dvadf
/home/homerdlh/public_html/1ef9ad/python3.8.tar
site-packages/__pycache__/easy_install.cpython-38.pyc000064400000000431151446176770016633 0ustar00U

�Qab~�@s"dZedkrddlmZe�dS)zRun the EasyInstall command�__main__�)�mainN)�__doc__�__name__Zsetuptools.command.easy_installr�rr�0/usr/lib/python3.8/site-packages/easy_install.py�<module>ssite-packages/__pycache__/easy_install.cpython-38.opt-1.pyc000064400000000431151446176770017572 0ustar00U

�Qab~�@s"dZedkrddlmZe�dS)zRun the EasyInstall command�__main__�)�mainN)�__doc__�__name__Zsetuptools.command.easy_installr�rr�0/usr/lib/python3.8/site-packages/easy_install.py�<module>ssite-packages/pip-19.3.1.dist-info/WHEEL000064400000000156151446176770013311 0ustar00Wheel-Version: 1.0
Generator: bdist_wheel (0.33.6)
Root-Is-Purelib: true
Tag: py2-none-any
Tag: py3-none-any

site-packages/pip-19.3.1.dist-info/INSTALLER000064400000000004151446176770013772 0ustar00rpm
site-packages/pip-19.3.1.dist-info/entry_points.txt000064400000000161151446176770016014 0ustar00[console_scripts]
pip = pip._internal.main:main
pip3 = pip._internal.main:main
pip3.8 = pip._internal.main:main

site-packages/pip-19.3.1.dist-info/METADATA000064400000006255151446176770013633 0ustar00Metadata-Version: 2.1
Name: pip
Version: 19.3.1
Summary: The PyPA recommended tool for installing Python packages.
Home-page: https://pip.pypa.io/
Author: The pip developers
Author-email: pypa-dev@groups.google.com
License: MIT
Keywords: distutils easy_install egg setuptools wheel virtualenv
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Software Development :: Build Tools
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*

pip - The Python Package Installer
==================================

.. image:: https://img.shields.io/pypi/v/pip.svg
   :target: https://pypi.org/project/pip/

.. image:: https://readthedocs.org/projects/pip/badge/?version=latest
   :target: https://pip.pypa.io/en/latest

pip is the `package installer`_ for Python. You can use pip to install packages from the `Python Package Index`_ and other indexes.

Please take a look at our documentation for how to install and use pip:

* `Installation`_
* `Usage`_

Updates are released regularly, with a new version every 3 months. More details can be found in our documentation:

* `Release notes`_
* `Release process`_

If you find bugs, need help, or want to talk to the developers please use our mailing lists or chat rooms:

* `Issue tracking`_
* `Discourse channel`_
* `User IRC`_

If you want to get involved head over to GitHub to get the source code, look at our development documentation and feel free to jump on the developer mailing lists and chat rooms:

* `GitHub page`_
* `Dev documentation`_
* `Dev mailing list`_
* `Dev IRC`_

Code of Conduct
---------------

Everyone interacting in the pip project's codebases, issue trackers, chat
rooms, and mailing lists is expected to follow the `PyPA Code of Conduct`_.

.. _package installer: https://packaging.python.org/en/latest/current/
.. _Python Package Index: https://pypi.org
.. _Installation: https://pip.pypa.io/en/stable/installing.html
.. _Usage: https://pip.pypa.io/en/stable/
.. _Release notes: https://pip.pypa.io/en/stable/news.html
.. _Release process: https://pip.pypa.io/en/latest/development/release-process/
.. _GitHub page: https://github.com/pypa/pip
.. _Dev documentation: https://pip.pypa.io/en/latest/development
.. _Issue tracking: https://github.com/pypa/pip/issues
.. _Discourse channel: https://discuss.python.org/c/packaging
.. _Dev mailing list: https://groups.google.com/forum/#!forum/pypa-dev
.. _User IRC: https://webchat.freenode.net/?channels=%23pypa
.. _Dev IRC: https://webchat.freenode.net/?channels=%23pypa-dev
.. _PyPA Code of Conduct: https://www.pypa.io/en/latest/code-of-conduct/


site-packages/pip-19.3.1.dist-info/RECORD000064400000142732151446176770013432 0ustar00../../../bin/pip,sha256=isMYezCDrq79FYcQQqNmVGeOh26HvQz3wntdy5zsiUc,219
../../../bin/pip3,sha256=isMYezCDrq79FYcQQqNmVGeOh26HvQz3wntdy5zsiUc,219
../../../bin/pip3.8,sha256=isMYezCDrq79FYcQQqNmVGeOh26HvQz3wntdy5zsiUc,219
pip-19.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
pip-19.3.1.dist-info/LICENSE.txt,sha256=W6Ifuwlk-TatfRU2LR7W1JMcyMj5_y1NkRkOEJvnRDE,1090
pip-19.3.1.dist-info/METADATA,sha256=3VTJN81wKoCumM54Ay7Je-xOiIkScmdYQu9WD43uK5o,3245
pip-19.3.1.dist-info/RECORD,,
pip-19.3.1.dist-info/WHEEL,sha256=8zNYZbwQSXoB9IfXOjPfeNwvAsALAjffgk27FqvCWbo,110
pip-19.3.1.dist-info/entry_points.txt,sha256=tbYijp8dTAsoGzseo-3RkvhZNzpr8DW4lFJdKFuARUk,113
pip-19.3.1.dist-info/top_level.txt,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
pip/__init__.py,sha256=3XVcbBDOOau8B2kbTs7mairuEe_dyGELVtflVt0LMVs,23
pip/__main__.py,sha256=JhJZiiWUmlPTwFOZ7_L68hWG4nUVQTDTtwc1o_yWdWw,628
pip/__pycache__/__init__.cpython-38.pyc,,
pip/__pycache__/__main__.cpython-38.pyc,,
pip/_internal/__init__.py,sha256=4lqJ4waZxiP4QFg34znQ3j5zdyDsrWZkERPeLAs7lT8,80
pip/_internal/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/__pycache__/build_env.cpython-38.pyc,,
pip/_internal/__pycache__/cache.cpython-38.pyc,,
pip/_internal/__pycache__/collector.cpython-38.pyc,,
pip/_internal/__pycache__/configuration.cpython-38.pyc,,
pip/_internal/__pycache__/download.cpython-38.pyc,,
pip/_internal/__pycache__/exceptions.cpython-38.pyc,,
pip/_internal/__pycache__/index.cpython-38.pyc,,
pip/_internal/__pycache__/legacy_resolve.cpython-38.pyc,,
pip/_internal/__pycache__/locations.cpython-38.pyc,,
pip/_internal/__pycache__/main.cpython-38.pyc,,
pip/_internal/__pycache__/pep425tags.cpython-38.pyc,,
pip/_internal/__pycache__/pyproject.cpython-38.pyc,,
pip/_internal/__pycache__/self_outdated_check.cpython-38.pyc,,
pip/_internal/__pycache__/wheel.cpython-38.pyc,,
pip/_internal/build_env.py,sha256=h8_IrSllK1aEv4cmoO9G7l5XDrwMeq2aADy6EWqbEKs,7517
pip/_internal/cache.py,sha256=tv5gyBOh4gx8my0ikxCEHzg92Y5D8mCbcE4lq9rQLhw,8371
pip/_internal/cli/__init__.py,sha256=FkHBgpxxb-_gd6r1FjnNhfMOzAUYyXoXKJ6abijfcFU,132
pip/_internal/cli/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/cli/__pycache__/autocompletion.cpython-38.pyc,,
pip/_internal/cli/__pycache__/base_command.cpython-38.pyc,,
pip/_internal/cli/__pycache__/cmdoptions.cpython-38.pyc,,
pip/_internal/cli/__pycache__/command_context.cpython-38.pyc,,
pip/_internal/cli/__pycache__/main_parser.cpython-38.pyc,,
pip/_internal/cli/__pycache__/parser.cpython-38.pyc,,
pip/_internal/cli/__pycache__/req_command.cpython-38.pyc,,
pip/_internal/cli/__pycache__/status_codes.cpython-38.pyc,,
pip/_internal/cli/autocompletion.py,sha256=KLBLfPkMKgkl6FS6RGlYlgRmdxFiwvdefv3Ywt5JqzM,6169
pip/_internal/cli/base_command.py,sha256=Xg0kP33AsjMYqXmFoZ-HX6-hRM5QaKDXAJRXLO03IVU,6504
pip/_internal/cli/cmdoptions.py,sha256=y6x_kbx-obAF2i6rO0cZR2HOi5SC31LKxl0ZjQV6uOs,26839
pip/_internal/cli/command_context.py,sha256=F0hZ0Xm8NZAgcOpl5J46OpjvAhIgx5P1nZHGaAAxlmc,796
pip/_internal/cli/main_parser.py,sha256=W9OWeryh7ZkqELohaFh0Ko9sB98ZkSeDmnYbOZ1imBc,2819
pip/_internal/cli/parser.py,sha256=O9djTuYQuSfObiY-NU6p4MJCfWsRUnDpE2YGA_fwols,9487
pip/_internal/cli/req_command.py,sha256=J1fTDjVZAExZDMBEqwJQ-NgNlab1g8zE1nZND-6TnP0,11363
pip/_internal/cli/status_codes.py,sha256=F6uDG6Gj7RNKQJUDnd87QKqI16Us-t-B0wPF_4QMpWc,156
pip/_internal/collector.py,sha256=zGSX67z_CN8uGIxxseKTIV2TC1QN1AE9mwBPvodTxak,18007
pip/_internal/commands/__init__.py,sha256=uTSj58QlrSKeXqCUSdL-eAf_APzx5BHy1ABxb0j5ZNE,3714
pip/_internal/commands/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/commands/__pycache__/check.cpython-38.pyc,,
pip/_internal/commands/__pycache__/completion.cpython-38.pyc,,
pip/_internal/commands/__pycache__/configuration.cpython-38.pyc,,
pip/_internal/commands/__pycache__/debug.cpython-38.pyc,,
pip/_internal/commands/__pycache__/download.cpython-38.pyc,,
pip/_internal/commands/__pycache__/freeze.cpython-38.pyc,,
pip/_internal/commands/__pycache__/hash.cpython-38.pyc,,
pip/_internal/commands/__pycache__/help.cpython-38.pyc,,
pip/_internal/commands/__pycache__/install.cpython-38.pyc,,
pip/_internal/commands/__pycache__/list.cpython-38.pyc,,
pip/_internal/commands/__pycache__/search.cpython-38.pyc,,
pip/_internal/commands/__pycache__/show.cpython-38.pyc,,
pip/_internal/commands/__pycache__/uninstall.cpython-38.pyc,,
pip/_internal/commands/__pycache__/wheel.cpython-38.pyc,,
pip/_internal/commands/check.py,sha256=mgLNYT3bd6Kmynwh4zzcBmVlFZ-urMo40jTgk6U405E,1505
pip/_internal/commands/completion.py,sha256=UFQvq0Q4_B96z1bvnQyMOq82aPSu05RejbLmqeTZjC0,2975
pip/_internal/commands/configuration.py,sha256=6riioZjMhsNSEct7dE-X8SobGodk3WERKJvuyjBje4Q,7226
pip/_internal/commands/debug.py,sha256=m9Ap_dd5jd7W6FbE9_t5495SAEvUC1vnDZ2m-TYXsQ4,3394
pip/_internal/commands/download.py,sha256=J6hxq7dO8Ld751WYueAdC18xiGhi27B6lrdOefFxwZo,5577
pip/_internal/commands/freeze.py,sha256=G9I_yoBHlpWLX1qItsWNOmmqc8ET7pekFybdbV333d4,3464
pip/_internal/commands/hash.py,sha256=47teimfAPhpkaVbSDaafck51BT3XXYuL83lAqc5lOcE,1735
pip/_internal/commands/help.py,sha256=Nhecq--ydFn80Gm1Zvbf9943EcRJfO0TnXUhsF0RO7s,1181
pip/_internal/commands/install.py,sha256=J6QUYQHD4XO-eTuC3wl3Mv1xYp3DxU1AWioHwnWIXwU,24559
pip/_internal/commands/list.py,sha256=wQijUCcLQmME_ryAk1EqjBM4CNfF8FXt5XGC5o3lQjc,10548
pip/_internal/commands/search.py,sha256=7Il8nKZ9mM7qF5jlnBoPvSIFY9f-0-5IbYoX3miTuZY,5148
pip/_internal/commands/show.py,sha256=Vzsj2oX0JBl94MPyF3LV8YoMcigl8B2UsMM8zp0pH2s,6792
pip/_internal/commands/uninstall.py,sha256=8mldFbrQecSoWDZRqxBgJkrlvx6Y9Iy7cs-2BIgtXt4,2983
pip/_internal/commands/wheel.py,sha256=cDwoMefUjOdLqE29rQGYwvdzwvsV0j5Ac7pCszbqaK8,6408
pip/_internal/configuration.py,sha256=ug70zCMs2OYEgef_6uebyXWDknbY-hz5cSaL9CpLYkI,14218
pip/_internal/distributions/__init__.py,sha256=plnByCzRAZJL98kuchZ4PoRKxseDWM7wBfjvb2_fMw8,967
pip/_internal/distributions/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/distributions/__pycache__/base.cpython-38.pyc,,
pip/_internal/distributions/__pycache__/installed.cpython-38.pyc,,
pip/_internal/distributions/__pycache__/wheel.cpython-38.pyc,,
pip/_internal/distributions/base.py,sha256=91UqVXWnIyQPpIQed4nAuYWkGY665aYIV1EjS-CkBEg,1108
pip/_internal/distributions/installed.py,sha256=4bZq8NqgXgPqX-yTz94WzTRvobjwDnxVnFCL24FjAWA,542
pip/_internal/distributions/source/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pip/_internal/distributions/source/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/distributions/source/__pycache__/legacy.cpython-38.pyc,,
pip/_internal/distributions/source/legacy.py,sha256=8QbAup0CBA5iPsSAJgxZyz1tQxO1C6hvfFpTlCJnyKE,3941
pip/_internal/distributions/wheel.py,sha256=0hkgI9NpkT4bCwA9RTsX2NJcz9MJyPhlh3f7Z3529sY,616
pip/_internal/download.py,sha256=IdIOCKfLSqfAgq34SCOyMKJHnJOr81JF-EeGB_faLHQ,20805
pip/_internal/exceptions.py,sha256=6YRuwXAK6F1iyUWKIkCIpWWN2khkAn1sZOgrFA9S8Ro,10247
pip/_internal/index.py,sha256=P5WnrP8zyBK29EFDCcIsznQquTNn4ZL-cYP8L-NbfPU,36887
pip/_internal/legacy_resolve.py,sha256=X9Vh3sRLMKI7HnGZ2UuTO_liClsSPwRA4m9D7L5osxY,17234
pip/_internal/locations.py,sha256=n6KALLEJN-L99QFHPNdJl3nMktwcpmqMyyo6EXZoCL0,5414
pip/_internal/main.py,sha256=ikuDY1c82JZivOvnSXJZN31IeeZF_BkNpgZZ90p6iJ4,1359
pip/_internal/models/__init__.py,sha256=3DHUd_qxpPozfzouoqa9g9ts1Czr5qaHfFxbnxriepM,63
pip/_internal/models/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/models/__pycache__/candidate.cpython-38.pyc,,
pip/_internal/models/__pycache__/format_control.cpython-38.pyc,,
pip/_internal/models/__pycache__/index.cpython-38.pyc,,
pip/_internal/models/__pycache__/link.cpython-38.pyc,,
pip/_internal/models/__pycache__/search_scope.cpython-38.pyc,,
pip/_internal/models/__pycache__/selection_prefs.cpython-38.pyc,,
pip/_internal/models/__pycache__/target_python.cpython-38.pyc,,
pip/_internal/models/candidate.py,sha256=S5ipn5ZvnWFX_A84OGrtc4DAZTJM7GSnIyDIA8PwZWw,1277
pip/_internal/models/format_control.py,sha256=bMcS0iTVLBXrYRDkGeGqYE3pTQUR96T7cGyMtLeH0Fs,2592
pip/_internal/models/index.py,sha256=K59A8-hVhBM20Xkahr4dTwP7OjkJyEqXH11UwHFVgqM,1060
pip/_internal/models/link.py,sha256=MFYBc2ko2B--zFyk6JBnorkAdFpJ8lwozz-64YBdDO0,6860
pip/_internal/models/search_scope.py,sha256=25LTMmqHvKxCpOsEH1qcb0Id-hqATsg2SVIjcxY702o,3971
pip/_internal/models/selection_prefs.py,sha256=rPeif2KKjhTPXeMoQYffjqh10oWpXhdkxRDaPT1HO8k,1908
pip/_internal/models/target_python.py,sha256=d66ljdpZZtAAQsuOytiZ7yq6spCa8GOmz5Vf7uoVZT0,3820
pip/_internal/network/__init__.py,sha256=jf6Tt5nV_7zkARBrKojIXItgejvoegVJVKUbhAa5Ioc,50
pip/_internal/network/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/network/__pycache__/auth.cpython-38.pyc,,
pip/_internal/network/__pycache__/cache.cpython-38.pyc,,
pip/_internal/network/__pycache__/session.cpython-38.pyc,,
pip/_internal/network/__pycache__/xmlrpc.cpython-38.pyc,,
pip/_internal/network/auth.py,sha256=K3G1ukKb3PiH8w_UnpXTz8qQsTULO-qdbfOE9zTo1fE,11119
pip/_internal/network/cache.py,sha256=WJafQhl9_gSxvEMvYN-ecsijGscKCVPsb09sEUbwL-E,2233
pip/_internal/network/session.py,sha256=m2E-pkpE3nWVswt2JzKP9NANwfhf38SjDOUor0cxqd8,15842
pip/_internal/network/xmlrpc.py,sha256=AL115M3vFJ8xiHVJneb8Hi0ZFeRvdPhblC89w25OG5s,1597
pip/_internal/operations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pip/_internal/operations/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/operations/__pycache__/check.cpython-38.pyc,,
pip/_internal/operations/__pycache__/freeze.cpython-38.pyc,,
pip/_internal/operations/__pycache__/generate_metadata.cpython-38.pyc,,
pip/_internal/operations/__pycache__/prepare.cpython-38.pyc,,
pip/_internal/operations/check.py,sha256=SG2AuZ4NFwUPAWo4OQOotKCn6OUxjkAgBdehNAo_2sM,5354
pip/_internal/operations/freeze.py,sha256=MeHazCBo6DF0B2ay0t0CqRRfR4bETqKB-ANv4yIq4Bg,9826
pip/_internal/operations/generate_metadata.py,sha256=oHJtWo0QpOt5xt5xQTfOEVNOpaPy9E0lhMCIE6Upidw,4699
pip/_internal/operations/prepare.py,sha256=_TNie4ORlITMh04dkEQcBVDFkcz5FW67VjUfeJDRUcM,11279
pip/_internal/pep425tags.py,sha256=mCZA3yvHjZfQGnQti2sNfzrinhLmDp0o9Fwb826Edj4,15941
pip/_internal/pyproject.py,sha256=98g1oHmpdqraOqAJuoCDr2XP3QQuN5oEuoD0fWDtVhE,6490
pip/_internal/req/__init__.py,sha256=iR73_MGlD4N2Dg86t2kooz7okpZgpAuZUSROrR9KkkE,2467
pip/_internal/req/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/req/__pycache__/constructors.cpython-38.pyc,,
pip/_internal/req/__pycache__/req_file.cpython-38.pyc,,
pip/_internal/req/__pycache__/req_install.cpython-38.pyc,,
pip/_internal/req/__pycache__/req_set.cpython-38.pyc,,
pip/_internal/req/__pycache__/req_tracker.cpython-38.pyc,,
pip/_internal/req/__pycache__/req_uninstall.cpython-38.pyc,,
pip/_internal/req/constructors.py,sha256=DcUoVBQabogW6FoTxo_7FApvYTBk5LmiTtLOSi9Wh7Y,14388
pip/_internal/req/req_file.py,sha256=Ip4KV67FLLexYq9xVGgzjbyjIQCP5W-RmkVZWFWV5AY,14294
pip/_internal/req/req_install.py,sha256=0Fkfk1ireEama-Ox3H7VJEW_ytMrb3g0zN_r4sEda-8,36635
pip/_internal/req/req_set.py,sha256=ykotCTON9_be3yzrkXs9yv986Tv-p-Sk5-q8tqgk6BY,8132
pip/_internal/req/req_tracker.py,sha256=M5VZxoKrvDmwH2G2kk1QthJmhF19zCmKSXLY-WDLKWY,3195
pip/_internal/req/req_uninstall.py,sha256=VyukcnrMTRob977YO6C5t9CVadmZIF24Yj30Hfz4lpc,23590
pip/_internal/self_outdated_check.py,sha256=0RuTI8jXNm_CK7ZV8huRUqtabE0SQgwJSogapEti_zo,7934
pip/_internal/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pip/_internal/utils/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/utils/__pycache__/appdirs.cpython-38.pyc,,
pip/_internal/utils/__pycache__/compat.cpython-38.pyc,,
pip/_internal/utils/__pycache__/deprecation.cpython-38.pyc,,
pip/_internal/utils/__pycache__/encoding.cpython-38.pyc,,
pip/_internal/utils/__pycache__/filesystem.cpython-38.pyc,,
pip/_internal/utils/__pycache__/filetypes.cpython-38.pyc,,
pip/_internal/utils/__pycache__/glibc.cpython-38.pyc,,
pip/_internal/utils/__pycache__/hashes.cpython-38.pyc,,
pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.pyc,,
pip/_internal/utils/__pycache__/logging.cpython-38.pyc,,
pip/_internal/utils/__pycache__/marker_files.cpython-38.pyc,,
pip/_internal/utils/__pycache__/misc.cpython-38.pyc,,
pip/_internal/utils/__pycache__/models.cpython-38.pyc,,
pip/_internal/utils/__pycache__/packaging.cpython-38.pyc,,
pip/_internal/utils/__pycache__/setuptools_build.cpython-38.pyc,,
pip/_internal/utils/__pycache__/subprocess.cpython-38.pyc,,
pip/_internal/utils/__pycache__/temp_dir.cpython-38.pyc,,
pip/_internal/utils/__pycache__/typing.cpython-38.pyc,,
pip/_internal/utils/__pycache__/ui.cpython-38.pyc,,
pip/_internal/utils/__pycache__/unpacking.cpython-38.pyc,,
pip/_internal/utils/__pycache__/urls.cpython-38.pyc,,
pip/_internal/utils/__pycache__/virtualenv.cpython-38.pyc,,
pip/_internal/utils/appdirs.py,sha256=hchP3vBMefwp3Jr05IqN6cssVlbzYPTj062hJzBDhA4,9766
pip/_internal/utils/compat.py,sha256=i9XoohQwMK73PwN0Nkan6DfiG47rdyllTXvX3WJO30c,9565
pip/_internal/utils/deprecation.py,sha256=pBnNogoA4UGTxa_JDnPXBRRYpKMbExAhXpBwAwklOBs,3318
pip/_internal/utils/encoding.py,sha256=hxZz0t3Whw3d4MHQEiofxalTlfKwxFdLc8fpeGfhKo8,1320
pip/_internal/utils/filesystem.py,sha256=TG_hHd0BZkYih17f4z4wEi0XXheo5TE-UnAQB964Pf0,3334
pip/_internal/utils/filetypes.py,sha256=R2FwzoeX7b-rZALOXx5cuO8VPPMhUQ4ne7wm3n3IcWA,571
pip/_internal/utils/glibc.py,sha256=HXnQNSGfrldTYbF6V6asT86h6QQKPwumYok1MFyQDnM,4397
pip/_internal/utils/hashes.py,sha256=XXj0SZfz4piN8XgqloGzPnfQYGTcSZZDtuqa1zWCts8,4020
pip/_internal/utils/inject_securetransport.py,sha256=M17ZlFVY66ApgeASVjKKLKNz0LAfk-SyU0HZ4ZB6MmI,810
pip/_internal/utils/logging.py,sha256=aJL7NldPhS5KGFof6Qt3o3MG5cjm5TOoo7bGRu9_wsg,13033
pip/_internal/utils/marker_files.py,sha256=ktYfV9ccPKzVREiWlmTveiKOztk0L7F2zXi2ob2lymM,823
pip/_internal/utils/misc.py,sha256=Ekpr2RWm4BwrccJT148FA7lvcJzJSB59qINEjHMre28,25579
pip/_internal/utils/models.py,sha256=IA0hw_T4awQzui0kqfIEASm5yLtgZAB08ag59Nip5G8,1148
pip/_internal/utils/packaging.py,sha256=VtiwcAAL7LBi7tGL2je7LeW4bE11KMHGCsJ1NZY5XtM,3035
pip/_internal/utils/setuptools_build.py,sha256=vHAmalU_IcDvU7ioRioVspEyVD2N4_NPDSbtHOoow8g,1631
pip/_internal/utils/subprocess.py,sha256=M3oBdbCSxDhmQSWYRZo0PTzGuyYvJaNIzt3DVCmtjJI,9911
pip/_internal/utils/temp_dir.py,sha256=fFNkfrE3MlyjZjoLzeX9A2AkjUWEEEoP-8ObyX3BSnE,5521
pip/_internal/utils/typing.py,sha256=bF73ImJzIaxLLEVwfEaSJzFGqV9LaxkQBvDULIyr1jI,1125
pip/_internal/utils/ui.py,sha256=SmwDgg45shGo0wVJSK3MUZUQtM4DNGdQntE3n2G97yk,13906
pip/_internal/utils/unpacking.py,sha256=7qOhuK60YvrXwqGGWYQ0rE7vBrMkAwYAtmsIsN0eQgc,9682
pip/_internal/utils/urls.py,sha256=aNV9wq5ClUmrz6sG-al7hEWJ4ToitOy7l82CmFGFNW8,1481
pip/_internal/utils/virtualenv.py,sha256=oSTrUMQUqmuXcDvQZGwV65w-hlvhBAqyQiWRxLf8fN0,891
pip/_internal/vcs/__init__.py,sha256=viJxJRqRE_mVScum85bgQIXAd6o0ozFt18VpC-qIJrM,617
pip/_internal/vcs/__pycache__/__init__.cpython-38.pyc,,
pip/_internal/vcs/__pycache__/bazaar.cpython-38.pyc,,
pip/_internal/vcs/__pycache__/git.cpython-38.pyc,,
pip/_internal/vcs/__pycache__/mercurial.cpython-38.pyc,,
pip/_internal/vcs/__pycache__/subversion.cpython-38.pyc,,
pip/_internal/vcs/__pycache__/versioncontrol.cpython-38.pyc,,
pip/_internal/vcs/bazaar.py,sha256=84q1-kj1_nJ9AMzMu8RmMp-riRZu81M7K9kowcYgi3U,3957
pip/_internal/vcs/git.py,sha256=PqhcEuFXQhutNNT4wI0uy6QcYnk9TOf8KGQNMBxL9hU,13568
pip/_internal/vcs/mercurial.py,sha256=2mg7BdYI_Fe00fF6omaNccFQLPHBsDBG5CAEzvqn5sA,5110
pip/_internal/vcs/subversion.py,sha256=Fpwy71AmuqXnoKi6h1SrXRtPjEMn8fieuM1O4j01IBg,12292
pip/_internal/vcs/versioncontrol.py,sha256=HiWHloaYAo4UWGxJGZhG0nO0PWS513H6ACiqT0z5Yh0,21374
pip/_internal/wheel.py,sha256=emOltdF4VmpsSabfIBbtlCcozviIOnUwIdB0D3_VMrQ,43080
pip/_vendor/__init__.py,sha256=gEJYEfJm7XGLslyjW3KBQyQxyTYxdvTEkRT5Bz28MDs,4657
pip/_vendor/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/__pycache__/appdirs.cpython-38.pyc,,
pip/_vendor/__pycache__/contextlib2.cpython-38.pyc,,
pip/_vendor/__pycache__/distro.cpython-38.pyc,,
pip/_vendor/__pycache__/ipaddress.cpython-38.pyc,,
pip/_vendor/__pycache__/pyparsing.cpython-38.pyc,,
pip/_vendor/__pycache__/retrying.cpython-38.pyc,,
pip/_vendor/__pycache__/six.cpython-38.pyc,,
pip/_vendor/appdirs.py,sha256=BENKsvcA08IpccD9345-rMrg3aXWFA1q6BFEglnHg6I,24547
pip/_vendor/cachecontrol/__init__.py,sha256=6cRPchVqkAkeUtYTSW8qCetjSqJo-GxP-n4VMVDbvmc,302
pip/_vendor/cachecontrol/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/adapter.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/cache.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/compat.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/controller.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/serialize.cpython-38.pyc,,
pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-38.pyc,,
pip/_vendor/cachecontrol/_cmd.py,sha256=URGE0KrA87QekCG3SGPatlSPT571dZTDjNa-ZXX3pDc,1295
pip/_vendor/cachecontrol/adapter.py,sha256=eBGAtVNRZgtl_Kj5JV54miqL9YND-D0JZPahwY8kFtY,4863
pip/_vendor/cachecontrol/cache.py,sha256=1fc4wJP8HYt1ycnJXeEw5pCpeBL2Cqxx6g9Fb0AYDWQ,805
pip/_vendor/cachecontrol/caches/__init__.py,sha256=-gHNKYvaeD0kOk5M74eOrsSgIKUtC6i6GfbmugGweEo,86
pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-38.pyc,,
pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-38.pyc,,
pip/_vendor/cachecontrol/caches/file_cache.py,sha256=nYVKsJtXh6gJXvdn1iWyrhxvkwpQrK-eKoMRzuiwkKk,4153
pip/_vendor/cachecontrol/caches/redis_cache.py,sha256=HxelMpNCo-dYr2fiJDwM3hhhRmxUYtB5tXm1GpAAT4Y,856
pip/_vendor/cachecontrol/compat.py,sha256=kHNvMRdt6s_Xwqq_9qJmr9ou3wYMOMUMxPPcwNxT8Mc,695
pip/_vendor/cachecontrol/controller.py,sha256=U7g-YwizQ2O5NRgK_MZreF1ntM4E49C3PuF3od-Vwz4,13698
pip/_vendor/cachecontrol/filewrapper.py,sha256=vACKO8Llzu_ZWyjV1Fxn1MA4TGU60N5N3GSrAFdAY2Q,2533
pip/_vendor/cachecontrol/heuristics.py,sha256=BFGHJ3yQcxvZizfo90LLZ04T_Z5XSCXvFotrp7Us0sc,4070
pip/_vendor/cachecontrol/serialize.py,sha256=GebE34fgToyWwAsRPguh8hEPN6CqoG-5hRMXRsjVABQ,6954
pip/_vendor/cachecontrol/wrapper.py,sha256=sfr9YHWx-5TwNz1H5rT6QOo8ggII6v3vbEDjQFwR6wc,671
pip/_vendor/certifi/__init__.py,sha256=WFoavXHhpX-BZ5kbvyinZTbhLsqPJypLKIZu29nUsQg,52
pip/_vendor/certifi/__main__.py,sha256=NaCn6WtWME-zzVWQ2j4zFyl8cY4knDa9CwtHNIeFPhM,53
pip/_vendor/certifi/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/certifi/__pycache__/__main__.cpython-38.pyc,,
pip/_vendor/certifi/__pycache__/core.cpython-38.pyc,,
pip/_vendor/certifi/core.py,sha256=p7-3v1KMyEft0Z4vBDRxJ4TfjS7l7zALERrmncYjhSg,188
pip/_vendor/chardet/__init__.py,sha256=YsP5wQlsHJ2auF1RZJfypiSrCA7_bQiRm3ES_NI76-Y,1559
pip/_vendor/chardet/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/big5freq.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/big5prober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/chardistribution.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/charsetgroupprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/charsetprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/codingstatemachine.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/compat.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/cp949prober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/enums.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/escprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/escsm.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/eucjpprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/euckrfreq.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/euckrprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/euctwfreq.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/euctwprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/gb2312freq.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/gb2312prober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/hebrewprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/jisfreq.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/jpcntx.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/langbulgarianmodel.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/langcyrillicmodel.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/langgreekmodel.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/langhebrewmodel.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/langhungarianmodel.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/langthaimodel.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/langturkishmodel.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/latin1prober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/mbcharsetprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/mbcsgroupprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/mbcssm.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/sbcharsetprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/sbcsgroupprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/sjisprober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/universaldetector.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/utf8prober.cpython-38.pyc,,
pip/_vendor/chardet/__pycache__/version.cpython-38.pyc,,
pip/_vendor/chardet/big5freq.py,sha256=D_zK5GyzoVsRes0HkLJziltFQX0bKCLOrFe9_xDvO_8,31254
pip/_vendor/chardet/big5prober.py,sha256=kBxHbdetBpPe7xrlb-e990iot64g_eGSLd32lB7_h3M,1757
pip/_vendor/chardet/chardistribution.py,sha256=3woWS62KrGooKyqz4zQSnjFbJpa6V7g02daAibTwcl8,9411
pip/_vendor/chardet/charsetgroupprober.py,sha256=6bDu8YIiRuScX4ca9Igb0U69TA2PGXXDej6Cc4_9kO4,3787
pip/_vendor/chardet/charsetprober.py,sha256=KSmwJErjypyj0bRZmC5F5eM7c8YQgLYIjZXintZNstg,5110
pip/_vendor/chardet/cli/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
pip/_vendor/chardet/cli/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/chardet/cli/__pycache__/chardetect.cpython-38.pyc,,
pip/_vendor/chardet/cli/chardetect.py,sha256=DI8dlV3FBD0c0XA_y3sQ78z754DUv1J8n34RtDjOXNw,2774
pip/_vendor/chardet/codingstatemachine.py,sha256=VYp_6cyyki5sHgXDSZnXW4q1oelHc3cu9AyQTX7uug8,3590
pip/_vendor/chardet/compat.py,sha256=PKTzHkSbtbHDqS9PyujMbX74q1a8mMpeQTDVsQhZMRw,1134
pip/_vendor/chardet/cp949prober.py,sha256=TZ434QX8zzBsnUvL_8wm4AQVTZ2ZkqEEQL_lNw9f9ow,1855
pip/_vendor/chardet/enums.py,sha256=Aimwdb9as1dJKZaFNUH2OhWIVBVd6ZkJJ_WK5sNY8cU,1661
pip/_vendor/chardet/escprober.py,sha256=kkyqVg1Yw3DIOAMJ2bdlyQgUFQhuHAW8dUGskToNWSc,3950
pip/_vendor/chardet/escsm.py,sha256=RuXlgNvTIDarndvllNCk5WZBIpdCxQ0kcd9EAuxUh84,10510
pip/_vendor/chardet/eucjpprober.py,sha256=iD8Jdp0ISRjgjiVN7f0e8xGeQJ5GM2oeZ1dA8nbSeUw,3749
pip/_vendor/chardet/euckrfreq.py,sha256=-7GdmvgWez4-eO4SuXpa7tBiDi5vRXQ8WvdFAzVaSfo,13546
pip/_vendor/chardet/euckrprober.py,sha256=MqFMTQXxW4HbzIpZ9lKDHB3GN8SP4yiHenTmf8g_PxY,1748
pip/_vendor/chardet/euctwfreq.py,sha256=No1WyduFOgB5VITUA7PLyC5oJRNzRyMbBxaKI1l16MA,31621
pip/_vendor/chardet/euctwprober.py,sha256=13p6EP4yRaxqnP4iHtxHOJ6R2zxHq1_m8hTRjzVZ95c,1747
pip/_vendor/chardet/gb2312freq.py,sha256=JX8lsweKLmnCwmk8UHEQsLgkr_rP_kEbvivC4qPOrlc,20715
pip/_vendor/chardet/gb2312prober.py,sha256=gGvIWi9WhDjE-xQXHvNIyrnLvEbMAYgyUSZ65HUfylw,1754
pip/_vendor/chardet/hebrewprober.py,sha256=c3SZ-K7hvyzGY6JRAZxJgwJ_sUS9k0WYkvMY00YBYFo,13838
pip/_vendor/chardet/jisfreq.py,sha256=vpmJv2Bu0J8gnMVRPHMFefTRvo_ha1mryLig8CBwgOg,25777
pip/_vendor/chardet/jpcntx.py,sha256=PYlNqRUQT8LM3cT5FmHGP0iiscFlTWED92MALvBungo,19643
pip/_vendor/chardet/langbulgarianmodel.py,sha256=1HqQS9Pbtnj1xQgxitJMvw8X6kKr5OockNCZWfEQrPE,12839
pip/_vendor/chardet/langcyrillicmodel.py,sha256=LODajvsetH87yYDDQKA2CULXUH87tI223dhfjh9Zx9c,17948
pip/_vendor/chardet/langgreekmodel.py,sha256=8YAW7bU8YwSJap0kIJSbPMw1BEqzGjWzqcqf0WgUKAA,12688
pip/_vendor/chardet/langhebrewmodel.py,sha256=JSnqmE5E62tDLTPTvLpQsg5gOMO4PbdWRvV7Avkc0HA,11345
pip/_vendor/chardet/langhungarianmodel.py,sha256=RhapYSG5l0ZaO-VV4Fan5sW0WRGQqhwBM61yx3yxyOA,12592
pip/_vendor/chardet/langthaimodel.py,sha256=8l0173Gu_W6G8mxmQOTEF4ls2YdE7FxWf3QkSxEGXJQ,11290
pip/_vendor/chardet/langturkishmodel.py,sha256=W22eRNJsqI6uWAfwXSKVWWnCerYqrI8dZQTm_M0lRFk,11102
pip/_vendor/chardet/latin1prober.py,sha256=S2IoORhFk39FEFOlSFWtgVybRiP6h7BlLldHVclNkU8,5370
pip/_vendor/chardet/mbcharsetprober.py,sha256=AR95eFH9vuqSfvLQZN-L5ijea25NOBCoXqw8s5O9xLQ,3413
pip/_vendor/chardet/mbcsgroupprober.py,sha256=h6TRnnYq2OxG1WdD5JOyxcdVpn7dG0q-vB8nWr5mbh4,2012
pip/_vendor/chardet/mbcssm.py,sha256=SY32wVIF3HzcjY3BaEspy9metbNSKxIIB0RKPn7tjpI,25481
pip/_vendor/chardet/sbcharsetprober.py,sha256=LDSpCldDCFlYwUkGkwD2oFxLlPWIWXT09akH_2PiY74,5657
pip/_vendor/chardet/sbcsgroupprober.py,sha256=1IprcCB_k1qfmnxGC6MBbxELlKqD3scW6S8YIwdeyXA,3546
pip/_vendor/chardet/sjisprober.py,sha256=IIt-lZj0WJqK4rmUZzKZP4GJlE8KUEtFYVuY96ek5MQ,3774
pip/_vendor/chardet/universaldetector.py,sha256=qL0174lSZE442eB21nnktT9_VcAye07laFWUeUrjttY,12485
pip/_vendor/chardet/utf8prober.py,sha256=IdD8v3zWOsB8OLiyPi-y_fqwipRFxV9Nc1eKBLSuIEw,2766
pip/_vendor/chardet/version.py,sha256=sp3B08mrDXB-pf3K9fqJ_zeDHOCLC8RrngQyDFap_7g,242
pip/_vendor/colorama/__init__.py,sha256=lJdY6COz9uM_pXwuk9oLr0fp8H8q2RrUqN16GKabvq4,239
pip/_vendor/colorama/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/colorama/__pycache__/ansi.cpython-38.pyc,,
pip/_vendor/colorama/__pycache__/ansitowin32.cpython-38.pyc,,
pip/_vendor/colorama/__pycache__/initialise.cpython-38.pyc,,
pip/_vendor/colorama/__pycache__/win32.cpython-38.pyc,,
pip/_vendor/colorama/__pycache__/winterm.cpython-38.pyc,,
pip/_vendor/colorama/ansi.py,sha256=Fi0un-QLqRm-v7o_nKiOqyC8PapBJK7DLV_q9LKtTO0,2524
pip/_vendor/colorama/ansitowin32.py,sha256=u8QaqdqS_xYSfNkPM1eRJLHz6JMWPodaJaP0mxgHCDc,10462
pip/_vendor/colorama/initialise.py,sha256=PprovDNxMTrvoNHFcL2NZjpH2XzDc8BLxLxiErfUl4k,1915
pip/_vendor/colorama/win32.py,sha256=bJ8Il9jwaBN5BJ8bmN6FoYZ1QYuMKv2j8fGrXh7TJjw,5404
pip/_vendor/colorama/winterm.py,sha256=2y_2b7Zsv34feAsP67mLOVc-Bgq51mdYGo571VprlrM,6438
pip/_vendor/contextlib2.py,sha256=5HjGflUzwWAUfcILhSmC2GqvoYdZZzFzVfIDztHigUs,16915
pip/_vendor/distlib/__init__.py,sha256=SkHYPuEQNQF2a2Cr18rfZ-LQyDqwwizn8tJE4seXPgU,587
pip/_vendor/distlib/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/compat.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/database.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/index.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/locators.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/manifest.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/markers.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/metadata.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/resources.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/scripts.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/util.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/version.cpython-38.pyc,,
pip/_vendor/distlib/__pycache__/wheel.cpython-38.pyc,,
pip/_vendor/distlib/_backport/__init__.py,sha256=bqS_dTOH6uW9iGgd0uzfpPjo6vZ4xpPZ7kyfZJ2vNaw,274
pip/_vendor/distlib/_backport/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/distlib/_backport/__pycache__/misc.cpython-38.pyc,,
pip/_vendor/distlib/_backport/__pycache__/sysconfig.cpython-38.pyc,,
pip/_vendor/distlib/_backport/misc.py,sha256=KWecINdbFNOxSOP1fGF680CJnaC6S4fBRgEtaYTw0ig,971
pip/_vendor/distlib/_backport/sysconfig.cfg,sha256=swZKxq9RY5e9r3PXCrlvQPMsvOdiWZBTHLEbqS8LJLU,2617
pip/_vendor/distlib/_backport/sysconfig.py,sha256=JdJ9ztRy4Hc-b5-VS74x3nUtdEIVr_OBvMsIb8O2sjc,26964
pip/_vendor/distlib/compat.py,sha256=xdNZmqFN5HwF30HjRn5M415pcC2kgXRBXn767xS8v-M,41404
pip/_vendor/distlib/database.py,sha256=-KJH63AJ7hqjLtGCwOTrionhKr2Vsytdwkjyo8UdEco,51029
pip/_vendor/distlib/index.py,sha256=SXKzpQCERctxYDMp_OLee2f0J0e19ZhGdCIoMlUfUQM,21066
pip/_vendor/distlib/locators.py,sha256=bqzEWP3Ad8UE3D1rmzW1pgzVTKkY4rDUA_EWIVYli54,51807
pip/_vendor/distlib/manifest.py,sha256=nQEhYmgoreaBZzyFzwYsXxJARu3fo4EkunU163U16iE,14811
pip/_vendor/distlib/markers.py,sha256=6Ac3cCfFBERexiESWIOXmg-apIP8l2esafNSX3KMy-8,4387
pip/_vendor/distlib/metadata.py,sha256=OhbCKmf5lswE8unWBopI1hj7tRpHp4ZbFvU4d6aAEMM,40234
pip/_vendor/distlib/resources.py,sha256=2FGv0ZHF14KXjLIlL0R991lyQQGcewOS4mJ-5n-JVnc,10766
pip/_vendor/distlib/scripts.py,sha256=W24OXnZUmgRX_XtDrVZdfc-Frf4X4_cybvhP87iR-QU,16290
pip/_vendor/distlib/util.py,sha256=vv8T7g_c8Ei9dRosWP1ypxKmaBpPpTwlMpPRKbLgWEY,60408
pip/_vendor/distlib/version.py,sha256=_n7F6juvQGAcn769E_SHa7fOcf5ERlEVymJ_EjPRwGw,23391
pip/_vendor/distlib/wheel.py,sha256=2lviV6L4IvTP5DRkKE0HGpClvdoTJQHZJLfTQ6dfn2A,40437
pip/_vendor/distro.py,sha256=X2So5kjrRKyMbQJ90Xgy93HU5eFtujCzKaYNeoy1k1c,43251
pip/_vendor/html5lib/__init__.py,sha256=Ztrn7UvF-wIFAgRBBa0ML-Gu5AffH3BPX_INJx4SaBI,1162
pip/_vendor/html5lib/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/html5lib/__pycache__/_ihatexml.cpython-38.pyc,,
pip/_vendor/html5lib/__pycache__/_inputstream.cpython-38.pyc,,
pip/_vendor/html5lib/__pycache__/_tokenizer.cpython-38.pyc,,
pip/_vendor/html5lib/__pycache__/_utils.cpython-38.pyc,,
pip/_vendor/html5lib/__pycache__/constants.cpython-38.pyc,,
pip/_vendor/html5lib/__pycache__/html5parser.cpython-38.pyc,,
pip/_vendor/html5lib/__pycache__/serializer.cpython-38.pyc,,
pip/_vendor/html5lib/_ihatexml.py,sha256=3LBtJMlzgwM8vpQiU1TvGmEEmNH72sV0yD8yS53y07A,16705
pip/_vendor/html5lib/_inputstream.py,sha256=bPUWcAfJScK4xkjQQaG_HsI2BvEVbFvI0AsodDYPQj0,32552
pip/_vendor/html5lib/_tokenizer.py,sha256=YAaOEBD6qc5ISq9Xt9Nif1OFgcybTTfMdwqBkZhpAq4,76580
pip/_vendor/html5lib/_trie/__init__.py,sha256=8VR1bcgD2OpeS2XExpu5yBhP_Q1K-lwKbBKICBPf1kU,289
pip/_vendor/html5lib/_trie/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/html5lib/_trie/__pycache__/_base.cpython-38.pyc,,
pip/_vendor/html5lib/_trie/__pycache__/datrie.cpython-38.pyc,,
pip/_vendor/html5lib/_trie/__pycache__/py.cpython-38.pyc,,
pip/_vendor/html5lib/_trie/_base.py,sha256=CaybYyMro8uERQYjby2tTeSUatnWDfWroUN9N7ety5w,1013
pip/_vendor/html5lib/_trie/datrie.py,sha256=EQpqSfkZRuTbE-DuhW7xMdVDxdZNZ0CfmnYfHA_3zxM,1178
pip/_vendor/html5lib/_trie/py.py,sha256=wXmQLrZRf4MyWNyg0m3h81m9InhLR7GJ002mIIZh-8o,1775
pip/_vendor/html5lib/_utils.py,sha256=ismpASeqa2jqEPQjHUj8vReAf7yIoKnvLN5fuOw6nv0,4015
pip/_vendor/html5lib/constants.py,sha256=4lmZWLtEPRLnl8NzftOoYTJdo6jpeMtP6dqQC0g_bWQ,83518
pip/_vendor/html5lib/filters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pip/_vendor/html5lib/filters/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/html5lib/filters/__pycache__/alphabeticalattributes.cpython-38.pyc,,
pip/_vendor/html5lib/filters/__pycache__/base.cpython-38.pyc,,
pip/_vendor/html5lib/filters/__pycache__/inject_meta_charset.cpython-38.pyc,,
pip/_vendor/html5lib/filters/__pycache__/lint.cpython-38.pyc,,
pip/_vendor/html5lib/filters/__pycache__/optionaltags.cpython-38.pyc,,
pip/_vendor/html5lib/filters/__pycache__/sanitizer.cpython-38.pyc,,
pip/_vendor/html5lib/filters/__pycache__/whitespace.cpython-38.pyc,,
pip/_vendor/html5lib/filters/alphabeticalattributes.py,sha256=lViZc2JMCclXi_5gduvmdzrRxtO5Xo9ONnbHBVCsykU,919
pip/_vendor/html5lib/filters/base.py,sha256=z-IU9ZAYjpsVsqmVt7kuWC63jR11hDMr6CVrvuao8W0,286
pip/_vendor/html5lib/filters/inject_meta_charset.py,sha256=egDXUEHXmAG9504xz0K6ALDgYkvUrC2q15YUVeNlVQg,2945
pip/_vendor/html5lib/filters/lint.py,sha256=jk6q56xY0ojiYfvpdP-OZSm9eTqcAdRqhCoPItemPYA,3643
pip/_vendor/html5lib/filters/optionaltags.py,sha256=8lWT75J0aBOHmPgfmqTHSfPpPMp01T84NKu0CRedxcE,10588
pip/_vendor/html5lib/filters/sanitizer.py,sha256=4ON02KNjuqda1lCw5_JCUZxb0BzWR5M7ON84dtJ7dm0,26248
pip/_vendor/html5lib/filters/whitespace.py,sha256=8eWqZxd4UC4zlFGW6iyY6f-2uuT8pOCSALc3IZt7_t4,1214
pip/_vendor/html5lib/html5parser.py,sha256=g5g2ezkusHxhi7b23vK_-d6K6BfIJRbqIQmvQ9z4EgI,118963
pip/_vendor/html5lib/serializer.py,sha256=yfcfBHse2wDs6ojxn-kieJjLT5s1ipilQJ0gL3-rJis,15758
pip/_vendor/html5lib/treeadapters/__init__.py,sha256=A0rY5gXIe4bJOiSGRO_j_tFhngRBO8QZPzPtPw5dFzo,679
pip/_vendor/html5lib/treeadapters/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/html5lib/treeadapters/__pycache__/genshi.cpython-38.pyc,,
pip/_vendor/html5lib/treeadapters/__pycache__/sax.cpython-38.pyc,,
pip/_vendor/html5lib/treeadapters/genshi.py,sha256=CH27pAsDKmu4ZGkAUrwty7u0KauGLCZRLPMzaO3M5vo,1715
pip/_vendor/html5lib/treeadapters/sax.py,sha256=BKS8woQTnKiqeffHsxChUqL4q2ZR_wb5fc9MJ3zQC8s,1776
pip/_vendor/html5lib/treebuilders/__init__.py,sha256=AysSJyvPfikCMMsTVvaxwkgDieELD5dfR8FJIAuq7hY,3592
pip/_vendor/html5lib/treebuilders/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/html5lib/treebuilders/__pycache__/base.cpython-38.pyc,,
pip/_vendor/html5lib/treebuilders/__pycache__/dom.cpython-38.pyc,,
pip/_vendor/html5lib/treebuilders/__pycache__/etree.cpython-38.pyc,,
pip/_vendor/html5lib/treebuilders/__pycache__/etree_lxml.cpython-38.pyc,,
pip/_vendor/html5lib/treebuilders/base.py,sha256=wQGp5yy22TNG8tJ6aREe4UUeTR7A99dEz0BXVaedWb4,14579
pip/_vendor/html5lib/treebuilders/dom.py,sha256=22whb0C71zXIsai5mamg6qzBEiigcBIvaDy4Asw3at0,8925
pip/_vendor/html5lib/treebuilders/etree.py,sha256=aqIBOGj_dFYqBURIcTegGNBhAIJOw5iFDHb4jrkYH-8,12764
pip/_vendor/html5lib/treebuilders/etree_lxml.py,sha256=9V0dXxbJYYq-Skgb5-_OL2NkVYpjioEb4CHajo0e9yI,14122
pip/_vendor/html5lib/treewalkers/__init__.py,sha256=yhXxHpjlSqfQyUag3v8-vWjMPriFBU8YRAPNpDgBTn8,5714
pip/_vendor/html5lib/treewalkers/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/html5lib/treewalkers/__pycache__/base.cpython-38.pyc,,
pip/_vendor/html5lib/treewalkers/__pycache__/dom.cpython-38.pyc,,
pip/_vendor/html5lib/treewalkers/__pycache__/etree.cpython-38.pyc,,
pip/_vendor/html5lib/treewalkers/__pycache__/etree_lxml.cpython-38.pyc,,
pip/_vendor/html5lib/treewalkers/__pycache__/genshi.cpython-38.pyc,,
pip/_vendor/html5lib/treewalkers/base.py,sha256=ouiOsuSzvI0KgzdWP8PlxIaSNs9falhbiinAEc_UIJY,7476
pip/_vendor/html5lib/treewalkers/dom.py,sha256=EHyFR8D8lYNnyDU9lx_IKigVJRyecUGua0mOi7HBukc,1413
pip/_vendor/html5lib/treewalkers/etree.py,sha256=sz1o6mmE93NQ53qJFDO7HKyDtuwgK-Ay3qSFZPC6u00,4550
pip/_vendor/html5lib/treewalkers/etree_lxml.py,sha256=sY6wfRshWTllu6n48TPWpKsQRPp-0CQrT0hj_AdzHSU,6309
pip/_vendor/html5lib/treewalkers/genshi.py,sha256=4D2PECZ5n3ZN3qu3jMl9yY7B81jnQApBQSVlfaIuYbA,2309
pip/_vendor/idna/__init__.py,sha256=9Nt7xpyet3DmOrPUGooDdAwmHZZu1qUAy2EaJ93kGiQ,58
pip/_vendor/idna/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/idna/__pycache__/codec.cpython-38.pyc,,
pip/_vendor/idna/__pycache__/compat.cpython-38.pyc,,
pip/_vendor/idna/__pycache__/core.cpython-38.pyc,,
pip/_vendor/idna/__pycache__/idnadata.cpython-38.pyc,,
pip/_vendor/idna/__pycache__/intranges.cpython-38.pyc,,
pip/_vendor/idna/__pycache__/package_data.cpython-38.pyc,,
pip/_vendor/idna/__pycache__/uts46data.cpython-38.pyc,,
pip/_vendor/idna/codec.py,sha256=lvYb7yu7PhAqFaAIAdWcwgaWI2UmgseUua-1c0AsG0A,3299
pip/_vendor/idna/compat.py,sha256=R-h29D-6mrnJzbXxymrWUW7iZUvy-26TQwZ0ij57i4U,232
pip/_vendor/idna/core.py,sha256=JDCZZ_PLESqIgEbU8mPyoEufWwoOiIqygA17-QZIe3s,11733
pip/_vendor/idna/idnadata.py,sha256=HXaPFw6_YAJ0qppACPu0YLAULtRs3QovRM_CCZHGdY0,40899
pip/_vendor/idna/intranges.py,sha256=TY1lpxZIQWEP6tNqjZkFA5hgoMWOj1OBmnUG8ihT87E,1749
pip/_vendor/idna/package_data.py,sha256=kIzeKKXEouXLR4srqwf9Q3zv-NffKSOz5aSDOJARPB0,21
pip/_vendor/idna/uts46data.py,sha256=oLyNZ1pBaiBlj9zFzLFRd_P7J8MkRcgDisjExZR_4MY,198292
pip/_vendor/ipaddress.py,sha256=2OgbkeAD2rLkcXqbcvof3J5R7lRwjNLoBySyTkBtKnc,79852
pip/_vendor/msgpack/__init__.py,sha256=LnKzG5v0RyZgs7KlY2-SZYDBn-toylovXxKiXR6C-IQ,1535
pip/_vendor/msgpack/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/msgpack/__pycache__/_version.cpython-38.pyc,,
pip/_vendor/msgpack/__pycache__/exceptions.cpython-38.pyc,,
pip/_vendor/msgpack/__pycache__/fallback.cpython-38.pyc,,
pip/_vendor/msgpack/_version.py,sha256=72BxB5FMl1q3Nz1hteHINzHhrFpXQ9nNtULaK52NLk8,20
pip/_vendor/msgpack/exceptions.py,sha256=dCTWei8dpkrMsQDcjQk74ATl9HsIBH0ybt8zOPNqMYc,1081
pip/_vendor/msgpack/fallback.py,sha256=vXo6S67Dmil9mz0PRBCLDu6znpv6CGKt9WPCEsdZx2A,37454
pip/_vendor/packaging/__about__.py,sha256=CpuMSyh1V7adw8QMjWKkY3LtdqRUkRX4MgJ6nF4stM0,744
pip/_vendor/packaging/__init__.py,sha256=6enbp5XgRfjBjsI9-bn00HjHf5TH21PDMOKkJW8xw-w,562
pip/_vendor/packaging/__pycache__/__about__.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/_compat.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/_structures.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/markers.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/requirements.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/specifiers.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/tags.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/utils.cpython-38.pyc,,
pip/_vendor/packaging/__pycache__/version.cpython-38.pyc,,
pip/_vendor/packaging/_compat.py,sha256=Ugdm-qcneSchW25JrtMIKgUxfEEBcCAz6WrEeXeqz9o,865
pip/_vendor/packaging/_structures.py,sha256=pVd90XcXRGwpZRB_qdFuVEibhCHpX_bL5zYr9-N0mc8,1416
pip/_vendor/packaging/markers.py,sha256=jRoHXMzT_7InY31pBB9Nkx66COZpQBAwa5scHla9uVQ,8250
pip/_vendor/packaging/requirements.py,sha256=grcnFU8x7KD230JaFLXtWl3VClLuOmsOy4c-m55tOWs,4700
pip/_vendor/packaging/specifiers.py,sha256=0ZzQpcUnvrQ6LjR-mQRLzMr8G6hdRv-mY0VSf_amFtI,27778
pip/_vendor/packaging/tags.py,sha256=EPLXhO6GTD7_oiWEO1U0l0PkfR8R_xivpMDHXnsTlts,12933
pip/_vendor/packaging/utils.py,sha256=VaTC0Ei7zO2xl9ARiWmz2YFLFt89PuuhLbAlXMyAGms,1520
pip/_vendor/packaging/version.py,sha256=Npdwnb8OHedj_2L86yiUqscujb7w_i5gmSK1PhOAFzg,11978
pip/_vendor/pep517/__init__.py,sha256=nCw8ZdLH4c19g8xP_Ndag1KPdQhlSDKaL9pg-X7uNWU,84
pip/_vendor/pep517/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/_in_process.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/build.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/check.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/colorlog.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/compat.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/dirtools.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/envbuild.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/meta.cpython-38.pyc,,
pip/_vendor/pep517/__pycache__/wrappers.cpython-38.pyc,,
pip/_vendor/pep517/_in_process.py,sha256=v1Viek27-MGCOFu8eSlLd2jGCrIqc1fISnutGFoRDps,7792
pip/_vendor/pep517/build.py,sha256=WqM0-X4KyzY566qxGf3FeaYc1hw95H7YP0ElZ1zuTb0,3318
pip/_vendor/pep517/check.py,sha256=ST02kRWBrRMOxgnRm9clw18Q2X7sJGaD4j3h6GmBhJ8,5949
pip/_vendor/pep517/colorlog.py,sha256=Tk9AuYm_cLF3BKTBoSTJt9bRryn0aFojIQOwbfVUTxQ,4098
pip/_vendor/pep517/compat.py,sha256=M-5s4VNp8rjyT76ZZ_ibnPD44DYVzSQlyCEHayjtDPw,780
pip/_vendor/pep517/dirtools.py,sha256=2mkAkAL0mRz_elYFjRKuekTJVipH1zTn4tbf1EDev84,1129
pip/_vendor/pep517/envbuild.py,sha256=K4dIGAbkXf3RoQX_9RFpZvMvPrVSHtcbH7o9VSrNnlM,6024
pip/_vendor/pep517/meta.py,sha256=8mnM5lDnT4zXQpBTliJbRGfesH7iioHwozbDxALPS9Y,2463
pip/_vendor/pep517/wrappers.py,sha256=QiQaEQlfCrhRpPBFQiGVM9QjrKSlj8AvM39haoyfPRk,10599
pip/_vendor/pkg_resources/__init__.py,sha256=hnT0Ph4iK40Ycr-OzSii_wZW5f7HCkP79E6Vf4cR3Vg,108237
pip/_vendor/pkg_resources/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/pkg_resources/__pycache__/py31compat.cpython-38.pyc,,
pip/_vendor/pkg_resources/py31compat.py,sha256=CRk8fkiPRDLsbi5pZcKsHI__Pbmh_94L8mr9Qy9Ab2U,562
pip/_vendor/progress/__init__.py,sha256=fcbQQXo5np2CoQyhSH5XprkicwLZNLePR3uIahznSO0,4857
pip/_vendor/progress/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/progress/__pycache__/bar.cpython-38.pyc,,
pip/_vendor/progress/__pycache__/counter.cpython-38.pyc,,
pip/_vendor/progress/__pycache__/spinner.cpython-38.pyc,,
pip/_vendor/progress/bar.py,sha256=QuDuVNcmXgpxtNtxO0Fq72xKigxABaVmxYGBw4J3Z_E,2854
pip/_vendor/progress/counter.py,sha256=MznyBrvPWrOlGe4MZAlGUb9q3aODe6_aNYeAE_VNoYA,1372
pip/_vendor/progress/spinner.py,sha256=k8JbDW94T0-WXuXfxZIFhdoNPYp3jfnpXqBnfRv5fGs,1380
pip/_vendor/pyparsing.py,sha256=uJuFv_UoLmKOHlCU-EhIiKjYqYS2OCj-Gmr-sRkCzmU,263468
pip/_vendor/pytoml/__init__.py,sha256=W_SKx36Hsew-Fty36BOpreLm4uF4V_Tgkm_z9rIoOE8,127
pip/_vendor/pytoml/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/pytoml/__pycache__/core.cpython-38.pyc,,
pip/_vendor/pytoml/__pycache__/parser.cpython-38.pyc,,
pip/_vendor/pytoml/__pycache__/test.cpython-38.pyc,,
pip/_vendor/pytoml/__pycache__/utils.cpython-38.pyc,,
pip/_vendor/pytoml/__pycache__/writer.cpython-38.pyc,,
pip/_vendor/pytoml/core.py,sha256=9CrLLTs1PdWjEwRnYzt_i4dhHcZvGxs_GsMlYAX3iY4,509
pip/_vendor/pytoml/parser.py,sha256=qsc0NRnTgdFZgRp9gmr6D_KWFelrwxLkTj9dVxUcqS8,10309
pip/_vendor/pytoml/test.py,sha256=2nQs4aX3XQEaaQCx6x_OJTS2Hb0_IiTZRqNOeDmLCzo,1021
pip/_vendor/pytoml/utils.py,sha256=JCLHx77Hu1R3F-bRgiROIiKyCzLwyebnp5P35cRJxWs,1665
pip/_vendor/pytoml/writer.py,sha256=4QQky9JSuRv60uzuhVZASU8T3CuobSkLG1285X6bDW8,3369
pip/_vendor/requests/__init__.py,sha256=ONVsH6kJuPTV9nf-XVoubWsVX3qVtjCyju42kTW6Uug,4074
pip/_vendor/requests/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/__version__.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/_internal_utils.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/adapters.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/api.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/auth.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/certs.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/compat.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/cookies.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/exceptions.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/help.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/hooks.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/models.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/packages.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/sessions.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/status_codes.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/structures.cpython-38.pyc,,
pip/_vendor/requests/__pycache__/utils.cpython-38.pyc,,
pip/_vendor/requests/__version__.py,sha256=Bm-GFstQaFezsFlnmEMrJDe8JNROz9n2XXYtODdvjjc,436
pip/_vendor/requests/_internal_utils.py,sha256=Zx3PnEUccyfsB-ie11nZVAW8qClJy0gx1qNME7rgT18,1096
pip/_vendor/requests/adapters.py,sha256=e-bmKEApNVqFdylxuMJJfiaHdlmS_zhWhIMEzlHvGuc,21548
pip/_vendor/requests/api.py,sha256=fbUo11QoLOoNgWU6FfvNz8vMj9bE_cMmICXBa7TZHJs,6271
pip/_vendor/requests/auth.py,sha256=QB2-cSUj1jrvWZfPXttsZpyAacQgtKLVk14vQW9TpSE,10206
pip/_vendor/requests/certs.py,sha256=nXRVq9DtGmv_1AYbwjTu9UrgAcdJv05ZvkNeaoLOZxY,465
pip/_vendor/requests/compat.py,sha256=FZX4Q_EMKiMnhZpZ3g_gOsT-j2ca9ij2gehDx1cwYeo,1941
pip/_vendor/requests/cookies.py,sha256=Y-bKX6TvW3FnYlE6Au0SXtVVWcaNdFvuAwQxw-G0iTI,18430
pip/_vendor/requests/exceptions.py,sha256=-mLam3TAx80V09EaH3H-ZxR61eAVuLRZ8zgBBSLjK44,3197
pip/_vendor/requests/help.py,sha256=SJPVcoXeo7KfK4AxJN5eFVQCjr0im87tU2n7ubLsksU,3578
pip/_vendor/requests/hooks.py,sha256=QReGyy0bRcr5rkwCuObNakbYsc7EkiKeBwG4qHekr2Q,757
pip/_vendor/requests/models.py,sha256=6s-37iAqXVptq8z7U_LoH_pbIPrCQUm_Z8QuIGE29Q0,34275
pip/_vendor/requests/packages.py,sha256=njJmVifY4aSctuW3PP5EFRCxjEwMRDO6J_feG2dKWsI,695
pip/_vendor/requests/sessions.py,sha256=DjbCotDW6xSAaBsjbW-L8l4N0UcwmrxVNgSrZgIjGWM,29332
pip/_vendor/requests/status_codes.py,sha256=XWlcpBjbCtq9sSqpH9_KKxgnLTf9Z__wCWolq21ySlg,4129
pip/_vendor/requests/structures.py,sha256=zoP8qly2Jak5e89HwpqjN1z2diztI-_gaqts1raJJBc,2981
pip/_vendor/requests/utils.py,sha256=LtPJ1db6mJff2TJSJWKi7rBpzjPS3mSOrjC9zRhoD3A,30049
pip/_vendor/retrying.py,sha256=k3fflf5_Mm0XcIJYhB7Tj34bqCCPhUDkYbx1NvW2FPE,9972
pip/_vendor/six.py,sha256=h9jch2pS86y4R36pKRS3LOYUCVFNIJMRwjZ4fJDtJ44,32452
pip/_vendor/urllib3/__init__.py,sha256=cedaGRiXnA8WzcI3WPbb9u2Al9l2ortwfXZSQ4yFHHU,2683
pip/_vendor/urllib3/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/_collections.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/connection.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/connectionpool.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/exceptions.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/fields.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/filepost.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/poolmanager.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/request.cpython-38.pyc,,
pip/_vendor/urllib3/__pycache__/response.cpython-38.pyc,,
pip/_vendor/urllib3/_collections.py,sha256=GouVsNzwg6jADZTmimMI6oqmwKSswnMo9dh5tGNVWO4,10792
pip/_vendor/urllib3/connection.py,sha256=p7uUWh3cP0hgja8fFlzfZvwVxviJa8-C5cx9G3wQ5-o,15170
pip/_vendor/urllib3/connectionpool.py,sha256=NYYFYX-L9XO4tQMU7ug5ABidsmGKVSE2_X4XMggzwxk,36446
pip/_vendor/urllib3/contrib/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/_appengine_environ.py,sha256=tJvMXygi5UnFn4tmCHtrXOQIqy1FAfZoDDK36Q35F1I,707
pip/_vendor/urllib3/contrib/_securetransport/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-38.pyc,,
pip/_vendor/urllib3/contrib/_securetransport/bindings.py,sha256=ZuSEVZwiubk0oaVmkZa8bUoK9ACVJJhPVgRzPZN6KoQ,16805
pip/_vendor/urllib3/contrib/_securetransport/low_level.py,sha256=V7GnujxnWZh2N2sMsV5N4d9Imymokkm3zBwgt77_bSE,11956
pip/_vendor/urllib3/contrib/appengine.py,sha256=CosoKgcu5PE5COkPSGa7Q5AFzh9XWAf0PTBU7LSBE7A,11314
pip/_vendor/urllib3/contrib/ntlmpool.py,sha256=YnWc2-np7Rzi2LfCxJ2fEprhGkeZDSjQFdJuTQ5vuUE,4201
pip/_vendor/urllib3/contrib/pyopenssl.py,sha256=w35mWy_1POZUsbOhurVb_zhf0C1Jkd79AFlucLs6KuQ,16440
pip/_vendor/urllib3/contrib/securetransport.py,sha256=_vByA8KzFPxn9x67hilAPu9wpoKDS9fU3K1DVavEk74,32742
pip/_vendor/urllib3/contrib/socks.py,sha256=nzDMgDIFJWVubKHqvIn2-SKCO91hhJInP92WgHChGzA,7036
pip/_vendor/urllib3/exceptions.py,sha256=_tiSmwYQ8em6OSr5GPO5hpbCG8q0DTIuJ2F7NMEyDyc,6610
pip/_vendor/urllib3/fields.py,sha256=kroD76QK-GdHHW7f_AUN4XxDC3OQPI2FFrS9eSL4BCs,8553
pip/_vendor/urllib3/filepost.py,sha256=vj0qbrpT1AFzvvW4SuC8M5kJiw7wftHcSr-7b8UpPpw,2440
pip/_vendor/urllib3/packages/__init__.py,sha256=h4BLhD4tLaBx1adaDtKXfupsgqY0wWLXb_f1_yVlV6A,108
pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/urllib3/packages/__pycache__/six.cpython-38.pyc,,
pip/_vendor/urllib3/packages/backports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-38.pyc,,
pip/_vendor/urllib3/packages/backports/makefile.py,sha256=005wrvH-_pWSnTFqQ2sdzzh4zVCtQUUQ4mR2Yyxwc0A,1418
pip/_vendor/urllib3/packages/six.py,sha256=adx4z-eM_D0Vvu0IIqVzFACQ_ux9l64y7DkSEfbxCDs,32536
pip/_vendor/urllib3/packages/ssl_match_hostname/__init__.py,sha256=ywgKMtfHi1-DrXlzPfVAhzsLzzqcK7GT6eLgdode1Fg,688
pip/_vendor/urllib3/packages/ssl_match_hostname/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/urllib3/packages/ssl_match_hostname/__pycache__/_implementation.cpython-38.pyc,,
pip/_vendor/urllib3/packages/ssl_match_hostname/_implementation.py,sha256=EFrDbzAs-pV-Fm1HeuAqLl2mJ6MS23LwxYiukKrtf9U,5724
pip/_vendor/urllib3/poolmanager.py,sha256=JYUyBUN3IiEknUdjZ7VJrpCQr6SP7vi0WwSndrn8XpE,17053
pip/_vendor/urllib3/request.py,sha256=hhoHvEEatyd9Tn5EbGjQ0emn-ENMCyY591yNWTneINA,6018
pip/_vendor/urllib3/response.py,sha256=O2DVzBeWOzyxZDZ8k0EDFU3GW1jWXk_b03mS0O1ybxs,27836
pip/_vendor/urllib3/util/__init__.py,sha256=bWNaav_OT-1L7-sxm59cGb59rDORlbhb_4noduM5m0U,1038
pip/_vendor/urllib3/util/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/connection.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/queue.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/request.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/response.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/retry.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/timeout.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/url.cpython-38.pyc,,
pip/_vendor/urllib3/util/__pycache__/wait.cpython-38.pyc,,
pip/_vendor/urllib3/util/connection.py,sha256=fOXAQ288KHaXmdTlDv5drwScDk9taQ9YzT42xegxzTg,4636
pip/_vendor/urllib3/util/queue.py,sha256=myTX3JDHntglKQNBf3b6dasHH-uF-W59vzGSQiFdAfI,497
pip/_vendor/urllib3/util/request.py,sha256=_LJPqQXTYA_9c0syijP8Bmj72BeKNO9PXBk62oM7HQY,3821
pip/_vendor/urllib3/util/response.py,sha256=_WbTQr8xRQuJuY2rTIZxVdJD6mnEOtQupjaK_bF_Vj8,2573
pip/_vendor/urllib3/util/retry.py,sha256=Ui74h44gLIIWkAxT9SK3A2mEvu55-odWgJMw3LiUNGk,15450
pip/_vendor/urllib3/util/ssl_.py,sha256=7mB3AsidIqLLq6gbeBL-7Ta0MyVOL5uZax8_5bH3y7c,14163
pip/_vendor/urllib3/util/timeout.py,sha256=2g39u7rU68ilOcGhP1sVzySm4yWDbiY1LxCjsrCrMk8,9874
pip/_vendor/urllib3/util/url.py,sha256=8rFC9RmQVDZuYlqBvlDUm7wcG7N4emdEWe0jQ101lzE,14313
pip/_vendor/urllib3/util/wait.py,sha256=k46KzqIYu3Vnzla5YW3EvtInNlU_QycFqQAghIOxoAg,5406
pip/_vendor/webencodings/__init__.py,sha256=qOBJIuPy_4ByYH6W_bNgJF-qYQ2DoU-dKsDu5yRWCXg,10579
pip/_vendor/webencodings/__pycache__/__init__.cpython-38.pyc,,
pip/_vendor/webencodings/__pycache__/labels.cpython-38.pyc,,
pip/_vendor/webencodings/__pycache__/mklabels.cpython-38.pyc,,
pip/_vendor/webencodings/__pycache__/tests.cpython-38.pyc,,
pip/_vendor/webencodings/__pycache__/x_user_defined.cpython-38.pyc,,
pip/_vendor/webencodings/labels.py,sha256=4AO_KxTddqGtrL9ns7kAPjb0CcN6xsCIxbK37HY9r3E,8979
pip/_vendor/webencodings/mklabels.py,sha256=GYIeywnpaLnP0GSic8LFWgd0UVvO_l1Nc6YoF-87R_4,1305
pip/_vendor/webencodings/tests.py,sha256=OtGLyjhNY1fvkW1GvLJ_FV9ZoqC9Anyjr7q3kxTbzNs,6563
pip/_vendor/webencodings/x_user_defined.py,sha256=yOqWSdmpytGfUgh_Z6JYgDNhoc-BAHyyeeT15Fr42tM,4307
site-packages/pip-19.3.1.dist-info/top_level.txt000064400000000004151446176770015244 0ustar00pip
site-packages/pip-19.3.1.dist-info/LICENSE.txt000064400000002102151446176770014336 0ustar00Copyright (c) 2008-2019 The pip developers (see AUTHORS.txt file)

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
site-packages/setuptools-41.6.0.dist-info/zip-safe000064400000000001151446176770015576 0ustar00
site-packages/setuptools-41.6.0.dist-info/dependency_links.txt000064400000000357151446176770020232 0ustar00https://files.pythonhosted.org/packages/source/c/certifi/certifi-2016.9.26.tar.gz#md5=baa81e951a29958563689d868ef1064d
https://files.pythonhosted.org/packages/source/w/wincertstore/wincertstore-0.2.zip#md5=ae728f2f007185648d0c7a8679b361e2
site-packages/setuptools-41.6.0.dist-info/WHEEL000064400000000156151446176770014737 0ustar00Wheel-Version: 1.0
Generator: bdist_wheel (0.33.6)
Root-Is-Purelib: true
Tag: py2-none-any
Tag: py3-none-any

site-packages/setuptools-41.6.0.dist-info/INSTALLER000064400000000004151446176770015420 0ustar00pip
site-packages/setuptools-41.6.0.dist-info/LICENSE000064400000002066151446176770015157 0ustar00Copyright (C) 2016 Jason R Coombs <jaraco@jaraco.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
site-packages/setuptools-41.6.0.dist-info/entry_points.txt000064400000005656151446176770017460 0ustar00[console_scripts]
easy_install = setuptools.command.easy_install:main
easy_install-3.8 = setuptools.command.easy_install:main

[distutils.commands]
alias = setuptools.command.alias:alias
bdist_egg = setuptools.command.bdist_egg:bdist_egg
bdist_rpm = setuptools.command.bdist_rpm:bdist_rpm
bdist_wininst = setuptools.command.bdist_wininst:bdist_wininst
build_clib = setuptools.command.build_clib:build_clib
build_ext = setuptools.command.build_ext:build_ext
build_py = setuptools.command.build_py:build_py
develop = setuptools.command.develop:develop
dist_info = setuptools.command.dist_info:dist_info
easy_install = setuptools.command.easy_install:easy_install
egg_info = setuptools.command.egg_info:egg_info
install = setuptools.command.install:install
install_egg_info = setuptools.command.install_egg_info:install_egg_info
install_lib = setuptools.command.install_lib:install_lib
install_scripts = setuptools.command.install_scripts:install_scripts
register = setuptools.command.register:register
rotate = setuptools.command.rotate:rotate
saveopts = setuptools.command.saveopts:saveopts
sdist = setuptools.command.sdist:sdist
setopt = setuptools.command.setopt:setopt
test = setuptools.command.test:test
upload = setuptools.command.upload:upload
upload_docs = setuptools.command.upload_docs:upload_docs

[distutils.setup_keywords]
convert_2to3_doctests = setuptools.dist:assert_string_list
dependency_links = setuptools.dist:assert_string_list
eager_resources = setuptools.dist:assert_string_list
entry_points = setuptools.dist:check_entry_points
exclude_package_data = setuptools.dist:check_package_data
extras_require = setuptools.dist:check_extras
include_package_data = setuptools.dist:assert_bool
install_requires = setuptools.dist:check_requirements
namespace_packages = setuptools.dist:check_nsp
package_data = setuptools.dist:check_package_data
packages = setuptools.dist:check_packages
python_requires = setuptools.dist:check_specifier
setup_requires = setuptools.dist:check_requirements
test_loader = setuptools.dist:check_importable
test_runner = setuptools.dist:check_importable
test_suite = setuptools.dist:check_test_suite
tests_require = setuptools.dist:check_requirements
use_2to3 = setuptools.dist:assert_bool
use_2to3_exclude_fixers = setuptools.dist:assert_string_list
use_2to3_fixers = setuptools.dist:assert_string_list
zip_safe = setuptools.dist:assert_bool

[egg_info.writers]
PKG-INFO = setuptools.command.egg_info:write_pkg_info
dependency_links.txt = setuptools.command.egg_info:overwrite_arg
depends.txt = setuptools.command.egg_info:warn_depends_obsolete
eager_resources.txt = setuptools.command.egg_info:overwrite_arg
entry_points.txt = setuptools.command.egg_info:write_entries
namespace_packages.txt = setuptools.command.egg_info:overwrite_arg
requires.txt = setuptools.command.egg_info:write_requirements
top_level.txt = setuptools.command.egg_info:write_toplevel_names

[setuptools.installation]
eggsecutable = setuptools.command.easy_install:bootstrap

site-packages/setuptools-41.6.0.dist-info/METADATA000064400000006433151446176770015257 0ustar00Metadata-Version: 2.1
Name: setuptools
Version: 41.6.0
Summary: Easily download, build, install, upgrade, and uninstall Python packages
Home-page: https://github.com/pypa/setuptools
Author: Python Packaging Authority
Author-email: distutils-sig@python.org
License: UNKNOWN
Project-URL: Documentation, https://setuptools.readthedocs.io/
Keywords: CPAN PyPI distutils eggs package management
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Archiving :: Packaging
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: !=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,>=2.7
Description-Content-Type: text/x-rst; charset=UTF-8
Provides-Extra: certs
Requires-Dist: certifi (==2016.9.26) ; extra == 'certs'
Provides-Extra: ssl
Requires-Dist: wincertstore (==0.2) ; (sys_platform == "win32") and extra == 'ssl'

.. image:: https://img.shields.io/pypi/v/setuptools.svg
   :target: https://pypi.org/project/setuptools

.. image:: https://img.shields.io/readthedocs/setuptools/latest.svg
    :target: https://setuptools.readthedocs.io

.. image:: https://img.shields.io/travis/pypa/setuptools/master.svg?label=Linux%20CI&logo=travis&logoColor=white
   :target: https://travis-ci.org/pypa/setuptools

.. image:: https://img.shields.io/appveyor/ci/pypa/setuptools/master.svg?label=Windows%20CI&logo=appveyor&logoColor=white
   :target: https://ci.appveyor.com/project/pypa/setuptools/branch/master

.. image:: https://img.shields.io/codecov/c/github/pypa/setuptools/master.svg?logo=codecov&logoColor=white
   :target: https://codecov.io/gh/pypa/setuptools

.. image:: https://tidelift.com/badges/github/pypa/setuptools?style=flat
   :target: https://tidelift.com/subscription/pkg/pypi-setuptools?utm_source=pypi-setuptools&utm_medium=readme

.. image:: https://img.shields.io/pypi/pyversions/setuptools.svg

See the `Installation Instructions
<https://packaging.python.org/installing/>`_ in the Python Packaging
User's Guide for instructions on installing, upgrading, and uninstalling
Setuptools.

Questions and comments should be directed to the `distutils-sig
mailing list <http://mail.python.org/pipermail/distutils-sig/>`_.
Bug reports and especially tested patches may be
submitted directly to the `bug tracker
<https://github.com/pypa/setuptools/issues>`_.

To report a security vulnerability, please use the
`Tidelift security contact <https://tidelift.com/security>`_.
Tidelift will coordinate the fix and disclosure.


Code of Conduct
---------------

Everyone interacting in the setuptools project's codebases, issue trackers,
chat rooms, and mailing lists is expected to follow the
`PyPA Code of Conduct <https://www.pypa.io/en/latest/code-of-conduct/>`_.


site-packages/setuptools-41.6.0.dist-info/RECORD000064400000032734151446176770015060 0ustar00../../../bin/easy_install,sha256=kyVHjd3KmOt_Hd-ehMBXo7pGpLnKgL4ShtrVFRGdt3E,232
../../../bin/easy_install-3.8,sha256=kyVHjd3KmOt_Hd-ehMBXo7pGpLnKgL4ShtrVFRGdt3E,232
__pycache__/easy_install.cpython-38.pyc,,
easy_install.py,sha256=MDC9vt5AxDsXX5qcKlBz2TnW6Tpuv_AobnfhCJ9X3PM,126
pkg_resources/__init__.py,sha256=8L9Xzt6qtgAwlbk95DVBMbFflwoxjIbnikZkRjdJU7U,108349
pkg_resources/__pycache__/__init__.cpython-38.pyc,,
pkg_resources/__pycache__/py31compat.cpython-38.pyc,,
pkg_resources/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
pkg_resources/_vendor/__pycache__/__init__.cpython-38.pyc,,
pkg_resources/_vendor/__pycache__/appdirs.cpython-38.pyc,,
pkg_resources/_vendor/__pycache__/pyparsing.cpython-38.pyc,,
pkg_resources/_vendor/__pycache__/six.cpython-38.pyc,,
pkg_resources/_vendor/appdirs.py,sha256=C1zpkt179PgsJ4dspL09N-HhOxy6bkTSxUj2_vG6Hkw,24679
pkg_resources/_vendor/packaging/__about__.py,sha256=zkcCPTN_6TcLW0Nrlg0176-R1QQ_WVPTm8sz1R4-HjM,720
pkg_resources/_vendor/packaging/__init__.py,sha256=_vNac5TrzwsrzbOFIbF-5cHqc_Y2aPT2D7zrIR06BOo,513
pkg_resources/_vendor/packaging/__pycache__/__about__.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/__init__.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/_compat.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/_structures.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/markers.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/requirements.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/specifiers.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/utils.cpython-38.pyc,,
pkg_resources/_vendor/packaging/__pycache__/version.cpython-38.pyc,,
pkg_resources/_vendor/packaging/_compat.py,sha256=Vi_A0rAQeHbU-a9X0tt1yQm9RqkgQbDSxzRw8WlU9kA,860
pkg_resources/_vendor/packaging/_structures.py,sha256=RImECJ4c_wTlaTYYwZYLHEiebDMaAJmK1oPARhw1T5o,1416
pkg_resources/_vendor/packaging/markers.py,sha256=uEcBBtGvzqltgnArqb9c4RrcInXezDLos14zbBHhWJo,8248
pkg_resources/_vendor/packaging/requirements.py,sha256=SikL2UynbsT0qtY9ltqngndha_sfo0w6XGFhAhoSoaQ,4355
pkg_resources/_vendor/packaging/specifiers.py,sha256=SAMRerzO3fK2IkFZCaZkuwZaL_EGqHNOz4pni4vhnN0,28025
pkg_resources/_vendor/packaging/utils.py,sha256=3m6WvPm6NNxE8rkTGmn0r75B_GZSGg7ikafxHsBN1WA,421
pkg_resources/_vendor/packaging/version.py,sha256=OwGnxYfr2ghNzYx59qWIBkrK3SnB6n-Zfd1XaLpnnM0,11556
pkg_resources/_vendor/pyparsing.py,sha256=tmrp-lu-qO1i75ZzIN5A12nKRRD1Cm4Vpk-5LR9rims,232055
pkg_resources/_vendor/six.py,sha256=A6hdJZVjI3t_geebZ9BzUvwRrIXo0lfwzQlM2LcKyas,30098
pkg_resources/extern/__init__.py,sha256=cHiEfHuLmm6rs5Ve_ztBfMI7Lr31vss-D4wkqF5xzlI,2498
pkg_resources/extern/__pycache__/__init__.cpython-38.pyc,,
pkg_resources/py31compat.py,sha256=-WQ0e4c3RG_acdhwC3gLiXhP_lg4G5q7XYkZkQg0gxU,558
setuptools-41.6.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
setuptools-41.6.0.dist-info/LICENSE,sha256=wyo6w5WvYyHv0ovnPQagDw22q4h9HCHU_sRhKNIFbVo,1078
setuptools-41.6.0.dist-info/METADATA,sha256=C4M3emJvpj_5ir5cWHN7qwqzqSdoNn90zBzQzCZcfEw,3355
setuptools-41.6.0.dist-info/RECORD,,
setuptools-41.6.0.dist-info/WHEEL,sha256=8zNYZbwQSXoB9IfXOjPfeNwvAsALAjffgk27FqvCWbo,110
setuptools-41.6.0.dist-info/dependency_links.txt,sha256=HlkCFkoK5TbZ5EMLbLKYhLcY_E31kBWD8TqW2EgmatQ,239
setuptools-41.6.0.dist-info/entry_points.txt,sha256=t51hYQSHTv2cDVO8fdyd3huPmuBPr2aDcevvakP7lbI,2990
setuptools-41.6.0.dist-info/top_level.txt,sha256=2HUXVVwA4Pff1xgTFr3GsTXXKaPaO6vlG6oNJ_4u4Tg,38
setuptools-41.6.0.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
setuptools/__init__.py,sha256=WBpCcn2lvdckotabeae1TTYonPOcgCIF3raD2zRWzBc,7283
setuptools/__pycache__/__init__.cpython-38.pyc,,
setuptools/__pycache__/_deprecation_warning.cpython-38.pyc,,
setuptools/__pycache__/_imp.cpython-38.pyc,,
setuptools/__pycache__/archive_util.cpython-38.pyc,,
setuptools/__pycache__/build_meta.cpython-38.pyc,,
setuptools/__pycache__/config.cpython-38.pyc,,
setuptools/__pycache__/dep_util.cpython-38.pyc,,
setuptools/__pycache__/depends.cpython-38.pyc,,
setuptools/__pycache__/dist.cpython-38.pyc,,
setuptools/__pycache__/extension.cpython-38.pyc,,
setuptools/__pycache__/glibc.cpython-38.pyc,,
setuptools/__pycache__/glob.cpython-38.pyc,,
setuptools/__pycache__/launch.cpython-38.pyc,,
setuptools/__pycache__/lib2to3_ex.cpython-38.pyc,,
setuptools/__pycache__/monkey.cpython-38.pyc,,
setuptools/__pycache__/msvc.cpython-38.pyc,,
setuptools/__pycache__/namespaces.cpython-38.pyc,,
setuptools/__pycache__/package_index.cpython-38.pyc,,
setuptools/__pycache__/pep425tags.cpython-38.pyc,,
setuptools/__pycache__/py27compat.cpython-38.pyc,,
setuptools/__pycache__/py31compat.cpython-38.pyc,,
setuptools/__pycache__/py33compat.cpython-38.pyc,,
setuptools/__pycache__/py34compat.cpython-38.pyc,,
setuptools/__pycache__/sandbox.cpython-38.pyc,,
setuptools/__pycache__/site-patch.cpython-38.pyc,,
setuptools/__pycache__/ssl_support.cpython-38.pyc,,
setuptools/__pycache__/unicode_utils.cpython-38.pyc,,
setuptools/__pycache__/version.cpython-38.pyc,,
setuptools/__pycache__/wheel.cpython-38.pyc,,
setuptools/__pycache__/windows_support.cpython-38.pyc,,
setuptools/_deprecation_warning.py,sha256=jU9-dtfv6cKmtQJOXN8nP1mm7gONw5kKEtiPtbwnZyI,218
setuptools/_imp.py,sha256=jloslOkxrTKbobgemfP94YII0nhqiJzE1bRmCTZ1a5I,2223
setuptools/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
setuptools/_vendor/__pycache__/__init__.cpython-38.pyc,,
setuptools/_vendor/__pycache__/ordered_set.cpython-38.pyc,,
setuptools/_vendor/__pycache__/pyparsing.cpython-38.pyc,,
setuptools/_vendor/__pycache__/six.cpython-38.pyc,,
setuptools/_vendor/ordered_set.py,sha256=dbaCcs27dyN9gnMWGF5nA_BrVn6Q-NrjKYJpV9_fgBs,15130
setuptools/_vendor/packaging/__about__.py,sha256=zkcCPTN_6TcLW0Nrlg0176-R1QQ_WVPTm8sz1R4-HjM,720
setuptools/_vendor/packaging/__init__.py,sha256=_vNac5TrzwsrzbOFIbF-5cHqc_Y2aPT2D7zrIR06BOo,513
setuptools/_vendor/packaging/__pycache__/__about__.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/__init__.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/_compat.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/_structures.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/markers.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/requirements.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/specifiers.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/utils.cpython-38.pyc,,
setuptools/_vendor/packaging/__pycache__/version.cpython-38.pyc,,
setuptools/_vendor/packaging/_compat.py,sha256=Vi_A0rAQeHbU-a9X0tt1yQm9RqkgQbDSxzRw8WlU9kA,860
setuptools/_vendor/packaging/_structures.py,sha256=RImECJ4c_wTlaTYYwZYLHEiebDMaAJmK1oPARhw1T5o,1416
setuptools/_vendor/packaging/markers.py,sha256=Gvpk9EY20yKaMTiKgQZ8yFEEpodqVgVYtfekoic1Yts,8239
setuptools/_vendor/packaging/requirements.py,sha256=t44M2HVWtr8phIz2OhnILzuGT3rTATaovctV1dpnVIg,4343
setuptools/_vendor/packaging/specifiers.py,sha256=SAMRerzO3fK2IkFZCaZkuwZaL_EGqHNOz4pni4vhnN0,28025
setuptools/_vendor/packaging/utils.py,sha256=3m6WvPm6NNxE8rkTGmn0r75B_GZSGg7ikafxHsBN1WA,421
setuptools/_vendor/packaging/version.py,sha256=OwGnxYfr2ghNzYx59qWIBkrK3SnB6n-Zfd1XaLpnnM0,11556
setuptools/_vendor/pyparsing.py,sha256=tmrp-lu-qO1i75ZzIN5A12nKRRD1Cm4Vpk-5LR9rims,232055
setuptools/_vendor/six.py,sha256=A6hdJZVjI3t_geebZ9BzUvwRrIXo0lfwzQlM2LcKyas,30098
setuptools/archive_util.py,sha256=kw8Ib_lKjCcnPKNbS7h8HztRVK0d5RacU3r_KRdVnmM,6592
setuptools/build_meta.py,sha256=-9Nmj9YdbW4zX3TssPJZhsENrTa4fw3k86Jm1cdKMik,9597
setuptools/command/__init__.py,sha256=NWzJ0A1BEengZpVeqUyWLNm2bk4P3F4iL5QUErHy7kA,594
setuptools/command/__pycache__/__init__.cpython-38.pyc,,
setuptools/command/__pycache__/alias.cpython-38.pyc,,
setuptools/command/__pycache__/bdist_egg.cpython-38.pyc,,
setuptools/command/__pycache__/bdist_rpm.cpython-38.pyc,,
setuptools/command/__pycache__/bdist_wininst.cpython-38.pyc,,
setuptools/command/__pycache__/build_clib.cpython-38.pyc,,
setuptools/command/__pycache__/build_ext.cpython-38.pyc,,
setuptools/command/__pycache__/build_py.cpython-38.pyc,,
setuptools/command/__pycache__/develop.cpython-38.pyc,,
setuptools/command/__pycache__/dist_info.cpython-38.pyc,,
setuptools/command/__pycache__/easy_install.cpython-38.pyc,,
setuptools/command/__pycache__/egg_info.cpython-38.pyc,,
setuptools/command/__pycache__/install.cpython-38.pyc,,
setuptools/command/__pycache__/install_egg_info.cpython-38.pyc,,
setuptools/command/__pycache__/install_lib.cpython-38.pyc,,
setuptools/command/__pycache__/install_scripts.cpython-38.pyc,,
setuptools/command/__pycache__/py36compat.cpython-38.pyc,,
setuptools/command/__pycache__/register.cpython-38.pyc,,
setuptools/command/__pycache__/rotate.cpython-38.pyc,,
setuptools/command/__pycache__/saveopts.cpython-38.pyc,,
setuptools/command/__pycache__/sdist.cpython-38.pyc,,
setuptools/command/__pycache__/setopt.cpython-38.pyc,,
setuptools/command/__pycache__/test.cpython-38.pyc,,
setuptools/command/__pycache__/upload.cpython-38.pyc,,
setuptools/command/__pycache__/upload_docs.cpython-38.pyc,,
setuptools/command/alias.py,sha256=KjpE0sz_SDIHv3fpZcIQK-sCkJz-SrC6Gmug6b9Nkc8,2426
setuptools/command/bdist_egg.py,sha256=nnfV8Ah8IRC_Ifv5Loa9FdxL66MVbyDXwy-foP810zM,18185
setuptools/command/bdist_rpm.py,sha256=B7l0TnzCGb-0nLlm6rS00jWLkojASwVmdhW2w5Qz_Ak,1508
setuptools/command/bdist_wininst.py,sha256=_6dz3lpB1tY200LxKPLM7qgwTCceOMgaWFF-jW2-pm0,637
setuptools/command/build_clib.py,sha256=bQ9aBr-5ZSO-9fGsGsDLz0mnnFteHUZnftVLkhvHDq0,4484
setuptools/command/build_ext.py,sha256=Ib42YUGksBswm2mL5xmQPF6NeTA6HcqrvAtEgFCv32A,13019
setuptools/command/build_py.py,sha256=yWyYaaS9F3o9JbIczn064A5g1C5_UiKRDxGaTqYbtLE,9596
setuptools/command/develop.py,sha256=MQlnGS6uP19erK2JCNOyQYoYyquk3PADrqrrinqqLtA,8184
setuptools/command/dist_info.py,sha256=5t6kOfrdgALT-P3ogss6PF9k-Leyesueycuk3dUyZnI,960
setuptools/command/easy_install.py,sha256=BLJBFm2-rtp-ZZj0SoN1KAd3GH-LGhKV5MrcgIuFx_8,87453
setuptools/command/egg_info.py,sha256=w73EdxYSOk2gsaAiHGL2dZrCldoPiuRr2eTfqcFvCds,25570
setuptools/command/install.py,sha256=a0EZpL_A866KEdhicTGbuyD_TYl1sykfzdrri-zazT4,4683
setuptools/command/install_egg_info.py,sha256=bMgeIeRiXzQ4DAGPV1328kcjwQjHjOWU4FngAWLV78Q,2203
setuptools/command/install_lib.py,sha256=r5NuasaSxvmIrjgZNj38Iq-1UJG1o1ms7CuHq6MCTbQ,3862
setuptools/command/install_scripts.py,sha256=UD0rEZ6861mTYhIdzcsqKnUl8PozocXWl9VBQ1VTWnc,2439
setuptools/command/launcher manifest.xml,sha256=xlLbjWrB01tKC0-hlVkOKkiSPbzMml2eOPtJ_ucCnbE,628
setuptools/command/py36compat.py,sha256=SzjZcOxF7zdFUT47Zv2n7AM3H8koDys_0OpS-n9gIfc,4986
setuptools/command/register.py,sha256=LO3MvYKPE8dN1m-KkrBRHC68ZFoPvA_vI8Xgp7vv6zI,534
setuptools/command/rotate.py,sha256=co5C1EkI7P0GGT6Tqz-T2SIj2LBJTZXYELpmao6d4KQ,2164
setuptools/command/saveopts.py,sha256=za7QCBcQimKKriWcoCcbhxPjUz30gSB74zuTL47xpP4,658
setuptools/command/sdist.py,sha256=gr5hFrDzUtGfp_0tu0sllzIyr3jMQegIkFmlDauQJxw,7388
setuptools/command/setopt.py,sha256=NTWDyx-gjDF-txf4dO577s7LOzHVoKR0Mq33rFxaRr8,5085
setuptools/command/test.py,sha256=u2kXngIIdSYqtvwFlHiN6Iye1IB4TU6uadB2uiV1szw,9602
setuptools/command/upload.py,sha256=GxtNkIl7SA0r8mACkbDcSCN1m2_WPppK9gZXJmQSiow,6811
setuptools/command/upload_docs.py,sha256=oXiGplM_cUKLwE4CWWw98RzCufAu8tBhMC97GegFcms,7311
setuptools/config.py,sha256=Rek2y8zh67yIc5Rs4biqo63jOwYrvsy5gy8SSDJbWU0,20534
setuptools/dep_util.py,sha256=fgixvC1R7sH3r13ktyf7N0FALoqEXL1cBarmNpSEoWg,935
setuptools/depends.py,sha256=qt2RWllArRvhnm8lxsyRpcthEZYp4GHQgREl1q0LkFw,5517
setuptools/dist.py,sha256=awhNuAZVxwnjntKLjGeUKhSWiCaBsetnPyYQ9LDUUls,50309
setuptools/extension.py,sha256=uc6nHI-MxwmNCNPbUiBnybSyqhpJqjbhvOQ-emdvt_E,1729
setuptools/extern/__init__.py,sha256=4q9gtShB1XFP6CisltsyPqtcfTO6ZM9Lu1QBl3l-qmo,2514
setuptools/extern/__pycache__/__init__.cpython-38.pyc,,
setuptools/glibc.py,sha256=X64VvGPL2AbURKwYRsWJOXXGAYOiF_v2qixeTkAULuU,3146
setuptools/glob.py,sha256=o75cHrOxYsvn854thSxE0x9k8JrKDuhP_rRXlVB00Q4,5084
setuptools/launch.py,sha256=sd7ejwhBocCDx_wG9rIs0OaZ8HtmmFU8ZC6IR_S0Lvg,787
setuptools/lib2to3_ex.py,sha256=t5e12hbR2pi9V4ezWDTB4JM-AISUnGOkmcnYHek3xjg,2013
setuptools/monkey.py,sha256=FGc9fffh7gAxMLFmJs2DW_OYWpBjkdbNS2n14UAK4NA,5264
setuptools/msvc.py,sha256=8baJ6aYgCA4TRdWQQi185qB9dnU8FaP4wgpbmd7VODs,46751
setuptools/namespaces.py,sha256=F0Nrbv8KCT2OrO7rwa03om4N4GZKAlnce-rr-cgDQa8,3199
setuptools/package_index.py,sha256=6pb-B1POtHyLycAbkDETk4fO-Qv8_sY-rjTXhUOoh6k,40605
setuptools/pep425tags.py,sha256=o_D_WVeWcXZiI2xjPSg7pouGOvaWRgGRxEDK9DzAXIA,10861
setuptools/py27compat.py,sha256=tvmer0Tn-wk_JummCkoM22UIjpjL-AQ8uUiOaqTs8sI,1496
setuptools/py31compat.py,sha256=h2rtZghOfwoGYd8sQ0-auaKiF3TcL3qX0bX3VessqcE,838
setuptools/py33compat.py,sha256=SMF9Z8wnGicTOkU1uRNwZ_kz5Z_bj29PUBbqdqeeNsc,1330
setuptools/py34compat.py,sha256=KYOd6ybRxjBW8NJmYD8t_UyyVmysppFXqHpFLdslGXU,245
setuptools/sandbox.py,sha256=9UbwfEL5QY436oMI1LtFWohhoZ-UzwHvGyZjUH_qhkw,14276
setuptools/script (dev).tmpl,sha256=RUzQzCQUaXtwdLtYHWYbIQmOaES5Brqq1FvUA_tu-5I,218
setuptools/script.tmpl,sha256=WGTt5piezO27c-Dbx6l5Q4T3Ff20A5z7872hv3aAhYY,138
setuptools/site-patch.py,sha256=OumkIHMuoSenRSW1382kKWI1VAwxNE86E5W8iDd34FY,2302
setuptools/ssl_support.py,sha256=nLjPUBBw7RTTx6O4RJZ5eAMGgjJG8beiDbkFXDZpLuM,8493
setuptools/unicode_utils.py,sha256=NOiZ_5hD72A6w-4wVj8awHFM3n51Kmw1Ic_vx15XFqw,996
setuptools/version.py,sha256=og_cuZQb0QI6ukKZFfZWPlr1HgJBPPn2vO2m_bI9ZTE,144
setuptools/wheel.py,sha256=94uqXsOaKt91d9hW5z6ZppZmNSs_nO66R4uiwhcr4V0,8094
setuptools/windows_support.py,sha256=5GrfqSP2-dLGJoZTq2g6dCKkyQxxa2n5IQiXlJCoYEE,714
site-packages/setuptools-41.6.0.dist-info/top_level.txt000064400000000046151446176770016700 0ustar00easy_install
pkg_resources
setuptools
site-packages/pip/_internal/operations/prepare.py000064400000026017151446176770016252 0ustar00"""Prepares a distribution for installation
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

import logging
import os

from pip._vendor import requests

from pip._internal.distributions import (
    make_distribution_for_install_requirement,
)
from pip._internal.distributions.installed import InstalledDistribution
from pip._internal.download import unpack_url
from pip._internal.exceptions import (
    DirectoryUrlHashUnsupported,
    HashUnpinned,
    InstallationError,
    PreviousBuildDirError,
    VcsHashUnsupported,
)
from pip._internal.utils.compat import expanduser
from pip._internal.utils.hashes import MissingHashes
from pip._internal.utils.logging import indent_log
from pip._internal.utils.marker_files import write_delete_marker_file
from pip._internal.utils.misc import display_path, normalize_path
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional

    from pip._internal.distributions import AbstractDistribution
    from pip._internal.index import PackageFinder
    from pip._internal.network.session import PipSession
    from pip._internal.req.req_install import InstallRequirement
    from pip._internal.req.req_tracker import RequirementTracker

logger = logging.getLogger(__name__)


def _get_prepared_distribution(req, req_tracker, finder, build_isolation):
    """Prepare a distribution for installation.
    """
    abstract_dist = make_distribution_for_install_requirement(req)
    with req_tracker.track(req):
        abstract_dist.prepare_distribution_metadata(finder, build_isolation)
    return abstract_dist


class RequirementPreparer(object):
    """Prepares a Requirement
    """

    def __init__(
        self,
        build_dir,  # type: str
        download_dir,  # type: Optional[str]
        src_dir,  # type: str
        wheel_download_dir,  # type: Optional[str]
        progress_bar,  # type: str
        build_isolation,  # type: bool
        req_tracker  # type: RequirementTracker
    ):
        # type: (...) -> None
        super(RequirementPreparer, self).__init__()

        self.src_dir = src_dir
        self.build_dir = build_dir
        self.req_tracker = req_tracker

        # Where still-packed archives should be written to. If None, they are
        # not saved, and are deleted immediately after unpacking.
        if download_dir:
            download_dir = expanduser(download_dir)
        self.download_dir = download_dir

        # Where still-packed .whl files should be written to. If None, they are
        # written to the download_dir parameter. Separate to download_dir to
        # permit only keeping wheel archives for pip wheel.
        if wheel_download_dir:
            wheel_download_dir = normalize_path(wheel_download_dir)
        self.wheel_download_dir = wheel_download_dir

        # NOTE
        # download_dir and wheel_download_dir overlap semantically and may
        # be combined if we're willing to have non-wheel archives present in
        # the wheelhouse output by 'pip wheel'.

        self.progress_bar = progress_bar

        # Is build isolation allowed?
        self.build_isolation = build_isolation

    @property
    def _download_should_save(self):
        # type: () -> bool
        if not self.download_dir:
            return False

        if os.path.exists(self.download_dir):
            return True

        logger.critical('Could not find download directory')
        raise InstallationError(
            "Could not find or access download directory '%s'"
            % display_path(self.download_dir))

    def prepare_linked_requirement(
        self,
        req,  # type: InstallRequirement
        session,  # type: PipSession
        finder,  # type: PackageFinder
        require_hashes,  # type: bool
    ):
        # type: (...) -> AbstractDistribution
        """Prepare a requirement that would be obtained from req.link
        """
        assert req.link
        link = req.link

        # TODO: Breakup into smaller functions
        if link.scheme == 'file':
            path = link.file_path
            logger.info('Processing %s', display_path(path))
        else:
            logger.info('Collecting %s', req.req or req)

        with indent_log():
            # @@ if filesystem packages are not marked
            # editable in a req, a non deterministic error
            # occurs when the script attempts to unpack the
            # build directory
            req.ensure_has_source_dir(self.build_dir)
            # If a checkout exists, it's unwise to keep going.  version
            # inconsistencies are logged later, but do not fail the
            # installation.
            # FIXME: this won't upgrade when there's an existing
            # package unpacked in `req.source_dir`
            if os.path.exists(os.path.join(req.source_dir, 'setup.py')):
                raise PreviousBuildDirError(
                    "pip can't proceed with requirements '%s' due to a"
                    " pre-existing build directory (%s). This is "
                    "likely due to a previous installation that failed"
                    ". pip is being responsible and not assuming it "
                    "can delete this. Please delete it and try again."
                    % (req, req.source_dir)
                )

            # Now that we have the real link, we can tell what kind of
            # requirements we have and raise some more informative errors
            # than otherwise. (For example, we can raise VcsHashUnsupported
            # for a VCS URL rather than HashMissing.)
            if require_hashes:
                # We could check these first 2 conditions inside
                # unpack_url and save repetition of conditions, but then
                # we would report less-useful error messages for
                # unhashable requirements, complaining that there's no
                # hash provided.
                if link.is_vcs:
                    raise VcsHashUnsupported()
                elif link.is_existing_dir():
                    raise DirectoryUrlHashUnsupported()
                if not req.original_link and not req.is_pinned:
                    # Unpinned packages are asking for trouble when a new
                    # version is uploaded. This isn't a security check, but
                    # it saves users a surprising hash mismatch in the
                    # future.
                    #
                    # file:/// URLs aren't pinnable, so don't complain
                    # about them not being pinned.
                    raise HashUnpinned()

            hashes = req.hashes(trust_internet=not require_hashes)
            if require_hashes and not hashes:
                # Known-good hashes are missing for this requirement, so
                # shim it with a facade object that will provoke hash
                # computation and then raise a HashMissing exception
                # showing the user what the hash should be.
                hashes = MissingHashes()

            download_dir = self.download_dir
            if link.is_wheel and self.wheel_download_dir:
                # when doing 'pip wheel` we download wheels to a
                # dedicated dir.
                download_dir = self.wheel_download_dir

            try:
                unpack_url(
                    link, req.source_dir, download_dir,
                    session=session, hashes=hashes,
                    progress_bar=self.progress_bar
                )
            except requests.HTTPError as exc:
                logger.critical(
                    'Could not install requirement %s because of error %s',
                    req,
                    exc,
                )
                raise InstallationError(
                    'Could not install requirement %s because of HTTP '
                    'error %s for URL %s' %
                    (req, exc, link)
                )

            if link.is_wheel:
                if download_dir:
                    # When downloading, we only unpack wheels to get
                    # metadata.
                    autodelete_unpacked = True
                else:
                    # When installing a wheel, we use the unpacked
                    # wheel.
                    autodelete_unpacked = False
            else:
                # We always delete unpacked sdists after pip runs.
                autodelete_unpacked = True
            if autodelete_unpacked:
                write_delete_marker_file(req.source_dir)

            abstract_dist = _get_prepared_distribution(
                req, self.req_tracker, finder, self.build_isolation,
            )

            if self._download_should_save:
                # Make a .zip of the source_dir we already created.
                if link.is_vcs:
                    req.archive(self.download_dir)
        return abstract_dist

    def prepare_editable_requirement(
        self,
        req,  # type: InstallRequirement
        require_hashes,  # type: bool
        use_user_site,  # type: bool
        finder  # type: PackageFinder
    ):
        # type: (...) -> AbstractDistribution
        """Prepare an editable requirement
        """
        assert req.editable, "cannot prepare a non-editable req as editable"

        logger.info('Obtaining %s', req)

        with indent_log():
            if require_hashes:
                raise InstallationError(
                    'The editable requirement %s cannot be installed when '
                    'requiring hashes, because there is no single file to '
                    'hash.' % req
                )
            req.ensure_has_source_dir(self.src_dir)
            req.update_editable(not self._download_should_save)

            abstract_dist = _get_prepared_distribution(
                req, self.req_tracker, finder, self.build_isolation,
            )

            if self._download_should_save:
                req.archive(self.download_dir)
            req.check_if_exists(use_user_site)

        return abstract_dist

    def prepare_installed_requirement(
        self,
        req,  # type: InstallRequirement
        require_hashes,  # type: bool
        skip_reason  # type: str
    ):
        # type: (...) -> AbstractDistribution
        """Prepare an already-installed requirement
        """
        assert req.satisfied_by, "req should have been satisfied but isn't"
        assert skip_reason is not None, (
            "did not get skip reason skipped but req.satisfied_by "
            "is set to %r" % (req.satisfied_by,)
        )
        logger.info(
            'Requirement %s: %s (%s)',
            skip_reason, req, req.satisfied_by.version
        )
        with indent_log():
            if require_hashes:
                logger.debug(
                    'Since it is already installed, we are trusting this '
                    'package without checking its hash. To ensure a '
                    'completely repeatable environment, install into an '
                    'empty virtualenv.'
                )
            abstract_dist = InstalledDistribution(req)

        return abstract_dist
site-packages/pip/_internal/operations/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000240151446176770023566 0ustar00U

��.e�@sdS)N�rrr�E/usr/lib/python3.8/site-packages/pip/_internal/operations/__init__.py�<module>�site-packages/pip/_internal/operations/__pycache__/generate_metadata.cpython-38.opt-1.pyc000064400000007463151446176770025477 0ustar00U

��.e[�@s�dZddlZddlZddlmZddlmZddlmZddl	m
Z
ddlmZddl
mZer|dd	lmZmZdd
lmZe�e�Zdd�Zd
d�Zdd�Zdd�ZdS)z4Metadata generation logic for source distributions.
�N)�InstallationError)�
ensure_dir)�make_setuptools_shim_args)�call_subprocess)�MYPY_CHECK_RUNNING)�vcs)�Callable�List)�InstallRequirementcCs|js
tStS)aReturn a callable metadata generator for this InstallRequirement.

    A metadata generator takes an InstallRequirement (install_req) as an input,
    generates metadata via the appropriate process for that install_req and
    returns the generated metadata directory.
    )Z
use_pep517�_generate_metadata_legacy�_generate_metadata��install_req�r�N/usr/lib/python3.8/site-packages/pip/_internal/operations/generate_metadata.py�get_metadata_generatorsrcs�dd���fdd�}dd�}|}|r.||�}ntj�|d�}t�|�}|sVtd|��t|�d	krn|j|d
�tj�||d�S)zEFind an .egg-info in `source_directory`, based on `is_editable`.
    cSs0tj�tj�|dd��p.tj�tj�|dd��S)N�bin�pythonZScriptsz
Python.exe)�os�path�lexists�join�exists)rrrr�looks_like_virtual_env(s�z._find_egg_info.<locals>.looks_like_virtual_envcs�g}t�|�D]�\�}}tjD]}||kr|�|�qt|�D]<}�tj��|��r`|�|�q>|dksp|dkr>|�|�q>|��fdd�|D��qdd�|D�S)NZtestZtestsc3s|]}tj��|�VqdS�N)rrr)�.0�dir_��rootrr�	<genexpr>?szC_find_egg_info.<locals>.locate_editable_egg_info.<locals>.<genexpr>cSsg|]}|�d�r|�qS)z	.egg-info)�endswith)r�frrr�
<listcomp>@s
zD_find_egg_info.<locals>.locate_editable_egg_info.<locals>.<listcomp>)	r�walkrZdirnames�remove�listrr�extend)�baseZ
candidates�dirs�filesr�rrr�locate_editable_egg_info/s
z0_find_egg_info.<locals>.locate_editable_egg_infocSs(|�tjj�tjjr"|�tjj�p$dS)Nr)�countrr�sep�altsep)rrrr�depth_of_directoryBs��z*_find_egg_info.<locals>.depth_of_directory�pip-egg-infoz!Files/directories not found in %s�)�keyr)rrr�listdirr�len�sort)Zsource_directoryZis_editabler+r/r'�	filenamesrr*r�_find_egg_info#s

�r7c	Cs�|jpd�|j�}t�d|j|�t|j�}|jr<|dg7}g}|jsft	j
�|jd�}d|g}t
|�|j� t|dg||jdd�W5QRXt|j|j�S)	Nzfrom {}z2Running setup.py (path:%s) egg_info for package %sz
--no-user-cfgr0z
--egg-baseZegg_infozpython setup.py egg_info)�cwdZcommand_desc)�name�format�link�logger�debugZ
setup_py_pathr�isolatedZeditablerrrZunpacked_source_directoryrZ	build_envrr7)rZreq_details_strZbase_cmdZegg_base_optionZegg_info_dirrrrr^s6�

���rcCs|��Sr)Zprepare_pep517_metadatar
rrrr�sr)�__doc__ZloggingrZpip._internal.exceptionsrZpip._internal.utils.miscrZ$pip._internal.utils.setuptools_buildrZpip._internal.utils.subprocessrZpip._internal.utils.typingrZpip._internal.vcsr�typingrr	Zpip._internal.req.req_installr
Z	getLogger�__name__r<rr7rrrrrr�<module>s 
;(site-packages/pip/_internal/operations/__pycache__/freeze.cpython-38.opt-1.pyc000064400000013142151446176770023314 0ustar00U

��.eb&�
@s4ddlmZddlZddlZddlZddlZddlmZddlm	Z	ddl
mZddlm
Z
mZddlmZmZddlmZdd	lmZmZdd
lmZe�rddlmZmZmZmZmZmZm Z m!Z!m"Z"ddl#m$Z$dd
l
m%Z%m&Z&e ee"e'e&fe(ee'fZ)e�*e+�Z,ddd�Z-dd�Z.Gdd�de/�Z0dS)�)�absolute_importN)�six)�canonicalize_name)�RequirementParseError)�
BadCommand�InstallationError)�install_req_from_editable�install_req_from_line)�
COMMENT_RE)�dist_is_editable�get_installed_distributions)�MYPY_CHECK_RUNNING)	�Iterator�Optional�List�	Container�Set�Dict�Tuple�Iterable�Union)�
WheelCache)�Distribution�RequirementF�c
cs�|pg}d}
|rt�|�j}
|D]}d|Vq i}t|d||d�D]b}
zt�|
�}Wn8tk
r�}zt�d|
|�WY�qDW5d}~XYnX|r�|j	r�qD|||j
<qD|�r�t�}t�
t�}|D�]�}t|����}|D�]r}|���r|���d��s|
�r|
|��s|�d��r6|��}||kr�|�|�|Vq�|�d��sN|�d��r�|�d��rl|d	d���}n|td�d����d
�}t|||d�}ntt�d|���||d�}|j
�s�t�d
||���t�d�q�|j
|k�r ||j
�st�d|t�d|���|j
�n||j
�|�q�t||j
���V||j
=||j
�|�q�W5QRXq�t�|�D]4\}}t|�dk�rdt�d|d�t t|�����qddVt |�!�dd�d�D]$}t"|j
�|	k�r�t|���V�q�dS)Nz-f %sr)�
local_only�skip�	user_only�pathsz6Could not generate requirement for distribution %r: %s�#)z-rz
--requirementz-Zz--always-unzipz-fz--find-linksz-iz--index-urlz--prez--trusted-hostz--process-dependency-linksz--extra-index-urlz-ez
--editable��=)�isolated�wheel_cache�zWSkipping line in requirement file [%s] because it's not clear what it would install: %sz9  (add #egg=PackageName to the URL to avoid this warning)zBRequirement file [%s] contains %s, but package %r is not installed�z+Requirement %s included multiple times [%s]z, z7## The following requirements were added by pip freeze:cSs
|j��S�N)�name�lower)�xrr�C/usr/lib/python3.8/site-packages/pip/_internal/operations/freeze.py�<lambda>��zfreeze.<locals>.<lambda>)�key)#�re�compile�searchr�FrozenRequirement�	from_distr�logger�warning�editabler'�set�collections�defaultdict�list�open�strip�
startswith�rstrip�add�len�lstriprr	r
�sub�info�append�strrZ	iteritems�join�sorted�valuesr)ZrequirementZ
find_linksrrrZ
skip_regexr"r#Zexclude_editablerZ
skip_match�linkZ
installations�dist�req�excZemitted_optionsZ	req_filesZ
req_file_pathZreq_file�lineZline_reqr'�filesZinstallationrrr*�freeze+s�
�
�




����
��������
rNc
CsNt|�sddgfStj�tj�|j��}ddlm}m}|�	|�}|dkrv|�
�}t�d||�d�
|�g}|d|fSz|�||j�}Wn�|k
r�|�
�}d�
t|�j|�g}|d|fYStk
r�t�d	||j�ddgfYStk
�r}zt�d
|�W5d}~XYnX|dk	�r2|dgfSt�d|�dg}dd|fS)
zk
    Compute and return values (req, editable, comments) for use in
    FrozenRequirement.from_dist().
    NFr)�vcs�RemoteNotFoundErrorz1No VCS found for editable requirement "%s" in: %rz/# Editable install with no version control ({})Tz)# Editable {} install with no remote ({})zPcannot determine version of editable source in %s (%s command not found in path)zYError when trying to get requirement for VCS system %s, falling back to uneditable formatz-Could not determine repository location of %sz-## !! Could not determine repository location)r�os�path�normcase�abspath�locationZpip._internal.vcsrOrPZget_backend_for_dir�as_requirementr3�debug�formatZget_src_requirement�project_name�type�__name__rr4r'r)rIrUrOrPZvcs_backendrJ�commentsrKrrr*�get_requirement_info�sZ

��
����

�r]c@s*eZdZd	dd�Zedd��Zdd�ZdS)
r1rcCs||_||_||_||_dSr&)r'rJr5r\)�selfr'rJr5r\rrr*�__init__�szFrozenRequirement.__init__cCs0t|�\}}}|dkr|��}||j|||d�S)N)r\)r]rVrY)�clsrIrJr5r\rrr*r2�szFrozenRequirement.from_distcCs2|j}|jrd|}d�t|j�t|�g�dS)Nz-e %s�
)rJr5rEr9r\rD)r^rJrrr*�__str__�szFrozenRequirement.__str__N)r)r[�
__module__�__qualname__r_�classmethodr2rbrrrr*r1�s

r1)
NNNNNNFNFr)1Z
__future__rr7ZloggingrQr.Zpip._vendorrZpip._vendor.packaging.utilsrZpip._vendor.pkg_resourcesrZpip._internal.exceptionsrrZpip._internal.req.constructorsrr	Zpip._internal.req.req_filer
Zpip._internal.utils.miscrrZpip._internal.utils.typingr
�typingrrrrrrrrrZpip._internal.cacherrrrD�boolZRequirementInfoZ	getLoggerr[r3rNr]�objectr1rrrr*�<module>s@,
�
>site-packages/pip/_internal/operations/__pycache__/prepare.cpython-38.pyc000064400000013410151446176770022531 0ustar00U

��.e,�@sdZddlZddlZddlmZddlmZddlmZddl	m
Z
ddlmZm
Z
mZmZmZddlmZdd	lmZdd
lmZddlmZddlmZmZdd
lmZer�ddlmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(e�)e*�Z+dd�Z,Gdd�de-�Z.dS)z)Prepares a distribution for installation
�N)�requests)�)make_distribution_for_install_requirement)�InstalledDistribution)�
unpack_url)�DirectoryUrlHashUnsupported�HashUnpinned�InstallationError�PreviousBuildDirError�VcsHashUnsupported)�
expanduser)�
MissingHashes)�
indent_log)�write_delete_marker_file)�display_path�normalize_path)�MYPY_CHECK_RUNNING)�Optional)�AbstractDistribution)�
PackageFinder)�
PipSession)�InstallRequirement)�RequirementTrackerc	Cs.t|�}|�|��|�||�W5QRX|S)z-Prepare a distribution for installation.
    )rZtrackZprepare_distribution_metadata)�req�req_tracker�finder�build_isolation�
abstract_dist�r�D/usr/lib/python3.8/site-packages/pip/_internal/operations/prepare.py�_get_prepared_distribution,srcsDeZdZdZ�fdd�Zedd��Zdd�Zdd	�Zd
d�Z	�Z
S)�RequirementPreparerzPrepares a Requirement
    csTtt|���||_||_||_|r,t|�}||_|r>t|�}||_	||_
||_dS)N)�superr �__init__�src_dir�	build_dirrr�download_dirr�wheel_download_dir�progress_barr)�selfr$r%r#r&r'rr��	__class__rrr"9szRequirementPreparer.__init__cCs<|js
dStj�|j�rdSt�d�tdt|j���dS)NFTz!Could not find download directoryz0Could not find or access download directory '%s')r%�os�path�exists�logger�criticalrr)r(rrr�_download_should_saveas
��z)RequirementPreparer._download_should_savecCs�|js
t�|j}|jdkr2|j}t�dt|��nt�d|jp@|�t���b|�	|j
�tj�
tj�|jd��r�td||jf��|r�|jr�t��n|��r�t��|js�|js�t��|j|d�}|r�|s�t�}|j}|jr�|jr�|j}zt||j||||jd�WnFtj k
�rL}	z$t�!d||	�t"d	||	|f��W5d
}	~	XYnX|j�rh|�rbd}
nd}
nd}
|
�r|t#|j�t$||j%||j&�}|j'�r�|j�r�|�(|j�W5QRX|S)
zCPrepare a requirement that would be obtained from req.link
        �filez
Processing %sz
Collecting %szsetup.pyz�pip can't proceed with requirements '%s' due to a pre-existing build directory (%s). This is likely due to a previous installation that failed. pip is being responsible and not assuming it can delete this. Please delete it and try again.)Ztrust_internet)�session�hashesr'z4Could not install requirement %s because of error %szDCould not install requirement %s because of HTTP error %s for URL %sNTF))�link�AssertionErrorZschemeZ	file_pathr.�inforrr
�ensure_has_source_dirr$r+r,r-�joinZ
source_dirr	Zis_vcsr
Zis_existing_dirrZ
original_linkZ	is_pinnedrr3rr%Zis_wheelr&rr'rZ	HTTPErrorr/rrrrrr0�archive)r(rr2r�require_hashesr4r,r3r%�excZautodelete_unpackedrrrr�prepare_linked_requirementos�



��
�
���
�z.RequirementPreparer.prepare_linked_requirementc	Cs�|jstd��t�d|�t��^|r2td|��|�|j�|�|j	�t
||j||j�}|j	rp|�
|j�|�|�W5QRX|S)z(Prepare an editable requirement
        z-cannot prepare a non-editable req as editablezObtaining %szoThe editable requirement %s cannot be installed when requiring hashes, because there is no single file to hash.)Zeditabler5r.r6r
rr7r#Zupdate_editabler0rrrr9r%Zcheck_if_exists)r(rr:Z
use_user_siterrrrr�prepare_editable_requirement�s*
���z0RequirementPreparer.prepare_editable_requirementc	Csf|jstd��|dk	s&td|jf��t�d|||jj�t��|rPt�d�t|�}W5QRX|S)z1Prepare an already-installed requirement
        z(req should have been satisfied but isn'tNzAdid not get skip reason skipped but req.satisfied_by is set to %rzRequirement %s: %s (%s)z�Since it is already installed, we are trusting this package without checking its hash. To ensure a completely repeatable environment, install into an empty virtualenv.)Zsatisfied_byr5r.r6�versionr
�debugr)r(rr:Zskip_reasonrrrr�prepare_installed_requirements&	
����z1RequirementPreparer.prepare_installed_requirement)�__name__�
__module__�__qualname__�__doc__r"�propertyr0r<r=r@�
__classcell__rrr)rr 5s(

z"r )/rDZloggingr+Zpip._vendorrZpip._internal.distributionsrZ%pip._internal.distributions.installedrZpip._internal.downloadrZpip._internal.exceptionsrrrr	r
Zpip._internal.utils.compatrZpip._internal.utils.hashesrZpip._internal.utils.loggingr
Z pip._internal.utils.marker_filesrZpip._internal.utils.miscrrZpip._internal.utils.typingr�typingrrZpip._internal.indexrZpip._internal.network.sessionrZpip._internal.req.req_installrZpip._internal.req.req_trackerrZ	getLoggerrAr.r�objectr rrrr�<module>s.
	site-packages/pip/_internal/operations/__pycache__/prepare.cpython-38.opt-1.pyc000064400000012771151446176770023501 0ustar00U

��.e,�@sdZddlZddlZddlmZddlmZddlmZddl	m
Z
ddlmZm
Z
mZmZmZddlmZdd	lmZdd
lmZddlmZddlmZmZdd
lmZer�ddlmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(e�)e*�Z+dd�Z,Gdd�de-�Z.dS)z)Prepares a distribution for installation
�N)�requests)�)make_distribution_for_install_requirement)�InstalledDistribution)�
unpack_url)�DirectoryUrlHashUnsupported�HashUnpinned�InstallationError�PreviousBuildDirError�VcsHashUnsupported)�
expanduser)�
MissingHashes)�
indent_log)�write_delete_marker_file)�display_path�normalize_path)�MYPY_CHECK_RUNNING)�Optional)�AbstractDistribution)�
PackageFinder)�
PipSession)�InstallRequirement)�RequirementTrackerc	Cs.t|�}|�|��|�||�W5QRX|S)z-Prepare a distribution for installation.
    )rZtrackZprepare_distribution_metadata)�req�req_tracker�finder�build_isolation�
abstract_dist�r�D/usr/lib/python3.8/site-packages/pip/_internal/operations/prepare.py�_get_prepared_distribution,srcsDeZdZdZ�fdd�Zedd��Zdd�Zdd	�Zd
d�Z	�Z
S)�RequirementPreparerzPrepares a Requirement
    csTtt|���||_||_||_|r,t|�}||_|r>t|�}||_	||_
||_dS)N)�superr �__init__�src_dir�	build_dirrr�download_dirr�wheel_download_dir�progress_barr)�selfr$r%r#r&r'rr��	__class__rrr"9szRequirementPreparer.__init__cCs<|js
dStj�|j�rdSt�d�tdt|j���dS)NFTz!Could not find download directoryz0Could not find or access download directory '%s')r%�os�path�exists�logger�criticalrr)r(rrr�_download_should_saveas
��z)RequirementPreparer._download_should_savecCs�|j}|jdkr(|j}t�dt|��nt�d|jp6|�t���b|�|j	�t
j�t
j�
|jd��rztd||jf��|r�|jr�t��n|��r�t��|js�|js�t��|j|d�}|r�|s�t�}|j}|jr�|jr�|j}zt||j||||jd�WnFtjk
�rB}	z$t� d||	�t!d	||	|f��W5d
}	~	XYnX|j�r^|�rXd}
nd}
nd}
|
�rrt"|j�t#||j$||j%�}|j&�r�|j�r�|�'|j�W5QRX|S)
zCPrepare a requirement that would be obtained from req.link
        �filez
Processing %sz
Collecting %szsetup.pyz�pip can't proceed with requirements '%s' due to a pre-existing build directory (%s). This is likely due to a previous installation that failed. pip is being responsible and not assuming it can delete this. Please delete it and try again.)Ztrust_internet)�session�hashesr'z4Could not install requirement %s because of error %szDCould not install requirement %s because of HTTP error %s for URL %sNTF)(�linkZschemeZ	file_pathr.�inforrr
�ensure_has_source_dirr$r+r,r-�joinZ
source_dirr	Zis_vcsr
Zis_existing_dirrZ
original_linkZ	is_pinnedrr3rr%Zis_wheelr&rr'rZ	HTTPErrorr/rrrrrr0�archive)r(rr2r�require_hashesr4r,r3r%�excZautodelete_unpackedrrrr�prepare_linked_requirementos~

��
�
���
�z.RequirementPreparer.prepare_linked_requirementc	Cszt�d|�t��^|r$td|��|�|j�|�|j�t||j	||j
�}|jrb|�|j�|�
|�W5QRX|S)z(Prepare an editable requirement
        zObtaining %szoThe editable requirement %s cannot be installed when requiring hashes, because there is no single file to hash.)r.r5r
rr6r#Zupdate_editabler0rrrr8r%Zcheck_if_exists)r(rr9Z
use_user_siterrrrr�prepare_editable_requirement�s(���z0RequirementPreparer.prepare_editable_requirementc	Cs@t�d|||jj�t��|r*t�d�t|�}W5QRX|S)z1Prepare an already-installed requirement
        zRequirement %s: %s (%s)z�Since it is already installed, we are trusting this package without checking its hash. To ensure a completely repeatable environment, install into an empty virtualenv.)r.r5Zsatisfied_by�versionr
�debugr)r(rr9Zskip_reasonrrrr�prepare_installed_requirements��z1RequirementPreparer.prepare_installed_requirement)�__name__�
__module__�__qualname__�__doc__r"�propertyr0r;r<r?�
__classcell__rrr)rr 5s(

z"r )/rCZloggingr+Zpip._vendorrZpip._internal.distributionsrZ%pip._internal.distributions.installedrZpip._internal.downloadrZpip._internal.exceptionsrrrr	r
Zpip._internal.utils.compatrZpip._internal.utils.hashesrZpip._internal.utils.loggingr
Z pip._internal.utils.marker_filesrZpip._internal.utils.miscrrZpip._internal.utils.typingr�typingrrZpip._internal.indexrZpip._internal.network.sessionrZpip._internal.req.req_installrZpip._internal.req.req_trackerrZ	getLoggerr@r.r�objectr rrrr�<module>s.
	site-packages/pip/_internal/operations/__pycache__/generate_metadata.cpython-38.pyc000064400000007463151446176770024540 0ustar00U

��.e[�@s�dZddlZddlZddlmZddlmZddlmZddl	m
Z
ddlmZddl
mZer|dd	lmZmZdd
lmZe�e�Zdd�Zd
d�Zdd�Zdd�ZdS)z4Metadata generation logic for source distributions.
�N)�InstallationError)�
ensure_dir)�make_setuptools_shim_args)�call_subprocess)�MYPY_CHECK_RUNNING)�vcs)�Callable�List)�InstallRequirementcCs|js
tStS)aReturn a callable metadata generator for this InstallRequirement.

    A metadata generator takes an InstallRequirement (install_req) as an input,
    generates metadata via the appropriate process for that install_req and
    returns the generated metadata directory.
    )Z
use_pep517�_generate_metadata_legacy�_generate_metadata��install_req�r�N/usr/lib/python3.8/site-packages/pip/_internal/operations/generate_metadata.py�get_metadata_generatorsrcs�dd���fdd�}dd�}|}|r.||�}ntj�|d�}t�|�}|sVtd|��t|�d	krn|j|d
�tj�||d�S)zEFind an .egg-info in `source_directory`, based on `is_editable`.
    cSs0tj�tj�|dd��p.tj�tj�|dd��S)N�bin�pythonZScriptsz
Python.exe)�os�path�lexists�join�exists)rrrr�looks_like_virtual_env(s�z._find_egg_info.<locals>.looks_like_virtual_envcs�g}t�|�D]�\�}}tjD]}||kr|�|�qt|�D]<}�tj��|��r`|�|�q>|dksp|dkr>|�|�q>|��fdd�|D��qdd�|D�S)NZtestZtestsc3s|]}tj��|�VqdS�N)rrr)�.0�dir_��rootrr�	<genexpr>?szC_find_egg_info.<locals>.locate_editable_egg_info.<locals>.<genexpr>cSsg|]}|�d�r|�qS)z	.egg-info)�endswith)r�frrr�
<listcomp>@s
zD_find_egg_info.<locals>.locate_editable_egg_info.<locals>.<listcomp>)	r�walkrZdirnames�remove�listrr�extend)�baseZ
candidates�dirs�filesr�rrr�locate_editable_egg_info/s
z0_find_egg_info.<locals>.locate_editable_egg_infocSs(|�tjj�tjjr"|�tjj�p$dS)Nr)�countrr�sep�altsep)rrrr�depth_of_directoryBs��z*_find_egg_info.<locals>.depth_of_directory�pip-egg-infoz!Files/directories not found in %s�)�keyr)rrr�listdirr�len�sort)Zsource_directoryZis_editabler+r/r'�	filenamesrr*r�_find_egg_info#s

�r7c	Cs�|jpd�|j�}t�d|j|�t|j�}|jr<|dg7}g}|jsft	j
�|jd�}d|g}t
|�|j� t|dg||jdd�W5QRXt|j|j�S)	Nzfrom {}z2Running setup.py (path:%s) egg_info for package %sz
--no-user-cfgr0z
--egg-baseZegg_infozpython setup.py egg_info)�cwdZcommand_desc)�name�format�link�logger�debugZ
setup_py_pathr�isolatedZeditablerrrZunpacked_source_directoryrZ	build_envrr7)rZreq_details_strZbase_cmdZegg_base_optionZegg_info_dirrrrr^s6�

���rcCs|��Sr)Zprepare_pep517_metadatar
rrrr�sr)�__doc__ZloggingrZpip._internal.exceptionsrZpip._internal.utils.miscrZ$pip._internal.utils.setuptools_buildrZpip._internal.utils.subprocessrZpip._internal.utils.typingrZpip._internal.vcsr�typingrr	Zpip._internal.req.req_installr
Z	getLogger�__name__r<rr7rrrrrr�<module>s 
;(site-packages/pip/_internal/operations/__pycache__/check.cpython-38.opt-1.pyc000064400000007110151446176770023107 0ustar00U

��.e��@s dZddlZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
e�e�Ze
r�dd	lmZdd
lmZmZmZmZmZmZmZeedfZeeefZeeeefZeeeefZeeeefZ eee fZ!eddd
g�Z"dd�Z#ddd�Z$dd�Z%dd�Z&dd�Z'dS)z'Validation of dependencies of packages
�N)�
namedtuple)�canonicalize_name)�RequirementParseError)�)make_distribution_for_install_requirement)�get_installed_distributions)�MYPY_CHECK_RUNNING)�InstallRequirement)�Any�Callable�Dict�Optional�Set�Tuple�List�PackageDetails�version�requirescKs�|ikrddd�}i}d}tf|�D]\}t|j�}zt|j|���||<Wq$tk
r~}zt�d||�d}W5d}~XYq$Xq$||fS)z8Converts a list of distributions into a PackageSet.
    F�)Z
local_only�skipz%Error parsing requirements for %s: %sTN)	rr�project_namerrrr�loggingZwarning)�kwargs�package_setZproblems�dist�name�err�B/usr/lib/python3.8/site-packages/pip/_internal/operations/check.py�!create_package_set_from_installed(s

rcCs�|dkrdd�}i}i}|D]�}t�}t�}||�r6q||jD]l}t|j�}||kr�d}	|jdk	rn|j��}	|	r@|�||f�q@||j}
|jj	|
dd�s@|�||
|f�q@|r�t
|td�||<|rt
|td�||<q||fS)z�Check if a package set is consistent

    If should_ignore is passed, it should be a callable that takes a
    package name and returns a boolean.
    NcSsdS)NFr�rrrr�
should_ignoreEsz(check_package_set.<locals>.should_ignoreT)Zprereleases)�key)�setrrrZmarkerZevaluate�addrZ	specifier�contains�sorted�str)rrZmissingZconflicting�package_nameZmissing_depsZconflicting_deps�reqrZmissedrrrr�check_package_set=s4



r(cs6t�\}}t||�}t||��|t|�fdd�d�fS)zeFor checking if the dependency graph would be consistent after     installing given requirements
    cs|�kS�Nrr�Z	whitelistrr�<lambda>|�z)check_install_conflicts.<locals>.<lambda>)r)r�_simulate_installation_of�_create_whitelistr()�
to_installr�_�would_be_installedrr*r�check_install_conflictsls



��r2cCsLt�}|D]<}t|�}|��}t|j�}t|j|���||<|�|�q
|S)zBComputes the version of packages after installing to_install.
    )	r!rZget_pkg_resources_distributionrr rrrr")r/rZ	installedZinst_reqZ
abstract_distrrrrrr-�s
r-cCsLt|�}|D]:}||krq||jD] }t|j�|kr$|�|�qq$q|Sr))r!rrrr")r1rZpackages_affectedr&r'rrrr.�s
r.)N)(�__doc__r�collectionsrZpip._vendor.packaging.utilsrZpip._vendor.pkg_resourcesrZpip._internal.distributionsrZpip._internal.utils.miscrZpip._internal.utils.typingrZ	getLogger�__name__ZloggerZpip._internal.req.req_installr�typingr	r
rrr
rrr%Z
PackageSetZMissingZConflictingZMissingDictZConflictingDictZCheckResultrrr(r2r-r.rrrr�<module>s.
$
/site-packages/pip/_internal/operations/__pycache__/check.cpython-38.pyc000064400000007110151446176770022150 0ustar00U

��.e��@s dZddlZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
e�e�Ze
r�dd	lmZdd
lmZmZmZmZmZmZmZeedfZeeefZeeeefZeeeefZeeeefZ eee fZ!eddd
g�Z"dd�Z#ddd�Z$dd�Z%dd�Z&dd�Z'dS)z'Validation of dependencies of packages
�N)�
namedtuple)�canonicalize_name)�RequirementParseError)�)make_distribution_for_install_requirement)�get_installed_distributions)�MYPY_CHECK_RUNNING)�InstallRequirement)�Any�Callable�Dict�Optional�Set�Tuple�List�PackageDetails�version�requirescKs�|ikrddd�}i}d}tf|�D]\}t|j�}zt|j|���||<Wq$tk
r~}zt�d||�d}W5d}~XYq$Xq$||fS)z8Converts a list of distributions into a PackageSet.
    F�)Z
local_only�skipz%Error parsing requirements for %s: %sTN)	rr�project_namerrrr�loggingZwarning)�kwargs�package_setZproblems�dist�name�err�B/usr/lib/python3.8/site-packages/pip/_internal/operations/check.py�!create_package_set_from_installed(s

rcCs�|dkrdd�}i}i}|D]�}t�}t�}||�r6q||jD]l}t|j�}||kr�d}	|jdk	rn|j��}	|	r@|�||f�q@||j}
|jj	|
dd�s@|�||
|f�q@|r�t
|td�||<|rt
|td�||<q||fS)z�Check if a package set is consistent

    If should_ignore is passed, it should be a callable that takes a
    package name and returns a boolean.
    NcSsdS)NFr�rrrr�
should_ignoreEsz(check_package_set.<locals>.should_ignoreT)Zprereleases)�key)�setrrrZmarkerZevaluate�addrZ	specifier�contains�sorted�str)rrZmissingZconflicting�package_nameZmissing_depsZconflicting_deps�reqrZmissedrrrr�check_package_set=s4



r(cs6t�\}}t||�}t||��|t|�fdd�d�fS)zeFor checking if the dependency graph would be consistent after     installing given requirements
    cs|�kS�Nrr�Z	whitelistrr�<lambda>|�z)check_install_conflicts.<locals>.<lambda>)r)r�_simulate_installation_of�_create_whitelistr()�
to_installr�_�would_be_installedrr*r�check_install_conflictsls



��r2cCsLt�}|D]<}t|�}|��}t|j�}t|j|���||<|�|�q
|S)zBComputes the version of packages after installing to_install.
    )	r!rZget_pkg_resources_distributionrr rrrr")r/rZ	installedZinst_reqZ
abstract_distrrrrrr-�s
r-cCsLt|�}|D]:}||krq||jD] }t|j�|kr$|�|�qq$q|Sr))r!rrrr")r1rZpackages_affectedr&r'rrrr.�s
r.)N)(�__doc__r�collectionsrZpip._vendor.packaging.utilsrZpip._vendor.pkg_resourcesrZpip._internal.distributionsrZpip._internal.utils.miscrZpip._internal.utils.typingrZ	getLogger�__name__ZloggerZpip._internal.req.req_installr�typingr	r
rrr
rrr%Z
PackageSetZMissingZConflictingZMissingDictZConflictingDictZCheckResultrrr(r2r-r.rrrr�<module>s.
$
/site-packages/pip/_internal/operations/__pycache__/freeze.cpython-38.pyc000064400000013142151446176770022355 0ustar00U

��.eb&�
@s4ddlmZddlZddlZddlZddlZddlmZddlm	Z	ddl
mZddlm
Z
mZddlmZmZddlmZdd	lmZmZdd
lmZe�rddlmZmZmZmZmZmZm Z m!Z!m"Z"ddl#m$Z$dd
l
m%Z%m&Z&e ee"e'e&fe(ee'fZ)e�*e+�Z,ddd�Z-dd�Z.Gdd�de/�Z0dS)�)�absolute_importN)�six)�canonicalize_name)�RequirementParseError)�
BadCommand�InstallationError)�install_req_from_editable�install_req_from_line)�
COMMENT_RE)�dist_is_editable�get_installed_distributions)�MYPY_CHECK_RUNNING)	�Iterator�Optional�List�	Container�Set�Dict�Tuple�Iterable�Union)�
WheelCache)�Distribution�RequirementF�c
cs�|pg}d}
|rt�|�j}
|D]}d|Vq i}t|d||d�D]b}
zt�|
�}Wn8tk
r�}zt�d|
|�WY�qDW5d}~XYnX|r�|j	r�qD|||j
<qD|�r�t�}t�
t�}|D�]�}t|����}|D�]r}|���r|���d��s|
�r|
|��s|�d��r6|��}||kr�|�|�|Vq�|�d��sN|�d��r�|�d��rl|d	d���}n|td�d����d
�}t|||d�}ntt�d|���||d�}|j
�s�t�d
||���t�d�q�|j
|k�r ||j
�st�d|t�d|���|j
�n||j
�|�q�t||j
���V||j
=||j
�|�q�W5QRXq�t�|�D]4\}}t|�dk�rdt�d|d�t t|�����qddVt |�!�dd�d�D]$}t"|j
�|	k�r�t|���V�q�dS)Nz-f %sr)�
local_only�skip�	user_only�pathsz6Could not generate requirement for distribution %r: %s�#)z-rz
--requirementz-Zz--always-unzipz-fz--find-linksz-iz--index-urlz--prez--trusted-hostz--process-dependency-linksz--extra-index-urlz-ez
--editable��=)�isolated�wheel_cache�zWSkipping line in requirement file [%s] because it's not clear what it would install: %sz9  (add #egg=PackageName to the URL to avoid this warning)zBRequirement file [%s] contains %s, but package %r is not installed�z+Requirement %s included multiple times [%s]z, z7## The following requirements were added by pip freeze:cSs
|j��S�N)�name�lower)�xrr�C/usr/lib/python3.8/site-packages/pip/_internal/operations/freeze.py�<lambda>��zfreeze.<locals>.<lambda>)�key)#�re�compile�searchr�FrozenRequirement�	from_distr�logger�warning�editabler'�set�collections�defaultdict�list�open�strip�
startswith�rstrip�add�len�lstriprr	r
�sub�info�append�strrZ	iteritems�join�sorted�valuesr)ZrequirementZ
find_linksrrrZ
skip_regexr"r#Zexclude_editablerZ
skip_match�linkZ
installations�dist�req�excZemitted_optionsZ	req_filesZ
req_file_pathZreq_file�lineZline_reqr'�filesZinstallationrrr*�freeze+s�
�
�




����
��������
rNc
CsNt|�sddgfStj�tj�|j��}ddlm}m}|�	|�}|dkrv|�
�}t�d||�d�
|�g}|d|fSz|�||j�}Wn�|k
r�|�
�}d�
t|�j|�g}|d|fYStk
r�t�d	||j�ddgfYStk
�r}zt�d
|�W5d}~XYnX|dk	�r2|dgfSt�d|�dg}dd|fS)
zk
    Compute and return values (req, editable, comments) for use in
    FrozenRequirement.from_dist().
    NFr)�vcs�RemoteNotFoundErrorz1No VCS found for editable requirement "%s" in: %rz/# Editable install with no version control ({})Tz)# Editable {} install with no remote ({})zPcannot determine version of editable source in %s (%s command not found in path)zYError when trying to get requirement for VCS system %s, falling back to uneditable formatz-Could not determine repository location of %sz-## !! Could not determine repository location)r�os�path�normcase�abspath�locationZpip._internal.vcsrOrPZget_backend_for_dir�as_requirementr3�debug�formatZget_src_requirement�project_name�type�__name__rr4r'r)rIrUrOrPZvcs_backendrJ�commentsrKrrr*�get_requirement_info�sZ

��
����

�r]c@s*eZdZd	dd�Zedd��Zdd�ZdS)
r1rcCs||_||_||_||_dSr&)r'rJr5r\)�selfr'rJr5r\rrr*�__init__�szFrozenRequirement.__init__cCs0t|�\}}}|dkr|��}||j|||d�S)N)r\)r]rVrY)�clsrIrJr5r\rrr*r2�szFrozenRequirement.from_distcCs2|j}|jrd|}d�t|j�t|�g�dS)Nz-e %s�
)rJr5rEr9r\rD)r^rJrrr*�__str__�szFrozenRequirement.__str__N)r)r[�
__module__�__qualname__r_�classmethodr2rbrrrr*r1�s

r1)
NNNNNNFNFr)1Z
__future__rr7ZloggingrQr.Zpip._vendorrZpip._vendor.packaging.utilsrZpip._vendor.pkg_resourcesrZpip._internal.exceptionsrrZpip._internal.req.constructorsrr	Zpip._internal.req.req_filer
Zpip._internal.utils.miscrrZpip._internal.utils.typingr
�typingrrrrrrrrrZpip._internal.cacherrrrD�boolZRequirementInfoZ	getLoggerr[r3rNr]�objectr1rrrr*�<module>s@,
�
>site-packages/pip/_internal/operations/__pycache__/__init__.cpython-38.pyc000064400000000240151446176770022627 0ustar00U

��.e�@sdS)N�rrr�E/usr/lib/python3.8/site-packages/pip/_internal/operations/__init__.py�<module>�site-packages/pip/_internal/operations/__init__.py000064400000000000151446176770016333 0ustar00site-packages/pip/_internal/operations/check.py000064400000012352151446176770015666 0ustar00"""Validation of dependencies of packages
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

import logging
from collections import namedtuple

from pip._vendor.packaging.utils import canonicalize_name
from pip._vendor.pkg_resources import RequirementParseError

from pip._internal.distributions import (
    make_distribution_for_install_requirement,
)
from pip._internal.utils.misc import get_installed_distributions
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

logger = logging.getLogger(__name__)

if MYPY_CHECK_RUNNING:
    from pip._internal.req.req_install import InstallRequirement
    from typing import (
        Any, Callable, Dict, Optional, Set, Tuple, List
    )

    # Shorthands
    PackageSet = Dict[str, 'PackageDetails']
    Missing = Tuple[str, Any]
    Conflicting = Tuple[str, str, Any]

    MissingDict = Dict[str, List[Missing]]
    ConflictingDict = Dict[str, List[Conflicting]]
    CheckResult = Tuple[MissingDict, ConflictingDict]

PackageDetails = namedtuple('PackageDetails', ['version', 'requires'])


def create_package_set_from_installed(**kwargs):
    # type: (**Any) -> Tuple[PackageSet, bool]
    """Converts a list of distributions into a PackageSet.
    """
    # Default to using all packages installed on the system
    if kwargs == {}:
        kwargs = {"local_only": False, "skip": ()}

    package_set = {}
    problems = False
    for dist in get_installed_distributions(**kwargs):
        name = canonicalize_name(dist.project_name)
        try:
            package_set[name] = PackageDetails(dist.version, dist.requires())
        except RequirementParseError as e:
            # Don't crash on broken metadata
            logging.warning("Error parsing requirements for %s: %s", name, e)
            problems = True
    return package_set, problems


def check_package_set(package_set, should_ignore=None):
    # type: (PackageSet, Optional[Callable[[str], bool]]) -> CheckResult
    """Check if a package set is consistent

    If should_ignore is passed, it should be a callable that takes a
    package name and returns a boolean.
    """
    if should_ignore is None:
        def should_ignore(name):
            return False

    missing = {}
    conflicting = {}

    for package_name in package_set:
        # Info about dependencies of package_name
        missing_deps = set()  # type: Set[Missing]
        conflicting_deps = set()  # type: Set[Conflicting]

        if should_ignore(package_name):
            continue

        for req in package_set[package_name].requires:
            name = canonicalize_name(req.project_name)  # type: str

            # Check if it's missing
            if name not in package_set:
                missed = True
                if req.marker is not None:
                    missed = req.marker.evaluate()
                if missed:
                    missing_deps.add((name, req))
                continue

            # Check if there's a conflict
            version = package_set[name].version  # type: str
            if not req.specifier.contains(version, prereleases=True):
                conflicting_deps.add((name, version, req))

        if missing_deps:
            missing[package_name] = sorted(missing_deps, key=str)
        if conflicting_deps:
            conflicting[package_name] = sorted(conflicting_deps, key=str)

    return missing, conflicting


def check_install_conflicts(to_install):
    # type: (List[InstallRequirement]) -> Tuple[PackageSet, CheckResult]
    """For checking if the dependency graph would be consistent after \
    installing given requirements
    """
    # Start from the current state
    package_set, _ = create_package_set_from_installed()
    # Install packages
    would_be_installed = _simulate_installation_of(to_install, package_set)

    # Only warn about directly-dependent packages; create a whitelist of them
    whitelist = _create_whitelist(would_be_installed, package_set)

    return (
        package_set,
        check_package_set(
            package_set, should_ignore=lambda name: name not in whitelist
        )
    )


def _simulate_installation_of(to_install, package_set):
    # type: (List[InstallRequirement], PackageSet) -> Set[str]
    """Computes the version of packages after installing to_install.
    """

    # Keep track of packages that were installed
    installed = set()

    # Modify it as installing requirement_set would (assuming no errors)
    for inst_req in to_install:
        abstract_dist = make_distribution_for_install_requirement(inst_req)
        dist = abstract_dist.get_pkg_resources_distribution()

        name = canonicalize_name(dist.key)
        package_set[name] = PackageDetails(dist.version, dist.requires())

        installed.add(name)

    return installed


def _create_whitelist(would_be_installed, package_set):
    # type: (Set[str], PackageSet) -> Set[str]
    packages_affected = set(would_be_installed)

    for package_name in package_set:
        if package_name in packages_affected:
            continue

        for req in package_set[package_name].requires:
            if canonicalize_name(req.name) in packages_affected:
                packages_affected.add(package_name)
                break

    return packages_affected
site-packages/pip/_internal/operations/generate_metadata.py000064400000011133151446176770020237 0ustar00"""Metadata generation logic for source distributions.
"""

import logging
import os

from pip._internal.exceptions import InstallationError
from pip._internal.utils.misc import ensure_dir
from pip._internal.utils.setuptools_build import make_setuptools_shim_args
from pip._internal.utils.subprocess import call_subprocess
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.vcs import vcs

if MYPY_CHECK_RUNNING:
    from typing import Callable, List
    from pip._internal.req.req_install import InstallRequirement

logger = logging.getLogger(__name__)


def get_metadata_generator(install_req):
    # type: (InstallRequirement) -> Callable[[InstallRequirement], str]
    """Return a callable metadata generator for this InstallRequirement.

    A metadata generator takes an InstallRequirement (install_req) as an input,
    generates metadata via the appropriate process for that install_req and
    returns the generated metadata directory.
    """
    if not install_req.use_pep517:
        return _generate_metadata_legacy

    return _generate_metadata


def _find_egg_info(source_directory, is_editable):
    # type: (str, bool) -> str
    """Find an .egg-info in `source_directory`, based on `is_editable`.
    """

    def looks_like_virtual_env(path):
        # type: (str) -> bool
        return (
            os.path.lexists(os.path.join(path, 'bin', 'python')) or
            os.path.exists(os.path.join(path, 'Scripts', 'Python.exe'))
        )

    def locate_editable_egg_info(base):
        # type: (str) -> List[str]
        candidates = []  # type: List[str]
        for root, dirs, files in os.walk(base):
            for dir_ in vcs.dirnames:
                if dir_ in dirs:
                    dirs.remove(dir_)
            # Iterate over a copy of ``dirs``, since mutating
            # a list while iterating over it can cause trouble.
            # (See https://github.com/pypa/pip/pull/462.)
            for dir_ in list(dirs):
                if looks_like_virtual_env(os.path.join(root, dir_)):
                    dirs.remove(dir_)
                # Also don't search through tests
                elif dir_ == 'test' or dir_ == 'tests':
                    dirs.remove(dir_)
            candidates.extend(os.path.join(root, dir_) for dir_ in dirs)
        return [f for f in candidates if f.endswith('.egg-info')]

    def depth_of_directory(dir_):
        # type: (str) -> int
        return (
            dir_.count(os.path.sep) +
            (os.path.altsep and dir_.count(os.path.altsep) or 0)
        )

    base = source_directory
    if is_editable:
        filenames = locate_editable_egg_info(base)
    else:
        base = os.path.join(base, 'pip-egg-info')
        filenames = os.listdir(base)

    if not filenames:
        raise InstallationError(
            "Files/directories not found in %s" % base
        )

    # If we have more than one match, we pick the toplevel one.  This
    # can easily be the case if there is a dist folder which contains
    # an extracted tarball for testing purposes.
    if len(filenames) > 1:
        filenames.sort(key=depth_of_directory)

    return os.path.join(base, filenames[0])


def _generate_metadata_legacy(install_req):
    # type: (InstallRequirement) -> str
    req_details_str = install_req.name or "from {}".format(install_req.link)
    logger.debug(
        'Running setup.py (path:%s) egg_info for package %s',
        install_req.setup_py_path, req_details_str,
    )

    # Compose arguments for subprocess call
    base_cmd = make_setuptools_shim_args(install_req.setup_py_path)
    if install_req.isolated:
        base_cmd += ["--no-user-cfg"]

    # For non-editable installs, don't put the .egg-info files at the root,
    # to avoid confusion due to the source code being considered an installed
    # egg.
    egg_base_option = []  # type: List[str]
    if not install_req.editable:
        egg_info_dir = os.path.join(
            install_req.unpacked_source_directory, 'pip-egg-info',
        )
        egg_base_option = ['--egg-base', egg_info_dir]

        # setuptools complains if the target directory does not exist.
        ensure_dir(egg_info_dir)

    with install_req.build_env:
        call_subprocess(
            base_cmd + ["egg_info"] + egg_base_option,
            cwd=install_req.unpacked_source_directory,
            command_desc='python setup.py egg_info',
        )

    # Return the .egg-info directory.
    return _find_egg_info(
        install_req.unpacked_source_directory,
        install_req.editable,
    )


def _generate_metadata(install_req):
    # type: (InstallRequirement) -> str
    return install_req.prepare_pep517_metadata()
site-packages/pip/_internal/operations/freeze.py000064400000023142151446176770016070 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import collections
import logging
import os
import re

from pip._vendor import six
from pip._vendor.packaging.utils import canonicalize_name
from pip._vendor.pkg_resources import RequirementParseError

from pip._internal.exceptions import BadCommand, InstallationError
from pip._internal.req.constructors import (
    install_req_from_editable,
    install_req_from_line,
)
from pip._internal.req.req_file import COMMENT_RE
from pip._internal.utils.misc import (
    dist_is_editable,
    get_installed_distributions,
)
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import (
        Iterator, Optional, List, Container, Set, Dict, Tuple, Iterable, Union
    )
    from pip._internal.cache import WheelCache
    from pip._vendor.pkg_resources import (
        Distribution, Requirement
    )

    RequirementInfo = Tuple[Optional[Union[str, Requirement]], bool, List[str]]


logger = logging.getLogger(__name__)


def freeze(
    requirement=None,  # type: Optional[List[str]]
    find_links=None,  # type: Optional[List[str]]
    local_only=None,  # type: Optional[bool]
    user_only=None,  # type: Optional[bool]
    paths=None,  # type: Optional[List[str]]
    skip_regex=None,  # type: Optional[str]
    isolated=False,  # type: bool
    wheel_cache=None,  # type: Optional[WheelCache]
    exclude_editable=False,  # type: bool
    skip=()  # type: Container[str]
):
    # type: (...) -> Iterator[str]
    find_links = find_links or []
    skip_match = None

    if skip_regex:
        skip_match = re.compile(skip_regex).search

    for link in find_links:
        yield '-f %s' % link
    installations = {}  # type: Dict[str, FrozenRequirement]
    for dist in get_installed_distributions(local_only=local_only,
                                            skip=(),
                                            user_only=user_only,
                                            paths=paths):
        try:
            req = FrozenRequirement.from_dist(dist)
        except RequirementParseError as exc:
            # We include dist rather than dist.project_name because the
            # dist string includes more information, like the version and
            # location. We also include the exception message to aid
            # troubleshooting.
            logger.warning(
                'Could not generate requirement for distribution %r: %s',
                dist, exc
            )
            continue
        if exclude_editable and req.editable:
            continue
        installations[req.name] = req

    if requirement:
        # the options that don't get turned into an InstallRequirement
        # should only be emitted once, even if the same option is in multiple
        # requirements files, so we need to keep track of what has been emitted
        # so that we don't emit it again if it's seen again
        emitted_options = set()  # type: Set[str]
        # keep track of which files a requirement is in so that we can
        # give an accurate warning if a requirement appears multiple times.
        req_files = collections.defaultdict(list)  # type: Dict[str, List[str]]
        for req_file_path in requirement:
            with open(req_file_path) as req_file:
                for line in req_file:
                    if (not line.strip() or
                            line.strip().startswith('#') or
                            (skip_match and skip_match(line)) or
                            line.startswith((
                                '-r', '--requirement',
                                '-Z', '--always-unzip',
                                '-f', '--find-links',
                                '-i', '--index-url',
                                '--pre',
                                '--trusted-host',
                                '--process-dependency-links',
                                '--extra-index-url'))):
                        line = line.rstrip()
                        if line not in emitted_options:
                            emitted_options.add(line)
                            yield line
                        continue

                    if line.startswith('-e') or line.startswith('--editable'):
                        if line.startswith('-e'):
                            line = line[2:].strip()
                        else:
                            line = line[len('--editable'):].strip().lstrip('=')
                        line_req = install_req_from_editable(
                            line,
                            isolated=isolated,
                            wheel_cache=wheel_cache,
                        )
                    else:
                        line_req = install_req_from_line(
                            COMMENT_RE.sub('', line).strip(),
                            isolated=isolated,
                            wheel_cache=wheel_cache,
                        )

                    if not line_req.name:
                        logger.info(
                            "Skipping line in requirement file [%s] because "
                            "it's not clear what it would install: %s",
                            req_file_path, line.strip(),
                        )
                        logger.info(
                            "  (add #egg=PackageName to the URL to avoid"
                            " this warning)"
                        )
                    elif line_req.name not in installations:
                        # either it's not installed, or it is installed
                        # but has been processed already
                        if not req_files[line_req.name]:
                            logger.warning(
                                "Requirement file [%s] contains %s, but "
                                "package %r is not installed",
                                req_file_path,
                                COMMENT_RE.sub('', line).strip(), line_req.name
                            )
                        else:
                            req_files[line_req.name].append(req_file_path)
                    else:
                        yield str(installations[line_req.name]).rstrip()
                        del installations[line_req.name]
                        req_files[line_req.name].append(req_file_path)

        # Warn about requirements that were included multiple times (in a
        # single requirements file or in different requirements files).
        for name, files in six.iteritems(req_files):
            if len(files) > 1:
                logger.warning("Requirement %s included multiple times [%s]",
                               name, ', '.join(sorted(set(files))))

        yield(
            '## The following requirements were added by '
            'pip freeze:'
        )
    for installation in sorted(
            installations.values(), key=lambda x: x.name.lower()):
        if canonicalize_name(installation.name) not in skip:
            yield str(installation).rstrip()


def get_requirement_info(dist):
    # type: (Distribution) -> RequirementInfo
    """
    Compute and return values (req, editable, comments) for use in
    FrozenRequirement.from_dist().
    """
    if not dist_is_editable(dist):
        return (None, False, [])

    location = os.path.normcase(os.path.abspath(dist.location))

    from pip._internal.vcs import vcs, RemoteNotFoundError
    vcs_backend = vcs.get_backend_for_dir(location)

    if vcs_backend is None:
        req = dist.as_requirement()
        logger.debug(
            'No VCS found for editable requirement "%s" in: %r', req,
            location,
        )
        comments = [
            '# Editable install with no version control ({})'.format(req)
        ]
        return (location, True, comments)

    try:
        req = vcs_backend.get_src_requirement(location, dist.project_name)
    except RemoteNotFoundError:
        req = dist.as_requirement()
        comments = [
            '# Editable {} install with no remote ({})'.format(
                type(vcs_backend).__name__, req,
            )
        ]
        return (location, True, comments)

    except BadCommand:
        logger.warning(
            'cannot determine version of editable source in %s '
            '(%s command not found in path)',
            location,
            vcs_backend.name,
        )
        return (None, True, [])

    except InstallationError as exc:
        logger.warning(
            "Error when trying to get requirement for VCS system %s, "
            "falling back to uneditable format", exc
        )
    else:
        if req is not None:
            return (req, True, [])

    logger.warning(
        'Could not determine repository location of %s', location
    )
    comments = ['## !! Could not determine repository location']

    return (None, False, comments)


class FrozenRequirement(object):
    def __init__(self, name, req, editable, comments=()):
        # type: (str, Union[str, Requirement], bool, Iterable[str]) -> None
        self.name = name
        self.req = req
        self.editable = editable
        self.comments = comments

    @classmethod
    def from_dist(cls, dist):
        # type: (Distribution) -> FrozenRequirement
        req, editable, comments = get_requirement_info(dist)
        if req is None:
            req = dist.as_requirement()

        return cls(dist.project_name, req, editable, comments=comments)

    def __str__(self):
        req = self.req
        if self.editable:
            req = '-e %s' % req
        return '\n'.join(list(self.comments) + [str(req)]) + '\n'
site-packages/pip/_internal/commands/help.py000064400000002235151446176770015156 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

from pip._internal.cli.base_command import Command
from pip._internal.cli.status_codes import SUCCESS
from pip._internal.exceptions import CommandError


class HelpCommand(Command):
    """Show help for commands"""

    usage = """
      %prog <command>"""
    ignore_require_venv = True

    def run(self, options, args):
        from pip._internal.commands import (
            commands_dict, create_command, get_similar_commands,
        )

        try:
            # 'pip help' with no args is handled by pip.__init__.parseopt()
            cmd_name = args[0]  # the command we need help for
        except IndexError:
            return SUCCESS

        if cmd_name not in commands_dict:
            guess = get_similar_commands(cmd_name)

            msg = ['unknown command "%s"' % cmd_name]
            if guess:
                msg.append('maybe you meant "%s"' % guess)

            raise CommandError(' - '.join(msg))

        command = create_command(cmd_name)
        command.parser.print_help()

        return SUCCESS
site-packages/pip/_internal/commands/search.py000064400000012034151446176770015471 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import sys
import textwrap
from collections import OrderedDict

from pip._vendor import pkg_resources
from pip._vendor.packaging.version import parse as parse_version
# NOTE: XMLRPC Client is not annotated in typeshed as on 2017-07-17, which is
#       why we ignore the type on this import
from pip._vendor.six.moves import xmlrpc_client  # type: ignore

from pip._internal.cli.base_command import Command
from pip._internal.cli.req_command import SessionCommandMixin
from pip._internal.cli.status_codes import NO_MATCHES_FOUND, SUCCESS
from pip._internal.exceptions import CommandError
from pip._internal.models.index import PyPI
from pip._internal.network.xmlrpc import PipXmlrpcTransport
from pip._internal.utils.compat import get_terminal_size
from pip._internal.utils.logging import indent_log
from pip._internal.utils.misc import write_output

logger = logging.getLogger(__name__)


class SearchCommand(Command, SessionCommandMixin):
    """Search for PyPI packages whose name or summary contains <query>."""

    usage = """
      %prog [options] <query>"""
    ignore_require_venv = True

    def __init__(self, *args, **kw):
        super(SearchCommand, self).__init__(*args, **kw)
        self.cmd_opts.add_option(
            '-i', '--index',
            dest='index',
            metavar='URL',
            default=PyPI.pypi_url,
            help='Base URL of Python Package Index (default %default)')

        self.parser.insert_option_group(0, self.cmd_opts)

    def run(self, options, args):
        if not args:
            raise CommandError('Missing required argument (search query).')
        query = args
        pypi_hits = self.search(query, options)
        hits = transform_hits(pypi_hits)

        terminal_width = None
        if sys.stdout.isatty():
            terminal_width = get_terminal_size()[0]

        print_results(hits, terminal_width=terminal_width)
        if pypi_hits:
            return SUCCESS
        return NO_MATCHES_FOUND

    def search(self, query, options):
        index_url = options.index

        session = self.get_default_session(options)

        transport = PipXmlrpcTransport(index_url, session)
        pypi = xmlrpc_client.ServerProxy(index_url, transport)
        hits = pypi.search({'name': query, 'summary': query}, 'or')
        return hits


def transform_hits(hits):
    """
    The list from pypi is really a list of versions. We want a list of
    packages with the list of versions stored inline. This converts the
    list from pypi into one we can use.
    """
    packages = OrderedDict()
    for hit in hits:
        name = hit['name']
        summary = hit['summary']
        version = hit['version']

        if name not in packages.keys():
            packages[name] = {
                'name': name,
                'summary': summary,
                'versions': [version],
            }
        else:
            packages[name]['versions'].append(version)

            # if this is the highest version, replace summary and score
            if version == highest_version(packages[name]['versions']):
                packages[name]['summary'] = summary

    return list(packages.values())


def print_results(hits, name_column_width=None, terminal_width=None):
    if not hits:
        return
    if name_column_width is None:
        name_column_width = max([
            len(hit['name']) + len(highest_version(hit.get('versions', ['-'])))
            for hit in hits
        ]) + 4

    installed_packages = [p.project_name for p in pkg_resources.working_set]
    for hit in hits:
        name = hit['name']
        summary = hit['summary'] or ''
        latest = highest_version(hit.get('versions', ['-']))
        if terminal_width is not None:
            target_width = terminal_width - name_column_width - 5
            if target_width > 10:
                # wrap and indent summary to fit terminal
                summary = textwrap.wrap(summary, target_width)
                summary = ('\n' + ' ' * (name_column_width + 3)).join(summary)

        line = '%-*s - %s' % (name_column_width,
                              '%s (%s)' % (name, latest), summary)
        try:
            write_output(line)
            if name in installed_packages:
                dist = pkg_resources.get_distribution(name)
                with indent_log():
                    if dist.version == latest:
                        write_output('INSTALLED: %s (latest)', dist.version)
                    else:
                        write_output('INSTALLED: %s', dist.version)
                        if parse_version(latest).pre:
                            write_output('LATEST:    %s (pre-release; install'
                                         ' with "pip install --pre")', latest)
                        else:
                            write_output('LATEST:    %s', latest)
        except UnicodeEncodeError:
            pass


def highest_version(versions):
    return max(versions, key=parse_version)
site-packages/pip/_internal/commands/hash.py000064400000003307151446176770015152 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import hashlib
import logging
import sys

from pip._internal.cli.base_command import Command
from pip._internal.cli.status_codes import ERROR
from pip._internal.utils.hashes import FAVORITE_HASH, STRONG_HASHES
from pip._internal.utils.misc import read_chunks, write_output

logger = logging.getLogger(__name__)


class HashCommand(Command):
    """
    Compute a hash of a local package archive.

    These can be used with --hash in a requirements file to do repeatable
    installs.
    """

    usage = '%prog [options] <file> ...'
    ignore_require_venv = True

    def __init__(self, *args, **kw):
        super(HashCommand, self).__init__(*args, **kw)
        self.cmd_opts.add_option(
            '-a', '--algorithm',
            dest='algorithm',
            choices=STRONG_HASHES,
            action='store',
            default=FAVORITE_HASH,
            help='The hash algorithm to use: one of %s' %
                 ', '.join(STRONG_HASHES))
        self.parser.insert_option_group(0, self.cmd_opts)

    def run(self, options, args):
        if not args:
            self.parser.print_usage(sys.stderr)
            return ERROR

        algorithm = options.algorithm
        for path in args:
            write_output('%s:\n--hash=%s:%s',
                         path, algorithm, _hash_of_file(path, algorithm))


def _hash_of_file(path, algorithm):
    """Return the hash digest of a file."""
    with open(path, 'rb') as archive:
        hash = hashlib.new(algorithm)
        for chunk in read_chunks(archive):
            hash.update(chunk)
    return hash.hexdigest()
site-packages/pip/_internal/commands/install.py000064400000057757151446176770015717 0ustar00# The following comment should be removed at some point in the future.
# It's included for now because without it InstallCommand.run() has a
# couple errors where we have to know req.name is str rather than
# Optional[str] for the InstallRequirement req.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import errno
import logging
import operator
import os
import shutil
import sys
from os import path
from optparse import SUPPRESS_HELP

from pip._vendor import pkg_resources
from pip._vendor.packaging.utils import canonicalize_name

from pip._internal.cache import WheelCache
from pip._internal.cli import cmdoptions
from pip._internal.cli.cmdoptions import make_target_python
from pip._internal.cli.req_command import RequirementCommand
from pip._internal.cli.status_codes import ERROR, SUCCESS
from pip._internal.exceptions import (
    CommandError,
    InstallationError,
    PreviousBuildDirError,
)
from pip._internal.locations import distutils_scheme
from pip._internal.operations.check import check_install_conflicts
from pip._internal.req import RequirementSet, install_given_reqs
from pip._internal.req.req_tracker import RequirementTracker
from pip._internal.utils.filesystem import check_path_owner
from pip._internal.utils.misc import (
    ensure_dir,
    get_installed_version,
    protect_pip_from_modification_on_windows,
    write_output,
)
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.virtualenv import virtualenv_no_global
from pip._internal.wheel import WheelBuilder

if MYPY_CHECK_RUNNING:
    from optparse import Values
    from typing import Any, List, Optional

    from pip._internal.models.format_control import FormatControl
    from pip._internal.req.req_install import InstallRequirement
    from pip._internal.wheel import BinaryAllowedPredicate


logger = logging.getLogger(__name__)


def is_wheel_installed():
    """
    Return whether the wheel package is installed.
    """
    try:
        import wheel  # noqa: F401
    except ImportError:
        return False

    return True


def build_wheels(
    builder,              # type: WheelBuilder
    pep517_requirements,  # type: List[InstallRequirement]
    legacy_requirements,  # type: List[InstallRequirement]
):
    # type: (...) -> List[InstallRequirement]
    """
    Build wheels for requirements, depending on whether wheel is installed.
    """
    # We don't build wheels for legacy requirements if wheel is not installed.
    should_build_legacy = is_wheel_installed()

    # Always build PEP 517 requirements
    build_failures = builder.build(
        pep517_requirements,
        should_unpack=True,
    )

    if should_build_legacy:
        # We don't care about failures building legacy
        # requirements, as we'll fall through to a direct
        # install for those.
        builder.build(
            legacy_requirements,
            should_unpack=True,
        )

    return build_failures


def get_check_binary_allowed(format_control):
    # type: (FormatControl) -> BinaryAllowedPredicate
    def check_binary_allowed(req):
        # type: (InstallRequirement) -> bool
        if req.use_pep517:
            return True
        canonical_name = canonicalize_name(req.name)
        allowed_formats = format_control.get_allowed_formats(canonical_name)
        return "binary" in allowed_formats

    return check_binary_allowed


class InstallCommand(RequirementCommand):
    """
    Install packages from:

    - PyPI (and other indexes) using requirement specifiers.
    - VCS project urls.
    - Local project directories.
    - Local or remote source archives.

    pip also supports installing from "requirements files", which provide
    an easy way to specify a whole environment to be installed.
    """

    usage = """
      %prog [options] <requirement specifier> [package-index-options] ...
      %prog [options] -r <requirements file> [package-index-options] ...
      %prog [options] [-e] <vcs project url> ...
      %prog [options] [-e] <local project path> ...
      %prog [options] <archive url/path> ..."""

    def __init__(self, *args, **kw):
        super(InstallCommand, self).__init__(*args, **kw)

        cmd_opts = self.cmd_opts

        cmd_opts.add_option(cmdoptions.requirements())
        cmd_opts.add_option(cmdoptions.constraints())
        cmd_opts.add_option(cmdoptions.no_deps())
        cmd_opts.add_option(cmdoptions.pre())

        cmd_opts.add_option(cmdoptions.editable())
        cmd_opts.add_option(
            '-t', '--target',
            dest='target_dir',
            metavar='dir',
            default=None,
            help='Install packages into <dir>. '
                 'By default this will not replace existing files/folders in '
                 '<dir>. Use --upgrade to replace existing packages in <dir> '
                 'with new versions.'
        )
        cmdoptions.add_target_python_options(cmd_opts)

        cmd_opts.add_option(
            '--user',
            dest='use_user_site',
            action='store_true',
            help="Install to the Python user install directory for your "
                 "platform. Typically ~/.local/, or %APPDATA%\\Python on "
                 "Windows. (See the Python documentation for site.USER_BASE "
                 "for full details.)")
        cmd_opts.add_option(
            '--no-user',
            dest='use_user_site',
            action='store_false',
            help=SUPPRESS_HELP)
        cmd_opts.add_option(
            '--root',
            dest='root_path',
            metavar='dir',
            default=None,
            help="Install everything relative to this alternate root "
                 "directory.")
        cmd_opts.add_option(
            '--prefix',
            dest='prefix_path',
            metavar='dir',
            default=None,
            help="Installation prefix where lib, bin and other top-level "
                 "folders are placed")

        cmd_opts.add_option(cmdoptions.build_dir())

        cmd_opts.add_option(cmdoptions.src())

        cmd_opts.add_option(
            '-U', '--upgrade',
            dest='upgrade',
            action='store_true',
            help='Upgrade all specified packages to the newest available '
                 'version. The handling of dependencies depends on the '
                 'upgrade-strategy used.'
        )

        cmd_opts.add_option(
            '--upgrade-strategy',
            dest='upgrade_strategy',
            default='only-if-needed',
            choices=['only-if-needed', 'eager'],
            help='Determines how dependency upgrading should be handled '
                 '[default: %default]. '
                 '"eager" - dependencies are upgraded regardless of '
                 'whether the currently installed version satisfies the '
                 'requirements of the upgraded package(s). '
                 '"only-if-needed" -  are upgraded only when they do not '
                 'satisfy the requirements of the upgraded package(s).'
        )

        cmd_opts.add_option(
            '--force-reinstall',
            dest='force_reinstall',
            action='store_true',
            help='Reinstall all packages even if they are already '
                 'up-to-date.')

        cmd_opts.add_option(
            '-I', '--ignore-installed',
            dest='ignore_installed',
            action='store_true',
            help='Ignore the installed packages, overwriting them. '
                 'This can break your system if the existing package '
                 'is of a different version or was installed '
                 'with a different package manager!'
        )

        cmd_opts.add_option(cmdoptions.ignore_requires_python())
        cmd_opts.add_option(cmdoptions.no_build_isolation())
        cmd_opts.add_option(cmdoptions.use_pep517())
        cmd_opts.add_option(cmdoptions.no_use_pep517())

        cmd_opts.add_option(cmdoptions.install_options())
        cmd_opts.add_option(cmdoptions.global_options())

        cmd_opts.add_option(
            "--compile",
            action="store_true",
            dest="compile",
            default=True,
            help="Compile Python source files to bytecode",
        )

        cmd_opts.add_option(
            "--no-compile",
            action="store_false",
            dest="compile",
            help="Do not compile Python source files to bytecode",
        )

        cmd_opts.add_option(
            "--no-warn-script-location",
            action="store_false",
            dest="warn_script_location",
            default=True,
            help="Do not warn when installing scripts outside PATH",
        )
        cmd_opts.add_option(
            "--no-warn-conflicts",
            action="store_false",
            dest="warn_about_conflicts",
            default=True,
            help="Do not warn about broken dependencies",
        )

        cmd_opts.add_option(cmdoptions.no_binary())
        cmd_opts.add_option(cmdoptions.only_binary())
        cmd_opts.add_option(cmdoptions.prefer_binary())
        cmd_opts.add_option(cmdoptions.no_clean())
        cmd_opts.add_option(cmdoptions.require_hashes())
        cmd_opts.add_option(cmdoptions.progress_bar())

        index_opts = cmdoptions.make_option_group(
            cmdoptions.index_group,
            self.parser,
        )

        self.parser.insert_option_group(0, index_opts)
        self.parser.insert_option_group(0, cmd_opts)

    def run(self, options, args):
        # type: (Values, List[Any]) -> int
        cmdoptions.check_install_build_global(options)

        def is_venv():
            return (hasattr(sys, 'real_prefix') or
                    (hasattr(sys, 'base_prefix') and
                     sys.base_prefix != sys.prefix))

        # Check whether we have root privileges and aren't in venv/virtualenv
        if os.getuid() == 0 and not is_venv():
            command = path.basename(sys.argv[0])
            if command == "__main__.py":
                command = path.basename(sys.executable) + " -m pip"
            logger.warning(
                "Running pip install with root privileges is "
                "generally not a good idea. Try `%s install --user` instead."
                % command
            )

        upgrade_strategy = "to-satisfy-only"
        if options.upgrade:
            upgrade_strategy = options.upgrade_strategy

        if options.build_dir:
            options.build_dir = os.path.abspath(options.build_dir)

        cmdoptions.check_dist_restriction(options, check_target=True)

        options.src_dir = os.path.abspath(options.src_dir)
        install_options = options.install_options or []
        if options.use_user_site:
            if options.prefix_path:
                raise CommandError(
                    "Can not combine '--user' and '--prefix' as they imply "
                    "different installation locations"
                )
            if virtualenv_no_global():
                raise InstallationError(
                    "Can not perform a '--user' install. User site-packages "
                    "are not visible in this virtualenv."
                )
            install_options.append('--user')
            install_options.append('--prefix=')

        target_temp_dir = None  # type: Optional[TempDirectory]
        target_temp_dir_path = None  # type: Optional[str]
        if options.target_dir:
            options.ignore_installed = True
            options.target_dir = os.path.abspath(options.target_dir)
            if (os.path.exists(options.target_dir) and not
                    os.path.isdir(options.target_dir)):
                raise CommandError(
                    "Target path exists but is not a directory, will not "
                    "continue."
                )

            # Create a target directory for using with the target option
            target_temp_dir = TempDirectory(kind="target")
            target_temp_dir_path = target_temp_dir.path
            install_options.append('--home=' + target_temp_dir_path)

        global_options = options.global_options or []

        session = self.get_default_session(options)

        target_python = make_target_python(options)
        finder = self._build_package_finder(
            options=options,
            session=session,
            target_python=target_python,
            ignore_requires_python=options.ignore_requires_python,
        )
        build_delete = (not (options.no_clean or options.build_dir))
        wheel_cache = WheelCache(options.cache_dir, options.format_control)

        if options.cache_dir and not check_path_owner(options.cache_dir):
            logger.warning(
                "The directory '%s' or its parent directory is not owned "
                "by the current user and caching wheels has been "
                "disabled. check the permissions and owner of that "
                "directory. If executing pip with sudo, you may want "
                "sudo's -H flag.",
                options.cache_dir,
            )
            options.cache_dir = None

        with RequirementTracker() as req_tracker, TempDirectory(
            options.build_dir, delete=build_delete, kind="install"
        ) as directory:
            requirement_set = RequirementSet(
                require_hashes=options.require_hashes,
                check_supported_wheels=not options.target_dir,
            )

            try:
                self.populate_requirement_set(
                    requirement_set, args, options, finder, session,
                    wheel_cache
                )
                preparer = self.make_requirement_preparer(
                    temp_build_dir=directory,
                    options=options,
                    req_tracker=req_tracker,
                )
                resolver = self.make_resolver(
                    preparer=preparer,
                    finder=finder,
                    session=session,
                    options=options,
                    wheel_cache=wheel_cache,
                    use_user_site=options.use_user_site,
                    ignore_installed=options.ignore_installed,
                    ignore_requires_python=options.ignore_requires_python,
                    force_reinstall=options.force_reinstall,
                    upgrade_strategy=upgrade_strategy,
                    use_pep517=options.use_pep517,
                )
                resolver.resolve(requirement_set)

                try:
                    pip_req = requirement_set.get_requirement("pip")
                except KeyError:
                    modifying_pip = None
                else:
                    # If we're not replacing an already installed pip,
                    # we're not modifying it.
                    modifying_pip = pip_req.satisfied_by is None
                protect_pip_from_modification_on_windows(
                    modifying_pip=modifying_pip
                )

                check_binary_allowed = get_check_binary_allowed(
                    finder.format_control
                )
                # Consider legacy and PEP517-using requirements separately
                legacy_requirements = []
                pep517_requirements = []
                for req in requirement_set.requirements.values():
                    if req.use_pep517:
                        pep517_requirements.append(req)
                    else:
                        legacy_requirements.append(req)

                wheel_builder = WheelBuilder(
                    preparer, wheel_cache,
                    build_options=[], global_options=[],
                    check_binary_allowed=check_binary_allowed,
                )

                build_failures = build_wheels(
                    builder=wheel_builder,
                    pep517_requirements=pep517_requirements,
                    legacy_requirements=legacy_requirements,
                )

                # If we're using PEP 517, we cannot do a direct install
                # so we fail here.
                if build_failures:
                    raise InstallationError(
                        "Could not build wheels for {} which use"
                        " PEP 517 and cannot be installed directly".format(
                            ", ".join(r.name for r in build_failures)))

                to_install = resolver.get_installation_order(
                    requirement_set
                )

                # Consistency Checking of the package set we're installing.
                should_warn_about_conflicts = (
                    not options.ignore_dependencies and
                    options.warn_about_conflicts
                )
                if should_warn_about_conflicts:
                    self._warn_about_conflicts(to_install)

                # Don't warn about script install locations if
                # --target has been specified
                warn_script_location = options.warn_script_location
                if options.target_dir:
                    warn_script_location = False

                installed = install_given_reqs(
                    to_install,
                    install_options,
                    global_options,
                    root=options.root_path,
                    home=target_temp_dir_path,
                    prefix=options.prefix_path,
                    pycompile=options.compile,
                    warn_script_location=warn_script_location,
                    use_user_site=options.use_user_site,
                )

                lib_locations = get_lib_location_guesses(
                    user=options.use_user_site,
                    home=target_temp_dir_path,
                    root=options.root_path,
                    prefix=options.prefix_path,
                    isolated=options.isolated_mode,
                )
                working_set = pkg_resources.WorkingSet(lib_locations)

                reqs = sorted(installed, key=operator.attrgetter('name'))
                items = []
                for req in reqs:
                    item = req.name
                    try:
                        installed_version = get_installed_version(
                            req.name, working_set=working_set
                        )
                        if installed_version:
                            item += '-' + installed_version
                    except Exception:
                        pass
                    items.append(item)
                installed_desc = ' '.join(items)
                if installed_desc:
                    write_output(
                        'Successfully installed %s', installed_desc,
                    )
            except EnvironmentError as error:
                show_traceback = (self.verbosity >= 1)

                message = create_env_error_message(
                    error, show_traceback, options.use_user_site,
                )
                logger.error(message, exc_info=show_traceback)

                return ERROR
            except PreviousBuildDirError:
                options.no_clean = True
                raise
            finally:
                # Clean up
                if not options.no_clean:
                    requirement_set.cleanup_files()
                    wheel_cache.cleanup()

        if options.target_dir:
            self._handle_target_dir(
                options.target_dir, target_temp_dir, options.upgrade
            )

        return SUCCESS

    def _handle_target_dir(self, target_dir, target_temp_dir, upgrade):
        ensure_dir(target_dir)

        # Checking both purelib and platlib directories for installed
        # packages to be moved to target directory
        lib_dir_list = []

        with target_temp_dir:
            # Checking both purelib and platlib directories for installed
            # packages to be moved to target directory
            scheme = distutils_scheme('', home=target_temp_dir.path)
            purelib_dir = scheme['purelib']
            platlib_dir = scheme['platlib']
            data_dir = scheme['data']

            if os.path.exists(purelib_dir):
                lib_dir_list.append(purelib_dir)
            if os.path.exists(platlib_dir) and platlib_dir != purelib_dir:
                lib_dir_list.append(platlib_dir)
            if os.path.exists(data_dir):
                lib_dir_list.append(data_dir)

            for lib_dir in lib_dir_list:
                for item in os.listdir(lib_dir):
                    if lib_dir == data_dir:
                        ddir = os.path.join(data_dir, item)
                        if any(s.startswith(ddir) for s in lib_dir_list[:-1]):
                            continue
                    target_item_dir = os.path.join(target_dir, item)
                    if os.path.exists(target_item_dir):
                        if not upgrade:
                            logger.warning(
                                'Target directory %s already exists. Specify '
                                '--upgrade to force replacement.',
                                target_item_dir
                            )
                            continue
                        if os.path.islink(target_item_dir):
                            logger.warning(
                                'Target directory %s already exists and is '
                                'a link. Pip will not automatically replace '
                                'links, please remove if replacement is '
                                'desired.',
                                target_item_dir
                            )
                            continue
                        if os.path.isdir(target_item_dir):
                            shutil.rmtree(target_item_dir)
                        else:
                            os.remove(target_item_dir)

                    shutil.move(
                        os.path.join(lib_dir, item),
                        target_item_dir
                    )

    def _warn_about_conflicts(self, to_install):
        try:
            package_set, _dep_info = check_install_conflicts(to_install)
        except Exception:
            logger.error("Error checking for conflicts.", exc_info=True)
            return
        missing, conflicting = _dep_info

        # NOTE: There is some duplication here from pip check
        for project_name in missing:
            version = package_set[project_name][0]
            for dependency in missing[project_name]:
                logger.critical(
                    "%s %s requires %s, which is not installed.",
                    project_name, version, dependency[1],
                )

        for project_name in conflicting:
            version = package_set[project_name][0]
            for dep_name, dep_version, req in conflicting[project_name]:
                logger.critical(
                    "%s %s has requirement %s, but you'll have %s %s which is "
                    "incompatible.",
                    project_name, version, req, dep_name, dep_version,
                )


def get_lib_location_guesses(*args, **kwargs):
    scheme = distutils_scheme('', *args, **kwargs)
    return [scheme['purelib'], scheme['platlib']]


def create_env_error_message(error, show_traceback, using_user_site):
    """Format an error message for an EnvironmentError

    It may occur anytime during the execution of the install command.
    """
    parts = []

    # Mention the error if we are not going to show a traceback
    parts.append("Could not install packages due to an EnvironmentError")
    if not show_traceback:
        parts.append(": ")
        parts.append(str(error))
    else:
        parts.append(".")

    # Spilt the error indication from a helper message (if any)
    parts[-1] += "\n"

    # Suggest useful actions to the user:
    #  (1) using user site-packages or (2) verifying the permissions
    if error.errno == errno.EACCES:
        user_option_part = "Consider using the `--user` option"
        permissions_part = "Check the permissions"

        if not using_user_site:
            parts.extend([
                user_option_part, " or ",
                permissions_part.lower(),
            ])
        else:
            parts.append(permissions_part)
        parts.append(".\n")

    return "".join(parts).strip() + "\n"
site-packages/pip/_internal/commands/completion.py000064400000005637151446176770016410 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import sys
import textwrap

from pip._internal.cli.base_command import Command
from pip._internal.utils.misc import get_prog

BASE_COMPLETION = """
# pip %(shell)s completion start%(script)s# pip %(shell)s completion end
"""

COMPLETION_SCRIPTS = {
    'bash': """
        _pip_completion()
        {
            COMPREPLY=( $( COMP_WORDS="${COMP_WORDS[*]}" \\
                           COMP_CWORD=$COMP_CWORD \\
                           PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) )
        }
        complete -o default -F _pip_completion %(prog)s
    """,
    'zsh': """
        function _pip_completion {
          local words cword
          read -Ac words
          read -cn cword
          reply=( $( COMP_WORDS="$words[*]" \\
                     COMP_CWORD=$(( cword-1 )) \\
                     PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null ))
        }
        compctl -K _pip_completion %(prog)s
    """,
    'fish': """
        function __fish_complete_pip
            set -lx COMP_WORDS (commandline -o) ""
            set -lx COMP_CWORD ( \\
                math (contains -i -- (commandline -t) $COMP_WORDS)-1 \\
            )
            set -lx PIP_AUTO_COMPLETE 1
            string split \\  -- (eval $COMP_WORDS[1])
        end
        complete -fa "(__fish_complete_pip)" -c %(prog)s
    """,
}


class CompletionCommand(Command):
    """A helper command to be used for command completion."""

    ignore_require_venv = True

    def __init__(self, *args, **kw):
        super(CompletionCommand, self).__init__(*args, **kw)

        cmd_opts = self.cmd_opts

        cmd_opts.add_option(
            '--bash', '-b',
            action='store_const',
            const='bash',
            dest='shell',
            help='Emit completion code for bash')
        cmd_opts.add_option(
            '--zsh', '-z',
            action='store_const',
            const='zsh',
            dest='shell',
            help='Emit completion code for zsh')
        cmd_opts.add_option(
            '--fish', '-f',
            action='store_const',
            const='fish',
            dest='shell',
            help='Emit completion code for fish')

        self.parser.insert_option_group(0, cmd_opts)

    def run(self, options, args):
        """Prints the completion code of the given shell"""
        shells = COMPLETION_SCRIPTS.keys()
        shell_options = ['--' + shell for shell in sorted(shells)]
        if options.shell in shells:
            script = textwrap.dedent(
                COMPLETION_SCRIPTS.get(options.shell, '') % {
                    'prog': get_prog(),
                }
            )
            print(BASE_COMPLETION % {'script': script, 'shell': options.shell})
        else:
            sys.stderr.write(
                'ERROR: You must pass %s\n' % ' or '.join(shell_options)
            )
site-packages/pip/_internal/commands/uninstall.py000064400000005647151446176770016251 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

from pip._vendor.packaging.utils import canonicalize_name

from pip._internal.cli.base_command import Command
from pip._internal.cli.req_command import SessionCommandMixin
from pip._internal.exceptions import InstallationError
from pip._internal.req import parse_requirements
from pip._internal.req.constructors import install_req_from_line
from pip._internal.utils.misc import protect_pip_from_modification_on_windows


class UninstallCommand(Command, SessionCommandMixin):
    """
    Uninstall packages.

    pip is able to uninstall most installed packages. Known exceptions are:

    - Pure distutils packages installed with ``python setup.py install``, which
      leave behind no metadata to determine what files were installed.
    - Script wrappers installed by ``python setup.py develop``.
    """

    usage = """
      %prog [options] <package> ...
      %prog [options] -r <requirements file> ..."""

    def __init__(self, *args, **kw):
        super(UninstallCommand, self).__init__(*args, **kw)
        self.cmd_opts.add_option(
            '-r', '--requirement',
            dest='requirements',
            action='append',
            default=[],
            metavar='file',
            help='Uninstall all the packages listed in the given requirements '
                 'file.  This option can be used multiple times.',
        )
        self.cmd_opts.add_option(
            '-y', '--yes',
            dest='yes',
            action='store_true',
            help="Don't ask for confirmation of uninstall deletions.")

        self.parser.insert_option_group(0, self.cmd_opts)

    def run(self, options, args):
        session = self.get_default_session(options)

        reqs_to_uninstall = {}
        for name in args:
            req = install_req_from_line(
                name, isolated=options.isolated_mode,
            )
            if req.name:
                reqs_to_uninstall[canonicalize_name(req.name)] = req
        for filename in options.requirements:
            for req in parse_requirements(
                    filename,
                    options=options,
                    session=session):
                if req.name:
                    reqs_to_uninstall[canonicalize_name(req.name)] = req
        if not reqs_to_uninstall:
            raise InstallationError(
                'You must give at least one requirement to %(name)s (see '
                '"pip help %(name)s")' % dict(name=self.name)
            )

        protect_pip_from_modification_on_windows(
            modifying_pip="pip" in reqs_to_uninstall
        )

        for req in reqs_to_uninstall.values():
            uninstall_pathset = req.uninstall(
                auto_confirm=options.yes, verbose=self.verbosity > 0,
            )
            if uninstall_pathset:
                uninstall_pathset.commit()
site-packages/pip/_internal/commands/wheel.py000064400000014410151446176770015330 0ustar00# -*- coding: utf-8 -*-

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os

from pip._internal.cache import WheelCache
from pip._internal.cli import cmdoptions
from pip._internal.cli.req_command import RequirementCommand
from pip._internal.exceptions import CommandError, PreviousBuildDirError
from pip._internal.req import RequirementSet
from pip._internal.req.req_tracker import RequirementTracker
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.wheel import WheelBuilder

if MYPY_CHECK_RUNNING:
    from optparse import Values
    from typing import Any, List


logger = logging.getLogger(__name__)


class WheelCommand(RequirementCommand):
    """
    Build Wheel archives for your requirements and dependencies.

    Wheel is a built-package format, and offers the advantage of not
    recompiling your software during every install. For more details, see the
    wheel docs: https://wheel.readthedocs.io/en/latest/

    Requirements: setuptools>=0.8, and wheel.

    'pip wheel' uses the bdist_wheel setuptools extension from the wheel
    package to build individual wheels.

    """

    usage = """
      %prog [options] <requirement specifier> ...
      %prog [options] -r <requirements file> ...
      %prog [options] [-e] <vcs project url> ...
      %prog [options] [-e] <local project path> ...
      %prog [options] <archive url/path> ..."""

    def __init__(self, *args, **kw):
        super(WheelCommand, self).__init__(*args, **kw)

        cmd_opts = self.cmd_opts

        cmd_opts.add_option(
            '-w', '--wheel-dir',
            dest='wheel_dir',
            metavar='dir',
            default=os.curdir,
            help=("Build wheels into <dir>, where the default is the "
                  "current working directory."),
        )
        cmd_opts.add_option(cmdoptions.no_binary())
        cmd_opts.add_option(cmdoptions.only_binary())
        cmd_opts.add_option(cmdoptions.prefer_binary())
        cmd_opts.add_option(
            '--build-option',
            dest='build_options',
            metavar='options',
            action='append',
            help="Extra arguments to be supplied to 'setup.py bdist_wheel'.",
        )
        cmd_opts.add_option(cmdoptions.no_build_isolation())
        cmd_opts.add_option(cmdoptions.use_pep517())
        cmd_opts.add_option(cmdoptions.no_use_pep517())
        cmd_opts.add_option(cmdoptions.constraints())
        cmd_opts.add_option(cmdoptions.editable())
        cmd_opts.add_option(cmdoptions.requirements())
        cmd_opts.add_option(cmdoptions.src())
        cmd_opts.add_option(cmdoptions.ignore_requires_python())
        cmd_opts.add_option(cmdoptions.no_deps())
        cmd_opts.add_option(cmdoptions.build_dir())
        cmd_opts.add_option(cmdoptions.progress_bar())

        cmd_opts.add_option(
            '--global-option',
            dest='global_options',
            action='append',
            metavar='options',
            help="Extra global options to be supplied to the setup.py "
            "call before the 'bdist_wheel' command.")

        cmd_opts.add_option(
            '--pre',
            action='store_true',
            default=False,
            help=("Include pre-release and development versions. By default, "
                  "pip only finds stable versions."),
        )

        cmd_opts.add_option(cmdoptions.no_clean())
        cmd_opts.add_option(cmdoptions.require_hashes())

        index_opts = cmdoptions.make_option_group(
            cmdoptions.index_group,
            self.parser,
        )

        self.parser.insert_option_group(0, index_opts)
        self.parser.insert_option_group(0, cmd_opts)

    def run(self, options, args):
        # type: (Values, List[Any]) -> None
        cmdoptions.check_install_build_global(options)

        if options.build_dir:
            options.build_dir = os.path.abspath(options.build_dir)

        options.src_dir = os.path.abspath(options.src_dir)

        session = self.get_default_session(options)

        finder = self._build_package_finder(options, session)
        build_delete = (not (options.no_clean or options.build_dir))
        wheel_cache = WheelCache(options.cache_dir, options.format_control)

        with RequirementTracker() as req_tracker, TempDirectory(
            options.build_dir, delete=build_delete, kind="wheel"
        ) as directory:

            requirement_set = RequirementSet(
                require_hashes=options.require_hashes,
            )

            try:
                self.populate_requirement_set(
                    requirement_set, args, options, finder, session,
                    wheel_cache
                )

                preparer = self.make_requirement_preparer(
                    temp_build_dir=directory,
                    options=options,
                    req_tracker=req_tracker,
                    wheel_download_dir=options.wheel_dir,
                )

                resolver = self.make_resolver(
                    preparer=preparer,
                    finder=finder,
                    session=session,
                    options=options,
                    wheel_cache=wheel_cache,
                    ignore_requires_python=options.ignore_requires_python,
                    use_pep517=options.use_pep517,
                )
                resolver.resolve(requirement_set)

                # build wheels
                wb = WheelBuilder(
                    preparer, wheel_cache,
                    build_options=options.build_options or [],
                    global_options=options.global_options or [],
                    no_clean=options.no_clean,
                )
                build_failures = wb.build(
                    requirement_set.requirements.values(),
                )
                if len(build_failures) != 0:
                    raise CommandError(
                        "Failed to build one or more wheels"
                    )
            except PreviousBuildDirError:
                options.no_clean = True
                raise
            finally:
                if not options.no_clean:
                    requirement_set.cleanup_files()
                    wheel_cache.cleanup()
site-packages/pip/_internal/commands/list.py000064400000024464151446176770015211 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import json
import logging

from pip._vendor import six
from pip._vendor.six.moves import zip_longest

from pip._internal.cli import cmdoptions
from pip._internal.cli.req_command import IndexGroupCommand
from pip._internal.exceptions import CommandError
from pip._internal.index import PackageFinder
from pip._internal.models.selection_prefs import SelectionPreferences
from pip._internal.self_outdated_check import make_link_collector
from pip._internal.utils.misc import (
    dist_is_editable,
    get_installed_distributions,
    write_output,
)
from pip._internal.utils.packaging import get_installer

logger = logging.getLogger(__name__)


class ListCommand(IndexGroupCommand):
    """
    List installed packages, including editables.

    Packages are listed in a case-insensitive sorted order.
    """

    usage = """
      %prog [options]"""

    def __init__(self, *args, **kw):
        super(ListCommand, self).__init__(*args, **kw)

        cmd_opts = self.cmd_opts

        cmd_opts.add_option(
            '-o', '--outdated',
            action='store_true',
            default=False,
            help='List outdated packages')
        cmd_opts.add_option(
            '-u', '--uptodate',
            action='store_true',
            default=False,
            help='List uptodate packages')
        cmd_opts.add_option(
            '-e', '--editable',
            action='store_true',
            default=False,
            help='List editable projects.')
        cmd_opts.add_option(
            '-l', '--local',
            action='store_true',
            default=False,
            help=('If in a virtualenv that has global access, do not list '
                  'globally-installed packages.'),
        )
        self.cmd_opts.add_option(
            '--user',
            dest='user',
            action='store_true',
            default=False,
            help='Only output packages installed in user-site.')
        cmd_opts.add_option(cmdoptions.list_path())
        cmd_opts.add_option(
            '--pre',
            action='store_true',
            default=False,
            help=("Include pre-release and development versions. By default, "
                  "pip only finds stable versions."),
        )

        cmd_opts.add_option(
            '--format',
            action='store',
            dest='list_format',
            default="columns",
            choices=('columns', 'freeze', 'json'),
            help="Select the output format among: columns (default), freeze, "
                 "or json",
        )

        cmd_opts.add_option(
            '--not-required',
            action='store_true',
            dest='not_required',
            help="List packages that are not dependencies of "
                 "installed packages.",
        )

        cmd_opts.add_option(
            '--exclude-editable',
            action='store_false',
            dest='include_editable',
            help='Exclude editable package from output.',
        )
        cmd_opts.add_option(
            '--include-editable',
            action='store_true',
            dest='include_editable',
            help='Include editable package from output.',
            default=True,
        )
        index_opts = cmdoptions.make_option_group(
            cmdoptions.index_group, self.parser
        )

        self.parser.insert_option_group(0, index_opts)
        self.parser.insert_option_group(0, cmd_opts)

    def _build_package_finder(self, options, session):
        """
        Create a package finder appropriate to this list command.
        """
        link_collector = make_link_collector(session, options=options)

        # Pass allow_yanked=False to ignore yanked versions.
        selection_prefs = SelectionPreferences(
            allow_yanked=False,
            allow_all_prereleases=options.pre,
        )

        return PackageFinder.create(
            link_collector=link_collector,
            selection_prefs=selection_prefs,
        )

    def run(self, options, args):
        if options.outdated and options.uptodate:
            raise CommandError(
                "Options --outdated and --uptodate cannot be combined.")

        cmdoptions.check_list_path_option(options)

        packages = get_installed_distributions(
            local_only=options.local,
            user_only=options.user,
            editables_only=options.editable,
            include_editables=options.include_editable,
            paths=options.path,
        )

        # get_not_required must be called firstly in order to find and
        # filter out all dependencies correctly. Otherwise a package
        # can't be identified as requirement because some parent packages
        # could be filtered out before.
        if options.not_required:
            packages = self.get_not_required(packages, options)

        if options.outdated:
            packages = self.get_outdated(packages, options)
        elif options.uptodate:
            packages = self.get_uptodate(packages, options)

        self.output_package_listing(packages, options)

    def get_outdated(self, packages, options):
        return [
            dist for dist in self.iter_packages_latest_infos(packages, options)
            if dist.latest_version > dist.parsed_version
        ]

    def get_uptodate(self, packages, options):
        return [
            dist for dist in self.iter_packages_latest_infos(packages, options)
            if dist.latest_version == dist.parsed_version
        ]

    def get_not_required(self, packages, options):
        dep_keys = set()
        for dist in packages:
            dep_keys.update(requirement.key for requirement in dist.requires())
        return {pkg for pkg in packages if pkg.key not in dep_keys}

    def iter_packages_latest_infos(self, packages, options):
        with self._build_session(options) as session:
            finder = self._build_package_finder(options, session)

            for dist in packages:
                typ = 'unknown'
                all_candidates = finder.find_all_candidates(dist.key)
                if not options.pre:
                    # Remove prereleases
                    all_candidates = [candidate for candidate in all_candidates
                                      if not candidate.version.is_prerelease]

                evaluator = finder.make_candidate_evaluator(
                    project_name=dist.project_name,
                )
                best_candidate = evaluator.sort_best_candidate(all_candidates)
                if best_candidate is None:
                    continue

                remote_version = best_candidate.version
                if best_candidate.link.is_wheel:
                    typ = 'wheel'
                else:
                    typ = 'sdist'
                # This is dirty but makes the rest of the code much cleaner
                dist.latest_version = remote_version
                dist.latest_filetype = typ
                yield dist

    def output_package_listing(self, packages, options):
        packages = sorted(
            packages,
            key=lambda dist: dist.project_name.lower(),
        )
        if options.list_format == 'columns' and packages:
            data, header = format_for_columns(packages, options)
            self.output_package_listing_columns(data, header)
        elif options.list_format == 'freeze':
            for dist in packages:
                if options.verbose >= 1:
                    write_output("%s==%s (%s)", dist.project_name,
                                 dist.version, dist.location)
                else:
                    write_output("%s==%s", dist.project_name, dist.version)
        elif options.list_format == 'json':
            write_output(format_for_json(packages, options))

    def output_package_listing_columns(self, data, header):
        # insert the header first: we need to know the size of column names
        if len(data) > 0:
            data.insert(0, header)

        pkg_strings, sizes = tabulate(data)

        # Create and add a separator.
        if len(data) > 0:
            pkg_strings.insert(1, " ".join(map(lambda x: '-' * x, sizes)))

        for val in pkg_strings:
            write_output(val)


def tabulate(vals):
    # From pfmoore on GitHub:
    # https://github.com/pypa/pip/issues/3651#issuecomment-216932564
    assert len(vals) > 0

    sizes = [0] * max(len(x) for x in vals)
    for row in vals:
        sizes = [max(s, len(str(c))) for s, c in zip_longest(sizes, row)]

    result = []
    for row in vals:
        display = " ".join([str(c).ljust(s) if c is not None else ''
                            for s, c in zip_longest(sizes, row)])
        result.append(display)

    return result, sizes


def format_for_columns(pkgs, options):
    """
    Convert the package data into something usable
    by output_package_listing_columns.
    """
    running_outdated = options.outdated
    # Adjust the header for the `pip list --outdated` case.
    if running_outdated:
        header = ["Package", "Version", "Latest", "Type"]
    else:
        header = ["Package", "Version"]

    data = []
    if options.verbose >= 1 or any(dist_is_editable(x) for x in pkgs):
        header.append("Location")
    if options.verbose >= 1:
        header.append("Installer")

    for proj in pkgs:
        # if we're working on the 'outdated' list, separate out the
        # latest_version and type
        row = [proj.project_name, proj.version]

        if running_outdated:
            row.append(proj.latest_version)
            row.append(proj.latest_filetype)

        if options.verbose >= 1 or dist_is_editable(proj):
            row.append(proj.location)
        if options.verbose >= 1:
            row.append(get_installer(proj))

        data.append(row)

    return data, header


def format_for_json(packages, options):
    data = []
    for dist in packages:
        info = {
            'name': dist.project_name,
            'version': six.text_type(dist.version),
        }
        if options.verbose >= 1:
            info['location'] = dist.location
            info['installer'] = get_installer(dist)
        if options.outdated:
            info['latest_version'] = six.text_type(dist.latest_version)
            info['latest_filetype'] = dist.latest_filetype
        data.append(info)
    return json.dumps(data)
site-packages/pip/_internal/commands/__pycache__/wheel.cpython-38.opt-1.pyc000064400000011015151446176770022553 0ustar00U

��.e�@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZmZddl
mZddlmZdd	lmZdd
lmZddlmZer�ddlmZdd
lmZmZe�e�ZGdd�de	�ZdS)�)�absolute_importN)�
WheelCache)�
cmdoptions)�RequirementCommand)�CommandError�PreviousBuildDirError)�RequirementSet)�RequirementTracker)�
TempDirectory)�MYPY_CHECK_RUNNING)�WheelBuilder)�Values)�Any�Listcs,eZdZdZdZ�fdd�Zdd�Z�ZS)�WheelCommanda�
    Build Wheel archives for your requirements and dependencies.

    Wheel is a built-package format, and offers the advantage of not
    recompiling your software during every install. For more details, see the
    wheel docs: https://wheel.readthedocs.io/en/latest/

    Requirements: setuptools>=0.8, and wheel.

    'pip wheel' uses the bdist_wheel setuptools extension from the wheel
    package to build individual wheels.

    z�
      %prog [options] <requirement specifier> ...
      %prog [options] -r <requirements file> ...
      %prog [options] [-e] <vcs project url> ...
      %prog [options] [-e] <local project path> ...
      %prog [options] <archive url/path> ...csztt|�j||�|j}|jddddtjdd�|�t���|�t�	��|�t�
��|jddd	d
dd�|�t���|�t���|�t�
��|�t���|�t���|�t���|�t���|�t���|�t���|�t���|�t���|jd
dd
d	dd�|jddddd�|�t���|�t���t�tj|j�}|j�d|�|j�d|�dS)Nz-wz--wheel-dir�	wheel_dir�dirzLBuild wheels into <dir>, where the default is the current working directory.)�dest�metavar�default�helpz--build-option�
build_options�options�appendz9Extra arguments to be supplied to 'setup.py bdist_wheel'.)rr�actionrz--global-option�global_optionszZExtra global options to be supplied to the setup.py call before the 'bdist_wheel' command.)rrrrz--pre�
store_trueFzYInclude pre-release and development versions. By default, pip only finds stable versions.)rrrr)�superr�__init__�cmd_optsZ
add_option�os�curdirrZ	no_binaryZonly_binaryZ
prefer_binaryZno_build_isolation�
use_pep517Z
no_use_pep517ZconstraintsZeditable�requirements�src�ignore_requires_pythonZno_deps�	build_dirZprogress_bar�no_clean�require_hashesZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrZ
index_opts��	__class__��@/usr/lib/python3.8/site-packages/pip/_internal/commands/wheel.pyr3sh�����zWheelCommand.__init__cCszt�|�|jr tj�|j�|_tj�|j�|_|�|�}|�||�}|j	pP|j}t
|j|j�}t
���}t|j|dd���}t|jd�}	z�z�|�|	|||||�|j||||jd�}
|j|
|||||j|jd�}|�|	�t|
||jp�g|jp�g|j	d�}|�|	j���}
t |
�dk�r"t!d��Wnt"k
�rBd	|_	�YnXW5|j	�s`|	��|��XW5QRXW5QRXdS)
NZwheel)�deleteZkind)r()Ztemp_build_dirr�req_trackerZwheel_download_dir)�preparer�finder�sessionr�wheel_cacher%r")rrr'rz"Failed to build one or more wheelsT)#rZcheck_install_build_globalr&r �path�abspathZsrc_dirZget_default_sessionZ_build_package_finderr'r�	cache_dirZformat_controlr	r
rr(Z
cleanup_filesZcleanupZpopulate_requirement_setZmake_requirement_preparerrZ
make_resolverr%r"ZresolverrrZbuildr#�values�lenrr)r*rr+r5r4Zbuild_deleter6r2Z	directoryZrequirement_setr3Zresolver�wbZbuild_failuresr/r/r0�runqs|

�����	
���zWheelCommand.run)�__name__�
__module__�__qualname__�__doc__Zusagerr=�
__classcell__r/r/r-r0rs>r) Z
__future__rZloggingr Zpip._internal.cacherZpip._internal.clirZpip._internal.cli.req_commandrZpip._internal.exceptionsrrZpip._internal.reqrZpip._internal.req.req_trackerr	Zpip._internal.utils.temp_dirr
Zpip._internal.utils.typingrZpip._internal.wheelrZoptparser
�typingrrZ	getLoggerr>Zloggerrr/r/r/r0�<module>s 
site-packages/pip/_internal/commands/__pycache__/__init__.cpython-38.opt-1.pyc000064400000005444151446176770023217 0ustar00U

��.e��@s:dZddlmZddlZddlmZmZddlmZerPddl	m
Z
ddlmZedd	�Z
ed
e
ddd
�fde
ddd�fde
ddd�fde
ddd�fde
ddd�fde
dd d!�fd"e
d#d$d%�fd&e
d'd(d)�fd*e
d+d,d-�fd.e
d/d0d1�fd2e
d3d4d5�fd6e
d7d8d9�fd:e
d;d<d=�fd>e
d?d@dA�fg�ZdBdC�ZdDdE�ZdS)Fz%
Package containing all pip commands
�)�absolute_importN)�OrderedDict�
namedtuple)�MYPY_CHECK_RUNNING)�Any)�Command�CommandInfoz module_path, class_name, summaryZinstallzpip._internal.commands.installZInstallCommandzInstall packages.Zdownloadzpip._internal.commands.downloadZDownloadCommandzDownload packages.Z	uninstallz pip._internal.commands.uninstallZUninstallCommandzUninstall packages.Zfreezezpip._internal.commands.freezeZ
FreezeCommandz1Output installed packages in requirements format.�listzpip._internal.commands.listZListCommandzList installed packages.Zshowzpip._internal.commands.showZShowCommandz*Show information about installed packages.Zcheckzpip._internal.commands.checkZCheckCommandz7Verify installed packages have compatible dependencies.Zconfigz$pip._internal.commands.configurationZConfigurationCommandz&Manage local and global configuration.�searchzpip._internal.commands.searchZ
SearchCommandzSearch PyPI for packages.Zwheelzpip._internal.commands.wheelZWheelCommandz$Build wheels from your requirements.�hashzpip._internal.commands.hashZHashCommandz#Compute hashes of package archives.Z
completionz!pip._internal.commands.completionZCompletionCommandz-A helper command used for command completion.�debugzpip._internal.commands.debugZDebugCommandz&Show information useful for debugging.�helpzpip._internal.commands.helpZHelpCommandzShow help for commands.cKs:t|\}}}t�|�}t||�}|f||d�|��}|S)zF
    Create an instance of the Command class with the given name.
    )�name�summary)�
commands_dict�	importlib�
import_module�getattr)r�kwargsZmodule_path�
class_namer�moduleZ
command_classZcommand�r�C/usr/lib/python3.8/site-packages/pip/_internal/commands/__init__.py�create_commandZs


rcCs6ddlm}|��}||t���}|r.|dSdSdS)zCommand name auto-correct.r)�get_close_matchesFN)Zdifflibr�lowerr�keys)rrZclose_commandsrrr�get_similar_commandsgsr)�__doc__Z
__future__rr�collectionsrrZpip._internal.utils.typingr�typingrZpip._internal.cli.base_commandrrrrrrrrr�<module>s�

���������������<
site-packages/pip/_internal/commands/__pycache__/uninstall.cpython-38.pyc000064400000005206151446176770022526 0ustar00U

��.e��@svddlmZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZGd	d
�d
ee�ZdS)�)�absolute_import)�canonicalize_name)�Command)�SessionCommandMixin)�InstallationError)�parse_requirements)�install_req_from_line)�(protect_pip_from_modification_on_windowscs,eZdZdZdZ�fdd�Zdd�Z�ZS)�UninstallCommandaB
    Uninstall packages.

    pip is able to uninstall most installed packages. Known exceptions are:

    - Pure distutils packages installed with ``python setup.py install``, which
      leave behind no metadata to determine what files were installed.
    - Script wrappers installed by ``python setup.py develop``.
    zU
      %prog [options] <package> ...
      %prog [options] -r <requirements file> ...c	sVtt|�j||�|jjddddgddd�|jjdd	d
ddd
�|j�d|j�dS)Nz-rz
--requirement�requirements�append�filezjUninstall all the packages listed in the given requirements file.  This option can be used multiple times.)�dest�action�default�metavar�helpz-yz--yes�yes�
store_truez2Don't ask for confirmation of uninstall deletions.)rrrr)�superr
�__init__Zcmd_optsZ
add_option�parserZinsert_option_group)�self�args�kw��	__class__��D/usr/lib/python3.8/site-packages/pip/_internal/commands/uninstall.pyrs$�	�zUninstallCommand.__init__c	Cs�|�|�}i}|D]&}t||jd�}|jr||t|j�<q|jD],}t|||d�D]}|jrR||t|j�<qRq@|s�tdt|jd���t	d|kd�|�
�D]&}|j|j|j
dkd�}|r�|��q�dS)	N)�isolated)�options�sessionzLYou must give at least one requirement to %(name)s (see "pip help %(name)s"))�nameZpip)Z
modifying_pipr)Zauto_confirm�verbose)Zget_default_sessionrZ
isolated_moder"rrrr�dictr	�valuesZ	uninstallr�	verbosityZcommit)	rr rr!Zreqs_to_uninstallr"Zreq�filenameZuninstall_pathsetrrr�run2sB
�
�

����zUninstallCommand.run)�__name__�
__module__�__qualname__�__doc__Zusagerr(�
__classcell__rrrrr
s
r
N)Z
__future__rZpip._vendor.packaging.utilsrZpip._internal.cli.base_commandrZpip._internal.cli.req_commandrZpip._internal.exceptionsrZpip._internal.reqrZpip._internal.req.constructorsrZpip._internal.utils.miscr	r
rrrr�<module>ssite-packages/pip/_internal/commands/__pycache__/hash.cpython-38.opt-1.pyc000064400000003706151446176770022402 0ustar00U

��.e��@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Z
mZddlm
Z
mZe�e�ZGdd�de�Zd	d
�ZdS)�)�absolute_importN)�Command)�ERROR)�
FAVORITE_HASH�
STRONG_HASHES)�read_chunks�write_outputcs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�HashCommandz�
    Compute a hash of a local package archive.

    These can be used with --hash in a requirements file to do repeatable
    installs.
    z%prog [options] <file> ...TcsJtt|�j||�|jjdddtdtdd�t�d�|j�	d|j�dS)	Nz-az--algorithm�	algorithmZstorez$The hash algorithm to use: one of %sz, )�dest�choices�action�default�helpr)
�superr	�__init__Zcmd_optsZ
add_optionrr�join�parserZinsert_option_group)�self�args�kw��	__class__��?/usr/lib/python3.8/site-packages/pip/_internal/commands/hash.pyrs��zHashCommand.__init__cCs>|s|j�tj�tS|j}|D]}td||t||��q dS)Nz%s:
--hash=%s:%s)rZprint_usage�sys�stderrrr
r�
_hash_of_file)rZoptionsrr
�pathrrr�run)s�zHashCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrr�
__classcell__rrrrr	s
r	c	Cs@t|d��(}t�|�}t|�D]}|�|�qW5QRX|��S)z!Return the hash digest of a file.�rb)�open�hashlib�newr�updateZ	hexdigest)rr
�archive�hash�chunkrrrr4s

r)Z
__future__rr'ZloggingrZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrZpip._internal.utils.hashesrrZpip._internal.utils.miscrrZ	getLoggerr Zloggerr	rrrrr�<module>s
"site-packages/pip/_internal/commands/__pycache__/completion.cpython-38.opt-1.pyc000064400000005705151446176770023631 0ustar00U

��.e��@sXddlmZddlZddlZddlmZddlmZdZdddd	�Z	Gd
d�de�Z
dS)�)�absolute_importN)�Command)�get_progzJ
# pip %(shell)s completion start%(script)s# pip %(shell)s completion end
a
        _pip_completion()
        {
            COMPREPLY=( $( COMP_WORDS="${COMP_WORDS[*]}" \
                           COMP_CWORD=$COMP_CWORD \
                           PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) )
        }
        complete -o default -F _pip_completion %(prog)s
    aM
        function _pip_completion {
          local words cword
          read -Ac words
          read -cn cword
          reply=( $( COMP_WORDS="$words[*]" \
                     COMP_CWORD=$(( cword-1 )) \
                     PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null ))
        }
        compctl -K _pip_completion %(prog)s
    aw
        function __fish_complete_pip
            set -lx COMP_WORDS (commandline -o) ""
            set -lx COMP_CWORD ( \
                math (contains -i -- (commandline -t) $COMP_WORDS)-1 \
            )
            set -lx PIP_AUTO_COMPLETE 1
            string split \  -- (eval $COMP_WORDS[1])
        end
        complete -fa "(__fish_complete_pip)" -c %(prog)s
    )�bash�zsh�fishcs,eZdZdZdZ�fdd�Zdd�Z�ZS)�CompletionCommandz3A helper command to be used for command completion.Tcsltt|�j||�|j}|jddddddd�|jdd	dd
ddd�|jdd
ddddd�|j�d|�dS)Nz--bashz-b�store_constr�shellzEmit completion code for bash)�action�const�dest�helpz--zshz-zrzEmit completion code for zshz--fishz-frzEmit completion code for fishr)�superr�__init__�cmd_optsZ
add_option�parserZinsert_option_group)�self�args�kwr��	__class__��E/usr/lib/python3.8/site-packages/pip/_internal/commands/completion.pyr8s6���zCompletionCommand.__init__cCsrt��}dd�t|�D�}|j|krXt�t�|jd�dt�i�}tt	||jd��nt
j�dd�
|��dS)	z-Prints the completion code of the given shellcSsg|]}d|�qS)z--r)�.0r
rrr�
<listcomp>Usz)CompletionCommand.run.<locals>.<listcomp>��prog)�scriptr
zERROR: You must pass %s
z or N)�COMPLETION_SCRIPTS�keys�sortedr
�textwrap�dedent�getr�print�BASE_COMPLETION�sys�stderr�write�join)rZoptionsrZshellsZ
shell_optionsrrrr�runRs
���zCompletionCommand.run)�__name__�
__module__�__qualname__�__doc__Zignore_require_venvrr+�
__classcell__rrrrr3sr)Z
__future__rr'r"Zpip._internal.cli.base_commandrZpip._internal.utils.miscrr&rrrrrr�<module>s	�#site-packages/pip/_internal/commands/__pycache__/configuration.cpython-38.opt-1.pyc000064400000014657151446176770024335 0ustar00U

��.e:�@s�ddlZddlZddlZddlmZddlmZmZddlm	Z	m
Z
mZddlm
Z
ddlmZmZe�e�ZGdd�de�ZdS)	�N)�Command)�ERROR�SUCCESS)�
Configuration�get_configuration_files�kinds)�PipError)�get_prog�write_outputcsxeZdZdZdZdZ�fdd�Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Z�ZS)�ConfigurationCommanda9Manage local and global configuration.

        Subcommands:

        list: List the active configuration (or from the file specified)
        edit: Edit the configuration file in an editor
        get: Get the value associated with name
        set: Set the name=value
        unset: Unset the value associated with name

        If none of --user, --global and --site are passed, a virtual
        environment configuration file is used if one is active and the file
        exists. Otherwise, all modifications happen on the to the user file by
        default.
    Tz�
        %prog [<file-option>] list
        %prog [<file-option>] [--editor <editor-path>] edit

        %prog [<file-option>] get name
        %prog [<file-option>] set name value
        %prog [<file-option>] unset name
    cs�tt|�j||�d|_|jjdddddd�|jjdddd	d
d�|jjdddd	d
d�|jjdddd	dd�|j�d|j�dS)Nz--editor�editorZstorez\Editor to use to edit the file. Uses VISUAL or EDITOR environment variables if not provided.)�dest�action�default�helpz--global�global_file�
store_trueFz+Use the system-wide configuration file onlyz--user�	user_filez$Use the user configuration file onlyz--site�	site_filez3Use the current environment configuration file onlyr)�superr�__init__�
configurationZcmd_optsZ
add_option�parserZinsert_option_group)�self�args�kwargs��	__class__��H/usr/lib/python3.8/site-packages/pip/_internal/commands/configuration.pyr0s>����zConfigurationCommand.__init__c
Cs|j|j|j|j|jd�}|r*|d|krHt�d�d�t	|����t
S|d}z|j||dkd�}Wn:tk
r�}zt�|j
d�t
WY�Sd}~XYnXt|j|d�|_|j��z||||dd��Wn<tk
�r}zt�|j
d�t
WY�Sd}~XYnXtS)	N)�list�edit�get�set�unsetrzNeed an action ({}) to perform.z, )r"r#r$r!)�
need_value)�isolated�	load_only�)�list_values�open_in_editor�get_name�set_name_value�
unset_name�logger�error�format�join�sortedr�_determine_filerrrZ
isolated_moder�loadr)r�optionsrZhandlersrr'�errr�runZs>�	��
�
zConfigurationCommand.runcCs�dd�tj|jftj|jftj|jffD�}|s`|s8dStdd�t�tjD��rXtjStjSnt	|�dkrt|dSt
d��dS)NcSsg|]\}}|r|�qSrr)�.0�key�valuerrr�
<listcomp>�s�z8ConfigurationCommand._determine_file.<locals>.<listcomp>css|]}tj�|�VqdS)N)�os�path�exists)r8Zsite_config_filerrr�	<genexpr>�s�z7ConfigurationCommand._determine_file.<locals>.<genexpr>r(rzLNeed exactly one file to operate upon (--user, --site, --global) to perform.)rZUSERrZGLOBALrZSITEr�anyr�lenr)rr5r%Zfile_optionsrrrr3�s$


�
��z$ConfigurationCommand._determine_filecCs8|j|ddd�t|j���D]\}}td||�qdS)Nr r��nz%s=%r)�_get_n_argsr2r�itemsr
�rr5rr9r:rrrr)�sz ConfigurationCommand.list_valuescCs*|j|ddd�}|j�|�}td|�dS)Nz
get [name]r(rBz%s)rDrZ	get_valuer
rFrrrr+�szConfigurationCommand.get_namecCs.|j|ddd�\}}|j�||�|��dS)Nzset [name] [value]�rB)rDrZ	set_value�_save_configurationrFrrrr,�sz#ConfigurationCommand.set_name_valuecCs(|j|ddd�}|j�|�|��dS)Nzunset [name]r(rB)rDrZunset_valuerH)rr5rr9rrrr-�szConfigurationCommand.unset_namec
Csp|�|�}|j��}|dkr$td��zt�||g�Wn4tjk
rj}ztd�|j���W5d}~XYnXdS)Nz%Could not determine appropriate file.z*Editor Subprocess exited with exit code {})	�_determine_editorrZget_file_to_editr�
subprocessZ
check_callZCalledProcessErrorr0�
returncode)rr5rrZfnamer6rrrr*�s

��z#ConfigurationCommand.open_in_editorcCs<t|�|kr$d�|t�|�}t|��|dkr4|dS|SdS)zJHelper to make sure the command got the right number of arguments
        zJGot unexpected number of arguments, expected {}. (example: "{} config {}")r(rN)rAr0r	r)rrZexamplerC�msgrrrrD�s��z ConfigurationCommand._get_n_argscCs>z|j��Wn*tk
r8tjddd�td��YnXdS)Nz:Unable to save configuration. Please report this as a bug.r()�exc_infozInternal Error.)rZsave�	Exceptionr.r/r)rrrrrH�s�z(ConfigurationCommand._save_configurationcCsD|jdk	r|jSdtjkr$tjdSdtjkr8tjdStd��dS)NZVISUALZEDITORz"Could not determine editor to use.)rr<�environr)rr5rrrrI�s




z&ConfigurationCommand._determine_editor)�__name__�
__module__�__qualname__�__doc__Zignore_require_venvZusagerr7r3r)r+r,r-r*rDrHrI�
__classcell__rrrrrs	*+r)Zloggingr<rJZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrrZpip._internal.configurationrrrZpip._internal.exceptionsrZpip._internal.utils.miscr	r
Z	getLoggerrPr.rrrrr�<module>s
site-packages/pip/_internal/commands/__pycache__/install.cpython-38.opt-1.pyc000064400000034172151446176770023126 0ustar00U

��.e�_�@s�ddlmZddlZddlZddlZddlZddlZddlZddlmZddl	m
Z
ddlmZddl
mZddlmZddlmZdd	lmZdd
lmZddlmZmZddlmZmZmZdd
lmZddl m!Z!ddl"m#Z#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5e1�r�ddl	m6Z6ddl7m8Z8m9Z9m:Z:ddl;m<Z<ddl=m>Z>ddl4m?Z?e�@eA�ZBdd�ZCdd�ZDd d!�ZEGd"d#�d#e�ZFd$d%�ZGd&d'�ZHdS)(�)�absolute_importN)�path)�
SUPPRESS_HELP)�
pkg_resources)�canonicalize_name)�
WheelCache)�
cmdoptions)�make_target_python)�RequirementCommand)�ERROR�SUCCESS)�CommandError�InstallationError�PreviousBuildDirError��distutils_scheme)�check_install_conflicts)�RequirementSet�install_given_reqs)�RequirementTracker)�check_path_owner)�
ensure_dir�get_installed_version�(protect_pip_from_modification_on_windows�write_output)�
TempDirectory)�MYPY_CHECK_RUNNING)�virtualenv_no_global)�WheelBuilder)�Values)�Any�List�Optional)�
FormatControl)�InstallRequirement)�BinaryAllowedPredicatecCs(zddl}Wntk
r"YdSXdS)z8
    Return whether the wheel package is installed.
    rNFT)�wheel�ImportError)r&�r(�B/usr/lib/python3.8/site-packages/pip/_internal/commands/install.py�is_wheel_installed<s
r*cCs*t�}|j|dd�}|r&|j|dd�|S)zQ
    Build wheels for requirements, depending on whether wheel is installed.
    T)Z
should_unpack)r*Zbuild)�builder�pep517_requirements�legacy_requirementsZshould_build_legacy�build_failuresr(r(r)�build_wheelsHs
��r/cs�fdd�}|S)Ncs&|jr
dSt|j�}��|�}d|kS)NTZbinary)�
use_pep517r�nameZget_allowed_formats)�reqZcanonical_nameZallowed_formats��format_controlr(r)�check_binary_allowedhs


z6get_check_binary_allowed.<locals>.check_binary_allowedr()r4r5r(r3r)�get_check_binary_allowedfsr6cs<eZdZdZdZ�fdd�Zdd�Zdd�Zd	d
�Z�Z	S)�InstallCommandaI
    Install packages from:

    - PyPI (and other indexes) using requirement specifiers.
    - VCS project urls.
    - Local project directories.
    - Local or remote source archives.

    pip also supports installing from "requirements files", which provide
    an easy way to specify a whole environment to be installed.
    a%
      %prog [options] <requirement specifier> [package-index-options] ...
      %prog [options] -r <requirements file> [package-index-options] ...
      %prog [options] [-e] <vcs project url> ...
      %prog [options] [-e] <local project path> ...
      %prog [options] <archive url/path> ...cs^tt|�j||�|j}|�t���|�t���|�t���|�t�	��|�t�
��|jddddddd�t�|�|jddd	d
d�|jddd
td�|jdddddd�|jdddddd�|�t�
��|�t���|jdddd	dd�|jdddddgdd�|jddd	d d�|jd!d"d#d	d$d�|�t���|�t���|�t���|�t���|�t���|�t���|jd%d	d&d'd(d)�|jd*d
d&d+d,�|jd-d
d.d'd/d)�|jd0d
d1d'd2d)�|�t���|�t���|�t���|�t���|�t���|�t���t�tj|j�}|j�d3|�|j�d3|�dS)4Nz-tz--target�
target_dir�dirz�Install packages into <dir>. By default this will not replace existing files/folders in <dir>. Use --upgrade to replace existing packages in <dir> with new versions.)�dest�metavar�default�help�--user�
use_user_site�
store_truez�Install to the Python user install directory for your platform. Typically ~/.local/, or %APPDATA%\Python on Windows. (See the Python documentation for site.USER_BASE for full details.))r:�actionr=z	--no-userZstore_falsez--root�	root_pathz=Install everything relative to this alternate root directory.z--prefix�prefix_pathzIInstallation prefix where lib, bin and other top-level folders are placedz-Uz	--upgrade�upgradez�Upgrade all specified packages to the newest available version. The handling of dependencies depends on the upgrade-strategy used.z--upgrade-strategy�upgrade_strategyzonly-if-neededZeageraGDetermines how dependency upgrading should be handled [default: %default]. "eager" - dependencies are upgraded regardless of whether the currently installed version satisfies the requirements of the upgraded package(s). "only-if-needed" -  are upgraded only when they do not satisfy the requirements of the upgraded package(s).)r:r<�choicesr=z--force-reinstall�force_reinstallz;Reinstall all packages even if they are already up-to-date.z-Iz--ignore-installed�ignore_installedz�Ignore the installed packages, overwriting them. This can break your system if the existing package is of a different version or was installed with a different package manager!z	--compile�compileTz'Compile Python source files to bytecode)rAr:r<r=z--no-compilez.Do not compile Python source files to bytecode)rAr:r=z--no-warn-script-location�warn_script_locationz0Do not warn when installing scripts outside PATHz--no-warn-conflicts�warn_about_conflictsz%Do not warn about broken dependenciesr)�superr7�__init__�cmd_optsZ
add_optionr�requirementsZconstraintsZno_depsZpreZeditableZadd_target_python_optionsr�	build_dir�src�ignore_requires_pythonZno_build_isolationr0Z
no_use_pep517�install_options�global_optionsZ	no_binaryZonly_binaryZ
prefer_binary�no_clean�require_hashesZprogress_barZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrNZ
index_opts��	__class__r(r)rM�s��

�����	���
�����zInstallCommand.__init__c*Cs�t�|�dd�}t��dkrZ|�sZt�tjd�}|dkrLt�tj�d}t	�
d|�d}|jrj|j}|j
r�tj�|j
�|_
tj|dd	�tj�|j�|_|jp�g}|jr�|jr�td
��t�r�td��|�d�|�d
�d}d}|j�rJd|_tj�|j�|_tj�|j��r,tj�|j��s,td��tdd�}|j}|�d|�|j�pTg}	|�|�}
t|�}|j ||
||j!d�}|j"�p�|j
}
t#|j$|j%�}|j$�r�t&|j$��s�t	�
d|j$�d|_$t'���}t|j
|
dd����}t(|j)|jd�}�z��z*|�,|||||
|�|j-|||d�}|j.|||
|||j|j|j!|j/||j0d�}|�1|�z|�2d�}Wnt3k
�rzd}YnX|j4dk}t5|d�t6|j%�}g}g}|j7�8�D]$}|j0�r�|�|�n
|�|��q�t9||gg|d�}t:|||d�}|�rtd�;d�<dd �|D�����|�=|�}|j>�o.|j?}|�r@|�@|�|jA}|j�rRd!}tB|||	|jC||j|jD||jd"�	}tE|j||jC|j|jFd#�} tG�H| �}!tI|tJ�Kd$�d%�}"g}#|"D]R}|jL}$z$tM|jL|!d&�}%|%�r�|$d'|%7}$WntNk
�r�YnX|#�|$��q�d(�<|#�}&|&�r tOd)|&�Wn�tPk
�r�}'zN|jQd*k}(tR|'|(|j�})t	jS|)|(d+�tTWY�W�HW5QR�W5QR�Sd}'~'XYntUk
�r�d|_"�YnXW5|j"�s�|�*�|�+�XW5QRXW5QRX|j�r�|�V|j||j�tWS),NcSs ttd�pttd�otjtjkS)NZreal_prefix�base_prefix)�hasattr�sysr]�prefixr(r(r(r)�is_venvs


�z#InstallCommand.run.<locals>.is_venvrz__main__.pyz -m pipzgRunning pip install with root privileges is generally not a good idea. Try `%s install --user` instead.zto-satisfy-onlyT)Zcheck_targetzVCan not combine '--user' and '--prefix' as they imply different installation locationszZCan not perform a '--user' install. User site-packages are not visible in this virtualenv.r>z	--prefix=z=Target path exists but is not a directory, will not continue.�target)�kindz--home=)�options�session�
target_pythonrRz�The directory '%s' or its parent directory is not owned by the current user and caching wheels has been disabled. check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.Zinstall)�deleterc)rVZcheck_supported_wheels)Ztemp_build_dirrd�req_tracker)�preparer�finderrerd�wheel_cacher?rHrRrGrEr0Zpip)�
modifying_pip)Z
build_optionsrTr5)r+r,r-zPCould not build wheels for {} which use PEP 517 and cannot be installed directlyz, css|]}|jVqdS�N)r1)�.0�rr(r(r)�	<genexpr>�sz%InstallCommand.run.<locals>.<genexpr>F)�root�homer`Z	pycompilerJr?)�userrrrqr`�isolatedr1)�key)�working_set�-� zSuccessfully installed %s���exc_info)XrZcheck_install_build_global�os�getuidr�basenamer_�argv�
executable�logger�warningrDrErP�abspathZcheck_dist_restrictionZsrc_dirrSr?rCr
rr�appendr8rH�exists�isdirrrTZget_default_sessionr	Z_build_package_finderrRrUr�	cache_dirr4rrrrVZ
cleanup_filesZcleanupZpopulate_requirement_setZmake_requirement_preparerZ
make_resolverrGr0ZresolveZget_requirement�KeyErrorZsatisfied_byrr6rO�valuesrr/�format�joinZget_installation_orderZignore_dependenciesrK�_warn_about_conflictsrJrrBrI�get_lib_location_guessesZ
isolated_moderZ
WorkingSet�sorted�operator�
attrgetterr1r�	Exceptionr�EnvironmentError�	verbosity�create_env_error_message�errorrr�_handle_target_dirr)*rXrdrYraZcommandrErS�target_temp_dirZtarget_temp_dir_pathrTrerfrjZbuild_deleterkrhZ	directoryZrequirement_setriZresolverZpip_reqrlr5r-r,r2Z
wheel_builderr.�
to_installZshould_warn_about_conflictsrJZ	installedZ
lib_locationsrvZreqs�items�itemZinstalled_versionZinstalled_descr��show_traceback�messager(r(r)�runs�
��
��

��

�������


�������
�
��
�
�
�4�zInstallCommand.runc	sft|�g}|��Jtd|jd�}|d}|d}|d}tj�|�rP|�|�tj�|�rn||krn|�|�tj�|�r�|�|�|D]�}	t�|	�D]�}
|	|kr�tj�||
��t�fdd�|dd�D��r�q�tj�||
�}tj�|��r>|s�t	�
d	|�q�tj�|��rt	�
d
|�q�tj�|��r4t
�|�n
t�|�t
�tj�|	|
�|�q�q�W5QRXdS)N�)rr�purelib�platlib�datac3s|]}|���VqdSrm)�
startswith)rn�s��ddirr(r)rp+sz4InstallCommand._handle_target_dir.<locals>.<genexpr>���zKTarget directory %s already exists. Specify --upgrade to force replacement.z�Target directory %s already exists and is a link. Pip will not automatically replace links, please remove if replacement is desired.)rrrr|r�r��listdirr��anyr�r��islinkr��shutilZrmtree�removeZmove)rXr8r�rDZlib_dir_list�schemeZpurelib_dirZplatlib_dirZdata_dirZlib_dirr�Ztarget_item_dirr(r�r)r�sP


��
�z!InstallCommand._handle_target_dirc
Cs�zt|�\}}Wn$tk
r4tjddd�YdSX|\}}|D]2}||d}||D]}t�d|||d�qZqB|D]8}||d}||D]\}	}
}t�d||||	|
�q�qzdS)NzError checking for conflicts.Trzrz*%s %s requires %s, which is not installed.ryzF%s %s has requirement %s, but you'll have %s %s which is incompatible.)rr�r�r�Zcritical)rXr�Zpackage_setZ	_dep_infoZmissingZconflictingZproject_name�versionZ
dependencyZdep_nameZdep_versionr2r(r(r)r�Is4��z$InstallCommand._warn_about_conflicts)
�__name__�
__module__�__qualname__�__doc__ZusagerMr�r�r��
__classcell__r(r(r[r)r7ssw8r7cOstd|�|�}|d|dgS)Nr�r�r�)r�r)rY�kwargsr�r(r(r)r�dsr�cCs�g}|�d�|s,|�d�|�t|��n
|�d�|dd7<|jtjkr�d}d}|st|�|d|��g�n
|�|�|�d	�d
�|���dS)z{Format an error message for an EnvironmentError

    It may occur anytime during the execution of the install command.
    z5Could not install packages due to an EnvironmentErrorz: �.r��
z"Consider using the `--user` optionzCheck the permissionsz or z.
r�)r��str�errnoZEACCES�extend�lowerr��strip)r�r�Zusing_user_site�partsZuser_option_partZpermissions_partr(r(r)r�is&


�

r�)IZ
__future__rr�Zloggingr�r|r�r_rZoptparserZpip._vendorrZpip._vendor.packaging.utilsrZpip._internal.cacherZpip._internal.clirZpip._internal.cli.cmdoptionsr	Zpip._internal.cli.req_commandr
Zpip._internal.cli.status_codesrrZpip._internal.exceptionsr
rrZpip._internal.locationsrZpip._internal.operations.checkrZpip._internal.reqrrZpip._internal.req.req_trackerrZpip._internal.utils.filesystemrZpip._internal.utils.miscrrrrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.virtualenvrZpip._internal.wheelrr�typingr r!r"Z#pip._internal.models.format_controlr#Zpip._internal.req.req_installr$r%Z	getLoggerr�r�r*r/r6r7r�r�r(r(r(r)�<module>sT

tsite-packages/pip/_internal/commands/__pycache__/search.cpython-38.pyc000064400000010604151446176770021760 0ustar00U

��.e�@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Zddlm
Z
ddlmZddlmZdd	lmZmZdd
lmZddlmZddlmZdd
lmZddlmZddlm Z e�!e"�Z#Gdd�dee�Z$dd�Z%ddd�Z&dd�Z'dS)�)�absolute_importN)�OrderedDict)�
pkg_resources)�parse)�
xmlrpc_client)�Command)�SessionCommandMixin)�NO_MATCHES_FOUND�SUCCESS)�CommandError)�PyPI)�PipXmlrpcTransport)�get_terminal_size)�
indent_log)�write_outputcs8eZdZdZdZdZ�fdd�Zdd�Zdd	�Z�Z	S)
�
SearchCommandz@Search for PyPI packages whose name or summary contains <query>.z
      %prog [options] <query>Tcs@tt|�j||�|jjddddtjdd�|j�d|j�dS)Nz-iz--index�indexZURLz3Base URL of Python Package Index (default %default))�dest�metavar�default�helpr)	�superr�__init__Zcmd_optsZ
add_optionrZpypi_url�parserZinsert_option_group)�self�args�kw��	__class__��A/usr/lib/python3.8/site-packages/pip/_internal/commands/search.pyr%s�zSearchCommand.__init__cCsT|std��|}|�||�}t|�}d}tj��r<t�d}t||d�|rPtSt	S)Nz)Missing required argument (search query).r)�terminal_width)
r�search�transform_hits�sys�stdout�isattyr�
print_resultsr
r	)r�optionsr�queryZ	pypi_hits�hitsr!rrr �run0s

zSearchCommand.runcCs<|j}|�|�}t||�}t�||�}|�||d�d�}|S)N)�name�summary�or)rZget_default_sessionr
rZServerProxyr")rr)r(Z	index_urlZsessionZ	transportZpypir*rrr r"@s

zSearchCommand.search)
�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrr+r"�
__classcell__rrrr rsrcCs�t�}|D]n}|d}|d}|d}||��krF|||gd�||<q
||d�|�|t||d�kr
|||d<q
t|���S)z�
    The list from pypi is really a list of versions. We want a list of
    packages with the list of versions stored inline. This converts the
    list from pypi into one we can use.
    r,r-�version)r,r-�versionsr5)r�keys�append�highest_version�list�values)r*Zpackages�hitr,r-r4rrr r#Ks�r#c
CsP|sdS|dkr&tdd�|D��d}dd�tjD�}|D�]}|d}|dpRd}t|�dd	g��}|dk	r�||d
}|dkr�t�||�}dd
|d�|�}d|d||f|f}	zxt|	�||k�r0t�	|�}
t
��L|
j|kr�td|
j�n.td|
j�t|�j
�rtd|�n
td|�W5QRXWq:tk
�rHYq:Xq:dS)Nc	Ss.g|]&}t|d�tt|�ddg����qS)r,r5�-)�lenr8�get)�.0r;rrr �
<listcomp>ks�z!print_results.<locals>.<listcomp>�cSsg|]
}|j�qSr)Zproject_name)r?�prrr r@psr,r-�r5r<��
�
� �z	%-*s - %sz%s (%s)zINSTALLED: %s (latest)z
INSTALLED: %sz=LATEST:    %s (pre-release; install with "pip install --pre")z
LATEST:    %s)�maxrZworking_setr8r>�textwrapZwrap�joinrZget_distributionrr4�
parse_versionZpre�UnicodeEncodeError)r*Zname_column_widthr!Zinstalled_packagesr;r,r-ZlatestZtarget_width�lineZdistrrr r'gsJ��

�


�r'cCst|td�S)N)�key)rIrL)r5rrr r8�sr8)NN)(Z
__future__rZloggingr$rJ�collectionsrZpip._vendorrZpip._vendor.packaging.versionrrLZpip._vendor.six.movesrZpip._internal.cli.base_commandrZpip._internal.cli.req_commandrZpip._internal.cli.status_codesr	r
Zpip._internal.exceptionsrZpip._internal.models.indexrZpip._internal.network.xmlrpcr
Zpip._internal.utils.compatrZpip._internal.utils.loggingrZpip._internal.utils.miscrZ	getLoggerr/Zloggerrr#r'r8rrrr �<module>s*
-
)site-packages/pip/_internal/commands/__pycache__/freeze.cpython-38.opt-1.pyc000064400000005540151446176770022735 0ustar00U

��.e�
�@s|ddlmZddlZddlmZddlmZddlmZddl	m
Z
ddlmZddl
mZd	d
ddhZGd
d�de�ZdS)�)�absolute_importN)�
WheelCache)�
cmdoptions)�Command)�
FormatControl)�freeze)�stdlib_pkgsZpipZ
setuptoolsZ
distributeZwheelcs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�
FreezeCommandzx
    Output installed packages in requirements format.

    packages are listed in a case-insensitive sorted order.
    z
      %prog [options])�ext://sys.stderrr
c	s�tt|�j||�|jjddddgddd�|jjdd	d
dgddd�|jjd
dddddd�|jjdddddd�|j�t���|jjddddd�t�d�|jjddddd�|j	�
d|j�dS) Nz-rz
--requirement�requirements�append�filez}Use the order in the given requirements file and its comments when generating output. This option can be used multiple times.)�dest�action�default�metavar�helpz-fz--find-links�
find_linksZURLz<URL for finding packages, which will be added to the output.z-lz--local�local�
store_trueFzUIf in a virtualenv that has global access, do not output globally-installed packages.)rrrrz--user�userz,Only output packages installed in user-site.z--all�
freeze_allz,Do not skip these packages in the output: %sz, )rrrz--exclude-editable�exclude_editablez%Exclude editable package from output.r)�superr	�__init__Zcmd_optsZ
add_optionrZ	list_path�join�DEV_PKGS�parserZinsert_option_group)�self�args�kw��	__class__��A/usr/lib/python3.8/site-packages/pip/_internal/commands/freeze.pyrsd�	������zFreezeCommand.__init__cCs�tt�t��}t|j|�}tt�}|js2|�t�t�	|�t
|j|j|j
|j|j|j|j|||jd�
}z$tf|�D]}tj�|d�qtW5|��XdS)N)
ZrequirementrZ
local_onlyZ	user_only�pathsZ
skip_regex�isolated�wheel_cache�skipr�
)r�setr�	cache_dirrr�updaterrZcheck_list_path_option�dictrrrr�pathZskip_requirements_regexZ
isolated_moderZcleanupr�sys�stdout�write)rZoptionsrZformat_controlr'r(Z
freeze_kwargs�liner#r#r$�runMs,

�
zFreezeCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZlog_streamsrr3�
__classcell__r#r#r!r$r	s
0r	)Z
__future__rr/Zpip._internal.cacherZpip._internal.clirZpip._internal.cli.base_commandrZ#pip._internal.models.format_controlrZpip._internal.operations.freezerZpip._internal.utils.compatrrr	r#r#r#r$�<module>ssite-packages/pip/_internal/commands/__pycache__/download.cpython-38.opt-1.pyc000064400000010314151446176770023257 0ustar00U

��.e��@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZdd	lmZmZmZdd
lmZe�e�ZGdd�de	�ZdS)
�)�absolute_importN)�
cmdoptions)�make_target_python)�RequirementCommand)�RequirementSet)�RequirementTracker)�check_path_owner)�
ensure_dir�normalize_path�write_output)�
TempDirectorycs,eZdZdZdZ�fdd�Zdd�Z�ZS)�DownloadCommandaL
    Download packages from:

    - PyPI (and other indexes) using requirement specifiers.
    - VCS project urls.
    - Local project directories.
    - Local or remote source archives.

    pip also supports downloading from "requirements files", which provide
    an easy way to specify a whole environment to be downloaded.
    a
      %prog [options] <requirement specifier> [package-index-options] ...
      %prog [options] -r <requirements file> [package-index-options] ...
      %prog [options] <vcs project url> ...
      %prog [options] <local project path> ...
      %prog [options] <archive url/path> ...c
sNtt|�j||�|j}|�t���|�t���|�t���|�t�	��|�t�
��|�t���|�t���|�t�
��|�t���|�t���|�t���|�t���|�t���|�t���|�t���|�t���|jddddddtjdd�t�|�t�tj|j�}|j�d	|�|j�d	|�dS)
Nz-dz--destz--destination-dirz--destination-directory�download_dir�dirzDownload packages into <dir>.)�dest�metavar�default�helpr)�superr
�__init__�cmd_optsZ
add_optionrZconstraintsZrequirements�	build_dirZno_depsZglobal_optionsZ	no_binaryZonly_binaryZ
prefer_binary�srcZpre�no_clean�require_hashesZprogress_barZno_build_isolationZ
use_pep517Z
no_use_pep517�os�curdirZadd_target_python_optionsZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrZ
index_opts��	__class__��C/usr/lib/python3.8/site-packages/pip/_internal/commands/download.pyr)sF�
�zDownloadCommand.__init__c

CsLd|_g|_t�|�tj�|j�|_t|j	�|_	t
|j	�|�|�}t|�}|j
|||d�}|jph|j}|jr�t|j�s�t�d|j�d|_t���}t|j|dd���}t|jd�}	|�|	||||d�|j||||j	d�}
|j|
||||jd�}|�|	�d	�d
d�|	jD��}|�r$td|�|j�s4|	� �W5QRXW5QRX|	S)
NT)�options�session�
target_pythonz�The directory '%s' or its parent directory is not owned by the current user and caching wheels has been disabled. check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.Zdownload)�deleteZkind)r)Ztemp_build_dirr%�req_trackerr)�preparer�finderr&r%Zpy_version_info� cSsg|]
}|j�qSr#)�name)�.0Zreqr#r#r$�
<listcomp>�sz'DownloadCommand.run.<locals>.<listcomp>zSuccessfully downloaded %s)!Zignore_installedZ	editablesrZcheck_dist_restrictionr�path�abspathZsrc_dirr
rr	Zget_default_sessionrZ_build_package_finderrr�	cache_dirr�loggerZwarningrrrrZpopulate_requirement_setZmake_requirement_preparerZ
make_resolverZpython_versionZresolve�joinZsuccessfully_downloadedrZ
cleanup_files)
rr%rr&r'r+Zbuild_deleter)Z	directoryZrequirement_setr*ZresolverZ
downloadedr#r#r$�runQsv


��
���	��

�
zDownloadCommand.run)�__name__�
__module__�__qualname__�__doc__Zusagerr5�
__classcell__r#r#r!r$r
s(r
)Z
__future__rZloggingrZpip._internal.clirZpip._internal.cli.cmdoptionsrZpip._internal.cli.req_commandrZpip._internal.reqrZpip._internal.req.req_trackerrZpip._internal.utils.filesystemrZpip._internal.utils.miscr	r
rZpip._internal.utils.temp_dirrZ	getLoggerr6r3r
r#r#r#r$�<module>s
site-packages/pip/_internal/commands/__pycache__/help.cpython-38.pyc000064400000002242151446176770021442 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�absolute_import)�Command)�SUCCESS)�CommandErrorc@s eZdZdZdZdZdd�ZdS)�HelpCommandzShow help for commandsz
      %prog <command>Tc
Cs�ddlm}m}m}z|d}Wntk
r8tYSX||krt||�}d|g}|rf|�d|�td�|���||�}	|	j	�
�tS)Nr)�
commands_dict�create_command�get_similar_commandszunknown command "%s"zmaybe you meant "%s"z - )Zpip._internal.commandsrrr	�
IndexErrorr�appendr�join�parserZ
print_help)
�selfZoptions�argsrrr	Zcmd_nameZguess�msgZcommand�r�?/usr/lib/python3.8/site-packages/pip/_internal/commands/help.py�runs


zHelpCommand.runN)�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrrrrrrsrN)	Z
__future__rZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrZpip._internal.exceptionsrrrrrr�<module>ssite-packages/pip/_internal/commands/__pycache__/list.cpython-38.pyc000064400000021336151446176770021472 0ustar00U

��.e4)�@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZdd	lmZdd
lmZddlmZmZmZddlmZe�e�ZGd
d�de�Zdd�Zdd�Zdd�Z dS)�)�absolute_importN)�six)�zip_longest)�
cmdoptions)�IndexGroupCommand)�CommandError)�
PackageFinder)�SelectionPreferences)�make_link_collector)�dist_is_editable�get_installed_distributions�write_output)�
get_installercsdeZdZdZdZ�fdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
�ZS)�ListCommandzt
    List installed packages, including editables.

    Packages are listed in a case-insensitive sorted order.
    z
      %prog [options]cstt|�j||�|j}|jdddddd�|jddddd	d�|jd
ddddd�|jd
ddddd�|jjdddddd�|�t���|jddddd�|jddddddd�|jddddd �|jd!d"d#d$d �|jd%dd#d&d'd(�t�tj|j	�}|j	�
d)|�|j	�
d)|�dS)*Nz-oz
--outdated�
store_trueFzList outdated packages)�action�default�helpz-uz
--uptodatezList uptodate packagesz-ez
--editablezList editable projects.z-lz--localzSIf in a virtualenv that has global access, do not list globally-installed packages.z--user�userz,Only output packages installed in user-site.)�destrrrz--prezYInclude pre-release and development versions. By default, pip only finds stable versions.z--formatZstore�list_format�columns)r�freeze�jsonzBSelect the output format among: columns (default), freeze, or json)rrr�choicesrz--not-required�not_requiredz>List packages that are not dependencies of installed packages.)rrrz--exclude-editableZstore_false�include_editablez%Exclude editable package from output.z--include-editablez%Include editable package from output.T)rrrrr)�superr�__init__�cmd_optsZ
add_optionrZ	list_pathZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrZ
index_opts��	__class__��?/usr/lib/python3.8/site-packages/pip/_internal/commands/list.pyr&s��������
����zListCommand.__init__cCs(t||d�}td|jd�}tj||d�S)zK
        Create a package finder appropriate to this list command.
        )�optionsF)Zallow_yankedZallow_all_prereleases)�link_collector�selection_prefs)r
r	�prerZcreate)r!r(�sessionr)r*r&r&r'�_build_package_findervs��z!ListCommand._build_package_findercCs�|jr|jrtd��t�|�t|j|j|j|j	|j
d�}|jrL|�||�}|jr`|�
||�}n|jrr|�||�}|�||�dS)Nz5Options --outdated and --uptodate cannot be combined.)Z
local_onlyZ	user_onlyZeditables_onlyZinclude_editables�paths)�outdatedZuptodaterrZcheck_list_path_optionrZlocalrZeditabler�pathr�get_not_required�get_outdated�get_uptodate�output_package_listing)r!r(r"�packagesr&r&r'�run�s&�
�zListCommand.runcCsdd�|�||�D�S)NcSsg|]}|j|jkr|�qSr&��latest_versionZparsed_version��.0�distr&r&r'�
<listcomp>�s�z,ListCommand.get_outdated.<locals>.<listcomp>��iter_packages_latest_infos�r!r5r(r&r&r'r2�s
�zListCommand.get_outdatedcCsdd�|�||�D�S)NcSsg|]}|j|jkr|�qSr&r7r9r&r&r'r<�s�z,ListCommand.get_uptodate.<locals>.<listcomp>r=r?r&r&r'r3�s
�zListCommand.get_uptodatecs:t��|D]}��dd�|��D��q
�fdd�|D�S)Ncss|]}|jVqdS�N��key)r:Zrequirementr&r&r'�	<genexpr>�sz/ListCommand.get_not_required.<locals>.<genexpr>csh|]}|j�kr|�qSr&rA)r:Zpkg�Zdep_keysr&r'�	<setcomp>�s
z/ListCommand.get_not_required.<locals>.<setcomp>)�set�updateZrequires)r!r5r(r;r&rDr'r1�szListCommand.get_not_requiredc	cs�|�|���}|�||�}|D]t}d}|�|j�}|jsDdd�|D�}|j|jd�}|�|�}	|	dkrfq|	j}
|	j	j
rzd}nd}|
|_||_|VqW5QRXdS)N�unknowncSsg|]}|jjs|�qSr&)�versionZ
is_prerelease)r:�	candidater&r&r'r<�s�z:ListCommand.iter_packages_latest_infos.<locals>.<listcomp>)�project_nameZwheelZsdist)
Z_build_sessionr-Zfind_all_candidatesrBr+Zmake_candidate_evaluatorrKZsort_best_candidaterI�linkZis_wheelr8�latest_filetype)r!r5r(r,�finderr;�typZall_candidatesZ	evaluatorZbest_candidateZremote_versionr&r&r'r>�s(�
z&ListCommand.iter_packages_latest_infoscCs�t|dd�d�}|jdkr:|r:t||�\}}|�||�n^|jdkr�|D]4}|jdkrltd|j|j|j�qHtd|j|j�qHn|jd	kr�tt	||��dS)
NcSs
|j��Sr@)rK�lower)r;r&r&r'�<lambda>��z4ListCommand.output_package_listing.<locals>.<lambda>rArr�z%s==%s (%s)z%s==%sr)
�sortedr�format_for_columns�output_package_listing_columns�verboser
rKrI�location�format_for_json)r!r5r(�data�headerr;r&r&r'r4�s"�

�
z"ListCommand.output_package_listingcCsbt|�dkr|�d|�t|�\}}t|�dkrL|�dd�tdd�|���|D]}t|�qPdS)NrrS� cSsd|S)N�-r&)�xr&r&r'rQ�rRz<ListCommand.output_package_listing_columns.<locals>.<lambda>)�len�insert�tabulate�join�mapr
)r!rZr[Zpkg_strings�sizes�valr&r&r'rV�sz*ListCommand.output_package_listing_columns)�__name__�
__module__�__qualname__�__doc__Zusagerr-r6r2r3r1r>r4rV�
__classcell__r&r&r$r'rsPrcCs�t|�dkst�dgtdd�|D��}|D]}dd�t||�D�}q,g}|D](}d�dd�t||�D��}|�|�qN||fS)Nrcss|]}t|�VqdSr@)r_�r:r^r&r&r'rC�sztabulate.<locals>.<genexpr>cSs"g|]\}}t|tt|����qSr&)�maxr_�str�r:�s�cr&r&r'r<�sztabulate.<locals>.<listcomp>r\cSs*g|]"\}}|dk	r"t|��|�nd�qS)N�)rm�ljustrnr&r&r'r<�s�)r_�AssertionErrorrlrrb�append)Zvalsrd�row�resultZdisplayr&r&r'ra�s
�racCs�|j}|rddddg}nddg}g}|jdks@tdd�|D��rJ|�d�|jdkr^|�d	�|D]l}|j|jg}|r�|�|j�|�|j�|jdks�t|�r�|�|j	�|jdkr�|�t
|��|�|�qb||fS)
z_
    Convert the package data into something usable
    by output_package_listing_columns.
    ZPackageZVersionZLatestZTyperScss|]}t|�VqdSr@)rrkr&r&r'rCsz%format_for_columns.<locals>.<genexpr>ZLocationZ	Installer)r/rW�anyrtrKrIr8rMrrXr)Zpkgsr(Zrunning_outdatedr[rZZprojrur&r&r'rUs(



rUcCsvg}|D]b}|jt�|j�d�}|jdkr@|j|d<t|�|d<|jr`t�|j�|d<|j	|d<|�
|�qt�|�S)N)�namerIrSrXZ	installerr8rM)
rKrZ	text_typerIrWrXrr/r8rMrtr�dumps)r5r(rZr;�infor&r&r'rY+s
�


rY)!Z
__future__rrZloggingZpip._vendorrZpip._vendor.six.movesrZpip._internal.clirZpip._internal.cli.req_commandrZpip._internal.exceptionsrZpip._internal.indexrZ$pip._internal.models.selection_prefsr	Z!pip._internal.self_outdated_checkr
Zpip._internal.utils.miscrrr
Zpip._internal.utils.packagingrZ	getLoggerrfZloggerrrarUrYr&r&r&r'�<module>s$
Y%site-packages/pip/_internal/commands/__pycache__/hash.cpython-38.pyc000064400000003706151446176770021443 0ustar00U

��.e��@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Z
mZddlm
Z
mZe�e�ZGdd�de�Zd	d
�ZdS)�)�absolute_importN)�Command)�ERROR)�
FAVORITE_HASH�
STRONG_HASHES)�read_chunks�write_outputcs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�HashCommandz�
    Compute a hash of a local package archive.

    These can be used with --hash in a requirements file to do repeatable
    installs.
    z%prog [options] <file> ...TcsJtt|�j||�|jjdddtdtdd�t�d�|j�	d|j�dS)	Nz-az--algorithm�	algorithmZstorez$The hash algorithm to use: one of %sz, )�dest�choices�action�default�helpr)
�superr	�__init__Zcmd_optsZ
add_optionrr�join�parserZinsert_option_group)�self�args�kw��	__class__��?/usr/lib/python3.8/site-packages/pip/_internal/commands/hash.pyrs��zHashCommand.__init__cCs>|s|j�tj�tS|j}|D]}td||t||��q dS)Nz%s:
--hash=%s:%s)rZprint_usage�sys�stderrrr
r�
_hash_of_file)rZoptionsrr
�pathrrr�run)s�zHashCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrr�
__classcell__rrrrr	s
r	c	Cs@t|d��(}t�|�}t|�D]}|�|�qW5QRX|��S)z!Return the hash digest of a file.�rb)�open�hashlib�newr�updateZ	hexdigest)rr
�archive�hash�chunkrrrr4s

r)Z
__future__rr'ZloggingrZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrZpip._internal.utils.hashesrrZpip._internal.utils.miscrrZ	getLoggerr Zloggerr	rrrrr�<module>s
"site-packages/pip/_internal/commands/__pycache__/show.cpython-38.opt-1.pyc000064400000014265151446176770022441 0ustar00U

��.e��@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
mZddlmZe�e�ZGd	d
�d
e�Zdd�Zddd�ZdS)�)�absolute_importN)�
FeedParser)�
pkg_resources��canonicalize_name)�Command)�ERROR�SUCCESS)�write_outputcs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�ShowCommandzx
    Show information about one or more installed packages.

    The output is in RFC-compliant mail header format.
    z$
      %prog [options] <package> ...Tcs>tt|�j||�|jjddddddd�|j�d|j�dS)	Nz-fz--files�files�
store_trueFz7Show the full list of installed files for each package.)�dest�action�default�helpr)�superr�__init__Zcmd_optsZ
add_option�parserZinsert_option_group)�self�args�kw��	__class__��?/usr/lib/python3.8/site-packages/pip/_internal/commands/show.pyrs�zShowCommand.__init__cCs8|st�d�tS|}t|�}t||j|jd�s4tStS)Nz.ERROR: Please provide a package name or names.)�
list_files�verbose)�logger�warningr�search_packages_info�
print_resultsrrr	)rZoptionsr�query�resultsrrr�run*s
�zShowCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrr$�
__classcell__rrrrrs
rc#sTi�tjD]}|�t|j�<q
dd�|D�}t�fdd�t||�D��}|r^t�dd�|��dd�}�fdd�|D�D�]ԉ�j�j	�j
d	d����D�|�j�d
�}d}d}t�tj
��r��d��r��d�}d
d�|D�}	�fdd�|	D�}	�fdd�|	D�}��d��rn��d�}nP��d��rX��d�}	�fdd�|	D�}	�fdd�|	D�}��d��rn��d�}��d��r���d�}
|
|d<��d��rƈ�d�D]"}|���r�|��|d<�qƐq�t�}|�|�|��}
dD]}|
�|�||<�q�g}|��D](}|�d��r|�|td�d���q||d<|�rHt|�|d<|VqxdS)z�
    Gather details from installed distributions. Print distribution name,
    version, location, and installed files. Installed files requires a
    pip generated 'installed-files.txt' in the distributions '.egg-info'
    directory.
    cSsg|]}t|��qSrr)�.0�namerrr�
<listcomp>Bsz(search_packages_info.<locals>.<listcomp>csg|]\}}|�kr|�qSrr)r*r+�pkg��	installedrrr,DszPackage(s) not found: %s�, cst|���fdd�tjD�S)Ncs(g|] }�dd�|��D�kr|j�qS)cSsg|]}t|j��qSr)rr+)r*Zrequiredrrrr,NszSsearch_packages_info.<locals>.get_requiring_packages.<locals>.<listcomp>.<listcomp>)�requires�project_name�r*r-�Zcanonical_namerrr,Ks���zHsearch_packages_info.<locals>.get_requiring_packages.<locals>.<listcomp>)rr�working_set)Zpackage_namerr4r�get_requiring_packagesIs
�z4search_packages_info.<locals>.get_requiring_packagescsg|]}|�kr�|�qSrrr3r.rrr,RscSsg|]
}|j�qSr)r2)r*Zdeprrrr,Ws)r+�version�locationr1�required_byNZRECORDcSsg|]}|�d�d�qS)�,r)�split)r*�lrrrr,`scsg|]}tj��j|��qSr)�os�path�joinr8�r*�p��distrrr,ascsg|]}tj�|�j��qSr�r=r>�relpathr8r@rBrrr,bsZMETADATAzinstalled-files.txtcsg|]}tj��j|��qSr)r=r>r?Zegg_infor@rBrrr,jscsg|]}tj�|�j��qSrrDr@rBrrr,kszPKG-INFOzentry_points.txt�entry_pointsZ	INSTALLER�	installer)�metadata-version�summary�	home-page�author�author-email�licensezClassifier: �classifiersr)rr5rr2�sorted�ziprrr?r7r8r1�
isinstanceZDistInfoDistributionZhas_metadataZget_metadata_linesZget_metadata�striprZfeed�close�get�
splitlines�
startswith�append�len)r"rAZquery_namesZmissingr6�packageZ	file_listZmetadata�lines�pathsrF�lineZfeed_parserZ
pkg_info_dict�keyrNr)rCr/rr 7sl
�	�






r Fc		Cs�d}t|�D�]�\}}d}|dkr*td�td|�dd��td|�d	d��td
|�dd��td|�d
d��td|�dd��td|�dd��td|�dd��td|�dd��tdd�|�dg���tdd�|�dg���|�rdtd|�dd��td|�dd��td�|�d g�D]}td!|��q(td"�|�d#g�D]}td!|����qN|rtd$�|�d%g�D]}td!|����q|d%|krtd&�q|S)'zD
    Print the informations from installed distributions found.
    FTrz---zName: %sr+�zVersion: %sr7zSummary: %srIz
Home-page: %srJz
Author: %srKzAuthor-email: %srLzLicense: %srMzLocation: %sr8zRequires: %sr0r1zRequired-by: %sr9zMetadata-Version: %srHz
Installer: %srGzClassifiers:rNz  %sz
Entry-points:rFzFiles:rz!Cannot locate installed-files.txt)�	enumerater
rTr?rR)	Z
distributionsrrZresults_printed�irCZ
classifier�entryr\rrrr!�sB
�
r!)FF)Z
__future__rZloggingr=Zemail.parserrZpip._vendorrZpip._vendor.packaging.utilsrZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrr	Zpip._internal.utils.miscr
Z	getLoggerr%rrr r!rrrr�<module>s
#Xsite-packages/pip/_internal/commands/__pycache__/debug.cpython-38.pyc000064400000006313151446176770021603 0ustar00U

��.eB
�@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZddl
mZddlmZdd	lmZdd
lmZer�ddlmZmZddlmZe�e�Zd
d�Zdd�Zdd�ZGdd�de�Z dS)�)�absolute_importN)�
cmdoptions)�Command)�make_target_python)�SUCCESS)�
indent_log)�get_pip_version)�MYPY_CHECK_RUNNING)�
format_tag)�Any�List)�ValuescCst�d�||��dS)Nz{}: {})�logger�info�format)�name�value�r�@/usr/lib/python3.8/site-packages/pip/_internal/commands/debug.py�
show_valuesrc	CsFt�d�ttd�r"tj}|j}nd}t��td|�W5QRXdS)Nzsys.implementation:�implementation�r)rr�hasattr�sysrrrr)rZimplementation_namerrr�show_sys_implementations

rc		Cs�d}t|�}|��}|��}d}|r.d�|�}d�t|�|�}t�|�|jdkrpt|�|krpd}|d|�}nd}t��8|D]}t�t	|��q�|r�dj|d	�}t�|�W5QRXdS)
N�
rz
 (target: {})zCompatible tags: {}{}�TFz?...
[First {tag_limit} tags shown. Pass --verbose to show all.])�	tag_limit)
rZget_tagsZformat_givenr�lenrr�verboserr
)	�optionsrZ
target_pythonZtagsZformatted_target�suffix�msgZtags_limited�tagrrr�	show_tags,s,

��r$cs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�DebugCommandz$
    Display debug information.
    z
      %prog <options>Tcs4tt|�j||�|j}t�|�|j�d|�dS)Nr)�superr%�__init__�cmd_optsrZadd_target_python_options�parserZinsert_option_group)�self�args�kwr(��	__class__rrr'Ws
zDebugCommand.__init__cCsvt�d�tdt��tdtj�tdtj�tdt���tdt���tdt	�
��tdtj�t�t
|�tS)	Nz�This command is only meant for debugging. Do not use this with automation for parsing and getting these details, since the output and options of this command may change without notice.zpip versionzsys.versionzsys.executablezsys.getdefaultencodingzsys.getfilesystemencodingzlocale.getpreferredencodingzsys.platform)rZwarningrrr�version�
executable�getdefaultencoding�getfilesystemencoding�localeZgetpreferredencoding�platformrr$r)r*r r+rrr�run^s ��zDebugCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvr'r5�
__classcell__rrr-rr%Ns
r%)!Z
__future__rr3ZloggingrZpip._internal.clirZpip._internal.cli.base_commandrZpip._internal.cli.cmdoptionsrZpip._internal.cli.status_codesrZpip._internal.utils.loggingrZpip._internal.utils.miscrZpip._internal.utils.typingr	Zpip._internal.wheelr
�typingrrZoptparser
Z	getLoggerr6rrrr$r%rrrr�<module>s&

"site-packages/pip/_internal/commands/__pycache__/search.cpython-38.opt-1.pyc000064400000010604151446176770022717 0ustar00U

��.e�@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Zddlm
Z
ddlmZddlmZdd	lmZmZdd
lmZddlmZddlmZdd
lmZddlmZddlm Z e�!e"�Z#Gdd�dee�Z$dd�Z%ddd�Z&dd�Z'dS)�)�absolute_importN)�OrderedDict)�
pkg_resources)�parse)�
xmlrpc_client)�Command)�SessionCommandMixin)�NO_MATCHES_FOUND�SUCCESS)�CommandError)�PyPI)�PipXmlrpcTransport)�get_terminal_size)�
indent_log)�write_outputcs8eZdZdZdZdZ�fdd�Zdd�Zdd	�Z�Z	S)
�
SearchCommandz@Search for PyPI packages whose name or summary contains <query>.z
      %prog [options] <query>Tcs@tt|�j||�|jjddddtjdd�|j�d|j�dS)Nz-iz--index�indexZURLz3Base URL of Python Package Index (default %default))�dest�metavar�default�helpr)	�superr�__init__Zcmd_optsZ
add_optionrZpypi_url�parserZinsert_option_group)�self�args�kw��	__class__��A/usr/lib/python3.8/site-packages/pip/_internal/commands/search.pyr%s�zSearchCommand.__init__cCsT|std��|}|�||�}t|�}d}tj��r<t�d}t||d�|rPtSt	S)Nz)Missing required argument (search query).r)�terminal_width)
r�search�transform_hits�sys�stdout�isattyr�
print_resultsr
r	)r�optionsr�queryZ	pypi_hits�hitsr!rrr �run0s

zSearchCommand.runcCs<|j}|�|�}t||�}t�||�}|�||d�d�}|S)N)�name�summary�or)rZget_default_sessionr
rZServerProxyr")rr)r(Z	index_urlZsessionZ	transportZpypir*rrr r"@s

zSearchCommand.search)
�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrr+r"�
__classcell__rrrr rsrcCs�t�}|D]n}|d}|d}|d}||��krF|||gd�||<q
||d�|�|t||d�kr
|||d<q
t|���S)z�
    The list from pypi is really a list of versions. We want a list of
    packages with the list of versions stored inline. This converts the
    list from pypi into one we can use.
    r,r-�version)r,r-�versionsr5)r�keys�append�highest_version�list�values)r*Zpackages�hitr,r-r4rrr r#Ks�r#c
CsP|sdS|dkr&tdd�|D��d}dd�tjD�}|D�]}|d}|dpRd}t|�dd	g��}|dk	r�||d
}|dkr�t�||�}dd
|d�|�}d|d||f|f}	zxt|	�||k�r0t�	|�}
t
��L|
j|kr�td|
j�n.td|
j�t|�j
�rtd|�n
td|�W5QRXWq:tk
�rHYq:Xq:dS)Nc	Ss.g|]&}t|d�tt|�ddg����qS)r,r5�-)�lenr8�get)�.0r;rrr �
<listcomp>ks�z!print_results.<locals>.<listcomp>�cSsg|]
}|j�qSr)Zproject_name)r?�prrr r@psr,r-�r5r<��
�
� �z	%-*s - %sz%s (%s)zINSTALLED: %s (latest)z
INSTALLED: %sz=LATEST:    %s (pre-release; install with "pip install --pre")z
LATEST:    %s)�maxrZworking_setr8r>�textwrapZwrap�joinrZget_distributionrr4�
parse_versionZpre�UnicodeEncodeError)r*Zname_column_widthr!Zinstalled_packagesr;r,r-ZlatestZtarget_width�lineZdistrrr r'gsJ��

�


�r'cCst|td�S)N)�key)rIrL)r5rrr r8�sr8)NN)(Z
__future__rZloggingr$rJ�collectionsrZpip._vendorrZpip._vendor.packaging.versionrrLZpip._vendor.six.movesrZpip._internal.cli.base_commandrZpip._internal.cli.req_commandrZpip._internal.cli.status_codesr	r
Zpip._internal.exceptionsrZpip._internal.models.indexrZpip._internal.network.xmlrpcr
Zpip._internal.utils.compatrZpip._internal.utils.loggingrZpip._internal.utils.miscrZ	getLoggerr/Zloggerrr#r'r8rrrr �<module>s*
-
)site-packages/pip/_internal/commands/__pycache__/configuration.cpython-38.pyc000064400000014657151446176770023376 0ustar00U

��.e:�@s�ddlZddlZddlZddlmZddlmZmZddlm	Z	m
Z
mZddlm
Z
ddlmZmZe�e�ZGdd�de�ZdS)	�N)�Command)�ERROR�SUCCESS)�
Configuration�get_configuration_files�kinds)�PipError)�get_prog�write_outputcsxeZdZdZdZdZ�fdd�Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Z�ZS)�ConfigurationCommanda9Manage local and global configuration.

        Subcommands:

        list: List the active configuration (or from the file specified)
        edit: Edit the configuration file in an editor
        get: Get the value associated with name
        set: Set the name=value
        unset: Unset the value associated with name

        If none of --user, --global and --site are passed, a virtual
        environment configuration file is used if one is active and the file
        exists. Otherwise, all modifications happen on the to the user file by
        default.
    Tz�
        %prog [<file-option>] list
        %prog [<file-option>] [--editor <editor-path>] edit

        %prog [<file-option>] get name
        %prog [<file-option>] set name value
        %prog [<file-option>] unset name
    cs�tt|�j||�d|_|jjdddddd�|jjdddd	d
d�|jjdddd	d
d�|jjdddd	dd�|j�d|j�dS)Nz--editor�editorZstorez\Editor to use to edit the file. Uses VISUAL or EDITOR environment variables if not provided.)�dest�action�default�helpz--global�global_file�
store_trueFz+Use the system-wide configuration file onlyz--user�	user_filez$Use the user configuration file onlyz--site�	site_filez3Use the current environment configuration file onlyr)�superr�__init__�
configurationZcmd_optsZ
add_option�parserZinsert_option_group)�self�args�kwargs��	__class__��H/usr/lib/python3.8/site-packages/pip/_internal/commands/configuration.pyr0s>����zConfigurationCommand.__init__c
Cs|j|j|j|j|jd�}|r*|d|krHt�d�d�t	|����t
S|d}z|j||dkd�}Wn:tk
r�}zt�|j
d�t
WY�Sd}~XYnXt|j|d�|_|j��z||||dd��Wn<tk
�r}zt�|j
d�t
WY�Sd}~XYnXtS)	N)�list�edit�get�set�unsetrzNeed an action ({}) to perform.z, )r"r#r$r!)�
need_value)�isolated�	load_only�)�list_values�open_in_editor�get_name�set_name_value�
unset_name�logger�error�format�join�sortedr�_determine_filerrrZ
isolated_moder�loadr)r�optionsrZhandlersrr'�errr�runZs>�	��
�
zConfigurationCommand.runcCs�dd�tj|jftj|jftj|jffD�}|s`|s8dStdd�t�tjD��rXtjStjSnt	|�dkrt|dSt
d��dS)NcSsg|]\}}|r|�qSrr)�.0�key�valuerrr�
<listcomp>�s�z8ConfigurationCommand._determine_file.<locals>.<listcomp>css|]}tj�|�VqdS)N)�os�path�exists)r8Zsite_config_filerrr�	<genexpr>�s�z7ConfigurationCommand._determine_file.<locals>.<genexpr>r(rzLNeed exactly one file to operate upon (--user, --site, --global) to perform.)rZUSERrZGLOBALrZSITEr�anyr�lenr)rr5r%Zfile_optionsrrrr3�s$


�
��z$ConfigurationCommand._determine_filecCs8|j|ddd�t|j���D]\}}td||�qdS)Nr r��nz%s=%r)�_get_n_argsr2r�itemsr
�rr5rr9r:rrrr)�sz ConfigurationCommand.list_valuescCs*|j|ddd�}|j�|�}td|�dS)Nz
get [name]r(rBz%s)rDrZ	get_valuer
rFrrrr+�szConfigurationCommand.get_namecCs.|j|ddd�\}}|j�||�|��dS)Nzset [name] [value]�rB)rDrZ	set_value�_save_configurationrFrrrr,�sz#ConfigurationCommand.set_name_valuecCs(|j|ddd�}|j�|�|��dS)Nzunset [name]r(rB)rDrZunset_valuerH)rr5rr9rrrr-�szConfigurationCommand.unset_namec
Csp|�|�}|j��}|dkr$td��zt�||g�Wn4tjk
rj}ztd�|j���W5d}~XYnXdS)Nz%Could not determine appropriate file.z*Editor Subprocess exited with exit code {})	�_determine_editorrZget_file_to_editr�
subprocessZ
check_callZCalledProcessErrorr0�
returncode)rr5rrZfnamer6rrrr*�s

��z#ConfigurationCommand.open_in_editorcCs<t|�|kr$d�|t�|�}t|��|dkr4|dS|SdS)zJHelper to make sure the command got the right number of arguments
        zJGot unexpected number of arguments, expected {}. (example: "{} config {}")r(rN)rAr0r	r)rrZexamplerC�msgrrrrD�s��z ConfigurationCommand._get_n_argscCs>z|j��Wn*tk
r8tjddd�td��YnXdS)Nz:Unable to save configuration. Please report this as a bug.r()�exc_infozInternal Error.)rZsave�	Exceptionr.r/r)rrrrrH�s�z(ConfigurationCommand._save_configurationcCsD|jdk	r|jSdtjkr$tjdSdtjkr8tjdStd��dS)NZVISUALZEDITORz"Could not determine editor to use.)rr<�environr)rr5rrrrI�s




z&ConfigurationCommand._determine_editor)�__name__�
__module__�__qualname__�__doc__Zignore_require_venvZusagerr7r3r)r+r,r-r*rDrHrI�
__classcell__rrrrrs	*+r)Zloggingr<rJZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrrZpip._internal.configurationrrrZpip._internal.exceptionsrZpip._internal.utils.miscr	r
Z	getLoggerrPr.rrrrr�<module>s
site-packages/pip/_internal/commands/__pycache__/debug.cpython-38.opt-1.pyc000064400000006313151446176770022542 0ustar00U

��.eB
�@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZddl
mZddlmZdd	lmZdd
lmZer�ddlmZmZddlmZe�e�Zd
d�Zdd�Zdd�ZGdd�de�Z dS)�)�absolute_importN)�
cmdoptions)�Command)�make_target_python)�SUCCESS)�
indent_log)�get_pip_version)�MYPY_CHECK_RUNNING)�
format_tag)�Any�List)�ValuescCst�d�||��dS)Nz{}: {})�logger�info�format)�name�value�r�@/usr/lib/python3.8/site-packages/pip/_internal/commands/debug.py�
show_valuesrc	CsFt�d�ttd�r"tj}|j}nd}t��td|�W5QRXdS)Nzsys.implementation:�implementation�r)rr�hasattr�sysrrrr)rZimplementation_namerrr�show_sys_implementations

rc		Cs�d}t|�}|��}|��}d}|r.d�|�}d�t|�|�}t�|�|jdkrpt|�|krpd}|d|�}nd}t��8|D]}t�t	|��q�|r�dj|d	�}t�|�W5QRXdS)
N�
rz
 (target: {})zCompatible tags: {}{}�TFz?...
[First {tag_limit} tags shown. Pass --verbose to show all.])�	tag_limit)
rZget_tagsZformat_givenr�lenrr�verboserr
)	�optionsrZ
target_pythonZtagsZformatted_target�suffix�msgZtags_limited�tagrrr�	show_tags,s,

��r$cs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�DebugCommandz$
    Display debug information.
    z
      %prog <options>Tcs4tt|�j||�|j}t�|�|j�d|�dS)Nr)�superr%�__init__�cmd_optsrZadd_target_python_options�parserZinsert_option_group)�self�args�kwr(��	__class__rrr'Ws
zDebugCommand.__init__cCsvt�d�tdt��tdtj�tdtj�tdt���tdt���tdt	�
��tdtj�t�t
|�tS)	Nz�This command is only meant for debugging. Do not use this with automation for parsing and getting these details, since the output and options of this command may change without notice.zpip versionzsys.versionzsys.executablezsys.getdefaultencodingzsys.getfilesystemencodingzlocale.getpreferredencodingzsys.platform)rZwarningrrr�version�
executable�getdefaultencoding�getfilesystemencoding�localeZgetpreferredencoding�platformrr$r)r*r r+rrr�run^s ��zDebugCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvr'r5�
__classcell__rrr-rr%Ns
r%)!Z
__future__rr3ZloggingrZpip._internal.clirZpip._internal.cli.base_commandrZpip._internal.cli.cmdoptionsrZpip._internal.cli.status_codesrZpip._internal.utils.loggingrZpip._internal.utils.miscrZpip._internal.utils.typingr	Zpip._internal.wheelr
�typingrrZoptparser
Z	getLoggerr6rrrr$r%rrrr�<module>s&

"site-packages/pip/_internal/commands/__pycache__/install.cpython-38.pyc000064400000034172151446176770022167 0ustar00U

��.e�_�@s�ddlmZddlZddlZddlZddlZddlZddlZddlmZddl	m
Z
ddlmZddl
mZddlmZddlmZdd	lmZdd
lmZddlmZmZddlmZmZmZdd
lmZddl m!Z!ddl"m#Z#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5e1�r�ddl	m6Z6ddl7m8Z8m9Z9m:Z:ddl;m<Z<ddl=m>Z>ddl4m?Z?e�@eA�ZBdd�ZCdd�ZDd d!�ZEGd"d#�d#e�ZFd$d%�ZGd&d'�ZHdS)(�)�absolute_importN)�path)�
SUPPRESS_HELP)�
pkg_resources)�canonicalize_name)�
WheelCache)�
cmdoptions)�make_target_python)�RequirementCommand)�ERROR�SUCCESS)�CommandError�InstallationError�PreviousBuildDirError��distutils_scheme)�check_install_conflicts)�RequirementSet�install_given_reqs)�RequirementTracker)�check_path_owner)�
ensure_dir�get_installed_version�(protect_pip_from_modification_on_windows�write_output)�
TempDirectory)�MYPY_CHECK_RUNNING)�virtualenv_no_global)�WheelBuilder)�Values)�Any�List�Optional)�
FormatControl)�InstallRequirement)�BinaryAllowedPredicatecCs(zddl}Wntk
r"YdSXdS)z8
    Return whether the wheel package is installed.
    rNFT)�wheel�ImportError)r&�r(�B/usr/lib/python3.8/site-packages/pip/_internal/commands/install.py�is_wheel_installed<s
r*cCs*t�}|j|dd�}|r&|j|dd�|S)zQ
    Build wheels for requirements, depending on whether wheel is installed.
    T)Z
should_unpack)r*Zbuild)�builder�pep517_requirements�legacy_requirementsZshould_build_legacy�build_failuresr(r(r)�build_wheelsHs
��r/cs�fdd�}|S)Ncs&|jr
dSt|j�}��|�}d|kS)NTZbinary)�
use_pep517r�nameZget_allowed_formats)�reqZcanonical_nameZallowed_formats��format_controlr(r)�check_binary_allowedhs


z6get_check_binary_allowed.<locals>.check_binary_allowedr()r4r5r(r3r)�get_check_binary_allowedfsr6cs<eZdZdZdZ�fdd�Zdd�Zdd�Zd	d
�Z�Z	S)�InstallCommandaI
    Install packages from:

    - PyPI (and other indexes) using requirement specifiers.
    - VCS project urls.
    - Local project directories.
    - Local or remote source archives.

    pip also supports installing from "requirements files", which provide
    an easy way to specify a whole environment to be installed.
    a%
      %prog [options] <requirement specifier> [package-index-options] ...
      %prog [options] -r <requirements file> [package-index-options] ...
      %prog [options] [-e] <vcs project url> ...
      %prog [options] [-e] <local project path> ...
      %prog [options] <archive url/path> ...cs^tt|�j||�|j}|�t���|�t���|�t���|�t�	��|�t�
��|jddddddd�t�|�|jddd	d
d�|jddd
td�|jdddddd�|jdddddd�|�t�
��|�t���|jdddd	dd�|jdddddgdd�|jddd	d d�|jd!d"d#d	d$d�|�t���|�t���|�t���|�t���|�t���|�t���|jd%d	d&d'd(d)�|jd*d
d&d+d,�|jd-d
d.d'd/d)�|jd0d
d1d'd2d)�|�t���|�t���|�t���|�t���|�t���|�t���t�tj|j�}|j�d3|�|j�d3|�dS)4Nz-tz--target�
target_dir�dirz�Install packages into <dir>. By default this will not replace existing files/folders in <dir>. Use --upgrade to replace existing packages in <dir> with new versions.)�dest�metavar�default�help�--user�
use_user_site�
store_truez�Install to the Python user install directory for your platform. Typically ~/.local/, or %APPDATA%\Python on Windows. (See the Python documentation for site.USER_BASE for full details.))r:�actionr=z	--no-userZstore_falsez--root�	root_pathz=Install everything relative to this alternate root directory.z--prefix�prefix_pathzIInstallation prefix where lib, bin and other top-level folders are placedz-Uz	--upgrade�upgradez�Upgrade all specified packages to the newest available version. The handling of dependencies depends on the upgrade-strategy used.z--upgrade-strategy�upgrade_strategyzonly-if-neededZeageraGDetermines how dependency upgrading should be handled [default: %default]. "eager" - dependencies are upgraded regardless of whether the currently installed version satisfies the requirements of the upgraded package(s). "only-if-needed" -  are upgraded only when they do not satisfy the requirements of the upgraded package(s).)r:r<�choicesr=z--force-reinstall�force_reinstallz;Reinstall all packages even if they are already up-to-date.z-Iz--ignore-installed�ignore_installedz�Ignore the installed packages, overwriting them. This can break your system if the existing package is of a different version or was installed with a different package manager!z	--compile�compileTz'Compile Python source files to bytecode)rAr:r<r=z--no-compilez.Do not compile Python source files to bytecode)rAr:r=z--no-warn-script-location�warn_script_locationz0Do not warn when installing scripts outside PATHz--no-warn-conflicts�warn_about_conflictsz%Do not warn about broken dependenciesr)�superr7�__init__�cmd_optsZ
add_optionr�requirementsZconstraintsZno_depsZpreZeditableZadd_target_python_optionsr�	build_dir�src�ignore_requires_pythonZno_build_isolationr0Z
no_use_pep517�install_options�global_optionsZ	no_binaryZonly_binaryZ
prefer_binary�no_clean�require_hashesZprogress_barZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrNZ
index_opts��	__class__r(r)rM�s��

�����	���
�����zInstallCommand.__init__c*Cs�t�|�dd�}t��dkrZ|�sZt�tjd�}|dkrLt�tj�d}t	�
d|�d}|jrj|j}|j
r�tj�|j
�|_
tj|dd	�tj�|j�|_|jp�g}|jr�|jr�td
��t�r�td��|�d�|�d
�d}d}|j�rJd|_tj�|j�|_tj�|j��r,tj�|j��s,td��tdd�}|j}|�d|�|j�pTg}	|�|�}
t|�}|j ||
||j!d�}|j"�p�|j
}
t#|j$|j%�}|j$�r�t&|j$��s�t	�
d|j$�d|_$t'���}t|j
|
dd����}t(|j)|jd�}�z��z*|�,|||||
|�|j-|||d�}|j.|||
|||j|j|j!|j/||j0d�}|�1|�z|�2d�}Wnt3k
�rzd}YnX|j4dk}t5|d�t6|j%�}g}g}|j7�8�D]$}|j0�r�|�|�n
|�|��q�t9||gg|d�}t:|||d�}|�rtd�;d�<dd �|D�����|�=|�}|j>�o.|j?}|�r@|�@|�|jA}|j�rRd!}tB|||	|jC||j|jD||jd"�	}tE|j||jC|j|jFd#�} tG�H| �}!tI|tJ�Kd$�d%�}"g}#|"D]R}|jL}$z$tM|jL|!d&�}%|%�r�|$d'|%7}$WntNk
�r�YnX|#�|$��q�d(�<|#�}&|&�r tOd)|&�Wn�tPk
�r�}'zN|jQd*k}(tR|'|(|j�})t	jS|)|(d+�tTWY�W�HW5QR�W5QR�Sd}'~'XYntUk
�r�d|_"�YnXW5|j"�s�|�*�|�+�XW5QRXW5QRX|j�r�|�V|j||j�tWS),NcSs ttd�pttd�otjtjkS)NZreal_prefix�base_prefix)�hasattr�sysr]�prefixr(r(r(r)�is_venvs


�z#InstallCommand.run.<locals>.is_venvrz__main__.pyz -m pipzgRunning pip install with root privileges is generally not a good idea. Try `%s install --user` instead.zto-satisfy-onlyT)Zcheck_targetzVCan not combine '--user' and '--prefix' as they imply different installation locationszZCan not perform a '--user' install. User site-packages are not visible in this virtualenv.r>z	--prefix=z=Target path exists but is not a directory, will not continue.�target)�kindz--home=)�options�session�
target_pythonrRz�The directory '%s' or its parent directory is not owned by the current user and caching wheels has been disabled. check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.Zinstall)�deleterc)rVZcheck_supported_wheels)Ztemp_build_dirrd�req_tracker)�preparer�finderrerd�wheel_cacher?rHrRrGrEr0Zpip)�
modifying_pip)Z
build_optionsrTr5)r+r,r-zPCould not build wheels for {} which use PEP 517 and cannot be installed directlyz, css|]}|jVqdS�N)r1)�.0�rr(r(r)�	<genexpr>�sz%InstallCommand.run.<locals>.<genexpr>F)�root�homer`Z	pycompilerJr?)�userrrrqr`�isolatedr1)�key)�working_set�-� zSuccessfully installed %s���exc_info)XrZcheck_install_build_global�os�getuidr�basenamer_�argv�
executable�logger�warningrDrErP�abspathZcheck_dist_restrictionZsrc_dirrSr?rCr
rr�appendr8rH�exists�isdirrrTZget_default_sessionr	Z_build_package_finderrRrUr�	cache_dirr4rrrrVZ
cleanup_filesZcleanupZpopulate_requirement_setZmake_requirement_preparerZ
make_resolverrGr0ZresolveZget_requirement�KeyErrorZsatisfied_byrr6rO�valuesrr/�format�joinZget_installation_orderZignore_dependenciesrK�_warn_about_conflictsrJrrBrI�get_lib_location_guessesZ
isolated_moderZ
WorkingSet�sorted�operator�
attrgetterr1r�	Exceptionr�EnvironmentError�	verbosity�create_env_error_message�errorrr�_handle_target_dirr)*rXrdrYraZcommandrErS�target_temp_dirZtarget_temp_dir_pathrTrerfrjZbuild_deleterkrhZ	directoryZrequirement_setriZresolverZpip_reqrlr5r-r,r2Z
wheel_builderr.�
to_installZshould_warn_about_conflictsrJZ	installedZ
lib_locationsrvZreqs�items�itemZinstalled_versionZinstalled_descr��show_traceback�messager(r(r)�runs�
��
��

��

�������


�������
�
��
�
�
�4�zInstallCommand.runc	sft|�g}|��Jtd|jd�}|d}|d}|d}tj�|�rP|�|�tj�|�rn||krn|�|�tj�|�r�|�|�|D]�}	t�|	�D]�}
|	|kr�tj�||
��t�fdd�|dd�D��r�q�tj�||
�}tj�|��r>|s�t	�
d	|�q�tj�|��rt	�
d
|�q�tj�|��r4t
�|�n
t�|�t
�tj�|	|
�|�q�q�W5QRXdS)N�)rr�purelib�platlib�datac3s|]}|���VqdSrm)�
startswith)rn�s��ddirr(r)rp+sz4InstallCommand._handle_target_dir.<locals>.<genexpr>���zKTarget directory %s already exists. Specify --upgrade to force replacement.z�Target directory %s already exists and is a link. Pip will not automatically replace links, please remove if replacement is desired.)rrrr|r�r��listdirr��anyr�r��islinkr��shutilZrmtree�removeZmove)rXr8r�rDZlib_dir_list�schemeZpurelib_dirZplatlib_dirZdata_dirZlib_dirr�Ztarget_item_dirr(r�r)r�sP


��
�z!InstallCommand._handle_target_dirc
Cs�zt|�\}}Wn$tk
r4tjddd�YdSX|\}}|D]2}||d}||D]}t�d|||d�qZqB|D]8}||d}||D]\}	}
}t�d||||	|
�q�qzdS)NzError checking for conflicts.Trzrz*%s %s requires %s, which is not installed.ryzF%s %s has requirement %s, but you'll have %s %s which is incompatible.)rr�r�r�Zcritical)rXr�Zpackage_setZ	_dep_infoZmissingZconflictingZproject_name�versionZ
dependencyZdep_nameZdep_versionr2r(r(r)r�Is4��z$InstallCommand._warn_about_conflicts)
�__name__�
__module__�__qualname__�__doc__ZusagerMr�r�r��
__classcell__r(r(r[r)r7ssw8r7cOstd|�|�}|d|dgS)Nr�r�r�)r�r)rY�kwargsr�r(r(r)r�dsr�cCs�g}|�d�|s,|�d�|�t|��n
|�d�|dd7<|jtjkr�d}d}|st|�|d|��g�n
|�|�|�d	�d
�|���dS)z{Format an error message for an EnvironmentError

    It may occur anytime during the execution of the install command.
    z5Could not install packages due to an EnvironmentErrorz: �.r��
z"Consider using the `--user` optionzCheck the permissionsz or z.
r�)r��str�errnoZEACCES�extend�lowerr��strip)r�r�Zusing_user_site�partsZuser_option_partZpermissions_partr(r(r)r�is&


�

r�)IZ
__future__rr�Zloggingr�r|r�r_rZoptparserZpip._vendorrZpip._vendor.packaging.utilsrZpip._internal.cacherZpip._internal.clirZpip._internal.cli.cmdoptionsr	Zpip._internal.cli.req_commandr
Zpip._internal.cli.status_codesrrZpip._internal.exceptionsr
rrZpip._internal.locationsrZpip._internal.operations.checkrZpip._internal.reqrrZpip._internal.req.req_trackerrZpip._internal.utils.filesystemrZpip._internal.utils.miscrrrrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.virtualenvrZpip._internal.wheelrr�typingr r!r"Z#pip._internal.models.format_controlr#Zpip._internal.req.req_installr$r%Z	getLoggerr�r�r*r/r6r7r�r�r(r(r(r)�<module>sT

tsite-packages/pip/_internal/commands/__pycache__/list.cpython-38.opt-1.pyc000064400000021267151446176770022434 0ustar00U

��.e4)�@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZdd	lmZdd
lmZddlmZmZmZddlmZe�e�ZGd
d�de�Zdd�Zdd�Zdd�Z dS)�)�absolute_importN)�six)�zip_longest)�
cmdoptions)�IndexGroupCommand)�CommandError)�
PackageFinder)�SelectionPreferences)�make_link_collector)�dist_is_editable�get_installed_distributions�write_output)�
get_installercsdeZdZdZdZ�fdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
�ZS)�ListCommandzt
    List installed packages, including editables.

    Packages are listed in a case-insensitive sorted order.
    z
      %prog [options]cstt|�j||�|j}|jdddddd�|jddddd	d�|jd
ddddd�|jd
ddddd�|jjdddddd�|�t���|jddddd�|jddddddd�|jddddd �|jd!d"d#d$d �|jd%dd#d&d'd(�t�tj|j	�}|j	�
d)|�|j	�
d)|�dS)*Nz-oz
--outdated�
store_trueFzList outdated packages)�action�default�helpz-uz
--uptodatezList uptodate packagesz-ez
--editablezList editable projects.z-lz--localzSIf in a virtualenv that has global access, do not list globally-installed packages.z--user�userz,Only output packages installed in user-site.)�destrrrz--prezYInclude pre-release and development versions. By default, pip only finds stable versions.z--formatZstore�list_format�columns)r�freeze�jsonzBSelect the output format among: columns (default), freeze, or json)rrr�choicesrz--not-required�not_requiredz>List packages that are not dependencies of installed packages.)rrrz--exclude-editableZstore_false�include_editablez%Exclude editable package from output.z--include-editablez%Include editable package from output.T)rrrrr)�superr�__init__�cmd_optsZ
add_optionrZ	list_pathZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrZ
index_opts��	__class__��?/usr/lib/python3.8/site-packages/pip/_internal/commands/list.pyr&s��������
����zListCommand.__init__cCs(t||d�}td|jd�}tj||d�S)zK
        Create a package finder appropriate to this list command.
        )�optionsF)Zallow_yankedZallow_all_prereleases)�link_collector�selection_prefs)r
r	�prerZcreate)r!r(�sessionr)r*r&r&r'�_build_package_findervs��z!ListCommand._build_package_findercCs�|jr|jrtd��t�|�t|j|j|j|j	|j
d�}|jrL|�||�}|jr`|�
||�}n|jrr|�||�}|�||�dS)Nz5Options --outdated and --uptodate cannot be combined.)Z
local_onlyZ	user_onlyZeditables_onlyZinclude_editables�paths)�outdatedZuptodaterrZcheck_list_path_optionrZlocalrZeditabler�pathr�get_not_required�get_outdated�get_uptodate�output_package_listing)r!r(r"�packagesr&r&r'�run�s&�
�zListCommand.runcCsdd�|�||�D�S)NcSsg|]}|j|jkr|�qSr&��latest_versionZparsed_version��.0�distr&r&r'�
<listcomp>�s�z,ListCommand.get_outdated.<locals>.<listcomp>��iter_packages_latest_infos�r!r5r(r&r&r'r2�s
�zListCommand.get_outdatedcCsdd�|�||�D�S)NcSsg|]}|j|jkr|�qSr&r7r9r&r&r'r<�s�z,ListCommand.get_uptodate.<locals>.<listcomp>r=r?r&r&r'r3�s
�zListCommand.get_uptodatecs:t��|D]}��dd�|��D��q
�fdd�|D�S)Ncss|]}|jVqdS�N��key)r:Zrequirementr&r&r'�	<genexpr>�sz/ListCommand.get_not_required.<locals>.<genexpr>csh|]}|j�kr|�qSr&rA)r:Zpkg�Zdep_keysr&r'�	<setcomp>�s
z/ListCommand.get_not_required.<locals>.<setcomp>)�set�updateZrequires)r!r5r(r;r&rDr'r1�szListCommand.get_not_requiredc	cs�|�|���}|�||�}|D]t}d}|�|j�}|jsDdd�|D�}|j|jd�}|�|�}	|	dkrfq|	j}
|	j	j
rzd}nd}|
|_||_|VqW5QRXdS)N�unknowncSsg|]}|jjs|�qSr&)�versionZ
is_prerelease)r:�	candidater&r&r'r<�s�z:ListCommand.iter_packages_latest_infos.<locals>.<listcomp>)�project_nameZwheelZsdist)
Z_build_sessionr-Zfind_all_candidatesrBr+Zmake_candidate_evaluatorrKZsort_best_candidaterI�linkZis_wheelr8�latest_filetype)r!r5r(r,�finderr;�typZall_candidatesZ	evaluatorZbest_candidateZremote_versionr&r&r'r>�s(�
z&ListCommand.iter_packages_latest_infoscCs�t|dd�d�}|jdkr:|r:t||�\}}|�||�n^|jdkr�|D]4}|jdkrltd|j|j|j�qHtd|j|j�qHn|jd	kr�tt	||��dS)
NcSs
|j��Sr@)rK�lower)r;r&r&r'�<lambda>��z4ListCommand.output_package_listing.<locals>.<lambda>rArr�z%s==%s (%s)z%s==%sr)
�sortedr�format_for_columns�output_package_listing_columns�verboser
rKrI�location�format_for_json)r!r5r(�data�headerr;r&r&r'r4�s"�

�
z"ListCommand.output_package_listingcCsbt|�dkr|�d|�t|�\}}t|�dkrL|�dd�tdd�|���|D]}t|�qPdS)NrrS� cSsd|S)N�-r&)�xr&r&r'rQ�rRz<ListCommand.output_package_listing_columns.<locals>.<lambda>)�len�insert�tabulate�join�mapr
)r!rZr[Zpkg_strings�sizes�valr&r&r'rV�sz*ListCommand.output_package_listing_columns)�__name__�
__module__�__qualname__�__doc__Zusagerr-r6r2r3r1r>r4rV�
__classcell__r&r&r$r'rsPrcCspdgtdd�|D��}|D]}dd�t||�D�}qg}|D](}d�dd�t||�D��}|�|�q>||fS)Nrcss|]}t|�VqdSr@)r_�r:r^r&r&r'rC�sztabulate.<locals>.<genexpr>cSs"g|]\}}t|tt|����qSr&)�maxr_�str�r:�s�cr&r&r'r<�sztabulate.<locals>.<listcomp>r\cSs*g|]"\}}|dk	r"t|��|�nd�qS)N�)rm�ljustrnr&r&r'r<�s�)rlrrb�append)Zvalsrd�row�resultZdisplayr&r&r'ra�s
�racCs�|j}|rddddg}nddg}g}|jdks@tdd�|D��rJ|�d�|jdkr^|�d	�|D]l}|j|jg}|r�|�|j�|�|j�|jdks�t|�r�|�|j	�|jdkr�|�t
|��|�|�qb||fS)
z_
    Convert the package data into something usable
    by output_package_listing_columns.
    ZPackageZVersionZLatestZTyperScss|]}t|�VqdSr@)rrkr&r&r'rCsz%format_for_columns.<locals>.<genexpr>ZLocationZ	Installer)r/rW�anyrsrKrIr8rMrrXr)Zpkgsr(Zrunning_outdatedr[rZZprojrtr&r&r'rUs(



rUcCsvg}|D]b}|jt�|j�d�}|jdkr@|j|d<t|�|d<|jr`t�|j�|d<|j	|d<|�
|�qt�|�S)N)�namerIrSrXZ	installerr8rM)
rKrZ	text_typerIrWrXrr/r8rMrsr�dumps)r5r(rZr;�infor&r&r'rY+s
�


rY)!Z
__future__rrZloggingZpip._vendorrZpip._vendor.six.movesrZpip._internal.clirZpip._internal.cli.req_commandrZpip._internal.exceptionsrZpip._internal.indexrZ$pip._internal.models.selection_prefsr	Z!pip._internal.self_outdated_checkr
Zpip._internal.utils.miscrrr
Zpip._internal.utils.packagingrZ	getLoggerrfZloggerrrarUrYr&r&r&r'�<module>s$
Y%site-packages/pip/_internal/commands/__pycache__/completion.cpython-38.pyc000064400000005705151446176770022672 0ustar00U

��.e��@sXddlmZddlZddlZddlmZddlmZdZdddd	�Z	Gd
d�de�Z
dS)�)�absolute_importN)�Command)�get_progzJ
# pip %(shell)s completion start%(script)s# pip %(shell)s completion end
a
        _pip_completion()
        {
            COMPREPLY=( $( COMP_WORDS="${COMP_WORDS[*]}" \
                           COMP_CWORD=$COMP_CWORD \
                           PIP_AUTO_COMPLETE=1 $1 2>/dev/null ) )
        }
        complete -o default -F _pip_completion %(prog)s
    aM
        function _pip_completion {
          local words cword
          read -Ac words
          read -cn cword
          reply=( $( COMP_WORDS="$words[*]" \
                     COMP_CWORD=$(( cword-1 )) \
                     PIP_AUTO_COMPLETE=1 $words[1] 2>/dev/null ))
        }
        compctl -K _pip_completion %(prog)s
    aw
        function __fish_complete_pip
            set -lx COMP_WORDS (commandline -o) ""
            set -lx COMP_CWORD ( \
                math (contains -i -- (commandline -t) $COMP_WORDS)-1 \
            )
            set -lx PIP_AUTO_COMPLETE 1
            string split \  -- (eval $COMP_WORDS[1])
        end
        complete -fa "(__fish_complete_pip)" -c %(prog)s
    )�bash�zsh�fishcs,eZdZdZdZ�fdd�Zdd�Z�ZS)�CompletionCommandz3A helper command to be used for command completion.Tcsltt|�j||�|j}|jddddddd�|jdd	dd
ddd�|jdd
ddddd�|j�d|�dS)Nz--bashz-b�store_constr�shellzEmit completion code for bash)�action�const�dest�helpz--zshz-zrzEmit completion code for zshz--fishz-frzEmit completion code for fishr)�superr�__init__�cmd_optsZ
add_option�parserZinsert_option_group)�self�args�kwr��	__class__��E/usr/lib/python3.8/site-packages/pip/_internal/commands/completion.pyr8s6���zCompletionCommand.__init__cCsrt��}dd�t|�D�}|j|krXt�t�|jd�dt�i�}tt	||jd��nt
j�dd�
|��dS)	z-Prints the completion code of the given shellcSsg|]}d|�qS)z--r)�.0r
rrr�
<listcomp>Usz)CompletionCommand.run.<locals>.<listcomp>��prog)�scriptr
zERROR: You must pass %s
z or N)�COMPLETION_SCRIPTS�keys�sortedr
�textwrap�dedent�getr�print�BASE_COMPLETION�sys�stderr�write�join)rZoptionsrZshellsZ
shell_optionsrrrr�runRs
���zCompletionCommand.run)�__name__�
__module__�__qualname__�__doc__Zignore_require_venvrr+�
__classcell__rrrrr3sr)Z
__future__rr'r"Zpip._internal.cli.base_commandrZpip._internal.utils.miscrr&rrrrrr�<module>s	�#site-packages/pip/_internal/commands/__pycache__/check.cpython-38.opt-1.pyc000064400000002440151446176770022526 0ustar00U

��.e��@sNddlZddlmZddlmZmZddlmZe�e	�Z
Gdd�de�ZdS)�N)�Command)�check_package_set�!create_package_set_from_installed)�write_outputc@seZdZdZdZdd�ZdS)�CheckCommandz7Verify installed packages have compatible dependencies.z
      %prog [options]c
	Cs�t�\}}t|�\}}|D].}||j}||D]}	td|||	d�q0q|D]4}||j}||D]\}
}}td||||
|�qdqN|s�|s�|r�dStd�dS)Nz*%s %s requires %s, which is not installed.rz-%s %s has requirement %s, but you have %s %s.�zNo broken requirements found.)rr�versionr)
�selfZoptions�argsZpackage_setZ
parsing_probsZmissingZconflictingZproject_namerZ
dependencyZdep_nameZdep_versionZreq�r�@/usr/lib/python3.8/site-packages/pip/_internal/commands/check.py�runs2

�
�zCheckCommand.runN)�__name__�
__module__�__qualname__�__doc__Zusager
rrrrrsr)ZloggingZpip._internal.cli.base_commandrZpip._internal.operations.checkrrZpip._internal.utils.miscrZ	getLoggerrZloggerrrrrr�<module>s

site-packages/pip/_internal/commands/__pycache__/check.cpython-38.pyc000064400000002440151446176770021567 0ustar00U

��.e��@sNddlZddlmZddlmZmZddlmZe�e	�Z
Gdd�de�ZdS)�N)�Command)�check_package_set�!create_package_set_from_installed)�write_outputc@seZdZdZdZdd�ZdS)�CheckCommandz7Verify installed packages have compatible dependencies.z
      %prog [options]c
	Cs�t�\}}t|�\}}|D].}||j}||D]}	td|||	d�q0q|D]4}||j}||D]\}
}}td||||
|�qdqN|s�|s�|r�dStd�dS)Nz*%s %s requires %s, which is not installed.rz-%s %s has requirement %s, but you have %s %s.�zNo broken requirements found.)rr�versionr)
�selfZoptions�argsZpackage_setZ
parsing_probsZmissingZconflictingZproject_namerZ
dependencyZdep_nameZdep_versionZreq�r�@/usr/lib/python3.8/site-packages/pip/_internal/commands/check.py�runs2

�
�zCheckCommand.runN)�__name__�
__module__�__qualname__�__doc__Zusager
rrrrrsr)ZloggingZpip._internal.cli.base_commandrZpip._internal.operations.checkrrZpip._internal.utils.miscrZ	getLoggerrZloggerrrrrr�<module>s

site-packages/pip/_internal/commands/__pycache__/download.cpython-38.pyc000064400000010314151446176770022320 0ustar00U

��.e��@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZdd	lmZmZmZdd
lmZe�e�ZGdd�de	�ZdS)
�)�absolute_importN)�
cmdoptions)�make_target_python)�RequirementCommand)�RequirementSet)�RequirementTracker)�check_path_owner)�
ensure_dir�normalize_path�write_output)�
TempDirectorycs,eZdZdZdZ�fdd�Zdd�Z�ZS)�DownloadCommandaL
    Download packages from:

    - PyPI (and other indexes) using requirement specifiers.
    - VCS project urls.
    - Local project directories.
    - Local or remote source archives.

    pip also supports downloading from "requirements files", which provide
    an easy way to specify a whole environment to be downloaded.
    a
      %prog [options] <requirement specifier> [package-index-options] ...
      %prog [options] -r <requirements file> [package-index-options] ...
      %prog [options] <vcs project url> ...
      %prog [options] <local project path> ...
      %prog [options] <archive url/path> ...c
sNtt|�j||�|j}|�t���|�t���|�t���|�t�	��|�t�
��|�t���|�t���|�t�
��|�t���|�t���|�t���|�t���|�t���|�t���|�t���|�t���|jddddddtjdd�t�|�t�tj|j�}|j�d	|�|j�d	|�dS)
Nz-dz--destz--destination-dirz--destination-directory�download_dir�dirzDownload packages into <dir>.)�dest�metavar�default�helpr)�superr
�__init__�cmd_optsZ
add_optionrZconstraintsZrequirements�	build_dirZno_depsZglobal_optionsZ	no_binaryZonly_binaryZ
prefer_binary�srcZpre�no_clean�require_hashesZprogress_barZno_build_isolationZ
use_pep517Z
no_use_pep517�os�curdirZadd_target_python_optionsZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrZ
index_opts��	__class__��C/usr/lib/python3.8/site-packages/pip/_internal/commands/download.pyr)sF�
�zDownloadCommand.__init__c

CsLd|_g|_t�|�tj�|j�|_t|j	�|_	t
|j	�|�|�}t|�}|j
|||d�}|jph|j}|jr�t|j�s�t�d|j�d|_t���}t|j|dd���}t|jd�}	|�|	||||d�|j||||j	d�}
|j|
||||jd�}|�|	�d	�d
d�|	jD��}|�r$td|�|j�s4|	� �W5QRXW5QRX|	S)
NT)�options�session�
target_pythonz�The directory '%s' or its parent directory is not owned by the current user and caching wheels has been disabled. check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.Zdownload)�deleteZkind)r)Ztemp_build_dirr%�req_trackerr)�preparer�finderr&r%Zpy_version_info� cSsg|]
}|j�qSr#)�name)�.0Zreqr#r#r$�
<listcomp>�sz'DownloadCommand.run.<locals>.<listcomp>zSuccessfully downloaded %s)!Zignore_installedZ	editablesrZcheck_dist_restrictionr�path�abspathZsrc_dirr
rr	Zget_default_sessionrZ_build_package_finderrr�	cache_dirr�loggerZwarningrrrrZpopulate_requirement_setZmake_requirement_preparerZ
make_resolverZpython_versionZresolve�joinZsuccessfully_downloadedrZ
cleanup_files)
rr%rr&r'r+Zbuild_deleter)Z	directoryZrequirement_setr*ZresolverZ
downloadedr#r#r$�runQsv


��
���	��

�
zDownloadCommand.run)�__name__�
__module__�__qualname__�__doc__Zusagerr5�
__classcell__r#r#r!r$r
s(r
)Z
__future__rZloggingrZpip._internal.clirZpip._internal.cli.cmdoptionsrZpip._internal.cli.req_commandrZpip._internal.reqrZpip._internal.req.req_trackerrZpip._internal.utils.filesystemrZpip._internal.utils.miscr	r
rZpip._internal.utils.temp_dirrZ	getLoggerr6r3r
r#r#r#r$�<module>s
site-packages/pip/_internal/commands/__pycache__/uninstall.cpython-38.opt-1.pyc000064400000005206151446176770023465 0ustar00U

��.e��@svddlmZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZGd	d
�d
ee�ZdS)�)�absolute_import)�canonicalize_name)�Command)�SessionCommandMixin)�InstallationError)�parse_requirements)�install_req_from_line)�(protect_pip_from_modification_on_windowscs,eZdZdZdZ�fdd�Zdd�Z�ZS)�UninstallCommandaB
    Uninstall packages.

    pip is able to uninstall most installed packages. Known exceptions are:

    - Pure distutils packages installed with ``python setup.py install``, which
      leave behind no metadata to determine what files were installed.
    - Script wrappers installed by ``python setup.py develop``.
    zU
      %prog [options] <package> ...
      %prog [options] -r <requirements file> ...c	sVtt|�j||�|jjddddgddd�|jjdd	d
ddd
�|j�d|j�dS)Nz-rz
--requirement�requirements�append�filezjUninstall all the packages listed in the given requirements file.  This option can be used multiple times.)�dest�action�default�metavar�helpz-yz--yes�yes�
store_truez2Don't ask for confirmation of uninstall deletions.)rrrr)�superr
�__init__Zcmd_optsZ
add_option�parserZinsert_option_group)�self�args�kw��	__class__��D/usr/lib/python3.8/site-packages/pip/_internal/commands/uninstall.pyrs$�	�zUninstallCommand.__init__c	Cs�|�|�}i}|D]&}t||jd�}|jr||t|j�<q|jD],}t|||d�D]}|jrR||t|j�<qRq@|s�tdt|jd���t	d|kd�|�
�D]&}|j|j|j
dkd�}|r�|��q�dS)	N)�isolated)�options�sessionzLYou must give at least one requirement to %(name)s (see "pip help %(name)s"))�nameZpip)Z
modifying_pipr)Zauto_confirm�verbose)Zget_default_sessionrZ
isolated_moder"rrrr�dictr	�valuesZ	uninstallr�	verbosityZcommit)	rr rr!Zreqs_to_uninstallr"Zreq�filenameZuninstall_pathsetrrr�run2sB
�
�

����zUninstallCommand.run)�__name__�
__module__�__qualname__�__doc__Zusagerr(�
__classcell__rrrrr
s
r
N)Z
__future__rZpip._vendor.packaging.utilsrZpip._internal.cli.base_commandrZpip._internal.cli.req_commandrZpip._internal.exceptionsrZpip._internal.reqrZpip._internal.req.constructorsrZpip._internal.utils.miscr	r
rrrr�<module>ssite-packages/pip/_internal/commands/__pycache__/show.cpython-38.pyc000064400000014265151446176770021502 0ustar00U

��.e��@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
mZddlmZe�e�ZGd	d
�d
e�Zdd�Zddd�ZdS)�)�absolute_importN)�
FeedParser)�
pkg_resources��canonicalize_name)�Command)�ERROR�SUCCESS)�write_outputcs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�ShowCommandzx
    Show information about one or more installed packages.

    The output is in RFC-compliant mail header format.
    z$
      %prog [options] <package> ...Tcs>tt|�j||�|jjddddddd�|j�d|j�dS)	Nz-fz--files�files�
store_trueFz7Show the full list of installed files for each package.)�dest�action�default�helpr)�superr�__init__Zcmd_optsZ
add_option�parserZinsert_option_group)�self�args�kw��	__class__��?/usr/lib/python3.8/site-packages/pip/_internal/commands/show.pyrs�zShowCommand.__init__cCs8|st�d�tS|}t|�}t||j|jd�s4tStS)Nz.ERROR: Please provide a package name or names.)�
list_files�verbose)�logger�warningr�search_packages_info�
print_resultsrrr	)rZoptionsr�query�resultsrrr�run*s
�zShowCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrr$�
__classcell__rrrrrs
rc#sTi�tjD]}|�t|j�<q
dd�|D�}t�fdd�t||�D��}|r^t�dd�|��dd�}�fdd�|D�D�]ԉ�j�j	�j
d	d����D�|�j�d
�}d}d}t�tj
��r��d��r��d�}d
d�|D�}	�fdd�|	D�}	�fdd�|	D�}��d��rn��d�}nP��d��rX��d�}	�fdd�|	D�}	�fdd�|	D�}��d��rn��d�}��d��r���d�}
|
|d<��d��rƈ�d�D]"}|���r�|��|d<�qƐq�t�}|�|�|��}
dD]}|
�|�||<�q�g}|��D](}|�d��r|�|td�d���q||d<|�rHt|�|d<|VqxdS)z�
    Gather details from installed distributions. Print distribution name,
    version, location, and installed files. Installed files requires a
    pip generated 'installed-files.txt' in the distributions '.egg-info'
    directory.
    cSsg|]}t|��qSrr)�.0�namerrr�
<listcomp>Bsz(search_packages_info.<locals>.<listcomp>csg|]\}}|�kr|�qSrr)r*r+�pkg��	installedrrr,DszPackage(s) not found: %s�, cst|���fdd�tjD�S)Ncs(g|] }�dd�|��D�kr|j�qS)cSsg|]}t|j��qSr)rr+)r*Zrequiredrrrr,NszSsearch_packages_info.<locals>.get_requiring_packages.<locals>.<listcomp>.<listcomp>)�requires�project_name�r*r-�Zcanonical_namerrr,Ks���zHsearch_packages_info.<locals>.get_requiring_packages.<locals>.<listcomp>)rr�working_set)Zpackage_namerr4r�get_requiring_packagesIs
�z4search_packages_info.<locals>.get_requiring_packagescsg|]}|�kr�|�qSrrr3r.rrr,RscSsg|]
}|j�qSr)r2)r*Zdeprrrr,Ws)r+�version�locationr1�required_byNZRECORDcSsg|]}|�d�d�qS)�,r)�split)r*�lrrrr,`scsg|]}tj��j|��qSr)�os�path�joinr8�r*�p��distrrr,ascsg|]}tj�|�j��qSr�r=r>�relpathr8r@rBrrr,bsZMETADATAzinstalled-files.txtcsg|]}tj��j|��qSr)r=r>r?Zegg_infor@rBrrr,jscsg|]}tj�|�j��qSrrDr@rBrrr,kszPKG-INFOzentry_points.txt�entry_pointsZ	INSTALLER�	installer)�metadata-version�summary�	home-page�author�author-email�licensezClassifier: �classifiersr)rr5rr2�sorted�ziprrr?r7r8r1�
isinstanceZDistInfoDistributionZhas_metadataZget_metadata_linesZget_metadata�striprZfeed�close�get�
splitlines�
startswith�append�len)r"rAZquery_namesZmissingr6�packageZ	file_listZmetadata�lines�pathsrF�lineZfeed_parserZ
pkg_info_dict�keyrNr)rCr/rr 7sl
�	�






r Fc		Cs�d}t|�D�]�\}}d}|dkr*td�td|�dd��td|�d	d��td
|�dd��td|�d
d��td|�dd��td|�dd��td|�dd��td|�dd��tdd�|�dg���tdd�|�dg���|�rdtd|�dd��td|�dd��td�|�d g�D]}td!|��q(td"�|�d#g�D]}td!|����qN|rtd$�|�d%g�D]}td!|����q|d%|krtd&�q|S)'zD
    Print the informations from installed distributions found.
    FTrz---zName: %sr+�zVersion: %sr7zSummary: %srIz
Home-page: %srJz
Author: %srKzAuthor-email: %srLzLicense: %srMzLocation: %sr8zRequires: %sr0r1zRequired-by: %sr9zMetadata-Version: %srHz
Installer: %srGzClassifiers:rNz  %sz
Entry-points:rFzFiles:rz!Cannot locate installed-files.txt)�	enumerater
rTr?rR)	Z
distributionsrrZresults_printed�irCZ
classifier�entryr\rrrr!�sB
�
r!)FF)Z
__future__rZloggingr=Zemail.parserrZpip._vendorrZpip._vendor.packaging.utilsrZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrr	Zpip._internal.utils.miscr
Z	getLoggerr%rrr r!rrrr�<module>s
#Xsite-packages/pip/_internal/commands/__pycache__/freeze.cpython-38.pyc000064400000005540151446176770021776 0ustar00U

��.e�
�@s|ddlmZddlZddlmZddlmZddlmZddl	m
Z
ddlmZddl
mZd	d
ddhZGd
d�de�ZdS)�)�absolute_importN)�
WheelCache)�
cmdoptions)�Command)�
FormatControl)�freeze)�stdlib_pkgsZpipZ
setuptoolsZ
distributeZwheelcs0eZdZdZdZdZ�fdd�Zdd�Z�ZS)�
FreezeCommandzx
    Output installed packages in requirements format.

    packages are listed in a case-insensitive sorted order.
    z
      %prog [options])�ext://sys.stderrr
c	s�tt|�j||�|jjddddgddd�|jjdd	d
dgddd�|jjd
dddddd�|jjdddddd�|j�t���|jjddddd�t�d�|jjddddd�|j	�
d|j�dS) Nz-rz
--requirement�requirements�append�filez}Use the order in the given requirements file and its comments when generating output. This option can be used multiple times.)�dest�action�default�metavar�helpz-fz--find-links�
find_linksZURLz<URL for finding packages, which will be added to the output.z-lz--local�local�
store_trueFzUIf in a virtualenv that has global access, do not output globally-installed packages.)rrrrz--user�userz,Only output packages installed in user-site.z--all�
freeze_allz,Do not skip these packages in the output: %sz, )rrrz--exclude-editable�exclude_editablez%Exclude editable package from output.r)�superr	�__init__Zcmd_optsZ
add_optionrZ	list_path�join�DEV_PKGS�parserZinsert_option_group)�self�args�kw��	__class__��A/usr/lib/python3.8/site-packages/pip/_internal/commands/freeze.pyrsd�	������zFreezeCommand.__init__cCs�tt�t��}t|j|�}tt�}|js2|�t�t�	|�t
|j|j|j
|j|j|j|j|||jd�
}z$tf|�D]}tj�|d�qtW5|��XdS)N)
ZrequirementrZ
local_onlyZ	user_only�pathsZ
skip_regex�isolated�wheel_cache�skipr�
)r�setr�	cache_dirrr�updaterrZcheck_list_path_option�dictrrrr�pathZskip_requirements_regexZ
isolated_moderZcleanupr�sys�stdout�write)rZoptionsrZformat_controlr'r(Z
freeze_kwargs�liner#r#r$�runMs,

�
zFreezeCommand.run)	�__name__�
__module__�__qualname__�__doc__ZusageZlog_streamsrr3�
__classcell__r#r#r!r$r	s
0r	)Z
__future__rr/Zpip._internal.cacherZpip._internal.clirZpip._internal.cli.base_commandrZ#pip._internal.models.format_controlrZpip._internal.operations.freezerZpip._internal.utils.compatrrr	r#r#r#r$�<module>ssite-packages/pip/_internal/commands/__pycache__/wheel.cpython-38.pyc000064400000011015151446176770021614 0ustar00U

��.e�@s�ddlmZddlZddlZddlmZddlmZddlm	Z	ddl
mZmZddl
mZddlmZdd	lmZdd
lmZddlmZer�ddlmZdd
lmZmZe�e�ZGdd�de	�ZdS)�)�absolute_importN)�
WheelCache)�
cmdoptions)�RequirementCommand)�CommandError�PreviousBuildDirError)�RequirementSet)�RequirementTracker)�
TempDirectory)�MYPY_CHECK_RUNNING)�WheelBuilder)�Values)�Any�Listcs,eZdZdZdZ�fdd�Zdd�Z�ZS)�WheelCommanda�
    Build Wheel archives for your requirements and dependencies.

    Wheel is a built-package format, and offers the advantage of not
    recompiling your software during every install. For more details, see the
    wheel docs: https://wheel.readthedocs.io/en/latest/

    Requirements: setuptools>=0.8, and wheel.

    'pip wheel' uses the bdist_wheel setuptools extension from the wheel
    package to build individual wheels.

    z�
      %prog [options] <requirement specifier> ...
      %prog [options] -r <requirements file> ...
      %prog [options] [-e] <vcs project url> ...
      %prog [options] [-e] <local project path> ...
      %prog [options] <archive url/path> ...csztt|�j||�|j}|jddddtjdd�|�t���|�t�	��|�t�
��|jddd	d
dd�|�t���|�t���|�t�
��|�t���|�t���|�t���|�t���|�t���|�t���|�t���|�t���|jd
dd
d	dd�|jddddd�|�t���|�t���t�tj|j�}|j�d|�|j�d|�dS)Nz-wz--wheel-dir�	wheel_dir�dirzLBuild wheels into <dir>, where the default is the current working directory.)�dest�metavar�default�helpz--build-option�
build_options�options�appendz9Extra arguments to be supplied to 'setup.py bdist_wheel'.)rr�actionrz--global-option�global_optionszZExtra global options to be supplied to the setup.py call before the 'bdist_wheel' command.)rrrrz--pre�
store_trueFzYInclude pre-release and development versions. By default, pip only finds stable versions.)rrrr)�superr�__init__�cmd_optsZ
add_option�os�curdirrZ	no_binaryZonly_binaryZ
prefer_binaryZno_build_isolation�
use_pep517Z
no_use_pep517ZconstraintsZeditable�requirements�src�ignore_requires_pythonZno_deps�	build_dirZprogress_bar�no_clean�require_hashesZmake_option_groupZindex_group�parserZinsert_option_group)�self�args�kwrZ
index_opts��	__class__��@/usr/lib/python3.8/site-packages/pip/_internal/commands/wheel.pyr3sh�����zWheelCommand.__init__cCszt�|�|jr tj�|j�|_tj�|j�|_|�|�}|�||�}|j	pP|j}t
|j|j�}t
���}t|j|dd���}t|jd�}	z�z�|�|	|||||�|j||||jd�}
|j|
|||||j|jd�}|�|	�t|
||jp�g|jp�g|j	d�}|�|	j���}
t |
�dk�r"t!d��Wnt"k
�rBd	|_	�YnXW5|j	�s`|	��|��XW5QRXW5QRXdS)
NZwheel)�deleteZkind)r()Ztemp_build_dirr�req_trackerZwheel_download_dir)�preparer�finder�sessionr�wheel_cacher%r")rrr'rz"Failed to build one or more wheelsT)#rZcheck_install_build_globalr&r �path�abspathZsrc_dirZget_default_sessionZ_build_package_finderr'r�	cache_dirZformat_controlr	r
rr(Z
cleanup_filesZcleanupZpopulate_requirement_setZmake_requirement_preparerrZ
make_resolverr%r"ZresolverrrZbuildr#�values�lenrr)r*rr+r5r4Zbuild_deleter6r2Z	directoryZrequirement_setr3Zresolver�wbZbuild_failuresr/r/r0�runqs|

�����	
���zWheelCommand.run)�__name__�
__module__�__qualname__�__doc__Zusagerr=�
__classcell__r/r/r-r0rs>r) Z
__future__rZloggingr Zpip._internal.cacherZpip._internal.clirZpip._internal.cli.req_commandrZpip._internal.exceptionsrrZpip._internal.reqrZpip._internal.req.req_trackerr	Zpip._internal.utils.temp_dirr
Zpip._internal.utils.typingrZpip._internal.wheelrZoptparser
�typingrrZ	getLoggerr>Zloggerrr/r/r/r0�<module>s 
site-packages/pip/_internal/commands/__pycache__/help.cpython-38.opt-1.pyc000064400000002242151446176770022401 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�absolute_import)�Command)�SUCCESS)�CommandErrorc@s eZdZdZdZdZdd�ZdS)�HelpCommandzShow help for commandsz
      %prog <command>Tc
Cs�ddlm}m}m}z|d}Wntk
r8tYSX||krt||�}d|g}|rf|�d|�td�|���||�}	|	j	�
�tS)Nr)�
commands_dict�create_command�get_similar_commandszunknown command "%s"zmaybe you meant "%s"z - )Zpip._internal.commandsrrr	�
IndexErrorr�appendr�join�parserZ
print_help)
�selfZoptions�argsrrr	Zcmd_nameZguess�msgZcommand�r�?/usr/lib/python3.8/site-packages/pip/_internal/commands/help.py�runs


zHelpCommand.runN)�__name__�
__module__�__qualname__�__doc__ZusageZignore_require_venvrrrrrrsrN)	Z
__future__rZpip._internal.cli.base_commandrZpip._internal.cli.status_codesrZpip._internal.exceptionsrrrrrr�<module>ssite-packages/pip/_internal/commands/__pycache__/__init__.cpython-38.pyc000064400000005444151446176770022260 0ustar00U

��.e��@s:dZddlmZddlZddlmZmZddlmZerPddl	m
Z
ddlmZedd	�Z
ed
e
ddd
�fde
ddd�fde
ddd�fde
ddd�fde
ddd�fde
dd d!�fd"e
d#d$d%�fd&e
d'd(d)�fd*e
d+d,d-�fd.e
d/d0d1�fd2e
d3d4d5�fd6e
d7d8d9�fd:e
d;d<d=�fd>e
d?d@dA�fg�ZdBdC�ZdDdE�ZdS)Fz%
Package containing all pip commands
�)�absolute_importN)�OrderedDict�
namedtuple)�MYPY_CHECK_RUNNING)�Any)�Command�CommandInfoz module_path, class_name, summaryZinstallzpip._internal.commands.installZInstallCommandzInstall packages.Zdownloadzpip._internal.commands.downloadZDownloadCommandzDownload packages.Z	uninstallz pip._internal.commands.uninstallZUninstallCommandzUninstall packages.Zfreezezpip._internal.commands.freezeZ
FreezeCommandz1Output installed packages in requirements format.�listzpip._internal.commands.listZListCommandzList installed packages.Zshowzpip._internal.commands.showZShowCommandz*Show information about installed packages.Zcheckzpip._internal.commands.checkZCheckCommandz7Verify installed packages have compatible dependencies.Zconfigz$pip._internal.commands.configurationZConfigurationCommandz&Manage local and global configuration.�searchzpip._internal.commands.searchZ
SearchCommandzSearch PyPI for packages.Zwheelzpip._internal.commands.wheelZWheelCommandz$Build wheels from your requirements.�hashzpip._internal.commands.hashZHashCommandz#Compute hashes of package archives.Z
completionz!pip._internal.commands.completionZCompletionCommandz-A helper command used for command completion.�debugzpip._internal.commands.debugZDebugCommandz&Show information useful for debugging.�helpzpip._internal.commands.helpZHelpCommandzShow help for commands.cKs:t|\}}}t�|�}t||�}|f||d�|��}|S)zF
    Create an instance of the Command class with the given name.
    )�name�summary)�
commands_dict�	importlib�
import_module�getattr)r�kwargsZmodule_path�
class_namer�moduleZ
command_classZcommand�r�C/usr/lib/python3.8/site-packages/pip/_internal/commands/__init__.py�create_commandZs


rcCs6ddlm}|��}||t���}|r.|dSdSdS)zCommand name auto-correct.r)�get_close_matchesFN)Zdifflibr�lowerr�keys)rrZclose_commandsrrr�get_similar_commandsgsr)�__doc__Z
__future__rr�collectionsrrZpip._internal.utils.typingr�typingrZpip._internal.cli.base_commandrrrrrrrrr�<module>s�

���������������<
site-packages/pip/_internal/commands/__init__.py000064400000007202151446176770015764 0ustar00"""
Package containing all pip commands
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import importlib
from collections import OrderedDict, namedtuple

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Any
    from pip._internal.cli.base_command import Command


CommandInfo = namedtuple('CommandInfo', 'module_path, class_name, summary')

# The ordering matters for help display.
#    Also, even though the module path starts with the same
# "pip._internal.commands" prefix in each case, we include the full path
# because it makes testing easier (specifically when modifying commands_dict
# in test setup / teardown by adding info for a FakeCommand class defined
# in a test-related module).
#    Finally, we need to pass an iterable of pairs here rather than a dict
# so that the ordering won't be lost when using Python 2.7.
commands_dict = OrderedDict([
    ('install', CommandInfo(
        'pip._internal.commands.install', 'InstallCommand',
        'Install packages.',
    )),
    ('download', CommandInfo(
        'pip._internal.commands.download', 'DownloadCommand',
        'Download packages.',
    )),
    ('uninstall', CommandInfo(
        'pip._internal.commands.uninstall', 'UninstallCommand',
        'Uninstall packages.',
    )),
    ('freeze', CommandInfo(
        'pip._internal.commands.freeze', 'FreezeCommand',
        'Output installed packages in requirements format.',
    )),
    ('list', CommandInfo(
        'pip._internal.commands.list', 'ListCommand',
        'List installed packages.',
    )),
    ('show', CommandInfo(
        'pip._internal.commands.show', 'ShowCommand',
        'Show information about installed packages.',
    )),
    ('check', CommandInfo(
        'pip._internal.commands.check', 'CheckCommand',
        'Verify installed packages have compatible dependencies.',
    )),
    ('config', CommandInfo(
        'pip._internal.commands.configuration', 'ConfigurationCommand',
        'Manage local and global configuration.',
    )),
    ('search', CommandInfo(
        'pip._internal.commands.search', 'SearchCommand',
        'Search PyPI for packages.',
    )),
    ('wheel', CommandInfo(
        'pip._internal.commands.wheel', 'WheelCommand',
        'Build wheels from your requirements.',
    )),
    ('hash', CommandInfo(
        'pip._internal.commands.hash', 'HashCommand',
        'Compute hashes of package archives.',
    )),
    ('completion', CommandInfo(
        'pip._internal.commands.completion', 'CompletionCommand',
        'A helper command used for command completion.',
    )),
    ('debug', CommandInfo(
        'pip._internal.commands.debug', 'DebugCommand',
        'Show information useful for debugging.',
    )),
    ('help', CommandInfo(
        'pip._internal.commands.help', 'HelpCommand',
        'Show help for commands.',
    )),
])  # type: OrderedDict[str, CommandInfo]


def create_command(name, **kwargs):
    # type: (str, **Any) -> Command
    """
    Create an instance of the Command class with the given name.
    """
    module_path, class_name, summary = commands_dict[name]
    module = importlib.import_module(module_path)
    command_class = getattr(module, class_name)
    command = command_class(name=name, summary=summary, **kwargs)

    return command


def get_similar_commands(name):
    """Command name auto-correct."""
    from difflib import get_close_matches

    name = name.lower()

    close_commands = get_close_matches(name, commands_dict.keys())

    if close_commands:
        return close_commands[0]
    else:
        return False
site-packages/pip/_internal/commands/debug.py000064400000006502151446176770015315 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import locale
import logging
import sys

from pip._internal.cli import cmdoptions
from pip._internal.cli.base_command import Command
from pip._internal.cli.cmdoptions import make_target_python
from pip._internal.cli.status_codes import SUCCESS
from pip._internal.utils.logging import indent_log
from pip._internal.utils.misc import get_pip_version
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.wheel import format_tag

if MYPY_CHECK_RUNNING:
    from typing import Any, List
    from optparse import Values

logger = logging.getLogger(__name__)


def show_value(name, value):
    # type: (str, str) -> None
    logger.info('{}: {}'.format(name, value))


def show_sys_implementation():
    # type: () -> None
    logger.info('sys.implementation:')
    if hasattr(sys, 'implementation'):
        implementation = sys.implementation  # type: ignore
        implementation_name = implementation.name
    else:
        implementation_name = ''

    with indent_log():
        show_value('name', implementation_name)


def show_tags(options):
    # type: (Values) -> None
    tag_limit = 10

    target_python = make_target_python(options)
    tags = target_python.get_tags()

    # Display the target options that were explicitly provided.
    formatted_target = target_python.format_given()
    suffix = ''
    if formatted_target:
        suffix = ' (target: {})'.format(formatted_target)

    msg = 'Compatible tags: {}{}'.format(len(tags), suffix)
    logger.info(msg)

    if options.verbose < 1 and len(tags) > tag_limit:
        tags_limited = True
        tags = tags[:tag_limit]
    else:
        tags_limited = False

    with indent_log():
        for tag in tags:
            logger.info(format_tag(tag))

        if tags_limited:
            msg = (
                '...\n'
                '[First {tag_limit} tags shown. Pass --verbose to show all.]'
            ).format(tag_limit=tag_limit)
            logger.info(msg)


class DebugCommand(Command):
    """
    Display debug information.
    """

    usage = """
      %prog <options>"""
    ignore_require_venv = True

    def __init__(self, *args, **kw):
        super(DebugCommand, self).__init__(*args, **kw)

        cmd_opts = self.cmd_opts
        cmdoptions.add_target_python_options(cmd_opts)
        self.parser.insert_option_group(0, cmd_opts)

    def run(self, options, args):
        # type: (Values, List[Any]) -> int
        logger.warning(
            "This command is only meant for debugging. "
            "Do not use this with automation for parsing and getting these "
            "details, since the output and options of this command may "
            "change without notice."
        )
        show_value('pip version', get_pip_version())
        show_value('sys.version', sys.version)
        show_value('sys.executable', sys.executable)
        show_value('sys.getdefaultencoding', sys.getdefaultencoding())
        show_value('sys.getfilesystemencoding', sys.getfilesystemencoding())
        show_value(
            'locale.getpreferredencoding', locale.getpreferredencoding(),
        )
        show_value('sys.platform', sys.platform)
        show_sys_implementation()

        show_tags(options)

        return SUCCESS
site-packages/pip/_internal/commands/download.py000064400000012711151446176770016035 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os

from pip._internal.cli import cmdoptions
from pip._internal.cli.cmdoptions import make_target_python
from pip._internal.cli.req_command import RequirementCommand
from pip._internal.req import RequirementSet
from pip._internal.req.req_tracker import RequirementTracker
from pip._internal.utils.filesystem import check_path_owner
from pip._internal.utils.misc import ensure_dir, normalize_path, write_output
from pip._internal.utils.temp_dir import TempDirectory

logger = logging.getLogger(__name__)


class DownloadCommand(RequirementCommand):
    """
    Download packages from:

    - PyPI (and other indexes) using requirement specifiers.
    - VCS project urls.
    - Local project directories.
    - Local or remote source archives.

    pip also supports downloading from "requirements files", which provide
    an easy way to specify a whole environment to be downloaded.
    """

    usage = """
      %prog [options] <requirement specifier> [package-index-options] ...
      %prog [options] -r <requirements file> [package-index-options] ...
      %prog [options] <vcs project url> ...
      %prog [options] <local project path> ...
      %prog [options] <archive url/path> ..."""

    def __init__(self, *args, **kw):
        super(DownloadCommand, self).__init__(*args, **kw)

        cmd_opts = self.cmd_opts

        cmd_opts.add_option(cmdoptions.constraints())
        cmd_opts.add_option(cmdoptions.requirements())
        cmd_opts.add_option(cmdoptions.build_dir())
        cmd_opts.add_option(cmdoptions.no_deps())
        cmd_opts.add_option(cmdoptions.global_options())
        cmd_opts.add_option(cmdoptions.no_binary())
        cmd_opts.add_option(cmdoptions.only_binary())
        cmd_opts.add_option(cmdoptions.prefer_binary())
        cmd_opts.add_option(cmdoptions.src())
        cmd_opts.add_option(cmdoptions.pre())
        cmd_opts.add_option(cmdoptions.no_clean())
        cmd_opts.add_option(cmdoptions.require_hashes())
        cmd_opts.add_option(cmdoptions.progress_bar())
        cmd_opts.add_option(cmdoptions.no_build_isolation())
        cmd_opts.add_option(cmdoptions.use_pep517())
        cmd_opts.add_option(cmdoptions.no_use_pep517())

        cmd_opts.add_option(
            '-d', '--dest', '--destination-dir', '--destination-directory',
            dest='download_dir',
            metavar='dir',
            default=os.curdir,
            help=("Download packages into <dir>."),
        )

        cmdoptions.add_target_python_options(cmd_opts)

        index_opts = cmdoptions.make_option_group(
            cmdoptions.index_group,
            self.parser,
        )

        self.parser.insert_option_group(0, index_opts)
        self.parser.insert_option_group(0, cmd_opts)

    def run(self, options, args):
        options.ignore_installed = True
        # editable doesn't really make sense for `pip download`, but the bowels
        # of the RequirementSet code require that property.
        options.editables = []

        cmdoptions.check_dist_restriction(options)

        options.src_dir = os.path.abspath(options.src_dir)
        options.download_dir = normalize_path(options.download_dir)

        ensure_dir(options.download_dir)

        session = self.get_default_session(options)

        target_python = make_target_python(options)
        finder = self._build_package_finder(
            options=options,
            session=session,
            target_python=target_python,
        )
        build_delete = (not (options.no_clean or options.build_dir))
        if options.cache_dir and not check_path_owner(options.cache_dir):
            logger.warning(
                "The directory '%s' or its parent directory is not owned "
                "by the current user and caching wheels has been "
                "disabled. check the permissions and owner of that "
                "directory. If executing pip with sudo, you may want "
                "sudo's -H flag.",
                options.cache_dir,
            )
            options.cache_dir = None

        with RequirementTracker() as req_tracker, TempDirectory(
            options.build_dir, delete=build_delete, kind="download"
        ) as directory:

            requirement_set = RequirementSet(
                require_hashes=options.require_hashes,
            )
            self.populate_requirement_set(
                requirement_set,
                args,
                options,
                finder,
                session,
                None
            )

            preparer = self.make_requirement_preparer(
                temp_build_dir=directory,
                options=options,
                req_tracker=req_tracker,
                download_dir=options.download_dir,
            )

            resolver = self.make_resolver(
                preparer=preparer,
                finder=finder,
                session=session,
                options=options,
                py_version_info=options.python_version,
            )
            resolver.resolve(requirement_set)

            downloaded = ' '.join([
                req.name for req in requirement_set.successfully_downloaded
            ])
            if downloaded:
                write_output('Successfully downloaded %s', downloaded)

            # Clean up
            if not options.no_clean:
                requirement_set.cleanup_files()

        return requirement_set
site-packages/pip/_internal/commands/configuration.py000064400000016072151446176770017101 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import logging
import os
import subprocess

from pip._internal.cli.base_command import Command
from pip._internal.cli.status_codes import ERROR, SUCCESS
from pip._internal.configuration import (
    Configuration,
    get_configuration_files,
    kinds,
)
from pip._internal.exceptions import PipError
from pip._internal.utils.misc import get_prog, write_output

logger = logging.getLogger(__name__)


class ConfigurationCommand(Command):
    """Manage local and global configuration.

        Subcommands:

        list: List the active configuration (or from the file specified)
        edit: Edit the configuration file in an editor
        get: Get the value associated with name
        set: Set the name=value
        unset: Unset the value associated with name

        If none of --user, --global and --site are passed, a virtual
        environment configuration file is used if one is active and the file
        exists. Otherwise, all modifications happen on the to the user file by
        default.
    """

    ignore_require_venv = True
    usage = """
        %prog [<file-option>] list
        %prog [<file-option>] [--editor <editor-path>] edit

        %prog [<file-option>] get name
        %prog [<file-option>] set name value
        %prog [<file-option>] unset name
    """

    def __init__(self, *args, **kwargs):
        super(ConfigurationCommand, self).__init__(*args, **kwargs)

        self.configuration = None

        self.cmd_opts.add_option(
            '--editor',
            dest='editor',
            action='store',
            default=None,
            help=(
                'Editor to use to edit the file. Uses VISUAL or EDITOR '
                'environment variables if not provided.'
            )
        )

        self.cmd_opts.add_option(
            '--global',
            dest='global_file',
            action='store_true',
            default=False,
            help='Use the system-wide configuration file only'
        )

        self.cmd_opts.add_option(
            '--user',
            dest='user_file',
            action='store_true',
            default=False,
            help='Use the user configuration file only'
        )

        self.cmd_opts.add_option(
            '--site',
            dest='site_file',
            action='store_true',
            default=False,
            help='Use the current environment configuration file only'
        )

        self.parser.insert_option_group(0, self.cmd_opts)

    def run(self, options, args):
        handlers = {
            "list": self.list_values,
            "edit": self.open_in_editor,
            "get": self.get_name,
            "set": self.set_name_value,
            "unset": self.unset_name
        }

        # Determine action
        if not args or args[0] not in handlers:
            logger.error("Need an action ({}) to perform.".format(
                ", ".join(sorted(handlers)))
            )
            return ERROR

        action = args[0]

        # Determine which configuration files are to be loaded
        #    Depends on whether the command is modifying.
        try:
            load_only = self._determine_file(
                options, need_value=(action in ["get", "set", "unset", "edit"])
            )
        except PipError as e:
            logger.error(e.args[0])
            return ERROR

        # Load a new configuration
        self.configuration = Configuration(
            isolated=options.isolated_mode, load_only=load_only
        )
        self.configuration.load()

        # Error handling happens here, not in the action-handlers.
        try:
            handlers[action](options, args[1:])
        except PipError as e:
            logger.error(e.args[0])
            return ERROR

        return SUCCESS

    def _determine_file(self, options, need_value):
        file_options = [key for key, value in (
            (kinds.USER, options.user_file),
            (kinds.GLOBAL, options.global_file),
            (kinds.SITE, options.site_file),
        ) if value]

        if not file_options:
            if not need_value:
                return None
            # Default to user, unless there's a site file.
            elif any(
                os.path.exists(site_config_file)
                for site_config_file in get_configuration_files()[kinds.SITE]
            ):
                return kinds.SITE
            else:
                return kinds.USER
        elif len(file_options) == 1:
            return file_options[0]

        raise PipError(
            "Need exactly one file to operate upon "
            "(--user, --site, --global) to perform."
        )

    def list_values(self, options, args):
        self._get_n_args(args, "list", n=0)

        for key, value in sorted(self.configuration.items()):
            write_output("%s=%r", key, value)

    def get_name(self, options, args):
        key = self._get_n_args(args, "get [name]", n=1)
        value = self.configuration.get_value(key)

        write_output("%s", value)

    def set_name_value(self, options, args):
        key, value = self._get_n_args(args, "set [name] [value]", n=2)
        self.configuration.set_value(key, value)

        self._save_configuration()

    def unset_name(self, options, args):
        key = self._get_n_args(args, "unset [name]", n=1)
        self.configuration.unset_value(key)

        self._save_configuration()

    def open_in_editor(self, options, args):
        editor = self._determine_editor(options)

        fname = self.configuration.get_file_to_edit()
        if fname is None:
            raise PipError("Could not determine appropriate file.")

        try:
            subprocess.check_call([editor, fname])
        except subprocess.CalledProcessError as e:
            raise PipError(
                "Editor Subprocess exited with exit code {}"
                .format(e.returncode)
            )

    def _get_n_args(self, args, example, n):
        """Helper to make sure the command got the right number of arguments
        """
        if len(args) != n:
            msg = (
                'Got unexpected number of arguments, expected {}. '
                '(example: "{} config {}")'
            ).format(n, get_prog(), example)
            raise PipError(msg)

        if n == 1:
            return args[0]
        else:
            return args

    def _save_configuration(self):
        # We successfully ran a modifying command. Need to save the
        # configuration.
        try:
            self.configuration.save()
        except Exception:
            logger.error(
                "Unable to save configuration. Please report this as a bug.",
                exc_info=1
            )
            raise PipError("Internal Error.")

    def _determine_editor(self, options):
        if options.editor is not None:
            return options.editor
        elif "VISUAL" in os.environ:
            return os.environ["VISUAL"]
        elif "EDITOR" in os.environ:
            return os.environ["EDITOR"]
        else:
            raise PipError("Could not determine editor to use.")
site-packages/pip/_internal/commands/check.py000064400000002741151446176770015305 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import logging

from pip._internal.cli.base_command import Command
from pip._internal.operations.check import (
    check_package_set,
    create_package_set_from_installed,
)
from pip._internal.utils.misc import write_output

logger = logging.getLogger(__name__)


class CheckCommand(Command):
    """Verify installed packages have compatible dependencies."""

    usage = """
      %prog [options]"""

    def run(self, options, args):
        package_set, parsing_probs = create_package_set_from_installed()
        missing, conflicting = check_package_set(package_set)

        for project_name in missing:
            version = package_set[project_name].version
            for dependency in missing[project_name]:
                write_output(
                    "%s %s requires %s, which is not installed.",
                    project_name, version, dependency[0],
                )

        for project_name in conflicting:
            version = package_set[project_name].version
            for dep_name, dep_version, req in conflicting[project_name]:
                write_output(
                    "%s %s has requirement %s, but you have %s %s.",
                    project_name, version, req, dep_name, dep_version,
                )

        if missing or conflicting or parsing_probs:
            return 1
        else:
            write_output("No broken requirements found.")
site-packages/pip/_internal/commands/show.py000064400000015210151446176770015203 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os
from email.parser import FeedParser

from pip._vendor import pkg_resources
from pip._vendor.packaging.utils import canonicalize_name

from pip._internal.cli.base_command import Command
from pip._internal.cli.status_codes import ERROR, SUCCESS
from pip._internal.utils.misc import write_output

logger = logging.getLogger(__name__)


class ShowCommand(Command):
    """
    Show information about one or more installed packages.

    The output is in RFC-compliant mail header format.
    """

    usage = """
      %prog [options] <package> ..."""
    ignore_require_venv = True

    def __init__(self, *args, **kw):
        super(ShowCommand, self).__init__(*args, **kw)
        self.cmd_opts.add_option(
            '-f', '--files',
            dest='files',
            action='store_true',
            default=False,
            help='Show the full list of installed files for each package.')

        self.parser.insert_option_group(0, self.cmd_opts)

    def run(self, options, args):
        if not args:
            logger.warning('ERROR: Please provide a package name or names.')
            return ERROR
        query = args

        results = search_packages_info(query)
        if not print_results(
                results, list_files=options.files, verbose=options.verbose):
            return ERROR
        return SUCCESS


def search_packages_info(query):
    """
    Gather details from installed distributions. Print distribution name,
    version, location, and installed files. Installed files requires a
    pip generated 'installed-files.txt' in the distributions '.egg-info'
    directory.
    """
    installed = {}
    for p in pkg_resources.working_set:
        installed[canonicalize_name(p.project_name)] = p

    query_names = [canonicalize_name(name) for name in query]
    missing = sorted(
        [name for name, pkg in zip(query, query_names) if pkg not in installed]
    )
    if missing:
        logger.warning('Package(s) not found: %s', ', '.join(missing))

    def get_requiring_packages(package_name):
        canonical_name = canonicalize_name(package_name)
        return [
            pkg.project_name for pkg in pkg_resources.working_set
            if canonical_name in
               [canonicalize_name(required.name) for required in
                pkg.requires()]
        ]

    for dist in [installed[pkg] for pkg in query_names if pkg in installed]:
        package = {
            'name': dist.project_name,
            'version': dist.version,
            'location': dist.location,
            'requires': [dep.project_name for dep in dist.requires()],
            'required_by': get_requiring_packages(dist.project_name)
        }
        file_list = None
        metadata = None
        if isinstance(dist, pkg_resources.DistInfoDistribution):
            # RECORDs should be part of .dist-info metadatas
            if dist.has_metadata('RECORD'):
                lines = dist.get_metadata_lines('RECORD')
                paths = [l.split(',')[0] for l in lines]
                paths = [os.path.join(dist.location, p) for p in paths]
                file_list = [os.path.relpath(p, dist.location) for p in paths]

            if dist.has_metadata('METADATA'):
                metadata = dist.get_metadata('METADATA')
        else:
            # Otherwise use pip's log for .egg-info's
            if dist.has_metadata('installed-files.txt'):
                paths = dist.get_metadata_lines('installed-files.txt')
                paths = [os.path.join(dist.egg_info, p) for p in paths]
                file_list = [os.path.relpath(p, dist.location) for p in paths]

            if dist.has_metadata('PKG-INFO'):
                metadata = dist.get_metadata('PKG-INFO')

        if dist.has_metadata('entry_points.txt'):
            entry_points = dist.get_metadata_lines('entry_points.txt')
            package['entry_points'] = entry_points

        if dist.has_metadata('INSTALLER'):
            for line in dist.get_metadata_lines('INSTALLER'):
                if line.strip():
                    package['installer'] = line.strip()
                    break

        # @todo: Should pkg_resources.Distribution have a
        # `get_pkg_info` method?
        feed_parser = FeedParser()
        feed_parser.feed(metadata)
        pkg_info_dict = feed_parser.close()
        for key in ('metadata-version', 'summary',
                    'home-page', 'author', 'author-email', 'license'):
            package[key] = pkg_info_dict.get(key)

        # It looks like FeedParser cannot deal with repeated headers
        classifiers = []
        for line in metadata.splitlines():
            if line.startswith('Classifier: '):
                classifiers.append(line[len('Classifier: '):])
        package['classifiers'] = classifiers

        if file_list:
            package['files'] = sorted(file_list)
        yield package


def print_results(distributions, list_files=False, verbose=False):
    """
    Print the informations from installed distributions found.
    """
    results_printed = False
    for i, dist in enumerate(distributions):
        results_printed = True
        if i > 0:
            write_output("---")

        write_output("Name: %s", dist.get('name', ''))
        write_output("Version: %s", dist.get('version', ''))
        write_output("Summary: %s", dist.get('summary', ''))
        write_output("Home-page: %s", dist.get('home-page', ''))
        write_output("Author: %s", dist.get('author', ''))
        write_output("Author-email: %s", dist.get('author-email', ''))
        write_output("License: %s", dist.get('license', ''))
        write_output("Location: %s", dist.get('location', ''))
        write_output("Requires: %s", ', '.join(dist.get('requires', [])))
        write_output("Required-by: %s", ', '.join(dist.get('required_by', [])))

        if verbose:
            write_output("Metadata-Version: %s",
                         dist.get('metadata-version', ''))
            write_output("Installer: %s", dist.get('installer', ''))
            write_output("Classifiers:")
            for classifier in dist.get('classifiers', []):
                write_output("  %s", classifier)
            write_output("Entry-points:")
            for entry in dist.get('entry_points', []):
                write_output("  %s", entry.strip())
        if list_files:
            write_output("Files:")
            for line in dist.get('files', []):
                write_output("  %s", line.strip())
            if "files" not in dist:
                write_output("Cannot locate installed-files.txt")
    return results_printed
site-packages/pip/_internal/commands/freeze.py000064400000006610151446176770015507 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import sys

from pip._internal.cache import WheelCache
from pip._internal.cli import cmdoptions
from pip._internal.cli.base_command import Command
from pip._internal.models.format_control import FormatControl
from pip._internal.operations.freeze import freeze
from pip._internal.utils.compat import stdlib_pkgs

DEV_PKGS = {'pip', 'setuptools', 'distribute', 'wheel'}


class FreezeCommand(Command):
    """
    Output installed packages in requirements format.

    packages are listed in a case-insensitive sorted order.
    """

    usage = """
      %prog [options]"""
    log_streams = ("ext://sys.stderr", "ext://sys.stderr")

    def __init__(self, *args, **kw):
        super(FreezeCommand, self).__init__(*args, **kw)

        self.cmd_opts.add_option(
            '-r', '--requirement',
            dest='requirements',
            action='append',
            default=[],
            metavar='file',
            help="Use the order in the given requirements file and its "
                 "comments when generating output. This option can be "
                 "used multiple times.")
        self.cmd_opts.add_option(
            '-f', '--find-links',
            dest='find_links',
            action='append',
            default=[],
            metavar='URL',
            help='URL for finding packages, which will be added to the '
                 'output.')
        self.cmd_opts.add_option(
            '-l', '--local',
            dest='local',
            action='store_true',
            default=False,
            help='If in a virtualenv that has global access, do not output '
                 'globally-installed packages.')
        self.cmd_opts.add_option(
            '--user',
            dest='user',
            action='store_true',
            default=False,
            help='Only output packages installed in user-site.')
        self.cmd_opts.add_option(cmdoptions.list_path())
        self.cmd_opts.add_option(
            '--all',
            dest='freeze_all',
            action='store_true',
            help='Do not skip these packages in the output:'
                 ' %s' % ', '.join(DEV_PKGS))
        self.cmd_opts.add_option(
            '--exclude-editable',
            dest='exclude_editable',
            action='store_true',
            help='Exclude editable package from output.')

        self.parser.insert_option_group(0, self.cmd_opts)

    def run(self, options, args):
        format_control = FormatControl(set(), set())
        wheel_cache = WheelCache(options.cache_dir, format_control)
        skip = set(stdlib_pkgs)
        if not options.freeze_all:
            skip.update(DEV_PKGS)

        cmdoptions.check_list_path_option(options)

        freeze_kwargs = dict(
            requirement=options.requirements,
            find_links=options.find_links,
            local_only=options.local,
            user_only=options.user,
            paths=options.path,
            skip_regex=options.skip_requirements_regex,
            isolated=options.isolated_mode,
            wheel_cache=wheel_cache,
            skip=skip,
            exclude_editable=options.exclude_editable,
        )

        try:
            for line in freeze(**freeze_kwargs):
                sys.stdout.write(line + '\n')
        finally:
            wheel_cache.cleanup()
site-packages/pip/_internal/pyproject.py000064400000014532151446176770014447 0ustar00from __future__ import absolute_import

import io
import os
import sys

from pip._vendor import pytoml, six

from pip._internal.exceptions import InstallationError
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Any, Tuple, Optional, List


def _is_list_of_str(obj):
    # type: (Any) -> bool
    return (
        isinstance(obj, list) and
        all(isinstance(item, six.string_types) for item in obj)
    )


def make_pyproject_path(unpacked_source_directory):
    # type: (str) -> str
    path = os.path.join(unpacked_source_directory, 'pyproject.toml')

    # Python2 __file__ should not be unicode
    if six.PY2 and isinstance(path, six.text_type):
        path = path.encode(sys.getfilesystemencoding())

    return path


def load_pyproject_toml(
    use_pep517,  # type: Optional[bool]
    pyproject_toml,  # type: str
    setup_py,  # type: str
    req_name  # type: str
):
    # type: (...) -> Optional[Tuple[List[str], str, List[str]]]
    """Load the pyproject.toml file.

    Parameters:
        use_pep517 - Has the user requested PEP 517 processing? None
                     means the user hasn't explicitly specified.
        pyproject_toml - Location of the project's pyproject.toml file
        setup_py - Location of the project's setup.py file
        req_name - The name of the requirement we're processing (for
                   error reporting)

    Returns:
        None if we should use the legacy code path, otherwise a tuple
        (
            requirements from pyproject.toml,
            name of PEP 517 backend,
            requirements we should check are installed after setting
                up the build environment
        )
    """
    has_pyproject = os.path.isfile(pyproject_toml)
    has_setup = os.path.isfile(setup_py)

    if has_pyproject:
        with io.open(pyproject_toml, encoding="utf-8") as f:
            pp_toml = pytoml.load(f)
        build_system = pp_toml.get("build-system")
    else:
        build_system = None

    # The following cases must use PEP 517
    # We check for use_pep517 being non-None and falsey because that means
    # the user explicitly requested --no-use-pep517.  The value 0 as
    # opposed to False can occur when the value is provided via an
    # environment variable or config file option (due to the quirk of
    # strtobool() returning an integer in pip's configuration code).
    if has_pyproject and not has_setup:
        if use_pep517 is not None and not use_pep517:
            raise InstallationError(
                "Disabling PEP 517 processing is invalid: "
                "project does not have a setup.py"
            )
        use_pep517 = True
    elif build_system and "build-backend" in build_system:
        if use_pep517 is not None and not use_pep517:
            raise InstallationError(
                "Disabling PEP 517 processing is invalid: "
                "project specifies a build backend of {} "
                "in pyproject.toml".format(
                    build_system["build-backend"]
                )
            )
        use_pep517 = True

    # If we haven't worked out whether to use PEP 517 yet,
    # and the user hasn't explicitly stated a preference,
    # we do so if the project has a pyproject.toml file.
    elif use_pep517 is None:
        use_pep517 = has_pyproject

    # At this point, we know whether we're going to use PEP 517.
    assert use_pep517 is not None

    # If we're using the legacy code path, there is nothing further
    # for us to do here.
    if not use_pep517:
        return None

    if build_system is None:
        # Either the user has a pyproject.toml with no build-system
        # section, or the user has no pyproject.toml, but has opted in
        # explicitly via --use-pep517.
        # In the absence of any explicit backend specification, we
        # assume the setuptools backend that most closely emulates the
        # traditional direct setup.py execution, and require wheel and
        # a version of setuptools that supports that backend.

        build_system = {
            "requires": ["setuptools>=40.8.0", "wheel"],
            "build-backend": "setuptools.build_meta:__legacy__",
        }

    # If we're using PEP 517, we have build system information (either
    # from pyproject.toml, or defaulted by the code above).
    # Note that at this point, we do not know if the user has actually
    # specified a backend, though.
    assert build_system is not None

    # Ensure that the build-system section in pyproject.toml conforms
    # to PEP 518.
    error_template = (
        "{package} has a pyproject.toml file that does not comply "
        "with PEP 518: {reason}"
    )

    # Specifying the build-system table but not the requires key is invalid
    if "requires" not in build_system:
        raise InstallationError(
            error_template.format(package=req_name, reason=(
                "it has a 'build-system' table but not "
                "'build-system.requires' which is mandatory in the table"
            ))
        )

    # Error out if requires is not a list of strings
    requires = build_system["requires"]
    if not _is_list_of_str(requires):
        raise InstallationError(error_template.format(
            package=req_name,
            reason="'build-system.requires' is not a list of strings.",
        ))

    backend = build_system.get("build-backend")
    check = []  # type: List[str]
    if backend is None:
        # If the user didn't specify a backend, we assume they want to use
        # the setuptools backend. But we can't be sure they have included
        # a version of setuptools which supplies the backend, or wheel
        # (which is needed by the backend) in their requirements. So we
        # make a note to check that those requirements are present once
        # we have set up the environment.
        # This is quite a lot of work to check for a very specific case. But
        # the problem is, that case is potentially quite common - projects that
        # adopted PEP 518 early for the ability to specify requirements to
        # execute setup.py, but never considered needing to mention the build
        # tools themselves. The original PEP 518 code had a similar check (but
        # implemented in a different way).
        backend = "setuptools.build_meta:__legacy__"
        check = ["setuptools>=40.8.0", "wheel"]

    return (requires, backend, check)
site-packages/pip/_internal/pep425tags.py000064400000037105151446176770014327 0ustar00"""Generate and work with PEP 425 Compatibility Tags."""
from __future__ import absolute_import

import distutils.util
import logging
import platform
import re
import sys
import sysconfig
import warnings
from collections import OrderedDict

import pip._internal.utils.glibc
from pip._internal.utils.compat import get_extension_suffixes
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import (
        Tuple, Callable, List, Optional, Union, Dict, Set
    )

    Pep425Tag = Tuple[str, str, str]

logger = logging.getLogger(__name__)

_osx_arch_pat = re.compile(r'(.+)_(\d+)_(\d+)_(.+)')


def get_config_var(var):
    # type: (str) -> Optional[str]
    try:
        return sysconfig.get_config_var(var)
    except IOError as e:  # Issue #1074
        warnings.warn("{}".format(e), RuntimeWarning)
        return None


def get_abbr_impl():
    # type: () -> str
    """Return abbreviated implementation name."""
    if hasattr(sys, 'pypy_version_info'):
        pyimpl = 'pp'
    elif sys.platform.startswith('java'):
        pyimpl = 'jy'
    elif sys.platform == 'cli':
        pyimpl = 'ip'
    else:
        pyimpl = 'cp'
    return pyimpl


def version_info_to_nodot(version_info):
    # type: (Tuple[int, ...]) -> str
    # Only use up to the first two numbers.
    return ''.join(map(str, version_info[:2]))


def get_impl_ver():
    # type: () -> str
    """Return implementation version."""
    impl_ver = get_config_var("py_version_nodot")
    if not impl_ver or get_abbr_impl() == 'pp':
        impl_ver = ''.join(map(str, get_impl_version_info()))
    return impl_ver


def get_impl_version_info():
    # type: () -> Tuple[int, ...]
    """Return sys.version_info-like tuple for use in decrementing the minor
    version."""
    if get_abbr_impl() == 'pp':
        # as per https://github.com/pypa/pip/issues/2882
        # attrs exist only on pypy
        return (sys.version_info[0],
                sys.pypy_version_info.major,  # type: ignore
                sys.pypy_version_info.minor)  # type: ignore
    else:
        return sys.version_info[0], sys.version_info[1]


def get_impl_tag():
    # type: () -> str
    """
    Returns the Tag for this specific implementation.
    """
    return "{}{}".format(get_abbr_impl(), get_impl_ver())


def get_flag(var, fallback, expected=True, warn=True):
    # type: (str, Callable[..., bool], Union[bool, int], bool) -> bool
    """Use a fallback method for determining SOABI flags if the needed config
    var is unset or unavailable."""
    val = get_config_var(var)
    if val is None:
        if warn:
            logger.debug("Config variable '%s' is unset, Python ABI tag may "
                         "be incorrect", var)
        return fallback()
    return val == expected


def get_abi_tag():
    # type: () -> Optional[str]
    """Return the ABI tag based on SOABI (if available) or emulate SOABI
    (CPython 2, PyPy)."""
    soabi = get_config_var('SOABI')
    impl = get_abbr_impl()
    abi = None  # type: Optional[str]

    if not soabi and impl in {'cp', 'pp'} and hasattr(sys, 'maxunicode'):
        d = ''
        m = ''
        u = ''
        is_cpython = (impl == 'cp')
        if get_flag(
                'Py_DEBUG', lambda: hasattr(sys, 'gettotalrefcount'),
                warn=is_cpython):
            d = 'd'
        if sys.version_info < (3, 8) and get_flag(
                'WITH_PYMALLOC', lambda: is_cpython, warn=is_cpython):
            m = 'm'
        if sys.version_info < (3, 3) and get_flag(
                'Py_UNICODE_SIZE', lambda: sys.maxunicode == 0x10ffff,
                expected=4, warn=is_cpython):
            u = 'u'
        abi = '%s%s%s%s%s' % (impl, get_impl_ver(), d, m, u)
    elif soabi and soabi.startswith('cpython-'):
        abi = 'cp' + soabi.split('-')[1]
    elif soabi:
        abi = soabi.replace('.', '_').replace('-', '_')

    return abi


def _is_running_32bit():
    # type: () -> bool
    return sys.maxsize == 2147483647


def get_platform():
    # type: () -> str
    """Return our platform name 'win32', 'linux_x86_64'"""
    if sys.platform == 'darwin':
        # distutils.util.get_platform() returns the release based on the value
        # of MACOSX_DEPLOYMENT_TARGET on which Python was built, which may
        # be significantly older than the user's current machine.
        release, _, machine = platform.mac_ver()
        split_ver = release.split('.')

        if machine == "x86_64" and _is_running_32bit():
            machine = "i386"
        elif machine == "ppc64" and _is_running_32bit():
            machine = "ppc"

        return 'macosx_{}_{}_{}'.format(split_ver[0], split_ver[1], machine)

    # XXX remove distutils dependency
    result = distutils.util.get_platform().replace('.', '_').replace('-', '_')
    if result == "linux_x86_64" and _is_running_32bit():
        # 32 bit Python program (running on a 64 bit Linux): pip should only
        # install and run 32 bit compiled extensions in that case.
        result = "linux_i686"

    return result


def is_linux_armhf():
    # type: () -> bool
    if get_platform() != "linux_armv7l":
        return False
    # hard-float ABI can be detected from the ELF header of the running
    # process
    try:
        with open(sys.executable, 'rb') as f:
            elf_header_raw = f.read(40)  # read 40 first bytes of ELF header
    except (IOError, OSError, TypeError):
        return False
    if elf_header_raw is None or len(elf_header_raw) < 40:
        return False
    if isinstance(elf_header_raw, str):
        elf_header = [ord(c) for c in elf_header_raw]
    else:
        elf_header = [b for b in elf_header_raw]
    result = elf_header[0:4] == [0x7f, 0x45, 0x4c, 0x46]  # ELF magic number
    result &= elf_header[4:5] == [1]  # 32-bit ELF
    result &= elf_header[5:6] == [1]  # little-endian
    result &= elf_header[18:20] == [0x28, 0]  # ARM machine
    result &= elf_header[39:40] == [5]  # ARM EABIv5
    result &= (elf_header[37:38][0] & 4) == 4  # EF_ARM_ABI_FLOAT_HARD
    return result


def is_manylinux1_compatible():
    # type: () -> bool
    # Only Linux, and only x86-64 / i686
    if get_platform() not in {"linux_x86_64", "linux_i686"}:
        return False

    # Check for presence of _manylinux module
    try:
        import _manylinux
        return bool(_manylinux.manylinux1_compatible)
    except (ImportError, AttributeError):
        # Fall through to heuristic check below
        pass

    # Check glibc version. CentOS 5 uses glibc 2.5.
    return pip._internal.utils.glibc.have_compatible_glibc(2, 5)


def is_manylinux2010_compatible():
    # type: () -> bool
    # Only Linux, and only x86-64 / i686
    if get_platform() not in {"linux_x86_64", "linux_i686"}:
        return False

    # Check for presence of _manylinux module
    try:
        import _manylinux
        return bool(_manylinux.manylinux2010_compatible)
    except (ImportError, AttributeError):
        # Fall through to heuristic check below
        pass

    # Check glibc version. CentOS 6 uses glibc 2.12.
    return pip._internal.utils.glibc.have_compatible_glibc(2, 12)


def is_manylinux2014_compatible():
    # type: () -> bool
    # Only Linux, and only supported architectures
    platform = get_platform()
    if platform not in {"linux_x86_64", "linux_i686", "linux_aarch64",
                        "linux_armv7l", "linux_ppc64", "linux_ppc64le",
                        "linux_s390x"}:
        return False

    # check for hard-float ABI in case we're running linux_armv7l not to
    # install hard-float ABI wheel in a soft-float ABI environment
    if platform == "linux_armv7l" and not is_linux_armhf():
        return False

    # Check for presence of _manylinux module
    try:
        import _manylinux
        return bool(_manylinux.manylinux2014_compatible)
    except (ImportError, AttributeError):
        # Fall through to heuristic check below
        pass

    # Check glibc version. CentOS 7 uses glibc 2.17.
    return pip._internal.utils.glibc.have_compatible_glibc(2, 17)


def get_darwin_arches(major, minor, machine):
    # type: (int, int, str) -> List[str]
    """Return a list of supported arches (including group arches) for
    the given major, minor and machine architecture of an macOS machine.
    """
    arches = []

    def _supports_arch(major, minor, arch):
        # type: (int, int, str) -> bool
        # Looking at the application support for macOS versions in the chart
        # provided by https://en.wikipedia.org/wiki/OS_X#Versions it appears
        # our timeline looks roughly like:
        #
        # 10.0 - Introduces ppc support.
        # 10.4 - Introduces ppc64, i386, and x86_64 support, however the ppc64
        #        and x86_64 support is CLI only, and cannot be used for GUI
        #        applications.
        # 10.5 - Extends ppc64 and x86_64 support to cover GUI applications.
        # 10.6 - Drops support for ppc64
        # 10.7 - Drops support for ppc
        #
        # Given that we do not know if we're installing a CLI or a GUI
        # application, we must be conservative and assume it might be a GUI
        # application and behave as if ppc64 and x86_64 support did not occur
        # until 10.5.
        #
        # Note: The above information is taken from the "Application support"
        #       column in the chart not the "Processor support" since I believe
        #       that we care about what instruction sets an application can use
        #       not which processors the OS supports.
        if arch == 'ppc':
            return (major, minor) <= (10, 5)
        if arch == 'ppc64':
            return (major, minor) == (10, 5)
        if arch == 'i386':
            return (major, minor) >= (10, 4)
        if arch == 'x86_64':
            return (major, minor) >= (10, 5)
        if arch in groups:
            for garch in groups[arch]:
                if _supports_arch(major, minor, garch):
                    return True
        return False

    groups = OrderedDict([
        ("fat", ("i386", "ppc")),
        ("intel", ("x86_64", "i386")),
        ("fat64", ("x86_64", "ppc64")),
        ("fat32", ("x86_64", "i386", "ppc")),
    ])  # type: Dict[str, Tuple[str, ...]]

    if _supports_arch(major, minor, machine):
        arches.append(machine)

    for garch in groups:
        if machine in groups[garch] and _supports_arch(major, minor, garch):
            arches.append(garch)

    arches.append('universal')

    return arches


def get_all_minor_versions_as_strings(version_info):
    # type: (Tuple[int, ...]) -> List[str]
    versions = []
    major = version_info[:-1]
    # Support all previous minor Python versions.
    for minor in range(version_info[-1], -1, -1):
        versions.append(''.join(map(str, major + (minor,))))
    return versions


def get_supported(
    versions=None,  # type: Optional[List[str]]
    noarch=False,  # type: bool
    platform=None,  # type: Optional[str]
    impl=None,  # type: Optional[str]
    abi=None  # type: Optional[str]
):
    # type: (...) -> List[Pep425Tag]
    """Return a list of supported tags for each version specified in
    `versions`.

    :param versions: a list of string versions, of the form ["33", "32"],
        or None. The first version will be assumed to support our ABI.
    :param platform: specify the exact platform you want valid
        tags for, or None. If None, use the local system platform.
    :param impl: specify the exact implementation you want valid
        tags for, or None. If None, use the local interpreter impl.
    :param abi: specify the exact abi you want valid
        tags for, or None. If None, use the local interpreter abi.
    """
    supported = []

    # Versions must be given with respect to the preference
    if versions is None:
        version_info = get_impl_version_info()
        versions = get_all_minor_versions_as_strings(version_info)

    impl = impl or get_abbr_impl()

    abis = []  # type: List[str]

    abi = abi or get_abi_tag()
    if abi:
        abis[0:0] = [abi]

    abi3s = set()  # type: Set[str]
    for suffix in get_extension_suffixes():
        if suffix.startswith('.abi'):
            abi3s.add(suffix.split('.', 2)[1])

    abis.extend(sorted(list(abi3s)))

    abis.append('none')

    if not noarch:
        arch = platform or get_platform()
        arch_prefix, arch_sep, arch_suffix = arch.partition('_')
        if arch.startswith('macosx'):
            # support macosx-10.6-intel on macosx-10.9-x86_64
            match = _osx_arch_pat.match(arch)
            if match:
                name, major, minor, actual_arch = match.groups()
                tpl = '{}_{}_%i_%s'.format(name, major)
                arches = []
                for m in reversed(range(int(minor) + 1)):
                    for a in get_darwin_arches(int(major), m, actual_arch):
                        arches.append(tpl % (m, a))
            else:
                # arch pattern didn't match (?!)
                arches = [arch]
        elif arch_prefix == 'manylinux2014':
            arches = [arch]
            # manylinux1/manylinux2010 wheels run on most manylinux2014 systems
            # with the exception of wheels depending on ncurses. PEP 599 states
            # manylinux1/manylinux2010 wheels should be considered
            # manylinux2014 wheels:
            # https://www.python.org/dev/peps/pep-0599/#backwards-compatibility-with-manylinux2010-wheels
            if arch_suffix in {'i686', 'x86_64'}:
                arches.append('manylinux2010' + arch_sep + arch_suffix)
                arches.append('manylinux1' + arch_sep + arch_suffix)
        elif arch_prefix == 'manylinux2010':
            # manylinux1 wheels run on most manylinux2010 systems with the
            # exception of wheels depending on ncurses. PEP 571 states
            # manylinux1 wheels should be considered manylinux2010 wheels:
            # https://www.python.org/dev/peps/pep-0571/#backwards-compatibility-with-manylinux1-wheels
            arches = [arch, 'manylinux1' + arch_sep + arch_suffix]
        elif platform is None:
            arches = []
            if is_manylinux2014_compatible():
                arches.append('manylinux2014' + arch_sep + arch_suffix)
            if is_manylinux2010_compatible():
                arches.append('manylinux2010' + arch_sep + arch_suffix)
            if is_manylinux1_compatible():
                arches.append('manylinux1' + arch_sep + arch_suffix)
            arches.append(arch)
        else:
            arches = [arch]

        # Current version, current API (built specifically for our Python):
        for abi in abis:
            for arch in arches:
                supported.append(('%s%s' % (impl, versions[0]), abi, arch))

        # abi3 modules compatible with older version of Python
        for version in versions[1:]:
            # abi3 was introduced in Python 3.2
            if version in {'31', '30'}:
                break
            for abi in abi3s:   # empty set if not Python 3
                for arch in arches:
                    supported.append(("%s%s" % (impl, version), abi, arch))

        # Has binaries, does not use the Python API:
        for arch in arches:
            supported.append(('py%s' % (versions[0][0]), 'none', arch))

    # No abi / arch, but requires our implementation:
    supported.append(('%s%s' % (impl, versions[0]), 'none', 'any'))
    # Tagged specifically as being cross-version compatible
    # (with just the major version specified)
    supported.append(('%s%s' % (impl, versions[0][0]), 'none', 'any'))

    # No abi / arch, generic Python
    for i, version in enumerate(versions):
        supported.append(('py%s' % (version,), 'none', 'any'))
        if i == 0:
            supported.append(('py%s' % (version[0]), 'none', 'any'))

    return supported


implementation_tag = get_impl_tag()
site-packages/pip/_internal/models/target_python.py000064400000007354151446176770016606 0ustar00import sys

from pip._internal.pep425tags import get_supported, version_info_to_nodot
from pip._internal.utils.misc import normalize_version_info
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import List, Optional, Tuple
    from pip._internal.pep425tags import Pep425Tag


class TargetPython(object):

    """
    Encapsulates the properties of a Python interpreter one is targeting
    for a package install, download, etc.
    """

    def __init__(
        self,
        platform=None,  # type: Optional[str]
        py_version_info=None,  # type: Optional[Tuple[int, ...]]
        abi=None,  # type: Optional[str]
        implementation=None,  # type: Optional[str]
    ):
        # type: (...) -> None
        """
        :param platform: A string or None. If None, searches for packages
            that are supported by the current system. Otherwise, will find
            packages that can be built on the platform passed in. These
            packages will only be downloaded for distribution: they will
            not be built locally.
        :param py_version_info: An optional tuple of ints representing the
            Python version information to use (e.g. `sys.version_info[:3]`).
            This can have length 1, 2, or 3 when provided.
        :param abi: A string or None. This is passed to pep425tags.py's
            get_supported() function as is.
        :param implementation: A string or None. This is passed to
            pep425tags.py's get_supported() function as is.
        """
        # Store the given py_version_info for when we call get_supported().
        self._given_py_version_info = py_version_info

        if py_version_info is None:
            py_version_info = sys.version_info[:3]
        else:
            py_version_info = normalize_version_info(py_version_info)

        py_version = '.'.join(map(str, py_version_info[:2]))

        self.abi = abi
        self.implementation = implementation
        self.platform = platform
        self.py_version = py_version
        self.py_version_info = py_version_info

        # This is used to cache the return value of get_tags().
        self._valid_tags = None  # type: Optional[List[Pep425Tag]]

    def format_given(self):
        # type: () -> str
        """
        Format the given, non-None attributes for display.
        """
        display_version = None
        if self._given_py_version_info is not None:
            display_version = '.'.join(
                str(part) for part in self._given_py_version_info
            )

        key_values = [
            ('platform', self.platform),
            ('version_info', display_version),
            ('abi', self.abi),
            ('implementation', self.implementation),
        ]
        return ' '.join(
            '{}={!r}'.format(key, value) for key, value in key_values
            if value is not None
        )

    def get_tags(self):
        # type: () -> List[Pep425Tag]
        """
        Return the supported PEP 425 tags to check wheel candidates against.

        The tags are returned in order of preference (most preferred first).
        """
        if self._valid_tags is None:
            # Pass versions=None if no py_version_info was given since
            # versions=None uses special default logic.
            py_version_info = self._given_py_version_info
            if py_version_info is None:
                versions = None
            else:
                versions = [version_info_to_nodot(py_version_info)]

            tags = get_supported(
                versions=versions,
                platform=self.platform,
                abi=self.abi,
                impl=self.implementation,
            )
            self._valid_tags = tags

        return self._valid_tags
site-packages/pip/_internal/models/search_scope.py000064400000007603151446176770016352 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import itertools
import logging
import os
import posixpath

from pip._vendor.packaging.utils import canonicalize_name
from pip._vendor.six.moves.urllib import parse as urllib_parse

from pip._internal.models.index import PyPI
from pip._internal.utils.compat import HAS_TLS
from pip._internal.utils.misc import normalize_path, redact_auth_from_url
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import List


logger = logging.getLogger(__name__)


class SearchScope(object):

    """
    Encapsulates the locations that pip is configured to search.
    """

    @classmethod
    def create(
        cls,
        find_links,  # type: List[str]
        index_urls,  # type: List[str]
    ):
        # type: (...) -> SearchScope
        """
        Create a SearchScope object after normalizing the `find_links`.
        """
        # Build find_links. If an argument starts with ~, it may be
        # a local file relative to a home directory. So try normalizing
        # it and if it exists, use the normalized version.
        # This is deliberately conservative - it might be fine just to
        # blindly normalize anything starting with a ~...
        built_find_links = []  # type: List[str]
        for link in find_links:
            if link.startswith('~'):
                new_link = normalize_path(link)
                if os.path.exists(new_link):
                    link = new_link
            built_find_links.append(link)

        # If we don't have TLS enabled, then WARN if anyplace we're looking
        # relies on TLS.
        if not HAS_TLS:
            for link in itertools.chain(index_urls, built_find_links):
                parsed = urllib_parse.urlparse(link)
                if parsed.scheme == 'https':
                    logger.warning(
                        'pip is configured with locations that require '
                        'TLS/SSL, however the ssl module in Python is not '
                        'available.'
                    )
                    break

        return cls(
            find_links=built_find_links,
            index_urls=index_urls,
        )

    def __init__(
        self,
        find_links,  # type: List[str]
        index_urls,  # type: List[str]
    ):
        # type: (...) -> None
        self.find_links = find_links
        self.index_urls = index_urls

    def get_formatted_locations(self):
        # type: () -> str
        lines = []
        if self.index_urls and self.index_urls != [PyPI.simple_url]:
            lines.append(
                'Looking in indexes: {}'.format(', '.join(
                    redact_auth_from_url(url) for url in self.index_urls))
            )
        if self.find_links:
            lines.append(
                'Looking in links: {}'.format(', '.join(
                    redact_auth_from_url(url) for url in self.find_links))
            )
        return '\n'.join(lines)

    def get_index_urls_locations(self, project_name):
        # type: (str) -> List[str]
        """Returns the locations found via self.index_urls

        Checks the url_name on the main (first in the list) index and
        use this url_name to produce all locations
        """

        def mkurl_pypi_url(url):
            loc = posixpath.join(
                url,
                urllib_parse.quote(canonicalize_name(project_name)))
            # For maximum compatibility with easy_install, ensure the path
            # ends in a trailing slash.  Although this isn't in the spec
            # (and PyPI can handle it without the slash) some other index
            # implementations might break if they relied on easy_install's
            # behavior.
            if not loc.endswith('/'):
                loc = loc + '/'
            return loc

        return [mkurl_pypi_url(url) for url in self.index_urls]
site-packages/pip/_internal/models/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000340151446176770022667 0ustar00U

��.e?�@sdZdS)z8A package that contains models that represent entities.
N)�__doc__�rr�A/usr/lib/python3.8/site-packages/pip/_internal/models/__init__.py�<module>�site-packages/pip/_internal/models/__pycache__/candidate.cpython-38.opt-1.pyc000064400000002662151446176770023055 0ustar00U

��.e��@s`ddlmZddlmZddlmZerLddlmZddlm	Z	ddl
mZGdd�de�Zd	S)
�)�parse)�KeyBasedCompareMixin)�MYPY_CHECK_RUNNING)�_BaseVersion)�Link)�Anycs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�InstallationCandidatez9Represents a potential "candidate" for installation.
    cs:||_t|�|_||_tt|�j|j|j|jftd�dS)N)�keyZdefining_class)�project�
parse_version�version�link�superr�__init__)�selfr
rr
��	__class__��B/usr/lib/python3.8/site-packages/pip/_internal/models/candidate.pyrs

�zInstallationCandidate.__init__cCsd�|j|j|j�S)Nz)<InstallationCandidate({!r}, {!r}, {!r})>��formatr
rr
�rrrr�__repr__s
�zInstallationCandidate.__repr__cCsd�|j|j|j�S)Nz!{!r} candidate (version {} at {})rrrrr�__str__$s
�zInstallationCandidate.__str__)�__name__�
__module__�__qualname__�__doc__rrr�
__classcell__rrrrrsrN)
Zpip._vendor.packaging.versionrrZpip._internal.utils.modelsrZpip._internal.utils.typingrrZpip._internal.models.linkr�typingrrrrrr�<module>ssite-packages/pip/_internal/models/__pycache__/format_control.cpython-38.opt-1.pyc000064400000004560151446176770024170 0ustar00U

��.e 
�@sPddlmZddlmZddlmZer<ddlmZmZm	Z	Gdd�de
�ZdS)�)�canonicalize_name)�CommandError)�MYPY_CHECK_RUNNING)�Optional�Set�	FrozenSetc@sNeZdZdZddd�Zdd�Zdd�Zd	d
�Zedd��Z	d
d�Z
dd�ZdS)�
FormatControlzGHelper for managing formats from which a package can be installed.
    NcCs,|dkrt�}|dkrt�}||_||_dS�N)�set�	no_binary�only_binary)�selfrr�r�G/usr/lib/python3.8/site-packages/pip/_internal/models/format_control.py�__init__szFormatControl.__init__cCs|j|jkSr	)�__dict__�r
�otherrrr�__eq__szFormatControl.__eq__cCs|�|�Sr	)rrrrr�__ne__szFormatControl.__ne__cCsd�|jj|j|j�S)Nz
{}({}, {}))�format�	__class__�__name__rr�r
rrr�__repr__"s
�zFormatControl.__repr__cCs�|�d�rtd��|�d�}d|kr`|��|��|�d�|d|�d�d�=d|krdSq|D]2}|dkrz|��qdt|�}|�|�|�|�qddS)N�-z7--no-binary / --only-binary option requires 1 argument.�,�:all:�z:none:)�
startswithr�split�clear�add�indexr�discard)�value�targetr�new�namerrr�handle_mutual_excludes)s&
�


z$FormatControl.handle_mutual_excludescCsfddh}||jkr|�d�n@||jkr4|�d�n*d|jkrJ|�d�nd|jkr^|�d�t|�S)NZbinary�sourcer)rr$r�	frozenset)r
Zcanonical_name�resultrrr�get_allowed_formatsAs




z!FormatControl.get_allowed_formatscCs|�d|j|j�dS)Nr)r)rrrrrr�disallow_binariesNs
�zFormatControl.disallow_binaries)NN)r�
__module__�__qualname__�__doc__rrrr�staticmethodr)r-r.rrrrrs



rN)Zpip._vendor.packaging.utilsrZpip._internal.exceptionsrZpip._internal.utils.typingr�typingrrr�objectrrrrr�<module>s
site-packages/pip/_internal/models/__pycache__/link.cpython-38.pyc000064400000014775151446176770021147 0ustar00U

��.e��@s�ddlZddlZddlZddlmZddlmZddlm	Z	m
Z
mZddlm
Z
ddlmZddlmZmZer�ddlmZmZmZmZdd	lmZdd
lmZGdd�de
�ZdS)
�N)�parse)�WHEEL_EXTENSION)�redact_auth_from_url�split_auth_from_netloc�splitext)�KeyBasedCompareMixin)�MYPY_CHECK_RUNNING)�path_to_url�url_to_path)�Optional�Text�Tuple�Union)�HTMLPage)�Hashescs@eZdZdZd6�fdd�	Zdd�Zdd�Zed	d
��Zedd��Z	ed
d��Z
edd��Zedd��Zedd��Z
dd�Zedd��Zedd��Ze�d�Zedd��Ze�d�Zedd ��Ze�d!�Zed"d#��Zed$d%��Zed&d'��Zed(d)��Zd*d+�Zed,d-��Zed.d/��Zed0d1��Zed2d3��Z d4d5�Z!�Z"S)7�Linkz?Represents a parsed link from a Package Index's simple URL
    NcsV|�d�rt|�}t�|�|_||_||_|r2|nd|_||_t	t
|�j|t
d�dS)a`
        :param url: url of the resource pointed to (href of the link)
        :param comes_from: instance of HTMLPage where the link was found,
            or string.
        :param requires_python: String containing the `Requires-Python`
            metadata field, specified in PEP 345. This may be specified by
            a data-requires-python attribute in the HTML link tag, as
            described in PEP 503.
        :param yanked_reason: the reason the file has been yanked, if the
            file has been yanked, or None if the file hasn't been yanked.
            This is the value of the "data-yanked" attribute, if present, in
            a simple repository HTML link. If the file has been yanked but
            no reason was provided, this should be the empty string. See
            PEP 592 for more information and the specification.
        z\\N)�keyZdefining_class)�
startswithr	�urllib_parseZurlsplit�_parsed_url�_url�
comes_from�requires_python�
yanked_reason�superr�__init__)�self�urlrrr��	__class__��=/usr/lib/python3.8/site-packages/pip/_internal/models/link.pyrs
z
Link.__init__cCsD|jrd|j}nd}|jr2dt|j�|j|fStt|j��SdS)Nz (requires-python:%s)�z%s (from %s)%s)rrrr�str)rZrpr r r!�__str__Es
�zLink.__str__cCsd|S)Nz	<Link %s>r �rr r r!�__repr__Psz
Link.__repr__cCs|jS�N)rr%r r r!rSszLink.urlcCsL|j�d�}t�|�}|s,t|j�\}}|St�|�}|sHtd|j	��|S)N�/zURL %r produced no filename)
�path�rstrip�	posixpath�basenamer�netlocr�unquote�AssertionErrorr)rr)�namer-Z	user_passr r r!�filenameXs

z
Link.filenamecCs
t|j�Sr')r
rr%r r r!�	file_pathgszLink.file_pathcCs|jjSr')r�schemer%r r r!r3lszLink.schemecCs|jjS)z4
        This can contain auth information.
        )rr-r%r r r!r-qszLink.netloccCst�|jj�Sr')rr.rr)r%r r r!r)ysz	Link.pathcCstt�|j�d���S)Nr()rr+r,r)r*r%r r r!r~sz
Link.splitextcCs|��dS�N�)rr%r r r!�ext�szLink.extcCs$|j\}}}}}t�||||df�Sr')rrZ
urlunsplit)rr3r-r)ZqueryZfragmentr r r!�url_without_fragment�szLink.url_without_fragmentz[#&]egg=([^&]*)cCs |j�|j�}|sdS|�d�Sr4)�_egg_fragment_re�searchr�group�r�matchr r r!�egg_fragment�szLink.egg_fragmentz[#&]subdirectory=([^&]*)cCs |j�|j�}|sdS|�d�Sr4)�_subdirectory_fragment_rer9rr:r;r r r!�subdirectory_fragment�szLink.subdirectory_fragmentz2(sha1|sha224|sha384|sha256|sha512|md5)=([a-f0-9]+)cCs |j�|j�}|r|�d�SdS)N���_hash_rer9rr:r;r r r!�hash�s
z	Link.hashcCs |j�|j�}|r|�d�SdSr4rAr;r r r!�	hash_name�s
zLink.hash_namecCs$t�|j�dd�d�dd�d�S)N�#r5r�?)r+r,r�splitr%r r r!�show_url�sz
Link.show_urlcCs
|jdkS)N�file)r3r%r r r!�is_file�szLink.is_filecCs|jotj�|j�Sr')rJ�osr)�isdirr2r%r r r!�is_existing_dir�szLink.is_existing_dircCs
|jtkSr')r6rr%r r r!�is_wheel�sz
Link.is_wheelcCsddlm}|j|jkS)Nr)�vcs)Zpip._internal.vcsrOr3Zall_schemes)rrOr r r!�is_vcs�szLink.is_vcscCs
|jdk	Sr')rr%r r r!�	is_yanked�szLink.is_yankedcCs
|jdk	Sr')rDr%r r r!�has_hash�sz
Link.has_hashcCs@|dks|jsdS|jdk	s t�|jdk	s.t�|j|j|jd�S)zG
        Return True if the link has a hash and it is allowed.
        NF)Z
hex_digest)rRrDr/rC�is_hash_allowed)rZhashesr r r!rS�s
zLink.is_hash_allowed)NNN)#�__name__�
__module__�__qualname__�__doc__rr$r&�propertyrr1r2r3r-r)rr6r7�re�compiler8r=r>r?rBrCrDrHrJrMrNrPrQrRrS�
__classcell__r r rr!rsf�'











�







r)rKr+rYZpip._vendor.six.moves.urllibrrZpip._internal.utils.filetypesrZpip._internal.utils.miscrrrZpip._internal.utils.modelsrZpip._internal.utils.typingrZpip._internal.utils.urlsr	r
�typingrrr
rZpip._internal.collectorrZpip._internal.utils.hashesrrr r r r!�<module>ssite-packages/pip/_internal/models/__pycache__/index.cpython-38.opt-1.pyc000064400000002172151446176770022244 0ustar00U

��.e$�@s8ddlmZGdd�de�Zeddd�Zeddd�Zd	S)
�)�parsecs(eZdZdZ�fdd�Zdd�Z�ZS)�PackageIndexzGRepresents a Package Index and provides easier access to endpoints
    csDtt|���||_t�|�j|_|�d�|_|�d�|_	||_
dS)NZsimpleZpypi)�superr�__init__�url�urllib_parseZurlsplitZnetloc�
_url_for_pathZ
simple_urlZpypi_url�file_storage_domain)�selfrr	��	__class__��>/usr/lib/python3.8/site-packages/pip/_internal/models/index.pyrszPackageIndex.__init__cCst�|j|�S)N)rZurljoinr)r
�pathr
r
rrszPackageIndex._url_for_path)�__name__�
__module__�__qualname__�__doc__rr�
__classcell__r
r
rrrs
rzhttps://pypi.org/zfiles.pythonhosted.org)r	zhttps://test.pypi.org/ztest-files.pythonhosted.orgN)Zpip._vendor.six.moves.urllibrr�objectrZPyPIZTestPyPIr
r
r
r�<module>s��site-packages/pip/_internal/models/__pycache__/search_scope.cpython-38.opt-1.pyc000064400000006263151446176770023600 0ustar00U

��.e��@s�ddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZddl
mZmZddlmZer|ddlmZe�e�ZGd	d
�d
e�ZdS)�N)�canonicalize_name)�parse)�PyPI)�HAS_TLS)�normalize_path�redact_auth_from_url)�MYPY_CHECK_RUNNING)�Listc@s4eZdZdZedd��Zdd�Zdd�Zdd	�Zd
S)�SearchScopezF
    Encapsulates the locations that pip is configured to search.
    cCs~g}|D]0}|�d�r.t|�}tj�|�r.|}|�|�qtsrt�||�D]&}t	�
|�}|jdkrJt�
d�qrqJ|||d�S)zQ
        Create a SearchScope object after normalizing the `find_links`.
        �~Zhttpszipip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.��
find_links�
index_urls)�
startswithr�os�path�exists�appendr�	itertools�chain�urllib_parseZurlparseZscheme�loggerZwarning)�clsr
rZbuilt_find_links�linkZnew_linkZparsed�r�E/usr/lib/python3.8/site-packages/pip/_internal/models/search_scope.py�creates&


��zSearchScope.createcCs||_||_dS�Nr)�selfr
rrrr�__init__GszSearchScope.__init__cCslg}|jr:|jtjgkr:|�d�d�dd�|jD����|jrb|�d�d�dd�|jD����d�|�S)NzLooking in indexes: {}z, css|]}t|�VqdSr�r��.0�urlrrr�	<genexpr>Usz6SearchScope.get_formatted_locations.<locals>.<genexpr>zLooking in links: {}css|]}t|�VqdSrr r!rrrr$Zs�
)rrZ
simple_urlr�format�joinr
)r�linesrrr�get_formatted_locationsPs����z#SearchScope.get_formatted_locationscs �fdd���fdd�|jD�S)z�Returns the locations found via self.index_urls

        Checks the url_name on the main (first in the list) index and
        use this url_name to produce all locations
        cs,t�|t�t����}|�d�s(|d}|S)N�/)�	posixpathr'rZquoter�endswith)r#Zloc)�project_namerr�mkurl_pypi_urlgs�
z<SearchScope.get_index_urls_locations.<locals>.mkurl_pypi_urlcsg|]}�|��qSrrr!)r.rr�
<listcomp>tsz8SearchScope.get_index_urls_locations.<locals>.<listcomp>)r)rr-r)r.r-r�get_index_urls_locations_s
z$SearchScope.get_index_urls_locationsN)	�__name__�
__module__�__qualname__�__doc__�classmethodrrr)r0rrrrr
s
(	r
)rZloggingrr+Zpip._vendor.packaging.utilsrZpip._vendor.six.moves.urllibrrZpip._internal.models.indexrZpip._internal.utils.compatrZpip._internal.utils.miscrrZpip._internal.utils.typingr�typingr	Z	getLoggerr1r�objectr
rrrr�<module>s
site-packages/pip/_internal/models/__pycache__/target_python.cpython-38.opt-1.pyc000064400000006200151446176770024020 0ustar00U

��.e��@shddlZddlmZmZddlmZddlmZerTddlm	Z	m
Z
mZddlmZGdd�de
�ZdS)	�N)�
get_supported�version_info_to_nodot)�normalize_version_info)�MYPY_CHECK_RUNNING)�List�Optional�Tuple)�	Pep425Tagc@s*eZdZdZd	dd�Zdd�Zdd�ZdS)
�TargetPythonzx
    Encapsulates the properties of a Python interpreter one is targeting
    for a package install, download, etc.
    NcCsf||_|dkrtjdd�}nt|�}d�tt|dd���}||_||_||_	||_
||_d|_dS)a
        :param platform: A string or None. If None, searches for packages
            that are supported by the current system. Otherwise, will find
            packages that can be built on the platform passed in. These
            packages will only be downloaded for distribution: they will
            not be built locally.
        :param py_version_info: An optional tuple of ints representing the
            Python version information to use (e.g. `sys.version_info[:3]`).
            This can have length 1, 2, or 3 when provided.
        :param abi: A string or None. This is passed to pep425tags.py's
            get_supported() function as is.
        :param implementation: A string or None. This is passed to
            pep425tags.py's get_supported() function as is.
        N��.�)
�_given_py_version_info�sys�version_infor�join�map�str�abi�implementation�platform�
py_version�py_version_info�_valid_tags)�selfrrrrr�r�F/usr/lib/python3.8/site-packages/pip/_internal/models/target_python.py�__init__szTargetPython.__init__cCsZd}|jdk	r$d�dd�|jD��}d|jfd|fd|jfd|jfg}d	�d
d�|D��S)zD
        Format the given, non-None attributes for display.
        Nrcss|]}t|�VqdS)N)r)�.0�partrrr�	<genexpr>Csz,TargetPython.format_given.<locals>.<genexpr>rrrr� css&|]\}}|dk	rd�||�VqdS)Nz{}={!r})�format)r�key�valuerrrr Ms�)rrrrr)rZdisplay_versionZ
key_valuesrrr�format_given<s

��
�zTargetPython.format_givencCsJ|jdkrD|j}|dkrd}n
t|�g}t||j|j|jd�}||_|jS)z�
        Return the supported PEP 425 tags to check wheel candidates against.

        The tags are returned in order of preference (most preferred first).
        N)�versionsrr�impl)rrrrrrr)rrr&Ztagsrrr�get_tagsRs

�zTargetPython.get_tags)NNNN)�__name__�
__module__�__qualname__�__doc__rr%r(rrrrr
s�
)r
)rZpip._internal.pep425tagsrrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingrrrr	�objectr
rrrr�<module>ssite-packages/pip/_internal/models/__pycache__/index.cpython-38.pyc000064400000002172151446176770021305 0ustar00U

��.e$�@s8ddlmZGdd�de�Zeddd�Zeddd�Zd	S)
�)�parsecs(eZdZdZ�fdd�Zdd�Z�ZS)�PackageIndexzGRepresents a Package Index and provides easier access to endpoints
    csDtt|���||_t�|�j|_|�d�|_|�d�|_	||_
dS)NZsimpleZpypi)�superr�__init__�url�urllib_parseZurlsplitZnetloc�
_url_for_pathZ
simple_urlZpypi_url�file_storage_domain)�selfrr	��	__class__��>/usr/lib/python3.8/site-packages/pip/_internal/models/index.pyrszPackageIndex.__init__cCst�|j|�S)N)rZurljoinr)r
�pathr
r
rrszPackageIndex._url_for_path)�__name__�
__module__�__qualname__�__doc__rr�
__classcell__r
r
rrrs
rzhttps://pypi.org/zfiles.pythonhosted.org)r	zhttps://test.pypi.org/ztest-files.pythonhosted.orgN)Zpip._vendor.six.moves.urllibrr�objectrZPyPIZTestPyPIr
r
r
r�<module>s��site-packages/pip/_internal/models/__pycache__/link.cpython-38.opt-1.pyc000064400000014617151446176770022101 0ustar00U

��.e��@s�ddlZddlZddlZddlmZddlmZddlm	Z	m
Z
mZddlm
Z
ddlmZddlmZmZer�ddlmZmZmZmZdd	lmZdd
lmZGdd�de
�ZdS)
�N)�parse)�WHEEL_EXTENSION)�redact_auth_from_url�split_auth_from_netloc�splitext)�KeyBasedCompareMixin)�MYPY_CHECK_RUNNING)�path_to_url�url_to_path)�Optional�Text�Tuple�Union)�HTMLPage)�Hashescs@eZdZdZd6�fdd�	Zdd�Zdd�Zed	d
��Zedd��Z	ed
d��Z
edd��Zedd��Zedd��Z
dd�Zedd��Zedd��Ze�d�Zedd��Ze�d�Zedd ��Ze�d!�Zed"d#��Zed$d%��Zed&d'��Zed(d)��Zd*d+�Zed,d-��Zed.d/��Zed0d1��Zed2d3��Z d4d5�Z!�Z"S)7�Linkz?Represents a parsed link from a Package Index's simple URL
    NcsV|�d�rt|�}t�|�|_||_||_|r2|nd|_||_t	t
|�j|t
d�dS)a`
        :param url: url of the resource pointed to (href of the link)
        :param comes_from: instance of HTMLPage where the link was found,
            or string.
        :param requires_python: String containing the `Requires-Python`
            metadata field, specified in PEP 345. This may be specified by
            a data-requires-python attribute in the HTML link tag, as
            described in PEP 503.
        :param yanked_reason: the reason the file has been yanked, if the
            file has been yanked, or None if the file hasn't been yanked.
            This is the value of the "data-yanked" attribute, if present, in
            a simple repository HTML link. If the file has been yanked but
            no reason was provided, this should be the empty string. See
            PEP 592 for more information and the specification.
        z\\N)�keyZdefining_class)�
startswithr	�urllib_parseZurlsplit�_parsed_url�_url�
comes_from�requires_python�
yanked_reason�superr�__init__)�self�urlrrr��	__class__��=/usr/lib/python3.8/site-packages/pip/_internal/models/link.pyrs
z
Link.__init__cCsD|jrd|j}nd}|jr2dt|j�|j|fStt|j��SdS)Nz (requires-python:%s)�z%s (from %s)%s)rrrr�str)rZrpr r r!�__str__Es
�zLink.__str__cCsd|S)Nz	<Link %s>r �rr r r!�__repr__Psz
Link.__repr__cCs|jS�N)rr%r r r!rSszLink.urlcCs:|j�d�}t�|�}|s,t|j�\}}|St�|�}|S�N�/)�path�rstrip�	posixpath�basenamer�netlocr�unquote)rr*�namer.Z	user_passr r r!�filenameXs

z
Link.filenamecCs
t|j�Sr')r
rr%r r r!�	file_pathgszLink.file_pathcCs|jjSr')r�schemer%r r r!r3lszLink.schemecCs|jjS)z4
        This can contain auth information.
        )rr.r%r r r!r.qszLink.netloccCst�|jj�Sr')rr/rr*r%r r r!r*ysz	Link.pathcCstt�|j�d���Sr()rr,r-r*r+r%r r r!r~sz
Link.splitextcCs|��dS�N�)rr%r r r!�ext�szLink.extcCs$|j\}}}}}t�||||df�Sr')rrZ
urlunsplit)rr3r.r*ZqueryZfragmentr r r!�url_without_fragment�szLink.url_without_fragmentz[#&]egg=([^&]*)cCs |j�|j�}|sdS|�d�Sr4)�_egg_fragment_re�searchr�group�r�matchr r r!�egg_fragment�szLink.egg_fragmentz[#&]subdirectory=([^&]*)cCs |j�|j�}|sdS|�d�Sr4)�_subdirectory_fragment_rer9rr:r;r r r!�subdirectory_fragment�szLink.subdirectory_fragmentz2(sha1|sha224|sha384|sha256|sha512|md5)=([a-f0-9]+)cCs |j�|j�}|r|�d�SdS)N���_hash_rer9rr:r;r r r!�hash�s
z	Link.hashcCs |j�|j�}|r|�d�SdSr4rAr;r r r!�	hash_name�s
zLink.hash_namecCs$t�|j�dd�d�dd�d�S)N�#r5r�?)r,r-r�splitr%r r r!�show_url�sz
Link.show_urlcCs
|jdkS)N�file)r3r%r r r!�is_file�szLink.is_filecCs|jotj�|j�Sr')rJ�osr*�isdirr2r%r r r!�is_existing_dir�szLink.is_existing_dircCs
|jtkSr')r6rr%r r r!�is_wheel�sz
Link.is_wheelcCsddlm}|j|jkS)Nr)�vcs)Zpip._internal.vcsrOr3Zall_schemes)rrOr r r!�is_vcs�szLink.is_vcscCs
|jdk	Sr')rr%r r r!�	is_yanked�szLink.is_yankedcCs
|jdk	Sr')rDr%r r r!�has_hash�sz
Link.has_hashcCs$|dks|jsdS|j|j|jd�S)zG
        Return True if the link has a hash and it is allowed.
        NF)Z
hex_digest)rR�is_hash_allowedrDrC)rZhashesr r r!rS�szLink.is_hash_allowed)NNN)#�__name__�
__module__�__qualname__�__doc__rr$r&�propertyrr1r2r3r.r*rr6r7�re�compiler8r=r>r?rBrCrDrHrJrMrNrPrQrRrS�
__classcell__r r rr!rsf�'











�







r)rKr,rYZpip._vendor.six.moves.urllibrrZpip._internal.utils.filetypesrZpip._internal.utils.miscrrrZpip._internal.utils.modelsrZpip._internal.utils.typingrZpip._internal.utils.urlsr	r
�typingrrr
rZpip._internal.collectorrZpip._internal.utils.hashesrrr r r r!�<module>ssite-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-38.pyc000064400000003074151446176770023364 0ustar00U

��.et�@s<ddlmZer(ddlmZddlmZGdd�de�ZdS)�)�MYPY_CHECK_RUNNING)�Optional)�
FormatControlc@seZdZdZddd�ZdS)�SelectionPreferenceszd
    Encapsulates the candidate selection preferences for downloading
    and installing files.
    FNcCs.|dkrd}||_||_||_||_||_dS)awCreate a SelectionPreferences object.

        :param allow_yanked: Whether files marked as yanked (in the sense
            of PEP 592) are permitted to be candidates for install.
        :param format_control: A FormatControl object or None. Used to control
            the selection of source packages / binary packages when consulting
            the index and links.
        :param prefer_binary: Whether to prefer an old, but valid, binary
            dist over a new source dist.
        :param ignore_requires_python: Whether to ignore incompatible
            "Requires-Python" values in links. Defaults to False.
        NF)�allow_yanked�allow_all_prereleases�format_control�
prefer_binary�ignore_requires_python)�selfrrrr	r
�r�H/usr/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py�__init__szSelectionPreferences.__init__)FNFN)�__name__�
__module__�__qualname__�__doc__rrrrr
rs�rN)Zpip._internal.utils.typingr�typingrZ#pip._internal.models.format_controlr�objectrrrrr
�<module>ssite-packages/pip/_internal/models/__pycache__/candidate.cpython-38.pyc000064400000002662151446176770022116 0ustar00U

��.e��@s`ddlmZddlmZddlmZerLddlmZddlm	Z	ddl
mZGdd�de�Zd	S)
�)�parse)�KeyBasedCompareMixin)�MYPY_CHECK_RUNNING)�_BaseVersion)�Link)�Anycs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�InstallationCandidatez9Represents a potential "candidate" for installation.
    cs:||_t|�|_||_tt|�j|j|j|jftd�dS)N)�keyZdefining_class)�project�
parse_version�version�link�superr�__init__)�selfr
rr
��	__class__��B/usr/lib/python3.8/site-packages/pip/_internal/models/candidate.pyrs

�zInstallationCandidate.__init__cCsd�|j|j|j�S)Nz)<InstallationCandidate({!r}, {!r}, {!r})>��formatr
rr
�rrrr�__repr__s
�zInstallationCandidate.__repr__cCsd�|j|j|j�S)Nz!{!r} candidate (version {} at {})rrrrr�__str__$s
�zInstallationCandidate.__str__)�__name__�
__module__�__qualname__�__doc__rrr�
__classcell__rrrrrsrN)
Zpip._vendor.packaging.versionrrZpip._internal.utils.modelsrZpip._internal.utils.typingrrZpip._internal.models.linkr�typingrrrrrr�<module>ssite-packages/pip/_internal/models/__pycache__/selection_prefs.cpython-38.opt-1.pyc000064400000003074151446176770024323 0ustar00U

��.et�@s<ddlmZer(ddlmZddlmZGdd�de�ZdS)�)�MYPY_CHECK_RUNNING)�Optional)�
FormatControlc@seZdZdZddd�ZdS)�SelectionPreferenceszd
    Encapsulates the candidate selection preferences for downloading
    and installing files.
    FNcCs.|dkrd}||_||_||_||_||_dS)awCreate a SelectionPreferences object.

        :param allow_yanked: Whether files marked as yanked (in the sense
            of PEP 592) are permitted to be candidates for install.
        :param format_control: A FormatControl object or None. Used to control
            the selection of source packages / binary packages when consulting
            the index and links.
        :param prefer_binary: Whether to prefer an old, but valid, binary
            dist over a new source dist.
        :param ignore_requires_python: Whether to ignore incompatible
            "Requires-Python" values in links. Defaults to False.
        NF)�allow_yanked�allow_all_prereleases�format_control�
prefer_binary�ignore_requires_python)�selfrrrr	r
�r�H/usr/lib/python3.8/site-packages/pip/_internal/models/selection_prefs.py�__init__szSelectionPreferences.__init__)FNFN)�__name__�
__module__�__qualname__�__doc__rrrrr
rs�rN)Zpip._internal.utils.typingr�typingrZ#pip._internal.models.format_controlr�objectrrrrr
�<module>ssite-packages/pip/_internal/models/__pycache__/search_scope.cpython-38.pyc000064400000006263151446176770022641 0ustar00U

��.e��@s�ddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZddl
mZmZddlmZer|ddlmZe�e�ZGd	d
�d
e�ZdS)�N)�canonicalize_name)�parse)�PyPI)�HAS_TLS)�normalize_path�redact_auth_from_url)�MYPY_CHECK_RUNNING)�Listc@s4eZdZdZedd��Zdd�Zdd�Zdd	�Zd
S)�SearchScopezF
    Encapsulates the locations that pip is configured to search.
    cCs~g}|D]0}|�d�r.t|�}tj�|�r.|}|�|�qtsrt�||�D]&}t	�
|�}|jdkrJt�
d�qrqJ|||d�S)zQ
        Create a SearchScope object after normalizing the `find_links`.
        �~Zhttpszipip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.��
find_links�
index_urls)�
startswithr�os�path�exists�appendr�	itertools�chain�urllib_parseZurlparseZscheme�loggerZwarning)�clsr
rZbuilt_find_links�linkZnew_linkZparsed�r�E/usr/lib/python3.8/site-packages/pip/_internal/models/search_scope.py�creates&


��zSearchScope.createcCs||_||_dS�Nr)�selfr
rrrr�__init__GszSearchScope.__init__cCslg}|jr:|jtjgkr:|�d�d�dd�|jD����|jrb|�d�d�dd�|jD����d�|�S)NzLooking in indexes: {}z, css|]}t|�VqdSr�r��.0�urlrrr�	<genexpr>Usz6SearchScope.get_formatted_locations.<locals>.<genexpr>zLooking in links: {}css|]}t|�VqdSrr r!rrrr$Zs�
)rrZ
simple_urlr�format�joinr
)r�linesrrr�get_formatted_locationsPs����z#SearchScope.get_formatted_locationscs �fdd���fdd�|jD�S)z�Returns the locations found via self.index_urls

        Checks the url_name on the main (first in the list) index and
        use this url_name to produce all locations
        cs,t�|t�t����}|�d�s(|d}|S)N�/)�	posixpathr'rZquoter�endswith)r#Zloc)�project_namerr�mkurl_pypi_urlgs�
z<SearchScope.get_index_urls_locations.<locals>.mkurl_pypi_urlcsg|]}�|��qSrrr!)r.rr�
<listcomp>tsz8SearchScope.get_index_urls_locations.<locals>.<listcomp>)r)rr-r)r.r-r�get_index_urls_locations_s
z$SearchScope.get_index_urls_locationsN)	�__name__�
__module__�__qualname__�__doc__�classmethodrrr)r0rrrrr
s
(	r
)rZloggingrr+Zpip._vendor.packaging.utilsrZpip._vendor.six.moves.urllibrrZpip._internal.models.indexrZpip._internal.utils.compatrZpip._internal.utils.miscrrZpip._internal.utils.typingr�typingr	Z	getLoggerr1r�objectr
rrrr�<module>s
site-packages/pip/_internal/models/__pycache__/format_control.cpython-38.pyc000064400000004560151446176770023231 0ustar00U

��.e 
�@sPddlmZddlmZddlmZer<ddlmZmZm	Z	Gdd�de
�ZdS)�)�canonicalize_name)�CommandError)�MYPY_CHECK_RUNNING)�Optional�Set�	FrozenSetc@sNeZdZdZddd�Zdd�Zdd�Zd	d
�Zedd��Z	d
d�Z
dd�ZdS)�
FormatControlzGHelper for managing formats from which a package can be installed.
    NcCs,|dkrt�}|dkrt�}||_||_dS�N)�set�	no_binary�only_binary)�selfrr�r�G/usr/lib/python3.8/site-packages/pip/_internal/models/format_control.py�__init__szFormatControl.__init__cCs|j|jkSr	)�__dict__�r
�otherrrr�__eq__szFormatControl.__eq__cCs|�|�Sr	)rrrrr�__ne__szFormatControl.__ne__cCsd�|jj|j|j�S)Nz
{}({}, {}))�format�	__class__�__name__rr�r
rrr�__repr__"s
�zFormatControl.__repr__cCs�|�d�rtd��|�d�}d|kr`|��|��|�d�|d|�d�d�=d|krdSq|D]2}|dkrz|��qdt|�}|�|�|�|�qddS)N�-z7--no-binary / --only-binary option requires 1 argument.�,�:all:�z:none:)�
startswithr�split�clear�add�indexr�discard)�value�targetr�new�namerrr�handle_mutual_excludes)s&
�


z$FormatControl.handle_mutual_excludescCsfddh}||jkr|�d�n@||jkr4|�d�n*d|jkrJ|�d�nd|jkr^|�d�t|�S)NZbinary�sourcer)rr$r�	frozenset)r
Zcanonical_name�resultrrr�get_allowed_formatsAs




z!FormatControl.get_allowed_formatscCs|�d|j|j�dS)Nr)r)rrrrrr�disallow_binariesNs
�zFormatControl.disallow_binaries)NN)r�
__module__�__qualname__�__doc__rrrr�staticmethodr)r-r.rrrrrs



rN)Zpip._vendor.packaging.utilsrZpip._internal.exceptionsrZpip._internal.utils.typingr�typingrrr�objectrrrrr�<module>s
site-packages/pip/_internal/models/__pycache__/target_python.cpython-38.pyc000064400000006200151446176770023061 0ustar00U

��.e��@shddlZddlmZmZddlmZddlmZerTddlm	Z	m
Z
mZddlmZGdd�de
�ZdS)	�N)�
get_supported�version_info_to_nodot)�normalize_version_info)�MYPY_CHECK_RUNNING)�List�Optional�Tuple)�	Pep425Tagc@s*eZdZdZd	dd�Zdd�Zdd�ZdS)
�TargetPythonzx
    Encapsulates the properties of a Python interpreter one is targeting
    for a package install, download, etc.
    NcCsf||_|dkrtjdd�}nt|�}d�tt|dd���}||_||_||_	||_
||_d|_dS)a
        :param platform: A string or None. If None, searches for packages
            that are supported by the current system. Otherwise, will find
            packages that can be built on the platform passed in. These
            packages will only be downloaded for distribution: they will
            not be built locally.
        :param py_version_info: An optional tuple of ints representing the
            Python version information to use (e.g. `sys.version_info[:3]`).
            This can have length 1, 2, or 3 when provided.
        :param abi: A string or None. This is passed to pep425tags.py's
            get_supported() function as is.
        :param implementation: A string or None. This is passed to
            pep425tags.py's get_supported() function as is.
        N��.�)
�_given_py_version_info�sys�version_infor�join�map�str�abi�implementation�platform�
py_version�py_version_info�_valid_tags)�selfrrrrr�r�F/usr/lib/python3.8/site-packages/pip/_internal/models/target_python.py�__init__szTargetPython.__init__cCsZd}|jdk	r$d�dd�|jD��}d|jfd|fd|jfd|jfg}d	�d
d�|D��S)zD
        Format the given, non-None attributes for display.
        Nrcss|]}t|�VqdS)N)r)�.0�partrrr�	<genexpr>Csz,TargetPython.format_given.<locals>.<genexpr>rrrr� css&|]\}}|dk	rd�||�VqdS)Nz{}={!r})�format)r�key�valuerrrr Ms�)rrrrr)rZdisplay_versionZ
key_valuesrrr�format_given<s

��
�zTargetPython.format_givencCsJ|jdkrD|j}|dkrd}n
t|�g}t||j|j|jd�}||_|jS)z�
        Return the supported PEP 425 tags to check wheel candidates against.

        The tags are returned in order of preference (most preferred first).
        N)�versionsrr�impl)rrrrrrr)rrr&Ztagsrrr�get_tagsRs

�zTargetPython.get_tags)NNNN)�__name__�
__module__�__qualname__�__doc__rr%r(rrrrr
s�
)r
)rZpip._internal.pep425tagsrrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingrrrr	�objectr
rrrr�<module>ssite-packages/pip/_internal/models/__pycache__/__init__.cpython-38.pyc000064400000000340151446176770021730 0ustar00U

��.e?�@sdZdS)z8A package that contains models that represent entities.
N)�__doc__�rr�A/usr/lib/python3.8/site-packages/pip/_internal/models/__init__.py�<module>�site-packages/pip/_internal/models/__init__.py000064400000000077151446176770015451 0ustar00"""A package that contains models that represent entities.
"""
site-packages/pip/_internal/models/link.py000064400000015314151446176770014647 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import os
import posixpath
import re

from pip._vendor.six.moves.urllib import parse as urllib_parse

from pip._internal.utils.filetypes import WHEEL_EXTENSION
from pip._internal.utils.misc import (
    redact_auth_from_url,
    split_auth_from_netloc,
    splitext,
)
from pip._internal.utils.models import KeyBasedCompareMixin
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import path_to_url, url_to_path

if MYPY_CHECK_RUNNING:
    from typing import Optional, Text, Tuple, Union
    from pip._internal.collector import HTMLPage
    from pip._internal.utils.hashes import Hashes


class Link(KeyBasedCompareMixin):
    """Represents a parsed link from a Package Index's simple URL
    """

    def __init__(
        self,
        url,                   # type: str
        comes_from=None,       # type: Optional[Union[str, HTMLPage]]
        requires_python=None,  # type: Optional[str]
        yanked_reason=None,    # type: Optional[Text]
    ):
        # type: (...) -> None
        """
        :param url: url of the resource pointed to (href of the link)
        :param comes_from: instance of HTMLPage where the link was found,
            or string.
        :param requires_python: String containing the `Requires-Python`
            metadata field, specified in PEP 345. This may be specified by
            a data-requires-python attribute in the HTML link tag, as
            described in PEP 503.
        :param yanked_reason: the reason the file has been yanked, if the
            file has been yanked, or None if the file hasn't been yanked.
            This is the value of the "data-yanked" attribute, if present, in
            a simple repository HTML link. If the file has been yanked but
            no reason was provided, this should be the empty string. See
            PEP 592 for more information and the specification.
        """

        # url can be a UNC windows share
        if url.startswith('\\\\'):
            url = path_to_url(url)

        self._parsed_url = urllib_parse.urlsplit(url)
        # Store the url as a private attribute to prevent accidentally
        # trying to set a new value.
        self._url = url

        self.comes_from = comes_from
        self.requires_python = requires_python if requires_python else None
        self.yanked_reason = yanked_reason

        super(Link, self).__init__(key=url, defining_class=Link)

    def __str__(self):
        if self.requires_python:
            rp = ' (requires-python:%s)' % self.requires_python
        else:
            rp = ''
        if self.comes_from:
            return '%s (from %s)%s' % (redact_auth_from_url(self._url),
                                       self.comes_from, rp)
        else:
            return redact_auth_from_url(str(self._url))

    def __repr__(self):
        return '<Link %s>' % self

    @property
    def url(self):
        # type: () -> str
        return self._url

    @property
    def filename(self):
        # type: () -> str
        path = self.path.rstrip('/')
        name = posixpath.basename(path)
        if not name:
            # Make sure we don't leak auth information if the netloc
            # includes a username and password.
            netloc, user_pass = split_auth_from_netloc(self.netloc)
            return netloc

        name = urllib_parse.unquote(name)
        assert name, ('URL %r produced no filename' % self._url)
        return name

    @property
    def file_path(self):
        # type: () -> str
        return url_to_path(self.url)

    @property
    def scheme(self):
        # type: () -> str
        return self._parsed_url.scheme

    @property
    def netloc(self):
        # type: () -> str
        """
        This can contain auth information.
        """
        return self._parsed_url.netloc

    @property
    def path(self):
        # type: () -> str
        return urllib_parse.unquote(self._parsed_url.path)

    def splitext(self):
        # type: () -> Tuple[str, str]
        return splitext(posixpath.basename(self.path.rstrip('/')))

    @property
    def ext(self):
        # type: () -> str
        return self.splitext()[1]

    @property
    def url_without_fragment(self):
        # type: () -> str
        scheme, netloc, path, query, fragment = self._parsed_url
        return urllib_parse.urlunsplit((scheme, netloc, path, query, None))

    _egg_fragment_re = re.compile(r'[#&]egg=([^&]*)')

    @property
    def egg_fragment(self):
        # type: () -> Optional[str]
        match = self._egg_fragment_re.search(self._url)
        if not match:
            return None
        return match.group(1)

    _subdirectory_fragment_re = re.compile(r'[#&]subdirectory=([^&]*)')

    @property
    def subdirectory_fragment(self):
        # type: () -> Optional[str]
        match = self._subdirectory_fragment_re.search(self._url)
        if not match:
            return None
        return match.group(1)

    _hash_re = re.compile(
        r'(sha1|sha224|sha384|sha256|sha512|md5)=([a-f0-9]+)'
    )

    @property
    def hash(self):
        # type: () -> Optional[str]
        match = self._hash_re.search(self._url)
        if match:
            return match.group(2)
        return None

    @property
    def hash_name(self):
        # type: () -> Optional[str]
        match = self._hash_re.search(self._url)
        if match:
            return match.group(1)
        return None

    @property
    def show_url(self):
        # type: () -> Optional[str]
        return posixpath.basename(self._url.split('#', 1)[0].split('?', 1)[0])

    @property
    def is_file(self):
        # type: () -> bool
        return self.scheme == 'file'

    def is_existing_dir(self):
        # type: () -> bool
        return self.is_file and os.path.isdir(self.file_path)

    @property
    def is_wheel(self):
        # type: () -> bool
        return self.ext == WHEEL_EXTENSION

    @property
    def is_vcs(self):
        # type: () -> bool
        from pip._internal.vcs import vcs

        return self.scheme in vcs.all_schemes

    @property
    def is_yanked(self):
        # type: () -> bool
        return self.yanked_reason is not None

    @property
    def has_hash(self):
        return self.hash_name is not None

    def is_hash_allowed(self, hashes):
        # type: (Optional[Hashes]) -> bool
        """
        Return True if the link has a hash and it is allowed.
        """
        if hashes is None or not self.has_hash:
            return False
        # Assert non-None so mypy knows self.hash_name and self.hash are str.
        assert self.hash_name is not None
        assert self.hash is not None

        return hashes.is_hash_allowed(self.hash_name, hex_digest=self.hash)
site-packages/pip/_internal/models/candidate.py000064400000002375151446176770015631 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from pip._vendor.packaging.version import parse as parse_version

from pip._internal.utils.models import KeyBasedCompareMixin
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from pip._vendor.packaging.version import _BaseVersion
    from pip._internal.models.link import Link
    from typing import Any


class InstallationCandidate(KeyBasedCompareMixin):
    """Represents a potential "candidate" for installation.
    """

    def __init__(self, project, version, link):
        # type: (Any, str, Link) -> None
        self.project = project
        self.version = parse_version(version)  # type: _BaseVersion
        self.link = link

        super(InstallationCandidate, self).__init__(
            key=(self.project, self.version, self.link),
            defining_class=InstallationCandidate
        )

    def __repr__(self):
        # type: () -> str
        return "<InstallationCandidate({!r}, {!r}, {!r})>".format(
            self.project, self.version, self.link,
        )

    def __str__(self):
        return '{!r} candidate (version {} at {})'.format(
            self.project, self.version, self.link,
        )
site-packages/pip/_internal/models/format_control.py000064400000005040151446176770016735 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from pip._vendor.packaging.utils import canonicalize_name

from pip._internal.exceptions import CommandError
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional, Set, FrozenSet


class FormatControl(object):
    """Helper for managing formats from which a package can be installed.
    """

    def __init__(self, no_binary=None, only_binary=None):
        # type: (Optional[Set], Optional[Set]) -> None
        if no_binary is None:
            no_binary = set()
        if only_binary is None:
            only_binary = set()

        self.no_binary = no_binary
        self.only_binary = only_binary

    def __eq__(self, other):
        return self.__dict__ == other.__dict__

    def __ne__(self, other):
        return not self.__eq__(other)

    def __repr__(self):
        return "{}({}, {})".format(
            self.__class__.__name__,
            self.no_binary,
            self.only_binary
        )

    @staticmethod
    def handle_mutual_excludes(value, target, other):
        # type: (str, Optional[Set], Optional[Set]) -> None
        if value.startswith('-'):
            raise CommandError(
                "--no-binary / --only-binary option requires 1 argument."
            )
        new = value.split(',')
        while ':all:' in new:
            other.clear()
            target.clear()
            target.add(':all:')
            del new[:new.index(':all:') + 1]
            # Without a none, we want to discard everything as :all: covers it
            if ':none:' not in new:
                return
        for name in new:
            if name == ':none:':
                target.clear()
                continue
            name = canonicalize_name(name)
            other.discard(name)
            target.add(name)

    def get_allowed_formats(self, canonical_name):
        # type: (str) -> FrozenSet
        result = {"binary", "source"}
        if canonical_name in self.only_binary:
            result.discard('source')
        elif canonical_name in self.no_binary:
            result.discard('binary')
        elif ':all:' in self.only_binary:
            result.discard('source')
        elif ':all:' in self.no_binary:
            result.discard('binary')
        return frozenset(result)

    def disallow_binaries(self):
        # type: () -> None
        self.handle_mutual_excludes(
            ':all:', self.no_binary, self.only_binary,
        )
site-packages/pip/_internal/models/index.py000064400000002044151446176770015015 0ustar00from pip._vendor.six.moves.urllib import parse as urllib_parse


class PackageIndex(object):
    """Represents a Package Index and provides easier access to endpoints
    """

    def __init__(self, url, file_storage_domain):
        # type: (str, str) -> None
        super(PackageIndex, self).__init__()
        self.url = url
        self.netloc = urllib_parse.urlsplit(url).netloc
        self.simple_url = self._url_for_path('simple')
        self.pypi_url = self._url_for_path('pypi')

        # This is part of a temporary hack used to block installs of PyPI
        # packages which depend on external urls only necessary until PyPI can
        # block such packages themselves
        self.file_storage_domain = file_storage_domain

    def _url_for_path(self, path):
        # type: (str) -> str
        return urllib_parse.urljoin(self.url, path)


PyPI = PackageIndex(
    'https://pypi.org/', file_storage_domain='files.pythonhosted.org'
)
TestPyPI = PackageIndex(
    'https://test.pypi.org/', file_storage_domain='test-files.pythonhosted.org'
)
site-packages/pip/_internal/models/selection_prefs.py000064400000003564151446176770017102 0ustar00from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional
    from pip._internal.models.format_control import FormatControl


class SelectionPreferences(object):

    """
    Encapsulates the candidate selection preferences for downloading
    and installing files.
    """

    # Don't include an allow_yanked default value to make sure each call
    # site considers whether yanked releases are allowed. This also causes
    # that decision to be made explicit in the calling code, which helps
    # people when reading the code.
    def __init__(
        self,
        allow_yanked,  # type: bool
        allow_all_prereleases=False,  # type: bool
        format_control=None,          # type: Optional[FormatControl]
        prefer_binary=False,          # type: bool
        ignore_requires_python=None,  # type: Optional[bool]
    ):
        # type: (...) -> None
        """Create a SelectionPreferences object.

        :param allow_yanked: Whether files marked as yanked (in the sense
            of PEP 592) are permitted to be candidates for install.
        :param format_control: A FormatControl object or None. Used to control
            the selection of source packages / binary packages when consulting
            the index and links.
        :param prefer_binary: Whether to prefer an old, but valid, binary
            dist over a new source dist.
        :param ignore_requires_python: Whether to ignore incompatible
            "Requires-Python" values in links. Defaults to False.
        """
        if ignore_requires_python is None:
            ignore_requires_python = False

        self.allow_yanked = allow_yanked
        self.allow_all_prereleases = allow_all_prereleases
        self.format_control = format_control
        self.prefer_binary = prefer_binary
        self.ignore_requires_python = ignore_requires_python
site-packages/pip/_internal/legacy_resolve.py000064400000041522151446176770015432 0ustar00"""Dependency Resolution

The dependency resolution in pip is performed as follows:

for top-level requirements:
    a. only one spec allowed per project, regardless of conflicts or not.
       otherwise a "double requirement" exception is raised
    b. they override sub-dependency requirements.
for sub-dependencies
    a. "first found, wins" (where the order is breadth first)
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

import logging
import sys
from collections import defaultdict
from itertools import chain

from pip._vendor.packaging import specifiers

from pip._internal.exceptions import (
    BestVersionAlreadyInstalled,
    DistributionNotFound,
    HashError,
    HashErrors,
    UnsupportedPythonVersion,
)
from pip._internal.utils.logging import indent_log
from pip._internal.utils.misc import (
    dist_in_install_path,
    dist_in_usersite,
    ensure_dir,
    normalize_version_info,
)
from pip._internal.utils.packaging import (
    check_requires_python,
    get_requires_python,
)
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Callable, DefaultDict, List, Optional, Set, Tuple
    from pip._vendor import pkg_resources

    from pip._internal.distributions import AbstractDistribution
    from pip._internal.network.session import PipSession
    from pip._internal.index import PackageFinder
    from pip._internal.operations.prepare import RequirementPreparer
    from pip._internal.req.req_install import InstallRequirement
    from pip._internal.req.req_set import RequirementSet

    InstallRequirementProvider = Callable[
        [str, InstallRequirement], InstallRequirement
    ]

logger = logging.getLogger(__name__)


def _check_dist_requires_python(
    dist,  # type: pkg_resources.Distribution
    version_info,  # type: Tuple[int, int, int]
    ignore_requires_python=False,  # type: bool
):
    # type: (...) -> None
    """
    Check whether the given Python version is compatible with a distribution's
    "Requires-Python" value.

    :param version_info: A 3-tuple of ints representing the Python
        major-minor-micro version to check.
    :param ignore_requires_python: Whether to ignore the "Requires-Python"
        value if the given Python version isn't compatible.

    :raises UnsupportedPythonVersion: When the given Python version isn't
        compatible.
    """
    requires_python = get_requires_python(dist)
    try:
        is_compatible = check_requires_python(
            requires_python, version_info=version_info,
        )
    except specifiers.InvalidSpecifier as exc:
        logger.warning(
            "Package %r has an invalid Requires-Python: %s",
            dist.project_name, exc,
        )
        return

    if is_compatible:
        return

    version = '.'.join(map(str, version_info))
    if ignore_requires_python:
        logger.debug(
            'Ignoring failed Requires-Python check for package %r: '
            '%s not in %r',
            dist.project_name, version, requires_python,
        )
        return

    raise UnsupportedPythonVersion(
        'Package {!r} requires a different Python: {} not in {!r}'.format(
            dist.project_name, version, requires_python,
        ))


class Resolver(object):
    """Resolves which packages need to be installed/uninstalled to perform \
    the requested operation without breaking the requirements of any package.
    """

    _allowed_strategies = {"eager", "only-if-needed", "to-satisfy-only"}

    def __init__(
        self,
        preparer,  # type: RequirementPreparer
        session,  # type: PipSession
        finder,  # type: PackageFinder
        make_install_req,  # type: InstallRequirementProvider
        use_user_site,  # type: bool
        ignore_dependencies,  # type: bool
        ignore_installed,  # type: bool
        ignore_requires_python,  # type: bool
        force_reinstall,  # type: bool
        upgrade_strategy,  # type: str
        py_version_info=None,  # type: Optional[Tuple[int, ...]]
    ):
        # type: (...) -> None
        super(Resolver, self).__init__()
        assert upgrade_strategy in self._allowed_strategies

        if py_version_info is None:
            py_version_info = sys.version_info[:3]
        else:
            py_version_info = normalize_version_info(py_version_info)

        self._py_version_info = py_version_info

        self.preparer = preparer
        self.finder = finder
        self.session = session

        # This is set in resolve
        self.require_hashes = None  # type: Optional[bool]

        self.upgrade_strategy = upgrade_strategy
        self.force_reinstall = force_reinstall
        self.ignore_dependencies = ignore_dependencies
        self.ignore_installed = ignore_installed
        self.ignore_requires_python = ignore_requires_python
        self.use_user_site = use_user_site
        self._make_install_req = make_install_req

        self._discovered_dependencies = \
            defaultdict(list)  # type: DefaultDict[str, List]

    def resolve(self, requirement_set):
        # type: (RequirementSet) -> None
        """Resolve what operations need to be done

        As a side-effect of this method, the packages (and their dependencies)
        are downloaded, unpacked and prepared for installation. This
        preparation is done by ``pip.operations.prepare``.

        Once PyPI has static dependency metadata available, it would be
        possible to move the preparation to become a step separated from
        dependency resolution.
        """
        # make the wheelhouse
        if self.preparer.wheel_download_dir:
            ensure_dir(self.preparer.wheel_download_dir)

        # If any top-level requirement has a hash specified, enter
        # hash-checking mode, which requires hashes from all.
        root_reqs = (
            requirement_set.unnamed_requirements +
            list(requirement_set.requirements.values())
        )
        self.require_hashes = (
            requirement_set.require_hashes or
            any(req.has_hash_options for req in root_reqs)
        )

        # Display where finder is looking for packages
        search_scope = self.finder.search_scope
        locations = search_scope.get_formatted_locations()
        if locations:
            logger.info(locations)

        # Actually prepare the files, and collect any exceptions. Most hash
        # exceptions cannot be checked ahead of time, because
        # req.populate_link() needs to be called before we can make decisions
        # based on link type.
        discovered_reqs = []  # type: List[InstallRequirement]
        hash_errors = HashErrors()
        for req in chain(root_reqs, discovered_reqs):
            try:
                discovered_reqs.extend(
                    self._resolve_one(requirement_set, req)
                )
            except HashError as exc:
                exc.req = req
                hash_errors.append(exc)

        if hash_errors:
            raise hash_errors

    def _is_upgrade_allowed(self, req):
        # type: (InstallRequirement) -> bool
        if self.upgrade_strategy == "to-satisfy-only":
            return False
        elif self.upgrade_strategy == "eager":
            return True
        else:
            assert self.upgrade_strategy == "only-if-needed"
            return req.is_direct

    def _set_req_to_reinstall(self, req):
        # type: (InstallRequirement) -> None
        """
        Set a requirement to be installed.
        """
        # Don't uninstall the conflict if doing a user install and the
        # conflict is not a user install.
        if ((not self.use_user_site
                or dist_in_usersite(req.satisfied_by))
                and dist_in_install_path(req.satisfied_by)):
            req.conflicts_with = req.satisfied_by
        req.satisfied_by = None

    def _check_skip_installed(self, req_to_install):
        # type: (InstallRequirement) -> Optional[str]
        """Check if req_to_install should be skipped.

        This will check if the req is installed, and whether we should upgrade
        or reinstall it, taking into account all the relevant user options.

        After calling this req_to_install will only have satisfied_by set to
        None if the req_to_install is to be upgraded/reinstalled etc. Any
        other value will be a dist recording the current thing installed that
        satisfies the requirement.

        Note that for vcs urls and the like we can't assess skipping in this
        routine - we simply identify that we need to pull the thing down,
        then later on it is pulled down and introspected to assess upgrade/
        reinstalls etc.

        :return: A text reason for why it was skipped, or None.
        """
        if self.ignore_installed:
            return None

        req_to_install.check_if_exists(self.use_user_site)
        if not req_to_install.satisfied_by:
            return None

        if self.force_reinstall:
            self._set_req_to_reinstall(req_to_install)
            return None

        if not self._is_upgrade_allowed(req_to_install):
            if self.upgrade_strategy == "only-if-needed":
                return 'already satisfied, skipping upgrade'
            return 'already satisfied'

        # Check for the possibility of an upgrade.  For link-based
        # requirements we have to pull the tree down and inspect to assess
        # the version #, so it's handled way down.
        if not req_to_install.link:
            try:
                self.finder.find_requirement(req_to_install, upgrade=True)
            except BestVersionAlreadyInstalled:
                # Then the best version is installed.
                return 'already up-to-date'
            except DistributionNotFound:
                # No distribution found, so we squash the error.  It will
                # be raised later when we re-try later to do the install.
                # Why don't we just raise here?
                pass

        self._set_req_to_reinstall(req_to_install)
        return None

    def _get_abstract_dist_for(self, req):
        # type: (InstallRequirement) -> AbstractDistribution
        """Takes a InstallRequirement and returns a single AbstractDist \
        representing a prepared variant of the same.
        """
        assert self.require_hashes is not None, (
            "require_hashes should have been set in Resolver.resolve()"
        )

        if req.editable:
            return self.preparer.prepare_editable_requirement(
                req, self.require_hashes, self.use_user_site, self.finder,
            )

        # satisfied_by is only evaluated by calling _check_skip_installed,
        # so it must be None here.
        assert req.satisfied_by is None
        skip_reason = self._check_skip_installed(req)

        if req.satisfied_by:
            return self.preparer.prepare_installed_requirement(
                req, self.require_hashes, skip_reason
            )

        upgrade_allowed = self._is_upgrade_allowed(req)

        # We eagerly populate the link, since that's our "legacy" behavior.
        req.populate_link(self.finder, upgrade_allowed, self.require_hashes)
        abstract_dist = self.preparer.prepare_linked_requirement(
            req, self.session, self.finder, self.require_hashes
        )

        # NOTE
        # The following portion is for determining if a certain package is
        # going to be re-installed/upgraded or not and reporting to the user.
        # This should probably get cleaned up in a future refactor.

        # req.req is only avail after unpack for URL
        # pkgs repeat check_if_exists to uninstall-on-upgrade
        # (#14)
        if not self.ignore_installed:
            req.check_if_exists(self.use_user_site)

        if req.satisfied_by:
            should_modify = (
                self.upgrade_strategy != "to-satisfy-only" or
                self.force_reinstall or
                self.ignore_installed or
                req.link.scheme == 'file'
            )
            if should_modify:
                self._set_req_to_reinstall(req)
            else:
                logger.info(
                    'Requirement already satisfied (use --upgrade to upgrade):'
                    ' %s', req,
                )

        return abstract_dist

    def _resolve_one(
        self,
        requirement_set,  # type: RequirementSet
        req_to_install  # type: InstallRequirement
    ):
        # type: (...) -> List[InstallRequirement]
        """Prepare a single requirements file.

        :return: A list of additional InstallRequirements to also install.
        """
        # Tell user what we are doing for this requirement:
        # obtain (editable), skipping, processing (local url), collecting
        # (remote url or package name)
        if req_to_install.constraint or req_to_install.prepared:
            return []

        req_to_install.prepared = True

        # register tmp src for cleanup in case something goes wrong
        requirement_set.reqs_to_cleanup.append(req_to_install)

        abstract_dist = self._get_abstract_dist_for(req_to_install)

        # Parse and return dependencies
        dist = abstract_dist.get_pkg_resources_distribution()
        # This will raise UnsupportedPythonVersion if the given Python
        # version isn't compatible with the distribution's Requires-Python.
        _check_dist_requires_python(
            dist, version_info=self._py_version_info,
            ignore_requires_python=self.ignore_requires_python,
        )

        more_reqs = []  # type: List[InstallRequirement]

        def add_req(subreq, extras_requested):
            sub_install_req = self._make_install_req(
                str(subreq),
                req_to_install,
            )
            parent_req_name = req_to_install.name
            to_scan_again, add_to_parent = requirement_set.add_requirement(
                sub_install_req,
                parent_req_name=parent_req_name,
                extras_requested=extras_requested,
            )
            if parent_req_name and add_to_parent:
                self._discovered_dependencies[parent_req_name].append(
                    add_to_parent
                )
            more_reqs.extend(to_scan_again)

        with indent_log():
            # We add req_to_install before its dependencies, so that we
            # can refer to it when adding dependencies.
            if not requirement_set.has_requirement(req_to_install.name):
                # 'unnamed' requirements will get added here
                req_to_install.is_direct = True
                requirement_set.add_requirement(
                    req_to_install, parent_req_name=None,
                )

            if not self.ignore_dependencies:
                if req_to_install.extras:
                    logger.debug(
                        "Installing extra requirements: %r",
                        ','.join(req_to_install.extras),
                    )
                missing_requested = sorted(
                    set(req_to_install.extras) - set(dist.extras)
                )
                for missing in missing_requested:
                    logger.warning(
                        '%s does not provide the extra \'%s\'',
                        dist, missing
                    )

                available_requested = sorted(
                    set(dist.extras) & set(req_to_install.extras)
                )
                for subreq in dist.requires(available_requested):
                    add_req(subreq, extras_requested=available_requested)

            if not req_to_install.editable and not req_to_install.satisfied_by:
                # XXX: --no-install leads this to report 'Successfully
                # downloaded' for only non-editable reqs, even though we took
                # action on them.
                requirement_set.successfully_downloaded.append(req_to_install)

        return more_reqs

    def get_installation_order(self, req_set):
        # type: (RequirementSet) -> List[InstallRequirement]
        """Create the installation order.

        The installation order is topological - requirements are installed
        before the requiring thing. We break cycles at an arbitrary point,
        and make no other guarantees.
        """
        # The current implementation, which we may change at any point
        # installs the user specified things in the order given, except when
        # dependencies must come earlier to achieve topological order.
        order = []
        ordered_reqs = set()  # type: Set[InstallRequirement]

        def schedule(req):
            if req.satisfied_by or req in ordered_reqs:
                return
            if req.constraint:
                return
            ordered_reqs.add(req)
            for dep in self._discovered_dependencies[req.name]:
                schedule(dep)
            order.append(req)

        for install_req in req_set.requirements.values():
            schedule(install_req)
        return order
site-packages/pip/_internal/req/req_uninstall.py000064400000056046151446176770016105 0ustar00from __future__ import absolute_import

import csv
import functools
import logging
import os
import sys
import sysconfig

from pip._vendor import pkg_resources

from pip._internal.exceptions import UninstallationError
from pip._internal.locations import bin_py, bin_user
from pip._internal.utils.compat import WINDOWS, cache_from_source, uses_pycache
from pip._internal.utils.logging import indent_log
from pip._internal.utils.misc import (
    FakeFile,
    ask,
    dist_in_usersite,
    dist_is_local,
    egg_link_path,
    is_local,
    normalize_path,
    renames,
    rmtree,
)
from pip._internal.utils.temp_dir import AdjacentTempDirectory, TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, Callable, Dict, Iterable, Iterator, List, Optional, Set, Tuple,
    )
    from pip._vendor.pkg_resources import Distribution

logger = logging.getLogger(__name__)


def _script_names(dist, script_name, is_gui):
    # type: (Distribution, str, bool) -> List[str]
    """Create the fully qualified name of the files created by
    {console,gui}_scripts for the given ``dist``.
    Returns the list of file names
    """
    if dist_in_usersite(dist):
        bin_dir = bin_user
    else:
        bin_dir = bin_py
    exe_name = os.path.join(bin_dir, script_name)
    paths_to_remove = [exe_name]
    if WINDOWS:
        paths_to_remove.append(exe_name + '.exe')
        paths_to_remove.append(exe_name + '.exe.manifest')
        if is_gui:
            paths_to_remove.append(exe_name + '-script.pyw')
        else:
            paths_to_remove.append(exe_name + '-script.py')
    return paths_to_remove


def _unique(fn):
    # type: (Callable) -> Callable[..., Iterator[Any]]
    @functools.wraps(fn)
    def unique(*args, **kw):
        # type: (Any, Any) -> Iterator[Any]
        seen = set()  # type: Set[Any]
        for item in fn(*args, **kw):
            if item not in seen:
                seen.add(item)
                yield item
    return unique


@_unique
def uninstallation_paths(dist):
    # type: (Distribution) -> Iterator[str]
    """
    Yield all the uninstallation paths for dist based on RECORD-without-.py[co]

    Yield paths to all the files in RECORD. For each .py file in RECORD, add
    the .pyc and .pyo in the same directory.

    UninstallPathSet.add() takes care of the __pycache__ .py[co].
    """
    r = csv.reader(FakeFile(dist.get_metadata_lines('RECORD')))
    for row in r:
        path = os.path.join(dist.location, row[0])
        yield path
        if path.endswith('.py'):
            dn, fn = os.path.split(path)
            base = fn[:-3]
            path = os.path.join(dn, base + '.pyc')
            yield path
            path = os.path.join(dn, base + '.pyo')
            yield path


def compact(paths):
    # type: (Iterable[str]) -> Set[str]
    """Compact a path set to contain the minimal number of paths
    necessary to contain all paths in the set. If /a/path/ and
    /a/path/to/a/file.txt are both in the set, leave only the
    shorter path."""

    sep = os.path.sep
    short_paths = set()  # type: Set[str]
    for path in sorted(paths, key=len):
        should_skip = any(
            path.startswith(shortpath.rstrip("*")) and
            path[len(shortpath.rstrip("*").rstrip(sep))] == sep
            for shortpath in short_paths
        )
        if not should_skip:
            short_paths.add(path)
    return short_paths


def compress_for_rename(paths):
    # type: (Iterable[str]) -> Set[str]
    """Returns a set containing the paths that need to be renamed.

    This set may include directories when the original sequence of paths
    included every file on disk.
    """
    case_map = dict((os.path.normcase(p), p) for p in paths)
    remaining = set(case_map)
    unchecked = sorted(set(os.path.split(p)[0]
                           for p in case_map.values()), key=len)
    wildcards = set()  # type: Set[str]

    def norm_join(*a):
        # type: (str) -> str
        return os.path.normcase(os.path.join(*a))

    for root in unchecked:
        if any(os.path.normcase(root).startswith(w)
               for w in wildcards):
            # This directory has already been handled.
            continue

        all_files = set()  # type: Set[str]
        all_subdirs = set()  # type: Set[str]
        for dirname, subdirs, files in os.walk(root):
            all_subdirs.update(norm_join(root, dirname, d)
                               for d in subdirs)
            all_files.update(norm_join(root, dirname, f)
                             for f in files)
        # If all the files we found are in our remaining set of files to
        # remove, then remove them from the latter set and add a wildcard
        # for the directory.
        if not (all_files - remaining):
            remaining.difference_update(all_files)
            wildcards.add(root + os.sep)

    return set(map(case_map.__getitem__, remaining)) | wildcards


def compress_for_output_listing(paths):
    # type: (Iterable[str]) -> Tuple[Set[str], Set[str]]
    """Returns a tuple of 2 sets of which paths to display to user

    The first set contains paths that would be deleted. Files of a package
    are not added and the top-level directory of the package has a '*' added
    at the end - to signify that all it's contents are removed.

    The second set contains files that would have been skipped in the above
    folders.
    """

    will_remove = set(paths)
    will_skip = set()

    # Determine folders and files
    folders = set()
    files = set()
    for path in will_remove:
        if path.endswith(".pyc"):
            continue
        if path.endswith("__init__.py") or ".dist-info" in path:
            folders.add(os.path.dirname(path))
        files.add(path)

    # probably this one https://github.com/python/mypy/issues/390
    _normcased_files = set(map(os.path.normcase, files))  # type: ignore

    folders = compact(folders)

    # This walks the tree using os.walk to not miss extra folders
    # that might get added.
    for folder in folders:
        for dirpath, _, dirfiles in os.walk(folder):
            for fname in dirfiles:
                if fname.endswith(".pyc"):
                    continue

                file_ = os.path.join(dirpath, fname)
                if (os.path.isfile(file_) and
                        os.path.normcase(file_) not in _normcased_files):
                    # We are skipping this file. Add it to the set.
                    will_skip.add(file_)

    will_remove = files | {
        os.path.join(folder, "*") for folder in folders
    }

    return will_remove, will_skip


class StashedUninstallPathSet(object):
    """A set of file rename operations to stash files while
    tentatively uninstalling them."""
    def __init__(self):
        # type: () -> None
        # Mapping from source file root to [Adjacent]TempDirectory
        # for files under that directory.
        self._save_dirs = {}  # type: Dict[str, TempDirectory]
        # (old path, new path) tuples for each move that may need
        # to be undone.
        self._moves = []  # type: List[Tuple[str, str]]

    def _get_directory_stash(self, path):
        # type: (str) -> str
        """Stashes a directory.

        Directories are stashed adjacent to their original location if
        possible, or else moved/copied into the user's temp dir."""

        try:
            save_dir = AdjacentTempDirectory(path)  # type: TempDirectory
        except OSError:
            save_dir = TempDirectory(kind="uninstall")
        self._save_dirs[os.path.normcase(path)] = save_dir

        return save_dir.path

    def _get_file_stash(self, path):
        # type: (str) -> str
        """Stashes a file.

        If no root has been provided, one will be created for the directory
        in the user's temp directory."""
        path = os.path.normcase(path)
        head, old_head = os.path.dirname(path), None
        save_dir = None

        while head != old_head:
            try:
                save_dir = self._save_dirs[head]
                break
            except KeyError:
                pass
            head, old_head = os.path.dirname(head), head
        else:
            # Did not find any suitable root
            head = os.path.dirname(path)
            save_dir = TempDirectory(kind='uninstall')
            self._save_dirs[head] = save_dir

        relpath = os.path.relpath(path, head)
        if relpath and relpath != os.path.curdir:
            return os.path.join(save_dir.path, relpath)
        return save_dir.path

    def stash(self, path):
        # type: (str) -> str
        """Stashes the directory or file and returns its new location.
        Handle symlinks as files to avoid modifying the symlink targets.
        """
        path_is_dir = os.path.isdir(path) and not os.path.islink(path)
        if path_is_dir:
            new_path = self._get_directory_stash(path)
        else:
            new_path = self._get_file_stash(path)

        self._moves.append((path, new_path))
        if (path_is_dir and os.path.isdir(new_path)):
            # If we're moving a directory, we need to
            # remove the destination first or else it will be
            # moved to inside the existing directory.
            # We just created new_path ourselves, so it will
            # be removable.
            os.rmdir(new_path)
        renames(path, new_path)
        return new_path

    def commit(self):
        # type: () -> None
        """Commits the uninstall by removing stashed files."""
        for _, save_dir in self._save_dirs.items():
            save_dir.cleanup()
        self._moves = []
        self._save_dirs = {}

    def rollback(self):
        # type: () -> None
        """Undoes the uninstall by moving stashed files back."""
        for p in self._moves:
            logging.info("Moving to %s\n from %s", *p)

        for new_path, path in self._moves:
            try:
                logger.debug('Replacing %s from %s', new_path, path)
                if os.path.isfile(new_path) or os.path.islink(new_path):
                    os.unlink(new_path)
                elif os.path.isdir(new_path):
                    rmtree(new_path)
                renames(path, new_path)
            except OSError as ex:
                logger.error("Failed to restore %s", new_path)
                logger.debug("Exception: %s", ex)

        self.commit()

    @property
    def can_rollback(self):
        # type: () -> bool
        return bool(self._moves)


class UninstallPathSet(object):
    """A set of file paths to be removed in the uninstallation of a
    requirement."""
    def __init__(self, dist):
        # type: (Distribution) -> None
        self.paths = set()  # type: Set[str]
        self._refuse = set()  # type: Set[str]
        self.pth = {}  # type: Dict[str, UninstallPthEntries]
        self.dist = dist
        self._moved_paths = StashedUninstallPathSet()

    def _permitted(self, path):
        # type: (str) -> bool
        """
        Return True if the given path is one we are permitted to
        remove/modify, False otherwise.

        """
        return is_local(path)

    def add(self, path):
        # type: (str) -> None
        head, tail = os.path.split(path)

        # we normalize the head to resolve parent directory symlinks, but not
        # the tail, since we only want to uninstall symlinks, not their targets
        path = os.path.join(normalize_path(head), os.path.normcase(tail))

        if not os.path.exists(path):
            return
        if self._permitted(path):
            self.paths.add(path)
        else:
            self._refuse.add(path)

        # __pycache__ files can show up after 'installed-files.txt' is created,
        # due to imports
        if os.path.splitext(path)[1] == '.py' and uses_pycache:
            self.add(cache_from_source(path))

    def add_pth(self, pth_file, entry):
        # type: (str, str) -> None
        pth_file = normalize_path(pth_file)
        if self._permitted(pth_file):
            if pth_file not in self.pth:
                self.pth[pth_file] = UninstallPthEntries(pth_file)
            self.pth[pth_file].add(entry)
        else:
            self._refuse.add(pth_file)

    def remove(self, auto_confirm=False, verbose=False):
        # type: (bool, bool) -> None
        """Remove paths in ``self.paths`` with confirmation (unless
        ``auto_confirm`` is True)."""

        if not self.paths:
            logger.info(
                "Can't uninstall '%s'. No files were found to uninstall.",
                self.dist.project_name,
            )
            return

        dist_name_version = (
            self.dist.project_name + "-" + self.dist.version
        )
        logger.info('Uninstalling %s:', dist_name_version)

        with indent_log():
            if auto_confirm or self._allowed_to_proceed(verbose):
                moved = self._moved_paths

                for_rename = compress_for_rename(self.paths)

                for path in sorted(compact(for_rename)):
                    moved.stash(path)
                    logger.debug('Removing file or directory %s', path)

                for pth in self.pth.values():
                    pth.remove()

                logger.info('Successfully uninstalled %s', dist_name_version)

    def _allowed_to_proceed(self, verbose):
        # type: (bool) -> bool
        """Display which files would be deleted and prompt for confirmation
        """

        def _display(msg, paths):
            # type: (str, Iterable[str]) -> None
            if not paths:
                return

            logger.info(msg)
            with indent_log():
                for path in sorted(compact(paths)):
                    logger.info(path)

        if not verbose:
            will_remove, will_skip = compress_for_output_listing(self.paths)
        else:
            # In verbose mode, display all the files that are going to be
            # deleted.
            will_remove = set(self.paths)
            will_skip = set()

        _display('Would remove:', will_remove)
        _display('Would not remove (might be manually added):', will_skip)
        _display('Would not remove (outside of prefix):', self._refuse)
        if verbose:
            _display('Will actually move:', compress_for_rename(self.paths))

        return ask('Proceed (y/n)? ', ('y', 'n')) == 'y'

    def rollback(self):
        # type: () -> None
        """Rollback the changes previously made by remove()."""
        if not self._moved_paths.can_rollback:
            logger.error(
                "Can't roll back %s; was not uninstalled",
                self.dist.project_name,
            )
            return
        logger.info('Rolling back uninstall of %s', self.dist.project_name)
        self._moved_paths.rollback()
        for pth in self.pth.values():
            pth.rollback()

    def commit(self):
        # type: () -> None
        """Remove temporary save dir: rollback will no longer be possible."""
        self._moved_paths.commit()

    @classmethod
    def from_dist(cls, dist):
        # type: (Distribution) -> UninstallPathSet
        dist_path = normalize_path(dist.location)
        if not dist_is_local(dist):
            logger.info(
                "Not uninstalling %s at %s, outside environment %s",
                dist.key,
                dist_path,
                sys.prefix,
            )
            return cls(dist)

        if dist_path in {p for p in {sysconfig.get_path("stdlib"),
                                     sysconfig.get_path("platstdlib")}
                         if p}:
            logger.info(
                "Not uninstalling %s at %s, as it is in the standard library.",
                dist.key,
                dist_path,
            )
            return cls(dist)

        paths_to_remove = cls(dist)
        develop_egg_link = egg_link_path(dist)
        develop_egg_link_egg_info = '{}.egg-info'.format(
            pkg_resources.to_filename(dist.project_name))
        egg_info_exists = dist.egg_info and os.path.exists(dist.egg_info)
        # Special case for distutils installed package
        distutils_egg_info = getattr(dist._provider, 'path', None)

        # Uninstall cases order do matter as in the case of 2 installs of the
        # same package, pip needs to uninstall the currently detected version
        if (egg_info_exists and dist.egg_info.endswith('.egg-info') and
                not dist.egg_info.endswith(develop_egg_link_egg_info)):
            # if dist.egg_info.endswith(develop_egg_link_egg_info), we
            # are in fact in the develop_egg_link case
            paths_to_remove.add(dist.egg_info)
            if dist.has_metadata('installed-files.txt'):
                for installed_file in dist.get_metadata(
                        'installed-files.txt').splitlines():
                    path = os.path.normpath(
                        os.path.join(dist.egg_info, installed_file)
                    )
                    paths_to_remove.add(path)
            # FIXME: need a test for this elif block
            # occurs with --single-version-externally-managed/--record outside
            # of pip
            elif dist.has_metadata('top_level.txt'):
                if dist.has_metadata('namespace_packages.txt'):
                    namespaces = dist.get_metadata('namespace_packages.txt')
                else:
                    namespaces = []
                for top_level_pkg in [
                        p for p
                        in dist.get_metadata('top_level.txt').splitlines()
                        if p and p not in namespaces]:
                    path = os.path.join(dist.location, top_level_pkg)
                    paths_to_remove.add(path)
                    paths_to_remove.add(path + '.py')
                    paths_to_remove.add(path + '.pyc')
                    paths_to_remove.add(path + '.pyo')

        elif distutils_egg_info:
            raise UninstallationError(
                "Cannot uninstall {!r}. It is a distutils installed project "
                "and thus we cannot accurately determine which files belong "
                "to it which would lead to only a partial uninstall.".format(
                    dist.project_name,
                )
            )

        elif dist.location.endswith('.egg'):
            # package installed by easy_install
            # We cannot match on dist.egg_name because it can slightly vary
            # i.e. setuptools-0.6c11-py2.6.egg vs setuptools-0.6rc11-py2.6.egg
            paths_to_remove.add(dist.location)
            easy_install_egg = os.path.split(dist.location)[1]
            easy_install_pth = os.path.join(os.path.dirname(dist.location),
                                            'easy-install.pth')
            paths_to_remove.add_pth(easy_install_pth, './' + easy_install_egg)

        elif egg_info_exists and dist.egg_info.endswith('.dist-info'):
            for path in uninstallation_paths(dist):
                paths_to_remove.add(path)

        elif develop_egg_link:
            # develop egg
            with open(develop_egg_link, 'r') as fh:
                link_pointer = os.path.normcase(fh.readline().strip())
            assert (link_pointer == dist.location), (
                'Egg-link %s does not match installed location of %s '
                '(at %s)' % (link_pointer, dist.project_name, dist.location)
            )
            paths_to_remove.add(develop_egg_link)
            easy_install_pth = os.path.join(os.path.dirname(develop_egg_link),
                                            'easy-install.pth')
            paths_to_remove.add_pth(easy_install_pth, dist.location)

        else:
            logger.debug(
                'Not sure how to uninstall: %s - Check: %s',
                dist, dist.location,
            )

        # find distutils scripts= scripts
        if dist.has_metadata('scripts') and dist.metadata_isdir('scripts'):
            for script in dist.metadata_listdir('scripts'):
                if dist_in_usersite(dist):
                    bin_dir = bin_user
                else:
                    bin_dir = bin_py
                paths_to_remove.add(os.path.join(bin_dir, script))
                if WINDOWS:
                    paths_to_remove.add(os.path.join(bin_dir, script) + '.bat')

        # find console_scripts
        _scripts_to_remove = []
        console_scripts = dist.get_entry_map(group='console_scripts')
        for name in console_scripts.keys():
            _scripts_to_remove.extend(_script_names(dist, name, False))
        # find gui_scripts
        gui_scripts = dist.get_entry_map(group='gui_scripts')
        for name in gui_scripts.keys():
            _scripts_to_remove.extend(_script_names(dist, name, True))

        for s in _scripts_to_remove:
            paths_to_remove.add(s)

        return paths_to_remove


class UninstallPthEntries(object):
    def __init__(self, pth_file):
        # type: (str) -> None
        if not os.path.isfile(pth_file):
            raise UninstallationError(
                "Cannot remove entries from nonexistent file %s" % pth_file
            )
        self.file = pth_file
        self.entries = set()  # type: Set[str]
        self._saved_lines = None  # type: Optional[List[bytes]]

    def add(self, entry):
        # type: (str) -> None
        entry = os.path.normcase(entry)
        # On Windows, os.path.normcase converts the entry to use
        # backslashes.  This is correct for entries that describe absolute
        # paths outside of site-packages, but all the others use forward
        # slashes.
        # os.path.splitdrive is used instead of os.path.isabs because isabs
        # treats non-absolute paths with drive letter markings like c:foo\bar
        # as absolute paths. It also does not recognize UNC paths if they don't
        # have more than "\\sever\share". Valid examples: "\\server\share\" or
        # "\\server\share\folder". Python 2.7.8+ support UNC in splitdrive.
        if WINDOWS and not os.path.splitdrive(entry)[0]:
            entry = entry.replace('\\', '/')
        self.entries.add(entry)

    def remove(self):
        # type: () -> None
        logger.debug('Removing pth entries from %s:', self.file)
        with open(self.file, 'rb') as fh:
            # windows uses '\r\n' with py3k, but uses '\n' with py2.x
            lines = fh.readlines()
            self._saved_lines = lines
        if any(b'\r\n' in line for line in lines):
            endline = '\r\n'
        else:
            endline = '\n'
        # handle missing trailing newline
        if lines and not lines[-1].endswith(endline.encode("utf-8")):
            lines[-1] = lines[-1] + endline.encode("utf-8")
        for entry in self.entries:
            try:
                logger.debug('Removing entry: %s', entry)
                lines.remove((entry + endline).encode("utf-8"))
            except ValueError:
                pass
        with open(self.file, 'wb') as fh:
            fh.writelines(lines)

    def rollback(self):
        # type: () -> bool
        if self._saved_lines is None:
            logger.error(
                'Cannot roll back changes to %s, none were made', self.file
            )
            return False
        logger.debug('Rolling %s back to previous state', self.file)
        with open(self.file, 'wb') as fh:
            fh.writelines(self._saved_lines)
        return True
site-packages/pip/_internal/req/req_set.py000064400000017704151446176770014665 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

from __future__ import absolute_import

import logging
from collections import OrderedDict

from pip._vendor.packaging.utils import canonicalize_name

from pip._internal import pep425tags
from pip._internal.exceptions import InstallationError
from pip._internal.utils.logging import indent_log
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.wheel import Wheel

if MYPY_CHECK_RUNNING:
    from typing import Dict, Iterable, List, Optional, Tuple
    from pip._internal.req.req_install import InstallRequirement


logger = logging.getLogger(__name__)


class RequirementSet(object):

    def __init__(self, require_hashes=False, check_supported_wheels=True):
        # type: (bool, bool) -> None
        """Create a RequirementSet.
        """

        self.requirements = OrderedDict()  # type: Dict[str, InstallRequirement]  # noqa: E501
        self.require_hashes = require_hashes
        self.check_supported_wheels = check_supported_wheels

        self.unnamed_requirements = []  # type: List[InstallRequirement]
        self.successfully_downloaded = []  # type: List[InstallRequirement]
        self.reqs_to_cleanup = []  # type: List[InstallRequirement]

    def __str__(self):
        # type: () -> str
        requirements = sorted(
            (req for req in self.requirements.values() if not req.comes_from),
            key=lambda req: canonicalize_name(req.name),
        )
        return ' '.join(str(req.req) for req in requirements)

    def __repr__(self):
        # type: () -> str
        requirements = sorted(
            self.requirements.values(),
            key=lambda req: canonicalize_name(req.name),
        )

        format_string = '<{classname} object; {count} requirement(s): {reqs}>'
        return format_string.format(
            classname=self.__class__.__name__,
            count=len(requirements),
            reqs=', '.join(str(req.req) for req in requirements),
        )

    def add_unnamed_requirement(self, install_req):
        # type: (InstallRequirement) -> None
        assert not install_req.name
        self.unnamed_requirements.append(install_req)

    def add_named_requirement(self, install_req):
        # type: (InstallRequirement) -> None
        assert install_req.name

        project_name = canonicalize_name(install_req.name)
        self.requirements[project_name] = install_req

    def add_requirement(
        self,
        install_req,  # type: InstallRequirement
        parent_req_name=None,  # type: Optional[str]
        extras_requested=None  # type: Optional[Iterable[str]]
    ):
        # type: (...) -> Tuple[List[InstallRequirement], Optional[InstallRequirement]]  # noqa: E501
        """Add install_req as a requirement to install.

        :param parent_req_name: The name of the requirement that needed this
            added. The name is used because when multiple unnamed requirements
            resolve to the same name, we could otherwise end up with dependency
            links that point outside the Requirements set. parent_req must
            already be added. Note that None implies that this is a user
            supplied requirement, vs an inferred one.
        :param extras_requested: an iterable of extras used to evaluate the
            environment markers.
        :return: Additional requirements to scan. That is either [] if
            the requirement is not applicable, or [install_req] if the
            requirement is applicable and has just been added.
        """
        # If the markers do not match, ignore this requirement.
        if not install_req.match_markers(extras_requested):
            logger.info(
                "Ignoring %s: markers '%s' don't match your environment",
                install_req.name, install_req.markers,
            )
            return [], None

        # If the wheel is not supported, raise an error.
        # Should check this after filtering out based on environment markers to
        # allow specifying different wheels based on the environment/OS, in a
        # single requirements file.
        if install_req.link and install_req.link.is_wheel:
            wheel = Wheel(install_req.link.filename)
            tags = pep425tags.get_supported()
            if (self.check_supported_wheels and not wheel.supported(tags)):
                raise InstallationError(
                    "%s is not a supported wheel on this platform." %
                    wheel.filename
                )

        # This next bit is really a sanity check.
        assert install_req.is_direct == (parent_req_name is None), (
            "a direct req shouldn't have a parent and also, "
            "a non direct req should have a parent"
        )

        # Unnamed requirements are scanned again and the requirement won't be
        # added as a dependency until after scanning.
        if not install_req.name:
            self.add_unnamed_requirement(install_req)
            return [install_req], None

        try:
            existing_req = self.get_requirement(install_req.name)
        except KeyError:
            existing_req = None

        has_conflicting_requirement = (
            parent_req_name is None and
            existing_req and
            not existing_req.constraint and
            existing_req.extras == install_req.extras and
            existing_req.req.specifier != install_req.req.specifier
        )
        if has_conflicting_requirement:
            raise InstallationError(
                "Double requirement given: %s (already in %s, name=%r)"
                % (install_req, existing_req, install_req.name)
            )

        # When no existing requirement exists, add the requirement as a
        # dependency and it will be scanned again after.
        if not existing_req:
            self.add_named_requirement(install_req)
            # We'd want to rescan this requirement later
            return [install_req], install_req

        # Assume there's no need to scan, and that we've already
        # encountered this for scanning.
        if install_req.constraint or not existing_req.constraint:
            return [], existing_req

        does_not_satisfy_constraint = (
            install_req.link and
            not (
                existing_req.link and
                install_req.link.path == existing_req.link.path
            )
        )
        if does_not_satisfy_constraint:
            self.reqs_to_cleanup.append(install_req)
            raise InstallationError(
                "Could not satisfy constraints for '%s': "
                "installation from path or url cannot be "
                "constrained to a version" % install_req.name,
            )
        # If we're now installing a constraint, mark the existing
        # object for real installation.
        existing_req.constraint = False
        existing_req.extras = tuple(sorted(
            set(existing_req.extras) | set(install_req.extras)
        ))
        logger.debug(
            "Setting %s extras to: %s",
            existing_req, existing_req.extras,
        )
        # Return the existing requirement for addition to the parent and
        # scanning again.
        return [existing_req], existing_req

    def has_requirement(self, name):
        # type: (str) -> bool
        project_name = canonicalize_name(name)

        return (
            project_name in self.requirements and
            not self.requirements[project_name].constraint
        )

    def get_requirement(self, name):
        # type: (str) -> InstallRequirement
        project_name = canonicalize_name(name)

        if project_name in self.requirements:
            return self.requirements[project_name]

        raise KeyError("No project with the name %r" % name)

    def cleanup_files(self):
        # type: () -> None
        """Clean up files, remove builds."""
        logger.debug('Cleaning up...')
        with indent_log():
            for req in self.reqs_to_cleanup:
                req.remove_temporary_source()
site-packages/pip/_internal/req/req_install.py000064400000107433151446176770015537 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import atexit
import logging
import os
import shutil
import sys
import sysconfig
import zipfile
from distutils.util import change_root

from pip._vendor import pkg_resources, six
from pip._vendor.packaging.requirements import Requirement
from pip._vendor.packaging.utils import canonicalize_name
from pip._vendor.packaging.version import Version
from pip._vendor.packaging.version import parse as parse_version
from pip._vendor.pep517.wrappers import Pep517HookCaller

from pip._internal import pep425tags, wheel
from pip._internal.build_env import NoOpBuildEnvironment
from pip._internal.exceptions import InstallationError
from pip._internal.models.link import Link
from pip._internal.operations.generate_metadata import get_metadata_generator
from pip._internal.pyproject import load_pyproject_toml, make_pyproject_path
from pip._internal.req.req_uninstall import UninstallPathSet
from pip._internal.utils.compat import native_str
from pip._internal.utils.hashes import Hashes
from pip._internal.utils.logging import indent_log
from pip._internal.utils.marker_files import (
    PIP_DELETE_MARKER_FILENAME,
    has_delete_marker_file,
)
from pip._internal.utils.misc import (
    _make_build_dir,
    ask_path_exists,
    backup_dir,
    display_path,
    dist_in_install_path,
    dist_in_site_packages,
    dist_in_usersite,
    ensure_dir,
    get_installed_version,
    hide_url,
    redact_auth_from_url,
    rmtree,
)
from pip._internal.utils.packaging import get_metadata
from pip._internal.utils.setuptools_build import make_setuptools_shim_args
from pip._internal.utils.subprocess import (
    call_subprocess,
    runner_with_spinner_message,
)
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.virtualenv import running_under_virtualenv
from pip._internal.vcs import vcs

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, Dict, Iterable, List, Optional, Sequence, Union,
    )
    from pip._internal.build_env import BuildEnvironment
    from pip._internal.cache import WheelCache
    from pip._internal.index import PackageFinder
    from pip._vendor.pkg_resources import Distribution
    from pip._vendor.packaging.specifiers import SpecifierSet
    from pip._vendor.packaging.markers import Marker


logger = logging.getLogger(__name__)


class InstallRequirement(object):
    """
    Represents something that may be installed later on, may have information
    about where to fetch the relevant requirement and also contains logic for
    installing the said requirement.
    """

    def __init__(
        self,
        req,  # type: Optional[Requirement]
        comes_from,  # type: Optional[Union[str, InstallRequirement]]
        source_dir=None,  # type: Optional[str]
        editable=False,  # type: bool
        link=None,  # type: Optional[Link]
        markers=None,  # type: Optional[Marker]
        use_pep517=None,  # type: Optional[bool]
        isolated=False,  # type: bool
        options=None,  # type: Optional[Dict[str, Any]]
        wheel_cache=None,  # type: Optional[WheelCache]
        constraint=False,  # type: bool
        extras=()  # type: Iterable[str]
    ):
        # type: (...) -> None
        assert req is None or isinstance(req, Requirement), req
        self.req = req
        self.comes_from = comes_from
        self.constraint = constraint
        if source_dir is None:
            self.source_dir = None  # type: Optional[str]
        else:
            self.source_dir = os.path.normpath(os.path.abspath(source_dir))
        self.editable = editable

        self._wheel_cache = wheel_cache
        if link is None and req and req.url:
            # PEP 508 URL requirement
            link = Link(req.url)
        self.link = self.original_link = link

        if extras:
            self.extras = extras
        elif req:
            self.extras = {
                pkg_resources.safe_extra(extra) for extra in req.extras
            }
        else:
            self.extras = set()
        if markers is None and req:
            markers = req.marker
        self.markers = markers

        # This holds the pkg_resources.Distribution object if this requirement
        # is already available:
        self.satisfied_by = None
        # This hold the pkg_resources.Distribution object if this requirement
        # conflicts with another installed distribution:
        self.conflicts_with = None
        # Temporary build location
        self._temp_build_dir = None  # type: Optional[TempDirectory]
        # Used to store the global directory where the _temp_build_dir should
        # have been created. Cf move_to_correct_build_directory method.
        self._ideal_build_dir = None  # type: Optional[str]
        # Set to True after successful installation
        self.install_succeeded = None  # type: Optional[bool]
        self.options = options if options else {}
        # Set to True after successful preparation of this requirement
        self.prepared = False
        self.is_direct = False

        self.isolated = isolated
        self.build_env = NoOpBuildEnvironment()  # type: BuildEnvironment

        # For PEP 517, the directory where we request the project metadata
        # gets stored. We need this to pass to build_wheel, so the backend
        # can ensure that the wheel matches the metadata (see the PEP for
        # details).
        self.metadata_directory = None  # type: Optional[str]

        # The static build requirements (from pyproject.toml)
        self.pyproject_requires = None  # type: Optional[List[str]]

        # Build requirements that we will check are available
        self.requirements_to_check = []  # type: List[str]

        # The PEP 517 backend we should use to build the project
        self.pep517_backend = None  # type: Optional[Pep517HookCaller]

        # Are we using PEP 517 for this requirement?
        # After pyproject.toml has been loaded, the only valid values are True
        # and False. Before loading, None is valid (meaning "use the default").
        # Setting an explicit value before loading pyproject.toml is supported,
        # but after loading this flag should be treated as read only.
        self.use_pep517 = use_pep517

    def __str__(self):
        # type: () -> str
        if self.req:
            s = str(self.req)
            if self.link:
                s += ' from %s' % redact_auth_from_url(self.link.url)
        elif self.link:
            s = redact_auth_from_url(self.link.url)
        else:
            s = '<InstallRequirement>'
        if self.satisfied_by is not None:
            s += ' in %s' % display_path(self.satisfied_by.location)
        if self.comes_from:
            if isinstance(self.comes_from, six.string_types):
                comes_from = self.comes_from  # type: Optional[str]
            else:
                comes_from = self.comes_from.from_path()
            if comes_from:
                s += ' (from %s)' % comes_from
        return s

    def __repr__(self):
        # type: () -> str
        return '<%s object: %s editable=%r>' % (
            self.__class__.__name__, str(self), self.editable)

    def format_debug(self):
        # type: () -> str
        """An un-tested helper for getting state, for debugging.
        """
        attributes = vars(self)
        names = sorted(attributes)

        state = (
            "{}={!r}".format(attr, attributes[attr]) for attr in sorted(names)
        )
        return '<{name} object: {{{state}}}>'.format(
            name=self.__class__.__name__,
            state=", ".join(state),
        )

    def populate_link(self, finder, upgrade, require_hashes):
        # type: (PackageFinder, bool, bool) -> None
        """Ensure that if a link can be found for this, that it is found.

        Note that self.link may still be None - if Upgrade is False and the
        requirement is already installed.

        If require_hashes is True, don't use the wheel cache, because cached
        wheels, always built locally, have different hashes than the files
        downloaded from the index server and thus throw false hash mismatches.
        Furthermore, cached wheels at present have undeterministic contents due
        to file modification times.
        """
        if self.link is None:
            self.link = finder.find_requirement(self, upgrade)
        if self._wheel_cache is not None and not require_hashes:
            old_link = self.link
            supported_tags = pep425tags.get_supported()
            self.link = self._wheel_cache.get(
                link=self.link,
                package_name=self.name,
                supported_tags=supported_tags,
            )
            if old_link != self.link:
                logger.debug('Using cached wheel link: %s', self.link)

    # Things that are valid for all kinds of requirements?
    @property
    def name(self):
        # type: () -> Optional[str]
        if self.req is None:
            return None
        return native_str(pkg_resources.safe_name(self.req.name))

    @property
    def specifier(self):
        # type: () -> SpecifierSet
        return self.req.specifier

    @property
    def is_pinned(self):
        # type: () -> bool
        """Return whether I am pinned to an exact version.

        For example, some-package==1.2 is pinned; some-package>1.2 is not.
        """
        specifiers = self.specifier
        return (len(specifiers) == 1 and
                next(iter(specifiers)).operator in {'==', '==='})

    @property
    def installed_version(self):
        # type: () -> Optional[str]
        return get_installed_version(self.name)

    def match_markers(self, extras_requested=None):
        # type: (Optional[Iterable[str]]) -> bool
        if not extras_requested:
            # Provide an extra to safely evaluate the markers
            # without matching any extra
            extras_requested = ('',)
        if self.markers is not None:
            return any(
                self.markers.evaluate({'extra': extra})
                for extra in extras_requested)
        else:
            return True

    @property
    def has_hash_options(self):
        # type: () -> bool
        """Return whether any known-good hashes are specified as options.

        These activate --require-hashes mode; hashes specified as part of a
        URL do not.

        """
        return bool(self.options.get('hashes', {}))

    def hashes(self, trust_internet=True):
        # type: (bool) -> Hashes
        """Return a hash-comparer that considers my option- and URL-based
        hashes to be known-good.

        Hashes in URLs--ones embedded in the requirements file, not ones
        downloaded from an index server--are almost peers with ones from
        flags. They satisfy --require-hashes (whether it was implicitly or
        explicitly activated) but do not activate it. md5 and sha224 are not
        allowed in flags, which should nudge people toward good algos. We
        always OR all hashes together, even ones from URLs.

        :param trust_internet: Whether to trust URL-based (#md5=...) hashes
            downloaded from the internet, as by populate_link()

        """
        good_hashes = self.options.get('hashes', {}).copy()
        link = self.link if trust_internet else self.original_link
        if link and link.hash:
            good_hashes.setdefault(link.hash_name, []).append(link.hash)
        return Hashes(good_hashes)

    def from_path(self):
        # type: () -> Optional[str]
        """Format a nice indicator to show where this "comes from"
        """
        if self.req is None:
            return None
        s = str(self.req)
        if self.comes_from:
            if isinstance(self.comes_from, six.string_types):
                comes_from = self.comes_from
            else:
                comes_from = self.comes_from.from_path()
            if comes_from:
                s += '->' + comes_from
        return s

    def ensure_build_location(self, build_dir):
        # type: (str) -> str
        assert build_dir is not None
        if self._temp_build_dir is not None:
            assert self._temp_build_dir.path
            return self._temp_build_dir.path
        if self.req is None:
            # for requirement via a path to a directory: the name of the
            # package is not available yet so we create a temp directory
            # Once run_egg_info will have run, we'll be able to fix it via
            # move_to_correct_build_directory().
            # Some systems have /tmp as a symlink which confuses custom
            # builds (such as numpy). Thus, we ensure that the real path
            # is returned.
            self._temp_build_dir = TempDirectory(kind="req-build")
            self._ideal_build_dir = build_dir

            return self._temp_build_dir.path
        if self.editable:
            name = self.name.lower()
        else:
            name = self.name
        # FIXME: Is there a better place to create the build_dir? (hg and bzr
        # need this)
        if not os.path.exists(build_dir):
            logger.debug('Creating directory %s', build_dir)
            _make_build_dir(build_dir)
        return os.path.join(build_dir, name)

    def move_to_correct_build_directory(self):
        # type: () -> None
        """Move self._temp_build_dir to "self._ideal_build_dir/self.req.name"

        For some requirements (e.g. a path to a directory), the name of the
        package is not available until we run egg_info, so the build_location
        will return a temporary directory and store the _ideal_build_dir.

        This is only called to "fix" the build directory after generating
        metadata.
        """
        if self.source_dir is not None:
            return
        assert self.req is not None
        assert self._temp_build_dir
        assert (
            self._ideal_build_dir is not None and
            self._ideal_build_dir.path  # type: ignore
        )
        old_location = self._temp_build_dir
        self._temp_build_dir = None  # checked inside ensure_build_location

        # Figure out the correct place to put the files.
        new_location = self.ensure_build_location(self._ideal_build_dir)
        if os.path.exists(new_location):
            raise InstallationError(
                'A package already exists in %s; please remove it to continue'
                % display_path(new_location)
            )

        # Move the files to the correct location.
        logger.debug(
            'Moving package %s from %s to new location %s',
            self, display_path(old_location.path), display_path(new_location),
        )
        shutil.move(old_location.path, new_location)

        # Update directory-tracking variables, to be in line with new_location
        self.source_dir = os.path.normpath(os.path.abspath(new_location))
        self._temp_build_dir = TempDirectory(
            path=new_location, kind="req-install",
        )

        # Correct the metadata directory, if it exists
        if self.metadata_directory:
            old_meta = self.metadata_directory
            rel = os.path.relpath(old_meta, start=old_location.path)
            new_meta = os.path.join(new_location, rel)
            new_meta = os.path.normpath(os.path.abspath(new_meta))
            self.metadata_directory = new_meta

        # Done with any "move built files" work, since have moved files to the
        # "ideal" build location. Setting to None allows to clearly flag that
        # no more moves are needed.
        self._ideal_build_dir = None

    def remove_temporary_source(self):
        # type: () -> None
        """Remove the source files from this requirement, if they are marked
        for deletion"""
        if self.source_dir and has_delete_marker_file(self.source_dir):
            logger.debug('Removing source in %s', self.source_dir)
            rmtree(self.source_dir)
        self.source_dir = None
        if self._temp_build_dir:
            self._temp_build_dir.cleanup()
            self._temp_build_dir = None
        self.build_env.cleanup()

    def check_if_exists(self, use_user_site):
        # type: (bool) -> bool
        """Find an installed distribution that satisfies or conflicts
        with this requirement, and set self.satisfied_by or
        self.conflicts_with appropriately.
        """
        if self.req is None:
            return False
        try:
            # get_distribution() will resolve the entire list of requirements
            # anyway, and we've already determined that we need the requirement
            # in question, so strip the marker so that we don't try to
            # evaluate it.
            no_marker = Requirement(str(self.req))
            no_marker.marker = None
            self.satisfied_by = pkg_resources.get_distribution(str(no_marker))
            if self.editable and self.satisfied_by:
                self.conflicts_with = self.satisfied_by
                # when installing editables, nothing pre-existing should ever
                # satisfy
                self.satisfied_by = None
                return True
        except pkg_resources.DistributionNotFound:
            return False
        except pkg_resources.VersionConflict:
            existing_dist = pkg_resources.get_distribution(
                self.req.name
            )
            if use_user_site:
                if dist_in_usersite(existing_dist):
                    self.conflicts_with = existing_dist
                elif (running_under_virtualenv() and
                        dist_in_site_packages(existing_dist)):
                    raise InstallationError(
                        "Will not install to the user site because it will "
                        "lack sys.path precedence to %s in %s" %
                        (existing_dist.project_name, existing_dist.location)
                    )
            elif dist_in_install_path(existing_dist):
                self.conflicts_with = existing_dist
        return True

    # Things valid for wheels
    @property
    def is_wheel(self):
        # type: () -> bool
        if not self.link:
            return False
        return self.link.is_wheel

    def move_wheel_files(
        self,
        wheeldir,  # type: str
        root=None,  # type: Optional[str]
        home=None,  # type: Optional[str]
        prefix=None,  # type: Optional[str]
        warn_script_location=True,  # type: bool
        use_user_site=False,  # type: bool
        pycompile=True  # type: bool
    ):
        # type: (...) -> None
        wheel.move_wheel_files(
            self.name, self.req, wheeldir,
            user=use_user_site,
            home=home,
            root=root,
            prefix=prefix,
            pycompile=pycompile,
            isolated=self.isolated,
            warn_script_location=warn_script_location,
        )

    # Things valid for sdists
    @property
    def unpacked_source_directory(self):
        # type: () -> str
        return os.path.join(
            self.source_dir,
            self.link and self.link.subdirectory_fragment or '')

    @property
    def setup_py_path(self):
        # type: () -> str
        assert self.source_dir, "No source dir for %s" % self
        setup_py = os.path.join(self.unpacked_source_directory, 'setup.py')

        # Python2 __file__ should not be unicode
        if six.PY2 and isinstance(setup_py, six.text_type):
            setup_py = setup_py.encode(sys.getfilesystemencoding())

        return setup_py

    @property
    def pyproject_toml_path(self):
        # type: () -> str
        assert self.source_dir, "No source dir for %s" % self
        return make_pyproject_path(self.unpacked_source_directory)

    def load_pyproject_toml(self):
        # type: () -> None
        """Load the pyproject.toml file.

        After calling this routine, all of the attributes related to PEP 517
        processing for this requirement have been set. In particular, the
        use_pep517 attribute can be used to determine whether we should
        follow the PEP 517 or legacy (setup.py) code path.
        """
        pyproject_toml_data = load_pyproject_toml(
            self.use_pep517,
            self.pyproject_toml_path,
            self.setup_py_path,
            str(self)
        )

        if pyproject_toml_data is None:
            self.use_pep517 = False
            return

        self.use_pep517 = True
        requires, backend, check = pyproject_toml_data
        self.requirements_to_check = check
        self.pyproject_requires = requires
        self.pep517_backend = Pep517HookCaller(
            self.unpacked_source_directory, backend
        )

    def prepare_metadata(self):
        # type: () -> None
        """Ensure that project metadata is available.

        Under PEP 517, call the backend hook to prepare the metadata.
        Under legacy processing, call setup.py egg-info.
        """
        assert self.source_dir

        metadata_generator = get_metadata_generator(self)
        with indent_log():
            self.metadata_directory = metadata_generator(self)

        if not self.req:
            if isinstance(parse_version(self.metadata["Version"]), Version):
                op = "=="
            else:
                op = "==="
            self.req = Requirement(
                "".join([
                    self.metadata["Name"],
                    op,
                    self.metadata["Version"],
                ])
            )
            self.move_to_correct_build_directory()
        else:
            metadata_name = canonicalize_name(self.metadata["Name"])
            if canonicalize_name(self.req.name) != metadata_name:
                logger.warning(
                    'Generating metadata for package %s '
                    'produced metadata for project name %s. Fix your '
                    '#egg=%s fragments.',
                    self.name, metadata_name, self.name
                )
                self.req = Requirement(metadata_name)

    def prepare_pep517_metadata(self):
        # type: () -> str
        assert self.pep517_backend is not None

        # NOTE: This needs to be refactored to stop using atexit
        metadata_tmpdir = TempDirectory(kind="modern-metadata")
        atexit.register(metadata_tmpdir.cleanup)

        metadata_dir = metadata_tmpdir.path

        with self.build_env:
            # Note that Pep517HookCaller implements a fallback for
            # prepare_metadata_for_build_wheel, so we don't have to
            # consider the possibility that this hook doesn't exist.
            runner = runner_with_spinner_message("Preparing wheel metadata")
            backend = self.pep517_backend
            with backend.subprocess_runner(runner):
                distinfo_dir = backend.prepare_metadata_for_build_wheel(
                    metadata_dir
                )

        return os.path.join(metadata_dir, distinfo_dir)

    @property
    def metadata(self):
        # type: () -> Any
        if not hasattr(self, '_metadata'):
            self._metadata = get_metadata(self.get_dist())

        return self._metadata

    def get_dist(self):
        # type: () -> Distribution
        """Return a pkg_resources.Distribution for this requirement"""
        dist_dir = self.metadata_directory.rstrip(os.sep)

        # Determine the correct Distribution object type.
        if dist_dir.endswith(".egg-info"):
            dist_cls = pkg_resources.Distribution
        else:
            assert dist_dir.endswith(".dist-info")
            dist_cls = pkg_resources.DistInfoDistribution

        # Build a PathMetadata object, from path to metadata. :wink:
        base_dir, dist_dir_name = os.path.split(dist_dir)
        dist_name = os.path.splitext(dist_dir_name)[0]
        metadata = pkg_resources.PathMetadata(base_dir, dist_dir)

        return dist_cls(
            base_dir,
            project_name=dist_name,
            metadata=metadata,
        )

    def assert_source_matches_version(self):
        # type: () -> None
        assert self.source_dir
        version = self.metadata['version']
        if self.req.specifier and version not in self.req.specifier:
            logger.warning(
                'Requested %s, but installing version %s',
                self,
                version,
            )
        else:
            logger.debug(
                'Source in %s has version %s, which satisfies requirement %s',
                display_path(self.source_dir),
                version,
                self,
            )

    # For both source distributions and editables
    def ensure_has_source_dir(self, parent_dir):
        # type: (str) -> None
        """Ensure that a source_dir is set.

        This will create a temporary build dir if the name of the requirement
        isn't known yet.

        :param parent_dir: The ideal pip parent_dir for the source_dir.
            Generally src_dir for editables and build_dir for sdists.
        :return: self.source_dir
        """
        if self.source_dir is None:
            self.source_dir = self.ensure_build_location(parent_dir)

    # For editable installations
    def install_editable(
        self,
        install_options,  # type: List[str]
        global_options=(),  # type: Sequence[str]
        prefix=None  # type: Optional[str]
    ):
        # type: (...) -> None
        logger.info('Running setup.py develop for %s', self.name)

        if prefix:
            prefix_param = ['--prefix={}'.format(prefix)]
            install_options = list(install_options) + prefix_param
        base_cmd = make_setuptools_shim_args(
            self.setup_py_path,
            global_options=global_options,
            no_user_config=self.isolated
        )
        with indent_log():
            with self.build_env:
                call_subprocess(
                    base_cmd +
                    ['develop', '--no-deps'] +
                    list(install_options),
                    cwd=self.unpacked_source_directory,
                )

        self.install_succeeded = True

    def update_editable(self, obtain=True):
        # type: (bool) -> None
        if not self.link:
            logger.debug(
                "Cannot update repository at %s; repository location is "
                "unknown",
                self.source_dir,
            )
            return
        assert self.editable
        assert self.source_dir
        if self.link.scheme == 'file':
            # Static paths don't get updated
            return
        assert '+' in self.link.url, "bad url: %r" % self.link.url
        vc_type, url = self.link.url.split('+', 1)
        vcs_backend = vcs.get_backend(vc_type)
        if vcs_backend:
            hidden_url = hide_url(self.link.url)
            if obtain:
                vcs_backend.obtain(self.source_dir, url=hidden_url)
            else:
                vcs_backend.export(self.source_dir, url=hidden_url)
        else:
            assert 0, (
                'Unexpected version control type (in %s): %s'
                % (self.link, vc_type))

    # Top-level Actions
    def uninstall(self, auto_confirm=False, verbose=False,
                  use_user_site=False):
        # type: (bool, bool, bool) -> Optional[UninstallPathSet]
        """
        Uninstall the distribution currently satisfying this requirement.

        Prompts before removing or modifying files unless
        ``auto_confirm`` is True.

        Refuses to delete or modify files outside of ``sys.prefix`` -
        thus uninstallation within a virtual environment can only
        modify that virtual environment, even if the virtualenv is
        linked to global site-packages.

        """
        if not self.check_if_exists(use_user_site):
            logger.warning("Skipping %s as it is not installed.", self.name)
            return None
        dist = self.satisfied_by or self.conflicts_with

        uninstalled_pathset = UninstallPathSet.from_dist(dist)
        uninstalled_pathset.remove(auto_confirm, verbose)
        return uninstalled_pathset

    def _clean_zip_name(self, name, prefix):  # only used by archive.
        # type: (str, str) -> str
        assert name.startswith(prefix + os.path.sep), (
            "name %r doesn't start with prefix %r" % (name, prefix)
        )
        name = name[len(prefix) + 1:]
        name = name.replace(os.path.sep, '/')
        return name

    def _get_archive_name(self, path, parentdir, rootdir):
        # type: (str, str, str) -> str
        path = os.path.join(parentdir, path)
        name = self._clean_zip_name(path, rootdir)
        return self.name + '/' + name

    def archive(self, build_dir):
        # type: (str) -> None
        """Saves archive to provided build_dir.

        Used for saving downloaded VCS requirements as part of `pip download`.
        """
        assert self.source_dir

        create_archive = True
        archive_name = '%s-%s.zip' % (self.name, self.metadata["version"])
        archive_path = os.path.join(build_dir, archive_name)

        if os.path.exists(archive_path):
            response = ask_path_exists(
                'The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)bort ' %
                display_path(archive_path), ('i', 'w', 'b', 'a'))
            if response == 'i':
                create_archive = False
            elif response == 'w':
                logger.warning('Deleting %s', display_path(archive_path))
                os.remove(archive_path)
            elif response == 'b':
                dest_file = backup_dir(archive_path)
                logger.warning(
                    'Backing up %s to %s',
                    display_path(archive_path),
                    display_path(dest_file),
                )
                shutil.move(archive_path, dest_file)
            elif response == 'a':
                sys.exit(-1)

        if not create_archive:
            return

        zip_output = zipfile.ZipFile(
            archive_path, 'w', zipfile.ZIP_DEFLATED, allowZip64=True,
        )
        with zip_output:
            dir = os.path.normcase(
                os.path.abspath(self.unpacked_source_directory)
            )
            for dirpath, dirnames, filenames in os.walk(dir):
                if 'pip-egg-info' in dirnames:
                    dirnames.remove('pip-egg-info')
                for dirname in dirnames:
                    dir_arcname = self._get_archive_name(
                        dirname, parentdir=dirpath, rootdir=dir,
                    )
                    zipdir = zipfile.ZipInfo(dir_arcname + '/')
                    zipdir.external_attr = 0x1ED << 16  # 0o755
                    zip_output.writestr(zipdir, '')
                for filename in filenames:
                    if filename == PIP_DELETE_MARKER_FILENAME:
                        continue
                    file_arcname = self._get_archive_name(
                        filename, parentdir=dirpath, rootdir=dir,
                    )
                    filename = os.path.join(dirpath, filename)
                    zip_output.write(filename, file_arcname)

        logger.info('Saved %s', display_path(archive_path))

    def install(
        self,
        install_options,  # type: List[str]
        global_options=None,  # type: Optional[Sequence[str]]
        root=None,  # type: Optional[str]
        home=None,  # type: Optional[str]
        prefix=None,  # type: Optional[str]
        warn_script_location=True,  # type: bool
        use_user_site=False,  # type: bool
        pycompile=True  # type: bool
    ):
        # type: (...) -> None
        global_options = global_options if global_options is not None else []
        if self.editable:
            self.install_editable(
                install_options, global_options, prefix=prefix,
            )
            return
        if self.is_wheel:
            version = wheel.wheel_version(self.source_dir)
            wheel.check_compatibility(version, self.name)

            self.move_wheel_files(
                self.source_dir, root=root, prefix=prefix, home=home,
                warn_script_location=warn_script_location,
                use_user_site=use_user_site, pycompile=pycompile,
            )
            self.install_succeeded = True
            return

        # Extend the list of global and install options passed on to
        # the setup.py call with the ones from the requirements file.
        # Options specified in requirements file override those
        # specified on the command line, since the last option given
        # to setup.py is the one that is used.
        global_options = list(global_options) + \
            self.options.get('global_options', [])
        install_options = list(install_options) + \
            self.options.get('install_options', [])

        with TempDirectory(kind="record") as temp_dir:
            record_filename = os.path.join(temp_dir.path, 'install-record.txt')
            install_args = self.get_install_args(
                global_options, record_filename, root, prefix, pycompile,
            )

            runner = runner_with_spinner_message(
                "Running setup.py install for {}".format(self.name)
            )
            with indent_log(), self.build_env:
                runner(
                    cmd=install_args + install_options,
                    cwd=self.unpacked_source_directory,
                )

            if not os.path.exists(record_filename):
                logger.debug('Record file %s not found', record_filename)
                return
            self.install_succeeded = True

            def prepend_root(path):
                # type: (str) -> str
                if root is None or not os.path.isabs(path):
                    return path
                else:
                    return change_root(root, path)

            with open(record_filename) as f:
                for line in f:
                    directory = os.path.dirname(line)
                    if directory.endswith('.egg-info'):
                        egg_info_dir = prepend_root(directory)
                        break
                else:
                    logger.warning(
                        'Could not find .egg-info directory in install record'
                        ' for %s',
                        self,
                    )
                    # FIXME: put the record somewhere
                    return
            new_lines = []
            with open(record_filename) as f:
                for line in f:
                    filename = line.strip()
                    if os.path.isdir(filename):
                        filename += os.path.sep
                    new_lines.append(
                        os.path.relpath(prepend_root(filename), egg_info_dir)
                    )
            new_lines.sort()
            ensure_dir(egg_info_dir)
            inst_files_path = os.path.join(egg_info_dir, 'installed-files.txt')
            with open(inst_files_path, 'w') as f:
                f.write('\n'.join(new_lines) + '\n')

    def get_install_args(
        self,
        global_options,  # type: Sequence[str]
        record_filename,  # type: str
        root,  # type: Optional[str]
        prefix,  # type: Optional[str]
        pycompile  # type: bool
    ):
        # type: (...) -> List[str]
        install_args = make_setuptools_shim_args(
            self.setup_py_path,
            global_options=global_options,
            no_user_config=self.isolated,
            unbuffered_output=True
        )
        install_args += ['install', '--record', record_filename]
        install_args += ['--single-version-externally-managed']

        if root is not None:
            install_args += ['--root', root]
        if prefix is not None:
            install_args += ['--prefix', prefix]

        if pycompile:
            install_args += ["--compile"]
        else:
            install_args += ["--no-compile"]

        if running_under_virtualenv():
            py_ver_str = 'python' + sysconfig.get_python_version()
            install_args += ['--install-headers',
                             os.path.join(sys.prefix, 'include', 'site',
                                          py_ver_str, self.name)]

        return install_args
site-packages/pip/_internal/req/__pycache__/__init__.cpython-38.opt-1.pyc000064400000003244151446176770022201 0ustar00U

��.e�	�@s�ddlmZddlZddlmZddlmZddlmZddl	m
Z
ddlmZerhdd	l
mZmZmZd
ddd
gZe�e�Zddd
�ZdS)�)�absolute_importN)�
indent_log)�MYPY_CHECK_RUNNING�)�parse_requirements)�InstallRequirement)�RequirementSet)�Any�List�Sequencerrr�install_given_reqs�c	Os�|r t�dd�dd�|D���t���|D]�}|jrbt�d|j�t��|jdd�}W5QRXz|j||f|�|�Wn0tk
r�|jo�|j}|r�|�	��YnX|jo�|j}|r�|�
�|��q,W5QRX|S)zu
    Install everything in the given list.

    (to be called after having downloaded and unpacked the packages)
    z!Installing collected packages: %sz, cSsg|]
}|j�qSr
)�name)�.0Zreqr
r
�>/usr/lib/python3.8/site-packages/pip/_internal/req/__init__.py�
<listcomp>+sz&install_given_reqs.<locals>.<listcomp>zFound existing installation: %sT)Zauto_confirm)�logger�info�joinrZconflicts_withZ	uninstallZinstall�	ExceptionZinstall_succeededZrollbackZcommitZremove_temporary_source)	Z
to_installZinstall_optionsZglobal_options�args�kwargsZrequirementZuninstalled_pathsetZshould_rollbackZ
should_commitr
r
rrsN��������)r
)Z
__future__rZloggingZpip._internal.utils.loggingrZpip._internal.utils.typingrZreq_filerZreq_installrZreq_setr�typingr	r
r�__all__Z	getLogger�__name__rrr
r
r
r�<module>s �
�site-packages/pip/_internal/req/__pycache__/req_set.cpython-38.pyc000064400000013635151446176770021152 0ustar00U

��.e��@s�ddlmZddlZddlmZddlmZddlmZddl	m
Z
ddlmZddl
mZdd	lmZer�dd
lmZmZmZmZmZddlmZe�e�ZGdd
�d
e�ZdS)�)�absolute_importN)�OrderedDict)�canonicalize_name)�
pep425tags)�InstallationError)�
indent_log)�MYPY_CHECK_RUNNING)�Wheel)�Dict�Iterable�List�Optional�Tuple)�InstallRequirementc@sXeZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zddd�Zdd�Z	dd�Z
dd�Zd
S)�RequirementSetFTcCs*t�|_||_||_g|_g|_g|_dS)z!Create a RequirementSet.
        N)r�requirements�require_hashes�check_supported_wheels�unnamed_requirementsZsuccessfully_downloaded�reqs_to_cleanup)�selfrr�r�=/usr/lib/python3.8/site-packages/pip/_internal/req/req_set.py�__init__szRequirementSet.__init__cCs4tdd�|j��D�dd�d�}d�dd�|D��S)Ncss|]}|js|VqdS�N)Z
comes_from��.0�reqrrr�	<genexpr>+sz)RequirementSet.__str__.<locals>.<genexpr>cSs
t|j�Sr�r�name�rrrr�<lambda>,�z(RequirementSet.__str__.<locals>.<lambda>��key� css|]}t|j�VqdSr��strrrrrrr.s)�sortedr�values�join)rrrrr�__str__(s
�zRequirementSet.__str__cCsBt|j��dd�d�}d}|j|jjt|�d�dd�|D��d�S)	NcSs
t|j�Srrr!rrrr"4r#z)RequirementSet.__repr__.<locals>.<lambda>r$z4<{classname} object; {count} requirement(s): {reqs}>z, css|]}t|j�VqdSrr'rrrrr;sz*RequirementSet.__repr__.<locals>.<genexpr>)Z	classname�countZreqs)r)rr*�format�	__class__�__name__�lenr+)rr�
format_stringrrr�__repr__0s��zRequirementSet.__repr__cCs|jr
t�|j�|�dSr)r �AssertionErrorr�append)r�install_reqrrr�add_unnamed_requirement>s
z&RequirementSet.add_unnamed_requirementcCs"|js
t�t|j�}||j|<dSr)r r4rr)rr6�project_namerrr�add_named_requirementCs

z$RequirementSet.add_named_requirementNc	Cs�|�|�s$t�d|j|j�gdfS|jrd|jjrdt|jj�}t	�
�}|jrd|�|�sdt
d|j��|j|dkksztd��|js�|�|�|gdfSz|�|j�}Wntk
r�d}YnX|dko�|o�|jo�|j|jko�|jj|jjk}|�rt
d|||jf��|�s"|�|�|g|fS|j�s2|j�s:g|fS|j�oZ|j�oX|jj|jjk}|�r||j�|�t
d|j��d|_ttt|j�t|j�B��|_t�d||j�|g|fS)	a&Add install_req as a requirement to install.

        :param parent_req_name: The name of the requirement that needed this
            added. The name is used because when multiple unnamed requirements
            resolve to the same name, we could otherwise end up with dependency
            links that point outside the Requirements set. parent_req must
            already be added. Note that None implies that this is a user
            supplied requirement, vs an inferred one.
        :param extras_requested: an iterable of extras used to evaluate the
            environment markers.
        :return: Additional requirements to scan. That is either [] if
            the requirement is not applicable, or [install_req] if the
            requirement is applicable and has just been added.
        z6Ignoring %s: markers '%s' don't match your environmentNz-%s is not a supported wheel on this platform.zTa direct req shouldn't have a parent and also, a non direct req should have a parentz5Double requirement given: %s (already in %s, name=%r)zhCould not satisfy constraints for '%s': installation from path or url cannot be constrained to a versionFzSetting %s extras to: %s)Z
match_markers�logger�infor Zmarkers�linkZis_wheelr	�filenamerZ
get_supportedrZ	supportedrZ	is_directr4r7�get_requirement�KeyError�
constraintZextrasrZ	specifierr9�pathrr5�tupler)�set�debug)	rr6Zparent_req_nameZextras_requestedZwheelZtagsZexisting_reqZhas_conflicting_requirementZdoes_not_satisfy_constraintrrr�add_requirementJs�
����


��
��
��

������zRequirementSet.add_requirementcCs t|�}||jko|j|jSr)rrr@�rr r8rrr�has_requirement�s
�zRequirementSet.has_requirementcCs,t|�}||jkr|j|Std|��dS)NzNo project with the name %r)rrr?rFrrrr>�s

zRequirementSet.get_requirementc	Cs4t�d�t��|jD]}|��qW5QRXdS)zClean up files, remove builds.zCleaning up...N)r:rDrrZremove_temporary_source)rrrrr�
cleanup_files�s

zRequirementSet.cleanup_files)FT)NN)r0�
__module__�__qualname__rr,r3r7r9rErGr>rHrrrrrs


�
p		r)Z
__future__rZlogging�collectionsrZpip._vendor.packaging.utilsrZ
pip._internalrZpip._internal.exceptionsrZpip._internal.utils.loggingrZpip._internal.utils.typingrZpip._internal.wheelr	�typingr
rrr
rZpip._internal.req.req_installrZ	getLoggerr0r:�objectrrrrr�<module>s
site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-38.pyc000064400000042030151446176770022357 0ustar00U

��.e&\�@s|ddlmZddlZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddlm
Z
mZddlmZmZmZddlmZddlmZmZmZmZmZmZmZmZmZdd	lm Z m!Z!dd
l"m#Z#e#�r
ddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/e�0e1�Z2d
d�Z3dd�Z4e4dd��Z5dd�Z6dd�Z7dd�Z8Gdd�de9�Z:Gdd�de9�Z;Gdd�de9�Z<dS)�)�absolute_importN)�
pkg_resources)�UninstallationError)�bin_py�bin_user)�WINDOWS�cache_from_source�uses_pycache)�
indent_log)	�FakeFile�ask�dist_in_usersite�
dist_is_local�
egg_link_path�is_local�normalize_path�renames�rmtree)�AdjacentTempDirectory�
TempDirectory)�MYPY_CHECK_RUNNING)	�Any�Callable�Dict�Iterable�Iterator�List�Optional�Set�Tuple)�DistributioncCslt|�rt}nt}tj�||�}|g}trh|�|d�|�|d�|rZ|�|d�n|�|d�|S)z�Create the fully qualified name of the files created by
    {console,gui}_scripts for the given ``dist``.
    Returns the list of file names
    z.exez
.exe.manifestz-script.pywz
-script.py)r
rr�os�path�joinr�append)�distZscript_nameZis_gui�bin_dirZexe_name�paths_to_remove�r(�C/usr/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py�
_script_names'sr*cst����fdd��}|S)Nc?s2t�}�||�D]}||kr|�|�|VqdS�N)�set�add)�args�kw�seen�item��fnr(r)�unique?s

z_unique.<locals>.unique)�	functools�wraps)r3r4r(r2r)�_unique=sr7ccs�t�t|�d���}|D]t}tj�|j|d�}|V|�d�rtj�	|�\}}|dd�}tj�||d�}|Vtj�||d�}|VqdS)a
    Yield all the uninstallation paths for dist based on RECORD-without-.py[co]

    Yield paths to all the files in RECORD. For each .py file in RECORD, add
    the .pyc and .pyo in the same directory.

    UninstallPathSet.add() takes care of the __pycache__ .py[co].
    ZRECORDr�.pyN����.pyc�.pyo)
�csv�readerrZget_metadata_linesr!r"r#�location�endswith�split)r%�r�rowr"Zdnr3�baser(r(r)�uninstallation_pathsJs
rDcsJtjj�t�}t|td�D]*�t��fdd�|D��}|s|���q|S)z�Compact a path set to contain the minimal number of paths
    necessary to contain all paths in the set. If /a/path/ and
    /a/path/to/a/file.txt are both in the set, leave only the
    shorter path.��keyc3s:|]2}��|�d��o0�t|�d������kVqdS)�*N)�
startswith�rstrip�len)�.0Z	shortpath�r"�sepr(r)�	<genexpr>ls�zcompact.<locals>.<genexpr>)r!r"rMr,�sortedrJ�anyr-)�pathsZshort_pathsZshould_skipr(rLr)�compactbs�rRc	s�tdd�|D��}t|�}ttdd�|��D��td�}t�}dd��|D]��t�fdd�|D��rfqJt�}t�}t���D]B\�}}|����fdd�|D��|����fd	d�|D��q|||sJ|�	|�|�
�tj�qJtt|j
|��|BS)
z�Returns a set containing the paths that need to be renamed.

    This set may include directories when the original sequence of paths
    included every file on disk.
    css|]}tj�|�|fVqdSr+)r!r"�normcase�rK�pr(r(r)rN}sz&compress_for_rename.<locals>.<genexpr>css|]}tj�|�dVqdS)rN)r!r"r@rTr(r(r)rNs�rEcWstj�tjj|��Sr+)r!r"rSr#)�ar(r(r)�	norm_join�sz&compress_for_rename.<locals>.norm_joinc3s |]}tj����|�VqdSr+)r!r"rSrH)rK�w)�rootr(r)rN�s�c3s|]}���|�VqdSr+r()rK�d��dirnamerWrYr(r)rN�s�c3s|]}���|�VqdSr+r()rK�fr[r(r)rN�s�)�dictr,rO�valuesrJrPr!�walk�update�difference_updater-rM�map�__getitem__)	rQZcase_mapZ	remainingZ	uncheckedZ	wildcardsZ	all_filesZall_subdirsZsubdirs�filesr(r[r)�compress_for_renamevs6
�����

rfc
Cs�t|�}t�}t�}t�}|D]>}|�d�r.q|�d�s@d|krR|�tj�|��|�|�qtttjj|��}t|�}|D]d}t�	|�D]T\}}	}
|
D]D}|�d�r�q�tj�
||�}tj�|�r�tj�|�|kr�|�|�q�q�q||dd�|D�B}||fS)asReturns a tuple of 2 sets of which paths to display to user

    The first set contains paths that would be deleted. Files of a package
    are not added and the top-level directory of the package has a '*' added
    at the end - to signify that all it's contents are removed.

    The second set contains files that would have been skipped in the above
    folders.
    r:z__init__.py�
.dist-infocSsh|]}tj�|d��qS)rG)r!r"r#)rK�folderr(r(r)�	<setcomp>�sz.compress_for_output_listing.<locals>.<setcomp>)r,r?r-r!r"r\rcrSrRr`r#�isfile)
rQ�will_remove�	will_skipZfoldersrer"Z_normcased_filesrh�dirpath�_ZdirfilesZfnameZfile_r(r(r)�compress_for_output_listing�s4

��roc@sLeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	e
dd��ZdS)�StashedUninstallPathSetzWA set of file rename operations to stash files while
    tentatively uninstalling them.cCsi|_g|_dSr+)�
_save_dirs�_moves��selfr(r(r)�__init__�sz StashedUninstallPathSet.__init__cCsDzt|�}Wntk
r*tdd�}YnX||jtj�|�<|jS)z�Stashes a directory.

        Directories are stashed adjacent to their original location if
        possible, or else moved/copied into the user's temp dir.�	uninstall�Zkind)r�OSErrorrrqr!r"rS)rtr"�save_dirr(r(r)�_get_directory_stash�sz,StashedUninstallPathSet._get_directory_stashcCs�tj�|�}tj�|�d}}d}||krfz|j|}Wq�Wntk
rPYnXtj�|�|}}q"tj�|�}tdd�}||j|<tj�||�}|r�|tjjkr�tj�	|j|�S|jS)z�Stashes a file.

        If no root has been provided, one will be created for the directory
        in the user's temp directory.Nrvrw)
r!r"rSr\rq�KeyErrorr�relpath�curdirr#)rtr"�headZold_headryr|r(r(r)�_get_file_stash�s"


z'StashedUninstallPathSet._get_file_stashcCsltj�|�otj�|�}|r*|�|�}n
|�|�}|j�||f�|r^tj�|�r^t�|�t	||�|S)z�Stashes the directory or file and returns its new location.
        Handle symlinks as files to avoid modifying the symlink targets.
        )
r!r"�isdir�islinkrzrrrr$�rmdirr)rtr"Zpath_is_dir�new_pathr(r(r)�stashs


zStashedUninstallPathSet.stashcCs,|j��D]\}}|��q
g|_i|_dS)z0Commits the uninstall by removing stashed files.N)rq�itemsZcleanuprr)rtrnryr(r(r)�commits
zStashedUninstallPathSet.commitcCs�|jD]}tjd|��q|jD]�\}}zTt�d||�tj�|�sPtj�|�r\t�	|�ntj�
|�rpt|�t||�Wq t
k
r�}zt�d|�t�d|�W5d}~XYq Xq |��dS)z2Undoes the uninstall by moving stashed files back.�Moving to %s
 from %szReplacing %s from %szFailed to restore %sz
Exception: %sN)r�)rr�logging�info�logger�debugr!r"rjr��unlinkr�rrrx�errorr�)rtrUr�r"Zexr(r(r)�rollback&s
 z StashedUninstallPathSet.rollbackcCs
t|j�Sr+)�boolrrrsr(r(r)�can_rollback:sz$StashedUninstallPathSet.can_rollbackN)�__name__�
__module__�__qualname__�__doc__rurzrr�r�r��propertyr�r(r(r(r)rp�s	rpc@s^eZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	dd�Z
dd�Zedd��Z
dS)�UninstallPathSetzMA set of file paths to be removed in the uninstallation of a
    requirement.cCs(t�|_t�|_i|_||_t�|_dSr+)r,rQ�_refuse�pthr%rp�_moved_paths)rtr%r(r(r)ruCs
zUninstallPathSet.__init__cCst|�S)zs
        Return True if the given path is one we are permitted to
        remove/modify, False otherwise.

        )r)rtr"r(r(r)�
_permittedKszUninstallPathSet._permittedcCs�tj�|�\}}tj�t|�tj�|��}tj�|�s:dS|�|�rR|j�	|�n|j
�	|�tj�|�ddkr�tr�|�	t
|��dS)N�r8)r!r"r@r#rrS�existsr�rQr-r��splitextr	r)rtr"r~�tailr(r(r)r-Ts
zUninstallPathSet.addcCsLt|�}|�|�r<||jkr*t|�|j|<|j|�|�n|j�|�dSr+)rr�r��UninstallPthEntriesr-r�)rt�pth_file�entryr(r(r)�add_pthhs

zUninstallPathSet.add_pthFc	Cs�|jst�d|jj�dS|jjd|jj}t�d|�t��p|sP|�|�r�|j}t	|j�}t
t|��D]}|�|�t�
d|�ql|j��D]}|��q�t�d|�W5QRXdS)z[Remove paths in ``self.paths`` with confirmation (unless
        ``auto_confirm`` is True).z7Can't uninstall '%s'. No files were found to uninstall.N�-zUninstalling %s:zRemoving file or directory %szSuccessfully uninstalled %s)rQr�r�r%�project_name�versionr
�_allowed_to_proceedr�rfrOrRr�r�r�r_�remove)rtZauto_confirm�verboseZdist_name_versionZmovedZ
for_renamer"r�r(r(r)r�rs&��


zUninstallPathSet.removecCsndd�}|st|j�\}}nt|j�}t�}|d|�|d|�|d|j�|r`|dt|j��tdd�d	kS)
zIDisplay which files would be deleted and prompt for confirmation
        c	SsD|sdSt�|�t��"tt|��D]}t�|�q&W5QRXdSr+)r�r�r
rOrR)�msgrQr"r(r(r)�_display�s
z6UninstallPathSet._allowed_to_proceed.<locals>._displayz
Would remove:z+Would not remove (might be manually added):z%Would not remove (outside of prefix):zWill actually move:zProceed (y/n)? )�y�nr�)rorQr,r�rfr)rtr�r�rkrlr(r(r)r��s



z$UninstallPathSet._allowed_to_proceedcCsR|jjst�d|jj�dSt�d|jj�|j��|j�	�D]}|��q@dS)z1Rollback the changes previously made by remove().z'Can't roll back %s; was not uninstalledNzRolling back uninstall of %s)
r�r�r�r�r%r�r�r�r�r_)rtr�r(r(r)r��s�
zUninstallPathSet.rollbackcCs|j��dS)z?Remove temporary save dir: rollback will no longer be possible.N)r�r�rsr(r(r)r��szUninstallPathSet.commitc	s�t|j�}t|�s.t�d|j|tj�||�S|dd�t�	d�t�	d�hD�krht�d|j|�||�S||�}t
|�}d�t�
|j��}|jo�tj�|j�}t|jdd�}|�r�|j�d	��r�|j�|��s�|�|j�|�d
��r|�d
���D]&}tj�tj�|j|��}	|�|	�q�n�|�d��r�|�d��rB|�d��ng��fd
d�|�d���D�D]J}
tj�|j|
�}	|�|	�|�|	d�|�|	d�|�|	d��qb�n2|�r�td�|j����n|j�d��r"|�|j�tj�|j�d}tj�tj�|j�d�}|�|d|�n�|�rR|j�d��rRt |�D]}	|�|	��q>n�|�r�t!|d��}
tj�"|
�#��$��}W5QRX||jk�s�t%d||j|jf��|�|�tj�tj�|�d�}|�||j�nt�&d||j�|�d��rT|�'d��rT|�(d�D]L}t)|��rt*}nt+}|�tj�||��t,�r|�tj�||�d��qg}|j-dd�}|�.�D]}|�/t0||d���ql|j-d d�}|�.�D]}|�/t0||d!���q�|D]}|�|��q�|S)"Nz1Not uninstalling %s at %s, outside environment %scSsh|]}|r|�qSr(r(rTr(r(r)ri�s�z-UninstallPathSet.from_dist.<locals>.<setcomp>ZstdlibZ
platstdlibz<Not uninstalling %s at %s, as it is in the standard library.z{}.egg-infor"z	.egg-infozinstalled-files.txtz
top_level.txtznamespace_packages.txtcsg|]}|r|�kr|�qSr(r(rT�Z
namespacesr(r)�
<listcomp>�s�z.UninstallPathSet.from_dist.<locals>.<listcomp>r8r:r;z�Cannot uninstall {!r}. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.z.eggr�zeasy-install.pthz./rgrAz;Egg-link %s does not match installed location of %s (at %s)z)Not sure how to uninstall: %s - Check: %sZscriptsz.bat�console_scripts)�groupF�gui_scriptsT)1rr>rr�r�rF�sys�prefix�	sysconfigZget_pathr�formatrZto_filenamer�Zegg_infor!r"r��getattrZ	_providerr?r-Zhas_metadataZget_metadata�
splitlines�normpathr#rr@r\r�rD�openrS�readline�strip�AssertionErrorr�Zmetadata_isdirZmetadata_listdirr
rrrZ
get_entry_map�keys�extendr*)�clsr%Z	dist_pathr'Zdevelop_egg_linkZdevelop_egg_link_egg_infoZegg_info_existsZdistutils_egg_infoZinstalled_filer"Z
top_level_pkgZeasy_install_eggZeasy_install_pth�fhZlink_pointerZscriptr&Z_scripts_to_remover��namer��sr(r�r)�	from_dist�s�
��
�
�
���
�

�����
��
zUninstallPathSet.from_distN)FF)r�r�r�r�rur�r-r�r�r�r�r��classmethodr�r(r(r(r)r�@s	

 r�c@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
r�cCs0tj�|�std|��||_t�|_d|_dS)Nz.Cannot remove entries from nonexistent file %s)r!r"rjr�filer,�entries�_saved_lines)rtr�r(r(r)ruIs�zUninstallPthEntries.__init__cCs<tj�|�}tr,tj�|�ds,|�dd�}|j�|�dS)Nr�\�/)r!r"rSr�
splitdrive�replacer�r-)rtr�r(r(r)r-Ss
zUninstallPthEntries.addc	Cs�t�d|j�t|jd��}|��}||_W5QRXtdd�|D��rLd}nd}|r~|d�|�d��s~|d|�d�|d<|j	D]>}z$t�d	|�|�
||�d��Wq�tk
r�Yq�Xq�t|jd
��}|�|�W5QRXdS)NzRemoving pth entries from %s:�rbcss|]}d|kVqdS)s
Nr()rK�liner(r(r)rNjsz-UninstallPthEntries.remove.<locals>.<genexpr>z
�
���zutf-8zRemoving entry: %s�wb)
r�r�r�r��	readlinesr�rPr?�encoder�r��
ValueError�
writelines)rtr��linesZendliner�r(r(r)r�cs"
zUninstallPthEntries.removec	CsR|jdkrt�d|j�dSt�d|j�t|jd��}|�|j�W5QRXdS)Nz.Cannot roll back changes to %s, none were madeFz!Rolling %s back to previous stater�T)r�r�r�r�r�r�r�)rtr�r(r(r)r�zs
�zUninstallPthEntries.rollbackN)r�r�r�rur-r�r�r(r(r(r)r�Hs
r�)=Z
__future__rr<r5r�r!r�r�Zpip._vendorrZpip._internal.exceptionsrZpip._internal.locationsrrZpip._internal.utils.compatrrr	Zpip._internal.utils.loggingr
Zpip._internal.utils.miscrrr
rrrrrrZpip._internal.utils.temp_dirrrZpip._internal.utils.typingr�typingrrrrrrrrrZpip._vendor.pkg_resourcesr Z	getLoggerr�r�r*r7rDrRrfro�objectrpr�r�r(r(r(r)�<module>s<,,


(3o
site-packages/pip/_internal/req/__pycache__/constructors.cpython-38.opt-1.pyc000064400000024164151446176770023216 0ustar00U

��.e48�@s�dZddlZddlZddlZddlmZddlmZmZddl	m
Z
ddlmZm
Z
ddlmZddlmZmZdd	lmZdd
lmZddlmZddlmZdd
lmZmZddlmZddl m!Z!ddl"m#Z#m$Z$ddl%m&Z&e�rddl'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/dddgZ0e�1e2�Z3e
j4�5�Z6dd�Z7dd�Z8dd�Z9dd�Z:dd�Z;Gd d!�d!e<�Z=d"d#�Z>d/d%d�Z?d&d'�Z@d(d)�ZAd*d+�ZBd0d,d�ZCd1d-d.�ZDdS)2a~Backing implementation for InstallRequirement's various constructors

The idea here is that these formed a major chunk of InstallRequirement's size
so, moving them and support code dedicated to them outside of that class
helps creates for better understandability for the rest of the code.

These are meant to be used elsewhere within pip to create instances of
InstallRequirement.
�N)�Marker)�InvalidRequirement�Requirement)�	Specifier)�RequirementParseError�parse_requirements)�InstallationError)�PyPI�TestPyPI)�Link)�make_pyproject_path)�InstallRequirement)�ARCHIVE_EXTENSIONS)�is_installable_dir�splitext)�MYPY_CHECK_RUNNING)�path_to_url)�is_url�vcs)�Wheel)�Any�Dict�Optional�Set�Tuple�Union)�
WheelCache�install_req_from_editable�install_req_from_line�parse_editablecCs t|�d��}|tkrdSdS)z9Return True if `name` is a considered as an archive file.�TF)r�lowerr)�nameZext�r#�B/usr/lib/python3.8/site-packages/pip/_internal/req/constructors.py�is_archive_file4sr%cCs6t�d|�}d}|r*|�d�}|�d�}n|}||fS)Nz^(.+)(\[[^\]]+\])$r �)�re�match�group)�path�m�extrasZpath_no_extrasr#r#r$�
_strip_extras=s
r-cCs|s
t�Std|���jS)N�placeholder)�setrr!r,)r,r#r#r$�convert_extrasJsr0c
Cs`|}t|�\}}tj�|�rptj�tj�|d��shd�tj�|��}t|�}tj�	|�r`|d7}t
|��t|�}|���
d�r�t|�j}|r�||td|���jfS||dfStD]&}|���
d|�r�d||f}q�q�d	|kr�t
d
�|���|�d	d�d��}t�|��s:d
|d�dd�tjD��d}	t
|	��t|�j}|�sVt
d|��||dfS)aParses an editable requirement into:
        - a requirement name
        - an URL
        - extras
        - editable options
    Accepted requirements:
        svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir
        .[some_extra]
    zsetup.pyzMFile "setup.py" not found. Directory cannot be installed in editable mode: {}zb
(A "pyproject.toml" file was found, but editable mode currently requires a setup.py based build.)zfile:r.Nz%s:z%s+%s�+z�{} is not a valid editable requirement. It should either be a path to a local project or a VCS URL (beginning with svn+, git+, hg+, or bzr+).r rzFor --editable=%s only z, cSsg|]}|jd�qS)z+URL�r")�.0Zbackendr#r#r$�
<listcomp>�sz"parse_editable.<locals>.<listcomp>z is currently supportedzZCould not detect requirement name for '%s', please specify one with #egg=your_package_name)r-�osr*�isdir�exists�join�format�abspathr�isfilerrr!�
startswithr�egg_fragmentrr,r�splitZget_backendZbackends)
�editable_req�urlZ
url_no_extrasr,�msgZpyproject_pathZpackage_nameZversion_controlZvc_typeZ
error_messager#r#r$rQsb
���
�
����
��c	Cs�d}tj�|�r�d}zFt|d��2}tt|����|dd|ddd7}W5QRXWq�tk
r�tj	d	|d
d�Yq�Xn|d|7}|S)
z�Returns helpful msg in case requirements file does not exist,
    or cannot be parsed.

    :params req: Requirements file path
    �z It does exist.�rz The argument you provided z(%s) appears to be az" requirements file. If that is thez# case, use the '-r' flag to installz" the packages specified within it.z2Cannot parse '%s' as requirements             fileT)�exc_infoz File '%s' does not exist.)
r5r*r7�open�nextr�readr�logger�debug)�reqrA�fpr#r#r$�deduce_helpful_msg�s.������rLc@seZdZdd�ZdS)�RequirementPartscCs||_||_||_||_dS�N)�requirement�link�markersr,)�selfrOrPrQr,r#r#r$�__init__�szRequirementParts.__init__N)�__name__�
__module__�__qualname__rSr#r#r#r$rM�srMcCs`t|�\}}}|dk	rFzt|�}WqJtk
rBtd|��YqJXnd}t|�}t||d|�S)N�Invalid requirement: '%s')rrrrrrM)r?r"r@Zextras_overriderJrPr#r#r$�parse_req_from_editable�srXFc	
CsLt|�}|jjdkr|jjnd}t|j||d|j||||r>|ni||jd�S)N�fileT)	�
source_dirZeditablerP�
constraint�
use_pep517�isolated�options�wheel_cacher,)rXrP�schemeZ	file_pathr
rOr,)	r?�
comes_fromr\r]r^r_r[�partsrZr#r#r$r�s
�cCs>tjj|krdStjjdk	r,tjj|kr,dS|�d�r:dSdS)akChecks whether the string "looks like" a path on the filesystem.

    This does not check whether the target actually exists, only judge from the
    appearance.

    Returns true if any of the following conditions is true:
    * a path separator is found (either os.path.sep or os.path.altsep);
    * a dot is found (which represents the current directory).
    TN�.F)r5r*�sep�altsepr<r2r#r#r$�_looks_like_path�s
rfcCs�t|�r0tj�|�r0t|�r$t|�Std|��t|�s<dStj�|�rPt|�S|�	dd�}t
|�dkrxt|d�sxdSt�d|�t|�S)ad
    First, it checks whether a provided path is an installable directory
    (e.g. it has a setup.py). If it is, returns the path.

    If false, check if the path is an archive file (such as a .whl).
    The function checks if the path is a file. If false, if the path has
    an @, it will treat it as a PEP 440 URL requirement and return the path.
    zODirectory %r is not installable. Neither 'setup.py' nor 'pyproject.toml' found.N�@r r&rzARequirement %r looks like a filename, but the file does not exist)
rfr5r*r6rrrr%r;r>�lenrHZwarning)r*r"Zurlreq_partsr#r#r$�_get_url_from_path	s(
���rics�t|�rd}nd}||krF|�|d�\}}|��}|s<d}qJt|�}nd}|��}d�tj�tj�|��}d}d}t|�r�t|�}n&t	|�\}}t
||�}	|	dk	r�t|	�}|�r|jdkr�t�
d|j�r�tttj�tj�|j����}|j�r
t|j�}
d|
j|
jf�n|j�n|�t|�}�fdd�}�dk	�r�zt��}
Wn�tk
�r�tjj�k�rrd	}|t��7}n,d
�k�r�t�fdd�tD���s�d
}nd}|d����}|�r�|d�|�7}t|��YnXnd}
t|
|||�S)Nz; �;r rYz\.\./z%s==%scs�s|Sd�|��S)Nz{} (from {}))r9)�text)�line_sourcer#r$�with_source]sz(parse_req_from_line.<locals>.with_sourcezIt looks like a path.�=c3s|]}|�kVqdSrNr#)r3�op)�
req_as_stringr#r$�	<genexpr>jsz&parse_req_from_line.<locals>.<genexpr>z,= is not a valid operator. Did you mean == ?rBzInvalid requirement: {!r}z	
Hint: {}) rr>�striprr5r*�normpathr:rr-rir`r'�searchr@rZis_wheelr�filenamer"�versionr=r0rrrdrL�any�	operatorsr9rrM)r"rlZ
marker_sepZmarkers_as_stringrQr*rPZextras_as_string�pr@Zwheelr,rmrJZadd_msgrAr#)rlrpr$�parse_req_from_line+sj


�


��rzc	Cs6t||�}t|j||j|j|||r&|ni|||jd�
S)aCreates an InstallRequirement from a name, which might be a
    requirement, directory containing 'setup.py', filename, or URL.

    :param line_source: An optional string describing where the line is from,
        for logging purposes in case of an error.
    )rPrQr\r]r^r_r[r,)rzr
rOrPrQr,)	r"rar\r]r^r_r[rlrbr#r#r$rzs

�cCszzt|�}Wn tk
r,td|��YnXtjtjg}|jrh|rh|jrh|jj|krhtd|j	|f��t
|||||d�S)NrWzkPackages installed from PyPI cannot depend on packages which are not also hosted on PyPI.
%s depends on %s )r]r_r\)rrrr	Zfile_storage_domainr
r@rPZnetlocr"r
)Z
req_stringrar]r_r\rJZdomains_not_allowedr#r#r$�install_req_from_req_string�s,�
����r{)NNFNNF)NNFNNFN)NFNN)E�__doc__Zloggingr5r'Zpip._vendor.packaging.markersrZ"pip._vendor.packaging.requirementsrrZ pip._vendor.packaging.specifiersrZpip._vendor.pkg_resourcesrrZpip._internal.exceptionsrZpip._internal.models.indexr	r
Zpip._internal.models.linkrZpip._internal.pyprojectrZpip._internal.req.req_installr
Zpip._internal.utils.filetypesrZpip._internal.utils.miscrrZpip._internal.utils.typingrZpip._internal.utils.urlsrZpip._internal.vcsrrZpip._internal.wheelr�typingrrrrrrZpip._internal.cacher�__all__Z	getLoggerrTrHZ
_operators�keysrxr%r-r0rrL�objectrMrXrrfrirzrr{r#r#r#r$�<module>sr �

	
J�
"Q�
�site-packages/pip/_internal/req/__pycache__/req_tracker.cpython-38.opt-1.pyc000064400000006145151446176770022747 0ustar00U

��.e{�@s�ddlmZddlZddlZddlZddlZddlZddlmZddl	m
Z
e
r�ddlmZddl
mZmZmZmZddlmZddlmZe�e�ZGd	d
�d
e�ZdS)�)�absolute_importN)�
TempDirectory)�MYPY_CHECK_RUNNING)�
TracebackType)�Iterator�Optional�Set�Type)�InstallRequirement)�Linkc@sReZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	e
jdd��ZdS)�RequirementTrackercCsjtj�d�|_|jdkrJtddd�|_|jj|_tjd<t�d|j�nd|_t�d|j�t	�|_
dS)NZPIP_REQ_TRACKERFzreq-tracker)�deleteZkindzCreated requirements tracker %rz Re-using requirements tracker %r)�os�environ�get�_rootr�	_temp_dir�path�logger�debug�set�_entries��self�r�A/usr/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py�__init__s
zRequirementTracker.__init__cCs|S�Nrrrrr�	__enter__&szRequirementTracker.__enter__cCs|��dSr)�cleanup)r�exc_typeZexc_valZexc_tbrrr�__exit__*szRequirementTracker.__exit__cCs$t�|j�����}tj�|j|�Sr)	�hashlibZsha224Zurl_without_fragment�encodeZ	hexdigestrr�joinr)r�linkZhashedrrr�_entry_path3szRequirementTracker._entry_pathcCs�|j}t|�}|�|�}z,t|��}td||��f��W5QRXWnltk
r�}zN|jtjkrd�t|d��}|�	|�W5QRX|j
�|�t�
d||j�W5d}~XYnXdS)Nz%s is already being built: %s�wzAdded %s to build tracker %r)r%�strr&�open�LookupError�read�IOError�errnoZENOENT�writer�addrrr)r�reqr%�infoZ
entry_path�fp�errrr/8s


�zRequirementTracker.addcCs6|j}|j�|�t�|�|��t�d||j�dS)Nz Removed %s from build tracker %r)	r%r�remover�unlinkr&rrr)rr0r%rrrr4KszRequirementTracker.removecCsNt|j�D]}|�|�q
|jdk	}|r2|j��t�d|r@dnd|j�dS)Nz%s build tracker %rZRemovedZCleaned)rrr4rrrrr)rr0r4rrrrRs


�zRequirementTracker.cleanupccs|�|�dV|�|�dSr)r/r4)rr0rrr�track]s
zRequirementTracker.trackN)
�__name__�
__module__�__qualname__rrr!r&r/r4r�
contextlib�contextmanagerr6rrrrrs	r)Z
__future__rr:r-r"ZloggingrZpip._internal.utils.temp_dirrZpip._internal.utils.typingr�typesr�typingrrrr	Zpip._internal.req.req_installr
Zpip._internal.models.linkrZ	getLoggerr7r�objectrrrrr�<module>s
site-packages/pip/_internal/req/__pycache__/req_tracker.cpython-38.pyc000064400000006205151446176770022005 0ustar00U

��.e{�@s�ddlmZddlZddlZddlZddlZddlZddlmZddl	m
Z
e
r�ddlmZddl
mZmZmZmZddlmZddlmZe�e�ZGd	d
�d
e�ZdS)�)�absolute_importN)�
TempDirectory)�MYPY_CHECK_RUNNING)�
TracebackType)�Iterator�Optional�Set�Type)�InstallRequirement)�Linkc@sReZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	e
jdd��ZdS)�RequirementTrackercCsjtj�d�|_|jdkrJtddd�|_|jj|_tjd<t�d|j�nd|_t�d|j�t	�|_
dS)NZPIP_REQ_TRACKERFzreq-tracker)�deleteZkindzCreated requirements tracker %rz Re-using requirements tracker %r)�os�environ�get�_rootr�	_temp_dir�path�logger�debug�set�_entries��self�r�A/usr/lib/python3.8/site-packages/pip/_internal/req/req_tracker.py�__init__s
zRequirementTracker.__init__cCs|S�Nrrrrr�	__enter__&szRequirementTracker.__enter__cCs|��dSr)�cleanup)r�exc_typeZexc_valZexc_tbrrr�__exit__*szRequirementTracker.__exit__cCs$t�|j�����}tj�|j|�Sr)	�hashlibZsha224Zurl_without_fragment�encodeZ	hexdigestrr�joinr)r�linkZhashedrrr�_entry_path3szRequirementTracker._entry_pathcCs�|j}t|�}|�|�}z,t|��}td||��f��W5QRXWnztk
r�}z\|jtjkrd�||j	ksrt
�t|d��}|�|�W5QRX|j	�|�t
�d||j�W5d}~XYnXdS)Nz%s is already being built: %s�wzAdded %s to build tracker %r)r%�strr&�open�LookupError�read�IOError�errnoZENOENTr�AssertionError�write�addrrr)r�reqr%�infoZ
entry_path�fp�errrr08s 


�zRequirementTracker.addcCs6|j}|j�|�t�|�|��t�d||j�dS)Nz Removed %s from build tracker %r)	r%r�remover�unlinkr&rrr)rr1r%rrrr5KszRequirementTracker.removecCsNt|j�D]}|�|�q
|jdk	}|r2|j��t�d|r@dnd|j�dS)Nz%s build tracker %rZRemovedZCleaned)rrr5rrrrr)rr1r5rrrrRs


�zRequirementTracker.cleanupccs|�|�dV|�|�dSr)r0r5)rr1rrr�track]s
zRequirementTracker.trackN)
�__name__�
__module__�__qualname__rrr!r&r0r5r�
contextlib�contextmanagerr7rrrrrs	r)Z
__future__rr;r-r"ZloggingrZpip._internal.utils.temp_dirrZpip._internal.utils.typingr�typesr�typingrrrr	Zpip._internal.req.req_installr
Zpip._internal.models.linkrZ	getLoggerr8r�objectrrrrr�<module>s
site-packages/pip/_internal/req/__pycache__/req_set.cpython-38.opt-1.pyc000064400000013347151446176770022111 0ustar00U

��.e��@s�ddlmZddlZddlmZddlmZddlmZddl	m
Z
ddlmZddl
mZdd	lmZer�dd
lmZmZmZmZmZddlmZe�e�ZGdd
�d
e�ZdS)�)�absolute_importN)�OrderedDict)�canonicalize_name)�
pep425tags)�InstallationError)�
indent_log)�MYPY_CHECK_RUNNING)�Wheel)�Dict�Iterable�List�Optional�Tuple)�InstallRequirementc@sXeZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zddd�Zdd�Z	dd�Z
dd�Zd
S)�RequirementSetFTcCs*t�|_||_||_g|_g|_g|_dS)z!Create a RequirementSet.
        N)r�requirements�require_hashes�check_supported_wheels�unnamed_requirementsZsuccessfully_downloaded�reqs_to_cleanup)�selfrr�r�=/usr/lib/python3.8/site-packages/pip/_internal/req/req_set.py�__init__szRequirementSet.__init__cCs4tdd�|j��D�dd�d�}d�dd�|D��S)Ncss|]}|js|VqdS�N)Z
comes_from��.0�reqrrr�	<genexpr>+sz)RequirementSet.__str__.<locals>.<genexpr>cSs
t|j�Sr�r�name�rrrr�<lambda>,�z(RequirementSet.__str__.<locals>.<lambda>��key� css|]}t|j�VqdSr��strrrrrrr.s)�sortedr�values�join)rrrrr�__str__(s
�zRequirementSet.__str__cCsBt|j��dd�d�}d}|j|jjt|�d�dd�|D��d�S)	NcSs
t|j�Srrr!rrrr"4r#z)RequirementSet.__repr__.<locals>.<lambda>r$z4<{classname} object; {count} requirement(s): {reqs}>z, css|]}t|j�VqdSrr'rrrrr;sz*RequirementSet.__repr__.<locals>.<genexpr>)Z	classname�countZreqs)r)rr*�format�	__class__�__name__�lenr+)rr�
format_stringrrr�__repr__0s��zRequirementSet.__repr__cCs|j�|�dSr)r�append)r�install_reqrrr�add_unnamed_requirement>sz&RequirementSet.add_unnamed_requirementcCst|j�}||j|<dSr)rr r)rr5�project_namerrr�add_named_requirementCs
z$RequirementSet.add_named_requirementNc	Cs�|�|�s$t�d|j|j�gdfS|jrd|jjrdt|jj�}t	�
�}|jrd|�|�sdt
d|j��|js~|�|�|gdfSz|�|j�}Wntk
r�d}YnX|dko�|o�|jo�|j|jko�|jj|jjk}|r�t
d|||jf��|�s
|�|�|g|fS|j�s|j�s"g|fS|j�oB|j�o@|jj|jjk}|�rd|j�|�t
d|j��d|_ttt|j�t|j�B��|_t�d||j�|g|fS)a&Add install_req as a requirement to install.

        :param parent_req_name: The name of the requirement that needed this
            added. The name is used because when multiple unnamed requirements
            resolve to the same name, we could otherwise end up with dependency
            links that point outside the Requirements set. parent_req must
            already be added. Note that None implies that this is a user
            supplied requirement, vs an inferred one.
        :param extras_requested: an iterable of extras used to evaluate the
            environment markers.
        :return: Additional requirements to scan. That is either [] if
            the requirement is not applicable, or [install_req] if the
            requirement is applicable and has just been added.
        z6Ignoring %s: markers '%s' don't match your environmentNz-%s is not a supported wheel on this platform.z5Double requirement given: %s (already in %s, name=%r)zhCould not satisfy constraints for '%s': installation from path or url cannot be constrained to a versionFzSetting %s extras to: %s)Z
match_markers�logger�infor Zmarkers�linkZis_wheelr	�filenamerZ
get_supportedrZ	supportedrr6�get_requirement�KeyError�
constraintZextrasrZ	specifierr8�pathrr4�tupler)�set�debug)	rr5Zparent_req_nameZextras_requestedZwheelZtagsZexisting_reqZhas_conflicting_requirementZdoes_not_satisfy_constraintrrr�add_requirementJs�
���



��
��
��

������zRequirementSet.add_requirementcCs t|�}||jko|j|jSr)rrr?�rr r7rrr�has_requirement�s
�zRequirementSet.has_requirementcCs,t|�}||jkr|j|Std|��dS)NzNo project with the name %r)rrr>rErrrr=�s

zRequirementSet.get_requirementc	Cs4t�d�t��|jD]}|��qW5QRXdS)zClean up files, remove builds.zCleaning up...N)r9rCrrZremove_temporary_source)rrrrr�
cleanup_files�s

zRequirementSet.cleanup_files)FT)NN)r0�
__module__�__qualname__rr,r3r6r8rDrFr=rGrrrrrs


�
p		r)Z
__future__rZlogging�collectionsrZpip._vendor.packaging.utilsrZ
pip._internalrZpip._internal.exceptionsrZpip._internal.utils.loggingrZpip._internal.utils.typingrZpip._internal.wheelr	�typingr
rrr
rZpip._internal.req.req_installrZ	getLoggerr0r9�objectrrrrr�<module>s
site-packages/pip/_internal/req/__pycache__/req_install.cpython-38.opt-1.pyc000064400000055511151446176770022763 0ustar00U

��.e��@sLddlmZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZm
Z
ddlmZddlmZddlmZddlmZdd	lmZdd
lmZmZddlmZddlmZdd
lm Z ddl!m"Z"ddl#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=ddl>m?Z?ddl@mAZAddlBmCZCmDZDddlEmFZFddlGmHZHddlImJZJddlKmLZLeH�r.ddlMmNZNmOZOmPZPmQZQmRZRmSZSmTZTddlmUZUddlVmWZWdd lXmYZYdd!lZm[Z[dd"l\m]Z]dd#l^m_Z_e�`ea�ZbGd$d%�d%ec�ZddS)&�)�absolute_importN)�change_root)�
pkg_resources�six)�Requirement)�canonicalize_name)�Version)�parse)�Pep517HookCaller)�
pep425tags�wheel)�NoOpBuildEnvironment)�InstallationError)�Link)�get_metadata_generator)�load_pyproject_toml�make_pyproject_path)�UninstallPathSet)�
native_str)�Hashes)�
indent_log)�PIP_DELETE_MARKER_FILENAME�has_delete_marker_file)�_make_build_dir�ask_path_exists�
backup_dir�display_path�dist_in_install_path�dist_in_site_packages�dist_in_usersite�
ensure_dir�get_installed_version�hide_url�redact_auth_from_url�rmtree)�get_metadata)�make_setuptools_shim_args)�call_subprocess�runner_with_spinner_message)�
TempDirectory)�MYPY_CHECK_RUNNING)�running_under_virtualenv)�vcs)�Any�Dict�Iterable�List�Optional�Sequence�Union)�BuildEnvironment)�
WheelCache)�
PackageFinder)�Distribution)�SpecifierSet)�Markerc
@speZdZdZdPdd�Zdd�Zd	d
�Zdd�Zd
d�Ze	dd��Z
e	dd��Ze	dd��Ze	dd��Z
dQdd�Ze	dd��ZdRdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Ze	d(d)��ZdSd*d+�Ze	d,d-��Ze	d.d/��Ze	d0d1��Zd2d3�Zd4d5�Zd6d7�Ze	d8d9��Zd:d;�Zd<d=�Z d>d?�Z!dTd@dA�Z"dUdBdC�Z#dVdDdE�Z$dFdG�Z%dHdI�Z&dJdK�Z'dWdLdM�Z(dNdO�Z)dS)X�InstallRequirementz�
    Represents something that may be installed later on, may have information
    about where to fetch the relevant requirement and also contains logic for
    installing the said requirement.
    NF�c

Cs||_||_||_|dkr"d|_ntj�tj�|��|_||_|
|_	|dkr`|r`|j
r`t|j
�}||_|_
|rx||_n |r�dd�|jD�|_nt�|_|dkr�|r�|j}||_d|_d|_d|_d|_d|_|	r�|	ni|_d|_d|_||_t�|_d|_d|_g|_d|_ ||_!dS)NcSsh|]}t�|��qSr;)rZ
safe_extra��.0�extrar;r;�A/usr/lib/python3.8/site-packages/pip/_internal/req/req_install.py�	<setcomp>wsz.InstallRequirement.__init__.<locals>.<setcomp>F)"�req�
comes_from�
constraint�
source_dir�os�path�normpath�abspath�editable�_wheel_cache�urlr�link�
original_link�extras�set�marker�markers�satisfied_by�conflicts_with�_temp_build_dir�_ideal_build_dir�install_succeeded�optionsZpreparedZ	is_direct�isolatedr
�	build_env�metadata_directory�pyproject_requires�requirements_to_check�pep517_backend�
use_pep517)
�selfrArBrDrIrLrQr^rXrWZwheel_cacherCrNr;r;r?�__init__TsH
�
zInstallRequirement.__init__cCs�|jr,t|j�}|jrD|dt|jj�7}n|jr@t|jj�}nd}|jdk	rb|dt|jj�7}|jr�t	|jt
j�r~|j}n
|j��}|r�|d|7}|S)Nz from %sz<InstallRequirement>z in %sz
 (from %s))
rA�strrLr#rKrRr�locationrB�
isinstancer�string_types�	from_path�r_�srBr;r;r?�__str__�s 


zInstallRequirement.__str__cCsd|jjt|�|jfS)Nz<%s object: %s editable=%r>)�	__class__�__name__rarI�r_r;r;r?�__repr__�s
�zInstallRequirement.__repr__cs>t|��t��}�fdd�t|�D�}dj|jjd�|�d�S)z>An un-tested helper for getting state, for debugging.
        c3s|]}d�|�|�VqdS)z{}={!r}N)�format)r=�attr�Z
attributesr;r?�	<genexpr>�sz2InstallRequirement.format_debug.<locals>.<genexpr>z<{name} object: {{{state}}}>z, )�name�state)�vars�sortedrmrirj�join)r_�namesrrr;ror?�format_debug�s
��zInstallRequirement.format_debugcCsh|jdkr|�||�|_|jdk	rd|sd|j}t��}|jj|j|j|d�|_||jkrdt�d|j�dS)aEnsure that if a link can be found for this, that it is found.

        Note that self.link may still be None - if Upgrade is False and the
        requirement is already installed.

        If require_hashes is True, don't use the wheel cache, because cached
        wheels, always built locally, have different hashes than the files
        downloaded from the index server and thus throw false hash mismatches.
        Furthermore, cached wheels at present have undeterministic contents due
        to file modification times.
        N)rLZpackage_name�supported_tagszUsing cached wheel link: %s)	rLZfind_requirementrJrZ
get_supported�getrq�logger�debug)r_�finderZupgradeZrequire_hashesZold_linkrxr;r;r?�
populate_link�s
�
z InstallRequirement.populate_linkcCs |jdkrdStt�|jj��S�N)rArrZ	safe_namerqrkr;r;r?rq�s
zInstallRequirement.namecCs|jjSr~)rA�	specifierrkr;r;r?r�szInstallRequirement.specifiercCs$|j}t|�dko"tt|��jdkS)z�Return whether I am pinned to an exact version.

        For example, some-package==1.2 is pinned; some-package>1.2 is not.
        �>�==�===)r�len�next�iter�operator)r_Z
specifiersr;r;r?�	is_pinned�s�zInstallRequirement.is_pinnedcCs
t|j�Sr~)r!rqrkr;r;r?�installed_versionsz$InstallRequirement.installed_versioncs0|sd}�jdk	r(t�fdd�|D��SdSdS)N)�c3s|]}�j�d|i�VqdS)r>N)rQZevaluater<rkr;r?rps�z3InstallRequirement.match_markers.<locals>.<genexpr>T)rQ�any)r_Zextras_requestedr;rkr?�
match_markerss
�z InstallRequirement.match_markerscCst|j�di��S)z�Return whether any known-good hashes are specified as options.

        These activate --require-hashes mode; hashes specified as part of a
        URL do not.

        �hashes)�boolrWryrkr;r;r?�has_hash_optionss	z#InstallRequirement.has_hash_optionsTcCsJ|j�di���}|r|jn|j}|rB|jrB|�|jg��|j�t	|�S)a�Return a hash-comparer that considers my option- and URL-based
        hashes to be known-good.

        Hashes in URLs--ones embedded in the requirements file, not ones
        downloaded from an index server--are almost peers with ones from
        flags. They satisfy --require-hashes (whether it was implicitly or
        explicitly activated) but do not activate it. md5 and sha224 are not
        allowed in flags, which should nudge people toward good algos. We
        always OR all hashes together, even ones from URLs.

        :param trust_internet: Whether to trust URL-based (#md5=...) hashes
            downloaded from the internet, as by populate_link()

        r�)
rWry�copyrLrM�hash�
setdefaultZ	hash_name�appendr)r_Ztrust_internetZgood_hashesrLr;r;r?r�#s

zInstallRequirement.hashescCsR|jdkrdSt|j�}|jrNt|jtj�r4|j}n
|j��}|rN|d|7}|S)z@Format a nice indicator to show where this "comes from"
        Nz->)rArarBrcrrdrerfr;r;r?re9s


zInstallRequirement.from_pathcCs||jdk	r|jjS|jdkr6tdd�|_||_|jjS|jrH|j��}n|j}tj�	|�snt
�d|�t|�tj�
||�S)Nz	req-build��kindzCreating directory %s)rTrFrAr)rUrIrq�lowerrE�existsrzr{rru)r_�	build_dirrqr;r;r?�ensure_build_locationIs

z(InstallRequirement.ensure_build_locationcCs�|jdk	rdS|j}d|_|�|j�}tj�|�rBtdt|���t	�
d|t|j�t|��t�|j|�tj�
tj�|��|_t|dd�|_|jr�|j}tjj||jd�}tj�||�}tj�
tj�|��}||_d|_dS)a�Move self._temp_build_dir to "self._ideal_build_dir/self.req.name"

        For some requirements (e.g. a path to a directory), the name of the
        package is not available until we run egg_info, so the build_location
        will return a temporary directory and store the _ideal_build_dir.

        This is only called to "fix" the build directory after generating
        metadata.
        Nz<A package already exists in %s; please remove it to continuez,Moving package %s from %s to new location %szreq-install)rFr�)�start)rDrTr�rUrErFr�rrrzr{�shutil�moverGrHr)rZ�relpathru)r_Zold_locationZnew_locationZold_metaZrelZnew_metar;r;r?�move_to_correct_build_directoryfs<
����z2InstallRequirement.move_to_correct_build_directorycCsR|jr(t|j�r(t�d|j�t|j�d|_|jrD|j��d|_|j��dS)zVRemove the source files from this requirement, if they are marked
        for deletionzRemoving source in %sN)rDrrzr{r$rT�cleanuprYrkr;r;r?�remove_temporary_source�s

z*InstallRequirement.remove_temporary_sourcecCs�|jdkrdSzHtt|j��}d|_t�t|��|_|jrT|jrT|j|_d|_WdSWn�tj	k
rnYdStj
k
r�t�|jj�}|r�t|�r�||_q�t
�r�t|�r�td|j|jf��nt|�r�||_YnXdS)z�Find an installed distribution that satisfies or conflicts
        with this requirement, and set self.satisfied_by or
        self.conflicts_with appropriately.
        NFTzVWill not install to the user site because it will lack sys.path precedence to %s in %s)rArrarPrZget_distributionrRrIrSZDistributionNotFoundZVersionConflictrqrr+rr�project_namerbr)r_�
use_user_siteZ	no_markerZ
existing_distr;r;r?�check_if_exists�s<

��
��z"InstallRequirement.check_if_existscCs|js
dS|jjS)NF)rL�is_wheelrkr;r;r?r��szInstallRequirement.is_wheelcCs(tj|j|j|||||||j|d�
dS)N)�user�home�root�prefix�	pycompilerX�warn_script_location)r�move_wheel_filesrqrArX)r_Zwheeldirr�r�r�r�r�r�r;r;r?r��s�z#InstallRequirement.move_wheel_filescCstj�|j|jr|jjpd�S)Nr�)rErFrurDrLZsubdirectory_fragmentrkr;r;r?�unpacked_source_directory�s�z,InstallRequirement.unpacked_source_directorycCs4tj�|jd�}tjr0t|tj�r0|�t	�
��}|S)Nzsetup.py)rErFrur�rZPY2rcZ	text_type�encode�sys�getfilesystemencoding)r_Zsetup_pyr;r;r?�
setup_py_path�sz InstallRequirement.setup_py_pathcCs
t|j�Sr~)rr�rkr;r;r?�pyproject_toml_pathsz&InstallRequirement.pyproject_toml_pathcCsXt|j|j|jt|��}|dkr*d|_dSd|_|\}}}||_||_t|j|�|_	dS)aALoad the pyproject.toml file.

        After calling this routine, all of the attributes related to PEP 517
        processing for this requirement have been set. In particular, the
        use_pep517 attribute can be used to determine whether we should
        follow the PEP 517 or legacy (setup.py) code path.
        NFT)
rr^r�r�rar\r[r
r�r])r_Zpyproject_toml_dataZrequires�backendZcheckr;r;r?r
s"	�
�z&InstallRequirement.load_pyproject_tomlc	Cs�t|�}t��||�|_W5QRX|jsttt|jd�t�rDd}nd}td�	|jd||jdg��|_|�
�n<t|jd�}t|jj�|kr�t
�d|j||j�t|�|_dS)z�Ensure that project metadata is available.

        Under PEP 517, call the backend hook to prepare the metadata.
        Under legacy processing, call setup.py egg-info.
        rr�r�r��NamezeGenerating metadata for package %s produced metadata for project name %s. Fix your #egg=%s fragments.N)rrrZrArc�
parse_version�metadatarrrur�rrqrz�warning)r_Zmetadata_generator�opZ
metadata_namer;r;r?�prepare_metadata)s0	��
�z#InstallRequirement.prepare_metadatac
Csjtdd�}t�|j�|j}|j�4td�}|j}|�|��|�	|�}W5QRXW5QRXt
j�||�S)Nzmodern-metadatar�zPreparing wheel metadata)r)�atexit�registerr�rFrYr(r]Zsubprocess_runnerZ prepare_metadata_for_build_wheelrEru)r_Zmetadata_tmpdirZmetadata_dir�runnerr�Zdistinfo_dirr;r;r?�prepare_pep517_metadataNs
�z*InstallRequirement.prepare_pep517_metadatacCst|d�st|���|_|jS)N�	_metadata)�hasattrr%�get_distr�rkr;r;r?r�es
zInstallRequirement.metadatacCs`|j�tj�}|�d�r tj}ntj}tj�	|�\}}tj�
|�d}t�||�}||||d�S)z8Return a pkg_resources.Distribution for this requirement�	.egg-infor)r�r�)rZ�rstriprE�sep�endswithrr7ZDistInfoDistributionrF�split�splitextZPathMetadata)r_Zdist_dirZdist_clsZbase_dirZ
dist_dir_nameZ	dist_namer�r;r;r?r�ms
�zInstallRequirement.get_distcCsH|jd}|jjr.||jjkr.t�d||�nt�dt|j�||�dS)N�versionz'Requested %s, but installing version %sz;Source in %s has version %s, which satisfies requirement %s)r�rArrzr�r{rrD)r_r�r;r;r?�assert_source_matches_version�s
��z0InstallRequirement.assert_source_matches_versioncCs|jdkr|�|�|_dS)aAEnsure that a source_dir is set.

        This will create a temporary build dir if the name of the requirement
        isn't known yet.

        :param parent_dir: The ideal pip parent_dir for the source_dir.
            Generally src_dir for editables and build_dir for sdists.
        :return: self.source_dir
        N)rDr�)r_Z
parent_dirr;r;r?�ensure_has_source_dir�s
z(InstallRequirement.ensure_has_source_dirc
Cs�t�d|j�|r*d�|�g}t|�|}t|j||jd�}t��6|j	�$t
|ddgt|�|jd�W5QRXW5QRXd|_dS)NzRunning setup.py develop for %sz--prefix={})�global_options�no_user_configZdevelopz	--no-deps)�cwdT)
rz�inforqrm�listr&r�rXrrYr'r�rV)r_�install_optionsr�r�Zprefix_paramZbase_cmdr;r;r?�install_editable�s(����z#InstallRequirement.install_editablecCs�|jst�d|j�dS|jjdkr(dS|jj�dd�\}}t�|�}|r~t	|jj�}|rl|j
|j|d�q~|j|j|d�ndS)Nz>Cannot update repository at %s; repository location is unknown�file�+r�)rK)rLrzr{rDZschemerKr�r,Zget_backendr"�obtainZexport)r_r�Zvc_typerKZvcs_backendZ
hidden_urlr;r;r?�update_editable�s �
z"InstallRequirement.update_editablecCsB|�|�st�d|j�dS|jp&|j}t�|�}|�||�|S)a�
        Uninstall the distribution currently satisfying this requirement.

        Prompts before removing or modifying files unless
        ``auto_confirm`` is True.

        Refuses to delete or modify files outside of ``sys.prefix`` -
        thus uninstallation within a virtual environment can only
        modify that virtual environment, even if the virtualenv is
        linked to global site-packages.

        z#Skipping %s as it is not installed.N)	r�rzr�rqrRrSrZ	from_dist�remove)r_Zauto_confirm�verboser�ZdistZuninstalled_pathsetr;r;r?�	uninstall�s

zInstallRequirement.uninstallcCs(|t|�dd�}|�tjjd�}|S)Nr��/)r��replacerErFr�)r_rqr�r;r;r?�_clean_zip_name�sz"InstallRequirement._clean_zip_namecCs(tj�||�}|�||�}|jd|S)Nr�)rErFrur�rq)r_rF�	parentdir�rootdirrqr;r;r?�_get_archive_namesz$InstallRequirement._get_archive_namec	Cs�d}d|j|jdf}tj�||�}tj�|�r�tdt|�d�}|dkrRd}nj|dkrvt�	d	t|��t�
|�nF|d
kr�t|�}t�	dt|�t|��t�
||�n|dkr�t�d
�|s�dStj|dtjdd�}|��tj�tj�|j��}t�|�D]�\}	}
}d|
k�r|
�
d�|
D]6}|j||	|d�}
t�|
d�}d|_|�|d��q |D]>}|tk�rn�q\|j||	|d�}tj�|	|�}|�||��q\q�W5QRXt�dt|��dS)z}Saves archive to provided build_dir.

        Used for saving downloaded VCS requirements as part of `pip download`.
        Tz	%s-%s.zipr�z8The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)bort )�i�w�b�ar�Fr�zDeleting %sr�zBacking up %s to %sr����N)Z
allowZip64zpip-egg-info)r�r�r�i�r�zSaved %s)rqr�rErFrur�rrrzr�r�rr�r�r��exit�zipfileZZipFileZZIP_DEFLATED�normcaserHr��walkr�ZZipInfoZ
external_attrZwritestrr�writer�)r_r�Zcreate_archiveZarchive_nameZarchive_pathZresponseZ	dest_fileZ
zip_output�dir�dirpathZdirnames�	filenames�dirnameZdir_arcnameZzipdir�filenameZfile_arcnamer;r;r?�archivesx���
��

�
�zInstallRequirement.archivec	sh|dk	r|ng}|jr*|j|||d�dS|jrnt�|j�}	t�|	|j�|j|j�|||||d�d|_	dSt
|�|j�dg�}t
|�|j�dg�}t
dd����}
tj�|
jd�}|�||�||�}td	�|j��}
t��*|j�|
|||jd
�W5QRXW5QRXtj�|��s8t�d|�W5QR�dSd|_	�fdd
�}t|��\}|D],}tj�|�}|�d��rX||�}�q��qXt�d|�W5QR�W5QR�dSW5QRXg}t|��L}|D]@}|��}tj�|��r�|tjj 7}|�!tj�"||�|���q�W5QRX|�#�t$|�tj�|d�}t|d��}|�%d�|�d�W5QRXW5QRXdS)N)r�)r�r�r�r�r�r�Tr�r��recordr�zinstall-record.txtzRunning setup.py install for {})�cmdr�zRecord file %s not foundcs&�dkstj�|�s|St�|�SdSr~)rErF�isabsr)rF�r�r;r?�prepend_root�sz0InstallRequirement.install.<locals>.prepend_rootr�z;Could not find .egg-info directory in install record for %szinstalled-files.txtr��
)&rIr�r�rZ
wheel_versionrDZcheck_compatibilityrqr�rVr�rWryr)rErFru�get_install_argsr(rmrrYr�r�rzr{�openr�r�r��strip�isdirr�r�r��sortr r�)r_r�r�r�r�r�r�r�r�r�Ztemp_dir�record_filename�install_argsr�r��f�lineZ	directoryZegg_info_dirZ	new_linesr�Zinst_files_pathr;r�r?�installEs������
��

�"
�zInstallRequirement.installc	Cs�t|j||jdd�}|dd|g7}|dg7}|dk	r@|d|g7}|dk	rT|d|g7}|rd|dg7}n
|d	g7}t�r�d
t��}|dtj�t	j
dd
||j�g7}|S)NT)r�r�Zunbuffered_outputr�z--recordz#--single-version-externally-managedz--rootz--prefixz	--compilez--no-compile�pythonz--install-headersZincludeZsite)r&r�rXr+�	sysconfigZget_python_versionrErFrur�r�rq)r_r�r�r�r�r�r�Z
py_ver_strr;r;r?r��s0	�

��z#InstallRequirement.get_install_args)
NFNNNFNNFr;)N)T)NNNTFT)r;N)T)FFF)NNNNTFT)*rj�
__module__�__qualname__�__doc__r`rhrlrwr}�propertyrqrr�r�r�r�r�rer�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r;r;r;r?r:Ms�
�
W









8
+
	�



%
�

�
	B�
`r:)eZ
__future__rr�ZloggingrEr�r�r�r�Zdistutils.utilrZpip._vendorrrZ"pip._vendor.packaging.requirementsrZpip._vendor.packaging.utilsrZpip._vendor.packaging.versionrr	r�Zpip._vendor.pep517.wrappersr
Z
pip._internalrrZpip._internal.build_envr
Zpip._internal.exceptionsrZpip._internal.models.linkrZ*pip._internal.operations.generate_metadatarZpip._internal.pyprojectrrZpip._internal.req.req_uninstallrZpip._internal.utils.compatrZpip._internal.utils.hashesrZpip._internal.utils.loggingrZ pip._internal.utils.marker_filesrrZpip._internal.utils.miscrrrrrrrr r!r"r#r$Zpip._internal.utils.packagingr%Z$pip._internal.utils.setuptools_buildr&Zpip._internal.utils.subprocessr'r(Zpip._internal.utils.temp_dirr)Zpip._internal.utils.typingr*Zpip._internal.utils.virtualenvr+Zpip._internal.vcsr,�typingr-r.r/r0r1r2r3r4Zpip._internal.cacher5Zpip._internal.indexr6Zpip._vendor.pkg_resourcesr7Z pip._vendor.packaging.specifiersr8Zpip._vendor.packaging.markersr9Z	getLoggerrjrz�objectr:r;r;r;r?�<module>sV8$
site-packages/pip/_internal/req/__pycache__/req_uninstall.cpython-38.opt-1.pyc000064400000041635151446176770023330 0ustar00U

��.e&\�@s|ddlmZddlZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddlm
Z
mZddlmZmZmZddlmZddlmZmZmZmZmZmZmZmZmZdd	lm Z m!Z!dd
l"m#Z#e#�r
ddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/e�0e1�Z2d
d�Z3dd�Z4e4dd��Z5dd�Z6dd�Z7dd�Z8Gdd�de9�Z:Gdd�de9�Z;Gdd�de9�Z<dS)�)�absolute_importN)�
pkg_resources)�UninstallationError)�bin_py�bin_user)�WINDOWS�cache_from_source�uses_pycache)�
indent_log)	�FakeFile�ask�dist_in_usersite�
dist_is_local�
egg_link_path�is_local�normalize_path�renames�rmtree)�AdjacentTempDirectory�
TempDirectory)�MYPY_CHECK_RUNNING)	�Any�Callable�Dict�Iterable�Iterator�List�Optional�Set�Tuple)�DistributioncCslt|�rt}nt}tj�||�}|g}trh|�|d�|�|d�|rZ|�|d�n|�|d�|S)z�Create the fully qualified name of the files created by
    {console,gui}_scripts for the given ``dist``.
    Returns the list of file names
    z.exez
.exe.manifestz-script.pywz
-script.py)r
rr�os�path�joinr�append)�distZscript_nameZis_gui�bin_dirZexe_name�paths_to_remove�r(�C/usr/lib/python3.8/site-packages/pip/_internal/req/req_uninstall.py�
_script_names'sr*cst����fdd��}|S)Nc?s2t�}�||�D]}||kr|�|�|VqdS�N)�set�add)�args�kw�seen�item��fnr(r)�unique?s

z_unique.<locals>.unique)�	functools�wraps)r3r4r(r2r)�_unique=sr7ccs�t�t|�d���}|D]t}tj�|j|d�}|V|�d�rtj�	|�\}}|dd�}tj�||d�}|Vtj�||d�}|VqdS)a
    Yield all the uninstallation paths for dist based on RECORD-without-.py[co]

    Yield paths to all the files in RECORD. For each .py file in RECORD, add
    the .pyc and .pyo in the same directory.

    UninstallPathSet.add() takes care of the __pycache__ .py[co].
    ZRECORDr�.pyN����.pyc�.pyo)
�csv�readerrZget_metadata_linesr!r"r#�location�endswith�split)r%�r�rowr"Zdnr3�baser(r(r)�uninstallation_pathsJs
rDcsJtjj�t�}t|td�D]*�t��fdd�|D��}|s|���q|S)z�Compact a path set to contain the minimal number of paths
    necessary to contain all paths in the set. If /a/path/ and
    /a/path/to/a/file.txt are both in the set, leave only the
    shorter path.��keyc3s:|]2}��|�d��o0�t|�d������kVqdS)�*N)�
startswith�rstrip�len)�.0Z	shortpath�r"�sepr(r)�	<genexpr>ls�zcompact.<locals>.<genexpr>)r!r"rMr,�sortedrJ�anyr-)�pathsZshort_pathsZshould_skipr(rLr)�compactbs�rRc	s�tdd�|D��}t|�}ttdd�|��D��td�}t�}dd��|D]��t�fdd�|D��rfqJt�}t�}t���D]B\�}}|����fdd�|D��|����fd	d�|D��q|||sJ|�	|�|�
�tj�qJtt|j
|��|BS)
z�Returns a set containing the paths that need to be renamed.

    This set may include directories when the original sequence of paths
    included every file on disk.
    css|]}tj�|�|fVqdSr+)r!r"�normcase�rK�pr(r(r)rN}sz&compress_for_rename.<locals>.<genexpr>css|]}tj�|�dVqdS)rN)r!r"r@rTr(r(r)rNs�rEcWstj�tjj|��Sr+)r!r"rSr#)�ar(r(r)�	norm_join�sz&compress_for_rename.<locals>.norm_joinc3s |]}tj����|�VqdSr+)r!r"rSrH)rK�w)�rootr(r)rN�s�c3s|]}���|�VqdSr+r()rK�d��dirnamerWrYr(r)rN�s�c3s|]}���|�VqdSr+r()rK�fr[r(r)rN�s�)�dictr,rO�valuesrJrPr!�walk�update�difference_updater-rM�map�__getitem__)	rQZcase_mapZ	remainingZ	uncheckedZ	wildcardsZ	all_filesZall_subdirsZsubdirs�filesr(r[r)�compress_for_renamevs6
�����

rfc
Cs�t|�}t�}t�}t�}|D]>}|�d�r.q|�d�s@d|krR|�tj�|��|�|�qtttjj|��}t|�}|D]d}t�	|�D]T\}}	}
|
D]D}|�d�r�q�tj�
||�}tj�|�r�tj�|�|kr�|�|�q�q�q||dd�|D�B}||fS)asReturns a tuple of 2 sets of which paths to display to user

    The first set contains paths that would be deleted. Files of a package
    are not added and the top-level directory of the package has a '*' added
    at the end - to signify that all it's contents are removed.

    The second set contains files that would have been skipped in the above
    folders.
    r:z__init__.py�
.dist-infocSsh|]}tj�|d��qS)rG)r!r"r#)rK�folderr(r(r)�	<setcomp>�sz.compress_for_output_listing.<locals>.<setcomp>)r,r?r-r!r"r\rcrSrRr`r#�isfile)
rQ�will_remove�	will_skipZfoldersrer"Z_normcased_filesrh�dirpath�_ZdirfilesZfnameZfile_r(r(r)�compress_for_output_listing�s4

��roc@sLeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	e
dd��ZdS)�StashedUninstallPathSetzWA set of file rename operations to stash files while
    tentatively uninstalling them.cCsi|_g|_dSr+)�
_save_dirs�_moves��selfr(r(r)�__init__�sz StashedUninstallPathSet.__init__cCsDzt|�}Wntk
r*tdd�}YnX||jtj�|�<|jS)z�Stashes a directory.

        Directories are stashed adjacent to their original location if
        possible, or else moved/copied into the user's temp dir.�	uninstall�Zkind)r�OSErrorrrqr!r"rS)rtr"�save_dirr(r(r)�_get_directory_stash�sz,StashedUninstallPathSet._get_directory_stashcCs�tj�|�}tj�|�d}}d}||krfz|j|}Wq�Wntk
rPYnXtj�|�|}}q"tj�|�}tdd�}||j|<tj�||�}|r�|tjjkr�tj�	|j|�S|jS)z�Stashes a file.

        If no root has been provided, one will be created for the directory
        in the user's temp directory.Nrvrw)
r!r"rSr\rq�KeyErrorr�relpath�curdirr#)rtr"�headZold_headryr|r(r(r)�_get_file_stash�s"


z'StashedUninstallPathSet._get_file_stashcCsltj�|�otj�|�}|r*|�|�}n
|�|�}|j�||f�|r^tj�|�r^t�|�t	||�|S)z�Stashes the directory or file and returns its new location.
        Handle symlinks as files to avoid modifying the symlink targets.
        )
r!r"�isdir�islinkrzrrrr$�rmdirr)rtr"Zpath_is_dir�new_pathr(r(r)�stashs


zStashedUninstallPathSet.stashcCs,|j��D]\}}|��q
g|_i|_dS)z0Commits the uninstall by removing stashed files.N)rq�itemsZcleanuprr)rtrnryr(r(r)�commits
zStashedUninstallPathSet.commitcCs�|jD]}tjd|��q|jD]�\}}zTt�d||�tj�|�sPtj�|�r\t�	|�ntj�
|�rpt|�t||�Wq t
k
r�}zt�d|�t�d|�W5d}~XYq Xq |��dS)z2Undoes the uninstall by moving stashed files back.�Moving to %s
 from %szReplacing %s from %szFailed to restore %sz
Exception: %sN)r�)rr�logging�info�logger�debugr!r"rjr��unlinkr�rrrx�errorr�)rtrUr�r"Zexr(r(r)�rollback&s
 z StashedUninstallPathSet.rollbackcCs
t|j�Sr+)�boolrrrsr(r(r)�can_rollback:sz$StashedUninstallPathSet.can_rollbackN)�__name__�
__module__�__qualname__�__doc__rurzrr�r�r��propertyr�r(r(r(r)rp�s	rpc@s^eZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	dd�Z
dd�Zedd��Z
dS)�UninstallPathSetzMA set of file paths to be removed in the uninstallation of a
    requirement.cCs(t�|_t�|_i|_||_t�|_dSr+)r,rQ�_refuse�pthr%rp�_moved_paths)rtr%r(r(r)ruCs
zUninstallPathSet.__init__cCst|�S)zs
        Return True if the given path is one we are permitted to
        remove/modify, False otherwise.

        )r)rtr"r(r(r)�
_permittedKszUninstallPathSet._permittedcCs�tj�|�\}}tj�t|�tj�|��}tj�|�s:dS|�|�rR|j�	|�n|j
�	|�tj�|�ddkr�tr�|�	t
|��dS)N�r8)r!r"r@r#rrS�existsr�rQr-r��splitextr	r)rtr"r~�tailr(r(r)r-Ts
zUninstallPathSet.addcCsLt|�}|�|�r<||jkr*t|�|j|<|j|�|�n|j�|�dSr+)rr�r��UninstallPthEntriesr-r�)rt�pth_file�entryr(r(r)�add_pthhs

zUninstallPathSet.add_pthFc	Cs�|jst�d|jj�dS|jjd|jj}t�d|�t��p|sP|�|�r�|j}t	|j�}t
t|��D]}|�|�t�
d|�ql|j��D]}|��q�t�d|�W5QRXdS)z[Remove paths in ``self.paths`` with confirmation (unless
        ``auto_confirm`` is True).z7Can't uninstall '%s'. No files were found to uninstall.N�-zUninstalling %s:zRemoving file or directory %szSuccessfully uninstalled %s)rQr�r�r%�project_name�versionr
�_allowed_to_proceedr�rfrOrRr�r�r�r_�remove)rtZauto_confirm�verboseZdist_name_versionZmovedZ
for_renamer"r�r(r(r)r�rs&��


zUninstallPathSet.removecCsndd�}|st|j�\}}nt|j�}t�}|d|�|d|�|d|j�|r`|dt|j��tdd�d	kS)
zIDisplay which files would be deleted and prompt for confirmation
        c	SsD|sdSt�|�t��"tt|��D]}t�|�q&W5QRXdSr+)r�r�r
rOrR)�msgrQr"r(r(r)�_display�s
z6UninstallPathSet._allowed_to_proceed.<locals>._displayz
Would remove:z+Would not remove (might be manually added):z%Would not remove (outside of prefix):zWill actually move:zProceed (y/n)? )�y�nr�)rorQr,r�rfr)rtr�r�rkrlr(r(r)r��s



z$UninstallPathSet._allowed_to_proceedcCsR|jjst�d|jj�dSt�d|jj�|j��|j�	�D]}|��q@dS)z1Rollback the changes previously made by remove().z'Can't roll back %s; was not uninstalledNzRolling back uninstall of %s)
r�r�r�r�r%r�r�r�r�r_)rtr�r(r(r)r��s�
zUninstallPathSet.rollbackcCs|j��dS)z?Remove temporary save dir: rollback will no longer be possible.N)r�r�rsr(r(r)r��szUninstallPathSet.commitc	s�t|j�}t|�s.t�d|j|tj�||�S|dd�t�	d�t�	d�hD�krht�d|j|�||�S||�}t
|�}d�t�
|j��}|jo�tj�|j�}t|jdd�}|�r�|j�d	��r�|j�|��s�|�|j�|�d
��r|�d
���D]&}tj�tj�|j|��}	|�|	�q�n�|�d��r�|�d��rB|�d��ng��fd
d�|�d���D�D]J}
tj�|j|
�}	|�|	�|�|	d�|�|	d�|�|	d��qb�n|�r�td�|j���n�|j�d��r |�|j�tj�|j�d}tj�tj�|j�d�}|�|d|�n�|�rP|j�d��rPt |�D]}	|�|	��q<np|�r�t!|d��}
tj�"|
�#��$��}W5QRX|�|�tj�tj�|�d�}|�||j�nt�%d||j�|�d��r0|�&d��r0|�'d�D]L}t(|��r�t)}nt*}|�tj�||��t+�r�|�tj�||�d��q�g}|j,dd�}|�-�D]}|�.t/||d���qH|j,dd�}|�-�D]}|�.t/||d ���qv|D]}|�|��q�|S)!Nz1Not uninstalling %s at %s, outside environment %scSsh|]}|r|�qSr(r(rTr(r(r)ri�s�z-UninstallPathSet.from_dist.<locals>.<setcomp>ZstdlibZ
platstdlibz<Not uninstalling %s at %s, as it is in the standard library.z{}.egg-infor"z	.egg-infozinstalled-files.txtz
top_level.txtznamespace_packages.txtcsg|]}|r|�kr|�qSr(r(rT�Z
namespacesr(r)�
<listcomp>�s�z.UninstallPathSet.from_dist.<locals>.<listcomp>r8r:r;z�Cannot uninstall {!r}. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.z.eggr�zeasy-install.pthz./rgrAz)Not sure how to uninstall: %s - Check: %sZscriptsz.bat�console_scripts)�groupF�gui_scriptsT)0rr>rr�r�rF�sys�prefix�	sysconfigZget_pathr�formatrZto_filenamer�Zegg_infor!r"r��getattrZ	_providerr?r-Zhas_metadataZget_metadata�
splitlines�normpathr#rr@r\r�rD�openrS�readline�stripr�Zmetadata_isdirZmetadata_listdirr
rrrZ
get_entry_map�keys�extendr*)�clsr%Z	dist_pathr'Zdevelop_egg_linkZdevelop_egg_link_egg_infoZegg_info_existsZdistutils_egg_infoZinstalled_filer"Z
top_level_pkgZeasy_install_eggZeasy_install_pth�fhZlink_pointerZscriptr&Z_scripts_to_remover��namer��sr(r�r)�	from_dist�s�
��
�
�
���
�

���
��
zUninstallPathSet.from_distN)FF)r�r�r�r�rur�r-r�r�r�r�r��classmethodr�r(r(r(r)r�@s	

 r�c@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
r�cCs0tj�|�std|��||_t�|_d|_dS)Nz.Cannot remove entries from nonexistent file %s)r!r"rjr�filer,�entries�_saved_lines)rtr�r(r(r)ruIs�zUninstallPthEntries.__init__cCs<tj�|�}tr,tj�|�ds,|�dd�}|j�|�dS)Nr�\�/)r!r"rSr�
splitdrive�replacer�r-)rtr�r(r(r)r-Ss
zUninstallPthEntries.addc	Cs�t�d|j�t|jd��}|��}||_W5QRXtdd�|D��rLd}nd}|r~|d�|�d��s~|d|�d�|d<|j	D]>}z$t�d	|�|�
||�d��Wq�tk
r�Yq�Xq�t|jd
��}|�|�W5QRXdS)NzRemoving pth entries from %s:�rbcss|]}d|kVqdS)s
Nr()rK�liner(r(r)rNjsz-UninstallPthEntries.remove.<locals>.<genexpr>z
�
���zutf-8zRemoving entry: %s�wb)
r�r�r�r��	readlinesr�rPr?�encoder�r��
ValueError�
writelines)rtr��linesZendliner�r(r(r)r�cs"
zUninstallPthEntries.removec	CsR|jdkrt�d|j�dSt�d|j�t|jd��}|�|j�W5QRXdS)Nz.Cannot roll back changes to %s, none were madeFz!Rolling %s back to previous stater�T)r�r�r�r�r�r�r�)rtr�r(r(r)r�zs
�zUninstallPthEntries.rollbackN)r�r�r�rur-r�r�r(r(r(r)r�Hs
r�)=Z
__future__rr<r5r�r!r�r�Zpip._vendorrZpip._internal.exceptionsrZpip._internal.locationsrrZpip._internal.utils.compatrrr	Zpip._internal.utils.loggingr
Zpip._internal.utils.miscrrr
rrrrrrZpip._internal.utils.temp_dirrrZpip._internal.utils.typingr�typingrrrrrrrrrZpip._vendor.pkg_resourcesr Z	getLoggerr�r�r*r7rDrRrfro�objectrpr�r�r(r(r(r)�<module>s<,,


(3o
site-packages/pip/_internal/req/__pycache__/constructors.cpython-38.pyc000064400000024164151446176770022257 0ustar00U

��.e48�@s�dZddlZddlZddlZddlmZddlmZmZddl	m
Z
ddlmZm
Z
ddlmZddlmZmZdd	lmZdd
lmZddlmZddlmZdd
lmZmZddlmZddl m!Z!ddl"m#Z#m$Z$ddl%m&Z&e�rddl'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/dddgZ0e�1e2�Z3e
j4�5�Z6dd�Z7dd�Z8dd�Z9dd�Z:dd�Z;Gd d!�d!e<�Z=d"d#�Z>d/d%d�Z?d&d'�Z@d(d)�ZAd*d+�ZBd0d,d�ZCd1d-d.�ZDdS)2a~Backing implementation for InstallRequirement's various constructors

The idea here is that these formed a major chunk of InstallRequirement's size
so, moving them and support code dedicated to them outside of that class
helps creates for better understandability for the rest of the code.

These are meant to be used elsewhere within pip to create instances of
InstallRequirement.
�N)�Marker)�InvalidRequirement�Requirement)�	Specifier)�RequirementParseError�parse_requirements)�InstallationError)�PyPI�TestPyPI)�Link)�make_pyproject_path)�InstallRequirement)�ARCHIVE_EXTENSIONS)�is_installable_dir�splitext)�MYPY_CHECK_RUNNING)�path_to_url)�is_url�vcs)�Wheel)�Any�Dict�Optional�Set�Tuple�Union)�
WheelCache�install_req_from_editable�install_req_from_line�parse_editablecCs t|�d��}|tkrdSdS)z9Return True if `name` is a considered as an archive file.�TF)r�lowerr)�nameZext�r#�B/usr/lib/python3.8/site-packages/pip/_internal/req/constructors.py�is_archive_file4sr%cCs6t�d|�}d}|r*|�d�}|�d�}n|}||fS)Nz^(.+)(\[[^\]]+\])$r �)�re�match�group)�path�m�extrasZpath_no_extrasr#r#r$�
_strip_extras=s
r-cCs|s
t�Std|���jS)N�placeholder)�setrr!r,)r,r#r#r$�convert_extrasJsr0c
Cs`|}t|�\}}tj�|�rptj�tj�|d��shd�tj�|��}t|�}tj�	|�r`|d7}t
|��t|�}|���
d�r�t|�j}|r�||td|���jfS||dfStD]&}|���
d|�r�d||f}q�q�d	|kr�t
d
�|���|�d	d�d��}t�|��s:d
|d�dd�tjD��d}	t
|	��t|�j}|�sVt
d|��||dfS)aParses an editable requirement into:
        - a requirement name
        - an URL
        - extras
        - editable options
    Accepted requirements:
        svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir
        .[some_extra]
    zsetup.pyzMFile "setup.py" not found. Directory cannot be installed in editable mode: {}zb
(A "pyproject.toml" file was found, but editable mode currently requires a setup.py based build.)zfile:r.Nz%s:z%s+%s�+z�{} is not a valid editable requirement. It should either be a path to a local project or a VCS URL (beginning with svn+, git+, hg+, or bzr+).r rzFor --editable=%s only z, cSsg|]}|jd�qS)z+URL�r")�.0Zbackendr#r#r$�
<listcomp>�sz"parse_editable.<locals>.<listcomp>z is currently supportedzZCould not detect requirement name for '%s', please specify one with #egg=your_package_name)r-�osr*�isdir�exists�join�format�abspathr�isfilerrr!�
startswithr�egg_fragmentrr,r�splitZget_backendZbackends)
�editable_req�urlZ
url_no_extrasr,�msgZpyproject_pathZpackage_nameZversion_controlZvc_typeZ
error_messager#r#r$rQsb
���
�
����
��c	Cs�d}tj�|�r�d}zFt|d��2}tt|����|dd|ddd7}W5QRXWq�tk
r�tj	d	|d
d�Yq�Xn|d|7}|S)
z�Returns helpful msg in case requirements file does not exist,
    or cannot be parsed.

    :params req: Requirements file path
    �z It does exist.�rz The argument you provided z(%s) appears to be az" requirements file. If that is thez# case, use the '-r' flag to installz" the packages specified within it.z2Cannot parse '%s' as requirements             fileT)�exc_infoz File '%s' does not exist.)
r5r*r7�open�nextr�readr�logger�debug)�reqrA�fpr#r#r$�deduce_helpful_msg�s.������rLc@seZdZdd�ZdS)�RequirementPartscCs||_||_||_||_dS�N)�requirement�link�markersr,)�selfrOrPrQr,r#r#r$�__init__�szRequirementParts.__init__N)�__name__�
__module__�__qualname__rSr#r#r#r$rM�srMcCs`t|�\}}}|dk	rFzt|�}WqJtk
rBtd|��YqJXnd}t|�}t||d|�S)N�Invalid requirement: '%s')rrrrrrM)r?r"r@Zextras_overriderJrPr#r#r$�parse_req_from_editable�srXFc	
CsLt|�}|jjdkr|jjnd}t|j||d|j||||r>|ni||jd�S)N�fileT)	�
source_dirZeditablerP�
constraint�
use_pep517�isolated�options�wheel_cacher,)rXrP�schemeZ	file_pathr
rOr,)	r?�
comes_fromr\r]r^r_r[�partsrZr#r#r$r�s
�cCs>tjj|krdStjjdk	r,tjj|kr,dS|�d�r:dSdS)akChecks whether the string "looks like" a path on the filesystem.

    This does not check whether the target actually exists, only judge from the
    appearance.

    Returns true if any of the following conditions is true:
    * a path separator is found (either os.path.sep or os.path.altsep);
    * a dot is found (which represents the current directory).
    TN�.F)r5r*�sep�altsepr<r2r#r#r$�_looks_like_path�s
rfcCs�t|�r0tj�|�r0t|�r$t|�Std|��t|�s<dStj�|�rPt|�S|�	dd�}t
|�dkrxt|d�sxdSt�d|�t|�S)ad
    First, it checks whether a provided path is an installable directory
    (e.g. it has a setup.py). If it is, returns the path.

    If false, check if the path is an archive file (such as a .whl).
    The function checks if the path is a file. If false, if the path has
    an @, it will treat it as a PEP 440 URL requirement and return the path.
    zODirectory %r is not installable. Neither 'setup.py' nor 'pyproject.toml' found.N�@r r&rzARequirement %r looks like a filename, but the file does not exist)
rfr5r*r6rrrr%r;r>�lenrHZwarning)r*r"Zurlreq_partsr#r#r$�_get_url_from_path	s(
���rics�t|�rd}nd}||krF|�|d�\}}|��}|s<d}qJt|�}nd}|��}d�tj�tj�|��}d}d}t|�r�t|�}n&t	|�\}}t
||�}	|	dk	r�t|	�}|�r|jdkr�t�
d|j�r�tttj�tj�|j����}|j�r
t|j�}
d|
j|
jf�n|j�n|�t|�}�fdd�}�dk	�r�zt��}
Wn�tk
�r�tjj�k�rrd	}|t��7}n,d
�k�r�t�fdd�tD���s�d
}nd}|d����}|�r�|d�|�7}t|��YnXnd}
t|
|||�S)Nz; �;r rYz\.\./z%s==%scs�s|Sd�|��S)Nz{} (from {}))r9)�text)�line_sourcer#r$�with_source]sz(parse_req_from_line.<locals>.with_sourcezIt looks like a path.�=c3s|]}|�kVqdSrNr#)r3�op)�
req_as_stringr#r$�	<genexpr>jsz&parse_req_from_line.<locals>.<genexpr>z,= is not a valid operator. Did you mean == ?rBzInvalid requirement: {!r}z	
Hint: {}) rr>�striprr5r*�normpathr:rr-rir`r'�searchr@rZis_wheelr�filenamer"�versionr=r0rrrdrL�any�	operatorsr9rrM)r"rlZ
marker_sepZmarkers_as_stringrQr*rPZextras_as_string�pr@Zwheelr,rmrJZadd_msgrAr#)rlrpr$�parse_req_from_line+sj


�


��rzc	Cs6t||�}t|j||j|j|||r&|ni|||jd�
S)aCreates an InstallRequirement from a name, which might be a
    requirement, directory containing 'setup.py', filename, or URL.

    :param line_source: An optional string describing where the line is from,
        for logging purposes in case of an error.
    )rPrQr\r]r^r_r[r,)rzr
rOrPrQr,)	r"rar\r]r^r_r[rlrbr#r#r$rzs

�cCszzt|�}Wn tk
r,td|��YnXtjtjg}|jrh|rh|jrh|jj|krhtd|j	|f��t
|||||d�S)NrWzkPackages installed from PyPI cannot depend on packages which are not also hosted on PyPI.
%s depends on %s )r]r_r\)rrrr	Zfile_storage_domainr
r@rPZnetlocr"r
)Z
req_stringrar]r_r\rJZdomains_not_allowedr#r#r$�install_req_from_req_string�s,�
����r{)NNFNNF)NNFNNFN)NFNN)E�__doc__Zloggingr5r'Zpip._vendor.packaging.markersrZ"pip._vendor.packaging.requirementsrrZ pip._vendor.packaging.specifiersrZpip._vendor.pkg_resourcesrrZpip._internal.exceptionsrZpip._internal.models.indexr	r
Zpip._internal.models.linkrZpip._internal.pyprojectrZpip._internal.req.req_installr
Zpip._internal.utils.filetypesrZpip._internal.utils.miscrrZpip._internal.utils.typingrZpip._internal.utils.urlsrZpip._internal.vcsrrZpip._internal.wheelr�typingrrrrrrZpip._internal.cacher�__all__Z	getLoggerrTrHZ
_operators�keysrxr%r-r0rrL�objectrMrXrrfrirzrr{r#r#r#r$�<module>sr �

	
J�
"Q�
�site-packages/pip/_internal/req/__pycache__/req_install.cpython-38.pyc000064400000056654151446176770022035 0ustar00U

��.e��@sLddlmZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZm
Z
ddlmZddlmZddlmZddlmZdd	lmZdd
lmZmZddlmZddlmZdd
lm Z ddl!m"Z"ddl#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/m0Z0ddl1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=ddl>m?Z?ddl@mAZAddlBmCZCmDZDddlEmFZFddlGmHZHddlImJZJddlKmLZLeH�r.ddlMmNZNmOZOmPZPmQZQmRZRmSZSmTZTddlmUZUddlVmWZWdd lXmYZYdd!lZm[Z[dd"l\m]Z]dd#l^m_Z_e�`ea�ZbGd$d%�d%ec�ZddS)&�)�absolute_importN)�change_root)�
pkg_resources�six)�Requirement)�canonicalize_name)�Version)�parse)�Pep517HookCaller)�
pep425tags�wheel)�NoOpBuildEnvironment)�InstallationError)�Link)�get_metadata_generator)�load_pyproject_toml�make_pyproject_path)�UninstallPathSet)�
native_str)�Hashes)�
indent_log)�PIP_DELETE_MARKER_FILENAME�has_delete_marker_file)�_make_build_dir�ask_path_exists�
backup_dir�display_path�dist_in_install_path�dist_in_site_packages�dist_in_usersite�
ensure_dir�get_installed_version�hide_url�redact_auth_from_url�rmtree)�get_metadata)�make_setuptools_shim_args)�call_subprocess�runner_with_spinner_message)�
TempDirectory)�MYPY_CHECK_RUNNING)�running_under_virtualenv)�vcs)�Any�Dict�Iterable�List�Optional�Sequence�Union)�BuildEnvironment)�
WheelCache)�
PackageFinder)�Distribution)�SpecifierSet)�Markerc
@speZdZdZdPdd�Zdd�Zd	d
�Zdd�Zd
d�Ze	dd��Z
e	dd��Ze	dd��Ze	dd��Z
dQdd�Ze	dd��ZdRdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Ze	d(d)��ZdSd*d+�Ze	d,d-��Ze	d.d/��Ze	d0d1��Zd2d3�Zd4d5�Zd6d7�Ze	d8d9��Zd:d;�Zd<d=�Z d>d?�Z!dTd@dA�Z"dUdBdC�Z#dVdDdE�Z$dFdG�Z%dHdI�Z&dJdK�Z'dWdLdM�Z(dNdO�Z)dS)X�InstallRequirementz�
    Represents something that may be installed later on, may have information
    about where to fetch the relevant requirement and also contains logic for
    installing the said requirement.
    NF�c

Cs2|dkst|t�st|��||_||_||_|dkr<d|_ntj�	tj�
|��|_||_|
|_|dkrz|rz|j
rzt|j
�}||_|_|r�||_n |r�dd�|jD�|_nt�|_|dkr�|r�|j}||_d|_d|_d|_d|_d|_|	r�|	ni|_d|_d|_||_t�|_d|_ d|_!g|_"d|_#||_$dS)NcSsh|]}t�|��qSr;)rZ
safe_extra��.0�extrar;r;�A/usr/lib/python3.8/site-packages/pip/_internal/req/req_install.py�	<setcomp>wsz.InstallRequirement.__init__.<locals>.<setcomp>F)%�
isinstancer�AssertionError�req�
comes_from�
constraint�
source_dir�os�path�normpath�abspath�editable�_wheel_cache�urlr�link�
original_link�extras�set�marker�markers�satisfied_by�conflicts_with�_temp_build_dir�_ideal_build_dir�install_succeeded�optionsZpreparedZ	is_direct�isolatedr
�	build_env�metadata_directory�pyproject_requires�requirements_to_check�pep517_backend�
use_pep517)
�selfrCrDrFrKrNrSr`rZrYZwheel_cacherErPr;r;r?�__init__TsJ
�
zInstallRequirement.__init__cCs�|jr,t|j�}|jrD|dt|jj�7}n|jr@t|jj�}nd}|jdk	rb|dt|jj�7}|jr�t	|jt
j�r~|j}n
|j��}|r�|d|7}|S)Nz from %sz<InstallRequirement>z in %sz
 (from %s))
rC�strrNr#rMrTr�locationrDrAr�string_types�	from_path�ra�srDr;r;r?�__str__�s 


zInstallRequirement.__str__cCsd|jjt|�|jfS)Nz<%s object: %s editable=%r>)�	__class__�__name__rcrK�rar;r;r?�__repr__�s
�zInstallRequirement.__repr__cs>t|��t��}�fdd�t|�D�}dj|jjd�|�d�S)z>An un-tested helper for getting state, for debugging.
        c3s|]}d�|�|�VqdS)z{}={!r}N)�format)r=�attr�Z
attributesr;r?�	<genexpr>�sz2InstallRequirement.format_debug.<locals>.<genexpr>z<{name} object: {{{state}}}>z, )�name�state)�vars�sortedrnrjrk�join)ra�namesrsr;rpr?�format_debug�s
��zInstallRequirement.format_debugcCsh|jdkr|�||�|_|jdk	rd|sd|j}t��}|jj|j|j|d�|_||jkrdt�d|j�dS)aEnsure that if a link can be found for this, that it is found.

        Note that self.link may still be None - if Upgrade is False and the
        requirement is already installed.

        If require_hashes is True, don't use the wheel cache, because cached
        wheels, always built locally, have different hashes than the files
        downloaded from the index server and thus throw false hash mismatches.
        Furthermore, cached wheels at present have undeterministic contents due
        to file modification times.
        N)rNZpackage_name�supported_tagszUsing cached wheel link: %s)	rNZfind_requirementrLrZ
get_supported�getrr�logger�debug)ra�finderZupgradeZrequire_hashesZold_linkryr;r;r?�
populate_link�s
�
z InstallRequirement.populate_linkcCs |jdkrdStt�|jj��S�N)rCrrZ	safe_namerrrlr;r;r?rr�s
zInstallRequirement.namecCs|jjSr)rC�	specifierrlr;r;r?r��szInstallRequirement.specifiercCs$|j}t|�dko"tt|��jdkS)z�Return whether I am pinned to an exact version.

        For example, some-package==1.2 is pinned; some-package>1.2 is not.
        �>�==�===)r��len�next�iter�operator)raZ
specifiersr;r;r?�	is_pinned�s�zInstallRequirement.is_pinnedcCs
t|j�Sr)r!rrrlr;r;r?�installed_versionsz$InstallRequirement.installed_versioncs0|sd}�jdk	r(t�fdd�|D��SdSdS)N)�c3s|]}�j�d|i�VqdS)r>N)rSZevaluater<rlr;r?rqs�z3InstallRequirement.match_markers.<locals>.<genexpr>T)rS�any)raZextras_requestedr;rlr?�
match_markerss
�z InstallRequirement.match_markerscCst|j�di��S)z�Return whether any known-good hashes are specified as options.

        These activate --require-hashes mode; hashes specified as part of a
        URL do not.

        �hashes)�boolrYrzrlr;r;r?�has_hash_optionss	z#InstallRequirement.has_hash_optionsTcCsJ|j�di���}|r|jn|j}|rB|jrB|�|jg��|j�t	|�S)a�Return a hash-comparer that considers my option- and URL-based
        hashes to be known-good.

        Hashes in URLs--ones embedded in the requirements file, not ones
        downloaded from an index server--are almost peers with ones from
        flags. They satisfy --require-hashes (whether it was implicitly or
        explicitly activated) but do not activate it. md5 and sha224 are not
        allowed in flags, which should nudge people toward good algos. We
        always OR all hashes together, even ones from URLs.

        :param trust_internet: Whether to trust URL-based (#md5=...) hashes
            downloaded from the internet, as by populate_link()

        r�)
rYrz�copyrNrO�hash�
setdefaultZ	hash_name�appendr)raZtrust_internetZgood_hashesrNr;r;r?r�#s

zInstallRequirement.hashescCsR|jdkrdSt|j�}|jrNt|jtj�r4|j}n
|j��}|rN|d|7}|S)z@Format a nice indicator to show where this "comes from"
        Nz->)rCrcrDrArrerfrgr;r;r?rf9s


zInstallRequirement.from_pathcCs�|dk	st�|jdk	r*|jjs"t�|jjS|jdkrNtdd�|_||_|jjS|jr`|j��}n|j}t	j�
|�s�t�d|�t
|�t	j�||�S)Nz	req-build��kindzCreating directory %s)rBrVrHrCr)rWrKrr�lowerrG�existsr{r|rrv)ra�	build_dirrrr;r;r?�ensure_build_locationIs

z(InstallRequirement.ensure_build_locationcCs|jdk	rdS|jdk	st�|js&t�|jdk	r8|jjs<t�|j}d|_|�|j�}tj�|�rpt	dt
|���t�d|t
|j�t
|��t
�|j|�tj�tj�|��|_t|dd�|_|j�r|j}tjj||jd�}tj�||�}tj�tj�|��}||_d|_dS)a�Move self._temp_build_dir to "self._ideal_build_dir/self.req.name"

        For some requirements (e.g. a path to a directory), the name of the
        package is not available until we run egg_info, so the build_location
        will return a temporary directory and store the _ideal_build_dir.

        This is only called to "fix" the build directory after generating
        metadata.
        Nz<A package already exists in %s; please remove it to continuez,Moving package %s from %s to new location %szreq-install)rHr�)�start)rFrCrBrVrWrHr�rGr�rrr{r|�shutil�moverIrJr)r\�relpathrv)raZold_locationZnew_locationZold_metaZrelZnew_metar;r;r?�move_to_correct_build_directoryfsH

������z2InstallRequirement.move_to_correct_build_directorycCsR|jr(t|j�r(t�d|j�t|j�d|_|jrD|j��d|_|j��dS)zVRemove the source files from this requirement, if they are marked
        for deletionzRemoving source in %sN)rFrr{r|r$rV�cleanupr[rlr;r;r?�remove_temporary_source�s

z*InstallRequirement.remove_temporary_sourcecCs�|jdkrdSzHtt|j��}d|_t�t|��|_|jrT|jrT|j|_d|_WdSWn�tj	k
rnYdStj
k
r�t�|jj�}|r�t|�r�||_q�t
�r�t|�r�td|j|jf��nt|�r�||_YnXdS)z�Find an installed distribution that satisfies or conflicts
        with this requirement, and set self.satisfied_by or
        self.conflicts_with appropriately.
        NFTzVWill not install to the user site because it will lack sys.path precedence to %s in %s)rCrrcrRrZget_distributionrTrKrUZDistributionNotFoundZVersionConflictrrrr+rr�project_namerdr)ra�
use_user_siteZ	no_markerZ
existing_distr;r;r?�check_if_exists�s<

��
��z"InstallRequirement.check_if_existscCs|js
dS|jjS)NF)rN�is_wheelrlr;r;r?r��szInstallRequirement.is_wheelcCs(tj|j|j|||||||j|d�
dS)N)�user�home�root�prefix�	pycompilerZ�warn_script_location)r�move_wheel_filesrrrCrZ)raZwheeldirr�r�r�r�r�r�r;r;r?r��s�z#InstallRequirement.move_wheel_filescCstj�|j|jr|jjpd�S)Nr�)rGrHrvrFrNZsubdirectory_fragmentrlr;r;r?�unpacked_source_directory�s�z,InstallRequirement.unpacked_source_directorycCsF|jstd|��tj�|jd�}tjrBt|tj	�rB|�
t���}|S)N�No source dir for %szsetup.py)
rFrBrGrHrvr�rZPY2rAZ	text_type�encode�sys�getfilesystemencoding)raZsetup_pyr;r;r?�
setup_py_path�s
z InstallRequirement.setup_py_pathcCs|jstd|��t|j�S)Nr�)rFrBrr�rlr;r;r?�pyproject_toml_pathsz&InstallRequirement.pyproject_toml_pathcCsXt|j|j|jt|��}|dkr*d|_dSd|_|\}}}||_||_t|j|�|_	dS)aALoad the pyproject.toml file.

        After calling this routine, all of the attributes related to PEP 517
        processing for this requirement have been set. In particular, the
        use_pep517 attribute can be used to determine whether we should
        follow the PEP 517 or legacy (setup.py) code path.
        NFT)
rr`r�r�rcr^r]r
r�r_)raZpyproject_toml_dataZrequires�backendZcheckr;r;r?r
s"	�
�z&InstallRequirement.load_pyproject_tomlc	Cs�|js
t�t|�}t��||�|_W5QRX|js~tt|jd�t	�rNd}nd}t
d�|jd||jdg��|_|��n<t
|jd�}t
|jj�|kr�t�d|j||j�t
|�|_dS)z�Ensure that project metadata is available.

        Under PEP 517, call the backend hook to prepare the metadata.
        Under legacy processing, call setup.py egg-info.
        rr�r�r��NamezeGenerating metadata for package %s produced metadata for project name %s. Fix your #egg=%s fragments.N)rFrBrrr\rCrA�
parse_version�metadatarrrvr�rrrr{�warning)raZmetadata_generator�opZ
metadata_namer;r;r?�prepare_metadata)s2
��
�z#InstallRequirement.prepare_metadatac
Csx|jdk	st�tdd�}t�|j�|j}|j�4td�}|j}|�	|��|�
|�}W5QRXW5QRXtj�||�S)Nzmodern-metadatar�zPreparing wheel metadata)
r_rBr)�atexit�registerr�rHr[r(Zsubprocess_runnerZ prepare_metadata_for_build_wheelrGrv)raZmetadata_tmpdirZmetadata_dir�runnerr�Zdistinfo_dirr;r;r?�prepare_pep517_metadataNs
�z*InstallRequirement.prepare_pep517_metadatacCst|d�st|���|_|jS)N�	_metadata)�hasattrr%�get_distr�rlr;r;r?r�es
zInstallRequirement.metadatacCsn|j�tj�}|�d�r tj}n|�d�s.t�tj}tj	�
|�\}}tj	�|�d}t�||�}||||d�S)z8Return a pkg_resources.Distribution for this requirement�	.egg-infoz
.dist-infor)r�r�)
r\�rstriprG�sep�endswithrr7rBZDistInfoDistributionrH�split�splitextZPathMetadata)raZdist_dirZdist_clsZbase_dirZ
dist_dir_nameZ	dist_namer�r;r;r?r�ms
�zInstallRequirement.get_distcCsR|js
t�|jd}|jjr8||jjkr8t�d||�nt�dt|j�||�dS)N�versionz'Requested %s, but installing version %sz;Source in %s has version %s, which satisfies requirement %s)	rFrBr�rCr�r{r�r|r)rar�r;r;r?�assert_source_matches_version�s

��z0InstallRequirement.assert_source_matches_versioncCs|jdkr|�|�|_dS)aAEnsure that a source_dir is set.

        This will create a temporary build dir if the name of the requirement
        isn't known yet.

        :param parent_dir: The ideal pip parent_dir for the source_dir.
            Generally src_dir for editables and build_dir for sdists.
        :return: self.source_dir
        N)rFr�)raZ
parent_dirr;r;r?�ensure_has_source_dir�s
z(InstallRequirement.ensure_has_source_dirc
Cs�t�d|j�|r*d�|�g}t|�|}t|j||jd�}t��6|j	�$t
|ddgt|�|jd�W5QRXW5QRXd|_dS)NzRunning setup.py develop for %sz--prefix={})�global_options�no_user_configZdevelopz	--no-deps)�cwdT)
r{�inforrrn�listr&r�rZrr[r'r�rX)ra�install_optionsr�r�Zprefix_paramZbase_cmdr;r;r?�install_editable�s(����z#InstallRequirement.install_editablecCs�|jst�d|j�dS|js"t�|js,t�|jjdkr<dSd|jjksXtd|jj��|jj�dd�\}}t	�
|�}|r�t|jj�}|r�|j|j|d�q�|j
|j|d�nds�td|j|f��dS)	Nz>Cannot update repository at %s; repository location is unknown�file�+zbad url: %rr�)rMrz+Unexpected version control type (in %s): %s)rNr{r|rFrKrBZschemerMr�r,Zget_backendr"�obtainZexport)rar�Zvc_typerMZvcs_backendZ
hidden_urlr;r;r?�update_editable�s.�


��z"InstallRequirement.update_editablecCsB|�|�st�d|j�dS|jp&|j}t�|�}|�||�|S)a�
        Uninstall the distribution currently satisfying this requirement.

        Prompts before removing or modifying files unless
        ``auto_confirm`` is True.

        Refuses to delete or modify files outside of ``sys.prefix`` -
        thus uninstallation within a virtual environment can only
        modify that virtual environment, even if the virtualenv is
        linked to global site-packages.

        z#Skipping %s as it is not installed.N)	r�r{r�rrrTrUrZ	from_dist�remove)raZauto_confirm�verboser�ZdistZuninstalled_pathsetr;r;r?�	uninstall�s

zInstallRequirement.uninstallcCsJ|�|tjj�s"td||f��|t|�dd�}|�tjjd�}|S)Nz$name %r doesn't start with prefix %rr��/)�
startswithrGrHr�rBr��replace)rarrr�r;r;r?�_clean_zip_name�s
�z"InstallRequirement._clean_zip_namecCs(tj�||�}|�||�}|jd|S)Nr�)rGrHrvr�rr)rarH�	parentdir�rootdirrrr;r;r?�_get_archive_namesz$InstallRequirement._get_archive_namec	Cs�|js
t�d}d|j|jdf}tj�||�}tj�|�r�tdt	|�d�}|dkr\d}nj|dkr�t
�d	t	|��t�|�nF|d
kr�t
|�}t
�dt	|�t	|��t�||�n|dkr�t�d
�|s�dStj|dtjdd�}|��tj�tj�|j��}t�|�D]�\}	}
}d|
k�r&|
�d�|
D]6}|j||	|d�}
t�|
d�}d|_|�|d��q*|D]>}|tk�rx�qf|j||	|d�}tj�|	|�}|�||��qf�qW5QRXt
�dt	|��dS)z}Saves archive to provided build_dir.

        Used for saving downloaded VCS requirements as part of `pip download`.
        Tz	%s-%s.zipr�z8The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)bort )�i�w�b�ar�Fr�zDeleting %sr�zBacking up %s to %sr����N)Z
allowZip64zpip-egg-info)r�r�r�i�r�zSaved %s) rFrBrrr�rGrHrvr�rrr{r�r�rr�r�r��exit�zipfileZZipFileZZIP_DEFLATED�normcaserJr��walkr�ZZipInfoZ
external_attrZwritestrr�writer�)rar�Zcreate_archiveZarchive_nameZarchive_pathZresponseZ	dest_fileZ
zip_output�dir�dirpathZdirnames�	filenames�dirnameZdir_arcnameZzipdir�filenameZfile_arcnamer;r;r?�archivesz
���
��

�
�zInstallRequirement.archivec	sh|dk	r|ng}|jr*|j|||d�dS|jrnt�|j�}	t�|	|j�|j|j�|||||d�d|_	dSt
|�|j�dg�}t
|�|j�dg�}t
dd����}
tj�|
jd�}|�||�||�}td	�|j��}
t��*|j�|
|||jd
�W5QRXW5QRXtj�|��s8t�d|�W5QR�dSd|_	�fdd
�}t|��\}|D],}tj�|�}|�d��rX||�}�q��qXt�d|�W5QR�W5QR�dSW5QRXg}t|��L}|D]@}|��}tj�|��r�|tjj 7}|�!tj�"||�|���q�W5QRX|�#�t$|�tj�|d�}t|d��}|�%d�|�d�W5QRXW5QRXdS)N)r�)r�r�r�r�r�r�Tr�r��recordr�zinstall-record.txtzRunning setup.py install for {})�cmdr�zRecord file %s not foundcs&�dkstj�|�s|St�|�SdSr)rGrH�isabsr)rH�r�r;r?�prepend_root�sz0InstallRequirement.install.<locals>.prepend_rootr�z;Could not find .egg-info directory in install record for %szinstalled-files.txtr��
)&rKr�r�rZ
wheel_versionrFZcheck_compatibilityrrr�rXr�rYrzr)rGrHrv�get_install_argsr(rnrr[r�r�r{r|�openr�r�r��strip�isdirr�r�r��sortr r�)rar�r�r�r�r�r�r�r�r�Ztemp_dir�record_filename�install_argsr�r��f�lineZ	directoryZegg_info_dirZ	new_linesr�Zinst_files_pathr;r�r?�installEs������
��

�"
�zInstallRequirement.installc	Cs�t|j||jdd�}|dd|g7}|dg7}|dk	r@|d|g7}|dk	rT|d|g7}|rd|dg7}n
|d	g7}t�r�d
t��}|dtj�t	j
dd
||j�g7}|S)NT)r�r�Zunbuffered_outputr�z--recordz#--single-version-externally-managedz--rootz--prefixz	--compilez--no-compile�pythonz--install-headersZincludeZsite)r&r�rZr+�	sysconfigZget_python_versionrGrHrvr�r�rr)rar�r�r�r�r�r�Z
py_ver_strr;r;r?r��s0	�

��z#InstallRequirement.get_install_args)
NFNNNFNNFr;)N)T)NNNTFT)r;N)T)FFF)NNNNTFT)*rk�
__module__�__qualname__�__doc__rbrirmrxr~�propertyrrr�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r;r;r;r?r:Ms�
�
W









8
+
	�



%
�

�
	B�
`r:)eZ
__future__rr�ZloggingrGr�r�rr�Zdistutils.utilrZpip._vendorrrZ"pip._vendor.packaging.requirementsrZpip._vendor.packaging.utilsrZpip._vendor.packaging.versionrr	r�Zpip._vendor.pep517.wrappersr
Z
pip._internalrrZpip._internal.build_envr
Zpip._internal.exceptionsrZpip._internal.models.linkrZ*pip._internal.operations.generate_metadatarZpip._internal.pyprojectrrZpip._internal.req.req_uninstallrZpip._internal.utils.compatrZpip._internal.utils.hashesrZpip._internal.utils.loggingrZ pip._internal.utils.marker_filesrrZpip._internal.utils.miscrrrrrrrr r!r"r#r$Zpip._internal.utils.packagingr%Z$pip._internal.utils.setuptools_buildr&Zpip._internal.utils.subprocessr'r(Zpip._internal.utils.temp_dirr)Zpip._internal.utils.typingr*Zpip._internal.utils.virtualenvr+Zpip._internal.vcsr,�typingr-r.r/r0r1r2r3r4Zpip._internal.cacher5Zpip._internal.indexr6Zpip._vendor.pkg_resourcesr7Z pip._vendor.packaging.specifiersr8Zpip._vendor.packaging.markersr9Z	getLoggerrkr{�objectr:r;r;r;r?�<module>sV8$
site-packages/pip/_internal/req/__pycache__/req_file.cpython-38.opt-1.pyc000064400000022300151446176770022222 0ustar00U

��.e�7�
@s�dZddlmZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddl
mZddlmZddlmZdd	lmZdd
lmZmZddlmZe�r
ddlmZmZmZmZmZm Z m!Z!m"Z"dd
l#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ee"e+e!fZ,dgZ-e�.dej/�Z0e�.d�Z1e�.d�Z2ej3ej4ej5ej6ej7ej8ej9ej:ej;ej<ej=ej>ej?g
Z@ejAejBejCgZDdd�eDD�ZEd)dd�ZFdd�ZGd*dd�ZHdd�ZIdd �ZJd!d"�ZKd#d$�ZLd%d&�ZMd'd(�ZNdS)+z
Requirements file parsing
�)�absolute_importN)�filterfalse)�parse)�
cmdoptions)�get_file_content��RequirementsFileParseError)�SearchScope)�install_req_from_editable�install_req_from_line)�MYPY_CHECK_RUNNING)�Any�Callable�Iterator�List�NoReturn�Optional�Text�Tuple)�InstallRequirement)�
WheelCache)�
PackageFinder)�
PipSession�parse_requirementsz^(http|https|file):z(^|\s+)#.*$z#(?P<var>\$\{(?P<name>[A-Z0-9_]+)\})cCsg|]}t|�j��qS�)�str�dest)�.0�orr�>/usr/lib/python3.8/site-packages/pip/_internal/req/req_file.py�
<listcomp>Ksr Fc
csj|dkrtd��t|||d�\}}	t|	|�}
|
D]4\}}t||||||||||d�
}
|
D]
}|VqXq0dS)a1Parse a requirements file and yield InstallRequirement instances.

    :param filename:    Path or url of requirements file.
    :param finder:      Instance of pip.index.PackageFinder.
    :param comes_from:  Origin description of requirements.
    :param options:     cli options.
    :param session:     Instance of pip.download.PipSession.
    :param constraint:  If true, parsing a constraint file rather than
        requirements file.
    :param wheel_cache: Instance of pip.wheel.WheelCache
    :param use_pep517:  Value of the --use-pep517 option.
    NzCparse_requirements() missing 1 required keyword argument: 'session')�
comes_from�session)�
use_pep517�
constraint)�	TypeErrorr�
preprocess�process_line)�filename�finderr!�optionsr"r$�wheel_cacher#�_�content�
lines_enum�line_number�lineZreq_iter�reqrrrrNs*��


�cCs6t|��dd�}t|�}t|�}t||�}t|�}|S)z�Split, filter, and join lines, and return a line iterator

    :param content: the content of the requirements file
    :param options: cli options
    �)�start)�	enumerate�
splitlines�
join_lines�ignore_comments�
skip_regex�expand_env_variables)r-r*r.rrrr&ys
r&c
!
cs�t|�}
|
��}d|_|r"|j|_t|�\}}
tjdkrB|
�d�}
|
�t	�
|
�|�\}}d|	rbdnd||f}|r�|r||jnd}|r�t�
||�i}tD]&}||jkr�|j|r�|j|||<q�d�||�}t|||||||	|d	�V�n�|j�r |r�|jnd}t|jd
|||	||d�V�n�|j�s0|j�r�|j�rH|jd
}d}n|jd
}d}t�|��rpt�||�}n"t�|��s�tj�tj�|�|�}t|||||||d
�}|D]}|V�q�n�|j�r�|j|_n�|�r�|j }|j!}|j�r�|jg}|j"dk�rg}|j#�r|�$|j#�|j �rd|j d
}tj�tj�%|��}tj�||�}tj�&|��rZ|}|�'|�t(||d�}||_)|j*�r�|�+�|j,�p�gD] }d�||�} |j-|| d��q�dS)a#Process a single requirements line; This can result in creating/yielding
    requirements, or updating the finder.

    For lines that contain requirements, the only options that have an effect
    are from SUPPORTED_OPTIONS_REQ, and they are scoped to the
    requirement. Other options from SUPPORTED_OPTIONS may be present, but are
    ignored.

    For lines that do not contain requirements, the only options that have an
    effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may
    be present, but are ignored. These lines may contain multiple options
    (although our docs imply only one is supported), and all our parsed and
    affect the finder.

    :param constraint: If True, parsing a constraints file.
    :param options: OptionParser options that we may update
    N)����utf8z%s %s (line %s)z-cz-rFz
line {} of {})r!r#�isolatedr*r+r$�line_sourcer)r!r#r$r>r+T)r$r+)�
find_links�
index_urls)�source).�build_parserZget_default_values�	index_urlZformat_control�break_args_options�sys�version_info�encode�
parse_args�shlex�splitZ
isolated_moderZcheck_install_build_global�SUPPORTED_OPTIONS_REQ_DEST�__dict__�formatrZ	editablesr
�requirements�constraints�	SCHEME_RE�search�urllib_parseZurljoin�os�path�join�dirnamer�require_hashesr@rA�no_indexZextra_index_urls�extend�abspath�exists�appendr	�search_scope�preZset_allow_all_prereleasesZ
trusted_hostsZadd_trusted_host)!r0r(r/r)r!r*r"r+r#r$�parser�defaultsZargs_strZoptions_strZoptsr,Zline_comes_fromr>Zreq_optionsrr?Zreq_pathZnested_constraintZparsed_reqsr1r@rA�valueZreq_dirZrelative_to_reqs_filer^ZhostrBrrrr'�s�

�
���

�


�r'cCsf|�d�}g}|dd�}|D]2}|�d�s6|�d�r<qRq|�|�|�d�qd�|�d�|�fS)z�Break up the line into an args and options string.  We only want to shlex
    (and then optparse) the options, not the args.  args can contain markers
    which are corrupted by shlex.
    � N�-z--r)rK�
startswithr]�poprV)r0�tokens�argsr*�tokenrrrrEs

rEcsDtjdd�}tt}|D]}|�}|�|�q�fdd�}||_|S)z7
    Return a parser for parsing requirement lines
    F)Zadd_help_optioncsd�|f}t|��dS)NzInvalid requirement: %s
%sr)�self�msg�r0rr�parser_exit6sz!build_parser.<locals>.parser_exit)�optparseZOptionParser�SUPPORTED_OPTIONS�SUPPORTED_OPTIONS_REQZ
add_option�exit)r0r`Zoption_factoriesZoption_factoryZoptionrmrrlrrC(srCccs�d}g}|D]v\}}|�d�r(t�|�rjt�|�r:d|}|r^|�|�|d�|�fVg}q�||fVq|sr|}|�|�d��q|r�|d�|�fVdS)z�Joins a line ending in '' with the previous line (except when following
    comments).  The joined line takes on the index of the first line.
    N�\rc�)�endswith�
COMMENT_RE�matchr]rV�strip)r.Zprimary_line_numberZnew_liner/r0rrrr6Bs 

r6ccs4|D]*\}}t�d|�}|��}|r||fVqdS)z1
    Strips comments and filter empty lines.
    rsN)ru�subrw)r.r/r0rrrr7`s
r7cs2|r
|jnd}|r.t�|��t�fdd�|�}|S)zs
    Skip lines that match '--skip-requirements-regex' pattern

    Note: the regex pattern is only built once
    Ncs��|d�S)Nr2)rR)�e��patternrr�<lambda>v�zskip_regex.<locals>.<lambda>)Zskip_requirements_regex�re�compiler)r.r*r8rrzrr8ls

r8ccsL|D]B\}}t�|�D]$\}}t�|�}|s.q|�||�}q||fVqdS)a�Replace all environment variables that can be retrieved via `os.getenv`.

    The only allowed format for environment variables defined in the
    requirement file is `${MY_VARIABLE_1}` to ensure two things:

    1. Strings that contain a `$` aren't accidentally (partially) expanded.
    2. Ensure consistency across platforms for requirement files.

    These points are the result of a discussion on the `github pull
    request #3514 <https://github.com/pypa/pip/pull/3514>`_.

    Valid characters in variable names follow the `POSIX standard
    <http://pubs.opengroup.org/onlinepubs/9699919799/>`_ and are limited
    to uppercase letter, digits and the `_` (underscore).
    N)�
ENV_VAR_RE�findallrT�getenv�replace)r.r/r0Zenv_varZvar_namerbrrrr9zs
r9)NNNNFNN)NNNNNNF)O�__doc__Z
__future__rrnrTr~rJrFZpip._vendor.six.movesrZpip._vendor.six.moves.urllibrrSZpip._internal.clirZpip._internal.downloadrZpip._internal.exceptionsrZ!pip._internal.models.search_scoper	Zpip._internal.req.constructorsr
rZpip._internal.utils.typingr�typingr
rrrrrrrZpip._internal.reqrZpip._internal.cacherZpip._internal.indexrZpip._internal.network.sessionr�intZReqFileLines�__all__r�IrQrur�rPZeditablerOrYrDr@Zextra_index_urlZalways_unzipZ	no_binaryZonly_binaryr_Ztrusted_hostrXroZinstall_optionsZglobal_options�hashrprLrr&r'rErCr6r7r8r9rrrr�<module>s�(

���
+�
site-packages/pip/_internal/req/__pycache__/req_file.cpython-38.pyc000064400000022300151446176770021263 0ustar00U

��.e�7�
@s�dZddlmZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddl
mZddlmZddlmZdd	lmZdd
lmZmZddlmZe�r
ddlmZmZmZmZmZm Z m!Z!m"Z"dd
l#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*ee"e+e!fZ,dgZ-e�.dej/�Z0e�.d�Z1e�.d�Z2ej3ej4ej5ej6ej7ej8ej9ej:ej;ej<ej=ej>ej?g
Z@ejAejBejCgZDdd�eDD�ZEd)dd�ZFdd�ZGd*dd�ZHdd�ZIdd �ZJd!d"�ZKd#d$�ZLd%d&�ZMd'd(�ZNdS)+z
Requirements file parsing
�)�absolute_importN)�filterfalse)�parse)�
cmdoptions)�get_file_content��RequirementsFileParseError)�SearchScope)�install_req_from_editable�install_req_from_line)�MYPY_CHECK_RUNNING)�Any�Callable�Iterator�List�NoReturn�Optional�Text�Tuple)�InstallRequirement)�
WheelCache)�
PackageFinder)�
PipSession�parse_requirementsz^(http|https|file):z(^|\s+)#.*$z#(?P<var>\$\{(?P<name>[A-Z0-9_]+)\})cCsg|]}t|�j��qS�)�str�dest)�.0�orr�>/usr/lib/python3.8/site-packages/pip/_internal/req/req_file.py�
<listcomp>Ksr Fc
csj|dkrtd��t|||d�\}}	t|	|�}
|
D]4\}}t||||||||||d�
}
|
D]
}|VqXq0dS)a1Parse a requirements file and yield InstallRequirement instances.

    :param filename:    Path or url of requirements file.
    :param finder:      Instance of pip.index.PackageFinder.
    :param comes_from:  Origin description of requirements.
    :param options:     cli options.
    :param session:     Instance of pip.download.PipSession.
    :param constraint:  If true, parsing a constraint file rather than
        requirements file.
    :param wheel_cache: Instance of pip.wheel.WheelCache
    :param use_pep517:  Value of the --use-pep517 option.
    NzCparse_requirements() missing 1 required keyword argument: 'session')�
comes_from�session)�
use_pep517�
constraint)�	TypeErrorr�
preprocess�process_line)�filename�finderr!�optionsr"r$�wheel_cacher#�_�content�
lines_enum�line_number�lineZreq_iter�reqrrrrNs*��


�cCs6t|��dd�}t|�}t|�}t||�}t|�}|S)z�Split, filter, and join lines, and return a line iterator

    :param content: the content of the requirements file
    :param options: cli options
    �)�start)�	enumerate�
splitlines�
join_lines�ignore_comments�
skip_regex�expand_env_variables)r-r*r.rrrr&ys
r&c
!
cs�t|�}
|
��}d|_|r"|j|_t|�\}}
tjdkrB|
�d�}
|
�t	�
|
�|�\}}d|	rbdnd||f}|r�|r||jnd}|r�t�
||�i}tD]&}||jkr�|j|r�|j|||<q�d�||�}t|||||||	|d	�V�n�|j�r |r�|jnd}t|jd
|||	||d�V�n�|j�s0|j�r�|j�rH|jd
}d}n|jd
}d}t�|��rpt�||�}n"t�|��s�tj�tj�|�|�}t|||||||d
�}|D]}|V�q�n�|j�r�|j|_n�|�r�|j }|j!}|j�r�|jg}|j"dk�rg}|j#�r|�$|j#�|j �rd|j d
}tj�tj�%|��}tj�||�}tj�&|��rZ|}|�'|�t(||d�}||_)|j*�r�|�+�|j,�p�gD] }d�||�} |j-|| d��q�dS)a#Process a single requirements line; This can result in creating/yielding
    requirements, or updating the finder.

    For lines that contain requirements, the only options that have an effect
    are from SUPPORTED_OPTIONS_REQ, and they are scoped to the
    requirement. Other options from SUPPORTED_OPTIONS may be present, but are
    ignored.

    For lines that do not contain requirements, the only options that have an
    effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may
    be present, but are ignored. These lines may contain multiple options
    (although our docs imply only one is supported), and all our parsed and
    affect the finder.

    :param constraint: If True, parsing a constraints file.
    :param options: OptionParser options that we may update
    N)����utf8z%s %s (line %s)z-cz-rFz
line {} of {})r!r#�isolatedr*r+r$�line_sourcer)r!r#r$r>r+T)r$r+)�
find_links�
index_urls)�source).�build_parserZget_default_values�	index_urlZformat_control�break_args_options�sys�version_info�encode�
parse_args�shlex�splitZ
isolated_moderZcheck_install_build_global�SUPPORTED_OPTIONS_REQ_DEST�__dict__�formatrZ	editablesr
�requirements�constraints�	SCHEME_RE�search�urllib_parseZurljoin�os�path�join�dirnamer�require_hashesr@rA�no_indexZextra_index_urls�extend�abspath�exists�appendr	�search_scope�preZset_allow_all_prereleasesZ
trusted_hostsZadd_trusted_host)!r0r(r/r)r!r*r"r+r#r$�parser�defaultsZargs_strZoptions_strZoptsr,Zline_comes_fromr>Zreq_optionsrr?Zreq_pathZnested_constraintZparsed_reqsr1r@rA�valueZreq_dirZrelative_to_reqs_filer^ZhostrBrrrr'�s�

�
���

�


�r'cCsf|�d�}g}|dd�}|D]2}|�d�s6|�d�r<qRq|�|�|�d�qd�|�d�|�fS)z�Break up the line into an args and options string.  We only want to shlex
    (and then optparse) the options, not the args.  args can contain markers
    which are corrupted by shlex.
    � N�-z--r)rK�
startswithr]�poprV)r0�tokens�argsr*�tokenrrrrEs

rEcsDtjdd�}tt}|D]}|�}|�|�q�fdd�}||_|S)z7
    Return a parser for parsing requirement lines
    F)Zadd_help_optioncsd�|f}t|��dS)NzInvalid requirement: %s
%sr)�self�msg�r0rr�parser_exit6sz!build_parser.<locals>.parser_exit)�optparseZOptionParser�SUPPORTED_OPTIONS�SUPPORTED_OPTIONS_REQZ
add_option�exit)r0r`Zoption_factoriesZoption_factoryZoptionrmrrlrrC(srCccs�d}g}|D]v\}}|�d�r(t�|�rjt�|�r:d|}|r^|�|�|d�|�fVg}q�||fVq|sr|}|�|�d��q|r�|d�|�fVdS)z�Joins a line ending in '' with the previous line (except when following
    comments).  The joined line takes on the index of the first line.
    N�\rc�)�endswith�
COMMENT_RE�matchr]rV�strip)r.Zprimary_line_numberZnew_liner/r0rrrr6Bs 

r6ccs4|D]*\}}t�d|�}|��}|r||fVqdS)z1
    Strips comments and filter empty lines.
    rsN)ru�subrw)r.r/r0rrrr7`s
r7cs2|r
|jnd}|r.t�|��t�fdd�|�}|S)zs
    Skip lines that match '--skip-requirements-regex' pattern

    Note: the regex pattern is only built once
    Ncs��|d�S)Nr2)rR)�e��patternrr�<lambda>v�zskip_regex.<locals>.<lambda>)Zskip_requirements_regex�re�compiler)r.r*r8rrzrr8ls

r8ccsL|D]B\}}t�|�D]$\}}t�|�}|s.q|�||�}q||fVqdS)a�Replace all environment variables that can be retrieved via `os.getenv`.

    The only allowed format for environment variables defined in the
    requirement file is `${MY_VARIABLE_1}` to ensure two things:

    1. Strings that contain a `$` aren't accidentally (partially) expanded.
    2. Ensure consistency across platforms for requirement files.

    These points are the result of a discussion on the `github pull
    request #3514 <https://github.com/pypa/pip/pull/3514>`_.

    Valid characters in variable names follow the `POSIX standard
    <http://pubs.opengroup.org/onlinepubs/9699919799/>`_ and are limited
    to uppercase letter, digits and the `_` (underscore).
    N)�
ENV_VAR_RE�findallrT�getenv�replace)r.r/r0Zenv_varZvar_namerbrrrr9zs
r9)NNNNFNN)NNNNNNF)O�__doc__Z
__future__rrnrTr~rJrFZpip._vendor.six.movesrZpip._vendor.six.moves.urllibrrSZpip._internal.clirZpip._internal.downloadrZpip._internal.exceptionsrZ!pip._internal.models.search_scoper	Zpip._internal.req.constructorsr
rZpip._internal.utils.typingr�typingr
rrrrrrrZpip._internal.reqrZpip._internal.cacherZpip._internal.indexrZpip._internal.network.sessionr�intZReqFileLines�__all__r�IrQrur�rPZeditablerOrYrDr@Zextra_index_urlZalways_unzipZ	no_binaryZonly_binaryr_Ztrusted_hostrXroZinstall_optionsZglobal_options�hashrprLrr&r'rErCr6r7r8r9rrrr�<module>s�(

���
+�
site-packages/pip/_internal/req/__pycache__/__init__.cpython-38.pyc000064400000003244151446176770021242 0ustar00U

��.e�	�@s�ddlmZddlZddlmZddlmZddlmZddl	m
Z
ddlmZerhdd	l
mZmZmZd
ddd
gZe�e�Zddd
�ZdS)�)�absolute_importN)�
indent_log)�MYPY_CHECK_RUNNING�)�parse_requirements)�InstallRequirement)�RequirementSet)�Any�List�Sequencerrr�install_given_reqs�c	Os�|r t�dd�dd�|D���t���|D]�}|jrbt�d|j�t��|jdd�}W5QRXz|j||f|�|�Wn0tk
r�|jo�|j}|r�|�	��YnX|jo�|j}|r�|�
�|��q,W5QRX|S)zu
    Install everything in the given list.

    (to be called after having downloaded and unpacked the packages)
    z!Installing collected packages: %sz, cSsg|]
}|j�qSr
)�name)�.0Zreqr
r
�>/usr/lib/python3.8/site-packages/pip/_internal/req/__init__.py�
<listcomp>+sz&install_given_reqs.<locals>.<listcomp>zFound existing installation: %sT)Zauto_confirm)�logger�info�joinrZconflicts_withZ	uninstallZinstall�	ExceptionZinstall_succeededZrollbackZcommitZremove_temporary_source)	Z
to_installZinstall_optionsZglobal_options�args�kwargsZrequirementZuninstalled_pathsetZshould_rollbackZ
should_commitr
r
rrsN��������)r
)Z
__future__rZloggingZpip._internal.utils.loggingrZpip._internal.utils.typingrZreq_filerZreq_installrZreq_setr�typingr	r
r�__all__Z	getLogger�__name__rrr
r
r
r�<module>s �
�site-packages/pip/_internal/req/req_tracker.py000064400000006173151446176770015523 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

from __future__ import absolute_import

import contextlib
import errno
import hashlib
import logging
import os

from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from types import TracebackType
    from typing import Iterator, Optional, Set, Type
    from pip._internal.req.req_install import InstallRequirement
    from pip._internal.models.link import Link

logger = logging.getLogger(__name__)


class RequirementTracker(object):

    def __init__(self):
        # type: () -> None
        self._root = os.environ.get('PIP_REQ_TRACKER')
        if self._root is None:
            self._temp_dir = TempDirectory(delete=False, kind='req-tracker')
            self._root = os.environ['PIP_REQ_TRACKER'] = self._temp_dir.path
            logger.debug('Created requirements tracker %r', self._root)
        else:
            self._temp_dir = None
            logger.debug('Re-using requirements tracker %r', self._root)
        self._entries = set()  # type: Set[InstallRequirement]

    def __enter__(self):
        # type: () -> RequirementTracker
        return self

    def __exit__(
        self,
        exc_type,  # type: Optional[Type[BaseException]]
        exc_val,  # type: Optional[BaseException]
        exc_tb  # type: Optional[TracebackType]
    ):
        # type: (...) -> None
        self.cleanup()

    def _entry_path(self, link):
        # type: (Link) -> str
        hashed = hashlib.sha224(link.url_without_fragment.encode()).hexdigest()
        return os.path.join(self._root, hashed)

    def add(self, req):
        # type: (InstallRequirement) -> None
        link = req.link
        info = str(req)
        entry_path = self._entry_path(link)
        try:
            with open(entry_path) as fp:
                # Error, these's already a build in progress.
                raise LookupError('%s is already being built: %s'
                                  % (link, fp.read()))
        except IOError as e:
            if e.errno != errno.ENOENT:
                raise
            assert req not in self._entries
            with open(entry_path, 'w') as fp:
                fp.write(info)
            self._entries.add(req)
            logger.debug('Added %s to build tracker %r', req, self._root)

    def remove(self, req):
        # type: (InstallRequirement) -> None
        link = req.link
        self._entries.remove(req)
        os.unlink(self._entry_path(link))
        logger.debug('Removed %s from build tracker %r', req, self._root)

    def cleanup(self):
        # type: () -> None
        for req in set(self._entries):
            self.remove(req)
        remove = self._temp_dir is not None
        if remove:
            self._temp_dir.cleanup()
        logger.debug('%s build tracker %r',
                     'Removed' if remove else 'Cleaned',
                     self._root)

    @contextlib.contextmanager
    def track(self, req):
        # type: (InstallRequirement) -> Iterator[None]
        self.add(req)
        yield
        self.remove(req)
site-packages/pip/_internal/req/__init__.py000064400000004643151446176770014760 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

from __future__ import absolute_import

import logging

from pip._internal.utils.logging import indent_log
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

from .req_file import parse_requirements
from .req_install import InstallRequirement
from .req_set import RequirementSet

if MYPY_CHECK_RUNNING:
    from typing import Any, List, Sequence

__all__ = [
    "RequirementSet", "InstallRequirement",
    "parse_requirements", "install_given_reqs",
]

logger = logging.getLogger(__name__)


def install_given_reqs(
    to_install,  # type: List[InstallRequirement]
    install_options,  # type: List[str]
    global_options=(),  # type: Sequence[str]
    *args,  # type: Any
    **kwargs  # type: Any
):
    # type: (...) -> List[InstallRequirement]
    """
    Install everything in the given list.

    (to be called after having downloaded and unpacked the packages)
    """

    if to_install:
        logger.info(
            'Installing collected packages: %s',
            ', '.join([req.name for req in to_install]),
        )

    with indent_log():
        for requirement in to_install:
            if requirement.conflicts_with:
                logger.info(
                    'Found existing installation: %s',
                    requirement.conflicts_with,
                )
                with indent_log():
                    uninstalled_pathset = requirement.uninstall(
                        auto_confirm=True
                    )
            try:
                requirement.install(
                    install_options,
                    global_options,
                    *args,
                    **kwargs
                )
            except Exception:
                should_rollback = (
                    requirement.conflicts_with and
                    not requirement.install_succeeded
                )
                # if install did not succeed, rollback previous uninstall
                if should_rollback:
                    uninstalled_pathset.rollback()
                raise
            else:
                should_commit = (
                    requirement.conflicts_with and
                    requirement.install_succeeded
                )
                if should_commit:
                    uninstalled_pathset.commit()
            requirement.remove_temporary_source()

    return to_install
site-packages/pip/_internal/req/constructors.py000064400000034064151446176770015771 0ustar00"""Backing implementation for InstallRequirement's various constructors

The idea here is that these formed a major chunk of InstallRequirement's size
so, moving them and support code dedicated to them outside of that class
helps creates for better understandability for the rest of the code.

These are meant to be used elsewhere within pip to create instances of
InstallRequirement.
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

import logging
import os
import re

from pip._vendor.packaging.markers import Marker
from pip._vendor.packaging.requirements import InvalidRequirement, Requirement
from pip._vendor.packaging.specifiers import Specifier
from pip._vendor.pkg_resources import RequirementParseError, parse_requirements

from pip._internal.exceptions import InstallationError
from pip._internal.models.index import PyPI, TestPyPI
from pip._internal.models.link import Link
from pip._internal.pyproject import make_pyproject_path
from pip._internal.req.req_install import InstallRequirement
from pip._internal.utils.filetypes import ARCHIVE_EXTENSIONS
from pip._internal.utils.misc import is_installable_dir, splitext
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import path_to_url
from pip._internal.vcs import is_url, vcs
from pip._internal.wheel import Wheel

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, Dict, Optional, Set, Tuple, Union,
    )
    from pip._internal.cache import WheelCache


__all__ = [
    "install_req_from_editable", "install_req_from_line",
    "parse_editable"
]

logger = logging.getLogger(__name__)
operators = Specifier._operators.keys()


def is_archive_file(name):
    # type: (str) -> bool
    """Return True if `name` is a considered as an archive file."""
    ext = splitext(name)[1].lower()
    if ext in ARCHIVE_EXTENSIONS:
        return True
    return False


def _strip_extras(path):
    # type: (str) -> Tuple[str, Optional[str]]
    m = re.match(r'^(.+)(\[[^\]]+\])$', path)
    extras = None
    if m:
        path_no_extras = m.group(1)
        extras = m.group(2)
    else:
        path_no_extras = path

    return path_no_extras, extras


def convert_extras(extras):
    # type: (Optional[str]) -> Set[str]
    if not extras:
        return set()
    return Requirement("placeholder" + extras.lower()).extras


def parse_editable(editable_req):
    # type: (str) -> Tuple[Optional[str], str, Optional[Set[str]]]
    """Parses an editable requirement into:
        - a requirement name
        - an URL
        - extras
        - editable options
    Accepted requirements:
        svn+http://blahblah@rev#egg=Foobar[baz]&subdirectory=version_subdir
        .[some_extra]
    """

    url = editable_req

    # If a file path is specified with extras, strip off the extras.
    url_no_extras, extras = _strip_extras(url)

    if os.path.isdir(url_no_extras):
        if not os.path.exists(os.path.join(url_no_extras, 'setup.py')):
            msg = (
                'File "setup.py" not found. Directory cannot be installed '
                'in editable mode: {}'.format(os.path.abspath(url_no_extras))
            )
            pyproject_path = make_pyproject_path(url_no_extras)
            if os.path.isfile(pyproject_path):
                msg += (
                    '\n(A "pyproject.toml" file was found, but editable '
                    'mode currently requires a setup.py based build.)'
                )
            raise InstallationError(msg)

        # Treating it as code that has already been checked out
        url_no_extras = path_to_url(url_no_extras)

    if url_no_extras.lower().startswith('file:'):
        package_name = Link(url_no_extras).egg_fragment
        if extras:
            return (
                package_name,
                url_no_extras,
                Requirement("placeholder" + extras.lower()).extras,
            )
        else:
            return package_name, url_no_extras, None

    for version_control in vcs:
        if url.lower().startswith('%s:' % version_control):
            url = '%s+%s' % (version_control, url)
            break

    if '+' not in url:
        raise InstallationError(
            '{} is not a valid editable requirement. '
            'It should either be a path to a local project or a VCS URL '
            '(beginning with svn+, git+, hg+, or bzr+).'.format(editable_req)
        )

    vc_type = url.split('+', 1)[0].lower()

    if not vcs.get_backend(vc_type):
        error_message = 'For --editable=%s only ' % editable_req + \
            ', '.join([backend.name + '+URL' for backend in vcs.backends]) + \
            ' is currently supported'
        raise InstallationError(error_message)

    package_name = Link(url).egg_fragment
    if not package_name:
        raise InstallationError(
            "Could not detect requirement name for '%s', please specify one "
            "with #egg=your_package_name" % editable_req
        )
    return package_name, url, None


def deduce_helpful_msg(req):
    # type: (str) -> str
    """Returns helpful msg in case requirements file does not exist,
    or cannot be parsed.

    :params req: Requirements file path
    """
    msg = ""
    if os.path.exists(req):
        msg = " It does exist."
        # Try to parse and check if it is a requirements file.
        try:
            with open(req, 'r') as fp:
                # parse first line only
                next(parse_requirements(fp.read()))
                msg += " The argument you provided " + \
                    "(%s) appears to be a" % (req) + \
                    " requirements file. If that is the" + \
                    " case, use the '-r' flag to install" + \
                    " the packages specified within it."
        except RequirementParseError:
            logger.debug("Cannot parse '%s' as requirements \
            file" % (req), exc_info=True)
    else:
        msg += " File '%s' does not exist." % (req)
    return msg


class RequirementParts(object):
    def __init__(
            self,
            requirement,  # type: Optional[Requirement]
            link,         # type: Optional[Link]
            markers,      # type: Optional[Marker]
            extras,       # type: Set[str]
    ):
        self.requirement = requirement
        self.link = link
        self.markers = markers
        self.extras = extras


def parse_req_from_editable(editable_req):
    # type: (str) -> RequirementParts
    name, url, extras_override = parse_editable(editable_req)

    if name is not None:
        try:
            req = Requirement(name)
        except InvalidRequirement:
            raise InstallationError("Invalid requirement: '%s'" % name)
    else:
        req = None

    link = Link(url)

    return RequirementParts(req, link, None, extras_override)


# ---- The actual constructors follow ----


def install_req_from_editable(
    editable_req,  # type: str
    comes_from=None,  # type: Optional[str]
    use_pep517=None,  # type: Optional[bool]
    isolated=False,  # type: bool
    options=None,  # type: Optional[Dict[str, Any]]
    wheel_cache=None,  # type: Optional[WheelCache]
    constraint=False  # type: bool
):
    # type: (...) -> InstallRequirement

    parts = parse_req_from_editable(editable_req)

    source_dir = parts.link.file_path if parts.link.scheme == 'file' else None

    return InstallRequirement(
        parts.requirement, comes_from, source_dir=source_dir,
        editable=True,
        link=parts.link,
        constraint=constraint,
        use_pep517=use_pep517,
        isolated=isolated,
        options=options if options else {},
        wheel_cache=wheel_cache,
        extras=parts.extras,
    )


def _looks_like_path(name):
    # type: (str) -> bool
    """Checks whether the string "looks like" a path on the filesystem.

    This does not check whether the target actually exists, only judge from the
    appearance.

    Returns true if any of the following conditions is true:
    * a path separator is found (either os.path.sep or os.path.altsep);
    * a dot is found (which represents the current directory).
    """
    if os.path.sep in name:
        return True
    if os.path.altsep is not None and os.path.altsep in name:
        return True
    if name.startswith("."):
        return True
    return False


def _get_url_from_path(path, name):
    # type: (str, str) -> str
    """
    First, it checks whether a provided path is an installable directory
    (e.g. it has a setup.py). If it is, returns the path.

    If false, check if the path is an archive file (such as a .whl).
    The function checks if the path is a file. If false, if the path has
    an @, it will treat it as a PEP 440 URL requirement and return the path.
    """
    if _looks_like_path(name) and os.path.isdir(path):
        if is_installable_dir(path):
            return path_to_url(path)
        raise InstallationError(
            "Directory %r is not installable. Neither 'setup.py' "
            "nor 'pyproject.toml' found." % name
        )
    if not is_archive_file(path):
        return None
    if os.path.isfile(path):
        return path_to_url(path)
    urlreq_parts = name.split('@', 1)
    if len(urlreq_parts) >= 2 and not _looks_like_path(urlreq_parts[0]):
        # If the path contains '@' and the part before it does not look
        # like a path, try to treat it as a PEP 440 URL req instead.
        return None
    logger.warning(
        'Requirement %r looks like a filename, but the '
        'file does not exist',
        name
    )
    return path_to_url(path)


def parse_req_from_line(name, line_source):
    # type: (str, Optional[str]) -> RequirementParts
    if is_url(name):
        marker_sep = '; '
    else:
        marker_sep = ';'
    if marker_sep in name:
        name, markers_as_string = name.split(marker_sep, 1)
        markers_as_string = markers_as_string.strip()
        if not markers_as_string:
            markers = None
        else:
            markers = Marker(markers_as_string)
    else:
        markers = None
    name = name.strip()
    req_as_string = None
    path = os.path.normpath(os.path.abspath(name))
    link = None
    extras_as_string = None

    if is_url(name):
        link = Link(name)
    else:
        p, extras_as_string = _strip_extras(path)
        url = _get_url_from_path(p, name)
        if url is not None:
            link = Link(url)

    # it's a local file, dir, or url
    if link:
        # Handle relative file URLs
        if link.scheme == 'file' and re.search(r'\.\./', link.url):
            link = Link(
                path_to_url(os.path.normpath(os.path.abspath(link.path))))
        # wheel file
        if link.is_wheel:
            wheel = Wheel(link.filename)  # can raise InvalidWheelFilename
            req_as_string = "%s==%s" % (wheel.name, wheel.version)
        else:
            # set the req to the egg fragment.  when it's not there, this
            # will become an 'unnamed' requirement
            req_as_string = link.egg_fragment

    # a requirement specifier
    else:
        req_as_string = name

    extras = convert_extras(extras_as_string)

    def with_source(text):
        if not line_source:
            return text
        return '{} (from {})'.format(text, line_source)

    if req_as_string is not None:
        try:
            req = Requirement(req_as_string)
        except InvalidRequirement:
            if os.path.sep in req_as_string:
                add_msg = "It looks like a path."
                add_msg += deduce_helpful_msg(req_as_string)
            elif ('=' in req_as_string and
                  not any(op in req_as_string for op in operators)):
                add_msg = "= is not a valid operator. Did you mean == ?"
            else:
                add_msg = ''
            msg = with_source(
                'Invalid requirement: {!r}'.format(req_as_string)
            )
            if add_msg:
                msg += '\nHint: {}'.format(add_msg)
            raise InstallationError(msg)
    else:
        req = None

    return RequirementParts(req, link, markers, extras)


def install_req_from_line(
    name,  # type: str
    comes_from=None,  # type: Optional[Union[str, InstallRequirement]]
    use_pep517=None,  # type: Optional[bool]
    isolated=False,  # type: bool
    options=None,  # type: Optional[Dict[str, Any]]
    wheel_cache=None,  # type: Optional[WheelCache]
    constraint=False,  # type: bool
    line_source=None,  # type: Optional[str]
):
    # type: (...) -> InstallRequirement
    """Creates an InstallRequirement from a name, which might be a
    requirement, directory containing 'setup.py', filename, or URL.

    :param line_source: An optional string describing where the line is from,
        for logging purposes in case of an error.
    """
    parts = parse_req_from_line(name, line_source)

    return InstallRequirement(
        parts.requirement, comes_from, link=parts.link, markers=parts.markers,
        use_pep517=use_pep517, isolated=isolated,
        options=options if options else {},
        wheel_cache=wheel_cache,
        constraint=constraint,
        extras=parts.extras,
    )


def install_req_from_req_string(
    req_string,  # type: str
    comes_from=None,  # type: Optional[InstallRequirement]
    isolated=False,  # type: bool
    wheel_cache=None,  # type: Optional[WheelCache]
    use_pep517=None  # type: Optional[bool]
):
    # type: (...) -> InstallRequirement
    try:
        req = Requirement(req_string)
    except InvalidRequirement:
        raise InstallationError("Invalid requirement: '%s'" % req_string)

    domains_not_allowed = [
        PyPI.file_storage_domain,
        TestPyPI.file_storage_domain,
    ]
    if (req.url and comes_from and comes_from.link and
            comes_from.link.netloc in domains_not_allowed):
        # Explicitly disallow pypi packages that depend on external urls
        raise InstallationError(
            "Packages installed from PyPI cannot depend on packages "
            "which are not also hosted on PyPI.\n"
            "%s depends on %s " % (comes_from.name, req)
        )

    return InstallRequirement(
        req, comes_from, isolated=isolated, wheel_cache=wheel_cache,
        use_pep517=use_pep517
    )
site-packages/pip/_internal/req/req_file.py000064400000033726151446176770015013 0ustar00"""
Requirements file parsing
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

from __future__ import absolute_import

import optparse
import os
import re
import shlex
import sys

from pip._vendor.six.moves import filterfalse
from pip._vendor.six.moves.urllib import parse as urllib_parse

from pip._internal.cli import cmdoptions
from pip._internal.download import get_file_content
from pip._internal.exceptions import RequirementsFileParseError
from pip._internal.models.search_scope import SearchScope
from pip._internal.req.constructors import (
    install_req_from_editable,
    install_req_from_line,
)
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, Callable, Iterator, List, NoReturn, Optional, Text, Tuple,
    )
    from pip._internal.req import InstallRequirement
    from pip._internal.cache import WheelCache
    from pip._internal.index import PackageFinder
    from pip._internal.network.session import PipSession

    ReqFileLines = Iterator[Tuple[int, Text]]

__all__ = ['parse_requirements']

SCHEME_RE = re.compile(r'^(http|https|file):', re.I)
COMMENT_RE = re.compile(r'(^|\s+)#.*$')

# Matches environment variable-style values in '${MY_VARIABLE_1}' with the
# variable name consisting of only uppercase letters, digits or the '_'
# (underscore). This follows the POSIX standard defined in IEEE Std 1003.1,
# 2013 Edition.
ENV_VAR_RE = re.compile(r'(?P<var>\$\{(?P<name>[A-Z0-9_]+)\})')

SUPPORTED_OPTIONS = [
    cmdoptions.constraints,
    cmdoptions.editable,
    cmdoptions.requirements,
    cmdoptions.no_index,
    cmdoptions.index_url,
    cmdoptions.find_links,
    cmdoptions.extra_index_url,
    cmdoptions.always_unzip,
    cmdoptions.no_binary,
    cmdoptions.only_binary,
    cmdoptions.pre,
    cmdoptions.trusted_host,
    cmdoptions.require_hashes,
]  # type: List[Callable[..., optparse.Option]]

# options to be passed to requirements
SUPPORTED_OPTIONS_REQ = [
    cmdoptions.install_options,
    cmdoptions.global_options,
    cmdoptions.hash,
]  # type: List[Callable[..., optparse.Option]]

# the 'dest' string values
SUPPORTED_OPTIONS_REQ_DEST = [str(o().dest) for o in SUPPORTED_OPTIONS_REQ]


def parse_requirements(
    filename,  # type: str
    finder=None,  # type: Optional[PackageFinder]
    comes_from=None,  # type: Optional[str]
    options=None,  # type: Optional[optparse.Values]
    session=None,  # type: Optional[PipSession]
    constraint=False,  # type: bool
    wheel_cache=None,  # type: Optional[WheelCache]
    use_pep517=None  # type: Optional[bool]
):
    # type: (...) -> Iterator[InstallRequirement]
    """Parse a requirements file and yield InstallRequirement instances.

    :param filename:    Path or url of requirements file.
    :param finder:      Instance of pip.index.PackageFinder.
    :param comes_from:  Origin description of requirements.
    :param options:     cli options.
    :param session:     Instance of pip.download.PipSession.
    :param constraint:  If true, parsing a constraint file rather than
        requirements file.
    :param wheel_cache: Instance of pip.wheel.WheelCache
    :param use_pep517:  Value of the --use-pep517 option.
    """
    if session is None:
        raise TypeError(
            "parse_requirements() missing 1 required keyword argument: "
            "'session'"
        )

    _, content = get_file_content(
        filename, comes_from=comes_from, session=session
    )

    lines_enum = preprocess(content, options)

    for line_number, line in lines_enum:
        req_iter = process_line(line, filename, line_number, finder,
                                comes_from, options, session, wheel_cache,
                                use_pep517=use_pep517, constraint=constraint)
        for req in req_iter:
            yield req


def preprocess(content, options):
    # type: (Text, Optional[optparse.Values]) -> ReqFileLines
    """Split, filter, and join lines, and return a line iterator

    :param content: the content of the requirements file
    :param options: cli options
    """
    lines_enum = enumerate(content.splitlines(), start=1)  # type: ReqFileLines
    lines_enum = join_lines(lines_enum)
    lines_enum = ignore_comments(lines_enum)
    lines_enum = skip_regex(lines_enum, options)
    lines_enum = expand_env_variables(lines_enum)
    return lines_enum


def process_line(
    line,  # type: Text
    filename,  # type: str
    line_number,  # type: int
    finder=None,  # type: Optional[PackageFinder]
    comes_from=None,  # type: Optional[str]
    options=None,  # type: Optional[optparse.Values]
    session=None,  # type: Optional[PipSession]
    wheel_cache=None,  # type: Optional[WheelCache]
    use_pep517=None,  # type: Optional[bool]
    constraint=False,  # type: bool
):
    # type: (...) -> Iterator[InstallRequirement]
    """Process a single requirements line; This can result in creating/yielding
    requirements, or updating the finder.

    For lines that contain requirements, the only options that have an effect
    are from SUPPORTED_OPTIONS_REQ, and they are scoped to the
    requirement. Other options from SUPPORTED_OPTIONS may be present, but are
    ignored.

    For lines that do not contain requirements, the only options that have an
    effect are from SUPPORTED_OPTIONS. Options from SUPPORTED_OPTIONS_REQ may
    be present, but are ignored. These lines may contain multiple options
    (although our docs imply only one is supported), and all our parsed and
    affect the finder.

    :param constraint: If True, parsing a constraints file.
    :param options: OptionParser options that we may update
    """
    parser = build_parser(line)
    defaults = parser.get_default_values()
    defaults.index_url = None
    if finder:
        defaults.format_control = finder.format_control
    args_str, options_str = break_args_options(line)
    # Prior to 2.7.3, shlex cannot deal with unicode entries
    if sys.version_info < (2, 7, 3):
        # https://github.com/python/mypy/issues/1174
        options_str = options_str.encode('utf8')  # type: ignore
    # https://github.com/python/mypy/issues/1174
    opts, _ = parser.parse_args(
        shlex.split(options_str), defaults)  # type: ignore

    # preserve for the nested code path
    line_comes_from = '%s %s (line %s)' % (
        '-c' if constraint else '-r', filename, line_number,
    )

    # yield a line requirement
    if args_str:
        isolated = options.isolated_mode if options else False
        if options:
            cmdoptions.check_install_build_global(options, opts)
        # get the options that apply to requirements
        req_options = {}
        for dest in SUPPORTED_OPTIONS_REQ_DEST:
            if dest in opts.__dict__ and opts.__dict__[dest]:
                req_options[dest] = opts.__dict__[dest]
        line_source = 'line {} of {}'.format(line_number, filename)
        yield install_req_from_line(
            args_str,
            comes_from=line_comes_from,
            use_pep517=use_pep517,
            isolated=isolated,
            options=req_options,
            wheel_cache=wheel_cache,
            constraint=constraint,
            line_source=line_source,
        )

    # yield an editable requirement
    elif opts.editables:
        isolated = options.isolated_mode if options else False
        yield install_req_from_editable(
            opts.editables[0], comes_from=line_comes_from,
            use_pep517=use_pep517,
            constraint=constraint, isolated=isolated, wheel_cache=wheel_cache
        )

    # parse a nested requirements file
    elif opts.requirements or opts.constraints:
        if opts.requirements:
            req_path = opts.requirements[0]
            nested_constraint = False
        else:
            req_path = opts.constraints[0]
            nested_constraint = True
        # original file is over http
        if SCHEME_RE.search(filename):
            # do a url join so relative paths work
            req_path = urllib_parse.urljoin(filename, req_path)
        # original file and nested file are paths
        elif not SCHEME_RE.search(req_path):
            # do a join so relative paths work
            req_path = os.path.join(os.path.dirname(filename), req_path)
        # TODO: Why not use `comes_from='-r {} (line {})'` here as well?
        parsed_reqs = parse_requirements(
            req_path, finder, comes_from, options, session,
            constraint=nested_constraint, wheel_cache=wheel_cache
        )
        for req in parsed_reqs:
            yield req

    # percolate hash-checking option upward
    elif opts.require_hashes:
        options.require_hashes = opts.require_hashes

    # set finder options
    elif finder:
        find_links = finder.find_links
        index_urls = finder.index_urls
        if opts.index_url:
            index_urls = [opts.index_url]
        if opts.no_index is True:
            index_urls = []
        if opts.extra_index_urls:
            index_urls.extend(opts.extra_index_urls)
        if opts.find_links:
            # FIXME: it would be nice to keep track of the source
            # of the find_links: support a find-links local path
            # relative to a requirements file.
            value = opts.find_links[0]
            req_dir = os.path.dirname(os.path.abspath(filename))
            relative_to_reqs_file = os.path.join(req_dir, value)
            if os.path.exists(relative_to_reqs_file):
                value = relative_to_reqs_file
            find_links.append(value)

        search_scope = SearchScope(
            find_links=find_links,
            index_urls=index_urls,
        )
        finder.search_scope = search_scope

        if opts.pre:
            finder.set_allow_all_prereleases()
        for host in opts.trusted_hosts or []:
            source = 'line {} of {}'.format(line_number, filename)
            session.add_trusted_host(host, source=source)


def break_args_options(line):
    # type: (Text) -> Tuple[str, Text]
    """Break up the line into an args and options string.  We only want to shlex
    (and then optparse) the options, not the args.  args can contain markers
    which are corrupted by shlex.
    """
    tokens = line.split(' ')
    args = []
    options = tokens[:]
    for token in tokens:
        if token.startswith('-') or token.startswith('--'):
            break
        else:
            args.append(token)
            options.pop(0)
    return ' '.join(args), ' '.join(options)  # type: ignore


def build_parser(line):
    # type: (Text) -> optparse.OptionParser
    """
    Return a parser for parsing requirement lines
    """
    parser = optparse.OptionParser(add_help_option=False)

    option_factories = SUPPORTED_OPTIONS + SUPPORTED_OPTIONS_REQ
    for option_factory in option_factories:
        option = option_factory()
        parser.add_option(option)

    # By default optparse sys.exits on parsing errors. We want to wrap
    # that in our own exception.
    def parser_exit(self, msg):
        # type: (Any, str) -> NoReturn
        # add offending line
        msg = 'Invalid requirement: %s\n%s' % (line, msg)
        raise RequirementsFileParseError(msg)
    # NOTE: mypy disallows assigning to a method
    #       https://github.com/python/mypy/issues/2427
    parser.exit = parser_exit  # type: ignore

    return parser


def join_lines(lines_enum):
    # type: (ReqFileLines) -> ReqFileLines
    """Joins a line ending in '\' with the previous line (except when following
    comments).  The joined line takes on the index of the first line.
    """
    primary_line_number = None
    new_line = []  # type: List[Text]
    for line_number, line in lines_enum:
        if not line.endswith('\\') or COMMENT_RE.match(line):
            if COMMENT_RE.match(line):
                # this ensures comments are always matched later
                line = ' ' + line
            if new_line:
                new_line.append(line)
                yield primary_line_number, ''.join(new_line)
                new_line = []
            else:
                yield line_number, line
        else:
            if not new_line:
                primary_line_number = line_number
            new_line.append(line.strip('\\'))

    # last line contains \
    if new_line:
        yield primary_line_number, ''.join(new_line)

    # TODO: handle space after '\'.


def ignore_comments(lines_enum):
    # type: (ReqFileLines) -> ReqFileLines
    """
    Strips comments and filter empty lines.
    """
    for line_number, line in lines_enum:
        line = COMMENT_RE.sub('', line)
        line = line.strip()
        if line:
            yield line_number, line


def skip_regex(lines_enum, options):
    # type: (ReqFileLines, Optional[optparse.Values]) -> ReqFileLines
    """
    Skip lines that match '--skip-requirements-regex' pattern

    Note: the regex pattern is only built once
    """
    skip_regex = options.skip_requirements_regex if options else None
    if skip_regex:
        pattern = re.compile(skip_regex)
        lines_enum = filterfalse(lambda e: pattern.search(e[1]), lines_enum)
    return lines_enum


def expand_env_variables(lines_enum):
    # type: (ReqFileLines) -> ReqFileLines
    """Replace all environment variables that can be retrieved via `os.getenv`.

    The only allowed format for environment variables defined in the
    requirement file is `${MY_VARIABLE_1}` to ensure two things:

    1. Strings that contain a `$` aren't accidentally (partially) expanded.
    2. Ensure consistency across platforms for requirement files.

    These points are the result of a discussion on the `github pull
    request #3514 <https://github.com/pypa/pip/pull/3514>`_.

    Valid characters in variable names follow the `POSIX standard
    <http://pubs.opengroup.org/onlinepubs/9699919799/>`_ and are limited
    to uppercase letter, digits and the `_` (underscore).
    """
    for line_number, line in lines_enum:
        for env_var, var_name in ENV_VAR_RE.findall(line):
            value = os.getenv(var_name)
            if not value:
                continue

            line = line.replace(env_var, value)

        yield line_number, line
site-packages/pip/_internal/vcs/mercurial.py000064400000011766151446176770015214 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os

from pip._vendor.six.moves import configparser

from pip._internal.exceptions import BadCommand, InstallationError
from pip._internal.utils.misc import display_path
from pip._internal.utils.subprocess import make_command
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import path_to_url
from pip._internal.vcs.versioncontrol import (
    VersionControl,
    find_path_to_setup_from_repo_root,
    vcs,
)

if MYPY_CHECK_RUNNING:
    from pip._internal.utils.misc import HiddenText
    from pip._internal.vcs.versioncontrol import RevOptions


logger = logging.getLogger(__name__)


class Mercurial(VersionControl):
    name = 'hg'
    dirname = '.hg'
    repo_name = 'clone'
    schemes = (
        'hg', 'hg+file', 'hg+http', 'hg+https', 'hg+ssh', 'hg+static-http',
    )

    @staticmethod
    def get_base_rev_args(rev):
        return [rev]

    def export(self, location, url):
        # type: (str, HiddenText) -> None
        """Export the Hg repository at the url to the destination location"""
        with TempDirectory(kind="export") as temp_dir:
            self.unpack(temp_dir.path, url=url)

            self.run_command(
                ['archive', location], show_stdout=False, cwd=temp_dir.path
            )

    def fetch_new(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        rev_display = rev_options.to_display()
        logger.info(
            'Cloning hg %s%s to %s',
            url,
            rev_display,
            display_path(dest),
        )
        self.run_command(make_command('clone', '--noupdate', '-q', url, dest))
        self.run_command(
            make_command('update', '-q', rev_options.to_args()),
            cwd=dest,
        )

    def switch(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        repo_config = os.path.join(dest, self.dirname, 'hgrc')
        config = configparser.RawConfigParser()
        try:
            config.read(repo_config)
            config.set('paths', 'default', url.secret)
            with open(repo_config, 'w') as config_file:
                config.write(config_file)
        except (OSError, configparser.NoSectionError) as exc:
            logger.warning(
                'Could not switch Mercurial repository to %s: %s', url, exc,
            )
        else:
            cmd_args = make_command('update', '-q', rev_options.to_args())
            self.run_command(cmd_args, cwd=dest)

    def update(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        self.run_command(['pull', '-q'], cwd=dest)
        cmd_args = make_command('update', '-q', rev_options.to_args())
        self.run_command(cmd_args, cwd=dest)

    @classmethod
    def get_remote_url(cls, location):
        url = cls.run_command(
            ['showconfig', 'paths.default'],
            show_stdout=False, cwd=location).strip()
        if cls._is_local_repository(url):
            url = path_to_url(url)
        return url.strip()

    @classmethod
    def get_revision(cls, location):
        """
        Return the repository-local changeset revision number, as an integer.
        """
        current_revision = cls.run_command(
            ['parents', '--template={rev}'],
            show_stdout=False, cwd=location).strip()
        return current_revision

    @classmethod
    def get_requirement_revision(cls, location):
        """
        Return the changeset identification hash, as a 40-character
        hexadecimal string
        """
        current_rev_hash = cls.run_command(
            ['parents', '--template={node}'],
            show_stdout=False, cwd=location).strip()
        return current_rev_hash

    @classmethod
    def is_commit_id_equal(cls, dest, name):
        """Always assume the versions don't match"""
        return False

    @classmethod
    def get_subdirectory(cls, location):
        """
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        """
        # find the repo root
        repo_root = cls.run_command(
            ['root'], show_stdout=False, cwd=location).strip()
        if not os.path.isabs(repo_root):
            repo_root = os.path.abspath(os.path.join(location, repo_root))
        return find_path_to_setup_from_repo_root(location, repo_root)

    @classmethod
    def controls_location(cls, location):
        if super(Mercurial, cls).controls_location(location):
            return True
        try:
            cls.run_command(
                ['identify'],
                cwd=location,
                show_stdout=False,
                on_returncode='raise',
                log_failed_cmd=False)
            return True
        except (BadCommand, InstallationError):
            return False


vcs.register(Mercurial)
site-packages/pip/_internal/vcs/bazaar.py000064400000007565151446176770014473 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os

from pip._vendor.six.moves.urllib import parse as urllib_parse

from pip._internal.utils.misc import display_path, rmtree
from pip._internal.utils.subprocess import make_command
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import path_to_url
from pip._internal.vcs.versioncontrol import VersionControl, vcs

if MYPY_CHECK_RUNNING:
    from typing import Optional, Tuple
    from pip._internal.utils.misc import HiddenText
    from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions


logger = logging.getLogger(__name__)


class Bazaar(VersionControl):
    name = 'bzr'
    dirname = '.bzr'
    repo_name = 'branch'
    schemes = (
        'bzr', 'bzr+http', 'bzr+https', 'bzr+ssh', 'bzr+sftp', 'bzr+ftp',
        'bzr+lp',
    )

    def __init__(self, *args, **kwargs):
        super(Bazaar, self).__init__(*args, **kwargs)
        # This is only needed for python <2.7.5
        # Register lp but do not expose as a scheme to support bzr+lp.
        if getattr(urllib_parse, 'uses_fragment', None):
            urllib_parse.uses_fragment.extend(['lp'])

    @staticmethod
    def get_base_rev_args(rev):
        return ['-r', rev]

    def export(self, location, url):
        # type: (str, HiddenText) -> None
        """
        Export the Bazaar repository at the url to the destination location
        """
        # Remove the location to make sure Bazaar can export it correctly
        if os.path.exists(location):
            rmtree(location)

        url, rev_options = self.get_url_rev_options(url)
        self.run_command(
            make_command('export', location, url, rev_options.to_args()),
            show_stdout=False,
        )

    def fetch_new(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        rev_display = rev_options.to_display()
        logger.info(
            'Checking out %s%s to %s',
            url,
            rev_display,
            display_path(dest),
        )
        cmd_args = (
            make_command('branch', '-q', rev_options.to_args(), url, dest)
        )
        self.run_command(cmd_args)

    def switch(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        self.run_command(make_command('switch', url), cwd=dest)

    def update(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        cmd_args = make_command('pull', '-q', rev_options.to_args())
        self.run_command(cmd_args, cwd=dest)

    @classmethod
    def get_url_rev_and_auth(cls, url):
        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
        # hotfix the URL scheme after removing bzr+ from bzr+ssh:// readd it
        url, rev, user_pass = super(Bazaar, cls).get_url_rev_and_auth(url)
        if url.startswith('ssh://'):
            url = 'bzr+' + url
        return url, rev, user_pass

    @classmethod
    def get_remote_url(cls, location):
        urls = cls.run_command(['info'], show_stdout=False, cwd=location)
        for line in urls.splitlines():
            line = line.strip()
            for x in ('checkout of branch: ',
                      'parent branch: '):
                if line.startswith(x):
                    repo = line.split(x)[1]
                    if cls._is_local_repository(repo):
                        return path_to_url(repo)
                    return repo
        return None

    @classmethod
    def get_revision(cls, location):
        revision = cls.run_command(
            ['revno'], show_stdout=False, cwd=location,
        )
        return revision.splitlines()[-1]

    @classmethod
    def is_commit_id_equal(cls, dest, name):
        """Always assume the versions don't match"""
        return False


vcs.register(Bazaar)
site-packages/pip/_internal/vcs/versioncontrol.py000064400000051576151446176770016322 0ustar00"""Handles all VCS (version control) support"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import errno
import logging
import os
import shutil
import sys

from pip._vendor import pkg_resources
from pip._vendor.six.moves.urllib import parse as urllib_parse

from pip._internal.exceptions import BadCommand
from pip._internal.utils.compat import samefile
from pip._internal.utils.misc import (
    ask_path_exists,
    backup_dir,
    display_path,
    hide_url,
    hide_value,
    rmtree,
)
from pip._internal.utils.subprocess import call_subprocess, make_command
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import get_url_scheme

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, Dict, Iterable, List, Mapping, Optional, Text, Tuple, Type, Union
    )
    from pip._internal.utils.ui import SpinnerInterface
    from pip._internal.utils.misc import HiddenText
    from pip._internal.utils.subprocess import CommandArgs

    AuthInfo = Tuple[Optional[str], Optional[str]]


__all__ = ['vcs']


logger = logging.getLogger(__name__)


def is_url(name):
    # type: (Union[str, Text]) -> bool
    """
    Return true if the name looks like a URL.
    """
    scheme = get_url_scheme(name)
    if scheme is None:
        return False
    return scheme in ['http', 'https', 'file', 'ftp'] + vcs.all_schemes


def make_vcs_requirement_url(repo_url, rev, project_name, subdir=None):
    """
    Return the URL for a VCS requirement.

    Args:
      repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+").
      project_name: the (unescaped) project name.
    """
    egg_project_name = pkg_resources.to_filename(project_name)
    req = '{}@{}#egg={}'.format(repo_url, rev, egg_project_name)
    if subdir:
        req += '&subdirectory={}'.format(subdir)

    return req


def find_path_to_setup_from_repo_root(location, repo_root):
    """
    Find the path to `setup.py` by searching up the filesystem from `location`.
    Return the path to `setup.py` relative to `repo_root`.
    Return None if `setup.py` is in `repo_root` or cannot be found.
    """
    # find setup.py
    orig_location = location
    while not os.path.exists(os.path.join(location, 'setup.py')):
        last_location = location
        location = os.path.dirname(location)
        if location == last_location:
            # We've traversed up to the root of the filesystem without
            # finding setup.py
            logger.warning(
                "Could not find setup.py for directory %s (tried all "
                "parent directories)",
                orig_location,
            )
            return None

    if samefile(repo_root, location):
        return None

    return os.path.relpath(location, repo_root)


class RemoteNotFoundError(Exception):
    pass


class RevOptions(object):

    """
    Encapsulates a VCS-specific revision to install, along with any VCS
    install options.

    Instances of this class should be treated as if immutable.
    """

    def __init__(
        self,
        vc_class,  # type: Type[VersionControl]
        rev=None,  # type: Optional[str]
        extra_args=None,  # type: Optional[CommandArgs]
    ):
        # type: (...) -> None
        """
        Args:
          vc_class: a VersionControl subclass.
          rev: the name of the revision to install.
          extra_args: a list of extra options.
        """
        if extra_args is None:
            extra_args = []

        self.extra_args = extra_args
        self.rev = rev
        self.vc_class = vc_class
        self.branch_name = None  # type: Optional[str]

    def __repr__(self):
        return '<RevOptions {}: rev={!r}>'.format(self.vc_class.name, self.rev)

    @property
    def arg_rev(self):
        # type: () -> Optional[str]
        if self.rev is None:
            return self.vc_class.default_arg_rev

        return self.rev

    def to_args(self):
        # type: () -> CommandArgs
        """
        Return the VCS-specific command arguments.
        """
        args = []  # type: CommandArgs
        rev = self.arg_rev
        if rev is not None:
            args += self.vc_class.get_base_rev_args(rev)
        args += self.extra_args

        return args

    def to_display(self):
        # type: () -> str
        if not self.rev:
            return ''

        return ' (to revision {})'.format(self.rev)

    def make_new(self, rev):
        # type: (str) -> RevOptions
        """
        Make a copy of the current instance, but with a new rev.

        Args:
          rev: the name of the revision for the new object.
        """
        return self.vc_class.make_rev_options(rev, extra_args=self.extra_args)


class VcsSupport(object):
    _registry = {}  # type: Dict[str, VersionControl]
    schemes = ['ssh', 'git', 'hg', 'bzr', 'sftp', 'svn']

    def __init__(self):
        # type: () -> None
        # Register more schemes with urlparse for various version control
        # systems
        urllib_parse.uses_netloc.extend(self.schemes)
        # Python >= 2.7.4, 3.3 doesn't have uses_fragment
        if getattr(urllib_parse, 'uses_fragment', None):
            urllib_parse.uses_fragment.extend(self.schemes)
        super(VcsSupport, self).__init__()

    def __iter__(self):
        return self._registry.__iter__()

    @property
    def backends(self):
        # type: () -> List[VersionControl]
        return list(self._registry.values())

    @property
    def dirnames(self):
        # type: () -> List[str]
        return [backend.dirname for backend in self.backends]

    @property
    def all_schemes(self):
        # type: () -> List[str]
        schemes = []  # type: List[str]
        for backend in self.backends:
            schemes.extend(backend.schemes)
        return schemes

    def register(self, cls):
        # type: (Type[VersionControl]) -> None
        if not hasattr(cls, 'name'):
            logger.warning('Cannot register VCS %s', cls.__name__)
            return
        if cls.name not in self._registry:
            self._registry[cls.name] = cls()
            logger.debug('Registered VCS backend: %s', cls.name)

    def unregister(self, name):
        # type: (str) -> None
        if name in self._registry:
            del self._registry[name]

    def get_backend_for_dir(self, location):
        # type: (str) -> Optional[VersionControl]
        """
        Return a VersionControl object if a repository of that type is found
        at the given directory.
        """
        for vcs_backend in self._registry.values():
            if vcs_backend.controls_location(location):
                logger.debug('Determine that %s uses VCS: %s',
                             location, vcs_backend.name)
                return vcs_backend
        return None

    def get_backend(self, name):
        # type: (str) -> Optional[VersionControl]
        """
        Return a VersionControl object or None.
        """
        name = name.lower()
        return self._registry.get(name)


vcs = VcsSupport()


class VersionControl(object):
    name = ''
    dirname = ''
    repo_name = ''
    # List of supported schemes for this Version Control
    schemes = ()  # type: Tuple[str, ...]
    # Iterable of environment variable names to pass to call_subprocess().
    unset_environ = ()  # type: Tuple[str, ...]
    default_arg_rev = None  # type: Optional[str]

    @classmethod
    def should_add_vcs_url_prefix(cls, remote_url):
        """
        Return whether the vcs prefix (e.g. "git+") should be added to a
        repository's remote url when used in a requirement.
        """
        return not remote_url.lower().startswith('{}:'.format(cls.name))

    @classmethod
    def get_subdirectory(cls, location):
        """
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        """
        return None

    @classmethod
    def get_requirement_revision(cls, repo_dir):
        """
        Return the revision string that should be used in a requirement.
        """
        return cls.get_revision(repo_dir)

    @classmethod
    def get_src_requirement(cls, repo_dir, project_name):
        """
        Return the requirement string to use to redownload the files
        currently at the given repository directory.

        Args:
          project_name: the (unescaped) project name.

        The return value has a form similar to the following:

            {repository_url}@{revision}#egg={project_name}
        """
        repo_url = cls.get_remote_url(repo_dir)
        if repo_url is None:
            return None

        if cls.should_add_vcs_url_prefix(repo_url):
            repo_url = '{}+{}'.format(cls.name, repo_url)

        revision = cls.get_requirement_revision(repo_dir)
        subdir = cls.get_subdirectory(repo_dir)
        req = make_vcs_requirement_url(repo_url, revision, project_name,
                                       subdir=subdir)

        return req

    @staticmethod
    def get_base_rev_args(rev):
        """
        Return the base revision arguments for a vcs command.

        Args:
          rev: the name of a revision to install.  Cannot be None.
        """
        raise NotImplementedError

    @classmethod
    def make_rev_options(cls, rev=None, extra_args=None):
        # type: (Optional[str], Optional[CommandArgs]) -> RevOptions
        """
        Return a RevOptions object.

        Args:
          rev: the name of a revision to install.
          extra_args: a list of extra options.
        """
        return RevOptions(cls, rev, extra_args=extra_args)

    @classmethod
    def _is_local_repository(cls, repo):
        # type: (str) -> bool
        """
           posix absolute paths start with os.path.sep,
           win32 ones start with drive (like c:\\folder)
        """
        drive, tail = os.path.splitdrive(repo)
        return repo.startswith(os.path.sep) or bool(drive)

    def export(self, location, url):
        # type: (str, HiddenText) -> None
        """
        Export the repository at the url to the destination location
        i.e. only download the files, without vcs informations

        :param url: the repository URL starting with a vcs prefix.
        """
        raise NotImplementedError

    @classmethod
    def get_netloc_and_auth(cls, netloc, scheme):
        """
        Parse the repository URL's netloc, and return the new netloc to use
        along with auth information.

        Args:
          netloc: the original repository URL netloc.
          scheme: the repository URL's scheme without the vcs prefix.

        This is mainly for the Subversion class to override, so that auth
        information can be provided via the --username and --password options
        instead of through the URL.  For other subclasses like Git without
        such an option, auth information must stay in the URL.

        Returns: (netloc, (username, password)).
        """
        return netloc, (None, None)

    @classmethod
    def get_url_rev_and_auth(cls, url):
        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
        """
        Parse the repository URL to use, and return the URL, revision,
        and auth info to use.

        Returns: (url, rev, (username, password)).
        """
        scheme, netloc, path, query, frag = urllib_parse.urlsplit(url)
        if '+' not in scheme:
            raise ValueError(
                "Sorry, {!r} is a malformed VCS url. "
                "The format is <vcs>+<protocol>://<url>, "
                "e.g. svn+http://myrepo/svn/MyApp#egg=MyApp".format(url)
            )
        # Remove the vcs prefix.
        scheme = scheme.split('+', 1)[1]
        netloc, user_pass = cls.get_netloc_and_auth(netloc, scheme)
        rev = None
        if '@' in path:
            path, rev = path.rsplit('@', 1)
        url = urllib_parse.urlunsplit((scheme, netloc, path, query, ''))
        return url, rev, user_pass

    @staticmethod
    def make_rev_args(username, password):
        # type: (Optional[str], Optional[HiddenText]) -> CommandArgs
        """
        Return the RevOptions "extra arguments" to use in obtain().
        """
        return []

    def get_url_rev_options(self, url):
        # type: (HiddenText) -> Tuple[HiddenText, RevOptions]
        """
        Return the URL and RevOptions object to use in obtain() and in
        some cases export(), as a tuple (url, rev_options).
        """
        secret_url, rev, user_pass = self.get_url_rev_and_auth(url.secret)
        username, secret_password = user_pass
        password = None  # type: Optional[HiddenText]
        if secret_password is not None:
            password = hide_value(secret_password)
        extra_args = self.make_rev_args(username, password)
        rev_options = self.make_rev_options(rev, extra_args=extra_args)

        return hide_url(secret_url), rev_options

    @staticmethod
    def normalize_url(url):
        # type: (str) -> str
        """
        Normalize a URL for comparison by unquoting it and removing any
        trailing slash.
        """
        return urllib_parse.unquote(url).rstrip('/')

    @classmethod
    def compare_urls(cls, url1, url2):
        # type: (str, str) -> bool
        """
        Compare two repo URLs for identity, ignoring incidental differences.
        """
        return (cls.normalize_url(url1) == cls.normalize_url(url2))

    def fetch_new(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        """
        Fetch a revision from a repository, in the case that this is the
        first fetch from the repository.

        Args:
          dest: the directory to fetch the repository to.
          rev_options: a RevOptions object.
        """
        raise NotImplementedError

    def switch(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        """
        Switch the repo at ``dest`` to point to ``URL``.

        Args:
          rev_options: a RevOptions object.
        """
        raise NotImplementedError

    def update(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        """
        Update an already-existing repo to the given ``rev_options``.

        Args:
          rev_options: a RevOptions object.
        """
        raise NotImplementedError

    @classmethod
    def is_commit_id_equal(cls, dest, name):
        """
        Return whether the id of the current commit equals the given name.

        Args:
          dest: the repository directory.
          name: a string name.
        """
        raise NotImplementedError

    def obtain(self, dest, url):
        # type: (str, HiddenText) -> None
        """
        Install or update in editable mode the package represented by this
        VersionControl object.

        :param dest: the repository directory in which to install or update.
        :param url: the repository URL starting with a vcs prefix.
        """
        url, rev_options = self.get_url_rev_options(url)

        if not os.path.exists(dest):
            self.fetch_new(dest, url, rev_options)
            return

        rev_display = rev_options.to_display()
        if self.is_repository_directory(dest):
            existing_url = self.get_remote_url(dest)
            if self.compare_urls(existing_url, url.secret):
                logger.debug(
                    '%s in %s exists, and has correct URL (%s)',
                    self.repo_name.title(),
                    display_path(dest),
                    url,
                )
                if not self.is_commit_id_equal(dest, rev_options.rev):
                    logger.info(
                        'Updating %s %s%s',
                        display_path(dest),
                        self.repo_name,
                        rev_display,
                    )
                    self.update(dest, url, rev_options)
                else:
                    logger.info('Skipping because already up-to-date.')
                return

            logger.warning(
                '%s %s in %s exists with URL %s',
                self.name,
                self.repo_name,
                display_path(dest),
                existing_url,
            )
            prompt = ('(s)witch, (i)gnore, (w)ipe, (b)ackup ',
                      ('s', 'i', 'w', 'b'))
        else:
            logger.warning(
                'Directory %s already exists, and is not a %s %s.',
                dest,
                self.name,
                self.repo_name,
            )
            # https://github.com/python/mypy/issues/1174
            prompt = ('(i)gnore, (w)ipe, (b)ackup ',  # type: ignore
                      ('i', 'w', 'b'))

        logger.warning(
            'The plan is to install the %s repository %s',
            self.name,
            url,
        )
        response = ask_path_exists('What to do?  %s' % prompt[0], prompt[1])

        if response == 'a':
            sys.exit(-1)

        if response == 'w':
            logger.warning('Deleting %s', display_path(dest))
            rmtree(dest)
            self.fetch_new(dest, url, rev_options)
            return

        if response == 'b':
            dest_dir = backup_dir(dest)
            logger.warning(
                'Backing up %s to %s', display_path(dest), dest_dir,
            )
            shutil.move(dest, dest_dir)
            self.fetch_new(dest, url, rev_options)
            return

        # Do nothing if the response is "i".
        if response == 's':
            logger.info(
                'Switching %s %s to %s%s',
                self.repo_name,
                display_path(dest),
                url,
                rev_display,
            )
            self.switch(dest, url, rev_options)

    def unpack(self, location, url):
        # type: (str, HiddenText) -> None
        """
        Clean up current location and download the url repository
        (and vcs infos) into location

        :param url: the repository URL starting with a vcs prefix.
        """
        if os.path.exists(location):
            rmtree(location)
        self.obtain(location, url=url)

    @classmethod
    def get_remote_url(cls, location):
        """
        Return the url used at location

        Raises RemoteNotFoundError if the repository does not have a remote
        url configured.
        """
        raise NotImplementedError

    @classmethod
    def get_revision(cls, location):
        """
        Return the current commit id of the files at the given location.
        """
        raise NotImplementedError

    @classmethod
    def run_command(
        cls,
        cmd,  # type: Union[List[str], CommandArgs]
        show_stdout=True,  # type: bool
        cwd=None,  # type: Optional[str]
        on_returncode='raise',  # type: str
        extra_ok_returncodes=None,  # type: Optional[Iterable[int]]
        command_desc=None,  # type: Optional[str]
        extra_environ=None,  # type: Optional[Mapping[str, Any]]
        spinner=None,  # type: Optional[SpinnerInterface]
        log_failed_cmd=True
    ):
        # type: (...) -> Text
        """
        Run a VCS subcommand
        This is simply a wrapper around call_subprocess that adds the VCS
        command name, and checks that the VCS is available
        """
        cmd = make_command(cls.name, *cmd)
        try:
            return call_subprocess(cmd, show_stdout, cwd,
                                   on_returncode=on_returncode,
                                   extra_ok_returncodes=extra_ok_returncodes,
                                   command_desc=command_desc,
                                   extra_environ=extra_environ,
                                   unset_environ=cls.unset_environ,
                                   spinner=spinner,
                                   log_failed_cmd=log_failed_cmd)
        except OSError as e:
            # errno.ENOENT = no such file or directory
            # In other words, the VCS executable isn't available
            if e.errno == errno.ENOENT:
                raise BadCommand(
                    'Cannot find command %r - do you have '
                    '%r installed and in your '
                    'PATH?' % (cls.name, cls.name))
            else:
                raise  # re-raise exception if a different error occurred

    @classmethod
    def is_repository_directory(cls, path):
        # type: (str) -> bool
        """
        Return whether a directory path is a repository directory.
        """
        logger.debug('Checking in %s for %s (%s)...',
                     path, cls.dirname, cls.name)
        return os.path.exists(os.path.join(path, cls.dirname))

    @classmethod
    def controls_location(cls, location):
        # type: (str) -> bool
        """
        Check if a location is controlled by the vcs.
        It is meant to be overridden to implement smarter detection
        mechanisms for specific vcs.

        This can do more than is_repository_directory() alone.  For example,
        the Git override checks that Git is actually available.
        """
        return cls.is_repository_directory(location)
site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000700151446176770022177 0ustar00U

��.ei�@s<ddlZddlZddlZddlZddlmZmZmZm	Z	dS)�N)�RemoteNotFoundError�is_url�make_vcs_requirement_url�vcs)
Zpip._internal.vcs.bazaarZpipZpip._internal.vcs.gitZpip._internal.vcs.mercurialZpip._internal.vcs.subversionZ pip._internal.vcs.versioncontrolrrrr�rr�>/usr/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py�<module>ssite-packages/pip/_internal/vcs/__pycache__/git.cpython-38.opt-1.pyc000064400000021715151446176770021234 0ustar00U

��.e5�@sddlmZddlZddlZddlZddlmZddl	mZ
ddl	mZddl
mZddlmZddlmZddlmZdd	lmZdd
lmZmZmZmZer�ddlmZmZddlmZdd
lm Z m!Z!e
j"Z"e
j#Z#e�$e%�Z&e�'d�Z(dd�Z)Gdd�de�Z*e�+e*�dS)�)�absolute_importN)�parse)�request)�
BadCommand)�display_path)�make_command)�
TempDirectory)�MYPY_CHECK_RUNNING)�RemoteNotFoundError�VersionControl�!find_path_to_setup_from_repo_root�vcs)�Optional�Tuple)�
HiddenText)�AuthInfo�
RevOptionsz^[a-fA-F0-9]{40}$cCstt�|��S�N)�bool�
HASH_REGEX�match)�sha�r�9/usr/lib/python3.8/site-packages/pip/_internal/vcs/git.py�looks_like_hash*srcs�eZdZdZdZdZdZdZdZe	dd��Z
d	d
�Zedd��Z
d
d�Zedd��Zedd��Zedd��Zdd�Zdd�Zdd�Zedd��Zed(dd��Zed d!��Ze�fd"d#��Zed$d%��Ze�fd&d'��Z�ZS))�Git�gitz.git�clone)rzgit+httpz	git+httpszgit+sshzgit+gitzgit+file)ZGIT_DIRZ
GIT_WORK_TREE�HEADcCs|gSrr��revrrr�get_base_rev_args:szGit.get_base_rev_argscCs\d}|jdgdd�}|�|�r8|t|�d���d}nd}d�|�d�dd��}t|�S)	Nzgit version �versionF)�show_stdoutr��.�)�run_command�
startswith�len�split�join�
parse_version)�selfZVERSION_PFXr"rrr�get_git_version>s
zGit.get_git_versioncCsBdddg}|j|dd|d�}|��}|�d�r>|td�d�SdS)	zl
        Return the current branch, or None if HEAD isn't at a branch
        (e.g. detached HEAD).
        zsymbolic-ref�-qr��F�Zextra_ok_returncodesr#�cwdzrefs/heads/N)r'�stripr(r))�cls�location�args�output�refrrr�get_current_branchKs

�
zGit.get_current_branchc	CsX|�d�s|d}tdd��2}|j|j|d�|jdddd|gd	|jd
�W5QRXdS)z@Export the Git repository at the url to the destination location�/�export)Zkind)�urlzcheckout-indexz-az-fz--prefixF�r#r3N)�endswithr�unpack�pathr')r-r6r=Ztemp_dirrrrr<`s
�z
Git.exportc
	Cs�|jd|g|ddd�}i}|���d�D]V}|�d�}|s<q(z|jddd	�\}}Wn"tk
rttd
�|���YnX|||<q(d�|�}d�|�}	|�|�}|d
k	r�|dfS|�|	�}|dfS)z�
        Return (sha_or_none, is_branch), where sha_or_none is a commit hash
        if the revision names a remote branch or tag, otherwise None.

        Args:
          dest: the repository directory.
          rev: the revision name.
        zshow-refF�ignore)r3r#�
on_returncode�
�
� �)�maxsplitzunexpected show-ref line: {!r}zrefs/remotes/origin/{}zrefs/tags/{}NT)r'r4r*�rstrip�
ValueError�format�get)
r5�destr r8Zrefs�linerr9Z
branch_refZtag_refrrr�get_revision_shams*�





zGit.get_revision_shacCs�|j}|�||�\}}|dk	r:|�|�}|r0|nd|_|St|�sNt�d|�|�d�s\|S|jt	dd||�
��|d�|j|dd�}|�|�}|S)	z�
        Resolve a revision to a new RevOptions object with the SHA1 of the
        branch, tag, or ref if found.

        Args:
          rev_options: a RevOptions object.
        Nz:Did not find branch or tag '%s', assuming revision or ref.zrefs/�fetchr/�r3Z
FETCH_HEADr)Zarg_revrOZmake_new�branch_namer�loggerZwarningr(r'r�to_args�get_revision)r5rMr=�rev_optionsr rZ	is_branchrrr�resolve_revision�s(

�
�
zGit.resolve_revisioncCs|sdS|�|�|kS)z�
        Return whether the current commit hash equals the given name.

        Args:
          dest: the repository directory.
          name: a string name.
        F)rU)r5rM�namerrr�is_commit_id_equal�s	zGit.is_commit_id_equalcCs�|��}t�d||t|��|�tdd||��|jr�|�|||�}t|dd�}|dkr�|�	||j�s�tdd|�
��}|j||d�n4|�|�|kr�d�|�}dd|d	|g}|j||d�|�
|�dS)
NzCloning %s%s to %srr/rR�checkoutrQz	origin/{}z-bz--track)Z
to_displayrS�inforr'rr rW�getattrrYrTr:rK�update_submodules)r-rMr=rVZrev_displayrR�cmd_argsZtrack_branchrrr�	fetch_new�s0�
�z
Git.fetch_newcCsB|jtdd|�|d�tdd|���}|j||d�|�|�dS)N�configzremote.origin.urlrQrZr/)r'rrTr]�r-rMr=rVr^rrr�switch�s
�z
Git.switchcCst|��td�kr&|jdddg|d�n|jddg|d�|�|||�}tddd|���}|j||d�|�|�dS)Nz1.9.0rPr/z--tagsrQ�resetz--hard)r.r,r'rWrrTr]rarrr�update�sz
Git.updatecCsx|jdddgdd|d�}|��}z|d}Wntk
rDt�YnX|D]}|�d�rJ|}qbqJ|�d	�d
}|��S)z�
        Return URL of the first remote encountered.

        Raises RemoteNotFoundError if the repository does not have a remote
        url configured.
        r`z--get-regexpzremote\..*\.urlr0Fr2rzremote.origin.url rFr1)r'�
splitlines�
IndexErrorr
r(r*r4)r5r6�stdoutZremotesZfound_remoteZremoter=rrr�get_remote_url
s"
�

zGit.get_remote_urlNcCs(|dkrd}|jd|gd|d�}|��S)Nr�	rev-parseFr>)r'r4)r5r6r Zcurrent_revrrrrU%s�zGit.get_revisioncCsR|jddgd|d���}tj�|�s2tj�||�}tj�tj�|d��}t||�S)z~
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        riz	--git-dirFr>z..)r'r4�osrA�isabsr+�abspathr)r5r6Zgit_dirZ	repo_rootrrr�get_subdirectory.s�
zGit.get_subdirectorycs�t|�\}}}}}|�d�r�|dt|�d���}|t�|��dd��d�}t|||||f�}|�d�d}	|d|	�t||	d�||||f�}d|kr�|�dd	�}t	t
|��|�\}}
}|�d
d�}nt	t
|��|�\}}
}||
|fS)a9
        Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'.
        That's required because although they use SSH they sometimes don't
        work with a ssh:// scheme (e.g. GitHub). But we need a scheme for
        parsing. Hence we remove it again afterwards and return it as a stub.
        �fileNr;�\�+r1z://zgit+z
git+ssh://zssh://r$)�urlsplitr?r)�lstrip�urllib_requestZurl2pathname�replace�
urlunsplit�find�superr�get_url_rev_and_auth)r5r=ZschemeZnetlocrAZqueryZfragment�initial_slashes�newpathZ
after_plusr Z	user_pass��	__class__rrrx=s.

�����zGit.get_url_rev_and_authcCs6tj�tj�|d��sdS|jdddddg|d�dS)Nz.gitmodulesZ	submodulerdz--initz--recursiver/rQ)rjrA�existsr+r')r5r6rrrr]`s�zGit.update_submodulescsZtt|��|�rdSz|jdg|dddd�}|WStk
rTt�d|�YdSXdS)NTriFrB)r3r#rCZlog_failed_cmdzKcould not determine if %s is under git control because git is not available)rwr�controls_locationr'rrS�debug)r5r6�rr{rrr~is��zGit.controls_location)N)�__name__�
__module__�__qualname__rX�dirnameZ	repo_nameZschemesZ
unset_environZdefault_arg_rev�staticmethodr!r.�classmethodr:r<rOrWrYr_rbrdrhrUrmrxr]r~�
__classcell__rrr{rr.sB




(
,


"
r),Z
__future__rZloggingZos.pathrj�reZpip._vendor.packaging.versionrr,Zpip._vendor.six.moves.urllibZurllib_parserrsZpip._internal.exceptionsrZpip._internal.utils.miscrZpip._internal.utils.subprocessrZpip._internal.utils.temp_dirrZpip._internal.utils.typingr	Z pip._internal.vcs.versioncontrolr
rrr
�typingrrrrrrqruZ	getLoggerr�rS�compilerrr�registerrrrr�<module>s2

Nsite-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-38.opt-1.pyc000064400000007243151446176770021711 0ustar00U

��.eu�@s�ddlmZddlZddlZddlmZddlmZm	Z	ddl
mZddlm
Z
ddlmZddlmZmZe
r�dd	lmZmZdd
lmZddlmZmZe�e�ZGdd
�d
e�Ze�e�dS)�)�absolute_importN)�parse)�display_path�rmtree)�make_command)�MYPY_CHECK_RUNNING)�path_to_url)�VersionControl�vcs)�Optional�Tuple)�
HiddenText)�AuthInfo�
RevOptionscs�eZdZdZdZdZdZ�fdd�Zedd��Z	d	d
�Z
dd�Zd
d�Zdd�Z
e�fdd��Zedd��Zedd��Zedd��Z�ZS)�Bazaar�bzrz.bzr�branch)rzbzr+httpz	bzr+httpszbzr+sshzbzr+sftpzbzr+ftpzbzr+lpcs0tt|�j||�ttdd�r,tj�dg�dS)N�
uses_fragmentZlp)�superr�__init__�getattr�urllib_parser�extend)�self�args�kwargs��	__class__��</usr/lib/python3.8/site-packages/pip/_internal/vcs/bazaar.pyr#szBazaar.__init__cCsd|gS)Nz-rr)�revrrr�get_base_rev_args*szBazaar.get_base_rev_argscCsBtj�|�rt|�|�|�\}}|jtd|||���dd�dS)zU
        Export the Bazaar repository at the url to the destination location
        �exportF)�show_stdoutN)�os�path�existsrZget_url_rev_options�run_commandr�to_args)r�location�url�rev_optionsrrrr".s�z
Bazaar.exportcCs>|��}t�d||t|��tdd|��||�}|�|�dS)NzChecking out %s%s to %sr�-q)Z
to_display�logger�inforrr(r')r�destr*r+Zrev_display�cmd_argsrrr�	fetch_new=s��zBazaar.fetch_newcCs|jtd|�|d�dS)N�switch��cwd)r'r)rr/r*r+rrrr2Ksz
Bazaar.switchcCs"tdd|���}|j||d�dS)NZpullr,r3)rr(r')rr/r*r+r0rrr�updateOsz
Bazaar.updatecs2tt|��|�\}}}|�d�r(d|}|||fS)Nzssh://zbzr+)rr�get_url_rev_and_auth�
startswith)�clsr*r Z	user_passrrrr6Ts
zBazaar.get_url_rev_and_authcCst|jdgd|d�}|��D]T}|��}dD]B}|�|�r*|�|�d}|�|�r`t|�S|Sq*qdS)Nr.F�r#r4)zcheckout of branch: zparent branch: �)r'�
splitlines�stripr7�splitZ_is_local_repositoryr)r8r)Zurls�line�xZreporrr�get_remote_url]s

zBazaar.get_remote_urlcCs|jdgd|d�}|��dS)NZrevnoFr9���)r'r;)r8r)Zrevisionrrr�get_revisionks�zBazaar.get_revisioncCsdS)z&Always assume the versions don't matchFr)r8r/�namerrr�is_commit_id_equalrszBazaar.is_commit_id_equal)�__name__�
__module__�__qualname__rC�dirnameZ	repo_nameZschemesr�staticmethodr!r"r1r2r5�classmethodr6r@rBrD�
__classcell__rrrrrs&



r)Z
__future__rZloggingr$Zpip._vendor.six.moves.urllibrrZpip._internal.utils.miscrrZpip._internal.utils.subprocessrZpip._internal.utils.typingrZpip._internal.utils.urlsrZ pip._internal.vcs.versioncontrolr	r
�typingrrr
rrZ	getLoggerrEr-r�registerrrrr�<module>s
^site-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-38.pyc000064400000044035151446176770022600 0ustar00U

��.e~S�@s�dZddlmZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddl
mZddlmZddlmZmZmZmZmZmZdd	lmZmZdd
lmZddlmZe�rddlm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd
l*m+Z+ddlm,Z,ddlm-Z-e'e%e.e%e.fZ/dgZ0e�1e2�Z3dd�Z4ddd�Z5dd�Z6Gdd�de7�Z8Gdd�de9�Z:Gdd�de9�Z;e;�Z<Gdd�de9�Z=dS) z)Handles all VCS (version control) support�)�absolute_importN)�
pkg_resources)�parse)�
BadCommand)�samefile)�ask_path_exists�
backup_dir�display_path�hide_url�
hide_value�rmtree)�call_subprocess�make_command)�MYPY_CHECK_RUNNING)�get_url_scheme)
�Any�Dict�Iterable�List�Mapping�Optional�Text�Tuple�Type�Union)�SpinnerInterface)�
HiddenText)�CommandArgs�vcscCs*t|�}|dkrdS|ddddgtjkS)z3
    Return true if the name looks like a URL.
    NFZhttpZhttps�fileZftp)rr�all_schemes)�name�scheme�r#�D/usr/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py�is_url0sr%cCs.t�|�}d�|||�}|r*|d�|�7}|S)z�
    Return the URL for a VCS requirement.

    Args:
      repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+").
      project_name: the (unescaped) project name.
    z{}@{}#egg={}z&subdirectory={})rZto_filename�format)�repo_url�rev�project_name�subdirZegg_project_name�reqr#r#r$�make_vcs_requirement_url;s

r,cCs`|}tj�tj�|d��sD|}tj�|�}||krt�d|�dSqt||�rRdStj�||�S)z�
    Find the path to `setup.py` by searching up the filesystem from `location`.
    Return the path to `setup.py` relative to `repo_root`.
    Return None if `setup.py` is in `repo_root` or cannot be found.
    zsetup.pyzGCould not find setup.py for directory %s (tried all parent directories)N)	�os�path�exists�join�dirname�logger�warningr�relpath)�locationZ	repo_rootZ
orig_locationZ
last_locationr#r#r$�!find_path_to_setup_from_repo_rootKs�
r6c@seZdZdS)�RemoteNotFoundErrorN)�__name__�
__module__�__qualname__r#r#r#r$r7fsr7c@sFeZdZdZddd�Zdd�Zedd��Zd	d
�Zdd�Z	d
d�Z
dS)�
RevOptionsz�
    Encapsulates a VCS-specific revision to install, along with any VCS
    install options.

    Instances of this class should be treated as if immutable.
    NcCs(|dkrg}||_||_||_d|_dS)z�
        Args:
          vc_class: a VersionControl subclass.
          rev: the name of the revision to install.
          extra_args: a list of extra options.
        N)�
extra_argsr(�vc_classZbranch_name)�selfr=r(r<r#r#r$�__init__ss
zRevOptions.__init__cCsd�|jj|j�S)Nz<RevOptions {}: rev={!r}>)r&r=r!r(�r>r#r#r$�__repr__�szRevOptions.__repr__cCs|jdkr|jjS|jS�N)r(r=�default_arg_revr@r#r#r$�arg_rev�s
zRevOptions.arg_revcCs0g}|j}|dk	r"||j�|�7}||j7}|S)z<
        Return the VCS-specific command arguments.
        N)rDr=�get_base_rev_argsr<)r>�argsr(r#r#r$�to_args�s
zRevOptions.to_argscCs|js
dSd�|j�S)N�z (to revision {}))r(r&r@r#r#r$�
to_display�szRevOptions.to_displaycCs|jj||jd�S)z�
        Make a copy of the current instance, but with a new rev.

        Args:
          rev: the name of the revision for the new object.
        �r<)r=�make_rev_optionsr<)r>r(r#r#r$�make_new�szRevOptions.make_new)NN)r8r9r:�__doc__r?rA�propertyrDrGrIrLr#r#r#r$r;js
�


r;cs|eZdZiZddddddgZ�fdd�Zd	d
�Zedd��Zed
d��Z	edd��Z
dd�Zdd�Zdd�Z
dd�Z�ZS)�
VcsSupportZsshZgitZhgZbzrZsftpZsvncs:tj�|j�ttdd�r(tj�|j�tt|���dS)N�
uses_fragment)	�urllib_parseZuses_netloc�extend�schemes�getattrrP�superrOr?r@��	__class__r#r$r?�szVcsSupport.__init__cCs
|j��SrB)�	_registry�__iter__r@r#r#r$rY�szVcsSupport.__iter__cCst|j���SrB)�listrX�valuesr@r#r#r$�backends�szVcsSupport.backendscCsdd�|jD�S)NcSsg|]
}|j�qSr#)r1)�.0�backendr#r#r$�
<listcomp>�sz'VcsSupport.dirnames.<locals>.<listcomp>)r\r@r#r#r$�dirnames�szVcsSupport.dirnamescCs g}|jD]}|�|j�q
|SrB)r\rRrS)r>rSr^r#r#r$r �s
zVcsSupport.all_schemescCsHt|d�st�d|j�dS|j|jkrD|�|j|j<t�d|j�dS)Nr!zCannot register VCS %szRegistered VCS backend: %s)�hasattrr2r3r8r!rX�debug)r>�clsr#r#r$�register�s
zVcsSupport.registercCs||jkr|j|=dSrB)rX�r>r!r#r#r$�
unregister�s
zVcsSupport.unregistercCs6|j��D]&}|�|�r
t�d||j�|Sq
dS)zv
        Return a VersionControl object if a repository of that type is found
        at the given directory.
        zDetermine that %s uses VCS: %sN)rXr[�controls_locationr2rbr!)r>r5Zvcs_backendr#r#r$�get_backend_for_dir�s
�
zVcsSupport.get_backend_for_dircCs|��}|j�|�S)z9
        Return a VersionControl object or None.
        )�lowerrX�getrer#r#r$�get_backend�szVcsSupport.get_backend)r8r9r:rXrSr?rYrNr\r`r rdrfrhrk�
__classcell__r#r#rVr$rO�s



	
rOc	@s8eZdZdZdZdZdZdZdZe	dd��Z
e	dd��Ze	dd	��Ze	d
d��Z
edd
��Ze	d8dd��Ze	dd��Zdd�Ze	dd��Ze	dd��Zedd��Zdd�Zedd��Ze	dd��Zd d!�Zd"d#�Zd$d%�Ze	d&d'��Zd(d)�Zd*d+�Ze	d,d-��Ze	d.d/��Z e	d9d2d3��Z!e	d4d5��Z"e	d6d7��Z#dS):�VersionControlrHr#NcCs|���d�|j��S)z�
        Return whether the vcs prefix (e.g. "git+") should be added to a
        repository's remote url when used in a requirement.
        z{}:)ri�
startswithr&r!)rcZ
remote_urlr#r#r$�should_add_vcs_url_prefixsz(VersionControl.should_add_vcs_url_prefixcCsdS)z~
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        Nr#�rcr5r#r#r$�get_subdirectoryszVersionControl.get_subdirectorycCs
|�|�S)zR
        Return the revision string that should be used in a requirement.
        )�get_revision)rc�repo_dirr#r#r$�get_requirement_revisionsz'VersionControl.get_requirement_revisioncCsV|�|�}|dkrdS|�|�r.d�|j|�}|�|�}|�|�}t||||d�}|S)aC
        Return the requirement string to use to redownload the files
        currently at the given repository directory.

        Args:
          project_name: the (unescaped) project name.

        The return value has a form similar to the following:

            {repository_url}@{revision}#egg={project_name}
        Nz{}+{})r*)�get_remote_urlror&r!rtrqr,)rcrsr)r'Zrevisionr*r+r#r#r$�get_src_requirements



�z"VersionControl.get_src_requirementcCst�dS)z�
        Return the base revision arguments for a vcs command.

        Args:
          rev: the name of a revision to install.  Cannot be None.
        N��NotImplementedError)r(r#r#r$rE8sz VersionControl.get_base_rev_argscCst|||d�S)z�
        Return a RevOptions object.

        Args:
          rev: the name of a revision to install.
          extra_args: a list of extra options.
        rJ)r;)rcr(r<r#r#r$rKBs
zVersionControl.make_rev_optionscCs&tj�|�\}}|�tjj�p$t|�S)zy
           posix absolute paths start with os.path.sep,
           win32 ones start with drive (like c:\folder)
        )r-r.�
splitdrivern�sep�bool)rcZrepoZdrive�tailr#r#r$�_is_local_repositoryNsz#VersionControl._is_local_repositorycCst�dS)z�
        Export the repository at the url to the destination location
        i.e. only download the files, without vcs informations

        :param url: the repository URL starting with a vcs prefix.
        Nrw�r>r5�urlr#r#r$�exportXszVersionControl.exportcCs|dfS)aZ
        Parse the repository URL's netloc, and return the new netloc to use
        along with auth information.

        Args:
          netloc: the original repository URL netloc.
          scheme: the repository URL's scheme without the vcs prefix.

        This is mainly for the Subversion class to override, so that auth
        information can be provided via the --username and --password options
        instead of through the URL.  For other subclasses like Git without
        such an option, auth information must stay in the URL.

        Returns: (netloc, (username, password)).
        )NNr#)rc�netlocr"r#r#r$�get_netloc_and_authbsz"VersionControl.get_netloc_and_authc	Cs�t�|�\}}}}}d|kr*td�|���|�dd�d}|�||�\}}d}d|krf|�dd�\}}t�||||df�}|||fS)z�
        Parse the repository URL to use, and return the URL, revision,
        and auth info to use.

        Returns: (url, rev, (username, password)).
        �+zvSorry, {!r} is a malformed VCS url. The format is <vcs>+<protocol>://<url>, e.g. svn+http://myrepo/svn/MyApp#egg=MyApp�N�@rH)rQZurlsplit�
ValueErrorr&�splitr��rsplitZ
urlunsplit)	rcrr"r�r.ZqueryZfrag�	user_passr(r#r#r$�get_url_rev_and_authus	��z#VersionControl.get_url_rev_and_authcCsgS)zM
        Return the RevOptions "extra arguments" to use in obtain().
        r#)�username�passwordr#r#r$�
make_rev_args�szVersionControl.make_rev_argsc
CsT|�|j�\}}}|\}}d}|dk	r.t|�}|�||�}|j||d�}	t|�|	fS)z�
        Return the URL and RevOptions object to use in obtain() and in
        some cases export(), as a tuple (url, rev_options).
        NrJ)r��secretrr�rKr
)
r>rZ
secret_urlr(r�r�Zsecret_passwordr�r<�rev_optionsr#r#r$�get_url_rev_options�sz"VersionControl.get_url_rev_optionscCst�|��d�S)zi
        Normalize a URL for comparison by unquoting it and removing any
        trailing slash.
        �/)rQZunquote�rstrip�rr#r#r$�
normalize_url�szVersionControl.normalize_urlcCs|�|�|�|�kS)zV
        Compare two repo URLs for identity, ignoring incidental differences.
        )r�)rcZurl1Zurl2r#r#r$�compare_urls�szVersionControl.compare_urlscCst�dS)z�
        Fetch a revision from a repository, in the case that this is the
        first fetch from the repository.

        Args:
          dest: the directory to fetch the repository to.
          rev_options: a RevOptions object.
        Nrw�r>�destrr�r#r#r$�	fetch_new�s
zVersionControl.fetch_newcCst�dS)z}
        Switch the repo at ``dest`` to point to ``URL``.

        Args:
          rev_options: a RevOptions object.
        Nrwr�r#r#r$�switch�szVersionControl.switchcCst�dS)z�
        Update an already-existing repo to the given ``rev_options``.

        Args:
          rev_options: a RevOptions object.
        Nrwr�r#r#r$�update�szVersionControl.updatecCst�dS)z�
        Return whether the id of the current commit equals the given name.

        Args:
          dest: the repository directory.
          name: a string name.
        Nrw)rcr�r!r#r#r$�is_commit_id_equal�s	z!VersionControl.is_commit_id_equalc	Cs�|�|�\}}tj�|�s,|�|||�dS|��}|�|�r�|�|�}|�||j	�r�t
�d|j�
�t|�|�|�||j�s�t
�dt|�|j|�|�|||�n
t
�d�dSt
�d|j|jt|�|�d}nt
�d||j|j�d}t
�d	|j|�td
|d|d�}|d
k�r$t�d�|dk�rXt
�dt|��t|�|�|||�dS|dk�r�t|�}t
�dt|�|�t�||�|�|||�dS|dk�r�t
�d|jt|�||�|�|||�dS)a
        Install or update in editable mode the package represented by this
        VersionControl object.

        :param dest: the repository directory in which to install or update.
        :param url: the repository URL starting with a vcs prefix.
        Nz)%s in %s exists, and has correct URL (%s)zUpdating %s %s%sz$Skipping because already up-to-date.z%s %s in %s exists with URL %s)z%(s)witch, (i)gnore, (w)ipe, (b)ackup )�s�i�w�bz0Directory %s already exists, and is not a %s %s.)z(i)gnore, (w)ipe, (b)ackup )r�r�r�z+The plan is to install the %s repository %szWhat to do?  %srr��a���r�zDeleting %sr�zBacking up %s to %sr�zSwitching %s %s to %s%s)r�r-r.r/r�rI�is_repository_directoryrur�r�r2rb�	repo_name�titler	r�r(�infor�r3r!r�sys�exitrr�shutilZmover�)	r>r�rr�Zrev_displayZexisting_url�promptZresponseZdest_dirr#r#r$�obtain�s�	

��
���



�
�zVersionControl.obtaincCs&tj�|�rt|�|j||d�dS)z�
        Clean up current location and download the url repository
        (and vcs infos) into location

        :param url: the repository URL starting with a vcs prefix.
        r�N)r-r.r/rr�r~r#r#r$�unpack?szVersionControl.unpackcCst�dS)z�
        Return the url used at location

        Raises RemoteNotFoundError if the repository does not have a remote
        url configured.
        Nrwrpr#r#r$ruKszVersionControl.get_remote_urlcCst�dS)zR
        Return the current commit id of the files at the given location.
        Nrwrpr#r#r$rrUszVersionControl.get_revisionT�raisec
Cs|t|jf|��}z t||||||||j||	d�
WStk
rv}
z(|
jtjkrdtd|j|jf��n�W5d}
~
XYnXdS)z�
        Run a VCS subcommand
        This is simply a wrapper around call_subprocess that adds the VCS
        command name, and checks that the VCS is available
        )�
on_returncode�extra_ok_returncodes�command_desc�
extra_environ�
unset_environ�spinner�log_failed_cmdzCCannot find command %r - do you have %r installed and in your PATH?N)rr!r
r��OSError�errnoZENOENTr)rc�cmdZshow_stdout�cwdr�r�r�r�r�r��er#r#r$�run_command\s&�
��zVersionControl.run_commandcCs,t�d||j|j�tj�tj�||j��S)zL
        Return whether a directory path is a repository directory.
        zChecking in %s for %s (%s)...)r2rbr1r!r-r.r/r0)rcr.r#r#r$r��s�z&VersionControl.is_repository_directorycCs
|�|�S)a6
        Check if a location is controlled by the vcs.
        It is meant to be overridden to implement smarter detection
        mechanisms for specific vcs.

        This can do more than is_repository_directory() alone.  For example,
        the Git override checks that Git is actually available.
        )r�rpr#r#r$rg�sz VersionControl.controls_location)NN)TNr�NNNNT)$r8r9r:r!r1r�rSr�rC�classmethodrorqrtrv�staticmethodrErKr}r�r�r�r�r�r�r�r�r�r�r�r�r�rurrr�r�rgr#r#r#r$rm�sr




	
	









]
	
�'
	rm)N)>rMZ
__future__rr�Zloggingr-r�r�Zpip._vendorrZpip._vendor.six.moves.urllibrrQZpip._internal.exceptionsrZpip._internal.utils.compatrZpip._internal.utils.miscrrr	r
rrZpip._internal.utils.subprocessr
rZpip._internal.utils.typingrZpip._internal.utils.urlsr�typingrrrrrrrrrrZpip._internal.utils.uirrr�strZAuthInfo�__all__Z	getLoggerr8r2r%r,r6�	Exceptionr7�objectr;rOrrmr#r#r#r$�<module>s< 0

HGsite-packages/pip/_internal/vcs/__pycache__/subversion.cpython-38.pyc000064400000020447151446176770021712 0ustar00U

��.e0�@s�ddlmZddlZddlZddlZddlmZddlmZm	Z	m
Z
mZddlm
Z
ddlmZddlmZmZe�d�Ze�d	�Ze�d
�Ze�d�Zer�ddlmZmZdd
lmZddlmZddlmZmZe�e �Z!Gdd�de�Z"e�#e"�dS)�)�absolute_importN)�
indent_log)�display_path�is_console_interactive�rmtree�split_auth_from_netloc)�make_command)�MYPY_CHECK_RUNNING)�VersionControl�vcsz
url="([^"]+)"zcommitted-rev="(\d+)"z\s*revision="(\d+)"z<url>(.*)</url>)�Optional�Tuple)�CommandArgs)�
HiddenText)�AuthInfo�
RevOptionscs�eZdZdZdZdZdZedd��Ze	dd��Z
ed	d
��Ze�fdd��Ze�fd
d��Z
e	dd��Zedd��Zedd��Zedd��Zd(�fdd�	Zdd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Z�ZS))�
Subversion�svnz.svn�checkout)rzsvn+sshzsvn+httpz	svn+httpszsvn+svncCsdS)NT�)�clsZ
remote_urlrr�@/usr/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py�should_add_vcs_url_prefix+sz$Subversion.should_add_vcs_url_prefixcCsd|gS)Nz-rr)�revrrr�get_base_rev_args/szSubversion.get_base_rev_argsc	Cs�d}t�|�D]�\}}}|j|kr0g|dd�<q|�|j�tj�||jd�}tj�|�s\q|�|�\}}||kr||d}n|r�|�|�s�g|dd�<qt	||�}q|S)zR
        Return the maximum revision for all files under a given location
        rN�entries�/)
�os�walk�dirname�remove�path�join�exists�_get_svn_url_rev�
startswith�max)	r�locationZrevision�base�dirs�filesZ
entries_fnZdirurlZlocalrevrrr�get_revision3s"

zSubversion.get_revisioncs"|dkrtt|��||�St|�S)z�
        This override allows the auth information to be passed to svn via the
        --username and --password options instead of via the URL.
        Zssh)�superr�get_netloc_and_authr)rZnetlocZscheme��	__class__rrr-OszSubversion.get_netloc_and_authcs2tt|��|�\}}}|�d�r(d|}|||fS)Nzssh://zsvn+)r,r�get_url_rev_and_authr%)r�urlrZ	user_passr.rrr0\s
zSubversion.get_url_rev_and_authcCs(g}|r|d|g7}|r$|d|g7}|S)Nz
--usernamez
--passwordr)ZusernameZpasswordZ
extra_argsrrr�
make_rev_argseszSubversion.make_rev_argscCsR|}tj�tj�|d��sD|}tj�|�}||krt�d|�dSq|�|�dS)Nzsetup.pyzGCould not find setup.py for directory %s (tried all parent directories)r)rr!r#r"r�loggerZwarningr$)rr'Z
orig_locationZ
last_locationrrr�get_remote_urlps�zSubversion.get_remote_urlc	Cspddlm}tj�||jd�}tj�|�rHt|��}|��}W5QRXnd}|�	d�sj|�	d�sj|�	d�r�t
ttj
|�d���}|dd=|dd	}d
d�|D�dg}n�|�	d�r�t�|�}|s�td
|��|�d�}dd�t�|�D�dg}n^z<|jdd|gdd�}	t�|	��d�}dd�t�|	�D�}Wn |k
�rRdg}}YnX|�rdt|�}
nd}
||
fS)Nr)�InstallationErrorr��8�9Z10z

�cSs,g|]$}t|�dkr|drt|d��qS)�	)�len�int)�.0�drrr�
<listcomp>�sz/Subversion._get_svn_url_rev.<locals>.<listcomp>z<?xmlzBadly formatted data: %r�cSsg|]}t|�d���qS�r@�r<�group�r=�mrrrr?�s�infoz--xmlF�Zshow_stdoutcSsg|]}t|�d���qSrArBrDrrrr?�s)Zpip._internal.exceptionsr5rr!r"rr#�open�readr%�list�map�str�
splitlines�split�_svn_xml_url_re�search�
ValueErrorrC�_svn_rev_re�finditer�run_command�_svn_info_xml_url_re�_svn_info_xml_rev_rer&)rr'r5Zentries_path�f�datar1Zrevs�matchZxmlrrrrr$�sH

��



��

zSubversion._get_svn_url_revcCsdS)z&Always assume the versions don't matchFr)r�dest�namerrr�is_commit_id_equal�szSubversion.is_commit_id_equalNcs,|dkrt�}||_d|_tt|���dS)N)r�use_interactive�_vcs_versionr,r�__init__)�selfr]r.rrr_�s
zSubversion.__init__cCsrd}|jdgdd�}|�|�s"dS|t|�d���d}|�d�}zttt|��}Wntk
rlYdSX|S)	aQuery the version of the currently installed Subversion client.

        :return: A tuple containing the parts of the version information or
            ``()`` if the version returned from ``svn`` could not be parsed.
        :raises: BadCommand: If ``svn`` is not installed.
        z
svn, version z	--versionFrGrNr�.)rTr%r;rN�tuplerKr<rQ)r`Zversion_prefix�versionZversion_listZparsed_versionrrr�call_vcs_version�s


zSubversion.call_vcs_versioncCs"|jdk	r|jS|��}||_|S)a�Return the version of the currently installed Subversion client.

        If the version of the Subversion client has already been queried,
        a cached value will be used.

        :return: A tuple containing the parts of the version information or
            ``()`` if the version returned from ``svn`` could not be parsed.
        :raises: BadCommand: If ``svn`` is not installed.
        N)r^rd)r`Zvcs_versionrrr�get_vcs_version�s

zSubversion.get_vcs_versioncCs&|jsdgS|��}|dkr"dgSgS)aXReturn options to be used on calls to Subversion that contact the server.

        These options are applicable for the following ``svn`` subcommands used
        in this class.

            - checkout
            - export
            - switch
            - update

        :return: A list of command line arguments to pass to ``svn``.
        z--non-interactive)r@�z--force-interactive)r]re)r`Zsvn_versionrrr�get_remote_call_options�s	z"Subversion.get_remote_call_optionsc	Csl|�|�\}}t�d||�t��@tj�|�r8t|�td|�	�|�
�||�}|j|dd�W5QRXdS)z@Export the svn repository at the url to the destination locationz!Exporting svn repository %s to %s�exportFrGN)Zget_url_rev_optionsr3rFrrr!r#rrrg�to_argsrT)r`r'r1�rev_options�cmd_argsrrrrhs�zSubversion.exportcCsD|��}t�d||t|��tdd|��|��||�}|�|�dS)NzChecking out %s%s to %srz-q)Z
to_displayr3rFrrrgrirT)r`rZr1rjZrev_displayrkrrr�	fetch_new-s ��zSubversion.fetch_newcCs&td|��|��||�}|�|�dS)N�switch�rrgrirT�r`rZr1rjrkrrrrm<s�zSubversion.switchcCs$td|��|��|�}|�|�dS)N�updaternrorrrrpDs�zSubversion.update)N)�__name__�
__module__�__qualname__r[rZ	repo_nameZschemes�classmethodr�staticmethodrr+r-r0r2r4r$r\r_rdrergrhrlrmrp�
__classcell__rrr.rr%s<






1
!r)$Z
__future__rZloggingr�reZpip._internal.utils.loggingrZpip._internal.utils.miscrrrrZpip._internal.utils.subprocessrZpip._internal.utils.typingr	Z pip._internal.vcs.versioncontrolr
r�compilerOrRrVrU�typingrr
rrrrZ	getLoggerrqr3r�registerrrrr�<module>s,




*site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-38.pyc000064400000011430151446176770021466 0ustar00U

��.e��@s�ddlmZddlZddlZddlmZddlmZmZddl	m
Z
ddlmZddl
mZddlmZdd	lmZdd
lmZmZmZer�ddl	mZddlmZe�e�ZGd
d�de�Ze�e�dS)�)�absolute_importN)�configparser)�
BadCommand�InstallationError)�display_path)�make_command)�
TempDirectory)�MYPY_CHECK_RUNNING)�path_to_url)�VersionControl�!find_path_to_setup_from_repo_root�vcs)�
HiddenText)�
RevOptionscs�eZdZdZdZdZdZedd��Zdd�Z	d	d
�Z
dd�Zd
d�Ze
dd��Ze
dd��Ze
dd��Ze
dd��Ze
dd��Ze
�fdd��Z�ZS)�	Mercurial�hgz.hg�clone)rzhg+filezhg+httpzhg+httpszhg+sshzhg+static-httpcCs|gS)N�)Zrevrr�?/usr/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py�get_base_rev_args'szMercurial.get_base_rev_argsc	Cs@tdd��,}|j|j|d�|jd|gd|jd�W5QRXdS)z?Export the Hg repository at the url to the destination location�export)Zkind)�url�archiveF��show_stdout�cwdN)r�unpack�path�run_command)�self�locationrZtemp_dirrrrr+s�zMercurial.exportcCsP|��}t�d||t|��|�tddd||��|jtdd|���|d�dS)NzCloning hg %s%s to %srz
--noupdate�-q�update�r)Z
to_display�logger�inforrr�to_args)r�destr�rev_optionsZrev_displayrrr�	fetch_new5s��zMercurial.fetch_newc	
Cs�tj�||jd�}t��}z>|�|�|�dd|j�t	|d��}|�
|�W5QRXWn6ttjfk
r�}zt
�d||�W5d}~XYn Xtdd|���}|j||d�dS)	NZhgrc�paths�default�wz/Could not switch Mercurial repository to %s: %sr"r!r#)�osr�join�dirnamerZRawConfigParser�read�setZsecret�open�write�OSErrorZNoSectionErrorr$Zwarningrr&r)	rr'rr(Zrepo_configZconfigZconfig_file�exc�cmd_argsrrr�switchDs
�zMercurial.switchcCs4|jddg|d�tdd|���}|j||d�dS)NZpullr!r#r")rrr&)rr'rr(r6rrrr"UszMercurial.updatecCs2|jddgd|d���}|�|�r*t|�}|��S)NZ
showconfigz
paths.defaultFr)r�stripZ_is_local_repositoryr
)�clsr rrrr�get_remote_url[s�

zMercurial.get_remote_urlcCs|jddgd|d���}|S)zW
        Return the repository-local changeset revision number, as an integer.
        �parentsz--template={rev}Fr�rr8)r9r Zcurrent_revisionrrr�get_revisionds�
zMercurial.get_revisioncCs|jddgd|d���}|S)zh
        Return the changeset identification hash, as a 40-character
        hexadecimal string
        r;z--template={node}Frr<)r9r Zcurrent_rev_hashrrr�get_requirement_revisionns�
z"Mercurial.get_requirement_revisioncCsdS)z&Always assume the versions don't matchFr)r9r'�namerrr�is_commit_id_equalyszMercurial.is_commit_id_equalcCsB|jdgd|d���}tj�|�s8tj�tj�||��}t||�S)z~
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        �rootFr)rr8r-r�isabs�abspathr.r)r9r Z	repo_rootrrr�get_subdirectory~s�
zMercurial.get_subdirectoryc	sPtt|��|�rdSz|jdg|dddd�WdSttfk
rJYdSXdS)NTZidentifyF�raise)rrZ
on_returncodeZlog_failed_cmd)�superr�controls_locationrrr)r9r ��	__class__rrrG�s�zMercurial.controls_location)�__name__�
__module__�__qualname__r?r/Z	repo_nameZschemes�staticmethodrrr)r7r"�classmethodr:r=r>r@rDrG�
__classcell__rrrHrrs,



	



r)Z
__future__rZloggingr-Zpip._vendor.six.movesrZpip._internal.exceptionsrrZpip._internal.utils.miscrZpip._internal.utils.subprocessrZpip._internal.utils.temp_dirrZpip._internal.utils.typingr	Zpip._internal.utils.urlsr
Z pip._internal.vcs.versioncontrolrrr
rrZ	getLoggerrJr$r�registerrrrr�<module>s 
|site-packages/pip/_internal/vcs/__pycache__/subversion.cpython-38.opt-1.pyc000064400000020447151446176770022651 0ustar00U

��.e0�@s�ddlmZddlZddlZddlZddlmZddlmZm	Z	m
Z
mZddlm
Z
ddlmZddlmZmZe�d�Ze�d	�Ze�d
�Ze�d�Zer�ddlmZmZdd
lmZddlmZddlmZmZe�e �Z!Gdd�de�Z"e�#e"�dS)�)�absolute_importN)�
indent_log)�display_path�is_console_interactive�rmtree�split_auth_from_netloc)�make_command)�MYPY_CHECK_RUNNING)�VersionControl�vcsz
url="([^"]+)"zcommitted-rev="(\d+)"z\s*revision="(\d+)"z<url>(.*)</url>)�Optional�Tuple)�CommandArgs)�
HiddenText)�AuthInfo�
RevOptionscs�eZdZdZdZdZdZedd��Ze	dd��Z
ed	d
��Ze�fdd��Ze�fd
d��Z
e	dd��Zedd��Zedd��Zedd��Zd(�fdd�	Zdd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Z�ZS))�
Subversion�svnz.svn�checkout)rzsvn+sshzsvn+httpz	svn+httpszsvn+svncCsdS)NT�)�clsZ
remote_urlrr�@/usr/lib/python3.8/site-packages/pip/_internal/vcs/subversion.py�should_add_vcs_url_prefix+sz$Subversion.should_add_vcs_url_prefixcCsd|gS)Nz-rr)�revrrr�get_base_rev_args/szSubversion.get_base_rev_argsc	Cs�d}t�|�D]�\}}}|j|kr0g|dd�<q|�|j�tj�||jd�}tj�|�s\q|�|�\}}||kr||d}n|r�|�|�s�g|dd�<qt	||�}q|S)zR
        Return the maximum revision for all files under a given location
        rN�entries�/)
�os�walk�dirname�remove�path�join�exists�_get_svn_url_rev�
startswith�max)	r�locationZrevision�base�dirs�filesZ
entries_fnZdirurlZlocalrevrrr�get_revision3s"

zSubversion.get_revisioncs"|dkrtt|��||�St|�S)z�
        This override allows the auth information to be passed to svn via the
        --username and --password options instead of via the URL.
        Zssh)�superr�get_netloc_and_authr)rZnetlocZscheme��	__class__rrr-OszSubversion.get_netloc_and_authcs2tt|��|�\}}}|�d�r(d|}|||fS)Nzssh://zsvn+)r,r�get_url_rev_and_authr%)r�urlrZ	user_passr.rrr0\s
zSubversion.get_url_rev_and_authcCs(g}|r|d|g7}|r$|d|g7}|S)Nz
--usernamez
--passwordr)ZusernameZpasswordZ
extra_argsrrr�
make_rev_argseszSubversion.make_rev_argscCsR|}tj�tj�|d��sD|}tj�|�}||krt�d|�dSq|�|�dS)Nzsetup.pyzGCould not find setup.py for directory %s (tried all parent directories)r)rr!r#r"r�loggerZwarningr$)rr'Z
orig_locationZ
last_locationrrr�get_remote_urlps�zSubversion.get_remote_urlc	Cspddlm}tj�||jd�}tj�|�rHt|��}|��}W5QRXnd}|�	d�sj|�	d�sj|�	d�r�t
ttj
|�d���}|dd=|dd	}d
d�|D�dg}n�|�	d�r�t�|�}|s�td
|��|�d�}dd�t�|�D�dg}n^z<|jdd|gdd�}	t�|	��d�}dd�t�|	�D�}Wn |k
�rRdg}}YnX|�rdt|�}
nd}
||
fS)Nr)�InstallationErrorr��8�9Z10z

�cSs,g|]$}t|�dkr|drt|d��qS)�	)�len�int)�.0�drrr�
<listcomp>�sz/Subversion._get_svn_url_rev.<locals>.<listcomp>z<?xmlzBadly formatted data: %r�cSsg|]}t|�d���qS�r@�r<�group�r=�mrrrr?�s�infoz--xmlF�Zshow_stdoutcSsg|]}t|�d���qSrArBrDrrrr?�s)Zpip._internal.exceptionsr5rr!r"rr#�open�readr%�list�map�str�
splitlines�split�_svn_xml_url_re�search�
ValueErrorrC�_svn_rev_re�finditer�run_command�_svn_info_xml_url_re�_svn_info_xml_rev_rer&)rr'r5Zentries_path�f�datar1Zrevs�matchZxmlrrrrr$�sH

��



��

zSubversion._get_svn_url_revcCsdS)z&Always assume the versions don't matchFr)r�dest�namerrr�is_commit_id_equal�szSubversion.is_commit_id_equalNcs,|dkrt�}||_d|_tt|���dS)N)r�use_interactive�_vcs_versionr,r�__init__)�selfr]r.rrr_�s
zSubversion.__init__cCsrd}|jdgdd�}|�|�s"dS|t|�d���d}|�d�}zttt|��}Wntk
rlYdSX|S)	aQuery the version of the currently installed Subversion client.

        :return: A tuple containing the parts of the version information or
            ``()`` if the version returned from ``svn`` could not be parsed.
        :raises: BadCommand: If ``svn`` is not installed.
        z
svn, version z	--versionFrGrNr�.)rTr%r;rN�tuplerKr<rQ)r`Zversion_prefix�versionZversion_listZparsed_versionrrr�call_vcs_version�s


zSubversion.call_vcs_versioncCs"|jdk	r|jS|��}||_|S)a�Return the version of the currently installed Subversion client.

        If the version of the Subversion client has already been queried,
        a cached value will be used.

        :return: A tuple containing the parts of the version information or
            ``()`` if the version returned from ``svn`` could not be parsed.
        :raises: BadCommand: If ``svn`` is not installed.
        N)r^rd)r`Zvcs_versionrrr�get_vcs_version�s

zSubversion.get_vcs_versioncCs&|jsdgS|��}|dkr"dgSgS)aXReturn options to be used on calls to Subversion that contact the server.

        These options are applicable for the following ``svn`` subcommands used
        in this class.

            - checkout
            - export
            - switch
            - update

        :return: A list of command line arguments to pass to ``svn``.
        z--non-interactive)r@�z--force-interactive)r]re)r`Zsvn_versionrrr�get_remote_call_options�s	z"Subversion.get_remote_call_optionsc	Csl|�|�\}}t�d||�t��@tj�|�r8t|�td|�	�|�
�||�}|j|dd�W5QRXdS)z@Export the svn repository at the url to the destination locationz!Exporting svn repository %s to %s�exportFrGN)Zget_url_rev_optionsr3rFrrr!r#rrrg�to_argsrT)r`r'r1�rev_options�cmd_argsrrrrhs�zSubversion.exportcCsD|��}t�d||t|��tdd|��|��||�}|�|�dS)NzChecking out %s%s to %srz-q)Z
to_displayr3rFrrrgrirT)r`rZr1rjZrev_displayrkrrr�	fetch_new-s ��zSubversion.fetch_newcCs&td|��|��||�}|�|�dS)N�switch�rrgrirT�r`rZr1rjrkrrrrm<s�zSubversion.switchcCs$td|��|��|�}|�|�dS)N�updaternrorrrrpDs�zSubversion.update)N)�__name__�
__module__�__qualname__r[rZ	repo_nameZschemes�classmethodr�staticmethodrr+r-r0r2r4r$r\r_rdrergrhrlrmrp�
__classcell__rrr.rr%s<






1
!r)$Z
__future__rZloggingr�reZpip._internal.utils.loggingrZpip._internal.utils.miscrrrrZpip._internal.utils.subprocessrZpip._internal.utils.typingr	Z pip._internal.vcs.versioncontrolr
r�compilerOrRrVrU�typingrr
rrrrZ	getLoggerrqr3r�registerrrrr�<module>s,




*site-packages/pip/_internal/vcs/__pycache__/bazaar.cpython-38.pyc000064400000007243151446176770020752 0ustar00U

��.eu�@s�ddlmZddlZddlZddlmZddlmZm	Z	ddl
mZddlm
Z
ddlmZddlmZmZe
r�dd	lmZmZdd
lmZddlmZmZe�e�ZGdd
�d
e�Ze�e�dS)�)�absolute_importN)�parse)�display_path�rmtree)�make_command)�MYPY_CHECK_RUNNING)�path_to_url)�VersionControl�vcs)�Optional�Tuple)�
HiddenText)�AuthInfo�
RevOptionscs�eZdZdZdZdZdZ�fdd�Zedd��Z	d	d
�Z
dd�Zd
d�Zdd�Z
e�fdd��Zedd��Zedd��Zedd��Z�ZS)�Bazaar�bzrz.bzr�branch)rzbzr+httpz	bzr+httpszbzr+sshzbzr+sftpzbzr+ftpzbzr+lpcs0tt|�j||�ttdd�r,tj�dg�dS)N�
uses_fragmentZlp)�superr�__init__�getattr�urllib_parser�extend)�self�args�kwargs��	__class__��</usr/lib/python3.8/site-packages/pip/_internal/vcs/bazaar.pyr#szBazaar.__init__cCsd|gS)Nz-rr)�revrrr�get_base_rev_args*szBazaar.get_base_rev_argscCsBtj�|�rt|�|�|�\}}|jtd|||���dd�dS)zU
        Export the Bazaar repository at the url to the destination location
        �exportF)�show_stdoutN)�os�path�existsrZget_url_rev_options�run_commandr�to_args)r�location�url�rev_optionsrrrr".s�z
Bazaar.exportcCs>|��}t�d||t|��tdd|��||�}|�|�dS)NzChecking out %s%s to %sr�-q)Z
to_display�logger�inforrr(r')r�destr*r+Zrev_display�cmd_argsrrr�	fetch_new=s��zBazaar.fetch_newcCs|jtd|�|d�dS)N�switch��cwd)r'r)rr/r*r+rrrr2Ksz
Bazaar.switchcCs"tdd|���}|j||d�dS)NZpullr,r3)rr(r')rr/r*r+r0rrr�updateOsz
Bazaar.updatecs2tt|��|�\}}}|�d�r(d|}|||fS)Nzssh://zbzr+)rr�get_url_rev_and_auth�
startswith)�clsr*r Z	user_passrrrr6Ts
zBazaar.get_url_rev_and_authcCst|jdgd|d�}|��D]T}|��}dD]B}|�|�r*|�|�d}|�|�r`t|�S|Sq*qdS)Nr.F�r#r4)zcheckout of branch: zparent branch: �)r'�
splitlines�stripr7�splitZ_is_local_repositoryr)r8r)Zurls�line�xZreporrr�get_remote_url]s

zBazaar.get_remote_urlcCs|jdgd|d�}|��dS)NZrevnoFr9���)r'r;)r8r)Zrevisionrrr�get_revisionks�zBazaar.get_revisioncCsdS)z&Always assume the versions don't matchFr)r8r/�namerrr�is_commit_id_equalrszBazaar.is_commit_id_equal)�__name__�
__module__�__qualname__rC�dirnameZ	repo_nameZschemesr�staticmethodr!r"r1r2r5�classmethodr6r@rBrD�
__classcell__rrrrrs&



r)Z
__future__rZloggingr$Zpip._vendor.six.moves.urllibrrZpip._internal.utils.miscrrZpip._internal.utils.subprocessrZpip._internal.utils.typingrZpip._internal.utils.urlsrZ pip._internal.vcs.versioncontrolr	r
�typingrrr
rrZ	getLoggerrEr-r�registerrrrr�<module>s
^site-packages/pip/_internal/vcs/__pycache__/mercurial.cpython-38.opt-1.pyc000064400000011430151446176770022425 0ustar00U

��.e��@s�ddlmZddlZddlZddlmZddlmZmZddl	m
Z
ddlmZddl
mZddlmZdd	lmZdd
lmZmZmZer�ddl	mZddlmZe�e�ZGd
d�de�Ze�e�dS)�)�absolute_importN)�configparser)�
BadCommand�InstallationError)�display_path)�make_command)�
TempDirectory)�MYPY_CHECK_RUNNING)�path_to_url)�VersionControl�!find_path_to_setup_from_repo_root�vcs)�
HiddenText)�
RevOptionscs�eZdZdZdZdZdZedd��Zdd�Z	d	d
�Z
dd�Zd
d�Ze
dd��Ze
dd��Ze
dd��Ze
dd��Ze
dd��Ze
�fdd��Z�ZS)�	Mercurial�hgz.hg�clone)rzhg+filezhg+httpzhg+httpszhg+sshzhg+static-httpcCs|gS)N�)Zrevrr�?/usr/lib/python3.8/site-packages/pip/_internal/vcs/mercurial.py�get_base_rev_args'szMercurial.get_base_rev_argsc	Cs@tdd��,}|j|j|d�|jd|gd|jd�W5QRXdS)z?Export the Hg repository at the url to the destination location�export)Zkind)�url�archiveF��show_stdout�cwdN)r�unpack�path�run_command)�self�locationrZtemp_dirrrrr+s�zMercurial.exportcCsP|��}t�d||t|��|�tddd||��|jtdd|���|d�dS)NzCloning hg %s%s to %srz
--noupdate�-q�update�r)Z
to_display�logger�inforrr�to_args)r�destr�rev_optionsZrev_displayrrr�	fetch_new5s��zMercurial.fetch_newc	
Cs�tj�||jd�}t��}z>|�|�|�dd|j�t	|d��}|�
|�W5QRXWn6ttjfk
r�}zt
�d||�W5d}~XYn Xtdd|���}|j||d�dS)	NZhgrc�paths�default�wz/Could not switch Mercurial repository to %s: %sr"r!r#)�osr�join�dirnamerZRawConfigParser�read�setZsecret�open�write�OSErrorZNoSectionErrorr$Zwarningrr&r)	rr'rr(Zrepo_configZconfigZconfig_file�exc�cmd_argsrrr�switchDs
�zMercurial.switchcCs4|jddg|d�tdd|���}|j||d�dS)NZpullr!r#r")rrr&)rr'rr(r6rrrr"UszMercurial.updatecCs2|jddgd|d���}|�|�r*t|�}|��S)NZ
showconfigz
paths.defaultFr)r�stripZ_is_local_repositoryr
)�clsr rrrr�get_remote_url[s�

zMercurial.get_remote_urlcCs|jddgd|d���}|S)zW
        Return the repository-local changeset revision number, as an integer.
        �parentsz--template={rev}Fr�rr8)r9r Zcurrent_revisionrrr�get_revisionds�
zMercurial.get_revisioncCs|jddgd|d���}|S)zh
        Return the changeset identification hash, as a 40-character
        hexadecimal string
        r;z--template={node}Frr<)r9r Zcurrent_rev_hashrrr�get_requirement_revisionns�
z"Mercurial.get_requirement_revisioncCsdS)z&Always assume the versions don't matchFr)r9r'�namerrr�is_commit_id_equalyszMercurial.is_commit_id_equalcCsB|jdgd|d���}tj�|�s8tj�tj�||��}t||�S)z~
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        �rootFr)rr8r-r�isabs�abspathr.r)r9r Z	repo_rootrrr�get_subdirectory~s�
zMercurial.get_subdirectoryc	sPtt|��|�rdSz|jdg|dddd�WdSttfk
rJYdSXdS)NTZidentifyF�raise)rrZ
on_returncodeZlog_failed_cmd)�superr�controls_locationrrr)r9r ��	__class__rrrG�s�zMercurial.controls_location)�__name__�
__module__�__qualname__r?r/Z	repo_nameZschemes�staticmethodrrr)r7r"�classmethodr:r=r>r@rDrG�
__classcell__rrrHrrs,



	



r)Z
__future__rZloggingr-Zpip._vendor.six.movesrZpip._internal.exceptionsrrZpip._internal.utils.miscrZpip._internal.utils.subprocessrZpip._internal.utils.temp_dirrZpip._internal.utils.typingr	Zpip._internal.utils.urlsr
Z pip._internal.vcs.versioncontrolrrr
rrZ	getLoggerrJr$r�registerrrrr�<module>s 
|site-packages/pip/_internal/vcs/__pycache__/__init__.cpython-38.pyc000064400000000700151446176770021240 0ustar00U

��.ei�@s<ddlZddlZddlZddlZddlmZmZmZm	Z	dS)�N)�RemoteNotFoundError�is_url�make_vcs_requirement_url�vcs)
Zpip._internal.vcs.bazaarZpipZpip._internal.vcs.gitZpip._internal.vcs.mercurialZpip._internal.vcs.subversionZ pip._internal.vcs.versioncontrolrrrr�rr�>/usr/lib/python3.8/site-packages/pip/_internal/vcs/__init__.py�<module>ssite-packages/pip/_internal/vcs/__pycache__/git.cpython-38.pyc000064400000022005151446176770020266 0ustar00U

��.e5�@sddlmZddlZddlZddlZddlmZddl	mZ
ddl	mZddl
mZddlmZddlmZddlmZdd	lmZdd
lmZmZmZmZer�ddlmZmZddlmZdd
lm Z m!Z!e
j"Z"e
j#Z#e�$e%�Z&e�'d�Z(dd�Z)Gdd�de�Z*e�+e*�dS)�)�absolute_importN)�parse)�request)�
BadCommand)�display_path)�make_command)�
TempDirectory)�MYPY_CHECK_RUNNING)�RemoteNotFoundError�VersionControl�!find_path_to_setup_from_repo_root�vcs)�Optional�Tuple)�
HiddenText)�AuthInfo�
RevOptionsz^[a-fA-F0-9]{40}$cCstt�|��S�N)�bool�
HASH_REGEX�match)�sha�r�9/usr/lib/python3.8/site-packages/pip/_internal/vcs/git.py�looks_like_hash*srcs�eZdZdZdZdZdZdZdZe	dd��Z
d	d
�Zedd��Z
d
d�Zedd��Zedd��Zedd��Zdd�Zdd�Zdd�Zedd��Zed(dd��Zed d!��Ze�fd"d#��Zed$d%��Ze�fd&d'��Z�ZS))�Git�gitz.git�clone)rzgit+httpz	git+httpszgit+sshzgit+gitzgit+file)ZGIT_DIRZ
GIT_WORK_TREE�HEADcCs|gSrr��revrrr�get_base_rev_args:szGit.get_base_rev_argscCs\d}|jdgdd�}|�|�r8|t|�d���d}nd}d�|�d�dd��}t|�S)	Nzgit version �versionF)�show_stdoutr��.�)�run_command�
startswith�len�split�join�
parse_version)�selfZVERSION_PFXr"rrr�get_git_version>s
zGit.get_git_versioncCsBdddg}|j|dd|d�}|��}|�d�r>|td�d�SdS)	zl
        Return the current branch, or None if HEAD isn't at a branch
        (e.g. detached HEAD).
        zsymbolic-ref�-qr��F�Zextra_ok_returncodesr#�cwdzrefs/heads/N)r'�stripr(r))�cls�location�args�output�refrrr�get_current_branchKs

�
zGit.get_current_branchc	CsX|�d�s|d}tdd��2}|j|j|d�|jdddd|gd	|jd
�W5QRXdS)z@Export the Git repository at the url to the destination location�/�export)Zkind)�urlzcheckout-indexz-az-fz--prefixF�r#r3N)�endswithr�unpack�pathr')r-r6r=Ztemp_dirrrrr<`s
�z
Git.exportc
	Cs�|jd|g|ddd�}i}|���d�D]V}|�d�}|s<q(z|jddd	�\}}Wn"tk
rttd
�|���YnX|||<q(d�|�}d�|�}	|�|�}|d
k	r�|dfS|�|	�}|dfS)z�
        Return (sha_or_none, is_branch), where sha_or_none is a commit hash
        if the revision names a remote branch or tag, otherwise None.

        Args:
          dest: the repository directory.
          rev: the revision name.
        zshow-refF�ignore)r3r#�
on_returncode�
�
� �)�maxsplitzunexpected show-ref line: {!r}zrefs/remotes/origin/{}zrefs/tags/{}NT)r'r4r*�rstrip�
ValueError�format�get)
r5�destr r8Zrefs�linerr9Z
branch_refZtag_refrrr�get_revision_shams*�





zGit.get_revision_shacCs�|j}|dk	st�|�||�\}}|dk	rF|�|�}|r<|nd|_|St|�sZt�d|�|�d�sh|S|j	t
dd||���|d�|j|dd�}|�|�}|S)	z�
        Resolve a revision to a new RevOptions object with the SHA1 of the
        branch, tag, or ref if found.

        Args:
          rev_options: a RevOptions object.
        Nz:Did not find branch or tag '%s', assuming revision or ref.zrefs/�fetchr/�r3Z
FETCH_HEADr)
Zarg_rev�AssertionErrorrOZmake_new�branch_namer�loggerZwarningr(r'r�to_args�get_revision)r5rMr=�rev_optionsr rZ	is_branchrrr�resolve_revision�s*

�
�
zGit.resolve_revisioncCs|sdS|�|�|kS)z�
        Return whether the current commit hash equals the given name.

        Args:
          dest: the repository directory.
          name: a string name.
        F)rV)r5rM�namerrr�is_commit_id_equal�s	zGit.is_commit_id_equalcCs�|��}t�d||t|��|�tdd||��|jr�|�|||�}t|dd�}|dkr�|�	||j�s�tdd|�
��}|j||d�n4|�|�|kr�d�|�}dd|d	|g}|j||d�|�
|�dS)
NzCloning %s%s to %srr/rS�checkoutrQz	origin/{}z-bz--track)Z
to_displayrT�inforr'rr rX�getattrrZrUr:rK�update_submodules)r-rMr=rWZrev_displayrS�cmd_argsZtrack_branchrrr�	fetch_new�s0�
�z
Git.fetch_newcCsB|jtdd|�|d�tdd|���}|j||d�|�|�dS)N�configzremote.origin.urlrQr[r/)r'rrUr^�r-rMr=rWr_rrr�switch�s
�z
Git.switchcCst|��td�kr&|jdddg|d�n|jddg|d�|�|||�}tddd|���}|j||d�|�|�dS)Nz1.9.0rPr/z--tagsrQ�resetz--hard)r.r,r'rXrrUr^rbrrr�update�sz
Git.updatecCsx|jdddgdd|d�}|��}z|d}Wntk
rDt�YnX|D]}|�d�rJ|}qbqJ|�d	�d
}|��S)z�
        Return URL of the first remote encountered.

        Raises RemoteNotFoundError if the repository does not have a remote
        url configured.
        raz--get-regexpzremote\..*\.urlr0Fr2rzremote.origin.url rFr1)r'�
splitlines�
IndexErrorr
r(r*r4)r5r6�stdoutZremotesZfound_remoteZremoter=rrr�get_remote_url
s"
�

zGit.get_remote_urlNcCs(|dkrd}|jd|gd|d�}|��S)Nr�	rev-parseFr>)r'r4)r5r6r Zcurrent_revrrrrV%s�zGit.get_revisioncCsR|jddgd|d���}tj�|�s2tj�||�}tj�tj�|d��}t||�S)z~
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        rjz	--git-dirFr>z..)r'r4�osrA�isabsr+�abspathr)r5r6Zgit_dirZ	repo_rootrrr�get_subdirectory.s�
zGit.get_subdirectorycs�t|�\}}}}}|�d�r�|dt|�d���}|t�|��dd��d�}t|||||f�}|�d�d}	|d|	�t||	d�||||f�}d|kr�d|ks�t	�|�d	d
�}t
t|��|�\}}
}|�dd�}nt
t|��|�\}}
}||
|fS)
a9
        Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'.
        That's required because although they use SSH they sometimes don't
        work with a ssh:// scheme (e.g. GitHub). But we need a scheme for
        parsing. Hence we remove it again afterwards and return it as a stub.
        �fileNr;�\�+r1z://zfile:zgit+z
git+ssh://zssh://r$)
�urlsplitr?r)�lstrip�urllib_requestZurl2pathname�replace�
urlunsplit�findrR�superr�get_url_rev_and_auth)r5r=ZschemeZnetlocrAZqueryZfragment�initial_slashes�newpathZ
after_plusr Z	user_pass��	__class__rrry=s0

�����zGit.get_url_rev_and_authcCs6tj�tj�|d��sdS|jdddddg|d�dS)Nz.gitmodulesZ	submodulerez--initz--recursiver/rQ)rkrA�existsr+r')r5r6rrrr^`s�zGit.update_submodulescsZtt|��|�rdSz|jdg|dddd�}|WStk
rTt�d|�YdSXdS)NTrjFrB)r3r#rCZlog_failed_cmdzKcould not determine if %s is under git control because git is not available)rxr�controls_locationr'rrT�debug)r5r6�rr|rrris��zGit.controls_location)N)�__name__�
__module__�__qualname__rY�dirnameZ	repo_nameZschemesZ
unset_environZdefault_arg_rev�staticmethodr!r.�classmethodr:r<rOrXrZr`rcrerirVrnryr^r�
__classcell__rrr|rr.sB




(
,


"
r),Z
__future__rZloggingZos.pathrk�reZpip._vendor.packaging.versionrr,Zpip._vendor.six.moves.urllibZurllib_parserrtZpip._internal.exceptionsrZpip._internal.utils.miscrZpip._internal.utils.subprocessrZpip._internal.utils.temp_dirrZpip._internal.utils.typingr	Z pip._internal.vcs.versioncontrolr
rrr
�typingrrrrrrrrvZ	getLoggerr�rT�compilerrr�registerrrrr�<module>s2

Nsite-packages/pip/_internal/vcs/__pycache__/versioncontrol.cpython-38.opt-1.pyc000064400000044035151446176770023537 0ustar00U

��.e~S�@s�dZddlmZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddl
mZddlmZddlmZmZmZmZmZmZdd	lmZmZdd
lmZddlmZe�rddlm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd
l*m+Z+ddlm,Z,ddlm-Z-e'e%e.e%e.fZ/dgZ0e�1e2�Z3dd�Z4ddd�Z5dd�Z6Gdd�de7�Z8Gdd�de9�Z:Gdd�de9�Z;e;�Z<Gdd�de9�Z=dS) z)Handles all VCS (version control) support�)�absolute_importN)�
pkg_resources)�parse)�
BadCommand)�samefile)�ask_path_exists�
backup_dir�display_path�hide_url�
hide_value�rmtree)�call_subprocess�make_command)�MYPY_CHECK_RUNNING)�get_url_scheme)
�Any�Dict�Iterable�List�Mapping�Optional�Text�Tuple�Type�Union)�SpinnerInterface)�
HiddenText)�CommandArgs�vcscCs*t|�}|dkrdS|ddddgtjkS)z3
    Return true if the name looks like a URL.
    NFZhttpZhttps�fileZftp)rr�all_schemes)�name�scheme�r#�D/usr/lib/python3.8/site-packages/pip/_internal/vcs/versioncontrol.py�is_url0sr%cCs.t�|�}d�|||�}|r*|d�|�7}|S)z�
    Return the URL for a VCS requirement.

    Args:
      repo_url: the remote VCS url, with any needed VCS prefix (e.g. "git+").
      project_name: the (unescaped) project name.
    z{}@{}#egg={}z&subdirectory={})rZto_filename�format)�repo_url�rev�project_name�subdirZegg_project_name�reqr#r#r$�make_vcs_requirement_url;s

r,cCs`|}tj�tj�|d��sD|}tj�|�}||krt�d|�dSqt||�rRdStj�||�S)z�
    Find the path to `setup.py` by searching up the filesystem from `location`.
    Return the path to `setup.py` relative to `repo_root`.
    Return None if `setup.py` is in `repo_root` or cannot be found.
    zsetup.pyzGCould not find setup.py for directory %s (tried all parent directories)N)	�os�path�exists�join�dirname�logger�warningr�relpath)�locationZ	repo_rootZ
orig_locationZ
last_locationr#r#r$�!find_path_to_setup_from_repo_rootKs�
r6c@seZdZdS)�RemoteNotFoundErrorN)�__name__�
__module__�__qualname__r#r#r#r$r7fsr7c@sFeZdZdZddd�Zdd�Zedd��Zd	d
�Zdd�Z	d
d�Z
dS)�
RevOptionsz�
    Encapsulates a VCS-specific revision to install, along with any VCS
    install options.

    Instances of this class should be treated as if immutable.
    NcCs(|dkrg}||_||_||_d|_dS)z�
        Args:
          vc_class: a VersionControl subclass.
          rev: the name of the revision to install.
          extra_args: a list of extra options.
        N)�
extra_argsr(�vc_classZbranch_name)�selfr=r(r<r#r#r$�__init__ss
zRevOptions.__init__cCsd�|jj|j�S)Nz<RevOptions {}: rev={!r}>)r&r=r!r(�r>r#r#r$�__repr__�szRevOptions.__repr__cCs|jdkr|jjS|jS�N)r(r=�default_arg_revr@r#r#r$�arg_rev�s
zRevOptions.arg_revcCs0g}|j}|dk	r"||j�|�7}||j7}|S)z<
        Return the VCS-specific command arguments.
        N)rDr=�get_base_rev_argsr<)r>�argsr(r#r#r$�to_args�s
zRevOptions.to_argscCs|js
dSd�|j�S)N�z (to revision {}))r(r&r@r#r#r$�
to_display�szRevOptions.to_displaycCs|jj||jd�S)z�
        Make a copy of the current instance, but with a new rev.

        Args:
          rev: the name of the revision for the new object.
        �r<)r=�make_rev_optionsr<)r>r(r#r#r$�make_new�szRevOptions.make_new)NN)r8r9r:�__doc__r?rA�propertyrDrGrIrLr#r#r#r$r;js
�


r;cs|eZdZiZddddddgZ�fdd�Zd	d
�Zedd��Zed
d��Z	edd��Z
dd�Zdd�Zdd�Z
dd�Z�ZS)�
VcsSupportZsshZgitZhgZbzrZsftpZsvncs:tj�|j�ttdd�r(tj�|j�tt|���dS)N�
uses_fragment)	�urllib_parseZuses_netloc�extend�schemes�getattrrP�superrOr?r@��	__class__r#r$r?�szVcsSupport.__init__cCs
|j��SrB)�	_registry�__iter__r@r#r#r$rY�szVcsSupport.__iter__cCst|j���SrB)�listrX�valuesr@r#r#r$�backends�szVcsSupport.backendscCsdd�|jD�S)NcSsg|]
}|j�qSr#)r1)�.0�backendr#r#r$�
<listcomp>�sz'VcsSupport.dirnames.<locals>.<listcomp>)r\r@r#r#r$�dirnames�szVcsSupport.dirnamescCs g}|jD]}|�|j�q
|SrB)r\rRrS)r>rSr^r#r#r$r �s
zVcsSupport.all_schemescCsHt|d�st�d|j�dS|j|jkrD|�|j|j<t�d|j�dS)Nr!zCannot register VCS %szRegistered VCS backend: %s)�hasattrr2r3r8r!rX�debug)r>�clsr#r#r$�register�s
zVcsSupport.registercCs||jkr|j|=dSrB)rX�r>r!r#r#r$�
unregister�s
zVcsSupport.unregistercCs6|j��D]&}|�|�r
t�d||j�|Sq
dS)zv
        Return a VersionControl object if a repository of that type is found
        at the given directory.
        zDetermine that %s uses VCS: %sN)rXr[�controls_locationr2rbr!)r>r5Zvcs_backendr#r#r$�get_backend_for_dir�s
�
zVcsSupport.get_backend_for_dircCs|��}|j�|�S)z9
        Return a VersionControl object or None.
        )�lowerrX�getrer#r#r$�get_backend�szVcsSupport.get_backend)r8r9r:rXrSr?rYrNr\r`r rdrfrhrk�
__classcell__r#r#rVr$rO�s



	
rOc	@s8eZdZdZdZdZdZdZdZe	dd��Z
e	dd��Ze	dd	��Ze	d
d��Z
edd
��Ze	d8dd��Ze	dd��Zdd�Ze	dd��Ze	dd��Zedd��Zdd�Zedd��Ze	dd��Zd d!�Zd"d#�Zd$d%�Ze	d&d'��Zd(d)�Zd*d+�Ze	d,d-��Ze	d.d/��Z e	d9d2d3��Z!e	d4d5��Z"e	d6d7��Z#dS):�VersionControlrHr#NcCs|���d�|j��S)z�
        Return whether the vcs prefix (e.g. "git+") should be added to a
        repository's remote url when used in a requirement.
        z{}:)ri�
startswithr&r!)rcZ
remote_urlr#r#r$�should_add_vcs_url_prefixsz(VersionControl.should_add_vcs_url_prefixcCsdS)z~
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        Nr#�rcr5r#r#r$�get_subdirectoryszVersionControl.get_subdirectorycCs
|�|�S)zR
        Return the revision string that should be used in a requirement.
        )�get_revision)rc�repo_dirr#r#r$�get_requirement_revisionsz'VersionControl.get_requirement_revisioncCsV|�|�}|dkrdS|�|�r.d�|j|�}|�|�}|�|�}t||||d�}|S)aC
        Return the requirement string to use to redownload the files
        currently at the given repository directory.

        Args:
          project_name: the (unescaped) project name.

        The return value has a form similar to the following:

            {repository_url}@{revision}#egg={project_name}
        Nz{}+{})r*)�get_remote_urlror&r!rtrqr,)rcrsr)r'Zrevisionr*r+r#r#r$�get_src_requirements



�z"VersionControl.get_src_requirementcCst�dS)z�
        Return the base revision arguments for a vcs command.

        Args:
          rev: the name of a revision to install.  Cannot be None.
        N��NotImplementedError)r(r#r#r$rE8sz VersionControl.get_base_rev_argscCst|||d�S)z�
        Return a RevOptions object.

        Args:
          rev: the name of a revision to install.
          extra_args: a list of extra options.
        rJ)r;)rcr(r<r#r#r$rKBs
zVersionControl.make_rev_optionscCs&tj�|�\}}|�tjj�p$t|�S)zy
           posix absolute paths start with os.path.sep,
           win32 ones start with drive (like c:\folder)
        )r-r.�
splitdrivern�sep�bool)rcZrepoZdrive�tailr#r#r$�_is_local_repositoryNsz#VersionControl._is_local_repositorycCst�dS)z�
        Export the repository at the url to the destination location
        i.e. only download the files, without vcs informations

        :param url: the repository URL starting with a vcs prefix.
        Nrw�r>r5�urlr#r#r$�exportXszVersionControl.exportcCs|dfS)aZ
        Parse the repository URL's netloc, and return the new netloc to use
        along with auth information.

        Args:
          netloc: the original repository URL netloc.
          scheme: the repository URL's scheme without the vcs prefix.

        This is mainly for the Subversion class to override, so that auth
        information can be provided via the --username and --password options
        instead of through the URL.  For other subclasses like Git without
        such an option, auth information must stay in the URL.

        Returns: (netloc, (username, password)).
        )NNr#)rc�netlocr"r#r#r$�get_netloc_and_authbsz"VersionControl.get_netloc_and_authc	Cs�t�|�\}}}}}d|kr*td�|���|�dd�d}|�||�\}}d}d|krf|�dd�\}}t�||||df�}|||fS)z�
        Parse the repository URL to use, and return the URL, revision,
        and auth info to use.

        Returns: (url, rev, (username, password)).
        �+zvSorry, {!r} is a malformed VCS url. The format is <vcs>+<protocol>://<url>, e.g. svn+http://myrepo/svn/MyApp#egg=MyApp�N�@rH)rQZurlsplit�
ValueErrorr&�splitr��rsplitZ
urlunsplit)	rcrr"r�r.ZqueryZfrag�	user_passr(r#r#r$�get_url_rev_and_authus	��z#VersionControl.get_url_rev_and_authcCsgS)zM
        Return the RevOptions "extra arguments" to use in obtain().
        r#)�username�passwordr#r#r$�
make_rev_args�szVersionControl.make_rev_argsc
CsT|�|j�\}}}|\}}d}|dk	r.t|�}|�||�}|j||d�}	t|�|	fS)z�
        Return the URL and RevOptions object to use in obtain() and in
        some cases export(), as a tuple (url, rev_options).
        NrJ)r��secretrr�rKr
)
r>rZ
secret_urlr(r�r�Zsecret_passwordr�r<�rev_optionsr#r#r$�get_url_rev_options�sz"VersionControl.get_url_rev_optionscCst�|��d�S)zi
        Normalize a URL for comparison by unquoting it and removing any
        trailing slash.
        �/)rQZunquote�rstrip�rr#r#r$�
normalize_url�szVersionControl.normalize_urlcCs|�|�|�|�kS)zV
        Compare two repo URLs for identity, ignoring incidental differences.
        )r�)rcZurl1Zurl2r#r#r$�compare_urls�szVersionControl.compare_urlscCst�dS)z�
        Fetch a revision from a repository, in the case that this is the
        first fetch from the repository.

        Args:
          dest: the directory to fetch the repository to.
          rev_options: a RevOptions object.
        Nrw�r>�destrr�r#r#r$�	fetch_new�s
zVersionControl.fetch_newcCst�dS)z}
        Switch the repo at ``dest`` to point to ``URL``.

        Args:
          rev_options: a RevOptions object.
        Nrwr�r#r#r$�switch�szVersionControl.switchcCst�dS)z�
        Update an already-existing repo to the given ``rev_options``.

        Args:
          rev_options: a RevOptions object.
        Nrwr�r#r#r$�update�szVersionControl.updatecCst�dS)z�
        Return whether the id of the current commit equals the given name.

        Args:
          dest: the repository directory.
          name: a string name.
        Nrw)rcr�r!r#r#r$�is_commit_id_equal�s	z!VersionControl.is_commit_id_equalc	Cs�|�|�\}}tj�|�s,|�|||�dS|��}|�|�r�|�|�}|�||j	�r�t
�d|j�
�t|�|�|�||j�s�t
�dt|�|j|�|�|||�n
t
�d�dSt
�d|j|jt|�|�d}nt
�d||j|j�d}t
�d	|j|�td
|d|d�}|d
k�r$t�d�|dk�rXt
�dt|��t|�|�|||�dS|dk�r�t|�}t
�dt|�|�t�||�|�|||�dS|dk�r�t
�d|jt|�||�|�|||�dS)a
        Install or update in editable mode the package represented by this
        VersionControl object.

        :param dest: the repository directory in which to install or update.
        :param url: the repository URL starting with a vcs prefix.
        Nz)%s in %s exists, and has correct URL (%s)zUpdating %s %s%sz$Skipping because already up-to-date.z%s %s in %s exists with URL %s)z%(s)witch, (i)gnore, (w)ipe, (b)ackup )�s�i�w�bz0Directory %s already exists, and is not a %s %s.)z(i)gnore, (w)ipe, (b)ackup )r�r�r�z+The plan is to install the %s repository %szWhat to do?  %srr��a���r�zDeleting %sr�zBacking up %s to %sr�zSwitching %s %s to %s%s)r�r-r.r/r�rI�is_repository_directoryrur�r�r2rb�	repo_name�titler	r�r(�infor�r3r!r�sys�exitrr�shutilZmover�)	r>r�rr�Zrev_displayZexisting_url�promptZresponseZdest_dirr#r#r$�obtain�s�	

��
���



�
�zVersionControl.obtaincCs&tj�|�rt|�|j||d�dS)z�
        Clean up current location and download the url repository
        (and vcs infos) into location

        :param url: the repository URL starting with a vcs prefix.
        r�N)r-r.r/rr�r~r#r#r$�unpack?szVersionControl.unpackcCst�dS)z�
        Return the url used at location

        Raises RemoteNotFoundError if the repository does not have a remote
        url configured.
        Nrwrpr#r#r$ruKszVersionControl.get_remote_urlcCst�dS)zR
        Return the current commit id of the files at the given location.
        Nrwrpr#r#r$rrUszVersionControl.get_revisionT�raisec
Cs|t|jf|��}z t||||||||j||	d�
WStk
rv}
z(|
jtjkrdtd|j|jf��n�W5d}
~
XYnXdS)z�
        Run a VCS subcommand
        This is simply a wrapper around call_subprocess that adds the VCS
        command name, and checks that the VCS is available
        )�
on_returncode�extra_ok_returncodes�command_desc�
extra_environ�
unset_environ�spinner�log_failed_cmdzCCannot find command %r - do you have %r installed and in your PATH?N)rr!r
r��OSError�errnoZENOENTr)rc�cmdZshow_stdout�cwdr�r�r�r�r�r��er#r#r$�run_command\s&�
��zVersionControl.run_commandcCs,t�d||j|j�tj�tj�||j��S)zL
        Return whether a directory path is a repository directory.
        zChecking in %s for %s (%s)...)r2rbr1r!r-r.r/r0)rcr.r#r#r$r��s�z&VersionControl.is_repository_directorycCs
|�|�S)a6
        Check if a location is controlled by the vcs.
        It is meant to be overridden to implement smarter detection
        mechanisms for specific vcs.

        This can do more than is_repository_directory() alone.  For example,
        the Git override checks that Git is actually available.
        )r�rpr#r#r$rg�sz VersionControl.controls_location)NN)TNr�NNNNT)$r8r9r:r!r1r�rSr�rC�classmethodrorqrtrv�staticmethodrErKr}r�r�r�r�r�r�r�r�r�r�r�r�r�rurrr�r�rgr#r#r#r$rm�sr




	
	









]
	
�'
	rm)N)>rMZ
__future__rr�Zloggingr-r�r�Zpip._vendorrZpip._vendor.six.moves.urllibrrQZpip._internal.exceptionsrZpip._internal.utils.compatrZpip._internal.utils.miscrrr	r
rrZpip._internal.utils.subprocessr
rZpip._internal.utils.typingrZpip._internal.utils.urlsr�typingrrrrrrrrrrZpip._internal.utils.uirrr�strZAuthInfo�__all__Z	getLoggerr8r2r%r,r6�	Exceptionr7�objectr;rOrrmr#r#r#r$�<module>s< 0

HGsite-packages/pip/_internal/vcs/subversion.py000064400000030004151446176770015412 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os
import re

from pip._internal.utils.logging import indent_log
from pip._internal.utils.misc import (
    display_path,
    is_console_interactive,
    rmtree,
    split_auth_from_netloc,
)
from pip._internal.utils.subprocess import make_command
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.vcs.versioncontrol import VersionControl, vcs

_svn_xml_url_re = re.compile('url="([^"]+)"')
_svn_rev_re = re.compile(r'committed-rev="(\d+)"')
_svn_info_xml_rev_re = re.compile(r'\s*revision="(\d+)"')
_svn_info_xml_url_re = re.compile(r'<url>(.*)</url>')


if MYPY_CHECK_RUNNING:
    from typing import Optional, Tuple
    from pip._internal.utils.subprocess import CommandArgs
    from pip._internal.utils.misc import HiddenText
    from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions


logger = logging.getLogger(__name__)


class Subversion(VersionControl):
    name = 'svn'
    dirname = '.svn'
    repo_name = 'checkout'
    schemes = ('svn', 'svn+ssh', 'svn+http', 'svn+https', 'svn+svn')

    @classmethod
    def should_add_vcs_url_prefix(cls, remote_url):
        return True

    @staticmethod
    def get_base_rev_args(rev):
        return ['-r', rev]

    @classmethod
    def get_revision(cls, location):
        """
        Return the maximum revision for all files under a given location
        """
        # Note: taken from setuptools.command.egg_info
        revision = 0

        for base, dirs, files in os.walk(location):
            if cls.dirname not in dirs:
                dirs[:] = []
                continue    # no sense walking uncontrolled subdirs
            dirs.remove(cls.dirname)
            entries_fn = os.path.join(base, cls.dirname, 'entries')
            if not os.path.exists(entries_fn):
                # FIXME: should we warn?
                continue

            dirurl, localrev = cls._get_svn_url_rev(base)

            if base == location:
                base = dirurl + '/'   # save the root url
            elif not dirurl or not dirurl.startswith(base):
                dirs[:] = []
                continue    # not part of the same svn tree, skip it
            revision = max(revision, localrev)
        return revision

    @classmethod
    def get_netloc_and_auth(cls, netloc, scheme):
        """
        This override allows the auth information to be passed to svn via the
        --username and --password options instead of via the URL.
        """
        if scheme == 'ssh':
            # The --username and --password options can't be used for
            # svn+ssh URLs, so keep the auth information in the URL.
            return super(Subversion, cls).get_netloc_and_auth(netloc, scheme)

        return split_auth_from_netloc(netloc)

    @classmethod
    def get_url_rev_and_auth(cls, url):
        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
        # hotfix the URL scheme after removing svn+ from svn+ssh:// readd it
        url, rev, user_pass = super(Subversion, cls).get_url_rev_and_auth(url)
        if url.startswith('ssh://'):
            url = 'svn+' + url
        return url, rev, user_pass

    @staticmethod
    def make_rev_args(username, password):
        # type: (Optional[str], Optional[HiddenText]) -> CommandArgs
        extra_args = []  # type: CommandArgs
        if username:
            extra_args += ['--username', username]
        if password:
            extra_args += ['--password', password]

        return extra_args

    @classmethod
    def get_remote_url(cls, location):
        # In cases where the source is in a subdirectory, not alongside
        # setup.py we have to look up in the location until we find a real
        # setup.py
        orig_location = location
        while not os.path.exists(os.path.join(location, 'setup.py')):
            last_location = location
            location = os.path.dirname(location)
            if location == last_location:
                # We've traversed up to the root of the filesystem without
                # finding setup.py
                logger.warning(
                    "Could not find setup.py for directory %s (tried all "
                    "parent directories)",
                    orig_location,
                )
                return None

        return cls._get_svn_url_rev(location)[0]

    @classmethod
    def _get_svn_url_rev(cls, location):
        from pip._internal.exceptions import InstallationError

        entries_path = os.path.join(location, cls.dirname, 'entries')
        if os.path.exists(entries_path):
            with open(entries_path) as f:
                data = f.read()
        else:  # subversion >= 1.7 does not have the 'entries' file
            data = ''

        if (data.startswith('8') or
                data.startswith('9') or
                data.startswith('10')):
            data = list(map(str.splitlines, data.split('\n\x0c\n')))
            del data[0][0]  # get rid of the '8'
            url = data[0][3]
            revs = [int(d[9]) for d in data if len(d) > 9 and d[9]] + [0]
        elif data.startswith('<?xml'):
            match = _svn_xml_url_re.search(data)
            if not match:
                raise ValueError('Badly formatted data: %r' % data)
            url = match.group(1)    # get repository URL
            revs = [int(m.group(1)) for m in _svn_rev_re.finditer(data)] + [0]
        else:
            try:
                # subversion >= 1.7
                # Note that using get_remote_call_options is not necessary here
                # because `svn info` is being run against a local directory.
                # We don't need to worry about making sure interactive mode
                # is being used to prompt for passwords, because passwords
                # are only potentially needed for remote server requests.
                xml = cls.run_command(
                    ['info', '--xml', location],
                    show_stdout=False,
                )
                url = _svn_info_xml_url_re.search(xml).group(1)
                revs = [
                    int(m.group(1)) for m in _svn_info_xml_rev_re.finditer(xml)
                ]
            except InstallationError:
                url, revs = None, []

        if revs:
            rev = max(revs)
        else:
            rev = 0

        return url, rev

    @classmethod
    def is_commit_id_equal(cls, dest, name):
        """Always assume the versions don't match"""
        return False

    def __init__(self, use_interactive=None):
        # type: (bool) -> None
        if use_interactive is None:
            use_interactive = is_console_interactive()
        self.use_interactive = use_interactive

        # This member is used to cache the fetched version of the current
        # ``svn`` client.
        # Special value definitions:
        #   None: Not evaluated yet.
        #   Empty tuple: Could not parse version.
        self._vcs_version = None  # type: Optional[Tuple[int, ...]]

        super(Subversion, self).__init__()

    def call_vcs_version(self):
        # type: () -> Tuple[int, ...]
        """Query the version of the currently installed Subversion client.

        :return: A tuple containing the parts of the version information or
            ``()`` if the version returned from ``svn`` could not be parsed.
        :raises: BadCommand: If ``svn`` is not installed.
        """
        # Example versions:
        #   svn, version 1.10.3 (r1842928)
        #      compiled Feb 25 2019, 14:20:39 on x86_64-apple-darwin17.0.0
        #   svn, version 1.7.14 (r1542130)
        #      compiled Mar 28 2018, 08:49:13 on x86_64-pc-linux-gnu
        version_prefix = 'svn, version '
        version = self.run_command(['--version'], show_stdout=False)
        if not version.startswith(version_prefix):
            return ()

        version = version[len(version_prefix):].split()[0]
        version_list = version.split('.')
        try:
            parsed_version = tuple(map(int, version_list))
        except ValueError:
            return ()

        return parsed_version

    def get_vcs_version(self):
        # type: () -> Tuple[int, ...]
        """Return the version of the currently installed Subversion client.

        If the version of the Subversion client has already been queried,
        a cached value will be used.

        :return: A tuple containing the parts of the version information or
            ``()`` if the version returned from ``svn`` could not be parsed.
        :raises: BadCommand: If ``svn`` is not installed.
        """
        if self._vcs_version is not None:
            # Use cached version, if available.
            # If parsing the version failed previously (empty tuple),
            # do not attempt to parse it again.
            return self._vcs_version

        vcs_version = self.call_vcs_version()
        self._vcs_version = vcs_version
        return vcs_version

    def get_remote_call_options(self):
        # type: () -> CommandArgs
        """Return options to be used on calls to Subversion that contact the server.

        These options are applicable for the following ``svn`` subcommands used
        in this class.

            - checkout
            - export
            - switch
            - update

        :return: A list of command line arguments to pass to ``svn``.
        """
        if not self.use_interactive:
            # --non-interactive switch is available since Subversion 0.14.4.
            # Subversion < 1.8 runs in interactive mode by default.
            return ['--non-interactive']

        svn_version = self.get_vcs_version()
        # By default, Subversion >= 1.8 runs in non-interactive mode if
        # stdin is not a TTY. Since that is how pip invokes SVN, in
        # call_subprocess(), pip must pass --force-interactive to ensure
        # the user can be prompted for a password, if required.
        #   SVN added the --force-interactive option in SVN 1.8. Since
        # e.g. RHEL/CentOS 7, which is supported until 2024, ships with
        # SVN 1.7, pip should continue to support SVN 1.7. Therefore, pip
        # can't safely add the option if the SVN version is < 1.8 (or unknown).
        if svn_version >= (1, 8):
            return ['--force-interactive']

        return []

    def export(self, location, url):
        # type: (str, HiddenText) -> None
        """Export the svn repository at the url to the destination location"""
        url, rev_options = self.get_url_rev_options(url)

        logger.info('Exporting svn repository %s to %s', url, location)
        with indent_log():
            if os.path.exists(location):
                # Subversion doesn't like to check out over an existing
                # directory --force fixes this, but was only added in svn 1.5
                rmtree(location)
            cmd_args = make_command(
                'export', self.get_remote_call_options(),
                rev_options.to_args(), url, location,
            )
            self.run_command(cmd_args, show_stdout=False)

    def fetch_new(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        rev_display = rev_options.to_display()
        logger.info(
            'Checking out %s%s to %s',
            url,
            rev_display,
            display_path(dest),
        )
        cmd_args = make_command(
            'checkout', '-q', self.get_remote_call_options(),
            rev_options.to_args(), url, dest,
        )
        self.run_command(cmd_args)

    def switch(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        cmd_args = make_command(
            'switch', self.get_remote_call_options(), rev_options.to_args(),
            url, dest,
        )
        self.run_command(cmd_args)

    def update(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        cmd_args = make_command(
            'update', self.get_remote_call_options(), rev_options.to_args(),
            dest,
        )
        self.run_command(cmd_args)


vcs.register(Subversion)
site-packages/pip/_internal/vcs/__init__.py000064400000001151151446176770014753 0ustar00# Expose a limited set of classes and functions so callers outside of
# the vcs package don't need to import deeper than `pip._internal.vcs`.
# (The test directory and imports protected by MYPY_CHECK_RUNNING may
# still need to import from a vcs sub-package.)
# Import all vcs modules to register each VCS in the VcsSupport object.
import pip._internal.vcs.bazaar
import pip._internal.vcs.git
import pip._internal.vcs.mercurial
import pip._internal.vcs.subversion  # noqa: F401
from pip._internal.vcs.versioncontrol import (  # noqa: F401
    RemoteNotFoundError,
    is_url,
    make_vcs_requirement_url,
    vcs,
)
site-packages/pip/_internal/vcs/git.py000064400000032400151446176770014000 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os.path
import re

from pip._vendor.packaging.version import parse as parse_version
from pip._vendor.six.moves.urllib import parse as urllib_parse
from pip._vendor.six.moves.urllib import request as urllib_request

from pip._internal.exceptions import BadCommand
from pip._internal.utils.misc import display_path
from pip._internal.utils.subprocess import make_command
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.vcs.versioncontrol import (
    RemoteNotFoundError,
    VersionControl,
    find_path_to_setup_from_repo_root,
    vcs,
)

if MYPY_CHECK_RUNNING:
    from typing import Optional, Tuple
    from pip._internal.utils.misc import HiddenText
    from pip._internal.vcs.versioncontrol import AuthInfo, RevOptions


urlsplit = urllib_parse.urlsplit
urlunsplit = urllib_parse.urlunsplit


logger = logging.getLogger(__name__)


HASH_REGEX = re.compile('^[a-fA-F0-9]{40}$')


def looks_like_hash(sha):
    return bool(HASH_REGEX.match(sha))


class Git(VersionControl):
    name = 'git'
    dirname = '.git'
    repo_name = 'clone'
    schemes = (
        'git', 'git+http', 'git+https', 'git+ssh', 'git+git', 'git+file',
    )
    # Prevent the user's environment variables from interfering with pip:
    # https://github.com/pypa/pip/issues/1130
    unset_environ = ('GIT_DIR', 'GIT_WORK_TREE')
    default_arg_rev = 'HEAD'

    @staticmethod
    def get_base_rev_args(rev):
        return [rev]

    def get_git_version(self):
        VERSION_PFX = 'git version '
        version = self.run_command(['version'], show_stdout=False)
        if version.startswith(VERSION_PFX):
            version = version[len(VERSION_PFX):].split()[0]
        else:
            version = ''
        # get first 3 positions of the git version because
        # on windows it is x.y.z.windows.t, and this parses as
        # LegacyVersion which always smaller than a Version.
        version = '.'.join(version.split('.')[:3])
        return parse_version(version)

    @classmethod
    def get_current_branch(cls, location):
        """
        Return the current branch, or None if HEAD isn't at a branch
        (e.g. detached HEAD).
        """
        # git-symbolic-ref exits with empty stdout if "HEAD" is a detached
        # HEAD rather than a symbolic ref.  In addition, the -q causes the
        # command to exit with status code 1 instead of 128 in this case
        # and to suppress the message to stderr.
        args = ['symbolic-ref', '-q', 'HEAD']
        output = cls.run_command(
            args, extra_ok_returncodes=(1, ), show_stdout=False, cwd=location,
        )
        ref = output.strip()

        if ref.startswith('refs/heads/'):
            return ref[len('refs/heads/'):]

        return None

    def export(self, location, url):
        # type: (str, HiddenText) -> None
        """Export the Git repository at the url to the destination location"""
        if not location.endswith('/'):
            location = location + '/'

        with TempDirectory(kind="export") as temp_dir:
            self.unpack(temp_dir.path, url=url)
            self.run_command(
                ['checkout-index', '-a', '-f', '--prefix', location],
                show_stdout=False, cwd=temp_dir.path
            )

    @classmethod
    def get_revision_sha(cls, dest, rev):
        """
        Return (sha_or_none, is_branch), where sha_or_none is a commit hash
        if the revision names a remote branch or tag, otherwise None.

        Args:
          dest: the repository directory.
          rev: the revision name.
        """
        # Pass rev to pre-filter the list.
        output = cls.run_command(['show-ref', rev], cwd=dest,
                                 show_stdout=False, on_returncode='ignore')
        refs = {}
        # NOTE: We do not use splitlines here since that would split on other
        #       unicode separators, which can be maliciously used to install a
        #       different revision.
        for line in output.strip().split("\n"):
            line = line.rstrip("\r")
            if not line:
                continue
            try:
                sha, ref = line.split(" ", maxsplit=2)
            except ValueError:
                # Include the offending line to simplify troubleshooting if
                # this error ever occurs.
                raise ValueError('unexpected show-ref line: {!r}'.format(line))

            refs[ref] = sha

        branch_ref = 'refs/remotes/origin/{}'.format(rev)
        tag_ref = 'refs/tags/{}'.format(rev)

        sha = refs.get(branch_ref)
        if sha is not None:
            return (sha, True)

        sha = refs.get(tag_ref)

        return (sha, False)

    @classmethod
    def resolve_revision(cls, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> RevOptions
        """
        Resolve a revision to a new RevOptions object with the SHA1 of the
        branch, tag, or ref if found.

        Args:
          rev_options: a RevOptions object.
        """
        rev = rev_options.arg_rev
        # The arg_rev property's implementation for Git ensures that the
        # rev return value is always non-None.
        assert rev is not None

        sha, is_branch = cls.get_revision_sha(dest, rev)

        if sha is not None:
            rev_options = rev_options.make_new(sha)
            rev_options.branch_name = rev if is_branch else None

            return rev_options

        # Do not show a warning for the common case of something that has
        # the form of a Git commit hash.
        if not looks_like_hash(rev):
            logger.warning(
                "Did not find branch or tag '%s', assuming revision or ref.",
                rev,
            )

        if not rev.startswith('refs/'):
            return rev_options

        # If it looks like a ref, we have to fetch it explicitly.
        cls.run_command(
            make_command('fetch', '-q', url, rev_options.to_args()),
            cwd=dest,
        )
        # Change the revision to the SHA of the ref we fetched
        sha = cls.get_revision(dest, rev='FETCH_HEAD')
        rev_options = rev_options.make_new(sha)

        return rev_options

    @classmethod
    def is_commit_id_equal(cls, dest, name):
        """
        Return whether the current commit hash equals the given name.

        Args:
          dest: the repository directory.
          name: a string name.
        """
        if not name:
            # Then avoid an unnecessary subprocess call.
            return False

        return cls.get_revision(dest) == name

    def fetch_new(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        rev_display = rev_options.to_display()
        logger.info('Cloning %s%s to %s', url, rev_display, display_path(dest))
        self.run_command(make_command('clone', '-q', url, dest))

        if rev_options.rev:
            # Then a specific revision was requested.
            rev_options = self.resolve_revision(dest, url, rev_options)
            branch_name = getattr(rev_options, 'branch_name', None)
            if branch_name is None:
                # Only do a checkout if the current commit id doesn't match
                # the requested revision.
                if not self.is_commit_id_equal(dest, rev_options.rev):
                    cmd_args = make_command(
                        'checkout', '-q', rev_options.to_args(),
                    )
                    self.run_command(cmd_args, cwd=dest)
            elif self.get_current_branch(dest) != branch_name:
                # Then a specific branch was requested, and that branch
                # is not yet checked out.
                track_branch = 'origin/{}'.format(branch_name)
                cmd_args = [
                    'checkout', '-b', branch_name, '--track', track_branch,
                ]
                self.run_command(cmd_args, cwd=dest)

        #: repo may contain submodules
        self.update_submodules(dest)

    def switch(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        self.run_command(
            make_command('config', 'remote.origin.url', url),
            cwd=dest,
        )
        cmd_args = make_command('checkout', '-q', rev_options.to_args())
        self.run_command(cmd_args, cwd=dest)

        self.update_submodules(dest)

    def update(self, dest, url, rev_options):
        # type: (str, HiddenText, RevOptions) -> None
        # First fetch changes from the default remote
        if self.get_git_version() >= parse_version('1.9.0'):
            # fetch tags in addition to everything else
            self.run_command(['fetch', '-q', '--tags'], cwd=dest)
        else:
            self.run_command(['fetch', '-q'], cwd=dest)
        # Then reset to wanted revision (maybe even origin/master)
        rev_options = self.resolve_revision(dest, url, rev_options)
        cmd_args = make_command('reset', '--hard', '-q', rev_options.to_args())
        self.run_command(cmd_args, cwd=dest)
        #: update submodules
        self.update_submodules(dest)

    @classmethod
    def get_remote_url(cls, location):
        """
        Return URL of the first remote encountered.

        Raises RemoteNotFoundError if the repository does not have a remote
        url configured.
        """
        # We need to pass 1 for extra_ok_returncodes since the command
        # exits with return code 1 if there are no matching lines.
        stdout = cls.run_command(
            ['config', '--get-regexp', r'remote\..*\.url'],
            extra_ok_returncodes=(1, ), show_stdout=False, cwd=location,
        )
        remotes = stdout.splitlines()
        try:
            found_remote = remotes[0]
        except IndexError:
            raise RemoteNotFoundError

        for remote in remotes:
            if remote.startswith('remote.origin.url '):
                found_remote = remote
                break
        url = found_remote.split(' ')[1]
        return url.strip()

    @classmethod
    def get_revision(cls, location, rev=None):
        if rev is None:
            rev = 'HEAD'
        current_rev = cls.run_command(
            ['rev-parse', rev], show_stdout=False, cwd=location,
        )
        return current_rev.strip()

    @classmethod
    def get_subdirectory(cls, location):
        """
        Return the path to setup.py, relative to the repo root.
        Return None if setup.py is in the repo root.
        """
        # find the repo root
        git_dir = cls.run_command(
            ['rev-parse', '--git-dir'],
            show_stdout=False, cwd=location).strip()
        if not os.path.isabs(git_dir):
            git_dir = os.path.join(location, git_dir)
        repo_root = os.path.abspath(os.path.join(git_dir, '..'))
        return find_path_to_setup_from_repo_root(location, repo_root)

    @classmethod
    def get_url_rev_and_auth(cls, url):
        # type: (str) -> Tuple[str, Optional[str], AuthInfo]
        """
        Prefixes stub URLs like 'user@hostname:user/repo.git' with 'ssh://'.
        That's required because although they use SSH they sometimes don't
        work with a ssh:// scheme (e.g. GitHub). But we need a scheme for
        parsing. Hence we remove it again afterwards and return it as a stub.
        """
        # Works around an apparent Git bug
        # (see https://article.gmane.org/gmane.comp.version-control.git/146500)
        scheme, netloc, path, query, fragment = urlsplit(url)
        if scheme.endswith('file'):
            initial_slashes = path[:-len(path.lstrip('/'))]
            newpath = (
                initial_slashes +
                urllib_request.url2pathname(path)
                .replace('\\', '/').lstrip('/')
            )
            url = urlunsplit((scheme, netloc, newpath, query, fragment))
            after_plus = scheme.find('+') + 1
            url = scheme[:after_plus] + urlunsplit(
                (scheme[after_plus:], netloc, newpath, query, fragment),
            )

        if '://' not in url:
            assert 'file:' not in url
            url = url.replace('git+', 'git+ssh://')
            url, rev, user_pass = super(Git, cls).get_url_rev_and_auth(url)
            url = url.replace('ssh://', '')
        else:
            url, rev, user_pass = super(Git, cls).get_url_rev_and_auth(url)

        return url, rev, user_pass

    @classmethod
    def update_submodules(cls, location):
        if not os.path.exists(os.path.join(location, '.gitmodules')):
            return
        cls.run_command(
            ['submodule', 'update', '--init', '--recursive', '-q'],
            cwd=location,
        )

    @classmethod
    def controls_location(cls, location):
        if super(Git, cls).controls_location(location):
            return True
        try:
            r = cls.run_command(['rev-parse'],
                                cwd=location,
                                show_stdout=False,
                                on_returncode='ignore',
                                log_failed_cmd=False)
            return not r
        except BadCommand:
            logger.debug("could not determine if %s is under git control "
                         "because git is not available", location)
            return False


vcs.register(Git)
site-packages/pip/_internal/wheel.py000064400000124110151446176770013526 0ustar00"""
Support for installing and building the "wheel" binary package format.
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import collections
import compileall
import csv
import hashlib
import logging
import os.path
import re
import shutil
import stat
import sys
import warnings
from base64 import urlsafe_b64encode
from email.parser import Parser

from pip._vendor import pkg_resources
from pip._vendor.distlib.scripts import ScriptMaker
from pip._vendor.distlib.util import get_export_entry
from pip._vendor.packaging.utils import canonicalize_name
from pip._vendor.six import StringIO

from pip._internal import pep425tags
from pip._internal.exceptions import (
    InstallationError,
    InvalidWheelFilename,
    UnsupportedWheel,
)
from pip._internal.locations import distutils_scheme, get_major_minor_version
from pip._internal.models.link import Link
from pip._internal.utils.logging import indent_log
from pip._internal.utils.marker_files import has_delete_marker_file
from pip._internal.utils.misc import captured_stdout, ensure_dir, read_chunks
from pip._internal.utils.setuptools_build import make_setuptools_shim_args
from pip._internal.utils.subprocess import (
    LOG_DIVIDER,
    call_subprocess,
    format_command_args,
    runner_with_spinner_message,
)
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.ui import open_spinner
from pip._internal.utils.unpacking import unpack_file
from pip._internal.utils.urls import path_to_url

if MYPY_CHECK_RUNNING:
    from typing import (
        Dict, List, Optional, Sequence, Mapping, Tuple, IO, Text, Any,
        Iterable, Callable, Set,
    )
    from pip._vendor.packaging.requirements import Requirement
    from pip._internal.req.req_install import InstallRequirement
    from pip._internal.operations.prepare import (
        RequirementPreparer
    )
    from pip._internal.cache import WheelCache
    from pip._internal.pep425tags import Pep425Tag

    InstalledCSVRow = Tuple[str, ...]

    BinaryAllowedPredicate = Callable[[InstallRequirement], bool]


VERSION_COMPATIBLE = (1, 0)


logger = logging.getLogger(__name__)


def normpath(src, p):
    return os.path.relpath(src, p).replace(os.path.sep, '/')


def hash_file(path, blocksize=1 << 20):
    # type: (str, int) -> Tuple[Any, int]
    """Return (hash, length) for path using hashlib.sha256()"""
    h = hashlib.sha256()
    length = 0
    with open(path, 'rb') as f:
        for block in read_chunks(f, size=blocksize):
            length += len(block)
            h.update(block)
    return (h, length)  # type: ignore


def rehash(path, blocksize=1 << 20):
    # type: (str, int) -> Tuple[str, str]
    """Return (encoded_digest, length) for path using hashlib.sha256()"""
    h, length = hash_file(path, blocksize)
    digest = 'sha256=' + urlsafe_b64encode(
        h.digest()
    ).decode('latin1').rstrip('=')
    # unicode/str python2 issues
    return (digest, str(length))  # type: ignore


def open_for_csv(name, mode):
    # type: (str, Text) -> IO
    if sys.version_info[0] < 3:
        nl = {}  # type: Dict[str, Any]
        bin = 'b'
    else:
        nl = {'newline': ''}  # type: Dict[str, Any]
        bin = ''
    return open(name, mode + bin, **nl)


def replace_python_tag(wheelname, new_tag):
    # type: (str, str) -> str
    """Replace the Python tag in a wheel file name with a new value.
    """
    parts = wheelname.split('-')
    parts[-3] = new_tag
    return '-'.join(parts)


def fix_script(path):
    # type: (str) -> Optional[bool]
    """Replace #!python with #!/path/to/python
    Return True if file was changed."""
    # XXX RECORD hashes will need to be updated
    if os.path.isfile(path):
        with open(path, 'rb') as script:
            firstline = script.readline()
            if not firstline.startswith(b'#!python'):
                return False
            exename = sys.executable.encode(sys.getfilesystemencoding())
            firstline = b'#!' + exename + os.linesep.encode("ascii")
            rest = script.read()
        with open(path, 'wb') as script:
            script.write(firstline)
            script.write(rest)
        return True
    return None


dist_info_re = re.compile(r"""^(?P<namever>(?P<name>.+?)(-(?P<ver>.+?))?)
                                \.dist-info$""", re.VERBOSE)


def root_is_purelib(name, wheeldir):
    # type: (str, str) -> bool
    """
    Return True if the extracted wheel in wheeldir should go into purelib.
    """
    name_folded = name.replace("-", "_")
    for item in os.listdir(wheeldir):
        match = dist_info_re.match(item)
        if match and match.group('name') == name_folded:
            with open(os.path.join(wheeldir, item, 'WHEEL')) as wheel:
                for line in wheel:
                    line = line.lower().rstrip()
                    if line == "root-is-purelib: true":
                        return True
    return False


def get_entrypoints(filename):
    # type: (str) -> Tuple[Dict[str, str], Dict[str, str]]
    if not os.path.exists(filename):
        return {}, {}

    # This is done because you can pass a string to entry_points wrappers which
    # means that they may or may not be valid INI files. The attempt here is to
    # strip leading and trailing whitespace in order to make them valid INI
    # files.
    with open(filename) as fp:
        data = StringIO()
        for line in fp:
            data.write(line.strip())
            data.write("\n")
        data.seek(0)

    # get the entry points and then the script names
    entry_points = pkg_resources.EntryPoint.parse_map(data)
    console = entry_points.get('console_scripts', {})
    gui = entry_points.get('gui_scripts', {})

    def _split_ep(s):
        """get the string representation of EntryPoint, remove space and split
        on '='"""
        return str(s).replace(" ", "").split("=")

    # convert the EntryPoint objects into strings with module:function
    console = dict(_split_ep(v) for v in console.values())
    gui = dict(_split_ep(v) for v in gui.values())
    return console, gui


def message_about_scripts_not_on_PATH(scripts):
    # type: (Sequence[str]) -> Optional[str]
    """Determine if any scripts are not on PATH and format a warning.

    Returns a warning message if one or more scripts are not on PATH,
    otherwise None.
    """
    if not scripts:
        return None

    # Group scripts by the path they were installed in
    grouped_by_dir = collections.defaultdict(set)  # type: Dict[str, Set[str]]
    for destfile in scripts:
        parent_dir = os.path.dirname(destfile)
        script_name = os.path.basename(destfile)
        grouped_by_dir[parent_dir].add(script_name)

    # We don't want to warn for directories that are on PATH.
    not_warn_dirs = [
        os.path.normcase(i).rstrip(os.sep) for i in
        os.environ.get("PATH", "").split(os.pathsep)
    ]
    # If an executable sits with sys.executable, we don't warn for it.
    #     This covers the case of venv invocations without activating the venv.
    not_warn_dirs.append(os.path.normcase(os.path.dirname(sys.executable)))
    warn_for = {
        parent_dir: scripts for parent_dir, scripts in grouped_by_dir.items()
        if os.path.normcase(parent_dir) not in not_warn_dirs
    }  # type: Dict[str, Set[str]]
    if not warn_for:
        return None

    # Format a message
    msg_lines = []
    for parent_dir, dir_scripts in warn_for.items():
        sorted_scripts = sorted(dir_scripts)  # type: List[str]
        if len(sorted_scripts) == 1:
            start_text = "script {} is".format(sorted_scripts[0])
        else:
            start_text = "scripts {} are".format(
                ", ".join(sorted_scripts[:-1]) + " and " + sorted_scripts[-1]
            )

        msg_lines.append(
            "The {} installed in '{}' which is not on PATH."
            .format(start_text, parent_dir)
        )

    last_line_fmt = (
        "Consider adding {} to PATH or, if you prefer "
        "to suppress this warning, use --no-warn-script-location."
    )
    if len(msg_lines) == 1:
        msg_lines.append(last_line_fmt.format("this directory"))
    else:
        msg_lines.append(last_line_fmt.format("these directories"))

    # Returns the formatted multiline message
    return "\n".join(msg_lines)


def sorted_outrows(outrows):
    # type: (Iterable[InstalledCSVRow]) -> List[InstalledCSVRow]
    """
    Return the given rows of a RECORD file in sorted order.

    Each row is a 3-tuple (path, hash, size) and corresponds to a record of
    a RECORD file (see PEP 376 and PEP 427 for details).  For the rows
    passed to this function, the size can be an integer as an int or string,
    or the empty string.
    """
    # Normally, there should only be one row per path, in which case the
    # second and third elements don't come into play when sorting.
    # However, in cases in the wild where a path might happen to occur twice,
    # we don't want the sort operation to trigger an error (but still want
    # determinism).  Since the third element can be an int or string, we
    # coerce each element to a string to avoid a TypeError in this case.
    # For additional background, see--
    # https://github.com/pypa/pip/issues/5868
    return sorted(outrows, key=lambda row: tuple(str(x) for x in row))


def get_csv_rows_for_installed(
    old_csv_rows,  # type: Iterable[List[str]]
    installed,  # type: Dict[str, str]
    changed,  # type: set
    generated,  # type: List[str]
    lib_dir,  # type: str
):
    # type: (...) -> List[InstalledCSVRow]
    """
    :param installed: A map from archive RECORD path to installation RECORD
        path.
    """
    installed_rows = []  # type: List[InstalledCSVRow]
    for row in old_csv_rows:
        if len(row) > 3:
            logger.warning(
                'RECORD line has more than three elements: {}'.format(row)
            )
        # Make a copy because we are mutating the row.
        row = list(row)
        old_path = row[0]
        new_path = installed.pop(old_path, old_path)
        row[0] = new_path
        if new_path in changed:
            digest, length = rehash(new_path)
            row[1] = digest
            row[2] = length
        installed_rows.append(tuple(row))
    for f in generated:
        digest, length = rehash(f)
        installed_rows.append((normpath(f, lib_dir), digest, str(length)))
    for f in installed:
        installed_rows.append((installed[f], '', ''))
    return installed_rows


class MissingCallableSuffix(Exception):
    pass


def _raise_for_invalid_entrypoint(specification):
    entry = get_export_entry(specification)
    if entry is not None and entry.suffix is None:
        raise MissingCallableSuffix(str(entry))


class PipScriptMaker(ScriptMaker):
    def make(self, specification, options=None):
        _raise_for_invalid_entrypoint(specification)
        return super(PipScriptMaker, self).make(specification, options)


def move_wheel_files(
    name,  # type: str
    req,  # type: Requirement
    wheeldir,  # type: str
    user=False,  # type: bool
    home=None,  # type: Optional[str]
    root=None,  # type: Optional[str]
    pycompile=True,  # type: bool
    scheme=None,  # type: Optional[Mapping[str, str]]
    isolated=False,  # type: bool
    prefix=None,  # type: Optional[str]
    warn_script_location=True  # type: bool
):
    # type: (...) -> None
    """Install a wheel"""
    # TODO: Investigate and break this up.
    # TODO: Look into moving this into a dedicated class for representing an
    #       installation.

    if not scheme:
        scheme = distutils_scheme(
            name, user=user, home=home, root=root, isolated=isolated,
            prefix=prefix,
        )

    if root_is_purelib(name, wheeldir):
        lib_dir = scheme['purelib']
    else:
        lib_dir = scheme['platlib']

    info_dir = []  # type: List[str]
    data_dirs = []
    source = wheeldir.rstrip(os.path.sep) + os.path.sep

    # Record details of the files moved
    #   installed = files copied from the wheel to the destination
    #   changed = files changed while installing (scripts #! line typically)
    #   generated = files newly generated during the install (script wrappers)
    installed = {}  # type: Dict[str, str]
    changed = set()
    generated = []  # type: List[str]

    # Compile all of the pyc files that we're going to be installing
    if pycompile:
        with captured_stdout() as stdout:
            with warnings.catch_warnings():
                warnings.filterwarnings('ignore')
                compileall.compile_dir(source, force=True, quiet=True)
        logger.debug(stdout.getvalue())

    def record_installed(srcfile, destfile, modified=False):
        """Map archive RECORD paths to installation RECORD paths."""
        oldpath = normpath(srcfile, wheeldir)
        newpath = normpath(destfile, lib_dir)
        installed[oldpath] = newpath
        if modified:
            changed.add(destfile)

    def clobber(source, dest, is_base, fixer=None, filter=None):
        ensure_dir(dest)  # common for the 'include' path

        for dir, subdirs, files in os.walk(source):
            basedir = dir[len(source):].lstrip(os.path.sep)
            destdir = os.path.join(dest, basedir)
            if is_base and basedir.split(os.path.sep, 1)[0].endswith('.data'):
                continue
            for s in subdirs:
                destsubdir = os.path.join(dest, basedir, s)
                if is_base and basedir == '' and destsubdir.endswith('.data'):
                    data_dirs.append(s)
                    continue
                elif (is_base and
                        s.endswith('.dist-info') and
                        canonicalize_name(s).startswith(
                            canonicalize_name(req.name))):
                    assert not info_dir, ('Multiple .dist-info directories: ' +
                                          destsubdir + ', ' +
                                          ', '.join(info_dir))
                    info_dir.append(destsubdir)
            for f in files:
                # Skip unwanted files
                if filter and filter(f):
                    continue
                srcfile = os.path.join(dir, f)
                destfile = os.path.join(dest, basedir, f)
                # directory creation is lazy and after the file filtering above
                # to ensure we don't install empty dirs; empty dirs can't be
                # uninstalled.
                ensure_dir(destdir)

                # copyfile (called below) truncates the destination if it
                # exists and then writes the new contents. This is fine in most
                # cases, but can cause a segfault if pip has loaded a shared
                # object (e.g. from pyopenssl through its vendored urllib3)
                # Since the shared object is mmap'd an attempt to call a
                # symbol in it will then cause a segfault. Unlinking the file
                # allows writing of new contents while allowing the process to
                # continue to use the old copy.
                if os.path.exists(destfile):
                    os.unlink(destfile)

                # We use copyfile (not move, copy, or copy2) to be extra sure
                # that we are not moving directories over (copyfile fails for
                # directories) as well as to ensure that we are not copying
                # over any metadata because we want more control over what
                # metadata we actually copy over.
                shutil.copyfile(srcfile, destfile)

                # Copy over the metadata for the file, currently this only
                # includes the atime and mtime.
                st = os.stat(srcfile)
                if hasattr(os, "utime"):
                    os.utime(destfile, (st.st_atime, st.st_mtime))

                # If our file is executable, then make our destination file
                # executable.
                if os.access(srcfile, os.X_OK):
                    st = os.stat(srcfile)
                    permissions = (
                        st.st_mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH
                    )
                    os.chmod(destfile, permissions)

                changed = False
                if fixer:
                    changed = fixer(destfile)
                record_installed(srcfile, destfile, changed)

    clobber(source, lib_dir, True)

    assert info_dir, "%s .dist-info directory not found" % req

    # Get the defined entry points
    ep_file = os.path.join(info_dir[0], 'entry_points.txt')
    console, gui = get_entrypoints(ep_file)

    def is_entrypoint_wrapper(name):
        # EP, EP.exe and EP-script.py are scripts generated for
        # entry point EP by setuptools
        if name.lower().endswith('.exe'):
            matchname = name[:-4]
        elif name.lower().endswith('-script.py'):
            matchname = name[:-10]
        elif name.lower().endswith(".pya"):
            matchname = name[:-4]
        else:
            matchname = name
        # Ignore setuptools-generated scripts
        return (matchname in console or matchname in gui)

    for datadir in data_dirs:
        fixer = None
        filter = None
        for subdir in os.listdir(os.path.join(wheeldir, datadir)):
            fixer = None
            if subdir == 'scripts':
                fixer = fix_script
                filter = is_entrypoint_wrapper
            source = os.path.join(wheeldir, datadir, subdir)
            dest = scheme[subdir]
            clobber(source, dest, False, fixer=fixer, filter=filter)

    maker = PipScriptMaker(None, scheme['scripts'])

    # Ensure old scripts are overwritten.
    # See https://github.com/pypa/pip/issues/1800
    maker.clobber = True

    # Ensure we don't generate any variants for scripts because this is almost
    # never what somebody wants.
    # See https://bitbucket.org/pypa/distlib/issue/35/
    maker.variants = {''}

    # This is required because otherwise distlib creates scripts that are not
    # executable.
    # See https://bitbucket.org/pypa/distlib/issue/32/
    maker.set_mode = True

    scripts_to_generate = []

    # Special case pip and setuptools to generate versioned wrappers
    #
    # The issue is that some projects (specifically, pip and setuptools) use
    # code in setup.py to create "versioned" entry points - pip2.7 on Python
    # 2.7, pip3.3 on Python 3.3, etc. But these entry points are baked into
    # the wheel metadata at build time, and so if the wheel is installed with
    # a *different* version of Python the entry points will be wrong. The
    # correct fix for this is to enhance the metadata to be able to describe
    # such versioned entry points, but that won't happen till Metadata 2.0 is
    # available.
    # In the meantime, projects using versioned entry points will either have
    # incorrect versioned entry points, or they will not be able to distribute
    # "universal" wheels (i.e., they will need a wheel per Python version).
    #
    # Because setuptools and pip are bundled with _ensurepip and virtualenv,
    # we need to use universal wheels. So, as a stopgap until Metadata 2.0, we
    # override the versioned entry points in the wheel and generate the
    # correct ones. This code is purely a short-term measure until Metadata 2.0
    # is available.
    #
    # To add the level of hack in this section of code, in order to support
    # ensurepip this code will look for an ``ENSUREPIP_OPTIONS`` environment
    # variable which will control which version scripts get installed.
    #
    # ENSUREPIP_OPTIONS=altinstall
    #   - Only pipX.Y and easy_install-X.Y will be generated and installed
    # ENSUREPIP_OPTIONS=install
    #   - pipX.Y, pipX, easy_install-X.Y will be generated and installed. Note
    #     that this option is technically if ENSUREPIP_OPTIONS is set and is
    #     not altinstall
    # DEFAULT
    #   - The default behavior is to install pip, pipX, pipX.Y, easy_install
    #     and easy_install-X.Y.
    pip_script = console.pop('pip', None)
    if pip_script:
        if "ENSUREPIP_OPTIONS" not in os.environ:
            scripts_to_generate.append('pip = ' + pip_script)

        if os.environ.get("ENSUREPIP_OPTIONS", "") != "altinstall":
            scripts_to_generate.append(
                'pip%s = %s' % (sys.version_info[0], pip_script)
            )

        scripts_to_generate.append(
            'pip%s = %s' % (get_major_minor_version(), pip_script)
        )
        # Delete any other versioned pip entry points
        pip_ep = [k for k in console if re.match(r'pip(\d(\.\d)?)?$', k)]
        for k in pip_ep:
            del console[k]
    easy_install_script = console.pop('easy_install', None)
    if easy_install_script:
        if "ENSUREPIP_OPTIONS" not in os.environ:
            scripts_to_generate.append(
                'easy_install = ' + easy_install_script
            )

        scripts_to_generate.append(
            'easy_install-%s = %s' % (
                get_major_minor_version(), easy_install_script
            )
        )
        # Delete any other versioned easy_install entry points
        easy_install_ep = [
            k for k in console if re.match(r'easy_install(-\d\.\d)?$', k)
        ]
        for k in easy_install_ep:
            del console[k]

    # Generate the console and GUI entry points specified in the wheel
    scripts_to_generate.extend(
        '%s = %s' % kv for kv in console.items()
    )

    gui_scripts_to_generate = [
        '%s = %s' % kv for kv in gui.items()
    ]

    generated_console_scripts = []  # type: List[str]

    try:
        generated_console_scripts = maker.make_multiple(scripts_to_generate)
        generated.extend(generated_console_scripts)

        generated.extend(
            maker.make_multiple(gui_scripts_to_generate, {'gui': True})
        )
    except MissingCallableSuffix as e:
        entry = e.args[0]
        raise InstallationError(
            "Invalid script entry point: {} for req: {} - A callable "
            "suffix is required. Cf https://packaging.python.org/en/"
            "latest/distributing.html#console-scripts for more "
            "information.".format(entry, req)
        )

    if warn_script_location:
        msg = message_about_scripts_not_on_PATH(generated_console_scripts)
        if msg is not None:
            logger.warning(msg)

    # Record pip as the installer
    installer = os.path.join(info_dir[0], 'INSTALLER')
    temp_installer = os.path.join(info_dir[0], 'INSTALLER.pip')
    with open(temp_installer, 'wb') as installer_file:
        installer_file.write(b'pip\n')
    shutil.move(temp_installer, installer)
    generated.append(installer)

    # Record details of all files installed
    record = os.path.join(info_dir[0], 'RECORD')
    temp_record = os.path.join(info_dir[0], 'RECORD.pip')
    with open_for_csv(record, 'r') as record_in:
        with open_for_csv(temp_record, 'w+') as record_out:
            reader = csv.reader(record_in)
            outrows = get_csv_rows_for_installed(
                reader, installed=installed, changed=changed,
                generated=generated, lib_dir=lib_dir,
            )
            writer = csv.writer(record_out)
            # Sort to simplify testing.
            for row in sorted_outrows(outrows):
                writer.writerow(row)
    shutil.move(temp_record, record)


def wheel_version(source_dir):
    # type: (Optional[str]) -> Optional[Tuple[int, ...]]
    """
    Return the Wheel-Version of an extracted wheel, if possible.

    Otherwise, return None if we couldn't parse / extract it.
    """
    try:
        dist = [d for d in pkg_resources.find_on_path(None, source_dir)][0]

        wheel_data = dist.get_metadata('WHEEL')
        wheel_data = Parser().parsestr(wheel_data)

        version = wheel_data['Wheel-Version'].strip()
        version = tuple(map(int, version.split('.')))
        return version
    except Exception:
        return None


def check_compatibility(version, name):
    # type: (Optional[Tuple[int, ...]], str) -> None
    """
    Raises errors or warns if called with an incompatible Wheel-Version.

    Pip should refuse to install a Wheel-Version that's a major series
    ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when
    installing a version only minor version ahead (e.g 1.2 > 1.1).

    version: a 2-tuple representing a Wheel-Version (Major, Minor)
    name: name of wheel or package to raise exception about

    :raises UnsupportedWheel: when an incompatible Wheel-Version is given
    """
    if not version:
        raise UnsupportedWheel(
            "%s is in an unsupported or invalid wheel" % name
        )
    if version[0] > VERSION_COMPATIBLE[0]:
        raise UnsupportedWheel(
            "%s's Wheel-Version (%s) is not compatible with this version "
            "of pip" % (name, '.'.join(map(str, version)))
        )
    elif version > VERSION_COMPATIBLE:
        logger.warning(
            'Installing from a newer Wheel-Version (%s)',
            '.'.join(map(str, version)),
        )


def format_tag(file_tag):
    # type: (Tuple[str, ...]) -> str
    """
    Format three tags in the form "<python_tag>-<abi_tag>-<platform_tag>".

    :param file_tag: A 3-tuple of tags (python_tag, abi_tag, platform_tag).
    """
    return '-'.join(file_tag)


class Wheel(object):
    """A wheel file"""

    # TODO: Maybe move the class into the models sub-package
    # TODO: Maybe move the install code into this class

    wheel_file_re = re.compile(
        r"""^(?P<namever>(?P<name>.+?)-(?P<ver>.*?))
        ((-(?P<build>\d[^-]*?))?-(?P<pyver>.+?)-(?P<abi>.+?)-(?P<plat>.+?)
        \.whl|\.dist-info)$""",
        re.VERBOSE
    )

    def __init__(self, filename):
        # type: (str) -> None
        """
        :raises InvalidWheelFilename: when the filename is invalid for a wheel
        """
        wheel_info = self.wheel_file_re.match(filename)
        if not wheel_info:
            raise InvalidWheelFilename(
                "%s is not a valid wheel filename." % filename
            )
        self.filename = filename
        self.name = wheel_info.group('name').replace('_', '-')
        # we'll assume "_" means "-" due to wheel naming scheme
        # (https://github.com/pypa/pip/issues/1150)
        self.version = wheel_info.group('ver').replace('_', '-')
        self.build_tag = wheel_info.group('build')
        self.pyversions = wheel_info.group('pyver').split('.')
        self.abis = wheel_info.group('abi').split('.')
        self.plats = wheel_info.group('plat').split('.')

        # All the tag combinations from this file
        self.file_tags = {
            (x, y, z) for x in self.pyversions
            for y in self.abis for z in self.plats
        }

    def get_formatted_file_tags(self):
        # type: () -> List[str]
        """
        Return the wheel's tags as a sorted list of strings.
        """
        return sorted(format_tag(tag) for tag in self.file_tags)

    def support_index_min(self, tags):
        # type: (List[Pep425Tag]) -> int
        """
        Return the lowest index that one of the wheel's file_tag combinations
        achieves in the given list of supported tags.

        For example, if there are 8 supported tags and one of the file tags
        is first in the list, then return 0.

        :param tags: the PEP 425 tags to check the wheel against, in order
            with most preferred first.

        :raises ValueError: If none of the wheel's file tags match one of
            the supported tags.
        """
        return min(tags.index(tag) for tag in self.file_tags if tag in tags)

    def supported(self, tags):
        # type: (List[Pep425Tag]) -> bool
        """
        Return whether the wheel is compatible with one of the given tags.

        :param tags: the PEP 425 tags to check the wheel against.
        """
        return not self.file_tags.isdisjoint(tags)


def _contains_egg_info(
        s, _egg_info_re=re.compile(r'([a-z0-9_.]+)-([a-z0-9_.!+-]+)', re.I)):
    """Determine whether the string looks like an egg_info.

    :param s: The string to parse. E.g. foo-2.1
    """
    return bool(_egg_info_re.search(s))


def should_use_ephemeral_cache(
    req,  # type: InstallRequirement
    should_unpack,  # type: bool
    cache_available,  # type: bool
    check_binary_allowed,  # type: BinaryAllowedPredicate
):
    # type: (...) -> Optional[bool]
    """
    Return whether to build an InstallRequirement object using the
    ephemeral cache.

    :param cache_available: whether a cache directory is available for the
        should_unpack=True case.

    :return: True or False to build the requirement with ephem_cache=True
        or False, respectively; or None not to build the requirement.
    """
    if req.constraint:
        # never build requirements that are merely constraints
        return None
    if req.is_wheel:
        if not should_unpack:
            logger.info(
                'Skipping %s, due to already being wheel.', req.name,
            )
        return None
    if not should_unpack:
        # i.e. pip wheel, not pip install;
        # return False, knowing that the caller will never cache
        # in this case anyway, so this return merely means "build it".
        # TODO improve this behavior
        return False

    if req.editable or not req.source_dir:
        return None

    if not check_binary_allowed(req):
        logger.info(
            "Skipping wheel build for %s, due to binaries "
            "being disabled for it.", req.name,
        )
        return None

    if req.link and req.link.is_vcs:
        # VCS checkout. Build wheel just for this run.
        return True

    link = req.link
    base, ext = link.splitext()
    if cache_available and _contains_egg_info(base):
        return False

    # Otherwise, build the wheel just for this run using the ephemeral
    # cache since we are either in the case of e.g. a local directory, or
    # no cache directory is available to use.
    return True


def format_command_result(
    command_args,  # type: List[str]
    command_output,  # type: str
):
    # type: (...) -> str
    """
    Format command information for logging.
    """
    command_desc = format_command_args(command_args)
    text = 'Command arguments: {}\n'.format(command_desc)

    if not command_output:
        text += 'Command output: None'
    elif logger.getEffectiveLevel() > logging.DEBUG:
        text += 'Command output: [use --verbose to show]'
    else:
        if not command_output.endswith('\n'):
            command_output += '\n'
        text += 'Command output:\n{}{}'.format(command_output, LOG_DIVIDER)

    return text


def get_legacy_build_wheel_path(
    names,  # type: List[str]
    temp_dir,  # type: str
    req,  # type: InstallRequirement
    command_args,  # type: List[str]
    command_output,  # type: str
):
    # type: (...) -> Optional[str]
    """
    Return the path to the wheel in the temporary build directory.
    """
    # Sort for determinism.
    names = sorted(names)
    if not names:
        msg = (
            'Legacy build of wheel for {!r} created no files.\n'
        ).format(req.name)
        msg += format_command_result(command_args, command_output)
        logger.warning(msg)
        return None

    if len(names) > 1:
        msg = (
            'Legacy build of wheel for {!r} created more than one file.\n'
            'Filenames (choosing first): {}\n'
        ).format(req.name, names)
        msg += format_command_result(command_args, command_output)
        logger.warning(msg)

    return os.path.join(temp_dir, names[0])


def _always_true(_):
    return True


class WheelBuilder(object):
    """Build wheels from a RequirementSet."""

    def __init__(
        self,
        preparer,  # type: RequirementPreparer
        wheel_cache,  # type: WheelCache
        build_options=None,  # type: Optional[List[str]]
        global_options=None,  # type: Optional[List[str]]
        check_binary_allowed=None,  # type: Optional[BinaryAllowedPredicate]
        no_clean=False  # type: bool
    ):
        # type: (...) -> None
        if check_binary_allowed is None:
            # Binaries allowed by default.
            check_binary_allowed = _always_true

        self.preparer = preparer
        self.wheel_cache = wheel_cache

        self._wheel_dir = preparer.wheel_download_dir

        self.build_options = build_options or []
        self.global_options = global_options or []
        self.check_binary_allowed = check_binary_allowed
        self.no_clean = no_clean

    def _build_one(self, req, output_dir, python_tag=None):
        """Build one wheel.

        :return: The filename of the built wheel, or None if the build failed.
        """
        # Install build deps into temporary directory (PEP 518)
        with req.build_env:
            return self._build_one_inside_env(req, output_dir,
                                              python_tag=python_tag)

    def _build_one_inside_env(self, req, output_dir, python_tag=None):
        with TempDirectory(kind="wheel") as temp_dir:
            if req.use_pep517:
                builder = self._build_one_pep517
            else:
                builder = self._build_one_legacy
            wheel_path = builder(req, temp_dir.path, python_tag=python_tag)
            if wheel_path is not None:
                wheel_name = os.path.basename(wheel_path)
                dest_path = os.path.join(output_dir, wheel_name)
                try:
                    wheel_hash, length = hash_file(wheel_path)
                    shutil.move(wheel_path, dest_path)
                    logger.info('Created wheel for %s: '
                                'filename=%s size=%d sha256=%s',
                                req.name, wheel_name, length,
                                wheel_hash.hexdigest())
                    logger.info('Stored in directory: %s', output_dir)
                    return dest_path
                except Exception:
                    pass
            # Ignore return, we can't do anything else useful.
            self._clean_one(req)
            return None

    def _base_setup_args(self, req):
        # NOTE: Eventually, we'd want to also -S to the flags here, when we're
        # isolating. Currently, it breaks Python in virtualenvs, because it
        # relies on site.py to find parts of the standard library outside the
        # virtualenv.
        return make_setuptools_shim_args(
            req.setup_py_path,
            global_options=self.global_options,
            unbuffered_output=True
        )

    def _build_one_pep517(self, req, tempd, python_tag=None):
        """Build one InstallRequirement using the PEP 517 build process.

        Returns path to wheel if successfully built. Otherwise, returns None.
        """
        assert req.metadata_directory is not None
        if self.build_options:
            # PEP 517 does not support --build-options
            logger.error('Cannot build wheel for %s using PEP 517 when '
                         '--build-options is present' % (req.name,))
            return None
        try:
            logger.debug('Destination directory: %s', tempd)

            runner = runner_with_spinner_message(
                'Building wheel for {} (PEP 517)'.format(req.name)
            )
            backend = req.pep517_backend
            with backend.subprocess_runner(runner):
                wheel_name = backend.build_wheel(
                    tempd,
                    metadata_directory=req.metadata_directory,
                )
            if python_tag:
                # General PEP 517 backends don't necessarily support
                # a "--python-tag" option, so we rename the wheel
                # file directly.
                new_name = replace_python_tag(wheel_name, python_tag)
                os.rename(
                    os.path.join(tempd, wheel_name),
                    os.path.join(tempd, new_name)
                )
                # Reassign to simplify the return at the end of function
                wheel_name = new_name
        except Exception:
            logger.error('Failed building wheel for %s', req.name)
            return None
        return os.path.join(tempd, wheel_name)

    def _build_one_legacy(self, req, tempd, python_tag=None):
        """Build one InstallRequirement using the "legacy" build process.

        Returns path to wheel if successfully built. Otherwise, returns None.
        """
        base_args = self._base_setup_args(req)

        spin_message = 'Building wheel for %s (setup.py)' % (req.name,)
        with open_spinner(spin_message) as spinner:
            logger.debug('Destination directory: %s', tempd)
            wheel_args = base_args + ['bdist_wheel', '-d', tempd] \
                + self.build_options

            if python_tag is not None:
                wheel_args += ["--python-tag", python_tag]

            try:
                output = call_subprocess(
                    wheel_args,
                    cwd=req.unpacked_source_directory,
                    spinner=spinner,
                )
            except Exception:
                spinner.finish("error")
                logger.error('Failed building wheel for %s', req.name)
                return None

            names = os.listdir(tempd)
            wheel_path = get_legacy_build_wheel_path(
                names=names,
                temp_dir=tempd,
                req=req,
                command_args=wheel_args,
                command_output=output,
            )
            return wheel_path

    def _clean_one(self, req):
        base_args = self._base_setup_args(req)

        logger.info('Running setup.py clean for %s', req.name)
        clean_args = base_args + ['clean', '--all']
        try:
            call_subprocess(clean_args, cwd=req.source_dir)
            return True
        except Exception:
            logger.error('Failed cleaning build dir for %s', req.name)
            return False

    def build(
        self,
        requirements,  # type: Iterable[InstallRequirement]
        should_unpack=False  # type: bool
    ):
        # type: (...) -> List[InstallRequirement]
        """Build wheels.

        :param should_unpack: If True, after building the wheel, unpack it
            and replace the sdist with the unpacked version in preparation
            for installation.
        :return: True if all the wheels built correctly.
        """
        # pip install uses should_unpack=True.
        # pip install never provides a _wheel_dir.
        # pip wheel uses should_unpack=False.
        # pip wheel always provides a _wheel_dir (via the preparer).
        assert (
            (should_unpack and not self._wheel_dir) or
            (not should_unpack and self._wheel_dir)
        )

        buildset = []
        cache_available = bool(self.wheel_cache.cache_dir)

        for req in requirements:
            ephem_cache = should_use_ephemeral_cache(
                req,
                should_unpack=should_unpack,
                cache_available=cache_available,
                check_binary_allowed=self.check_binary_allowed,
            )
            if ephem_cache is None:
                continue

            # Determine where the wheel should go.
            if should_unpack:
                if ephem_cache:
                    output_dir = self.wheel_cache.get_ephem_path_for_link(
                        req.link
                    )
                else:
                    output_dir = self.wheel_cache.get_path_for_link(req.link)
            else:
                output_dir = self._wheel_dir

            buildset.append((req, output_dir))

        if not buildset:
            return []

        # TODO by @pradyunsg
        # Should break up this method into 2 separate methods.

        # Build the wheels.
        logger.info(
            'Building wheels for collected packages: %s',
            ', '.join([req.name for (req, _) in buildset]),
        )

        python_tag = None
        if should_unpack:
            python_tag = pep425tags.implementation_tag

        with indent_log():
            build_success, build_failure = [], []
            for req, output_dir in buildset:
                try:
                    ensure_dir(output_dir)
                except OSError as e:
                    logger.warning(
                        "Building wheel for %s failed: %s",
                        req.name, e,
                    )
                    build_failure.append(req)
                    continue

                wheel_file = self._build_one(
                    req, output_dir,
                    python_tag=python_tag,
                )
                if wheel_file:
                    build_success.append(req)
                    if should_unpack:
                        # XXX: This is mildly duplicative with prepare_files,
                        # but not close enough to pull out to a single common
                        # method.
                        # The code below assumes temporary source dirs -
                        # prevent it doing bad things.
                        if (
                            req.source_dir and
                            not has_delete_marker_file(req.source_dir)
                        ):
                            raise AssertionError(
                                "bad source dir - missing marker")
                        # Delete the source we built the wheel from
                        req.remove_temporary_source()
                        # set the build directory again - name is known from
                        # the work prepare_files did.
                        req.source_dir = req.ensure_build_location(
                            self.preparer.build_dir
                        )
                        # Update the link for this.
                        req.link = Link(path_to_url(wheel_file))
                        assert req.link.is_wheel
                        # extract the wheel into the dir
                        unpack_file(req.link.file_path, req.source_dir)
                else:
                    build_failure.append(req)

        # notify success/failure
        if build_success:
            logger.info(
                'Successfully built %s',
                ' '.join([req.name for req in build_success]),
            )
        if build_failure:
            logger.info(
                'Failed to build %s',
                ' '.join([req.name for req in build_failure]),
            )
        # Return a list of requirements that failed to build
        return build_failure
site-packages/pip/_internal/__pycache__/wheel.cpython-38.opt-1.pyc000064400000066275151446176770020774 0ustar00U

��.eH��@s4dZddlmZddlZddlZddlZddlZddlZddlZ	ddl
Z
ddlZddlZddl
Z
ddlZddlmZddlmZddlmZddlmZddlmZdd	lmZdd
lmZddlmZddlm Z m!Z!m"Z"dd
l#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-m.Z.m/Z/ddl0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6ddl7m8Z8ddl9m:Z:ddl;m<Z<ddl=m>Z>ddl?m@Z@e:�rddlAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMddlNmOZOddlPmQZQddlRmSZSddlTmUZUddlVmWZWeGeXdfZYeLeQgeZfZ[d Z\e�]e^�Z_d!d"�Z`dXd$d%�ZadYd&d'�Zbd(d)�Zcd*d+�Zdd,d-�Zee
�fd.e
jg�Zhd/d0�Zid1d2�Zjd3d4�Zkd5d6�Zld7d8�ZmGd9d:�d:en�Zod;d<�ZpGd=d>�d>e�ZqdZdAdB�ZrdCdD�ZsdEdF�ZtdGdH�ZuGdIdJ�dJev�Zwe
�fdKe
jx�fdLdM�ZydNdO�ZzdPdQ�Z{dRdS�Z|dTdU�Z}GdVdW�dWev�Z~dS)[zH
Support for installing and building the "wheel" binary package format.
�)�absolute_importN)�urlsafe_b64encode)�Parser)�
pkg_resources)�ScriptMaker)�get_export_entry)�canonicalize_name)�StringIO)�
pep425tags)�InstallationError�InvalidWheelFilename�UnsupportedWheel)�distutils_scheme�get_major_minor_version)�Link)�
indent_log)�has_delete_marker_file)�captured_stdout�
ensure_dir�read_chunks)�make_setuptools_shim_args)�LOG_DIVIDER�call_subprocess�format_command_args�runner_with_spinner_message)�
TempDirectory)�MYPY_CHECK_RUNNING)�open_spinner)�unpack_file)�path_to_url)�Dict�List�Optional�Sequence�Mapping�Tuple�IO�Text�Any�Iterable�Callable�Set)�Requirement)�InstallRequirement)�RequirementPreparer)�
WheelCache)�	Pep425Tag.)�rcCstj�||��tjjd�S)N�/)�os�path�relpath�replace�sep)�src�p�r:�7/usr/lib/python3.8/site-packages/pip/_internal/wheel.py�normpathOsr<�c	CsRt��}d}t|d��.}t||d�D]}|t|�7}|�|�q$W5QRX||fS)z5Return (hash, length) for path using hashlib.sha256()r�rb)�size)�hashlibZsha256�openr�len�update)r4�	blocksize�h�length�f�blockr:r:r;�	hash_fileSsrIcCs6t||�\}}dt|����d��d�}|t|�fS)z?Return (encoded_digest, length) for path using hashlib.sha256()zsha256=�latin1�=)rIr�digest�decode�rstrip�str)r4rDrErFrLr:r:r;�rehash_s���rPcCs6tjddkri}d}nddi}d}t|||f|�S)Nr��b�newline�)�sys�version_inforA)�name�mode�nl�binr:r:r;�open_for_csvjsr[cCs|�d�}||d<d�|�S)zBReplace the Python tag in a wheel file name with a new value.
    �-���)�split�join)Z	wheelnameZnew_tag�partsr:r:r;�replace_python_tagus
rac	Cs�tj�|�r�t|d��R}|��}|�d�s8W5QR�dStj�t�	��}d|tj
�d�}|��}W5QRXt|d��}|�|�|�|�W5QRXdSdS)	zLReplace #!python with #!/path/to/python
    Return True if file was changed.r>s#!pythonFs#!�ascii�wbTN)
r3r4�isfilerA�readline�
startswithrU�
executable�encode�getfilesystemencoding�linesep�read�write)r4Zscript�	firstlineZexename�restr:r:r;�
fix_script~s

rozX^(?P<namever>(?P<name>.+?)(-(?P<ver>.+?))?)
                                \.dist-info$c
Cs�|�dd�}t�|�D]p}t�|�}|r|�d�|krttj�||d���6}|D]*}|�	��
�}|dkrPW5QR�dSqPW5QRXqdS)zP
    Return True if the extracted wheel in wheeldir should go into purelib.
    r\�_rW�WHEELzroot-is-purelib: trueTF)r6r3�listdir�dist_info_re�match�grouprAr4r_�lowerrN)rW�wheeldirZname_folded�itemrt�wheel�liner:r:r;�root_is_purelib�s
 r{c	s�tj�|�siifSt|��8}t�}|D]}|�|���|�d�q(|�d�W5QRXtj	�
|�}|�di�}|�di�}dd��t�fdd�|�
�D��}t�fd	d�|�
�D��}||fS)
N�
rZconsole_scriptsZgui_scriptscSst|��dd��d�S)zRget the string representation of EntryPoint, remove space and split
        on '='� rTrK)rOr6r^)�sr:r:r;�	_split_ep�sz"get_entrypoints.<locals>._split_epc3s|]}�|�VqdS�Nr:��.0�v�rr:r;�	<genexpr>�sz"get_entrypoints.<locals>.<genexpr>c3s|]}�|�VqdSr�r:r�r�r:r;r��s)r3r4�existsrAr	rl�strip�seekrZ
EntryPointZ	parse_map�get�dict�values)�filename�fp�datarzZentry_points�console�guir:r�r;�get_entrypoints�s
r�csJ|sdSt�t�}|D]*}tj�|�}tj�|�}||�|�qdd�tj�	dd��
tj�D����tj�
tj�tj����fdd�|��D�}|s�dSg}|��D]b\}}t|�}t|�dkr�d	�|d
�}	n$d�d�|dd
��d|d
�}	|�d�|	|��q�d}
t|�dk�r0|�|
�d��n|�|
�d��d�|�S)z�Determine if any scripts are not on PATH and format a warning.

    Returns a warning message if one or more scripts are not on PATH,
    otherwise None.
    NcSs g|]}tj�|��tj��qSr:)r3r4�normcaserNr7)r��ir:r:r;�
<listcomp>�sz5message_about_scripts_not_on_PATH.<locals>.<listcomp>�PATHrTcs&i|]\}}tj�|��kr||�qSr:)r3r4r�)r��
parent_dir�scripts�Z
not_warn_dirsr:r;�
<dictcomp>�s�z5message_about_scripts_not_on_PATH.<locals>.<dictcomp>r1zscript {} isrzscripts {} are�, ���z and z.The {} installed in '{}' which is not on PATH.zeConsider adding {} to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.zthis directoryzthese directoriesr|)�collections�defaultdict�setr3r4�dirname�basename�add�environr�r^�pathsep�appendr�rUrg�items�sortedrB�formatr_)r�Zgrouped_by_dir�destfiler�Zscript_nameZwarn_for�	msg_linesZdir_scriptsZsorted_scriptsZ
start_textZ
last_line_fmtr:r�r;�!message_about_scripts_not_on_PATH�sH
�
�����r�cCst|dd�d�S)a;
    Return the given rows of a RECORD file in sorted order.

    Each row is a 3-tuple (path, hash, size) and corresponds to a record of
    a RECORD file (see PEP 376 and PEP 427 for details).  For the rows
    passed to this function, the size can be an integer as an int or string,
    or the empty string.
    cSstdd�|D��S)Ncss|]}t|�VqdSr�)rO)r��xr:r:r;r�sz3sorted_outrows.<locals>.<lambda>.<locals>.<genexpr>)�tuple)�rowr:r:r;�<lambda>�z sorted_outrows.<locals>.<lambda>)�key)r�)�outrowsr:r:r;�sorted_outrowssr�cCs�g}|D]v}t|�dkr(t�d�|��t|�}|d}|�||�}||d<||krpt|�\}	}
|	|d<|
|d<|�t|��q|D]*}t|�\}	}
|�t	||�|	t
|
�f�q�|D]}|�||ddf�q�|S)z_
    :param installed: A map from archive RECORD path to installation RECORD
        path.
    rQz,RECORD line has more than three elements: {}rr1�rT)rB�logger�warningr��list�poprPr�r�r<rO)Zold_csv_rows�	installed�changed�	generated�lib_dirZinstalled_rowsr�Zold_path�new_pathrLrFrGr:r:r;�get_csv_rows_for_installeds*�r�c@seZdZdS)�MissingCallableSuffixN)�__name__�
__module__�__qualname__r:r:r:r;r�=sr�cCs*t|�}|dk	r&|jdkr&tt|���dSr�)r�suffixr�rO)�
specification�entryr:r:r;�_raise_for_invalid_entrypointAsr�cseZdZd�fdd�	Z�ZS)�PipScriptMakerNcst|�tt|��||�Sr�)r��superr��make)�selfr�Zoptions��	__class__r:r;r�HszPipScriptMaker.make)N)r�r�r�r��
__classcell__r:r:r�r;r�Gsr�FTc-
sL|st||||||	d�}t|�	�r,|d�n|d�g�g��	�tjj�tjj}i�t��g}|r�t��4}
t�	�� t�
d�tj|ddd�W5QRXW5QRXt
�|
���d-����	fdd	�	�d.����fdd�	}||�d�tj��d
d�}t|�\����fdd�}�D]j}d
}d
}t�tj��	|��D]F}d
}|dk�rPt}|}tj��	||�}||}|||d||d��q6�qtd
|d�}d|_dh|_d|_g}��dd
�}|�r4dtjk�r�|�d|�tj�dd�dk�r|�dtjd
|f�|�dt�|f�dd��D�}|D]}�|=�q&��dd
�}|�r�dtjk�r`|�d|�|�dt�|f�dd��D�}|D]}�|=�q�|�dd ��� �D��d!d��� �D�}g}z.|�!|�}|�|�|�|�!|d"di��Wn>t"k
�r.}z|j#d
} t$d#�%| ����W5d
}~XYnX|
�rRt&|�}!|!d
k	�rRt
�'|!�tj��d
d$�}"tj��d
d%�}#t(|#d&��}$|$�)d'�W5QRXt*�+|#|"�|�|"�tj��d
d(�}%tj��d
d)�}&t,|%d*��\}'t,|&d+��F}(t-�.|'�})t/|)��|�d,�}*t-�0|(�}+t1|*�D]},|+�2|,��qW5QRXW5QRXt*�+|&|%�d
S)/zInstall a wheel)�user�home�root�isolated�prefixZpurelibZplatlib�ignoreT)�force�quietFcs.t|��}t|��}|�|<|r*��|�dS)z6Map archive RECORD paths to installation RECORD paths.N)r<r�)�srcfiler�ZmodifiedZoldpath�newpath)r�r�r�rwr:r;�record_installeds


z*move_wheel_files.<locals>.record_installedNcs�t|�t�|�D�]�\}}}|t|�d��tjj�}tj�||�}	|rf|�tjjd�d�	d�rfq|D]d}
tj�|||
�}|r�|dkr�|�	d�r���
|
�qjqj|rj|
�	d�rjt|
��t�j
��rj��
|�qj|D]�}|r�||�r�q�tj�||�}
tj�|||�}t|	�tj�|��r$t�|�t�|
|�t�|
�}ttd��rZt�||j|jf�t�|
tj��r�t�|
�}|jtjBtjBtjB}t�||�d}|�r�||�}�|
||�q�qdS)Nr1rz.datarTz
.dist-info�utimeF)rr3�walkrB�lstripr4r7r_r^�endswithr�rrfrWr��unlink�shutilZcopyfile�stat�hasattrr��st_atime�st_mtime�access�X_OK�st_mode�S_IXUSR�S_IXGRP�S_IXOTH�chmod)�source�destZis_base�fixer�filter�dirZsubdirs�filesZbasedirZdestdirr~Z
destsubdirrGr�r��stZpermissionsr�)�	data_dirs�info_dirr��reqr:r;�clobber�sP
���



�z!move_wheel_files.<locals>.clobberrzentry_points.txtcsh|���d�r|dd�}n<|���d�r8|dd�}n |���d�rT|dd�}n|}|�kpf|�kS)Nz.exe���z
-script.pyi����z.pya)rvr�)rWZ	matchname)r�r�r:r;�is_entrypoint_wrapper�sz/move_wheel_files.<locals>.is_entrypoint_wrapperr�)r�r�rTZpipZENSUREPIP_OPTIONSzpip = Z
altinstallz
pip%s = %scSsg|]}t�d|�r|�qS)zpip(\d(\.\d)?)?$��rert�r��kr:r:r;r�0sz$move_wheel_files.<locals>.<listcomp>Zeasy_installzeasy_install = zeasy_install-%s = %scSsg|]}t�d|�r|�qS)zeasy_install(-\d\.\d)?$r�r�r:r:r;r�@scss|]}d|VqdS)�%s = %sNr:�r�Zkvr:r:r;r�Gsz#move_wheel_files.<locals>.<genexpr>cSsg|]}d|�qS)r�r:r�r:r:r;r�Ksr�z�Invalid script entry point: {} for req: {} - A callable suffix is required. Cf https://packaging.python.org/en/latest/distributing.html#console-scripts for more information.Z	INSTALLERz
INSTALLER.piprcspip
ZRECORDz
RECORD.pip�rzw+)r�r�r�r�)F)NN)3rr{rNr3r4r7r�r�warnings�catch_warnings�filterwarnings�
compileall�compile_dirr��debug�getvaluer_r�rrror�r�ZvariantsZset_moder�r�r�r�rUrVr�extendr�Z
make_multipler��argsrr�r�r�rArlr��mover[�csv�readerr��writerr�Zwriterow)-rWr�rwr�r�r�Z	pycompileZschemer�r�Zwarn_script_locationr�r��stdoutr�Zep_filer�Zdatadirr�r�Zsubdirr�ZmakerZscripts_to_generateZ
pip_scriptZpip_epr�Zeasy_install_scriptZeasy_install_epZgui_scripts_to_generateZgenerated_console_scripts�er��msgZ	installerZtemp_installerZinstaller_file�recordZtemp_recordZ	record_inZ
record_outrr�r	r�r:)
r�r�r�r�r�r�r�r�r�rwr;�move_wheel_filesMs��



$F
#��
����

��

�
��



�
"rcCsrzVdd�t�d|�D�d}|�d�}t��|�}|d��}ttt|�	d���}|WSt
k
rlYdSXdS)z�
    Return the Wheel-Version of an extracted wheel, if possible.

    Otherwise, return None if we couldn't parse / extract it.
    cSsg|]}|�qSr:r:)r��dr:r:r;r��sz!wheel_version.<locals>.<listcomp>Nrrqz
Wheel-Version�.)rZfind_on_pathZget_metadatarZparsestrr�r��map�intr^�	Exception)�
source_dirZdistZ
wheel_data�versionr:r:r;�
wheel_versions
rcCsb|std|��|dtdkr>td|d�tt|��f��n |tkr^t�dd�tt|���dS)a�
    Raises errors or warns if called with an incompatible Wheel-Version.

    Pip should refuse to install a Wheel-Version that's a major series
    ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when
    installing a version only minor version ahead (e.g 1.2 > 1.1).

    version: a 2-tuple representing a Wheel-Version (Major, Minor)
    name: name of wheel or package to raise exception about

    :raises UnsupportedWheel: when an incompatible Wheel-Version is given
    z(%s is in an unsupported or invalid wheelrzB%s's Wheel-Version (%s) is not compatible with this version of piprz*Installing from a newer Wheel-Version (%s)N)r
�VERSION_COMPATIBLEr_rrOr�r�)rrWr:r:r;�check_compatibility�s����rcCs
d�|�S)z�
    Format three tags in the form "<python_tag>-<abi_tag>-<platform_tag>".

    :param file_tag: A 3-tuple of tags (python_tag, abi_tag, platform_tag).
    r\)r_)Zfile_tagr:r:r;�
format_tag�src@s>eZdZdZe�dej�Zdd�Zdd�Z	dd�Z
d	d
�ZdS)�WheelzA wheel filez�^(?P<namever>(?P<name>.+?)-(?P<ver>.*?))
        ((-(?P<build>\d[^-]*?))?-(?P<pyver>.+?)-(?P<abi>.+?)-(?P<plat>.+?)
        \.whl|\.dist-info)$cs��j�|�}|std|��|�_|�d��dd��_|�d��dd��_|�d��_|�d��	d��_
|�d	��	d��_|�d
��	d��_�fdd��j
D��_
d
S)zX
        :raises InvalidWheelFilename: when the filename is invalid for a wheel
        z!%s is not a valid wheel filename.rWrpr\Zver�buildZpyverrZabiZplatcs.h|]&}�jD]}�jD]}|||f�qqqSr:)�abis�plats)r�r��y�z�r�r:r;�	<setcomp>�s�z!Wheel.__init__.<locals>.<setcomp>N)�
wheel_file_rertrr�rur6rWrZ	build_tagr^Z
pyversionsrr�	file_tags)r�r�Z
wheel_infor:r r;�__init__�s�
�zWheel.__init__cCstdd�|jD��S)zF
        Return the wheel's tags as a sorted list of strings.
        css|]}t|�VqdSr�)r�r��tagr:r:r;r��sz0Wheel.get_formatted_file_tags.<locals>.<genexpr>)r�r#r r:r:r;�get_formatted_file_tags�szWheel.get_formatted_file_tagscst�fdd�|jD��S)a�
        Return the lowest index that one of the wheel's file_tag combinations
        achieves in the given list of supported tags.

        For example, if there are 8 supported tags and one of the file tags
        is first in the list, then return 0.

        :param tags: the PEP 425 tags to check the wheel against, in order
            with most preferred first.

        :raises ValueError: If none of the wheel's file tags match one of
            the supported tags.
        c3s |]}|�kr��|�VqdSr�)�indexr%��tagsr:r;r��sz*Wheel.support_index_min.<locals>.<genexpr>)�minr#�r�r*r:r)r;�support_index_min�szWheel.support_index_mincCs|j�|�S)z�
        Return whether the wheel is compatible with one of the given tags.

        :param tags: the PEP 425 tags to check the wheel against.
        )r#�
isdisjointr,r:r:r;�	supported�szWheel.supportedN)r�r�r��__doc__r��compile�VERBOSEr"r$r'r-r/r:r:r:r;r�s�rz([a-z0-9_.]+)-([a-z0-9_.!+-]+)cCst|�|��S)zjDetermine whether the string looks like an egg_info.

    :param s: The string to parse. E.g. foo-2.1
    )�bool�search)r~Z_egg_info_rer:r:r;�_contains_egg_infosr5cCs�|jr
dS|jr&|s"t�d|j�dS|s.dS|js:|js>dS||�sXt�d|j�dS|jrj|jjrjdS|j}|�	�\}}|r�t
|�r�dSdS)a[
    Return whether to build an InstallRequirement object using the
    ephemeral cache.

    :param cache_available: whether a cache directory is available for the
        should_unpack=True case.

    :return: True or False to build the requirement with ephem_cache=True
        or False, respectively; or None not to build the requirement.
    Nz(Skipping %s, due to already being wheel.FzCSkipping wheel build for %s, due to binaries being disabled for it.T)Z
constraintZis_wheelr��inforWZeditabler�linkZis_vcs�splitextr5)r��
should_unpack�cache_available�check_binary_allowedr7�baseZextr:r:r;�should_use_ephemeral_cache
s4��r=cCs^t|�}d�|�}|s |d7}n:t��tjkr8|d7}n"|�d�sJ|d7}|d�|t�7}|S)z1
    Format command information for logging.
    zCommand arguments: {}
zCommand output: Nonez'Command output: [use --verbose to show]r|zCommand output:
{}{})rr�r�ZgetEffectiveLevel�logging�DEBUGr�r)�command_args�command_outputZcommand_desc�textr:r:r;�format_command_resultGs



rCcCsxt|�}|s4d�|j�}|t||�7}t�|�dSt|�dkrfd�|j|�}|t||�7}t�|�tj�	||d�S)zH
    Return the path to the wheel in the temporary build directory.
    z1Legacy build of wheel for {!r} created no files.
Nr1zZLegacy build of wheel for {!r} created more than one file.
Filenames (choosing first): {}
r)
r�r�rWrCr�r�rBr3r4r_)�names�temp_dirr�r@rArr:r:r;�get_legacy_build_wheel_path^s$��
��
rFcCsdS)NTr:)rpr:r:r;�_always_true~srGc@s\eZdZdZddd�Zddd�Zddd	�Zd
d�Zddd
�Zddd�Z	dd�Z
ddd�ZdS)�WheelBuilderz#Build wheels from a RequirementSet.NFcCsD|dkrt}||_||_|j|_|p&g|_|p0g|_||_||_dSr�)	rG�preparer�wheel_cacheZwheel_download_dir�
_wheel_dir�
build_options�global_optionsr;�no_clean)r�rIrJrLrMr;rNr:r:r;r$�s


zWheelBuilder.__init__c
Cs.|j�|j|||d�W5QR�SQRXdS)ziBuild one wheel.

        :return: The filename of the built wheel, or None if the build failed.
        ��
python_tagN)Z	build_env�_build_one_inside_env)r�r��
output_dirrPr:r:r;�
_build_one�s�zWheelBuilder._build_onec
Cs�tdd���}|jr|j}n|j}|||j|d�}|dk	r�tj�|�}tj�||�}zNt|�\}	}
t	�
||�t�d|j
||
|	���t�d|�|WW5QR�Stk
r�YnX|�|�W5QR�dSQRXdS)Nry)ZkindrOz3Created wheel for %s: filename=%s size=%d sha256=%szStored in directory: %s)rZ
use_pep517�_build_one_pep517�_build_one_legacyr4r3r�r_rIr�rr�r6rWZ	hexdigestr�
_clean_one)r�r�rRrPrEZbuilder�
wheel_path�
wheel_nameZ	dest_pathZ
wheel_hashrFr:r:r;rQ�s.�
z"WheelBuilder._build_one_inside_envcCst|j|jdd�S)NT)rMZunbuffered_output)rZ
setup_py_pathrM)r�r�r:r:r;�_base_setup_args�s
�zWheelBuilder._base_setup_argsc	Cs�|jrt�d|jf�dSz~t�d|�td�|j��}|j}|�|��|j	||j
d�}W5QRX|r�t||�}t�
tj�||�tj�||��|}Wn$tk
r�t�d|j�YdSXtj�||�S)z�Build one InstallRequirement using the PEP 517 build process.

        Returns path to wheel if successfully built. Otherwise, returns None.
        zGCannot build wheel for %s using PEP 517 when --build-options is presentN�Destination directory: %szBuilding wheel for {} (PEP 517))�metadata_directory�Failed building wheel for %s)rLr��errorrWrrr�Zpep517_backendZsubprocess_runnerZbuild_wheelr[rar3�renamer4r_r)r�r��tempdrPZrunnerZbackendrX�new_namer:r:r;rT�s6�
��
�zWheelBuilder._build_one_pep517c
Cs�|�|�}d|jf}t|���}t�d|�|dd|g|j}|dk	rT|d|g7}zt||j|d�}Wn8tk
r�|�	d�t�
d	|j�YW5QR�dSXt�|�}	t
|	||||d
�}
|
W5QR�SQRXdS)z�Build one InstallRequirement using the "legacy" build process.

        Returns path to wheel if successfully built. Otherwise, returns None.
        z Building wheel for %s (setup.py)rZZbdist_wheelz-dNz--python-tag)�cwd�spinnerr]r\)rDrEr�r@rA)rYrWrr�rrLrZunpacked_source_directoryrZfinishr]r3rrrF)r�r�r_rP�	base_argsZspin_messagerbZ
wheel_args�outputrDrWr:r:r;rU�s8

��


�zWheelBuilder._build_one_legacycCsb|�|�}t�d|j�|ddg}zt||jd�WdStk
r\t�d|j�YdSXdS)NzRunning setup.py clean for %sZcleanz--all)raTz Failed cleaning build dir for %sF)rYr�r6rWrrrr])r�r�rcZ
clean_argsr:r:r;rVs
zWheelBuilder._clean_onec
Cs�g}t|jj�}|D]\}t||||jd�}|dkr4q|r\|rL|j�|j�}qb|j�|j�}n|j}|�	||f�q|szgSt
�dd�dd�|D���d}|r�t
j}t���gg}	}
|D]�\}}zt|�WnFtk
�r}z&t
�d|j|�|
�	|�WY�q�W5d}~XYnX|j|||d�}|�r�|	�	|�|�r�|j�rXt|j��sXtd	��|��|�|jj�|_tt|��|_t|jj|j�q�|
�	|�q�W5QRX|	�r�t
�d
d�dd�|	D���|
�r�t
�d
d�dd�|
D���|
S)aBuild wheels.

        :param should_unpack: If True, after building the wheel, unpack it
            and replace the sdist with the unpacked version in preparation
            for installation.
        :return: True if all the wheels built correctly.
        )r9r:r;Nz*Building wheels for collected packages: %sr�cSsg|]\}}|j�qSr:�rW)r�r�rpr:r:r;r�\sz&WheelBuilder.build.<locals>.<listcomp>z Building wheel for %s failed: %srOzbad source dir - missing markerzSuccessfully built %sr}cSsg|]
}|j�qSr:re�r�r�r:r:r;r��szFailed to build %scSsg|]
}|j�qSr:rerfr:r:r;r��s) r3rJ�	cache_dirr=r;Zget_ephem_path_for_linkr7Zget_path_for_linkrKr�r�r6r_r
Zimplementation_tagrr�OSErrorr�rWrSrr�AssertionErrorZremove_temporary_sourceZensure_build_locationrIZ	build_dirrrrZ	file_path)
r�Zrequirementsr9Zbuildsetr:r�Zephem_cacherRrPZ
build_successZ
build_failurerZ
wheel_filer:r:r;r#s����
�
�
������zWheelBuilder.build)NNNF)N)N)N)N)F)r�r�r�r0r$rSrQrYrTrUrVrr:r:r:r;rH�s�




'
%�rH)r=)r=)FNNTNFNT)r0Z
__future__rr�rrr@r>Zos.pathr3r�r�r�rUr��base64rZemail.parserrZpip._vendorrZpip._vendor.distlib.scriptsrZpip._vendor.distlib.utilrZpip._vendor.packaging.utilsrZpip._vendor.sixr	Z
pip._internalr
Zpip._internal.exceptionsrrr
Zpip._internal.locationsrrZpip._internal.models.linkrZpip._internal.utils.loggingrZ pip._internal.utils.marker_filesrZpip._internal.utils.miscrrrZ$pip._internal.utils.setuptools_buildrZpip._internal.utils.subprocessrrrrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.uirZpip._internal.utils.unpackingrZpip._internal.utils.urlsr�typingr r!r"r#r$r%r&r'r(r)r*r+Z"pip._vendor.packaging.requirementsr,Zpip._internal.req.req_installr-Z pip._internal.operations.preparer.Zpip._internal.cacher/Zpip._internal.pep425tagsr0rOZInstalledCSVRowr3ZBinaryAllowedPredicaterZ	getLoggerr�r�r<rIrPr[raror1r2rsr{r�r�r�r�rr�r�r�rrrr�objectr�Ir5r=rCrFrGrHr:r:r:r;�<module>s�8


	� =$
�
4
J�
	: site-packages/pip/_internal/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000320151446176770021402 0ustar00U

��.eP�@sddlZdS)�N)Z*pip._internal.utils.inject_securetransportZpip�rr�:/usr/lib/python3.8/site-packages/pip/_internal/__init__.py�<module>�site-packages/pip/_internal/__pycache__/locations.cpython-38.pyc000064400000006160151446176770020707 0ustar00U

��.e&�@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	mZ
ddlmZddl
mZddlmZddlmZdd	lmZer�dd
lmZmZmZmZmZe�d�Zdd
�Zdd�Ze�d�Z e�!��"�dkr�e
�#�Z ze�$�Z%Wne&k
�rej'Z%YnXe�r`ej(�)ej*d�Z+ej(�)e%d�Z,ej(�-e+��s�ej(�)ej*d�Z+ej(�)e%d�Z,nJej(�)ej*d�Z+ej(�)e%d�Z,ejdd�dk�r�ej*dd�dk�r�dZ+ddd�Z.dS)z7Locations where we look for configs, install stuff, etc�)�absolute_importN)�	sysconfig)�SCHEME_KEYS)�appdirs)�WINDOWS)�MYPY_CHECK_RUNNING)�running_under_virtualenv)�Any�Union�Dict�List�OptionalZpipcCsdjtj�S)ze
    Return the major-minor version of the current Python as a string, e.g.
    "3.7" or "3.10".
    z{}.{})�format�sys�version_info�rr�;/usr/lib/python3.8/site-packages/pip/_internal/locations.py�get_major_minor_versionsrcCsZt�rtj�tjd�}n6ztj�t��d�}Wntk
rLt�d�YnXtj�	|�S)N�srcz=The folder you are executing pip from can no longer be found.)
r�os�path�joinr�prefix�getcwd�OSError�exit�abspath)Z
src_prefixrrr�get_src_prefix(s�
r�purelibZpypyZScripts�bin��darwin�z/System/Library/z/usr/local/binFcCs�ddlm}i}|r ddgi}ni}d|i}	|	�|�||	�}
|
��|
jddd�}|d	k	s`t�|rx|rxtd
�||���|r�|r�td�||���|p�|j|_|s�|r�d|_|p�|j|_|p�|j	|_	|p�|j
|_
|��tD]}t
|d
|�||<q�d|
�d�k�r|�t|j|jd��t��r�tj�tjddd�t��|�|d<|d	k	�r�tj�tj�|d��d}
tj�||
dd	��|d<|S)z+
    Return a distutils install scheme
    r)�DistributionZscript_argsz
--no-user-cfg�nameZinstallT)ZcreateNzuser={} prefix={}zhome={} prefix={}�Zinstall_�install_lib)rZplatlibZinclude�sitezpython{}Zheaders�)Zdistutils.distr#�updateZparse_config_filesZget_command_obj�AssertionErrorr�userr�home�rootZfinalize_optionsr�getattrZget_option_dict�dictr&rrrrrr�
splitdriver)Z	dist_namer+r,r-�isolatedrr#ZschemeZextra_dist_argsZ	dist_args�d�i�keyZ
path_no_driverrr�distutils_scheme[sV
	
�
��
�r5)FNNFN)/�__doc__Z
__future__rrZos.path�platformr'rrZ	distutilsZdistutils_sysconfigZdistutils.command.installrZpip._internal.utilsrZpip._internal.utils.compatrZpip._internal.utils.typingrZpip._internal.utils.virtualenvr�typingr	r
rrr
Zuser_cache_dirZUSER_CACHE_DIRrrZget_pathZ
site_packagesZpython_implementation�lowerZget_python_lib�getusersitepackages�	user_site�AttributeError�	USER_SITErrrZbin_pyZbin_user�existsr5rrrr�<module>sN
	
(�site-packages/pip/_internal/__pycache__/pyproject.cpython-38.opt-1.pyc000064400000006076151446176770021700 0ustar00U

��.eZ�@s�ddlmZddlZddlZddlZddlmZmZddlm	Z	ddl
mZerhddlm
Z
mZmZmZdd�Zd	d
�Zdd�ZdS)
�)�absolute_importN)�pytoml�six)�InstallationError)�MYPY_CHECK_RUNNING)�Any�Tuple�Optional�ListcCst|t�otdd�|D��S)Ncss|]}t|tj�VqdS)N)�
isinstancerZstring_types)�.0�item�r�;/usr/lib/python3.8/site-packages/pip/_internal/pyproject.py�	<genexpr>sz"_is_list_of_str.<locals>.<genexpr>)r�list�all)�objrrr�_is_list_of_strs
�rcCs2tj�|d�}tjr.t|tj�r.|�t�	��}|S)Nzpyproject.toml)
�os�path�joinrZPY2rZ	text_type�encode�sys�getfilesystemencoding)Zunpacked_source_directoryrrrr�make_pyproject_pathsrc
	Cs<tj�|�}tj�|�}|rLtj|dd��}t�|�}W5QRX|�d�}nd}|rr|sr|dk	rl|sltd��d}n<|r�d|kr�|dk	r�|s�td�	|d���d}n|dkr�|}|s�dS|dkr�d	d
gdd�}d
}	d|kr�t|	j	|dd���|d}
t
|
��st|	j	|dd���|�d�}g}|dk�r2d}d	d
g}|
||fS)a�Load the pyproject.toml file.

    Parameters:
        use_pep517 - Has the user requested PEP 517 processing? None
                     means the user hasn't explicitly specified.
        pyproject_toml - Location of the project's pyproject.toml file
        setup_py - Location of the project's setup.py file
        req_name - The name of the requirement we're processing (for
                   error reporting)

    Returns:
        None if we should use the legacy code path, otherwise a tuple
        (
            requirements from pyproject.toml,
            name of PEP 517 backend,
            requirements we should check are installed after setting
                up the build environment
        )
    zutf-8)�encodingzbuild-systemNzIDisabling PEP 517 processing is invalid: project does not have a setup.pyT�
build-backendzbDisabling PEP 517 processing is invalid: project specifies a build backend of {} in pyproject.tomlzsetuptools>=40.8.0Zwheelz setuptools.build_meta:__legacy__)�requiresrzO{package} has a pyproject.toml file that does not comply with PEP 518: {reason}rz]it has a 'build-system' table but not 'build-system.requires' which is mandatory in the table)�package�reasonz1'build-system.requires' is not a list of strings.)rr�isfile�io�openr�load�getr�formatr)
Z
use_pep517Zpyproject_tomlZsetup_pyZreq_nameZ
has_pyprojectZ	has_setup�fZpp_tomlZbuild_systemZerror_templaterZbackendZcheckrrr�load_pyproject_toml#sb���
����
�


r()Z
__future__rr"rrZpip._vendorrrZpip._internal.exceptionsrZpip._internal.utils.typingr�typingrrr	r
rrr(rrrr�<module>ssite-packages/pip/_internal/__pycache__/pep425tags.cpython-38.opt-1.pyc000064400000023072151446176770021552 0ustar00U

��.eE>�@sTdZddlmZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
ZddlmZddlmZer�ddlmZmZmZmZmZmZmZeeeefZe�e�Ze� d�Z!d	d
�Z"dd�Z#d
d�Z$dd�Z%dd�Z&dd�Z'd-dd�Z(dd�Z)dd�Z*dd�Z+dd�Z,d d!�Z-d"d#�Z.d$d%�Z/d&d'�Z0d(d)�Z1d.d+d,�Z2e'�Z3dS)/z2Generate and work with PEP 425 Compatibility Tags.�)�absolute_importN)�OrderedDict)�get_extension_suffixes)�MYPY_CHECK_RUNNING)�Tuple�Callable�List�Optional�Union�Dict�Setz(.+)_(\d+)_(\d+)_(.+)c
CsLzt�|�WStk
rF}zt�d�|�t�WY�dSd}~XYnXdS)Nz{})�	sysconfig�get_config_var�IOError�warnings�warn�format�RuntimeWarning)�var�e�r�</usr/lib/python3.8/site-packages/pip/_internal/pep425tags.pyrs
rcCs:ttd�rd}n&tj�d�r"d}ntjdkr2d}nd}|S)z'Return abbreviated implementation name.�pypy_version_info�pp�javaZjyZcliZip�cp)�hasattr�sys�platform�
startswith)Zpyimplrrr�
get_abbr_impl&s

r cCsd�tt|dd���S)N��)�join�map�str)�version_inforrr�version_info_to_nodot4sr'cCs,td�}|rt�dkr(d�ttt���}|S)zReturn implementation version.Zpy_version_nodotrr!)rr r#r$r%�get_impl_version_info)Zimpl_verrrr�get_impl_ver:sr)cCs:t�dkr"tjdtjjtjjfStjdtjdfSdS)zQReturn sys.version_info-like tuple for use in decrementing the minor
    version.rr�N)r rr&r�major�minorrrrrr(Cs
�r(cCsd�t�t��S)z;
    Returns the Tag for this specific implementation.
    z{}{})rr r)rrrr�get_impl_tagQsr-TcCs.t|�}|dkr&|r t�d|�|�S||kS)zgUse a fallback method for determining SOABI flags if the needed config
    var is unset or unavailable.Nz>Config variable '%s' is unset, Python ABI tag may be incorrect)r�logger�debug)rZfallback�expectedr�valrrr�get_flagYs�r2cs�td�}t�}d}|s�|dkr�ttd�r�d}d}d}|dk�tddd	��d
�rRd}tjdkrvtd
�fdd	��d
�rvd}tjdkr�tddd	�d�d�r�d}d|t�|||f}n:|r�|�d�r�d|�d�d}n|r�|�	dd��	dd�}|S)zXReturn the ABI tag based on SOABI (if available) or emulate SOABI
    (CPython 2, PyPy).ZSOABIN>rr�
maxunicoder!rZPy_DEBUGcSs
ttd�S)NZgettotalrefcount)rrrrrr�<lambda>t�zget_abi_tag.<locals>.<lambda>)r�d)��Z
WITH_PYMALLOCcs�S)Nrr�Z
is_cpythonrrr4xr5�m)r7r7ZPy_UNICODE_SIZEcSs
tjdkS)Ni��)rr3rrrrr4{r5�)r0r�uz
%s%s%s%s%szcpython-�-r*�.�_)
rr rrr2r&r)r�split�replace)Zsoabi�impl�abir6r:r<rr9r�get_abi_tagfsB�
��rDcCs
tjdkS)Ni���)r�maxsizerrrr�_is_running_32bit�srFcCs�tjdkr^t��\}}}|�d�}|dkr6t�r6d}n|dkrHt�rHd}d�|d|d	|�Stj���	dd
��	dd
�}|dkr�t�r�d
}|S)z0Return our platform name 'win32', 'linux_x86_64'�darwinr>�x86_64�i386�ppc64�ppczmacosx_{}_{}_{}rr*r?r=�linux_x86_64�
linux_i686)
rrZmac_verr@rFr�	distutils�util�get_platformrA)�releaser?�machineZ	split_ver�resultrrrrP�s

rPc
Cs$t�dkrdSz&ttjd��}|�d�}W5QRXWntttfk
rPYdSX|dksft|�dkrjdSt	|t
�r�dd�|D�}ndd�|D�}|dd	�d
ddd
gk}||d	d�dgkM}||dd�dgkM}||dd�ddgkM}||dd�dgkM}||dd�dd	@d	kM}|S)N�linux_armv7lF�rb�(cSsg|]}t|��qSr)�ord)�.0�crrr�
<listcomp>�sz"is_linux_armhf.<locals>.<listcomp>cSsg|]}|�qSrr)rX�brrrrZ�srr;��E�L�F�r*����'�%�&)rP�openr�
executable�readr�OSError�	TypeError�len�
isinstancer%)�fZelf_header_rawZ
elf_headerrSrrr�is_linux_armhf�s&

roc	CsNt�dkrdSzddl}t|j�WSttfk
r:YnXtjjj	�
dd�S)N�rLrMFrr"r`)rP�
_manylinux�boolZmanylinux1_compatible�ImportError�AttributeError�pip�	_internal�utils�glibc�have_compatible_glibc�rqrrr�is_manylinux1_compatible�s
r{c	CsNt�dkrdSzddl}t|j�WSttfk
r:YnXtjjj	�
dd�S)NrpFrr"�)rPrqrrZmanylinux2010_compatiblersrtrurvrwrxryrzrrr�is_manylinux2010_compatible�s
r}c	Csdt�}|dkrdS|dkr$t�s$dSzddl}t|j�WSttfk
rPYnXtjj	j
�dd�S)N>�linux_s390xrMrL�
linux_ppc64lerT�
linux_aarch64�linux_ppc64FrTrr"�)rProrqrrZmanylinux2014_compatiblersrtrurvrwrxry)rrqrrr�is_manylinux2014_compatible�sr�csrg}��fdd��tddddg���|||�r8|�|��D]&}|�|kr<�|||�r<|�|�q<|�d�|S)z�Return a list of supported arches (including group arches) for
    the given major, minor and machine architecture of an macOS machine.
    cs||dkr||fdkS|dkr(||fdkS|dkr<||fdkS|dkrP||fdkS|�krx�|D]}�|||�r`dSq`dS)	NrK)�
r`rJrI)r�r;rHTFr)r+r,�arch�garch��_supports_arch�groupsrrr�sz)get_darwin_arches.<locals>._supports_arch)Zfat)rIrK)Zintel)rHrI)Zfat64)rHrJ)Zfat32)rHrIrKZ	universal)r�append)r+r,rR�archesr�rr�r�get_darwin_arches�s%�

r�c	CsFg}|dd�}t|ddd�D] }|�d�tt||f���q |S)N���r!)�ranger�r#r$r%)r&�versionsr+r,rrr�!get_all_minor_versions_as_strings>s
r�FcCsDg}|dkrt�}t|�}|p"t�}g}|p0t�}|rD|g|dd�<t�}t�D]$}	|	�d�rP|�|	�dd�d�qP|�	t
t|���|�d�|�s�|p�t
�}
|
�d�\}}}
|
�d	��r>t�|
�}|�r6|��\}}}}d
�||�}g}ttt|�d��D]0}tt|�||�D]}|�|||f��q�qn|
g}n�|dk�r~|
g}|
dk�r|�d
||
�|�d||
�n�|d
k�r�|
d||
g}nn|dk�rg}t��r�|�d||
�t��r�|�d
||
�t��r�|�d||
�|�|
�n|
g}|D].}|D]"}
|�d||df||
f��q�q|dd�D]F}|dk�r\�q�|D]*}|D]}
|�d||f||
f��qh�q`�qH|D]"}
|�d|ddd|
f��q�|�d||dfddf�|�d||ddfddf�t|�D]B\}}|�d|fddf�|dk�r�|�d|dddf��q�|S)acReturn a list of supported tags for each version specified in
    `versions`.

    :param versions: a list of string versions, of the form ["33", "32"],
        or None. The first version will be assumed to support our ABI.
    :param platform: specify the exact platform you want valid
        tags for, or None. If None, use the local system platform.
    :param impl: specify the exact implementation you want valid
        tags for, or None. If None, use the local interpreter impl.
    :param abi: specify the exact abi you want valid
        tags for, or None. If None, use the local interpreter abi.
    Nrz.abir>r"r*Znoner?Zmacosxz{}_{}_%i_%sZ
manylinux2014>�i686rHZ
manylinux2010Z
manylinux1z%s%s>�31�30zpy%s�any)r(r�r rD�setrr�addr@�extend�sorted�listr�rP�	partition�
_osx_arch_pat�matchr�r�reversedr��intr�r�r}r{�	enumerate)r�ZnoarchrrBrCZ	supportedr&ZabisZabi3s�suffixr�Zarch_prefixZarch_sepZarch_suffixr��namer+r,Zactual_archZtplr�r:�a�version�irrr�
get_supportedHs~










$
$  
r�)TT)NFNNN)4�__doc__Z
__future__rZdistutils.utilrNZloggingr�rerr
r�collectionsrZpip._internal.utils.glibcruZpip._internal.utils.compatrZpip._internal.utils.typingr�typingrrrr	r
rrr%Z	Pep425TagZ	getLogger�__name__r.�compiler�rr r'r)r(r-r2rDrFrPror{r}r�r�r�r�Zimplementation_tagrrrr�<module>sP$

		

!?�
ysite-packages/pip/_internal/__pycache__/locations.cpython-38.opt-1.pyc000064400000005766151446176770021661 0ustar00U

��.e&�@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	mZ
ddlmZddl
mZddlmZddlmZdd	lmZer�dd
lmZmZmZmZmZe�d�Zdd
�Zdd�Ze�d�Z e�!��"�dkr�e
�#�Z ze�$�Z%Wne&k
�rej'Z%YnXe�r`ej(�)ej*d�Z+ej(�)e%d�Z,ej(�-e+��s�ej(�)ej*d�Z+ej(�)e%d�Z,nJej(�)ej*d�Z+ej(�)e%d�Z,ejdd�dk�r�ej*dd�dk�r�dZ+ddd�Z.dS)z7Locations where we look for configs, install stuff, etc�)�absolute_importN)�	sysconfig)�SCHEME_KEYS)�appdirs)�WINDOWS)�MYPY_CHECK_RUNNING)�running_under_virtualenv)�Any�Union�Dict�List�OptionalZpipcCsdjtj�S)ze
    Return the major-minor version of the current Python as a string, e.g.
    "3.7" or "3.10".
    z{}.{})�format�sys�version_info�rr�;/usr/lib/python3.8/site-packages/pip/_internal/locations.py�get_major_minor_versionsrcCsZt�rtj�tjd�}n6ztj�t��d�}Wntk
rLt�d�YnXtj�	|�S)N�srcz=The folder you are executing pip from can no longer be found.)
r�os�path�joinr�prefix�getcwd�OSError�exit�abspath)Z
src_prefixrrr�get_src_prefix(s�
r�purelibZpypyZScripts�bin��darwin�z/System/Library/z/usr/local/binFcCsHddlm}i}|r ddgi}ni}d|i}	|	�|�||	�}
|
��|
jddd�}|p\|j|_|sh|rnd	|_|pv|j|_|p�|j|_|p�|j|_|�	�t
D]}t|d
|�||<q�d|
�d�kr�|�t
|j|jd��t��rDtj�tjd
dd�t��|�|d<|dk	�rDtj�tj�|d��d}
tj�||
dd��|d<|S)z+
    Return a distutils install scheme
    r)�DistributionZscript_argsz
--no-user-cfg�nameZinstallT)Zcreate�Zinstall_�install_lib)rZplatlibZinclude�sitezpython{}ZheadersN�)Zdistutils.distr#�updateZparse_config_filesZget_command_obj�userr�home�rootZfinalize_optionsr�getattrZget_option_dict�dictr&rrrrrrr�
splitdriver)Z	dist_namer*r+r,�isolatedrr#ZschemeZextra_dist_argsZ	dist_args�d�i�keyZ
path_no_driverrr�distutils_scheme[sP
	
�
��
�r4)FNNFN)/�__doc__Z
__future__rrZos.path�platformr'rrZ	distutilsZdistutils_sysconfigZdistutils.command.installrZpip._internal.utilsrZpip._internal.utils.compatrZpip._internal.utils.typingrZpip._internal.utils.virtualenvr�typingr	r
rrr
Zuser_cache_dirZUSER_CACHE_DIRrrZget_pathZ
site_packagesZpython_implementation�lowerZget_python_lib�getusersitepackages�	user_site�AttributeError�	USER_SITErrrZbin_pyZbin_user�existsr4rrrr�<module>sN
	
(�site-packages/pip/_internal/__pycache__/index.cpython-38.opt-1.pyc000064400000061246151446176770020770 0ustar00U

��.e��@s(dZddlmZddlZddlZddlmZddlmZddl	m
Zddlm
Z
mZmZmZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*e$�r�ddl+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3ddl	m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;m<Z<ddl=m>Z>e3e2de2e?e@ffZAe2e?e?e?e4eAe/e?fZBdddgZCe�DeE�ZFd1d!d"�ZGGd#d$�d$eH�ZId%d&�ZJGd'd(�d(eH�ZKGd)d�deH�ZLGd*d+�d+eH�ZMGd,d�deH�ZNd-d.�ZOd/d0�ZPdS)2z!Routines related to PyPI, indexes�)�absolute_importN)�
specifiers)�canonicalize_name)�parse)�BestVersionAlreadyInstalled�DistributionNotFound�InvalidWheelFilename�UnsupportedWheel)�InstallationCandidate)�
FormatControl)�Link)�SelectionPreferences)�TargetPython)�WHEEL_EXTENSION)�
indent_log)�build_netloc)�check_requires_python)�MYPY_CHECK_RUNNING)�SUPPORTED_EXTENSIONS)�url_to_path)�Wheel)�	FrozenSet�Iterable�List�Optional�Set�Text�Tuple�Union)�_BaseVersion)�
LinkCollector)�SearchScope)�InstallRequirement)�	Pep425Tag)�Hashes�r�BestCandidateResult�
PackageFinderFcCs~zt|j|d�}Wn&tjk
r8t�d|j|�YnBX|szd�tt|��}|sht�d||j|�dSt�d||j|�dS)aa
    Return whether the given Python version is compatible with a link's
    "Requires-Python" value.

    :param version_info: A 3-tuple of ints representing the Python
        major-minor-micro version to check.
    :param ignore_requires_python: Whether to ignore the "Requires-Python"
        value if the given Python version isn't compatible.
    )�version_infoz2Ignoring invalid Requires-Python (%r) for link: %s�.z4Link requires a different Python (%s not in: %r): %sFzBIgnoring failed Requires-Python check (%s not in: %r) for link: %sT)	rZrequires_pythonrZInvalidSpecifier�logger�debug�join�map�str)�linkr(�ignore_requires_pythonZ
is_compatible�versionr%r%�7/usr/lib/python3.8/site-packages/pip/_internal/index.py�_check_link_requires_python;s8�
�
��r3c@s,eZdZdZe�d�Zddd�Zdd�ZdS)	�
LinkEvaluatorzD
    Responsible for evaluating links for a particular project.
    z-py([123]\.?[0-9]?)$NcCs4|dkrd}||_||_||_||_||_||_dS)a�
        :param project_name: The user supplied package name.
        :param canonical_name: The canonical package name.
        :param formats: The formats allowed for this package. Should be a set
            with 'binary' or 'source' or both in it.
        :param target_python: The target Python interpreter to use when
            evaluating link compatibility. This is used, for example, to
            check wheel compatibility, as well as when checking the Python
            version, e.g. the Python version embedded in a link filename
            (or egg fragment) and against an HTML link's optional PEP 503
            "data-requires-python" attribute.
        :param allow_yanked: Whether files marked as yanked (in the sense
            of PEP 592) are permitted to be candidates for install.
        :param ignore_requires_python: Whether to ignore incompatible
            PEP 503 "data-requires-python" values in HTML links. Defaults
            to False.
        NF)�
_allow_yanked�_canonical_name�_ignore_requires_python�_formats�_target_python�project_name)�selfr:�canonical_name�formats�
target_python�allow_yankedr0r%r%r2�__init__rszLinkEvaluator.__init__cCs�d}|jr(|js(|jpd}dd�|�fS|jr<|j}|j}n�|��\}}|sPdS|tkrddd|fSd|jkr�|t	kr�d|j
}d|fSd	|jkr�|d
kr�dS|t	k�r,zt|j
�}Wntk
r�YdSXt|j�|jkr�d
|j
}d|fS|j��}|�|��s&|��}d�d�|��}d|fS|j}d|jk�rP|t	k�rPdd|j
fS|�sbt||j�}|�svdd|j
fS|j�|�}	|	�r�|d|	���}|	�d�}
|
|jjk�r�dSt||jj|j d�}|�s�dSt!�"d||�d|fS)aG
        Determine whether a link is a candidate for installation.

        :return: A tuple (is_candidate, result), where `result` is (1) a
            version string if `is_candidate` is True, and (2) if
            `is_candidate` is False, an optional string to log the reason
            the link fails to qualify.
        N�<none given>Fzyanked for reason: {})Fz
not a filezunsupported archive format: %sZbinaryzNo binaries permitted for %sZmacosx10z.zip)Fzmacosx10 one)Fzinvalid wheel filenamezwrong project name (not %s)z"none of the wheel's tags match: {}�, �sourcezNo sources permitted for %szMissing project version for %s�)FzPython version is incorrect)r(r0)FNzFound link %s, version: %sT)#�	is_yankedr5�
yanked_reason�format�egg_fragment�ext�splitextrr8rr:�pathr�filenamerr�namer6r9�get_tags�	supportedZget_formatted_file_tagsr,r1�_extract_version_from_fragment�_py_version_re�search�start�group�
py_versionr3Zpy_version_infor7r*r+)r;r/r1�reasonZegg_inforI�wheel�supported_tagsZ	file_tags�matchrUZsupports_pythonr%r%r2�
evaluate_link�sx





����
�zLinkEvaluator.evaluate_link)N)	�__name__�
__module__�__qualname__�__doc__�re�compilerQr@rZr%r%r%r2r4fs


�
&r4c
	Cs�|st�dt|�|�t|�Sg}g}d}|D]>}|j}|js@n"|j|d�rV|d7}n|�|�q.|�|�q.|rx|}nt|�}t|�t|�kr�d}	n d�t|�d�	dd	�|D���}	t�d
t|�||j
|t|�||	�|S)a�
    Filter out candidates whose hashes aren't allowed, and return a new
    list of candidates.

    If at least one candidate has an allowed hash, then all candidates with
    either an allowed hash or no hash specified are returned.  Otherwise,
    the given candidates are returned.

    Including the candidates with no hash specified when there is a match
    allows a warning to be logged if there is a more preferred candidate
    with no hash specified.  Returning all candidates in the case of no
    matches lets pip report the hash of the candidate that would otherwise
    have been installed (e.g. permitting the user to more easily update
    their requirements file with the desired hash).
    zJGiven no hashes to check %s links for project %r: discarding no candidatesr)�hashesrDzdiscarding no candidateszdiscarding {} non-matches:
  {}z
  css|]}t|j�VqdS�N)r.r/��.0�	candidater%r%r2�	<genexpr>+sz*filter_unallowed_hashes.<locals>.<genexpr>zPChecked %s links for project %r against %s hashes (%s matches, %s no digest): %s)r*r+�len�listr/Zhas_hash�is_hash_allowed�appendrGr,Zdigest_count)
�
candidatesrar:Zmatches_or_no_digestZnon_matchesZmatch_countrer/ZfilteredZdiscard_messager%r%r2�filter_unallowed_hashes�sL�

�
�rlc@seZdZdZddd�ZdS)�CandidatePreferenceszk
    Encapsulates some of the preferences for filtering and sorting
    InstallationCandidate objects.
    FcCs||_||_dS)zR
        :param allow_all_prereleases: Whether to allow all pre-releases.
        N)�allow_all_prereleases�
prefer_binary)r;rornr%r%r2r@Cs	zCandidatePreferences.__init__N)FF)r[r\r]r^r@r%r%r%r2rm<s�rmc@s(eZdZdZdd�Zdd�Zdd�ZdS)	r&z�A collection of candidates, returned by `PackageFinder.find_best_candidate`.

    This class is only intended to be instantiated by CandidateEvaluator's
    `compute_best_candidate()` method.
    cCs |dkr
n||_||_||_dS)a
        :param candidates: A sequence of all available candidates found.
        :param applicable_candidates: The applicable candidates.
        :param best_candidate: The most preferred candidate found, or None
            if no applicable candidates were found.
        N)�_applicable_candidates�_candidates�best_candidate�r;rk�applicable_candidatesrrr%r%r2r@Ws
zBestCandidateResult.__init__cCs
t|j�S)z(Iterate through all candidates.
        )�iterrq�r;r%r%r2�iter_allpszBestCandidateResult.iter_allcCs
t|j�S)z3Iterate through the applicable candidates.
        )rurprvr%r%r2�iter_applicablevsz#BestCandidateResult.iter_applicableN)r[r\r]r^r@rwrxr%r%r%r2r&Psc@sHeZdZdZeddd��Zddd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dS)�CandidateEvaluatorzm
    Responsible for filtering and sorting candidates for installation based
    on what tags are valid.
    NFcCs:|dkrt�}|dkrt��}|��}|||||||d�S)a�Create a CandidateEvaluator object.

        :param target_python: The target Python interpreter to use when
            checking compatibility. If None (the default), a TargetPython
            object will be constructed from the running Python.
        :param specifier: An optional object implementing `filter`
            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
            versions.
        :param hashes: An optional collection of allowed hashes.
        N)r:rX�	specifierrornra)rrZSpecifierSetrN)�clsr:r>rornrzrarXr%r%r2�create�s�zCandidateEvaluator.createcCs(||_||_||_||_||_||_dS)z�
        :param supported_tags: The PEP 425 tags supported by the target
            Python in order of preference (most preferred first).
        N)�_allow_all_prereleases�_hashes�_prefer_binary�
_project_name�
_specifier�_supported_tags)r;r:rXrzrornrar%r%r2r@�szCandidateEvaluator.__init__csV|jpd}|j}dd�|jdd�|D�|d�D���fdd�|D�}t||j|jd	�S)
zM
        Return the applicable candidates from a list of candidates.
        NcSsh|]}t|��qSr%)r.)rd�vr%r%r2�	<setcomp>�sz?CandidateEvaluator.get_applicable_candidates.<locals>.<setcomp>css|]}t|j�VqdSrb�r.r1�rd�cr%r%r2rf�sz?CandidateEvaluator.get_applicable_candidates.<locals>.<genexpr>)Zprereleasescsg|]}t|j��kr|�qSr%r�r��Zversionsr%r2�
<listcomp>�sz@CandidateEvaluator.get_applicable_candidates.<locals>.<listcomp>)rkrar:)r}r��filterrlr~r�)r;rkZallow_prereleasesrzrtr%r�r2�get_applicable_candidates�s 	
��
��z,CandidateEvaluator.get_applicable_candidatesc
Cs�|j}t|�}d}d}|j}|jr�t|j�}|�|�sDtd|j��|jrNd}|�	|�}|j
dk	r�t�d|j
�}	|	�
�}
t|
d�|
df}n|}t|�|j��}dt|j�}||||j||fS)a)
        Function to pass as the `key` argument to a call to sorted() to sort
        InstallationCandidates by preference.

        Returns a tuple such that tuples sorting as greater using Python's
        default comparison operator are more preferred.

        The preference is as follows:

        First and foremost, candidates with allowed (matching) hashes are
        always preferred over candidates without matching hashes. This is
        because e.g. if the only candidate with an allowed hash is yanked,
        we still want to use that candidate.

        Second, excepting hash considerations, candidates that have been
        yanked (in the sense of PEP 592) are always less preferred than
        candidates that haven't been yanked. Then:

        If not finding wheels, they are sorted by version only.
        If finding wheels, then the sort order is by version, then:
          1. existing installs
          2. wheels ordered via Wheel.support_index_min(self._supported_tags)
          3. source archives
        If prefer_binary was set, then all wheels are sorted above sources.

        Note: it was considered to embed this logic into the Link
              comparison operators, but then different sdist links
              with the same version, would have to be considered equal
        r%rzB%s is not a supported wheel for this platform. It can't be sorted.rDNz^(\d+)(.*)$���)r�rgr/Zis_wheelrrLrOr	rZsupport_index_min�	build_tagr_rY�groups�intrir~rEr1)
r;reZ
valid_tagsZsupport_numr�Zbinary_preferencer/rWZprirYZbuild_tag_groupsZhas_allowed_hashZ
yank_valuer%r%r2�	_sort_key�s<

��
�zCandidateEvaluator._sort_keycCsH|sdSt||jd�}|j}|jrD|jp*d}dj||d�}t�|�|S)zy
        Return the best candidate per the instance's sort order, or None if
        no candidate is acceptable.
        N��keyrAzqThe candidate selected for download or install is a yanked version: {candidate}
Reason for being yanked: {reason})rerV)�maxr�r/rErFrGr*Zwarning)r;rkrrr/rV�msgr%r%r2�sort_best_candidates	
��
z&CandidateEvaluator.sort_best_candidatecCs"|�|�}|�|�}t|||d�S)zF
        Compute and return a `BestCandidateResult` instance.
        )rtrr)r�r�r&rsr%r%r2�compute_best_candidate<s

�z)CandidateEvaluator.compute_best_candidate)NFFNN)FFN)r[r\r]r^�classmethodr|r@r�r�r�r�r%r%r%r2ry}s �)�
$<ryc@s�eZdZdZd&dd�Zed'dd��Zedd��Zej	d	d��Zed
d��Z
edd
��Zedd��Zedd��Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd(d d!�Zd)d"d#�Zd$d%�ZdS)*r'z�This finds packages.

    This is meant to match easy_install's technique for looking for
    packages, by reading pages and looking for appropriate links.
    NcCsP|dkrt�}|ptt�t��}||_||_||_||_||_||_t�|_	dS)a�
        This constructor is primarily meant to be used by the create() class
        method and from tests.

        :param format_control: A FormatControl object, used to control
            the selection of source packages / binary packages when consulting
            the index and links.
        :param candidate_prefs: Options to use when creating a
            CandidateEvaluator object.
        N)
rmr�setr5�_candidate_prefsr7�_link_collectorr9�format_control�
_logged_links)r;�link_collectorr>r?r��candidate_prefsr0r%r%r2r@VszPackageFinder.__init__cCs8|dkrt�}t|j|jd�}|||||j|j|jd�S)afCreate a PackageFinder.

        :param selection_prefs: The candidate selection preferences, as a
            SelectionPreferences object.
        :param target_python: The target Python interpreter to use when
            checking compatibility. If None (the default), a TargetPython
            object will be constructed from the running Python.
        N)rorn)r�r�r>r?r�r0)rrmrornr?r�r0)r{r�Zselection_prefsr>r�r%r%r2r|~s��zPackageFinder.createcCs|jjSrb�r��search_scopervr%r%r2r��szPackageFinder.search_scopecCs||j_dSrbr�)r;r�r%r%r2r��scCs|jjSrb)r��
find_linksrvr%r%r2r��szPackageFinder.find_linkscCs|jjSrb)r��
index_urlsrvr%r%r2r��szPackageFinder.index_urlsccs|jjjD]}t|�Vq
dSrb)r�ZsessionZpip_trusted_originsr)r;Z	host_portr%r%r2�
trusted_hosts�szPackageFinder.trusted_hostscCs|jjSrb�r�rnrvr%r%r2rn�sz#PackageFinder.allow_all_prereleasescCsd|j_dS)NTr�rvr%r%r2�set_allow_all_prereleases�sz'PackageFinder.set_allow_all_prereleasescCs.t|�}|j�|�}t||||j|j|jd�S)N)r:r<r=r>r?r0)rr�Zget_allowed_formatsr4r9r5r7)r;r:r<r=r%r%r2�make_link_evaluator�s�z!PackageFinder.make_link_evaluatorcCsPgg}}t�}|D]2}||kr|�|�|jr<|�|�q|�|�q||S)z�
        Returns elements of links in order, non-egg links first, egg links
        second, while eliminating duplicates
        )r��addrHrj)r;�linksZeggsZno_eggs�seenr/r%r%r2�_sort_links�s

zPackageFinder._sort_linkscCs(||jkr$t�d||�|j�|�dS)NzSkipping link: %s: %s)r�r*r+r�)r;r/rVr%r%r2�_log_skipped_link�s
zPackageFinder._log_skipped_linkcCs<|�|�\}}|s(|r$|j||d�dSt|j|t|�d�S)z�
        If the link is a candidate for install, convert it to an
        InstallationCandidate and return it. Otherwise, return None.
        )rVN)Zprojectr/r1)rZr�r
r:r.)r;�link_evaluatorr/Zis_candidate�resultr%r%r2�get_install_candidate�s�z#PackageFinder.get_install_candidatecCs6g}|�|�D]"}|�||�}|dk	r|�|�q|S)zU
        Convert links that are candidates to InstallationCandidate objects.
        N)r�r�rj)r;r�r�rkr/rer%r%r2�evaluate_linksszPackageFinder.evaluate_linksc

Cs�|j�|�}|�|�}|j||jd�}g}|j��D]>\}}t�d|�t	��|j||d�}|�
|�W5QRXq4|j||jd�}	|	r�|	jdd�t�dd�
dd�|	D���|	||S)	aFind all available InstallationCandidate for project_name

        This checks index_urls and find_links.
        All versions found are returned as an InstallationCandidate list.

        See LinkEvaluator.evaluate_link() for details on which files
        are accepted.
        )r�zAnalyzing links from page %sT)�reversezLocal files found: %srBcSsg|]}t|jj��qSr%)rr/Zurlrcr%r%r2r�2s�z5PackageFinder.find_all_candidates.<locals>.<listcomp>)r�Z
collect_linksr�r�r�Zpages�itemsr*r+r�extend�files�sortr,)
r;r:Zcollected_linksr�Zfind_links_versionsZ
page_versionsZpage_urlZ
page_linksZnew_versionsZ
file_versionsr%r%r2�find_all_candidates
s8

���
��	z!PackageFinder.find_all_candidatescCs"|j}tj||j|j|j||d�S)z3Create a CandidateEvaluator object to use.
        )r:r>rornrzra)r�ryr|r9rorn)r;r:rzrar�r%r%r2�make_candidate_evaluator;s	�z&PackageFinder.make_candidate_evaluatorcCs$|�|�}|j|||d�}|�|�S)aFind matches for the given project and specifier.

        :param specifier: An optional object implementing `filter`
            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
            versions.

        :return: A `BestCandidateResult` instance.
        )r:rzra)r�r�r�)r;r:rzrarkZcandidate_evaluatorr%r%r2�find_best_candidateNs
�z!PackageFinder.find_best_candidatec	Cs|jdd�}|j|j|j|d�}|j}d}|jdk	r@t|jj�}dd�}|dkrz|dkrzt�	d|||�
���td|��d}|r�|dks�|j|kr�d	}|s�|dk	r�|r�t�d
|�nt�d||j�dS|r�t�d|||�
���t�t�d
|j||�
���|jS)z�Try to find a Link matching req

        Expects req, an InstallRequirement and upgrade, a boolean
        Returns a Link if found,
        Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise
        F)Ztrust_internet)rzraNcSs d�tdd�|D�td��pdS)NrBcSsh|]}t|j��qSr%r�r�r%r%r2r�}szKPackageFinder.find_requirement.<locals>._format_versions.<locals>.<setcomp>r�Znone)r,�sorted�
parse_version)Z	cand_iterr%r%r2�_format_versionsws��z8PackageFinder.find_requirement.<locals>._format_versionszNCould not find a version that satisfies the requirement %s (from versions: %s)z%No matching distribution found for %sTzLExisting installed version (%s) is most up-to-date and satisfies requirementzUExisting installed version (%s) satisfies requirement (most up-to-date version is %s)z=Installed version (%s) is most up-to-date (past versions: %s)z)Using version %s (newest of versions: %s))rar�rMrzrrZsatisfied_byr�r1r*Zcriticalrwrr+rxrr/)	r;ZreqZupgraderaZbest_candidate_resultrrZinstalled_versionr�Zbest_installedr%r%r2�find_requirementesh�


������
�
�zPackageFinder.find_requirement)NNN)N)NN)NN)r[r\r]r^r@r�r|�propertyr��setterr�r�r�rnr�r�r�r�r�r�r�r�r�r�r%r%r%r2r'OsD�
(� 






1�
�
cCsLt|�D].\}}|dkrqt|d|��|kr|Sqtd�||���dS)a�Find the separator's index based on the package's canonical name.

    :param fragment: A <package>+<version> filename "fragment" (stem) or
        egg fragment.
    :param canonical_name: The package's canonical name.

    This function is needed since the canonicalized name does not necessarily
    have the same length as the egg info's name part. An example::

    >>> fragment = 'foo__bar-1.0'
    >>> canonical_name = 'foo-bar'
    >>> _find_name_version_sep(fragment, canonical_name)
    8
    �-Nz{} does not match {})�	enumerater�
ValueErrorrG)�fragmentr<�ir�r%r%r2�_find_name_version_sep�s
r�cCsBzt||�d}Wntk
r(YdSX||d�}|s>dS|S)z�Parse the version string from a <package>+<version> filename
    "fragment" (stem) or egg fragment.

    :param fragment: The string to parse. E.g. foo-2.1
    :param canonical_name: The canonicalized name of the package this
        belongs to.
    rDN)r�r�)r�r<Z
version_startr1r%r%r2rP�s	rP)F)Qr^Z
__future__rZloggingr_Zpip._vendor.packagingrZpip._vendor.packaging.utilsrZpip._vendor.packaging.versionrr�Zpip._internal.exceptionsrrrr	Zpip._internal.models.candidater
Z#pip._internal.models.format_controlrZpip._internal.models.linkrZ$pip._internal.models.selection_prefsr
Z"pip._internal.models.target_pythonrZpip._internal.utils.filetypesrZpip._internal.utils.loggingrZpip._internal.utils.miscrZpip._internal.utils.packagingrZpip._internal.utils.typingrZpip._internal.utils.unpackingrZpip._internal.utils.urlsrZpip._internal.wheelr�typingrrrrrrrrrZpip._internal.collectorr Z!pip._internal.models.search_scoper!Zpip._internal.reqr"Zpip._internal.pep425tagsr#Zpip._internal.utils.hashesr$r�r.ZBuildTagZCandidateSortingKey�__all__Z	getLoggerr[r*r3�objectr4rlrmr&ryr'r�rPr%r%r%r2�<module>s^(�

�
+K-Shsite-packages/pip/_internal/__pycache__/configuration.cpython-38.opt-1.pyc000064400000024475151446176770022533 0ustar00U

��.e�7�@sdZddlZddlZddlZddlZddlmZddlmZm	Z	ddl
mZddlm
Z
mZddlmZmZddlmZer�dd	lmZmZmZmZmZmZmZejZed
e�Ze�e �Z!dd�Z"d
d�Z#edddddd�Z$e
r�dndZ%dd�Z&Gdd�de'�Z(dS)aConfiguration management setup

Some terminology:
- name
  As written in config files.
- value
  Value associated with a name
- key
  Name combined with it's section (section.name)
- variant
  A single word describing where the configuration key-value pair came from
�N)�configparser)�ConfigurationError�!ConfigurationFileCouldNotBeLoaded)�appdirs)�WINDOWS�
expanduser)�
ensure_dir�enum)�MYPY_CHECK_RUNNING)�Any�Dict�Iterable�List�NewType�Optional�Tuple�KindcCs*|���dd�}|�d�r&|dd�}|S)zFMake a name consistent regardless of source (environment or file)
    �_�-z--�N)�lower�replace�
startswith)�name�r�?/usr/lib/python3.8/site-packages/pip/_internal/configuration.py�_normalize_name.s
rcCs&d|krd�|�}t|��|�dd�S)N�.zbKey does not contain dot separated section and key. Perhaps you wanted to use 'global.{}' instead?�)�formatr�split)rZ
error_messagerrr�_disassemble_key8s��r!�user�globalZsite�envzenv-var)�USER�GLOBAL�SITE�ENV�ENV_VARzpip.inizpip.confcCspdd�t�d�D�}tj�tjt�}tj�td�t	r8dndt�}tj�t�
d�t�}tj|tj
|gtj||giS)NcSsg|]}tj�|t��qSr)�os�path�join�CONFIG_BASENAME)�.0r+rrr�
<listcomp>Qs�z+get_configuration_files.<locals>.<listcomp>Zpip�~z.pip)rZsite_config_dirsr*r+r,�sys�prefixr-rrZuser_config_dir�kindsr&r'r%)Zglobal_config_filesZsite_config_fileZlegacy_config_fileZnew_config_filerrr�get_configuration_filesPs(�
���r4cs�eZdZdZd)�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Ze
dd��Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Z�ZS)*�
Configurationa�Handles management of configuration.

    Provides an interface to accessing and managing configuration files.

    This class converts provides an API that takes "section.key-name" style
    keys and stores the value associated with it as "key-name" under the
    section "section".

    This allows for a clean interface wherein the both the section and the
    key-name are preserved in an easy to manage form in the configuration files
    and the data stored is also nice.
    Nc
s�tt|���tjtjtjdg}||krJtd�d�	t
t|dd������||_||_
tjtjtjtjtjg|_ddg|_dd�|jD�|_dd�|jD�|_g|_dS)	Nz5Got invalid value for load_only - should be one of {}z, ����version�helpcSsi|]
}|g�qSrr�r.�variantrrr�
<dictcomp>�sz*Configuration.__init__.<locals>.<dictcomp>cSsi|]
}|i�qSrrr9rrrr;�s)�superr5�__init__r3r%r&r'rrr,�map�repr�isolated�	load_onlyr(r)�_override_order�_ignore_env_names�_parsers�_config�_modified_parsers)�selfr@rAZ_valid_load_only��	__class__rrr=ts0���
��zConfiguration.__init__cCs|��|js|��dS)zELoads configuration from configuration files and environment
        N)�_load_config_filesr@�_load_environment_vars�rGrrr�load�szConfiguration.loadcCs*z|��dWStk
r$YdSXdS)z@Returns the file with highest priority in configuration
        rN)�_get_parser_to_modify�
IndexErrorrLrrr�get_file_to_edit�szConfiguration.get_file_to_editcCs
|j��S)z`Returns key-value pairs like dict.items() representing the loaded
        configuration
        )�_dictionary�itemsrLrrrrR�szConfiguration.itemscCs4z|j|WStk
r.td�|���YnXdS)z,Get a value from the configuration.
        �No such key - {}N)rQ�KeyErrorrr)rG�keyrrr�	get_value�szConfiguration.get_valuecCsj|��|��\}}|dk	rJt|�\}}|�|�s<|�|�|�|||�||j|j|<|�||�dS)z-Modify a value in the configuration.
        N)	�_ensure_have_load_onlyrNr!�has_sectionZadd_section�setrErA�_mark_as_modified)rGrU�value�fname�parser�sectionrrrr�	set_value�s

zConfiguration.set_valuec	Cs�|��||j|jkr&td�|���|��\}}|dk	r�t|�\}}d}|�|�r`|�||�}|r�t	|�
|��}zt|�}Wntk
r�d}YnX|dkr�|�
|�|�||�ntd��|j|j|=dS)z,Unset a value in the configuration.
        rSNFz4Fatal Internal error [id=1]. Please report as a bug.)rWrErArrrNr!rXZ
remove_option�iterrR�next�
StopIterationZremove_sectionrZ)	rGrUr\r]r^rZmodified_somethingZsection_iter�valrrr�unset_value�s,


�zConfiguration.unset_valuec
CsX|��|jD]D\}}t�d|�ttj�|��t|d��}|�	|�W5QRXqdS)z*Save the current in-memory state.
        z
Writing to %s�wN)
rWrF�logger�inforr*r+�dirname�open�write)rGr\r]�frrr�save�szConfiguration.savecCs$|jdkrtd��t�d|j�dS)Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rArrf�debugrLrrrrWs
z$Configuration._ensure_have_load_onlycCs$i}|jD]}|�|j|�q
|S)z<A dictionary representing the loaded configuration.
        )rB�updaterE)rGZretvalr:rrrrQ	s
zConfiguration._dictionarycCs�t|���}|tjdd�tjgkr4t�d�dS|��D]V\}}|D]H}|j	dk	rp||j	krpt�d||�qH|�
||�}|j|�||f�qHq<dS)z5Loads configuration from configuration files
        rrzZSkipping loading configuration files due to environment's PIP_CONFIG_FILE being os.devnullNz Skipping file '%s' (variant: %s))
�dict�_iter_config_filesr3r(r*�devnullrfrmrRrA�
_load_filerD�append)rG�config_filesr:�filesr\r]rrrrJs"��z Configuration._load_config_filescCsLt�d||�|�|�}|��D]&}|�|�}|j|�|�||��q |S)Nz'For variant '%s', will try loading '%s')rfrm�_construct_parserZsectionsrRrErn�_normalized_keys)rGr:r\r]r^rRrrrrr2s

zConfiguration._load_filec
Cs�t��}tj�|�r|z|�|�WnXtk
rNtd�t	�
d��|d��Yn.tjk
rz}zt|d��W5d}~XYnX|S)Nzcontains invalid {} charactersF)�reasonr\)�error)r�RawConfigParserr*r+�exists�read�UnicodeDecodeErrorrr�localeZgetpreferredencoding�Error)rGr\r]ryrrrrv=s��
zConfiguration._construct_parsercCs"|jtj�|�d|����dS)z7Loads configuration from environment variables
        z:env:N)rEr3r)rnrw�_get_environ_varsrLrrrrKTs�z$Configuration._load_environment_varscCs.i}|D] \}}|dt|�}|||<q|S)z�Normalizes items to construct a dictionary with normalized keys.

        This routine is where the names become keys and are made the same
        regardless of source - configuration files or environment.
        r)r)rGr^rRZ
normalizedrrcrUrrrrw\s

zConfiguration._normalized_keysccsRtj��D]B\}}|�d�o0|dd���|jk}|r
|dd���|fVq
dS)z@Returns a generator with all environmental vars with prefix PIP_ZPIP_�N)r*�environrRrrrC)rGrUrcZshould_be_yieldedrrrr�is
�zConfiguration._get_environ_varsccs�tj�dd�}|dk	r&tj|gfVntjgfVt�}tj|tjfV|job|o`tj�	|�}|rztj
|tj
fVtj|tjfVdS)zYields variant and configuration files associated with it.

        This should be treated like items of a dictionary.
        ZPIP_CONFIG_FILEN)r*r��getr3r(r4r&r@r+r{r%r')rGZconfig_filertZshould_load_user_configrrrrpus	�z Configuration._iter_config_filescCs |j|j}|std��|dS)Nz4Fatal Internal error [id=2]. Please report as a bug.r6)rDrAr)rGZparsersrrrrN�s�z#Configuration._get_parser_to_modifycCs"||f}||jkr|j�|�dS)N)rFrs)rGr\r]Zfile_parser_tuplerrrrZ�s
zConfiguration._mark_as_modified)N)�__name__�
__module__�__qualname__�__doc__r=rMrPrRrVr_rdrlrW�propertyrQrJrrrvrKrwr�rprNrZ�
__classcell__rrrHrr5fs*
	'


r5))r�r~Zloggingr*r1Zpip._vendor.six.movesrZpip._internal.exceptionsrrZpip._internal.utilsrZpip._internal.utils.compatrrZpip._internal.utils.miscrr	Zpip._internal.utils.typingr
�typingrrr
rrrrrz�strrZ	getLoggerr�rfrr!r3r-r4�objectr5rrrr�<module>s6$


�	site-packages/pip/_internal/__pycache__/legacy_resolve.cpython-38.pyc000064400000024404151446176770021720 0ustar00U

��.eRC�@sFdZddlZddlZddlmZddlmZddlmZddl	m
Z
mZmZm
Z
mZddlmZddlmZmZmZmZdd	lmZmZdd
lmZe�rddlmZmZmZmZm Z m!Z!ddl"m#Z#dd
l$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ee0e-ge-fZ1e�2e3�Z4ddd�Z5Gdd�de6�Z7dS)ayDependency Resolution

The dependency resolution in pip is performed as follows:

for top-level requirements:
    a. only one spec allowed per project, regardless of conflicts or not.
       otherwise a "double requirement" exception is raised
    b. they override sub-dependency requirements.
for sub-dependencies
    a. "first found, wins" (where the order is breadth first)
�N)�defaultdict)�chain)�
specifiers)�BestVersionAlreadyInstalled�DistributionNotFound�	HashError�
HashErrors�UnsupportedPythonVersion)�
indent_log)�dist_in_install_path�dist_in_usersite�
ensure_dir�normalize_version_info)�check_requires_python�get_requires_python)�MYPY_CHECK_RUNNING)�Callable�DefaultDict�List�Optional�Set�Tuple)�
pkg_resources)�AbstractDistribution)�
PipSession)�
PackageFinder)�RequirementPreparer)�InstallRequirement)�RequirementSetFc
Cs�t|�}zt||d�}Wn:tjk
rR}zt�d|j|�WY�dSd}~XYnX|r\dSd�tt	|��}|r�t�
d|j||�dStd�|j||���dS)a�
    Check whether the given Python version is compatible with a distribution's
    "Requires-Python" value.

    :param version_info: A 3-tuple of ints representing the Python
        major-minor-micro version to check.
    :param ignore_requires_python: Whether to ignore the "Requires-Python"
        value if the given Python version isn't compatible.

    :raises UnsupportedPythonVersion: When the given Python version isn't
        compatible.
    )�version_infoz-Package %r has an invalid Requires-Python: %sN�.zBIgnoring failed Requires-Python check for package %r: %s not in %rz8Package {!r} requires a different Python: {} not in {!r})
rrrZInvalidSpecifier�logger�warningZproject_name�join�map�str�debugr	�format)�distr�ignore_requires_pythonZrequires_pythonZ
is_compatible�exc�version�r,�@/usr/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py�_check_dist_requires_python>s>�
����r.csdeZdZdZdddhZd�fdd�	Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Z�Z
S)�Resolverz�Resolves which packages need to be installed/uninstalled to perform     the requested operation without breaking the requirements of any package.
    �eager�only-if-needed�to-satisfy-onlyNcs�tt|���|
|jkst�|dkr4tjdd�}nt|�}||_||_	||_
||_d|_|
|_
|	|_||_||_||_||_||_tt�|_dS)N�)�superr/�__init__�_allowed_strategies�AssertionError�sysrr�_py_version_info�preparer�finder�session�require_hashes�upgrade_strategy�force_reinstall�ignore_dependencies�ignore_installedr)�
use_user_site�_make_install_reqr�list�_discovered_dependencies)�selfr:r<r;Zmake_install_reqrBr@rAr)r?r>Zpy_version_info��	__class__r,r-r5us&�zResolver.__init__c	Cs�|jjrt|jj�|jt|j���}|jp>tdd�|D��|_|j	j
}|��}|r`t�
|�g}t�}t||�D]N}z|�|�||��Wqttk
r�}z||_|�|�W5d}~XYqtXqt|r�|�dS)a�Resolve what operations need to be done

        As a side-effect of this method, the packages (and their dependencies)
        are downloaded, unpacked and prepared for installation. This
        preparation is done by ``pip.operations.prepare``.

        Once PyPI has static dependency metadata available, it would be
        possible to move the preparation to become a step separated from
        dependency resolution.
        css|]}|jVqdS�N)Zhas_hash_options)�.0�reqr,r,r-�	<genexpr>�sz#Resolver.resolve.<locals>.<genexpr>N)r:Zwheel_download_dirr
Zunnamed_requirementsrD�requirements�valuesr=�anyr;�search_scopeZget_formatted_locationsr!�inforr�extend�_resolve_onerrK�append)	rF�requirement_setZ	root_reqsrPZ	locationsZdiscovered_reqsZhash_errorsrKr*r,r,r-�resolve�s2
���

�zResolver.resolvecCs4|jdkrdS|jdkrdS|jdks*t�|jSdS)Nr2Fr0Tr1)r>r7�	is_direct�rFrKr,r,r-�_is_upgrade_allowed�s

zResolver._is_upgrade_allowedcCs,|jrt|j�r"t|j�r"|j|_d|_dS)z4
        Set a requirement to be installed.
        N)rBr�satisfied_byrZconflicts_withrXr,r,r-�_set_req_to_reinstall�s��zResolver._set_req_to_reinstallcCs�|jr
dS|�|j�|js dS|jr4|�|�dS|�|�sP|jdkrLdSdS|js�z|j	j
|dd�Wn(tk
r�YdStk
r�YnX|�|�dS)aCheck if req_to_install should be skipped.

        This will check if the req is installed, and whether we should upgrade
        or reinstall it, taking into account all the relevant user options.

        After calling this req_to_install will only have satisfied_by set to
        None if the req_to_install is to be upgraded/reinstalled etc. Any
        other value will be a dist recording the current thing installed that
        satisfies the requirement.

        Note that for vcs urls and the like we can't assess skipping in this
        routine - we simply identify that we need to pull the thing down,
        then later on it is pulled down and introspected to assess upgrade/
        reinstalls etc.

        :return: A text reason for why it was skipped, or None.
        Nr1z#already satisfied, skipping upgradezalready satisfiedT)Zupgradezalready up-to-date)
rA�check_if_existsrBrZr?r[rYr>�linkr;Zfind_requirementrr)rF�req_to_installr,r,r-�_check_skip_installed�s*



zResolver._check_skip_installedcCs�|jdk	std��|jr0|j�||j|j|j�S|jdks>t�|�|�}|jr`|j�	||j|�S|�
|�}|�|j||j�|j�||j
|j|j�}|js�|�|j�|jr�|jdkp�|jp�|jp�|jjdk}|r�|�|�nt�d|�|S)zzTakes a InstallRequirement and returns a single AbstractDist         representing a prepared variant of the same.
        Nz9require_hashes should have been set in Resolver.resolve()r2�filez<Requirement already satisfied (use --upgrade to upgrade): %s)r=r7�editabler:Zprepare_editable_requirementrBr;rZr_Zprepare_installed_requirementrYZ
populate_linkZprepare_linked_requirementr<rAr\r>r?r]Zschemer[r!rQ)rFrKZskip_reasonZupgrade_allowed�
abstract_distZ
should_modifyr,r,r-�_get_abstract_dist_forsV��
�
�
��
��zResolver._get_abstract_dist_forc
	s4�js�jrgSd�_�j�������}|��}t|�j�jd�g�����fdd�}t	�����
�j�s�d�_�j
�dd��j�s
�jr�t�dd��j��tt�j�t|j��}|D]}t�d	||�q�tt|j�t�j�@�}|�|�D]}	||	|d
�q��j�s&�j�s&�j���W5QRX�S)zxPrepare a single requirements file.

        :return: A list of additional InstallRequirements to also install.
        T)rr)csP��t|���}�j}�j|||d�\}}|rB|rB�j|�|���|�dS)N)�parent_req_name�extras_requested)rCr%�name�add_requirementrErTrR)�subreqreZsub_install_reqrdZ
to_scan_againZ
add_to_parent�Z	more_reqsr^rUrFr,r-�add_req}s��

�z&Resolver._resolve_one.<locals>.add_reqN)rdz!Installing extra requirements: %r�,z"%s does not provide the extra '%s')re)�
constraintZpreparedZreqs_to_cleanuprTrcZget_pkg_resources_distributionr.r9r)r
Zhas_requirementrfrWrgr@Zextrasr!r&r#�sorted�setr"ZrequiresrarZZsuccessfully_downloaded)
rFrUr^rbr(rjZmissing_requestedZmissingZavailable_requestedrhr,rir-rS[sV

��
����zResolver._resolve_onecs8g�t������fdd��|j��D]}�|�q&�S)z�Create the installation order.

        The installation order is topological - requirements are installed
        before the requiring thing. We break cycles at an arbitrary point,
        and make no other guarantees.
        csN|js|�krdS|jrdS��|��j|jD]}�|�q2��|�dSrI)rZrl�addrErfrT)rKZdep��orderZordered_reqs�schedulerFr,r-rr�s

z1Resolver.get_installation_order.<locals>.schedule)rnrMrN)rFZreq_setZinstall_reqr,rpr-�get_installation_order�s

zResolver.get_installation_order)N)�__name__�
__module__�__qualname__�__doc__r6r5rVrYr[r_rcrSrs�
__classcell__r,r,rGr-r/ns
�+3

5<Zr/)F)8rwZloggingr8�collectionsr�	itertoolsrZpip._vendor.packagingrZpip._internal.exceptionsrrrrr	Zpip._internal.utils.loggingr
Zpip._internal.utils.miscrrr
rZpip._internal.utils.packagingrrZpip._internal.utils.typingr�typingrrrrrrZpip._vendorrZpip._internal.distributionsrZpip._internal.network.sessionrZpip._internal.indexrZ pip._internal.operations.preparerZpip._internal.req.req_installrZpip._internal.req.req_setrr%ZInstallRequirementProviderZ	getLoggerrtr!r.�objectr/r,r,r,r-�<module>s4 
�
�
0site-packages/pip/_internal/__pycache__/main.cpython-38.opt-1.pyc000064400000002371151446176770020577 0ustar00U

��.eO�@s�dZddlmZddlZddlZddlZddlZddlmZddl	m
Z
ddlmZddl
mZddlmZe�e�Zdd	d
�ZdS)z Primary application entrypoint.
�)�absolute_importN)�autocomplete)�
parse_command)�create_command)�PipError)�deprecationc
Cs�|dkrtjdd�}t��t�zt|�\}}WnJtk
r~}z,tj�d|�tj�t	j
�t�d�W5d}~XYnXzt�
tjd�Wn0tjk
r�}zt�d|�W5d}~XYnXt|d|kd�}|�|�S)N�z	ERROR: %s�z%Ignoring error %s when setting localez
--isolated)�isolated)�sys�argvrZinstall_warning_loggerrrr�stderr�write�os�linesep�exit�locale�	setlocale�LC_ALL�Error�logger�debugr�main)�argsZcmd_nameZcmd_args�exc�eZcommand�r�6/usr/lib/python3.8/site-packages/pip/_internal/main.pyrs r)N)�__doc__Z
__future__rrZloggingrrZ pip._internal.cli.autocompletionrZpip._internal.cli.main_parserrZpip._internal.commandsrZpip._internal.exceptionsrZpip._internal.utilsrZ	getLogger�__name__rrrrrr�<module>s
site-packages/pip/_internal/__pycache__/pyproject.cpython-38.pyc000064400000006154151446176770020736 0ustar00U

��.eZ�@s�ddlmZddlZddlZddlZddlmZmZddlm	Z	ddl
mZerhddlm
Z
mZmZmZdd�Zd	d
�Zdd�ZdS)
�)�absolute_importN)�pytoml�six)�InstallationError)�MYPY_CHECK_RUNNING)�Any�Tuple�Optional�ListcCst|t�otdd�|D��S)Ncss|]}t|tj�VqdS)N)�
isinstancerZstring_types)�.0�item�r�;/usr/lib/python3.8/site-packages/pip/_internal/pyproject.py�	<genexpr>sz"_is_list_of_str.<locals>.<genexpr>)r�list�all)�objrrr�_is_list_of_strs
�rcCs2tj�|d�}tjr.t|tj�r.|�t�	��}|S)Nzpyproject.toml)
�os�path�joinrZPY2rZ	text_type�encode�sys�getfilesystemencoding)Zunpacked_source_directoryrrrr�make_pyproject_pathsrc
	CsVtj�|�}tj�|�}|rLtj|dd��}t�|�}W5QRX|�d�}nd}|rr|sr|dk	rl|sltd��d}n<|r�d|kr�|dk	r�|s�td�	|d���d}n|dkr�|}|dk	s�t
�|s�dS|dkr�d	d
gdd�}|dk	s�t
�d
}	d|k�rt|	j	|dd���|d}
t|
��s(t|	j	|dd���|�d�}g}|dk�rLd}d	d
g}|
||fS)a�Load the pyproject.toml file.

    Parameters:
        use_pep517 - Has the user requested PEP 517 processing? None
                     means the user hasn't explicitly specified.
        pyproject_toml - Location of the project's pyproject.toml file
        setup_py - Location of the project's setup.py file
        req_name - The name of the requirement we're processing (for
                   error reporting)

    Returns:
        None if we should use the legacy code path, otherwise a tuple
        (
            requirements from pyproject.toml,
            name of PEP 517 backend,
            requirements we should check are installed after setting
                up the build environment
        )
    zutf-8)�encodingzbuild-systemNzIDisabling PEP 517 processing is invalid: project does not have a setup.pyT�
build-backendzbDisabling PEP 517 processing is invalid: project specifies a build backend of {} in pyproject.tomlzsetuptools>=40.8.0Zwheelz setuptools.build_meta:__legacy__)�requiresrzO{package} has a pyproject.toml file that does not comply with PEP 518: {reason}rz]it has a 'build-system' table but not 'build-system.requires' which is mandatory in the table)�package�reasonz1'build-system.requires' is not a list of strings.)rr�isfile�io�openr�load�getr�format�AssertionErrorr)
Z
use_pep517Zpyproject_tomlZsetup_pyZreq_nameZ
has_pyprojectZ	has_setup�fZpp_tomlZbuild_systemZerror_templaterZbackendZcheckrrr�load_pyproject_toml#sf���
�	�
��
�


r))Z
__future__rr"rrZpip._vendorrrZpip._internal.exceptionsrZpip._internal.utils.typingr�typingrrr	r
rrr)rrrr�<module>ssite-packages/pip/_internal/__pycache__/collector.cpython-38.opt-1.pyc000064400000033422151446176770021642 0ustar00U

��.eWF�@s dZddlZddlZddlZddlZddlZddlmZddlm	Z	m
Z
ddlmZddl
mZmZmZddlmZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZm Z ddl!m"Z"m#Z#e�rDddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5e/j6j7j8Z9e)e:e:fZ;e�<e=�Z>dd�Z?dd�Z@Gdd�deA�ZBdd�ZCGdd�deA�ZDdd�ZEdd �ZFd!d"�ZGd#d$�ZHd%d&�ZId'd(�ZJd)d*�ZKGd+d,�d,eL�ZMd<d-d.�ZNd/d0�ZOd=d1d2�ZPd3d4�ZQd>d6d7�ZRGd8d9�d9eL�ZSGd:d;�d;eL�ZTdS)?zM
The main purpose of this module is to expose LinkCollector.collect_links().
�N)�OrderedDict)�html5lib�requests)�unescape)�	HTTPError�
RetryError�SSLError)�parse)�request��Link)�ARCHIVE_EXTENSIONS)�redact_auth_from_url)�MYPY_CHECK_RUNNING)�path_to_url�url_to_path)�is_url�vcs)	�Callable�Dict�Iterable�List�MutableMapping�Optional�Sequence�Tuple�Union)�Response)�SearchScope)�
PipSessioncCs6tjD]*}|���|�r|t|�dkr|SqdS)zgLook for VCS schemes in the URL.

    Returns the matched VCS scheme, or None if there's no match.
    z+:N)rZschemes�lower�
startswith�len)�url�scheme�r%�;/usr/lib/python3.8/site-packages/pip/_internal/collector.py�_match_vcs_scheme/s

r'cCs(t|�j}tD]}|�|�rdSqdS)z2Return whether the URL looks like an archive.
    TF)r�filenamer
�endswith)r#r(Zbad_extr%r%r&�_is_url_like_archive;s


r*cseZdZ�fdd�Z�ZS)�_NotHTMLcs"tt|��||�||_||_dS�N)�superr+�__init__�content_type�request_desc)�selfr/r0��	__class__r%r&r.Gsz_NotHTML.__init__)�__name__�
__module__�__qualname__r.�
__classcell__r%r%r2r&r+Fsr+cCs.|j�dd�}|���d�s*t||jj��dS)z�Check the Content-Type header to ensure the response contains HTML.

    Raises `_NotHTML` if the content type is not text/html.
    �Content-Type��	text/htmlN)�headers�getr r!r+r
�method)�responser/r%r%r&�_ensure_html_headerNsr?c@seZdZdS)�_NotHTTPN)r4r5r6r%r%r%r&r@Ysr@cCsDt�|�\}}}}}|dkr"t��|j|dd�}|��t|�dS)z�Send a HEAD request to the URL, and ensure the response contains HTML.

    Raises `_NotHTTP` if the URL is not available for a HEAD request, or
    `_NotHTML` if the content type is not text/html.
    >�http�httpsT)Zallow_redirectsN)�urllib_parseZurlsplitr@�head�raise_for_statusr?)r#�sessionr$�netloc�pathZqueryZfragment�respr%r%r&�_ensure_html_response]srJcCsLt|�rt||d�t�dt|��|j|ddd�d�}|��t|�|S)aAccess an HTML page with GET, and return the response.

    This consists of three parts:

    1. If the URL looks suspiciously like an archive, send a HEAD first to
       check the Content-Type is HTML, to avoid downloading a large file.
       Raise `_NotHTTP` if the content type cannot be determined, or
       `_NotHTML` if it is not HTML.
    2. Actually perform the request. Raise HTTP exceptions on network failures.
    3. Check the Content-Type header to make sure we got HTML, and raise
       `_NotHTML` otherwise.
    �rFzGetting page %sr:z	max-age=0)ZAcceptz
Cache-Control)r;)r*rJ�logger�debugrr<rEr?)r#rFrIr%r%r&�_get_html_responsens��rNcCs2|r.d|kr.t�|d�\}}d|kr.|dSdS)zBDetermine if we have any encoding information in our headers.
    r8�charsetN)�cgiZparse_header)r;r/Zparamsr%r%r&�_get_encoding_from_headers�s
rQcCs.|�d�D]}|�d�}|dk	r
|Sq
|S)a�Determine the HTML document's base URL.

    This looks for a ``<base>`` tag in the HTML document. If present, its href
    attribute denotes the base URL of anchor tags in the document. If there is
    no such tag (or if it does not have a valid href attribute), the HTML
    file's URL is used as the base URL.

    :param document: An HTML document representation. The current
        implementation expects the result of ``html5lib.parse()``.
    :param page_url: The URL of the HTML document.
    z.//base�hrefN)�findallr<)�document�page_url�baserRr%r%r&�_determine_base_url�s



rWcCsPt�|�}|jdkr(t�t�|j��}ntjt�|j�dd�}t�	|j
|d��S)z�Makes sure a link is fully encoded.  That is, if a ' ' shows up in
    the link, it will be rewritten to %20 (while not over-quoting
    % or other characters).r9z/@)Zsafe)rH)rC�urlparserG�urllib_requestZpathname2url�url2pathnamerHZquoteZunquoteZ
urlunparse�_replace)r#�resultrHr%r%r&�_clean_link�s	


�r]cCsf|�d�}|sdStt�||��}|�d�}|r8t|�nd}|�d�}|rRt|�}t||||d�}|S)zJ
    Convert an anchor element in a simple repository page to a Link.
    rRNzdata-requires-pythonzdata-yanked)Z
comes_fromZrequires_python�
yanked_reason)r<r]rC�urljoinrr)�anchorrU�base_urlrRr#Z	pyrequirer^�linkr%r%r&�_create_link_from_element�s 	


�rcccsVtj|j|jdd�}|j}t||�}|�d�D]"}t|||d�}|dkrJq.|Vq.dS)zP
    Parse an HTML document, and yield its anchor elements as Link objects.
    F)Ztransport_encodingZnamespaceHTMLElementsz.//a)rUraN)rr	�content�encodingr#rWrSrc)�pagerTr#rar`rbr%r%r&�parse_links�s �
�rgc@s eZdZdZdd�Zdd�ZdS)�HTMLPagez'Represents one page, along with its URLcCs||_||_||_dS)z�
        :param encoding: the encoding to decode the given content.
        :param url: the URL from which the HTML was downloaded.
        N)rdrer#)r1rdrer#r%r%r&r.szHTMLPage.__init__cCs
t|j�Sr,)rr#�r1r%r%r&�__str__$szHTMLPage.__str__N)r4r5r6�__doc__r.rjr%r%r%r&rhsrhcCs|dkrtj}|d||�dS)Nz%Could not fetch URL %s: %s - skipping)rLrM)rb�reason�methr%r%r&�_handle_get_page_fail(srncCst|j�}t|j||jd�S)N)rer#)rQr;rhrdr#)r>rer%r%r&�_make_html_page3s
roc

Cs�|dkrtd��|j�dd�d}t|�}|r@t�d||�dSt�|�\}}}}}}|dkr�tj	�
t�|��r�|�
d�s�|d7}t�|d�}t�d	|�zt||d
�}W�nDtk
r�t�d|�Y�n,tk
�r}zt�d||j|j�W5d}~XYn�tk
�r0}zt||�W5d}~XYn�tk
�r\}zt||�W5d}~XYn�tk
�r�}z$d
}	|	t|�7}	t||	tjd�W5d}~XYn\tjk
�r�}zt|d|�W5d}~XYn*tjk
�r�t|d�Yn
Xt|�SdS)Nz?_get_html_page() missing 1 required keyword argument: 'session'�#�rzCannot look at %s URL %s�file�/z
index.htmlz# file: URL is directory, getting %srKzQSkipping page %s because it looks like an archive, and cannot be checked by HEAD.z<Skipping page %s because the %s request got Content-Type: %sz4There was a problem confirming the ssl certificate: )rmzconnection error: %sz	timed out)�	TypeErrorr#�splitr'rLrMrCrX�osrH�isdirrYrZr)r_rNr@r+r0r/rrnrr�str�infor�ConnectionErrorZTimeoutro)
rbrFr#Z
vcs_schemer$�_rHrI�excrlr%r%r&�_get_html_page9sV�
�
� r}cCstt�|��S)zQ
    Return a list of links, with duplicates removed and ordering preserved.
    )�listr�fromkeys)Zlinksr%r%r&�_remove_duplicate_linksosr�Fcs�g�g���fdd�}|D]�}tj�|�}|�d�}|s<|r�|rF|}nt|�}tj�|�r�|r�tj�|�}t�|�D]}|tj�||��qtq�|r���	|�q�t
�d�|��q�tj�
|�r�||�q�t
�d|�qt|�r��	|�qt
�d|�q��fS)z�
    Divide a list of locations into two groups: "files" (archives) and "urls."

    :return: A pair of lists (files, urls).
    cs8t|�}tj|dd�ddkr*��|�n
��|�dS)NF)�strictrr:)r�	mimetypesZ
guess_type�append)rHr#��filesZurlsr%r&�	sort_path�sz"group_locations.<locals>.sort_pathzfile:z)Path '{0}' is ignored: it is a directory.z:Url '%s' is ignored: it is neither a file nor a directory.zQUrl '%s' is ignored. It is either a non-existing path or lacks a specific scheme.)rvrH�existsr!rrw�realpath�listdir�joinr�rLZwarning�format�isfiler)�	locations�
expand_dirr�r#Z
is_local_pathZis_file_urlrH�itemr%r�r&�group_locationsxsF
��
��r�c@seZdZdZdd�ZdS)�CollectedLinksa
    Encapsulates all the Link objects collected by a call to
    LinkCollector.collect_links(), stored separately as--

    (1) links from the configured file locations,
    (2) links from the configured find_links, and
    (3) a dict mapping HTML page url to links from that page.
    cCs||_||_||_dS)z�
        :param files: Links from file locations.
        :param find_links: Links from find_links.
        :param pages: A dict mapping HTML page url to links from that page.
        N�r��
find_links�pages)r1r�r�r�r%r%r&r.�szCollectedLinks.__init__N)r4r5r6rkr.r%r%r%r&r��s	r�c@s4eZdZdZdd�Zedd��Zdd�Zdd	�Zd
S)�
LinkCollectorz�
    Responsible for collecting Link objects from all configured locations,
    making network requests as needed.

    The class's main method is its collect_links() method.
    cCs||_||_dSr,)�search_scoperF)r1rFr�r%r%r&r.�szLinkCollector.__init__cCs|jjSr,)r�r�rir%r%r&r��szLinkCollector.find_linksccs,|D]"}t||jd�}|dkr q|VqdS)zp
        Yields (page, page_url) from the given locations, skipping
        locations that have errors.
        rKN)r}rF)r1r��locationrfr%r%r&�
_get_pages�s
zLinkCollector._get_pagescs��j}|�|�}t|�\}}t�jdd�\}}dd�t�||�D�}dd��jD�}	�fdd�t�dd�|D�d	d�|D��D�}
t|
�}
d
�t|
�|�g}|
D]}|�	d�|��q�t
�d�|��i}
��
|
�D]}tt|��|
|j<q�t||	|
d
�S)z�Find all available links for the given project name.

        :return: All the Link objects (unfiltered), as a CollectedLinks object.
        T)r�cSsg|]}t|��qSr%r��.0r#r%r%r&�
<listcomp>sz/LinkCollector.collect_links.<locals>.<listcomp>cSsg|]}t|d��qS)z-frr�r%r%r&r�scsg|]}�j�|�r|�qSr%)rFZis_secure_origin)r�rbrir%r&r�
s�css|]}t|�VqdSr,rr�r%r%r&�	<genexpr>sz.LinkCollector.collect_links.<locals>.<genexpr>css|]}t|�VqdSr,rr�r%r%r&r�
sz,{} location(s) to search for versions of {}:z* {}�
r�)r�Zget_index_urls_locationsr�r��	itertools�chainr�r�r"r�rLrMr�r�r~rgr#r�)r1Zproject_namer�Zindex_locationsZindex_file_locZ
index_url_locZfl_file_locZ
fl_url_locZ
file_linksZfind_link_linksZ
url_locations�linesrbZpages_linksrfr%rir&�
collect_links�sD
�

�
�����zLinkCollector.collect_linksN)	r4r5r6rkr.�propertyr�r�r�r%r%r%r&r��s	

r�)N)N)F)UrkrPr�Zloggingr�rv�collectionsrZpip._vendorrrZpip._vendor.distlib.compatrZpip._vendor.requests.exceptionsrrrZpip._vendor.six.moves.urllibr	rCr
rYZpip._internal.models.linkrZpip._internal.utils.filetypesr
Zpip._internal.utils.miscrZpip._internal.utils.typingrZpip._internal.utils.urlsrrZpip._internal.vcsrr�typingrrrrrrrrrZxml.etree.ElementTreeZxmlZpip._vendor.requestsrZ!pip._internal.models.search_scoperZpip._internal.network.sessionrZetreeZElementTreeZElementZHTMLElementrxZResponseHeadersZ	getLoggerr4rLr'r*�	Exceptionr+r?r@rJrNrQrWr]rcrg�objectrhrnror}r�r�r�r�r%r%r%r&�<module>s^,

3 �

6	
;site-packages/pip/_internal/__pycache__/download.cpython-38.opt-1.pyc000064400000026231151446176770021463 0ustar00U

��.eEQ�@s�ddlmZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZm
Z
ddlmZddlmZddlmZmZddlmZdd	lmZdd
lmZddlmZddlmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd
l(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3e+�r�ddl4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:ddl;m<Z<ddl=m>Z>ddl?m@Z@ddlAmBZBe�r�e<de6eCe7eCge7eCfeDd�dd�ZEn8e<de6eCeCgdfe6eCe7eCge7eCfeDeDd�dd�ZEdddd d!d"d#gZFe�GeH�ZId=d$d�ZJe�Kd%ejL�ZMd&d�ZNd'd(�ZOd)d*�ZPd+d,�ZQd-d.�ZRd>d0d �ZSd1d2�ZTd3d4�ZUd?d5d�ZVd@d6d!�ZWd7d#�ZXd8d"�ZYd9d:�ZZd;d<�Z[dS)A�)�absolute_importN)�requests)�CONTENT_CHUNK_SIZE�Response)�PY2)�parse)�HashMismatch�InstallationError)�PyPI)�
PipSession)�auto_decode)�copy2_fixed)	�ask_path_exists�
backup_dir�consume�display_path�format_size�hide_url�path_to_display�rmtree�splitext)�
TempDirectory)�MYPY_CHECK_RUNNING)�DownloadProgressProvider)�unpack_file)�get_url_scheme)�vcs)�IO�Callable�List�Optional�Text�Tuple)�	TypedDict)�Link)�Hashes)�VersionControl�CopytreeKwargs��ignore�symlinksF)Ztotal)�
copy_functionr)Zignore_dangling_symlinksr*�get_file_content�unpack_vcs_link�unpack_file_url�unpack_http_url�
unpack_url�parse_content_disposition�sanitize_content_filenamec

Cs6|dkrtd��t|�}|dkr>|�|�}|��|j|jfS|dkr�|rd|�d�rdtd||f��|�dd�d}|�	d	d
�}t
�|�}|r�|�d�d|�dd�d}t
�|�}|�d
�r�d
|�d
�}|}z&t|d��}t|���}W5QRXWn4tk
�r,}	ztd
t|	���W5d}	~	XYnX||fS)a*Gets the content of a file; it may be a filename, file: URL, or
    http: URL.  Returns (location, content).  Content is unicode.

    :param url:         File path or url.
    :param comes_from:  Origin description of requirements.
    :param session:     Instance of pip.download.PipSession.
    NzAget_file_content() missing 1 required keyword argument: 'session')�httpZhttps�filer3z6Requirements file %s references URL %s, which is local�:��\�/�|�rbz$Could not open requirements file: %s)�	TypeErrorr�get�raise_for_status�url�text�
startswithr	�split�replace�_url_slash_drive_re�match�group�urllib_parseZunquote�lstrip�openr�read�IOError�str)
r>Z
comes_from�session�scheme�resp�pathrD�fZcontent�exc�rR�:/usr/lib/python3.8/site-packages/pip/_internal/download.pyr,UsB	�
��



�z/*([a-z])\|cCs t|�}|j|t|j�d�dS)N)r>)�_get_used_vcs_backend�unpackrr>)�link�location�vcs_backendrRrRrSr-�scCs$tjD]}|j|jkr|SqdS)z1
    Return a VersionControl object or None.
    N)rZbackendsrMZschemes)rVrXrRrRrSrT�s

rTcOs|S�NrR)�iterable�args�kwargsrRrRrS�_progress_indicator�sr]c
s6zt�jd�}Wntttfk
r0d}YnXt�dd�}t��tj	krRd}n&|r\d}n|dkrjd}n|std}nd}|j
}�fdd�}	�fd	d
�}
t}|jt
jkr�|}n|j}|r�t||d�}|r�t�d|t|��nt�d
|�n|r�t�d|�nt�d
|�|
||	t�t��}
|�r*|�|
�nt|
�dS)Nzcontent-lengthrZ
from_cacheFi@�Tc3sTz �jj|dd�D]
}|VqWn.tk
rN�j�|�}|sBqJ|Vq0YnXdS)NF)Zdecode_content)�raw�stream�AttributeErrorrI)Z
chunk_size�chunk)rNrRrS�	resp_read�s�
z _download_url.<locals>.resp_readc3s|D]}��|�|VqdSrY)�write)Zchunksra)�content_filerRrS�written_chunks�s
z%_download_url.<locals>.written_chunks)�maxzDownloading %s (%s)zDownloading %szUsing cached %s)�int�headers�
ValueError�KeyErrorr;�getattr�loggerZgetEffectiveLevel�logging�INFO�show_urlr]Znetlocr
Zurl_without_fragmentr�inforrZcheck_against_chunksr)rNrVrd�hashes�progress_barZtotal_lengthZcached_respZ
show_progressrorbreZprogress_indicatorr>Zdownloaded_chunksrR)rdrNrS�
_download_url�sP
%���rscCs�d}tj�||j�}tj�|�r�tdt|�d�}|dkr@d}nj|dkrdt�dt|��t�	|�nF|dkr�t
|�}t�d	t|�t|��t�||�n|d
kr�t
�d�|r�t�||�t�dt|��dS)
NTz8The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)abort)�i�w�b�artFruzDeleting %srvzBacking up %s to %srw���zSaved %s)�osrO�join�filename�existsrrrl�warning�remover�shutilZmove�sys�exit�copyrp)r{rWrVr�Zdownload_location�responseZ	dest_filerRrRrS�
_copy_files6���
r��onc
	Cs�|dkrtd��tdd��v}d}|r0t|||�}|rH|}t�|�d}	nt|||j||�\}}	t|||	�|r~|s~t|||�|s�t	�
|�W5QRXdS)Nz@unpack_http_url() missing 1 required keyword argument: 'session'rU)Zkindr)r;r�_check_download_dir�	mimetypes�
guess_type�_download_http_urlrOrr�ry�unlink)
rVrW�download_dirrLrqrr�temp_dir�already_downloaded_path�	from_path�content_typerRrRrSr/s2	���c
CsTzt||�Wn@tjk
rN}z t�dt|�t|�t|��W5d}~XYnXdS)z�Copying special files is not supported, but as a convenience to users
    we skip errors copying them. This supports tools that may create e.g.
    socket files in the project source directory.
    z>Ignoring special file error '%s' encountered copying %s to %s.N)r
rZSpecialFileErrorrlr}rKr)�src�dest�erRrRrS�_copy2_ignoring_special_filesJs�r�cs`tj�|�}tj�|��tj�|�����fdd�}t|dd�}tsLt|d<tj	�|f|�dS)Ncs6g}|�kr|ddg7}tj�|��kr2|�g7}|S)Nz.toxz.nox)ryrO�abspath)�d�namesZskipped��sourceZtarget_basenameZtarget_dirnamerRrSr)es
z!_copy_source_tree.<locals>.ignoreTr(r+)
ryrOr��basename�dirname�dictrr�rZcopytree)r��targetZtarget_abspathr)r\rRr�rS�_copy_source_tree_sr�cCs�|j}|��r>tj�|�r"t|�t||�|r:t�d�dS|rL|�	|�d}|r`t
|||�}|rj|}n|}t�|�d}t
|||�|r�|s�t|||�dS)z�Unpack link into location.

    If download_dir is provided and link points to a file, make a copy
    of the link file inside download_dir.
    z*Link is a directory, ignoring download_dirNr)�	file_pathZis_existing_dirryrO�isdirrr�rlrp�check_against_pathr�r�r�rr�)rVrWr�rqZ	link_pathr�r�r�rRrRrSr.~s.


�cCsP|jrt||�n:|jr*t||||d�n"|dkr8t�}t||||||d�dS)avUnpack link.
       If link is a VCS link:
         if only_download, export into download_dir and ignore location
          else unpack into location
       for other types of link:
         - unpack into location
         - if download_dir, copy the file into download_dir
         - if only_download, mark location for deletion

    :param hashes: A Hashes object, one of whose embedded hashes must match,
        or HashMismatch will be raised. If the Hashes is empty, no matches are
        required, and unhashable types of requirements (like VCS ones, which
        would ordinarily raise HashUnsupported) are allowed.
    )rqN)rqrr)Zis_vcsr-�is_filer.rr/)rVrWr�rLrqrrrRrRrSr0�s�cCstj�|�S)zJ
    Sanitize the "filename" value from a Content-Disposition header.
    )ryrOr�)r{rRrRrSr2�scCs,t�|�\}}|�d�}|r$t|�}|p*|S)z�
    Parse the "filename" value from a Content-Disposition header, and
    return the default filename if the result is empty.
    r{)�cgiZparse_headerr<r2)�content_dispositionZdefault_filenameZ_typeZparamsr{rRrRrSr1�s

c
Cs*|j�dd�d}z |j|ddidd�}|��Wn8tjk
rj}zt�d|jj	|��W5d	}~XYnX|j
�d
d�}|j}	|j
�d�}
|
r�t|
|	�}	t
|	�d}|s�t�|�}|r�|	|7}	|s�|j|jkr�tj�
|j�d}|r�|	|7}	tj�||	�}t|d
��}
t|||
||�W5QRX||fS)z6Download link url into temp_dir using provided session�#r6rzAccept-EncodingZidentityT)rhr_zHTTP error %s while getting %sNzcontent-type�zcontent-disposition�wb)r>rAr<r=rZ	HTTPErrorrlZcriticalr�Zstatus_coderhr{r1rr�Zguess_extensionryrOrzrHrs)rVrLr�rqrrZ
target_urlrNrQr�r{r�Zextr�rdrRrRrSr��sB	��

r�cCsptj�||j�}tj�|�s dSt�d|�|rlz|�|�Wn,tk
rjt�	d|�t�
|�YdSX|S)z� Check download_dir for previously downloaded file with correct hash
        If a correct file is found return its path else None
    NzFile was already downloaded %sz;Previously-downloaded file %s has bad hash. Re-downloading.)ryrOrzr{r|rlrpr�rr}r�)rVr�rqZ
download_pathrRrRrSr�7s�
r�)NN)NNNr�)NN)NNNr�)\Z
__future__rr�rmr�ry�rerr�Zpip._vendorrZpip._vendor.requests.modelsrrZpip._vendor.sixrZpip._vendor.six.moves.urllibrrFZpip._internal.exceptionsrr	Zpip._internal.models.indexr
Zpip._internal.network.sessionrZpip._internal.utils.encodingrZpip._internal.utils.filesystemr
Zpip._internal.utils.miscrrrrrrrrrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.uirZpip._internal.utils.unpackingrZpip._internal.utils.urlsrZpip._internal.vcsr�typingrrrr r!r"Zmypy_extensionsr#Zpip._internal.models.linkr$Zpip._internal.utils.hashesr%Z pip._internal.vcs.versioncontrolr&rK�boolr'�__all__Z	getLogger�__name__rlr,�compile�IrCr-rTr]rsr�r/r�r�r.r0r2r1r�r�rRrRrRrS�<module>s�, ��	���

0d�
-"�
8�
.?site-packages/pip/_internal/__pycache__/cache.cpython-38.opt-1.pyc000064400000015772151446176770020727 0ustar00U

��.e� �@s�dZddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZddl
mZddlmZdd	lmZmZer�dd
lmZmZmZmZddlmZddlmZe�e�ZGd
d�de �Z!Gdd�de!�Z"Gdd�de"�Z#Gdd�de!�Z$dS)zCache Management
�N)�canonicalize_name)�Link)�
expanduser)�
TempDirectory)�MYPY_CHECK_RUNNING)�path_to_url)�InvalidWheelFilename�Wheel)�Optional�Set�List�Any)�
FormatControl)�	Pep425TagcsPeZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
�ZS)�Cachea�An abstract class - provides cache directories for data from links


        :param cache_dir: The root of the cache.
        :param format_control: An object of FormatControl class to limit
            binaries being read from the cache.
        :param allowed_formats: which formats of files the cache should store.
            ('binary' and 'source' are the only allowed values)
    cs8tt|���|rt|�nd|_||_||_ddh}dS)N�source�binary)�superr�__init__r�	cache_dir�format_control�allowed_formats)�selfrrrZ_valid_formats��	__class__��7/usr/lib/python3.8/site-packages/pip/_internal/cache.pyr(szCache.__init__cCs�|jg}|jdk	r4|jdk	r4|�d�|j|jg��d�|�}t�|�����}|dd�|dd�|dd�|dd�g}|S)zEGet parts of part that must be os.path.joined with cache_dir
        N�=�#���)	Zurl_without_fragmentZ	hash_name�hash�append�join�hashlibZsha224�encodeZ	hexdigest)r�linkZ	key_partsZkey_urlZhashed�partsrrr�_get_cache_path_parts2s
,zCache._get_cache_path_partsc
Cs�|jp|p|}|rgSt|�}|j�|�}|j�|�s@gS|�|�}zt�|�WSt	k
r�}z$|j
t
jt
jhkr�gWY�S�W5d}~XYnXdS�N)
rrrZget_allowed_formatsr�intersection�get_path_for_link�os�listdir�OSError�errnoZENOENTZENOTDIR)rr'�package_nameZ
can_not_cacheZcanonical_nameZformats�root�errrrr�_get_candidatesLs(���
zCache._get_candidatescCs
t��dS)z>Return a directory to store cached items in for link.
        N��NotImplementedError�rr'rrrr,eszCache.get_path_for_linkcCs
t��dS)zaReturns a link to a cached item if it exists, otherwise returns the
        passed link.
        Nr5)rr'r1�supported_tagsrrr�getks
z	Cache.getcCs$|�|�}tj�||�}tt|��Sr*)r,r-�pathr$rr)rr'�	candidater2r:rrr�_link_for_candidatews
zCache._link_for_candidatecCsdSr*r�rrrr�cleanup~sz
Cache.cleanup)�__name__�
__module__�__qualname__�__doc__rr)r4r,r9r<r>�
__classcell__rrrrrs

rcs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�SimpleWheelCachez+A cache of wheels for future installs.
    cstt|��||dh�dS�Nr)rrDr�rrrrrrr�s

�zSimpleWheelCache.__init__cCs |�|�}tjj|jdf|��S)a�Return a directory to store cached wheels for link

        Because there are M wheels for any one sdist, we provide a directory
        to cache them in, and then consult that directory when looking up
        cache hits.

        We only insert things into the cache if they have plausible version
        numbers, so that we don't contaminate the cache with things that were
        not unique. E.g. ./package might have dozens of installs done for it
        and build a version of 0.0...and if we built and cached a wheel, we'd
        end up using the same wheel even if the source has been edited.

        :param link: The link of the sdist for which this will cache wheels.
        Zwheels)r)r-r:r$r)rr'r(rrrr,�s
z"SimpleWheelCache.get_path_for_linkc	Csxg}|�||�D]J}zt|�}Wntk
r8YqYnX|�|�sFq|�|�|�|f�q|sd|S|�|t|�d�S)N�)r4r	rZ	supportedr#Zsupport_index_minr<�min)rr'r1r8Z
candidatesZ
wheel_nameZwheelrrrr9�s

�zSimpleWheelCache.get)r?r@rArBrr,r9rCrrrrrD�srDcs(eZdZdZ�fdd�Zdd�Z�ZS)�EphemWheelCachezGA SimpleWheelCache that creates it's own temporary cache directory
    cs&tdd�|_tt|��|jj|�dS)Nzephem-wheel-cache)Zkind)r�	_temp_dirrrIrr:)rrrrrr�s

�zEphemWheelCache.__init__cCs|j��dSr*)rJr>r=rrrr>�szEphemWheelCache.cleanup)r?r@rArBrr>rCrrrrrI�srIcs@eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Z�Z	S)�
WheelCachez�Wraps EphemWheelCache and SimpleWheelCache into a single Cache

    This Cache allows for gracefully degradation, using the ephem wheel cache
    when a certain link is not found in the simple wheel cache first.
    cs0tt|��||dh�t||�|_t|�|_dSrE)rrKrrD�_wheel_cacherI�_ephem_cacherFrrrr�s
�zWheelCache.__init__cCs|j�|�Sr*)rLr,r7rrrr,�szWheelCache.get_path_for_linkcCs|j�|�Sr*)rMr,r7rrr�get_ephem_path_for_link�sz"WheelCache.get_ephem_path_for_linkcCs0|jj|||d�}||k	r|S|jj|||d�S)N)r'r1r8)rLr9rM)rr'r1r8Zretvalrrrr9�s��zWheelCache.getcCs|j��|j��dSr*)rLr>rMr=rrrr>�s
zWheelCache.cleanup)
r?r@rArBrr,rNr9r>rCrrrrrK�srK)%rBr0r%Zloggingr-Zpip._vendor.packaging.utilsrZpip._internal.models.linkrZpip._internal.utils.compatrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.urlsrZpip._internal.wheelrr	�typingr
rrr
Zpip._internal.indexrZpip._internal.pep425tagsrZ	getLoggerr?Zlogger�objectrrDrIrKrrrr�<module>s(
f:site-packages/pip/_internal/__pycache__/exceptions.cpython-38.pyc000064400000030302151446176770021070 0ustar00U

��.e(�@s�dZddlmZddlmZmZmZddlmZddl	m
Z
e
rdddlmZddl
mZddlmZGd	d
�d
e�ZGdd�de�ZGd
d�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd �d e�ZGd!d"�d"e�ZGd#d$�d$e�ZGd%d&�d&e�Z Gd'd(�d(e �Z!Gd)d*�d*e �Z"Gd+d,�d,e �Z#Gd-d.�d.e �Z$Gd/d0�d0e �Z%Gd1d2�d2e�Z&Gd3d4�d4e�Z'd5S)6z"Exceptions used throughout package�)�absolute_import)�chain�groupby�repeat)�	iteritems)�MYPY_CHECK_RUNNING)�Optional)�Distribution)�InstallRequirementc@seZdZdZdS)�PipErrorzBase pip exceptionN��__name__�
__module__�__qualname__�__doc__�rr�</usr/lib/python3.8/site-packages/pip/_internal/exceptions.pyrsrc@seZdZdZdS)�ConfigurationErrorz"General exception in configurationNrrrrrrsrc@seZdZdZdS)�InstallationErrorz%General exception during installationNrrrrrrsrc@seZdZdZdS)�UninstallationErrorz'General exception during uninstallationNrrrrrr src@s eZdZdZdd�Zdd�ZdS)�NoneMetadataErrora
    Raised when accessing "METADATA" or "PKG-INFO" metadata for a
    pip._vendor.pkg_resources.Distribution object and
    `dist.has_metadata('METADATA')` returns True but
    `dist.get_metadata('METADATA')` returns None (and similarly for
    "PKG-INFO").
    cCs||_||_dS)z�
        :param dist: A Distribution object.
        :param metadata_name: The name of the metadata being accessed
            (can be "METADATA" or "PKG-INFO").
        N)�dist�
metadata_name)�selfrrrrr�__init__-szNoneMetadataError.__init__cCsd�|j|j�S)Nz+None {} metadata found for distribution: {})�formatrr�rrrr�__str__7s
��zNoneMetadataError.__str__N)r
rrrrrrrrrr$s
rc@seZdZdZdS)�DistributionNotFoundzCRaised when a distribution cannot be found to satisfy a requirementNrrrrrrBsrc@seZdZdZdS)�RequirementsFileParseErrorzDRaised when a general error occurs parsing a requirements file line.NrrrrrrFsrc@seZdZdZdS)�BestVersionAlreadyInstalledzNRaised when the most up-to-date version of a package is already
    installed.Nrrrrrr Jsr c@seZdZdZdS)�
BadCommandz0Raised when virtualenv or a command is not foundNrrrrrr!Osr!c@seZdZdZdS)�CommandErrorz7Raised when there is an error in command-line argumentsNrrrrrr"Ssr"c@seZdZdZdS)�PreviousBuildDirErrorz:Raised when there's a previous conflicting build directoryNrrrrrr#Wsr#c@seZdZdZdS)�InvalidWheelFilenamezInvalid wheel filename.Nrrrrrr$[sr$c@seZdZdZdS)�UnsupportedWheelzUnsupported wheel.Nrrrrrr%_sr%c@s8eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
�
HashErrorsz:Multiple HashError instances rolled into one for reportingcCs
g|_dS�N)�errorsrrrrrfszHashErrors.__init__cCs|j�|�dSr')r(�append)r�errorrrrr)iszHashErrors.appendcCsbg}|jjdd�d�t|jdd��D](\}}|�|j�|�dd�|D��q&|r^d�|�SdS)NcSs|jSr')�order��errr�<lambda>n�z$HashErrors.__str__.<locals>.<lambda>)�keycSs|jSr'��	__class__r,rrrr.or/css|]}|��VqdSr')�body��.0r-rrr�	<genexpr>qsz%HashErrors.__str__.<locals>.<genexpr>�
)r(�sortrr)�head�extend�join)r�lines�clsZ
errors_of_clsrrrrlszHashErrors.__str__cCs
t|j�Sr')�boolr(rrrr�__nonzero__uszHashErrors.__nonzero__cCs|��Sr')r?rrrr�__bool__xszHashErrors.__bool__N)	r
rrrrr)rr?r@rrrrr&cs	r&c@s0eZdZdZdZdZdd�Zdd�Zdd	�ZdS)
�	HashErrora�
    A failure to verify a package against known-good hashes

    :cvar order: An int sorting hash exception classes by difficulty of
        recovery (lower being harder), so the user doesn't bother fretting
        about unpinned packages when he has deeper issues, like VCS
        dependencies, to deal with. Also keeps error reports in a
        deterministic order.
    :cvar head: A section heading for display above potentially many
        exceptions of this kind
    :ivar req: The InstallRequirement that triggered this error. This is
        pasted on after the exception is instantiated, because it's not
        typically available earlier.

    N�cCsd|��S)a)Return a summary of me for display under the heading.

        This default implementation simply prints a description of the
        triggering requirement.

        :param req: The InstallRequirement that provoked this error, with
            populate_link() having already been called

        z    %s)�_requirement_namerrrrr3�s
zHashError.bodycCsd|j|��fS)Nz%s
%s)r9r3rrrrr�szHashError.__str__cCs|jrt|j�SdS)z�Return a description of the requirement that triggered me.

        This default implementation returns long description of the req, with
        line numbers

        �unknown package)�req�strrrrrrC�szHashError._requirement_name)	r
rrrrEr9r3rrCrrrrrA|srAc@seZdZdZdZdZdS)�VcsHashUnsupported�uA hash was provided for a version-control-system-based requirement, but
    we don't have a method for hashing those.rzlCan't verify hashes for these requirements because we don't have a way to hash version control repositories:N�r
rrrr+r9rrrrrG�srGc@seZdZdZdZdZdS)�DirectoryUrlHashUnsupportedrH�zUCan't verify hashes for these file:// requirements because they point to directories:NrIrrrrrJ�srJc@s(eZdZdZdZdZdd�Zdd�ZdS)	�HashMissingz2A hash was needed for a requirement but is absent.�awHashes are required in --require-hashes mode, but they are missing from some requirements. Here is a list of those requirements along with the hashes their downloaded archives actually had. Add lines like these to your requirements files to prevent tampering. (If you did not enable --require-hashes manually, note that it turns on automatically when any package has a hash.)cCs
||_dS)zq
        :param gotten_hash: The hash of the (possibly malicious) archive we
            just downloaded
        N)�gotten_hash)rrNrrrr�szHashMissing.__init__cCsHddlm}d}|jr4|jjr&|jjnt|jdd�}d|p<d||jfS)Nr)�
FAVORITE_HASHrEz    %s --hash=%s:%srD)Zpip._internal.utils.hashesrOrEZ
original_link�getattrrN)rrO�packagerrrr3�s��zHashMissing.bodyN)r
rrrr+r9rr3rrrrrL�s
rLc@seZdZdZdZdZdS)�HashUnpinnedzPA requirement had a hash specified but was not pinned to a specific
    version.�zaIn --require-hashes mode, all requirements must have their versions pinned with ==. These do not:NrIrrrrrR�srRc@s0eZdZdZdZdZdd�Zdd�Zdd	�Zd
S)�HashMismatchz�
    Distribution file hash values don't match.

    :ivar package_name: The name of the package that triggered the hash
        mismatch. Feel free to write to this after the exception is raise to
        improve its error message.

    �z�THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. If you have updated the package versions, please update the hashes. Otherwise, examine the package contents carefully; someone may have tampered with them.cCs||_||_dS)z�
        :param allowed: A dict of algorithm names pointing to lists of allowed
            hex digests
        :param gots: A dict of algorithm names pointing to hashes we
            actually got from the files under suspicion
        N)�allowed�gots)rrVrWrrrr�szHashMismatch.__init__cCsd|��|��fS)Nz
    %s:
%s)rC�_hash_comparisonrrrrr3s�zHashMismatch.bodycsbdd�}g}t|j�D]@\}}||��|��fdd�|D��|�d|j|���qd�|�S)aE
        Return a comparison of actual and expected hash values.

        Example::

               Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde
                            or 123451234512345123451234512345123451234512345
                    Got        bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef

        cSst|gtd��S)Nz    or)rr)�	hash_namerrr�hash_then_orsz3HashMismatch._hash_comparison.<locals>.hash_then_orc3s|]}dt��|fVqdS)z        Expected %s %sN)�nextr4��prefixrrr6s�z0HashMismatch._hash_comparison.<locals>.<genexpr>z             Got        %s
r7)rrVr:r)rWZ	hexdigestr;)rrZr<rYZ	expectedsrr\rrXs��zHashMismatch._hash_comparisonN)	r
rrrr+r9rr3rXrrrrrT�s
rTc@seZdZdZdS)�UnsupportedPythonVersionzMUnsupported python version according to Requires-Python package
    metadata.Nrrrrrr^sr^cs*eZdZdZd�fdd�	Zdd�Z�ZS)	�!ConfigurationFileCouldNotBeLoadedz=When there are errors while loading a configuration file
    �could not be loadedNcs&tt|��|�||_||_||_dSr')�superr_r�reason�fnamer*)rrbrcr*r1rrr(sz*ConfigurationFileCouldNotBeLoaded.__init__cCsB|jdk	rd�|j�}n|jdk	s&t�d�|jj�}d�|j|�S)Nz in {}.z.
{}
zConfiguration file {}{})rcrr*�AssertionError�messagerb)rZmessage_partrrrr.s

z)ConfigurationFileCouldNotBeLoaded.__str__)r`NN)r
rrrrr�
__classcell__rrr1rr_$sr_N)(rZ
__future__r�	itertoolsrrrZpip._vendor.sixrZpip._internal.utils.typingr�typingrZpip._vendor.pkg_resourcesr	Zpip._internal.req.req_installr
�	Exceptionrrrrrrrr r!r"r#r$r%r&rArGrJrLrRrTr^r_rrrr�<module>s<,		%	7site-packages/pip/_internal/__pycache__/index.cpython-38.pyc000064400000061347151446176770020033 0ustar00U

��.e��@s(dZddlmZddlZddlZddlmZddlmZddl	m
Zddlm
Z
mZmZmZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlmZddlm Z ddl!m"Z"ddl#m$Z$ddl%m&Z&ddl'm(Z(ddl)m*Z*e$�r�ddl+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1m2Z2m3Z3ddl	m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:ddl;m<Z<ddl=m>Z>e3e2de2e?e@ffZAe2e?e?e?e4eAe/e?fZBdddgZCe�DeE�ZFd1d!d"�ZGGd#d$�d$eH�ZId%d&�ZJGd'd(�d(eH�ZKGd)d�deH�ZLGd*d+�d+eH�ZMGd,d�deH�ZNd-d.�ZOd/d0�ZPdS)2z!Routines related to PyPI, indexes�)�absolute_importN)�
specifiers)�canonicalize_name)�parse)�BestVersionAlreadyInstalled�DistributionNotFound�InvalidWheelFilename�UnsupportedWheel)�InstallationCandidate)�
FormatControl)�Link)�SelectionPreferences)�TargetPython)�WHEEL_EXTENSION)�
indent_log)�build_netloc)�check_requires_python)�MYPY_CHECK_RUNNING)�SUPPORTED_EXTENSIONS)�url_to_path)�Wheel)�	FrozenSet�Iterable�List�Optional�Set�Text�Tuple�Union)�_BaseVersion)�
LinkCollector)�SearchScope)�InstallRequirement)�	Pep425Tag)�Hashes�r�BestCandidateResult�
PackageFinderFcCs~zt|j|d�}Wn&tjk
r8t�d|j|�YnBX|szd�tt|��}|sht�d||j|�dSt�d||j|�dS)aa
    Return whether the given Python version is compatible with a link's
    "Requires-Python" value.

    :param version_info: A 3-tuple of ints representing the Python
        major-minor-micro version to check.
    :param ignore_requires_python: Whether to ignore the "Requires-Python"
        value if the given Python version isn't compatible.
    )�version_infoz2Ignoring invalid Requires-Python (%r) for link: %s�.z4Link requires a different Python (%s not in: %r): %sFzBIgnoring failed Requires-Python check (%s not in: %r) for link: %sT)	rZrequires_pythonrZInvalidSpecifier�logger�debug�join�map�str)�linkr(�ignore_requires_pythonZ
is_compatible�versionr%r%�7/usr/lib/python3.8/site-packages/pip/_internal/index.py�_check_link_requires_python;s8�
�
��r3c@s,eZdZdZe�d�Zddd�Zdd�ZdS)	�
LinkEvaluatorzD
    Responsible for evaluating links for a particular project.
    z-py([123]\.?[0-9]?)$NcCs4|dkrd}||_||_||_||_||_||_dS)a�
        :param project_name: The user supplied package name.
        :param canonical_name: The canonical package name.
        :param formats: The formats allowed for this package. Should be a set
            with 'binary' or 'source' or both in it.
        :param target_python: The target Python interpreter to use when
            evaluating link compatibility. This is used, for example, to
            check wheel compatibility, as well as when checking the Python
            version, e.g. the Python version embedded in a link filename
            (or egg fragment) and against an HTML link's optional PEP 503
            "data-requires-python" attribute.
        :param allow_yanked: Whether files marked as yanked (in the sense
            of PEP 592) are permitted to be candidates for install.
        :param ignore_requires_python: Whether to ignore incompatible
            PEP 503 "data-requires-python" values in HTML links. Defaults
            to False.
        NF)�
_allow_yanked�_canonical_name�_ignore_requires_python�_formats�_target_python�project_name)�selfr:�canonical_name�formats�
target_python�allow_yankedr0r%r%r2�__init__rszLinkEvaluator.__init__cCs�d}|jr(|js(|jpd}dd�|�fS|jr<|j}|j}n�|��\}}|sPdS|tkrddd|fSd|jkr�|t	kr�d|j
}d|fSd	|jkr�|d
kr�dS|t	k�r,zt|j
�}Wntk
r�YdSXt|j�|jkr�d
|j
}d|fS|j��}|�|��s&|��}d�d�|��}d|fS|j}d|jk�rP|t	k�rPdd|j
fS|�sbt||j�}|�svdd|j
fS|j�|�}	|	�r�|d|	���}|	�d�}
|
|jjk�r�dSt||jj|j d�}|�s�dSt!�"d||�d|fS)aG
        Determine whether a link is a candidate for installation.

        :return: A tuple (is_candidate, result), where `result` is (1) a
            version string if `is_candidate` is True, and (2) if
            `is_candidate` is False, an optional string to log the reason
            the link fails to qualify.
        N�<none given>Fzyanked for reason: {})Fz
not a filezunsupported archive format: %sZbinaryzNo binaries permitted for %sZmacosx10z.zip)Fzmacosx10 one)Fzinvalid wheel filenamezwrong project name (not %s)z"none of the wheel's tags match: {}�, �sourcezNo sources permitted for %szMissing project version for %s�)FzPython version is incorrect)r(r0)FNzFound link %s, version: %sT)#�	is_yankedr5�
yanked_reason�format�egg_fragment�ext�splitextrr8rr:�pathr�filenamerr�namer6r9�get_tags�	supportedZget_formatted_file_tagsr,r1�_extract_version_from_fragment�_py_version_re�search�start�group�
py_versionr3Zpy_version_infor7r*r+)r;r/r1�reasonZegg_inforI�wheel�supported_tagsZ	file_tags�matchrUZsupports_pythonr%r%r2�
evaluate_link�sx





����
�zLinkEvaluator.evaluate_link)N)	�__name__�
__module__�__qualname__�__doc__�re�compilerQr@rZr%r%r%r2r4fs


�
&r4c
	Cs�|st�dt|�|�t|�Sg}g}d}|D]>}|j}|js@n"|j|d�rV|d7}n|�|�q.|�|�q.|rx|}nt|�}t|�t|�kr�d}	n d�t|�d�	dd	�|D���}	t�d
t|�||j
|t|�||	�|S)a�
    Filter out candidates whose hashes aren't allowed, and return a new
    list of candidates.

    If at least one candidate has an allowed hash, then all candidates with
    either an allowed hash or no hash specified are returned.  Otherwise,
    the given candidates are returned.

    Including the candidates with no hash specified when there is a match
    allows a warning to be logged if there is a more preferred candidate
    with no hash specified.  Returning all candidates in the case of no
    matches lets pip report the hash of the candidate that would otherwise
    have been installed (e.g. permitting the user to more easily update
    their requirements file with the desired hash).
    zJGiven no hashes to check %s links for project %r: discarding no candidatesr)�hashesrDzdiscarding no candidateszdiscarding {} non-matches:
  {}z
  css|]}t|j�VqdS�N)r.r/��.0�	candidater%r%r2�	<genexpr>+sz*filter_unallowed_hashes.<locals>.<genexpr>zPChecked %s links for project %r against %s hashes (%s matches, %s no digest): %s)r*r+�len�listr/Zhas_hash�is_hash_allowed�appendrGr,Zdigest_count)
�
candidatesrar:Zmatches_or_no_digestZnon_matchesZmatch_countrer/ZfilteredZdiscard_messager%r%r2�filter_unallowed_hashes�sL�

�
�rlc@seZdZdZddd�ZdS)�CandidatePreferenceszk
    Encapsulates some of the preferences for filtering and sorting
    InstallationCandidate objects.
    FcCs||_||_dS)zR
        :param allow_all_prereleases: Whether to allow all pre-releases.
        N)�allow_all_prereleases�
prefer_binary)r;rornr%r%r2r@Cs	zCandidatePreferences.__init__N)FF)r[r\r]r^r@r%r%r%r2rm<s�rmc@s(eZdZdZdd�Zdd�Zdd�ZdS)	r&z�A collection of candidates, returned by `PackageFinder.find_best_candidate`.

    This class is only intended to be instantiated by CandidateEvaluator's
    `compute_best_candidate()` method.
    cCsHt|�t|�kst�|dkr&|r2t�n||ks2t�||_||_||_dS)a
        :param candidates: A sequence of all available candidates found.
        :param applicable_candidates: The applicable candidates.
        :param best_candidate: The most preferred candidate found, or None
            if no applicable candidates were found.
        N)�set�AssertionError�_applicable_candidates�_candidates�best_candidate�r;rk�applicable_candidatesrtr%r%r2r@Ws

zBestCandidateResult.__init__cCs
t|j�S)z(Iterate through all candidates.
        )�iterrs�r;r%r%r2�iter_allpszBestCandidateResult.iter_allcCs
t|j�S)z3Iterate through the applicable candidates.
        )rwrrrxr%r%r2�iter_applicablevsz#BestCandidateResult.iter_applicableN)r[r\r]r^r@ryrzr%r%r%r2r&Psc@sHeZdZdZeddd��Zddd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dS)�CandidateEvaluatorzm
    Responsible for filtering and sorting candidates for installation based
    on what tags are valid.
    NFcCs:|dkrt�}|dkrt��}|��}|||||||d�S)a�Create a CandidateEvaluator object.

        :param target_python: The target Python interpreter to use when
            checking compatibility. If None (the default), a TargetPython
            object will be constructed from the running Python.
        :param specifier: An optional object implementing `filter`
            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
            versions.
        :param hashes: An optional collection of allowed hashes.
        N)r:rX�	specifierrornra)rrZSpecifierSetrN)�clsr:r>rornr|rarXr%r%r2�create�s�zCandidateEvaluator.createcCs(||_||_||_||_||_||_dS)z�
        :param supported_tags: The PEP 425 tags supported by the target
            Python in order of preference (most preferred first).
        N)�_allow_all_prereleases�_hashes�_prefer_binary�
_project_name�
_specifier�_supported_tags)r;r:rXr|rornrar%r%r2r@�szCandidateEvaluator.__init__csV|jpd}|j}dd�|jdd�|D�|d�D���fdd�|D�}t||j|jd	�S)
zM
        Return the applicable candidates from a list of candidates.
        NcSsh|]}t|��qSr%)r.)rd�vr%r%r2�	<setcomp>�sz?CandidateEvaluator.get_applicable_candidates.<locals>.<setcomp>css|]}t|j�VqdSrb�r.r1�rd�cr%r%r2rf�sz?CandidateEvaluator.get_applicable_candidates.<locals>.<genexpr>)Zprereleasescsg|]}t|j��kr|�qSr%r�r��Zversionsr%r2�
<listcomp>�sz@CandidateEvaluator.get_applicable_candidates.<locals>.<listcomp>)rkrar:)rr��filterrlr�r�)r;rkZallow_prereleasesr|rvr%r�r2�get_applicable_candidates�s 	
��
��z,CandidateEvaluator.get_applicable_candidatesc
Cs�|j}t|�}d}d}|j}|jr�t|j�}|�|�sDtd|j��|jrNd}|�	|�}|j
dk	r�t�d|j
�}	|	�
�}
t|
d�|
df}n|}t|�|j��}dt|j�}||||j||fS)a)
        Function to pass as the `key` argument to a call to sorted() to sort
        InstallationCandidates by preference.

        Returns a tuple such that tuples sorting as greater using Python's
        default comparison operator are more preferred.

        The preference is as follows:

        First and foremost, candidates with allowed (matching) hashes are
        always preferred over candidates without matching hashes. This is
        because e.g. if the only candidate with an allowed hash is yanked,
        we still want to use that candidate.

        Second, excepting hash considerations, candidates that have been
        yanked (in the sense of PEP 592) are always less preferred than
        candidates that haven't been yanked. Then:

        If not finding wheels, they are sorted by version only.
        If finding wheels, then the sort order is by version, then:
          1. existing installs
          2. wheels ordered via Wheel.support_index_min(self._supported_tags)
          3. source archives
        If prefer_binary was set, then all wheels are sorted above sources.

        Note: it was considered to embed this logic into the Link
              comparison operators, but then different sdist links
              with the same version, would have to be considered equal
        r%rzB%s is not a supported wheel for this platform. It can't be sorted.rDNz^(\d+)(.*)$���)r�rgr/Zis_wheelrrLrOr	r�Zsupport_index_min�	build_tagr_rY�groups�intrir�rEr1)
r;reZ
valid_tagsZsupport_numr�Zbinary_preferencer/rWZprirYZbuild_tag_groupsZhas_allowed_hashZ
yank_valuer%r%r2�	_sort_key�s<

��
�zCandidateEvaluator._sort_keycCsH|sdSt||jd�}|j}|jrD|jp*d}dj||d�}t�|�|S)zy
        Return the best candidate per the instance's sort order, or None if
        no candidate is acceptable.
        N��keyrAzqThe candidate selected for download or install is a yanked version: {candidate}
Reason for being yanked: {reason})rerV)�maxr�r/rErFrGr*Zwarning)r;rkrtr/rV�msgr%r%r2�sort_best_candidates	
��
z&CandidateEvaluator.sort_best_candidatecCs"|�|�}|�|�}t|||d�S)zF
        Compute and return a `BestCandidateResult` instance.
        )rvrt)r�r�r&rur%r%r2�compute_best_candidate<s

�z)CandidateEvaluator.compute_best_candidate)NFFNN)FFN)r[r\r]r^�classmethodr~r@r�r�r�r�r%r%r%r2r{}s �)�
$<r{c@s�eZdZdZd&dd�Zed'dd��Zedd��Zej	d	d��Zed
d��Z
edd
��Zedd��Zedd��Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd(d d!�Zd)d"d#�Zd$d%�ZdS)*r'z�This finds packages.

    This is meant to match easy_install's technique for looking for
    packages, by reading pages and looking for appropriate links.
    NcCsP|dkrt�}|ptt�t��}||_||_||_||_||_||_t�|_	dS)a�
        This constructor is primarily meant to be used by the create() class
        method and from tests.

        :param format_control: A FormatControl object, used to control
            the selection of source packages / binary packages when consulting
            the index and links.
        :param candidate_prefs: Options to use when creating a
            CandidateEvaluator object.
        N)
rmrrpr5�_candidate_prefsr7�_link_collectorr9�format_control�
_logged_links)r;�link_collectorr>r?r��candidate_prefsr0r%r%r2r@VszPackageFinder.__init__cCs8|dkrt�}t|j|jd�}|||||j|j|jd�S)afCreate a PackageFinder.

        :param selection_prefs: The candidate selection preferences, as a
            SelectionPreferences object.
        :param target_python: The target Python interpreter to use when
            checking compatibility. If None (the default), a TargetPython
            object will be constructed from the running Python.
        N)rorn)r�r�r>r?r�r0)rrmrornr?r�r0)r}r�Zselection_prefsr>r�r%r%r2r~~s��zPackageFinder.createcCs|jjSrb�r��search_scoperxr%r%r2r��szPackageFinder.search_scopecCs||j_dSrbr�)r;r�r%r%r2r��scCs|jjSrb)r��
find_linksrxr%r%r2r��szPackageFinder.find_linkscCs|jjSrb)r��
index_urlsrxr%r%r2r��szPackageFinder.index_urlsccs|jjjD]}t|�Vq
dSrb)r�ZsessionZpip_trusted_originsr)r;Z	host_portr%r%r2�
trusted_hosts�szPackageFinder.trusted_hostscCs|jjSrb�r�rnrxr%r%r2rn�sz#PackageFinder.allow_all_prereleasescCsd|j_dS)NTr�rxr%r%r2�set_allow_all_prereleases�sz'PackageFinder.set_allow_all_prereleasescCs.t|�}|j�|�}t||||j|j|jd�S)N)r:r<r=r>r?r0)rr�Zget_allowed_formatsr4r9r5r7)r;r:r<r=r%r%r2�make_link_evaluator�s�z!PackageFinder.make_link_evaluatorcCsPgg}}t�}|D]2}||kr|�|�|jr<|�|�q|�|�q||S)z�
        Returns elements of links in order, non-egg links first, egg links
        second, while eliminating duplicates
        )rp�addrHrj)r;�linksZeggsZno_eggs�seenr/r%r%r2�_sort_links�s

zPackageFinder._sort_linkscCs(||jkr$t�d||�|j�|�dS)NzSkipping link: %s: %s)r�r*r+r�)r;r/rVr%r%r2�_log_skipped_link�s
zPackageFinder._log_skipped_linkcCs<|�|�\}}|s(|r$|j||d�dSt|j|t|�d�S)z�
        If the link is a candidate for install, convert it to an
        InstallationCandidate and return it. Otherwise, return None.
        )rVN)Zprojectr/r1)rZr�r
r:r.)r;�link_evaluatorr/Zis_candidate�resultr%r%r2�get_install_candidate�s�z#PackageFinder.get_install_candidatecCs6g}|�|�D]"}|�||�}|dk	r|�|�q|S)zU
        Convert links that are candidates to InstallationCandidate objects.
        N)r�r�rj)r;r�r�rkr/rer%r%r2�evaluate_linksszPackageFinder.evaluate_linksc

Cs�|j�|�}|�|�}|j||jd�}g}|j��D]>\}}t�d|�t	��|j||d�}|�
|�W5QRXq4|j||jd�}	|	r�|	jdd�t�dd�
dd�|	D���|	||S)	aFind all available InstallationCandidate for project_name

        This checks index_urls and find_links.
        All versions found are returned as an InstallationCandidate list.

        See LinkEvaluator.evaluate_link() for details on which files
        are accepted.
        )r�zAnalyzing links from page %sT)�reversezLocal files found: %srBcSsg|]}t|jj��qSr%)rr/Zurlrcr%r%r2r�2s�z5PackageFinder.find_all_candidates.<locals>.<listcomp>)r�Z
collect_linksr�r�r�Zpages�itemsr*r+r�extend�files�sortr,)
r;r:Zcollected_linksr�Zfind_links_versionsZ
page_versionsZpage_urlZ
page_linksZnew_versionsZ
file_versionsr%r%r2�find_all_candidates
s8

���
��	z!PackageFinder.find_all_candidatescCs"|j}tj||j|j|j||d�S)z3Create a CandidateEvaluator object to use.
        )r:r>rornr|ra)r�r{r~r9rorn)r;r:r|rar�r%r%r2�make_candidate_evaluator;s	�z&PackageFinder.make_candidate_evaluatorcCs$|�|�}|j|||d�}|�|�S)aFind matches for the given project and specifier.

        :param specifier: An optional object implementing `filter`
            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
            versions.

        :return: A `BestCandidateResult` instance.
        )r:r|ra)r�r�r�)r;r:r|rarkZcandidate_evaluatorr%r%r2�find_best_candidateNs
�z!PackageFinder.find_best_candidatec	Cs|jdd�}|j|j|j|d�}|j}d}|jdk	r@t|jj�}dd�}|dkrz|dkrzt�	d|||�
���td|��d}|r�|dks�|j|kr�d	}|s�|dk	r�|r�t�d
|�nt�d||j�dS|r�t�d|||�
���t�t�d
|j||�
���|jS)z�Try to find a Link matching req

        Expects req, an InstallRequirement and upgrade, a boolean
        Returns a Link if found,
        Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise
        F)Ztrust_internet)r|raNcSs d�tdd�|D�td��pdS)NrBcSsh|]}t|j��qSr%r�r�r%r%r2r�}szKPackageFinder.find_requirement.<locals>._format_versions.<locals>.<setcomp>r�Znone)r,�sorted�
parse_version)Z	cand_iterr%r%r2�_format_versionsws��z8PackageFinder.find_requirement.<locals>._format_versionszNCould not find a version that satisfies the requirement %s (from versions: %s)z%No matching distribution found for %sTzLExisting installed version (%s) is most up-to-date and satisfies requirementzUExisting installed version (%s) satisfies requirement (most up-to-date version is %s)z=Installed version (%s) is most up-to-date (past versions: %s)z)Using version %s (newest of versions: %s))rar�rMr|rtZsatisfied_byr�r1r*Zcriticalryrr+rzrr/)	r;ZreqZupgraderaZbest_candidate_resultrtZinstalled_versionr�Zbest_installedr%r%r2�find_requirementesh�


������
�
�zPackageFinder.find_requirement)NNN)N)NN)NN)r[r\r]r^r@r�r~�propertyr��setterr�r�r�rnr�r�r�r�r�r�r�r�r�r�r%r%r%r2r'OsD�
(� 






1�
�
cCsLt|�D].\}}|dkrqt|d|��|kr|Sqtd�||���dS)a�Find the separator's index based on the package's canonical name.

    :param fragment: A <package>+<version> filename "fragment" (stem) or
        egg fragment.
    :param canonical_name: The package's canonical name.

    This function is needed since the canonicalized name does not necessarily
    have the same length as the egg info's name part. An example::

    >>> fragment = 'foo__bar-1.0'
    >>> canonical_name = 'foo-bar'
    >>> _find_name_version_sep(fragment, canonical_name)
    8
    �-Nz{} does not match {})�	enumerater�
ValueErrorrG)�fragmentr<�ir�r%r%r2�_find_name_version_sep�s
r�cCsBzt||�d}Wntk
r(YdSX||d�}|s>dS|S)z�Parse the version string from a <package>+<version> filename
    "fragment" (stem) or egg fragment.

    :param fragment: The string to parse. E.g. foo-2.1
    :param canonical_name: The canonicalized name of the package this
        belongs to.
    rDN)r�r�)r�r<Z
version_startr1r%r%r2rP�s	rP)F)Qr^Z
__future__rZloggingr_Zpip._vendor.packagingrZpip._vendor.packaging.utilsrZpip._vendor.packaging.versionrr�Zpip._internal.exceptionsrrrr	Zpip._internal.models.candidater
Z#pip._internal.models.format_controlrZpip._internal.models.linkrZ$pip._internal.models.selection_prefsr
Z"pip._internal.models.target_pythonrZpip._internal.utils.filetypesrZpip._internal.utils.loggingrZpip._internal.utils.miscrZpip._internal.utils.packagingrZpip._internal.utils.typingrZpip._internal.utils.unpackingrZpip._internal.utils.urlsrZpip._internal.wheelr�typingrrrrrrrrrZpip._internal.collectorr Z!pip._internal.models.search_scoper!Zpip._internal.reqr"Zpip._internal.pep425tagsr#Zpip._internal.utils.hashesr$r�r.ZBuildTagZCandidateSortingKey�__all__Z	getLoggerr[r*r3�objectr4rlrmr&r{r'r�rPr%r%r%r2�<module>s^(�

�
+K-Shsite-packages/pip/_internal/__pycache__/configuration.cpython-38.pyc000064400000024625151446176770021571 0ustar00U

��.e�7�@sdZddlZddlZddlZddlZddlmZddlmZm	Z	ddl
mZddlm
Z
mZddlmZmZddlmZer�dd	lmZmZmZmZmZmZmZejZed
e�Ze�e �Z!dd�Z"d
d�Z#edddddd�Z$e
r�dndZ%dd�Z&Gdd�de'�Z(dS)aConfiguration management setup

Some terminology:
- name
  As written in config files.
- value
  Value associated with a name
- key
  Name combined with it's section (section.name)
- variant
  A single word describing where the configuration key-value pair came from
�N)�configparser)�ConfigurationError�!ConfigurationFileCouldNotBeLoaded)�appdirs)�WINDOWS�
expanduser)�
ensure_dir�enum)�MYPY_CHECK_RUNNING)�Any�Dict�Iterable�List�NewType�Optional�Tuple�KindcCs*|���dd�}|�d�r&|dd�}|S)zFMake a name consistent regardless of source (environment or file)
    �_�-z--�N)�lower�replace�
startswith)�name�r�?/usr/lib/python3.8/site-packages/pip/_internal/configuration.py�_normalize_name.s
rcCs&d|krd�|�}t|��|�dd�S)N�.zbKey does not contain dot separated section and key. Perhaps you wanted to use 'global.{}' instead?�)�formatr�split)rZ
error_messagerrr�_disassemble_key8s��r!�user�globalZsite�envzenv-var)�USER�GLOBAL�SITE�ENV�ENV_VARzpip.inizpip.confcCspdd�t�d�D�}tj�tjt�}tj�td�t	r8dndt�}tj�t�
d�t�}tj|tj
|gtj||giS)NcSsg|]}tj�|t��qSr)�os�path�join�CONFIG_BASENAME)�.0r+rrr�
<listcomp>Qs�z+get_configuration_files.<locals>.<listcomp>Zpip�~z.pip)rZsite_config_dirsr*r+r,�sys�prefixr-rrZuser_config_dir�kindsr&r'r%)Zglobal_config_filesZsite_config_fileZlegacy_config_fileZnew_config_filerrr�get_configuration_filesPs(�
���r4cs�eZdZdZd)�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Ze
dd��Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Z�ZS)*�
Configurationa�Handles management of configuration.

    Provides an interface to accessing and managing configuration files.

    This class converts provides an API that takes "section.key-name" style
    keys and stores the value associated with it as "key-name" under the
    section "section".

    This allows for a clean interface wherein the both the section and the
    key-name are preserved in an easy to manage form in the configuration files
    and the data stored is also nice.
    Nc
s�tt|���tjtjtjdg}||krJtd�d�	t
t|dd������||_||_
tjtjtjtjtjg|_ddg|_dd�|jD�|_dd�|jD�|_g|_dS)	Nz5Got invalid value for load_only - should be one of {}z, ����version�helpcSsi|]
}|g�qSrr�r.�variantrrr�
<dictcomp>�sz*Configuration.__init__.<locals>.<dictcomp>cSsi|]
}|i�qSrrr9rrrr;�s)�superr5�__init__r3r%r&r'rrr,�map�repr�isolated�	load_onlyr(r)�_override_order�_ignore_env_names�_parsers�_config�_modified_parsers)�selfr@rAZ_valid_load_only��	__class__rrr=ts0���
��zConfiguration.__init__cCs|��|js|��dS)zELoads configuration from configuration files and environment
        N)�_load_config_filesr@�_load_environment_vars�rGrrr�load�szConfiguration.loadcCs<|jdk	std��z|��dWStk
r6YdSXdS)z@Returns the file with highest priority in configuration
        Nz)Need to be specified a file to be editingr)rA�AssertionError�_get_parser_to_modify�
IndexErrorrLrrr�get_file_to_edit�s�zConfiguration.get_file_to_editcCs
|j��S)z`Returns key-value pairs like dict.items() representing the loaded
        configuration
        )�_dictionary�itemsrLrrrrS�szConfiguration.itemscCs4z|j|WStk
r.td�|���YnXdS)z,Get a value from the configuration.
        �No such key - {}N)rR�KeyErrorrr)rG�keyrrr�	get_value�szConfiguration.get_valuecCsj|��|��\}}|dk	rJt|�\}}|�|�s<|�|�|�|||�||j|j|<|�||�dS)z-Modify a value in the configuration.
        N)	�_ensure_have_load_onlyrOr!�has_sectionZadd_section�setrErA�_mark_as_modified)rGrV�value�fname�parser�sectionrrrr�	set_value�s

zConfiguration.set_valuec	Cs�|��||j|jkr&td�|���|��\}}|dk	r�t|�\}}d}|�|�r`|�||�}|r�t	|�
|��}zt|�}Wntk
r�d}YnX|dkr�|�
|�|�||�ntd��|j|j|=dS)z,Unset a value in the configuration.
        rTNFz4Fatal Internal error [id=1]. Please report as a bug.)rXrErArrrOr!rYZ
remove_option�iterrS�next�
StopIterationZremove_sectionr[)	rGrVr]r^r_rZmodified_somethingZsection_iter�valrrr�unset_value�s,


�zConfiguration.unset_valuec
CsX|��|jD]D\}}t�d|�ttj�|��t|d��}|�	|�W5QRXqdS)z*Save the current in-memory state.
        z
Writing to %s�wN)
rXrF�logger�inforr*r+�dirname�open�write)rGr]r^�frrr�save�szConfiguration.savecCs$|jdkrtd��t�d|j�dS)Nz'Needed a specific file to be modifying.z$Will be working with %s variant only)rArrg�debugrLrrrrXs
z$Configuration._ensure_have_load_onlycCs$i}|jD]}|�|j|�q
|S)z<A dictionary representing the loaded configuration.
        )rB�updaterE)rGZretvalr:rrrrR	s
zConfiguration._dictionarycCs�t|���}|tjdd�tjgkr4t�d�dS|��D]V\}}|D]H}|j	dk	rp||j	krpt�d||�qH|�
||�}|j|�||f�qHq<dS)z5Loads configuration from configuration files
        rrzZSkipping loading configuration files due to environment's PIP_CONFIG_FILE being os.devnullNz Skipping file '%s' (variant: %s))
�dict�_iter_config_filesr3r(r*�devnullrgrnrSrA�
_load_filerD�append)rG�config_filesr:�filesr]r^rrrrJs"��z Configuration._load_config_filescCsLt�d||�|�|�}|��D]&}|�|�}|j|�|�||��q |S)Nz'For variant '%s', will try loading '%s')rgrn�_construct_parserZsectionsrSrEro�_normalized_keys)rGr:r]r^r_rSrrrrs2s

zConfiguration._load_filec
Cs�t��}tj�|�r|z|�|�WnXtk
rNtd�t	�
d��|d��Yn.tjk
rz}zt|d��W5d}~XYnX|S)Nzcontains invalid {} charactersF)�reasonr])�error)r�RawConfigParserr*r+�exists�read�UnicodeDecodeErrorrr�localeZgetpreferredencoding�Error)rGr]r^rzrrrrw=s��
zConfiguration._construct_parsercCs"|jtj�|�d|����dS)z7Loads configuration from environment variables
        z:env:N)rEr3r)rorx�_get_environ_varsrLrrrrKTs�z$Configuration._load_environment_varscCs.i}|D] \}}|dt|�}|||<q|S)z�Normalizes items to construct a dictionary with normalized keys.

        This routine is where the names become keys and are made the same
        regardless of source - configuration files or environment.
        r)r)rGr_rSZ
normalizedrrdrVrrrrx\s

zConfiguration._normalized_keysccsRtj��D]B\}}|�d�o0|dd���|jk}|r
|dd���|fVq
dS)z@Returns a generator with all environmental vars with prefix PIP_ZPIP_�N)r*�environrSrrrC)rGrVrdZshould_be_yieldedrrrr�is
�zConfiguration._get_environ_varsccs�tj�dd�}|dk	r&tj|gfVntjgfVt�}tj|tjfV|job|o`tj�	|�}|rztj
|tj
fVtj|tjfVdS)zYields variant and configuration files associated with it.

        This should be treated like items of a dictionary.
        ZPIP_CONFIG_FILEN)r*r��getr3r(r4r&r@r+r|r%r')rGZconfig_fileruZshould_load_user_configrrrrqus	�z Configuration._iter_config_filescCs |j|j}|std��|dS)Nz4Fatal Internal error [id=2]. Please report as a bug.r6)rDrAr)rGZparsersrrrrO�s�z#Configuration._get_parser_to_modifycCs"||f}||jkr|j�|�dS)N)rFrt)rGr]r^Zfile_parser_tuplerrrr[�s
zConfiguration._mark_as_modified)N)�__name__�
__module__�__qualname__�__doc__r=rMrQrSrWr`rermrX�propertyrRrJrsrwrKrxr�rqrOr[�
__classcell__rrrHrr5fs*
	'


r5))r�rZloggingr*r1Zpip._vendor.six.movesrZpip._internal.exceptionsrrZpip._internal.utilsrZpip._internal.utils.compatrrZpip._internal.utils.miscrr	Zpip._internal.utils.typingr
�typingrrr
rrrrr{�strrZ	getLoggerr�rgrr!r3r-r4�objectr5rrrr�<module>s6$


�	site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-38.pyc000064400000012622151446176770022673 0ustar00U

��.e��@s^ddlmZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZ
ddlmZddlmZddlmZddlmZdd	lmZdd
lmZddlmZmZmZddlmZm Z m!Z!dd
l"m#Z#ddl$m%Z%e%�rddl&Z&ddl&m'Z'ddl(m)Z)m*Z*m+Z+m,Z,ddl-m.Z.dZ/e�0e1�Z2ddd�Z3dd�Z4Gdd�de5�Z6dd�Z7dd�Z8dS)�)�absolute_importN)�
pkg_resources)�version)�
ensure_binary)�
LinkCollector)�
PackageFinder)�SearchScope)�SelectionPreferences)�WINDOWS)�adjacent_tmp_file�check_path_owner�replace)�
ensure_dir�get_installed_version�redact_auth_from_url)�
get_installer)�MYPY_CHECK_RUNNING)�Values)�Any�Dict�Text�Union)�
PipSessionz%Y-%m-%dT%H:%M:%SZFcCs`|jg|j}|jr8|s8t�dd�dd�|D���g}|jp@g}tj||d�}t	||d�}|S)z�
    :param session: The Session to use to make requests.
    :param suppress_no_index: Whether to ignore the --no-index option
        when constructing the SearchScope object.
    zIgnoring indexes: %s�,css|]}t|�VqdS�N)r)�.0Zurl�r�E/usr/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py�	<genexpr>@sz&make_link_collector.<locals>.<genexpr>)�
find_links�
index_urls)�session�search_scope)
Z	index_urlZextra_index_urlsZno_index�logger�debug�joinrr�creater)r!�options�suppress_no_indexr rr"�link_collectorrrr�make_link_collector1s
�
�r*cCst|�}t�|���}|Sr)r�hashlibZsha224Z	hexdigest)�keyZ	key_bytes�namerrr�_get_statefile_namePsr.c@s(eZdZdd�Zedd��Zdd�ZdS)�SelfCheckStatec
Csni|_d|_|rjtj�|dt|j��|_z&t|j��}t�	|�|_W5QRXWnt
ttfk
rhYnXdS)NZ	selfcheck)
�state�statefile_path�os�pathr%r.r,�open�json�load�IOError�
ValueError�KeyError)�self�	cache_dirZ	statefilerrr�__init__Xs�zSelfCheckState.__init__cCstjSr)�sys�prefix)r:rrrr,jszSelfCheckState.keyc	Cs�|js
dSttj�|j��s dSttj�|j��|j|�t�|d�}t	j
|ddd�}t|j��}|�t
|��W5QRXzt|j|j�Wntk
r�YnXdS)N)r,�
last_check�pypi_versionT)r�:)Z	sort_keysZ
separators)r1rr2r3�dirnamerr,�strftime�SELFCHECK_DATE_FMTr5�dumpsr�writerr
r-�OSError)r:r@�current_timer0�text�frrr�savens �zSelfCheckState.saveN)�__name__�
__module__�__qualname__r<�propertyr,rKrrrrr/Ws
r/cCs6zt�|�}dt|�kWStjk
r0YdSXdS)z�Checks whether pkg was installed by pip

    This is used not to display the upgrade message when pip is in fact
    installed by system package manager, such as dnf on Fedora.
    �pipFN)rZget_distributionrZDistributionNotFound)ZpkgZdistrrr�was_installed_by_pip�s

rQcCsXtd�}|sdSt�|�}d}�zt|jd�}tj��}d|jkrzd|jkrztj�|jdt	�}||�
�dkrz|jd}|dkr�t||dd�}td	d	d
�}	t
j||	d�}
|
�d�j}|dkr�WdSt|j�}|�||�t�|�}||ko�|j|jko�td�}
|
�sWdSt�rd}nd}t�d
|||�Wn$tk
�rRtjddd�YnXdS)z�Check for an update for pip.

    Limit the frequency of checks to once per week. State is stored either in
    the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix
    of the pip script path.
    rPN)r;r?r@i�:	T)r'r(F)Zallow_yankedZallow_all_prereleases)r)�selection_prefsz
python -m pipz�You are using pip version %s; however, version %s is available.
You should consider upgrading via the '%s install --upgrade pip' command.z5There was an error checking the latest version of pip)�exc_info)r�packaging_version�parser/r;�datetimeZutcnowr0�strptimerDZ
total_secondsr*r	rr&Zfind_best_candidate�best_candidate�strrrKZbase_versionrQr
r#Zwarning�	Exceptionr$)r!r'Zinstalled_versionZpip_versionr@r0rHr?r)rR�finderrXZremote_versionZlocal_version_is_olderZpip_cmdrrr�pip_self_version_check�sp

�
���


����r\)F)9Z
__future__rrVr+r5ZloggingZos.pathr2r=Zpip._vendorrZpip._vendor.packagingrrTZpip._vendor.sixrZpip._internal.collectorrZpip._internal.indexrZ!pip._internal.models.search_scoperZ$pip._internal.models.selection_prefsr	Zpip._internal.utils.compatr
Zpip._internal.utils.filesystemrrr
Zpip._internal.utils.miscrrrZpip._internal.utils.packagingrZpip._internal.utils.typingrZoptparser�typingrrrrZpip._internal.network.sessionrrDZ	getLoggerrLr#r*r.�objectr/rQr\rrrr�<module>s>
�
;site-packages/pip/_internal/__pycache__/build_env.cpython-38.opt-1.pyc000064400000016416151446176770021627 0ustar00U

��.e]�@sdZddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZm
Z
mZddlmZddlmZdd	lmZdd
lmZddlmZer�ddlmZmZmZmZmZdd
l m!Z!e�"e#�Z$Gdd�d�Z%Gdd�de&�Z'Gdd�de'�Z(dS)z;Build Environment used for isolation during sdist building
�N)�OrderedDict)�get_python_lib)�	get_paths)�Requirement�VersionConflict�
WorkingSet)�__file__)�call_subprocess)�
TempDirectory)�MYPY_CHECK_RUNNING)�open_spinner)�Tuple�Set�Iterable�Optional�List)�
PackageFinderc@seZdZdd�ZdS)�_PrefixcCsj||_d|_ttjdkrdnd||d�d�d|_td|d�}td|d�}||kr\|g|_n
||g|_dS)	NF�ntZposix_prefix)�baseZplatbase)�varsZscripts)�
plat_specific�prefixT)�path�setupr�os�name�bin_dirr�lib_dirs)�selfrZpurelibZplatlib�r �;/usr/lib/python3.8/site-packages/pip/_internal/build_env.py�__init__!s��
z_Prefix.__init__N)�__name__�
__module__�__qualname__r"r r r r!rsrc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)�BuildEnvironmentzFCreates and manages an isolated environment to install build deps
    c	s�tdd��_t�fdd�dD���_g�_g�_tt�j����D] }�j�	|j
��j�|j�qBdd�t
dd	�t
d
d	�fD�}tj��jjd��_tj��j�s�t��j�ttj��jd�d
��"}|�t�d�j|�jd��W5QRXdS)Nz	build-env)Zkindc3s(|] }|ttj��jj|��fVqdS�N)rrr�join�	_temp_dir��.0r�rr r!�	<genexpr>;s�z,BuildEnvironment.__init__.<locals>.<genexpr>)ZnormalZoverlaycSsh|]}tj�|��qSr )rr�normcase)r+�siter r r!�	<setcomp>Isz,BuildEnvironment.__init__.<locals>.<setcomp>F)rTr/zsitecustomize.py�wa�
                import os, site, sys

                # First, drop system-sites related paths.
                original_sys_path = sys.path[:]
                known_paths = set()
                for path in {system_sites!r}:
                    site.addsitedir(path, known_paths=known_paths)
                system_paths = set(
                    os.path.normcase(path)
                    for path in sys.path[len(original_sys_path):]
                )
                original_sys_path = [
                    path for path in original_sys_path
                    if os.path.normcase(path) not in system_paths
                ]
                sys.path = original_sys_path

                # Second, add lib directories.
                # ensuring .pth file are processed.
                for path in {lib_dirs!r}:
                    assert not path in sys.path
                    site.addsitedir(path)
                )�system_sitesr)r
r)r�	_prefixes�	_bin_dirs�	_lib_dirs�reversed�list�values�appendr�extendrrrrr(�	_site_dir�exists�mkdir�open�write�textwrap�dedent�format)rrr2�fpr r,r!r"7s0�
����zBuildEnvironment.__init__cCsndd�dD�|_|jdd�}|jd}|r>|�|�tj��|jg}tj�tj�	|�dtj�	|�d��dS)NcSsi|]}|tj�|d��qSr')r�environ�getr*r r r!�
<dictcomp>os�z.BuildEnvironment.__enter__.<locals>.<dictcomp>)�PATHZPYTHONNOUSERSITEZ
PYTHONPATHrG�1)
�	_save_envr4r:�splitr�pathsepr;rD�updater()rrZold_pathZ
pythonpathr r r!�	__enter__ns�


�zBuildEnvironment.__enter__cCs:|j��D]*\}}|dkr*tj�|d�q
|tj|<q
dSr')rI�itemsrrD�pop)r�exc_type�exc_val�exc_tbZvarname�	old_valuer r r!�__exit__�szBuildEnvironment.__exit__cCs|j��dSr')r)�cleanupr,r r r!rU�szBuildEnvironment.cleanupcCs�t�}t�}|r�t|j�}|D]p}z"|�t�|��dkrB|�|�Wqtk
r�}z*|�t|j	d�
��t|j	d�f�W5d}~XYqXq||fS)z�Return 2 sets:
            - conflicting requirements: set of (installed, wanted) reqs tuples
            - missing requirements: set of reqs
        Nr�)�setrr5�findr�parse�addr�str�argsZas_requirement)rZreqsZmissingZconflictingZwsZreq�er r r!�check_requirements�s
�z#BuildEnvironment.check_requirementsc	CsV|j|}d|_|sdStjtj�t�dddd|jdg}t�	�t
jkrP|�d�dD]:}t
|j|�}|�d	|�d
d�d�t|p�d
h��f�qT|j}	|	r�|�d|	dg�|	dd�D]}
|�d|
g�q�n
|�d�|jD]}|�d|g�q�|jD]}|�d|g�q�|j�r|�d�|�d	�|�|�t|��}
t||
d�W5QRXdS)NTZinstallz--ignore-installedz	--no-userz--prefixz--no-warn-script-locationz-v)Z	no_binaryZonly_binaryz--�_�-�,z:none:z-irrVz--extra-index-urlz
--no-indexz--find-linksz--trusted-hostz--pre)�spinner)r3r�sys�
executablerr�dirname�pip_location�loggerZgetEffectiveLevel�logging�DEBUGr9�getattr�format_controlr:�replacer(�sorted�
index_urlsZ
find_linksZ
trusted_hostsZallow_all_prereleasesrr	)r�finder�requirementsZprefix_as_string�messagerr\rkZformatsrnZextra_index�linkZhostrbr r r!�install_requirements�sH

�
�






z%BuildEnvironment.install_requirementsN)
r#r$r%�__doc__r"rMrTrUr^rsr r r r!r&3s7r&c@s8eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
�NoOpBuildEnvironmentz5A no-op drop-in replacement for BuildEnvironment
    cCsdSr'r r,r r r!r"�szNoOpBuildEnvironment.__init__cCsdSr'r r,r r r!rM�szNoOpBuildEnvironment.__enter__cCsdSr'r )rrPrQrRr r r!rT�szNoOpBuildEnvironment.__exit__cCsdSr'r r,r r r!rU�szNoOpBuildEnvironment.cleanupcCs
t��dSr')�NotImplementedError)rrorprrqr r r!rs�sz)NoOpBuildEnvironment.install_requirementsN)	r#r$r%rtr"rMrTrUrsr r r r!ru�sru))rtrhrrcr@�collectionsrZdistutils.sysconfigrZ	sysconfigrZpip._vendor.pkg_resourcesrrrZpiprrfZpip._internal.utils.subprocessr	Zpip._internal.utils.temp_dirr
Zpip._internal.utils.typingrZpip._internal.utils.uir�typingr
rrrrZpip._internal.indexrZ	getLoggerr#rgr�objectr&rur r r r!�<module>s*
site-packages/pip/_internal/__pycache__/legacy_resolve.cpython-38.opt-1.pyc000064400000024134151446176770022657 0ustar00U

��.eRC�@sFdZddlZddlZddlmZddlmZddlmZddl	m
Z
mZmZm
Z
mZddlmZddlmZmZmZmZdd	lmZmZdd
lmZe�rddlmZmZmZmZm Z m!Z!ddl"m#Z#dd
l$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ee0e-ge-fZ1e�2e3�Z4ddd�Z5Gdd�de6�Z7dS)ayDependency Resolution

The dependency resolution in pip is performed as follows:

for top-level requirements:
    a. only one spec allowed per project, regardless of conflicts or not.
       otherwise a "double requirement" exception is raised
    b. they override sub-dependency requirements.
for sub-dependencies
    a. "first found, wins" (where the order is breadth first)
�N)�defaultdict)�chain)�
specifiers)�BestVersionAlreadyInstalled�DistributionNotFound�	HashError�
HashErrors�UnsupportedPythonVersion)�
indent_log)�dist_in_install_path�dist_in_usersite�
ensure_dir�normalize_version_info)�check_requires_python�get_requires_python)�MYPY_CHECK_RUNNING)�Callable�DefaultDict�List�Optional�Set�Tuple)�
pkg_resources)�AbstractDistribution)�
PipSession)�
PackageFinder)�RequirementPreparer)�InstallRequirement)�RequirementSetFc
Cs�t|�}zt||d�}Wn:tjk
rR}zt�d|j|�WY�dSd}~XYnX|r\dSd�tt	|��}|r�t�
d|j||�dStd�|j||���dS)a�
    Check whether the given Python version is compatible with a distribution's
    "Requires-Python" value.

    :param version_info: A 3-tuple of ints representing the Python
        major-minor-micro version to check.
    :param ignore_requires_python: Whether to ignore the "Requires-Python"
        value if the given Python version isn't compatible.

    :raises UnsupportedPythonVersion: When the given Python version isn't
        compatible.
    )�version_infoz-Package %r has an invalid Requires-Python: %sN�.zBIgnoring failed Requires-Python check for package %r: %s not in %rz8Package {!r} requires a different Python: {} not in {!r})
rrrZInvalidSpecifier�logger�warningZproject_name�join�map�str�debugr	�format)�distr�ignore_requires_pythonZrequires_pythonZ
is_compatible�exc�version�r,�@/usr/lib/python3.8/site-packages/pip/_internal/legacy_resolve.py�_check_dist_requires_python>s>�
����r.csdeZdZdZdddhZd�fdd�	Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Z�Z
S)�Resolverz�Resolves which packages need to be installed/uninstalled to perform     the requested operation without breaking the requirements of any package.
    �eager�only-if-needed�to-satisfy-onlyNcs�tt|���|dkr&tjdd�}nt|�}||_||_||_||_	d|_
|
|_|	|_||_
||_||_||_||_tt�|_dS)N�)�superr/�__init__�sysrr�_py_version_info�preparer�finder�session�require_hashes�upgrade_strategy�force_reinstall�ignore_dependencies�ignore_installedr)�
use_user_site�_make_install_reqr�list�_discovered_dependencies)�selfr8r:r9Zmake_install_reqr@r>r?r)r=r<Zpy_version_info��	__class__r,r-r5us$�zResolver.__init__c	Cs�|jjrt|jj�|jt|j���}|jp>tdd�|D��|_|j	j
}|��}|r`t�
|�g}t�}t||�D]N}z|�|�||��Wqttk
r�}z||_|�|�W5d}~XYqtXqt|r�|�dS)a�Resolve what operations need to be done

        As a side-effect of this method, the packages (and their dependencies)
        are downloaded, unpacked and prepared for installation. This
        preparation is done by ``pip.operations.prepare``.

        Once PyPI has static dependency metadata available, it would be
        possible to move the preparation to become a step separated from
        dependency resolution.
        css|]}|jVqdS�N)Zhas_hash_options)�.0�reqr,r,r-�	<genexpr>�sz#Resolver.resolve.<locals>.<genexpr>N)r8Zwheel_download_dirr
Zunnamed_requirementsrB�requirements�valuesr;�anyr9�search_scopeZget_formatted_locationsr!�inforr�extend�_resolve_onerrI�append)	rD�requirement_setZ	root_reqsrNZ	locationsZdiscovered_reqsZhash_errorsrIr*r,r,r-�resolve�s2
���

�zResolver.resolvecCs&|jdkrdS|jdkrdS|jSdS)Nr2Fr0T)r<�	is_direct�rDrIr,r,r-�_is_upgrade_allowed�s


zResolver._is_upgrade_allowedcCs,|jrt|j�r"t|j�r"|j|_d|_dS)z4
        Set a requirement to be installed.
        N)r@r�satisfied_byrZconflicts_withrVr,r,r-�_set_req_to_reinstall�s��zResolver._set_req_to_reinstallcCs�|jr
dS|�|j�|js dS|jr4|�|�dS|�|�sP|jdkrLdSdS|js�z|j	j
|dd�Wn(tk
r�YdStk
r�YnX|�|�dS)aCheck if req_to_install should be skipped.

        This will check if the req is installed, and whether we should upgrade
        or reinstall it, taking into account all the relevant user options.

        After calling this req_to_install will only have satisfied_by set to
        None if the req_to_install is to be upgraded/reinstalled etc. Any
        other value will be a dist recording the current thing installed that
        satisfies the requirement.

        Note that for vcs urls and the like we can't assess skipping in this
        routine - we simply identify that we need to pull the thing down,
        then later on it is pulled down and introspected to assess upgrade/
        reinstalls etc.

        :return: A text reason for why it was skipped, or None.
        Nr1z#already satisfied, skipping upgradezalready satisfiedT)Zupgradezalready up-to-date)
r?�check_if_existsr@rXr=rYrWr<�linkr9Zfind_requirementrr)rD�req_to_installr,r,r-�_check_skip_installed�s*



zResolver._check_skip_installedcCs�|jr|j�||j|j|j�S|�|�}|jr@|j�||j|�S|�	|�}|�
|j||j�|j�||j|j|j�}|j
s�|�|j�|jr�|jdkp�|jp�|j
p�|jjdk}|r�|�|�nt�d|�|S)zzTakes a InstallRequirement and returns a single AbstractDist         representing a prepared variant of the same.
        r2�filez<Requirement already satisfied (use --upgrade to upgrade): %s)�editabler8Zprepare_editable_requirementr;r@r9r]rXZprepare_installed_requirementrWZ
populate_linkZprepare_linked_requirementr:r?rZr<r=r[ZschemerYr!rO)rDrIZskip_reasonZupgrade_allowed�
abstract_distZ
should_modifyr,r,r-�_get_abstract_dist_forsN	�
�
�
��
��zResolver._get_abstract_dist_forc
	s4�js�jrgSd�_�j�������}|��}t|�j�jd�g�����fdd�}t	�����
�j�s�d�_�j
�dd��j�s
�jr�t�dd��j��tt�j�t|j��}|D]}t�d	||�q�tt|j�t�j�@�}|�|�D]}	||	|d
�q��j�s&�j�s&�j���W5QRX�S)zxPrepare a single requirements file.

        :return: A list of additional InstallRequirements to also install.
        T)rr)csP��t|���}�j}�j|||d�\}}|rB|rB�j|�|���|�dS)N)�parent_req_name�extras_requested)rAr%�name�add_requirementrCrRrP)�subreqrcZsub_install_reqrbZ
to_scan_againZ
add_to_parent�Z	more_reqsr\rSrDr,r-�add_req}s��

�z&Resolver._resolve_one.<locals>.add_reqN)rbz!Installing extra requirements: %r�,z"%s does not provide the extra '%s')rc)�
constraintZpreparedZreqs_to_cleanuprRraZget_pkg_resources_distributionr.r7r)r
Zhas_requirementrdrUrer>Zextrasr!r&r#�sorted�setr"Zrequiresr_rXZsuccessfully_downloaded)
rDrSr\r`r(rhZmissing_requestedZmissingZavailable_requestedrfr,rgr-rQ[sV

��
����zResolver._resolve_onecs8g�t������fdd��|j��D]}�|�q&�S)z�Create the installation order.

        The installation order is topological - requirements are installed
        before the requiring thing. We break cycles at an arbitrary point,
        and make no other guarantees.
        csN|js|�krdS|jrdS��|��j|jD]}�|�q2��|�dSrG)rXrj�addrCrdrR)rIZdep��orderZordered_reqs�schedulerDr,r-rp�s

z1Resolver.get_installation_order.<locals>.schedule)rlrKrL)rDZreq_setZinstall_reqr,rnr-�get_installation_order�s

zResolver.get_installation_order)N)�__name__�
__module__�__qualname__�__doc__Z_allowed_strategiesr5rTrWrYr]rarQrq�
__classcell__r,r,rEr-r/ns
�+3

5<Zr/)F)8ruZloggingr6�collectionsr�	itertoolsrZpip._vendor.packagingrZpip._internal.exceptionsrrrrr	Zpip._internal.utils.loggingr
Zpip._internal.utils.miscrrr
rZpip._internal.utils.packagingrrZpip._internal.utils.typingr�typingrrrrrrZpip._vendorrZpip._internal.distributionsrZpip._internal.network.sessionrZpip._internal.indexrZ pip._internal.operations.preparerZpip._internal.req.req_installrZpip._internal.req.req_setrr%ZInstallRequirementProviderZ	getLoggerrrr!r.�objectr/r,r,r,r-�<module>s4 
�
�
0site-packages/pip/_internal/__pycache__/download.cpython-38.pyc000064400000026267151446176770020535 0ustar00U

��.eEQ�@s�ddlmZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZm
Z
ddlmZddlmZddlmZmZddlmZdd	lmZdd
lmZddlmZddlmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd
l(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3e+�r�ddl4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:ddl;m<Z<ddl=m>Z>ddl?m@Z@ddlAmBZBe�r�e<de6eCe7eCge7eCfeDd�dd�ZEn8e<de6eCeCgdfe6eCe7eCge7eCfeDeDd�dd�ZEdddd d!d"d#gZFe�GeH�ZId=d$d�ZJe�Kd%ejL�ZMd&d�ZNd'd(�ZOd)d*�ZPd+d,�ZQd-d.�ZRd>d0d �ZSd1d2�ZTd3d4�ZUd?d5d�ZVd@d6d!�ZWd7d#�ZXd8d"�ZYd9d:�ZZd;d<�Z[dS)A�)�absolute_importN)�requests)�CONTENT_CHUNK_SIZE�Response)�PY2)�parse)�HashMismatch�InstallationError)�PyPI)�
PipSession)�auto_decode)�copy2_fixed)	�ask_path_exists�
backup_dir�consume�display_path�format_size�hide_url�path_to_display�rmtree�splitext)�
TempDirectory)�MYPY_CHECK_RUNNING)�DownloadProgressProvider)�unpack_file)�get_url_scheme)�vcs)�IO�Callable�List�Optional�Text�Tuple)�	TypedDict)�Link)�Hashes)�VersionControl�CopytreeKwargs��ignore�symlinksF)Ztotal)�
copy_functionr)Zignore_dangling_symlinksr*�get_file_content�unpack_vcs_link�unpack_file_url�unpack_http_url�
unpack_url�parse_content_disposition�sanitize_content_filenamec

Cs6|dkrtd��t|�}|dkr>|�|�}|��|j|jfS|dkr�|rd|�d�rdtd||f��|�dd�d}|�	d	d
�}t
�|�}|r�|�d�d|�dd�d}t
�|�}|�d
�r�d
|�d
�}|}z&t|d��}t|���}W5QRXWn4tk
�r,}	ztd
t|	���W5d}	~	XYnX||fS)a*Gets the content of a file; it may be a filename, file: URL, or
    http: URL.  Returns (location, content).  Content is unicode.

    :param url:         File path or url.
    :param comes_from:  Origin description of requirements.
    :param session:     Instance of pip.download.PipSession.
    NzAget_file_content() missing 1 required keyword argument: 'session')�httpZhttps�filer3z6Requirements file %s references URL %s, which is local�:��\�/�|�rbz$Could not open requirements file: %s)�	TypeErrorr�get�raise_for_status�url�text�
startswithr	�split�replace�_url_slash_drive_re�match�group�urllib_parseZunquote�lstrip�openr�read�IOError�str)
r>Z
comes_from�session�scheme�resp�pathrD�fZcontent�exc�rR�:/usr/lib/python3.8/site-packages/pip/_internal/download.pyr,UsB	�
��



�z/*([a-z])\|cCs,t|�}|dk	st�|j|t|j�d�dS)N)r>)�_get_used_vcs_backend�AssertionError�unpackrr>)�link�location�vcs_backendrRrRrSr-�scCs$tjD]}|j|jkr|SqdS)z1
    Return a VersionControl object or None.
    N)rZbackendsrMZschemes)rWrYrRrRrSrT�s

rTcOs|S�NrR)�iterable�args�kwargsrRrRrS�_progress_indicator�sr^c
s6zt�jd�}Wntttfk
r0d}YnXt�dd�}t��tj	krRd}n&|r\d}n|dkrjd}n|std}nd}|j
}�fdd�}	�fd	d
�}
t}|jt
jkr�|}n|j}|r�t||d�}|r�t�d|t|��nt�d
|�n|r�t�d|�nt�d
|�|
||	t�t��}
|�r*|�|
�nt|
�dS)Nzcontent-lengthrZ
from_cacheFi@�Tc3sTz �jj|dd�D]
}|VqWn.tk
rN�j�|�}|sBqJ|Vq0YnXdS)NF)Zdecode_content)�raw�stream�AttributeErrorrI)Z
chunk_size�chunk)rNrRrS�	resp_read�s�
z _download_url.<locals>.resp_readc3s|D]}��|�|VqdSrZ)�write)Zchunksrb)�content_filerRrS�written_chunks�s
z%_download_url.<locals>.written_chunks)�maxzDownloading %s (%s)zDownloading %szUsing cached %s)�int�headers�
ValueError�KeyErrorr;�getattr�loggerZgetEffectiveLevel�logging�INFO�show_urlr^Znetlocr
Zurl_without_fragmentr�inforrZcheck_against_chunksr)rNrWre�hashes�progress_barZtotal_lengthZcached_respZ
show_progressrprcrfZprogress_indicatorr>Zdownloaded_chunksrR)rerNrS�
_download_url�sP
%���rtcCs�d}tj�||j�}tj�|�r�tdt|�d�}|dkr@d}nj|dkrdt�dt|��t�	|�nF|dkr�t
|�}t�d	t|�t|��t�||�n|d
kr�t
�d�|r�t�||�t�dt|��dS)
NTz8The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)abort)�i�w�b�aruFrvzDeleting %srwzBacking up %s to %srx���zSaved %s)�osrO�join�filename�existsrrrm�warning�remover�shutilZmove�sys�exit�copyrq)r|rXrWr�Zdownload_location�responseZ	dest_filerRrRrS�
_copy_files6���
r��onc
	Cs�|dkrtd��tdd��v}d}|r0t|||�}|rH|}t�|�d}	nt|||j||�\}}	t|||	�|r~|s~t|||�|s�t	�
|�W5QRXdS)Nz@unpack_http_url() missing 1 required keyword argument: 'session'rV)Zkindr)r;r�_check_download_dir�	mimetypes�
guess_type�_download_http_urlrOrr�rz�unlink)
rWrX�download_dirrLrrrs�temp_dir�already_downloaded_path�	from_path�content_typerRrRrSr/s2	���c
CsTzt||�Wn@tjk
rN}z t�dt|�t|�t|��W5d}~XYnXdS)z�Copying special files is not supported, but as a convenience to users
    we skip errors copying them. This supports tools that may create e.g.
    socket files in the project source directory.
    z>Ignoring special file error '%s' encountered copying %s to %s.N)r
r�ZSpecialFileErrorrmr~rKr)�src�dest�erRrRrS�_copy2_ignoring_special_filesJs�r�cs`tj�|�}tj�|��tj�|�����fdd�}t|dd�}tsLt|d<tj	�|f|�dS)Ncs6g}|�kr|ddg7}tj�|��kr2|�g7}|S)Nz.toxz.nox)rzrO�abspath)�d�namesZskipped��sourceZtarget_basenameZtarget_dirnamerRrSr)es
z!_copy_source_tree.<locals>.ignoreTr(r+)
rzrOr��basename�dirname�dictrr�r�Zcopytree)r��targetZtarget_abspathr)r]rRr�rS�_copy_source_tree_sr�cCs�|j}|��r>tj�|�r"t|�t||�|r:t�d�dS|rL|�	|�d}|r`t
|||�}|rj|}n|}t�|�d}t
|||�|r�|s�t|||�dS)z�Unpack link into location.

    If download_dir is provided and link points to a file, make a copy
    of the link file inside download_dir.
    z*Link is a directory, ignoring download_dirNr)�	file_pathZis_existing_dirrzrO�isdirrr�rmrq�check_against_pathr�r�r�rr�)rWrXr�rrZ	link_pathr�r�r�rRrRrSr.~s.


�cCsP|jrt||�n:|jr*t||||d�n"|dkr8t�}t||||||d�dS)avUnpack link.
       If link is a VCS link:
         if only_download, export into download_dir and ignore location
          else unpack into location
       for other types of link:
         - unpack into location
         - if download_dir, copy the file into download_dir
         - if only_download, mark location for deletion

    :param hashes: A Hashes object, one of whose embedded hashes must match,
        or HashMismatch will be raised. If the Hashes is empty, no matches are
        required, and unhashable types of requirements (like VCS ones, which
        would ordinarily raise HashUnsupported) are allowed.
    )rrN)rrrs)Zis_vcsr-�is_filer.rr/)rWrXr�rLrrrsrRrRrSr0�s�cCstj�|�S)zJ
    Sanitize the "filename" value from a Content-Disposition header.
    )rzrOr�)r|rRrRrSr2�scCs,t�|�\}}|�d�}|r$t|�}|p*|S)z�
    Parse the "filename" value from a Content-Disposition header, and
    return the default filename if the result is empty.
    r|)�cgiZparse_headerr<r2)�content_dispositionZdefault_filenameZ_typeZparamsr|rRrRrSr1�s

c
Cs*|j�dd�d}z |j|ddidd�}|��Wn8tjk
rj}zt�d|jj	|��W5d	}~XYnX|j
�d
d�}|j}	|j
�d�}
|
r�t|
|	�}	t
|	�d}|s�t�|�}|r�|	|7}	|s�|j|jkr�tj�
|j�d}|r�|	|7}	tj�||	�}t|d
��}
t|||
||�W5QRX||fS)z6Download link url into temp_dir using provided session�#r6rzAccept-EncodingZidentityT)rir`zHTTP error %s while getting %sNzcontent-type�zcontent-disposition�wb)r>rAr<r=rZ	HTTPErrorrmZcriticalr�Zstatus_coderir|r1rr�Zguess_extensionrzrOr{rHrt)rWrLr�rrrsZ
target_urlrNrQr�r|r�Zextr�rerRrRrSr��sB	��

r�cCsptj�||j�}tj�|�s dSt�d|�|rlz|�|�Wn,tk
rjt�	d|�t�
|�YdSX|S)z� Check download_dir for previously downloaded file with correct hash
        If a correct file is found return its path else None
    NzFile was already downloaded %sz;Previously-downloaded file %s has bad hash. Re-downloading.)rzrOr{r|r}rmrqr�rr~r�)rWr�rrZ
download_pathrRrRrSr�7s�
r�)NN)NNNr�)NN)NNNr�)\Z
__future__rr�rnr�rz�rer�r�Zpip._vendorrZpip._vendor.requests.modelsrrZpip._vendor.sixrZpip._vendor.six.moves.urllibrrFZpip._internal.exceptionsrr	Zpip._internal.models.indexr
Zpip._internal.network.sessionrZpip._internal.utils.encodingrZpip._internal.utils.filesystemr
Zpip._internal.utils.miscrrrrrrrrrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.uirZpip._internal.utils.unpackingrZpip._internal.utils.urlsrZpip._internal.vcsr�typingrrrr r!r"Zmypy_extensionsr#Zpip._internal.models.linkr$Zpip._internal.utils.hashesr%Z pip._internal.vcs.versioncontrolr&rK�boolr'�__all__Z	getLogger�__name__rmr,�compile�IrCr-rTr^rtr�r/r�r�r.r0r2r1r�r�rRrRrRrS�<module>s�, ��	���

0d�
-"�
8�
.?site-packages/pip/_internal/__pycache__/pep425tags.cpython-38.pyc000064400000023072151446176770020613 0ustar00U

��.eE>�@sTdZddlmZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
ZddlmZddlmZer�ddlmZmZmZmZmZmZmZeeeefZe�e�Ze� d�Z!d	d
�Z"dd�Z#d
d�Z$dd�Z%dd�Z&dd�Z'd-dd�Z(dd�Z)dd�Z*dd�Z+dd�Z,d d!�Z-d"d#�Z.d$d%�Z/d&d'�Z0d(d)�Z1d.d+d,�Z2e'�Z3dS)/z2Generate and work with PEP 425 Compatibility Tags.�)�absolute_importN)�OrderedDict)�get_extension_suffixes)�MYPY_CHECK_RUNNING)�Tuple�Callable�List�Optional�Union�Dict�Setz(.+)_(\d+)_(\d+)_(.+)c
CsLzt�|�WStk
rF}zt�d�|�t�WY�dSd}~XYnXdS)Nz{})�	sysconfig�get_config_var�IOError�warnings�warn�format�RuntimeWarning)�var�e�r�</usr/lib/python3.8/site-packages/pip/_internal/pep425tags.pyrs
rcCs:ttd�rd}n&tj�d�r"d}ntjdkr2d}nd}|S)z'Return abbreviated implementation name.�pypy_version_info�pp�javaZjyZcliZip�cp)�hasattr�sys�platform�
startswith)Zpyimplrrr�
get_abbr_impl&s

r cCsd�tt|dd���S)N��)�join�map�str)�version_inforrr�version_info_to_nodot4sr'cCs,td�}|rt�dkr(d�ttt���}|S)zReturn implementation version.Zpy_version_nodotrr!)rr r#r$r%�get_impl_version_info)Zimpl_verrrr�get_impl_ver:sr)cCs:t�dkr"tjdtjjtjjfStjdtjdfSdS)zQReturn sys.version_info-like tuple for use in decrementing the minor
    version.rr�N)r rr&r�major�minorrrrrr(Cs
�r(cCsd�t�t��S)z;
    Returns the Tag for this specific implementation.
    z{}{})rr r)rrrr�get_impl_tagQsr-TcCs.t|�}|dkr&|r t�d|�|�S||kS)zgUse a fallback method for determining SOABI flags if the needed config
    var is unset or unavailable.Nz>Config variable '%s' is unset, Python ABI tag may be incorrect)r�logger�debug)rZfallback�expectedr�valrrr�get_flagYs�r2cs�td�}t�}d}|s�|dkr�ttd�r�d}d}d}|dk�tddd	��d
�rRd}tjdkrvtd
�fdd	��d
�rvd}tjdkr�tddd	�d�d�r�d}d|t�|||f}n:|r�|�d�r�d|�d�d}n|r�|�	dd��	dd�}|S)zXReturn the ABI tag based on SOABI (if available) or emulate SOABI
    (CPython 2, PyPy).ZSOABIN>rr�
maxunicoder!rZPy_DEBUGcSs
ttd�S)NZgettotalrefcount)rrrrrr�<lambda>t�zget_abi_tag.<locals>.<lambda>)r�d)��Z
WITH_PYMALLOCcs�S)Nrr�Z
is_cpythonrrr4xr5�m)r7r7ZPy_UNICODE_SIZEcSs
tjdkS)Ni��)rr3rrrrr4{r5�)r0r�uz
%s%s%s%s%szcpython-�-r*�.�_)
rr rrr2r&r)r�split�replace)Zsoabi�impl�abir6r:r<rr9r�get_abi_tagfsB�
��rDcCs
tjdkS)Ni���)r�maxsizerrrr�_is_running_32bit�srFcCs�tjdkr^t��\}}}|�d�}|dkr6t�r6d}n|dkrHt�rHd}d�|d|d	|�Stj���	dd
��	dd
�}|dkr�t�r�d
}|S)z0Return our platform name 'win32', 'linux_x86_64'�darwinr>�x86_64�i386�ppc64�ppczmacosx_{}_{}_{}rr*r?r=�linux_x86_64�
linux_i686)
rrZmac_verr@rFr�	distutils�util�get_platformrA)�releaser?�machineZ	split_ver�resultrrrrP�s

rPc
Cs$t�dkrdSz&ttjd��}|�d�}W5QRXWntttfk
rPYdSX|dksft|�dkrjdSt	|t
�r�dd�|D�}ndd�|D�}|dd	�d
ddd
gk}||d	d�dgkM}||dd�dgkM}||dd�ddgkM}||dd�dgkM}||dd�dd	@d	kM}|S)N�linux_armv7lF�rb�(cSsg|]}t|��qSr)�ord)�.0�crrr�
<listcomp>�sz"is_linux_armhf.<locals>.<listcomp>cSsg|]}|�qSrr)rX�brrrrZ�srr;��E�L�F�r*����'�%�&)rP�openr�
executable�readr�OSError�	TypeError�len�
isinstancer%)�fZelf_header_rawZ
elf_headerrSrrr�is_linux_armhf�s&

roc	CsNt�dkrdSzddl}t|j�WSttfk
r:YnXtjjj	�
dd�S)N�rMrLFrr"r`)rP�
_manylinux�boolZmanylinux1_compatible�ImportError�AttributeError�pip�	_internal�utils�glibc�have_compatible_glibc�rqrrr�is_manylinux1_compatible�s
r{c	CsNt�dkrdSzddl}t|j�WSttfk
r:YnXtjjj	�
dd�S)NrpFrr"�)rPrqrrZmanylinux2010_compatiblersrtrurvrwrxryrzrrr�is_manylinux2010_compatible�s
r}c	Csdt�}|dkrdS|dkr$t�s$dSzddl}t|j�WSttfk
rPYnXtjj	j
�dd�S)N>rM�linux_s390x�
linux_ppc64lerLrT�
linux_aarch64�linux_ppc64FrTrr"�)rProrqrrZmanylinux2014_compatiblersrtrurvrwrxry)rrqrrr�is_manylinux2014_compatible�sr�csrg}��fdd��tddddg���|||�r8|�|��D]&}|�|kr<�|||�r<|�|�q<|�d�|S)z�Return a list of supported arches (including group arches) for
    the given major, minor and machine architecture of an macOS machine.
    cs||dkr||fdkS|dkr(||fdkS|dkr<||fdkS|dkrP||fdkS|�krx�|D]}�|||�r`dSq`dS)	NrK)�
r`rJrI)r�r;rHTFr)r+r,�arch�garch��_supports_arch�groupsrrr�sz)get_darwin_arches.<locals>._supports_arch)Zfat)rIrK)Zintel)rHrI)Zfat64)rHrJ)Zfat32)rHrIrKZ	universal)r�append)r+r,rR�archesr�rr�r�get_darwin_arches�s%�

r�c	CsFg}|dd�}t|ddd�D] }|�d�tt||f���q |S)N���r!)�ranger�r#r$r%)r&�versionsr+r,rrr�!get_all_minor_versions_as_strings>s
r�FcCsDg}|dkrt�}t|�}|p"t�}g}|p0t�}|rD|g|dd�<t�}t�D]$}	|	�d�rP|�|	�dd�d�qP|�	t
t|���|�d�|�s�|p�t
�}
|
�d�\}}}
|
�d	��r>t�|
�}|�r6|��\}}}}d
�||�}g}ttt|�d��D]0}tt|�||�D]}|�|||f��q�qn|
g}n�|dk�r~|
g}|
dk�r|�d
||
�|�d||
�n�|d
k�r�|
d||
g}nn|dk�rg}t��r�|�d||
�t��r�|�d
||
�t��r�|�d||
�|�|
�n|
g}|D].}|D]"}
|�d||df||
f��q�q|dd�D]F}|dk�r\�q�|D]*}|D]}
|�d||f||
f��qh�q`�qH|D]"}
|�d|ddd|
f��q�|�d||dfddf�|�d||ddfddf�t|�D]B\}}|�d|fddf�|dk�r�|�d|dddf��q�|S)acReturn a list of supported tags for each version specified in
    `versions`.

    :param versions: a list of string versions, of the form ["33", "32"],
        or None. The first version will be assumed to support our ABI.
    :param platform: specify the exact platform you want valid
        tags for, or None. If None, use the local system platform.
    :param impl: specify the exact implementation you want valid
        tags for, or None. If None, use the local interpreter impl.
    :param abi: specify the exact abi you want valid
        tags for, or None. If None, use the local interpreter abi.
    Nrz.abir>r"r*Znoner?Zmacosxz{}_{}_%i_%sZ
manylinux2014>rH�i686Z
manylinux2010Z
manylinux1z%s%s>�31�30zpy%s�any)r(r�r rD�setrr�addr@�extend�sorted�listr�rP�	partition�
_osx_arch_pat�matchr�r�reversedr��intr�r�r}r{�	enumerate)r�ZnoarchrrBrCZ	supportedr&ZabisZabi3s�suffixr�Zarch_prefixZarch_sepZarch_suffixr��namer+r,Zactual_archZtplr�r:�a�version�irrr�
get_supportedHs~










$
$  
r�)TT)NFNNN)4�__doc__Z
__future__rZdistutils.utilrNZloggingr�rerr
r�collectionsrZpip._internal.utils.glibcruZpip._internal.utils.compatrZpip._internal.utils.typingr�typingrrrr	r
rrr%Z	Pep425TagZ	getLogger�__name__r.�compiler�rr r'r)r(r-r2rDrFrPror{r}r�r�r�r�Zimplementation_tagrrrr�<module>sP$

		

!?�
ysite-packages/pip/_internal/__pycache__/cache.cpython-38.pyc000064400000016045151446176770017762 0ustar00U

��.e� �@s�dZddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZddl
mZddlmZdd	lmZmZer�dd
lmZmZmZmZddlmZddlmZe�e�ZGd
d�de �Z!Gdd�de!�Z"Gdd�de"�Z#Gdd�de!�Z$dS)zCache Management
�N)�canonicalize_name)�Link)�
expanduser)�
TempDirectory)�MYPY_CHECK_RUNNING)�path_to_url)�InvalidWheelFilename�Wheel)�Optional�Set�List�Any)�
FormatControl)�	Pep425TagcsPeZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
�ZS)�Cachea�An abstract class - provides cache directories for data from links


        :param cache_dir: The root of the cache.
        :param format_control: An object of FormatControl class to limit
            binaries being read from the cache.
        :param allowed_formats: which formats of files the cache should store.
            ('binary' and 'source' are the only allowed values)
    csLtt|���|rt|�nd|_||_||_ddh}|j�|�|ksHt�dS)N�source�binary)	�superr�__init__r�	cache_dir�format_control�allowed_formats�union�AssertionError)�selfrrrZ_valid_formats��	__class__��7/usr/lib/python3.8/site-packages/pip/_internal/cache.pyr(szCache.__init__cCs�|jg}|jdk	r4|jdk	r4|�d�|j|jg��d�|�}t�|�����}|dd�|dd�|dd�|dd�g}|S)zEGet parts of part that must be os.path.joined with cache_dir
        N�=�#���)	Zurl_without_fragmentZ	hash_name�hash�append�join�hashlibZsha224�encodeZ	hexdigest)r�linkZ	key_partsZkey_urlZhashed�partsrrr�_get_cache_path_parts2s
,zCache._get_cache_path_partsc
Cs�|jp|p|}|rgSt|�}|j�|�}|j�|�s@gS|�|�}zt�|�WSt	k
r�}z$|j
t
jt
jhkr�gWY�S�W5d}~XYnXdS�N)
rrrZget_allowed_formatsr�intersection�get_path_for_link�os�listdir�OSError�errnoZENOENTZENOTDIR)rr)�package_nameZ
can_not_cacheZcanonical_nameZformats�root�errrrr�_get_candidatesLs(���
zCache._get_candidatescCs
t��dS)z>Return a directory to store cached items in for link.
        N��NotImplementedError�rr)rrrr.eszCache.get_path_for_linkcCs
t��dS)zaReturns a link to a cached item if it exists, otherwise returns the
        passed link.
        Nr7)rr)r3�supported_tagsrrr�getks
z	Cache.getcCs$|�|�}tj�||�}tt|��Sr,)r.r/�pathr&rr)rr)�	candidater4r<rrr�_link_for_candidatews
zCache._link_for_candidatecCsdSr,r�rrrr�cleanup~sz
Cache.cleanup)�__name__�
__module__�__qualname__�__doc__rr+r6r.r;r>r@�
__classcell__rrrrrs

rcs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�SimpleWheelCachez+A cache of wheels for future installs.
    cstt|��||dh�dS�Nr)rrFr�rrrrrrr�s

�zSimpleWheelCache.__init__cCs |�|�}tjj|jdf|��S)a�Return a directory to store cached wheels for link

        Because there are M wheels for any one sdist, we provide a directory
        to cache them in, and then consult that directory when looking up
        cache hits.

        We only insert things into the cache if they have plausible version
        numbers, so that we don't contaminate the cache with things that were
        not unique. E.g. ./package might have dozens of installs done for it
        and build a version of 0.0...and if we built and cached a wheel, we'd
        end up using the same wheel even if the source has been edited.

        :param link: The link of the sdist for which this will cache wheels.
        Zwheels)r+r/r<r&r)rr)r*rrrr.�s
z"SimpleWheelCache.get_path_for_linkc	Csxg}|�||�D]J}zt|�}Wntk
r8YqYnX|�|�sFq|�|�|�|f�q|sd|S|�|t|�d�S)N�)r6r	rZ	supportedr%Zsupport_index_minr>�min)rr)r3r:Z
candidatesZ
wheel_nameZwheelrrrr;�s

�zSimpleWheelCache.get)rArBrCrDrr.r;rErrrrrF�srFcs(eZdZdZ�fdd�Zdd�Z�ZS)�EphemWheelCachezGA SimpleWheelCache that creates it's own temporary cache directory
    cs&tdd�|_tt|��|jj|�dS)Nzephem-wheel-cache)Zkind)r�	_temp_dirrrKrr<)rrrrrr�s

�zEphemWheelCache.__init__cCs|j��dSr,)rLr@r?rrrr@�szEphemWheelCache.cleanup)rArBrCrDrr@rErrrrrK�srKcs@eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Z�Z	S)�
WheelCachez�Wraps EphemWheelCache and SimpleWheelCache into a single Cache

    This Cache allows for gracefully degradation, using the ephem wheel cache
    when a certain link is not found in the simple wheel cache first.
    cs0tt|��||dh�t||�|_t|�|_dSrG)rrMrrF�_wheel_cacherK�_ephem_cacherHrrrr�s
�zWheelCache.__init__cCs|j�|�Sr,)rNr.r9rrrr.�szWheelCache.get_path_for_linkcCs|j�|�Sr,)rOr.r9rrr�get_ephem_path_for_link�sz"WheelCache.get_ephem_path_for_linkcCs0|jj|||d�}||k	r|S|jj|||d�S)N)r)r3r:)rNr;rO)rr)r3r:Zretvalrrrr;�s��zWheelCache.getcCs|j��|j��dSr,)rNr@rOr?rrrr@�s
zWheelCache.cleanup)
rArBrCrDrr.rPr;r@rErrrrrM�srM)%rDr2r'Zloggingr/Zpip._vendor.packaging.utilsrZpip._internal.models.linkrZpip._internal.utils.compatrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.urlsrZpip._internal.wheelrr	�typingr
rrr
Zpip._internal.indexrZpip._internal.pep425tagsrZ	getLoggerrAZlogger�objectrrFrKrMrrrr�<module>s(
f:site-packages/pip/_internal/__pycache__/wheel.cpython-38.pyc000064400000066650151446176770020032 0ustar00U

��.eH��@s4dZddlmZddlZddlZddlZddlZddlZddlZ	ddl
Z
ddlZddlZddl
Z
ddlZddlmZddlmZddlmZddlmZddlmZdd	lmZdd
lmZddlmZddlm Z m!Z!m"Z"dd
l#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-m.Z.m/Z/ddl0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6ddl7m8Z8ddl9m:Z:ddl;m<Z<ddl=m>Z>ddl?m@Z@e:�rddlAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMddlNmOZOddlPmQZQddlRmSZSddlTmUZUddlVmWZWeGeXdfZYeLeQgeZfZ[d Z\e�]e^�Z_d!d"�Z`dXd$d%�ZadYd&d'�Zbd(d)�Zcd*d+�Zdd,d-�Zee
�fd.e
jg�Zhd/d0�Zid1d2�Zjd3d4�Zkd5d6�Zld7d8�ZmGd9d:�d:en�Zod;d<�ZpGd=d>�d>e�ZqdZdAdB�ZrdCdD�ZsdEdF�ZtdGdH�ZuGdIdJ�dJev�Zwe
�fdKe
jx�fdLdM�ZydNdO�ZzdPdQ�Z{dRdS�Z|dTdU�Z}GdVdW�dWev�Z~dS)[zH
Support for installing and building the "wheel" binary package format.
�)�absolute_importN)�urlsafe_b64encode)�Parser)�
pkg_resources)�ScriptMaker)�get_export_entry)�canonicalize_name)�StringIO)�
pep425tags)�InstallationError�InvalidWheelFilename�UnsupportedWheel)�distutils_scheme�get_major_minor_version)�Link)�
indent_log)�has_delete_marker_file)�captured_stdout�
ensure_dir�read_chunks)�make_setuptools_shim_args)�LOG_DIVIDER�call_subprocess�format_command_args�runner_with_spinner_message)�
TempDirectory)�MYPY_CHECK_RUNNING)�open_spinner)�unpack_file)�path_to_url)�Dict�List�Optional�Sequence�Mapping�Tuple�IO�Text�Any�Iterable�Callable�Set)�Requirement)�InstallRequirement)�RequirementPreparer)�
WheelCache)�	Pep425Tag.)�rcCstj�||��tjjd�S)N�/)�os�path�relpath�replace�sep)�src�p�r:�7/usr/lib/python3.8/site-packages/pip/_internal/wheel.py�normpathOsr<�c	CsRt��}d}t|d��.}t||d�D]}|t|�7}|�|�q$W5QRX||fS)z5Return (hash, length) for path using hashlib.sha256()r�rb)�size)�hashlibZsha256�openr�len�update)r4�	blocksize�h�length�f�blockr:r:r;�	hash_fileSsrIcCs6t||�\}}dt|����d��d�}|t|�fS)z?Return (encoded_digest, length) for path using hashlib.sha256()zsha256=�latin1�=)rIr�digest�decode�rstrip�str)r4rDrErFrLr:r:r;�rehash_s���rPcCs6tjddkri}d}nddi}d}t|||f|�S)Nr��b�newline�)�sys�version_inforA)�name�mode�nl�binr:r:r;�open_for_csvjsr[cCs|�d�}||d<d�|�S)zBReplace the Python tag in a wheel file name with a new value.
    �-���)�split�join)Z	wheelnameZnew_tag�partsr:r:r;�replace_python_tagus
rac	Cs�tj�|�r�t|d��R}|��}|�d�s8W5QR�dStj�t�	��}d|tj
�d�}|��}W5QRXt|d��}|�|�|�|�W5QRXdSdS)	zLReplace #!python with #!/path/to/python
    Return True if file was changed.r>s#!pythonFs#!�ascii�wbTN)
r3r4�isfilerA�readline�
startswithrU�
executable�encode�getfilesystemencoding�linesep�read�write)r4Zscript�	firstlineZexename�restr:r:r;�
fix_script~s

rozX^(?P<namever>(?P<name>.+?)(-(?P<ver>.+?))?)
                                \.dist-info$c
Cs�|�dd�}t�|�D]p}t�|�}|r|�d�|krttj�||d���6}|D]*}|�	��
�}|dkrPW5QR�dSqPW5QRXqdS)zP
    Return True if the extracted wheel in wheeldir should go into purelib.
    r\�_rW�WHEELzroot-is-purelib: trueTF)r6r3�listdir�dist_info_re�match�grouprAr4r_�lowerrN)rW�wheeldirZname_folded�itemrt�wheel�liner:r:r;�root_is_purelib�s
 r{c	s�tj�|�siifSt|��8}t�}|D]}|�|���|�d�q(|�d�W5QRXtj	�
|�}|�di�}|�di�}dd��t�fdd�|�
�D��}t�fd	d�|�
�D��}||fS)
N�
rZconsole_scriptsZgui_scriptscSst|��dd��d�S)zRget the string representation of EntryPoint, remove space and split
        on '='� rTrK)rOr6r^)�sr:r:r;�	_split_ep�sz"get_entrypoints.<locals>._split_epc3s|]}�|�VqdS�Nr:��.0�v�rr:r;�	<genexpr>�sz"get_entrypoints.<locals>.<genexpr>c3s|]}�|�VqdSr�r:r�r�r:r;r��s)r3r4�existsrAr	rl�strip�seekrZ
EntryPointZ	parse_map�get�dict�values)�filename�fp�datarzZentry_points�console�guir:r�r;�get_entrypoints�s
r�csJ|sdSt�t�}|D]*}tj�|�}tj�|�}||�|�qdd�tj�	dd��
tj�D����tj�
tj�tj����fdd�|��D�}|s�dSg}|��D]b\}}t|�}t|�dkr�d	�|d
�}	n$d�d�|dd
��d|d
�}	|�d�|	|��q�d}
t|�dk�r0|�|
�d��n|�|
�d��d�|�S)z�Determine if any scripts are not on PATH and format a warning.

    Returns a warning message if one or more scripts are not on PATH,
    otherwise None.
    NcSs g|]}tj�|��tj��qSr:)r3r4�normcaserNr7)r��ir:r:r;�
<listcomp>�sz5message_about_scripts_not_on_PATH.<locals>.<listcomp>�PATHrTcs&i|]\}}tj�|��kr||�qSr:)r3r4r�)r��
parent_dir�scripts�Z
not_warn_dirsr:r;�
<dictcomp>�s�z5message_about_scripts_not_on_PATH.<locals>.<dictcomp>r1zscript {} isrzscripts {} are�, ���z and z.The {} installed in '{}' which is not on PATH.zeConsider adding {} to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.zthis directoryzthese directoriesr|)�collections�defaultdict�setr3r4�dirname�basename�add�environr�r^�pathsep�appendr�rUrg�items�sortedrB�formatr_)r�Zgrouped_by_dir�destfiler�Zscript_nameZwarn_for�	msg_linesZdir_scriptsZsorted_scriptsZ
start_textZ
last_line_fmtr:r�r;�!message_about_scripts_not_on_PATH�sH
�
�����r�cCst|dd�d�S)a;
    Return the given rows of a RECORD file in sorted order.

    Each row is a 3-tuple (path, hash, size) and corresponds to a record of
    a RECORD file (see PEP 376 and PEP 427 for details).  For the rows
    passed to this function, the size can be an integer as an int or string,
    or the empty string.
    cSstdd�|D��S)Ncss|]}t|�VqdSr�)rO)r��xr:r:r;r�sz3sorted_outrows.<locals>.<lambda>.<locals>.<genexpr>)�tuple)�rowr:r:r;�<lambda>�z sorted_outrows.<locals>.<lambda>)�key)r�)�outrowsr:r:r;�sorted_outrowssr�cCs�g}|D]v}t|�dkr(t�d�|��t|�}|d}|�||�}||d<||krpt|�\}	}
|	|d<|
|d<|�t|��q|D]*}t|�\}	}
|�t	||�|	t
|
�f�q�|D]}|�||ddf�q�|S)z_
    :param installed: A map from archive RECORD path to installation RECORD
        path.
    rQz,RECORD line has more than three elements: {}rr1�rT)rB�logger�warningr��list�poprPr�r�r<rO)Zold_csv_rows�	installed�changed�	generated�lib_dirZinstalled_rowsr�Zold_path�new_pathrLrFrGr:r:r;�get_csv_rows_for_installeds*�r�c@seZdZdS)�MissingCallableSuffixN)�__name__�
__module__�__qualname__r:r:r:r;r�=sr�cCs*t|�}|dk	r&|jdkr&tt|���dSr�)r�suffixr�rO)�
specification�entryr:r:r;�_raise_for_invalid_entrypointAsr�cseZdZd�fdd�	Z�ZS)�PipScriptMakerNcst|�tt|��||�Sr�)r��superr��make)�selfr�Zoptions��	__class__r:r;r�HszPipScriptMaker.make)N)r�r�r�r��
__classcell__r:r:r�r;r�Gsr�FTc-
s\|st||||||	d�}t|�	�r,|d�n|d�g�g��	�tjj�tjj}i�t��g}|r�t��4}
t�	�� t�
d�tj|ddd�W5QRXW5QRXt
�|
���d.����	fdd	�	�d/����fdd�	}||�d��s�td
���tj��dd�}t|�\����fdd�}�D]j}d
}d
}t�tj��	|��D]F}d
}|dk�r`t}|}tj��	||�}||}|||d||d��qF�q&td
|d�}d|_dh|_d|_g}��dd
�}|�rDdtjk�r�|�d|�tj�dd�dk�r|�dtjd|f�|�dt�|f�dd��D�}|D]}�|=�q6��dd
�}|�r�dtjk�rp|�d|�|�dt�|f�dd��D�}|D]}�|=�q�|� d d!���!�D��d"d���!�D�}g}z.|�"|�}|� |�|� |�"|d#di��Wn>t#k
�r>}z|j$d} t%d$�&| ����W5d
}~XYnX|
�rbt'|�}!|!d
k	�rbt
�(|!�tj��dd%�}"tj��dd&�}#t)|#d'��}$|$�*d(�W5QRXt+�,|#|"�|�|"�tj��dd)�}%tj��dd*�}&t-|%d+��\}'t-|&d,��F}(t.�/|'�})t0|)��|�d-�}*t.�1|(�}+t2|*�D]},|+�3|,��q&W5QRXW5QRXt+�,|&|%�d
S)0zInstall a wheel)�user�home�root�isolated�prefixZpurelibZplatlib�ignoreT)�force�quietFcs.t|��}t|��}|�|<|r*��|�dS)z6Map archive RECORD paths to installation RECORD paths.N)r<r�)�srcfiler�ZmodifiedZoldpath�newpath)r�r�r�rwr:r;�record_installeds


z*move_wheel_files.<locals>.record_installedNcs�t|�t�|�D�]�\}}}|t|�d��tjj�}tj�||�}	|rf|�tjjd�d�	d�rfq|D]�}
tj�|||
�}|r�|dkr�|�	d�r���
|
�qjqj|rj|
�	d�rjt|
��t�j
��rj�r�td|dd�������
|�qj|D]�}|�r||��rq�tj�||�}
tj�|||�}t|	�tj�|��rFt�|�t�|
|�t�|
�}ttd��r|t�||j|jf�t�|
tj��r�t�|
�}|jtjBtjBtjB}t�||�d	}|�r�||�}�|
||�q�qdS)
Nr1rz.datarTz
.dist-infoz!Multiple .dist-info directories: r��utimeF)rr3�walkrB�lstripr4r7r_r^�endswithr�rrfrW�AssertionErrorr��unlink�shutilZcopyfile�stat�hasattrr��st_atime�st_mtime�access�X_OK�st_mode�S_IXUSR�S_IXGRP�S_IXOTH�chmod)�source�destZis_base�fixer�filter�dirZsubdirs�filesZbasedirZdestdirr~Z
destsubdirrGr�r��stZpermissionsr�)�	data_dirs�info_dirr��reqr:r;�clobber�s^
������



�z!move_wheel_files.<locals>.clobberz!%s .dist-info directory not foundrzentry_points.txtcsh|���d�r|dd�}n<|���d�r8|dd�}n |���d�rT|dd�}n|}|�kpf|�kS)Nz.exe���z
-script.pyi����z.pya)rvr�)rWZ	matchname)r�r�r:r;�is_entrypoint_wrapper�sz/move_wheel_files.<locals>.is_entrypoint_wrapperr�)r�r�rTZpipZENSUREPIP_OPTIONSzpip = Z
altinstallz
pip%s = %scSsg|]}t�d|�r|�qS)zpip(\d(\.\d)?)?$��rert�r��kr:r:r;r�0sz$move_wheel_files.<locals>.<listcomp>Zeasy_installzeasy_install = zeasy_install-%s = %scSsg|]}t�d|�r|�qS)zeasy_install(-\d\.\d)?$r�r�r:r:r;r�@scss|]}d|VqdS)�%s = %sNr:�r�Zkvr:r:r;r�Gsz#move_wheel_files.<locals>.<genexpr>cSsg|]}d|�qS)r�r:r�r:r:r;r�Ksr�z�Invalid script entry point: {} for req: {} - A callable suffix is required. Cf https://packaging.python.org/en/latest/distributing.html#console-scripts for more information.Z	INSTALLERz
INSTALLER.piprcspip
ZRECORDz
RECORD.pip�rzw+)r�r�r�r�)F)NN)4rr{rNr3r4r7r�r�warnings�catch_warnings�filterwarnings�
compileall�compile_dirr��debug�getvaluer�r_r�rrror�r�ZvariantsZset_moder�r�r�r�rUrVr�extendr�Z
make_multipler��argsrr�r�r�rArlr��mover[�csv�readerr��writerr�Zwriterow)-rWr�rwr�r�r�Z	pycompileZschemer�r�Zwarn_script_locationr�r��stdoutr�Zep_filer�Zdatadirr�r�Zsubdirr�ZmakerZscripts_to_generateZ
pip_scriptZpip_epr�Zeasy_install_scriptZeasy_install_epZgui_scripts_to_generateZgenerated_console_scripts�er��msgZ	installerZtemp_installerZinstaller_file�recordZtemp_recordZ	record_inZ
record_outr	r�r
r�r:)
r�r�r�r�r�r�r�r�r�rwr;�move_wheel_filesMs��



$F
#��
����

��

�
��



�
"rcCsrzVdd�t�d|�D�d}|�d�}t��|�}|d��}ttt|�	d���}|WSt
k
rlYdSXdS)z�
    Return the Wheel-Version of an extracted wheel, if possible.

    Otherwise, return None if we couldn't parse / extract it.
    cSsg|]}|�qSr:r:)r��dr:r:r;r��sz!wheel_version.<locals>.<listcomp>Nrrqz
Wheel-Version�.)rZfind_on_pathZget_metadatarZparsestrr�r��map�intr^�	Exception)�
source_dirZdistZ
wheel_data�versionr:r:r;�
wheel_versions
rcCsb|std|��|dtdkr>td|d�tt|��f��n |tkr^t�dd�tt|���dS)a�
    Raises errors or warns if called with an incompatible Wheel-Version.

    Pip should refuse to install a Wheel-Version that's a major series
    ahead of what it's compatible with (e.g 2.0 > 1.1); and warn when
    installing a version only minor version ahead (e.g 1.2 > 1.1).

    version: a 2-tuple representing a Wheel-Version (Major, Minor)
    name: name of wheel or package to raise exception about

    :raises UnsupportedWheel: when an incompatible Wheel-Version is given
    z(%s is in an unsupported or invalid wheelrzB%s's Wheel-Version (%s) is not compatible with this version of piprz*Installing from a newer Wheel-Version (%s)N)r
�VERSION_COMPATIBLEr_rrOr�r�)rrWr:r:r;�check_compatibility�s����rcCs
d�|�S)z�
    Format three tags in the form "<python_tag>-<abi_tag>-<platform_tag>".

    :param file_tag: A 3-tuple of tags (python_tag, abi_tag, platform_tag).
    r\)r_)Zfile_tagr:r:r;�
format_tag�src@s>eZdZdZe�dej�Zdd�Zdd�Z	dd�Z
d	d
�ZdS)�WheelzA wheel filez�^(?P<namever>(?P<name>.+?)-(?P<ver>.*?))
        ((-(?P<build>\d[^-]*?))?-(?P<pyver>.+?)-(?P<abi>.+?)-(?P<plat>.+?)
        \.whl|\.dist-info)$cs��j�|�}|std|��|�_|�d��dd��_|�d��dd��_|�d��_|�d��	d��_
|�d	��	d��_|�d
��	d��_�fdd��j
D��_
d
S)zX
        :raises InvalidWheelFilename: when the filename is invalid for a wheel
        z!%s is not a valid wheel filename.rWrpr\Zver�buildZpyverrZabiZplatcs.h|]&}�jD]}�jD]}|||f�qqqSr:)�abis�plats)r�r��y�z�r�r:r;�	<setcomp>�s�z!Wheel.__init__.<locals>.<setcomp>N)�
wheel_file_rertrr�rur6rWrZ	build_tagr^Z
pyversionsrr�	file_tags)r�r�Z
wheel_infor:r!r;�__init__�s�
�zWheel.__init__cCstdd�|jD��S)zF
        Return the wheel's tags as a sorted list of strings.
        css|]}t|�VqdSr�)r�r��tagr:r:r;r��sz0Wheel.get_formatted_file_tags.<locals>.<genexpr>)r�r$r!r:r:r;�get_formatted_file_tags�szWheel.get_formatted_file_tagscst�fdd�|jD��S)a�
        Return the lowest index that one of the wheel's file_tag combinations
        achieves in the given list of supported tags.

        For example, if there are 8 supported tags and one of the file tags
        is first in the list, then return 0.

        :param tags: the PEP 425 tags to check the wheel against, in order
            with most preferred first.

        :raises ValueError: If none of the wheel's file tags match one of
            the supported tags.
        c3s |]}|�kr��|�VqdSr�)�indexr&��tagsr:r;r��sz*Wheel.support_index_min.<locals>.<genexpr>)�minr$�r�r+r:r*r;�support_index_min�szWheel.support_index_mincCs|j�|�S)z�
        Return whether the wheel is compatible with one of the given tags.

        :param tags: the PEP 425 tags to check the wheel against.
        )r$�
isdisjointr-r:r:r;�	supported�szWheel.supportedN)r�r�r��__doc__r��compile�VERBOSEr#r%r(r.r0r:r:r:r;r�s�rz([a-z0-9_.]+)-([a-z0-9_.!+-]+)cCst|�|��S)zjDetermine whether the string looks like an egg_info.

    :param s: The string to parse. E.g. foo-2.1
    )�bool�search)r~Z_egg_info_rer:r:r;�_contains_egg_infosr6cCs�|jr
dS|jr&|s"t�d|j�dS|s.dS|js:|js>dS||�sXt�d|j�dS|jrj|jjrjdS|j}|�	�\}}|r�t
|�r�dSdS)a[
    Return whether to build an InstallRequirement object using the
    ephemeral cache.

    :param cache_available: whether a cache directory is available for the
        should_unpack=True case.

    :return: True or False to build the requirement with ephem_cache=True
        or False, respectively; or None not to build the requirement.
    Nz(Skipping %s, due to already being wheel.FzCSkipping wheel build for %s, due to binaries being disabled for it.T)Z
constraint�is_wheelr��inforWZeditabler�linkZis_vcs�splitextr6)r��
should_unpack�cache_available�check_binary_allowedr9�baseZextr:r:r;�should_use_ephemeral_cache
s4��r?cCs^t|�}d�|�}|s |d7}n:t��tjkr8|d7}n"|�d�sJ|d7}|d�|t�7}|S)z1
    Format command information for logging.
    zCommand arguments: {}
zCommand output: Nonez'Command output: [use --verbose to show]r|zCommand output:
{}{})rr�r�ZgetEffectiveLevel�logging�DEBUGr�r)�command_args�command_outputZcommand_desc�textr:r:r;�format_command_resultGs



rEcCsxt|�}|s4d�|j�}|t||�7}t�|�dSt|�dkrfd�|j|�}|t||�7}t�|�tj�	||d�S)zH
    Return the path to the wheel in the temporary build directory.
    z1Legacy build of wheel for {!r} created no files.
Nr1zZLegacy build of wheel for {!r} created more than one file.
Filenames (choosing first): {}
r)
r�r�rWrEr�r�rBr3r4r_)�names�temp_dirr�rBrCr
r:r:r;�get_legacy_build_wheel_path^s$��
��
rHcCsdS)NTr:)rpr:r:r;�_always_true~srIc@s\eZdZdZddd�Zddd�Zddd	�Zd
d�Zddd
�Zddd�Z	dd�Z
ddd�ZdS)�WheelBuilderz#Build wheels from a RequirementSet.NFcCsD|dkrt}||_||_|j|_|p&g|_|p0g|_||_||_dSr�)	rI�preparer�wheel_cacheZwheel_download_dir�
_wheel_dir�
build_options�global_optionsr=�no_clean)r�rKrLrNrOr=rPr:r:r;r%�s


zWheelBuilder.__init__c
Cs.|j�|j|||d�W5QR�SQRXdS)ziBuild one wheel.

        :return: The filename of the built wheel, or None if the build failed.
        ��
python_tagN)Z	build_env�_build_one_inside_env)r�r��
output_dirrRr:r:r;�
_build_one�s�zWheelBuilder._build_onec
Cs�tdd���}|jr|j}n|j}|||j|d�}|dk	r�tj�|�}tj�||�}zNt|�\}	}
t	�
||�t�d|j
||
|	���t�d|�|WW5QR�Stk
r�YnX|�|�W5QR�dSQRXdS)Nry)ZkindrQz3Created wheel for %s: filename=%s size=%d sha256=%szStored in directory: %s)rZ
use_pep517�_build_one_pep517�_build_one_legacyr4r3r�r_rIr�rr�r8rWZ	hexdigestr�
_clean_one)r�r�rTrRrGZbuilder�
wheel_path�
wheel_nameZ	dest_pathZ
wheel_hashrFr:r:r;rS�s.�
z"WheelBuilder._build_one_inside_envcCst|j|jdd�S)NT)rOZunbuffered_output)rZ
setup_py_pathrO)r�r�r:r:r;�_base_setup_args�s
�zWheelBuilder._base_setup_argsc	Cs�|jdk	st�|jr*t�d|jf�dSz~t�d|�td�|j��}|j	}|�
|��|j||jd�}W5QRX|r�t||�}t
�t
j�||�t
j�||��|}Wn$tk
r�t�d|j�YdSXt
j�||�S)z�Build one InstallRequirement using the PEP 517 build process.

        Returns path to wheel if successfully built. Otherwise, returns None.
        NzGCannot build wheel for %s using PEP 517 when --build-options is present�Destination directory: %szBuilding wheel for {} (PEP 517))�metadata_directory�Failed building wheel for %s)r]r�rNr��errorrWrrr�Zpep517_backendZsubprocess_runnerZbuild_wheelrar3�renamer4r_r)r�r��tempdrRZrunnerZbackendrZ�new_namer:r:r;rV�s8�
��
�zWheelBuilder._build_one_pep517c
Cs�|�|�}d|jf}t|���}t�d|�|dd|g|j}|dk	rT|d|g7}zt||j|d�}Wn8tk
r�|�	d�t�
d	|j�YW5QR�dSXt�|�}	t
|	||||d
�}
|
W5QR�SQRXdS)z�Build one InstallRequirement using the "legacy" build process.

        Returns path to wheel if successfully built. Otherwise, returns None.
        z Building wheel for %s (setup.py)r\Zbdist_wheelz-dNz--python-tag)�cwd�spinnerr_r^)rFrGr�rBrC)r[rWrr�rrNrZunpacked_source_directoryrZfinishr_r3rrrH)r�r�rarR�	base_argsZspin_messagerdZ
wheel_args�outputrFrYr:r:r;rW�s8

��


�zWheelBuilder._build_one_legacycCsb|�|�}t�d|j�|ddg}zt||jd�WdStk
r\t�d|j�YdSXdS)NzRunning setup.py clean for %sZcleanz--all)rcTz Failed cleaning build dir for %sF)r[r�r8rWrrrr_)r�r�reZ
clean_argsr:r:r;rXs
zWheelBuilder._clean_onec
Cs|r
|jr|s|jst�g}t|jj�}|D]\}t||||jd�}|dkrLq,|rt|rd|j�|j�}qz|j�	|j�}n|j}|�
||f�q,|s�gSt�dd�
dd�|D���d}|r�tj}t���gg}	}
|D]�\}}zt|�WnFtk
�r.}z&t�d|j|�|
�
|�WY�q�W5d}~XYnX|j|||d�}|�r�|	�
|�|�r�|j�rrt|j��srtd	��|��|�|jj�|_tt|��|_|jj�s�t�t|jj |j�q�|
�
|�q�W5QRX|	�r�t�d
d�
dd�|	D���|
�rt�d
d�
dd�|
D���|
S)aBuild wheels.

        :param should_unpack: If True, after building the wheel, unpack it
            and replace the sdist with the unpacked version in preparation
            for installation.
        :return: True if all the wheels built correctly.
        )r;r<r=Nz*Building wheels for collected packages: %sr�cSsg|]\}}|j�qSr:�rW)r�r�rpr:r:r;r�\sz&WheelBuilder.build.<locals>.<listcomp>z Building wheel for %s failed: %srQzbad source dir - missing markerzSuccessfully built %sr}cSsg|]
}|j�qSr:rg�r�r�r:r:r;r��szFailed to build %scSsg|]
}|j�qSr:rgrhr:r:r;r��s)!rMr�r4rL�	cache_dirr?r=Zget_ephem_path_for_linkr9Zget_path_for_linkr�r�r8r_r
Zimplementation_tagrr�OSErrorr�rWrUrrZremove_temporary_sourceZensure_build_locationrKZ	build_dirrrr7rZ	file_path)
r�Zrequirementsr;Zbuildsetr<r�Zephem_cacherTrRZ
build_successZ
build_failurerZ
wheel_filer:r:r;r#s��������

�
�
������zWheelBuilder.build)NNNF)N)N)N)N)F)r�r�r�r1r%rUrSr[rVrWrXrr:r:r:r;rJ�s�




'
%�rJ)r=)r=)FNNTNFNT)r1Z
__future__rr�rrr@r@Zos.pathr3r�r�r�rUr��base64rZemail.parserrZpip._vendorrZpip._vendor.distlib.scriptsrZpip._vendor.distlib.utilrZpip._vendor.packaging.utilsrZpip._vendor.sixr	Z
pip._internalr
Zpip._internal.exceptionsrrr
Zpip._internal.locationsrrZpip._internal.models.linkrZpip._internal.utils.loggingrZ pip._internal.utils.marker_filesrZpip._internal.utils.miscrrrZ$pip._internal.utils.setuptools_buildrZpip._internal.utils.subprocessrrrrZpip._internal.utils.temp_dirrZpip._internal.utils.typingrZpip._internal.utils.uirZpip._internal.utils.unpackingrZpip._internal.utils.urlsr�typingr r!r"r#r$r%r&r'r(r)r*r+Z"pip._vendor.packaging.requirementsr,Zpip._internal.req.req_installr-Z pip._internal.operations.preparer.Zpip._internal.cacher/Zpip._internal.pep425tagsr0rOZInstalledCSVRowr4ZBinaryAllowedPredicaterZ	getLoggerr�r�r<rIrPr[raror2r3rsr{r�r�r�r�rr�r�r�rrrr�objectr�Ir6r?rErHrIrJr:r:r:r;�<module>s�8


	� =$
�
4
J�
	: site-packages/pip/_internal/__pycache__/collector.cpython-38.pyc000064400000033422151446176770020703 0ustar00U

��.eWF�@s dZddlZddlZddlZddlZddlZddlmZddlm	Z	m
Z
ddlmZddl
mZmZmZddlmZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZm Z ddl!m"Z"m#Z#e�rDddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5e/j6j7j8Z9e)e:e:fZ;e�<e=�Z>dd�Z?dd�Z@Gdd�deA�ZBdd�ZCGdd�deA�ZDdd�ZEdd �ZFd!d"�ZGd#d$�ZHd%d&�ZId'd(�ZJd)d*�ZKGd+d,�d,eL�ZMd<d-d.�ZNd/d0�ZOd=d1d2�ZPd3d4�ZQd>d6d7�ZRGd8d9�d9eL�ZSGd:d;�d;eL�ZTdS)?zM
The main purpose of this module is to expose LinkCollector.collect_links().
�N)�OrderedDict)�html5lib�requests)�unescape)�	HTTPError�
RetryError�SSLError)�parse)�request��Link)�ARCHIVE_EXTENSIONS)�redact_auth_from_url)�MYPY_CHECK_RUNNING)�path_to_url�url_to_path)�is_url�vcs)	�Callable�Dict�Iterable�List�MutableMapping�Optional�Sequence�Tuple�Union)�Response)�SearchScope)�
PipSessioncCs6tjD]*}|���|�r|t|�dkr|SqdS)zgLook for VCS schemes in the URL.

    Returns the matched VCS scheme, or None if there's no match.
    z+:N)rZschemes�lower�
startswith�len)�url�scheme�r%�;/usr/lib/python3.8/site-packages/pip/_internal/collector.py�_match_vcs_scheme/s

r'cCs(t|�j}tD]}|�|�rdSqdS)z2Return whether the URL looks like an archive.
    TF)r�filenamer
�endswith)r#r(Zbad_extr%r%r&�_is_url_like_archive;s


r*cseZdZ�fdd�Z�ZS)�_NotHTMLcs"tt|��||�||_||_dS�N)�superr+�__init__�content_type�request_desc)�selfr/r0��	__class__r%r&r.Gsz_NotHTML.__init__)�__name__�
__module__�__qualname__r.�
__classcell__r%r%r2r&r+Fsr+cCs.|j�dd�}|���d�s*t||jj��dS)z�Check the Content-Type header to ensure the response contains HTML.

    Raises `_NotHTML` if the content type is not text/html.
    �Content-Type��	text/htmlN)�headers�getr r!r+r
�method)�responser/r%r%r&�_ensure_html_headerNsr?c@seZdZdS)�_NotHTTPN)r4r5r6r%r%r%r&r@Ysr@cCsDt�|�\}}}}}|dkr"t��|j|dd�}|��t|�dS)z�Send a HEAD request to the URL, and ensure the response contains HTML.

    Raises `_NotHTTP` if the URL is not available for a HEAD request, or
    `_NotHTML` if the content type is not text/html.
    >�http�httpsT)Zallow_redirectsN)�urllib_parseZurlsplitr@�head�raise_for_statusr?)r#�sessionr$�netloc�pathZqueryZfragment�respr%r%r&�_ensure_html_response]srJcCsLt|�rt||d�t�dt|��|j|ddd�d�}|��t|�|S)aAccess an HTML page with GET, and return the response.

    This consists of three parts:

    1. If the URL looks suspiciously like an archive, send a HEAD first to
       check the Content-Type is HTML, to avoid downloading a large file.
       Raise `_NotHTTP` if the content type cannot be determined, or
       `_NotHTML` if it is not HTML.
    2. Actually perform the request. Raise HTTP exceptions on network failures.
    3. Check the Content-Type header to make sure we got HTML, and raise
       `_NotHTML` otherwise.
    �rFzGetting page %sr:z	max-age=0)ZAcceptz
Cache-Control)r;)r*rJ�logger�debugrr<rEr?)r#rFrIr%r%r&�_get_html_responsens��rNcCs2|r.d|kr.t�|d�\}}d|kr.|dSdS)zBDetermine if we have any encoding information in our headers.
    r8�charsetN)�cgiZparse_header)r;r/Zparamsr%r%r&�_get_encoding_from_headers�s
rQcCs.|�d�D]}|�d�}|dk	r
|Sq
|S)a�Determine the HTML document's base URL.

    This looks for a ``<base>`` tag in the HTML document. If present, its href
    attribute denotes the base URL of anchor tags in the document. If there is
    no such tag (or if it does not have a valid href attribute), the HTML
    file's URL is used as the base URL.

    :param document: An HTML document representation. The current
        implementation expects the result of ``html5lib.parse()``.
    :param page_url: The URL of the HTML document.
    z.//base�hrefN)�findallr<)�document�page_url�baserRr%r%r&�_determine_base_url�s



rWcCsPt�|�}|jdkr(t�t�|j��}ntjt�|j�dd�}t�	|j
|d��S)z�Makes sure a link is fully encoded.  That is, if a ' ' shows up in
    the link, it will be rewritten to %20 (while not over-quoting
    % or other characters).r9z/@)Zsafe)rH)rC�urlparserG�urllib_requestZpathname2url�url2pathnamerHZquoteZunquoteZ
urlunparse�_replace)r#�resultrHr%r%r&�_clean_link�s	


�r]cCsf|�d�}|sdStt�||��}|�d�}|r8t|�nd}|�d�}|rRt|�}t||||d�}|S)zJ
    Convert an anchor element in a simple repository page to a Link.
    rRNzdata-requires-pythonzdata-yanked)Z
comes_fromZrequires_python�
yanked_reason)r<r]rC�urljoinrr)�anchorrU�base_urlrRr#Z	pyrequirer^�linkr%r%r&�_create_link_from_element�s 	


�rcccsVtj|j|jdd�}|j}t||�}|�d�D]"}t|||d�}|dkrJq.|Vq.dS)zP
    Parse an HTML document, and yield its anchor elements as Link objects.
    F)Ztransport_encodingZnamespaceHTMLElementsz.//a)rUraN)rr	�content�encodingr#rWrSrc)�pagerTr#rar`rbr%r%r&�parse_links�s �
�rgc@s eZdZdZdd�Zdd�ZdS)�HTMLPagez'Represents one page, along with its URLcCs||_||_||_dS)z�
        :param encoding: the encoding to decode the given content.
        :param url: the URL from which the HTML was downloaded.
        N)rdrer#)r1rdrer#r%r%r&r.szHTMLPage.__init__cCs
t|j�Sr,)rr#�r1r%r%r&�__str__$szHTMLPage.__str__N)r4r5r6�__doc__r.rjr%r%r%r&rhsrhcCs|dkrtj}|d||�dS)Nz%Could not fetch URL %s: %s - skipping)rLrM)rb�reason�methr%r%r&�_handle_get_page_fail(srncCst|j�}t|j||jd�S)N)rer#)rQr;rhrdr#)r>rer%r%r&�_make_html_page3s
roc

Cs�|dkrtd��|j�dd�d}t|�}|r@t�d||�dSt�|�\}}}}}}|dkr�tj	�
t�|��r�|�
d�s�|d7}t�|d�}t�d	|�zt||d
�}W�nDtk
r�t�d|�Y�n,tk
�r}zt�d||j|j�W5d}~XYn�tk
�r0}zt||�W5d}~XYn�tk
�r\}zt||�W5d}~XYn�tk
�r�}z$d
}	|	t|�7}	t||	tjd�W5d}~XYn\tjk
�r�}zt|d|�W5d}~XYn*tjk
�r�t|d�Yn
Xt|�SdS)Nz?_get_html_page() missing 1 required keyword argument: 'session'�#�rzCannot look at %s URL %s�file�/z
index.htmlz# file: URL is directory, getting %srKzQSkipping page %s because it looks like an archive, and cannot be checked by HEAD.z<Skipping page %s because the %s request got Content-Type: %sz4There was a problem confirming the ssl certificate: )rmzconnection error: %sz	timed out)�	TypeErrorr#�splitr'rLrMrCrX�osrH�isdirrYrZr)r_rNr@r+r0r/rrnrr�str�infor�ConnectionErrorZTimeoutro)
rbrFr#Z
vcs_schemer$�_rHrI�excrlr%r%r&�_get_html_page9sV�
�
� r}cCstt�|��S)zQ
    Return a list of links, with duplicates removed and ordering preserved.
    )�listr�fromkeys)Zlinksr%r%r&�_remove_duplicate_linksosr�Fcs�g�g���fdd�}|D]�}tj�|�}|�d�}|s<|r�|rF|}nt|�}tj�|�r�|r�tj�|�}t�|�D]}|tj�||��qtq�|r���	|�q�t
�d�|��q�tj�
|�r�||�q�t
�d|�qt|�r��	|�qt
�d|�q��fS)z�
    Divide a list of locations into two groups: "files" (archives) and "urls."

    :return: A pair of lists (files, urls).
    cs8t|�}tj|dd�ddkr*��|�n
��|�dS)NF)�strictrr:)r�	mimetypesZ
guess_type�append)rHr#��filesZurlsr%r&�	sort_path�sz"group_locations.<locals>.sort_pathzfile:z)Path '{0}' is ignored: it is a directory.z:Url '%s' is ignored: it is neither a file nor a directory.zQUrl '%s' is ignored. It is either a non-existing path or lacks a specific scheme.)rvrH�existsr!rrw�realpath�listdir�joinr�rLZwarning�format�isfiler)�	locations�
expand_dirr�r#Z
is_local_pathZis_file_urlrH�itemr%r�r&�group_locationsxsF
��
��r�c@seZdZdZdd�ZdS)�CollectedLinksa
    Encapsulates all the Link objects collected by a call to
    LinkCollector.collect_links(), stored separately as--

    (1) links from the configured file locations,
    (2) links from the configured find_links, and
    (3) a dict mapping HTML page url to links from that page.
    cCs||_||_||_dS)z�
        :param files: Links from file locations.
        :param find_links: Links from find_links.
        :param pages: A dict mapping HTML page url to links from that page.
        N�r��
find_links�pages)r1r�r�r�r%r%r&r.�szCollectedLinks.__init__N)r4r5r6rkr.r%r%r%r&r��s	r�c@s4eZdZdZdd�Zedd��Zdd�Zdd	�Zd
S)�
LinkCollectorz�
    Responsible for collecting Link objects from all configured locations,
    making network requests as needed.

    The class's main method is its collect_links() method.
    cCs||_||_dSr,)�search_scoperF)r1rFr�r%r%r&r.�szLinkCollector.__init__cCs|jjSr,)r�r�rir%r%r&r��szLinkCollector.find_linksccs,|D]"}t||jd�}|dkr q|VqdS)zp
        Yields (page, page_url) from the given locations, skipping
        locations that have errors.
        rKN)r}rF)r1r��locationrfr%r%r&�
_get_pages�s
zLinkCollector._get_pagescs��j}|�|�}t|�\}}t�jdd�\}}dd�t�||�D�}dd��jD�}	�fdd�t�dd�|D�d	d�|D��D�}
t|
�}
d
�t|
�|�g}|
D]}|�	d�|��q�t
�d�|��i}
��
|
�D]}tt|��|
|j<q�t||	|
d
�S)z�Find all available links for the given project name.

        :return: All the Link objects (unfiltered), as a CollectedLinks object.
        T)r�cSsg|]}t|��qSr%r��.0r#r%r%r&�
<listcomp>sz/LinkCollector.collect_links.<locals>.<listcomp>cSsg|]}t|d��qS)z-frr�r%r%r&r�scsg|]}�j�|�r|�qSr%)rFZis_secure_origin)r�rbrir%r&r�
s�css|]}t|�VqdSr,rr�r%r%r&�	<genexpr>sz.LinkCollector.collect_links.<locals>.<genexpr>css|]}t|�VqdSr,rr�r%r%r&r�
sz,{} location(s) to search for versions of {}:z* {}�
r�)r�Zget_index_urls_locationsr�r��	itertools�chainr�r�r"r�rLrMr�r�r~rgr#r�)r1Zproject_namer�Zindex_locationsZindex_file_locZ
index_url_locZfl_file_locZ
fl_url_locZ
file_linksZfind_link_linksZ
url_locations�linesrbZpages_linksrfr%rir&�
collect_links�sD
�

�
�����zLinkCollector.collect_linksN)	r4r5r6rkr.�propertyr�r�r�r%r%r%r&r��s	

r�)N)N)F)UrkrPr�Zloggingr�rv�collectionsrZpip._vendorrrZpip._vendor.distlib.compatrZpip._vendor.requests.exceptionsrrrZpip._vendor.six.moves.urllibr	rCr
rYZpip._internal.models.linkrZpip._internal.utils.filetypesr
Zpip._internal.utils.miscrZpip._internal.utils.typingrZpip._internal.utils.urlsrrZpip._internal.vcsrr�typingrrrrrrrrrZxml.etree.ElementTreeZxmlZpip._vendor.requestsrZ!pip._internal.models.search_scoperZpip._internal.network.sessionrZetreeZElementTreeZElementZHTMLElementrxZResponseHeadersZ	getLoggerr4rLr'r*�	Exceptionr+r?r@rJrNrQrWr]rcrg�objectrhrnror}r�r�r�r�r%r%r%r&�<module>s^,

3 �

6	
;site-packages/pip/_internal/__pycache__/exceptions.cpython-38.opt-1.pyc000064400000030242151446176770022032 0ustar00U

��.e(�@s�dZddlmZddlmZmZmZddlmZddl	m
Z
e
rdddlmZddl
mZddlmZGd	d
�d
e�ZGdd�de�ZGd
d�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd �d e�ZGd!d"�d"e�ZGd#d$�d$e�ZGd%d&�d&e�Z Gd'd(�d(e �Z!Gd)d*�d*e �Z"Gd+d,�d,e �Z#Gd-d.�d.e �Z$Gd/d0�d0e �Z%Gd1d2�d2e�Z&Gd3d4�d4e�Z'd5S)6z"Exceptions used throughout package�)�absolute_import)�chain�groupby�repeat)�	iteritems)�MYPY_CHECK_RUNNING)�Optional)�Distribution)�InstallRequirementc@seZdZdZdS)�PipErrorzBase pip exceptionN��__name__�
__module__�__qualname__�__doc__�rr�</usr/lib/python3.8/site-packages/pip/_internal/exceptions.pyrsrc@seZdZdZdS)�ConfigurationErrorz"General exception in configurationNrrrrrrsrc@seZdZdZdS)�InstallationErrorz%General exception during installationNrrrrrrsrc@seZdZdZdS)�UninstallationErrorz'General exception during uninstallationNrrrrrr src@s eZdZdZdd�Zdd�ZdS)�NoneMetadataErrora
    Raised when accessing "METADATA" or "PKG-INFO" metadata for a
    pip._vendor.pkg_resources.Distribution object and
    `dist.has_metadata('METADATA')` returns True but
    `dist.get_metadata('METADATA')` returns None (and similarly for
    "PKG-INFO").
    cCs||_||_dS)z�
        :param dist: A Distribution object.
        :param metadata_name: The name of the metadata being accessed
            (can be "METADATA" or "PKG-INFO").
        N)�dist�
metadata_name)�selfrrrrr�__init__-szNoneMetadataError.__init__cCsd�|j|j�S)Nz+None {} metadata found for distribution: {})�formatrr�rrrr�__str__7s
��zNoneMetadataError.__str__N)r
rrrrrrrrrr$s
rc@seZdZdZdS)�DistributionNotFoundzCRaised when a distribution cannot be found to satisfy a requirementNrrrrrrBsrc@seZdZdZdS)�RequirementsFileParseErrorzDRaised when a general error occurs parsing a requirements file line.NrrrrrrFsrc@seZdZdZdS)�BestVersionAlreadyInstalledzNRaised when the most up-to-date version of a package is already
    installed.Nrrrrrr Jsr c@seZdZdZdS)�
BadCommandz0Raised when virtualenv or a command is not foundNrrrrrr!Osr!c@seZdZdZdS)�CommandErrorz7Raised when there is an error in command-line argumentsNrrrrrr"Ssr"c@seZdZdZdS)�PreviousBuildDirErrorz:Raised when there's a previous conflicting build directoryNrrrrrr#Wsr#c@seZdZdZdS)�InvalidWheelFilenamezInvalid wheel filename.Nrrrrrr$[sr$c@seZdZdZdS)�UnsupportedWheelzUnsupported wheel.Nrrrrrr%_sr%c@s8eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
�
HashErrorsz:Multiple HashError instances rolled into one for reportingcCs
g|_dS�N)�errorsrrrrrfszHashErrors.__init__cCs|j�|�dSr')r(�append)r�errorrrrr)iszHashErrors.appendcCsbg}|jjdd�d�t|jdd��D](\}}|�|j�|�dd�|D��q&|r^d�|�SdS)NcSs|jSr')�order��errr�<lambda>n�z$HashErrors.__str__.<locals>.<lambda>)�keycSs|jSr'��	__class__r,rrrr.or/css|]}|��VqdSr')�body��.0r-rrr�	<genexpr>qsz%HashErrors.__str__.<locals>.<genexpr>�
)r(�sortrr)�head�extend�join)r�lines�clsZ
errors_of_clsrrrrlszHashErrors.__str__cCs
t|j�Sr')�boolr(rrrr�__nonzero__uszHashErrors.__nonzero__cCs|��Sr')r?rrrr�__bool__xszHashErrors.__bool__N)	r
rrrrr)rr?r@rrrrr&cs	r&c@s0eZdZdZdZdZdd�Zdd�Zdd	�ZdS)
�	HashErrora�
    A failure to verify a package against known-good hashes

    :cvar order: An int sorting hash exception classes by difficulty of
        recovery (lower being harder), so the user doesn't bother fretting
        about unpinned packages when he has deeper issues, like VCS
        dependencies, to deal with. Also keeps error reports in a
        deterministic order.
    :cvar head: A section heading for display above potentially many
        exceptions of this kind
    :ivar req: The InstallRequirement that triggered this error. This is
        pasted on after the exception is instantiated, because it's not
        typically available earlier.

    N�cCsd|��S)a)Return a summary of me for display under the heading.

        This default implementation simply prints a description of the
        triggering requirement.

        :param req: The InstallRequirement that provoked this error, with
            populate_link() having already been called

        z    %s)�_requirement_namerrrrr3�s
zHashError.bodycCsd|j|��fS)Nz%s
%s)r9r3rrrrr�szHashError.__str__cCs|jrt|j�SdS)z�Return a description of the requirement that triggered me.

        This default implementation returns long description of the req, with
        line numbers

        �unknown package)�req�strrrrrrC�szHashError._requirement_name)	r
rrrrEr9r3rrCrrrrrA|srAc@seZdZdZdZdZdS)�VcsHashUnsupported�uA hash was provided for a version-control-system-based requirement, but
    we don't have a method for hashing those.rzlCan't verify hashes for these requirements because we don't have a way to hash version control repositories:N�r
rrrr+r9rrrrrG�srGc@seZdZdZdZdZdS)�DirectoryUrlHashUnsupportedrH�zUCan't verify hashes for these file:// requirements because they point to directories:NrIrrrrrJ�srJc@s(eZdZdZdZdZdd�Zdd�ZdS)	�HashMissingz2A hash was needed for a requirement but is absent.�awHashes are required in --require-hashes mode, but they are missing from some requirements. Here is a list of those requirements along with the hashes their downloaded archives actually had. Add lines like these to your requirements files to prevent tampering. (If you did not enable --require-hashes manually, note that it turns on automatically when any package has a hash.)cCs
||_dS)zq
        :param gotten_hash: The hash of the (possibly malicious) archive we
            just downloaded
        N)�gotten_hash)rrNrrrr�szHashMissing.__init__cCsHddlm}d}|jr4|jjr&|jjnt|jdd�}d|p<d||jfS)Nr)�
FAVORITE_HASHrEz    %s --hash=%s:%srD)Zpip._internal.utils.hashesrOrEZ
original_link�getattrrN)rrO�packagerrrr3�s��zHashMissing.bodyN)r
rrrr+r9rr3rrrrrL�s
rLc@seZdZdZdZdZdS)�HashUnpinnedzPA requirement had a hash specified but was not pinned to a specific
    version.�zaIn --require-hashes mode, all requirements must have their versions pinned with ==. These do not:NrIrrrrrR�srRc@s0eZdZdZdZdZdd�Zdd�Zdd	�Zd
S)�HashMismatchz�
    Distribution file hash values don't match.

    :ivar package_name: The name of the package that triggered the hash
        mismatch. Feel free to write to this after the exception is raise to
        improve its error message.

    �z�THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. If you have updated the package versions, please update the hashes. Otherwise, examine the package contents carefully; someone may have tampered with them.cCs||_||_dS)z�
        :param allowed: A dict of algorithm names pointing to lists of allowed
            hex digests
        :param gots: A dict of algorithm names pointing to hashes we
            actually got from the files under suspicion
        N)�allowed�gots)rrVrWrrrr�szHashMismatch.__init__cCsd|��|��fS)Nz
    %s:
%s)rC�_hash_comparisonrrrrr3s�zHashMismatch.bodycsbdd�}g}t|j�D]@\}}||��|��fdd�|D��|�d|j|���qd�|�S)aE
        Return a comparison of actual and expected hash values.

        Example::

               Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde
                            or 123451234512345123451234512345123451234512345
                    Got        bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef

        cSst|gtd��S)Nz    or)rr)�	hash_namerrr�hash_then_orsz3HashMismatch._hash_comparison.<locals>.hash_then_orc3s|]}dt��|fVqdS)z        Expected %s %sN)�nextr4��prefixrrr6s�z0HashMismatch._hash_comparison.<locals>.<genexpr>z             Got        %s
r7)rrVr:r)rWZ	hexdigestr;)rrZr<rYZ	expectedsrr\rrXs��zHashMismatch._hash_comparisonN)	r
rrrr+r9rr3rXrrrrrT�s
rTc@seZdZdZdS)�UnsupportedPythonVersionzMUnsupported python version according to Requires-Python package
    metadata.Nrrrrrr^sr^cs*eZdZdZd�fdd�	Zdd�Z�ZS)	�!ConfigurationFileCouldNotBeLoadedz=When there are errors while loading a configuration file
    �could not be loadedNcs&tt|��|�||_||_||_dSr')�superr_r�reason�fnamer*)rrbrcr*r1rrr(sz*ConfigurationFileCouldNotBeLoaded.__init__cCs4|jdk	rd�|j�}nd�|jj�}d�|j|�S)Nz in {}.z.
{}
zConfiguration file {}{})rcrr*�messagerb)rZmessage_partrrrr.s
z)ConfigurationFileCouldNotBeLoaded.__str__)r`NN)r
rrrrr�
__classcell__rrr1rr_$sr_N)(rZ
__future__r�	itertoolsrrrZpip._vendor.sixrZpip._internal.utils.typingr�typingrZpip._vendor.pkg_resourcesr	Zpip._internal.req.req_installr
�	Exceptionrrrrrrrr r!r"r#r$r%r&rArGrJrLrRrTr^r_rrrr�<module>s<,		%	7site-packages/pip/_internal/__pycache__/main.cpython-38.pyc000064400000002371151446176770017640 0ustar00U

��.eO�@s�dZddlmZddlZddlZddlZddlZddlmZddl	m
Z
ddlmZddl
mZddlmZe�e�Zdd	d
�ZdS)z Primary application entrypoint.
�)�absolute_importN)�autocomplete)�
parse_command)�create_command)�PipError)�deprecationc
Cs�|dkrtjdd�}t��t�zt|�\}}WnJtk
r~}z,tj�d|�tj�t	j
�t�d�W5d}~XYnXzt�
tjd�Wn0tjk
r�}zt�d|�W5d}~XYnXt|d|kd�}|�|�S)N�z	ERROR: %s�z%Ignoring error %s when setting localez
--isolated)�isolated)�sys�argvrZinstall_warning_loggerrrr�stderr�write�os�linesep�exit�locale�	setlocale�LC_ALL�Error�logger�debugr�main)�argsZcmd_nameZcmd_args�exc�eZcommand�r�6/usr/lib/python3.8/site-packages/pip/_internal/main.pyrs r)N)�__doc__Z
__future__rrZloggingrrZ pip._internal.cli.autocompletionrZpip._internal.cli.main_parserrZpip._internal.commandsrZpip._internal.exceptionsrZpip._internal.utilsrZ	getLogger�__name__rrrrrr�<module>s
site-packages/pip/_internal/__pycache__/self_outdated_check.cpython-38.opt-1.pyc000064400000012622151446176770023632 0ustar00U

��.e��@s^ddlmZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZ
ddlmZddlmZddlmZddlmZdd	lmZdd
lmZddlmZmZmZddlmZm Z m!Z!dd
l"m#Z#ddl$m%Z%e%�rddl&Z&ddl&m'Z'ddl(m)Z)m*Z*m+Z+m,Z,ddl-m.Z.dZ/e�0e1�Z2ddd�Z3dd�Z4Gdd�de5�Z6dd�Z7dd�Z8dS)�)�absolute_importN)�
pkg_resources)�version)�
ensure_binary)�
LinkCollector)�
PackageFinder)�SearchScope)�SelectionPreferences)�WINDOWS)�adjacent_tmp_file�check_path_owner�replace)�
ensure_dir�get_installed_version�redact_auth_from_url)�
get_installer)�MYPY_CHECK_RUNNING)�Values)�Any�Dict�Text�Union)�
PipSessionz%Y-%m-%dT%H:%M:%SZFcCs`|jg|j}|jr8|s8t�dd�dd�|D���g}|jp@g}tj||d�}t	||d�}|S)z�
    :param session: The Session to use to make requests.
    :param suppress_no_index: Whether to ignore the --no-index option
        when constructing the SearchScope object.
    zIgnoring indexes: %s�,css|]}t|�VqdS�N)r)�.0Zurl�r�E/usr/lib/python3.8/site-packages/pip/_internal/self_outdated_check.py�	<genexpr>@sz&make_link_collector.<locals>.<genexpr>)�
find_links�
index_urls)�session�search_scope)
Z	index_urlZextra_index_urlsZno_index�logger�debug�joinrr�creater)r!�options�suppress_no_indexr rr"�link_collectorrrr�make_link_collector1s
�
�r*cCst|�}t�|���}|Sr)r�hashlibZsha224Z	hexdigest)�keyZ	key_bytes�namerrr�_get_statefile_namePsr.c@s(eZdZdd�Zedd��Zdd�ZdS)�SelfCheckStatec
Csni|_d|_|rjtj�|dt|j��|_z&t|j��}t�	|�|_W5QRXWnt
ttfk
rhYnXdS)NZ	selfcheck)
�state�statefile_path�os�pathr%r.r,�open�json�load�IOError�
ValueError�KeyError)�self�	cache_dirZ	statefilerrr�__init__Xs�zSelfCheckState.__init__cCstjSr)�sys�prefix)r:rrrr,jszSelfCheckState.keyc	Cs�|js
dSttj�|j��s dSttj�|j��|j|�t�|d�}t	j
|ddd�}t|j��}|�t
|��W5QRXzt|j|j�Wntk
r�YnXdS)N)r,�
last_check�pypi_versionT)r�:)Z	sort_keysZ
separators)r1rr2r3�dirnamerr,�strftime�SELFCHECK_DATE_FMTr5�dumpsr�writerr
r-�OSError)r:r@�current_timer0�text�frrr�savens �zSelfCheckState.saveN)�__name__�
__module__�__qualname__r<�propertyr,rKrrrrr/Ws
r/cCs6zt�|�}dt|�kWStjk
r0YdSXdS)z�Checks whether pkg was installed by pip

    This is used not to display the upgrade message when pip is in fact
    installed by system package manager, such as dnf on Fedora.
    �pipFN)rZget_distributionrZDistributionNotFound)ZpkgZdistrrr�was_installed_by_pip�s

rQcCsXtd�}|sdSt�|�}d}�zt|jd�}tj��}d|jkrzd|jkrztj�|jdt	�}||�
�dkrz|jd}|dkr�t||dd�}td	d	d
�}	t
j||	d�}
|
�d�j}|dkr�WdSt|j�}|�||�t�|�}||ko�|j|jko�td�}
|
�sWdSt�rd}nd}t�d
|||�Wn$tk
�rRtjddd�YnXdS)z�Check for an update for pip.

    Limit the frequency of checks to once per week. State is stored either in
    the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix
    of the pip script path.
    rPN)r;r?r@i�:	T)r'r(F)Zallow_yankedZallow_all_prereleases)r)�selection_prefsz
python -m pipz�You are using pip version %s; however, version %s is available.
You should consider upgrading via the '%s install --upgrade pip' command.z5There was an error checking the latest version of pip)�exc_info)r�packaging_version�parser/r;�datetimeZutcnowr0�strptimerDZ
total_secondsr*r	rr&Zfind_best_candidate�best_candidate�strrrKZbase_versionrQr
r#Zwarning�	Exceptionr$)r!r'Zinstalled_versionZpip_versionr@r0rHr?r)rR�finderrXZremote_versionZlocal_version_is_olderZpip_cmdrrr�pip_self_version_check�sp

�
���


����r\)F)9Z
__future__rrVr+r5ZloggingZos.pathr2r=Zpip._vendorrZpip._vendor.packagingrrTZpip._vendor.sixrZpip._internal.collectorrZpip._internal.indexrZ!pip._internal.models.search_scoperZ$pip._internal.models.selection_prefsr	Zpip._internal.utils.compatr
Zpip._internal.utils.filesystemrrr
Zpip._internal.utils.miscrrrZpip._internal.utils.packagingrZpip._internal.utils.typingrZoptparser�typingrrrrZpip._internal.network.sessionrrDZ	getLoggerrLr#r*r.�objectr/rQr\rrrr�<module>s>
�
;site-packages/pip/_internal/__pycache__/__init__.cpython-38.pyc000064400000000320151446176770020443 0ustar00U

��.eP�@sddlZdS)�N)Z*pip._internal.utils.inject_securetransportZpip�rr�:/usr/lib/python3.8/site-packages/pip/_internal/__init__.py�<module>�site-packages/pip/_internal/__pycache__/build_env.cpython-38.pyc000064400000016454151446176770020672 0ustar00U

��.e]�@sdZddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZm
Z
mZddlmZddlmZdd	lmZdd
lmZddlmZer�ddlmZmZmZmZmZdd
l m!Z!e�"e#�Z$Gdd�d�Z%Gdd�de&�Z'Gdd�de'�Z(dS)z;Build Environment used for isolation during sdist building
�N)�OrderedDict)�get_python_lib)�	get_paths)�Requirement�VersionConflict�
WorkingSet)�__file__)�call_subprocess)�
TempDirectory)�MYPY_CHECK_RUNNING)�open_spinner)�Tuple�Set�Iterable�Optional�List)�
PackageFinderc@seZdZdd�ZdS)�_PrefixcCsj||_d|_ttjdkrdnd||d�d�d|_td|d�}td|d�}||kr\|g|_n
||g|_dS)	NF�ntZposix_prefix)�baseZplatbase)�varsZscripts)�
plat_specific�prefixT)�path�setupr�os�name�bin_dirr�lib_dirs)�selfrZpurelibZplatlib�r �;/usr/lib/python3.8/site-packages/pip/_internal/build_env.py�__init__!s��
z_Prefix.__init__N)�__name__�
__module__�__qualname__r"r r r r!rsrc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)�BuildEnvironmentzFCreates and manages an isolated environment to install build deps
    c	s�tdd��_t�fdd�dD���_g�_g�_tt�j����D] }�j�	|j
��j�|j�qBdd�t
dd	�t
d
d	�fD�}tj��jjd��_tj��j�s�t��j�ttj��jd�d
��"}|�t�d�j|�jd��W5QRXdS)Nz	build-env)Zkindc3s(|] }|ttj��jj|��fVqdS�N)rrr�join�	_temp_dir��.0r�rr r!�	<genexpr>;s�z,BuildEnvironment.__init__.<locals>.<genexpr>)ZnormalZoverlaycSsh|]}tj�|��qSr )rr�normcase)r+�siter r r!�	<setcomp>Isz,BuildEnvironment.__init__.<locals>.<setcomp>F)rTr/zsitecustomize.py�wa�
                import os, site, sys

                # First, drop system-sites related paths.
                original_sys_path = sys.path[:]
                known_paths = set()
                for path in {system_sites!r}:
                    site.addsitedir(path, known_paths=known_paths)
                system_paths = set(
                    os.path.normcase(path)
                    for path in sys.path[len(original_sys_path):]
                )
                original_sys_path = [
                    path for path in original_sys_path
                    if os.path.normcase(path) not in system_paths
                ]
                sys.path = original_sys_path

                # Second, add lib directories.
                # ensuring .pth file are processed.
                for path in {lib_dirs!r}:
                    assert not path in sys.path
                    site.addsitedir(path)
                )�system_sitesr)r
r)r�	_prefixes�	_bin_dirs�	_lib_dirs�reversed�list�values�appendr�extendrrrrr(�	_site_dir�exists�mkdir�open�write�textwrap�dedent�format)rrr2�fpr r,r!r"7s0�
����zBuildEnvironment.__init__cCsndd�dD�|_|jdd�}|jd}|r>|�|�tj��|jg}tj�tj�	|�dtj�	|�d��dS)NcSsi|]}|tj�|d��qSr')r�environ�getr*r r r!�
<dictcomp>os�z.BuildEnvironment.__enter__.<locals>.<dictcomp>)�PATHZPYTHONNOUSERSITEZ
PYTHONPATHrG�1)
�	_save_envr4r:�splitr�pathsepr;rD�updater()rrZold_pathZ
pythonpathr r r!�	__enter__ns�


�zBuildEnvironment.__enter__cCs:|j��D]*\}}|dkr*tj�|d�q
|tj|<q
dSr')rI�itemsrrD�pop)r�exc_type�exc_val�exc_tbZvarname�	old_valuer r r!�__exit__�szBuildEnvironment.__exit__cCs|j��dSr')r)�cleanupr,r r r!rU�szBuildEnvironment.cleanupcCs�t�}t�}|r�t|j�}|D]p}z"|�t�|��dkrB|�|�Wqtk
r�}z*|�t|j	d�
��t|j	d�f�W5d}~XYqXq||fS)z�Return 2 sets:
            - conflicting requirements: set of (installed, wanted) reqs tuples
            - missing requirements: set of reqs
        Nr�)�setrr5�findr�parse�addr�str�argsZas_requirement)rZreqsZmissingZconflictingZwsZreq�er r r!�check_requirements�s
�z#BuildEnvironment.check_requirementsc	Csb|j|}|jrt�d|_|s"dStjtj�t�dddd|jdg}t	�
�tjkrZ|�
d�dD]:}t|j|�}|�d	|�d
d�d�t|p�d
h��f�q^|j}	|	r�|�d|	dg�|	dd�D]}
|�d|
g�q�n
|�
d�|jD]}|�d|g�q�|jD]}|�d|g��q|j�r*|�
d�|�
d	�|�|�t|��}
t||
d�W5QRXdS)NTZinstallz--ignore-installedz	--no-userz--prefixz--no-warn-script-locationz-v)Z	no_binaryZonly_binaryz--�_�-�,z:none:z-irrVz--extra-index-urlz
--no-indexz--find-linksz--trusted-hostz--pre)�spinner)r3r�AssertionError�sys�
executablerr�dirname�pip_location�loggerZgetEffectiveLevel�logging�DEBUGr9�getattr�format_controlr:�replacer(�sorted�
index_urlsZ
find_linksZ
trusted_hostsZallow_all_prereleasesrr	)r�finder�requirementsZprefix_as_string�messagerr\rlZformatsroZextra_index�linkZhostrbr r r!�install_requirements�sJ


�
�






z%BuildEnvironment.install_requirementsN)
r#r$r%�__doc__r"rMrTrUr^rtr r r r!r&3s7r&c@s8eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
�NoOpBuildEnvironmentz5A no-op drop-in replacement for BuildEnvironment
    cCsdSr'r r,r r r!r"�szNoOpBuildEnvironment.__init__cCsdSr'r r,r r r!rM�szNoOpBuildEnvironment.__enter__cCsdSr'r )rrPrQrRr r r!rT�szNoOpBuildEnvironment.__exit__cCsdSr'r r,r r r!rU�szNoOpBuildEnvironment.cleanupcCs
t��dSr')�NotImplementedError)rrprqrrrr r r!rt�sz)NoOpBuildEnvironment.install_requirementsN)	r#r$r%rur"rMrTrUrtr r r r!rv�srv))rurirrdr@�collectionsrZdistutils.sysconfigrZ	sysconfigrZpip._vendor.pkg_resourcesrrrZpiprrgZpip._internal.utils.subprocessr	Zpip._internal.utils.temp_dirr
Zpip._internal.utils.typingrZpip._internal.utils.uir�typingr
rrrrZpip._internal.indexrZ	getLoggerr#rhr�objectr&rvr r r r!�<module>s*
site-packages/pip/_internal/__init__.py000064400000000120151446176770014153 0ustar00#!/usr/bin/env python
import pip._internal.utils.inject_securetransport  # noqa
site-packages/pip/_internal/cache.py000064400000020263151446176770013471 0ustar00"""Cache Management
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

import errno
import hashlib
import logging
import os

from pip._vendor.packaging.utils import canonicalize_name

from pip._internal.models.link import Link
from pip._internal.utils.compat import expanduser
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import path_to_url
from pip._internal.wheel import InvalidWheelFilename, Wheel

if MYPY_CHECK_RUNNING:
    from typing import Optional, Set, List, Any
    from pip._internal.index import FormatControl
    from pip._internal.pep425tags import Pep425Tag

logger = logging.getLogger(__name__)


class Cache(object):
    """An abstract class - provides cache directories for data from links


        :param cache_dir: The root of the cache.
        :param format_control: An object of FormatControl class to limit
            binaries being read from the cache.
        :param allowed_formats: which formats of files the cache should store.
            ('binary' and 'source' are the only allowed values)
    """

    def __init__(self, cache_dir, format_control, allowed_formats):
        # type: (str, FormatControl, Set[str]) -> None
        super(Cache, self).__init__()
        self.cache_dir = expanduser(cache_dir) if cache_dir else None
        self.format_control = format_control
        self.allowed_formats = allowed_formats

        _valid_formats = {"source", "binary"}
        assert self.allowed_formats.union(_valid_formats) == _valid_formats

    def _get_cache_path_parts(self, link):
        # type: (Link) -> List[str]
        """Get parts of part that must be os.path.joined with cache_dir
        """

        # We want to generate an url to use as our cache key, we don't want to
        # just re-use the URL because it might have other items in the fragment
        # and we don't care about those.
        key_parts = [link.url_without_fragment]
        if link.hash_name is not None and link.hash is not None:
            key_parts.append("=".join([link.hash_name, link.hash]))
        key_url = "#".join(key_parts)

        # Encode our key url with sha224, we'll use this because it has similar
        # security properties to sha256, but with a shorter total output (and
        # thus less secure). However the differences don't make a lot of
        # difference for our use case here.
        hashed = hashlib.sha224(key_url.encode()).hexdigest()

        # We want to nest the directories some to prevent having a ton of top
        # level directories where we might run out of sub directories on some
        # FS.
        parts = [hashed[:2], hashed[2:4], hashed[4:6], hashed[6:]]

        return parts

    def _get_candidates(self, link, package_name):
        # type: (Link, Optional[str]) -> List[Any]
        can_not_cache = (
            not self.cache_dir or
            not package_name or
            not link
        )
        if can_not_cache:
            return []

        canonical_name = canonicalize_name(package_name)
        formats = self.format_control.get_allowed_formats(
            canonical_name
        )
        if not self.allowed_formats.intersection(formats):
            return []

        root = self.get_path_for_link(link)
        try:
            return os.listdir(root)
        except OSError as err:
            if err.errno in {errno.ENOENT, errno.ENOTDIR}:
                return []
            raise

    def get_path_for_link(self, link):
        # type: (Link) -> str
        """Return a directory to store cached items in for link.
        """
        raise NotImplementedError()

    def get(
        self,
        link,            # type: Link
        package_name,    # type: Optional[str]
        supported_tags,  # type: List[Pep425Tag]
    ):
        # type: (...) -> Link
        """Returns a link to a cached item if it exists, otherwise returns the
        passed link.
        """
        raise NotImplementedError()

    def _link_for_candidate(self, link, candidate):
        # type: (Link, str) -> Link
        root = self.get_path_for_link(link)
        path = os.path.join(root, candidate)

        return Link(path_to_url(path))

    def cleanup(self):
        # type: () -> None
        pass


class SimpleWheelCache(Cache):
    """A cache of wheels for future installs.
    """

    def __init__(self, cache_dir, format_control):
        # type: (str, FormatControl) -> None
        super(SimpleWheelCache, self).__init__(
            cache_dir, format_control, {"binary"}
        )

    def get_path_for_link(self, link):
        # type: (Link) -> str
        """Return a directory to store cached wheels for link

        Because there are M wheels for any one sdist, we provide a directory
        to cache them in, and then consult that directory when looking up
        cache hits.

        We only insert things into the cache if they have plausible version
        numbers, so that we don't contaminate the cache with things that were
        not unique. E.g. ./package might have dozens of installs done for it
        and build a version of 0.0...and if we built and cached a wheel, we'd
        end up using the same wheel even if the source has been edited.

        :param link: The link of the sdist for which this will cache wheels.
        """
        parts = self._get_cache_path_parts(link)

        # Store wheels within the root cache_dir
        return os.path.join(self.cache_dir, "wheels", *parts)

    def get(
        self,
        link,            # type: Link
        package_name,    # type: Optional[str]
        supported_tags,  # type: List[Pep425Tag]
    ):
        # type: (...) -> Link
        candidates = []

        for wheel_name in self._get_candidates(link, package_name):
            try:
                wheel = Wheel(wheel_name)
            except InvalidWheelFilename:
                continue
            if not wheel.supported(supported_tags):
                # Built for a different python/arch/etc
                continue
            candidates.append(
                (wheel.support_index_min(supported_tags), wheel_name)
            )

        if not candidates:
            return link

        return self._link_for_candidate(link, min(candidates)[1])


class EphemWheelCache(SimpleWheelCache):
    """A SimpleWheelCache that creates it's own temporary cache directory
    """

    def __init__(self, format_control):
        # type: (FormatControl) -> None
        self._temp_dir = TempDirectory(kind="ephem-wheel-cache")

        super(EphemWheelCache, self).__init__(
            self._temp_dir.path, format_control
        )

    def cleanup(self):
        # type: () -> None
        self._temp_dir.cleanup()


class WheelCache(Cache):
    """Wraps EphemWheelCache and SimpleWheelCache into a single Cache

    This Cache allows for gracefully degradation, using the ephem wheel cache
    when a certain link is not found in the simple wheel cache first.
    """

    def __init__(self, cache_dir, format_control):
        # type: (str, FormatControl) -> None
        super(WheelCache, self).__init__(
            cache_dir, format_control, {'binary'}
        )
        self._wheel_cache = SimpleWheelCache(cache_dir, format_control)
        self._ephem_cache = EphemWheelCache(format_control)

    def get_path_for_link(self, link):
        # type: (Link) -> str
        return self._wheel_cache.get_path_for_link(link)

    def get_ephem_path_for_link(self, link):
        # type: (Link) -> str
        return self._ephem_cache.get_path_for_link(link)

    def get(
        self,
        link,            # type: Link
        package_name,    # type: Optional[str]
        supported_tags,  # type: List[Pep425Tag]
    ):
        # type: (...) -> Link
        retval = self._wheel_cache.get(
            link=link,
            package_name=package_name,
            supported_tags=supported_tags,
        )
        if retval is not link:
            return retval

        return self._ephem_cache.get(
            link=link,
            package_name=package_name,
            supported_tags=supported_tags,
        )

    def cleanup(self):
        # type: () -> None
        self._wheel_cache.cleanup()
        self._ephem_cache.cleanup()
site-packages/pip/_internal/network/auth.py000064400000025557151446176770015073 0ustar00"""Network Authentication Helpers

Contains interface (MultiDomainBasicAuth) and associated glue code for
providing credentials in the context of network requests.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import logging

from pip._vendor.requests.auth import AuthBase, HTTPBasicAuth
from pip._vendor.requests.utils import get_netrc_auth
from pip._vendor.six.moves.urllib import parse as urllib_parse

from pip._internal.utils.misc import (
    ask,
    ask_input,
    ask_password,
    remove_auth_from_url,
    split_auth_netloc_from_url,
)
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from optparse import Values
    from typing import Dict, Optional, Tuple

    from pip._internal.vcs.versioncontrol import AuthInfo

    Credentials = Tuple[str, str, str]

logger = logging.getLogger(__name__)

try:
    import keyring  # noqa
except ImportError:
    keyring = None
except Exception as exc:
    logger.warning(
        "Keyring is skipped due to an exception: %s", str(exc),
    )
    keyring = None


def get_keyring_auth(url, username):
    """Return the tuple auth for a given url from keyring."""
    if not url or not keyring:
        return None

    try:
        try:
            get_credential = keyring.get_credential
        except AttributeError:
            pass
        else:
            logger.debug("Getting credentials from keyring for %s", url)
            cred = get_credential(url, username)
            if cred is not None:
                return cred.username, cred.password
            return None

        if username:
            logger.debug("Getting password from keyring for %s", url)
            password = keyring.get_password(url, username)
            if password:
                return username, password

    except Exception as exc:
        logger.warning(
            "Keyring is skipped due to an exception: %s", str(exc),
        )


class MultiDomainBasicAuth(AuthBase):

    def __init__(self, prompting=True, index_urls=None):
        # type: (bool, Optional[Values]) -> None
        self.prompting = prompting
        self.index_urls = index_urls
        self.passwords = {}  # type: Dict[str, AuthInfo]
        # When the user is prompted to enter credentials and keyring is
        # available, we will offer to save them. If the user accepts,
        # this value is set to the credentials they entered. After the
        # request authenticates, the caller should call
        # ``save_credentials`` to save these.
        self._credentials_to_save = None  # type: Optional[Credentials]

    def _get_index_url(self, url):
        """Return the original index URL matching the requested URL.

        Cached or dynamically generated credentials may work against
        the original index URL rather than just the netloc.

        The provided url should have had its username and password
        removed already. If the original index url had credentials then
        they will be included in the return value.

        Returns None if no matching index was found, or if --no-index
        was specified by the user.
        """
        if not url or not self.index_urls:
            return None

        for u in self.index_urls:
            prefix = remove_auth_from_url(u).rstrip("/") + "/"
            if url.startswith(prefix):
                return u

    def _get_new_credentials(self, original_url, allow_netrc=True,
                             allow_keyring=True):
        """Find and return credentials for the specified URL."""
        # Split the credentials and netloc from the url.
        url, netloc, url_user_password = split_auth_netloc_from_url(
            original_url,
        )

        # Start with the credentials embedded in the url
        username, password = url_user_password
        if username is not None and password is not None:
            logger.debug("Found credentials in url for %s", netloc)
            return url_user_password

        # Find a matching index url for this request
        index_url = self._get_index_url(url)
        if index_url:
            # Split the credentials from the url.
            index_info = split_auth_netloc_from_url(index_url)
            if index_info:
                index_url, _, index_url_user_password = index_info
                logger.debug("Found index url %s", index_url)

        # If an index URL was found, try its embedded credentials
        if index_url and index_url_user_password[0] is not None:
            username, password = index_url_user_password
            if username is not None and password is not None:
                logger.debug("Found credentials in index url for %s", netloc)
                return index_url_user_password

        # Get creds from netrc if we still don't have them
        if allow_netrc:
            netrc_auth = get_netrc_auth(original_url)
            if netrc_auth:
                logger.debug("Found credentials in netrc for %s", netloc)
                return netrc_auth

        # If we don't have a password and keyring is available, use it.
        if allow_keyring:
            # The index url is more specific than the netloc, so try it first
            kr_auth = (
                get_keyring_auth(index_url, username) or
                get_keyring_auth(netloc, username)
            )
            if kr_auth:
                logger.debug("Found credentials in keyring for %s", netloc)
                return kr_auth

        return username, password

    def _get_url_and_credentials(self, original_url):
        """Return the credentials to use for the provided URL.

        If allowed, netrc and keyring may be used to obtain the
        correct credentials.

        Returns (url_without_credentials, username, password). Note
        that even if the original URL contains credentials, this
        function may return a different username and password.
        """
        url, netloc, _ = split_auth_netloc_from_url(original_url)

        # Use any stored credentials that we have for this netloc
        username, password = self.passwords.get(netloc, (None, None))

        if username is None and password is None:
            # No stored credentials. Acquire new credentials without prompting
            # the user. (e.g. from netrc, keyring, or the URL itself)
            username, password = self._get_new_credentials(original_url)

        if username is not None or password is not None:
            # Convert the username and password if they're None, so that
            # this netloc will show up as "cached" in the conditional above.
            # Further, HTTPBasicAuth doesn't accept None, so it makes sense to
            # cache the value that is going to be used.
            username = username or ""
            password = password or ""

            # Store any acquired credentials.
            self.passwords[netloc] = (username, password)

        assert (
            # Credentials were found
            (username is not None and password is not None) or
            # Credentials were not found
            (username is None and password is None)
        ), "Could not load credentials from url: {}".format(original_url)

        return url, username, password

    def __call__(self, req):
        # Get credentials for this request
        url, username, password = self._get_url_and_credentials(req.url)

        # Set the url of the request to the url without any credentials
        req.url = url

        if username is not None and password is not None:
            # Send the basic auth with this request
            req = HTTPBasicAuth(username, password)(req)

        # Attach a hook to handle 401 responses
        req.register_hook("response", self.handle_401)

        return req

    # Factored out to allow for easy patching in tests
    def _prompt_for_password(self, netloc):
        username = ask_input("User for %s: " % netloc)
        if not username:
            return None, None
        auth = get_keyring_auth(netloc, username)
        if auth:
            return auth[0], auth[1], False
        password = ask_password("Password: ")
        return username, password, True

    # Factored out to allow for easy patching in tests
    def _should_save_password_to_keyring(self):
        if not keyring:
            return False
        return ask("Save credentials to keyring [y/N]: ", ["y", "n"]) == "y"

    def handle_401(self, resp, **kwargs):
        # We only care about 401 responses, anything else we want to just
        #   pass through the actual response
        if resp.status_code != 401:
            return resp

        # We are not able to prompt the user so simply return the response
        if not self.prompting:
            return resp

        parsed = urllib_parse.urlparse(resp.url)

        # Prompt the user for a new username and password
        username, password, save = self._prompt_for_password(parsed.netloc)

        # Store the new username and password to use for future requests
        self._credentials_to_save = None
        if username is not None and password is not None:
            self.passwords[parsed.netloc] = (username, password)

            # Prompt to save the password to keyring
            if save and self._should_save_password_to_keyring():
                self._credentials_to_save = (parsed.netloc, username, password)

        # Consume content and release the original connection to allow our new
        #   request to reuse the same one.
        resp.content
        resp.raw.release_conn()

        # Add our new username and password to the request
        req = HTTPBasicAuth(username or "", password or "")(resp.request)
        req.register_hook("response", self.warn_on_401)

        # On successful request, save the credentials that were used to
        # keyring. (Note that if the user responded "no" above, this member
        # is not set and nothing will be saved.)
        if self._credentials_to_save:
            req.register_hook("response", self.save_credentials)

        # Send our new request
        new_resp = resp.connection.send(req, **kwargs)
        new_resp.history.append(resp)

        return new_resp

    def warn_on_401(self, resp, **kwargs):
        """Response callback to warn about incorrect credentials."""
        if resp.status_code == 401:
            logger.warning(
                '401 Error, Credentials not correct for %s', resp.request.url,
            )

    def save_credentials(self, resp, **kwargs):
        """Response callback to save credentials on success."""
        assert keyring is not None, "should never reach here without keyring"
        if not keyring:
            return

        creds = self._credentials_to_save
        self._credentials_to_save = None
        if creds and resp.status_code < 400:
            try:
                logger.info('Saving credentials to keyring')
                keyring.set_password(*creds)
            except Exception:
                logger.exception('Failed to save credentials')
site-packages/pip/_internal/network/session.py000064400000036742151446176770015613 0ustar00"""PipSession and supporting code, containing all pip-specific
network request configuration and behavior.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import email.utils
import json
import logging
import mimetypes
import os
import platform
import sys
import warnings

from pip._vendor import requests, six, urllib3
from pip._vendor.cachecontrol import CacheControlAdapter
from pip._vendor.requests.adapters import BaseAdapter, HTTPAdapter
from pip._vendor.requests.models import Response
from pip._vendor.requests.structures import CaseInsensitiveDict
from pip._vendor.six.moves.urllib import parse as urllib_parse
from pip._vendor.urllib3.exceptions import InsecureRequestWarning

from pip import __version__
from pip._internal.network.auth import MultiDomainBasicAuth
from pip._internal.network.cache import SafeFileCache
# Import ssl from compat so the initial import occurs in only one place.
from pip._internal.utils.compat import HAS_TLS, ipaddress, ssl
from pip._internal.utils.filesystem import check_path_owner
from pip._internal.utils.glibc import libc_ver
from pip._internal.utils.misc import (
    build_url_from_netloc,
    get_installed_version,
    parse_netloc,
)
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import url_to_path

if MYPY_CHECK_RUNNING:
    from typing import (
        Iterator, List, Optional, Tuple, Union,
    )

    from pip._internal.models.link import Link

    SecureOrigin = Tuple[str, str, Optional[Union[int, str]]]


logger = logging.getLogger(__name__)


# Ignore warning raised when using --trusted-host.
warnings.filterwarnings("ignore", category=InsecureRequestWarning)


SECURE_ORIGINS = [
    # protocol, hostname, port
    # Taken from Chrome's list of secure origins (See: http://bit.ly/1qrySKC)
    ("https", "*", "*"),
    ("*", "localhost", "*"),
    ("*", "127.0.0.0/8", "*"),
    ("*", "::1/128", "*"),
    ("file", "*", None),
    # ssh is always secure.
    ("ssh", "*", "*"),
]  # type: List[SecureOrigin]


# These are environment variables present when running under various
# CI systems.  For each variable, some CI systems that use the variable
# are indicated.  The collection was chosen so that for each of a number
# of popular systems, at least one of the environment variables is used.
# This list is used to provide some indication of and lower bound for
# CI traffic to PyPI.  Thus, it is okay if the list is not comprehensive.
# For more background, see: https://github.com/pypa/pip/issues/5499
CI_ENVIRONMENT_VARIABLES = (
    # Azure Pipelines
    'BUILD_BUILDID',
    # Jenkins
    'BUILD_ID',
    # AppVeyor, CircleCI, Codeship, Gitlab CI, Shippable, Travis CI
    'CI',
    # Explicit environment variable.
    'PIP_IS_CI',
)


def looks_like_ci():
    # type: () -> bool
    """
    Return whether it looks like pip is running under CI.
    """
    # We don't use the method of checking for a tty (e.g. using isatty())
    # because some CI systems mimic a tty (e.g. Travis CI).  Thus that
    # method doesn't provide definitive information in either direction.
    return any(name in os.environ for name in CI_ENVIRONMENT_VARIABLES)


def user_agent():
    """
    Return a string representing the user agent.
    """
    data = {
        "installer": {"name": "pip", "version": __version__},
        "python": platform.python_version(),
        "implementation": {
            "name": platform.python_implementation(),
        },
    }

    if data["implementation"]["name"] == 'CPython':
        data["implementation"]["version"] = platform.python_version()
    elif data["implementation"]["name"] == 'PyPy':
        if sys.pypy_version_info.releaselevel == 'final':
            pypy_version_info = sys.pypy_version_info[:3]
        else:
            pypy_version_info = sys.pypy_version_info
        data["implementation"]["version"] = ".".join(
            [str(x) for x in pypy_version_info]
        )
    elif data["implementation"]["name"] == 'Jython':
        # Complete Guess
        data["implementation"]["version"] = platform.python_version()
    elif data["implementation"]["name"] == 'IronPython':
        # Complete Guess
        data["implementation"]["version"] = platform.python_version()

    if sys.platform.startswith("linux"):
        from pip._vendor import distro
        distro_infos = dict(filter(
            lambda x: x[1],
            zip(["name", "version", "id"], distro.linux_distribution()),
        ))
        libc = dict(filter(
            lambda x: x[1],
            zip(["lib", "version"], libc_ver()),
        ))
        if libc:
            distro_infos["libc"] = libc
        if distro_infos:
            data["distro"] = distro_infos

    if sys.platform.startswith("darwin") and platform.mac_ver()[0]:
        data["distro"] = {"name": "macOS", "version": platform.mac_ver()[0]}

    if platform.system():
        data.setdefault("system", {})["name"] = platform.system()

    if platform.release():
        data.setdefault("system", {})["release"] = platform.release()

    if platform.machine():
        data["cpu"] = platform.machine()

    if HAS_TLS:
        data["openssl_version"] = ssl.OPENSSL_VERSION

    setuptools_version = get_installed_version("setuptools")
    if setuptools_version is not None:
        data["setuptools_version"] = setuptools_version

    # Use None rather than False so as not to give the impression that
    # pip knows it is not being run under CI.  Rather, it is a null or
    # inconclusive result.  Also, we include some value rather than no
    # value to make it easier to know that the check has been run.
    data["ci"] = True if looks_like_ci() else None

    user_data = os.environ.get("PIP_USER_AGENT_USER_DATA")
    if user_data is not None:
        data["user_data"] = user_data

    return "{data[installer][name]}/{data[installer][version]} {json}".format(
        data=data,
        json=json.dumps(data, separators=(",", ":"), sort_keys=True),
    )


class LocalFSAdapter(BaseAdapter):

    def send(self, request, stream=None, timeout=None, verify=None, cert=None,
             proxies=None):
        pathname = url_to_path(request.url)

        resp = Response()
        resp.status_code = 200
        resp.url = request.url

        try:
            stats = os.stat(pathname)
        except OSError as exc:
            resp.status_code = 404
            resp.raw = exc
        else:
            modified = email.utils.formatdate(stats.st_mtime, usegmt=True)
            content_type = mimetypes.guess_type(pathname)[0] or "text/plain"
            resp.headers = CaseInsensitiveDict({
                "Content-Type": content_type,
                "Content-Length": stats.st_size,
                "Last-Modified": modified,
            })

            resp.raw = open(pathname, "rb")
            resp.close = resp.raw.close

        return resp

    def close(self):
        pass


class InsecureHTTPAdapter(HTTPAdapter):

    def cert_verify(self, conn, url, verify, cert):
        conn.cert_reqs = 'CERT_NONE'
        conn.ca_certs = None


class PipSession(requests.Session):

    timeout = None  # type: Optional[int]

    def __init__(self, *args, **kwargs):
        """
        :param trusted_hosts: Domains not to emit warnings for when not using
            HTTPS.
        """
        retries = kwargs.pop("retries", 0)
        cache = kwargs.pop("cache", None)
        trusted_hosts = kwargs.pop("trusted_hosts", [])  # type: List[str]
        index_urls = kwargs.pop("index_urls", None)

        super(PipSession, self).__init__(*args, **kwargs)

        # Namespace the attribute with "pip_" just in case to prevent
        # possible conflicts with the base class.
        self.pip_trusted_origins = []  # type: List[Tuple[str, Optional[int]]]

        # Attach our User Agent to the request
        self.headers["User-Agent"] = user_agent()

        # Attach our Authentication handler to the session
        self.auth = MultiDomainBasicAuth(index_urls=index_urls)

        # Create our urllib3.Retry instance which will allow us to customize
        # how we handle retries.
        retries = urllib3.Retry(
            # Set the total number of retries that a particular request can
            # have.
            total=retries,

            # A 503 error from PyPI typically means that the Fastly -> Origin
            # connection got interrupted in some way. A 503 error in general
            # is typically considered a transient error so we'll go ahead and
            # retry it.
            # A 500 may indicate transient error in Amazon S3
            # A 520 or 527 - may indicate transient error in CloudFlare
            status_forcelist=[500, 503, 520, 527],

            # Add a small amount of back off between failed requests in
            # order to prevent hammering the service.
            backoff_factor=0.25,
        )

        # Check to ensure that the directory containing our cache directory
        # is owned by the user current executing pip. If it does not exist
        # we will check the parent directory until we find one that does exist.
        if cache and not check_path_owner(cache):
            logger.warning(
                "The directory '%s' or its parent directory is not owned by "
                "the current user and the cache has been disabled. Please "
                "check the permissions and owner of that directory. If "
                "executing pip with sudo, you may want sudo's -H flag.",
                cache,
            )
            cache = None

        # We want to _only_ cache responses on securely fetched origins. We do
        # this because we can't validate the response of an insecurely fetched
        # origin, and we don't want someone to be able to poison the cache and
        # require manual eviction from the cache to fix it.
        if cache:
            secure_adapter = CacheControlAdapter(
                cache=SafeFileCache(cache),
                max_retries=retries,
            )
        else:
            secure_adapter = HTTPAdapter(max_retries=retries)

        # Our Insecure HTTPAdapter disables HTTPS validation. It does not
        # support caching (see above) so we'll use it for all http:// URLs as
        # well as any https:// host that we've marked as ignoring TLS errors
        # for.
        insecure_adapter = InsecureHTTPAdapter(max_retries=retries)
        # Save this for later use in add_insecure_host().
        self._insecure_adapter = insecure_adapter

        self.mount("https://", secure_adapter)
        self.mount("http://", insecure_adapter)

        # Enable file:// urls
        self.mount("file://", LocalFSAdapter())

        for host in trusted_hosts:
            self.add_trusted_host(host, suppress_logging=True)

    def add_trusted_host(self, host, source=None, suppress_logging=False):
        # type: (str, Optional[str], bool) -> None
        """
        :param host: It is okay to provide a host that has previously been
            added.
        :param source: An optional source string, for logging where the host
            string came from.
        """
        if not suppress_logging:
            msg = 'adding trusted host: {!r}'.format(host)
            if source is not None:
                msg += ' (from {})'.format(source)
            logger.info(msg)

        host_port = parse_netloc(host)
        if host_port not in self.pip_trusted_origins:
            self.pip_trusted_origins.append(host_port)

        self.mount(build_url_from_netloc(host) + '/', self._insecure_adapter)
        if not host_port[1]:
            # Mount wildcard ports for the same host.
            self.mount(
                build_url_from_netloc(host) + ':',
                self._insecure_adapter
            )

    def iter_secure_origins(self):
        # type: () -> Iterator[SecureOrigin]
        for secure_origin in SECURE_ORIGINS:
            yield secure_origin
        for host, port in self.pip_trusted_origins:
            yield ('*', host, '*' if port is None else port)

    def is_secure_origin(self, location):
        # type: (Link) -> bool
        # Determine if this url used a secure transport mechanism
        parsed = urllib_parse.urlparse(str(location))
        origin_protocol, origin_host, origin_port = (
            parsed.scheme, parsed.hostname, parsed.port,
        )

        # The protocol to use to see if the protocol matches.
        # Don't count the repository type as part of the protocol: in
        # cases such as "git+ssh", only use "ssh". (I.e., Only verify against
        # the last scheme.)
        origin_protocol = origin_protocol.rsplit('+', 1)[-1]

        # Determine if our origin is a secure origin by looking through our
        # hardcoded list of secure origins, as well as any additional ones
        # configured on this PackageFinder instance.
        for secure_origin in self.iter_secure_origins():
            secure_protocol, secure_host, secure_port = secure_origin
            if origin_protocol != secure_protocol and secure_protocol != "*":
                continue

            try:
                # We need to do this decode dance to ensure that we have a
                # unicode object, even on Python 2.x.
                addr = ipaddress.ip_address(
                    origin_host
                    if (
                        isinstance(origin_host, six.text_type) or
                        origin_host is None
                    )
                    else origin_host.decode("utf8")
                )
                network = ipaddress.ip_network(
                    secure_host
                    if isinstance(secure_host, six.text_type)
                    # setting secure_host to proper Union[bytes, str]
                    # creates problems in other places
                    else secure_host.decode("utf8")  # type: ignore
                )
            except ValueError:
                # We don't have both a valid address or a valid network, so
                # we'll check this origin against hostnames.
                if (
                    origin_host and
                    origin_host.lower() != secure_host.lower() and
                    secure_host != "*"
                ):
                    continue
            else:
                # We have a valid address and network, so see if the address
                # is contained within the network.
                if addr not in network:
                    continue

            # Check to see if the port matches.
            if (
                origin_port != secure_port and
                secure_port != "*" and
                secure_port is not None
            ):
                continue

            # If we've gotten here, then this origin matches the current
            # secure origin and we should return True
            return True

        # If we've gotten to this point, then the origin isn't secure and we
        # will not accept it as a valid location to search. We will however
        # log a warning that we are ignoring it.
        logger.warning(
            "The repository located at %s is not a trusted or secure host and "
            "is being ignored. If this repository is available via HTTPS we "
            "recommend you use HTTPS instead, otherwise you may silence "
            "this warning and allow it anyway with '--trusted-host %s'.",
            origin_host,
            origin_host,
        )

        return False

    def request(self, method, url, *args, **kwargs):
        # Allow setting a default timeout on a session
        kwargs.setdefault("timeout", self.timeout)

        # Dispatch the actual request
        return super(PipSession, self).request(method, url, *args, **kwargs)
site-packages/pip/_internal/network/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000324151446176770023077 0ustar00U

��.e2�@sdZdS)z+Contains purely network-related utilities.
N)�__doc__�rr�B/usr/lib/python3.8/site-packages/pip/_internal/network/__init__.py�<module>�site-packages/pip/_internal/network/__pycache__/xmlrpc.cpython-38.opt-1.pyc000064400000003046151446176770022651 0ustar00U

��.e=�@sPdZddlZddlmZddlmZddlmZe�	e
�ZGdd�dej�Z
dS)z#xmlrpclib.Transport implementation
�N)�requests)�
xmlrpc_client)�parsec@s$eZdZdZddd�Zd	dd�ZdS)
�PipXmlrpcTransportzRProvide a `xmlrpclib.Transport` implementation via a `PipSession`
    object.
    FcCs*tj�||�t�|�}|j|_||_dS)N)r�	Transport�__init__�urllib_parseZurlparseZscheme�_scheme�_session)�selfZ	index_urlZsessionZuse_datetimeZindex_parts�r�@/usr/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.pyrs
zPipXmlrpcTransport.__init__c

Cs�|j||dddf}t�|�}z8ddi}|jj|||dd�}|��||_|�|j�WSt	j
k
r�}	zt�d|	j
j|��W5d}	~	XYnXdS)NzContent-Typeztext/xmlT)�data�headers�streamzHTTP error %s while getting %s)r	rZ
urlunparser
ZpostZraise_for_status�verboseZparse_response�rawrZ	HTTPError�loggerZcritical�responseZstatus_code)
rZhostZhandlerZrequest_bodyr�partsZurlrr�excrrr
�requests$

��zPipXmlrpcTransport.requestN)F)F)�__name__�
__module__�__qualname__�__doc__rrrrrr
rs
r)rZloggingZpip._vendorrZpip._vendor.six.movesrZpip._vendor.six.moves.urllibrrZ	getLoggerrrrrrrrr
�<module>s
site-packages/pip/_internal/network/__pycache__/auth.cpython-38.pyc000064400000015502151446176770021346 0ustar00U

��.eo+�
@sdZddlZddlmZmZddlmZddlmZ	ddl
mZmZm
Z
mZmZddlmZer�ddlmZdd	lmZmZmZdd
lmZeeeefZe�e�ZzddlZWnLe k
r�dZYn6e!k
r�Z"ze�#dee"��dZW5dZ"["XYnXdd
�Z$Gdd�de�Z%dS)z�Network Authentication Helpers

Contains interface (MultiDomainBasicAuth) and associated glue code for
providing credentials in the context of network requests.
�N)�AuthBase�
HTTPBasicAuth)�get_netrc_auth)�parse)�ask�	ask_input�ask_password�remove_auth_from_url�split_auth_netloc_from_url)�MYPY_CHECK_RUNNING)�Values)�Dict�Optional�Tuple)�AuthInfo�*Keyring is skipped due to an exception: %sc
Cs�|rtsdSz�z
tj}Wntk
r,Yn4Xt�d|�|||�}|dk	rZ|j|jfWSWdS|r�t�d|�t�||�}|r�||fWSWn2tk
r�}zt�	dt
|��W5d}~XYnXdS)z3Return the tuple auth for a given url from keyring.Nz'Getting credentials from keyring for %sz$Getting password from keyring for %sr)�keyring�get_credential�AttributeError�logger�debug�username�passwordZget_password�	Exception�warning�str)�urlrrZcredr�exc�r�>/usr/lib/python3.8/site-packages/pip/_internal/network/auth.py�get_keyring_auth.s,

�r c@s`eZdZddd�Zdd�Zddd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zdd�ZdS)�MultiDomainBasicAuthTNcCs||_||_i|_d|_dS)N)�	prompting�
index_urls�	passwords�_credentials_to_save)�selfr"r#rrr�__init__MszMultiDomainBasicAuth.__init__cCsB|r
|jsdS|jD](}t|��d�d}|�|�r|SqdS)a�Return the original index URL matching the requested URL.

        Cached or dynamically generated credentials may work against
        the original index URL rather than just the netloc.

        The provided url should have had its username and password
        removed already. If the original index url had credentials then
        they will be included in the return value.

        Returns None if no matching index was found, or if --no-index
        was specified by the user.
        N�/)r#r	�rstrip�
startswith)r&r�u�prefixrrr�_get_index_urlYs


z#MultiDomainBasicAuth._get_index_urlcCs�t|�\}}}|\}}|dk	r6|dk	r6t�d|�|S|�|�}	|	rft|	�}
|
rf|
\}	}}t�d|	�|	r�|ddk	r�|\}}|dk	r�|dk	r�t�d|�|S|r�t|�}
|
r�t�d|�|
S|r�t|	|�p�t||�}|r�t�d|�|S||fS)z2Find and return credentials for the specified URL.NzFound credentials in url for %szFound index url %srz%Found credentials in index url for %sz!Found credentials in netrc for %sz#Found credentials in keyring for %s)r
rrr-rr )r&�original_urlZallow_netrcZ
allow_keyringr�netlocZurl_user_passwordrrZ	index_urlZ
index_info�_Zindex_url_user_passwordZ
netrc_authZkr_authrrr�_get_new_credentialsns>�



�z)MultiDomainBasicAuth._get_new_credentialscCs�t|�\}}}|j�|d�\}}|dkr>|dkr>|�|�\}}|dk	sN|dk	rl|pTd}|p\d}||f|j|<|dk	r||dk	s�|dkr�|dks�td�|���|||fS)a_Return the credentials to use for the provided URL.

        If allowed, netrc and keyring may be used to obtain the
        correct credentials.

        Returns (url_without_credentials, username, password). Note
        that even if the original URL contains credentials, this
        function may return a different username and password.
        �NNN�z'Could not load credentials from url: {})r
r$�getr1�AssertionError�format)r&r.rr/r0rrrrr�_get_url_and_credentials�s&
�����z-MultiDomainBasicAuth._get_url_and_credentialscCsH|�|j�\}}}||_|dk	r6|dk	r6t||�|�}|�d|j�|S)N�response)r7rr�
register_hook�
handle_401)r&�reqrrrrrr�__call__�szMultiDomainBasicAuth.__call__cCsFtd|�}|sdSt||�}|r4|d|ddfStd�}||dfS)Nz
User for %s: r2r�Fz
Password: T)rr r)r&r/rZauthrrrr�_prompt_for_password�s
z)MultiDomainBasicAuth._prompt_for_passwordcCstsdStdddg�dkS)NFz#Save credentials to keyring [y/N]: �y�n)rr)r&rrr� _should_save_password_to_keyring�sz5MultiDomainBasicAuth._should_save_password_to_keyringc	Ks�|jdkr|S|js|St�|j�}|�|j�\}}}d|_|dk	rv|dk	rv||f|j|j<|rv|�	�rv|j||f|_|j
|j��t
|p�d|p�d�|j�}|�d|j�|jr�|�d|j�|jj|f|�}|j�|�|S)N�r3r8)�status_coder"�urllib_parseZurlparserr>r/r%r$rAZcontent�rawZrelease_connr�requestr9�warn_on_401�save_credentialsZ
connection�send�history�append)	r&�resp�kwargsZparsedrrZsaver;Znew_resprrrr:�s(

zMultiDomainBasicAuth.handle_401cKs|jdkrt�d|jj�dS)z6Response callback to warn about incorrect credentials.rBz)401 Error, Credentials not correct for %sN)rCrrrFr)r&rLrMrrrrGs

�z MultiDomainBasicAuth.warn_on_401cKsntdk	std��tsdS|j}d|_|rj|jdkrjzt�d�tj|�Wntk
rht�d�YnXdS)z1Response callback to save credentials on success.Nz'should never reach here without keyringi�zSaving credentials to keyringzFailed to save credentials)	rr5r%rCr�infoZset_passwordrZ	exception)r&rLrMZcredsrrrrHs
z%MultiDomainBasicAuth.save_credentials)TN)TT)
�__name__�
__module__�__qualname__r'r-r1r7r<r>rAr:rGrHrrrrr!Ks
�
2(-r!)&�__doc__ZloggingZpip._vendor.requests.authrrZpip._vendor.requests.utilsrZpip._vendor.six.moves.urllibrrDZpip._internal.utils.miscrrrr	r
Zpip._internal.utils.typingrZoptparser�typingr
rrZ pip._internal.vcs.versioncontrolrrZCredentialsZ	getLoggerrOrr�ImportErrorrrrr r!rrrr�<module>s0	
�site-packages/pip/_internal/network/__pycache__/session.cpython-38.opt-1.pyc000064400000022012151446176770023021 0ustar00U

��.e�=�@s�dZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
mZmZm
Z
ddlmZddlmZmZddlmZddlmZddlmZdd	lmZdd
lmZddlmZddl m!Z!dd
l"m#Z#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1e/�rhddl2m3Z3m4Z4m5Z5m6Z6m7Z7ddl8m9Z9e6e:e:e5e7e;e:ffZ<e�=e>�Z?e	j@ded�ddddddgZAdZBdd�ZCd d!�ZDGd"d#�d#e�ZEGd$d%�d%e�ZFGd&d'�d'ejG�ZHdS)(zhPipSession and supporting code, containing all pip-specific
network request configuration and behavior.
�N)�requests�six�urllib3)�CacheControlAdapter)�BaseAdapter�HTTPAdapter)�Response)�CaseInsensitiveDict)�parse)�InsecureRequestWarning)�__version__)�MultiDomainBasicAuth)�
SafeFileCache)�HAS_TLS�	ipaddress�ssl)�check_path_owner)�libc_ver)�build_url_from_netloc�get_installed_version�parse_netloc)�MYPY_CHECK_RUNNING)�url_to_path)�Iterator�List�Optional�Tuple�Union)�Link�ignore)�category)Zhttps�*r!)r!Z	localhostr!)r!z127.0.0.0/8r!)r!z::1/128r!)�filer!N)Zsshr!r!)Z
BUILD_BUILDIDZBUILD_IDZCIZ	PIP_IS_CIcCstdd�tD��S)z?
    Return whether it looks like pip is running under CI.
    css|]}|tjkVqdS�N)�os�environ)�.0�name�r(�A/usr/lib/python3.8/site-packages/pip/_internal/network/session.py�	<genexpr>asz looks_like_ci.<locals>.<genexpr>)�any�CI_ENVIRONMENT_VARIABLESr(r(r(r)�
looks_like_ciYsr-cCsBdtd�t��dt��id�}|dddkr@t��|dd<n�|dddkr�tjjd	krltjd
d�}ntj}d�d
d�|D��|dd<nB|dddkr�t��|dd<n |dddkr�t��|dd<tj�d��rHddl	m
}ttdd�t
dddg|�����}ttdd�t
ddgt����}|�r:||d<|�rH||d<tj�d��rzt��d�rzdt��dd�|d<t���r�t��|�di�d<t���r�t��|�di�d<t���r�t��|d<t�r�tj|d <td!�}|d
k	�r�||d"<t��rd#nd
|d$<tj�d%�}|d
k	�r(||d&<d'j|tj|d(d#d)�d*�S)+z6
    Return a string representing the user agent.
    �pip)r'�versionr')Z	installer�python�implementationr1ZCPythonr/ZPyPy�finalN��.cSsg|]}t|��qSr()�str)r&�xr(r(r)�
<listcomp>xszuser_agent.<locals>.<listcomp>ZJythonZ
IronPythonZlinuxr)�distrocSs|dS�N�r(�r6r(r(r)�<lambda>��zuser_agent.<locals>.<lambda>�idcSs|dSr9r(r;r(r(r)r<�r=�lib�libcr8�darwinZmacOS�system�releaseZcpuZopenssl_versionZ
setuptools�setuptools_versionTZciZPIP_USER_AGENT_USER_DATA�	user_dataz9{data[installer][name]}/{data[installer][version]} {json})�,�:)Z
separatorsZ	sort_keys)�data�json) r�platformZpython_versionZpython_implementation�sys�pypy_version_info�releaselevel�join�
startswith�pip._vendorr8�dict�filter�zipZlinux_distributionrZmac_verrB�
setdefaultrC�machinerrZOPENSSL_VERSIONrr-r$r%�get�formatrI�dumps)rHrLr8Zdistro_infosr@rDrEr(r(r)�
user_agentdsl�����





�rYc@seZdZddd�Zdd�ZdS)�LocalFSAdapterNc

Cs�t|j�}t�}d|_|j|_zt�|�}	Wn.tk
rZ}
zd|_|
|_W5d}
~
XYnPXtj	j
|	jdd�}t�
|�dp~d}t||	j|d��|_t|d�|_|jj|_|S)	N��i�T)Zusegmtrz
text/plain)zContent-TypezContent-Lengthz
Last-Modified�rb)r�urlrZstatus_coder$�stat�OSError�raw�emailZutilsZ
formatdate�st_mtime�	mimetypesZ
guess_typer	�st_size�headers�open�close)
�self�request�stream�timeout�verify�certZproxies�pathnameZrespZstats�excZmodifiedZcontent_typer(r(r)�send�s&
�

zLocalFSAdapter.sendcCsdSr#r()rhr(r(r)rg�szLocalFSAdapter.close)NNNNN)�__name__�
__module__�__qualname__rprgr(r(r(r)rZ�s�
rZc@seZdZdd�ZdS)�InsecureHTTPAdaptercCsd|_d|_dS)NZ	CERT_NONE)Z	cert_reqsZca_certs)rhZconnr]rlrmr(r(r)�cert_verify�szInsecureHTTPAdapter.cert_verifyN)rqrrrsrur(r(r(r)rt�srtcsFeZdZdZ�fdd�Zd
dd�Zdd�Zd	d
�Z�fdd�Z�Z	S)�
PipSessionNc
s|�dd�}|�dd�}|�dg�}|�dd�}tt|�j||�g|_t�|jd<t|d�|_t	j
|d	d
ddgd
d�}|r�t|�s�t�
d|�d}|r�tt|�|d�}n
t|d�}t|d�}||_|�d|�|�d|�|�dt��|D]}	|j|	dd�q�dS)zj
        :param trusted_hosts: Domains not to emit warnings for when not using
            HTTPS.
        �retriesr�cacheN�
trusted_hosts�
index_urlsz
User-Agent)rzi�i�iig�?)ZtotalZstatus_forcelistZbackoff_factorz�The directory '%s' or its parent directory is not owned by the current user and the cache has been disabled. Please check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.)rx�max_retries)r{zhttps://zhttp://zfile://T)�suppress_logging)�pop�superrv�__init__�pip_trusted_originsrYrer
ZauthrZRetryr�logger�warningrrrrt�_insecure_adapter�mountrZ�add_trusted_host)
rh�args�kwargsrwrxryrzZsecure_adapterZinsecure_adapter�host��	__class__r(r)r�s@
���

zPipSession.__init__FcCs�|s.d�|�}|dk	r$|d�|�7}t�|�t|�}||jkrL|j�|�|�t|�d|j�|ds�|�t|�d|j�dS)z�
        :param host: It is okay to provide a host that has previously been
            added.
        :param source: An optional source string, for logging where the host
            string came from.
        zadding trusted host: {!r}Nz
 (from {})�/r:rG)	rWr��inforr��appendr�rr�)rhr��sourcer|�msgZ	host_portr(r(r)r�3s



�zPipSession.add_trusted_hostccs<tD]
}|Vq|jD] \}}d||dkr.dn|fVqdS)Nr!)�SECURE_ORIGINSr�)rh�
secure_originr��portr(r(r)�iter_secure_originsMszPipSession.iter_secure_originsc	Cs t�t|��}|j|j|j}}}|�dd�d}|��D]�}|\}}}	||kr\|dkr\q<zLt�	t
|tj�sv|dkrz|n|�
d��}
t�t
|tj�r�|n|�
d��}Wn4tk
r�|r�|��|��kr�|dkr�Yq<YnX|
|kr�q<||	k�r|	dk�r|	dk	�rq<dSt�d||�dS)	N�+r:���r!�utf8Tz�The repository located at %s is not a trusted or secure host and is being ignored. If this repository is available via HTTPS we recommend you use HTTPS instead, otherwise you may silence this warning and allow it anyway with '--trusted-host %s'.F)�urllib_parseZurlparser5ZschemeZhostnamer��rsplitr�rZ
ip_address�
isinstancerZ	text_type�decodeZ
ip_network�
ValueError�lowerr�r�)rh�locationZparsedZorigin_protocolZorigin_hostZorigin_portr�Zsecure_protocolZsecure_hostZsecure_portZaddrZnetworkr(r(r)�is_secure_originTs^�


���
�����
����	zPipSession.is_secure_origincs(|�d|j�tt|�j||f|�|�S)Nrk)rTrkr~rvri)rh�methodr]r�r�r�r(r)ri�szPipSession.request)NF)
rqrrrsrkrr�r�r�ri�
__classcell__r(r(r�r)rv�sT
Qrv)I�__doc__Zemail.utilsrarIZloggingrcr$rJrK�warningsrPrrrZpip._vendor.cachecontrolrZpip._vendor.requests.adaptersrrZpip._vendor.requests.modelsrZpip._vendor.requests.structuresr	Zpip._vendor.six.moves.urllibr
r�Zpip._vendor.urllib3.exceptionsrr.rZpip._internal.network.authr
Zpip._internal.network.cacherZpip._internal.utils.compatrrrZpip._internal.utils.filesystemrZpip._internal.utils.glibcrZpip._internal.utils.miscrrrZpip._internal.utils.typingrZpip._internal.utils.urlsr�typingrrrrrZpip._internal.models.linkrr5�intZSecureOriginZ	getLoggerrqr��filterwarningsr�r,r-rYrZrtZSessionrvr(r(r(r)�<module>sV
�O!site-packages/pip/_internal/network/__pycache__/session.cpython-38.pyc000064400000022012151446176770022062 0ustar00U

��.e�=�@s�dZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
mZmZm
Z
ddlmZddlmZmZddlmZddlmZddlmZdd	lmZdd
lmZddlmZddl m!Z!dd
l"m#Z#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1e/�rhddl2m3Z3m4Z4m5Z5m6Z6m7Z7ddl8m9Z9e6e:e:e5e7e;e:ffZ<e�=e>�Z?e	j@ded�ddddddgZAdZBdd�ZCd d!�ZDGd"d#�d#e�ZEGd$d%�d%e�ZFGd&d'�d'ejG�ZHdS)(zhPipSession and supporting code, containing all pip-specific
network request configuration and behavior.
�N)�requests�six�urllib3)�CacheControlAdapter)�BaseAdapter�HTTPAdapter)�Response)�CaseInsensitiveDict)�parse)�InsecureRequestWarning)�__version__)�MultiDomainBasicAuth)�
SafeFileCache)�HAS_TLS�	ipaddress�ssl)�check_path_owner)�libc_ver)�build_url_from_netloc�get_installed_version�parse_netloc)�MYPY_CHECK_RUNNING)�url_to_path)�Iterator�List�Optional�Tuple�Union)�Link�ignore)�category)Zhttps�*r!)r!Z	localhostr!)r!z127.0.0.0/8r!)r!z::1/128r!)�filer!N)Zsshr!r!)Z
BUILD_BUILDIDZBUILD_IDZCIZ	PIP_IS_CIcCstdd�tD��S)z?
    Return whether it looks like pip is running under CI.
    css|]}|tjkVqdS�N)�os�environ)�.0�name�r(�A/usr/lib/python3.8/site-packages/pip/_internal/network/session.py�	<genexpr>asz looks_like_ci.<locals>.<genexpr>)�any�CI_ENVIRONMENT_VARIABLESr(r(r(r)�
looks_like_ciYsr-cCsBdtd�t��dt��id�}|dddkr@t��|dd<n�|dddkr�tjjd	krltjd
d�}ntj}d�d
d�|D��|dd<nB|dddkr�t��|dd<n |dddkr�t��|dd<tj�d��rHddl	m
}ttdd�t
dddg|�����}ttdd�t
ddgt����}|�r:||d<|�rH||d<tj�d��rzt��d�rzdt��dd�|d<t���r�t��|�di�d<t���r�t��|�di�d<t���r�t��|d<t�r�tj|d <td!�}|d
k	�r�||d"<t��rd#nd
|d$<tj�d%�}|d
k	�r(||d&<d'j|tj|d(d#d)�d*�S)+z6
    Return a string representing the user agent.
    �pip)r'�versionr')Z	installer�python�implementationr1ZCPythonr/ZPyPy�finalN��.cSsg|]}t|��qSr()�str)r&�xr(r(r)�
<listcomp>xszuser_agent.<locals>.<listcomp>ZJythonZ
IronPythonZlinuxr)�distrocSs|dS�N�r(�r6r(r(r)�<lambda>��zuser_agent.<locals>.<lambda>�idcSs|dSr9r(r;r(r(r)r<�r=�lib�libcr8�darwinZmacOS�system�releaseZcpuZopenssl_versionZ
setuptools�setuptools_versionTZciZPIP_USER_AGENT_USER_DATA�	user_dataz9{data[installer][name]}/{data[installer][version]} {json})�,�:)Z
separatorsZ	sort_keys)�data�json) r�platformZpython_versionZpython_implementation�sys�pypy_version_info�releaselevel�join�
startswith�pip._vendorr8�dict�filter�zipZlinux_distributionrZmac_verrB�
setdefaultrC�machinerrZOPENSSL_VERSIONrr-r$r%�get�formatrI�dumps)rHrLr8Zdistro_infosr@rDrEr(r(r)�
user_agentdsl�����





�rYc@seZdZddd�Zdd�ZdS)�LocalFSAdapterNc

Cs�t|j�}t�}d|_|j|_zt�|�}	Wn.tk
rZ}
zd|_|
|_W5d}
~
XYnPXtj	j
|	jdd�}t�
|�dp~d}t||	j|d��|_t|d�|_|jj|_|S)	N��i�T)Zusegmtrz
text/plain)zContent-TypezContent-Lengthz
Last-Modified�rb)r�urlrZstatus_coder$�stat�OSError�raw�emailZutilsZ
formatdate�st_mtime�	mimetypesZ
guess_typer	�st_size�headers�open�close)
�self�request�stream�timeout�verify�certZproxies�pathnameZrespZstats�excZmodifiedZcontent_typer(r(r)�send�s&
�

zLocalFSAdapter.sendcCsdSr#r()rhr(r(r)rg�szLocalFSAdapter.close)NNNNN)�__name__�
__module__�__qualname__rprgr(r(r(r)rZ�s�
rZc@seZdZdd�ZdS)�InsecureHTTPAdaptercCsd|_d|_dS)NZ	CERT_NONE)Z	cert_reqsZca_certs)rhZconnr]rlrmr(r(r)�cert_verify�szInsecureHTTPAdapter.cert_verifyN)rqrrrsrur(r(r(r)rt�srtcsFeZdZdZ�fdd�Zd
dd�Zdd�Zd	d
�Z�fdd�Z�Z	S)�
PipSessionNc
s|�dd�}|�dd�}|�dg�}|�dd�}tt|�j||�g|_t�|jd<t|d�|_t	j
|d	d
ddgd
d�}|r�t|�s�t�
d|�d}|r�tt|�|d�}n
t|d�}t|d�}||_|�d|�|�d|�|�dt��|D]}	|j|	dd�q�dS)zj
        :param trusted_hosts: Domains not to emit warnings for when not using
            HTTPS.
        �retriesr�cacheN�
trusted_hosts�
index_urlsz
User-Agent)rzi�i�iig�?)ZtotalZstatus_forcelistZbackoff_factorz�The directory '%s' or its parent directory is not owned by the current user and the cache has been disabled. Please check the permissions and owner of that directory. If executing pip with sudo, you may want sudo's -H flag.)rx�max_retries)r{zhttps://zhttp://zfile://T)�suppress_logging)�pop�superrv�__init__�pip_trusted_originsrYrer
ZauthrZRetryr�logger�warningrrrrt�_insecure_adapter�mountrZ�add_trusted_host)
rh�args�kwargsrwrxryrzZsecure_adapterZinsecure_adapter�host��	__class__r(r)r�s@
���

zPipSession.__init__FcCs�|s.d�|�}|dk	r$|d�|�7}t�|�t|�}||jkrL|j�|�|�t|�d|j�|ds�|�t|�d|j�dS)z�
        :param host: It is okay to provide a host that has previously been
            added.
        :param source: An optional source string, for logging where the host
            string came from.
        zadding trusted host: {!r}Nz
 (from {})�/r:rG)	rWr��inforr��appendr�rr�)rhr��sourcer|�msgZ	host_portr(r(r)r�3s



�zPipSession.add_trusted_hostccs<tD]
}|Vq|jD] \}}d||dkr.dn|fVqdS)Nr!)�SECURE_ORIGINSr�)rh�
secure_originr��portr(r(r)�iter_secure_originsMszPipSession.iter_secure_originsc	Cs t�t|��}|j|j|j}}}|�dd�d}|��D]�}|\}}}	||kr\|dkr\q<zLt�	t
|tj�sv|dkrz|n|�
d��}
t�t
|tj�r�|n|�
d��}Wn4tk
r�|r�|��|��kr�|dkr�Yq<YnX|
|kr�q<||	k�r|	dk�r|	dk	�rq<dSt�d||�dS)	N�+r:���r!�utf8Tz�The repository located at %s is not a trusted or secure host and is being ignored. If this repository is available via HTTPS we recommend you use HTTPS instead, otherwise you may silence this warning and allow it anyway with '--trusted-host %s'.F)�urllib_parseZurlparser5ZschemeZhostnamer��rsplitr�rZ
ip_address�
isinstancerZ	text_type�decodeZ
ip_network�
ValueError�lowerr�r�)rh�locationZparsedZorigin_protocolZorigin_hostZorigin_portr�Zsecure_protocolZsecure_hostZsecure_portZaddrZnetworkr(r(r)�is_secure_originTs^�


���
�����
����	zPipSession.is_secure_origincs(|�d|j�tt|�j||f|�|�S)Nrk)rTrkr~rvri)rh�methodr]r�r�r�r(r)ri�szPipSession.request)NF)
rqrrrsrkrr�r�r�ri�
__classcell__r(r(r�r)rv�sT
Qrv)I�__doc__Zemail.utilsrarIZloggingrcr$rJrK�warningsrPrrrZpip._vendor.cachecontrolrZpip._vendor.requests.adaptersrrZpip._vendor.requests.modelsrZpip._vendor.requests.structuresr	Zpip._vendor.six.moves.urllibr
r�Zpip._vendor.urllib3.exceptionsrr.rZpip._internal.network.authr
Zpip._internal.network.cacherZpip._internal.utils.compatrrrZpip._internal.utils.filesystemrZpip._internal.utils.glibcrZpip._internal.utils.miscrrrZpip._internal.utils.typingrZpip._internal.utils.urlsr�typingrrrrrZpip._internal.models.linkrr5�intZSecureOriginZ	getLoggerrqr��filterwarningsr�r,r-rYrZrtZSessionrvr(r(r(r)�<module>sV
�O!site-packages/pip/_internal/network/__pycache__/cache.cpython-38.opt-1.pyc000064400000004566151446176770022417 0ustar00U

��.e��@s�dZddlZddlmZddlmZddlmZddlm	Z	m
Z
ddlmZddl
mZerhdd	lmZed
d��ZGdd
�d
e�ZdS)zHTTP cache implementation.
�N)�contextmanager)�	BaseCache)�	FileCache)�adjacent_tmp_file�replace)�
ensure_dir)�MYPY_CHECK_RUNNING)�Optionalc	cs(z
dVWnttfk
r"YnXdS)zvIf we can't access the cache then we can just skip caching and process
    requests as if caching wasn't enabled.
    N)�OSError�IOError�rr�?/usr/lib/python3.8/site-packages/pip/_internal/network/cache.py�suppressed_cache_errorss
rcs@eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Z�Z	S)�
SafeFileCachezw
    A file based cache which is safe to use even when the target directory may
    not be accessible or writable.
    cstt|���||_dS�N)�superr�__init__�	directory)�selfr��	__class__rr
r&szSafeFileCache.__init__cCs4t�|�}t|dd��|g}tjj|jf|��S)N�)r�encode�list�os�path�joinr)r�nameZhashed�partsrrr
�_get_cache_path,s
zSafeFileCache._get_cache_pathcCsR|�|�}t��8t|d��"}|��W5QR�W5QR�SQRXW5QRXdS)N�rb)rr�open�read)r�keyr�frrr
�get5s
zSafeFileCache.getc
CsZ|�|�}t��@ttj�|��t|��}|�|�W5QRXt|j	|�W5QRXdSr)
rrrrr�dirnamer�writerr)rr#�valuerr$rrr
�set<s

zSafeFileCache.setc	Cs*|�|�}t��t�|�W5QRXdSr)rrr�remove)rr#rrrr
�deleteGs
zSafeFileCache.delete)
�__name__�
__module__�__qualname__�__doc__rrr%r)r+�
__classcell__rrrr
r s	r)r/r�
contextlibrZpip._vendor.cachecontrol.cacherZpip._vendor.cachecontrol.cachesrZpip._internal.utils.filesystemrrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingr	rrrrrr
�<module>s

site-packages/pip/_internal/network/__pycache__/auth.cpython-38.opt-1.pyc000064400000015177151446176770022315 0ustar00U

��.eo+�
@sdZddlZddlmZmZddlmZddlmZ	ddl
mZmZm
Z
mZmZddlmZer�ddlmZdd	lmZmZmZdd
lmZeeeefZe�e�ZzddlZWnLe k
r�dZYn6e!k
r�Z"ze�#dee"��dZW5dZ"["XYnXdd
�Z$Gdd�de�Z%dS)z�Network Authentication Helpers

Contains interface (MultiDomainBasicAuth) and associated glue code for
providing credentials in the context of network requests.
�N)�AuthBase�
HTTPBasicAuth)�get_netrc_auth)�parse)�ask�	ask_input�ask_password�remove_auth_from_url�split_auth_netloc_from_url)�MYPY_CHECK_RUNNING)�Values)�Dict�Optional�Tuple)�AuthInfo�*Keyring is skipped due to an exception: %sc
Cs�|rtsdSz�z
tj}Wntk
r,Yn4Xt�d|�|||�}|dk	rZ|j|jfWSWdS|r�t�d|�t�||�}|r�||fWSWn2tk
r�}zt�	dt
|��W5d}~XYnXdS)z3Return the tuple auth for a given url from keyring.Nz'Getting credentials from keyring for %sz$Getting password from keyring for %sr)�keyring�get_credential�AttributeError�logger�debug�username�passwordZget_password�	Exception�warning�str)�urlrrZcredr�exc�r�>/usr/lib/python3.8/site-packages/pip/_internal/network/auth.py�get_keyring_auth.s,

�r c@s`eZdZddd�Zdd�Zddd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zdd�ZdS)�MultiDomainBasicAuthTNcCs||_||_i|_d|_dS)N)�	prompting�
index_urls�	passwords�_credentials_to_save)�selfr"r#rrr�__init__MszMultiDomainBasicAuth.__init__cCsB|r
|jsdS|jD](}t|��d�d}|�|�r|SqdS)a�Return the original index URL matching the requested URL.

        Cached or dynamically generated credentials may work against
        the original index URL rather than just the netloc.

        The provided url should have had its username and password
        removed already. If the original index url had credentials then
        they will be included in the return value.

        Returns None if no matching index was found, or if --no-index
        was specified by the user.
        N�/)r#r	�rstrip�
startswith)r&r�u�prefixrrr�_get_index_urlYs


z#MultiDomainBasicAuth._get_index_urlcCs�t|�\}}}|\}}|dk	r6|dk	r6t�d|�|S|�|�}	|	rft|	�}
|
rf|
\}	}}t�d|	�|	r�|ddk	r�|\}}|dk	r�|dk	r�t�d|�|S|r�t|�}
|
r�t�d|�|
S|r�t|	|�p�t||�}|r�t�d|�|S||fS)z2Find and return credentials for the specified URL.NzFound credentials in url for %szFound index url %srz%Found credentials in index url for %sz!Found credentials in netrc for %sz#Found credentials in keyring for %s)r
rrr-rr )r&�original_urlZallow_netrcZ
allow_keyringr�netlocZurl_user_passwordrrZ	index_urlZ
index_info�_Zindex_url_user_passwordZ
netrc_authZkr_authrrr�_get_new_credentialsns>�



�z)MultiDomainBasicAuth._get_new_credentialscCsvt|�\}}}|j�|d�\}}|dkr>|dkr>|�|�\}}|dk	sN|dk	rl|pTd}|p\d}||f|j|<|||fS)a_Return the credentials to use for the provided URL.

        If allowed, netrc and keyring may be used to obtain the
        correct credentials.

        Returns (url_without_credentials, username, password). Note
        that even if the original URL contains credentials, this
        function may return a different username and password.
        �NNN�)r
r$�getr1)r&r.rr/r0rrrrr�_get_url_and_credentials�s
	z-MultiDomainBasicAuth._get_url_and_credentialscCsH|�|j�\}}}||_|dk	r6|dk	r6t||�|�}|�d|j�|S)N�response)r5rr�
register_hook�
handle_401)r&�reqrrrrrr�__call__�szMultiDomainBasicAuth.__call__cCsFtd|�}|sdSt||�}|r4|d|ddfStd�}||dfS)Nz
User for %s: r2r�Fz
Password: T)rr r)r&r/rZauthrrrr�_prompt_for_password�s
z)MultiDomainBasicAuth._prompt_for_passwordcCstsdStdddg�dkS)NFz#Save credentials to keyring [y/N]: �y�n)rr)r&rrr� _should_save_password_to_keyring�sz5MultiDomainBasicAuth._should_save_password_to_keyringc	Ks�|jdkr|S|js|St�|j�}|�|j�\}}}d|_|dk	rv|dk	rv||f|j|j<|rv|�	�rv|j||f|_|j
|j��t
|p�d|p�d�|j�}|�d|j�|jr�|�d|j�|jj|f|�}|j�|�|S)N�r3r6)�status_coder"�urllib_parseZurlparserr<r/r%r$r?Zcontent�rawZrelease_connr�requestr7�warn_on_401�save_credentialsZ
connection�send�history�append)	r&�resp�kwargsZparsedrrZsaver9Znew_resprrrr8�s(

zMultiDomainBasicAuth.handle_401cKs|jdkrt�d|jj�dS)z6Response callback to warn about incorrect credentials.r@z)401 Error, Credentials not correct for %sN)rArrrDr)r&rJrKrrrrEs

�z MultiDomainBasicAuth.warn_on_401cKs^tsdS|j}d|_|rZ|jdkrZzt�d�tj|�Wntk
rXt�d�YnXdS)z1Response callback to save credentials on success.Ni�zSaving credentials to keyringzFailed to save credentials)rr%rAr�infoZset_passwordrZ	exception)r&rJrKZcredsrrrrFs
z%MultiDomainBasicAuth.save_credentials)TN)TT)
�__name__�
__module__�__qualname__r'r-r1r5r:r<r?r8rErFrrrrr!Ks
�
2(-r!)&�__doc__ZloggingZpip._vendor.requests.authrrZpip._vendor.requests.utilsrZpip._vendor.six.moves.urllibrrBZpip._internal.utils.miscrrrr	r
Zpip._internal.utils.typingrZoptparser�typingr
rrZ pip._internal.vcs.versioncontrolrrZCredentialsZ	getLoggerrMrr�ImportErrorrrrr r!rrrr�<module>s0	
�site-packages/pip/_internal/network/__pycache__/cache.cpython-38.pyc000064400000004671151446176770021455 0ustar00U

��.e��@s�dZddlZddlmZddlmZddlmZddlm	Z	m
Z
ddlmZddl
mZerhdd	lmZed
d��ZGdd
�d
e�ZdS)zHTTP cache implementation.
�N)�contextmanager)�	BaseCache)�	FileCache)�adjacent_tmp_file�replace)�
ensure_dir)�MYPY_CHECK_RUNNING)�Optionalc	cs(z
dVWnttfk
r"YnXdS)zvIf we can't access the cache then we can just skip caching and process
    requests as if caching wasn't enabled.
    N)�OSError�IOError�rr�?/usr/lib/python3.8/site-packages/pip/_internal/network/cache.py�suppressed_cache_errorss
rcs@eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Z�Z	S)�
SafeFileCachezw
    A file based cache which is safe to use even when the target directory may
    not be accessible or writable.
    cs(|dk	std��tt|���||_dS)Nz!Cache directory must not be None.)�AssertionError�superr�__init__�	directory)�selfr��	__class__rr
r&szSafeFileCache.__init__cCs4t�|�}t|dd��|g}tjj|jf|��S)N�)r�encode�list�os�path�joinr)r�nameZhashed�partsrrr
�_get_cache_path,s
zSafeFileCache._get_cache_pathcCsR|�|�}t��8t|d��"}|��W5QR�W5QR�SQRXW5QRXdS)N�rb)rr�open�read)r�keyr�frrr
�get5s
zSafeFileCache.getc
CsZ|�|�}t��@ttj�|��t|��}|�|�W5QRXt|j	|�W5QRXdS�N)
rrrrr�dirnamer�writerr)rr#�valuerr$rrr
�set<s

zSafeFileCache.setc	Cs*|�|�}t��t�|�W5QRXdSr&)rrr�remove)rr#rrrr
�deleteGs
zSafeFileCache.delete)
�__name__�
__module__�__qualname__�__doc__rrr%r*r,�
__classcell__rrrr
r s	r)r0r�
contextlibrZpip._vendor.cachecontrol.cacherZpip._vendor.cachecontrol.cachesrZpip._internal.utils.filesystemrrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingr	rrrrrr
�<module>s

site-packages/pip/_internal/network/__pycache__/__init__.cpython-38.pyc000064400000000324151446176770022140 0ustar00U

��.e2�@sdZdS)z+Contains purely network-related utilities.
N)�__doc__�rr�B/usr/lib/python3.8/site-packages/pip/_internal/network/__init__.py�<module>�site-packages/pip/_internal/network/__pycache__/xmlrpc.cpython-38.pyc000064400000003046151446176770021712 0ustar00U

��.e=�@sPdZddlZddlmZddlmZddlmZe�	e
�ZGdd�dej�Z
dS)z#xmlrpclib.Transport implementation
�N)�requests)�
xmlrpc_client)�parsec@s$eZdZdZddd�Zd	dd�ZdS)
�PipXmlrpcTransportzRProvide a `xmlrpclib.Transport` implementation via a `PipSession`
    object.
    FcCs*tj�||�t�|�}|j|_||_dS)N)r�	Transport�__init__�urllib_parseZurlparseZscheme�_scheme�_session)�selfZ	index_urlZsessionZuse_datetimeZindex_parts�r�@/usr/lib/python3.8/site-packages/pip/_internal/network/xmlrpc.pyrs
zPipXmlrpcTransport.__init__c

Cs�|j||dddf}t�|�}z8ddi}|jj|||dd�}|��||_|�|j�WSt	j
k
r�}	zt�d|	j
j|��W5d}	~	XYnXdS)NzContent-Typeztext/xmlT)�data�headers�streamzHTTP error %s while getting %s)r	rZ
urlunparser
ZpostZraise_for_status�verboseZparse_response�rawrZ	HTTPError�loggerZcritical�responseZstatus_code)
rZhostZhandlerZrequest_bodyr�partsZurlrr�excrrr
�requests$

��zPipXmlrpcTransport.requestN)F)F)�__name__�
__module__�__qualname__�__doc__rrrrrr
rs
r)rZloggingZpip._vendorrZpip._vendor.six.movesrZpip._vendor.six.moves.urllibrrZ	getLoggerrrrrrrrr
�<module>s
site-packages/pip/_internal/network/__init__.py000064400000000062151446176770015651 0ustar00"""Contains purely network-related utilities.
"""
site-packages/pip/_internal/network/cache.py000064400000004271151446176770015163 0ustar00"""HTTP cache implementation.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import os
from contextlib import contextmanager

from pip._vendor.cachecontrol.cache import BaseCache
from pip._vendor.cachecontrol.caches import FileCache

from pip._internal.utils.filesystem import adjacent_tmp_file, replace
from pip._internal.utils.misc import ensure_dir
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional


@contextmanager
def suppressed_cache_errors():
    """If we can't access the cache then we can just skip caching and process
    requests as if caching wasn't enabled.
    """
    try:
        yield
    except (OSError, IOError):
        pass


class SafeFileCache(BaseCache):
    """
    A file based cache which is safe to use even when the target directory may
    not be accessible or writable.
    """

    def __init__(self, directory):
        # type: (str) -> None
        assert directory is not None, "Cache directory must not be None."
        super(SafeFileCache, self).__init__()
        self.directory = directory

    def _get_cache_path(self, name):
        # type: (str) -> str
        # From cachecontrol.caches.file_cache.FileCache._fn, brought into our
        # class for backwards-compatibility and to avoid using a non-public
        # method.
        hashed = FileCache.encode(name)
        parts = list(hashed[:5]) + [hashed]
        return os.path.join(self.directory, *parts)

    def get(self, key):
        # type: (str) -> Optional[bytes]
        path = self._get_cache_path(key)
        with suppressed_cache_errors():
            with open(path, 'rb') as f:
                return f.read()

    def set(self, key, value):
        # type: (str, bytes) -> None
        path = self._get_cache_path(key)
        with suppressed_cache_errors():
            ensure_dir(os.path.dirname(path))

            with adjacent_tmp_file(path) as f:
                f.write(value)

            replace(f.name, path)

    def delete(self, key):
        # type: (str) -> None
        path = self._get_cache_path(key)
        with suppressed_cache_errors():
            os.remove(path)
site-packages/pip/_internal/network/xmlrpc.py000064400000003075151446176770015426 0ustar00"""xmlrpclib.Transport implementation
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import logging

from pip._vendor import requests
# NOTE: XMLRPC Client is not annotated in typeshed as on 2017-07-17, which is
#       why we ignore the type on this import
from pip._vendor.six.moves import xmlrpc_client  # type: ignore
from pip._vendor.six.moves.urllib import parse as urllib_parse

logger = logging.getLogger(__name__)


class PipXmlrpcTransport(xmlrpc_client.Transport):
    """Provide a `xmlrpclib.Transport` implementation via a `PipSession`
    object.
    """

    def __init__(self, index_url, session, use_datetime=False):
        xmlrpc_client.Transport.__init__(self, use_datetime)
        index_parts = urllib_parse.urlparse(index_url)
        self._scheme = index_parts.scheme
        self._session = session

    def request(self, host, handler, request_body, verbose=False):
        parts = (self._scheme, host, handler, None, None, None)
        url = urllib_parse.urlunparse(parts)
        try:
            headers = {'Content-Type': 'text/xml'}
            response = self._session.post(url, data=request_body,
                                          headers=headers, stream=True)
            response.raise_for_status()
            self.verbose = verbose
            return self.parse_response(response.raw)
        except requests.HTTPError as exc:
            logger.critical(
                "HTTP error %s while getting %s",
                exc.response.status_code, url,
            )
            raise
site-packages/pip/_internal/distributions/base.py000064400000002124151446176770016236 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import abc

from pip._vendor.six import add_metaclass


@add_metaclass(abc.ABCMeta)
class AbstractDistribution(object):
    """A base class for handling installable artifacts.

    The requirements for anything installable are as follows:

     - we must be able to determine the requirement name
       (or we can't correctly handle the non-upgrade case).

     - for packages with setup requirements, we must also be able
       to determine their requirements without installing additional
       packages (for the same reason as run-time dependencies)

     - we must be able to create a Distribution object exposing the
       above metadata.
    """

    def __init__(self, req):
        super(AbstractDistribution, self).__init__()
        self.req = req

    @abc.abstractmethod
    def get_pkg_resources_distribution(self):
        raise NotImplementedError()

    @abc.abstractmethod
    def prepare_distribution_metadata(self, finder, build_isolation):
        raise NotImplementedError()
site-packages/pip/_internal/distributions/source/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000252151446176770025610 0ustar00U

��.e�@sdS)N�rrr�O/usr/lib/python3.8/site-packages/pip/_internal/distributions/source/__init__.py�<module>�site-packages/pip/_internal/distributions/source/__pycache__/legacy.cpython-38.pyc000064400000006617151446176770024371 0ustar00U

��.ee�@sVddlZddlmZddlmZddlmZddlmZe�	e
�ZGdd�de�ZdS)�N)�BuildEnvironment)�AbstractDistribution)�InstallationError)�runner_with_spinner_messagec@s(eZdZdZdd�Zdd�Zdd�ZdS)	�SourceDistributiona�Represents a source distribution.

    The preparation step for these needs metadata for the packages to be
    generated, either using PEP 517 or using the legacy `setup.py egg_info`.

    NOTE from @pradyunsg (14 June 2019)
    I expect SourceDistribution class will need to be split into
    `legacy_source` (setup.py based) and `source` (PEP 517 based) when we start
    bringing logic for preparation out of InstallRequirement into this class.
    cCs
|j��S�N)�reqZget_dist)�self�r
�M/usr/lib/python3.8/site-packages/pip/_internal/distributions/source/legacy.py�get_pkg_resources_distributionsz1SourceDistribution.get_pkg_resources_distributioncCs<|j��|jjo|}|r$|�|�|j��|j��dSr)rZload_pyproject_tomlZ
use_pep517�_setup_isolationZprepare_metadataZassert_source_matches_version)r	�finderZbuild_isolationZshould_isolater
r
r�prepare_distribution_metadatas


z0SourceDistribution.prepare_distribution_metadatac
s���fdd�}t��j_�jj�|�jjdd��jj��jj�\�}�rT|d��|r�t�d�j�t�dd�	t
tt|�����jj�4t
d	�}�jj}|�|��|��}W5QRXW5QRX�jj�|�\�}�r�|d
���jj�||dd�dS)
Ncs6d}|j�j|d�dd�t��D��d�}t|��dS)NzZSome build dependencies for {requirement} conflict with {conflicting_with}: {description}.z, css|]\}}d||fVqdS)z%s is incompatible with %sNr
)�.0Z	installedZwantedr
r
r�	<genexpr>3s�zPSourceDistribution._setup_isolation.<locals>._raise_conflicts.<locals>.<genexpr>)Zrequirement�conflicting_with�description)�formatr�join�sortedr)rZconflicting_reqs�
format_stringZ
error_message�Zconflictingr	r
r�_raise_conflicts+s�
��z=SourceDistribution._setup_isolation.<locals>._raise_conflictsZoverlayzInstalling build dependenciesz"PEP 517/518 supported requirementsz4Missing build requirements in pyproject.toml for %s.z`The project does not specify a build backend, and pip cannot fall back to setuptools without %s.z and z#Getting requirements to build wheelzthe backend dependenciesZnormalzInstalling backend dependencies)rrZ	build_envZinstall_requirementsZpyproject_requiresZcheck_requirementsZrequirements_to_check�loggerZwarningr�map�reprrrZpep517_backendZsubprocess_runnerZget_requires_for_build_wheel)r	rrZmissingZrunnerZbackendZreqsr
rrr
*sP
�����
�
�z#SourceDistribution._setup_isolationN)�__name__�
__module__�__qualname__�__doc__rrr
r
r
r
rrs
r)
ZloggingZpip._internal.build_envrZ pip._internal.distributions.baserZpip._internal.exceptionsrZpip._internal.utils.subprocessrZ	getLoggerrrrr
r
r
r�<module>s
site-packages/pip/_internal/distributions/source/__pycache__/legacy.cpython-38.opt-1.pyc000064400000006617151446176770025330 0ustar00U

��.ee�@sVddlZddlmZddlmZddlmZddlmZe�	e
�ZGdd�de�ZdS)�N)�BuildEnvironment)�AbstractDistribution)�InstallationError)�runner_with_spinner_messagec@s(eZdZdZdd�Zdd�Zdd�ZdS)	�SourceDistributiona�Represents a source distribution.

    The preparation step for these needs metadata for the packages to be
    generated, either using PEP 517 or using the legacy `setup.py egg_info`.

    NOTE from @pradyunsg (14 June 2019)
    I expect SourceDistribution class will need to be split into
    `legacy_source` (setup.py based) and `source` (PEP 517 based) when we start
    bringing logic for preparation out of InstallRequirement into this class.
    cCs
|j��S�N)�reqZget_dist)�self�r
�M/usr/lib/python3.8/site-packages/pip/_internal/distributions/source/legacy.py�get_pkg_resources_distributionsz1SourceDistribution.get_pkg_resources_distributioncCs<|j��|jjo|}|r$|�|�|j��|j��dSr)rZload_pyproject_tomlZ
use_pep517�_setup_isolationZprepare_metadataZassert_source_matches_version)r	�finderZbuild_isolationZshould_isolater
r
r�prepare_distribution_metadatas


z0SourceDistribution.prepare_distribution_metadatac
s���fdd�}t��j_�jj�|�jjdd��jj��jj�\�}�rT|d��|r�t�d�j�t�dd�	t
tt|�����jj�4t
d	�}�jj}|�|��|��}W5QRXW5QRX�jj�|�\�}�r�|d
���jj�||dd�dS)
Ncs6d}|j�j|d�dd�t��D��d�}t|��dS)NzZSome build dependencies for {requirement} conflict with {conflicting_with}: {description}.z, css|]\}}d||fVqdS)z%s is incompatible with %sNr
)�.0Z	installedZwantedr
r
r�	<genexpr>3s�zPSourceDistribution._setup_isolation.<locals>._raise_conflicts.<locals>.<genexpr>)Zrequirement�conflicting_with�description)�formatr�join�sortedr)rZconflicting_reqs�
format_stringZ
error_message�Zconflictingr	r
r�_raise_conflicts+s�
��z=SourceDistribution._setup_isolation.<locals>._raise_conflictsZoverlayzInstalling build dependenciesz"PEP 517/518 supported requirementsz4Missing build requirements in pyproject.toml for %s.z`The project does not specify a build backend, and pip cannot fall back to setuptools without %s.z and z#Getting requirements to build wheelzthe backend dependenciesZnormalzInstalling backend dependencies)rrZ	build_envZinstall_requirementsZpyproject_requiresZcheck_requirementsZrequirements_to_check�loggerZwarningr�map�reprrrZpep517_backendZsubprocess_runnerZget_requires_for_build_wheel)r	rrZmissingZrunnerZbackendZreqsr
rrr
*sP
�����
�
�z#SourceDistribution._setup_isolationN)�__name__�
__module__�__qualname__�__doc__rrr
r
r
r
rrs
r)
ZloggingZpip._internal.build_envrZ pip._internal.distributions.baserZpip._internal.exceptionsrZpip._internal.utils.subprocessrZ	getLoggerrrrr
r
r
r�<module>s
site-packages/pip/_internal/distributions/source/__pycache__/__init__.cpython-38.pyc000064400000000252151446176770024651 0ustar00U

��.e�@sdS)N�rrr�O/usr/lib/python3.8/site-packages/pip/_internal/distributions/source/__init__.py�<module>�site-packages/pip/_internal/distributions/source/__init__.py000064400000000000151446176770020352 0ustar00site-packages/pip/_internal/distributions/source/legacy.py000064400000007545151446176770020104 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import logging

from pip._internal.build_env import BuildEnvironment
from pip._internal.distributions.base import AbstractDistribution
from pip._internal.exceptions import InstallationError
from pip._internal.utils.subprocess import runner_with_spinner_message

logger = logging.getLogger(__name__)


class SourceDistribution(AbstractDistribution):
    """Represents a source distribution.

    The preparation step for these needs metadata for the packages to be
    generated, either using PEP 517 or using the legacy `setup.py egg_info`.

    NOTE from @pradyunsg (14 June 2019)
    I expect SourceDistribution class will need to be split into
    `legacy_source` (setup.py based) and `source` (PEP 517 based) when we start
    bringing logic for preparation out of InstallRequirement into this class.
    """

    def get_pkg_resources_distribution(self):
        return self.req.get_dist()

    def prepare_distribution_metadata(self, finder, build_isolation):
        # Prepare for building. We need to:
        #   1. Load pyproject.toml (if it exists)
        #   2. Set up the build environment

        self.req.load_pyproject_toml()
        should_isolate = self.req.use_pep517 and build_isolation
        if should_isolate:
            self._setup_isolation(finder)

        self.req.prepare_metadata()
        self.req.assert_source_matches_version()

    def _setup_isolation(self, finder):
        def _raise_conflicts(conflicting_with, conflicting_reqs):
            format_string = (
                "Some build dependencies for {requirement} "
                "conflict with {conflicting_with}: {description}."
            )
            error_message = format_string.format(
                requirement=self.req,
                conflicting_with=conflicting_with,
                description=', '.join(
                    '%s is incompatible with %s' % (installed, wanted)
                    for installed, wanted in sorted(conflicting)
                )
            )
            raise InstallationError(error_message)

        # Isolate in a BuildEnvironment and install the build-time
        # requirements.
        self.req.build_env = BuildEnvironment()
        self.req.build_env.install_requirements(
            finder, self.req.pyproject_requires, 'overlay',
            "Installing build dependencies"
        )
        conflicting, missing = self.req.build_env.check_requirements(
            self.req.requirements_to_check
        )
        if conflicting:
            _raise_conflicts("PEP 517/518 supported requirements",
                             conflicting)
        if missing:
            logger.warning(
                "Missing build requirements in pyproject.toml for %s.",
                self.req,
            )
            logger.warning(
                "The project does not specify a build backend, and "
                "pip cannot fall back to setuptools without %s.",
                " and ".join(map(repr, sorted(missing)))
            )
        # Install any extra build dependencies that the backend requests.
        # This must be done in a second pass, as the pyproject.toml
        # dependencies must be installed before we can call the backend.
        with self.req.build_env:
            runner = runner_with_spinner_message(
                "Getting requirements to build wheel"
            )
            backend = self.req.pep517_backend
            with backend.subprocess_runner(runner):
                reqs = backend.get_requires_for_build_wheel()

        conflicting, missing = self.req.build_env.check_requirements(reqs)
        if conflicting:
            _raise_conflicts("the backend dependencies", conflicting)
        self.req.build_env.install_requirements(
            finder, missing, 'normal',
            "Installing backend dependencies"
        )
site-packages/pip/_internal/distributions/wheel.py000064400000001150151446176770016426 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from pip._vendor import pkg_resources

from pip._internal.distributions.base import AbstractDistribution


class WheelDistribution(AbstractDistribution):
    """Represents a wheel distribution.

    This does not need any preparation as wheels can be directly unpacked.
    """

    def get_pkg_resources_distribution(self):
        return list(pkg_resources.find_distributions(
                    self.req.source_dir))[0]

    def prepare_distribution_metadata(self, finder, build_isolation):
        pass
site-packages/pip/_internal/distributions/__pycache__/wheel.cpython-38.opt-1.pyc000064400000002000151446176770023646 0ustar00U

��.eh�@s,ddlmZddlmZGdd�de�ZdS)�)�
pkg_resources)�AbstractDistributionc@s eZdZdZdd�Zdd�ZdS)�WheelDistributionzqRepresents a wheel distribution.

    This does not need any preparation as wheels can be directly unpacked.
    cCstt�|jj��dS)Nr)�listr�find_distributionsZreqZ
source_dir)�self�r�E/usr/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py�get_pkg_resources_distributions
��z0WheelDistribution.get_pkg_resources_distributioncCsdS)Nr)r�finderZbuild_isolationrrr	�prepare_distribution_metadatasz/WheelDistribution.prepare_distribution_metadataN)�__name__�
__module__�__qualname__�__doc__r
rrrrr	r	srN)Zpip._vendorrZ pip._internal.distributions.baserrrrrr	�<module>ssite-packages/pip/_internal/distributions/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001464151446176770024316 0ustar00U

��.e��@sLddlmZddlmZddlmZer@ddlmZddlm	Z	dd�Z
dS)	�)�SourceDistribution)�WheelDistribution)�MYPY_CHECK_RUNNING)�AbstractDistribution)�InstallRequirementcCs$|jrt|�S|jrt|�St|�S)z<Returns a Distribution for the given InstallRequirement
    )ZeditablerZis_wheelr)Zinstall_req�r�H/usr/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py�)make_distribution_for_install_requirement
s
r	N)Z)pip._internal.distributions.source.legacyrZ!pip._internal.distributions.wheelrZpip._internal.utils.typingrZ pip._internal.distributions.baserZpip._internal.req.req_installrr	rrrr�<module>ssite-packages/pip/_internal/distributions/__pycache__/installed.cpython-38.opt-1.pyc000064400000001700151446176770024527 0ustar00U

��.e�@s ddlmZGdd�de�ZdS)�)�AbstractDistributionc@s eZdZdZdd�Zdd�ZdS)�InstalledDistributionz�Represents an installed package.

    This does not need any preparation as the required information has already
    been computed.
    cCs|jjS�N)ZreqZsatisfied_by)�self�r�I/usr/lib/python3.8/site-packages/pip/_internal/distributions/installed.py�get_pkg_resources_distributionsz4InstalledDistribution.get_pkg_resources_distributioncCsdSrr)r�finderZbuild_isolationrrr�prepare_distribution_metadatasz3InstalledDistribution.prepare_distribution_metadataN)�__name__�
__module__�__qualname__�__doc__rr
rrrrrsrN)Z pip._internal.distributions.baserrrrrr�<module>ssite-packages/pip/_internal/distributions/__pycache__/base.cpython-38.pyc000064400000003124151446176770022525 0ustar00U

��.eT�@s2ddlZddlmZeej�Gdd�de��ZdS)�N)�
add_metaclasscs<eZdZdZ�fdd�Zejdd��Zejdd��Z�Z	S)�AbstractDistributiona
A base class for handling installable artifacts.

    The requirements for anything installable are as follows:

     - we must be able to determine the requirement name
       (or we can't correctly handle the non-upgrade case).

     - for packages with setup requirements, we must also be able
       to determine their requirements without installing additional
       packages (for the same reason as run-time dependencies)

     - we must be able to create a Distribution object exposing the
       above metadata.
    cstt|���||_dS�N)�superr�__init__�req)�selfr��	__class__��D/usr/lib/python3.8/site-packages/pip/_internal/distributions/base.pyrszAbstractDistribution.__init__cCs
t��dSr��NotImplementedError)rrrr�get_pkg_resources_distributionsz3AbstractDistribution.get_pkg_resources_distributioncCs
t��dSrr
)r�finderZbuild_isolationrrr�prepare_distribution_metadata"sz2AbstractDistribution.prepare_distribution_metadata)
�__name__�
__module__�__qualname__�__doc__r�abc�abstractmethodrr�
__classcell__rrr	rr	s
r)rZpip._vendor.sixr�ABCMeta�objectrrrrr�<module>ssite-packages/pip/_internal/distributions/__pycache__/installed.cpython-38.pyc000064400000001700151446176770023570 0ustar00U

��.e�@s ddlmZGdd�de�ZdS)�)�AbstractDistributionc@s eZdZdZdd�Zdd�ZdS)�InstalledDistributionz�Represents an installed package.

    This does not need any preparation as the required information has already
    been computed.
    cCs|jjS�N)ZreqZsatisfied_by)�self�r�I/usr/lib/python3.8/site-packages/pip/_internal/distributions/installed.py�get_pkg_resources_distributionsz4InstalledDistribution.get_pkg_resources_distributioncCsdSrr)r�finderZbuild_isolationrrr�prepare_distribution_metadatasz3InstalledDistribution.prepare_distribution_metadataN)�__name__�
__module__�__qualname__�__doc__rr
rrrrrsrN)Z pip._internal.distributions.baserrrrrr�<module>ssite-packages/pip/_internal/distributions/__pycache__/base.cpython-38.opt-1.pyc000064400000003124151446176770023464 0ustar00U

��.eT�@s2ddlZddlmZeej�Gdd�de��ZdS)�N)�
add_metaclasscs<eZdZdZ�fdd�Zejdd��Zejdd��Z�Z	S)�AbstractDistributiona
A base class for handling installable artifacts.

    The requirements for anything installable are as follows:

     - we must be able to determine the requirement name
       (or we can't correctly handle the non-upgrade case).

     - for packages with setup requirements, we must also be able
       to determine their requirements without installing additional
       packages (for the same reason as run-time dependencies)

     - we must be able to create a Distribution object exposing the
       above metadata.
    cstt|���||_dS�N)�superr�__init__�req)�selfr��	__class__��D/usr/lib/python3.8/site-packages/pip/_internal/distributions/base.pyrszAbstractDistribution.__init__cCs
t��dSr��NotImplementedError)rrrr�get_pkg_resources_distributionsz3AbstractDistribution.get_pkg_resources_distributioncCs
t��dSrr
)r�finderZbuild_isolationrrr�prepare_distribution_metadata"sz2AbstractDistribution.prepare_distribution_metadata)
�__name__�
__module__�__qualname__�__doc__r�abc�abstractmethodrr�
__classcell__rrr	rr	s
r)rZpip._vendor.sixr�ABCMeta�objectrrrrr�<module>ssite-packages/pip/_internal/distributions/__pycache__/wheel.cpython-38.pyc000064400000002000151446176770022707 0ustar00U

��.eh�@s,ddlmZddlmZGdd�de�ZdS)�)�
pkg_resources)�AbstractDistributionc@s eZdZdZdd�Zdd�ZdS)�WheelDistributionzqRepresents a wheel distribution.

    This does not need any preparation as wheels can be directly unpacked.
    cCstt�|jj��dS)Nr)�listr�find_distributionsZreqZ
source_dir)�self�r�E/usr/lib/python3.8/site-packages/pip/_internal/distributions/wheel.py�get_pkg_resources_distributions
��z0WheelDistribution.get_pkg_resources_distributioncCsdS)Nr)r�finderZbuild_isolationrrr	�prepare_distribution_metadatasz/WheelDistribution.prepare_distribution_metadataN)�__name__�
__module__�__qualname__�__doc__r
rrrrr	r	srN)Zpip._vendorrZ pip._internal.distributions.baserrrrrr	�<module>ssite-packages/pip/_internal/distributions/__pycache__/__init__.cpython-38.pyc000064400000001464151446176770023357 0ustar00U

��.e��@sLddlmZddlmZddlmZer@ddlmZddlm	Z	dd�Z
dS)	�)�SourceDistribution)�WheelDistribution)�MYPY_CHECK_RUNNING)�AbstractDistribution)�InstallRequirementcCs$|jrt|�S|jrt|�St|�S)z<Returns a Distribution for the given InstallRequirement
    )ZeditablerZis_wheelr)Zinstall_req�r�H/usr/lib/python3.8/site-packages/pip/_internal/distributions/__init__.py�)make_distribution_for_install_requirement
s
r	N)Z)pip._internal.distributions.source.legacyrZ!pip._internal.distributions.wheelrZpip._internal.utils.typingrZ pip._internal.distributions.baserZpip._internal.req.req_installrr	rrrr�<module>ssite-packages/pip/_internal/distributions/__init__.py000064400000001707151446176770017071 0ustar00from pip._internal.distributions.source.legacy import SourceDistribution
from pip._internal.distributions.wheel import WheelDistribution
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from pip._internal.distributions.base import AbstractDistribution
    from pip._internal.req.req_install import InstallRequirement


def make_distribution_for_install_requirement(install_req):
    # type: (InstallRequirement) -> AbstractDistribution
    """Returns a Distribution for the given InstallRequirement
    """
    # Editable requirements will always be source distributions. They use the
    # legacy logic until we create a modern standard for them.
    if install_req.editable:
        return SourceDistribution(install_req)

    # If it's a wheel, it's a WheelDistribution
    if install_req.is_wheel:
        return WheelDistribution(install_req)

    # Otherwise, a SourceDistribution
    return SourceDistribution(install_req)
site-packages/pip/_internal/distributions/installed.py000064400000001036151446176770017304 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from pip._internal.distributions.base import AbstractDistribution


class InstalledDistribution(AbstractDistribution):
    """Represents an installed package.

    This does not need any preparation as the required information has already
    been computed.
    """

    def get_pkg_resources_distribution(self):
        return self.req.satisfied_by

    def prepare_distribution_metadata(self, finder, build_isolation):
        pass
site-packages/pip/_internal/download.py000064400000050505151446176770014237 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import cgi
import logging
import mimetypes
import os
import re
import shutil
import sys

from pip._vendor import requests
from pip._vendor.requests.models import CONTENT_CHUNK_SIZE, Response
from pip._vendor.six import PY2
from pip._vendor.six.moves.urllib import parse as urllib_parse

from pip._internal.exceptions import HashMismatch, InstallationError
from pip._internal.models.index import PyPI
from pip._internal.network.session import PipSession
from pip._internal.utils.encoding import auto_decode
from pip._internal.utils.filesystem import copy2_fixed
from pip._internal.utils.misc import (
    ask_path_exists,
    backup_dir,
    consume,
    display_path,
    format_size,
    hide_url,
    path_to_display,
    rmtree,
    splitext,
)
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.ui import DownloadProgressProvider
from pip._internal.utils.unpacking import unpack_file
from pip._internal.utils.urls import get_url_scheme
from pip._internal.vcs import vcs

if MYPY_CHECK_RUNNING:
    from typing import (
        IO, Callable, List, Optional, Text, Tuple,
    )

    from mypy_extensions import TypedDict

    from pip._internal.models.link import Link
    from pip._internal.utils.hashes import Hashes
    from pip._internal.vcs.versioncontrol import VersionControl

    if PY2:
        CopytreeKwargs = TypedDict(
            'CopytreeKwargs',
            {
                'ignore': Callable[[str, List[str]], List[str]],
                'symlinks': bool,
            },
            total=False,
        )
    else:
        CopytreeKwargs = TypedDict(
            'CopytreeKwargs',
            {
                'copy_function': Callable[[str, str], None],
                'ignore': Callable[[str, List[str]], List[str]],
                'ignore_dangling_symlinks': bool,
                'symlinks': bool,
            },
            total=False,
        )


__all__ = ['get_file_content',
           'unpack_vcs_link',
           'unpack_file_url',
           'unpack_http_url', 'unpack_url',
           'parse_content_disposition', 'sanitize_content_filename']


logger = logging.getLogger(__name__)


def get_file_content(url, comes_from=None, session=None):
    # type: (str, Optional[str], Optional[PipSession]) -> Tuple[str, Text]
    """Gets the content of a file; it may be a filename, file: URL, or
    http: URL.  Returns (location, content).  Content is unicode.

    :param url:         File path or url.
    :param comes_from:  Origin description of requirements.
    :param session:     Instance of pip.download.PipSession.
    """
    if session is None:
        raise TypeError(
            "get_file_content() missing 1 required keyword argument: 'session'"
        )

    scheme = get_url_scheme(url)

    if scheme in ['http', 'https']:
        # FIXME: catch some errors
        resp = session.get(url)
        resp.raise_for_status()
        return resp.url, resp.text

    elif scheme == 'file':
        if comes_from and comes_from.startswith('http'):
            raise InstallationError(
                'Requirements file %s references URL %s, which is local'
                % (comes_from, url))

        path = url.split(':', 1)[1]
        path = path.replace('\\', '/')
        match = _url_slash_drive_re.match(path)
        if match:
            path = match.group(1) + ':' + path.split('|', 1)[1]
        path = urllib_parse.unquote(path)
        if path.startswith('/'):
            path = '/' + path.lstrip('/')
        url = path

    try:
        with open(url, 'rb') as f:
            content = auto_decode(f.read())
    except IOError as exc:
        raise InstallationError(
            'Could not open requirements file: %s' % str(exc)
        )
    return url, content


_url_slash_drive_re = re.compile(r'/*([a-z])\|', re.I)


def unpack_vcs_link(link, location):
    # type: (Link, str) -> None
    vcs_backend = _get_used_vcs_backend(link)
    assert vcs_backend is not None
    vcs_backend.unpack(location, url=hide_url(link.url))


def _get_used_vcs_backend(link):
    # type: (Link) -> Optional[VersionControl]
    """
    Return a VersionControl object or None.
    """
    for vcs_backend in vcs.backends:
        if link.scheme in vcs_backend.schemes:
            return vcs_backend
    return None


def _progress_indicator(iterable, *args, **kwargs):
    return iterable


def _download_url(
    resp,  # type: Response
    link,  # type: Link
    content_file,  # type: IO
    hashes,  # type: Optional[Hashes]
    progress_bar  # type: str
):
    # type: (...) -> None
    try:
        total_length = int(resp.headers['content-length'])
    except (ValueError, KeyError, TypeError):
        total_length = 0

    cached_resp = getattr(resp, "from_cache", False)
    if logger.getEffectiveLevel() > logging.INFO:
        show_progress = False
    elif cached_resp:
        show_progress = False
    elif total_length > (40 * 1000):
        show_progress = True
    elif not total_length:
        show_progress = True
    else:
        show_progress = False

    show_url = link.show_url

    def resp_read(chunk_size):
        try:
            # Special case for urllib3.
            for chunk in resp.raw.stream(
                    chunk_size,
                    # We use decode_content=False here because we don't
                    # want urllib3 to mess with the raw bytes we get
                    # from the server. If we decompress inside of
                    # urllib3 then we cannot verify the checksum
                    # because the checksum will be of the compressed
                    # file. This breakage will only occur if the
                    # server adds a Content-Encoding header, which
                    # depends on how the server was configured:
                    # - Some servers will notice that the file isn't a
                    #   compressible file and will leave the file alone
                    #   and with an empty Content-Encoding
                    # - Some servers will notice that the file is
                    #   already compressed and will leave the file
                    #   alone and will add a Content-Encoding: gzip
                    #   header
                    # - Some servers won't notice anything at all and
                    #   will take a file that's already been compressed
                    #   and compress it again and set the
                    #   Content-Encoding: gzip header
                    #
                    # By setting this not to decode automatically we
                    # hope to eliminate problems with the second case.
                    decode_content=False):
                yield chunk
        except AttributeError:
            # Standard file-like object.
            while True:
                chunk = resp.raw.read(chunk_size)
                if not chunk:
                    break
                yield chunk

    def written_chunks(chunks):
        for chunk in chunks:
            content_file.write(chunk)
            yield chunk

    progress_indicator = _progress_indicator

    if link.netloc == PyPI.netloc:
        url = show_url
    else:
        url = link.url_without_fragment

    if show_progress:  # We don't show progress on cached responses
        progress_indicator = DownloadProgressProvider(progress_bar,
                                                      max=total_length)
        if total_length:
            logger.info("Downloading %s (%s)", url, format_size(total_length))
        else:
            logger.info("Downloading %s", url)
    elif cached_resp:
        logger.info("Using cached %s", url)
    else:
        logger.info("Downloading %s", url)

    downloaded_chunks = written_chunks(
        progress_indicator(
            resp_read(CONTENT_CHUNK_SIZE),
            CONTENT_CHUNK_SIZE
        )
    )
    if hashes:
        hashes.check_against_chunks(downloaded_chunks)
    else:
        consume(downloaded_chunks)


def _copy_file(filename, location, link):
    copy = True
    download_location = os.path.join(location, link.filename)
    if os.path.exists(download_location):
        response = ask_path_exists(
            'The file %s exists. (i)gnore, (w)ipe, (b)ackup, (a)abort' %
            display_path(download_location), ('i', 'w', 'b', 'a'))
        if response == 'i':
            copy = False
        elif response == 'w':
            logger.warning('Deleting %s', display_path(download_location))
            os.remove(download_location)
        elif response == 'b':
            dest_file = backup_dir(download_location)
            logger.warning(
                'Backing up %s to %s',
                display_path(download_location),
                display_path(dest_file),
            )
            shutil.move(download_location, dest_file)
        elif response == 'a':
            sys.exit(-1)
    if copy:
        shutil.copy(filename, download_location)
        logger.info('Saved %s', display_path(download_location))


def unpack_http_url(
    link,  # type: Link
    location,  # type: str
    download_dir=None,  # type: Optional[str]
    session=None,  # type: Optional[PipSession]
    hashes=None,  # type: Optional[Hashes]
    progress_bar="on"  # type: str
):
    # type: (...) -> None
    if session is None:
        raise TypeError(
            "unpack_http_url() missing 1 required keyword argument: 'session'"
        )

    with TempDirectory(kind="unpack") as temp_dir:
        # If a download dir is specified, is the file already downloaded there?
        already_downloaded_path = None
        if download_dir:
            already_downloaded_path = _check_download_dir(link,
                                                          download_dir,
                                                          hashes)

        if already_downloaded_path:
            from_path = already_downloaded_path
            content_type = mimetypes.guess_type(from_path)[0]
        else:
            # let's download to a tmp dir
            from_path, content_type = _download_http_url(link,
                                                         session,
                                                         temp_dir.path,
                                                         hashes,
                                                         progress_bar)

        # unpack the archive to the build dir location. even when only
        # downloading archives, they have to be unpacked to parse dependencies
        unpack_file(from_path, location, content_type)

        # a download dir is specified; let's copy the archive there
        if download_dir and not already_downloaded_path:
            _copy_file(from_path, download_dir, link)

        if not already_downloaded_path:
            os.unlink(from_path)


def _copy2_ignoring_special_files(src, dest):
    # type: (str, str) -> None
    """Copying special files is not supported, but as a convenience to users
    we skip errors copying them. This supports tools that may create e.g.
    socket files in the project source directory.
    """
    try:
        copy2_fixed(src, dest)
    except shutil.SpecialFileError as e:
        # SpecialFileError may be raised due to either the source or
        # destination. If the destination was the cause then we would actually
        # care, but since the destination directory is deleted prior to
        # copy we ignore all of them assuming it is caused by the source.
        logger.warning(
            "Ignoring special file error '%s' encountered copying %s to %s.",
            str(e),
            path_to_display(src),
            path_to_display(dest),
        )


def _copy_source_tree(source, target):
    # type: (str, str) -> None
    target_abspath = os.path.abspath(target)
    target_basename = os.path.basename(target_abspath)
    target_dirname = os.path.dirname(target_abspath)

    def ignore(d, names):
        skipped = []  # type: List[str]
        if d == source:
            # Pulling in those directories can potentially be very slow,
            # exclude the following directories if they appear in the top
            # level dir (and only it).
            # See discussion at https://github.com/pypa/pip/pull/6770
            skipped += ['.tox', '.nox']
        if os.path.abspath(d) == target_dirname:
            # Prevent an infinite recursion if the target is in source.
            # This can happen when TMPDIR is set to ${PWD}/...
            # and we copy PWD to TMPDIR.
            skipped += [target_basename]
        return skipped

    kwargs = dict(ignore=ignore, symlinks=True)  # type: CopytreeKwargs

    if not PY2:
        # Python 2 does not support copy_function, so we only ignore
        # errors on special file copy in Python 3.
        kwargs['copy_function'] = _copy2_ignoring_special_files

    shutil.copytree(source, target, **kwargs)


def unpack_file_url(
    link,  # type: Link
    location,  # type: str
    download_dir=None,  # type: Optional[str]
    hashes=None  # type: Optional[Hashes]
):
    # type: (...) -> None
    """Unpack link into location.

    If download_dir is provided and link points to a file, make a copy
    of the link file inside download_dir.
    """
    link_path = link.file_path
    # If it's a url to a local directory
    if link.is_existing_dir():
        if os.path.isdir(location):
            rmtree(location)
        _copy_source_tree(link_path, location)
        if download_dir:
            logger.info('Link is a directory, ignoring download_dir')
        return

    # If --require-hashes is off, `hashes` is either empty, the
    # link's embedded hash, or MissingHashes; it is required to
    # match. If --require-hashes is on, we are satisfied by any
    # hash in `hashes` matching: a URL-based or an option-based
    # one; no internet-sourced hash will be in `hashes`.
    if hashes:
        hashes.check_against_path(link_path)

    # If a download dir is specified, is the file already there and valid?
    already_downloaded_path = None
    if download_dir:
        already_downloaded_path = _check_download_dir(link,
                                                      download_dir,
                                                      hashes)

    if already_downloaded_path:
        from_path = already_downloaded_path
    else:
        from_path = link_path

    content_type = mimetypes.guess_type(from_path)[0]

    # unpack the archive to the build dir location. even when only downloading
    # archives, they have to be unpacked to parse dependencies
    unpack_file(from_path, location, content_type)

    # a download dir is specified and not already downloaded
    if download_dir and not already_downloaded_path:
        _copy_file(from_path, download_dir, link)


def unpack_url(
    link,  # type: Link
    location,  # type: str
    download_dir=None,  # type: Optional[str]
    session=None,  # type: Optional[PipSession]
    hashes=None,  # type: Optional[Hashes]
    progress_bar="on"  # type: str
):
    # type: (...) -> None
    """Unpack link.
       If link is a VCS link:
         if only_download, export into download_dir and ignore location
          else unpack into location
       for other types of link:
         - unpack into location
         - if download_dir, copy the file into download_dir
         - if only_download, mark location for deletion

    :param hashes: A Hashes object, one of whose embedded hashes must match,
        or HashMismatch will be raised. If the Hashes is empty, no matches are
        required, and unhashable types of requirements (like VCS ones, which
        would ordinarily raise HashUnsupported) are allowed.
    """
    # non-editable vcs urls
    if link.is_vcs:
        unpack_vcs_link(link, location)

    # file urls
    elif link.is_file:
        unpack_file_url(link, location, download_dir, hashes=hashes)

    # http urls
    else:
        if session is None:
            session = PipSession()

        unpack_http_url(
            link,
            location,
            download_dir,
            session,
            hashes=hashes,
            progress_bar=progress_bar
        )


def sanitize_content_filename(filename):
    # type: (str) -> str
    """
    Sanitize the "filename" value from a Content-Disposition header.
    """
    return os.path.basename(filename)


def parse_content_disposition(content_disposition, default_filename):
    # type: (str, str) -> str
    """
    Parse the "filename" value from a Content-Disposition header, and
    return the default filename if the result is empty.
    """
    _type, params = cgi.parse_header(content_disposition)
    filename = params.get('filename')
    if filename:
        # We need to sanitize the filename to prevent directory traversal
        # in case the filename contains ".." path parts.
        filename = sanitize_content_filename(filename)
    return filename or default_filename


def _download_http_url(
    link,  # type: Link
    session,  # type: PipSession
    temp_dir,  # type: str
    hashes,  # type: Optional[Hashes]
    progress_bar  # type: str
):
    # type: (...) -> Tuple[str, str]
    """Download link url into temp_dir using provided session"""
    target_url = link.url.split('#', 1)[0]
    try:
        resp = session.get(
            target_url,
            # We use Accept-Encoding: identity here because requests
            # defaults to accepting compressed responses. This breaks in
            # a variety of ways depending on how the server is configured.
            # - Some servers will notice that the file isn't a compressible
            #   file and will leave the file alone and with an empty
            #   Content-Encoding
            # - Some servers will notice that the file is already
            #   compressed and will leave the file alone and will add a
            #   Content-Encoding: gzip header
            # - Some servers won't notice anything at all and will take
            #   a file that's already been compressed and compress it again
            #   and set the Content-Encoding: gzip header
            # By setting this to request only the identity encoding We're
            # hoping to eliminate the third case. Hopefully there does not
            # exist a server which when given a file will notice it is
            # already compressed and that you're not asking for a
            # compressed file and will then decompress it before sending
            # because if that's the case I don't think it'll ever be
            # possible to make this work.
            headers={"Accept-Encoding": "identity"},
            stream=True,
        )
        resp.raise_for_status()
    except requests.HTTPError as exc:
        logger.critical(
            "HTTP error %s while getting %s", exc.response.status_code, link,
        )
        raise

    content_type = resp.headers.get('content-type', '')
    filename = link.filename  # fallback
    # Have a look at the Content-Disposition header for a better guess
    content_disposition = resp.headers.get('content-disposition')
    if content_disposition:
        filename = parse_content_disposition(content_disposition, filename)
    ext = splitext(filename)[1]  # type: Optional[str]
    if not ext:
        ext = mimetypes.guess_extension(content_type)
        if ext:
            filename += ext
    if not ext and link.url != resp.url:
        ext = os.path.splitext(resp.url)[1]
        if ext:
            filename += ext
    file_path = os.path.join(temp_dir, filename)
    with open(file_path, 'wb') as content_file:
        _download_url(resp, link, content_file, hashes, progress_bar)
    return file_path, content_type


def _check_download_dir(link, download_dir, hashes):
    # type: (Link, str, Optional[Hashes]) -> Optional[str]
    """ Check download_dir for previously downloaded file with correct hash
        If a correct file is found return its path else None
    """
    download_path = os.path.join(download_dir, link.filename)

    if not os.path.exists(download_path):
        return None

    # If already downloaded, does its hash match?
    logger.info('File was already downloaded %s', download_path)
    if hashes:
        try:
            hashes.check_against_path(download_path)
        except HashMismatch:
            logger.warning(
                'Previously-downloaded file %s has bad hash. '
                'Re-downloading.',
                download_path
            )
            os.unlink(download_path)
            return None
    return download_path
site-packages/pip/_internal/build_env.py000064400000016535151446176770014404 0ustar00"""Build Environment used for isolation during sdist building
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

import logging
import os
import sys
import textwrap
from collections import OrderedDict
from distutils.sysconfig import get_python_lib
from sysconfig import get_paths

from pip._vendor.pkg_resources import Requirement, VersionConflict, WorkingSet

from pip import __file__ as pip_location
from pip._internal.utils.subprocess import call_subprocess
from pip._internal.utils.temp_dir import TempDirectory
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.ui import open_spinner

if MYPY_CHECK_RUNNING:
    from typing import Tuple, Set, Iterable, Optional, List
    from pip._internal.index import PackageFinder

logger = logging.getLogger(__name__)


class _Prefix:

    def __init__(self, path):
        # type: (str) -> None
        self.path = path
        self.setup = False
        self.bin_dir = get_paths(
            'nt' if os.name == 'nt' else 'posix_prefix',
            vars={'base': path, 'platbase': path}
        )['scripts']
        # Note: prefer distutils' sysconfig to get the
        # library paths so PyPy is correctly supported.
        purelib = get_python_lib(plat_specific=False, prefix=path)
        platlib = get_python_lib(plat_specific=True, prefix=path)
        if purelib == platlib:
            self.lib_dirs = [purelib]
        else:
            self.lib_dirs = [purelib, platlib]


class BuildEnvironment(object):
    """Creates and manages an isolated environment to install build deps
    """

    def __init__(self):
        # type: () -> None
        self._temp_dir = TempDirectory(kind="build-env")

        self._prefixes = OrderedDict((
            (name, _Prefix(os.path.join(self._temp_dir.path, name)))
            for name in ('normal', 'overlay')
        ))

        self._bin_dirs = []  # type: List[str]
        self._lib_dirs = []  # type: List[str]
        for prefix in reversed(list(self._prefixes.values())):
            self._bin_dirs.append(prefix.bin_dir)
            self._lib_dirs.extend(prefix.lib_dirs)

        # Customize site to:
        # - ensure .pth files are honored
        # - prevent access to system site packages
        system_sites = {
            os.path.normcase(site) for site in (
                get_python_lib(plat_specific=False),
                get_python_lib(plat_specific=True),
            )
        }
        self._site_dir = os.path.join(self._temp_dir.path, 'site')
        if not os.path.exists(self._site_dir):
            os.mkdir(self._site_dir)
        with open(os.path.join(self._site_dir, 'sitecustomize.py'), 'w') as fp:
            fp.write(textwrap.dedent(
                '''
                import os, site, sys

                # First, drop system-sites related paths.
                original_sys_path = sys.path[:]
                known_paths = set()
                for path in {system_sites!r}:
                    site.addsitedir(path, known_paths=known_paths)
                system_paths = set(
                    os.path.normcase(path)
                    for path in sys.path[len(original_sys_path):]
                )
                original_sys_path = [
                    path for path in original_sys_path
                    if os.path.normcase(path) not in system_paths
                ]
                sys.path = original_sys_path

                # Second, add lib directories.
                # ensuring .pth file are processed.
                for path in {lib_dirs!r}:
                    assert not path in sys.path
                    site.addsitedir(path)
                '''
            ).format(system_sites=system_sites, lib_dirs=self._lib_dirs))

    def __enter__(self):
        self._save_env = {
            name: os.environ.get(name, None)
            for name in ('PATH', 'PYTHONNOUSERSITE', 'PYTHONPATH')
        }

        path = self._bin_dirs[:]
        old_path = self._save_env['PATH']
        if old_path:
            path.extend(old_path.split(os.pathsep))

        pythonpath = [self._site_dir]

        os.environ.update({
            'PATH': os.pathsep.join(path),
            'PYTHONNOUSERSITE': '1',
            'PYTHONPATH': os.pathsep.join(pythonpath),
        })

    def __exit__(self, exc_type, exc_val, exc_tb):
        for varname, old_value in self._save_env.items():
            if old_value is None:
                os.environ.pop(varname, None)
            else:
                os.environ[varname] = old_value

    def cleanup(self):
        # type: () -> None
        self._temp_dir.cleanup()

    def check_requirements(self, reqs):
        # type: (Iterable[str]) -> Tuple[Set[Tuple[str, str]], Set[str]]
        """Return 2 sets:
            - conflicting requirements: set of (installed, wanted) reqs tuples
            - missing requirements: set of reqs
        """
        missing = set()
        conflicting = set()
        if reqs:
            ws = WorkingSet(self._lib_dirs)
            for req in reqs:
                try:
                    if ws.find(Requirement.parse(req)) is None:
                        missing.add(req)
                except VersionConflict as e:
                    conflicting.add((str(e.args[0].as_requirement()),
                                     str(e.args[1])))
        return conflicting, missing

    def install_requirements(
        self,
        finder,  # type: PackageFinder
        requirements,  # type: Iterable[str]
        prefix_as_string,  # type: str
        message  # type: Optional[str]
    ):
        # type: (...) -> None
        prefix = self._prefixes[prefix_as_string]
        assert not prefix.setup
        prefix.setup = True
        if not requirements:
            return
        args = [
            sys.executable, os.path.dirname(pip_location), 'install',
            '--ignore-installed', '--no-user', '--prefix', prefix.path,
            '--no-warn-script-location',
        ]  # type: List[str]
        if logger.getEffectiveLevel() <= logging.DEBUG:
            args.append('-v')
        for format_control in ('no_binary', 'only_binary'):
            formats = getattr(finder.format_control, format_control)
            args.extend(('--' + format_control.replace('_', '-'),
                         ','.join(sorted(formats or {':none:'}))))

        index_urls = finder.index_urls
        if index_urls:
            args.extend(['-i', index_urls[0]])
            for extra_index in index_urls[1:]:
                args.extend(['--extra-index-url', extra_index])
        else:
            args.append('--no-index')
        for link in finder.find_links:
            args.extend(['--find-links', link])

        for host in finder.trusted_hosts:
            args.extend(['--trusted-host', host])
        if finder.allow_all_prereleases:
            args.append('--pre')
        args.append('--')
        args.extend(requirements)
        with open_spinner(message) as spinner:
            call_subprocess(args, spinner=spinner)


class NoOpBuildEnvironment(BuildEnvironment):
    """A no-op drop-in replacement for BuildEnvironment
    """

    def __init__(self):
        pass

    def __enter__(self):
        pass

    def __exit__(self, exc_type, exc_val, exc_tb):
        pass

    def cleanup(self):
        pass

    def install_requirements(self, finder, requirements, prefix, message):
        raise NotImplementedError()
site-packages/pip/_internal/configuration.py000064400000033612151446176770015277 0ustar00"""Configuration management setup

Some terminology:
- name
  As written in config files.
- value
  Value associated with a name
- key
  Name combined with it's section (section.name)
- variant
  A single word describing where the configuration key-value pair came from
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

import locale
import logging
import os
import sys

from pip._vendor.six.moves import configparser

from pip._internal.exceptions import (
    ConfigurationError,
    ConfigurationFileCouldNotBeLoaded,
)
from pip._internal.utils import appdirs
from pip._internal.utils.compat import WINDOWS, expanduser
from pip._internal.utils.misc import ensure_dir, enum
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, Dict, Iterable, List, NewType, Optional, Tuple
    )

    RawConfigParser = configparser.RawConfigParser  # Shorthand
    Kind = NewType("Kind", str)

logger = logging.getLogger(__name__)


# NOTE: Maybe use the optionx attribute to normalize keynames.
def _normalize_name(name):
    # type: (str) -> str
    """Make a name consistent regardless of source (environment or file)
    """
    name = name.lower().replace('_', '-')
    if name.startswith('--'):
        name = name[2:]  # only prefer long opts
    return name


def _disassemble_key(name):
    # type: (str) -> List[str]
    if "." not in name:
        error_message = (
            "Key does not contain dot separated section and key. "
            "Perhaps you wanted to use 'global.{}' instead?"
        ).format(name)
        raise ConfigurationError(error_message)
    return name.split(".", 1)


# The kinds of configurations there are.
kinds = enum(
    USER="user",        # User Specific
    GLOBAL="global",    # System Wide
    SITE="site",        # [Virtual] Environment Specific
    ENV="env",          # from PIP_CONFIG_FILE
    ENV_VAR="env-var",  # from Environment Variables
)


CONFIG_BASENAME = 'pip.ini' if WINDOWS else 'pip.conf'


def get_configuration_files():
    global_config_files = [
        os.path.join(path, CONFIG_BASENAME)
        for path in appdirs.site_config_dirs('pip')
    ]

    site_config_file = os.path.join(sys.prefix, CONFIG_BASENAME)
    legacy_config_file = os.path.join(
        expanduser('~'),
        'pip' if WINDOWS else '.pip',
        CONFIG_BASENAME,
    )
    new_config_file = os.path.join(
        appdirs.user_config_dir("pip"), CONFIG_BASENAME
    )
    return {
        kinds.GLOBAL: global_config_files,
        kinds.SITE: [site_config_file],
        kinds.USER: [legacy_config_file, new_config_file],
    }


class Configuration(object):
    """Handles management of configuration.

    Provides an interface to accessing and managing configuration files.

    This class converts provides an API that takes "section.key-name" style
    keys and stores the value associated with it as "key-name" under the
    section "section".

    This allows for a clean interface wherein the both the section and the
    key-name are preserved in an easy to manage form in the configuration files
    and the data stored is also nice.
    """

    def __init__(self, isolated, load_only=None):
        # type: (bool, Kind) -> None
        super(Configuration, self).__init__()

        _valid_load_only = [kinds.USER, kinds.GLOBAL, kinds.SITE, None]
        if load_only not in _valid_load_only:
            raise ConfigurationError(
                "Got invalid value for load_only - should be one of {}".format(
                    ", ".join(map(repr, _valid_load_only[:-1]))
                )
            )
        self.isolated = isolated  # type: bool
        self.load_only = load_only  # type: Optional[Kind]

        # The order here determines the override order.
        self._override_order = [
            kinds.GLOBAL, kinds.USER, kinds.SITE, kinds.ENV, kinds.ENV_VAR
        ]

        self._ignore_env_names = ["version", "help"]

        # Because we keep track of where we got the data from
        self._parsers = {
            variant: [] for variant in self._override_order
        }  # type: Dict[Kind, List[Tuple[str, RawConfigParser]]]
        self._config = {
            variant: {} for variant in self._override_order
        }  # type: Dict[Kind, Dict[str, Any]]
        self._modified_parsers = []  # type: List[Tuple[str, RawConfigParser]]

    def load(self):
        # type: () -> None
        """Loads configuration from configuration files and environment
        """
        self._load_config_files()
        if not self.isolated:
            self._load_environment_vars()

    def get_file_to_edit(self):
        # type: () -> Optional[str]
        """Returns the file with highest priority in configuration
        """
        assert self.load_only is not None, \
            "Need to be specified a file to be editing"

        try:
            return self._get_parser_to_modify()[0]
        except IndexError:
            return None

    def items(self):
        # type: () -> Iterable[Tuple[str, Any]]
        """Returns key-value pairs like dict.items() representing the loaded
        configuration
        """
        return self._dictionary.items()

    def get_value(self, key):
        # type: (str) -> Any
        """Get a value from the configuration.
        """
        try:
            return self._dictionary[key]
        except KeyError:
            raise ConfigurationError("No such key - {}".format(key))

    def set_value(self, key, value):
        # type: (str, Any) -> None
        """Modify a value in the configuration.
        """
        self._ensure_have_load_only()

        fname, parser = self._get_parser_to_modify()

        if parser is not None:
            section, name = _disassemble_key(key)

            # Modify the parser and the configuration
            if not parser.has_section(section):
                parser.add_section(section)
            parser.set(section, name, value)

        self._config[self.load_only][key] = value
        self._mark_as_modified(fname, parser)

    def unset_value(self, key):
        # type: (str) -> None
        """Unset a value in the configuration.
        """
        self._ensure_have_load_only()

        if key not in self._config[self.load_only]:
            raise ConfigurationError("No such key - {}".format(key))

        fname, parser = self._get_parser_to_modify()

        if parser is not None:
            section, name = _disassemble_key(key)

            # Remove the key in the parser
            modified_something = False
            if parser.has_section(section):
                # Returns whether the option was removed or not
                modified_something = parser.remove_option(section, name)

            if modified_something:
                # name removed from parser, section may now be empty
                section_iter = iter(parser.items(section))
                try:
                    val = next(section_iter)
                except StopIteration:
                    val = None

                if val is None:
                    parser.remove_section(section)

                self._mark_as_modified(fname, parser)
            else:
                raise ConfigurationError(
                    "Fatal Internal error [id=1]. Please report as a bug."
                )

        del self._config[self.load_only][key]

    def save(self):
        # type: () -> None
        """Save the current in-memory state.
        """
        self._ensure_have_load_only()

        for fname, parser in self._modified_parsers:
            logger.info("Writing to %s", fname)

            # Ensure directory exists.
            ensure_dir(os.path.dirname(fname))

            with open(fname, "w") as f:
                parser.write(f)

    #
    # Private routines
    #

    def _ensure_have_load_only(self):
        # type: () -> None
        if self.load_only is None:
            raise ConfigurationError("Needed a specific file to be modifying.")
        logger.debug("Will be working with %s variant only", self.load_only)

    @property
    def _dictionary(self):
        # type: () -> Dict[str, Any]
        """A dictionary representing the loaded configuration.
        """
        # NOTE: Dictionaries are not populated if not loaded. So, conditionals
        #       are not needed here.
        retval = {}

        for variant in self._override_order:
            retval.update(self._config[variant])

        return retval

    def _load_config_files(self):
        # type: () -> None
        """Loads configuration from configuration files
        """
        config_files = dict(self._iter_config_files())
        if config_files[kinds.ENV][0:1] == [os.devnull]:
            logger.debug(
                "Skipping loading configuration files due to "
                "environment's PIP_CONFIG_FILE being os.devnull"
            )
            return

        for variant, files in config_files.items():
            for fname in files:
                # If there's specific variant set in `load_only`, load only
                # that variant, not the others.
                if self.load_only is not None and variant != self.load_only:
                    logger.debug(
                        "Skipping file '%s' (variant: %s)", fname, variant
                    )
                    continue

                parser = self._load_file(variant, fname)

                # Keeping track of the parsers used
                self._parsers[variant].append((fname, parser))

    def _load_file(self, variant, fname):
        # type: (Kind, str) -> RawConfigParser
        logger.debug("For variant '%s', will try loading '%s'", variant, fname)
        parser = self._construct_parser(fname)

        for section in parser.sections():
            items = parser.items(section)
            self._config[variant].update(self._normalized_keys(section, items))

        return parser

    def _construct_parser(self, fname):
        # type: (str) -> RawConfigParser
        parser = configparser.RawConfigParser()
        # If there is no such file, don't bother reading it but create the
        # parser anyway, to hold the data.
        # Doing this is useful when modifying and saving files, where we don't
        # need to construct a parser.
        if os.path.exists(fname):
            try:
                parser.read(fname)
            except UnicodeDecodeError:
                # See https://github.com/pypa/pip/issues/4963
                raise ConfigurationFileCouldNotBeLoaded(
                    reason="contains invalid {} characters".format(
                        locale.getpreferredencoding(False)
                    ),
                    fname=fname,
                )
            except configparser.Error as error:
                # See https://github.com/pypa/pip/issues/4893
                raise ConfigurationFileCouldNotBeLoaded(error=error)
        return parser

    def _load_environment_vars(self):
        # type: () -> None
        """Loads configuration from environment variables
        """
        self._config[kinds.ENV_VAR].update(
            self._normalized_keys(":env:", self._get_environ_vars())
        )

    def _normalized_keys(self, section, items):
        # type: (str, Iterable[Tuple[str, Any]]) -> Dict[str, Any]
        """Normalizes items to construct a dictionary with normalized keys.

        This routine is where the names become keys and are made the same
        regardless of source - configuration files or environment.
        """
        normalized = {}
        for name, val in items:
            key = section + "." + _normalize_name(name)
            normalized[key] = val
        return normalized

    def _get_environ_vars(self):
        # type: () -> Iterable[Tuple[str, str]]
        """Returns a generator with all environmental vars with prefix PIP_"""
        for key, val in os.environ.items():
            should_be_yielded = (
                key.startswith("PIP_") and
                key[4:].lower() not in self._ignore_env_names
            )
            if should_be_yielded:
                yield key[4:].lower(), val

    # XXX: This is patched in the tests.
    def _iter_config_files(self):
        # type: () -> Iterable[Tuple[Kind, List[str]]]
        """Yields variant and configuration files associated with it.

        This should be treated like items of a dictionary.
        """
        # SMELL: Move the conditions out of this function

        # environment variables have the lowest priority
        config_file = os.environ.get('PIP_CONFIG_FILE', None)
        if config_file is not None:
            yield kinds.ENV, [config_file]
        else:
            yield kinds.ENV, []

        config_files = get_configuration_files()

        # at the base we have any global configuration
        yield kinds.GLOBAL, config_files[kinds.GLOBAL]

        # per-user configuration next
        should_load_user_config = not self.isolated and not (
            config_file and os.path.exists(config_file)
        )
        if should_load_user_config:
            # The legacy config file is overridden by the new config file
            yield kinds.USER, config_files[kinds.USER]

        # finally virtualenv configuration first trumping others
        yield kinds.SITE, config_files[kinds.SITE]

    def _get_parser_to_modify(self):
        # type: () -> Tuple[str, RawConfigParser]
        # Determine which parser to modify
        parsers = self._parsers[self.load_only]
        if not parsers:
            # This should not happen if everything works correctly.
            raise ConfigurationError(
                "Fatal Internal error [id=2]. Please report as a bug."
            )

        # Use the highest priority parser.
        return parsers[-1]

    # XXX: This is patched in the tests.
    def _mark_as_modified(self, fname, parser):
        # type: (str, RawConfigParser) -> None
        file_parser_tuple = (fname, parser)
        if file_parser_tuple not in self._modified_parsers:
            self._modified_parsers.append(file_parser_tuple)
site-packages/pip/_internal/locations.py000064400000012446151446176770014425 0ustar00"""Locations where we look for configs, install stuff, etc"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import os
import os.path
import platform
import site
import sys
import sysconfig
from distutils import sysconfig as distutils_sysconfig
from distutils.command.install import SCHEME_KEYS  # type: ignore

from pip._internal.utils import appdirs
from pip._internal.utils.compat import WINDOWS
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.virtualenv import running_under_virtualenv

if MYPY_CHECK_RUNNING:
    from typing import Any, Union, Dict, List, Optional


# Application Directories
USER_CACHE_DIR = appdirs.user_cache_dir("pip")


def get_major_minor_version():
    # type: () -> str
    """
    Return the major-minor version of the current Python as a string, e.g.
    "3.7" or "3.10".
    """
    return '{}.{}'.format(*sys.version_info)


def get_src_prefix():
    if running_under_virtualenv():
        src_prefix = os.path.join(sys.prefix, 'src')
    else:
        # FIXME: keep src in cwd for now (it is not a temporary folder)
        try:
            src_prefix = os.path.join(os.getcwd(), 'src')
        except OSError:
            # In case the current working directory has been renamed or deleted
            sys.exit(
                "The folder you are executing pip from can no longer be found."
            )

    # under macOS + virtualenv sys.prefix is not properly resolved
    # it is something like /path/to/python/bin/..
    return os.path.abspath(src_prefix)


# FIXME doesn't account for venv linked to global site-packages

site_packages = sysconfig.get_path("purelib")  # type: Optional[str]

# This is because of a bug in PyPy's sysconfig module, see
# https://bitbucket.org/pypy/pypy/issues/2506/sysconfig-returns-incorrect-paths
# for more information.
if platform.python_implementation().lower() == "pypy":
    site_packages = distutils_sysconfig.get_python_lib()
try:
    # Use getusersitepackages if this is present, as it ensures that the
    # value is initialised properly.
    user_site = site.getusersitepackages()
except AttributeError:
    user_site = site.USER_SITE

if WINDOWS:
    bin_py = os.path.join(sys.prefix, 'Scripts')
    bin_user = os.path.join(user_site, 'Scripts')
    # buildout uses 'bin' on Windows too?
    if not os.path.exists(bin_py):
        bin_py = os.path.join(sys.prefix, 'bin')
        bin_user = os.path.join(user_site, 'bin')
else:
    bin_py = os.path.join(sys.prefix, 'bin')
    bin_user = os.path.join(user_site, 'bin')

    # Forcing to use /usr/local/bin for standard macOS framework installs
    # Also log to ~/Library/Logs/ for use with the Console.app log viewer
    if sys.platform[:6] == 'darwin' and sys.prefix[:16] == '/System/Library/':
        bin_py = '/usr/local/bin'


def distutils_scheme(dist_name, user=False, home=None, root=None,
                     isolated=False, prefix=None):
    # type:(str, bool, str, str, bool, str) -> dict
    """
    Return a distutils install scheme
    """
    from distutils.dist import Distribution

    scheme = {}

    if isolated:
        extra_dist_args = {"script_args": ["--no-user-cfg"]}
    else:
        extra_dist_args = {}
    dist_args = {'name': dist_name}  # type: Dict[str, Union[str, List[str]]]
    dist_args.update(extra_dist_args)

    d = Distribution(dist_args)
    # Ignoring, typeshed issue reported python/typeshed/issues/2567
    d.parse_config_files()
    # NOTE: Ignoring type since mypy can't find attributes on 'Command'
    i = d.get_command_obj('install', create=True)  # type: Any
    assert i is not None
    # NOTE: setting user or home has the side-effect of creating the home dir
    # or user base for installations during finalize_options()
    # ideally, we'd prefer a scheme class that has no side-effects.
    assert not (user and prefix), "user={} prefix={}".format(user, prefix)
    assert not (home and prefix), "home={} prefix={}".format(home, prefix)
    i.user = user or i.user
    if user or home:
        i.prefix = ""
    i.prefix = prefix or i.prefix
    i.home = home or i.home
    i.root = root or i.root
    i.finalize_options()
    for key in SCHEME_KEYS:
        scheme[key] = getattr(i, 'install_' + key)

    # install_lib specified in setup.cfg should install *everything*
    # into there (i.e. it takes precedence over both purelib and
    # platlib).  Note, i.install_lib is *always* set after
    # finalize_options(); we only want to override here if the user
    # has explicitly requested it hence going back to the config

    # Ignoring, typeshed issue reported python/typeshed/issues/2567
    if 'install_lib' in d.get_option_dict('install'):  # type: ignore
        scheme.update(dict(purelib=i.install_lib, platlib=i.install_lib))

    if running_under_virtualenv():
        scheme['headers'] = os.path.join(
            sys.prefix,
            'include',
            'site',
            'python{}'.format(get_major_minor_version()),
            dist_name,
        )

        if root is not None:
            path_no_drive = os.path.splitdrive(
                os.path.abspath(scheme["headers"]))[1]
            scheme["headers"] = os.path.join(
                root,
                path_no_drive[1:],
            )

    return scheme
site-packages/pip/_internal/collector.py000064400000043127151446176770014420 0ustar00"""
The main purpose of this module is to expose LinkCollector.collect_links().
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import cgi
import itertools
import logging
import mimetypes
import os
from collections import OrderedDict

from pip._vendor import html5lib, requests
from pip._vendor.distlib.compat import unescape
from pip._vendor.requests.exceptions import HTTPError, RetryError, SSLError
from pip._vendor.six.moves.urllib import parse as urllib_parse
from pip._vendor.six.moves.urllib import request as urllib_request

from pip._internal.models.link import Link
from pip._internal.utils.filetypes import ARCHIVE_EXTENSIONS
from pip._internal.utils.misc import redact_auth_from_url
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.urls import path_to_url, url_to_path
from pip._internal.vcs import is_url, vcs

if MYPY_CHECK_RUNNING:
    from typing import (
        Callable, Dict, Iterable, List, MutableMapping, Optional, Sequence,
        Tuple, Union,
    )
    import xml.etree.ElementTree

    from pip._vendor.requests import Response

    from pip._internal.models.search_scope import SearchScope
    from pip._internal.network.session import PipSession

    HTMLElement = xml.etree.ElementTree.Element
    ResponseHeaders = MutableMapping[str, str]


logger = logging.getLogger(__name__)


def _match_vcs_scheme(url):
    # type: (str) -> Optional[str]
    """Look for VCS schemes in the URL.

    Returns the matched VCS scheme, or None if there's no match.
    """
    for scheme in vcs.schemes:
        if url.lower().startswith(scheme) and url[len(scheme)] in '+:':
            return scheme
    return None


def _is_url_like_archive(url):
    # type: (str) -> bool
    """Return whether the URL looks like an archive.
    """
    filename = Link(url).filename
    for bad_ext in ARCHIVE_EXTENSIONS:
        if filename.endswith(bad_ext):
            return True
    return False


class _NotHTML(Exception):
    def __init__(self, content_type, request_desc):
        # type: (str, str) -> None
        super(_NotHTML, self).__init__(content_type, request_desc)
        self.content_type = content_type
        self.request_desc = request_desc


def _ensure_html_header(response):
    # type: (Response) -> None
    """Check the Content-Type header to ensure the response contains HTML.

    Raises `_NotHTML` if the content type is not text/html.
    """
    content_type = response.headers.get("Content-Type", "")
    if not content_type.lower().startswith("text/html"):
        raise _NotHTML(content_type, response.request.method)


class _NotHTTP(Exception):
    pass


def _ensure_html_response(url, session):
    # type: (str, PipSession) -> None
    """Send a HEAD request to the URL, and ensure the response contains HTML.

    Raises `_NotHTTP` if the URL is not available for a HEAD request, or
    `_NotHTML` if the content type is not text/html.
    """
    scheme, netloc, path, query, fragment = urllib_parse.urlsplit(url)
    if scheme not in {'http', 'https'}:
        raise _NotHTTP()

    resp = session.head(url, allow_redirects=True)
    resp.raise_for_status()

    _ensure_html_header(resp)


def _get_html_response(url, session):
    # type: (str, PipSession) -> Response
    """Access an HTML page with GET, and return the response.

    This consists of three parts:

    1. If the URL looks suspiciously like an archive, send a HEAD first to
       check the Content-Type is HTML, to avoid downloading a large file.
       Raise `_NotHTTP` if the content type cannot be determined, or
       `_NotHTML` if it is not HTML.
    2. Actually perform the request. Raise HTTP exceptions on network failures.
    3. Check the Content-Type header to make sure we got HTML, and raise
       `_NotHTML` otherwise.
    """
    if _is_url_like_archive(url):
        _ensure_html_response(url, session=session)

    logger.debug('Getting page %s', redact_auth_from_url(url))

    resp = session.get(
        url,
        headers={
            "Accept": "text/html",
            # We don't want to blindly returned cached data for
            # /simple/, because authors generally expecting that
            # twine upload && pip install will function, but if
            # they've done a pip install in the last ~10 minutes
            # it won't. Thus by setting this to zero we will not
            # blindly use any cached data, however the benefit of
            # using max-age=0 instead of no-cache, is that we will
            # still support conditional requests, so we will still
            # minimize traffic sent in cases where the page hasn't
            # changed at all, we will just always incur the round
            # trip for the conditional GET now instead of only
            # once per 10 minutes.
            # For more information, please see pypa/pip#5670.
            "Cache-Control": "max-age=0",
        },
    )
    resp.raise_for_status()

    # The check for archives above only works if the url ends with
    # something that looks like an archive. However that is not a
    # requirement of an url. Unless we issue a HEAD request on every
    # url we cannot know ahead of time for sure if something is HTML
    # or not. However we can check after we've downloaded it.
    _ensure_html_header(resp)

    return resp


def _get_encoding_from_headers(headers):
    # type: (ResponseHeaders) -> Optional[str]
    """Determine if we have any encoding information in our headers.
    """
    if headers and "Content-Type" in headers:
        content_type, params = cgi.parse_header(headers["Content-Type"])
        if "charset" in params:
            return params['charset']
    return None


def _determine_base_url(document, page_url):
    # type: (HTMLElement, str) -> str
    """Determine the HTML document's base URL.

    This looks for a ``<base>`` tag in the HTML document. If present, its href
    attribute denotes the base URL of anchor tags in the document. If there is
    no such tag (or if it does not have a valid href attribute), the HTML
    file's URL is used as the base URL.

    :param document: An HTML document representation. The current
        implementation expects the result of ``html5lib.parse()``.
    :param page_url: The URL of the HTML document.
    """
    for base in document.findall(".//base"):
        href = base.get("href")
        if href is not None:
            return href
    return page_url


def _clean_link(url):
    # type: (str) -> str
    """Makes sure a link is fully encoded.  That is, if a ' ' shows up in
    the link, it will be rewritten to %20 (while not over-quoting
    % or other characters)."""
    # Split the URL into parts according to the general structure
    # `scheme://netloc/path;parameters?query#fragment`. Note that the
    # `netloc` can be empty and the URI will then refer to a local
    # filesystem path.
    result = urllib_parse.urlparse(url)
    # In both cases below we unquote prior to quoting to make sure
    # nothing is double quoted.
    if result.netloc == "":
        # On Windows the path part might contain a drive letter which
        # should not be quoted. On Linux where drive letters do not
        # exist, the colon should be quoted. We rely on urllib.request
        # to do the right thing here.
        path = urllib_request.pathname2url(
            urllib_request.url2pathname(result.path))
    else:
        # In addition to the `/` character we protect `@` so that
        # revision strings in VCS URLs are properly parsed.
        path = urllib_parse.quote(urllib_parse.unquote(result.path), safe="/@")
    return urllib_parse.urlunparse(result._replace(path=path))


def _create_link_from_element(
    anchor,    # type: HTMLElement
    page_url,  # type: str
    base_url,  # type: str
):
    # type: (...) -> Optional[Link]
    """
    Convert an anchor element in a simple repository page to a Link.
    """
    href = anchor.get("href")
    if not href:
        return None

    url = _clean_link(urllib_parse.urljoin(base_url, href))
    pyrequire = anchor.get('data-requires-python')
    pyrequire = unescape(pyrequire) if pyrequire else None

    yanked_reason = anchor.get('data-yanked')
    if yanked_reason:
        # This is a unicode string in Python 2 (and 3).
        yanked_reason = unescape(yanked_reason)

    link = Link(
        url,
        comes_from=page_url,
        requires_python=pyrequire,
        yanked_reason=yanked_reason,
    )

    return link


def parse_links(page):
    # type: (HTMLPage) -> Iterable[Link]
    """
    Parse an HTML document, and yield its anchor elements as Link objects.
    """
    document = html5lib.parse(
        page.content,
        transport_encoding=page.encoding,
        namespaceHTMLElements=False,
    )

    url = page.url
    base_url = _determine_base_url(document, url)
    for anchor in document.findall(".//a"):
        link = _create_link_from_element(
            anchor,
            page_url=url,
            base_url=base_url,
        )
        if link is None:
            continue
        yield link


class HTMLPage(object):
    """Represents one page, along with its URL"""

    def __init__(
        self,
        content,   # type: bytes
        encoding,  # type: Optional[str]
        url,       # type: str
    ):
        # type: (...) -> None
        """
        :param encoding: the encoding to decode the given content.
        :param url: the URL from which the HTML was downloaded.
        """
        self.content = content
        self.encoding = encoding
        self.url = url

    def __str__(self):
        return redact_auth_from_url(self.url)


def _handle_get_page_fail(
    link,  # type: Link
    reason,  # type: Union[str, Exception]
    meth=None  # type: Optional[Callable[..., None]]
):
    # type: (...) -> None
    if meth is None:
        meth = logger.debug
    meth("Could not fetch URL %s: %s - skipping", link, reason)


def _make_html_page(response):
    # type: (Response) -> HTMLPage
    encoding = _get_encoding_from_headers(response.headers)
    return HTMLPage(response.content, encoding=encoding, url=response.url)


def _get_html_page(link, session=None):
    # type: (Link, Optional[PipSession]) -> Optional[HTMLPage]
    if session is None:
        raise TypeError(
            "_get_html_page() missing 1 required keyword argument: 'session'"
        )

    url = link.url.split('#', 1)[0]

    # Check for VCS schemes that do not support lookup as web pages.
    vcs_scheme = _match_vcs_scheme(url)
    if vcs_scheme:
        logger.debug('Cannot look at %s URL %s', vcs_scheme, link)
        return None

    # Tack index.html onto file:// URLs that point to directories
    scheme, _, path, _, _, _ = urllib_parse.urlparse(url)
    if (scheme == 'file' and os.path.isdir(urllib_request.url2pathname(path))):
        # add trailing slash if not present so urljoin doesn't trim
        # final segment
        if not url.endswith('/'):
            url += '/'
        url = urllib_parse.urljoin(url, 'index.html')
        logger.debug(' file: URL is directory, getting %s', url)

    try:
        resp = _get_html_response(url, session=session)
    except _NotHTTP:
        logger.debug(
            'Skipping page %s because it looks like an archive, and cannot '
            'be checked by HEAD.', link,
        )
    except _NotHTML as exc:
        logger.debug(
            'Skipping page %s because the %s request got Content-Type: %s',
            link, exc.request_desc, exc.content_type,
        )
    except HTTPError as exc:
        _handle_get_page_fail(link, exc)
    except RetryError as exc:
        _handle_get_page_fail(link, exc)
    except SSLError as exc:
        reason = "There was a problem confirming the ssl certificate: "
        reason += str(exc)
        _handle_get_page_fail(link, reason, meth=logger.info)
    except requests.ConnectionError as exc:
        _handle_get_page_fail(link, "connection error: %s" % exc)
    except requests.Timeout:
        _handle_get_page_fail(link, "timed out")
    else:
        return _make_html_page(resp)
    return None


def _remove_duplicate_links(links):
    # type: (Iterable[Link]) -> List[Link]
    """
    Return a list of links, with duplicates removed and ordering preserved.
    """
    # We preserve the ordering when removing duplicates because we can.
    return list(OrderedDict.fromkeys(links))


def group_locations(locations, expand_dir=False):
    # type: (Sequence[str], bool) -> Tuple[List[str], List[str]]
    """
    Divide a list of locations into two groups: "files" (archives) and "urls."

    :return: A pair of lists (files, urls).
    """
    files = []
    urls = []

    # puts the url for the given file path into the appropriate list
    def sort_path(path):
        url = path_to_url(path)
        if mimetypes.guess_type(url, strict=False)[0] == 'text/html':
            urls.append(url)
        else:
            files.append(url)

    for url in locations:

        is_local_path = os.path.exists(url)
        is_file_url = url.startswith('file:')

        if is_local_path or is_file_url:
            if is_local_path:
                path = url
            else:
                path = url_to_path(url)
            if os.path.isdir(path):
                if expand_dir:
                    path = os.path.realpath(path)
                    for item in os.listdir(path):
                        sort_path(os.path.join(path, item))
                elif is_file_url:
                    urls.append(url)
                else:
                    logger.warning(
                        "Path '{0}' is ignored: "
                        "it is a directory.".format(path),
                    )
            elif os.path.isfile(path):
                sort_path(path)
            else:
                logger.warning(
                    "Url '%s' is ignored: it is neither a file "
                    "nor a directory.", url,
                )
        elif is_url(url):
            # Only add url with clear scheme
            urls.append(url)
        else:
            logger.warning(
                "Url '%s' is ignored. It is either a non-existing "
                "path or lacks a specific scheme.", url,
            )

    return files, urls


class CollectedLinks(object):

    """
    Encapsulates all the Link objects collected by a call to
    LinkCollector.collect_links(), stored separately as--

    (1) links from the configured file locations,
    (2) links from the configured find_links, and
    (3) a dict mapping HTML page url to links from that page.
    """

    def __init__(
        self,
        files,       # type: List[Link]
        find_links,  # type: List[Link]
        pages,       # type: Dict[str, List[Link]]
    ):
        # type: (...) -> None
        """
        :param files: Links from file locations.
        :param find_links: Links from find_links.
        :param pages: A dict mapping HTML page url to links from that page.
        """
        self.files = files
        self.find_links = find_links
        self.pages = pages


class LinkCollector(object):

    """
    Responsible for collecting Link objects from all configured locations,
    making network requests as needed.

    The class's main method is its collect_links() method.
    """

    def __init__(
        self,
        session,       # type: PipSession
        search_scope,  # type: SearchScope
    ):
        # type: (...) -> None
        self.search_scope = search_scope
        self.session = session

    @property
    def find_links(self):
        # type: () -> List[str]
        return self.search_scope.find_links

    def _get_pages(self, locations):
        # type: (Iterable[Link]) -> Iterable[HTMLPage]
        """
        Yields (page, page_url) from the given locations, skipping
        locations that have errors.
        """
        for location in locations:
            page = _get_html_page(location, session=self.session)
            if page is None:
                continue

            yield page

    def collect_links(self, project_name):
        # type: (str) -> CollectedLinks
        """Find all available links for the given project name.

        :return: All the Link objects (unfiltered), as a CollectedLinks object.
        """
        search_scope = self.search_scope
        index_locations = search_scope.get_index_urls_locations(project_name)
        index_file_loc, index_url_loc = group_locations(index_locations)
        fl_file_loc, fl_url_loc = group_locations(
            self.find_links, expand_dir=True,
        )

        file_links = [
            Link(url) for url in itertools.chain(index_file_loc, fl_file_loc)
        ]

        # We trust every directly linked archive in find_links
        find_link_links = [Link(url, '-f') for url in self.find_links]

        # We trust every url that the user has given us whether it was given
        # via --index-url or --find-links.
        # We want to filter out anything that does not have a secure origin.
        url_locations = [
            link for link in itertools.chain(
                (Link(url) for url in index_url_loc),
                (Link(url) for url in fl_url_loc),
            )
            if self.session.is_secure_origin(link)
        ]

        url_locations = _remove_duplicate_links(url_locations)
        lines = [
            '{} location(s) to search for versions of {}:'.format(
                len(url_locations), project_name,
            ),
        ]
        for link in url_locations:
            lines.append('* {}'.format(link))
        logger.debug('\n'.join(lines))

        pages_links = {}
        for page in self._get_pages(url_locations):
            pages_links[page.url] = list(parse_links(page))

        return CollectedLinks(
            files=file_links,
            find_links=find_link_links,
            pages=pages_links,
        )
site-packages/pip/_internal/exceptions.py000064400000024007151446176770014607 0ustar00"""Exceptions used throughout package"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

from itertools import chain, groupby, repeat

from pip._vendor.six import iteritems

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional
    from pip._vendor.pkg_resources import Distribution
    from pip._internal.req.req_install import InstallRequirement


class PipError(Exception):
    """Base pip exception"""


class ConfigurationError(PipError):
    """General exception in configuration"""


class InstallationError(PipError):
    """General exception during installation"""


class UninstallationError(PipError):
    """General exception during uninstallation"""


class NoneMetadataError(PipError):
    """
    Raised when accessing "METADATA" or "PKG-INFO" metadata for a
    pip._vendor.pkg_resources.Distribution object and
    `dist.has_metadata('METADATA')` returns True but
    `dist.get_metadata('METADATA')` returns None (and similarly for
    "PKG-INFO").
    """

    def __init__(self, dist, metadata_name):
        # type: (Distribution, str) -> None
        """
        :param dist: A Distribution object.
        :param metadata_name: The name of the metadata being accessed
            (can be "METADATA" or "PKG-INFO").
        """
        self.dist = dist
        self.metadata_name = metadata_name

    def __str__(self):
        # type: () -> str
        # Use `dist` in the error message because its stringification
        # includes more information, like the version and location.
        return (
            'None {} metadata found for distribution: {}'.format(
                self.metadata_name, self.dist,
            )
        )


class DistributionNotFound(InstallationError):
    """Raised when a distribution cannot be found to satisfy a requirement"""


class RequirementsFileParseError(InstallationError):
    """Raised when a general error occurs parsing a requirements file line."""


class BestVersionAlreadyInstalled(PipError):
    """Raised when the most up-to-date version of a package is already
    installed."""


class BadCommand(PipError):
    """Raised when virtualenv or a command is not found"""


class CommandError(PipError):
    """Raised when there is an error in command-line arguments"""


class PreviousBuildDirError(PipError):
    """Raised when there's a previous conflicting build directory"""


class InvalidWheelFilename(InstallationError):
    """Invalid wheel filename."""


class UnsupportedWheel(InstallationError):
    """Unsupported wheel."""


class HashErrors(InstallationError):
    """Multiple HashError instances rolled into one for reporting"""

    def __init__(self):
        self.errors = []

    def append(self, error):
        self.errors.append(error)

    def __str__(self):
        lines = []
        self.errors.sort(key=lambda e: e.order)
        for cls, errors_of_cls in groupby(self.errors, lambda e: e.__class__):
            lines.append(cls.head)
            lines.extend(e.body() for e in errors_of_cls)
        if lines:
            return '\n'.join(lines)

    def __nonzero__(self):
        return bool(self.errors)

    def __bool__(self):
        return self.__nonzero__()


class HashError(InstallationError):
    """
    A failure to verify a package against known-good hashes

    :cvar order: An int sorting hash exception classes by difficulty of
        recovery (lower being harder), so the user doesn't bother fretting
        about unpinned packages when he has deeper issues, like VCS
        dependencies, to deal with. Also keeps error reports in a
        deterministic order.
    :cvar head: A section heading for display above potentially many
        exceptions of this kind
    :ivar req: The InstallRequirement that triggered this error. This is
        pasted on after the exception is instantiated, because it's not
        typically available earlier.

    """
    req = None  # type: Optional[InstallRequirement]
    head = ''

    def body(self):
        """Return a summary of me for display under the heading.

        This default implementation simply prints a description of the
        triggering requirement.

        :param req: The InstallRequirement that provoked this error, with
            populate_link() having already been called

        """
        return '    %s' % self._requirement_name()

    def __str__(self):
        return '%s\n%s' % (self.head, self.body())

    def _requirement_name(self):
        """Return a description of the requirement that triggered me.

        This default implementation returns long description of the req, with
        line numbers

        """
        return str(self.req) if self.req else 'unknown package'


class VcsHashUnsupported(HashError):
    """A hash was provided for a version-control-system-based requirement, but
    we don't have a method for hashing those."""

    order = 0
    head = ("Can't verify hashes for these requirements because we don't "
            "have a way to hash version control repositories:")


class DirectoryUrlHashUnsupported(HashError):
    """A hash was provided for a version-control-system-based requirement, but
    we don't have a method for hashing those."""

    order = 1
    head = ("Can't verify hashes for these file:// requirements because they "
            "point to directories:")


class HashMissing(HashError):
    """A hash was needed for a requirement but is absent."""

    order = 2
    head = ('Hashes are required in --require-hashes mode, but they are '
            'missing from some requirements. Here is a list of those '
            'requirements along with the hashes their downloaded archives '
            'actually had. Add lines like these to your requirements files to '
            'prevent tampering. (If you did not enable --require-hashes '
            'manually, note that it turns on automatically when any package '
            'has a hash.)')

    def __init__(self, gotten_hash):
        """
        :param gotten_hash: The hash of the (possibly malicious) archive we
            just downloaded
        """
        self.gotten_hash = gotten_hash

    def body(self):
        # Dodge circular import.
        from pip._internal.utils.hashes import FAVORITE_HASH

        package = None
        if self.req:
            # In the case of URL-based requirements, display the original URL
            # seen in the requirements file rather than the package name,
            # so the output can be directly copied into the requirements file.
            package = (self.req.original_link if self.req.original_link
                       # In case someone feeds something downright stupid
                       # to InstallRequirement's constructor.
                       else getattr(self.req, 'req', None))
        return '    %s --hash=%s:%s' % (package or 'unknown package',
                                        FAVORITE_HASH,
                                        self.gotten_hash)


class HashUnpinned(HashError):
    """A requirement had a hash specified but was not pinned to a specific
    version."""

    order = 3
    head = ('In --require-hashes mode, all requirements must have their '
            'versions pinned with ==. These do not:')


class HashMismatch(HashError):
    """
    Distribution file hash values don't match.

    :ivar package_name: The name of the package that triggered the hash
        mismatch. Feel free to write to this after the exception is raise to
        improve its error message.

    """
    order = 4
    head = ('THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS '
            'FILE. If you have updated the package versions, please update '
            'the hashes. Otherwise, examine the package contents carefully; '
            'someone may have tampered with them.')

    def __init__(self, allowed, gots):
        """
        :param allowed: A dict of algorithm names pointing to lists of allowed
            hex digests
        :param gots: A dict of algorithm names pointing to hashes we
            actually got from the files under suspicion
        """
        self.allowed = allowed
        self.gots = gots

    def body(self):
        return '    %s:\n%s' % (self._requirement_name(),
                                self._hash_comparison())

    def _hash_comparison(self):
        """
        Return a comparison of actual and expected hash values.

        Example::

               Expected sha256 abcdeabcdeabcdeabcdeabcdeabcdeabcdeabcdeabcde
                            or 123451234512345123451234512345123451234512345
                    Got        bcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdefbcdef

        """
        def hash_then_or(hash_name):
            # For now, all the decent hashes have 6-char names, so we can get
            # away with hard-coding space literals.
            return chain([hash_name], repeat('    or'))

        lines = []
        for hash_name, expecteds in iteritems(self.allowed):
            prefix = hash_then_or(hash_name)
            lines.extend(('        Expected %s %s' % (next(prefix), e))
                         for e in expecteds)
            lines.append('             Got        %s\n' %
                         self.gots[hash_name].hexdigest())
        return '\n'.join(lines)


class UnsupportedPythonVersion(InstallationError):
    """Unsupported python version according to Requires-Python package
    metadata."""


class ConfigurationFileCouldNotBeLoaded(ConfigurationError):
    """When there are errors while loading a configuration file
    """

    def __init__(self, reason="could not be loaded", fname=None, error=None):
        super(ConfigurationFileCouldNotBeLoaded, self).__init__(error)
        self.reason = reason
        self.fname = fname
        self.error = error

    def __str__(self):
        if self.fname is not None:
            message_part = " in {}.".format(self.fname)
        else:
            assert self.error is not None
            message_part = ".\n{}\n".format(self.error.message)
        return "Configuration file {}{}".format(self.reason, message_part)
site-packages/pip/_internal/cli/main_parser.py000064400000005403151446176770015474 0ustar00"""A single place for constructing and exposing the main parser
"""

import os
import sys

from pip._internal.cli import cmdoptions
from pip._internal.cli.parser import (
    ConfigOptionParser,
    UpdatingDefaultsHelpFormatter,
)
from pip._internal.commands import commands_dict, get_similar_commands
from pip._internal.exceptions import CommandError
from pip._internal.utils.misc import get_pip_version, get_prog
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Tuple, List


__all__ = ["create_main_parser", "parse_command"]


def create_main_parser():
    # type: () -> ConfigOptionParser
    """Creates and returns the main parser for pip's CLI
    """

    parser_kw = {
        'usage': '\n%prog <command> [options]',
        'add_help_option': False,
        'formatter': UpdatingDefaultsHelpFormatter(),
        'name': 'global',
        'prog': get_prog(),
    }

    parser = ConfigOptionParser(**parser_kw)
    parser.disable_interspersed_args()

    parser.version = get_pip_version()

    # add the general options
    gen_opts = cmdoptions.make_option_group(cmdoptions.general_group, parser)
    parser.add_option_group(gen_opts)

    # so the help formatter knows
    parser.main = True  # type: ignore

    # create command listing for description
    description = [''] + [
        '%-27s %s' % (name, command_info.summary)
        for name, command_info in commands_dict.items()
    ]
    parser.description = '\n'.join(description)

    return parser


def parse_command(args):
    # type: (List[str]) -> Tuple[str, List[str]]
    parser = create_main_parser()

    # Note: parser calls disable_interspersed_args(), so the result of this
    # call is to split the initial args into the general options before the
    # subcommand and everything else.
    # For example:
    #  args: ['--timeout=5', 'install', '--user', 'INITools']
    #  general_options: ['--timeout==5']
    #  args_else: ['install', '--user', 'INITools']
    general_options, args_else = parser.parse_args(args)

    # --version
    if general_options.version:
        sys.stdout.write(parser.version)  # type: ignore
        sys.stdout.write(os.linesep)
        sys.exit()

    # pip || pip help -> print_help()
    if not args_else or (args_else[0] == 'help' and len(args_else) == 1):
        parser.print_help()
        sys.exit()

    # the subcommand name
    cmd_name = args_else[0]

    if cmd_name not in commands_dict:
        guess = get_similar_commands(cmd_name)

        msg = ['unknown command "%s"' % cmd_name]
        if guess:
            msg.append('maybe you meant "%s"' % guess)

        raise CommandError(' - '.join(msg))

    # all the args without the subcommand
    cmd_args = args[:]
    cmd_args.remove(cmd_name)

    return cmd_name, cmd_args
site-packages/pip/_internal/cli/status_codes.py000064400000000234151446176770015671 0ustar00from __future__ import absolute_import

SUCCESS = 0
ERROR = 1
UNKNOWN_ERROR = 2
VIRTUALENV_NOT_FOUND = 3
PREVIOUS_BUILD_DIR_ERROR = 4
NO_MATCHES_FOUND = 23
site-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-38.opt-1.pyc000064400000045506151446176770022610 0ustar00U

��.e�h�@s�dZddlmZddlZddlZddlZddlmZddlm	Z	ddl
mZmZm
Z
ddlmZddlmZdd	lmZmZdd
lmZddlmZddlmZdd
lmZddlmZddlmZe�rddl m!Z!m"Z"m#Z#m$Z$m%Z%ddl
m&Z&m'Z'ddl(m)Z)e�*e+�Z,dd�Z-dd�Z.d�dd�Z/d�dd�Z0e	edddddd �Z1e	ed!d"d#dd$d%�Z2e	ed&d'd(d#ded%�Z3e	ed)d*d+d,dd-d%�Z4e	ed.d/d#dd0d%�Z5e	ed1d2d3d#d4d �Z6e	ed5d6d7d,dd8d%�Z7e	ed9d:d;e8e�9��d<d=d>�:e�9��d?d@�Z;e	edAdBdCdDdEdFdG�Z<e	edHdId#ded%�Z=e	edJdKdLdMdNdO�Z>e	edPdQdRdSdTdO�Z?e	edUdVdWdXdYdZd[d\�Z@e	ed]d^dLdMedO�ZAd_d`�ZBe	edadbdLdEdcdd�ZCe	ededfdLddEdgdh�ZDe	edidjdkdldmejEdndo�ZFdpdq�ZGe	edrdsd#ddtd%�ZHdudv�ZIdwdx�ZJdydz�ZKd{d|�ZLd}d~�ZMe	edd�d�d�d�d�e�d�do�	ZNd�d��ZOd�d��ZPd�d��ZQd�d��ZRd�d��ZSe	ed�d�d�dd�do�ZTd�d��ZUd�d��ZVe	ed�d�d�d�eVdLded��d��	ZWe	ed�d�d�dd�do�ZXe	ed�d�d�dd�do�ZYd�d��ZZd�d��Z[d�d��Z\e	ed�d�ed�d�d��Z]d�d��Z^e	ed�d�d�e^d�d��Z_e	ed�d�d�d#dd�d%�Z`e	ed�d�d�d�d�d�d�dG�Zae	ed�d�d#d�d �Zbe	ed�d�d�d�d�d%�Zcd�dĄZde	ed�d�d#dd�d%�Zee	ed�d�d�eddedɍZfe	ed�d�d�d�d�dύZge	ed�d�d�d�d�dύZhe	ed�d#dd�dՍZie	ed�d#dd�dՍZje	ed�d�d#dd�d%�Zke	ed�d�d�d#ed �Zld�d߄Zme	ed�d�d�emd�d�d�Zne	ed�d�d#dd�d%�Zoe	ed�dEd�d�d �Zpd�d�Zqd�e1e2e3e4e6e7e<e=e>e?e@eAeBeJeCeDe]e_eke5gd�Zrd�eFeGeHeIgd�ZsdS)�aC
shared options and groups

The principle here is to define options once, but *not* instantiate them
globally. One reason being that options with action='append' can carry state
between parses. pip parses general options twice internally, and shouldn't
pass on state. To be consistent, all options will follow this design.
�)�absolute_importN)�	strtobool)�partial)�
SUPPRESS_HELP�Option�OptionGroup)�dedent)�CommandError)�USER_CACHE_DIR�get_src_prefix)�
FormatControl)�PyPI)�TargetPython)�
STRONG_HASHES)�MYPY_CHECK_RUNNING)�	BAR_TYPES)�Any�Callable�Dict�Optional�Tuple)�OptionParser�Values)�ConfigOptionParsercCs.d�||�}t�d�|����}|�|�dS)z�
    Raise an option parsing error using parser.error().

    Args:
      parser: an OptionParser instance.
      option: an Option instance.
      msg: the error text.
    z{} error: {}� N)�format�textwrapZfill�join�split�error)�parser�option�msg�r#�@/usr/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py�raise_option_error)s	r%cCs,t||d�}|dD]}|�|��q|S)z�
    Return an OptionGroup object
    group  -- assumed to be dict with 'name' and 'options' keys
    parser -- an optparse Parser
    �name�options)r�
add_option)�groupr Zoption_groupr!r#r#r$�make_option_group7sr*csP�dkr|��fdd�}dddg}tt||��rL|j}|��tjddd	�dS)
z�Disable wheels if per-setup.py call options are set.

    :param options: The OptionParser options to update.
    :param check_options: The options to check, if not supplied defaults to
        options.
    Ncst�|d�S�N)�getattr)�n��
check_optionsr#r$�getnameOsz+check_install_build_global.<locals>.getnameZ
build_options�global_options�install_optionszeDisabling all use of wheels due to the use of --build-options / --global-options / --install-options.�)�
stacklevel)�any�map�format_controlZdisallow_binaries�warnings�warn)r'r/r0�namesZcontrolr#r.r$�check_install_build_globalDs
�r;FcCsbt|j|j|j|jg�}tt�dh�}|j|ko6|j}|rH|rHt	d��|r^|r^|j
s^t	d��dS)z�Function for determining if custom platform options are allowed.

    :param options: The OptionParser options.
    :param check_target: Whether or not to check if --target is being used.
    z:all:z�When restricting platform and interpreter constraints using --python-version, --platform, --abi, or --implementation, either --no-deps must be set, or --only-binary=:all: must be set and --no-binary must not be set (or must be set to :none:).zQCan not use any platform or abi specific options unless installing via '--target'N)r5�python_version�platform�abi�implementationr�setr7�ignore_dependenciesr	Z
target_dir)r'Zcheck_targetZdist_restriction_setZbinary_onlyZsdist_dependencies_allowedr#r#r$�check_dist_restriction[s&�
��
�rBz-hz--help�helpz
Show help.)�dest�actionrCz
--isolated�
isolated_mode�
store_truezSRun pip in an isolated mode, ignoring environment variables and user configuration.�rDrE�defaultrCz--require-virtualenvz--require-venvZrequire_venvz-vz	--verbose�verbose�countzDGive more output. Option is additive, and can be used up to 3 times.z
--no-color�no_colorzSuppress colored outputz-Vz	--version�versionzShow version and exit.z-qz--quiet�quietz�Give less output. Option is additive, and can be used up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels).z--progress-bar�progress_bar�choiceZonz*Specify type of progress to be displayed [�|z] (default: %default))rD�type�choicesrIrCz--logz
--log-filez--local-log�log�pathz Path to a verbose appending log.)rD�metavarrCz
--no-input�no_inputz--proxy�proxy�str�z<Specify a proxy in the form [user:passwd@]proxy.server:port.)rDrRrIrCz	--retries�retries�int�zRMaximum number of retries each connection should attempt (default %default times).z	--timeoutz--default-timeoutZsec�timeout�float�z2Set the socket timeout (default %default seconds).)rVrDrRrIrCz--skip-requirements-regex�skip_requirements_regexc
Cs"tddddddddggd	d
dd�S)
Nz--exists-action�
exists_actionrP�s�i�w�b�a�appendrEzYDefault action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.)rDrRrSrIrErVrC�rr#r#r#r$rbs�rbz--cert�certzPath to alternate CA bundle.)rDrRrVrCz
--client-cert�client_certzkPath to SSL client certificate, a single file containing the private key and the certificate in PEM format.)rDrRrIrVrCz-iz--index-urlz
--pypi-url�	index_url�URLz�Base URL of the Python Package Index (default %default). This should point to a repository compliant with PEP 503 (the simple repository API) or a local directory laid out in the same format.)rDrVrIrCcCstddddgdd�S)Nz--extra-index-urlZextra_index_urlsrmrhzmExtra URLs of package indexes to use in addition to --index-url. Should follow the same rules as --index-url.)rDrVrErIrCrir#r#r#r$�extra_index_urlDs�rnz
--no-index�no_indexzAIgnore package index (only looking at --find-links URLs instead).c	Cstddddgddd�S)Nz-fz--find-links�
find_linksrhZurlz�If a url or path to an html file, then parse for links to archives. If a local path or file:// url that's a directory, then look for archives in the directory listing.�rDrErIrVrCrir#r#r#r$rp[s�rpcCstddddgdd�S)Nz--trusted-hostZ
trusted_hostsrhZHOSTNAMEz]Mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS.)rDrErVrIrCrir#r#r#r$�trusted_hostis�rrc	Cstddddgddd�S)Nz-cz--constraint�constraintsrh�filez\Constrain versions using the given constraints file. This option can be used multiple times.rqrir#r#r#r$rsvs�rsc	Cstddddgddd�S)Nz-rz
--requirement�requirementsrhrtzQInstall from the given requirements file. This option can be used multiple times.rqrir#r#r#r$ru�s�ruc	Cstddddgddd�S)Nz-ez
--editableZ	editablesrhzpath/urlzkInstall a project in editable mode (i.e. setuptools "develop mode") from a local project path or a VCS url.rqrir#r#r#r$�editable�s�rvz--srcz--sourcez--source-dirz--source-directoryZsrc_dir�dirz�Directory to check out editable projects into. The default in a virtualenv is "<venv path>/src". The default for global installs is "<current dir>/src".cCst||j�S)zGet a format_control object.)r,rD)�valuesr!r#r#r$�_get_format_control�srycCs"t|j|�}t�||j|j�dSr+)ryrxr�handle_mutual_excludes�	no_binary�only_binary�r!�opt_str�valuer Zexistingr#r#r$�_handle_no_binary�s�r�cCs"t|j|�}t�||j|j�dSr+)ryrxrrzr|r{r}r#r#r$�_handle_only_binary�s�r�c	Cs$tt�t��}tdddtd|dd�S)Nz--no-binaryr7�callbackrYa^Do not use binary packages. Can be supplied multiple times, and each time adds to the existing value. Accepts either :all: to disable all binary packages, :none: to empty the set, or one or more package names with commas between them (no colons). Note that some packages are tricky to compile and may fail to install when this option is used on them.�rDrEr�rRrIrC)rr@rr��r7r#r#r$r{�s�r{c	Cs$tt�t��}tdddtd|dd�S)Nz
--only-binaryr7r�rYaGDo not use source packages. Can be supplied multiple times, and each time adds to the existing value. Accepts either :all: to disable all source packages, :none: to empty the set, or one or more package names with commas between them. Packages without binary distributions will fail to install when this option is used on them.r�)rr@rr�r�r#r#r$r|�s�r|z
--platformr=z[Only use wheels compatible with <platform>. Defaults to the platform of the running system.cCs�|sdS|�d�}t|�dkr"dSt|�dkrV|d}t|�dkrV|d|dd�g}ztdd	�|D��}Wntk
r�Yd
SX|dfS)z�
    Convert a version string like "3", "37", or "3.7.3" into a tuple of ints.

    :return: A 2-tuple (version_info, error_msg), where `error_msg` is
        non-None if and only if there was a parsing error.
    )NN�.�)r#z'at most three version parts are allowed�rNcss|]}t|�VqdSr+)r\)�.0�partr#r#r$�	<genexpr>sz*_convert_python_version.<locals>.<genexpr>)r#z$each version part must be an integer)r�len�tuple�
ValueError)r�parts�version_infor#r#r$�_convert_python_version�s
r�cCs:t|�\}}|dk	r.d�||�}t|||d�||j_dS)z3
    Handle a provided --python-version value.
    Nz(invalid --python-version value: {!r}: {}�r!r")r�rr%rxr<)r!r~rr r�Z	error_msgr"r#r#r$�_handle_python_version	s��r�z--python-versionr<r�a�    The Python interpreter version to use for wheel and "Requires-Python"
    compatibility checks. Defaults to a version derived from the running
    interpreter. The version can be specified using up to three dot-separated
    integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor
    version can also be given as a string without dots (e.g. "37" for 3.7.0).
    )rDrVrEr�rRrIrCz--implementationr?z�Only use wheels compatible with Python implementation <implementation>, e.g. 'pp', 'jy', 'cp',  or 'ip'. If not specified, then the current interpreter implementation is used.  Use 'py' to force implementation-agnostic wheels.z--abir>z�Only use wheels compatible with Python abi <abi>, e.g. 'pypy_41'.  If not specified, then the current interpreter abi tag is used.  Generally you will need to specify --implementation, --platform, and --python-version when using this option.cCs4|�t��|�t��|�t��|�t��dSr+)r(r=r<r?r>)Zcmd_optsr#r#r$�add_target_python_optionsIsr�cCst|j|j|j|jd�}|S)N)r=Zpy_version_infor>r?)rr=r<r>r?)r'Z
target_pythonr#r#r$�make_target_pythonQs�r�cCstdddddd�S)Nz--prefer-binary�
prefer_binaryrGFz8Prefer older binary packages over newer source packages.rHrir#r#r#r$r�]s�r�z--cache-dir�	cache_dirzStore the cache data in <dir>.)rDrIrVrCc
CsV|dk	rJzt|�Wn4tk
rH}zt||t|�d�W5d}~XYnXd|j_dS)z�
    Process a value provided for the --no-cache-dir option.

    This is an optparse.Option callback for the --no-cache-dir option.
    Nr�F)rr�r%rYrxr�)r!�optrr �excr#r#r$�_handle_no_cache_dirrs$	r�z--no-cache-dirzDisable the cache.)rDrEr�rCz	--no-depsz--no-dependenciesrAz#Don't install package dependencies.z-bz--buildz--build-dirz--build-directory�	build_dira>Directory to unpack packages into and build in. Note that an initial build still takes place in a temporary directory. The location of temporary directories can be controlled by setting the TMPDIR environment variable (TEMP on Windows) appropriately. When passed, build directories are not cleaned in case of failures.z--ignore-requires-python�ignore_requires_pythonz'Ignore the Requires-Python information.z--no-build-isolationZbuild_isolationZstore_falseTz�Disable isolation when building a modern source distribution. Build dependencies specified by PEP 518 must be already installed if this option is used.cCs&|dk	rd}t|||d�d|j_dS)z�
    Process a value provided for the --no-use-pep517 option.

    This is an optparse.Option callback for the no_use_pep517 option.
    Na0A value was passed for --no-use-pep517,
        probably using either the PIP_NO_USE_PEP517 environment variable
        or the "no-use-pep517" config file option. Use an appropriate value
        of the PIP_USE_PEP517 environment variable or the "use-pep517"
        config file option instead.
        r�F)r%rx�
use_pep517)r!r�rr r"r#r#r$�_handle_no_use_pep517�sr�z--use-pep517r�z^Use PEP 517 for building source distributions (use --no-use-pep517 to force legacy behaviour).z--no-use-pep517)rDrEr�rIrCz--install-optionr2rhr'a"Extra arguments to be supplied to the setup.py install command (use like --install-option="--install-scripts=/usr/local/bin"). Use multiple --install-option options to pass multiple options to setup.py install. If you are using an option with a directory path, be sure to use absolute path.)rDrErVrCz--global-optionr1zTExtra global options to be supplied to the setup.py call before the install command.z
--no-cleanz!Don't clean up build directories.)rErIrCz--prezYInclude pre-release and development versions. By default, pip only finds stable versions.z--disable-pip-version-check�disable_pip_version_checkz{Don't periodically check PyPI to determine whether a new version of pip is available for download. Implied with --no-index.z-Zz--always-unzip�always_unzipcCs�|jjsi|j_z|�dd�\}}Wn"tk
rF|�d|�YnX|tkrh|�d|d�t�f�|jj�|g��|�dS)zkGiven a value spelled "algo:digest", append the digest to a list
    pointed to in a dict by the algo name.�:r�zTArguments to %s must be a hash name followed by a value, like --hash=sha256:abcde...z&Allowed hash algorithms for %s are %s.z, N)	rx�hashesrr�rrr�
setdefaultrh)r!r~rr ZalgoZdigestr#r#r$�_handle_merge_hash)s��r�z--hashr��stringzgVerify that the package's archive matches this hash before installing. Example: --hash=sha256:abcdef...)rDrEr�rRrCz--require-hashes�require_hashesz�Require a hash to check each requirement against, for repeatable installs. This option is implied when any package in a requirements file has a --hash option.z--pathz^Restrict to the specified installation path for listing packages (can be used multiple times).cCs|jr|js|jrtd��dS)Nz2Cannot combine '--path' with '--user' or '--local')rU�userZlocalr	)r'r#r#r$�check_list_path_option_s�r�zGeneral Options)r&r'zPackage Index Options)N)F)t�__doc__Z
__future__rZloggingrr8Zdistutils.utilr�	functoolsrZoptparserrrrZpip._internal.exceptionsr	Zpip._internal.locationsr
rZ#pip._internal.models.format_controlrZpip._internal.models.indexr
Z"pip._internal.models.target_pythonrZpip._internal.utils.hashesrZpip._internal.utils.typingrZpip._internal.utils.uir�typingrrrrrrrZpip._internal.cli.parserrZ	getLogger�__name__Zloggerr%r*r;rBZhelp_rFZrequire_virtualenvrJrLrMrN�list�keysrrOrTrWrXr[r^rarbrjrkZ
simple_urlrlrnrorprrrsrurv�srcryr�r�r{r|r=r�r�r<r?r>r�r�r�r�r�Zno_cacheZno_depsr�r�Zno_build_isolationr�r�Z
no_use_pep517r2r1Zno_cleanZprer�r�r��hashr�Z	list_pathr�Z
general_groupZindex_groupr#r#r#r$�<module>sB



,���
�	�	��

���
��
�	�
�
��	��

�




������
�	�	����
�
�
�
��	��	���

����site-packages/pip/_internal/cli/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000354151446176770022160 0ustar00U

��.e��@sdZdS)zGSubpackage containing all of pip's command line interface related code
N)�__doc__�rr�>/usr/lib/python3.8/site-packages/pip/_internal/cli/__init__.py�<module>�site-packages/pip/_internal/cli/__pycache__/parser.cpython-38.pyc000064400000021421151446176770020754 0ustar00U

��.e%�@s�dZddlmZddlZddlZddlZddlZddlmZddl	m
Z
ddlmZddl
mZmZddlmZe�e�ZGd	d
�d
ej�ZGdd�de�ZGd
d�dej�ZGdd�de�Zdd�ZdS)zBase option parser setup�)�absolute_importN)�	strtobool)�string_types)�
UNKNOWN_ERROR)�
Configuration�ConfigurationError)�get_terminal_sizec@sReZdZdZdd�Zdd�Zddd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�ZdS)�PrettyHelpFormatterz4A prettier/less verbose help formatter for optparse.cOs:d|d<d|d<t�dd|d<tjj|f|�|�dS)N�Zmax_help_position�Zindent_incrementr��width)r�optparse�IndentedHelpFormatter�__init__)�self�args�kwargs�r�</usr/lib/python3.8/site-packages/pip/_internal/cli/parser.pyrszPrettyHelpFormatter.__init__cCs|�|dd�S)N� <%s>�, )�_format_option_strings�r�optionrrr�format_option_strings!sz)PrettyHelpFormatter.format_option_stringsrrcCs|g}|jr|�|jd�|jr0|�|jd�t|�dkrH|�d|�|��rr|jp^|j��}|�||���d�	|�S)a
        Return a comma-separated list of option strings and metavars.

        :param option:  tuple of (short opt, long opt), e.g: ('-f', '--format')
        :param mvarfmt: metavar format string - evaluated as mvarfmt % metavar
        :param optsep:  separator
        rr�)
Z_short_opts�appendZ
_long_opts�len�insertZtakes_value�metavar�dest�lower�join)rrZmvarfmtZoptsepZoptsr rrrr$sz*PrettyHelpFormatter._format_option_stringscCs|dkrdS|dS)NZOptionsrz:
r)rZheadingrrr�format_heading;sz"PrettyHelpFormatter.format_headingcCsd|�t�|�d�}|S)zz
        Ensure there is only one newline between usage and the first heading
        if there is no description.
        z
Usage: %s
�  )�indent_lines�textwrap�dedent)rZusage�msgrrr�format_usage@sz PrettyHelpFormatter.format_usagecCsV|rNt|jd�rd}nd}|�d�}|��}|�t�|�d�}d||f}|SdSdS)N�mainZCommandsZDescription�
r%z%s:
%s
r)�hasattr�parser�lstrip�rstripr&r'r()r�descriptionZlabelrrr�format_descriptionHs
z&PrettyHelpFormatter.format_descriptioncCs|r|SdSdS)Nrr)rZepilogrrr�
format_epilogZsz!PrettyHelpFormatter.format_epilogcs"�fdd�|�d�D�}d�|�S)Ncsg|]}�|�qSrr)�.0�line��indentrr�
<listcomp>bsz4PrettyHelpFormatter.indent_lines.<locals>.<listcomp>r,)�splitr#)r�textr7Z	new_linesrr6rr&asz PrettyHelpFormatter.indent_linesN)rr)�__name__�
__module__�__qualname__�__doc__rrrr$r*r2r3r&rrrrr	s
r	c@seZdZdZdd�ZdS)�UpdatingDefaultsHelpFormatterz�Custom help formatter for use in ConfigOptionParser.

    This is updates the defaults before expanding them, allowing
    them to show up correctly in the help listing.
    cCs(|jdk	r|j�|jj�tj�||�S)N)r.�_update_defaults�defaultsrr�expand_defaultrrrrrBms
z,UpdatingDefaultsHelpFormatter.expand_defaultN)r;r<r=r>rBrrrrr?fsr?c@s eZdZdd�Zedd��ZdS)�CustomOptionParsercOs(|j||�}|j��|j�||�|S)z*Insert an OptionGroup at a given position.)Zadd_option_group�
option_groups�popr)r�idxrr�grouprrr�insert_option_groupus
z&CustomOptionParser.insert_option_groupcCs*|jdd�}|jD]}|�|j�q|S)z<Get a list of all options, including those in option groups.N)Zoption_listrD�extend)r�res�irrr�option_list_all~s
z"CustomOptionParser.option_list_allN)r;r<r=rH�propertyrLrrrrrCss	rCc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)�ConfigOptionParserzsCustom option parser which updates its defaults by checking the
    configuration files and environmental variablescOsD|�d�|_|�dd�}t|�|_|js,t�tjj|f|�|�dS)N�name�isolatedF)rErOr�config�AssertionErrorr�OptionParserr)rrrrPrrrr�s


zConfigOptionParser.__init__c
CsNz|�||�WStjk
rH}ztd|�t�d�W5d}~XYnXdS)Nz*An error occurred during configuration: %s�)�check_valuerZOptionValueError�print�sys�exit)rr�key�val�excrrr�
check_default�s
z ConfigOptionParser.check_defaultccs�d|jdg}dd�|D�}|j��D]D\}}|s>t�d|�q$|�dd�\}}||kr$||�||f�q$|D] }||D]\}}||fVqzqndS)N�globalz:env:cSsi|]
}|g�qSrr)r4rOrrr�
<dictcomp>�szGConfigOptionParser._get_ordered_configuration_items.<locals>.<dictcomp>z7Ignoring configuration key '%s' as it's value is empty.�.r)rOrQ�items�logger�debugr9r)rZoverride_orderZ
section_itemsZsection_keyrZZsectionrYrrr� _get_ordered_configuration_items�s�z3ConfigOptionParser._get_ordered_configuration_itemsc	sHt��j��_t�}���D�]\�}��d����dkr>q�jdkr�zt|�}Wn,t	k
r�t
�j�|�}��|�YnXn��jdkr�|��}���fdd�|D�}nh�jdk�r|�
�j����}��||�}�jp�d}�jp�i}�j�||�f|�|�n����|�}||�j<q|D]�t�j��|�<�q&d�_|S)	z�Updates the given defaults with values from the config files and
        the environ. Does a little special handling for certain types of
        options (lists).z--N)�
store_true�store_false�countrcsg|]}����|��qSr)r\)r4�v�rYrrrrr8�sz7ConfigOptionParser._update_defaults.<locals>.<listcomp>�callbackr)r�ValuesrA�values�setrcZ
get_option�actionr�
ValueError�invalid_config_error_message�errorr9�addr!�get_opt_stringZ
convert_valueZ
callback_argsZcallback_kwargsrir\�getattr)rrAZ	late_evalrZZ	error_msg�opt_strrrrrhrr@�s@
�


z#ConfigOptionParser._update_defaultsc
Cs�|jst�|j�Sz|j��Wn2tk
rR}z|�tt	|��W5d}~XYnX|�
|j���}|��D]4}|�
|j�}t|t�rl|��}|�||�||j<qlt�|�S)z�Overriding to make updating the defaults after instantiation of
        the option parser possible, _update_defaults() does the dirty work.N)Zprocess_default_valuesrrjrArQ�loadrrXr�strr@�copyZ_get_all_options�getr!�
isinstancerrrrU)r�errrAr�defaultrtrrr�get_default_values�s"
z%ConfigOptionParser.get_default_valuescCs |�tj�|�td|�dS)Nz%s
)Zprint_usagerW�stderrrXr)rr)rrrrp�szConfigOptionParser.errorN)
r;r<r=r>rr\rcr@r|rprrrrrN�s	1rNcCs |dkrd�||�Sd�||�S)zQReturns a better error message when invalid configuration option
    is provided.)rdrezo{0} is not a valid value for {1} option, please specify a boolean value like yes/no, true/false or 1/0 instead.z[{0} is not a valid value for {1} option, please specify a numerical value like 1/0 instead.)�format)rmrYrZrrrro�s��ro)r>Z
__future__rZloggingrrWr'Zdistutils.utilrZpip._vendor.sixrZpip._internal.cli.status_codesrZpip._internal.configurationrrZpip._internal.utils.compatrZ	getLoggerr;rarr	r?rSrCrNrorrrr�<module>s 
O
wsite-packages/pip/_internal/cli/__pycache__/cmdoptions.cpython-38.pyc000064400000045506151446176770021651 0ustar00U

��.e�h�@s�dZddlmZddlZddlZddlZddlmZddlm	Z	ddl
mZmZm
Z
ddlmZddlmZdd	lmZmZdd
lmZddlmZddlmZdd
lmZddlmZddlmZe�rddl m!Z!m"Z"m#Z#m$Z$m%Z%ddl
m&Z&m'Z'ddl(m)Z)e�*e+�Z,dd�Z-dd�Z.d�dd�Z/d�dd�Z0e	edddddd �Z1e	ed!d"d#dd$d%�Z2e	ed&d'd(d#ded%�Z3e	ed)d*d+d,dd-d%�Z4e	ed.d/d#dd0d%�Z5e	ed1d2d3d#d4d �Z6e	ed5d6d7d,dd8d%�Z7e	ed9d:d;e8e�9��d<d=d>�:e�9��d?d@�Z;e	edAdBdCdDdEdFdG�Z<e	edHdId#ded%�Z=e	edJdKdLdMdNdO�Z>e	edPdQdRdSdTdO�Z?e	edUdVdWdXdYdZd[d\�Z@e	ed]d^dLdMedO�ZAd_d`�ZBe	edadbdLdEdcdd�ZCe	ededfdLddEdgdh�ZDe	edidjdkdldmejEdndo�ZFdpdq�ZGe	edrdsd#ddtd%�ZHdudv�ZIdwdx�ZJdydz�ZKd{d|�ZLd}d~�ZMe	edd�d�d�d�d�e�d�do�	ZNd�d��ZOd�d��ZPd�d��ZQd�d��ZRd�d��ZSe	ed�d�d�dd�do�ZTd�d��ZUd�d��ZVe	ed�d�d�d�eVdLded��d��	ZWe	ed�d�d�dd�do�ZXe	ed�d�d�dd�do�ZYd�d��ZZd�d��Z[d�d��Z\e	ed�d�ed�d�d��Z]d�d��Z^e	ed�d�d�e^d�d��Z_e	ed�d�d�d#dd�d%�Z`e	ed�d�d�d�d�d�d�dG�Zae	ed�d�d#d�d �Zbe	ed�d�d�d�d�d%�Zcd�dĄZde	ed�d�d#dd�d%�Zee	ed�d�d�eddedɍZfe	ed�d�d�d�d�dύZge	ed�d�d�d�d�dύZhe	ed�d#dd�dՍZie	ed�d#dd�dՍZje	ed�d�d#dd�d%�Zke	ed�d�d�d#ed �Zld�d߄Zme	ed�d�d�emd�d�d�Zne	ed�d�d#dd�d%�Zoe	ed�dEd�d�d �Zpd�d�Zqd�e1e2e3e4e6e7e<e=e>e?e@eAeBeJeCeDe]e_eke5gd�Zrd�eFeGeHeIgd�ZsdS)�aC
shared options and groups

The principle here is to define options once, but *not* instantiate them
globally. One reason being that options with action='append' can carry state
between parses. pip parses general options twice internally, and shouldn't
pass on state. To be consistent, all options will follow this design.
�)�absolute_importN)�	strtobool)�partial)�
SUPPRESS_HELP�Option�OptionGroup)�dedent)�CommandError)�USER_CACHE_DIR�get_src_prefix)�
FormatControl)�PyPI)�TargetPython)�
STRONG_HASHES)�MYPY_CHECK_RUNNING)�	BAR_TYPES)�Any�Callable�Dict�Optional�Tuple)�OptionParser�Values)�ConfigOptionParsercCs.d�||�}t�d�|����}|�|�dS)z�
    Raise an option parsing error using parser.error().

    Args:
      parser: an OptionParser instance.
      option: an Option instance.
      msg: the error text.
    z{} error: {}� N)�format�textwrapZfill�join�split�error)�parser�option�msg�r#�@/usr/lib/python3.8/site-packages/pip/_internal/cli/cmdoptions.py�raise_option_error)s	r%cCs,t||d�}|dD]}|�|��q|S)z�
    Return an OptionGroup object
    group  -- assumed to be dict with 'name' and 'options' keys
    parser -- an optparse Parser
    �name�options)r�
add_option)�groupr Zoption_groupr!r#r#r$�make_option_group7sr*csP�dkr|��fdd�}dddg}tt||��rL|j}|��tjddd	�dS)
z�Disable wheels if per-setup.py call options are set.

    :param options: The OptionParser options to update.
    :param check_options: The options to check, if not supplied defaults to
        options.
    Ncst�|d�S�N)�getattr)�n��
check_optionsr#r$�getnameOsz+check_install_build_global.<locals>.getnameZ
build_options�global_options�install_optionszeDisabling all use of wheels due to the use of --build-options / --global-options / --install-options.�)�
stacklevel)�any�map�format_controlZdisallow_binaries�warnings�warn)r'r/r0�namesZcontrolr#r.r$�check_install_build_globalDs
�r;FcCsbt|j|j|j|jg�}tt�dh�}|j|ko6|j}|rH|rHt	d��|r^|r^|j
s^t	d��dS)z�Function for determining if custom platform options are allowed.

    :param options: The OptionParser options.
    :param check_target: Whether or not to check if --target is being used.
    z:all:z�When restricting platform and interpreter constraints using --python-version, --platform, --abi, or --implementation, either --no-deps must be set, or --only-binary=:all: must be set and --no-binary must not be set (or must be set to :none:).zQCan not use any platform or abi specific options unless installing via '--target'N)r5�python_version�platform�abi�implementationr�setr7�ignore_dependenciesr	Z
target_dir)r'Zcheck_targetZdist_restriction_setZbinary_onlyZsdist_dependencies_allowedr#r#r$�check_dist_restriction[s&�
��
�rBz-hz--help�helpz
Show help.)�dest�actionrCz
--isolated�
isolated_mode�
store_truezSRun pip in an isolated mode, ignoring environment variables and user configuration.�rDrE�defaultrCz--require-virtualenvz--require-venvZrequire_venvz-vz	--verbose�verbose�countzDGive more output. Option is additive, and can be used up to 3 times.z
--no-color�no_colorzSuppress colored outputz-Vz	--version�versionzShow version and exit.z-qz--quiet�quietz�Give less output. Option is additive, and can be used up to 3 times (corresponding to WARNING, ERROR, and CRITICAL logging levels).z--progress-bar�progress_bar�choiceZonz*Specify type of progress to be displayed [�|z] (default: %default))rD�type�choicesrIrCz--logz
--log-filez--local-log�log�pathz Path to a verbose appending log.)rD�metavarrCz
--no-input�no_inputz--proxy�proxy�str�z<Specify a proxy in the form [user:passwd@]proxy.server:port.)rDrRrIrCz	--retries�retries�int�zRMaximum number of retries each connection should attempt (default %default times).z	--timeoutz--default-timeoutZsec�timeout�float�z2Set the socket timeout (default %default seconds).)rVrDrRrIrCz--skip-requirements-regex�skip_requirements_regexc
Cs"tddddddddggd	d
dd�S)
Nz--exists-action�
exists_actionrP�s�i�w�b�a�appendrEzYDefault action when a path already exists: (s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.)rDrRrSrIrErVrC�rr#r#r#r$rbs�rbz--cert�certzPath to alternate CA bundle.)rDrRrVrCz
--client-cert�client_certzkPath to SSL client certificate, a single file containing the private key and the certificate in PEM format.)rDrRrIrVrCz-iz--index-urlz
--pypi-url�	index_url�URLz�Base URL of the Python Package Index (default %default). This should point to a repository compliant with PEP 503 (the simple repository API) or a local directory laid out in the same format.)rDrVrIrCcCstddddgdd�S)Nz--extra-index-urlZextra_index_urlsrmrhzmExtra URLs of package indexes to use in addition to --index-url. Should follow the same rules as --index-url.)rDrVrErIrCrir#r#r#r$�extra_index_urlDs�rnz
--no-index�no_indexzAIgnore package index (only looking at --find-links URLs instead).c	Cstddddgddd�S)Nz-fz--find-links�
find_linksrhZurlz�If a url or path to an html file, then parse for links to archives. If a local path or file:// url that's a directory, then look for archives in the directory listing.�rDrErIrVrCrir#r#r#r$rp[s�rpcCstddddgdd�S)Nz--trusted-hostZ
trusted_hostsrhZHOSTNAMEz]Mark this host or host:port pair as trusted, even though it does not have valid or any HTTPS.)rDrErVrIrCrir#r#r#r$�trusted_hostis�rrc	Cstddddgddd�S)Nz-cz--constraint�constraintsrh�filez\Constrain versions using the given constraints file. This option can be used multiple times.rqrir#r#r#r$rsvs�rsc	Cstddddgddd�S)Nz-rz
--requirement�requirementsrhrtzQInstall from the given requirements file. This option can be used multiple times.rqrir#r#r#r$ru�s�ruc	Cstddddgddd�S)Nz-ez
--editableZ	editablesrhzpath/urlzkInstall a project in editable mode (i.e. setuptools "develop mode") from a local project path or a VCS url.rqrir#r#r#r$�editable�s�rvz--srcz--sourcez--source-dirz--source-directoryZsrc_dir�dirz�Directory to check out editable projects into. The default in a virtualenv is "<venv path>/src". The default for global installs is "<current dir>/src".cCst||j�S)zGet a format_control object.)r,rD)�valuesr!r#r#r$�_get_format_control�srycCs"t|j|�}t�||j|j�dSr+)ryrxr�handle_mutual_excludes�	no_binary�only_binary�r!�opt_str�valuer Zexistingr#r#r$�_handle_no_binary�s�r�cCs"t|j|�}t�||j|j�dSr+)ryrxrrzr|r{r}r#r#r$�_handle_only_binary�s�r�c	Cs$tt�t��}tdddtd|dd�S)Nz--no-binaryr7�callbackrYa^Do not use binary packages. Can be supplied multiple times, and each time adds to the existing value. Accepts either :all: to disable all binary packages, :none: to empty the set, or one or more package names with commas between them (no colons). Note that some packages are tricky to compile and may fail to install when this option is used on them.�rDrEr�rRrIrC)rr@rr��r7r#r#r$r{�s�r{c	Cs$tt�t��}tdddtd|dd�S)Nz
--only-binaryr7r�rYaGDo not use source packages. Can be supplied multiple times, and each time adds to the existing value. Accepts either :all: to disable all source packages, :none: to empty the set, or one or more package names with commas between them. Packages without binary distributions will fail to install when this option is used on them.r�)rr@rr�r�r#r#r$r|�s�r|z
--platformr=z[Only use wheels compatible with <platform>. Defaults to the platform of the running system.cCs�|sdS|�d�}t|�dkr"dSt|�dkrV|d}t|�dkrV|d|dd�g}ztdd	�|D��}Wntk
r�Yd
SX|dfS)z�
    Convert a version string like "3", "37", or "3.7.3" into a tuple of ints.

    :return: A 2-tuple (version_info, error_msg), where `error_msg` is
        non-None if and only if there was a parsing error.
    )NN�.�)r#z'at most three version parts are allowed�rNcss|]}t|�VqdSr+)r\)�.0�partr#r#r$�	<genexpr>sz*_convert_python_version.<locals>.<genexpr>)r#z$each version part must be an integer)r�len�tuple�
ValueError)r�parts�version_infor#r#r$�_convert_python_version�s
r�cCs:t|�\}}|dk	r.d�||�}t|||d�||j_dS)z3
    Handle a provided --python-version value.
    Nz(invalid --python-version value: {!r}: {}�r!r")r�rr%rxr<)r!r~rr r�Z	error_msgr"r#r#r$�_handle_python_version	s��r�z--python-versionr<r�a�    The Python interpreter version to use for wheel and "Requires-Python"
    compatibility checks. Defaults to a version derived from the running
    interpreter. The version can be specified using up to three dot-separated
    integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor
    version can also be given as a string without dots (e.g. "37" for 3.7.0).
    )rDrVrEr�rRrIrCz--implementationr?z�Only use wheels compatible with Python implementation <implementation>, e.g. 'pp', 'jy', 'cp',  or 'ip'. If not specified, then the current interpreter implementation is used.  Use 'py' to force implementation-agnostic wheels.z--abir>z�Only use wheels compatible with Python abi <abi>, e.g. 'pypy_41'.  If not specified, then the current interpreter abi tag is used.  Generally you will need to specify --implementation, --platform, and --python-version when using this option.cCs4|�t��|�t��|�t��|�t��dSr+)r(r=r<r?r>)Zcmd_optsr#r#r$�add_target_python_optionsIsr�cCst|j|j|j|jd�}|S)N)r=Zpy_version_infor>r?)rr=r<r>r?)r'Z
target_pythonr#r#r$�make_target_pythonQs�r�cCstdddddd�S)Nz--prefer-binary�
prefer_binaryrGFz8Prefer older binary packages over newer source packages.rHrir#r#r#r$r�]s�r�z--cache-dir�	cache_dirzStore the cache data in <dir>.)rDrIrVrCc
CsV|dk	rJzt|�Wn4tk
rH}zt||t|�d�W5d}~XYnXd|j_dS)z�
    Process a value provided for the --no-cache-dir option.

    This is an optparse.Option callback for the --no-cache-dir option.
    Nr�F)rr�r%rYrxr�)r!�optrr �excr#r#r$�_handle_no_cache_dirrs$	r�z--no-cache-dirzDisable the cache.)rDrEr�rCz	--no-depsz--no-dependenciesrAz#Don't install package dependencies.z-bz--buildz--build-dirz--build-directory�	build_dira>Directory to unpack packages into and build in. Note that an initial build still takes place in a temporary directory. The location of temporary directories can be controlled by setting the TMPDIR environment variable (TEMP on Windows) appropriately. When passed, build directories are not cleaned in case of failures.z--ignore-requires-python�ignore_requires_pythonz'Ignore the Requires-Python information.z--no-build-isolationZbuild_isolationZstore_falseTz�Disable isolation when building a modern source distribution. Build dependencies specified by PEP 518 must be already installed if this option is used.cCs&|dk	rd}t|||d�d|j_dS)z�
    Process a value provided for the --no-use-pep517 option.

    This is an optparse.Option callback for the no_use_pep517 option.
    Na0A value was passed for --no-use-pep517,
        probably using either the PIP_NO_USE_PEP517 environment variable
        or the "no-use-pep517" config file option. Use an appropriate value
        of the PIP_USE_PEP517 environment variable or the "use-pep517"
        config file option instead.
        r�F)r%rx�
use_pep517)r!r�rr r"r#r#r$�_handle_no_use_pep517�sr�z--use-pep517r�z^Use PEP 517 for building source distributions (use --no-use-pep517 to force legacy behaviour).z--no-use-pep517)rDrEr�rIrCz--install-optionr2rhr'a"Extra arguments to be supplied to the setup.py install command (use like --install-option="--install-scripts=/usr/local/bin"). Use multiple --install-option options to pass multiple options to setup.py install. If you are using an option with a directory path, be sure to use absolute path.)rDrErVrCz--global-optionr1zTExtra global options to be supplied to the setup.py call before the install command.z
--no-cleanz!Don't clean up build directories.)rErIrCz--prezYInclude pre-release and development versions. By default, pip only finds stable versions.z--disable-pip-version-check�disable_pip_version_checkz{Don't periodically check PyPI to determine whether a new version of pip is available for download. Implied with --no-index.z-Zz--always-unzip�always_unzipcCs�|jjsi|j_z|�dd�\}}Wn"tk
rF|�d|�YnX|tkrh|�d|d�t�f�|jj�|g��|�dS)zkGiven a value spelled "algo:digest", append the digest to a list
    pointed to in a dict by the algo name.�:r�zTArguments to %s must be a hash name followed by a value, like --hash=sha256:abcde...z&Allowed hash algorithms for %s are %s.z, N)	rx�hashesrr�rrr�
setdefaultrh)r!r~rr ZalgoZdigestr#r#r$�_handle_merge_hash)s��r�z--hashr��stringzgVerify that the package's archive matches this hash before installing. Example: --hash=sha256:abcdef...)rDrEr�rRrCz--require-hashes�require_hashesz�Require a hash to check each requirement against, for repeatable installs. This option is implied when any package in a requirements file has a --hash option.z--pathz^Restrict to the specified installation path for listing packages (can be used multiple times).cCs|jr|js|jrtd��dS)Nz2Cannot combine '--path' with '--user' or '--local')rU�userZlocalr	)r'r#r#r$�check_list_path_option_s�r�zGeneral Options)r&r'zPackage Index Options)N)F)t�__doc__Z
__future__rZloggingrr8Zdistutils.utilr�	functoolsrZoptparserrrrZpip._internal.exceptionsr	Zpip._internal.locationsr
rZ#pip._internal.models.format_controlrZpip._internal.models.indexr
Z"pip._internal.models.target_pythonrZpip._internal.utils.hashesrZpip._internal.utils.typingrZpip._internal.utils.uir�typingrrrrrrrZpip._internal.cli.parserrZ	getLogger�__name__Zloggerr%r*r;rBZhelp_rFZrequire_virtualenvrJrLrMrN�list�keysrrOrTrWrXr[r^rarbrjrkZ
simple_urlrlrnrorprrrsrurv�srcryr�r�r{r|r=r�r�r<r?r>r�r�r�r�r�Zno_cacheZno_depsr�r�Zno_build_isolationr�r�Z
no_use_pep517r2r1Zno_cleanZprer�r�r��hashr�Z	list_pathr�Z
general_groupZindex_groupr#r#r#r$�<module>sB



,���
�	�	��

���
��
�	�
�
��	��

�




������
�	�	����
�
�
�
��	��	���

����site-packages/pip/_internal/cli/__pycache__/base_command.cpython-38.opt-1.pyc000064400000011603151446176770023030 0ustar00U

��.eh�@s6dZddlmZmZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
mZddlmZmZddlmZmZmZmZmZddlmZmZmZmZmZdd	lmZdd
l m!Z!m"Z"ddl#m$Z$ddl%m&Z&dd
l'm(Z(e&�rddl)m*Z*m+Z+m,Z,ddlm-Z-dgZ.e�/e0�Z1Gdd�de�Z2dS)z(Base Command class, and related routines�)�absolute_import�print_functionN)�
cmdoptions)�CommandContextMixIn)�ConfigOptionParser�UpdatingDefaultsHelpFormatter)�ERROR�PREVIOUS_BUILD_DIR_ERROR�SUCCESS�
UNKNOWN_ERROR�VIRTUALENV_NOT_FOUND)�
BadCommand�CommandError�InstallationError�PreviousBuildDirError�UninstallationError)�
deprecated)�BrokenStdoutLoggingError�
setup_logging)�get_prog)�MYPY_CHECK_RUNNING)�running_under_virtualenv)�List�Tuple�Any)�Values�CommandcsNeZdZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
�ZS)rNFcs�tt|���|jdt�|ft�d||j|d�}||_||_t	f|�|_
d|j��}t�
|j
|�|_t�tj|j
�}|j
�|�dS)Nz%s %sF)�usage�progZ	formatterZadd_help_option�name�description�isolatedz
%s Options)�superr�__init__rrr�__doc__r�summaryr�parser�
capitalize�optparseZOptionGroupZcmd_optsrZmake_option_groupZ
general_groupZadd_option_group)�selfrr%r!Z	parser_kwZ
optgroup_nameZgen_opts��	__class__��B/usr/lib/python3.8/site-packages/pip/_internal/cli/base_command.pyr#4s&�
�zCommand.__init__cCsdS)zf
        This is a no-op so that commands by default do not do the pip version
        check.
        Nr,)r)�optionsr,r,r-�handle_pip_version_checkPsz Command.handle_pip_version_checkcCst�dS�N)�NotImplementedError)r)r.�argsr,r,r-�runZszCommand.runcCs|j�|�Sr0)r&�
parse_args�r)r2r,r,r-r4^szCommand.parse_argsc
Cs>z.|���|�|�W5QR�W�SQRXW5t��XdSr0)�loggingZshutdownZmain_context�_mainr5r,r,r-�maincs
$zCommand.mainc
Cs�|�|�\}}|j|j|_t|j|j|jd�}tjdd�dkrhd}t	�
�dkrZd|}t|ddd�|jrxdt
jd	<|jr�d
�|j�t
jd<|jr�|js�t�s�t�d�t�t��z�z(|�||�}t|t�r�|WW���SW�n�tk
�r2}z.t�t|��tjd
dd�tWY�W��RSd}~XY�n>t t!t"fk
�r�}z.t�t|��tjd
dd�t#WY�W���Sd}~XYn�t$k
�r�}z*t�d|�tjd
dd�t#WY�W��Sd}~XYn�t%k
�rt&dtj'd�|t(j)k�rt*j+tj'd�t#YW�fSt,k
�rDt�d�tjd
dd�t#YW�2St-k
�rntjddd�t.YW�SXW5|�|�Xt/S)N)�	verbosity�no_colorZ
user_log_file�)r;�z�A future version of pip will drop support for Python 2.7. More details about Python 2 support in pip, can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-supportZCPythonz�Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. )ZreplacementZgone_in�1ZPIP_NO_INPUT� ZPIP_EXISTS_ACTIONz2Could not find an activated virtualenv (required).zException information:T)�exc_infoz%sz ERROR: Pipe to stdout was broken)�filezOperation cancelled by userz
Exception:)0r4�verbose�quietr9rr:�log�sys�version_info�platformZpython_implementationrZno_input�os�environZ
exists_action�joinZrequire_venv�ignore_require_venvr�loggerZcritical�exitrr/r3�
isinstance�intr�str�debugr	rrr
rrr�print�stderrr6�DEBUG�	traceback�	print_exc�KeyboardInterrupt�
BaseExceptionrr
)r)r2r.Zlevel_number�messageZstatus�excr,r,r-r7ksn���
�

 
z
Command._main)F)�__name__�
__module__�__qualname__rrJr#r/r3r4r8r7�
__classcell__r,r,r*r-r0s
)3r$Z
__future__rrr6Zlogging.configr(rGrFrDrTZpip._internal.clirZ!pip._internal.cli.command_contextrZpip._internal.cli.parserrrZpip._internal.cli.status_codesrr	r
rrZpip._internal.exceptionsr
rrrrZpip._internal.utils.deprecationrZpip._internal.utils.loggingrrZpip._internal.utils.miscrZpip._internal.utils.typingrZpip._internal.utils.virtualenvr�typingrrrr�__all__Z	getLoggerrZrKrr,r,r,r-�<module>s0
site-packages/pip/_internal/cli/__pycache__/main_parser.cpython-38.pyc000064400000004157151446176770021767 0ustar00U

��.e�@s�dZddlZddlZddlmZddlmZmZddlm	Z	m
Z
ddlmZddl
mZmZddlmZer|dd	lmZmZd
dgZdd
�Zd
d�ZdS)z=A single place for constructing and exposing the main parser
�N)�
cmdoptions)�ConfigOptionParser�UpdatingDefaultsHelpFormatter)�
commands_dict�get_similar_commands)�CommandError)�get_pip_version�get_prog)�MYPY_CHECK_RUNNING)�Tuple�List�create_main_parser�
parse_commandcCstddt�dt�d�}tf|�}|��t�|_t�tj|�}|�	|�d|_
dgdd�t��D�}d	�
|�|_|S)
z6Creates and returns the main parser for pip's CLI
    z
%prog <command> [options]F�global)ZusageZadd_help_optionZ	formatter�name�progT�cSsg|]\}}d||jf�qS)z%-27s %s)Zsummary)�.0rZcommand_info�r�A/usr/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py�
<listcomp>2s�z&create_main_parser.<locals>.<listcomp>�
)rr	rZdisable_interspersed_argsr�versionrZmake_option_groupZ
general_groupZadd_option_group�mainr�items�join�description)Z	parser_kw�parserZgen_optsrrrrr
s"�


�cCs�t�}|�|�\}}|jr>tj�|j�tj�tj�t��|rZ|ddkrjt	|�dkrj|�
�t��|d}|tkr�t|�}d|g}|r�|�
d|�td�|���|dd�}|�|�||fS)Nr�help�zunknown command "%s"zmaybe you meant "%s"z - )r
�
parse_argsr�sys�stdout�write�os�linesep�exit�lenZ
print_helprr�appendrr�remove)�argsrZgeneral_optionsZ	args_elseZcmd_nameZguess�msgZcmd_argsrrrr;s&	

)�__doc__r$r!Zpip._internal.clirZpip._internal.cli.parserrrZpip._internal.commandsrrZpip._internal.exceptionsrZpip._internal.utils.miscrr	Zpip._internal.utils.typingr
�typingrr�__all__r
rrrrr�<module>s#site-packages/pip/_internal/cli/__pycache__/req_command.cpython-38.opt-1.pyc000064400000016404151446176770022711 0ustar00U

��.ec,�@sXdZddlZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
dd	lmZdd
lmZddlmZddlmZmZmZdd
lmZddlmZmZddlmZddlm Z e �r"ddl!m"Z"ddl#m$Z$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0Gdd�de�Z1Gdd�dee1�Z2Gdd�de2�Z3dS)aContains the Command base classes that depend on PipSession.

The classes in this module are in a separate module so the commands not
needing download / PackageFinder capability don't unnecessarily import the
PackageFinder machinery and all its vendored dependencies, etc.
�N)�partial)�Command)�CommandContextMixIn)�CommandError)�
PackageFinder)�Resolver)�SelectionPreferences)�
PipSession)�RequirementPreparer)�install_req_from_editable�install_req_from_line�install_req_from_req_string)�parse_requirements)�make_link_collector�pip_self_version_check)�normalize_path)�MYPY_CHECK_RUNNING)�Values)�List�Optional�Tuple)�
WheelCache)�TargetPython)�RequirementSet)�RequirementTracker)�
TempDirectorycs>eZdZdZ�fdd�Zedd��Zdd�Zdd	d
�Z�Z	S)�SessionCommandMixinzE
    A class mixin for command classes needing _build_session().
    cstt|���d|_dS)N)�superr�__init__�_session)�self��	__class__��A/usr/lib/python3.8/site-packages/pip/_internal/cli/req_command.pyr2szSessionCommandMixin.__init__cCsLg}t|dd�s*t|dd�}|r*|�|�t|dd�}|rD|�|�|pJdS)z7Return a list of index urls from user-provided options.�no_indexFZ	index_urlNZextra_index_urls)�getattr�append�extend)�cls�options�
index_urlsZurlZurlsr#r#r$�_get_index_urls6s

z#SessionCommandMixin._get_index_urlscCs"|jdkr|�|�|��|_|jS)zGet a default-managed session.N)r�
enter_context�_build_session)r r*r#r#r$�get_default_sessionDs
z'SessionCommandMixin.get_default_sessionNcCs�t|jrttj�|jd��nd|dk	r*|n|j|j|�|�d�}|j	rN|j	|_
|jr\|j|_	|jsf|rz|dk	rr|n|j|_|j
r�|j
|j
d�|_|j|j_|S)N�http)�cache�retries�
trusted_hostsr+)r0Zhttps)r	�	cache_dirr�os�path�joinr2r3r,ZcertZverifyZclient_cert�timeout�proxyZproxiesZno_inputZauthZ	prompting)r r*r2r8�sessionr#r#r$r.Ks*��
��z"SessionCommandMixin._build_session)NN)
�__name__�
__module__�__qualname__�__doc__r�classmethodr,r/r.�
__classcell__r#r#r!r$r-s

rc@seZdZdZdd�ZdS)�IndexGroupCommandz�
    Abstract base class for commands with the index_group options.

    This also corresponds to the commands that permit the pip version check.
    c	CsF|js|jrdS|j|dtd|j�d�}|�t||�W5QRXdS)z�
        Do the pip version check if not disabled.

        This overrides the default behavior of not doing the check.
        Nr�)r2r8)Zdisable_pip_version_checkr%r.�minr8r)r r*r:r#r#r$�handle_pip_version_checkzs

�z*IndexGroupCommand.handle_pip_version_checkN)r;r<r=r>rDr#r#r#r$rArsrAc	@s:eZdZed
dd��Zeddd��Zd	d
�Zddd�ZdS)�RequirementCommandNc	Cs"|j}t||j|||j|j|d�S)zQ
        Create a RequirementPreparer instance for the given parameters.
        )Z	build_dir�src_dir�download_dir�wheel_download_dir�progress_bar�build_isolation�req_tracker)r6r
rFrIrJ)Ztemp_build_dirr*rKrGrHZtemp_build_dir_pathr#r#r$�make_requirement_preparer�s�z,RequirementCommand.make_requirement_preparerFT�to-satisfy-onlyc

Cs2tt|j||
d�}t||||||j||||	|d�S)zF
        Create a Resolver instance for the given parameters.
        )�isolated�wheel_cache�
use_pep517)�preparerr:�finder�make_install_req�
use_user_site�ignore_dependencies�ignore_installed�ignore_requires_python�force_reinstall�upgrade_strategy�py_version_info)rr
�
isolated_moderrU)
rQr:rRr*rOrTrVrWrXrYrPrZrSr#r#r$�
make_resolver�s&��z RequirementCommand.make_resolverc	Cs,|jD].}t|d||||d�D]}d|_|�|�qq|D]*}	t|	d|j|j|d�}d|_|�|�q:|jD](}	t|	|j|j|d�}d|_|�|�ql|j	D]0}t||||||jd�D]}d|_|�|�q�q�|j
|_
|�s(|j�s(|j	�s(d|ji}
|j�rt
dt|
d�|j�d	���nt
d
|
��dS)z?
        Marshal cmd line args into a requirement set.
        T)Z
constraintrRr*r:rON)rNrPrO)rRr*r:rOrP�namez^You must give at least one requirement to %(name)s (maybe you meant "pip %(name)s %(links)s"?)� )ZlinkszLYou must give at least one requirement to %(name)s (see "pip help %(name)s"))ZconstraintsrZ	is_directZadd_requirementrr[rPZ	editablesrZrequirementsZrequire_hashesr]Z
find_linksr�dictr7)r Zrequirement_set�argsr*rRr:rO�filenameZ
req_to_addZreqZoptsr#r#r$�populate_requirement_set�sn
�
�
�
�

����z+RequirementCommand.populate_requirement_setcCs4t||d�}td|j|j|j|d�}tj|||d�S)z�
        Create a package finder appropriate to this requirement command.

        :param ignore_requires_python: Whether to ignore incompatible
            "Requires-Python" values in links. Defaults to False.
        )r*T)Zallow_yanked�format_controlZallow_all_prereleases�
prefer_binaryrW)�link_collector�selection_prefs�
target_python)rrrcZprerdrZcreate)r r*r:rgrWrerfr#r#r$�_build_package_finders��z(RequirementCommand._build_package_finder)NN)NFTFFrMNN)NN)r;r<r=�staticmethodrLr\rbrhr#r#r#r$rE�s$��&G�rE)4r>r5�	functoolsrZpip._internal.cli.base_commandrZ!pip._internal.cli.command_contextrZpip._internal.exceptionsrZpip._internal.indexrZpip._internal.legacy_resolverZ$pip._internal.models.selection_prefsrZpip._internal.network.sessionr	Z pip._internal.operations.preparer
Zpip._internal.req.constructorsrrr
Zpip._internal.req.req_filerZ!pip._internal.self_outdated_checkrrZpip._internal.utils.miscrZpip._internal.utils.typingrZoptparser�typingrrrZpip._internal.cacherZ"pip._internal.models.target_pythonrZpip._internal.req.req_setrZpip._internal.req.req_trackerrZpip._internal.utils.temp_dirrrrArEr#r#r#r$�<module>s4
Esite-packages/pip/_internal/cli/__pycache__/command_context.cpython-38.pyc000064400000002135151446176770022643 0ustar00U

��.e�@s,ddlmZddlmZGdd�de�ZdS)�)�contextmanager)�	ExitStackcs0eZdZ�fdd�Zedd��Zdd�Z�ZS)�CommandContextMixIncs tt|���d|_t�|_dS)NF)�superr�__init__�_in_main_contextr�
_main_context��self��	__class__��E/usr/lib/python3.8/site-packages/pip/_internal/cli/command_context.pyr
szCommandContextMixIn.__init__c	cs:|jr
t�d|_z|j�dVW5QRXW5d|_XdS)NTF)r�AssertionErrorrr	r
r
r�main_contexts
z CommandContextMixIn.main_contextcCs|js
t�|j�|�S)N)rrr�
enter_context)r
Zcontext_providerr
r
rrs
z!CommandContextMixIn.enter_context)�__name__�
__module__�__qualname__rrrr�
__classcell__r
r
rrr	s

rN)�
contextlibrZpip._vendor.contextlib2r�objectrr
r
r
r�<module>ssite-packages/pip/_internal/cli/__pycache__/parser.cpython-38.opt-1.pyc000064400000021365151446176770021722 0ustar00U

��.e%�@s�dZddlmZddlZddlZddlZddlZddlmZddl	m
Z
ddlmZddl
mZmZddlmZe�e�ZGd	d
�d
ej�ZGdd�de�ZGd
d�dej�ZGdd�de�Zdd�ZdS)zBase option parser setup�)�absolute_importN)�	strtobool)�string_types)�
UNKNOWN_ERROR)�
Configuration�ConfigurationError)�get_terminal_sizec@sReZdZdZdd�Zdd�Zddd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�ZdS)�PrettyHelpFormatterz4A prettier/less verbose help formatter for optparse.cOs:d|d<d|d<t�dd|d<tjj|f|�|�dS)N�Zmax_help_position�Zindent_incrementr��width)r�optparse�IndentedHelpFormatter�__init__)�self�args�kwargs�r�</usr/lib/python3.8/site-packages/pip/_internal/cli/parser.pyrszPrettyHelpFormatter.__init__cCs|�|dd�S)N� <%s>�, )�_format_option_strings�r�optionrrr�format_option_strings!sz)PrettyHelpFormatter.format_option_stringsrrcCs|g}|jr|�|jd�|jr0|�|jd�t|�dkrH|�d|�|��rr|jp^|j��}|�||���d�	|�S)a
        Return a comma-separated list of option strings and metavars.

        :param option:  tuple of (short opt, long opt), e.g: ('-f', '--format')
        :param mvarfmt: metavar format string - evaluated as mvarfmt % metavar
        :param optsep:  separator
        rr�)
Z_short_opts�appendZ
_long_opts�len�insertZtakes_value�metavar�dest�lower�join)rrZmvarfmtZoptsepZoptsr rrrr$sz*PrettyHelpFormatter._format_option_stringscCs|dkrdS|dS)NZOptionsrz:
r)rZheadingrrr�format_heading;sz"PrettyHelpFormatter.format_headingcCsd|�t�|�d�}|S)zz
        Ensure there is only one newline between usage and the first heading
        if there is no description.
        z
Usage: %s
�  )�indent_lines�textwrap�dedent)rZusage�msgrrr�format_usage@sz PrettyHelpFormatter.format_usagecCsV|rNt|jd�rd}nd}|�d�}|��}|�t�|�d�}d||f}|SdSdS)N�mainZCommandsZDescription�
r%z%s:
%s
r)�hasattr�parser�lstrip�rstripr&r'r()r�descriptionZlabelrrr�format_descriptionHs
z&PrettyHelpFormatter.format_descriptioncCs|r|SdSdS)Nrr)rZepilogrrr�
format_epilogZsz!PrettyHelpFormatter.format_epilogcs"�fdd�|�d�D�}d�|�S)Ncsg|]}�|�qSrr)�.0�line��indentrr�
<listcomp>bsz4PrettyHelpFormatter.indent_lines.<locals>.<listcomp>r,)�splitr#)r�textr7Z	new_linesrr6rr&asz PrettyHelpFormatter.indent_linesN)rr)�__name__�
__module__�__qualname__�__doc__rrrr$r*r2r3r&rrrrr	s
r	c@seZdZdZdd�ZdS)�UpdatingDefaultsHelpFormatterz�Custom help formatter for use in ConfigOptionParser.

    This is updates the defaults before expanding them, allowing
    them to show up correctly in the help listing.
    cCs(|jdk	r|j�|jj�tj�||�S)N)r.�_update_defaults�defaultsrr�expand_defaultrrrrrBms
z,UpdatingDefaultsHelpFormatter.expand_defaultN)r;r<r=r>rBrrrrr?fsr?c@s eZdZdd�Zedd��ZdS)�CustomOptionParsercOs(|j||�}|j��|j�||�|S)z*Insert an OptionGroup at a given position.)Zadd_option_group�
option_groups�popr)r�idxrr�grouprrr�insert_option_groupus
z&CustomOptionParser.insert_option_groupcCs*|jdd�}|jD]}|�|j�q|S)z<Get a list of all options, including those in option groups.N)Zoption_listrD�extend)r�res�irrr�option_list_all~s
z"CustomOptionParser.option_list_allN)r;r<r=rH�propertyrLrrrrrCss	rCc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)�ConfigOptionParserzsCustom option parser which updates its defaults by checking the
    configuration files and environmental variablescOs:|�d�|_|�dd�}t|�|_tjj|f|�|�dS)N�name�isolatedF)rErOr�configr�OptionParserr)rrrrPrrrr�s
zConfigOptionParser.__init__c
CsNz|�||�WStjk
rH}ztd|�t�d�W5d}~XYnXdS)Nz*An error occurred during configuration: %s�)�check_valuerZOptionValueError�print�sys�exit)rr�key�val�excrrr�
check_default�s
z ConfigOptionParser.check_defaultccs�d|jdg}dd�|D�}|j��D]D\}}|s>t�d|�q$|�dd�\}}||kr$||�||f�q$|D] }||D]\}}||fVqzqndS)N�globalz:env:cSsi|]
}|g�qSrr)r4rOrrr�
<dictcomp>�szGConfigOptionParser._get_ordered_configuration_items.<locals>.<dictcomp>z7Ignoring configuration key '%s' as it's value is empty.�.r)rOrQ�items�logger�debugr9r)rZoverride_orderZ
section_itemsZsection_keyrYZsectionrXrrr� _get_ordered_configuration_items�s�z3ConfigOptionParser._get_ordered_configuration_itemsc	sHt��j��_t�}���D�]\�}��d����dkr>q�jdkr�zt|�}Wn,t	k
r�t
�j�|�}��|�YnXn��jdkr�|��}���fdd�|D�}nh�jdk�r|�
�j����}��||�}�jp�d}�jp�i}�j�||�f|�|�n����|�}||�j<q|D]�t�j��|�<�q&d�_|S)	z�Updates the given defaults with values from the config files and
        the environ. Does a little special handling for certain types of
        options (lists).z--N)�
store_true�store_false�countrcsg|]}����|��qSr)r[)r4�v�rXrrrrr8�sz7ConfigOptionParser._update_defaults.<locals>.<listcomp>�callbackr)r�ValuesrA�values�setrbZ
get_option�actionr�
ValueError�invalid_config_error_message�errorr9�addr!�get_opt_stringZ
convert_valueZ
callback_argsZcallback_kwargsrhr[�getattr)rrAZ	late_evalrYZ	error_msg�opt_strrrrrgrr@�s@
�


z#ConfigOptionParser._update_defaultsc
Cs�|jst�|j�Sz|j��Wn2tk
rR}z|�tt	|��W5d}~XYnX|�
|j���}|��D]4}|�
|j�}t|t�rl|��}|�||�||j<qlt�|�S)z�Overriding to make updating the defaults after instantiation of
        the option parser possible, _update_defaults() does the dirty work.N)Zprocess_default_valuesrrirArQ�loadrrWr�strr@�copyZ_get_all_options�getr!�
isinstancerrqrT)r�errrAr�defaultrsrrr�get_default_values�s"
z%ConfigOptionParser.get_default_valuescCs |�tj�|�td|�dS)Nz%s
)Zprint_usagerV�stderrrWr)rr)rrrro�szConfigOptionParser.errorN)
r;r<r=r>rr[rbr@r{rorrrrrN�s	1rNcCs |dkrd�||�Sd�||�S)zQReturns a better error message when invalid configuration option
    is provided.)rcrdzo{0} is not a valid value for {1} option, please specify a boolean value like yes/no, true/false or 1/0 instead.z[{0} is not a valid value for {1} option, please specify a numerical value like 1/0 instead.)�format)rlrXrYrrrrn�s��rn)r>Z
__future__rZloggingrrVr'Zdistutils.utilrZpip._vendor.sixrZpip._internal.cli.status_codesrZpip._internal.configurationrrZpip._internal.utils.compatrZ	getLoggerr;r`rr	r?rRrCrNrnrrrr�<module>s 
O
wsite-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-38.opt-1.pyc000064400000011561151446176770023465 0ustar00U

��.e�@s`dZddlZddlZddlZddlmZddlmZmZddl	m
Z
dd�Zdd	�Zd
d�Z
dS)zBLogic that powers autocompletion installed by ``pip completion``.
�N)�create_main_parser)�
commands_dict�create_command)�get_installed_distributionscs�dtjkrdStjd��dd�}ttjd�}z||d�Wntk
rZd�YnXtt��g}z�fdd�|D�d	}Wntk
r�d}YnXt�}|�r:|d
kr�t�	d�|dkö�
d�}|�r>g}���}td
d�D].}|j
�
|�r�|j
|dd�kr�|�|j
�q�|�r>|D]}t|��q$t�	d�t|�}	|	jjD]8}
|
jtjk�rN|
j|
jD]}|�||
jf��ql�qNdd�|d|d�D���fdd�|D�}�fdd�|D�}t|||	jj�}|�r�t�|�}dd�|D�}|D]>}
|
d	}|
d�r,|
d	dd�dk�r,|d7}t|��q�n�dd�|jD�}|�|j�dd�|D�}��
d��r�|D]$}
|
jtjk�rt�|
j|
j7��qtnt|||�}|�r�t�|��td��fdd��D���t�	d�dS)z?Entry Point for completion of main and subcommand options.
    ZPIP_AUTO_COMPLETENZ
COMP_WORDS�Z
COMP_CWORD�csg|]}|�kr|�qS�r)�.0�w)�subcommandsr�D/usr/lib/python3.8/site-packages/pip/_internal/cli/autocompletion.py�
<listcomp>!sz autocomplete.<locals>.<listcomp>r�help)ZshowZ	uninstall�-T)Z
local_onlycSsg|]}|�d�d�qS)�=r)�split�r	�xrrrr
Dscs g|]\}}|�kr||f�qSrr)r	r�v)�	prev_optsrrr
Escs"g|]\}}|���r||f�qSr��
startswith)r	�kr��currentrrr
Gs
css|]}|dfVqdS)rNr)r	�optrrr�	<genexpr>Pszautocomplete.<locals>.<genexpr>�z--rcSsg|]
}|j�qSr)�option_list)r	�irrrr
Zscss|]}|D]
}|Vq
qdS�Nr)r	�it�orrrr\s� csg|]}|���r|�qSrrrrrrr
gs
)�os�environr�int�
IndexError�listrr�sys�exitr�lowerr�key�append�printr�parserZoption_list_allr�optparse�
SUPPRESS_HELPZ
_long_optsZ_short_opts�nargs�get_path_completion_type�auto_complete_pathsZ
option_groupsr�join)�cwords�cwordZoptionsZsubcommand_namer/Zshould_list_installedZ	installedZlcZdistZ
subcommandrZopt_str�completion_typeZoptionZ	opt_label�optsr)rrrr�autocompletes�




�
�
 
r:cCs�|dks||d�d�sdS|D]n}|jtjkr4q"t|��d�D]L}||d�d�d|krB|jr�tdd�|j�d�D��rB|jSqBq"dS)	aLGet the type of path completion (``file``, ``dir``, ``path`` or None)

    :param cwords: same as the environmental variable ``COMP_WORDS``
    :param cword: same as the environmental variable ``COMP_CWORD``
    :param opts: The available options to check
    :return: path completion type (``file``, ``dir``, ``path`` or None)
    rrN�/rrcss|]}|dkVqdS))�path�file�dirNrrrrrrzs�z+get_path_completion_type.<locals>.<genexpr>)rrr0r1�strr�metavar�any)r6r7r9rr"rrrr3ks
�r3c#s�tj�|�\}�tj�|�}t�|tj�s.dStj�����fdd�t�|�D�}|D]`}tj�||�}tj�tj�||��}|dkr�tj�	|�r�|VqVtj�
|�rVtj�|d�VqVdS)aoIf ``completion_type`` is ``file`` or ``path``, list all regular files
    and directories starting with ``current``; otherwise only list directories
    starting with ``current``.

    :param current: The word to be completed
    :param completion_type: path completion type(`file`, `path` or `dir`)i
    :return: A generator of regular files and/or directories
    Nc3s$|]}tj�|����r|VqdSr )r$r<�normcaserr��filenamerrr�s�z&auto_complete_paths.<locals>.<genexpr>r>r)r$r<r�abspath�access�R_OKrB�listdirr5�isfile�isdir)rr8Z	directoryZcurrent_pathZ	file_list�frZ	comp_filerrCrr4�s	r4)�__doc__r0r$r)Zpip._internal.cli.main_parserrZpip._internal.commandsrrZpip._internal.utils.miscrr:r3r4rrrr�<module>s[site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-38.opt-1.pyc000064400000000555151446176770023124 0ustar00U

��.e��@s(ddlmZdZdZdZdZdZdZdS)�)�absolute_import�����N)Z
__future__r�SUCCESSZERRORZ
UNKNOWN_ERRORZVIRTUALENV_NOT_FOUNDZPREVIOUS_BUILD_DIR_ERRORZNO_MATCHES_FOUND�r	r	�B/usr/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py�<module>ssite-packages/pip/_internal/cli/__pycache__/command_context.cpython-38.opt-1.pyc000064400000002053151446176770023601 0ustar00U

��.e�@s,ddlmZddlmZGdd�de�ZdS)�)�contextmanager)�	ExitStackcs0eZdZ�fdd�Zedd��Zdd�Z�ZS)�CommandContextMixIncs tt|���d|_t�|_dS)NF)�superr�__init__�_in_main_contextr�
_main_context��self��	__class__��E/usr/lib/python3.8/site-packages/pip/_internal/cli/command_context.pyr
szCommandContextMixIn.__init__c	cs0d|_z|j�dVW5QRXW5d|_XdS)NTF)rrr	r
r
r�main_contexts
z CommandContextMixIn.main_contextcCs|j�|�S)N)r�
enter_context)r
Zcontext_providerr
r
rrsz!CommandContextMixIn.enter_context)�__name__�
__module__�__qualname__rrrr�
__classcell__r
r
rrr	s

rN)�
contextlibrZpip._vendor.contextlib2r�objectrr
r
r
r�<module>ssite-packages/pip/_internal/cli/__pycache__/base_command.cpython-38.pyc000064400000011661151446176770022075 0ustar00U

��.eh�@s6dZddlmZmZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
mZddlmZmZddlmZmZmZmZmZddlmZmZmZmZmZdd	lmZdd
l m!Z!m"Z"ddl#m$Z$ddl%m&Z&dd
l'm(Z(e&�rddl)m*Z*m+Z+m,Z,ddlm-Z-dgZ.e�/e0�Z1Gdd�de�Z2dS)z(Base Command class, and related routines�)�absolute_import�print_functionN)�
cmdoptions)�CommandContextMixIn)�ConfigOptionParser�UpdatingDefaultsHelpFormatter)�ERROR�PREVIOUS_BUILD_DIR_ERROR�SUCCESS�
UNKNOWN_ERROR�VIRTUALENV_NOT_FOUND)�
BadCommand�CommandError�InstallationError�PreviousBuildDirError�UninstallationError)�
deprecated)�BrokenStdoutLoggingError�
setup_logging)�get_prog)�MYPY_CHECK_RUNNING)�running_under_virtualenv)�List�Tuple�Any)�Values�CommandcsNeZdZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
�ZS)rNFcs�tt|���|jdt�|ft�d||j|d�}||_||_t	f|�|_
d|j��}t�
|j
|�|_t�tj|j
�}|j
�|�dS)Nz%s %sF)�usage�progZ	formatterZadd_help_option�name�description�isolatedz
%s Options)�superr�__init__rrr�__doc__r�summaryr�parser�
capitalize�optparseZOptionGroupZcmd_optsrZmake_option_groupZ
general_groupZadd_option_group)�selfrr%r!Z	parser_kwZ
optgroup_nameZgen_opts��	__class__��B/usr/lib/python3.8/site-packages/pip/_internal/cli/base_command.pyr#4s&�
�zCommand.__init__cCst|d�rt�dS)zf
        This is a no-op so that commands by default do not do the pip version
        check.
        Zno_indexN)�hasattr�AssertionError)r)�optionsr,r,r-�handle_pip_version_checkPsz Command.handle_pip_version_checkcCst�dS�N)�NotImplementedError)r)r0�argsr,r,r-�runZszCommand.runcCs|j�|�Sr2)r&�
parse_args�r)r4r,r,r-r6^szCommand.parse_argsc
Cs>z.|���|�|�W5QR�W�SQRXW5t��XdSr2)�loggingZshutdownZmain_context�_mainr7r,r,r-�maincs
$zCommand.mainc
Cs�|�|�\}}|j|j|_t|j|j|jd�}tjdd�dkrhd}t	�
�dkrZd|}t|ddd�|jrxdt
jd	<|jr�d
�|j�t
jd<|jr�|js�t�s�t�d�t�t��z�z(|�||�}t|t�r�|WW���SW�n�tk
�r2}z.t�t|��tjd
dd�tWY�W��RSd}~XY�n>t t!t"fk
�r�}z.t�t|��tjd
dd�t#WY�W���Sd}~XYn�t$k
�r�}z*t�d|�tjd
dd�t#WY�W��Sd}~XYn�t%k
�rt&dtj'd�|t(j)k�rt*j+tj'd�t#YW�fSt,k
�rDt�d�tjd
dd�t#YW�2St-k
�rntjddd�t.YW�SXW5|�|�Xt/S)N)�	verbosity�no_colorZ
user_log_file�)r=�z�A future version of pip will drop support for Python 2.7. More details about Python 2 support in pip, can be found at https://pip.pypa.io/en/latest/development/release-process/#python-2-supportZCPythonz�Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. )ZreplacementZgone_in�1ZPIP_NO_INPUT� ZPIP_EXISTS_ACTIONz2Could not find an activated virtualenv (required).zException information:T)�exc_infoz%sz ERROR: Pipe to stdout was broken)�filezOperation cancelled by userz
Exception:)0r6�verbose�quietr;rr<�log�sys�version_info�platformZpython_implementationrZno_input�os�environZ
exists_action�joinZrequire_venv�ignore_require_venvr�loggerZcritical�exitrr1r5�
isinstance�intr�str�debugr	rrr
rrr�print�stderrr8�DEBUG�	traceback�	print_exc�KeyboardInterrupt�
BaseExceptionrr
)r)r4r0Zlevel_number�messageZstatus�excr,r,r-r9ksn���
�

 
z
Command._main)F)�__name__�
__module__�__qualname__rrLr#r1r5r6r:r9�
__classcell__r,r,r*r-r0s
)3r$Z
__future__rrr8Zlogging.configr(rIrHrFrVZpip._internal.clirZ!pip._internal.cli.command_contextrZpip._internal.cli.parserrrZpip._internal.cli.status_codesrr	r
rrZpip._internal.exceptionsr
rrrrZpip._internal.utils.deprecationrZpip._internal.utils.loggingrrZpip._internal.utils.miscrZpip._internal.utils.typingrZpip._internal.utils.virtualenvr�typingrrrr�__all__Z	getLoggerr\rMrr,r,r,r-�<module>s0
site-packages/pip/_internal/cli/__pycache__/req_command.cpython-38.pyc000064400000016506151446176770021755 0ustar00U

��.ec,�@sXdZddlZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
dd	lmZdd
lmZddlmZddlmZmZmZdd
lmZddlmZmZddlmZddlm Z e �r"ddl!m"Z"ddl#m$Z$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0Gdd�de�Z1Gdd�dee1�Z2Gdd�de2�Z3dS)aContains the Command base classes that depend on PipSession.

The classes in this module are in a separate module so the commands not
needing download / PackageFinder capability don't unnecessarily import the
PackageFinder machinery and all its vendored dependencies, etc.
�N)�partial)�Command)�CommandContextMixIn)�CommandError)�
PackageFinder)�Resolver)�SelectionPreferences)�
PipSession)�RequirementPreparer)�install_req_from_editable�install_req_from_line�install_req_from_req_string)�parse_requirements)�make_link_collector�pip_self_version_check)�normalize_path)�MYPY_CHECK_RUNNING)�Values)�List�Optional�Tuple)�
WheelCache)�TargetPython)�RequirementSet)�RequirementTracker)�
TempDirectorycs>eZdZdZ�fdd�Zedd��Zdd�Zdd	d
�Z�Z	S)�SessionCommandMixinzE
    A class mixin for command classes needing _build_session().
    cstt|���d|_dS)N)�superr�__init__�_session)�self��	__class__��A/usr/lib/python3.8/site-packages/pip/_internal/cli/req_command.pyr2szSessionCommandMixin.__init__cCsLg}t|dd�s*t|dd�}|r*|�|�t|dd�}|rD|�|�|pJdS)z7Return a list of index urls from user-provided options.�no_indexFZ	index_urlNZextra_index_urls)�getattr�append�extend)�cls�options�
index_urlsZurlZurlsr#r#r$�_get_index_urls6s

z#SessionCommandMixin._get_index_urlscCs"|jdkr|�|�|��|_|jS)zGet a default-managed session.N)r�
enter_context�_build_session)r r*r#r#r$�get_default_sessionDs
z'SessionCommandMixin.get_default_sessionNcCs�t|jrttj�|jd��nd|dk	r*|n|j|j|�|�d�}|j	rN|j	|_
|jr\|j|_	|jsf|rz|dk	rr|n|j|_|j
r�|j
|j
d�|_|j|j_|S)N�http)�cache�retries�
trusted_hostsr+)r0Zhttps)r	�	cache_dirr�os�path�joinr2r3r,ZcertZverifyZclient_cert�timeout�proxyZproxiesZno_inputZauthZ	prompting)r r*r2r8�sessionr#r#r$r.Ks*��
��z"SessionCommandMixin._build_session)NN)
�__name__�
__module__�__qualname__�__doc__r�classmethodr,r/r.�
__classcell__r#r#r!r$r-s

rc@seZdZdZdd�ZdS)�IndexGroupCommandz�
    Abstract base class for commands with the index_group options.

    This also corresponds to the commands that permit the pip version check.
    c	CsTt|d�st�|js|jrdS|j|dtd|j�d�}|�t||�W5QRXdS)z�
        Do the pip version check if not disabled.

        This overrides the default behavior of not doing the check.
        r%Nr�)r2r8)�hasattr�AssertionErrorZdisable_pip_version_checkr%r.�minr8r)r r*r:r#r#r$�handle_pip_version_checkzs
�z*IndexGroupCommand.handle_pip_version_checkN)r;r<r=r>rFr#r#r#r$rArsrAc	@s:eZdZed
dd��Zeddd��Zd	d
�Zddd�ZdS)�RequirementCommandNc	Cs.|j}|dk	st�t||j|||j|j|d�S)zQ
        Create a RequirementPreparer instance for the given parameters.
        N)Z	build_dir�src_dir�download_dir�wheel_download_dir�progress_bar�build_isolation�req_tracker)r6rDr
rHrKrL)Ztemp_build_dirr*rMrIrJZtemp_build_dir_pathr#r#r$�make_requirement_preparer�s�z,RequirementCommand.make_requirement_preparerFT�to-satisfy-onlyc

Cs2tt|j||
d�}t||||||j||||	|d�S)zF
        Create a Resolver instance for the given parameters.
        )�isolated�wheel_cache�
use_pep517)�preparerr:�finder�make_install_req�
use_user_site�ignore_dependencies�ignore_installed�ignore_requires_python�force_reinstall�upgrade_strategy�py_version_info)rr
�
isolated_moderrW)
rSr:rTr*rQrVrXrYrZr[rRr\rUr#r#r$�
make_resolver�s&��z RequirementCommand.make_resolverc	Cs,|jD].}t|d||||d�D]}d|_|�|�qq|D]*}	t|	d|j|j|d�}d|_|�|�q:|jD](}	t|	|j|j|d�}d|_|�|�ql|j	D]0}t||||||jd�D]}d|_|�|�q�q�|j
|_
|�s(|j�s(|j	�s(d|ji}
|j�rt
dt|
d�|j�d	���nt
d
|
��dS)z?
        Marshal cmd line args into a requirement set.
        T)Z
constraintrTr*r:rQN)rPrRrQ)rTr*r:rQrR�namez^You must give at least one requirement to %(name)s (maybe you meant "pip %(name)s %(links)s"?)� )ZlinkszLYou must give at least one requirement to %(name)s (see "pip help %(name)s"))ZconstraintsrZ	is_directZadd_requirementrr]rRZ	editablesrZrequirementsZrequire_hashesr_Z
find_linksr�dictr7)r Zrequirement_set�argsr*rTr:rQ�filenameZ
req_to_addZreqZoptsr#r#r$�populate_requirement_set�sn
�
�
�
�

����z+RequirementCommand.populate_requirement_setcCs4t||d�}td|j|j|j|d�}tj|||d�S)z�
        Create a package finder appropriate to this requirement command.

        :param ignore_requires_python: Whether to ignore incompatible
            "Requires-Python" values in links. Defaults to False.
        )r*T)Zallow_yanked�format_controlZallow_all_prereleases�
prefer_binaryrY)�link_collector�selection_prefs�
target_python)rrreZprerfrZcreate)r r*r:rirYrgrhr#r#r$�_build_package_finders��z(RequirementCommand._build_package_finder)NN)NFTFFrONN)NN)r;r<r=�staticmethodrNr^rdrjr#r#r#r$rG�s$��&G�rG)4r>r5�	functoolsrZpip._internal.cli.base_commandrZ!pip._internal.cli.command_contextrZpip._internal.exceptionsrZpip._internal.indexrZpip._internal.legacy_resolverZ$pip._internal.models.selection_prefsrZpip._internal.network.sessionr	Z pip._internal.operations.preparer
Zpip._internal.req.constructorsrrr
Zpip._internal.req.req_filerZ!pip._internal.self_outdated_checkrrZpip._internal.utils.miscrZpip._internal.utils.typingrZoptparser�typingrrrZpip._internal.cacherZ"pip._internal.models.target_pythonrZpip._internal.req.req_setrZpip._internal.req.req_trackerrZpip._internal.utils.temp_dirrrrArGr#r#r#r$�<module>s4
Esite-packages/pip/_internal/cli/__pycache__/main_parser.cpython-38.opt-1.pyc000064400000004157151446176770022726 0ustar00U

��.e�@s�dZddlZddlZddlmZddlmZmZddlm	Z	m
Z
ddlmZddl
mZmZddlmZer|dd	lmZmZd
dgZdd
�Zd
d�ZdS)z=A single place for constructing and exposing the main parser
�N)�
cmdoptions)�ConfigOptionParser�UpdatingDefaultsHelpFormatter)�
commands_dict�get_similar_commands)�CommandError)�get_pip_version�get_prog)�MYPY_CHECK_RUNNING)�Tuple�List�create_main_parser�
parse_commandcCstddt�dt�d�}tf|�}|��t�|_t�tj|�}|�	|�d|_
dgdd�t��D�}d	�
|�|_|S)
z6Creates and returns the main parser for pip's CLI
    z
%prog <command> [options]F�global)ZusageZadd_help_optionZ	formatter�name�progT�cSsg|]\}}d||jf�qS)z%-27s %s)Zsummary)�.0rZcommand_info�r�A/usr/lib/python3.8/site-packages/pip/_internal/cli/main_parser.py�
<listcomp>2s�z&create_main_parser.<locals>.<listcomp>�
)rr	rZdisable_interspersed_argsr�versionrZmake_option_groupZ
general_groupZadd_option_group�mainr�items�join�description)Z	parser_kw�parserZgen_optsrrrrr
s"�


�cCs�t�}|�|�\}}|jr>tj�|j�tj�tj�t��|rZ|ddkrjt	|�dkrj|�
�t��|d}|tkr�t|�}d|g}|r�|�
d|�td�|���|dd�}|�|�||fS)Nr�help�zunknown command "%s"zmaybe you meant "%s"z - )r
�
parse_argsr�sys�stdout�write�os�linesep�exit�lenZ
print_helprr�appendrr�remove)�argsrZgeneral_optionsZ	args_elseZcmd_nameZguess�msgZcmd_argsrrrr;s&	

)�__doc__r$r!Zpip._internal.clirZpip._internal.cli.parserrrZpip._internal.commandsrrZpip._internal.exceptionsrZpip._internal.utils.miscrr	Zpip._internal.utils.typingr
�typingrr�__all__r
rrrrr�<module>s#site-packages/pip/_internal/cli/__pycache__/autocompletion.cpython-38.pyc000064400000011561151446176770022526 0ustar00U

��.e�@s`dZddlZddlZddlZddlmZddlmZmZddl	m
Z
dd�Zdd	�Zd
d�Z
dS)zBLogic that powers autocompletion installed by ``pip completion``.
�N)�create_main_parser)�
commands_dict�create_command)�get_installed_distributionscs�dtjkrdStjd��dd�}ttjd�}z||d�Wntk
rZd�YnXtt��g}z�fdd�|D�d	}Wntk
r�d}YnXt�}|�r:|d
kr�t�	d�|dkö�
d�}|�r>g}���}td
d�D].}|j
�
|�r�|j
|dd�kr�|�|j
�q�|�r>|D]}t|��q$t�	d�t|�}	|	jjD]8}
|
jtjk�rN|
j|
jD]}|�||
jf��ql�qNdd�|d|d�D���fdd�|D�}�fdd�|D�}t|||	jj�}|�r�t�|�}dd�|D�}|D]>}
|
d	}|
d�r,|
d	dd�dk�r,|d7}t|��q�n�dd�|jD�}|�|j�dd�|D�}��
d��r�|D]$}
|
jtjk�rt�|
j|
j7��qtnt|||�}|�r�t�|��td��fdd��D���t�	d�dS)z?Entry Point for completion of main and subcommand options.
    ZPIP_AUTO_COMPLETENZ
COMP_WORDS�Z
COMP_CWORD�csg|]}|�kr|�qS�r)�.0�w)�subcommandsr�D/usr/lib/python3.8/site-packages/pip/_internal/cli/autocompletion.py�
<listcomp>!sz autocomplete.<locals>.<listcomp>r�help)ZshowZ	uninstall�-T)Z
local_onlycSsg|]}|�d�d�qS)�=r)�split�r	�xrrrr
Dscs g|]\}}|�kr||f�qSrr)r	r�v)�	prev_optsrrr
Escs"g|]\}}|���r||f�qSr��
startswith)r	�kr��currentrrr
Gs
css|]}|dfVqdS)rNr)r	�optrrr�	<genexpr>Pszautocomplete.<locals>.<genexpr>�z--rcSsg|]
}|j�qSr)�option_list)r	�irrrr
Zscss|]}|D]
}|Vq
qdS�Nr)r	�it�orrrr\s� csg|]}|���r|�qSrrrrrrr
gs
)�os�environr�int�
IndexError�listrr�sys�exitr�lowerr�key�append�printr�parserZoption_list_allr�optparse�
SUPPRESS_HELPZ
_long_optsZ_short_opts�nargs�get_path_completion_type�auto_complete_pathsZ
option_groupsr�join)�cwords�cwordZoptionsZsubcommand_namer/Zshould_list_installedZ	installedZlcZdistZ
subcommandrZopt_str�completion_typeZoptionZ	opt_label�optsr)rrrr�autocompletes�




�
�
 
r:cCs�|dks||d�d�sdS|D]n}|jtjkr4q"t|��d�D]L}||d�d�d|krB|jr�tdd�|j�d�D��rB|jSqBq"dS)	aLGet the type of path completion (``file``, ``dir``, ``path`` or None)

    :param cwords: same as the environmental variable ``COMP_WORDS``
    :param cword: same as the environmental variable ``COMP_CWORD``
    :param opts: The available options to check
    :return: path completion type (``file``, ``dir``, ``path`` or None)
    rrN�/rrcss|]}|dkVqdS))�path�file�dirNrrrrrrzs�z+get_path_completion_type.<locals>.<genexpr>)rrr0r1�strr�metavar�any)r6r7r9rr"rrrr3ks
�r3c#s�tj�|�\}�tj�|�}t�|tj�s.dStj�����fdd�t�|�D�}|D]`}tj�||�}tj�tj�||��}|dkr�tj�	|�r�|VqVtj�
|�rVtj�|d�VqVdS)aoIf ``completion_type`` is ``file`` or ``path``, list all regular files
    and directories starting with ``current``; otherwise only list directories
    starting with ``current``.

    :param current: The word to be completed
    :param completion_type: path completion type(`file`, `path` or `dir`)i
    :return: A generator of regular files and/or directories
    Nc3s$|]}tj�|����r|VqdSr )r$r<�normcaserr��filenamerrr�s�z&auto_complete_paths.<locals>.<genexpr>r>r)r$r<r�abspath�access�R_OKrB�listdirr5�isfile�isdir)rr8Z	directoryZcurrent_pathZ	file_list�frZ	comp_filerrCrr4�s	r4)�__doc__r0r$r)Zpip._internal.cli.main_parserrZpip._internal.commandsrrZpip._internal.utils.miscrr:r3r4rrrr�<module>s[site-packages/pip/_internal/cli/__pycache__/status_codes.cpython-38.pyc000064400000000555151446176770022165 0ustar00U

��.e��@s(ddlmZdZdZdZdZdZdZdS)�)�absolute_import�����N)Z
__future__r�SUCCESSZERRORZ
UNKNOWN_ERRORZVIRTUALENV_NOT_FOUNDZPREVIOUS_BUILD_DIR_ERRORZNO_MATCHES_FOUND�r	r	�B/usr/lib/python3.8/site-packages/pip/_internal/cli/status_codes.py�<module>ssite-packages/pip/_internal/cli/__pycache__/__init__.cpython-38.pyc000064400000000354151446176770021221 0ustar00U

��.e��@sdZdS)zGSubpackage containing all of pip's command line interface related code
N)�__doc__�rr�>/usr/lib/python3.8/site-packages/pip/_internal/cli/__init__.py�<module>�site-packages/pip/_internal/cli/__init__.py000064400000000204151446176770014725 0ustar00"""Subpackage containing all of pip's command line interface related code
"""

# This file intentionally does not import submodules
site-packages/pip/_internal/cli/req_command.py000064400000026143151446176770015465 0ustar00"""Contains the Command base classes that depend on PipSession.

The classes in this module are in a separate module so the commands not
needing download / PackageFinder capability don't unnecessarily import the
PackageFinder machinery and all its vendored dependencies, etc.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import os
from functools import partial

from pip._internal.cli.base_command import Command
from pip._internal.cli.command_context import CommandContextMixIn
from pip._internal.exceptions import CommandError
from pip._internal.index import PackageFinder
from pip._internal.legacy_resolve import Resolver
from pip._internal.models.selection_prefs import SelectionPreferences
from pip._internal.network.session import PipSession
from pip._internal.operations.prepare import RequirementPreparer
from pip._internal.req.constructors import (
    install_req_from_editable,
    install_req_from_line,
    install_req_from_req_string,
)
from pip._internal.req.req_file import parse_requirements
from pip._internal.self_outdated_check import (
    make_link_collector,
    pip_self_version_check,
)
from pip._internal.utils.misc import normalize_path
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from optparse import Values
    from typing import List, Optional, Tuple
    from pip._internal.cache import WheelCache
    from pip._internal.models.target_python import TargetPython
    from pip._internal.req.req_set import RequirementSet
    from pip._internal.req.req_tracker import RequirementTracker
    from pip._internal.utils.temp_dir import TempDirectory


class SessionCommandMixin(CommandContextMixIn):

    """
    A class mixin for command classes needing _build_session().
    """
    def __init__(self):
        super(SessionCommandMixin, self).__init__()
        self._session = None  # Optional[PipSession]

    @classmethod
    def _get_index_urls(cls, options):
        """Return a list of index urls from user-provided options."""
        index_urls = []
        if not getattr(options, "no_index", False):
            url = getattr(options, "index_url", None)
            if url:
                index_urls.append(url)
        urls = getattr(options, "extra_index_urls", None)
        if urls:
            index_urls.extend(urls)
        # Return None rather than an empty list
        return index_urls or None

    def get_default_session(self, options):
        # type: (Values) -> PipSession
        """Get a default-managed session."""
        if self._session is None:
            self._session = self.enter_context(self._build_session(options))
        return self._session

    def _build_session(self, options, retries=None, timeout=None):
        # type: (Values, Optional[int], Optional[int]) -> PipSession
        session = PipSession(
            cache=(
                normalize_path(os.path.join(options.cache_dir, "http"))
                if options.cache_dir else None
            ),
            retries=retries if retries is not None else options.retries,
            trusted_hosts=options.trusted_hosts,
            index_urls=self._get_index_urls(options),
        )

        # Handle custom ca-bundles from the user
        if options.cert:
            session.verify = options.cert

        # Handle SSL client certificate
        if options.client_cert:
            session.cert = options.client_cert

        # Handle timeouts
        if options.timeout or timeout:
            session.timeout = (
                timeout if timeout is not None else options.timeout
            )

        # Handle configured proxies
        if options.proxy:
            session.proxies = {
                "http": options.proxy,
                "https": options.proxy,
            }

        # Determine if we can prompt the user for authentication or not
        session.auth.prompting = not options.no_input

        return session


class IndexGroupCommand(Command, SessionCommandMixin):

    """
    Abstract base class for commands with the index_group options.

    This also corresponds to the commands that permit the pip version check.
    """

    def handle_pip_version_check(self, options):
        # type: (Values) -> None
        """
        Do the pip version check if not disabled.

        This overrides the default behavior of not doing the check.
        """
        # Make sure the index_group options are present.
        assert hasattr(options, 'no_index')

        if options.disable_pip_version_check or options.no_index:
            return

        # Otherwise, check if we're using the latest version of pip available.
        session = self._build_session(
            options,
            retries=0,
            timeout=min(5, options.timeout)
        )
        with session:
            pip_self_version_check(session, options)


class RequirementCommand(IndexGroupCommand):

    @staticmethod
    def make_requirement_preparer(
        temp_build_dir,           # type: TempDirectory
        options,                  # type: Values
        req_tracker,              # type: RequirementTracker
        download_dir=None,        # type: str
        wheel_download_dir=None,  # type: str
    ):
        # type: (...) -> RequirementPreparer
        """
        Create a RequirementPreparer instance for the given parameters.
        """
        temp_build_dir_path = temp_build_dir.path
        assert temp_build_dir_path is not None
        return RequirementPreparer(
            build_dir=temp_build_dir_path,
            src_dir=options.src_dir,
            download_dir=download_dir,
            wheel_download_dir=wheel_download_dir,
            progress_bar=options.progress_bar,
            build_isolation=options.build_isolation,
            req_tracker=req_tracker,
        )

    @staticmethod
    def make_resolver(
        preparer,                            # type: RequirementPreparer
        session,                             # type: PipSession
        finder,                              # type: PackageFinder
        options,                             # type: Values
        wheel_cache=None,                    # type: Optional[WheelCache]
        use_user_site=False,                 # type: bool
        ignore_installed=True,               # type: bool
        ignore_requires_python=False,        # type: bool
        force_reinstall=False,               # type: bool
        upgrade_strategy="to-satisfy-only",  # type: str
        use_pep517=None,                     # type: Optional[bool]
        py_version_info=None            # type: Optional[Tuple[int, ...]]
    ):
        # type: (...) -> Resolver
        """
        Create a Resolver instance for the given parameters.
        """
        make_install_req = partial(
            install_req_from_req_string,
            isolated=options.isolated_mode,
            wheel_cache=wheel_cache,
            use_pep517=use_pep517,
        )
        return Resolver(
            preparer=preparer,
            session=session,
            finder=finder,
            make_install_req=make_install_req,
            use_user_site=use_user_site,
            ignore_dependencies=options.ignore_dependencies,
            ignore_installed=ignore_installed,
            ignore_requires_python=ignore_requires_python,
            force_reinstall=force_reinstall,
            upgrade_strategy=upgrade_strategy,
            py_version_info=py_version_info
        )

    def populate_requirement_set(
        self,
        requirement_set,  # type: RequirementSet
        args,             # type: List[str]
        options,          # type: Values
        finder,           # type: PackageFinder
        session,          # type: PipSession
        wheel_cache,      # type: Optional[WheelCache]
    ):
        # type: (...) -> None
        """
        Marshal cmd line args into a requirement set.
        """
        # NOTE: As a side-effect, options.require_hashes and
        #       requirement_set.require_hashes may be updated

        for filename in options.constraints:
            for req_to_add in parse_requirements(
                    filename,
                    constraint=True, finder=finder, options=options,
                    session=session, wheel_cache=wheel_cache):
                req_to_add.is_direct = True
                requirement_set.add_requirement(req_to_add)

        for req in args:
            req_to_add = install_req_from_line(
                req, None, isolated=options.isolated_mode,
                use_pep517=options.use_pep517,
                wheel_cache=wheel_cache
            )
            req_to_add.is_direct = True
            requirement_set.add_requirement(req_to_add)

        for req in options.editables:
            req_to_add = install_req_from_editable(
                req,
                isolated=options.isolated_mode,
                use_pep517=options.use_pep517,
                wheel_cache=wheel_cache
            )
            req_to_add.is_direct = True
            requirement_set.add_requirement(req_to_add)

        for filename in options.requirements:
            for req_to_add in parse_requirements(
                    filename,
                    finder=finder, options=options, session=session,
                    wheel_cache=wheel_cache,
                    use_pep517=options.use_pep517):
                req_to_add.is_direct = True
                requirement_set.add_requirement(req_to_add)
        # If --require-hashes was a line in a requirements file, tell
        # RequirementSet about it:
        requirement_set.require_hashes = options.require_hashes

        if not (args or options.editables or options.requirements):
            opts = {'name': self.name}
            if options.find_links:
                raise CommandError(
                    'You must give at least one requirement to %(name)s '
                    '(maybe you meant "pip %(name)s %(links)s"?)' %
                    dict(opts, links=' '.join(options.find_links)))
            else:
                raise CommandError(
                    'You must give at least one requirement to %(name)s '
                    '(see "pip help %(name)s")' % opts)

    def _build_package_finder(
        self,
        options,               # type: Values
        session,               # type: PipSession
        target_python=None,    # type: Optional[TargetPython]
        ignore_requires_python=None,  # type: Optional[bool]
    ):
        # type: (...) -> PackageFinder
        """
        Create a package finder appropriate to this requirement command.

        :param ignore_requires_python: Whether to ignore incompatible
            "Requires-Python" values in links. Defaults to False.
        """
        link_collector = make_link_collector(session, options=options)
        selection_prefs = SelectionPreferences(
            allow_yanked=True,
            format_control=options.format_control,
            allow_all_prereleases=options.pre,
            prefer_binary=options.prefer_binary,
            ignore_requires_python=ignore_requires_python,
        )

        return PackageFinder.create(
            link_collector=link_collector,
            selection_prefs=selection_prefs,
            target_python=target_python,
        )
site-packages/pip/_internal/cli/parser.py000064400000022417151446176770014474 0ustar00"""Base option parser setup"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import optparse
import sys
import textwrap
from distutils.util import strtobool

from pip._vendor.six import string_types

from pip._internal.cli.status_codes import UNKNOWN_ERROR
from pip._internal.configuration import Configuration, ConfigurationError
from pip._internal.utils.compat import get_terminal_size

logger = logging.getLogger(__name__)


class PrettyHelpFormatter(optparse.IndentedHelpFormatter):
    """A prettier/less verbose help formatter for optparse."""

    def __init__(self, *args, **kwargs):
        # help position must be aligned with __init__.parseopts.description
        kwargs['max_help_position'] = 30
        kwargs['indent_increment'] = 1
        kwargs['width'] = get_terminal_size()[0] - 2
        optparse.IndentedHelpFormatter.__init__(self, *args, **kwargs)

    def format_option_strings(self, option):
        return self._format_option_strings(option, ' <%s>', ', ')

    def _format_option_strings(self, option, mvarfmt=' <%s>', optsep=', '):
        """
        Return a comma-separated list of option strings and metavars.

        :param option:  tuple of (short opt, long opt), e.g: ('-f', '--format')
        :param mvarfmt: metavar format string - evaluated as mvarfmt % metavar
        :param optsep:  separator
        """
        opts = []

        if option._short_opts:
            opts.append(option._short_opts[0])
        if option._long_opts:
            opts.append(option._long_opts[0])
        if len(opts) > 1:
            opts.insert(1, optsep)

        if option.takes_value():
            metavar = option.metavar or option.dest.lower()
            opts.append(mvarfmt % metavar.lower())

        return ''.join(opts)

    def format_heading(self, heading):
        if heading == 'Options':
            return ''
        return heading + ':\n'

    def format_usage(self, usage):
        """
        Ensure there is only one newline between usage and the first heading
        if there is no description.
        """
        msg = '\nUsage: %s\n' % self.indent_lines(textwrap.dedent(usage), "  ")
        return msg

    def format_description(self, description):
        # leave full control over description to us
        if description:
            if hasattr(self.parser, 'main'):
                label = 'Commands'
            else:
                label = 'Description'
            # some doc strings have initial newlines, some don't
            description = description.lstrip('\n')
            # some doc strings have final newlines and spaces, some don't
            description = description.rstrip()
            # dedent, then reindent
            description = self.indent_lines(textwrap.dedent(description), "  ")
            description = '%s:\n%s\n' % (label, description)
            return description
        else:
            return ''

    def format_epilog(self, epilog):
        # leave full control over epilog to us
        if epilog:
            return epilog
        else:
            return ''

    def indent_lines(self, text, indent):
        new_lines = [indent + line for line in text.split('\n')]
        return "\n".join(new_lines)


class UpdatingDefaultsHelpFormatter(PrettyHelpFormatter):
    """Custom help formatter for use in ConfigOptionParser.

    This is updates the defaults before expanding them, allowing
    them to show up correctly in the help listing.
    """

    def expand_default(self, option):
        if self.parser is not None:
            self.parser._update_defaults(self.parser.defaults)
        return optparse.IndentedHelpFormatter.expand_default(self, option)


class CustomOptionParser(optparse.OptionParser):

    def insert_option_group(self, idx, *args, **kwargs):
        """Insert an OptionGroup at a given position."""
        group = self.add_option_group(*args, **kwargs)

        self.option_groups.pop()
        self.option_groups.insert(idx, group)

        return group

    @property
    def option_list_all(self):
        """Get a list of all options, including those in option groups."""
        res = self.option_list[:]
        for i in self.option_groups:
            res.extend(i.option_list)

        return res


class ConfigOptionParser(CustomOptionParser):
    """Custom option parser which updates its defaults by checking the
    configuration files and environmental variables"""

    def __init__(self, *args, **kwargs):
        self.name = kwargs.pop('name')

        isolated = kwargs.pop("isolated", False)
        self.config = Configuration(isolated)

        assert self.name
        optparse.OptionParser.__init__(self, *args, **kwargs)

    def check_default(self, option, key, val):
        try:
            return option.check_value(key, val)
        except optparse.OptionValueError as exc:
            print("An error occurred during configuration: %s" % exc)
            sys.exit(3)

    def _get_ordered_configuration_items(self):
        # Configuration gives keys in an unordered manner. Order them.
        override_order = ["global", self.name, ":env:"]

        # Pool the options into different groups
        section_items = {name: [] for name in override_order}
        for section_key, val in self.config.items():
            # ignore empty values
            if not val:
                logger.debug(
                    "Ignoring configuration key '%s' as it's value is empty.",
                    section_key
                )
                continue

            section, key = section_key.split(".", 1)
            if section in override_order:
                section_items[section].append((key, val))

        # Yield each group in their override order
        for section in override_order:
            for key, val in section_items[section]:
                yield key, val

    def _update_defaults(self, defaults):
        """Updates the given defaults with values from the config files and
        the environ. Does a little special handling for certain types of
        options (lists)."""

        # Accumulate complex default state.
        self.values = optparse.Values(self.defaults)
        late_eval = set()
        # Then set the options with those values
        for key, val in self._get_ordered_configuration_items():
            # '--' because configuration supports only long names
            option = self.get_option('--' + key)

            # Ignore options not present in this parser. E.g. non-globals put
            # in [global] by users that want them to apply to all applicable
            # commands.
            if option is None:
                continue

            if option.action in ('store_true', 'store_false', 'count'):
                try:
                    val = strtobool(val)
                except ValueError:
                    error_msg = invalid_config_error_message(
                        option.action, key, val
                    )
                    self.error(error_msg)

            elif option.action == 'append':
                val = val.split()
                val = [self.check_default(option, key, v) for v in val]
            elif option.action == 'callback':
                late_eval.add(option.dest)
                opt_str = option.get_opt_string()
                val = option.convert_value(opt_str, val)
                # From take_action
                args = option.callback_args or ()
                kwargs = option.callback_kwargs or {}
                option.callback(option, opt_str, val, self, *args, **kwargs)
            else:
                val = self.check_default(option, key, val)

            defaults[option.dest] = val

        for key in late_eval:
            defaults[key] = getattr(self.values, key)
        self.values = None
        return defaults

    def get_default_values(self):
        """Overriding to make updating the defaults after instantiation of
        the option parser possible, _update_defaults() does the dirty work."""
        if not self.process_default_values:
            # Old, pre-Optik 1.5 behaviour.
            return optparse.Values(self.defaults)

        # Load the configuration, or error out in case of an error
        try:
            self.config.load()
        except ConfigurationError as err:
            self.exit(UNKNOWN_ERROR, str(err))

        defaults = self._update_defaults(self.defaults.copy())  # ours
        for option in self._get_all_options():
            default = defaults.get(option.dest)
            if isinstance(default, string_types):
                opt_str = option.get_opt_string()
                defaults[option.dest] = option.check_value(opt_str, default)
        return optparse.Values(defaults)

    def error(self, msg):
        self.print_usage(sys.stderr)
        self.exit(UNKNOWN_ERROR, "%s\n" % msg)


def invalid_config_error_message(action, key, val):
    """Returns a better error message when invalid configuration option
    is provided."""
    if action in ('store_true', 'store_false'):
        return ("{0} is not a valid value for {1} option, "
                "please specify a boolean value like yes/no, "
                "true/false or 1/0 instead.").format(val, key)

    return ("{0} is not a valid value for {1} option, "
            "please specify a numerical value like 1/0 "
            "instead.").format(val, key)
site-packages/pip/_internal/cli/base_command.py000064400000014550151446176770015607 0ustar00"""Base Command class, and related routines"""

from __future__ import absolute_import, print_function

import logging
import logging.config
import optparse
import os
import platform
import sys
import traceback

from pip._internal.cli import cmdoptions
from pip._internal.cli.command_context import CommandContextMixIn
from pip._internal.cli.parser import (
    ConfigOptionParser,
    UpdatingDefaultsHelpFormatter,
)
from pip._internal.cli.status_codes import (
    ERROR,
    PREVIOUS_BUILD_DIR_ERROR,
    SUCCESS,
    UNKNOWN_ERROR,
    VIRTUALENV_NOT_FOUND,
)
from pip._internal.exceptions import (
    BadCommand,
    CommandError,
    InstallationError,
    PreviousBuildDirError,
    UninstallationError,
)
from pip._internal.utils.deprecation import deprecated
from pip._internal.utils.logging import BrokenStdoutLoggingError, setup_logging
from pip._internal.utils.misc import get_prog
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.virtualenv import running_under_virtualenv

if MYPY_CHECK_RUNNING:
    from typing import List, Tuple, Any
    from optparse import Values

__all__ = ['Command']

logger = logging.getLogger(__name__)


class Command(CommandContextMixIn):
    usage = None  # type: str
    ignore_require_venv = False  # type: bool

    def __init__(self, name, summary, isolated=False):
        # type: (str, str, bool) -> None
        super(Command, self).__init__()
        parser_kw = {
            'usage': self.usage,
            'prog': '%s %s' % (get_prog(), name),
            'formatter': UpdatingDefaultsHelpFormatter(),
            'add_help_option': False,
            'name': name,
            'description': self.__doc__,
            'isolated': isolated,
        }

        self.name = name
        self.summary = summary
        self.parser = ConfigOptionParser(**parser_kw)

        # Commands should add options to this option group
        optgroup_name = '%s Options' % self.name.capitalize()
        self.cmd_opts = optparse.OptionGroup(self.parser, optgroup_name)

        # Add the general options
        gen_opts = cmdoptions.make_option_group(
            cmdoptions.general_group,
            self.parser,
        )
        self.parser.add_option_group(gen_opts)

    def handle_pip_version_check(self, options):
        # type: (Values) -> None
        """
        This is a no-op so that commands by default do not do the pip version
        check.
        """
        # Make sure we do the pip version check if the index_group options
        # are present.
        assert not hasattr(options, 'no_index')

    def run(self, options, args):
        # type: (Values, List[Any]) -> Any
        raise NotImplementedError

    def parse_args(self, args):
        # type: (List[str]) -> Tuple
        # factored out for testability
        return self.parser.parse_args(args)

    def main(self, args):
        # type: (List[str]) -> int
        try:
            with self.main_context():
                return self._main(args)
        finally:
            logging.shutdown()

    def _main(self, args):
        # type: (List[str]) -> int
        options, args = self.parse_args(args)

        # Set verbosity so that it can be used elsewhere.
        self.verbosity = options.verbose - options.quiet

        level_number = setup_logging(
            verbosity=self.verbosity,
            no_color=options.no_color,
            user_log_file=options.log,
        )

        if sys.version_info[:2] == (2, 7):
            message = (
                "A future version of pip will drop support for Python 2.7. "
                "More details about Python 2 support in pip, can be found at "
                "https://pip.pypa.io/en/latest/development/release-process/#python-2-support"  # noqa
            )
            if platform.python_implementation() == "CPython":
                message = (
                    "Python 2.7 will reach the end of its life on January "
                    "1st, 2020. Please upgrade your Python as Python 2.7 "
                    "won't be maintained after that date. "
                ) + message
            deprecated(message, replacement=None, gone_in=None)

        # TODO: Try to get these passing down from the command?
        #       without resorting to os.environ to hold these.
        #       This also affects isolated builds and it should.

        if options.no_input:
            os.environ['PIP_NO_INPUT'] = '1'

        if options.exists_action:
            os.environ['PIP_EXISTS_ACTION'] = ' '.join(options.exists_action)

        if options.require_venv and not self.ignore_require_venv:
            # If a venv is required check if it can really be found
            if not running_under_virtualenv():
                logger.critical(
                    'Could not find an activated virtualenv (required).'
                )
                sys.exit(VIRTUALENV_NOT_FOUND)

        try:
            status = self.run(options, args)
            # FIXME: all commands should return an exit status
            # and when it is done, isinstance is not needed anymore
            if isinstance(status, int):
                return status
        except PreviousBuildDirError as exc:
            logger.critical(str(exc))
            logger.debug('Exception information:', exc_info=True)

            return PREVIOUS_BUILD_DIR_ERROR
        except (InstallationError, UninstallationError, BadCommand) as exc:
            logger.critical(str(exc))
            logger.debug('Exception information:', exc_info=True)

            return ERROR
        except CommandError as exc:
            logger.critical('%s', exc)
            logger.debug('Exception information:', exc_info=True)

            return ERROR
        except BrokenStdoutLoggingError:
            # Bypass our logger and write any remaining messages to stderr
            # because stdout no longer works.
            print('ERROR: Pipe to stdout was broken', file=sys.stderr)
            if level_number <= logging.DEBUG:
                traceback.print_exc(file=sys.stderr)

            return ERROR
        except KeyboardInterrupt:
            logger.critical('Operation cancelled by user')
            logger.debug('Exception information:', exc_info=True)

            return ERROR
        except BaseException:
            logger.critical('Exception:', exc_info=True)

            return UNKNOWN_ERROR
        finally:
            self.handle_pip_version_check(options)

        return SUCCESS
site-packages/pip/_internal/cli/cmdoptions.py000064400000064327151446176770015365 0ustar00"""
shared options and groups

The principle here is to define options once, but *not* instantiate them
globally. One reason being that options with action='append' can carry state
between parses. pip parses general options twice internally, and shouldn't
pass on state. To be consistent, all options will follow this design.
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import textwrap
import warnings
from distutils.util import strtobool
from functools import partial
from optparse import SUPPRESS_HELP, Option, OptionGroup
from textwrap import dedent

from pip._internal.exceptions import CommandError
from pip._internal.locations import USER_CACHE_DIR, get_src_prefix
from pip._internal.models.format_control import FormatControl
from pip._internal.models.index import PyPI
from pip._internal.models.target_python import TargetPython
from pip._internal.utils.hashes import STRONG_HASHES
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.ui import BAR_TYPES

if MYPY_CHECK_RUNNING:
    from typing import Any, Callable, Dict, Optional, Tuple
    from optparse import OptionParser, Values
    from pip._internal.cli.parser import ConfigOptionParser

logger = logging.getLogger(__name__)


def raise_option_error(parser, option, msg):
    """
    Raise an option parsing error using parser.error().

    Args:
      parser: an OptionParser instance.
      option: an Option instance.
      msg: the error text.
    """
    msg = '{} error: {}'.format(option, msg)
    msg = textwrap.fill(' '.join(msg.split()))
    parser.error(msg)


def make_option_group(group, parser):
    # type: (Dict[str, Any], ConfigOptionParser) -> OptionGroup
    """
    Return an OptionGroup object
    group  -- assumed to be dict with 'name' and 'options' keys
    parser -- an optparse Parser
    """
    option_group = OptionGroup(parser, group['name'])
    for option in group['options']:
        option_group.add_option(option())
    return option_group


def check_install_build_global(options, check_options=None):
    # type: (Values, Optional[Values]) -> None
    """Disable wheels if per-setup.py call options are set.

    :param options: The OptionParser options to update.
    :param check_options: The options to check, if not supplied defaults to
        options.
    """
    if check_options is None:
        check_options = options

    def getname(n):
        return getattr(check_options, n, None)
    names = ["build_options", "global_options", "install_options"]
    if any(map(getname, names)):
        control = options.format_control
        control.disallow_binaries()
        warnings.warn(
            'Disabling all use of wheels due to the use of --build-options '
            '/ --global-options / --install-options.', stacklevel=2,
        )


def check_dist_restriction(options, check_target=False):
    # type: (Values, bool) -> None
    """Function for determining if custom platform options are allowed.

    :param options: The OptionParser options.
    :param check_target: Whether or not to check if --target is being used.
    """
    dist_restriction_set = any([
        options.python_version,
        options.platform,
        options.abi,
        options.implementation,
    ])

    binary_only = FormatControl(set(), {':all:'})
    sdist_dependencies_allowed = (
        options.format_control != binary_only and
        not options.ignore_dependencies
    )

    # Installations or downloads using dist restrictions must not combine
    # source distributions and dist-specific wheels, as they are not
    # guaranteed to be locally compatible.
    if dist_restriction_set and sdist_dependencies_allowed:
        raise CommandError(
            "When restricting platform and interpreter constraints using "
            "--python-version, --platform, --abi, or --implementation, "
            "either --no-deps must be set, or --only-binary=:all: must be "
            "set and --no-binary must not be set (or must be set to "
            ":none:)."
        )

    if check_target:
        if dist_restriction_set and not options.target_dir:
            raise CommandError(
                "Can not use any platform or abi specific options unless "
                "installing via '--target'"
            )


###########
# options #
###########

help_ = partial(
    Option,
    '-h', '--help',
    dest='help',
    action='help',
    help='Show help.',
)  # type: Callable[..., Option]

isolated_mode = partial(
    Option,
    "--isolated",
    dest="isolated_mode",
    action="store_true",
    default=False,
    help=(
        "Run pip in an isolated mode, ignoring environment variables and user "
        "configuration."
    ),
)  # type: Callable[..., Option]

require_virtualenv = partial(
    Option,
    # Run only if inside a virtualenv, bail if not.
    '--require-virtualenv', '--require-venv',
    dest='require_venv',
    action='store_true',
    default=False,
    help=SUPPRESS_HELP
)  # type: Callable[..., Option]

verbose = partial(
    Option,
    '-v', '--verbose',
    dest='verbose',
    action='count',
    default=0,
    help='Give more output. Option is additive, and can be used up to 3 times.'
)  # type: Callable[..., Option]

no_color = partial(
    Option,
    '--no-color',
    dest='no_color',
    action='store_true',
    default=False,
    help="Suppress colored output",
)  # type: Callable[..., Option]

version = partial(
    Option,
    '-V', '--version',
    dest='version',
    action='store_true',
    help='Show version and exit.',
)  # type: Callable[..., Option]

quiet = partial(
    Option,
    '-q', '--quiet',
    dest='quiet',
    action='count',
    default=0,
    help=(
        'Give less output. Option is additive, and can be used up to 3'
        ' times (corresponding to WARNING, ERROR, and CRITICAL logging'
        ' levels).'
    ),
)  # type: Callable[..., Option]

progress_bar = partial(
    Option,
    '--progress-bar',
    dest='progress_bar',
    type='choice',
    choices=list(BAR_TYPES.keys()),
    default='on',
    help=(
        'Specify type of progress to be displayed [' +
        '|'.join(BAR_TYPES.keys()) + '] (default: %default)'
    ),
)  # type: Callable[..., Option]

log = partial(
    Option,
    "--log", "--log-file", "--local-log",
    dest="log",
    metavar="path",
    help="Path to a verbose appending log."
)  # type: Callable[..., Option]

no_input = partial(
    Option,
    # Don't ask for input
    '--no-input',
    dest='no_input',
    action='store_true',
    default=False,
    help=SUPPRESS_HELP
)  # type: Callable[..., Option]

proxy = partial(
    Option,
    '--proxy',
    dest='proxy',
    type='str',
    default='',
    help="Specify a proxy in the form [user:passwd@]proxy.server:port."
)  # type: Callable[..., Option]

retries = partial(
    Option,
    '--retries',
    dest='retries',
    type='int',
    default=5,
    help="Maximum number of retries each connection should attempt "
         "(default %default times).",
)  # type: Callable[..., Option]

timeout = partial(
    Option,
    '--timeout', '--default-timeout',
    metavar='sec',
    dest='timeout',
    type='float',
    default=15,
    help='Set the socket timeout (default %default seconds).',
)  # type: Callable[..., Option]

skip_requirements_regex = partial(
    Option,
    # A regex to be used to skip requirements
    '--skip-requirements-regex',
    dest='skip_requirements_regex',
    type='str',
    default='',
    help=SUPPRESS_HELP,
)  # type: Callable[..., Option]


def exists_action():
    # type: () -> Option
    return Option(
        # Option when path already exist
        '--exists-action',
        dest='exists_action',
        type='choice',
        choices=['s', 'i', 'w', 'b', 'a'],
        default=[],
        action='append',
        metavar='action',
        help="Default action when a path already exists: "
             "(s)witch, (i)gnore, (w)ipe, (b)ackup, (a)bort.",
    )


cert = partial(
    Option,
    '--cert',
    dest='cert',
    type='str',
    metavar='path',
    help="Path to alternate CA bundle.",
)  # type: Callable[..., Option]

client_cert = partial(
    Option,
    '--client-cert',
    dest='client_cert',
    type='str',
    default=None,
    metavar='path',
    help="Path to SSL client certificate, a single file containing the "
         "private key and the certificate in PEM format.",
)  # type: Callable[..., Option]

index_url = partial(
    Option,
    '-i', '--index-url', '--pypi-url',
    dest='index_url',
    metavar='URL',
    default=PyPI.simple_url,
    help="Base URL of the Python Package Index (default %default). "
         "This should point to a repository compliant with PEP 503 "
         "(the simple repository API) or a local directory laid out "
         "in the same format.",
)  # type: Callable[..., Option]


def extra_index_url():
    return Option(
        '--extra-index-url',
        dest='extra_index_urls',
        metavar='URL',
        action='append',
        default=[],
        help="Extra URLs of package indexes to use in addition to "
             "--index-url. Should follow the same rules as "
             "--index-url.",
    )


no_index = partial(
    Option,
    '--no-index',
    dest='no_index',
    action='store_true',
    default=False,
    help='Ignore package index (only looking at --find-links URLs instead).',
)  # type: Callable[..., Option]


def find_links():
    # type: () -> Option
    return Option(
        '-f', '--find-links',
        dest='find_links',
        action='append',
        default=[],
        metavar='url',
        help="If a url or path to an html file, then parse for links to "
             "archives. If a local path or file:// url that's a directory, "
             "then look for archives in the directory listing.",
    )


def trusted_host():
    # type: () -> Option
    return Option(
        "--trusted-host",
        dest="trusted_hosts",
        action="append",
        metavar="HOSTNAME",
        default=[],
        help="Mark this host or host:port pair as trusted, even though it "
             "does not have valid or any HTTPS.",
    )


def constraints():
    # type: () -> Option
    return Option(
        '-c', '--constraint',
        dest='constraints',
        action='append',
        default=[],
        metavar='file',
        help='Constrain versions using the given constraints file. '
        'This option can be used multiple times.'
    )


def requirements():
    # type: () -> Option
    return Option(
        '-r', '--requirement',
        dest='requirements',
        action='append',
        default=[],
        metavar='file',
        help='Install from the given requirements file. '
        'This option can be used multiple times.'
    )


def editable():
    # type: () -> Option
    return Option(
        '-e', '--editable',
        dest='editables',
        action='append',
        default=[],
        metavar='path/url',
        help=('Install a project in editable mode (i.e. setuptools '
              '"develop mode") from a local project path or a VCS url.'),
    )


src = partial(
    Option,
    '--src', '--source', '--source-dir', '--source-directory',
    dest='src_dir',
    metavar='dir',
    default=get_src_prefix(),
    help='Directory to check out editable projects into. '
    'The default in a virtualenv is "<venv path>/src". '
    'The default for global installs is "<current dir>/src".'
)  # type: Callable[..., Option]


def _get_format_control(values, option):
    # type: (Values, Option) -> Any
    """Get a format_control object."""
    return getattr(values, option.dest)


def _handle_no_binary(option, opt_str, value, parser):
    # type: (Option, str, str, OptionParser) -> None
    existing = _get_format_control(parser.values, option)
    FormatControl.handle_mutual_excludes(
        value, existing.no_binary, existing.only_binary,
    )


def _handle_only_binary(option, opt_str, value, parser):
    # type: (Option, str, str, OptionParser) -> None
    existing = _get_format_control(parser.values, option)
    FormatControl.handle_mutual_excludes(
        value, existing.only_binary, existing.no_binary,
    )


def no_binary():
    # type: () -> Option
    format_control = FormatControl(set(), set())
    return Option(
        "--no-binary", dest="format_control", action="callback",
        callback=_handle_no_binary, type="str",
        default=format_control,
        help="Do not use binary packages. Can be supplied multiple times, and "
             "each time adds to the existing value. Accepts either :all: to "
             "disable all binary packages, :none: to empty the set, or one or "
             "more package names with commas between them (no colons). Note "
             "that some packages are tricky to compile and may fail to "
             "install when this option is used on them.",
    )


def only_binary():
    # type: () -> Option
    format_control = FormatControl(set(), set())
    return Option(
        "--only-binary", dest="format_control", action="callback",
        callback=_handle_only_binary, type="str",
        default=format_control,
        help="Do not use source packages. Can be supplied multiple times, and "
             "each time adds to the existing value. Accepts either :all: to "
             "disable all source packages, :none: to empty the set, or one or "
             "more package names with commas between them. Packages without "
             "binary distributions will fail to install when this option is "
             "used on them.",
    )


platform = partial(
    Option,
    '--platform',
    dest='platform',
    metavar='platform',
    default=None,
    help=("Only use wheels compatible with <platform>. "
          "Defaults to the platform of the running system."),
)  # type: Callable[..., Option]


# This was made a separate function for unit-testing purposes.
def _convert_python_version(value):
    # type: (str) -> Tuple[Tuple[int, ...], Optional[str]]
    """
    Convert a version string like "3", "37", or "3.7.3" into a tuple of ints.

    :return: A 2-tuple (version_info, error_msg), where `error_msg` is
        non-None if and only if there was a parsing error.
    """
    if not value:
        # The empty string is the same as not providing a value.
        return (None, None)

    parts = value.split('.')
    if len(parts) > 3:
        return ((), 'at most three version parts are allowed')

    if len(parts) == 1:
        # Then we are in the case of "3" or "37".
        value = parts[0]
        if len(value) > 1:
            parts = [value[0], value[1:]]

    try:
        version_info = tuple(int(part) for part in parts)
    except ValueError:
        return ((), 'each version part must be an integer')

    return (version_info, None)


def _handle_python_version(option, opt_str, value, parser):
    # type: (Option, str, str, OptionParser) -> None
    """
    Handle a provided --python-version value.
    """
    version_info, error_msg = _convert_python_version(value)
    if error_msg is not None:
        msg = (
            'invalid --python-version value: {!r}: {}'.format(
                value, error_msg,
            )
        )
        raise_option_error(parser, option=option, msg=msg)

    parser.values.python_version = version_info


python_version = partial(
    Option,
    '--python-version',
    dest='python_version',
    metavar='python_version',
    action='callback',
    callback=_handle_python_version, type='str',
    default=None,
    help=dedent("""\
    The Python interpreter version to use for wheel and "Requires-Python"
    compatibility checks. Defaults to a version derived from the running
    interpreter. The version can be specified using up to three dot-separated
    integers (e.g. "3" for 3.0.0, "3.7" for 3.7.0, or "3.7.3"). A major-minor
    version can also be given as a string without dots (e.g. "37" for 3.7.0).
    """),
)  # type: Callable[..., Option]


implementation = partial(
    Option,
    '--implementation',
    dest='implementation',
    metavar='implementation',
    default=None,
    help=("Only use wheels compatible with Python "
          "implementation <implementation>, e.g. 'pp', 'jy', 'cp', "
          " or 'ip'. If not specified, then the current "
          "interpreter implementation is used.  Use 'py' to force "
          "implementation-agnostic wheels."),
)  # type: Callable[..., Option]


abi = partial(
    Option,
    '--abi',
    dest='abi',
    metavar='abi',
    default=None,
    help=("Only use wheels compatible with Python "
          "abi <abi>, e.g. 'pypy_41'.  If not specified, then the "
          "current interpreter abi tag is used.  Generally "
          "you will need to specify --implementation, "
          "--platform, and --python-version when using "
          "this option."),
)  # type: Callable[..., Option]


def add_target_python_options(cmd_opts):
    # type: (OptionGroup) -> None
    cmd_opts.add_option(platform())
    cmd_opts.add_option(python_version())
    cmd_opts.add_option(implementation())
    cmd_opts.add_option(abi())


def make_target_python(options):
    # type: (Values) -> TargetPython
    target_python = TargetPython(
        platform=options.platform,
        py_version_info=options.python_version,
        abi=options.abi,
        implementation=options.implementation,
    )

    return target_python


def prefer_binary():
    # type: () -> Option
    return Option(
        "--prefer-binary",
        dest="prefer_binary",
        action="store_true",
        default=False,
        help="Prefer older binary packages over newer source packages."
    )


cache_dir = partial(
    Option,
    "--cache-dir",
    dest="cache_dir",
    default=USER_CACHE_DIR,
    metavar="dir",
    help="Store the cache data in <dir>."
)  # type: Callable[..., Option]


def _handle_no_cache_dir(option, opt, value, parser):
    # type: (Option, str, str, OptionParser) -> None
    """
    Process a value provided for the --no-cache-dir option.

    This is an optparse.Option callback for the --no-cache-dir option.
    """
    # The value argument will be None if --no-cache-dir is passed via the
    # command-line, since the option doesn't accept arguments.  However,
    # the value can be non-None if the option is triggered e.g. by an
    # environment variable, like PIP_NO_CACHE_DIR=true.
    if value is not None:
        # Then parse the string value to get argument error-checking.
        try:
            strtobool(value)
        except ValueError as exc:
            raise_option_error(parser, option=option, msg=str(exc))

    # Originally, setting PIP_NO_CACHE_DIR to a value that strtobool()
    # converted to 0 (like "false" or "no") caused cache_dir to be disabled
    # rather than enabled (logic would say the latter).  Thus, we disable
    # the cache directory not just on values that parse to True, but (for
    # backwards compatibility reasons) also on values that parse to False.
    # In other words, always set it to False if the option is provided in
    # some (valid) form.
    parser.values.cache_dir = False


no_cache = partial(
    Option,
    "--no-cache-dir",
    dest="cache_dir",
    action="callback",
    callback=_handle_no_cache_dir,
    help="Disable the cache.",
)  # type: Callable[..., Option]

no_deps = partial(
    Option,
    '--no-deps', '--no-dependencies',
    dest='ignore_dependencies',
    action='store_true',
    default=False,
    help="Don't install package dependencies.",
)  # type: Callable[..., Option]

build_dir = partial(
    Option,
    '-b', '--build', '--build-dir', '--build-directory',
    dest='build_dir',
    metavar='dir',
    help='Directory to unpack packages into and build in. Note that '
         'an initial build still takes place in a temporary directory. '
         'The location of temporary directories can be controlled by setting '
         'the TMPDIR environment variable (TEMP on Windows) appropriately. '
         'When passed, build directories are not cleaned in case of failures.'
)  # type: Callable[..., Option]

ignore_requires_python = partial(
    Option,
    '--ignore-requires-python',
    dest='ignore_requires_python',
    action='store_true',
    help='Ignore the Requires-Python information.'
)  # type: Callable[..., Option]

no_build_isolation = partial(
    Option,
    '--no-build-isolation',
    dest='build_isolation',
    action='store_false',
    default=True,
    help='Disable isolation when building a modern source distribution. '
         'Build dependencies specified by PEP 518 must be already installed '
         'if this option is used.'
)  # type: Callable[..., Option]


def _handle_no_use_pep517(option, opt, value, parser):
    # type: (Option, str, str, OptionParser) -> None
    """
    Process a value provided for the --no-use-pep517 option.

    This is an optparse.Option callback for the no_use_pep517 option.
    """
    # Since --no-use-pep517 doesn't accept arguments, the value argument
    # will be None if --no-use-pep517 is passed via the command-line.
    # However, the value can be non-None if the option is triggered e.g.
    # by an environment variable, for example "PIP_NO_USE_PEP517=true".
    if value is not None:
        msg = """A value was passed for --no-use-pep517,
        probably using either the PIP_NO_USE_PEP517 environment variable
        or the "no-use-pep517" config file option. Use an appropriate value
        of the PIP_USE_PEP517 environment variable or the "use-pep517"
        config file option instead.
        """
        raise_option_error(parser, option=option, msg=msg)

    # Otherwise, --no-use-pep517 was passed via the command-line.
    parser.values.use_pep517 = False


use_pep517 = partial(
    Option,
    '--use-pep517',
    dest='use_pep517',
    action='store_true',
    default=None,
    help='Use PEP 517 for building source distributions '
         '(use --no-use-pep517 to force legacy behaviour).'
)  # type: Any

no_use_pep517 = partial(
    Option,
    '--no-use-pep517',
    dest='use_pep517',
    action='callback',
    callback=_handle_no_use_pep517,
    default=None,
    help=SUPPRESS_HELP
)  # type: Any

install_options = partial(
    Option,
    '--install-option',
    dest='install_options',
    action='append',
    metavar='options',
    help="Extra arguments to be supplied to the setup.py install "
         "command (use like --install-option=\"--install-scripts=/usr/local/"
         "bin\"). Use multiple --install-option options to pass multiple "
         "options to setup.py install. If you are using an option with a "
         "directory path, be sure to use absolute path.",
)  # type: Callable[..., Option]

global_options = partial(
    Option,
    '--global-option',
    dest='global_options',
    action='append',
    metavar='options',
    help="Extra global options to be supplied to the setup.py "
         "call before the install command.",
)  # type: Callable[..., Option]

no_clean = partial(
    Option,
    '--no-clean',
    action='store_true',
    default=False,
    help="Don't clean up build directories."
)  # type: Callable[..., Option]

pre = partial(
    Option,
    '--pre',
    action='store_true',
    default=False,
    help="Include pre-release and development versions. By default, "
         "pip only finds stable versions.",
)  # type: Callable[..., Option]

disable_pip_version_check = partial(
    Option,
    "--disable-pip-version-check",
    dest="disable_pip_version_check",
    action="store_true",
    default=False,
    help="Don't periodically check PyPI to determine whether a new version "
         "of pip is available for download. Implied with --no-index.",
)  # type: Callable[..., Option]


# Deprecated, Remove later
always_unzip = partial(
    Option,
    '-Z', '--always-unzip',
    dest='always_unzip',
    action='store_true',
    help=SUPPRESS_HELP,
)  # type: Callable[..., Option]


def _handle_merge_hash(option, opt_str, value, parser):
    # type: (Option, str, str, OptionParser) -> None
    """Given a value spelled "algo:digest", append the digest to a list
    pointed to in a dict by the algo name."""
    if not parser.values.hashes:
        parser.values.hashes = {}
    try:
        algo, digest = value.split(':', 1)
    except ValueError:
        parser.error('Arguments to %s must be a hash name '
                     'followed by a value, like --hash=sha256:abcde...' %
                     opt_str)
    if algo not in STRONG_HASHES:
        parser.error('Allowed hash algorithms for %s are %s.' %
                     (opt_str, ', '.join(STRONG_HASHES)))
    parser.values.hashes.setdefault(algo, []).append(digest)


hash = partial(
    Option,
    '--hash',
    # Hash values eventually end up in InstallRequirement.hashes due to
    # __dict__ copying in process_line().
    dest='hashes',
    action='callback',
    callback=_handle_merge_hash,
    type='string',
    help="Verify that the package's archive matches this "
         'hash before installing. Example: --hash=sha256:abcdef...',
)  # type: Callable[..., Option]


require_hashes = partial(
    Option,
    '--require-hashes',
    dest='require_hashes',
    action='store_true',
    default=False,
    help='Require a hash to check each requirement against, for '
         'repeatable installs. This option is implied when any package in a '
         'requirements file has a --hash option.',
)  # type: Callable[..., Option]


list_path = partial(
    Option,
    '--path',
    dest='path',
    action='append',
    help='Restrict to the specified installation path for listing '
         'packages (can be used multiple times).'
)  # type: Callable[..., Option]


def check_list_path_option(options):
    # type: (Values) -> None
    if options.path and (options.user or options.local):
        raise CommandError(
            "Cannot combine '--path' with '--user' or '--local'"
        )


##########
# groups #
##########

general_group = {
    'name': 'General Options',
    'options': [
        help_,
        isolated_mode,
        require_virtualenv,
        verbose,
        version,
        quiet,
        log,
        no_input,
        proxy,
        retries,
        timeout,
        skip_requirements_regex,
        exists_action,
        trusted_host,
        cert,
        client_cert,
        cache_dir,
        no_cache,
        disable_pip_version_check,
        no_color,
    ]
}  # type: Dict[str, Any]

index_group = {
    'name': 'Package Index Options',
    'options': [
        index_url,
        extra_index_url,
        no_index,
        find_links,
    ]
}  # type: Dict[str, Any]
site-packages/pip/_internal/cli/autocompletion.py000064400000014031151446176770016233 0ustar00"""Logic that powers autocompletion installed by ``pip completion``.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import optparse
import os
import sys

from pip._internal.cli.main_parser import create_main_parser
from pip._internal.commands import commands_dict, create_command
from pip._internal.utils.misc import get_installed_distributions


def autocomplete():
    """Entry Point for completion of main and subcommand options.
    """
    # Don't complete if user hasn't sourced bash_completion file.
    if 'PIP_AUTO_COMPLETE' not in os.environ:
        return
    cwords = os.environ['COMP_WORDS'].split()[1:]
    cword = int(os.environ['COMP_CWORD'])
    try:
        current = cwords[cword - 1]
    except IndexError:
        current = ''

    subcommands = list(commands_dict)
    options = []
    # subcommand
    try:
        subcommand_name = [w for w in cwords if w in subcommands][0]
    except IndexError:
        subcommand_name = None

    parser = create_main_parser()
    # subcommand options
    if subcommand_name:
        # special case: 'help' subcommand has no options
        if subcommand_name == 'help':
            sys.exit(1)
        # special case: list locally installed dists for show and uninstall
        should_list_installed = (
            subcommand_name in ['show', 'uninstall'] and
            not current.startswith('-')
        )
        if should_list_installed:
            installed = []
            lc = current.lower()
            for dist in get_installed_distributions(local_only=True):
                if dist.key.startswith(lc) and dist.key not in cwords[1:]:
                    installed.append(dist.key)
            # if there are no dists installed, fall back to option completion
            if installed:
                for dist in installed:
                    print(dist)
                sys.exit(1)

        subcommand = create_command(subcommand_name)

        for opt in subcommand.parser.option_list_all:
            if opt.help != optparse.SUPPRESS_HELP:
                for opt_str in opt._long_opts + opt._short_opts:
                    options.append((opt_str, opt.nargs))

        # filter out previously specified options from available options
        prev_opts = [x.split('=')[0] for x in cwords[1:cword - 1]]
        options = [(x, v) for (x, v) in options if x not in prev_opts]
        # filter options by current input
        options = [(k, v) for k, v in options if k.startswith(current)]
        # get completion type given cwords and available subcommand options
        completion_type = get_path_completion_type(
            cwords, cword, subcommand.parser.option_list_all,
        )
        # get completion files and directories if ``completion_type`` is
        # ``<file>``, ``<dir>`` or ``<path>``
        if completion_type:
            options = auto_complete_paths(current, completion_type)
            options = ((opt, 0) for opt in options)
        for option in options:
            opt_label = option[0]
            # append '=' to options which require args
            if option[1] and option[0][:2] == "--":
                opt_label += '='
            print(opt_label)
    else:
        # show main parser options only when necessary

        opts = [i.option_list for i in parser.option_groups]
        opts.append(parser.option_list)
        opts = (o for it in opts for o in it)
        if current.startswith('-'):
            for opt in opts:
                if opt.help != optparse.SUPPRESS_HELP:
                    subcommands += opt._long_opts + opt._short_opts
        else:
            # get completion type given cwords and all available options
            completion_type = get_path_completion_type(cwords, cword, opts)
            if completion_type:
                subcommands = auto_complete_paths(current, completion_type)

        print(' '.join([x for x in subcommands if x.startswith(current)]))
    sys.exit(1)


def get_path_completion_type(cwords, cword, opts):
    """Get the type of path completion (``file``, ``dir``, ``path`` or None)

    :param cwords: same as the environmental variable ``COMP_WORDS``
    :param cword: same as the environmental variable ``COMP_CWORD``
    :param opts: The available options to check
    :return: path completion type (``file``, ``dir``, ``path`` or None)
    """
    if cword < 2 or not cwords[cword - 2].startswith('-'):
        return
    for opt in opts:
        if opt.help == optparse.SUPPRESS_HELP:
            continue
        for o in str(opt).split('/'):
            if cwords[cword - 2].split('=')[0] == o:
                if not opt.metavar or any(
                        x in ('path', 'file', 'dir')
                        for x in opt.metavar.split('/')):
                    return opt.metavar


def auto_complete_paths(current, completion_type):
    """If ``completion_type`` is ``file`` or ``path``, list all regular files
    and directories starting with ``current``; otherwise only list directories
    starting with ``current``.

    :param current: The word to be completed
    :param completion_type: path completion type(`file`, `path` or `dir`)i
    :return: A generator of regular files and/or directories
    """
    directory, filename = os.path.split(current)
    current_path = os.path.abspath(directory)
    # Don't complete paths if they can't be accessed
    if not os.access(current_path, os.R_OK):
        return
    filename = os.path.normcase(filename)
    # list all files that start with ``filename``
    file_list = (x for x in os.listdir(current_path)
                 if os.path.normcase(x).startswith(filename))
    for f in file_list:
        opt = os.path.join(current_path, f)
        comp_file = os.path.normcase(os.path.join(directory, f))
        # complete regular files when there is not ``<dir>`` after option
        # complete directories when there is ``<file>``, ``<path>`` or
        # ``<dir>``after option
        if completion_type != 'dir' and os.path.isfile(opt):
            yield comp_file
        elif os.path.isdir(opt):
            yield os.path.join(comp_file, '')
site-packages/pip/_internal/cli/command_context.py000064400000001434151446176770016356 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from contextlib import contextmanager

from pip._vendor.contextlib2 import ExitStack


class CommandContextMixIn(object):
    def __init__(self):
        super(CommandContextMixIn, self).__init__()
        self._in_main_context = False
        self._main_context = ExitStack()

    @contextmanager
    def main_context(self):
        assert not self._in_main_context

        self._in_main_context = True
        try:
            with self._main_context:
                yield
        finally:
            self._in_main_context = False

    def enter_context(self, context_provider):
        assert self._in_main_context

        return self._main_context.enter_context(context_provider)
site-packages/pip/_internal/self_outdated_check.py000064400000017376151446176770016420 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import datetime
import hashlib
import json
import logging
import os.path
import sys

from pip._vendor import pkg_resources
from pip._vendor.packaging import version as packaging_version
from pip._vendor.six import ensure_binary

from pip._internal.collector import LinkCollector
from pip._internal.index import PackageFinder
from pip._internal.models.search_scope import SearchScope
from pip._internal.models.selection_prefs import SelectionPreferences
from pip._internal.utils.compat import WINDOWS
from pip._internal.utils.filesystem import (
    adjacent_tmp_file,
    check_path_owner,
    replace,
)
from pip._internal.utils.misc import (
    ensure_dir,
    get_installed_version,
    redact_auth_from_url,
)
from pip._internal.utils.packaging import get_installer
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    import optparse
    from optparse import Values
    from typing import Any, Dict, Text, Union

    from pip._internal.network.session import PipSession


SELFCHECK_DATE_FMT = "%Y-%m-%dT%H:%M:%SZ"


logger = logging.getLogger(__name__)


def make_link_collector(
    session,  # type: PipSession
    options,  # type: Values
    suppress_no_index=False,  # type: bool
):
    # type: (...) -> LinkCollector
    """
    :param session: The Session to use to make requests.
    :param suppress_no_index: Whether to ignore the --no-index option
        when constructing the SearchScope object.
    """
    index_urls = [options.index_url] + options.extra_index_urls
    if options.no_index and not suppress_no_index:
        logger.debug(
            'Ignoring indexes: %s',
            ','.join(redact_auth_from_url(url) for url in index_urls),
        )
        index_urls = []

    # Make sure find_links is a list before passing to create().
    find_links = options.find_links or []

    search_scope = SearchScope.create(
        find_links=find_links, index_urls=index_urls,
    )

    link_collector = LinkCollector(session=session, search_scope=search_scope)

    return link_collector


def _get_statefile_name(key):
    # type: (Union[str, Text]) -> str
    key_bytes = ensure_binary(key)
    name = hashlib.sha224(key_bytes).hexdigest()
    return name


class SelfCheckState(object):
    def __init__(self, cache_dir):
        # type: (str) -> None
        self.state = {}  # type: Dict[str, Any]
        self.statefile_path = None

        # Try to load the existing state
        if cache_dir:
            self.statefile_path = os.path.join(
                cache_dir, "selfcheck", _get_statefile_name(self.key)
            )
            try:
                with open(self.statefile_path) as statefile:
                    self.state = json.load(statefile)
            except (IOError, ValueError, KeyError):
                # Explicitly suppressing exceptions, since we don't want to
                # error out if the cache file is invalid.
                pass

    @property
    def key(self):
        return sys.prefix

    def save(self, pypi_version, current_time):
        # type: (str, datetime.datetime) -> None
        # If we do not have a path to cache in, don't bother saving.
        if not self.statefile_path:
            return

        # Check to make sure that we own the directory
        if not check_path_owner(os.path.dirname(self.statefile_path)):
            return

        # Now that we've ensured the directory is owned by this user, we'll go
        # ahead and make sure that all our directories are created.
        ensure_dir(os.path.dirname(self.statefile_path))

        state = {
            # Include the key so it's easy to tell which pip wrote the
            # file.
            "key": self.key,
            "last_check": current_time.strftime(SELFCHECK_DATE_FMT),
            "pypi_version": pypi_version,
        }

        text = json.dumps(state, sort_keys=True, separators=(",", ":"))

        with adjacent_tmp_file(self.statefile_path) as f:
            f.write(ensure_binary(text))

        try:
            # Since we have a prefix-specific state file, we can just
            # overwrite whatever is there, no need to check.
            replace(f.name, self.statefile_path)
        except OSError:
            # Best effort.
            pass


def was_installed_by_pip(pkg):
    # type: (str) -> bool
    """Checks whether pkg was installed by pip

    This is used not to display the upgrade message when pip is in fact
    installed by system package manager, such as dnf on Fedora.
    """
    try:
        dist = pkg_resources.get_distribution(pkg)
        return "pip" == get_installer(dist)
    except pkg_resources.DistributionNotFound:
        return False


def pip_self_version_check(session, options):
    # type: (PipSession, optparse.Values) -> None
    """Check for an update for pip.

    Limit the frequency of checks to once per week. State is stored either in
    the active virtualenv or in the user's USER_CACHE_DIR keyed off the prefix
    of the pip script path.
    """
    installed_version = get_installed_version("pip")
    if not installed_version:
        return

    pip_version = packaging_version.parse(installed_version)
    pypi_version = None

    try:
        state = SelfCheckState(cache_dir=options.cache_dir)

        current_time = datetime.datetime.utcnow()
        # Determine if we need to refresh the state
        if "last_check" in state.state and "pypi_version" in state.state:
            last_check = datetime.datetime.strptime(
                state.state["last_check"],
                SELFCHECK_DATE_FMT
            )
            if (current_time - last_check).total_seconds() < 7 * 24 * 60 * 60:
                pypi_version = state.state["pypi_version"]

        # Refresh the version if we need to or just see if we need to warn
        if pypi_version is None:
            # Lets use PackageFinder to see what the latest pip version is
            link_collector = make_link_collector(
                session,
                options=options,
                suppress_no_index=True,
            )

            # Pass allow_yanked=False so we don't suggest upgrading to a
            # yanked version.
            selection_prefs = SelectionPreferences(
                allow_yanked=False,
                allow_all_prereleases=False,  # Explicitly set to False
            )

            finder = PackageFinder.create(
                link_collector=link_collector,
                selection_prefs=selection_prefs,
            )
            best_candidate = finder.find_best_candidate("pip").best_candidate
            if best_candidate is None:
                return
            pypi_version = str(best_candidate.version)

            # save that we've performed a check
            state.save(pypi_version, current_time)

        remote_version = packaging_version.parse(pypi_version)

        local_version_is_older = (
            pip_version < remote_version and
            pip_version.base_version != remote_version.base_version and
            was_installed_by_pip('pip')
        )

        # Determine if our pypi_version is older
        if not local_version_is_older:
            return

        # Advise "python -m pip" on Windows to avoid issues
        # with overwriting pip.exe.
        if WINDOWS:
            pip_cmd = "python -m pip"
        else:
            pip_cmd = "pip"
        logger.warning(
            "You are using pip version %s; however, version %s is "
            "available.\nYou should consider upgrading via the "
            "'%s install --upgrade pip' command.",
            pip_version, pypi_version, pip_cmd
        )
    except Exception:
        logger.debug(
            "There was an error checking the latest version of pip",
            exc_info=True,
        )
site-packages/pip/_internal/index.py000064400000110027151446176770013533 0ustar00"""Routines related to PyPI, indexes"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import re

from pip._vendor.packaging import specifiers
from pip._vendor.packaging.utils import canonicalize_name
from pip._vendor.packaging.version import parse as parse_version

from pip._internal.exceptions import (
    BestVersionAlreadyInstalled,
    DistributionNotFound,
    InvalidWheelFilename,
    UnsupportedWheel,
)
from pip._internal.models.candidate import InstallationCandidate
from pip._internal.models.format_control import FormatControl
from pip._internal.models.link import Link
from pip._internal.models.selection_prefs import SelectionPreferences
from pip._internal.models.target_python import TargetPython
from pip._internal.utils.filetypes import WHEEL_EXTENSION
from pip._internal.utils.logging import indent_log
from pip._internal.utils.misc import build_netloc
from pip._internal.utils.packaging import check_requires_python
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.unpacking import SUPPORTED_EXTENSIONS
from pip._internal.utils.urls import url_to_path
from pip._internal.wheel import Wheel

if MYPY_CHECK_RUNNING:
    from typing import (
        FrozenSet, Iterable, List, Optional, Set, Text, Tuple, Union,
    )
    from pip._vendor.packaging.version import _BaseVersion
    from pip._internal.collector import LinkCollector
    from pip._internal.models.search_scope import SearchScope
    from pip._internal.req import InstallRequirement
    from pip._internal.pep425tags import Pep425Tag
    from pip._internal.utils.hashes import Hashes

    BuildTag = Union[Tuple[()], Tuple[int, str]]
    CandidateSortingKey = (
        Tuple[int, int, int, _BaseVersion, BuildTag, Optional[int]]
    )


__all__ = ['FormatControl', 'BestCandidateResult', 'PackageFinder']


logger = logging.getLogger(__name__)


def _check_link_requires_python(
    link,  # type: Link
    version_info,  # type: Tuple[int, int, int]
    ignore_requires_python=False,  # type: bool
):
    # type: (...) -> bool
    """
    Return whether the given Python version is compatible with a link's
    "Requires-Python" value.

    :param version_info: A 3-tuple of ints representing the Python
        major-minor-micro version to check.
    :param ignore_requires_python: Whether to ignore the "Requires-Python"
        value if the given Python version isn't compatible.
    """
    try:
        is_compatible = check_requires_python(
            link.requires_python, version_info=version_info,
        )
    except specifiers.InvalidSpecifier:
        logger.debug(
            "Ignoring invalid Requires-Python (%r) for link: %s",
            link.requires_python, link,
        )
    else:
        if not is_compatible:
            version = '.'.join(map(str, version_info))
            if not ignore_requires_python:
                logger.debug(
                    'Link requires a different Python (%s not in: %r): %s',
                    version, link.requires_python, link,
                )
                return False

            logger.debug(
                'Ignoring failed Requires-Python check (%s not in: %r) '
                'for link: %s',
                version, link.requires_python, link,
            )

    return True


class LinkEvaluator(object):

    """
    Responsible for evaluating links for a particular project.
    """

    _py_version_re = re.compile(r'-py([123]\.?[0-9]?)$')

    # Don't include an allow_yanked default value to make sure each call
    # site considers whether yanked releases are allowed. This also causes
    # that decision to be made explicit in the calling code, which helps
    # people when reading the code.
    def __init__(
        self,
        project_name,    # type: str
        canonical_name,  # type: str
        formats,         # type: FrozenSet
        target_python,   # type: TargetPython
        allow_yanked,    # type: bool
        ignore_requires_python=None,  # type: Optional[bool]
    ):
        # type: (...) -> None
        """
        :param project_name: The user supplied package name.
        :param canonical_name: The canonical package name.
        :param formats: The formats allowed for this package. Should be a set
            with 'binary' or 'source' or both in it.
        :param target_python: The target Python interpreter to use when
            evaluating link compatibility. This is used, for example, to
            check wheel compatibility, as well as when checking the Python
            version, e.g. the Python version embedded in a link filename
            (or egg fragment) and against an HTML link's optional PEP 503
            "data-requires-python" attribute.
        :param allow_yanked: Whether files marked as yanked (in the sense
            of PEP 592) are permitted to be candidates for install.
        :param ignore_requires_python: Whether to ignore incompatible
            PEP 503 "data-requires-python" values in HTML links. Defaults
            to False.
        """
        if ignore_requires_python is None:
            ignore_requires_python = False

        self._allow_yanked = allow_yanked
        self._canonical_name = canonical_name
        self._ignore_requires_python = ignore_requires_python
        self._formats = formats
        self._target_python = target_python

        self.project_name = project_name

    def evaluate_link(self, link):
        # type: (Link) -> Tuple[bool, Optional[Text]]
        """
        Determine whether a link is a candidate for installation.

        :return: A tuple (is_candidate, result), where `result` is (1) a
            version string if `is_candidate` is True, and (2) if
            `is_candidate` is False, an optional string to log the reason
            the link fails to qualify.
        """
        version = None
        if link.is_yanked and not self._allow_yanked:
            reason = link.yanked_reason or '<none given>'
            # Mark this as a unicode string to prevent "UnicodeEncodeError:
            # 'ascii' codec can't encode character" in Python 2 when
            # the reason contains non-ascii characters.
            return (False, u'yanked for reason: {}'.format(reason))

        if link.egg_fragment:
            egg_info = link.egg_fragment
            ext = link.ext
        else:
            egg_info, ext = link.splitext()
            if not ext:
                return (False, 'not a file')
            if ext not in SUPPORTED_EXTENSIONS:
                return (False, 'unsupported archive format: %s' % ext)
            if "binary" not in self._formats and ext == WHEEL_EXTENSION:
                reason = 'No binaries permitted for %s' % self.project_name
                return (False, reason)
            if "macosx10" in link.path and ext == '.zip':
                return (False, 'macosx10 one')
            if ext == WHEEL_EXTENSION:
                try:
                    wheel = Wheel(link.filename)
                except InvalidWheelFilename:
                    return (False, 'invalid wheel filename')
                if canonicalize_name(wheel.name) != self._canonical_name:
                    reason = 'wrong project name (not %s)' % self.project_name
                    return (False, reason)

                supported_tags = self._target_python.get_tags()
                if not wheel.supported(supported_tags):
                    # Include the wheel's tags in the reason string to
                    # simplify troubleshooting compatibility issues.
                    file_tags = wheel.get_formatted_file_tags()
                    reason = (
                        "none of the wheel's tags match: {}".format(
                            ', '.join(file_tags)
                        )
                    )
                    return (False, reason)

                version = wheel.version

        # This should be up by the self.ok_binary check, but see issue 2700.
        if "source" not in self._formats and ext != WHEEL_EXTENSION:
            return (False, 'No sources permitted for %s' % self.project_name)

        if not version:
            version = _extract_version_from_fragment(
                egg_info, self._canonical_name,
            )
        if not version:
            return (
                False, 'Missing project version for %s' % self.project_name,
            )

        match = self._py_version_re.search(version)
        if match:
            version = version[:match.start()]
            py_version = match.group(1)
            if py_version != self._target_python.py_version:
                return (False, 'Python version is incorrect')

        supports_python = _check_link_requires_python(
            link, version_info=self._target_python.py_version_info,
            ignore_requires_python=self._ignore_requires_python,
        )
        if not supports_python:
            # Return None for the reason text to suppress calling
            # _log_skipped_link().
            return (False, None)

        logger.debug('Found link %s, version: %s', link, version)

        return (True, version)


def filter_unallowed_hashes(
    candidates,    # type: List[InstallationCandidate]
    hashes,        # type: Hashes
    project_name,  # type: str
):
    # type: (...) -> List[InstallationCandidate]
    """
    Filter out candidates whose hashes aren't allowed, and return a new
    list of candidates.

    If at least one candidate has an allowed hash, then all candidates with
    either an allowed hash or no hash specified are returned.  Otherwise,
    the given candidates are returned.

    Including the candidates with no hash specified when there is a match
    allows a warning to be logged if there is a more preferred candidate
    with no hash specified.  Returning all candidates in the case of no
    matches lets pip report the hash of the candidate that would otherwise
    have been installed (e.g. permitting the user to more easily update
    their requirements file with the desired hash).
    """
    if not hashes:
        logger.debug(
            'Given no hashes to check %s links for project %r: '
            'discarding no candidates',
            len(candidates),
            project_name,
        )
        # Make sure we're not returning back the given value.
        return list(candidates)

    matches_or_no_digest = []
    # Collect the non-matches for logging purposes.
    non_matches = []
    match_count = 0
    for candidate in candidates:
        link = candidate.link
        if not link.has_hash:
            pass
        elif link.is_hash_allowed(hashes=hashes):
            match_count += 1
        else:
            non_matches.append(candidate)
            continue

        matches_or_no_digest.append(candidate)

    if match_count:
        filtered = matches_or_no_digest
    else:
        # Make sure we're not returning back the given value.
        filtered = list(candidates)

    if len(filtered) == len(candidates):
        discard_message = 'discarding no candidates'
    else:
        discard_message = 'discarding {} non-matches:\n  {}'.format(
            len(non_matches),
            '\n  '.join(str(candidate.link) for candidate in non_matches)
        )

    logger.debug(
        'Checked %s links for project %r against %s hashes '
        '(%s matches, %s no digest): %s',
        len(candidates),
        project_name,
        hashes.digest_count,
        match_count,
        len(matches_or_no_digest) - match_count,
        discard_message
    )

    return filtered


class CandidatePreferences(object):

    """
    Encapsulates some of the preferences for filtering and sorting
    InstallationCandidate objects.
    """

    def __init__(
        self,
        prefer_binary=False,  # type: bool
        allow_all_prereleases=False,  # type: bool
    ):
        # type: (...) -> None
        """
        :param allow_all_prereleases: Whether to allow all pre-releases.
        """
        self.allow_all_prereleases = allow_all_prereleases
        self.prefer_binary = prefer_binary


class BestCandidateResult(object):
    """A collection of candidates, returned by `PackageFinder.find_best_candidate`.

    This class is only intended to be instantiated by CandidateEvaluator's
    `compute_best_candidate()` method.
    """

    def __init__(
        self,
        candidates,             # type: List[InstallationCandidate]
        applicable_candidates,  # type: List[InstallationCandidate]
        best_candidate,         # type: Optional[InstallationCandidate]
    ):
        # type: (...) -> None
        """
        :param candidates: A sequence of all available candidates found.
        :param applicable_candidates: The applicable candidates.
        :param best_candidate: The most preferred candidate found, or None
            if no applicable candidates were found.
        """
        assert set(applicable_candidates) <= set(candidates)

        if best_candidate is None:
            assert not applicable_candidates
        else:
            assert best_candidate in applicable_candidates

        self._applicable_candidates = applicable_candidates
        self._candidates = candidates

        self.best_candidate = best_candidate

    def iter_all(self):
        # type: () -> Iterable[InstallationCandidate]
        """Iterate through all candidates.
        """
        return iter(self._candidates)

    def iter_applicable(self):
        # type: () -> Iterable[InstallationCandidate]
        """Iterate through the applicable candidates.
        """
        return iter(self._applicable_candidates)


class CandidateEvaluator(object):

    """
    Responsible for filtering and sorting candidates for installation based
    on what tags are valid.
    """

    @classmethod
    def create(
        cls,
        project_name,         # type: str
        target_python=None,   # type: Optional[TargetPython]
        prefer_binary=False,  # type: bool
        allow_all_prereleases=False,  # type: bool
        specifier=None,       # type: Optional[specifiers.BaseSpecifier]
        hashes=None,          # type: Optional[Hashes]
    ):
        # type: (...) -> CandidateEvaluator
        """Create a CandidateEvaluator object.

        :param target_python: The target Python interpreter to use when
            checking compatibility. If None (the default), a TargetPython
            object will be constructed from the running Python.
        :param specifier: An optional object implementing `filter`
            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
            versions.
        :param hashes: An optional collection of allowed hashes.
        """
        if target_python is None:
            target_python = TargetPython()
        if specifier is None:
            specifier = specifiers.SpecifierSet()

        supported_tags = target_python.get_tags()

        return cls(
            project_name=project_name,
            supported_tags=supported_tags,
            specifier=specifier,
            prefer_binary=prefer_binary,
            allow_all_prereleases=allow_all_prereleases,
            hashes=hashes,
        )

    def __init__(
        self,
        project_name,         # type: str
        supported_tags,       # type: List[Pep425Tag]
        specifier,            # type: specifiers.BaseSpecifier
        prefer_binary=False,  # type: bool
        allow_all_prereleases=False,  # type: bool
        hashes=None,                  # type: Optional[Hashes]
    ):
        # type: (...) -> None
        """
        :param supported_tags: The PEP 425 tags supported by the target
            Python in order of preference (most preferred first).
        """
        self._allow_all_prereleases = allow_all_prereleases
        self._hashes = hashes
        self._prefer_binary = prefer_binary
        self._project_name = project_name
        self._specifier = specifier
        self._supported_tags = supported_tags

    def get_applicable_candidates(
        self,
        candidates,  # type: List[InstallationCandidate]
    ):
        # type: (...) -> List[InstallationCandidate]
        """
        Return the applicable candidates from a list of candidates.
        """
        # Using None infers from the specifier instead.
        allow_prereleases = self._allow_all_prereleases or None
        specifier = self._specifier
        versions = {
            str(v) for v in specifier.filter(
                # We turn the version object into a str here because otherwise
                # when we're debundled but setuptools isn't, Python will see
                # packaging.version.Version and
                # pkg_resources._vendor.packaging.version.Version as different
                # types. This way we'll use a str as a common data interchange
                # format. If we stop using the pkg_resources provided specifier
                # and start using our own, we can drop the cast to str().
                (str(c.version) for c in candidates),
                prereleases=allow_prereleases,
            )
        }

        # Again, converting version to str to deal with debundling.
        applicable_candidates = [
            c for c in candidates if str(c.version) in versions
        ]

        return filter_unallowed_hashes(
            candidates=applicable_candidates,
            hashes=self._hashes,
            project_name=self._project_name,
        )

    def _sort_key(self, candidate):
        # type: (InstallationCandidate) -> CandidateSortingKey
        """
        Function to pass as the `key` argument to a call to sorted() to sort
        InstallationCandidates by preference.

        Returns a tuple such that tuples sorting as greater using Python's
        default comparison operator are more preferred.

        The preference is as follows:

        First and foremost, candidates with allowed (matching) hashes are
        always preferred over candidates without matching hashes. This is
        because e.g. if the only candidate with an allowed hash is yanked,
        we still want to use that candidate.

        Second, excepting hash considerations, candidates that have been
        yanked (in the sense of PEP 592) are always less preferred than
        candidates that haven't been yanked. Then:

        If not finding wheels, they are sorted by version only.
        If finding wheels, then the sort order is by version, then:
          1. existing installs
          2. wheels ordered via Wheel.support_index_min(self._supported_tags)
          3. source archives
        If prefer_binary was set, then all wheels are sorted above sources.

        Note: it was considered to embed this logic into the Link
              comparison operators, but then different sdist links
              with the same version, would have to be considered equal
        """
        valid_tags = self._supported_tags
        support_num = len(valid_tags)
        build_tag = ()  # type: BuildTag
        binary_preference = 0
        link = candidate.link
        if link.is_wheel:
            # can raise InvalidWheelFilename
            wheel = Wheel(link.filename)
            if not wheel.supported(valid_tags):
                raise UnsupportedWheel(
                    "%s is not a supported wheel for this platform. It "
                    "can't be sorted." % wheel.filename
                )
            if self._prefer_binary:
                binary_preference = 1
            pri = -(wheel.support_index_min(valid_tags))
            if wheel.build_tag is not None:
                match = re.match(r'^(\d+)(.*)$', wheel.build_tag)
                build_tag_groups = match.groups()
                build_tag = (int(build_tag_groups[0]), build_tag_groups[1])
        else:  # sdist
            pri = -(support_num)
        has_allowed_hash = int(link.is_hash_allowed(self._hashes))
        yank_value = -1 * int(link.is_yanked)  # -1 for yanked.
        return (
            has_allowed_hash, yank_value, binary_preference, candidate.version,
            build_tag, pri,
        )

    def sort_best_candidate(
        self,
        candidates,    # type: List[InstallationCandidate]
    ):
        # type: (...) -> Optional[InstallationCandidate]
        """
        Return the best candidate per the instance's sort order, or None if
        no candidate is acceptable.
        """
        if not candidates:
            return None

        best_candidate = max(candidates, key=self._sort_key)

        # Log a warning per PEP 592 if necessary before returning.
        link = best_candidate.link
        if link.is_yanked:
            reason = link.yanked_reason or '<none given>'
            msg = (
                # Mark this as a unicode string to prevent
                # "UnicodeEncodeError: 'ascii' codec can't encode character"
                # in Python 2 when the reason contains non-ascii characters.
                u'The candidate selected for download or install is a '
                'yanked version: {candidate}\n'
                'Reason for being yanked: {reason}'
            ).format(candidate=best_candidate, reason=reason)
            logger.warning(msg)

        return best_candidate

    def compute_best_candidate(
        self,
        candidates,      # type: List[InstallationCandidate]
    ):
        # type: (...) -> BestCandidateResult
        """
        Compute and return a `BestCandidateResult` instance.
        """
        applicable_candidates = self.get_applicable_candidates(candidates)

        best_candidate = self.sort_best_candidate(applicable_candidates)

        return BestCandidateResult(
            candidates,
            applicable_candidates=applicable_candidates,
            best_candidate=best_candidate,
        )


class PackageFinder(object):
    """This finds packages.

    This is meant to match easy_install's technique for looking for
    packages, by reading pages and looking for appropriate links.
    """

    def __init__(
        self,
        link_collector,       # type: LinkCollector
        target_python,        # type: TargetPython
        allow_yanked,         # type: bool
        format_control=None,  # type: Optional[FormatControl]
        candidate_prefs=None,         # type: CandidatePreferences
        ignore_requires_python=None,  # type: Optional[bool]
    ):
        # type: (...) -> None
        """
        This constructor is primarily meant to be used by the create() class
        method and from tests.

        :param format_control: A FormatControl object, used to control
            the selection of source packages / binary packages when consulting
            the index and links.
        :param candidate_prefs: Options to use when creating a
            CandidateEvaluator object.
        """
        if candidate_prefs is None:
            candidate_prefs = CandidatePreferences()

        format_control = format_control or FormatControl(set(), set())

        self._allow_yanked = allow_yanked
        self._candidate_prefs = candidate_prefs
        self._ignore_requires_python = ignore_requires_python
        self._link_collector = link_collector
        self._target_python = target_python

        self.format_control = format_control

        # These are boring links that have already been logged somehow.
        self._logged_links = set()  # type: Set[Link]

    # Don't include an allow_yanked default value to make sure each call
    # site considers whether yanked releases are allowed. This also causes
    # that decision to be made explicit in the calling code, which helps
    # people when reading the code.
    @classmethod
    def create(
        cls,
        link_collector,      # type: LinkCollector
        selection_prefs,     # type: SelectionPreferences
        target_python=None,  # type: Optional[TargetPython]
    ):
        # type: (...) -> PackageFinder
        """Create a PackageFinder.

        :param selection_prefs: The candidate selection preferences, as a
            SelectionPreferences object.
        :param target_python: The target Python interpreter to use when
            checking compatibility. If None (the default), a TargetPython
            object will be constructed from the running Python.
        """
        if target_python is None:
            target_python = TargetPython()

        candidate_prefs = CandidatePreferences(
            prefer_binary=selection_prefs.prefer_binary,
            allow_all_prereleases=selection_prefs.allow_all_prereleases,
        )

        return cls(
            candidate_prefs=candidate_prefs,
            link_collector=link_collector,
            target_python=target_python,
            allow_yanked=selection_prefs.allow_yanked,
            format_control=selection_prefs.format_control,
            ignore_requires_python=selection_prefs.ignore_requires_python,
        )

    @property
    def search_scope(self):
        # type: () -> SearchScope
        return self._link_collector.search_scope

    @search_scope.setter
    def search_scope(self, search_scope):
        # type: (SearchScope) -> None
        self._link_collector.search_scope = search_scope

    @property
    def find_links(self):
        # type: () -> List[str]
        return self._link_collector.find_links

    @property
    def index_urls(self):
        # type: () -> List[str]
        return self.search_scope.index_urls

    @property
    def trusted_hosts(self):
        # type: () -> Iterable[str]
        for host_port in self._link_collector.session.pip_trusted_origins:
            yield build_netloc(*host_port)

    @property
    def allow_all_prereleases(self):
        # type: () -> bool
        return self._candidate_prefs.allow_all_prereleases

    def set_allow_all_prereleases(self):
        # type: () -> None
        self._candidate_prefs.allow_all_prereleases = True

    def make_link_evaluator(self, project_name):
        # type: (str) -> LinkEvaluator
        canonical_name = canonicalize_name(project_name)
        formats = self.format_control.get_allowed_formats(canonical_name)

        return LinkEvaluator(
            project_name=project_name,
            canonical_name=canonical_name,
            formats=formats,
            target_python=self._target_python,
            allow_yanked=self._allow_yanked,
            ignore_requires_python=self._ignore_requires_python,
        )

    def _sort_links(self, links):
        # type: (Iterable[Link]) -> List[Link]
        """
        Returns elements of links in order, non-egg links first, egg links
        second, while eliminating duplicates
        """
        eggs, no_eggs = [], []
        seen = set()  # type: Set[Link]
        for link in links:
            if link not in seen:
                seen.add(link)
                if link.egg_fragment:
                    eggs.append(link)
                else:
                    no_eggs.append(link)
        return no_eggs + eggs

    def _log_skipped_link(self, link, reason):
        # type: (Link, Text) -> None
        if link not in self._logged_links:
            # Mark this as a unicode string to prevent "UnicodeEncodeError:
            # 'ascii' codec can't encode character" in Python 2 when
            # the reason contains non-ascii characters.
            #   Also, put the link at the end so the reason is more visible
            # and because the link string is usually very long.
            logger.debug(u'Skipping link: %s: %s', reason, link)
            self._logged_links.add(link)

    def get_install_candidate(self, link_evaluator, link):
        # type: (LinkEvaluator, Link) -> Optional[InstallationCandidate]
        """
        If the link is a candidate for install, convert it to an
        InstallationCandidate and return it. Otherwise, return None.
        """
        is_candidate, result = link_evaluator.evaluate_link(link)
        if not is_candidate:
            if result:
                self._log_skipped_link(link, reason=result)
            return None

        return InstallationCandidate(
            project=link_evaluator.project_name,
            link=link,
            # Convert the Text result to str since InstallationCandidate
            # accepts str.
            version=str(result),
        )

    def evaluate_links(self, link_evaluator, links):
        # type: (LinkEvaluator, Iterable[Link]) -> List[InstallationCandidate]
        """
        Convert links that are candidates to InstallationCandidate objects.
        """
        candidates = []
        for link in self._sort_links(links):
            candidate = self.get_install_candidate(link_evaluator, link)
            if candidate is not None:
                candidates.append(candidate)

        return candidates

    def find_all_candidates(self, project_name):
        # type: (str) -> List[InstallationCandidate]
        """Find all available InstallationCandidate for project_name

        This checks index_urls and find_links.
        All versions found are returned as an InstallationCandidate list.

        See LinkEvaluator.evaluate_link() for details on which files
        are accepted.
        """
        collected_links = self._link_collector.collect_links(project_name)

        link_evaluator = self.make_link_evaluator(project_name)

        find_links_versions = self.evaluate_links(
            link_evaluator,
            links=collected_links.find_links,
        )

        page_versions = []
        for page_url, page_links in collected_links.pages.items():
            logger.debug('Analyzing links from page %s', page_url)
            with indent_log():
                new_versions = self.evaluate_links(
                    link_evaluator,
                    links=page_links,
                )
                page_versions.extend(new_versions)

        file_versions = self.evaluate_links(
            link_evaluator,
            links=collected_links.files,
        )
        if file_versions:
            file_versions.sort(reverse=True)
            logger.debug(
                'Local files found: %s',
                ', '.join([
                    url_to_path(candidate.link.url)
                    for candidate in file_versions
                ])
            )

        # This is an intentional priority ordering
        return file_versions + find_links_versions + page_versions

    def make_candidate_evaluator(
        self,
        project_name,    # type: str
        specifier=None,  # type: Optional[specifiers.BaseSpecifier]
        hashes=None,     # type: Optional[Hashes]
    ):
        # type: (...) -> CandidateEvaluator
        """Create a CandidateEvaluator object to use.
        """
        candidate_prefs = self._candidate_prefs
        return CandidateEvaluator.create(
            project_name=project_name,
            target_python=self._target_python,
            prefer_binary=candidate_prefs.prefer_binary,
            allow_all_prereleases=candidate_prefs.allow_all_prereleases,
            specifier=specifier,
            hashes=hashes,
        )

    def find_best_candidate(
        self,
        project_name,       # type: str
        specifier=None,     # type: Optional[specifiers.BaseSpecifier]
        hashes=None,        # type: Optional[Hashes]
    ):
        # type: (...) -> BestCandidateResult
        """Find matches for the given project and specifier.

        :param specifier: An optional object implementing `filter`
            (e.g. `packaging.specifiers.SpecifierSet`) to filter applicable
            versions.

        :return: A `BestCandidateResult` instance.
        """
        candidates = self.find_all_candidates(project_name)
        candidate_evaluator = self.make_candidate_evaluator(
            project_name=project_name,
            specifier=specifier,
            hashes=hashes,
        )
        return candidate_evaluator.compute_best_candidate(candidates)

    def find_requirement(self, req, upgrade):
        # type: (InstallRequirement, bool) -> Optional[Link]
        """Try to find a Link matching req

        Expects req, an InstallRequirement and upgrade, a boolean
        Returns a Link if found,
        Raises DistributionNotFound or BestVersionAlreadyInstalled otherwise
        """
        hashes = req.hashes(trust_internet=False)
        best_candidate_result = self.find_best_candidate(
            req.name, specifier=req.specifier, hashes=hashes,
        )
        best_candidate = best_candidate_result.best_candidate

        installed_version = None    # type: Optional[_BaseVersion]
        if req.satisfied_by is not None:
            installed_version = parse_version(req.satisfied_by.version)

        def _format_versions(cand_iter):
            # This repeated parse_version and str() conversion is needed to
            # handle different vendoring sources from pip and pkg_resources.
            # If we stop using the pkg_resources provided specifier and start
            # using our own, we can drop the cast to str().
            return ", ".join(sorted(
                {str(c.version) for c in cand_iter},
                key=parse_version,
            )) or "none"

        if installed_version is None and best_candidate is None:
            logger.critical(
                'Could not find a version that satisfies the requirement %s '
                '(from versions: %s)',
                req,
                _format_versions(best_candidate_result.iter_all()),
            )

            raise DistributionNotFound(
                'No matching distribution found for %s' % req
            )

        best_installed = False
        if installed_version and (
                best_candidate is None or
                best_candidate.version <= installed_version):
            best_installed = True

        if not upgrade and installed_version is not None:
            if best_installed:
                logger.debug(
                    'Existing installed version (%s) is most up-to-date and '
                    'satisfies requirement',
                    installed_version,
                )
            else:
                logger.debug(
                    'Existing installed version (%s) satisfies requirement '
                    '(most up-to-date version is %s)',
                    installed_version,
                    best_candidate.version,
                )
            return None

        if best_installed:
            # We have an existing version, and its the best version
            logger.debug(
                'Installed version (%s) is most up-to-date (past versions: '
                '%s)',
                installed_version,
                _format_versions(best_candidate_result.iter_applicable()),
            )
            raise BestVersionAlreadyInstalled

        logger.debug(
            'Using version %s (newest of versions: %s)',
            best_candidate.version,
            _format_versions(best_candidate_result.iter_applicable()),
        )
        return best_candidate.link


def _find_name_version_sep(fragment, canonical_name):
    # type: (str, str) -> int
    """Find the separator's index based on the package's canonical name.

    :param fragment: A <package>+<version> filename "fragment" (stem) or
        egg fragment.
    :param canonical_name: The package's canonical name.

    This function is needed since the canonicalized name does not necessarily
    have the same length as the egg info's name part. An example::

    >>> fragment = 'foo__bar-1.0'
    >>> canonical_name = 'foo-bar'
    >>> _find_name_version_sep(fragment, canonical_name)
    8
    """
    # Project name and version must be separated by one single dash. Find all
    # occurrences of dashes; if the string in front of it matches the canonical
    # name, this is the one separating the name and version parts.
    for i, c in enumerate(fragment):
        if c != "-":
            continue
        if canonicalize_name(fragment[:i]) == canonical_name:
            return i
    raise ValueError("{} does not match {}".format(fragment, canonical_name))


def _extract_version_from_fragment(fragment, canonical_name):
    # type: (str, str) -> Optional[str]
    """Parse the version string from a <package>+<version> filename
    "fragment" (stem) or egg fragment.

    :param fragment: The string to parse. E.g. foo-2.1
    :param canonical_name: The canonicalized name of the package this
        belongs to.
    """
    try:
        version_start = _find_name_version_sep(fragment, canonical_name) + 1
    except ValueError:
        return None
    version = fragment[version_start:]
    if not version:
        return None
    return version
site-packages/pip/_internal/main.py000064400000002517151446176770013354 0ustar00"""Primary application entrypoint.
"""
# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import locale
import logging
import os
import sys

from pip._internal.cli.autocompletion import autocomplete
from pip._internal.cli.main_parser import parse_command
from pip._internal.commands import create_command
from pip._internal.exceptions import PipError
from pip._internal.utils import deprecation

logger = logging.getLogger(__name__)


def main(args=None):
    if args is None:
        args = sys.argv[1:]

    # Configure our deprecation warnings to be sent through loggers
    deprecation.install_warning_logger()

    autocomplete()

    try:
        cmd_name, cmd_args = parse_command(args)
    except PipError as exc:
        sys.stderr.write("ERROR: %s" % exc)
        sys.stderr.write(os.linesep)
        sys.exit(1)

    # Needed for locale.getpreferredencoding(False) to work
    # in pip._internal.utils.encoding.auto_decode
    try:
        locale.setlocale(locale.LC_ALL, '')
    except locale.Error as e:
        # setlocale can apparently crash if locale are uninitialized
        logger.debug("Ignoring error %s when setting locale", e)
    command = create_command(cmd_name, isolated=("--isolated" in cmd_args))

    return command.main(cmd_args)
site-packages/pip/_internal/utils/urls.py000064400000002711151446176770014551 0ustar00import os
import sys

from pip._vendor.six.moves.urllib import parse as urllib_parse
from pip._vendor.six.moves.urllib import request as urllib_request

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional, Text, Union


def get_url_scheme(url):
    # type: (Union[str, Text]) -> Optional[Text]
    if ':' not in url:
        return None
    return url.split(':', 1)[0].lower()


def path_to_url(path):
    # type: (Union[str, Text]) -> str
    """
    Convert a path to a file: URL.  The path will be made absolute and have
    quoted path parts.
    """
    path = os.path.normpath(os.path.abspath(path))
    url = urllib_parse.urljoin('file:', urllib_request.pathname2url(path))
    return url


def url_to_path(url):
    # type: (str) -> str
    """
    Convert a file: URL to a path.
    """
    assert url.startswith('file:'), (
        "You can only turn file: urls into filenames (not %r)" % url)

    _, netloc, path, _, _ = urllib_parse.urlsplit(url)

    if not netloc or netloc == 'localhost':
        # According to RFC 8089, same as empty authority.
        netloc = ''
    elif sys.platform == 'win32':
        # If we have a UNC path, prepend UNC share notation.
        netloc = '\\\\' + netloc
    else:
        raise ValueError(
            'non-local file URIs are not supported on this platform: %r'
            % url
        )

    path = urllib_request.url2pathname(netloc + path)
    return path
site-packages/pip/_internal/utils/ui.py000064400000033122151446176770014201 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import, division

import contextlib
import itertools
import logging
import sys
import time
from signal import SIGINT, default_int_handler, signal

from pip._vendor import six
from pip._vendor.progress import HIDE_CURSOR, SHOW_CURSOR
from pip._vendor.progress.bar import Bar, FillingCirclesBar, IncrementalBar
from pip._vendor.progress.spinner import Spinner

from pip._internal.utils.compat import WINDOWS
from pip._internal.utils.logging import get_indentation
from pip._internal.utils.misc import format_size
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Any, Iterator, IO

try:
    from pip._vendor import colorama
# Lots of different errors can come from this, including SystemError and
# ImportError.
except Exception:
    colorama = None

logger = logging.getLogger(__name__)


def _select_progress_class(preferred, fallback):
    encoding = getattr(preferred.file, "encoding", None)

    # If we don't know what encoding this file is in, then we'll just assume
    # that it doesn't support unicode and use the ASCII bar.
    if not encoding:
        return fallback

    # Collect all of the possible characters we want to use with the preferred
    # bar.
    characters = [
        getattr(preferred, "empty_fill", six.text_type()),
        getattr(preferred, "fill", six.text_type()),
    ]
    characters += list(getattr(preferred, "phases", []))

    # Try to decode the characters we're using for the bar using the encoding
    # of the given file, if this works then we'll assume that we can use the
    # fancier bar and if not we'll fall back to the plaintext bar.
    try:
        six.text_type().join(characters).encode(encoding)
    except UnicodeEncodeError:
        return fallback
    else:
        return preferred


_BaseBar = _select_progress_class(IncrementalBar, Bar)  # type: Any


class InterruptibleMixin(object):
    """
    Helper to ensure that self.finish() gets called on keyboard interrupt.

    This allows downloads to be interrupted without leaving temporary state
    (like hidden cursors) behind.

    This class is similar to the progress library's existing SigIntMixin
    helper, but as of version 1.2, that helper has the following problems:

    1. It calls sys.exit().
    2. It discards the existing SIGINT handler completely.
    3. It leaves its own handler in place even after an uninterrupted finish,
       which will have unexpected delayed effects if the user triggers an
       unrelated keyboard interrupt some time after a progress-displaying
       download has already completed, for example.
    """

    def __init__(self, *args, **kwargs):
        """
        Save the original SIGINT handler for later.
        """
        super(InterruptibleMixin, self).__init__(*args, **kwargs)

        self.original_handler = signal(SIGINT, self.handle_sigint)

        # If signal() returns None, the previous handler was not installed from
        # Python, and we cannot restore it. This probably should not happen,
        # but if it does, we must restore something sensible instead, at least.
        # The least bad option should be Python's default SIGINT handler, which
        # just raises KeyboardInterrupt.
        if self.original_handler is None:
            self.original_handler = default_int_handler

    def finish(self):
        """
        Restore the original SIGINT handler after finishing.

        This should happen regardless of whether the progress display finishes
        normally, or gets interrupted.
        """
        super(InterruptibleMixin, self).finish()
        signal(SIGINT, self.original_handler)

    def handle_sigint(self, signum, frame):
        """
        Call self.finish() before delegating to the original SIGINT handler.

        This handler should only be in place while the progress display is
        active.
        """
        self.finish()
        self.original_handler(signum, frame)


class SilentBar(Bar):

    def update(self):
        pass


class BlueEmojiBar(IncrementalBar):

    suffix = "%(percent)d%%"
    bar_prefix = " "
    bar_suffix = " "
    phases = (u"\U0001F539", u"\U0001F537", u"\U0001F535")  # type: Any


class DownloadProgressMixin(object):

    def __init__(self, *args, **kwargs):
        super(DownloadProgressMixin, self).__init__(*args, **kwargs)
        self.message = (" " * (get_indentation() + 2)) + self.message

    @property
    def downloaded(self):
        return format_size(self.index)

    @property
    def download_speed(self):
        # Avoid zero division errors...
        if self.avg == 0.0:
            return "..."
        return format_size(1 / self.avg) + "/s"

    @property
    def pretty_eta(self):
        if self.eta:
            return "eta %s" % self.eta_td
        return ""

    def iter(self, it, n=1):
        for x in it:
            yield x
            self.next(n)
        self.finish()


class WindowsMixin(object):

    def __init__(self, *args, **kwargs):
        # The Windows terminal does not support the hide/show cursor ANSI codes
        # even with colorama. So we'll ensure that hide_cursor is False on
        # Windows.
        # This call needs to go before the super() call, so that hide_cursor
        # is set in time. The base progress bar class writes the "hide cursor"
        # code to the terminal in its init, so if we don't set this soon
        # enough, we get a "hide" with no corresponding "show"...
        if WINDOWS and self.hide_cursor:
            self.hide_cursor = False

        super(WindowsMixin, self).__init__(*args, **kwargs)

        # Check if we are running on Windows and we have the colorama module,
        # if we do then wrap our file with it.
        if WINDOWS and colorama:
            self.file = colorama.AnsiToWin32(self.file)
            # The progress code expects to be able to call self.file.isatty()
            # but the colorama.AnsiToWin32() object doesn't have that, so we'll
            # add it.
            self.file.isatty = lambda: self.file.wrapped.isatty()
            # The progress code expects to be able to call self.file.flush()
            # but the colorama.AnsiToWin32() object doesn't have that, so we'll
            # add it.
            self.file.flush = lambda: self.file.wrapped.flush()


class BaseDownloadProgressBar(WindowsMixin, InterruptibleMixin,
                              DownloadProgressMixin):

    file = sys.stdout
    message = "%(percent)d%%"
    suffix = "%(downloaded)s %(download_speed)s %(pretty_eta)s"

# NOTE: The "type: ignore" comments on the following classes are there to
#       work around https://github.com/python/typing/issues/241


class DefaultDownloadProgressBar(BaseDownloadProgressBar,
                                 _BaseBar):
    pass


class DownloadSilentBar(BaseDownloadProgressBar, SilentBar):  # type: ignore
    pass


class DownloadBar(BaseDownloadProgressBar,  # type: ignore
                  Bar):
    pass


class DownloadFillingCirclesBar(BaseDownloadProgressBar,  # type: ignore
                                FillingCirclesBar):
    pass


class DownloadBlueEmojiProgressBar(BaseDownloadProgressBar,  # type: ignore
                                   BlueEmojiBar):
    pass


class DownloadProgressSpinner(WindowsMixin, InterruptibleMixin,
                              DownloadProgressMixin, Spinner):

    file = sys.stdout
    suffix = "%(downloaded)s %(download_speed)s"

    def next_phase(self):
        if not hasattr(self, "_phaser"):
            self._phaser = itertools.cycle(self.phases)
        return next(self._phaser)

    def update(self):
        message = self.message % self
        phase = self.next_phase()
        suffix = self.suffix % self
        line = ''.join([
            message,
            " " if message else "",
            phase,
            " " if suffix else "",
            suffix,
        ])

        self.writeln(line)


BAR_TYPES = {
    "off": (DownloadSilentBar, DownloadSilentBar),
    "on": (DefaultDownloadProgressBar, DownloadProgressSpinner),
    "ascii": (DownloadBar, DownloadProgressSpinner),
    "pretty": (DownloadFillingCirclesBar, DownloadProgressSpinner),
    "emoji": (DownloadBlueEmojiProgressBar, DownloadProgressSpinner)
}


def DownloadProgressProvider(progress_bar, max=None):
    if max is None or max == 0:
        return BAR_TYPES[progress_bar][1]().iter
    else:
        return BAR_TYPES[progress_bar][0](max=max).iter


################################################################
# Generic "something is happening" spinners
#
# We don't even try using progress.spinner.Spinner here because it's actually
# simpler to reimplement from scratch than to coerce their code into doing
# what we need.
################################################################

@contextlib.contextmanager
def hidden_cursor(file):
    # type: (IO) -> Iterator[None]
    # The Windows terminal does not support the hide/show cursor ANSI codes,
    # even via colorama. So don't even try.
    if WINDOWS:
        yield
    # We don't want to clutter the output with control characters if we're
    # writing to a file, or if the user is running with --quiet.
    # See https://github.com/pypa/pip/issues/3418
    elif not file.isatty() or logger.getEffectiveLevel() > logging.INFO:
        yield
    else:
        file.write(HIDE_CURSOR)
        try:
            yield
        finally:
            file.write(SHOW_CURSOR)


class RateLimiter(object):
    def __init__(self, min_update_interval_seconds):
        # type: (float) -> None
        self._min_update_interval_seconds = min_update_interval_seconds
        self._last_update = 0  # type: float

    def ready(self):
        # type: () -> bool
        now = time.time()
        delta = now - self._last_update
        return delta >= self._min_update_interval_seconds

    def reset(self):
        # type: () -> None
        self._last_update = time.time()


class SpinnerInterface(object):
    def spin(self):
        # type: () -> None
        raise NotImplementedError()

    def finish(self, final_status):
        # type: (str) -> None
        raise NotImplementedError()


class InteractiveSpinner(SpinnerInterface):
    def __init__(self, message, file=None, spin_chars="-\\|/",
                 # Empirically, 8 updates/second looks nice
                 min_update_interval_seconds=0.125):
        self._message = message
        if file is None:
            file = sys.stdout
        self._file = file
        self._rate_limiter = RateLimiter(min_update_interval_seconds)
        self._finished = False

        self._spin_cycle = itertools.cycle(spin_chars)

        self._file.write(" " * get_indentation() + self._message + " ... ")
        self._width = 0

    def _write(self, status):
        assert not self._finished
        # Erase what we wrote before by backspacing to the beginning, writing
        # spaces to overwrite the old text, and then backspacing again
        backup = "\b" * self._width
        self._file.write(backup + " " * self._width + backup)
        # Now we have a blank slate to add our status
        self._file.write(status)
        self._width = len(status)
        self._file.flush()
        self._rate_limiter.reset()

    def spin(self):
        # type: () -> None
        if self._finished:
            return
        if not self._rate_limiter.ready():
            return
        self._write(next(self._spin_cycle))

    def finish(self, final_status):
        # type: (str) -> None
        if self._finished:
            return
        self._write(final_status)
        self._file.write("\n")
        self._file.flush()
        self._finished = True


# Used for dumb terminals, non-interactive installs (no tty), etc.
# We still print updates occasionally (once every 60 seconds by default) to
# act as a keep-alive for systems like Travis-CI that take lack-of-output as
# an indication that a task has frozen.
class NonInteractiveSpinner(SpinnerInterface):
    def __init__(self, message, min_update_interval_seconds=60):
        # type: (str, float) -> None
        self._message = message
        self._finished = False
        self._rate_limiter = RateLimiter(min_update_interval_seconds)
        self._update("started")

    def _update(self, status):
        assert not self._finished
        self._rate_limiter.reset()
        logger.info("%s: %s", self._message, status)

    def spin(self):
        # type: () -> None
        if self._finished:
            return
        if not self._rate_limiter.ready():
            return
        self._update("still running...")

    def finish(self, final_status):
        # type: (str) -> None
        if self._finished:
            return
        self._update("finished with status '%s'" % (final_status,))
        self._finished = True


@contextlib.contextmanager
def open_spinner(message):
    # type: (str) -> Iterator[SpinnerInterface]
    # Interactive spinner goes directly to sys.stdout rather than being routed
    # through the logging system, but it acts like it has level INFO,
    # i.e. it's only displayed if we're at level INFO or better.
    # Non-interactive spinner goes through the logging system, so it is always
    # in sync with logging configuration.
    if sys.stdout.isatty() and logger.getEffectiveLevel() <= logging.INFO:
        spinner = InteractiveSpinner(message)  # type: SpinnerInterface
    else:
        spinner = NonInteractiveSpinner(message)
    try:
        with hidden_cursor(sys.stdout):
            yield spinner
    except KeyboardInterrupt:
        spinner.finish("canceled")
        raise
    except Exception:
        spinner.finish("error")
        raise
    else:
        spinner.finish("done")
site-packages/pip/_internal/utils/encoding.py000064400000002450151446176770015352 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

import codecs
import locale
import re
import sys

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import List, Tuple, Text

BOMS = [
    (codecs.BOM_UTF8, 'utf-8'),
    (codecs.BOM_UTF16, 'utf-16'),
    (codecs.BOM_UTF16_BE, 'utf-16-be'),
    (codecs.BOM_UTF16_LE, 'utf-16-le'),
    (codecs.BOM_UTF32, 'utf-32'),
    (codecs.BOM_UTF32_BE, 'utf-32-be'),
    (codecs.BOM_UTF32_LE, 'utf-32-le'),
]  # type: List[Tuple[bytes, Text]]

ENCODING_RE = re.compile(br'coding[:=]\s*([-\w.]+)')


def auto_decode(data):
    # type: (bytes) -> Text
    """Check a bytes string for a BOM to correctly detect the encoding

    Fallback to locale.getpreferredencoding(False) like open() on Python3"""
    for bom, encoding in BOMS:
        if data.startswith(bom):
            return data[len(bom):].decode(encoding)
    # Lets check the first two lines as in PEP263
    for line in data.split(b'\n')[:2]:
        if line[0:1] == b'#' and ENCODING_RE.search(line):
            encoding = ENCODING_RE.search(line).groups()[0].decode('ascii')
            return data.decode(encoding)
    return data.decode(
        locale.getpreferredencoding(False) or sys.getdefaultencoding(),
    )
site-packages/pip/_internal/utils/logging.py000064400000031351151446176770015214 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import contextlib
import errno
import logging
import logging.handlers
import os
import sys
from logging import Filter, getLogger

from pip._vendor.six import PY2

from pip._internal.utils.compat import WINDOWS
from pip._internal.utils.deprecation import DEPRECATION_MSG_PREFIX
from pip._internal.utils.misc import ensure_dir

try:
    import threading
except ImportError:
    import dummy_threading as threading  # type: ignore


try:
    # Use "import as" and set colorama in the else clause to avoid mypy
    # errors and get the following correct revealed type for colorama:
    # `Union[_importlib_modulespec.ModuleType, None]`
    # Otherwise, we get an error like the following in the except block:
    #  > Incompatible types in assignment (expression has type "None",
    #   variable has type Module)
    # TODO: eliminate the need to use "import as" once mypy addresses some
    #  of its issues with conditional imports. Here is an umbrella issue:
    #  https://github.com/python/mypy/issues/1297
    from pip._vendor import colorama as _colorama
# Lots of different errors can come from this, including SystemError and
# ImportError.
except Exception:
    colorama = None
else:
    # Import Fore explicitly rather than accessing below as colorama.Fore
    # to avoid the following error running mypy:
    # > Module has no attribute "Fore"
    # TODO: eliminate the need to import Fore once mypy addresses some of its
    #  issues with conditional imports. This particular case could be an
    #  instance of the following issue (but also see the umbrella issue above):
    #  https://github.com/python/mypy/issues/3500
    from pip._vendor.colorama import Fore

    colorama = _colorama


_log_state = threading.local()
_log_state.indentation = 0
subprocess_logger = getLogger('pip.subprocessor')


class BrokenStdoutLoggingError(Exception):
    """
    Raised if BrokenPipeError occurs for the stdout stream while logging.
    """
    pass


# BrokenPipeError does not exist in Python 2 and, in addition, manifests
# differently in Windows and non-Windows.
if WINDOWS:
    # In Windows, a broken pipe can show up as EINVAL rather than EPIPE:
    # https://bugs.python.org/issue19612
    # https://bugs.python.org/issue30418
    if PY2:
        def _is_broken_pipe_error(exc_class, exc):
            """See the docstring for non-Windows Python 3 below."""
            return (exc_class is IOError and
                    exc.errno in (errno.EINVAL, errno.EPIPE))
    else:
        # In Windows, a broken pipe IOError became OSError in Python 3.
        def _is_broken_pipe_error(exc_class, exc):
            """See the docstring for non-Windows Python 3 below."""
            return ((exc_class is BrokenPipeError) or  # noqa: F821
                    (exc_class is OSError and
                     exc.errno in (errno.EINVAL, errno.EPIPE)))
elif PY2:
    def _is_broken_pipe_error(exc_class, exc):
        """See the docstring for non-Windows Python 3 below."""
        return (exc_class is IOError and exc.errno == errno.EPIPE)
else:
    # Then we are in the non-Windows Python 3 case.
    def _is_broken_pipe_error(exc_class, exc):
        """
        Return whether an exception is a broken pipe error.

        Args:
          exc_class: an exception class.
          exc: an exception instance.
        """
        return (exc_class is BrokenPipeError)  # noqa: F821


@contextlib.contextmanager
def indent_log(num=2):
    """
    A context manager which will cause the log output to be indented for any
    log messages emitted inside it.
    """
    _log_state.indentation += num
    try:
        yield
    finally:
        _log_state.indentation -= num


def get_indentation():
    return getattr(_log_state, 'indentation', 0)


class IndentingFormatter(logging.Formatter):

    def __init__(self, *args, **kwargs):
        """
        A logging.Formatter that obeys the indent_log() context manager.

        :param add_timestamp: A bool indicating output lines should be prefixed
            with their record's timestamp.
        """
        self.add_timestamp = kwargs.pop("add_timestamp", False)
        super(IndentingFormatter, self).__init__(*args, **kwargs)

    def get_message_start(self, formatted, levelno):
        """
        Return the start of the formatted log message (not counting the
        prefix to add to each line).
        """
        if levelno < logging.WARNING:
            return ''
        if formatted.startswith(DEPRECATION_MSG_PREFIX):
            # Then the message already has a prefix.  We don't want it to
            # look like "WARNING: DEPRECATION: ...."
            return ''
        if levelno < logging.ERROR:
            return 'WARNING: '

        return 'ERROR: '

    def format(self, record):
        """
        Calls the standard formatter, but will indent all of the log message
        lines by our current indentation level.
        """
        formatted = super(IndentingFormatter, self).format(record)
        message_start = self.get_message_start(formatted, record.levelno)
        formatted = message_start + formatted

        prefix = ''
        if self.add_timestamp:
            # TODO: Use Formatter.default_time_format after dropping PY2.
            t = self.formatTime(record, "%Y-%m-%dT%H:%M:%S")
            prefix = '%s,%03d ' % (t, record.msecs)
        prefix += " " * get_indentation()
        formatted = "".join([
            prefix + line
            for line in formatted.splitlines(True)
        ])
        return formatted


def _color_wrap(*colors):
    def wrapped(inp):
        return "".join(list(colors) + [inp, colorama.Style.RESET_ALL])
    return wrapped


class ColorizedStreamHandler(logging.StreamHandler):

    # Don't build up a list of colors if we don't have colorama
    if colorama:
        COLORS = [
            # This needs to be in order from highest logging level to lowest.
            (logging.ERROR, _color_wrap(Fore.RED)),
            (logging.WARNING, _color_wrap(Fore.YELLOW)),
        ]
    else:
        COLORS = []

    def __init__(self, stream=None, no_color=None):
        logging.StreamHandler.__init__(self, stream)
        self._no_color = no_color

        if WINDOWS and colorama:
            self.stream = colorama.AnsiToWin32(self.stream)

    def _using_stdout(self):
        """
        Return whether the handler is using sys.stdout.
        """
        if WINDOWS and colorama:
            # Then self.stream is an AnsiToWin32 object.
            return self.stream.wrapped is sys.stdout

        return self.stream is sys.stdout

    def should_color(self):
        # Don't colorize things if we do not have colorama or if told not to
        if not colorama or self._no_color:
            return False

        real_stream = (
            self.stream if not isinstance(self.stream, colorama.AnsiToWin32)
            else self.stream.wrapped
        )

        # If the stream is a tty we should color it
        if hasattr(real_stream, "isatty") and real_stream.isatty():
            return True

        # If we have an ANSI term we should color it
        if os.environ.get("TERM") == "ANSI":
            return True

        # If anything else we should not color it
        return False

    def format(self, record):
        msg = logging.StreamHandler.format(self, record)

        if self.should_color():
            for level, color in self.COLORS:
                if record.levelno >= level:
                    msg = color(msg)
                    break

        return msg

    # The logging module says handleError() can be customized.
    def handleError(self, record):
        exc_class, exc = sys.exc_info()[:2]
        # If a broken pipe occurred while calling write() or flush() on the
        # stdout stream in logging's Handler.emit(), then raise our special
        # exception so we can handle it in main() instead of logging the
        # broken pipe error and continuing.
        if (exc_class and self._using_stdout() and
                _is_broken_pipe_error(exc_class, exc)):
            raise BrokenStdoutLoggingError()

        return super(ColorizedStreamHandler, self).handleError(record)


class BetterRotatingFileHandler(logging.handlers.RotatingFileHandler):

    def _open(self):
        ensure_dir(os.path.dirname(self.baseFilename))
        return logging.handlers.RotatingFileHandler._open(self)


class MaxLevelFilter(Filter):

    def __init__(self, level):
        self.level = level

    def filter(self, record):
        return record.levelno < self.level


class ExcludeLoggerFilter(Filter):

    """
    A logging Filter that excludes records from a logger (or its children).
    """

    def filter(self, record):
        # The base Filter class allows only records from a logger (or its
        # children).
        return not super(ExcludeLoggerFilter, self).filter(record)


def setup_logging(verbosity, no_color, user_log_file):
    """Configures and sets up all of the logging

    Returns the requested logging level, as its integer value.
    """

    # Determine the level to be logging at.
    if verbosity >= 1:
        level = "DEBUG"
    elif verbosity == -1:
        level = "WARNING"
    elif verbosity == -2:
        level = "ERROR"
    elif verbosity <= -3:
        level = "CRITICAL"
    else:
        level = "INFO"

    level_number = getattr(logging, level)

    # The "root" logger should match the "console" level *unless* we also need
    # to log to a user log file.
    include_user_log = user_log_file is not None
    if include_user_log:
        additional_log_file = user_log_file
        root_level = "DEBUG"
    else:
        additional_log_file = "/dev/null"
        root_level = level

    # Disable any logging besides WARNING unless we have DEBUG level logging
    # enabled for vendored libraries.
    vendored_log_level = "WARNING" if level in ["INFO", "ERROR"] else "DEBUG"

    # Shorthands for clarity
    log_streams = {
        "stdout": "ext://sys.stdout",
        "stderr": "ext://sys.stderr",
    }
    handler_classes = {
        "stream": "pip._internal.utils.logging.ColorizedStreamHandler",
        "file": "pip._internal.utils.logging.BetterRotatingFileHandler",
    }
    handlers = ["console", "console_errors", "console_subprocess"] + (
        ["user_log"] if include_user_log else []
    )

    logging.config.dictConfig({
        "version": 1,
        "disable_existing_loggers": False,
        "filters": {
            "exclude_warnings": {
                "()": "pip._internal.utils.logging.MaxLevelFilter",
                "level": logging.WARNING,
            },
            "restrict_to_subprocess": {
                "()": "logging.Filter",
                "name": subprocess_logger.name,
            },
            "exclude_subprocess": {
                "()": "pip._internal.utils.logging.ExcludeLoggerFilter",
                "name": subprocess_logger.name,
            },
        },
        "formatters": {
            "indent": {
                "()": IndentingFormatter,
                "format": "%(message)s",
            },
            "indent_with_timestamp": {
                "()": IndentingFormatter,
                "format": "%(message)s",
                "add_timestamp": True,
            },
        },
        "handlers": {
            "console": {
                "level": level,
                "class": handler_classes["stream"],
                "no_color": no_color,
                "stream": log_streams["stdout"],
                "filters": ["exclude_subprocess", "exclude_warnings"],
                "formatter": "indent",
            },
            "console_errors": {
                "level": "WARNING",
                "class": handler_classes["stream"],
                "no_color": no_color,
                "stream": log_streams["stderr"],
                "filters": ["exclude_subprocess"],
                "formatter": "indent",
            },
            # A handler responsible for logging to the console messages
            # from the "subprocessor" logger.
            "console_subprocess": {
                "level": level,
                "class": handler_classes["stream"],
                "no_color": no_color,
                "stream": log_streams["stderr"],
                "filters": ["restrict_to_subprocess"],
                "formatter": "indent",
            },
            "user_log": {
                "level": "DEBUG",
                "class": handler_classes["file"],
                "filename": additional_log_file,
                "delay": True,
                "formatter": "indent_with_timestamp",
            },
        },
        "root": {
            "level": root_level,
            "handlers": handlers,
        },
        "loggers": {
            "pip._vendor": {
                "level": vendored_log_level
            }
        },
    })

    return level_number
site-packages/pip/_internal/utils/setuptools_build.py000064400000003137151446176770017167 0ustar00import sys

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import List, Sequence

# Shim to wrap setup.py invocation with setuptools
#
# We set sys.argv[0] to the path to the underlying setup.py file so
# setuptools / distutils don't take the path to the setup.py to be "-c" when
# invoking via the shim.  This avoids e.g. the following manifest_maker
# warning: "warning: manifest_maker: standard file '-c' not found".
_SETUPTOOLS_SHIM = (
    "import sys, setuptools, tokenize; sys.argv[0] = {0!r}; __file__={0!r};"
    "f=getattr(tokenize, 'open', open)(__file__);"
    "code=f.read().replace('\\r\\n', '\\n');"
    "f.close();"
    "exec(compile(code, __file__, 'exec'))"
)


def make_setuptools_shim_args(
        setup_py_path,  # type: str
        global_options=None,  # type: Sequence[str]
        no_user_config=False,  # type: bool
        unbuffered_output=False  # type: bool
):
    # type: (...) -> List[str]
    """
    Get setuptools command arguments with shim wrapped setup file invocation.

    :param setup_py_path: The path to setup.py to be wrapped.
    :param global_options: Additional global options.
    :param no_user_config: If True, disables personal user configuration.
    :param unbuffered_output: If True, adds the unbuffered switch to the
     argument list.
    """
    args = [sys.executable]
    if unbuffered_output:
        args.append('-u')
    args.extend(['-c', _SETUPTOOLS_SHIM.format(setup_py_path)])
    if global_options:
        args.extend(global_options)
    if no_user_config:
        args.append('--no-user-cfg')
    return args
site-packages/pip/_internal/utils/packaging.py000064400000005733151446176770015517 0ustar00from __future__ import absolute_import

import logging
from email.parser import FeedParser

from pip._vendor import pkg_resources
from pip._vendor.packaging import specifiers, version

from pip._internal.exceptions import NoneMetadataError
from pip._internal.utils.misc import display_path
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional, Tuple
    from email.message import Message
    from pip._vendor.pkg_resources import Distribution


logger = logging.getLogger(__name__)


def check_requires_python(requires_python, version_info):
    # type: (Optional[str], Tuple[int, ...]) -> bool
    """
    Check if the given Python version matches a "Requires-Python" specifier.

    :param version_info: A 3-tuple of ints representing a Python
        major-minor-micro version to check (e.g. `sys.version_info[:3]`).

    :return: `True` if the given Python version satisfies the requirement.
        Otherwise, return `False`.

    :raises InvalidSpecifier: If `requires_python` has an invalid format.
    """
    if requires_python is None:
        # The package provides no information
        return True
    requires_python_specifier = specifiers.SpecifierSet(requires_python)

    python_version = version.parse('.'.join(map(str, version_info)))
    return python_version in requires_python_specifier


def get_metadata(dist):
    # type: (Distribution) -> Message
    """
    :raises NoneMetadataError: if the distribution reports `has_metadata()`
        True but `get_metadata()` returns None.
    """
    metadata_name = 'METADATA'
    if (isinstance(dist, pkg_resources.DistInfoDistribution) and
            dist.has_metadata(metadata_name)):
        metadata = dist.get_metadata(metadata_name)
    elif dist.has_metadata('PKG-INFO'):
        metadata_name = 'PKG-INFO'
        metadata = dist.get_metadata(metadata_name)
    else:
        logger.warning("No metadata found in %s", display_path(dist.location))
        metadata = ''

    if metadata is None:
        raise NoneMetadataError(dist, metadata_name)

    feed_parser = FeedParser()
    # The following line errors out if with a "NoneType" TypeError if
    # passed metadata=None.
    feed_parser.feed(metadata)
    return feed_parser.close()


def get_requires_python(dist):
    # type: (pkg_resources.Distribution) -> Optional[str]
    """
    Return the "Requires-Python" metadata for a distribution, or None
    if not present.
    """
    pkg_info_dict = get_metadata(dist)
    requires_python = pkg_info_dict.get('Requires-Python')

    if requires_python is not None:
        # Convert to a str to satisfy the type checker, since requires_python
        # can be a Header object.
        requires_python = str(requires_python)

    return requires_python


def get_installer(dist):
    # type: (Distribution) -> str
    if dist.has_metadata('INSTALLER'):
        for line in dist.get_metadata_lines('INSTALLER'):
            if line.strip():
                return line.strip()
    return ''
site-packages/pip/_internal/utils/marker_files.py000064400000001467151446176770016236 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import os.path

DELETE_MARKER_MESSAGE = '''\
This file is placed here by pip to indicate the source was put
here by pip.

Once this package is successfully installed this source code will be
deleted (unless you remove this file).
'''
PIP_DELETE_MARKER_FILENAME = 'pip-delete-this-directory.txt'


def has_delete_marker_file(directory):
    return os.path.exists(os.path.join(directory, PIP_DELETE_MARKER_FILENAME))


def write_delete_marker_file(directory):
    # type: (str) -> None
    """
    Write the pip delete marker file into this directory.
    """
    filepath = os.path.join(directory, PIP_DELETE_MARKER_FILENAME)
    with open(filepath, 'w') as marker_fp:
        marker_fp.write(DELETE_MARKER_MESSAGE)
site-packages/pip/_internal/utils/glibc.py000064400000010455151446176770014650 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

from __future__ import absolute_import

import os
import re
import warnings

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional, Tuple


def glibc_version_string():
    # type: () -> Optional[str]
    "Returns glibc version string, or None if not using glibc."
    return glibc_version_string_confstr() or glibc_version_string_ctypes()


def glibc_version_string_confstr():
    # type: () -> Optional[str]
    "Primary implementation of glibc_version_string using os.confstr."
    # os.confstr is quite a bit faster than ctypes.DLL. It's also less likely
    # to be broken or missing. This strategy is used in the standard library
    # platform module:
    # https://github.com/python/cpython/blob/fcf1d003bf4f0100c9d0921ff3d70e1127ca1b71/Lib/platform.py#L175-L183
    try:
        # os.confstr("CS_GNU_LIBC_VERSION") returns a string like "glibc 2.17":
        _, version = os.confstr("CS_GNU_LIBC_VERSION").split()
    except (AttributeError, OSError, ValueError):
        # os.confstr() or CS_GNU_LIBC_VERSION not available (or a bad value)...
        return None
    return version


def glibc_version_string_ctypes():
    # type: () -> Optional[str]
    "Fallback implementation of glibc_version_string using ctypes."

    try:
        import ctypes
    except ImportError:
        return None

    # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen
    # manpage says, "If filename is NULL, then the returned handle is for the
    # main program". This way we can let the linker do the work to figure out
    # which libc our process is actually using.
    process_namespace = ctypes.CDLL(None)
    try:
        gnu_get_libc_version = process_namespace.gnu_get_libc_version
    except AttributeError:
        # Symbol doesn't exist -> therefore, we are not linked to
        # glibc.
        return None

    # Call gnu_get_libc_version, which returns a string like "2.5"
    gnu_get_libc_version.restype = ctypes.c_char_p
    version_str = gnu_get_libc_version()
    # py2 / py3 compatibility:
    if not isinstance(version_str, str):
        version_str = version_str.decode("ascii")

    return version_str


# Separated out from have_compatible_glibc for easier unit testing
def check_glibc_version(version_str, required_major, minimum_minor):
    # type: (str, int, int) -> bool
    # Parse string and check against requested version.
    #
    # We use a regexp instead of str.split because we want to discard any
    # random junk that might come after the minor version -- this might happen
    # in patched/forked versions of glibc (e.g. Linaro's version of glibc
    # uses version strings like "2.20-2014.11"). See gh-3588.
    m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str)
    if not m:
        warnings.warn("Expected glibc version with 2 components major.minor,"
                      " got: %s" % version_str, RuntimeWarning)
        return False
    return (int(m.group("major")) == required_major and
            int(m.group("minor")) >= minimum_minor)


def have_compatible_glibc(required_major, minimum_minor):
    # type: (int, int) -> bool
    version_str = glibc_version_string()
    if version_str is None:
        return False
    return check_glibc_version(version_str, required_major, minimum_minor)


# platform.libc_ver regularly returns completely nonsensical glibc
# versions. E.g. on my computer, platform says:
#
#   ~$ python2.7 -c 'import platform; print(platform.libc_ver())'
#   ('glibc', '2.7')
#   ~$ python3.5 -c 'import platform; print(platform.libc_ver())'
#   ('glibc', '2.9')
#
# But the truth is:
#
#   ~$ ldd --version
#   ldd (Debian GLIBC 2.22-11) 2.22
#
# This is unfortunate, because it means that the linehaul data on libc
# versions that was generated by pip 8.1.2 and earlier is useless and
# misleading. Solution: instead of using platform, use our code that actually
# works.
def libc_ver():
    # type: () -> Tuple[str, str]
    """Try to determine the glibc version

    Returns a tuple of strings (lib, version) which default to empty strings
    in case the lookup fails.
    """
    glibc_version = glibc_version_string()
    if glibc_version is None:
        return ("", "")
    else:
        return ("glibc", glibc_version)
site-packages/pip/_internal/utils/virtualenv.py000064400000001573151446176770015770 0ustar00import os.path
import site
import sys


def running_under_virtualenv():
    # type: () -> bool
    """
    Return True if we're running inside a virtualenv, False otherwise.

    """
    if hasattr(sys, 'real_prefix'):
        # pypa/virtualenv case
        return True
    elif sys.prefix != getattr(sys, "base_prefix", sys.prefix):
        # PEP 405 venv
        return True

    return False


def virtualenv_no_global():
    # type: () -> bool
    """
    Return True if in a venv and no system site packages.
    """
    # this mirrors the logic in virtualenv.py for locating the
    # no-global-site-packages.txt file
    site_mod_dir = os.path.dirname(os.path.abspath(site.__file__))
    no_global_file = os.path.join(site_mod_dir, 'no-global-site-packages.txt')
    if running_under_virtualenv() and os.path.isfile(no_global_file):
        return True
    else:
        return False
site-packages/pip/_internal/utils/typing.py000064400000002145151446176770015077 0ustar00"""For neatly implementing static typing in pip.

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

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

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

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

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

    from pip._internal.utils.typing import MYPY_CHECK_RUNNING

    if MYPY_CHECK_RUNNING:
        from typing import ...

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

MYPY_CHECK_RUNNING = False
site-packages/pip/_internal/utils/compat.py000064400000022535151446176770015055 0ustar00"""Stuff that differs in different Python versions and platform
distributions."""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import, division

import codecs
import locale
import logging
import os
import shutil
import sys

from pip._vendor.six import PY2, text_type
from pip._vendor.urllib3.util import IS_PYOPENSSL

from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional, Text, Tuple, Union

try:
    import _ssl  # noqa
except ImportError:
    ssl = None
else:
    # This additional assignment was needed to prevent a mypy error.
    ssl = _ssl

try:
    import ipaddress
except ImportError:
    try:
        from pip._vendor import ipaddress  # type: ignore
    except ImportError:
        import ipaddr as ipaddress  # type: ignore
        ipaddress.ip_address = ipaddress.IPAddress  # type: ignore
        ipaddress.ip_network = ipaddress.IPNetwork  # type: ignore


__all__ = [
    "ipaddress", "uses_pycache", "console_to_str", "native_str",
    "get_path_uid", "stdlib_pkgs", "WINDOWS", "samefile", "get_terminal_size",
    "get_extension_suffixes",
]


logger = logging.getLogger(__name__)

HAS_TLS = (ssl is not None) or IS_PYOPENSSL

if PY2:
    import imp

    try:
        cache_from_source = imp.cache_from_source  # type: ignore
    except AttributeError:
        # does not use __pycache__
        cache_from_source = None

    uses_pycache = cache_from_source is not None
else:
    uses_pycache = True
    from importlib.util import cache_from_source


if PY2:
    # In Python 2.7, backslashreplace exists
    # but does not support use for decoding.
    # We implement our own replace handler for this
    # situation, so that we can consistently use
    # backslash replacement for all versions.
    def backslashreplace_decode_fn(err):
        raw_bytes = (err.object[i] for i in range(err.start, err.end))
        # Python 2 gave us characters - convert to numeric bytes
        raw_bytes = (ord(b) for b in raw_bytes)
        return u"".join(u"\\x%x" % c for c in raw_bytes), err.end
    codecs.register_error(
        "backslashreplace_decode",
        backslashreplace_decode_fn,
    )
    backslashreplace_decode = "backslashreplace_decode"
else:
    backslashreplace_decode = "backslashreplace"


def str_to_display(data, desc=None):
    # type: (Union[bytes, Text], Optional[str]) -> Text
    """
    For display or logging purposes, convert a bytes object (or text) to
    text (e.g. unicode in Python 2) safe for output.

    :param desc: An optional phrase describing the input data, for use in
        the log message if a warning is logged. Defaults to "Bytes object".

    This function should never error out and so can take a best effort
    approach. It is okay to be lossy if needed since the return value is
    just for display.

    We assume the data is in the locale preferred encoding. If it won't
    decode properly, we warn the user but decode as best we can.

    We also ensure that the output can be safely written to standard output
    without encoding errors.
    """
    if isinstance(data, text_type):
        return data

    # Otherwise, data is a bytes object (str in Python 2).
    # First, get the encoding we assume. This is the preferred
    # encoding for the locale, unless that is not found, or
    # it is ASCII, in which case assume UTF-8
    encoding = locale.getpreferredencoding()
    if (not encoding) or codecs.lookup(encoding).name == "ascii":
        encoding = "utf-8"

    # Now try to decode the data - if we fail, warn the user and
    # decode with replacement.
    try:
        decoded_data = data.decode(encoding)
    except UnicodeDecodeError:
        if desc is None:
            desc = 'Bytes object'
        msg_format = '{} does not appear to be encoded as %s'.format(desc)
        logger.warning(msg_format, encoding)
        decoded_data = data.decode(encoding, errors=backslashreplace_decode)

    # Make sure we can print the output, by encoding it to the output
    # encoding with replacement of unencodable characters, and then
    # decoding again.
    # We use stderr's encoding because it's less likely to be
    # redirected and if we don't find an encoding we skip this
    # step (on the assumption that output is wrapped by something
    # that won't fail).
    # The double getattr is to deal with the possibility that we're
    # being called in a situation where sys.__stderr__ doesn't exist,
    # or doesn't have an encoding attribute. Neither of these cases
    # should occur in normal pip use, but there's no harm in checking
    # in case people use pip in (unsupported) unusual situations.
    output_encoding = getattr(getattr(sys, "__stderr__", None),
                              "encoding", None)

    if output_encoding:
        output_encoded = decoded_data.encode(
            output_encoding,
            errors="backslashreplace"
        )
        decoded_data = output_encoded.decode(output_encoding)

    return decoded_data


def console_to_str(data):
    # type: (bytes) -> Text
    """Return a string, safe for output, of subprocess output.
    """
    return str_to_display(data, desc='Subprocess output')


if PY2:
    def native_str(s, replace=False):
        # type: (str, bool) -> str
        # Replace is ignored -- unicode to UTF-8 can't fail
        if isinstance(s, text_type):
            return s.encode('utf-8')
        return s

else:
    def native_str(s, replace=False):
        # type: (str, bool) -> str
        if isinstance(s, bytes):
            return s.decode('utf-8', 'replace' if replace else 'strict')
        return s


def get_path_uid(path):
    # type: (str) -> int
    """
    Return path's uid.

    Does not follow symlinks:
        https://github.com/pypa/pip/pull/935#discussion_r5307003

    Placed this function in compat due to differences on AIX and
    Jython, that should eventually go away.

    :raises OSError: When path is a symlink or can't be read.
    """
    if hasattr(os, 'O_NOFOLLOW'):
        fd = os.open(path, os.O_RDONLY | os.O_NOFOLLOW)
        file_uid = os.fstat(fd).st_uid
        os.close(fd)
    else:  # AIX and Jython
        # WARNING: time of check vulnerability, but best we can do w/o NOFOLLOW
        if not os.path.islink(path):
            # older versions of Jython don't have `os.fstat`
            file_uid = os.stat(path).st_uid
        else:
            # raise OSError for parity with os.O_NOFOLLOW above
            raise OSError(
                "%s is a symlink; Will not return uid for symlinks" % path
            )
    return file_uid


if PY2:
    from imp import get_suffixes

    def get_extension_suffixes():
        return [suffix[0] for suffix in get_suffixes()]

else:
    from importlib.machinery import EXTENSION_SUFFIXES

    def get_extension_suffixes():
        return EXTENSION_SUFFIXES


def expanduser(path):
    # type: (str) -> str
    """
    Expand ~ and ~user constructions.

    Includes a workaround for https://bugs.python.org/issue14768
    """
    expanded = os.path.expanduser(path)
    if path.startswith('~/') and expanded.startswith('//'):
        expanded = expanded[1:]
    return expanded


# packages in the stdlib that may have installation metadata, but should not be
# considered 'installed'.  this theoretically could be determined based on
# dist.location (py27:`sysconfig.get_paths()['stdlib']`,
# py26:sysconfig.get_config_vars('LIBDEST')), but fear platform variation may
# make this ineffective, so hard-coding
stdlib_pkgs = {"python", "wsgiref", "argparse"}


# windows detection, covers cpython and ironpython
WINDOWS = (sys.platform.startswith("win") or
           (sys.platform == 'cli' and os.name == 'nt'))


def samefile(file1, file2):
    # type: (str, str) -> bool
    """Provide an alternative for os.path.samefile on Windows/Python2"""
    if hasattr(os.path, 'samefile'):
        return os.path.samefile(file1, file2)
    else:
        path1 = os.path.normcase(os.path.abspath(file1))
        path2 = os.path.normcase(os.path.abspath(file2))
        return path1 == path2


if hasattr(shutil, 'get_terminal_size'):
    def get_terminal_size():
        # type: () -> Tuple[int, int]
        """
        Returns a tuple (x, y) representing the width(x) and the height(y)
        in characters of the terminal window.
        """
        return tuple(shutil.get_terminal_size())  # type: ignore
else:
    def get_terminal_size():
        # type: () -> Tuple[int, int]
        """
        Returns a tuple (x, y) representing the width(x) and the height(y)
        in characters of the terminal window.
        """
        def ioctl_GWINSZ(fd):
            try:
                import fcntl
                import termios
                import struct
                cr = struct.unpack_from(
                    'hh',
                    fcntl.ioctl(fd, termios.TIOCGWINSZ, '12345678')
                )
            except Exception:
                return None
            if cr == (0, 0):
                return None
            return cr
        cr = ioctl_GWINSZ(0) or ioctl_GWINSZ(1) or ioctl_GWINSZ(2)
        if not cr:
            try:
                fd = os.open(os.ctermid(), os.O_RDONLY)
                cr = ioctl_GWINSZ(fd)
                os.close(fd)
            except Exception:
                pass
        if not cr:
            cr = (os.environ.get('LINES', 25), os.environ.get('COLUMNS', 80))
        return int(cr[1]), int(cr[0])
site-packages/pip/_internal/utils/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000233151446176770022545 0ustar00U

��.e�@sdS)N�rrr�@/usr/lib/python3.8/site-packages/pip/_internal/utils/__init__.py�<module>�site-packages/pip/_internal/utils/__pycache__/packaging.cpython-38.opt-1.pyc000064400000005060151446176770022735 0ustar00U

��.e��@s�ddlmZddlZddlmZddlmZddlmZm	Z	ddl
mZddlm
Z
ddlmZer�dd	lmZmZdd
lmZddlmZe�e�Zdd
�Zdd�Zdd�Zdd�ZdS)�)�absolute_importN)�
FeedParser)�
pkg_resources)�
specifiers�version)�NoneMetadataError)�display_path)�MYPY_CHECK_RUNNING)�Optional�Tuple)�Message)�DistributioncCs4|dkrdSt�|�}t�d�tt|���}||kS)a�
    Check if the given Python version matches a "Requires-Python" specifier.

    :param version_info: A 3-tuple of ints representing a Python
        major-minor-micro version to check (e.g. `sys.version_info[:3]`).

    :return: `True` if the given Python version satisfies the requirement.
        Otherwise, return `False`.

    :raises InvalidSpecifier: If `requires_python` has an invalid format.
    NT�.)rZSpecifierSetr�parse�join�map�str)�requires_python�version_infoZrequires_python_specifierZpython_version�r�A/usr/lib/python3.8/site-packages/pip/_internal/utils/packaging.py�check_requires_pythons


rcCs�d}t|tj�r&|�|�r&|�|�}n0|�d�r@d}|�|�}nt�dt|j��d}|dkrht	||��t
�}|�|�|��S)z�
    :raises NoneMetadataError: if the distribution reports `has_metadata()`
        True but `get_metadata()` returns None.
    ZMETADATAzPKG-INFOzNo metadata found in %s�N)
�
isinstancerZDistInfoDistribution�has_metadata�get_metadata�loggerZwarningr�locationrrZfeed�close)�distZ
metadata_nameZmetadataZfeed_parserrrrr,s�


rcCs&t|�}|�d�}|dk	r"t|�}|S)z_
    Return the "Requires-Python" metadata for a distribution, or None
    if not present.
    zRequires-PythonN)r�getr)rZ
pkg_info_dictrrrr�get_requires_pythonGs

r!cCs2|�d�r.|�d�D]}|��r|��SqdS)NZ	INSTALLERr)rZget_metadata_lines�strip)r�linerrr�
get_installerXs

r$)Z
__future__rZloggingZemail.parserrZpip._vendorrZpip._vendor.packagingrrZpip._internal.exceptionsrZpip._internal.utils.miscrZpip._internal.utils.typingr	�typingr
rZ
email.messagerZpip._vendor.pkg_resourcesr
Z	getLogger�__name__rrrr!r$rrrr�<module>s 
site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-38.opt-1.pyc000064400000011365151446176770022621 0ustar00U

��.e��@s�ddlmZddlZddlZddlZddlZddlZddlm	Z	ddl
mZer\ddlm
Z
e�e�ZGdd�de�ZGdd	�d	e�ZdS)
�)�absolute_importN)�rmtree)�MYPY_CHECK_RUNNING)�OptionalcsVeZdZdZd�fdd�	Zedd��Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Z�ZS)�
TempDirectoryaMHelper class that owns and cleans up a temporary directory.

    This class can be used as a context manager or as an OO representation of a
    temporary directory.

    Attributes:
        path
            Location to the created temporary directory
        delete
            Whether the directory should be deleted when exiting
            (when used as a contextmanager)

    Methods:
        cleanup()
            Deletes the temporary directory

    When used as a context manager, if the delete attribute is True, on
    exiting the context the temporary directory is deleted.
    N�tempcsPtt|���|dkr"|dkr"d}|dkr4|�|�}||_d|_||_||_dS)NTF)�superr�__init__�_create�_path�_deleted�delete�kind)�self�pathr
r��	__class__��@/usr/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.pyr	+s
zTempDirectory.__init__cCs|jS�N)r�rrrrr@szTempDirectory.pathcCsd�|jj|j�S)Nz	<{} {!r}>)�formatr�__name__rrrrr�__repr__HszTempDirectory.__repr__cCs|Srrrrrr�	__enter__KszTempDirectory.__enter__cCs|jr|��dSr)r
�cleanup)r�exc�value�tbrrr�__exit__NszTempDirectory.__exit__cCs.tj�tjd�|�d��}t�d�|��|S)zECreate a temporary directory and store its path in self.path
        �pip-{}-��prefix�Created temporary directory: {})�osr�realpath�tempfile�mkdtempr�logger�debug)rrrrrrr
Rs
�zTempDirectory._createcCs"d|_tj�|j�rt|j�dS)z?Remove the temporary directory created and reset state
        TN)rr$r�existsrrrrrrr_szTempDirectory.cleanup)NNr)
r�
__module__�__qualname__�__doc__r	�propertyrrrrr
r�
__classcell__rrrrrs�

rcs:eZdZdZdZd
�fdd�	Zedd��Zdd	�Z�Z	S)�AdjacentTempDirectorya�Helper class that creates a temporary directory adjacent to a real one.

    Attributes:
        original
            The original directory to create a temp directory for.
        path
            After calling create() or entering, contains the full
            path to the temporary directory.
        delete
            Whether the directory should be deleted when exiting
            (when used as a contextmanager)

    z-~.=%0123456789Ncs"|�d�|_tt|�j|d�dS)Nz/\)r
)�rstrip�originalrr0r	)rr2r
rrrr	|szAdjacentTempDirectory.__init__ccs�tdt|��D]D}t�|j|d�D],}dd�|�||d�}||kr$|Vq$qtt|j��D]8}t�|j|�D]$}dd�|�|}||krt|VqtqbdS)aGenerates a series of temporary names.

        The algorithm replaces the leading characters in the name
        with ones that are valid filesystem characters, but are not
        valid package names (for both Python and pip definitions of
        package).
        ��~�N)�range�len�	itertools�combinations_with_replacement�
LEADING_CHARS�join)�cls�name�i�	candidate�new_namerrr�_generate_names�s 	�
�z%AdjacentTempDirectory._generate_namescCs�tj�|j�\}}|�|�D]b}tj�||�}zt�|�Wn0tk
rl}z|jtj	kr\�W5d}~XYqXtj�
|�}q�qtj�
tjd�
|�d��}t�d�
|��|S)Nr r!r#)r$r�splitr2rAr;�mkdir�OSError�errnoZEEXISTr%r&r'rr(r))rr�rootr=r?rZexrrrr
�s�zAdjacentTempDirectory._create)N)
rr+r,r-r:r	�classmethodrAr
r/rrrrr0gs
r0)Z
__future__rrEr8ZloggingZos.pathr$r&Zpip._internal.utils.miscrZpip._internal.utils.typingr�typingrZ	getLoggerrr(�objectrr0rrrr�<module>s
Qsite-packages/pip/_internal/utils/__pycache__/filetypes.cpython-38.opt-1.pyc000064400000001054151446176770023014 0ustar00U

��.e;�@sLdZddlmZer ddlmZdZdZdZdefZdZ	eee	eZ
d	S)
zFiletype information.
�)�MYPY_CHECK_RUNNING)�Tuplez.whl)z.tar.bz2z.tbz)z.tar.xzz.txzz.tlzz.tar.lzz	.tar.lzmaz.zip)z.tar.gzz.tgzz.tarN)�__doc__Zpip._internal.utils.typingr�typingrZWHEEL_EXTENSIONZBZ2_EXTENSIONSZ
XZ_EXTENSIONSZZIP_EXTENSIONSZTAR_EXTENSIONSZARCHIVE_EXTENSIONS�rr�A/usr/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py�<module>s�site-packages/pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.pyc000064400000001644151446176770024655 0ustar00U

��.e*�@sdZddlZdd�Ze�dS)a-A helper module that injects SecureTransport, on import.

The import should be done as early as possible, to ensure all requests and
sessions (or whatever) are created after injecting SecureTransport.

Note that we only do the injection on macOS, when the linked OpenSSL is too
old to handle TLSv1.2.
�Nc	CsxtjdkrdSzddl}Wntk
r0YdSX|jdkr@dSzddlm}Wnttfk
rjYdSX|��dS)N�darwinri)�securetransport)	�sys�platform�ssl�ImportErrorZOPENSSL_VERSION_NUMBERZpip._vendor.urllib3.contribr�OSErrorZinject_into_urllib3)rr�r	�N/usr/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py�inject_securetransport
s

r)�__doc__rrr	r	r	r
�<module>s	site-packages/pip/_internal/utils/__pycache__/hashes.cpython-38.opt-1.pyc000064400000010060151446176770022260 0ustar00U

��.e��@s�ddlmZddlZddlmZmZmZddlmZm	Z	m
Z
ddlmZddl
mZer�ddlmZmZmZmZmZddlmZer�dd	lmZndd
lmZdZddd
gZGdd�de�ZGdd�de�ZdS)�)�absolute_importN)�	iteritems�iterkeys�
itervalues)�HashMismatch�HashMissing�InstallationError)�read_chunks)�MYPY_CHECK_RUNNING)�Dict�List�BinaryIO�NoReturn�Iterator)�PY3)�_Hash)�_hashZsha256Zsha384Zsha512c@s^eZdZdZddd�Zedd��Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
dS)�HasheszaA wrapper that builds multiple hashes at once and checks them against
    known-good values

    NcCs|dkrin||_dS)zo
        :param hashes: A dict of algorithm names pointing to lists of allowed
            hex digests
        N)�_allowed)�self�hashes�r�>/usr/lib/python3.8/site-packages/pip/_internal/utils/hashes.py�__init__,szHashes.__init__cCstdd�|j��D��S)Ncss|]}t|�VqdS�N)�len)�.0Zdigestsrrr�	<genexpr>7sz&Hashes.digest_count.<locals>.<genexpr>)�sumr�values�rrrr�digest_count4szHashes.digest_countcCs||j�|g�kS)z/Return whether the given hex digest is allowed.)r�get)r�	hash_nameZ
hex_digestrrr�is_hash_allowed9szHashes.is_hash_allowedc
Cs�i}t|j�D]<}zt�|�||<Wqttfk
rHtd|��YqXq|D]}t|�D]}|�|�q\qPt	|�D] \}}|�
�|j|krvdSqv|�|�dS)z�Check good hashes against ones built from iterable of chunks of
        data.

        Raise HashMismatch if none match.

        zUnknown hash name: %sN)rr�hashlib�new�
ValueError�	TypeErrorrr�updater�	hexdigest�_raise)rZchunks�gotsr#�chunk�hashZgotrrr�check_against_chunksAszHashes.check_against_chunkscCst|j|��dSr)rr�rr,rrrr+Ysz
Hashes._raisecCs|�t|��S)zaCheck good hashes against a file-like object

        Raise HashMismatch if none match.

        )r/r	)r�filerrr�check_against_file]szHashes.check_against_filec
Cs,t|d��}|�|�W5QR�SQRXdS)N�rb)�openr2)r�pathr1rrr�check_against_pathfszHashes.check_against_pathcCs
t|j�S)z,Return whether I know any known-good hashes.)�boolrr rrr�__nonzero__kszHashes.__nonzero__cCs|��Sr)r8r rrr�__bool__pszHashes.__bool__)N)�__name__�
__module__�__qualname__�__doc__r�propertyr!r$r/r+r2r6r8r9rrrrr's

	rcs(eZdZdZ�fdd�Zdd�Z�ZS)�
MissingHashesz�A workalike for Hashes used when we're missing a hash for a requirement

    It computes the actual hash of the requirement and raises a HashMissing
    exception showing it to the user.

    cstt|�jtgid�dS)z!Don't offer the ``hashes`` kwarg.)rN)�superr?r�
FAVORITE_HASHr ��	__class__rrr|szMissingHashes.__init__cCst|t����dSr)rrAr*r0rrrr+�szMissingHashes._raise)r:r;r<r=rr+�
__classcell__rrrBrr?usr?)Z
__future__rr%Zpip._vendor.sixrrrZpip._internal.exceptionsrrrZpip._internal.utils.miscr	Zpip._internal.utils.typingr
�typingrrr
rrrrrrAZ
STRONG_HASHES�objectrr?rrrr�<module>s
Nsite-packages/pip/_internal/utils/__pycache__/compat.cpython-38.pyc000064400000015267151446176770021347 0ustar00U

��.e]%�@s~dZddlmZmZddlZddlZddlZddlZddlZddl	Z	ddl
mZmZddl
mZddlmZer�ddlmZmZmZmZzddlZWnek
r�dZYnXeZzddlZWnVek
�rzddlmZWn.ek
�rddlZeje_eje_YnXYnXd	d
ddd
dddddg
Z e�!e"�Z#edk	�pDeZ$e�r�ddl%Z%z
e%j&Z&Wne'k
�rxdZ&YnXe&dk	Z(ndZ(ddl)m&Z&e�r�dd�Z*e�+de*�dZ,ndZ,d/dd�Z-dd�Z.e�r�d0dd�Z/n
d1dd�Z/dd
�Z0e�r
dd l%m1Z1d!d�Z2ndd"l3m4Z4d#d�Z2d$d%�Z5d&d'd(hZ6e	j7�8d)��pRe	j7d*k�oRej9d+kZ:d,d�Z;e<ed��rrd-d�Z=nd.d�Z=dS)2zKStuff that differs in different Python versions and platform
distributions.�)�absolute_import�divisionN)�PY2�	text_type)�IS_PYOPENSSL)�MYPY_CHECK_RUNNING)�Optional�Text�Tuple�Union)�	ipaddressr�uses_pycache�console_to_str�
native_str�get_path_uid�stdlib_pkgs�WINDOWS�samefile�get_terminal_size�get_extension_suffixesT)�cache_from_sourcecsD�fdd�t�j�j�D�}dd�|D�}d�dd�|D���jfS)Nc3s|]}�j|VqdS�N)�object)�.0�i��err��>/usr/lib/python3.8/site-packages/pip/_internal/utils/compat.py�	<genexpr>Lsz-backslashreplace_decode_fn.<locals>.<genexpr>css|]}t|�VqdSr)�ord)r�brrrrNs�css|]}d|VqdS)z\x%xNr)r�crrrrOs)�range�start�end�join)rZ	raw_bytesrrr�backslashreplace_decode_fnKsr(�backslashreplace_decode�backslashreplacecCs�t|t�r|St��}|r*t�|�jdkr.d}z|�|�}WnDtk
r�|dkrXd}d�	|�}t
�||�|j|td�}YnXt
t
tdd�dd�}|r�|j|d	d�}|�|�}|S)
a�
    For display or logging purposes, convert a bytes object (or text) to
    text (e.g. unicode in Python 2) safe for output.

    :param desc: An optional phrase describing the input data, for use in
        the log message if a warning is logged. Defaults to "Bytes object".

    This function should never error out and so can take a best effort
    approach. It is okay to be lossy if needed since the return value is
    just for display.

    We assume the data is in the locale preferred encoding. If it won't
    decode properly, we warn the user but decode as best we can.

    We also ensure that the output can be safely written to standard output
    without encoding errors.
    �ascii�utf-8NzBytes objectz&{} does not appear to be encoded as %s)�errors�
__stderr__�encodingr*)�
isinstancer�localeZgetpreferredencoding�codecs�lookup�name�decode�UnicodeDecodeError�format�loggerZwarningr)�getattr�sys�encode)�data�descr/Zdecoded_dataZ
msg_formatZoutput_encodingZoutput_encodedrrr�str_to_displayYs0

��
r>cCst|dd�S)z<Return a string, safe for output, of subprocess output.
    zSubprocess output)r=)r>)r<rrrr�sFcCst|t�r|�d�S|S)Nr,)r0rr;��s�replacerrrr�s

cCs"t|t�r|�d|rdnd�S|S)Nr,rA�strict)r0�bytesr5r?rrrr�s
cCs`ttd�r6t�|tjtjB�}t�|�j}t�|�n&tj�	|�sPt�
|�j}ntd|��|S)a)
    Return path's uid.

    Does not follow symlinks:
        https://github.com/pypa/pip/pull/935#discussion_r5307003

    Placed this function in compat due to differences on AIX and
    Jython, that should eventually go away.

    :raises OSError: When path is a symlink or can't be read.
    �
O_NOFOLLOWz1%s is a symlink; Will not return uid for symlinks)�hasattr�os�open�O_RDONLYrD�fstat�st_uid�close�path�islink�stat�OSError)rL�fdZfile_uidrrrr�s
���get_suffixescCsdd�t�D�S)NcSsg|]}|d�qS)rr)r�suffixrrr�
<listcomp>�sz*get_extension_suffixes.<locals>.<listcomp>rQrrrrr�s��EXTENSION_SUFFIXEScCstSrrUrrrrr�scCs0tj�|�}|�d�r,|�d�r,|dd�}|S)zm
    Expand ~ and ~user constructions.

    Includes a workaround for https://bugs.python.org/issue14768
    z~/z//�N)rFrL�
expanduser�
startswith)rLZexpandedrrrrX�srX�pythonZwsgiref�argparse�winZcli�ntcCsNttjd�rtj�||�Stj�tj�|��}tj�tj�|��}||kSdS)z>Provide an alternative for os.path.samefile on Windows/Python2rN)rErFrLr�normcase�abspath)Zfile1Zfile2Zpath1Zpath2rrrr�s
cCstt���S)��
        Returns a tuple (x, y) representing the width(x) and the height(y)
        in characters of the terminal window.
        )�tuple�shutilrrrrrrscCs�dd�}|d�p|d�p|d�}|sbz(t�t��tj�}||�}t�|�Wntk
r`YnX|s�tj�dd�tj�dd	�f}t|d�t|d�fS)
r`cSs\z4ddl}ddl}ddl}|�d|�||jd��}Wntk
rJYdSX|dkrXdS|S)NrZhhZ12345678)rr)�fcntl�termios�struct�unpack_fromZioctlZ
TIOCGWINSZ�	Exception)rPrcrdre�crrrr�ioctl_GWINSZs�z'get_terminal_size.<locals>.ioctl_GWINSZrrW�ZLINES�ZCOLUMNS�P)	rFrG�ctermidrHrKrg�environ�get�int)rirhrPrrrrs)N)F)F)>�__doc__Z
__future__rrr2r1ZloggingrFrbr:Zpip._vendor.sixrrZpip._vendor.urllib3.utilrZpip._internal.utils.typingr�typingrr	r
rZ_ssl�ImportErrorZsslrZpip._vendorZipaddrZ	IPAddressZ
ip_addressZ	IPNetworkZ
ip_network�__all__Z	getLogger�__name__r8ZHAS_TLSZimpr�AttributeErrorr
�importlib.utilr(�register_errorr)r>rrrrRrZimportlib.machineryrVrXr�platformrYr4rrrErrrrr�<module>s�
�



�
B


�
site-packages/pip/_internal/utils/__pycache__/models.cpython-38.pyc000064400000003604151446176770021337 0ustar00U

��.e|�@s dZddlZGdd�de�ZdS)zUtilities for defining models
�Nc@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)�KeyBasedCompareMixinz<Provides comparison capabilities that is based on a key
    cCs||_||_dS�N)�_compare_key�_defining_class)�self�keyZdefining_class�r�>/usr/lib/python3.8/site-packages/pip/_internal/utils/models.py�__init__
szKeyBasedCompareMixin.__init__cCs
t|j�Sr)�hashr)rrrr	�__hash__szKeyBasedCompareMixin.__hash__cCs|�|tj�Sr)�_compare�operator�__lt__�r�otherrrr	rszKeyBasedCompareMixin.__lt__cCs|�|tj�Sr)r
r�__le__rrrr	rszKeyBasedCompareMixin.__le__cCs|�|tj�Sr)r
r�__gt__rrrr	rszKeyBasedCompareMixin.__gt__cCs|�|tj�Sr)r
r�__ge__rrrr	rszKeyBasedCompareMixin.__ge__cCs|�|tj�Sr)r
r�__eq__rrrr	r szKeyBasedCompareMixin.__eq__cCs|�|tj�Sr)r
r�__ne__rrrr	r#szKeyBasedCompareMixin.__ne__cCst||j�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr�methodrrr	r
&szKeyBasedCompareMixin._compareN)
�__name__�
__module__�__qualname__�__doc__r
rrrrrrrr
rrrr	r	sr)rr�objectrrrrr	�<module>ssite-packages/pip/_internal/utils/__pycache__/appdirs.cpython-38.opt-1.pyc000064400000017553151446176770022465 0ustar00U

��.e&&�@s�dZddlmZddlZddlZddlmZmZddlm	Z	m
Z
ddlmZer\ddl
mZdd	�Zddd�Zddd�Zdd�Zdd�Zdd�Ze	r�zddlZeZWnek
r�eZYnXdd�ZdS)zd
This code was taken from https://github.com/ActiveState/appdirs and modified
to suit our purposes.
�)�absolute_importN)�PY2�	text_type)�WINDOWS�
expanduser)�MYPY_CHECK_RUNNING)�ListcCs�tr<tj�td��}tr*t|t�r*t|�}tj�	||d�}n@t
jdkr^td�}tj�	||�}nt�
dtd��}tj�	||�}|S)a5
    Return full path to the user-specific cache dir for this application.

        "appname" is the name of application.

    Typical user cache directories are:
        macOS:      ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Windows:    C:\Users\<username>\AppData\Local\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go
    in the `CSIDL_LOCAL_APPDATA` directory. This is identical to the
    non-roaming app data dir (the default returned by `user_data_dir`). Apps
    typically put cache data somewhere *under* the given dir here. Some
    examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0

    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    �CSIDL_LOCAL_APPDATAZCache�darwinz~/Library/CachesZXDG_CACHE_HOMEz~/.cache)r�os�path�normpath�_get_win_folderr�
isinstancer�_win_path_to_bytes�join�sys�platformr�getenv)�appnamer�r�?/usr/lib/python3.8/site-packages/pip/_internal/utils/appdirs.py�user_cache_dirs
rFcCs�tr,|rdpd}tj�tj�t|��|�}ndtjdkrvtj�tj�t	d�|��rbtj�t	d�|�ntj�t	d�|�}ntj�t�
dt	d��|�}|S)a�
    Return full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  ~/Library/Application Support/<AppName>
                                if it exists, else ~/.config/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in
                                $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\ ...
                                ...Application Data\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local ...
                                ...Settings\Application Data\<AppName>
        Win 7  (not roaming):   C:\\Users\<username>\AppData\Local\<AppName>
        Win 7  (roaming):       C:\\Users\<username>\AppData\Roaming\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    �
CSIDL_APPDATAr	r
z~/Library/Application Support/z
~/.config/Z
XDG_DATA_HOMEz~/.local/share)rrrrr
rrr�isdirrr)r�roaming�constrrrr�
user_data_dirHs,
������rTcCsHtrt||d�}n2tjdkr&t|�}nt�dtd��}tj�||�}|S)arReturn full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default True) can be set False to not use the
            Windows roaming appdata directory. That means that for users on a
            Windows network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  same as user_data_dir
        Unix:                   ~/.config/<AppName>
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    )rr
ZXDG_CONFIG_HOMEz	~/.config)	rrrrrrrrr)rrrrrr�user_config_dir}s

rcs�tr&tj�td��}tj�|��g}nVtjdkrBtj�d��g}n:t�dd�}|rn�fdd�|�	tj
�D�}ng}|�d�|S)	a�Return a list of potential user-shared config dirs for this application.

        "appname" is the name of application.

    Typical user config directories are:
        macOS:      /Library/Application Support/<AppName>/
        Unix:       /etc or $XDG_CONFIG_DIRS[i]/<AppName>/ for each value in
                    $XDG_CONFIG_DIRS
        Win XP:     C:\Documents and Settings\All Users\Application ...
                    ...Data\<AppName>\
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory
                    on Vista.)
        Win 7:      Hidden, but writeable on Win 7:
                    C:\ProgramData\<AppName>\
    �CSIDL_COMMON_APPDATAr
z/Library/Application SupportZXDG_CONFIG_DIRSz/etc/xdgcsg|]}tj�t|����qSr)rrrr)�.0�x�rrr�
<listcomp>�s�z$site_config_dirs.<locals>.<listcomp>z/etc)rrrr
rrrrr�split�pathsep�append)rrZpathlistZxdg_config_dirsrr"r�site_config_dirs�s


�
r'cCs:ddl}dddd�|}|�|jd�}|�||�\}}|S)z�
    This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    rNZAppDatazCommon AppDataz
Local AppData�rrr	z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)�_winreg�OpenKey�HKEY_CURRENT_USERZQueryValueEx)�
csidl_namer)Zshell_folder_name�keyZ	directoryZ_typerrr�_get_win_folder_from_registry�s���r.cCs�dddd�|}t�d�}tj}|j�d|dd|�d}|D]}t|�dkr<d	}qVq<|rzt�d�}|j�|j|d�rz|}|jS)
N��#�r(irF�T)	�ctypesZcreate_unicode_buffer�windllZshell32ZSHGetFolderPathW�ordZkernel32ZGetShortPathNameW�value)r,Zcsidl_constZbufr4Z
has_high_char�cZbuf2rrr�_get_win_folder_with_ctypes�s&��

r8c
Cs8dD].}z|�|�WSttfk
r0YqXq|S)a�Encode Windows paths to bytes. Only used on Python 2.

    Motivation is to be consistent with other operating systems where paths
    are also returned as bytes. This avoids problems mixing bytes and Unicode
    elsewhere in the codebase. For more details and discussion see
    <https://github.com/pypa/pip/issues/3463>.

    If encoding using ASCII and MBCS fails, return the original Unicode path.
    )�ASCIIZMBCS)�encode�UnicodeEncodeError�LookupError)r�encodingrrrrs
r)F)T)�__doc__Z
__future__rrrZpip._vendor.sixrrZpip._internal.utils.compatrrZpip._internal.utils.typingr�typingrrrrr'r.r8r3r�ImportErrorrrrrr�<module>s*1
5
")
site-packages/pip/_internal/utils/__pycache__/subprocess.cpython-38.opt-1.pyc000064400000012736151446176770023211 0ustar00U

��.e�&�	@sddlmZddlZddlZddlZddlmZddlmZddl	m
Z
mZddlm
Z
ddlmZmZddlmZdd	lmZer�dd
lmZmZmZmZmZmZmZmZddlmZeeeefZ dZ!d
d�Z"dd�Z#dd�Z$dd�Z%ddd�Z&dd�Z'dS)�)�absolute_importN)�shlex_quote)�InstallationError)�console_to_str�str_to_display)�subprocess_logger)�
HiddenText�path_to_display)�MYPY_CHECK_RUNNING)�open_spinner)�Any�Callable�Iterable�List�Mapping�Optional�Text�Union)�SpinnerInterfacez(----------------------------------------cGs2g}|D]$}t|t�r"|�|�q|�|�q|S)z&
    Create a CommandArgs object.
    )�
isinstance�list�extend�append)�argsZcommand_args�arg�r�B/usr/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py�make_commands
rcCsd�dd�|D��S)z/
    Format command arguments for display.
    � css,|]$}t|t�rtt|��nt|�VqdS)N)rrr�str��.0rrrr�	<genexpr>;s�z&format_command_args.<locals>.<genexpr>)�join�rrrr�format_command_args1s

�r%cCsdd�|D�S)z=
    Return the arguments in their raw, unredacted form.
    cSs g|]}t|t�r|jn|�qSr)rrZsecretr rrr�
<listcomp>Fsz'reveal_command_args.<locals>.<listcomp>rr$rrr�reveal_command_argsAs�r'c	CsDt|�}t|dd�}t|�}d�|�}dj|||t|�|td�}|S)z�
    Create and return the error message to use to log a subprocess error
    with command output.

    :param lines: A list of lines, each ending with a newline.
    z
command bytes)Zdesc�z�Command errored out with exit status {exit_status}:
 command: {command_display}
     cwd: {cwd_display}
Complete output ({line_count} lines):
{output}{divider})�exit_status�command_display�cwd_displayZ
line_count�outputZdivider)r%rr	r#�format�len�LOG_DIVIDER)	�cmd_args�cwd�linesr)Zcommandr*r+r,�msgrrr�make_subprocess_output_errorKs

�	�r4F�raiseTc

Cs4|dkrg}|dkrg}|r*tj}
tj}ntj}
tj}t��|k}|oN|dk	}
|dkr`t|�}|
d|�tj	�
�}|r�|�|�|D]}|�|d�q�z.t
jt|�t
jt
jt
j||d�}|j��Wn6tk
r�}z|	r�t�d||��W5d}~XYnXg}t|j���}|�s�qJ|��}|�|d�|
|�|
�r|���qz|��W5|j�rj|j��X|j�o||j|k}|
�r�|�r�|�d�n
|�d�|�r*|dk�r�|�s�|	�r�t||||jd	�}t� |�d
�!|j|�}t"|��n:|dk�rt�#d||j|�n|d
k�rnt$dt%|���d�&|�S)a�
    Args:
      show_stdout: if true, use INFO to log the subprocess's stderr and
        stdout streams.  Otherwise, use DEBUG.  Defaults to False.
      extra_ok_returncodes: an iterable of integer return codes that are
        acceptable, in addition to 0. Defaults to None, which means [].
      unset_environ: an iterable of environment variable names to unset
        prior to calling subprocess.Popen().
      log_failed_cmd: if false, failed commands are not logged, only raised.
    NzRunning command %s)�stderr�stdin�stdoutr1�envz#Error %s while executing command %s�
�errorZdoner5)r0r1r2r)zSCommand errored out with exit status {}: {} Check the logs for full command output.�warnz$Command "%s" had error code %s in %s�ignorezInvalid value: on_returncode=%sr()'r�info�logging�INFO�debug�DEBUGZgetEffectiveLevelr%�os�environ�copy�update�pop�
subprocess�Popenr'ZSTDOUT�PIPEr7�close�	ExceptionZcriticalrr8�readline�rstriprZspin�wait�
returncodeZfinishr4r;r-rZwarning�
ValueError�reprr#)�cmdZshow_stdoutr1Z
on_returncodeZextra_ok_returncodesZcommand_desc�
extra_environZ
unset_environ�spinnerZlog_failed_cmdZlog_subprocessZ
used_levelZshowing_subprocessZuse_spinnerr9�name�proc�excZ
all_output�lineZproc_had_errorr3Zexc_msgrrr�call_subprocessus�


���

�
��

�
�rZcsd�fdd�	}|S)z�Provide a subprocess_runner that shows a spinner message.

    Intended for use with for pep517's Pep517HookCaller. Thus, the runner has
    an API that matches what's expected by Pep517HookCaller.subprocess_runner.
    Nc	s(t���}t||||d�W5QRXdS)N)r1rTrU)rrZ)rSr1rTrU��messagerr�runners
�z+runner_with_spinner_message.<locals>.runner)NNr)r\r]rr[r�runner_with_spinner_messages
�r^)	FNr5NNNNNT)(Z
__future__rr?rCrHZpip._vendor.six.movesrZpip._internal.exceptionsrZpip._internal.utils.compatrrZpip._internal.utils.loggingrZpip._internal.utils.miscrr	Zpip._internal.utils.typingr
Zpip._internal.utils.uir�typingrr
rrrrrrrrZCommandArgsr/rr%r'r4rZr^rrrr�<module>s>(
,�
site-packages/pip/_internal/utils/__pycache__/encoding.cpython-38.pyc000064400000002337151446176770021644 0ustar00U

��.e(�@s�ddlZddlZddlZddlZddlmZerDddlmZmZm	Z	ej
dfejdfejdfej
dfejdfejd	fejd
fgZe�d�Zdd
�ZdS)�N)�MYPY_CHECK_RUNNING)�List�Tuple�Textzutf-8zutf-16z	utf-16-bez	utf-16-lezutf-32z	utf-32-bez	utf-32-lescoding[:=]\s*([-\w.]+)cCs�tD],\}}|�|�r|t|�d��|�Sq|�d�dd�D]D}|dd�dkrDt�|�rDt�|���d�d�}|�|�SqD|�t�	d�p�t
���S)	z�Check a bytes string for a BOM to correctly detect the encoding

    Fallback to locale.getpreferredencoding(False) like open() on Python3N�
�r��#�asciiF)�BOMS�
startswith�len�decode�split�ENCODING_RE�search�groups�localeZgetpreferredencoding�sys�getdefaultencoding)�dataZbom�encoding�line�r�@/usr/lib/python3.8/site-packages/pip/_internal/utils/encoding.py�auto_decodes
�r)�codecsr�rerZpip._internal.utils.typingr�typingrrr�BOM_UTF8�	BOM_UTF16�BOM_UTF16_BE�BOM_UTF16_LE�	BOM_UTF32�BOM_UTF32_BE�BOM_UTF32_LEr�compilerrrrrr�<module>s �

site-packages/pip/_internal/utils/__pycache__/models.cpython-38.opt-1.pyc000064400000003604151446176770022276 0ustar00U

��.e|�@s dZddlZGdd�de�ZdS)zUtilities for defining models
�Nc@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)�KeyBasedCompareMixinz<Provides comparison capabilities that is based on a key
    cCs||_||_dS�N)�_compare_key�_defining_class)�self�keyZdefining_class�r�>/usr/lib/python3.8/site-packages/pip/_internal/utils/models.py�__init__
szKeyBasedCompareMixin.__init__cCs
t|j�Sr)�hashr)rrrr	�__hash__szKeyBasedCompareMixin.__hash__cCs|�|tj�Sr)�_compare�operator�__lt__�r�otherrrr	rszKeyBasedCompareMixin.__lt__cCs|�|tj�Sr)r
r�__le__rrrr	rszKeyBasedCompareMixin.__le__cCs|�|tj�Sr)r
r�__gt__rrrr	rszKeyBasedCompareMixin.__gt__cCs|�|tj�Sr)r
r�__ge__rrrr	rszKeyBasedCompareMixin.__ge__cCs|�|tj�Sr)r
r�__eq__rrrr	r szKeyBasedCompareMixin.__eq__cCs|�|tj�Sr)r
r�__ne__rrrr	r#szKeyBasedCompareMixin.__ne__cCst||j�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr�methodrrr	r
&szKeyBasedCompareMixin._compareN)
�__name__�
__module__�__qualname__�__doc__r
rrrrrrrr
rrrr	r	sr)rr�objectrrrrr	�<module>ssite-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-38.opt-1.pyc000064400000002352151446176770024412 0ustar00U

��.e_�@s:ddlZddlmZer(ddlmZmZdZddd�ZdS)	�N)�MYPY_CHECK_RUNNING)�List�Sequencez�import sys, setuptools, tokenize; sys.argv[0] = {0!r}; __file__={0!r};f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))FcCsJtjg}|r|�d�|�dt�|�g�|r8|�|�|rF|�d�|S)ao
    Get setuptools command arguments with shim wrapped setup file invocation.

    :param setup_py_path: The path to setup.py to be wrapped.
    :param global_options: Additional global options.
    :param no_user_config: If True, disables personal user configuration.
    :param unbuffered_output: If True, adds the unbuffered switch to the
     argument list.
    z-uz-cz
--no-user-cfg)�sys�
executable�append�extend�_SETUPTOOLS_SHIM�format)Z
setup_py_pathZglobal_optionsZno_user_configZunbuffered_output�args�r�H/usr/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py�make_setuptools_shim_argss


r)NFF)rZpip._internal.utils.typingr�typingrrr	rrrrr
�<module>s	��site-packages/pip/_internal/utils/__pycache__/filetypes.cpython-38.pyc000064400000001054151446176770022055 0ustar00U

��.e;�@sLdZddlmZer ddlmZdZdZdZdefZdZ	eee	eZ
d	S)
zFiletype information.
�)�MYPY_CHECK_RUNNING)�Tuplez.whl)z.tar.bz2z.tbz)z.tar.xzz.txzz.tlzz.tar.lzz	.tar.lzmaz.zip)z.tar.gzz.tgzz.tarN)�__doc__Zpip._internal.utils.typingr�typingrZWHEEL_EXTENSIONZBZ2_EXTENSIONSZ
XZ_EXTENSIONSZZIP_EXTENSIONSZTAR_EXTENSIONSZARCHIVE_EXTENSIONS�rr�A/usr/lib/python3.8/site-packages/pip/_internal/utils/filetypes.py�<module>s�site-packages/pip/_internal/utils/__pycache__/misc.cpython-38.pyc000064400000055526151446176770021021 0ustar00U

��.e�c�@s�ddlmZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
ddlmZddlmZddlmZmZddlmZddlmZdd	lmZdd
lmZddlm Z ddl!m"Z"m#Z#m$Z$m%Z%dd
l&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0m1Z1e�r8ddlm2Z3nddlm3Z3e.�r�ddl4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>ddl?m@Z@e<eAeAeAfZBndd�Z>dddddddddd d!d"d#d$gZCe�DeE�ZFd%d&�ZGd'd(�ZHd)d"�ZId*d �ZJed+d,d-�d�d/d��ZKd0d1�ZLd2d3�ZMd4d�ZNd�d6d�ZOd7d8�ZPd9d:�ZQd;d�ZRd<d=�ZSd>d?�ZTd@d�ZUdAd�ZVejWfdBdC�ZXd�dEd�ZYdFd�ZZdGd�Z[dHdI�Z\dJdK�Z]dLdM�Z^dNdO�Z_dPdQ�Z`dRdS�ZadDe)dDd.d.dfdTdU�ZbdVdW�ZcdXdY�ZddZd[�Zed\d]�ZfGd^d_�d_eg�ZhGd`da�dae3�Ziejjdbdc��Zkddd!�Zldedf�ZmGdgdh�dheg�Znd�did#�Zodjdk�Zpdldm�Zqdndo�Zrd�dqdr�Zsdsdt�Ztdudv�Zudwdx�Zvdydz�Zwd{d|�Zxd}d~�Zydd��Zzd�d$�Z{d�d��Z|Gd�d��d�eg�Z}d�d��Z~d�d��Zd�d��Z�d�d��Z�dS)��)�absolute_importN��deque)�
pkg_resources)�retry)�PY2�	text_type)�input)�parse)�unquote)�__version__)�CommandError)�distutils_scheme�get_major_minor_version�
site_packages�	user_site)�WINDOWS�
expanduser�stdlib_pkgs�str_to_display)�write_delete_marker_file)�MYPY_CHECK_RUNNING)�running_under_virtualenv�virtualenv_no_global)�BytesIO)�StringIO)
�Any�AnyStr�	Container�Iterable�List�Optional�Text�Tuple�Union�cast)�DistributioncCs|S�N�)Ztype_�valuer(r(�</usr/lib/python3.8/site-packages/pip/_internal/utils/misc.pyr%Asr%�rmtree�display_path�
backup_dir�ask�splitext�format_size�is_installable_dir�normalize_path�renames�get_prog�captured_stdout�
ensure_dir�get_installed_version�remove_auth_from_urlcCs4tj�tj�t�dd�}tj�|�}d�t|t��S)Nz..zpip {} from {} (python {}))	�os�path�join�dirname�__file__�abspath�formatrr)Zpip_pkg_dirr(r(r*�get_pip_versionQs��r@cCsDt|�dkr"|dt|�d7}nt|�dkr:|dd�}td|�S)ax
    Convert a tuple of ints representing a Python version to one of length
    three.

    :param py_version_info: a tuple of ints representing a Python version,
        or None to specify no version. The tuple can have any length.

    :return: a tuple of length three if `py_version_info` is non-None.
        Otherwise, return `py_version_info` unchanged (i.e. None).
    �)rN�VersionInfo)�lenr%)Zpy_version_infor(r(r*�normalize_version_info]s
rDc
CsDzt�|�Wn0tk
r>}z|jtjkr.�W5d}~XYnXdS)z os.path.makedirs without EEXIST.N)r9�makedirs�OSError�errnoZEEXIST)r:�er(r(r*r6qs
c
CsPz0tj�tjd�}|dkr(dtjWS|WSWntttfk
rJYnXdS)Nr)z__main__.pyz-cz	%s -m pip�pip)	r9r:�basename�sys�argv�
executable�AttributeError�	TypeError�
IndexError)�progr(r(r*r4{s
i�i�)Zstop_max_delayZ
wait_fixedFcCstj||td�dS)N)�
ignore_errors�onerror)�shutilr+�rmtree_errorhandler)�dirrRr(r(r*r+�s�c	CsXzt�|�jtj@}Wnttfk
r2YdSX|rRt�|tj�||�dS�dS)z�On Windows, the files in .svn are read-only, so when rmtree() tries to
    remove them, an exception is thrown.  We catch that here, remove the
    read-only attribute, and hopefully continue without problems.N)r9�stat�st_mode�S_IWRITE�IOErrorrF�chmod)�funcr:�exc_infoZhas_attr_readonlyr(r(r*rU�srUcCsd|dkrdSt|t�r|Sz|�t��d�}Wn0tk
r^trRtd�|��}nt	|�}YnX|S)z�
    Convert a bytes (or text) path to text (unicode in Python 2) for display
    and logging purposes.

    This function should never error out. Also, this function is mainly needed
    for Python 2 since in Python 3 str paths are already text.
    N�strictzb{!r})
�
isinstancer�decoderK�getfilesystemencoding�UnicodeDecodeErrorrrr?�ascii)r:r,r(r(r*�path_to_display�s	
rdcCsttj�tj�|��}tjddkrB|�t��d�}|�t�	�d�}|�
t��tjj�rpd|t
t���d�}|S)zTGives the display value for a given path, making it relative to cwd
    if possible.r��replace�.N)r9r:�normcaser>rK�version_infor`ra�encode�getdefaultencoding�
startswith�getcwd�seprC�r:r(r(r*r,�s�.bakcCs6d}|}tj�||�r.|d7}|t|�}q||S)z\Figure out the name of a directory to back up the given dir to
    (adding .bak, .bak2, etc)�)r9r:�exists�str)rV�ext�n�	extensionr(r(r*r-�scCs2tj�dd���D]}||kr|Sqt||�S)NZPIP_EXISTS_ACTION�)r9�environ�get�splitr.)�message�options�actionr(r(r*�ask_path_exists�s
r~cCstj�d�rtd|��dS)z&Raise an error if no input is allowed.ZPIP_NO_INPUTz7No input was expected ($PIP_NO_INPUT set); question: %sN)r9rxry�	Exception�r{r(r(r*�_check_no_input�s��r�cCsFt|�t|�}|����}||kr<td|d�|�f�q|SqdS)z@Ask the message interactively, with the given possible responsesz<Your response (%r) was not one of the expected responses: %sz, N)r�r	�strip�lower�printr;)r{r|Zresponser(r(r*r.�s��cCst|�t|�S)zAsk for input interactively.)r�r	r�r(r(r*�	ask_inputsr�cCst|�t�|�S)z!Ask for a password interactively.)r��getpassr�r(r(r*�ask_passwordsr�cCsL|dkrd|ddS|dkr,d|dS|dkr@d|dSd|SdS)	Ni@Bz%.1fMBg@�@i�i'z%ikBz%.1fkBz%ibytesr()�bytesr(r(r*r0scCsPtj�|�sdStj�|d�}tj�|�r.dStj�|d�}tj�|�rLdSdS)zBIs path is a directory containing setup.py or pyproject.toml?
    Fzsetup.pyTzpyproject.toml)r9r:�isdirr;�isfile)r:Zsetup_pyZpyproject_tomlr(r(r*r1sccs|�|�}|sq|VqdS)z7Yield pieces of data from a file-like object until EOF.N)�read)�file�size�chunkr(r(r*�read_chunks*s
r�TcCs2t|�}|rtj�|�}ntj�|�}tj�|�S)zN
    Convert a path to its canonical, case-normalized, absolute version.

    )rr9r:�realpathr>rh)r:Zresolve_symlinksr(r(r*r23s
cCs@t�|�\}}|���d�r8|dd�|}|dd�}||fS)z,Like os.path.splitext, but take off .tar tooz.tar���N)�	posixpathr/r��endswith)r:�basertr(r(r*r/As
cCsztj�|�\}}|r.|r.tj�|�s.t�|�t�||�tj�|�\}}|rv|rvzt�|�Wntk
rtYnXdS)z7Like os.renames(), but handles renaming across devices.N)	r9r:rzrrrErTZmove�
removedirsrF)�old�new�head�tailr(r(r*r3Ks
cCst�s
dS|�ttj��S)z�
    Return True if path is within sys.prefix, if we're running in a virtualenv.

    If we're not in a virtualenv, all paths are considered "local."

    Caution: this function assumes the head of path has been normalized
    with normalize_path.
    T)rrlr2rK�prefixror(r(r*�is_local]s
r�cCstt|��S)z�
    Return True if given Distribution object is installed locally
    (i.e. within current virtualenv).

    Always True if we're not in a virtualenv.

    )r��
dist_location��distr(r(r*�
dist_is_localls	r�cCst|��tt��S)zF
    Return True if given Distribution is installed in user site.
    )r�rlr2rr�r(r(r*�dist_in_usersitexsr�cCst|��tt��S)z[
    Return True if given Distribution is installed in
    sysconfig.get_python_lib().
    )r�rlr2rr�r(r(r*�dist_in_site_packages�sr�cCs,tt|��}|�ttd�d�d�d��S)zf
    Return True if given Distribution is installed in
    path matching distutils_scheme layout.
    rwZpurelib�pythonr)r2r�rlrrz)r�Z	norm_pathr(r(r*�dist_in_install_path�s�r�cCs6tjD]*}tj�||jd�}tj�|�rdSqdS)zC
    Return True if given Distribution is an editable install.
    �	.egg-linkTF)rKr:r9r;�project_namer�)r�Z	path_item�egg_linkr(r(r*�dist_is_editable�s

r�cs�|rt�|�}ntj}|r t�ndd��|r6dd��ndd��|rLdd��ndd��|r^t�nd	d
�������fdd�|D�S)
a^
    Return a list of installed Distribution objects.

    If ``local_only`` is True (default), only return installations
    local to the current virtualenv, if in a virtualenv.

    ``skip`` argument is an iterable of lower-case project names to
    ignore; defaults to stdlib_pkgs

    If ``include_editables`` is False, don't report editables.

    If ``editables_only`` is True , only report editables.

    If ``user_only`` is True , only report installations in the user
    site directory.

    If ``paths`` is set, only report the distributions present at the
    specified list of locations.
    cSsdS�NTr(��dr(r(r*�
local_test�sz/get_installed_distributions.<locals>.local_testcSsdSr�r(r�r(r(r*�
editable_test�sz2get_installed_distributions.<locals>.editable_testcSs
t|�Sr'�r�r�r(r(r*r��scSst|�Sr'r�r�r(r(r*�editables_only_test�sz8get_installed_distributions.<locals>.editables_only_testcSsdSr�r(r�r(r(r*r��scSsdSr�r(r�r(r(r*�	user_test�sz.get_installed_distributions.<locals>.user_testcs:g|]2}�|�r|j�kr�|�r�|�r�|�r|�qSr()�key)�.0r��r�r�r��skipr�r(r*�
<listcomp>�s
�z/get_installed_distributions.<locals>.<listcomp>)r�
WorkingSet�working_setr�r�)Z
local_onlyr�Zinclude_editablesZeditables_onlyZ	user_only�pathsr�r(r�r*�get_installed_distributions�s 

r�cCsxg}t�r*|�t�t�sBtrB|�t�ntr8|�t�|�t�|D],}tj�||j�d}tj�	|�rF|SqFdS)a
    Return the path for the .egg-link file if it exists, otherwise, None.

    There's 3 scenarios:
    1) not in a virtualenv
       try to find in site.USER_SITE, then site_packages
    2) in a no-global virtualenv
       try to find in site_packages
    3) in a yes-global virtualenv
       try to find in site_packages, then site.USER_SITE
       (don't look in global location)

    For #1 and #3, there could be odd cases, where there's an egg-link in 2
    locations.

    This method will just return the first one found.
    r�N)
r�appendrrrr9r:r;r�r�)r�ZsitesZsiteZegglinkr(r(r*�
egg_link_path�s




r�cCst|�}|rt|�St|j�S)aO
    Get the site-packages location of this distribution. Generally
    this is dist.location, except in the case of develop-installed
    packages, where dist.location is the source code location, and we
    want to know where the egg-link file is.

    The returned location is normalized (in particular, with symlinks removed).
    )r�r2�location)r�r�r(r(r*r�s
r�cGstj|f|��dSr')�logger�info)�msg�argsr(r(r*�write_outputsr�cCst�|�t|�dSr')r9rEr)Z	build_dirr(r(r*�_make_build_dirs
r�c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�FakeFilezQWrap a list of lines in an object with readline() to make
    ConfigParser happy.cCsdd�|D�|_dS)Ncss|]
}|VqdSr'r()r��lr(r(r*�	<genexpr>&sz$FakeFile.__init__.<locals>.<genexpr>��_gen)�self�linesr(r(r*�__init__%szFakeFile.__init__cCsPz4zt|j�WWStk
r0|j��YWSXWntk
rJYdSXdS)Nrw)�nextr��	NameError�
StopIteration�r�r(r(r*�readline(szFakeFile.readlinecCs|jSr'r�r�r(r(r*�__iter__1szFakeFile.__iter__N)�__name__�
__module__�__qualname__�__doc__r�r�r�r(r(r(r*r�"s	r�c@s$eZdZedd��Zedd��ZdS)�
StreamWrappercCs||_|�Sr')�orig_stream)�clsr�r(r(r*�from_stream7szStreamWrapper.from_streamcCs|jjSr')r��encodingr�r(r(r*r�=szStreamWrapper.encodingN)r�r�r��classmethodr��propertyr�r(r(r(r*r�5s
r�c
cs@tt|�}tt|t�|��ztt|�VW5tt||�XdS)z�Return a context manager used by captured_stdout/stdin/stderr
    that temporarily replaces the sys stream *stream_name* with a StringIO.

    Taken from Lib/support/__init__.py in the CPython repo.
    N)�getattrrK�setattrr�r�)Zstream_nameZorig_stdoutr(r(r*�captured_outputBs

r�cCstd�S)z�Capture the output of sys.stdout:

       with captured_stdout() as stdout:
           print('hello')
       self.assertEqual(stdout.getvalue(), 'hello
')

    Taken from Lib/support/__init__.py in the CPython repo.
    �stdout�r�r(r(r(r*r5Qs	cCstd�S)z 
    See captured_stdout().
    �stderrr�r(r(r(r*�captured_stderr]sr�c@s eZdZdZdd�Zdd�ZdS)�cached_propertyz�A property that is only computed once per instance and then replaces
       itself with an ordinary attribute. Deleting the attribute resets the
       property.

       Source: https://github.com/bottlepy/bottle/blob/0.11.5/bottle.py#L175
    cCst|d�|_||_dS)Nr�)r�r�r\)r�r\r(r(r*r�lszcached_property.__init__cCs(|dkr|S|�|�}|j|jj<|Sr')r\�__dict__r�)r��objr�r)r(r(r*�__get__pszcached_property.__get__N)r�r�r�r�r�r�r(r(r(r*r�dsr�cCs4tj�|�}|dkrt��}|�|�}|r0|jSdS)zCGet the installed version of dist_name avoiding pkg_resources cacheN)rZRequirementr
r��find�version)Z	dist_namer�Zreqr�r(r(r*r7xs

cCst|dd�dS)zConsume an iterable at C speed.r)�maxlenNr)�iteratorr(r(r*�consume�sr�cOs@tt|tt|���f|�}dd�|��D�}||d<tdd|�S)NcSsi|]\}}||�qSr(r()r�r�r)r(r(r*�
<dictcomp>�szenum.<locals>.<dictcomp>Zreverse_mapping�Enumr()�dict�zip�rangerC�items�type)Z
sequentialZnamedZenums�reverser(r(r*�enum�sr�cCs*|dkr|Sd|krd�|�}d�||�S)z.
    Build a netloc from a host-port pair
    N�:�[{}]z{}:{})r?)Zhost�portr(r(r*�build_netloc�s

r��httpscCs4|�d�dkr(d|kr(d|kr(d�|�}d�||�S)z)
    Build a full URL from a netloc.
    r�re�@�[r�z{}://{})�countr?)�netloc�schemer(r(r*�build_url_from_netloc�s
r�cCst|�}t�|�}|j|jfS)z2
    Return the host-port pair from a netloc.
    )r��urllib_parseZurlparseZhostnamer�)r��urlZparsedr(r(r*�parse_netloc�s
rcCsXd|kr|dfS|�dd�\}}d|kr6|�dd�}n|df}tdd�|D��}||fS)zp
    Parse out and remove the auth information from a netloc.

    Returns: (netloc, (username, password)).
    r�)NNrqr�Ncss"|]}|dkrdnt|�VqdSr')�urllib_unquote)r��xr(r(r*r��sz)split_auth_from_netloc.<locals>.<genexpr>)�rsplitrz�tuple)r��authZ	user_passr(r(r*�split_auth_from_netloc�s�rcCsLt|�\}\}}|dkr|S|dkr.d}d}nt�|�}d}dj|||d�S)z�
    Replace the sensitive data in a netloc with "****", if it exists.

    For example:
        - "user:pass@example.com" returns "user:****@example.com"
        - "accesstoken@example.com" returns "****@example.com"
    N�****rwz:****z{user}{password}@{netloc})�user�passwordr�)rr�Zquoter?)r�r	r
r(r(r*�
redact_netloc�s	
�rcCs@t�|�}||j�}|j|d|j|j|jf}t�|�}||fS)aRTransform and replace netloc in a url.

    transform_netloc is a function taking the netloc and returning a
    tuple. The first element of this tuple is the new netloc. The
    entire tuple is returned.

    Returns a tuple containing the transformed url as item 0 and the
    original tuple returned by transform_netloc as item 1.
    r)r�Zurlsplitr�r�r:ZqueryZfragmentZ
urlunsplit)rZtransform_netlocZpurlZnetloc_tupleZ
url_piecesZsurlr(r(r*�_transform_url�s


�
rcCst|�Sr')r�r�r(r(r*�_get_netlocsrcCs
t|�fSr')rr
r(r(r*�_redact_netlocsrcCst|t�\}\}}|||fS)z�
    Parse a url into separate netloc, auth, and url with no auth.

    Returns: (url_without_auth, netloc, (username, password))
    �rr)rZurl_without_authr�rr(r(r*�split_auth_netloc_from_urlsrcCst|t�dS)z7Return a copy of url with 'username:password@' removed.rr�rr(r(r*r8scCst|t�dS)z.Replace the password in a given url with ****.r)rrrr(r(r*�redact_auth_from_urlsrc@s4eZdZdd�Zdd�Zdd�Zdd�Zd	d
�ZdS)�
HiddenTextcCs||_||_dSr')�secret�redacted)r�rrr(r(r*r�"szHiddenText.__init__cCsd�t|��S)Nz<HiddenText {!r}>)r?rsr�r(r(r*�__repr__+szHiddenText.__repr__cCs|jSr'�rr�r(r(r*�__str__/szHiddenText.__str__cCs t|�t|�krdS|j|jkS)NF)r�r�r��otherr(r(r*�__eq__4szHiddenText.__eq__cCs
||kSr'r(rr(r(r*�__ne__?szHiddenText.__ne__N)r�r�r�r�rrrrr(r(r(r*r!s
	rcCst|dd�S)Nrr)r)r)r(r(r*�
hide_valueDsrcCst|�}t||d�S)Nr)rr)rrr(r(r*�hide_urlIsrcCs�t�}dD]P}|�dj|d��|�djtjd|d��|�djtjdd�d	|i��q
|oxtoxtj�tj	d�|k}|r�tj
d
dgtj	dd�}td
�d�|����dS)z�Protection of pip.exe from modification on Windows

    On Windows, any operation modifying pip should be run as:
        python -m pip ...
    )rwz.exezpip{ext})rtz
pip{}{ext}rz
pip{}.{}{ext}Nrertz-mrIrqz3To modify pip, please run the following command:
{}� )
�set�addr?rKrirr9r:rJrLrMr
r;)Z
modifying_pipZ	pip_namesrtZshould_show_use_python_msgZnew_commandr(r(r*�(protect_pip_from_modification_on_windowsOs,"������r#cCstjdk	otj��S)z!Is this console interactive?
    N)rK�stdin�isattyr(r(r(r*�is_console_interactivemsr&)F)rp)T)N)r�)�Z
__future__r�
contextlibrGr��ioZloggingr9r�rTrWrK�collectionsrZpip._vendorrZpip._vendor.retryingrZpip._vendor.sixrrZpip._vendor.six.movesr	Zpip._vendor.six.moves.urllibr
r�Z"pip._vendor.six.moves.urllib.parserrrIrZpip._internal.exceptionsr
Zpip._internal.locationsrrrrZpip._internal.utils.compatrrrrZ pip._internal.utils.marker_filesrZpip._internal.utils.typingrZpip._internal.utils.virtualenvrrrr�typingrrrrr r!r"r#r$r%Zpip._vendor.pkg_resourcesr&�intrB�__all__Z	getLoggerr�r�r@rDr6r4r+rUrdr,r-r~r�r.r�r�r0r1�DEFAULT_BUFFER_SIZEr�r2r/r3r�r�r�r�r�r�r�r�r�r�r��objectr�r��contextmanagerr�r5r�r�r7r�r�r�r�rrrrrrrr8rrrrr#r&r(r(r(r*�<module>s�0�	


"

	

	

�
E$




#site-packages/pip/_internal/utils/__pycache__/temp_dir.cpython-38.pyc000064400000011517151446176770021661 0ustar00U

��.e��@s�ddlmZddlZddlZddlZddlZddlZddlm	Z	ddl
mZer\ddlm
Z
e�e�ZGdd�de�ZGdd	�d	e�ZdS)
�)�absolute_importN)�rmtree)�MYPY_CHECK_RUNNING)�OptionalcsVeZdZdZd�fdd�	Zedd��Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Z�ZS)�
TempDirectoryaMHelper class that owns and cleans up a temporary directory.

    This class can be used as a context manager or as an OO representation of a
    temporary directory.

    Attributes:
        path
            Location to the created temporary directory
        delete
            Whether the directory should be deleted when exiting
            (when used as a contextmanager)

    Methods:
        cleanup()
            Deletes the temporary directory

    When used as a context manager, if the delete attribute is True, on
    exiting the context the temporary directory is deleted.
    N�tempcsPtt|���|dkr"|dkr"d}|dkr4|�|�}||_d|_||_||_dS)NTF)�superr�__init__�_create�_path�_deleted�delete�kind)�self�pathr
r��	__class__��@/usr/lib/python3.8/site-packages/pip/_internal/utils/temp_dir.pyr	+s
zTempDirectory.__init__cCs|jrtd�|j���|jS)Nz$Attempted to access deleted path: {})r�AssertionError�formatr�rrrrr@s
�zTempDirectory.pathcCsd�|jj|j�S)Nz	<{} {!r}>)rr�__name__rrrrr�__repr__HszTempDirectory.__repr__cCs|S�Nrrrrr�	__enter__KszTempDirectory.__enter__cCs|jr|��dSr)r
�cleanup)r�exc�value�tbrrr�__exit__NszTempDirectory.__exit__cCs.tj�tjd�|�d��}t�d�|��|S)zECreate a temporary directory and store its path in self.path
        �pip-{}-��prefix�Created temporary directory: {})�osr�realpath�tempfile�mkdtempr�logger�debug)rrrrrrr
Rs
�zTempDirectory._createcCs"d|_tj�|j�rt|j�dS)z?Remove the temporary directory created and reset state
        TN)rr%r�existsrrrrrrr_szTempDirectory.cleanup)NNr)
r�
__module__�__qualname__�__doc__r	�propertyrrrr r
r�
__classcell__rrrrrs�

rcs:eZdZdZdZd
�fdd�	Zedd��Zdd	�Z�Z	S)�AdjacentTempDirectorya�Helper class that creates a temporary directory adjacent to a real one.

    Attributes:
        original
            The original directory to create a temp directory for.
        path
            After calling create() or entering, contains the full
            path to the temporary directory.
        delete
            Whether the directory should be deleted when exiting
            (when used as a contextmanager)

    z-~.=%0123456789Ncs"|�d�|_tt|�j|d�dS)Nz/\)r
)�rstrip�originalrr1r	)rr3r
rrrr	|szAdjacentTempDirectory.__init__ccs�tdt|��D]D}t�|j|d�D],}dd�|�||d�}||kr$|Vq$qtt|j��D]8}t�|j|�D]$}dd�|�|}||krt|VqtqbdS)aGenerates a series of temporary names.

        The algorithm replaces the leading characters in the name
        with ones that are valid filesystem characters, but are not
        valid package names (for both Python and pip definitions of
        package).
        ��~�N)�range�len�	itertools�combinations_with_replacement�
LEADING_CHARS�join)�cls�name�i�	candidate�new_namerrr�_generate_names�s 	�
�z%AdjacentTempDirectory._generate_namescCs�tj�|j�\}}|�|�D]b}tj�||�}zt�|�Wn0tk
rl}z|jtj	kr\�W5d}~XYqXtj�
|�}q�qtj�
tjd�
|�d��}t�d�
|��|S)Nr!r"r$)r%r�splitr3rBr<�mkdir�OSError�errnoZEEXISTr&r'r(rr)r*)rr�rootr>r@rZexrrrr
�s�zAdjacentTempDirectory._create)N)
rr,r-r.r;r	�classmethodrBr
r0rrrrr1gs
r1)Z
__future__rrFr9ZloggingZos.pathr%r'Zpip._internal.utils.miscrZpip._internal.utils.typingr�typingrZ	getLoggerrr)�objectrr1rrrr�<module>s
Qsite-packages/pip/_internal/utils/__pycache__/ui.cpython-38.opt-1.pyc000064400000026753151446176770021442 0ustar00U

��.eR6�@sxddlmZmZddlZddlZddlZddlZddlZddlm	Z	m
Z
mZddlmZddl
mZmZddlmZmZmZddlmZddlmZdd	lmZdd
lmZddlmZer�ddlmZm Z m!Z!zdd
lm"Z"Wne#k
r�dZ"YnXe�$e%�Z&dd�Z'e'ee�Z(Gdd�de)�Z*Gdd�de�Z+Gdd�de�Z,Gdd�de)�Z-Gdd�de)�Z.Gdd�de.e*e-�Z/Gdd�de/e(�Z0Gdd�de/e+�Z1Gd d!�d!e/e�Z2Gd"d#�d#e/e�Z3Gd$d%�d%e/e,�Z4Gd&d'�d'e.e*e-e�Z5e1e1fe0e5fe2e5fe3e5fe4e5fd(�Z6d7d)d*�Z7ej8d+d,��Z9Gd-d.�d.e)�Z:Gd/d0�d0e)�Z;Gd1d2�d2e;�Z<Gd3d4�d4e;�Z=ej8d5d6��Z>dS)8�)�absolute_import�divisionN)�SIGINT�default_int_handler�signal)�six)�HIDE_CURSOR�SHOW_CURSOR)�Bar�FillingCirclesBar�IncrementalBar)�Spinner)�WINDOWS)�get_indentation)�format_size)�MYPY_CHECK_RUNNING)�Any�Iterator�IO)�coloramacCs�t|jdd�}|s|St|dt���t|dt���g}|tt|dg��7}zt���|��|�Wntk
rz|YSX|SdS)N�encodingZ
empty_fillZfill�phases)�getattr�filerZ	text_type�list�join�encode�UnicodeEncodeError)Z	preferredZfallbackrZ
characters�r�:/usr/lib/python3.8/site-packages/pip/_internal/utils/ui.py�_select_progress_class%s�
r cs4eZdZdZ�fdd�Z�fdd�Zdd�Z�ZS)�InterruptibleMixina�
    Helper to ensure that self.finish() gets called on keyboard interrupt.

    This allows downloads to be interrupted without leaving temporary state
    (like hidden cursors) behind.

    This class is similar to the progress library's existing SigIntMixin
    helper, but as of version 1.2, that helper has the following problems:

    1. It calls sys.exit().
    2. It discards the existing SIGINT handler completely.
    3. It leaves its own handler in place even after an uninterrupted finish,
       which will have unexpected delayed effects if the user triggers an
       unrelated keyboard interrupt some time after a progress-displaying
       download has already completed, for example.
    cs4tt|�j||�tt|j�|_|jdkr0t|_dS)z=
        Save the original SIGINT handler for later.
        N)�superr!�__init__rr�
handle_sigint�original_handlerr��self�args�kwargs��	__class__rrr#Us
zInterruptibleMixin.__init__cstt|���tt|j�dS)z�
        Restore the original SIGINT handler after finishing.

        This should happen regardless of whether the progress display finishes
        normally, or gets interrupted.
        N)r"r!�finishrrr%�r'r*rrr,eszInterruptibleMixin.finishcCs|��|�||�dS)z�
        Call self.finish() before delegating to the original SIGINT handler.

        This handler should only be in place while the progress display is
        active.
        N)r,r%)r'Zsignum�framerrrr$osz InterruptibleMixin.handle_sigint)�__name__�
__module__�__qualname__�__doc__r#r,r$�
__classcell__rrr*rr!Cs
r!c@seZdZdd�ZdS)�	SilentBarcCsdS�Nrr-rrr�update|szSilentBar.updateN)r/r0r1r6rrrrr4zsr4c@seZdZdZdZdZdZdS)�BlueEmojiBar�
%(percent)d%%� )u🔹u🔷u🔵N)r/r0r1�suffixZ
bar_prefixZ
bar_suffixrrrrrr7�sr7csJeZdZ�fdd�Zedd��Zedd��Zedd��Zdd
d�Z�Z	S)
�DownloadProgressMixincs,tt|�j||�dt�d|j|_dS)Nr9�)r"r;r#r�messager&r*rrr#�szDownloadProgressMixin.__init__cCs
t|j�Sr5)r�indexr-rrr�
downloaded�sz DownloadProgressMixin.downloadedcCs |jdkrdStd|j�dS)Ngz...�z/s)Zavgrr-rrr�download_speed�s
z$DownloadProgressMixin.download_speedcCs|jrd|jSdS)Nzeta %s�)ZetaZeta_tdr-rrr�
pretty_eta�s
z DownloadProgressMixin.pretty_etar@ccs&|D]}|V|�|�q|��dSr5)�nextr,)r'�it�n�xrrr�iter�szDownloadProgressMixin.iter)r@)
r/r0r1r#�propertyr?rArCrHr3rrr*rr;�s


r;cseZdZ�fdd�Z�ZS)�WindowsMixincs\tr�jrd�_tt��j||�trXtrXt��j��_�fdd��j_�fdd��j_	dS)NFcs�jj��Sr5)r�wrapped�isattyrr-rr�<lambda>��z'WindowsMixin.__init__.<locals>.<lambda>cs�jj��Sr5)rrK�flushrr-rrrM�rN)
rZhide_cursorr"rJr#rZAnsiToWin32rrLrOr&r*r-rr#�s
zWindowsMixin.__init__)r/r0r1r#r3rrr*rrJ�srJc@seZdZejZdZdZdS)�BaseDownloadProgressBarr8z0%(downloaded)s %(download_speed)s %(pretty_eta)sN)r/r0r1�sys�stdoutrr=r:rrrrrP�srPc@seZdZdS)�DefaultDownloadProgressBarN�r/r0r1rrrrrS�srSc@seZdZdS)�DownloadSilentBarNrTrrrrrU�srUc@seZdZdS)�DownloadBarNrTrrrrrV�srVc@seZdZdS)�DownloadFillingCirclesBarNrTrrrrrW�srWc@seZdZdS)�DownloadBlueEmojiProgressBarNrTrrrrrX�srXc@s&eZdZejZdZdd�Zdd�ZdS)�DownloadProgressSpinnerz!%(downloaded)s %(download_speed)scCs"t|d�st�|j�|_t|j�S)N�_phaser)�hasattr�	itertools�cyclerrZrDr-rrr�
next_phase�s
z"DownloadProgressSpinner.next_phasecCsN|j|}|��}|j|}d�||r*dnd||r6dnd|g�}|�|�dS)NrBr9)r=r^r:rZwriteln)r'r=Zphaser:�linerrrr6�s



�zDownloadProgressSpinner.updateN)	r/r0r1rQrRrr:r^r6rrrrrY�srY)ZoffZon�asciiZprettyZemojicCs8|dks|dkr t|d�jSt|d|d�jSdS)Nrr@)�max)�	BAR_TYPESrH)Zprogress_barrarrr�DownloadProgressProvider	srcc	csPtrdVn@|��r"t��tjkr*dVn"|�t�z
dVW5|�t�XdSr5)	rrL�logger�getEffectiveLevel�logging�INFO�writerr	)rrrr�
hidden_cursors

ric@s$eZdZdd�Zdd�Zdd�ZdS)�RateLimitercCs||_d|_dS)Nr)�_min_update_interval_seconds�_last_update)r'�min_update_interval_secondsrrrr#-szRateLimiter.__init__cCst��}||j}||jkSr5)�timerlrk)r'ZnowZdeltarrr�ready2s
zRateLimiter.readycCst��|_dSr5)rnrlr-rrr�reset8szRateLimiter.resetN)r/r0r1r#rorprrrrrj,srjc@seZdZdd�Zdd�ZdS)�SpinnerInterfacecCs
t��dSr5��NotImplementedErrorr-rrr�spin>szSpinnerInterface.spincCs
t��dSr5rr�r'Zfinal_statusrrrr,BszSpinnerInterface.finishN)r/r0r1rtr,rrrrrq=srqc@s.eZdZddd�Zdd�Zdd	�Zd
d�ZdS)
�InteractiveSpinnerN�-\|/��?cCs\||_|dkrtj}||_t|�|_d|_t�|�|_	|j�
dt�|jd�d|_dS)NFr9z ... r)
�_messagerQrR�_filerj�
_rate_limiter�	_finishedr\r]�_spin_cyclerhr�_width)r'r=rZ
spin_charsrmrrrr#Hs
zInteractiveSpinner.__init__cCsRd|j}|j�|d|j|�|j�|�t|�|_|j��|j��dS)N�r9)r~rzrh�lenrOr{rp)r'�statusZbackuprrr�_writeWs


zInteractiveSpinner._writecCs,|jr
dS|j��sdS|�t|j��dSr5)r|r{ror�rDr}r-rrrrtcs

zInteractiveSpinner.spincCs4|jr
dS|�|�|j�d�|j��d|_dS)N�
T)r|r�rzrhrOrurrrr,ks

zInteractiveSpinner.finish)Nrwrx)r/r0r1r#r�rtr,rrrrrvGs�
rvc@s.eZdZddd�Zdd�Zdd�Zdd	�Zd
S)�NonInteractiveSpinner�<cCs$||_d|_t|�|_|�d�dS)NFZstarted)ryr|rjr{�_update)r'r=rmrrrr#zs
zNonInteractiveSpinner.__init__cCs|j��t�d|j|�dS)Nz%s: %s)r{rprd�infory)r'r�rrrr��s
zNonInteractiveSpinner._updatecCs&|jr
dS|j��sdS|�d�dS)Nzstill running...)r|r{ror�r-rrrrt�s

zNonInteractiveSpinner.spincCs$|jr
dS|�d|f�d|_dS)Nzfinished with status '%s'T)r|r�rurrrr,�szNonInteractiveSpinner.finishN)r�)r/r0r1r#r�rtr,rrrrr�ys
r�c	cs�tj��r"t��tjkr"t|�}nt|�}z t	tj��|VW5QRXWn>t
k
rj|�d��Yn*tk
r�|�d��YnX|�d�dS)NZcanceled�errorZdone)
rQrRrLrdrerfrgrvr�ri�KeyboardInterruptr,�	Exception)r=Zspinnerrrr�open_spinner�s


r�)N)?Z
__future__rr�
contextlibr\rfrQrnrrrZpip._vendorrZpip._vendor.progressrr	Zpip._vendor.progress.barr
rrZpip._vendor.progress.spinnerr
Zpip._internal.utils.compatrZpip._internal.utils.loggingrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingrrrrr�Z	getLoggerr/rdr Z_BaseBar�objectr!r4r7r;rJrPrSrUrVrWrXrYrbrc�contextmanagerrirjrqrvr�r�rrrr�<module>s~


7�������	


2site-packages/pip/_internal/utils/__pycache__/glibc.cpython-38.pyc000064400000004321151446176770021131 0ustar00U

��.e-�@sxddlmZddlZddlZddlZddlmZerDddlmZm	Z	dd�Z
dd�Zd	d
�Zdd�Z
d
d�Zdd�ZdS)�)�absolute_importN)�MYPY_CHECK_RUNNING)�Optional�TuplecCst�p
t�S)z9Returns glibc version string, or None if not using glibc.)�glibc_version_string_confstr�glibc_version_string_ctypes�rr�=/usr/lib/python3.8/site-packages/pip/_internal/utils/glibc.py�glibc_version_stringsr
c
Cs8zt�d���\}}Wntttfk
r2YdSX|S)z@Primary implementation of glibc_version_string using os.confstr.�CS_GNU_LIBC_VERSIONN)�os�confstr�split�AttributeError�OSError�
ValueError)�_�versionrrr	rs
rcCsvzddl}Wntk
r"YdSX|�d�}z
|j}Wntk
rNYdSX|j|_|�}t|t�sr|�	d�}|S)z=Fallback implementation of glibc_version_string using ctypes.rN�ascii)
�ctypes�ImportErrorZCDLL�gnu_get_libc_versionrZc_char_pZrestype�
isinstance�str�decode)rZprocess_namespacer�version_strrrr	r&s



rcCsHt�d|�}|s$t�d|t�dSt|�d��|koFt|�d��|kS)Nz$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z=Expected glibc version with 2 components major.minor, got: %sF�major�minor)�re�match�warnings�warn�RuntimeWarning�int�group)r�required_major�
minimum_minor�mrrr	�check_glibc_versionFs���r(cCst�}|dkrdSt|||�S)NF)r
r()r%r&rrrr	�have_compatible_glibcWsr)cCst�}|dkrdSd|fSdS)z�Try to determine the glibc version

    Returns a tuple of strings (lib, version) which default to empty strings
    in case the lookup fails.
    N)�r*Zglibc)r
)Z
glibc_versionrrr	�libc_verpsr+)Z
__future__rrrr Zpip._internal.utils.typingr�typingrrr
rrr(r)r+rrrr	�<module>s site-packages/pip/_internal/utils/__pycache__/encoding.cpython-38.opt-1.pyc000064400000002337151446176770022603 0ustar00U

��.e(�@s�ddlZddlZddlZddlZddlmZerDddlmZmZm	Z	ej
dfejdfejdfej
dfejdfejd	fejd
fgZe�d�Zdd
�ZdS)�N)�MYPY_CHECK_RUNNING)�List�Tuple�Textzutf-8zutf-16z	utf-16-bez	utf-16-lezutf-32z	utf-32-bez	utf-32-lescoding[:=]\s*([-\w.]+)cCs�tD],\}}|�|�r|t|�d��|�Sq|�d�dd�D]D}|dd�dkrDt�|�rDt�|���d�d�}|�|�SqD|�t�	d�p�t
���S)	z�Check a bytes string for a BOM to correctly detect the encoding

    Fallback to locale.getpreferredencoding(False) like open() on Python3N�
�r��#�asciiF)�BOMS�
startswith�len�decode�split�ENCODING_RE�search�groups�localeZgetpreferredencoding�sys�getdefaultencoding)�dataZbom�encoding�line�r�@/usr/lib/python3.8/site-packages/pip/_internal/utils/encoding.py�auto_decodes
�r)�codecsr�rerZpip._internal.utils.typingr�typingrrr�BOM_UTF8�	BOM_UTF16�BOM_UTF16_BE�BOM_UTF16_LE�	BOM_UTF32�BOM_UTF32_BE�BOM_UTF32_LEr�compilerrrrrr�<module>s �

site-packages/pip/_internal/utils/__pycache__/ui.cpython-38.pyc000064400000027042151446176770020473 0ustar00U

��.eR6�@sxddlmZmZddlZddlZddlZddlZddlZddlm	Z	m
Z
mZddlmZddl
mZmZddlmZmZmZddlmZddlmZdd	lmZdd
lmZddlmZer�ddlmZm Z m!Z!zdd
lm"Z"Wne#k
r�dZ"YnXe�$e%�Z&dd�Z'e'ee�Z(Gdd�de)�Z*Gdd�de�Z+Gdd�de�Z,Gdd�de)�Z-Gdd�de)�Z.Gdd�de.e*e-�Z/Gdd�de/e(�Z0Gdd�de/e+�Z1Gd d!�d!e/e�Z2Gd"d#�d#e/e�Z3Gd$d%�d%e/e,�Z4Gd&d'�d'e.e*e-e�Z5e1e1fe0e5fe2e5fe3e5fe4e5fd(�Z6d7d)d*�Z7ej8d+d,��Z9Gd-d.�d.e)�Z:Gd/d0�d0e)�Z;Gd1d2�d2e;�Z<Gd3d4�d4e;�Z=ej8d5d6��Z>dS)8�)�absolute_import�divisionN)�SIGINT�default_int_handler�signal)�six)�HIDE_CURSOR�SHOW_CURSOR)�Bar�FillingCirclesBar�IncrementalBar)�Spinner)�WINDOWS)�get_indentation)�format_size)�MYPY_CHECK_RUNNING)�Any�Iterator�IO)�coloramacCs�t|jdd�}|s|St|dt���t|dt���g}|tt|dg��7}zt���|��|�Wntk
rz|YSX|SdS)N�encodingZ
empty_fillZfill�phases)�getattr�filerZ	text_type�list�join�encode�UnicodeEncodeError)Z	preferredZfallbackrZ
characters�r�:/usr/lib/python3.8/site-packages/pip/_internal/utils/ui.py�_select_progress_class%s�
r cs4eZdZdZ�fdd�Z�fdd�Zdd�Z�ZS)�InterruptibleMixina�
    Helper to ensure that self.finish() gets called on keyboard interrupt.

    This allows downloads to be interrupted without leaving temporary state
    (like hidden cursors) behind.

    This class is similar to the progress library's existing SigIntMixin
    helper, but as of version 1.2, that helper has the following problems:

    1. It calls sys.exit().
    2. It discards the existing SIGINT handler completely.
    3. It leaves its own handler in place even after an uninterrupted finish,
       which will have unexpected delayed effects if the user triggers an
       unrelated keyboard interrupt some time after a progress-displaying
       download has already completed, for example.
    cs4tt|�j||�tt|j�|_|jdkr0t|_dS)z=
        Save the original SIGINT handler for later.
        N)�superr!�__init__rr�
handle_sigint�original_handlerr��self�args�kwargs��	__class__rrr#Us
zInterruptibleMixin.__init__cstt|���tt|j�dS)z�
        Restore the original SIGINT handler after finishing.

        This should happen regardless of whether the progress display finishes
        normally, or gets interrupted.
        N)r"r!�finishrrr%�r'r*rrr,eszInterruptibleMixin.finishcCs|��|�||�dS)z�
        Call self.finish() before delegating to the original SIGINT handler.

        This handler should only be in place while the progress display is
        active.
        N)r,r%)r'Zsignum�framerrrr$osz InterruptibleMixin.handle_sigint)�__name__�
__module__�__qualname__�__doc__r#r,r$�
__classcell__rrr*rr!Cs
r!c@seZdZdd�ZdS)�	SilentBarcCsdS�Nrr-rrr�update|szSilentBar.updateN)r/r0r1r6rrrrr4zsr4c@seZdZdZdZdZdZdS)�BlueEmojiBar�
%(percent)d%%� )u🔹u🔷u🔵N)r/r0r1�suffixZ
bar_prefixZ
bar_suffixrrrrrr7�sr7csJeZdZ�fdd�Zedd��Zedd��Zedd��Zdd
d�Z�Z	S)
�DownloadProgressMixincs,tt|�j||�dt�d|j|_dS)Nr9�)r"r;r#r�messager&r*rrr#�szDownloadProgressMixin.__init__cCs
t|j�Sr5)r�indexr-rrr�
downloaded�sz DownloadProgressMixin.downloadedcCs |jdkrdStd|j�dS)Ngz...�z/s)Zavgrr-rrr�download_speed�s
z$DownloadProgressMixin.download_speedcCs|jrd|jSdS)Nzeta %s�)ZetaZeta_tdr-rrr�
pretty_eta�s
z DownloadProgressMixin.pretty_etar@ccs&|D]}|V|�|�q|��dSr5)�nextr,)r'�it�n�xrrr�iter�szDownloadProgressMixin.iter)r@)
r/r0r1r#�propertyr?rArCrHr3rrr*rr;�s


r;cseZdZ�fdd�Z�ZS)�WindowsMixincs\tr�jrd�_tt��j||�trXtrXt��j��_�fdd��j_�fdd��j_	dS)NFcs�jj��Sr5)r�wrapped�isattyrr-rr�<lambda>��z'WindowsMixin.__init__.<locals>.<lambda>cs�jj��Sr5)rrK�flushrr-rrrM�rN)
rZhide_cursorr"rJr#rZAnsiToWin32rrLrOr&r*r-rr#�s
zWindowsMixin.__init__)r/r0r1r#r3rrr*rrJ�srJc@seZdZejZdZdZdS)�BaseDownloadProgressBarr8z0%(downloaded)s %(download_speed)s %(pretty_eta)sN)r/r0r1�sys�stdoutrr=r:rrrrrP�srPc@seZdZdS)�DefaultDownloadProgressBarN�r/r0r1rrrrrS�srSc@seZdZdS)�DownloadSilentBarNrTrrrrrU�srUc@seZdZdS)�DownloadBarNrTrrrrrV�srVc@seZdZdS)�DownloadFillingCirclesBarNrTrrrrrW�srWc@seZdZdS)�DownloadBlueEmojiProgressBarNrTrrrrrX�srXc@s&eZdZejZdZdd�Zdd�ZdS)�DownloadProgressSpinnerz!%(downloaded)s %(download_speed)scCs"t|d�st�|j�|_t|j�S)N�_phaser)�hasattr�	itertools�cyclerrZrDr-rrr�
next_phase�s
z"DownloadProgressSpinner.next_phasecCsN|j|}|��}|j|}d�||r*dnd||r6dnd|g�}|�|�dS)NrBr9)r=r^r:rZwriteln)r'r=Zphaser:�linerrrr6�s



�zDownloadProgressSpinner.updateN)	r/r0r1rQrRrr:r^r6rrrrrY�srY)ZoffZon�asciiZprettyZemojicCs8|dks|dkr t|d�jSt|d|d�jSdS)Nrr@)�max)�	BAR_TYPESrH)Zprogress_barrarrr�DownloadProgressProvider	srcc	csPtrdVn@|��r"t��tjkr*dVn"|�t�z
dVW5|�t�XdSr5)	rrL�logger�getEffectiveLevel�logging�INFO�writerr	)rrrr�
hidden_cursors

ric@s$eZdZdd�Zdd�Zdd�ZdS)�RateLimitercCs||_d|_dS)Nr)�_min_update_interval_seconds�_last_update)r'�min_update_interval_secondsrrrr#-szRateLimiter.__init__cCst��}||j}||jkSr5)�timerlrk)r'ZnowZdeltarrr�ready2s
zRateLimiter.readycCst��|_dSr5)rnrlr-rrr�reset8szRateLimiter.resetN)r/r0r1r#rorprrrrrj,srjc@seZdZdd�Zdd�ZdS)�SpinnerInterfacecCs
t��dSr5��NotImplementedErrorr-rrr�spin>szSpinnerInterface.spincCs
t��dSr5rr�r'Zfinal_statusrrrr,BszSpinnerInterface.finishN)r/r0r1rtr,rrrrrq=srqc@s.eZdZddd�Zdd�Zdd	�Zd
d�ZdS)
�InteractiveSpinnerN�-\|/��?cCs\||_|dkrtj}||_t|�|_d|_t�|�|_	|j�
dt�|jd�d|_dS)NFr9z ... r)
�_messagerQrR�_filerj�
_rate_limiter�	_finishedr\r]�_spin_cyclerhr�_width)r'r=rZ
spin_charsrmrrrr#Hs
zInteractiveSpinner.__init__cCs\|jr
t�d|j}|j�|d|j|�|j�|�t|�|_|j��|j��dS)N�r9)	r|�AssertionErrorr~rzrh�lenrOr{rp)r'�statusZbackuprrr�_writeWs



zInteractiveSpinner._writecCs,|jr
dS|j��sdS|�t|j��dSr5)r|r{ror�rDr}r-rrrrtcs

zInteractiveSpinner.spincCs4|jr
dS|�|�|j�d�|j��d|_dS)N�
T)r|r�rzrhrOrurrrr,ks

zInteractiveSpinner.finish)Nrwrx)r/r0r1r#r�rtr,rrrrrvGs�
rvc@s.eZdZddd�Zdd�Zdd�Zdd	�Zd
S)�NonInteractiveSpinner�<cCs$||_d|_t|�|_|�d�dS)NFZstarted)ryr|rjr{�_update)r'r=rmrrrr#zs
zNonInteractiveSpinner.__init__cCs(|jr
t�|j��t�d|j|�dS)Nz%s: %s)r|r�r{rprd�infory)r'r�rrrr��s

zNonInteractiveSpinner._updatecCs&|jr
dS|j��sdS|�d�dS)Nzstill running...)r|r{ror�r-rrrrt�s

zNonInteractiveSpinner.spincCs$|jr
dS|�d|f�d|_dS)Nzfinished with status '%s'T)r|r�rurrrr,�szNonInteractiveSpinner.finishN)r�)r/r0r1r#r�rtr,rrrrr�ys
r�c	cs�tj��r"t��tjkr"t|�}nt|�}z t	tj��|VW5QRXWn>t
k
rj|�d��Yn*tk
r�|�d��YnX|�d�dS)NZcanceled�errorZdone)
rQrRrLrdrerfrgrvr�ri�KeyboardInterruptr,�	Exception)r=Zspinnerrrr�open_spinner�s


r�)N)?Z
__future__rr�
contextlibr\rfrQrnrrrZpip._vendorrZpip._vendor.progressrr	Zpip._vendor.progress.barr
rrZpip._vendor.progress.spinnerr
Zpip._internal.utils.compatrZpip._internal.utils.loggingrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingrrrrr�Z	getLoggerr/rdr Z_BaseBar�objectr!r4r7r;rJrPrSrUrVrWrXrYrbrc�contextmanagerrirjrqrvr�r�rrrr�<module>s~


7�������	


2site-packages/pip/_internal/utils/__pycache__/appdirs.cpython-38.pyc000064400000017553151446176770021526 0ustar00U

��.e&&�@s�dZddlmZddlZddlZddlmZmZddlm	Z	m
Z
ddlmZer\ddl
mZdd	�Zddd�Zddd�Zdd�Zdd�Zdd�Ze	r�zddlZeZWnek
r�eZYnXdd�ZdS)zd
This code was taken from https://github.com/ActiveState/appdirs and modified
to suit our purposes.
�)�absolute_importN)�PY2�	text_type)�WINDOWS�
expanduser)�MYPY_CHECK_RUNNING)�ListcCs�tr<tj�td��}tr*t|t�r*t|�}tj�	||d�}n@t
jdkr^td�}tj�	||�}nt�
dtd��}tj�	||�}|S)a5
    Return full path to the user-specific cache dir for this application.

        "appname" is the name of application.

    Typical user cache directories are:
        macOS:      ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Windows:    C:\Users\<username>\AppData\Local\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go
    in the `CSIDL_LOCAL_APPDATA` directory. This is identical to the
    non-roaming app data dir (the default returned by `user_data_dir`). Apps
    typically put cache data somewhere *under* the given dir here. Some
    examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0

    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    �CSIDL_LOCAL_APPDATAZCache�darwinz~/Library/CachesZXDG_CACHE_HOMEz~/.cache)r�os�path�normpath�_get_win_folderr�
isinstancer�_win_path_to_bytes�join�sys�platformr�getenv)�appnamer�r�?/usr/lib/python3.8/site-packages/pip/_internal/utils/appdirs.py�user_cache_dirs
rFcCs�tr,|rdpd}tj�tj�t|��|�}ndtjdkrvtj�tj�t	d�|��rbtj�t	d�|�ntj�t	d�|�}ntj�t�
dt	d��|�}|S)a�
    Return full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  ~/Library/Application Support/<AppName>
                                if it exists, else ~/.config/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in
                                $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\ ...
                                ...Application Data\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local ...
                                ...Settings\Application Data\<AppName>
        Win 7  (not roaming):   C:\\Users\<username>\AppData\Local\<AppName>
        Win 7  (roaming):       C:\\Users\<username>\AppData\Roaming\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    �
CSIDL_APPDATAr	r
z~/Library/Application Support/z
~/.config/Z
XDG_DATA_HOMEz~/.local/share)rrrrr
rrr�isdirrr)r�roaming�constrrrr�
user_data_dirHs,
������rTcCsHtrt||d�}n2tjdkr&t|�}nt�dtd��}tj�||�}|S)arReturn full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default True) can be set False to not use the
            Windows roaming appdata directory. That means that for users on a
            Windows network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  same as user_data_dir
        Unix:                   ~/.config/<AppName>
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    )rr
ZXDG_CONFIG_HOMEz	~/.config)	rrrrrrrrr)rrrrrr�user_config_dir}s

rcs�tr&tj�td��}tj�|��g}nVtjdkrBtj�d��g}n:t�dd�}|rn�fdd�|�	tj
�D�}ng}|�d�|S)	a�Return a list of potential user-shared config dirs for this application.

        "appname" is the name of application.

    Typical user config directories are:
        macOS:      /Library/Application Support/<AppName>/
        Unix:       /etc or $XDG_CONFIG_DIRS[i]/<AppName>/ for each value in
                    $XDG_CONFIG_DIRS
        Win XP:     C:\Documents and Settings\All Users\Application ...
                    ...Data\<AppName>\
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory
                    on Vista.)
        Win 7:      Hidden, but writeable on Win 7:
                    C:\ProgramData\<AppName>\
    �CSIDL_COMMON_APPDATAr
z/Library/Application SupportZXDG_CONFIG_DIRSz/etc/xdgcsg|]}tj�t|����qSr)rrrr)�.0�x�rrr�
<listcomp>�s�z$site_config_dirs.<locals>.<listcomp>z/etc)rrrr
rrrrr�split�pathsep�append)rrZpathlistZxdg_config_dirsrr"r�site_config_dirs�s


�
r'cCs:ddl}dddd�|}|�|jd�}|�||�\}}|S)z�
    This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    rNZAppDatazCommon AppDataz
Local AppData�rrr	z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)�_winreg�OpenKey�HKEY_CURRENT_USERZQueryValueEx)�
csidl_namer)Zshell_folder_name�keyZ	directoryZ_typerrr�_get_win_folder_from_registry�s���r.cCs�dddd�|}t�d�}tj}|j�d|dd|�d}|D]}t|�dkr<d	}qVq<|rzt�d�}|j�|j|d�rz|}|jS)
N��#�r(irF�T)	�ctypesZcreate_unicode_buffer�windllZshell32ZSHGetFolderPathW�ordZkernel32ZGetShortPathNameW�value)r,Zcsidl_constZbufr4Z
has_high_char�cZbuf2rrr�_get_win_folder_with_ctypes�s&��

r8c
Cs8dD].}z|�|�WSttfk
r0YqXq|S)a�Encode Windows paths to bytes. Only used on Python 2.

    Motivation is to be consistent with other operating systems where paths
    are also returned as bytes. This avoids problems mixing bytes and Unicode
    elsewhere in the codebase. For more details and discussion see
    <https://github.com/pypa/pip/issues/3463>.

    If encoding using ASCII and MBCS fails, return the original Unicode path.
    )�ASCIIZMBCS)�encode�UnicodeEncodeError�LookupError)r�encodingrrrrs
r)F)T)�__doc__Z
__future__rrrZpip._vendor.sixrrZpip._internal.utils.compatrrZpip._internal.utils.typingr�typingrrrrr'r.r8r3r�ImportErrorrrrrr�<module>s*1
5
")
site-packages/pip/_internal/utils/__pycache__/deprecation.cpython-38.opt-1.pyc000064400000005412151446176770023307 0ustar00U

��.e��@s�dZddlmZddlZddlZddlmZddlmZ	ddl
mZerXddlm
Z
mZdZGd	d
�d
e�Zdaddd�Zd
d�Zddd�ZdS)zN
A module that implements tooling to enable easy warnings about deprecations.
�)�absolute_importN)�parse)�__version__)�MYPY_CHECK_RUNNING)�Any�Optionalz
DEPRECATION: c@seZdZdS)�PipDeprecationWarningN)�__name__�
__module__�__qualname__�rr�C/usr/lib/python3.8/site-packages/pip/_internal/utils/deprecation.pyrsrcCsZ|dk	r$tdk	rVt||||||�n2t|t�rDt�d�}|�|�nt||||||�dS)Nzpip._internal.deprecations)�_original_showwarning�
issubclassr�loggingZ	getLoggerZwarning)�message�category�filename�lineno�file�lineZloggerrrr
�_showwarning!s*�

�rcCs(tjdtdd�tdkr$tjatt_dS)N�defaultT)�append)�warnings�simplefilterrr�showwarningrrrrr
�install_warning_logger2srcCsh|tdf|df|df|dfg}d�dd�|D��}|dk	rTtt�t|�krTt|��tj|td	d
�dS)a�Helper to deprecate existing functionality.

    reason:
        Textual reason shown to the user about why this functionality has
        been deprecated.
    replacement:
        Textual suggestion shown to the user about what alternative
        functionality they can use.
    gone_in:
        The version of pip does this functionality should get removed in.
        Raises errors if pip's current version is greater than or equal to
        this.
    issue:
        Issue number on the tracker that would serve as a useful place for
        users to find related discussion and provide feedback.

    Always pass replacement, gone_in and issue as keyword arguments for clarity
    at the call site.
    z{}z2pip {} will remove support for this functionality.zA possible replacement is {}.zPYou can find discussion regarding this at https://github.com/pypa/pip/issues/{}.� css$|]\}}|dk	r|�|�VqdS)N)�format)�.0�val�templaterrr
�	<genexpr>`szdeprecated.<locals>.<genexpr>N�)r�
stacklevel)�DEPRECATION_MSG_PREFIX�joinr�current_versionrr�warn)�reasonZreplacementZgone_inZissueZ	sentencesrrrr
�
deprecated>s
��	
�r+)NN)N)�__doc__Z
__future__rrrZpip._vendor.packaging.versionrZpiprr(Zpip._internal.utils.typingr�typingrrr&�Warningrrrrr+rrrr
�<module>s
site-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-38.opt-1.pyc000064400000001556151446176770023216 0ustar00U

��.e{�@s,ddlZddlZddlZdd�Zdd�ZdS)�NcCs*ttd�rdStjttdtj�kr&dSdS)zM
    Return True if we're running inside a virtualenv, False otherwise.

    Zreal_prefixT�base_prefixF)�hasattr�sys�prefix�getattr�rr�B/usr/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py�running_under_virtualenvs

r	cCsBtj�tj�tj��}tj�|d�}t�r:tj�|�r:dSdSdS)z?
    Return True if in a venv and no system site packages.
    zno-global-site-packages.txtTFN)	�os�path�dirname�abspath�site�__file__�joinr	�isfile)Zsite_mod_dirZno_global_filerrr�virtualenv_no_globals
r)Zos.pathr
rrr	rrrrr�<module>ssite-packages/pip/_internal/utils/__pycache__/marker_files.cpython-38.opt-1.pyc000064400000001640151446176770023454 0ustar00U

��.e7�@s$ddlZdZdZdd�Zdd�ZdS)�Nz�This file is placed here by pip to indicate the source was put
here by pip.

Once this package is successfully installed this source code will be
deleted (unless you remove this file).
zpip-delete-this-directory.txtcCstj�tj�|t��S)N)�os�path�exists�join�PIP_DELETE_MARKER_FILENAME)�	directory�r�D/usr/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py�has_delete_marker_filesr
c	Cs2tj�|t�}t|d��}|�t�W5QRXdS)z?
    Write the pip delete marker file into this directory.
    �wN)rrrr�open�write�DELETE_MARKER_MESSAGE)r�filepathZ	marker_fprrr	�write_delete_marker_filesr)Zos.pathrrrr
rrrrr	�<module>ssite-packages/pip/_internal/utils/__pycache__/filesystem.cpython-38.pyc000064400000005325151446176770022242 0ustar00U

��.e
�@s�ddlZddlZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZddlmZer�dd	lmZmZGd
d�de�Zdd
�Zdd�Zdd�Zedd��Ze	ddd�Zer�edd��Zn
eej�ZdS)�N)�contextmanager)�NamedTemporaryFile)�retry)�PY2)�get_path_uid)�cast)�MYPY_CHECK_RUNNING)�BinaryIO�Iteratorc@seZdZedd��ZdS)�NamedTemporaryFileResultcCsdS�N�)�selfr
r
�B/usr/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py�fileszNamedTemporaryFileResult.fileN)�__name__�
__module__�__qualname__�propertyrr
r
r
rrsrcCs�ttd�sdSd}||kr�tj�|�rnt��dkr^zt|�}Wntk
rTYdSX|dkSt�|tj�Sq|tj�	|�}}qdS)N�geteuidTrF)
�hasattr�os�path�lexistsrr�OSError�access�W_OK�dirname)rZpreviousZpath_uidr
r
r�check_path_owners
rcCsrzt�||�Wn\ttfk
rl||fD]8}zt|�}Wntk
rPYq,X|r,t�d|��q,�YnXdS)z�Wrap shutil.copy2() but map errors copying socket files to
    SpecialFileError as expected.

    See also https://bugs.python.org/issue37700.
    z`%s` is a socketN)�shutilZcopy2r�IOError�	is_socketZSpecialFileError)�src�dest�fZis_socket_filer
r
r�copy2_fixed5sr%cCst�t�|�j�Sr)�stat�S_ISSOCKr�lstat�st_mode)rr
r
rr!Msr!ccsbtdtj�|�tj�|�dd��8}td|�}z
|VW5|j��t�|j�	��XW5QRXdS)z�Given a path to a file, open a temp file next to it securely and ensure
    it is written to disk after the context reaches its end.
    Fz.tmp)�delete�dir�prefix�suffixrN)
rrrr�basenamerr�flush�fsync�fileno)rr$�resultr
r
r�adjacent_tmp_fileRs

�


r3i��)Zstop_max_delayZ
wait_fixedcCs@zt�||�Wn*tk
r:t�|�t�||�YnXdSr)r�renamer�remove)r"r#r
r
r�replaceis

r7)rZos.pathrr&�
contextlibrZtempfilerZpip._vendor.retryingrZpip._vendor.sixrZpip._internal.utils.compatrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingr	r
rrr%r!r3Z_replace_retryr7r
r
r
r�<module>s.
	site-packages/pip/_internal/utils/__pycache__/filesystem.cpython-38.opt-1.pyc000064400000005325151446176770023201 0ustar00U

��.e
�@s�ddlZddlZddlZddlZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZddlmZer�dd	lmZmZGd
d�de�Zdd
�Zdd�Zdd�Zedd��Ze	ddd�Zer�edd��Zn
eej�ZdS)�N)�contextmanager)�NamedTemporaryFile)�retry)�PY2)�get_path_uid)�cast)�MYPY_CHECK_RUNNING)�BinaryIO�Iteratorc@seZdZedd��ZdS)�NamedTemporaryFileResultcCsdS�N�)�selfr
r
�B/usr/lib/python3.8/site-packages/pip/_internal/utils/filesystem.py�fileszNamedTemporaryFileResult.fileN)�__name__�
__module__�__qualname__�propertyrr
r
r
rrsrcCs�ttd�sdSd}||kr�tj�|�rnt��dkr^zt|�}Wntk
rTYdSX|dkSt�|tj�Sq|tj�	|�}}qdS)N�geteuidTrF)
�hasattr�os�path�lexistsrr�OSError�access�W_OK�dirname)rZpreviousZpath_uidr
r
r�check_path_owners
rcCsrzt�||�Wn\ttfk
rl||fD]8}zt|�}Wntk
rPYq,X|r,t�d|��q,�YnXdS)z�Wrap shutil.copy2() but map errors copying socket files to
    SpecialFileError as expected.

    See also https://bugs.python.org/issue37700.
    z`%s` is a socketN)�shutilZcopy2r�IOError�	is_socketZSpecialFileError)�src�dest�fZis_socket_filer
r
r�copy2_fixed5sr%cCst�t�|�j�Sr)�stat�S_ISSOCKr�lstat�st_mode)rr
r
rr!Msr!ccsbtdtj�|�tj�|�dd��8}td|�}z
|VW5|j��t�|j�	��XW5QRXdS)z�Given a path to a file, open a temp file next to it securely and ensure
    it is written to disk after the context reaches its end.
    Fz.tmp)�delete�dir�prefix�suffixrN)
rrrr�basenamerr�flush�fsync�fileno)rr$�resultr
r
r�adjacent_tmp_fileRs

�


r3i��)Zstop_max_delayZ
wait_fixedcCs@zt�||�Wn*tk
r:t�|�t�||�YnXdSr)r�renamer�remove)r"r#r
r
r�replaceis

r7)rZos.pathrr&�
contextlibrZtempfilerZpip._vendor.retryingrZpip._vendor.sixrZpip._internal.utils.compatrZpip._internal.utils.miscrZpip._internal.utils.typingr�typingr	r
rrr%r!r3Z_replace_retryr7r
r
r
r�<module>s.
	site-packages/pip/_internal/utils/__pycache__/inject_securetransport.cpython-38.opt-1.pyc000064400000001644151446176770025614 0ustar00U

��.e*�@sdZddlZdd�Ze�dS)a-A helper module that injects SecureTransport, on import.

The import should be done as early as possible, to ensure all requests and
sessions (or whatever) are created after injecting SecureTransport.

Note that we only do the injection on macOS, when the linked OpenSSL is too
old to handle TLSv1.2.
�Nc	CsxtjdkrdSzddl}Wntk
r0YdSX|jdkr@dSzddlm}Wnttfk
rjYdSX|��dS)N�darwinri)�securetransport)	�sys�platform�ssl�ImportErrorZOPENSSL_VERSION_NUMBERZpip._vendor.urllib3.contribr�OSErrorZinject_into_urllib3)rr�r	�N/usr/lib/python3.8/site-packages/pip/_internal/utils/inject_securetransport.py�inject_securetransport
s

r)�__doc__rrr	r	r	r
�<module>s	site-packages/pip/_internal/utils/__pycache__/urls.cpython-38.pyc000064400000002671151446176770021044 0ustar00U

��.e��@shddlZddlZddlmZddlmZddlmZerLddl	m
Z
mZmZdd�Z
dd	�Zd
d�ZdS)�N)�parse)�request)�MYPY_CHECK_RUNNING)�Optional�Text�UnioncCs d|krdS|�dd�d��S)N�:�r)�split�lower)�url�r
�</usr/lib/python3.8/site-packages/pip/_internal/utils/urls.py�get_url_scheme
srcCs*tj�tj�|��}t�dt�|��}|S)zh
    Convert a path to a file: URL.  The path will be made absolute and have
    quoted path parts.
    �file:)�os�path�normpath�abspath�urllib_parseZurljoin�urllib_requestZpathname2url)rrr
r
r�path_to_urlsrcCsn|�d�std|��t�|�\}}}}}|r6|dkr<d}n tjdkrPd|}ntd|��t�||�}|S)z(
    Convert a file: URL to a path.
    rz4You can only turn file: urls into filenames (not %r)Z	localhost�Zwin32z\\z:non-local file URIs are not supported on this platform: %r)	�
startswith�AssertionErrorrZurlsplit�sys�platform�
ValueErrorrZurl2pathname)r�_Znetlocrr
r
r�url_to_paths�

��r)rrZpip._vendor.six.moves.urllibrrrrZpip._internal.utils.typingr�typingrrrrrrr
r
r
r�<module>ssite-packages/pip/_internal/utils/__pycache__/virtualenv.cpython-38.pyc000064400000001556151446176770022257 0ustar00U

��.e{�@s,ddlZddlZddlZdd�Zdd�ZdS)�NcCs*ttd�rdStjttdtj�kr&dSdS)zM
    Return True if we're running inside a virtualenv, False otherwise.

    Zreal_prefixT�base_prefixF)�hasattr�sys�prefix�getattr�rr�B/usr/lib/python3.8/site-packages/pip/_internal/utils/virtualenv.py�running_under_virtualenvs

r	cCsBtj�tj�tj��}tj�|d�}t�r:tj�|�r:dSdSdS)z?
    Return True if in a venv and no system site packages.
    zno-global-site-packages.txtTFN)	�os�path�dirname�abspath�site�__file__�joinr	�isfile)Zsite_mod_dirZno_global_filerrr�virtualenv_no_globals
r)Zos.pathr
rrr	rrrrr�<module>ssite-packages/pip/_internal/utils/__pycache__/compat.cpython-38.opt-1.pyc000064400000015267151446176770022306 0ustar00U

��.e]%�@s~dZddlmZmZddlZddlZddlZddlZddlZddl	Z	ddl
mZmZddl
mZddlmZer�ddlmZmZmZmZzddlZWnek
r�dZYnXeZzddlZWnVek
�rzddlmZWn.ek
�rddlZeje_eje_YnXYnXd	d
ddd
dddddg
Z e�!e"�Z#edk	�pDeZ$e�r�ddl%Z%z
e%j&Z&Wne'k
�rxdZ&YnXe&dk	Z(ndZ(ddl)m&Z&e�r�dd�Z*e�+de*�dZ,ndZ,d/dd�Z-dd�Z.e�r�d0dd�Z/n
d1dd�Z/dd
�Z0e�r
dd l%m1Z1d!d�Z2ndd"l3m4Z4d#d�Z2d$d%�Z5d&d'd(hZ6e	j7�8d)��pRe	j7d*k�oRej9d+kZ:d,d�Z;e<ed��rrd-d�Z=nd.d�Z=dS)2zKStuff that differs in different Python versions and platform
distributions.�)�absolute_import�divisionN)�PY2�	text_type)�IS_PYOPENSSL)�MYPY_CHECK_RUNNING)�Optional�Text�Tuple�Union)�	ipaddressr�uses_pycache�console_to_str�
native_str�get_path_uid�stdlib_pkgs�WINDOWS�samefile�get_terminal_size�get_extension_suffixesT)�cache_from_sourcecsD�fdd�t�j�j�D�}dd�|D�}d�dd�|D���jfS)Nc3s|]}�j|VqdS�N)�object)�.0�i��err��>/usr/lib/python3.8/site-packages/pip/_internal/utils/compat.py�	<genexpr>Lsz-backslashreplace_decode_fn.<locals>.<genexpr>css|]}t|�VqdSr)�ord)r�brrrrNs�css|]}d|VqdS)z\x%xNr)r�crrrrOs)�range�start�end�join)rZ	raw_bytesrrr�backslashreplace_decode_fnKsr(�backslashreplace_decode�backslashreplacecCs�t|t�r|St��}|r*t�|�jdkr.d}z|�|�}WnDtk
r�|dkrXd}d�	|�}t
�||�|j|td�}YnXt
t
tdd�dd�}|r�|j|d	d�}|�|�}|S)
a�
    For display or logging purposes, convert a bytes object (or text) to
    text (e.g. unicode in Python 2) safe for output.

    :param desc: An optional phrase describing the input data, for use in
        the log message if a warning is logged. Defaults to "Bytes object".

    This function should never error out and so can take a best effort
    approach. It is okay to be lossy if needed since the return value is
    just for display.

    We assume the data is in the locale preferred encoding. If it won't
    decode properly, we warn the user but decode as best we can.

    We also ensure that the output can be safely written to standard output
    without encoding errors.
    �ascii�utf-8NzBytes objectz&{} does not appear to be encoded as %s)�errors�
__stderr__�encodingr*)�
isinstancer�localeZgetpreferredencoding�codecs�lookup�name�decode�UnicodeDecodeError�format�loggerZwarningr)�getattr�sys�encode)�data�descr/Zdecoded_dataZ
msg_formatZoutput_encodingZoutput_encodedrrr�str_to_displayYs0

��
r>cCst|dd�S)z<Return a string, safe for output, of subprocess output.
    zSubprocess output)r=)r>)r<rrrr�sFcCst|t�r|�d�S|S)Nr,)r0rr;��s�replacerrrr�s

cCs"t|t�r|�d|rdnd�S|S)Nr,rA�strict)r0�bytesr5r?rrrr�s
cCs`ttd�r6t�|tjtjB�}t�|�j}t�|�n&tj�	|�sPt�
|�j}ntd|��|S)a)
    Return path's uid.

    Does not follow symlinks:
        https://github.com/pypa/pip/pull/935#discussion_r5307003

    Placed this function in compat due to differences on AIX and
    Jython, that should eventually go away.

    :raises OSError: When path is a symlink or can't be read.
    �
O_NOFOLLOWz1%s is a symlink; Will not return uid for symlinks)�hasattr�os�open�O_RDONLYrD�fstat�st_uid�close�path�islink�stat�OSError)rL�fdZfile_uidrrrr�s
���get_suffixescCsdd�t�D�S)NcSsg|]}|d�qS)rr)r�suffixrrr�
<listcomp>�sz*get_extension_suffixes.<locals>.<listcomp>rQrrrrr�s��EXTENSION_SUFFIXEScCstSrrUrrrrr�scCs0tj�|�}|�d�r,|�d�r,|dd�}|S)zm
    Expand ~ and ~user constructions.

    Includes a workaround for https://bugs.python.org/issue14768
    z~/z//�N)rFrL�
expanduser�
startswith)rLZexpandedrrrrX�srX�pythonZwsgiref�argparse�winZcli�ntcCsNttjd�rtj�||�Stj�tj�|��}tj�tj�|��}||kSdS)z>Provide an alternative for os.path.samefile on Windows/Python2rN)rErFrLr�normcase�abspath)Zfile1Zfile2Zpath1Zpath2rrrr�s
cCstt���S)��
        Returns a tuple (x, y) representing the width(x) and the height(y)
        in characters of the terminal window.
        )�tuple�shutilrrrrrrscCs�dd�}|d�p|d�p|d�}|sbz(t�t��tj�}||�}t�|�Wntk
r`YnX|s�tj�dd�tj�dd	�f}t|d�t|d�fS)
r`cSs\z4ddl}ddl}ddl}|�d|�||jd��}Wntk
rJYdSX|dkrXdS|S)NrZhhZ12345678)rr)�fcntl�termios�struct�unpack_fromZioctlZ
TIOCGWINSZ�	Exception)rPrcrdre�crrrr�ioctl_GWINSZs�z'get_terminal_size.<locals>.ioctl_GWINSZrrW�ZLINES�ZCOLUMNS�P)	rFrG�ctermidrHrKrg�environ�get�int)rirhrPrrrrs)N)F)F)>�__doc__Z
__future__rrr2r1ZloggingrFrbr:Zpip._vendor.sixrrZpip._vendor.urllib3.utilrZpip._internal.utils.typingr�typingrr	r
rZ_ssl�ImportErrorZsslrZpip._vendorZipaddrZ	IPAddressZ
ip_addressZ	IPNetworkZ
ip_network�__all__Z	getLogger�__name__r8ZHAS_TLSZimpr�AttributeErrorr
�importlib.utilr(�register_errorr)r>rrrrRrZimportlib.machineryrVrXr�platformrYr4rrrErrrrr�<module>s�
�



�
B


�
site-packages/pip/_internal/utils/__pycache__/logging.cpython-38.opt-1.pyc000064400000021707151446176770022445 0ustar00U

��.e�2�@s�ddlmZddlZddlZddlZddlZddlZddlZddlmZm	Z	ddl
mZddlm
Z
ddlmZddlmZzddlZWnek
r�ddlZYnXzddlmZWnek
r�dZYnXdd	lmZeZe��Zde_e	d
�ZGdd�de�Ze
�r&e�rd
d�Z ndd�Z ne�r6dd�Z ndd�Z ej!d%dd��Z"dd�Z#Gdd�dej$�Z%dd�Z&Gdd�dej'�Z(Gdd�dej)j*�Z+Gdd �d e�Z,Gd!d"�d"e�Z-d#d$�Z.dS)&�)�absolute_importN)�Filter�	getLogger)�PY2)�WINDOWS)�DEPRECATION_MSG_PREFIX)�
ensure_dir)�colorama)�Forezpip.subprocessorc@seZdZdZdS)�BrokenStdoutLoggingErrorzO
    Raised if BrokenPipeError occurs for the stdout stream while logging.
    N)�__name__�
__module__�__qualname__�__doc__�rr�?/usr/lib/python3.8/site-packages/pip/_internal/utils/logging.pyr;srcCs|tko|jtjtjfkS�z1See the docstring for non-Windows Python 3 below.)�IOError�errno�EINVAL�EPIPE��	exc_class�excrrr�_is_broken_pipe_errorIs�rcCs"|tkp |tko |jtjtjfkSr)�BrokenPipeError�OSErrorrrrrrrrrOs�cCs|tko|jtjkSr)rrrrrrrrUscCs|tkS)z�
        Return whether an exception is a broken pipe error.

        Args:
          exc_class: an exception class.
          exc: an exception instance.
        )rrrrrrZs�c	cs.tj|7_z
dVW5tj|8_XdS)zv
    A context manager which will cause the log output to be indented for any
    log messages emitted inside it.
    N)�
_log_state�indentation)Znumrrr�
indent_loges
r cCsttdd�S)Nrr)�getattrrrrrr�get_indentationrsr"cs0eZdZ�fdd�Zdd�Z�fdd�Z�ZS)�IndentingFormattercs$|�dd�|_tt|�j||�dS)z�
        A logging.Formatter that obeys the indent_log() context manager.

        :param add_timestamp: A bool indicating output lines should be prefixed
            with their record's timestamp.
        �
add_timestampFN)�popr$�superr#�__init__)�self�args�kwargs��	__class__rrr'xszIndentingFormatter.__init__cCs.|tjkrdS|�t�rdS|tjkr*dSdS)zv
        Return the start of the formatted log message (not counting the
        prefix to add to each line).
        �z	WARNING: zERROR: )�logging�WARNING�
startswithr�ERROR)r(�	formatted�levelnorrr�get_message_start�s


z$IndentingFormatter.get_message_startcsztt|��|�}|�||j�}||}d�|jrJ|�|d�}d||jf��dt�7�d�	�fdd�|�
d�D��}|S)z�
        Calls the standard formatter, but will indent all of the log message
        lines by our current indentation level.
        r-z%Y-%m-%dT%H:%M:%Sz%s,%03d � csg|]}�|�qSrr)�.0�line��prefixrr�
<listcomp>�s�z-IndentingFormatter.format.<locals>.<listcomp>T)r&r#�formatr4r3r$Z
formatTimeZmsecsr"�join�
splitlines)r(�recordr2Z
message_start�tr+r8rr;�s�zIndentingFormatter.format)rr
rr'r4r;�
__classcell__rrr+rr#vs
r#cs�fdd�}|S)Ncsd�t��|tjjg�S)Nr-)r<�listr	ZStyleZ	RESET_ALL)Zinp��colorsrr�wrapped�sz_color_wrap.<locals>.wrappedr)rCrDrrBr�_color_wrap�srEcsheZdZer.ejeej�fej	eej
�fgZngZddd�Zdd�Z
dd�Zdd	�Z�fd
d�Z�ZS)
�ColorizedStreamHandlerNcCs.tj�||�||_tr*tr*t�|j�|_dS�N)r.�
StreamHandlerr'�	_no_colorrr	�AnsiToWin32�stream)r(rK�no_colorrrrr'�szColorizedStreamHandler.__init__cCs"trtr|jjtjkS|jtjkS)zA
        Return whether the handler is using sys.stdout.
        )rr	rKrD�sys�stdout�r(rrr�
_using_stdout�sz$ColorizedStreamHandler._using_stdoutcCsXtr
|jrdSt|jtj�s"|jn|jj}t|d�r@|��r@dStj	�
d�dkrTdSdS)NF�isattyTZTERMZANSI)r	rI�
isinstancerKrJrD�hasattrrQ�os�environ�get)r(Zreal_streamrrr�should_color�s
�z#ColorizedStreamHandler.should_colorcCs@tj�||�}|��r<|jD]\}}|j|kr||�}q<q|SrG)r.rHr;rW�COLORSr3)r(r>�msg�levelZcolorrrrr;�s
zColorizedStreamHandler.formatcs@t��dd�\}}|r0|��r0t||�r0t��tt|��|�S)Nr)rM�exc_inforPrrr&rF�handleError)r(r>rrr+rrr\�s�z"ColorizedStreamHandler.handleError)NN)rr
rr	r.r1rEr
ZREDr/ZYELLOWrXr'rPrWr;r\r@rrr+rrF�s�

rFc@seZdZdd�ZdS)�BetterRotatingFileHandlercCs ttj�|j��tjj�|�SrG)	rrT�path�dirnameZbaseFilenamer.�handlers�RotatingFileHandler�_openrOrrrrb�szBetterRotatingFileHandler._openN)rr
rrbrrrrr]�sr]c@seZdZdd�Zdd�ZdS)�MaxLevelFiltercCs
||_dSrG)rZ)r(rZrrrr'szMaxLevelFilter.__init__cCs|j|jkSrG)r3rZ�r(r>rrr�filterszMaxLevelFilter.filterN)rr
rr'rerrrrrcsrccs eZdZdZ�fdd�Z�ZS)�ExcludeLoggerFilterzQ
    A logging Filter that excludes records from a logger (or its children).
    cstt|��|�SrG)r&rfrerdr+rrreszExcludeLoggerFilter.filter)rr
rrrer@rrr+rrf	srfcCsf|dkrd}n.|dkrd}n |dkr*d}n|dkr8d}nd	}tt|�}|d
k	}|r\|}d}nd}|}|dkrpdnd}d
dd�}	ddd�}
dddg|r�dgng}tj�dddtjd�dtjd�dtjd�d�tdd�tdd d!�d"�||
d#||	d$d%d&gd'd(�d|
d#||	d)d%gd'd(�||
d#||	d)d*gd'd(�d|
d+|d d,d-�d.�||d/�d0d1|iid2��|S)3znConfigures and sets up all of the logging

    Returns the requested logging level, as its integer value.
    ��DEBUG���r/���r1���ZCRITICAL�INFONz	/dev/null)rlr1zext://sys.stdoutzext://sys.stderr)rN�stderrz2pip._internal.utils.logging.ColorizedStreamHandlerz5pip._internal.utils.logging.BetterRotatingFileHandler)rK�file�console�console_errors�console_subprocess�user_logFz*pip._internal.utils.logging.MaxLevelFilter)�()rZzlogging.Filter)rs�namez/pip._internal.utils.logging.ExcludeLoggerFilter)�exclude_warnings�restrict_to_subprocess�exclude_subprocessz%(message)s)rsr;T)rsr;r$)�indent�indent_with_timestamprKrNrwrurx)rZ�classrLrK�filters�	formatterrmrvrnry)rZrz�filenameZdelayr|)rorprqrr)rZr`zpip._vendorrZ)�versionZdisable_existing_loggersr{Z
formattersr`�rootZloggers)r!r.ZconfigZ
dictConfigr/�subprocess_loggerrtr#)�	verbosityrLZ
user_log_filerZZlevel_numberZinclude_user_logZadditional_log_fileZ
root_levelZvendored_log_levelZlog_streamsZhandler_classesr`rrr�
setup_loggings�
����������
�	��	��$����Jr�)r)/Z
__future__r�
contextlibrr.Zlogging.handlersrTrMrrZpip._vendor.sixrZpip._internal.utils.compatrZpip._internal.utils.deprecationrZpip._internal.utils.miscrZ	threading�ImportErrorZdummy_threadingZpip._vendorr	Z	_colorama�	ExceptionZpip._vendor.coloramar
Zlocalrrr�rr�contextmanagerr r"Z	Formatterr#rErHrFr`rar]rcrfr�rrrr�<module>sT

		


2K	site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-38.pyc000064400000014055151446176770022035 0ustar00U

��.e�%�@sXdZddlmZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZm
Z
mZmZddlmZddlmZer�ddlmZmZmZmZmZe�e�Zee
ZzddlZee7ZWnek
r�e� d	�YnXzddl!Z!ee7ZWn ek
�re� d
�YnXdd�Z"d
d�Z#dd�Z$dd�Z%ddd�Z&dd�Z'ddd�Z(dS)zUtilities related archives.
�)�absolute_importN)�InstallationError)�BZ2_EXTENSIONS�TAR_EXTENSIONS�
XZ_EXTENSIONS�ZIP_EXTENSIONS)�
ensure_dir)�MYPY_CHECK_RUNNING)�Iterable�List�Optional�Text�Unionzbz2 module is not availablezlzma module is not availablecCst�d�}t�|�|S)zBGet the current umask which involves having to set it temporarily.r)�os�umask)�mask�r�A/usr/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py�
current_umask2s

rcCsh|�d��d�}d|krHd|kr4|�d�|�d�ks<d|krH|�dd�Sd|kr\|�dd�S|dgSdS)N�/�\��)�lstrip�find�split)�pathrrr�split_leading_dir9s����rcCsDd}|D]6}t|�\}}|s"dS|dkr0|}q||krdSqdS)zyReturns true if all the paths have the same leading path name
    (i.e., everything is in one subdirectory in an archive)NFT)r)�pathsZ
common_prefixr�prefix�restrrr�has_leading_dirIsr!cCs0tj�|�}tj�|�}tj�||g�}||kS)zL
    Return true if the absolute path of target is within the directory
    )rr�abspath�commonprefix)Z	directory�targetZ
abs_directoryZ
abs_targetrrrr�is_within_directoryYsr%TcCsFt|�t|d�}�z"tj|dd�}t|���o2|}|��D]�}|j}|}|rZt	|�d}t
j�||�}t
j�
|�}	t||�s�d}
t|
�|||���|�d�s�|�d�r�t|�q<t|	�|�|�}z&t|d��}
t�||
�W5QRXW5|��|jd?}|�r0t�|��r0|d	@�r0t
�|d
t�d	B�Xq<W5|��XdS)
a�
    Unzip the file (with path `filename`) to the destination `location`.  All
    files are written based on system defaults and umask (i.e. permissions are
    not preserved), except that regular file members with any execute
    permissions (user, group, or world) have "chmod +x" applied after being
    written. Note that for windows, any execute changes using os.chmod are
    no-ops per the python docs.
    �rbT)Z
allowZip64rzQThe zip file ({}) has a file ({}) trying to install outside target directory ({})rr��I��wbN)r�open�close�zipfileZZipFiler!ZnamelistZinfolist�filenamerrr�join�dirnamer%r�format�endswithZ
external_attr�stat�S_ISREG�chmodr�shutil�copyfileobj)r.�location�flattenZzipfp�zip�leading�info�name�fn�dir�message�fp�mode�destfprrr�
unzip_filees8


�


rDcCs\t|�|���d�s$|���d�r*d}nL|���t�r>d}n8|���t�rRd}n$|���d�rfd}nt�d|�d	}t�||�}�z�t
d
d�|��D��}|��D�]�}|j}|r�t
|�d}tj�||�}t||�s�d
}t|�|||���zt�|j|d�|�Wntjk
�rYnX|���r4t|�q�|���r�z|�||�Wn>tk
�r�}	zt�d||j|	�WY�q�W5d}	~	XYnXq�z|�|�}
WnBttfk
�r�}	zt�d||j|	�WY�q�W5d}	~	XYnXttj�|��t|d��}t� |
|�W5QRX|
�	�|�!||�|j"d@r�t�#|dt$�dB�q�W5|�	�XdS)a�
    Untar the file (with path `filename`) to the destination `location`.
    All files are written based on system defaults and umask (i.e. permissions
    are not preserved), except that regular file members with any execute
    permissions (user, group, or world) have "chmod +x" applied after being
    written.  Note that for windows, any execute changes using os.chmod are
    no-ops per the python docs.
    z.gzz.tgzzr:gzzr:bz2zr:xzz.tar�rz-Cannot determine compression type for file %szr:*cSsg|]
}|j�qSr�r=)�.0�memberrrr�
<listcomp>�szuntar_file.<locals>.<listcomp>rzQThe tar file ({}) has a file ({}) trying to install outside target directory ({})rFz/In the tar file %s the member %s is invalid: %sNr*r(r))%r�lowerr2rr�loggerZwarning�tarfiler+r,r!Z
getmembersr=rrrr/r%rr1Zdata_filter�replaceZLinkOutsideDestinationError�isdirZissymZ_extract_member�	ExceptionZextractfile�KeyError�AttributeErrorr0r6r7�utimerBr5r)r.r8rBZtarr;rHr>rr@�excrArCrrr�
untar_file�s�
��
��


��
rTcCs�tj�|�}|dks,|���t�s,t�|�rDt|||�d�d�nR|dkslt	�
|�sl|���ttt
�rxt||�nt�d|||�td�|���dS)Nzapplication/zipz.whl)r9zapplication/x-gzipzZCannot unpack file %s (downloaded from %s, content-type: %s); cannot detect archive formatz%Cannot determine archive format of {})rr�realpathrJr2rr-Z
is_zipfilerDrLZ
is_tarfilerrrrTrKZcriticalrr1)r.r8Zcontent_typerrr�unpack_file�s<���
���
����rV)T)N))�__doc__Z
__future__rZloggingrr6r3rLr-Zpip._internal.exceptionsrZpip._internal.utils.filetypesrrrrZpip._internal.utils.miscrZpip._internal.utils.typingr	�typingr
rrr
rZ	getLogger�__name__rKZSUPPORTED_EXTENSIONS�bz2�ImportError�debugZlzmarrr!r%rDrTrVrrrr�<module>sB

4^�site-packages/pip/_internal/utils/__pycache__/unpacking.cpython-38.opt-1.pyc000064400000014055151446176770022774 0ustar00U

��.e�%�@sXdZddlmZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZm
Z
mZmZddlmZddlmZer�ddlmZmZmZmZmZe�e�Zee
ZzddlZee7ZWnek
r�e� d	�YnXzddl!Z!ee7ZWn ek
�re� d
�YnXdd�Z"d
d�Z#dd�Z$dd�Z%ddd�Z&dd�Z'ddd�Z(dS)zUtilities related archives.
�)�absolute_importN)�InstallationError)�BZ2_EXTENSIONS�TAR_EXTENSIONS�
XZ_EXTENSIONS�ZIP_EXTENSIONS)�
ensure_dir)�MYPY_CHECK_RUNNING)�Iterable�List�Optional�Text�Unionzbz2 module is not availablezlzma module is not availablecCst�d�}t�|�|S)zBGet the current umask which involves having to set it temporarily.r)�os�umask)�mask�r�A/usr/lib/python3.8/site-packages/pip/_internal/utils/unpacking.py�
current_umask2s

rcCsh|�d��d�}d|krHd|kr4|�d�|�d�ks<d|krH|�dd�Sd|kr\|�dd�S|dgSdS)N�/�\��)�lstrip�find�split)�pathrrr�split_leading_dir9s����rcCsDd}|D]6}t|�\}}|s"dS|dkr0|}q||krdSqdS)zyReturns true if all the paths have the same leading path name
    (i.e., everything is in one subdirectory in an archive)NFT)r)�pathsZ
common_prefixr�prefix�restrrr�has_leading_dirIsr!cCs0tj�|�}tj�|�}tj�||g�}||kS)zL
    Return true if the absolute path of target is within the directory
    )rr�abspath�commonprefix)Z	directory�targetZ
abs_directoryZ
abs_targetrrrr�is_within_directoryYsr%TcCsFt|�t|d�}�z"tj|dd�}t|���o2|}|��D]�}|j}|}|rZt	|�d}t
j�||�}t
j�
|�}	t||�s�d}
t|
�|||���|�d�s�|�d�r�t|�q<t|	�|�|�}z&t|d��}
t�||
�W5QRXW5|��|jd?}|�r0t�|��r0|d	@�r0t
�|d
t�d	B�Xq<W5|��XdS)
a�
    Unzip the file (with path `filename`) to the destination `location`.  All
    files are written based on system defaults and umask (i.e. permissions are
    not preserved), except that regular file members with any execute
    permissions (user, group, or world) have "chmod +x" applied after being
    written. Note that for windows, any execute changes using os.chmod are
    no-ops per the python docs.
    �rbT)Z
allowZip64rzQThe zip file ({}) has a file ({}) trying to install outside target directory ({})rr��I��wbN)r�open�close�zipfileZZipFiler!ZnamelistZinfolist�filenamerrr�join�dirnamer%r�format�endswithZ
external_attr�stat�S_ISREG�chmodr�shutil�copyfileobj)r.�location�flattenZzipfp�zip�leading�info�name�fn�dir�message�fp�mode�destfprrr�
unzip_filees8


�


rDcCs\t|�|���d�s$|���d�r*d}nL|���t�r>d}n8|���t�rRd}n$|���d�rfd}nt�d|�d	}t�||�}�z�t
d
d�|��D��}|��D�]�}|j}|r�t
|�d}tj�||�}t||�s�d
}t|�|||���zt�|j|d�|�Wntjk
�rYnX|���r4t|�q�|���r�z|�||�Wn>tk
�r�}	zt�d||j|	�WY�q�W5d}	~	XYnXq�z|�|�}
WnBttfk
�r�}	zt�d||j|	�WY�q�W5d}	~	XYnXttj�|��t|d��}t� |
|�W5QRX|
�	�|�!||�|j"d@r�t�#|dt$�dB�q�W5|�	�XdS)a�
    Untar the file (with path `filename`) to the destination `location`.
    All files are written based on system defaults and umask (i.e. permissions
    are not preserved), except that regular file members with any execute
    permissions (user, group, or world) have "chmod +x" applied after being
    written.  Note that for windows, any execute changes using os.chmod are
    no-ops per the python docs.
    z.gzz.tgzzr:gzzr:bz2zr:xzz.tar�rz-Cannot determine compression type for file %szr:*cSsg|]
}|j�qSr�r=)�.0�memberrrr�
<listcomp>�szuntar_file.<locals>.<listcomp>rzQThe tar file ({}) has a file ({}) trying to install outside target directory ({})rFz/In the tar file %s the member %s is invalid: %sNr*r(r))%r�lowerr2rr�loggerZwarning�tarfiler+r,r!Z
getmembersr=rrrr/r%rr1Zdata_filter�replaceZLinkOutsideDestinationError�isdirZissymZ_extract_member�	ExceptionZextractfile�KeyError�AttributeErrorr0r6r7�utimerBr5r)r.r8rBZtarr;rHr>rr@�excrArCrrr�
untar_file�s�
��
��


��
rTcCs�tj�|�}|dks,|���t�s,t�|�rDt|||�d�d�nR|dkslt	�
|�sl|���ttt
�rxt||�nt�d|||�td�|���dS)Nzapplication/zipz.whl)r9zapplication/x-gzipzZCannot unpack file %s (downloaded from %s, content-type: %s); cannot detect archive formatz%Cannot determine archive format of {})rr�realpathrJr2rr-Z
is_zipfilerDrLZ
is_tarfilerrrrTrKZcriticalrr1)r.r8Zcontent_typerrr�unpack_file�s<���
���
����rV)T)N))�__doc__Z
__future__rZloggingrr6r3rLr-Zpip._internal.exceptionsrZpip._internal.utils.filetypesrrrrZpip._internal.utils.miscrZpip._internal.utils.typingr	�typingr
rrr
rZ	getLogger�__name__rKZSUPPORTED_EXTENSIONS�bz2�ImportError�debugZlzmarrr!r%rDrTrVrrrr�<module>sB

4^�site-packages/pip/_internal/utils/__pycache__/packaging.cpython-38.pyc000064400000005060151446176770021776 0ustar00U

��.e��@s�ddlmZddlZddlmZddlmZddlmZm	Z	ddl
mZddlm
Z
ddlmZer�dd	lmZmZdd
lmZddlmZe�e�Zdd
�Zdd�Zdd�Zdd�ZdS)�)�absolute_importN)�
FeedParser)�
pkg_resources)�
specifiers�version)�NoneMetadataError)�display_path)�MYPY_CHECK_RUNNING)�Optional�Tuple)�Message)�DistributioncCs4|dkrdSt�|�}t�d�tt|���}||kS)a�
    Check if the given Python version matches a "Requires-Python" specifier.

    :param version_info: A 3-tuple of ints representing a Python
        major-minor-micro version to check (e.g. `sys.version_info[:3]`).

    :return: `True` if the given Python version satisfies the requirement.
        Otherwise, return `False`.

    :raises InvalidSpecifier: If `requires_python` has an invalid format.
    NT�.)rZSpecifierSetr�parse�join�map�str)�requires_python�version_infoZrequires_python_specifierZpython_version�r�A/usr/lib/python3.8/site-packages/pip/_internal/utils/packaging.py�check_requires_pythons


rcCs�d}t|tj�r&|�|�r&|�|�}n0|�d�r@d}|�|�}nt�dt|j��d}|dkrht	||��t
�}|�|�|��S)z�
    :raises NoneMetadataError: if the distribution reports `has_metadata()`
        True but `get_metadata()` returns None.
    ZMETADATAzPKG-INFOzNo metadata found in %s�N)
�
isinstancerZDistInfoDistribution�has_metadata�get_metadata�loggerZwarningr�locationrrZfeed�close)�distZ
metadata_nameZmetadataZfeed_parserrrrr,s�


rcCs&t|�}|�d�}|dk	r"t|�}|S)z_
    Return the "Requires-Python" metadata for a distribution, or None
    if not present.
    zRequires-PythonN)r�getr)rZ
pkg_info_dictrrrr�get_requires_pythonGs

r!cCs2|�d�r.|�d�D]}|��r|��SqdS)NZ	INSTALLERr)rZget_metadata_lines�strip)r�linerrr�
get_installerXs

r$)Z
__future__rZloggingZemail.parserrZpip._vendorrZpip._vendor.packagingrrZpip._internal.exceptionsrZpip._internal.utils.miscrZpip._internal.utils.typingr	�typingr
rZ
email.messagerZpip._vendor.pkg_resourcesr
Z	getLogger�__name__rrrr!r$rrrr�<module>s 
site-packages/pip/_internal/utils/__pycache__/typing.cpython-38.pyc000064400000002405151446176770021364 0ustar00U

��.ee�@sdZdZdS)aBFor neatly implementing static typing in pip.

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

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

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

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

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

    from pip._internal.utils.typing import MYPY_CHECK_RUNNING

    if MYPY_CHECK_RUNNING:
        from typing import ...

Ref: https://github.com/python/mypy/issues/3216
FN)�__doc__ZMYPY_CHECK_RUNNING�rr�>/usr/lib/python3.8/site-packages/pip/_internal/utils/typing.py�<module>ssite-packages/pip/_internal/utils/__pycache__/deprecation.cpython-38.pyc000064400000005412151446176770022350 0ustar00U

��.e��@s�dZddlmZddlZddlZddlmZddlmZ	ddl
mZerXddlm
Z
mZdZGd	d
�d
e�Zdaddd�Zd
d�Zddd�ZdS)zN
A module that implements tooling to enable easy warnings about deprecations.
�)�absolute_importN)�parse)�__version__)�MYPY_CHECK_RUNNING)�Any�Optionalz
DEPRECATION: c@seZdZdS)�PipDeprecationWarningN)�__name__�
__module__�__qualname__�rr�C/usr/lib/python3.8/site-packages/pip/_internal/utils/deprecation.pyrsrcCsZ|dk	r$tdk	rVt||||||�n2t|t�rDt�d�}|�|�nt||||||�dS)Nzpip._internal.deprecations)�_original_showwarning�
issubclassr�loggingZ	getLoggerZwarning)�message�category�filename�lineno�file�lineZloggerrrr
�_showwarning!s*�

�rcCs(tjdtdd�tdkr$tjatt_dS)N�defaultT)�append)�warnings�simplefilterrr�showwarningrrrrr
�install_warning_logger2srcCsh|tdf|df|df|dfg}d�dd�|D��}|dk	rTtt�t|�krTt|��tj|td	d
�dS)a�Helper to deprecate existing functionality.

    reason:
        Textual reason shown to the user about why this functionality has
        been deprecated.
    replacement:
        Textual suggestion shown to the user about what alternative
        functionality they can use.
    gone_in:
        The version of pip does this functionality should get removed in.
        Raises errors if pip's current version is greater than or equal to
        this.
    issue:
        Issue number on the tracker that would serve as a useful place for
        users to find related discussion and provide feedback.

    Always pass replacement, gone_in and issue as keyword arguments for clarity
    at the call site.
    z{}z2pip {} will remove support for this functionality.zA possible replacement is {}.zPYou can find discussion regarding this at https://github.com/pypa/pip/issues/{}.� css$|]\}}|dk	r|�|�VqdS)N)�format)�.0�val�templaterrr
�	<genexpr>`szdeprecated.<locals>.<genexpr>N�)r�
stacklevel)�DEPRECATION_MSG_PREFIX�joinr�current_versionrr�warn)�reasonZreplacementZgone_inZissueZ	sentencesrrrr
�
deprecated>s
��	
�r+)NN)N)�__doc__Z
__future__rrrZpip._vendor.packaging.versionrZpiprr(Zpip._internal.utils.typingr�typingrrr&�Warningrrrrr+rrrr
�<module>s
site-packages/pip/_internal/utils/__pycache__/urls.cpython-38.opt-1.pyc000064400000002506151446176770022000 0ustar00U

��.e��@shddlZddlZddlmZddlmZddlmZerLddl	m
Z
mZmZdd�Z
dd	�Zd
d�ZdS)�N)�parse)�request)�MYPY_CHECK_RUNNING)�Optional�Text�UnioncCs d|krdS|�dd�d��S)N�:�r)�split�lower)�url�r
�</usr/lib/python3.8/site-packages/pip/_internal/utils/urls.py�get_url_scheme
srcCs*tj�tj�|��}t�dt�|��}|S)zh
    Convert a path to a file: URL.  The path will be made absolute and have
    quoted path parts.
    zfile:)�os�path�normpath�abspath�urllib_parseZurljoin�urllib_requestZpathname2url)rrr
r
r�path_to_urlsrcCsXt�|�\}}}}}|r |dkr&d}n tjdkr:d|}ntd|��t�||�}|S)z(
    Convert a file: URL to a path.
    Z	localhost�Zwin32z\\z:non-local file URIs are not supported on this platform: %r)rZurlsplit�sys�platform�
ValueErrorrZurl2pathname)r�_Znetlocrr
r
r�url_to_paths

��r)rrZpip._vendor.six.moves.urllibrrrrZpip._internal.utils.typingr�typingrrrrrrr
r
r
r�<module>ssite-packages/pip/_internal/utils/__pycache__/hashes.cpython-38.pyc000064400000010060151446176770021321 0ustar00U

��.e��@s�ddlmZddlZddlmZmZmZddlmZm	Z	m
Z
ddlmZddl
mZer�ddlmZmZmZmZmZddlmZer�dd	lmZndd
lmZdZddd
gZGdd�de�ZGdd�de�ZdS)�)�absolute_importN)�	iteritems�iterkeys�
itervalues)�HashMismatch�HashMissing�InstallationError)�read_chunks)�MYPY_CHECK_RUNNING)�Dict�List�BinaryIO�NoReturn�Iterator)�PY3)�_Hash)�_hashZsha256Zsha384Zsha512c@s^eZdZdZddd�Zedd��Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
dS)�HasheszaA wrapper that builds multiple hashes at once and checks them against
    known-good values

    NcCs|dkrin||_dS)zo
        :param hashes: A dict of algorithm names pointing to lists of allowed
            hex digests
        N)�_allowed)�self�hashes�r�>/usr/lib/python3.8/site-packages/pip/_internal/utils/hashes.py�__init__,szHashes.__init__cCstdd�|j��D��S)Ncss|]}t|�VqdS�N)�len)�.0Zdigestsrrr�	<genexpr>7sz&Hashes.digest_count.<locals>.<genexpr>)�sumr�values�rrrr�digest_count4szHashes.digest_countcCs||j�|g�kS)z/Return whether the given hex digest is allowed.)r�get)r�	hash_nameZ
hex_digestrrr�is_hash_allowed9szHashes.is_hash_allowedc
Cs�i}t|j�D]<}zt�|�||<Wqttfk
rHtd|��YqXq|D]}t|�D]}|�|�q\qPt	|�D] \}}|�
�|j|krvdSqv|�|�dS)z�Check good hashes against ones built from iterable of chunks of
        data.

        Raise HashMismatch if none match.

        zUnknown hash name: %sN)rr�hashlib�new�
ValueError�	TypeErrorrr�updater�	hexdigest�_raise)rZchunks�gotsr#�chunk�hashZgotrrr�check_against_chunksAszHashes.check_against_chunkscCst|j|��dSr)rr�rr,rrrr+Ysz
Hashes._raisecCs|�t|��S)zaCheck good hashes against a file-like object

        Raise HashMismatch if none match.

        )r/r	)r�filerrr�check_against_file]szHashes.check_against_filec
Cs,t|d��}|�|�W5QR�SQRXdS)N�rb)�openr2)r�pathr1rrr�check_against_pathfszHashes.check_against_pathcCs
t|j�S)z,Return whether I know any known-good hashes.)�boolrr rrr�__nonzero__kszHashes.__nonzero__cCs|��Sr)r8r rrr�__bool__pszHashes.__bool__)N)�__name__�
__module__�__qualname__�__doc__r�propertyr!r$r/r+r2r6r8r9rrrrr's

	rcs(eZdZdZ�fdd�Zdd�Z�ZS)�
MissingHashesz�A workalike for Hashes used when we're missing a hash for a requirement

    It computes the actual hash of the requirement and raises a HashMissing
    exception showing it to the user.

    cstt|�jtgid�dS)z!Don't offer the ``hashes`` kwarg.)rN)�superr?r�
FAVORITE_HASHr ��	__class__rrr|szMissingHashes.__init__cCst|t����dSr)rrAr*r0rrrr+�szMissingHashes._raise)r:r;r<r=rr+�
__classcell__rrrBrr?usr?)Z
__future__rr%Zpip._vendor.sixrrrZpip._internal.exceptionsrrrZpip._internal.utils.miscr	Zpip._internal.utils.typingr
�typingrrr
rrrrrrAZ
STRONG_HASHES�objectrr?rrrr�<module>s
Nsite-packages/pip/_internal/utils/__pycache__/glibc.cpython-38.opt-1.pyc000064400000004321151446176770022070 0ustar00U

��.e-�@sxddlmZddlZddlZddlZddlmZerDddlmZm	Z	dd�Z
dd�Zd	d
�Zdd�Z
d
d�Zdd�ZdS)�)�absolute_importN)�MYPY_CHECK_RUNNING)�Optional�TuplecCst�p
t�S)z9Returns glibc version string, or None if not using glibc.)�glibc_version_string_confstr�glibc_version_string_ctypes�rr�=/usr/lib/python3.8/site-packages/pip/_internal/utils/glibc.py�glibc_version_stringsr
c
Cs8zt�d���\}}Wntttfk
r2YdSX|S)z@Primary implementation of glibc_version_string using os.confstr.�CS_GNU_LIBC_VERSIONN)�os�confstr�split�AttributeError�OSError�
ValueError)�_�versionrrr	rs
rcCsvzddl}Wntk
r"YdSX|�d�}z
|j}Wntk
rNYdSX|j|_|�}t|t�sr|�	d�}|S)z=Fallback implementation of glibc_version_string using ctypes.rN�ascii)
�ctypes�ImportErrorZCDLL�gnu_get_libc_versionrZc_char_pZrestype�
isinstance�str�decode)rZprocess_namespacer�version_strrrr	r&s



rcCsHt�d|�}|s$t�d|t�dSt|�d��|koFt|�d��|kS)Nz$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z=Expected glibc version with 2 components major.minor, got: %sF�major�minor)�re�match�warnings�warn�RuntimeWarning�int�group)r�required_major�
minimum_minor�mrrr	�check_glibc_versionFs���r(cCst�}|dkrdSt|||�S)NF)r
r()r%r&rrrr	�have_compatible_glibcWsr)cCst�}|dkrdSd|fSdS)z�Try to determine the glibc version

    Returns a tuple of strings (lib, version) which default to empty strings
    in case the lookup fails.
    N)�r*Zglibc)r
)Z
glibc_versionrrr	�libc_verpsr+)Z
__future__rrrr Zpip._internal.utils.typingr�typingrrr
rrr(r)r+rrrr	�<module>s site-packages/pip/_internal/utils/__pycache__/marker_files.cpython-38.pyc000064400000001640151446176770022515 0ustar00U

��.e7�@s$ddlZdZdZdd�Zdd�ZdS)�Nz�This file is placed here by pip to indicate the source was put
here by pip.

Once this package is successfully installed this source code will be
deleted (unless you remove this file).
zpip-delete-this-directory.txtcCstj�tj�|t��S)N)�os�path�exists�join�PIP_DELETE_MARKER_FILENAME)�	directory�r�D/usr/lib/python3.8/site-packages/pip/_internal/utils/marker_files.py�has_delete_marker_filesr
c	Cs2tj�|t�}t|d��}|�t�W5QRXdS)z?
    Write the pip delete marker file into this directory.
    �wN)rrrr�open�write�DELETE_MARKER_MESSAGE)r�filepathZ	marker_fprrr	�write_delete_marker_filesr)Zos.pathrrrr
rrrrr	�<module>ssite-packages/pip/_internal/utils/__pycache__/logging.cpython-38.pyc000064400000021707151446176770021506 0ustar00U

��.e�2�@s�ddlmZddlZddlZddlZddlZddlZddlZddlmZm	Z	ddl
mZddlm
Z
ddlmZddlmZzddlZWnek
r�ddlZYnXzddlmZWnek
r�dZYnXdd	lmZeZe��Zde_e	d
�ZGdd�de�Ze
�r&e�rd
d�Z ndd�Z ne�r6dd�Z ndd�Z ej!d%dd��Z"dd�Z#Gdd�dej$�Z%dd�Z&Gdd�dej'�Z(Gdd�dej)j*�Z+Gdd �d e�Z,Gd!d"�d"e�Z-d#d$�Z.dS)&�)�absolute_importN)�Filter�	getLogger)�PY2)�WINDOWS)�DEPRECATION_MSG_PREFIX)�
ensure_dir)�colorama)�Forezpip.subprocessorc@seZdZdZdS)�BrokenStdoutLoggingErrorzO
    Raised if BrokenPipeError occurs for the stdout stream while logging.
    N)�__name__�
__module__�__qualname__�__doc__�rr�?/usr/lib/python3.8/site-packages/pip/_internal/utils/logging.pyr;srcCs|tko|jtjtjfkS�z1See the docstring for non-Windows Python 3 below.)�IOError�errno�EINVAL�EPIPE��	exc_class�excrrr�_is_broken_pipe_errorIs�rcCs"|tkp |tko |jtjtjfkSr)�BrokenPipeError�OSErrorrrrrrrrrOs�cCs|tko|jtjkSr)rrrrrrrrUscCs|tkS)z�
        Return whether an exception is a broken pipe error.

        Args:
          exc_class: an exception class.
          exc: an exception instance.
        )rrrrrrZs�c	cs.tj|7_z
dVW5tj|8_XdS)zv
    A context manager which will cause the log output to be indented for any
    log messages emitted inside it.
    N)�
_log_state�indentation)Znumrrr�
indent_loges
r cCsttdd�S)Nrr)�getattrrrrrr�get_indentationrsr"cs0eZdZ�fdd�Zdd�Z�fdd�Z�ZS)�IndentingFormattercs$|�dd�|_tt|�j||�dS)z�
        A logging.Formatter that obeys the indent_log() context manager.

        :param add_timestamp: A bool indicating output lines should be prefixed
            with their record's timestamp.
        �
add_timestampFN)�popr$�superr#�__init__)�self�args�kwargs��	__class__rrr'xszIndentingFormatter.__init__cCs.|tjkrdS|�t�rdS|tjkr*dSdS)zv
        Return the start of the formatted log message (not counting the
        prefix to add to each line).
        �z	WARNING: zERROR: )�logging�WARNING�
startswithr�ERROR)r(�	formatted�levelnorrr�get_message_start�s


z$IndentingFormatter.get_message_startcsztt|��|�}|�||j�}||}d�|jrJ|�|d�}d||jf��dt�7�d�	�fdd�|�
d�D��}|S)z�
        Calls the standard formatter, but will indent all of the log message
        lines by our current indentation level.
        r-z%Y-%m-%dT%H:%M:%Sz%s,%03d � csg|]}�|�qSrr)�.0�line��prefixrr�
<listcomp>�s�z-IndentingFormatter.format.<locals>.<listcomp>T)r&r#�formatr4r3r$Z
formatTimeZmsecsr"�join�
splitlines)r(�recordr2Z
message_start�tr+r8rr;�s�zIndentingFormatter.format)rr
rr'r4r;�
__classcell__rrr+rr#vs
r#cs�fdd�}|S)Ncsd�t��|tjjg�S)Nr-)r<�listr	ZStyleZ	RESET_ALL)Zinp��colorsrr�wrapped�sz_color_wrap.<locals>.wrappedr)rCrDrrBr�_color_wrap�srEcsheZdZer.ejeej�fej	eej
�fgZngZddd�Zdd�Z
dd�Zdd	�Z�fd
d�Z�ZS)
�ColorizedStreamHandlerNcCs.tj�||�||_tr*tr*t�|j�|_dS�N)r.�
StreamHandlerr'�	_no_colorrr	�AnsiToWin32�stream)r(rK�no_colorrrrr'�szColorizedStreamHandler.__init__cCs"trtr|jjtjkS|jtjkS)zA
        Return whether the handler is using sys.stdout.
        )rr	rKrD�sys�stdout�r(rrr�
_using_stdout�sz$ColorizedStreamHandler._using_stdoutcCsXtr
|jrdSt|jtj�s"|jn|jj}t|d�r@|��r@dStj	�
d�dkrTdSdS)NF�isattyTZTERMZANSI)r	rI�
isinstancerKrJrD�hasattrrQ�os�environ�get)r(Zreal_streamrrr�should_color�s
�z#ColorizedStreamHandler.should_colorcCs@tj�||�}|��r<|jD]\}}|j|kr||�}q<q|SrG)r.rHr;rW�COLORSr3)r(r>�msg�levelZcolorrrrr;�s
zColorizedStreamHandler.formatcs@t��dd�\}}|r0|��r0t||�r0t��tt|��|�S)Nr)rM�exc_inforPrrr&rF�handleError)r(r>rrr+rrr\�s�z"ColorizedStreamHandler.handleError)NN)rr
rr	r.r1rEr
ZREDr/ZYELLOWrXr'rPrWr;r\r@rrr+rrF�s�

rFc@seZdZdd�ZdS)�BetterRotatingFileHandlercCs ttj�|j��tjj�|�SrG)	rrT�path�dirnameZbaseFilenamer.�handlers�RotatingFileHandler�_openrOrrrrb�szBetterRotatingFileHandler._openN)rr
rrbrrrrr]�sr]c@seZdZdd�Zdd�ZdS)�MaxLevelFiltercCs
||_dSrG)rZ)r(rZrrrr'szMaxLevelFilter.__init__cCs|j|jkSrG)r3rZ�r(r>rrr�filterszMaxLevelFilter.filterN)rr
rr'rerrrrrcsrccs eZdZdZ�fdd�Z�ZS)�ExcludeLoggerFilterzQ
    A logging Filter that excludes records from a logger (or its children).
    cstt|��|�SrG)r&rfrerdr+rrreszExcludeLoggerFilter.filter)rr
rrrer@rrr+rrf	srfcCsf|dkrd}n.|dkrd}n |dkr*d}n|dkr8d}nd	}tt|�}|d
k	}|r\|}d}nd}|}|dkrpdnd}d
dd�}	ddd�}
dddg|r�dgng}tj�dddtjd�dtjd�dtjd�d�tdd�tdd d!�d"�||
d#||	d$d%d&gd'd(�d|
d#||	d)d%gd'd(�||
d#||	d)d*gd'd(�d|
d+|d d,d-�d.�||d/�d0d1|iid2��|S)3znConfigures and sets up all of the logging

    Returns the requested logging level, as its integer value.
    ��DEBUG���r/���r1���ZCRITICAL�INFONz	/dev/null)rlr1zext://sys.stdoutzext://sys.stderr)rN�stderrz2pip._internal.utils.logging.ColorizedStreamHandlerz5pip._internal.utils.logging.BetterRotatingFileHandler)rK�file�console�console_errors�console_subprocess�user_logFz*pip._internal.utils.logging.MaxLevelFilter)�()rZzlogging.Filter)rs�namez/pip._internal.utils.logging.ExcludeLoggerFilter)�exclude_warnings�restrict_to_subprocess�exclude_subprocessz%(message)s)rsr;T)rsr;r$)�indent�indent_with_timestamprKrNrwrurx)rZ�classrLrK�filters�	formatterrmrvrnry)rZrz�filenameZdelayr|)rorprqrr)rZr`zpip._vendorrZ)�versionZdisable_existing_loggersr{Z
formattersr`�rootZloggers)r!r.ZconfigZ
dictConfigr/�subprocess_loggerrtr#)�	verbosityrLZ
user_log_filerZZlevel_numberZinclude_user_logZadditional_log_fileZ
root_levelZvendored_log_levelZlog_streamsZhandler_classesr`rrr�
setup_loggings�
����������
�	��	��$����Jr�)r)/Z
__future__r�
contextlibrr.Zlogging.handlersrTrMrrZpip._vendor.sixrZpip._internal.utils.compatrZpip._internal.utils.deprecationrZpip._internal.utils.miscrZ	threading�ImportErrorZdummy_threadingZpip._vendorr	Z	_colorama�	ExceptionZpip._vendor.coloramar
Zlocalrrr�rr�contextmanagerr r"Z	Formatterr#rErHrFr`rar]rcrfr�rrrr�<module>sT

		


2K	site-packages/pip/_internal/utils/__pycache__/setuptools_build.cpython-38.pyc000064400000002352151446176770023453 0ustar00U

��.e_�@s:ddlZddlmZer(ddlmZmZdZddd�ZdS)	�N)�MYPY_CHECK_RUNNING)�List�Sequencez�import sys, setuptools, tokenize; sys.argv[0] = {0!r}; __file__={0!r};f=getattr(tokenize, 'open', open)(__file__);code=f.read().replace('\r\n', '\n');f.close();exec(compile(code, __file__, 'exec'))FcCsJtjg}|r|�d�|�dt�|�g�|r8|�|�|rF|�d�|S)ao
    Get setuptools command arguments with shim wrapped setup file invocation.

    :param setup_py_path: The path to setup.py to be wrapped.
    :param global_options: Additional global options.
    :param no_user_config: If True, disables personal user configuration.
    :param unbuffered_output: If True, adds the unbuffered switch to the
     argument list.
    z-uz-cz
--no-user-cfg)�sys�
executable�append�extend�_SETUPTOOLS_SHIM�format)Z
setup_py_pathZglobal_optionsZno_user_configZunbuffered_output�args�r�H/usr/lib/python3.8/site-packages/pip/_internal/utils/setuptools_build.py�make_setuptools_shim_argss


r)NFF)rZpip._internal.utils.typingr�typingrrr	rrrrr
�<module>s	��site-packages/pip/_internal/utils/__pycache__/typing.cpython-38.opt-1.pyc000064400000002405151446176770022323 0ustar00U

��.ee�@sdZdZdS)aBFor neatly implementing static typing in pip.

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

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

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

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

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

    from pip._internal.utils.typing import MYPY_CHECK_RUNNING

    if MYPY_CHECK_RUNNING:
        from typing import ...

Ref: https://github.com/python/mypy/issues/3216
FN)�__doc__ZMYPY_CHECK_RUNNING�rr�>/usr/lib/python3.8/site-packages/pip/_internal/utils/typing.py�<module>ssite-packages/pip/_internal/utils/__pycache__/subprocess.cpython-38.pyc000064400000012736151446176770022252 0ustar00U

��.e�&�	@sddlmZddlZddlZddlZddlmZddlmZddl	m
Z
mZddlm
Z
ddlmZmZddlmZdd	lmZer�dd
lmZmZmZmZmZmZmZmZddlmZeeeefZ dZ!d
d�Z"dd�Z#dd�Z$dd�Z%ddd�Z&dd�Z'dS)�)�absolute_importN)�shlex_quote)�InstallationError)�console_to_str�str_to_display)�subprocess_logger)�
HiddenText�path_to_display)�MYPY_CHECK_RUNNING)�open_spinner)�Any�Callable�Iterable�List�Mapping�Optional�Text�Union)�SpinnerInterfacez(----------------------------------------cGs2g}|D]$}t|t�r"|�|�q|�|�q|S)z&
    Create a CommandArgs object.
    )�
isinstance�list�extend�append)�argsZcommand_args�arg�r�B/usr/lib/python3.8/site-packages/pip/_internal/utils/subprocess.py�make_commands
rcCsd�dd�|D��S)z/
    Format command arguments for display.
    � css,|]$}t|t�rtt|��nt|�VqdS)N)rrr�str��.0rrrr�	<genexpr>;s�z&format_command_args.<locals>.<genexpr>)�join�rrrr�format_command_args1s

�r%cCsdd�|D�S)z=
    Return the arguments in their raw, unredacted form.
    cSs g|]}t|t�r|jn|�qSr)rrZsecretr rrr�
<listcomp>Fsz'reveal_command_args.<locals>.<listcomp>rr$rrr�reveal_command_argsAs�r'c	CsDt|�}t|dd�}t|�}d�|�}dj|||t|�|td�}|S)z�
    Create and return the error message to use to log a subprocess error
    with command output.

    :param lines: A list of lines, each ending with a newline.
    z
command bytes)Zdesc�z�Command errored out with exit status {exit_status}:
 command: {command_display}
     cwd: {cwd_display}
Complete output ({line_count} lines):
{output}{divider})�exit_status�command_display�cwd_displayZ
line_count�outputZdivider)r%rr	r#�format�len�LOG_DIVIDER)	�cmd_args�cwd�linesr)Zcommandr*r+r,�msgrrr�make_subprocess_output_errorKs

�	�r4F�raiseTc

Cs4|dkrg}|dkrg}|r*tj}
tj}ntj}
tj}t��|k}|oN|dk	}
|dkr`t|�}|
d|�tj	�
�}|r�|�|�|D]}|�|d�q�z.t
jt|�t
jt
jt
j||d�}|j��Wn6tk
r�}z|	r�t�d||��W5d}~XYnXg}t|j���}|�s�qJ|��}|�|d�|
|�|
�r|���qz|��W5|j�rj|j��X|j�o||j|k}|
�r�|�r�|�d�n
|�d�|�r*|dk�r�|�s�|	�r�t||||jd	�}t� |�d
�!|j|�}t"|��n:|dk�rt�#d||j|�n|d
k�rnt$dt%|���d�&|�S)a�
    Args:
      show_stdout: if true, use INFO to log the subprocess's stderr and
        stdout streams.  Otherwise, use DEBUG.  Defaults to False.
      extra_ok_returncodes: an iterable of integer return codes that are
        acceptable, in addition to 0. Defaults to None, which means [].
      unset_environ: an iterable of environment variable names to unset
        prior to calling subprocess.Popen().
      log_failed_cmd: if false, failed commands are not logged, only raised.
    NzRunning command %s)�stderr�stdin�stdoutr1�envz#Error %s while executing command %s�
�errorZdoner5)r0r1r2r)zSCommand errored out with exit status {}: {} Check the logs for full command output.�warnz$Command "%s" had error code %s in %s�ignorezInvalid value: on_returncode=%sr()'r�info�logging�INFO�debug�DEBUGZgetEffectiveLevelr%�os�environ�copy�update�pop�
subprocess�Popenr'ZSTDOUT�PIPEr7�close�	ExceptionZcriticalrr8�readline�rstriprZspin�wait�
returncodeZfinishr4r;r-rZwarning�
ValueError�reprr#)�cmdZshow_stdoutr1Z
on_returncodeZextra_ok_returncodesZcommand_desc�
extra_environZ
unset_environ�spinnerZlog_failed_cmdZlog_subprocessZ
used_levelZshowing_subprocessZuse_spinnerr9�name�proc�excZ
all_output�lineZproc_had_errorr3Zexc_msgrrr�call_subprocessus�


���

�
��

�
�rZcsd�fdd�	}|S)z�Provide a subprocess_runner that shows a spinner message.

    Intended for use with for pep517's Pep517HookCaller. Thus, the runner has
    an API that matches what's expected by Pep517HookCaller.subprocess_runner.
    Nc	s(t���}t||||d�W5QRXdS)N)r1rTrU)rrZ)rSr1rTrU��messagerr�runners
�z+runner_with_spinner_message.<locals>.runner)NNr)r\r]rr[r�runner_with_spinner_messages
�r^)	FNr5NNNNNT)(Z
__future__rr?rCrHZpip._vendor.six.movesrZpip._internal.exceptionsrZpip._internal.utils.compatrrZpip._internal.utils.loggingrZpip._internal.utils.miscrr	Zpip._internal.utils.typingr
Zpip._internal.utils.uir�typingrr
rrrrrrrrZCommandArgsr/rr%r'r4rZr^rrrr�<module>s>(
,�
site-packages/pip/_internal/utils/__pycache__/__init__.cpython-38.pyc000064400000000233151446176770021606 0ustar00U

��.e�@sdS)N�rrr�@/usr/lib/python3.8/site-packages/pip/_internal/utils/__init__.py�<module>�site-packages/pip/_internal/utils/__pycache__/misc.cpython-38.opt-1.pyc000064400000055526151446176770021760 0ustar00U

��.e�c�@s�ddlmZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
ddlmZddlmZddlmZmZddlmZddlmZdd	lmZdd
lmZddlm Z ddl!m"Z"m#Z#m$Z$m%Z%dd
l&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0m1Z1e�r8ddlm2Z3nddlm3Z3e.�r�ddl4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>ddl?m@Z@e<eAeAeAfZBndd�Z>dddddddddd d!d"d#d$gZCe�DeE�ZFd%d&�ZGd'd(�ZHd)d"�ZId*d �ZJed+d,d-�d�d/d��ZKd0d1�ZLd2d3�ZMd4d�ZNd�d6d�ZOd7d8�ZPd9d:�ZQd;d�ZRd<d=�ZSd>d?�ZTd@d�ZUdAd�ZVejWfdBdC�ZXd�dEd�ZYdFd�ZZdGd�Z[dHdI�Z\dJdK�Z]dLdM�Z^dNdO�Z_dPdQ�Z`dRdS�ZadDe)dDd.d.dfdTdU�ZbdVdW�ZcdXdY�ZddZd[�Zed\d]�ZfGd^d_�d_eg�ZhGd`da�dae3�Ziejjdbdc��Zkddd!�Zldedf�ZmGdgdh�dheg�Znd�did#�Zodjdk�Zpdldm�Zqdndo�Zrd�dqdr�Zsdsdt�Ztdudv�Zudwdx�Zvdydz�Zwd{d|�Zxd}d~�Zydd��Zzd�d$�Z{d�d��Z|Gd�d��d�eg�Z}d�d��Z~d�d��Zd�d��Z�d�d��Z�dS)��)�absolute_importN��deque)�
pkg_resources)�retry)�PY2�	text_type)�input)�parse)�unquote)�__version__)�CommandError)�distutils_scheme�get_major_minor_version�
site_packages�	user_site)�WINDOWS�
expanduser�stdlib_pkgs�str_to_display)�write_delete_marker_file)�MYPY_CHECK_RUNNING)�running_under_virtualenv�virtualenv_no_global)�BytesIO)�StringIO)
�Any�AnyStr�	Container�Iterable�List�Optional�Text�Tuple�Union�cast)�DistributioncCs|S�N�)Ztype_�valuer(r(�</usr/lib/python3.8/site-packages/pip/_internal/utils/misc.pyr%Asr%�rmtree�display_path�
backup_dir�ask�splitext�format_size�is_installable_dir�normalize_path�renames�get_prog�captured_stdout�
ensure_dir�get_installed_version�remove_auth_from_urlcCs4tj�tj�t�dd�}tj�|�}d�t|t��S)Nz..zpip {} from {} (python {}))	�os�path�join�dirname�__file__�abspath�formatrr)Zpip_pkg_dirr(r(r*�get_pip_versionQs��r@cCsDt|�dkr"|dt|�d7}nt|�dkr:|dd�}td|�S)ax
    Convert a tuple of ints representing a Python version to one of length
    three.

    :param py_version_info: a tuple of ints representing a Python version,
        or None to specify no version. The tuple can have any length.

    :return: a tuple of length three if `py_version_info` is non-None.
        Otherwise, return `py_version_info` unchanged (i.e. None).
    �)rN�VersionInfo)�lenr%)Zpy_version_infor(r(r*�normalize_version_info]s
rDc
CsDzt�|�Wn0tk
r>}z|jtjkr.�W5d}~XYnXdS)z os.path.makedirs without EEXIST.N)r9�makedirs�OSError�errnoZEEXIST)r:�er(r(r*r6qs
c
CsPz0tj�tjd�}|dkr(dtjWS|WSWntttfk
rJYnXdS)Nr)z__main__.pyz-cz	%s -m pip�pip)	r9r:�basename�sys�argv�
executable�AttributeError�	TypeError�
IndexError)�progr(r(r*r4{s
i�i�)Zstop_max_delayZ
wait_fixedFcCstj||td�dS)N)�
ignore_errors�onerror)�shutilr+�rmtree_errorhandler)�dirrRr(r(r*r+�s�c	CsXzt�|�jtj@}Wnttfk
r2YdSX|rRt�|tj�||�dS�dS)z�On Windows, the files in .svn are read-only, so when rmtree() tries to
    remove them, an exception is thrown.  We catch that here, remove the
    read-only attribute, and hopefully continue without problems.N)r9�stat�st_mode�S_IWRITE�IOErrorrF�chmod)�funcr:�exc_infoZhas_attr_readonlyr(r(r*rU�srUcCsd|dkrdSt|t�r|Sz|�t��d�}Wn0tk
r^trRtd�|��}nt	|�}YnX|S)z�
    Convert a bytes (or text) path to text (unicode in Python 2) for display
    and logging purposes.

    This function should never error out. Also, this function is mainly needed
    for Python 2 since in Python 3 str paths are already text.
    N�strictzb{!r})
�
isinstancer�decoderK�getfilesystemencoding�UnicodeDecodeErrorrrr?�ascii)r:r,r(r(r*�path_to_display�s	
rdcCsttj�tj�|��}tjddkrB|�t��d�}|�t�	�d�}|�
t��tjj�rpd|t
t���d�}|S)zTGives the display value for a given path, making it relative to cwd
    if possible.r��replace�.N)r9r:�normcaser>rK�version_infor`ra�encode�getdefaultencoding�
startswith�getcwd�seprC�r:r(r(r*r,�s�.bakcCs6d}|}tj�||�r.|d7}|t|�}q||S)z\Figure out the name of a directory to back up the given dir to
    (adding .bak, .bak2, etc)�)r9r:�exists�str)rV�ext�n�	extensionr(r(r*r-�scCs2tj�dd���D]}||kr|Sqt||�S)NZPIP_EXISTS_ACTION�)r9�environ�get�splitr.)�message�options�actionr(r(r*�ask_path_exists�s
r~cCstj�d�rtd|��dS)z&Raise an error if no input is allowed.ZPIP_NO_INPUTz7No input was expected ($PIP_NO_INPUT set); question: %sN)r9rxry�	Exception�r{r(r(r*�_check_no_input�s��r�cCsFt|�t|�}|����}||kr<td|d�|�f�q|SqdS)z@Ask the message interactively, with the given possible responsesz<Your response (%r) was not one of the expected responses: %sz, N)r�r	�strip�lower�printr;)r{r|Zresponser(r(r*r.�s��cCst|�t|�S)zAsk for input interactively.)r�r	r�r(r(r*�	ask_inputsr�cCst|�t�|�S)z!Ask for a password interactively.)r��getpassr�r(r(r*�ask_passwordsr�cCsL|dkrd|ddS|dkr,d|dS|dkr@d|dSd|SdS)	Ni@Bz%.1fMBg@�@i�i'z%ikBz%.1fkBz%ibytesr()�bytesr(r(r*r0scCsPtj�|�sdStj�|d�}tj�|�r.dStj�|d�}tj�|�rLdSdS)zBIs path is a directory containing setup.py or pyproject.toml?
    Fzsetup.pyTzpyproject.toml)r9r:�isdirr;�isfile)r:Zsetup_pyZpyproject_tomlr(r(r*r1sccs|�|�}|sq|VqdS)z7Yield pieces of data from a file-like object until EOF.N)�read)�file�size�chunkr(r(r*�read_chunks*s
r�TcCs2t|�}|rtj�|�}ntj�|�}tj�|�S)zN
    Convert a path to its canonical, case-normalized, absolute version.

    )rr9r:�realpathr>rh)r:Zresolve_symlinksr(r(r*r23s
cCs@t�|�\}}|���d�r8|dd�|}|dd�}||fS)z,Like os.path.splitext, but take off .tar tooz.tar���N)�	posixpathr/r��endswith)r:�basertr(r(r*r/As
cCsztj�|�\}}|r.|r.tj�|�s.t�|�t�||�tj�|�\}}|rv|rvzt�|�Wntk
rtYnXdS)z7Like os.renames(), but handles renaming across devices.N)	r9r:rzrrrErTZmove�
removedirsrF)�old�new�head�tailr(r(r*r3Ks
cCst�s
dS|�ttj��S)z�
    Return True if path is within sys.prefix, if we're running in a virtualenv.

    If we're not in a virtualenv, all paths are considered "local."

    Caution: this function assumes the head of path has been normalized
    with normalize_path.
    T)rrlr2rK�prefixror(r(r*�is_local]s
r�cCstt|��S)z�
    Return True if given Distribution object is installed locally
    (i.e. within current virtualenv).

    Always True if we're not in a virtualenv.

    )r��
dist_location��distr(r(r*�
dist_is_localls	r�cCst|��tt��S)zF
    Return True if given Distribution is installed in user site.
    )r�rlr2rr�r(r(r*�dist_in_usersitexsr�cCst|��tt��S)z[
    Return True if given Distribution is installed in
    sysconfig.get_python_lib().
    )r�rlr2rr�r(r(r*�dist_in_site_packages�sr�cCs,tt|��}|�ttd�d�d�d��S)zf
    Return True if given Distribution is installed in
    path matching distutils_scheme layout.
    rwZpurelib�pythonr)r2r�rlrrz)r�Z	norm_pathr(r(r*�dist_in_install_path�s�r�cCs6tjD]*}tj�||jd�}tj�|�rdSqdS)zC
    Return True if given Distribution is an editable install.
    �	.egg-linkTF)rKr:r9r;�project_namer�)r�Z	path_item�egg_linkr(r(r*�dist_is_editable�s

r�cs�|rt�|�}ntj}|r t�ndd��|r6dd��ndd��|rLdd��ndd��|r^t�nd	d
�������fdd�|D�S)
a^
    Return a list of installed Distribution objects.

    If ``local_only`` is True (default), only return installations
    local to the current virtualenv, if in a virtualenv.

    ``skip`` argument is an iterable of lower-case project names to
    ignore; defaults to stdlib_pkgs

    If ``include_editables`` is False, don't report editables.

    If ``editables_only`` is True , only report editables.

    If ``user_only`` is True , only report installations in the user
    site directory.

    If ``paths`` is set, only report the distributions present at the
    specified list of locations.
    cSsdS�NTr(��dr(r(r*�
local_test�sz/get_installed_distributions.<locals>.local_testcSsdSr�r(r�r(r(r*�
editable_test�sz2get_installed_distributions.<locals>.editable_testcSs
t|�Sr'�r�r�r(r(r*r��scSst|�Sr'r�r�r(r(r*�editables_only_test�sz8get_installed_distributions.<locals>.editables_only_testcSsdSr�r(r�r(r(r*r��scSsdSr�r(r�r(r(r*�	user_test�sz.get_installed_distributions.<locals>.user_testcs:g|]2}�|�r|j�kr�|�r�|�r�|�r|�qSr()�key)�.0r��r�r�r��skipr�r(r*�
<listcomp>�s
�z/get_installed_distributions.<locals>.<listcomp>)r�
WorkingSet�working_setr�r�)Z
local_onlyr�Zinclude_editablesZeditables_onlyZ	user_only�pathsr�r(r�r*�get_installed_distributions�s 

r�cCsxg}t�r*|�t�t�sBtrB|�t�ntr8|�t�|�t�|D],}tj�||j�d}tj�	|�rF|SqFdS)a
    Return the path for the .egg-link file if it exists, otherwise, None.

    There's 3 scenarios:
    1) not in a virtualenv
       try to find in site.USER_SITE, then site_packages
    2) in a no-global virtualenv
       try to find in site_packages
    3) in a yes-global virtualenv
       try to find in site_packages, then site.USER_SITE
       (don't look in global location)

    For #1 and #3, there could be odd cases, where there's an egg-link in 2
    locations.

    This method will just return the first one found.
    r�N)
r�appendrrrr9r:r;r�r�)r�ZsitesZsiteZegglinkr(r(r*�
egg_link_path�s




r�cCst|�}|rt|�St|j�S)aO
    Get the site-packages location of this distribution. Generally
    this is dist.location, except in the case of develop-installed
    packages, where dist.location is the source code location, and we
    want to know where the egg-link file is.

    The returned location is normalized (in particular, with symlinks removed).
    )r�r2�location)r�r�r(r(r*r�s
r�cGstj|f|��dSr')�logger�info)�msg�argsr(r(r*�write_outputsr�cCst�|�t|�dSr')r9rEr)Z	build_dirr(r(r*�_make_build_dirs
r�c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�FakeFilezQWrap a list of lines in an object with readline() to make
    ConfigParser happy.cCsdd�|D�|_dS)Ncss|]
}|VqdSr'r()r��lr(r(r*�	<genexpr>&sz$FakeFile.__init__.<locals>.<genexpr>��_gen)�self�linesr(r(r*�__init__%szFakeFile.__init__cCsPz4zt|j�WWStk
r0|j��YWSXWntk
rJYdSXdS)Nrw)�nextr��	NameError�
StopIteration�r�r(r(r*�readline(szFakeFile.readlinecCs|jSr'r�r�r(r(r*�__iter__1szFakeFile.__iter__N)�__name__�
__module__�__qualname__�__doc__r�r�r�r(r(r(r*r�"s	r�c@s$eZdZedd��Zedd��ZdS)�
StreamWrappercCs||_|�Sr')�orig_stream)�clsr�r(r(r*�from_stream7szStreamWrapper.from_streamcCs|jjSr')r��encodingr�r(r(r*r�=szStreamWrapper.encodingN)r�r�r��classmethodr��propertyr�r(r(r(r*r�5s
r�c
cs@tt|�}tt|t�|��ztt|�VW5tt||�XdS)z�Return a context manager used by captured_stdout/stdin/stderr
    that temporarily replaces the sys stream *stream_name* with a StringIO.

    Taken from Lib/support/__init__.py in the CPython repo.
    N)�getattrrK�setattrr�r�)Zstream_nameZorig_stdoutr(r(r*�captured_outputBs

r�cCstd�S)z�Capture the output of sys.stdout:

       with captured_stdout() as stdout:
           print('hello')
       self.assertEqual(stdout.getvalue(), 'hello
')

    Taken from Lib/support/__init__.py in the CPython repo.
    �stdout�r�r(r(r(r*r5Qs	cCstd�S)z 
    See captured_stdout().
    �stderrr�r(r(r(r*�captured_stderr]sr�c@s eZdZdZdd�Zdd�ZdS)�cached_propertyz�A property that is only computed once per instance and then replaces
       itself with an ordinary attribute. Deleting the attribute resets the
       property.

       Source: https://github.com/bottlepy/bottle/blob/0.11.5/bottle.py#L175
    cCst|d�|_||_dS)Nr�)r�r�r\)r�r\r(r(r*r�lszcached_property.__init__cCs(|dkr|S|�|�}|j|jj<|Sr')r\�__dict__r�)r��objr�r)r(r(r*�__get__pszcached_property.__get__N)r�r�r�r�r�r�r(r(r(r*r�dsr�cCs4tj�|�}|dkrt��}|�|�}|r0|jSdS)zCGet the installed version of dist_name avoiding pkg_resources cacheN)rZRequirementr
r��find�version)Z	dist_namer�Zreqr�r(r(r*r7xs

cCst|dd�dS)zConsume an iterable at C speed.r)�maxlenNr)�iteratorr(r(r*�consume�sr�cOs@tt|tt|���f|�}dd�|��D�}||d<tdd|�S)NcSsi|]\}}||�qSr(r()r�r�r)r(r(r*�
<dictcomp>�szenum.<locals>.<dictcomp>Zreverse_mapping�Enumr()�dict�zip�rangerC�items�type)Z
sequentialZnamedZenums�reverser(r(r*�enum�sr�cCs*|dkr|Sd|krd�|�}d�||�S)z.
    Build a netloc from a host-port pair
    N�:�[{}]z{}:{})r?)Zhost�portr(r(r*�build_netloc�s

r��httpscCs4|�d�dkr(d|kr(d|kr(d�|�}d�||�S)z)
    Build a full URL from a netloc.
    r�re�@�[r�z{}://{})�countr?)�netloc�schemer(r(r*�build_url_from_netloc�s
r�cCst|�}t�|�}|j|jfS)z2
    Return the host-port pair from a netloc.
    )r��urllib_parseZurlparseZhostnamer�)r��urlZparsedr(r(r*�parse_netloc�s
rcCsXd|kr|dfS|�dd�\}}d|kr6|�dd�}n|df}tdd�|D��}||fS)zp
    Parse out and remove the auth information from a netloc.

    Returns: (netloc, (username, password)).
    r�)NNrqr�Ncss"|]}|dkrdnt|�VqdSr')�urllib_unquote)r��xr(r(r*r��sz)split_auth_from_netloc.<locals>.<genexpr>)�rsplitrz�tuple)r��authZ	user_passr(r(r*�split_auth_from_netloc�s�rcCsLt|�\}\}}|dkr|S|dkr.d}d}nt�|�}d}dj|||d�S)z�
    Replace the sensitive data in a netloc with "****", if it exists.

    For example:
        - "user:pass@example.com" returns "user:****@example.com"
        - "accesstoken@example.com" returns "****@example.com"
    N�****rwz:****z{user}{password}@{netloc})�user�passwordr�)rr�Zquoter?)r�r	r
r(r(r*�
redact_netloc�s	
�rcCs@t�|�}||j�}|j|d|j|j|jf}t�|�}||fS)aRTransform and replace netloc in a url.

    transform_netloc is a function taking the netloc and returning a
    tuple. The first element of this tuple is the new netloc. The
    entire tuple is returned.

    Returns a tuple containing the transformed url as item 0 and the
    original tuple returned by transform_netloc as item 1.
    r)r�Zurlsplitr�r�r:ZqueryZfragmentZ
urlunsplit)rZtransform_netlocZpurlZnetloc_tupleZ
url_piecesZsurlr(r(r*�_transform_url�s


�
rcCst|�Sr')r�r�r(r(r*�_get_netlocsrcCs
t|�fSr')rr
r(r(r*�_redact_netlocsrcCst|t�\}\}}|||fS)z�
    Parse a url into separate netloc, auth, and url with no auth.

    Returns: (url_without_auth, netloc, (username, password))
    �rr)rZurl_without_authr�rr(r(r*�split_auth_netloc_from_urlsrcCst|t�dS)z7Return a copy of url with 'username:password@' removed.rr�rr(r(r*r8scCst|t�dS)z.Replace the password in a given url with ****.r)rrrr(r(r*�redact_auth_from_urlsrc@s4eZdZdd�Zdd�Zdd�Zdd�Zd	d
�ZdS)�
HiddenTextcCs||_||_dSr')�secret�redacted)r�rrr(r(r*r�"szHiddenText.__init__cCsd�t|��S)Nz<HiddenText {!r}>)r?rsr�r(r(r*�__repr__+szHiddenText.__repr__cCs|jSr'�rr�r(r(r*�__str__/szHiddenText.__str__cCs t|�t|�krdS|j|jkS)NF)r�r�r��otherr(r(r*�__eq__4szHiddenText.__eq__cCs
||kSr'r(rr(r(r*�__ne__?szHiddenText.__ne__N)r�r�r�r�rrrrr(r(r(r*r!s
	rcCst|dd�S)Nrr)r)r)r(r(r*�
hide_valueDsrcCst|�}t||d�S)Nr)rr)rrr(r(r*�hide_urlIsrcCs�t�}dD]P}|�dj|d��|�djtjd|d��|�djtjdd�d	|i��q
|oxtoxtj�tj	d�|k}|r�tj
d
dgtj	dd�}td
�d�|����dS)z�Protection of pip.exe from modification on Windows

    On Windows, any operation modifying pip should be run as:
        python -m pip ...
    )rwz.exezpip{ext})rtz
pip{}{ext}rz
pip{}.{}{ext}Nrertz-mrIrqz3To modify pip, please run the following command:
{}� )
�set�addr?rKrirr9r:rJrLrMr
r;)Z
modifying_pipZ	pip_namesrtZshould_show_use_python_msgZnew_commandr(r(r*�(protect_pip_from_modification_on_windowsOs,"������r#cCstjdk	otj��S)z!Is this console interactive?
    N)rK�stdin�isattyr(r(r(r*�is_console_interactivemsr&)F)rp)T)N)r�)�Z
__future__r�
contextlibrGr��ioZloggingr9r�rTrWrK�collectionsrZpip._vendorrZpip._vendor.retryingrZpip._vendor.sixrrZpip._vendor.six.movesr	Zpip._vendor.six.moves.urllibr
r�Z"pip._vendor.six.moves.urllib.parserrrIrZpip._internal.exceptionsr
Zpip._internal.locationsrrrrZpip._internal.utils.compatrrrrZ pip._internal.utils.marker_filesrZpip._internal.utils.typingrZpip._internal.utils.virtualenvrrrr�typingrrrrr r!r"r#r$r%Zpip._vendor.pkg_resourcesr&�intrB�__all__Z	getLoggerr�r�r@rDr6r4r+rUrdr,r-r~r�r.r�r�r0r1�DEFAULT_BUFFER_SIZEr�r2r/r3r�r�r�r�r�r�r�r�r�r�r��objectr�r��contextmanagerr�r5r�r�r7r�r�r�r�rrrrrrrr8rrrrr#r&r(r(r(r*�<module>s�0�	


"

	

	

�
E$




#site-packages/pip/_internal/utils/temp_dir.py000064400000012621151446176770015370 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import errno
import itertools
import logging
import os.path
import tempfile

from pip._internal.utils.misc import rmtree
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Optional


logger = logging.getLogger(__name__)


class TempDirectory(object):
    """Helper class that owns and cleans up a temporary directory.

    This class can be used as a context manager or as an OO representation of a
    temporary directory.

    Attributes:
        path
            Location to the created temporary directory
        delete
            Whether the directory should be deleted when exiting
            (when used as a contextmanager)

    Methods:
        cleanup()
            Deletes the temporary directory

    When used as a context manager, if the delete attribute is True, on
    exiting the context the temporary directory is deleted.
    """

    def __init__(
        self,
        path=None,    # type: Optional[str]
        delete=None,  # type: Optional[bool]
        kind="temp"
    ):
        super(TempDirectory, self).__init__()

        if path is None and delete is None:
            # If we were not given an explicit directory, and we were not given
            # an explicit delete option, then we'll default to deleting.
            delete = True

        if path is None:
            path = self._create(kind)

        self._path = path
        self._deleted = False
        self.delete = delete
        self.kind = kind

    @property
    def path(self):
        # type: () -> str
        assert not self._deleted, (
            "Attempted to access deleted path: {}".format(self._path)
        )
        return self._path

    def __repr__(self):
        return "<{} {!r}>".format(self.__class__.__name__, self.path)

    def __enter__(self):
        return self

    def __exit__(self, exc, value, tb):
        if self.delete:
            self.cleanup()

    def _create(self, kind):
        """Create a temporary directory and store its path in self.path
        """
        # We realpath here because some systems have their default tmpdir
        # symlinked to another directory.  This tends to confuse build
        # scripts, so we canonicalize the path by traversing potential
        # symlinks here.
        path = os.path.realpath(
            tempfile.mkdtemp(prefix="pip-{}-".format(kind))
        )
        logger.debug("Created temporary directory: {}".format(path))
        return path

    def cleanup(self):
        """Remove the temporary directory created and reset state
        """
        self._deleted = True
        if os.path.exists(self._path):
            rmtree(self._path)


class AdjacentTempDirectory(TempDirectory):
    """Helper class that creates a temporary directory adjacent to a real one.

    Attributes:
        original
            The original directory to create a temp directory for.
        path
            After calling create() or entering, contains the full
            path to the temporary directory.
        delete
            Whether the directory should be deleted when exiting
            (when used as a contextmanager)

    """
    # The characters that may be used to name the temp directory
    # We always prepend a ~ and then rotate through these until
    # a usable name is found.
    # pkg_resources raises a different error for .dist-info folder
    # with leading '-' and invalid metadata
    LEADING_CHARS = "-~.=%0123456789"

    def __init__(self, original, delete=None):
        self.original = original.rstrip('/\\')
        super(AdjacentTempDirectory, self).__init__(delete=delete)

    @classmethod
    def _generate_names(cls, name):
        """Generates a series of temporary names.

        The algorithm replaces the leading characters in the name
        with ones that are valid filesystem characters, but are not
        valid package names (for both Python and pip definitions of
        package).
        """
        for i in range(1, len(name)):
            for candidate in itertools.combinations_with_replacement(
                    cls.LEADING_CHARS, i - 1):
                new_name = '~' + ''.join(candidate) + name[i:]
                if new_name != name:
                    yield new_name

        # If we make it this far, we will have to make a longer name
        for i in range(len(cls.LEADING_CHARS)):
            for candidate in itertools.combinations_with_replacement(
                    cls.LEADING_CHARS, i):
                new_name = '~' + ''.join(candidate) + name
                if new_name != name:
                    yield new_name

    def _create(self, kind):
        root, name = os.path.split(self.original)
        for candidate in self._generate_names(name):
            path = os.path.join(root, candidate)
            try:
                os.mkdir(path)
            except OSError as ex:
                # Continue if the name exists already
                if ex.errno != errno.EEXIST:
                    raise
            else:
                path = os.path.realpath(path)
                break
        else:
            # Final fallback on the default behavior.
            path = os.path.realpath(
                tempfile.mkdtemp(prefix="pip-{}-".format(kind))
            )

        logger.debug("Created temporary directory: {}".format(path))
        return path
site-packages/pip/_internal/utils/unpacking.py000064400000022722151446176770015547 0ustar00"""Utilities related archives.
"""

# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import os
import shutil
import stat
import tarfile
import zipfile

from pip._internal.exceptions import InstallationError
from pip._internal.utils.filetypes import (
    BZ2_EXTENSIONS,
    TAR_EXTENSIONS,
    XZ_EXTENSIONS,
    ZIP_EXTENSIONS,
)
from pip._internal.utils.misc import ensure_dir
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Iterable, List, Optional, Text, Union


logger = logging.getLogger(__name__)


SUPPORTED_EXTENSIONS = ZIP_EXTENSIONS + TAR_EXTENSIONS

try:
    import bz2  # noqa
    SUPPORTED_EXTENSIONS += BZ2_EXTENSIONS
except ImportError:
    logger.debug('bz2 module is not available')

try:
    # Only for Python 3.3+
    import lzma  # noqa
    SUPPORTED_EXTENSIONS += XZ_EXTENSIONS
except ImportError:
    logger.debug('lzma module is not available')


def current_umask():
    """Get the current umask which involves having to set it temporarily."""
    mask = os.umask(0)
    os.umask(mask)
    return mask


def split_leading_dir(path):
    # type: (Union[str, Text]) -> List[Union[str, Text]]
    path = path.lstrip('/').lstrip('\\')
    if (
        '/' in path and (
            ('\\' in path and path.find('/') < path.find('\\')) or
            '\\' not in path
        )
    ):
        return path.split('/', 1)
    elif '\\' in path:
        return path.split('\\', 1)
    else:
        return [path, '']


def has_leading_dir(paths):
    # type: (Iterable[Union[str, Text]]) -> bool
    """Returns true if all the paths have the same leading path name
    (i.e., everything is in one subdirectory in an archive)"""
    common_prefix = None
    for path in paths:
        prefix, rest = split_leading_dir(path)
        if not prefix:
            return False
        elif common_prefix is None:
            common_prefix = prefix
        elif prefix != common_prefix:
            return False
    return True


def is_within_directory(directory, target):
    # type: ((Union[str, Text]), (Union[str, Text])) -> bool
    """
    Return true if the absolute path of target is within the directory
    """
    abs_directory = os.path.abspath(directory)
    abs_target = os.path.abspath(target)

    prefix = os.path.commonprefix([abs_directory, abs_target])
    return prefix == abs_directory


def unzip_file(filename, location, flatten=True):
    # type: (str, str, bool) -> None
    """
    Unzip the file (with path `filename`) to the destination `location`.  All
    files are written based on system defaults and umask (i.e. permissions are
    not preserved), except that regular file members with any execute
    permissions (user, group, or world) have "chmod +x" applied after being
    written. Note that for windows, any execute changes using os.chmod are
    no-ops per the python docs.
    """
    ensure_dir(location)
    zipfp = open(filename, 'rb')
    try:
        zip = zipfile.ZipFile(zipfp, allowZip64=True)
        leading = has_leading_dir(zip.namelist()) and flatten
        for info in zip.infolist():
            name = info.filename
            fn = name
            if leading:
                fn = split_leading_dir(name)[1]
            fn = os.path.join(location, fn)
            dir = os.path.dirname(fn)
            if not is_within_directory(location, fn):
                message = (
                    'The zip file ({}) has a file ({}) trying to install '
                    'outside target directory ({})'
                )
                raise InstallationError(message.format(filename, fn, location))
            if fn.endswith('/') or fn.endswith('\\'):
                # A directory
                ensure_dir(fn)
            else:
                ensure_dir(dir)
                # Don't use read() to avoid allocating an arbitrarily large
                # chunk of memory for the file's content
                fp = zip.open(name)
                try:
                    with open(fn, 'wb') as destfp:
                        shutil.copyfileobj(fp, destfp)
                finally:
                    fp.close()
                    mode = info.external_attr >> 16
                    # if mode and regular file and any execute permissions for
                    # user/group/world?
                    if mode and stat.S_ISREG(mode) and mode & 0o111:
                        # make dest file have execute for user/group/world
                        # (chmod +x) no-op on windows per python docs
                        os.chmod(fn, (0o777 - current_umask() | 0o111))
    finally:
        zipfp.close()


def untar_file(filename, location):
    # type: (str, str) -> None
    """
    Untar the file (with path `filename`) to the destination `location`.
    All files are written based on system defaults and umask (i.e. permissions
    are not preserved), except that regular file members with any execute
    permissions (user, group, or world) have "chmod +x" applied after being
    written.  Note that for windows, any execute changes using os.chmod are
    no-ops per the python docs.
    """
    ensure_dir(location)
    if filename.lower().endswith('.gz') or filename.lower().endswith('.tgz'):
        mode = 'r:gz'
    elif filename.lower().endswith(BZ2_EXTENSIONS):
        mode = 'r:bz2'
    elif filename.lower().endswith(XZ_EXTENSIONS):
        mode = 'r:xz'
    elif filename.lower().endswith('.tar'):
        mode = 'r'
    else:
        logger.warning(
            'Cannot determine compression type for file %s', filename,
        )
        mode = 'r:*'
    tar = tarfile.open(filename, mode)
    try:
        leading = has_leading_dir([
            member.name for member in tar.getmembers()
        ])
        for member in tar.getmembers():
            fn = member.name
            if leading:
                # https://github.com/python/mypy/issues/1174
                fn = split_leading_dir(fn)[1]  # type: ignore
            path = os.path.join(location, fn)
            if not is_within_directory(location, path):
                message = (
                    'The tar file ({}) has a file ({}) trying to install '
                    'outside target directory ({})'
                )
                raise InstallationError(
                    message.format(filename, path, location)
                )

            # Call the `data` filter for its side effect (raising exception)
            try:
                tarfile.data_filter(member.replace(name=fn), location)
            except tarfile.LinkOutsideDestinationError:
                pass

            if member.isdir():
                ensure_dir(path)
            elif member.issym():
                try:
                    # https://github.com/python/typeshed/issues/2673
                    tar._extract_member(member, path)  # type: ignore
                except Exception as exc:
                    # Some corrupt tar files seem to produce this
                    # (specifically bad symlinks)
                    logger.warning(
                        'In the tar file %s the member %s is invalid: %s',
                        filename, member.name, exc,
                    )
                    continue
            else:
                try:
                    fp = tar.extractfile(member)
                except (KeyError, AttributeError) as exc:
                    # Some corrupt tar files seem to produce this
                    # (specifically bad symlinks)
                    logger.warning(
                        'In the tar file %s the member %s is invalid: %s',
                        filename, member.name, exc,
                    )
                    continue
                ensure_dir(os.path.dirname(path))
                with open(path, 'wb') as destfp:
                    shutil.copyfileobj(fp, destfp)
                fp.close()
                # Update the timestamp (useful for cython compiled files)
                # https://github.com/python/typeshed/issues/2673
                tar.utime(member, path)  # type: ignore
                # member have any execute permissions for user/group/world?
                if member.mode & 0o111:
                    # make dest file have execute for user/group/world
                    # no-op on windows per python docs
                    os.chmod(path, (0o777 - current_umask() | 0o111))
    finally:
        tar.close()


def unpack_file(
        filename,  # type: str
        location,  # type: str
        content_type=None,  # type: Optional[str]
):
    # type: (...) -> None
    filename = os.path.realpath(filename)
    if (
        content_type == 'application/zip' or
        filename.lower().endswith(ZIP_EXTENSIONS) or
        zipfile.is_zipfile(filename)
    ):
        unzip_file(
            filename,
            location,
            flatten=not filename.endswith('.whl')
        )
    elif (
        content_type == 'application/x-gzip' or
        tarfile.is_tarfile(filename) or
        filename.lower().endswith(
            TAR_EXTENSIONS + BZ2_EXTENSIONS + XZ_EXTENSIONS
        )
    ):
        untar_file(filename, location)
    else:
        # FIXME: handle?
        # FIXME: magic signatures?
        logger.critical(
            'Cannot unpack file %s (downloaded from %s, content-type: %s); '
            'cannot detect archive format',
            filename, location, content_type,
        )
        raise InstallationError(
            'Cannot determine archive format of {}'.format(location)
        )
site-packages/pip/_internal/utils/deprecation.py000064400000006366151446176770016073 0ustar00"""
A module that implements tooling to enable easy warnings about deprecations.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import warnings

from pip._vendor.packaging.version import parse

from pip import __version__ as current_version
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Any, Optional


DEPRECATION_MSG_PREFIX = "DEPRECATION: "


class PipDeprecationWarning(Warning):
    pass


_original_showwarning = None  # type: Any


# Warnings <-> Logging Integration
def _showwarning(message, category, filename, lineno, file=None, line=None):
    if file is not None:
        if _original_showwarning is not None:
            _original_showwarning(
                message, category, filename, lineno, file, line,
            )
    elif issubclass(category, PipDeprecationWarning):
        # We use a specially named logger which will handle all of the
        # deprecation messages for pip.
        logger = logging.getLogger("pip._internal.deprecations")
        logger.warning(message)
    else:
        _original_showwarning(
            message, category, filename, lineno, file, line,
        )


def install_warning_logger():
    # type: () -> None
    # Enable our Deprecation Warnings
    warnings.simplefilter("default", PipDeprecationWarning, append=True)

    global _original_showwarning

    if _original_showwarning is None:
        _original_showwarning = warnings.showwarning
        warnings.showwarning = _showwarning


def deprecated(reason, replacement, gone_in, issue=None):
    # type: (str, Optional[str], Optional[str], Optional[int]) -> None
    """Helper to deprecate existing functionality.

    reason:
        Textual reason shown to the user about why this functionality has
        been deprecated.
    replacement:
        Textual suggestion shown to the user about what alternative
        functionality they can use.
    gone_in:
        The version of pip does this functionality should get removed in.
        Raises errors if pip's current version is greater than or equal to
        this.
    issue:
        Issue number on the tracker that would serve as a useful place for
        users to find related discussion and provide feedback.

    Always pass replacement, gone_in and issue as keyword arguments for clarity
    at the call site.
    """

    # Construct a nice message.
    #   This is eagerly formatted as we want it to get logged as if someone
    #   typed this entire message out.
    sentences = [
        (reason, DEPRECATION_MSG_PREFIX + "{}"),
        (gone_in, "pip {} will remove support for this functionality."),
        (replacement, "A possible replacement is {}."),
        (issue, (
            "You can find discussion regarding this at "
            "https://github.com/pypa/pip/issues/{}."
        )),
    ]
    message = " ".join(
        template.format(val) for val, template in sentences if val is not None
    )

    # Raise as an error if it has to be removed.
    if gone_in is not None and parse(current_version) >= parse(gone_in):
        raise PipDeprecationWarning(message)

    warnings.warn(message, category=PipDeprecationWarning, stacklevel=2)
site-packages/pip/_internal/utils/__init__.py000064400000000000151446176770015310 0ustar00site-packages/pip/_internal/utils/appdirs.py000064400000023046151446176770015232 0ustar00"""
This code was taken from https://github.com/ActiveState/appdirs and modified
to suit our purposes.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import os
import sys

from pip._vendor.six import PY2, text_type

from pip._internal.utils.compat import WINDOWS, expanduser
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import List


def user_cache_dir(appname):
    # type: (str) -> str
    r"""
    Return full path to the user-specific cache dir for this application.

        "appname" is the name of application.

    Typical user cache directories are:
        macOS:      ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Windows:    C:\Users\<username>\AppData\Local\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go
    in the `CSIDL_LOCAL_APPDATA` directory. This is identical to the
    non-roaming app data dir (the default returned by `user_data_dir`). Apps
    typically put cache data somewhere *under* the given dir here. Some
    examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0

    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    """
    if WINDOWS:
        # Get the base path
        path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA"))

        # When using Python 2, return paths as bytes on Windows like we do on
        # other operating systems. See helper function docs for more details.
        if PY2 and isinstance(path, text_type):
            path = _win_path_to_bytes(path)

        # Add our app name and Cache directory to it
        path = os.path.join(path, appname, "Cache")
    elif sys.platform == "darwin":
        # Get the base path
        path = expanduser("~/Library/Caches")

        # Add our app name to it
        path = os.path.join(path, appname)
    else:
        # Get the base path
        path = os.getenv("XDG_CACHE_HOME", expanduser("~/.cache"))

        # Add our app name to it
        path = os.path.join(path, appname)

    return path


def user_data_dir(appname, roaming=False):
    # type: (str, bool) -> str
    r"""
    Return full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  ~/Library/Application Support/<AppName>
                                if it exists, else ~/.config/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in
                                $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\ ...
                                ...Application Data\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local ...
                                ...Settings\Application Data\<AppName>
        Win 7  (not roaming):   C:\\Users\<username>\AppData\Local\<AppName>
        Win 7  (roaming):       C:\\Users\<username>\AppData\Roaming\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    """
    if WINDOWS:
        const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA"
        path = os.path.join(os.path.normpath(_get_win_folder(const)), appname)
    elif sys.platform == "darwin":
        path = os.path.join(
            expanduser('~/Library/Application Support/'),
            appname,
        ) if os.path.isdir(os.path.join(
            expanduser('~/Library/Application Support/'),
            appname,
        )
        ) else os.path.join(
            expanduser('~/.config/'),
            appname,
        )
    else:
        path = os.path.join(
            os.getenv('XDG_DATA_HOME', expanduser("~/.local/share")),
            appname,
        )

    return path


def user_config_dir(appname, roaming=True):
    # type: (str, bool) -> str
    """Return full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "roaming" (boolean, default True) can be set False to not use the
            Windows roaming appdata directory. That means that for users on a
            Windows network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        macOS:                  same as user_data_dir
        Unix:                   ~/.config/<AppName>
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    """
    if WINDOWS:
        path = user_data_dir(appname, roaming=roaming)
    elif sys.platform == "darwin":
        path = user_data_dir(appname)
    else:
        path = os.getenv('XDG_CONFIG_HOME', expanduser("~/.config"))
        path = os.path.join(path, appname)

    return path


# for the discussion regarding site_config_dirs locations
# see <https://github.com/pypa/pip/issues/1733>
def site_config_dirs(appname):
    # type: (str) -> List[str]
    r"""Return a list of potential user-shared config dirs for this application.

        "appname" is the name of application.

    Typical user config directories are:
        macOS:      /Library/Application Support/<AppName>/
        Unix:       /etc or $XDG_CONFIG_DIRS[i]/<AppName>/ for each value in
                    $XDG_CONFIG_DIRS
        Win XP:     C:\Documents and Settings\All Users\Application ...
                    ...Data\<AppName>\
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory
                    on Vista.)
        Win 7:      Hidden, but writeable on Win 7:
                    C:\ProgramData\<AppName>\
    """
    if WINDOWS:
        path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA"))
        pathlist = [os.path.join(path, appname)]
    elif sys.platform == 'darwin':
        pathlist = [os.path.join('/Library/Application Support', appname)]
    else:
        # try looking in $XDG_CONFIG_DIRS
        xdg_config_dirs = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg')
        if xdg_config_dirs:
            pathlist = [
                os.path.join(expanduser(x), appname)
                for x in xdg_config_dirs.split(os.pathsep)
            ]
        else:
            pathlist = []

        # always look in /etc directly as well
        pathlist.append('/etc')

    return pathlist


# -- Windows support functions --

def _get_win_folder_from_registry(csidl_name):
    # type: (str) -> str
    """
    This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    """
    import _winreg

    shell_folder_name = {
        "CSIDL_APPDATA": "AppData",
        "CSIDL_COMMON_APPDATA": "Common AppData",
        "CSIDL_LOCAL_APPDATA": "Local AppData",
    }[csidl_name]

    key = _winreg.OpenKey(
        _winreg.HKEY_CURRENT_USER,
        r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders"
    )
    directory, _type = _winreg.QueryValueEx(key, shell_folder_name)
    return directory


def _get_win_folder_with_ctypes(csidl_name):
    # type: (str) -> str
    # On Python 2, ctypes.create_unicode_buffer().value returns "unicode",
    # which isn't the same as str in the annotation above.
    csidl_const = {
        "CSIDL_APPDATA": 26,
        "CSIDL_COMMON_APPDATA": 35,
        "CSIDL_LOCAL_APPDATA": 28,
    }[csidl_name]

    buf = ctypes.create_unicode_buffer(1024)
    windll = ctypes.windll  # type: ignore
    windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)

    # Downgrade to short path name if have highbit chars. See
    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
    has_high_char = False
    for c in buf:
        if ord(c) > 255:
            has_high_char = True
            break
    if has_high_char:
        buf2 = ctypes.create_unicode_buffer(1024)
        if windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
            buf = buf2

    # The type: ignore is explained under the type annotation for this function
    return buf.value  # type: ignore


if WINDOWS:
    try:
        import ctypes
        _get_win_folder = _get_win_folder_with_ctypes
    except ImportError:
        _get_win_folder = _get_win_folder_from_registry


def _win_path_to_bytes(path):
    """Encode Windows paths to bytes. Only used on Python 2.

    Motivation is to be consistent with other operating systems where paths
    are also returned as bytes. This avoids problems mixing bytes and Unicode
    elsewhere in the codebase. For more details and discussion see
    <https://github.com/pypa/pip/issues/3463>.

    If encoding using ASCII and MBCS fails, return the original Unicode path.
    """
    for encoding in ('ASCII', 'MBCS'):
        try:
            return path.encode(encoding)
        except (UnicodeEncodeError, LookupError):
            pass
    return path
site-packages/pip/_internal/utils/models.py000064400000002174151446176770015052 0ustar00"""Utilities for defining models
"""
# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

import operator


class KeyBasedCompareMixin(object):
    """Provides comparison capabilities that is based on a key
    """

    def __init__(self, key, defining_class):
        self._compare_key = key
        self._defining_class = defining_class

    def __hash__(self):
        return hash(self._compare_key)

    def __lt__(self, other):
        return self._compare(other, operator.__lt__)

    def __le__(self, other):
        return self._compare(other, operator.__le__)

    def __gt__(self, other):
        return self._compare(other, operator.__gt__)

    def __ge__(self, other):
        return self._compare(other, operator.__ge__)

    def __eq__(self, other):
        return self._compare(other, operator.__eq__)

    def __ne__(self, other):
        return self._compare(other, operator.__ne__)

    def _compare(self, other, method):
        if not isinstance(other, self._defining_class):
            return NotImplemented

        return method(self._compare_key, other._compare_key)
site-packages/pip/_internal/utils/inject_securetransport.py000064400000001452151446176770020364 0ustar00"""A helper module that injects SecureTransport, on import.

The import should be done as early as possible, to ensure all requests and
sessions (or whatever) are created after injecting SecureTransport.

Note that we only do the injection on macOS, when the linked OpenSSL is too
old to handle TLSv1.2.
"""

import sys


def inject_securetransport():
    # type: () -> None
    # Only relevant on macOS
    if sys.platform != "darwin":
        return

    try:
        import ssl
    except ImportError:
        return

    # Checks for OpenSSL 1.0.1
    if ssl.OPENSSL_VERSION_NUMBER >= 0x1000100f:
        return

    try:
        from pip._vendor.urllib3.contrib import securetransport
    except (ImportError, OSError):
        return

    securetransport.inject_into_urllib3()


inject_securetransport()
site-packages/pip/_internal/utils/misc.py000064400000061753151446176770014532 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import contextlib
import errno
import getpass
import io
import logging
import os
import posixpath
import shutil
import stat
import sys
from collections import deque

from pip._vendor import pkg_resources
# NOTE: retrying is not annotated in typeshed as on 2017-07-17, which is
#       why we ignore the type on this import.
from pip._vendor.retrying import retry  # type: ignore
from pip._vendor.six import PY2, text_type
from pip._vendor.six.moves import input
from pip._vendor.six.moves.urllib import parse as urllib_parse
from pip._vendor.six.moves.urllib.parse import unquote as urllib_unquote

from pip import __version__
from pip._internal.exceptions import CommandError
from pip._internal.locations import (
    distutils_scheme,
    get_major_minor_version,
    site_packages,
    user_site,
)
from pip._internal.utils.compat import (
    WINDOWS,
    expanduser,
    stdlib_pkgs,
    str_to_display,
)
from pip._internal.utils.marker_files import write_delete_marker_file
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.virtualenv import (
    running_under_virtualenv,
    virtualenv_no_global,
)

if PY2:
    from io import BytesIO as StringIO
else:
    from io import StringIO

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, AnyStr, Container, Iterable, List, Optional, Text,
        Tuple, Union, cast,
    )
    from pip._vendor.pkg_resources import Distribution

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


__all__ = ['rmtree', 'display_path', 'backup_dir',
           'ask', 'splitext',
           'format_size', 'is_installable_dir',
           'normalize_path',
           'renames', 'get_prog',
           'captured_stdout', 'ensure_dir',
           'get_installed_version', 'remove_auth_from_url']


logger = logging.getLogger(__name__)


def get_pip_version():
    # type: () -> str
    pip_pkg_dir = os.path.join(os.path.dirname(__file__), "..", "..")
    pip_pkg_dir = os.path.abspath(pip_pkg_dir)

    return (
        'pip {} from {} (python {})'.format(
            __version__, pip_pkg_dir, get_major_minor_version(),
        )
    )


def normalize_version_info(py_version_info):
    # type: (Tuple[int, ...]) -> Tuple[int, int, int]
    """
    Convert a tuple of ints representing a Python version to one of length
    three.

    :param py_version_info: a tuple of ints representing a Python version,
        or None to specify no version. The tuple can have any length.

    :return: a tuple of length three if `py_version_info` is non-None.
        Otherwise, return `py_version_info` unchanged (i.e. None).
    """
    if len(py_version_info) < 3:
        py_version_info += (3 - len(py_version_info)) * (0,)
    elif len(py_version_info) > 3:
        py_version_info = py_version_info[:3]

    return cast('VersionInfo', py_version_info)


def ensure_dir(path):
    # type: (AnyStr) -> None
    """os.path.makedirs without EEXIST."""
    try:
        os.makedirs(path)
    except OSError as e:
        if e.errno != errno.EEXIST:
            raise


def get_prog():
    # type: () -> str
    try:
        prog = os.path.basename(sys.argv[0])
        if prog in ('__main__.py', '-c'):
            return "%s -m pip" % sys.executable
        else:
            return prog
    except (AttributeError, TypeError, IndexError):
        pass
    return 'pip'


# Retry every half second for up to 3 seconds
@retry(stop_max_delay=3000, wait_fixed=500)
def rmtree(dir, ignore_errors=False):
    # type: (str, bool) -> None
    shutil.rmtree(dir, ignore_errors=ignore_errors,
                  onerror=rmtree_errorhandler)


def rmtree_errorhandler(func, path, exc_info):
    """On Windows, the files in .svn are read-only, so when rmtree() tries to
    remove them, an exception is thrown.  We catch that here, remove the
    read-only attribute, and hopefully continue without problems."""
    try:
        has_attr_readonly = not (os.stat(path).st_mode & stat.S_IWRITE)
    except (IOError, OSError):
        # it's equivalent to os.path.exists
        return

    if has_attr_readonly:
        # convert to read/write
        os.chmod(path, stat.S_IWRITE)
        # use the original function to repeat the operation
        func(path)
        return
    else:
        raise


def path_to_display(path):
    # type: (Optional[Union[str, Text]]) -> Optional[Text]
    """
    Convert a bytes (or text) path to text (unicode in Python 2) for display
    and logging purposes.

    This function should never error out. Also, this function is mainly needed
    for Python 2 since in Python 3 str paths are already text.
    """
    if path is None:
        return None
    if isinstance(path, text_type):
        return path
    # Otherwise, path is a bytes object (str in Python 2).
    try:
        display_path = path.decode(sys.getfilesystemencoding(), 'strict')
    except UnicodeDecodeError:
        # Include the full bytes to make troubleshooting easier, even though
        # it may not be very human readable.
        if PY2:
            # Convert the bytes to a readable str representation using
            # repr(), and then convert the str to unicode.
            #   Also, we add the prefix "b" to the repr() return value both
            # to make the Python 2 output look like the Python 3 output, and
            # to signal to the user that this is a bytes representation.
            display_path = str_to_display('b{!r}'.format(path))
        else:
            # Silence the "F821 undefined name 'ascii'" flake8 error since
            # in Python 3 ascii() is a built-in.
            display_path = ascii(path)  # noqa: F821

    return display_path


def display_path(path):
    # type: (Union[str, Text]) -> str
    """Gives the display value for a given path, making it relative to cwd
    if possible."""
    path = os.path.normcase(os.path.abspath(path))
    if sys.version_info[0] == 2:
        path = path.decode(sys.getfilesystemencoding(), 'replace')
        path = path.encode(sys.getdefaultencoding(), 'replace')
    if path.startswith(os.getcwd() + os.path.sep):
        path = '.' + path[len(os.getcwd()):]
    return path


def backup_dir(dir, ext='.bak'):
    # type: (str, str) -> str
    """Figure out the name of a directory to back up the given dir to
    (adding .bak, .bak2, etc)"""
    n = 1
    extension = ext
    while os.path.exists(dir + extension):
        n += 1
        extension = ext + str(n)
    return dir + extension


def ask_path_exists(message, options):
    # type: (str, Iterable[str]) -> str
    for action in os.environ.get('PIP_EXISTS_ACTION', '').split():
        if action in options:
            return action
    return ask(message, options)


def _check_no_input(message):
    # type: (str) -> None
    """Raise an error if no input is allowed."""
    if os.environ.get('PIP_NO_INPUT'):
        raise Exception(
            'No input was expected ($PIP_NO_INPUT set); question: %s' %
            message
        )


def ask(message, options):
    # type: (str, Iterable[str]) -> str
    """Ask the message interactively, with the given possible responses"""
    while 1:
        _check_no_input(message)
        response = input(message)
        response = response.strip().lower()
        if response not in options:
            print(
                'Your response (%r) was not one of the expected responses: '
                '%s' % (response, ', '.join(options))
            )
        else:
            return response


def ask_input(message):
    # type: (str) -> str
    """Ask for input interactively."""
    _check_no_input(message)
    return input(message)


def ask_password(message):
    # type: (str) -> str
    """Ask for a password interactively."""
    _check_no_input(message)
    return getpass.getpass(message)


def format_size(bytes):
    # type: (float) -> str
    if bytes > 1000 * 1000:
        return '%.1fMB' % (bytes / 1000.0 / 1000)
    elif bytes > 10 * 1000:
        return '%ikB' % (bytes / 1000)
    elif bytes > 1000:
        return '%.1fkB' % (bytes / 1000.0)
    else:
        return '%ibytes' % bytes


def is_installable_dir(path):
    # type: (str) -> bool
    """Is path is a directory containing setup.py or pyproject.toml?
    """
    if not os.path.isdir(path):
        return False
    setup_py = os.path.join(path, 'setup.py')
    if os.path.isfile(setup_py):
        return True
    pyproject_toml = os.path.join(path, 'pyproject.toml')
    if os.path.isfile(pyproject_toml):
        return True
    return False


def read_chunks(file, size=io.DEFAULT_BUFFER_SIZE):
    """Yield pieces of data from a file-like object until EOF."""
    while True:
        chunk = file.read(size)
        if not chunk:
            break
        yield chunk


def normalize_path(path, resolve_symlinks=True):
    # type: (str, bool) -> str
    """
    Convert a path to its canonical, case-normalized, absolute version.

    """
    path = expanduser(path)
    if resolve_symlinks:
        path = os.path.realpath(path)
    else:
        path = os.path.abspath(path)
    return os.path.normcase(path)


def splitext(path):
    # type: (str) -> Tuple[str, str]
    """Like os.path.splitext, but take off .tar too"""
    base, ext = posixpath.splitext(path)
    if base.lower().endswith('.tar'):
        ext = base[-4:] + ext
        base = base[:-4]
    return base, ext


def renames(old, new):
    # type: (str, str) -> None
    """Like os.renames(), but handles renaming across devices."""
    # Implementation borrowed from os.renames().
    head, tail = os.path.split(new)
    if head and tail and not os.path.exists(head):
        os.makedirs(head)

    shutil.move(old, new)

    head, tail = os.path.split(old)
    if head and tail:
        try:
            os.removedirs(head)
        except OSError:
            pass


def is_local(path):
    # type: (str) -> bool
    """
    Return True if path is within sys.prefix, if we're running in a virtualenv.

    If we're not in a virtualenv, all paths are considered "local."

    Caution: this function assumes the head of path has been normalized
    with normalize_path.
    """
    if not running_under_virtualenv():
        return True
    return path.startswith(normalize_path(sys.prefix))


def dist_is_local(dist):
    # type: (Distribution) -> bool
    """
    Return True if given Distribution object is installed locally
    (i.e. within current virtualenv).

    Always True if we're not in a virtualenv.

    """
    return is_local(dist_location(dist))


def dist_in_usersite(dist):
    # type: (Distribution) -> bool
    """
    Return True if given Distribution is installed in user site.
    """
    return dist_location(dist).startswith(normalize_path(user_site))


def dist_in_site_packages(dist):
    # type: (Distribution) -> bool
    """
    Return True if given Distribution is installed in
    sysconfig.get_python_lib().
    """
    return dist_location(dist).startswith(normalize_path(site_packages))


def dist_in_install_path(dist):
    """
    Return True if given Distribution is installed in
    path matching distutils_scheme layout.
    """
    norm_path = normalize_path(dist_location(dist))
    return norm_path.startswith(normalize_path(
        distutils_scheme("")['purelib'].split('python')[0]))


def dist_is_editable(dist):
    # type: (Distribution) -> bool
    """
    Return True if given Distribution is an editable install.
    """
    for path_item in sys.path:
        egg_link = os.path.join(path_item, dist.project_name + '.egg-link')
        if os.path.isfile(egg_link):
            return True
    return False


def get_installed_distributions(
        local_only=True,  # type: bool
        skip=stdlib_pkgs,  # type: Container[str]
        include_editables=True,  # type: bool
        editables_only=False,  # type: bool
        user_only=False,  # type: bool
        paths=None  # type: Optional[List[str]]
):
    # type: (...) -> List[Distribution]
    """
    Return a list of installed Distribution objects.

    If ``local_only`` is True (default), only return installations
    local to the current virtualenv, if in a virtualenv.

    ``skip`` argument is an iterable of lower-case project names to
    ignore; defaults to stdlib_pkgs

    If ``include_editables`` is False, don't report editables.

    If ``editables_only`` is True , only report editables.

    If ``user_only`` is True , only report installations in the user
    site directory.

    If ``paths`` is set, only report the distributions present at the
    specified list of locations.
    """
    if paths:
        working_set = pkg_resources.WorkingSet(paths)
    else:
        working_set = pkg_resources.working_set

    if local_only:
        local_test = dist_is_local
    else:
        def local_test(d):
            return True

    if include_editables:
        def editable_test(d):
            return True
    else:
        def editable_test(d):
            return not dist_is_editable(d)

    if editables_only:
        def editables_only_test(d):
            return dist_is_editable(d)
    else:
        def editables_only_test(d):
            return True

    if user_only:
        user_test = dist_in_usersite
    else:
        def user_test(d):
            return True

    # because of pkg_resources vendoring, mypy cannot find stub in typeshed
    return [d for d in working_set  # type: ignore
            if local_test(d) and
            d.key not in skip and
            editable_test(d) and
            editables_only_test(d) and
            user_test(d)
            ]


def egg_link_path(dist):
    # type: (Distribution) -> Optional[str]
    """
    Return the path for the .egg-link file if it exists, otherwise, None.

    There's 3 scenarios:
    1) not in a virtualenv
       try to find in site.USER_SITE, then site_packages
    2) in a no-global virtualenv
       try to find in site_packages
    3) in a yes-global virtualenv
       try to find in site_packages, then site.USER_SITE
       (don't look in global location)

    For #1 and #3, there could be odd cases, where there's an egg-link in 2
    locations.

    This method will just return the first one found.
    """
    sites = []
    if running_under_virtualenv():
        sites.append(site_packages)
        if not virtualenv_no_global() and user_site:
            sites.append(user_site)
    else:
        if user_site:
            sites.append(user_site)
        sites.append(site_packages)

    for site in sites:
        egglink = os.path.join(site, dist.project_name) + '.egg-link'
        if os.path.isfile(egglink):
            return egglink
    return None


def dist_location(dist):
    # type: (Distribution) -> str
    """
    Get the site-packages location of this distribution. Generally
    this is dist.location, except in the case of develop-installed
    packages, where dist.location is the source code location, and we
    want to know where the egg-link file is.

    The returned location is normalized (in particular, with symlinks removed).
    """
    egg_link = egg_link_path(dist)
    if egg_link:
        return normalize_path(egg_link)
    return normalize_path(dist.location)


def write_output(msg, *args):
    # type: (str, str) -> None
    logger.info(msg, *args)


def _make_build_dir(build_dir):
    os.makedirs(build_dir)
    write_delete_marker_file(build_dir)


class FakeFile(object):
    """Wrap a list of lines in an object with readline() to make
    ConfigParser happy."""
    def __init__(self, lines):
        self._gen = (l for l in lines)

    def readline(self):
        try:
            try:
                return next(self._gen)
            except NameError:
                return self._gen.next()
        except StopIteration:
            return ''

    def __iter__(self):
        return self._gen


class StreamWrapper(StringIO):

    @classmethod
    def from_stream(cls, orig_stream):
        cls.orig_stream = orig_stream
        return cls()

    # compileall.compile_dir() needs stdout.encoding to print to stdout
    @property
    def encoding(self):
        return self.orig_stream.encoding


@contextlib.contextmanager
def captured_output(stream_name):
    """Return a context manager used by captured_stdout/stdin/stderr
    that temporarily replaces the sys stream *stream_name* with a StringIO.

    Taken from Lib/support/__init__.py in the CPython repo.
    """
    orig_stdout = getattr(sys, stream_name)
    setattr(sys, stream_name, StreamWrapper.from_stream(orig_stdout))
    try:
        yield getattr(sys, stream_name)
    finally:
        setattr(sys, stream_name, orig_stdout)


def captured_stdout():
    """Capture the output of sys.stdout:

       with captured_stdout() as stdout:
           print('hello')
       self.assertEqual(stdout.getvalue(), 'hello\n')

    Taken from Lib/support/__init__.py in the CPython repo.
    """
    return captured_output('stdout')


def captured_stderr():
    """
    See captured_stdout().
    """
    return captured_output('stderr')


class cached_property(object):
    """A property that is only computed once per instance and then replaces
       itself with an ordinary attribute. Deleting the attribute resets the
       property.

       Source: https://github.com/bottlepy/bottle/blob/0.11.5/bottle.py#L175
    """

    def __init__(self, func):
        self.__doc__ = getattr(func, '__doc__')
        self.func = func

    def __get__(self, obj, cls):
        if obj is None:
            # We're being accessed from the class itself, not from an object
            return self
        value = obj.__dict__[self.func.__name__] = self.func(obj)
        return value


def get_installed_version(dist_name, working_set=None):
    """Get the installed version of dist_name avoiding pkg_resources cache"""
    # Create a requirement that we'll look for inside of setuptools.
    req = pkg_resources.Requirement.parse(dist_name)

    if working_set is None:
        # We want to avoid having this cached, so we need to construct a new
        # working set each time.
        working_set = pkg_resources.WorkingSet()

    # Get the installed distribution from our working set
    dist = working_set.find(req)

    # Check to see if we got an installed distribution or not, if we did
    # we want to return it's version.
    return dist.version if dist else None


def consume(iterator):
    """Consume an iterable at C speed."""
    deque(iterator, maxlen=0)


# Simulates an enum
def enum(*sequential, **named):
    enums = dict(zip(sequential, range(len(sequential))), **named)
    reverse = {value: key for key, value in enums.items()}
    enums['reverse_mapping'] = reverse
    return type('Enum', (), enums)


def build_netloc(host, port):
    # type: (str, Optional[int]) -> str
    """
    Build a netloc from a host-port pair
    """
    if port is None:
        return host
    if ':' in host:
        # Only wrap host with square brackets when it is IPv6
        host = '[{}]'.format(host)
    return '{}:{}'.format(host, port)


def build_url_from_netloc(netloc, scheme='https'):
    # type: (str, str) -> str
    """
    Build a full URL from a netloc.
    """
    if netloc.count(':') >= 2 and '@' not in netloc and '[' not in netloc:
        # It must be a bare IPv6 address, so wrap it with brackets.
        netloc = '[{}]'.format(netloc)
    return '{}://{}'.format(scheme, netloc)


def parse_netloc(netloc):
    # type: (str) -> Tuple[str, Optional[int]]
    """
    Return the host-port pair from a netloc.
    """
    url = build_url_from_netloc(netloc)
    parsed = urllib_parse.urlparse(url)
    return parsed.hostname, parsed.port


def split_auth_from_netloc(netloc):
    """
    Parse out and remove the auth information from a netloc.

    Returns: (netloc, (username, password)).
    """
    if '@' not in netloc:
        return netloc, (None, None)

    # Split from the right because that's how urllib.parse.urlsplit()
    # behaves if more than one @ is present (which can be checked using
    # the password attribute of urlsplit()'s return value).
    auth, netloc = netloc.rsplit('@', 1)
    if ':' in auth:
        # Split from the left because that's how urllib.parse.urlsplit()
        # behaves if more than one : is present (which again can be checked
        # using the password attribute of the return value)
        user_pass = auth.split(':', 1)
    else:
        user_pass = auth, None

    user_pass = tuple(
        None if x is None else urllib_unquote(x) for x in user_pass
    )

    return netloc, user_pass


def redact_netloc(netloc):
    # type: (str) -> str
    """
    Replace the sensitive data in a netloc with "****", if it exists.

    For example:
        - "user:pass@example.com" returns "user:****@example.com"
        - "accesstoken@example.com" returns "****@example.com"
    """
    netloc, (user, password) = split_auth_from_netloc(netloc)
    if user is None:
        return netloc
    if password is None:
        user = '****'
        password = ''
    else:
        user = urllib_parse.quote(user)
        password = ':****'
    return '{user}{password}@{netloc}'.format(user=user,
                                              password=password,
                                              netloc=netloc)


def _transform_url(url, transform_netloc):
    """Transform and replace netloc in a url.

    transform_netloc is a function taking the netloc and returning a
    tuple. The first element of this tuple is the new netloc. The
    entire tuple is returned.

    Returns a tuple containing the transformed url as item 0 and the
    original tuple returned by transform_netloc as item 1.
    """
    purl = urllib_parse.urlsplit(url)
    netloc_tuple = transform_netloc(purl.netloc)
    # stripped url
    url_pieces = (
        purl.scheme, netloc_tuple[0], purl.path, purl.query, purl.fragment
    )
    surl = urllib_parse.urlunsplit(url_pieces)
    return surl, netloc_tuple


def _get_netloc(netloc):
    return split_auth_from_netloc(netloc)


def _redact_netloc(netloc):
    return (redact_netloc(netloc),)


def split_auth_netloc_from_url(url):
    # type: (str) -> Tuple[str, str, Tuple[str, str]]
    """
    Parse a url into separate netloc, auth, and url with no auth.

    Returns: (url_without_auth, netloc, (username, password))
    """
    url_without_auth, (netloc, auth) = _transform_url(url, _get_netloc)
    return url_without_auth, netloc, auth


def remove_auth_from_url(url):
    # type: (str) -> str
    """Return a copy of url with 'username:password@' removed."""
    # username/pass params are passed to subversion through flags
    # and are not recognized in the url.
    return _transform_url(url, _get_netloc)[0]


def redact_auth_from_url(url):
    # type: (str) -> str
    """Replace the password in a given url with ****."""
    return _transform_url(url, _redact_netloc)[0]


class HiddenText(object):
    def __init__(
        self,
        secret,    # type: str
        redacted,  # type: str
    ):
        # type: (...) -> None
        self.secret = secret
        self.redacted = redacted

    def __repr__(self):
        # type: (...) -> str
        return '<HiddenText {!r}>'.format(str(self))

    def __str__(self):
        # type: (...) -> str
        return self.redacted

    # This is useful for testing.
    def __eq__(self, other):
        # type: (Any) -> bool
        if type(self) != type(other):
            return False

        # The string being used for redaction doesn't also have to match,
        # just the raw, original string.
        return (self.secret == other.secret)

    # We need to provide an explicit __ne__ implementation for Python 2.
    # TODO: remove this when we drop PY2 support.
    def __ne__(self, other):
        # type: (Any) -> bool
        return not self == other


def hide_value(value):
    # type: (str) -> HiddenText
    return HiddenText(value, redacted='****')


def hide_url(url):
    # type: (str) -> HiddenText
    redacted = redact_auth_from_url(url)
    return HiddenText(url, redacted=redacted)


def protect_pip_from_modification_on_windows(modifying_pip):
    # type: (bool) -> None
    """Protection of pip.exe from modification on Windows

    On Windows, any operation modifying pip should be run as:
        python -m pip ...
    """
    pip_names = set()
    for ext in ('', '.exe'):
        pip_names.add('pip{ext}'.format(ext=ext))
        pip_names.add('pip{}{ext}'.format(sys.version_info[0], ext=ext))
        pip_names.add('pip{}.{}{ext}'.format(*sys.version_info[:2], ext=ext))

    # See https://github.com/pypa/pip/issues/1299 for more discussion
    should_show_use_python_msg = (
        modifying_pip and
        WINDOWS and
        os.path.basename(sys.argv[0]) in pip_names
    )

    if should_show_use_python_msg:
        new_command = [
            sys.executable, "-m", "pip"
        ] + sys.argv[1:]
        raise CommandError(
            'To modify pip, please run the following command:\n{}'
            .format(" ".join(new_command))
        )


def is_console_interactive():
    # type: () -> bool
    """Is this console interactive?
    """
    return sys.stdin is not None and sys.stdin.isatty()
site-packages/pip/_internal/utils/hashes.py000064400000007664151446176770015053 0ustar00# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import hashlib

from pip._vendor.six import iteritems, iterkeys, itervalues

from pip._internal.exceptions import (
    HashMismatch,
    HashMissing,
    InstallationError,
)
from pip._internal.utils.misc import read_chunks
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import (
        Dict, List, BinaryIO, NoReturn, Iterator
    )
    from pip._vendor.six import PY3
    if PY3:
        from hashlib import _Hash
    else:
        from hashlib import _hash as _Hash


# The recommended hash algo of the moment. Change this whenever the state of
# the art changes; it won't hurt backward compatibility.
FAVORITE_HASH = 'sha256'


# Names of hashlib algorithms allowed by the --hash option and ``pip hash``
# Currently, those are the ones at least as collision-resistant as sha256.
STRONG_HASHES = ['sha256', 'sha384', 'sha512']


class Hashes(object):
    """A wrapper that builds multiple hashes at once and checks them against
    known-good values

    """
    def __init__(self, hashes=None):
        # type: (Dict[str, List[str]]) -> None
        """
        :param hashes: A dict of algorithm names pointing to lists of allowed
            hex digests
        """
        self._allowed = {} if hashes is None else hashes

    @property
    def digest_count(self):
        # type: () -> int
        return sum(len(digests) for digests in self._allowed.values())

    def is_hash_allowed(
        self,
        hash_name,   # type: str
        hex_digest,  # type: str
    ):
        """Return whether the given hex digest is allowed."""
        return hex_digest in self._allowed.get(hash_name, [])

    def check_against_chunks(self, chunks):
        # type: (Iterator[bytes]) -> None
        """Check good hashes against ones built from iterable of chunks of
        data.

        Raise HashMismatch if none match.

        """
        gots = {}
        for hash_name in iterkeys(self._allowed):
            try:
                gots[hash_name] = hashlib.new(hash_name)
            except (ValueError, TypeError):
                raise InstallationError('Unknown hash name: %s' % hash_name)

        for chunk in chunks:
            for hash in itervalues(gots):
                hash.update(chunk)

        for hash_name, got in iteritems(gots):
            if got.hexdigest() in self._allowed[hash_name]:
                return
        self._raise(gots)

    def _raise(self, gots):
        # type: (Dict[str, _Hash]) -> NoReturn
        raise HashMismatch(self._allowed, gots)

    def check_against_file(self, file):
        # type: (BinaryIO) -> None
        """Check good hashes against a file-like object

        Raise HashMismatch if none match.

        """
        return self.check_against_chunks(read_chunks(file))

    def check_against_path(self, path):
        # type: (str) -> None
        with open(path, 'rb') as file:
            return self.check_against_file(file)

    def __nonzero__(self):
        # type: () -> bool
        """Return whether I know any known-good hashes."""
        return bool(self._allowed)

    def __bool__(self):
        # type: () -> bool
        return self.__nonzero__()


class MissingHashes(Hashes):
    """A workalike for Hashes used when we're missing a hash for a requirement

    It computes the actual hash of the requirement and raises a HashMissing
    exception showing it to the user.

    """
    def __init__(self):
        # type: () -> None
        """Don't offer the ``hashes`` kwarg."""
        # Pass our favorite hash in to generate a "gotten hash". With the
        # empty list, it will never match, so an error will always raise.
        super(MissingHashes, self).__init__(hashes={FAVORITE_HASH: []})

    def _raise(self, gots):
        # type: (Dict[str, _Hash]) -> NoReturn
        raise HashMissing(gots[FAVORITE_HASH].hexdigest())
site-packages/pip/_internal/utils/subprocess.py000064400000023267151446176770015765 0ustar00# The following comment should be removed at some point in the future.
# mypy: strict-optional=False

from __future__ import absolute_import

import logging
import os
import subprocess

from pip._vendor.six.moves import shlex_quote

from pip._internal.exceptions import InstallationError
from pip._internal.utils.compat import console_to_str, str_to_display
from pip._internal.utils.logging import subprocess_logger
from pip._internal.utils.misc import HiddenText, path_to_display
from pip._internal.utils.typing import MYPY_CHECK_RUNNING
from pip._internal.utils.ui import open_spinner

if MYPY_CHECK_RUNNING:
    from typing import (
        Any, Callable, Iterable, List, Mapping, Optional, Text, Union,
    )
    from pip._internal.utils.ui import SpinnerInterface

    CommandArgs = List[Union[str, HiddenText]]


LOG_DIVIDER = '----------------------------------------'


def make_command(*args):
    # type: (Union[str, HiddenText, CommandArgs]) -> CommandArgs
    """
    Create a CommandArgs object.
    """
    command_args = []  # type: CommandArgs
    for arg in args:
        # Check for list instead of CommandArgs since CommandArgs is
        # only known during type-checking.
        if isinstance(arg, list):
            command_args.extend(arg)
        else:
            # Otherwise, arg is str or HiddenText.
            command_args.append(arg)

    return command_args


def format_command_args(args):
    # type: (Union[List[str], CommandArgs]) -> str
    """
    Format command arguments for display.
    """
    # For HiddenText arguments, display the redacted form by calling str().
    # Also, we don't apply str() to arguments that aren't HiddenText since
    # this can trigger a UnicodeDecodeError in Python 2 if the argument
    # has type unicode and includes a non-ascii character.  (The type
    # checker doesn't ensure the annotations are correct in all cases.)
    return ' '.join(
        shlex_quote(str(arg)) if isinstance(arg, HiddenText)
        else shlex_quote(arg) for arg in args
    )


def reveal_command_args(args):
    # type: (Union[List[str], CommandArgs]) -> List[str]
    """
    Return the arguments in their raw, unredacted form.
    """
    return [
        arg.secret if isinstance(arg, HiddenText) else arg for arg in args
    ]


def make_subprocess_output_error(
    cmd_args,     # type: Union[List[str], CommandArgs]
    cwd,          # type: Optional[str]
    lines,        # type: List[Text]
    exit_status,  # type: int
):
    # type: (...) -> Text
    """
    Create and return the error message to use to log a subprocess error
    with command output.

    :param lines: A list of lines, each ending with a newline.
    """
    command = format_command_args(cmd_args)
    # Convert `command` and `cwd` to text (unicode in Python 2) so we can use
    # them as arguments in the unicode format string below. This avoids
    # "UnicodeDecodeError: 'ascii' codec can't decode byte ..." in Python 2
    # if either contains a non-ascii character.
    command_display = str_to_display(command, desc='command bytes')
    cwd_display = path_to_display(cwd)

    # We know the joined output value ends in a newline.
    output = ''.join(lines)
    msg = (
        # Use a unicode string to avoid "UnicodeEncodeError: 'ascii'
        # codec can't encode character ..." in Python 2 when a format
        # argument (e.g. `output`) has a non-ascii character.
        u'Command errored out with exit status {exit_status}:\n'
        ' command: {command_display}\n'
        '     cwd: {cwd_display}\n'
        'Complete output ({line_count} lines):\n{output}{divider}'
    ).format(
        exit_status=exit_status,
        command_display=command_display,
        cwd_display=cwd_display,
        line_count=len(lines),
        output=output,
        divider=LOG_DIVIDER,
    )
    return msg


def call_subprocess(
    cmd,  # type: Union[List[str], CommandArgs]
    show_stdout=False,  # type: bool
    cwd=None,  # type: Optional[str]
    on_returncode='raise',  # type: str
    extra_ok_returncodes=None,  # type: Optional[Iterable[int]]
    command_desc=None,  # type: Optional[str]
    extra_environ=None,  # type: Optional[Mapping[str, Any]]
    unset_environ=None,  # type: Optional[Iterable[str]]
    spinner=None,  # type: Optional[SpinnerInterface]
    log_failed_cmd=True  # type: Optional[bool]
):
    # type: (...) -> Text
    """
    Args:
      show_stdout: if true, use INFO to log the subprocess's stderr and
        stdout streams.  Otherwise, use DEBUG.  Defaults to False.
      extra_ok_returncodes: an iterable of integer return codes that are
        acceptable, in addition to 0. Defaults to None, which means [].
      unset_environ: an iterable of environment variable names to unset
        prior to calling subprocess.Popen().
      log_failed_cmd: if false, failed commands are not logged, only raised.
    """
    if extra_ok_returncodes is None:
        extra_ok_returncodes = []
    if unset_environ is None:
        unset_environ = []
    # Most places in pip use show_stdout=False. What this means is--
    #
    # - We connect the child's output (combined stderr and stdout) to a
    #   single pipe, which we read.
    # - We log this output to stderr at DEBUG level as it is received.
    # - If DEBUG logging isn't enabled (e.g. if --verbose logging wasn't
    #   requested), then we show a spinner so the user can still see the
    #   subprocess is in progress.
    # - If the subprocess exits with an error, we log the output to stderr
    #   at ERROR level if it hasn't already been displayed to the console
    #   (e.g. if --verbose logging wasn't enabled).  This way we don't log
    #   the output to the console twice.
    #
    # If show_stdout=True, then the above is still done, but with DEBUG
    # replaced by INFO.
    if show_stdout:
        # Then log the subprocess output at INFO level.
        log_subprocess = subprocess_logger.info
        used_level = logging.INFO
    else:
        # Then log the subprocess output using DEBUG.  This also ensures
        # it will be logged to the log file (aka user_log), if enabled.
        log_subprocess = subprocess_logger.debug
        used_level = logging.DEBUG

    # Whether the subprocess will be visible in the console.
    showing_subprocess = subprocess_logger.getEffectiveLevel() <= used_level

    # Only use the spinner if we're not showing the subprocess output
    # and we have a spinner.
    use_spinner = not showing_subprocess and spinner is not None

    if command_desc is None:
        command_desc = format_command_args(cmd)

    log_subprocess("Running command %s", command_desc)
    env = os.environ.copy()
    if extra_environ:
        env.update(extra_environ)
    for name in unset_environ:
        env.pop(name, None)
    try:
        proc = subprocess.Popen(
            # Convert HiddenText objects to the underlying str.
            reveal_command_args(cmd),
            stderr=subprocess.STDOUT, stdin=subprocess.PIPE,
            stdout=subprocess.PIPE, cwd=cwd, env=env,
        )
        proc.stdin.close()
    except Exception as exc:
        if log_failed_cmd:
            subprocess_logger.critical(
                "Error %s while executing command %s", exc, command_desc,
            )
        raise
    all_output = []
    while True:
        # The "line" value is a unicode string in Python 2.
        line = console_to_str(proc.stdout.readline())
        if not line:
            break
        line = line.rstrip()
        all_output.append(line + '\n')

        # Show the line immediately.
        log_subprocess(line)
        # Update the spinner.
        if use_spinner:
            spinner.spin()
    try:
        proc.wait()
    finally:
        if proc.stdout:
            proc.stdout.close()
    proc_had_error = (
        proc.returncode and proc.returncode not in extra_ok_returncodes
    )
    if use_spinner:
        if proc_had_error:
            spinner.finish("error")
        else:
            spinner.finish("done")
    if proc_had_error:
        if on_returncode == 'raise':
            if not showing_subprocess and log_failed_cmd:
                # Then the subprocess streams haven't been logged to the
                # console yet.
                msg = make_subprocess_output_error(
                    cmd_args=cmd,
                    cwd=cwd,
                    lines=all_output,
                    exit_status=proc.returncode,
                )
                subprocess_logger.error(msg)
            exc_msg = (
                'Command errored out with exit status {}: {} '
                'Check the logs for full command output.'
            ).format(proc.returncode, command_desc)
            raise InstallationError(exc_msg)
        elif on_returncode == 'warn':
            subprocess_logger.warning(
                'Command "%s" had error code %s in %s',
                command_desc, proc.returncode, cwd,
            )
        elif on_returncode == 'ignore':
            pass
        else:
            raise ValueError('Invalid value: on_returncode=%s' %
                             repr(on_returncode))
    return ''.join(all_output)


def runner_with_spinner_message(message):
    # type: (str) -> Callable
    """Provide a subprocess_runner that shows a spinner message.

    Intended for use with for pep517's Pep517HookCaller. Thus, the runner has
    an API that matches what's expected by Pep517HookCaller.subprocess_runner.
    """

    def runner(
        cmd,  # type: List[str]
        cwd=None,  # type: Optional[str]
        extra_environ=None  # type: Optional[Mapping[str, Any]]
    ):
        # type: (...) -> None
        with open_spinner(message) as spinner:
            call_subprocess(
                cmd,
                cwd=cwd,
                extra_environ=extra_environ,
                spinner=spinner,
            )

    return runner
site-packages/pip/_internal/utils/filetypes.py000064400000001073151446176770015570 0ustar00"""Filetype information.
"""
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Tuple

WHEEL_EXTENSION = '.whl'
BZ2_EXTENSIONS = ('.tar.bz2', '.tbz')  # type: Tuple[str, ...]
XZ_EXTENSIONS = ('.tar.xz', '.txz', '.tlz',
                 '.tar.lz', '.tar.lzma')  # type: Tuple[str, ...]
ZIP_EXTENSIONS = ('.zip', WHEEL_EXTENSION)  # type: Tuple[str, ...]
TAR_EXTENSIONS = ('.tar.gz', '.tgz', '.tar')  # type: Tuple[str, ...]
ARCHIVE_EXTENSIONS = (
    ZIP_EXTENSIONS + BZ2_EXTENSIONS + TAR_EXTENSIONS + XZ_EXTENSIONS
)
site-packages/pip/_internal/utils/filesystem.py000064400000006406151446176770015755 0ustar00import os
import os.path
import shutil
import stat
from contextlib import contextmanager
from tempfile import NamedTemporaryFile

# NOTE: retrying is not annotated in typeshed as on 2017-07-17, which is
#       why we ignore the type on this import.
from pip._vendor.retrying import retry  # type: ignore
from pip._vendor.six import PY2

from pip._internal.utils.compat import get_path_uid
from pip._internal.utils.misc import cast
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import BinaryIO, Iterator

    class NamedTemporaryFileResult(BinaryIO):
        @property
        def file(self):
            # type: () -> BinaryIO
            pass


def check_path_owner(path):
    # type: (str) -> bool
    # If we don't have a way to check the effective uid of this process, then
    # we'll just assume that we own the directory.
    if not hasattr(os, "geteuid"):
        return True

    previous = None
    while path != previous:
        if os.path.lexists(path):
            # Check if path is writable by current user.
            if os.geteuid() == 0:
                # Special handling for root user in order to handle properly
                # cases where users use sudo without -H flag.
                try:
                    path_uid = get_path_uid(path)
                except OSError:
                    return False
                return path_uid == 0
            else:
                return os.access(path, os.W_OK)
        else:
            previous, path = path, os.path.dirname(path)
    return False  # assume we don't own the path


def copy2_fixed(src, dest):
    # type: (str, str) -> None
    """Wrap shutil.copy2() but map errors copying socket files to
    SpecialFileError as expected.

    See also https://bugs.python.org/issue37700.
    """
    try:
        shutil.copy2(src, dest)
    except (OSError, IOError):
        for f in [src, dest]:
            try:
                is_socket_file = is_socket(f)
            except OSError:
                # An error has already occurred. Another error here is not
                # a problem and we can ignore it.
                pass
            else:
                if is_socket_file:
                    raise shutil.SpecialFileError("`%s` is a socket" % f)

        raise


def is_socket(path):
    # type: (str) -> bool
    return stat.S_ISSOCK(os.lstat(path).st_mode)


@contextmanager
def adjacent_tmp_file(path):
    # type: (str) -> Iterator[NamedTemporaryFileResult]
    """Given a path to a file, open a temp file next to it securely and ensure
    it is written to disk after the context reaches its end.
    """
    with NamedTemporaryFile(
        delete=False,
        dir=os.path.dirname(path),
        prefix=os.path.basename(path),
        suffix='.tmp',
    ) as f:
        result = cast('NamedTemporaryFileResult', f)
        try:
            yield result
        finally:
            result.file.flush()
            os.fsync(result.file.fileno())


_replace_retry = retry(stop_max_delay=1000, wait_fixed=250)

if PY2:
    @_replace_retry
    def replace(src, dest):
        # type: (str, str) -> None
        try:
            os.rename(src, dest)
        except OSError:
            os.remove(dest)
            os.rename(src, dest)

else:
    replace = _replace_retry(os.replace)
site-packages/pip/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000241151446176770017431 0ustar00U

��.e�@sdZdS)z19.3.1N)�__version__�rr�0/usr/lib/python3.8/site-packages/pip/__init__.py�<module>�site-packages/pip/__pycache__/__main__.cpython-38.opt-1.pyc000064400000000642151446176770017417 0ustar00U

��.et�@sjddlmZddlZddlZedkrFej�ej�e��Zej�de�ddl	m
Zedkrfe�
e��dS)�)�absolute_importN�)�main�__main__)Z
__future__r�os�sys�__package__�path�dirname�__file__�insertZpip._internal.mainrZ_main�__name__�exit�rr�0/usr/lib/python3.8/site-packages/pip/__main__.py�<module>ssite-packages/pip/__pycache__/__main__.cpython-38.pyc000064400000000642151446176770016460 0ustar00U

��.et�@sjddlmZddlZddlZedkrFej�ej�e��Zej�de�ddl	m
Zedkrfe�
e��dS)�)�absolute_importN�)�main�__main__)Z
__future__r�os�sys�__package__�path�dirname�__file__�insertZpip._internal.mainrZ_main�__name__�exit�rr�0/usr/lib/python3.8/site-packages/pip/__main__.py�<module>ssite-packages/pip/__pycache__/__init__.cpython-38.pyc000064400000000241151446176770016472 0ustar00U

��.e�@sdZdS)z19.3.1N)�__version__�rr�0/usr/lib/python3.8/site-packages/pip/__init__.py�<module>�site-packages/pip/__init__.py000064400000000027151446176770012206 0ustar00__version__ = "19.3.1"
site-packages/pip/_vendor/packaging/_compat.py000064400000001541151446176770015453 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import sys


PY2 = sys.version_info[0] == 2
PY3 = sys.version_info[0] == 3

# flake8: noqa

if PY3:
    string_types = (str,)
else:
    string_types = (basestring,)


def with_metaclass(meta, *bases):
    """
    Create a base class with a metaclass.
    """
    # This requires a bit of explanation: the basic idea is to make a dummy
    # metaclass for one level of class instantiation that replaces itself with
    # the actual metaclass.
    class metaclass(meta):
        def __new__(cls, name, this_bases, d):
            return meta(name, bases, d)

    return type.__new__(metaclass, "temporary_class", (), {})
site-packages/pip/_vendor/packaging/version.py000064400000027312151446176770015522 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import collections
import itertools
import re

from ._structures import Infinity


__all__ = ["parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"]


_Version = collections.namedtuple(
    "_Version", ["epoch", "release", "dev", "pre", "post", "local"]
)


def parse(version):
    """
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    """
    try:
        return Version(version)
    except InvalidVersion:
        return LegacyVersion(version)


class InvalidVersion(ValueError):
    """
    An invalid version was found, users should refer to PEP 440.
    """


class _BaseVersion(object):
    def __hash__(self):
        return hash(self._key)

    def __lt__(self, other):
        return self._compare(other, lambda s, o: s < o)

    def __le__(self, other):
        return self._compare(other, lambda s, o: s <= o)

    def __eq__(self, other):
        return self._compare(other, lambda s, o: s == o)

    def __ge__(self, other):
        return self._compare(other, lambda s, o: s >= o)

    def __gt__(self, other):
        return self._compare(other, lambda s, o: s > o)

    def __ne__(self, other):
        return self._compare(other, lambda s, o: s != o)

    def _compare(self, other, method):
        if not isinstance(other, _BaseVersion):
            return NotImplemented

        return method(self._key, other._key)


class LegacyVersion(_BaseVersion):
    def __init__(self, version):
        self._version = str(version)
        self._key = _legacy_cmpkey(self._version)

    def __str__(self):
        return self._version

    def __repr__(self):
        return "<LegacyVersion({0})>".format(repr(str(self)))

    @property
    def public(self):
        return self._version

    @property
    def base_version(self):
        return self._version

    @property
    def epoch(self):
        return -1

    @property
    def release(self):
        return None

    @property
    def pre(self):
        return None

    @property
    def post(self):
        return None

    @property
    def dev(self):
        return None

    @property
    def local(self):
        return None

    @property
    def is_prerelease(self):
        return False

    @property
    def is_postrelease(self):
        return False

    @property
    def is_devrelease(self):
        return False


_legacy_version_component_re = re.compile(r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE)

_legacy_version_replacement_map = {
    "pre": "c",
    "preview": "c",
    "-": "final-",
    "rc": "c",
    "dev": "@",
}


def _parse_version_parts(s):
    for part in _legacy_version_component_re.split(s):
        part = _legacy_version_replacement_map.get(part, part)

        if not part or part == ".":
            continue

        if part[:1] in "0123456789":
            # pad for numeric comparison
            yield part.zfill(8)
        else:
            yield "*" + part

    # ensure that alpha/beta/candidate are before final
    yield "*final"


def _legacy_cmpkey(version):
    # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch
    # greater than or equal to 0. This will effectively put the LegacyVersion,
    # which uses the defacto standard originally implemented by setuptools,
    # as before all PEP 440 versions.
    epoch = -1

    # This scheme is taken from pkg_resources.parse_version setuptools prior to
    # it's adoption of the packaging library.
    parts = []
    for part in _parse_version_parts(version.lower()):
        if part.startswith("*"):
            # remove "-" before a prerelease tag
            if part < "*final":
                while parts and parts[-1] == "*final-":
                    parts.pop()

            # remove trailing zeros from each series of numeric parts
            while parts and parts[-1] == "00000000":
                parts.pop()

        parts.append(part)
    parts = tuple(parts)

    return epoch, parts


# Deliberately not anchored to the start and end of the string, to make it
# easier for 3rd party code to reuse
VERSION_PATTERN = r"""
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
"""


class Version(_BaseVersion):

    _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)

    def __init__(self, version):
        # Validate the version and parse it into pieces
        match = self._regex.search(version)
        if not match:
            raise InvalidVersion("Invalid version: '{0}'".format(version))

        # Store the parsed out pieces of the version
        self._version = _Version(
            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
            release=tuple(int(i) for i in match.group("release").split(".")),
            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
            post=_parse_letter_version(
                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
            ),
            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
            local=_parse_local_version(match.group("local")),
        )

        # Generate a key which will be used for sorting
        self._key = _cmpkey(
            self._version.epoch,
            self._version.release,
            self._version.pre,
            self._version.post,
            self._version.dev,
            self._version.local,
        )

    def __repr__(self):
        return "<Version({0})>".format(repr(str(self)))

    def __str__(self):
        parts = []

        # Epoch
        if self.epoch != 0:
            parts.append("{0}!".format(self.epoch))

        # Release segment
        parts.append(".".join(str(x) for x in self.release))

        # Pre-release
        if self.pre is not None:
            parts.append("".join(str(x) for x in self.pre))

        # Post-release
        if self.post is not None:
            parts.append(".post{0}".format(self.post))

        # Development release
        if self.dev is not None:
            parts.append(".dev{0}".format(self.dev))

        # Local version segment
        if self.local is not None:
            parts.append("+{0}".format(self.local))

        return "".join(parts)

    @property
    def epoch(self):
        return self._version.epoch

    @property
    def release(self):
        return self._version.release

    @property
    def pre(self):
        return self._version.pre

    @property
    def post(self):
        return self._version.post[1] if self._version.post else None

    @property
    def dev(self):
        return self._version.dev[1] if self._version.dev else None

    @property
    def local(self):
        if self._version.local:
            return ".".join(str(x) for x in self._version.local)
        else:
            return None

    @property
    def public(self):
        return str(self).split("+", 1)[0]

    @property
    def base_version(self):
        parts = []

        # Epoch
        if self.epoch != 0:
            parts.append("{0}!".format(self.epoch))

        # Release segment
        parts.append(".".join(str(x) for x in self.release))

        return "".join(parts)

    @property
    def is_prerelease(self):
        return self.dev is not None or self.pre is not None

    @property
    def is_postrelease(self):
        return self.post is not None

    @property
    def is_devrelease(self):
        return self.dev is not None


def _parse_letter_version(letter, number):
    if letter:
        # We consider there to be an implicit 0 in a pre-release if there is
        # not a numeral associated with it.
        if number is None:
            number = 0

        # We normalize any letters to their lower case form
        letter = letter.lower()

        # We consider some words to be alternate spellings of other words and
        # in those cases we want to normalize the spellings to our preferred
        # spelling.
        if letter == "alpha":
            letter = "a"
        elif letter == "beta":
            letter = "b"
        elif letter in ["c", "pre", "preview"]:
            letter = "rc"
        elif letter in ["rev", "r"]:
            letter = "post"

        return letter, int(number)
    if not letter and number:
        # We assume if we are given a number, but we are not given a letter
        # then this is using the implicit post release syntax (e.g. 1.0-1)
        letter = "post"

        return letter, int(number)


_local_version_separators = re.compile(r"[\._-]")


def _parse_local_version(local):
    """
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    """
    if local is not None:
        return tuple(
            part.lower() if not part.isdigit() else int(part)
            for part in _local_version_separators.split(local)
        )


def _cmpkey(epoch, release, pre, post, dev, local):
    # When we compare a release version, we want to compare it with all of the
    # trailing zeros removed. So we'll use a reverse the list, drop all the now
    # leading zeros until we come to something non zero, then take the rest
    # re-reverse it back into the correct order and make it a tuple and use
    # that for our sorting key.
    release = tuple(
        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
    )

    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
    # We'll do this by abusing the pre segment, but we _only_ want to do this
    # if there is not a pre or a post segment. If we have one of those then
    # the normal sorting rules will handle this case correctly.
    if pre is None and post is None and dev is not None:
        pre = -Infinity
    # Versions without a pre-release (except as noted above) should sort after
    # those with one.
    elif pre is None:
        pre = Infinity

    # Versions without a post segment should sort before those with one.
    if post is None:
        post = -Infinity

    # Versions without a development segment should sort after those with one.
    if dev is None:
        dev = Infinity

    if local is None:
        # Versions without a local segment should sort before those with one.
        local = -Infinity
    else:
        # Versions with a local segment need that segment parsed to implement
        # the sorting rules in PEP440.
        # - Alpha numeric segments sort before numeric segments
        # - Alpha numeric segments sort lexicographically
        # - Numeric segments sort numerically
        # - Shorter versions sort before longer versions when the prefixes
        #   match exactly
        local = tuple((i, "") if isinstance(i, int) else (-Infinity, i) for i in local)

    return epoch, release, pre, post, dev, local
site-packages/pip/_vendor/packaging/utils.py000064400000002760151446176770015175 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import re

from .version import InvalidVersion, Version


_canonicalize_regex = re.compile(r"[-_.]+")


def canonicalize_name(name):
    # This is taken from PEP 503.
    return _canonicalize_regex.sub("-", name).lower()


def canonicalize_version(version):
    """
    This is very similar to Version.__str__, but has one subtle differences
    with the way it handles the release segment.
    """

    try:
        version = Version(version)
    except InvalidVersion:
        # Legacy versions cannot be normalized
        return version

    parts = []

    # Epoch
    if version.epoch != 0:
        parts.append("{0}!".format(version.epoch))

    # Release segment
    # NB: This strips trailing '.0's to normalize
    parts.append(re.sub(r"(\.0)+$", "", ".".join(str(x) for x in version.release)))

    # Pre-release
    if version.pre is not None:
        parts.append("".join(str(x) for x in version.pre))

    # Post-release
    if version.post is not None:
        parts.append(".post{0}".format(version.post))

    # Development release
    if version.dev is not None:
        parts.append(".dev{0}".format(version.dev))

    # Local version segment
    if version.local is not None:
        parts.append("+{0}".format(version.local))

    return "".join(parts)
site-packages/pip/_vendor/packaging/__about__.py000064400000001350151446176770015735 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

__all__ = [
    "__title__",
    "__summary__",
    "__uri__",
    "__version__",
    "__author__",
    "__email__",
    "__license__",
    "__copyright__",
]

__title__ = "packaging"
__summary__ = "Core utilities for Python packages"
__uri__ = "https://github.com/pypa/packaging"

__version__ = "19.2"

__author__ = "Donald Stufft and individual contributors"
__email__ = "donald@stufft.io"

__license__ = "BSD or Apache License, Version 2.0"
__copyright__ = "Copyright 2014-2019 %s" % __author__
site-packages/pip/_vendor/packaging/specifiers.py000064400000066202151446176770016172 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import abc
import functools
import itertools
import re

from ._compat import string_types, with_metaclass
from .version import Version, LegacyVersion, parse


class InvalidSpecifier(ValueError):
    """
    An invalid specifier was found, users should refer to PEP 440.
    """


class BaseSpecifier(with_metaclass(abc.ABCMeta, object)):
    @abc.abstractmethod
    def __str__(self):
        """
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        """

    @abc.abstractmethod
    def __hash__(self):
        """
        Returns a hash value for this Specifier like object.
        """

    @abc.abstractmethod
    def __eq__(self, other):
        """
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        """

    @abc.abstractmethod
    def __ne__(self, other):
        """
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        """

    @abc.abstractproperty
    def prereleases(self):
        """
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        """

    @prereleases.setter
    def prereleases(self, value):
        """
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        """

    @abc.abstractmethod
    def contains(self, item, prereleases=None):
        """
        Determines if the given item is contained within this specifier.
        """

    @abc.abstractmethod
    def filter(self, iterable, prereleases=None):
        """
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        """


class _IndividualSpecifier(BaseSpecifier):

    _operators = {}

    def __init__(self, spec="", prereleases=None):
        match = self._regex.search(spec)
        if not match:
            raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec))

        self._spec = (match.group("operator").strip(), match.group("version").strip())

        # Store whether or not this Specifier should accept prereleases
        self._prereleases = prereleases

    def __repr__(self):
        pre = (
            ", prereleases={0!r}".format(self.prereleases)
            if self._prereleases is not None
            else ""
        )

        return "<{0}({1!r}{2})>".format(self.__class__.__name__, str(self), pre)

    def __str__(self):
        return "{0}{1}".format(*self._spec)

    def __hash__(self):
        return hash(self._spec)

    def __eq__(self, other):
        if isinstance(other, string_types):
            try:
                other = self.__class__(other)
            except InvalidSpecifier:
                return NotImplemented
        elif not isinstance(other, self.__class__):
            return NotImplemented

        return self._spec == other._spec

    def __ne__(self, other):
        if isinstance(other, string_types):
            try:
                other = self.__class__(other)
            except InvalidSpecifier:
                return NotImplemented
        elif not isinstance(other, self.__class__):
            return NotImplemented

        return self._spec != other._spec

    def _get_operator(self, op):
        return getattr(self, "_compare_{0}".format(self._operators[op]))

    def _coerce_version(self, version):
        if not isinstance(version, (LegacyVersion, Version)):
            version = parse(version)
        return version

    @property
    def operator(self):
        return self._spec[0]

    @property
    def version(self):
        return self._spec[1]

    @property
    def prereleases(self):
        return self._prereleases

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value

    def __contains__(self, item):
        return self.contains(item)

    def contains(self, item, prereleases=None):
        # Determine if prereleases are to be allowed or not.
        if prereleases is None:
            prereleases = self.prereleases

        # Normalize item to a Version or LegacyVersion, this allows us to have
        # a shortcut for ``"2.0" in Specifier(">=2")
        item = self._coerce_version(item)

        # Determine if we should be supporting prereleases in this specifier
        # or not, if we do not support prereleases than we can short circuit
        # logic if this version is a prereleases.
        if item.is_prerelease and not prereleases:
            return False

        # Actually do the comparison to determine if this item is contained
        # within this Specifier or not.
        return self._get_operator(self.operator)(item, self.version)

    def filter(self, iterable, prereleases=None):
        yielded = False
        found_prereleases = []

        kw = {"prereleases": prereleases if prereleases is not None else True}

        # Attempt to iterate over all the values in the iterable and if any of
        # them match, yield them.
        for version in iterable:
            parsed_version = self._coerce_version(version)

            if self.contains(parsed_version, **kw):
                # If our version is a prerelease, and we were not set to allow
                # prereleases, then we'll store it for later incase nothing
                # else matches this specifier.
                if parsed_version.is_prerelease and not (
                    prereleases or self.prereleases
                ):
                    found_prereleases.append(version)
                # Either this is not a prerelease, or we should have been
                # accepting prereleases from the beginning.
                else:
                    yielded = True
                    yield version

        # Now that we've iterated over everything, determine if we've yielded
        # any values, and if we have not and we have any prereleases stored up
        # then we will go ahead and yield the prereleases.
        if not yielded and found_prereleases:
            for version in found_prereleases:
                yield version


class LegacySpecifier(_IndividualSpecifier):

    _regex_str = r"""
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        """

    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)

    _operators = {
        "==": "equal",
        "!=": "not_equal",
        "<=": "less_than_equal",
        ">=": "greater_than_equal",
        "<": "less_than",
        ">": "greater_than",
    }

    def _coerce_version(self, version):
        if not isinstance(version, LegacyVersion):
            version = LegacyVersion(str(version))
        return version

    def _compare_equal(self, prospective, spec):
        return prospective == self._coerce_version(spec)

    def _compare_not_equal(self, prospective, spec):
        return prospective != self._coerce_version(spec)

    def _compare_less_than_equal(self, prospective, spec):
        return prospective <= self._coerce_version(spec)

    def _compare_greater_than_equal(self, prospective, spec):
        return prospective >= self._coerce_version(spec)

    def _compare_less_than(self, prospective, spec):
        return prospective < self._coerce_version(spec)

    def _compare_greater_than(self, prospective, spec):
        return prospective > self._coerce_version(spec)


def _require_version_compare(fn):
    @functools.wraps(fn)
    def wrapped(self, prospective, spec):
        if not isinstance(prospective, Version):
            return False
        return fn(self, prospective, spec)

    return wrapped


class Specifier(_IndividualSpecifier):

    _regex_str = r"""
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        """

    _regex = re.compile(r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)

    _operators = {
        "~=": "compatible",
        "==": "equal",
        "!=": "not_equal",
        "<=": "less_than_equal",
        ">=": "greater_than_equal",
        "<": "less_than",
        ">": "greater_than",
        "===": "arbitrary",
    }

    @_require_version_compare
    def _compare_compatible(self, prospective, spec):
        # Compatible releases have an equivalent combination of >= and ==. That
        # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
        # implement this in terms of the other specifiers instead of
        # implementing it ourselves. The only thing we need to do is construct
        # the other specifiers.

        # We want everything but the last item in the version, but we want to
        # ignore post and dev releases and we want to treat the pre-release as
        # it's own separate segment.
        prefix = ".".join(
            list(
                itertools.takewhile(
                    lambda x: (not x.startswith("post") and not x.startswith("dev")),
                    _version_split(spec),
                )
            )[:-1]
        )

        # Add the prefix notation to the end of our string
        prefix += ".*"

        return self._get_operator(">=")(prospective, spec) and self._get_operator("==")(
            prospective, prefix
        )

    @_require_version_compare
    def _compare_equal(self, prospective, spec):
        # We need special logic to handle prefix matching
        if spec.endswith(".*"):
            # In the case of prefix matching we want to ignore local segment.
            prospective = Version(prospective.public)
            # Split the spec out by dots, and pretend that there is an implicit
            # dot in between a release segment and a pre-release segment.
            spec = _version_split(spec[:-2])  # Remove the trailing .*

            # Split the prospective version out by dots, and pretend that there
            # is an implicit dot in between a release segment and a pre-release
            # segment.
            prospective = _version_split(str(prospective))

            # Shorten the prospective version to be the same length as the spec
            # so that we can determine if the specifier is a prefix of the
            # prospective version or not.
            prospective = prospective[: len(spec)]

            # Pad out our two sides with zeros so that they both equal the same
            # length.
            spec, prospective = _pad_version(spec, prospective)
        else:
            # Convert our spec string into a Version
            spec = Version(spec)

            # If the specifier does not have a local segment, then we want to
            # act as if the prospective version also does not have a local
            # segment.
            if not spec.local:
                prospective = Version(prospective.public)

        return prospective == spec

    @_require_version_compare
    def _compare_not_equal(self, prospective, spec):
        return not self._compare_equal(prospective, spec)

    @_require_version_compare
    def _compare_less_than_equal(self, prospective, spec):
        return prospective <= Version(spec)

    @_require_version_compare
    def _compare_greater_than_equal(self, prospective, spec):
        return prospective >= Version(spec)

    @_require_version_compare
    def _compare_less_than(self, prospective, spec):
        # Convert our spec to a Version instance, since we'll want to work with
        # it as a version.
        spec = Version(spec)

        # Check to see if the prospective version is less than the spec
        # version. If it's not we can short circuit and just return False now
        # instead of doing extra unneeded work.
        if not prospective < spec:
            return False

        # This special case is here so that, unless the specifier itself
        # includes is a pre-release version, that we do not accept pre-release
        # versions for the version mentioned in the specifier (e.g. <3.1 should
        # not match 3.1.dev0, but should match 3.0.dev0).
        if not spec.is_prerelease and prospective.is_prerelease:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # If we've gotten to here, it means that prospective version is both
        # less than the spec version *and* it's not a pre-release of the same
        # version in the spec.
        return True

    @_require_version_compare
    def _compare_greater_than(self, prospective, spec):
        # Convert our spec to a Version instance, since we'll want to work with
        # it as a version.
        spec = Version(spec)

        # Check to see if the prospective version is greater than the spec
        # version. If it's not we can short circuit and just return False now
        # instead of doing extra unneeded work.
        if not prospective > spec:
            return False

        # This special case is here so that, unless the specifier itself
        # includes is a post-release version, that we do not accept
        # post-release versions for the version mentioned in the specifier
        # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0).
        if not spec.is_postrelease and prospective.is_postrelease:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # Ensure that we do not allow a local version of the version mentioned
        # in the specifier, which is technically greater than, to match.
        if prospective.local is not None:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # If we've gotten to here, it means that prospective version is both
        # greater than the spec version *and* it's not a pre-release of the
        # same version in the spec.
        return True

    def _compare_arbitrary(self, prospective, spec):
        return str(prospective).lower() == str(spec).lower()

    @property
    def prereleases(self):
        # If there is an explicit prereleases set for this, then we'll just
        # blindly use that.
        if self._prereleases is not None:
            return self._prereleases

        # Look at all of our specifiers and determine if they are inclusive
        # operators, and if they are if they are including an explicit
        # prerelease.
        operator, version = self._spec
        if operator in ["==", ">=", "<=", "~=", "==="]:
            # The == specifier can include a trailing .*, if it does we
            # want to remove before parsing.
            if operator == "==" and version.endswith(".*"):
                version = version[:-2]

            # Parse the version, and if it is a pre-release than this
            # specifier allows pre-releases.
            if parse(version).is_prerelease:
                return True

        return False

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value


_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")


def _version_split(version):
    result = []
    for item in version.split("."):
        match = _prefix_regex.search(item)
        if match:
            result.extend(match.groups())
        else:
            result.append(item)
    return result


def _pad_version(left, right):
    left_split, right_split = [], []

    # Get the release segment of our versions
    left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left)))
    right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right)))

    # Get the rest of our versions
    left_split.append(left[len(left_split[0]) :])
    right_split.append(right[len(right_split[0]) :])

    # Insert our padding
    left_split.insert(1, ["0"] * max(0, len(right_split[0]) - len(left_split[0])))
    right_split.insert(1, ["0"] * max(0, len(left_split[0]) - len(right_split[0])))

    return (list(itertools.chain(*left_split)), list(itertools.chain(*right_split)))


class SpecifierSet(BaseSpecifier):
    def __init__(self, specifiers="", prereleases=None):
        # Split on , to break each indidivual specifier into it's own item, and
        # strip each item to remove leading/trailing whitespace.
        specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]

        # Parsed each individual specifier, attempting first to make it a
        # Specifier and falling back to a LegacySpecifier.
        parsed = set()
        for specifier in specifiers:
            try:
                parsed.add(Specifier(specifier))
            except InvalidSpecifier:
                parsed.add(LegacySpecifier(specifier))

        # Turn our parsed specifiers into a frozen set and save them for later.
        self._specs = frozenset(parsed)

        # Store our prereleases value so we can use it later to determine if
        # we accept prereleases or not.
        self._prereleases = prereleases

    def __repr__(self):
        pre = (
            ", prereleases={0!r}".format(self.prereleases)
            if self._prereleases is not None
            else ""
        )

        return "<SpecifierSet({0!r}{1})>".format(str(self), pre)

    def __str__(self):
        return ",".join(sorted(str(s) for s in self._specs))

    def __hash__(self):
        return hash(self._specs)

    def __and__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        specifier = SpecifierSet()
        specifier._specs = frozenset(self._specs | other._specs)

        if self._prereleases is None and other._prereleases is not None:
            specifier._prereleases = other._prereleases
        elif self._prereleases is not None and other._prereleases is None:
            specifier._prereleases = self._prereleases
        elif self._prereleases == other._prereleases:
            specifier._prereleases = self._prereleases
        else:
            raise ValueError(
                "Cannot combine SpecifierSets with True and False prerelease "
                "overrides."
            )

        return specifier

    def __eq__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif isinstance(other, _IndividualSpecifier):
            other = SpecifierSet(str(other))
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        return self._specs == other._specs

    def __ne__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif isinstance(other, _IndividualSpecifier):
            other = SpecifierSet(str(other))
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        return self._specs != other._specs

    def __len__(self):
        return len(self._specs)

    def __iter__(self):
        return iter(self._specs)

    @property
    def prereleases(self):
        # If we have been given an explicit prerelease modifier, then we'll
        # pass that through here.
        if self._prereleases is not None:
            return self._prereleases

        # If we don't have any specifiers, and we don't have a forced value,
        # then we'll just return None since we don't know if this should have
        # pre-releases or not.
        if not self._specs:
            return None

        # Otherwise we'll see if any of the given specifiers accept
        # prereleases, if any of them do we'll return True, otherwise False.
        return any(s.prereleases for s in self._specs)

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value

    def __contains__(self, item):
        return self.contains(item)

    def contains(self, item, prereleases=None):
        # Ensure that our item is a Version or LegacyVersion instance.
        if not isinstance(item, (LegacyVersion, Version)):
            item = parse(item)

        # Determine if we're forcing a prerelease or not, if we're not forcing
        # one for this particular filter call, then we'll use whatever the
        # SpecifierSet thinks for whether or not we should support prereleases.
        if prereleases is None:
            prereleases = self.prereleases

        # We can determine if we're going to allow pre-releases by looking to
        # see if any of the underlying items supports them. If none of them do
        # and this item is a pre-release then we do not allow it and we can
        # short circuit that here.
        # Note: This means that 1.0.dev1 would not be contained in something
        #       like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0
        if not prereleases and item.is_prerelease:
            return False

        # We simply dispatch to the underlying specs here to make sure that the
        # given version is contained within all of them.
        # Note: This use of all() here means that an empty set of specifiers
        #       will always return True, this is an explicit design decision.
        return all(s.contains(item, prereleases=prereleases) for s in self._specs)

    def filter(self, iterable, prereleases=None):
        # Determine if we're forcing a prerelease or not, if we're not forcing
        # one for this particular filter call, then we'll use whatever the
        # SpecifierSet thinks for whether or not we should support prereleases.
        if prereleases is None:
            prereleases = self.prereleases

        # If we have any specifiers, then we want to wrap our iterable in the
        # filter method for each one, this will act as a logical AND amongst
        # each specifier.
        if self._specs:
            for spec in self._specs:
                iterable = spec.filter(iterable, prereleases=bool(prereleases))
            return iterable
        # If we do not have any specifiers, then we need to have a rough filter
        # which will filter out any pre-releases, unless there are no final
        # releases, and which will filter out LegacyVersion in general.
        else:
            filtered = []
            found_prereleases = []

            for item in iterable:
                # Ensure that we some kind of Version class for this item.
                if not isinstance(item, (LegacyVersion, Version)):
                    parsed_version = parse(item)
                else:
                    parsed_version = item

                # Filter out any item which is parsed as a LegacyVersion
                if isinstance(parsed_version, LegacyVersion):
                    continue

                # Store any item which is a pre-release for later unless we've
                # already found a final version or we are accepting prereleases
                if parsed_version.is_prerelease and not prereleases:
                    if not filtered:
                        found_prereleases.append(item)
                else:
                    filtered.append(item)

            # If we've found no items except for pre-releases, then we'll go
            # ahead and use the pre-releases
            if not filtered and found_prereleases and prereleases is None:
                return found_prereleases

            return filtered
site-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001027151446176770023014 0ustar00U

��.e2�@sTddlmZmZmZddlmZmZmZmZm	Z	m
Z
mZmZdddddd	d
dgZ
dS)
�)�absolute_import�division�print_function�)�
__author__�
__copyright__�	__email__�__license__�__summary__�	__title__�__uri__�__version__rr
rr
rrr	rN)Z
__future__rrr�	__about__rrrr	r
rrr
�__all__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/packaging/__init__.py�<module>s(�site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-38.pyc000064400000046417151446176770022466 0ustar00U

��.e�l�@s�ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
ddlmZm
Z
mZGdd�de�ZGdd	�d	e
eje��ZGd
d�de�ZGdd
�d
e�Zdd�ZGdd�de�Ze�d�Zdd�Zdd�ZGdd�de�ZdS)�)�absolute_import�division�print_functionN�)�string_types�with_metaclass)�Version�
LegacyVersion�parsec@seZdZdZdS)�InvalidSpecifierzH
    An invalid specifier was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__�rr�D/usr/lib/python3.8/site-packages/pip/_vendor/packaging/specifiers.pyrsrc@s�eZdZejdd��Zejdd��Zejdd��Zejdd��Zej	d	d
��Z
e
jdd
��Z
ejdd
d��Zejddd��Z
dS)�
BaseSpecifiercCsdS)z�
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        Nr��selfrrr�__str__szBaseSpecifier.__str__cCsdS)zF
        Returns a hash value for this Specifier like object.
        Nrrrrr�__hash__szBaseSpecifier.__hash__cCsdS)zq
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        Nr�r�otherrrr�__eq__#szBaseSpecifier.__eq__cCsdS)zu
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        Nrrrrr�__ne__*szBaseSpecifier.__ne__cCsdS)zg
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        Nrrrrr�prereleases1szBaseSpecifier.prereleasescCsdS)zd
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr�r�valuerrrr8sNcCsdS)zR
        Determines if the given item is contained within this specifier.
        Nr�r�itemrrrr�contains?szBaseSpecifier.containscCsdS)z�
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        Nr)r�iterablerrrr�filterEszBaseSpecifier.filter)N)N)rr
r�abc�abstractmethodrrrr�abstractpropertyr�setterr r"rrrrrs 





rc@s�eZdZiZd dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zedd��Z
edd��Zedd��Zejdd��Zdd�Zd!dd�Zd"dd�ZdS)#�_IndividualSpecifier�NcCsF|j�|�}|std�|���|�d���|�d���f|_||_dS)NzInvalid specifier: '{0}'�operator�version)�_regex�searchr�format�group�strip�_spec�_prereleases)r�specr�matchrrr�__init__Qs
z_IndividualSpecifier.__init__cCs0|jdk	rd�|j�nd}d�|jjt|�|�S)N�, prereleases={0!r}r(z<{0}({1!r}{2})>)r1r-r�	__class__r�str�rZprerrr�__repr__[s
��z_IndividualSpecifier.__repr__cCsdj|j�S)Nz{0}{1})r-r0rrrrrdsz_IndividualSpecifier.__str__cCs
t|j�S�N)�hashr0rrrrrgsz_IndividualSpecifier.__hash__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:��
isinstancerr6r�NotImplementedr0rrrrrjs
z_IndividualSpecifier.__eq__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:r<rrrrrus
z_IndividualSpecifier.__ne__cCst|d�|j|��S)Nz_compare_{0})�getattrr-�
_operators)r�oprrr�
_get_operator�sz"_IndividualSpecifier._get_operatorcCst|ttf�st|�}|Sr:)r=r	rr
�rr*rrr�_coerce_version�sz$_IndividualSpecifier._coerce_versioncCs
|jdS)Nr�r0rrrrr)�sz_IndividualSpecifier.operatorcCs
|jdS)NrrErrrrr*�sz_IndividualSpecifier.versioncCs|jSr:�r1rrrrr�sz _IndividualSpecifier.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:�r �rrrrr�__contains__�sz!_IndividualSpecifier.__contains__cCs:|dkr|j}|�|�}|jr&|s&dS|�|j�||j�S�NF)rrD�
is_prereleaserBr)r*rrrrr �s

z_IndividualSpecifier.containsccs�d}g}d|dk	r|ndi}|D]B}|�|�}|j|f|�r |jrX|sX|jsX|�|�q d}|Vq |s||r||D]
}|VqpdS)NFrT)rDr rKr�append)rr!rZyielded�found_prereleases�kwr*�parsed_versionrrrr"�s"
��z_IndividualSpecifier.filter)r(N)N)N)rr
rr@r4r9rrrrrBrD�propertyr)r*rr&rIr r"rrrrr'Ms(

	




r'c@sveZdZdZe�dedejejB�Zdddddd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�LegacySpecifiera�
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        �^\s*�\s*$�equal�	not_equal�less_than_equal�greater_than_equal�	less_than�greater_than)�==�!=�<=�>=�<�>cCst|t�stt|��}|Sr:)r=r	r7rCrrrrD�s
zLegacySpecifier._coerce_versioncCs||�|�kSr:�rD�r�prospectiver2rrr�_compare_equal�szLegacySpecifier._compare_equalcCs||�|�kSr:r`rarrr�_compare_not_equal�sz"LegacySpecifier._compare_not_equalcCs||�|�kSr:r`rarrr�_compare_less_than_equal�sz(LegacySpecifier._compare_less_than_equalcCs||�|�kSr:r`rarrr�_compare_greater_than_equal�sz+LegacySpecifier._compare_greater_than_equalcCs||�|�kSr:r`rarrr�_compare_less_than�sz"LegacySpecifier._compare_less_thancCs||�|�kSr:r`rarrr�_compare_greater_than�sz%LegacySpecifier._compare_greater_thanN)rr
r�
_regex_str�re�compile�VERBOSE�
IGNORECASEr+r@rDrcrdrerfrgrhrrrrrQ�s �	rQcst����fdd��}|S)Ncst|t�sdS�|||�SrJ)r=rra��fnrr�wrappeds
z)_require_version_compare.<locals>.wrapped)�	functools�wraps)rorprrnr�_require_version_comparesrsc	@s�eZdZdZe�dedejejB�Zdddddd	d
dd�Z	e
d
d��Ze
dd��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��Ze
dd��Zdd�Zedd��Zejdd��Zd S)!�	Specifiera
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        rRrSZ
compatiblerTrUrVrWrXrYZ	arbitrary)�~=rZr[r\r]r^r_�===cCsNd�tt�dd�t|���dd��}|d7}|�d�||�oL|�d�||�S)N�.cSs|�d�o|�d�S)NZpostZdev)�
startswith��xrrr�<lambda>��z/Specifier._compare_compatible.<locals>.<lambda>����.*r]rZ)�join�list�	itertools�	takewhile�_version_splitrB)rrbr2�prefixrrr�_compare_compatiblevs����
�zSpecifier._compare_compatiblecCsp|�d�rPt|j�}t|dd��}tt|��}|dt|��}t||�\}}nt|�}|jsht|j�}||kS)Nr~���)�endswithrZpublicr�r7�len�_pad_version�localrarrrrc�s


zSpecifier._compare_equalcCs|�||�Sr:)rcrarrrrd�szSpecifier._compare_not_equalcCs|t|�kSr:�rrarrrre�sz"Specifier._compare_less_than_equalcCs|t|�kSr:r�rarrrrf�sz%Specifier._compare_greater_than_equalcCs<t|�}||ksdS|js8|jr8t|j�t|j�kr8dSdS�NFT)rrK�base_versionrarrrrg�szSpecifier._compare_less_thancCs^t|�}||ksdS|js8|jr8t|j�t|j�kr8dS|jdk	rZt|j�t|j�krZdSdSr�)rZis_postreleaser�r�rarrrrh�s
zSpecifier._compare_greater_thancCst|���t|���kSr:)r7�lowerrarrr�_compare_arbitrary�szSpecifier._compare_arbitrarycCsR|jdk	r|jS|j\}}|dkrN|dkr@|�d�r@|dd�}t|�jrNdSdS)N)rZr]r\rurvrZr~r�TF)r1r0r�r
rK)rr)r*rrrr�s


zSpecifier.prereleasescCs
||_dSr:rFrrrrrsN)rr
rrirjrkrlrmr+r@rsr�rcrdrerfrgrhr�rPrr&rrrrrt
s<]�

"





rtz^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCs@g}|�d�D],}t�|�}|r0|�|���q|�|�q|S)Nrw)�split�
_prefix_regexr,�extend�groupsrL)r*�resultrr3rrrr�s
r�c
Cs�gg}}|�tt�dd�|���|�tt�dd�|���|�|t|d�d��|�|t|d�d��|�ddgtdt|d�t|d���|�ddgtdt|d�t|d���ttj|��ttj|��fS)NcSs|��Sr:��isdigitryrrrr{*r|z_pad_version.<locals>.<lambda>cSs|��Sr:r�ryrrrr{+r|rr�0)rLr�r�r�r��insert�max�chain)�left�rightZ
left_splitZright_splitrrrr�&s
,,r�c@s�eZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zedd��Z
e
jdd��Z
dd�Zddd�Zd dd�ZdS)!�SpecifierSetr(Nc	Csndd�|�d�D�}t�}|D]:}z|�t|��Wqtk
rV|�t|��YqXqt|�|_||_dS)NcSsg|]}|��r|���qSr)r/��.0�srrr�
<listcomp><sz)SpecifierSet.__init__.<locals>.<listcomp>�,)	r��set�addrtrrQ�	frozenset�_specsr1)rZ
specifiersrZparsed�	specifierrrrr49s
zSpecifierSet.__init__cCs*|jdk	rd�|j�nd}d�t|�|�S)Nr5r(z<SpecifierSet({0!r}{1})>)r1r-rr7r8rrrr9Ns
��zSpecifierSet.__repr__cCsd�tdd�|jD���S)Nr�css|]}t|�VqdSr:)r7r�rrr�	<genexpr>Xsz'SpecifierSet.__str__.<locals>.<genexpr>)r�sortedr�rrrrrWszSpecifierSet.__str__cCs
t|j�Sr:)r;r�rrrrrZszSpecifierSet.__hash__cCs�t|t�rt|�}nt|t�s"tSt�}t|j|jB�|_|jdkrX|jdk	rX|j|_n<|jdk	rv|jdkrv|j|_n|j|jkr�|j|_ntd��|S)NzFCannot combine SpecifierSets with True and False prerelease overrides.)r=rr�r>r�r�r1�
ValueError)rrr�rrr�__and__]s 





�zSpecifierSet.__and__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:�r=rr�r'r7r>r�rrrrrts



zSpecifierSet.__eq__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:r�rrrrr~s



zSpecifierSet.__ne__cCs
t|j�Sr:)r�r�rrrr�__len__�szSpecifierSet.__len__cCs
t|j�Sr:)�iterr�rrrr�__iter__�szSpecifierSet.__iter__cCs.|jdk	r|jS|jsdStdd�|jD��S)Ncss|]}|jVqdSr:�rr�rrrr��sz+SpecifierSet.prereleases.<locals>.<genexpr>)r1r��anyrrrrr�s

zSpecifierSet.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:rGrHrrrrI�szSpecifierSet.__contains__csLt�ttf�st����dkr$|j��s2�jr2dSt��fdd�|jD��S)NFc3s|]}|j��d�VqdS)r�NrGr��rrrrr��sz(SpecifierSet.contains.<locals>.<genexpr>)r=r	rr
rrK�allr�rrr�rr �s
zSpecifierSet.containscCs�|dkr|j}|jr6|jD]}|j|t|�d�}q|Sg}g}|D]P}t|ttf�s^t|�}n|}t|t�rnqB|jr�|s�|s�|�	|�qB|�	|�qB|s�|r�|dkr�|S|SdS)Nr�)
rr�r"�boolr=r	rr
rKrL)rr!rr2ZfilteredrMrrOrrrr"�s*



zSpecifierSet.filter)r(N)N)N)rr
rr4r9rrr�rrr�r�rPrr&rIr r"rrrrr�8s 
	




r�)Z
__future__rrrr#rqr�rjZ_compatrrr*rr	r
r�r�ABCMeta�objectrr'rQrsrtrkr�r�r�r�rrrr�<module>s&81

site-packages/pip/_vendor/packaging/__pycache__/_compat.cpython-38.pyc000064400000001713151446176770021742 0ustar00U

��.ea�@sVddlmZmZmZddlZejddkZejddkZerDefZ	ne
fZ	dd�ZdS)�)�absolute_import�division�print_functionN��cs&G��fdd�d��}t�|ddi�S)z/
    Create a base class with a metaclass.
    cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�S)N�)�cls�nameZ
this_bases�d��bases�metar�A/usr/lib/python3.8/site-packages/pip/_vendor/packaging/_compat.py�__new__sz)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__�__qualname__rrrrr�	metaclasssrZtemporary_classr)�typer)r
rrrrr�with_metaclasssr)Z
__future__rrr�sys�version_infoZPY2ZPY3�strZstring_typesZ
basestringrrrrr�<module>ssite-packages/pip/_vendor/packaging/__pycache__/_compat.cpython-38.opt-1.pyc000064400000001713151446176770022701 0ustar00U

��.ea�@sVddlmZmZmZddlZejddkZejddkZerDefZ	ne
fZ	dd�ZdS)�)�absolute_import�division�print_functionN��cs&G��fdd�d��}t�|ddi�S)z/
    Create a base class with a metaclass.
    cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�S)N�)�cls�nameZ
this_bases�d��bases�metar�A/usr/lib/python3.8/site-packages/pip/_vendor/packaging/_compat.py�__new__sz)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__�__qualname__rrrrr�	metaclasssrZtemporary_classr)�typer)r
rrrrr�with_metaclasssr)Z
__future__rrr�sys�version_infoZPY2ZPY3�strZstring_typesZ
basestringrrrrr�<module>ssite-packages/pip/_vendor/packaging/__pycache__/utils.cpython-38.opt-1.pyc000064400000002624151446176770022421 0ustar00U

��.e��@sJddlmZmZmZddlZddlmZmZe�d�Z	dd�Z
dd	�ZdS)
�)�absolute_import�division�print_functionN�)�InvalidVersion�Versionz[-_.]+cCst�d|���S)N�-)�_canonicalize_regex�sub�lower)�name�r
�?/usr/lib/python3.8/site-packages/pip/_vendor/packaging/utils.py�canonicalize_namesrc
Cs�zt|�}Wntk
r$|YSXg}|jdkrF|�d�|j��|�t�ddd�dd�|jD����|j	dk	r�|�d�d	d�|j	D���|j
dk	r�|�d
�|j
��|jdk	r�|�d�|j��|jdk	r�|�d�|j��d�|�S)
z�
    This is very similar to Version.__str__, but has one subtle differences
    with the way it handles the release segment.
    rz{0}!z(\.0)+$��.css|]}t|�VqdS�N��str��.0�xr
r
r�	<genexpr>'sz'canonicalize_version.<locals>.<genexpr>Ncss|]}t|�VqdSrrrr
r
rr+sz.post{0}z.dev{0}z+{0})
rrZepoch�append�format�rer
�join�releaseZpreZpostZdevZlocal)�version�partsr
r
r�canonicalize_versions"

&



r )Z
__future__rrrrrrr�compiler	rr r
r
r
r�<module>s

site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-38.pyc000064400000025064151446176770021263 0ustar00U

��.e�2�@snddlmZddlZzddlmZWn0ek
rTddlZdd�e��D�Z[YnXddl	Z	ddl
Z
ddlZddlZddl
Z
dddd	d
d�ZejdkZGd
d�de�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zefd%d&�Zd'd(�Zd=d)d*�Z d+d,�Z!d-d.�Z"d/d0�Z#d1d2�Z$efd3d4�Z%d5d6�Z&d7d8�Z'd9d:�Z(d;d<�Z)dS)>�)�absolute_importN)�EXTENSION_SUFFIXEScCsg|]}|d�qS)r�)�.0�xrr�>/usr/lib/python3.8/site-packages/pip/_vendor/packaging/tags.py�
<listcomp>sr�py�cp�ppZipZjy)�pythonZcpythonZpypyZ
ironpythonZjythonlc@sbeZdZdddgZdd�Zedd��Zedd	��Zed
d��Zdd
�Z	dd�Z
dd�Zdd�ZdS)�Tag�_interpreter�_abi�	_platformcCs"|��|_|��|_|��|_dS�N)�lowerrrr)�self�interpreter�abi�platformrrr�__init__'s

zTag.__init__cCs|jSr)r�rrrrr,szTag.interpretercCs|jSr)rrrrrr0szTag.abicCs|jSr)rrrrrr4szTag.platformcCs$|j|jko"|j|jko"|j|jkSr)rrr)r�otherrrr�__eq__8s

�
�z
Tag.__eq__cCst|j|j|jf�Sr)�hashrrrrrrr�__hash__?szTag.__hash__cCsd�|j|j|j�S)Nz{}-{}-{})�formatrrrrrrr�__str__BszTag.__str__cCsdj|t|�d�S)Nz<{self} @ {self_id}>)rZself_id)r�idrrrr�__repr__EszTag.__repr__N)
�__name__�
__module__�__qualname__�	__slots__r�propertyrrrrrrr rrrrr
#s



r
c	Cs`t�}|�d�\}}}|�d�D]6}|�d�D]&}|�d�D]}|�t|||��q<q.q t|�S)N�-�.)�set�split�addr
�	frozenset)�tag�tagsZinterpreters�abis�	platformsrr�	platform_rrr�	parse_tagIsr1cCs|�dd��dd�S)Nr'�_r&��replace)�stringrrr�_normalize_stringSsr6cCsdj|d|dd�S)N�cp{major}{minor}r���major�minor)r)�
py_versionrrr�_cpython_interpreterWsr=c	Cs�g}dj|dd��}d}}}t�d�}ttd�}dtk}|sR|dkrV|sR|rVd}|dkr�t�d	�}	|	st|	dkrxd
}|dkr�t�d�}
|
d
ks�|
dkr�tjdkr�d}n|r�|�dj|d��|�ddj||||d��|S)Nz{}{}��ZPy_DEBUGZgettotalrefcountz_d.pyd�d)��Z
WITH_PYMALLOC�m)rArAZPy_UNICODE_SIZE�i���uzcp{version})�versionrz"cp{version}{debug}{pymalloc}{ucs4})rF�debug�pymalloc�ucs4)	r�	sysconfig�get_config_var�hasattr�sysr�
maxunicode�append�insert)r<r.rFrGrHrIZ
with_debugZhas_refcountZhas_extZ
with_pymallocZunicode_sizerrr�
_cpython_abis\s@



����rQc#s�|D]}|D]}t�||�Vqq�fdd�|D�D]
}|Vq4�fdd�|D�D]
}|VqRt|dddd�D].}|D]$}dj|d|d��t�d	|�VqzqrdS)
Nc3s|]}t�d|�VqdS)�abi3N�r
�rr0�rrr�	<genexpr>�sz _cpython_tags.<locals>.<genexpr>c3s|]}t�d|�VqdS��noneNrSrTrUrrrV�sr8���r7rr9rR)r
�ranger)r<rr.r/rr0r,�
minor_versionrrUr�
_cpython_tagss�r\cCsdjtjdtjjtjjd�S)Nz$pp{py_major}{pypy_major}{pypy_minor}r)Zpy_majorZ
pypy_majorZ
pypy_minor)rrM�version_infoZpypy_version_infor:r;rrrr�_pypy_interpreter�s
�r^cCst�d�}|rt|�SdSdS)NZSOABIrX)rJrKr6)rrrr�_generic_abi�s
r_c#sB��fdd�|D�D]
}|Vq�fdd�|D�D]
}|Vq2dS)Nc3s|]}t��|�VqdSrrS�rr�rrrrrV�sz_pypy_tags.<locals>.<genexpr>c3s|]}t�d|�VqdSrWrSr`rUrrrV�sr)r<rrr/r,rrar�
_pypy_tags�srbc#sN��fdd�|D�D]
}|Vq�dkrJ�fdd�|D�}|D]
}|Vq>dS)Nc3s|]}t��|�VqdSrrSr`rarrrV�sz _generic_tags.<locals>.<genexpr>rXc3s|]}t�d|�VqdSrWrSrTrUrrrV�sr)rr<rr/r,r-rrar�
_generic_tags�srcccs\dj|d|dd�Vdj|dd�Vt|dddd�D]}dj|d|d�Vq>dS)	z�
    Yield Python versions in descending order.

    After the latest version, the major-only version will be yielded, and then
    all following versions up to 'end'.
    zpy{major}{minor}rr8r9z	py{major})r:rYN)rrZ)r<r;rrr�_py_interpreter_range�srdccsTt|�D]}|D]}t|d|�Vqqt|dd�Vt|�D]}t|dd�Vq<dS)z�
    Return the sequence of tags that are consistent across implementations.

    The tags consist of:
    - py*-none-<platform>
    - <interpreter>-none-any
    - py*-none-any
    rX�anyN)rdr
)rr<r/rFr0rrr�_independent_tags�s	rfcCs|s|S|�d�rdSdS)N�ppc�i386)�
startswith)�arch�is_32bitrrr�	_mac_arch�s

rlcCs�|g}|dkr,|dkrgS|�dddg�np|dkrR|dkr@gS|�dddg�nJ|dkrz|d	ksj|dkrngS|�d�n"|d
kr�|dkr�gS|�ddg�|�d�|S)
NZx86_64)�
rDZintelZfat64Zfat32rhZfatZppc64)rm�rg)rm�Z	universal)�extendrO)rF�cpu_archZformatsrrr�_mac_binary_formats�s&
rrc
	Cs�t��\}}}|dkr2ttt|�d�dd���}|dkrBt|�}g}t|ddd�D]B}|d|f}t||�}|D]"}	|�	dj
|d|d|	d��qtqV|S)Nr'r>r8rYrz&macosx_{major}_{minor}_{binary_format})r:r;�
binary_format)rZmac_ver�tuple�map�intr)rlrZrrrOr)
rFrj�version_strr2rqr/r[Zcompat_versionZbinary_formatsrsrrr�_mac_platforms�s$
��rxc	Cs>zddl}tt||d��WSttfk
r4YnXt|�S)NrZ_compatible)�
_manylinux�bool�getattr�ImportError�AttributeError�_have_compatible_glibc)�name�
glibc_versionryrrr�_is_manylinux_compatible	sr�cCsZddl}|�d�}z
|j}Wntk
r2YdSX|j|_|�}t|t�sV|�d�}|S)Nr�ascii)	�ctypesZCDLL�gnu_get_libc_versionr}Zc_char_pZrestype�
isinstance�str�decode)r�Zprocess_namespacer�rwrrr�_glibc_version_strings



r�cCsHt�d|�}|s$t�d|t�dSt|�d��|koFt|�d��|kS)Nz$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z=Expected glibc version with 2 components major.minor, got: %sFr:r;)�re�match�warnings�warn�RuntimeWarningrv�group)rw�required_major�
minimum_minorrCrrr�_check_glibc_version1s���r�cCst�}|dkrdSt|||�S)NF)r�r�)r�r�rwrrrr~Fsr~cs|ttj�����dkr|rd�d}t|�}|D]$\}}t||�r.��d|�g}qXq.g}|�fdd�|D�7}|���|S)NZlinux_x86_64Z
linux_i686))Z
manylinux2014)r>�)Z
manylinux2010)r>�)Z
manylinux1)r>rn�linuxcsg|]\}}��d|��qS�r�r3)rrr2r�rrr^sz$_linux_platforms.<locals>.<listcomp>)r6�	distutils�util�get_platform�iterr�r4rO)rkZmanylinux_supportZmanylinux_support_iterrr�r/rr�r�_linux_platformsMs

r�cCsttj���}|gSr)r6r�r�r�)rrrr�_generic_platformscsr�cCst����}t�|�p|Sr)rZpython_implementationr�INTERPRETER_SHORT_NAMES�get)rrrr�_interpreter_namehsr�cCs4t�d�}|s&d�tt|dd���}dj||d�S)NZpy_version_nodotr?r>z{name}{version})rrF)rJrK�joinrur�r)rr<rFrrr�_generic_interpreterms
r�ccs�tjdd�}t�}t��dkr(t�}nt��dkr<t�}nt�}|dkrvt|�}t	|�}t
||||�D]
}|VqhnZ|dkr�t�}t�}t
||||�D]
}|Vq�n*t||�}t�}t||||�D]
}|Vq�t|||�D]
}|Vq�dS)z�
    Returns the sequence of tag triples for the running interpreter.

    The order of the sequence corresponds to priority order for the
    interpreter, from most to least important.
    Nr>ZDarwinZLinuxr
r)rMr]r�r�systemrxr�r�r=rQr\r^r_rbr�rcrf)r<Zinterpreter_namer/rr.r,rrrr�sys_tagsts.


r�)NN)*Z
__future__rZdistutils.utilr�Zimportlib.machineryrr|ZimpZget_suffixesrr�rMrJr�r��maxsizeZ_32_BIT_INTERPRETER�objectr
r1r6r=rQr\r^r_rbrcrdrfrlrrrxr�r�r�r~r�r�r�r�r�rrrr�<module>sV�	
&
#	



site-packages/pip/_vendor/packaging/__pycache__/markers.cpython-38.opt-1.pyc000064400000021155151446176770022725 0ustar00U

��.e: �	@s@ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
mZmZddlm
Z
mZmZmZddlmZddlmZddlmZmZd	d
ddd
gZGdd	�d	e�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�Z Gdd�de�Z!ed�ed�Bed�Bed�Bed�Bed�Bed�Bed �Bed!�Bed"�Bed#�Bed$�Bed%�Bed&�Bed'�Bed(�Bed)�Bed*�BZ"d#d"ddddd+�Z#e"�$d,d-��ed.�ed/�Bed0�Bed1�Bed2�Bed3�Bed4�Bed5�BZ%e%ed6�Bed7�BZ&e&�$d8d-��ed9�ed:�BZ'e'�$d;d-��ed<�ed=�BZ(e"e'BZ)ee)e&e)�Z*e*�$d>d-��ed?��+�Z,ed@��+�Z-e�Z.e*ee,e.e-�BZ/e.e/e
e(e.�>ee.eZ0dAdB�Z1dSdDdE�Z2dFd-�dGd-�ej3ej4ej5ej6ej7ej8dH�Z9dIdJ�Z:e�Z;dKdL�Z<dMdN�Z=dOdP�Z>dQd
�Z?GdRd�de�Z@dS)T�)�absolute_import�division�print_functionN)�ParseException�ParseResults�stringStart�	stringEnd)�
ZeroOrMore�Group�Forward�QuotedString)�Literal�)�string_types)�	Specifier�InvalidSpecifier�
InvalidMarker�UndefinedComparison�UndefinedEnvironmentName�Marker�default_environmentc@seZdZdZdS)rzE
    An invalid marker was found, users should refer to PEP 508.
    N��__name__�
__module__�__qualname__�__doc__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/packaging/markers.pyrsc@seZdZdZdS)rzP
    An invalid operation was attempted on a value that doesn't support it.
    Nrrrrrr"sc@seZdZdZdS)rz\
    A name was attempted to be used that does not exist inside of the
    environment.
    Nrrrrrr(sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�NodecCs
||_dS�N)�value)�selfr rrr�__init__0sz
Node.__init__cCs
t|j�Sr)�strr �r!rrr�__str__3szNode.__str__cCsd�|jjt|��S)Nz<{0}({1!r})>)�format�	__class__rr#r$rrr�__repr__6sz
Node.__repr__cCst�dSr)�NotImplementedErrorr$rrr�	serialize9szNode.serializeN)rrrr"r%r(r*rrrrr/src@seZdZdd�ZdS)�VariablecCst|�Sr�r#r$rrrr*>szVariable.serializeN�rrrr*rrrrr+=sr+c@seZdZdd�ZdS)�ValuecCs
d�|�S)Nz"{0}")r&r$rrrr*CszValue.serializeNr-rrrrr.Bsr.c@seZdZdd�ZdS)�OpcCst|�Srr,r$rrrr*HszOp.serializeNr-rrrrr/Gsr/�implementation_version�platform_python_implementation�implementation_name�python_full_version�platform_release�platform_version�platform_machine�platform_system�python_version�sys_platform�os_name�os.name�sys.platform�platform.version�platform.machine�platform.python_implementation�python_implementationZextra)r;r<r=r>r?r@cCstt�|d|d��S�Nr)r+�ALIASES�get��s�l�trrr�<lambda>h�rHz===�==�>=�<=�!=z~=�>�<�not in�incCst|d�SrA)r/rDrrrrHorI�'�"cCst|d�SrA)r.rDrrrrHrrI�and�orcCst|d�SrA)�tuplerDrrrrHyrI�(�)cCs t|t�rdd�|D�S|SdS)NcSsg|]}t|��qSr)�_coerce_parse_result)�.0�irrr�
<listcomp>�sz(_coerce_parse_result.<locals>.<listcomp>)�
isinstancer)�resultsrrrrY�s
rYTcCs�t|t�r4t|�dkr4t|dttf�r4t|d�St|t�rndd�|D�}|rZd�|�Sdd�|�dSn"t|t�r�d�dd	�|D��S|SdS)
Nrrcss|]}t|dd�VqdS)F)�firstN)�_format_marker�rZ�mrrr�	<genexpr>�sz!_format_marker.<locals>.<genexpr>� rWrXcSsg|]}|���qSr)r*rarrrr\�sz"_format_marker.<locals>.<listcomp>)r]�list�lenrVr`�join)�markerr_�innerrrrr`�s�
��


r`cCs||kSrr��lhs�rhsrrrrH�rIcCs||kSrrrjrrrrH�rI)rQrPrOrLrJrMrKrNcCslztd�|��|g��}Wntk
r.YnX|�|�St�|���}|dkrbtd�|||���|||�S)N�z#Undefined {0!r} on {1!r} and {2!r}.)	rrgr*r�contains�
_operatorsrCrr&)rk�oprl�specZoperrrr�_eval_op�s
�rrcCs&|�|t�}|tkr"td�|���|S)Nz/{0!r} does not exist in evaluation environment.)rC�
_undefinedrr&)�environment�namer rrr�_get_env�s�rvc	Cs�gg}|D]�}t|t�r.|d�t||��q
t|t�r�|\}}}t|t�r`t||j�}|j}n|j}t||j�}|d�t|||��q
|dkr
|�g�q
t	dd�|D��S)N���rUcss|]}t|�VqdSr)�all)rZ�itemrrrrc�sz$_evaluate_markers.<locals>.<genexpr>)
r]re�append�_evaluate_markersrVr+rvr rr�any)	Zmarkersrt�groupsrhrkrprlZ	lhs_valueZ	rhs_valuerrrr{�s



r{cCs2d�|�}|j}|dkr.||dt|j�7}|S)Nz{0.major}.{0.minor}.{0.micro}�finalr)r&�releaselevelr#�serial)�info�versionZkindrrr�format_full_version�s

r�cCsrttd�r ttjj�}tjj}nd}d}||tjt��t�	�t�
�t��t��t��d�
t��dd��tjd�S)N�implementation�0rm�.�)r2r0r:r6r4r7r5r3r1r8r9)�hasattr�sysr�r�r�ru�os�platform�machine�release�systemr8r@rgZpython_version_tuple)Ziverr2rrrr�s"

�c@s.eZdZdd�Zdd�Zdd�Zd
dd	�ZdS)rc
Cs`ztt�|��|_WnFtk
rZ}z(d�|||j|jd��}t|��W5d}~XYnXdS)Nz+Invalid marker: {0!r}, parse error at {1!r}�)rY�MARKERZparseString�_markersrr&Zlocr)r!rh�eZerr_strrrrr"s�zMarker.__init__cCs
t|j�Sr)r`r�r$rrrr%szMarker.__str__cCsd�t|��S)Nz<Marker({0!r})>)r&r#r$rrrr(szMarker.__repr__NcCs$t�}|dk	r|�|�t|j|�S)a$Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        N)r�updater{r�)r!rtZcurrent_environmentrrr�evaluates	
zMarker.evaluate)N)rrrr"r%r(r�rrrrrs	)T)AZ
__future__rrr�operatorr�r�r�Zpip._vendor.pyparsingrrrrr	r
rrr
�LZ_compatrZ
specifiersrr�__all__�
ValueErrorrrr�objectrr+r.r/ZVARIABLErBZsetParseActionZVERSION_CMPZ	MARKER_OPZMARKER_VALUEZBOOLOPZ
MARKER_VARZMARKER_ITEM�suppressZLPARENZRPARENZMARKER_EXPRZMARKER_ATOMr�rYr`�lt�le�eq�ne�ge�gtrorrrsrvr{r�rrrrrr�<module>s��	��������	�
���
�������>�
�site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-38.pyc000064400000007610151446176770023045 0ustar00U

��.e\�@s|ddlmZmZmZddlZddlZddlmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZddlmZddlmZddlmZmZdd	lmZmZmZGd
d�de�Zeejej�Z ed��!�Z"ed
��!�Z#ed��!�Z$ed��!�Z%ed��!�Z&ed��!�Z'ed��!�Z(ed�Z)e ee)�e BZ*ee ee*��Z+e+d�Z,e+Z-ed�d�Z.e(e.Z/e-ee&e-�Z0e"e
e0�e#d�Z1eej2ej3ej4B�Z5eej2ej3ej4B�Z6e5e6AZ7ee7ee&e7�ddd�d�Z8e
e$e8e%e8B�Z9e9�:dd��e	e9�d�Z;e;�:dd��e	e��d�Ze�:d d��e'Z<e<eZ=e;e
e=�Z>e/e
e=�Z?e,e
e1�e?e>BZ@ee@eZAeA�Bd!�Gd"d#�d#eC�ZDdS)$�)�absolute_import�division�print_functionN)�stringStart�	stringEnd�originalTextFor�ParseException)�
ZeroOrMore�Word�Optional�Regex�Combine)�Literal)�parse�)�MARKER_EXPR�Marker)�LegacySpecifier�	Specifier�SpecifierSetc@seZdZdZdS)�InvalidRequirementzJ
    An invalid requirement was found, users should refer to PEP 508.
    N)�__name__�
__module__�__qualname__�__doc__�rr�F/usr/lib/python3.8/site-packages/pip/_vendor/packaging/requirements.pyrsr�[�]�(�)�,�;�@z-_.�namez[^ ]+�url�extrasF)Z
joinStringZadjacent�	_raw_speccCs
|jpdS)N�)r'��s�l�trrr�<lambda>7�r-�	specifiercCs|dS)Nrrr)rrrr-:r.�markercCst||j|j��S)N)rZ_original_startZ
_original_endr)rrrr->r.zx[]c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Requirementz�Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    c
Cszt�|�}WnDtk
rR}z&td�||j|jd�|j���W5d}~XYnX|j|_|jr�t	�	|j�}|j
dkr�t	�|�|jkr�td��n(|j
r�|jr�|j
s�|js�td�|j���|j|_nd|_t
|jr�|j��ng�|_t|j�|_|jr�|jnd|_dS)NzParse error at "{0!r}": {1}��filezInvalid URL givenzInvalid URL: {0})�REQUIREMENT�parseStringrr�formatZloc�msgr$r%�urlparseZschemeZ
urlunparseZnetloc�setr&ZasListrr/r0)�selfZrequirement_stringZreq�eZ
parsed_urlrrr�__init__[s4��

��
zRequirement.__init__cCs�|jg}|jr*|�d�d�t|j����|jr@|�t|j��|jrh|�d�|j��|j	rh|�d�|j	r�|�d�|j	��d�|�S)Nz[{0}]r!z@ {0}� z; {0}r()
r$r&�appendr6�join�sortedr/�strr%r0)r:�partsrrr�__str__vs
zRequirement.__str__cCsd�t|��S)Nz<Requirement({0!r})>)r6rA)r:rrr�__repr__�szRequirement.__repr__N)rrrrr<rCrDrrrrr1Nsr1)EZ
__future__rrr�string�reZpip._vendor.pyparsingrrrrr	r
rrr
r�LZpip._vendor.six.moves.urllibrr8ZmarkersrrZ
specifiersrrr�
ValueErrorrZ
ascii_lettersZdigitsZALPHANUM�suppressZLBRACKETZRBRACKETZLPARENZRPAREN�COMMAZ	SEMICOLON�ATZPUNCTUATIONZIDENTIFIER_ENDZ
IDENTIFIER�NAMEZEXTRAZURIZURLZEXTRAS_LISTZEXTRASZ
_regex_str�VERBOSE�
IGNORECASEZVERSION_PEP440ZVERSION_LEGACYZVERSION_ONEZVERSION_MANYZ
_VERSION_SPECZsetParseActionZVERSION_SPECZMARKER_SEPARATORZMARKERZVERSION_AND_MARKERZURL_AND_MARKERZNAMED_REQUIREMENTr4r5�objectr1rrrr�<module>sh���
site-packages/pip/_vendor/packaging/__pycache__/tags.cpython-38.opt-1.pyc000064400000025064151446176770022222 0ustar00U

��.e�2�@snddlmZddlZzddlmZWn0ek
rTddlZdd�e��D�Z[YnXddl	Z	ddl
Z
ddlZddlZddl
Z
dddd	d
d�ZejdkZGd
d�de�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zefd%d&�Zd'd(�Zd=d)d*�Z d+d,�Z!d-d.�Z"d/d0�Z#d1d2�Z$efd3d4�Z%d5d6�Z&d7d8�Z'd9d:�Z(d;d<�Z)dS)>�)�absolute_importN)�EXTENSION_SUFFIXEScCsg|]}|d�qS)r�)�.0�xrr�>/usr/lib/python3.8/site-packages/pip/_vendor/packaging/tags.py�
<listcomp>sr�py�cp�ppZipZjy)�pythonZcpythonZpypyZ
ironpythonZjythonlc@sbeZdZdddgZdd�Zedd��Zedd	��Zed
d��Zdd
�Z	dd�Z
dd�Zdd�ZdS)�Tag�_interpreter�_abi�	_platformcCs"|��|_|��|_|��|_dS�N)�lowerrrr)�self�interpreter�abi�platformrrr�__init__'s

zTag.__init__cCs|jSr)r�rrrrr,szTag.interpretercCs|jSr)rrrrrr0szTag.abicCs|jSr)rrrrrr4szTag.platformcCs$|j|jko"|j|jko"|j|jkSr)rrr)r�otherrrr�__eq__8s

�
�z
Tag.__eq__cCst|j|j|jf�Sr)�hashrrrrrrr�__hash__?szTag.__hash__cCsd�|j|j|j�S)Nz{}-{}-{})�formatrrrrrrr�__str__BszTag.__str__cCsdj|t|�d�S)Nz<{self} @ {self_id}>)rZself_id)r�idrrrr�__repr__EszTag.__repr__N)
�__name__�
__module__�__qualname__�	__slots__r�propertyrrrrrrr rrrrr
#s



r
c	Cs`t�}|�d�\}}}|�d�D]6}|�d�D]&}|�d�D]}|�t|||��q<q.q t|�S)N�-�.)�set�split�addr
�	frozenset)�tag�tagsZinterpreters�abis�	platformsrr�	platform_rrr�	parse_tagIsr1cCs|�dd��dd�S)Nr'�_r&��replace)�stringrrr�_normalize_stringSsr6cCsdj|d|dd�S)N�cp{major}{minor}r���major�minor)r)�
py_versionrrr�_cpython_interpreterWsr=c	Cs�g}dj|dd��}d}}}t�d�}ttd�}dtk}|sR|dkrV|sR|rVd}|dkr�t�d	�}	|	st|	dkrxd
}|dkr�t�d�}
|
d
ks�|
dkr�tjdkr�d}n|r�|�dj|d��|�ddj||||d��|S)Nz{}{}��ZPy_DEBUGZgettotalrefcountz_d.pyd�d)��Z
WITH_PYMALLOC�m)rArAZPy_UNICODE_SIZE�i���uzcp{version})�versionrz"cp{version}{debug}{pymalloc}{ucs4})rF�debug�pymalloc�ucs4)	r�	sysconfig�get_config_var�hasattr�sysr�
maxunicode�append�insert)r<r.rFrGrHrIZ
with_debugZhas_refcountZhas_extZ
with_pymallocZunicode_sizerrr�
_cpython_abis\s@



����rQc#s�|D]}|D]}t�||�Vqq�fdd�|D�D]
}|Vq4�fdd�|D�D]
}|VqRt|dddd�D].}|D]$}dj|d|d��t�d	|�VqzqrdS)
Nc3s|]}t�d|�VqdS)�abi3N�r
�rr0�rrr�	<genexpr>�sz _cpython_tags.<locals>.<genexpr>c3s|]}t�d|�VqdS��noneNrSrTrUrrrV�sr8���r7rr9rR)r
�ranger)r<rr.r/rr0r,�
minor_versionrrUr�
_cpython_tagss�r\cCsdjtjdtjjtjjd�S)Nz$pp{py_major}{pypy_major}{pypy_minor}r)Zpy_majorZ
pypy_majorZ
pypy_minor)rrM�version_infoZpypy_version_infor:r;rrrr�_pypy_interpreter�s
�r^cCst�d�}|rt|�SdSdS)NZSOABIrX)rJrKr6)rrrr�_generic_abi�s
r_c#sB��fdd�|D�D]
}|Vq�fdd�|D�D]
}|Vq2dS)Nc3s|]}t��|�VqdSrrS�rr�rrrrrV�sz_pypy_tags.<locals>.<genexpr>c3s|]}t�d|�VqdSrWrSr`rUrrrV�sr)r<rrr/r,rrar�
_pypy_tags�srbc#sN��fdd�|D�D]
}|Vq�dkrJ�fdd�|D�}|D]
}|Vq>dS)Nc3s|]}t��|�VqdSrrSr`rarrrV�sz _generic_tags.<locals>.<genexpr>rXc3s|]}t�d|�VqdSrWrSrTrUrrrV�sr)rr<rr/r,r-rrar�
_generic_tags�srcccs\dj|d|dd�Vdj|dd�Vt|dddd�D]}dj|d|d�Vq>dS)	z�
    Yield Python versions in descending order.

    After the latest version, the major-only version will be yielded, and then
    all following versions up to 'end'.
    zpy{major}{minor}rr8r9z	py{major})r:rYN)rrZ)r<r;rrr�_py_interpreter_range�srdccsTt|�D]}|D]}t|d|�Vqqt|dd�Vt|�D]}t|dd�Vq<dS)z�
    Return the sequence of tags that are consistent across implementations.

    The tags consist of:
    - py*-none-<platform>
    - <interpreter>-none-any
    - py*-none-any
    rX�anyN)rdr
)rr<r/rFr0rrr�_independent_tags�s	rfcCs|s|S|�d�rdSdS)N�ppc�i386)�
startswith)�arch�is_32bitrrr�	_mac_arch�s

rlcCs�|g}|dkr,|dkrgS|�dddg�np|dkrR|dkr@gS|�dddg�nJ|dkrz|d	ksj|dkrngS|�d�n"|d
kr�|dkr�gS|�ddg�|�d�|S)
NZx86_64)�
rDZintelZfat64Zfat32rhZfatZppc64)rm�rg)rm�Z	universal)�extendrO)rF�cpu_archZformatsrrr�_mac_binary_formats�s&
rrc
	Cs�t��\}}}|dkr2ttt|�d�dd���}|dkrBt|�}g}t|ddd�D]B}|d|f}t||�}|D]"}	|�	dj
|d|d|	d��qtqV|S)Nr'r>r8rYrz&macosx_{major}_{minor}_{binary_format})r:r;�
binary_format)rZmac_ver�tuple�map�intr)rlrZrrrOr)
rFrj�version_strr2rqr/r[Zcompat_versionZbinary_formatsrsrrr�_mac_platforms�s$
��rxc	Cs>zddl}tt||d��WSttfk
r4YnXt|�S)NrZ_compatible)�
_manylinux�bool�getattr�ImportError�AttributeError�_have_compatible_glibc)�name�
glibc_versionryrrr�_is_manylinux_compatible	sr�cCsZddl}|�d�}z
|j}Wntk
r2YdSX|j|_|�}t|t�sV|�d�}|S)Nr�ascii)	�ctypesZCDLL�gnu_get_libc_versionr}Zc_char_pZrestype�
isinstance�str�decode)r�Zprocess_namespacer�rwrrr�_glibc_version_strings



r�cCsHt�d|�}|s$t�d|t�dSt|�d��|koFt|�d��|kS)Nz$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z=Expected glibc version with 2 components major.minor, got: %sFr:r;)�re�match�warnings�warn�RuntimeWarningrv�group)rw�required_major�
minimum_minorrCrrr�_check_glibc_version1s���r�cCst�}|dkrdSt|||�S)NF)r�r�)r�r�rwrrrr~Fsr~cs|ttj�����dkr|rd�d}t|�}|D]$\}}t||�r.��d|�g}qXq.g}|�fdd�|D�7}|���|S)NZlinux_x86_64Z
linux_i686))Z
manylinux2014)r>�)Z
manylinux2010)r>�)Z
manylinux1)r>rn�linuxcsg|]\}}��d|��qS�r�r3)rrr2r�rrr^sz$_linux_platforms.<locals>.<listcomp>)r6�	distutils�util�get_platform�iterr�r4rO)rkZmanylinux_supportZmanylinux_support_iterrr�r/rr�r�_linux_platformsMs

r�cCsttj���}|gSr)r6r�r�r�)rrrr�_generic_platformscsr�cCst����}t�|�p|Sr)rZpython_implementationr�INTERPRETER_SHORT_NAMES�get)rrrr�_interpreter_namehsr�cCs4t�d�}|s&d�tt|dd���}dj||d�S)NZpy_version_nodotr?r>z{name}{version})rrF)rJrK�joinrur�r)rr<rFrrr�_generic_interpreterms
r�ccs�tjdd�}t�}t��dkr(t�}nt��dkr<t�}nt�}|dkrvt|�}t	|�}t
||||�D]
}|VqhnZ|dkr�t�}t�}t
||||�D]
}|Vq�n*t||�}t�}t||||�D]
}|Vq�t|||�D]
}|Vq�dS)z�
    Returns the sequence of tag triples for the running interpreter.

    The order of the sequence corresponds to priority order for the
    interpreter, from most to least important.
    Nr>ZDarwinZLinuxr
r)rMr]r�r�systemrxr�r�r=rQr\r^r_rbr�rcrf)r<Zinterpreter_namer/rr.r,rrrr�sys_tagsts.


r�)NN)*Z
__future__rZdistutils.utilr�Zimportlib.machineryrr|ZimpZget_suffixesrr�rMrJr�r��maxsizeZ_32_BIT_INTERPRETER�objectr
r1r6r=rQr\r^r_rbrcrdrfrlrrrxr�r�r�r~r�r�r�r�r�rrrr�<module>sV�	
&
#	



site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-38.opt-1.pyc000064400000005301151446176770023636 0ustar00U

��.e��@sDddlmZmZmZGdd�de�Ze�ZGdd�de�Ze�ZdS)�)�absolute_import�division�print_functionc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)�InfinitycCsdS)Nr���selfrr�E/usr/lib/python3.8/site-packages/pip/_vendor/packaging/_structures.py�__repr__szInfinity.__repr__cCstt|��S�N��hash�reprrrrr	�__hash__szInfinity.__hash__cCsdS�NFr�r�otherrrr	�__lt__szInfinity.__lt__cCsdSrrrrrr	�__le__szInfinity.__le__cCst||j�Sr��
isinstance�	__class__rrrr	�__eq__szInfinity.__eq__cCst||j�Srrrrrr	�__ne__szInfinity.__ne__cCsdS�NTrrrrr	�__gt__szInfinity.__gt__cCsdSrrrrrr	�__ge__szInfinity.__ge__cCstSr)�NegativeInfinityrrrr	�__neg__ szInfinity.__neg__N��__name__�
__module__�__qualname__r
rrrrrrrrrrrr	rsrc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)rcCsdS)Nz	-Infinityrrrrr	r
(szNegativeInfinity.__repr__cCstt|��Srrrrrr	r+szNegativeInfinity.__hash__cCsdSrrrrrr	r.szNegativeInfinity.__lt__cCsdSrrrrrr	r1szNegativeInfinity.__le__cCst||j�Srrrrrr	r4szNegativeInfinity.__eq__cCst||j�Srrrrrr	r7szNegativeInfinity.__ne__cCsdSrrrrrr	r:szNegativeInfinity.__gt__cCsdSrrrrrr	r=szNegativeInfinity.__ge__cCstSr)rrrrr	r@szNegativeInfinity.__neg__Nrrrrr	r'srN)Z
__future__rrr�objectrrrrrr	�<module>ssite-packages/pip/_vendor/packaging/__pycache__/version.cpython-38.pyc000064400000027432151446176770022013 0ustar00U

��.e�.�	@s�ddlmZmZmZddlZddlZddlZddlmZddddd	gZ	e�
d
ddd
dddg�Zdd�ZGdd�de
�ZGdd�de�ZGdd�de�Ze�dej�Zdddddd�Zdd�Zdd�ZdZGd d�de�Zd!d"�Ze�d#�Zd$d%�Zd&d'�ZdS)(�)�absolute_import�division�print_functionN�)�Infinity�parse�Version�
LegacyVersion�InvalidVersion�VERSION_PATTERN�_Version�epoch�release�dev�pre�post�localcCs,z
t|�WStk
r&t|�YSXdS)z�
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    N)rr
r	)�version�r�A/usr/lib/python3.8/site-packages/pip/_vendor/packaging/version.pyrs
c@seZdZdZdS)r
zF
    An invalid version was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__rrrrr
!sc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)�_BaseVersioncCs
t|j�S�N)�hash�_key��selfrrr�__hash__(sz_BaseVersion.__hash__cCs|�|dd��S)NcSs||kSrr��s�orrr�<lambda>,�z%_BaseVersion.__lt__.<locals>.<lambda>��_compare�r�otherrrr�__lt__+sz_BaseVersion.__lt__cCs|�|dd��S)NcSs||kSrrr!rrrr$/r%z%_BaseVersion.__le__.<locals>.<lambda>r&r(rrr�__le__.sz_BaseVersion.__le__cCs|�|dd��S)NcSs||kSrrr!rrrr$2r%z%_BaseVersion.__eq__.<locals>.<lambda>r&r(rrr�__eq__1sz_BaseVersion.__eq__cCs|�|dd��S)NcSs||kSrrr!rrrr$5r%z%_BaseVersion.__ge__.<locals>.<lambda>r&r(rrr�__ge__4sz_BaseVersion.__ge__cCs|�|dd��S)NcSs||kSrrr!rrrr$8r%z%_BaseVersion.__gt__.<locals>.<lambda>r&r(rrr�__gt__7sz_BaseVersion.__gt__cCs|�|dd��S)NcSs||kSrrr!rrrr$;r%z%_BaseVersion.__ne__.<locals>.<lambda>r&r(rrr�__ne__:sz_BaseVersion.__ne__cCst|t�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr)�methodrrrr'=s
z_BaseVersion._compareN)rrrr r*r+r,r-r.r/r'rrrrr'src@s�eZdZdd�Zdd�Zdd�Zedd��Zed	d
��Zedd��Z	ed
d��Z
edd��Zedd��Zedd��Z
edd��Zedd��Zedd��Zedd��ZdS)r	cCst|�|_t|j�|_dSr)�str�_version�_legacy_cmpkeyr)rrrrr�__init__Es
zLegacyVersion.__init__cCs|jSr�r4rrrr�__str__IszLegacyVersion.__str__cCsd�tt|���S)Nz<LegacyVersion({0})>��format�reprr3rrrr�__repr__LszLegacyVersion.__repr__cCs|jSrr7rrrr�publicOszLegacyVersion.publiccCs|jSrr7rrrr�base_versionSszLegacyVersion.base_versioncCsdS)N���rrrrrr
WszLegacyVersion.epochcCsdSrrrrrrr[szLegacyVersion.releasecCsdSrrrrrrr_szLegacyVersion.precCsdSrrrrrrrcszLegacyVersion.postcCsdSrrrrrrrgszLegacyVersion.devcCsdSrrrrrrrkszLegacyVersion.localcCsdS�NFrrrrr�
is_prereleaseoszLegacyVersion.is_prereleasecCsdSr@rrrrr�is_postreleasesszLegacyVersion.is_postreleasecCsdSr@rrrrr�
is_devreleasewszLegacyVersion.is_devreleaseN)rrrr6r8r<�propertyr=r>r
rrrrrrArBrCrrrrr	Ds2









z(\d+ | [a-z]+ | \.| -)�czfinal-�@)r�preview�-�rcrccs\t�|�D]F}t�||�}|r
|dkr(q
|dd�dkrF|�d�Vq
d|Vq
dVdS)N�.r�
0123456789��*�*final)�_legacy_version_component_re�split�_legacy_version_replacement_map�get�zfill)r"�partrrr�_parse_version_parts�srUcCszd}g}t|���D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�}||fS)Nr?rMrNz*final-Z00000000)rU�lower�
startswith�pop�append�tuple)rr
�partsrTrrrr5�s


r5a�
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
c@s�eZdZe�dedejejB�Zdd�Z	dd�Z
dd�Zed	d
��Z
edd��Zed
d��Zedd��Zedd��Zedd��Zedd��Zedd��Zedd��Zedd��Zedd��ZdS) rz^\s*z\s*$c
Cs�|j�|�}|std�|���t|�d�r8t|�d��ndtdd�|�d��d�D��t	|�d�|�d	��t	|�d
�|�d�p�|�d��t	|�d
�|�d��t
|�d��d�|_t|jj
|jj|jj|jj|jj|jj�|_dS)NzInvalid version: '{0}'r
rcss|]}t|�VqdSr)�int��.0�irrr�	<genexpr>�sz#Version.__init__.<locals>.<genexpr>rrJZpre_lZpre_nZpost_lZpost_n1Zpost_n2Zdev_lZdev_nr�r
rrrrr)�_regex�searchr
r:r�groupr\rZrP�_parse_letter_version�_parse_local_versionr4�_cmpkeyr
rrrrrr)rr�matchrrrr6�s,���zVersion.__init__cCsd�tt|���S)Nz<Version({0})>r9rrrrr<�szVersion.__repr__cCs�g}|jdkr |�d�|j��|�d�dd�|jD���|jdk	rb|�d�dd�|jD���|jdk	r~|�d�|j��|jdk	r�|�d	�|j��|jdk	r�|�d
�|j��d�|�S)Nr�{0}!rJcss|]}t|�VqdSr�r3�r^�xrrrr`sz"Version.__str__.<locals>.<genexpr>�css|]}t|�VqdSrrjrkrrrr`sz.post{0}z.dev{0}z+{0})	r
rYr:�joinrrrrr�rr[rrrr8�s




zVersion.__str__cCs|jjSr)r4r
rrrrr
sz
Version.epochcCs|jjSr)r4rrrrrrszVersion.releasecCs|jjSr)r4rrrrrrszVersion.precCs|jjr|jjdSdS�Nr)r4rrrrrr szVersion.postcCs|jjr|jjdSdSrp)r4rrrrrr$szVersion.devcCs(|jjr d�dd�|jjD��SdSdS)NrJcss|]}t|�VqdSrrjrkrrrr`+sz Version.local.<locals>.<genexpr>)r4rrnrrrrr(sz
Version.localcCst|��dd�dS)N�+rr)r3rPrrrrr=/szVersion.publiccCsFg}|jdkr |�d�|j��|�d�dd�|jD���d�|�S)NrrirJcss|]}t|�VqdSrrjrkrrrr`<sz'Version.base_version.<locals>.<genexpr>rm)r
rYr:rnrrorrrr>3s

zVersion.base_versioncCs|jdk	p|jdk	Sr)rrrrrrrA@szVersion.is_prereleasecCs
|jdk	Sr)rrrrrrBDszVersion.is_postreleasecCs
|jdk	Sr)rrrrrrCHszVersion.is_devreleaseN)rrr�re�compiler�VERBOSE�
IGNORECASErbr6r<r8rDr
rrrrrr=r>rArBrCrrrrr�s4









cCsv|rZ|dkrd}|��}|dkr&d}n(|dkr4d}n|dkrBd}n|dkrNd	}|t|�fS|sr|rrd	}|t|�fSdS)
NrZalpha�aZbeta�b)rErrGrI)Zrev�rr)rVr\)ZletterZnumberrrrreMs rez[\._-]cCs$|dk	r tdd�t�|�D��SdS)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Ncss&|]}|��s|��nt|�VqdSr)�isdigitrVr\)r^rTrrrr`ts�z'_parse_local_version.<locals>.<genexpr>)rZ�_local_version_separatorsrP)rrrrrfos�rfcCs�tttt�dd�t|�����}|dkr@|dkr@|dk	r@t}n|dkrLt}|dkrZt}|dkrft}|dkrvt}ntdd�|D��}||||||fS)NcSs|dkS)Nrr)rlrrrr$�r%z_cmpkey.<locals>.<lambda>css*|]"}t|t�r|dfnt|fVqdS)rmN)r0r\rr]rrrr`�sz_cmpkey.<locals>.<genexpr>)rZ�reversed�list�	itertools�	dropwhilerrarrrrgzs�	rg)Z
__future__rrr�collectionsr}rrZ_structuresr�__all__�
namedtuplerr�
ValueErrorr
�objectrr	rsrtrOrQrUr5rrrerzrfrgrrrr�<module>s8�8�	 x
site-packages/pip/_vendor/packaging/__pycache__/__about__.cpython-38.opt-1.pyc000064400000001271151446176770023164 0ustar00U

��.e��@sPddlmZmZmZdddddddd	gZd
ZdZdZd
ZdZ	dZ
dZde	ZdS)�)�absolute_import�division�print_function�	__title__�__summary__�__uri__�__version__�
__author__�	__email__�__license__�
__copyright__Z	packagingz"Core utilities for Python packagesz!https://github.com/pypa/packagingz19.2z)Donald Stufft and individual contributorszdonald@stufft.ioz"BSD or Apache License, Version 2.0zCopyright 2014-2019 %sN)
Z
__future__rrr�__all__rrrrr	r
rr�rr�C/usr/lib/python3.8/site-packages/pip/_vendor/packaging/__about__.py�<module>s"�site-packages/pip/_vendor/packaging/__pycache__/__about__.cpython-38.pyc000064400000001271151446176770022225 0ustar00U

��.e��@sPddlmZmZmZdddddddd	gZd
ZdZdZd
ZdZ	dZ
dZde	ZdS)�)�absolute_import�division�print_function�	__title__�__summary__�__uri__�__version__�
__author__�	__email__�__license__�
__copyright__Z	packagingz"Core utilities for Python packagesz!https://github.com/pypa/packagingz19.2z)Donald Stufft and individual contributorszdonald@stufft.ioz"BSD or Apache License, Version 2.0zCopyright 2014-2019 %sN)
Z
__future__rrr�__all__rrrrr	r
rr�rr�C/usr/lib/python3.8/site-packages/pip/_vendor/packaging/__about__.py�<module>s"�site-packages/pip/_vendor/packaging/__pycache__/utils.cpython-38.pyc000064400000002624151446176770021462 0ustar00U

��.e��@sJddlmZmZmZddlZddlmZmZe�d�Z	dd�Z
dd	�ZdS)
�)�absolute_import�division�print_functionN�)�InvalidVersion�Versionz[-_.]+cCst�d|���S)N�-)�_canonicalize_regex�sub�lower)�name�r
�?/usr/lib/python3.8/site-packages/pip/_vendor/packaging/utils.py�canonicalize_namesrc
Cs�zt|�}Wntk
r$|YSXg}|jdkrF|�d�|j��|�t�ddd�dd�|jD����|j	dk	r�|�d�d	d�|j	D���|j
dk	r�|�d
�|j
��|jdk	r�|�d�|j��|jdk	r�|�d�|j��d�|�S)
z�
    This is very similar to Version.__str__, but has one subtle differences
    with the way it handles the release segment.
    rz{0}!z(\.0)+$��.css|]}t|�VqdS�N��str��.0�xr
r
r�	<genexpr>'sz'canonicalize_version.<locals>.<genexpr>Ncss|]}t|�VqdSrrrr
r
rr+sz.post{0}z.dev{0}z+{0})
rrZepoch�append�format�rer
�join�releaseZpreZpostZdevZlocal)�version�partsr
r
r�canonicalize_versions"

&



r )Z
__future__rrrrrrr�compiler	rr r
r
r
r�<module>s

site-packages/pip/_vendor/packaging/__pycache__/markers.cpython-38.pyc000064400000021322151446176770021762 0ustar00U

��.e: �	@s@ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
mZmZddlm
Z
mZmZmZddlmZddlmZddlmZmZd	d
ddd
gZGdd	�d	e�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�Z Gdd�de�Z!ed�ed�Bed�Bed�Bed�Bed�Bed�Bed �Bed!�Bed"�Bed#�Bed$�Bed%�Bed&�Bed'�Bed(�Bed)�Bed*�BZ"d#d"ddddd+�Z#e"�$d,d-��ed.�ed/�Bed0�Bed1�Bed2�Bed3�Bed4�Bed5�BZ%e%ed6�Bed7�BZ&e&�$d8d-��ed9�ed:�BZ'e'�$d;d-��ed<�ed=�BZ(e"e'BZ)ee)e&e)�Z*e*�$d>d-��ed?��+�Z,ed@��+�Z-e�Z.e*ee,e.e-�BZ/e.e/e
e(e.�>ee.eZ0dAdB�Z1dSdDdE�Z2dFd-�dGd-�ej3ej4ej5ej6ej7ej8dH�Z9dIdJ�Z:e�Z;dKdL�Z<dMdN�Z=dOdP�Z>dQd
�Z?GdRd�de�Z@dS)T�)�absolute_import�division�print_functionN)�ParseException�ParseResults�stringStart�	stringEnd)�
ZeroOrMore�Group�Forward�QuotedString)�Literal�)�string_types)�	Specifier�InvalidSpecifier�
InvalidMarker�UndefinedComparison�UndefinedEnvironmentName�Marker�default_environmentc@seZdZdZdS)rzE
    An invalid marker was found, users should refer to PEP 508.
    N��__name__�
__module__�__qualname__�__doc__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/packaging/markers.pyrsc@seZdZdZdS)rzP
    An invalid operation was attempted on a value that doesn't support it.
    Nrrrrrr"sc@seZdZdZdS)rz\
    A name was attempted to be used that does not exist inside of the
    environment.
    Nrrrrrr(sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�NodecCs
||_dS�N)�value)�selfr rrr�__init__0sz
Node.__init__cCs
t|j�Sr)�strr �r!rrr�__str__3szNode.__str__cCsd�|jjt|��S)Nz<{0}({1!r})>)�format�	__class__rr#r$rrr�__repr__6sz
Node.__repr__cCst�dSr)�NotImplementedErrorr$rrr�	serialize9szNode.serializeN)rrrr"r%r(r*rrrrr/src@seZdZdd�ZdS)�VariablecCst|�Sr�r#r$rrrr*>szVariable.serializeN�rrrr*rrrrr+=sr+c@seZdZdd�ZdS)�ValuecCs
d�|�S)Nz"{0}")r&r$rrrr*CszValue.serializeNr-rrrrr.Bsr.c@seZdZdd�ZdS)�OpcCst|�Srr,r$rrrr*HszOp.serializeNr-rrrrr/Gsr/�implementation_version�platform_python_implementation�implementation_name�python_full_version�platform_release�platform_version�platform_machine�platform_system�python_version�sys_platform�os_name�os.name�sys.platform�platform.version�platform.machine�platform.python_implementation�python_implementationZextra)r;r<r=r>r?r@cCstt�|d|d��S�Nr)r+�ALIASES�get��s�l�trrr�<lambda>h�rHz===�==�>=�<=�!=z~=�>�<�not in�incCst|d�SrA)r/rDrrrrHorI�'�"cCst|d�SrA)r.rDrrrrHrrI�and�orcCst|d�SrA)�tuplerDrrrrHyrI�(�)cCs t|t�rdd�|D�S|SdS)NcSsg|]}t|��qSr)�_coerce_parse_result)�.0�irrr�
<listcomp>�sz(_coerce_parse_result.<locals>.<listcomp>)�
isinstancer)�resultsrrrrY�s
rYTcCs�t|tttf�st�t|t�rHt|�dkrHt|dttf�rHt|d�St|t�r�dd�|D�}|rnd�|�Sdd�|�dSn"t|t�r�d�dd	�|D��S|SdS)
Nrrcss|]}t|dd�VqdS)F)�firstN)�_format_marker�rZ�mrrr�	<genexpr>�sz!_format_marker.<locals>.<genexpr>� rWrXcSsg|]}|���qSr)r*rarrrr\�sz"_format_marker.<locals>.<listcomp>)r]�listrVr�AssertionError�lenr`�join)�markerr_�innerrrrr`�s �
��


r`cCs||kSrr��lhs�rhsrrrrH�rIcCs||kSrrrkrrrrH�rI)rQrPrOrLrJrMrKrNcCslztd�|��|g��}Wntk
r.YnX|�|�St�|���}|dkrbtd�|||���|||�S)N�z#Undefined {0!r} on {1!r} and {2!r}.)	rrhr*r�contains�
_operatorsrCrr&)rl�oprm�specZoperrrr�_eval_op�s
�rscCs&|�|t�}|tkr"td�|���|S)Nz/{0!r} does not exist in evaluation environment.)rC�
_undefinedrr&)�environment�namer rrr�_get_env�s�rwc	Cs�gg}|D]�}t|tttf�s"t�t|t�rB|d�t||��q
t|t�r�|\}}}t|t�rtt||j	�}|j	}n|j	}t||j	�}|d�t
|||��q
|dks�t�|dkr
|�g�q
tdd�|D��S)N���)rTrUrUcss|]}t|�VqdSr)�all)rZ�itemrrrrc�sz$_evaluate_markers.<locals>.<genexpr>)r]rerVrrf�append�_evaluate_markersr+rwr rs�any)	Zmarkersru�groupsrirlrqrmZ	lhs_valueZ	rhs_valuerrrr|�s"



r|cCs2d�|�}|j}|dkr.||dt|j�7}|S)Nz{0.major}.{0.minor}.{0.micro}�finalr)r&�releaselevelr#�serial)�info�versionZkindrrr�format_full_version�s

r�cCsrttd�r ttjj�}tjj}nd}d}||tjt��t�	�t�
�t��t��t��d�
t��dd��tjd�S)N�implementation�0rn�.�)r2r0r:r6r4r7r5r3r1r8r9)�hasattr�sysr�r�r�rv�os�platform�machine�release�systemr8r@rhZpython_version_tuple)Ziverr2rrrr�s"

�c@s.eZdZdd�Zdd�Zdd�Zd
dd	�ZdS)rc
Cs`ztt�|��|_WnFtk
rZ}z(d�|||j|jd��}t|��W5d}~XYnXdS)Nz+Invalid marker: {0!r}, parse error at {1!r}�)rY�MARKERZparseString�_markersrr&Zlocr)r!ri�eZerr_strrrrr"s�zMarker.__init__cCs
t|j�Sr)r`r�r$rrrr%szMarker.__str__cCsd�t|��S)Nz<Marker({0!r})>)r&r#r$rrrr(szMarker.__repr__NcCs$t�}|dk	r|�|�t|j|�S)a$Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        N)r�updater|r�)r!ruZcurrent_environmentrrr�evaluates	
zMarker.evaluate)N)rrrr"r%r(r�rrrrrs	)T)AZ
__future__rrr�operatorr�r�r�Zpip._vendor.pyparsingrrrrr	r
rrr
�LZ_compatrZ
specifiersrr�__all__�
ValueErrorrrr�objectrr+r.r/ZVARIABLErBZsetParseActionZVERSION_CMPZ	MARKER_OPZMARKER_VALUEZBOOLOPZ
MARKER_VARZMARKER_ITEM�suppressZLPARENZRPARENZMARKER_EXPRZMARKER_ATOMr�rYr`�lt�le�eq�ne�ge�gtrprsrtrwr|r�rrrrrr�<module>s��	��������	�
���
�������>�
�site-packages/pip/_vendor/packaging/__pycache__/requirements.cpython-38.opt-1.pyc000064400000007610151446176770024004 0ustar00U

��.e\�@s|ddlmZmZmZddlZddlZddlmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZddlmZddlmZddlmZmZdd	lmZmZmZGd
d�de�Zeejej�Z ed��!�Z"ed
��!�Z#ed��!�Z$ed��!�Z%ed��!�Z&ed��!�Z'ed��!�Z(ed�Z)e ee)�e BZ*ee ee*��Z+e+d�Z,e+Z-ed�d�Z.e(e.Z/e-ee&e-�Z0e"e
e0�e#d�Z1eej2ej3ej4B�Z5eej2ej3ej4B�Z6e5e6AZ7ee7ee&e7�ddd�d�Z8e
e$e8e%e8B�Z9e9�:dd��e	e9�d�Z;e;�:dd��e	e��d�Ze�:d d��e'Z<e<eZ=e;e
e=�Z>e/e
e=�Z?e,e
e1�e?e>BZ@ee@eZAeA�Bd!�Gd"d#�d#eC�ZDdS)$�)�absolute_import�division�print_functionN)�stringStart�	stringEnd�originalTextFor�ParseException)�
ZeroOrMore�Word�Optional�Regex�Combine)�Literal)�parse�)�MARKER_EXPR�Marker)�LegacySpecifier�	Specifier�SpecifierSetc@seZdZdZdS)�InvalidRequirementzJ
    An invalid requirement was found, users should refer to PEP 508.
    N)�__name__�
__module__�__qualname__�__doc__�rr�F/usr/lib/python3.8/site-packages/pip/_vendor/packaging/requirements.pyrsr�[�]�(�)�,�;�@z-_.�namez[^ ]+�url�extrasF)Z
joinStringZadjacent�	_raw_speccCs
|jpdS)N�)r'��s�l�trrr�<lambda>7�r-�	specifiercCs|dS)Nrrr)rrrr-:r.�markercCst||j|j��S)N)rZ_original_startZ
_original_endr)rrrr->r.zx[]c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Requirementz�Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    c
Cszt�|�}WnDtk
rR}z&td�||j|jd�|j���W5d}~XYnX|j|_|jr�t	�	|j�}|j
dkr�t	�|�|jkr�td��n(|j
r�|jr�|j
s�|js�td�|j���|j|_nd|_t
|jr�|j��ng�|_t|j�|_|jr�|jnd|_dS)NzParse error at "{0!r}": {1}��filezInvalid URL givenzInvalid URL: {0})�REQUIREMENT�parseStringrr�formatZloc�msgr$r%�urlparseZschemeZ
urlunparseZnetloc�setr&ZasListrr/r0)�selfZrequirement_stringZreq�eZ
parsed_urlrrr�__init__[s4��

��
zRequirement.__init__cCs�|jg}|jr*|�d�d�t|j����|jr@|�t|j��|jrh|�d�|j��|j	rh|�d�|j	r�|�d�|j	��d�|�S)Nz[{0}]r!z@ {0}� z; {0}r()
r$r&�appendr6�join�sortedr/�strr%r0)r:�partsrrr�__str__vs
zRequirement.__str__cCsd�t|��S)Nz<Requirement({0!r})>)r6rA)r:rrr�__repr__�szRequirement.__repr__N)rrrrr<rCrDrrrrr1Nsr1)EZ
__future__rrr�string�reZpip._vendor.pyparsingrrrrr	r
rrr
r�LZpip._vendor.six.moves.urllibrr8ZmarkersrrZ
specifiersrrr�
ValueErrorrZ
ascii_lettersZdigitsZALPHANUM�suppressZLBRACKETZRBRACKETZLPARENZRPAREN�COMMAZ	SEMICOLON�ATZPUNCTUATIONZIDENTIFIER_ENDZ
IDENTIFIER�NAMEZEXTRAZURIZURLZEXTRAS_LISTZEXTRASZ
_regex_str�VERBOSE�
IGNORECASEZVERSION_PEP440ZVERSION_LEGACYZVERSION_ONEZVERSION_MANYZ
_VERSION_SPECZsetParseActionZVERSION_SPECZMARKER_SEPARATORZMARKERZVERSION_AND_MARKERZURL_AND_MARKERZNAMED_REQUIREMENTr4r5�objectr1rrrr�<module>sh���
site-packages/pip/_vendor/packaging/__pycache__/specifiers.cpython-38.opt-1.pyc000064400000046417151446176770023425 0ustar00U

��.e�l�@s�ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
ddlmZm
Z
mZGdd�de�ZGdd	�d	e
eje��ZGd
d�de�ZGdd
�d
e�Zdd�ZGdd�de�Ze�d�Zdd�Zdd�ZGdd�de�ZdS)�)�absolute_import�division�print_functionN�)�string_types�with_metaclass)�Version�
LegacyVersion�parsec@seZdZdZdS)�InvalidSpecifierzH
    An invalid specifier was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__�rr�D/usr/lib/python3.8/site-packages/pip/_vendor/packaging/specifiers.pyrsrc@s�eZdZejdd��Zejdd��Zejdd��Zejdd��Zej	d	d
��Z
e
jdd
��Z
ejdd
d��Zejddd��Z
dS)�
BaseSpecifiercCsdS)z�
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        Nr��selfrrr�__str__szBaseSpecifier.__str__cCsdS)zF
        Returns a hash value for this Specifier like object.
        Nrrrrr�__hash__szBaseSpecifier.__hash__cCsdS)zq
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        Nr�r�otherrrr�__eq__#szBaseSpecifier.__eq__cCsdS)zu
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        Nrrrrr�__ne__*szBaseSpecifier.__ne__cCsdS)zg
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        Nrrrrr�prereleases1szBaseSpecifier.prereleasescCsdS)zd
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr�r�valuerrrr8sNcCsdS)zR
        Determines if the given item is contained within this specifier.
        Nr�r�itemrrrr�contains?szBaseSpecifier.containscCsdS)z�
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        Nr)r�iterablerrrr�filterEszBaseSpecifier.filter)N)N)rr
r�abc�abstractmethodrrrr�abstractpropertyr�setterr r"rrrrrs 





rc@s�eZdZiZd dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zedd��Z
edd��Zedd��Zejdd��Zdd�Zd!dd�Zd"dd�ZdS)#�_IndividualSpecifier�NcCsF|j�|�}|std�|���|�d���|�d���f|_||_dS)NzInvalid specifier: '{0}'�operator�version)�_regex�searchr�format�group�strip�_spec�_prereleases)r�specr�matchrrr�__init__Qs
z_IndividualSpecifier.__init__cCs0|jdk	rd�|j�nd}d�|jjt|�|�S)N�, prereleases={0!r}r(z<{0}({1!r}{2})>)r1r-r�	__class__r�str�rZprerrr�__repr__[s
��z_IndividualSpecifier.__repr__cCsdj|j�S)Nz{0}{1})r-r0rrrrrdsz_IndividualSpecifier.__str__cCs
t|j�S�N)�hashr0rrrrrgsz_IndividualSpecifier.__hash__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:��
isinstancerr6r�NotImplementedr0rrrrrjs
z_IndividualSpecifier.__eq__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:r<rrrrrus
z_IndividualSpecifier.__ne__cCst|d�|j|��S)Nz_compare_{0})�getattrr-�
_operators)r�oprrr�
_get_operator�sz"_IndividualSpecifier._get_operatorcCst|ttf�st|�}|Sr:)r=r	rr
�rr*rrr�_coerce_version�sz$_IndividualSpecifier._coerce_versioncCs
|jdS)Nr�r0rrrrr)�sz_IndividualSpecifier.operatorcCs
|jdS)NrrErrrrr*�sz_IndividualSpecifier.versioncCs|jSr:�r1rrrrr�sz _IndividualSpecifier.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:�r �rrrrr�__contains__�sz!_IndividualSpecifier.__contains__cCs:|dkr|j}|�|�}|jr&|s&dS|�|j�||j�S�NF)rrD�
is_prereleaserBr)r*rrrrr �s

z_IndividualSpecifier.containsccs�d}g}d|dk	r|ndi}|D]B}|�|�}|j|f|�r |jrX|sX|jsX|�|�q d}|Vq |s||r||D]
}|VqpdS)NFrT)rDr rKr�append)rr!rZyielded�found_prereleases�kwr*�parsed_versionrrrr"�s"
��z_IndividualSpecifier.filter)r(N)N)N)rr
rr@r4r9rrrrrBrD�propertyr)r*rr&rIr r"rrrrr'Ms(

	




r'c@sveZdZdZe�dedejejB�Zdddddd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�LegacySpecifiera�
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        �^\s*�\s*$�equal�	not_equal�less_than_equal�greater_than_equal�	less_than�greater_than)�==�!=�<=�>=�<�>cCst|t�stt|��}|Sr:)r=r	r7rCrrrrD�s
zLegacySpecifier._coerce_versioncCs||�|�kSr:�rD�r�prospectiver2rrr�_compare_equal�szLegacySpecifier._compare_equalcCs||�|�kSr:r`rarrr�_compare_not_equal�sz"LegacySpecifier._compare_not_equalcCs||�|�kSr:r`rarrr�_compare_less_than_equal�sz(LegacySpecifier._compare_less_than_equalcCs||�|�kSr:r`rarrr�_compare_greater_than_equal�sz+LegacySpecifier._compare_greater_than_equalcCs||�|�kSr:r`rarrr�_compare_less_than�sz"LegacySpecifier._compare_less_thancCs||�|�kSr:r`rarrr�_compare_greater_than�sz%LegacySpecifier._compare_greater_thanN)rr
r�
_regex_str�re�compile�VERBOSE�
IGNORECASEr+r@rDrcrdrerfrgrhrrrrrQ�s �	rQcst����fdd��}|S)Ncst|t�sdS�|||�SrJ)r=rra��fnrr�wrappeds
z)_require_version_compare.<locals>.wrapped)�	functools�wraps)rorprrnr�_require_version_comparesrsc	@s�eZdZdZe�dedejejB�Zdddddd	d
dd�Z	e
d
d��Ze
dd��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��Ze
dd��Zdd�Zedd��Zejdd��Zd S)!�	Specifiera
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        rRrSZ
compatiblerTrUrVrWrXrYZ	arbitrary)�~=rZr[r\r]r^r_�===cCsNd�tt�dd�t|���dd��}|d7}|�d�||�oL|�d�||�S)N�.cSs|�d�o|�d�S)NZpostZdev)�
startswith��xrrr�<lambda>��z/Specifier._compare_compatible.<locals>.<lambda>����.*r]rZ)�join�list�	itertools�	takewhile�_version_splitrB)rrbr2�prefixrrr�_compare_compatiblevs����
�zSpecifier._compare_compatiblecCsp|�d�rPt|j�}t|dd��}tt|��}|dt|��}t||�\}}nt|�}|jsht|j�}||kS)Nr~���)�endswithrZpublicr�r7�len�_pad_version�localrarrrrc�s


zSpecifier._compare_equalcCs|�||�Sr:)rcrarrrrd�szSpecifier._compare_not_equalcCs|t|�kSr:�rrarrrre�sz"Specifier._compare_less_than_equalcCs|t|�kSr:r�rarrrrf�sz%Specifier._compare_greater_than_equalcCs<t|�}||ksdS|js8|jr8t|j�t|j�kr8dSdS�NFT)rrK�base_versionrarrrrg�szSpecifier._compare_less_thancCs^t|�}||ksdS|js8|jr8t|j�t|j�kr8dS|jdk	rZt|j�t|j�krZdSdSr�)rZis_postreleaser�r�rarrrrh�s
zSpecifier._compare_greater_thancCst|���t|���kSr:)r7�lowerrarrr�_compare_arbitrary�szSpecifier._compare_arbitrarycCsR|jdk	r|jS|j\}}|dkrN|dkr@|�d�r@|dd�}t|�jrNdSdS)N)rZr]r\rurvrZr~r�TF)r1r0r�r
rK)rr)r*rrrr�s


zSpecifier.prereleasescCs
||_dSr:rFrrrrrsN)rr
rrirjrkrlrmr+r@rsr�rcrdrerfrgrhr�rPrr&rrrrrt
s<]�

"





rtz^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCs@g}|�d�D],}t�|�}|r0|�|���q|�|�q|S)Nrw)�split�
_prefix_regexr,�extend�groupsrL)r*�resultrr3rrrr�s
r�c
Cs�gg}}|�tt�dd�|���|�tt�dd�|���|�|t|d�d��|�|t|d�d��|�ddgtdt|d�t|d���|�ddgtdt|d�t|d���ttj|��ttj|��fS)NcSs|��Sr:��isdigitryrrrr{*r|z_pad_version.<locals>.<lambda>cSs|��Sr:r�ryrrrr{+r|rr�0)rLr�r�r�r��insert�max�chain)�left�rightZ
left_splitZright_splitrrrr�&s
,,r�c@s�eZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zedd��Z
e
jdd��Z
dd�Zddd�Zd dd�ZdS)!�SpecifierSetr(Nc	Csndd�|�d�D�}t�}|D]:}z|�t|��Wqtk
rV|�t|��YqXqt|�|_||_dS)NcSsg|]}|��r|���qSr)r/��.0�srrr�
<listcomp><sz)SpecifierSet.__init__.<locals>.<listcomp>�,)	r��set�addrtrrQ�	frozenset�_specsr1)rZ
specifiersrZparsed�	specifierrrrr49s
zSpecifierSet.__init__cCs*|jdk	rd�|j�nd}d�t|�|�S)Nr5r(z<SpecifierSet({0!r}{1})>)r1r-rr7r8rrrr9Ns
��zSpecifierSet.__repr__cCsd�tdd�|jD���S)Nr�css|]}t|�VqdSr:)r7r�rrr�	<genexpr>Xsz'SpecifierSet.__str__.<locals>.<genexpr>)r�sortedr�rrrrrWszSpecifierSet.__str__cCs
t|j�Sr:)r;r�rrrrrZszSpecifierSet.__hash__cCs�t|t�rt|�}nt|t�s"tSt�}t|j|jB�|_|jdkrX|jdk	rX|j|_n<|jdk	rv|jdkrv|j|_n|j|jkr�|j|_ntd��|S)NzFCannot combine SpecifierSets with True and False prerelease overrides.)r=rr�r>r�r�r1�
ValueError)rrr�rrr�__and__]s 





�zSpecifierSet.__and__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:�r=rr�r'r7r>r�rrrrrts



zSpecifierSet.__eq__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:r�rrrrr~s



zSpecifierSet.__ne__cCs
t|j�Sr:)r�r�rrrr�__len__�szSpecifierSet.__len__cCs
t|j�Sr:)�iterr�rrrr�__iter__�szSpecifierSet.__iter__cCs.|jdk	r|jS|jsdStdd�|jD��S)Ncss|]}|jVqdSr:�rr�rrrr��sz+SpecifierSet.prereleases.<locals>.<genexpr>)r1r��anyrrrrr�s

zSpecifierSet.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:rGrHrrrrI�szSpecifierSet.__contains__csLt�ttf�st����dkr$|j��s2�jr2dSt��fdd�|jD��S)NFc3s|]}|j��d�VqdS)r�NrGr��rrrrr��sz(SpecifierSet.contains.<locals>.<genexpr>)r=r	rr
rrK�allr�rrr�rr �s
zSpecifierSet.containscCs�|dkr|j}|jr6|jD]}|j|t|�d�}q|Sg}g}|D]P}t|ttf�s^t|�}n|}t|t�rnqB|jr�|s�|s�|�	|�qB|�	|�qB|s�|r�|dkr�|S|SdS)Nr�)
rr�r"�boolr=r	rr
rKrL)rr!rr2ZfilteredrMrrOrrrr"�s*



zSpecifierSet.filter)r(N)N)N)rr
rr4r9rrr�rrr�r�rPrr&rIr r"rrrrr�8s 
	




r�)Z
__future__rrrr#rqr�rjZ_compatrrr*rr	r
r�r�ABCMeta�objectrr'rQrsrtrkr�r�r�r�rrrr�<module>s&81

site-packages/pip/_vendor/packaging/__pycache__/version.cpython-38.opt-1.pyc000064400000027432151446176770022752 0ustar00U

��.e�.�	@s�ddlmZmZmZddlZddlZddlZddlmZddddd	gZ	e�
d
ddd
dddg�Zdd�ZGdd�de
�ZGdd�de�ZGdd�de�Ze�dej�Zdddddd�Zdd�Zdd�ZdZGd d�de�Zd!d"�Ze�d#�Zd$d%�Zd&d'�ZdS)(�)�absolute_import�division�print_functionN�)�Infinity�parse�Version�
LegacyVersion�InvalidVersion�VERSION_PATTERN�_Version�epoch�release�dev�pre�post�localcCs,z
t|�WStk
r&t|�YSXdS)z�
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    N)rr
r	)�version�r�A/usr/lib/python3.8/site-packages/pip/_vendor/packaging/version.pyrs
c@seZdZdZdS)r
zF
    An invalid version was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__rrrrr
!sc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)�_BaseVersioncCs
t|j�S�N)�hash�_key��selfrrr�__hash__(sz_BaseVersion.__hash__cCs|�|dd��S)NcSs||kSrr��s�orrr�<lambda>,�z%_BaseVersion.__lt__.<locals>.<lambda>��_compare�r�otherrrr�__lt__+sz_BaseVersion.__lt__cCs|�|dd��S)NcSs||kSrrr!rrrr$/r%z%_BaseVersion.__le__.<locals>.<lambda>r&r(rrr�__le__.sz_BaseVersion.__le__cCs|�|dd��S)NcSs||kSrrr!rrrr$2r%z%_BaseVersion.__eq__.<locals>.<lambda>r&r(rrr�__eq__1sz_BaseVersion.__eq__cCs|�|dd��S)NcSs||kSrrr!rrrr$5r%z%_BaseVersion.__ge__.<locals>.<lambda>r&r(rrr�__ge__4sz_BaseVersion.__ge__cCs|�|dd��S)NcSs||kSrrr!rrrr$8r%z%_BaseVersion.__gt__.<locals>.<lambda>r&r(rrr�__gt__7sz_BaseVersion.__gt__cCs|�|dd��S)NcSs||kSrrr!rrrr$;r%z%_BaseVersion.__ne__.<locals>.<lambda>r&r(rrr�__ne__:sz_BaseVersion.__ne__cCst|t�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr)�methodrrrr'=s
z_BaseVersion._compareN)rrrr r*r+r,r-r.r/r'rrrrr'src@s�eZdZdd�Zdd�Zdd�Zedd��Zed	d
��Zedd��Z	ed
d��Z
edd��Zedd��Zedd��Z
edd��Zedd��Zedd��Zedd��ZdS)r	cCst|�|_t|j�|_dSr)�str�_version�_legacy_cmpkeyr)rrrrr�__init__Es
zLegacyVersion.__init__cCs|jSr�r4rrrr�__str__IszLegacyVersion.__str__cCsd�tt|���S)Nz<LegacyVersion({0})>��format�reprr3rrrr�__repr__LszLegacyVersion.__repr__cCs|jSrr7rrrr�publicOszLegacyVersion.publiccCs|jSrr7rrrr�base_versionSszLegacyVersion.base_versioncCsdS)N���rrrrrr
WszLegacyVersion.epochcCsdSrrrrrrr[szLegacyVersion.releasecCsdSrrrrrrr_szLegacyVersion.precCsdSrrrrrrrcszLegacyVersion.postcCsdSrrrrrrrgszLegacyVersion.devcCsdSrrrrrrrkszLegacyVersion.localcCsdS�NFrrrrr�
is_prereleaseoszLegacyVersion.is_prereleasecCsdSr@rrrrr�is_postreleasesszLegacyVersion.is_postreleasecCsdSr@rrrrr�
is_devreleasewszLegacyVersion.is_devreleaseN)rrrr6r8r<�propertyr=r>r
rrrrrrArBrCrrrrr	Ds2









z(\d+ | [a-z]+ | \.| -)�czfinal-�@)r�preview�-�rcrccs\t�|�D]F}t�||�}|r
|dkr(q
|dd�dkrF|�d�Vq
d|Vq
dVdS)N�.r�
0123456789��*�*final)�_legacy_version_component_re�split�_legacy_version_replacement_map�get�zfill)r"�partrrr�_parse_version_parts�srUcCszd}g}t|���D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�}||fS)Nr?rMrNz*final-Z00000000)rU�lower�
startswith�pop�append�tuple)rr
�partsrTrrrr5�s


r5a�
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
c@s�eZdZe�dedejejB�Zdd�Z	dd�Z
dd�Zed	d
��Z
edd��Zed
d��Zedd��Zedd��Zedd��Zedd��Zedd��Zedd��Zedd��Zedd��ZdS) rz^\s*z\s*$c
Cs�|j�|�}|std�|���t|�d�r8t|�d��ndtdd�|�d��d�D��t	|�d�|�d	��t	|�d
�|�d�p�|�d��t	|�d
�|�d��t
|�d��d�|_t|jj
|jj|jj|jj|jj|jj�|_dS)NzInvalid version: '{0}'r
rcss|]}t|�VqdSr)�int��.0�irrr�	<genexpr>�sz#Version.__init__.<locals>.<genexpr>rrJZpre_lZpre_nZpost_lZpost_n1Zpost_n2Zdev_lZdev_nr�r
rrrrr)�_regex�searchr
r:r�groupr\rZrP�_parse_letter_version�_parse_local_versionr4�_cmpkeyr
rrrrrr)rr�matchrrrr6�s,���zVersion.__init__cCsd�tt|���S)Nz<Version({0})>r9rrrrr<�szVersion.__repr__cCs�g}|jdkr |�d�|j��|�d�dd�|jD���|jdk	rb|�d�dd�|jD���|jdk	r~|�d�|j��|jdk	r�|�d	�|j��|jdk	r�|�d
�|j��d�|�S)Nr�{0}!rJcss|]}t|�VqdSr�r3�r^�xrrrr`sz"Version.__str__.<locals>.<genexpr>�css|]}t|�VqdSrrjrkrrrr`sz.post{0}z.dev{0}z+{0})	r
rYr:�joinrrrrr�rr[rrrr8�s




zVersion.__str__cCs|jjSr)r4r
rrrrr
sz
Version.epochcCs|jjSr)r4rrrrrrszVersion.releasecCs|jjSr)r4rrrrrrszVersion.precCs|jjr|jjdSdS�Nr)r4rrrrrr szVersion.postcCs|jjr|jjdSdSrp)r4rrrrrr$szVersion.devcCs(|jjr d�dd�|jjD��SdSdS)NrJcss|]}t|�VqdSrrjrkrrrr`+sz Version.local.<locals>.<genexpr>)r4rrnrrrrr(sz
Version.localcCst|��dd�dS)N�+rr)r3rPrrrrr=/szVersion.publiccCsFg}|jdkr |�d�|j��|�d�dd�|jD���d�|�S)NrrirJcss|]}t|�VqdSrrjrkrrrr`<sz'Version.base_version.<locals>.<genexpr>rm)r
rYr:rnrrorrrr>3s

zVersion.base_versioncCs|jdk	p|jdk	Sr)rrrrrrrA@szVersion.is_prereleasecCs
|jdk	Sr)rrrrrrBDszVersion.is_postreleasecCs
|jdk	Sr)rrrrrrCHszVersion.is_devreleaseN)rrr�re�compiler�VERBOSE�
IGNORECASErbr6r<r8rDr
rrrrrr=r>rArBrCrrrrr�s4









cCsv|rZ|dkrd}|��}|dkr&d}n(|dkr4d}n|dkrBd}n|dkrNd	}|t|�fS|sr|rrd	}|t|�fSdS)
NrZalpha�aZbeta�b)rErrGrI)Zrev�rr)rVr\)ZletterZnumberrrrreMs rez[\._-]cCs$|dk	r tdd�t�|�D��SdS)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Ncss&|]}|��s|��nt|�VqdSr)�isdigitrVr\)r^rTrrrr`ts�z'_parse_local_version.<locals>.<genexpr>)rZ�_local_version_separatorsrP)rrrrrfos�rfcCs�tttt�dd�t|�����}|dkr@|dkr@|dk	r@t}n|dkrLt}|dkrZt}|dkrft}|dkrvt}ntdd�|D��}||||||fS)NcSs|dkS)Nrr)rlrrrr$�r%z_cmpkey.<locals>.<lambda>css*|]"}t|t�r|dfnt|fVqdS)rmN)r0r\rr]rrrr`�sz_cmpkey.<locals>.<genexpr>)rZ�reversed�list�	itertools�	dropwhilerrarrrrgzs�	rg)Z
__future__rrr�collectionsr}rrZ_structuresr�__all__�
namedtuplerr�
ValueErrorr
�objectrr	rsrtrOrQrUr5rrrerzrfrgrrrr�<module>s8�8�	 x
site-packages/pip/_vendor/packaging/__pycache__/_structures.cpython-38.pyc000064400000005301151446176770022677 0ustar00U

��.e��@sDddlmZmZmZGdd�de�Ze�ZGdd�de�Ze�ZdS)�)�absolute_import�division�print_functionc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)�InfinitycCsdS)Nr���selfrr�E/usr/lib/python3.8/site-packages/pip/_vendor/packaging/_structures.py�__repr__szInfinity.__repr__cCstt|��S�N��hash�reprrrrr	�__hash__szInfinity.__hash__cCsdS�NFr�r�otherrrr	�__lt__szInfinity.__lt__cCsdSrrrrrr	�__le__szInfinity.__le__cCst||j�Sr��
isinstance�	__class__rrrr	�__eq__szInfinity.__eq__cCst||j�Srrrrrr	�__ne__szInfinity.__ne__cCsdS�NTrrrrr	�__gt__szInfinity.__gt__cCsdSrrrrrr	�__ge__szInfinity.__ge__cCstSr)�NegativeInfinityrrrr	�__neg__ szInfinity.__neg__N��__name__�
__module__�__qualname__r
rrrrrrrrrrrr	rsrc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)rcCsdS)Nz	-Infinityrrrrr	r
(szNegativeInfinity.__repr__cCstt|��Srrrrrr	r+szNegativeInfinity.__hash__cCsdSrrrrrr	r.szNegativeInfinity.__lt__cCsdSrrrrrr	r1szNegativeInfinity.__le__cCst||j�Srrrrrr	r4szNegativeInfinity.__eq__cCst||j�Srrrrrr	r7szNegativeInfinity.__ne__cCsdSrrrrrr	r:szNegativeInfinity.__gt__cCsdSrrrrrr	r=szNegativeInfinity.__ge__cCstSr)rrrrr	r@szNegativeInfinity.__neg__Nrrrrr	r'srN)Z
__future__rrr�objectrrrrrr	�<module>ssite-packages/pip/_vendor/packaging/__pycache__/__init__.cpython-38.pyc000064400000001027151446176770022055 0ustar00U

��.e2�@sTddlmZmZmZddlmZmZmZmZm	Z	m
Z
mZmZdddddd	d
dgZ
dS)
�)�absolute_import�division�print_function�)�
__author__�
__copyright__�	__email__�__license__�__summary__�	__title__�__uri__�__version__rr
rr
rrr	rN)Z
__future__rrr�	__about__rrrr	r
rrr
�__all__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/packaging/__init__.py�<module>s(�site-packages/pip/_vendor/packaging/__init__.py000064400000001062151446176770015566 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

from .__about__ import (
    __author__,
    __copyright__,
    __email__,
    __license__,
    __summary__,
    __title__,
    __uri__,
    __version__,
)

__all__ = [
    "__title__",
    "__summary__",
    "__uri__",
    "__version__",
    "__author__",
    "__email__",
    "__license__",
    "__copyright__",
]
site-packages/pip/_vendor/packaging/markers.py000064400000020072151446176770015475 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import operator
import os
import platform
import sys

from pip._vendor.pyparsing import ParseException, ParseResults, stringStart, stringEnd
from pip._vendor.pyparsing import ZeroOrMore, Group, Forward, QuotedString
from pip._vendor.pyparsing import Literal as L  # noqa

from ._compat import string_types
from .specifiers import Specifier, InvalidSpecifier


__all__ = [
    "InvalidMarker",
    "UndefinedComparison",
    "UndefinedEnvironmentName",
    "Marker",
    "default_environment",
]


class InvalidMarker(ValueError):
    """
    An invalid marker was found, users should refer to PEP 508.
    """


class UndefinedComparison(ValueError):
    """
    An invalid operation was attempted on a value that doesn't support it.
    """


class UndefinedEnvironmentName(ValueError):
    """
    A name was attempted to be used that does not exist inside of the
    environment.
    """


class Node(object):
    def __init__(self, value):
        self.value = value

    def __str__(self):
        return str(self.value)

    def __repr__(self):
        return "<{0}({1!r})>".format(self.__class__.__name__, str(self))

    def serialize(self):
        raise NotImplementedError


class Variable(Node):
    def serialize(self):
        return str(self)


class Value(Node):
    def serialize(self):
        return '"{0}"'.format(self)


class Op(Node):
    def serialize(self):
        return str(self)


VARIABLE = (
    L("implementation_version")
    | L("platform_python_implementation")
    | L("implementation_name")
    | L("python_full_version")
    | L("platform_release")
    | L("platform_version")
    | L("platform_machine")
    | L("platform_system")
    | L("python_version")
    | L("sys_platform")
    | L("os_name")
    | L("os.name")
    | L("sys.platform")  # PEP-345
    | L("platform.version")  # PEP-345
    | L("platform.machine")  # PEP-345
    | L("platform.python_implementation")  # PEP-345
    | L("python_implementation")  # PEP-345
    | L("extra")  # undocumented setuptools legacy
)
ALIASES = {
    "os.name": "os_name",
    "sys.platform": "sys_platform",
    "platform.version": "platform_version",
    "platform.machine": "platform_machine",
    "platform.python_implementation": "platform_python_implementation",
    "python_implementation": "platform_python_implementation",
}
VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0])))

VERSION_CMP = (
    L("===") | L("==") | L(">=") | L("<=") | L("!=") | L("~=") | L(">") | L("<")
)

MARKER_OP = VERSION_CMP | L("not in") | L("in")
MARKER_OP.setParseAction(lambda s, l, t: Op(t[0]))

MARKER_VALUE = QuotedString("'") | QuotedString('"')
MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0]))

BOOLOP = L("and") | L("or")

MARKER_VAR = VARIABLE | MARKER_VALUE

MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR)
MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0]))

LPAREN = L("(").suppress()
RPAREN = L(")").suppress()

MARKER_EXPR = Forward()
MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN)
MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR)

MARKER = stringStart + MARKER_EXPR + stringEnd


def _coerce_parse_result(results):
    if isinstance(results, ParseResults):
        return [_coerce_parse_result(i) for i in results]
    else:
        return results


def _format_marker(marker, first=True):
    assert isinstance(marker, (list, tuple, string_types))

    # Sometimes we have a structure like [[...]] which is a single item list
    # where the single item is itself it's own list. In that case we want skip
    # the rest of this function so that we don't get extraneous () on the
    # outside.
    if (
        isinstance(marker, list)
        and len(marker) == 1
        and isinstance(marker[0], (list, tuple))
    ):
        return _format_marker(marker[0])

    if isinstance(marker, list):
        inner = (_format_marker(m, first=False) for m in marker)
        if first:
            return " ".join(inner)
        else:
            return "(" + " ".join(inner) + ")"
    elif isinstance(marker, tuple):
        return " ".join([m.serialize() for m in marker])
    else:
        return marker


_operators = {
    "in": lambda lhs, rhs: lhs in rhs,
    "not in": lambda lhs, rhs: lhs not in rhs,
    "<": operator.lt,
    "<=": operator.le,
    "==": operator.eq,
    "!=": operator.ne,
    ">=": operator.ge,
    ">": operator.gt,
}


def _eval_op(lhs, op, rhs):
    try:
        spec = Specifier("".join([op.serialize(), rhs]))
    except InvalidSpecifier:
        pass
    else:
        return spec.contains(lhs)

    oper = _operators.get(op.serialize())
    if oper is None:
        raise UndefinedComparison(
            "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs)
        )

    return oper(lhs, rhs)


_undefined = object()


def _get_env(environment, name):
    value = environment.get(name, _undefined)

    if value is _undefined:
        raise UndefinedEnvironmentName(
            "{0!r} does not exist in evaluation environment.".format(name)
        )

    return value


def _evaluate_markers(markers, environment):
    groups = [[]]

    for marker in markers:
        assert isinstance(marker, (list, tuple, string_types))

        if isinstance(marker, list):
            groups[-1].append(_evaluate_markers(marker, environment))
        elif isinstance(marker, tuple):
            lhs, op, rhs = marker

            if isinstance(lhs, Variable):
                lhs_value = _get_env(environment, lhs.value)
                rhs_value = rhs.value
            else:
                lhs_value = lhs.value
                rhs_value = _get_env(environment, rhs.value)

            groups[-1].append(_eval_op(lhs_value, op, rhs_value))
        else:
            assert marker in ["and", "or"]
            if marker == "or":
                groups.append([])

    return any(all(item) for item in groups)


def format_full_version(info):
    version = "{0.major}.{0.minor}.{0.micro}".format(info)
    kind = info.releaselevel
    if kind != "final":
        version += kind[0] + str(info.serial)
    return version


def default_environment():
    if hasattr(sys, "implementation"):
        iver = format_full_version(sys.implementation.version)
        implementation_name = sys.implementation.name
    else:
        iver = "0"
        implementation_name = ""

    return {
        "implementation_name": implementation_name,
        "implementation_version": iver,
        "os_name": os.name,
        "platform_machine": platform.machine(),
        "platform_release": platform.release(),
        "platform_system": platform.system(),
        "platform_version": platform.version(),
        "python_full_version": platform.python_version(),
        "platform_python_implementation": platform.python_implementation(),
        "python_version": ".".join(platform.python_version_tuple()[:2]),
        "sys_platform": sys.platform,
    }


class Marker(object):
    def __init__(self, marker):
        try:
            self._markers = _coerce_parse_result(MARKER.parseString(marker))
        except ParseException as e:
            err_str = "Invalid marker: {0!r}, parse error at {1!r}".format(
                marker, marker[e.loc : e.loc + 8]
            )
            raise InvalidMarker(err_str)

    def __str__(self):
        return _format_marker(self._markers)

    def __repr__(self):
        return "<Marker({0!r})>".format(str(self))

    def evaluate(self, environment=None):
        """Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        """
        current_environment = default_environment()
        if environment is not None:
            current_environment.update(environment)

        return _evaluate_markers(self._markers, current_environment)
site-packages/pip/_vendor/packaging/_structures.py000064400000002610151446176770016411 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function


class Infinity(object):
    def __repr__(self):
        return "Infinity"

    def __hash__(self):
        return hash(repr(self))

    def __lt__(self, other):
        return False

    def __le__(self, other):
        return False

    def __eq__(self, other):
        return isinstance(other, self.__class__)

    def __ne__(self, other):
        return not isinstance(other, self.__class__)

    def __gt__(self, other):
        return True

    def __ge__(self, other):
        return True

    def __neg__(self):
        return NegativeInfinity


Infinity = Infinity()


class NegativeInfinity(object):
    def __repr__(self):
        return "-Infinity"

    def __hash__(self):
        return hash(repr(self))

    def __lt__(self, other):
        return True

    def __le__(self, other):
        return True

    def __eq__(self, other):
        return isinstance(other, self.__class__)

    def __ne__(self, other):
        return not isinstance(other, self.__class__)

    def __gt__(self, other):
        return False

    def __ge__(self, other):
        return False

    def __neg__(self):
        return Infinity


NegativeInfinity = NegativeInfinity()
site-packages/pip/_vendor/packaging/tags.py000064400000031205151446176770014767 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.

from __future__ import absolute_import

import distutils.util

try:
    from importlib.machinery import EXTENSION_SUFFIXES
except ImportError:  # pragma: no cover
    import imp

    EXTENSION_SUFFIXES = [x[0] for x in imp.get_suffixes()]
    del imp
import platform
import re
import sys
import sysconfig
import warnings


INTERPRETER_SHORT_NAMES = {
    "python": "py",  # Generic.
    "cpython": "cp",
    "pypy": "pp",
    "ironpython": "ip",
    "jython": "jy",
}


_32_BIT_INTERPRETER = sys.maxsize <= 2 ** 32


class Tag(object):

    __slots__ = ["_interpreter", "_abi", "_platform"]

    def __init__(self, interpreter, abi, platform):
        self._interpreter = interpreter.lower()
        self._abi = abi.lower()
        self._platform = platform.lower()

    @property
    def interpreter(self):
        return self._interpreter

    @property
    def abi(self):
        return self._abi

    @property
    def platform(self):
        return self._platform

    def __eq__(self, other):
        return (
            (self.platform == other.platform)
            and (self.abi == other.abi)
            and (self.interpreter == other.interpreter)
        )

    def __hash__(self):
        return hash((self._interpreter, self._abi, self._platform))

    def __str__(self):
        return "{}-{}-{}".format(self._interpreter, self._abi, self._platform)

    def __repr__(self):
        return "<{self} @ {self_id}>".format(self=self, self_id=id(self))


def parse_tag(tag):
    tags = set()
    interpreters, abis, platforms = tag.split("-")
    for interpreter in interpreters.split("."):
        for abi in abis.split("."):
            for platform_ in platforms.split("."):
                tags.add(Tag(interpreter, abi, platform_))
    return frozenset(tags)


def _normalize_string(string):
    return string.replace(".", "_").replace("-", "_")


def _cpython_interpreter(py_version):
    # TODO: Is using py_version_nodot for interpreter version critical?
    return "cp{major}{minor}".format(major=py_version[0], minor=py_version[1])


def _cpython_abis(py_version):
    abis = []
    version = "{}{}".format(*py_version[:2])
    debug = pymalloc = ucs4 = ""
    with_debug = sysconfig.get_config_var("Py_DEBUG")
    has_refcount = hasattr(sys, "gettotalrefcount")
    # Windows doesn't set Py_DEBUG, so checking for support of debug-compiled
    # extension modules is the best option.
    # https://github.com/pypa/pip/issues/3383#issuecomment-173267692
    has_ext = "_d.pyd" in EXTENSION_SUFFIXES
    if with_debug or (with_debug is None and (has_refcount or has_ext)):
        debug = "d"
    if py_version < (3, 8):
        with_pymalloc = sysconfig.get_config_var("WITH_PYMALLOC")
        if with_pymalloc or with_pymalloc is None:
            pymalloc = "m"
        if py_version < (3, 3):
            unicode_size = sysconfig.get_config_var("Py_UNICODE_SIZE")
            if unicode_size == 4 or (
                unicode_size is None and sys.maxunicode == 0x10FFFF
            ):
                ucs4 = "u"
    elif debug:
        # Debug builds can also load "normal" extension modules.
        # We can also assume no UCS-4 or pymalloc requirement.
        abis.append("cp{version}".format(version=version))
    abis.insert(
        0,
        "cp{version}{debug}{pymalloc}{ucs4}".format(
            version=version, debug=debug, pymalloc=pymalloc, ucs4=ucs4
        ),
    )
    return abis


def _cpython_tags(py_version, interpreter, abis, platforms):
    for abi in abis:
        for platform_ in platforms:
            yield Tag(interpreter, abi, platform_)
    for tag in (Tag(interpreter, "abi3", platform_) for platform_ in platforms):
        yield tag
    for tag in (Tag(interpreter, "none", platform_) for platform_ in platforms):
        yield tag
    # PEP 384 was first implemented in Python 3.2.
    for minor_version in range(py_version[1] - 1, 1, -1):
        for platform_ in platforms:
            interpreter = "cp{major}{minor}".format(
                major=py_version[0], minor=minor_version
            )
            yield Tag(interpreter, "abi3", platform_)


def _pypy_interpreter():
    return "pp{py_major}{pypy_major}{pypy_minor}".format(
        py_major=sys.version_info[0],
        pypy_major=sys.pypy_version_info.major,
        pypy_minor=sys.pypy_version_info.minor,
    )


def _generic_abi():
    abi = sysconfig.get_config_var("SOABI")
    if abi:
        return _normalize_string(abi)
    else:
        return "none"


def _pypy_tags(py_version, interpreter, abi, platforms):
    for tag in (Tag(interpreter, abi, platform) for platform in platforms):
        yield tag
    for tag in (Tag(interpreter, "none", platform) for platform in platforms):
        yield tag


def _generic_tags(interpreter, py_version, abi, platforms):
    for tag in (Tag(interpreter, abi, platform) for platform in platforms):
        yield tag
    if abi != "none":
        tags = (Tag(interpreter, "none", platform_) for platform_ in platforms)
        for tag in tags:
            yield tag


def _py_interpreter_range(py_version):
    """
    Yield Python versions in descending order.

    After the latest version, the major-only version will be yielded, and then
    all following versions up to 'end'.
    """
    yield "py{major}{minor}".format(major=py_version[0], minor=py_version[1])
    yield "py{major}".format(major=py_version[0])
    for minor in range(py_version[1] - 1, -1, -1):
        yield "py{major}{minor}".format(major=py_version[0], minor=minor)


def _independent_tags(interpreter, py_version, platforms):
    """
    Return the sequence of tags that are consistent across implementations.

    The tags consist of:
    - py*-none-<platform>
    - <interpreter>-none-any
    - py*-none-any
    """
    for version in _py_interpreter_range(py_version):
        for platform_ in platforms:
            yield Tag(version, "none", platform_)
    yield Tag(interpreter, "none", "any")
    for version in _py_interpreter_range(py_version):
        yield Tag(version, "none", "any")


def _mac_arch(arch, is_32bit=_32_BIT_INTERPRETER):
    if not is_32bit:
        return arch

    if arch.startswith("ppc"):
        return "ppc"

    return "i386"


def _mac_binary_formats(version, cpu_arch):
    formats = [cpu_arch]
    if cpu_arch == "x86_64":
        if version < (10, 4):
            return []
        formats.extend(["intel", "fat64", "fat32"])

    elif cpu_arch == "i386":
        if version < (10, 4):
            return []
        formats.extend(["intel", "fat32", "fat"])

    elif cpu_arch == "ppc64":
        # TODO: Need to care about 32-bit PPC for ppc64 through 10.2?
        if version > (10, 5) or version < (10, 4):
            return []
        formats.append("fat64")

    elif cpu_arch == "ppc":
        if version > (10, 6):
            return []
        formats.extend(["fat32", "fat"])

    formats.append("universal")
    return formats


def _mac_platforms(version=None, arch=None):
    version_str, _, cpu_arch = platform.mac_ver()
    if version is None:
        version = tuple(map(int, version_str.split(".")[:2]))
    if arch is None:
        arch = _mac_arch(cpu_arch)
    platforms = []
    for minor_version in range(version[1], -1, -1):
        compat_version = version[0], minor_version
        binary_formats = _mac_binary_formats(compat_version, arch)
        for binary_format in binary_formats:
            platforms.append(
                "macosx_{major}_{minor}_{binary_format}".format(
                    major=compat_version[0],
                    minor=compat_version[1],
                    binary_format=binary_format,
                )
            )
    return platforms


# From PEP 513.
def _is_manylinux_compatible(name, glibc_version):
    # Check for presence of _manylinux module.
    try:
        import _manylinux

        return bool(getattr(_manylinux, name + "_compatible"))
    except (ImportError, AttributeError):
        # Fall through to heuristic check below.
        pass

    return _have_compatible_glibc(*glibc_version)


def _glibc_version_string():
    # Returns glibc version string, or None if not using glibc.
    import ctypes

    # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen
    # manpage says, "If filename is NULL, then the returned handle is for the
    # main program". This way we can let the linker do the work to figure out
    # which libc our process is actually using.
    process_namespace = ctypes.CDLL(None)
    try:
        gnu_get_libc_version = process_namespace.gnu_get_libc_version
    except AttributeError:
        # Symbol doesn't exist -> therefore, we are not linked to
        # glibc.
        return None

    # Call gnu_get_libc_version, which returns a string like "2.5"
    gnu_get_libc_version.restype = ctypes.c_char_p
    version_str = gnu_get_libc_version()
    # py2 / py3 compatibility:
    if not isinstance(version_str, str):
        version_str = version_str.decode("ascii")

    return version_str


# Separated out from have_compatible_glibc for easier unit testing.
def _check_glibc_version(version_str, required_major, minimum_minor):
    # Parse string and check against requested version.
    #
    # We use a regexp instead of str.split because we want to discard any
    # random junk that might come after the minor version -- this might happen
    # in patched/forked versions of glibc (e.g. Linaro's version of glibc
    # uses version strings like "2.20-2014.11"). See gh-3588.
    m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str)
    if not m:
        warnings.warn(
            "Expected glibc version with 2 components major.minor,"
            " got: %s" % version_str,
            RuntimeWarning,
        )
        return False
    return (
        int(m.group("major")) == required_major
        and int(m.group("minor")) >= minimum_minor
    )


def _have_compatible_glibc(required_major, minimum_minor):
    version_str = _glibc_version_string()
    if version_str is None:
        return False
    return _check_glibc_version(version_str, required_major, minimum_minor)


def _linux_platforms(is_32bit=_32_BIT_INTERPRETER):
    linux = _normalize_string(distutils.util.get_platform())
    if linux == "linux_x86_64" and is_32bit:
        linux = "linux_i686"
    manylinux_support = (
        ("manylinux2014", (2, 17)),  # CentOS 7 w/ glibc 2.17 (PEP 599)
        ("manylinux2010", (2, 12)),  # CentOS 6 w/ glibc 2.12 (PEP 571)
        ("manylinux1", (2, 5)),  # CentOS 5 w/ glibc 2.5 (PEP 513)
    )
    manylinux_support_iter = iter(manylinux_support)
    for name, glibc_version in manylinux_support_iter:
        if _is_manylinux_compatible(name, glibc_version):
            platforms = [linux.replace("linux", name)]
            break
    else:
        platforms = []
    # Support for a later manylinux implies support for an earlier version.
    platforms += [linux.replace("linux", name) for name, _ in manylinux_support_iter]
    platforms.append(linux)
    return platforms


def _generic_platforms():
    platform = _normalize_string(distutils.util.get_platform())
    return [platform]


def _interpreter_name():
    name = platform.python_implementation().lower()
    return INTERPRETER_SHORT_NAMES.get(name) or name


def _generic_interpreter(name, py_version):
    version = sysconfig.get_config_var("py_version_nodot")
    if not version:
        version = "".join(map(str, py_version[:2]))
    return "{name}{version}".format(name=name, version=version)


def sys_tags():
    """
    Returns the sequence of tag triples for the running interpreter.

    The order of the sequence corresponds to priority order for the
    interpreter, from most to least important.
    """
    py_version = sys.version_info[:2]
    interpreter_name = _interpreter_name()
    if platform.system() == "Darwin":
        platforms = _mac_platforms()
    elif platform.system() == "Linux":
        platforms = _linux_platforms()
    else:
        platforms = _generic_platforms()

    if interpreter_name == "cp":
        interpreter = _cpython_interpreter(py_version)
        abis = _cpython_abis(py_version)
        for tag in _cpython_tags(py_version, interpreter, abis, platforms):
            yield tag
    elif interpreter_name == "pp":
        interpreter = _pypy_interpreter()
        abi = _generic_abi()
        for tag in _pypy_tags(py_version, interpreter, abi, platforms):
            yield tag
    else:
        interpreter = _generic_interpreter(interpreter_name, py_version)
        abi = _generic_abi()
        for tag in _generic_tags(interpreter, py_version, abi, platforms):
            yield tag
    for tag in _independent_tags(interpreter, py_version, platforms):
        yield tag
site-packages/pip/_vendor/packaging/requirements.py000064400000011134151446176770016553 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import string
import re

from pip._vendor.pyparsing import stringStart, stringEnd, originalTextFor, ParseException
from pip._vendor.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine
from pip._vendor.pyparsing import Literal as L  # noqa
from pip._vendor.six.moves.urllib import parse as urlparse

from .markers import MARKER_EXPR, Marker
from .specifiers import LegacySpecifier, Specifier, SpecifierSet


class InvalidRequirement(ValueError):
    """
    An invalid requirement was found, users should refer to PEP 508.
    """


ALPHANUM = Word(string.ascii_letters + string.digits)

LBRACKET = L("[").suppress()
RBRACKET = L("]").suppress()
LPAREN = L("(").suppress()
RPAREN = L(")").suppress()
COMMA = L(",").suppress()
SEMICOLON = L(";").suppress()
AT = L("@").suppress()

PUNCTUATION = Word("-_.")
IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))

NAME = IDENTIFIER("name")
EXTRA = IDENTIFIER

URI = Regex(r"[^ ]+")("url")
URL = AT + URI

EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")

VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)

VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
VERSION_MANY = Combine(
    VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE), joinString=",", adjacent=False
)("_raw_spec")
_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY))
_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or "")

VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
VERSION_SPEC.setParseAction(lambda s, l, t: t[1])

MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
MARKER_EXPR.setParseAction(
    lambda s, l, t: Marker(s[t._original_start : t._original_end])
)
MARKER_SEPARATOR = SEMICOLON
MARKER = MARKER_SEPARATOR + MARKER_EXPR

VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
URL_AND_MARKER = URL + Optional(MARKER)

NAMED_REQUIREMENT = NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)

REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd
# pyparsing isn't thread safe during initialization, so we do it eagerly, see
# issue #104
REQUIREMENT.parseString("x[]")


class Requirement(object):
    """Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    """

    # TODO: Can we test whether something is contained within a requirement?
    #       If so how do we do that? Do we need to test against the _name_ of
    #       the thing as well as the version? What about the markers?
    # TODO: Can we normalize the name and extra name?

    def __init__(self, requirement_string):
        try:
            req = REQUIREMENT.parseString(requirement_string)
        except ParseException as e:
            raise InvalidRequirement(
                'Parse error at "{0!r}": {1}'.format(
                    requirement_string[e.loc : e.loc + 8], e.msg
                )
            )

        self.name = req.name
        if req.url:
            parsed_url = urlparse.urlparse(req.url)
            if parsed_url.scheme == "file":
                if urlparse.urlunparse(parsed_url) != req.url:
                    raise InvalidRequirement("Invalid URL given")
            elif not (parsed_url.scheme and parsed_url.netloc) or (
                not parsed_url.scheme and not parsed_url.netloc
            ):
                raise InvalidRequirement("Invalid URL: {0}".format(req.url))
            self.url = req.url
        else:
            self.url = None
        self.extras = set(req.extras.asList() if req.extras else [])
        self.specifier = SpecifierSet(req.specifier)
        self.marker = req.marker if req.marker else None

    def __str__(self):
        parts = [self.name]

        if self.extras:
            parts.append("[{0}]".format(",".join(sorted(self.extras))))

        if self.specifier:
            parts.append(str(self.specifier))

        if self.url:
            parts.append("@ {0}".format(self.url))
            if self.marker:
                parts.append(" ")

        if self.marker:
            parts.append("; {0}".format(self.marker))

        return "".join(parts)

    def __repr__(self):
        return "<Requirement({0!r})>".format(str(self))
site-packages/pip/_vendor/requests/__version__.py000064400000000664151446176770016246 0ustar00# .-. .-. .-. . . .-. .-. .-. .-.
# |(  |-  |.| | | |-  `-.  |  `-.
# ' ' `-' `-`.`-' `-' `-'  '  `-'

__title__ = 'requests'
__description__ = 'Python HTTP for Humans.'
__url__ = 'http://python-requests.org'
__version__ = '2.22.0'
__build__ = 0x022200
__author__ = 'Kenneth Reitz'
__author_email__ = 'me@kennethreitz.org'
__license__ = 'Apache 2.0'
__copyright__ = 'Copyright 2019 Kenneth Reitz'
__cake__ = u'\u2728 \U0001f370 \u2728'
site-packages/pip/_vendor/requests/auth.py000064400000023736151446176770014733 0ustar00# -*- coding: utf-8 -*-

"""
requests.auth
~~~~~~~~~~~~~

This module contains the authentication handlers for Requests.
"""

import os
import re
import time
import hashlib
import threading
import warnings

from base64 import b64encode

from .compat import urlparse, str, basestring
from .cookies import extract_cookies_to_jar
from ._internal_utils import to_native_string
from .utils import parse_dict_header

CONTENT_TYPE_FORM_URLENCODED = 'application/x-www-form-urlencoded'
CONTENT_TYPE_MULTI_PART = 'multipart/form-data'


def _basic_auth_str(username, password):
    """Returns a Basic Auth string."""

    # "I want us to put a big-ol' comment on top of it that
    # says that this behaviour is dumb but we need to preserve
    # it because people are relying on it."
    #    - Lukasa
    #
    # These are here solely to maintain backwards compatibility
    # for things like ints. This will be removed in 3.0.0.
    if not isinstance(username, basestring):
        warnings.warn(
            "Non-string usernames will no longer be supported in Requests "
            "3.0.0. Please convert the object you've passed in ({!r}) to "
            "a string or bytes object in the near future to avoid "
            "problems.".format(username),
            category=DeprecationWarning,
        )
        username = str(username)

    if not isinstance(password, basestring):
        warnings.warn(
            "Non-string passwords will no longer be supported in Requests "
            "3.0.0. Please convert the object you've passed in ({!r}) to "
            "a string or bytes object in the near future to avoid "
            "problems.".format(password),
            category=DeprecationWarning,
        )
        password = str(password)
    # -- End Removal --

    if isinstance(username, str):
        username = username.encode('latin1')

    if isinstance(password, str):
        password = password.encode('latin1')

    authstr = 'Basic ' + to_native_string(
        b64encode(b':'.join((username, password))).strip()
    )

    return authstr


class AuthBase(object):
    """Base class that all auth implementations derive from"""

    def __call__(self, r):
        raise NotImplementedError('Auth hooks must be callable.')


class HTTPBasicAuth(AuthBase):
    """Attaches HTTP Basic Authentication to the given Request object."""

    def __init__(self, username, password):
        self.username = username
        self.password = password

    def __eq__(self, other):
        return all([
            self.username == getattr(other, 'username', None),
            self.password == getattr(other, 'password', None)
        ])

    def __ne__(self, other):
        return not self == other

    def __call__(self, r):
        r.headers['Authorization'] = _basic_auth_str(self.username, self.password)
        return r


class HTTPProxyAuth(HTTPBasicAuth):
    """Attaches HTTP Proxy Authentication to a given Request object."""

    def __call__(self, r):
        r.headers['Proxy-Authorization'] = _basic_auth_str(self.username, self.password)
        return r


class HTTPDigestAuth(AuthBase):
    """Attaches HTTP Digest Authentication to the given Request object."""

    def __init__(self, username, password):
        self.username = username
        self.password = password
        # Keep state in per-thread local storage
        self._thread_local = threading.local()

    def init_per_thread_state(self):
        # Ensure state is initialized just once per-thread
        if not hasattr(self._thread_local, 'init'):
            self._thread_local.init = True
            self._thread_local.last_nonce = ''
            self._thread_local.nonce_count = 0
            self._thread_local.chal = {}
            self._thread_local.pos = None
            self._thread_local.num_401_calls = None

    def build_digest_header(self, method, url):
        """
        :rtype: str
        """

        realm = self._thread_local.chal['realm']
        nonce = self._thread_local.chal['nonce']
        qop = self._thread_local.chal.get('qop')
        algorithm = self._thread_local.chal.get('algorithm')
        opaque = self._thread_local.chal.get('opaque')
        hash_utf8 = None

        if algorithm is None:
            _algorithm = 'MD5'
        else:
            _algorithm = algorithm.upper()
        # lambdas assume digest modules are imported at the top level
        if _algorithm == 'MD5' or _algorithm == 'MD5-SESS':
            def md5_utf8(x):
                if isinstance(x, str):
                    x = x.encode('utf-8')
                return hashlib.md5(x).hexdigest()
            hash_utf8 = md5_utf8
        elif _algorithm == 'SHA':
            def sha_utf8(x):
                if isinstance(x, str):
                    x = x.encode('utf-8')
                return hashlib.sha1(x).hexdigest()
            hash_utf8 = sha_utf8
        elif _algorithm == 'SHA-256':
            def sha256_utf8(x):
                if isinstance(x, str):
                    x = x.encode('utf-8')
                return hashlib.sha256(x).hexdigest()
            hash_utf8 = sha256_utf8
        elif _algorithm == 'SHA-512':
            def sha512_utf8(x):
                if isinstance(x, str):
                    x = x.encode('utf-8')
                return hashlib.sha512(x).hexdigest()
            hash_utf8 = sha512_utf8

        KD = lambda s, d: hash_utf8("%s:%s" % (s, d))

        if hash_utf8 is None:
            return None

        # XXX not implemented yet
        entdig = None
        p_parsed = urlparse(url)
        #: path is request-uri defined in RFC 2616 which should not be empty
        path = p_parsed.path or "/"
        if p_parsed.query:
            path += '?' + p_parsed.query

        A1 = '%s:%s:%s' % (self.username, realm, self.password)
        A2 = '%s:%s' % (method, path)

        HA1 = hash_utf8(A1)
        HA2 = hash_utf8(A2)

        if nonce == self._thread_local.last_nonce:
            self._thread_local.nonce_count += 1
        else:
            self._thread_local.nonce_count = 1
        ncvalue = '%08x' % self._thread_local.nonce_count
        s = str(self._thread_local.nonce_count).encode('utf-8')
        s += nonce.encode('utf-8')
        s += time.ctime().encode('utf-8')
        s += os.urandom(8)

        cnonce = (hashlib.sha1(s).hexdigest()[:16])
        if _algorithm == 'MD5-SESS':
            HA1 = hash_utf8('%s:%s:%s' % (HA1, nonce, cnonce))

        if not qop:
            respdig = KD(HA1, "%s:%s" % (nonce, HA2))
        elif qop == 'auth' or 'auth' in qop.split(','):
            noncebit = "%s:%s:%s:%s:%s" % (
                nonce, ncvalue, cnonce, 'auth', HA2
            )
            respdig = KD(HA1, noncebit)
        else:
            # XXX handle auth-int.
            return None

        self._thread_local.last_nonce = nonce

        # XXX should the partial digests be encoded too?
        base = 'username="%s", realm="%s", nonce="%s", uri="%s", ' \
               'response="%s"' % (self.username, realm, nonce, path, respdig)
        if opaque:
            base += ', opaque="%s"' % opaque
        if algorithm:
            base += ', algorithm="%s"' % algorithm
        if entdig:
            base += ', digest="%s"' % entdig
        if qop:
            base += ', qop="auth", nc=%s, cnonce="%s"' % (ncvalue, cnonce)

        return 'Digest %s' % (base)

    def handle_redirect(self, r, **kwargs):
        """Reset num_401_calls counter on redirects."""
        if r.is_redirect:
            self._thread_local.num_401_calls = 1

    def handle_401(self, r, **kwargs):
        """
        Takes the given response and tries digest-auth, if needed.

        :rtype: requests.Response
        """

        # If response is not 4xx, do not auth
        # See https://github.com/requests/requests/issues/3772
        if not 400 <= r.status_code < 500:
            self._thread_local.num_401_calls = 1
            return r

        if self._thread_local.pos is not None:
            # Rewind the file position indicator of the body to where
            # it was to resend the request.
            r.request.body.seek(self._thread_local.pos)
        s_auth = r.headers.get('www-authenticate', '')

        if 'digest' in s_auth.lower() and self._thread_local.num_401_calls < 2:

            self._thread_local.num_401_calls += 1
            pat = re.compile(r'digest ', flags=re.IGNORECASE)
            self._thread_local.chal = parse_dict_header(pat.sub('', s_auth, count=1))

            # Consume content and release the original connection
            # to allow our new request to reuse the same one.
            r.content
            r.close()
            prep = r.request.copy()
            extract_cookies_to_jar(prep._cookies, r.request, r.raw)
            prep.prepare_cookies(prep._cookies)

            prep.headers['Authorization'] = self.build_digest_header(
                prep.method, prep.url)
            _r = r.connection.send(prep, **kwargs)
            _r.history.append(r)
            _r.request = prep

            return _r

        self._thread_local.num_401_calls = 1
        return r

    def __call__(self, r):
        # Initialize per-thread state, if needed
        self.init_per_thread_state()
        # If we have a saved nonce, skip the 401
        if self._thread_local.last_nonce:
            r.headers['Authorization'] = self.build_digest_header(r.method, r.url)
        try:
            self._thread_local.pos = r.body.tell()
        except AttributeError:
            # In the case of HTTPDigestAuth being reused and the body of
            # the previous request was a file-like object, pos has the
            # file position of the previous body. Ensure it's set to
            # None.
            self._thread_local.pos = None
        r.register_hook('response', self.handle_401)
        r.register_hook('response', self.handle_redirect)
        self._thread_local.num_401_calls = 1

        return r

    def __eq__(self, other):
        return all([
            self.username == getattr(other, 'username', None),
            self.password == getattr(other, 'password', None)
        ])

    def __ne__(self, other):
        return not self == other
site-packages/pip/_vendor/requests/help.py000064400000006772151446176770014723 0ustar00"""Module containing bug report helper(s)."""
from __future__ import print_function

import json
import platform
import sys
import ssl

from pip._vendor import idna
from pip._vendor import urllib3
from pip._vendor import chardet

from . import __version__ as requests_version

try:
    from pip._vendor.urllib3.contrib import pyopenssl
except ImportError:
    pyopenssl = None
    OpenSSL = None
    cryptography = None
else:
    import OpenSSL
    import cryptography


def _implementation():
    """Return a dict with the Python implementation and version.

    Provide both the name and the version of the Python implementation
    currently running. For example, on CPython 2.7.5 it will return
    {'name': 'CPython', 'version': '2.7.5'}.

    This function works best on CPython and PyPy: in particular, it probably
    doesn't work for Jython or IronPython. Future investigation should be done
    to work out the correct shape of the code for those platforms.
    """
    implementation = platform.python_implementation()

    if implementation == 'CPython':
        implementation_version = platform.python_version()
    elif implementation == 'PyPy':
        implementation_version = '%s.%s.%s' % (sys.pypy_version_info.major,
                                               sys.pypy_version_info.minor,
                                               sys.pypy_version_info.micro)
        if sys.pypy_version_info.releaselevel != 'final':
            implementation_version = ''.join([
                implementation_version, sys.pypy_version_info.releaselevel
            ])
    elif implementation == 'Jython':
        implementation_version = platform.python_version()  # Complete Guess
    elif implementation == 'IronPython':
        implementation_version = platform.python_version()  # Complete Guess
    else:
        implementation_version = 'Unknown'

    return {'name': implementation, 'version': implementation_version}


def info():
    """Generate information for a bug report."""
    try:
        platform_info = {
            'system': platform.system(),
            'release': platform.release(),
        }
    except IOError:
        platform_info = {
            'system': 'Unknown',
            'release': 'Unknown',
        }

    implementation_info = _implementation()
    urllib3_info = {'version': urllib3.__version__}
    chardet_info = {'version': chardet.__version__}

    pyopenssl_info = {
        'version': None,
        'openssl_version': '',
    }
    if OpenSSL:
        pyopenssl_info = {
            'version': OpenSSL.__version__,
            'openssl_version': '%x' % OpenSSL.SSL.OPENSSL_VERSION_NUMBER,
        }
    cryptography_info = {
        'version': getattr(cryptography, '__version__', ''),
    }
    idna_info = {
        'version': getattr(idna, '__version__', ''),
    }

    system_ssl = ssl.OPENSSL_VERSION_NUMBER
    system_ssl_info = {
        'version': '%x' % system_ssl if system_ssl is not None else ''
    }

    return {
        'platform': platform_info,
        'implementation': implementation_info,
        'system_ssl': system_ssl_info,
        'using_pyopenssl': pyopenssl is not None,
        'pyOpenSSL': pyopenssl_info,
        'urllib3': urllib3_info,
        'chardet': chardet_info,
        'cryptography': cryptography_info,
        'idna': idna_info,
        'requests': {
            'version': requests_version,
        },
    }


def main():
    """Pretty-print the bug information as JSON."""
    print(json.dumps(info(), sort_keys=True, indent=2))


if __name__ == '__main__':
    main()
site-packages/pip/_vendor/requests/structures.py000064400000005645151446176770016214 0ustar00# -*- coding: utf-8 -*-

"""
requests.structures
~~~~~~~~~~~~~~~~~~~

Data structures that power Requests.
"""

from .compat import OrderedDict, Mapping, MutableMapping


class CaseInsensitiveDict(MutableMapping):
    """A case-insensitive ``dict``-like object.

    Implements all methods and operations of
    ``MutableMapping`` as well as dict's ``copy``. Also
    provides ``lower_items``.

    All keys are expected to be strings. The structure remembers the
    case of the last key to be set, and ``iter(instance)``,
    ``keys()``, ``items()``, ``iterkeys()``, and ``iteritems()``
    will contain case-sensitive keys. However, querying and contains
    testing is case insensitive::

        cid = CaseInsensitiveDict()
        cid['Accept'] = 'application/json'
        cid['aCCEPT'] == 'application/json'  # True
        list(cid) == ['Accept']  # True

    For example, ``headers['content-encoding']`` will return the
    value of a ``'Content-Encoding'`` response header, regardless
    of how the header name was originally stored.

    If the constructor, ``.update``, or equality comparison
    operations are given keys that have equal ``.lower()``s, the
    behavior is undefined.
    """

    def __init__(self, data=None, **kwargs):
        self._store = OrderedDict()
        if data is None:
            data = {}
        self.update(data, **kwargs)

    def __setitem__(self, key, value):
        # Use the lowercased key for lookups, but store the actual
        # key alongside the value.
        self._store[key.lower()] = (key, value)

    def __getitem__(self, key):
        return self._store[key.lower()][1]

    def __delitem__(self, key):
        del self._store[key.lower()]

    def __iter__(self):
        return (casedkey for casedkey, mappedvalue in self._store.values())

    def __len__(self):
        return len(self._store)

    def lower_items(self):
        """Like iteritems(), but with all lowercase keys."""
        return (
            (lowerkey, keyval[1])
            for (lowerkey, keyval)
            in self._store.items()
        )

    def __eq__(self, other):
        if isinstance(other, Mapping):
            other = CaseInsensitiveDict(other)
        else:
            return NotImplemented
        # Compare insensitively
        return dict(self.lower_items()) == dict(other.lower_items())

    # Copy is required
    def copy(self):
        return CaseInsensitiveDict(self._store.values())

    def __repr__(self):
        return str(dict(self.items()))


class LookupDict(dict):
    """Dictionary lookup object."""

    def __init__(self, name=None):
        self.name = name
        super(LookupDict, self).__init__()

    def __repr__(self):
        return '<lookup \'%s\'>' % (self.name)

    def __getitem__(self, key):
        # We allow fall-through here, so values default to None

        return self.__dict__.get(key, None)

    def get(self, key, default=None):
        return self.__dict__.get(key, default)
site-packages/pip/_vendor/requests/cookies.py000064400000043776151446176770015434 0ustar00# -*- coding: utf-8 -*-

"""
requests.cookies
~~~~~~~~~~~~~~~~

Compatibility code to be able to use `cookielib.CookieJar` with requests.

requests.utils imports from here, so be careful with imports.
"""

import copy
import time
import calendar

from ._internal_utils import to_native_string
from .compat import cookielib, urlparse, urlunparse, Morsel, MutableMapping

try:
    import threading
except ImportError:
    import dummy_threading as threading


class MockRequest(object):
    """Wraps a `requests.Request` to mimic a `urllib2.Request`.

    The code in `cookielib.CookieJar` expects this interface in order to correctly
    manage cookie policies, i.e., determine whether a cookie can be set, given the
    domains of the request and the cookie.

    The original request object is read-only. The client is responsible for collecting
    the new headers via `get_new_headers()` and interpreting them appropriately. You
    probably want `get_cookie_header`, defined below.
    """

    def __init__(self, request):
        self._r = request
        self._new_headers = {}
        self.type = urlparse(self._r.url).scheme

    def get_type(self):
        return self.type

    def get_host(self):
        return urlparse(self._r.url).netloc

    def get_origin_req_host(self):
        return self.get_host()

    def get_full_url(self):
        # Only return the response's URL if the user hadn't set the Host
        # header
        if not self._r.headers.get('Host'):
            return self._r.url
        # If they did set it, retrieve it and reconstruct the expected domain
        host = to_native_string(self._r.headers['Host'], encoding='utf-8')
        parsed = urlparse(self._r.url)
        # Reconstruct the URL as we expect it
        return urlunparse([
            parsed.scheme, host, parsed.path, parsed.params, parsed.query,
            parsed.fragment
        ])

    def is_unverifiable(self):
        return True

    def has_header(self, name):
        return name in self._r.headers or name in self._new_headers

    def get_header(self, name, default=None):
        return self._r.headers.get(name, self._new_headers.get(name, default))

    def add_header(self, key, val):
        """cookielib has no legitimate use for this method; add it back if you find one."""
        raise NotImplementedError("Cookie headers should be added with add_unredirected_header()")

    def add_unredirected_header(self, name, value):
        self._new_headers[name] = value

    def get_new_headers(self):
        return self._new_headers

    @property
    def unverifiable(self):
        return self.is_unverifiable()

    @property
    def origin_req_host(self):
        return self.get_origin_req_host()

    @property
    def host(self):
        return self.get_host()


class MockResponse(object):
    """Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.

    ...what? Basically, expose the parsed HTTP headers from the server response
    the way `cookielib` expects to see them.
    """

    def __init__(self, headers):
        """Make a MockResponse for `cookielib` to read.

        :param headers: a httplib.HTTPMessage or analogous carrying the headers
        """
        self._headers = headers

    def info(self):
        return self._headers

    def getheaders(self, name):
        self._headers.getheaders(name)


def extract_cookies_to_jar(jar, request, response):
    """Extract the cookies from the response into a CookieJar.

    :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar)
    :param request: our own requests.Request object
    :param response: urllib3.HTTPResponse object
    """
    if not (hasattr(response, '_original_response') and
            response._original_response):
        return
    # the _original_response field is the wrapped httplib.HTTPResponse object,
    req = MockRequest(request)
    # pull out the HTTPMessage with the headers and put it in the mock:
    res = MockResponse(response._original_response.msg)
    jar.extract_cookies(res, req)


def get_cookie_header(jar, request):
    """
    Produce an appropriate Cookie header string to be sent with `request`, or None.

    :rtype: str
    """
    r = MockRequest(request)
    jar.add_cookie_header(r)
    return r.get_new_headers().get('Cookie')


def remove_cookie_by_name(cookiejar, name, domain=None, path=None):
    """Unsets a cookie by name, by default over all domains and paths.

    Wraps CookieJar.clear(), is O(n).
    """
    clearables = []
    for cookie in cookiejar:
        if cookie.name != name:
            continue
        if domain is not None and domain != cookie.domain:
            continue
        if path is not None and path != cookie.path:
            continue
        clearables.append((cookie.domain, cookie.path, cookie.name))

    for domain, path, name in clearables:
        cookiejar.clear(domain, path, name)


class CookieConflictError(RuntimeError):
    """There are two cookies that meet the criteria specified in the cookie jar.
    Use .get and .set and include domain and path args in order to be more specific.
    """


class RequestsCookieJar(cookielib.CookieJar, MutableMapping):
    """Compatibility class; is a cookielib.CookieJar, but exposes a dict
    interface.

    This is the CookieJar we create by default for requests and sessions that
    don't specify one, since some clients may expect response.cookies and
    session.cookies to support dict operations.

    Requests does not use the dict interface internally; it's just for
    compatibility with external client code. All requests code should work
    out of the box with externally provided instances of ``CookieJar``, e.g.
    ``LWPCookieJar`` and ``FileCookieJar``.

    Unlike a regular CookieJar, this class is pickleable.

    .. warning:: dictionary operations that are normally O(1) may be O(n).
    """

    def get(self, name, default=None, domain=None, path=None):
        """Dict-like get() that also supports optional domain and path args in
        order to resolve naming collisions from using one cookie jar over
        multiple domains.

        .. warning:: operation is O(n), not O(1).
        """
        try:
            return self._find_no_duplicates(name, domain, path)
        except KeyError:
            return default

    def set(self, name, value, **kwargs):
        """Dict-like set() that also supports optional domain and path args in
        order to resolve naming collisions from using one cookie jar over
        multiple domains.
        """
        # support client code that unsets cookies by assignment of a None value:
        if value is None:
            remove_cookie_by_name(self, name, domain=kwargs.get('domain'), path=kwargs.get('path'))
            return

        if isinstance(value, Morsel):
            c = morsel_to_cookie(value)
        else:
            c = create_cookie(name, value, **kwargs)
        self.set_cookie(c)
        return c

    def iterkeys(self):
        """Dict-like iterkeys() that returns an iterator of names of cookies
        from the jar.

        .. seealso:: itervalues() and iteritems().
        """
        for cookie in iter(self):
            yield cookie.name

    def keys(self):
        """Dict-like keys() that returns a list of names of cookies from the
        jar.

        .. seealso:: values() and items().
        """
        return list(self.iterkeys())

    def itervalues(self):
        """Dict-like itervalues() that returns an iterator of values of cookies
        from the jar.

        .. seealso:: iterkeys() and iteritems().
        """
        for cookie in iter(self):
            yield cookie.value

    def values(self):
        """Dict-like values() that returns a list of values of cookies from the
        jar.

        .. seealso:: keys() and items().
        """
        return list(self.itervalues())

    def iteritems(self):
        """Dict-like iteritems() that returns an iterator of name-value tuples
        from the jar.

        .. seealso:: iterkeys() and itervalues().
        """
        for cookie in iter(self):
            yield cookie.name, cookie.value

    def items(self):
        """Dict-like items() that returns a list of name-value tuples from the
        jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a
        vanilla python dict of key value pairs.

        .. seealso:: keys() and values().
        """
        return list(self.iteritems())

    def list_domains(self):
        """Utility method to list all the domains in the jar."""
        domains = []
        for cookie in iter(self):
            if cookie.domain not in domains:
                domains.append(cookie.domain)
        return domains

    def list_paths(self):
        """Utility method to list all the paths in the jar."""
        paths = []
        for cookie in iter(self):
            if cookie.path not in paths:
                paths.append(cookie.path)
        return paths

    def multiple_domains(self):
        """Returns True if there are multiple domains in the jar.
        Returns False otherwise.

        :rtype: bool
        """
        domains = []
        for cookie in iter(self):
            if cookie.domain is not None and cookie.domain in domains:
                return True
            domains.append(cookie.domain)
        return False  # there is only one domain in jar

    def get_dict(self, domain=None, path=None):
        """Takes as an argument an optional domain and path and returns a plain
        old Python dict of name-value pairs of cookies that meet the
        requirements.

        :rtype: dict
        """
        dictionary = {}
        for cookie in iter(self):
            if (
                (domain is None or cookie.domain == domain) and
                (path is None or cookie.path == path)
            ):
                dictionary[cookie.name] = cookie.value
        return dictionary

    def __contains__(self, name):
        try:
            return super(RequestsCookieJar, self).__contains__(name)
        except CookieConflictError:
            return True

    def __getitem__(self, name):
        """Dict-like __getitem__() for compatibility with client code. Throws
        exception if there are more than one cookie with name. In that case,
        use the more explicit get() method instead.

        .. warning:: operation is O(n), not O(1).
        """
        return self._find_no_duplicates(name)

    def __setitem__(self, name, value):
        """Dict-like __setitem__ for compatibility with client code. Throws
        exception if there is already a cookie of that name in the jar. In that
        case, use the more explicit set() method instead.
        """
        self.set(name, value)

    def __delitem__(self, name):
        """Deletes a cookie given a name. Wraps ``cookielib.CookieJar``'s
        ``remove_cookie_by_name()``.
        """
        remove_cookie_by_name(self, name)

    def set_cookie(self, cookie, *args, **kwargs):
        if hasattr(cookie.value, 'startswith') and cookie.value.startswith('"') and cookie.value.endswith('"'):
            cookie.value = cookie.value.replace('\\"', '')
        return super(RequestsCookieJar, self).set_cookie(cookie, *args, **kwargs)

    def update(self, other):
        """Updates this jar with cookies from another CookieJar or dict-like"""
        if isinstance(other, cookielib.CookieJar):
            for cookie in other:
                self.set_cookie(copy.copy(cookie))
        else:
            super(RequestsCookieJar, self).update(other)

    def _find(self, name, domain=None, path=None):
        """Requests uses this method internally to get cookie values.

        If there are conflicting cookies, _find arbitrarily chooses one.
        See _find_no_duplicates if you want an exception thrown if there are
        conflicting cookies.

        :param name: a string containing name of cookie
        :param domain: (optional) string containing domain of cookie
        :param path: (optional) string containing path of cookie
        :return: cookie.value
        """
        for cookie in iter(self):
            if cookie.name == name:
                if domain is None or cookie.domain == domain:
                    if path is None or cookie.path == path:
                        return cookie.value

        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))

    def _find_no_duplicates(self, name, domain=None, path=None):
        """Both ``__get_item__`` and ``get`` call this function: it's never
        used elsewhere in Requests.

        :param name: a string containing name of cookie
        :param domain: (optional) string containing domain of cookie
        :param path: (optional) string containing path of cookie
        :raises KeyError: if cookie is not found
        :raises CookieConflictError: if there are multiple cookies
            that match name and optionally domain and path
        :return: cookie.value
        """
        toReturn = None
        for cookie in iter(self):
            if cookie.name == name:
                if domain is None or cookie.domain == domain:
                    if path is None or cookie.path == path:
                        if toReturn is not None:  # if there are multiple cookies that meet passed in criteria
                            raise CookieConflictError('There are multiple cookies with name, %r' % (name))
                        toReturn = cookie.value  # we will eventually return this as long as no cookie conflict

        if toReturn:
            return toReturn
        raise KeyError('name=%r, domain=%r, path=%r' % (name, domain, path))

    def __getstate__(self):
        """Unlike a normal CookieJar, this class is pickleable."""
        state = self.__dict__.copy()
        # remove the unpickleable RLock object
        state.pop('_cookies_lock')
        return state

    def __setstate__(self, state):
        """Unlike a normal CookieJar, this class is pickleable."""
        self.__dict__.update(state)
        if '_cookies_lock' not in self.__dict__:
            self._cookies_lock = threading.RLock()

    def copy(self):
        """Return a copy of this RequestsCookieJar."""
        new_cj = RequestsCookieJar()
        new_cj.set_policy(self.get_policy())
        new_cj.update(self)
        return new_cj

    def get_policy(self):
        """Return the CookiePolicy instance used."""
        return self._policy


def _copy_cookie_jar(jar):
    if jar is None:
        return None

    if hasattr(jar, 'copy'):
        # We're dealing with an instance of RequestsCookieJar
        return jar.copy()
    # We're dealing with a generic CookieJar instance
    new_jar = copy.copy(jar)
    new_jar.clear()
    for cookie in jar:
        new_jar.set_cookie(copy.copy(cookie))
    return new_jar


def create_cookie(name, value, **kwargs):
    """Make a cookie from underspecified parameters.

    By default, the pair of `name` and `value` will be set for the domain ''
    and sent on every request (this is sometimes called a "supercookie").
    """
    result = {
        'version': 0,
        'name': name,
        'value': value,
        'port': None,
        'domain': '',
        'path': '/',
        'secure': False,
        'expires': None,
        'discard': True,
        'comment': None,
        'comment_url': None,
        'rest': {'HttpOnly': None},
        'rfc2109': False,
    }

    badargs = set(kwargs) - set(result)
    if badargs:
        err = 'create_cookie() got unexpected keyword arguments: %s'
        raise TypeError(err % list(badargs))

    result.update(kwargs)
    result['port_specified'] = bool(result['port'])
    result['domain_specified'] = bool(result['domain'])
    result['domain_initial_dot'] = result['domain'].startswith('.')
    result['path_specified'] = bool(result['path'])

    return cookielib.Cookie(**result)


def morsel_to_cookie(morsel):
    """Convert a Morsel object into a Cookie containing the one k/v pair."""

    expires = None
    if morsel['max-age']:
        try:
            expires = int(time.time() + int(morsel['max-age']))
        except ValueError:
            raise TypeError('max-age: %s must be integer' % morsel['max-age'])
    elif morsel['expires']:
        time_template = '%a, %d-%b-%Y %H:%M:%S GMT'
        expires = calendar.timegm(
            time.strptime(morsel['expires'], time_template)
        )
    return create_cookie(
        comment=morsel['comment'],
        comment_url=bool(morsel['comment']),
        discard=False,
        domain=morsel['domain'],
        expires=expires,
        name=morsel.key,
        path=morsel['path'],
        port=None,
        rest={'HttpOnly': morsel['httponly']},
        rfc2109=False,
        secure=bool(morsel['secure']),
        value=morsel.value,
        version=morsel['version'] or 0,
    )


def cookiejar_from_dict(cookie_dict, cookiejar=None, overwrite=True):
    """Returns a CookieJar from a key/value dictionary.

    :param cookie_dict: Dict of key/values to insert into CookieJar.
    :param cookiejar: (optional) A cookiejar to add the cookies to.
    :param overwrite: (optional) If False, will not replace cookies
        already in the jar with new ones.
    :rtype: CookieJar
    """
    if cookiejar is None:
        cookiejar = RequestsCookieJar()

    if cookie_dict is not None:
        names_from_jar = [cookie.name for cookie in cookiejar]
        for name in cookie_dict:
            if overwrite or (name not in names_from_jar):
                cookiejar.set_cookie(create_cookie(name, cookie_dict[name]))

    return cookiejar


def merge_cookies(cookiejar, cookies):
    """Add cookies to cookiejar and returns a merged CookieJar.

    :param cookiejar: CookieJar object to add the cookies to.
    :param cookies: Dictionary or CookieJar object to be added.
    :rtype: CookieJar
    """
    if not isinstance(cookiejar, cookielib.CookieJar):
        raise ValueError('You can only merge into CookieJar')

    if isinstance(cookies, dict):
        cookiejar = cookiejar_from_dict(
            cookies, cookiejar=cookiejar, overwrite=False)
    elif isinstance(cookies, cookielib.CookieJar):
        try:
            cookiejar.update(cookies)
        except AttributeError:
            for cookie_in_jar in cookies:
                cookiejar.set_cookie(cookie_in_jar)

    return cookiejar
site-packages/pip/_vendor/requests/status_codes.py000064400000010041151446176770016453 0ustar00# -*- coding: utf-8 -*-

r"""
The ``codes`` object defines a mapping from common names for HTTP statuses
to their numerical codes, accessible either as attributes or as dictionary
items.

>>> requests.codes['temporary_redirect']
307
>>> requests.codes.teapot
418
>>> requests.codes['\o/']
200

Some codes have multiple names, and both upper- and lower-case versions of
the names are allowed. For example, ``codes.ok``, ``codes.OK``, and
``codes.okay`` all correspond to the HTTP status code 200.
"""

from .structures import LookupDict

_codes = {

    # Informational.
    100: ('continue',),
    101: ('switching_protocols',),
    102: ('processing',),
    103: ('checkpoint',),
    122: ('uri_too_long', 'request_uri_too_long'),
    200: ('ok', 'okay', 'all_ok', 'all_okay', 'all_good', '\\o/', '✓'),
    201: ('created',),
    202: ('accepted',),
    203: ('non_authoritative_info', 'non_authoritative_information'),
    204: ('no_content',),
    205: ('reset_content', 'reset'),
    206: ('partial_content', 'partial'),
    207: ('multi_status', 'multiple_status', 'multi_stati', 'multiple_stati'),
    208: ('already_reported',),
    226: ('im_used',),

    # Redirection.
    300: ('multiple_choices',),
    301: ('moved_permanently', 'moved', '\\o-'),
    302: ('found',),
    303: ('see_other', 'other'),
    304: ('not_modified',),
    305: ('use_proxy',),
    306: ('switch_proxy',),
    307: ('temporary_redirect', 'temporary_moved', 'temporary'),
    308: ('permanent_redirect',
          'resume_incomplete', 'resume',),  # These 2 to be removed in 3.0

    # Client Error.
    400: ('bad_request', 'bad'),
    401: ('unauthorized',),
    402: ('payment_required', 'payment'),
    403: ('forbidden',),
    404: ('not_found', '-o-'),
    405: ('method_not_allowed', 'not_allowed'),
    406: ('not_acceptable',),
    407: ('proxy_authentication_required', 'proxy_auth', 'proxy_authentication'),
    408: ('request_timeout', 'timeout'),
    409: ('conflict',),
    410: ('gone',),
    411: ('length_required',),
    412: ('precondition_failed', 'precondition'),
    413: ('request_entity_too_large',),
    414: ('request_uri_too_large',),
    415: ('unsupported_media_type', 'unsupported_media', 'media_type'),
    416: ('requested_range_not_satisfiable', 'requested_range', 'range_not_satisfiable'),
    417: ('expectation_failed',),
    418: ('im_a_teapot', 'teapot', 'i_am_a_teapot'),
    421: ('misdirected_request',),
    422: ('unprocessable_entity', 'unprocessable'),
    423: ('locked',),
    424: ('failed_dependency', 'dependency'),
    425: ('unordered_collection', 'unordered'),
    426: ('upgrade_required', 'upgrade'),
    428: ('precondition_required', 'precondition'),
    429: ('too_many_requests', 'too_many'),
    431: ('header_fields_too_large', 'fields_too_large'),
    444: ('no_response', 'none'),
    449: ('retry_with', 'retry'),
    450: ('blocked_by_windows_parental_controls', 'parental_controls'),
    451: ('unavailable_for_legal_reasons', 'legal_reasons'),
    499: ('client_closed_request',),

    # Server Error.
    500: ('internal_server_error', 'server_error', '/o\\', '✗'),
    501: ('not_implemented',),
    502: ('bad_gateway',),
    503: ('service_unavailable', 'unavailable'),
    504: ('gateway_timeout',),
    505: ('http_version_not_supported', 'http_version'),
    506: ('variant_also_negotiates',),
    507: ('insufficient_storage',),
    509: ('bandwidth_limit_exceeded', 'bandwidth'),
    510: ('not_extended',),
    511: ('network_authentication_required', 'network_auth', 'network_authentication'),
}

codes = LookupDict(name='status_codes')

def _init():
    for code, titles in _codes.items():
        for title in titles:
            setattr(codes, title, code)
            if not title.startswith(('\\', '/')):
                setattr(codes, title.upper(), code)

    def doc(code):
        names = ', '.join('``%s``' % n for n in _codes[code])
        return '* %d: %s' % (code, names)

    global __doc__
    __doc__ = (__doc__ + '\n' +
               '\n'.join(doc(code) for code in sorted(_codes))
               if __doc__ is not None else None)

_init()
site-packages/pip/_vendor/requests/utils.py000064400000072541151446176770015130 0ustar00# -*- coding: utf-8 -*-

"""
requests.utils
~~~~~~~~~~~~~~

This module provides utility functions that are used within Requests
that are also useful for external consumption.
"""

import codecs
import contextlib
import io
import os
import re
import socket
import struct
import sys
import tempfile
import warnings
import zipfile

from .__version__ import __version__
from . import certs
# to_native_string is unused here, but imported here for backwards compatibility
from ._internal_utils import to_native_string
from .compat import parse_http_list as _parse_list_header
from .compat import (
    quote, urlparse, bytes, str, OrderedDict, unquote, getproxies,
    proxy_bypass, urlunparse, basestring, integer_types, is_py3,
    proxy_bypass_environment, getproxies_environment, Mapping)
from .cookies import cookiejar_from_dict
from .structures import CaseInsensitiveDict
from .exceptions import (
    InvalidURL, InvalidHeader, FileModeWarning, UnrewindableBodyError)

NETRC_FILES = ('.netrc', '_netrc')

DEFAULT_CA_BUNDLE_PATH = certs.where()

DEFAULT_PORTS = {'http': 80, 'https': 443}


if sys.platform == 'win32':
    # provide a proxy_bypass version on Windows without DNS lookups

    def proxy_bypass_registry(host):
        try:
            if is_py3:
                import winreg
            else:
                import _winreg as winreg
        except ImportError:
            return False

        try:
            internetSettings = winreg.OpenKey(winreg.HKEY_CURRENT_USER,
                r'Software\Microsoft\Windows\CurrentVersion\Internet Settings')
            # ProxyEnable could be REG_SZ or REG_DWORD, normalizing it
            proxyEnable = int(winreg.QueryValueEx(internetSettings,
                                              'ProxyEnable')[0])
            # ProxyOverride is almost always a string
            proxyOverride = winreg.QueryValueEx(internetSettings,
                                                'ProxyOverride')[0]
        except OSError:
            return False
        if not proxyEnable or not proxyOverride:
            return False

        # make a check value list from the registry entry: replace the
        # '<local>' string by the localhost entry and the corresponding
        # canonical entry.
        proxyOverride = proxyOverride.split(';')
        # now check if we match one of the registry values.
        for test in proxyOverride:
            if test == '<local>':
                if '.' not in host:
                    return True
            test = test.replace(".", r"\.")     # mask dots
            test = test.replace("*", r".*")     # change glob sequence
            test = test.replace("?", r".")      # change glob char
            if re.match(test, host, re.I):
                return True
        return False

    def proxy_bypass(host):  # noqa
        """Return True, if the host should be bypassed.

        Checks proxy settings gathered from the environment, if specified,
        or the registry.
        """
        if getproxies_environment():
            return proxy_bypass_environment(host)
        else:
            return proxy_bypass_registry(host)


def dict_to_sequence(d):
    """Returns an internal sequence dictionary update."""

    if hasattr(d, 'items'):
        d = d.items()

    return d


def super_len(o):
    total_length = None
    current_position = 0

    if hasattr(o, '__len__'):
        total_length = len(o)

    elif hasattr(o, 'len'):
        total_length = o.len

    elif hasattr(o, 'fileno'):
        try:
            fileno = o.fileno()
        except io.UnsupportedOperation:
            pass
        else:
            total_length = os.fstat(fileno).st_size

            # Having used fstat to determine the file length, we need to
            # confirm that this file was opened up in binary mode.
            if 'b' not in o.mode:
                warnings.warn((
                    "Requests has determined the content-length for this "
                    "request using the binary size of the file: however, the "
                    "file has been opened in text mode (i.e. without the 'b' "
                    "flag in the mode). This may lead to an incorrect "
                    "content-length. In Requests 3.0, support will be removed "
                    "for files in text mode."),
                    FileModeWarning
                )

    if hasattr(o, 'tell'):
        try:
            current_position = o.tell()
        except (OSError, IOError):
            # This can happen in some weird situations, such as when the file
            # is actually a special file descriptor like stdin. In this
            # instance, we don't know what the length is, so set it to zero and
            # let requests chunk it instead.
            if total_length is not None:
                current_position = total_length
        else:
            if hasattr(o, 'seek') and total_length is None:
                # StringIO and BytesIO have seek but no useable fileno
                try:
                    # seek to end of file
                    o.seek(0, 2)
                    total_length = o.tell()

                    # seek back to current position to support
                    # partially read file-like objects
                    o.seek(current_position or 0)
                except (OSError, IOError):
                    total_length = 0

    if total_length is None:
        total_length = 0

    return max(0, total_length - current_position)


def get_netrc_auth(url, raise_errors=False):
    """Returns the Requests tuple auth for a given url from netrc."""

    try:
        from netrc import netrc, NetrcParseError

        netrc_path = None

        for f in NETRC_FILES:
            try:
                loc = os.path.expanduser('~/{}'.format(f))
            except KeyError:
                # os.path.expanduser can fail when $HOME is undefined and
                # getpwuid fails. See https://bugs.python.org/issue20164 &
                # https://github.com/requests/requests/issues/1846
                return

            if os.path.exists(loc):
                netrc_path = loc
                break

        # Abort early if there isn't one.
        if netrc_path is None:
            return

        ri = urlparse(url)

        # Strip port numbers from netloc. This weird `if...encode`` dance is
        # used for Python 3.2, which doesn't support unicode literals.
        splitstr = b':'
        if isinstance(url, str):
            splitstr = splitstr.decode('ascii')
        host = ri.netloc.split(splitstr)[0]

        try:
            _netrc = netrc(netrc_path).authenticators(host)
            if _netrc:
                # Return with login / password
                login_i = (0 if _netrc[0] else 1)
                return (_netrc[login_i], _netrc[2])
        except (NetrcParseError, IOError):
            # If there was a parsing error or a permissions issue reading the file,
            # we'll just skip netrc auth unless explicitly asked to raise errors.
            if raise_errors:
                raise

    # AppEngine hackiness.
    except (ImportError, AttributeError):
        pass


def guess_filename(obj):
    """Tries to guess the filename of the given object."""
    name = getattr(obj, 'name', None)
    if (name and isinstance(name, basestring) and name[0] != '<' and
            name[-1] != '>'):
        return os.path.basename(name)


def extract_zipped_paths(path):
    """Replace nonexistent paths that look like they refer to a member of a zip
    archive with the location of an extracted copy of the target, or else
    just return the provided path unchanged.
    """
    if os.path.exists(path):
        # this is already a valid path, no need to do anything further
        return path

    # find the first valid part of the provided path and treat that as a zip archive
    # assume the rest of the path is the name of a member in the archive
    archive, member = os.path.split(path)
    while archive and not os.path.exists(archive):
        archive, prefix = os.path.split(archive)
        member = '/'.join([prefix, member])

    if not zipfile.is_zipfile(archive):
        return path

    zip_file = zipfile.ZipFile(archive)
    if member not in zip_file.namelist():
        return path

    # we have a valid zip archive and a valid member of that archive
    tmp = tempfile.gettempdir()
    extracted_path = os.path.join(tmp, *member.split('/'))
    if not os.path.exists(extracted_path):
        extracted_path = zip_file.extract(member, path=tmp)

    return extracted_path


def from_key_val_list(value):
    """Take an object and test to see if it can be represented as a
    dictionary. Unless it can not be represented as such, return an
    OrderedDict, e.g.,

    ::

        >>> from_key_val_list([('key', 'val')])
        OrderedDict([('key', 'val')])
        >>> from_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples
        >>> from_key_val_list({'key': 'val'})
        OrderedDict([('key', 'val')])

    :rtype: OrderedDict
    """
    if value is None:
        return None

    if isinstance(value, (str, bytes, bool, int)):
        raise ValueError('cannot encode objects that are not 2-tuples')

    return OrderedDict(value)


def to_key_val_list(value):
    """Take an object and test to see if it can be represented as a
    dictionary. If it can be, return a list of tuples, e.g.,

    ::

        >>> to_key_val_list([('key', 'val')])
        [('key', 'val')]
        >>> to_key_val_list({'key': 'val'})
        [('key', 'val')]
        >>> to_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples.

    :rtype: list
    """
    if value is None:
        return None

    if isinstance(value, (str, bytes, bool, int)):
        raise ValueError('cannot encode objects that are not 2-tuples')

    if isinstance(value, Mapping):
        value = value.items()

    return list(value)


# From mitsuhiko/werkzeug (used with permission).
def parse_list_header(value):
    """Parse lists as described by RFC 2068 Section 2.

    In particular, parse comma-separated lists where the elements of
    the list may include quoted-strings.  A quoted-string could
    contain a comma.  A non-quoted string could have quotes in the
    middle.  Quotes are removed automatically after parsing.

    It basically works like :func:`parse_set_header` just that items
    may appear multiple times and case sensitivity is preserved.

    The return value is a standard :class:`list`:

    >>> parse_list_header('token, "quoted value"')
    ['token', 'quoted value']

    To create a header from the :class:`list` again, use the
    :func:`dump_header` function.

    :param value: a string with a list header.
    :return: :class:`list`
    :rtype: list
    """
    result = []
    for item in _parse_list_header(value):
        if item[:1] == item[-1:] == '"':
            item = unquote_header_value(item[1:-1])
        result.append(item)
    return result


# From mitsuhiko/werkzeug (used with permission).
def parse_dict_header(value):
    """Parse lists of key, value pairs as described by RFC 2068 Section 2 and
    convert them into a python dict:

    >>> d = parse_dict_header('foo="is a fish", bar="as well"')
    >>> type(d) is dict
    True
    >>> sorted(d.items())
    [('bar', 'as well'), ('foo', 'is a fish')]

    If there is no value for a key it will be `None`:

    >>> parse_dict_header('key_without_value')
    {'key_without_value': None}

    To create a header from the :class:`dict` again, use the
    :func:`dump_header` function.

    :param value: a string with a dict header.
    :return: :class:`dict`
    :rtype: dict
    """
    result = {}
    for item in _parse_list_header(value):
        if '=' not in item:
            result[item] = None
            continue
        name, value = item.split('=', 1)
        if value[:1] == value[-1:] == '"':
            value = unquote_header_value(value[1:-1])
        result[name] = value
    return result


# From mitsuhiko/werkzeug (used with permission).
def unquote_header_value(value, is_filename=False):
    r"""Unquotes a header value.  (Reversal of :func:`quote_header_value`).
    This does not use the real unquoting but what browsers are actually
    using for quoting.

    :param value: the header value to unquote.
    :rtype: str
    """
    if value and value[0] == value[-1] == '"':
        # this is not the real unquoting, but fixing this so that the
        # RFC is met will result in bugs with internet explorer and
        # probably some other browsers as well.  IE for example is
        # uploading files with "C:\foo\bar.txt" as filename
        value = value[1:-1]

        # if this is a filename and the starting characters look like
        # a UNC path, then just return the value without quotes.  Using the
        # replace sequence below on a UNC path has the effect of turning
        # the leading double slash into a single slash and then
        # _fix_ie_filename() doesn't work correctly.  See #458.
        if not is_filename or value[:2] != '\\\\':
            return value.replace('\\\\', '\\').replace('\\"', '"')
    return value


def dict_from_cookiejar(cj):
    """Returns a key/value dictionary from a CookieJar.

    :param cj: CookieJar object to extract cookies from.
    :rtype: dict
    """

    cookie_dict = {}

    for cookie in cj:
        cookie_dict[cookie.name] = cookie.value

    return cookie_dict


def add_dict_to_cookiejar(cj, cookie_dict):
    """Returns a CookieJar from a key/value dictionary.

    :param cj: CookieJar to insert cookies into.
    :param cookie_dict: Dict of key/values to insert into CookieJar.
    :rtype: CookieJar
    """

    return cookiejar_from_dict(cookie_dict, cj)


def get_encodings_from_content(content):
    """Returns encodings from given content string.

    :param content: bytestring to extract encodings from.
    """
    warnings.warn((
        'In requests 3.0, get_encodings_from_content will be removed. For '
        'more information, please see the discussion on issue #2266. (This'
        ' warning should only appear once.)'),
        DeprecationWarning)

    charset_re = re.compile(r'<meta.*?charset=["\']*(.+?)["\'>]', flags=re.I)
    pragma_re = re.compile(r'<meta.*?content=["\']*;?charset=(.+?)["\'>]', flags=re.I)
    xml_re = re.compile(r'^<\?xml.*?encoding=["\']*(.+?)["\'>]')

    return (charset_re.findall(content) +
            pragma_re.findall(content) +
            xml_re.findall(content))


def _parse_content_type_header(header):
    """Returns content type and parameters from given header

    :param header: string
    :return: tuple containing content type and dictionary of
         parameters
    """

    tokens = header.split(';')
    content_type, params = tokens[0].strip(), tokens[1:]
    params_dict = {}
    items_to_strip = "\"' "

    for param in params:
        param = param.strip()
        if param:
            key, value = param, True
            index_of_equals = param.find("=")
            if index_of_equals != -1:
                key = param[:index_of_equals].strip(items_to_strip)
                value = param[index_of_equals + 1:].strip(items_to_strip)
            params_dict[key.lower()] = value
    return content_type, params_dict


def get_encoding_from_headers(headers):
    """Returns encodings from given HTTP Header Dict.

    :param headers: dictionary to extract encoding from.
    :rtype: str
    """

    content_type = headers.get('content-type')

    if not content_type:
        return None

    content_type, params = _parse_content_type_header(content_type)

    if 'charset' in params:
        return params['charset'].strip("'\"")

    if 'text' in content_type:
        return 'ISO-8859-1'


def stream_decode_response_unicode(iterator, r):
    """Stream decodes a iterator."""

    if r.encoding is None:
        for item in iterator:
            yield item
        return

    decoder = codecs.getincrementaldecoder(r.encoding)(errors='replace')
    for chunk in iterator:
        rv = decoder.decode(chunk)
        if rv:
            yield rv
    rv = decoder.decode(b'', final=True)
    if rv:
        yield rv


def iter_slices(string, slice_length):
    """Iterate over slices of a string."""
    pos = 0
    if slice_length is None or slice_length <= 0:
        slice_length = len(string)
    while pos < len(string):
        yield string[pos:pos + slice_length]
        pos += slice_length


def get_unicode_from_response(r):
    """Returns the requested content back in unicode.

    :param r: Response object to get unicode content from.

    Tried:

    1. charset from content-type
    2. fall back and replace all unicode characters

    :rtype: str
    """
    warnings.warn((
        'In requests 3.0, get_unicode_from_response will be removed. For '
        'more information, please see the discussion on issue #2266. (This'
        ' warning should only appear once.)'),
        DeprecationWarning)

    tried_encodings = []

    # Try charset from content-type
    encoding = get_encoding_from_headers(r.headers)

    if encoding:
        try:
            return str(r.content, encoding)
        except UnicodeError:
            tried_encodings.append(encoding)

    # Fall back:
    try:
        return str(r.content, encoding, errors='replace')
    except TypeError:
        return r.content


# The unreserved URI characters (RFC 3986)
UNRESERVED_SET = frozenset(
    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~")


def unquote_unreserved(uri):
    """Un-escape any percent-escape sequences in a URI that are unreserved
    characters. This leaves all reserved, illegal and non-ASCII bytes encoded.

    :rtype: str
    """
    parts = uri.split('%')
    for i in range(1, len(parts)):
        h = parts[i][0:2]
        if len(h) == 2 and h.isalnum():
            try:
                c = chr(int(h, 16))
            except ValueError:
                raise InvalidURL("Invalid percent-escape sequence: '%s'" % h)

            if c in UNRESERVED_SET:
                parts[i] = c + parts[i][2:]
            else:
                parts[i] = '%' + parts[i]
        else:
            parts[i] = '%' + parts[i]
    return ''.join(parts)


def requote_uri(uri):
    """Re-quote the given URI.

    This function passes the given URI through an unquote/quote cycle to
    ensure that it is fully and consistently quoted.

    :rtype: str
    """
    safe_with_percent = "!#$%&'()*+,/:;=?@[]~"
    safe_without_percent = "!#$&'()*+,/:;=?@[]~"
    try:
        # Unquote only the unreserved characters
        # Then quote only illegal characters (do not quote reserved,
        # unreserved, or '%')
        return quote(unquote_unreserved(uri), safe=safe_with_percent)
    except InvalidURL:
        # We couldn't unquote the given URI, so let's try quoting it, but
        # there may be unquoted '%'s in the URI. We need to make sure they're
        # properly quoted so they do not cause issues elsewhere.
        return quote(uri, safe=safe_without_percent)


def address_in_network(ip, net):
    """This function allows you to check if an IP belongs to a network subnet

    Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
             returns False if ip = 192.168.1.1 and net = 192.168.100.0/24

    :rtype: bool
    """
    ipaddr = struct.unpack('=L', socket.inet_aton(ip))[0]
    netaddr, bits = net.split('/')
    netmask = struct.unpack('=L', socket.inet_aton(dotted_netmask(int(bits))))[0]
    network = struct.unpack('=L', socket.inet_aton(netaddr))[0] & netmask
    return (ipaddr & netmask) == (network & netmask)


def dotted_netmask(mask):
    """Converts mask from /xx format to xxx.xxx.xxx.xxx

    Example: if mask is 24 function returns 255.255.255.0

    :rtype: str
    """
    bits = 0xffffffff ^ (1 << 32 - mask) - 1
    return socket.inet_ntoa(struct.pack('>I', bits))


def is_ipv4_address(string_ip):
    """
    :rtype: bool
    """
    try:
        socket.inet_aton(string_ip)
    except socket.error:
        return False
    return True


def is_valid_cidr(string_network):
    """
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    """
    if string_network.count('/') == 1:
        try:
            mask = int(string_network.split('/')[1])
        except ValueError:
            return False

        if mask < 1 or mask > 32:
            return False

        try:
            socket.inet_aton(string_network.split('/')[0])
        except socket.error:
            return False
    else:
        return False
    return True


@contextlib.contextmanager
def set_environ(env_name, value):
    """Set the environment variable 'env_name' to 'value'

    Save previous value, yield, and then restore the previous value stored in
    the environment variable 'env_name'.

    If 'value' is None, do nothing"""
    value_changed = value is not None
    if value_changed:
        old_value = os.environ.get(env_name)
        os.environ[env_name] = value
    try:
        yield
    finally:
        if value_changed:
            if old_value is None:
                del os.environ[env_name]
            else:
                os.environ[env_name] = old_value


def should_bypass_proxies(url, no_proxy):
    """
    Returns whether we should bypass proxies or not.

    :rtype: bool
    """
    # Prioritize lowercase environment variables over uppercase
    # to keep a consistent behaviour with other http projects (curl, wget).
    get_proxy = lambda k: os.environ.get(k) or os.environ.get(k.upper())

    # First check whether no_proxy is defined. If it is, check that the URL
    # we're getting isn't in the no_proxy list.
    no_proxy_arg = no_proxy
    if no_proxy is None:
        no_proxy = get_proxy('no_proxy')
    parsed = urlparse(url)

    if parsed.hostname is None:
        # URLs don't always have hostnames, e.g. file:/// urls.
        return True

    if no_proxy:
        # We need to check whether we match here. We need to see if we match
        # the end of the hostname, both with and without the port.
        no_proxy = (
            host for host in no_proxy.replace(' ', '').split(',') if host
        )

        if is_ipv4_address(parsed.hostname):
            for proxy_ip in no_proxy:
                if is_valid_cidr(proxy_ip):
                    if address_in_network(parsed.hostname, proxy_ip):
                        return True
                elif parsed.hostname == proxy_ip:
                    # If no_proxy ip was defined in plain IP notation instead of cidr notation &
                    # matches the IP of the index
                    return True
        else:
            host_with_port = parsed.hostname
            if parsed.port:
                host_with_port += ':{}'.format(parsed.port)

            for host in no_proxy:
                if parsed.hostname.endswith(host) or host_with_port.endswith(host):
                    # The URL does match something in no_proxy, so we don't want
                    # to apply the proxies on this URL.
                    return True

    with set_environ('no_proxy', no_proxy_arg):
        # parsed.hostname can be `None` in cases such as a file URI.
        try:
            bypass = proxy_bypass(parsed.hostname)
        except (TypeError, socket.gaierror):
            bypass = False

    if bypass:
        return True

    return False


def get_environ_proxies(url, no_proxy=None):
    """
    Return a dict of environment proxies.

    :rtype: dict
    """
    if should_bypass_proxies(url, no_proxy=no_proxy):
        return {}
    else:
        return getproxies()


def select_proxy(url, proxies):
    """Select a proxy for the url, if applicable.

    :param url: The url being for the request
    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
    """
    proxies = proxies or {}
    urlparts = urlparse(url)
    if urlparts.hostname is None:
        return proxies.get(urlparts.scheme, proxies.get('all'))

    proxy_keys = [
        urlparts.scheme + '://' + urlparts.hostname,
        urlparts.scheme,
        'all://' + urlparts.hostname,
        'all',
    ]
    proxy = None
    for proxy_key in proxy_keys:
        if proxy_key in proxies:
            proxy = proxies[proxy_key]
            break

    return proxy


def default_user_agent(name="python-requests"):
    """
    Return a string representing the default user agent.

    :rtype: str
    """
    return '%s/%s' % (name, __version__)


def default_headers():
    """
    :rtype: requests.structures.CaseInsensitiveDict
    """
    return CaseInsensitiveDict({
        'User-Agent': default_user_agent(),
        'Accept-Encoding': ', '.join(('gzip', 'deflate')),
        'Accept': '*/*',
        'Connection': 'keep-alive',
    })


def parse_header_links(value):
    """Return a list of parsed link headers proxies.

    i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"

    :rtype: list
    """

    links = []

    replace_chars = ' \'"'

    value = value.strip(replace_chars)
    if not value:
        return links

    for val in re.split(', *<', value):
        try:
            url, params = val.split(';', 1)
        except ValueError:
            url, params = val, ''

        link = {'url': url.strip('<> \'"')}

        for param in params.split(';'):
            try:
                key, value = param.split('=')
            except ValueError:
                break

            link[key.strip(replace_chars)] = value.strip(replace_chars)

        links.append(link)

    return links


# Null bytes; no need to recreate these on each call to guess_json_utf
_null = '\x00'.encode('ascii')  # encoding to ASCII for Python 3
_null2 = _null * 2
_null3 = _null * 3


def guess_json_utf(data):
    """
    :rtype: str
    """
    # JSON always starts with two ASCII characters, so detection is as
    # easy as counting the nulls and from their location and count
    # determine the encoding. Also detect a BOM, if present.
    sample = data[:4]
    if sample in (codecs.BOM_UTF32_LE, codecs.BOM_UTF32_BE):
        return 'utf-32'     # BOM included
    if sample[:3] == codecs.BOM_UTF8:
        return 'utf-8-sig'  # BOM included, MS style (discouraged)
    if sample[:2] in (codecs.BOM_UTF16_LE, codecs.BOM_UTF16_BE):
        return 'utf-16'     # BOM included
    nullcount = sample.count(_null)
    if nullcount == 0:
        return 'utf-8'
    if nullcount == 2:
        if sample[::2] == _null2:   # 1st and 3rd are null
            return 'utf-16-be'
        if sample[1::2] == _null2:  # 2nd and 4th are null
            return 'utf-16-le'
        # Did not detect 2 valid UTF-16 ascii-range characters
    if nullcount == 3:
        if sample[:3] == _null3:
            return 'utf-32-be'
        if sample[1:] == _null3:
            return 'utf-32-le'
        # Did not detect a valid UTF-32 ascii-range character
    return None


def prepend_scheme_if_needed(url, new_scheme):
    """Given a URL that may or may not have a scheme, prepend the given scheme.
    Does not replace a present scheme with the one provided as an argument.

    :rtype: str
    """
    scheme, netloc, path, params, query, fragment = urlparse(url, new_scheme)

    # urlparse is a finicky beast, and sometimes decides that there isn't a
    # netloc present. Assume that it's being over-cautious, and switch netloc
    # and path if urlparse decided there was no netloc.
    if not netloc:
        netloc, path = path, netloc

    return urlunparse((scheme, netloc, path, params, query, fragment))


def get_auth_from_url(url):
    """Given a url with authentication components, extract them into a tuple of
    username,password.

    :rtype: (str,str)
    """
    parsed = urlparse(url)

    try:
        auth = (unquote(parsed.username), unquote(parsed.password))
    except (AttributeError, TypeError):
        auth = ('', '')

    return auth


# Moved outside of function to avoid recompile every call
_CLEAN_HEADER_REGEX_BYTE = re.compile(b'^\\S[^\\r\\n]*$|^$')
_CLEAN_HEADER_REGEX_STR = re.compile(r'^\S[^\r\n]*$|^$')


def check_header_validity(header):
    """Verifies that header value is a string which doesn't contain
    leading whitespace or return characters. This prevents unintended
    header injection.

    :param header: tuple, in the format (name, value).
    """
    name, value = header

    if isinstance(value, bytes):
        pat = _CLEAN_HEADER_REGEX_BYTE
    else:
        pat = _CLEAN_HEADER_REGEX_STR
    try:
        if not pat.match(value):
            raise InvalidHeader("Invalid return character or leading space in header: %s" % name)
    except TypeError:
        raise InvalidHeader("Value for header {%s: %s} must be of type str or "
                            "bytes, not %s" % (name, value, type(value)))


def urldefragauth(url):
    """
    Given a url remove the fragment and the authentication part.

    :rtype: str
    """
    scheme, netloc, path, params, query, fragment = urlparse(url)

    # see func:`prepend_scheme_if_needed`
    if not netloc:
        netloc, path = path, netloc

    netloc = netloc.rsplit('@', 1)[-1]

    return urlunparse((scheme, netloc, path, params, query, ''))


def rewind_body(prepared_request):
    """Move file pointer back to its recorded starting position
    so it can be read again on redirect.
    """
    body_seek = getattr(prepared_request.body, 'seek', None)
    if body_seek is not None and isinstance(prepared_request._body_position, integer_types):
        try:
            body_seek(prepared_request._body_position)
        except (IOError, OSError):
            raise UnrewindableBodyError("An error occurred when rewinding request "
                                        "body for redirect.")
    else:
        raise UnrewindableBodyError("Unable to rewind request body for redirect.")
site-packages/pip/_vendor/requests/hooks.py000064400000001365151446176770015107 0ustar00# -*- coding: utf-8 -*-

"""
requests.hooks
~~~~~~~~~~~~~~

This module provides the capabilities for the Requests hooks system.

Available hooks:

``response``:
    The response generated from a Request.
"""
HOOKS = ['response']


def default_hooks():
    return {event: [] for event in HOOKS}

# TODO: response is the only one


def dispatch_hook(key, hooks, hook_data, **kwargs):
    """Dispatches a hook dictionary on a given piece of data."""
    hooks = hooks or {}
    hooks = hooks.get(key)
    if hooks:
        if hasattr(hooks, '__call__'):
            hooks = [hooks]
        for hook in hooks:
            _hook_data = hook(hook_data, **kwargs)
            if _hook_data is not None:
                hook_data = _hook_data
    return hook_data
site-packages/pip/_vendor/requests/compat.py000064400000003625151446176770015250 0ustar00# -*- coding: utf-8 -*-

"""
requests.compat
~~~~~~~~~~~~~~~

This module handles import compatibility issues between Python 2 and
Python 3.
"""

from pip._vendor import chardet

import sys

# -------
# Pythons
# -------

# Syntax sugar.
_ver = sys.version_info

#: Python 2.x?
is_py2 = (_ver[0] == 2)

#: Python 3.x?
is_py3 = (_ver[0] == 3)

# Note: We've patched out simplejson support in pip because it prevents
#       upgrading simplejson on Windows.
# try:
#     import simplejson as json
# except (ImportError, SyntaxError):
#     # simplejson does not support Python 3.2, it throws a SyntaxError
#     # because of u'...' Unicode literals.
import json

# ---------
# Specifics
# ---------

if is_py2:
    from urllib import (
        quote, unquote, quote_plus, unquote_plus, urlencode, getproxies,
        proxy_bypass, proxy_bypass_environment, getproxies_environment)
    from urlparse import urlparse, urlunparse, urljoin, urlsplit, urldefrag
    from urllib2 import parse_http_list
    import cookielib
    from Cookie import Morsel
    from StringIO import StringIO
    from collections import Callable, Mapping, MutableMapping, OrderedDict


    builtin_str = str
    bytes = str
    str = unicode
    basestring = basestring
    numeric_types = (int, long, float)
    integer_types = (int, long)

elif is_py3:
    from urllib.parse import urlparse, urlunparse, urljoin, urlsplit, urlencode, quote, unquote, quote_plus, unquote_plus, urldefrag
    from urllib.request import parse_http_list, getproxies, proxy_bypass, proxy_bypass_environment, getproxies_environment
    from http import cookiejar as cookielib
    from http.cookies import Morsel
    from io import StringIO
    from collections import OrderedDict
    from collections.abc import Callable, Mapping, MutableMapping

    builtin_str = str
    str = str
    bytes = bytes
    basestring = (str, bytes)
    numeric_types = (int, float)
    integer_types = (int,)
site-packages/pip/_vendor/requests/__pycache__/_internal_utils.cpython-38.opt-1.pyc000064400000002332151446176770024377 0ustar00U

��.eH�@s.dZddlmZmZmZd	dd�Zdd�ZdS)
z�
requests._internal_utils
~~~~~~~~~~~~~~

Provides utility functions that are consumed internally by Requests
which depend on extremely few external helpers (such as compat)
�)�is_py2�builtin_str�str�asciicCs.t|t�r|}ntr |�|�}n
|�|�}|S)z�Given a string object, regardless of type, returns a representation of
    that string in the native string type, encoding and decoding where
    necessary. This assumes ASCII unless told otherwise.
    )�
isinstancerr�encode�decode)�string�encoding�out�r�H/usr/lib/python3.8/site-packages/pip/_vendor/requests/_internal_utils.py�to_native_strings

rcCs,z|�d�WdStk
r&YdSXdS)z�Determine if unicode string only contains ASCII characters.

    :param str u_string: unicode string to check. Must be unicode
        and not Python 2 `str`.
    :rtype: bool
    rTFN)r�UnicodeEncodeError)Zu_stringrrr
�unicode_is_asciis

rN)r)�__doc__�compatrrrrrrrrr
�<module>s
site-packages/pip/_vendor/requests/__pycache__/__init__.cpython-38.opt-1.pyc000064400000006420151446176770022745 0ustar00U

��.e��	@sdZddlmZddlmZddlZddlmZdd�Zd	d
�Zzeej	ej	�Wn0e
efk
r�e�d�
ej	ej	�e�YnXddlmZes�z,dd
lmZe��ddlm	Zee�Wnek
r�YnXddlmZe�de�ddl	mZmZmZm	Z	ddl	mZmZmZmZddl	m Z m!Z!ddl"m#Z#ddl"m$Z$ddl%m&Z&m'Z'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3m4Z4ddl5m6Z6ddlm7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?ddl@Z@ddl@mAZAe@�BeC��DeA��ejde=dd�dS)a�
Requests HTTP Library
~~~~~~~~~~~~~~~~~~~~~

Requests is an HTTP library, written in Python, for human beings. Basic GET
usage:

   >>> import requests
   >>> r = requests.get('https://www.python.org')
   >>> r.status_code
   200
   >>> 'Python is a programming language' in r.content
   True

... or POST:

   >>> payload = dict(key1='value1', key2='value2')
   >>> r = requests.post('https://httpbin.org/post', data=payload)
   >>> print(r.text)
   {
     ...
     "form": {
       "key2": "value2",
       "key1": "value1"
     },
     ...
   }

The other HTTP methods are supported - see `requests.api`. Full documentation
is at <http://python-requests.org>.

:copyright: (c) 2017 by Kenneth Reitz.
:license: Apache 2.0, see LICENSE for more details.
�)�urllib3)�chardetN�)�RequestsDependencyWarningcCs~|�d�}t|�dkr |�d�|\}}}t|�t|�t|�}}}|�d�dd�\}}}t|�t|�t|�}}}dS)N�.��0�)�split�len�append�int)Zurllib3_versionZchardet_version�major�minor�patch�r�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/__init__.py�check_compatibility1s


rcCsXzttt|�d���}Wntk
r.YdSX|dddgkrTd�|�}t�|t�dS)Nrrr	�z4Old version of cryptography ({}) may cause slowdown.)	�list�mapr
r
�
ValueError�format�warnings�warnr)�cryptography_versionZwarningrrr�_check_cryptographyJs
rz?urllib3 ({}) or chardet ({}) doesn't match a supported version!)�WINDOWS)�	pyopenssl)�__version__)�DependencyWarning�ignore)�	__title__�__description__�__url__r)�	__build__�
__author__�__author_email__�__license__)�
__copyright__�__cake__)�utils)�packages)�Request�Response�PreparedRequest)�request�get�head�postr�put�delete�options)�session�Session)�codes)	�RequestException�Timeout�URLRequired�TooManyRedirects�	HTTPError�ConnectionError�FileModeWarning�ConnectTimeout�ReadTimeout)�NullHandler�defaultT)r)E�__doc__Zpip._vendorrrr�
exceptionsrrrr�AssertionErrorrrrZpip._internal.utils.compatrZpip._vendor.urllib3.contribrZinject_into_urllib3Zcryptographyr�ImportErrorZpip._vendor.urllib3.exceptionsr �simplefilterr"r#r$r%r&r'r(r)r*�r+r,Zmodelsr-r.r/Zapir0r1r2r3rr4r5r6Zsessionsr7r8Zstatus_codesr9r:r;r<r=r>r?r@rArBZloggingrCZ	getLogger�__name__Z
addHandlerrrrr�<module>sP#��
(,site-packages/pip/_vendor/requests/__pycache__/adapters.cpython-38.pyc000064400000041063151446176770022054 0ustar00U

��.e,T�@s�dZddlZddlZddlmZmZddlmZddl	m
Z
ddl	mZddl
mZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlmZddlmZddlmZddlmZddlmZddlmZddl m!Z!m"Z"ddl#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0m1Z1m2Z2mZmZm3Z3m4Z4m5Z5m6Z6ddl7m8Z8zddl9m:Z:Wne;k
�r�dd�Z:YnXdZ<dZ=dZ>dZ?Gd d!�d!e@�ZAGd"d#�d#eA�ZBdS)$z�
requests.adapters
~~~~~~~~~~~~~~~~~

This module contains the transport adapters that Requests uses to define
and maintain connections.
�N)�PoolManager�proxy_from_url)�HTTPResponse)�	parse_url)�Timeout)�Retry)�ClosedPoolError)�ConnectTimeoutError)�	HTTPError)�
MaxRetryError)�NewConnectionError)�
ProxyError)�
ProtocolError)�ReadTimeoutError)�SSLError)�
ResponseError)�LocationValueError�)�Response)�urlparse�
basestring)�DEFAULT_CA_BUNDLE_PATH�extract_zipped_paths�get_encoding_from_headers�prepend_scheme_if_needed�get_auth_from_url�
urldefragauth�select_proxy)�CaseInsensitiveDict)�extract_cookies_to_jar)	�ConnectionError�ConnectTimeout�ReadTimeoutrr
�
RetryError�
InvalidSchema�InvalidProxyURL�
InvalidURL)�_basic_auth_str)�SOCKSProxyManagercOstd��dS)Nz'Missing dependencies for SOCKS support.)r$)�args�kwargs�r+�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/adapters.pyr(.sr(F�
cs2eZdZdZ�fdd�Zddd�Zd	d
�Z�ZS)�BaseAdapterzThe Base Transport Adaptercstt|���dS�N)�superr.�__init__��self��	__class__r+r,r1:szBaseAdapter.__init__FNTcCst�dS)aCSends PreparedRequest object. Returns Response object.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param stream: (optional) Whether to stream the request content.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple
        :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use
        :param cert: (optional) Any user-provided SSL certificate to be trusted.
        :param proxies: (optional) The proxies dictionary to apply to the request.
        N��NotImplementedError)r3�request�stream�timeout�verify�cert�proxiesr+r+r,�send=szBaseAdapter.sendcCst�dS)z!Cleans up adapter specific items.Nr6r2r+r+r,�closeOszBaseAdapter.close)FNTNN)�__name__�
__module__�__qualname__�__doc__r1r>r?�
__classcell__r+r+r4r,r.7s�
r.cs�eZdZdZdddddgZeeeef�fdd�	Zd	d
�Z	dd�Z
efd
d�Zdd�Zdd�Z
dd�Zd$dd�Zdd�Zdd�Zdd�Zdd�Zd%d"d#�Z�ZS)&�HTTPAdaptera�The built-in HTTP Adapter for urllib3.

    Provides a general-case interface for Requests sessions to contact HTTP and
    HTTPS urls by implementing the Transport Adapter interface. This class will
    usually be created by the :class:`Session <Session>` class under the
    covers.

    :param pool_connections: The number of urllib3 connection pools to cache.
    :param pool_maxsize: The maximum number of connections to save in the pool.
    :param max_retries: The maximum number of retries each connection
        should attempt. Note, this applies only to failed DNS lookups, socket
        connections and connection timeouts, never to requests where data has
        made it to the server. By default, Requests does not retry failed
        connections. If you need granular control over the conditions under
        which we retry a request, import urllib3's ``Retry`` class and pass
        that instead.
    :param pool_block: Whether the connection pool should block for connections.

    Usage::

      >>> import requests
      >>> s = requests.Session()
      >>> a = requests.adapters.HTTPAdapter(max_retries=3)
      >>> s.mount('http://', a)
    �max_retries�config�_pool_connections�
_pool_maxsize�_pool_blockcsd|tkrtddd�|_nt�|�|_i|_i|_tt|���||_	||_
||_|j|||d�dS)NrF)�read��block)
�DEFAULT_RETRIESrrFZfrom_intrG�
proxy_managerr0rEr1rHrIrJ�init_poolmanager)r3Zpool_connectionsZpool_maxsizerFZ
pool_blockr4r+r,r1qszHTTPAdapter.__init__cs�fdd��jD�S)Ncsi|]}|t�|d��qSr/)�getattr)�.0�attrr2r+r,�
<dictcomp>�sz,HTTPAdapter.__getstate__.<locals>.<dictcomp>)�	__attrs__r2r+r2r,�__getstate__�szHTTPAdapter.__getstate__cCsDi|_i|_|��D]\}}t|||�q|j|j|j|jd�dS)NrL)rOrG�items�setattrrPrHrIrJ)r3�staterS�valuer+r+r,�__setstate__�s�zHTTPAdapter.__setstate__cKs0||_||_||_tf|||dd�|��|_dS)aInitializes a urllib3 PoolManager.

        This method should not be called from user code, and is only
        exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param connections: The number of urllib3 connection pools to cache.
        :param maxsize: The maximum number of connections to save in the pool.
        :param block: Block when no free connections are available.
        :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager.
        T)�	num_pools�maxsizerM�strictN)rHrIrJr�poolmanager)r3Zconnectionsr]rMZpool_kwargsr+r+r,rP�s
��zHTTPAdapter.init_poolmanagercKs�||jkr|j|}n||���d�r^t|�\}}t|f|||j|j|jd�|��}|j|<n4|�|�}t	|f||j|j|jd�|��}|j|<|S)a�Return urllib3 ProxyManager for the given proxy.

        This method should not be called from user code, and is only
        exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param proxy: The proxy to return a urllib3 ProxyManager for.
        :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager.
        :returns: ProxyManager
        :rtype: urllib3.ProxyManager
        �socks)�username�passwordr\r]rM)�
proxy_headersr\r]rM)
rO�lower�
startswithrr(rHrIrJrcr)r3�proxyZproxy_kwargsZmanagerrarbrcr+r+r,�proxy_manager_for�s6
���

���zHTTPAdapter.proxy_manager_forcCs�|���d�rn|rnd}|dk	r"|}|s.tt�}|r>tj�|�sLtd�|���d|_	tj�
|�sf||_q�||_nd|_	d|_d|_|r�t
|t�s�|d|_|d|_n||_d|_|jr�tj�|j�s�td	�|j���|jr�tj�|j�s�td
�|j���dS)aAVerify a SSL certificate. This method should not be called from user
        code, and is only exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param conn: The urllib3 connection object associated with the cert.
        :param url: The requested URL.
        :param verify: Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use
        :param cert: The SSL certificate to verify.
        �httpsNTzECould not find a suitable TLS CA certificate bundle, invalid path: {}Z
CERT_REQUIREDZ	CERT_NONErrz9Could not find the TLS certificate file, invalid path: {}z1Could not find the TLS key file, invalid path: {})rdrerr�os�path�exists�IOError�formatZ	cert_reqs�isdirZca_certsZca_cert_dir�
isinstancerZ	cert_fileZkey_file)r3�conn�urlr;r<Zcert_locr+r+r,�cert_verify�s>�

��zHTTPAdapter.cert_verifycCs�t�}t|dd�|_tt|di��|_t|j�|_||_|jj|_t	|j
t�r^|j
�d�|_
n|j
|_
t
|j||�||_||_|S)a�Builds a :class:`Response <requests.Response>` object from a urllib3
        response. This should not be called from user code, and is only exposed
        for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`

        :param req: The :class:`PreparedRequest <PreparedRequest>` used to generate the response.
        :param resp: The urllib3 response object.
        :rtype: requests.Response
        ZstatusN�headers�utf-8)rrQZstatus_coderrsr�encoding�raw�reasonrorq�bytes�decoder�cookiesr8�
connection)r3Zreq�respZresponser+r+r,�build_response�s

zHTTPAdapter.build_responseNcCsdt||�}|rDt|d�}t|�}|js.td��|�|�}|�|�}nt|�}|��}|j	�|�}|S)a�Returns a urllib3 connection for the given URL. This should not be
        called from user code, and is only exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param url: The URL to connect to.
        :param proxies: (optional) A Requests-style dictionary of proxies used on this request.
        :rtype: urllib3.ConnectionPool
        ZhttpzFPlease check proxy URL. It is malformed and could be missing the host.)
rrrZhostr%rgZconnection_from_urlrZgeturlr_)r3rqr=rfZ	proxy_urlrOrpZparsedr+r+r,�get_connection$s	


zHTTPAdapter.get_connectioncCs&|j��|j��D]}|��qdS)z�Disposes of any internal state.

        Currently, this closes the PoolManager and any active ProxyManager,
        which closes any pooled connections.
        N)r_�clearrO�values)r3rfr+r+r,r??s
zHTTPAdapter.closec	Cs`t|j|�}t|j�j}|o"|dk}d}|rDt|�j��}|�d�}|j}|r\|s\t|j�}|S)a?Obtain the url to use when making the final request.

        If the message is being sent through a HTTP proxy, the full URL has to
        be used. Otherwise, we should only use the path portion of the URL.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs.
        :rtype: str
        rhFr`)rrqr�schemerdreZpath_urlr)	r3r8r=rfr�Zis_proxied_http_requestZusing_socks_proxyZproxy_schemerqr+r+r,�request_urlIs

zHTTPAdapter.request_urlcKsdS)a"Add any headers needed by the connection. As of v2.0 this does
        nothing by default, but is left for overriding by users that subclass
        the :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param request: The :class:`PreparedRequest <PreparedRequest>` to add headers to.
        :param kwargs: The keyword arguments from the call to send().
        Nr+)r3r8r*r+r+r,�add_headersfszHTTPAdapter.add_headerscCs&i}t|�\}}|r"t||�|d<|S)aReturns a dictionary of the headers to add to any request sent
        through a proxy. This works with urllib3 magic to ensure that they are
        correctly sent to the proxy, rather than in a tunnelled request if
        CONNECT is being used.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param proxy: The url of the proxy being used for this request.
        :rtype: dict
        zProxy-Authorization)rr')r3rfrsrarbr+r+r,rcts
�zHTTPAdapter.proxy_headersFTcCs�z|�|j|�}Wn.tk
r@}zt||d��W5d}~XYnX|�||j||�|�||�}	|j||||||d�|jdkp�d|jk}
t	|t
�r�z|\}}t||d�}Wq�tk
r�}zd�
|�}
t|
��W5d}~XYq�Xnt	|t�r�nt||d�}�zF|
�s2|j|j|	|j|jdddd|j|d�
}�nt|d	��rD|j}|jtd
�}z�|j|j|	dd�|j��D]\}}|�||��qn|��|jD]D}|�tt|��d
d��d��|�d�|�|�|�d��q�|�d�z|jdd�}Wntk
�r|��}YnXtj |||ddd�}Wn|�!��YnXW�n�t"t#j$fk
�r~}
zt%|
|d��W5d}
~
XY�nZt&k
�r"}z�t	|j't(��r�t	|j't)��s�t*||d��t	|j't+��r�t,||d��t	|j't-��r�t.||d��t	|j't/��rt0||d��t%||d��W5d}~XYn�t1k
�rP}zt%||d��W5d}~XYn�t-k
�rz}zt.|��W5d}~XYn^t/t2fk
�r�}z:t	|t/��r�t0||d��nt	|t3��r�t4||d��n�W5d}~XYnX|�5||�S)aSends PreparedRequest object. Returns Response object.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param stream: (optional) Whether to stream the request content.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple or urllib3 Timeout object
        :param verify: (optional) Either a boolean, in which case it controls whether
            we verify the server's TLS certificate, or a string, in which case it
            must be a path to a CA bundle to use
        :param cert: (optional) Any user-provided SSL certificate to be trusted.
        :param proxies: (optional) The proxies dictionary to apply to the request.
        :rtype: requests.Response
        )r8N)r9r:r;r<r=zContent-Length)�connectrKzrInvalid timeout {}. Pass a (connect, read) timeout tuple, or a single float to set both timeouts to the same valueF)
�methodrq�bodyrsZredirectZassert_same_host�preload_content�decode_contentZretriesr:�
proxy_pool)r:T)Zskip_accept_encoding�rts
s0

)�	buffering)Zpoolr{r�r�)6r~rqrr&rrr�r�r�rsro�tuple�TimeoutSauce�
ValueErrorrmZurlopenr�rF�hasattrr�Z	_get_conn�DEFAULT_POOL_TIMEOUTZ
putrequestrWZ	putheaderZ
endheadersr>�hex�len�encodeZgetresponse�	TypeErrorrZfrom_httplibr?r�socket�errorr rrwr	rr!rr#�_ProxyErrorr
�	_SSLErrorrr�
_HTTPErrorrr"r})r3r8r9r:r;r<r=rp�erqZchunkedr�rK�errr|Zlow_conn�headerrZ�i�rr+r+r,r>�s�
�
�
�
 


�
zHTTPAdapter.send)N)FNTNN)r@rArBrCrU�DEFAULT_POOLSIZErN�DEFAULT_POOLBLOCKr1rVr[rPrgrrr}r~r?r�r�rcr>rDr+r+r4r,rETs*��%4%

rE)CrCZos.pathrir�Zpip._vendor.urllib3.poolmanagerrrZpip._vendor.urllib3.responserZpip._vendor.urllib3.utilrrr�Zpip._vendor.urllib3.util.retryrZpip._vendor.urllib3.exceptionsrr	r
r�rrr
r�rrrr�rrZmodelsr�compatrrZutilsrrrrrrrZ
structuresrrzr�
exceptionsr r!r"r#r$r%r&Zauthr'Z!pip._vendor.urllib3.contrib.socksr(�ImportErrorr�r�rNr��objectr.rEr+r+r+r,�<module>sF$,site-packages/pip/_vendor/requests/__pycache__/utils.cpython-38.opt-1.pyc000064400000053223151446176770022351 0ustar00U

��.eau�@s�dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlmZddl
mZddlmZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"dd	l#m$Z$dd
l%m&Z&ddl'm(Z(m)Z)m*Z*m+Z+dZ,e�-�Z.d
dd�Z/ej0dk�r2dd�Z1dd�Zdd�Z2dd�Z3dhdd�Z4dd�Z5dd�Z6d d!�Z7d"d#�Z8d$d%�Z9d&d'�Z:did(d)�Z;d*d+�Z<d,d-�Z=d.d/�Z>d0d1�Z?d2d3�Z@d4d5�ZAd6d7�ZBd8d9�ZCeDd:�ZEd;d<�ZFd=d>�ZGd?d@�ZHdAdB�ZIdCdD�ZJdEdF�ZKejLdGdH��ZMdIdJ�ZNdjdKdL�ZOdMdN�ZPdkdPdQ�ZQdRdS�ZRdTdU�ZSdV�TdW�ZUeUdXZVeUdYZWdZd[�ZXd\d]�ZYd^d_�ZZe�[d`�Z\e�[da�Z]dbdc�Z^ddde�Z_dfdg�Z`dS)lz�
requests.utils
~~~~~~~~~~~~~~

This module provides utility functions that are used within Requests
that are also useful for external consumption.
�N���__version__)�certs)�to_native_string)�parse_http_list)�quote�urlparse�bytes�str�OrderedDict�unquote�
getproxies�proxy_bypass�
urlunparse�
basestring�
integer_types�is_py3�proxy_bypass_environment�getproxies_environment�Mapping��cookiejar_from_dict)�CaseInsensitiveDict)�
InvalidURL�
InvalidHeader�FileModeWarning�UnrewindableBodyError)z.netrc�_netrc�Pi�)ZhttpZhttpsZwin32cCs�ztrddl}nddl}Wntk
r0YdSXz6|�|jd�}t|�|d�d�}|�|d�d}Wntk
r~YdSX|r�|s�dS|�	d�}|D]T}|dkr�d|kr�d	S|�
dd
�}|�
dd�}|�
d
d�}t�||tj
�r�d	Sq�dS)NrFz;Software\Microsoft\Windows\CurrentVersion\Internet SettingsZProxyEnableZ
ProxyOverride�;z<local>�.Tz\.�*z.*�?)r�winreg�_winreg�ImportError�OpenKey�HKEY_CURRENT_USER�intZQueryValueEx�OSError�split�replace�re�match�I)�hostr$ZinternetSettingsZproxyEnableZ
proxyOverrideZtest�r1�>/usr/lib/python3.8/site-packages/pip/_vendor/requests/utils.py�proxy_bypass_registry/sF
�����
r3cCst�rt|�St|�SdS)z�Return True, if the host should be bypassed.

        Checks proxy settings gathered from the environment, if specified,
        or the registry.
        N)rrr3)r0r1r1r2rVsrcCst|d�r|��}|S)z/Returns an internal sequence dictionary update.�items)�hasattrr4)�dr1r1r2�dict_to_sequencebs
r7c	Cs4d}d}t|d�rt|�}nbt|d�r.|j}nPt|d�r~z|��}Wntjk
rZYn$Xt�|�j}d|jkr~t	�
dt�t|d��rz|��}Wn$t
tfk
r�|dk	r�|}Yn^Xt|d��r|dk�rz&|�dd	�|��}|�|p�d�Wnt
tfk
�rd}YnX|dk�r&d}td||�S)
Nr�__len__�len�fileno�ba%Requests has determined the content-length for this request using the binary size of the file: however, the file has been opened in text mode (i.e. without the 'b' flag in the mode). This may lead to an incorrect content-length. In Requests 3.0, support will be removed for files in text mode.�tell�seek�)r5r9r:�io�UnsupportedOperation�os�fstat�st_size�mode�warnings�warnrr<r*�IOErrorr=�max)�oZtotal_lengthZcurrent_positionr:r1r1r2�	super_lenksB




�



rJFc	Cs&�zddlm}m}d}tD]J}ztj�d�|��}Wntk
rPYWdSXtj�|�r|}qhq|dkrvWdSt	|�}d}t
|t�r�|�d�}|j
�|�d}	z:||��|	�}
|
r�|
dr�dnd}|
||
dfWWSWn"|tfk
�r|�r��YnXWnttfk
�r YnXdS)	z;Returns the Requests tuple auth for a given url from netrc.r)�netrc�NetrcParseErrorNz~/{}�:�asciirr>)rKrL�NETRC_FILESrA�path�
expanduser�format�KeyError�existsr	�
isinstancer�decode�netlocr+ZauthenticatorsrGr&�AttributeError)�urlZraise_errorsrKrLZ
netrc_path�fZlocZriZsplitstrr0rZlogin_ir1r1r2�get_netrc_auth�s8

r[cCsBt|dd�}|r>t|t�r>|ddkr>|ddkr>tj�|�SdS)z0Tries to guess the filename of the given object.�nameNr�<����>)�getattrrUrrArP�basename)�objr\r1r1r2�guess_filename�s

�rccCs�tj�|�r|Stj�|�\}}|rPtj�|�sPtj�|�\}}d�||g�}q t�|�s^|St�|�}||��krx|St	�
�}tjj|f|�d���}tj�|�s�|j||d�}|S)z�Replace nonexistent paths that look like they refer to a member of a zip
    archive with the location of an extracted copy of the target, or else
    just return the provided path unchanged.
    �/)rP)rArPrTr+�join�zipfileZ
is_zipfileZZipFileZnamelist�tempfileZ
gettempdir�extract)rP�archive�member�prefixZzip_fileZtmpZextracted_pathr1r1r2�extract_zipped_paths�s 

rlcCs.|dkrdSt|ttttf�r&td��t|�S)a�Take an object and test to see if it can be represented as a
    dictionary. Unless it can not be represented as such, return an
    OrderedDict, e.g.,

    ::

        >>> from_key_val_list([('key', 'val')])
        OrderedDict([('key', 'val')])
        >>> from_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples
        >>> from_key_val_list({'key': 'val'})
        OrderedDict([('key', 'val')])

    :rtype: OrderedDict
    N�+cannot encode objects that are not 2-tuples)rUrr
�boolr)�
ValueErrorr��valuer1r1r2�from_key_val_lists
rrcCs@|dkrdSt|ttttf�r&td��t|t�r8|��}t|�S)a�Take an object and test to see if it can be represented as a
    dictionary. If it can be, return a list of tuples, e.g.,

    ::

        >>> to_key_val_list([('key', 'val')])
        [('key', 'val')]
        >>> to_key_val_list({'key': 'val'})
        [('key', 'val')]
        >>> to_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples.

    :rtype: list
    Nrm)	rUrr
rnr)rorr4�listrpr1r1r2�to_key_val_lists
rtcCsXg}t|�D]F}|dd�|dd�kr4dkrHnnt|dd��}|�|�q|S)aParse lists as described by RFC 2068 Section 2.

    In particular, parse comma-separated lists where the elements of
    the list may include quoted-strings.  A quoted-string could
    contain a comma.  A non-quoted string could have quotes in the
    middle.  Quotes are removed automatically after parsing.

    It basically works like :func:`parse_set_header` just that items
    may appear multiple times and case sensitivity is preserved.

    The return value is a standard :class:`list`:

    >>> parse_list_header('token, "quoted value"')
    ['token', 'quoted value']

    To create a header from the :class:`list` again, use the
    :func:`dump_header` function.

    :param value: a string with a list header.
    :return: :class:`list`
    :rtype: list
    Nrr^�")�_parse_list_header�unquote_header_value�append)rq�result�itemr1r1r2�parse_list_header8s(r{cCsxi}t|�D]f}d|kr"d||<q|�dd�\}}|dd�|dd�krVdkrjnnt|dd��}|||<q|S)a^Parse lists of key, value pairs as described by RFC 2068 Section 2 and
    convert them into a python dict:

    >>> d = parse_dict_header('foo="is a fish", bar="as well"')
    >>> type(d) is dict
    True
    >>> sorted(d.items())
    [('bar', 'as well'), ('foo', 'is a fish')]

    If there is no value for a key it will be `None`:

    >>> parse_dict_header('key_without_value')
    {'key_without_value': None}

    To create a header from the :class:`dict` again, use the
    :func:`dump_header` function.

    :param value: a string with a dict header.
    :return: :class:`dict`
    :rtype: dict
    �=Nrr^ru)rvr+rw)rqryrzr\r1r1r2�parse_dict_headerXs(
r}cCs\|rX|d|dkr dkrXnn4|dd�}|rD|dd�dkrX|�dd��d	d�S|S)
z�Unquotes a header value.  (Reversal of :func:`quote_header_value`).
    This does not use the real unquoting but what browsers are actually
    using for quoting.

    :param value: the header value to unquote.
    :rtype: str
    rr^rurNr>z\\�\z\")r,)rqZis_filenamer1r1r2rw{s
$rwcCsi}|D]}|j||j<q|S)z�Returns a key/value dictionary from a CookieJar.

    :param cj: CookieJar object to extract cookies from.
    :rtype: dict
    )rqr\)�cj�cookie_dictZcookier1r1r2�dict_from_cookiejar�sr�cCs
t||�S)z�Returns a CookieJar from a key/value dictionary.

    :param cj: CookieJar to insert cookies into.
    :param cookie_dict: Dict of key/values to insert into CookieJar.
    :rtype: CookieJar
    r)rr�r1r1r2�add_dict_to_cookiejar�sr�cCsTt�dt�tjdtjd�}tjdtjd�}t�d�}|�|�|�|�|�|�S)zlReturns encodings from given content string.

    :param content: bytestring to extract encodings from.
    z�In requests 3.0, get_encodings_from_content will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)z!<meta.*?charset=["\']*(.+?)["\'>])�flagsz+<meta.*?content=["\']*;?charset=(.+?)["\'>]z$^<\?xml.*?encoding=["\']*(.+?)["\'>])rErF�DeprecationWarningr-�compiler/�findall)�contentZ
charset_reZ	pragma_reZxml_rer1r1r2�get_encodings_from_content�s�
��r�c
Cs�|�d�}|d��|dd�}}i}d}|D]`}|��}|r0|d}}|�d�}	|	dkr�|d|	��|�}||	dd��|�}|||��<q0||fS)	z�Returns content type and parameters from given header

    :param header: string
    :return: tuple containing content type and dictionary of
         parameters
    r rrNz"' Tr|r^)r+�strip�find�lower)
�header�tokens�content_type�paramsZparams_dictZitems_to_strip�param�keyrqZindex_of_equalsr1r1r2�_parse_content_type_header�s


r�cCsD|�d�}|sdSt|�\}}d|kr4|d�d�Sd|kr@dSdS)z}Returns encodings from given HTTP Header Dict.

    :param headers: dictionary to extract encoding from.
    :rtype: str
    zcontent-typeN�charsetz'"�textz
ISO-8859-1)�getr�r�)�headersr�r�r1r1r2�get_encoding_from_headers�s
r�ccsj|jdkr|D]
}|VqdSt�|j�dd�}|D]}|�|�}|r4|Vq4|jddd�}|rf|VdS)zStream decodes a iterator.Nr,��errors�T)�final)�encoding�codecs�getincrementaldecoderrV)�iterator�rrz�decoder�chunk�rvr1r1r2�stream_decode_response_unicode�s

r�ccsHd}|dks|dkrt|�}|t|�krD||||�V||7}qdS)z Iterate over slices of a string.rN)r9)�stringZslice_length�posr1r1r2�iter_slicessr�cCs~t�dt�g}t|j�}|rLzt|j|�WStk
rJ|�|�YnXzt|j|dd�WSt	k
rx|jYSXdS)z�Returns the requested content back in unicode.

    :param r: Response object to get unicode content from.

    Tried:

    1. charset from content-type
    2. fall back and replace all unicode characters

    :rtype: str
    z�In requests 3.0, get_unicode_from_response will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)r,r�N)
rErFr�r�r�rr��UnicodeErrorrx�	TypeError)r�Ztried_encodingsr�r1r1r2�get_unicode_from_responses�
r�zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c	Cs�|�d�}tdt|��D]�}||dd�}t|�dkr�|��r�ztt|d��}Wn tk
rrtd|��YnX|tkr�|||dd�||<q�d||||<qd||||<qd�	|�S)	z�Un-escape any percent-escape sequences in a URI that are unreserved
    characters. This leaves all reserved, illegal and non-ASCII bytes encoded.

    :rtype: str
    �%rrr>�z%Invalid percent-escape sequence: '%s'N�)
r+�ranger9�isalnum�chrr)ror�UNRESERVED_SETre)�uri�parts�i�h�cr1r1r2�unquote_unreserved5s
r�cCs@d}d}ztt|�|d�WStk
r:t||d�YSXdS)z�Re-quote the given URI.

    This function passes the given URI through an unquote/quote cycle to
    ensure that it is fully and consistently quoted.

    :rtype: str
    z!#$%&'()*+,/:;=?@[]~z!#$&'()*+,/:;=?@[]~)ZsafeN)rr�r)r�Zsafe_with_percentZsafe_without_percentr1r1r2�requote_uriMsr�cCslt�dt�|��d}|�d�\}}t�dt�tt|����d}t�dt�|��d|@}||@||@kS)z�This function allows you to check if an IP belongs to a network subnet

    Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
             returns False if ip = 192.168.1.1 and net = 192.168.100.0/24

    :rtype: bool
    z=Lrrd)�struct�unpack�socket�	inet_atonr+�dotted_netmaskr))ZipZnetZipaddrZnetaddr�bitsZnetmaskZnetworkr1r1r2�address_in_networkcs
r�cCs&ddd|>dA}t�t�d|��S)z�Converts mask from /xx format to xxx.xxx.xxx.xxx

    Example: if mask is 24 function returns 255.255.255.0

    :rtype: str
    l��r� z>I)r�Z	inet_ntoar��pack)�maskr�r1r1r2r�rsr�cCs,zt�|�Wntjk
r&YdSXdS)z
    :rtype: bool
    FT)r�r��error)Z	string_ipr1r1r2�is_ipv4_address}s
r�cCs�|�d�dkr�zt|�d�d�}Wntk
r:YdSX|dksL|dkrPdSzt�|�d�d�Wq�tjk
r�YdSXndSdS)zV
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    rdrFr�rT)�countr)r+ror�r�r�)Zstring_networkr�r1r1r2�
is_valid_cidr�s
r�c	csT|dk	}|r"tj�|�}|tj|<z
dVW5|rN|dkrDtj|=n
|tj|<XdS)z�Set the environment variable 'env_name' to 'value'

    Save previous value, yield, and then restore the previous value stored in
    the environment variable 'env_name'.

    If 'value' is None, do nothingN)rA�environr�)Zenv_namerqZ
value_changed�	old_valuer1r1r2�set_environ�s


r�c	
Cs*dd�}|}|dkr|d�}t|�}|jdkr2dS|r�dd�|�dd	��d
�D�}t|j�r�|D]0}t|�r�t|j|�r�dSq`|j|kr`dSq`nB|j}|jr�|d�|j�7}|D] }|j�	|�s�|�	|�r�dSq�t
d|��6zt|j�}Wn tt
jfk
�rd}YnXW5QRX|�r&dSdS)
zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    cSstj�|�ptj�|���S�N)rAr�r��upper)�kr1r1r2�<lambda>�r�z'should_bypass_proxies.<locals>.<lambda>N�no_proxyTcss|]}|r|VqdSr�r1)�.0r0r1r1r2�	<genexpr>�sz(should_bypass_proxies.<locals>.<genexpr>� r��,z:{}F)r	�hostnamer,r+r�r�r�ZportrR�endswithr�rr�r�Zgaierror)	rYr�Z	get_proxyZno_proxy_arg�parsedZproxy_ipZhost_with_portr0Zbypassr1r1r2�should_bypass_proxies�s@
�


r�cCst||d�riSt�SdS)zA
    Return a dict of environment proxies.

    :rtype: dict
    )r�N)r�r)rYr�r1r1r2�get_environ_proxies�sr�cCst|pi}t|�}|jdkr.|�|j|�d��S|jd|j|jd|jdg}d}|D]}||krV||}qpqV|S)z�Select a proxy for the url, if applicable.

    :param url: The url being for the request
    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
    N�allz://zall://)r	r�r��scheme)rYZproxiesZurlpartsZ
proxy_keys�proxyZ	proxy_keyr1r1r2�select_proxy�s
�r��python-requestscCsd|tfS)zO
    Return a string representing the default user agent.

    :rtype: str
    z%s/%sr)r\r1r1r2�default_user_agentsr�cCstt�d�d�ddd��S)z9
    :rtype: requests.structures.CaseInsensitiveDict
    z, )ZgzipZdeflatez*/*z
keep-alive)z
User-AgentzAccept-EncodingZAcceptZ
Connection)rr�rer1r1r1r2�default_headers"s�r�c	
Cs�g}d}|�|�}|s|St�d|�D]�}z|�dd�\}}Wntk
r\|d}}YnXd|�d�i}|�d�D]F}z|�d�\}}Wntk
r�Yq�YnX|�|�||�|�<qv|�|�q&|S)	z�Return a list of parsed link headers proxies.

    i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"

    :rtype: list
    z '"z, *<r rr�rYz<> '"r|)r�r-r+rorx)	rqZlinksZ
replace_chars�valrYr��linkr�r�r1r1r2�parse_header_links.s&
r��rNr>�cCs�|dd�}|tjtjfkr dS|dd�tjkr6dS|dd�tjtjfkrRdS|�t�}|dkrhd	S|dkr�|ddd�tkr�d
S|ddd�tkr�dS|dkr�|dd�t	kr�d
S|dd�t	kr�dSdS)z
    :rtype: str
    N�zutf-32r�z	utf-8-sigr>zutf-16rzutf-8z	utf-16-berz	utf-16-lez	utf-32-bez	utf-32-le)
r��BOM_UTF32_LE�BOM_UTF32_BE�BOM_UTF8�BOM_UTF16_LE�BOM_UTF16_BEr��_null�_null2�_null3)�dataZsampleZ	nullcountr1r1r2�guess_json_utfYs*
r�cCs8t||�\}}}}}}|s$||}}t||||||f�S)z�Given a URL that may or may not have a scheme, prepend the given scheme.
    Does not replace a present scheme with the one provided as an argument.

    :rtype: str
    )r	r)rYZ
new_schemer�rWrPr��query�fragmentr1r1r2�prepend_scheme_if_neededys
r�c	CsBt|�}zt|j�t|j�f}Wnttfk
r<d}YnX|S)z{Given a url with authentication components, extract them into a tuple of
    username,password.

    :rtype: (str,str)
    )r�r�)r	r
ZusernameZpasswordrXr�)rYr�Zauthr1r1r2�get_auth_from_url�s
r�s^\S[^\r\n]*$|^$z^\S[^\r\n]*$|^$c	Csf|\}}t|t�rt}nt}z|�|�s4td|��Wn*tk
r`td||t|�f��YnXdS)z�Verifies that header value is a string which doesn't contain
    leading whitespace or return characters. This prevents unintended
    header injection.

    :param header: tuple, in the format (name, value).
    z7Invalid return character or leading space in header: %sz>Value for header {%s: %s} must be of type str or bytes, not %sN)rUr
�_CLEAN_HEADER_REGEX_BYTE�_CLEAN_HEADER_REGEX_STRr.rr��type)r�r\rqZpatr1r1r2�check_header_validity�s

�r�cCsFt|�\}}}}}}|s"||}}|�dd�d}t|||||df�S)zW
    Given a url remove the fragment and the authentication part.

    :rtype: str
    �@rr^r�)r	�rsplitr)rYr�rWrPr�r�r�r1r1r2�
urldefragauth�s

r�c	Cs`t|jdd�}|dk	rTt|jt�rTz||j�Wq\ttfk
rPtd��Yq\Xntd��dS)zfMove file pointer back to its recorded starting position
    so it can be read again on redirect.
    r=Nz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)r`ZbodyrUZ_body_positionrrGr*r)Zprepared_requestZ	body_seekr1r1r2�rewind_body�sr�)F)F)N)r�)a�__doc__r��
contextlibr?rAr-r�r��sysrgrErfrr�rZ_internal_utilsr�compatrrvrr	r
rrr
rrrrrrrrrZcookiesrZ
structuresr�
exceptionsrrrrrO�whereZDEFAULT_CA_BUNDLE_PATHZ
DEFAULT_PORTS�platformr3r7rJr[rcrlrrrtr{r}rwr�r�r�r�r�r�r�r��	frozensetr�r�r�r�r�r�r��contextmanagerr�r�r�r�r�r�r��encoder�r�r�r�r�r�r�r�r�r�r�r�r1r1r1r2�<module>s�D
'	=
3  #

%�
=

	&
 

site-packages/pip/_vendor/requests/__pycache__/auth.cpython-38.pyc000064400000020145151446176770021210 0ustar00U

��.e�'�@s�dZddlZddlZddlZddlZddlZddlZddlmZddl	m
Z
mZmZddl
mZddlmZddlmZd	Zd
Zdd�ZGd
d�de�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)z]
requests.auth
~~~~~~~~~~~~~

This module contains the authentication handlers for Requests.
�N)�	b64encode�)�urlparse�str�
basestring)�extract_cookies_to_jar)�to_native_string)�parse_dict_headerz!application/x-www-form-urlencodedzmultipart/form-datacCs�t|t�s&tjd�|�td�t|�}t|t�sLtjd�|�td�t|�}t|t�r`|�d�}t|t�rt|�d�}dtt	d�
||f�����}|S)zReturns a Basic Auth string.z�Non-string usernames will no longer be supported in Requests 3.0.0. Please convert the object you've passed in ({!r}) to a string or bytes object in the near future to avoid problems.)�categoryz�Non-string passwords will no longer be supported in Requests 3.0.0. Please convert the object you've passed in ({!r}) to a string or bytes object in the near future to avoid problems.�latin1zBasic �:)�
isinstancer�warnings�warn�format�DeprecationWarningr�encoderr�join�strip)�username�passwordZauthstr�r�=/usr/lib/python3.8/site-packages/pip/_vendor/requests/auth.py�_basic_auth_strs0

��
��



�rc@seZdZdZdd�ZdS)�AuthBasez4Base class that all auth implementations derive fromcCstd��dS)NzAuth hooks must be callable.)�NotImplementedError��self�rrrr�__call__KszAuthBase.__call__N��__name__�
__module__�__qualname__�__doc__rrrrrrHsrc@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�
HTTPBasicAuthz?Attaches HTTP Basic Authentication to the given Request object.cCs||_||_dS�N)rr�rrrrrr�__init__RszHTTPBasicAuth.__init__cCs(t|jt|dd�k|jt|dd�kg�S�Nrr��allr�getattrr�r�otherrrr�__eq__Vs�zHTTPBasicAuth.__eq__cCs
||kSr&rr-rrr�__ne__\szHTTPBasicAuth.__ne__cCst|j|j�|jd<|S)N�
Authorization�rrr�headersrrrrr_szHTTPBasicAuth.__call__N)r!r"r#r$r(r/r0rrrrrr%Os
r%c@seZdZdZdd�ZdS)�
HTTPProxyAuthz=Attaches HTTP Proxy Authentication to a given Request object.cCst|j|j�|jd<|S)NzProxy-Authorizationr2rrrrrgszHTTPProxyAuth.__call__Nr rrrrr4dsr4c@sPeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�ZdS)�HTTPDigestAuthz@Attaches HTTP Digest Authentication to the given Request object.cCs||_||_t��|_dSr&)rr�	threadingZlocal�
_thread_localr'rrrr(oszHTTPDigestAuth.__init__cCs@t|jd�s<d|j_d|j_d|j_i|j_d|j_d|j_dS)N�initT�r)�hasattrr7r8�
last_nonce�nonce_count�chal�pos�
num_401_calls)rrrr�init_per_thread_stateusz$HTTPDigestAuth.init_per_thread_statecs�|jjd}|jjd}|jj�d�}|jj�d�}|jj�d�}d�|dkrTd}n|��}|dksl|dkrzd	d
�}	|	�n@|dkr�dd
�}
|
�n*|dkr�dd�}|�n|dkr�dd�}|��fdd�}
�dkr�dSd}t|�}|jp�d}|jr�|d|j7}d|j||jf}d||f}�|�}�|�}||jj	k�rJ|jj
d7_
nd|j_
d|jj
}t|jj
��d�}||�d�7}|t
���d�7}|t�d�7}t�|���dd�}|dk�rЈd|||f�}|�s�|
|d||f�}n<|dk�sd|�d �k�r"d!|||d|f}|
||�}ndS||j_	d"|j||||f}|�rT|d#|7}|�rf|d$|7}|�rx|d%|7}|�r�|d&||f7}d'|S)(z
        :rtype: str
        �realm�nonce�qop�	algorithm�opaqueNZMD5zMD5-SESScSs"t|t�r|�d�}t�|���S�N�utf-8)r
rr�hashlibZmd5�	hexdigest��xrrr�md5_utf8�s

z4HTTPDigestAuth.build_digest_header.<locals>.md5_utf8ZSHAcSs"t|t�r|�d�}t�|���SrF)r
rrrH�sha1rIrJrrr�sha_utf8�s

z4HTTPDigestAuth.build_digest_header.<locals>.sha_utf8zSHA-256cSs"t|t�r|�d�}t�|���SrF)r
rrrHZsha256rIrJrrr�sha256_utf8�s

z7HTTPDigestAuth.build_digest_header.<locals>.sha256_utf8zSHA-512cSs"t|t�r|�d�}t�|���SrF)r
rrrHZsha512rIrJrrr�sha512_utf8�s

z7HTTPDigestAuth.build_digest_header.<locals>.sha512_utf8cs�d||f�S)N�%s:%sr)�s�d�Z	hash_utf8rr�<lambda>��z4HTTPDigestAuth.build_digest_header.<locals>.<lambda>�/�?z%s:%s:%srQrz%08xrG��Zauth�,z%s:%s:%s:%s:%sz>username="%s", realm="%s", nonce="%s", uri="%s", response="%s"z
, opaque="%s"z, algorithm="%s"z
, digest="%s"z , qop="auth", nc=%s, cnonce="%s"z	Digest %s)r7r=�get�upperr�pathZqueryrrr;r<rr�time�ctime�os�urandomrHrMrI�split)r�method�urlrArBrCrDrEZ
_algorithmrLrNrOrPZKDZentdigZp_parsedr^ZA1ZA2ZHA1ZHA2ZncvaluerRZcnonceZrespdigZnoncebit�baserrTr�build_digest_headers�

��z"HTTPDigestAuth.build_digest_headercKs|jrd|j_dS)z)Reset num_401_calls counter on redirects.rN)Zis_redirectr7r?)rr�kwargsrrr�handle_redirect�szHTTPDigestAuth.handle_redirectcKs"d|jkrdks$nd|j_|S|jjdk	rB|jj�|jj�|j�dd�}d|�	�k�r|jjdk�r|jjd7_t
jd	t
jd
�}t
|jd|dd��|j_|j|��|j��}t|j|j|j�|�|j�|�|j|j�|jd<|jj|f|�}|j�|�||_|Sd|j_|S)
zo
        Takes the given response and tries digest-auth, if needed.

        :rtype: requests.Response
        i�i�rNzwww-authenticater9Zdigest�zdigest )�flags)�countr1)Zstatus_coder7r?r>Zrequest�body�seekr3r\�lower�re�compile�
IGNORECASEr	�subr=Zcontent�close�copyrZ_cookies�rawZprepare_cookiesrgrdreZ
connection�send�history�append)rrrhZs_authZpatZprepZ_rrrr�
handle_401�s2	
�
zHTTPDigestAuth.handle_401cCs~|��|jjr&|�|j|j�|jd<z|j��|j_	Wnt
k
rTd|j_	YnX|�d|j�|�d|j
�d|j_|S)Nr1Zresponser)r@r7r;rgrdrer3rm�tellr>�AttributeErrorZ
register_hookrzrir?rrrrrszHTTPDigestAuth.__call__cCs(t|jt|dd�k|jt|dd�kg�Sr)r*r-rrrr/*s�zHTTPDigestAuth.__eq__cCs
||kSr&rr-rrrr00szHTTPDigestAuth.__ne__N)r!r"r#r$r(r@rgrirzrr/r0rrrrr5ls
f,r5)r$rarpr_rHr6r�base64r�compatrrrZcookiesrZ_internal_utilsrZutilsr	ZCONTENT_TYPE_FORM_URLENCODEDZCONTENT_TYPE_MULTI_PARTr�objectrr%r4r5rrrr�<module>s$,site-packages/pip/_vendor/requests/__pycache__/compat.cpython-38.pyc000064400000003050151446176770021526 0ustar00U

��.e��@s�dZddlmZddlZejZeddkZeddkZddlZer�ddl	m
Z
mZmZm
Z
mZmZmZmZmZddlmZmZmZmZmZddlmZddlZdd	lmZdd
lmZddlmZm Z m!Z!m"Z"e#Z$e#Z%e&Z#e'Z'e(e)e*fZ+e(e)fZ,n�e�r�ddl-mZmZmZmZmZm
Z
mZmZm
Z
mZdd
l.mZmZmZmZmZddl/m0Zdd	l1mZdd
l2mZddlm"Z"ddl3mZm Z m!Z!e#Z$e#Z#e%Z%e#e%fZ'e(e*fZ+e(fZ,dS)zq
requests.compat
~~~~~~~~~~~~~~~

This module handles import compatibility issues between Python 2 and
Python 3.
�)�chardetN��)	�quote�unquote�
quote_plus�unquote_plus�	urlencode�
getproxies�proxy_bypass�proxy_bypass_environment�getproxies_environment)�urlparse�
urlunparse�urljoin�urlsplit�	urldefrag)�parse_http_list)�Morsel)�StringIO)�Callable�Mapping�MutableMapping�OrderedDict)
rrrrr	rrrrr)rr
rrr
)�	cookiejar)r)rrr)4�__doc__Zpip._vendorr�sys�version_infoZ_verZis_py2Zis_py3ZjsonZurllibrrrrr	r
rrr
rrrrrZurllib2rZ	cookielibZCookierr�collectionsrrrr�strZbuiltin_str�bytesZunicodeZ
basestring�intZlong�floatZ
numeric_typesZ
integer_typesZurllib.parseZurllib.requestZhttprZhttp.cookies�ioZcollections.abc�r$r$�?/usr/lib/python3.8/site-packages/pip/_vendor/requests/compat.py�<module>sD	,

0site-packages/pip/_vendor/requests/__pycache__/models.cpython-38.pyc000064400000056524151446176770021544 0ustar00U

��.e��@s�dZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZm
Z
mZmZddlmZdd	lmZdd
lmZddlmZddlmZmZmZdd
lmZmZmZm Z m!Z!m"Z"m#Z#ddl$m%Z%m&Z&ddl'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>ddl2m?Z@ddlAmBZBeBjCeBjDeBjEeBjFeBjGfZHdZIdZJdZKGdd�deL�ZMGdd�deL�ZNGdd�deN�ZOGdd�deMeN�ZPGdd�deL�ZQdS) z`
requests.models
~~~~~~~~~~~~~~~

This module contains the primary objects that power Requests.
�N)�RequestField)�encode_multipart_formdata)�	parse_url)�DecodeError�ReadTimeoutError�
ProtocolError�LocationParseError)�UnsupportedOperation�)�
default_hooks)�CaseInsensitiveDict)�
HTTPBasicAuth)�cookiejar_from_dict�get_cookie_header�_copy_cookie_jar)�	HTTPError�
MissingSchema�
InvalidURL�ChunkedEncodingError�ContentDecodingError�ConnectionError�StreamConsumedError)�to_native_string�unicode_is_ascii)
�guess_filename�get_auth_from_url�requote_uri�stream_decode_response_unicode�to_key_val_list�parse_header_links�iter_slices�guess_json_utf�	super_len�check_header_validity)�Callable�Mapping�	cookielib�
urlunparse�urlsplit�	urlencode�str�bytes�is_py2�chardet�builtin_str�
basestring)�json)�codes�i(ic@s0eZdZedd��Zedd��Zedd��ZdS)�RequestEncodingMixincCsNg}t|j�}|j}|sd}|�|�|j}|rD|�d�|�|�d�|�S)zBuild the path URL to use.�/�?�)r(�url�path�append�query�join)�selfr7�pr8r:�r>�?/usr/lib/python3.8/site-packages/pip/_vendor/requests/models.py�path_url=s



zRequestEncodingMixin.path_urlcCs�t|ttf�r|St|d�r |St|d�r�g}t|�D]j\}}t|t�sRt|d�sX|g}|D]B}|dk	r\|�t|t�r�|�d�n|t|t�r�|�d�n|f�q\q6t|dd�S|SdS)z�Encode parameters in a piece of data.

        Will successfully encode parameters when passed as a dict or a list of
        2-tuples. Order is retained if data is a list of 2-tuples but arbitrary
        if parameters are supplied as a dict.
        �read�__iter__N�utf-8T)Zdoseq)	�
isinstancer*r+�hasattrrr/r9�encoder))�data�result�kZvs�vr>r>r?�_encode_paramsRs$	

��z#RequestEncodingMixin._encode_paramscCs�|std��nt|t�r td��g}t|p,i�}t|p8i�}|D]|\}}t|t�s\t|d�sb|g}|D]T}|dk	rft|t�s�t|�}|�t|t�r�|�d�n|t|t�r�|�	d�n|f�qfq@|D]�\}}d}d}	t|t
tf��r t|�dkr�|\}
}n&t|�dk�r|\}
}}n|\}
}}}	nt
|��p,|}
|}t|tttf��rJ|}n(t|d��r`|��}n|dk�rnq�n|}t|||
|	d	�}
|
j|d
�|�|
�q�t|�\}}||fS)a�Build the body for a multipart/form-data request.

        Will successfully encode files when passed as a dict or a list of
        tuples. Order is retained if data is a list of tuples but arbitrary
        if parameters are supplied as a dict.
        The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype)
        or 4-tuples (filename, fileobj, contentype, custom_headers).
        zFiles must be provided.zData must not be a string.rBNrC��rA)�namerG�filename�headers)�content_type)�
ValueErrorrDr/rrEr+r*r9�decoderF�tuple�list�lenr�	bytearrayrArZmake_multipartr)�filesrGZ
new_fieldsZfieldsZfield�valrJrIZftZfh�fn�fpZfdataZrf�bodyrQr>r>r?�
_encode_filesmsT



��


z"RequestEncodingMixin._encode_filesN)�__name__�
__module__�__qualname__�propertyr@�staticmethodrKr]r>r>r>r?r3<s

r3c@seZdZdd�Zdd�ZdS)�RequestHooksMixincCsZ||jkrtd|��t|t�r2|j|�|�n$t|d�rV|j|�dd�|D��dS)zProperly register a hook.z1Unsupported event specified, with event name "%s"rBcss|]}t|t�r|VqdS�N)rDr$)�.0�hr>r>r?�	<genexpr>�s
z2RequestHooksMixin.register_hook.<locals>.<genexpr>N)�hooksrRrDr$r9rE�extend�r<�event�hookr>r>r?�
register_hook�s


zRequestHooksMixin.register_hookcCs2z|j|�|�WdStk
r,YdSXdS)ziDeregister a previously registered hook.
        Returns True if the hook existed, False if not.
        TFN)rh�removerRrjr>r>r?�deregister_hook�s
z!RequestHooksMixin.deregister_hookN)r^r_r`rmror>r>r>r?rc�srcc
@s*eZdZdZd	dd�Zdd�Zdd�ZdS)
�Requesta{A user-created :class:`Request <Request>` object.

    Used to prepare a :class:`PreparedRequest <PreparedRequest>`, which is sent to the server.

    :param method: HTTP method to use.
    :param url: URL to send.
    :param headers: dictionary of headers to send.
    :param files: dictionary of {filename: fileobject} files to multipart upload.
    :param data: the body to attach to the request. If a dictionary or
        list of tuples ``[(key, value)]`` is provided, form-encoding will
        take place.
    :param json: json for the body to attach to the request (if files or data is not specified).
    :param params: URL parameters to append to the URL. If a dictionary or
        list of tuples ``[(key, value)]`` is provided, form-encoding will
        take place.
    :param auth: Auth handler or (user, pass) tuple.
    :param cookies: dictionary or CookieJar of cookies to attach to this request.
    :param hooks: dictionary of callback hooks, for internal usage.

    Usage::

      >>> import requests
      >>> req = requests.Request('GET', 'https://httpbin.org/get')
      >>> req.prepare()
      <PreparedRequest [GET]>
    Nc
Cs�|dkrgn|}|dkrgn|}|dkr,in|}|dkr<in|}|	dkrLin|	}	t�|_t|	���D]\}}|j||d�qd||_||_||_||_||_	|
|_
||_||_||_
dS)N)rkrl)rrhrU�itemsrm�methodr7rPrXrGr0�params�auth�cookies)
r<rrr7rPrXrGrsrtrurhr0rIrJr>r>r?�__init__�s"zRequest.__init__cCs
d|jS)Nz<Request [%s]>�rr�r<r>r>r?�__repr__�szRequest.__repr__cCs<t�}|j|j|j|j|j|j|j|j|j	|j
|jd�
|S)zXConstructs a :class:`PreparedRequest <PreparedRequest>` for transmission and returns it.)
rrr7rPrXrGr0rsrtrurh)�PreparedRequest�preparerrr7rPrXrGr0rsrtrurh�r<r=r>r>r?r{�s�zRequest.prepare)
NNNNNNNNNN)r^r_r`�__doc__rvryr{r>r>r>r?rp�s�
rpc
@s�eZdZdZdd�Zddd�Zdd�Zd	d
�Zdd�Ze	d
d��Z
dd�Zdd�Zddd�Z
dd�Zd dd�Zdd�Zdd�ZdS)!rza�The fully mutable :class:`PreparedRequest <PreparedRequest>` object,
    containing the exact bytes that will be sent to the server.

    Generated from either a :class:`Request <Request>` object or manually.

    Usage::

      >>> import requests
      >>> req = requests.Request('GET', 'https://httpbin.org/get')
      >>> r = req.prepare()
      <PreparedRequest [GET]>

      >>> s = requests.Session()
      >>> s.send(r)
      <Response [200]>
    cCs0d|_d|_d|_d|_d|_t�|_d|_dSrd)rrr7rP�_cookiesr\rrh�_body_positionrxr>r>r?rv"szPreparedRequest.__init__NcCsR|�|�|�||�|�|�|�|�|�|||
�|�||�|�|	�dS)z6Prepares the entire request with the given parameters.N)�prepare_method�prepare_url�prepare_headers�prepare_cookies�prepare_body�prepare_auth�
prepare_hooks)r<rrr7rPrXrGrsrtrurhr0r>r>r?r{3s


zPreparedRequest.preparecCs
d|jS)Nz<PreparedRequest [%s]>rwrxr>r>r?ryEszPreparedRequest.__repr__cCsXt�}|j|_|j|_|jdk	r*|j��nd|_t|j�|_|j|_|j|_|j	|_	|Srd)
rzrrr7rP�copyrr~r\rhrr|r>r>r?r�HszPreparedRequest.copycCs$||_|jdk	r t|j���|_dS)zPrepares the given HTTP method.N)rrr�upper)r<rrr>r>r?r�Ss
zPreparedRequest.prepare_methodcCsDddlm}z|j|dd��d�}Wn|jk
r>t�YnX|S)Nr)�idnaT)Zuts46rC)Zpip._vendorr�rFrSZ	IDNAError�UnicodeError)�hostr�r>r>r?�_get_idna_encoded_hostYs
z&PreparedRequest._get_idna_encoded_hostc
Cs,t|t�r|�d�}ntr"t|�nt|�}|��}d|krR|���d�sR||_	dSzt
|�\}}}}}}}	Wn,tk
r�}
zt|
j
��W5d}
~
XYnX|s�d}|�t|d��}t|��|s�td|��t|��sz|�|�}Wntk
r�td��YnXn|�d��rtd��|�pd	}|�r.|d
7}||7}|�rL|dt|�7}|�sVd}t�r�t|t��rr|�d�}t|t��r�|�d�}t|t��r�|�d�}t|t��r�|�d�}t|	t��r�|	�d�}	t|ttf��r�t|�}|�|�}
|
�r
|�rd
||
f}n|
}tt|||d||	g��}||_	dS)zPrepares the given HTTP URL.�utf8�:ZhttpNzDInvalid URL {0!r}: No schema supplied. Perhaps you meant http://{0}?z Invalid URL %r: No host suppliedzURL has an invalid label.�*r6�@r4rCz%s&%s)rDr+rSr,Zunicoder*�lstrip�lower�
startswithr7rrr�args�formatrrrr�r�rFrKrr')r<r7rsZschemertr�Zportr8r:Zfragment�e�errorZnetlocZ
enc_paramsr>r>r?r�csh








zPreparedRequest.prepare_urlcCs<t�|_|r8|��D]"}t|�|\}}||jt|�<qdS)z Prepares the given HTTP headers.N)rrPrqr#r)r<rP�headerrN�valuer>r>r?r��szPreparedRequest.prepare_headersc
Csrd}d}|s6|dk	r6d}t�|�}t|t�s6|�d�}tt|d�t|ttt	t
f�g�}zt|�}Wntt
tfk
r�d}YnX|r�|}t|dd�dk	r�z|��|_Wn ttfk
r�t�|_YnX|r�td��|r�t|�|jd<n
d|jd	<np|�r|�||�\}}n2|�rB|�|�}t|t��s8t|d
��r>d}nd}|�|�|�rhd|jk�rh||jd
<||_dS)z"Prepares the given HTTP body data.Nzapplication/jsonrCrB�tellz1Streamed bodies and files are mutually exclusive.�Content-LengthZchunkedzTransfer-EncodingrAz!application/x-www-form-urlencodedzcontent-typezContent-Type)�complexjson�dumpsrDr+rF�allrEr/rUrTr%r"�	TypeError�AttributeErrorr	�getattrr�r�IOError�OSError�object�NotImplementedErrorr.rPr]rK�prepare_content_lengthr\)r<rGrXr0r\rQZ	is_stream�lengthr>r>r?r��sL


�



zPreparedRequest.prepare_bodycCsL|dk	r$t|�}|rHt|�|jd<n$|jdkrH|j�d�dkrHd|jd<dS)z>Prepare Content-Length header based on request method and bodyNr�)ZGETZHEAD�0)r"r.rPrr�get)r<r\r�r>r>r?r�	sz&PreparedRequest.prepare_content_lengthr6cCsj|dkr"t|j�}t|�r|nd}|rft|t�rDt|�dkrDt|�}||�}|j�|j�|�	|j
�dS)z"Prepares the given HTTP auth data.NrL)rr7�anyrDrTrVr
�__dict__�updater�r\)r<rtr7Zurl_auth�rr>r>r?r�s
zPreparedRequest.prepare_authcCs@t|tj�r||_n
t|�|_t|j|�}|dk	r<||jd<dS)aPrepares the given HTTP cookie data.

        This function eventually generates a ``Cookie`` header from the
        given cookies using cookielib. Due to cookielib's design, the header
        will not be regenerated if it already exists, meaning this function
        can only be called once for the life of the
        :class:`PreparedRequest <PreparedRequest>` object. Any subsequent calls
        to ``prepare_cookies`` will have no actual effect, unless the "Cookie"
        header is removed beforehand.
        NZCookie)rDr&Z	CookieJarr~rrrP)r<ruZ
cookie_headerr>r>r?r�,s
zPreparedRequest.prepare_cookiescCs&|pg}|D]}|�|||�qdS)zPrepares the given hooks.N)rm)r<rhrkr>r>r?r�@szPreparedRequest.prepare_hooks)
NNNNNNNNNN)N)r6)r^r_r`r}rvr{ryr�r�rbr�r�r�r�r�r�r�r�r>r>r>r?rzs2�

	V
E
rzc
@seZdZdZdddddddd	d
dg
Zdd
�Zdd�Zdd�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
edd��Zed d!��Zed"d#��Zed$d%��Zed&d'��Zd;d*d+�Zed)d,fd-d.�Zed/d0��Zed1d2��Zd3d4�Zed5d6��Zd7d8�Zd9d:�Zd,S)<�ResponsezhThe :class:`Response <Response>` object, which contains a
    server's response to an HTTP request.
    �_content�status_coderPr7�history�encoding�reasonru�elapsed�requestcCs^d|_d|_d|_d|_t�|_d|_d|_d|_g|_	d|_
ti�|_t
�d�|_d|_dS)NFr)r��_content_consumed�_nextr�rrP�rawr7r�r�r�rru�datetimeZ	timedeltar�r�rxr>r>r?rvTs
zResponse.__init__cCs|Srdr>rxr>r>r?�	__enter__�szResponse.__enter__cGs|��dSrd)�close)r<r�r>r>r?�__exit__�szResponse.__exit__cs �js�j�fdd��jD�S)Ncsi|]}|t�|d��qSrd)r�)re�attrrxr>r?�
<dictcomp>�sz)Response.__getstate__.<locals>.<dictcomp>)r��content�	__attrs__rxr>rxr?�__getstate__�szResponse.__getstate__cCs:|��D]\}}t|||�qt|dd�t|dd�dS)Nr�Tr�)rq�setattr)r<�staterNr�r>r>r?�__setstate__�szResponse.__setstate__cCs
d|jS)Nz<Response [%s]>)r�rxr>r>r?ry�szResponse.__repr__cCs|jS�akReturns True if :attr:`status_code` is less than 400.

        This attribute checks if the status code of the response is between
        400 and 600 to see if there was a client error or a server error. If
        the status code, is between 200 and 400, this will return True. This
        is **not** a check to see if the response code is ``200 OK``.
        ��okrxr>r>r?�__bool__�szResponse.__bool__cCs|jSr�r�rxr>r>r?�__nonzero__�szResponse.__nonzero__cCs
|�d�S)z,Allows you to use a response as an iterator.�)�iter_contentrxr>r>r?rB�szResponse.__iter__cCs(z|��Wntk
r"YdSXdS)axReturns True if :attr:`status_code` is less than 400, False if not.

        This attribute checks if the status code of the response is between
        400 and 600 to see if there was a client error or a server error. If
        the status code is between 200 and 400, this will return True. This
        is **not** a check to see if the response code is ``200 OK``.
        FT)�raise_for_statusrrxr>r>r?r��s
	zResponse.okcCsd|jko|jtkS)z�True if this Response is a well-formed HTTP redirect that could have
        been processed automatically (by :meth:`Session.resolve_redirects`).
        �location)rPr��REDIRECT_STATIrxr>r>r?�is_redirect�szResponse.is_redirectcCsd|jko|jtjtjfkS)z@True if this Response one of the permanent versions of redirect.r�)rPr�r1Zmoved_permanently�permanent_redirectrxr>r>r?�is_permanent_redirect�szResponse.is_permanent_redirectcCs|jS)zTReturns a PreparedRequest for the next request in a redirect chain, if there is one.)r�rxr>r>r?�next�sz
Response.nextcCst�|j�dS)z7The apparent encoding, provided by the chardet library.r�)r-Zdetectr�rxr>r>r?�apparent_encoding�szResponse.apparent_encodingr
Fcs|��fdd�}�jr(t�jt�r(t��n"�dk	rJt�t�sJtdt����t�j��}|�}�jrf|n|}|rxt	|��}|S)a�Iterates over the response data.  When stream=True is set on the
        request, this avoids reading the content at once into memory for
        large responses.  The chunk size is the number of bytes it should
        read into memory.  This is not necessarily the length of each item
        returned as decoding can take place.

        chunk_size must be of type int or None. A value of None will
        function differently depending on the value of `stream`.
        stream=True will read data as it arrives in whatever size the
        chunks are received. If stream=False, data is returned as
        a single chunk.

        If decode_unicode is True, content will be decoded using the best
        available encoding based on the response.
        c
3s�t�jd�r�z �jj�dd�D]
}|VqWq�tk
rV}zt|��W5d}~XYq�tk
r~}zt|��W5d}~XYq�tk
r�}zt|��W5d}~XYq�Xn�j�	��}|s�q�|Vq�d�_
dS)N�streamT)Zdecode_content)rEr�r�rrrrrrrAr�)�chunkr���
chunk_sizer<r>r?�generate�sz'Response.iter_content.<locals>.generateNz.chunk_size must be an int, it is instead a %s.)
r�rDr��boolr�intr��typer r)r<r��decode_unicoder�Z
reused_chunksZ
stream_chunksZchunksr>r�r?r��s
zResponse.iter_contentNccs�d}|j||d�D]n}|dk	r&||}|r6|�|�}n|��}|rl|drl|rl|dd|dkrl|��}nd}|D]
}|Vqtq|dk	r�|VdS)z�Iterates over the response data, one line at a time.  When
        stream=True is set on the request, this avoids reading the
        content at once into memory for large responses.

        .. note:: This method is not reentrant safe.
        N)r�r����)r��split�
splitlines�pop)r<r�r�Z	delimiterZpendingr��lines�liner>r>r?�
iter_liness$

zResponse.iter_linescCsV|jdkrJ|jrtd��|jdks,|jdkr4d|_nd�|�t��pFd|_d|_|jS)z"Content of the response, in bytes.Fz2The content for this response was already consumedrN�T)r�r��RuntimeErrorr�r�r;r��CONTENT_CHUNK_SIZErxr>r>r?r�/s
�zResponse.contentc	Cshd}|j}|jstd�S|jdkr(|j}zt|j|dd�}Wn&ttfk
rbt|jdd�}YnX|S)a�Content of the response, in unicode.

        If Response.encoding is None, encoding will be guessed using
        ``chardet``.

        The encoding of the response content is determined based solely on HTTP
        headers, following RFC 2616 to the letter. If you can take advantage of
        non-HTTP knowledge to make a better guess at the encoding, you should
        set ``r.encoding`` appropriately before accessing this property.
        Nr6�replace)�errors)r�r�r*r��LookupErrorr�)r<r�r�r>r>r?�textCs
z
Response.textcKsj|jsZ|jrZt|j�dkrZt|j�}|dk	rZztj|j�|�f|�WStk
rXYnXtj|jf|�S)z�Returns the json-encoded content of a response, if any.

        :param \*\*kwargs: Optional arguments that ``json.loads`` takes.
        :raises ValueError: If the response body does not contain valid json.
        rMN)	r�r�rVr!r��loadsrS�UnicodeDecodeErrorr�)r<�kwargsr�r>r>r?r0is

��z
Response.jsoncCsF|j�d�}i}|rBt|�}|D] }|�d�p6|�d�}|||<q |S)z8Returns the parsed header links of the response, if any.�linkZrelr7)rPr�r)r<r��l�linksr��keyr>r>r?r��s
zResponse.linkscCs�d}t|jt�rDz|j�d�}WqJtk
r@|j�d�}YqJXn|j}d|jkr`dkrxnnd|j||jf}n,d|jkr�dkr�nnd|j||jf}|r�t||d	��d
S)z2Raises stored :class:`HTTPError`, if one occurred.r6rCz
iso-8859-1i�i�z%s Client Error: %s for url: %siXz%s Server Error: %s for url: %s)ZresponseN)rDr�r+rSr�r�r7r)r<Zhttp_error_msgr�r>r>r?r��szResponse.raise_for_statuscCs0|js|j��t|jdd�}|dk	r,|�dS)z�Releases the connection back to the pool. Once this method has been
        called the underlying ``raw`` object must not be accessed again.

        *Note: Should not normally need to be called explicitly.*
        �release_connN)r�r�r�r�)r<r�r>r>r?r��s

zResponse.close)r
F)r^r_r`r}r�rvr�r�r�r�ryr�r�rBrar�r�r�r�r�r��ITER_CHUNK_SIZEr�r�r�r0r�r�r�r>r>r>r?r�JsT�/







7

%
r�)Rr}r��sysZencodings.idnaZ	encodingsZpip._vendor.urllib3.fieldsrZpip._vendor.urllib3.filepostrZpip._vendor.urllib3.utilrZpip._vendor.urllib3.exceptionsrrrr�ior	rhrZ
structuresrrtr
rurrr�
exceptionsrrrrrrrZ_internal_utilsrrZutilsrrrrrrr r!r"r#�compatr$r%r&r'r(r)r*r+r,r-r.r/r0r�Zstatus_codesr1Zmoved�found�otherZtemporary_redirectr�r�ZDEFAULT_REDIRECT_LIMITr�r�r�r3rcrprzr�r>r>r>r?�<module>sD$08�rJ<site-packages/pip/_vendor/requests/__pycache__/models.cpython-38.opt-1.pyc000064400000056524151446176770022503 0ustar00U

��.e��@s�dZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZm
Z
mZmZddlmZdd	lmZdd
lmZddlmZddlmZmZmZdd
lmZmZmZm Z m!Z!m"Z"m#Z#ddl$m%Z%m&Z&ddl'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>ddl2m?Z@ddlAmBZBeBjCeBjDeBjEeBjFeBjGfZHdZIdZJdZKGdd�deL�ZMGdd�deL�ZNGdd�deN�ZOGdd�deMeN�ZPGdd�deL�ZQdS) z`
requests.models
~~~~~~~~~~~~~~~

This module contains the primary objects that power Requests.
�N)�RequestField)�encode_multipart_formdata)�	parse_url)�DecodeError�ReadTimeoutError�
ProtocolError�LocationParseError)�UnsupportedOperation�)�
default_hooks)�CaseInsensitiveDict)�
HTTPBasicAuth)�cookiejar_from_dict�get_cookie_header�_copy_cookie_jar)�	HTTPError�
MissingSchema�
InvalidURL�ChunkedEncodingError�ContentDecodingError�ConnectionError�StreamConsumedError)�to_native_string�unicode_is_ascii)
�guess_filename�get_auth_from_url�requote_uri�stream_decode_response_unicode�to_key_val_list�parse_header_links�iter_slices�guess_json_utf�	super_len�check_header_validity)�Callable�Mapping�	cookielib�
urlunparse�urlsplit�	urlencode�str�bytes�is_py2�chardet�builtin_str�
basestring)�json)�codes�i(ic@s0eZdZedd��Zedd��Zedd��ZdS)�RequestEncodingMixincCsNg}t|j�}|j}|sd}|�|�|j}|rD|�d�|�|�d�|�S)zBuild the path URL to use.�/�?�)r(�url�path�append�query�join)�selfr7�pr8r:�r>�?/usr/lib/python3.8/site-packages/pip/_vendor/requests/models.py�path_url=s



zRequestEncodingMixin.path_urlcCs�t|ttf�r|St|d�r |St|d�r�g}t|�D]j\}}t|t�sRt|d�sX|g}|D]B}|dk	r\|�t|t�r�|�d�n|t|t�r�|�d�n|f�q\q6t|dd�S|SdS)z�Encode parameters in a piece of data.

        Will successfully encode parameters when passed as a dict or a list of
        2-tuples. Order is retained if data is a list of 2-tuples but arbitrary
        if parameters are supplied as a dict.
        �read�__iter__N�utf-8T)Zdoseq)	�
isinstancer*r+�hasattrrr/r9�encoder))�data�result�kZvs�vr>r>r?�_encode_paramsRs$	

��z#RequestEncodingMixin._encode_paramscCs�|std��nt|t�r td��g}t|p,i�}t|p8i�}|D]|\}}t|t�s\t|d�sb|g}|D]T}|dk	rft|t�s�t|�}|�t|t�r�|�d�n|t|t�r�|�	d�n|f�qfq@|D]�\}}d}d}	t|t
tf��r t|�dkr�|\}
}n&t|�dk�r|\}
}}n|\}
}}}	nt
|��p,|}
|}t|tttf��rJ|}n(t|d��r`|��}n|dk�rnq�n|}t|||
|	d	�}
|
j|d
�|�|
�q�t|�\}}||fS)a�Build the body for a multipart/form-data request.

        Will successfully encode files when passed as a dict or a list of
        tuples. Order is retained if data is a list of tuples but arbitrary
        if parameters are supplied as a dict.
        The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype)
        or 4-tuples (filename, fileobj, contentype, custom_headers).
        zFiles must be provided.zData must not be a string.rBNrC��rA)�namerG�filename�headers)�content_type)�
ValueErrorrDr/rrEr+r*r9�decoderF�tuple�list�lenr�	bytearrayrArZmake_multipartr)�filesrGZ
new_fieldsZfieldsZfield�valrJrIZftZfh�fn�fpZfdataZrf�bodyrQr>r>r?�
_encode_filesmsT



��


z"RequestEncodingMixin._encode_filesN)�__name__�
__module__�__qualname__�propertyr@�staticmethodrKr]r>r>r>r?r3<s

r3c@seZdZdd�Zdd�ZdS)�RequestHooksMixincCsZ||jkrtd|��t|t�r2|j|�|�n$t|d�rV|j|�dd�|D��dS)zProperly register a hook.z1Unsupported event specified, with event name "%s"rBcss|]}t|t�r|VqdS�N)rDr$)�.0�hr>r>r?�	<genexpr>�s
z2RequestHooksMixin.register_hook.<locals>.<genexpr>N)�hooksrRrDr$r9rE�extend�r<�event�hookr>r>r?�
register_hook�s


zRequestHooksMixin.register_hookcCs2z|j|�|�WdStk
r,YdSXdS)ziDeregister a previously registered hook.
        Returns True if the hook existed, False if not.
        TFN)rh�removerRrjr>r>r?�deregister_hook�s
z!RequestHooksMixin.deregister_hookN)r^r_r`rmror>r>r>r?rc�srcc
@s*eZdZdZd	dd�Zdd�Zdd�ZdS)
�Requesta{A user-created :class:`Request <Request>` object.

    Used to prepare a :class:`PreparedRequest <PreparedRequest>`, which is sent to the server.

    :param method: HTTP method to use.
    :param url: URL to send.
    :param headers: dictionary of headers to send.
    :param files: dictionary of {filename: fileobject} files to multipart upload.
    :param data: the body to attach to the request. If a dictionary or
        list of tuples ``[(key, value)]`` is provided, form-encoding will
        take place.
    :param json: json for the body to attach to the request (if files or data is not specified).
    :param params: URL parameters to append to the URL. If a dictionary or
        list of tuples ``[(key, value)]`` is provided, form-encoding will
        take place.
    :param auth: Auth handler or (user, pass) tuple.
    :param cookies: dictionary or CookieJar of cookies to attach to this request.
    :param hooks: dictionary of callback hooks, for internal usage.

    Usage::

      >>> import requests
      >>> req = requests.Request('GET', 'https://httpbin.org/get')
      >>> req.prepare()
      <PreparedRequest [GET]>
    Nc
Cs�|dkrgn|}|dkrgn|}|dkr,in|}|dkr<in|}|	dkrLin|	}	t�|_t|	���D]\}}|j||d�qd||_||_||_||_||_	|
|_
||_||_||_
dS)N)rkrl)rrhrU�itemsrm�methodr7rPrXrGr0�params�auth�cookies)
r<rrr7rPrXrGrsrtrurhr0rIrJr>r>r?�__init__�s"zRequest.__init__cCs
d|jS)Nz<Request [%s]>�rr�r<r>r>r?�__repr__�szRequest.__repr__cCs<t�}|j|j|j|j|j|j|j|j|j	|j
|jd�
|S)zXConstructs a :class:`PreparedRequest <PreparedRequest>` for transmission and returns it.)
rrr7rPrXrGr0rsrtrurh)�PreparedRequest�preparerrr7rPrXrGr0rsrtrurh�r<r=r>r>r?r{�s�zRequest.prepare)
NNNNNNNNNN)r^r_r`�__doc__rvryr{r>r>r>r?rp�s�
rpc
@s�eZdZdZdd�Zddd�Zdd�Zd	d
�Zdd�Ze	d
d��Z
dd�Zdd�Zddd�Z
dd�Zd dd�Zdd�Zdd�ZdS)!rza�The fully mutable :class:`PreparedRequest <PreparedRequest>` object,
    containing the exact bytes that will be sent to the server.

    Generated from either a :class:`Request <Request>` object or manually.

    Usage::

      >>> import requests
      >>> req = requests.Request('GET', 'https://httpbin.org/get')
      >>> r = req.prepare()
      <PreparedRequest [GET]>

      >>> s = requests.Session()
      >>> s.send(r)
      <Response [200]>
    cCs0d|_d|_d|_d|_d|_t�|_d|_dSrd)rrr7rP�_cookiesr\rrh�_body_positionrxr>r>r?rv"szPreparedRequest.__init__NcCsR|�|�|�||�|�|�|�|�|�|||
�|�||�|�|	�dS)z6Prepares the entire request with the given parameters.N)�prepare_method�prepare_url�prepare_headers�prepare_cookies�prepare_body�prepare_auth�
prepare_hooks)r<rrr7rPrXrGrsrtrurhr0r>r>r?r{3s


zPreparedRequest.preparecCs
d|jS)Nz<PreparedRequest [%s]>rwrxr>r>r?ryEszPreparedRequest.__repr__cCsXt�}|j|_|j|_|jdk	r*|j��nd|_t|j�|_|j|_|j|_|j	|_	|Srd)
rzrrr7rP�copyrr~r\rhrr|r>r>r?r�HszPreparedRequest.copycCs$||_|jdk	r t|j���|_dS)zPrepares the given HTTP method.N)rrr�upper)r<rrr>r>r?r�Ss
zPreparedRequest.prepare_methodcCsDddlm}z|j|dd��d�}Wn|jk
r>t�YnX|S)Nr)�idnaT)Zuts46rC)Zpip._vendorr�rFrSZ	IDNAError�UnicodeError)�hostr�r>r>r?�_get_idna_encoded_hostYs
z&PreparedRequest._get_idna_encoded_hostc
Cs,t|t�r|�d�}ntr"t|�nt|�}|��}d|krR|���d�sR||_	dSzt
|�\}}}}}}}	Wn,tk
r�}
zt|
j
��W5d}
~
XYnX|s�d}|�t|d��}t|��|s�td|��t|��sz|�|�}Wntk
r�td��YnXn|�d��rtd��|�pd	}|�r.|d
7}||7}|�rL|dt|�7}|�sVd}t�r�t|t��rr|�d�}t|t��r�|�d�}t|t��r�|�d�}t|t��r�|�d�}t|	t��r�|	�d�}	t|ttf��r�t|�}|�|�}
|
�r
|�rd
||
f}n|
}tt|||d||	g��}||_	dS)zPrepares the given HTTP URL.�utf8�:ZhttpNzDInvalid URL {0!r}: No schema supplied. Perhaps you meant http://{0}?z Invalid URL %r: No host suppliedzURL has an invalid label.�*r6�@r4rCz%s&%s)rDr+rSr,Zunicoder*�lstrip�lower�
startswithr7rrr�args�formatrrrr�r�rFrKrr')r<r7rsZschemertr�Zportr8r:Zfragment�e�errorZnetlocZ
enc_paramsr>r>r?r�csh








zPreparedRequest.prepare_urlcCs<t�|_|r8|��D]"}t|�|\}}||jt|�<qdS)z Prepares the given HTTP headers.N)rrPrqr#r)r<rP�headerrN�valuer>r>r?r��szPreparedRequest.prepare_headersc
Csrd}d}|s6|dk	r6d}t�|�}t|t�s6|�d�}tt|d�t|ttt	t
f�g�}zt|�}Wntt
tfk
r�d}YnX|r�|}t|dd�dk	r�z|��|_Wn ttfk
r�t�|_YnX|r�td��|r�t|�|jd<n
d|jd	<np|�r|�||�\}}n2|�rB|�|�}t|t��s8t|d
��r>d}nd}|�|�|�rhd|jk�rh||jd
<||_dS)z"Prepares the given HTTP body data.Nzapplication/jsonrCrB�tellz1Streamed bodies and files are mutually exclusive.�Content-LengthZchunkedzTransfer-EncodingrAz!application/x-www-form-urlencodedzcontent-typezContent-Type)�complexjson�dumpsrDr+rF�allrEr/rUrTr%r"�	TypeError�AttributeErrorr	�getattrr�r�IOError�OSError�object�NotImplementedErrorr.rPr]rK�prepare_content_lengthr\)r<rGrXr0r\rQZ	is_stream�lengthr>r>r?r��sL


�



zPreparedRequest.prepare_bodycCsL|dk	r$t|�}|rHt|�|jd<n$|jdkrH|j�d�dkrHd|jd<dS)z>Prepare Content-Length header based on request method and bodyNr�)ZGETZHEAD�0)r"r.rPrr�get)r<r\r�r>r>r?r�	sz&PreparedRequest.prepare_content_lengthr6cCsj|dkr"t|j�}t|�r|nd}|rft|t�rDt|�dkrDt|�}||�}|j�|j�|�	|j
�dS)z"Prepares the given HTTP auth data.NrL)rr7�anyrDrTrVr
�__dict__�updater�r\)r<rtr7Zurl_auth�rr>r>r?r�s
zPreparedRequest.prepare_authcCs@t|tj�r||_n
t|�|_t|j|�}|dk	r<||jd<dS)aPrepares the given HTTP cookie data.

        This function eventually generates a ``Cookie`` header from the
        given cookies using cookielib. Due to cookielib's design, the header
        will not be regenerated if it already exists, meaning this function
        can only be called once for the life of the
        :class:`PreparedRequest <PreparedRequest>` object. Any subsequent calls
        to ``prepare_cookies`` will have no actual effect, unless the "Cookie"
        header is removed beforehand.
        NZCookie)rDr&Z	CookieJarr~rrrP)r<ruZ
cookie_headerr>r>r?r�,s
zPreparedRequest.prepare_cookiescCs&|pg}|D]}|�|||�qdS)zPrepares the given hooks.N)rm)r<rhrkr>r>r?r�@szPreparedRequest.prepare_hooks)
NNNNNNNNNN)N)r6)r^r_r`r}rvr{ryr�r�rbr�r�r�r�r�r�r�r�r>r>r>r?rzs2�

	V
E
rzc
@seZdZdZdddddddd	d
dg
Zdd
�Zdd�Zdd�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
edd��Zed d!��Zed"d#��Zed$d%��Zed&d'��Zd;d*d+�Zed)d,fd-d.�Zed/d0��Zed1d2��Zd3d4�Zed5d6��Zd7d8�Zd9d:�Zd,S)<�ResponsezhThe :class:`Response <Response>` object, which contains a
    server's response to an HTTP request.
    �_content�status_coderPr7�history�encoding�reasonru�elapsed�requestcCs^d|_d|_d|_d|_t�|_d|_d|_d|_g|_	d|_
ti�|_t
�d�|_d|_dS)NFr)r��_content_consumed�_nextr�rrP�rawr7r�r�r�rru�datetimeZ	timedeltar�r�rxr>r>r?rvTs
zResponse.__init__cCs|Srdr>rxr>r>r?�	__enter__�szResponse.__enter__cGs|��dSrd)�close)r<r�r>r>r?�__exit__�szResponse.__exit__cs �js�j�fdd��jD�S)Ncsi|]}|t�|d��qSrd)r�)re�attrrxr>r?�
<dictcomp>�sz)Response.__getstate__.<locals>.<dictcomp>)r��content�	__attrs__rxr>rxr?�__getstate__�szResponse.__getstate__cCs:|��D]\}}t|||�qt|dd�t|dd�dS)Nr�Tr�)rq�setattr)r<�staterNr�r>r>r?�__setstate__�szResponse.__setstate__cCs
d|jS)Nz<Response [%s]>)r�rxr>r>r?ry�szResponse.__repr__cCs|jS�akReturns True if :attr:`status_code` is less than 400.

        This attribute checks if the status code of the response is between
        400 and 600 to see if there was a client error or a server error. If
        the status code, is between 200 and 400, this will return True. This
        is **not** a check to see if the response code is ``200 OK``.
        ��okrxr>r>r?�__bool__�szResponse.__bool__cCs|jSr�r�rxr>r>r?�__nonzero__�szResponse.__nonzero__cCs
|�d�S)z,Allows you to use a response as an iterator.�)�iter_contentrxr>r>r?rB�szResponse.__iter__cCs(z|��Wntk
r"YdSXdS)axReturns True if :attr:`status_code` is less than 400, False if not.

        This attribute checks if the status code of the response is between
        400 and 600 to see if there was a client error or a server error. If
        the status code is between 200 and 400, this will return True. This
        is **not** a check to see if the response code is ``200 OK``.
        FT)�raise_for_statusrrxr>r>r?r��s
	zResponse.okcCsd|jko|jtkS)z�True if this Response is a well-formed HTTP redirect that could have
        been processed automatically (by :meth:`Session.resolve_redirects`).
        �location)rPr��REDIRECT_STATIrxr>r>r?�is_redirect�szResponse.is_redirectcCsd|jko|jtjtjfkS)z@True if this Response one of the permanent versions of redirect.r�)rPr�r1Zmoved_permanently�permanent_redirectrxr>r>r?�is_permanent_redirect�szResponse.is_permanent_redirectcCs|jS)zTReturns a PreparedRequest for the next request in a redirect chain, if there is one.)r�rxr>r>r?�next�sz
Response.nextcCst�|j�dS)z7The apparent encoding, provided by the chardet library.r�)r-Zdetectr�rxr>r>r?�apparent_encoding�szResponse.apparent_encodingr
Fcs|��fdd�}�jr(t�jt�r(t��n"�dk	rJt�t�sJtdt����t�j��}|�}�jrf|n|}|rxt	|��}|S)a�Iterates over the response data.  When stream=True is set on the
        request, this avoids reading the content at once into memory for
        large responses.  The chunk size is the number of bytes it should
        read into memory.  This is not necessarily the length of each item
        returned as decoding can take place.

        chunk_size must be of type int or None. A value of None will
        function differently depending on the value of `stream`.
        stream=True will read data as it arrives in whatever size the
        chunks are received. If stream=False, data is returned as
        a single chunk.

        If decode_unicode is True, content will be decoded using the best
        available encoding based on the response.
        c
3s�t�jd�r�z �jj�dd�D]
}|VqWq�tk
rV}zt|��W5d}~XYq�tk
r~}zt|��W5d}~XYq�tk
r�}zt|��W5d}~XYq�Xn�j�	��}|s�q�|Vq�d�_
dS)N�streamT)Zdecode_content)rEr�r�rrrrrrrAr�)�chunkr���
chunk_sizer<r>r?�generate�sz'Response.iter_content.<locals>.generateNz.chunk_size must be an int, it is instead a %s.)
r�rDr��boolr�intr��typer r)r<r��decode_unicoder�Z
reused_chunksZ
stream_chunksZchunksr>r�r?r��s
zResponse.iter_contentNccs�d}|j||d�D]n}|dk	r&||}|r6|�|�}n|��}|rl|drl|rl|dd|dkrl|��}nd}|D]
}|Vqtq|dk	r�|VdS)z�Iterates over the response data, one line at a time.  When
        stream=True is set on the request, this avoids reading the
        content at once into memory for large responses.

        .. note:: This method is not reentrant safe.
        N)r�r����)r��split�
splitlines�pop)r<r�r�Z	delimiterZpendingr��lines�liner>r>r?�
iter_liness$

zResponse.iter_linescCsV|jdkrJ|jrtd��|jdks,|jdkr4d|_nd�|�t��pFd|_d|_|jS)z"Content of the response, in bytes.Fz2The content for this response was already consumedrN�T)r�r��RuntimeErrorr�r�r;r��CONTENT_CHUNK_SIZErxr>r>r?r�/s
�zResponse.contentc	Cshd}|j}|jstd�S|jdkr(|j}zt|j|dd�}Wn&ttfk
rbt|jdd�}YnX|S)a�Content of the response, in unicode.

        If Response.encoding is None, encoding will be guessed using
        ``chardet``.

        The encoding of the response content is determined based solely on HTTP
        headers, following RFC 2616 to the letter. If you can take advantage of
        non-HTTP knowledge to make a better guess at the encoding, you should
        set ``r.encoding`` appropriately before accessing this property.
        Nr6�replace)�errors)r�r�r*r��LookupErrorr�)r<r�r�r>r>r?�textCs
z
Response.textcKsj|jsZ|jrZt|j�dkrZt|j�}|dk	rZztj|j�|�f|�WStk
rXYnXtj|jf|�S)z�Returns the json-encoded content of a response, if any.

        :param \*\*kwargs: Optional arguments that ``json.loads`` takes.
        :raises ValueError: If the response body does not contain valid json.
        rMN)	r�r�rVr!r��loadsrS�UnicodeDecodeErrorr�)r<�kwargsr�r>r>r?r0is

��z
Response.jsoncCsF|j�d�}i}|rBt|�}|D] }|�d�p6|�d�}|||<q |S)z8Returns the parsed header links of the response, if any.�linkZrelr7)rPr�r)r<r��l�linksr��keyr>r>r?r��s
zResponse.linkscCs�d}t|jt�rDz|j�d�}WqJtk
r@|j�d�}YqJXn|j}d|jkr`dkrxnnd|j||jf}n,d|jkr�dkr�nnd|j||jf}|r�t||d	��d
S)z2Raises stored :class:`HTTPError`, if one occurred.r6rCz
iso-8859-1i�i�z%s Client Error: %s for url: %siXz%s Server Error: %s for url: %s)ZresponseN)rDr�r+rSr�r�r7r)r<Zhttp_error_msgr�r>r>r?r��szResponse.raise_for_statuscCs0|js|j��t|jdd�}|dk	r,|�dS)z�Releases the connection back to the pool. Once this method has been
        called the underlying ``raw`` object must not be accessed again.

        *Note: Should not normally need to be called explicitly.*
        �release_connN)r�r�r�r�)r<r�r>r>r?r��s

zResponse.close)r
F)r^r_r`r}r�rvr�r�r�r�ryr�r�rBrar�r�r�r�r�r��ITER_CHUNK_SIZEr�r�r�r0r�r�r�r>r>r>r?r�JsT�/







7

%
r�)Rr}r��sysZencodings.idnaZ	encodingsZpip._vendor.urllib3.fieldsrZpip._vendor.urllib3.filepostrZpip._vendor.urllib3.utilrZpip._vendor.urllib3.exceptionsrrrr�ior	rhrZ
structuresrrtr
rurrr�
exceptionsrrrrrrrZ_internal_utilsrrZutilsrrrrrrr r!r"r#�compatr$r%r&r'r(r)r*r+r,r-r.r/r0r�Zstatus_codesr1Zmoved�found�otherZtemporary_redirectr�r�ZDEFAULT_REDIRECT_LIMITr�r�r�r3rcrprzr�r>r>r>r?�<module>sD$08�rJ<site-packages/pip/_vendor/requests/__pycache__/certs.cpython-38.pyc000064400000001125151446176770021364 0ustar00U

��.e��@s&dZddlmZedkr"ee��dS)uF
requests.certs
~~~~~~~~~~~~~~

This module returns the preferred default CA certificate bundle. There is
only one — the one from the certifi package.

If you are packaging Requests, e.g., for a Linux distribution or a managed
environment, you can change the definition of where() to return a separately
packaged CA bundle.
�)�where�__main__N)�__doc__Zpip._vendor.certifir�__name__�print�rr�>/usr/lib/python3.8/site-packages/pip/_vendor/requests/certs.py�<module>ssite-packages/pip/_vendor/requests/__pycache__/status_codes.cpython-38.opt-1.pyc000064400000010070151446176770023702 0ustar00U

��.e!�E@s�daddlmZddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdG�DZedHdI�ZdJdK�Ze�dLS)Ma�
The ``codes`` object defines a mapping from common names for HTTP statuses
to their numerical codes, accessible either as attributes or as dictionary
items.

>>> requests.codes['temporary_redirect']
307
>>> requests.codes.teapot
418
>>> requests.codes['\o/']
200

Some codes have multiple names, and both upper- and lower-case versions of
the names are allowed. For example, ``codes.ok``, ``codes.OK``, and
``codes.okay`` all correspond to the HTTP status code 200.
�)�
LookupDict)�continue)Zswitching_protocols)Z
processing)Z
checkpoint)Zuri_too_longZrequest_uri_too_long)�okZokayZall_okZall_okayZall_goodz\o/u✓)Zcreated)Zaccepted)Znon_authoritative_infoZnon_authoritative_information)Z
no_content)Z
reset_content�reset)Zpartial_content�partial)Zmulti_statusZmultiple_statusZmulti_statiZmultiple_stati)Zalready_reported)Zim_used)Zmultiple_choices)Zmoved_permanentlyZmovedz\o-)�found)Z	see_other�other)Znot_modified)Z	use_proxy)Zswitch_proxy)Ztemporary_redirectZtemporary_movedZ	temporary)Zpermanent_redirectZresume_incompleteZresume)Zbad_requestZbad)Zunauthorized)Zpayment_requiredZpayment)Z	forbidden)Z	not_foundz-o-)Zmethod_not_allowedZnot_allowed)Znot_acceptable)Zproxy_authentication_requiredZ
proxy_authZproxy_authentication)Zrequest_timeoutZtimeout)Zconflict)Zgone)Zlength_required)Zprecondition_failed�precondition)Zrequest_entity_too_large)Zrequest_uri_too_large)Zunsupported_media_typeZunsupported_mediaZ
media_type)Zrequested_range_not_satisfiableZrequested_rangeZrange_not_satisfiable)Zexpectation_failed)Zim_a_teapotZteapotZ
i_am_a_teapot)Zmisdirected_request)Zunprocessable_entityZ
unprocessable)�locked)Zfailed_dependencyZ
dependency)Zunordered_collectionZ	unordered)Zupgrade_requiredZupgrade)Zprecondition_requiredr	)Ztoo_many_requestsZtoo_many)Zheader_fields_too_largeZfields_too_large)Zno_responseZnone)Z
retry_withZretry)Z$blocked_by_windows_parental_controlsZparental_controls)Zunavailable_for_legal_reasonsZ
legal_reasons)Zclient_closed_request)Zinternal_server_errorZserver_errorz/o\u✗)Znot_implemented)Zbad_gateway)Zservice_unavailableZunavailable)Zgateway_timeout)Zhttp_version_not_supportedZhttp_version)Zvariant_also_negotiates)Zinsufficient_storage)Zbandwidth_limit_exceededZ	bandwidth)Znot_extended)Znetwork_authentication_requiredZnetwork_authZnetwork_authentication)D�d�e�f�g�z��������������������i,i-i.i/i0i1i2i3i4i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�Zstatus_codes)�namecs~t��D]8\}}|D]*}tt||�|�d�stt|��|�qqdd��tdk	rvtdd��fdd�tt�D��ndadS)N)�\�/cSs$d�dd�t|D��}d||fS)Nz, css|]}d|VqdS)z``%s``N�)�.0�nrr�E/usr/lib/python3.8/site-packages/pip/_vendor/requests/status_codes.py�	<genexpr>psz%_init.<locals>.doc.<locals>.<genexpr>z* %d: %s)�join�_codes)�code�namesrrr �docosz_init.<locals>.doc�
c3s|]}�|�VqdS)Nr)rr$�r&rr r!usz_init.<locals>.<genexpr>)	r#�items�setattr�codes�
startswith�upper�__doc__r"�sorted)r$Ztitles�titlerr(r �_iniths
���r1N)r.Z
structuresrr#r+r1rrrr �<module>s��P
site-packages/pip/_vendor/requests/__pycache__/help.cpython-38.pyc000064400000005206151446176770021200 0ustar00U

��.e�
�@s�dZddlmZddlZddlZddlZddlZddlmZddlm	Z	ddlm
Z
ddlmZ
zdd	lmZWn ek
r�dZdZdZYnXddlZddlZd
d�Zdd
�Zdd�Zedkr�e�dS)z'Module containing bug report helper(s).�)�print_functionN)�idna)�urllib3)�chardet�)�__version__)�	pyopensslcCs�t��}|dkrt��}nj|dkr\dtjjtjjtjjf}tjjdkr�d�	|tjjg�}n(|dkrnt��}n|dkr�t��}nd}||d	�S)
a�Return a dict with the Python implementation and version.

    Provide both the name and the version of the Python implementation
    currently running. For example, on CPython 2.7.5 it will return
    {'name': 'CPython', 'version': '2.7.5'}.

    This function works best on CPython and PyPy: in particular, it probably
    doesn't work for Jython or IronPython. Future investigation should be done
    to work out the correct shape of the code for those platforms.
    ZCPythonZPyPyz%s.%s.%s�final�ZJythonZ
IronPython�Unknown)�name�version)
�platformZpython_implementationZpython_version�sysZpypy_version_info�major�minor�micro�releaselevel�join)�implementationZimplementation_version�r�=/usr/lib/python3.8/site-packages/pip/_vendor/requests/help.py�_implementations&
��

rc	Cs�zt��t��d�}Wntk
r4ddd�}YnXt�}dtji}dtji}ddd�}trrtjdtj	j
d�}dttdd�i}dtt
dd�i}tj
}d|dk	r�d|ndi}|||tdk	|||||dtid	�
S)
z&Generate information for a bug report.)�system�releaserr
Nr
)r
Zopenssl_versionz%xr)
rr�
system_sslZusing_pyopensslZ	pyOpenSSLrr�cryptographyrZrequests)rrr�IOErrorrrrr�OpenSSLZSSLZOPENSSL_VERSION_NUMBER�getattrrr�sslr�requests_version)	Z
platform_infoZimplementation_infoZurllib3_infoZchardet_infoZpyopenssl_infoZcryptography_infoZ	idna_inforZsystem_ssl_inforrr�info;sR�
�

�
�
�
����r"cCsttjt�ddd��dS)z)Pretty-print the bug information as JSON.T�)Z	sort_keys�indentN)�print�json�dumpsr"rrrr�mainqsr(�__main__)�__doc__Z
__future__rr&rrr Zpip._vendorrrrr
rr!Zpip._vendor.urllib3.contribr�ImportErrorrrrr"r(�__name__rrrr�<module>s,
!6site-packages/pip/_vendor/requests/__pycache__/certs.cpython-38.opt-1.pyc000064400000001125151446176770022323 0ustar00U

��.e��@s&dZddlmZedkr"ee��dS)uF
requests.certs
~~~~~~~~~~~~~~

This module returns the preferred default CA certificate bundle. There is
only one — the one from the certifi package.

If you are packaging Requests, e.g., for a Linux distribution or a managed
environment, you can change the definition of where() to return a separately
packaged CA bundle.
�)�where�__main__N)�__doc__Zpip._vendor.certifir�__name__�print�rr�>/usr/lib/python3.8/site-packages/pip/_vendor/requests/certs.py�<module>ssite-packages/pip/_vendor/requests/__pycache__/exceptions.cpython-38.pyc000064400000012130151446176770022423 0ustar00U

��.e}�@s�dZddlmZGdd�de�ZGdd�de�ZGdd�de�ZGd	d
�d
e�ZGdd�de�ZGd
d�de�Z	Gdd�dee	�Z
Gdd�de	�ZGdd�de�ZGdd�de�Z
Gdd�dee�ZGdd�dee�ZGdd�dee�ZGdd�dee�ZGdd �d e�ZGd!d"�d"e�ZGd#d$�d$ee�ZGd%d&�d&ee�ZGd'd(�d(e�ZGd)d*�d*e�ZGd+d,�d,e�ZGd-d.�d.ee�ZGd/d0�d0e�Zd1S)2z`
requests.exceptions
~~~~~~~~~~~~~~~~~~~

This module contains the set of Requests' exceptions.
�)�	HTTPErrorcs eZdZdZ�fdd�Z�ZS)�RequestExceptionzTThere was an ambiguous exception that occurred while handling your
    request.
    csX|�dd�}||_|�dd�|_|dk	rB|jsBt|d�rB|jj|_tt|�j||�dS)zBInitialize RequestException with `request` and `response` objects.�responseN�request)�poprr�hasattr�superr�__init__)�self�args�kwargsr��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/requests/exceptions.pyr	s�
zRequestException.__init__)�__name__�
__module__�__qualname__�__doc__r	�
__classcell__rrr
rrsrc@seZdZdZdS)rzAn HTTP error occurred.N�rrrrrrrrrsrc@seZdZdZdS)�ConnectionErrorzA Connection error occurred.Nrrrrrr src@seZdZdZdS)�
ProxyErrorzA proxy error occurred.Nrrrrrr$src@seZdZdZdS)�SSLErrorzAn SSL error occurred.Nrrrrrr(src@seZdZdZdS)�Timeoutz�The request timed out.

    Catching this error will catch both
    :exc:`~requests.exceptions.ConnectTimeout` and
    :exc:`~requests.exceptions.ReadTimeout` errors.
    Nrrrrrr,src@seZdZdZdS)�ConnectTimeoutz�The request timed out while trying to connect to the remote server.

    Requests that produced this error are safe to retry.
    Nrrrrrr5src@seZdZdZdS)�ReadTimeoutz@The server did not send any data in the allotted amount of time.Nrrrrrr<src@seZdZdZdS)�URLRequiredz*A valid URL is required to make a request.Nrrrrrr@src@seZdZdZdS)�TooManyRedirectszToo many redirects.NrrrrrrDsrc@seZdZdZdS)�
MissingSchemaz/The URL schema (e.g. http or https) is missing.NrrrrrrHsrc@seZdZdZdS)�
InvalidSchemaz"See defaults.py for valid schemas.Nrrrrrr Lsr c@seZdZdZdS)�
InvalidURLz%The URL provided was somehow invalid.Nrrrrrr!Psr!c@seZdZdZdS)�
InvalidHeaderz.The header value provided was somehow invalid.Nrrrrrr"Tsr"c@seZdZdZdS)�InvalidProxyURLz"The proxy URL provided is invalid.Nrrrrrr#Xsr#c@seZdZdZdS)�ChunkedEncodingErrorz?The server declared chunked encoding but sent an invalid chunk.Nrrrrrr$\sr$c@seZdZdZdS)�ContentDecodingErrorz!Failed to decode response contentNrrrrrr%`sr%c@seZdZdZdS)�StreamConsumedErrorz2The content for this response was already consumedNrrrrrr&dsr&c@seZdZdZdS)�
RetryErrorzCustom retries logic failedNrrrrrr'hsr'c@seZdZdZdS)�UnrewindableBodyErrorz:Requests encountered an error when trying to rewind a bodyNrrrrrr(lsr(c@seZdZdZdS)�RequestsWarningzBase warning for Requests.Nrrrrrr)rsr)c@seZdZdZdS)�FileModeWarningzJA file was opened in text mode, but Requests determined its binary length.Nrrrrrr*wsr*c@seZdZdZdS)�RequestsDependencyWarningz@An imported dependency doesn't match the expected version range.Nrrrrrr+|sr+N)rZpip._vendor.urllib3.exceptionsrZ
BaseHTTPError�IOErrorrrrrrrrrr�
ValueErrorrr r!r"r#r$r%�	TypeErrorr&r'r(�Warningr)�DeprecationWarningr*r+rrrr�<module>s0	site-packages/pip/_vendor/requests/__pycache__/utils.cpython-38.pyc000064400000053223151446176770021412 0ustar00U

��.eau�@s�dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlmZddl
mZddlmZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"dd	l#m$Z$dd
l%m&Z&ddl'm(Z(m)Z)m*Z*m+Z+dZ,e�-�Z.d
dd�Z/ej0dk�r2dd�Z1dd�Zdd�Z2dd�Z3dhdd�Z4dd�Z5dd�Z6d d!�Z7d"d#�Z8d$d%�Z9d&d'�Z:did(d)�Z;d*d+�Z<d,d-�Z=d.d/�Z>d0d1�Z?d2d3�Z@d4d5�ZAd6d7�ZBd8d9�ZCeDd:�ZEd;d<�ZFd=d>�ZGd?d@�ZHdAdB�ZIdCdD�ZJdEdF�ZKejLdGdH��ZMdIdJ�ZNdjdKdL�ZOdMdN�ZPdkdPdQ�ZQdRdS�ZRdTdU�ZSdV�TdW�ZUeUdXZVeUdYZWdZd[�ZXd\d]�ZYd^d_�ZZe�[d`�Z\e�[da�Z]dbdc�Z^ddde�Z_dfdg�Z`dS)lz�
requests.utils
~~~~~~~~~~~~~~

This module provides utility functions that are used within Requests
that are also useful for external consumption.
�N���__version__)�certs)�to_native_string)�parse_http_list)�quote�urlparse�bytes�str�OrderedDict�unquote�
getproxies�proxy_bypass�
urlunparse�
basestring�
integer_types�is_py3�proxy_bypass_environment�getproxies_environment�Mapping��cookiejar_from_dict)�CaseInsensitiveDict)�
InvalidURL�
InvalidHeader�FileModeWarning�UnrewindableBodyError)z.netrc�_netrc�Pi�)ZhttpZhttpsZwin32cCs�ztrddl}nddl}Wntk
r0YdSXz6|�|jd�}t|�|d�d�}|�|d�d}Wntk
r~YdSX|r�|s�dS|�	d�}|D]T}|dkr�d|kr�d	S|�
dd
�}|�
dd�}|�
d
d�}t�||tj
�r�d	Sq�dS)NrFz;Software\Microsoft\Windows\CurrentVersion\Internet SettingsZProxyEnableZ
ProxyOverride�;z<local>�.Tz\.�*z.*�?)r�winreg�_winreg�ImportError�OpenKey�HKEY_CURRENT_USER�intZQueryValueEx�OSError�split�replace�re�match�I)�hostr$ZinternetSettingsZproxyEnableZ
proxyOverrideZtest�r1�>/usr/lib/python3.8/site-packages/pip/_vendor/requests/utils.py�proxy_bypass_registry/sF
�����
r3cCst�rt|�St|�SdS)z�Return True, if the host should be bypassed.

        Checks proxy settings gathered from the environment, if specified,
        or the registry.
        N)rrr3)r0r1r1r2rVsrcCst|d�r|��}|S)z/Returns an internal sequence dictionary update.�items)�hasattrr4)�dr1r1r2�dict_to_sequencebs
r7c	Cs4d}d}t|d�rt|�}nbt|d�r.|j}nPt|d�r~z|��}Wntjk
rZYn$Xt�|�j}d|jkr~t	�
dt�t|d��rz|��}Wn$t
tfk
r�|dk	r�|}Yn^Xt|d��r|dk�rz&|�dd	�|��}|�|p�d�Wnt
tfk
�rd}YnX|dk�r&d}td||�S)
Nr�__len__�len�fileno�ba%Requests has determined the content-length for this request using the binary size of the file: however, the file has been opened in text mode (i.e. without the 'b' flag in the mode). This may lead to an incorrect content-length. In Requests 3.0, support will be removed for files in text mode.�tell�seek�)r5r9r:�io�UnsupportedOperation�os�fstat�st_size�mode�warnings�warnrr<r*�IOErrorr=�max)�oZtotal_lengthZcurrent_positionr:r1r1r2�	super_lenksB




�



rJFc	Cs&�zddlm}m}d}tD]J}ztj�d�|��}Wntk
rPYWdSXtj�|�r|}qhq|dkrvWdSt	|�}d}t
|t�r�|�d�}|j
�|�d}	z:||��|	�}
|
r�|
dr�dnd}|
||
dfWWSWn"|tfk
�r|�r��YnXWnttfk
�r YnXdS)	z;Returns the Requests tuple auth for a given url from netrc.r)�netrc�NetrcParseErrorNz~/{}�:�asciirr>)rKrL�NETRC_FILESrA�path�
expanduser�format�KeyError�existsr	�
isinstancer�decode�netlocr+ZauthenticatorsrGr&�AttributeError)�urlZraise_errorsrKrLZ
netrc_path�fZlocZriZsplitstrr0rZlogin_ir1r1r2�get_netrc_auth�s8

r[cCsBt|dd�}|r>t|t�r>|ddkr>|ddkr>tj�|�SdS)z0Tries to guess the filename of the given object.�nameNr�<����>)�getattrrUrrArP�basename)�objr\r1r1r2�guess_filename�s

�rccCs�tj�|�r|Stj�|�\}}|rPtj�|�sPtj�|�\}}d�||g�}q t�|�s^|St�|�}||��krx|St	�
�}tjj|f|�d���}tj�|�s�|j||d�}|S)z�Replace nonexistent paths that look like they refer to a member of a zip
    archive with the location of an extracted copy of the target, or else
    just return the provided path unchanged.
    �/)rP)rArPrTr+�join�zipfileZ
is_zipfileZZipFileZnamelist�tempfileZ
gettempdir�extract)rP�archive�member�prefixZzip_fileZtmpZextracted_pathr1r1r2�extract_zipped_paths�s 

rlcCs.|dkrdSt|ttttf�r&td��t|�S)a�Take an object and test to see if it can be represented as a
    dictionary. Unless it can not be represented as such, return an
    OrderedDict, e.g.,

    ::

        >>> from_key_val_list([('key', 'val')])
        OrderedDict([('key', 'val')])
        >>> from_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples
        >>> from_key_val_list({'key': 'val'})
        OrderedDict([('key', 'val')])

    :rtype: OrderedDict
    N�+cannot encode objects that are not 2-tuples)rUrr
�boolr)�
ValueErrorr��valuer1r1r2�from_key_val_lists
rrcCs@|dkrdSt|ttttf�r&td��t|t�r8|��}t|�S)a�Take an object and test to see if it can be represented as a
    dictionary. If it can be, return a list of tuples, e.g.,

    ::

        >>> to_key_val_list([('key', 'val')])
        [('key', 'val')]
        >>> to_key_val_list({'key': 'val'})
        [('key', 'val')]
        >>> to_key_val_list('string')
        ValueError: cannot encode objects that are not 2-tuples.

    :rtype: list
    Nrm)	rUrr
rnr)rorr4�listrpr1r1r2�to_key_val_lists
rtcCsXg}t|�D]F}|dd�|dd�kr4dkrHnnt|dd��}|�|�q|S)aParse lists as described by RFC 2068 Section 2.

    In particular, parse comma-separated lists where the elements of
    the list may include quoted-strings.  A quoted-string could
    contain a comma.  A non-quoted string could have quotes in the
    middle.  Quotes are removed automatically after parsing.

    It basically works like :func:`parse_set_header` just that items
    may appear multiple times and case sensitivity is preserved.

    The return value is a standard :class:`list`:

    >>> parse_list_header('token, "quoted value"')
    ['token', 'quoted value']

    To create a header from the :class:`list` again, use the
    :func:`dump_header` function.

    :param value: a string with a list header.
    :return: :class:`list`
    :rtype: list
    Nrr^�")�_parse_list_header�unquote_header_value�append)rq�result�itemr1r1r2�parse_list_header8s(r{cCsxi}t|�D]f}d|kr"d||<q|�dd�\}}|dd�|dd�krVdkrjnnt|dd��}|||<q|S)a^Parse lists of key, value pairs as described by RFC 2068 Section 2 and
    convert them into a python dict:

    >>> d = parse_dict_header('foo="is a fish", bar="as well"')
    >>> type(d) is dict
    True
    >>> sorted(d.items())
    [('bar', 'as well'), ('foo', 'is a fish')]

    If there is no value for a key it will be `None`:

    >>> parse_dict_header('key_without_value')
    {'key_without_value': None}

    To create a header from the :class:`dict` again, use the
    :func:`dump_header` function.

    :param value: a string with a dict header.
    :return: :class:`dict`
    :rtype: dict
    �=Nrr^ru)rvr+rw)rqryrzr\r1r1r2�parse_dict_headerXs(
r}cCs\|rX|d|dkr dkrXnn4|dd�}|rD|dd�dkrX|�dd��d	d�S|S)
z�Unquotes a header value.  (Reversal of :func:`quote_header_value`).
    This does not use the real unquoting but what browsers are actually
    using for quoting.

    :param value: the header value to unquote.
    :rtype: str
    rr^rurNr>z\\�\z\")r,)rqZis_filenamer1r1r2rw{s
$rwcCsi}|D]}|j||j<q|S)z�Returns a key/value dictionary from a CookieJar.

    :param cj: CookieJar object to extract cookies from.
    :rtype: dict
    )rqr\)�cj�cookie_dictZcookier1r1r2�dict_from_cookiejar�sr�cCs
t||�S)z�Returns a CookieJar from a key/value dictionary.

    :param cj: CookieJar to insert cookies into.
    :param cookie_dict: Dict of key/values to insert into CookieJar.
    :rtype: CookieJar
    r)rr�r1r1r2�add_dict_to_cookiejar�sr�cCsTt�dt�tjdtjd�}tjdtjd�}t�d�}|�|�|�|�|�|�S)zlReturns encodings from given content string.

    :param content: bytestring to extract encodings from.
    z�In requests 3.0, get_encodings_from_content will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)z!<meta.*?charset=["\']*(.+?)["\'>])�flagsz+<meta.*?content=["\']*;?charset=(.+?)["\'>]z$^<\?xml.*?encoding=["\']*(.+?)["\'>])rErF�DeprecationWarningr-�compiler/�findall)�contentZ
charset_reZ	pragma_reZxml_rer1r1r2�get_encodings_from_content�s�
��r�c
Cs�|�d�}|d��|dd�}}i}d}|D]`}|��}|r0|d}}|�d�}	|	dkr�|d|	��|�}||	dd��|�}|||��<q0||fS)	z�Returns content type and parameters from given header

    :param header: string
    :return: tuple containing content type and dictionary of
         parameters
    r rrNz"' Tr|r^)r+�strip�find�lower)
�header�tokens�content_type�paramsZparams_dictZitems_to_strip�param�keyrqZindex_of_equalsr1r1r2�_parse_content_type_header�s


r�cCsD|�d�}|sdSt|�\}}d|kr4|d�d�Sd|kr@dSdS)z}Returns encodings from given HTTP Header Dict.

    :param headers: dictionary to extract encoding from.
    :rtype: str
    zcontent-typeN�charsetz'"�textz
ISO-8859-1)�getr�r�)�headersr�r�r1r1r2�get_encoding_from_headers�s
r�ccsj|jdkr|D]
}|VqdSt�|j�dd�}|D]}|�|�}|r4|Vq4|jddd�}|rf|VdS)zStream decodes a iterator.Nr,��errors�T)�final)�encoding�codecs�getincrementaldecoderrV)�iterator�rrz�decoder�chunk�rvr1r1r2�stream_decode_response_unicode�s

r�ccsHd}|dks|dkrt|�}|t|�krD||||�V||7}qdS)z Iterate over slices of a string.rN)r9)�stringZslice_length�posr1r1r2�iter_slicessr�cCs~t�dt�g}t|j�}|rLzt|j|�WStk
rJ|�|�YnXzt|j|dd�WSt	k
rx|jYSXdS)z�Returns the requested content back in unicode.

    :param r: Response object to get unicode content from.

    Tried:

    1. charset from content-type
    2. fall back and replace all unicode characters

    :rtype: str
    z�In requests 3.0, get_unicode_from_response will be removed. For more information, please see the discussion on issue #2266. (This warning should only appear once.)r,r�N)
rErFr�r�r�rr��UnicodeErrorrx�	TypeError)r�Ztried_encodingsr�r1r1r2�get_unicode_from_responses�
r�zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-._~c	Cs�|�d�}tdt|��D]�}||dd�}t|�dkr�|��r�ztt|d��}Wn tk
rrtd|��YnX|tkr�|||dd�||<q�d||||<qd||||<qd�	|�S)	z�Un-escape any percent-escape sequences in a URI that are unreserved
    characters. This leaves all reserved, illegal and non-ASCII bytes encoded.

    :rtype: str
    �%rrr>�z%Invalid percent-escape sequence: '%s'N�)
r+�ranger9�isalnum�chrr)ror�UNRESERVED_SETre)�uri�parts�i�h�cr1r1r2�unquote_unreserved5s
r�cCs@d}d}ztt|�|d�WStk
r:t||d�YSXdS)z�Re-quote the given URI.

    This function passes the given URI through an unquote/quote cycle to
    ensure that it is fully and consistently quoted.

    :rtype: str
    z!#$%&'()*+,/:;=?@[]~z!#$&'()*+,/:;=?@[]~)ZsafeN)rr�r)r�Zsafe_with_percentZsafe_without_percentr1r1r2�requote_uriMsr�cCslt�dt�|��d}|�d�\}}t�dt�tt|����d}t�dt�|��d|@}||@||@kS)z�This function allows you to check if an IP belongs to a network subnet

    Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
             returns False if ip = 192.168.1.1 and net = 192.168.100.0/24

    :rtype: bool
    z=Lrrd)�struct�unpack�socket�	inet_atonr+�dotted_netmaskr))ZipZnetZipaddrZnetaddr�bitsZnetmaskZnetworkr1r1r2�address_in_networkcs
r�cCs&ddd|>dA}t�t�d|��S)z�Converts mask from /xx format to xxx.xxx.xxx.xxx

    Example: if mask is 24 function returns 255.255.255.0

    :rtype: str
    l��r� z>I)r�Z	inet_ntoar��pack)�maskr�r1r1r2r�rsr�cCs,zt�|�Wntjk
r&YdSXdS)z
    :rtype: bool
    FT)r�r��error)Z	string_ipr1r1r2�is_ipv4_address}s
r�cCs�|�d�dkr�zt|�d�d�}Wntk
r:YdSX|dksL|dkrPdSzt�|�d�d�Wq�tjk
r�YdSXndSdS)zV
    Very simple check of the cidr format in no_proxy variable.

    :rtype: bool
    rdrFr�rT)�countr)r+ror�r�r�)Zstring_networkr�r1r1r2�
is_valid_cidr�s
r�c	csT|dk	}|r"tj�|�}|tj|<z
dVW5|rN|dkrDtj|=n
|tj|<XdS)z�Set the environment variable 'env_name' to 'value'

    Save previous value, yield, and then restore the previous value stored in
    the environment variable 'env_name'.

    If 'value' is None, do nothingN)rA�environr�)Zenv_namerqZ
value_changed�	old_valuer1r1r2�set_environ�s


r�c	
Cs*dd�}|}|dkr|d�}t|�}|jdkr2dS|r�dd�|�dd	��d
�D�}t|j�r�|D]0}t|�r�t|j|�r�dSq`|j|kr`dSq`nB|j}|jr�|d�|j�7}|D] }|j�	|�s�|�	|�r�dSq�t
d|��6zt|j�}Wn tt
jfk
�rd}YnXW5QRX|�r&dSdS)
zL
    Returns whether we should bypass proxies or not.

    :rtype: bool
    cSstj�|�ptj�|���S�N)rAr�r��upper)�kr1r1r2�<lambda>�r�z'should_bypass_proxies.<locals>.<lambda>N�no_proxyTcss|]}|r|VqdSr�r1)�.0r0r1r1r2�	<genexpr>�sz(should_bypass_proxies.<locals>.<genexpr>� r��,z:{}F)r	�hostnamer,r+r�r�r�ZportrR�endswithr�rr�r�Zgaierror)	rYr�Z	get_proxyZno_proxy_arg�parsedZproxy_ipZhost_with_portr0Zbypassr1r1r2�should_bypass_proxies�s@
�


r�cCst||d�riSt�SdS)zA
    Return a dict of environment proxies.

    :rtype: dict
    )r�N)r�r)rYr�r1r1r2�get_environ_proxies�sr�cCst|pi}t|�}|jdkr.|�|j|�d��S|jd|j|jd|jdg}d}|D]}||krV||}qpqV|S)z�Select a proxy for the url, if applicable.

    :param url: The url being for the request
    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
    N�allz://zall://)r	r�r��scheme)rYZproxiesZurlpartsZ
proxy_keys�proxyZ	proxy_keyr1r1r2�select_proxy�s
�r��python-requestscCsd|tfS)zO
    Return a string representing the default user agent.

    :rtype: str
    z%s/%sr)r\r1r1r2�default_user_agentsr�cCstt�d�d�ddd��S)z9
    :rtype: requests.structures.CaseInsensitiveDict
    z, )ZgzipZdeflatez*/*z
keep-alive)z
User-AgentzAccept-EncodingZAcceptZ
Connection)rr�rer1r1r1r2�default_headers"s�r�c	
Cs�g}d}|�|�}|s|St�d|�D]�}z|�dd�\}}Wntk
r\|d}}YnXd|�d�i}|�d�D]F}z|�d�\}}Wntk
r�Yq�YnX|�|�||�|�<qv|�|�q&|S)	z�Return a list of parsed link headers proxies.

    i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"

    :rtype: list
    z '"z, *<r rr�rYz<> '"r|)r�r-r+rorx)	rqZlinksZ
replace_chars�valrYr��linkr�r�r1r1r2�parse_header_links.s&
r��rNr>�cCs�|dd�}|tjtjfkr dS|dd�tjkr6dS|dd�tjtjfkrRdS|�t�}|dkrhd	S|dkr�|ddd�tkr�d
S|ddd�tkr�dS|dkr�|dd�t	kr�d
S|dd�t	kr�dSdS)z
    :rtype: str
    N�zutf-32r�z	utf-8-sigr>zutf-16rzutf-8z	utf-16-berz	utf-16-lez	utf-32-bez	utf-32-le)
r��BOM_UTF32_LE�BOM_UTF32_BE�BOM_UTF8�BOM_UTF16_LE�BOM_UTF16_BEr��_null�_null2�_null3)�dataZsampleZ	nullcountr1r1r2�guess_json_utfYs*
r�cCs8t||�\}}}}}}|s$||}}t||||||f�S)z�Given a URL that may or may not have a scheme, prepend the given scheme.
    Does not replace a present scheme with the one provided as an argument.

    :rtype: str
    )r	r)rYZ
new_schemer�rWrPr��query�fragmentr1r1r2�prepend_scheme_if_neededys
r�c	CsBt|�}zt|j�t|j�f}Wnttfk
r<d}YnX|S)z{Given a url with authentication components, extract them into a tuple of
    username,password.

    :rtype: (str,str)
    )r�r�)r	r
ZusernameZpasswordrXr�)rYr�Zauthr1r1r2�get_auth_from_url�s
r�s^\S[^\r\n]*$|^$z^\S[^\r\n]*$|^$c	Csf|\}}t|t�rt}nt}z|�|�s4td|��Wn*tk
r`td||t|�f��YnXdS)z�Verifies that header value is a string which doesn't contain
    leading whitespace or return characters. This prevents unintended
    header injection.

    :param header: tuple, in the format (name, value).
    z7Invalid return character or leading space in header: %sz>Value for header {%s: %s} must be of type str or bytes, not %sN)rUr
�_CLEAN_HEADER_REGEX_BYTE�_CLEAN_HEADER_REGEX_STRr.rr��type)r�r\rqZpatr1r1r2�check_header_validity�s

�r�cCsFt|�\}}}}}}|s"||}}|�dd�d}t|||||df�S)zW
    Given a url remove the fragment and the authentication part.

    :rtype: str
    �@rr^r�)r	�rsplitr)rYr�rWrPr�r�r�r1r1r2�
urldefragauth�s

r�c	Cs`t|jdd�}|dk	rTt|jt�rTz||j�Wq\ttfk
rPtd��Yq\Xntd��dS)zfMove file pointer back to its recorded starting position
    so it can be read again on redirect.
    r=Nz;An error occurred when rewinding request body for redirect.z+Unable to rewind request body for redirect.)r`ZbodyrUZ_body_positionrrGr*r)Zprepared_requestZ	body_seekr1r1r2�rewind_body�sr�)F)F)N)r�)a�__doc__r��
contextlibr?rAr-r�r��sysrgrErfrr�rZ_internal_utilsr�compatrrvrr	r
rrr
rrrrrrrrrZcookiesrZ
structuresr�
exceptionsrrrrrO�whereZDEFAULT_CA_BUNDLE_PATHZ
DEFAULT_PORTS�platformr3r7rJr[rcrlrrrtr{r}rwr�r�r�r�r�r�r�r��	frozensetr�r�r�r�r�r�r��contextmanagerr�r�r�r�r�r�r��encoder�r�r�r�r�r�r�r�r�r�r�r�r1r1r1r2�<module>s�D
'	=
3  #

%�
=

	&
 

site-packages/pip/_vendor/requests/__pycache__/_internal_utils.cpython-38.pyc000064400000002404151446176770023440 0ustar00U

��.eH�@s.dZddlmZmZmZd	dd�Zdd�ZdS)
z�
requests._internal_utils
~~~~~~~~~~~~~~

Provides utility functions that are consumed internally by Requests
which depend on extremely few external helpers (such as compat)
�)�is_py2�builtin_str�str�asciicCs.t|t�r|}ntr |�|�}n
|�|�}|S)z�Given a string object, regardless of type, returns a representation of
    that string in the native string type, encoding and decoding where
    necessary. This assumes ASCII unless told otherwise.
    )�
isinstancerr�encode�decode)�string�encoding�out�r�H/usr/lib/python3.8/site-packages/pip/_vendor/requests/_internal_utils.py�to_native_strings

rcCs:t|t�st�z|�d�WdStk
r4YdSXdS)z�Determine if unicode string only contains ASCII characters.

    :param str u_string: unicode string to check. Must be unicode
        and not Python 2 `str`.
    :rtype: bool
    rTFN)rr�AssertionErrorr�UnicodeEncodeError)Zu_stringrrr
�unicode_is_asciis
rN)r)�__doc__�compatrrrrrrrrr
�<module>s
site-packages/pip/_vendor/requests/__pycache__/auth.cpython-38.opt-1.pyc000064400000020145151446176770022147 0ustar00U

��.e�'�@s�dZddlZddlZddlZddlZddlZddlZddlmZddl	m
Z
mZmZddl
mZddlmZddlmZd	Zd
Zdd�ZGd
d�de�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)z]
requests.auth
~~~~~~~~~~~~~

This module contains the authentication handlers for Requests.
�N)�	b64encode�)�urlparse�str�
basestring)�extract_cookies_to_jar)�to_native_string)�parse_dict_headerz!application/x-www-form-urlencodedzmultipart/form-datacCs�t|t�s&tjd�|�td�t|�}t|t�sLtjd�|�td�t|�}t|t�r`|�d�}t|t�rt|�d�}dtt	d�
||f�����}|S)zReturns a Basic Auth string.z�Non-string usernames will no longer be supported in Requests 3.0.0. Please convert the object you've passed in ({!r}) to a string or bytes object in the near future to avoid problems.)�categoryz�Non-string passwords will no longer be supported in Requests 3.0.0. Please convert the object you've passed in ({!r}) to a string or bytes object in the near future to avoid problems.�latin1zBasic �:)�
isinstancer�warnings�warn�format�DeprecationWarningr�encoderr�join�strip)�username�passwordZauthstr�r�=/usr/lib/python3.8/site-packages/pip/_vendor/requests/auth.py�_basic_auth_strs0

��
��



�rc@seZdZdZdd�ZdS)�AuthBasez4Base class that all auth implementations derive fromcCstd��dS)NzAuth hooks must be callable.)�NotImplementedError��self�rrrr�__call__KszAuthBase.__call__N��__name__�
__module__�__qualname__�__doc__rrrrrrHsrc@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�
HTTPBasicAuthz?Attaches HTTP Basic Authentication to the given Request object.cCs||_||_dS�N)rr�rrrrrr�__init__RszHTTPBasicAuth.__init__cCs(t|jt|dd�k|jt|dd�kg�S�Nrr��allr�getattrr�r�otherrrr�__eq__Vs�zHTTPBasicAuth.__eq__cCs
||kSr&rr-rrr�__ne__\szHTTPBasicAuth.__ne__cCst|j|j�|jd<|S)N�
Authorization�rrr�headersrrrrr_szHTTPBasicAuth.__call__N)r!r"r#r$r(r/r0rrrrrr%Os
r%c@seZdZdZdd�ZdS)�
HTTPProxyAuthz=Attaches HTTP Proxy Authentication to a given Request object.cCst|j|j�|jd<|S)NzProxy-Authorizationr2rrrrrgszHTTPProxyAuth.__call__Nr rrrrr4dsr4c@sPeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�ZdS)�HTTPDigestAuthz@Attaches HTTP Digest Authentication to the given Request object.cCs||_||_t��|_dSr&)rr�	threadingZlocal�
_thread_localr'rrrr(oszHTTPDigestAuth.__init__cCs@t|jd�s<d|j_d|j_d|j_i|j_d|j_d|j_dS)N�initT�r)�hasattrr7r8�
last_nonce�nonce_count�chal�pos�
num_401_calls)rrrr�init_per_thread_stateusz$HTTPDigestAuth.init_per_thread_statecs�|jjd}|jjd}|jj�d�}|jj�d�}|jj�d�}d�|dkrTd}n|��}|dksl|dkrzd	d
�}	|	�n@|dkr�dd
�}
|
�n*|dkr�dd�}|�n|dkr�dd�}|��fdd�}
�dkr�dSd}t|�}|jp�d}|jr�|d|j7}d|j||jf}d||f}�|�}�|�}||jj	k�rJ|jj
d7_
nd|j_
d|jj
}t|jj
��d�}||�d�7}|t
���d�7}|t�d�7}t�|���dd�}|dk�rЈd|||f�}|�s�|
|d||f�}n<|dk�sd|�d �k�r"d!|||d|f}|
||�}ndS||j_	d"|j||||f}|�rT|d#|7}|�rf|d$|7}|�rx|d%|7}|�r�|d&||f7}d'|S)(z
        :rtype: str
        �realm�nonce�qop�	algorithm�opaqueNZMD5zMD5-SESScSs"t|t�r|�d�}t�|���S�N�utf-8)r
rr�hashlibZmd5�	hexdigest��xrrr�md5_utf8�s

z4HTTPDigestAuth.build_digest_header.<locals>.md5_utf8ZSHAcSs"t|t�r|�d�}t�|���SrF)r
rrrH�sha1rIrJrrr�sha_utf8�s

z4HTTPDigestAuth.build_digest_header.<locals>.sha_utf8zSHA-256cSs"t|t�r|�d�}t�|���SrF)r
rrrHZsha256rIrJrrr�sha256_utf8�s

z7HTTPDigestAuth.build_digest_header.<locals>.sha256_utf8zSHA-512cSs"t|t�r|�d�}t�|���SrF)r
rrrHZsha512rIrJrrr�sha512_utf8�s

z7HTTPDigestAuth.build_digest_header.<locals>.sha512_utf8cs�d||f�S)N�%s:%sr)�s�d�Z	hash_utf8rr�<lambda>��z4HTTPDigestAuth.build_digest_header.<locals>.<lambda>�/�?z%s:%s:%srQrz%08xrG��Zauth�,z%s:%s:%s:%s:%sz>username="%s", realm="%s", nonce="%s", uri="%s", response="%s"z
, opaque="%s"z, algorithm="%s"z
, digest="%s"z , qop="auth", nc=%s, cnonce="%s"z	Digest %s)r7r=�get�upperr�pathZqueryrrr;r<rr�time�ctime�os�urandomrHrMrI�split)r�method�urlrArBrCrDrEZ
_algorithmrLrNrOrPZKDZentdigZp_parsedr^ZA1ZA2ZHA1ZHA2ZncvaluerRZcnonceZrespdigZnoncebit�baserrTr�build_digest_headers�

��z"HTTPDigestAuth.build_digest_headercKs|jrd|j_dS)z)Reset num_401_calls counter on redirects.rN)Zis_redirectr7r?)rr�kwargsrrr�handle_redirect�szHTTPDigestAuth.handle_redirectcKs"d|jkrdks$nd|j_|S|jjdk	rB|jj�|jj�|j�dd�}d|�	�k�r|jjdk�r|jjd7_t
jd	t
jd
�}t
|jd|dd��|j_|j|��|j��}t|j|j|j�|�|j�|�|j|j�|jd<|jj|f|�}|j�|�||_|Sd|j_|S)
zo
        Takes the given response and tries digest-auth, if needed.

        :rtype: requests.Response
        i�i�rNzwww-authenticater9Zdigest�zdigest )�flags)�countr1)Zstatus_coder7r?r>Zrequest�body�seekr3r\�lower�re�compile�
IGNORECASEr	�subr=Zcontent�close�copyrZ_cookies�rawZprepare_cookiesrgrdreZ
connection�send�history�append)rrrhZs_authZpatZprepZ_rrrr�
handle_401�s2	
�
zHTTPDigestAuth.handle_401cCs~|��|jjr&|�|j|j�|jd<z|j��|j_	Wnt
k
rTd|j_	YnX|�d|j�|�d|j
�d|j_|S)Nr1Zresponser)r@r7r;rgrdrer3rm�tellr>�AttributeErrorZ
register_hookrzrir?rrrrrszHTTPDigestAuth.__call__cCs(t|jt|dd�k|jt|dd�kg�Sr)r*r-rrrr/*s�zHTTPDigestAuth.__eq__cCs
||kSr&rr-rrrr00szHTTPDigestAuth.__ne__N)r!r"r#r$r(r@rgrirzrr/r0rrrrr5ls
f,r5)r$rarpr_rHr6r�base64r�compatrrrZcookiesrZ_internal_utilsrZutilsr	ZCONTENT_TYPE_FORM_URLENCODEDZCONTENT_TYPE_MULTI_PARTr�objectrr%r4r5rrrr�<module>s$,site-packages/pip/_vendor/requests/__pycache__/packages.cpython-38.pyc000064400000000722151446176770022024 0ustar00U

��.e��@svddlZdD]dZdeZee�e�e<eej�D]>ZeeksJe�ed�r0ee	d�d�Z
ejeejde
<q0qdS)�N)Zurllib3ZidnaZchardetzpip._vendor.�.zpip._vendor.requests.packages.)�sys�packageZvendored_package�
__import__�locals�list�modules�mod�
startswith�lenZunprefixed_mod�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/packages.py�<module>ssite-packages/pip/_vendor/requests/__pycache__/hooks.cpython-38.opt-1.pyc000064400000001674151446176770022337 0ustar00U

��.e��@sdZdgZdd�Zdd�ZdS)z�
requests.hooks
~~~~~~~~~~~~~~

This module provides the capabilities for the Requests hooks system.

Available hooks:

``response``:
    The response generated from a Request.
ZresponsecCsdd�tD�S)NcSsi|]
}|g�qS�r)�.0Zeventrr�>/usr/lib/python3.8/site-packages/pip/_vendor/requests/hooks.py�
<dictcomp>sz!default_hooks.<locals>.<dictcomp>)�HOOKSrrrr�
default_hookssrcKsL|pi}|�|�}|rHt|d�r&|g}|D]}||f|�}|dk	r*|}q*|S)z6Dispatches a hook dictionary on a given piece of data.�__call__N)�get�hasattr)�keyZhooksZ	hook_data�kwargs�hookZ
_hook_datarrr�
dispatch_hooks

r
N)�__doc__rrr
rrrr�<module>ssite-packages/pip/_vendor/requests/__pycache__/__version__.cpython-38.pyc000064400000001002151446176770022517 0ustar00U

��.e��@s,dZdZdZdZdZdZdZdZdZd	Z	d
S)ZrequestszPython HTTP for Humans.zhttp://python-requests.orgz2.22.0i"z
Kenneth Reitzzme@kennethreitz.orgz
Apache 2.0zCopyright 2019 Kenneth Reitzu✨ 🍰 ✨N)
Z	__title__Z__description__Z__url__�__version__Z	__build__�
__author__Z__author_email__Z__license__Z
__copyright__Z__cake__�rr�D/usr/lib/python3.8/site-packages/pip/_vendor/requests/__version__.py�<module>ssite-packages/pip/_vendor/requests/__pycache__/compat.cpython-38.opt-1.pyc000064400000003050151446176770022465 0ustar00U

��.e��@s�dZddlmZddlZejZeddkZeddkZddlZer�ddl	m
Z
mZmZm
Z
mZmZmZmZmZddlmZmZmZmZmZddlmZddlZdd	lmZdd
lmZddlmZm Z m!Z!m"Z"e#Z$e#Z%e&Z#e'Z'e(e)e*fZ+e(e)fZ,n�e�r�ddl-mZmZmZmZmZm
Z
mZmZm
Z
mZdd
l.mZmZmZmZmZddl/m0Zdd	l1mZdd
l2mZddlm"Z"ddl3mZm Z m!Z!e#Z$e#Z#e%Z%e#e%fZ'e(e*fZ+e(fZ,dS)zq
requests.compat
~~~~~~~~~~~~~~~

This module handles import compatibility issues between Python 2 and
Python 3.
�)�chardetN��)	�quote�unquote�
quote_plus�unquote_plus�	urlencode�
getproxies�proxy_bypass�proxy_bypass_environment�getproxies_environment)�urlparse�
urlunparse�urljoin�urlsplit�	urldefrag)�parse_http_list)�Morsel)�StringIO)�Callable�Mapping�MutableMapping�OrderedDict)
rrrrr	rrrrr)rr
rrr
)�	cookiejar)r)rrr)4�__doc__Zpip._vendorr�sys�version_infoZ_verZis_py2Zis_py3ZjsonZurllibrrrrr	r
rrr
rrrrrZurllib2rZ	cookielibZCookierr�collectionsrrrr�strZbuiltin_str�bytesZunicodeZ
basestring�intZlong�floatZ
numeric_typesZ
integer_typesZurllib.parseZurllib.requestZhttprZhttp.cookies�ioZcollections.abc�r$r$�?/usr/lib/python3.8/site-packages/pip/_vendor/requests/compat.py�<module>sD	,

0site-packages/pip/_vendor/requests/__pycache__/structures.cpython-38.pyc000064400000010452151446176770022472 0ustar00U

��.e��@s<dZddlmZmZmZGdd�de�ZGdd�de�ZdS)zO
requests.structures
~~~~~~~~~~~~~~~~~~~

Data structures that power Requests.
�)�OrderedDict�Mapping�MutableMappingc@sbeZdZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dS)�CaseInsensitiveDicta�A case-insensitive ``dict``-like object.

    Implements all methods and operations of
    ``MutableMapping`` as well as dict's ``copy``. Also
    provides ``lower_items``.

    All keys are expected to be strings. The structure remembers the
    case of the last key to be set, and ``iter(instance)``,
    ``keys()``, ``items()``, ``iterkeys()``, and ``iteritems()``
    will contain case-sensitive keys. However, querying and contains
    testing is case insensitive::

        cid = CaseInsensitiveDict()
        cid['Accept'] = 'application/json'
        cid['aCCEPT'] == 'application/json'  # True
        list(cid) == ['Accept']  # True

    For example, ``headers['content-encoding']`` will return the
    value of a ``'Content-Encoding'`` response header, regardless
    of how the header name was originally stored.

    If the constructor, ``.update``, or equality comparison
    operations are given keys that have equal ``.lower()``s, the
    behavior is undefined.
    NcKs&t�|_|dkri}|j|f|�dS�N)r�_store�update)�self�data�kwargs�r�C/usr/lib/python3.8/site-packages/pip/_vendor/requests/structures.py�__init__(szCaseInsensitiveDict.__init__cCs||f|j|��<dSr�r�lower)r	�key�valuerrr
�__setitem__.szCaseInsensitiveDict.__setitem__cCs|j|��dS)Nrr�r	rrrr
�__getitem__3szCaseInsensitiveDict.__getitem__cCs|j|��=dSrrrrrr
�__delitem__6szCaseInsensitiveDict.__delitem__cCsdd�|j��D�S)Ncss|]\}}|VqdSrr)�.0ZcasedkeyZmappedvaluerrr
�	<genexpr>:sz/CaseInsensitiveDict.__iter__.<locals>.<genexpr>)r�values�r	rrr
�__iter__9szCaseInsensitiveDict.__iter__cCs
t|j�Sr)�lenrrrrr
�__len__<szCaseInsensitiveDict.__len__cCsdd�|j��D�S)z.Like iteritems(), but with all lowercase keys.css|]\}}||dfVqdS)rNr)rZlowerkeyZkeyvalrrr
rAs�z2CaseInsensitiveDict.lower_items.<locals>.<genexpr>)r�itemsrrrr
�lower_items?s�zCaseInsensitiveDict.lower_itemscCs0t|t�rt|�}ntSt|���t|���kSr)�
isinstancerr�NotImplemented�dictr)r	�otherrrr
�__eq__Gs

zCaseInsensitiveDict.__eq__cCst|j���Sr)rrrrrrr
�copyPszCaseInsensitiveDict.copycCstt|����Sr)�strr"rrrrr
�__repr__SszCaseInsensitiveDict.__repr__)N)�__name__�
__module__�__qualname__�__doc__rrrrrrrr$r%r'rrrr
r
s
	rcs<eZdZdZd�fdd�	Zdd�Zdd�Zdd	d
�Z�ZS)
�
LookupDictzDictionary lookup object.Ncs||_tt|���dSr)�name�superr,r)r	r-��	__class__rr
rZszLookupDict.__init__cCs
d|jS)Nz
<lookup '%s'>)r-rrrr
r'^szLookupDict.__repr__cCs|j�|d�Sr��__dict__�getrrrr
raszLookupDict.__getitem__cCs|j�||�Srr1)r	r�defaultrrr
r3fszLookupDict.get)N)N)	r(r)r*r+rr'rr3�
__classcell__rrr/r
r,Ws
r,N)r+�compatrrrrr"r,rrrr
�<module>sJsite-packages/pip/_vendor/requests/__pycache__/api.cpython-38.opt-1.pyc000064400000014507151446176770021764 0ustar00U

��.e�@s\dZddlmZdd�Zddd�Zdd	�Zd
d�Zddd
�Zddd�Zddd�Z	dd�Z
dS)z�
requests.api
~~~~~~~~~~~~

This module implements the Requests API.

:copyright: (c) 2012 by Kenneth Reitz.
:license: Apache2, see LICENSE for more details.
�)�sessionsc
Ks6t���$}|jf||d�|��W5QR�SQRXdS)a�	Constructs and sends a :class:`Request <Request>`.

    :param method: method for the new :class:`Request` object.
    :param url: URL for the new :class:`Request` object.
    :param params: (optional) Dictionary, list of tuples or bytes to send
        in the query string for the :class:`Request`.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
    :param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`.
    :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`.
    :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload.
        ``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')``
        or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content-type'`` is a string
        defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers
        to add for the file.
    :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
    :param timeout: (optional) How many seconds to wait for the server to send data
        before giving up, as a float, or a :ref:`(connect timeout, read
        timeout) <timeouts>` tuple.
    :type timeout: float or tuple
    :param allow_redirects: (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to ``True``.
    :type allow_redirects: bool
    :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy.
    :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use. Defaults to ``True``.
    :param stream: (optional) if ``False``, the response content will be immediately downloaded.
    :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response

    Usage::

      >>> import requests
      >>> req = requests.request('GET', 'https://httpbin.org/get')
      <Response [200]>
    )�method�urlN)rZSession�request)rr�kwargsZsession�r�</usr/lib/python3.8/site-packages/pip/_vendor/requests/api.pyrs+
rNcKs"|�dd�td|fd|i|��S)adSends a GET request.

    :param url: URL for the new :class:`Request` object.
    :param params: (optional) Dictionary, list of tuples or bytes to send
        in the query string for the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �allow_redirectsT�get�params��
setdefaultr)rrrrrrr
?sr
cKs|�dd�td|f|�S)z�Sends an OPTIONS request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    r	T�optionsr�rrrrrrNs	rcKs|�dd�td|f|�S)z�Sends a HEAD request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    r	F�headrrrrrr[s	rcKstd|f||d�|��S)a�Sends a POST request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �post)�data�json�r)rrrrrrrrhsrcKstd|fd|i|��S)a�Sends a PUT request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �putrr�rrrrrrrwsrcKstd|fd|i|��S)a�Sends a PATCH request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �patchrrrrrrr�srcKstd|f|�S)z�Sends a DELETE request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �deleterrrrrr�s	r)N)NN)N)N)�__doc__�rrr
rrrrrrrrrr�<module>s
/




site-packages/pip/_vendor/requests/__pycache__/status_codes.cpython-38.pyc000064400000010070151446176770022743 0ustar00U

��.e!�E@s�daddlmZddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdG�DZedHdI�ZdJdK�Ze�dLS)Ma�
The ``codes`` object defines a mapping from common names for HTTP statuses
to their numerical codes, accessible either as attributes or as dictionary
items.

>>> requests.codes['temporary_redirect']
307
>>> requests.codes.teapot
418
>>> requests.codes['\o/']
200

Some codes have multiple names, and both upper- and lower-case versions of
the names are allowed. For example, ``codes.ok``, ``codes.OK``, and
``codes.okay`` all correspond to the HTTP status code 200.
�)�
LookupDict)�continue)Zswitching_protocols)Z
processing)Z
checkpoint)Zuri_too_longZrequest_uri_too_long)�okZokayZall_okZall_okayZall_goodz\o/u✓)Zcreated)Zaccepted)Znon_authoritative_infoZnon_authoritative_information)Z
no_content)Z
reset_content�reset)Zpartial_content�partial)Zmulti_statusZmultiple_statusZmulti_statiZmultiple_stati)Zalready_reported)Zim_used)Zmultiple_choices)Zmoved_permanentlyZmovedz\o-)�found)Z	see_other�other)Znot_modified)Z	use_proxy)Zswitch_proxy)Ztemporary_redirectZtemporary_movedZ	temporary)Zpermanent_redirectZresume_incompleteZresume)Zbad_requestZbad)Zunauthorized)Zpayment_requiredZpayment)Z	forbidden)Z	not_foundz-o-)Zmethod_not_allowedZnot_allowed)Znot_acceptable)Zproxy_authentication_requiredZ
proxy_authZproxy_authentication)Zrequest_timeoutZtimeout)Zconflict)Zgone)Zlength_required)Zprecondition_failed�precondition)Zrequest_entity_too_large)Zrequest_uri_too_large)Zunsupported_media_typeZunsupported_mediaZ
media_type)Zrequested_range_not_satisfiableZrequested_rangeZrange_not_satisfiable)Zexpectation_failed)Zim_a_teapotZteapotZ
i_am_a_teapot)Zmisdirected_request)Zunprocessable_entityZ
unprocessable)�locked)Zfailed_dependencyZ
dependency)Zunordered_collectionZ	unordered)Zupgrade_requiredZupgrade)Zprecondition_requiredr	)Ztoo_many_requestsZtoo_many)Zheader_fields_too_largeZfields_too_large)Zno_responseZnone)Z
retry_withZretry)Z$blocked_by_windows_parental_controlsZparental_controls)Zunavailable_for_legal_reasonsZ
legal_reasons)Zclient_closed_request)Zinternal_server_errorZserver_errorz/o\u✗)Znot_implemented)Zbad_gateway)Zservice_unavailableZunavailable)Zgateway_timeout)Zhttp_version_not_supportedZhttp_version)Zvariant_also_negotiates)Zinsufficient_storage)Zbandwidth_limit_exceededZ	bandwidth)Znot_extended)Znetwork_authentication_requiredZnetwork_authZnetwork_authentication)D�d�e�f�g�z��������������������i,i-i.i/i0i1i2i3i4i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�Zstatus_codes)�namecs~t��D]8\}}|D]*}tt||�|�d�stt|��|�qqdd��tdk	rvtdd��fdd�tt�D��ndadS)N)�\�/cSs$d�dd�t|D��}d||fS)Nz, css|]}d|VqdS)z``%s``N�)�.0�nrr�E/usr/lib/python3.8/site-packages/pip/_vendor/requests/status_codes.py�	<genexpr>psz%_init.<locals>.doc.<locals>.<genexpr>z* %d: %s)�join�_codes)�code�namesrrr �docosz_init.<locals>.doc�
c3s|]}�|�VqdS)Nr)rr$�r&rr r!usz_init.<locals>.<genexpr>)	r#�items�setattr�codes�
startswith�upper�__doc__r"�sorted)r$Ztitles�titlerr(r �_iniths
���r1N)r.Z
structuresrr#r+r1rrrr �<module>s��P
site-packages/pip/_vendor/requests/__pycache__/cookies.cpython-38.pyc000064400000044556151446176770021717 0ustar00U

��.e�G�@s�dZddlZddlZddlZddlmZddlmZmZm	Z	m
Z
mZzddlZWne
k
rlddlZYnXGdd�de�ZGdd	�d	e�Zd
d�Zdd
�Zddd�ZGdd�de�ZGdd�deje�Zdd�Zdd�Zdd�Zd dd�Zdd�ZdS)!z�
requests.cookies
~~~~~~~~~~~~~~~~

Compatibility code to be able to use `cookielib.CookieJar` with requests.

requests.utils imports from here, so be careful with imports.
�N�)�to_native_string)�	cookielib�urlparse�
urlunparse�Morsel�MutableMappingc@s�eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
ddd�Zdd�Zdd�Z
dd�Zedd��Zedd��Zedd��ZdS) �MockRequesta�Wraps a `requests.Request` to mimic a `urllib2.Request`.

    The code in `cookielib.CookieJar` expects this interface in order to correctly
    manage cookie policies, i.e., determine whether a cookie can be set, given the
    domains of the request and the cookie.

    The original request object is read-only. The client is responsible for collecting
    the new headers via `get_new_headers()` and interpreting them appropriately. You
    probably want `get_cookie_header`, defined below.
    cCs ||_i|_t|jj�j|_dS�N)�_r�_new_headersr�url�scheme�type)�self�request�r�@/usr/lib/python3.8/site-packages/pip/_vendor/requests/cookies.py�__init__%szMockRequest.__init__cCs|jSr
)r�rrrr�get_type*szMockRequest.get_typecCst|jj�jSr
)rrr
Znetlocrrrr�get_host-szMockRequest.get_hostcCs|��Sr
�rrrrr�get_origin_req_host0szMockRequest.get_origin_req_hostcCsT|jj�d�s|jjSt|jjddd�}t|jj�}t|j||j|j	|j
|jg�S)NZHostzutf-8)�encoding)r�headers�getr
rrrr�pathZparamsZqueryZfragment)r�hostZparsedrrr�get_full_url3s�zMockRequest.get_full_urlcCsdS�NTrrrrr�is_unverifiableAszMockRequest.is_unverifiablecCs||jjkp||jkSr
)rrr�r�namerrr�
has_headerDszMockRequest.has_headerNcCs|jj�||j�||��Sr
)rrrr)rr#�defaultrrr�
get_headerGszMockRequest.get_headercCstd��dS)zMcookielib has no legitimate use for this method; add it back if you find one.z=Cookie headers should be added with add_unredirected_header()N)�NotImplementedError)r�key�valrrr�
add_headerJszMockRequest.add_headercCs||j|<dSr
�r�rr#�valuerrr�add_unredirected_headerNsz#MockRequest.add_unredirected_headercCs|jSr
r+rrrr�get_new_headersQszMockRequest.get_new_headerscCs|��Sr
)r!rrrr�unverifiableTszMockRequest.unverifiablecCs|��Sr
)rrrrr�origin_req_hostXszMockRequest.origin_req_hostcCs|��Sr
rrrrrr\szMockRequest.host)N)�__name__�
__module__�__qualname__�__doc__rrrrrr!r$r&r*r.r/�propertyr0r1rrrrrr	s$


r	c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�MockResponsez�Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.

    ...what? Basically, expose the parsed HTTP headers from the server response
    the way `cookielib` expects to see them.
    cCs
||_dS)z�Make a MockResponse for `cookielib` to read.

        :param headers: a httplib.HTTPMessage or analogous carrying the headers
        N��_headers)rrrrrrhszMockResponse.__init__cCs|jSr
r8rrrr�infooszMockResponse.infocCs|j�|�dSr
)r9�
getheadersr"rrrr;rszMockResponse.getheadersN)r2r3r4r5rr:r;rrrrr7asr7cCs8t|d�r|jsdSt|�}t|jj�}|�||�dS)z�Extract the cookies from the response into a CookieJar.

    :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar)
    :param request: our own requests.Request object
    :param response: urllib3.HTTPResponse object
    �_original_responseN)�hasattrr<r	r7�msgZextract_cookies)�jarrZresponseZreq�resrrr�extract_cookies_to_jarvs
�rAcCs t|�}|�|�|���d�S)zj
    Produce an appropriate Cookie header string to be sent with `request`, or None.

    :rtype: str
    �Cookie)r	Zadd_cookie_headerr/r)r?r�rrrr�get_cookie_header�s
rDcCszg}|D]N}|j|krq|dk	r,||jkr,q|dk	r@||jkr@q|�|j|j|jf�q|D]\}}}|�|||�q\dS)zkUnsets a cookie by name, by default over all domains and paths.

    Wraps CookieJar.clear(), is O(n).
    N)r#�domainr�append�clear)�	cookiejarr#rErZ
clearables�cookierrr�remove_cookie_by_name�s
rJc@seZdZdZdS)�CookieConflictErrorz�There are two cookies that meet the criteria specified in the cookie jar.
    Use .get and .set and include domain and path args in order to be more specific.
    N)r2r3r4r5rrrrrK�srKcs�eZdZdZd3dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zd4dd�Z�fdd�Zdd�Zdd �Zd!d"�Z�fd#d$�Z�fd%d&�Zd5d'd(�Zd6d)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Z�ZS)7�RequestsCookieJara�Compatibility class; is a cookielib.CookieJar, but exposes a dict
    interface.

    This is the CookieJar we create by default for requests and sessions that
    don't specify one, since some clients may expect response.cookies and
    session.cookies to support dict operations.

    Requests does not use the dict interface internally; it's just for
    compatibility with external client code. All requests code should work
    out of the box with externally provided instances of ``CookieJar``, e.g.
    ``LWPCookieJar`` and ``FileCookieJar``.

    Unlike a regular CookieJar, this class is pickleable.

    .. warning:: dictionary operations that are normally O(1) may be O(n).
    NcCs.z|�|||�WStk
r(|YSXdS)z�Dict-like get() that also supports optional domain and path args in
        order to resolve naming collisions from using one cookie jar over
        multiple domains.

        .. warning:: operation is O(n), not O(1).
        N)�_find_no_duplicates�KeyError)rr#r%rErrrrr�szRequestsCookieJar.getcKsX|dkr(t|||�d�|�d�d�dSt|t�r<t|�}nt||f|�}|�|�|S)z�Dict-like set() that also supports optional domain and path args in
        order to resolve naming collisions from using one cookie jar over
        multiple domains.
        NrEr)rEr)rJr�
isinstancer�morsel_to_cookie�
create_cookie�
set_cookie)rr#r-�kwargs�crrr�set�s


zRequestsCookieJar.setccst|�D]}|jVqdS)z�Dict-like iterkeys() that returns an iterator of names of cookies
        from the jar.

        .. seealso:: itervalues() and iteritems().
        N)�iterr#�rrIrrr�iterkeys�szRequestsCookieJar.iterkeyscCst|���S)z�Dict-like keys() that returns a list of names of cookies from the
        jar.

        .. seealso:: values() and items().
        )�listrXrrrr�keys�szRequestsCookieJar.keysccst|�D]}|jVqdS)z�Dict-like itervalues() that returns an iterator of values of cookies
        from the jar.

        .. seealso:: iterkeys() and iteritems().
        N)rVr-rWrrr�
itervalues�szRequestsCookieJar.itervaluescCst|���S)z�Dict-like values() that returns a list of values of cookies from the
        jar.

        .. seealso:: keys() and items().
        )rYr[rrrr�values�szRequestsCookieJar.valuesccs t|�D]}|j|jfVqdS)z�Dict-like iteritems() that returns an iterator of name-value tuples
        from the jar.

        .. seealso:: iterkeys() and itervalues().
        N)rVr#r-rWrrr�	iteritems�szRequestsCookieJar.iteritemscCst|���S)z�Dict-like items() that returns a list of name-value tuples from the
        jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a
        vanilla python dict of key value pairs.

        .. seealso:: keys() and values().
        )rYr]rrrr�itemsszRequestsCookieJar.itemscCs,g}t|�D]}|j|kr|�|j�q|S)z2Utility method to list all the domains in the jar.�rVrErF�rZdomainsrIrrr�list_domainss

zRequestsCookieJar.list_domainscCs,g}t|�D]}|j|kr|�|j�q|S)z0Utility method to list all the paths in the jar.)rVrrF)r�pathsrIrrr�
list_pathss

zRequestsCookieJar.list_pathscCs<g}t|�D]*}|jdk	r*|j|kr*dS|�|j�qdS)zvReturns True if there are multiple domains in the jar.
        Returns False otherwise.

        :rtype: bool
        NTFr_r`rrr�multiple_domainssz"RequestsCookieJar.multiple_domainscCsFi}t|�D]4}|dks"|j|kr|dks4|j|kr|j||j<q|S)z�Takes as an argument an optional domain and path and returns a plain
        old Python dict of name-value pairs of cookies that meet the
        requirements.

        :rtype: dict
        N)rVrErr-r#)rrErZ
dictionaryrIrrr�get_dict+s����zRequestsCookieJar.get_dictcs.ztt|��|�WStk
r(YdSXdSr )�superrL�__contains__rKr"��	__class__rrrg;szRequestsCookieJar.__contains__cCs
|�|�S)z�Dict-like __getitem__() for compatibility with client code. Throws
        exception if there are more than one cookie with name. In that case,
        use the more explicit get() method instead.

        .. warning:: operation is O(n), not O(1).
        )rMr"rrr�__getitem__AszRequestsCookieJar.__getitem__cCs|�||�dS)z�Dict-like __setitem__ for compatibility with client code. Throws
        exception if there is already a cookie of that name in the jar. In that
        case, use the more explicit set() method instead.
        N)rUr,rrr�__setitem__JszRequestsCookieJar.__setitem__cCst||�dS)zlDeletes a cookie given a name. Wraps ``cookielib.CookieJar``'s
        ``remove_cookie_by_name()``.
        N)rJr"rrr�__delitem__QszRequestsCookieJar.__delitem__csLt|jd�r4|j�d�r4|j�d�r4|j�dd�|_tt|�j|f|�|�S)N�
startswith�"z\"�)r=r-rm�endswith�replacerfrLrR)rrI�argsrSrhrrrRWs$zRequestsCookieJar.set_cookiecs<t|tj�r(|D]}|�t�|��qntt|��|�dS)zAUpdates this jar with cookies from another CookieJar or dict-likeN)rOr�	CookieJarrR�copyrfrL�update)r�otherrIrhrrru\szRequestsCookieJar.updatecCs\t|�D]<}|j|kr|dks(|j|kr|dks:|j|kr|jSqtd|||f��dS)a�Requests uses this method internally to get cookie values.

        If there are conflicting cookies, _find arbitrarily chooses one.
        See _find_no_duplicates if you want an exception thrown if there are
        conflicting cookies.

        :param name: a string containing name of cookie
        :param domain: (optional) string containing domain of cookie
        :param path: (optional) string containing path of cookie
        :return: cookie.value
        N�name=%r, domain=%r, path=%r)rVr#rErr-rN)rr#rErrIrrr�_findds
zRequestsCookieJar._findcCsxd}t|�D]L}|j|kr|dks,|j|kr|dks>|j|kr|dk	rRtd|��|j}q|rb|Std|||f��dS)a�Both ``__get_item__`` and ``get`` call this function: it's never
        used elsewhere in Requests.

        :param name: a string containing name of cookie
        :param domain: (optional) string containing domain of cookie
        :param path: (optional) string containing path of cookie
        :raises KeyError: if cookie is not found
        :raises CookieConflictError: if there are multiple cookies
            that match name and optionally domain and path
        :return: cookie.value
        Nz(There are multiple cookies with name, %rrw)rVr#rErrKr-rN)rr#rErZtoReturnrIrrrrMxs
z%RequestsCookieJar._find_no_duplicatescCs|j��}|�d�|S)�4Unlike a normal CookieJar, this class is pickleable.�
_cookies_lock)�__dict__rt�pop�r�staterrr�__getstate__�s

zRequestsCookieJar.__getstate__cCs$|j�|�d|jkr t��|_dS)ryrzN)r{ru�	threading�RLockrzr}rrr�__setstate__�s
zRequestsCookieJar.__setstate__cCs"t�}|�|���|�|�|S)z(Return a copy of this RequestsCookieJar.)rLZ
set_policy�
get_policyru)rZnew_cjrrrrt�s
zRequestsCookieJar.copycCs|jS)z&Return the CookiePolicy instance used.)Z_policyrrrrr��szRequestsCookieJar.get_policy)NNN)NN)NN)NN)r2r3r4r5rrUrXrZr[r\r]r^rarcrdrergrjrkrlrRrurxrMrr�rtr��
__classcell__rrrhrrL�s2
				
	

rLcCsN|dkrdSt|d�r|��St�|�}|��|D]}|�t�|��q4|S)Nrt)r=rtrGrR)r?Znew_jarrIrrr�_copy_cookie_jar�s

r�cKs�d||ddddddddddidd�
}t|�t|�}|rLd	}t|t|���|�|�t|d
�|d<t|d�|d
<|d�d�|d<t|d�|d<tjf|�S)z�Make a cookie from underspecified parameters.

    By default, the pair of `name` and `value` will be set for the domain ''
    and sent on every request (this is sometimes called a "supercookie").
    rNro�/FT�HttpOnly)
�versionr#r-�portrEr�secure�expires�discard�comment�comment_url�rest�rfc2109z4create_cookie() got unexpected keyword arguments: %sr�Zport_specifiedrEZdomain_specified�.Zdomain_initial_dotrZpath_specified)rU�	TypeErrorrYru�boolrmrrB)r#r-rS�resultZbadargs�errrrrrQ�s0�
rQcCs�d}|drPztt��t|d��}Wqrtk
rLtd|d��YqrXn"|drrd}t�t�|d|��}t|dt|d�d|d||j	|d	dd
|didt|d�|j
|d
p�dd�
S)zBConvert a Morsel object into a Cookie containing the one k/v pair.Nzmax-agezmax-age: %s must be integerr�z%a, %d-%b-%Y %H:%M:%S GMTr�FrErr�Zhttponlyr�r�r)
r�r�r�rEr�r#rr�r�r�r�r-r�)�int�time�
ValueErrorr��calendarZtimegm�strptimerQr�r(r-)Zmorselr�Z
time_templaterrrrP�s4�



�rPTcCsR|dkrt�}|dk	rNdd�|D�}|D]$}|s8||kr(|�t|||��q(|S)aCReturns a CookieJar from a key/value dictionary.

    :param cookie_dict: Dict of key/values to insert into CookieJar.
    :param cookiejar: (optional) A cookiejar to add the cookies to.
    :param overwrite: (optional) If False, will not replace cookies
        already in the jar with new ones.
    :rtype: CookieJar
    NcSsg|]
}|j�qSr)r#)�.0rIrrr�
<listcomp>	sz'cookiejar_from_dict.<locals>.<listcomp>)rLrRrQ)Zcookie_dictrH�	overwriteZnames_from_jarr#rrr�cookiejar_from_dict�s	r�cCsvt|tj�std��t|t�r.t||dd�}nDt|tj�rrz|�|�Wn(tk
rp|D]}|�|�q\YnX|S)z�Add cookies to cookiejar and returns a merged CookieJar.

    :param cookiejar: CookieJar object to add the cookies to.
    :param cookies: Dictionary or CookieJar object to be added.
    :rtype: CookieJar
    z!You can only merge into CookieJarF)rHr�)	rOrrsr��dictr�ru�AttributeErrorrR)rHZcookiesZ
cookie_in_jarrrr�
merge_cookiess
�r�)NN)NT)r5rtr�r�Z_internal_utilsr�compatrrrrrr��ImportErrorZdummy_threading�objectr	r7rArDrJ�RuntimeErrorrKrsrLr�rQrPr�r�rrrr�<module>s.	H
$
site-packages/pip/_vendor/requests/__pycache__/sessions.cpython-38.pyc000064400000046062151446176770022123 0ustar00U

��.e�r�@s�dZddlZddlZddlZddlmZddlmZddlm	Z	m
Z
mZmZm
Z
mZddlmZmZmZmZddlmZmZmZdd	lmZmZdd
lmZddlmZmZm Z ddl!m"Z"m#Z#m$Z$m%Z%dd
l&m'Z'ddl(m)Z)ddlm*Z*m+Z+m,Z,m-Z-m.Z.m/Z/ddl0m1Z1ddlm2Z2ej3dk�rNz
ej4Z5Wne6k
�rJej7Z5YnXnejZ5efdd�Z8efdd�Z9Gdd�de:�Z;Gdd�de;�Z<dd�Z=dS)z�
requests.session
~~~~~~~~~~~~~~~~

This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
�N)�	timedelta�)�_basic_auth_str)�	cookielib�is_py3�OrderedDict�urljoin�urlparse�Mapping)�cookiejar_from_dict�extract_cookies_to_jar�RequestsCookieJar�
merge_cookies)�Request�PreparedRequest�DEFAULT_REDIRECT_LIMIT)�
default_hooks�
dispatch_hook)�to_native_string)�to_key_val_list�default_headers�
DEFAULT_PORTS)�TooManyRedirects�
InvalidSchema�ChunkedEncodingError�ContentDecodingError)�CaseInsensitiveDict)�HTTPAdapter)�requote_uri�get_environ_proxies�get_netrc_auth�should_bypass_proxies�get_auth_from_url�rewind_body)�codes)�REDIRECT_STATIZwin32cCsp|dkr|S|dkr|St|t�r,t|t�s0|S|t|��}|�t|��dd�|��D�}|D]
}||=q`|S)z�Determines appropriate setting for a given request, taking into account
    the explicit setting on that request, and the setting in the session. If a
    setting is a dictionary, they will be merged together using `dict_class`
    NcSsg|]\}}|dkr|�qS�N�)�.0�k�vr'r'�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/sessions.py�
<listcomp>Isz!merge_setting.<locals>.<listcomp>)�
isinstancer
r�update�items)Zrequest_settingZsession_setting�
dict_classZmerged_settingZ	none_keys�keyr'r'r+�
merge_setting1s��r2cCs@|dks|�d�gkr|S|dks0|�d�gkr4|St|||�S)z�Properly merges both requests and session hooks.

    This is necessary because when request_hooks == {'response': []}, the
    merge breaks Session hooks entirely.
    N�response)�getr2)Z
request_hooksZ
session_hooksr0r'r'r+�merge_hooksPs
r5c@s>eZdZdd�Zdd�Zddd	�Zd
d�Zdd
�Zdd�ZdS)�SessionRedirectMixincCs,|jr(|jd}tr|�d�}t|d�SdS)z7Receives a Response. Returns a redirect URI or ``None``�location�latin1�utf8N)Zis_redirect�headersr�encoder)�self�respr7r'r'r+�get_redirect_targetas


z(SessionRedirectMixin.get_redirect_targetcCs�t|�}t|�}|j|jkr dS|jdkrL|jdkrL|jdkrL|jdkrLdS|j|jk}|j|jk}t�|jd�df}|s�|j|kr�|j|kr�dS|p�|S)zFDecide whether Authorization header should be removed when redirectingTZhttp)�PNZhttps)i�NFN)r	Zhostname�schemeZportrr4)r<Zold_urlZnew_urlZ
old_parsedZ
new_parsedZchanged_portZchanged_schemeZdefault_portr'r'r+�should_strip_authvs$���z&SessionRedirectMixin.should_strip_authFNTc	
ksZg}
|�|�}t|j�j}|�rV|��}
|
�|�|
dd�|_z
|jWn(tt	t
fk
rr|jjdd�YnXt
|j�|jkr�td|j|d��|��|�d�r�t|j�}dt|j�|f}t|�}|jd	kr�|r�|j|d
�}n|jr�|j}|��}|j�st|jt|��}nt|�}t|�|
_|�|
|�|jtjtjfk�rld}|D]}|
j�|d��qPd|
_ |
j}z
|d=Wnt!k
�r�YnXt"|
j#||j�t$|
j#|j%�|
�&|
j#�|�'|
|�}|�(|
|�|
j)dk	�o�d
|k�p�d|k}|�rt*|
�|
}|�r|Vq|j+|f|||||dd�|	��}t"|j%|
|j�|�|�}|VqdS)zBReceives a Response. Returns a generator of Responses or Requests.rNF)Zdecode_contentzExceeded %s redirects.)r3z//z%s:%s�)�fragment)�Content-LengthzContent-Type�Transfer-EncodingZCookierDrE)�stream�timeout�verify�cert�proxies�allow_redirects),r>r	�urlrC�copy�append�history�contentrr�RuntimeError�raw�read�len�
max_redirectsr�close�
startswithrr@�_replaceZgeturlZnetlocrr�rebuild_method�status_coder$Ztemporary_redirectZpermanent_redirectr:�popZbody�KeyErrorrZ_cookiesr�cookiesZprepare_cookies�rebuild_proxies�rebuild_authZ_body_positionr#�send)r<r=�reqrFrGrHrIrJ�yield_requestsZadapter_kwargsZhistrLZprevious_fragment�prepared_requestZparsed_rurlZparsedZpurged_headers�headerr:Z
rewindabler'r'r+�resolve_redirects�s�






����
z&SessionRedirectMixin.resolve_redirectscCsR|j}|j}d|kr*|�|jj|�r*|d=|jr8t|�nd}|dk	rN|�|�dS)z�When being redirected we may want to strip authentication from the
        request to avoid leaking credentials. This method intelligently removes
        and reapplies authentication where possible to avoid credential loss.
        Z
AuthorizationN)r:rLrA�request�	trust_envr Zprepare_auth)r<rcr3r:rLZnew_authr'r'r+r_s
z!SessionRedirectMixin.rebuild_authc
Cs�|dk	r|ni}|j}|j}t|�j}|��}|�d�}t||d�}|jr||s|t||d�}	|	�||	�d��}
|
r||�	||
�d|kr�|d=zt
||�\}}Wntk
r�d\}}YnX|r�|r�t||�|d<|S)a�This method re-evaluates the proxy configuration by considering the
        environment variables. If we are redirected to a URL covered by
        NO_PROXY, we strip the proxy configuration. Otherwise, we set missing
        proxy keys for this URL (in case they were stripped by a previous
        redirect).

        This method also replaces the Proxy-Authorization header where
        necessary.

        :rtype: dict
        N�no_proxy�rh�allzProxy-Authorization)NN)
r:rLr	r@rMr4r!rgr�
setdefaultr"r\r)
r<rcrJr:rLr@Znew_proxiesrhZbypass_proxyZenviron_proxies�proxyZusernameZpasswordr'r'r+r^s*


z$SessionRedirectMixin.rebuild_proxiescCsX|j}|jtjkr|dkrd}|jtjkr6|dkr6d}|jtjkrN|dkrNd}||_dS)z�When being redirected we may want to change the method of the request
        based on certain specs or browser behavior.
        �HEAD�GET�POSTN)�methodrZr$Z	see_other�foundZmoved)r<rcr3rpr'r'r+rY=sz#SessionRedirectMixin.rebuild_method)FNTNNF)	�__name__�
__module__�__qualname__r>rArer_r^rYr'r'r'r+r6_s�
q)r6c@s�eZdZdZdddddddd	d
ddd
dg
Zdd�Zdd�Zdd�Zdd�Zd7dd�Z	dd�Z
dd�Zdd �Zd8d!d"�Z
d9d#d$�Zd:d%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�ZdS);�Sessiona�A Requests session.

    Provides cookie persistence, connection-pooling, and configuration.

    Basic Usage::

      >>> import requests
      >>> s = requests.Session()
      >>> s.get('https://httpbin.org/get')
      <Response [200]>

    Or as a context manager::

      >>> with requests.Session() as s:
      >>>     s.get('https://httpbin.org/get')
      <Response [200]>
    r:r]�authrJ�hooks�paramsrHrIZprefetch�adaptersrFrgrUcCsrt�|_d|_i|_t�|_i|_d|_d|_d|_	t
|_d|_t
i�|_t�|_|�dt��|�dt��dS)NFTzhttps://zhttp://)rr:rvrJrrwrxrFrHrIrrUrgrr]rry�mountr�r<r'r'r+�__init__ms
zSession.__init__cCs|Sr&r'r{r'r'r+�	__enter__�szSession.__enter__cGs|��dSr&)rV)r<�argsr'r'r+�__exit__�szSession.__exit__c
Cs�|jpi}t|tj�st|�}ttt�|j�|�}|j}|jrR|sR|jsRt	|j
�}t�}|j|j
��|j
|j|j|jt|j|jtd�t|j|j�t||j�|t|j|j�d�
|S)a�Constructs a :class:`PreparedRequest <PreparedRequest>` for
        transmission and returns it. The :class:`PreparedRequest` has settings
        merged from the :class:`Request <Request>` instance and those of the
        :class:`Session`.

        :param request: :class:`Request` instance to prepare with this
            session's settings.
        :rtype: requests.PreparedRequest
        )r0)
rprL�files�data�jsonr:rxrvr]rw)r]r-rZ	CookieJarrrr
rvrgr rLrZpreparerp�upperr�r�r�r2r:rrxr5rw)r<rfr]Zmerged_cookiesrv�pr'r'r+�prepare_request�s0

�

�zSession.prepare_requestNTcCstt|��||||pi||pi|||d�
}|�|�}|p8i}|�|j||
||�}|	|
d�}|�|�|j|f|�}|S)aConstructs a :class:`Request <Request>`, prepares it and sends it.
        Returns :class:`Response <Response>` object.

        :param method: method for the new :class:`Request` object.
        :param url: URL for the new :class:`Request` object.
        :param params: (optional) Dictionary or bytes to be sent in the query
            string for the :class:`Request`.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param json: (optional) json to send in the body of the
            :class:`Request`.
        :param headers: (optional) Dictionary of HTTP Headers to send with the
            :class:`Request`.
        :param cookies: (optional) Dict or CookieJar object to send with the
            :class:`Request`.
        :param files: (optional) Dictionary of ``'filename': file-like-objects``
            for multipart encoding upload.
        :param auth: (optional) Auth tuple or callable to enable
            Basic/Digest/Custom HTTP Auth.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple
        :param allow_redirects: (optional) Set to True by default.
        :type allow_redirects: bool
        :param proxies: (optional) Dictionary mapping protocol or protocol and
            hostname to the URL of the proxy.
        :param stream: (optional) whether to immediately download the response
            content. Defaults to ``False``.
        :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use. Defaults to ``True``.
        :param cert: (optional) if String, path to ssl client cert file (.pem).
            If Tuple, ('cert', 'key') pair.
        :rtype: requests.Response
        )
rprLr:r�r�r�rxrvr]rw)rGrK)rr�r��merge_environment_settingsrLr.r`)r<rprLrxr�r:r]r�rvrGrKrJrwrFrHrIr�raZprepZsettingsZsend_kwargsr=r'r'r+rf�s6)�
��
zSession.requestcKs|�dd�|jd|f|�S)z�Sends a GET request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        rKTrn�rkrf�r<rL�kwargsr'r'r+r4szSession.getcKs|�dd�|jd|f|�S)z�Sends a OPTIONS request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        rKTZOPTIONSr�r�r'r'r+�options$szSession.optionscKs|�dd�|jd|f|�S)z�Sends a HEAD request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        rKFrmr�r�r'r'r+�head/szSession.headcKs|jd|f||d�|��S)a�Sends a POST request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param json: (optional) json to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ro)r�r��rf)r<rLr�r�r�r'r'r+�post:szSession.postcKs|jd|fd|i|��S)auSends a PUT request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ZPUTr�r��r<rLr�r�r'r'r+�putGs
zSession.putcKs|jd|fd|i|��S)awSends a PATCH request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ZPATCHr�r�r�r'r'r+�patchSs
z
Session.patchcKs|jd|f|�S)z�Sends a DELETE request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ZDELETEr�r�r'r'r+�delete_szSession.deletec
Ksz|�d|j�|�d|j�|�d|j�|�d|j�t|t�rJtd��|�dd�}|�	d�}|j
}|j|jd�}t
�}|j|f|�}t
�|}	t|	d	�|_td
||f|�}|jr�|jD]}
t|j|
j|
j�q�t|j||j�|j||f|�}|�rdd�|D�ng}|�r*|�d
|�|��}||_|�sjz"t|j||fddi|���|_Wntk
�rhYnX|�sv|j|S)zISend a given PreparedRequest.

        :rtype: requests.Response
        rFrHrIrJz#You can only send PreparedRequests.rKT)rL)Zsecondsr3cSsg|]}|�qSr'r')r(r=r'r'r+r,�sz Session.send.<locals>.<listcomp>rrb)rkrFrHrIrJr-r�
ValueErrorr[r4rw�get_adapterrL�preferred_clockr`r�elapsedrrOrr]rfrRre�insert�nextZ_next�
StopIterationrP)
r<rfr�rKrFrw�adapter�start�rr�r=�genrOr'r'r+r`isB



"zSession.sendc
Cs�|jrn|dk	r|�d�nd}t||d�}|��D]\}}	|�||	�q0|dksV|dkrntj�d�pltj�d�}t||j�}t||j	�}t||j
�}t||j�}||||d�S)z^
        Check the environment and merge it with some settings.

        :rtype: dict
        NrhriTZREQUESTS_CA_BUNDLEZCURL_CA_BUNDLE)rHrJrFrI)rgr4rr/rk�os�environr2rJrFrHrI)
r<rLrJrFrHrIrhZenv_proxiesr)r*r'r'r+r��s 
��z"Session.merge_environment_settingscCs>|j��D]"\}}|���|���r
|Sq
td|��dS)z~
        Returns the appropriate connection adapter for the given URL.

        :rtype: requests.adapters.BaseAdapter
        z*No connection adapters were found for '%s'N)ryr/�lowerrWr)r<rL�prefixr�r'r'r+r��s
zSession.get_adaptercCs|j��D]}|��q
dS)z+Closes all adapters and as such the sessionN)ry�valuesrV)r<r*r'r'r+rV�sz
Session.closecs>||j�<�fdd�|jD�}|D]}|j�|�|j|<q"dS)zwRegisters a connection adapter to a prefix.

        Adapters are sorted in descending order by prefix length.
        cs g|]}t|�t��kr|�qSr')rT)r(r)�r�r'r+r,�sz!Session.mount.<locals>.<listcomp>N)ryr[)r<r�r�Zkeys_to_mover1r'r�r+rz�s
z
Session.mountcs�fdd��jD�}|S)Ncsi|]}|t�|d��qSr&)�getattr)r(�attrr{r'r+�
<dictcomp>�sz(Session.__getstate__.<locals>.<dictcomp>)�	__attrs__)r<�stater'r{r+�__getstate__�szSession.__getstate__cCs"|��D]\}}t|||�qdSr&)r/�setattr)r<r�r��valuer'r'r+�__setstate__�szSession.__setstate__)NNNNNNNTNNNNNN)NN)N)N)rrrsrt�__doc__r�r|r}rr�rfr4r�r�r�r�r�r�r`r�r�rVrzr�r�r'r'r'r+ruTs`�7)�
G



IrucCst�S)aZ
    Returns a :class:`Session` for context-management.

    .. deprecated:: 1.0.0

        This method has been deprecated since version 1.0.0 and is only kept for
        backwards compatibility. New code should use :class:`~requests.sessions.Session`
        to create a session. This may be removed at a future date.

    :rtype: Session
    )rur'r'r'r+�session�sr�)>r�r��sys�timeZdatetimerrvr�compatrrrrr	r
r]rrr
rZmodelsrrrrwrrZ_internal_utilsrZutilsrrr�
exceptionsrrrrZ
structuresrryrrrr r!r"r#Zstatus_codesr$r%�platform�perf_counterr��AttributeErrorZclockr2r5�objectr6rur�r'r'r'r+�<module>s@  
v%site-packages/pip/_vendor/requests/__pycache__/sessions.cpython-38.opt-1.pyc000064400000046062151446176770023062 0ustar00U

��.e�r�@s�dZddlZddlZddlZddlmZddlmZddlm	Z	m
Z
mZmZm
Z
mZddlmZmZmZmZddlmZmZmZdd	lmZmZdd
lmZddlmZmZm Z ddl!m"Z"m#Z#m$Z$m%Z%dd
l&m'Z'ddl(m)Z)ddlm*Z*m+Z+m,Z,m-Z-m.Z.m/Z/ddl0m1Z1ddlm2Z2ej3dk�rNz
ej4Z5Wne6k
�rJej7Z5YnXnejZ5efdd�Z8efdd�Z9Gdd�de:�Z;Gdd�de;�Z<dd�Z=dS)z�
requests.session
~~~~~~~~~~~~~~~~

This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
�N)�	timedelta�)�_basic_auth_str)�	cookielib�is_py3�OrderedDict�urljoin�urlparse�Mapping)�cookiejar_from_dict�extract_cookies_to_jar�RequestsCookieJar�
merge_cookies)�Request�PreparedRequest�DEFAULT_REDIRECT_LIMIT)�
default_hooks�
dispatch_hook)�to_native_string)�to_key_val_list�default_headers�
DEFAULT_PORTS)�TooManyRedirects�
InvalidSchema�ChunkedEncodingError�ContentDecodingError)�CaseInsensitiveDict)�HTTPAdapter)�requote_uri�get_environ_proxies�get_netrc_auth�should_bypass_proxies�get_auth_from_url�rewind_body)�codes)�REDIRECT_STATIZwin32cCsp|dkr|S|dkr|St|t�r,t|t�s0|S|t|��}|�t|��dd�|��D�}|D]
}||=q`|S)z�Determines appropriate setting for a given request, taking into account
    the explicit setting on that request, and the setting in the session. If a
    setting is a dictionary, they will be merged together using `dict_class`
    NcSsg|]\}}|dkr|�qS�N�)�.0�k�vr'r'�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/sessions.py�
<listcomp>Isz!merge_setting.<locals>.<listcomp>)�
isinstancer
r�update�items)Zrequest_settingZsession_setting�
dict_classZmerged_settingZ	none_keys�keyr'r'r+�
merge_setting1s��r2cCs@|dks|�d�gkr|S|dks0|�d�gkr4|St|||�S)z�Properly merges both requests and session hooks.

    This is necessary because when request_hooks == {'response': []}, the
    merge breaks Session hooks entirely.
    N�response)�getr2)Z
request_hooksZ
session_hooksr0r'r'r+�merge_hooksPs
r5c@s>eZdZdd�Zdd�Zddd	�Zd
d�Zdd
�Zdd�ZdS)�SessionRedirectMixincCs,|jr(|jd}tr|�d�}t|d�SdS)z7Receives a Response. Returns a redirect URI or ``None``�location�latin1�utf8N)Zis_redirect�headersr�encoder)�self�respr7r'r'r+�get_redirect_targetas


z(SessionRedirectMixin.get_redirect_targetcCs�t|�}t|�}|j|jkr dS|jdkrL|jdkrL|jdkrL|jdkrLdS|j|jk}|j|jk}t�|jd�df}|s�|j|kr�|j|kr�dS|p�|S)zFDecide whether Authorization header should be removed when redirectingTZhttp)�PNZhttps)i�NFN)r	Zhostname�schemeZportrr4)r<Zold_urlZnew_urlZ
old_parsedZ
new_parsedZchanged_portZchanged_schemeZdefault_portr'r'r+�should_strip_authvs$���z&SessionRedirectMixin.should_strip_authFNTc	
ksZg}
|�|�}t|j�j}|�rV|��}
|
�|�|
dd�|_z
|jWn(tt	t
fk
rr|jjdd�YnXt
|j�|jkr�td|j|d��|��|�d�r�t|j�}dt|j�|f}t|�}|jd	kr�|r�|j|d
�}n|jr�|j}|��}|j�st|jt|��}nt|�}t|�|
_|�|
|�|jtjtjfk�rld}|D]}|
j�|d��qPd|
_ |
j}z
|d=Wnt!k
�r�YnXt"|
j#||j�t$|
j#|j%�|
�&|
j#�|�'|
|�}|�(|
|�|
j)dk	�o�d
|k�p�d|k}|�rt*|
�|
}|�r|Vq|j+|f|||||dd�|	��}t"|j%|
|j�|�|�}|VqdS)zBReceives a Response. Returns a generator of Responses or Requests.rNF)Zdecode_contentzExceeded %s redirects.)r3z//z%s:%s�)�fragment)�Content-LengthzContent-Type�Transfer-EncodingZCookierDrE)�stream�timeout�verify�cert�proxies�allow_redirects),r>r	�urlrC�copy�append�history�contentrr�RuntimeError�raw�read�len�
max_redirectsr�close�
startswithrr@�_replaceZgeturlZnetlocrr�rebuild_method�status_coder$Ztemporary_redirectZpermanent_redirectr:�popZbody�KeyErrorrZ_cookiesr�cookiesZprepare_cookies�rebuild_proxies�rebuild_authZ_body_positionr#�send)r<r=�reqrFrGrHrIrJ�yield_requestsZadapter_kwargsZhistrLZprevious_fragment�prepared_requestZparsed_rurlZparsedZpurged_headers�headerr:Z
rewindabler'r'r+�resolve_redirects�s�






����
z&SessionRedirectMixin.resolve_redirectscCsR|j}|j}d|kr*|�|jj|�r*|d=|jr8t|�nd}|dk	rN|�|�dS)z�When being redirected we may want to strip authentication from the
        request to avoid leaking credentials. This method intelligently removes
        and reapplies authentication where possible to avoid credential loss.
        Z
AuthorizationN)r:rLrA�request�	trust_envr Zprepare_auth)r<rcr3r:rLZnew_authr'r'r+r_s
z!SessionRedirectMixin.rebuild_authc
Cs�|dk	r|ni}|j}|j}t|�j}|��}|�d�}t||d�}|jr||s|t||d�}	|	�||	�d��}
|
r||�	||
�d|kr�|d=zt
||�\}}Wntk
r�d\}}YnX|r�|r�t||�|d<|S)a�This method re-evaluates the proxy configuration by considering the
        environment variables. If we are redirected to a URL covered by
        NO_PROXY, we strip the proxy configuration. Otherwise, we set missing
        proxy keys for this URL (in case they were stripped by a previous
        redirect).

        This method also replaces the Proxy-Authorization header where
        necessary.

        :rtype: dict
        N�no_proxy�rh�allzProxy-Authorization)NN)
r:rLr	r@rMr4r!rgr�
setdefaultr"r\r)
r<rcrJr:rLr@Znew_proxiesrhZbypass_proxyZenviron_proxies�proxyZusernameZpasswordr'r'r+r^s*


z$SessionRedirectMixin.rebuild_proxiescCsX|j}|jtjkr|dkrd}|jtjkr6|dkr6d}|jtjkrN|dkrNd}||_dS)z�When being redirected we may want to change the method of the request
        based on certain specs or browser behavior.
        �HEAD�GET�POSTN)�methodrZr$Z	see_other�foundZmoved)r<rcr3rpr'r'r+rY=sz#SessionRedirectMixin.rebuild_method)FNTNNF)	�__name__�
__module__�__qualname__r>rArer_r^rYr'r'r'r+r6_s�
q)r6c@s�eZdZdZdddddddd	d
ddd
dg
Zdd�Zdd�Zdd�Zdd�Zd7dd�Z	dd�Z
dd�Zdd �Zd8d!d"�Z
d9d#d$�Zd:d%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�ZdS);�Sessiona�A Requests session.

    Provides cookie persistence, connection-pooling, and configuration.

    Basic Usage::

      >>> import requests
      >>> s = requests.Session()
      >>> s.get('https://httpbin.org/get')
      <Response [200]>

    Or as a context manager::

      >>> with requests.Session() as s:
      >>>     s.get('https://httpbin.org/get')
      <Response [200]>
    r:r]�authrJ�hooks�paramsrHrIZprefetch�adaptersrFrgrUcCsrt�|_d|_i|_t�|_i|_d|_d|_d|_	t
|_d|_t
i�|_t�|_|�dt��|�dt��dS)NFTzhttps://zhttp://)rr:rvrJrrwrxrFrHrIrrUrgrr]rry�mountr�r<r'r'r+�__init__ms
zSession.__init__cCs|Sr&r'r{r'r'r+�	__enter__�szSession.__enter__cGs|��dSr&)rV)r<�argsr'r'r+�__exit__�szSession.__exit__c
Cs�|jpi}t|tj�st|�}ttt�|j�|�}|j}|jrR|sR|jsRt	|j
�}t�}|j|j
��|j
|j|j|jt|j|jtd�t|j|j�t||j�|t|j|j�d�
|S)a�Constructs a :class:`PreparedRequest <PreparedRequest>` for
        transmission and returns it. The :class:`PreparedRequest` has settings
        merged from the :class:`Request <Request>` instance and those of the
        :class:`Session`.

        :param request: :class:`Request` instance to prepare with this
            session's settings.
        :rtype: requests.PreparedRequest
        )r0)
rprL�files�data�jsonr:rxrvr]rw)r]r-rZ	CookieJarrrr
rvrgr rLrZpreparerp�upperr�r�r�r2r:rrxr5rw)r<rfr]Zmerged_cookiesrv�pr'r'r+�prepare_request�s0

�

�zSession.prepare_requestNTcCstt|��||||pi||pi|||d�
}|�|�}|p8i}|�|j||
||�}|	|
d�}|�|�|j|f|�}|S)aConstructs a :class:`Request <Request>`, prepares it and sends it.
        Returns :class:`Response <Response>` object.

        :param method: method for the new :class:`Request` object.
        :param url: URL for the new :class:`Request` object.
        :param params: (optional) Dictionary or bytes to be sent in the query
            string for the :class:`Request`.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param json: (optional) json to send in the body of the
            :class:`Request`.
        :param headers: (optional) Dictionary of HTTP Headers to send with the
            :class:`Request`.
        :param cookies: (optional) Dict or CookieJar object to send with the
            :class:`Request`.
        :param files: (optional) Dictionary of ``'filename': file-like-objects``
            for multipart encoding upload.
        :param auth: (optional) Auth tuple or callable to enable
            Basic/Digest/Custom HTTP Auth.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple
        :param allow_redirects: (optional) Set to True by default.
        :type allow_redirects: bool
        :param proxies: (optional) Dictionary mapping protocol or protocol and
            hostname to the URL of the proxy.
        :param stream: (optional) whether to immediately download the response
            content. Defaults to ``False``.
        :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use. Defaults to ``True``.
        :param cert: (optional) if String, path to ssl client cert file (.pem).
            If Tuple, ('cert', 'key') pair.
        :rtype: requests.Response
        )
rprLr:r�r�r�rxrvr]rw)rGrK)rr�r��merge_environment_settingsrLr.r`)r<rprLrxr�r:r]r�rvrGrKrJrwrFrHrIr�raZprepZsettingsZsend_kwargsr=r'r'r+rf�s6)�
��
zSession.requestcKs|�dd�|jd|f|�S)z�Sends a GET request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        rKTrn�rkrf�r<rL�kwargsr'r'r+r4szSession.getcKs|�dd�|jd|f|�S)z�Sends a OPTIONS request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        rKTZOPTIONSr�r�r'r'r+�options$szSession.optionscKs|�dd�|jd|f|�S)z�Sends a HEAD request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        rKFrmr�r�r'r'r+�head/szSession.headcKs|jd|f||d�|��S)a�Sends a POST request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param json: (optional) json to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ro)r�r��rf)r<rLr�r�r�r'r'r+�post:szSession.postcKs|jd|fd|i|��S)auSends a PUT request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ZPUTr�r��r<rLr�r�r'r'r+�putGs
zSession.putcKs|jd|fd|i|��S)awSends a PATCH request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ZPATCHr�r�r�r'r'r+�patchSs
z
Session.patchcKs|jd|f|�S)z�Sends a DELETE request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        ZDELETEr�r�r'r'r+�delete_szSession.deletec
Ksz|�d|j�|�d|j�|�d|j�|�d|j�t|t�rJtd��|�dd�}|�	d�}|j
}|j|jd�}t
�}|j|f|�}t
�|}	t|	d	�|_td
||f|�}|jr�|jD]}
t|j|
j|
j�q�t|j||j�|j||f|�}|�rdd�|D�ng}|�r*|�d
|�|��}||_|�sjz"t|j||fddi|���|_Wntk
�rhYnX|�sv|j|S)zISend a given PreparedRequest.

        :rtype: requests.Response
        rFrHrIrJz#You can only send PreparedRequests.rKT)rL)Zsecondsr3cSsg|]}|�qSr'r')r(r=r'r'r+r,�sz Session.send.<locals>.<listcomp>rrb)rkrFrHrIrJr-r�
ValueErrorr[r4rw�get_adapterrL�preferred_clockr`r�elapsedrrOrr]rfrRre�insert�nextZ_next�
StopIterationrP)
r<rfr�rKrFrw�adapter�start�rr�r=�genrOr'r'r+r`isB



"zSession.sendc
Cs�|jrn|dk	r|�d�nd}t||d�}|��D]\}}	|�||	�q0|dksV|dkrntj�d�pltj�d�}t||j�}t||j	�}t||j
�}t||j�}||||d�S)z^
        Check the environment and merge it with some settings.

        :rtype: dict
        NrhriTZREQUESTS_CA_BUNDLEZCURL_CA_BUNDLE)rHrJrFrI)rgr4rr/rk�os�environr2rJrFrHrI)
r<rLrJrFrHrIrhZenv_proxiesr)r*r'r'r+r��s 
��z"Session.merge_environment_settingscCs>|j��D]"\}}|���|���r
|Sq
td|��dS)z~
        Returns the appropriate connection adapter for the given URL.

        :rtype: requests.adapters.BaseAdapter
        z*No connection adapters were found for '%s'N)ryr/�lowerrWr)r<rL�prefixr�r'r'r+r��s
zSession.get_adaptercCs|j��D]}|��q
dS)z+Closes all adapters and as such the sessionN)ry�valuesrV)r<r*r'r'r+rV�sz
Session.closecs>||j�<�fdd�|jD�}|D]}|j�|�|j|<q"dS)zwRegisters a connection adapter to a prefix.

        Adapters are sorted in descending order by prefix length.
        cs g|]}t|�t��kr|�qSr')rT)r(r)�r�r'r+r,�sz!Session.mount.<locals>.<listcomp>N)ryr[)r<r�r�Zkeys_to_mover1r'r�r+rz�s
z
Session.mountcs�fdd��jD�}|S)Ncsi|]}|t�|d��qSr&)�getattr)r(�attrr{r'r+�
<dictcomp>�sz(Session.__getstate__.<locals>.<dictcomp>)�	__attrs__)r<�stater'r{r+�__getstate__�szSession.__getstate__cCs"|��D]\}}t|||�qdSr&)r/�setattr)r<r�r��valuer'r'r+�__setstate__�szSession.__setstate__)NNNNNNNTNNNNNN)NN)N)N)rrrsrt�__doc__r�r|r}rr�rfr4r�r�r�r�r�r�r`r�r�rVrzr�r�r'r'r'r+ruTs`�7)�
G



IrucCst�S)aZ
    Returns a :class:`Session` for context-management.

    .. deprecated:: 1.0.0

        This method has been deprecated since version 1.0.0 and is only kept for
        backwards compatibility. New code should use :class:`~requests.sessions.Session`
        to create a session. This may be removed at a future date.

    :rtype: Session
    )rur'r'r'r+�session�sr�)>r�r��sys�timeZdatetimerrvr�compatrrrrr	r
r]rrr
rZmodelsrrrrwrrZ_internal_utilsrZutilsrrr�
exceptionsrrrrZ
structuresrryrrrr r!r"r#Zstatus_codesr$r%�platform�perf_counterr��AttributeErrorZclockr2r5�objectr6rur�r'r'r'r+�<module>s@  
v%site-packages/pip/_vendor/requests/__pycache__/api.cpython-38.pyc000064400000014507151446177000021010 0ustar00U

��.e�@s\dZddlmZdd�Zddd�Zdd	�Zd
d�Zddd
�Zddd�Zddd�Z	dd�Z
dS)z�
requests.api
~~~~~~~~~~~~

This module implements the Requests API.

:copyright: (c) 2012 by Kenneth Reitz.
:license: Apache2, see LICENSE for more details.
�)�sessionsc
Ks6t���$}|jf||d�|��W5QR�SQRXdS)a�	Constructs and sends a :class:`Request <Request>`.

    :param method: method for the new :class:`Request` object.
    :param url: URL for the new :class:`Request` object.
    :param params: (optional) Dictionary, list of tuples or bytes to send
        in the query string for the :class:`Request`.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
    :param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`.
    :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`.
    :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload.
        ``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')``
        or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content-type'`` is a string
        defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers
        to add for the file.
    :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
    :param timeout: (optional) How many seconds to wait for the server to send data
        before giving up, as a float, or a :ref:`(connect timeout, read
        timeout) <timeouts>` tuple.
    :type timeout: float or tuple
    :param allow_redirects: (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to ``True``.
    :type allow_redirects: bool
    :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy.
    :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use. Defaults to ``True``.
    :param stream: (optional) if ``False``, the response content will be immediately downloaded.
    :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response

    Usage::

      >>> import requests
      >>> req = requests.request('GET', 'https://httpbin.org/get')
      <Response [200]>
    )�method�urlN)rZSession�request)rr�kwargsZsession�r�</usr/lib/python3.8/site-packages/pip/_vendor/requests/api.pyrs+
rNcKs"|�dd�td|fd|i|��S)adSends a GET request.

    :param url: URL for the new :class:`Request` object.
    :param params: (optional) Dictionary, list of tuples or bytes to send
        in the query string for the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �allow_redirectsT�get�params��
setdefaultr)rrrrrrr
?sr
cKs|�dd�td|f|�S)z�Sends an OPTIONS request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    r	T�optionsr�rrrrrrNs	rcKs|�dd�td|f|�S)z�Sends a HEAD request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    r	F�headrrrrrr[s	rcKstd|f||d�|��S)a�Sends a POST request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �post)�data�json�r)rrrrrrrrhsrcKstd|fd|i|��S)a�Sends a PUT request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �putrr�rrrrrrrwsrcKstd|fd|i|��S)a�Sends a PATCH request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �patchrrrrrrr�srcKstd|f|�S)z�Sends a DELETE request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    �deleterrrrrr�s	r)N)NN)N)N)�__doc__�rrr
rrrrrrrrrr�<module>s
/




site-packages/pip/_vendor/requests/__pycache__/hooks.cpython-38.pyc000064400000001674151446177000021363 0ustar00U

��.e��@sdZdgZdd�Zdd�ZdS)z�
requests.hooks
~~~~~~~~~~~~~~

This module provides the capabilities for the Requests hooks system.

Available hooks:

``response``:
    The response generated from a Request.
ZresponsecCsdd�tD�S)NcSsi|]
}|g�qS�r)�.0Zeventrr�>/usr/lib/python3.8/site-packages/pip/_vendor/requests/hooks.py�
<dictcomp>sz!default_hooks.<locals>.<dictcomp>)�HOOKSrrrr�
default_hookssrcKsL|pi}|�|�}|rHt|d�r&|g}|D]}||f|�}|dk	r*|}q*|S)z6Dispatches a hook dictionary on a given piece of data.�__call__N)�get�hasattr)�keyZhooksZ	hook_data�kwargs�hookZ
_hook_datarrr�
dispatch_hooks

r
N)�__doc__rrr
rrrr�<module>ssite-packages/pip/_vendor/requests/__pycache__/structures.cpython-38.opt-1.pyc000064400000010452151446177000023414 0ustar00U

��.e��@s<dZddlmZmZmZGdd�de�ZGdd�de�ZdS)zO
requests.structures
~~~~~~~~~~~~~~~~~~~

Data structures that power Requests.
�)�OrderedDict�Mapping�MutableMappingc@sbeZdZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dS)�CaseInsensitiveDicta�A case-insensitive ``dict``-like object.

    Implements all methods and operations of
    ``MutableMapping`` as well as dict's ``copy``. Also
    provides ``lower_items``.

    All keys are expected to be strings. The structure remembers the
    case of the last key to be set, and ``iter(instance)``,
    ``keys()``, ``items()``, ``iterkeys()``, and ``iteritems()``
    will contain case-sensitive keys. However, querying and contains
    testing is case insensitive::

        cid = CaseInsensitiveDict()
        cid['Accept'] = 'application/json'
        cid['aCCEPT'] == 'application/json'  # True
        list(cid) == ['Accept']  # True

    For example, ``headers['content-encoding']`` will return the
    value of a ``'Content-Encoding'`` response header, regardless
    of how the header name was originally stored.

    If the constructor, ``.update``, or equality comparison
    operations are given keys that have equal ``.lower()``s, the
    behavior is undefined.
    NcKs&t�|_|dkri}|j|f|�dS�N)r�_store�update)�self�data�kwargs�r�C/usr/lib/python3.8/site-packages/pip/_vendor/requests/structures.py�__init__(szCaseInsensitiveDict.__init__cCs||f|j|��<dSr�r�lower)r	�key�valuerrr
�__setitem__.szCaseInsensitiveDict.__setitem__cCs|j|��dS)Nrr�r	rrrr
�__getitem__3szCaseInsensitiveDict.__getitem__cCs|j|��=dSrrrrrr
�__delitem__6szCaseInsensitiveDict.__delitem__cCsdd�|j��D�S)Ncss|]\}}|VqdSrr)�.0ZcasedkeyZmappedvaluerrr
�	<genexpr>:sz/CaseInsensitiveDict.__iter__.<locals>.<genexpr>)r�values�r	rrr
�__iter__9szCaseInsensitiveDict.__iter__cCs
t|j�Sr)�lenrrrrr
�__len__<szCaseInsensitiveDict.__len__cCsdd�|j��D�S)z.Like iteritems(), but with all lowercase keys.css|]\}}||dfVqdS)rNr)rZlowerkeyZkeyvalrrr
rAs�z2CaseInsensitiveDict.lower_items.<locals>.<genexpr>)r�itemsrrrr
�lower_items?s�zCaseInsensitiveDict.lower_itemscCs0t|t�rt|�}ntSt|���t|���kSr)�
isinstancerr�NotImplemented�dictr)r	�otherrrr
�__eq__Gs

zCaseInsensitiveDict.__eq__cCst|j���Sr)rrrrrrr
�copyPszCaseInsensitiveDict.copycCstt|����Sr)�strr"rrrrr
�__repr__SszCaseInsensitiveDict.__repr__)N)�__name__�
__module__�__qualname__�__doc__rrrrrrrr$r%r'rrrr
r
s
	rcs<eZdZdZd�fdd�	Zdd�Zdd�Zdd	d
�Z�ZS)
�
LookupDictzDictionary lookup object.Ncs||_tt|���dSr)�name�superr,r)r	r-��	__class__rr
rZszLookupDict.__init__cCs
d|jS)Nz
<lookup '%s'>)r-rrrr
r'^szLookupDict.__repr__cCs|j�|d�Sr��__dict__�getrrrr
raszLookupDict.__getitem__cCs|j�||�Srr1)r	r�defaultrrr
r3fszLookupDict.get)N)N)	r(r)r*r+rr'rr3�
__classcell__rrr/r
r,Ws
r,N)r+�compatrrrrr"r,rrrr
�<module>sJsite-packages/pip/_vendor/requests/__pycache__/help.cpython-38.opt-1.pyc000064400000005206151446177000022122 0ustar00U

��.e�
�@s�dZddlmZddlZddlZddlZddlZddlmZddlm	Z	ddlm
Z
ddlmZ
zdd	lmZWn ek
r�dZdZdZYnXddlZddlZd
d�Zdd
�Zdd�Zedkr�e�dS)z'Module containing bug report helper(s).�)�print_functionN)�idna)�urllib3)�chardet�)�__version__)�	pyopensslcCs�t��}|dkrt��}nj|dkr\dtjjtjjtjjf}tjjdkr�d�	|tjjg�}n(|dkrnt��}n|dkr�t��}nd}||d	�S)
a�Return a dict with the Python implementation and version.

    Provide both the name and the version of the Python implementation
    currently running. For example, on CPython 2.7.5 it will return
    {'name': 'CPython', 'version': '2.7.5'}.

    This function works best on CPython and PyPy: in particular, it probably
    doesn't work for Jython or IronPython. Future investigation should be done
    to work out the correct shape of the code for those platforms.
    ZCPythonZPyPyz%s.%s.%s�final�ZJythonZ
IronPython�Unknown)�name�version)
�platformZpython_implementationZpython_version�sysZpypy_version_info�major�minor�micro�releaselevel�join)�implementationZimplementation_version�r�=/usr/lib/python3.8/site-packages/pip/_vendor/requests/help.py�_implementations&
��

rc	Cs�zt��t��d�}Wntk
r4ddd�}YnXt�}dtji}dtji}ddd�}trrtjdtj	j
d�}dttdd�i}dtt
dd�i}tj
}d|dk	r�d|ndi}|||tdk	|||||dtid	�
S)
z&Generate information for a bug report.)�system�releaserr
Nr
)r
Zopenssl_versionz%xr)
rr�
system_sslZusing_pyopensslZ	pyOpenSSLrr�cryptographyrZrequests)rrr�IOErrorrrrr�OpenSSLZSSLZOPENSSL_VERSION_NUMBER�getattrrr�sslr�requests_version)	Z
platform_infoZimplementation_infoZurllib3_infoZchardet_infoZpyopenssl_infoZcryptography_infoZ	idna_inforZsystem_ssl_inforrr�info;sR�
�

�
�
�
����r"cCsttjt�ddd��dS)z)Pretty-print the bug information as JSON.T�)Z	sort_keys�indentN)�print�json�dumpsr"rrrr�mainqsr(�__main__)�__doc__Z
__future__rr&rrr Zpip._vendorrrrr
rr!Zpip._vendor.urllib3.contribr�ImportErrorrrrr"r(�__name__rrrr�<module>s,
!6site-packages/pip/_vendor/requests/__pycache__/adapters.cpython-38.opt-1.pyc000064400000041063151446177000022776 0ustar00U

��.e,T�@s�dZddlZddlZddlmZmZddlmZddl	m
Z
ddl	mZddl
mZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlmZddlmZddlmZddlmZddlmZddlmZddl m!Z!m"Z"ddl#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*ddl+m,Z,ddl-m.Z.ddl/m0Z0m1Z1m2Z2mZmZm3Z3m4Z4m5Z5m6Z6ddl7m8Z8zddl9m:Z:Wne;k
�r�dd�Z:YnXdZ<dZ=dZ>dZ?Gd d!�d!e@�ZAGd"d#�d#eA�ZBdS)$z�
requests.adapters
~~~~~~~~~~~~~~~~~

This module contains the transport adapters that Requests uses to define
and maintain connections.
�N)�PoolManager�proxy_from_url)�HTTPResponse)�	parse_url)�Timeout)�Retry)�ClosedPoolError)�ConnectTimeoutError)�	HTTPError)�
MaxRetryError)�NewConnectionError)�
ProxyError)�
ProtocolError)�ReadTimeoutError)�SSLError)�
ResponseError)�LocationValueError�)�Response)�urlparse�
basestring)�DEFAULT_CA_BUNDLE_PATH�extract_zipped_paths�get_encoding_from_headers�prepend_scheme_if_needed�get_auth_from_url�
urldefragauth�select_proxy)�CaseInsensitiveDict)�extract_cookies_to_jar)	�ConnectionError�ConnectTimeout�ReadTimeoutrr
�
RetryError�
InvalidSchema�InvalidProxyURL�
InvalidURL)�_basic_auth_str)�SOCKSProxyManagercOstd��dS)Nz'Missing dependencies for SOCKS support.)r$)�args�kwargs�r+�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/adapters.pyr(.sr(F�
cs2eZdZdZ�fdd�Zddd�Zd	d
�Z�ZS)�BaseAdapterzThe Base Transport Adaptercstt|���dS�N)�superr.�__init__��self��	__class__r+r,r1:szBaseAdapter.__init__FNTcCst�dS)aCSends PreparedRequest object. Returns Response object.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param stream: (optional) Whether to stream the request content.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple
        :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use
        :param cert: (optional) Any user-provided SSL certificate to be trusted.
        :param proxies: (optional) The proxies dictionary to apply to the request.
        N��NotImplementedError)r3�request�stream�timeout�verify�cert�proxiesr+r+r,�send=szBaseAdapter.sendcCst�dS)z!Cleans up adapter specific items.Nr6r2r+r+r,�closeOszBaseAdapter.close)FNTNN)�__name__�
__module__�__qualname__�__doc__r1r>r?�
__classcell__r+r+r4r,r.7s�
r.cs�eZdZdZdddddgZeeeef�fdd�	Zd	d
�Z	dd�Z
efd
d�Zdd�Zdd�Z
dd�Zd$dd�Zdd�Zdd�Zdd�Zdd�Zd%d"d#�Z�ZS)&�HTTPAdaptera�The built-in HTTP Adapter for urllib3.

    Provides a general-case interface for Requests sessions to contact HTTP and
    HTTPS urls by implementing the Transport Adapter interface. This class will
    usually be created by the :class:`Session <Session>` class under the
    covers.

    :param pool_connections: The number of urllib3 connection pools to cache.
    :param pool_maxsize: The maximum number of connections to save in the pool.
    :param max_retries: The maximum number of retries each connection
        should attempt. Note, this applies only to failed DNS lookups, socket
        connections and connection timeouts, never to requests where data has
        made it to the server. By default, Requests does not retry failed
        connections. If you need granular control over the conditions under
        which we retry a request, import urllib3's ``Retry`` class and pass
        that instead.
    :param pool_block: Whether the connection pool should block for connections.

    Usage::

      >>> import requests
      >>> s = requests.Session()
      >>> a = requests.adapters.HTTPAdapter(max_retries=3)
      >>> s.mount('http://', a)
    �max_retries�config�_pool_connections�
_pool_maxsize�_pool_blockcsd|tkrtddd�|_nt�|�|_i|_i|_tt|���||_	||_
||_|j|||d�dS)NrF)�read��block)
�DEFAULT_RETRIESrrFZfrom_intrG�
proxy_managerr0rEr1rHrIrJ�init_poolmanager)r3Zpool_connectionsZpool_maxsizerFZ
pool_blockr4r+r,r1qszHTTPAdapter.__init__cs�fdd��jD�S)Ncsi|]}|t�|d��qSr/)�getattr)�.0�attrr2r+r,�
<dictcomp>�sz,HTTPAdapter.__getstate__.<locals>.<dictcomp>)�	__attrs__r2r+r2r,�__getstate__�szHTTPAdapter.__getstate__cCsDi|_i|_|��D]\}}t|||�q|j|j|j|jd�dS)NrL)rOrG�items�setattrrPrHrIrJ)r3�staterS�valuer+r+r,�__setstate__�s�zHTTPAdapter.__setstate__cKs0||_||_||_tf|||dd�|��|_dS)aInitializes a urllib3 PoolManager.

        This method should not be called from user code, and is only
        exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param connections: The number of urllib3 connection pools to cache.
        :param maxsize: The maximum number of connections to save in the pool.
        :param block: Block when no free connections are available.
        :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager.
        T)�	num_pools�maxsizerM�strictN)rHrIrJr�poolmanager)r3Zconnectionsr]rMZpool_kwargsr+r+r,rP�s
��zHTTPAdapter.init_poolmanagercKs�||jkr|j|}n||���d�r^t|�\}}t|f|||j|j|jd�|��}|j|<n4|�|�}t	|f||j|j|jd�|��}|j|<|S)a�Return urllib3 ProxyManager for the given proxy.

        This method should not be called from user code, and is only
        exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param proxy: The proxy to return a urllib3 ProxyManager for.
        :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager.
        :returns: ProxyManager
        :rtype: urllib3.ProxyManager
        �socks)�username�passwordr\r]rM)�
proxy_headersr\r]rM)
rO�lower�
startswithrr(rHrIrJrcr)r3�proxyZproxy_kwargsZmanagerrarbrcr+r+r,�proxy_manager_for�s6
���

���zHTTPAdapter.proxy_manager_forcCs�|���d�rn|rnd}|dk	r"|}|s.tt�}|r>tj�|�sLtd�|���d|_	tj�
|�sf||_q�||_nd|_	d|_d|_|r�t
|t�s�|d|_|d|_n||_d|_|jr�tj�|j�s�td	�|j���|jr�tj�|j�s�td
�|j���dS)aAVerify a SSL certificate. This method should not be called from user
        code, and is only exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param conn: The urllib3 connection object associated with the cert.
        :param url: The requested URL.
        :param verify: Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use
        :param cert: The SSL certificate to verify.
        �httpsNTzECould not find a suitable TLS CA certificate bundle, invalid path: {}Z
CERT_REQUIREDZ	CERT_NONErrz9Could not find the TLS certificate file, invalid path: {}z1Could not find the TLS key file, invalid path: {})rdrerr�os�path�exists�IOError�formatZ	cert_reqs�isdirZca_certsZca_cert_dir�
isinstancerZ	cert_fileZkey_file)r3�conn�urlr;r<Zcert_locr+r+r,�cert_verify�s>�

��zHTTPAdapter.cert_verifycCs�t�}t|dd�|_tt|di��|_t|j�|_||_|jj|_t	|j
t�r^|j
�d�|_
n|j
|_
t
|j||�||_||_|S)a�Builds a :class:`Response <requests.Response>` object from a urllib3
        response. This should not be called from user code, and is only exposed
        for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`

        :param req: The :class:`PreparedRequest <PreparedRequest>` used to generate the response.
        :param resp: The urllib3 response object.
        :rtype: requests.Response
        ZstatusN�headers�utf-8)rrQZstatus_coderrsr�encoding�raw�reasonrorq�bytes�decoder�cookiesr8�
connection)r3Zreq�respZresponser+r+r,�build_response�s

zHTTPAdapter.build_responseNcCsdt||�}|rDt|d�}t|�}|js.td��|�|�}|�|�}nt|�}|��}|j	�|�}|S)a�Returns a urllib3 connection for the given URL. This should not be
        called from user code, and is only exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param url: The URL to connect to.
        :param proxies: (optional) A Requests-style dictionary of proxies used on this request.
        :rtype: urllib3.ConnectionPool
        ZhttpzFPlease check proxy URL. It is malformed and could be missing the host.)
rrrZhostr%rgZconnection_from_urlrZgeturlr_)r3rqr=rfZ	proxy_urlrOrpZparsedr+r+r,�get_connection$s	


zHTTPAdapter.get_connectioncCs&|j��|j��D]}|��qdS)z�Disposes of any internal state.

        Currently, this closes the PoolManager and any active ProxyManager,
        which closes any pooled connections.
        N)r_�clearrO�values)r3rfr+r+r,r??s
zHTTPAdapter.closec	Cs`t|j|�}t|j�j}|o"|dk}d}|rDt|�j��}|�d�}|j}|r\|s\t|j�}|S)a?Obtain the url to use when making the final request.

        If the message is being sent through a HTTP proxy, the full URL has to
        be used. Otherwise, we should only use the path portion of the URL.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs.
        :rtype: str
        rhFr`)rrqr�schemerdreZpath_urlr)	r3r8r=rfr�Zis_proxied_http_requestZusing_socks_proxyZproxy_schemerqr+r+r,�request_urlIs

zHTTPAdapter.request_urlcKsdS)a"Add any headers needed by the connection. As of v2.0 this does
        nothing by default, but is left for overriding by users that subclass
        the :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param request: The :class:`PreparedRequest <PreparedRequest>` to add headers to.
        :param kwargs: The keyword arguments from the call to send().
        Nr+)r3r8r*r+r+r,�add_headersfszHTTPAdapter.add_headerscCs&i}t|�\}}|r"t||�|d<|S)aReturns a dictionary of the headers to add to any request sent
        through a proxy. This works with urllib3 magic to ensure that they are
        correctly sent to the proxy, rather than in a tunnelled request if
        CONNECT is being used.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param proxy: The url of the proxy being used for this request.
        :rtype: dict
        zProxy-Authorization)rr')r3rfrsrarbr+r+r,rcts
�zHTTPAdapter.proxy_headersFTcCs�z|�|j|�}Wn.tk
r@}zt||d��W5d}~XYnX|�||j||�|�||�}	|j||||||d�|jdkp�d|jk}
t	|t
�r�z|\}}t||d�}Wq�tk
r�}zd�
|�}
t|
��W5d}~XYq�Xnt	|t�r�nt||d�}�zF|
�s2|j|j|	|j|jdddd|j|d�
}�nt|d	��rD|j}|jtd
�}z�|j|j|	dd�|j��D]\}}|�||��qn|��|jD]D}|�tt|��d
d��d��|�d�|�|�|�d��q�|�d�z|jdd�}Wntk
�r|��}YnXtj |||ddd�}Wn|�!��YnXW�n�t"t#j$fk
�r~}
zt%|
|d��W5d}
~
XY�nZt&k
�r"}z�t	|j't(��r�t	|j't)��s�t*||d��t	|j't+��r�t,||d��t	|j't-��r�t.||d��t	|j't/��rt0||d��t%||d��W5d}~XYn�t1k
�rP}zt%||d��W5d}~XYn�t-k
�rz}zt.|��W5d}~XYn^t/t2fk
�r�}z:t	|t/��r�t0||d��nt	|t3��r�t4||d��n�W5d}~XYnX|�5||�S)aSends PreparedRequest object. Returns Response object.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param stream: (optional) Whether to stream the request content.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple or urllib3 Timeout object
        :param verify: (optional) Either a boolean, in which case it controls whether
            we verify the server's TLS certificate, or a string, in which case it
            must be a path to a CA bundle to use
        :param cert: (optional) Any user-provided SSL certificate to be trusted.
        :param proxies: (optional) The proxies dictionary to apply to the request.
        :rtype: requests.Response
        )r8N)r9r:r;r<r=zContent-Length)�connectrKzrInvalid timeout {}. Pass a (connect, read) timeout tuple, or a single float to set both timeouts to the same valueF)
�methodrq�bodyrsZredirectZassert_same_host�preload_content�decode_contentZretriesr:�
proxy_pool)r:T)Zskip_accept_encoding�rts
s0

)�	buffering)Zpoolr{r�r�)6r~rqrr&rrr�r�r�rsro�tuple�TimeoutSauce�
ValueErrorrmZurlopenr�rF�hasattrr�Z	_get_conn�DEFAULT_POOL_TIMEOUTZ
putrequestrWZ	putheaderZ
endheadersr>�hex�len�encodeZgetresponse�	TypeErrorrZfrom_httplibr?r�socket�errorr rrwr	rr!rr#�_ProxyErrorr
�	_SSLErrorrr�
_HTTPErrorrr"r})r3r8r9r:r;r<r=rp�erqZchunkedr�rK�errr|Zlow_conn�headerrZ�i�rr+r+r,r>�s�
�
�
�
 


�
zHTTPAdapter.send)N)FNTNN)r@rArBrCrU�DEFAULT_POOLSIZErN�DEFAULT_POOLBLOCKr1rVr[rPrgrrr}r~r?r�r�rcr>rDr+r+r4r,rETs*��%4%

rE)CrCZos.pathrir�Zpip._vendor.urllib3.poolmanagerrrZpip._vendor.urllib3.responserZpip._vendor.urllib3.utilrrr�Zpip._vendor.urllib3.util.retryrZpip._vendor.urllib3.exceptionsrr	r
r�rrr
r�rrrr�rrZmodelsr�compatrrZutilsrrrrrrrZ
structuresrrzr�
exceptionsr r!r"r#r$r%r&Zauthr'Z!pip._vendor.urllib3.contrib.socksr(�ImportErrorr�r�rNr��objectr.rEr+r+r+r,�<module>sF$,site-packages/pip/_vendor/requests/__pycache__/exceptions.cpython-38.opt-1.pyc000064400000012130151446177000023345 0ustar00U

��.e}�@s�dZddlmZGdd�de�ZGdd�de�ZGdd�de�ZGd	d
�d
e�ZGdd�de�ZGd
d�de�Z	Gdd�dee	�Z
Gdd�de	�ZGdd�de�ZGdd�de�Z
Gdd�dee�ZGdd�dee�ZGdd�dee�ZGdd�dee�ZGdd �d e�ZGd!d"�d"e�ZGd#d$�d$ee�ZGd%d&�d&ee�ZGd'd(�d(e�ZGd)d*�d*e�ZGd+d,�d,e�ZGd-d.�d.ee�ZGd/d0�d0e�Zd1S)2z`
requests.exceptions
~~~~~~~~~~~~~~~~~~~

This module contains the set of Requests' exceptions.
�)�	HTTPErrorcs eZdZdZ�fdd�Z�ZS)�RequestExceptionzTThere was an ambiguous exception that occurred while handling your
    request.
    csX|�dd�}||_|�dd�|_|dk	rB|jsBt|d�rB|jj|_tt|�j||�dS)zBInitialize RequestException with `request` and `response` objects.�responseN�request)�poprr�hasattr�superr�__init__)�self�args�kwargsr��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/requests/exceptions.pyr	s�
zRequestException.__init__)�__name__�
__module__�__qualname__�__doc__r	�
__classcell__rrr
rrsrc@seZdZdZdS)rzAn HTTP error occurred.N�rrrrrrrrrsrc@seZdZdZdS)�ConnectionErrorzA Connection error occurred.Nrrrrrr src@seZdZdZdS)�
ProxyErrorzA proxy error occurred.Nrrrrrr$src@seZdZdZdS)�SSLErrorzAn SSL error occurred.Nrrrrrr(src@seZdZdZdS)�Timeoutz�The request timed out.

    Catching this error will catch both
    :exc:`~requests.exceptions.ConnectTimeout` and
    :exc:`~requests.exceptions.ReadTimeout` errors.
    Nrrrrrr,src@seZdZdZdS)�ConnectTimeoutz�The request timed out while trying to connect to the remote server.

    Requests that produced this error are safe to retry.
    Nrrrrrr5src@seZdZdZdS)�ReadTimeoutz@The server did not send any data in the allotted amount of time.Nrrrrrr<src@seZdZdZdS)�URLRequiredz*A valid URL is required to make a request.Nrrrrrr@src@seZdZdZdS)�TooManyRedirectszToo many redirects.NrrrrrrDsrc@seZdZdZdS)�
MissingSchemaz/The URL schema (e.g. http or https) is missing.NrrrrrrHsrc@seZdZdZdS)�
InvalidSchemaz"See defaults.py for valid schemas.Nrrrrrr Lsr c@seZdZdZdS)�
InvalidURLz%The URL provided was somehow invalid.Nrrrrrr!Psr!c@seZdZdZdS)�
InvalidHeaderz.The header value provided was somehow invalid.Nrrrrrr"Tsr"c@seZdZdZdS)�InvalidProxyURLz"The proxy URL provided is invalid.Nrrrrrr#Xsr#c@seZdZdZdS)�ChunkedEncodingErrorz?The server declared chunked encoding but sent an invalid chunk.Nrrrrrr$\sr$c@seZdZdZdS)�ContentDecodingErrorz!Failed to decode response contentNrrrrrr%`sr%c@seZdZdZdS)�StreamConsumedErrorz2The content for this response was already consumedNrrrrrr&dsr&c@seZdZdZdS)�
RetryErrorzCustom retries logic failedNrrrrrr'hsr'c@seZdZdZdS)�UnrewindableBodyErrorz:Requests encountered an error when trying to rewind a bodyNrrrrrr(lsr(c@seZdZdZdS)�RequestsWarningzBase warning for Requests.Nrrrrrr)rsr)c@seZdZdZdS)�FileModeWarningzJA file was opened in text mode, but Requests determined its binary length.Nrrrrrr*wsr*c@seZdZdZdS)�RequestsDependencyWarningz@An imported dependency doesn't match the expected version range.Nrrrrrr+|sr+N)rZpip._vendor.urllib3.exceptionsrZ
BaseHTTPError�IOErrorrrrrrrrrr�
ValueErrorrr r!r"r#r$r%�	TypeErrorr&r'r(�Warningr)�DeprecationWarningr*r+rrrr�<module>s0	site-packages/pip/_vendor/requests/__pycache__/__init__.cpython-38.pyc000064400000006613151446177000021775 0ustar00U

��.e��	@sdZddlmZddlmZddlZddlmZdd�Zd	d
�Zzeej	ej	�Wn0e
efk
r�e�d�
ej	ej	�e�YnXddlmZes�z,dd
lmZe��ddlm	Zee�Wnek
r�YnXddlmZe�de�ddl	mZmZmZm	Z	ddl	mZmZmZmZddl	m Z m!Z!ddl"m#Z#ddl"m$Z$ddl%m&Z&m'Z'm(Z(ddl)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0m1Z1ddl2m3Z3m4Z4ddl5m6Z6ddlm7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>m?Z?ddl@Z@ddl@mAZAe@�BeC��DeA��ejde=dd�dS)a�
Requests HTTP Library
~~~~~~~~~~~~~~~~~~~~~

Requests is an HTTP library, written in Python, for human beings. Basic GET
usage:

   >>> import requests
   >>> r = requests.get('https://www.python.org')
   >>> r.status_code
   200
   >>> 'Python is a programming language' in r.content
   True

... or POST:

   >>> payload = dict(key1='value1', key2='value2')
   >>> r = requests.post('https://httpbin.org/post', data=payload)
   >>> print(r.text)
   {
     ...
     "form": {
       "key2": "value2",
       "key1": "value1"
     },
     ...
   }

The other HTTP methods are supported - see `requests.api`. Full documentation
is at <http://python-requests.org>.

:copyright: (c) 2017 by Kenneth Reitz.
:license: Apache 2.0, see LICENSE for more details.
�)�urllib3)�chardetN�)�RequestsDependencyWarningcCs�|�d�}|dgkst�t|�dkr.|�d�|\}}}t|�t|�t|�}}}|dks`t�|dkslt�|dksxt�|�d�dd�\}}}t|�t|�t|�}}}|dks�t�|dks�t�|dks�t�dS)	N�.Zdev��0r���)�split�AssertionError�len�append�int)Zurllib3_versionZchardet_version�major�minor�patch�r�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/__init__.py�check_compatibility1s


rcCsXzttt|�d���}Wntk
r.YdSX|dddgkrTd�|�}t�|t�dS)Nrrr�z4Old version of cryptography ({}) may cause slowdown.)	�list�maprr�
ValueError�format�warnings�warnr)�cryptography_versionZwarningrrr�_check_cryptographyJs
rz?urllib3 ({}) or chardet ({}) doesn't match a supported version!)�WINDOWS)�	pyopenssl)�__version__)�DependencyWarning�ignore)�	__title__�__description__�__url__r")�	__build__�
__author__�__author_email__�__license__)�
__copyright__�__cake__)�utils)�packages)�Request�Response�PreparedRequest)�request�get�head�postr�put�delete�options)�session�Session)�codes)	�RequestException�Timeout�URLRequired�TooManyRedirects�	HTTPError�ConnectionError�FileModeWarning�ConnectTimeout�ReadTimeout)�NullHandler�defaultT)r)E�__doc__Zpip._vendorrrr�
exceptionsrrrr"r
rrrZpip._internal.utils.compatr Zpip._vendor.urllib3.contribr!Zinject_into_urllib3Zcryptographyr�ImportErrorZpip._vendor.urllib3.exceptionsr#�simplefilterr%r&r'r(r)r*r+r,r-�r.r/Zmodelsr0r1r2Zapir3r4r5r6rr7r8r9Zsessionsr:r;Zstatus_codesr<r=r>r?r@rArBrCrDrEZloggingrFZ	getLogger�__name__Z
addHandlerrrrr�<module>sP#��
(,site-packages/pip/_vendor/requests/__pycache__/packages.cpython-38.opt-1.pyc000064400000000722151446177000022746 0ustar00U

��.e��@svddlZdD]dZdeZee�e�e<eej�D]>ZeeksJe�ed�r0ee	d�d�Z
ejeejde
<q0qdS)�N)Zurllib3ZidnaZchardetzpip._vendor.�.zpip._vendor.requests.packages.)�sys�packageZvendored_package�
__import__�locals�list�modules�mod�
startswith�lenZunprefixed_mod�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/requests/packages.py�<module>ssite-packages/pip/_vendor/requests/__pycache__/__version__.cpython-38.opt-1.pyc000064400000001002151446177000023441 0ustar00U

��.e��@s,dZdZdZdZdZdZdZdZdZd	Z	d
S)ZrequestszPython HTTP for Humans.zhttp://python-requests.orgz2.22.0i"z
Kenneth Reitzzme@kennethreitz.orgz
Apache 2.0zCopyright 2019 Kenneth Reitzu✨ 🍰 ✨N)
Z	__title__Z__description__Z__url__�__version__Z	__build__�
__author__Z__author_email__Z__license__Z
__copyright__Z__cake__�rr�D/usr/lib/python3.8/site-packages/pip/_vendor/requests/__version__.py�<module>ssite-packages/pip/_vendor/requests/__pycache__/cookies.cpython-38.opt-1.pyc000064400000044556151446177000022641 0ustar00U

��.e�G�@s�dZddlZddlZddlZddlmZddlmZmZm	Z	m
Z
mZzddlZWne
k
rlddlZYnXGdd�de�ZGdd	�d	e�Zd
d�Zdd
�Zddd�ZGdd�de�ZGdd�deje�Zdd�Zdd�Zdd�Zd dd�Zdd�ZdS)!z�
requests.cookies
~~~~~~~~~~~~~~~~

Compatibility code to be able to use `cookielib.CookieJar` with requests.

requests.utils imports from here, so be careful with imports.
�N�)�to_native_string)�	cookielib�urlparse�
urlunparse�Morsel�MutableMappingc@s�eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
ddd�Zdd�Zdd�Z
dd�Zedd��Zedd��Zedd��ZdS) �MockRequesta�Wraps a `requests.Request` to mimic a `urllib2.Request`.

    The code in `cookielib.CookieJar` expects this interface in order to correctly
    manage cookie policies, i.e., determine whether a cookie can be set, given the
    domains of the request and the cookie.

    The original request object is read-only. The client is responsible for collecting
    the new headers via `get_new_headers()` and interpreting them appropriately. You
    probably want `get_cookie_header`, defined below.
    cCs ||_i|_t|jj�j|_dS�N)�_r�_new_headersr�url�scheme�type)�self�request�r�@/usr/lib/python3.8/site-packages/pip/_vendor/requests/cookies.py�__init__%szMockRequest.__init__cCs|jSr
)r�rrrr�get_type*szMockRequest.get_typecCst|jj�jSr
)rrr
Znetlocrrrr�get_host-szMockRequest.get_hostcCs|��Sr
�rrrrr�get_origin_req_host0szMockRequest.get_origin_req_hostcCsT|jj�d�s|jjSt|jjddd�}t|jj�}t|j||j|j	|j
|jg�S)NZHostzutf-8)�encoding)r�headers�getr
rrrr�pathZparamsZqueryZfragment)r�hostZparsedrrr�get_full_url3s�zMockRequest.get_full_urlcCsdS�NTrrrrr�is_unverifiableAszMockRequest.is_unverifiablecCs||jjkp||jkSr
)rrr�r�namerrr�
has_headerDszMockRequest.has_headerNcCs|jj�||j�||��Sr
)rrrr)rr#�defaultrrr�
get_headerGszMockRequest.get_headercCstd��dS)zMcookielib has no legitimate use for this method; add it back if you find one.z=Cookie headers should be added with add_unredirected_header()N)�NotImplementedError)r�key�valrrr�
add_headerJszMockRequest.add_headercCs||j|<dSr
�r�rr#�valuerrr�add_unredirected_headerNsz#MockRequest.add_unredirected_headercCs|jSr
r+rrrr�get_new_headersQszMockRequest.get_new_headerscCs|��Sr
)r!rrrr�unverifiableTszMockRequest.unverifiablecCs|��Sr
)rrrrr�origin_req_hostXszMockRequest.origin_req_hostcCs|��Sr
rrrrrr\szMockRequest.host)N)�__name__�
__module__�__qualname__�__doc__rrrrrr!r$r&r*r.r/�propertyr0r1rrrrrr	s$


r	c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�MockResponsez�Wraps a `httplib.HTTPMessage` to mimic a `urllib.addinfourl`.

    ...what? Basically, expose the parsed HTTP headers from the server response
    the way `cookielib` expects to see them.
    cCs
||_dS)z�Make a MockResponse for `cookielib` to read.

        :param headers: a httplib.HTTPMessage or analogous carrying the headers
        N��_headers)rrrrrrhszMockResponse.__init__cCs|jSr
r8rrrr�infooszMockResponse.infocCs|j�|�dSr
)r9�
getheadersr"rrrr;rszMockResponse.getheadersN)r2r3r4r5rr:r;rrrrr7asr7cCs8t|d�r|jsdSt|�}t|jj�}|�||�dS)z�Extract the cookies from the response into a CookieJar.

    :param jar: cookielib.CookieJar (not necessarily a RequestsCookieJar)
    :param request: our own requests.Request object
    :param response: urllib3.HTTPResponse object
    �_original_responseN)�hasattrr<r	r7�msgZextract_cookies)�jarrZresponseZreq�resrrr�extract_cookies_to_jarvs
�rAcCs t|�}|�|�|���d�S)zj
    Produce an appropriate Cookie header string to be sent with `request`, or None.

    :rtype: str
    �Cookie)r	Zadd_cookie_headerr/r)r?r�rrrr�get_cookie_header�s
rDcCszg}|D]N}|j|krq|dk	r,||jkr,q|dk	r@||jkr@q|�|j|j|jf�q|D]\}}}|�|||�q\dS)zkUnsets a cookie by name, by default over all domains and paths.

    Wraps CookieJar.clear(), is O(n).
    N)r#�domainr�append�clear)�	cookiejarr#rErZ
clearables�cookierrr�remove_cookie_by_name�s
rJc@seZdZdZdS)�CookieConflictErrorz�There are two cookies that meet the criteria specified in the cookie jar.
    Use .get and .set and include domain and path args in order to be more specific.
    N)r2r3r4r5rrrrrK�srKcs�eZdZdZd3dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zd4dd�Z�fdd�Zdd�Zdd �Zd!d"�Z�fd#d$�Z�fd%d&�Zd5d'd(�Zd6d)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Z�ZS)7�RequestsCookieJara�Compatibility class; is a cookielib.CookieJar, but exposes a dict
    interface.

    This is the CookieJar we create by default for requests and sessions that
    don't specify one, since some clients may expect response.cookies and
    session.cookies to support dict operations.

    Requests does not use the dict interface internally; it's just for
    compatibility with external client code. All requests code should work
    out of the box with externally provided instances of ``CookieJar``, e.g.
    ``LWPCookieJar`` and ``FileCookieJar``.

    Unlike a regular CookieJar, this class is pickleable.

    .. warning:: dictionary operations that are normally O(1) may be O(n).
    NcCs.z|�|||�WStk
r(|YSXdS)z�Dict-like get() that also supports optional domain and path args in
        order to resolve naming collisions from using one cookie jar over
        multiple domains.

        .. warning:: operation is O(n), not O(1).
        N)�_find_no_duplicates�KeyError)rr#r%rErrrrr�szRequestsCookieJar.getcKsX|dkr(t|||�d�|�d�d�dSt|t�r<t|�}nt||f|�}|�|�|S)z�Dict-like set() that also supports optional domain and path args in
        order to resolve naming collisions from using one cookie jar over
        multiple domains.
        NrEr)rEr)rJr�
isinstancer�morsel_to_cookie�
create_cookie�
set_cookie)rr#r-�kwargs�crrr�set�s


zRequestsCookieJar.setccst|�D]}|jVqdS)z�Dict-like iterkeys() that returns an iterator of names of cookies
        from the jar.

        .. seealso:: itervalues() and iteritems().
        N)�iterr#�rrIrrr�iterkeys�szRequestsCookieJar.iterkeyscCst|���S)z�Dict-like keys() that returns a list of names of cookies from the
        jar.

        .. seealso:: values() and items().
        )�listrXrrrr�keys�szRequestsCookieJar.keysccst|�D]}|jVqdS)z�Dict-like itervalues() that returns an iterator of values of cookies
        from the jar.

        .. seealso:: iterkeys() and iteritems().
        N)rVr-rWrrr�
itervalues�szRequestsCookieJar.itervaluescCst|���S)z�Dict-like values() that returns a list of values of cookies from the
        jar.

        .. seealso:: keys() and items().
        )rYr[rrrr�values�szRequestsCookieJar.valuesccs t|�D]}|j|jfVqdS)z�Dict-like iteritems() that returns an iterator of name-value tuples
        from the jar.

        .. seealso:: iterkeys() and itervalues().
        N)rVr#r-rWrrr�	iteritems�szRequestsCookieJar.iteritemscCst|���S)z�Dict-like items() that returns a list of name-value tuples from the
        jar. Allows client-code to call ``dict(RequestsCookieJar)`` and get a
        vanilla python dict of key value pairs.

        .. seealso:: keys() and values().
        )rYr]rrrr�itemsszRequestsCookieJar.itemscCs,g}t|�D]}|j|kr|�|j�q|S)z2Utility method to list all the domains in the jar.�rVrErF�rZdomainsrIrrr�list_domainss

zRequestsCookieJar.list_domainscCs,g}t|�D]}|j|kr|�|j�q|S)z0Utility method to list all the paths in the jar.)rVrrF)r�pathsrIrrr�
list_pathss

zRequestsCookieJar.list_pathscCs<g}t|�D]*}|jdk	r*|j|kr*dS|�|j�qdS)zvReturns True if there are multiple domains in the jar.
        Returns False otherwise.

        :rtype: bool
        NTFr_r`rrr�multiple_domainssz"RequestsCookieJar.multiple_domainscCsFi}t|�D]4}|dks"|j|kr|dks4|j|kr|j||j<q|S)z�Takes as an argument an optional domain and path and returns a plain
        old Python dict of name-value pairs of cookies that meet the
        requirements.

        :rtype: dict
        N)rVrErr-r#)rrErZ
dictionaryrIrrr�get_dict+s����zRequestsCookieJar.get_dictcs.ztt|��|�WStk
r(YdSXdSr )�superrL�__contains__rKr"��	__class__rrrg;szRequestsCookieJar.__contains__cCs
|�|�S)z�Dict-like __getitem__() for compatibility with client code. Throws
        exception if there are more than one cookie with name. In that case,
        use the more explicit get() method instead.

        .. warning:: operation is O(n), not O(1).
        )rMr"rrr�__getitem__AszRequestsCookieJar.__getitem__cCs|�||�dS)z�Dict-like __setitem__ for compatibility with client code. Throws
        exception if there is already a cookie of that name in the jar. In that
        case, use the more explicit set() method instead.
        N)rUr,rrr�__setitem__JszRequestsCookieJar.__setitem__cCst||�dS)zlDeletes a cookie given a name. Wraps ``cookielib.CookieJar``'s
        ``remove_cookie_by_name()``.
        N)rJr"rrr�__delitem__QszRequestsCookieJar.__delitem__csLt|jd�r4|j�d�r4|j�d�r4|j�dd�|_tt|�j|f|�|�S)N�
startswith�"z\"�)r=r-rm�endswith�replacerfrLrR)rrI�argsrSrhrrrRWs$zRequestsCookieJar.set_cookiecs<t|tj�r(|D]}|�t�|��qntt|��|�dS)zAUpdates this jar with cookies from another CookieJar or dict-likeN)rOr�	CookieJarrR�copyrfrL�update)r�otherrIrhrrru\szRequestsCookieJar.updatecCs\t|�D]<}|j|kr|dks(|j|kr|dks:|j|kr|jSqtd|||f��dS)a�Requests uses this method internally to get cookie values.

        If there are conflicting cookies, _find arbitrarily chooses one.
        See _find_no_duplicates if you want an exception thrown if there are
        conflicting cookies.

        :param name: a string containing name of cookie
        :param domain: (optional) string containing domain of cookie
        :param path: (optional) string containing path of cookie
        :return: cookie.value
        N�name=%r, domain=%r, path=%r)rVr#rErr-rN)rr#rErrIrrr�_findds
zRequestsCookieJar._findcCsxd}t|�D]L}|j|kr|dks,|j|kr|dks>|j|kr|dk	rRtd|��|j}q|rb|Std|||f��dS)a�Both ``__get_item__`` and ``get`` call this function: it's never
        used elsewhere in Requests.

        :param name: a string containing name of cookie
        :param domain: (optional) string containing domain of cookie
        :param path: (optional) string containing path of cookie
        :raises KeyError: if cookie is not found
        :raises CookieConflictError: if there are multiple cookies
            that match name and optionally domain and path
        :return: cookie.value
        Nz(There are multiple cookies with name, %rrw)rVr#rErrKr-rN)rr#rErZtoReturnrIrrrrMxs
z%RequestsCookieJar._find_no_duplicatescCs|j��}|�d�|S)�4Unlike a normal CookieJar, this class is pickleable.�
_cookies_lock)�__dict__rt�pop�r�staterrr�__getstate__�s

zRequestsCookieJar.__getstate__cCs$|j�|�d|jkr t��|_dS)ryrzN)r{ru�	threading�RLockrzr}rrr�__setstate__�s
zRequestsCookieJar.__setstate__cCs"t�}|�|���|�|�|S)z(Return a copy of this RequestsCookieJar.)rLZ
set_policy�
get_policyru)rZnew_cjrrrrt�s
zRequestsCookieJar.copycCs|jS)z&Return the CookiePolicy instance used.)Z_policyrrrrr��szRequestsCookieJar.get_policy)NNN)NN)NN)NN)r2r3r4r5rrUrXrZr[r\r]r^rarcrdrergrjrkrlrRrurxrMrr�rtr��
__classcell__rrrhrrL�s2
				
	

rLcCsN|dkrdSt|d�r|��St�|�}|��|D]}|�t�|��q4|S)Nrt)r=rtrGrR)r?Znew_jarrIrrr�_copy_cookie_jar�s

r�cKs�d||ddddddddddidd�
}t|�t|�}|rLd	}t|t|���|�|�t|d
�|d<t|d�|d
<|d�d�|d<t|d�|d<tjf|�S)z�Make a cookie from underspecified parameters.

    By default, the pair of `name` and `value` will be set for the domain ''
    and sent on every request (this is sometimes called a "supercookie").
    rNro�/FT�HttpOnly)
�versionr#r-�portrEr�secure�expires�discard�comment�comment_url�rest�rfc2109z4create_cookie() got unexpected keyword arguments: %sr�Zport_specifiedrEZdomain_specified�.Zdomain_initial_dotrZpath_specified)rU�	TypeErrorrYru�boolrmrrB)r#r-rS�resultZbadargs�errrrrrQ�s0�
rQcCs�d}|drPztt��t|d��}Wqrtk
rLtd|d��YqrXn"|drrd}t�t�|d|��}t|dt|d�d|d||j	|d	dd
|didt|d�|j
|d
p�dd�
S)zBConvert a Morsel object into a Cookie containing the one k/v pair.Nzmax-agezmax-age: %s must be integerr�z%a, %d-%b-%Y %H:%M:%S GMTr�FrErr�Zhttponlyr�r�r)
r�r�r�rEr�r#rr�r�r�r�r-r�)�int�time�
ValueErrorr��calendarZtimegm�strptimerQr�r(r-)Zmorselr�Z
time_templaterrrrP�s4�



�rPTcCsR|dkrt�}|dk	rNdd�|D�}|D]$}|s8||kr(|�t|||��q(|S)aCReturns a CookieJar from a key/value dictionary.

    :param cookie_dict: Dict of key/values to insert into CookieJar.
    :param cookiejar: (optional) A cookiejar to add the cookies to.
    :param overwrite: (optional) If False, will not replace cookies
        already in the jar with new ones.
    :rtype: CookieJar
    NcSsg|]
}|j�qSr)r#)�.0rIrrr�
<listcomp>	sz'cookiejar_from_dict.<locals>.<listcomp>)rLrRrQ)Zcookie_dictrH�	overwriteZnames_from_jarr#rrr�cookiejar_from_dict�s	r�cCsvt|tj�std��t|t�r.t||dd�}nDt|tj�rrz|�|�Wn(tk
rp|D]}|�|�q\YnX|S)z�Add cookies to cookiejar and returns a merged CookieJar.

    :param cookiejar: CookieJar object to add the cookies to.
    :param cookies: Dictionary or CookieJar object to be added.
    :rtype: CookieJar
    z!You can only merge into CookieJarF)rHr�)	rOrrsr��dictr�ru�AttributeErrorrR)rHZcookiesZ
cookie_in_jarrrr�
merge_cookiess
�r�)NN)NT)r5rtr�r�Z_internal_utilsr�compatrrrrrr��ImportErrorZdummy_threading�objectr	r7rArDrJ�RuntimeErrorrKrsrLr�rQrPr�r�rrrr�<module>s.	H
$
site-packages/pip/_vendor/requests/packages.py000064400000001267151446177000015526 0ustar00import sys

# This code exists for backwards compatibility reasons.
# I don't like it either. Just look the other way. :)

for package in ('urllib3', 'idna', 'chardet'):
    vendored_package = "pip._vendor." + package
    locals()[package] = __import__(vendored_package)
    # This traversal is apparently necessary such that the identities are
    # preserved (requests.packages.urllib3.* is urllib3.*)
    for mod in list(sys.modules):
        if mod == vendored_package or mod.startswith(vendored_package + '.'):
            unprefixed_mod = mod[len("pip._vendor."):]
            sys.modules['pip._vendor.requests.packages.' + unprefixed_mod] = sys.modules[mod]

# Kinda cool, though, right?
site-packages/pip/_vendor/requests/__init__.py000064400000007752151446177000015514 0ustar00# -*- coding: utf-8 -*-

#   __
#  /__)  _  _     _   _ _/   _
# / (   (- (/ (/ (- _)  /  _)
#          /

"""
Requests HTTP Library
~~~~~~~~~~~~~~~~~~~~~

Requests is an HTTP library, written in Python, for human beings. Basic GET
usage:

   >>> import requests
   >>> r = requests.get('https://www.python.org')
   >>> r.status_code
   200
   >>> 'Python is a programming language' in r.content
   True

... or POST:

   >>> payload = dict(key1='value1', key2='value2')
   >>> r = requests.post('https://httpbin.org/post', data=payload)
   >>> print(r.text)
   {
     ...
     "form": {
       "key2": "value2",
       "key1": "value1"
     },
     ...
   }

The other HTTP methods are supported - see `requests.api`. Full documentation
is at <http://python-requests.org>.

:copyright: (c) 2017 by Kenneth Reitz.
:license: Apache 2.0, see LICENSE for more details.
"""

from pip._vendor import urllib3
from pip._vendor import chardet
import warnings
from .exceptions import RequestsDependencyWarning


def check_compatibility(urllib3_version, chardet_version):
    urllib3_version = urllib3_version.split('.')
    assert urllib3_version != ['dev']  # Verify urllib3 isn't installed from git.

    # Sometimes, urllib3 only reports its version as 16.1.
    if len(urllib3_version) == 2:
        urllib3_version.append('0')

    # Check urllib3 for compatibility.
    major, minor, patch = urllib3_version  # noqa: F811
    major, minor, patch = int(major), int(minor), int(patch)
    # urllib3 >= 1.21.1, <= 1.25
    assert major == 1
    assert minor >= 21
    assert minor <= 25

    # Check chardet for compatibility.
    major, minor, patch = chardet_version.split('.')[:3]
    major, minor, patch = int(major), int(minor), int(patch)
    # chardet >= 3.0.2, < 3.1.0
    assert major == 3
    assert minor < 1
    assert patch >= 2


def _check_cryptography(cryptography_version):
    # cryptography < 1.3.4
    try:
        cryptography_version = list(map(int, cryptography_version.split('.')))
    except ValueError:
        return

    if cryptography_version < [1, 3, 4]:
        warning = 'Old version of cryptography ({}) may cause slowdown.'.format(cryptography_version)
        warnings.warn(warning, RequestsDependencyWarning)

# Check imported dependencies for compatibility.
try:
    check_compatibility(urllib3.__version__, chardet.__version__)
except (AssertionError, ValueError):
    warnings.warn("urllib3 ({}) or chardet ({}) doesn't match a supported "
                  "version!".format(urllib3.__version__, chardet.__version__),
                  RequestsDependencyWarning)

# Attempt to enable urllib3's SNI support, if possible
from pip._internal.utils.compat import WINDOWS
if not WINDOWS:
    try:
        from pip._vendor.urllib3.contrib import pyopenssl
        pyopenssl.inject_into_urllib3()

        # Check cryptography version
        from cryptography import __version__ as cryptography_version
        _check_cryptography(cryptography_version)
    except ImportError:
        pass

# urllib3's DependencyWarnings should be silenced.
from pip._vendor.urllib3.exceptions import DependencyWarning
warnings.simplefilter('ignore', DependencyWarning)

from .__version__ import __title__, __description__, __url__, __version__
from .__version__ import __build__, __author__, __author_email__, __license__
from .__version__ import __copyright__, __cake__

from . import utils
from . import packages
from .models import Request, Response, PreparedRequest
from .api import request, get, head, post, patch, put, delete, options
from .sessions import session, Session
from .status_codes import codes
from .exceptions import (
    RequestException, Timeout, URLRequired,
    TooManyRedirects, HTTPError, ConnectionError,
    FileModeWarning, ConnectTimeout, ReadTimeout
)

# Set default logging handler to avoid "No handler found" warnings.
import logging
from logging import NullHandler

logging.getLogger(__name__).addHandler(NullHandler())

# FileModeWarnings go off per the default.
warnings.simplefilter('default', FileModeWarning, append=True)
site-packages/pip/_vendor/requests/_internal_utils.py000064400000002110151446177000017127 0ustar00# -*- coding: utf-8 -*-

"""
requests._internal_utils
~~~~~~~~~~~~~~

Provides utility functions that are consumed internally by Requests
which depend on extremely few external helpers (such as compat)
"""

from .compat import is_py2, builtin_str, str


def to_native_string(string, encoding='ascii'):
    """Given a string object, regardless of type, returns a representation of
    that string in the native string type, encoding and decoding where
    necessary. This assumes ASCII unless told otherwise.
    """
    if isinstance(string, builtin_str):
        out = string
    else:
        if is_py2:
            out = string.encode(encoding)
        else:
            out = string.decode(encoding)

    return out


def unicode_is_ascii(u_string):
    """Determine if unicode string only contains ASCII characters.

    :param str u_string: unicode string to check. Must be unicode
        and not Python 2 `str`.
    :rtype: bool
    """
    assert isinstance(u_string, str)
    try:
        u_string.encode('ascii')
        return True
    except UnicodeEncodeError:
        return False
site-packages/pip/_vendor/requests/sessions.py000064400000071224151446177000015616 0ustar00# -*- coding: utf-8 -*-

"""
requests.session
~~~~~~~~~~~~~~~~

This module provides a Session object to manage and persist settings across
requests (cookies, auth, proxies).
"""
import os
import sys
import time
from datetime import timedelta

from .auth import _basic_auth_str
from .compat import cookielib, is_py3, OrderedDict, urljoin, urlparse, Mapping
from .cookies import (
    cookiejar_from_dict, extract_cookies_to_jar, RequestsCookieJar, merge_cookies)
from .models import Request, PreparedRequest, DEFAULT_REDIRECT_LIMIT
from .hooks import default_hooks, dispatch_hook
from ._internal_utils import to_native_string
from .utils import to_key_val_list, default_headers, DEFAULT_PORTS
from .exceptions import (
    TooManyRedirects, InvalidSchema, ChunkedEncodingError, ContentDecodingError)

from .structures import CaseInsensitiveDict
from .adapters import HTTPAdapter

from .utils import (
    requote_uri, get_environ_proxies, get_netrc_auth, should_bypass_proxies,
    get_auth_from_url, rewind_body
)

from .status_codes import codes

# formerly defined here, reexposed here for backward compatibility
from .models import REDIRECT_STATI

# Preferred clock, based on which one is more accurate on a given system.
if sys.platform == 'win32':
    try:  # Python 3.4+
        preferred_clock = time.perf_counter
    except AttributeError:  # Earlier than Python 3.
        preferred_clock = time.clock
else:
    preferred_clock = time.time


def merge_setting(request_setting, session_setting, dict_class=OrderedDict):
    """Determines appropriate setting for a given request, taking into account
    the explicit setting on that request, and the setting in the session. If a
    setting is a dictionary, they will be merged together using `dict_class`
    """

    if session_setting is None:
        return request_setting

    if request_setting is None:
        return session_setting

    # Bypass if not a dictionary (e.g. verify)
    if not (
            isinstance(session_setting, Mapping) and
            isinstance(request_setting, Mapping)
    ):
        return request_setting

    merged_setting = dict_class(to_key_val_list(session_setting))
    merged_setting.update(to_key_val_list(request_setting))

    # Remove keys that are set to None. Extract keys first to avoid altering
    # the dictionary during iteration.
    none_keys = [k for (k, v) in merged_setting.items() if v is None]
    for key in none_keys:
        del merged_setting[key]

    return merged_setting


def merge_hooks(request_hooks, session_hooks, dict_class=OrderedDict):
    """Properly merges both requests and session hooks.

    This is necessary because when request_hooks == {'response': []}, the
    merge breaks Session hooks entirely.
    """
    if session_hooks is None or session_hooks.get('response') == []:
        return request_hooks

    if request_hooks is None or request_hooks.get('response') == []:
        return session_hooks

    return merge_setting(request_hooks, session_hooks, dict_class)


class SessionRedirectMixin(object):

    def get_redirect_target(self, resp):
        """Receives a Response. Returns a redirect URI or ``None``"""
        # Due to the nature of how requests processes redirects this method will
        # be called at least once upon the original response and at least twice
        # on each subsequent redirect response (if any).
        # If a custom mixin is used to handle this logic, it may be advantageous
        # to cache the redirect location onto the response object as a private
        # attribute.
        if resp.is_redirect:
            location = resp.headers['location']
            # Currently the underlying http module on py3 decode headers
            # in latin1, but empirical evidence suggests that latin1 is very
            # rarely used with non-ASCII characters in HTTP headers.
            # It is more likely to get UTF8 header rather than latin1.
            # This causes incorrect handling of UTF8 encoded location headers.
            # To solve this, we re-encode the location in latin1.
            if is_py3:
                location = location.encode('latin1')
            return to_native_string(location, 'utf8')
        return None

    def should_strip_auth(self, old_url, new_url):
        """Decide whether Authorization header should be removed when redirecting"""
        old_parsed = urlparse(old_url)
        new_parsed = urlparse(new_url)
        if old_parsed.hostname != new_parsed.hostname:
            return True
        # Special case: allow http -> https redirect when using the standard
        # ports. This isn't specified by RFC 7235, but is kept to avoid
        # breaking backwards compatibility with older versions of requests
        # that allowed any redirects on the same host.
        if (old_parsed.scheme == 'http' and old_parsed.port in (80, None)
                and new_parsed.scheme == 'https' and new_parsed.port in (443, None)):
            return False

        # Handle default port usage corresponding to scheme.
        changed_port = old_parsed.port != new_parsed.port
        changed_scheme = old_parsed.scheme != new_parsed.scheme
        default_port = (DEFAULT_PORTS.get(old_parsed.scheme, None), None)
        if (not changed_scheme and old_parsed.port in default_port
                and new_parsed.port in default_port):
            return False

        # Standard case: root URI must match
        return changed_port or changed_scheme

    def resolve_redirects(self, resp, req, stream=False, timeout=None,
                          verify=True, cert=None, proxies=None, yield_requests=False, **adapter_kwargs):
        """Receives a Response. Returns a generator of Responses or Requests."""

        hist = []  # keep track of history

        url = self.get_redirect_target(resp)
        previous_fragment = urlparse(req.url).fragment
        while url:
            prepared_request = req.copy()

            # Update history and keep track of redirects.
            # resp.history must ignore the original request in this loop
            hist.append(resp)
            resp.history = hist[1:]

            try:
                resp.content  # Consume socket so it can be released
            except (ChunkedEncodingError, ContentDecodingError, RuntimeError):
                resp.raw.read(decode_content=False)

            if len(resp.history) >= self.max_redirects:
                raise TooManyRedirects('Exceeded %s redirects.' % self.max_redirects, response=resp)

            # Release the connection back into the pool.
            resp.close()

            # Handle redirection without scheme (see: RFC 1808 Section 4)
            if url.startswith('//'):
                parsed_rurl = urlparse(resp.url)
                url = '%s:%s' % (to_native_string(parsed_rurl.scheme), url)

            # Normalize url case and attach previous fragment if needed (RFC 7231 7.1.2)
            parsed = urlparse(url)
            if parsed.fragment == '' and previous_fragment:
                parsed = parsed._replace(fragment=previous_fragment)
            elif parsed.fragment:
                previous_fragment = parsed.fragment
            url = parsed.geturl()

            # Facilitate relative 'location' headers, as allowed by RFC 7231.
            # (e.g. '/path/to/resource' instead of 'http://domain.tld/path/to/resource')
            # Compliant with RFC3986, we percent encode the url.
            if not parsed.netloc:
                url = urljoin(resp.url, requote_uri(url))
            else:
                url = requote_uri(url)

            prepared_request.url = to_native_string(url)

            self.rebuild_method(prepared_request, resp)

            # https://github.com/requests/requests/issues/1084
            if resp.status_code not in (codes.temporary_redirect, codes.permanent_redirect):
                # https://github.com/requests/requests/issues/3490
                purged_headers = ('Content-Length', 'Content-Type', 'Transfer-Encoding')
                for header in purged_headers:
                    prepared_request.headers.pop(header, None)
                prepared_request.body = None

            headers = prepared_request.headers
            try:
                del headers['Cookie']
            except KeyError:
                pass

            # Extract any cookies sent on the response to the cookiejar
            # in the new request. Because we've mutated our copied prepared
            # request, use the old one that we haven't yet touched.
            extract_cookies_to_jar(prepared_request._cookies, req, resp.raw)
            merge_cookies(prepared_request._cookies, self.cookies)
            prepared_request.prepare_cookies(prepared_request._cookies)

            # Rebuild auth and proxy information.
            proxies = self.rebuild_proxies(prepared_request, proxies)
            self.rebuild_auth(prepared_request, resp)

            # A failed tell() sets `_body_position` to `object()`. This non-None
            # value ensures `rewindable` will be True, allowing us to raise an
            # UnrewindableBodyError, instead of hanging the connection.
            rewindable = (
                prepared_request._body_position is not None and
                ('Content-Length' in headers or 'Transfer-Encoding' in headers)
            )

            # Attempt to rewind consumed file-like object.
            if rewindable:
                rewind_body(prepared_request)

            # Override the original request.
            req = prepared_request

            if yield_requests:
                yield req
            else:

                resp = self.send(
                    req,
                    stream=stream,
                    timeout=timeout,
                    verify=verify,
                    cert=cert,
                    proxies=proxies,
                    allow_redirects=False,
                    **adapter_kwargs
                )

                extract_cookies_to_jar(self.cookies, prepared_request, resp.raw)

                # extract redirect url, if any, for the next loop
                url = self.get_redirect_target(resp)
                yield resp

    def rebuild_auth(self, prepared_request, response):
        """When being redirected we may want to strip authentication from the
        request to avoid leaking credentials. This method intelligently removes
        and reapplies authentication where possible to avoid credential loss.
        """
        headers = prepared_request.headers
        url = prepared_request.url

        if 'Authorization' in headers and self.should_strip_auth(response.request.url, url):
            # If we get redirected to a new host, we should strip out any
            # authentication headers.
            del headers['Authorization']

        # .netrc might have more auth for us on our new host.
        new_auth = get_netrc_auth(url) if self.trust_env else None
        if new_auth is not None:
            prepared_request.prepare_auth(new_auth)

        return

    def rebuild_proxies(self, prepared_request, proxies):
        """This method re-evaluates the proxy configuration by considering the
        environment variables. If we are redirected to a URL covered by
        NO_PROXY, we strip the proxy configuration. Otherwise, we set missing
        proxy keys for this URL (in case they were stripped by a previous
        redirect).

        This method also replaces the Proxy-Authorization header where
        necessary.

        :rtype: dict
        """
        proxies = proxies if proxies is not None else {}
        headers = prepared_request.headers
        url = prepared_request.url
        scheme = urlparse(url).scheme
        new_proxies = proxies.copy()
        no_proxy = proxies.get('no_proxy')

        bypass_proxy = should_bypass_proxies(url, no_proxy=no_proxy)
        if self.trust_env and not bypass_proxy:
            environ_proxies = get_environ_proxies(url, no_proxy=no_proxy)

            proxy = environ_proxies.get(scheme, environ_proxies.get('all'))

            if proxy:
                new_proxies.setdefault(scheme, proxy)

        if 'Proxy-Authorization' in headers:
            del headers['Proxy-Authorization']

        try:
            username, password = get_auth_from_url(new_proxies[scheme])
        except KeyError:
            username, password = None, None

        if username and password:
            headers['Proxy-Authorization'] = _basic_auth_str(username, password)

        return new_proxies

    def rebuild_method(self, prepared_request, response):
        """When being redirected we may want to change the method of the request
        based on certain specs or browser behavior.
        """
        method = prepared_request.method

        # https://tools.ietf.org/html/rfc7231#section-6.4.4
        if response.status_code == codes.see_other and method != 'HEAD':
            method = 'GET'

        # Do what the browsers do, despite standards...
        # First, turn 302s into GETs.
        if response.status_code == codes.found and method != 'HEAD':
            method = 'GET'

        # Second, if a POST is responded to with a 301, turn it into a GET.
        # This bizarre behaviour is explained in Issue 1704.
        if response.status_code == codes.moved and method == 'POST':
            method = 'GET'

        prepared_request.method = method


class Session(SessionRedirectMixin):
    """A Requests session.

    Provides cookie persistence, connection-pooling, and configuration.

    Basic Usage::

      >>> import requests
      >>> s = requests.Session()
      >>> s.get('https://httpbin.org/get')
      <Response [200]>

    Or as a context manager::

      >>> with requests.Session() as s:
      >>>     s.get('https://httpbin.org/get')
      <Response [200]>
    """

    __attrs__ = [
        'headers', 'cookies', 'auth', 'proxies', 'hooks', 'params', 'verify',
        'cert', 'prefetch', 'adapters', 'stream', 'trust_env',
        'max_redirects',
    ]

    def __init__(self):

        #: A case-insensitive dictionary of headers to be sent on each
        #: :class:`Request <Request>` sent from this
        #: :class:`Session <Session>`.
        self.headers = default_headers()

        #: Default Authentication tuple or object to attach to
        #: :class:`Request <Request>`.
        self.auth = None

        #: Dictionary mapping protocol or protocol and host to the URL of the proxy
        #: (e.g. {'http': 'foo.bar:3128', 'http://host.name': 'foo.bar:4012'}) to
        #: be used on each :class:`Request <Request>`.
        self.proxies = {}

        #: Event-handling hooks.
        self.hooks = default_hooks()

        #: Dictionary of querystring data to attach to each
        #: :class:`Request <Request>`. The dictionary values may be lists for
        #: representing multivalued query parameters.
        self.params = {}

        #: Stream response content default.
        self.stream = False

        #: SSL Verification default.
        self.verify = True

        #: SSL client certificate default, if String, path to ssl client
        #: cert file (.pem). If Tuple, ('cert', 'key') pair.
        self.cert = None

        #: Maximum number of redirects allowed. If the request exceeds this
        #: limit, a :class:`TooManyRedirects` exception is raised.
        #: This defaults to requests.models.DEFAULT_REDIRECT_LIMIT, which is
        #: 30.
        self.max_redirects = DEFAULT_REDIRECT_LIMIT

        #: Trust environment settings for proxy configuration, default
        #: authentication and similar.
        self.trust_env = True

        #: A CookieJar containing all currently outstanding cookies set on this
        #: session. By default it is a
        #: :class:`RequestsCookieJar <requests.cookies.RequestsCookieJar>`, but
        #: may be any other ``cookielib.CookieJar`` compatible object.
        self.cookies = cookiejar_from_dict({})

        # Default connection adapters.
        self.adapters = OrderedDict()
        self.mount('https://', HTTPAdapter())
        self.mount('http://', HTTPAdapter())

    def __enter__(self):
        return self

    def __exit__(self, *args):
        self.close()

    def prepare_request(self, request):
        """Constructs a :class:`PreparedRequest <PreparedRequest>` for
        transmission and returns it. The :class:`PreparedRequest` has settings
        merged from the :class:`Request <Request>` instance and those of the
        :class:`Session`.

        :param request: :class:`Request` instance to prepare with this
            session's settings.
        :rtype: requests.PreparedRequest
        """
        cookies = request.cookies or {}

        # Bootstrap CookieJar.
        if not isinstance(cookies, cookielib.CookieJar):
            cookies = cookiejar_from_dict(cookies)

        # Merge with session cookies
        merged_cookies = merge_cookies(
            merge_cookies(RequestsCookieJar(), self.cookies), cookies)

        # Set environment's basic authentication if not explicitly set.
        auth = request.auth
        if self.trust_env and not auth and not self.auth:
            auth = get_netrc_auth(request.url)

        p = PreparedRequest()
        p.prepare(
            method=request.method.upper(),
            url=request.url,
            files=request.files,
            data=request.data,
            json=request.json,
            headers=merge_setting(request.headers, self.headers, dict_class=CaseInsensitiveDict),
            params=merge_setting(request.params, self.params),
            auth=merge_setting(auth, self.auth),
            cookies=merged_cookies,
            hooks=merge_hooks(request.hooks, self.hooks),
        )
        return p

    def request(self, method, url,
            params=None, data=None, headers=None, cookies=None, files=None,
            auth=None, timeout=None, allow_redirects=True, proxies=None,
            hooks=None, stream=None, verify=None, cert=None, json=None):
        """Constructs a :class:`Request <Request>`, prepares it and sends it.
        Returns :class:`Response <Response>` object.

        :param method: method for the new :class:`Request` object.
        :param url: URL for the new :class:`Request` object.
        :param params: (optional) Dictionary or bytes to be sent in the query
            string for the :class:`Request`.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param json: (optional) json to send in the body of the
            :class:`Request`.
        :param headers: (optional) Dictionary of HTTP Headers to send with the
            :class:`Request`.
        :param cookies: (optional) Dict or CookieJar object to send with the
            :class:`Request`.
        :param files: (optional) Dictionary of ``'filename': file-like-objects``
            for multipart encoding upload.
        :param auth: (optional) Auth tuple or callable to enable
            Basic/Digest/Custom HTTP Auth.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple
        :param allow_redirects: (optional) Set to True by default.
        :type allow_redirects: bool
        :param proxies: (optional) Dictionary mapping protocol or protocol and
            hostname to the URL of the proxy.
        :param stream: (optional) whether to immediately download the response
            content. Defaults to ``False``.
        :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use. Defaults to ``True``.
        :param cert: (optional) if String, path to ssl client cert file (.pem).
            If Tuple, ('cert', 'key') pair.
        :rtype: requests.Response
        """
        # Create the Request.
        req = Request(
            method=method.upper(),
            url=url,
            headers=headers,
            files=files,
            data=data or {},
            json=json,
            params=params or {},
            auth=auth,
            cookies=cookies,
            hooks=hooks,
        )
        prep = self.prepare_request(req)

        proxies = proxies or {}

        settings = self.merge_environment_settings(
            prep.url, proxies, stream, verify, cert
        )

        # Send the request.
        send_kwargs = {
            'timeout': timeout,
            'allow_redirects': allow_redirects,
        }
        send_kwargs.update(settings)
        resp = self.send(prep, **send_kwargs)

        return resp

    def get(self, url, **kwargs):
        r"""Sends a GET request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        """

        kwargs.setdefault('allow_redirects', True)
        return self.request('GET', url, **kwargs)

    def options(self, url, **kwargs):
        r"""Sends a OPTIONS request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        """

        kwargs.setdefault('allow_redirects', True)
        return self.request('OPTIONS', url, **kwargs)

    def head(self, url, **kwargs):
        r"""Sends a HEAD request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        """

        kwargs.setdefault('allow_redirects', False)
        return self.request('HEAD', url, **kwargs)

    def post(self, url, data=None, json=None, **kwargs):
        r"""Sends a POST request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param json: (optional) json to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        """

        return self.request('POST', url, data=data, json=json, **kwargs)

    def put(self, url, data=None, **kwargs):
        r"""Sends a PUT request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        """

        return self.request('PUT', url, data=data, **kwargs)

    def patch(self, url, data=None, **kwargs):
        r"""Sends a PATCH request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param data: (optional) Dictionary, list of tuples, bytes, or file-like
            object to send in the body of the :class:`Request`.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        """

        return self.request('PATCH', url, data=data, **kwargs)

    def delete(self, url, **kwargs):
        r"""Sends a DELETE request. Returns :class:`Response` object.

        :param url: URL for the new :class:`Request` object.
        :param \*\*kwargs: Optional arguments that ``request`` takes.
        :rtype: requests.Response
        """

        return self.request('DELETE', url, **kwargs)

    def send(self, request, **kwargs):
        """Send a given PreparedRequest.

        :rtype: requests.Response
        """
        # Set defaults that the hooks can utilize to ensure they always have
        # the correct parameters to reproduce the previous request.
        kwargs.setdefault('stream', self.stream)
        kwargs.setdefault('verify', self.verify)
        kwargs.setdefault('cert', self.cert)
        kwargs.setdefault('proxies', self.proxies)

        # It's possible that users might accidentally send a Request object.
        # Guard against that specific failure case.
        if isinstance(request, Request):
            raise ValueError('You can only send PreparedRequests.')

        # Set up variables needed for resolve_redirects and dispatching of hooks
        allow_redirects = kwargs.pop('allow_redirects', True)
        stream = kwargs.get('stream')
        hooks = request.hooks

        # Get the appropriate adapter to use
        adapter = self.get_adapter(url=request.url)

        # Start time (approximately) of the request
        start = preferred_clock()

        # Send the request
        r = adapter.send(request, **kwargs)

        # Total elapsed time of the request (approximately)
        elapsed = preferred_clock() - start
        r.elapsed = timedelta(seconds=elapsed)

        # Response manipulation hooks
        r = dispatch_hook('response', hooks, r, **kwargs)

        # Persist cookies
        if r.history:

            # If the hooks create history then we want those cookies too
            for resp in r.history:
                extract_cookies_to_jar(self.cookies, resp.request, resp.raw)

        extract_cookies_to_jar(self.cookies, request, r.raw)

        # Redirect resolving generator.
        gen = self.resolve_redirects(r, request, **kwargs)

        # Resolve redirects if allowed.
        history = [resp for resp in gen] if allow_redirects else []

        # Shuffle things around if there's history.
        if history:
            # Insert the first (original) request at the start
            history.insert(0, r)
            # Get the last request made
            r = history.pop()
            r.history = history

        # If redirects aren't being followed, store the response on the Request for Response.next().
        if not allow_redirects:
            try:
                r._next = next(self.resolve_redirects(r, request, yield_requests=True, **kwargs))
            except StopIteration:
                pass

        if not stream:
            r.content

        return r

    def merge_environment_settings(self, url, proxies, stream, verify, cert):
        """
        Check the environment and merge it with some settings.

        :rtype: dict
        """
        # Gather clues from the surrounding environment.
        if self.trust_env:
            # Set environment's proxies.
            no_proxy = proxies.get('no_proxy') if proxies is not None else None
            env_proxies = get_environ_proxies(url, no_proxy=no_proxy)
            for (k, v) in env_proxies.items():
                proxies.setdefault(k, v)

            # Look for requests environment configuration and be compatible
            # with cURL.
            if verify is True or verify is None:
                verify = (os.environ.get('REQUESTS_CA_BUNDLE') or
                          os.environ.get('CURL_CA_BUNDLE'))

        # Merge all the kwargs.
        proxies = merge_setting(proxies, self.proxies)
        stream = merge_setting(stream, self.stream)
        verify = merge_setting(verify, self.verify)
        cert = merge_setting(cert, self.cert)

        return {'verify': verify, 'proxies': proxies, 'stream': stream,
                'cert': cert}

    def get_adapter(self, url):
        """
        Returns the appropriate connection adapter for the given URL.

        :rtype: requests.adapters.BaseAdapter
        """
        for (prefix, adapter) in self.adapters.items():

            if url.lower().startswith(prefix.lower()):
                return adapter

        # Nothing matches :-/
        raise InvalidSchema("No connection adapters were found for '%s'" % url)

    def close(self):
        """Closes all adapters and as such the session"""
        for v in self.adapters.values():
            v.close()

    def mount(self, prefix, adapter):
        """Registers a connection adapter to a prefix.

        Adapters are sorted in descending order by prefix length.
        """
        self.adapters[prefix] = adapter
        keys_to_move = [k for k in self.adapters if len(k) < len(prefix)]

        for key in keys_to_move:
            self.adapters[key] = self.adapters.pop(key)

    def __getstate__(self):
        state = {attr: getattr(self, attr, None) for attr in self.__attrs__}
        return state

    def __setstate__(self, state):
        for attr, value in state.items():
            setattr(self, attr, value)


def session():
    """
    Returns a :class:`Session` for context-management.

    .. deprecated:: 1.0.0

        This method has been deprecated since version 1.0.0 and is only kept for
        backwards compatibility. New code should use :class:`~requests.sessions.Session`
        to create a session. This may be removed at a future date.

    :rtype: Session
    """
    return Session()
site-packages/pip/_vendor/requests/models.py000064400000102743151446177000015234 0ustar00# -*- coding: utf-8 -*-

"""
requests.models
~~~~~~~~~~~~~~~

This module contains the primary objects that power Requests.
"""

import datetime
import sys

# Import encoding now, to avoid implicit import later.
# Implicit import within threads may cause LookupError when standard library is in a ZIP,
# such as in Embedded Python. See https://github.com/requests/requests/issues/3578.
import encodings.idna

from pip._vendor.urllib3.fields import RequestField
from pip._vendor.urllib3.filepost import encode_multipart_formdata
from pip._vendor.urllib3.util import parse_url
from pip._vendor.urllib3.exceptions import (
    DecodeError, ReadTimeoutError, ProtocolError, LocationParseError)

from io import UnsupportedOperation
from .hooks import default_hooks
from .structures import CaseInsensitiveDict

from .auth import HTTPBasicAuth
from .cookies import cookiejar_from_dict, get_cookie_header, _copy_cookie_jar
from .exceptions import (
    HTTPError, MissingSchema, InvalidURL, ChunkedEncodingError,
    ContentDecodingError, ConnectionError, StreamConsumedError)
from ._internal_utils import to_native_string, unicode_is_ascii
from .utils import (
    guess_filename, get_auth_from_url, requote_uri,
    stream_decode_response_unicode, to_key_val_list, parse_header_links,
    iter_slices, guess_json_utf, super_len, check_header_validity)
from .compat import (
    Callable, Mapping,
    cookielib, urlunparse, urlsplit, urlencode, str, bytes,
    is_py2, chardet, builtin_str, basestring)
from .compat import json as complexjson
from .status_codes import codes

#: The set of HTTP status codes that indicate an automatically
#: processable redirect.
REDIRECT_STATI = (
    codes.moved,               # 301
    codes.found,               # 302
    codes.other,               # 303
    codes.temporary_redirect,  # 307
    codes.permanent_redirect,  # 308
)

DEFAULT_REDIRECT_LIMIT = 30
CONTENT_CHUNK_SIZE = 10 * 1024
ITER_CHUNK_SIZE = 512


class RequestEncodingMixin(object):
    @property
    def path_url(self):
        """Build the path URL to use."""

        url = []

        p = urlsplit(self.url)

        path = p.path
        if not path:
            path = '/'

        url.append(path)

        query = p.query
        if query:
            url.append('?')
            url.append(query)

        return ''.join(url)

    @staticmethod
    def _encode_params(data):
        """Encode parameters in a piece of data.

        Will successfully encode parameters when passed as a dict or a list of
        2-tuples. Order is retained if data is a list of 2-tuples but arbitrary
        if parameters are supplied as a dict.
        """

        if isinstance(data, (str, bytes)):
            return data
        elif hasattr(data, 'read'):
            return data
        elif hasattr(data, '__iter__'):
            result = []
            for k, vs in to_key_val_list(data):
                if isinstance(vs, basestring) or not hasattr(vs, '__iter__'):
                    vs = [vs]
                for v in vs:
                    if v is not None:
                        result.append(
                            (k.encode('utf-8') if isinstance(k, str) else k,
                             v.encode('utf-8') if isinstance(v, str) else v))
            return urlencode(result, doseq=True)
        else:
            return data

    @staticmethod
    def _encode_files(files, data):
        """Build the body for a multipart/form-data request.

        Will successfully encode files when passed as a dict or a list of
        tuples. Order is retained if data is a list of tuples but arbitrary
        if parameters are supplied as a dict.
        The tuples may be 2-tuples (filename, fileobj), 3-tuples (filename, fileobj, contentype)
        or 4-tuples (filename, fileobj, contentype, custom_headers).
        """
        if (not files):
            raise ValueError("Files must be provided.")
        elif isinstance(data, basestring):
            raise ValueError("Data must not be a string.")

        new_fields = []
        fields = to_key_val_list(data or {})
        files = to_key_val_list(files or {})

        for field, val in fields:
            if isinstance(val, basestring) or not hasattr(val, '__iter__'):
                val = [val]
            for v in val:
                if v is not None:
                    # Don't call str() on bytestrings: in Py3 it all goes wrong.
                    if not isinstance(v, bytes):
                        v = str(v)

                    new_fields.append(
                        (field.decode('utf-8') if isinstance(field, bytes) else field,
                         v.encode('utf-8') if isinstance(v, str) else v))

        for (k, v) in files:
            # support for explicit filename
            ft = None
            fh = None
            if isinstance(v, (tuple, list)):
                if len(v) == 2:
                    fn, fp = v
                elif len(v) == 3:
                    fn, fp, ft = v
                else:
                    fn, fp, ft, fh = v
            else:
                fn = guess_filename(v) or k
                fp = v

            if isinstance(fp, (str, bytes, bytearray)):
                fdata = fp
            elif hasattr(fp, 'read'):
                fdata = fp.read()
            elif fp is None:
                continue
            else:
                fdata = fp

            rf = RequestField(name=k, data=fdata, filename=fn, headers=fh)
            rf.make_multipart(content_type=ft)
            new_fields.append(rf)

        body, content_type = encode_multipart_formdata(new_fields)

        return body, content_type


class RequestHooksMixin(object):
    def register_hook(self, event, hook):
        """Properly register a hook."""

        if event not in self.hooks:
            raise ValueError('Unsupported event specified, with event name "%s"' % (event))

        if isinstance(hook, Callable):
            self.hooks[event].append(hook)
        elif hasattr(hook, '__iter__'):
            self.hooks[event].extend(h for h in hook if isinstance(h, Callable))

    def deregister_hook(self, event, hook):
        """Deregister a previously registered hook.
        Returns True if the hook existed, False if not.
        """

        try:
            self.hooks[event].remove(hook)
            return True
        except ValueError:
            return False


class Request(RequestHooksMixin):
    """A user-created :class:`Request <Request>` object.

    Used to prepare a :class:`PreparedRequest <PreparedRequest>`, which is sent to the server.

    :param method: HTTP method to use.
    :param url: URL to send.
    :param headers: dictionary of headers to send.
    :param files: dictionary of {filename: fileobject} files to multipart upload.
    :param data: the body to attach to the request. If a dictionary or
        list of tuples ``[(key, value)]`` is provided, form-encoding will
        take place.
    :param json: json for the body to attach to the request (if files or data is not specified).
    :param params: URL parameters to append to the URL. If a dictionary or
        list of tuples ``[(key, value)]`` is provided, form-encoding will
        take place.
    :param auth: Auth handler or (user, pass) tuple.
    :param cookies: dictionary or CookieJar of cookies to attach to this request.
    :param hooks: dictionary of callback hooks, for internal usage.

    Usage::

      >>> import requests
      >>> req = requests.Request('GET', 'https://httpbin.org/get')
      >>> req.prepare()
      <PreparedRequest [GET]>
    """

    def __init__(self,
            method=None, url=None, headers=None, files=None, data=None,
            params=None, auth=None, cookies=None, hooks=None, json=None):

        # Default empty dicts for dict params.
        data = [] if data is None else data
        files = [] if files is None else files
        headers = {} if headers is None else headers
        params = {} if params is None else params
        hooks = {} if hooks is None else hooks

        self.hooks = default_hooks()
        for (k, v) in list(hooks.items()):
            self.register_hook(event=k, hook=v)

        self.method = method
        self.url = url
        self.headers = headers
        self.files = files
        self.data = data
        self.json = json
        self.params = params
        self.auth = auth
        self.cookies = cookies

    def __repr__(self):
        return '<Request [%s]>' % (self.method)

    def prepare(self):
        """Constructs a :class:`PreparedRequest <PreparedRequest>` for transmission and returns it."""
        p = PreparedRequest()
        p.prepare(
            method=self.method,
            url=self.url,
            headers=self.headers,
            files=self.files,
            data=self.data,
            json=self.json,
            params=self.params,
            auth=self.auth,
            cookies=self.cookies,
            hooks=self.hooks,
        )
        return p


class PreparedRequest(RequestEncodingMixin, RequestHooksMixin):
    """The fully mutable :class:`PreparedRequest <PreparedRequest>` object,
    containing the exact bytes that will be sent to the server.

    Generated from either a :class:`Request <Request>` object or manually.

    Usage::

      >>> import requests
      >>> req = requests.Request('GET', 'https://httpbin.org/get')
      >>> r = req.prepare()
      <PreparedRequest [GET]>

      >>> s = requests.Session()
      >>> s.send(r)
      <Response [200]>
    """

    def __init__(self):
        #: HTTP verb to send to the server.
        self.method = None
        #: HTTP URL to send the request to.
        self.url = None
        #: dictionary of HTTP headers.
        self.headers = None
        # The `CookieJar` used to create the Cookie header will be stored here
        # after prepare_cookies is called
        self._cookies = None
        #: request body to send to the server.
        self.body = None
        #: dictionary of callback hooks, for internal usage.
        self.hooks = default_hooks()
        #: integer denoting starting position of a readable file-like body.
        self._body_position = None

    def prepare(self,
            method=None, url=None, headers=None, files=None, data=None,
            params=None, auth=None, cookies=None, hooks=None, json=None):
        """Prepares the entire request with the given parameters."""

        self.prepare_method(method)
        self.prepare_url(url, params)
        self.prepare_headers(headers)
        self.prepare_cookies(cookies)
        self.prepare_body(data, files, json)
        self.prepare_auth(auth, url)

        # Note that prepare_auth must be last to enable authentication schemes
        # such as OAuth to work on a fully prepared request.

        # This MUST go after prepare_auth. Authenticators could add a hook
        self.prepare_hooks(hooks)

    def __repr__(self):
        return '<PreparedRequest [%s]>' % (self.method)

    def copy(self):
        p = PreparedRequest()
        p.method = self.method
        p.url = self.url
        p.headers = self.headers.copy() if self.headers is not None else None
        p._cookies = _copy_cookie_jar(self._cookies)
        p.body = self.body
        p.hooks = self.hooks
        p._body_position = self._body_position
        return p

    def prepare_method(self, method):
        """Prepares the given HTTP method."""
        self.method = method
        if self.method is not None:
            self.method = to_native_string(self.method.upper())

    @staticmethod
    def _get_idna_encoded_host(host):
        from pip._vendor import idna

        try:
            host = idna.encode(host, uts46=True).decode('utf-8')
        except idna.IDNAError:
            raise UnicodeError
        return host

    def prepare_url(self, url, params):
        """Prepares the given HTTP URL."""
        #: Accept objects that have string representations.
        #: We're unable to blindly call unicode/str functions
        #: as this will include the bytestring indicator (b'')
        #: on python 3.x.
        #: https://github.com/requests/requests/pull/2238
        if isinstance(url, bytes):
            url = url.decode('utf8')
        else:
            url = unicode(url) if is_py2 else str(url)

        # Remove leading whitespaces from url
        url = url.lstrip()

        # Don't do any URL preparation for non-HTTP schemes like `mailto`,
        # `data` etc to work around exceptions from `url_parse`, which
        # handles RFC 3986 only.
        if ':' in url and not url.lower().startswith('http'):
            self.url = url
            return

        # Support for unicode domain names and paths.
        try:
            scheme, auth, host, port, path, query, fragment = parse_url(url)
        except LocationParseError as e:
            raise InvalidURL(*e.args)

        if not scheme:
            error = ("Invalid URL {0!r}: No schema supplied. Perhaps you meant http://{0}?")
            error = error.format(to_native_string(url, 'utf8'))

            raise MissingSchema(error)

        if not host:
            raise InvalidURL("Invalid URL %r: No host supplied" % url)

        # In general, we want to try IDNA encoding the hostname if the string contains
        # non-ASCII characters. This allows users to automatically get the correct IDNA
        # behaviour. For strings containing only ASCII characters, we need to also verify
        # it doesn't start with a wildcard (*), before allowing the unencoded hostname.
        if not unicode_is_ascii(host):
            try:
                host = self._get_idna_encoded_host(host)
            except UnicodeError:
                raise InvalidURL('URL has an invalid label.')
        elif host.startswith(u'*'):
            raise InvalidURL('URL has an invalid label.')

        # Carefully reconstruct the network location
        netloc = auth or ''
        if netloc:
            netloc += '@'
        netloc += host
        if port:
            netloc += ':' + str(port)

        # Bare domains aren't valid URLs.
        if not path:
            path = '/'

        if is_py2:
            if isinstance(scheme, str):
                scheme = scheme.encode('utf-8')
            if isinstance(netloc, str):
                netloc = netloc.encode('utf-8')
            if isinstance(path, str):
                path = path.encode('utf-8')
            if isinstance(query, str):
                query = query.encode('utf-8')
            if isinstance(fragment, str):
                fragment = fragment.encode('utf-8')

        if isinstance(params, (str, bytes)):
            params = to_native_string(params)

        enc_params = self._encode_params(params)
        if enc_params:
            if query:
                query = '%s&%s' % (query, enc_params)
            else:
                query = enc_params

        url = requote_uri(urlunparse([scheme, netloc, path, None, query, fragment]))
        self.url = url

    def prepare_headers(self, headers):
        """Prepares the given HTTP headers."""

        self.headers = CaseInsensitiveDict()
        if headers:
            for header in headers.items():
                # Raise exception on invalid header value.
                check_header_validity(header)
                name, value = header
                self.headers[to_native_string(name)] = value

    def prepare_body(self, data, files, json=None):
        """Prepares the given HTTP body data."""

        # Check if file, fo, generator, iterator.
        # If not, run through normal process.

        # Nottin' on you.
        body = None
        content_type = None

        if not data and json is not None:
            # urllib3 requires a bytes-like body. Python 2's json.dumps
            # provides this natively, but Python 3 gives a Unicode string.
            content_type = 'application/json'
            body = complexjson.dumps(json)
            if not isinstance(body, bytes):
                body = body.encode('utf-8')

        is_stream = all([
            hasattr(data, '__iter__'),
            not isinstance(data, (basestring, list, tuple, Mapping))
        ])

        try:
            length = super_len(data)
        except (TypeError, AttributeError, UnsupportedOperation):
            length = None

        if is_stream:
            body = data

            if getattr(body, 'tell', None) is not None:
                # Record the current file position before reading.
                # This will allow us to rewind a file in the event
                # of a redirect.
                try:
                    self._body_position = body.tell()
                except (IOError, OSError):
                    # This differentiates from None, allowing us to catch
                    # a failed `tell()` later when trying to rewind the body
                    self._body_position = object()

            if files:
                raise NotImplementedError('Streamed bodies and files are mutually exclusive.')

            if length:
                self.headers['Content-Length'] = builtin_str(length)
            else:
                self.headers['Transfer-Encoding'] = 'chunked'
        else:
            # Multi-part file uploads.
            if files:
                (body, content_type) = self._encode_files(files, data)
            else:
                if data:
                    body = self._encode_params(data)
                    if isinstance(data, basestring) or hasattr(data, 'read'):
                        content_type = None
                    else:
                        content_type = 'application/x-www-form-urlencoded'

            self.prepare_content_length(body)

            # Add content-type if it wasn't explicitly provided.
            if content_type and ('content-type' not in self.headers):
                self.headers['Content-Type'] = content_type

        self.body = body

    def prepare_content_length(self, body):
        """Prepare Content-Length header based on request method and body"""
        if body is not None:
            length = super_len(body)
            if length:
                # If length exists, set it. Otherwise, we fallback
                # to Transfer-Encoding: chunked.
                self.headers['Content-Length'] = builtin_str(length)
        elif self.method not in ('GET', 'HEAD') and self.headers.get('Content-Length') is None:
            # Set Content-Length to 0 for methods that can have a body
            # but don't provide one. (i.e. not GET or HEAD)
            self.headers['Content-Length'] = '0'

    def prepare_auth(self, auth, url=''):
        """Prepares the given HTTP auth data."""

        # If no Auth is explicitly provided, extract it from the URL first.
        if auth is None:
            url_auth = get_auth_from_url(self.url)
            auth = url_auth if any(url_auth) else None

        if auth:
            if isinstance(auth, tuple) and len(auth) == 2:
                # special-case basic HTTP auth
                auth = HTTPBasicAuth(*auth)

            # Allow auth to make its changes.
            r = auth(self)

            # Update self to reflect the auth changes.
            self.__dict__.update(r.__dict__)

            # Recompute Content-Length
            self.prepare_content_length(self.body)

    def prepare_cookies(self, cookies):
        """Prepares the given HTTP cookie data.

        This function eventually generates a ``Cookie`` header from the
        given cookies using cookielib. Due to cookielib's design, the header
        will not be regenerated if it already exists, meaning this function
        can only be called once for the life of the
        :class:`PreparedRequest <PreparedRequest>` object. Any subsequent calls
        to ``prepare_cookies`` will have no actual effect, unless the "Cookie"
        header is removed beforehand.
        """
        if isinstance(cookies, cookielib.CookieJar):
            self._cookies = cookies
        else:
            self._cookies = cookiejar_from_dict(cookies)

        cookie_header = get_cookie_header(self._cookies, self)
        if cookie_header is not None:
            self.headers['Cookie'] = cookie_header

    def prepare_hooks(self, hooks):
        """Prepares the given hooks."""
        # hooks can be passed as None to the prepare method and to this
        # method. To prevent iterating over None, simply use an empty list
        # if hooks is False-y
        hooks = hooks or []
        for event in hooks:
            self.register_hook(event, hooks[event])


class Response(object):
    """The :class:`Response <Response>` object, which contains a
    server's response to an HTTP request.
    """

    __attrs__ = [
        '_content', 'status_code', 'headers', 'url', 'history',
        'encoding', 'reason', 'cookies', 'elapsed', 'request'
    ]

    def __init__(self):
        self._content = False
        self._content_consumed = False
        self._next = None

        #: Integer Code of responded HTTP Status, e.g. 404 or 200.
        self.status_code = None

        #: Case-insensitive Dictionary of Response Headers.
        #: For example, ``headers['content-encoding']`` will return the
        #: value of a ``'Content-Encoding'`` response header.
        self.headers = CaseInsensitiveDict()

        #: File-like object representation of response (for advanced usage).
        #: Use of ``raw`` requires that ``stream=True`` be set on the request.
        # This requirement does not apply for use internally to Requests.
        self.raw = None

        #: Final URL location of Response.
        self.url = None

        #: Encoding to decode with when accessing r.text.
        self.encoding = None

        #: A list of :class:`Response <Response>` objects from
        #: the history of the Request. Any redirect responses will end
        #: up here. The list is sorted from the oldest to the most recent request.
        self.history = []

        #: Textual reason of responded HTTP Status, e.g. "Not Found" or "OK".
        self.reason = None

        #: A CookieJar of Cookies the server sent back.
        self.cookies = cookiejar_from_dict({})

        #: The amount of time elapsed between sending the request
        #: and the arrival of the response (as a timedelta).
        #: This property specifically measures the time taken between sending
        #: the first byte of the request and finishing parsing the headers. It
        #: is therefore unaffected by consuming the response content or the
        #: value of the ``stream`` keyword argument.
        self.elapsed = datetime.timedelta(0)

        #: The :class:`PreparedRequest <PreparedRequest>` object to which this
        #: is a response.
        self.request = None

    def __enter__(self):
        return self

    def __exit__(self, *args):
        self.close()

    def __getstate__(self):
        # Consume everything; accessing the content attribute makes
        # sure the content has been fully read.
        if not self._content_consumed:
            self.content

        return {attr: getattr(self, attr, None) for attr in self.__attrs__}

    def __setstate__(self, state):
        for name, value in state.items():
            setattr(self, name, value)

        # pickled objects do not have .raw
        setattr(self, '_content_consumed', True)
        setattr(self, 'raw', None)

    def __repr__(self):
        return '<Response [%s]>' % (self.status_code)

    def __bool__(self):
        """Returns True if :attr:`status_code` is less than 400.

        This attribute checks if the status code of the response is between
        400 and 600 to see if there was a client error or a server error. If
        the status code, is between 200 and 400, this will return True. This
        is **not** a check to see if the response code is ``200 OK``.
        """
        return self.ok

    def __nonzero__(self):
        """Returns True if :attr:`status_code` is less than 400.

        This attribute checks if the status code of the response is between
        400 and 600 to see if there was a client error or a server error. If
        the status code, is between 200 and 400, this will return True. This
        is **not** a check to see if the response code is ``200 OK``.
        """
        return self.ok

    def __iter__(self):
        """Allows you to use a response as an iterator."""
        return self.iter_content(128)

    @property
    def ok(self):
        """Returns True if :attr:`status_code` is less than 400, False if not.

        This attribute checks if the status code of the response is between
        400 and 600 to see if there was a client error or a server error. If
        the status code is between 200 and 400, this will return True. This
        is **not** a check to see if the response code is ``200 OK``.
        """
        try:
            self.raise_for_status()
        except HTTPError:
            return False
        return True

    @property
    def is_redirect(self):
        """True if this Response is a well-formed HTTP redirect that could have
        been processed automatically (by :meth:`Session.resolve_redirects`).
        """
        return ('location' in self.headers and self.status_code in REDIRECT_STATI)

    @property
    def is_permanent_redirect(self):
        """True if this Response one of the permanent versions of redirect."""
        return ('location' in self.headers and self.status_code in (codes.moved_permanently, codes.permanent_redirect))

    @property
    def next(self):
        """Returns a PreparedRequest for the next request in a redirect chain, if there is one."""
        return self._next

    @property
    def apparent_encoding(self):
        """The apparent encoding, provided by the chardet library."""
        return chardet.detect(self.content)['encoding']

    def iter_content(self, chunk_size=1, decode_unicode=False):
        """Iterates over the response data.  When stream=True is set on the
        request, this avoids reading the content at once into memory for
        large responses.  The chunk size is the number of bytes it should
        read into memory.  This is not necessarily the length of each item
        returned as decoding can take place.

        chunk_size must be of type int or None. A value of None will
        function differently depending on the value of `stream`.
        stream=True will read data as it arrives in whatever size the
        chunks are received. If stream=False, data is returned as
        a single chunk.

        If decode_unicode is True, content will be decoded using the best
        available encoding based on the response.
        """

        def generate():
            # Special case for urllib3.
            if hasattr(self.raw, 'stream'):
                try:
                    for chunk in self.raw.stream(chunk_size, decode_content=True):
                        yield chunk
                except ProtocolError as e:
                    raise ChunkedEncodingError(e)
                except DecodeError as e:
                    raise ContentDecodingError(e)
                except ReadTimeoutError as e:
                    raise ConnectionError(e)
            else:
                # Standard file-like object.
                while True:
                    chunk = self.raw.read(chunk_size)
                    if not chunk:
                        break
                    yield chunk

            self._content_consumed = True

        if self._content_consumed and isinstance(self._content, bool):
            raise StreamConsumedError()
        elif chunk_size is not None and not isinstance(chunk_size, int):
            raise TypeError("chunk_size must be an int, it is instead a %s." % type(chunk_size))
        # simulate reading small chunks of the content
        reused_chunks = iter_slices(self._content, chunk_size)

        stream_chunks = generate()

        chunks = reused_chunks if self._content_consumed else stream_chunks

        if decode_unicode:
            chunks = stream_decode_response_unicode(chunks, self)

        return chunks

    def iter_lines(self, chunk_size=ITER_CHUNK_SIZE, decode_unicode=False, delimiter=None):
        """Iterates over the response data, one line at a time.  When
        stream=True is set on the request, this avoids reading the
        content at once into memory for large responses.

        .. note:: This method is not reentrant safe.
        """

        pending = None

        for chunk in self.iter_content(chunk_size=chunk_size, decode_unicode=decode_unicode):

            if pending is not None:
                chunk = pending + chunk

            if delimiter:
                lines = chunk.split(delimiter)
            else:
                lines = chunk.splitlines()

            if lines and lines[-1] and chunk and lines[-1][-1] == chunk[-1]:
                pending = lines.pop()
            else:
                pending = None

            for line in lines:
                yield line

        if pending is not None:
            yield pending

    @property
    def content(self):
        """Content of the response, in bytes."""

        if self._content is False:
            # Read the contents.
            if self._content_consumed:
                raise RuntimeError(
                    'The content for this response was already consumed')

            if self.status_code == 0 or self.raw is None:
                self._content = None
            else:
                self._content = b''.join(self.iter_content(CONTENT_CHUNK_SIZE)) or b''

        self._content_consumed = True
        # don't need to release the connection; that's been handled by urllib3
        # since we exhausted the data.
        return self._content

    @property
    def text(self):
        """Content of the response, in unicode.

        If Response.encoding is None, encoding will be guessed using
        ``chardet``.

        The encoding of the response content is determined based solely on HTTP
        headers, following RFC 2616 to the letter. If you can take advantage of
        non-HTTP knowledge to make a better guess at the encoding, you should
        set ``r.encoding`` appropriately before accessing this property.
        """

        # Try charset from content-type
        content = None
        encoding = self.encoding

        if not self.content:
            return str('')

        # Fallback to auto-detected encoding.
        if self.encoding is None:
            encoding = self.apparent_encoding

        # Decode unicode from given encoding.
        try:
            content = str(self.content, encoding, errors='replace')
        except (LookupError, TypeError):
            # A LookupError is raised if the encoding was not found which could
            # indicate a misspelling or similar mistake.
            #
            # A TypeError can be raised if encoding is None
            #
            # So we try blindly encoding.
            content = str(self.content, errors='replace')

        return content

    def json(self, **kwargs):
        r"""Returns the json-encoded content of a response, if any.

        :param \*\*kwargs: Optional arguments that ``json.loads`` takes.
        :raises ValueError: If the response body does not contain valid json.
        """

        if not self.encoding and self.content and len(self.content) > 3:
            # No encoding set. JSON RFC 4627 section 3 states we should expect
            # UTF-8, -16 or -32. Detect which one to use; If the detection or
            # decoding fails, fall back to `self.text` (using chardet to make
            # a best guess).
            encoding = guess_json_utf(self.content)
            if encoding is not None:
                try:
                    return complexjson.loads(
                        self.content.decode(encoding), **kwargs
                    )
                except UnicodeDecodeError:
                    # Wrong UTF codec detected; usually because it's not UTF-8
                    # but some other 8-bit codec.  This is an RFC violation,
                    # and the server didn't bother to tell us what codec *was*
                    # used.
                    pass
        return complexjson.loads(self.text, **kwargs)

    @property
    def links(self):
        """Returns the parsed header links of the response, if any."""

        header = self.headers.get('link')

        # l = MultiDict()
        l = {}

        if header:
            links = parse_header_links(header)

            for link in links:
                key = link.get('rel') or link.get('url')
                l[key] = link

        return l

    def raise_for_status(self):
        """Raises stored :class:`HTTPError`, if one occurred."""

        http_error_msg = ''
        if isinstance(self.reason, bytes):
            # We attempt to decode utf-8 first because some servers
            # choose to localize their reason strings. If the string
            # isn't utf-8, we fall back to iso-8859-1 for all other
            # encodings. (See PR #3538)
            try:
                reason = self.reason.decode('utf-8')
            except UnicodeDecodeError:
                reason = self.reason.decode('iso-8859-1')
        else:
            reason = self.reason

        if 400 <= self.status_code < 500:
            http_error_msg = u'%s Client Error: %s for url: %s' % (self.status_code, reason, self.url)

        elif 500 <= self.status_code < 600:
            http_error_msg = u'%s Server Error: %s for url: %s' % (self.status_code, reason, self.url)

        if http_error_msg:
            raise HTTPError(http_error_msg, response=self)

    def close(self):
        """Releases the connection back to the pool. Once this method has been
        called the underlying ``raw`` object must not be accessed again.

        *Note: Should not normally need to be called explicitly.*
        """
        if not self._content_consumed:
            self.raw.close()

        release_conn = getattr(self.raw, 'release_conn', None)
        if release_conn is not None:
            release_conn()
site-packages/pip/_vendor/requests/exceptions.py000064400000006175151446177000016134 0ustar00# -*- coding: utf-8 -*-

"""
requests.exceptions
~~~~~~~~~~~~~~~~~~~

This module contains the set of Requests' exceptions.
"""
from pip._vendor.urllib3.exceptions import HTTPError as BaseHTTPError


class RequestException(IOError):
    """There was an ambiguous exception that occurred while handling your
    request.
    """

    def __init__(self, *args, **kwargs):
        """Initialize RequestException with `request` and `response` objects."""
        response = kwargs.pop('response', None)
        self.response = response
        self.request = kwargs.pop('request', None)
        if (response is not None and not self.request and
                hasattr(response, 'request')):
            self.request = self.response.request
        super(RequestException, self).__init__(*args, **kwargs)


class HTTPError(RequestException):
    """An HTTP error occurred."""


class ConnectionError(RequestException):
    """A Connection error occurred."""


class ProxyError(ConnectionError):
    """A proxy error occurred."""


class SSLError(ConnectionError):
    """An SSL error occurred."""


class Timeout(RequestException):
    """The request timed out.

    Catching this error will catch both
    :exc:`~requests.exceptions.ConnectTimeout` and
    :exc:`~requests.exceptions.ReadTimeout` errors.
    """


class ConnectTimeout(ConnectionError, Timeout):
    """The request timed out while trying to connect to the remote server.

    Requests that produced this error are safe to retry.
    """


class ReadTimeout(Timeout):
    """The server did not send any data in the allotted amount of time."""


class URLRequired(RequestException):
    """A valid URL is required to make a request."""


class TooManyRedirects(RequestException):
    """Too many redirects."""


class MissingSchema(RequestException, ValueError):
    """The URL schema (e.g. http or https) is missing."""


class InvalidSchema(RequestException, ValueError):
    """See defaults.py for valid schemas."""


class InvalidURL(RequestException, ValueError):
    """The URL provided was somehow invalid."""


class InvalidHeader(RequestException, ValueError):
    """The header value provided was somehow invalid."""


class InvalidProxyURL(InvalidURL):
    """The proxy URL provided is invalid."""


class ChunkedEncodingError(RequestException):
    """The server declared chunked encoding but sent an invalid chunk."""


class ContentDecodingError(RequestException, BaseHTTPError):
    """Failed to decode response content"""


class StreamConsumedError(RequestException, TypeError):
    """The content for this response was already consumed"""


class RetryError(RequestException):
    """Custom retries logic failed"""


class UnrewindableBodyError(RequestException):
    """Requests encountered an error when trying to rewind a body"""

# Warnings


class RequestsWarning(Warning):
    """Base warning for Requests."""
    pass


class FileModeWarning(RequestsWarning, DeprecationWarning):
    """A file was opened in text mode, but Requests determined its binary length."""
    pass


class RequestsDependencyWarning(RequestsWarning):
    """An imported dependency doesn't match the expected version range."""
    pass
site-packages/pip/_vendor/requests/adapters.py000064400000052054151446177000015553 0ustar00# -*- coding: utf-8 -*-

"""
requests.adapters
~~~~~~~~~~~~~~~~~

This module contains the transport adapters that Requests uses to define
and maintain connections.
"""

import os.path
import socket

from pip._vendor.urllib3.poolmanager import PoolManager, proxy_from_url
from pip._vendor.urllib3.response import HTTPResponse
from pip._vendor.urllib3.util import parse_url
from pip._vendor.urllib3.util import Timeout as TimeoutSauce
from pip._vendor.urllib3.util.retry import Retry
from pip._vendor.urllib3.exceptions import ClosedPoolError
from pip._vendor.urllib3.exceptions import ConnectTimeoutError
from pip._vendor.urllib3.exceptions import HTTPError as _HTTPError
from pip._vendor.urllib3.exceptions import MaxRetryError
from pip._vendor.urllib3.exceptions import NewConnectionError
from pip._vendor.urllib3.exceptions import ProxyError as _ProxyError
from pip._vendor.urllib3.exceptions import ProtocolError
from pip._vendor.urllib3.exceptions import ReadTimeoutError
from pip._vendor.urllib3.exceptions import SSLError as _SSLError
from pip._vendor.urllib3.exceptions import ResponseError
from pip._vendor.urllib3.exceptions import LocationValueError

from .models import Response
from .compat import urlparse, basestring
from .utils import (DEFAULT_CA_BUNDLE_PATH, extract_zipped_paths,
                    get_encoding_from_headers, prepend_scheme_if_needed,
                    get_auth_from_url, urldefragauth, select_proxy)
from .structures import CaseInsensitiveDict
from .cookies import extract_cookies_to_jar
from .exceptions import (ConnectionError, ConnectTimeout, ReadTimeout, SSLError,
                         ProxyError, RetryError, InvalidSchema, InvalidProxyURL,
                         InvalidURL)
from .auth import _basic_auth_str

try:
    from pip._vendor.urllib3.contrib.socks import SOCKSProxyManager
except ImportError:
    def SOCKSProxyManager(*args, **kwargs):
        raise InvalidSchema("Missing dependencies for SOCKS support.")

DEFAULT_POOLBLOCK = False
DEFAULT_POOLSIZE = 10
DEFAULT_RETRIES = 0
DEFAULT_POOL_TIMEOUT = None


class BaseAdapter(object):
    """The Base Transport Adapter"""

    def __init__(self):
        super(BaseAdapter, self).__init__()

    def send(self, request, stream=False, timeout=None, verify=True,
             cert=None, proxies=None):
        """Sends PreparedRequest object. Returns Response object.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param stream: (optional) Whether to stream the request content.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple
        :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use
        :param cert: (optional) Any user-provided SSL certificate to be trusted.
        :param proxies: (optional) The proxies dictionary to apply to the request.
        """
        raise NotImplementedError

    def close(self):
        """Cleans up adapter specific items."""
        raise NotImplementedError


class HTTPAdapter(BaseAdapter):
    """The built-in HTTP Adapter for urllib3.

    Provides a general-case interface for Requests sessions to contact HTTP and
    HTTPS urls by implementing the Transport Adapter interface. This class will
    usually be created by the :class:`Session <Session>` class under the
    covers.

    :param pool_connections: The number of urllib3 connection pools to cache.
    :param pool_maxsize: The maximum number of connections to save in the pool.
    :param max_retries: The maximum number of retries each connection
        should attempt. Note, this applies only to failed DNS lookups, socket
        connections and connection timeouts, never to requests where data has
        made it to the server. By default, Requests does not retry failed
        connections. If you need granular control over the conditions under
        which we retry a request, import urllib3's ``Retry`` class and pass
        that instead.
    :param pool_block: Whether the connection pool should block for connections.

    Usage::

      >>> import requests
      >>> s = requests.Session()
      >>> a = requests.adapters.HTTPAdapter(max_retries=3)
      >>> s.mount('http://', a)
    """
    __attrs__ = ['max_retries', 'config', '_pool_connections', '_pool_maxsize',
                 '_pool_block']

    def __init__(self, pool_connections=DEFAULT_POOLSIZE,
                 pool_maxsize=DEFAULT_POOLSIZE, max_retries=DEFAULT_RETRIES,
                 pool_block=DEFAULT_POOLBLOCK):
        if max_retries == DEFAULT_RETRIES:
            self.max_retries = Retry(0, read=False)
        else:
            self.max_retries = Retry.from_int(max_retries)
        self.config = {}
        self.proxy_manager = {}

        super(HTTPAdapter, self).__init__()

        self._pool_connections = pool_connections
        self._pool_maxsize = pool_maxsize
        self._pool_block = pool_block

        self.init_poolmanager(pool_connections, pool_maxsize, block=pool_block)

    def __getstate__(self):
        return {attr: getattr(self, attr, None) for attr in self.__attrs__}

    def __setstate__(self, state):
        # Can't handle by adding 'proxy_manager' to self.__attrs__ because
        # self.poolmanager uses a lambda function, which isn't pickleable.
        self.proxy_manager = {}
        self.config = {}

        for attr, value in state.items():
            setattr(self, attr, value)

        self.init_poolmanager(self._pool_connections, self._pool_maxsize,
                              block=self._pool_block)

    def init_poolmanager(self, connections, maxsize, block=DEFAULT_POOLBLOCK, **pool_kwargs):
        """Initializes a urllib3 PoolManager.

        This method should not be called from user code, and is only
        exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param connections: The number of urllib3 connection pools to cache.
        :param maxsize: The maximum number of connections to save in the pool.
        :param block: Block when no free connections are available.
        :param pool_kwargs: Extra keyword arguments used to initialize the Pool Manager.
        """
        # save these values for pickling
        self._pool_connections = connections
        self._pool_maxsize = maxsize
        self._pool_block = block

        self.poolmanager = PoolManager(num_pools=connections, maxsize=maxsize,
                                       block=block, strict=True, **pool_kwargs)

    def proxy_manager_for(self, proxy, **proxy_kwargs):
        """Return urllib3 ProxyManager for the given proxy.

        This method should not be called from user code, and is only
        exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param proxy: The proxy to return a urllib3 ProxyManager for.
        :param proxy_kwargs: Extra keyword arguments used to configure the Proxy Manager.
        :returns: ProxyManager
        :rtype: urllib3.ProxyManager
        """
        if proxy in self.proxy_manager:
            manager = self.proxy_manager[proxy]
        elif proxy.lower().startswith('socks'):
            username, password = get_auth_from_url(proxy)
            manager = self.proxy_manager[proxy] = SOCKSProxyManager(
                proxy,
                username=username,
                password=password,
                num_pools=self._pool_connections,
                maxsize=self._pool_maxsize,
                block=self._pool_block,
                **proxy_kwargs
            )
        else:
            proxy_headers = self.proxy_headers(proxy)
            manager = self.proxy_manager[proxy] = proxy_from_url(
                proxy,
                proxy_headers=proxy_headers,
                num_pools=self._pool_connections,
                maxsize=self._pool_maxsize,
                block=self._pool_block,
                **proxy_kwargs)

        return manager

    def cert_verify(self, conn, url, verify, cert):
        """Verify a SSL certificate. This method should not be called from user
        code, and is only exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param conn: The urllib3 connection object associated with the cert.
        :param url: The requested URL.
        :param verify: Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use
        :param cert: The SSL certificate to verify.
        """
        if url.lower().startswith('https') and verify:

            cert_loc = None

            # Allow self-specified cert location.
            if verify is not True:
                cert_loc = verify

            if not cert_loc:
                cert_loc = extract_zipped_paths(DEFAULT_CA_BUNDLE_PATH)

            if not cert_loc or not os.path.exists(cert_loc):
                raise IOError("Could not find a suitable TLS CA certificate bundle, "
                              "invalid path: {}".format(cert_loc))

            conn.cert_reqs = 'CERT_REQUIRED'

            if not os.path.isdir(cert_loc):
                conn.ca_certs = cert_loc
            else:
                conn.ca_cert_dir = cert_loc
        else:
            conn.cert_reqs = 'CERT_NONE'
            conn.ca_certs = None
            conn.ca_cert_dir = None

        if cert:
            if not isinstance(cert, basestring):
                conn.cert_file = cert[0]
                conn.key_file = cert[1]
            else:
                conn.cert_file = cert
                conn.key_file = None
            if conn.cert_file and not os.path.exists(conn.cert_file):
                raise IOError("Could not find the TLS certificate file, "
                              "invalid path: {}".format(conn.cert_file))
            if conn.key_file and not os.path.exists(conn.key_file):
                raise IOError("Could not find the TLS key file, "
                              "invalid path: {}".format(conn.key_file))

    def build_response(self, req, resp):
        """Builds a :class:`Response <requests.Response>` object from a urllib3
        response. This should not be called from user code, and is only exposed
        for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`

        :param req: The :class:`PreparedRequest <PreparedRequest>` used to generate the response.
        :param resp: The urllib3 response object.
        :rtype: requests.Response
        """
        response = Response()

        # Fallback to None if there's no status_code, for whatever reason.
        response.status_code = getattr(resp, 'status', None)

        # Make headers case-insensitive.
        response.headers = CaseInsensitiveDict(getattr(resp, 'headers', {}))

        # Set encoding.
        response.encoding = get_encoding_from_headers(response.headers)
        response.raw = resp
        response.reason = response.raw.reason

        if isinstance(req.url, bytes):
            response.url = req.url.decode('utf-8')
        else:
            response.url = req.url

        # Add new cookies from the server.
        extract_cookies_to_jar(response.cookies, req, resp)

        # Give the Response some context.
        response.request = req
        response.connection = self

        return response

    def get_connection(self, url, proxies=None):
        """Returns a urllib3 connection for the given URL. This should not be
        called from user code, and is only exposed for use when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param url: The URL to connect to.
        :param proxies: (optional) A Requests-style dictionary of proxies used on this request.
        :rtype: urllib3.ConnectionPool
        """
        proxy = select_proxy(url, proxies)

        if proxy:
            proxy = prepend_scheme_if_needed(proxy, 'http')
            proxy_url = parse_url(proxy)
            if not proxy_url.host:
                raise InvalidProxyURL("Please check proxy URL. It is malformed"
                                      " and could be missing the host.")
            proxy_manager = self.proxy_manager_for(proxy)
            conn = proxy_manager.connection_from_url(url)
        else:
            # Only scheme should be lower case
            parsed = urlparse(url)
            url = parsed.geturl()
            conn = self.poolmanager.connection_from_url(url)

        return conn

    def close(self):
        """Disposes of any internal state.

        Currently, this closes the PoolManager and any active ProxyManager,
        which closes any pooled connections.
        """
        self.poolmanager.clear()
        for proxy in self.proxy_manager.values():
            proxy.clear()

    def request_url(self, request, proxies):
        """Obtain the url to use when making the final request.

        If the message is being sent through a HTTP proxy, the full URL has to
        be used. Otherwise, we should only use the path portion of the URL.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs.
        :rtype: str
        """
        proxy = select_proxy(request.url, proxies)
        scheme = urlparse(request.url).scheme

        is_proxied_http_request = (proxy and scheme != 'https')
        using_socks_proxy = False
        if proxy:
            proxy_scheme = urlparse(proxy).scheme.lower()
            using_socks_proxy = proxy_scheme.startswith('socks')

        url = request.path_url
        if is_proxied_http_request and not using_socks_proxy:
            url = urldefragauth(request.url)

        return url

    def add_headers(self, request, **kwargs):
        """Add any headers needed by the connection. As of v2.0 this does
        nothing by default, but is left for overriding by users that subclass
        the :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param request: The :class:`PreparedRequest <PreparedRequest>` to add headers to.
        :param kwargs: The keyword arguments from the call to send().
        """
        pass

    def proxy_headers(self, proxy):
        """Returns a dictionary of the headers to add to any request sent
        through a proxy. This works with urllib3 magic to ensure that they are
        correctly sent to the proxy, rather than in a tunnelled request if
        CONNECT is being used.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param proxy: The url of the proxy being used for this request.
        :rtype: dict
        """
        headers = {}
        username, password = get_auth_from_url(proxy)

        if username:
            headers['Proxy-Authorization'] = _basic_auth_str(username,
                                                             password)

        return headers

    def send(self, request, stream=False, timeout=None, verify=True, cert=None, proxies=None):
        """Sends PreparedRequest object. Returns Response object.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param stream: (optional) Whether to stream the request content.
        :param timeout: (optional) How long to wait for the server to send
            data before giving up, as a float, or a :ref:`(connect timeout,
            read timeout) <timeouts>` tuple.
        :type timeout: float or tuple or urllib3 Timeout object
        :param verify: (optional) Either a boolean, in which case it controls whether
            we verify the server's TLS certificate, or a string, in which case it
            must be a path to a CA bundle to use
        :param cert: (optional) Any user-provided SSL certificate to be trusted.
        :param proxies: (optional) The proxies dictionary to apply to the request.
        :rtype: requests.Response
        """

        try:
            conn = self.get_connection(request.url, proxies)
        except LocationValueError as e:
            raise InvalidURL(e, request=request)

        self.cert_verify(conn, request.url, verify, cert)
        url = self.request_url(request, proxies)
        self.add_headers(request, stream=stream, timeout=timeout, verify=verify, cert=cert, proxies=proxies)

        chunked = not (request.body is None or 'Content-Length' in request.headers)

        if isinstance(timeout, tuple):
            try:
                connect, read = timeout
                timeout = TimeoutSauce(connect=connect, read=read)
            except ValueError as e:
                # this may raise a string formatting error.
                err = ("Invalid timeout {}. Pass a (connect, read) "
                       "timeout tuple, or a single float to set "
                       "both timeouts to the same value".format(timeout))
                raise ValueError(err)
        elif isinstance(timeout, TimeoutSauce):
            pass
        else:
            timeout = TimeoutSauce(connect=timeout, read=timeout)

        try:
            if not chunked:
                resp = conn.urlopen(
                    method=request.method,
                    url=url,
                    body=request.body,
                    headers=request.headers,
                    redirect=False,
                    assert_same_host=False,
                    preload_content=False,
                    decode_content=False,
                    retries=self.max_retries,
                    timeout=timeout
                )

            # Send the request.
            else:
                if hasattr(conn, 'proxy_pool'):
                    conn = conn.proxy_pool

                low_conn = conn._get_conn(timeout=DEFAULT_POOL_TIMEOUT)

                try:
                    low_conn.putrequest(request.method,
                                        url,
                                        skip_accept_encoding=True)

                    for header, value in request.headers.items():
                        low_conn.putheader(header, value)

                    low_conn.endheaders()

                    for i in request.body:
                        low_conn.send(hex(len(i))[2:].encode('utf-8'))
                        low_conn.send(b'\r\n')
                        low_conn.send(i)
                        low_conn.send(b'\r\n')
                    low_conn.send(b'0\r\n\r\n')

                    # Receive the response from the server
                    try:
                        # For Python 2.7, use buffering of HTTP responses
                        r = low_conn.getresponse(buffering=True)
                    except TypeError:
                        # For compatibility with Python 3.3+
                        r = low_conn.getresponse()

                    resp = HTTPResponse.from_httplib(
                        r,
                        pool=conn,
                        connection=low_conn,
                        preload_content=False,
                        decode_content=False
                    )
                except:
                    # If we hit any problems here, clean up the connection.
                    # Then, reraise so that we can handle the actual exception.
                    low_conn.close()
                    raise

        except (ProtocolError, socket.error) as err:
            raise ConnectionError(err, request=request)

        except MaxRetryError as e:
            if isinstance(e.reason, ConnectTimeoutError):
                # TODO: Remove this in 3.0.0: see #2811
                if not isinstance(e.reason, NewConnectionError):
                    raise ConnectTimeout(e, request=request)

            if isinstance(e.reason, ResponseError):
                raise RetryError(e, request=request)

            if isinstance(e.reason, _ProxyError):
                raise ProxyError(e, request=request)

            if isinstance(e.reason, _SSLError):
                # This branch is for urllib3 v1.22 and later.
                raise SSLError(e, request=request)

            raise ConnectionError(e, request=request)

        except ClosedPoolError as e:
            raise ConnectionError(e, request=request)

        except _ProxyError as e:
            raise ProxyError(e)

        except (_SSLError, _HTTPError) as e:
            if isinstance(e, _SSLError):
                # This branch is for urllib3 versions earlier than v1.22
                raise SSLError(e, request=request)
            elif isinstance(e, ReadTimeoutError):
                raise ReadTimeout(e, request=request)
            else:
                raise

        return self.build_response(request, resp)
site-packages/pip/_vendor/requests/api.py000064400000014177151446177000014525 0ustar00# -*- coding: utf-8 -*-

"""
requests.api
~~~~~~~~~~~~

This module implements the Requests API.

:copyright: (c) 2012 by Kenneth Reitz.
:license: Apache2, see LICENSE for more details.
"""

from . import sessions


def request(method, url, **kwargs):
    """Constructs and sends a :class:`Request <Request>`.

    :param method: method for the new :class:`Request` object.
    :param url: URL for the new :class:`Request` object.
    :param params: (optional) Dictionary, list of tuples or bytes to send
        in the query string for the :class:`Request`.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
    :param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`.
    :param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`.
    :param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload.
        ``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')``
        or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content-type'`` is a string
        defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers
        to add for the file.
    :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
    :param timeout: (optional) How many seconds to wait for the server to send data
        before giving up, as a float, or a :ref:`(connect timeout, read
        timeout) <timeouts>` tuple.
    :type timeout: float or tuple
    :param allow_redirects: (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to ``True``.
    :type allow_redirects: bool
    :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy.
    :param verify: (optional) Either a boolean, in which case it controls whether we verify
            the server's TLS certificate, or a string, in which case it must be a path
            to a CA bundle to use. Defaults to ``True``.
    :param stream: (optional) if ``False``, the response content will be immediately downloaded.
    :param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response

    Usage::

      >>> import requests
      >>> req = requests.request('GET', 'https://httpbin.org/get')
      <Response [200]>
    """

    # By using the 'with' statement we are sure the session is closed, thus we
    # avoid leaving sockets open which can trigger a ResourceWarning in some
    # cases, and look like a memory leak in others.
    with sessions.Session() as session:
        return session.request(method=method, url=url, **kwargs)


def get(url, params=None, **kwargs):
    r"""Sends a GET request.

    :param url: URL for the new :class:`Request` object.
    :param params: (optional) Dictionary, list of tuples or bytes to send
        in the query string for the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    kwargs.setdefault('allow_redirects', True)
    return request('get', url, params=params, **kwargs)


def options(url, **kwargs):
    r"""Sends an OPTIONS request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    kwargs.setdefault('allow_redirects', True)
    return request('options', url, **kwargs)


def head(url, **kwargs):
    r"""Sends a HEAD request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    kwargs.setdefault('allow_redirects', False)
    return request('head', url, **kwargs)


def post(url, data=None, json=None, **kwargs):
    r"""Sends a POST request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    return request('post', url, data=data, json=json, **kwargs)


def put(url, data=None, **kwargs):
    r"""Sends a PUT request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    return request('put', url, data=data, **kwargs)


def patch(url, data=None, **kwargs):
    r"""Sends a PATCH request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    return request('patch', url, data=data, **kwargs)


def delete(url, **kwargs):
    r"""Sends a DELETE request.

    :param url: URL for the new :class:`Request` object.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    return request('delete', url, **kwargs)
site-packages/pip/_vendor/requests/certs.py000064400000000721151446177000015062 0ustar00#!/usr/bin/env python
# -*- coding: utf-8 -*-

"""
requests.certs
~~~~~~~~~~~~~~

This module returns the preferred default CA certificate bundle. There is
only one — the one from the certifi package.

If you are packaging Requests, e.g., for a Linux distribution or a managed
environment, you can change the definition of where() to return a separately
packaged CA bundle.
"""
from pip._vendor.certifi import where

if __name__ == '__main__':
    print(where())
site-packages/pip/_vendor/progress/__pycache__/__init__.cpython-38.opt-1.pyc000064400000012715151446177000022725 0ustar00U

��.e��@s�ddlmZmZddlmZddlmZddlmZddl	m
Z
zddlmZWn e
k
rpddlmZYnXdZd	Zd
ZGdd�de�ZGd
d�de�ZdS)�)�division�print_function)�deque)�	timedelta)�ceil)�stderr)�	monotonic)�timez1.5z[?25lz[?25hc@s�eZdZeZdZdZdZd&dd�Zdd�Z	e
dd	��Ze
d
d��Zdd
�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd'dd�Zdd �Zd!d"�Zd#d$�Zd%S)(�Infinite�
T�cKs�d|_t�|_d|_|j|_|j|_t|jd�|_|�	�D]\}}t
|||�q:d|_||_|j
r�|��r�|jr�ttd|j
d�t|jd|j
d�|j
��dS)Nr)�maxlenr��end�file)�indexr�start_ts�avg�_avg_update_ts�_tsr�
sma_window�_xput�items�setattr�_width�messager�is_tty�hide_cursor�print�HIDE_CURSOR�flush)�selfr�kwargs�key�val�r%�A/usr/lib/python3.8/site-packages/pip/_vendor/progress/__init__.py�__init__'szInfinite.__init__cCs|�d�rdSt||d�S)N�_)�
startswith�getattr)r!r#r%r%r&�__getitem__:s
zInfinite.__getitem__cCstt�|j�S�N)�intrr�r!r%r%r&�elapsed?szInfinite.elapsedcCst|jd�S�N)Zseconds)rr/r.r%r%r&�
elapsed_tdCszInfinite.elapsed_tdcCs`|dkr\t|j�}|j�||�t�}||jks@||jdkr\t|j�t|j�|_||_dS)Nr�)�lenr�appendrrr�sumr)r!�n�dtZxput_len�nowr%r%r&�
update_avgGs

�zInfinite.update_avgcCsdSr,r%r.r%r%r&�updateRszInfinite.updatecCsdSr,r%r.r%r%r&�startUszInfinite.startcCs"|jr|��rtdd|jd�dS)Nz
rr)rrrr.r%r%r&�clearlnXszInfinite.clearlncCsT|jrP|��rP|j|�|j�}td|d|jd�t|jt|��|_|j��dS)N�
rr)	rrr�ljustrr�maxr3r )r!�s�liner%r%r&�write\s
zInfinite.writecCs4|jr0|��r0|��t|d|jd�|j��dS)Nrr)rrr<rr )r!rAr%r%r&�writelncszInfinite.writelncCs4|jr0|��r0t|jd�|jr0ttd|jd�dS)N)rrr)rrrr�SHOW_CURSORr.r%r%r&�finishiszInfinite.finishcCs|jr|j��SdS)NT)�	check_ttyr�isattyr.r%r%r&roszInfinite.is_ttyr2cCs:t�}||j}|�||�||_|j||_|��dSr,)rrr9rr:)r!r6r8r7r%r%r&�nextrs
z
Infinite.nextc	cs,|�|D]}|V|��q
W5QRXdSr,)rH�r!�it�xr%r%r&�iterzsz
Infinite.itercCs|��|Sr,)r;r.r%r%r&�	__enter__�szInfinite.__enter__cCs|��dSr,)rE)r!�exc_typeZexc_valZexc_tbr%r%r&�__exit__�szInfinite.__exit__N)r)r2)�__name__�
__module__�__qualname__rrrrFrr'r+�propertyr/r1r9r:r;r<rBrCrErrHrLrMrOr%r%r%r&r
!s,



r
cspeZdZ�fdd�Zedd��Zedd��Zedd��Zed	d
��Zedd��Z	d
d�Z
dd�Zdd�Z�Z
S)�Progresscs$tt|�j||�|�dd�|_dS)Nr?�d)�superrTr'�getr?)r!�argsr"��	__class__r%r&r'�szProgress.__init__cCstt|j|j��Sr,)r-rr�	remainingr.r%r%r&�eta�szProgress.etacCst|jd�Sr0)rr\r.r%r%r&�eta_td�szProgress.eta_tdcCs
|jdS)NrU)�progressr.r%r%r&�percent�szProgress.percentcCstd|j|j�S)Nr2)�minrr?r.r%r%r&r^�szProgress.progresscCst|j|jd�S)Nr)r?rr.r%r%r&r[�szProgress.remainingcCs|��dSr,)r:r.r%r%r&r;�szProgress.startcCs||j}|�|�dSr,)rrH)r!rZincrr%r%r&�goto�s
z
Progress.gotoc	csPzt|�|_Wntk
r"YnX|�|D]}|V|��q.W5QRXdSr,)r3r?�	TypeErrorrHrIr%r%r&rL�sz
Progress.iter)rPrQrRr'rSr\r]r_r^r[r;rarL�
__classcell__r%r%rYr&rT�s




rTN)Z
__future__rr�collectionsrZdatetimerZmathr�sysrr	r�ImportError�__version__rrD�objectr
rTr%r%r%r&�<module>sgsite-packages/pip/_vendor/progress/__pycache__/spinner.cpython-38.opt-1.pyc000064400000002524151446177000022641 0ustar00U

��.ed�@slddlmZddlmZGdd�de�ZGdd�de�ZGdd	�d	e�ZGd
d�de�ZGdd
�d
e�ZdS)�)�unicode_literals�)�Infinitec@seZdZdZdZdd�ZdS)�Spinner)�-�\�|�/TcCs$|jt|j�}|�|j|�dS)N)�index�len�phases�write)�self�i�r�@/usr/lib/python3.8/site-packages/pip/_vendor/progress/spinner.py�updateszSpinner.updateN)�__name__�
__module__�__qualname__rZhide_cursorrrrrrrsrc@seZdZddddgZdS)�
PieSpinneru◷u◶u◵u◴N�rrrrrrrrrsrc@seZdZddddgZdS)�MoonSpinneru◑u◒u◐u◓Nrrrrrr"src@seZdZddddddgZdS)�LineSpinneru⎺u⎻u⎼u⎽Nrrrrrr&src@s eZdZddddddddgZd	S)
�PixelSpinneru⣾u⣷u⣯u⣟u⡿u⢿u⣻u⣽Nrrrrrr*srN)	Z
__future__r�rrrrrrrrrr�<module>s	site-packages/pip/_vendor/progress/__pycache__/bar.cpython-38.pyc000064400000005055151446177000020772 0ustar00U

��.e&�@s�ddlmZddlZddlmZGdd�de�ZGdd�de�ZGd	d
�d
e�ZGdd�de�ZGd
d�de�Z	Gdd�de	�Z
Gdd�de	�ZdS)�)�unicode_literalsN�)�Progressc@s,eZdZdZdZdZdZdZdZdd�Z	d	S)
�Bar� z%(index)d/%(max)dz |z| � �#cCsjt|j|j�}|j|}|j|}|j|}|j|}|j|}d�||j|||j	|g�}|�
|�dS)N�)�int�width�progress�message�fill�
empty_fill�suffix�join�
bar_prefix�
bar_suffix�writeln)�selfZ
filled_lengthZempty_lengthr
�bar�emptyr�line�r�</usr/lib/python3.8/site-packages/pip/_vendor/progress/bar.py�update s




�z
Bar.updateN)
�__name__�
__module__�__qualname__rrrrrrrrrrrrsrc@s eZdZdZdZdZdZdZdS)�ChargingBarz
%(percent)d%%ru∙�█N)rrrrrrrrrrrrr-s
rc@seZdZdZdZdS)�FillingSquaresBaru▢u▣N�rrrrrrrrrr!5sr!c@seZdZdZdZdS)�FillingCirclesBaru◯u◉Nr"rrrrr#:sr#c@s*eZdZej�d�rdZndZdd�ZdS)�IncrementalBar�win)r�▌r )	ru▏u▎u▍r&u▋u▊u▉r c	Cs�t|j�}|j|j}t|�}t|||�}|j|}|j|}|jd|}|dkrb|j|nd}|jtd|t|��}	|j|}
d�	||j
|||	|j|
g�}|�|�dS)N���rr	)
�len�phasesrrr
r
r�maxrrrrr)rZnphasesZ
filled_lenZnfullZphaseZnemptyr
rZcurrentrrrrrrrEs



�zIncrementalBar.updateN)rrr�sys�platform�
startswithr)rrrrrr$?sr$c@seZdZdZdS)�PixelBar)u⡀u⡄u⡆u⡇u⣇u⣧u⣷u⣿N�rrrr)rrrrr.Vsr.c@seZdZdZdS)�ShadyBar)ru░u▒u▓r Nr/rrrrr0Zsr0)Z
__future__rr+r	rrrr!r#r$r.r0rrrr�<module>ssite-packages/pip/_vendor/progress/__pycache__/counter.cpython-38.opt-1.pyc000064400000002635151446177000022645 0ustar00U

��.e\�@s`ddlmZddlmZmZGdd�de�ZGdd�de�ZGdd	�d	e�ZGd
d�de�ZdS)
�)�unicode_literals�)�Infinite�Progressc@seZdZdd�ZdS)�CountercCs|�t|j��dS�N)�write�str�index��self�r
�@/usr/lib/python3.8/site-packages/pip/_vendor/progress/counter.py�updateszCounter.updateN��__name__�
__module__�__qualname__rr
r
r
rrsrc@seZdZdd�ZdS)�	CountdowncCs|�t|j��dSr)rr	Z	remainingrr
r
rrszCountdown.updateNrr
r
r
rrsrc@seZdZdZdd�ZdS)�Stack)	� u▁u▂u▃u▄u▅u▆u▇u█cCs6t|j�}t|dt|j|��}|�|j|�dS)Nr)�len�phases�min�intZprogressr)rZnphases�ir
r
rr"s
zStack.updateN)rrrrrr
r
r
rrsrc@seZdZdZdS)�Pie)u○u◔u◑u◕u●N)rrrrr
r
r
rr(srN)	Z
__future__r�rrrrrrr
r
r
r�<module>s
	site-packages/pip/_vendor/progress/__pycache__/bar.cpython-38.opt-1.pyc000064400000005055151446177000021731 0ustar00U

��.e&�@s�ddlmZddlZddlmZGdd�de�ZGdd�de�ZGd	d
�d
e�ZGdd�de�ZGd
d�de�Z	Gdd�de	�Z
Gdd�de	�ZdS)�)�unicode_literalsN�)�Progressc@s,eZdZdZdZdZdZdZdZdd�Z	d	S)
�Bar� z%(index)d/%(max)dz |z| � �#cCsjt|j|j�}|j|}|j|}|j|}|j|}|j|}d�||j|||j	|g�}|�
|�dS)N�)�int�width�progress�message�fill�
empty_fill�suffix�join�
bar_prefix�
bar_suffix�writeln)�selfZ
filled_lengthZempty_lengthr
�bar�emptyr�line�r�</usr/lib/python3.8/site-packages/pip/_vendor/progress/bar.py�update s




�z
Bar.updateN)
�__name__�
__module__�__qualname__rrrrrrrrrrrrsrc@s eZdZdZdZdZdZdZdS)�ChargingBarz
%(percent)d%%ru∙�█N)rrrrrrrrrrrrr-s
rc@seZdZdZdZdS)�FillingSquaresBaru▢u▣N�rrrrrrrrrr!5sr!c@seZdZdZdZdS)�FillingCirclesBaru◯u◉Nr"rrrrr#:sr#c@s*eZdZej�d�rdZndZdd�ZdS)�IncrementalBar�win)r�▌r )	ru▏u▎u▍r&u▋u▊u▉r c	Cs�t|j�}|j|j}t|�}t|||�}|j|}|j|}|jd|}|dkrb|j|nd}|jtd|t|��}	|j|}
d�	||j
|||	|j|
g�}|�|�dS)N���rr	)
�len�phasesrrr
r
r�maxrrrrr)rZnphasesZ
filled_lenZnfullZphaseZnemptyr
rZcurrentrrrrrrrEs



�zIncrementalBar.updateN)rrr�sys�platform�
startswithr)rrrrrr$?sr$c@seZdZdZdS)�PixelBar)u⡀u⡄u⡆u⡇u⣇u⣧u⣷u⣿N�rrrr)rrrrr.Vsr.c@seZdZdZdS)�ShadyBar)ru░u▒u▓r Nr/rrrrr0Zsr0)Z
__future__rr+r	rrrr!r#r$r.r0rrrr�<module>ssite-packages/pip/_vendor/progress/__pycache__/counter.cpython-38.pyc000064400000002635151446177000021706 0ustar00U

��.e\�@s`ddlmZddlmZmZGdd�de�ZGdd�de�ZGdd	�d	e�ZGd
d�de�ZdS)
�)�unicode_literals�)�Infinite�Progressc@seZdZdd�ZdS)�CountercCs|�t|j��dS�N)�write�str�index��self�r
�@/usr/lib/python3.8/site-packages/pip/_vendor/progress/counter.py�updateszCounter.updateN��__name__�
__module__�__qualname__rr
r
r
rrsrc@seZdZdd�ZdS)�	CountdowncCs|�t|j��dSr)rr	Z	remainingrr
r
rrszCountdown.updateNrr
r
r
rrsrc@seZdZdZdd�ZdS)�Stack)	� u▁u▂u▃u▄u▅u▆u▇u█cCs6t|j�}t|dt|j|��}|�|j|�dS)Nr)�len�phases�min�intZprogressr)rZnphases�ir
r
rr"s
zStack.updateN)rrrrrr
r
r
rrsrc@seZdZdZdS)�Pie)u○u◔u◑u◕u●N)rrrrr
r
r
rr(srN)	Z
__future__r�rrrrrrr
r
r
r�<module>s
	site-packages/pip/_vendor/progress/__pycache__/spinner.cpython-38.pyc000064400000002524151446177000021702 0ustar00U

��.ed�@slddlmZddlmZGdd�de�ZGdd�de�ZGdd	�d	e�ZGd
d�de�ZGdd
�d
e�ZdS)�)�unicode_literals�)�Infinitec@seZdZdZdZdd�ZdS)�Spinner)�-�\�|�/TcCs$|jt|j�}|�|j|�dS)N)�index�len�phases�write)�self�i�r�@/usr/lib/python3.8/site-packages/pip/_vendor/progress/spinner.py�updateszSpinner.updateN)�__name__�
__module__�__qualname__rZhide_cursorrrrrrrsrc@seZdZddddgZdS)�
PieSpinneru◷u◶u◵u◴N�rrrrrrrrrsrc@seZdZddddgZdS)�MoonSpinneru◑u◒u◐u◓Nrrrrrr"src@seZdZddddddgZdS)�LineSpinneru⎺u⎻u⎼u⎽Nrrrrrr&src@s eZdZddddddddgZd	S)
�PixelSpinneru⣾u⣷u⣯u⣟u⡿u⢿u⣻u⣽Nrrrrrr*srN)	Z
__future__r�rrrrrrrrrr�<module>s	site-packages/pip/_vendor/progress/__pycache__/__init__.cpython-38.pyc000064400000012715151446177000021766 0ustar00U

��.e��@s�ddlmZmZddlmZddlmZddlmZddl	m
Z
zddlmZWn e
k
rpddlmZYnXdZd	Zd
ZGdd�de�ZGd
d�de�ZdS)�)�division�print_function)�deque)�	timedelta)�ceil)�stderr)�	monotonic)�timez1.5z[?25lz[?25hc@s�eZdZeZdZdZdZd&dd�Zdd�Z	e
dd	��Ze
d
d��Zdd
�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd'dd�Zdd �Zd!d"�Zd#d$�Zd%S)(�Infinite�
T�cKs�d|_t�|_d|_|j|_|j|_t|jd�|_|�	�D]\}}t
|||�q:d|_||_|j
r�|��r�|jr�ttd|j
d�t|jd|j
d�|j
��dS)Nr)�maxlenr��end�file)�indexr�start_ts�avg�_avg_update_ts�_tsr�
sma_window�_xput�items�setattr�_width�messager�is_tty�hide_cursor�print�HIDE_CURSOR�flush)�selfr�kwargs�key�val�r%�A/usr/lib/python3.8/site-packages/pip/_vendor/progress/__init__.py�__init__'szInfinite.__init__cCs|�d�rdSt||d�S)N�_)�
startswith�getattr)r!r#r%r%r&�__getitem__:s
zInfinite.__getitem__cCstt�|j�S�N)�intrr�r!r%r%r&�elapsed?szInfinite.elapsedcCst|jd�S�N)Zseconds)rr/r.r%r%r&�
elapsed_tdCszInfinite.elapsed_tdcCs`|dkr\t|j�}|j�||�t�}||jks@||jdkr\t|j�t|j�|_||_dS)Nr�)�lenr�appendrrr�sumr)r!�n�dtZxput_len�nowr%r%r&�
update_avgGs

�zInfinite.update_avgcCsdSr,r%r.r%r%r&�updateRszInfinite.updatecCsdSr,r%r.r%r%r&�startUszInfinite.startcCs"|jr|��rtdd|jd�dS)Nz
rr)rrrr.r%r%r&�clearlnXszInfinite.clearlncCsT|jrP|��rP|j|�|j�}td|d|jd�t|jt|��|_|j��dS)N�
rr)	rrr�ljustrr�maxr3r )r!�s�liner%r%r&�write\s
zInfinite.writecCs4|jr0|��r0|��t|d|jd�|j��dS)Nrr)rrr<rr )r!rAr%r%r&�writelncszInfinite.writelncCs4|jr0|��r0t|jd�|jr0ttd|jd�dS)N)rrr)rrrr�SHOW_CURSORr.r%r%r&�finishiszInfinite.finishcCs|jr|j��SdS)NT)�	check_ttyr�isattyr.r%r%r&roszInfinite.is_ttyr2cCs:t�}||j}|�||�||_|j||_|��dSr,)rrr9rr:)r!r6r8r7r%r%r&�nextrs
z
Infinite.nextc	cs,|�|D]}|V|��q
W5QRXdSr,)rH�r!�it�xr%r%r&�iterzsz
Infinite.itercCs|��|Sr,)r;r.r%r%r&�	__enter__�szInfinite.__enter__cCs|��dSr,)rE)r!�exc_typeZexc_valZexc_tbr%r%r&�__exit__�szInfinite.__exit__N)r)r2)�__name__�
__module__�__qualname__rrrrFrr'r+�propertyr/r1r9r:r;r<rBrCrErrHrLrMrOr%r%r%r&r
!s,



r
cspeZdZ�fdd�Zedd��Zedd��Zedd��Zed	d
��Zedd��Z	d
d�Z
dd�Zdd�Z�Z
S)�Progresscs$tt|�j||�|�dd�|_dS)Nr?�d)�superrTr'�getr?)r!�argsr"��	__class__r%r&r'�szProgress.__init__cCstt|j|j��Sr,)r-rr�	remainingr.r%r%r&�eta�szProgress.etacCst|jd�Sr0)rr\r.r%r%r&�eta_td�szProgress.eta_tdcCs
|jdS)NrU)�progressr.r%r%r&�percent�szProgress.percentcCstd|j|j�S)Nr2)�minrr?r.r%r%r&r^�szProgress.progresscCst|j|jd�S)Nr)r?rr.r%r%r&r[�szProgress.remainingcCs|��dSr,)r:r.r%r%r&r;�szProgress.startcCs||j}|�|�dSr,)rrH)r!rZincrr%r%r&�goto�s
z
Progress.gotoc	csPzt|�|_Wntk
r"YnX|�|D]}|V|��q.W5QRXdSr,)r3r?�	TypeErrorrHrIr%r%r&rL�sz
Progress.iter)rPrQrRr'rSr\r]r_r^r[r;rarL�
__classcell__r%r%rYr&rT�s




rTN)Z
__future__rr�collectionsrZdatetimerZmathr�sysrr	r�ImportError�__version__rrD�objectr
rTr%r%r%r&�<module>sgsite-packages/pip/_vendor/progress/__init__.py000064400000011371151446177000015475 0ustar00# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
#
# Permission to use, copy, modify, and distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, 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.

from __future__ import division, print_function

from collections import deque
from datetime import timedelta
from math import ceil
from sys import stderr
try:
    from time import monotonic
except ImportError:
    from time import time as monotonic


__version__ = '1.5'

HIDE_CURSOR = '\x1b[?25l'
SHOW_CURSOR = '\x1b[?25h'


class Infinite(object):
    file = stderr
    sma_window = 10         # Simple Moving Average window
    check_tty = True
    hide_cursor = True

    def __init__(self, message='', **kwargs):
        self.index = 0
        self.start_ts = monotonic()
        self.avg = 0
        self._avg_update_ts = self.start_ts
        self._ts = self.start_ts
        self._xput = deque(maxlen=self.sma_window)
        for key, val in kwargs.items():
            setattr(self, key, val)

        self._width = 0
        self.message = message

        if self.file and self.is_tty():
            if self.hide_cursor:
                print(HIDE_CURSOR, end='', file=self.file)
            print(self.message, end='', file=self.file)
            self.file.flush()

    def __getitem__(self, key):
        if key.startswith('_'):
            return None
        return getattr(self, key, None)

    @property
    def elapsed(self):
        return int(monotonic() - self.start_ts)

    @property
    def elapsed_td(self):
        return timedelta(seconds=self.elapsed)

    def update_avg(self, n, dt):
        if n > 0:
            xput_len = len(self._xput)
            self._xput.append(dt / n)
            now = monotonic()
            # update when we're still filling _xput, then after every second
            if (xput_len < self.sma_window or
                    now - self._avg_update_ts > 1):
                self.avg = sum(self._xput) / len(self._xput)
                self._avg_update_ts = now

    def update(self):
        pass

    def start(self):
        pass

    def clearln(self):
        if self.file and self.is_tty():
            print('\r\x1b[K', end='', file=self.file)

    def write(self, s):
        if self.file and self.is_tty():
            line = self.message + s.ljust(self._width)
            print('\r' + line, end='', file=self.file)
            self._width = max(self._width, len(s))
            self.file.flush()

    def writeln(self, line):
        if self.file and self.is_tty():
            self.clearln()
            print(line, end='', file=self.file)
            self.file.flush()

    def finish(self):
        if self.file and self.is_tty():
            print(file=self.file)
            if self.hide_cursor:
                print(SHOW_CURSOR, end='', file=self.file)

    def is_tty(self):
        return self.file.isatty() if self.check_tty else True

    def next(self, n=1):
        now = monotonic()
        dt = now - self._ts
        self.update_avg(n, dt)
        self._ts = now
        self.index = self.index + n
        self.update()

    def iter(self, it):
        with self:
            for x in it:
                yield x
                self.next()

    def __enter__(self):
        self.start()
        return self

    def __exit__(self, exc_type, exc_val, exc_tb):
        self.finish()


class Progress(Infinite):
    def __init__(self, *args, **kwargs):
        super(Progress, self).__init__(*args, **kwargs)
        self.max = kwargs.get('max', 100)

    @property
    def eta(self):
        return int(ceil(self.avg * self.remaining))

    @property
    def eta_td(self):
        return timedelta(seconds=self.eta)

    @property
    def percent(self):
        return self.progress * 100

    @property
    def progress(self):
        return min(1, self.index / self.max)

    @property
    def remaining(self):
        return max(self.max - self.index, 0)

    def start(self):
        self.update()

    def goto(self, index):
        incr = index - self.index
        self.next(incr)

    def iter(self, it):
        try:
            self.max = len(it)
        except TypeError:
            pass

        with self:
            for x in it:
                yield x
                self.next()
site-packages/pip/_vendor/progress/bar.py000064400000005446151446177000014510 0ustar00# -*- coding: utf-8 -*-

# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
#
# Permission to use, copy, modify, and distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, 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.

from __future__ import unicode_literals

import sys

from . import Progress


class Bar(Progress):
    width = 32
    suffix = '%(index)d/%(max)d'
    bar_prefix = ' |'
    bar_suffix = '| '
    empty_fill = ' '
    fill = '#'

    def update(self):
        filled_length = int(self.width * self.progress)
        empty_length = self.width - filled_length

        message = self.message % self
        bar = self.fill * filled_length
        empty = self.empty_fill * empty_length
        suffix = self.suffix % self
        line = ''.join([message, self.bar_prefix, bar, empty, self.bar_suffix,
                        suffix])
        self.writeln(line)


class ChargingBar(Bar):
    suffix = '%(percent)d%%'
    bar_prefix = ' '
    bar_suffix = ' '
    empty_fill = '∙'
    fill = '█'


class FillingSquaresBar(ChargingBar):
    empty_fill = '▢'
    fill = '▣'


class FillingCirclesBar(ChargingBar):
    empty_fill = '◯'
    fill = '◉'


class IncrementalBar(Bar):
    if sys.platform.startswith('win'):
        phases = (u' ', u'▌', u'█')
    else:
        phases = (' ', '▏', '▎', '▍', '▌', '▋', '▊', '▉', '█')

    def update(self):
        nphases = len(self.phases)
        filled_len = self.width * self.progress
        nfull = int(filled_len)                      # Number of full chars
        phase = int((filled_len - nfull) * nphases)  # Phase of last char
        nempty = self.width - nfull                  # Number of empty chars

        message = self.message % self
        bar = self.phases[-1] * nfull
        current = self.phases[phase] if phase > 0 else ''
        empty = self.empty_fill * max(0, nempty - len(current))
        suffix = self.suffix % self
        line = ''.join([message, self.bar_prefix, bar, current, empty,
                        self.bar_suffix, suffix])
        self.writeln(line)


class PixelBar(IncrementalBar):
    phases = ('⡀', '⡄', '⡆', '⡇', '⣇', '⣧', '⣷', '⣿')


class ShadyBar(IncrementalBar):
    phases = (' ', '░', '▒', '▓', '█')
site-packages/pip/_vendor/progress/spinner.py000064400000002544151446177000015416 0ustar00# -*- coding: utf-8 -*-

# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
#
# Permission to use, copy, modify, and distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, 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.

from __future__ import unicode_literals
from . import Infinite


class Spinner(Infinite):
    phases = ('-', '\\', '|', '/')
    hide_cursor = True

    def update(self):
        i = self.index % len(self.phases)
        self.write(self.phases[i])


class PieSpinner(Spinner):
    phases = ['◷', '◶', '◵', '◴']


class MoonSpinner(Spinner):
    phases = ['◑', '◒', '◐', '◓']


class LineSpinner(Spinner):
    phases = ['⎺', '⎻', '⎼', '⎽', '⎼', '⎻']


class PixelSpinner(Spinner):
    phases = ['⣾', '⣷', '⣯', '⣟', '⡿', '⢿', '⣻', '⣽']
site-packages/pip/_vendor/progress/counter.py000064400000002534151446177000015416 0ustar00# -*- coding: utf-8 -*-

# Copyright (c) 2012 Giorgos Verigakis <verigak@gmail.com>
#
# Permission to use, copy, modify, and distribute this software for any
# purpose with or without fee is hereby granted, provided that the above
# copyright notice and this permission notice appear in all copies.
#
# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
# ANY SPECIAL, DIRECT, 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.

from __future__ import unicode_literals
from . import Infinite, Progress


class Counter(Infinite):
    def update(self):
        self.write(str(self.index))


class Countdown(Progress):
    def update(self):
        self.write(str(self.remaining))


class Stack(Progress):
    phases = (' ', '▁', '▂', '▃', '▄', '▅', '▆', '▇', '█')

    def update(self):
        nphases = len(self.phases)
        i = min(nphases - 1, int(self.progress * nphases))
        self.write(self.phases[i])


class Pie(Stack):
    phases = ('○', '◔', '◑', '◕', '●')
site-packages/pip/_vendor/contextlib2.py000064400000041023151446177000014324 0ustar00"""contextlib2 - backports and enhancements to the contextlib module"""

import abc
import sys
import warnings
from collections import deque
from functools import wraps

__all__ = ["contextmanager", "closing", "nullcontext",
           "AbstractContextManager",
           "ContextDecorator", "ExitStack",
           "redirect_stdout", "redirect_stderr", "suppress"]

# Backwards compatibility
__all__ += ["ContextStack"]


# Backport abc.ABC
if sys.version_info[:2] >= (3, 4):
    _abc_ABC = abc.ABC
else:
    _abc_ABC = abc.ABCMeta('ABC', (object,), {'__slots__': ()})


# Backport classic class MRO
def _classic_mro(C, result):
    if C in result:
        return
    result.append(C)
    for B in C.__bases__:
        _classic_mro(B, result)
    return result


# Backport _collections_abc._check_methods
def _check_methods(C, *methods):
    try:
        mro = C.__mro__
    except AttributeError:
        mro = tuple(_classic_mro(C, []))

    for method in methods:
        for B in mro:
            if method in B.__dict__:
                if B.__dict__[method] is None:
                    return NotImplemented
                break
        else:
            return NotImplemented
    return True


class AbstractContextManager(_abc_ABC):
    """An abstract base class for context managers."""

    def __enter__(self):
        """Return `self` upon entering the runtime context."""
        return self

    @abc.abstractmethod
    def __exit__(self, exc_type, exc_value, traceback):
        """Raise any exception triggered within the runtime context."""
        return None

    @classmethod
    def __subclasshook__(cls, C):
        """Check whether subclass is considered a subclass of this ABC."""
        if cls is AbstractContextManager:
            return _check_methods(C, "__enter__", "__exit__")
        return NotImplemented


class ContextDecorator(object):
    """A base class or mixin that enables context managers to work as decorators."""

    def refresh_cm(self):
        """Returns the context manager used to actually wrap the call to the
        decorated function.

        The default implementation just returns *self*.

        Overriding this method allows otherwise one-shot context managers
        like _GeneratorContextManager to support use as decorators via
        implicit recreation.

        DEPRECATED: refresh_cm was never added to the standard library's
                    ContextDecorator API
        """
        warnings.warn("refresh_cm was never added to the standard library",
                      DeprecationWarning)
        return self._recreate_cm()

    def _recreate_cm(self):
        """Return a recreated instance of self.

        Allows an otherwise one-shot context manager like
        _GeneratorContextManager to support use as
        a decorator via implicit recreation.

        This is a private interface just for _GeneratorContextManager.
        See issue #11647 for details.
        """
        return self

    def __call__(self, func):
        @wraps(func)
        def inner(*args, **kwds):
            with self._recreate_cm():
                return func(*args, **kwds)
        return inner


class _GeneratorContextManager(ContextDecorator):
    """Helper for @contextmanager decorator."""

    def __init__(self, func, args, kwds):
        self.gen = func(*args, **kwds)
        self.func, self.args, self.kwds = func, args, kwds
        # Issue 19330: ensure context manager instances have good docstrings
        doc = getattr(func, "__doc__", None)
        if doc is None:
            doc = type(self).__doc__
        self.__doc__ = doc
        # Unfortunately, this still doesn't provide good help output when
        # inspecting the created context manager instances, since pydoc
        # currently bypasses the instance docstring and shows the docstring
        # for the class instead.
        # See http://bugs.python.org/issue19404 for more details.

    def _recreate_cm(self):
        # _GCM instances are one-shot context managers, so the
        # CM must be recreated each time a decorated function is
        # called
        return self.__class__(self.func, self.args, self.kwds)

    def __enter__(self):
        try:
            return next(self.gen)
        except StopIteration:
            raise RuntimeError("generator didn't yield")

    def __exit__(self, type, value, traceback):
        if type is None:
            try:
                next(self.gen)
            except StopIteration:
                return
            else:
                raise RuntimeError("generator didn't stop")
        else:
            if value is None:
                # Need to force instantiation so we can reliably
                # tell if we get the same exception back
                value = type()
            try:
                self.gen.throw(type, value, traceback)
                raise RuntimeError("generator didn't stop after throw()")
            except StopIteration as exc:
                # Suppress StopIteration *unless* it's the same exception that
                # was passed to throw().  This prevents a StopIteration
                # raised inside the "with" statement from being suppressed.
                return exc is not value
            except RuntimeError as exc:
                # Don't re-raise the passed in exception
                if exc is value:
                    return False
                # Likewise, avoid suppressing if a StopIteration exception
                # was passed to throw() and later wrapped into a RuntimeError
                # (see PEP 479).
                if _HAVE_EXCEPTION_CHAINING and exc.__cause__ is value:
                    return False
                raise
            except:
                # only re-raise if it's *not* the exception that was
                # passed to throw(), because __exit__() must not raise
                # an exception unless __exit__() itself failed.  But throw()
                # has to raise the exception to signal propagation, so this
                # fixes the impedance mismatch between the throw() protocol
                # and the __exit__() protocol.
                #
                if sys.exc_info()[1] is not value:
                    raise


def contextmanager(func):
    """@contextmanager decorator.

    Typical usage:

        @contextmanager
        def some_generator(<arguments>):
            <setup>
            try:
                yield <value>
            finally:
                <cleanup>

    This makes this:

        with some_generator(<arguments>) as <variable>:
            <body>

    equivalent to this:

        <setup>
        try:
            <variable> = <value>
            <body>
        finally:
            <cleanup>

    """
    @wraps(func)
    def helper(*args, **kwds):
        return _GeneratorContextManager(func, args, kwds)
    return helper


class closing(object):
    """Context to automatically close something at the end of a block.

    Code like this:

        with closing(<module>.open(<arguments>)) as f:
            <block>

    is equivalent to this:

        f = <module>.open(<arguments>)
        try:
            <block>
        finally:
            f.close()

    """
    def __init__(self, thing):
        self.thing = thing

    def __enter__(self):
        return self.thing

    def __exit__(self, *exc_info):
        self.thing.close()


class _RedirectStream(object):

    _stream = None

    def __init__(self, new_target):
        self._new_target = new_target
        # We use a list of old targets to make this CM re-entrant
        self._old_targets = []

    def __enter__(self):
        self._old_targets.append(getattr(sys, self._stream))
        setattr(sys, self._stream, self._new_target)
        return self._new_target

    def __exit__(self, exctype, excinst, exctb):
        setattr(sys, self._stream, self._old_targets.pop())


class redirect_stdout(_RedirectStream):
    """Context manager for temporarily redirecting stdout to another file.

        # How to send help() to stderr
        with redirect_stdout(sys.stderr):
            help(dir)

        # How to write help() to a file
        with open('help.txt', 'w') as f:
            with redirect_stdout(f):
                help(pow)
    """

    _stream = "stdout"


class redirect_stderr(_RedirectStream):
    """Context manager for temporarily redirecting stderr to another file."""

    _stream = "stderr"


class suppress(object):
    """Context manager to suppress specified exceptions

    After the exception is suppressed, execution proceeds with the next
    statement following the with statement.

         with suppress(FileNotFoundError):
             os.remove(somefile)
         # Execution still resumes here if the file was already removed
    """

    def __init__(self, *exceptions):
        self._exceptions = exceptions

    def __enter__(self):
        pass

    def __exit__(self, exctype, excinst, exctb):
        # Unlike isinstance and issubclass, CPython exception handling
        # currently only looks at the concrete type hierarchy (ignoring
        # the instance and subclass checking hooks). While Guido considers
        # that a bug rather than a feature, it's a fairly hard one to fix
        # due to various internal implementation details. suppress provides
        # the simpler issubclass based semantics, rather than trying to
        # exactly reproduce the limitations of the CPython interpreter.
        #
        # See http://bugs.python.org/issue12029 for more details
        return exctype is not None and issubclass(exctype, self._exceptions)


# Context manipulation is Python 3 only
_HAVE_EXCEPTION_CHAINING = sys.version_info[0] >= 3
if _HAVE_EXCEPTION_CHAINING:
    def _make_context_fixer(frame_exc):
        def _fix_exception_context(new_exc, old_exc):
            # Context may not be correct, so find the end of the chain
            while 1:
                exc_context = new_exc.__context__
                if exc_context is old_exc:
                    # Context is already set correctly (see issue 20317)
                    return
                if exc_context is None or exc_context is frame_exc:
                    break
                new_exc = exc_context
            # Change the end of the chain to point to the exception
            # we expect it to reference
            new_exc.__context__ = old_exc
        return _fix_exception_context

    def _reraise_with_existing_context(exc_details):
        try:
            # bare "raise exc_details[1]" replaces our carefully
            # set-up context
            fixed_ctx = exc_details[1].__context__
            raise exc_details[1]
        except BaseException:
            exc_details[1].__context__ = fixed_ctx
            raise
else:
    # No exception context in Python 2
    def _make_context_fixer(frame_exc):
        return lambda new_exc, old_exc: None

    # Use 3 argument raise in Python 2,
    # but use exec to avoid SyntaxError in Python 3
    def _reraise_with_existing_context(exc_details):
        exc_type, exc_value, exc_tb = exc_details
        exec("raise exc_type, exc_value, exc_tb")

# Handle old-style classes if they exist
try:
    from types import InstanceType
except ImportError:
    # Python 3 doesn't have old-style classes
    _get_type = type
else:
    # Need to handle old-style context managers on Python 2
    def _get_type(obj):
        obj_type = type(obj)
        if obj_type is InstanceType:
            return obj.__class__  # Old-style class
        return obj_type  # New-style class


# Inspired by discussions on http://bugs.python.org/issue13585
class ExitStack(object):
    """Context manager for dynamic management of a stack of exit callbacks

    For example:

        with ExitStack() as stack:
            files = [stack.enter_context(open(fname)) for fname in filenames]
            # All opened files will automatically be closed at the end of
            # the with statement, even if attempts to open files later
            # in the list raise an exception

    """
    def __init__(self):
        self._exit_callbacks = deque()

    def pop_all(self):
        """Preserve the context stack by transferring it to a new instance"""
        new_stack = type(self)()
        new_stack._exit_callbacks = self._exit_callbacks
        self._exit_callbacks = deque()
        return new_stack

    def _push_cm_exit(self, cm, cm_exit):
        """Helper to correctly register callbacks to __exit__ methods"""
        def _exit_wrapper(*exc_details):
            return cm_exit(cm, *exc_details)
        _exit_wrapper.__self__ = cm
        self.push(_exit_wrapper)

    def push(self, exit):
        """Registers a callback with the standard __exit__ method signature

        Can suppress exceptions the same way __exit__ methods can.

        Also accepts any object with an __exit__ method (registering a call
        to the method instead of the object itself)
        """
        # We use an unbound method rather than a bound method to follow
        # the standard lookup behaviour for special methods
        _cb_type = _get_type(exit)
        try:
            exit_method = _cb_type.__exit__
        except AttributeError:
            # Not a context manager, so assume its a callable
            self._exit_callbacks.append(exit)
        else:
            self._push_cm_exit(exit, exit_method)
        return exit # Allow use as a decorator

    def callback(self, callback, *args, **kwds):
        """Registers an arbitrary callback and arguments.

        Cannot suppress exceptions.
        """
        def _exit_wrapper(exc_type, exc, tb):
            callback(*args, **kwds)
        # We changed the signature, so using @wraps is not appropriate, but
        # setting __wrapped__ may still help with introspection
        _exit_wrapper.__wrapped__ = callback
        self.push(_exit_wrapper)
        return callback # Allow use as a decorator

    def enter_context(self, cm):
        """Enters the supplied context manager

        If successful, also pushes its __exit__ method as a callback and
        returns the result of the __enter__ method.
        """
        # We look up the special methods on the type to match the with statement
        _cm_type = _get_type(cm)
        _exit = _cm_type.__exit__
        result = _cm_type.__enter__(cm)
        self._push_cm_exit(cm, _exit)
        return result

    def close(self):
        """Immediately unwind the context stack"""
        self.__exit__(None, None, None)

    def __enter__(self):
        return self

    def __exit__(self, *exc_details):
        received_exc = exc_details[0] is not None

        # We manipulate the exception state so it behaves as though
        # we were actually nesting multiple with statements
        frame_exc = sys.exc_info()[1]
        _fix_exception_context = _make_context_fixer(frame_exc)

        # Callbacks are invoked in LIFO order to match the behaviour of
        # nested context managers
        suppressed_exc = False
        pending_raise = False
        while self._exit_callbacks:
            cb = self._exit_callbacks.pop()
            try:
                if cb(*exc_details):
                    suppressed_exc = True
                    pending_raise = False
                    exc_details = (None, None, None)
            except:
                new_exc_details = sys.exc_info()
                # simulate the stack of exceptions by setting the context
                _fix_exception_context(new_exc_details[1], exc_details[1])
                pending_raise = True
                exc_details = new_exc_details
        if pending_raise:
            _reraise_with_existing_context(exc_details)
        return received_exc and suppressed_exc


# Preserve backwards compatibility
class ContextStack(ExitStack):
    """Backwards compatibility alias for ExitStack"""

    def __init__(self):
        warnings.warn("ContextStack has been renamed to ExitStack",
                      DeprecationWarning)
        super(ContextStack, self).__init__()

    def register_exit(self, callback):
        return self.push(callback)

    def register(self, callback, *args, **kwds):
        return self.callback(callback, *args, **kwds)

    def preserve(self):
        return self.pop_all()


class nullcontext(AbstractContextManager):
    """Context manager that does no additional processing.
    Used as a stand-in for a normal context manager, when a particular
    block of code is only sometimes used with a normal context manager:
    cm = optional_cm if condition else nullcontext()
    with cm:
        # Perform operation, using optional_cm if condition is True
    """

    def __init__(self, enter_result=None):
        self.enter_result = enter_result

    def __enter__(self):
        return self.enter_result

    def __exit__(self, *excinfo):
        pass
site-packages/pip/_vendor/retrying.py000064400000023364151446177000013742 0ustar00## Copyright 2013-2014 Ray Holder
##
## Licensed under the Apache License, Version 2.0 (the "License");
## you may not use this file except in compliance with the License.
## You may obtain a copy of the License at
##
## http://www.apache.org/licenses/LICENSE-2.0
##
## Unless required by applicable law or agreed to in writing, software
## distributed under the License is distributed on an "AS IS" BASIS,
## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
## See the License for the specific language governing permissions and
## limitations under the License.

import random
from pip._vendor import six
import sys
import time
import traceback


# sys.maxint / 2, since Python 3.2 doesn't have a sys.maxint...
MAX_WAIT = 1073741823


def retry(*dargs, **dkw):
    """
    Decorator function that instantiates the Retrying object
    @param *dargs: positional arguments passed to Retrying object
    @param **dkw: keyword arguments passed to the Retrying object
    """
    # support both @retry and @retry() as valid syntax
    if len(dargs) == 1 and callable(dargs[0]):
        def wrap_simple(f):

            @six.wraps(f)
            def wrapped_f(*args, **kw):
                return Retrying().call(f, *args, **kw)

            return wrapped_f

        return wrap_simple(dargs[0])

    else:
        def wrap(f):

            @six.wraps(f)
            def wrapped_f(*args, **kw):
                return Retrying(*dargs, **dkw).call(f, *args, **kw)

            return wrapped_f

        return wrap


class Retrying(object):

    def __init__(self,
                 stop=None, wait=None,
                 stop_max_attempt_number=None,
                 stop_max_delay=None,
                 wait_fixed=None,
                 wait_random_min=None, wait_random_max=None,
                 wait_incrementing_start=None, wait_incrementing_increment=None,
                 wait_exponential_multiplier=None, wait_exponential_max=None,
                 retry_on_exception=None,
                 retry_on_result=None,
                 wrap_exception=False,
                 stop_func=None,
                 wait_func=None,
                 wait_jitter_max=None):

        self._stop_max_attempt_number = 5 if stop_max_attempt_number is None else stop_max_attempt_number
        self._stop_max_delay = 100 if stop_max_delay is None else stop_max_delay
        self._wait_fixed = 1000 if wait_fixed is None else wait_fixed
        self._wait_random_min = 0 if wait_random_min is None else wait_random_min
        self._wait_random_max = 1000 if wait_random_max is None else wait_random_max
        self._wait_incrementing_start = 0 if wait_incrementing_start is None else wait_incrementing_start
        self._wait_incrementing_increment = 100 if wait_incrementing_increment is None else wait_incrementing_increment
        self._wait_exponential_multiplier = 1 if wait_exponential_multiplier is None else wait_exponential_multiplier
        self._wait_exponential_max = MAX_WAIT if wait_exponential_max is None else wait_exponential_max
        self._wait_jitter_max = 0 if wait_jitter_max is None else wait_jitter_max

        # TODO add chaining of stop behaviors
        # stop behavior
        stop_funcs = []
        if stop_max_attempt_number is not None:
            stop_funcs.append(self.stop_after_attempt)

        if stop_max_delay is not None:
            stop_funcs.append(self.stop_after_delay)

        if stop_func is not None:
            self.stop = stop_func

        elif stop is None:
            self.stop = lambda attempts, delay: any(f(attempts, delay) for f in stop_funcs)

        else:
            self.stop = getattr(self, stop)

        # TODO add chaining of wait behaviors
        # wait behavior
        wait_funcs = [lambda *args, **kwargs: 0]
        if wait_fixed is not None:
            wait_funcs.append(self.fixed_sleep)

        if wait_random_min is not None or wait_random_max is not None:
            wait_funcs.append(self.random_sleep)

        if wait_incrementing_start is not None or wait_incrementing_increment is not None:
            wait_funcs.append(self.incrementing_sleep)

        if wait_exponential_multiplier is not None or wait_exponential_max is not None:
            wait_funcs.append(self.exponential_sleep)

        if wait_func is not None:
            self.wait = wait_func

        elif wait is None:
            self.wait = lambda attempts, delay: max(f(attempts, delay) for f in wait_funcs)

        else:
            self.wait = getattr(self, wait)

        # retry on exception filter
        if retry_on_exception is None:
            self._retry_on_exception = self.always_reject
        else:
            self._retry_on_exception = retry_on_exception

        # TODO simplify retrying by Exception types
        # retry on result filter
        if retry_on_result is None:
            self._retry_on_result = self.never_reject
        else:
            self._retry_on_result = retry_on_result

        self._wrap_exception = wrap_exception

    def stop_after_attempt(self, previous_attempt_number, delay_since_first_attempt_ms):
        """Stop after the previous attempt >= stop_max_attempt_number."""
        return previous_attempt_number >= self._stop_max_attempt_number

    def stop_after_delay(self, previous_attempt_number, delay_since_first_attempt_ms):
        """Stop after the time from the first attempt >= stop_max_delay."""
        return delay_since_first_attempt_ms >= self._stop_max_delay

    def no_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
        """Don't sleep at all before retrying."""
        return 0

    def fixed_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
        """Sleep a fixed amount of time between each retry."""
        return self._wait_fixed

    def random_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
        """Sleep a random amount of time between wait_random_min and wait_random_max"""
        return random.randint(self._wait_random_min, self._wait_random_max)

    def incrementing_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
        """
        Sleep an incremental amount of time after each attempt, starting at
        wait_incrementing_start and incrementing by wait_incrementing_increment
        """
        result = self._wait_incrementing_start + (self._wait_incrementing_increment * (previous_attempt_number - 1))
        if result < 0:
            result = 0
        return result

    def exponential_sleep(self, previous_attempt_number, delay_since_first_attempt_ms):
        exp = 2 ** previous_attempt_number
        result = self._wait_exponential_multiplier * exp
        if result > self._wait_exponential_max:
            result = self._wait_exponential_max
        if result < 0:
            result = 0
        return result

    def never_reject(self, result):
        return False

    def always_reject(self, result):
        return True

    def should_reject(self, attempt):
        reject = False
        if attempt.has_exception:
            reject |= self._retry_on_exception(attempt.value[1])
        else:
            reject |= self._retry_on_result(attempt.value)

        return reject

    def call(self, fn, *args, **kwargs):
        start_time = int(round(time.time() * 1000))
        attempt_number = 1
        while True:
            try:
                attempt = Attempt(fn(*args, **kwargs), attempt_number, False)
            except:
                tb = sys.exc_info()
                attempt = Attempt(tb, attempt_number, True)

            if not self.should_reject(attempt):
                return attempt.get(self._wrap_exception)

            delay_since_first_attempt_ms = int(round(time.time() * 1000)) - start_time
            if self.stop(attempt_number, delay_since_first_attempt_ms):
                if not self._wrap_exception and attempt.has_exception:
                    # get() on an attempt with an exception should cause it to be raised, but raise just in case
                    raise attempt.get()
                else:
                    raise RetryError(attempt)
            else:
                sleep = self.wait(attempt_number, delay_since_first_attempt_ms)
                if self._wait_jitter_max:
                    jitter = random.random() * self._wait_jitter_max
                    sleep = sleep + max(0, jitter)
                time.sleep(sleep / 1000.0)

            attempt_number += 1


class Attempt(object):
    """
    An Attempt encapsulates a call to a target function that may end as a
    normal return value from the function or an Exception depending on what
    occurred during the execution.
    """

    def __init__(self, value, attempt_number, has_exception):
        self.value = value
        self.attempt_number = attempt_number
        self.has_exception = has_exception

    def get(self, wrap_exception=False):
        """
        Return the return value of this Attempt instance or raise an Exception.
        If wrap_exception is true, this Attempt is wrapped inside of a
        RetryError before being raised.
        """
        if self.has_exception:
            if wrap_exception:
                raise RetryError(self)
            else:
                six.reraise(self.value[0], self.value[1], self.value[2])
        else:
            return self.value

    def __repr__(self):
        if self.has_exception:
            return "Attempts: {0}, Error:\n{1}".format(self.attempt_number, "".join(traceback.format_tb(self.value[2])))
        else:
            return "Attempts: {0}, Value: {1}".format(self.attempt_number, self.value)


class RetryError(Exception):
    """
    A RetryError encapsulates the last Attempt instance right before giving up.
    """

    def __init__(self, last_attempt):
        self.last_attempt = last_attempt

    def __str__(self):
        return "RetryError[{0}]".format(self.last_attempt)
site-packages/pip/_vendor/pytoml/writer.py000064400000006451151446177000014735 0ustar00from __future__ import unicode_literals
import io, datetime, math, string, sys

from .utils import format_rfc3339

try:
    from pathlib import PurePath as _path_types
except ImportError:
    _path_types = ()


if sys.version_info[0] == 3:
    long = int
    unicode = str


def dumps(obj, sort_keys=False):
    fout = io.StringIO()
    dump(obj, fout, sort_keys=sort_keys)
    return fout.getvalue()


_escapes = {'\n': 'n', '\r': 'r', '\\': '\\', '\t': 't', '\b': 'b', '\f': 'f', '"': '"'}


def _escape_string(s):
    res = []
    start = 0

    def flush():
        if start != i:
            res.append(s[start:i])
        return i + 1

    i = 0
    while i < len(s):
        c = s[i]
        if c in '"\\\n\r\t\b\f':
            start = flush()
            res.append('\\' + _escapes[c])
        elif ord(c) < 0x20:
            start = flush()
            res.append('\\u%04x' % ord(c))
        i += 1

    flush()
    return '"' + ''.join(res) + '"'


_key_chars = string.digits + string.ascii_letters + '-_'
def _escape_id(s):
    if any(c not in _key_chars for c in s):
        return _escape_string(s)
    return s


def _format_value(v):
    if isinstance(v, bool):
        return 'true' if v else 'false'
    if isinstance(v, int) or isinstance(v, long):
        return unicode(v)
    if isinstance(v, float):
        if math.isnan(v) or math.isinf(v):
            raise ValueError("{0} is not a valid TOML value".format(v))
        else:
            return repr(v)
    elif isinstance(v, unicode) or isinstance(v, bytes):
        return _escape_string(v)
    elif isinstance(v, datetime.datetime):
        return format_rfc3339(v)
    elif isinstance(v, list):
        return '[{0}]'.format(', '.join(_format_value(obj) for obj in v))
    elif isinstance(v, dict):
        return '{{{0}}}'.format(', '.join('{} = {}'.format(_escape_id(k), _format_value(obj)) for k, obj in v.items()))
    elif isinstance(v, _path_types):
        return _escape_string(str(v))
    else:
        raise RuntimeError(v)


def dump(obj, fout, sort_keys=False):
    tables = [((), obj, False)]

    while tables:
        name, table, is_array = tables.pop()
        if name:
            section_name = '.'.join(_escape_id(c) for c in name)
            if is_array:
                fout.write('[[{0}]]\n'.format(section_name))
            else:
                fout.write('[{0}]\n'.format(section_name))

        table_keys = sorted(table.keys()) if sort_keys else table.keys()
        new_tables = []
        has_kv = False
        for k in table_keys:
            v = table[k]
            if isinstance(v, dict):
                new_tables.append((name + (k,), v, False))
            elif isinstance(v, list) and v and all(isinstance(o, dict) for o in v):
                new_tables.extend((name + (k,), d, True) for d in v)
            elif v is None:
                # based on mojombo's comment: https://github.com/toml-lang/toml/issues/146#issuecomment-25019344
                fout.write(
                    '#{} = null  # To use: uncomment and replace null with value\n'.format(_escape_id(k)))
                has_kv = True
            else:
                fout.write('{0} = {1}\n'.format(_escape_id(k), _format_value(v)))
                has_kv = True

        tables.extend(reversed(new_tables))

        if (name or has_kv) and tables:
            fout.write('\n')
site-packages/pip/_vendor/pytoml/utils.py000064400000003201151446177000014547 0ustar00import datetime
import re

rfc3339_re = re.compile(r'(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d+)?(?:Z|([+-]\d{2}):(\d{2}))')

def parse_rfc3339(v):
    m = rfc3339_re.match(v)
    if not m or m.group(0) != v:
        return None
    return parse_rfc3339_re(m)

def parse_rfc3339_re(m):
    r = map(int, m.groups()[:6])
    if m.group(7):
        micro = float(m.group(7))
    else:
        micro = 0

    if m.group(8):
        g = int(m.group(8), 10) * 60 + int(m.group(9), 10)
        tz = _TimeZone(datetime.timedelta(0, g * 60))
    else:
        tz = _TimeZone(datetime.timedelta(0, 0))

    y, m, d, H, M, S = r
    return datetime.datetime(y, m, d, H, M, S, int(micro * 1000000), tz)


def format_rfc3339(v):
    offs = v.utcoffset()
    offs = int(offs.total_seconds()) // 60 if offs is not None else 0

    if offs == 0:
        suffix = 'Z'
    else:
        if offs > 0:
            suffix = '+'
        else:
            suffix = '-'
            offs = -offs
        suffix = '{0}{1:02}:{2:02}'.format(suffix, offs // 60, offs % 60)

    if v.microsecond:
        return v.strftime('%Y-%m-%dT%H:%M:%S.%f') + suffix
    else:
        return v.strftime('%Y-%m-%dT%H:%M:%S') + suffix

class _TimeZone(datetime.tzinfo):
    def __init__(self, offset):
        self._offset = offset

    def utcoffset(self, dt):
        return self._offset

    def dst(self, dt):
        return None

    def tzname(self, dt):
        m = self._offset.total_seconds() // 60
        if m < 0:
            res = '-'
            m = -m
        else:
            res = '+'
        h = m // 60
        m = m - h * 60
        return '{}{:.02}{:.02}'.format(res, h, m)
site-packages/pip/_vendor/pytoml/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000524151446177000022400 0ustar00U

��.e�@s<ddlmZddlmZmZddlmZddlmZm	Z	dS)�)�	TomlError)�load�loads)�translate_to_test)�dump�dumpsN)
Zcorer�parserrrZtestr�writerrr�r
r
�?/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/__init__.py�<module>ssite-packages/pip/_vendor/pytoml/__pycache__/parser.cpython-38.pyc000064400000023542151446177000021203 0ustar00U

��.eE(�@sNddlZddlZddlmZddlmZmZejddkr@eZ	ne
Z	dd�efdd	�Zd
dd�efdd
�Z
Gdd�d�Ze�d�Zdd�Ze�d�Zdd�Zdddddddd�Ze�d�Ze�d�Ze�d �Ze�d!�Ze�d"�Zefd#d$�Ze�d%�Zd&d'�Ze�d(�Ze�d)�Ze�d*�Ze�d+�Z d,d-�Z!d.d/�Z"e�d0�Z#d1d2�Z$dS)3�N���	TomlError)�
rfc3339_re�parse_rfc3339_re�cCs|S�N���t�x�vr	r	�=/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/parser.py�<lambda>
�rc	Cs t|��||t|dt|��d�S)N�name)�	translate�object_pairs_hook�filename)�loads�read�getattr�repr)Zfinrrr	r	r�load
srz<string>cCs|Srr	r
r	r	rr
rcs�t|t�r|�d�}|�dd�}��}��}|}t|�d�}t|�d�}��fdd�����fdd	��|D�]D\}	}
�|	d
kr�|
\}}||kr��d�|���|�d�||<qj|	dk}
|}|
dd
�D]<}t|�|�t�r�||d
\}}q�|�	|d��f�\}}qƈ�}|
d
}||k�rD|
�r4|��fg||<n|��f||<qjt||t��rx|
�sb�d�||�
|��f�qj|
�r��d�||\}}|dk	�r��d�||f||<qj���fdd���||�S)Nzutf-8z
�
)r�rcst|�d�d���dS�Nrrr)�msg)r�posr	r�errorszloads.<locals>.errorcs�|\}}�}|dkrT�r>t�fdd��dd�D��r>�d���fdd��D��n"|dkrv����fd	d��D����||��S)
N�arrayc3s&|]\}}}}|�ddkVqdS)rNr	)�.0�krr
�p)�valuer	r�	<genexpr> s
z/loads.<locals>.process_value.<locals>.<genexpr>rzarray-type-mismatchcsg|]}�|�d��qS�rr	)r!�item)r�
process_valuer	r�
<listcomp>"sz0loads.<locals>.process_value.<locals>.<listcomp>�tablecs g|]}|��|�d�f�qSr&r	)r!r")rr(r$r	rr)$s)�any)r
r�kind�textr)rr(r)rr$rr(s"zloads.<locals>.process_value�kvz2duplicate_keys. Key "{0}" was used more than once.�table_array���Ztable_type_mismatchZduplicate_tablescsl|dkr��}|D]T}||kr&�d�||}t|t�rP�fdd�|D�||<q�|d|d�||<q|S)NZkey_table_conflictcsg|]\}}�||��qSr	r	)r!ZscZtbl)�merge_tablesr	rr)Qsz/loads.<locals>.merge_tables.<locals>.<listcomp>rr)�
isinstance�list)�scope�tablesr"r
)rr1rr	rr1Is
zloads.<locals>.merge_tables)r2�bytes�decode�replace�_Source�_p_toml�format�getr3�
setdefault�append)�srrr�rootr5r4�srcZastr,r$r"r
Zis_table_arrayZcurr�dZ	old_scopeZ
next_tabler	)rrr1rrr(rrr
sP





rc@s�eZdZd$dd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zd d!�Zd"d#�ZdS)%r9NcCs"||_d|_d|_||_g|_dS)N)rr)r?�_pos�_last�	_filename�backtrack_stack)�selfr?rr	r	r�__init__Ys
z_Source.__init__cCs|jSr)rD�rGr	r	r�last`sz_Source.lastcCs|jSr)rCrIr	r	rrcsz_Source.poscCs
|�d�Sr)�_expectrIr	r	r�failfsz_Source.failcCs6|jr2|jd|_|dd�|_|�|j�|jSdSr)r?rD�_advancerIr	r	r�consume_dotisz_Source.consume_dotcCs|�|���Sr)rKrNrIr	r	r�
expect_dotqsz_Source.expect_dotcCs|jsd|_dSdS)N�TF)r?rDrIr	r	r�consume_eoftsz_Source.consume_eofcCs|�|���Sr)rKrQrIr	r	r�
expect_eofzsz_Source.expect_eofcCs8|j�|�r4|jt|�d�|_||_|�|�dSdS)NTF)r?�
startswith�lenrDrM�rGr?r	r	r�consume}s
z_Source.consumecCs|�|�|��Sr)rKrVrUr	r	r�expect�sz_Source.expectcCsH|�|j�}|rD|jt|�d��d�|_||_|�|�d��|SdS)Nr)�matchr?rT�grouprDrM)rG�re�mr	r	r�
consume_re�sz_Source.consume_recCs|�|�|��Sr)rKr\)rGrZr	r	r�	expect_re�sz_Source.expect_recCs|j�|j|jf�dSr)rFr>r?rCrIr	r	r�	__enter__�sz_Source.__enter__cCs.|dkr|j��n|j��\|_|_|tkSr)rF�popr?rCr)rG�typer$�	tracebackr	r	r�__exit__�sz_Source.__exit__cCs|j|jf|jd<dS)Nr0)r?rCrFrIr	r	r�commit�sz_Source.commitcCs$|s td|jd|jd|j��|S)Nrrr)rrCrE)rG�rr	r	rrK�sz_Source._expectcCsX|�d�}|dkr2|jd|jdt|�f|_n"|jd|�d�t|�|f|_dS)Nrr0rr)�rfindrCrT�count)rGr?Z
suffix_posr	r	rrM�s
 z_Source._advance)N)�__name__�
__module__�__qualname__rHrJrrLrNrOrQrRrVrWr\r]r^rbrcrKrMr	r	r	rr9Xs"
	r9z!(?:[ \t]|#[^\n]*\n|#[^\n]*\Z|\n)*cCs|�t�dSr)r]�_ews_re�r?r	r	r�_p_ews�srlz[ \t]*cCs|�t�dSr)r]�_ws_rerkr	r	r�_p_ws�srn�r�
�	�"�\�)�b�nrdrrrrs�fz[^"\\\000-\037]*zu([0-9a-fA-F]{4})zU([0-9a-fA-F]{8})z[btnfr\"\\]z
[ 	
]*cCs�g}|�|�|��d��|�d�s&q�|�t�r2q|�t�sF|�t�r�t|�	��d�d�}d|krndkrznn|�
�|�t|��q|�t�|�t
|�	��d��qd�|�S)Nrrsr�i�i�rP)r>r]rYrVr\�_newline_esc_re�
_short_uni_re�_long_uni_re�intrJrL�_chr�_escapes_re�_escapes�join)r?Zcontent�resr
r	r	r�_p_basicstr_content�s


r�z[0-9a-zA-Z-_]+c
Cs�|�0|�d�t|t�}|�d�|W5QR�SQRX|�d�r�|�d�rt|�d�|�t��d�}|�d�n|�t��d�}|�d�|S|�t��d�S)Nrr�'�''rr�''')	rWr��_basicstr_rerVr]�
_litstr_ml_rerY�
_litstr_re�_key_re)r?rdr	r	r�_p_key�s






r�zH[+-]?(?:0|[1-9](?:_?\d)*)(?:\.\d(?:_?\d)*)?(?:[eE][+-]?(?:\d(?:_?\d)*))?z&(?:""?(?!")|[^"\\\000-\011\013-\037])*z[^'\000\010\012-\037]*z((?:(?:|'|'')(?:[^'\000-\010\013-\037]))*c	Cs�|��}|�d�r"d|��d|fS|�d�r<d|��d|fS|�d�r�|�d�rp|�d�t|t�}|�d	�nt|t�}|�d�d
|||fS|�d�r�|�d�r�|�d�|�t��	d
�}|�d�n|�t
��	d
�}|�d�d
|||fS|�t��r|��}d|�	d
�t
|�|fS|�t��r�|���	d
�}|�dd�}d|k�s^d|k�s^d|k�rnd|t|�|fSd|t|d�|fS|�d��r�g}|�Ft|�|�t||d��|��t|�|�d�|���q�W5QRXt|�|�d�dd||fS|�d��r�t|�|�}|�d��s�t|�}t|�|�d�t|�t||d�||<t|�|�d��r�t|�t|�}t|�|�d�t|�t||d�||<t|��q^|�d�d d||fS|��dS)!N�true�boolTZfalseFrrz""rz"""�strr�r�rr�Zdatetime�_rP�.�e�E�floatr|�
�[r�,�]r �{�}�=r*)rrVrJr��_basicstr_ml_rerWr�r]r�rYr�r\rr�	_float_rer8r�r|rlr>�_p_valuercrnr�rL)r?rrrdr[�itemsr"r	r	rr��s~
















r�cCs�|��}|�d�r�|�d�}t|�t|�g}t|�|�d�r`t|�|�t|��t|�q6|�d�|rx|�d�|r�dnd||fSt|�}t|�|�d�t|�t||d�}d||f|fS)	Nr�r�r�r/r*r�rr.)rrVrnr�r>rWr�)r?rrZis_array�keys�keyr$r	r	r�_p_stmt3s(







r�z(?:[ \t]*(?:#[^\n]*)?\n)+[ \t]*c	Cshg}t|�|�>|�t||d��|��|�t�|�t||d��q$W5QRXt|�|��|S)Nr)rlr>r�rcr]�_stmtsep_rerR)r?rZstmtsr	r	rr:Ks
r:)%rZ�sysZcorerZutilsrr�version_infoZunichrr}�chr�dictrrr9�compilerjrlrmrnrr�rzr{r~ryr�r�r�r�r�r�r�r�r�r�r:r	r	r	r�<module>s@KU


�









M
site-packages/pip/_vendor/pytoml/__pycache__/utils.cpython-38.opt-1.pyc000064400000004121151446177000021776 0ustar00U

��.e��@sHddlZddlZe�d�Zdd�Zdd�Zdd�ZGd	d
�d
ej�ZdS)�NzP(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d+)?(?:Z|([+-]\d{2}):(\d{2}))cCs(t�|�}|r|�d�|kr dSt|�S)Nr)�
rfc3339_re�match�group�parse_rfc3339_re)�v�m�r�</usr/lib/python3.8/site-packages/pip/_vendor/pytoml/utils.py�
parse_rfc3339s
r
c
Cs�tt|��dd��}|�d�r0t|�d��}nd}|�d�rxt|�d�d�dt|�d�d�}tt�d|d��}ntt�dd��}|\}}}}}}	t�||||||	t|d�|�S)	N��r��
�<�	i@B)�map�int�groupsr�float�	_TimeZone�datetimeZ	timedelta)
r�r�micro�gZtz�y�d�H�M�Srrr	rs

$rcCs�|��}|dk	r t|���dnd}|dkr2d}n.|dkr@d}n
d}|}d�||d|d�}|jrt|�d�|S|�d�|SdS)	Nrr�Z�+�-z{0}{1:02}:{2:02}z%Y-%m-%dT%H:%M:%S.%fz%Y-%m-%dT%H:%M:%S)�	utcoffsetr�
total_seconds�formatZmicrosecond�strftime)rZoffs�suffixrrr	�format_rfc3339sr'c@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
rcCs
||_dS�N��_offset)�self�offsetrrr	�__init__1sz_TimeZone.__init__cCs|jSr(r)�r+�dtrrr	r"4sz_TimeZone.utcoffsetcCsdSr(rr.rrr	�dst7sz
_TimeZone.dstcCsH|j��d}|dkr"d}|}nd}|d}||d}d�|||�S)Nrrr!r z{}{:.02}{:.02})r*r#r$)r+r/r�res�hrrr	�tzname:sz_TimeZone.tznameN)�__name__�
__module__�__qualname__r-r"r0r3rrrr	r0sr)	r�re�compilerr
rr'Ztzinforrrrr	�<module>s
site-packages/pip/_vendor/pytoml/__pycache__/core.cpython-38.pyc000064400000001625151446177000020635 0ustar00U

��.e��@sGdd�de�ZdS)c@s$eZdZdd�Zdd�Zdd�ZdS)�	TomlErrorcCs.t�|||||�||_||_||_||_dS)N)�RuntimeError�__init__�message�line�col�filename)�selfrrrr�r	�;/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/core.pyrs
zTomlError.__init__cCsd�|j|j|j|j�S)Nz{}({}, {}): {})�formatrrrr�rr	r	r
�__str__	szTomlError.__str__cCsd�|j|j|j|j�S)Nz!TomlError({!r}, {!r}, {!r}, {!r}))rrrrrrr	r	r
�__repr__szTomlError.__repr__N)�__name__�
__module__�__qualname__rr
rr	r	r	r
rsrN)rrr	r	r	r
�<module>�site-packages/pip/_vendor/pytoml/__pycache__/parser.cpython-38.opt-1.pyc000064400000023542151446177000022142 0ustar00U

��.eE(�@sNddlZddlZddlmZddlmZmZejddkr@eZ	ne
Z	dd�efdd	�Zd
dd�efdd
�Z
Gdd�d�Ze�d�Zdd�Ze�d�Zdd�Zdddddddd�Ze�d�Ze�d�Ze�d �Ze�d!�Ze�d"�Zefd#d$�Ze�d%�Zd&d'�Ze�d(�Ze�d)�Ze�d*�Ze�d+�Z d,d-�Z!d.d/�Z"e�d0�Z#d1d2�Z$dS)3�N���	TomlError)�
rfc3339_re�parse_rfc3339_re�cCs|S�N���t�x�vr	r	�=/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/parser.py�<lambda>
�rc	Cs t|��||t|dt|��d�S)N�name)�	translate�object_pairs_hook�filename)�loads�read�getattr�repr)Zfinrrr	r	r�load
srz<string>cCs|Srr	r
r	r	rr
rcs�t|t�r|�d�}|�dd�}��}��}|}t|�d�}t|�d�}��fdd�����fdd	��|D�]D\}	}
�|	d
kr�|
\}}||kr��d�|���|�d�||<qj|	dk}
|}|
dd
�D]<}t|�|�t�r�||d
\}}q�|�	|d��f�\}}qƈ�}|
d
}||k�rD|
�r4|��fg||<n|��f||<qjt||t��rx|
�sb�d�||�
|��f�qj|
�r��d�||\}}|dk	�r��d�||f||<qj���fdd���||�S)Nzutf-8z
�
)r�rcst|�d�d���dS�Nrrr)�msg)r�posr	r�errorszloads.<locals>.errorcs�|\}}�}|dkrT�r>t�fdd��dd�D��r>�d���fdd��D��n"|dkrv����fd	d��D����||��S)
N�arrayc3s&|]\}}}}|�ddkVqdS)rNr	)�.0�krr
�p)�valuer	r�	<genexpr> s
z/loads.<locals>.process_value.<locals>.<genexpr>rzarray-type-mismatchcsg|]}�|�d��qS�rr	)r!�item)r�
process_valuer	r�
<listcomp>"sz0loads.<locals>.process_value.<locals>.<listcomp>�tablecs g|]}|��|�d�f�qSr&r	)r!r")rr(r$r	rr)$s)�any)r
r�kind�textr)rr(r)rr$rr(s"zloads.<locals>.process_value�kvz2duplicate_keys. Key "{0}" was used more than once.�table_array���Ztable_type_mismatchZduplicate_tablescsl|dkr��}|D]T}||kr&�d�||}t|t�rP�fdd�|D�||<q�|d|d�||<q|S)NZkey_table_conflictcsg|]\}}�||��qSr	r	)r!ZscZtbl)�merge_tablesr	rr)Qsz/loads.<locals>.merge_tables.<locals>.<listcomp>rr)�
isinstance�list)�scope�tablesr"r
)rr1rr	rr1Is
zloads.<locals>.merge_tables)r2�bytes�decode�replace�_Source�_p_toml�format�getr3�
setdefault�append)�srrr�rootr5r4�srcZastr,r$r"r
Zis_table_arrayZcurr�dZ	old_scopeZ
next_tabler	)rrr1rrr(rrr
sP





rc@s�eZdZd$dd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zd d!�Zd"d#�ZdS)%r9NcCs"||_d|_d|_||_g|_dS)N)rr)r?�_pos�_last�	_filename�backtrack_stack)�selfr?rr	r	r�__init__Ys
z_Source.__init__cCs|jSr)rD�rGr	r	r�last`sz_Source.lastcCs|jSr)rCrIr	r	rrcsz_Source.poscCs
|�d�Sr)�_expectrIr	r	r�failfsz_Source.failcCs6|jr2|jd|_|dd�|_|�|j�|jSdSr)r?rD�_advancerIr	r	r�consume_dotisz_Source.consume_dotcCs|�|���Sr)rKrNrIr	r	r�
expect_dotqsz_Source.expect_dotcCs|jsd|_dSdS)N�TF)r?rDrIr	r	r�consume_eoftsz_Source.consume_eofcCs|�|���Sr)rKrQrIr	r	r�
expect_eofzsz_Source.expect_eofcCs8|j�|�r4|jt|�d�|_||_|�|�dSdS)NTF)r?�
startswith�lenrDrM�rGr?r	r	r�consume}s
z_Source.consumecCs|�|�|��Sr)rKrVrUr	r	r�expect�sz_Source.expectcCsH|�|j�}|rD|jt|�d��d�|_||_|�|�d��|SdS)Nr)�matchr?rT�grouprDrM)rG�re�mr	r	r�
consume_re�sz_Source.consume_recCs|�|�|��Sr)rKr\)rGrZr	r	r�	expect_re�sz_Source.expect_recCs|j�|j|jf�dSr)rFr>r?rCrIr	r	r�	__enter__�sz_Source.__enter__cCs.|dkr|j��n|j��\|_|_|tkSr)rF�popr?rCr)rG�typer$�	tracebackr	r	r�__exit__�sz_Source.__exit__cCs|j|jf|jd<dS)Nr0)r?rCrFrIr	r	r�commit�sz_Source.commitcCs$|s td|jd|jd|j��|S)Nrrr)rrCrE)rG�rr	r	rrK�sz_Source._expectcCsX|�d�}|dkr2|jd|jdt|�f|_n"|jd|�d�t|�|f|_dS)Nrr0rr)�rfindrCrT�count)rGr?Z
suffix_posr	r	rrM�s
 z_Source._advance)N)�__name__�
__module__�__qualname__rHrJrrLrNrOrQrRrVrWr\r]r^rbrcrKrMr	r	r	rr9Xs"
	r9z!(?:[ \t]|#[^\n]*\n|#[^\n]*\Z|\n)*cCs|�t�dSr)r]�_ews_re�r?r	r	r�_p_ews�srlz[ \t]*cCs|�t�dSr)r]�_ws_rerkr	r	r�_p_ws�srn�r�
�	�"�\�)�b�nrdrrrrs�fz[^"\\\000-\037]*zu([0-9a-fA-F]{4})zU([0-9a-fA-F]{8})z[btnfr\"\\]z
[ 	
]*cCs�g}|�|�|��d��|�d�s&q�|�t�r2q|�t�sF|�t�r�t|�	��d�d�}d|krndkrznn|�
�|�t|��q|�t�|�t
|�	��d��qd�|�S)Nrrsr�i�i�rP)r>r]rYrVr\�_newline_esc_re�
_short_uni_re�_long_uni_re�intrJrL�_chr�_escapes_re�_escapes�join)r?Zcontent�resr
r	r	r�_p_basicstr_content�s


r�z[0-9a-zA-Z-_]+c
Cs�|�0|�d�t|t�}|�d�|W5QR�SQRX|�d�r�|�d�rt|�d�|�t��d�}|�d�n|�t��d�}|�d�|S|�t��d�S)Nrr�'�''rr�''')	rWr��_basicstr_rerVr]�
_litstr_ml_rerY�
_litstr_re�_key_re)r?rdr	r	r�_p_key�s






r�zH[+-]?(?:0|[1-9](?:_?\d)*)(?:\.\d(?:_?\d)*)?(?:[eE][+-]?(?:\d(?:_?\d)*))?z&(?:""?(?!")|[^"\\\000-\011\013-\037])*z[^'\000\010\012-\037]*z((?:(?:|'|'')(?:[^'\000-\010\013-\037]))*c	Cs�|��}|�d�r"d|��d|fS|�d�r<d|��d|fS|�d�r�|�d�rp|�d�t|t�}|�d	�nt|t�}|�d�d
|||fS|�d�r�|�d�r�|�d�|�t��	d
�}|�d�n|�t
��	d
�}|�d�d
|||fS|�t��r|��}d|�	d
�t
|�|fS|�t��r�|���	d
�}|�dd�}d|k�s^d|k�s^d|k�rnd|t|�|fSd|t|d�|fS|�d��r�g}|�Ft|�|�t||d��|��t|�|�d�|���q�W5QRXt|�|�d�dd||fS|�d��r�t|�|�}|�d��s�t|�}t|�|�d�t|�t||d�||<t|�|�d��r�t|�t|�}t|�|�d�t|�t||d�||<t|��q^|�d�d d||fS|��dS)!N�true�boolTZfalseFrrz""rz"""�strr�r�rr�Zdatetime�_rP�.�e�E�floatr|�
�[r�,�]r �{�}�=r*)rrVrJr��_basicstr_ml_rerWr�r]r�rYr�r\rr�	_float_rer8r�r|rlr>�_p_valuercrnr�rL)r?rrrdr[�itemsr"r	r	rr��s~
















r�cCs�|��}|�d�r�|�d�}t|�t|�g}t|�|�d�r`t|�|�t|��t|�q6|�d�|rx|�d�|r�dnd||fSt|�}t|�|�d�t|�t||d�}d||f|fS)	Nr�r�r�r/r*r�rr.)rrVrnr�r>rWr�)r?rrZis_array�keys�keyr$r	r	r�_p_stmt3s(







r�z(?:[ \t]*(?:#[^\n]*)?\n)+[ \t]*c	Cshg}t|�|�>|�t||d��|��|�t�|�t||d��q$W5QRXt|�|��|S)Nr)rlr>r�rcr]�_stmtsep_rerR)r?rZstmtsr	r	rr:Ks
r:)%rZ�sysZcorerZutilsrr�version_infoZunichrr}�chr�dictrrr9�compilerjrlrmrnrr�rzr{r~ryr�r�r�r�r�r�r�r�r�r�r:r	r	r	r�<module>s@KU


�









M
site-packages/pip/_vendor/pytoml/__pycache__/writer.cpython-38.pyc000064400000007171151446177000021223 0ustar00U

��.e)
�@s�ddlmZddlZddlZddlZddlZddlZddlmZzddl	m
ZWnek
rhdZYnXej
ddkr�eZeZdd	d
�Zddd
ddddd�Zdd�ZejejdZdd�Zdd�Zddd�ZdS)�)�unicode_literalsN�)�format_rfc3339)�PurePath��FcCst��}t|||d�|��S)N)�	sort_keys)�io�StringIO�dump�getvalue)�objr�foutrr�=/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/writer.py�dumpssr�n�r�\�t�b�f�")�
�
r�	��rcs�g�d�����fdd�}d��t��kr���}|dkrT|����dt|�n$t|�dkrx|����dt|���d7�q|�d	d
���d	S)Nrcs"��kr��������dS)Nr)�appendr��i�res�s�startrr�flushsz_escape_string.<locals>.flushz"\

	r� z\u%04xrr�)�lenr�_escapes�ord�join)r!r#�crrr�_escape_strings
r+z-_cCstdd�|D��rt|�S|S)Ncss|]}|tkVqdS�N)�
_key_chars��.0r*rrr�	<genexpr>4sz_escape_id.<locals>.<genexpr>)�anyr+)r!rrr�
_escape_id3sr2cCs
t|t�r|rdSdSt|t�s*t|t�r2t|�St|t�rjt�|�sPt�|�r`t	d�
|���nt|�Sn�t|t�s~t|t�r�t
|�St|tj�r�t|�St|t�r�d�
d�dd�|D���St|t�r�d�
d�d	d�|��D���St|t��r�t
t|��St|��dS)
N�trueZfalsez{0} is not a valid TOML valuez[{0}]z, css|]}t|�VqdSr,)�
_format_value)r/r
rrrr0Hsz _format_value.<locals>.<genexpr>z{{{0}}}css&|]\}}d�t|�t|��VqdS)z{} = {}N)�formatr2r4)r/�kr
rrrr0Js)�
isinstance�bool�int�long�unicode�float�mathZisnanZisinf�
ValueErrorr5�repr�bytesr+�datetimer�listr)�dict�items�_path_types�str�RuntimeError)�vrrrr49s&




r4cs\d|dfg}|�rX|��\�}}�r^d�dd��D��}|rN|�d�|��n|�d�|��|rnt|���n|��}g}d}	|D]��|�}
t|
t�r�|���f|
df�q�t|
t	�r�|
r�t
dd�|
D��r�|���fd	d�|
D��q�|
dk�r|�d
�t����d}	q�|�d�t��t
|
���d}	q�|�t|����sH|	r|r|�d
�qdS)NrF�.css|]}t|�VqdSr,)r2r.rrrr0Wszdump.<locals>.<genexpr>z[[{0}]]
z[{0}]
css|]}t|t�VqdSr,)r7rC)r/�orrrr0dsc3s|]}��f|dfVqdS)TNr)r/�d�r6�namerrr0esz<#{} = null  # To use: uncomment and replace null with value
Tz
{0} = {1}
r)�popr)�writer5�sorted�keysr7rCrrB�all�extendr2r4�reversed)r
rrZtables�tableZis_arrayZsection_nameZ
table_keysZ
new_tablesZhas_kvrHrrLrrQs6
 
�r)F)F)Z
__future__rr	rAr=�string�sysZutilsr�pathlibrrE�ImportError�version_infor9r:rFr;rr'r+ZdigitsZ
ascii_lettersr-r2r4rrrrr�<module>s (

site-packages/pip/_vendor/pytoml/__pycache__/writer.cpython-38.opt-1.pyc000064400000007171151446177000022162 0ustar00U

��.e)
�@s�ddlmZddlZddlZddlZddlZddlZddlmZzddl	m
ZWnek
rhdZYnXej
ddkr�eZeZdd	d
�Zddd
ddddd�Zdd�ZejejdZdd�Zdd�Zddd�ZdS)�)�unicode_literalsN�)�format_rfc3339)�PurePath��FcCst��}t|||d�|��S)N)�	sort_keys)�io�StringIO�dump�getvalue)�objr�foutrr�=/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/writer.py�dumpssr�n�r�\�t�b�f�")�
�
r�	��rcs�g�d�����fdd�}d��t��kr���}|dkrT|����dt|�n$t|�dkrx|����dt|���d7�q|�d	d
���d	S)Nrcs"��kr��������dS)Nr)�appendr��i�res�s�startrr�flushsz_escape_string.<locals>.flushz"\

	r� z\u%04xrr�)�lenr�_escapes�ord�join)r!r#�crrr�_escape_strings
r+z-_cCstdd�|D��rt|�S|S)Ncss|]}|tkVqdS�N)�
_key_chars��.0r*rrr�	<genexpr>4sz_escape_id.<locals>.<genexpr>)�anyr+)r!rrr�
_escape_id3sr2cCs
t|t�r|rdSdSt|t�s*t|t�r2t|�St|t�rjt�|�sPt�|�r`t	d�
|���nt|�Sn�t|t�s~t|t�r�t
|�St|tj�r�t|�St|t�r�d�
d�dd�|D���St|t�r�d�
d�d	d�|��D���St|t��r�t
t|��St|��dS)
N�trueZfalsez{0} is not a valid TOML valuez[{0}]z, css|]}t|�VqdSr,)�
_format_value)r/r
rrrr0Hsz _format_value.<locals>.<genexpr>z{{{0}}}css&|]\}}d�t|�t|��VqdS)z{} = {}N)�formatr2r4)r/�kr
rrrr0Js)�
isinstance�bool�int�long�unicode�float�mathZisnanZisinf�
ValueErrorr5�repr�bytesr+�datetimer�listr)�dict�items�_path_types�str�RuntimeError)�vrrrr49s&




r4cs\d|dfg}|�rX|��\�}}�r^d�dd��D��}|rN|�d�|��n|�d�|��|rnt|���n|��}g}d}	|D]��|�}
t|
t�r�|���f|
df�q�t|
t	�r�|
r�t
dd�|
D��r�|���fd	d�|
D��q�|
dk�r|�d
�t����d}	q�|�d�t��t
|
���d}	q�|�t|����sH|	r|r|�d
�qdS)NrF�.css|]}t|�VqdSr,)r2r.rrrr0Wszdump.<locals>.<genexpr>z[[{0}]]
z[{0}]
css|]}t|t�VqdSr,)r7rC)r/�orrrr0dsc3s|]}��f|dfVqdS)TNr)r/�d�r6�namerrr0esz<#{} = null  # To use: uncomment and replace null with value
Tz
{0} = {1}
r)�popr)�writer5�sorted�keysr7rCrrB�all�extendr2r4�reversed)r
rrZtables�tableZis_arrayZsection_nameZ
table_keysZ
new_tablesZhas_kvrHrrLrrQs6
 
�r)F)F)Z
__future__rr	rAr=�string�sysZutilsr�pathlibrrE�ImportError�version_infor9r:rFr;rr'r+ZdigitsZ
ascii_lettersr-r2r4rrrrr�<module>s (

site-packages/pip/_vendor/pytoml/__pycache__/utils.cpython-38.pyc000064400000004121151446177000021037 0ustar00U

��.e��@sHddlZddlZe�d�Zdd�Zdd�Zdd�ZGd	d
�d
ej�ZdS)�NzP(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(\.\d+)?(?:Z|([+-]\d{2}):(\d{2}))cCs(t�|�}|r|�d�|kr dSt|�S)Nr)�
rfc3339_re�match�group�parse_rfc3339_re)�v�m�r�</usr/lib/python3.8/site-packages/pip/_vendor/pytoml/utils.py�
parse_rfc3339s
r
c
Cs�tt|��dd��}|�d�r0t|�d��}nd}|�d�rxt|�d�d�dt|�d�d�}tt�d|d��}ntt�dd��}|\}}}}}}	t�||||||	t|d�|�S)	N��r��
�<�	i@B)�map�int�groupsr�float�	_TimeZone�datetimeZ	timedelta)
r�r�micro�gZtz�y�d�H�M�Srrr	rs

$rcCs�|��}|dk	r t|���dnd}|dkr2d}n.|dkr@d}n
d}|}d�||d|d�}|jrt|�d�|S|�d�|SdS)	Nrr�Z�+�-z{0}{1:02}:{2:02}z%Y-%m-%dT%H:%M:%S.%fz%Y-%m-%dT%H:%M:%S)�	utcoffsetr�
total_seconds�formatZmicrosecond�strftime)rZoffs�suffixrrr	�format_rfc3339sr'c@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
rcCs
||_dS�N��_offset)�self�offsetrrr	�__init__1sz_TimeZone.__init__cCs|jSr(r)�r+�dtrrr	r"4sz_TimeZone.utcoffsetcCsdSr(rr.rrr	�dst7sz
_TimeZone.dstcCsH|j��d}|dkr"d}|}nd}|d}||d}d�|||�S)Nrrr!r z{}{:.02}{:.02})r*r#r$)r+r/r�res�hrrr	�tzname:sz_TimeZone.tznameN)�__name__�
__module__�__qualname__r-r"r0r3rrrr	r0sr)	r�re�compilerr
rr'Ztzinforrrrr	�<module>s
site-packages/pip/_vendor/pytoml/__pycache__/test.cpython-38.opt-1.pyc000064400000002303151446177000021615 0ustar00U

��.e��@sRddlZddlmZzeefZeefZWne	k
rDeZeZYnXdd�Z
dS)�N�)�format_rfc3339cCs�t|t�rdd�|��D�St|t�rTdd�|D�}|rJt|dt�rJ|Sd|d�St|tj�rndt|�d�St|t�r�d	|r�d
ndd�St|t�r�dt|�d�St|t	�r�d
d�
|�d�St|t�r�d|d�Std�
|���dS)NcSsi|]\}}|t|��qS���translate_to_test)�.0�k�vrr�;/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/test.py�
<dictcomp>
sz%translate_to_test.<locals>.<dictcomp>cSsg|]}t|��qSrr)r�xrrr
�
<listcomp>sz%translate_to_test.<locals>.<listcomp>rZarray)�type�value�datetime�bool�trueZfalseZinteger�floatz{:.17}�stringzunexpected value: {!r})
�
isinstance�dict�items�listrrr�
_int_types�strr�format�
_string_types�RuntimeError)r	�arrr
rs$







r)rZutilsrrZunicoder�intZlongr�	NameErrorrrrrr
�<module>s
site-packages/pip/_vendor/pytoml/__pycache__/test.cpython-38.pyc000064400000002303151446177000020656 0ustar00U

��.e��@sRddlZddlmZzeefZeefZWne	k
rDeZeZYnXdd�Z
dS)�N�)�format_rfc3339cCs�t|t�rdd�|��D�St|t�rTdd�|D�}|rJt|dt�rJ|Sd|d�St|tj�rndt|�d�St|t�r�d	|r�d
ndd�St|t�r�dt|�d�St|t	�r�d
d�
|�d�St|t�r�d|d�Std�
|���dS)NcSsi|]\}}|t|��qS���translate_to_test)�.0�k�vrr�;/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/test.py�
<dictcomp>
sz%translate_to_test.<locals>.<dictcomp>cSsg|]}t|��qSrr)r�xrrr
�
<listcomp>sz%translate_to_test.<locals>.<listcomp>rZarray)�type�value�datetime�bool�trueZfalseZinteger�floatz{:.17}�stringzunexpected value: {!r})
�
isinstance�dict�items�listrrr�
_int_types�strr�format�
_string_types�RuntimeError)r	�arrr
rs$







r)rZutilsrrZunicoder�intZlongr�	NameErrorrrrrr
�<module>s
site-packages/pip/_vendor/pytoml/__pycache__/__init__.cpython-38.pyc000064400000000524151446177000021441 0ustar00U

��.e�@s<ddlmZddlmZmZddlmZddlmZm	Z	dS)�)�	TomlError)�load�loads)�translate_to_test)�dump�dumpsN)
Zcorer�parserrrZtestr�writerrr�r
r
�?/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/__init__.py�<module>ssite-packages/pip/_vendor/pytoml/__pycache__/core.cpython-38.opt-1.pyc000064400000001625151446177000021574 0ustar00U

��.e��@sGdd�de�ZdS)c@s$eZdZdd�Zdd�Zdd�ZdS)�	TomlErrorcCs.t�|||||�||_||_||_||_dS)N)�RuntimeError�__init__�message�line�col�filename)�selfrrrr�r	�;/usr/lib/python3.8/site-packages/pip/_vendor/pytoml/core.pyrs
zTomlError.__init__cCsd�|j|j|j|j�S)Nz{}({}, {}): {})�formatrrrr�rr	r	r
�__str__	szTomlError.__str__cCsd�|j|j|j|j�S)Nz!TomlError({!r}, {!r}, {!r}, {!r}))rrrrrrr	r	r
�__repr__szTomlError.__repr__N)�__name__�
__module__�__qualname__rr
rr	r	r	r
rsrN)rrr	r	r	r
�<module>�site-packages/pip/_vendor/pytoml/__init__.py000064400000000177151446177000015157 0ustar00from .core import TomlError
from .parser import load, loads
from .test import translate_to_test
from .writer import dump, dumpssite-packages/pip/_vendor/pytoml/parser.py000064400000024105151446177000014711 0ustar00import re, sys
from .core import TomlError
from .utils import rfc3339_re, parse_rfc3339_re

if sys.version_info[0] == 2:
    _chr = unichr
else:
    _chr = chr

def load(fin, translate=lambda t, x, v: v, object_pairs_hook=dict):
    return loads(fin.read(), translate=translate, object_pairs_hook=object_pairs_hook, filename=getattr(fin, 'name', repr(fin)))

def loads(s, filename='<string>', translate=lambda t, x, v: v, object_pairs_hook=dict):
    if isinstance(s, bytes):
        s = s.decode('utf-8')

    s = s.replace('\r\n', '\n')

    root = object_pairs_hook()
    tables = object_pairs_hook()
    scope = root

    src = _Source(s, filename=filename)
    ast = _p_toml(src, object_pairs_hook=object_pairs_hook)

    def error(msg):
        raise TomlError(msg, pos[0], pos[1], filename)

    def process_value(v, object_pairs_hook):
        kind, text, value, pos = v
        if kind == 'array':
            if value and any(k != value[0][0] for k, t, v, p in value[1:]):
                error('array-type-mismatch')
            value = [process_value(item, object_pairs_hook=object_pairs_hook) for item in value]
        elif kind == 'table':
            value = object_pairs_hook([(k, process_value(value[k], object_pairs_hook=object_pairs_hook)) for k in value])
        return translate(kind, text, value)

    for kind, value, pos in ast:
        if kind == 'kv':
            k, v = value
            if k in scope:
                error('duplicate_keys. Key "{0}" was used more than once.'.format(k))
            scope[k] = process_value(v, object_pairs_hook=object_pairs_hook)
        else:
            is_table_array = (kind == 'table_array')
            cur = tables
            for name in value[:-1]:
                if isinstance(cur.get(name), list):
                    d, cur = cur[name][-1]
                else:
                    d, cur = cur.setdefault(name, (None, object_pairs_hook()))

            scope = object_pairs_hook()
            name = value[-1]
            if name not in cur:
                if is_table_array:
                    cur[name] = [(scope, object_pairs_hook())]
                else:
                    cur[name] = (scope, object_pairs_hook())
            elif isinstance(cur[name], list):
                if not is_table_array:
                    error('table_type_mismatch')
                cur[name].append((scope, object_pairs_hook()))
            else:
                if is_table_array:
                    error('table_type_mismatch')
                old_scope, next_table = cur[name]
                if old_scope is not None:
                    error('duplicate_tables')
                cur[name] = (scope, next_table)

    def merge_tables(scope, tables):
        if scope is None:
            scope = object_pairs_hook()
        for k in tables:
            if k in scope:
                error('key_table_conflict')
            v = tables[k]
            if isinstance(v, list):
                scope[k] = [merge_tables(sc, tbl) for sc, tbl in v]
            else:
                scope[k] = merge_tables(v[0], v[1])
        return scope

    return merge_tables(root, tables)

class _Source:
    def __init__(self, s, filename=None):
        self.s = s
        self._pos = (1, 1)
        self._last = None
        self._filename = filename
        self.backtrack_stack = []

    def last(self):
        return self._last

    def pos(self):
        return self._pos

    def fail(self):
        return self._expect(None)

    def consume_dot(self):
        if self.s:
            self._last = self.s[0]
            self.s = self[1:]
            self._advance(self._last)
            return self._last
        return None

    def expect_dot(self):
        return self._expect(self.consume_dot())

    def consume_eof(self):
        if not self.s:
            self._last = ''
            return True
        return False

    def expect_eof(self):
        return self._expect(self.consume_eof())

    def consume(self, s):
        if self.s.startswith(s):
            self.s = self.s[len(s):]
            self._last = s
            self._advance(s)
            return True
        return False

    def expect(self, s):
        return self._expect(self.consume(s))

    def consume_re(self, re):
        m = re.match(self.s)
        if m:
            self.s = self.s[len(m.group(0)):]
            self._last = m
            self._advance(m.group(0))
            return m
        return None

    def expect_re(self, re):
        return self._expect(self.consume_re(re))

    def __enter__(self):
        self.backtrack_stack.append((self.s, self._pos))

    def __exit__(self, type, value, traceback):
        if type is None:
            self.backtrack_stack.pop()
        else:
            self.s, self._pos = self.backtrack_stack.pop()
        return type == TomlError

    def commit(self):
        self.backtrack_stack[-1] = (self.s, self._pos)

    def _expect(self, r):
        if not r:
            raise TomlError('msg', self._pos[0], self._pos[1], self._filename)
        return r

    def _advance(self, s):
        suffix_pos = s.rfind('\n')
        if suffix_pos == -1:
            self._pos = (self._pos[0], self._pos[1] + len(s))
        else:
            self._pos = (self._pos[0] + s.count('\n'), len(s) - suffix_pos)

_ews_re = re.compile(r'(?:[ \t]|#[^\n]*\n|#[^\n]*\Z|\n)*')
def _p_ews(s):
    s.expect_re(_ews_re)

_ws_re = re.compile(r'[ \t]*')
def _p_ws(s):
    s.expect_re(_ws_re)

_escapes = { 'b': '\b', 'n': '\n', 'r': '\r', 't': '\t', '"': '"',
    '\\': '\\', 'f': '\f' }

_basicstr_re = re.compile(r'[^"\\\000-\037]*')
_short_uni_re = re.compile(r'u([0-9a-fA-F]{4})')
_long_uni_re = re.compile(r'U([0-9a-fA-F]{8})')
_escapes_re = re.compile(r'[btnfr\"\\]')
_newline_esc_re = re.compile('\n[ \t\n]*')
def _p_basicstr_content(s, content=_basicstr_re):
    res = []
    while True:
        res.append(s.expect_re(content).group(0))
        if not s.consume('\\'):
            break
        if s.consume_re(_newline_esc_re):
            pass
        elif s.consume_re(_short_uni_re) or s.consume_re(_long_uni_re):
            v = int(s.last().group(1), 16)
            if 0xd800 <= v < 0xe000:
                s.fail()
            res.append(_chr(v))
        else:
            s.expect_re(_escapes_re)
            res.append(_escapes[s.last().group(0)])
    return ''.join(res)

_key_re = re.compile(r'[0-9a-zA-Z-_]+')
def _p_key(s):
    with s:
        s.expect('"')
        r = _p_basicstr_content(s, _basicstr_re)
        s.expect('"')
        return r
    if s.consume('\''):
        if s.consume('\'\''):
            s.consume('\n')
            r = s.expect_re(_litstr_ml_re).group(0)
            s.expect('\'\'\'')
        else:
            r = s.expect_re(_litstr_re).group(0)
            s.expect('\'')
        return r
    return s.expect_re(_key_re).group(0)

_float_re = re.compile(r'[+-]?(?:0|[1-9](?:_?\d)*)(?:\.\d(?:_?\d)*)?(?:[eE][+-]?(?:\d(?:_?\d)*))?')

_basicstr_ml_re = re.compile(r'(?:""?(?!")|[^"\\\000-\011\013-\037])*')
_litstr_re = re.compile(r"[^'\000\010\012-\037]*")
_litstr_ml_re = re.compile(r"(?:(?:|'|'')(?:[^'\000-\010\013-\037]))*")
def _p_value(s, object_pairs_hook):
    pos = s.pos()

    if s.consume('true'):
        return 'bool', s.last(), True, pos
    if s.consume('false'):
        return 'bool', s.last(), False, pos

    if s.consume('"'):
        if s.consume('""'):
            s.consume('\n')
            r = _p_basicstr_content(s, _basicstr_ml_re)
            s.expect('"""')
        else:
            r = _p_basicstr_content(s, _basicstr_re)
            s.expect('"')
        return 'str', r, r, pos

    if s.consume('\''):
        if s.consume('\'\''):
            s.consume('\n')
            r = s.expect_re(_litstr_ml_re).group(0)
            s.expect('\'\'\'')
        else:
            r = s.expect_re(_litstr_re).group(0)
            s.expect('\'')
        return 'str', r, r, pos

    if s.consume_re(rfc3339_re):
        m = s.last()
        return 'datetime', m.group(0), parse_rfc3339_re(m), pos

    if s.consume_re(_float_re):
        m = s.last().group(0)
        r = m.replace('_','')
        if '.' in m or 'e' in m or 'E' in m:
            return 'float', m, float(r), pos
        else:
            return 'int', m, int(r, 10), pos

    if s.consume('['):
        items = []
        with s:
            while True:
                _p_ews(s)
                items.append(_p_value(s, object_pairs_hook=object_pairs_hook))
                s.commit()
                _p_ews(s)
                s.expect(',')
                s.commit()
        _p_ews(s)
        s.expect(']')
        return 'array', None, items, pos

    if s.consume('{'):
        _p_ws(s)
        items = object_pairs_hook()
        if not s.consume('}'):
            k = _p_key(s)
            _p_ws(s)
            s.expect('=')
            _p_ws(s)
            items[k] = _p_value(s, object_pairs_hook=object_pairs_hook)
            _p_ws(s)
            while s.consume(','):
                _p_ws(s)
                k = _p_key(s)
                _p_ws(s)
                s.expect('=')
                _p_ws(s)
                items[k] = _p_value(s, object_pairs_hook=object_pairs_hook)
                _p_ws(s)
            s.expect('}')
        return 'table', None, items, pos

    s.fail()

def _p_stmt(s, object_pairs_hook):
    pos = s.pos()
    if s.consume(   '['):
        is_array = s.consume('[')
        _p_ws(s)
        keys = [_p_key(s)]
        _p_ws(s)
        while s.consume('.'):
            _p_ws(s)
            keys.append(_p_key(s))
            _p_ws(s)
        s.expect(']')
        if is_array:
            s.expect(']')
        return 'table_array' if is_array else 'table', keys, pos

    key = _p_key(s)
    _p_ws(s)
    s.expect('=')
    _p_ws(s)
    value = _p_value(s, object_pairs_hook=object_pairs_hook)
    return 'kv', (key, value), pos

_stmtsep_re = re.compile(r'(?:[ \t]*(?:#[^\n]*)?\n)+[ \t]*')
def _p_toml(s, object_pairs_hook):
    stmts = []
    _p_ews(s)
    with s:
        stmts.append(_p_stmt(s, object_pairs_hook=object_pairs_hook))
        while True:
            s.commit()
            s.expect_re(_stmtsep_re)
            stmts.append(_p_stmt(s, object_pairs_hook=object_pairs_hook))
    _p_ews(s)
    s.expect_eof()
    return stmts
site-packages/pip/_vendor/pytoml/core.py000064400000000775151446177000014354 0ustar00class TomlError(RuntimeError):
    def __init__(self, message, line, col, filename):
        RuntimeError.__init__(self, message, line, col, filename)
        self.message = message
        self.line = line
        self.col = col
        self.filename = filename

    def __str__(self):
        return '{}({}, {}): {}'.format(self.filename, self.line, self.col, self.message)

    def __repr__(self):
        return 'TomlError({!r}, {!r}, {!r}, {!r})'.format(self.message, self.line, self.col, self.filename)
site-packages/pip/_vendor/pytoml/test.py000064400000001775151446177000014404 0ustar00import datetime
from .utils import format_rfc3339

try:
    _string_types = (str, unicode)
    _int_types = (int, long)
except NameError:
    _string_types = str
    _int_types = int

def translate_to_test(v):
    if isinstance(v, dict):
        return { k: translate_to_test(v) for k, v in v.items() }
    if isinstance(v, list):
        a = [translate_to_test(x) for x in v]
        if v and isinstance(v[0], dict):
            return a
        else:
            return {'type': 'array', 'value': a}
    if isinstance(v, datetime.datetime):
        return {'type': 'datetime', 'value': format_rfc3339(v)}
    if isinstance(v, bool):
        return {'type': 'bool', 'value': 'true' if v else 'false'}
    if isinstance(v, _int_types):
        return {'type': 'integer', 'value': str(v)}
    if isinstance(v, float):
        return {'type': 'float', 'value': '{:.17}'.format(v)}
    if isinstance(v, _string_types):
        return {'type': 'string', 'value': v}
    raise RuntimeError('unexpected value: {!r}'.format(v))
site-packages/pip/_vendor/html5lib/filters/base.py000064400000000436151446177000016174 0ustar00from __future__ import absolute_import, division, unicode_literals


class Filter(object):
    def __init__(self, source):
        self.source = source

    def __iter__(self):
        return iter(self.source)

    def __getattr__(self, name):
        return getattr(self.source, name)
site-packages/pip/_vendor/html5lib/filters/optionaltags.py000064400000024534151446177000017773 0ustar00from __future__ import absolute_import, division, unicode_literals

from . import base


class Filter(base.Filter):
    """Removes optional tags from the token stream"""
    def slider(self):
        previous1 = previous2 = None
        for token in self.source:
            if previous1 is not None:
                yield previous2, previous1, token
            previous2 = previous1
            previous1 = token
        if previous1 is not None:
            yield previous2, previous1, None

    def __iter__(self):
        for previous, token, next in self.slider():
            type = token["type"]
            if type == "StartTag":
                if (token["data"] or
                        not self.is_optional_start(token["name"], previous, next)):
                    yield token
            elif type == "EndTag":
                if not self.is_optional_end(token["name"], next):
                    yield token
            else:
                yield token

    def is_optional_start(self, tagname, previous, next):
        type = next and next["type"] or None
        if tagname in 'html':
            # An html element's start tag may be omitted if the first thing
            # inside the html element is not a space character or a comment.
            return type not in ("Comment", "SpaceCharacters")
        elif tagname == 'head':
            # A head element's start tag may be omitted if the first thing
            # inside the head element is an element.
            # XXX: we also omit the start tag if the head element is empty
            if type in ("StartTag", "EmptyTag"):
                return True
            elif type == "EndTag":
                return next["name"] == "head"
        elif tagname == 'body':
            # A body element's start tag may be omitted if the first thing
            # inside the body element is not a space character or a comment,
            # except if the first thing inside the body element is a script
            # or style element and the node immediately preceding the body
            # element is a head element whose end tag has been omitted.
            if type in ("Comment", "SpaceCharacters"):
                return False
            elif type == "StartTag":
                # XXX: we do not look at the preceding event, so we never omit
                # the body element's start tag if it's followed by a script or
                # a style element.
                return next["name"] not in ('script', 'style')
            else:
                return True
        elif tagname == 'colgroup':
            # A colgroup element's start tag may be omitted if the first thing
            # inside the colgroup element is a col element, and if the element
            # is not immediately preceded by another colgroup element whose
            # end tag has been omitted.
            if type in ("StartTag", "EmptyTag"):
                # XXX: we do not look at the preceding event, so instead we never
                # omit the colgroup element's end tag when it is immediately
                # followed by another colgroup element. See is_optional_end.
                return next["name"] == "col"
            else:
                return False
        elif tagname == 'tbody':
            # A tbody element's start tag may be omitted if the first thing
            # inside the tbody element is a tr element, and if the element is
            # not immediately preceded by a tbody, thead, or tfoot element
            # whose end tag has been omitted.
            if type == "StartTag":
                # omit the thead and tfoot elements' end tag when they are
                # immediately followed by a tbody element. See is_optional_end.
                if previous and previous['type'] == 'EndTag' and \
                        previous['name'] in ('tbody', 'thead', 'tfoot'):
                    return False
                return next["name"] == 'tr'
            else:
                return False
        return False

    def is_optional_end(self, tagname, next):
        type = next and next["type"] or None
        if tagname in ('html', 'head', 'body'):
            # An html element's end tag may be omitted if the html element
            # is not immediately followed by a space character or a comment.
            return type not in ("Comment", "SpaceCharacters")
        elif tagname in ('li', 'optgroup', 'tr'):
            # A li element's end tag may be omitted if the li element is
            # immediately followed by another li element or if there is
            # no more content in the parent element.
            # An optgroup element's end tag may be omitted if the optgroup
            # element is immediately followed by another optgroup element,
            # or if there is no more content in the parent element.
            # A tr element's end tag may be omitted if the tr element is
            # immediately followed by another tr element, or if there is
            # no more content in the parent element.
            if type == "StartTag":
                return next["name"] == tagname
            else:
                return type == "EndTag" or type is None
        elif tagname in ('dt', 'dd'):
            # A dt element's end tag may be omitted if the dt element is
            # immediately followed by another dt element or a dd element.
            # A dd element's end tag may be omitted if the dd element is
            # immediately followed by another dd element or a dt element,
            # or if there is no more content in the parent element.
            if type == "StartTag":
                return next["name"] in ('dt', 'dd')
            elif tagname == 'dd':
                return type == "EndTag" or type is None
            else:
                return False
        elif tagname == 'p':
            # A p element's end tag may be omitted if the p element is
            # immediately followed by an address, article, aside,
            # blockquote, datagrid, dialog, dir, div, dl, fieldset,
            # footer, form, h1, h2, h3, h4, h5, h6, header, hr, menu,
            # nav, ol, p, pre, section, table, or ul, element, or if
            # there is no more content in the parent element.
            if type in ("StartTag", "EmptyTag"):
                return next["name"] in ('address', 'article', 'aside',
                                        'blockquote', 'datagrid', 'dialog',
                                        'dir', 'div', 'dl', 'fieldset', 'footer',
                                        'form', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6',
                                        'header', 'hr', 'menu', 'nav', 'ol',
                                        'p', 'pre', 'section', 'table', 'ul')
            else:
                return type == "EndTag" or type is None
        elif tagname == 'option':
            # An option element's end tag may be omitted if the option
            # element is immediately followed by another option element,
            # or if it is immediately followed by an <code>optgroup</code>
            # element, or if there is no more content in the parent
            # element.
            if type == "StartTag":
                return next["name"] in ('option', 'optgroup')
            else:
                return type == "EndTag" or type is None
        elif tagname in ('rt', 'rp'):
            # An rt element's end tag may be omitted if the rt element is
            # immediately followed by an rt or rp element, or if there is
            # no more content in the parent element.
            # An rp element's end tag may be omitted if the rp element is
            # immediately followed by an rt or rp element, or if there is
            # no more content in the parent element.
            if type == "StartTag":
                return next["name"] in ('rt', 'rp')
            else:
                return type == "EndTag" or type is None
        elif tagname == 'colgroup':
            # A colgroup element's end tag may be omitted if the colgroup
            # element is not immediately followed by a space character or
            # a comment.
            if type in ("Comment", "SpaceCharacters"):
                return False
            elif type == "StartTag":
                # XXX: we also look for an immediately following colgroup
                # element. See is_optional_start.
                return next["name"] != 'colgroup'
            else:
                return True
        elif tagname in ('thead', 'tbody'):
            # A thead element's end tag may be omitted if the thead element
            # is immediately followed by a tbody or tfoot element.
            # A tbody element's end tag may be omitted if the tbody element
            # is immediately followed by a tbody or tfoot element, or if
            # there is no more content in the parent element.
            # A tfoot element's end tag may be omitted if the tfoot element
            # is immediately followed by a tbody element, or if there is no
            # more content in the parent element.
            # XXX: we never omit the end tag when the following element is
            # a tbody. See is_optional_start.
            if type == "StartTag":
                return next["name"] in ['tbody', 'tfoot']
            elif tagname == 'tbody':
                return type == "EndTag" or type is None
            else:
                return False
        elif tagname == 'tfoot':
            # A tfoot element's end tag may be omitted if the tfoot element
            # is immediately followed by a tbody element, or if there is no
            # more content in the parent element.
            # XXX: we never omit the end tag when the following element is
            # a tbody. See is_optional_start.
            if type == "StartTag":
                return next["name"] == 'tbody'
            else:
                return type == "EndTag" or type is None
        elif tagname in ('td', 'th'):
            # A td element's end tag may be omitted if the td element is
            # immediately followed by a td or th element, or if there is
            # no more content in the parent element.
            # A th element's end tag may be omitted if the th element is
            # immediately followed by a td or th element, or if there is
            # no more content in the parent element.
            if type == "StartTag":
                return next["name"] in ('td', 'th')
            else:
                return type == "EndTag" or type is None
        return False
site-packages/pip/_vendor/html5lib/filters/whitespace.py000064400000002276151446177000017422 0ustar00from __future__ import absolute_import, division, unicode_literals

import re

from . import base
from ..constants import rcdataElements, spaceCharacters
spaceCharacters = "".join(spaceCharacters)

SPACES_REGEX = re.compile("[%s]+" % spaceCharacters)


class Filter(base.Filter):
    """Collapses whitespace except in pre, textarea, and script elements"""
    spacePreserveElements = frozenset(["pre", "textarea"] + list(rcdataElements))

    def __iter__(self):
        preserve = 0
        for token in base.Filter.__iter__(self):
            type = token["type"]
            if type == "StartTag" \
                    and (preserve or token["name"] in self.spacePreserveElements):
                preserve += 1

            elif type == "EndTag" and preserve:
                preserve -= 1

            elif not preserve and type == "SpaceCharacters" and token["data"]:
                # Test on token["data"] above to not introduce spaces where there were not
                token["data"] = " "

            elif not preserve and type == "Characters":
                token["data"] = collapse_spaces(token["data"])

            yield token


def collapse_spaces(text):
    return SPACES_REGEX.sub(' ', text)
site-packages/pip/_vendor/html5lib/filters/lint.py000064400000007073151446177000016234 0ustar00from __future__ import absolute_import, division, unicode_literals

from pip._vendor.six import text_type

from . import base
from ..constants import namespaces, voidElements

from ..constants import spaceCharacters
spaceCharacters = "".join(spaceCharacters)


class Filter(base.Filter):
    """Lints the token stream for errors

    If it finds any errors, it'll raise an ``AssertionError``.

    """
    def __init__(self, source, require_matching_tags=True):
        """Creates a Filter

        :arg source: the source token stream

        :arg require_matching_tags: whether or not to require matching tags

        """
        super(Filter, self).__init__(source)
        self.require_matching_tags = require_matching_tags

    def __iter__(self):
        open_elements = []
        for token in base.Filter.__iter__(self):
            type = token["type"]
            if type in ("StartTag", "EmptyTag"):
                namespace = token["namespace"]
                name = token["name"]
                assert namespace is None or isinstance(namespace, text_type)
                assert namespace != ""
                assert isinstance(name, text_type)
                assert name != ""
                assert isinstance(token["data"], dict)
                if (not namespace or namespace == namespaces["html"]) and name in voidElements:
                    assert type == "EmptyTag"
                else:
                    assert type == "StartTag"
                if type == "StartTag" and self.require_matching_tags:
                    open_elements.append((namespace, name))
                for (namespace, name), value in token["data"].items():
                    assert namespace is None or isinstance(namespace, text_type)
                    assert namespace != ""
                    assert isinstance(name, text_type)
                    assert name != ""
                    assert isinstance(value, text_type)

            elif type == "EndTag":
                namespace = token["namespace"]
                name = token["name"]
                assert namespace is None or isinstance(namespace, text_type)
                assert namespace != ""
                assert isinstance(name, text_type)
                assert name != ""
                if (not namespace or namespace == namespaces["html"]) and name in voidElements:
                    assert False, "Void element reported as EndTag token: %(tag)s" % {"tag": name}
                elif self.require_matching_tags:
                    start = open_elements.pop()
                    assert start == (namespace, name)

            elif type == "Comment":
                data = token["data"]
                assert isinstance(data, text_type)

            elif type in ("Characters", "SpaceCharacters"):
                data = token["data"]
                assert isinstance(data, text_type)
                assert data != ""
                if type == "SpaceCharacters":
                    assert data.strip(spaceCharacters) == ""

            elif type == "Doctype":
                name = token["name"]
                assert name is None or isinstance(name, text_type)
                assert token["publicId"] is None or isinstance(name, text_type)
                assert token["systemId"] is None or isinstance(name, text_type)

            elif type == "Entity":
                assert isinstance(token["name"], text_type)

            elif type == "SerializerError":
                assert isinstance(token["data"], text_type)

            else:
                assert False, "Unknown token type: %(type)s" % {"type": type}

            yield token
site-packages/pip/_vendor/html5lib/filters/sanitizer.py000064400000063210151446177000017271 0ustar00from __future__ import absolute_import, division, unicode_literals

import re
from xml.sax.saxutils import escape, unescape

from pip._vendor.six.moves import urllib_parse as urlparse

from . import base
from ..constants import namespaces, prefixes

__all__ = ["Filter"]


allowed_elements = frozenset((
    (namespaces['html'], 'a'),
    (namespaces['html'], 'abbr'),
    (namespaces['html'], 'acronym'),
    (namespaces['html'], 'address'),
    (namespaces['html'], 'area'),
    (namespaces['html'], 'article'),
    (namespaces['html'], 'aside'),
    (namespaces['html'], 'audio'),
    (namespaces['html'], 'b'),
    (namespaces['html'], 'big'),
    (namespaces['html'], 'blockquote'),
    (namespaces['html'], 'br'),
    (namespaces['html'], 'button'),
    (namespaces['html'], 'canvas'),
    (namespaces['html'], 'caption'),
    (namespaces['html'], 'center'),
    (namespaces['html'], 'cite'),
    (namespaces['html'], 'code'),
    (namespaces['html'], 'col'),
    (namespaces['html'], 'colgroup'),
    (namespaces['html'], 'command'),
    (namespaces['html'], 'datagrid'),
    (namespaces['html'], 'datalist'),
    (namespaces['html'], 'dd'),
    (namespaces['html'], 'del'),
    (namespaces['html'], 'details'),
    (namespaces['html'], 'dfn'),
    (namespaces['html'], 'dialog'),
    (namespaces['html'], 'dir'),
    (namespaces['html'], 'div'),
    (namespaces['html'], 'dl'),
    (namespaces['html'], 'dt'),
    (namespaces['html'], 'em'),
    (namespaces['html'], 'event-source'),
    (namespaces['html'], 'fieldset'),
    (namespaces['html'], 'figcaption'),
    (namespaces['html'], 'figure'),
    (namespaces['html'], 'footer'),
    (namespaces['html'], 'font'),
    (namespaces['html'], 'form'),
    (namespaces['html'], 'header'),
    (namespaces['html'], 'h1'),
    (namespaces['html'], 'h2'),
    (namespaces['html'], 'h3'),
    (namespaces['html'], 'h4'),
    (namespaces['html'], 'h5'),
    (namespaces['html'], 'h6'),
    (namespaces['html'], 'hr'),
    (namespaces['html'], 'i'),
    (namespaces['html'], 'img'),
    (namespaces['html'], 'input'),
    (namespaces['html'], 'ins'),
    (namespaces['html'], 'keygen'),
    (namespaces['html'], 'kbd'),
    (namespaces['html'], 'label'),
    (namespaces['html'], 'legend'),
    (namespaces['html'], 'li'),
    (namespaces['html'], 'm'),
    (namespaces['html'], 'map'),
    (namespaces['html'], 'menu'),
    (namespaces['html'], 'meter'),
    (namespaces['html'], 'multicol'),
    (namespaces['html'], 'nav'),
    (namespaces['html'], 'nextid'),
    (namespaces['html'], 'ol'),
    (namespaces['html'], 'output'),
    (namespaces['html'], 'optgroup'),
    (namespaces['html'], 'option'),
    (namespaces['html'], 'p'),
    (namespaces['html'], 'pre'),
    (namespaces['html'], 'progress'),
    (namespaces['html'], 'q'),
    (namespaces['html'], 's'),
    (namespaces['html'], 'samp'),
    (namespaces['html'], 'section'),
    (namespaces['html'], 'select'),
    (namespaces['html'], 'small'),
    (namespaces['html'], 'sound'),
    (namespaces['html'], 'source'),
    (namespaces['html'], 'spacer'),
    (namespaces['html'], 'span'),
    (namespaces['html'], 'strike'),
    (namespaces['html'], 'strong'),
    (namespaces['html'], 'sub'),
    (namespaces['html'], 'sup'),
    (namespaces['html'], 'table'),
    (namespaces['html'], 'tbody'),
    (namespaces['html'], 'td'),
    (namespaces['html'], 'textarea'),
    (namespaces['html'], 'time'),
    (namespaces['html'], 'tfoot'),
    (namespaces['html'], 'th'),
    (namespaces['html'], 'thead'),
    (namespaces['html'], 'tr'),
    (namespaces['html'], 'tt'),
    (namespaces['html'], 'u'),
    (namespaces['html'], 'ul'),
    (namespaces['html'], 'var'),
    (namespaces['html'], 'video'),
    (namespaces['mathml'], 'maction'),
    (namespaces['mathml'], 'math'),
    (namespaces['mathml'], 'merror'),
    (namespaces['mathml'], 'mfrac'),
    (namespaces['mathml'], 'mi'),
    (namespaces['mathml'], 'mmultiscripts'),
    (namespaces['mathml'], 'mn'),
    (namespaces['mathml'], 'mo'),
    (namespaces['mathml'], 'mover'),
    (namespaces['mathml'], 'mpadded'),
    (namespaces['mathml'], 'mphantom'),
    (namespaces['mathml'], 'mprescripts'),
    (namespaces['mathml'], 'mroot'),
    (namespaces['mathml'], 'mrow'),
    (namespaces['mathml'], 'mspace'),
    (namespaces['mathml'], 'msqrt'),
    (namespaces['mathml'], 'mstyle'),
    (namespaces['mathml'], 'msub'),
    (namespaces['mathml'], 'msubsup'),
    (namespaces['mathml'], 'msup'),
    (namespaces['mathml'], 'mtable'),
    (namespaces['mathml'], 'mtd'),
    (namespaces['mathml'], 'mtext'),
    (namespaces['mathml'], 'mtr'),
    (namespaces['mathml'], 'munder'),
    (namespaces['mathml'], 'munderover'),
    (namespaces['mathml'], 'none'),
    (namespaces['svg'], 'a'),
    (namespaces['svg'], 'animate'),
    (namespaces['svg'], 'animateColor'),
    (namespaces['svg'], 'animateMotion'),
    (namespaces['svg'], 'animateTransform'),
    (namespaces['svg'], 'clipPath'),
    (namespaces['svg'], 'circle'),
    (namespaces['svg'], 'defs'),
    (namespaces['svg'], 'desc'),
    (namespaces['svg'], 'ellipse'),
    (namespaces['svg'], 'font-face'),
    (namespaces['svg'], 'font-face-name'),
    (namespaces['svg'], 'font-face-src'),
    (namespaces['svg'], 'g'),
    (namespaces['svg'], 'glyph'),
    (namespaces['svg'], 'hkern'),
    (namespaces['svg'], 'linearGradient'),
    (namespaces['svg'], 'line'),
    (namespaces['svg'], 'marker'),
    (namespaces['svg'], 'metadata'),
    (namespaces['svg'], 'missing-glyph'),
    (namespaces['svg'], 'mpath'),
    (namespaces['svg'], 'path'),
    (namespaces['svg'], 'polygon'),
    (namespaces['svg'], 'polyline'),
    (namespaces['svg'], 'radialGradient'),
    (namespaces['svg'], 'rect'),
    (namespaces['svg'], 'set'),
    (namespaces['svg'], 'stop'),
    (namespaces['svg'], 'svg'),
    (namespaces['svg'], 'switch'),
    (namespaces['svg'], 'text'),
    (namespaces['svg'], 'title'),
    (namespaces['svg'], 'tspan'),
    (namespaces['svg'], 'use'),
))

allowed_attributes = frozenset((
    # HTML attributes
    (None, 'abbr'),
    (None, 'accept'),
    (None, 'accept-charset'),
    (None, 'accesskey'),
    (None, 'action'),
    (None, 'align'),
    (None, 'alt'),
    (None, 'autocomplete'),
    (None, 'autofocus'),
    (None, 'axis'),
    (None, 'background'),
    (None, 'balance'),
    (None, 'bgcolor'),
    (None, 'bgproperties'),
    (None, 'border'),
    (None, 'bordercolor'),
    (None, 'bordercolordark'),
    (None, 'bordercolorlight'),
    (None, 'bottompadding'),
    (None, 'cellpadding'),
    (None, 'cellspacing'),
    (None, 'ch'),
    (None, 'challenge'),
    (None, 'char'),
    (None, 'charoff'),
    (None, 'choff'),
    (None, 'charset'),
    (None, 'checked'),
    (None, 'cite'),
    (None, 'class'),
    (None, 'clear'),
    (None, 'color'),
    (None, 'cols'),
    (None, 'colspan'),
    (None, 'compact'),
    (None, 'contenteditable'),
    (None, 'controls'),
    (None, 'coords'),
    (None, 'data'),
    (None, 'datafld'),
    (None, 'datapagesize'),
    (None, 'datasrc'),
    (None, 'datetime'),
    (None, 'default'),
    (None, 'delay'),
    (None, 'dir'),
    (None, 'disabled'),
    (None, 'draggable'),
    (None, 'dynsrc'),
    (None, 'enctype'),
    (None, 'end'),
    (None, 'face'),
    (None, 'for'),
    (None, 'form'),
    (None, 'frame'),
    (None, 'galleryimg'),
    (None, 'gutter'),
    (None, 'headers'),
    (None, 'height'),
    (None, 'hidefocus'),
    (None, 'hidden'),
    (None, 'high'),
    (None, 'href'),
    (None, 'hreflang'),
    (None, 'hspace'),
    (None, 'icon'),
    (None, 'id'),
    (None, 'inputmode'),
    (None, 'ismap'),
    (None, 'keytype'),
    (None, 'label'),
    (None, 'leftspacing'),
    (None, 'lang'),
    (None, 'list'),
    (None, 'longdesc'),
    (None, 'loop'),
    (None, 'loopcount'),
    (None, 'loopend'),
    (None, 'loopstart'),
    (None, 'low'),
    (None, 'lowsrc'),
    (None, 'max'),
    (None, 'maxlength'),
    (None, 'media'),
    (None, 'method'),
    (None, 'min'),
    (None, 'multiple'),
    (None, 'name'),
    (None, 'nohref'),
    (None, 'noshade'),
    (None, 'nowrap'),
    (None, 'open'),
    (None, 'optimum'),
    (None, 'pattern'),
    (None, 'ping'),
    (None, 'point-size'),
    (None, 'poster'),
    (None, 'pqg'),
    (None, 'preload'),
    (None, 'prompt'),
    (None, 'radiogroup'),
    (None, 'readonly'),
    (None, 'rel'),
    (None, 'repeat-max'),
    (None, 'repeat-min'),
    (None, 'replace'),
    (None, 'required'),
    (None, 'rev'),
    (None, 'rightspacing'),
    (None, 'rows'),
    (None, 'rowspan'),
    (None, 'rules'),
    (None, 'scope'),
    (None, 'selected'),
    (None, 'shape'),
    (None, 'size'),
    (None, 'span'),
    (None, 'src'),
    (None, 'start'),
    (None, 'step'),
    (None, 'style'),
    (None, 'summary'),
    (None, 'suppress'),
    (None, 'tabindex'),
    (None, 'target'),
    (None, 'template'),
    (None, 'title'),
    (None, 'toppadding'),
    (None, 'type'),
    (None, 'unselectable'),
    (None, 'usemap'),
    (None, 'urn'),
    (None, 'valign'),
    (None, 'value'),
    (None, 'variable'),
    (None, 'volume'),
    (None, 'vspace'),
    (None, 'vrml'),
    (None, 'width'),
    (None, 'wrap'),
    (namespaces['xml'], 'lang'),
    # MathML attributes
    (None, 'actiontype'),
    (None, 'align'),
    (None, 'columnalign'),
    (None, 'columnalign'),
    (None, 'columnalign'),
    (None, 'columnlines'),
    (None, 'columnspacing'),
    (None, 'columnspan'),
    (None, 'depth'),
    (None, 'display'),
    (None, 'displaystyle'),
    (None, 'equalcolumns'),
    (None, 'equalrows'),
    (None, 'fence'),
    (None, 'fontstyle'),
    (None, 'fontweight'),
    (None, 'frame'),
    (None, 'height'),
    (None, 'linethickness'),
    (None, 'lspace'),
    (None, 'mathbackground'),
    (None, 'mathcolor'),
    (None, 'mathvariant'),
    (None, 'mathvariant'),
    (None, 'maxsize'),
    (None, 'minsize'),
    (None, 'other'),
    (None, 'rowalign'),
    (None, 'rowalign'),
    (None, 'rowalign'),
    (None, 'rowlines'),
    (None, 'rowspacing'),
    (None, 'rowspan'),
    (None, 'rspace'),
    (None, 'scriptlevel'),
    (None, 'selection'),
    (None, 'separator'),
    (None, 'stretchy'),
    (None, 'width'),
    (None, 'width'),
    (namespaces['xlink'], 'href'),
    (namespaces['xlink'], 'show'),
    (namespaces['xlink'], 'type'),
    # SVG attributes
    (None, 'accent-height'),
    (None, 'accumulate'),
    (None, 'additive'),
    (None, 'alphabetic'),
    (None, 'arabic-form'),
    (None, 'ascent'),
    (None, 'attributeName'),
    (None, 'attributeType'),
    (None, 'baseProfile'),
    (None, 'bbox'),
    (None, 'begin'),
    (None, 'by'),
    (None, 'calcMode'),
    (None, 'cap-height'),
    (None, 'class'),
    (None, 'clip-path'),
    (None, 'color'),
    (None, 'color-rendering'),
    (None, 'content'),
    (None, 'cx'),
    (None, 'cy'),
    (None, 'd'),
    (None, 'dx'),
    (None, 'dy'),
    (None, 'descent'),
    (None, 'display'),
    (None, 'dur'),
    (None, 'end'),
    (None, 'fill'),
    (None, 'fill-opacity'),
    (None, 'fill-rule'),
    (None, 'font-family'),
    (None, 'font-size'),
    (None, 'font-stretch'),
    (None, 'font-style'),
    (None, 'font-variant'),
    (None, 'font-weight'),
    (None, 'from'),
    (None, 'fx'),
    (None, 'fy'),
    (None, 'g1'),
    (None, 'g2'),
    (None, 'glyph-name'),
    (None, 'gradientUnits'),
    (None, 'hanging'),
    (None, 'height'),
    (None, 'horiz-adv-x'),
    (None, 'horiz-origin-x'),
    (None, 'id'),
    (None, 'ideographic'),
    (None, 'k'),
    (None, 'keyPoints'),
    (None, 'keySplines'),
    (None, 'keyTimes'),
    (None, 'lang'),
    (None, 'marker-end'),
    (None, 'marker-mid'),
    (None, 'marker-start'),
    (None, 'markerHeight'),
    (None, 'markerUnits'),
    (None, 'markerWidth'),
    (None, 'mathematical'),
    (None, 'max'),
    (None, 'min'),
    (None, 'name'),
    (None, 'offset'),
    (None, 'opacity'),
    (None, 'orient'),
    (None, 'origin'),
    (None, 'overline-position'),
    (None, 'overline-thickness'),
    (None, 'panose-1'),
    (None, 'path'),
    (None, 'pathLength'),
    (None, 'points'),
    (None, 'preserveAspectRatio'),
    (None, 'r'),
    (None, 'refX'),
    (None, 'refY'),
    (None, 'repeatCount'),
    (None, 'repeatDur'),
    (None, 'requiredExtensions'),
    (None, 'requiredFeatures'),
    (None, 'restart'),
    (None, 'rotate'),
    (None, 'rx'),
    (None, 'ry'),
    (None, 'slope'),
    (None, 'stemh'),
    (None, 'stemv'),
    (None, 'stop-color'),
    (None, 'stop-opacity'),
    (None, 'strikethrough-position'),
    (None, 'strikethrough-thickness'),
    (None, 'stroke'),
    (None, 'stroke-dasharray'),
    (None, 'stroke-dashoffset'),
    (None, 'stroke-linecap'),
    (None, 'stroke-linejoin'),
    (None, 'stroke-miterlimit'),
    (None, 'stroke-opacity'),
    (None, 'stroke-width'),
    (None, 'systemLanguage'),
    (None, 'target'),
    (None, 'text-anchor'),
    (None, 'to'),
    (None, 'transform'),
    (None, 'type'),
    (None, 'u1'),
    (None, 'u2'),
    (None, 'underline-position'),
    (None, 'underline-thickness'),
    (None, 'unicode'),
    (None, 'unicode-range'),
    (None, 'units-per-em'),
    (None, 'values'),
    (None, 'version'),
    (None, 'viewBox'),
    (None, 'visibility'),
    (None, 'width'),
    (None, 'widths'),
    (None, 'x'),
    (None, 'x-height'),
    (None, 'x1'),
    (None, 'x2'),
    (namespaces['xlink'], 'actuate'),
    (namespaces['xlink'], 'arcrole'),
    (namespaces['xlink'], 'href'),
    (namespaces['xlink'], 'role'),
    (namespaces['xlink'], 'show'),
    (namespaces['xlink'], 'title'),
    (namespaces['xlink'], 'type'),
    (namespaces['xml'], 'base'),
    (namespaces['xml'], 'lang'),
    (namespaces['xml'], 'space'),
    (None, 'y'),
    (None, 'y1'),
    (None, 'y2'),
    (None, 'zoomAndPan'),
))

attr_val_is_uri = frozenset((
    (None, 'href'),
    (None, 'src'),
    (None, 'cite'),
    (None, 'action'),
    (None, 'longdesc'),
    (None, 'poster'),
    (None, 'background'),
    (None, 'datasrc'),
    (None, 'dynsrc'),
    (None, 'lowsrc'),
    (None, 'ping'),
    (namespaces['xlink'], 'href'),
    (namespaces['xml'], 'base'),
))

svg_attr_val_allows_ref = frozenset((
    (None, 'clip-path'),
    (None, 'color-profile'),
    (None, 'cursor'),
    (None, 'fill'),
    (None, 'filter'),
    (None, 'marker'),
    (None, 'marker-start'),
    (None, 'marker-mid'),
    (None, 'marker-end'),
    (None, 'mask'),
    (None, 'stroke'),
))

svg_allow_local_href = frozenset((
    (None, 'altGlyph'),
    (None, 'animate'),
    (None, 'animateColor'),
    (None, 'animateMotion'),
    (None, 'animateTransform'),
    (None, 'cursor'),
    (None, 'feImage'),
    (None, 'filter'),
    (None, 'linearGradient'),
    (None, 'pattern'),
    (None, 'radialGradient'),
    (None, 'textpath'),
    (None, 'tref'),
    (None, 'set'),
    (None, 'use')
))

allowed_css_properties = frozenset((
    'azimuth',
    'background-color',
    'border-bottom-color',
    'border-collapse',
    'border-color',
    'border-left-color',
    'border-right-color',
    'border-top-color',
    'clear',
    'color',
    'cursor',
    'direction',
    'display',
    'elevation',
    'float',
    'font',
    'font-family',
    'font-size',
    'font-style',
    'font-variant',
    'font-weight',
    'height',
    'letter-spacing',
    'line-height',
    'overflow',
    'pause',
    'pause-after',
    'pause-before',
    'pitch',
    'pitch-range',
    'richness',
    'speak',
    'speak-header',
    'speak-numeral',
    'speak-punctuation',
    'speech-rate',
    'stress',
    'text-align',
    'text-decoration',
    'text-indent',
    'unicode-bidi',
    'vertical-align',
    'voice-family',
    'volume',
    'white-space',
    'width',
))

allowed_css_keywords = frozenset((
    'auto',
    'aqua',
    'black',
    'block',
    'blue',
    'bold',
    'both',
    'bottom',
    'brown',
    'center',
    'collapse',
    'dashed',
    'dotted',
    'fuchsia',
    'gray',
    'green',
    '!important',
    'italic',
    'left',
    'lime',
    'maroon',
    'medium',
    'none',
    'navy',
    'normal',
    'nowrap',
    'olive',
    'pointer',
    'purple',
    'red',
    'right',
    'solid',
    'silver',
    'teal',
    'top',
    'transparent',
    'underline',
    'white',
    'yellow',
))

allowed_svg_properties = frozenset((
    'fill',
    'fill-opacity',
    'fill-rule',
    'stroke',
    'stroke-width',
    'stroke-linecap',
    'stroke-linejoin',
    'stroke-opacity',
))

allowed_protocols = frozenset((
    'ed2k',
    'ftp',
    'http',
    'https',
    'irc',
    'mailto',
    'news',
    'gopher',
    'nntp',
    'telnet',
    'webcal',
    'xmpp',
    'callto',
    'feed',
    'urn',
    'aim',
    'rsync',
    'tag',
    'ssh',
    'sftp',
    'rtsp',
    'afs',
    'data',
))

allowed_content_types = frozenset((
    'image/png',
    'image/jpeg',
    'image/gif',
    'image/webp',
    'image/bmp',
    'text/plain',
))


data_content_type = re.compile(r'''
                                ^
                                # Match a content type <application>/<type>
                                (?P<content_type>[-a-zA-Z0-9.]+/[-a-zA-Z0-9.]+)
                                # Match any character set and encoding
                                (?:(?:;charset=(?:[-a-zA-Z0-9]+)(?:;(?:base64))?)
                                  |(?:;(?:base64))?(?:;charset=(?:[-a-zA-Z0-9]+))?)
                                # Assume the rest is data
                                ,.*
                                $
                                ''',
                               re.VERBOSE)


class Filter(base.Filter):
    """Sanitizes token stream of XHTML+MathML+SVG and of inline style attributes"""
    def __init__(self,
                 source,
                 allowed_elements=allowed_elements,
                 allowed_attributes=allowed_attributes,
                 allowed_css_properties=allowed_css_properties,
                 allowed_css_keywords=allowed_css_keywords,
                 allowed_svg_properties=allowed_svg_properties,
                 allowed_protocols=allowed_protocols,
                 allowed_content_types=allowed_content_types,
                 attr_val_is_uri=attr_val_is_uri,
                 svg_attr_val_allows_ref=svg_attr_val_allows_ref,
                 svg_allow_local_href=svg_allow_local_href):
        """Creates a Filter

        :arg allowed_elements: set of elements to allow--everything else will
            be escaped

        :arg allowed_attributes: set of attributes to allow in
            elements--everything else will be stripped

        :arg allowed_css_properties: set of CSS properties to allow--everything
            else will be stripped

        :arg allowed_css_keywords: set of CSS keywords to allow--everything
            else will be stripped

        :arg allowed_svg_properties: set of SVG properties to allow--everything
            else will be removed

        :arg allowed_protocols: set of allowed protocols for URIs

        :arg allowed_content_types: set of allowed content types for ``data`` URIs.

        :arg attr_val_is_uri: set of attributes that have URI values--values
            that have a scheme not listed in ``allowed_protocols`` are removed

        :arg svg_attr_val_allows_ref: set of SVG attributes that can have
            references

        :arg svg_allow_local_href: set of SVG elements that can have local
            hrefs--these are removed

        """
        super(Filter, self).__init__(source)
        self.allowed_elements = allowed_elements
        self.allowed_attributes = allowed_attributes
        self.allowed_css_properties = allowed_css_properties
        self.allowed_css_keywords = allowed_css_keywords
        self.allowed_svg_properties = allowed_svg_properties
        self.allowed_protocols = allowed_protocols
        self.allowed_content_types = allowed_content_types
        self.attr_val_is_uri = attr_val_is_uri
        self.svg_attr_val_allows_ref = svg_attr_val_allows_ref
        self.svg_allow_local_href = svg_allow_local_href

    def __iter__(self):
        for token in base.Filter.__iter__(self):
            token = self.sanitize_token(token)
            if token:
                yield token

    # Sanitize the +html+, escaping all elements not in ALLOWED_ELEMENTS, and
    # stripping out all attributes not in ALLOWED_ATTRIBUTES. Style attributes
    # are parsed, and a restricted set, specified by ALLOWED_CSS_PROPERTIES and
    # ALLOWED_CSS_KEYWORDS, are allowed through. attributes in ATTR_VAL_IS_URI
    # are scanned, and only URI schemes specified in ALLOWED_PROTOCOLS are
    # allowed.
    #
    #   sanitize_html('<script> do_nasty_stuff() </script>')
    #    => &lt;script> do_nasty_stuff() &lt;/script>
    #   sanitize_html('<a href="javascript: sucker();">Click here for $100</a>')
    #    => <a>Click here for $100</a>
    def sanitize_token(self, token):

        # accommodate filters which use token_type differently
        token_type = token["type"]
        if token_type in ("StartTag", "EndTag", "EmptyTag"):
            name = token["name"]
            namespace = token["namespace"]
            if ((namespace, name) in self.allowed_elements or
                (namespace is None and
                 (namespaces["html"], name) in self.allowed_elements)):
                return self.allowed_token(token)
            else:
                return self.disallowed_token(token)
        elif token_type == "Comment":
            pass
        else:
            return token

    def allowed_token(self, token):
        if "data" in token:
            attrs = token["data"]
            attr_names = set(attrs.keys())

            # Remove forbidden attributes
            for to_remove in (attr_names - self.allowed_attributes):
                del token["data"][to_remove]
                attr_names.remove(to_remove)

            # Remove attributes with disallowed URL values
            for attr in (attr_names & self.attr_val_is_uri):
                assert attr in attrs
                # I don't have a clue where this regexp comes from or why it matches those
                # characters, nor why we call unescape. I just know it's always been here.
                # Should you be worried by this comment in a sanitizer? Yes. On the other hand, all
                # this will do is remove *more* than it otherwise would.
                val_unescaped = re.sub("[`\x00-\x20\x7f-\xa0\\s]+", '',
                                       unescape(attrs[attr])).lower()
                # remove replacement characters from unescaped characters
                val_unescaped = val_unescaped.replace("\ufffd", "")
                try:
                    uri = urlparse.urlparse(val_unescaped)
                except ValueError:
                    uri = None
                    del attrs[attr]
                if uri and uri.scheme:
                    if uri.scheme not in self.allowed_protocols:
                        del attrs[attr]
                    if uri.scheme == 'data':
                        m = data_content_type.match(uri.path)
                        if not m:
                            del attrs[attr]
                        elif m.group('content_type') not in self.allowed_content_types:
                            del attrs[attr]

            for attr in self.svg_attr_val_allows_ref:
                if attr in attrs:
                    attrs[attr] = re.sub(r'url\s*\(\s*[^#\s][^)]+?\)',
                                         ' ',
                                         unescape(attrs[attr]))
            if (token["name"] in self.svg_allow_local_href and
                (namespaces['xlink'], 'href') in attrs and re.search(r'^\s*[^#\s].*',
                                                                     attrs[(namespaces['xlink'], 'href')])):
                del attrs[(namespaces['xlink'], 'href')]
            if (None, 'style') in attrs:
                attrs[(None, 'style')] = self.sanitize_css(attrs[(None, 'style')])
            token["data"] = attrs
        return token

    def disallowed_token(self, token):
        token_type = token["type"]
        if token_type == "EndTag":
            token["data"] = "</%s>" % token["name"]
        elif token["data"]:
            assert token_type in ("StartTag", "EmptyTag")
            attrs = []
            for (ns, name), v in token["data"].items():
                attrs.append(' %s="%s"' % (name if ns is None else "%s:%s" % (prefixes[ns], name), escape(v)))
            token["data"] = "<%s%s>" % (token["name"], ''.join(attrs))
        else:
            token["data"] = "<%s>" % token["name"]
        if token.get("selfClosing"):
            token["data"] = token["data"][:-1] + "/>"

        token["type"] = "Characters"

        del token["name"]
        return token

    def sanitize_css(self, style):
        # disallow urls
        style = re.compile(r'url\s*\(\s*[^\s)]+?\s*\)\s*').sub(' ', style)

        # gauntlet
        if not re.match(r"""^([:,;#%.\sa-zA-Z0-9!]|\w-\w|'[\s\w]+'|"[\s\w]+"|\([\d,\s]+\))*$""", style):
            return ''
        if not re.match(r"^\s*([-\w]+\s*:[^:;]*(;\s*|$))*$", style):
            return ''

        clean = []
        for prop, value in re.findall(r"([-\w]+)\s*:\s*([^:;]*)", style):
            if not value:
                continue
            if prop.lower() in self.allowed_css_properties:
                clean.append(prop + ': ' + value + ';')
            elif prop.split('-')[0].lower() in ['background', 'border', 'margin',
                                                'padding']:
                for keyword in value.split():
                    if keyword not in self.allowed_css_keywords and \
                            not re.match(r"^(#[0-9a-fA-F]+|rgb\(\d+%?,\d*%?,?\d*%?\)?|\d{0,2}\.?\d{0,2}(cm|em|ex|in|mm|pc|pt|px|%|,|\))?)$", keyword):  # noqa
                        break
                else:
                    clean.append(prop + ': ' + value + ';')
            elif prop.lower() in self.allowed_svg_properties:
                clean.append(prop + ': ' + value + ';')

        return ' '.join(clean)
site-packages/pip/_vendor/html5lib/filters/inject_meta_charset.py000064400000005601151446177000021254 0ustar00from __future__ import absolute_import, division, unicode_literals

from . import base


class Filter(base.Filter):
    """Injects ``<meta charset=ENCODING>`` tag into head of document"""
    def __init__(self, source, encoding):
        """Creates a Filter

        :arg source: the source token stream

        :arg encoding: the encoding to set

        """
        base.Filter.__init__(self, source)
        self.encoding = encoding

    def __iter__(self):
        state = "pre_head"
        meta_found = (self.encoding is None)
        pending = []

        for token in base.Filter.__iter__(self):
            type = token["type"]
            if type == "StartTag":
                if token["name"].lower() == "head":
                    state = "in_head"

            elif type == "EmptyTag":
                if token["name"].lower() == "meta":
                    # replace charset with actual encoding
                    has_http_equiv_content_type = False
                    for (namespace, name), value in token["data"].items():
                        if namespace is not None:
                            continue
                        elif name.lower() == 'charset':
                            token["data"][(namespace, name)] = self.encoding
                            meta_found = True
                            break
                        elif name == 'http-equiv' and value.lower() == 'content-type':
                            has_http_equiv_content_type = True
                    else:
                        if has_http_equiv_content_type and (None, "content") in token["data"]:
                            token["data"][(None, "content")] = 'text/html; charset=%s' % self.encoding
                            meta_found = True

                elif token["name"].lower() == "head" and not meta_found:
                    # insert meta into empty head
                    yield {"type": "StartTag", "name": "head",
                           "data": token["data"]}
                    yield {"type": "EmptyTag", "name": "meta",
                           "data": {(None, "charset"): self.encoding}}
                    yield {"type": "EndTag", "name": "head"}
                    meta_found = True
                    continue

            elif type == "EndTag":
                if token["name"].lower() == "head" and pending:
                    # insert meta into head (if necessary) and flush pending queue
                    yield pending.pop(0)
                    if not meta_found:
                        yield {"type": "EmptyTag", "name": "meta",
                               "data": {(None, "charset"): self.encoding}}
                    while pending:
                        yield pending.pop(0)
                    meta_found = True
                    state = "post_head"

            if state == "in_head":
                pending.append(token)
            else:
                yield token
site-packages/pip/_vendor/html5lib/filters/alphabeticalattributes.py000064400000001627151446177000022005 0ustar00from __future__ import absolute_import, division, unicode_literals

from . import base

from collections import OrderedDict


def _attr_key(attr):
    """Return an appropriate key for an attribute for sorting

    Attributes have a namespace that can be either ``None`` or a string. We
    can't compare the two because they're different types, so we convert
    ``None`` to an empty string first.

    """
    return (attr[0][0] or ''), attr[0][1]


class Filter(base.Filter):
    """Alphabetizes attributes for elements"""
    def __iter__(self):
        for token in base.Filter.__iter__(self):
            if token["type"] in ("StartTag", "EmptyTag"):
                attrs = OrderedDict()
                for name, value in sorted(token["data"].items(),
                                          key=_attr_key):
                    attrs[name] = value
                token["data"] = attrs
            yield token
site-packages/pip/_vendor/html5lib/filters/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000244151446177000024243 0ustar00U

��.e�@sdS)N�rrr�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/__init__.py�<module>�site-packages/pip/_vendor/html5lib/filters/__pycache__/whitespace.cpython-38.pyc000064400000002464151446177000023707 0ustar00U

��.e��@snddlmZmZmZddlZddlmZddlmZm	Z	d�
e	�Z	e�de	�ZGd	d
�d
ej
�Z
dd�ZdS)
�)�absolute_import�division�unicode_literalsN�)�base�)�rcdataElements�spaceCharacters�z[%s]+c@s,eZdZdZeddgee��Zdd�ZdS)�FilterzACollapses whitespace except in pre, textarea, and script elementsZpreZtextareaccs�d}tj�|�D]�}|d}|dkr@|s6|d|jkr@|d7}nP|dkrV|rV|d8}n:|st|dkrt|drtd	|d<n|s�|d
kr�t|d�|d<|VqdS)Nr�typeZStartTag�namerZEndTagZSpaceCharacters�data� Z
Characters)rr�__iter__�spacePreserveElements�collapse_spaces)�selfZpreserve�tokenr�r�K/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/whitespace.pyrs ��


zFilter.__iter__N)	�__name__�
__module__�__qualname__�__doc__�	frozenset�listrrrrrrrrsrcCst�d|�S)Nr)�SPACES_REGEX�sub)�textrrrr%sr)Z
__future__rrr�rer
rZ	constantsrr	�join�compilerrrrrrr�<module>s
site-packages/pip/_vendor/html5lib/filters/__pycache__/lint.cpython-38.opt-1.pyc000064400000003505151446177000023455 0ustar00U

��.e;�@shddlmZmZmZddlmZddlmZddlm	Z	m
Z
ddlmZd�e�ZGd	d
�d
ej
�Z
dS)�)�absolute_import�division�unicode_literals)�	text_type�)�base�)�
namespaces�voidElements)�spaceCharacters�cs*eZdZdZd�fdd�	Zdd�Z�ZS)�FilterzgLints the token stream for errors

    If it finds any errors, it'll raise an ``AssertionError``.

    Tcstt|��|�||_dS)z�Creates a Filter

        :arg source: the source token stream

        :arg require_matching_tags: whether or not to require matching tags

        N)�superr
�__init__�require_matching_tags)�self�sourcer��	__class__��E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/lint.pyrszFilter.__init__c	cs.g}tj�|�D�]}|d}|dkr�|d}|d}|rF|tdkrP|tkrPn|dkrl|jrl|�||f�|d��D]\\}}}qxn�|dkr�|d}|d}|r�|tdkr�|tkr�n|jr�|��}nX|d	kr�|d}nF|d
kr�|d}|dkr�n,|dk�r
|d}n|d
k�rn|dk�r"n|VqdS)N�type)�StartTagZEmptyTag�	namespace�nameZhtmlr�dataZEndTag�Comment)Z
Characters�SpaceCharactersrZDoctypeZEntityZSerializerError)	rr
�__iter__r	r
r�append�items�pop)	rZ
open_elements�tokenrrr�value�startrrrrrsF


zFilter.__iter__)T)�__name__�
__module__�__qualname__�__doc__rr�
__classcell__rrrrr
sr
N)Z
__future__rrrZpip._vendor.sixrrrZ	constantsr	r
r�joinr
rrrr�<module>s
site-packages/pip/_vendor/html5lib/filters/__pycache__/sanitizer.cpython-38.pyc000064400000037615151446177000023571 0ustar00U

��.e�f�D@s>ddlmZmZmZddlZddlmZmZddlm	Z
ddlmZddl
mZmZd	gZeed
dfed
dfed
d
fed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
d fed
d!fed
d"fed
d#fed
d$fed
d%fed
d&fed
d'fed
d(fed
d)fed
d*fed
d+fed
d,fed
d-fed
d.fed
d/fed
d0fed
d1fed
d2fed
d3fed
d4fed
d5fed
d6fed
d7fed
d8fed
d9fed
d:fed
d;fed
d<fed
d=fed
d>fed
d?fed
d@fed
dAfed
dBfed
dCfed
dDfed
dEfed
dFfed
dGfed
dHfed
dIfed
dJfed
dKfed
dLfed
dMfed
dNfed
dOfed
dPfed
dQfed
dRfed
dSfed
dTfed
dUfed
dVfed
dWfed
dXfed
dYfed
dZfed
d[fed
d\fed
d]fed
d^fed
d_fed
d`fed
dafed
dbfed
dcfed
ddfed
defed
dffed
dgfed
dhfed
difed
djfed
dkfed
dlfed
dmfedndofedndpfedndqfedndrfedndsfedndtfedndufedndvfedndwfedndxfedndyfedndzfednd{fednd|fednd}fednd~fedndfednd�fednd�fednd�fednd�fednd�fednd�fednd�fednd�fednd�fednd�fed�dfed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�ff��Zed�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d'�d(�d)�d*�d+�d,�d-�d.�d/�d0�d1�d2�d3�d4�d5�d6�d7e�d8�d9f�d:d��d;�d;�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dFd�d�dG�dH�dI�dJ�dK�dK�dL�dM�dN�dO�dO�dO�dP�dQ�d�dR�dS�dT�dU�dV�d6�d6e�dW�dXfe�dW�dYfe�dW�dZf�d[�d\�d]�d^�d_�d`�da�db�dc�dd�de�df�dg�dhdɐdidːdj�dk�dl�dm�dn�do�dp�dq�d@�drdސds�dt�du�dv�dw�dx�dy�dz�d{�d|�d}�d~�d�d��d��d��d�d�d��d�d�d��d��d��d��d�d�d��d��d��d��d��d��d�d��d�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d(�d��d��d��d,�d��d��d��d��d��d��d��ddÐdĐdŐd6�dƐdǐdȐdɐd�e�dW�d�fe�dW�d�fe�dW�dXfe�dW�d�fe�dW�dYfe�dWd�fe�dW�dZfe�d8�d�fe�d8�d9fe�d8�d�f�dАdѐdҐdӐfC�Zed�d!d�d�d��dd�d�d�d��d
e�dW�dXfe�d8�d�ff
�Ze�dԃZe�dՃZe�dփZe�d׃Ze�d؃Ze�dكZe�dڃZe��d�ej�ZG�d�d	�d	ej�ZdS(��)�absolute_import�division�unicode_literalsN)�escape�unescape)�urllib_parse�)�base�)�
namespaces�prefixes�Filter�html�a�abbrZacronymZaddressZareaZarticleZasideZaudio�bZbigZ
blockquote�brZbuttonZcanvasZcaption�center�cite�code�colZcolgroupZcommandZdatagridZdatalistZdd�delZdetailsZdfnZdialog�dirZdivZdlZdtZemzevent-sourceZfieldsetZ
figcaptionZfigureZfooter�font�form�headerZh1Zh2Zh3Zh4Zh5Zh6Zhr�iZimg�inputZinsZkeygenZkbd�labelZlegendZli�m�mapZmenuZmeterZmulticolZnavZnextidZol�outputZoptgroupZoption�pZpreZprogress�q�sZsampZsectionZselectZsmallZsound�sourceZspacer�spanZstrikeZstrong�subZsup�tableZtbodyZtdZtextarea�timeZtfootZthZtheadZtrZtt�uZul�varZvideoZmathmlZmactionZmathZmerrorZmfrac�miZ
mmultiscriptsZmn�moZmoverZmpaddedZmphantomZmprescriptsZmrootZmrowZmspaceZmsqrtZmstyleZmsubZmsubsupZmsupZmtableZmtdZmtextZmtrZmunderZ
munderover�noneZsvg�animate�animateColor�
animateMotion�animateTransformZclipPathZcircleZdefsZdescZellipsez	font-facezfont-face-namez
font-face-src�gZglyphZhkern�linearGradient�line�markerZmetadataz
missing-glyphZmpath�pathZpolygonZpolyline�radialGradientZrect�set�stopZswitch�text�titleZtspan�use)Nr)NZaccept)Nzaccept-charset)NZ	accesskey)N�action)NZalign)NZalt)NZautocomplete)NZ	autofocus)NZaxis)N�
background)NZbalance)NZbgcolor)NZbgproperties)N�border)NZbordercolor)NZbordercolordark)NZbordercolorlight)NZ
bottompadding)NZcellpadding)NZcellspacing)NZch)NZ	challenge)N�char)NZcharoff)NZchoff)N�charset)N�checked)Nr)N�class)N�clear)N�color)NZcols)NZcolspan)NZcompact)NZcontenteditable)NZcontrols)NZcoords)N�data)NZdatafld)NZdatapagesize)NZdatasrc)NZdatetime)N�default)NZdelay)Nr)NZdisabled)NZ	draggable)NZdynsrc)NZenctype)N�end)NZface)N�for)Nr)N�frame)NZ
galleryimg)NZgutter)NZheaders)N�height)NZ	hidefocus)NZhidden)NZhigh)N�href)NZhreflang)NZhspace)NZicon)N�id)NZ	inputmode)NZismap)NZkeytype)Nr)NZleftspacing)N�lang)N�list)NZlongdesc)NZloop)NZ	loopcount)NZloopend)NZ	loopstart)NZlow)NZlowsrc)N�max)NZ	maxlength)NZmedia)N�method)N�min)NZmultiple)N�name)NZnohref)NZnoshade)N�nowrap)N�open)NZoptimum�N�pattern)NZping)Nz
point-size)NZposter)NZpqg)NZpreload)N�prompt)NZ
radiogroup)N�readonly)NZrel)Nz
repeat-max)Nz
repeat-min)N�replace)NZrequired)NZrev)NZrightspacing)NZrows)NZrowspan)NZrules)NZscope)NZselected)N�shape)N�size)Nr&)N�src)N�start)N�step�N�style)NZsummary)N�suppress)NZtabindex)N�target)N�template)Nr<)NZ
toppadding)N�type)NZunselectable)NZusemap)N�urn)NZvalign)N�value)NZvariable)N�volume)NZvspace)NZvrml)N�width)NZwrapZxmlrO)NZ
actiontype)NZcolumnalign)NZcolumnlines)NZ
columnspacing)NZ
columnspan)N�depth)N�display)NZdisplaystyle)NZequalcolumns)NZ	equalrows)NZfence)NZ	fontstyle)NZ
fontweight)NZ
linethickness)NZlspace)NZmathbackground)NZ	mathcolor)NZmathvariant)N�maxsize)NZminsize)N�other)NZrowalign)NZrowlines)NZ
rowspacing)NZrspace)NZscriptlevel)NZ	selection)NZ	separator)NZstretchy�xlinkrMZshowrf)Nz
accent-height)N�
accumulate)NZadditive)NZ
alphabetic)Nzarabic-form)NZascent)NZ
attributeName)NZ
attributeType)NZbaseProfile)NZbbox)NZbegin)NZby)NZcalcMode)Nz
cap-height�Nz	clip-path)Nzcolor-rendering)NZcontent)NZcx)NZcy)N�d)NZdx)NZdy)NZdescent)NZdur�N�fill)N�fill-opacity)N�	fill-rule)N�font-family)N�	font-size)Nzfont-stretch)N�
font-style)N�font-variant)N�font-weight)N�from)NZfx)NZfy)NZg1)NZg2)Nz
glyph-name)NZ
gradientUnits)NZhanging)Nzhoriz-adv-x)Nzhoriz-origin-x)NZideographic)N�k)NZ	keyPoints)NZ
keySplines)NZkeyTimes�Nz
marker-end�Nz
marker-mid�Nzmarker-start)NZmarkerHeight)NZmarkerUnits)NZmarkerWidth)NZmathematical)N�offset)NZopacity)NZorient)N�origin)Nzoverline-position)Nzoverline-thickness)Nzpanose-1)Nr7)NZ
pathLength)NZpoints)NZpreserveAspectRatio)N�r)NZrefX)NZrefY)NZrepeatCount)NZ	repeatDur)NZrequiredExtensions)NZrequiredFeatures)NZrestart)N�rotate)N�rx)NZry)NZslope)NZstemh)NZstemv)Nz
stop-color)Nzstop-opacity)Nzstrikethrough-position)Nzstrikethrough-thickness�N�stroke)Nzstroke-dasharray)Nzstroke-dashoffset)N�stroke-linecap)N�stroke-linejoin)Nzstroke-miterlimit)N�stroke-opacity)N�stroke-width)NZsystemLanguage)Nztext-anchor)N�to)NZ	transform)NZu1)NZu2)Nzunderline-position)Nzunderline-thickness)NZunicode)Nz
unicode-range)Nzunits-per-em)N�values)N�version)NZviewBox)NZ
visibility)NZwidths)N�x)Nzx-height)NZx1)NZx2ZactuateZarcroleZroler	Zspace)N�y)NZy1)NZy2)NZ
zoomAndPan)rq)Nz
color-profile�N�cursorrs�N�filter)Nr6r�rr~)N�maskr�))NZaltGlyph)Nr/)Nr0)Nr1)Nr2r�)NZfeImager�)Nr4rW)Nr8)NZtextpath)NZtref)Nr9)Nr=).Zazimuthzbackground-colorzborder-bottom-colorzborder-collapsezborder-colorzborder-left-colorzborder-right-colorzborder-top-colorrErFr��	directionrlZ	elevation�floatrrwrxryrzr{rLzletter-spacingzline-heightZoverflow�pausezpause-afterzpause-beforeZpitchzpitch-rangeZrichnessZspeakzspeak-headerz
speak-numeralzspeak-punctuationzspeech-rateZstressz
text-alignztext-decorationztext-indentzunicode-bidizvertical-alignzvoice-familyrizwhite-spacerj)'�autoZaquaZblack�blockZblueZboldZbothZbottomZbrownrZcollapseZdashedZdottedZfuchsiaZgrayZgreenz
!importantZitalic�leftZlimeZmaroonZmediumr.ZnavyZnormalrUZoliveZpointerZpurpleZred�rightZsolidZsilverZteal�topZtransparentZ	underlineZwhiteZyellow)rtrurvr�r�r�r�r�)Zed2kZftpZhttpZhttpsZircZmailtoZnewsZgopherZnntpZtelnetZwebcalZxmppZcalltoZfeedrgZaimZrsync�tagZsshZsftpZrtspZafsrG)z	image/pngz
image/jpegz	image/gifz
image/webpz	image/bmpz
text/plainaL
                                ^
                                # Match a content type <application>/<type>
                                (?P<content_type>[-a-zA-Z0-9.]+/[-a-zA-Z0-9.]+)
                                # Match any character set and encoding
                                (?:(?:;charset=(?:[-a-zA-Z0-9]+)(?:;(?:base64))?)
                                  |(?:;(?:base64))?(?:;charset=(?:[-a-zA-Z0-9]+))?)
                                # Assume the rest is data
                                ,.*
                                $
                                c
s^eZdZdZeeeeee	e
eee
f
�fdd�	Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z�ZS)r
zISanitizes token stream of XHTML+MathML+SVG and of inline style attributescsPtt|��|�||_||_||_||_||_||_||_	|	|_
|
|_||_dS)aSCreates a Filter

        :arg allowed_elements: set of elements to allow--everything else will
            be escaped

        :arg allowed_attributes: set of attributes to allow in
            elements--everything else will be stripped

        :arg allowed_css_properties: set of CSS properties to allow--everything
            else will be stripped

        :arg allowed_css_keywords: set of CSS keywords to allow--everything
            else will be stripped

        :arg allowed_svg_properties: set of SVG properties to allow--everything
            else will be removed

        :arg allowed_protocols: set of allowed protocols for URIs

        :arg allowed_content_types: set of allowed content types for ``data`` URIs.

        :arg attr_val_is_uri: set of attributes that have URI values--values
            that have a scheme not listed in ``allowed_protocols`` are removed

        :arg svg_attr_val_allows_ref: set of SVG attributes that can have
            references

        :arg svg_allow_local_href: set of SVG elements that can have local
            hrefs--these are removed

        N)
�superr
�__init__�allowed_elements�allowed_attributes�allowed_css_properties�allowed_css_keywords�allowed_svg_properties�allowed_protocols�allowed_content_types�attr_val_is_uri�svg_attr_val_allows_ref�svg_allow_local_href)�selfr%r�r�r�r�r�r�r�r�r�r���	__class__��J/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/sanitizer.pyr��s+zFilter.__init__ccs*tj�|�D]}|�|�}|r|VqdS)N)r	r
�__iter__�sanitize_token)r��tokenr�r�r�r��s
zFilter.__iter__cCsp|d}|dkr^|d}|d}||f|jksH|dkrRtd|f|jkrR|�|�S|�|�Sn|dkrhn|SdS)Nrf)�StartTag�EndTag�EmptyTagrT�	namespacer�Comment)r�r�
allowed_token�disallowed_token)r�r��
token_typerTr�r�r�r�r�
s��
zFilter.sanitize_tokenc		Cs�d|k�r�|d}t|���}||jD]}|d|=|�|�q(||j@D]�}||ks\t�t�ddt||���	�}|�
dd�}zt�|�}Wntk
r�d}||=YnX|rL|j
rL|j
|jkr�||=|j
dkrLt�|j�}|s�||=qL|�d�|jkrL||=qL|jD]*}||k�rt�ddt||��||<�q|d|jk�r�td	d
f|k�r�t�d|td	d
f��r�|td	d
f=d|k�r�|�|d�|d<||d<|S)
NrGu
[`- - \s]+�u�Zcontent_typezurl\s*\(\s*[^#\s][^)]+?\)� rTrorMz^\s*[^#\s].*ra)r9�keysr��remover��AssertionError�rer'r�lowerr[�urlparse�
ValueErrorZschemer��data_content_type�matchr7�groupr�r�r�r�search�sanitize_css)	r�r��attrsZ
attr_namesZ	to_remove�attrZ
val_unescapedZurirr�r�r�r�sX


�




����
zFilter.allowed_tokencCs�|d}|dkr"d|d|d<n�|dr�|dks6t�g}|d��D]:\\}}}|�d|dkrd|ndt||ft|�f�qFd	|dd
�|�f|d<nd|d|d<|�d�r�|ddd
�d|d<d|d<|d=|S)Nrfr�z</%s>rTrG)r�r�z %s="%s"z%s:%sz<%s%s>r�z<%s>ZselfClosing���z/>Z
Characters)r��items�appendrr�join�get)r�r�r�r��nsrT�vr�r�r�r�Qs0
zFilter.disallowed_tokencCs�t�d��d|�}t�d|�s"dSt�d|�s2dSg}t�d|�D]�\}}|sPqB|��|jkrv|�|d|d�qB|�d	�d
��dkr�|��D]}||j	kr�t�d|�s�q�q�|�|d|d�qB|��|j
krB|�|d|d�qBd�|�S)
Nzurl\s*\(\s*[^\s)]+?\s*\)\s*r�z@^([:,;#%.\sa-zA-Z0-9!]|\w-\w|'[\s\w]+'|"[\s\w]+"|\([\d,\s]+\))*$r�z ^\s*([-\w]+\s*:[^:;]*(;\s*|$))*$z([-\w]+)\s*:\s*([^:;]*)z: �;�-r)r?r@ZmarginZpaddingz_^(#[0-9a-fA-F]+|rgb\(\d+%?,\d*%?,?\d*%?\)?|\d{0,2}\.?\d{0,2}(cm|em|ex|in|mm|pc|pt|px|%|,|\))?)$)r��compiler'r��findallr�r�r��splitr�r�r�)r�rbZcleanZproprh�keywordr�r�r�r�es*

�zFilter.sanitize_css)�__name__�
__module__�__qualname__�__doc__r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r��
__classcell__r�r�r�r�r
�s"�72) Z
__future__rrrr�Zxml.sax.saxutilsrrZpip._vendor.six.movesrr�r�r	Z	constantsrr�__all__�	frozensetr�r�r�r�r�r�r�r�r�r�r��VERBOSEr�r
r�r�r�r��<module>s
































































































































































��%���K�


1
*



�site-packages/pip/_vendor/html5lib/filters/__pycache__/lint.cpython-38.pyc000064400000005046151446177000022520 0ustar00U

��.e;�@shddlmZmZmZddlmZddlmZddlm	Z	m
Z
ddlmZd�e�ZGd	d
�d
ej
�Z
dS)�)�absolute_import�division�unicode_literals)�	text_type�)�base�)�
namespaces�voidElements)�spaceCharacters�cs*eZdZdZd�fdd�	Zdd�Z�ZS)�FilterzgLints the token stream for errors

    If it finds any errors, it'll raise an ``AssertionError``.

    Tcstt|��|�||_dS)z�Creates a Filter

        :arg source: the source token stream

        :arg require_matching_tags: whether or not to require matching tags

        N)�superr
�__init__�require_matching_tags)�self�sourcer��	__class__��E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/lint.pyrszFilter.__init__c	csDg}tj�|�D�],}|d}|dk�rF|d}|d}|dksNt|t�sNt�|dksZt�t|t�sht�|dkstt�t|dt�s�t�|r�|tdkr�|tkr�|dks�t�n|d	ks�t�|d	kr�|j	r�|�
||f�|d��D]`\\}}}|dk�st|t��st�|dk�st�t|t��s$t�|dk�s2t�t|t�s�t�q�n�|d
k�r|d}|d}|dk�szt|t��szt�|dk�s�t�t|t��s�t�|dk�s�t�|�r�|tdk�r�|tk�r�d�s�tdd
|i��n"|j	�r8|��}|||fk�s8t��n6|dk�r(|d}t|t��s8t��n|dk�rx|d}t|t��sJt�|dk�sXt�|dk�r8|�
t�dk�s8t�n�|dk�r�|d}|dk�s�t|t��s�t�|ddk�s�t|t��s�t�|ddk�s8t|t��s8t�nV|dk�rt|dt��s8t�n6|dk�r"t|dt��s8t�nd�s8tdd|i��|VqdS)N�type)�StartTag�EmptyTag�	namespace�namer�dataZhtmlrrZEndTagFz.Void element reported as EndTag token: %(tag)s�tag�Comment)Z
Characters�SpaceCharactersrZDoctypeZpublicIdZsystemIdZEntityZSerializerErrorzUnknown token type: %(type)s)rr
�__iter__�
isinstancer�AssertionError�dictr	r
r�append�items�pop�stripr)	rZ
open_elements�tokenrrr�value�startrrrrr sl





 

zFilter.__iter__)T)�__name__�
__module__�__qualname__�__doc__rr �
__classcell__rrrrr
sr
N)Z
__future__rrrZpip._vendor.sixrrrZ	constantsr	r
r�joinr
rrrr�<module>s
site-packages/pip/_vendor/html5lib/filters/__pycache__/alphabeticalattributes.cpython-38.pyc000064400000002406151446177000026267 0ustar00U

��.e��@sJddlmZmZmZddlmZddlmZdd�ZGdd�dej	�Z	d	S)
�)�absolute_import�division�unicode_literals�)�base)�OrderedDictcCs|ddpd|ddfS)z�Return an appropriate key for an attribute for sorting

    Attributes have a namespace that can be either ``None`` or a string. We
    can't compare the two because they're different types, so we convert
    ``None`` to an empty string first.

    r�r�)�attrr	r	�W/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/alphabeticalattributes.py�	_attr_keysrc@seZdZdZdd�ZdS)�Filterz$Alphabetizes attributes for elementsccs\tj�|�D]J}|ddkrPt�}t|d��td�D]\}}|||<q6||d<|VqdS)N�type)ZStartTagZEmptyTag�data)�key)rr
�__iter__r�sorted�itemsr)�self�tokenZattrs�name�valuer	r	rrs�
zFilter.__iter__N)�__name__�
__module__�__qualname__�__doc__rr	r	r	rr
sr
N)
Z
__future__rrrrr�collectionsrrr
r	r	r	r�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/base.cpython-38.pyc000064400000001502151446177000022455 0ustar00U

��.e�@s(ddlmZmZmZGdd�de�ZdS)�)�absolute_import�division�unicode_literalsc@s$eZdZdd�Zdd�Zdd�ZdS)�FiltercCs
||_dS�N)�source)�selfr�r	�E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/base.py�__init__szFilter.__init__cCs
t|j�Sr)�iterr)rr	r	r
�__iter__szFilter.__iter__cCst|j|�Sr)�getattrr)r�namer	r	r
�__getattr__szFilter.__getattr__N)�__name__�
__module__�__qualname__rr
rr	r	r	r
rsrN)Z
__future__rrr�objectrr	r	r	r
�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/optionaltags.cpython-38.pyc000064400000005247151446177000024261 0ustar00U

��.e\)�@s6ddlmZmZmZddlmZGdd�dej�ZdS)�)�absolute_import�division�unicode_literals�)�basec@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�Filterz+Removes optional tags from the token streamccsHd}}|jD] }|dk	r&|||fV|}|}q|dk	rD||dfVdS)N)�source)�selfZ	previous1Z	previous2�token�r�M/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/optionaltags.py�sliders
z
Filter.sliderccsp|��D]b\}}}|d}|dkrD|ds<|�|d||�sj|Vq|dkrd|�|d|�sj|Vq|VqdS)N�type�StartTag�data�name�EndTag)r
�is_optional_start�is_optional_end)r	�previousr
�nextrrrr�__iter__s�zFilter.__iter__cCs�|r|dpd}|dkr |dkS|dkrJ|dkr4dS|dkr�|ddkSn�|d	krx|dkr^d
S|dkrr|ddkSdSnb|d
kr�|dkr�|ddkSd
Sn@|dkr�|dkr�|r�|ddkr�|ddkr�d
S|ddkSd
Sd
S)Nr�html��CommentZSpaceCharacters�head�rZEmptyTagTrr�bodyFr)ZscriptZstyle�colgroup�col�tbody)r �thead�tfoot�trr)r	�tagnamerrrrrrrs6
�zFilter.is_optional_startcCs|r|dpd}|dkr |dkS|dkrP|dkr<|d|kS|dkpJ|dkS�n�|dkr�|dkrl|ddkS|d	kr�|dkp�|dkSd
S�np|dkr�|dkr�|dd
kS|dkp�|dkS�n@|dkr�|dkr�|ddkS|dkp�|dkS�n|dk�r |dk�r|ddkS|dk�p|dkSn�|dk�rT|dk�r8d
S|dk�rN|ddkSdSn�|dk�r�|dk�rt|ddkS|dk�r�|dk�p�|dkSd
Snf|dk�r�|dk�r�|ddkS|dk�p�|dkSn2|dk�r�|dk�r�|ddkS|dk�p�|dkSd
S)Nr)rrrr)Zli�optgroupr#rrr)Zdt�ddr&F�pr)ZaddressZarticleZasideZ
blockquoteZdatagridZdialog�dirZdivZdlZfieldsetZfooterZformZh1Zh2Zh3Zh4Zh5Zh6�headerZhrZmenuZnavZolr'ZpreZsection�tableZul�option)r+r%)ZrtZrprT)r!r )r r"r r")ZtdZthr)r	r$rrrrrrXs\












zFilter.is_optional_endN)�__name__�
__module__�__qualname__�__doc__r
rrrrrrrrs


9rN)Z
__future__rrr�rrrrrr�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/inject_meta_charset.cpython-38.opt-1.pyc000064400000003460151446177000026502 0ustar00U

��.e��@s6ddlmZmZmZddlmZGdd�dej�ZdS)�)�absolute_import�division�unicode_literals�)�basec@s eZdZdZdd�Zdd�ZdS)�Filterz=Injects ``<meta charset=ENCODING>`` tag into head of documentcCstj�||�||_dS)ztCreates a Filter

        :arg source: the source token stream

        :arg encoding: the encoding to set

        N)rr�__init__�encoding)�self�sourcer	�r�T/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/inject_meta_charset.pyrszFilter.__init__c
cs�d}|jdk}g}tj�|�D�]�}|d}|dkrL|d��dkrHd}�nd|dk�rJ|d��dkr�d	}|d
��D]X\\}}}	|dk	r�qvqv|��dkr�|j|d
||f<d}q�qv|d
krv|	��dkrvd}qv|r�d|d
kr�d|j|d
d<d}nP|d��dk�r�|�s�dd|d
d�Vddd|jid�Vddd�Vd}qnf|dk�r�|d��dk�r�|�r�|�d�V|�s�ddd|jid�V|�r�|�d�V�q�d}d}|dk�r�|�|�q|VqdS)NZpre_head�typeZStartTag�name�headZin_headZEmptyTag�metaF�data�charsetTz
http-equivzcontent-type)NZcontentztext/html; charset=%s)rrr)NrZEndTag)rrrZ	post_head)r	rr�__iter__�lower�items�pop�append)
r
�stateZ
meta_foundZpending�tokenrZhas_http_equiv_content_type�	namespacer�valuerrr
rs^

��
�
zFilter.__iter__N)�__name__�
__module__�__qualname__�__doc__rrrrrr
rsrN)Z
__future__rrr�rrrrrr
�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/whitespace.cpython-38.opt-1.pyc000064400000002464151446177000024646 0ustar00U

��.e��@snddlmZmZmZddlZddlmZddlmZm	Z	d�
e	�Z	e�de	�ZGd	d
�d
ej
�Z
dd�ZdS)
�)�absolute_import�division�unicode_literalsN�)�base�)�rcdataElements�spaceCharacters�z[%s]+c@s,eZdZdZeddgee��Zdd�ZdS)�FilterzACollapses whitespace except in pre, textarea, and script elementsZpreZtextareaccs�d}tj�|�D]�}|d}|dkr@|s6|d|jkr@|d7}nP|dkrV|rV|d8}n:|st|dkrt|drtd	|d<n|s�|d
kr�t|d�|d<|VqdS)Nr�typeZStartTag�namerZEndTagZSpaceCharacters�data� Z
Characters)rr�__iter__�spacePreserveElements�collapse_spaces)�selfZpreserve�tokenr�r�K/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/whitespace.pyrs ��


zFilter.__iter__N)	�__name__�
__module__�__qualname__�__doc__�	frozenset�listrrrrrrrrsrcCst�d|�S)Nr)�SPACES_REGEX�sub)�textrrrr%sr)Z
__future__rrr�rer
rZ	constantsrr	�join�compilerrrrrrr�<module>s
site-packages/pip/_vendor/html5lib/filters/__pycache__/base.cpython-38.opt-1.pyc000064400000001502151446177000023414 0ustar00U

��.e�@s(ddlmZmZmZGdd�de�ZdS)�)�absolute_import�division�unicode_literalsc@s$eZdZdd�Zdd�Zdd�ZdS)�FiltercCs
||_dS�N)�source)�selfr�r	�E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/base.py�__init__szFilter.__init__cCs
t|j�Sr)�iterr)rr	r	r
�__iter__szFilter.__iter__cCst|j|�Sr)�getattrr)r�namer	r	r
�__getattr__szFilter.__getattr__N)�__name__�
__module__�__qualname__rr
rr	r	r	r
rsrN)Z
__future__rrr�objectrr	r	r	r
�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/optionaltags.cpython-38.opt-1.pyc000064400000005247151446177000025220 0ustar00U

��.e\)�@s6ddlmZmZmZddlmZGdd�dej�ZdS)�)�absolute_import�division�unicode_literals�)�basec@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�Filterz+Removes optional tags from the token streamccsHd}}|jD] }|dk	r&|||fV|}|}q|dk	rD||dfVdS)N)�source)�selfZ	previous1Z	previous2�token�r�M/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/optionaltags.py�sliders
z
Filter.sliderccsp|��D]b\}}}|d}|dkrD|ds<|�|d||�sj|Vq|dkrd|�|d|�sj|Vq|VqdS)N�type�StartTag�data�name�EndTag)r
�is_optional_start�is_optional_end)r	�previousr
�nextrrrr�__iter__s�zFilter.__iter__cCs�|r|dpd}|dkr |dkS|dkrJ|dkr4dS|dkr�|ddkSn�|d	krx|dkr^d
S|dkrr|ddkSdSnb|d
kr�|dkr�|ddkSd
Sn@|dkr�|dkr�|r�|ddkr�|ddkr�d
S|ddkSd
Sd
S)Nr�html��CommentZSpaceCharacters�head�rZEmptyTagTrr�bodyFr)ZscriptZstyle�colgroup�col�tbody)r �thead�tfoot�trr)r	�tagnamerrrrrrrs6
�zFilter.is_optional_startcCs|r|dpd}|dkr |dkS|dkrP|dkr<|d|kS|dkpJ|dkS�n�|dkr�|dkrl|ddkS|d	kr�|dkp�|dkSd
S�np|dkr�|dkr�|dd
kS|dkp�|dkS�n@|dkr�|dkr�|ddkS|dkp�|dkS�n|dk�r |dk�r|ddkS|dk�p|dkSn�|dk�rT|dk�r8d
S|dk�rN|ddkSdSn�|dk�r�|dk�rt|ddkS|dk�r�|dk�p�|dkSd
Snf|dk�r�|dk�r�|ddkS|dk�p�|dkSn2|dk�r�|dk�r�|ddkS|dk�p�|dkSd
S)Nr)rrrr)Zli�optgroupr#rrr)Zdt�ddr&F�pr)ZaddressZarticleZasideZ
blockquoteZdatagridZdialog�dirZdivZdlZfieldsetZfooterZformZh1Zh2Zh3Zh4Zh5Zh6�headerZhrZmenuZnavZolr'ZpreZsection�tableZul�option)r+r%)ZrtZrprT)r!r )r r"r r")ZtdZthr)r	r$rrrrrrXs\












zFilter.is_optional_endN)�__name__�
__module__�__qualname__�__doc__r
rrrrrrrrs


9rN)Z
__future__rrr�rrrrrr�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/sanitizer.cpython-38.opt-1.pyc000064400000037520151446177000024523 0ustar00U

��.e�f�D@s>ddlmZmZmZddlZddlmZmZddlm	Z
ddlmZddl
mZmZd	gZeed
dfed
dfed
d
fed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
dfed
d fed
d!fed
d"fed
d#fed
d$fed
d%fed
d&fed
d'fed
d(fed
d)fed
d*fed
d+fed
d,fed
d-fed
d.fed
d/fed
d0fed
d1fed
d2fed
d3fed
d4fed
d5fed
d6fed
d7fed
d8fed
d9fed
d:fed
d;fed
d<fed
d=fed
d>fed
d?fed
d@fed
dAfed
dBfed
dCfed
dDfed
dEfed
dFfed
dGfed
dHfed
dIfed
dJfed
dKfed
dLfed
dMfed
dNfed
dOfed
dPfed
dQfed
dRfed
dSfed
dTfed
dUfed
dVfed
dWfed
dXfed
dYfed
dZfed
d[fed
d\fed
d]fed
d^fed
d_fed
d`fed
dafed
dbfed
dcfed
ddfed
defed
dffed
dgfed
dhfed
difed
djfed
dkfed
dlfed
dmfedndofedndpfedndqfedndrfedndsfedndtfedndufedndvfedndwfedndxfedndyfedndzfednd{fednd|fednd}fednd~fedndfednd�fednd�fednd�fednd�fednd�fednd�fednd�fednd�fednd�fednd�fed�dfed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�ff��Zed�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d'�d(�d)�d*�d+�d,�d-�d.�d/�d0�d1�d2�d3�d4�d5�d6�d7e�d8�d9f�d:d��d;�d;�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dFd�d�dG�dH�dI�dJ�dK�dK�dL�dM�dN�dO�dO�dO�dP�dQ�d�dR�dS�dT�dU�dV�d6�d6e�dW�dXfe�dW�dYfe�dW�dZf�d[�d\�d]�d^�d_�d`�da�db�dc�dd�de�df�dg�dhdɐdidːdj�dk�dl�dm�dn�do�dp�dq�d@�drdސds�dt�du�dv�dw�dx�dy�dz�d{�d|�d}�d~�d�d��d��d��d�d�d��d�d�d��d��d��d��d�d�d��d��d��d��d��d��d�d��d�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d(�d��d��d��d,�d��d��d��d��d��d��d��ddÐdĐdŐd6�dƐdǐdȐdɐd�e�dW�d�fe�dW�d�fe�dW�dXfe�dW�d�fe�dW�dYfe�dWd�fe�dW�dZfe�d8�d�fe�d8�d9fe�d8�d�f�dАdѐdҐdӐfC�Zed�d!d�d�d��dd�d�d�d��d
e�dW�dXfe�d8�d�ff
�Ze�dԃZe�dՃZe�dփZe�d׃Ze�d؃Ze�dكZe�dڃZe��d�ej�ZG�d�d	�d	ej�ZdS(��)�absolute_import�division�unicode_literalsN)�escape�unescape)�urllib_parse�)�base�)�
namespaces�prefixes�Filter�html�a�abbrZacronymZaddressZareaZarticleZasideZaudio�bZbigZ
blockquote�brZbuttonZcanvasZcaption�center�cite�code�colZcolgroupZcommandZdatagridZdatalistZdd�delZdetailsZdfnZdialog�dirZdivZdlZdtZemzevent-sourceZfieldsetZ
figcaptionZfigureZfooter�font�form�headerZh1Zh2Zh3Zh4Zh5Zh6Zhr�iZimg�inputZinsZkeygenZkbd�labelZlegendZli�m�mapZmenuZmeterZmulticolZnavZnextidZol�outputZoptgroupZoption�pZpreZprogress�q�sZsampZsectionZselectZsmallZsound�sourceZspacer�spanZstrikeZstrong�subZsup�tableZtbodyZtdZtextarea�timeZtfootZthZtheadZtrZtt�uZul�varZvideoZmathmlZmactionZmathZmerrorZmfrac�miZ
mmultiscriptsZmn�moZmoverZmpaddedZmphantomZmprescriptsZmrootZmrowZmspaceZmsqrtZmstyleZmsubZmsubsupZmsupZmtableZmtdZmtextZmtrZmunderZ
munderover�noneZsvg�animate�animateColor�
animateMotion�animateTransformZclipPathZcircleZdefsZdescZellipsez	font-facezfont-face-namez
font-face-src�gZglyphZhkern�linearGradient�line�markerZmetadataz
missing-glyphZmpath�pathZpolygonZpolyline�radialGradientZrect�set�stopZswitch�text�titleZtspan�use)Nr)NZaccept)Nzaccept-charset)NZ	accesskey)N�action)NZalign)NZalt)NZautocomplete)NZ	autofocus)NZaxis)N�
background)NZbalance)NZbgcolor)NZbgproperties)N�border)NZbordercolor)NZbordercolordark)NZbordercolorlight)NZ
bottompadding)NZcellpadding)NZcellspacing)NZch)NZ	challenge)N�char)NZcharoff)NZchoff)N�charset)N�checked)Nr)N�class)N�clear)N�color)NZcols)NZcolspan)NZcompact)NZcontenteditable)NZcontrols)NZcoords)N�data)NZdatafld)NZdatapagesize)NZdatasrc)NZdatetime)N�default)NZdelay)Nr)NZdisabled)NZ	draggable)NZdynsrc)NZenctype)N�end)NZface)N�for)Nr)N�frame)NZ
galleryimg)NZgutter)NZheaders)N�height)NZ	hidefocus)NZhidden)NZhigh)N�href)NZhreflang)NZhspace)NZicon)N�id)NZ	inputmode)NZismap)NZkeytype)Nr)NZleftspacing)N�lang)N�list)NZlongdesc)NZloop)NZ	loopcount)NZloopend)NZ	loopstart)NZlow)NZlowsrc)N�max)NZ	maxlength)NZmedia)N�method)N�min)NZmultiple)N�name)NZnohref)NZnoshade)N�nowrap)N�open)NZoptimum�N�pattern)NZping)Nz
point-size)NZposter)NZpqg)NZpreload)N�prompt)NZ
radiogroup)N�readonly)NZrel)Nz
repeat-max)Nz
repeat-min)N�replace)NZrequired)NZrev)NZrightspacing)NZrows)NZrowspan)NZrules)NZscope)NZselected)N�shape)N�size)Nr&)N�src)N�start)N�step�N�style)NZsummary)N�suppress)NZtabindex)N�target)N�template)Nr<)NZ
toppadding)N�type)NZunselectable)NZusemap)N�urn)NZvalign)N�value)NZvariable)N�volume)NZvspace)NZvrml)N�width)NZwrapZxmlrO)NZ
actiontype)NZcolumnalign)NZcolumnlines)NZ
columnspacing)NZ
columnspan)N�depth)N�display)NZdisplaystyle)NZequalcolumns)NZ	equalrows)NZfence)NZ	fontstyle)NZ
fontweight)NZ
linethickness)NZlspace)NZmathbackground)NZ	mathcolor)NZmathvariant)N�maxsize)NZminsize)N�other)NZrowalign)NZrowlines)NZ
rowspacing)NZrspace)NZscriptlevel)NZ	selection)NZ	separator)NZstretchy�xlinkrMZshowrf)Nz
accent-height)N�
accumulate)NZadditive)NZ
alphabetic)Nzarabic-form)NZascent)NZ
attributeName)NZ
attributeType)NZbaseProfile)NZbbox)NZbegin)NZby)NZcalcMode)Nz
cap-height�Nz	clip-path)Nzcolor-rendering)NZcontent)NZcx)NZcy)N�d)NZdx)NZdy)NZdescent)NZdur�N�fill)N�fill-opacity)N�	fill-rule)N�font-family)N�	font-size)Nzfont-stretch)N�
font-style)N�font-variant)N�font-weight)N�from)NZfx)NZfy)NZg1)NZg2)Nz
glyph-name)NZ
gradientUnits)NZhanging)Nzhoriz-adv-x)Nzhoriz-origin-x)NZideographic)N�k)NZ	keyPoints)NZ
keySplines)NZkeyTimes�Nz
marker-end�Nz
marker-mid�Nzmarker-start)NZmarkerHeight)NZmarkerUnits)NZmarkerWidth)NZmathematical)N�offset)NZopacity)NZorient)N�origin)Nzoverline-position)Nzoverline-thickness)Nzpanose-1)Nr7)NZ
pathLength)NZpoints)NZpreserveAspectRatio)N�r)NZrefX)NZrefY)NZrepeatCount)NZ	repeatDur)NZrequiredExtensions)NZrequiredFeatures)NZrestart)N�rotate)N�rx)NZry)NZslope)NZstemh)NZstemv)Nz
stop-color)Nzstop-opacity)Nzstrikethrough-position)Nzstrikethrough-thickness�N�stroke)Nzstroke-dasharray)Nzstroke-dashoffset)N�stroke-linecap)N�stroke-linejoin)Nzstroke-miterlimit)N�stroke-opacity)N�stroke-width)NZsystemLanguage)Nztext-anchor)N�to)NZ	transform)NZu1)NZu2)Nzunderline-position)Nzunderline-thickness)NZunicode)Nz
unicode-range)Nzunits-per-em)N�values)N�version)NZviewBox)NZ
visibility)NZwidths)N�x)Nzx-height)NZx1)NZx2ZactuateZarcroleZroler	Zspace)N�y)NZy1)NZy2)NZ
zoomAndPan)rq)Nz
color-profile�N�cursorrs�N�filter)Nr6r�rr~)N�maskr�))NZaltGlyph)Nr/)Nr0)Nr1)Nr2r�)NZfeImager�)Nr4rW)Nr8)NZtextpath)NZtref)Nr9)Nr=).Zazimuthzbackground-colorzborder-bottom-colorzborder-collapsezborder-colorzborder-left-colorzborder-right-colorzborder-top-colorrErFr��	directionrlZ	elevation�floatrrwrxryrzr{rLzletter-spacingzline-heightZoverflow�pausezpause-afterzpause-beforeZpitchzpitch-rangeZrichnessZspeakzspeak-headerz
speak-numeralzspeak-punctuationzspeech-rateZstressz
text-alignztext-decorationztext-indentzunicode-bidizvertical-alignzvoice-familyrizwhite-spacerj)'�autoZaquaZblack�blockZblueZboldZbothZbottomZbrownrZcollapseZdashedZdottedZfuchsiaZgrayZgreenz
!importantZitalic�leftZlimeZmaroonZmediumr.ZnavyZnormalrUZoliveZpointerZpurpleZred�rightZsolidZsilverZteal�topZtransparentZ	underlineZwhiteZyellow)rtrurvr�r�r�r�r�)Zed2kZftpZhttpZhttpsZircZmailtoZnewsZgopherZnntpZtelnetZwebcalZxmppZcalltoZfeedrgZaimZrsync�tagZsshZsftpZrtspZafsrG)z	image/pngz
image/jpegz	image/gifz
image/webpz	image/bmpz
text/plainaL
                                ^
                                # Match a content type <application>/<type>
                                (?P<content_type>[-a-zA-Z0-9.]+/[-a-zA-Z0-9.]+)
                                # Match any character set and encoding
                                (?:(?:;charset=(?:[-a-zA-Z0-9]+)(?:;(?:base64))?)
                                  |(?:;(?:base64))?(?:;charset=(?:[-a-zA-Z0-9]+))?)
                                # Assume the rest is data
                                ,.*
                                $
                                c
s^eZdZdZeeeeee	e
eee
f
�fdd�	Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z�ZS)r
zISanitizes token stream of XHTML+MathML+SVG and of inline style attributescsPtt|��|�||_||_||_||_||_||_||_	|	|_
|
|_||_dS)aSCreates a Filter

        :arg allowed_elements: set of elements to allow--everything else will
            be escaped

        :arg allowed_attributes: set of attributes to allow in
            elements--everything else will be stripped

        :arg allowed_css_properties: set of CSS properties to allow--everything
            else will be stripped

        :arg allowed_css_keywords: set of CSS keywords to allow--everything
            else will be stripped

        :arg allowed_svg_properties: set of SVG properties to allow--everything
            else will be removed

        :arg allowed_protocols: set of allowed protocols for URIs

        :arg allowed_content_types: set of allowed content types for ``data`` URIs.

        :arg attr_val_is_uri: set of attributes that have URI values--values
            that have a scheme not listed in ``allowed_protocols`` are removed

        :arg svg_attr_val_allows_ref: set of SVG attributes that can have
            references

        :arg svg_allow_local_href: set of SVG elements that can have local
            hrefs--these are removed

        N)
�superr
�__init__�allowed_elements�allowed_attributes�allowed_css_properties�allowed_css_keywords�allowed_svg_properties�allowed_protocols�allowed_content_types�attr_val_is_uri�svg_attr_val_allows_ref�svg_allow_local_href)�selfr%r�r�r�r�r�r�r�r�r�r���	__class__��J/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/sanitizer.pyr��s+zFilter.__init__ccs*tj�|�D]}|�|�}|r|VqdS)N)r	r
�__iter__�sanitize_token)r��tokenr�r�r�r��s
zFilter.__iter__cCsp|d}|dkr^|d}|d}||f|jksH|dkrRtd|f|jkrR|�|�S|�|�Sn|dkrhn|SdS)Nrf)ZStartTag�EndTagZEmptyTagrT�	namespacer�Comment)r�r�
allowed_token�disallowed_token)r�r��
token_typerTr�r�r�r�r�
s��
zFilter.sanitize_tokenc		Cs�d|k�r�|d}t|���}||jD]}|d|=|�|�q(||j@D]�}t�ddt||����}|�	dd�}zt
�
|�}Wntk
r�d}||=YnX|rL|jrL|j|j
kr�||=|jdkrLt�|j�}|s�||=qL|�d�|jkrL||=qL|jD]*}||k�rt�ddt||��||<�q|d|jk�rvtd	d
f|k�rvt�d|td	d
f��rv|td	d
f=d|k�r�|�|d�|d<||d<|S)
NrGu
[`- - \s]+�u�Zcontent_typezurl\s*\(\s*[^#\s][^)]+?\)� rTrorMz^\s*[^#\s].*ra)r9�keysr��remover��rer'r�lowerr[�urlparse�
ValueErrorZschemer��data_content_type�matchr7�groupr�r�r�r�search�sanitize_css)	r�r��attrsZ
attr_namesZ	to_remove�attrZ
val_unescapedZurirr�r�r�r�sV


�




����
zFilter.allowed_tokencCs�|d}|dkr"d|d|d<n�|dr�g}|d��D]:\\}}}|�d|dkrX|ndt||ft|�f�q:d|dd	�|�f|d<nd
|d|d<|�d�r�|ddd�d
|d<d|d<|d=|S)Nrfr�z</%s>rTrGz %s="%s"z%s:%sz<%s%s>r�z<%s>ZselfClosing���z/>Z
Characters)�items�appendrr�join�get)r�r�r�r��nsrT�vr�r�r�r�Qs0
zFilter.disallowed_tokencCs�t�d��d|�}t�d|�s"dSt�d|�s2dSg}t�d|�D]�\}}|sPqB|��|jkrv|�|d|d�qB|�d	�d
��dkr�|��D]}||j	kr�t�d|�s�q�q�|�|d|d�qB|��|j
krB|�|d|d�qBd�|�S)
Nzurl\s*\(\s*[^\s)]+?\s*\)\s*r�z@^([:,;#%.\sa-zA-Z0-9!]|\w-\w|'[\s\w]+'|"[\s\w]+"|\([\d,\s]+\))*$r�z ^\s*([-\w]+\s*:[^:;]*(;\s*|$))*$z([-\w]+)\s*:\s*([^:;]*)z: �;�-r)r?r@ZmarginZpaddingz_^(#[0-9a-fA-F]+|rgb\(\d+%?,\d*%?,?\d*%?\)?|\d{0,2}\.?\d{0,2}(cm|em|ex|in|mm|pc|pt|px|%|,|\))?)$)r��compiler'r��findallr�r�r��splitr�r�r�)r�rbZcleanZproprh�keywordr�r�r�r�es*

�zFilter.sanitize_css)�__name__�
__module__�__qualname__�__doc__r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r��
__classcell__r�r�r�r�r
�s"�72) Z
__future__rrrr�Zxml.sax.saxutilsrrZpip._vendor.six.movesrr�r�r	Z	constantsrr�__all__�	frozensetr�r�r�r�r�r�r�r�r�r�r��VERBOSEr�r
r�r�r�r��<module>s
































































































































































��%���K�


1
*



�site-packages/pip/_vendor/html5lib/filters/__pycache__/alphabeticalattributes.cpython-38.opt-1.pyc000064400000002406151446177000027226 0ustar00U

��.e��@sJddlmZmZmZddlmZddlmZdd�ZGdd�dej	�Z	d	S)
�)�absolute_import�division�unicode_literals�)�base)�OrderedDictcCs|ddpd|ddfS)z�Return an appropriate key for an attribute for sorting

    Attributes have a namespace that can be either ``None`` or a string. We
    can't compare the two because they're different types, so we convert
    ``None`` to an empty string first.

    r�r�)�attrr	r	�W/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/alphabeticalattributes.py�	_attr_keysrc@seZdZdZdd�ZdS)�Filterz$Alphabetizes attributes for elementsccs\tj�|�D]J}|ddkrPt�}t|d��td�D]\}}|||<q6||d<|VqdS)N�type)ZStartTagZEmptyTag�data)�key)rr
�__iter__r�sorted�itemsr)�self�tokenZattrs�name�valuer	r	rrs�
zFilter.__iter__N)�__name__�
__module__�__qualname__�__doc__rr	r	r	rr
sr
N)
Z
__future__rrrrr�collectionsrrr
r	r	r	r�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/inject_meta_charset.cpython-38.pyc000064400000003460151446177000025543 0ustar00U

��.e��@s6ddlmZmZmZddlmZGdd�dej�ZdS)�)�absolute_import�division�unicode_literals�)�basec@s eZdZdZdd�Zdd�ZdS)�Filterz=Injects ``<meta charset=ENCODING>`` tag into head of documentcCstj�||�||_dS)ztCreates a Filter

        :arg source: the source token stream

        :arg encoding: the encoding to set

        N)rr�__init__�encoding)�self�sourcer	�r�T/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/inject_meta_charset.pyrszFilter.__init__c
cs�d}|jdk}g}tj�|�D�]�}|d}|dkrL|d��dkrHd}�nd|dk�rJ|d��dkr�d	}|d
��D]X\\}}}	|dk	r�qvqv|��dkr�|j|d
||f<d}q�qv|d
krv|	��dkrvd}qv|r�d|d
kr�d|j|d
d<d}nP|d��dk�r�|�s�dd|d
d�Vddd|jid�Vddd�Vd}qnf|dk�r�|d��dk�r�|�r�|�d�V|�s�ddd|jid�V|�r�|�d�V�q�d}d}|dk�r�|�|�q|VqdS)NZpre_head�typeZStartTag�name�headZin_headZEmptyTag�metaF�data�charsetTz
http-equivzcontent-type)NZcontentztext/html; charset=%s)rrr)NrZEndTag)rrrZ	post_head)r	rr�__iter__�lower�items�pop�append)
r
�stateZ
meta_foundZpending�tokenrZhas_http_equiv_content_type�	namespacer�valuerrr
rs^

��
�
zFilter.__iter__N)�__name__�
__module__�__qualname__�__doc__rrrrrr
rsrN)Z
__future__rrr�rrrrrr
�<module>ssite-packages/pip/_vendor/html5lib/filters/__pycache__/__init__.cpython-38.pyc000064400000000244151446177000023304 0ustar00U

��.e�@sdS)N�rrr�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/filters/__init__.py�<module>�site-packages/pip/_vendor/html5lib/filters/__init__.py000064400000000000151446177000017004 0ustar00site-packages/pip/_vendor/html5lib/treeadapters/genshi.py000064400000003263151446177000017553 0ustar00from __future__ import absolute_import, division, unicode_literals

from genshi.core import QName, Attrs
from genshi.core import START, END, TEXT, COMMENT, DOCTYPE


def to_genshi(walker):
    """Convert a tree to a genshi tree

    :arg walker: the treewalker to use to walk the tree to convert it

    :returns: generator of genshi nodes

    """
    text = []
    for token in walker:
        type = token["type"]
        if type in ("Characters", "SpaceCharacters"):
            text.append(token["data"])
        elif text:
            yield TEXT, "".join(text), (None, -1, -1)
            text = []

        if type in ("StartTag", "EmptyTag"):
            if token["namespace"]:
                name = "{%s}%s" % (token["namespace"], token["name"])
            else:
                name = token["name"]
            attrs = Attrs([(QName("{%s}%s" % attr if attr[0] is not None else attr[1]), value)
                           for attr, value in token["data"].items()])
            yield (START, (QName(name), attrs), (None, -1, -1))
            if type == "EmptyTag":
                type = "EndTag"

        if type == "EndTag":
            if token["namespace"]:
                name = "{%s}%s" % (token["namespace"], token["name"])
            else:
                name = token["name"]

            yield END, QName(name), (None, -1, -1)

        elif type == "Comment":
            yield COMMENT, token["data"], (None, -1, -1)

        elif type == "Doctype":
            yield DOCTYPE, (token["name"], token["publicId"],
                            token["systemId"]), (None, -1, -1)

        else:
            pass  # FIXME: What to do?

    if text:
        yield TEXT, "".join(text), (None, -1, -1)
site-packages/pip/_vendor/html5lib/treeadapters/sax.py000064400000003360151446177000017067 0ustar00from __future__ import absolute_import, division, unicode_literals

from xml.sax.xmlreader import AttributesNSImpl

from ..constants import adjustForeignAttributes, unadjustForeignAttributes

prefix_mapping = {}
for prefix, localName, namespace in adjustForeignAttributes.values():
    if prefix is not None:
        prefix_mapping[prefix] = namespace


def to_sax(walker, handler):
    """Call SAX-like content handler based on treewalker walker

    :arg walker: the treewalker to use to walk the tree to convert it

    :arg handler: SAX handler to use

    """
    handler.startDocument()
    for prefix, namespace in prefix_mapping.items():
        handler.startPrefixMapping(prefix, namespace)

    for token in walker:
        type = token["type"]
        if type == "Doctype":
            continue
        elif type in ("StartTag", "EmptyTag"):
            attrs = AttributesNSImpl(token["data"],
                                     unadjustForeignAttributes)
            handler.startElementNS((token["namespace"], token["name"]),
                                   token["name"],
                                   attrs)
            if type == "EmptyTag":
                handler.endElementNS((token["namespace"], token["name"]),
                                     token["name"])
        elif type == "EndTag":
            handler.endElementNS((token["namespace"], token["name"]),
                                 token["name"])
        elif type in ("Characters", "SpaceCharacters"):
            handler.characters(token["data"])
        elif type == "Comment":
            pass
        else:
            assert False, "Unknown token type"

    for prefix, namespace in prefix_mapping.items():
        handler.endPrefixMapping(prefix)
    handler.endDocument()
site-packages/pip/_vendor/html5lib/treeadapters/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001607151446177000025262 0ustar00U

��.e��@s^dZddlmZmZmZddlmZdgZzddlmZWne	k
rNYnXe�
d�dS)	a�Tree adapters let you convert from one tree structure to another

Example:

.. code-block:: python

   from pip._vendor import html5lib
   from pip._vendor.html5lib.treeadapters import genshi

   doc = '<html><body>Hi!</body></html>'
   treebuilder = html5lib.getTreeBuilder('etree')
   parser = html5lib.HTMLParser(tree=treebuilder)
   tree = parser.parse(doc)
   TreeWalker = html5lib.getTreeWalker('etree')

   genshi_tree = genshi.to_genshi(TreeWalker(tree))

�)�absolute_import�division�unicode_literals�)�saxr)�genshirN)�__doc__Z
__future__rrr�r�__all__r�ImportError�append�r
r
�N/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treeadapters/__init__.py�<module>ssite-packages/pip/_vendor/html5lib/treeadapters/__pycache__/genshi.cpython-38.opt-1.pyc000064400000002745151446177000025004 0ustar00U

��.e��@sLddlmZmZmZddlmZmZddlmZmZm	Z	m
Z
mZdd�ZdS)�)�absolute_import�division�unicode_literals)�QName�Attrs)�START�END�TEXT�COMMENT�DOCTYPEccsRg}|D�]*}|d}|dkr.|�|d�n|rHtd�|�dfVg}|dkr�|drnd|d|d	f}n|d	}td
d�|d��D��}tt|�|fdfV|dkr�d
}|d
kr�|dr�d|d|d	f}n|d	}tt|�dfVq|dk�rt|ddfVq|dkrt	|d	|d|dfdfVqq|�rNtd�|�dfVdS)z�Convert a tree to a genshi tree

    :arg walker: the treewalker to use to walk the tree to convert it

    :returns: generator of genshi nodes

    �type)Z
CharactersZSpaceCharacters�data�)N���r)ZStartTag�EmptyTag�	namespace�{%s}%s�namecSs4g|],\}}t|ddk	r"d|n|d�|f�qS)rNr�)r)�.0�attr�value�r�L/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treeadapters/genshi.py�
<listcomp>s�zto_genshi.<locals>.<listcomp>rZEndTag�CommentZDoctypeZpublicIdZsystemIdN)
�appendr	�joinr�itemsrrrr
r)Zwalker�text�tokenrrZattrsrrr�	to_genshisD

�
��r!N)
Z
__future__rrrZgenshi.corerrrrr	r
rr!rrrr�<module>ssite-packages/pip/_vendor/html5lib/treeadapters/__pycache__/sax.cpython-38.opt-1.pyc000064400000002563151446177000024320 0ustar00U

��.e��@sdddlmZmZmZddlmZddlmZmZiZ	e�
�D]\ZZZ
edk	r<e
e	e<q<dd�ZdS)�)�absolute_import�division�unicode_literals)�AttributesNSImpl�)�adjustForeignAttributes�unadjustForeignAttributesNcCs|��t��D]\}}|�||�q|D]�}|d}|dkrBq*q*|dkr�t|dt�}|�|d|df|d|�|dkr�|�|d|df|d�q*|dkr�|�|d|df|d�q*|d	kr�|�|d�q*|d
kr*q*q*t��D]\}}|�	|�q�|�
�dS)z�Call SAX-like content handler based on treewalker walker

    :arg walker: the treewalker to use to walk the tree to convert it

    :arg handler: SAX handler to use

    �typeZDoctype)ZStartTag�EmptyTag�data�	namespace�namer
ZEndTag)Z
CharactersZSpaceCharacters�CommentN)Z
startDocument�prefix_mapping�itemsZstartPrefixMappingrrZstartElementNSZendElementNSZ
charactersZendPrefixMappingZendDocument)ZwalkerZhandler�prefixr�tokenr	Zattrs�r�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treeadapters/sax.py�to_sax
s>����r)Z
__future__rrrZxml.sax.xmlreaderrZ	constantsrrr�valuesrZ	localNamerrrrrr�<module>s
site-packages/pip/_vendor/html5lib/treeadapters/__pycache__/genshi.cpython-38.pyc000064400000002745151446177000024045 0ustar00U

��.e��@sLddlmZmZmZddlmZmZddlmZmZm	Z	m
Z
mZdd�ZdS)�)�absolute_import�division�unicode_literals)�QName�Attrs)�START�END�TEXT�COMMENT�DOCTYPEccsRg}|D�]*}|d}|dkr.|�|d�n|rHtd�|�dfVg}|dkr�|drnd|d|d	f}n|d	}td
d�|d��D��}tt|�|fdfV|dkr�d
}|d
kr�|dr�d|d|d	f}n|d	}tt|�dfVq|dk�rt|ddfVq|dkrt	|d	|d|dfdfVqq|�rNtd�|�dfVdS)z�Convert a tree to a genshi tree

    :arg walker: the treewalker to use to walk the tree to convert it

    :returns: generator of genshi nodes

    �type)Z
CharactersZSpaceCharacters�data�)N���r)ZStartTag�EmptyTag�	namespace�{%s}%s�namecSs4g|],\}}t|ddk	r"d|n|d�|f�qS)rNr�)r)�.0�attr�value�r�L/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treeadapters/genshi.py�
<listcomp>s�zto_genshi.<locals>.<listcomp>rZEndTag�CommentZDoctypeZpublicIdZsystemIdN)
�appendr	�joinr�itemsrrrr
r)Zwalker�text�tokenrrZattrsrrr�	to_genshisD

�
��r!N)
Z
__future__rrrZgenshi.corerrrrr	r
rr!rrrr�<module>ssite-packages/pip/_vendor/html5lib/treeadapters/__pycache__/sax.cpython-38.pyc000064400000002644151446177000023361 0ustar00U

��.e��@sdddlmZmZmZddlmZddlmZmZiZ	e�
�D]\ZZZ
edk	r<e
e	e<q<dd�ZdS)�)�absolute_import�division�unicode_literals)�AttributesNSImpl�)�adjustForeignAttributes�unadjustForeignAttributesNcCs|��t��D]\}}|�||�q|D]�}|d}|dkrBq*q*|dkr�t|dt�}|�|d|df|d|�|dkr�|�|d|df|d�q*|dkr�|�|d|df|d�q*|d	kr�|�|d�q*|d
kr�q*ds*t	d��q*t��D]\}}|�
|�q�|��d
S)z�Call SAX-like content handler based on treewalker walker

    :arg walker: the treewalker to use to walk the tree to convert it

    :arg handler: SAX handler to use

    �typeZDoctype)ZStartTag�EmptyTag�data�	namespace�namer
ZEndTag)Z
CharactersZSpaceCharacters�CommentFzUnknown token typeN)Z
startDocument�prefix_mapping�itemsZstartPrefixMappingrrZstartElementNSZendElementNSZ
characters�AssertionErrorZendPrefixMappingZendDocument)ZwalkerZhandler�prefixr�tokenr	Zattrs�r�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treeadapters/sax.py�to_sax
s>����r)Z
__future__rrrZxml.sax.xmlreaderrZ	constantsrrr�valuesrZ	localNamerrrrrr�<module>s
site-packages/pip/_vendor/html5lib/treeadapters/__pycache__/__init__.cpython-38.pyc000064400000001607151446177000024323 0ustar00U

��.e��@s^dZddlmZmZmZddlmZdgZzddlmZWne	k
rNYnXe�
d�dS)	a�Tree adapters let you convert from one tree structure to another

Example:

.. code-block:: python

   from pip._vendor import html5lib
   from pip._vendor.html5lib.treeadapters import genshi

   doc = '<html><body>Hi!</body></html>'
   treebuilder = html5lib.getTreeBuilder('etree')
   parser = html5lib.HTMLParser(tree=treebuilder)
   tree = parser.parse(doc)
   TreeWalker = html5lib.getTreeWalker('etree')

   genshi_tree = genshi.to_genshi(TreeWalker(tree))

�)�absolute_import�division�unicode_literals�)�saxr)�genshirN)�__doc__Z
__future__rrr�r�__all__r�ImportError�append�r
r
�N/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treeadapters/__init__.py�<module>ssite-packages/pip/_vendor/html5lib/treeadapters/__init__.py000064400000001247151446177000020035 0ustar00"""Tree adapters let you convert from one tree structure to another

Example:

.. code-block:: python

   from pip._vendor import html5lib
   from pip._vendor.html5lib.treeadapters import genshi

   doc = '<html><body>Hi!</body></html>'
   treebuilder = html5lib.getTreeBuilder('etree')
   parser = html5lib.HTMLParser(tree=treebuilder)
   tree = parser.parse(doc)
   TreeWalker = html5lib.getTreeWalker('etree')

   genshi_tree = genshi.to_genshi(TreeWalker(tree))

"""
from __future__ import absolute_import, division, unicode_literals

from . import sax

__all__ = ["sax"]

try:
    from . import genshi  # noqa
except ImportError:
    pass
else:
    __all__.append("genshi")
site-packages/pip/_vendor/html5lib/_inputstream.py000064400000077450151446177000016336 0ustar00from __future__ import absolute_import, division, unicode_literals

from pip._vendor.six import text_type, binary_type
from pip._vendor.six.moves import http_client, urllib

import codecs
import re

from pip._vendor import webencodings

from .constants import EOF, spaceCharacters, asciiLetters, asciiUppercase
from .constants import _ReparseException
from . import _utils

from io import StringIO

try:
    from io import BytesIO
except ImportError:
    BytesIO = StringIO

# Non-unicode versions of constants for use in the pre-parser
spaceCharactersBytes = frozenset([item.encode("ascii") for item in spaceCharacters])
asciiLettersBytes = frozenset([item.encode("ascii") for item in asciiLetters])
asciiUppercaseBytes = frozenset([item.encode("ascii") for item in asciiUppercase])
spacesAngleBrackets = spaceCharactersBytes | frozenset([b">", b"<"])


invalid_unicode_no_surrogate = "[\u0001-\u0008\u000B\u000E-\u001F\u007F-\u009F\uFDD0-\uFDEF\uFFFE\uFFFF\U0001FFFE\U0001FFFF\U0002FFFE\U0002FFFF\U0003FFFE\U0003FFFF\U0004FFFE\U0004FFFF\U0005FFFE\U0005FFFF\U0006FFFE\U0006FFFF\U0007FFFE\U0007FFFF\U0008FFFE\U0008FFFF\U0009FFFE\U0009FFFF\U000AFFFE\U000AFFFF\U000BFFFE\U000BFFFF\U000CFFFE\U000CFFFF\U000DFFFE\U000DFFFF\U000EFFFE\U000EFFFF\U000FFFFE\U000FFFFF\U0010FFFE\U0010FFFF]"  # noqa

if _utils.supports_lone_surrogates:
    # Use one extra step of indirection and create surrogates with
    # eval. Not using this indirection would introduce an illegal
    # unicode literal on platforms not supporting such lone
    # surrogates.
    assert invalid_unicode_no_surrogate[-1] == "]" and invalid_unicode_no_surrogate.count("]") == 1
    invalid_unicode_re = re.compile(invalid_unicode_no_surrogate[:-1] +
                                    eval('"\\uD800-\\uDFFF"') +  # pylint:disable=eval-used
                                    "]")
else:
    invalid_unicode_re = re.compile(invalid_unicode_no_surrogate)

non_bmp_invalid_codepoints = set([0x1FFFE, 0x1FFFF, 0x2FFFE, 0x2FFFF, 0x3FFFE,
                                  0x3FFFF, 0x4FFFE, 0x4FFFF, 0x5FFFE, 0x5FFFF,
                                  0x6FFFE, 0x6FFFF, 0x7FFFE, 0x7FFFF, 0x8FFFE,
                                  0x8FFFF, 0x9FFFE, 0x9FFFF, 0xAFFFE, 0xAFFFF,
                                  0xBFFFE, 0xBFFFF, 0xCFFFE, 0xCFFFF, 0xDFFFE,
                                  0xDFFFF, 0xEFFFE, 0xEFFFF, 0xFFFFE, 0xFFFFF,
                                  0x10FFFE, 0x10FFFF])

ascii_punctuation_re = re.compile("[\u0009-\u000D\u0020-\u002F\u003A-\u0040\u005C\u005B-\u0060\u007B-\u007E]")

# Cache for charsUntil()
charsUntilRegEx = {}


class BufferedStream(object):
    """Buffering for streams that do not have buffering of their own

    The buffer is implemented as a list of chunks on the assumption that
    joining many strings will be slow since it is O(n**2)
    """

    def __init__(self, stream):
        self.stream = stream
        self.buffer = []
        self.position = [-1, 0]  # chunk number, offset

    def tell(self):
        pos = 0
        for chunk in self.buffer[:self.position[0]]:
            pos += len(chunk)
        pos += self.position[1]
        return pos

    def seek(self, pos):
        assert pos <= self._bufferedBytes()
        offset = pos
        i = 0
        while len(self.buffer[i]) < offset:
            offset -= len(self.buffer[i])
            i += 1
        self.position = [i, offset]

    def read(self, bytes):
        if not self.buffer:
            return self._readStream(bytes)
        elif (self.position[0] == len(self.buffer) and
              self.position[1] == len(self.buffer[-1])):
            return self._readStream(bytes)
        else:
            return self._readFromBuffer(bytes)

    def _bufferedBytes(self):
        return sum([len(item) for item in self.buffer])

    def _readStream(self, bytes):
        data = self.stream.read(bytes)
        self.buffer.append(data)
        self.position[0] += 1
        self.position[1] = len(data)
        return data

    def _readFromBuffer(self, bytes):
        remainingBytes = bytes
        rv = []
        bufferIndex = self.position[0]
        bufferOffset = self.position[1]
        while bufferIndex < len(self.buffer) and remainingBytes != 0:
            assert remainingBytes > 0
            bufferedData = self.buffer[bufferIndex]

            if remainingBytes <= len(bufferedData) - bufferOffset:
                bytesToRead = remainingBytes
                self.position = [bufferIndex, bufferOffset + bytesToRead]
            else:
                bytesToRead = len(bufferedData) - bufferOffset
                self.position = [bufferIndex, len(bufferedData)]
                bufferIndex += 1
            rv.append(bufferedData[bufferOffset:bufferOffset + bytesToRead])
            remainingBytes -= bytesToRead

            bufferOffset = 0

        if remainingBytes:
            rv.append(self._readStream(remainingBytes))

        return b"".join(rv)


def HTMLInputStream(source, **kwargs):
    # Work around Python bug #20007: read(0) closes the connection.
    # http://bugs.python.org/issue20007
    if (isinstance(source, http_client.HTTPResponse) or
        # Also check for addinfourl wrapping HTTPResponse
        (isinstance(source, urllib.response.addbase) and
         isinstance(source.fp, http_client.HTTPResponse))):
        isUnicode = False
    elif hasattr(source, "read"):
        isUnicode = isinstance(source.read(0), text_type)
    else:
        isUnicode = isinstance(source, text_type)

    if isUnicode:
        encodings = [x for x in kwargs if x.endswith("_encoding")]
        if encodings:
            raise TypeError("Cannot set an encoding with a unicode input, set %r" % encodings)

        return HTMLUnicodeInputStream(source, **kwargs)
    else:
        return HTMLBinaryInputStream(source, **kwargs)


class HTMLUnicodeInputStream(object):
    """Provides a unicode stream of characters to the HTMLTokenizer.

    This class takes care of character encoding and removing or replacing
    incorrect byte-sequences and also provides column and line tracking.

    """

    _defaultChunkSize = 10240

    def __init__(self, source):
        """Initialises the HTMLInputStream.

        HTMLInputStream(source, [encoding]) -> Normalized stream from source
        for use by html5lib.

        source can be either a file-object, local filename or a string.

        The optional encoding parameter must be a string that indicates
        the encoding.  If specified, that encoding will be used,
        regardless of any BOM or later declaration (such as in a meta
        element)

        """

        if not _utils.supports_lone_surrogates:
            # Such platforms will have already checked for such
            # surrogate errors, so no need to do this checking.
            self.reportCharacterErrors = None
        elif len("\U0010FFFF") == 1:
            self.reportCharacterErrors = self.characterErrorsUCS4
        else:
            self.reportCharacterErrors = self.characterErrorsUCS2

        # List of where new lines occur
        self.newLines = [0]

        self.charEncoding = (lookupEncoding("utf-8"), "certain")
        self.dataStream = self.openStream(source)

        self.reset()

    def reset(self):
        self.chunk = ""
        self.chunkSize = 0
        self.chunkOffset = 0
        self.errors = []

        # number of (complete) lines in previous chunks
        self.prevNumLines = 0
        # number of columns in the last line of the previous chunk
        self.prevNumCols = 0

        # Deal with CR LF and surrogates split over chunk boundaries
        self._bufferedCharacter = None

    def openStream(self, source):
        """Produces a file object from source.

        source can be either a file object, local filename or a string.

        """
        # Already a file object
        if hasattr(source, 'read'):
            stream = source
        else:
            stream = StringIO(source)

        return stream

    def _position(self, offset):
        chunk = self.chunk
        nLines = chunk.count('\n', 0, offset)
        positionLine = self.prevNumLines + nLines
        lastLinePos = chunk.rfind('\n', 0, offset)
        if lastLinePos == -1:
            positionColumn = self.prevNumCols + offset
        else:
            positionColumn = offset - (lastLinePos + 1)
        return (positionLine, positionColumn)

    def position(self):
        """Returns (line, col) of the current position in the stream."""
        line, col = self._position(self.chunkOffset)
        return (line + 1, col)

    def char(self):
        """ Read one character from the stream or queue if available. Return
            EOF when EOF is reached.
        """
        # Read a new chunk from the input stream if necessary
        if self.chunkOffset >= self.chunkSize:
            if not self.readChunk():
                return EOF

        chunkOffset = self.chunkOffset
        char = self.chunk[chunkOffset]
        self.chunkOffset = chunkOffset + 1

        return char

    def readChunk(self, chunkSize=None):
        if chunkSize is None:
            chunkSize = self._defaultChunkSize

        self.prevNumLines, self.prevNumCols = self._position(self.chunkSize)

        self.chunk = ""
        self.chunkSize = 0
        self.chunkOffset = 0

        data = self.dataStream.read(chunkSize)

        # Deal with CR LF and surrogates broken across chunks
        if self._bufferedCharacter:
            data = self._bufferedCharacter + data
            self._bufferedCharacter = None
        elif not data:
            # We have no more data, bye-bye stream
            return False

        if len(data) > 1:
            lastv = ord(data[-1])
            if lastv == 0x0D or 0xD800 <= lastv <= 0xDBFF:
                self._bufferedCharacter = data[-1]
                data = data[:-1]

        if self.reportCharacterErrors:
            self.reportCharacterErrors(data)

        # Replace invalid characters
        data = data.replace("\r\n", "\n")
        data = data.replace("\r", "\n")

        self.chunk = data
        self.chunkSize = len(data)

        return True

    def characterErrorsUCS4(self, data):
        for _ in range(len(invalid_unicode_re.findall(data))):
            self.errors.append("invalid-codepoint")

    def characterErrorsUCS2(self, data):
        # Someone picked the wrong compile option
        # You lose
        skip = False
        for match in invalid_unicode_re.finditer(data):
            if skip:
                continue
            codepoint = ord(match.group())
            pos = match.start()
            # Pretty sure there should be endianness issues here
            if _utils.isSurrogatePair(data[pos:pos + 2]):
                # We have a surrogate pair!
                char_val = _utils.surrogatePairToCodepoint(data[pos:pos + 2])
                if char_val in non_bmp_invalid_codepoints:
                    self.errors.append("invalid-codepoint")
                skip = True
            elif (codepoint >= 0xD800 and codepoint <= 0xDFFF and
                  pos == len(data) - 1):
                self.errors.append("invalid-codepoint")
            else:
                skip = False
                self.errors.append("invalid-codepoint")

    def charsUntil(self, characters, opposite=False):
        """ Returns a string of characters from the stream up to but not
        including any character in 'characters' or EOF. 'characters' must be
        a container that supports the 'in' method and iteration over its
        characters.
        """

        # Use a cache of regexps to find the required characters
        try:
            chars = charsUntilRegEx[(characters, opposite)]
        except KeyError:
            if __debug__:
                for c in characters:
                    assert(ord(c) < 128)
            regex = "".join(["\\x%02x" % ord(c) for c in characters])
            if not opposite:
                regex = "^%s" % regex
            chars = charsUntilRegEx[(characters, opposite)] = re.compile("[%s]+" % regex)

        rv = []

        while True:
            # Find the longest matching prefix
            m = chars.match(self.chunk, self.chunkOffset)
            if m is None:
                # If nothing matched, and it wasn't because we ran out of chunk,
                # then stop
                if self.chunkOffset != self.chunkSize:
                    break
            else:
                end = m.end()
                # If not the whole chunk matched, return everything
                # up to the part that didn't match
                if end != self.chunkSize:
                    rv.append(self.chunk[self.chunkOffset:end])
                    self.chunkOffset = end
                    break
            # If the whole remainder of the chunk matched,
            # use it all and read the next chunk
            rv.append(self.chunk[self.chunkOffset:])
            if not self.readChunk():
                # Reached EOF
                break

        r = "".join(rv)
        return r

    def unget(self, char):
        # Only one character is allowed to be ungotten at once - it must
        # be consumed again before any further call to unget
        if char is not None:
            if self.chunkOffset == 0:
                # unget is called quite rarely, so it's a good idea to do
                # more work here if it saves a bit of work in the frequently
                # called char and charsUntil.
                # So, just prepend the ungotten character onto the current
                # chunk:
                self.chunk = char + self.chunk
                self.chunkSize += 1
            else:
                self.chunkOffset -= 1
                assert self.chunk[self.chunkOffset] == char


class HTMLBinaryInputStream(HTMLUnicodeInputStream):
    """Provides a unicode stream of characters to the HTMLTokenizer.

    This class takes care of character encoding and removing or replacing
    incorrect byte-sequences and also provides column and line tracking.

    """

    def __init__(self, source, override_encoding=None, transport_encoding=None,
                 same_origin_parent_encoding=None, likely_encoding=None,
                 default_encoding="windows-1252", useChardet=True):
        """Initialises the HTMLInputStream.

        HTMLInputStream(source, [encoding]) -> Normalized stream from source
        for use by html5lib.

        source can be either a file-object, local filename or a string.

        The optional encoding parameter must be a string that indicates
        the encoding.  If specified, that encoding will be used,
        regardless of any BOM or later declaration (such as in a meta
        element)

        """
        # Raw Stream - for unicode objects this will encode to utf-8 and set
        #              self.charEncoding as appropriate
        self.rawStream = self.openStream(source)

        HTMLUnicodeInputStream.__init__(self, self.rawStream)

        # Encoding Information
        # Number of bytes to use when looking for a meta element with
        # encoding information
        self.numBytesMeta = 1024
        # Number of bytes to use when using detecting encoding using chardet
        self.numBytesChardet = 100
        # Things from args
        self.override_encoding = override_encoding
        self.transport_encoding = transport_encoding
        self.same_origin_parent_encoding = same_origin_parent_encoding
        self.likely_encoding = likely_encoding
        self.default_encoding = default_encoding

        # Determine encoding
        self.charEncoding = self.determineEncoding(useChardet)
        assert self.charEncoding[0] is not None

        # Call superclass
        self.reset()

    def reset(self):
        self.dataStream = self.charEncoding[0].codec_info.streamreader(self.rawStream, 'replace')
        HTMLUnicodeInputStream.reset(self)

    def openStream(self, source):
        """Produces a file object from source.

        source can be either a file object, local filename or a string.

        """
        # Already a file object
        if hasattr(source, 'read'):
            stream = source
        else:
            stream = BytesIO(source)

        try:
            stream.seek(stream.tell())
        except:  # pylint:disable=bare-except
            stream = BufferedStream(stream)

        return stream

    def determineEncoding(self, chardet=True):
        # BOMs take precedence over everything
        # This will also read past the BOM if present
        charEncoding = self.detectBOM(), "certain"
        if charEncoding[0] is not None:
            return charEncoding

        # If we've been overriden, we've been overriden
        charEncoding = lookupEncoding(self.override_encoding), "certain"
        if charEncoding[0] is not None:
            return charEncoding

        # Now check the transport layer
        charEncoding = lookupEncoding(self.transport_encoding), "certain"
        if charEncoding[0] is not None:
            return charEncoding

        # Look for meta elements with encoding information
        charEncoding = self.detectEncodingMeta(), "tentative"
        if charEncoding[0] is not None:
            return charEncoding

        # Parent document encoding
        charEncoding = lookupEncoding(self.same_origin_parent_encoding), "tentative"
        if charEncoding[0] is not None and not charEncoding[0].name.startswith("utf-16"):
            return charEncoding

        # "likely" encoding
        charEncoding = lookupEncoding(self.likely_encoding), "tentative"
        if charEncoding[0] is not None:
            return charEncoding

        # Guess with chardet, if available
        if chardet:
            try:
                from pip._vendor.chardet.universaldetector import UniversalDetector
            except ImportError:
                pass
            else:
                buffers = []
                detector = UniversalDetector()
                while not detector.done:
                    buffer = self.rawStream.read(self.numBytesChardet)
                    assert isinstance(buffer, bytes)
                    if not buffer:
                        break
                    buffers.append(buffer)
                    detector.feed(buffer)
                detector.close()
                encoding = lookupEncoding(detector.result['encoding'])
                self.rawStream.seek(0)
                if encoding is not None:
                    return encoding, "tentative"

        # Try the default encoding
        charEncoding = lookupEncoding(self.default_encoding), "tentative"
        if charEncoding[0] is not None:
            return charEncoding

        # Fallback to html5lib's default if even that hasn't worked
        return lookupEncoding("windows-1252"), "tentative"

    def changeEncoding(self, newEncoding):
        assert self.charEncoding[1] != "certain"
        newEncoding = lookupEncoding(newEncoding)
        if newEncoding is None:
            return
        if newEncoding.name in ("utf-16be", "utf-16le"):
            newEncoding = lookupEncoding("utf-8")
            assert newEncoding is not None
        elif newEncoding == self.charEncoding[0]:
            self.charEncoding = (self.charEncoding[0], "certain")
        else:
            self.rawStream.seek(0)
            self.charEncoding = (newEncoding, "certain")
            self.reset()
            raise _ReparseException("Encoding changed from %s to %s" % (self.charEncoding[0], newEncoding))

    def detectBOM(self):
        """Attempts to detect at BOM at the start of the stream. If
        an encoding can be determined from the BOM return the name of the
        encoding otherwise return None"""
        bomDict = {
            codecs.BOM_UTF8: 'utf-8',
            codecs.BOM_UTF16_LE: 'utf-16le', codecs.BOM_UTF16_BE: 'utf-16be',
            codecs.BOM_UTF32_LE: 'utf-32le', codecs.BOM_UTF32_BE: 'utf-32be'
        }

        # Go to beginning of file and read in 4 bytes
        string = self.rawStream.read(4)
        assert isinstance(string, bytes)

        # Try detecting the BOM using bytes from the string
        encoding = bomDict.get(string[:3])         # UTF-8
        seek = 3
        if not encoding:
            # Need to detect UTF-32 before UTF-16
            encoding = bomDict.get(string)         # UTF-32
            seek = 4
            if not encoding:
                encoding = bomDict.get(string[:2])  # UTF-16
                seek = 2

        # Set the read position past the BOM if one was found, otherwise
        # set it to the start of the stream
        if encoding:
            self.rawStream.seek(seek)
            return lookupEncoding(encoding)
        else:
            self.rawStream.seek(0)
            return None

    def detectEncodingMeta(self):
        """Report the encoding declared by the meta element
        """
        buffer = self.rawStream.read(self.numBytesMeta)
        assert isinstance(buffer, bytes)
        parser = EncodingParser(buffer)
        self.rawStream.seek(0)
        encoding = parser.getEncoding()

        if encoding is not None and encoding.name in ("utf-16be", "utf-16le"):
            encoding = lookupEncoding("utf-8")

        return encoding


class EncodingBytes(bytes):
    """String-like object with an associated position and various extra methods
    If the position is ever greater than the string length then an exception is
    raised"""
    def __new__(self, value):
        assert isinstance(value, bytes)
        return bytes.__new__(self, value.lower())

    def __init__(self, value):
        # pylint:disable=unused-argument
        self._position = -1

    def __iter__(self):
        return self

    def __next__(self):
        p = self._position = self._position + 1
        if p >= len(self):
            raise StopIteration
        elif p < 0:
            raise TypeError
        return self[p:p + 1]

    def next(self):
        # Py2 compat
        return self.__next__()

    def previous(self):
        p = self._position
        if p >= len(self):
            raise StopIteration
        elif p < 0:
            raise TypeError
        self._position = p = p - 1
        return self[p:p + 1]

    def setPosition(self, position):
        if self._position >= len(self):
            raise StopIteration
        self._position = position

    def getPosition(self):
        if self._position >= len(self):
            raise StopIteration
        if self._position >= 0:
            return self._position
        else:
            return None

    position = property(getPosition, setPosition)

    def getCurrentByte(self):
        return self[self.position:self.position + 1]

    currentByte = property(getCurrentByte)

    def skip(self, chars=spaceCharactersBytes):
        """Skip past a list of characters"""
        p = self.position               # use property for the error-checking
        while p < len(self):
            c = self[p:p + 1]
            if c not in chars:
                self._position = p
                return c
            p += 1
        self._position = p
        return None

    def skipUntil(self, chars):
        p = self.position
        while p < len(self):
            c = self[p:p + 1]
            if c in chars:
                self._position = p
                return c
            p += 1
        self._position = p
        return None

    def matchBytes(self, bytes):
        """Look for a sequence of bytes at the start of a string. If the bytes
        are found return True and advance the position to the byte after the
        match. Otherwise return False and leave the position alone"""
        p = self.position
        data = self[p:p + len(bytes)]
        rv = data.startswith(bytes)
        if rv:
            self.position += len(bytes)
        return rv

    def jumpTo(self, bytes):
        """Look for the next sequence of bytes matching a given sequence. If
        a match is found advance the position to the last byte of the match"""
        newPosition = self[self.position:].find(bytes)
        if newPosition > -1:
            # XXX: This is ugly, but I can't see a nicer way to fix this.
            if self._position == -1:
                self._position = 0
            self._position += (newPosition + len(bytes) - 1)
            return True
        else:
            raise StopIteration


class EncodingParser(object):
    """Mini parser for detecting character encoding from meta elements"""

    def __init__(self, data):
        """string - the data to work on for encoding detection"""
        self.data = EncodingBytes(data)
        self.encoding = None

    def getEncoding(self):
        methodDispatch = (
            (b"<!--", self.handleComment),
            (b"<meta", self.handleMeta),
            (b"</", self.handlePossibleEndTag),
            (b"<!", self.handleOther),
            (b"<?", self.handleOther),
            (b"<", self.handlePossibleStartTag))
        for _ in self.data:
            keepParsing = True
            for key, method in methodDispatch:
                if self.data.matchBytes(key):
                    try:
                        keepParsing = method()
                        break
                    except StopIteration:
                        keepParsing = False
                        break
            if not keepParsing:
                break

        return self.encoding

    def handleComment(self):
        """Skip over comments"""
        return self.data.jumpTo(b"-->")

    def handleMeta(self):
        if self.data.currentByte not in spaceCharactersBytes:
            # if we have <meta not followed by a space so just keep going
            return True
        # We have a valid meta element we want to search for attributes
        hasPragma = False
        pendingEncoding = None
        while True:
            # Try to find the next attribute after the current position
            attr = self.getAttribute()
            if attr is None:
                return True
            else:
                if attr[0] == b"http-equiv":
                    hasPragma = attr[1] == b"content-type"
                    if hasPragma and pendingEncoding is not None:
                        self.encoding = pendingEncoding
                        return False
                elif attr[0] == b"charset":
                    tentativeEncoding = attr[1]
                    codec = lookupEncoding(tentativeEncoding)
                    if codec is not None:
                        self.encoding = codec
                        return False
                elif attr[0] == b"content":
                    contentParser = ContentAttrParser(EncodingBytes(attr[1]))
                    tentativeEncoding = contentParser.parse()
                    if tentativeEncoding is not None:
                        codec = lookupEncoding(tentativeEncoding)
                        if codec is not None:
                            if hasPragma:
                                self.encoding = codec
                                return False
                            else:
                                pendingEncoding = codec

    def handlePossibleStartTag(self):
        return self.handlePossibleTag(False)

    def handlePossibleEndTag(self):
        next(self.data)
        return self.handlePossibleTag(True)

    def handlePossibleTag(self, endTag):
        data = self.data
        if data.currentByte not in asciiLettersBytes:
            # If the next byte is not an ascii letter either ignore this
            # fragment (possible start tag case) or treat it according to
            # handleOther
            if endTag:
                data.previous()
                self.handleOther()
            return True

        c = data.skipUntil(spacesAngleBrackets)
        if c == b"<":
            # return to the first step in the overall "two step" algorithm
            # reprocessing the < byte
            data.previous()
        else:
            # Read all attributes
            attr = self.getAttribute()
            while attr is not None:
                attr = self.getAttribute()
        return True

    def handleOther(self):
        return self.data.jumpTo(b">")

    def getAttribute(self):
        """Return a name,value pair for the next attribute in the stream,
        if one is found, or None"""
        data = self.data
        # Step 1 (skip chars)
        c = data.skip(spaceCharactersBytes | frozenset([b"/"]))
        assert c is None or len(c) == 1
        # Step 2
        if c in (b">", None):
            return None
        # Step 3
        attrName = []
        attrValue = []
        # Step 4 attribute name
        while True:
            if c == b"=" and attrName:
                break
            elif c in spaceCharactersBytes:
                # Step 6!
                c = data.skip()
                break
            elif c in (b"/", b">"):
                return b"".join(attrName), b""
            elif c in asciiUppercaseBytes:
                attrName.append(c.lower())
            elif c is None:
                return None
            else:
                attrName.append(c)
            # Step 5
            c = next(data)
        # Step 7
        if c != b"=":
            data.previous()
            return b"".join(attrName), b""
        # Step 8
        next(data)
        # Step 9
        c = data.skip()
        # Step 10
        if c in (b"'", b'"'):
            # 10.1
            quoteChar = c
            while True:
                # 10.2
                c = next(data)
                # 10.3
                if c == quoteChar:
                    next(data)
                    return b"".join(attrName), b"".join(attrValue)
                # 10.4
                elif c in asciiUppercaseBytes:
                    attrValue.append(c.lower())
                # 10.5
                else:
                    attrValue.append(c)
        elif c == b">":
            return b"".join(attrName), b""
        elif c in asciiUppercaseBytes:
            attrValue.append(c.lower())
        elif c is None:
            return None
        else:
            attrValue.append(c)
        # Step 11
        while True:
            c = next(data)
            if c in spacesAngleBrackets:
                return b"".join(attrName), b"".join(attrValue)
            elif c in asciiUppercaseBytes:
                attrValue.append(c.lower())
            elif c is None:
                return None
            else:
                attrValue.append(c)


class ContentAttrParser(object):
    def __init__(self, data):
        assert isinstance(data, bytes)
        self.data = data

    def parse(self):
        try:
            # Check if the attr name is charset
            # otherwise return
            self.data.jumpTo(b"charset")
            self.data.position += 1
            self.data.skip()
            if not self.data.currentByte == b"=":
                # If there is no = sign keep looking for attrs
                return None
            self.data.position += 1
            self.data.skip()
            # Look for an encoding between matching quote marks
            if self.data.currentByte in (b'"', b"'"):
                quoteMark = self.data.currentByte
                self.data.position += 1
                oldPosition = self.data.position
                if self.data.jumpTo(quoteMark):
                    return self.data[oldPosition:self.data.position]
                else:
                    return None
            else:
                # Unquoted value
                oldPosition = self.data.position
                try:
                    self.data.skipUntil(spaceCharactersBytes)
                    return self.data[oldPosition:self.data.position]
                except StopIteration:
                    # Return the whole remaining value
                    return self.data[oldPosition:]
        except StopIteration:
            return None


def lookupEncoding(encoding):
    """Return the python codec name corresponding to an encoding or None if the
    string doesn't correspond to a valid encoding."""
    if isinstance(encoding, binary_type):
        try:
            encoding = encoding.decode("ascii")
        except UnicodeDecodeError:
            return None

    if encoding is not None:
        try:
            return webencodings.lookup(encoding)
        except AttributeError:
            return None
    else:
        return None
site-packages/pip/_vendor/html5lib/_tokenizer.py000064400000225444151446177000015773 0ustar00from __future__ import absolute_import, division, unicode_literals

from pip._vendor.six import unichr as chr

from collections import deque

from .constants import spaceCharacters
from .constants import entities
from .constants import asciiLetters, asciiUpper2Lower
from .constants import digits, hexDigits, EOF
from .constants import tokenTypes, tagTokenTypes
from .constants import replacementCharacters

from ._inputstream import HTMLInputStream

from ._trie import Trie

entitiesTrie = Trie(entities)


class HTMLTokenizer(object):
    """ This class takes care of tokenizing HTML.

    * self.currentToken
      Holds the token that is currently being processed.

    * self.state
      Holds a reference to the method to be invoked... XXX

    * self.stream
      Points to HTMLInputStream object.
    """

    def __init__(self, stream, parser=None, **kwargs):

        self.stream = HTMLInputStream(stream, **kwargs)
        self.parser = parser

        # Setup the initial tokenizer state
        self.escapeFlag = False
        self.lastFourChars = []
        self.state = self.dataState
        self.escape = False

        # The current token being created
        self.currentToken = None
        super(HTMLTokenizer, self).__init__()

    def __iter__(self):
        """ This is where the magic happens.

        We do our usually processing through the states and when we have a token
        to return we yield the token which pauses processing until the next token
        is requested.
        """
        self.tokenQueue = deque([])
        # Start processing. When EOF is reached self.state will return False
        # instead of True and the loop will terminate.
        while self.state():
            while self.stream.errors:
                yield {"type": tokenTypes["ParseError"], "data": self.stream.errors.pop(0)}
            while self.tokenQueue:
                yield self.tokenQueue.popleft()

    def consumeNumberEntity(self, isHex):
        """This function returns either U+FFFD or the character based on the
        decimal or hexadecimal representation. It also discards ";" if present.
        If not present self.tokenQueue.append({"type": tokenTypes["ParseError"]}) is invoked.
        """

        allowed = digits
        radix = 10
        if isHex:
            allowed = hexDigits
            radix = 16

        charStack = []

        # Consume all the characters that are in range while making sure we
        # don't hit an EOF.
        c = self.stream.char()
        while c in allowed and c is not EOF:
            charStack.append(c)
            c = self.stream.char()

        # Convert the set of characters consumed to an int.
        charAsInt = int("".join(charStack), radix)

        # Certain characters get replaced with others
        if charAsInt in replacementCharacters:
            char = replacementCharacters[charAsInt]
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "illegal-codepoint-for-numeric-entity",
                                    "datavars": {"charAsInt": charAsInt}})
        elif ((0xD800 <= charAsInt <= 0xDFFF) or
              (charAsInt > 0x10FFFF)):
            char = "\uFFFD"
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "illegal-codepoint-for-numeric-entity",
                                    "datavars": {"charAsInt": charAsInt}})
        else:
            # Should speed up this check somehow (e.g. move the set to a constant)
            if ((0x0001 <= charAsInt <= 0x0008) or
                (0x000E <= charAsInt <= 0x001F) or
                (0x007F <= charAsInt <= 0x009F) or
                (0xFDD0 <= charAsInt <= 0xFDEF) or
                charAsInt in frozenset([0x000B, 0xFFFE, 0xFFFF, 0x1FFFE,
                                        0x1FFFF, 0x2FFFE, 0x2FFFF, 0x3FFFE,
                                        0x3FFFF, 0x4FFFE, 0x4FFFF, 0x5FFFE,
                                        0x5FFFF, 0x6FFFE, 0x6FFFF, 0x7FFFE,
                                        0x7FFFF, 0x8FFFE, 0x8FFFF, 0x9FFFE,
                                        0x9FFFF, 0xAFFFE, 0xAFFFF, 0xBFFFE,
                                        0xBFFFF, 0xCFFFE, 0xCFFFF, 0xDFFFE,
                                        0xDFFFF, 0xEFFFE, 0xEFFFF, 0xFFFFE,
                                        0xFFFFF, 0x10FFFE, 0x10FFFF])):
                self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                        "data":
                                        "illegal-codepoint-for-numeric-entity",
                                        "datavars": {"charAsInt": charAsInt}})
            try:
                # Try/except needed as UCS-2 Python builds' unichar only works
                # within the BMP.
                char = chr(charAsInt)
            except ValueError:
                v = charAsInt - 0x10000
                char = chr(0xD800 | (v >> 10)) + chr(0xDC00 | (v & 0x3FF))

        # Discard the ; if present. Otherwise, put it back on the queue and
        # invoke parseError on parser.
        if c != ";":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "numeric-entity-without-semicolon"})
            self.stream.unget(c)

        return char

    def consumeEntity(self, allowedChar=None, fromAttribute=False):
        # Initialise to the default output for when no entity is matched
        output = "&"

        charStack = [self.stream.char()]
        if (charStack[0] in spaceCharacters or charStack[0] in (EOF, "<", "&") or
                (allowedChar is not None and allowedChar == charStack[0])):
            self.stream.unget(charStack[0])

        elif charStack[0] == "#":
            # Read the next character to see if it's hex or decimal
            hex = False
            charStack.append(self.stream.char())
            if charStack[-1] in ("x", "X"):
                hex = True
                charStack.append(self.stream.char())

            # charStack[-1] should be the first digit
            if (hex and charStack[-1] in hexDigits) \
                    or (not hex and charStack[-1] in digits):
                # At least one digit found, so consume the whole number
                self.stream.unget(charStack[-1])
                output = self.consumeNumberEntity(hex)
            else:
                # No digits found
                self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                        "data": "expected-numeric-entity"})
                self.stream.unget(charStack.pop())
                output = "&" + "".join(charStack)

        else:
            # At this point in the process might have named entity. Entities
            # are stored in the global variable "entities".
            #
            # Consume characters and compare to these to a substring of the
            # entity names in the list until the substring no longer matches.
            while (charStack[-1] is not EOF):
                if not entitiesTrie.has_keys_with_prefix("".join(charStack)):
                    break
                charStack.append(self.stream.char())

            # At this point we have a string that starts with some characters
            # that may match an entity
            # Try to find the longest entity the string will match to take care
            # of &noti for instance.
            try:
                entityName = entitiesTrie.longest_prefix("".join(charStack[:-1]))
                entityLength = len(entityName)
            except KeyError:
                entityName = None

            if entityName is not None:
                if entityName[-1] != ";":
                    self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                            "named-entity-without-semicolon"})
                if (entityName[-1] != ";" and fromAttribute and
                    (charStack[entityLength] in asciiLetters or
                     charStack[entityLength] in digits or
                     charStack[entityLength] == "=")):
                    self.stream.unget(charStack.pop())
                    output = "&" + "".join(charStack)
                else:
                    output = entities[entityName]
                    self.stream.unget(charStack.pop())
                    output += "".join(charStack[entityLength:])
            else:
                self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                        "expected-named-entity"})
                self.stream.unget(charStack.pop())
                output = "&" + "".join(charStack)

        if fromAttribute:
            self.currentToken["data"][-1][1] += output
        else:
            if output in spaceCharacters:
                tokenType = "SpaceCharacters"
            else:
                tokenType = "Characters"
            self.tokenQueue.append({"type": tokenTypes[tokenType], "data": output})

    def processEntityInAttribute(self, allowedChar):
        """This method replaces the need for "entityInAttributeValueState".
        """
        self.consumeEntity(allowedChar=allowedChar, fromAttribute=True)

    def emitCurrentToken(self):
        """This method is a generic handler for emitting the tags. It also sets
        the state to "data" because that's what's needed after a token has been
        emitted.
        """
        token = self.currentToken
        # Add token to the queue to be yielded
        if (token["type"] in tagTokenTypes):
            token["name"] = token["name"].translate(asciiUpper2Lower)
            if token["type"] == tokenTypes["EndTag"]:
                if token["data"]:
                    self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                            "data": "attributes-in-end-tag"})
                if token["selfClosing"]:
                    self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                            "data": "self-closing-flag-on-end-tag"})
        self.tokenQueue.append(token)
        self.state = self.dataState

    # Below are the various tokenizer states worked out.
    def dataState(self):
        data = self.stream.char()
        if data == "&":
            self.state = self.entityDataState
        elif data == "<":
            self.state = self.tagOpenState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\u0000"})
        elif data is EOF:
            # Tokenization ends.
            return False
        elif data in spaceCharacters:
            # Directly after emitting a token you switch back to the "data
            # state". At that point spaceCharacters are important so they are
            # emitted separately.
            self.tokenQueue.append({"type": tokenTypes["SpaceCharacters"], "data":
                                    data + self.stream.charsUntil(spaceCharacters, True)})
            # No need to update lastFourChars here, since the first space will
            # have already been appended to lastFourChars and will have broken
            # any <!-- or --> sequences
        else:
            chars = self.stream.charsUntil(("&", "<", "\u0000"))
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
                                    data + chars})
        return True

    def entityDataState(self):
        self.consumeEntity()
        self.state = self.dataState
        return True

    def rcdataState(self):
        data = self.stream.char()
        if data == "&":
            self.state = self.characterReferenceInRcdata
        elif data == "<":
            self.state = self.rcdataLessThanSignState
        elif data == EOF:
            # Tokenization ends.
            return False
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
        elif data in spaceCharacters:
            # Directly after emitting a token you switch back to the "data
            # state". At that point spaceCharacters are important so they are
            # emitted separately.
            self.tokenQueue.append({"type": tokenTypes["SpaceCharacters"], "data":
                                    data + self.stream.charsUntil(spaceCharacters, True)})
            # No need to update lastFourChars here, since the first space will
            # have already been appended to lastFourChars and will have broken
            # any <!-- or --> sequences
        else:
            chars = self.stream.charsUntil(("&", "<", "\u0000"))
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
                                    data + chars})
        return True

    def characterReferenceInRcdata(self):
        self.consumeEntity()
        self.state = self.rcdataState
        return True

    def rawtextState(self):
        data = self.stream.char()
        if data == "<":
            self.state = self.rawtextLessThanSignState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
        elif data == EOF:
            # Tokenization ends.
            return False
        else:
            chars = self.stream.charsUntil(("<", "\u0000"))
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
                                    data + chars})
        return True

    def scriptDataState(self):
        data = self.stream.char()
        if data == "<":
            self.state = self.scriptDataLessThanSignState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
        elif data == EOF:
            # Tokenization ends.
            return False
        else:
            chars = self.stream.charsUntil(("<", "\u0000"))
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
                                    data + chars})
        return True

    def plaintextState(self):
        data = self.stream.char()
        if data == EOF:
            # Tokenization ends.
            return False
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
                                    data + self.stream.charsUntil("\u0000")})
        return True

    def tagOpenState(self):
        data = self.stream.char()
        if data == "!":
            self.state = self.markupDeclarationOpenState
        elif data == "/":
            self.state = self.closeTagOpenState
        elif data in asciiLetters:
            self.currentToken = {"type": tokenTypes["StartTag"],
                                 "name": data, "data": [],
                                 "selfClosing": False,
                                 "selfClosingAcknowledged": False}
            self.state = self.tagNameState
        elif data == ">":
            # XXX In theory it could be something besides a tag name. But
            # do we really care?
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-tag-name-but-got-right-bracket"})
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<>"})
            self.state = self.dataState
        elif data == "?":
            # XXX In theory it could be something besides a tag name. But
            # do we really care?
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-tag-name-but-got-question-mark"})
            self.stream.unget(data)
            self.state = self.bogusCommentState
        else:
            # XXX
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-tag-name"})
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.stream.unget(data)
            self.state = self.dataState
        return True

    def closeTagOpenState(self):
        data = self.stream.char()
        if data in asciiLetters:
            self.currentToken = {"type": tokenTypes["EndTag"], "name": data,
                                 "data": [], "selfClosing": False}
            self.state = self.tagNameState
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-closing-tag-but-got-right-bracket"})
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-closing-tag-but-got-eof"})
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
            self.state = self.dataState
        else:
            # XXX data can be _'_...
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-closing-tag-but-got-char",
                                    "datavars": {"data": data}})
            self.stream.unget(data)
            self.state = self.bogusCommentState
        return True

    def tagNameState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.state = self.beforeAttributeNameState
        elif data == ">":
            self.emitCurrentToken()
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-tag-name"})
            self.state = self.dataState
        elif data == "/":
            self.state = self.selfClosingStartTagState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["name"] += "\uFFFD"
        else:
            self.currentToken["name"] += data
            # (Don't use charsUntil here, because tag names are
            # very short and it's faster to not do anything fancy)
        return True

    def rcdataLessThanSignState(self):
        data = self.stream.char()
        if data == "/":
            self.temporaryBuffer = ""
            self.state = self.rcdataEndTagOpenState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.stream.unget(data)
            self.state = self.rcdataState
        return True

    def rcdataEndTagOpenState(self):
        data = self.stream.char()
        if data in asciiLetters:
            self.temporaryBuffer += data
            self.state = self.rcdataEndTagNameState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
            self.stream.unget(data)
            self.state = self.rcdataState
        return True

    def rcdataEndTagNameState(self):
        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
        data = self.stream.char()
        if data in spaceCharacters and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.beforeAttributeNameState
        elif data == "/" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.selfClosingStartTagState
        elif data == ">" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.emitCurrentToken()
            self.state = self.dataState
        elif data in asciiLetters:
            self.temporaryBuffer += data
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "</" + self.temporaryBuffer})
            self.stream.unget(data)
            self.state = self.rcdataState
        return True

    def rawtextLessThanSignState(self):
        data = self.stream.char()
        if data == "/":
            self.temporaryBuffer = ""
            self.state = self.rawtextEndTagOpenState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.stream.unget(data)
            self.state = self.rawtextState
        return True

    def rawtextEndTagOpenState(self):
        data = self.stream.char()
        if data in asciiLetters:
            self.temporaryBuffer += data
            self.state = self.rawtextEndTagNameState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
            self.stream.unget(data)
            self.state = self.rawtextState
        return True

    def rawtextEndTagNameState(self):
        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
        data = self.stream.char()
        if data in spaceCharacters and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.beforeAttributeNameState
        elif data == "/" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.selfClosingStartTagState
        elif data == ">" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.emitCurrentToken()
            self.state = self.dataState
        elif data in asciiLetters:
            self.temporaryBuffer += data
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "</" + self.temporaryBuffer})
            self.stream.unget(data)
            self.state = self.rawtextState
        return True

    def scriptDataLessThanSignState(self):
        data = self.stream.char()
        if data == "/":
            self.temporaryBuffer = ""
            self.state = self.scriptDataEndTagOpenState
        elif data == "!":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<!"})
            self.state = self.scriptDataEscapeStartState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.stream.unget(data)
            self.state = self.scriptDataState
        return True

    def scriptDataEndTagOpenState(self):
        data = self.stream.char()
        if data in asciiLetters:
            self.temporaryBuffer += data
            self.state = self.scriptDataEndTagNameState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
            self.stream.unget(data)
            self.state = self.scriptDataState
        return True

    def scriptDataEndTagNameState(self):
        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
        data = self.stream.char()
        if data in spaceCharacters and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.beforeAttributeNameState
        elif data == "/" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.selfClosingStartTagState
        elif data == ">" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.emitCurrentToken()
            self.state = self.dataState
        elif data in asciiLetters:
            self.temporaryBuffer += data
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "</" + self.temporaryBuffer})
            self.stream.unget(data)
            self.state = self.scriptDataState
        return True

    def scriptDataEscapeStartState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
            self.state = self.scriptDataEscapeStartDashState
        else:
            self.stream.unget(data)
            self.state = self.scriptDataState
        return True

    def scriptDataEscapeStartDashState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
            self.state = self.scriptDataEscapedDashDashState
        else:
            self.stream.unget(data)
            self.state = self.scriptDataState
        return True

    def scriptDataEscapedState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
            self.state = self.scriptDataEscapedDashState
        elif data == "<":
            self.state = self.scriptDataEscapedLessThanSignState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
        elif data == EOF:
            self.state = self.dataState
        else:
            chars = self.stream.charsUntil(("<", "-", "\u0000"))
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data":
                                    data + chars})
        return True

    def scriptDataEscapedDashState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
            self.state = self.scriptDataEscapedDashDashState
        elif data == "<":
            self.state = self.scriptDataEscapedLessThanSignState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
            self.state = self.scriptDataEscapedState
        elif data == EOF:
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            self.state = self.scriptDataEscapedState
        return True

    def scriptDataEscapedDashDashState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
        elif data == "<":
            self.state = self.scriptDataEscapedLessThanSignState
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": ">"})
            self.state = self.scriptDataState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
            self.state = self.scriptDataEscapedState
        elif data == EOF:
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            self.state = self.scriptDataEscapedState
        return True

    def scriptDataEscapedLessThanSignState(self):
        data = self.stream.char()
        if data == "/":
            self.temporaryBuffer = ""
            self.state = self.scriptDataEscapedEndTagOpenState
        elif data in asciiLetters:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<" + data})
            self.temporaryBuffer = data
            self.state = self.scriptDataDoubleEscapeStartState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.stream.unget(data)
            self.state = self.scriptDataEscapedState
        return True

    def scriptDataEscapedEndTagOpenState(self):
        data = self.stream.char()
        if data in asciiLetters:
            self.temporaryBuffer = data
            self.state = self.scriptDataEscapedEndTagNameState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "</"})
            self.stream.unget(data)
            self.state = self.scriptDataEscapedState
        return True

    def scriptDataEscapedEndTagNameState(self):
        appropriate = self.currentToken and self.currentToken["name"].lower() == self.temporaryBuffer.lower()
        data = self.stream.char()
        if data in spaceCharacters and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.beforeAttributeNameState
        elif data == "/" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.state = self.selfClosingStartTagState
        elif data == ">" and appropriate:
            self.currentToken = {"type": tokenTypes["EndTag"],
                                 "name": self.temporaryBuffer,
                                 "data": [], "selfClosing": False}
            self.emitCurrentToken()
            self.state = self.dataState
        elif data in asciiLetters:
            self.temporaryBuffer += data
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "</" + self.temporaryBuffer})
            self.stream.unget(data)
            self.state = self.scriptDataEscapedState
        return True

    def scriptDataDoubleEscapeStartState(self):
        data = self.stream.char()
        if data in (spaceCharacters | frozenset(("/", ">"))):
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            if self.temporaryBuffer.lower() == "script":
                self.state = self.scriptDataDoubleEscapedState
            else:
                self.state = self.scriptDataEscapedState
        elif data in asciiLetters:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            self.temporaryBuffer += data
        else:
            self.stream.unget(data)
            self.state = self.scriptDataEscapedState
        return True

    def scriptDataDoubleEscapedState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
            self.state = self.scriptDataDoubleEscapedDashState
        elif data == "<":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.state = self.scriptDataDoubleEscapedLessThanSignState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
        elif data == EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-script-in-script"})
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
        return True

    def scriptDataDoubleEscapedDashState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
            self.state = self.scriptDataDoubleEscapedDashDashState
        elif data == "<":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.state = self.scriptDataDoubleEscapedLessThanSignState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
            self.state = self.scriptDataDoubleEscapedState
        elif data == EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-script-in-script"})
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            self.state = self.scriptDataDoubleEscapedState
        return True

    def scriptDataDoubleEscapedDashDashState(self):
        data = self.stream.char()
        if data == "-":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "-"})
        elif data == "<":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "<"})
            self.state = self.scriptDataDoubleEscapedLessThanSignState
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": ">"})
            self.state = self.scriptDataState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": "\uFFFD"})
            self.state = self.scriptDataDoubleEscapedState
        elif data == EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-script-in-script"})
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            self.state = self.scriptDataDoubleEscapedState
        return True

    def scriptDataDoubleEscapedLessThanSignState(self):
        data = self.stream.char()
        if data == "/":
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": "/"})
            self.temporaryBuffer = ""
            self.state = self.scriptDataDoubleEscapeEndState
        else:
            self.stream.unget(data)
            self.state = self.scriptDataDoubleEscapedState
        return True

    def scriptDataDoubleEscapeEndState(self):
        data = self.stream.char()
        if data in (spaceCharacters | frozenset(("/", ">"))):
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            if self.temporaryBuffer.lower() == "script":
                self.state = self.scriptDataEscapedState
            else:
                self.state = self.scriptDataDoubleEscapedState
        elif data in asciiLetters:
            self.tokenQueue.append({"type": tokenTypes["Characters"], "data": data})
            self.temporaryBuffer += data
        else:
            self.stream.unget(data)
            self.state = self.scriptDataDoubleEscapedState
        return True

    def beforeAttributeNameState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.stream.charsUntil(spaceCharacters, True)
        elif data in asciiLetters:
            self.currentToken["data"].append([data, ""])
            self.state = self.attributeNameState
        elif data == ">":
            self.emitCurrentToken()
        elif data == "/":
            self.state = self.selfClosingStartTagState
        elif data in ("'", '"', "=", "<"):
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "invalid-character-in-attribute-name"})
            self.currentToken["data"].append([data, ""])
            self.state = self.attributeNameState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"].append(["\uFFFD", ""])
            self.state = self.attributeNameState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-attribute-name-but-got-eof"})
            self.state = self.dataState
        else:
            self.currentToken["data"].append([data, ""])
            self.state = self.attributeNameState
        return True

    def attributeNameState(self):
        data = self.stream.char()
        leavingThisState = True
        emitToken = False
        if data == "=":
            self.state = self.beforeAttributeValueState
        elif data in asciiLetters:
            self.currentToken["data"][-1][0] += data +\
                self.stream.charsUntil(asciiLetters, True)
            leavingThisState = False
        elif data == ">":
            # XXX If we emit here the attributes are converted to a dict
            # without being checked and when the code below runs we error
            # because data is a dict not a list
            emitToken = True
        elif data in spaceCharacters:
            self.state = self.afterAttributeNameState
        elif data == "/":
            self.state = self.selfClosingStartTagState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"][-1][0] += "\uFFFD"
            leavingThisState = False
        elif data in ("'", '"', "<"):
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data":
                                    "invalid-character-in-attribute-name"})
            self.currentToken["data"][-1][0] += data
            leavingThisState = False
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "eof-in-attribute-name"})
            self.state = self.dataState
        else:
            self.currentToken["data"][-1][0] += data
            leavingThisState = False

        if leavingThisState:
            # Attributes are not dropped at this stage. That happens when the
            # start tag token is emitted so values can still be safely appended
            # to attributes, but we do want to report the parse error in time.
            self.currentToken["data"][-1][0] = (
                self.currentToken["data"][-1][0].translate(asciiUpper2Lower))
            for name, _ in self.currentToken["data"][:-1]:
                if self.currentToken["data"][-1][0] == name:
                    self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                            "duplicate-attribute"})
                    break
            # XXX Fix for above XXX
            if emitToken:
                self.emitCurrentToken()
        return True

    def afterAttributeNameState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.stream.charsUntil(spaceCharacters, True)
        elif data == "=":
            self.state = self.beforeAttributeValueState
        elif data == ">":
            self.emitCurrentToken()
        elif data in asciiLetters:
            self.currentToken["data"].append([data, ""])
            self.state = self.attributeNameState
        elif data == "/":
            self.state = self.selfClosingStartTagState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"].append(["\uFFFD", ""])
            self.state = self.attributeNameState
        elif data in ("'", '"', "<"):
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "invalid-character-after-attribute-name"})
            self.currentToken["data"].append([data, ""])
            self.state = self.attributeNameState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-end-of-tag-but-got-eof"})
            self.state = self.dataState
        else:
            self.currentToken["data"].append([data, ""])
            self.state = self.attributeNameState
        return True

    def beforeAttributeValueState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.stream.charsUntil(spaceCharacters, True)
        elif data == "\"":
            self.state = self.attributeValueDoubleQuotedState
        elif data == "&":
            self.state = self.attributeValueUnQuotedState
            self.stream.unget(data)
        elif data == "'":
            self.state = self.attributeValueSingleQuotedState
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-attribute-value-but-got-right-bracket"})
            self.emitCurrentToken()
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"][-1][1] += "\uFFFD"
            self.state = self.attributeValueUnQuotedState
        elif data in ("=", "<", "`"):
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "equals-in-unquoted-attribute-value"})
            self.currentToken["data"][-1][1] += data
            self.state = self.attributeValueUnQuotedState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-attribute-value-but-got-eof"})
            self.state = self.dataState
        else:
            self.currentToken["data"][-1][1] += data
            self.state = self.attributeValueUnQuotedState
        return True

    def attributeValueDoubleQuotedState(self):
        data = self.stream.char()
        if data == "\"":
            self.state = self.afterAttributeValueState
        elif data == "&":
            self.processEntityInAttribute('"')
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"][-1][1] += "\uFFFD"
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-attribute-value-double-quote"})
            self.state = self.dataState
        else:
            self.currentToken["data"][-1][1] += data +\
                self.stream.charsUntil(("\"", "&", "\u0000"))
        return True

    def attributeValueSingleQuotedState(self):
        data = self.stream.char()
        if data == "'":
            self.state = self.afterAttributeValueState
        elif data == "&":
            self.processEntityInAttribute("'")
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"][-1][1] += "\uFFFD"
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-attribute-value-single-quote"})
            self.state = self.dataState
        else:
            self.currentToken["data"][-1][1] += data +\
                self.stream.charsUntil(("'", "&", "\u0000"))
        return True

    def attributeValueUnQuotedState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.state = self.beforeAttributeNameState
        elif data == "&":
            self.processEntityInAttribute(">")
        elif data == ">":
            self.emitCurrentToken()
        elif data in ('"', "'", "=", "<", "`"):
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-character-in-unquoted-attribute-value"})
            self.currentToken["data"][-1][1] += data
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"][-1][1] += "\uFFFD"
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-attribute-value-no-quotes"})
            self.state = self.dataState
        else:
            self.currentToken["data"][-1][1] += data + self.stream.charsUntil(
                frozenset(("&", ">", '"', "'", "=", "<", "`", "\u0000")) | spaceCharacters)
        return True

    def afterAttributeValueState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.state = self.beforeAttributeNameState
        elif data == ">":
            self.emitCurrentToken()
        elif data == "/":
            self.state = self.selfClosingStartTagState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-EOF-after-attribute-value"})
            self.stream.unget(data)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-character-after-attribute-value"})
            self.stream.unget(data)
            self.state = self.beforeAttributeNameState
        return True

    def selfClosingStartTagState(self):
        data = self.stream.char()
        if data == ">":
            self.currentToken["selfClosing"] = True
            self.emitCurrentToken()
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data":
                                    "unexpected-EOF-after-solidus-in-tag"})
            self.stream.unget(data)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-character-after-solidus-in-tag"})
            self.stream.unget(data)
            self.state = self.beforeAttributeNameState
        return True

    def bogusCommentState(self):
        # Make a new comment token and give it as value all the characters
        # until the first > or EOF (charsUntil checks for EOF automatically)
        # and emit it.
        data = self.stream.charsUntil(">")
        data = data.replace("\u0000", "\uFFFD")
        self.tokenQueue.append(
            {"type": tokenTypes["Comment"], "data": data})

        # Eat the character directly after the bogus comment which is either a
        # ">" or an EOF.
        self.stream.char()
        self.state = self.dataState
        return True

    def markupDeclarationOpenState(self):
        charStack = [self.stream.char()]
        if charStack[-1] == "-":
            charStack.append(self.stream.char())
            if charStack[-1] == "-":
                self.currentToken = {"type": tokenTypes["Comment"], "data": ""}
                self.state = self.commentStartState
                return True
        elif charStack[-1] in ('d', 'D'):
            matched = True
            for expected in (('o', 'O'), ('c', 'C'), ('t', 'T'),
                             ('y', 'Y'), ('p', 'P'), ('e', 'E')):
                charStack.append(self.stream.char())
                if charStack[-1] not in expected:
                    matched = False
                    break
            if matched:
                self.currentToken = {"type": tokenTypes["Doctype"],
                                     "name": "",
                                     "publicId": None, "systemId": None,
                                     "correct": True}
                self.state = self.doctypeState
                return True
        elif (charStack[-1] == "[" and
              self.parser is not None and
              self.parser.tree.openElements and
              self.parser.tree.openElements[-1].namespace != self.parser.tree.defaultNamespace):
            matched = True
            for expected in ["C", "D", "A", "T", "A", "["]:
                charStack.append(self.stream.char())
                if charStack[-1] != expected:
                    matched = False
                    break
            if matched:
                self.state = self.cdataSectionState
                return True

        self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                "expected-dashes-or-doctype"})

        while charStack:
            self.stream.unget(charStack.pop())
        self.state = self.bogusCommentState
        return True

    def commentStartState(self):
        data = self.stream.char()
        if data == "-":
            self.state = self.commentStartDashState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"] += "\uFFFD"
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "incorrect-comment"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-comment"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["data"] += data
            self.state = self.commentState
        return True

    def commentStartDashState(self):
        data = self.stream.char()
        if data == "-":
            self.state = self.commentEndState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"] += "-\uFFFD"
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "incorrect-comment"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-comment"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["data"] += "-" + data
            self.state = self.commentState
        return True

    def commentState(self):
        data = self.stream.char()
        if data == "-":
            self.state = self.commentEndDashState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"] += "\uFFFD"
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "eof-in-comment"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["data"] += data + \
                self.stream.charsUntil(("-", "\u0000"))
        return True

    def commentEndDashState(self):
        data = self.stream.char()
        if data == "-":
            self.state = self.commentEndState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"] += "-\uFFFD"
            self.state = self.commentState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-comment-end-dash"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["data"] += "-" + data
            self.state = self.commentState
        return True

    def commentEndState(self):
        data = self.stream.char()
        if data == ">":
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"] += "--\uFFFD"
            self.state = self.commentState
        elif data == "!":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-bang-after-double-dash-in-comment"})
            self.state = self.commentEndBangState
        elif data == "-":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-dash-after-double-dash-in-comment"})
            self.currentToken["data"] += data
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-comment-double-dash"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            # XXX
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-comment"})
            self.currentToken["data"] += "--" + data
            self.state = self.commentState
        return True

    def commentEndBangState(self):
        data = self.stream.char()
        if data == ">":
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data == "-":
            self.currentToken["data"] += "--!"
            self.state = self.commentEndDashState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["data"] += "--!\uFFFD"
            self.state = self.commentState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-comment-end-bang-state"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["data"] += "--!" + data
            self.state = self.commentState
        return True

    def doctypeState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.state = self.beforeDoctypeNameState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-doctype-name-but-got-eof"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "need-space-after-doctype"})
            self.stream.unget(data)
            self.state = self.beforeDoctypeNameState
        return True

    def beforeDoctypeNameState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            pass
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-doctype-name-but-got-right-bracket"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["name"] = "\uFFFD"
            self.state = self.doctypeNameState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-doctype-name-but-got-eof"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["name"] = data
            self.state = self.doctypeNameState
        return True

    def doctypeNameState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.currentToken["name"] = self.currentToken["name"].translate(asciiUpper2Lower)
            self.state = self.afterDoctypeNameState
        elif data == ">":
            self.currentToken["name"] = self.currentToken["name"].translate(asciiUpper2Lower)
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["name"] += "\uFFFD"
            self.state = self.doctypeNameState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype-name"})
            self.currentToken["correct"] = False
            self.currentToken["name"] = self.currentToken["name"].translate(asciiUpper2Lower)
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["name"] += data
        return True

    def afterDoctypeNameState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            pass
        elif data == ">":
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.currentToken["correct"] = False
            self.stream.unget(data)
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            if data in ("p", "P"):
                matched = True
                for expected in (("u", "U"), ("b", "B"), ("l", "L"),
                                 ("i", "I"), ("c", "C")):
                    data = self.stream.char()
                    if data not in expected:
                        matched = False
                        break
                if matched:
                    self.state = self.afterDoctypePublicKeywordState
                    return True
            elif data in ("s", "S"):
                matched = True
                for expected in (("y", "Y"), ("s", "S"), ("t", "T"),
                                 ("e", "E"), ("m", "M")):
                    data = self.stream.char()
                    if data not in expected:
                        matched = False
                        break
                if matched:
                    self.state = self.afterDoctypeSystemKeywordState
                    return True

            # All the characters read before the current 'data' will be
            # [a-zA-Z], so they're garbage in the bogus doctype and can be
            # discarded; only the latest character might be '>' or EOF
            # and needs to be ungetted
            self.stream.unget(data)
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "expected-space-or-right-bracket-in-doctype", "datavars":
                                    {"data": data}})
            self.currentToken["correct"] = False
            self.state = self.bogusDoctypeState

        return True

    def afterDoctypePublicKeywordState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.state = self.beforeDoctypePublicIdentifierState
        elif data in ("'", '"'):
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.stream.unget(data)
            self.state = self.beforeDoctypePublicIdentifierState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.stream.unget(data)
            self.state = self.beforeDoctypePublicIdentifierState
        return True

    def beforeDoctypePublicIdentifierState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            pass
        elif data == "\"":
            self.currentToken["publicId"] = ""
            self.state = self.doctypePublicIdentifierDoubleQuotedState
        elif data == "'":
            self.currentToken["publicId"] = ""
            self.state = self.doctypePublicIdentifierSingleQuotedState
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-end-of-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.currentToken["correct"] = False
            self.state = self.bogusDoctypeState
        return True

    def doctypePublicIdentifierDoubleQuotedState(self):
        data = self.stream.char()
        if data == "\"":
            self.state = self.afterDoctypePublicIdentifierState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["publicId"] += "\uFFFD"
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-end-of-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["publicId"] += data
        return True

    def doctypePublicIdentifierSingleQuotedState(self):
        data = self.stream.char()
        if data == "'":
            self.state = self.afterDoctypePublicIdentifierState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["publicId"] += "\uFFFD"
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-end-of-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["publicId"] += data
        return True

    def afterDoctypePublicIdentifierState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.state = self.betweenDoctypePublicAndSystemIdentifiersState
        elif data == ">":
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data == '"':
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.currentToken["systemId"] = ""
            self.state = self.doctypeSystemIdentifierDoubleQuotedState
        elif data == "'":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.currentToken["systemId"] = ""
            self.state = self.doctypeSystemIdentifierSingleQuotedState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.currentToken["correct"] = False
            self.state = self.bogusDoctypeState
        return True

    def betweenDoctypePublicAndSystemIdentifiersState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            pass
        elif data == ">":
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data == '"':
            self.currentToken["systemId"] = ""
            self.state = self.doctypeSystemIdentifierDoubleQuotedState
        elif data == "'":
            self.currentToken["systemId"] = ""
            self.state = self.doctypeSystemIdentifierSingleQuotedState
        elif data == EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.currentToken["correct"] = False
            self.state = self.bogusDoctypeState
        return True

    def afterDoctypeSystemKeywordState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            self.state = self.beforeDoctypeSystemIdentifierState
        elif data in ("'", '"'):
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.stream.unget(data)
            self.state = self.beforeDoctypeSystemIdentifierState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.stream.unget(data)
            self.state = self.beforeDoctypeSystemIdentifierState
        return True

    def beforeDoctypeSystemIdentifierState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            pass
        elif data == "\"":
            self.currentToken["systemId"] = ""
            self.state = self.doctypeSystemIdentifierDoubleQuotedState
        elif data == "'":
            self.currentToken["systemId"] = ""
            self.state = self.doctypeSystemIdentifierSingleQuotedState
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.currentToken["correct"] = False
            self.state = self.bogusDoctypeState
        return True

    def doctypeSystemIdentifierDoubleQuotedState(self):
        data = self.stream.char()
        if data == "\"":
            self.state = self.afterDoctypeSystemIdentifierState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["systemId"] += "\uFFFD"
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-end-of-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["systemId"] += data
        return True

    def doctypeSystemIdentifierSingleQuotedState(self):
        data = self.stream.char()
        if data == "'":
            self.state = self.afterDoctypeSystemIdentifierState
        elif data == "\u0000":
            self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                    "data": "invalid-codepoint"})
            self.currentToken["systemId"] += "\uFFFD"
        elif data == ">":
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-end-of-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.currentToken["systemId"] += data
        return True

    def afterDoctypeSystemIdentifierState(self):
        data = self.stream.char()
        if data in spaceCharacters:
            pass
        elif data == ">":
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "eof-in-doctype"})
            self.currentToken["correct"] = False
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            self.tokenQueue.append({"type": tokenTypes["ParseError"], "data":
                                    "unexpected-char-in-doctype"})
            self.state = self.bogusDoctypeState
        return True

    def bogusDoctypeState(self):
        data = self.stream.char()
        if data == ">":
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        elif data is EOF:
            # XXX EMIT
            self.stream.unget(data)
            self.tokenQueue.append(self.currentToken)
            self.state = self.dataState
        else:
            pass
        return True

    def cdataSectionState(self):
        data = []
        while True:
            data.append(self.stream.charsUntil("]"))
            data.append(self.stream.charsUntil(">"))
            char = self.stream.char()
            if char == EOF:
                break
            else:
                assert char == ">"
                if data[-1][-2:] == "]]":
                    data[-1] = data[-1][:-2]
                    break
                else:
                    data.append(char)

        data = "".join(data)  # pylint:disable=redefined-variable-type
        # Deal with null here rather than in the parser
        nullCount = data.count("\u0000")
        if nullCount > 0:
            for _ in range(nullCount):
                self.tokenQueue.append({"type": tokenTypes["ParseError"],
                                        "data": "invalid-codepoint"})
            data = data.replace("\u0000", "\uFFFD")
        if data:
            self.tokenQueue.append({"type": tokenTypes["Characters"],
                                    "data": data})
        self.state = self.dataState
        return True
site-packages/pip/_vendor/html5lib/_trie/_base.py000064400000001765151446177000015773 0ustar00from __future__ import absolute_import, division, unicode_literals

try:
    from collections.abc import Mapping
except ImportError:  # Python 2.7
    from collections import Mapping


class Trie(Mapping):
    """Abstract base class for tries"""

    def keys(self, prefix=None):
        # pylint:disable=arguments-differ
        keys = super(Trie, self).keys()

        if prefix is None:
            return set(keys)

        return {x for x in keys if x.startswith(prefix)}

    def has_keys_with_prefix(self, prefix):
        for key in self.keys():
            if key.startswith(prefix):
                return True

        return False

    def longest_prefix(self, prefix):
        if prefix in self:
            return prefix

        for i in range(1, len(prefix) + 1):
            if prefix[:-i] in self:
                return prefix[:-i]

        raise KeyError(prefix)

    def longest_prefix_item(self, prefix):
        lprefix = self.longest_prefix(prefix)
        return (lprefix, self[lprefix])
site-packages/pip/_vendor/html5lib/_trie/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000605151446177000023676 0ustar00U

��.e!�@sRddlmZmZmZddlmZeZzddlmZWne	k
rHYnXeZdS)�)�absolute_import�division�unicode_literals�)�TrieN)
Z
__future__rrr�pyrZPyTrieZdatrieZDATrie�ImportError�r	r	�G/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/__init__.py�<module>ssite-packages/pip/_vendor/html5lib/_trie/__pycache__/datrie.cpython-38.opt-1.pyc000064400000003721151446177000023411 0ustar00U

��.e��@sLddlmZmZmZddlmZddlmZddl	mZ
Gdd�de
�ZdS)�)�absolute_import�division�unicode_literals)�Trie)�	text_type�c@sVeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zddd
�Zdd�Z	dd�Z
dd�ZdS)rcCsjt�}|��D]*}t|t�s$td��|D]}|�|�q(qtd�|��|_|�	�D]\}}||j|<qRdS)NzAll keys must be strings�)
�set�keys�
isinstancer�	TypeError�add�DATrie�join�_data�items)�self�data�chars�key�char�value�r�E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/datrie.py�__init__
s
z
Trie.__init__cCs
||jkS�N�r�rrrrr�__contains__szTrie.__contains__cCs
t|j�Sr)�lenr�rrrr�__len__szTrie.__len__cCs
t��dSr)�NotImplementedErrorr rrr�__iter__sz
Trie.__iter__cCs
|j|Srrrrrr�__getitem__szTrie.__getitem__NcCs|j�|�Sr)rr
�r�prefixrrrr
"sz	Trie.keyscCs|j�|�Sr)r�has_keys_with_prefixr%rrrr'%szTrie.has_keys_with_prefixcCs|j�|�Sr)r�longest_prefixr%rrrr((szTrie.longest_prefixcCs|j�|�Sr)r�longest_prefix_itemr%rrrr)+szTrie.longest_prefix_item)N)�__name__�
__module__�__qualname__rrr!r#r$r
r'r(r)rrrrr	s
rN)Z
__future__rrrZdatrierrZpip._vendor.sixrZ_baseZABCTrierrrr�<module>ssite-packages/pip/_vendor/html5lib/_trie/__pycache__/_base.cpython-38.pyc000064400000003040151446177000022245 0ustar00U

��.e��@sZddlmZmZmZzddlmZWn ek
rDddlmZYnXGdd�de�ZdS)�)�absolute_import�division�unicode_literals)�Mappingcs:eZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Z�ZS)�TriezAbstract base class for triesNcs0tt|���}�dkrt|�S�fdd�|D�S)Ncsh|]}|���r|�qS�)�
startswith)�.0�x��prefixr�D/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/_base.py�	<setcomp>s
zTrie.keys.<locals>.<setcomp>)�superr�keys�set)�selfrr��	__class__rr
rsz	Trie.keyscCs"|��D]}|�|�rdSqdS)NTF)rr)rr�keyrrr
�has_keys_with_prefixs
zTrie.has_keys_with_prefixcCsT||kr|Stdt|�d�D](}|d|�|kr|d|�Sqt|��dS)N�)�range�len�KeyError)rr�irrr
�longest_prefixszTrie.longest_prefixcCs|�|�}|||fS)N)r)rrZlprefixrrr
�longest_prefix_item&s
zTrie.longest_prefix_item)N)	�__name__�
__module__�__qualname__�__doc__rrrr�
__classcell__rrrr
r	s
	
rN)	Z
__future__rrrZcollections.abcr�ImportError�collectionsrrrrr
�<module>s
site-packages/pip/_vendor/html5lib/_trie/__pycache__/datrie.cpython-38.pyc000064400000003721151446177000022452 0ustar00U

��.e��@sLddlmZmZmZddlmZddlmZddl	mZ
Gdd�de
�ZdS)�)�absolute_import�division�unicode_literals)�Trie)�	text_type�c@sVeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zddd
�Zdd�Z	dd�Z
dd�ZdS)rcCsjt�}|��D]*}t|t�s$td��|D]}|�|�q(qtd�|��|_|�	�D]\}}||j|<qRdS)NzAll keys must be strings�)
�set�keys�
isinstancer�	TypeError�add�DATrie�join�_data�items)�self�data�chars�key�char�value�r�E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/datrie.py�__init__
s
z
Trie.__init__cCs
||jkS�N�r�rrrrr�__contains__szTrie.__contains__cCs
t|j�Sr)�lenr�rrrr�__len__szTrie.__len__cCs
t��dSr)�NotImplementedErrorr rrr�__iter__sz
Trie.__iter__cCs
|j|Srrrrrr�__getitem__szTrie.__getitem__NcCs|j�|�Sr)rr
�r�prefixrrrr
"sz	Trie.keyscCs|j�|�Sr)r�has_keys_with_prefixr%rrrr'%szTrie.has_keys_with_prefixcCs|j�|�Sr)r�longest_prefixr%rrrr((szTrie.longest_prefixcCs|j�|�Sr)r�longest_prefix_itemr%rrrr)+szTrie.longest_prefix_item)N)�__name__�
__module__�__qualname__rrr!r#r$r
r'r(r)rrrrr	s
rN)Z
__future__rrrZdatrierrZpip._vendor.sixrZ_baseZABCTrierrrr�<module>ssite-packages/pip/_vendor/html5lib/_trie/__pycache__/_base.cpython-38.opt-1.pyc000064400000003040151446177000023204 0ustar00U

��.e��@sZddlmZmZmZzddlmZWn ek
rDddlmZYnXGdd�de�ZdS)�)�absolute_import�division�unicode_literals)�Mappingcs:eZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Z�ZS)�TriezAbstract base class for triesNcs0tt|���}�dkrt|�S�fdd�|D�S)Ncsh|]}|���r|�qS�)�
startswith)�.0�x��prefixr�D/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/_base.py�	<setcomp>s
zTrie.keys.<locals>.<setcomp>)�superr�keys�set)�selfrr��	__class__rr
rsz	Trie.keyscCs"|��D]}|�|�rdSqdS)NTF)rr)rr�keyrrr
�has_keys_with_prefixs
zTrie.has_keys_with_prefixcCsT||kr|Stdt|�d�D](}|d|�|kr|d|�Sqt|��dS)N�)�range�len�KeyError)rr�irrr
�longest_prefixszTrie.longest_prefixcCs|�|�}|||fS)N)r)rrZlprefixrrr
�longest_prefix_item&s
zTrie.longest_prefix_item)N)	�__name__�
__module__�__qualname__�__doc__rrrr�
__classcell__rrrr
r	s
	
rN)	Z
__future__rrrZcollections.abcr�ImportError�collectionsrrrrr
�<module>s
site-packages/pip/_vendor/html5lib/_trie/__pycache__/py.cpython-38.pyc000064400000004261151446177000021632 0ustar00U

��.e��@sLddlmZmZmZddlmZddlmZddlm	Z
Gdd�de
�Z	dS)	�)�absolute_import�division�unicode_literals)�	text_type)�bisect_left�)�Triec@sFeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zddd
�Zdd�Z	dS)rcCsJtdd�|��D��std��||_t|���|_d|_dt|�f|_dS)Ncss|]}t|t�VqdS�N)�
isinstancer)�.0�x�r
�A/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/py.py�	<genexpr>sz Trie.__init__.<locals>.<genexpr>zAll keys must be strings�r)	�all�keys�	TypeError�_data�sorted�_keys�	_cachestr�len�_cachepoints)�self�datar
r
r�__init__
sz
Trie.__init__cCs
||jkSr	�r�r�keyr
r
r�__contains__szTrie.__contains__cCs
t|j�Sr	)rr�rr
r
r�__len__szTrie.__len__cCs
t|j�Sr	)�iterrr!r
r
r�__iter__sz
Trie.__iter__cCs
|j|Sr	rrr
r
r�__getitem__szTrie.__getitem__NcCs�|dks|dks|js t|j�S|�|j�rL|j\}}t|j|||�}}nt|j|�}}t�}|t|j�krt|S|j|�|�r�|�|j|�|d7}qt||_||f|_|S)Nrr)r�set�
startswithrrrr�add)r�prefix�lo�hi�start�irr
r
rrs



z	Trie.keyscCsd||jkrdS|�|j�r6|j\}}t|j|||�}nt|j|�}|t|j�krTdS|j|�|�S)NTF)rr'rrrrr)rr)r*r+r-r
r
r�has_keys_with_prefix6s

zTrie.has_keys_with_prefix)N)
�__name__�
__module__�__qualname__rr r"r$r%rr.r
r
r
rr	s	
rN)Z
__future__rrrZpip._vendor.sixrZbisectrZ_baserZABCTrier
r
r
r�<module>ssite-packages/pip/_vendor/html5lib/_trie/__pycache__/py.cpython-38.opt-1.pyc000064400000004261151446177000022571 0ustar00U

��.e��@sLddlmZmZmZddlmZddlmZddlm	Z
Gdd�de
�Z	dS)	�)�absolute_import�division�unicode_literals)�	text_type)�bisect_left�)�Triec@sFeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zddd
�Zdd�Z	dS)rcCsJtdd�|��D��std��||_t|���|_d|_dt|�f|_dS)Ncss|]}t|t�VqdS�N)�
isinstancer)�.0�x�r
�A/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/py.py�	<genexpr>sz Trie.__init__.<locals>.<genexpr>zAll keys must be strings�r)	�all�keys�	TypeError�_data�sorted�_keys�	_cachestr�len�_cachepoints)�self�datar
r
r�__init__
sz
Trie.__init__cCs
||jkSr	�r�r�keyr
r
r�__contains__szTrie.__contains__cCs
t|j�Sr	)rr�rr
r
r�__len__szTrie.__len__cCs
t|j�Sr	)�iterrr!r
r
r�__iter__sz
Trie.__iter__cCs
|j|Sr	rrr
r
r�__getitem__szTrie.__getitem__NcCs�|dks|dks|js t|j�S|�|j�rL|j\}}t|j|||�}}nt|j|�}}t�}|t|j�krt|S|j|�|�r�|�|j|�|d7}qt||_||f|_|S)Nrr)r�set�
startswithrrrr�add)r�prefix�lo�hi�start�irr
r
rrs



z	Trie.keyscCsd||jkrdS|�|j�r6|j\}}t|j|||�}nt|j|�}|t|j�krTdS|j|�|�S)NTF)rr'rrrrr)rr)r*r+r-r
r
r�has_keys_with_prefix6s

zTrie.has_keys_with_prefix)N)
�__name__�
__module__�__qualname__rr r"r$r%rr.r
r
r
rr	s	
rN)Z
__future__rrrZpip._vendor.sixrZbisectrZ_baserZABCTrier
r
r
r�<module>ssite-packages/pip/_vendor/html5lib/_trie/__pycache__/__init__.cpython-38.pyc000064400000000605151446177000022737 0ustar00U

��.e!�@sRddlmZmZmZddlmZeZzddlmZWne	k
rHYnXeZdS)�)�absolute_import�division�unicode_literals�)�TrieN)
Z
__future__rrr�pyrZPyTrieZdatrieZDATrie�ImportError�r	r	�G/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_trie/__init__.py�<module>ssite-packages/pip/_vendor/html5lib/_trie/__init__.py000064400000000441151446177000016447 0ustar00from __future__ import absolute_import, division, unicode_literals

from .py import Trie as PyTrie

Trie = PyTrie

# pylint:disable=wrong-import-position
try:
    from .datrie import Trie as DATrie
except ImportError:
    pass
else:
    Trie = DATrie
# pylint:enable=wrong-import-position
site-packages/pip/_vendor/html5lib/_trie/py.py000064400000003357151446177000015351 0ustar00from __future__ import absolute_import, division, unicode_literals
from pip._vendor.six import text_type

from bisect import bisect_left

from ._base import Trie as ABCTrie


class Trie(ABCTrie):
    def __init__(self, data):
        if not all(isinstance(x, text_type) for x in data.keys()):
            raise TypeError("All keys must be strings")

        self._data = data
        self._keys = sorted(data.keys())
        self._cachestr = ""
        self._cachepoints = (0, len(data))

    def __contains__(self, key):
        return key in self._data

    def __len__(self):
        return len(self._data)

    def __iter__(self):
        return iter(self._data)

    def __getitem__(self, key):
        return self._data[key]

    def keys(self, prefix=None):
        if prefix is None or prefix == "" or not self._keys:
            return set(self._keys)

        if prefix.startswith(self._cachestr):
            lo, hi = self._cachepoints
            start = i = bisect_left(self._keys, prefix, lo, hi)
        else:
            start = i = bisect_left(self._keys, prefix)

        keys = set()
        if start == len(self._keys):
            return keys

        while self._keys[i].startswith(prefix):
            keys.add(self._keys[i])
            i += 1

        self._cachestr = prefix
        self._cachepoints = (start, i)

        return keys

    def has_keys_with_prefix(self, prefix):
        if prefix in self._data:
            return True

        if prefix.startswith(self._cachestr):
            lo, hi = self._cachepoints
            i = bisect_left(self._keys, prefix, lo, hi)
        else:
            i = bisect_left(self._keys, prefix)

        if i == len(self._keys):
            return False

        return self._keys[i].startswith(prefix)
site-packages/pip/_vendor/html5lib/_trie/datrie.py000064400000002232151446177000016160 0ustar00from __future__ import absolute_import, division, unicode_literals

from datrie import Trie as DATrie
from pip._vendor.six import text_type

from ._base import Trie as ABCTrie


class Trie(ABCTrie):
    def __init__(self, data):
        chars = set()
        for key in data.keys():
            if not isinstance(key, text_type):
                raise TypeError("All keys must be strings")
            for char in key:
                chars.add(char)

        self._data = DATrie("".join(chars))
        for key, value in data.items():
            self._data[key] = value

    def __contains__(self, key):
        return key in self._data

    def __len__(self):
        return len(self._data)

    def __iter__(self):
        raise NotImplementedError()

    def __getitem__(self, key):
        return self._data[key]

    def keys(self, prefix=None):
        return self._data.keys(prefix)

    def has_keys_with_prefix(self, prefix):
        return self._data.has_keys_with_prefix(prefix)

    def longest_prefix(self, prefix):
        return self._data.longest_prefix(prefix)

    def longest_prefix_item(self, prefix):
        return self._data.longest_prefix_item(prefix)
site-packages/pip/_vendor/html5lib/constants.py000064400000243076151446177000015637 0ustar00from __future__ import absolute_import, division, unicode_literals

import string

EOF = None

E = {
    "null-character":
        "Null character in input stream, replaced with U+FFFD.",
    "invalid-codepoint":
        "Invalid codepoint in stream.",
    "incorrectly-placed-solidus":
        "Solidus (/) incorrectly placed in tag.",
    "incorrect-cr-newline-entity":
        "Incorrect CR newline entity, replaced with LF.",
    "illegal-windows-1252-entity":
        "Entity used with illegal number (windows-1252 reference).",
    "cant-convert-numeric-entity":
        "Numeric entity couldn't be converted to character "
        "(codepoint U+%(charAsInt)08x).",
    "illegal-codepoint-for-numeric-entity":
        "Numeric entity represents an illegal codepoint: "
        "U+%(charAsInt)08x.",
    "numeric-entity-without-semicolon":
        "Numeric entity didn't end with ';'.",
    "expected-numeric-entity-but-got-eof":
        "Numeric entity expected. Got end of file instead.",
    "expected-numeric-entity":
        "Numeric entity expected but none found.",
    "named-entity-without-semicolon":
        "Named entity didn't end with ';'.",
    "expected-named-entity":
        "Named entity expected. Got none.",
    "attributes-in-end-tag":
        "End tag contains unexpected attributes.",
    'self-closing-flag-on-end-tag':
        "End tag contains unexpected self-closing flag.",
    "expected-tag-name-but-got-right-bracket":
        "Expected tag name. Got '>' instead.",
    "expected-tag-name-but-got-question-mark":
        "Expected tag name. Got '?' instead. (HTML doesn't "
        "support processing instructions.)",
    "expected-tag-name":
        "Expected tag name. Got something else instead",
    "expected-closing-tag-but-got-right-bracket":
        "Expected closing tag. Got '>' instead. Ignoring '</>'.",
    "expected-closing-tag-but-got-eof":
        "Expected closing tag. Unexpected end of file.",
    "expected-closing-tag-but-got-char":
        "Expected closing tag. Unexpected character '%(data)s' found.",
    "eof-in-tag-name":
        "Unexpected end of file in the tag name.",
    "expected-attribute-name-but-got-eof":
        "Unexpected end of file. Expected attribute name instead.",
    "eof-in-attribute-name":
        "Unexpected end of file in attribute name.",
    "invalid-character-in-attribute-name":
        "Invalid character in attribute name",
    "duplicate-attribute":
        "Dropped duplicate attribute on tag.",
    "expected-end-of-tag-name-but-got-eof":
        "Unexpected end of file. Expected = or end of tag.",
    "expected-attribute-value-but-got-eof":
        "Unexpected end of file. Expected attribute value.",
    "expected-attribute-value-but-got-right-bracket":
        "Expected attribute value. Got '>' instead.",
    'equals-in-unquoted-attribute-value':
        "Unexpected = in unquoted attribute",
    'unexpected-character-in-unquoted-attribute-value':
        "Unexpected character in unquoted attribute",
    "invalid-character-after-attribute-name":
        "Unexpected character after attribute name.",
    "unexpected-character-after-attribute-value":
        "Unexpected character after attribute value.",
    "eof-in-attribute-value-double-quote":
        "Unexpected end of file in attribute value (\").",
    "eof-in-attribute-value-single-quote":
        "Unexpected end of file in attribute value (').",
    "eof-in-attribute-value-no-quotes":
        "Unexpected end of file in attribute value.",
    "unexpected-EOF-after-solidus-in-tag":
        "Unexpected end of file in tag. Expected >",
    "unexpected-character-after-solidus-in-tag":
        "Unexpected character after / in tag. Expected >",
    "expected-dashes-or-doctype":
        "Expected '--' or 'DOCTYPE'. Not found.",
    "unexpected-bang-after-double-dash-in-comment":
        "Unexpected ! after -- in comment",
    "unexpected-space-after-double-dash-in-comment":
        "Unexpected space after -- in comment",
    "incorrect-comment":
        "Incorrect comment.",
    "eof-in-comment":
        "Unexpected end of file in comment.",
    "eof-in-comment-end-dash":
        "Unexpected end of file in comment (-)",
    "unexpected-dash-after-double-dash-in-comment":
        "Unexpected '-' after '--' found in comment.",
    "eof-in-comment-double-dash":
        "Unexpected end of file in comment (--).",
    "eof-in-comment-end-space-state":
        "Unexpected end of file in comment.",
    "eof-in-comment-end-bang-state":
        "Unexpected end of file in comment.",
    "unexpected-char-in-comment":
        "Unexpected character in comment found.",
    "need-space-after-doctype":
        "No space after literal string 'DOCTYPE'.",
    "expected-doctype-name-but-got-right-bracket":
        "Unexpected > character. Expected DOCTYPE name.",
    "expected-doctype-name-but-got-eof":
        "Unexpected end of file. Expected DOCTYPE name.",
    "eof-in-doctype-name":
        "Unexpected end of file in DOCTYPE name.",
    "eof-in-doctype":
        "Unexpected end of file in DOCTYPE.",
    "expected-space-or-right-bracket-in-doctype":
        "Expected space or '>'. Got '%(data)s'",
    "unexpected-end-of-doctype":
        "Unexpected end of DOCTYPE.",
    "unexpected-char-in-doctype":
        "Unexpected character in DOCTYPE.",
    "eof-in-innerhtml":
        "XXX innerHTML EOF",
    "unexpected-doctype":
        "Unexpected DOCTYPE. Ignored.",
    "non-html-root":
        "html needs to be the first start tag.",
    "expected-doctype-but-got-eof":
        "Unexpected End of file. Expected DOCTYPE.",
    "unknown-doctype":
        "Erroneous DOCTYPE.",
    "expected-doctype-but-got-chars":
        "Unexpected non-space characters. Expected DOCTYPE.",
    "expected-doctype-but-got-start-tag":
        "Unexpected start tag (%(name)s). Expected DOCTYPE.",
    "expected-doctype-but-got-end-tag":
        "Unexpected end tag (%(name)s). Expected DOCTYPE.",
    "end-tag-after-implied-root":
        "Unexpected end tag (%(name)s) after the (implied) root element.",
    "expected-named-closing-tag-but-got-eof":
        "Unexpected end of file. Expected end tag (%(name)s).",
    "two-heads-are-not-better-than-one":
        "Unexpected start tag head in existing head. Ignored.",
    "unexpected-end-tag":
        "Unexpected end tag (%(name)s). Ignored.",
    "unexpected-start-tag-out-of-my-head":
        "Unexpected start tag (%(name)s) that can be in head. Moved.",
    "unexpected-start-tag":
        "Unexpected start tag (%(name)s).",
    "missing-end-tag":
        "Missing end tag (%(name)s).",
    "missing-end-tags":
        "Missing end tags (%(name)s).",
    "unexpected-start-tag-implies-end-tag":
        "Unexpected start tag (%(startName)s) "
        "implies end tag (%(endName)s).",
    "unexpected-start-tag-treated-as":
        "Unexpected start tag (%(originalName)s). Treated as %(newName)s.",
    "deprecated-tag":
        "Unexpected start tag %(name)s. Don't use it!",
    "unexpected-start-tag-ignored":
        "Unexpected start tag %(name)s. Ignored.",
    "expected-one-end-tag-but-got-another":
        "Unexpected end tag (%(gotName)s). "
        "Missing end tag (%(expectedName)s).",
    "end-tag-too-early":
        "End tag (%(name)s) seen too early. Expected other end tag.",
    "end-tag-too-early-named":
        "Unexpected end tag (%(gotName)s). Expected end tag (%(expectedName)s).",
    "end-tag-too-early-ignored":
        "End tag (%(name)s) seen too early. Ignored.",
    "adoption-agency-1.1":
        "End tag (%(name)s) violates step 1, "
        "paragraph 1 of the adoption agency algorithm.",
    "adoption-agency-1.2":
        "End tag (%(name)s) violates step 1, "
        "paragraph 2 of the adoption agency algorithm.",
    "adoption-agency-1.3":
        "End tag (%(name)s) violates step 1, "
        "paragraph 3 of the adoption agency algorithm.",
    "adoption-agency-4.4":
        "End tag (%(name)s) violates step 4, "
        "paragraph 4 of the adoption agency algorithm.",
    "unexpected-end-tag-treated-as":
        "Unexpected end tag (%(originalName)s). Treated as %(newName)s.",
    "no-end-tag":
        "This element (%(name)s) has no end tag.",
    "unexpected-implied-end-tag-in-table":
        "Unexpected implied end tag (%(name)s) in the table phase.",
    "unexpected-implied-end-tag-in-table-body":
        "Unexpected implied end tag (%(name)s) in the table body phase.",
    "unexpected-char-implies-table-voodoo":
        "Unexpected non-space characters in "
        "table context caused voodoo mode.",
    "unexpected-hidden-input-in-table":
        "Unexpected input with type hidden in table context.",
    "unexpected-form-in-table":
        "Unexpected form in table context.",
    "unexpected-start-tag-implies-table-voodoo":
        "Unexpected start tag (%(name)s) in "
        "table context caused voodoo mode.",
    "unexpected-end-tag-implies-table-voodoo":
        "Unexpected end tag (%(name)s) in "
        "table context caused voodoo mode.",
    "unexpected-cell-in-table-body":
        "Unexpected table cell start tag (%(name)s) "
        "in the table body phase.",
    "unexpected-cell-end-tag":
        "Got table cell end tag (%(name)s) "
        "while required end tags are missing.",
    "unexpected-end-tag-in-table-body":
        "Unexpected end tag (%(name)s) in the table body phase. Ignored.",
    "unexpected-implied-end-tag-in-table-row":
        "Unexpected implied end tag (%(name)s) in the table row phase.",
    "unexpected-end-tag-in-table-row":
        "Unexpected end tag (%(name)s) in the table row phase. Ignored.",
    "unexpected-select-in-select":
        "Unexpected select start tag in the select phase "
        "treated as select end tag.",
    "unexpected-input-in-select":
        "Unexpected input start tag in the select phase.",
    "unexpected-start-tag-in-select":
        "Unexpected start tag token (%(name)s in the select phase. "
        "Ignored.",
    "unexpected-end-tag-in-select":
        "Unexpected end tag (%(name)s) in the select phase. Ignored.",
    "unexpected-table-element-start-tag-in-select-in-table":
        "Unexpected table element start tag (%(name)s) in the select in table phase.",
    "unexpected-table-element-end-tag-in-select-in-table":
        "Unexpected table element end tag (%(name)s) in the select in table phase.",
    "unexpected-char-after-body":
        "Unexpected non-space characters in the after body phase.",
    "unexpected-start-tag-after-body":
        "Unexpected start tag token (%(name)s)"
        " in the after body phase.",
    "unexpected-end-tag-after-body":
        "Unexpected end tag token (%(name)s)"
        " in the after body phase.",
    "unexpected-char-in-frameset":
        "Unexpected characters in the frameset phase. Characters ignored.",
    "unexpected-start-tag-in-frameset":
        "Unexpected start tag token (%(name)s)"
        " in the frameset phase. Ignored.",
    "unexpected-frameset-in-frameset-innerhtml":
        "Unexpected end tag token (frameset) "
        "in the frameset phase (innerHTML).",
    "unexpected-end-tag-in-frameset":
        "Unexpected end tag token (%(name)s)"
        " in the frameset phase. Ignored.",
    "unexpected-char-after-frameset":
        "Unexpected non-space characters in the "
        "after frameset phase. Ignored.",
    "unexpected-start-tag-after-frameset":
        "Unexpected start tag (%(name)s)"
        " in the after frameset phase. Ignored.",
    "unexpected-end-tag-after-frameset":
        "Unexpected end tag (%(name)s)"
        " in the after frameset phase. Ignored.",
    "unexpected-end-tag-after-body-innerhtml":
        "Unexpected end tag after body(innerHtml)",
    "expected-eof-but-got-char":
        "Unexpected non-space characters. Expected end of file.",
    "expected-eof-but-got-start-tag":
        "Unexpected start tag (%(name)s)"
        ". Expected end of file.",
    "expected-eof-but-got-end-tag":
        "Unexpected end tag (%(name)s)"
        ". Expected end of file.",
    "eof-in-table":
        "Unexpected end of file. Expected table content.",
    "eof-in-select":
        "Unexpected end of file. Expected select content.",
    "eof-in-frameset":
        "Unexpected end of file. Expected frameset content.",
    "eof-in-script-in-script":
        "Unexpected end of file. Expected script content.",
    "eof-in-foreign-lands":
        "Unexpected end of file. Expected foreign content",
    "non-void-element-with-trailing-solidus":
        "Trailing solidus not allowed on element %(name)s",
    "unexpected-html-element-in-foreign-content":
        "Element %(name)s not allowed in a non-html context",
    "unexpected-end-tag-before-html":
        "Unexpected end tag (%(name)s) before html.",
    "unexpected-inhead-noscript-tag":
        "Element %(name)s not allowed in a inhead-noscript context",
    "eof-in-head-noscript":
        "Unexpected end of file. Expected inhead-noscript content",
    "char-in-head-noscript":
        "Unexpected non-space character. Expected inhead-noscript content",
    "XXX-undefined-error":
        "Undefined error (this sucks and should be fixed)",
}

namespaces = {
    "html": "http://www.w3.org/1999/xhtml",
    "mathml": "http://www.w3.org/1998/Math/MathML",
    "svg": "http://www.w3.org/2000/svg",
    "xlink": "http://www.w3.org/1999/xlink",
    "xml": "http://www.w3.org/XML/1998/namespace",
    "xmlns": "http://www.w3.org/2000/xmlns/"
}

scopingElements = frozenset([
    (namespaces["html"], "applet"),
    (namespaces["html"], "caption"),
    (namespaces["html"], "html"),
    (namespaces["html"], "marquee"),
    (namespaces["html"], "object"),
    (namespaces["html"], "table"),
    (namespaces["html"], "td"),
    (namespaces["html"], "th"),
    (namespaces["mathml"], "mi"),
    (namespaces["mathml"], "mo"),
    (namespaces["mathml"], "mn"),
    (namespaces["mathml"], "ms"),
    (namespaces["mathml"], "mtext"),
    (namespaces["mathml"], "annotation-xml"),
    (namespaces["svg"], "foreignObject"),
    (namespaces["svg"], "desc"),
    (namespaces["svg"], "title"),
])

formattingElements = frozenset([
    (namespaces["html"], "a"),
    (namespaces["html"], "b"),
    (namespaces["html"], "big"),
    (namespaces["html"], "code"),
    (namespaces["html"], "em"),
    (namespaces["html"], "font"),
    (namespaces["html"], "i"),
    (namespaces["html"], "nobr"),
    (namespaces["html"], "s"),
    (namespaces["html"], "small"),
    (namespaces["html"], "strike"),
    (namespaces["html"], "strong"),
    (namespaces["html"], "tt"),
    (namespaces["html"], "u")
])

specialElements = frozenset([
    (namespaces["html"], "address"),
    (namespaces["html"], "applet"),
    (namespaces["html"], "area"),
    (namespaces["html"], "article"),
    (namespaces["html"], "aside"),
    (namespaces["html"], "base"),
    (namespaces["html"], "basefont"),
    (namespaces["html"], "bgsound"),
    (namespaces["html"], "blockquote"),
    (namespaces["html"], "body"),
    (namespaces["html"], "br"),
    (namespaces["html"], "button"),
    (namespaces["html"], "caption"),
    (namespaces["html"], "center"),
    (namespaces["html"], "col"),
    (namespaces["html"], "colgroup"),
    (namespaces["html"], "command"),
    (namespaces["html"], "dd"),
    (namespaces["html"], "details"),
    (namespaces["html"], "dir"),
    (namespaces["html"], "div"),
    (namespaces["html"], "dl"),
    (namespaces["html"], "dt"),
    (namespaces["html"], "embed"),
    (namespaces["html"], "fieldset"),
    (namespaces["html"], "figure"),
    (namespaces["html"], "footer"),
    (namespaces["html"], "form"),
    (namespaces["html"], "frame"),
    (namespaces["html"], "frameset"),
    (namespaces["html"], "h1"),
    (namespaces["html"], "h2"),
    (namespaces["html"], "h3"),
    (namespaces["html"], "h4"),
    (namespaces["html"], "h5"),
    (namespaces["html"], "h6"),
    (namespaces["html"], "head"),
    (namespaces["html"], "header"),
    (namespaces["html"], "hr"),
    (namespaces["html"], "html"),
    (namespaces["html"], "iframe"),
    # Note that image is commented out in the spec as "this isn't an
    # element that can end up on the stack, so it doesn't matter,"
    (namespaces["html"], "image"),
    (namespaces["html"], "img"),
    (namespaces["html"], "input"),
    (namespaces["html"], "isindex"),
    (namespaces["html"], "li"),
    (namespaces["html"], "link"),
    (namespaces["html"], "listing"),
    (namespaces["html"], "marquee"),
    (namespaces["html"], "menu"),
    (namespaces["html"], "meta"),
    (namespaces["html"], "nav"),
    (namespaces["html"], "noembed"),
    (namespaces["html"], "noframes"),
    (namespaces["html"], "noscript"),
    (namespaces["html"], "object"),
    (namespaces["html"], "ol"),
    (namespaces["html"], "p"),
    (namespaces["html"], "param"),
    (namespaces["html"], "plaintext"),
    (namespaces["html"], "pre"),
    (namespaces["html"], "script"),
    (namespaces["html"], "section"),
    (namespaces["html"], "select"),
    (namespaces["html"], "style"),
    (namespaces["html"], "table"),
    (namespaces["html"], "tbody"),
    (namespaces["html"], "td"),
    (namespaces["html"], "textarea"),
    (namespaces["html"], "tfoot"),
    (namespaces["html"], "th"),
    (namespaces["html"], "thead"),
    (namespaces["html"], "title"),
    (namespaces["html"], "tr"),
    (namespaces["html"], "ul"),
    (namespaces["html"], "wbr"),
    (namespaces["html"], "xmp"),
    (namespaces["svg"], "foreignObject")
])

htmlIntegrationPointElements = frozenset([
    (namespaces["mathml"], "annotation-xml"),
    (namespaces["svg"], "foreignObject"),
    (namespaces["svg"], "desc"),
    (namespaces["svg"], "title")
])

mathmlTextIntegrationPointElements = frozenset([
    (namespaces["mathml"], "mi"),
    (namespaces["mathml"], "mo"),
    (namespaces["mathml"], "mn"),
    (namespaces["mathml"], "ms"),
    (namespaces["mathml"], "mtext")
])

adjustSVGAttributes = {
    "attributename": "attributeName",
    "attributetype": "attributeType",
    "basefrequency": "baseFrequency",
    "baseprofile": "baseProfile",
    "calcmode": "calcMode",
    "clippathunits": "clipPathUnits",
    "contentscripttype": "contentScriptType",
    "contentstyletype": "contentStyleType",
    "diffuseconstant": "diffuseConstant",
    "edgemode": "edgeMode",
    "externalresourcesrequired": "externalResourcesRequired",
    "filterres": "filterRes",
    "filterunits": "filterUnits",
    "glyphref": "glyphRef",
    "gradienttransform": "gradientTransform",
    "gradientunits": "gradientUnits",
    "kernelmatrix": "kernelMatrix",
    "kernelunitlength": "kernelUnitLength",
    "keypoints": "keyPoints",
    "keysplines": "keySplines",
    "keytimes": "keyTimes",
    "lengthadjust": "lengthAdjust",
    "limitingconeangle": "limitingConeAngle",
    "markerheight": "markerHeight",
    "markerunits": "markerUnits",
    "markerwidth": "markerWidth",
    "maskcontentunits": "maskContentUnits",
    "maskunits": "maskUnits",
    "numoctaves": "numOctaves",
    "pathlength": "pathLength",
    "patterncontentunits": "patternContentUnits",
    "patterntransform": "patternTransform",
    "patternunits": "patternUnits",
    "pointsatx": "pointsAtX",
    "pointsaty": "pointsAtY",
    "pointsatz": "pointsAtZ",
    "preservealpha": "preserveAlpha",
    "preserveaspectratio": "preserveAspectRatio",
    "primitiveunits": "primitiveUnits",
    "refx": "refX",
    "refy": "refY",
    "repeatcount": "repeatCount",
    "repeatdur": "repeatDur",
    "requiredextensions": "requiredExtensions",
    "requiredfeatures": "requiredFeatures",
    "specularconstant": "specularConstant",
    "specularexponent": "specularExponent",
    "spreadmethod": "spreadMethod",
    "startoffset": "startOffset",
    "stddeviation": "stdDeviation",
    "stitchtiles": "stitchTiles",
    "surfacescale": "surfaceScale",
    "systemlanguage": "systemLanguage",
    "tablevalues": "tableValues",
    "targetx": "targetX",
    "targety": "targetY",
    "textlength": "textLength",
    "viewbox": "viewBox",
    "viewtarget": "viewTarget",
    "xchannelselector": "xChannelSelector",
    "ychannelselector": "yChannelSelector",
    "zoomandpan": "zoomAndPan"
}

adjustMathMLAttributes = {"definitionurl": "definitionURL"}

adjustForeignAttributes = {
    "xlink:actuate": ("xlink", "actuate", namespaces["xlink"]),
    "xlink:arcrole": ("xlink", "arcrole", namespaces["xlink"]),
    "xlink:href": ("xlink", "href", namespaces["xlink"]),
    "xlink:role": ("xlink", "role", namespaces["xlink"]),
    "xlink:show": ("xlink", "show", namespaces["xlink"]),
    "xlink:title": ("xlink", "title", namespaces["xlink"]),
    "xlink:type": ("xlink", "type", namespaces["xlink"]),
    "xml:base": ("xml", "base", namespaces["xml"]),
    "xml:lang": ("xml", "lang", namespaces["xml"]),
    "xml:space": ("xml", "space", namespaces["xml"]),
    "xmlns": (None, "xmlns", namespaces["xmlns"]),
    "xmlns:xlink": ("xmlns", "xlink", namespaces["xmlns"])
}

unadjustForeignAttributes = dict([((ns, local), qname) for qname, (prefix, local, ns) in
                                  adjustForeignAttributes.items()])

spaceCharacters = frozenset([
    "\t",
    "\n",
    "\u000C",
    " ",
    "\r"
])

tableInsertModeElements = frozenset([
    "table",
    "tbody",
    "tfoot",
    "thead",
    "tr"
])

asciiLowercase = frozenset(string.ascii_lowercase)
asciiUppercase = frozenset(string.ascii_uppercase)
asciiLetters = frozenset(string.ascii_letters)
digits = frozenset(string.digits)
hexDigits = frozenset(string.hexdigits)

asciiUpper2Lower = dict([(ord(c), ord(c.lower()))
                         for c in string.ascii_uppercase])

# Heading elements need to be ordered
headingElements = (
    "h1",
    "h2",
    "h3",
    "h4",
    "h5",
    "h6"
)

voidElements = frozenset([
    "base",
    "command",
    "event-source",
    "link",
    "meta",
    "hr",
    "br",
    "img",
    "embed",
    "param",
    "area",
    "col",
    "input",
    "source",
    "track"
])

cdataElements = frozenset(['title', 'textarea'])

rcdataElements = frozenset([
    'style',
    'script',
    'xmp',
    'iframe',
    'noembed',
    'noframes',
    'noscript'
])

booleanAttributes = {
    "": frozenset(["irrelevant", "itemscope"]),
    "style": frozenset(["scoped"]),
    "img": frozenset(["ismap"]),
    "audio": frozenset(["autoplay", "controls"]),
    "video": frozenset(["autoplay", "controls"]),
    "script": frozenset(["defer", "async"]),
    "details": frozenset(["open"]),
    "datagrid": frozenset(["multiple", "disabled"]),
    "command": frozenset(["hidden", "disabled", "checked", "default"]),
    "hr": frozenset(["noshade"]),
    "menu": frozenset(["autosubmit"]),
    "fieldset": frozenset(["disabled", "readonly"]),
    "option": frozenset(["disabled", "readonly", "selected"]),
    "optgroup": frozenset(["disabled", "readonly"]),
    "button": frozenset(["disabled", "autofocus"]),
    "input": frozenset(["disabled", "readonly", "required", "autofocus", "checked", "ismap"]),
    "select": frozenset(["disabled", "readonly", "autofocus", "multiple"]),
    "output": frozenset(["disabled", "readonly"]),
    "iframe": frozenset(["seamless"]),
}

# entitiesWindows1252 has to be _ordered_ and needs to have an index. It
# therefore can't be a frozenset.
entitiesWindows1252 = (
    8364,   # 0x80  0x20AC  EURO SIGN
    65533,  # 0x81          UNDEFINED
    8218,   # 0x82  0x201A  SINGLE LOW-9 QUOTATION MARK
    402,    # 0x83  0x0192  LATIN SMALL LETTER F WITH HOOK
    8222,   # 0x84  0x201E  DOUBLE LOW-9 QUOTATION MARK
    8230,   # 0x85  0x2026  HORIZONTAL ELLIPSIS
    8224,   # 0x86  0x2020  DAGGER
    8225,   # 0x87  0x2021  DOUBLE DAGGER
    710,    # 0x88  0x02C6  MODIFIER LETTER CIRCUMFLEX ACCENT
    8240,   # 0x89  0x2030  PER MILLE SIGN
    352,    # 0x8A  0x0160  LATIN CAPITAL LETTER S WITH CARON
    8249,   # 0x8B  0x2039  SINGLE LEFT-POINTING ANGLE QUOTATION MARK
    338,    # 0x8C  0x0152  LATIN CAPITAL LIGATURE OE
    65533,  # 0x8D          UNDEFINED
    381,    # 0x8E  0x017D  LATIN CAPITAL LETTER Z WITH CARON
    65533,  # 0x8F          UNDEFINED
    65533,  # 0x90          UNDEFINED
    8216,   # 0x91  0x2018  LEFT SINGLE QUOTATION MARK
    8217,   # 0x92  0x2019  RIGHT SINGLE QUOTATION MARK
    8220,   # 0x93  0x201C  LEFT DOUBLE QUOTATION MARK
    8221,   # 0x94  0x201D  RIGHT DOUBLE QUOTATION MARK
    8226,   # 0x95  0x2022  BULLET
    8211,   # 0x96  0x2013  EN DASH
    8212,   # 0x97  0x2014  EM DASH
    732,    # 0x98  0x02DC  SMALL TILDE
    8482,   # 0x99  0x2122  TRADE MARK SIGN
    353,    # 0x9A  0x0161  LATIN SMALL LETTER S WITH CARON
    8250,   # 0x9B  0x203A  SINGLE RIGHT-POINTING ANGLE QUOTATION MARK
    339,    # 0x9C  0x0153  LATIN SMALL LIGATURE OE
    65533,  # 0x9D          UNDEFINED
    382,    # 0x9E  0x017E  LATIN SMALL LETTER Z WITH CARON
    376     # 0x9F  0x0178  LATIN CAPITAL LETTER Y WITH DIAERESIS
)

xmlEntities = frozenset(['lt;', 'gt;', 'amp;', 'apos;', 'quot;'])

entities = {
    "AElig": "\xc6",
    "AElig;": "\xc6",
    "AMP": "&",
    "AMP;": "&",
    "Aacute": "\xc1",
    "Aacute;": "\xc1",
    "Abreve;": "\u0102",
    "Acirc": "\xc2",
    "Acirc;": "\xc2",
    "Acy;": "\u0410",
    "Afr;": "\U0001d504",
    "Agrave": "\xc0",
    "Agrave;": "\xc0",
    "Alpha;": "\u0391",
    "Amacr;": "\u0100",
    "And;": "\u2a53",
    "Aogon;": "\u0104",
    "Aopf;": "\U0001d538",
    "ApplyFunction;": "\u2061",
    "Aring": "\xc5",
    "Aring;": "\xc5",
    "Ascr;": "\U0001d49c",
    "Assign;": "\u2254",
    "Atilde": "\xc3",
    "Atilde;": "\xc3",
    "Auml": "\xc4",
    "Auml;": "\xc4",
    "Backslash;": "\u2216",
    "Barv;": "\u2ae7",
    "Barwed;": "\u2306",
    "Bcy;": "\u0411",
    "Because;": "\u2235",
    "Bernoullis;": "\u212c",
    "Beta;": "\u0392",
    "Bfr;": "\U0001d505",
    "Bopf;": "\U0001d539",
    "Breve;": "\u02d8",
    "Bscr;": "\u212c",
    "Bumpeq;": "\u224e",
    "CHcy;": "\u0427",
    "COPY": "\xa9",
    "COPY;": "\xa9",
    "Cacute;": "\u0106",
    "Cap;": "\u22d2",
    "CapitalDifferentialD;": "\u2145",
    "Cayleys;": "\u212d",
    "Ccaron;": "\u010c",
    "Ccedil": "\xc7",
    "Ccedil;": "\xc7",
    "Ccirc;": "\u0108",
    "Cconint;": "\u2230",
    "Cdot;": "\u010a",
    "Cedilla;": "\xb8",
    "CenterDot;": "\xb7",
    "Cfr;": "\u212d",
    "Chi;": "\u03a7",
    "CircleDot;": "\u2299",
    "CircleMinus;": "\u2296",
    "CirclePlus;": "\u2295",
    "CircleTimes;": "\u2297",
    "ClockwiseContourIntegral;": "\u2232",
    "CloseCurlyDoubleQuote;": "\u201d",
    "CloseCurlyQuote;": "\u2019",
    "Colon;": "\u2237",
    "Colone;": "\u2a74",
    "Congruent;": "\u2261",
    "Conint;": "\u222f",
    "ContourIntegral;": "\u222e",
    "Copf;": "\u2102",
    "Coproduct;": "\u2210",
    "CounterClockwiseContourIntegral;": "\u2233",
    "Cross;": "\u2a2f",
    "Cscr;": "\U0001d49e",
    "Cup;": "\u22d3",
    "CupCap;": "\u224d",
    "DD;": "\u2145",
    "DDotrahd;": "\u2911",
    "DJcy;": "\u0402",
    "DScy;": "\u0405",
    "DZcy;": "\u040f",
    "Dagger;": "\u2021",
    "Darr;": "\u21a1",
    "Dashv;": "\u2ae4",
    "Dcaron;": "\u010e",
    "Dcy;": "\u0414",
    "Del;": "\u2207",
    "Delta;": "\u0394",
    "Dfr;": "\U0001d507",
    "DiacriticalAcute;": "\xb4",
    "DiacriticalDot;": "\u02d9",
    "DiacriticalDoubleAcute;": "\u02dd",
    "DiacriticalGrave;": "`",
    "DiacriticalTilde;": "\u02dc",
    "Diamond;": "\u22c4",
    "DifferentialD;": "\u2146",
    "Dopf;": "\U0001d53b",
    "Dot;": "\xa8",
    "DotDot;": "\u20dc",
    "DotEqual;": "\u2250",
    "DoubleContourIntegral;": "\u222f",
    "DoubleDot;": "\xa8",
    "DoubleDownArrow;": "\u21d3",
    "DoubleLeftArrow;": "\u21d0",
    "DoubleLeftRightArrow;": "\u21d4",
    "DoubleLeftTee;": "\u2ae4",
    "DoubleLongLeftArrow;": "\u27f8",
    "DoubleLongLeftRightArrow;": "\u27fa",
    "DoubleLongRightArrow;": "\u27f9",
    "DoubleRightArrow;": "\u21d2",
    "DoubleRightTee;": "\u22a8",
    "DoubleUpArrow;": "\u21d1",
    "DoubleUpDownArrow;": "\u21d5",
    "DoubleVerticalBar;": "\u2225",
    "DownArrow;": "\u2193",
    "DownArrowBar;": "\u2913",
    "DownArrowUpArrow;": "\u21f5",
    "DownBreve;": "\u0311",
    "DownLeftRightVector;": "\u2950",
    "DownLeftTeeVector;": "\u295e",
    "DownLeftVector;": "\u21bd",
    "DownLeftVectorBar;": "\u2956",
    "DownRightTeeVector;": "\u295f",
    "DownRightVector;": "\u21c1",
    "DownRightVectorBar;": "\u2957",
    "DownTee;": "\u22a4",
    "DownTeeArrow;": "\u21a7",
    "Downarrow;": "\u21d3",
    "Dscr;": "\U0001d49f",
    "Dstrok;": "\u0110",
    "ENG;": "\u014a",
    "ETH": "\xd0",
    "ETH;": "\xd0",
    "Eacute": "\xc9",
    "Eacute;": "\xc9",
    "Ecaron;": "\u011a",
    "Ecirc": "\xca",
    "Ecirc;": "\xca",
    "Ecy;": "\u042d",
    "Edot;": "\u0116",
    "Efr;": "\U0001d508",
    "Egrave": "\xc8",
    "Egrave;": "\xc8",
    "Element;": "\u2208",
    "Emacr;": "\u0112",
    "EmptySmallSquare;": "\u25fb",
    "EmptyVerySmallSquare;": "\u25ab",
    "Eogon;": "\u0118",
    "Eopf;": "\U0001d53c",
    "Epsilon;": "\u0395",
    "Equal;": "\u2a75",
    "EqualTilde;": "\u2242",
    "Equilibrium;": "\u21cc",
    "Escr;": "\u2130",
    "Esim;": "\u2a73",
    "Eta;": "\u0397",
    "Euml": "\xcb",
    "Euml;": "\xcb",
    "Exists;": "\u2203",
    "ExponentialE;": "\u2147",
    "Fcy;": "\u0424",
    "Ffr;": "\U0001d509",
    "FilledSmallSquare;": "\u25fc",
    "FilledVerySmallSquare;": "\u25aa",
    "Fopf;": "\U0001d53d",
    "ForAll;": "\u2200",
    "Fouriertrf;": "\u2131",
    "Fscr;": "\u2131",
    "GJcy;": "\u0403",
    "GT": ">",
    "GT;": ">",
    "Gamma;": "\u0393",
    "Gammad;": "\u03dc",
    "Gbreve;": "\u011e",
    "Gcedil;": "\u0122",
    "Gcirc;": "\u011c",
    "Gcy;": "\u0413",
    "Gdot;": "\u0120",
    "Gfr;": "\U0001d50a",
    "Gg;": "\u22d9",
    "Gopf;": "\U0001d53e",
    "GreaterEqual;": "\u2265",
    "GreaterEqualLess;": "\u22db",
    "GreaterFullEqual;": "\u2267",
    "GreaterGreater;": "\u2aa2",
    "GreaterLess;": "\u2277",
    "GreaterSlantEqual;": "\u2a7e",
    "GreaterTilde;": "\u2273",
    "Gscr;": "\U0001d4a2",
    "Gt;": "\u226b",
    "HARDcy;": "\u042a",
    "Hacek;": "\u02c7",
    "Hat;": "^",
    "Hcirc;": "\u0124",
    "Hfr;": "\u210c",
    "HilbertSpace;": "\u210b",
    "Hopf;": "\u210d",
    "HorizontalLine;": "\u2500",
    "Hscr;": "\u210b",
    "Hstrok;": "\u0126",
    "HumpDownHump;": "\u224e",
    "HumpEqual;": "\u224f",
    "IEcy;": "\u0415",
    "IJlig;": "\u0132",
    "IOcy;": "\u0401",
    "Iacute": "\xcd",
    "Iacute;": "\xcd",
    "Icirc": "\xce",
    "Icirc;": "\xce",
    "Icy;": "\u0418",
    "Idot;": "\u0130",
    "Ifr;": "\u2111",
    "Igrave": "\xcc",
    "Igrave;": "\xcc",
    "Im;": "\u2111",
    "Imacr;": "\u012a",
    "ImaginaryI;": "\u2148",
    "Implies;": "\u21d2",
    "Int;": "\u222c",
    "Integral;": "\u222b",
    "Intersection;": "\u22c2",
    "InvisibleComma;": "\u2063",
    "InvisibleTimes;": "\u2062",
    "Iogon;": "\u012e",
    "Iopf;": "\U0001d540",
    "Iota;": "\u0399",
    "Iscr;": "\u2110",
    "Itilde;": "\u0128",
    "Iukcy;": "\u0406",
    "Iuml": "\xcf",
    "Iuml;": "\xcf",
    "Jcirc;": "\u0134",
    "Jcy;": "\u0419",
    "Jfr;": "\U0001d50d",
    "Jopf;": "\U0001d541",
    "Jscr;": "\U0001d4a5",
    "Jsercy;": "\u0408",
    "Jukcy;": "\u0404",
    "KHcy;": "\u0425",
    "KJcy;": "\u040c",
    "Kappa;": "\u039a",
    "Kcedil;": "\u0136",
    "Kcy;": "\u041a",
    "Kfr;": "\U0001d50e",
    "Kopf;": "\U0001d542",
    "Kscr;": "\U0001d4a6",
    "LJcy;": "\u0409",
    "LT": "<",
    "LT;": "<",
    "Lacute;": "\u0139",
    "Lambda;": "\u039b",
    "Lang;": "\u27ea",
    "Laplacetrf;": "\u2112",
    "Larr;": "\u219e",
    "Lcaron;": "\u013d",
    "Lcedil;": "\u013b",
    "Lcy;": "\u041b",
    "LeftAngleBracket;": "\u27e8",
    "LeftArrow;": "\u2190",
    "LeftArrowBar;": "\u21e4",
    "LeftArrowRightArrow;": "\u21c6",
    "LeftCeiling;": "\u2308",
    "LeftDoubleBracket;": "\u27e6",
    "LeftDownTeeVector;": "\u2961",
    "LeftDownVector;": "\u21c3",
    "LeftDownVectorBar;": "\u2959",
    "LeftFloor;": "\u230a",
    "LeftRightArrow;": "\u2194",
    "LeftRightVector;": "\u294e",
    "LeftTee;": "\u22a3",
    "LeftTeeArrow;": "\u21a4",
    "LeftTeeVector;": "\u295a",
    "LeftTriangle;": "\u22b2",
    "LeftTriangleBar;": "\u29cf",
    "LeftTriangleEqual;": "\u22b4",
    "LeftUpDownVector;": "\u2951",
    "LeftUpTeeVector;": "\u2960",
    "LeftUpVector;": "\u21bf",
    "LeftUpVectorBar;": "\u2958",
    "LeftVector;": "\u21bc",
    "LeftVectorBar;": "\u2952",
    "Leftarrow;": "\u21d0",
    "Leftrightarrow;": "\u21d4",
    "LessEqualGreater;": "\u22da",
    "LessFullEqual;": "\u2266",
    "LessGreater;": "\u2276",
    "LessLess;": "\u2aa1",
    "LessSlantEqual;": "\u2a7d",
    "LessTilde;": "\u2272",
    "Lfr;": "\U0001d50f",
    "Ll;": "\u22d8",
    "Lleftarrow;": "\u21da",
    "Lmidot;": "\u013f",
    "LongLeftArrow;": "\u27f5",
    "LongLeftRightArrow;": "\u27f7",
    "LongRightArrow;": "\u27f6",
    "Longleftarrow;": "\u27f8",
    "Longleftrightarrow;": "\u27fa",
    "Longrightarrow;": "\u27f9",
    "Lopf;": "\U0001d543",
    "LowerLeftArrow;": "\u2199",
    "LowerRightArrow;": "\u2198",
    "Lscr;": "\u2112",
    "Lsh;": "\u21b0",
    "Lstrok;": "\u0141",
    "Lt;": "\u226a",
    "Map;": "\u2905",
    "Mcy;": "\u041c",
    "MediumSpace;": "\u205f",
    "Mellintrf;": "\u2133",
    "Mfr;": "\U0001d510",
    "MinusPlus;": "\u2213",
    "Mopf;": "\U0001d544",
    "Mscr;": "\u2133",
    "Mu;": "\u039c",
    "NJcy;": "\u040a",
    "Nacute;": "\u0143",
    "Ncaron;": "\u0147",
    "Ncedil;": "\u0145",
    "Ncy;": "\u041d",
    "NegativeMediumSpace;": "\u200b",
    "NegativeThickSpace;": "\u200b",
    "NegativeThinSpace;": "\u200b",
    "NegativeVeryThinSpace;": "\u200b",
    "NestedGreaterGreater;": "\u226b",
    "NestedLessLess;": "\u226a",
    "NewLine;": "\n",
    "Nfr;": "\U0001d511",
    "NoBreak;": "\u2060",
    "NonBreakingSpace;": "\xa0",
    "Nopf;": "\u2115",
    "Not;": "\u2aec",
    "NotCongruent;": "\u2262",
    "NotCupCap;": "\u226d",
    "NotDoubleVerticalBar;": "\u2226",
    "NotElement;": "\u2209",
    "NotEqual;": "\u2260",
    "NotEqualTilde;": "\u2242\u0338",
    "NotExists;": "\u2204",
    "NotGreater;": "\u226f",
    "NotGreaterEqual;": "\u2271",
    "NotGreaterFullEqual;": "\u2267\u0338",
    "NotGreaterGreater;": "\u226b\u0338",
    "NotGreaterLess;": "\u2279",
    "NotGreaterSlantEqual;": "\u2a7e\u0338",
    "NotGreaterTilde;": "\u2275",
    "NotHumpDownHump;": "\u224e\u0338",
    "NotHumpEqual;": "\u224f\u0338",
    "NotLeftTriangle;": "\u22ea",
    "NotLeftTriangleBar;": "\u29cf\u0338",
    "NotLeftTriangleEqual;": "\u22ec",
    "NotLess;": "\u226e",
    "NotLessEqual;": "\u2270",
    "NotLessGreater;": "\u2278",
    "NotLessLess;": "\u226a\u0338",
    "NotLessSlantEqual;": "\u2a7d\u0338",
    "NotLessTilde;": "\u2274",
    "NotNestedGreaterGreater;": "\u2aa2\u0338",
    "NotNestedLessLess;": "\u2aa1\u0338",
    "NotPrecedes;": "\u2280",
    "NotPrecedesEqual;": "\u2aaf\u0338",
    "NotPrecedesSlantEqual;": "\u22e0",
    "NotReverseElement;": "\u220c",
    "NotRightTriangle;": "\u22eb",
    "NotRightTriangleBar;": "\u29d0\u0338",
    "NotRightTriangleEqual;": "\u22ed",
    "NotSquareSubset;": "\u228f\u0338",
    "NotSquareSubsetEqual;": "\u22e2",
    "NotSquareSuperset;": "\u2290\u0338",
    "NotSquareSupersetEqual;": "\u22e3",
    "NotSubset;": "\u2282\u20d2",
    "NotSubsetEqual;": "\u2288",
    "NotSucceeds;": "\u2281",
    "NotSucceedsEqual;": "\u2ab0\u0338",
    "NotSucceedsSlantEqual;": "\u22e1",
    "NotSucceedsTilde;": "\u227f\u0338",
    "NotSuperset;": "\u2283\u20d2",
    "NotSupersetEqual;": "\u2289",
    "NotTilde;": "\u2241",
    "NotTildeEqual;": "\u2244",
    "NotTildeFullEqual;": "\u2247",
    "NotTildeTilde;": "\u2249",
    "NotVerticalBar;": "\u2224",
    "Nscr;": "\U0001d4a9",
    "Ntilde": "\xd1",
    "Ntilde;": "\xd1",
    "Nu;": "\u039d",
    "OElig;": "\u0152",
    "Oacute": "\xd3",
    "Oacute;": "\xd3",
    "Ocirc": "\xd4",
    "Ocirc;": "\xd4",
    "Ocy;": "\u041e",
    "Odblac;": "\u0150",
    "Ofr;": "\U0001d512",
    "Ograve": "\xd2",
    "Ograve;": "\xd2",
    "Omacr;": "\u014c",
    "Omega;": "\u03a9",
    "Omicron;": "\u039f",
    "Oopf;": "\U0001d546",
    "OpenCurlyDoubleQuote;": "\u201c",
    "OpenCurlyQuote;": "\u2018",
    "Or;": "\u2a54",
    "Oscr;": "\U0001d4aa",
    "Oslash": "\xd8",
    "Oslash;": "\xd8",
    "Otilde": "\xd5",
    "Otilde;": "\xd5",
    "Otimes;": "\u2a37",
    "Ouml": "\xd6",
    "Ouml;": "\xd6",
    "OverBar;": "\u203e",
    "OverBrace;": "\u23de",
    "OverBracket;": "\u23b4",
    "OverParenthesis;": "\u23dc",
    "PartialD;": "\u2202",
    "Pcy;": "\u041f",
    "Pfr;": "\U0001d513",
    "Phi;": "\u03a6",
    "Pi;": "\u03a0",
    "PlusMinus;": "\xb1",
    "Poincareplane;": "\u210c",
    "Popf;": "\u2119",
    "Pr;": "\u2abb",
    "Precedes;": "\u227a",
    "PrecedesEqual;": "\u2aaf",
    "PrecedesSlantEqual;": "\u227c",
    "PrecedesTilde;": "\u227e",
    "Prime;": "\u2033",
    "Product;": "\u220f",
    "Proportion;": "\u2237",
    "Proportional;": "\u221d",
    "Pscr;": "\U0001d4ab",
    "Psi;": "\u03a8",
    "QUOT": "\"",
    "QUOT;": "\"",
    "Qfr;": "\U0001d514",
    "Qopf;": "\u211a",
    "Qscr;": "\U0001d4ac",
    "RBarr;": "\u2910",
    "REG": "\xae",
    "REG;": "\xae",
    "Racute;": "\u0154",
    "Rang;": "\u27eb",
    "Rarr;": "\u21a0",
    "Rarrtl;": "\u2916",
    "Rcaron;": "\u0158",
    "Rcedil;": "\u0156",
    "Rcy;": "\u0420",
    "Re;": "\u211c",
    "ReverseElement;": "\u220b",
    "ReverseEquilibrium;": "\u21cb",
    "ReverseUpEquilibrium;": "\u296f",
    "Rfr;": "\u211c",
    "Rho;": "\u03a1",
    "RightAngleBracket;": "\u27e9",
    "RightArrow;": "\u2192",
    "RightArrowBar;": "\u21e5",
    "RightArrowLeftArrow;": "\u21c4",
    "RightCeiling;": "\u2309",
    "RightDoubleBracket;": "\u27e7",
    "RightDownTeeVector;": "\u295d",
    "RightDownVector;": "\u21c2",
    "RightDownVectorBar;": "\u2955",
    "RightFloor;": "\u230b",
    "RightTee;": "\u22a2",
    "RightTeeArrow;": "\u21a6",
    "RightTeeVector;": "\u295b",
    "RightTriangle;": "\u22b3",
    "RightTriangleBar;": "\u29d0",
    "RightTriangleEqual;": "\u22b5",
    "RightUpDownVector;": "\u294f",
    "RightUpTeeVector;": "\u295c",
    "RightUpVector;": "\u21be",
    "RightUpVectorBar;": "\u2954",
    "RightVector;": "\u21c0",
    "RightVectorBar;": "\u2953",
    "Rightarrow;": "\u21d2",
    "Ropf;": "\u211d",
    "RoundImplies;": "\u2970",
    "Rrightarrow;": "\u21db",
    "Rscr;": "\u211b",
    "Rsh;": "\u21b1",
    "RuleDelayed;": "\u29f4",
    "SHCHcy;": "\u0429",
    "SHcy;": "\u0428",
    "SOFTcy;": "\u042c",
    "Sacute;": "\u015a",
    "Sc;": "\u2abc",
    "Scaron;": "\u0160",
    "Scedil;": "\u015e",
    "Scirc;": "\u015c",
    "Scy;": "\u0421",
    "Sfr;": "\U0001d516",
    "ShortDownArrow;": "\u2193",
    "ShortLeftArrow;": "\u2190",
    "ShortRightArrow;": "\u2192",
    "ShortUpArrow;": "\u2191",
    "Sigma;": "\u03a3",
    "SmallCircle;": "\u2218",
    "Sopf;": "\U0001d54a",
    "Sqrt;": "\u221a",
    "Square;": "\u25a1",
    "SquareIntersection;": "\u2293",
    "SquareSubset;": "\u228f",
    "SquareSubsetEqual;": "\u2291",
    "SquareSuperset;": "\u2290",
    "SquareSupersetEqual;": "\u2292",
    "SquareUnion;": "\u2294",
    "Sscr;": "\U0001d4ae",
    "Star;": "\u22c6",
    "Sub;": "\u22d0",
    "Subset;": "\u22d0",
    "SubsetEqual;": "\u2286",
    "Succeeds;": "\u227b",
    "SucceedsEqual;": "\u2ab0",
    "SucceedsSlantEqual;": "\u227d",
    "SucceedsTilde;": "\u227f",
    "SuchThat;": "\u220b",
    "Sum;": "\u2211",
    "Sup;": "\u22d1",
    "Superset;": "\u2283",
    "SupersetEqual;": "\u2287",
    "Supset;": "\u22d1",
    "THORN": "\xde",
    "THORN;": "\xde",
    "TRADE;": "\u2122",
    "TSHcy;": "\u040b",
    "TScy;": "\u0426",
    "Tab;": "\t",
    "Tau;": "\u03a4",
    "Tcaron;": "\u0164",
    "Tcedil;": "\u0162",
    "Tcy;": "\u0422",
    "Tfr;": "\U0001d517",
    "Therefore;": "\u2234",
    "Theta;": "\u0398",
    "ThickSpace;": "\u205f\u200a",
    "ThinSpace;": "\u2009",
    "Tilde;": "\u223c",
    "TildeEqual;": "\u2243",
    "TildeFullEqual;": "\u2245",
    "TildeTilde;": "\u2248",
    "Topf;": "\U0001d54b",
    "TripleDot;": "\u20db",
    "Tscr;": "\U0001d4af",
    "Tstrok;": "\u0166",
    "Uacute": "\xda",
    "Uacute;": "\xda",
    "Uarr;": "\u219f",
    "Uarrocir;": "\u2949",
    "Ubrcy;": "\u040e",
    "Ubreve;": "\u016c",
    "Ucirc": "\xdb",
    "Ucirc;": "\xdb",
    "Ucy;": "\u0423",
    "Udblac;": "\u0170",
    "Ufr;": "\U0001d518",
    "Ugrave": "\xd9",
    "Ugrave;": "\xd9",
    "Umacr;": "\u016a",
    "UnderBar;": "_",
    "UnderBrace;": "\u23df",
    "UnderBracket;": "\u23b5",
    "UnderParenthesis;": "\u23dd",
    "Union;": "\u22c3",
    "UnionPlus;": "\u228e",
    "Uogon;": "\u0172",
    "Uopf;": "\U0001d54c",
    "UpArrow;": "\u2191",
    "UpArrowBar;": "\u2912",
    "UpArrowDownArrow;": "\u21c5",
    "UpDownArrow;": "\u2195",
    "UpEquilibrium;": "\u296e",
    "UpTee;": "\u22a5",
    "UpTeeArrow;": "\u21a5",
    "Uparrow;": "\u21d1",
    "Updownarrow;": "\u21d5",
    "UpperLeftArrow;": "\u2196",
    "UpperRightArrow;": "\u2197",
    "Upsi;": "\u03d2",
    "Upsilon;": "\u03a5",
    "Uring;": "\u016e",
    "Uscr;": "\U0001d4b0",
    "Utilde;": "\u0168",
    "Uuml": "\xdc",
    "Uuml;": "\xdc",
    "VDash;": "\u22ab",
    "Vbar;": "\u2aeb",
    "Vcy;": "\u0412",
    "Vdash;": "\u22a9",
    "Vdashl;": "\u2ae6",
    "Vee;": "\u22c1",
    "Verbar;": "\u2016",
    "Vert;": "\u2016",
    "VerticalBar;": "\u2223",
    "VerticalLine;": "|",
    "VerticalSeparator;": "\u2758",
    "VerticalTilde;": "\u2240",
    "VeryThinSpace;": "\u200a",
    "Vfr;": "\U0001d519",
    "Vopf;": "\U0001d54d",
    "Vscr;": "\U0001d4b1",
    "Vvdash;": "\u22aa",
    "Wcirc;": "\u0174",
    "Wedge;": "\u22c0",
    "Wfr;": "\U0001d51a",
    "Wopf;": "\U0001d54e",
    "Wscr;": "\U0001d4b2",
    "Xfr;": "\U0001d51b",
    "Xi;": "\u039e",
    "Xopf;": "\U0001d54f",
    "Xscr;": "\U0001d4b3",
    "YAcy;": "\u042f",
    "YIcy;": "\u0407",
    "YUcy;": "\u042e",
    "Yacute": "\xdd",
    "Yacute;": "\xdd",
    "Ycirc;": "\u0176",
    "Ycy;": "\u042b",
    "Yfr;": "\U0001d51c",
    "Yopf;": "\U0001d550",
    "Yscr;": "\U0001d4b4",
    "Yuml;": "\u0178",
    "ZHcy;": "\u0416",
    "Zacute;": "\u0179",
    "Zcaron;": "\u017d",
    "Zcy;": "\u0417",
    "Zdot;": "\u017b",
    "ZeroWidthSpace;": "\u200b",
    "Zeta;": "\u0396",
    "Zfr;": "\u2128",
    "Zopf;": "\u2124",
    "Zscr;": "\U0001d4b5",
    "aacute": "\xe1",
    "aacute;": "\xe1",
    "abreve;": "\u0103",
    "ac;": "\u223e",
    "acE;": "\u223e\u0333",
    "acd;": "\u223f",
    "acirc": "\xe2",
    "acirc;": "\xe2",
    "acute": "\xb4",
    "acute;": "\xb4",
    "acy;": "\u0430",
    "aelig": "\xe6",
    "aelig;": "\xe6",
    "af;": "\u2061",
    "afr;": "\U0001d51e",
    "agrave": "\xe0",
    "agrave;": "\xe0",
    "alefsym;": "\u2135",
    "aleph;": "\u2135",
    "alpha;": "\u03b1",
    "amacr;": "\u0101",
    "amalg;": "\u2a3f",
    "amp": "&",
    "amp;": "&",
    "and;": "\u2227",
    "andand;": "\u2a55",
    "andd;": "\u2a5c",
    "andslope;": "\u2a58",
    "andv;": "\u2a5a",
    "ang;": "\u2220",
    "ange;": "\u29a4",
    "angle;": "\u2220",
    "angmsd;": "\u2221",
    "angmsdaa;": "\u29a8",
    "angmsdab;": "\u29a9",
    "angmsdac;": "\u29aa",
    "angmsdad;": "\u29ab",
    "angmsdae;": "\u29ac",
    "angmsdaf;": "\u29ad",
    "angmsdag;": "\u29ae",
    "angmsdah;": "\u29af",
    "angrt;": "\u221f",
    "angrtvb;": "\u22be",
    "angrtvbd;": "\u299d",
    "angsph;": "\u2222",
    "angst;": "\xc5",
    "angzarr;": "\u237c",
    "aogon;": "\u0105",
    "aopf;": "\U0001d552",
    "ap;": "\u2248",
    "apE;": "\u2a70",
    "apacir;": "\u2a6f",
    "ape;": "\u224a",
    "apid;": "\u224b",
    "apos;": "'",
    "approx;": "\u2248",
    "approxeq;": "\u224a",
    "aring": "\xe5",
    "aring;": "\xe5",
    "ascr;": "\U0001d4b6",
    "ast;": "*",
    "asymp;": "\u2248",
    "asympeq;": "\u224d",
    "atilde": "\xe3",
    "atilde;": "\xe3",
    "auml": "\xe4",
    "auml;": "\xe4",
    "awconint;": "\u2233",
    "awint;": "\u2a11",
    "bNot;": "\u2aed",
    "backcong;": "\u224c",
    "backepsilon;": "\u03f6",
    "backprime;": "\u2035",
    "backsim;": "\u223d",
    "backsimeq;": "\u22cd",
    "barvee;": "\u22bd",
    "barwed;": "\u2305",
    "barwedge;": "\u2305",
    "bbrk;": "\u23b5",
    "bbrktbrk;": "\u23b6",
    "bcong;": "\u224c",
    "bcy;": "\u0431",
    "bdquo;": "\u201e",
    "becaus;": "\u2235",
    "because;": "\u2235",
    "bemptyv;": "\u29b0",
    "bepsi;": "\u03f6",
    "bernou;": "\u212c",
    "beta;": "\u03b2",
    "beth;": "\u2136",
    "between;": "\u226c",
    "bfr;": "\U0001d51f",
    "bigcap;": "\u22c2",
    "bigcirc;": "\u25ef",
    "bigcup;": "\u22c3",
    "bigodot;": "\u2a00",
    "bigoplus;": "\u2a01",
    "bigotimes;": "\u2a02",
    "bigsqcup;": "\u2a06",
    "bigstar;": "\u2605",
    "bigtriangledown;": "\u25bd",
    "bigtriangleup;": "\u25b3",
    "biguplus;": "\u2a04",
    "bigvee;": "\u22c1",
    "bigwedge;": "\u22c0",
    "bkarow;": "\u290d",
    "blacklozenge;": "\u29eb",
    "blacksquare;": "\u25aa",
    "blacktriangle;": "\u25b4",
    "blacktriangledown;": "\u25be",
    "blacktriangleleft;": "\u25c2",
    "blacktriangleright;": "\u25b8",
    "blank;": "\u2423",
    "blk12;": "\u2592",
    "blk14;": "\u2591",
    "blk34;": "\u2593",
    "block;": "\u2588",
    "bne;": "=\u20e5",
    "bnequiv;": "\u2261\u20e5",
    "bnot;": "\u2310",
    "bopf;": "\U0001d553",
    "bot;": "\u22a5",
    "bottom;": "\u22a5",
    "bowtie;": "\u22c8",
    "boxDL;": "\u2557",
    "boxDR;": "\u2554",
    "boxDl;": "\u2556",
    "boxDr;": "\u2553",
    "boxH;": "\u2550",
    "boxHD;": "\u2566",
    "boxHU;": "\u2569",
    "boxHd;": "\u2564",
    "boxHu;": "\u2567",
    "boxUL;": "\u255d",
    "boxUR;": "\u255a",
    "boxUl;": "\u255c",
    "boxUr;": "\u2559",
    "boxV;": "\u2551",
    "boxVH;": "\u256c",
    "boxVL;": "\u2563",
    "boxVR;": "\u2560",
    "boxVh;": "\u256b",
    "boxVl;": "\u2562",
    "boxVr;": "\u255f",
    "boxbox;": "\u29c9",
    "boxdL;": "\u2555",
    "boxdR;": "\u2552",
    "boxdl;": "\u2510",
    "boxdr;": "\u250c",
    "boxh;": "\u2500",
    "boxhD;": "\u2565",
    "boxhU;": "\u2568",
    "boxhd;": "\u252c",
    "boxhu;": "\u2534",
    "boxminus;": "\u229f",
    "boxplus;": "\u229e",
    "boxtimes;": "\u22a0",
    "boxuL;": "\u255b",
    "boxuR;": "\u2558",
    "boxul;": "\u2518",
    "boxur;": "\u2514",
    "boxv;": "\u2502",
    "boxvH;": "\u256a",
    "boxvL;": "\u2561",
    "boxvR;": "\u255e",
    "boxvh;": "\u253c",
    "boxvl;": "\u2524",
    "boxvr;": "\u251c",
    "bprime;": "\u2035",
    "breve;": "\u02d8",
    "brvbar": "\xa6",
    "brvbar;": "\xa6",
    "bscr;": "\U0001d4b7",
    "bsemi;": "\u204f",
    "bsim;": "\u223d",
    "bsime;": "\u22cd",
    "bsol;": "\\",
    "bsolb;": "\u29c5",
    "bsolhsub;": "\u27c8",
    "bull;": "\u2022",
    "bullet;": "\u2022",
    "bump;": "\u224e",
    "bumpE;": "\u2aae",
    "bumpe;": "\u224f",
    "bumpeq;": "\u224f",
    "cacute;": "\u0107",
    "cap;": "\u2229",
    "capand;": "\u2a44",
    "capbrcup;": "\u2a49",
    "capcap;": "\u2a4b",
    "capcup;": "\u2a47",
    "capdot;": "\u2a40",
    "caps;": "\u2229\ufe00",
    "caret;": "\u2041",
    "caron;": "\u02c7",
    "ccaps;": "\u2a4d",
    "ccaron;": "\u010d",
    "ccedil": "\xe7",
    "ccedil;": "\xe7",
    "ccirc;": "\u0109",
    "ccups;": "\u2a4c",
    "ccupssm;": "\u2a50",
    "cdot;": "\u010b",
    "cedil": "\xb8",
    "cedil;": "\xb8",
    "cemptyv;": "\u29b2",
    "cent": "\xa2",
    "cent;": "\xa2",
    "centerdot;": "\xb7",
    "cfr;": "\U0001d520",
    "chcy;": "\u0447",
    "check;": "\u2713",
    "checkmark;": "\u2713",
    "chi;": "\u03c7",
    "cir;": "\u25cb",
    "cirE;": "\u29c3",
    "circ;": "\u02c6",
    "circeq;": "\u2257",
    "circlearrowleft;": "\u21ba",
    "circlearrowright;": "\u21bb",
    "circledR;": "\xae",
    "circledS;": "\u24c8",
    "circledast;": "\u229b",
    "circledcirc;": "\u229a",
    "circleddash;": "\u229d",
    "cire;": "\u2257",
    "cirfnint;": "\u2a10",
    "cirmid;": "\u2aef",
    "cirscir;": "\u29c2",
    "clubs;": "\u2663",
    "clubsuit;": "\u2663",
    "colon;": ":",
    "colone;": "\u2254",
    "coloneq;": "\u2254",
    "comma;": ",",
    "commat;": "@",
    "comp;": "\u2201",
    "compfn;": "\u2218",
    "complement;": "\u2201",
    "complexes;": "\u2102",
    "cong;": "\u2245",
    "congdot;": "\u2a6d",
    "conint;": "\u222e",
    "copf;": "\U0001d554",
    "coprod;": "\u2210",
    "copy": "\xa9",
    "copy;": "\xa9",
    "copysr;": "\u2117",
    "crarr;": "\u21b5",
    "cross;": "\u2717",
    "cscr;": "\U0001d4b8",
    "csub;": "\u2acf",
    "csube;": "\u2ad1",
    "csup;": "\u2ad0",
    "csupe;": "\u2ad2",
    "ctdot;": "\u22ef",
    "cudarrl;": "\u2938",
    "cudarrr;": "\u2935",
    "cuepr;": "\u22de",
    "cuesc;": "\u22df",
    "cularr;": "\u21b6",
    "cularrp;": "\u293d",
    "cup;": "\u222a",
    "cupbrcap;": "\u2a48",
    "cupcap;": "\u2a46",
    "cupcup;": "\u2a4a",
    "cupdot;": "\u228d",
    "cupor;": "\u2a45",
    "cups;": "\u222a\ufe00",
    "curarr;": "\u21b7",
    "curarrm;": "\u293c",
    "curlyeqprec;": "\u22de",
    "curlyeqsucc;": "\u22df",
    "curlyvee;": "\u22ce",
    "curlywedge;": "\u22cf",
    "curren": "\xa4",
    "curren;": "\xa4",
    "curvearrowleft;": "\u21b6",
    "curvearrowright;": "\u21b7",
    "cuvee;": "\u22ce",
    "cuwed;": "\u22cf",
    "cwconint;": "\u2232",
    "cwint;": "\u2231",
    "cylcty;": "\u232d",
    "dArr;": "\u21d3",
    "dHar;": "\u2965",
    "dagger;": "\u2020",
    "daleth;": "\u2138",
    "darr;": "\u2193",
    "dash;": "\u2010",
    "dashv;": "\u22a3",
    "dbkarow;": "\u290f",
    "dblac;": "\u02dd",
    "dcaron;": "\u010f",
    "dcy;": "\u0434",
    "dd;": "\u2146",
    "ddagger;": "\u2021",
    "ddarr;": "\u21ca",
    "ddotseq;": "\u2a77",
    "deg": "\xb0",
    "deg;": "\xb0",
    "delta;": "\u03b4",
    "demptyv;": "\u29b1",
    "dfisht;": "\u297f",
    "dfr;": "\U0001d521",
    "dharl;": "\u21c3",
    "dharr;": "\u21c2",
    "diam;": "\u22c4",
    "diamond;": "\u22c4",
    "diamondsuit;": "\u2666",
    "diams;": "\u2666",
    "die;": "\xa8",
    "digamma;": "\u03dd",
    "disin;": "\u22f2",
    "div;": "\xf7",
    "divide": "\xf7",
    "divide;": "\xf7",
    "divideontimes;": "\u22c7",
    "divonx;": "\u22c7",
    "djcy;": "\u0452",
    "dlcorn;": "\u231e",
    "dlcrop;": "\u230d",
    "dollar;": "$",
    "dopf;": "\U0001d555",
    "dot;": "\u02d9",
    "doteq;": "\u2250",
    "doteqdot;": "\u2251",
    "dotminus;": "\u2238",
    "dotplus;": "\u2214",
    "dotsquare;": "\u22a1",
    "doublebarwedge;": "\u2306",
    "downarrow;": "\u2193",
    "downdownarrows;": "\u21ca",
    "downharpoonleft;": "\u21c3",
    "downharpoonright;": "\u21c2",
    "drbkarow;": "\u2910",
    "drcorn;": "\u231f",
    "drcrop;": "\u230c",
    "dscr;": "\U0001d4b9",
    "dscy;": "\u0455",
    "dsol;": "\u29f6",
    "dstrok;": "\u0111",
    "dtdot;": "\u22f1",
    "dtri;": "\u25bf",
    "dtrif;": "\u25be",
    "duarr;": "\u21f5",
    "duhar;": "\u296f",
    "dwangle;": "\u29a6",
    "dzcy;": "\u045f",
    "dzigrarr;": "\u27ff",
    "eDDot;": "\u2a77",
    "eDot;": "\u2251",
    "eacute": "\xe9",
    "eacute;": "\xe9",
    "easter;": "\u2a6e",
    "ecaron;": "\u011b",
    "ecir;": "\u2256",
    "ecirc": "\xea",
    "ecirc;": "\xea",
    "ecolon;": "\u2255",
    "ecy;": "\u044d",
    "edot;": "\u0117",
    "ee;": "\u2147",
    "efDot;": "\u2252",
    "efr;": "\U0001d522",
    "eg;": "\u2a9a",
    "egrave": "\xe8",
    "egrave;": "\xe8",
    "egs;": "\u2a96",
    "egsdot;": "\u2a98",
    "el;": "\u2a99",
    "elinters;": "\u23e7",
    "ell;": "\u2113",
    "els;": "\u2a95",
    "elsdot;": "\u2a97",
    "emacr;": "\u0113",
    "empty;": "\u2205",
    "emptyset;": "\u2205",
    "emptyv;": "\u2205",
    "emsp13;": "\u2004",
    "emsp14;": "\u2005",
    "emsp;": "\u2003",
    "eng;": "\u014b",
    "ensp;": "\u2002",
    "eogon;": "\u0119",
    "eopf;": "\U0001d556",
    "epar;": "\u22d5",
    "eparsl;": "\u29e3",
    "eplus;": "\u2a71",
    "epsi;": "\u03b5",
    "epsilon;": "\u03b5",
    "epsiv;": "\u03f5",
    "eqcirc;": "\u2256",
    "eqcolon;": "\u2255",
    "eqsim;": "\u2242",
    "eqslantgtr;": "\u2a96",
    "eqslantless;": "\u2a95",
    "equals;": "=",
    "equest;": "\u225f",
    "equiv;": "\u2261",
    "equivDD;": "\u2a78",
    "eqvparsl;": "\u29e5",
    "erDot;": "\u2253",
    "erarr;": "\u2971",
    "escr;": "\u212f",
    "esdot;": "\u2250",
    "esim;": "\u2242",
    "eta;": "\u03b7",
    "eth": "\xf0",
    "eth;": "\xf0",
    "euml": "\xeb",
    "euml;": "\xeb",
    "euro;": "\u20ac",
    "excl;": "!",
    "exist;": "\u2203",
    "expectation;": "\u2130",
    "exponentiale;": "\u2147",
    "fallingdotseq;": "\u2252",
    "fcy;": "\u0444",
    "female;": "\u2640",
    "ffilig;": "\ufb03",
    "fflig;": "\ufb00",
    "ffllig;": "\ufb04",
    "ffr;": "\U0001d523",
    "filig;": "\ufb01",
    "fjlig;": "fj",
    "flat;": "\u266d",
    "fllig;": "\ufb02",
    "fltns;": "\u25b1",
    "fnof;": "\u0192",
    "fopf;": "\U0001d557",
    "forall;": "\u2200",
    "fork;": "\u22d4",
    "forkv;": "\u2ad9",
    "fpartint;": "\u2a0d",
    "frac12": "\xbd",
    "frac12;": "\xbd",
    "frac13;": "\u2153",
    "frac14": "\xbc",
    "frac14;": "\xbc",
    "frac15;": "\u2155",
    "frac16;": "\u2159",
    "frac18;": "\u215b",
    "frac23;": "\u2154",
    "frac25;": "\u2156",
    "frac34": "\xbe",
    "frac34;": "\xbe",
    "frac35;": "\u2157",
    "frac38;": "\u215c",
    "frac45;": "\u2158",
    "frac56;": "\u215a",
    "frac58;": "\u215d",
    "frac78;": "\u215e",
    "frasl;": "\u2044",
    "frown;": "\u2322",
    "fscr;": "\U0001d4bb",
    "gE;": "\u2267",
    "gEl;": "\u2a8c",
    "gacute;": "\u01f5",
    "gamma;": "\u03b3",
    "gammad;": "\u03dd",
    "gap;": "\u2a86",
    "gbreve;": "\u011f",
    "gcirc;": "\u011d",
    "gcy;": "\u0433",
    "gdot;": "\u0121",
    "ge;": "\u2265",
    "gel;": "\u22db",
    "geq;": "\u2265",
    "geqq;": "\u2267",
    "geqslant;": "\u2a7e",
    "ges;": "\u2a7e",
    "gescc;": "\u2aa9",
    "gesdot;": "\u2a80",
    "gesdoto;": "\u2a82",
    "gesdotol;": "\u2a84",
    "gesl;": "\u22db\ufe00",
    "gesles;": "\u2a94",
    "gfr;": "\U0001d524",
    "gg;": "\u226b",
    "ggg;": "\u22d9",
    "gimel;": "\u2137",
    "gjcy;": "\u0453",
    "gl;": "\u2277",
    "glE;": "\u2a92",
    "gla;": "\u2aa5",
    "glj;": "\u2aa4",
    "gnE;": "\u2269",
    "gnap;": "\u2a8a",
    "gnapprox;": "\u2a8a",
    "gne;": "\u2a88",
    "gneq;": "\u2a88",
    "gneqq;": "\u2269",
    "gnsim;": "\u22e7",
    "gopf;": "\U0001d558",
    "grave;": "`",
    "gscr;": "\u210a",
    "gsim;": "\u2273",
    "gsime;": "\u2a8e",
    "gsiml;": "\u2a90",
    "gt": ">",
    "gt;": ">",
    "gtcc;": "\u2aa7",
    "gtcir;": "\u2a7a",
    "gtdot;": "\u22d7",
    "gtlPar;": "\u2995",
    "gtquest;": "\u2a7c",
    "gtrapprox;": "\u2a86",
    "gtrarr;": "\u2978",
    "gtrdot;": "\u22d7",
    "gtreqless;": "\u22db",
    "gtreqqless;": "\u2a8c",
    "gtrless;": "\u2277",
    "gtrsim;": "\u2273",
    "gvertneqq;": "\u2269\ufe00",
    "gvnE;": "\u2269\ufe00",
    "hArr;": "\u21d4",
    "hairsp;": "\u200a",
    "half;": "\xbd",
    "hamilt;": "\u210b",
    "hardcy;": "\u044a",
    "harr;": "\u2194",
    "harrcir;": "\u2948",
    "harrw;": "\u21ad",
    "hbar;": "\u210f",
    "hcirc;": "\u0125",
    "hearts;": "\u2665",
    "heartsuit;": "\u2665",
    "hellip;": "\u2026",
    "hercon;": "\u22b9",
    "hfr;": "\U0001d525",
    "hksearow;": "\u2925",
    "hkswarow;": "\u2926",
    "hoarr;": "\u21ff",
    "homtht;": "\u223b",
    "hookleftarrow;": "\u21a9",
    "hookrightarrow;": "\u21aa",
    "hopf;": "\U0001d559",
    "horbar;": "\u2015",
    "hscr;": "\U0001d4bd",
    "hslash;": "\u210f",
    "hstrok;": "\u0127",
    "hybull;": "\u2043",
    "hyphen;": "\u2010",
    "iacute": "\xed",
    "iacute;": "\xed",
    "ic;": "\u2063",
    "icirc": "\xee",
    "icirc;": "\xee",
    "icy;": "\u0438",
    "iecy;": "\u0435",
    "iexcl": "\xa1",
    "iexcl;": "\xa1",
    "iff;": "\u21d4",
    "ifr;": "\U0001d526",
    "igrave": "\xec",
    "igrave;": "\xec",
    "ii;": "\u2148",
    "iiiint;": "\u2a0c",
    "iiint;": "\u222d",
    "iinfin;": "\u29dc",
    "iiota;": "\u2129",
    "ijlig;": "\u0133",
    "imacr;": "\u012b",
    "image;": "\u2111",
    "imagline;": "\u2110",
    "imagpart;": "\u2111",
    "imath;": "\u0131",
    "imof;": "\u22b7",
    "imped;": "\u01b5",
    "in;": "\u2208",
    "incare;": "\u2105",
    "infin;": "\u221e",
    "infintie;": "\u29dd",
    "inodot;": "\u0131",
    "int;": "\u222b",
    "intcal;": "\u22ba",
    "integers;": "\u2124",
    "intercal;": "\u22ba",
    "intlarhk;": "\u2a17",
    "intprod;": "\u2a3c",
    "iocy;": "\u0451",
    "iogon;": "\u012f",
    "iopf;": "\U0001d55a",
    "iota;": "\u03b9",
    "iprod;": "\u2a3c",
    "iquest": "\xbf",
    "iquest;": "\xbf",
    "iscr;": "\U0001d4be",
    "isin;": "\u2208",
    "isinE;": "\u22f9",
    "isindot;": "\u22f5",
    "isins;": "\u22f4",
    "isinsv;": "\u22f3",
    "isinv;": "\u2208",
    "it;": "\u2062",
    "itilde;": "\u0129",
    "iukcy;": "\u0456",
    "iuml": "\xef",
    "iuml;": "\xef",
    "jcirc;": "\u0135",
    "jcy;": "\u0439",
    "jfr;": "\U0001d527",
    "jmath;": "\u0237",
    "jopf;": "\U0001d55b",
    "jscr;": "\U0001d4bf",
    "jsercy;": "\u0458",
    "jukcy;": "\u0454",
    "kappa;": "\u03ba",
    "kappav;": "\u03f0",
    "kcedil;": "\u0137",
    "kcy;": "\u043a",
    "kfr;": "\U0001d528",
    "kgreen;": "\u0138",
    "khcy;": "\u0445",
    "kjcy;": "\u045c",
    "kopf;": "\U0001d55c",
    "kscr;": "\U0001d4c0",
    "lAarr;": "\u21da",
    "lArr;": "\u21d0",
    "lAtail;": "\u291b",
    "lBarr;": "\u290e",
    "lE;": "\u2266",
    "lEg;": "\u2a8b",
    "lHar;": "\u2962",
    "lacute;": "\u013a",
    "laemptyv;": "\u29b4",
    "lagran;": "\u2112",
    "lambda;": "\u03bb",
    "lang;": "\u27e8",
    "langd;": "\u2991",
    "langle;": "\u27e8",
    "lap;": "\u2a85",
    "laquo": "\xab",
    "laquo;": "\xab",
    "larr;": "\u2190",
    "larrb;": "\u21e4",
    "larrbfs;": "\u291f",
    "larrfs;": "\u291d",
    "larrhk;": "\u21a9",
    "larrlp;": "\u21ab",
    "larrpl;": "\u2939",
    "larrsim;": "\u2973",
    "larrtl;": "\u21a2",
    "lat;": "\u2aab",
    "latail;": "\u2919",
    "late;": "\u2aad",
    "lates;": "\u2aad\ufe00",
    "lbarr;": "\u290c",
    "lbbrk;": "\u2772",
    "lbrace;": "{",
    "lbrack;": "[",
    "lbrke;": "\u298b",
    "lbrksld;": "\u298f",
    "lbrkslu;": "\u298d",
    "lcaron;": "\u013e",
    "lcedil;": "\u013c",
    "lceil;": "\u2308",
    "lcub;": "{",
    "lcy;": "\u043b",
    "ldca;": "\u2936",
    "ldquo;": "\u201c",
    "ldquor;": "\u201e",
    "ldrdhar;": "\u2967",
    "ldrushar;": "\u294b",
    "ldsh;": "\u21b2",
    "le;": "\u2264",
    "leftarrow;": "\u2190",
    "leftarrowtail;": "\u21a2",
    "leftharpoondown;": "\u21bd",
    "leftharpoonup;": "\u21bc",
    "leftleftarrows;": "\u21c7",
    "leftrightarrow;": "\u2194",
    "leftrightarrows;": "\u21c6",
    "leftrightharpoons;": "\u21cb",
    "leftrightsquigarrow;": "\u21ad",
    "leftthreetimes;": "\u22cb",
    "leg;": "\u22da",
    "leq;": "\u2264",
    "leqq;": "\u2266",
    "leqslant;": "\u2a7d",
    "les;": "\u2a7d",
    "lescc;": "\u2aa8",
    "lesdot;": "\u2a7f",
    "lesdoto;": "\u2a81",
    "lesdotor;": "\u2a83",
    "lesg;": "\u22da\ufe00",
    "lesges;": "\u2a93",
    "lessapprox;": "\u2a85",
    "lessdot;": "\u22d6",
    "lesseqgtr;": "\u22da",
    "lesseqqgtr;": "\u2a8b",
    "lessgtr;": "\u2276",
    "lesssim;": "\u2272",
    "lfisht;": "\u297c",
    "lfloor;": "\u230a",
    "lfr;": "\U0001d529",
    "lg;": "\u2276",
    "lgE;": "\u2a91",
    "lhard;": "\u21bd",
    "lharu;": "\u21bc",
    "lharul;": "\u296a",
    "lhblk;": "\u2584",
    "ljcy;": "\u0459",
    "ll;": "\u226a",
    "llarr;": "\u21c7",
    "llcorner;": "\u231e",
    "llhard;": "\u296b",
    "lltri;": "\u25fa",
    "lmidot;": "\u0140",
    "lmoust;": "\u23b0",
    "lmoustache;": "\u23b0",
    "lnE;": "\u2268",
    "lnap;": "\u2a89",
    "lnapprox;": "\u2a89",
    "lne;": "\u2a87",
    "lneq;": "\u2a87",
    "lneqq;": "\u2268",
    "lnsim;": "\u22e6",
    "loang;": "\u27ec",
    "loarr;": "\u21fd",
    "lobrk;": "\u27e6",
    "longleftarrow;": "\u27f5",
    "longleftrightarrow;": "\u27f7",
    "longmapsto;": "\u27fc",
    "longrightarrow;": "\u27f6",
    "looparrowleft;": "\u21ab",
    "looparrowright;": "\u21ac",
    "lopar;": "\u2985",
    "lopf;": "\U0001d55d",
    "loplus;": "\u2a2d",
    "lotimes;": "\u2a34",
    "lowast;": "\u2217",
    "lowbar;": "_",
    "loz;": "\u25ca",
    "lozenge;": "\u25ca",
    "lozf;": "\u29eb",
    "lpar;": "(",
    "lparlt;": "\u2993",
    "lrarr;": "\u21c6",
    "lrcorner;": "\u231f",
    "lrhar;": "\u21cb",
    "lrhard;": "\u296d",
    "lrm;": "\u200e",
    "lrtri;": "\u22bf",
    "lsaquo;": "\u2039",
    "lscr;": "\U0001d4c1",
    "lsh;": "\u21b0",
    "lsim;": "\u2272",
    "lsime;": "\u2a8d",
    "lsimg;": "\u2a8f",
    "lsqb;": "[",
    "lsquo;": "\u2018",
    "lsquor;": "\u201a",
    "lstrok;": "\u0142",
    "lt": "<",
    "lt;": "<",
    "ltcc;": "\u2aa6",
    "ltcir;": "\u2a79",
    "ltdot;": "\u22d6",
    "lthree;": "\u22cb",
    "ltimes;": "\u22c9",
    "ltlarr;": "\u2976",
    "ltquest;": "\u2a7b",
    "ltrPar;": "\u2996",
    "ltri;": "\u25c3",
    "ltrie;": "\u22b4",
    "ltrif;": "\u25c2",
    "lurdshar;": "\u294a",
    "luruhar;": "\u2966",
    "lvertneqq;": "\u2268\ufe00",
    "lvnE;": "\u2268\ufe00",
    "mDDot;": "\u223a",
    "macr": "\xaf",
    "macr;": "\xaf",
    "male;": "\u2642",
    "malt;": "\u2720",
    "maltese;": "\u2720",
    "map;": "\u21a6",
    "mapsto;": "\u21a6",
    "mapstodown;": "\u21a7",
    "mapstoleft;": "\u21a4",
    "mapstoup;": "\u21a5",
    "marker;": "\u25ae",
    "mcomma;": "\u2a29",
    "mcy;": "\u043c",
    "mdash;": "\u2014",
    "measuredangle;": "\u2221",
    "mfr;": "\U0001d52a",
    "mho;": "\u2127",
    "micro": "\xb5",
    "micro;": "\xb5",
    "mid;": "\u2223",
    "midast;": "*",
    "midcir;": "\u2af0",
    "middot": "\xb7",
    "middot;": "\xb7",
    "minus;": "\u2212",
    "minusb;": "\u229f",
    "minusd;": "\u2238",
    "minusdu;": "\u2a2a",
    "mlcp;": "\u2adb",
    "mldr;": "\u2026",
    "mnplus;": "\u2213",
    "models;": "\u22a7",
    "mopf;": "\U0001d55e",
    "mp;": "\u2213",
    "mscr;": "\U0001d4c2",
    "mstpos;": "\u223e",
    "mu;": "\u03bc",
    "multimap;": "\u22b8",
    "mumap;": "\u22b8",
    "nGg;": "\u22d9\u0338",
    "nGt;": "\u226b\u20d2",
    "nGtv;": "\u226b\u0338",
    "nLeftarrow;": "\u21cd",
    "nLeftrightarrow;": "\u21ce",
    "nLl;": "\u22d8\u0338",
    "nLt;": "\u226a\u20d2",
    "nLtv;": "\u226a\u0338",
    "nRightarrow;": "\u21cf",
    "nVDash;": "\u22af",
    "nVdash;": "\u22ae",
    "nabla;": "\u2207",
    "nacute;": "\u0144",
    "nang;": "\u2220\u20d2",
    "nap;": "\u2249",
    "napE;": "\u2a70\u0338",
    "napid;": "\u224b\u0338",
    "napos;": "\u0149",
    "napprox;": "\u2249",
    "natur;": "\u266e",
    "natural;": "\u266e",
    "naturals;": "\u2115",
    "nbsp": "\xa0",
    "nbsp;": "\xa0",
    "nbump;": "\u224e\u0338",
    "nbumpe;": "\u224f\u0338",
    "ncap;": "\u2a43",
    "ncaron;": "\u0148",
    "ncedil;": "\u0146",
    "ncong;": "\u2247",
    "ncongdot;": "\u2a6d\u0338",
    "ncup;": "\u2a42",
    "ncy;": "\u043d",
    "ndash;": "\u2013",
    "ne;": "\u2260",
    "neArr;": "\u21d7",
    "nearhk;": "\u2924",
    "nearr;": "\u2197",
    "nearrow;": "\u2197",
    "nedot;": "\u2250\u0338",
    "nequiv;": "\u2262",
    "nesear;": "\u2928",
    "nesim;": "\u2242\u0338",
    "nexist;": "\u2204",
    "nexists;": "\u2204",
    "nfr;": "\U0001d52b",
    "ngE;": "\u2267\u0338",
    "nge;": "\u2271",
    "ngeq;": "\u2271",
    "ngeqq;": "\u2267\u0338",
    "ngeqslant;": "\u2a7e\u0338",
    "nges;": "\u2a7e\u0338",
    "ngsim;": "\u2275",
    "ngt;": "\u226f",
    "ngtr;": "\u226f",
    "nhArr;": "\u21ce",
    "nharr;": "\u21ae",
    "nhpar;": "\u2af2",
    "ni;": "\u220b",
    "nis;": "\u22fc",
    "nisd;": "\u22fa",
    "niv;": "\u220b",
    "njcy;": "\u045a",
    "nlArr;": "\u21cd",
    "nlE;": "\u2266\u0338",
    "nlarr;": "\u219a",
    "nldr;": "\u2025",
    "nle;": "\u2270",
    "nleftarrow;": "\u219a",
    "nleftrightarrow;": "\u21ae",
    "nleq;": "\u2270",
    "nleqq;": "\u2266\u0338",
    "nleqslant;": "\u2a7d\u0338",
    "nles;": "\u2a7d\u0338",
    "nless;": "\u226e",
    "nlsim;": "\u2274",
    "nlt;": "\u226e",
    "nltri;": "\u22ea",
    "nltrie;": "\u22ec",
    "nmid;": "\u2224",
    "nopf;": "\U0001d55f",
    "not": "\xac",
    "not;": "\xac",
    "notin;": "\u2209",
    "notinE;": "\u22f9\u0338",
    "notindot;": "\u22f5\u0338",
    "notinva;": "\u2209",
    "notinvb;": "\u22f7",
    "notinvc;": "\u22f6",
    "notni;": "\u220c",
    "notniva;": "\u220c",
    "notnivb;": "\u22fe",
    "notnivc;": "\u22fd",
    "npar;": "\u2226",
    "nparallel;": "\u2226",
    "nparsl;": "\u2afd\u20e5",
    "npart;": "\u2202\u0338",
    "npolint;": "\u2a14",
    "npr;": "\u2280",
    "nprcue;": "\u22e0",
    "npre;": "\u2aaf\u0338",
    "nprec;": "\u2280",
    "npreceq;": "\u2aaf\u0338",
    "nrArr;": "\u21cf",
    "nrarr;": "\u219b",
    "nrarrc;": "\u2933\u0338",
    "nrarrw;": "\u219d\u0338",
    "nrightarrow;": "\u219b",
    "nrtri;": "\u22eb",
    "nrtrie;": "\u22ed",
    "nsc;": "\u2281",
    "nsccue;": "\u22e1",
    "nsce;": "\u2ab0\u0338",
    "nscr;": "\U0001d4c3",
    "nshortmid;": "\u2224",
    "nshortparallel;": "\u2226",
    "nsim;": "\u2241",
    "nsime;": "\u2244",
    "nsimeq;": "\u2244",
    "nsmid;": "\u2224",
    "nspar;": "\u2226",
    "nsqsube;": "\u22e2",
    "nsqsupe;": "\u22e3",
    "nsub;": "\u2284",
    "nsubE;": "\u2ac5\u0338",
    "nsube;": "\u2288",
    "nsubset;": "\u2282\u20d2",
    "nsubseteq;": "\u2288",
    "nsubseteqq;": "\u2ac5\u0338",
    "nsucc;": "\u2281",
    "nsucceq;": "\u2ab0\u0338",
    "nsup;": "\u2285",
    "nsupE;": "\u2ac6\u0338",
    "nsupe;": "\u2289",
    "nsupset;": "\u2283\u20d2",
    "nsupseteq;": "\u2289",
    "nsupseteqq;": "\u2ac6\u0338",
    "ntgl;": "\u2279",
    "ntilde": "\xf1",
    "ntilde;": "\xf1",
    "ntlg;": "\u2278",
    "ntriangleleft;": "\u22ea",
    "ntrianglelefteq;": "\u22ec",
    "ntriangleright;": "\u22eb",
    "ntrianglerighteq;": "\u22ed",
    "nu;": "\u03bd",
    "num;": "#",
    "numero;": "\u2116",
    "numsp;": "\u2007",
    "nvDash;": "\u22ad",
    "nvHarr;": "\u2904",
    "nvap;": "\u224d\u20d2",
    "nvdash;": "\u22ac",
    "nvge;": "\u2265\u20d2",
    "nvgt;": ">\u20d2",
    "nvinfin;": "\u29de",
    "nvlArr;": "\u2902",
    "nvle;": "\u2264\u20d2",
    "nvlt;": "<\u20d2",
    "nvltrie;": "\u22b4\u20d2",
    "nvrArr;": "\u2903",
    "nvrtrie;": "\u22b5\u20d2",
    "nvsim;": "\u223c\u20d2",
    "nwArr;": "\u21d6",
    "nwarhk;": "\u2923",
    "nwarr;": "\u2196",
    "nwarrow;": "\u2196",
    "nwnear;": "\u2927",
    "oS;": "\u24c8",
    "oacute": "\xf3",
    "oacute;": "\xf3",
    "oast;": "\u229b",
    "ocir;": "\u229a",
    "ocirc": "\xf4",
    "ocirc;": "\xf4",
    "ocy;": "\u043e",
    "odash;": "\u229d",
    "odblac;": "\u0151",
    "odiv;": "\u2a38",
    "odot;": "\u2299",
    "odsold;": "\u29bc",
    "oelig;": "\u0153",
    "ofcir;": "\u29bf",
    "ofr;": "\U0001d52c",
    "ogon;": "\u02db",
    "ograve": "\xf2",
    "ograve;": "\xf2",
    "ogt;": "\u29c1",
    "ohbar;": "\u29b5",
    "ohm;": "\u03a9",
    "oint;": "\u222e",
    "olarr;": "\u21ba",
    "olcir;": "\u29be",
    "olcross;": "\u29bb",
    "oline;": "\u203e",
    "olt;": "\u29c0",
    "omacr;": "\u014d",
    "omega;": "\u03c9",
    "omicron;": "\u03bf",
    "omid;": "\u29b6",
    "ominus;": "\u2296",
    "oopf;": "\U0001d560",
    "opar;": "\u29b7",
    "operp;": "\u29b9",
    "oplus;": "\u2295",
    "or;": "\u2228",
    "orarr;": "\u21bb",
    "ord;": "\u2a5d",
    "order;": "\u2134",
    "orderof;": "\u2134",
    "ordf": "\xaa",
    "ordf;": "\xaa",
    "ordm": "\xba",
    "ordm;": "\xba",
    "origof;": "\u22b6",
    "oror;": "\u2a56",
    "orslope;": "\u2a57",
    "orv;": "\u2a5b",
    "oscr;": "\u2134",
    "oslash": "\xf8",
    "oslash;": "\xf8",
    "osol;": "\u2298",
    "otilde": "\xf5",
    "otilde;": "\xf5",
    "otimes;": "\u2297",
    "otimesas;": "\u2a36",
    "ouml": "\xf6",
    "ouml;": "\xf6",
    "ovbar;": "\u233d",
    "par;": "\u2225",
    "para": "\xb6",
    "para;": "\xb6",
    "parallel;": "\u2225",
    "parsim;": "\u2af3",
    "parsl;": "\u2afd",
    "part;": "\u2202",
    "pcy;": "\u043f",
    "percnt;": "%",
    "period;": ".",
    "permil;": "\u2030",
    "perp;": "\u22a5",
    "pertenk;": "\u2031",
    "pfr;": "\U0001d52d",
    "phi;": "\u03c6",
    "phiv;": "\u03d5",
    "phmmat;": "\u2133",
    "phone;": "\u260e",
    "pi;": "\u03c0",
    "pitchfork;": "\u22d4",
    "piv;": "\u03d6",
    "planck;": "\u210f",
    "planckh;": "\u210e",
    "plankv;": "\u210f",
    "plus;": "+",
    "plusacir;": "\u2a23",
    "plusb;": "\u229e",
    "pluscir;": "\u2a22",
    "plusdo;": "\u2214",
    "plusdu;": "\u2a25",
    "pluse;": "\u2a72",
    "plusmn": "\xb1",
    "plusmn;": "\xb1",
    "plussim;": "\u2a26",
    "plustwo;": "\u2a27",
    "pm;": "\xb1",
    "pointint;": "\u2a15",
    "popf;": "\U0001d561",
    "pound": "\xa3",
    "pound;": "\xa3",
    "pr;": "\u227a",
    "prE;": "\u2ab3",
    "prap;": "\u2ab7",
    "prcue;": "\u227c",
    "pre;": "\u2aaf",
    "prec;": "\u227a",
    "precapprox;": "\u2ab7",
    "preccurlyeq;": "\u227c",
    "preceq;": "\u2aaf",
    "precnapprox;": "\u2ab9",
    "precneqq;": "\u2ab5",
    "precnsim;": "\u22e8",
    "precsim;": "\u227e",
    "prime;": "\u2032",
    "primes;": "\u2119",
    "prnE;": "\u2ab5",
    "prnap;": "\u2ab9",
    "prnsim;": "\u22e8",
    "prod;": "\u220f",
    "profalar;": "\u232e",
    "profline;": "\u2312",
    "profsurf;": "\u2313",
    "prop;": "\u221d",
    "propto;": "\u221d",
    "prsim;": "\u227e",
    "prurel;": "\u22b0",
    "pscr;": "\U0001d4c5",
    "psi;": "\u03c8",
    "puncsp;": "\u2008",
    "qfr;": "\U0001d52e",
    "qint;": "\u2a0c",
    "qopf;": "\U0001d562",
    "qprime;": "\u2057",
    "qscr;": "\U0001d4c6",
    "quaternions;": "\u210d",
    "quatint;": "\u2a16",
    "quest;": "?",
    "questeq;": "\u225f",
    "quot": "\"",
    "quot;": "\"",
    "rAarr;": "\u21db",
    "rArr;": "\u21d2",
    "rAtail;": "\u291c",
    "rBarr;": "\u290f",
    "rHar;": "\u2964",
    "race;": "\u223d\u0331",
    "racute;": "\u0155",
    "radic;": "\u221a",
    "raemptyv;": "\u29b3",
    "rang;": "\u27e9",
    "rangd;": "\u2992",
    "range;": "\u29a5",
    "rangle;": "\u27e9",
    "raquo": "\xbb",
    "raquo;": "\xbb",
    "rarr;": "\u2192",
    "rarrap;": "\u2975",
    "rarrb;": "\u21e5",
    "rarrbfs;": "\u2920",
    "rarrc;": "\u2933",
    "rarrfs;": "\u291e",
    "rarrhk;": "\u21aa",
    "rarrlp;": "\u21ac",
    "rarrpl;": "\u2945",
    "rarrsim;": "\u2974",
    "rarrtl;": "\u21a3",
    "rarrw;": "\u219d",
    "ratail;": "\u291a",
    "ratio;": "\u2236",
    "rationals;": "\u211a",
    "rbarr;": "\u290d",
    "rbbrk;": "\u2773",
    "rbrace;": "}",
    "rbrack;": "]",
    "rbrke;": "\u298c",
    "rbrksld;": "\u298e",
    "rbrkslu;": "\u2990",
    "rcaron;": "\u0159",
    "rcedil;": "\u0157",
    "rceil;": "\u2309",
    "rcub;": "}",
    "rcy;": "\u0440",
    "rdca;": "\u2937",
    "rdldhar;": "\u2969",
    "rdquo;": "\u201d",
    "rdquor;": "\u201d",
    "rdsh;": "\u21b3",
    "real;": "\u211c",
    "realine;": "\u211b",
    "realpart;": "\u211c",
    "reals;": "\u211d",
    "rect;": "\u25ad",
    "reg": "\xae",
    "reg;": "\xae",
    "rfisht;": "\u297d",
    "rfloor;": "\u230b",
    "rfr;": "\U0001d52f",
    "rhard;": "\u21c1",
    "rharu;": "\u21c0",
    "rharul;": "\u296c",
    "rho;": "\u03c1",
    "rhov;": "\u03f1",
    "rightarrow;": "\u2192",
    "rightarrowtail;": "\u21a3",
    "rightharpoondown;": "\u21c1",
    "rightharpoonup;": "\u21c0",
    "rightleftarrows;": "\u21c4",
    "rightleftharpoons;": "\u21cc",
    "rightrightarrows;": "\u21c9",
    "rightsquigarrow;": "\u219d",
    "rightthreetimes;": "\u22cc",
    "ring;": "\u02da",
    "risingdotseq;": "\u2253",
    "rlarr;": "\u21c4",
    "rlhar;": "\u21cc",
    "rlm;": "\u200f",
    "rmoust;": "\u23b1",
    "rmoustache;": "\u23b1",
    "rnmid;": "\u2aee",
    "roang;": "\u27ed",
    "roarr;": "\u21fe",
    "robrk;": "\u27e7",
    "ropar;": "\u2986",
    "ropf;": "\U0001d563",
    "roplus;": "\u2a2e",
    "rotimes;": "\u2a35",
    "rpar;": ")",
    "rpargt;": "\u2994",
    "rppolint;": "\u2a12",
    "rrarr;": "\u21c9",
    "rsaquo;": "\u203a",
    "rscr;": "\U0001d4c7",
    "rsh;": "\u21b1",
    "rsqb;": "]",
    "rsquo;": "\u2019",
    "rsquor;": "\u2019",
    "rthree;": "\u22cc",
    "rtimes;": "\u22ca",
    "rtri;": "\u25b9",
    "rtrie;": "\u22b5",
    "rtrif;": "\u25b8",
    "rtriltri;": "\u29ce",
    "ruluhar;": "\u2968",
    "rx;": "\u211e",
    "sacute;": "\u015b",
    "sbquo;": "\u201a",
    "sc;": "\u227b",
    "scE;": "\u2ab4",
    "scap;": "\u2ab8",
    "scaron;": "\u0161",
    "sccue;": "\u227d",
    "sce;": "\u2ab0",
    "scedil;": "\u015f",
    "scirc;": "\u015d",
    "scnE;": "\u2ab6",
    "scnap;": "\u2aba",
    "scnsim;": "\u22e9",
    "scpolint;": "\u2a13",
    "scsim;": "\u227f",
    "scy;": "\u0441",
    "sdot;": "\u22c5",
    "sdotb;": "\u22a1",
    "sdote;": "\u2a66",
    "seArr;": "\u21d8",
    "searhk;": "\u2925",
    "searr;": "\u2198",
    "searrow;": "\u2198",
    "sect": "\xa7",
    "sect;": "\xa7",
    "semi;": ";",
    "seswar;": "\u2929",
    "setminus;": "\u2216",
    "setmn;": "\u2216",
    "sext;": "\u2736",
    "sfr;": "\U0001d530",
    "sfrown;": "\u2322",
    "sharp;": "\u266f",
    "shchcy;": "\u0449",
    "shcy;": "\u0448",
    "shortmid;": "\u2223",
    "shortparallel;": "\u2225",
    "shy": "\xad",
    "shy;": "\xad",
    "sigma;": "\u03c3",
    "sigmaf;": "\u03c2",
    "sigmav;": "\u03c2",
    "sim;": "\u223c",
    "simdot;": "\u2a6a",
    "sime;": "\u2243",
    "simeq;": "\u2243",
    "simg;": "\u2a9e",
    "simgE;": "\u2aa0",
    "siml;": "\u2a9d",
    "simlE;": "\u2a9f",
    "simne;": "\u2246",
    "simplus;": "\u2a24",
    "simrarr;": "\u2972",
    "slarr;": "\u2190",
    "smallsetminus;": "\u2216",
    "smashp;": "\u2a33",
    "smeparsl;": "\u29e4",
    "smid;": "\u2223",
    "smile;": "\u2323",
    "smt;": "\u2aaa",
    "smte;": "\u2aac",
    "smtes;": "\u2aac\ufe00",
    "softcy;": "\u044c",
    "sol;": "/",
    "solb;": "\u29c4",
    "solbar;": "\u233f",
    "sopf;": "\U0001d564",
    "spades;": "\u2660",
    "spadesuit;": "\u2660",
    "spar;": "\u2225",
    "sqcap;": "\u2293",
    "sqcaps;": "\u2293\ufe00",
    "sqcup;": "\u2294",
    "sqcups;": "\u2294\ufe00",
    "sqsub;": "\u228f",
    "sqsube;": "\u2291",
    "sqsubset;": "\u228f",
    "sqsubseteq;": "\u2291",
    "sqsup;": "\u2290",
    "sqsupe;": "\u2292",
    "sqsupset;": "\u2290",
    "sqsupseteq;": "\u2292",
    "squ;": "\u25a1",
    "square;": "\u25a1",
    "squarf;": "\u25aa",
    "squf;": "\u25aa",
    "srarr;": "\u2192",
    "sscr;": "\U0001d4c8",
    "ssetmn;": "\u2216",
    "ssmile;": "\u2323",
    "sstarf;": "\u22c6",
    "star;": "\u2606",
    "starf;": "\u2605",
    "straightepsilon;": "\u03f5",
    "straightphi;": "\u03d5",
    "strns;": "\xaf",
    "sub;": "\u2282",
    "subE;": "\u2ac5",
    "subdot;": "\u2abd",
    "sube;": "\u2286",
    "subedot;": "\u2ac3",
    "submult;": "\u2ac1",
    "subnE;": "\u2acb",
    "subne;": "\u228a",
    "subplus;": "\u2abf",
    "subrarr;": "\u2979",
    "subset;": "\u2282",
    "subseteq;": "\u2286",
    "subseteqq;": "\u2ac5",
    "subsetneq;": "\u228a",
    "subsetneqq;": "\u2acb",
    "subsim;": "\u2ac7",
    "subsub;": "\u2ad5",
    "subsup;": "\u2ad3",
    "succ;": "\u227b",
    "succapprox;": "\u2ab8",
    "succcurlyeq;": "\u227d",
    "succeq;": "\u2ab0",
    "succnapprox;": "\u2aba",
    "succneqq;": "\u2ab6",
    "succnsim;": "\u22e9",
    "succsim;": "\u227f",
    "sum;": "\u2211",
    "sung;": "\u266a",
    "sup1": "\xb9",
    "sup1;": "\xb9",
    "sup2": "\xb2",
    "sup2;": "\xb2",
    "sup3": "\xb3",
    "sup3;": "\xb3",
    "sup;": "\u2283",
    "supE;": "\u2ac6",
    "supdot;": "\u2abe",
    "supdsub;": "\u2ad8",
    "supe;": "\u2287",
    "supedot;": "\u2ac4",
    "suphsol;": "\u27c9",
    "suphsub;": "\u2ad7",
    "suplarr;": "\u297b",
    "supmult;": "\u2ac2",
    "supnE;": "\u2acc",
    "supne;": "\u228b",
    "supplus;": "\u2ac0",
    "supset;": "\u2283",
    "supseteq;": "\u2287",
    "supseteqq;": "\u2ac6",
    "supsetneq;": "\u228b",
    "supsetneqq;": "\u2acc",
    "supsim;": "\u2ac8",
    "supsub;": "\u2ad4",
    "supsup;": "\u2ad6",
    "swArr;": "\u21d9",
    "swarhk;": "\u2926",
    "swarr;": "\u2199",
    "swarrow;": "\u2199",
    "swnwar;": "\u292a",
    "szlig": "\xdf",
    "szlig;": "\xdf",
    "target;": "\u2316",
    "tau;": "\u03c4",
    "tbrk;": "\u23b4",
    "tcaron;": "\u0165",
    "tcedil;": "\u0163",
    "tcy;": "\u0442",
    "tdot;": "\u20db",
    "telrec;": "\u2315",
    "tfr;": "\U0001d531",
    "there4;": "\u2234",
    "therefore;": "\u2234",
    "theta;": "\u03b8",
    "thetasym;": "\u03d1",
    "thetav;": "\u03d1",
    "thickapprox;": "\u2248",
    "thicksim;": "\u223c",
    "thinsp;": "\u2009",
    "thkap;": "\u2248",
    "thksim;": "\u223c",
    "thorn": "\xfe",
    "thorn;": "\xfe",
    "tilde;": "\u02dc",
    "times": "\xd7",
    "times;": "\xd7",
    "timesb;": "\u22a0",
    "timesbar;": "\u2a31",
    "timesd;": "\u2a30",
    "tint;": "\u222d",
    "toea;": "\u2928",
    "top;": "\u22a4",
    "topbot;": "\u2336",
    "topcir;": "\u2af1",
    "topf;": "\U0001d565",
    "topfork;": "\u2ada",
    "tosa;": "\u2929",
    "tprime;": "\u2034",
    "trade;": "\u2122",
    "triangle;": "\u25b5",
    "triangledown;": "\u25bf",
    "triangleleft;": "\u25c3",
    "trianglelefteq;": "\u22b4",
    "triangleq;": "\u225c",
    "triangleright;": "\u25b9",
    "trianglerighteq;": "\u22b5",
    "tridot;": "\u25ec",
    "trie;": "\u225c",
    "triminus;": "\u2a3a",
    "triplus;": "\u2a39",
    "trisb;": "\u29cd",
    "tritime;": "\u2a3b",
    "trpezium;": "\u23e2",
    "tscr;": "\U0001d4c9",
    "tscy;": "\u0446",
    "tshcy;": "\u045b",
    "tstrok;": "\u0167",
    "twixt;": "\u226c",
    "twoheadleftarrow;": "\u219e",
    "twoheadrightarrow;": "\u21a0",
    "uArr;": "\u21d1",
    "uHar;": "\u2963",
    "uacute": "\xfa",
    "uacute;": "\xfa",
    "uarr;": "\u2191",
    "ubrcy;": "\u045e",
    "ubreve;": "\u016d",
    "ucirc": "\xfb",
    "ucirc;": "\xfb",
    "ucy;": "\u0443",
    "udarr;": "\u21c5",
    "udblac;": "\u0171",
    "udhar;": "\u296e",
    "ufisht;": "\u297e",
    "ufr;": "\U0001d532",
    "ugrave": "\xf9",
    "ugrave;": "\xf9",
    "uharl;": "\u21bf",
    "uharr;": "\u21be",
    "uhblk;": "\u2580",
    "ulcorn;": "\u231c",
    "ulcorner;": "\u231c",
    "ulcrop;": "\u230f",
    "ultri;": "\u25f8",
    "umacr;": "\u016b",
    "uml": "\xa8",
    "uml;": "\xa8",
    "uogon;": "\u0173",
    "uopf;": "\U0001d566",
    "uparrow;": "\u2191",
    "updownarrow;": "\u2195",
    "upharpoonleft;": "\u21bf",
    "upharpoonright;": "\u21be",
    "uplus;": "\u228e",
    "upsi;": "\u03c5",
    "upsih;": "\u03d2",
    "upsilon;": "\u03c5",
    "upuparrows;": "\u21c8",
    "urcorn;": "\u231d",
    "urcorner;": "\u231d",
    "urcrop;": "\u230e",
    "uring;": "\u016f",
    "urtri;": "\u25f9",
    "uscr;": "\U0001d4ca",
    "utdot;": "\u22f0",
    "utilde;": "\u0169",
    "utri;": "\u25b5",
    "utrif;": "\u25b4",
    "uuarr;": "\u21c8",
    "uuml": "\xfc",
    "uuml;": "\xfc",
    "uwangle;": "\u29a7",
    "vArr;": "\u21d5",
    "vBar;": "\u2ae8",
    "vBarv;": "\u2ae9",
    "vDash;": "\u22a8",
    "vangrt;": "\u299c",
    "varepsilon;": "\u03f5",
    "varkappa;": "\u03f0",
    "varnothing;": "\u2205",
    "varphi;": "\u03d5",
    "varpi;": "\u03d6",
    "varpropto;": "\u221d",
    "varr;": "\u2195",
    "varrho;": "\u03f1",
    "varsigma;": "\u03c2",
    "varsubsetneq;": "\u228a\ufe00",
    "varsubsetneqq;": "\u2acb\ufe00",
    "varsupsetneq;": "\u228b\ufe00",
    "varsupsetneqq;": "\u2acc\ufe00",
    "vartheta;": "\u03d1",
    "vartriangleleft;": "\u22b2",
    "vartriangleright;": "\u22b3",
    "vcy;": "\u0432",
    "vdash;": "\u22a2",
    "vee;": "\u2228",
    "veebar;": "\u22bb",
    "veeeq;": "\u225a",
    "vellip;": "\u22ee",
    "verbar;": "|",
    "vert;": "|",
    "vfr;": "\U0001d533",
    "vltri;": "\u22b2",
    "vnsub;": "\u2282\u20d2",
    "vnsup;": "\u2283\u20d2",
    "vopf;": "\U0001d567",
    "vprop;": "\u221d",
    "vrtri;": "\u22b3",
    "vscr;": "\U0001d4cb",
    "vsubnE;": "\u2acb\ufe00",
    "vsubne;": "\u228a\ufe00",
    "vsupnE;": "\u2acc\ufe00",
    "vsupne;": "\u228b\ufe00",
    "vzigzag;": "\u299a",
    "wcirc;": "\u0175",
    "wedbar;": "\u2a5f",
    "wedge;": "\u2227",
    "wedgeq;": "\u2259",
    "weierp;": "\u2118",
    "wfr;": "\U0001d534",
    "wopf;": "\U0001d568",
    "wp;": "\u2118",
    "wr;": "\u2240",
    "wreath;": "\u2240",
    "wscr;": "\U0001d4cc",
    "xcap;": "\u22c2",
    "xcirc;": "\u25ef",
    "xcup;": "\u22c3",
    "xdtri;": "\u25bd",
    "xfr;": "\U0001d535",
    "xhArr;": "\u27fa",
    "xharr;": "\u27f7",
    "xi;": "\u03be",
    "xlArr;": "\u27f8",
    "xlarr;": "\u27f5",
    "xmap;": "\u27fc",
    "xnis;": "\u22fb",
    "xodot;": "\u2a00",
    "xopf;": "\U0001d569",
    "xoplus;": "\u2a01",
    "xotime;": "\u2a02",
    "xrArr;": "\u27f9",
    "xrarr;": "\u27f6",
    "xscr;": "\U0001d4cd",
    "xsqcup;": "\u2a06",
    "xuplus;": "\u2a04",
    "xutri;": "\u25b3",
    "xvee;": "\u22c1",
    "xwedge;": "\u22c0",
    "yacute": "\xfd",
    "yacute;": "\xfd",
    "yacy;": "\u044f",
    "ycirc;": "\u0177",
    "ycy;": "\u044b",
    "yen": "\xa5",
    "yen;": "\xa5",
    "yfr;": "\U0001d536",
    "yicy;": "\u0457",
    "yopf;": "\U0001d56a",
    "yscr;": "\U0001d4ce",
    "yucy;": "\u044e",
    "yuml": "\xff",
    "yuml;": "\xff",
    "zacute;": "\u017a",
    "zcaron;": "\u017e",
    "zcy;": "\u0437",
    "zdot;": "\u017c",
    "zeetrf;": "\u2128",
    "zeta;": "\u03b6",
    "zfr;": "\U0001d537",
    "zhcy;": "\u0436",
    "zigrarr;": "\u21dd",
    "zopf;": "\U0001d56b",
    "zscr;": "\U0001d4cf",
    "zwj;": "\u200d",
    "zwnj;": "\u200c",
}

replacementCharacters = {
    0x0: "\uFFFD",
    0x0d: "\u000D",
    0x80: "\u20AC",
    0x81: "\u0081",
    0x82: "\u201A",
    0x83: "\u0192",
    0x84: "\u201E",
    0x85: "\u2026",
    0x86: "\u2020",
    0x87: "\u2021",
    0x88: "\u02C6",
    0x89: "\u2030",
    0x8A: "\u0160",
    0x8B: "\u2039",
    0x8C: "\u0152",
    0x8D: "\u008D",
    0x8E: "\u017D",
    0x8F: "\u008F",
    0x90: "\u0090",
    0x91: "\u2018",
    0x92: "\u2019",
    0x93: "\u201C",
    0x94: "\u201D",
    0x95: "\u2022",
    0x96: "\u2013",
    0x97: "\u2014",
    0x98: "\u02DC",
    0x99: "\u2122",
    0x9A: "\u0161",
    0x9B: "\u203A",
    0x9C: "\u0153",
    0x9D: "\u009D",
    0x9E: "\u017E",
    0x9F: "\u0178",
}

tokenTypes = {
    "Doctype": 0,
    "Characters": 1,
    "SpaceCharacters": 2,
    "StartTag": 3,
    "EndTag": 4,
    "EmptyTag": 5,
    "Comment": 6,
    "ParseError": 7
}

tagTokenTypes = frozenset([tokenTypes["StartTag"], tokenTypes["EndTag"],
                           tokenTypes["EmptyTag"]])


prefixes = dict([(v, k) for k, v in namespaces.items()])
prefixes["http://www.w3.org/1998/Math/MathML"] = "math"


class DataLossWarning(UserWarning):
    """Raised when the current tree is unable to represent the input data"""
    pass


class _ReparseException(Exception):
    pass
site-packages/pip/_vendor/html5lib/serializer.py000064400000036616151446177000015774 0ustar00from __future__ import absolute_import, division, unicode_literals
from pip._vendor.six import text_type

import re

from codecs import register_error, xmlcharrefreplace_errors

from .constants import voidElements, booleanAttributes, spaceCharacters
from .constants import rcdataElements, entities, xmlEntities
from . import treewalkers, _utils
from xml.sax.saxutils import escape

_quoteAttributeSpecChars = "".join(spaceCharacters) + "\"'=<>`"
_quoteAttributeSpec = re.compile("[" + _quoteAttributeSpecChars + "]")
_quoteAttributeLegacy = re.compile("[" + _quoteAttributeSpecChars +
                                   "\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n"
                                   "\x0b\x0c\r\x0e\x0f\x10\x11\x12\x13\x14\x15"
                                   "\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f"
                                   "\x20\x2f\x60\xa0\u1680\u180e\u180f\u2000"
                                   "\u2001\u2002\u2003\u2004\u2005\u2006\u2007"
                                   "\u2008\u2009\u200a\u2028\u2029\u202f\u205f"
                                   "\u3000]")


_encode_entity_map = {}
_is_ucs4 = len("\U0010FFFF") == 1
for k, v in list(entities.items()):
    # skip multi-character entities
    if ((_is_ucs4 and len(v) > 1) or
            (not _is_ucs4 and len(v) > 2)):
        continue
    if v != "&":
        if len(v) == 2:
            v = _utils.surrogatePairToCodepoint(v)
        else:
            v = ord(v)
        if v not in _encode_entity_map or k.islower():
            # prefer &lt; over &LT; and similarly for &amp;, &gt;, etc.
            _encode_entity_map[v] = k


def htmlentityreplace_errors(exc):
    if isinstance(exc, (UnicodeEncodeError, UnicodeTranslateError)):
        res = []
        codepoints = []
        skip = False
        for i, c in enumerate(exc.object[exc.start:exc.end]):
            if skip:
                skip = False
                continue
            index = i + exc.start
            if _utils.isSurrogatePair(exc.object[index:min([exc.end, index + 2])]):
                codepoint = _utils.surrogatePairToCodepoint(exc.object[index:index + 2])
                skip = True
            else:
                codepoint = ord(c)
            codepoints.append(codepoint)
        for cp in codepoints:
            e = _encode_entity_map.get(cp)
            if e:
                res.append("&")
                res.append(e)
                if not e.endswith(";"):
                    res.append(";")
            else:
                res.append("&#x%s;" % (hex(cp)[2:]))
        return ("".join(res), exc.end)
    else:
        return xmlcharrefreplace_errors(exc)


register_error("htmlentityreplace", htmlentityreplace_errors)


def serialize(input, tree="etree", encoding=None, **serializer_opts):
    """Serializes the input token stream using the specified treewalker

    :arg input: the token stream to serialize

    :arg tree: the treewalker to use

    :arg encoding: the encoding to use

    :arg serializer_opts: any options to pass to the
        :py:class:`html5lib.serializer.HTMLSerializer` that gets created

    :returns: the tree serialized as a string

    Example:

    >>> from html5lib.html5parser import parse
    >>> from html5lib.serializer import serialize
    >>> token_stream = parse('<html><body><p>Hi!</p></body></html>')
    >>> serialize(token_stream, omit_optional_tags=False)
    '<html><head></head><body><p>Hi!</p></body></html>'

    """
    # XXX: Should we cache this?
    walker = treewalkers.getTreeWalker(tree)
    s = HTMLSerializer(**serializer_opts)
    return s.render(walker(input), encoding)


class HTMLSerializer(object):

    # attribute quoting options
    quote_attr_values = "legacy"  # be secure by default
    quote_char = '"'
    use_best_quote_char = True

    # tag syntax options
    omit_optional_tags = True
    minimize_boolean_attributes = True
    use_trailing_solidus = False
    space_before_trailing_solidus = True

    # escaping options
    escape_lt_in_attrs = False
    escape_rcdata = False
    resolve_entities = True

    # miscellaneous options
    alphabetical_attributes = False
    inject_meta_charset = True
    strip_whitespace = False
    sanitize = False

    options = ("quote_attr_values", "quote_char", "use_best_quote_char",
               "omit_optional_tags", "minimize_boolean_attributes",
               "use_trailing_solidus", "space_before_trailing_solidus",
               "escape_lt_in_attrs", "escape_rcdata", "resolve_entities",
               "alphabetical_attributes", "inject_meta_charset",
               "strip_whitespace", "sanitize")

    def __init__(self, **kwargs):
        """Initialize HTMLSerializer

        :arg inject_meta_charset: Whether or not to inject the meta charset.

            Defaults to ``True``.

        :arg quote_attr_values: Whether to quote attribute values that don't
            require quoting per legacy browser behavior (``"legacy"``), when
            required by the standard (``"spec"``), or always (``"always"``).

            Defaults to ``"legacy"``.

        :arg quote_char: Use given quote character for attribute quoting.

            Defaults to ``"`` which will use double quotes unless attribute
            value contains a double quote, in which case single quotes are
            used.

        :arg escape_lt_in_attrs: Whether or not to escape ``<`` in attribute
            values.

            Defaults to ``False``.

        :arg escape_rcdata: Whether to escape characters that need to be
            escaped within normal elements within rcdata elements such as
            style.

            Defaults to ``False``.

        :arg resolve_entities: Whether to resolve named character entities that
            appear in the source tree. The XML predefined entities &lt; &gt;
            &amp; &quot; &apos; are unaffected by this setting.

            Defaults to ``True``.

        :arg strip_whitespace: Whether to remove semantically meaningless
            whitespace. (This compresses all whitespace to a single space
            except within ``pre``.)

            Defaults to ``False``.

        :arg minimize_boolean_attributes: Shortens boolean attributes to give
            just the attribute value, for example::

              <input disabled="disabled">

            becomes::

              <input disabled>

            Defaults to ``True``.

        :arg use_trailing_solidus: Includes a close-tag slash at the end of the
            start tag of void elements (empty elements whose end tag is
            forbidden). E.g. ``<hr/>``.

            Defaults to ``False``.

        :arg space_before_trailing_solidus: Places a space immediately before
            the closing slash in a tag using a trailing solidus. E.g.
            ``<hr />``. Requires ``use_trailing_solidus=True``.

            Defaults to ``True``.

        :arg sanitize: Strip all unsafe or unknown constructs from output.
            See :py:class:`html5lib.filters.sanitizer.Filter`.

            Defaults to ``False``.

        :arg omit_optional_tags: Omit start/end tags that are optional.

            Defaults to ``True``.

        :arg alphabetical_attributes: Reorder attributes to be in alphabetical order.

            Defaults to ``False``.

        """
        unexpected_args = frozenset(kwargs) - frozenset(self.options)
        if len(unexpected_args) > 0:
            raise TypeError("__init__() got an unexpected keyword argument '%s'" % next(iter(unexpected_args)))
        if 'quote_char' in kwargs:
            self.use_best_quote_char = False
        for attr in self.options:
            setattr(self, attr, kwargs.get(attr, getattr(self, attr)))
        self.errors = []
        self.strict = False

    def encode(self, string):
        assert(isinstance(string, text_type))
        if self.encoding:
            return string.encode(self.encoding, "htmlentityreplace")
        else:
            return string

    def encodeStrict(self, string):
        assert(isinstance(string, text_type))
        if self.encoding:
            return string.encode(self.encoding, "strict")
        else:
            return string

    def serialize(self, treewalker, encoding=None):
        # pylint:disable=too-many-nested-blocks
        self.encoding = encoding
        in_cdata = False
        self.errors = []

        if encoding and self.inject_meta_charset:
            from .filters.inject_meta_charset import Filter
            treewalker = Filter(treewalker, encoding)
        # Alphabetical attributes is here under the assumption that none of
        # the later filters add or change order of attributes; it needs to be
        # before the sanitizer so escaped elements come out correctly
        if self.alphabetical_attributes:
            from .filters.alphabeticalattributes import Filter
            treewalker = Filter(treewalker)
        # WhitespaceFilter should be used before OptionalTagFilter
        # for maximum efficiently of this latter filter
        if self.strip_whitespace:
            from .filters.whitespace import Filter
            treewalker = Filter(treewalker)
        if self.sanitize:
            from .filters.sanitizer import Filter
            treewalker = Filter(treewalker)
        if self.omit_optional_tags:
            from .filters.optionaltags import Filter
            treewalker = Filter(treewalker)

        for token in treewalker:
            type = token["type"]
            if type == "Doctype":
                doctype = "<!DOCTYPE %s" % token["name"]

                if token["publicId"]:
                    doctype += ' PUBLIC "%s"' % token["publicId"]
                elif token["systemId"]:
                    doctype += " SYSTEM"
                if token["systemId"]:
                    if token["systemId"].find('"') >= 0:
                        if token["systemId"].find("'") >= 0:
                            self.serializeError("System identifer contains both single and double quote characters")
                        quote_char = "'"
                    else:
                        quote_char = '"'
                    doctype += " %s%s%s" % (quote_char, token["systemId"], quote_char)

                doctype += ">"
                yield self.encodeStrict(doctype)

            elif type in ("Characters", "SpaceCharacters"):
                if type == "SpaceCharacters" or in_cdata:
                    if in_cdata and token["data"].find("</") >= 0:
                        self.serializeError("Unexpected </ in CDATA")
                    yield self.encode(token["data"])
                else:
                    yield self.encode(escape(token["data"]))

            elif type in ("StartTag", "EmptyTag"):
                name = token["name"]
                yield self.encodeStrict("<%s" % name)
                if name in rcdataElements and not self.escape_rcdata:
                    in_cdata = True
                elif in_cdata:
                    self.serializeError("Unexpected child element of a CDATA element")
                for (_, attr_name), attr_value in token["data"].items():
                    # TODO: Add namespace support here
                    k = attr_name
                    v = attr_value
                    yield self.encodeStrict(' ')

                    yield self.encodeStrict(k)
                    if not self.minimize_boolean_attributes or \
                        (k not in booleanAttributes.get(name, tuple()) and
                         k not in booleanAttributes.get("", tuple())):
                        yield self.encodeStrict("=")
                        if self.quote_attr_values == "always" or len(v) == 0:
                            quote_attr = True
                        elif self.quote_attr_values == "spec":
                            quote_attr = _quoteAttributeSpec.search(v) is not None
                        elif self.quote_attr_values == "legacy":
                            quote_attr = _quoteAttributeLegacy.search(v) is not None
                        else:
                            raise ValueError("quote_attr_values must be one of: "
                                             "'always', 'spec', or 'legacy'")
                        v = v.replace("&", "&amp;")
                        if self.escape_lt_in_attrs:
                            v = v.replace("<", "&lt;")
                        if quote_attr:
                            quote_char = self.quote_char
                            if self.use_best_quote_char:
                                if "'" in v and '"' not in v:
                                    quote_char = '"'
                                elif '"' in v and "'" not in v:
                                    quote_char = "'"
                            if quote_char == "'":
                                v = v.replace("'", "&#39;")
                            else:
                                v = v.replace('"', "&quot;")
                            yield self.encodeStrict(quote_char)
                            yield self.encode(v)
                            yield self.encodeStrict(quote_char)
                        else:
                            yield self.encode(v)
                if name in voidElements and self.use_trailing_solidus:
                    if self.space_before_trailing_solidus:
                        yield self.encodeStrict(" /")
                    else:
                        yield self.encodeStrict("/")
                yield self.encode(">")

            elif type == "EndTag":
                name = token["name"]
                if name in rcdataElements:
                    in_cdata = False
                elif in_cdata:
                    self.serializeError("Unexpected child element of a CDATA element")
                yield self.encodeStrict("</%s>" % name)

            elif type == "Comment":
                data = token["data"]
                if data.find("--") >= 0:
                    self.serializeError("Comment contains --")
                yield self.encodeStrict("<!--%s-->" % token["data"])

            elif type == "Entity":
                name = token["name"]
                key = name + ";"
                if key not in entities:
                    self.serializeError("Entity %s not recognized" % name)
                if self.resolve_entities and key not in xmlEntities:
                    data = entities[key]
                else:
                    data = "&%s;" % name
                yield self.encodeStrict(data)

            else:
                self.serializeError(token["data"])

    def render(self, treewalker, encoding=None):
        """Serializes the stream from the treewalker into a string

        :arg treewalker: the treewalker to serialize

        :arg encoding: the string encoding to use

        :returns: the serialized tree

        Example:

        >>> from html5lib import parse, getTreeWalker
        >>> from html5lib.serializer import HTMLSerializer
        >>> token_stream = parse('<html><body>Hi!</body></html>')
        >>> walker = getTreeWalker('etree')
        >>> serializer = HTMLSerializer(omit_optional_tags=False)
        >>> serializer.render(walker(token_stream))
        '<html><head></head><body>Hi!</body></html>'

        """
        if encoding:
            return b"".join(list(self.serialize(treewalker, encoding)))
        else:
            return "".join(list(self.serialize(treewalker)))

    def serializeError(self, data="XXX ERROR MESSAGE NEEDED"):
        # XXX The idea is to make data mandatory.
        self.errors.append(data)
        if self.strict:
            raise SerializeError


class SerializeError(Exception):
    """Error in serialized tree"""
    pass
site-packages/pip/_vendor/html5lib/__pycache__/_ihatexml.cpython-38.pyc000064400000032670151446177000022057 0ustar00U

��.eAA�	@s�ddlmZmZmZddlZddlZddlmZdZdZ	dZ
dZd	Zd
�
ee	g�Zd
�
eeddd
e
eg�Zd
�
ed
g�Ze�d�Ze�d�Zdd�Zdd�Zedd�Zdd�Zdd�Zdd�Zdd�Ze�d�Ze�d�Ze�d �ZGd!d"�d"e�Z dS)#�)�absolute_import�division�unicode_literalsN�)�DataLossWarninga^
[#x0041-#x005A] | [#x0061-#x007A] | [#x00C0-#x00D6] | [#x00D8-#x00F6] |
[#x00F8-#x00FF] | [#x0100-#x0131] | [#x0134-#x013E] | [#x0141-#x0148] |
[#x014A-#x017E] | [#x0180-#x01C3] | [#x01CD-#x01F0] | [#x01F4-#x01F5] |
[#x01FA-#x0217] | [#x0250-#x02A8] | [#x02BB-#x02C1] | #x0386 |
[#x0388-#x038A] | #x038C | [#x038E-#x03A1] | [#x03A3-#x03CE] |
[#x03D0-#x03D6] | #x03DA | #x03DC | #x03DE | #x03E0 | [#x03E2-#x03F3] |
[#x0401-#x040C] | [#x040E-#x044F] | [#x0451-#x045C] | [#x045E-#x0481] |
[#x0490-#x04C4] | [#x04C7-#x04C8] | [#x04CB-#x04CC] | [#x04D0-#x04EB] |
[#x04EE-#x04F5] | [#x04F8-#x04F9] | [#x0531-#x0556] | #x0559 |
[#x0561-#x0586] | [#x05D0-#x05EA] | [#x05F0-#x05F2] | [#x0621-#x063A] |
[#x0641-#x064A] | [#x0671-#x06B7] | [#x06BA-#x06BE] | [#x06C0-#x06CE] |
[#x06D0-#x06D3] | #x06D5 | [#x06E5-#x06E6] | [#x0905-#x0939] | #x093D |
[#x0958-#x0961] | [#x0985-#x098C] | [#x098F-#x0990] | [#x0993-#x09A8] |
[#x09AA-#x09B0] | #x09B2 | [#x09B6-#x09B9] | [#x09DC-#x09DD] |
[#x09DF-#x09E1] | [#x09F0-#x09F1] | [#x0A05-#x0A0A] | [#x0A0F-#x0A10] |
[#x0A13-#x0A28] | [#x0A2A-#x0A30] | [#x0A32-#x0A33] | [#x0A35-#x0A36] |
[#x0A38-#x0A39] | [#x0A59-#x0A5C] | #x0A5E | [#x0A72-#x0A74] |
[#x0A85-#x0A8B] | #x0A8D | [#x0A8F-#x0A91] | [#x0A93-#x0AA8] |
[#x0AAA-#x0AB0] | [#x0AB2-#x0AB3] | [#x0AB5-#x0AB9] | #x0ABD | #x0AE0 |
[#x0B05-#x0B0C] | [#x0B0F-#x0B10] | [#x0B13-#x0B28] | [#x0B2A-#x0B30] |
[#x0B32-#x0B33] | [#x0B36-#x0B39] | #x0B3D | [#x0B5C-#x0B5D] |
[#x0B5F-#x0B61] | [#x0B85-#x0B8A] | [#x0B8E-#x0B90] | [#x0B92-#x0B95] |
[#x0B99-#x0B9A] | #x0B9C | [#x0B9E-#x0B9F] | [#x0BA3-#x0BA4] |
[#x0BA8-#x0BAA] | [#x0BAE-#x0BB5] | [#x0BB7-#x0BB9] | [#x0C05-#x0C0C] |
[#x0C0E-#x0C10] | [#x0C12-#x0C28] | [#x0C2A-#x0C33] | [#x0C35-#x0C39] |
[#x0C60-#x0C61] | [#x0C85-#x0C8C] | [#x0C8E-#x0C90] | [#x0C92-#x0CA8] |
[#x0CAA-#x0CB3] | [#x0CB5-#x0CB9] | #x0CDE | [#x0CE0-#x0CE1] |
[#x0D05-#x0D0C] | [#x0D0E-#x0D10] | [#x0D12-#x0D28] | [#x0D2A-#x0D39] |
[#x0D60-#x0D61] | [#x0E01-#x0E2E] | #x0E30 | [#x0E32-#x0E33] |
[#x0E40-#x0E45] | [#x0E81-#x0E82] | #x0E84 | [#x0E87-#x0E88] | #x0E8A |
#x0E8D | [#x0E94-#x0E97] | [#x0E99-#x0E9F] | [#x0EA1-#x0EA3] | #x0EA5 |
#x0EA7 | [#x0EAA-#x0EAB] | [#x0EAD-#x0EAE] | #x0EB0 | [#x0EB2-#x0EB3] |
#x0EBD | [#x0EC0-#x0EC4] | [#x0F40-#x0F47] | [#x0F49-#x0F69] |
[#x10A0-#x10C5] | [#x10D0-#x10F6] | #x1100 | [#x1102-#x1103] |
[#x1105-#x1107] | #x1109 | [#x110B-#x110C] | [#x110E-#x1112] | #x113C |
#x113E | #x1140 | #x114C | #x114E | #x1150 | [#x1154-#x1155] | #x1159 |
[#x115F-#x1161] | #x1163 | #x1165 | #x1167 | #x1169 | [#x116D-#x116E] |
[#x1172-#x1173] | #x1175 | #x119E | #x11A8 | #x11AB | [#x11AE-#x11AF] |
[#x11B7-#x11B8] | #x11BA | [#x11BC-#x11C2] | #x11EB | #x11F0 | #x11F9 |
[#x1E00-#x1E9B] | [#x1EA0-#x1EF9] | [#x1F00-#x1F15] | [#x1F18-#x1F1D] |
[#x1F20-#x1F45] | [#x1F48-#x1F4D] | [#x1F50-#x1F57] | #x1F59 | #x1F5B |
#x1F5D | [#x1F5F-#x1F7D] | [#x1F80-#x1FB4] | [#x1FB6-#x1FBC] | #x1FBE |
[#x1FC2-#x1FC4] | [#x1FC6-#x1FCC] | [#x1FD0-#x1FD3] | [#x1FD6-#x1FDB] |
[#x1FE0-#x1FEC] | [#x1FF2-#x1FF4] | [#x1FF6-#x1FFC] | #x2126 |
[#x212A-#x212B] | #x212E | [#x2180-#x2182] | [#x3041-#x3094] |
[#x30A1-#x30FA] | [#x3105-#x312C] | [#xAC00-#xD7A3]z*[#x4E00-#x9FA5] | #x3007 | [#x3021-#x3029]a�
[#x0300-#x0345] | [#x0360-#x0361] | [#x0483-#x0486] | [#x0591-#x05A1] |
[#x05A3-#x05B9] | [#x05BB-#x05BD] | #x05BF | [#x05C1-#x05C2] | #x05C4 |
[#x064B-#x0652] | #x0670 | [#x06D6-#x06DC] | [#x06DD-#x06DF] |
[#x06E0-#x06E4] | [#x06E7-#x06E8] | [#x06EA-#x06ED] | [#x0901-#x0903] |
#x093C | [#x093E-#x094C] | #x094D | [#x0951-#x0954] | [#x0962-#x0963] |
[#x0981-#x0983] | #x09BC | #x09BE | #x09BF | [#x09C0-#x09C4] |
[#x09C7-#x09C8] | [#x09CB-#x09CD] | #x09D7 | [#x09E2-#x09E3] | #x0A02 |
#x0A3C | #x0A3E | #x0A3F | [#x0A40-#x0A42] | [#x0A47-#x0A48] |
[#x0A4B-#x0A4D] | [#x0A70-#x0A71] | [#x0A81-#x0A83] | #x0ABC |
[#x0ABE-#x0AC5] | [#x0AC7-#x0AC9] | [#x0ACB-#x0ACD] | [#x0B01-#x0B03] |
#x0B3C | [#x0B3E-#x0B43] | [#x0B47-#x0B48] | [#x0B4B-#x0B4D] |
[#x0B56-#x0B57] | [#x0B82-#x0B83] | [#x0BBE-#x0BC2] | [#x0BC6-#x0BC8] |
[#x0BCA-#x0BCD] | #x0BD7 | [#x0C01-#x0C03] | [#x0C3E-#x0C44] |
[#x0C46-#x0C48] | [#x0C4A-#x0C4D] | [#x0C55-#x0C56] | [#x0C82-#x0C83] |
[#x0CBE-#x0CC4] | [#x0CC6-#x0CC8] | [#x0CCA-#x0CCD] | [#x0CD5-#x0CD6] |
[#x0D02-#x0D03] | [#x0D3E-#x0D43] | [#x0D46-#x0D48] | [#x0D4A-#x0D4D] |
#x0D57 | #x0E31 | [#x0E34-#x0E3A] | [#x0E47-#x0E4E] | #x0EB1 |
[#x0EB4-#x0EB9] | [#x0EBB-#x0EBC] | [#x0EC8-#x0ECD] | [#x0F18-#x0F19] |
#x0F35 | #x0F37 | #x0F39 | #x0F3E | #x0F3F | [#x0F71-#x0F84] |
[#x0F86-#x0F8B] | [#x0F90-#x0F95] | #x0F97 | [#x0F99-#x0FAD] |
[#x0FB1-#x0FB7] | #x0FB9 | [#x20D0-#x20DC] | #x20E1 | [#x302A-#x302F] |
#x3099 | #x309Aa
[#x0030-#x0039] | [#x0660-#x0669] | [#x06F0-#x06F9] | [#x0966-#x096F] |
[#x09E6-#x09EF] | [#x0A66-#x0A6F] | [#x0AE6-#x0AEF] | [#x0B66-#x0B6F] |
[#x0BE7-#x0BEF] | [#x0C66-#x0C6F] | [#x0CE6-#x0CEF] | [#x0D66-#x0D6F] |
[#x0E50-#x0E59] | [#x0ED0-#x0ED9] | [#x0F20-#x0F29]z}
#x00B7 | #x02D0 | #x02D1 | #x0387 | #x0640 | #x0E46 | #x0EC6 | #x3005 |
#[#x3031-#x3035] | [#x309D-#x309E] | [#x30FC-#x30FE]� | �.�-�_z#x([\d|A-F]{4,4})z'\[#x([\d|A-F]{4,4})-#x([\d|A-F]{4,4})\]cCs�dd�|�d�D�}g}|D]�}d}ttfD]V}|�|�}|dk	r,|�dd�|��D��t|d�dkrz|dd|d<d	}q�q,|st|�dks�t�|�t|�gd�qt	|�}|S)
NcSsg|]}|���qS�)�strip��.0�itemrr�B/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_ihatexml.py�
<listcomp>hsz$charStringToList.<locals>.<listcomp>rFcSsg|]}t|��qSr)�hexToIntr
rrrros���r�T)
�split�reChar�reCharRange�match�append�groups�len�AssertionError�ord�normaliseCharList)�charsZ
charRanges�rvrZ
foundMatchZregexprrrr�charStringToListgs"
r!cCs�t|�}|D]}|d|dkst�qg}d}|t|�kr�d}|�||�||t|�kr�|||d|dddkr�|||d|dd<|d7}qL||7}q.|S)Nrrr)�sortedrrr)�charListrr �i�jrrrr|s0

rZFFFF�cCs�g}|ddkr*|�d|dddg�t|dd��D].\}}|�|dd||dddg�q:|ddtkr�|�|dddtg�|S)Nrrr)r�	enumerate�max_unicode)r#r r$rrrr�
missingRanges�s(r)cCsng}|D]V}|d|dkr4|�tt|d���q|�tt|d��dtt|d���qdd�|�S)Nrrr	z[%s]�)r�escapeRegexp�chr�join)r#r rrrr�listToRegexpStr�s�r.cCs
t|d�S)Nr&)�int)Zhex_strrrrr�srcCs"d}|D]}|�|d|�}q|S)N)r�^�$�*�+�?�{�}�[�]�|�(�)r	�\)�replace)�stringZspecialCharacters�charrrrr+�sr+u�[-,/:-@\[-\^`\{-¶¸-¿×÷IJ-ijĿ-ŀʼnſDŽ-njDZ-dzǶ-ǹȘ-ɏʩ-ʺ˂-ˏ˒-˿͆-͟͢-΅΋΍΢Ϗϗ-ϙϛϝϟϡϴ-ЀЍѐѝ҂҇-ҏӅ-ӆӉ-ӊӍ-ӏӬ-ӭӶ-ӷӺ-԰՗-՘՚-ՠև-֐ֺ֢־׀׃ׅ-׏׫-ׯ׳-ؠػ-ؿٓ-ٟ٪-ٯڸ-ڹڿۏ۔۩ۮ-ۯۺ-ऀऄऺ-ऻॎ-ॐॕ-ॗ।-॥॰-ঀ঄঍-঎঑-঒঩঱঳-঵঺-঻ঽ৅-৆৉-৊ৎ-৖৘-৛৞৤-৥৲-ਁਃ-਄਋-਎਑-਒਩਱਴਷਺-਻਽੃-੆੉-੊੎-੘੝੟-੥ੵ-઀઄ઌ઎઒઩઱઴઺-઻૆૊૎-૟ૡ-૥૰-଀଄଍-଎଑-଒଩଱଴-ଵ଺-଻ୄ-୆୉-୊୎-୕୘-୛୞ୢ-୥୰-஁஄஋-஍஑஖-஘஛஝஠-஢஥-஧஫-஭ஶ஺-஽௃-௅௉௎-௖௘-௦௰-ఀఄ఍఑఩ఴ఺-ఽ౅౉౎-౔౗-౟ౢ-౥౰-ಁ಄಍಑಩಴಺-ಽ೅೉೎-೔೗-ೝ೟ೢ-೥೰-ഁഄ഍഑ഩഺ-ഽൄ-൅൉ൎ-ൖ൘-ൟൢ-൥൰-฀ฯ฻-฿๏๚-຀຃຅-ຆຉ຋-ຌຎ-ຓຘຠ຤຦ຨ-ຩຬຯ຺຾-຿໅໇໎-໏໚-༗༚-༟༪-༴༶༸༺-༽཈ཪ-཰྅ྌ-ྏྖ྘ྮ-ྰྸྺ-႟჆-჏ჷ-ჿᄁᄄᄈᄊᄍᄓ-ᄻᄽᄿᅁ-ᅋᅍᅏᅑ-ᅓᅖ-ᅘᅚ-ᅞᅢᅤᅦᅨᅪ-ᅬᅯ-ᅱᅴᅶ-ᆝᆟ-ᆧᆩ-ᆪᆬ-ᆭᆰ-ᆶᆹᆻᇃ-ᇪᇬ-ᇯᇱ-ᇸᇺ-᷿ẜ-ẟỺ-ỿ἖-἗἞-἟὆-὇὎-὏὘὚὜὞὾-὿᾵᾽᾿-῁῅῍-῏῔-῕῜-῟῭-῱῵´-⃏⃝-⃠⃢-℥℧-℩ℬ-ℭℯ-ⅿↃ-〄〆〈-〠〰〶-぀ゕ-゘゛-゜ゟ-゠・ヿ-㄄ㄭ-䷿龦-꯿힤-￿]u�[-@\[-\^`\{-¿×÷IJ-ijĿ-ŀʼnſDŽ-njDZ-dzǶ-ǹȘ-ɏʩ-ʺ˂-΅·΋΍΢Ϗϗ-ϙϛϝϟϡϴ-ЀЍѐѝ҂-ҏӅ-ӆӉ-ӊӍ-ӏӬ-ӭӶ-ӷӺ-԰՗-՘՚-ՠև-׏׫-ׯ׳-ؠػ-ـً-ٰڸ-ڹڿۏ۔ۖ-ۤۧ-ऄऺ-़ा-ॗॢ-঄঍-঎঑-঒঩঱঳-঵঺-৛৞ৢ-৯৲-਄਋-਎਑-਒਩਱਴਷਺-੘੝੟-ੱੵ-઄ઌ઎઒઩઱઴઺-઼ા-૟ૡ-଄଍-଎଑-଒଩଱଴-ଵ଺-଼ା-୛୞ୢ-஄஋-஍஑஖-஘஛஝஠-஢஥-஧஫-஭ஶ஺-ఄ఍఑఩ఴ఺-౟ౢ-಄಍಑಩಴಺-ೝ೟ೢ-ഄ഍഑ഩഺ-ൟൢ-฀ฯัิ-฿ๆ-຀຃຅-ຆຉ຋-ຌຎ-ຓຘຠ຤຦ຨ-ຩຬຯັິ-ຼ຾-຿໅-༿཈ཪ-႟჆-჏ჷ-ჿᄁᄄᄈᄊᄍᄓ-ᄻᄽᄿᅁ-ᅋᅍᅏᅑ-ᅓᅖ-ᅘᅚ-ᅞᅢᅤᅦᅨᅪ-ᅬᅯ-ᅱᅴᅶ-ᆝᆟ-ᆧᆩ-ᆪᆬ-ᆭᆰ-ᆶᆹᆻᇃ-ᇪᇬ-ᇯᇱ-ᇸᇺ-᷿ẜ-ẟỺ-ỿ἖-἗἞-἟὆-὇὎-὏὘὚὜὞὾-὿᾵᾽᾿-῁῅῍-῏῔-῕῜-῟῭-῱῵´-℥℧-℩ℬ-ℭℯ-ⅿↃ-〆〈-〠〪-぀ゕ-゠・-㄄ㄭ-䷿龦-꯿힤-￿]z#[^ 
a-zA-Z0-9\-'()+,./:=?;!*#@$_%]c@sreZdZe�d�Zddd�Zddd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�
InfosetFilterz
U[\dA-F]{5,5}FTcCs.||_||_||_||_||_||_i|_dS�N)�dropXmlnsLocalName�dropXmlnsAttrNs�preventDoubleDashComments�preventDashAtCommentEnd�replaceFormFeedCharacters�preventSingleQuotePubid�replaceCache)�selfrBrCrDrErFrGrrr�__init__�szInfosetFilter.__init__NcCsL|jr |�d�r t�dt�dS|jr>|dkr>t�dt�dS|�|�SdS)Nzxmlns:z"Attributes cannot begin with xmlnszhttp://www.w3.org/2000/xmlns/z)Attributes cannot be in the xml namespace)rB�
startswith�warnings�warnrrC�	toXmlName)rI�name�	namespacerrr�coerceAttribute�s�zInfosetFilter.coerceAttributecCs
|�|�SrA)rN)rIrOrrr�
coerceElement�szInfosetFilter.coerceElementcCsJ|jrFd|kr(t�dt�|�dd�}q|�d�rFt�dt�|d7}|S)Nz--z'Comments cannot contain adjacent dashesz- -r	zComments cannot end in a dash� )rDrLrMrr=�endswith)rI�datarrr�
coerceComment�s
zInfosetFilter.coerceCommentcCs6|jr2t|�d��D]}t�dt�q|�dd�}|S)N�zText cannot contain U+000CrS)rF�range�countrLrMrr=)rIrUr
rrr�coerceCharacters�s
zInfosetFilter.coerceCharacterscCsl|}t�|�D]&}t�dt�|�|�}|�||�}q|jrh|�d�dkrht�dt�|�d|�d��}|S)NzCoercing non-XML pubid�'rz!Pubid cannot contain single quote)	�nonPubidCharRegexp�findallrLrMr�getReplacementCharacterr=rG�find)rIrUZ
dataOutputr?�replacementrrr�coercePubid�s
zInfosetFilter.coercePubidc
Cs�|d}|dd�}t�|�}|r:t�dt�|�|�}n|}|}tt�|��}|D]&}t�dt�|�|�}	|�	||	�}qT||S)NrrzCoercing non-XML name)
�nonXmlNameFirstBMPRegexprrLrMrr^�set�nonXmlNameBMPRegexpr]r=)
rIrO�	nameFirstZnameRest�mZnameFirstOutputZnameRestOutputZreplaceCharsr?r`rrrrN�s

zInfosetFilter.toXmlNamecCs$||jkr|j|}n
|�|�}|SrA)rH�
escapeChar�rIr?r`rrrr^s

z%InfosetFilter.getReplacementCharactercCs,t|j�|��D]}|�||�|��}q|SrA)rc�replacementRegexpr]r=�unescapeChar)rIrOrrrr�fromXmlNameszInfosetFilter.fromXmlNamecCsdt|�}||j|<|S)NzU%05X)rrHrhrrrrgs
zInfosetFilter.escapeCharcCstt|dd�d��S)Nrr&)r,r/)rIZcharcoderrrrjszInfosetFilter.unescapeChar)FFFFTF)N)�__name__�
__module__�__qualname__�re�compilerirJrQrRrVrZrarNr^rkrgrjrrrrr@�s$
�


r@)!Z
__future__rrrrorLZ	constantsrZbaseCharZideographicZcombiningCharacterZdigitZextenderr-ZletterrOrerprrr!rr/r(r)r.rr+rdrbr\�objectr@rrrr�<module>s40�


	


site-packages/pip/_vendor/html5lib/__pycache__/__init__.cpython-38.opt-1.pyc000064400000002400151446177000022567 0ustar00U

��.e��@shdZddlmZmZmZddlmZmZmZddl	m
Z
ddlmZddl
mZdd	d
ddd
gZdZdS)a�
HTML parsing library based on the `WHATWG HTML specification
<https://whatwg.org/html>`_. The parser is designed to be compatible with
existing HTML found in the wild and implements well-defined error recovery that
is largely compatible with modern desktop web browsers.

Example usage::

    from pip._vendor import html5lib
    with open("my_document.html", "rb") as f:
        tree = html5lib.parse(f)

For convenience, this module re-exports the following names:

* :func:`~.html5parser.parse`
* :func:`~.html5parser.parseFragment`
* :class:`~.html5parser.HTMLParser`
* :func:`~.treebuilders.getTreeBuilder`
* :func:`~.treewalkers.getTreeWalker`
* :func:`~.serializer.serialize`
�)�absolute_import�division�unicode_literals�)�
HTMLParser�parse�
parseFragment)�getTreeBuilder)�
getTreeWalker)�	serializerrrr	r
rz1.0.1N)�__doc__Z
__future__rrrZhtml5parserrrrZtreebuildersr	Ztreewalkersr
Z
serializerr�__all__�__version__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/__init__.py�<module>s�site-packages/pip/_vendor/html5lib/__pycache__/_tokenizer.cpython-38.opt-1.pyc000064400000115250151446177000023211 0ustar00U

��.e$+�@s�ddlmZmZmZddlmZddlmZddl	m
Z
ddl	mZddl	mZm
Z
ddl	mZmZmZdd	l	mZmZdd
l	mZddlmZddlmZee�ZGd
d�de�ZdS)�)�absolute_import�division�unicode_literals)�unichr)�deque�)�spaceCharacters)�entities)�asciiLetters�asciiUpper2Lower)�digits�	hexDigits�EOF)�
tokenTypes�
tagTokenTypes)�replacementCharacters)�HTMLInputStream)�TriecsdeZdZdZd��fdd�	Zdd�Zdd�Zd�d
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Zd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Z d>d?�Z!d@dA�Z"dBdC�Z#dDdE�Z$dFdG�Z%dHdI�Z&dJdK�Z'dLdM�Z(dNdO�Z)dPdQ�Z*dRdS�Z+dTdU�Z,dVdW�Z-dXdY�Z.dZd[�Z/d\d]�Z0d^d_�Z1d`da�Z2dbdc�Z3ddde�Z4dfdg�Z5dhdi�Z6djdk�Z7dldm�Z8dndo�Z9dpdq�Z:drds�Z;dtdu�Z<dvdw�Z=dxdy�Z>dzd{�Z?d|d}�Z@d~d�ZAd�d��ZBd�d��ZCd�d��ZDd�d��ZEd�d��ZFd�d��ZGd�d��ZHd�d��ZId�d��ZJd�d��ZKd�d��ZL�ZMS)��
HTMLTokenizera	 This class takes care of tokenizing HTML.

    * self.currentToken
      Holds the token that is currently being processed.

    * self.state
      Holds a reference to the method to be invoked... XXX

    * self.stream
      Points to HTMLInputStream object.
    NcsFt|f|�|_||_d|_g|_|j|_d|_d|_t	t
|���dS)NF)r�stream�parserZ
escapeFlagZ
lastFourChars�	dataState�state�escape�currentToken�superr�__init__)�selfrr�kwargs��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_tokenizer.pyr"szHTMLTokenizer.__init__ccsPtg�|_|��rL|jjr6td|jj�d�d�Vq|jr
|j��Vq6q
dS)z� This is where the magic happens.

        We do our usually processing through the states and when we have a token
        to return we yield the token which pauses processing until the next token
        is requested.
        �
ParseErrorr��type�dataN)r�
tokenQueuerr�errorsr�pop�popleft�rr!r!r"�__iter__1s
zHTMLTokenizer.__iter__c	%Cst}d}|rt}d}g}|j��}||krH|tk	rH|�|�|j��}q"td�|�|�}|tkr�t|}|j	�t
ddd|id���nbd|kr�d	ks�n|d
kr�d}|j	�t
ddd|id���n d|kr�d
k�s�nd|kr�dk�s�nd|k�rdk�s�nd|k�r,dk�s�n|tddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d
g#�k�r�|j	�t
ddd|id��zt|�}Wn>t
k
�r�|d6}td|d?B�td7|d8@B�}YnX|d9k�r|j	�t
dd:d;��|j�|�|S)<z�This function returns either U+FFFD or the character based on the
        decimal or hexadecimal representation. It also discards ";" if present.
        If not present self.tokenQueue.append({"type": tokenTypes["ParseError"]}) is invoked.
        �
��r#z$illegal-codepoint-for-numeric-entity�	charAsInt�r%r&Zdatavarsi�i��i����r�����i�i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��	i��	i��
i��
i��i��i��i��i��
i��
i��i��i��i��i��ii�i��;z numeric-entity-without-semicolonr$)rr
r�charr�append�int�joinrr'r�	frozenset�chr�
ValueError�unget)	rZisHexZallowed�radix�	charStack�cr0r:�vr!r!r"�consumeNumberEntityAs�

�����
�
�
�
�
��
�&
�z!HTMLTokenizer.consumeNumberEntityFc	Cs�d}|j��g}|dtksB|dtddfksB|dk	rV||dkrV|j�|d��n|ddk�rd}|�|j���|ddkr�d}|�|j���|r�|dtks�|s�|dtkr�|j�|d�|�|�}n4|j	�t
d	d
d��|j�|���dd�|�}�nh|dtk	�rDt
�d�|���s0�qD|�|j����qz$t
�d�|dd���}t|�}Wntk
�r�d}YnX|dk	�r@|dd
k�r�|j	�t
d	dd��|dd
k�r|�r||tk�s�||tk�s�||dk�r|j�|���dd�|�}n.t|}|j�|���|d�||d��7}n4|j	�t
d	dd��|j�|���dd�|�}|�r�|jddd|7<n*|tk�r�d}nd}|j	�t
||d��dS)N�&r�<�#F���)�x�XTr#zexpected-numeric-entityr$r/r9znamed-entity-without-semicolon�=zexpected-named-entityr&r�SpaceCharacters�
Characters)rr:rrrAr;r
rrFr'rr)r=�entitiesTrieZhas_keys_with_prefixZlongest_prefix�len�KeyErrorr
r	r)	r�allowedChar�
fromAttribute�outputrC�hexZ
entityNameZentityLengthZ	tokenTyper!r!r"�
consumeEntity�s~�
��
��

�
�
�
��
zHTMLTokenizer.consumeEntitycCs|j|dd�dS)zIThis method replaces the need for "entityInAttributeValueState".
        T)rSrTN)rW)rrSr!r!r"�processEntityInAttribute�sz&HTMLTokenizer.processEntityInAttributecCs�|j}|dtkrp|d�t�|d<|dtdkrp|drR|j�tddd��|drp|j�tdd	d��|j�|�|j|_d
S)z�This method is a generic handler for emitting the tags. It also sets
        the state to "data" because that's what's needed after a token has been
        emitted.
        r%�name�EndTagr&r#zattributes-in-end-tagr$�selfClosingzself-closing-flag-on-end-tagN)	rr�	translaterrr'r;rr)r�tokenr!r!r"�emitCurrentToken�s��zHTMLTokenizer.emitCurrentTokencCs�|j��}|dkr|j|_n�|dkr.|j|_n�|dkrd|j�tddd��|j�tddd��n`|tkrpdS|t	kr�|j�td	||j�
t	d
�d��n&|j�
d�}|j�td||d��d
S)NrGrH�r#�invalid-codepointr$rOFrNT�rGrHr_)rr:�entityDataStater�tagOpenStater'r;rrr�
charsUntil�rr&�charsr!r!r"r�s.


��
�
�zHTMLTokenizer.dataStatecCs|��|j|_dS�NT)rWrrr+r!r!r"rbszHTMLTokenizer.entityDataStatecCs�|j��}|dkr|j|_n�|dkr.|j|_n�|tkr:dS|dkrp|j�tddd��|j�tdd	d��nT|t	kr�|j�td
||j�
t	d�d��n&|j�
d�}|j�td||d��dS)
NrGrHFr_r#r`r$rOr2rNTra)rr:�characterReferenceInRcdatar�rcdataLessThanSignStaterr'r;rrrdrer!r!r"�rcdataStates.


��
�
�zHTMLTokenizer.rcdataStatecCs|��|j|_dSrg)rWrjrr+r!r!r"rh1sz(HTMLTokenizer.characterReferenceInRcdatacCs�|j��}|dkr|j|_nh|dkrR|j�tddd��|j�tddd��n2|tkr^dS|j�d	�}|j�td||d��d
S�NrHr_r#r`r$rOr2F)rHr_T)	rr:�rawtextLessThanSignStaterr'r;rrrdrer!r!r"�rawtextState6s"

��
�zHTMLTokenizer.rawtextStatecCs�|j��}|dkr|j|_nh|dkrR|j�tddd��|j�tddd��n2|tkr^dS|j�d	�}|j�td||d��d
Srk)	rr:�scriptDataLessThanSignStaterr'r;rrrdrer!r!r"�scriptDataStateHs"

��
�zHTMLTokenizer.scriptDataStatecCsr|j��}|tkrdS|dkrL|j�tddd��|j�tddd��n"|j�td||j�d�d��dS)	NFr_r#r`r$rOr2T)rr:rr'r;rrd�rr&r!r!r"�plaintextStateZs
��
�zHTMLTokenizer.plaintextStatecCs|j��}|dkr|j|_n�|dkr.|j|_n�|tkrVtd|gddd�|_|j|_n�|dkr�|j	�
tddd	��|j	�
td
dd	��|j|_nt|dkr�|j	�
tdd
d	��|j�|�|j
|_n@|j	�
tddd	��|j	�
td
dd	��|j�|�|j|_dS)N�!�/ZStartTagF)r%rYr&r[ZselfClosingAcknowledged�>r#z'expected-tag-name-but-got-right-bracketr$rOz<>�?z'expected-tag-name-but-got-question-markzexpected-tag-namerHT)rr:�markupDeclarationOpenStater�closeTagOpenStater
rr�tagNameStater'r;rrA�bogusCommentStaterpr!r!r"rcis@


�
�
�
�zHTMLTokenizer.tagOpenStatecCs�|j��}|tkr0td|gdd�|_|j|_n�|dkrX|j�tddd��|j	|_nn|t
kr�|j�tddd��|j�td	d
d��|j	|_n0|j�tddd|id
��|j�|�|j|_dS)NrZF�r%rYr&r[rtr#z*expected-closing-tag-but-got-right-bracketr$z expected-closing-tag-but-got-eofrO�</z!expected-closing-tag-but-got-charr&r1T)
rr:r
rrrxrr'r;rrrAryrpr!r!r"rw�s2
�
�
�
�zHTMLTokenizer.closeTagOpenStatecCs�|j��}|tkr|j|_n�|dkr.|��n~|tkrV|j�t	ddd��|j
|_nV|dkrh|j|_nD|dkr�|j�t	ddd��|jdd	7<n|jd|7<d
S)Nrtr#zeof-in-tag-namer$rsr_r`rYr2T)
rr:r�beforeAttributeNameStaterr^rr'r;rr�selfClosingStartTagStaterrpr!r!r"rx�s&


�

�zHTMLTokenizer.tagNameStatecCsP|j��}|dkr"d|_|j|_n*|j�tddd��|j�|�|j	|_dS�Nrsr/rOrHr$T)
rr:�temporaryBuffer�rcdataEndTagOpenStaterr'r;rrArjrpr!r!r"ri�s

z%HTMLTokenizer.rcdataLessThanSignStatecCsX|j��}|tkr*|j|7_|j|_n*|j�tddd��|j�	|�|j
|_dS�NrOr{r$T)rr:r
r�rcdataEndTagNameStaterr'r;rrArjrpr!r!r"r��s

z#HTMLTokenizer.rcdataEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
S�NrYrZFrzrsrtrOr{r$T)r�lowerrrr:rrr|rr}r^rr
r'r;rArj�rZappropriater&r!r!r"r��s@
�
�
�
�z#HTMLTokenizer.rcdataEndTagNameStatecCsP|j��}|dkr"d|_|j|_n*|j�tddd��|j�|�|j	|_dSr~)
rr:r�rawtextEndTagOpenStaterr'r;rrArmrpr!r!r"rl�s

z&HTMLTokenizer.rawtextLessThanSignStatecCsX|j��}|tkr*|j|7_|j|_n*|j�tddd��|j�	|�|j
|_dSr�)rr:r
r�rawtextEndTagNameStaterr'r;rrArmrpr!r!r"r��s

z$HTMLTokenizer.rawtextEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
Sr�)rr�rrr:rrr|rr}r^rr
r'r;rArmr�r!r!r"r�s@
�
�
�
�z$HTMLTokenizer.rawtextEndTagNameStatecCsx|j��}|dkr"d|_|j|_nR|dkrJ|j�tddd��|j|_n*|j�tddd��|j�	|�|j
|_dS)	Nrsr/rrrOz<!r$rHT)rr:r�scriptDataEndTagOpenStaterr'r;r�scriptDataEscapeStartStaterArorpr!r!r"rns


z)HTMLTokenizer.scriptDataLessThanSignStatecCsX|j��}|tkr*|j|7_|j|_n*|j�tddd��|j�	|�|j
|_dSr�)rr:r
r�scriptDataEndTagNameStaterr'r;rrArorpr!r!r"r�,s

z'HTMLTokenizer.scriptDataEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
Sr�)rr�rrr:rrr|rr}r^rr
r'r;rAror�r!r!r"r�7s@
�
�
�
�z'HTMLTokenizer.scriptDataEndTagNameStatecCsJ|j��}|dkr2|j�tddd��|j|_n|j�|�|j|_dS�N�-rOr$T)	rr:r'r;r�scriptDataEscapeStartDashStaterrArorpr!r!r"r�Ss

z(HTMLTokenizer.scriptDataEscapeStartStatecCsJ|j��}|dkr2|j�tddd��|j|_n|j�|�|j|_dSr�)	rr:r'r;r�scriptDataEscapedDashDashStaterrArorpr!r!r"r�]s

z,HTMLTokenizer.scriptDataEscapeStartDashStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrD|j|_nn|dkrz|j�tddd��|j�tddd��n8|tkr�|j	|_n&|j�
d	�}|j�td||d��d
S)Nr�rOr$rHr_r#r`r2)rHr�r_T)rr:r'r;r�scriptDataEscapedDashStater�"scriptDataEscapedLessThanSignStaterrrdrer!r!r"�scriptDataEscapedStategs(


��

�z$HTMLTokenizer.scriptDataEscapedStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrD|j|_nn|dkr�|j�tddd��|j�tddd��|j|_n0|t	kr�|j
|_n|j�td|d��|j|_d	S)
Nr�rOr$rHr_r#r`r2T)rr:r'r;rr�rr�r�rrrpr!r!r"r�{s&


��

z(HTMLTokenizer.scriptDataEscapedDashStatecCs�|j��}|dkr*|j�tddd��n�|dkr<|j|_n�|dkrd|j�tddd��|j|_nn|dkr�|j�tddd��|j�tdd	d��|j|_n0|t	kr�|j
|_n|j�td|d��|j|_d
S)Nr�rOr$rHrtr_r#r`r2T)rr:r'r;rr�rror�rrrpr!r!r"r��s*


��

z,HTMLTokenizer.scriptDataEscapedDashDashStatecCs�|j��}|dkr"d|_|j|_n\|tkrT|j�tdd|d��||_|j	|_n*|j�tddd��|j�
|�|j|_dSr~)rr:r� scriptDataEscapedEndTagOpenStaterr
r'r;r� scriptDataDoubleEscapeStartStaterAr�rpr!r!r"r��s


z0HTMLTokenizer.scriptDataEscapedLessThanSignStatecCsP|j��}|tkr"||_|j|_n*|j�tddd��|j�	|�|j
|_dSr�)rr:r
r� scriptDataEscapedEndTagNameStaterr'r;rrAr�rpr!r!r"r��s

z.HTMLTokenizer.scriptDataEscapedEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
Sr�)rr�rrr:rrr|rr}r^rr
r'r;rAr�r�r!r!r"r��s@
�
�
�
�z.HTMLTokenizer.scriptDataEscapedEndTagNameStatecCs�|j��}|ttd�BkrR|j�td|d��|j��dkrH|j	|_
q�|j|_
nB|tkr�|j�td|d��|j|7_n|j�
|�|j|_
dS�N)rsrtrOr$ZscriptT)rr:rr>r'r;rrr��scriptDataDoubleEscapedStaterr�r
rArpr!r!r"r��s


z.HTMLTokenizer.scriptDataDoubleEscapeStartStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrZ|j�tddd��|j|_nt|dkr�|j�tddd��|j�tddd��n>|tkr�|j�tdd	d��|j	|_n|j�td|d��d
S�Nr�rOr$rHr_r#r`r2�eof-in-script-in-scriptT)
rr:r'r;r� scriptDataDoubleEscapedDashStater�(scriptDataDoubleEscapedLessThanSignStaterrrpr!r!r"r��s*


��
�
z*HTMLTokenizer.scriptDataDoubleEscapedStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrZ|j�tddd��|j|_n�|dkr�|j�tddd��|j�tddd��|j|_nF|t	kr�|j�tdd	d��|j
|_n|j�td|d��|j|_d
Sr�)rr:r'r;r�$scriptDataDoubleEscapedDashDashStaterr�r�rrrpr!r!r"r�s.


��
�
z.HTMLTokenizer.scriptDataDoubleEscapedDashStatecCs|j��}|dkr*|j�tddd��n�|dkrR|j�tddd��|j|_n�|dkrz|j�tddd��|j|_n�|dkr�|j�tddd��|j�tdd	d��|j|_nF|t	kr�|j�tdd
d��|j
|_n|j�td|d��|j|_dS)Nr�rOr$rHrtr_r#r`r2r�T)rr:r'r;rr�rror�rrrpr!r!r"r�s2


��
�
z2HTMLTokenizer.scriptDataDoubleEscapedDashDashStatecCsP|j��}|dkr8|j�tddd��d|_|j|_n|j�|�|j	|_dS)NrsrOr$r/T)
rr:r'r;rr�scriptDataDoubleEscapeEndStaterrAr�rpr!r!r"r�0s

z6HTMLTokenizer.scriptDataDoubleEscapedLessThanSignStatecCs�|j��}|ttd�BkrR|j�td|d��|j��dkrH|j	|_
q�|j|_
nB|tkr�|j�td|d��|j|7_n|j�
|�|j|_
dSr�)rr:rr>r'r;rrr�r�rr�r
rArpr!r!r"r�;s


z,HTMLTokenizer.scriptDataDoubleEscapeEndStatecCs0|j��}|tkr$|j�td��n|tkrJ|jd�|dg�|j|_n�|dkr\|�	�n�|dkrn|j
|_n�|dkr�|j�tddd	��|jd�|dg�|j|_n�|d
kr�|j�tddd	��|jd�ddg�|j|_nF|t
k�r|j�tdd
d	��|j|_n|jd�|dg�|j|_dS)NTr&r/rtrs)�'�"rMrHr#�#invalid-character-in-attribute-namer$r_r`r2z#expected-attribute-name-but-got-eof)rr:rrdr
rr;�attributeNameStaterr^r}r'rrrrpr!r!r"r|Ks<



�
�

�
z&HTMLTokenizer.beforeAttributeNameStatecCs�|j��}d}d}|dkr&|j|_�n.|tkr\|jddd||j�td�7<d}n�|dkrjd}n�|tkr||j|_n�|dkr�|j	|_n�|d	kr�|j
�td
dd��|jdddd
7<d}n�|dk�r|j
�td
dd��|jddd|7<d}nH|t
k�r6|j
�td
dd��|j|_n|jddd|7<d}|�r�|jddd�t�|jddd<|jddd�D]>\}}|jddd|k�r�|j
�td
dd���qҐq�|�r�|��dS)NTFrMr&rJrrtrsr_r#r`r$r2�r�r�rHr�zeof-in-attribute-namezduplicate-attribute)rr:�beforeAttributeValueStaterr
rrdr�afterAttributeNameStater}r'r;rrrr\rr^)rr&ZleavingThisStateZ	emitTokenrY�_r!r!r"r�is^
�

�
�
�
��
z HTMLTokenizer.attributeNameStatecCsD|j��}|tkr$|j�td��n|dkr8|j|_�n|dkrJ|��n�|tkrp|jd�	|dg�|j
|_n�|dkr�|j|_n�|dkr�|j�	t
dd	d
��|jd�	ddg�|j
|_n�|dkr�|j�	t
dd
d
��|jd�	|dg�|j
|_nF|tk�r$|j�	t
ddd
��|j|_n|jd�	|dg�|j
|_dS)NTrMrtr&r/rsr_r#r`r$r2r�z&invalid-character-after-attribute-namezexpected-end-of-tag-but-got-eof)rr:rrdr�rr^r
rr;r�r}r'rrrrpr!r!r"r��s@



�
�

�
z%HTMLTokenizer.afterAttributeNameStatecCsh|j��}|tkr$|j�td��n@|dkr8|j|_�n,|dkrX|j|_|j�|��n|dkrj|j|_n�|dkr�|j	�
tddd��|��n�|d	kr�|j	�
tdd
d��|j
ddd
d7<|j|_n�|dk�r|j	�
tddd��|j
ddd
|7<|j|_nL|tk�rB|j	�
tddd��|j|_n"|j
ddd
|7<|j|_dS)NTr�rGr�rtr#z.expected-attribute-value-but-got-right-bracketr$r_r`r&rJrr2)rMrH�`z"equals-in-unquoted-attribute-valuez$expected-attribute-value-but-got-eof)rr:rrd�attributeValueDoubleQuotedStater�attributeValueUnQuotedStaterA�attributeValueSingleQuotedStater'r;rr^rrrrpr!r!r"r��sF

�
�

�

�
z'HTMLTokenizer.beforeAttributeValueStatecCs�|j��}|dkr|j|_n�|dkr0|�d�n�|dkrj|j�tddd��|jddd	d
7<nN|t	kr�|j�tddd��|j
|_n&|jddd	||j�d�7<d
S)Nr�rGr_r#r`r$r&rJrr2z#eof-in-attribute-value-double-quote)r�rGr_T�rr:�afterAttributeValueStaterrXr'r;rrrrrdrpr!r!r"r��s&

��

�z-HTMLTokenizer.attributeValueDoubleQuotedStatecCs�|j��}|dkr|j|_n�|dkr0|�d�n�|dkrj|j�tddd��|jddd	d
7<nN|t	kr�|j�tddd��|j
|_n&|jddd	||j�d�7<d
S)Nr�rGr_r#r`r$r&rJrr2z#eof-in-attribute-value-single-quote)r�rGr_Tr�rpr!r!r"r��s&

��

�z-HTMLTokenizer.attributeValueSingleQuotedStatecCs|j��}|tkr|j|_n�|dkr0|�d�n�|dkrB|��n�|dkr||j�t	ddd��|j
ddd	|7<n�|d
kr�|j�t	ddd��|j
ddd	d7<nV|tkr�|j�t	dd
d��|j|_n.|j
ddd	||j�
td�tB�7<dS)NrGrt)r�r�rMrHr�r#z0unexpected-character-in-unquoted-attribute-valuer$r&rJrr_r`r2z eof-in-attribute-value-no-quotes)rGrtr�r�rMrHr�r_T)rr:rr|rrXr^r'r;rrrrrdr>rpr!r!r"r�s4


���

�
z)HTMLTokenizer.attributeValueUnQuotedStatecCs�|j��}|tkr|j|_n�|dkr.|��np|dkr@|j|_n^|tkrt|j�	t
ddd��|j�|�|j|_n*|j�	t
ddd��|j�|�|j|_dS)Nrtrsr#z$unexpected-EOF-after-attribute-valuer$z*unexpected-character-after-attribute-valueT)
rr:rr|rr^r}rr'r;rrArrpr!r!r"r� s&



�
�z&HTMLTokenizer.afterAttributeValueStatecCs�|j��}|dkr&d|jd<|��n^|tkrZ|j�tddd��|j�|�|j	|_
n*|j�tddd��|j�|�|j|_
dS)NrtTr[r#z#unexpected-EOF-after-solidus-in-tagr$z)unexpected-character-after-solidus-in-tag)rr:rr^rr'r;rrArrr|rpr!r!r"r}4s 


�
�z&HTMLTokenizer.selfClosingStartTagStatecCsD|j�d�}|�dd�}|j�td|d��|j��|j|_dS)Nrtr_r2�Commentr$T)	rrd�replacer'r;rr:rrrpr!r!r"ryFs�
zHTMLTokenizer.bogusCommentStatecCs�|j��g}|ddkrR|�|j���|ddkrPtddd�|_|j|_dSn�|ddkr�d}dD](}|�|j���|d|krfd	}q�qf|r�td
ddddd�|_|j|_dSn�|ddk�rD|jdk	�rD|jj	j
�rD|jj	j
dj|jj	jk�rDd}d
D].}|�|j���|d|k�rd	}�q2�q|�rD|j
|_dS|j�tddd��|�rt|j�|����qZ|j|_dS)NrJr�r�r/r$T)�d�D))�o�O�rD�C��t�T��y�Y��p�P��e�EFZDoctype)r%rY�publicId�systemId�correct�[)r�r��Ar�r�r�r#zexpected-dashes-or-doctype)rr:r;rr�commentStartStater�doctypeStaterZtreeZopenElements�	namespaceZdefaultNamespace�cdataSectionStater'rAr)ry)rrC�matched�expectedr!r!r"rvUs\����
�z(HTMLTokenizer.markupDeclarationOpenStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��|j�|j�|j|_nP|t	kr�|j�tdd
d��|j�|j�|j|_n|jd|7<|j
|_dS)Nr�r_r#r`r$r&r2rt�incorrect-comment�eof-in-commentT)rr:�commentStartDashStaterr'r;rrrr�commentStaterpr!r!r"r��s.

��
�
zHTMLTokenizer.commentStartStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��|j�|j�|j|_nT|t	kr�|j�tdd
d��|j�|j�|j|_n|jdd|7<|j
|_dS)Nr�r_r#r`r$r&�-�rtr�r�T)rr:�commentEndStaterr'r;rrrrr�rpr!r!r"r��s.

��
�
z#HTMLTokenizer.commentStartDashStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<nT|tkr�|j�tddd��|j�|j�|j	|_n|jd||j�
d	�7<d
S)Nr�r_r#r`r$r&r2r�)r�r_T)rr:�commentEndDashStaterr'r;rrrrrdrpr!r!r"r��s$

��

�zHTMLTokenizer.commentStatecCs�|j��}|dkr|j|_n�|dkrV|j�tddd��|jdd7<|j|_nT|t	kr�|j�tddd��|j�|j�|j
|_n|jdd|7<|j|_d	S)
Nr�r_r#r`r$r&r�zeof-in-comment-end-dashT)rr:r�rr'r;rrr�rrrpr!r!r"r��s$

�
�
z!HTMLTokenizer.commentEndDashStatecCs,|j��}|dkr*|j�|j�|j|_n�|dkrd|j�tddd��|jdd7<|j|_n�|dkr�|j�tdd	d��|j	|_n�|d
kr�|j�tddd��|jd|7<nj|t
kr�|j�tddd��|j�|j�|j|_n4|j�tdd
d��|jdd|7<|j|_dS)Nrtr_r#r`r$r&u--�rrz,unexpected-bang-after-double-dash-in-commentr�z,unexpected-dash-after-double-dash-in-commentzeof-in-comment-double-dashzunexpected-char-in-commentz--T)rr:r'r;rrrrr��commentEndBangStaterrpr!r!r"r��s@

�
�
��
�zHTMLTokenizer.commentEndStatecCs�|j��}|dkr*|j�|j�|j|_n�|dkrN|jdd7<|j|_n�|dkr�|j�tddd��|jdd	7<|j	|_nT|t
kr�|j�tdd
d��|j�|j�|j|_n|jdd|7<|j	|_dS)Nrtr�r&z--!r_r#r`r$u--!�zeof-in-comment-end-bang-stateT)rr:r'r;rrrr�rr�rrpr!r!r"r��s,


�
�
z!HTMLTokenizer.commentEndBangStatecCs�|j��}|tkr|j|_nj|tkr\|j�tddd��d|j	d<|j�|j	�|j
|_n*|j�tddd��|j�|�|j|_dS)Nr#�!expected-doctype-name-but-got-eofr$Fr�zneed-space-after-doctypeT)rr:r�beforeDoctypeNameStaterrr'r;rrrrArpr!r!r"r�s 

�

�zHTMLTokenizer.doctypeStatecCs�|j��}|tkrn�|dkrT|j�tddd��d|jd<|j�|j�|j|_n�|dkr�|j�tddd��d	|jd
<|j	|_nR|t
kr�|j�tddd��d|jd<|j�|j�|j|_n||jd
<|j	|_dS)
Nrtr#z+expected-doctype-name-but-got-right-bracketr$Fr�r_r`r2rYr�T)rr:rr'r;rrrr�doctypeNameStaterrpr!r!r"r�s4
�

�

�


z$HTMLTokenizer.beforeDoctypeNameStatecCs|j��}|tkr2|jd�t�|jd<|j|_n�|dkrh|jd�t�|jd<|j�	|j�|j
|_n�|dkr�|j�	tddd��|jdd7<|j|_nh|t
kr�|j�	tddd��d	|jd
<|jd�t�|jd<|j�	|j�|j
|_n|jd|7<dS)NrYrtr_r#r`r$r2zeof-in-doctype-nameFr�T)rr:rrr\r�afterDoctypeNameStaterr'r;rrr�rrpr!r!r"r�6s0


�
�

zHTMLTokenizer.doctypeNameStatecCsH|j��}|tkr�n.|dkr8|j�|j�|j|_�n|tkr�d|jd<|j�	|�|j�t
ddd��|j�|j�|j|_n�|dkr�d}d	D]}|j��}||kr�d}q�q�|r�|j|_dSnD|d
k�r
d}dD]}|j��}||kr�d}q�q�|�r
|j|_dS|j�	|�|j�t
ddd
|id��d|jd<|j
|_dS)NrtFr�r#�eof-in-doctyper$r�T))�u�U)�b�B)�l�L)�i�Ir���s�S)r�r�r�r�)�m�Mz*expected-space-or-right-bracket-in-doctyper&r1)rr:rr'r;rrrrrAr�afterDoctypePublicKeywordState�afterDoctypeSystemKeywordState�bogusDoctypeState)rr&r�r�r!r!r"r�OsT

�



�
z#HTMLTokenizer.afterDoctypeNameStatecCs�|j��}|tkr|j|_n�|dkrP|j�tddd��|j�|�|j|_nT|t	kr�|j�tddd��d|j
d<|j�|j
�|j|_n|j�|�|j|_dS�	N)r�r�r#�unexpected-char-in-doctyper$r�Fr�T)rr:r�"beforeDoctypePublicIdentifierStaterr'r;rrArrrrpr!r!r"r��s&

�
�

z,HTMLTokenizer.afterDoctypePublicKeywordStatecCs�|j��}|tkrn�|dkr0d|jd<|j|_n�|dkrLd|jd<|j|_n�|dkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_nh|tkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_n(|j�t	ddd��d	|jd
<|j|_d
S)Nr�r/r�r�rtr#�unexpected-end-of-doctyper$Fr�r�r�T)
rr:rr�(doctypePublicIdentifierDoubleQuotedStater�(doctypePublicIdentifierSingleQuotedStater'r;rrrr�rpr!r!r"r��s:




�

�

�
z0HTMLTokenizer.beforeDoctypePublicIdentifierStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�T�
rr:�!afterDoctypePublicIdentifierStaterr'r;rrrrrpr!r!r"r��s0

��

�

z6HTMLTokenizer.doctypePublicIdentifierDoubleQuotedStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�Tr�rpr!r!r"r��s0

��

�

z6HTMLTokenizer.doctypePublicIdentifierSingleQuotedStatecCs|j��}|tkr|j|_n�|dkr<|j�|j�|j|_n�|dkrn|j�t	ddd��d|jd<|j
|_n�|dkr�|j�t	ddd��d|jd<|j|_nh|tkr�|j�t	dd	d��d
|jd<|j�|j�|j|_n(|j�t	ddd��d
|jd<|j
|_dS)
Nrtr�r#r�r$r/r�r�r�Fr�T)rr:r�-betweenDoctypePublicAndSystemIdentifiersStaterr'r;rrr�(doctypeSystemIdentifierDoubleQuotedState�(doctypeSystemIdentifierSingleQuotedStaterr�rpr!r!r"r��s>


�

�

�

�
z/HTMLTokenizer.afterDoctypePublicIdentifierStatecCs�|j��}|tkrn�|dkr4|j�|j�|j|_n�|dkrPd|jd<|j|_n�|dkrld|jd<|j	|_nh|t
kr�|j�tddd��d	|jd
<|j�|j�|j|_n(|j�tddd��d	|jd
<|j|_dS)
Nrtr�r/r�r�r#r�r$Fr�r�T)
rr:rr'r;rrrr�r�rrr�rpr!r!r"r�s2





�

�
z;HTMLTokenizer.betweenDoctypePublicAndSystemIdentifiersStatecCs�|j��}|tkr|j|_n�|dkrP|j�tddd��|j�|�|j|_nT|t	kr�|j�tddd��d|j
d<|j�|j
�|j|_n|j�|�|j|_dSr�)rr:r�"beforeDoctypeSystemIdentifierStaterr'r;rrArrrrpr!r!r"r�s&

�
�

z,HTMLTokenizer.afterDoctypeSystemKeywordStatecCs�|j��}|tkrn�|dkr0d|jd<|j|_n�|dkrLd|jd<|j|_n�|dkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_nh|tkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_n(|j�t	ddd��d	|jd
<|j|_dS)
Nr�r/r�r�rtr#r�r$Fr�r�T)
rr:rrr�rr�r'r;rrrr�rpr!r!r"r�/s:




�

�

�
z0HTMLTokenizer.beforeDoctypeSystemIdentifierStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�T�
rr:�!afterDoctypeSystemIdentifierStaterr'r;rrrrrpr!r!r"r�Ls0

��

�

z6HTMLTokenizer.doctypeSystemIdentifierDoubleQuotedStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�Tr�rpr!r!r"r�ds0

��

�

z6HTMLTokenizer.doctypeSystemIdentifierSingleQuotedStatecCs�|j��}|tkrn~|dkr4|j�|j�|j|_n^|tkrt|j�t	ddd��d|jd<|j�|j�|j|_n|j�t	ddd��|j
|_dS)	Nrtr#r�r$Fr�r�T)rr:rr'r;rrrrrr�rpr!r!r"r�|s$

�

�z/HTMLTokenizer.afterDoctypeSystemIdentifierStatecCsZ|j��}|dkr*|j�|j�|j|_n,|tkrV|j�|�|j�|j�|j|_ndS)NrtT)	rr:r'r;rrrrrArpr!r!r"r��s


zHTMLTokenizer.bogusDoctypeStatecCs�g}|�|j�d��|�|j�d��|j��}|tkr>qvq|ddd�dkrj|ddd�|d<qvq|�|�qd�|�}|�d�}|dkr�t|�D]}|j�t	d	d
d��q�|�
dd�}|r�|j�t	d
|d��|j|_dS)N�]rtrJ���z]]r/r_rr#r`r$r2rOT)
r;rrdr:rr=�count�ranger'rr�rr)rr&r:Z	nullCountr�r!r!r"r��s0


�
�zHTMLTokenizer.cdataSectionState)N)NF)N�__name__�
__module__�__qualname__�__doc__rr,rFrWrXr^rrbrjrhrmrorqrcrwrxrir�r�rlr�r�rnr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r}ryrvr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r��
__classcell__r!r!rr"rs�H
P#

6 "-3rN)Z
__future__rrrZpip._vendor.sixrr?�collectionsrZ	constantsrr	r
rrr
rrrrZ_inputstreamrZ_trierrP�objectrr!r!r!r"�<module>ssite-packages/pip/_vendor/html5lib/__pycache__/html5parser.cpython-38.opt-1.pyc000064400000270232151446177000023310 0ustar00U

��.e���@sddlmZmZmZddlmZmZddlZddlm	Z	ddl
mZddl
mZddl
m
Z
dd	lmZdd
l
mZddlmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"d!dd�Z#d"dd�Z$dd�Z%Gdd�de&�Z'ej(dd��Z)dd�Z*d#dd�Z+Gdd �d e,�Z-dS)$�)�absolute_import�division�unicode_literals)�with_metaclass�viewkeysN)�OrderedDict�)�_inputstream)�
_tokenizer)�treebuilders)�Marker)�_utils)�spaceCharacters�asciiUpper2Lower�specialElements�headingElements�
cdataElements�rcdataElements�
tokenTypes�
tagTokenTypes�
namespaces�htmlIntegrationPointElements�"mathmlTextIntegrationPointElements�adjustForeignAttributes�adjustMathMLAttributes�adjustSVGAttributes�E�_ReparseException�etreeTcKs$t�|�}t||d�}|j|f|�S)a�Parse an HTML document as a string or file-like object into a tree

    :arg doc: the document to parse as a string or file-like object

    :arg treebuilder: the treebuilder to use when parsing

    :arg namespaceHTMLElements: whether or not to namespace HTML elements

    :returns: parsed tree

    Example:

    >>> from html5lib.html5parser import parse
    >>> parse('<html><body><p>This is a doc</p></body></html>')
    <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>

    ��namespaceHTMLElements)r�getTreeBuilder�
HTMLParser�parse)�doc�treebuilderr �kwargs�tb�p�r)�D/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/html5parser.pyr#s
r#�divcKs,t�|�}t||d�}|j|fd|i|��S)a#Parse an HTML fragment as a string or file-like object into a tree

    :arg doc: the fragment to parse as a string or file-like object

    :arg container: the container context to parse the fragment in

    :arg treebuilder: the treebuilder to use when parsing

    :arg namespaceHTMLElements: whether or not to namespace HTML elements

    :returns: parsed tree

    Example:

    >>> from html5lib.html5libparser import parseFragment
    >>> parseFragment('<b>this is a fragment</b>')
    <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>

    r�	container)rr!r"�
parseFragment)r$r,r%r r&r'r(r)r)r*r-2s
r-csG�fdd�dt�}|S)NcseZdZ�fdd�ZdS)z-method_decorator_metaclass.<locals>.Decoratedcs>|��D]$\}}t|tj�r$�|�}|||<qt�||||�S�N)�items�
isinstance�types�FunctionType�type�__new__)�metaZ	classname�basesZ	classDictZ
attributeNameZ	attribute��functionr)r*r4Ms

z5method_decorator_metaclass.<locals>.Decorated.__new__N)�__name__�
__module__�__qualname__r4r)r7r)r*�	DecoratedLsr<)r3)r8r<r)r7r*�method_decorator_metaclassKsr=c@s�eZdZdZd+dd�Zd,dd	�Zd
d�Zedd
��Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zd-dd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�ZdS).r"z]HTML parser

    Generates a tree structure from a stream of (possibly malformed) HTML.

    NFTcsL|�_|dkrt�d�}||��_g�_t�fdd�t|���D���_dS)a�
        :arg tree: a treebuilder class controlling the type of tree that will be
            returned. Built in treebuilders can be accessed through
            html5lib.treebuilders.getTreeBuilder(treeType)

        :arg strict: raise an exception when a parse error is encountered

        :arg namespaceHTMLElements: whether or not to namespace HTML elements

        :arg debug: whether or not to enable debug mode which logs things

        Example:

        >>> from html5lib.html5parser import HTMLParser
        >>> parser = HTMLParser()                     # generates parser with etree builder
        >>> parser = HTMLParser('lxml', strict=True)  # generates parser with lxml builder which is strict

        Nrcs g|]\}}||��j�f�qSr))�tree)�.0�name�cls��selfr)r*�
<listcomp>zsz'HTMLParser.__init__.<locals>.<listcomp>)	�strictrr!r>�errors�dict�	getPhasesr/�phases)rCr>rEr �debugr)rBr*�__init__^s


�zHTMLParser.__init__r+cKsh||_||_||_tj|fd|i|��|_|��z|��Wn$tk
rb|��|��YnXdS)N�parser)	�
innerHTMLModer,�	scriptingr
Z
HTMLTokenizer�	tokenizer�reset�mainLoopr)rC�stream�	innerHTMLr,rNr&r)r)r*�_parse}szHTMLParser._parsecCs�|j��d|_g|_g|_d|_|jr�|j��|_	|j	t
krL|jj|j_
n0|j	tkrd|jj|j_
n|j	dkr||jj|j_
n|jd|_|j��|��nd|_	|jd|_d|_d|_d|_dS)NFz	no quirks�	plaintext�
beforeHtml�initialT)r>rP�
firstStartTagrF�log�
compatModerMr,�lowerrSrrO�rcdataState�stater�rawtextState�plaintextStaterI�phase�insertHtmlElement�resetInsertionModeZ	lastPhaseZbeforeRCDataPhase�
framesetOKrBr)r)r*rP�s*





zHTMLParser.resetcCst|d�sdS|jjjdjS)z�Name of the character encoding that was used to decode the input stream, or
        :obj:`None` if that is not determined yet

        rONr)�hasattrrOrR�charEncodingr@rBr)r)r*�documentEncoding�s
zHTMLParser.documentEncodingcCsJ|jdkr6|jtdkr6d|jko4|jd�t�dkS|j|jftkSdS)N�annotation-xml�mathml�encoding)z	text/htmlzapplication/xhtml+xml)r@�	namespacer�
attributes�	translaterr�rC�elementr)r)r*�isHTMLIntegrationPoint�s
�

���z!HTMLParser.isHTMLIntegrationPointcCs|j|jftkSr.)rjr@rrmr)r)r*�isMathMLTextIntegrationPoint�sz'HTMLParser.isMathMLTextIntegrationPointcCsXtd}td}td}td}td}td}td}|��D�]�}d}	|}
|
dk	�r�|
}	|jjrp|jjdnd}|r~|jnd}|r�|jnd}
|
d	}||kr�|�|
d
|
�di��d}
qNt|jj�dk�sd||jj	k�sd|�
|��r||k�r
|d
tddg�k�sd|||fk�sd|tdk�rH|
dk�rH||k�rH|d
dk�sd|�
|��rl||||fk�rl|j}n
|jd}||k�r�|�|
�}
qN||k�r�|�|
�}
qN||k�r�|�|
�}
qN||k�r�|�|
�}
qN||k�r�|�|
�}
qN||krN|�|
�}
qN||kr@|	dr@|	ds@|�dd
|	d
i�q@d}g}|�rT|�|j�|j��}|�r.�q.dS)N�
CharactersZSpaceCharacters�StartTag�EndTag�CommentZDoctype�
ParseError���r3�data�datavarsrr@ZmglyphZ
malignmarkrhrg�svg�inForeignContent�selfClosing�selfClosingAcknowledgedz&non-void-element-with-trailing-solidusT)r�normalizedTokensr>�openElementsrjr@�
parseError�get�len�defaultNamespacerp�	frozensetrror`rI�processCharacters�processSpaceCharacters�processStartTag�
processEndTag�processComment�processDoctype�append�
processEOF)rCZCharactersTokenZSpaceCharactersTokenZ
StartTagTokenZEndTagTokenZCommentTokenZDoctypeTokenZParseErrorToken�tokenZ
prev_token�	new_token�currentNodeZcurrentNodeNamespaceZcurrentNodeNamer3r`Z	reprocessrIr)r)r*rQ�s�

����
�
���	
�
��





�
�
zHTMLParser.mainLoopccs|jD]}|�|�VqdSr.)rO�normalizeToken�rCr�r)r)r*r}s
zHTMLParser.normalizedTokenscOs |j|ddf|�|�|j��S)a�Parse a HTML document into a well-formed tree

        :arg stream: a file-like object or string containing the HTML to be parsed

            The optional encoding parameter must be a string that indicates
            the encoding.  If specified, that encoding will be used,
            regardless of any BOM or later declaration (such as in a meta
            element).

        :arg scripting: treat noscript elements as if JavaScript was turned on

        :returns: parsed tree

        Example:

        >>> from html5lib.html5parser import HTMLParser
        >>> parser = HTMLParser()
        >>> parser.parse('<html><body><p>This is a doc</p></body></html>')
        <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>

        FN)rTr>ZgetDocument�rCrR�argsr&r)r)r*r#szHTMLParser.parsecOs|j|df|�|�|j��S)aZParse a HTML fragment into a well-formed tree fragment

        :arg container: name of the element we're setting the innerHTML
            property if set to None, default to 'div'

        :arg stream: a file-like object or string containing the HTML to be parsed

            The optional encoding parameter must be a string that indicates
            the encoding.  If specified, that encoding will be used,
            regardless of any BOM or later declaration (such as in a meta
            element)

        :arg scripting: treat noscript elements as if JavaScript was turned on

        :returns: parsed tree

        Example:

        >>> from html5lib.html5libparser import HTMLParser
        >>> parser = HTMLParser()
        >>> parser.parseFragment('<b>this is a fragment</b>')
        <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>

        T)rTr>ZgetFragmentr�r)r)r*r-$szHTMLParser.parseFragment�XXX-undefined-errorcCs@|dkri}|j�|jj��||f�|jr<tt||��dSr.)rFr�rOrRZpositionrErur)rCZ	errorcoderxr)r)r*r@s
zHTMLParser.parseErrorcCsT|dtdkrP|d}t|�|d<t|�t|d�krP|d�|ddd��|S)Nr3rrrwrv)rrr��update)rCr��rawr)r)r*r�HszHTMLParser.normalizeTokencCst|t�dSr.)�adjust_attributesrr�r)r)r*rSsz!HTMLParser.adjustMathMLAttributescCst|t�dSr.)r�rr�r)r)r*rVszHTMLParser.adjustSVGAttributescCst|t�dSr.)r��adjustForeignAttributesMapr�r)r)r*rYsz"HTMLParser.adjustForeignAttributescCs|j��dSr.)rLr`r�r)r)r*�reparseTokenNormal\szHTMLParser.reparseTokenNormalcCs�d}ddddddddddd	d	d
dd�}|jjddd
�D]r}|j}d}||jjdkr`d}|j}|dkrh|s||j|jjkr|q8||kr�|j||}q�q8|r8|jd	}q�q8||_dS)NF�inSelect�inCell�inRow�inTableBody�	inCaption�
inColumnGroup�inTable�inBody�
inFrameset�
beforeHead)�select�td�th�tr�tbody�thead�tfoot�caption�colgroup�table�head�body�frameset�htmlrvrT)r�r�r�r�)r>r~r@rSrjr�rIr`)rCZlastZnewModes�nodeZnodeNameZ	new_phaser)r)r*rb`s@�
zHTMLParser.resetInsertionModecCsF|j�|�|dkr"|jj|j_n|jj|j_|j|_|jd|_dS)N�RAWTEXT�text)	r>�
insertElementrOr^r]r\r`�
originalPhaserI)rCr�ZcontentTyper)r)r*�parseRCDataRawtext�szHTMLParser.parseRCDataRawtext)NFTF)Fr+F)r�N)r9r:r;�__doc__rKrTrP�propertyrfrorprQr}r#r-rr�rrrr�rbr�r)r)r)r*r"Ws(

"
	
C
,r"cs"dd�}dd�}Gdd�dt|||����Gdd�d��}Gd	d
�d
��}G�fdd�d��}G�fd
d�d��}G�fdd�d��}G�fdd�d��}G�fdd�d��}	G�fdd�d��}
G�fdd�d��}G�fdd�d��}G�fdd�d��}
G�fdd�d��}G�fdd �d ��}G�fd!d"�d"��}G�fd#d$�d$��}G�fd%d&�d&��}G�fd'd(�d(��}G�fd)d*�d*��}G�fd+d,�d,��}G�fd-d.�d.��}G�fd/d0�d0��}G�fd1d2�d2��}G�fd3d4�d4��}|||||||	|
|||
||||||||||||d5�S)6Ncs(tdd�t��D�����fdd�}|S)z4Logger that records which phase processes each tokencss|]\}}||fVqdSr.r))r?�key�valuer)r)r*�	<genexpr>�sz)getPhases.<locals>.log.<locals>.<genexpr>cs��j�d�r�t|�dkr�|d}zd�|di}Wn�YnX|dtkr\|d|d<|jj�|jjjj|jj	j
j|j
j�j|f��|f|�|�S�|f|�|�SdS)NZprocessrr3r@)r9�
startswithr�rrLrYr�rOr]r`�	__class__)rCr�r&r��info�r8Z
type_namesr)r*�wrapped�s 
�z'getPhases.<locals>.log.<locals>.wrapped)rGrr/)r8r�r)r�r*rY�s
�zgetPhases.<locals>.logcSs|rt|�StSdSr.)r=r3)Z
use_metaclassZmetaclass_funcr)r)r*�getMetaclass�szgetPhases.<locals>.getMetaclassc@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)zgetPhases.<locals>.PhasezNBase class for helper object that implements each phase of processing
        cSs||_||_dSr.)rLr>�rCrLr>r)r)r*rK�sz!getPhases.<locals>.Phase.__init__cSst�dSr.)�NotImplementedErrorrBr)r)r*r��sz#getPhases.<locals>.Phase.processEOFcSs|j�||jjd�dS)Nrv�r>�
insertCommentr~r�r)r)r*r��sz'getPhases.<locals>.Phase.processCommentcSs|j�d�dS)Nzunexpected-doctype�rLrr�r)r)r*r��sz'getPhases.<locals>.Phase.processDoctypecSs|j�|d�dS�Nrw�r>�
insertTextr�r)r)r*r��sz*getPhases.<locals>.Phase.processCharacterscSs|j�|d�dSr�r�r�r)r)r*r��sz/getPhases.<locals>.Phase.processSpaceCharacterscSs|j|d|�S�Nr@)�startTagHandlerr�r)r)r*r��sz(getPhases.<locals>.Phase.processStartTagcSsf|jjs |ddkr |j�d�|d��D],\}}||jjdjkr,||jjdj|<q,d|j_dS)Nr@r�z
non-html-rootrwrF)rLrXrr/r>r~rk�rCr��attrr�r)r)r*�startTagHtml�sz%getPhases.<locals>.Phase.startTagHtmlcSs|j|d|�Sr�)�
endTagHandlerr�r)r)r*r��sz&getPhases.<locals>.Phase.processEndTagN)
r9r:r;r�rKr�r�r�r�r�r�r�r�r)r)r)r*�Phase�s
r�c@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)zgetPhases.<locals>.InitialPhasecSsdSr.r)r�r)r)r*r��sz6getPhases.<locals>.InitialPhase.processSpaceCharacterscSs|j�||jj�dSr.�r>r�Zdocumentr�r)r)r*r��sz.getPhases.<locals>.InitialPhase.processCommentcSs�|d}|d}|d}|d}|dks@|dk	s@|dk	rL|dkrL|j�d�|dkrXd}|j�|�|dkrv|�t�}|r�|ddks�|�d	�s�|d
ks�|�d�r�|dks�|r�|��dkr�d
|j_n$|�d�s�|�d�r�|dk	r�d|j_|jj	d|j_
dS)Nr@�publicId�systemId�correctr�zabout:legacy-compatzunknown-doctype�)7z*+//silmaril//dtd html pro v0r11 19970101//z4-//advasoft ltd//dtd html 3.0 aswedit + extensions//z*-//as//dtd html 3.0 aswedit + extensions//z-//ietf//dtd html 2.0 level 1//z-//ietf//dtd html 2.0 level 2//z&-//ietf//dtd html 2.0 strict level 1//z&-//ietf//dtd html 2.0 strict level 2//z-//ietf//dtd html 2.0 strict//z-//ietf//dtd html 2.0//z-//ietf//dtd html 2.1e//z-//ietf//dtd html 3.0//z-//ietf//dtd html 3.2 final//z-//ietf//dtd html 3.2//z-//ietf//dtd html 3//z-//ietf//dtd html level 0//z-//ietf//dtd html level 1//z-//ietf//dtd html level 2//z-//ietf//dtd html level 3//z"-//ietf//dtd html strict level 0//z"-//ietf//dtd html strict level 1//z"-//ietf//dtd html strict level 2//z"-//ietf//dtd html strict level 3//z-//ietf//dtd html strict//z-//ietf//dtd html//z(-//metrius//dtd metrius presentational//z5-//microsoft//dtd internet explorer 2.0 html strict//z.-//microsoft//dtd internet explorer 2.0 html//z0-//microsoft//dtd internet explorer 2.0 tables//z5-//microsoft//dtd internet explorer 3.0 html strict//z.-//microsoft//dtd internet explorer 3.0 html//z0-//microsoft//dtd internet explorer 3.0 tables//z#-//netscape comm. corp.//dtd html//z*-//netscape comm. corp.//dtd strict html//z*-//o'reilly and associates//dtd html 2.0//z3-//o'reilly and associates//dtd html extended 1.0//z;-//o'reilly and associates//dtd html extended relaxed 1.0//zN-//softquad software//dtd hotmetal pro 6.0::19990601::extensions to html 4.0//zE-//softquad//dtd hotmetal pro 4.0::19971010::extensions to html 4.0//z$-//spyglass//dtd html 2.0 extended//z+-//sq//dtd html 2.0 hotmetal + extensions//z--//sun microsystems corp.//dtd hotjava html//z4-//sun microsystems corp.//dtd hotjava strict html//z-//w3c//dtd html 3 1995-03-24//z-//w3c//dtd html 3.2 draft//z-//w3c//dtd html 3.2 final//z-//w3c//dtd html 3.2//z-//w3c//dtd html 3.2s draft//z-//w3c//dtd html 4.0 frameset//z#-//w3c//dtd html 4.0 transitional//z(-//w3c//dtd html experimental 19960712//z&-//w3c//dtd html experimental 970421//z-//w3c//dtd w3 html//z-//w3o//dtd w3 html 3.0//z#-//webtechs//dtd mozilla html 2.0//z-//webtechs//dtd mozilla html//)z$-//w3o//dtd w3 html strict 3.0//en//z"-/w3c/dtd html 4.0 transitional/enr�)z -//w3c//dtd html 4.01 frameset//z$-//w3c//dtd html 4.01 transitional//z:http://www.ibm.com/data/dtd/v11/ibmxhtml1-transitional.dtd�quirks)z -//w3c//dtd xhtml 1.0 frameset//z$-//w3c//dtd xhtml 1.0 transitional//zlimited quirksrV)rLrr>Z
insertDoctyperlrr�r[rZrIr`)rCr�r@r�r�r�r)r)r*r��sX��
��9�<��?�@�@
�A
����z.getPhases.<locals>.InitialPhase.processDoctypecSsd|j_|jjd|j_dS)Nr�rV)rLrZrIr`rBr)r)r*�anythingElseMsz,getPhases.<locals>.InitialPhase.anythingElsecSs|j�d�|��|S)Nzexpected-doctype-but-got-chars�rLrr�r�r)r)r*r�Qsz1getPhases.<locals>.InitialPhase.processCharacterscSs"|j�dd|di�|��|S)Nz"expected-doctype-but-got-start-tagr@r�r�r)r)r*r�Vs

�z/getPhases.<locals>.InitialPhase.processStartTagcSs"|j�dd|di�|��|S)Nz expected-doctype-but-got-end-tagr@r�r�r)r)r*r�\s

�z-getPhases.<locals>.InitialPhase.processEndTagcSs|j�d�|��dS)Nzexpected-doctype-but-got-eofTr�rBr)r)r*r�bsz*getPhases.<locals>.InitialPhase.processEOFN)r9r:r;r�r�r�r�r�r�r�r�r)r)r)r*�InitialPhase�s_r�c@sDeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dS)z"getPhases.<locals>.BeforeHtmlPhasecSs&|j�tdd��|jjd|j_dS)Nr�rrr�)r>Z
insertRoot�impliedTagTokenrLrIr`rBr)r)r*raisz4getPhases.<locals>.BeforeHtmlPhase.insertHtmlElementcSs|��dS�NT�rarBr)r)r*r�nsz-getPhases.<locals>.BeforeHtmlPhase.processEOFcSs|j�||jj�dSr.r�r�r)r)r*r�rsz1getPhases.<locals>.BeforeHtmlPhase.processCommentcSsdSr.r)r�r)r)r*r�usz9getPhases.<locals>.BeforeHtmlPhase.processSpaceCharacterscSs|��|Sr.r�r�r)r)r*r�xsz4getPhases.<locals>.BeforeHtmlPhase.processCharacterscSs |ddkrd|j_|��|S)Nr@r�T)rLrXrar�r)r)r*r�|sz2getPhases.<locals>.BeforeHtmlPhase.processStartTagcSs4|ddkr$|j�dd|di�n|��|SdS)Nr@�r�r�r��brzunexpected-end-tag-before-html)rLrrar�r)r)r*r��s
�z0getPhases.<locals>.BeforeHtmlPhase.processEndTagN)
r9r:r;rar�r�r�r�r�r�r)r)r)r*�BeforeHtmlPhasegsr�csXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z"getPhases.<locals>.BeforeHeadPhasecsV��|||�t�d|jfd|jfg�|_|j|j_t�d|jfg�|_	|j
|j	_dS)Nr�r�r�)rKr
�MethodDispatcherr��startTagHeadr��
startTagOther�default�endTagImplyHeadr��endTagOtherr��r�r)r*rK�s�
�z+getPhases.<locals>.BeforeHeadPhase.__init__cSs|�tdd��dS)Nr�rrT�r�r�rBr)r)r*r��sz-getPhases.<locals>.BeforeHeadPhase.processEOFcSsdSr.r)r�r)r)r*r��sz9getPhases.<locals>.BeforeHeadPhase.processSpaceCharacterscSs|�tdd��|S�Nr�rrr�r�r)r)r*r��sz4getPhases.<locals>.BeforeHeadPhase.processCharacterscSs|jjd�|�S�Nr��rLrIr�r�r)r)r*r��sz/getPhases.<locals>.BeforeHeadPhase.startTagHtmlcSs0|j�|�|jjd|j_|jjd|j_dS)Nrv�inHead)r>r�r~�headPointerrLrIr`r�r)r)r*r��sz/getPhases.<locals>.BeforeHeadPhase.startTagHeadcSs|�tdd��|Sr�r�r�r)r)r*r��sz0getPhases.<locals>.BeforeHeadPhase.startTagOthercSs|�tdd��|Sr�r�r�r)r)r*r��sz2getPhases.<locals>.BeforeHeadPhase.endTagImplyHeadcSs|j�dd|di�dS)Nzend-tag-after-implied-rootr@r�r�r)r)r*r��s
�z.getPhases.<locals>.BeforeHeadPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r)r�r)r*�BeforeHeadPhase�sr�cs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Zd!S)"zgetPhases.<locals>.InHeadPhasecs���|||�t�d|jfd|jfd|jfd|jfd|jfd|jfd|j	fd|j
fg�|_|j|j_
t�d|jfd	|jfg�|_|j|j_
dS)
Nr��title)�noframes�style�noscript�script)�base�basefont�bgsound�command�linkr5r�)r�r�r�)rKr
r�r��
startTagTitle�startTagNoFramesStyle�startTagNoscript�startTagScript�startTagBaseLinkCommand�startTagMetar�r�r�r��
endTagHead�endTagHtmlBodyBrr�r�r�r�r)r*rK�s&��
�z'getPhases.<locals>.InHeadPhase.__init__cSs|��dSr��r�rBr)r)r*r��sz)getPhases.<locals>.InHeadPhase.processEOFcSs|��|Sr.rr�r)r)r*r��sz0getPhases.<locals>.InHeadPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��sz+getPhases.<locals>.InHeadPhase.startTagHtmlcSs|j�d�dS)Nz!two-heads-are-not-better-than-oner�r�r)r)r*r��sz+getPhases.<locals>.InHeadPhase.startTagHeadcSs$|j�|�|jj��d|d<dS�NTr|�r>r�r~�popr�r)r)r*r��sz6getPhases.<locals>.InHeadPhase.startTagBaseLinkCommandcSs�|j�|�|jj��d|d<|d}|jjjjddkr�d|krZ|jjj�|d�nVd|kr�d|kr�|d�	�d	kr�t
�|d�d
��}t
�
|�}|��}|jjj�|�dS)NTr|rwrZ	tentative�charsetZcontentz
http-equivzcontent-typezutf-8)r>r�r~rrLrOrRreZchangeEncodingr[r	Z
EncodingBytes�encodeZContentAttrParserr#)rCr�rkrwrL�codecr)r)r*r��s ��
z+getPhases.<locals>.InHeadPhase.startTagMetacSs|j�|d�dS)NZRCDATA�rLr�r�r)r)r*r��sz,getPhases.<locals>.InHeadPhase.startTagTitlecSs|j�|d�dS)Nr�rr�r)r)r*r��sz4getPhases.<locals>.InHeadPhase.startTagNoFramesStylecSs8|jjr|j�|d�n|j�|�|jjd|j_dS)Nr��inHeadNoscript)rLrNr�r>r�rIr`r�r)r)r*r��sz/getPhases.<locals>.InHeadPhase.startTagNoscriptcSs<|j�|�|jjj|jj_|jj|j_|jjd|j_dS)Nr�)	r>r�rLrOZscriptDataStater]r`r�rIr�r)r)r*r�sz-getPhases.<locals>.InHeadPhase.startTagScriptcSs|��|Sr.rr�r)r)r*r�sz,getPhases.<locals>.InHeadPhase.startTagOthercSs"|jjj��}|jjd|j_dS)N�	afterHead�rLr>r~rrIr`�rCr�r�r)r)r*r�sz)getPhases.<locals>.InHeadPhase.endTagHeadcSs|��|Sr.rr�r)r)r*r�sz/getPhases.<locals>.InHeadPhase.endTagHtmlBodyBrcSs|j�dd|di�dS�N�unexpected-end-tagr@r�r�r)r)r*r�sz*getPhases.<locals>.InHeadPhase.endTagOthercSs|�td��dS)Nr�)r�r�rBr)r)r*r�sz+getPhases.<locals>.InHeadPhase.anythingElseN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r)r�r)r*�InHeadPhase�s rcsxeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS)z&getPhases.<locals>.InHeadNoscriptPhasecsf��|||�t�d|jfd|jfd|jfg�|_|j|j_t�d|j	fd|j
fg�|_|j|j_dS)Nr�)r�r�r�r5r�r�)r�r�r�r�)
rKr
r�r�r��startTagHeadNoscriptr�r�r��endTagNoscript�endTagBrr�r�r�r�r)r*rK s�
�z/getPhases.<locals>.InHeadNoscriptPhase.__init__cSs|j�d�|��dS)Nzeof-in-head-noscriptTr�rBr)r)r*r�0sz1getPhases.<locals>.InHeadNoscriptPhase.processEOFcSs|jjd�|�S�Nr�)rLrIr�r�r)r)r*r�5sz5getPhases.<locals>.InHeadNoscriptPhase.processCommentcSs|j�d�|��|S)Nzchar-in-head-noscriptr�r�r)r)r*r�8sz8getPhases.<locals>.InHeadNoscriptPhase.processCharacterscSs|jjd�|�Sr�rLrIr�r�r)r)r*r�=sz=getPhases.<locals>.InHeadNoscriptPhase.processSpaceCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�@sz3getPhases.<locals>.InHeadNoscriptPhase.startTagHtmlcSs|jjd�|�Srr�r�r)r)r*r�Csz>getPhases.<locals>.InHeadNoscriptPhase.startTagBaseLinkCommandcSs|j�dd|di�dS�N�unexpected-start-tagr@r�r�r)r)r*rFsz;getPhases.<locals>.InHeadNoscriptPhase.startTagHeadNoscriptcSs"|j�dd|di�|��|S�Nzunexpected-inhead-noscript-tagr@r�r�r)r)r*r�Isz4getPhases.<locals>.InHeadNoscriptPhase.startTagOthercSs"|jjj��}|jjd|j_dSrr
rr)r)r*rNsz5getPhases.<locals>.InHeadNoscriptPhase.endTagNoscriptcSs"|j�dd|di�|��|Srr�r�r)r)r*rSsz/getPhases.<locals>.InHeadNoscriptPhase.endTagBrcSs|j�dd|di�dSrr�r�r)r)r*r�Xsz2getPhases.<locals>.InHeadNoscriptPhase.endTagOthercSs|�td��dS)Nr�)rr�rBr)r)r*r�[sz3getPhases.<locals>.InHeadNoscriptPhase.anythingElseN)r9r:r;rKr�r�r�r�r�r�rr�rrr�r�r)r�r)r*�InHeadNoscriptPhasesrcspeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�ZdS)z!getPhases.<locals>.AfterHeadPhasecsn��|||�t�d|jfd|jfd|jfd|jfd|jfg�|_|j	|j_
t�d|jfg�|_|j
|j_
dS)Nr�r�r�)	r�r�r�r�r5r�r�r�r�r�)r�r�r�)rKr
r�r��startTagBody�startTagFrameset�startTagFromHeadr�r�r�r�r�r�r�r�r�r)r*rK`s��	
�
z*getPhases.<locals>.AfterHeadPhase.__init__cSs|��dSr�rrBr)r)r*r�qsz,getPhases.<locals>.AfterHeadPhase.processEOFcSs|��|Sr.rr�r)r)r*r�usz3getPhases.<locals>.AfterHeadPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�ysz.getPhases.<locals>.AfterHeadPhase.startTagHtmlcSs(d|j_|j�|�|jjd|j_dS)NFr�)rLrcr>r�rIr`r�r)r)r*r|sz.getPhases.<locals>.AfterHeadPhase.startTagBodycSs |j�|�|jjd|j_dS)Nr�)r>r�rLrIr`r�r)r)r*r�sz2getPhases.<locals>.AfterHeadPhase.startTagFramesetcSsr|j�dd|di�|jj�|jj�|jjd�|�|jjddd�D] }|jdkrL|jj�	|�qnqLdS)Nz#unexpected-start-tag-out-of-my-headr@r�rvr�)
rLrr>r~r�r�rIr�r@�removerr)r)r*r�s
�
z2getPhases.<locals>.AfterHeadPhase.startTagFromHeadcSs|j�dd|di�dSrr�r�r)r)r*r��sz.getPhases.<locals>.AfterHeadPhase.startTagHeadcSs|��|Sr.rr�r)r)r*r��sz/getPhases.<locals>.AfterHeadPhase.startTagOthercSs|��|Sr.rr�r)r)r*r��sz2getPhases.<locals>.AfterHeadPhase.endTagHtmlBodyBrcSs|j�dd|di�dSrr�r�r)r)r*r��sz-getPhases.<locals>.AfterHeadPhase.endTagOthercSs.|j�tdd��|jjd|j_d|j_dS)Nr�rrr�T)r>r�r�rLrIr`rcrBr)r)r*r��sz.getPhases.<locals>.AfterHeadPhase.anythingElseN)r9r:r;rKr�r�r�rrrr�r�r�r�r�r)r�r)r*�AfterHeadPhase_s
rcs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�Zd7d8�Zd9d:�Zd;d<�Z d=d>�Z!d?d@�Z"dAdB�Z#dCdD�Z$dEdF�Z%dGdH�Z&dIdJ�Z'dKdL�Z(dMdN�Z)dOdP�Z*dQdR�Z+dSdT�Z,dUdV�Z-dWdX�Z.dYdZ�Z/d[d\�Z0d]d^�Z1d_d`�Z2dadb�Z3dcdd�Z4dedf�Z5dgS)hzgetPhases.<locals>.InBodyPhasec$s���|||�|j|_t�d|jfd|jfd|jfd|jfd|j	ft
|jfd|jfd|j
fd|jfd	|jfd
|jfd|jfd|jfd
|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|j fd|j!fd|j"fd|j#fd|j$fd|j%fd |j&fg!�|_'|j(|j'_)t�d|j*fd|j+fd!|j,fd|j-fd"|j.fd#|j/ft
|j0fd$|j1fd|j2fd%|j3fg
�|_4|j5|j4_)dS)&Nr�)	r�r�r�r�r�r5r�r�r�r�r�)�address�article�aside�
blockquote�center�details�dirr+�dl�fieldset�
figcaption�figure�footer�header�hgroup�main�menu�nav�olr(�section�summary�ul)�pre�listing�form)�li�dd�dtrU�a)�b�big�code�em�font�i�s�small�strike�strong�tt�u�nobr�button)ZappletZmarquee�objectZxmpr�)Zarear��embed�img�keygenZwbr)Zparam�sourceZtrack�input�hr�image�isindex�textareaZiframer�)Znoembedr�r�)�rp�rt)�option�optgroupZmathry)r��colr��framer�r�r�r�r�r�r�)rrrr rFr!r"Zdialogr#r+r$r%r&r'r(r)r*r3r+r,r-r.r2r/r0r1r()r6r7r5)r8r9r:r;r<r=r>rEr?r@rArBrCrDr�)6rK�processSpaceCharactersNonPrer�r
r�r��startTagProcessInHeadrr�startTagClosePr�startTagHeading�startTagPreListing�startTagForm�startTagListItem�startTagPlaintext�	startTagA�startTagFormatting�startTagNobr�startTagButton�startTagAppletMarqueeObject�startTagXmp�
startTagTable�startTagVoidFormatting�startTagParamSource�
startTagInput�
startTagHr�
startTagImage�startTagIsIndex�startTagTextarea�startTagIFramer��startTagRawtext�startTagSelect�startTagRpRt�startTagOpt�startTagMath�startTagSvg�startTagMisplacedr�r�r��
endTagBody�
endTagHtml�endTagBlock�
endTagForm�endTagP�endTagListItem�
endTagHeading�endTagFormatting�endTagAppletMarqueeObjectrr�r�r�r�r)r*rK�s�������-
���z'getPhases.<locals>.InBodyPhase.__init__cSs$|j|jko"|j|jko"|j|jkSr.)r@rjrk)rCZnode1Znode2r)r)r*�isMatchingFormattingElement�s

�
�z:getPhases.<locals>.InBodyPhase.isMatchingFormattingElementcSs�|j�|�|jjd}g}|jjddd�D](}|tkr@qXq.|�||�r.|�|�q.t|�dkrv|jj�|d�|jj�|�dS)Nrv�)	r>r�r~�activeFormattingElementsrr~r�r�r)rCr�rnZmatchingElementsr�r)r)r*�addFormattingElement�sz3getPhases.<locals>.InBodyPhase.addFormattingElementcSs>td�}|jjddd�D]}|j|kr|j�d�q:qdS)N)r6r7r5r(r�r�r�r�r�r�r�r�rvz expected-closing-tag-but-got-eof)r�r>r~r@rLr)rCZallowed_elementsr�r)r)r*r�s

z)getPhases.<locals>.InBodyPhase.processEOFcSsf|d}|j|_|�d�rH|jjdjdkrH|jjd��sH|dd�}|rb|j��|j�|�dS)Nrw�
rv)r2r3rPr)	rWr�r�r>r~r@Z
hasContent�#reconstructActiveFormattingElementsr�)rCr�rwr)r)r*�!processSpaceCharactersDropNewline
s
��
z@getPhases.<locals>.InBodyPhase.processSpaceCharactersDropNewlinecSsT|ddkrdS|j��|j�|d�|jjrPtdd�|dD��rPd|j_dS)Nrw�cSsg|]}|tk�qSr)�r�r?�charr)r)r*rD"s�zDgetPhases.<locals>.InBodyPhase.processCharacters.<locals>.<listcomp>F)r>r�r�rLrc�anyr�r)r)r*r�s
��z0getPhases.<locals>.InBodyPhase.processCharacterscSs|j��|j�|d�dSr�)r>r�r�r�r)r)r*rW&s
z;getPhases.<locals>.InBodyPhase.processSpaceCharactersNonPrecSs|jjd�|�Srr�r�r)r)r*rX*sz4getPhases.<locals>.InBodyPhase.startTagProcessInHeadcSs||j�dddi�t|jj�dksx|jjdjdkr6nBd|j_|d��D],\}}||jjdjkrJ||jjdj|<qJdS)Nrr@r�rFrw)	rLrr�r>r~r@rcr/rkr�r)r)r*r-s�z+getPhases.<locals>.InBodyPhase.startTagBodycSs�|j�dddi�t|jj�dks�|jjdjdkr6np|jjs@nf|jjdjrj|jjdj�|jjd�|jjdjdkr�|jj�	�qj|j�
|�|jjd|j_dS)	Nrr@r�rr�rvr�r�)
rLrr�r>r~r@rc�parent�removeChildrr�rIr`r�r)r)r*r8s"z/getPhases.<locals>.InBodyPhase.startTagFramesetcSs.|jjddd�r|�td��|j�|�dS�Nr(rF��variant)r>�elementInScoperyr�r�r�r)r)r*rYFsz-getPhases.<locals>.InBodyPhase.startTagClosePcSs>|jjddd�r|�td��|j�|�d|j_|j|_dS)Nr(rFr�F)	r>r�ryr�r�rLrcr�r�r�r)r)r*r[Ks
z1getPhases.<locals>.InBodyPhase.startTagPreListingcSsZ|jjr|j�dddi�n:|jjddd�r:|�td��|j�|�|jjd|j_dS)Nrr@r4r(rFr�rv)	r>�formPointerrLrr�ryr�r�r~r�r)r)r*r\Rsz+getPhases.<locals>.InBodyPhase.startTagFormcSs�d|j_dgddgddgd�}||d}t|jj�D]@}|j|kr^|jj�t|jd��qx|j	t
kr6|jdkr6qxq6|jjd	d
d�r�|jj�td	d��|j�|�dS)NFr5r7r6)r5r7r6r@rs)rr+r(r(rFr�)
rLrc�reversedr>r~r@r`r�r��	nameTuplerr�r�)rCr�ZstopNamesMapZ	stopNamesr�r)r)r*r][s*�

�
��z/getPhases.<locals>.InBodyPhase.startTagListItemcSs>|jjddd�r|�td��|j�|�|jjj|jj_dSr�)	r>r�ryr�r�rLrOr_r]r�r)r)r*r^qsz0getPhases.<locals>.InBodyPhase.startTagPlaintextcSsb|jjddd�r|�td��|jjdjtkrR|j�dd|di�|jj�	�|j�
|�dS)Nr(rFr�rvrr@)r>r�ryr�r~r@rrLrrr�r�r)r)r*rZwsz.getPhases.<locals>.InBodyPhase.startTagHeadingcSs~|j�d�}|rf|j�dddd��|�td��||jjkrL|jj�|�||jjkrf|jj�|�|j�	�|�
|�dS)Nr8�$unexpected-start-tag-implies-end-tag�Z	startNameZendName)r>�!elementInActiveFormattingElementsrLrr|r�r~rr�r�r�)rCr�ZafeAElementr)r)r*r_s�
z(getPhases.<locals>.InBodyPhase.startTagAcSs|j��|�|�dSr.)r>r�r�r�r)r)r*r`�s
z1getPhases.<locals>.InBodyPhase.startTagFormattingcSsP|j��|j�d�rB|j�dddd��|�td��|j��|�|�dS)NrEr�r�)r>r�r�rLrr�r�r�r�r)r)r*ra�s
�
z+getPhases.<locals>.InBodyPhase.startTagNobrcSsT|j�d�r2|j�dddd��|�td��|S|j��|j�|�d|j_dS)NrFr�r�F)	r>r�rLrr�r�r�r�rcr�r)r)r*rb�s�
z-getPhases.<locals>.InBodyPhase.startTagButtoncSs0|j��|j�|�|jj�t�d|j_dS�NF)r>r�r�r�r�rrLrcr�r)r)r*rc�s
z:getPhases.<locals>.InBodyPhase.startTagAppletMarqueeObjectcSsB|jjddd�r|�td��|j��d|j_|j�|d�dS)Nr(rFr�Fr�)r>r�ryr�r�rLrcr�r�r)r)r*rd�s

z*getPhases.<locals>.InBodyPhase.startTagXmpcSsR|jjdkr*|jjddd�r*|�td��|j�|�d|j_|jjd|j_	dS)Nr�r(rFr�Fr�)
rLrZr>r�r�r�r�rcrIr`r�r)r)r*re�sz,getPhases.<locals>.InBodyPhase.startTagTablecSs6|j��|j�|�|jj��d|d<d|j_dS)NTr|F)r>r�r�r~rrLrcr�r)r)r*rf�s

z5getPhases.<locals>.InBodyPhase.startTagVoidFormattingcSs@|jj}|�|�d|dkr<|dd�t�dkr<||j_dS)Nr3rw�hidden)rLrcrfrlr)rCr�rcr)r)r*rh�s
�z,getPhases.<locals>.InBodyPhase.startTagInputcSs$|j�|�|jj��d|d<dSrrr�r)r)r*rg�sz2getPhases.<locals>.InBodyPhase.startTagParamSourcecSsJ|jjddd�r|�td��|j�|�|jj��d|d<d|j_dS)Nr(rFr�Tr|F)	r>r�ryr�r�r~rrLrcr�r)r)r*ri�sz)getPhases.<locals>.InBodyPhase.startTagHrcSs6|j�dddd��|�tdd|d|dd��dS)	Nzunexpected-start-tag-treated-asrNrI�ZoriginalNameZnewNamerrrwr{�rkr{)rLrr�r�r�r)r)r*rj�s�
�z,getPhases.<locals>.InBodyPhase.startTagImagecSs|j�dddi�|jjrdSi}d|dkr>|dd|d<|�tdd|d��|�td	d��|�td
d��d|dkr�|dd}nd}|�td
|d��|d��}d|kr�|d=d|kr�|d=d|d<|�tdd||dd��|�	td
��|�td	d��|�	td��dS)Nzdeprecated-tagr@rO�actionrwr4rr)rkrMZlabel�promptz3This is a searchable index. Enter search keywords: rq�r3rwrLr{r�)
rLrr>r�r�r�r�r�copyr�)rCr�Z
form_attrsr�rkr)r)r*rk�s<
��
�z.getPhases.<locals>.InBodyPhase.startTagIsIndexcSs0|j�|�|jjj|jj_|j|_d|j_dSr�)	r>r�rLrOr\r]r�r�rcr�r)r)r*rl�sz/getPhases.<locals>.InBodyPhase.startTagTextareacSsd|j_|�|�dSr�)rLrcrnr�r)r)r*rmsz-getPhases.<locals>.InBodyPhase.startTagIFramecSs"|jjr|�|�n
|�|�dSr.)rLrNrnr�r�r)r)r*r�sz/getPhases.<locals>.InBodyPhase.startTagNoscriptcSs|j�|d�dS)z8iframe, noembed noframes, noscript(if scripting enabled)r�Nrr�r)r)r*rn
sz.getPhases.<locals>.InBodyPhase.startTagRawtextcSs@|jjdjdkr$|jj�td��|j��|jj�|�dS�NrvrS)	r>r~r@rLr`r�r�r�r�r�r)r)r*rqs
z*getPhases.<locals>.InBodyPhase.startTagOptcSs�|j��|j�|�d|j_|jj|jjd|jjd|jjd|jjd|jjd|jjdfkrx|jjd|j_n|jjd	|j_dS)
NFr�r�r�r�r�r��inSelectInTabler�)r>r�r�rLrcr`rIr�r)r)r*ros





�z-getPhases.<locals>.InBodyPhase.startTagSelectcSsB|j�d�r2|j��|jjdjdkr2|j��|j�|�dS)N�rubyrv)r>r��generateImpliedEndTagsr~r@rLrr�r�r)r)r*rp%s


z+getPhases.<locals>.InBodyPhase.startTagRpRtcSsZ|j��|j�|�|j�|�td|d<|j�|�|drV|jj��d|d<dS)Nrhrjr{Tr|)	r>r�rLrrrr�r~rr�r)r)r*rr,s
z+getPhases.<locals>.InBodyPhase.startTagMathcSsZ|j��|j�|�|j�|�td|d<|j�|�|drV|jj��d|d<dS)Nryrjr{Tr|)	r>r�rLrrrr�r~rr�r)r)r*rs8s
z*getPhases.<locals>.InBodyPhase.startTagSvgcSs|j�dd|di�dS)a5 Elements that should be children of other elements that have a
            different insertion mode; here they are ignored
            "caption", "col", "colgroup", "frame", "frameset", "head",
            "option", "optgroup", "tbody", "td", "tfoot", "th", "thead",
            "tr", "noscript"
            zunexpected-start-tag-ignoredr@Nr�r�r)r)r*rtDsz0getPhases.<locals>.InBodyPhase.startTagMisplacedcSs|j��|j�|�dSr.)r>r�r�r�r)r)r*r�Ms
z,getPhases.<locals>.InBodyPhase.startTagOthercSs�|jjddd�sD|�tdd��|j�dddi�|�tdd��nT|j�d�|jjdj	dkrt|j�dddi�|jj�
�}|j	dkr�|jj�
�}q�dS)	Nr(rFr�rrr
r@rsrv)r>r�rYr�rLrryr�r~r@rrr)r)r*ryQs
z&getPhases.<locals>.InBodyPhase.endTagPcSs~|j�d�s|j��dS|jjdjdkrj|jjdd�D],}|jtd�kr<|j�dd|jd��qjq<|jjd|j_dS)Nr�rv�)r6r7r5rTrSr(rQrRr�r�r�r�r�r�r�r��$expected-one-end-tag-but-got-another�ZgotNameZexpectedName�	afterBody)	r>r�rLrr~r@r�rIr`rr)r)r*ru^s

�z)getPhases.<locals>.InBodyPhase.endTagBodycSs"|j�d�r|�td��|SdS)Nr�)r>r�rur�r�r)r)r*rvpsz)getPhases.<locals>.InBodyPhase.endTagHtmlcSs�|ddkr|j|_|j�|d�}|r2|j��|jjdj|dkr^|j�dd|di�|r�|jj�	�}|j|dkr�|jj�	�}qndS)Nr@r2rv�end-tag-too-early)
rWr�r>r�r�r~r@rLrr)rCr�ZinScoper�r)r)r*rwvs
z*getPhases.<locals>.InBodyPhase.endTagBlockcSsv|jj}d|j_|dks$|j�|�s8|j�dddi�n:|j��|jjd|krd|j�dddi�|jj�|�dS)Nr
r@r4rvzend-tag-too-early-ignored)r>r�r�rLrr�r~rrr)r)r*rx�s�
�z)getPhases.<locals>.InBodyPhase.endTagFormcSs�|ddkrd}nd}|jj|d|d�sB|j�dd|di�nf|jj|dd�|jjdj|dkr�|j�dd|di�|jj��}|j|dkr�|jj��}q�dS)	Nr@r5�listr�r
��excludervr�)r>r�rLrr�r~r@r)rCr�r�r�r)r)r*rz�s
�z-getPhases.<locals>.InBodyPhase.endTagListItemcSs�tD]}|j�|�r|j��q$q|jjdj|dkrP|j�dd|di�tD]8}|j�|�rT|jj��}|jtkr�|jj��}qpq�qTdS)Nrvr@r�)	rr>r�r�r~r@rLrr)rCr��itemr)r)r*r{�s

z,getPhases.<locals>.InBodyPhase.endTagHeadingcSsd}|dk�r
|d7}|j�|d�}|rD||jjkrR|j�|j�sR|�|�dS||jjkr�|j�dd|di�|jj�	|�dS|j�|j�s�|j�dd|di�dS||jjdkr�|j�d	d|di�|jj�
|�}d}|jj|d�D]}|jtkr�|}�qq�|dk�rR|jj�
�}||k�r@|jj�
�}�q&|jj�	|�dS|jj|d}|jj�
|�}|}	}
d}|jj�
|
�}|d
k�rX|d7}|d8}|jj|}
|
|jjk�r�|jj�	|
��q�|
|k�rސqX|	|k�r�|jj�
|
�d}|
��}
|
|jj|jj�
|
�<|
|jj|jj�
|
�<|
}
|	j�rF|	j�|	�|
�|	�|
}	�q�|	j�rl|	j�|	�|jtd�k�r�|j��\}}|�|	|�n
|�|	�|��}
|�|
�|�|
�|jj�	|�|jj�||
�|jj�	|�|jj�|jj�
|�d|
�qdS)z)The much-feared adoption agency algorithmr�rr@Nzadoption-agency-1.2zadoption-agency-4.4rvzadoption-agency-1.3r�r�r�r�r�r�)r>r�r~r�r@r�rLrr�r�indexr�rrZ	cloneNoder�r�ZappendChildr�ZgetTableMisnestedNodePosition�insertBeforeZreparentChildren�insert)rCr�ZouterLoopCounterZformattingElementZafeIndexZ
furthestBlockrnZcommonAncestorZbookmarkZlastNoder�ZinnerLoopCounterr�Zcloner�r�r)r)r*r|�s�

�
��







����



�z/getPhases.<locals>.InBodyPhase.endTagFormattingcSs�|j�|d�r|j��|jjdj|dkrF|j�dd|di�|j�|d�r�|jj��}|j|dkr~|jj��}qb|j��dS)Nr@rvr�)	r>r�r�r~r@rLrr�clearActiveFormattingElements)rCr�rnr)r)r*r}Ts
z8getPhases.<locals>.InBodyPhase.endTagAppletMarqueeObjectcSs@|j�dddd��|j��|j�tdd��|jj��dS)Nzunexpected-end-tag-treated-asr�z
br elementr�rr)rLrr>r�r�r�r~rr�r)r)r*r`s�
z'getPhases.<locals>.InBodyPhase.endTagBrcSs�|jjddd�D]�}|j|dkrz|jj|dd�|jjdj|dkrb|j�dd|di�|jj��|krtqbq�q|jtkr|j�dd|di�q�qdS)Nrvr@r�r
)	r>r~r@r�rLrrr�rrr)r)r*r�gs
z*getPhases.<locals>.InBodyPhase.endTagOtherN)6r9r:r;rKr~r�r�r�r�rWrXrrrYr[r\r]r^rZr_r`rarbrcrdrerfrhrgrirjrkrlrmr�rnrqrorprrrsrtr�ryrurvrwrxrzr{r|r}rr�r)r�r)r*�InBodyPhase�shG

	

	

$r�cs@eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
S)zgetPhases.<locals>.TextPhasecsF��|||�t�g�|_|j|j_t�d|jfg�|_|j|j_dS)Nr�)	rKr
r�r�r�r��endTagScriptr�r�r�r�r)r*rKvs
�z%getPhases.<locals>.TextPhase.__init__cSs|j�|d�dSr�r�r�r)r)r*r�~sz.getPhases.<locals>.TextPhase.processCharacterscSs8|j�dd|jjdji�|jj��|jj|j_dS)Nz&expected-named-closing-tag-but-got-eofr@rvT)rLrr>r~r@rr�r`rBr)r)r*r��s�z'getPhases.<locals>.TextPhase.processEOFcSsdSr.r)r�r)r)r*r��sz*getPhases.<locals>.TextPhase.startTagOthercSs|jj��}|jj|j_dSr.�r>r~rrLr�r`rr)r)r*r��sz)getPhases.<locals>.TextPhase.endTagScriptcSs|jj��|jj|j_dSr.r�r�r)r)r*r��sz(getPhases.<locals>.TextPhase.endTagOtherN)	r9r:r;rKr�r�r�r�r�r)r�r)r*�	TextPhaseusr�cs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'S)(zgetPhases.<locals>.InTablePhasec
s���|||�t�d|jfd|jfd|jfd|jfd|jfd|jfd|j	fd|j
fd	|jfd
|jfg
�|_
|j|j
_t�d|jfd|jfg�|_|j|j_dS)Nr�r�r�rU�r�r�r�)r�r�r�r�)r�r�rLr4)r�r�rUr�r�r�r�r�r�r�r�)rKr
r�r��startTagCaption�startTagColgroup�startTagCol�startTagRowGroup�startTagImplyTbodyre�startTagStyleScriptrhr\r�r�r��endTagTable�endTagIgnorer�r�r�r�r)r*rK�s*�
��z(getPhases.<locals>.InTablePhase.__init__cSs$|jjdjdkr |jj��qdS)Nrv)r�r��r>r~r@rrBr)r)r*�clearStackToTableContext�sz8getPhases.<locals>.InTablePhase.clearStackToTableContextcSs$|jjdjdkr |j�d�ndS)Nrvr�zeof-in-table�r>r~r@rLrrBr)r)r*r��sz*getPhases.<locals>.InTablePhase.processEOFcSs4|jj}|jjd|j_||jj_|jj�|�dS�N�inTableText)rLr`rIr�r��rCr�r�r)r)r*r��s
z6getPhases.<locals>.InTablePhase.processSpaceCharacterscSs4|jj}|jjd|j_||jj_|jj�|�dSr�)rLr`rIr�r�r�r)r)r*r��s
z1getPhases.<locals>.InTablePhase.processCharacterscSs&d|j_|jjd�|�d|j_dS)NTr�F)r>�insertFromTablerLrIr�r�r)r)r*r��sz*getPhases.<locals>.InTablePhase.insertTextcSs6|��|jj�t�|j�|�|jjd|j_dS)Nr�)	r�r>r�r�rr�rLrIr`r�r)r)r*r��sz/getPhases.<locals>.InTablePhase.startTagCaptioncSs(|��|j�|�|jjd|j_dS)Nr��r�r>r�rLrIr`r�r)r)r*r��sz0getPhases.<locals>.InTablePhase.startTagColgroupcSs|�tdd��|S)Nr�rr)r�r�r�r)r)r*r��sz+getPhases.<locals>.InTablePhase.startTagColcSs(|��|j�|�|jjd|j_dS�Nr�r�r�r)r)r*r��sz0getPhases.<locals>.InTablePhase.startTagRowGroupcSs|�tdd��|S)Nr�rr)r�r�r�r)r)r*r��sz2getPhases.<locals>.InTablePhase.startTagImplyTbodycSs6|j�dddd��|jj�td��|jjs2|SdS)Nr�r�r�)rLrr`r�r�rSr�r)r)r*re�s�z-getPhases.<locals>.InTablePhase.startTagTablecSs|jjd�|�Srr�r�r)r)r*r��sz3getPhases.<locals>.InTablePhase.startTagStyleScriptcSsVd|dkrH|dd�t�dkrH|j�d�|j�|�|jj��n
|�|�dS)Nr3rwr�z unexpected-hidden-input-in-table)	rlrrLrr>r�r~rr�r�r)r)r*rh�s�z-getPhases.<locals>.InTablePhase.startTagInputcSsD|j�d�|jjdkr@|j�|�|jjd|j_|jj��dS)Nzunexpected-form-in-tablerv)rLrr>r�r�r~rr�r)r)r*r\�s
z,getPhases.<locals>.InTablePhase.startTagFormcSs<|j�dd|di�d|j_|jjd�|�d|j_dS)Nz)unexpected-start-tag-implies-table-voodoor@Tr�F)rLrr>r�rIr�r�r)r)r*r�sz-getPhases.<locals>.InTablePhase.startTagOthercSs�|jjddd�r�|j��|jjdjdkrJ|j�dd|jjdjd��|jjdjdkrj|jj��qJ|jj��|j��n
|j��dS)Nr�r�rvzend-tag-too-early-namedr�)	r>r�r�r~r@rLrrrbr�r)r)r*r�
s
��z+getPhases.<locals>.InTablePhase.endTagTablecSs|j�dd|di�dSrr�r�r)r)r*r�sz,getPhases.<locals>.InTablePhase.endTagIgnorecSs<|j�dd|di�d|j_|jjd�|�d|j_dS)Nz'unexpected-end-tag-implies-table-voodoor@Tr�F)rLrr>r�rIr�r�r)r)r*r� sz+getPhases.<locals>.InTablePhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�rer�rhr\r�r�r�r�r)r�r)r*�InTablePhase�s&	
r�csPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)z#getPhases.<locals>.InTableTextPhasecs��|||�d|_g|_dSr.)rKr��characterTokensr�r�r)r*rK(sz,getPhases.<locals>.InTableTextPhase.__init__cSsdd�dd�|jD��}tdd�|D��rJtd|d�}|jjd�|�n|rZ|j�|�g|_dS)Nr�cSsg|]}|d�qS)rwr)�r?r�r)r)r*rD.szGgetPhases.<locals>.InTableTextPhase.flushCharacters.<locals>.<listcomp>cSsg|]}|tk�qSr)r�r�r)r)r*rD/srqr�r�)�joinr�r�rrLrIr�r>)rCrwr�r)r)r*�flushCharacters-sz3getPhases.<locals>.InTableTextPhase.flushCharacterscSs|��|j|j_|Sr.�r�r�rLr`r�r)r)r*r�6s
z2getPhases.<locals>.InTableTextPhase.processCommentcSs|��|j|j_dSr�r�rBr)r)r*r�;s
z.getPhases.<locals>.InTableTextPhase.processEOFcSs |ddkrdS|j�|�dS�Nrwr��r�r�r�r)r)r*r�@sz5getPhases.<locals>.InTableTextPhase.processCharacterscSs|j�|�dSr.r�r�r)r)r*r�Esz:getPhases.<locals>.InTableTextPhase.processSpaceCharacterscSs|��|j|j_|Sr.r�r�r)r)r*r�Js
z3getPhases.<locals>.InTableTextPhase.processStartTagcSs|��|j|j_|Sr.r�r�r)r)r*r�Os
z1getPhases.<locals>.InTableTextPhase.processEndTagN)r9r:r;rKr�r�r�r�r�r�r�r)r�r)r*�InTableTextPhase's	r�cs`eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�ZdS)z!getPhases.<locals>.InCaptionPhasecsf��|||�t�d|jfd|jfg�|_|j|j_t�d|jfd|j	fd|j
fg�|_|j|j_dS)Nr��	r�rUr�r�r�r�r�r�r�r�r�)
r�rUr�r�r�r�r�r�r�r�)
rKr
r�r��startTagTableElementr�r�r��
endTagCaptionr�r�r�r�r�r�r)r*rKVs ��
��z*getPhases.<locals>.InCaptionPhase.__init__cSs|jjddd�S)Nr�r�r��r>r�rBr)r)r*�ignoreEndTagCaptionhsz5getPhases.<locals>.InCaptionPhase.ignoreEndTagCaptioncSs|jjd��dSr��rLrIr�rBr)r)r*r�ksz,getPhases.<locals>.InCaptionPhase.processEOFcSs|jjd�|�Sr��rLrIr�r�r)r)r*r�nsz3getPhases.<locals>.InCaptionPhase.processCharacterscSs0|j��|��}|jj�td��|s,|SdS�Nr��rLrr�r`r�r��rCr��ignoreEndTagr)r)r*r�qs

z6getPhases.<locals>.InCaptionPhase.startTagTableElementcSs|jjd�|�Sr�r�r�r)r)r*r�ysz/getPhases.<locals>.InCaptionPhase.startTagOthercSs�|��s�|j��|jjdjdkrB|j�dd|jjdjd��|jjdjdkrb|jj��qB|jj��|j��|jj	d|j_
n
|j��dS)Nrvr�r�r�r�)r�r>r�r~r@rLrrr�rIr`r�r)r)r*r�|s
��
z/getPhases.<locals>.InCaptionPhase.endTagCaptioncSs0|j��|��}|jj�td��|s,|SdSr�r�r�r)r)r*r��s

z-getPhases.<locals>.InCaptionPhase.endTagTablecSs|j�dd|di�dSrr�r�r)r)r*r��sz.getPhases.<locals>.InCaptionPhase.endTagIgnorecSs|jjd�|�Sr��rLrIr�r�r)r)r*r��sz-getPhases.<locals>.InCaptionPhase.endTagOtherN)
r9r:r;rKr�r�r�r�r�r�r�r�r�r)r�r)r*�InCaptionPhaseTsr�csXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z%getPhases.<locals>.InColumnGroupPhasecs^��|||�t�d|jfd|jfg�|_|j|j_t�d|jfd|j	fg�|_
|j|j
_dS)Nr�rUr�)rKr
r�r�r�r�r�r��endTagColgroup�	endTagColr�r�r�r�r)r*rK�s�
�z.getPhases.<locals>.InColumnGroupPhase.__init__cSs|jjdjdkS)Nrvr�)r>r~r@rBr)r)r*�ignoreEndTagColgroup�sz:getPhases.<locals>.InColumnGroupPhase.ignoreEndTagColgroupcSs8|jjdjdkrdS|��}|�td��|s4dSdS)Nrvr�r�T)r>r~r@r�r�r�)rCr�r)r)r*r��sz0getPhases.<locals>.InColumnGroupPhase.processEOFcSs"|��}|�td��|s|SdS�Nr��r�r�r�r�r)r)r*r��sz7getPhases.<locals>.InColumnGroupPhase.processCharacterscSs$|j�|�|jj��d|d<dSrrr�r)r)r*r��sz1getPhases.<locals>.InColumnGroupPhase.startTagColcSs"|��}|�td��|s|SdSr�r�r�r)r)r*r��sz3getPhases.<locals>.InColumnGroupPhase.startTagOthercSs4|��r|j��n|jj��|jjd|j_dS�Nr�)r�rLrr>r~rrIr`r�r)r)r*r��sz4getPhases.<locals>.InColumnGroupPhase.endTagColgroupcSs|j�dddi�dS)Nz
no-end-tagr@rUr�r�r)r)r*r��sz/getPhases.<locals>.InColumnGroupPhase.endTagColcSs"|��}|�td��|s|SdSr�r�r�r)r)r*r��sz1getPhases.<locals>.InColumnGroupPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r)r�r)r*�InColumnGroupPhase�s
	r�csxeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS)z#getPhases.<locals>.InTableBodyPhasecsv��|||�t�d|jfd|jfd|jfd|jfg�|_|j|j_	t�d|j
fd|jfd|jfg�|_
|j|j
_	dS)Nr�r��r�r�)r�rUr�r�r�r�r�r�)r�r�rUr�r�r�r�r�)rKr
r�r��
startTagTr�startTagTableCell�startTagTableOtherr�r�r��endTagTableRowGroupr�r�r�r�r�r�r)r*rK�s$��
��z,getPhases.<locals>.InTableBodyPhase.__init__cSs6|jjdjdkr |jj��q|jjdjdkr2dS)Nrv)r�r�r�r�r�r�rBr)r)r*�clearStackToTableBodyContext�sz@getPhases.<locals>.InTableBodyPhase.clearStackToTableBodyContextcSs|jjd��dSr�r�rBr)r)r*r��sz.getPhases.<locals>.InTableBodyPhase.processEOFcSs|jjd�|�Sr�rr�r)r)r*r�sz:getPhases.<locals>.InTableBodyPhase.processSpaceCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�sz5getPhases.<locals>.InTableBodyPhase.processCharacterscSs(|��|j�|�|jjd|j_dS)Nr�)r�r>r�rLrIr`r�r)r)r*r�sz.getPhases.<locals>.InTableBodyPhase.startTagTrcSs*|j�dd|di�|�tdd��|S)Nzunexpected-cell-in-table-bodyr@r�rr)rLrr�r�r�r)r)r*r�s

�z5getPhases.<locals>.InTableBodyPhase.startTagTableCellcSsb|jjddd�s0|jjddd�s0|jjddd�rT|��|�t|jjdj��|S|j��dS�Nr�r�r�r�r�rv�	r>r�r�r�r�r~r@rLrr�r)r)r*r�s���z6getPhases.<locals>.InTableBodyPhase.startTagTableOthercSs|jjd�|�Sr�r�r�r)r)r*r�sz1getPhases.<locals>.InTableBodyPhase.startTagOthercSsT|jj|ddd�r:|��|jj��|jjd|j_n|j�dd|di�dS)Nr@r�r�r�� unexpected-end-tag-in-table-body)	r>r�r�r~rrLrIr`rr�r)r)r*r�"s
�z7getPhases.<locals>.InTableBodyPhase.endTagTableRowGroupcSsb|jjddd�s0|jjddd�s0|jjddd�rT|��|�t|jjdj��|S|j��dSr�r�r�r)r)r*r�+s���z/getPhases.<locals>.InTableBodyPhase.endTagTablecSs|j�dd|di�dS)Nr�r@r�r�r)r)r*r�8s
�z0getPhases.<locals>.InTableBodyPhase.endTagIgnorecSs|jjd�|�Sr�r�r�r)r)r*r�<sz/getPhases.<locals>.InTableBodyPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�r�r�r)r�r)r*�InTableBodyPhase�s
	
r�cs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)zgetPhases.<locals>.InRowPhasecsv��|||�t�d|jfd|jfd|jfg�|_|j|j_t�d|j	fd|j
fd|jfd|jfg�|_
|j|j
_dS)Nr�r�)r�rUr�r�r�r�r�r�r�r�)r�r�rUr�r�r�r�)rKr
r�r�r�r�r�r�r��endTagTrr�r�r�r�r�r�r�r)r*rKAs$��
��z&getPhases.<locals>.InRowPhase.__init__cSs@|jjdjdkr<|j�dd|jjdji�|jj��qdS)Nrv)r�r�z'unexpected-implied-end-tag-in-table-rowr@)r>r~r@rLrrrBr)r)r*�clearStackToTableRowContextUs
�z9getPhases.<locals>.InRowPhase.clearStackToTableRowContextcSs|jjddd�S)Nr�r�r�r�rBr)r)r*�ignoreEndTagTr[sz,getPhases.<locals>.InRowPhase.ignoreEndTagTrcSs|jjd��dSr�r�rBr)r)r*r�_sz(getPhases.<locals>.InRowPhase.processEOFcSs|jjd�|�Sr�rr�r)r)r*r�bsz4getPhases.<locals>.InRowPhase.processSpaceCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�esz/getPhases.<locals>.InRowPhase.processCharacterscSs6|��|j�|�|jjd|j_|jj�t�dS)Nr�)	r�r>r�rLrIr`r�r�rr�r)r)r*r�hsz/getPhases.<locals>.InRowPhase.startTagTableCellcSs"|��}|�td��|s|SdS�Nr��r�r�r�r�r)r)r*r�nsz0getPhases.<locals>.InRowPhase.startTagTableOthercSs|jjd�|�Sr�r�r�r)r)r*r�usz+getPhases.<locals>.InRowPhase.startTagOthercSs<|��s.|��|jj��|jjd|j_n
|j��dSr�)	r�r�r>r~rrLrIr`rr�r)r)r*r�xs
z&getPhases.<locals>.InRowPhase.endTagTrcSs"|��}|�td��|s|SdSr�r�r�r)r)r*r��sz)getPhases.<locals>.InRowPhase.endTagTablecSs4|jj|ddd�r&|�td��|S|j��dS)Nr@r�r�r�)r>r�r�r�rLrr�r)r)r*r��sz1getPhases.<locals>.InRowPhase.endTagTableRowGroupcSs|j�dd|di�dS)Nzunexpected-end-tag-in-table-rowr@r�r�r)r)r*r��s
�z*getPhases.<locals>.InRowPhase.endTagIgnorecSs|jjd�|�Sr�r�r�r)r)r*r��sz)getPhases.<locals>.InRowPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�r�r�r�r)r�r)r*�
InRowPhase?s
r�cs`eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�ZdS)zgetPhases.<locals>.InCellPhasecsf��|||�t�d|jfd|jfg�|_|j|j_t�d|jfd|j	fd|j
fg�|_|j|j_dS)Nr�r�r�)r�r�rUr�r�r�)
rKr
r�r�r�r�r�r��endTagTableCellr��endTagImplyr�r�r�r�r)r*rK�s��
�z'getPhases.<locals>.InCellPhase.__init__cSsB|jjddd�r |�td��n|jjddd�r>|�td��dS�Nr�r�r�r�)r>r�r�r�rBr)r)r*�	closeCell�sz(getPhases.<locals>.InCellPhase.closeCellcSs|jjd��dSr�r�rBr)r)r*r��sz)getPhases.<locals>.InCellPhase.processEOFcSs|jjd�|�Sr�r�r�r)r)r*r��sz0getPhases.<locals>.InCellPhase.processCharacterscSs:|jjddd�s |jjddd�r,|��|S|j��dSr��r>r�r�rLrr�r)r)r*r��s�z1getPhases.<locals>.InCellPhase.startTagTableOthercSs|jjd�|�Sr�r�r�r)r)r*r��sz,getPhases.<locals>.InCellPhase.startTagOthercSs�|jj|ddd�r�|j�|d�|jjdj|dkrp|j�dd|di�|jj��}|j|dkrPq|qPn|jj��|j��|jj	d|j_
n|j�dd|di�dS)Nr@r�r�rvzunexpected-cell-end-tagr�r
)r>r�r�r~r@rLrrr�rIr`rr)r)r*r��s
�
z.getPhases.<locals>.InCellPhase.endTagTableCellcSs|j�dd|di�dSrr�r�r)r)r*r��sz+getPhases.<locals>.InCellPhase.endTagIgnorecSs.|jj|ddd�r |��|S|j��dS)Nr@r�r�r�r�r)r)r*r��sz*getPhases.<locals>.InCellPhase.endTagImplycSs|jjd�|�Sr�r�r�r)r)r*r��sz*getPhases.<locals>.InCellPhase.endTagOtherN)
r9r:r;rKr�r�r�r�r�r�r�r�r�r)r�r)r*�InCellPhase�s
r�csxeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS)z getPhases.<locals>.InSelectPhasec	s���|||�t�d|jfd|jfd|jfd|jfd|jfd|jfg�|_	|j
|j	_t�d|jfd|j
fd|jfg�|_|j|j_dS)Nr�rSrTr�)rLrJrPr�)rKr
r�r��startTagOption�startTagOptgrouprorhr�r�r�r��endTagOption�endTagOptgroup�endTagSelectr�r�r�r�r)r*rK�s �
�z)getPhases.<locals>.InSelectPhase.__init__cSs$|jjdjdkr |j�d�ndS)Nrvr�z
eof-in-selectr�rBr)r)r*r��sz+getPhases.<locals>.InSelectPhase.processEOFcSs$|ddkrdS|j�|d�dSr�r�r�r)r)r*r�	sz2getPhases.<locals>.InSelectPhase.processCharacterscSs.|jjdjdkr|jj��|j�|�dSr��r>r~r@rr�r�r)r)r*r�	sz/getPhases.<locals>.InSelectPhase.startTagOptioncSsL|jjdjdkr|jj��|jjdjdkr<|jj��|j�|�dS)NrvrSrTr�r�r)r)r*r�	s
z1getPhases.<locals>.InSelectPhase.startTagOptgroupcSs|j�d�|�td��dS)Nzunexpected-select-in-selectr�)rLrr�r�r�r)r)r*ro	sz/getPhases.<locals>.InSelectPhase.startTagSelectcSs2|j�d�|jjddd�r.|�td��|SdS)Nzunexpected-input-in-selectr�r�)rLrr>r�r�r�r�r)r)r*rh	s
z.getPhases.<locals>.InSelectPhase.startTagInputcSs|jjd�|�Srr�r�r)r)r*r�	sz/getPhases.<locals>.InSelectPhase.startTagScriptcSs|j�dd|di�dS)Nzunexpected-start-tag-in-selectr@r�r�r)r)r*r�!	s
�z.getPhases.<locals>.InSelectPhase.startTagOthercSs6|jjdjdkr |jj��n|j�dddi�dS)NrvrS�unexpected-end-tag-in-selectr@�r>r~r@rrLrr�r)r)r*r�%	s
�z-getPhases.<locals>.InSelectPhase.endTagOptioncSsf|jjdjdkr0|jjdjdkr0|jj��|jjdjdkrP|jj��n|j�dddi�dS)NrvrS���rTrr@rr�r)r)r*r�,	s��z/getPhases.<locals>.InSelectPhase.endTagOptgroupcSsN|jjddd�r@|jj��}|jdkr4|jj��}q|j��n
|j��dS)Nr�r�)r>r�r~rr@rLrbrrr)r)r*r�9	s
z-getPhases.<locals>.InSelectPhase.endTagSelectcSs|j�dd|di�dS)Nrr@r�r�r)r)r*r�D	s
�z,getPhases.<locals>.InSelectPhase.endTagOtherN)r9r:r;rKr�r�r�r�rorhr�r�r�r�r�r�r)r�r)r*�
InSelectPhase�s
rcsHeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dS)z'getPhases.<locals>.InSelectInTablePhasecsN��|||�t�d|jfg�|_|j|j_t�d|jfg�|_|j	|j_dS)N)r�r�r�r�r�r�r�r�)
rKr
r�rer�r�r�r�r�r�r�r�r)r*rKI	s��
��z0getPhases.<locals>.InSelectInTablePhase.__init__cSs|jjd��dS�Nr�r�rBr)r)r*r�X	sz2getPhases.<locals>.InSelectInTablePhase.processEOFcSs|jjd�|�Srr�r�r)r)r*r�[	sz9getPhases.<locals>.InSelectInTablePhase.processCharacterscSs(|j�dd|di�|�td��|S)Nz5unexpected-table-element-start-tag-in-select-in-tabler@r�)rLrr�r�r�r)r)r*re^	sz5getPhases.<locals>.InSelectInTablePhase.startTagTablecSs|jjd�|�Srr�r�r)r)r*r�c	sz5getPhases.<locals>.InSelectInTablePhase.startTagOthercSs@|j�dd|di�|jj|ddd�r<|�td��|SdS)Nz3unexpected-table-element-end-tag-in-select-in-tabler@r�r�r�)rLrr>r�r�r�r�r)r)r*r�f	sz3getPhases.<locals>.InSelectInTablePhase.endTagTablecSs|jjd�|�Srr�r�r)r)r*r�l	sz3getPhases.<locals>.InSelectInTablePhase.endTagOtherN)
r9r:r;rKr�r�rer�r�r�r)r�r)r*�InSelectInTablePhaseH	src-s�eZdZeddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,g,�Z�fd-d.�Zd/d0�Z�fd1d2�Zd3d4�Zd5d6�Z	d7S)8z(getPhases.<locals>.InForeignContentPhaser9r:r r�r�r!r;r6r+r$r7r<rHZh1Zh2Zh3Zh4Zh5Zh6r�rMr>rIr5r3r,r5rEr.r(r2r�r?r@�spanrBrA�subZsupr�rCrDr1�varcs��|||�dSr.)rKr�r�r)r*rKy	sz1getPhases.<locals>.InForeignContentPhase.__init__c%Ssnddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%�$}|d&|krj||d&|d&<dS)'NZaltGlyphZaltGlyphDefZaltGlyphItemZanimateColorZ
animateMotionZanimateTransformZclipPathZfeBlendZ
feColorMatrixZfeComponentTransferZfeCompositeZfeConvolveMatrixZfeDiffuseLightingZfeDisplacementMapZfeDistantLightZfeFloodZfeFuncAZfeFuncBZfeFuncGZfeFuncRZfeGaussianBlurZfeImageZfeMergeZfeMergeNodeZfeMorphologyZfeOffsetZfePointLightZfeSpecularLightingZfeSpotLightZfeTileZfeTurbulenceZ
foreignObjectZglyphRefZlinearGradientZradialGradientZtextPath)$ZaltglyphZaltglyphdefZaltglyphitemZanimatecolorZ
animatemotionZanimatetransformZclippathZfeblendZ
fecolormatrixZfecomponenttransferZfecompositeZfeconvolvematrixZfediffuselightingZfedisplacementmapZfedistantlightZfefloodZfefuncaZfefuncbZfefuncgZfefuncrZfegaussianblurZfeimageZfemergeZfemergenodeZfemorphologyZfeoffsetZfepointlightZfespecularlightingZfespotlightZfetileZfeturbulenceZ
foreignobjectZglyphrefZlineargradientZradialgradientZtextpathr@r))rCr��replacementsr)r)r*�adjustSVGTagNames|	sN�%z:getPhases.<locals>.InForeignContentPhase.adjustSVGTagNamescsL|ddkrd|d<n&|jjr<tdd�|dD��r<d|j_��||�dS)Nrwr�u�css|]}|tkVqdSr.r�r�r)r)r*r��	szMgetPhases.<locals>.InForeignContentPhase.processCharacters.<locals>.<genexpr>F)rLrcr�r�r�r�r)r*r��	s
�z:getPhases.<locals>.InForeignContentPhase.processCharacterscSs.|jjd}|d|jksD|ddkr�t|d���tdddg�@r�|j�dd|di�|jjdj|jjkr�|j�	|jjd�s�|j�
|jjd�s�|jj��qZ|S|jtd	kr�|j�
|�n$|jtd
kr�|�|�|j�|�|j�|�|j|d<|j�|�|d�r*|jj��d
|d<dS)Nrvr@r=rwZcolorZface�sizez*unexpected-html-element-in-foreign-contentrhryrjr{Tr|)r>r~�breakoutElements�set�keysrLrrjr�rorprrrr
rrr�)rCr�r�r)r)r*r��	s:
��
����


z8getPhases.<locals>.InForeignContentPhase.processStartTagcSs�t|jj�d}|jjd}|j�t�|dkrF|j�dd|di�|j�t�|dkr�|jj|jj	dkr�|jj�
�|jjj|j_|jj��|kr�q�d}q�|d8}|jj|}|j
|jjkr�qFqF|jj�|�}q�qF|S)Nrrvr@r
r�)r�r>r~r@rlrrLrr`rIr�r�rrjr�r�)rCr�Z	nodeIndexr�r�r)r)r*r��	s&z6getPhases.<locals>.InForeignContentPhase.processEndTagN)
r9r:r;r�rrKr
r�r�r�r)r�r)r*�InForeignContentPhaseo	s\�	)rcsPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)z!getPhases.<locals>.AfterBodyPhasecsN��|||�t�d|jfg�|_|j|j_t�d|jfg�|_|j	|j_dS�Nr�)
rKr
r�r�r�r�r�rvr�r�r�r�r)r*rK�	s�
z*getPhases.<locals>.AfterBodyPhase.__init__cSsdSr.r)rBr)r)r*r��	sz,getPhases.<locals>.AfterBodyPhase.processEOFcSs|j�||jjd�dS)Nrr�r�r)r)r*r��	sz0getPhases.<locals>.AfterBodyPhase.processCommentcSs |j�d�|jjd|j_|S)Nzunexpected-char-after-bodyr��rLrrIr`r�r)r)r*r��	sz3getPhases.<locals>.AfterBodyPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��	sz.getPhases.<locals>.AfterBodyPhase.startTagHtmlcSs*|j�dd|di�|jjd|j_|S)Nzunexpected-start-tag-after-bodyr@r�rr�r)r)r*r��	s

�z/getPhases.<locals>.AfterBodyPhase.startTagOthercSs*|jjr|j�d�n|jjd|j_dS)Nz'unexpected-end-tag-after-body-innerhtml�afterAfterBody)rLrSrrIr`)rCr@r)r)r*rv
sz,getPhases.<locals>.AfterBodyPhase.endTagHtmlcSs*|j�dd|di�|jjd|j_|S)Nzunexpected-end-tag-after-bodyr@r�rr�r)r)r*r�
s

�z-getPhases.<locals>.AfterBodyPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�rvr�r)r�r)r*�AfterBodyPhase�	srcsXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z"getPhases.<locals>.InFramesetPhasecsf��|||�t�d|jfd|jfd|jfd|jfg�|_|j|j_	t�d|j
fg�|_|j|j_	dS)Nr�r�rVr�)
rKr
r�r�r�
startTagFrame�startTagNoframesr�r�r��endTagFramesetr�r�r�r�r)r*rK
s�
�z+getPhases.<locals>.InFramesetPhase.__init__cSs$|jjdjdkr |j�d�ndS)Nrvr�zeof-in-framesetr�rBr)r)r*r�#
sz-getPhases.<locals>.InFramesetPhase.processEOFcSs|j�d�dS)Nzunexpected-char-in-framesetr�r�r)r)r*r�)
sz4getPhases.<locals>.InFramesetPhase.processCharacterscSs|j�|�dSr.)r>r�r�r)r)r*r,
sz3getPhases.<locals>.InFramesetPhase.startTagFramesetcSs|j�|�|jj��dSr.rr�r)r)r*r/
sz0getPhases.<locals>.InFramesetPhase.startTagFramecSs|jjd�|�Sr�r�r�r)r)r*r3
sz3getPhases.<locals>.InFramesetPhase.startTagNoframescSs|j�dd|di�dS)Nz unexpected-start-tag-in-framesetr@r�r�r)r)r*r�6
s
�z0getPhases.<locals>.InFramesetPhase.startTagOthercSsZ|jjdjdkr |j�d�n|jj��|jjsV|jjdjdkrV|jjd|j_dS)Nrvr�z)unexpected-frameset-in-frameset-innerhtmlr��
afterFrameset)	r>r~r@rLrrrSrIr`r�r)r)r*r:
s�z1getPhases.<locals>.InFramesetPhase.endTagFramesetcSs|j�dd|di�dS)Nzunexpected-end-tag-in-framesetr@r�r�r)r)r*r�F
s
�z.getPhases.<locals>.InFramesetPhase.endTagOtherN)r9r:r;rKr�r�rrrr�rr�r)r�r)r*�InFramesetPhase
srcsHeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dS)z%getPhases.<locals>.AfterFramesetPhasecsV��|||�t�d|jfd|jfg�|_|j|j_t�d|jfg�|_	|j
|j	_dS�Nr�r�)rKr
r�r�rr�r�r�rvr�r�r�r�r)r*rKL
s�
�z.getPhases.<locals>.AfterFramesetPhase.__init__cSsdSr.r)rBr)r)r*r�Z
sz0getPhases.<locals>.AfterFramesetPhase.processEOFcSs|j�d�dS)Nzunexpected-char-after-framesetr�r�r)r)r*r�^
sz7getPhases.<locals>.AfterFramesetPhase.processCharacterscSs|jjd�|�Srr�r�r)r)r*ra
sz6getPhases.<locals>.AfterFramesetPhase.startTagNoframescSs|j�dd|di�dS)Nz#unexpected-start-tag-after-framesetr@r�r�r)r)r*r�d
s
�z3getPhases.<locals>.AfterFramesetPhase.startTagOthercSs|jjd|j_dS)N�afterAfterFrameset)rLrIr`r�r)r)r*rvh
sz0getPhases.<locals>.AfterFramesetPhase.endTagHtmlcSs|j�dd|di�dS)Nz!unexpected-end-tag-after-framesetr@r�r�r)r)r*r�k
s
�z1getPhases.<locals>.AfterFramesetPhase.endTagOtherN)
r9r:r;rKr�r�rr�rvr�r)r�r)r*�AfterFramesetPhaseJ
srcsPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)z&getPhases.<locals>.AfterAfterBodyPhasecs0��|||�t�d|jfg�|_|j|j_dSr)rKr
r�r�r�r�r�r�r�r)r*rKp
s
�z/getPhases.<locals>.AfterAfterBodyPhase.__init__cSsdSr.r)rBr)r)r*r�x
sz1getPhases.<locals>.AfterAfterBodyPhase.processEOFcSs|j�||jj�dSr.r�r�r)r)r*r�{
sz5getPhases.<locals>.AfterAfterBodyPhase.processCommentcSs|jjd�|�Sr�rr�r)r)r*r�~
sz=getPhases.<locals>.AfterAfterBodyPhase.processSpaceCharacterscSs |j�d�|jjd|j_|S)N�expected-eof-but-got-charr�rr�r)r)r*r��
sz8getPhases.<locals>.AfterAfterBodyPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��
sz3getPhases.<locals>.AfterAfterBodyPhase.startTagHtmlcSs*|j�dd|di�|jjd|j_|S)N�expected-eof-but-got-start-tagr@r�rr�r)r)r*r��
s

�z4getPhases.<locals>.AfterAfterBodyPhase.startTagOthercSs*|j�dd|di�|jjd|j_|S)N�expected-eof-but-got-end-tagr@r�rr�r)r)r*r��
s

�z4getPhases.<locals>.AfterAfterBodyPhase.processEndTagN)r9r:r;rKr�r�r�r�r�r�r�r)r�r)r*�AfterAfterBodyPhaseo
srcsXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z*getPhases.<locals>.AfterAfterFramesetPhasecs8��|||�t�d|jfd|jfg�|_|j|j_dSr)rKr
r�r��startTagNoFramesr�r�r�r�r�r)r*rK�
s�z3getPhases.<locals>.AfterAfterFramesetPhase.__init__cSsdSr.r)rBr)r)r*r��
sz5getPhases.<locals>.AfterAfterFramesetPhase.processEOFcSs|j�||jj�dSr.r�r�r)r)r*r��
sz9getPhases.<locals>.AfterAfterFramesetPhase.processCommentcSs|jjd�|�Sr�rr�r)r)r*r��
szAgetPhases.<locals>.AfterAfterFramesetPhase.processSpaceCharacterscSs|j�d�dS)Nrr�r�r)r)r*r��
sz<getPhases.<locals>.AfterAfterFramesetPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��
sz7getPhases.<locals>.AfterAfterFramesetPhase.startTagHtmlcSs|jjd�|�Srr�r�r)r)r*r �
sz;getPhases.<locals>.AfterAfterFramesetPhase.startTagNoFramescSs|j�dd|di�dS)Nrr@r�r�r)r)r*r��
s
�z8getPhases.<locals>.AfterAfterFramesetPhase.startTagOthercSs|j�dd|di�dS)Nrr@r�r�r)r)r*r��
s
�z8getPhases.<locals>.AfterAfterFramesetPhase.processEndTagN)r9r:r;rKr�r�r�r�r�r r�r�r)r�r)r*�AfterAfterFramesetPhase�
s	r!)rWrVr�r�rr	r�r�r�r�r�r�r�r�r�r�r�rzr�r�rrr)r)rJrYr�r�r�r�rrrr�r�r�r�r�r�r�r�r�rrrrrrrr!r)r�r*rH�sr)#.g@CX!-GBbYLd's/9%&&�rHcs>t|d�t��@}|r:t�fdd�|d��D��|d<dS)Nrwc3s"|]\}}��||�|fVqdSr.)r�)r?�k�v�r	r)r*r��
s�z$adjust_attributes.<locals>.<genexpr>)rrr/)r�r	Zneeds_adjustmentr)r$r*r��
s

�r�rsFcCs|dkri}t||||d�S)N)r3r@rwr{)r)r@r3rkr{r)r)r*r��
s

�r�c@seZdZdZdS)ruzError in parsed documentN)r9r:r;r�r)r)r)r*ru�
sru)rT)r+rT)rsNF).Z
__future__rrrZpip._vendor.sixrrr1�collectionsrr�r	r
rZtreebuilders.baserr
Z	constantsrrrrrrrrrrrrr�rrrrr#r-r=rGr"ZmemoizerHr�r��	Exceptionrur)r)r)r*�<module>sPH

G
K�
site-packages/pip/_vendor/html5lib/__pycache__/constants.cpython-38.opt-1.pyc000064400000201415151446177000023053 0ustar00U

��.e>F��@s�-ddlmZmZmZddlZdZddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d,d,d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d���Zd�d�d�d�d�d�d��Zeed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fg�Z	eed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fg�Z
eed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fgN�Zeed�d�fed�d�fed�d�fed�d�fg�Zeed�d�fed�d�fed�d�fed�d�fed�d�fg�Z
d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d'�d(�d)�d*�d+�d,�d-�d.�>Z�d/�d0iZ�d1�d2e�d1f�d1�d3e�d1f�d1�d4e�d1f�d1�d5e�d1f�d1�d6e�d1f�d1d�e�d1f�d1�d7e�d1f�d8d�e�d8f�d8�d9e�d8f�d8�d:e�d8fd�d;e�d;f�d;�d1e�d;f�d<�Ze�d=�d>�e��D��Ze�d?�d@�dA�dB�dCg�Zed�d�d�d�d�g�Zeej�Zeej�Zeej�Zeej�Zeej�Ze�dD�d>�ejD��Z�dEZ ed�d��dFd�d�d�d�d�d�d�d�d�dԐdG�dHg�Z!ed�d�g�Z"ed�d�d�d�d�d�d�g�Z#e�dI�dJg�e�dKg�e�dLg�e�dM�dNg�e�dM�dNg�e�dO�dPg�e�dQg�e�dR�dSg�e�dT�dS�dU�dVg�e�dWg�e�dXg�e�dS�dYg�e�dS�dY�dZg�e�dS�dYg�e�dS�d[g�e�dS�dY�d\�d[�dU�dLg�e�dS�dY�d[�dRg�e�dS�dYg�e�d]g��d^�Z$�d_Z%e�d`�da�db�dc�ddg�Z&�de�de�df�df�dg�dg�dh�di�di�dj�dk�dl�dl�dm�dn�do�dp�dq�dr�ds�ds�dt�du�dv�dv�dw�dw�dx�dy�dz�d{�d|�d}�d~�d�d��d��d}�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdȐdɐdʐdːd̐d͐dΐdϐdАdѐdҐd��dӐdԐdՐd֐d֐dאdאdؐdِdِdڐdېdܐdݐdݐdސdߐd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d��d��d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d �d!�d"�d#�d$�d%�d&�d'�d(�d)�d*�d*�d+�d,�d-�d.�d/�d0�d1�d2�d3�d4�d5�d6�d7�d8�d9�d:�d;�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dF�dG�dH�dI�dJ�dK�dL�dM�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dW�dX�dY�dZ�d[�d��d��d\�d]�d^�d_�d`�da�db�dc�dd�de�df�dg�dh�d��d��d��di�dj�dk�d?�dl�dm�dn�do�dp�dq�dr�ds�dt�du�dr�dv�dw�dx�dy�dz�d{�d|�d|�d|�d|�d	�dn�d@�d}�d~�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdǐdȐdȐdɐdʐdʐdːd̐d͐dΐdϐdАdѐdҐdӐdԐd�dՐd֐dאdؐdِdڐdېdܐd��dݐdސdߐd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d��d�d�d�d�d�d�d�d�d��d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�d�d�dƐdE�d�d�d�d�d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d&�d'�d(�d)�d*�d+�d�d,�d-�d.�d/�d-�d0�d0�d1�d2�d3�d?�d4�d5�d6�d7�d8�d9�d:�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dE�dF�dG�dH�dI�dJ�dJ�dK�dL�dM�dN�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dW�d�dX�dY�dZ�d[�d\�d]�dÐdĐd^�d_�d`�da�db�dc�dd�de�de�df�dg�dh�di�dj�dk�dl�dl�dm�dn�do�dp�dq�dr�ds�dt�du�dv�dw�dx�dy�dz�d{�d|�d}�d~�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d|�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��dr�d��d��d��d��d��d��d��d��df�df�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ds�d��d��d��d@�d��d��d��d��d��d@�d��d��d��d��d��d@�d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdȐdɐdɐdR�dʐdÐdːd̐d|�d|�d͐dĐd}�dΐdϐdАdѐd!�dҐdT�dӐdԐdՐd֐dאdؐdِdڐdk�dw�dېdܐd�dݐdސdߐd�d�d�d�d�d�d�d�d�d�d\�d\�d�d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d��d�d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�dŐd��d�d�d�d�dƐdǐd�d�d�d�d�d��d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d�d'�d(�d)�d)�d*�d+�d,�d-�d��d��d.�d/�d/�d��d0�d1�d2�d2�d3�d4�d5�d6�d7�d8�d9�d�d:�d;�d<�d=�d7�d>�d?�d@�dA�dA�dB�du�du�dC�dD�dE�d�dE�d��d?�dF�d��dG�d��d��d��dH�dI�dJ�dK�dL�dM�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dW�dX�dY�dZ�d[�d\�d]�d^�d_�dS�dT�d`�da�db�db�dU�d^�d`�da�d��dc�dd�d��de�df�dg�dƐdh�dP�di�d��dj�dk�d��d��dl�dm�dn�dn�do�dp�dq�dr�dK�d��d��d��ds�ds�d��dt�du�dv�dv�dv�dw�dw�dx�dy�dz�d{�d|�d��d��d}�d~�d�d��dz�dƐdl�dK�d��d�d��d��d��d��d��d��d��d��dސdȐd�d��d��d��dm�d}�d��d��d��d��d��d��d��d��d��d��d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d�d��d��d��d��d��d��d��d��d��d��d��d�d��d��d��d��d��d��d��d�d�d�d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐd�dƐdǐdȐdɐdɐdʐdːdːd̐d͐dΐdϐdАdѐdѐdҐdӐdԐdՐd֐dאdؐdِdڐd�dېdܐdݐdt�dސdߐd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d	�d��d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d�d��d��d��d��d��d��d��d��d��dސd��d��d�dېd�d�d��d��d��dq�dɐd�d��dN�d��d�d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�dh�d�d�d"�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d�d�d'�d�d�d �d!�dސd"�d#�d$�d�d �d%�d��d%�d&�d'�d(�d)�d*�d+�d'�d,�d,�d-�dސd.�d/�d0�d1�dސd#�d2�d3�d4�d4�d5�d6�d7�d8�d9�d:�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dF�dd�d��dG�dH�d]�dI�dJ�dK�dL�d?�dM�dD�dN�dD�dO�dP�dP�dE�dF�dQ�dR�d�dS�dT�dU�dV�dW�dX�dY�dZ�d[�d\�d]�d^�d_�d`�da�db�dc�dH�d]�dd�de�dÐd̐df�dg�dh�di�dE�dV�d̐dZ�dj�dN�dG�d�d�dk�d\�di�d]�d`�d`�dl�dm�dn�do�dp�dq�dO�dr�d\�dI�d^�da�ds�dM�dt�d^�du�d̐dZ�dv�dw�dx�dn�dj�dy�dy�dz�d{�d|�d|�d}�d~�d~�d�d�d}�d��d��d��dI�df�dg�d��dh�dS�d��d��d��d��d��d��dP�d��d��dܐd��d��dG�d��d�d��d��d��d��d��dl�da�d��d��d^�dĐd��d��d;�d;�d��d��dr�dk�d��d��d��d��d��dU�dߐd��d��d��d��d��d��d��d��d��d��d��d��dҐdQ�d]�d��d��d��d��d��d��d��d��d��dm�d��d��d��d��d��d�d~�d��d��d�dt�d��d��dt�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddd��d�d�d��d��dÐdĐdŐd��dƐdǐdȐdɐd��dʐdːd_�d_�d̐d��d͐d��d��d��dΐd��d��d��d��d��d��d��d��d��d��dϐdАd�dѐdҐd�dӐd��dԐdՐd֐d��dՐdϐd��dԐd��d��d��d��d��d��d��d��dאdؐdؐd��dِdڐd��dېdܐd��d��dݐdސd��d��dߐd�d�d��d��d��d��d��d��d�d�d�d�d��d��d��d��d��d�d��d��d��d��d��d��d��d��d��d�d�d��d��d��d�d��d��d�d�d��d��d��d�d��d�d�d��d��d��d��d��d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d^�d^�d��d:�d�d�d;�d<�d�d�d�d=�d�d�d��d�d�d�d�d	�d
�d
�d�d�d��d��d8�d
�d�dːd�d�d�d�d�d��d�d�d�d��d�d9�d�d�d�d�d�d�d�d�d�d�d�d�d �d �d!�d"�d"�d��d#�d$�d$�d%�dŐd&�d&�dŐd'�d(�dϐd)�d*�d+�d,�d\�d-�d.�d/�d0�dr�d1�d2�dƐd3�d�d4�d�d5�d6�d	�d7�d�d8�d9�dԐdԐd:�d;�dԐd<�d=�d>�d>�dאd?�d@�dِdؐdאd@�dِdؐdA�dB�dC�dڐdD�dՐdB�dA�dC�dܐdE�dF�dG�dݐdݐdڐdH�dI�dJ�dK�dL�d�dM�dN�dO�d�dP�dQ�d��d�d�d
�d��dR�di�dS�dT�dU�d�dV�d�dW�dX�d�dY�dY�d�dZ�d�d[�d\�d]�d�d��d^�d_�d`�da�db�dc�d�dېdd�de�df�dg�dh�di�dj�dk�d��de�dl�dm�dn�d��d��do�d�d�d�d�dp�d�d�dq�d��dr�dϐd�ds�dt�du�d�d`�dϐd�d��d�dv�da�dw�dx�d��d��d�dy�dz�dz�d{�d|�d}�d��d~�d�d��d��d��d��d��dv�d��d��d�df�d��d��dw�d��d��d�d�d��d��d��d��d��d(�d��d��d��d*�d)�d��d��d��d��d��d��d+�d��d��d��d��d��d�dk�dk�d��d��d��d��dx�dx�d��d��dِd��d��d��dm�dŐd��d��d��d��d��d=�d��d>�d>�d��d��d��d��d��d��d��dE�dx�d��d��dm�d��d��d��d��d��d��d��d��d��d��d��dŐd�d��d#�d��d�d �d�d �d!�d"�d!�d"�d�d�d�d�d�d��dx�d��d%�d��dאd��d0�d��d��d��d��d'�d��d��ddÐdĐdŐd��d'�d��dÐddƐdǐdȐd(�d��d*�d)�d��d��d��d+�d,�dɐdʐdʐdːdːd̐d̐d.�d͐dΐdϐd/�dАdѐdҐdӐdԐdՐd֐dאd.�d/�d͐d֐dՐdؐdِdڐdېd�dj�dj�dܐdݐdݐdސdߐd͐d�d�d�dB�d�d�d9�d9�d�d�d�d@�d=�d<�d@�d=�d�d�d��d�d�d
�d�d�d�d͐dѐd�d�d�d�d��d�d1�d�d��d��dU�d�d��d�d�d�d�d�d��d��d��d��d��d��d��dАd@�d�dÐd��d��d��d�d��d��d�d�d�dY�d�d[�d�d�d�d�dX�d�d�d�d�d�d	�d
�d��d��d�d�d�dZ�dX�d�dU�d
�d`�d
�d�d�d�d�d�d�d�d�d�d�dݐd�d�d�d�dĐd�d�dd�d��d>�d��d0�d3�dݐdZ�du�d��d�d�d�d�d�dS�d��d�d��d�d �d!�d"�dn�dn�d#�dS�d��d��d$�dݐd��d%�d�d�d�d�d&�d'�d(�d��d)�d*�d+�d,�d*�dp�dp�d-�d!�dҐdT�dؐd.�d��dg�d/�d��df�d��d0�dӐd1�dԐdՐd��dh�d2�d֐dڐdِdk�dw�d3�d3�d4�d5�d6�d7�d7�d8�d9�d:�d;�d<�d=�d=�d>�d?�d@�dA�d��dB�dC�dD�dE�dF�dG�dH�dI�dJ���Z'�dK�dC�d��dL�d��dĐd̐d�df�d��d6�d,�d�d��d��dM�d��dN�dO�dĐd��dÐd��d�dɐd��d��d1�d��d��d�dP�d?�d��dQ�"Z(d�dR�dS�dT�dU�dV�dW�dX�dY�Z)ee)�dZe)�d[e)�d\g�Z*e�d]�d>�e��D��Z+�d^e+d�<G�d_�d`��d`e,�Z-G�da�db��dbe.�Z/dS(c�)�absolute_import�division�unicode_literalsNz5Null character in input stream, replaced with U+FFFD.zInvalid codepoint in stream.z&Solidus (/) incorrectly placed in tag.z.Incorrect CR newline entity, replaced with LF.z9Entity used with illegal number (windows-1252 reference).zPNumeric entity couldn't be converted to character (codepoint U+%(charAsInt)08x).zBNumeric entity represents an illegal codepoint: U+%(charAsInt)08x.z#Numeric entity didn't end with ';'.z1Numeric entity expected. Got end of file instead.z'Numeric entity expected but none found.z!Named entity didn't end with ';'.z Named entity expected. Got none.z'End tag contains unexpected attributes.z.End tag contains unexpected self-closing flag.z#Expected tag name. Got '>' instead.zSExpected tag name. Got '?' instead. (HTML doesn't support processing instructions.)z-Expected tag name. Got something else insteadz6Expected closing tag. Got '>' instead. Ignoring '</>'.z-Expected closing tag. Unexpected end of file.z<Expected closing tag. Unexpected character '%(data)s' found.z'Unexpected end of file in the tag name.z8Unexpected end of file. Expected attribute name instead.z)Unexpected end of file in attribute name.z#Invalid character in attribute namez#Dropped duplicate attribute on tag.z1Unexpected end of file. Expected = or end of tag.z1Unexpected end of file. Expected attribute value.z*Expected attribute value. Got '>' instead.z"Unexpected = in unquoted attributez*Unexpected character in unquoted attributez*Unexpected character after attribute name.z+Unexpected character after attribute value.z.Unexpected end of file in attribute value (").z.Unexpected end of file in attribute value (').z*Unexpected end of file in attribute value.z)Unexpected end of file in tag. Expected >z/Unexpected character after / in tag. Expected >z&Expected '--' or 'DOCTYPE'. Not found.z Unexpected ! after -- in commentz$Unexpected space after -- in commentzIncorrect comment.z"Unexpected end of file in comment.z%Unexpected end of file in comment (-)z+Unexpected '-' after '--' found in comment.z'Unexpected end of file in comment (--).z&Unexpected character in comment found.z(No space after literal string 'DOCTYPE'.z.Unexpected > character. Expected DOCTYPE name.z.Unexpected end of file. Expected DOCTYPE name.z'Unexpected end of file in DOCTYPE name.z"Unexpected end of file in DOCTYPE.z%Expected space or '>'. Got '%(data)s'zUnexpected end of DOCTYPE.z Unexpected character in DOCTYPE.zXXX innerHTML EOFzUnexpected DOCTYPE. Ignored.z%html needs to be the first start tag.z)Unexpected End of file. Expected DOCTYPE.zErroneous DOCTYPE.z2Unexpected non-space characters. Expected DOCTYPE.z2Unexpected start tag (%(name)s). Expected DOCTYPE.z0Unexpected end tag (%(name)s). Expected DOCTYPE.z?Unexpected end tag (%(name)s) after the (implied) root element.z4Unexpected end of file. Expected end tag (%(name)s).z4Unexpected start tag head in existing head. Ignored.z'Unexpected end tag (%(name)s). Ignored.z;Unexpected start tag (%(name)s) that can be in head. Moved.z Unexpected start tag (%(name)s).zMissing end tag (%(name)s).zMissing end tags (%(name)s).zCUnexpected start tag (%(startName)s) implies end tag (%(endName)s).z@Unexpected start tag (%(originalName)s). Treated as %(newName)s.z,Unexpected start tag %(name)s. Don't use it!z'Unexpected start tag %(name)s. Ignored.zEUnexpected end tag (%(gotName)s). Missing end tag (%(expectedName)s).z:End tag (%(name)s) seen too early. Expected other end tag.zFUnexpected end tag (%(gotName)s). Expected end tag (%(expectedName)s).z+End tag (%(name)s) seen too early. Ignored.zQEnd tag (%(name)s) violates step 1, paragraph 1 of the adoption agency algorithm.zQEnd tag (%(name)s) violates step 1, paragraph 2 of the adoption agency algorithm.zQEnd tag (%(name)s) violates step 1, paragraph 3 of the adoption agency algorithm.zQEnd tag (%(name)s) violates step 4, paragraph 4 of the adoption agency algorithm.z>Unexpected end tag (%(originalName)s). Treated as %(newName)s.z'This element (%(name)s) has no end tag.z9Unexpected implied end tag (%(name)s) in the table phase.z>Unexpected implied end tag (%(name)s) in the table body phase.zDUnexpected non-space characters in table context caused voodoo mode.z3Unexpected input with type hidden in table context.z!Unexpected form in table context.zDUnexpected start tag (%(name)s) in table context caused voodoo mode.zBUnexpected end tag (%(name)s) in table context caused voodoo mode.zCUnexpected table cell start tag (%(name)s) in the table body phase.zFGot table cell end tag (%(name)s) while required end tags are missing.z?Unexpected end tag (%(name)s) in the table body phase. Ignored.z=Unexpected implied end tag (%(name)s) in the table row phase.z>Unexpected end tag (%(name)s) in the table row phase. Ignored.zJUnexpected select start tag in the select phase treated as select end tag.z/Unexpected input start tag in the select phase.zBUnexpected start tag token (%(name)s in the select phase. Ignored.z;Unexpected end tag (%(name)s) in the select phase. Ignored.zKUnexpected table element start tag (%(name)s) in the select in table phase.zIUnexpected table element end tag (%(name)s) in the select in table phase.z8Unexpected non-space characters in the after body phase.z>Unexpected start tag token (%(name)s) in the after body phase.z<Unexpected end tag token (%(name)s) in the after body phase.z@Unexpected characters in the frameset phase. Characters ignored.zEUnexpected start tag token (%(name)s) in the frameset phase. Ignored.zFUnexpected end tag token (frameset) in the frameset phase (innerHTML).zCUnexpected end tag token (%(name)s) in the frameset phase. Ignored.zEUnexpected non-space characters in the after frameset phase. Ignored.zEUnexpected start tag (%(name)s) in the after frameset phase. Ignored.zCUnexpected end tag (%(name)s) in the after frameset phase. Ignored.z(Unexpected end tag after body(innerHtml)z6Unexpected non-space characters. Expected end of file.z6Unexpected start tag (%(name)s). Expected end of file.z4Unexpected end tag (%(name)s). Expected end of file.z/Unexpected end of file. Expected table content.z0Unexpected end of file. Expected select content.z2Unexpected end of file. Expected frameset content.z0Unexpected end of file. Expected script content.z0Unexpected end of file. Expected foreign contentz0Trailing solidus not allowed on element %(name)sz2Element %(name)s not allowed in a non-html contextz*Unexpected end tag (%(name)s) before html.z9Element %(name)s not allowed in a inhead-noscript contextz8Unexpected end of file. Expected inhead-noscript contentz@Unexpected non-space character. Expected inhead-noscript contentz0Undefined error (this sucks and should be fixed))�znull-characterzinvalid-codepointzincorrectly-placed-soliduszincorrect-cr-newline-entityzillegal-windows-1252-entityzcant-convert-numeric-entityz$illegal-codepoint-for-numeric-entityz numeric-entity-without-semicolonz#expected-numeric-entity-but-got-eofzexpected-numeric-entityznamed-entity-without-semicolonzexpected-named-entityzattributes-in-end-tagzself-closing-flag-on-end-tagz'expected-tag-name-but-got-right-bracketz'expected-tag-name-but-got-question-markzexpected-tag-namez*expected-closing-tag-but-got-right-bracketz expected-closing-tag-but-got-eofz!expected-closing-tag-but-got-charzeof-in-tag-namez#expected-attribute-name-but-got-eofzeof-in-attribute-namez#invalid-character-in-attribute-namezduplicate-attributez$expected-end-of-tag-name-but-got-eofz$expected-attribute-value-but-got-eofz.expected-attribute-value-but-got-right-bracketz"equals-in-unquoted-attribute-valuez0unexpected-character-in-unquoted-attribute-valuez&invalid-character-after-attribute-namez*unexpected-character-after-attribute-valuez#eof-in-attribute-value-double-quotez#eof-in-attribute-value-single-quotez eof-in-attribute-value-no-quotesz#unexpected-EOF-after-solidus-in-tagz)unexpected-character-after-solidus-in-tagzexpected-dashes-or-doctypez,unexpected-bang-after-double-dash-in-commentz-unexpected-space-after-double-dash-in-commentzincorrect-commentzeof-in-commentzeof-in-comment-end-dashz,unexpected-dash-after-double-dash-in-commentzeof-in-comment-double-dashzeof-in-comment-end-space-statezeof-in-comment-end-bang-statezunexpected-char-in-commentzneed-space-after-doctypez+expected-doctype-name-but-got-right-bracketz!expected-doctype-name-but-got-eofzeof-in-doctype-namezeof-in-doctypez*expected-space-or-right-bracket-in-doctypezunexpected-end-of-doctypezunexpected-char-in-doctypezeof-in-innerhtmlzunexpected-doctypez
non-html-rootzexpected-doctype-but-got-eofzunknown-doctypezexpected-doctype-but-got-charsz"expected-doctype-but-got-start-tagz expected-doctype-but-got-end-tagzend-tag-after-implied-rootz&expected-named-closing-tag-but-got-eofz!two-heads-are-not-better-than-onezunexpected-end-tagz#unexpected-start-tag-out-of-my-headzunexpected-start-tagzmissing-end-tagzmissing-end-tagsz$unexpected-start-tag-implies-end-tagzunexpected-start-tag-treated-aszdeprecated-tagzunexpected-start-tag-ignoredz$expected-one-end-tag-but-got-anotherzend-tag-too-earlyzend-tag-too-early-namedzend-tag-too-early-ignoredzadoption-agency-1.1zadoption-agency-1.2zadoption-agency-1.3zadoption-agency-4.4zunexpected-end-tag-treated-asz
no-end-tagz#unexpected-implied-end-tag-in-tablez(unexpected-implied-end-tag-in-table-bodyz$unexpected-char-implies-table-voodooz unexpected-hidden-input-in-tablezunexpected-form-in-tablez)unexpected-start-tag-implies-table-voodooz'unexpected-end-tag-implies-table-voodoozunexpected-cell-in-table-bodyzunexpected-cell-end-tagz unexpected-end-tag-in-table-bodyz'unexpected-implied-end-tag-in-table-rowzunexpected-end-tag-in-table-rowzunexpected-select-in-selectzunexpected-input-in-selectzunexpected-start-tag-in-selectzunexpected-end-tag-in-selectz5unexpected-table-element-start-tag-in-select-in-tablez3unexpected-table-element-end-tag-in-select-in-tablezunexpected-char-after-bodyzunexpected-start-tag-after-bodyzunexpected-end-tag-after-bodyzunexpected-char-in-framesetz unexpected-start-tag-in-framesetz)unexpected-frameset-in-frameset-innerhtmlzunexpected-end-tag-in-framesetzunexpected-char-after-framesetz#unexpected-start-tag-after-framesetz!unexpected-end-tag-after-framesetz'unexpected-end-tag-after-body-innerhtmlzexpected-eof-but-got-charzexpected-eof-but-got-start-tagzexpected-eof-but-got-end-tagzeof-in-tablez
eof-in-selectzeof-in-framesetzeof-in-script-in-scriptzeof-in-foreign-landsz&non-void-element-with-trailing-solidusz*unexpected-html-element-in-foreign-contentzunexpected-end-tag-before-htmlzunexpected-inhead-noscript-tagzeof-in-head-noscriptzchar-in-head-noscriptzXXX-undefined-errorzhttp://www.w3.org/1999/xhtmlz"http://www.w3.org/1998/Math/MathMLzhttp://www.w3.org/2000/svgzhttp://www.w3.org/1999/xlinkz$http://www.w3.org/XML/1998/namespacezhttp://www.w3.org/2000/xmlns/)�html�mathml�svg�xlink�xml�xmlnsrZappletZcaptionZmarquee�object�tableZtdZthr�mi�moZmnZmsZmtextzannotation-xmlrZ
foreignObjectZdesc�title�a�bZbig�codeZemZfont�iZnobr�sZsmallZstrikeZstrongZtt�uZaddressZareaZarticleZaside�baseZbasefontZbgsoundZ
blockquoteZbody�br�button�center�colZcolgroup�commandZdd�details�dirZdivZdlZdtZembed�fieldsetZfigureZfooterZform�frameZframeset�h1�h2�h3�h4�h5�h6�head�header�hr�iframeZimage�img�inputZisindexZli�linkZlisting�menu�metaZnavZnoembedZnoframesZnoscriptZol�pZparamZ	plaintextZpre�scriptZsection�select�styleZtbodyZtextareaZtfootZtheadZtrZulZwbrZxmpZ
attributeNameZ
attributeTypeZ
baseFrequencyZbaseProfileZcalcModeZ
clipPathUnitsZcontentScriptTypeZcontentStyleTypeZdiffuseConstantZedgeModeZexternalResourcesRequiredZ	filterResZfilterUnitsZglyphRefZgradientTransformZ
gradientUnitsZkernelMatrixZkernelUnitLengthZ	keyPointsZ
keySplinesZkeyTimesZlengthAdjustZlimitingConeAngleZmarkerHeightZmarkerUnitsZmarkerWidthZmaskContentUnitsZ	maskUnitsZ
numOctavesZ
pathLengthZpatternContentUnitsZpatternTransformZpatternUnitsZ	pointsAtXZ	pointsAtYZ	pointsAtZZ
preserveAlphaZpreserveAspectRatioZprimitiveUnitsZrefXZrefYZrepeatCountZ	repeatDurZrequiredExtensionsZrequiredFeaturesZspecularConstantZspecularExponentZspreadMethodZstartOffsetZstdDeviationZstitchTilesZsurfaceScaleZsystemLanguageZtableValuesZtargetXZtargetYZ
textLengthZviewBoxZ
viewTargetZxChannelSelectorZyChannelSelectorZ
zoomAndPan)>Z
attributenameZ
attributetypeZ
basefrequencyZbaseprofileZcalcmodeZ
clippathunitsZcontentscripttypeZcontentstyletypeZdiffuseconstantZedgemodeZexternalresourcesrequiredZ	filterresZfilterunitsZglyphrefZgradienttransformZ
gradientunitsZkernelmatrixZkernelunitlengthZ	keypointsZ
keysplinesZkeytimesZlengthadjustZlimitingconeangleZmarkerheightZmarkerunitsZmarkerwidthZmaskcontentunitsZ	maskunitsZ
numoctavesZ
pathlengthZpatterncontentunitsZpatterntransformZpatternunitsZ	pointsatxZ	pointsatyZ	pointsatzZ
preservealphaZpreserveaspectratioZprimitiveunitsZrefxZrefyZrepeatcountZ	repeatdurZrequiredextensionsZrequiredfeaturesZspecularconstantZspecularexponentZspreadmethodZstartoffsetZstddeviationZstitchtilesZsurfacescaleZsystemlanguageZtablevaluesZtargetxZtargetyZ
textlengthZviewboxZ
viewtargetZxchannelselectorZychannelselectorZ
zoomandpanZ
definitionurlZ
definitionURLrZactuateZarcroleZhrefZroleZshow�typer	ZlangZspacer
)z
xlink:actuatez
xlink:arcrolez
xlink:hrefz
xlink:rolez
xlink:showzxlink:titlez
xlink:typezxml:basezxml:langz	xml:spacer
zxmlns:xlinkcCs"g|]\}\}}}||f|f�qS�r4)�.0Zqname�prefixZlocal�nsr4r4�B/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/constants.py�
<listcomp>
sr9�	�
�� �
cCs g|]}t|�t|���f�qSr4)�ord�lower)r5�cr4r4r8r9#s�)r r!r"r#r$r%zevent-source�sourceZtrackZ
irrelevantZ	itemscopeZscopedZismapZautoplayZcontrolsZdefer�async�openZmultipleZdisabledZhidden�checked�defaultZnoshadeZ
autosubmit�readonlyZselectedZ	autofocusZrequiredZseamless)�r2r*ZaudioZvideor0rZdatagridrr(r-rZoptionZoptgrouprr+r1�outputr)) i� �i i�i i& i  i! i�i0 i`i9 iRrJi}rJrJi i i i i" i i i�i"!iai: iSrJi~ix�lt;�gt;�amp;�apos;�quot;�Æ�&�ÁuĂ�ÂuАu𝔄�ÀuΑuĀu⩓uĄu𝔸u⁡�Åu𝒜u≔�Ã�Äu∖u⫧u⌆uБu∵uℬuΒu𝔅u𝔹u˘u≎uЧ�©uĆu⋒uⅅuℭuČ�ÇuĈu∰uĊ�¸�·uΧu⊙u⊖u⊕u⊗u∲u”u’u∷u⩴u≡u∯u∮uℂu∐u∳u⨯u𝒞u⋓u≍u⤑uЂuЅuЏu‡u↡u⫤uĎuДu∇uΔu𝔇�´u˙u˝�`u˜u⋄uⅆu𝔻�¨u⃜u≐u⇓u⇐u⇔u⟸u⟺u⟹u⇒u⊨u⇑u⇕u∥u↓u⤓u⇵ȗu⥐u⥞u↽u⥖u⥟u⇁u⥗u⊤u↧u𝒟uĐuŊ�Ð�ÉuĚ�ÊuЭuĖu𝔈�Èu∈uĒu◻u▫uĘu𝔼uΕu⩵u≂u⇌uℰu⩳uΗ�Ëu∃uⅇuФu𝔉u◼u▪u𝔽u∀uℱuЃ�>uΓuϜuĞuĢuĜuГuĠu𝔊u⋙u𝔾u≥u⋛u≧u⪢u≷u⩾u≳u𝒢u≫uЪuˇ�^uĤuℌuℋuℍu─uĦu≏uЕuIJuЁ�Í�ÎuИuİuℑ�ÌuĪuⅈu∬u∫u⋂u⁣u⁢uĮu𝕀uΙuℐuĨuІ�ÏuĴuЙu𝔍u𝕁u𝒥uЈuЄuХuЌuΚuĶuКu𝔎u𝕂u𝒦uЉ�<uĹuΛu⟪uℒu↞uĽuĻuЛu⟨u←u⇤u⇆u⌈u⟦u⥡u⇃u⥙u⌊u↔u⥎u⊣u↤u⥚u⊲u⧏u⊴u⥑u⥠u↿u⥘u↼u⥒u⋚u≦u≶u⪡u⩽u≲u𝔏u⋘u⇚uĿu⟵u⟷u⟶u𝕃u↙u↘u↰uŁu≪u⤅uМu uℳu𝔐u∓u𝕄uΜuЊuŃuŇuŅuНu​u𝔑u⁠� uℕu⫬u≢u≭u∦u∉u≠u≂̸u∄u≯u≱u≧̸u≫̸u≹u⩾̸u≵u≎̸u≏̸u⋪u⧏̸u⋬u≮u≰u≸u≪̸u⩽̸u≴u⪢̸u⪡̸u⊀u⪯̸u⋠u∌u⋫u⧐̸u⋭u⊏̸u⋢u⊐̸u⋣u⊂⃒u⊈u⊁u⪰̸u⋡u≿̸u⊃⃒u⊉u≁u≄u≇u≉u∤u𝒩�ÑuΝuŒ�Ó�ÔuОuŐu𝔒�ÒuŌuΩuΟu𝕆u“u‘u⩔u𝒪�Ø�Õu⨷�Öu‾u⏞u⎴u⏜u∂uПu𝔓uΦuΠ�±uℙu⪻u≺u⪯u≼u≾u″u∏u∝u𝒫uΨ�"u𝔔uℚu𝒬u⤐�®uŔu⟫u↠u⤖uŘuŖuРuℜu∋u⇋u⥯uΡu⟩u→u⇥u⇄u⌉u⟧u⥝u⇂u⥕u⌋u⊢u↦u⥛u⊳u⧐u⊵u⥏u⥜u↾u⥔u⇀u⥓uℝu⥰u⇛uℛu↱u⧴uЩuШuЬuŚu⪼uŠuŞuŜuСu𝔖u↑uΣu∘u𝕊u√u□u⊓u⊏u⊑u⊐u⊒u⊔u𝒮u⋆u⋐u⊆u≻u⪰u≽u≿u∑u⋑u⊃u⊇�Þu™uЋuЦuΤuŤuŢuТu𝔗u∴uΘu  u u∼u≃u≅u≈u𝕋u⃛u𝒯uŦ�Úu↟u⥉uЎuŬ�ÛuУuŰu𝔘�ÙuŪ�_u⏟u⎵u⏝u⋃u⊎uŲu𝕌u⤒u⇅u↕u⥮u⊥u↥u↖u↗uϒuΥuŮu𝒰uŨ�Üu⊫u⫫uВu⊩u⫦u⋁u‖u∣�|u❘u≀u u𝔙u𝕍u𝒱u⊪uŴu⋀u𝔚u𝕎u𝒲u𝔛uΞu𝕏u𝒳uЯuЇuЮ�ÝuŶuЫu𝔜u𝕐u𝒴uŸuЖuŹuŽuЗuŻuΖuℨuℤu𝒵�áuău∾u∾̳u∿�âuа�æu𝔞�àuℵuαuāu⨿u∧u⩕u⩜u⩘u⩚u∠u⦤u∡u⦨u⦩u⦪u⦫u⦬u⦭u⦮u⦯u∟u⊾u⦝u∢u⍼uąu𝕒u⩰u⩯u≊u≋�'�åu𝒶�*�ã�äu⨑u⫭u≌u϶u‵u∽u⋍u⊽u⌅u⎶uбu„u⦰uβuℶu≬u𝔟u◯u⨀u⨁u⨂u⨆u★u▽u△u⨄u⤍u⧫u▴u▾u◂u▸u␣u▒u░u▓u█u=⃥u≡⃥u⌐u𝕓u⋈u╗u╔u╖u╓u═u╦u╩u╤u╧u╝u╚u╜u╙u║u╬u╣u╠u╫u╢u╟u⧉u╕u╒u┐u┌u╥u╨u┬u┴u⊟u⊞u⊠u╛u╘u┘u└u│u╪u╡u╞u┼u┤u├�¦u𝒷u⁏�\u⧅u⟈u•u⪮uću∩u⩄u⩉u⩋u⩇u⩀u∩︀u⁁u⩍uč�çuĉu⩌u⩐uċu⦲�¢u𝔠uчu✓uχu○u⧃uˆu≗u↺u↻uⓈu⊛u⊚u⊝u⨐u⫯u⧂u♣�:�,�@u∁u⩭u𝕔u℗u↵u✗u𝒸u⫏u⫑u⫐u⫒u⋯u⤸u⤵u⋞u⋟u↶u⤽u∪u⩈u⩆u⩊u⊍u⩅u∪︀u↷u⤼u⋎u⋏�¤u∱u⌭u⥥u†uℸu‐u⤏uďuдu⇊u⩷�°uδu⦱u⥿u𝔡u♦uϝu⋲�÷u⋇uђu⌞u⌍�$u𝕕u≑u∸u∔u⊡u⌟u⌌u𝒹uѕu⧶uđu⋱u▿u⦦uџu⟿�éu⩮uěu≖�êu≕uэuėu≒u𝔢u⪚�èu⪖u⪘u⪙u⏧uℓu⪕u⪗uēu∅u u u uŋu uęu𝕖u⋕u⧣u⩱uεuϵ�=u≟u⩸u⧥u≓u⥱uℯuη�ð�ëu€�!uфu♀uffiuffufflu𝔣ufiZfju♭uflu▱uƒu𝕗u⋔u⫙u⨍�½u⅓�¼u⅕u⅙u⅛u⅔u⅖�¾u⅗u⅜u⅘u⅚u⅝u⅞u⁄u⌢u𝒻u⪌uǵuγu⪆uğuĝuгuġu⪩u⪀u⪂u⪄u⋛︀u⪔u𝔤uℷuѓu⪒u⪥u⪤u≩u⪊u⪈u⋧u𝕘uℊu⪎u⪐u⪧u⩺u⋗u⦕u⩼u⥸u≩︀uъu⥈u↭uℏuĥu♥u…u⊹u𝔥u⤥u⤦u⇿u∻u↩u↪u𝕙u―u𝒽uħu⁃�í�îuиuе�¡u𝔦�ìu⨌u∭u⧜u℩uijuīuıu⊷uƵu℅u∞u⧝u⊺u⨗u⨼uёuįu𝕚uι�¿u𝒾u⋹u⋵u⋴u⋳uĩuі�ïuĵuйu𝔧uȷu𝕛u𝒿uјuєuκuϰuķuкu𝔨uĸuхuќu𝕜u𝓀u⤛u⤎u⪋u⥢uĺu⦴uλu⦑u⪅�«u⤟u⤝u↫u⤹u⥳u↢u⪫u⤙u⪭u⪭︀u⤌u❲�{�[u⦋u⦏u⦍uľuļuлu⤶u⥧u⥋u↲u≤u⇇u⋋u⪨u⩿u⪁u⪃u⋚︀u⪓u⋖u⥼u𝔩u⪑u⥪u▄uљu⥫u◺uŀu⎰u≨u⪉u⪇u⋦u⟬u⇽u⟼u↬u⦅u𝕝u⨭u⨴u∗u◊�(u⦓u⥭u‎u⊿u‹u𝓁u⪍u⪏u‚ułu⪦u⩹u⋉u⥶u⩻u⦖u◃u⥊u⥦u≨︀u∺�¯u♂u✠u▮u⨩uмu—u𝔪u℧�µu⫰u−u⨪u⫛u⊧u𝕞u𝓂uμu⊸u⋙̸u≫⃒u⇍u⇎u⋘̸u≪⃒u⇏u⊯u⊮uńu∠⃒u⩰̸u≋̸uʼnu♮u⩃uňuņu⩭̸u⩂uнu–u⇗u⤤u≐̸u⤨u𝔫u↮u⫲u⋼u⋺uњu≦̸u↚u‥u𝕟�¬u⋹̸u⋵̸u⋷u⋶u⋾u⋽u⫽⃥u∂̸u⨔u↛u⤳̸u↝̸u𝓃u⊄u⫅̸u⊅u⫆̸�ñuν�#u№u u⊭u⤄u≍⃒u⊬u≥⃒u>⃒u⧞u⤂u≤⃒u<⃒u⊴⃒u⤃u⊵⃒u∼⃒u⇖u⤣u⤧�ó�ôuоuőu⨸u⦼uœu⦿u𝔬u˛�òu⧁u⦵u⦾u⦻u⧀uōuωuοu⦶u𝕠u⦷u⦹u∨u⩝uℴ�ª�ºu⊶u⩖u⩗u⩛�øu⊘�õu⨶�öu⌽�¶u⫳u⫽uп�%�.u‰u‱u𝔭uφuϕu☎uπuϖuℎ�+u⨣u⨢u⨥u⩲u⨦u⨧u⨕u𝕡�£u⪳u⪷u⪹u⪵u⋨u′u⌮u⌒u⌓u⊰u𝓅uψu u𝔮u𝕢u⁗u𝓆u⨖�?u⤜u⥤u∽̱uŕu⦳u⦒u⦥�»u⥵u⤠u⤳u⤞u⥅u⥴u↣u↝u⤚u∶u❳�}�]u⦌u⦎u⦐uřuŗuрu⤷u⥩u↳u▭u⥽u𝔯u⥬uρuϱu⇉u⋌u˚u‏u⎱u⫮u⟭u⇾u⦆u𝕣u⨮u⨵�)u⦔u⨒u›u𝓇u⋊u▹u⧎u⥨u℞uśu⪴u⪸ušuşuŝu⪶u⪺u⋩u⨓uсu⋅u⩦u⇘�§�;u⤩u✶u𝔰u♯uщuш�­uσuςu⩪u⪞u⪠u⪝u⪟u≆u⨤u⥲u⨳u⧤u⌣u⪪u⪬u⪬︀uь�/u⧄u⌿u𝕤u♠u⊓︀u⊔︀u𝓈u☆u⊂u⫅u⪽u⫃u⫁u⫋u⊊u⪿u⥹u⫇u⫕u⫓u♪�¹�²�³u⫆u⪾u⫘u⫄u⟉u⫗u⥻u⫂u⫌u⊋u⫀u⫈u⫔u⫖u⇙u⤪�ßu⌖uτuťuţuтu⌕u𝔱uθuϑ�þ�×u⨱u⨰u⌶u⫱u𝕥u⫚u‴u▵u≜u◬u⨺u⨹u⧍u⨻u⏢u𝓉uцuћuŧu⥣�úuўuŭ�ûuуuűu⥾u𝔲�ùu▀u⌜u⌏u◸uūuųu𝕦uυu⇈u⌝u⌎uůu◹u𝓊u⋰uũ�üu⦧u⫨u⫩u⦜u⊊︀u⫋︀u⊋︀u⫌︀uвu⊻u≚u⋮u𝔳u𝕧u𝓋u⦚uŵu⩟u≙u℘u𝔴u𝕨u𝓌u𝔵uξu⋻u𝕩u𝓍�ýuяuŷuы�¥u𝔶uїu𝕪u𝓎uю�ÿuźužuзużuζu𝔷uжu⇝u𝕫u𝓏u‍u‌(�ZAEligzAElig;ZAMPzAMP;ZAacutezAacute;zAbreve;ZAcirczAcirc;zAcy;zAfr;ZAgravezAgrave;zAlpha;zAmacr;zAnd;zAogon;zAopf;zApplyFunction;ZAringzAring;zAscr;zAssign;ZAtildezAtilde;ZAumlzAuml;z
Backslash;zBarv;zBarwed;zBcy;zBecause;zBernoullis;zBeta;zBfr;zBopf;zBreve;zBscr;zBumpeq;zCHcy;ZCOPYzCOPY;zCacute;zCap;zCapitalDifferentialD;zCayleys;zCcaron;ZCcedilzCcedil;zCcirc;zCconint;zCdot;zCedilla;z
CenterDot;zCfr;zChi;z
CircleDot;zCircleMinus;zCirclePlus;zCircleTimes;zClockwiseContourIntegral;zCloseCurlyDoubleQuote;zCloseCurlyQuote;zColon;zColone;z
Congruent;zConint;zContourIntegral;zCopf;z
Coproduct;z CounterClockwiseContourIntegral;zCross;zCscr;zCup;zCupCap;zDD;z	DDotrahd;zDJcy;zDScy;zDZcy;zDagger;zDarr;zDashv;zDcaron;zDcy;zDel;zDelta;zDfr;zDiacriticalAcute;zDiacriticalDot;zDiacriticalDoubleAcute;zDiacriticalGrave;zDiacriticalTilde;zDiamond;zDifferentialD;zDopf;zDot;zDotDot;z	DotEqual;zDoubleContourIntegral;z
DoubleDot;zDoubleDownArrow;zDoubleLeftArrow;zDoubleLeftRightArrow;zDoubleLeftTee;zDoubleLongLeftArrow;zDoubleLongLeftRightArrow;zDoubleLongRightArrow;zDoubleRightArrow;zDoubleRightTee;zDoubleUpArrow;zDoubleUpDownArrow;zDoubleVerticalBar;z
DownArrow;z
DownArrowBar;zDownArrowUpArrow;z
DownBreve;zDownLeftRightVector;zDownLeftTeeVector;zDownLeftVector;zDownLeftVectorBar;zDownRightTeeVector;zDownRightVector;zDownRightVectorBar;zDownTee;z
DownTeeArrow;z
Downarrow;zDscr;zDstrok;zENG;ZETHzETH;ZEacutezEacute;zEcaron;ZEcirczEcirc;zEcy;zEdot;zEfr;ZEgravezEgrave;zElement;zEmacr;zEmptySmallSquare;zEmptyVerySmallSquare;zEogon;zEopf;zEpsilon;zEqual;zEqualTilde;zEquilibrium;zEscr;zEsim;zEta;ZEumlzEuml;zExists;z
ExponentialE;zFcy;zFfr;zFilledSmallSquare;zFilledVerySmallSquare;zFopf;zForAll;zFouriertrf;zFscr;zGJcy;ZGTzGT;zGamma;zGammad;zGbreve;zGcedil;zGcirc;zGcy;zGdot;zGfr;zGg;zGopf;z
GreaterEqual;zGreaterEqualLess;zGreaterFullEqual;zGreaterGreater;zGreaterLess;zGreaterSlantEqual;z
GreaterTilde;zGscr;zGt;zHARDcy;zHacek;zHat;zHcirc;zHfr;z
HilbertSpace;zHopf;zHorizontalLine;zHscr;zHstrok;z
HumpDownHump;z
HumpEqual;zIEcy;zIJlig;zIOcy;ZIacutezIacute;ZIcirczIcirc;zIcy;zIdot;zIfr;ZIgravezIgrave;zIm;zImacr;zImaginaryI;zImplies;zInt;z	Integral;z
Intersection;zInvisibleComma;zInvisibleTimes;zIogon;zIopf;zIota;zIscr;zItilde;zIukcy;ZIumlzIuml;zJcirc;zJcy;zJfr;zJopf;zJscr;zJsercy;zJukcy;zKHcy;zKJcy;zKappa;zKcedil;zKcy;zKfr;zKopf;zKscr;zLJcy;ZLTzLT;zLacute;zLambda;zLang;zLaplacetrf;zLarr;zLcaron;zLcedil;zLcy;zLeftAngleBracket;z
LeftArrow;z
LeftArrowBar;zLeftArrowRightArrow;zLeftCeiling;zLeftDoubleBracket;zLeftDownTeeVector;zLeftDownVector;zLeftDownVectorBar;z
LeftFloor;zLeftRightArrow;zLeftRightVector;zLeftTee;z
LeftTeeArrow;zLeftTeeVector;z
LeftTriangle;zLeftTriangleBar;zLeftTriangleEqual;zLeftUpDownVector;zLeftUpTeeVector;z
LeftUpVector;zLeftUpVectorBar;zLeftVector;zLeftVectorBar;z
Leftarrow;zLeftrightarrow;zLessEqualGreater;zLessFullEqual;zLessGreater;z	LessLess;zLessSlantEqual;z
LessTilde;zLfr;zLl;zLleftarrow;zLmidot;zLongLeftArrow;zLongLeftRightArrow;zLongRightArrow;zLongleftarrow;zLongleftrightarrow;zLongrightarrow;zLopf;zLowerLeftArrow;zLowerRightArrow;zLscr;zLsh;zLstrok;zLt;zMap;zMcy;zMediumSpace;z
Mellintrf;zMfr;z
MinusPlus;zMopf;zMscr;zMu;zNJcy;zNacute;zNcaron;zNcedil;zNcy;zNegativeMediumSpace;zNegativeThickSpace;zNegativeThinSpace;zNegativeVeryThinSpace;zNestedGreaterGreater;zNestedLessLess;zNewLine;zNfr;zNoBreak;zNonBreakingSpace;zNopf;zNot;z
NotCongruent;z
NotCupCap;zNotDoubleVerticalBar;zNotElement;z	NotEqual;zNotEqualTilde;z
NotExists;zNotGreater;zNotGreaterEqual;zNotGreaterFullEqual;zNotGreaterGreater;zNotGreaterLess;zNotGreaterSlantEqual;zNotGreaterTilde;zNotHumpDownHump;z
NotHumpEqual;zNotLeftTriangle;zNotLeftTriangleBar;zNotLeftTriangleEqual;zNotLess;z
NotLessEqual;zNotLessGreater;zNotLessLess;zNotLessSlantEqual;z
NotLessTilde;zNotNestedGreaterGreater;zNotNestedLessLess;zNotPrecedes;zNotPrecedesEqual;zNotPrecedesSlantEqual;zNotReverseElement;zNotRightTriangle;zNotRightTriangleBar;zNotRightTriangleEqual;zNotSquareSubset;zNotSquareSubsetEqual;zNotSquareSuperset;zNotSquareSupersetEqual;z
NotSubset;zNotSubsetEqual;zNotSucceeds;zNotSucceedsEqual;zNotSucceedsSlantEqual;zNotSucceedsTilde;zNotSuperset;zNotSupersetEqual;z	NotTilde;zNotTildeEqual;zNotTildeFullEqual;zNotTildeTilde;zNotVerticalBar;zNscr;ZNtildezNtilde;zNu;zOElig;ZOacutezOacute;ZOcirczOcirc;zOcy;zOdblac;zOfr;ZOgravezOgrave;zOmacr;zOmega;zOmicron;zOopf;zOpenCurlyDoubleQuote;zOpenCurlyQuote;zOr;zOscr;ZOslashzOslash;ZOtildezOtilde;zOtimes;ZOumlzOuml;zOverBar;z
OverBrace;zOverBracket;zOverParenthesis;z	PartialD;zPcy;zPfr;zPhi;zPi;z
PlusMinus;zPoincareplane;zPopf;zPr;z	Precedes;zPrecedesEqual;zPrecedesSlantEqual;zPrecedesTilde;zPrime;zProduct;zProportion;z
Proportional;zPscr;zPsi;ZQUOTzQUOT;zQfr;zQopf;zQscr;zRBarr;ZREGzREG;zRacute;zRang;zRarr;zRarrtl;zRcaron;zRcedil;zRcy;zRe;zReverseElement;zReverseEquilibrium;zReverseUpEquilibrium;zRfr;zRho;zRightAngleBracket;zRightArrow;zRightArrowBar;zRightArrowLeftArrow;z
RightCeiling;zRightDoubleBracket;zRightDownTeeVector;zRightDownVector;zRightDownVectorBar;zRightFloor;z	RightTee;zRightTeeArrow;zRightTeeVector;zRightTriangle;zRightTriangleBar;zRightTriangleEqual;zRightUpDownVector;zRightUpTeeVector;zRightUpVector;zRightUpVectorBar;zRightVector;zRightVectorBar;zRightarrow;zRopf;z
RoundImplies;zRrightarrow;zRscr;zRsh;zRuleDelayed;zSHCHcy;zSHcy;zSOFTcy;zSacute;zSc;zScaron;zScedil;zScirc;zScy;zSfr;zShortDownArrow;zShortLeftArrow;zShortRightArrow;z
ShortUpArrow;zSigma;zSmallCircle;zSopf;zSqrt;zSquare;zSquareIntersection;z
SquareSubset;zSquareSubsetEqual;zSquareSuperset;zSquareSupersetEqual;zSquareUnion;zSscr;zStar;zSub;zSubset;zSubsetEqual;z	Succeeds;zSucceedsEqual;zSucceedsSlantEqual;zSucceedsTilde;z	SuchThat;zSum;zSup;z	Superset;zSupersetEqual;zSupset;ZTHORNzTHORN;zTRADE;zTSHcy;zTScy;zTab;zTau;zTcaron;zTcedil;zTcy;zTfr;z
Therefore;zTheta;zThickSpace;z
ThinSpace;zTilde;zTildeEqual;zTildeFullEqual;zTildeTilde;zTopf;z
TripleDot;zTscr;zTstrok;ZUacutezUacute;zUarr;z	Uarrocir;zUbrcy;zUbreve;ZUcirczUcirc;zUcy;zUdblac;zUfr;ZUgravezUgrave;zUmacr;z	UnderBar;zUnderBrace;z
UnderBracket;zUnderParenthesis;zUnion;z
UnionPlus;zUogon;zUopf;zUpArrow;zUpArrowBar;zUpArrowDownArrow;zUpDownArrow;zUpEquilibrium;zUpTee;zUpTeeArrow;zUparrow;zUpdownarrow;zUpperLeftArrow;zUpperRightArrow;zUpsi;zUpsilon;zUring;zUscr;zUtilde;ZUumlzUuml;zVDash;zVbar;zVcy;zVdash;zVdashl;zVee;zVerbar;zVert;zVerticalBar;z
VerticalLine;zVerticalSeparator;zVerticalTilde;zVeryThinSpace;zVfr;zVopf;zVscr;zVvdash;zWcirc;zWedge;zWfr;zWopf;zWscr;zXfr;zXi;zXopf;zXscr;zYAcy;zYIcy;zYUcy;ZYacutezYacute;zYcirc;zYcy;zYfr;zYopf;zYscr;zYuml;zZHcy;zZacute;zZcaron;zZcy;zZdot;zZeroWidthSpace;zZeta;zZfr;zZopf;zZscr;Zaacutezaacute;zabreve;zac;zacE;zacd;Zacirczacirc;Zacutezacute;zacy;Zaeligzaelig;zaf;zafr;Zagravezagrave;zalefsym;zaleph;zalpha;zamacr;zamalg;ZamprMzand;zandand;zandd;z	andslope;zandv;zang;zange;zangle;zangmsd;z	angmsdaa;z	angmsdab;z	angmsdac;z	angmsdad;z	angmsdae;z	angmsdaf;z	angmsdag;z	angmsdah;zangrt;zangrtvb;z	angrtvbd;zangsph;zangst;zangzarr;zaogon;zaopf;zap;zapE;zapacir;zape;zapid;rNzapprox;z	approxeq;Zaringzaring;zascr;zast;zasymp;zasympeq;Zatildezatilde;Zaumlzauml;z	awconint;zawint;zbNot;z	backcong;zbackepsilon;z
backprime;zbacksim;z
backsimeq;zbarvee;zbarwed;z	barwedge;zbbrk;z	bbrktbrk;zbcong;zbcy;zbdquo;zbecaus;zbecause;zbemptyv;zbepsi;zbernou;zbeta;zbeth;zbetween;zbfr;zbigcap;zbigcirc;zbigcup;zbigodot;z	bigoplus;z
bigotimes;z	bigsqcup;zbigstar;zbigtriangledown;zbigtriangleup;z	biguplus;zbigvee;z	bigwedge;zbkarow;z
blacklozenge;zblacksquare;zblacktriangle;zblacktriangledown;zblacktriangleleft;zblacktriangleright;zblank;zblk12;zblk14;zblk34;zblock;zbne;zbnequiv;zbnot;zbopf;zbot;zbottom;zbowtie;zboxDL;zboxDR;zboxDl;zboxDr;zboxH;zboxHD;zboxHU;zboxHd;zboxHu;zboxUL;zboxUR;zboxUl;zboxUr;zboxV;zboxVH;zboxVL;zboxVR;zboxVh;zboxVl;zboxVr;zboxbox;zboxdL;zboxdR;zboxdl;zboxdr;zboxh;zboxhD;zboxhU;zboxhd;zboxhu;z	boxminus;zboxplus;z	boxtimes;zboxuL;zboxuR;zboxul;zboxur;zboxv;zboxvH;zboxvL;zboxvR;zboxvh;zboxvl;zboxvr;zbprime;zbreve;Zbrvbarzbrvbar;zbscr;zbsemi;zbsim;zbsime;zbsol;zbsolb;z	bsolhsub;zbull;zbullet;zbump;zbumpE;zbumpe;zbumpeq;zcacute;zcap;zcapand;z	capbrcup;zcapcap;zcapcup;zcapdot;zcaps;zcaret;zcaron;zccaps;zccaron;Zccedilzccedil;zccirc;zccups;zccupssm;zcdot;Zcedilzcedil;zcemptyv;Zcentzcent;z
centerdot;zcfr;zchcy;zcheck;z
checkmark;zchi;zcir;zcirE;zcirc;zcirceq;zcirclearrowleft;zcirclearrowright;z	circledR;z	circledS;zcircledast;zcircledcirc;zcircleddash;zcire;z	cirfnint;zcirmid;zcirscir;zclubs;z	clubsuit;zcolon;zcolone;zcoloneq;zcomma;zcommat;zcomp;zcompfn;zcomplement;z
complexes;zcong;zcongdot;zconint;zcopf;zcoprod;�copyzcopy;zcopysr;zcrarr;zcross;zcscr;zcsub;zcsube;zcsup;zcsupe;zctdot;zcudarrl;zcudarrr;zcuepr;zcuesc;zcularr;zcularrp;zcup;z	cupbrcap;zcupcap;zcupcup;zcupdot;zcupor;zcups;zcurarr;zcurarrm;zcurlyeqprec;zcurlyeqsucc;z	curlyvee;zcurlywedge;Zcurrenzcurren;zcurvearrowleft;zcurvearrowright;zcuvee;zcuwed;z	cwconint;zcwint;zcylcty;zdArr;zdHar;zdagger;zdaleth;zdarr;zdash;zdashv;zdbkarow;zdblac;zdcaron;zdcy;zdd;zddagger;zddarr;zddotseq;Zdegzdeg;zdelta;zdemptyv;zdfisht;zdfr;zdharl;zdharr;zdiam;zdiamond;zdiamondsuit;zdiams;zdie;zdigamma;zdisin;zdiv;Zdividezdivide;zdivideontimes;zdivonx;zdjcy;zdlcorn;zdlcrop;zdollar;zdopf;zdot;zdoteq;z	doteqdot;z	dotminus;zdotplus;z
dotsquare;zdoublebarwedge;z
downarrow;zdowndownarrows;zdownharpoonleft;zdownharpoonright;z	drbkarow;zdrcorn;zdrcrop;zdscr;zdscy;zdsol;zdstrok;zdtdot;zdtri;zdtrif;zduarr;zduhar;zdwangle;zdzcy;z	dzigrarr;zeDDot;zeDot;Zeacutezeacute;zeaster;zecaron;zecir;Zecirczecirc;zecolon;zecy;zedot;zee;zefDot;zefr;zeg;Zegravezegrave;zegs;zegsdot;zel;z	elinters;zell;zels;zelsdot;zemacr;zempty;z	emptyset;zemptyv;zemsp13;zemsp14;zemsp;zeng;zensp;zeogon;zeopf;zepar;zeparsl;zeplus;zepsi;zepsilon;zepsiv;zeqcirc;zeqcolon;zeqsim;zeqslantgtr;zeqslantless;zequals;zequest;zequiv;zequivDD;z	eqvparsl;zerDot;zerarr;zescr;zesdot;zesim;zeta;Zethzeth;Zeumlzeuml;zeuro;zexcl;zexist;zexpectation;z
exponentiale;zfallingdotseq;zfcy;zfemale;zffilig;zfflig;zffllig;zffr;zfilig;zfjlig;zflat;zfllig;zfltns;zfnof;zfopf;zforall;zfork;zforkv;z	fpartint;Zfrac12zfrac12;zfrac13;Zfrac14zfrac14;zfrac15;zfrac16;zfrac18;zfrac23;zfrac25;Zfrac34zfrac34;zfrac35;zfrac38;zfrac45;zfrac56;zfrac58;zfrac78;zfrasl;zfrown;zfscr;zgE;zgEl;zgacute;zgamma;zgammad;zgap;zgbreve;zgcirc;zgcy;zgdot;zge;zgel;zgeq;zgeqq;z	geqslant;zges;zgescc;zgesdot;zgesdoto;z	gesdotol;zgesl;zgesles;zgfr;zgg;zggg;zgimel;zgjcy;zgl;zglE;zgla;zglj;zgnE;zgnap;z	gnapprox;zgne;zgneq;zgneqq;zgnsim;zgopf;zgrave;zgscr;zgsim;zgsime;zgsiml;�gtrLzgtcc;zgtcir;zgtdot;zgtlPar;zgtquest;z
gtrapprox;zgtrarr;zgtrdot;z
gtreqless;zgtreqqless;zgtrless;zgtrsim;z
gvertneqq;zgvnE;zhArr;zhairsp;zhalf;zhamilt;zhardcy;zharr;zharrcir;zharrw;zhbar;zhcirc;zhearts;z
heartsuit;zhellip;zhercon;zhfr;z	hksearow;z	hkswarow;zhoarr;zhomtht;zhookleftarrow;zhookrightarrow;zhopf;zhorbar;zhscr;zhslash;zhstrok;zhybull;zhyphen;Ziacuteziacute;zic;Zicirczicirc;zicy;ziecy;Ziexclziexcl;ziff;zifr;Zigravezigrave;zii;ziiiint;ziiint;ziinfin;ziiota;zijlig;zimacr;zimage;z	imagline;z	imagpart;zimath;zimof;zimped;zin;zincare;zinfin;z	infintie;zinodot;zint;zintcal;z	integers;z	intercal;z	intlarhk;zintprod;ziocy;ziogon;ziopf;ziota;ziprod;Ziquestziquest;ziscr;zisin;zisinE;zisindot;zisins;zisinsv;zisinv;zit;zitilde;ziukcy;Ziumlziuml;zjcirc;zjcy;zjfr;zjmath;zjopf;zjscr;zjsercy;zjukcy;zkappa;zkappav;zkcedil;zkcy;zkfr;zkgreen;zkhcy;zkjcy;zkopf;zkscr;zlAarr;zlArr;zlAtail;zlBarr;zlE;zlEg;zlHar;zlacute;z	laemptyv;zlagran;zlambda;zlang;zlangd;zlangle;zlap;Zlaquozlaquo;zlarr;zlarrb;zlarrbfs;zlarrfs;zlarrhk;zlarrlp;zlarrpl;zlarrsim;zlarrtl;zlat;zlatail;zlate;zlates;zlbarr;zlbbrk;zlbrace;zlbrack;zlbrke;zlbrksld;zlbrkslu;zlcaron;zlcedil;zlceil;zlcub;zlcy;zldca;zldquo;zldquor;zldrdhar;z	ldrushar;zldsh;zle;z
leftarrow;zleftarrowtail;zleftharpoondown;zleftharpoonup;zleftleftarrows;zleftrightarrow;zleftrightarrows;zleftrightharpoons;zleftrightsquigarrow;zleftthreetimes;zleg;zleq;zleqq;z	leqslant;zles;zlescc;zlesdot;zlesdoto;z	lesdotor;zlesg;zlesges;zlessapprox;zlessdot;z
lesseqgtr;zlesseqqgtr;zlessgtr;zlesssim;zlfisht;zlfloor;zlfr;zlg;zlgE;zlhard;zlharu;zlharul;zlhblk;zljcy;zll;zllarr;z	llcorner;zllhard;zlltri;zlmidot;zlmoust;zlmoustache;zlnE;zlnap;z	lnapprox;zlne;zlneq;zlneqq;zlnsim;zloang;zloarr;zlobrk;zlongleftarrow;zlongleftrightarrow;zlongmapsto;zlongrightarrow;zlooparrowleft;zlooparrowright;zlopar;zlopf;zloplus;zlotimes;zlowast;zlowbar;zloz;zlozenge;zlozf;zlpar;zlparlt;zlrarr;z	lrcorner;zlrhar;zlrhard;zlrm;zlrtri;zlsaquo;zlscr;zlsh;zlsim;zlsime;zlsimg;zlsqb;zlsquo;zlsquor;zlstrok;�ltrKzltcc;zltcir;zltdot;zlthree;zltimes;zltlarr;zltquest;zltrPar;zltri;zltrie;zltrif;z	lurdshar;zluruhar;z
lvertneqq;zlvnE;zmDDot;Zmacrzmacr;zmale;zmalt;zmaltese;zmap;zmapsto;zmapstodown;zmapstoleft;z	mapstoup;zmarker;zmcomma;zmcy;zmdash;zmeasuredangle;zmfr;zmho;�microzmicro;zmid;zmidast;zmidcir;Zmiddotzmiddot;zminus;zminusb;zminusd;zminusdu;zmlcp;zmldr;zmnplus;zmodels;zmopf;zmp;zmscr;zmstpos;zmu;z	multimap;zmumap;znGg;znGt;znGtv;znLeftarrow;znLeftrightarrow;znLl;znLt;znLtv;znRightarrow;znVDash;znVdash;znabla;znacute;znang;znap;znapE;znapid;znapos;znapprox;znatur;znatural;z	naturals;Znbspznbsp;znbump;znbumpe;zncap;zncaron;zncedil;zncong;z	ncongdot;zncup;zncy;zndash;zne;zneArr;znearhk;znearr;znearrow;znedot;znequiv;znesear;znesim;znexist;znexists;znfr;zngE;znge;zngeq;zngeqq;z
ngeqslant;znges;zngsim;zngt;zngtr;znhArr;znharr;znhpar;zni;znis;znisd;zniv;znjcy;znlArr;znlE;znlarr;znldr;znle;znleftarrow;znleftrightarrow;znleq;znleqq;z
nleqslant;znles;znless;znlsim;znlt;znltri;znltrie;znmid;znopf;�notznot;znotin;znotinE;z	notindot;znotinva;znotinvb;znotinvc;znotni;znotniva;znotnivb;znotnivc;znpar;z
nparallel;znparsl;znpart;znpolint;znpr;znprcue;znpre;znprec;znpreceq;znrArr;znrarr;znrarrc;znrarrw;znrightarrow;znrtri;znrtrie;znsc;znsccue;znsce;znscr;z
nshortmid;znshortparallel;znsim;znsime;znsimeq;znsmid;znspar;znsqsube;znsqsupe;znsub;znsubE;znsube;znsubset;z
nsubseteq;znsubseteqq;znsucc;znsucceq;znsup;znsupE;znsupe;znsupset;z
nsupseteq;znsupseteqq;zntgl;Zntildezntilde;zntlg;zntriangleleft;zntrianglelefteq;zntriangleright;zntrianglerighteq;znu;znum;znumero;znumsp;znvDash;znvHarr;znvap;znvdash;znvge;znvgt;znvinfin;znvlArr;znvle;znvlt;znvltrie;znvrArr;znvrtrie;znvsim;znwArr;znwarhk;znwarr;znwarrow;znwnear;zoS;Zoacutezoacute;zoast;zocir;Zocirczocirc;zocy;zodash;zodblac;zodiv;zodot;zodsold;zoelig;zofcir;zofr;zogon;Zogravezograve;zogt;zohbar;zohm;zoint;zolarr;zolcir;zolcross;zoline;zolt;zomacr;zomega;zomicron;zomid;zominus;zoopf;zopar;zoperp;zoplus;zor;zorarr;zord;zorder;zorderof;Zordfzordf;Zordmzordm;zorigof;zoror;zorslope;zorv;zoscr;Zoslashzoslash;zosol;Zotildezotilde;zotimes;z	otimesas;Zoumlzouml;zovbar;zpar;Zparazpara;z	parallel;zparsim;zparsl;zpart;zpcy;zpercnt;zperiod;zpermil;zperp;zpertenk;zpfr;zphi;zphiv;zphmmat;zphone;zpi;z
pitchfork;zpiv;zplanck;zplanckh;zplankv;zplus;z	plusacir;zplusb;zpluscir;zplusdo;zplusdu;zpluse;Zplusmnzplusmn;zplussim;zplustwo;zpm;z	pointint;zpopf;Zpoundzpound;zpr;zprE;zprap;zprcue;zpre;zprec;zprecapprox;zpreccurlyeq;zpreceq;zprecnapprox;z	precneqq;z	precnsim;zprecsim;zprime;zprimes;zprnE;zprnap;zprnsim;zprod;z	profalar;z	profline;z	profsurf;zprop;zpropto;zprsim;zprurel;zpscr;zpsi;zpuncsp;zqfr;zqint;zqopf;zqprime;zqscr;zquaternions;zquatint;zquest;zquesteq;ZquotrOzrAarr;zrArr;zrAtail;zrBarr;zrHar;zrace;zracute;zradic;z	raemptyv;zrang;zrangd;zrange;zrangle;Zraquozraquo;zrarr;zrarrap;zrarrb;zrarrbfs;zrarrc;zrarrfs;zrarrhk;zrarrlp;zrarrpl;zrarrsim;zrarrtl;zrarrw;zratail;zratio;z
rationals;zrbarr;zrbbrk;zrbrace;zrbrack;zrbrke;zrbrksld;zrbrkslu;zrcaron;zrcedil;zrceil;zrcub;zrcy;zrdca;zrdldhar;zrdquo;zrdquor;zrdsh;zreal;zrealine;z	realpart;zreals;zrect;Zregzreg;zrfisht;zrfloor;zrfr;zrhard;zrharu;zrharul;zrho;zrhov;zrightarrow;zrightarrowtail;zrightharpoondown;zrightharpoonup;zrightleftarrows;zrightleftharpoons;zrightrightarrows;zrightsquigarrow;zrightthreetimes;zring;z
risingdotseq;zrlarr;zrlhar;zrlm;zrmoust;zrmoustache;zrnmid;zroang;zroarr;zrobrk;zropar;zropf;zroplus;zrotimes;zrpar;zrpargt;z	rppolint;zrrarr;zrsaquo;zrscr;zrsh;zrsqb;zrsquo;zrsquor;zrthree;zrtimes;zrtri;zrtrie;zrtrif;z	rtriltri;zruluhar;zrx;zsacute;zsbquo;zsc;zscE;zscap;zscaron;zsccue;zsce;zscedil;zscirc;zscnE;zscnap;zscnsim;z	scpolint;zscsim;zscy;zsdot;zsdotb;zsdote;zseArr;zsearhk;zsearr;zsearrow;Zsectzsect;zsemi;zseswar;z	setminus;zsetmn;zsext;zsfr;zsfrown;zsharp;zshchcy;zshcy;z	shortmid;zshortparallel;Zshyzshy;zsigma;zsigmaf;zsigmav;zsim;zsimdot;zsime;zsimeq;zsimg;zsimgE;zsiml;zsimlE;zsimne;zsimplus;zsimrarr;zslarr;zsmallsetminus;zsmashp;z	smeparsl;zsmid;zsmile;zsmt;zsmte;zsmtes;zsoftcy;zsol;zsolb;zsolbar;zsopf;zspades;z
spadesuit;zspar;zsqcap;zsqcaps;zsqcup;zsqcups;zsqsub;zsqsube;z	sqsubset;zsqsubseteq;zsqsup;zsqsupe;z	sqsupset;zsqsupseteq;zsqu;zsquare;zsquarf;zsquf;zsrarr;zsscr;zssetmn;zssmile;zsstarf;zstar;zstarf;zstraightepsilon;zstraightphi;zstrns;zsub;zsubE;zsubdot;zsube;zsubedot;zsubmult;zsubnE;zsubne;zsubplus;zsubrarr;zsubset;z	subseteq;z
subseteqq;z
subsetneq;zsubsetneqq;zsubsim;zsubsub;zsubsup;zsucc;zsuccapprox;zsucccurlyeq;zsucceq;zsuccnapprox;z	succneqq;z	succnsim;zsuccsim;zsum;zsung;Zsup1zsup1;Zsup2zsup2;Zsup3zsup3;zsup;zsupE;zsupdot;zsupdsub;zsupe;zsupedot;zsuphsol;zsuphsub;zsuplarr;zsupmult;zsupnE;zsupne;zsupplus;zsupset;z	supseteq;z
supseteqq;z
supsetneq;zsupsetneqq;zsupsim;zsupsub;zsupsup;zswArr;zswarhk;zswarr;zswarrow;zswnwar;Zszligzszlig;ztarget;ztau;ztbrk;ztcaron;ztcedil;ztcy;ztdot;ztelrec;ztfr;zthere4;z
therefore;ztheta;z	thetasym;zthetav;zthickapprox;z	thicksim;zthinsp;zthkap;zthksim;Zthornzthorn;ztilde;�timesztimes;ztimesb;z	timesbar;ztimesd;ztint;ztoea;ztop;ztopbot;ztopcir;ztopf;ztopfork;ztosa;ztprime;ztrade;z	triangle;z
triangledown;z
triangleleft;ztrianglelefteq;z
triangleq;ztriangleright;ztrianglerighteq;ztridot;ztrie;z	triminus;ztriplus;ztrisb;ztritime;z	trpezium;ztscr;ztscy;ztshcy;ztstrok;ztwixt;ztwoheadleftarrow;ztwoheadrightarrow;zuArr;zuHar;Zuacutezuacute;zuarr;zubrcy;zubreve;Zucirczucirc;zucy;zudarr;zudblac;zudhar;zufisht;zufr;Zugravezugrave;zuharl;zuharr;zuhblk;zulcorn;z	ulcorner;zulcrop;zultri;zumacr;Zumlzuml;zuogon;zuopf;zuparrow;zupdownarrow;zupharpoonleft;zupharpoonright;zuplus;zupsi;zupsih;zupsilon;zupuparrows;zurcorn;z	urcorner;zurcrop;zuring;zurtri;zuscr;zutdot;zutilde;zutri;zutrif;zuuarr;Zuumlzuuml;zuwangle;zvArr;zvBar;zvBarv;zvDash;zvangrt;zvarepsilon;z	varkappa;zvarnothing;zvarphi;zvarpi;z
varpropto;zvarr;zvarrho;z	varsigma;z
varsubsetneq;zvarsubsetneqq;z
varsupsetneq;zvarsupsetneqq;z	vartheta;zvartriangleleft;zvartriangleright;zvcy;zvdash;zvee;zveebar;zveeeq;zvellip;zverbar;zvert;zvfr;zvltri;zvnsub;zvnsup;zvopf;zvprop;zvrtri;zvscr;zvsubnE;zvsubne;zvsupnE;zvsupne;zvzigzag;zwcirc;zwedbar;zwedge;zwedgeq;zweierp;zwfr;zwopf;zwp;zwr;zwreath;zwscr;zxcap;zxcirc;zxcup;zxdtri;zxfr;zxhArr;zxharr;zxi;zxlArr;zxlarr;zxmap;zxnis;zxodot;zxopf;zxoplus;zxotime;zxrArr;zxrarr;zxscr;zxsqcup;zxuplus;zxutri;zxvee;zxwedge;Zyacutezyacute;zyacy;zycirc;zycy;Zyenzyen;zyfr;zyicy;zyopf;zyscr;zyucy;Zyumlzyuml;zzacute;zzcaron;zzcy;zzdot;zzeetrf;zzeta;zzfr;zzhcy;zzigrarr;zzopf;zzscr;zzwj;zzwnj;u������)"r�
���������������������������������������)ZDoctypeZ
CharactersZSpaceCharacters�StartTag�EndTag�EmptyTag�CommentZ
ParseErrorrrrcCsg|]\}}||f�qSr4r4)r5�k�vr4r4r8r9ysZmathc@seZdZdZdS)�DataLossWarningzBRaised when the current tree is unable to represent the input dataN)�__name__�
__module__�__qualname__�__doc__r4r4r4r8r}src@seZdZdS)�_ReparseExceptionN)rr	r
r4r4r4r8r�sr)0Z
__future__rrr�stringZEOF�EZ
namespaces�	frozensetZscopingElementsZformattingElementsZspecialElementsZhtmlIntegrationPointElementsZ"mathmlTextIntegrationPointElementsZadjustSVGAttributesZadjustMathMLAttributesZadjustForeignAttributes�dict�itemsZunadjustForeignAttributesZspaceCharactersZtableInsertModeElementsZascii_lowercaseZasciiLowercaseZascii_uppercaseZasciiUppercaseZ
ascii_lettersZasciiLettersZdigitsZ	hexdigitsZ	hexDigitsZasciiUpper2LowerZheadingElementsZvoidElementsZ
cdataElementsZrcdataElementsZbooleanAttributesZentitiesWindows1252ZxmlEntitiesZentitiesZreplacementCharactersZ
tokenTypesZ
tagTokenTypes�prefixes�UserWarningr�	Exceptionrr4r4r4r8�<module>sj���$�	
















�













�













































































�S



�




�	�A����




�	��





�#������������������
L�&��
site-packages/pip/_vendor/html5lib/__pycache__/_ihatexml.cpython-38.opt-1.pyc000064400000032560151446177000023014 0ustar00U

��.eAA�	@s�ddlmZmZmZddlZddlZddlmZdZdZ	dZ
dZd	Zd
�
ee	g�Zd
�
eeddd
e
eg�Zd
�
ed
g�Ze�d�Ze�d�Zdd�Zdd�Zedd�Zdd�Zdd�Zdd�Zdd�Ze�d�Ze�d�Ze�d �ZGd!d"�d"e�Z dS)#�)�absolute_import�division�unicode_literalsN�)�DataLossWarninga^
[#x0041-#x005A] | [#x0061-#x007A] | [#x00C0-#x00D6] | [#x00D8-#x00F6] |
[#x00F8-#x00FF] | [#x0100-#x0131] | [#x0134-#x013E] | [#x0141-#x0148] |
[#x014A-#x017E] | [#x0180-#x01C3] | [#x01CD-#x01F0] | [#x01F4-#x01F5] |
[#x01FA-#x0217] | [#x0250-#x02A8] | [#x02BB-#x02C1] | #x0386 |
[#x0388-#x038A] | #x038C | [#x038E-#x03A1] | [#x03A3-#x03CE] |
[#x03D0-#x03D6] | #x03DA | #x03DC | #x03DE | #x03E0 | [#x03E2-#x03F3] |
[#x0401-#x040C] | [#x040E-#x044F] | [#x0451-#x045C] | [#x045E-#x0481] |
[#x0490-#x04C4] | [#x04C7-#x04C8] | [#x04CB-#x04CC] | [#x04D0-#x04EB] |
[#x04EE-#x04F5] | [#x04F8-#x04F9] | [#x0531-#x0556] | #x0559 |
[#x0561-#x0586] | [#x05D0-#x05EA] | [#x05F0-#x05F2] | [#x0621-#x063A] |
[#x0641-#x064A] | [#x0671-#x06B7] | [#x06BA-#x06BE] | [#x06C0-#x06CE] |
[#x06D0-#x06D3] | #x06D5 | [#x06E5-#x06E6] | [#x0905-#x0939] | #x093D |
[#x0958-#x0961] | [#x0985-#x098C] | [#x098F-#x0990] | [#x0993-#x09A8] |
[#x09AA-#x09B0] | #x09B2 | [#x09B6-#x09B9] | [#x09DC-#x09DD] |
[#x09DF-#x09E1] | [#x09F0-#x09F1] | [#x0A05-#x0A0A] | [#x0A0F-#x0A10] |
[#x0A13-#x0A28] | [#x0A2A-#x0A30] | [#x0A32-#x0A33] | [#x0A35-#x0A36] |
[#x0A38-#x0A39] | [#x0A59-#x0A5C] | #x0A5E | [#x0A72-#x0A74] |
[#x0A85-#x0A8B] | #x0A8D | [#x0A8F-#x0A91] | [#x0A93-#x0AA8] |
[#x0AAA-#x0AB0] | [#x0AB2-#x0AB3] | [#x0AB5-#x0AB9] | #x0ABD | #x0AE0 |
[#x0B05-#x0B0C] | [#x0B0F-#x0B10] | [#x0B13-#x0B28] | [#x0B2A-#x0B30] |
[#x0B32-#x0B33] | [#x0B36-#x0B39] | #x0B3D | [#x0B5C-#x0B5D] |
[#x0B5F-#x0B61] | [#x0B85-#x0B8A] | [#x0B8E-#x0B90] | [#x0B92-#x0B95] |
[#x0B99-#x0B9A] | #x0B9C | [#x0B9E-#x0B9F] | [#x0BA3-#x0BA4] |
[#x0BA8-#x0BAA] | [#x0BAE-#x0BB5] | [#x0BB7-#x0BB9] | [#x0C05-#x0C0C] |
[#x0C0E-#x0C10] | [#x0C12-#x0C28] | [#x0C2A-#x0C33] | [#x0C35-#x0C39] |
[#x0C60-#x0C61] | [#x0C85-#x0C8C] | [#x0C8E-#x0C90] | [#x0C92-#x0CA8] |
[#x0CAA-#x0CB3] | [#x0CB5-#x0CB9] | #x0CDE | [#x0CE0-#x0CE1] |
[#x0D05-#x0D0C] | [#x0D0E-#x0D10] | [#x0D12-#x0D28] | [#x0D2A-#x0D39] |
[#x0D60-#x0D61] | [#x0E01-#x0E2E] | #x0E30 | [#x0E32-#x0E33] |
[#x0E40-#x0E45] | [#x0E81-#x0E82] | #x0E84 | [#x0E87-#x0E88] | #x0E8A |
#x0E8D | [#x0E94-#x0E97] | [#x0E99-#x0E9F] | [#x0EA1-#x0EA3] | #x0EA5 |
#x0EA7 | [#x0EAA-#x0EAB] | [#x0EAD-#x0EAE] | #x0EB0 | [#x0EB2-#x0EB3] |
#x0EBD | [#x0EC0-#x0EC4] | [#x0F40-#x0F47] | [#x0F49-#x0F69] |
[#x10A0-#x10C5] | [#x10D0-#x10F6] | #x1100 | [#x1102-#x1103] |
[#x1105-#x1107] | #x1109 | [#x110B-#x110C] | [#x110E-#x1112] | #x113C |
#x113E | #x1140 | #x114C | #x114E | #x1150 | [#x1154-#x1155] | #x1159 |
[#x115F-#x1161] | #x1163 | #x1165 | #x1167 | #x1169 | [#x116D-#x116E] |
[#x1172-#x1173] | #x1175 | #x119E | #x11A8 | #x11AB | [#x11AE-#x11AF] |
[#x11B7-#x11B8] | #x11BA | [#x11BC-#x11C2] | #x11EB | #x11F0 | #x11F9 |
[#x1E00-#x1E9B] | [#x1EA0-#x1EF9] | [#x1F00-#x1F15] | [#x1F18-#x1F1D] |
[#x1F20-#x1F45] | [#x1F48-#x1F4D] | [#x1F50-#x1F57] | #x1F59 | #x1F5B |
#x1F5D | [#x1F5F-#x1F7D] | [#x1F80-#x1FB4] | [#x1FB6-#x1FBC] | #x1FBE |
[#x1FC2-#x1FC4] | [#x1FC6-#x1FCC] | [#x1FD0-#x1FD3] | [#x1FD6-#x1FDB] |
[#x1FE0-#x1FEC] | [#x1FF2-#x1FF4] | [#x1FF6-#x1FFC] | #x2126 |
[#x212A-#x212B] | #x212E | [#x2180-#x2182] | [#x3041-#x3094] |
[#x30A1-#x30FA] | [#x3105-#x312C] | [#xAC00-#xD7A3]z*[#x4E00-#x9FA5] | #x3007 | [#x3021-#x3029]a�
[#x0300-#x0345] | [#x0360-#x0361] | [#x0483-#x0486] | [#x0591-#x05A1] |
[#x05A3-#x05B9] | [#x05BB-#x05BD] | #x05BF | [#x05C1-#x05C2] | #x05C4 |
[#x064B-#x0652] | #x0670 | [#x06D6-#x06DC] | [#x06DD-#x06DF] |
[#x06E0-#x06E4] | [#x06E7-#x06E8] | [#x06EA-#x06ED] | [#x0901-#x0903] |
#x093C | [#x093E-#x094C] | #x094D | [#x0951-#x0954] | [#x0962-#x0963] |
[#x0981-#x0983] | #x09BC | #x09BE | #x09BF | [#x09C0-#x09C4] |
[#x09C7-#x09C8] | [#x09CB-#x09CD] | #x09D7 | [#x09E2-#x09E3] | #x0A02 |
#x0A3C | #x0A3E | #x0A3F | [#x0A40-#x0A42] | [#x0A47-#x0A48] |
[#x0A4B-#x0A4D] | [#x0A70-#x0A71] | [#x0A81-#x0A83] | #x0ABC |
[#x0ABE-#x0AC5] | [#x0AC7-#x0AC9] | [#x0ACB-#x0ACD] | [#x0B01-#x0B03] |
#x0B3C | [#x0B3E-#x0B43] | [#x0B47-#x0B48] | [#x0B4B-#x0B4D] |
[#x0B56-#x0B57] | [#x0B82-#x0B83] | [#x0BBE-#x0BC2] | [#x0BC6-#x0BC8] |
[#x0BCA-#x0BCD] | #x0BD7 | [#x0C01-#x0C03] | [#x0C3E-#x0C44] |
[#x0C46-#x0C48] | [#x0C4A-#x0C4D] | [#x0C55-#x0C56] | [#x0C82-#x0C83] |
[#x0CBE-#x0CC4] | [#x0CC6-#x0CC8] | [#x0CCA-#x0CCD] | [#x0CD5-#x0CD6] |
[#x0D02-#x0D03] | [#x0D3E-#x0D43] | [#x0D46-#x0D48] | [#x0D4A-#x0D4D] |
#x0D57 | #x0E31 | [#x0E34-#x0E3A] | [#x0E47-#x0E4E] | #x0EB1 |
[#x0EB4-#x0EB9] | [#x0EBB-#x0EBC] | [#x0EC8-#x0ECD] | [#x0F18-#x0F19] |
#x0F35 | #x0F37 | #x0F39 | #x0F3E | #x0F3F | [#x0F71-#x0F84] |
[#x0F86-#x0F8B] | [#x0F90-#x0F95] | #x0F97 | [#x0F99-#x0FAD] |
[#x0FB1-#x0FB7] | #x0FB9 | [#x20D0-#x20DC] | #x20E1 | [#x302A-#x302F] |
#x3099 | #x309Aa
[#x0030-#x0039] | [#x0660-#x0669] | [#x06F0-#x06F9] | [#x0966-#x096F] |
[#x09E6-#x09EF] | [#x0A66-#x0A6F] | [#x0AE6-#x0AEF] | [#x0B66-#x0B6F] |
[#x0BE7-#x0BEF] | [#x0C66-#x0C6F] | [#x0CE6-#x0CEF] | [#x0D66-#x0D6F] |
[#x0E50-#x0E59] | [#x0ED0-#x0ED9] | [#x0F20-#x0F29]z}
#x00B7 | #x02D0 | #x02D1 | #x0387 | #x0640 | #x0E46 | #x0EC6 | #x3005 |
#[#x3031-#x3035] | [#x309D-#x309E] | [#x30FC-#x30FE]� | �.�-�_z#x([\d|A-F]{4,4})z'\[#x([\d|A-F]{4,4})-#x([\d|A-F]{4,4})\]cCs�dd�|�d�D�}g}|D]�}d}ttfD]V}|�|�}|dk	r,|�dd�|��D��t|d�dkrz|dd|d<d	}q�q,|s|�t|�gd�qt|�}|S)
NcSsg|]}|���qS�)�strip��.0�itemrr�B/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_ihatexml.py�
<listcomp>hsz$charStringToList.<locals>.<listcomp>rFcSsg|]}t|��qSr)�hexToIntr
rrrros���r�T)	�split�reChar�reCharRange�match�append�groups�len�ord�normaliseCharList)�charsZ
charRanges�rvrZ
foundMatchZregexprrrr�charStringToListgs 
r cCs�t|�}|D]}qg}d}|t|�kr�d}|�||�||t|�kr�|||d|dddkr�|||d|dd<|d7}q8||7}q|S�Nrrr)�sortedrr)�charListrr�i�jrrrr|s0

rZFFFF�cCs�g}|ddkr*|�d|dddg�t|dd��D].\}}|�|dd||dddg�q:|ddtkr�|�|dddtg�|Sr!)r�	enumerate�max_unicode)r#rr$rrrr�
missingRanges�s(r)cCsng}|D]V}|d|dkr4|�tt|d���q|�tt|d��dtt|d���qdd�|�S)Nrrr	z[%s]�)r�escapeRegexp�chr�join)r#rrrrr�listToRegexpStr�s�r.cCs
t|d�S)Nr&)�int)Zhex_strrrrr�srcCs"d}|D]}|�|d|�}q|S)N)r�^�$�*�+�?�{�}�[�]�|�(�)r	�\)�replace)�stringZspecialCharacters�charrrrr+�sr+u�[-,/:-@\[-\^`\{-¶¸-¿×÷IJ-ijĿ-ŀʼnſDŽ-njDZ-dzǶ-ǹȘ-ɏʩ-ʺ˂-ˏ˒-˿͆-͟͢-΅΋΍΢Ϗϗ-ϙϛϝϟϡϴ-ЀЍѐѝ҂҇-ҏӅ-ӆӉ-ӊӍ-ӏӬ-ӭӶ-ӷӺ-԰՗-՘՚-ՠև-֐ֺ֢־׀׃ׅ-׏׫-ׯ׳-ؠػ-ؿٓ-ٟ٪-ٯڸ-ڹڿۏ۔۩ۮ-ۯۺ-ऀऄऺ-ऻॎ-ॐॕ-ॗ।-॥॰-ঀ঄঍-঎঑-঒঩঱঳-঵঺-঻ঽ৅-৆৉-৊ৎ-৖৘-৛৞৤-৥৲-ਁਃ-਄਋-਎਑-਒਩਱਴਷਺-਻਽੃-੆੉-੊੎-੘੝੟-੥ੵ-઀઄ઌ઎઒઩઱઴઺-઻૆૊૎-૟ૡ-૥૰-଀଄଍-଎଑-଒଩଱଴-ଵ଺-଻ୄ-୆୉-୊୎-୕୘-୛୞ୢ-୥୰-஁஄஋-஍஑஖-஘஛஝஠-஢஥-஧஫-஭ஶ஺-஽௃-௅௉௎-௖௘-௦௰-ఀఄ఍఑఩ఴ఺-ఽ౅౉౎-౔౗-౟ౢ-౥౰-ಁ಄಍಑಩಴಺-ಽ೅೉೎-೔೗-ೝ೟ೢ-೥೰-ഁഄ഍഑ഩഺ-ഽൄ-൅൉ൎ-ൖ൘-ൟൢ-൥൰-฀ฯ฻-฿๏๚-຀຃຅-ຆຉ຋-ຌຎ-ຓຘຠ຤຦ຨ-ຩຬຯ຺຾-຿໅໇໎-໏໚-༗༚-༟༪-༴༶༸༺-༽཈ཪ-཰྅ྌ-ྏྖ྘ྮ-ྰྸྺ-႟჆-჏ჷ-ჿᄁᄄᄈᄊᄍᄓ-ᄻᄽᄿᅁ-ᅋᅍᅏᅑ-ᅓᅖ-ᅘᅚ-ᅞᅢᅤᅦᅨᅪ-ᅬᅯ-ᅱᅴᅶ-ᆝᆟ-ᆧᆩ-ᆪᆬ-ᆭᆰ-ᆶᆹᆻᇃ-ᇪᇬ-ᇯᇱ-ᇸᇺ-᷿ẜ-ẟỺ-ỿ἖-἗἞-἟὆-὇὎-὏὘὚὜὞὾-὿᾵᾽᾿-῁῅῍-῏῔-῕῜-῟῭-῱῵´-⃏⃝-⃠⃢-℥℧-℩ℬ-ℭℯ-ⅿↃ-〄〆〈-〠〰〶-぀ゕ-゘゛-゜ゟ-゠・ヿ-㄄ㄭ-䷿龦-꯿힤-￿]u�[-@\[-\^`\{-¿×÷IJ-ijĿ-ŀʼnſDŽ-njDZ-dzǶ-ǹȘ-ɏʩ-ʺ˂-΅·΋΍΢Ϗϗ-ϙϛϝϟϡϴ-ЀЍѐѝ҂-ҏӅ-ӆӉ-ӊӍ-ӏӬ-ӭӶ-ӷӺ-԰՗-՘՚-ՠև-׏׫-ׯ׳-ؠػ-ـً-ٰڸ-ڹڿۏ۔ۖ-ۤۧ-ऄऺ-़ा-ॗॢ-঄঍-঎঑-঒঩঱঳-঵঺-৛৞ৢ-৯৲-਄਋-਎਑-਒਩਱਴਷਺-੘੝੟-ੱੵ-઄ઌ઎઒઩઱઴઺-઼ા-૟ૡ-଄଍-଎଑-଒଩଱଴-ଵ଺-଼ା-୛୞ୢ-஄஋-஍஑஖-஘஛஝஠-஢஥-஧஫-஭ஶ஺-ఄ఍఑఩ఴ఺-౟ౢ-಄಍಑಩಴಺-ೝ೟ೢ-ഄ഍഑ഩഺ-ൟൢ-฀ฯัิ-฿ๆ-຀຃຅-ຆຉ຋-ຌຎ-ຓຘຠ຤຦ຨ-ຩຬຯັິ-ຼ຾-຿໅-༿཈ཪ-႟჆-჏ჷ-ჿᄁᄄᄈᄊᄍᄓ-ᄻᄽᄿᅁ-ᅋᅍᅏᅑ-ᅓᅖ-ᅘᅚ-ᅞᅢᅤᅦᅨᅪ-ᅬᅯ-ᅱᅴᅶ-ᆝᆟ-ᆧᆩ-ᆪᆬ-ᆭᆰ-ᆶᆹᆻᇃ-ᇪᇬ-ᇯᇱ-ᇸᇺ-᷿ẜ-ẟỺ-ỿ἖-἗἞-἟὆-὇὎-὏὘὚὜὞὾-὿᾵᾽᾿-῁῅῍-῏῔-῕῜-῟῭-῱῵´-℥℧-℩ℬ-ℭℯ-ⅿↃ-〆〈-〠〪-぀ゕ-゠・-㄄ㄭ-䷿龦-꯿힤-￿]z#[^ 
a-zA-Z0-9\-'()+,./:=?;!*#@$_%]c@sreZdZe�d�Zddd�Zddd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�
InfosetFilterz
U[\dA-F]{5,5}FTcCs.||_||_||_||_||_||_i|_dS�N)�dropXmlnsLocalName�dropXmlnsAttrNs�preventDoubleDashComments�preventDashAtCommentEnd�replaceFormFeedCharacters�preventSingleQuotePubid�replaceCache)�selfrBrCrDrErFrGrrr�__init__�szInfosetFilter.__init__NcCsL|jr |�d�r t�dt�dS|jr>|dkr>t�dt�dS|�|�SdS)Nzxmlns:z"Attributes cannot begin with xmlnszhttp://www.w3.org/2000/xmlns/z)Attributes cannot be in the xml namespace)rB�
startswith�warnings�warnrrC�	toXmlName)rI�name�	namespacerrr�coerceAttribute�s�zInfosetFilter.coerceAttributecCs
|�|�SrA)rN)rIrOrrr�
coerceElement�szInfosetFilter.coerceElementcCsJ|jrFd|kr(t�dt�|�dd�}q|�d�rFt�dt�|d7}|S)Nz--z'Comments cannot contain adjacent dashesz- -r	zComments cannot end in a dash� )rDrLrMrr=�endswith)rI�datarrr�
coerceComment�s
zInfosetFilter.coerceCommentcCs6|jr2t|�d��D]}t�dt�q|�dd�}|S)N�zText cannot contain U+000CrS)rF�range�countrLrMrr=)rIrUr
rrr�coerceCharacters�s
zInfosetFilter.coerceCharacterscCsl|}t�|�D]&}t�dt�|�|�}|�||�}q|jrh|�d�dkrht�dt�|�d|�d��}|S)NzCoercing non-XML pubid�'rz!Pubid cannot contain single quote)	�nonPubidCharRegexp�findallrLrMr�getReplacementCharacterr=rG�find)rIrUZ
dataOutputr?�replacementrrr�coercePubid�s
zInfosetFilter.coercePubidc
Cs�|d}|dd�}t�|�}|r:t�dt�|�|�}n|}|}tt�|��}|D]&}t�dt�|�|�}	|�	||	�}qT||S)NrrzCoercing non-XML name)
�nonXmlNameFirstBMPRegexprrLrMrr^�set�nonXmlNameBMPRegexpr]r=)
rIrO�	nameFirstZnameRest�mZnameFirstOutputZnameRestOutputZreplaceCharsr?r`rrrrN�s

zInfosetFilter.toXmlNamecCs$||jkr|j|}n
|�|�}|SrA)rH�
escapeChar�rIr?r`rrrr^s

z%InfosetFilter.getReplacementCharactercCs,t|j�|��D]}|�||�|��}q|SrA)rc�replacementRegexpr]r=�unescapeChar)rIrOrrrr�fromXmlNameszInfosetFilter.fromXmlNamecCsdt|�}||j|<|S)NzU%05X)rrHrhrrrrgs
zInfosetFilter.escapeCharcCstt|dd�d��S)Nrr&)r,r/)rIZcharcoderrrrjszInfosetFilter.unescapeChar)FFFFTF)N)�__name__�
__module__�__qualname__�re�compilerirJrQrRrVrZrarNr^rkrgrjrrrrr@�s$
�


r@)!Z
__future__rrrrorLZ	constantsrZbaseCharZideographicZcombiningCharacterZdigitZextenderr-ZletterrOrerprrr rr/r(r)r.rr+rdrbr\�objectr@rrrr�<module>s40�


	


site-packages/pip/_vendor/html5lib/__pycache__/_tokenizer.cpython-38.pyc000064400000115306151446177000022254 0ustar00U

��.e$+�@s�ddlmZmZmZddlmZddlmZddl	m
Z
ddl	mZddl	mZm
Z
ddl	mZmZmZdd	l	mZmZdd
l	mZddlmZddlmZee�ZGd
d�de�ZdS)�)�absolute_import�division�unicode_literals)�unichr)�deque�)�spaceCharacters)�entities)�asciiLetters�asciiUpper2Lower)�digits�	hexDigits�EOF)�
tokenTypes�
tagTokenTypes)�replacementCharacters)�HTMLInputStream)�TriecsdeZdZdZd��fdd�	Zdd�Zdd�Zd�d
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Zd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Z d>d?�Z!d@dA�Z"dBdC�Z#dDdE�Z$dFdG�Z%dHdI�Z&dJdK�Z'dLdM�Z(dNdO�Z)dPdQ�Z*dRdS�Z+dTdU�Z,dVdW�Z-dXdY�Z.dZd[�Z/d\d]�Z0d^d_�Z1d`da�Z2dbdc�Z3ddde�Z4dfdg�Z5dhdi�Z6djdk�Z7dldm�Z8dndo�Z9dpdq�Z:drds�Z;dtdu�Z<dvdw�Z=dxdy�Z>dzd{�Z?d|d}�Z@d~d�ZAd�d��ZBd�d��ZCd�d��ZDd�d��ZEd�d��ZFd�d��ZGd�d��ZHd�d��ZId�d��ZJd�d��ZKd�d��ZL�ZMS)��
HTMLTokenizera	 This class takes care of tokenizing HTML.

    * self.currentToken
      Holds the token that is currently being processed.

    * self.state
      Holds a reference to the method to be invoked... XXX

    * self.stream
      Points to HTMLInputStream object.
    NcsFt|f|�|_||_d|_g|_|j|_d|_d|_t	t
|���dS)NF)r�stream�parserZ
escapeFlagZ
lastFourChars�	dataState�state�escape�currentToken�superr�__init__)�selfrr�kwargs��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_tokenizer.pyr"szHTMLTokenizer.__init__ccsPtg�|_|��rL|jjr6td|jj�d�d�Vq|jr
|j��Vq6q
dS)z� This is where the magic happens.

        We do our usually processing through the states and when we have a token
        to return we yield the token which pauses processing until the next token
        is requested.
        �
ParseErrorr��type�dataN)r�
tokenQueuerr�errorsr�pop�popleft�rr!r!r"�__iter__1s
zHTMLTokenizer.__iter__c	%Cst}d}|rt}d}g}|j��}||krH|tk	rH|�|�|j��}q"td�|�|�}|tkr�t|}|j	�t
ddd|id���nbd|kr�d	ks�n|d
kr�d}|j	�t
ddd|id���n d|kr�d
k�s�nd|kr�dk�s�nd|k�rdk�s�nd|k�r,dk�s�n|tddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d
g#�k�r�|j	�t
ddd|id��zt|�}Wn>t
k
�r�|d6}td|d?B�td7|d8@B�}YnX|d9k�r|j	�t
dd:d;��|j�|�|S)<z�This function returns either U+FFFD or the character based on the
        decimal or hexadecimal representation. It also discards ";" if present.
        If not present self.tokenQueue.append({"type": tokenTypes["ParseError"]}) is invoked.
        �
��r#z$illegal-codepoint-for-numeric-entity�	charAsInt�r%r&Zdatavarsi�i��i����r�����i�i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��	i��	i��
i��
i��i��i��i��i��
i��
i��i��i��i��i��ii�i��;z numeric-entity-without-semicolonr$)rr
r�charr�append�int�joinrr'r�	frozenset�chr�
ValueError�unget)	rZisHexZallowed�radix�	charStack�cr0r:�vr!r!r"�consumeNumberEntityAs�

�����
�
�
�
�
��
�&
�z!HTMLTokenizer.consumeNumberEntityFc	Cs�d}|j��g}|dtksB|dtddfksB|dk	rV||dkrV|j�|d��n|ddk�rd}|�|j���|ddkr�d}|�|j���|r�|dtks�|s�|dtkr�|j�|d�|�|�}n4|j	�t
d	d
d��|j�|���dd�|�}�nh|dtk	�rDt
�d�|���s0�qD|�|j����qz$t
�d�|dd���}t|�}Wntk
�r�d}YnX|dk	�r@|dd
k�r�|j	�t
d	dd��|dd
k�r|�r||tk�s�||tk�s�||dk�r|j�|���dd�|�}n.t|}|j�|���|d�||d��7}n4|j	�t
d	dd��|j�|���dd�|�}|�r�|jddd|7<n*|tk�r�d}nd}|j	�t
||d��dS)N�&r�<�#F���)�x�XTr#zexpected-numeric-entityr$r/r9znamed-entity-without-semicolon�=zexpected-named-entityr&r�SpaceCharacters�
Characters)rr:rrrAr;r
rrFr'rr)r=�entitiesTrieZhas_keys_with_prefixZlongest_prefix�len�KeyErrorr
r	r)	r�allowedChar�
fromAttribute�outputrC�hexZ
entityNameZentityLengthZ	tokenTyper!r!r"�
consumeEntity�s~�
��
��

�
�
�
��
zHTMLTokenizer.consumeEntitycCs|j|dd�dS)zIThis method replaces the need for "entityInAttributeValueState".
        T)rSrTN)rW)rrSr!r!r"�processEntityInAttribute�sz&HTMLTokenizer.processEntityInAttributecCs�|j}|dtkrp|d�t�|d<|dtdkrp|drR|j�tddd��|drp|j�tdd	d��|j�|�|j|_d
S)z�This method is a generic handler for emitting the tags. It also sets
        the state to "data" because that's what's needed after a token has been
        emitted.
        r%�name�EndTagr&r#zattributes-in-end-tagr$�selfClosingzself-closing-flag-on-end-tagN)	rr�	translaterrr'r;rr)r�tokenr!r!r"�emitCurrentToken�s��zHTMLTokenizer.emitCurrentTokencCs�|j��}|dkr|j|_n�|dkr.|j|_n�|dkrd|j�tddd��|j�tddd��n`|tkrpdS|t	kr�|j�td	||j�
t	d
�d��n&|j�
d�}|j�td||d��d
S)NrGrH�r#�invalid-codepointr$rOFrNT�rGrHr_)rr:�entityDataStater�tagOpenStater'r;rrr�
charsUntil�rr&�charsr!r!r"r�s.


��
�
�zHTMLTokenizer.dataStatecCs|��|j|_dS�NT)rWrrr+r!r!r"rbszHTMLTokenizer.entityDataStatecCs�|j��}|dkr|j|_n�|dkr.|j|_n�|tkr:dS|dkrp|j�tddd��|j�tdd	d��nT|t	kr�|j�td
||j�
t	d�d��n&|j�
d�}|j�td||d��dS)
NrGrHFr_r#r`r$rOr2rNTra)rr:�characterReferenceInRcdatar�rcdataLessThanSignStaterr'r;rrrdrer!r!r"�rcdataStates.


��
�
�zHTMLTokenizer.rcdataStatecCs|��|j|_dSrg)rWrjrr+r!r!r"rh1sz(HTMLTokenizer.characterReferenceInRcdatacCs�|j��}|dkr|j|_nh|dkrR|j�tddd��|j�tddd��n2|tkr^dS|j�d	�}|j�td||d��d
S�NrHr_r#r`r$rOr2F)rHr_T)	rr:�rawtextLessThanSignStaterr'r;rrrdrer!r!r"�rawtextState6s"

��
�zHTMLTokenizer.rawtextStatecCs�|j��}|dkr|j|_nh|dkrR|j�tddd��|j�tddd��n2|tkr^dS|j�d	�}|j�td||d��d
Srk)	rr:�scriptDataLessThanSignStaterr'r;rrrdrer!r!r"�scriptDataStateHs"

��
�zHTMLTokenizer.scriptDataStatecCsr|j��}|tkrdS|dkrL|j�tddd��|j�tddd��n"|j�td||j�d�d��dS)	NFr_r#r`r$rOr2T)rr:rr'r;rrd�rr&r!r!r"�plaintextStateZs
��
�zHTMLTokenizer.plaintextStatecCs|j��}|dkr|j|_n�|dkr.|j|_n�|tkrVtd|gddd�|_|j|_n�|dkr�|j	�
tddd	��|j	�
td
dd	��|j|_nt|dkr�|j	�
tdd
d	��|j�|�|j
|_n@|j	�
tddd	��|j	�
td
dd	��|j�|�|j|_dS)N�!�/ZStartTagF)r%rYr&r[ZselfClosingAcknowledged�>r#z'expected-tag-name-but-got-right-bracketr$rOz<>�?z'expected-tag-name-but-got-question-markzexpected-tag-namerHT)rr:�markupDeclarationOpenStater�closeTagOpenStater
rr�tagNameStater'r;rrA�bogusCommentStaterpr!r!r"rcis@


�
�
�
�zHTMLTokenizer.tagOpenStatecCs�|j��}|tkr0td|gdd�|_|j|_n�|dkrX|j�tddd��|j	|_nn|t
kr�|j�tddd��|j�td	d
d��|j	|_n0|j�tddd|id
��|j�|�|j|_dS)NrZF�r%rYr&r[rtr#z*expected-closing-tag-but-got-right-bracketr$z expected-closing-tag-but-got-eofrO�</z!expected-closing-tag-but-got-charr&r1T)
rr:r
rrrxrr'r;rrrAryrpr!r!r"rw�s2
�
�
�
�zHTMLTokenizer.closeTagOpenStatecCs�|j��}|tkr|j|_n�|dkr.|��n~|tkrV|j�t	ddd��|j
|_nV|dkrh|j|_nD|dkr�|j�t	ddd��|jdd	7<n|jd|7<d
S)Nrtr#zeof-in-tag-namer$rsr_r`rYr2T)
rr:r�beforeAttributeNameStaterr^rr'r;rr�selfClosingStartTagStaterrpr!r!r"rx�s&


�

�zHTMLTokenizer.tagNameStatecCsP|j��}|dkr"d|_|j|_n*|j�tddd��|j�|�|j	|_dS�Nrsr/rOrHr$T)
rr:�temporaryBuffer�rcdataEndTagOpenStaterr'r;rrArjrpr!r!r"ri�s

z%HTMLTokenizer.rcdataLessThanSignStatecCsX|j��}|tkr*|j|7_|j|_n*|j�tddd��|j�	|�|j
|_dS�NrOr{r$T)rr:r
r�rcdataEndTagNameStaterr'r;rrArjrpr!r!r"r��s

z#HTMLTokenizer.rcdataEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
S�NrYrZFrzrsrtrOr{r$T)r�lowerrrr:rrr|rr}r^rr
r'r;rArj�rZappropriater&r!r!r"r��s@
�
�
�
�z#HTMLTokenizer.rcdataEndTagNameStatecCsP|j��}|dkr"d|_|j|_n*|j�tddd��|j�|�|j	|_dSr~)
rr:r�rawtextEndTagOpenStaterr'r;rrArmrpr!r!r"rl�s

z&HTMLTokenizer.rawtextLessThanSignStatecCsX|j��}|tkr*|j|7_|j|_n*|j�tddd��|j�	|�|j
|_dSr�)rr:r
r�rawtextEndTagNameStaterr'r;rrArmrpr!r!r"r��s

z$HTMLTokenizer.rawtextEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
Sr�)rr�rrr:rrr|rr}r^rr
r'r;rArmr�r!r!r"r�s@
�
�
�
�z$HTMLTokenizer.rawtextEndTagNameStatecCsx|j��}|dkr"d|_|j|_nR|dkrJ|j�tddd��|j|_n*|j�tddd��|j�	|�|j
|_dS)	Nrsr/rrrOz<!r$rHT)rr:r�scriptDataEndTagOpenStaterr'r;r�scriptDataEscapeStartStaterArorpr!r!r"rns


z)HTMLTokenizer.scriptDataLessThanSignStatecCsX|j��}|tkr*|j|7_|j|_n*|j�tddd��|j�	|�|j
|_dSr�)rr:r
r�scriptDataEndTagNameStaterr'r;rrArorpr!r!r"r�,s

z'HTMLTokenizer.scriptDataEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
Sr�)rr�rrr:rrr|rr}r^rr
r'r;rAror�r!r!r"r�7s@
�
�
�
�z'HTMLTokenizer.scriptDataEndTagNameStatecCsJ|j��}|dkr2|j�tddd��|j|_n|j�|�|j|_dS�N�-rOr$T)	rr:r'r;r�scriptDataEscapeStartDashStaterrArorpr!r!r"r�Ss

z(HTMLTokenizer.scriptDataEscapeStartStatecCsJ|j��}|dkr2|j�tddd��|j|_n|j�|�|j|_dSr�)	rr:r'r;r�scriptDataEscapedDashDashStaterrArorpr!r!r"r�]s

z,HTMLTokenizer.scriptDataEscapeStartDashStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrD|j|_nn|dkrz|j�tddd��|j�tddd��n8|tkr�|j	|_n&|j�
d	�}|j�td||d��d
S)Nr�rOr$rHr_r#r`r2)rHr�r_T)rr:r'r;r�scriptDataEscapedDashStater�"scriptDataEscapedLessThanSignStaterrrdrer!r!r"�scriptDataEscapedStategs(


��

�z$HTMLTokenizer.scriptDataEscapedStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrD|j|_nn|dkr�|j�tddd��|j�tddd��|j|_n0|t	kr�|j
|_n|j�td|d��|j|_d	S)
Nr�rOr$rHr_r#r`r2T)rr:r'r;rr�rr�r�rrrpr!r!r"r�{s&


��

z(HTMLTokenizer.scriptDataEscapedDashStatecCs�|j��}|dkr*|j�tddd��n�|dkr<|j|_n�|dkrd|j�tddd��|j|_nn|dkr�|j�tddd��|j�tdd	d��|j|_n0|t	kr�|j
|_n|j�td|d��|j|_d
S)Nr�rOr$rHrtr_r#r`r2T)rr:r'r;rr�rror�rrrpr!r!r"r��s*


��

z,HTMLTokenizer.scriptDataEscapedDashDashStatecCs�|j��}|dkr"d|_|j|_n\|tkrT|j�tdd|d��||_|j	|_n*|j�tddd��|j�
|�|j|_dSr~)rr:r� scriptDataEscapedEndTagOpenStaterr
r'r;r� scriptDataDoubleEscapeStartStaterAr�rpr!r!r"r��s


z0HTMLTokenizer.scriptDataEscapedLessThanSignStatecCsP|j��}|tkr"||_|j|_n*|j�tddd��|j�	|�|j
|_dSr�)rr:r
r� scriptDataEscapedEndTagNameStaterr'r;rrAr�rpr!r!r"r��s

z.HTMLTokenizer.scriptDataEscapedEndTagOpenStatecCs|jo|jd��|j��k}|j��}|tkrT|rTtd|jgdd�|_|j|_n�|dkr�|r�td|jgdd�|_|j	|_n||dkr�|r�td|jgdd�|_|�
�|j|_nH|tkr�|j|7_n0|j
�tdd|jd	��|j�|�|j|_d
Sr�)rr�rrr:rrr|rr}r^rr
r'r;rAr�r�r!r!r"r��s@
�
�
�
�z.HTMLTokenizer.scriptDataEscapedEndTagNameStatecCs�|j��}|ttd�BkrR|j�td|d��|j��dkrH|j	|_
q�|j|_
nB|tkr�|j�td|d��|j|7_n|j�
|�|j|_
dS�N)rsrtrOr$ZscriptT)rr:rr>r'r;rrr��scriptDataDoubleEscapedStaterr�r
rArpr!r!r"r��s


z.HTMLTokenizer.scriptDataDoubleEscapeStartStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrZ|j�tddd��|j|_nt|dkr�|j�tddd��|j�tddd��n>|tkr�|j�tdd	d��|j	|_n|j�td|d��d
S�Nr�rOr$rHr_r#r`r2�eof-in-script-in-scriptT)
rr:r'r;r� scriptDataDoubleEscapedDashStater�(scriptDataDoubleEscapedLessThanSignStaterrrpr!r!r"r��s*


��
�
z*HTMLTokenizer.scriptDataDoubleEscapedStatecCs�|j��}|dkr2|j�tddd��|j|_n�|dkrZ|j�tddd��|j|_n�|dkr�|j�tddd��|j�tddd��|j|_nF|t	kr�|j�tdd	d��|j
|_n|j�td|d��|j|_d
Sr�)rr:r'r;r�$scriptDataDoubleEscapedDashDashStaterr�r�rrrpr!r!r"r�s.


��
�
z.HTMLTokenizer.scriptDataDoubleEscapedDashStatecCs|j��}|dkr*|j�tddd��n�|dkrR|j�tddd��|j|_n�|dkrz|j�tddd��|j|_n�|dkr�|j�tddd��|j�tdd	d��|j|_nF|t	kr�|j�tdd
d��|j
|_n|j�td|d��|j|_dS)Nr�rOr$rHrtr_r#r`r2r�T)rr:r'r;rr�rror�rrrpr!r!r"r�s2


��
�
z2HTMLTokenizer.scriptDataDoubleEscapedDashDashStatecCsP|j��}|dkr8|j�tddd��d|_|j|_n|j�|�|j	|_dS)NrsrOr$r/T)
rr:r'r;rr�scriptDataDoubleEscapeEndStaterrAr�rpr!r!r"r�0s

z6HTMLTokenizer.scriptDataDoubleEscapedLessThanSignStatecCs�|j��}|ttd�BkrR|j�td|d��|j��dkrH|j	|_
q�|j|_
nB|tkr�|j�td|d��|j|7_n|j�
|�|j|_
dSr�)rr:rr>r'r;rrr�r�rr�r
rArpr!r!r"r�;s


z,HTMLTokenizer.scriptDataDoubleEscapeEndStatecCs0|j��}|tkr$|j�td��n|tkrJ|jd�|dg�|j|_n�|dkr\|�	�n�|dkrn|j
|_n�|dkr�|j�tddd	��|jd�|dg�|j|_n�|d
kr�|j�tddd	��|jd�ddg�|j|_nF|t
k�r|j�tdd
d	��|j|_n|jd�|dg�|j|_dS)NTr&r/rtrs)�'�"rMrHr#�#invalid-character-in-attribute-namer$r_r`r2z#expected-attribute-name-but-got-eof)rr:rrdr
rr;�attributeNameStaterr^r}r'rrrrpr!r!r"r|Ks<



�
�

�
z&HTMLTokenizer.beforeAttributeNameStatecCs�|j��}d}d}|dkr&|j|_�n.|tkr\|jddd||j�td�7<d}n�|dkrjd}n�|tkr||j|_n�|dkr�|j	|_n�|d	kr�|j
�td
dd��|jdddd
7<d}n�|dk�r|j
�td
dd��|jddd|7<d}nH|t
k�r6|j
�td
dd��|j|_n|jddd|7<d}|�r�|jddd�t�|jddd<|jddd�D]>\}}|jddd|k�r�|j
�td
dd���qҐq�|�r�|��dS)NTFrMr&rJrrtrsr_r#r`r$r2�r�r�rHr�zeof-in-attribute-namezduplicate-attribute)rr:�beforeAttributeValueStaterr
rrdr�afterAttributeNameStater}r'r;rrrr\rr^)rr&ZleavingThisStateZ	emitTokenrY�_r!r!r"r�is^
�

�
�
�
��
z HTMLTokenizer.attributeNameStatecCsD|j��}|tkr$|j�td��n|dkr8|j|_�n|dkrJ|��n�|tkrp|jd�	|dg�|j
|_n�|dkr�|j|_n�|dkr�|j�	t
dd	d
��|jd�	ddg�|j
|_n�|dkr�|j�	t
dd
d
��|jd�	|dg�|j
|_nF|tk�r$|j�	t
ddd
��|j|_n|jd�	|dg�|j
|_dS)NTrMrtr&r/rsr_r#r`r$r2r�z&invalid-character-after-attribute-namezexpected-end-of-tag-but-got-eof)rr:rrdr�rr^r
rr;r�r}r'rrrrpr!r!r"r��s@



�
�

�
z%HTMLTokenizer.afterAttributeNameStatecCsh|j��}|tkr$|j�td��n@|dkr8|j|_�n,|dkrX|j|_|j�|��n|dkrj|j|_n�|dkr�|j	�
tddd��|��n�|d	kr�|j	�
tdd
d��|j
ddd
d7<|j|_n�|dk�r|j	�
tddd��|j
ddd
|7<|j|_nL|tk�rB|j	�
tddd��|j|_n"|j
ddd
|7<|j|_dS)NTr�rGr�rtr#z.expected-attribute-value-but-got-right-bracketr$r_r`r&rJrr2)rMrH�`z"equals-in-unquoted-attribute-valuez$expected-attribute-value-but-got-eof)rr:rrd�attributeValueDoubleQuotedStater�attributeValueUnQuotedStaterA�attributeValueSingleQuotedStater'r;rr^rrrrpr!r!r"r��sF

�
�

�

�
z'HTMLTokenizer.beforeAttributeValueStatecCs�|j��}|dkr|j|_n�|dkr0|�d�n�|dkrj|j�tddd��|jddd	d
7<nN|t	kr�|j�tddd��|j
|_n&|jddd	||j�d�7<d
S)Nr�rGr_r#r`r$r&rJrr2z#eof-in-attribute-value-double-quote)r�rGr_T�rr:�afterAttributeValueStaterrXr'r;rrrrrdrpr!r!r"r��s&

��

�z-HTMLTokenizer.attributeValueDoubleQuotedStatecCs�|j��}|dkr|j|_n�|dkr0|�d�n�|dkrj|j�tddd��|jddd	d
7<nN|t	kr�|j�tddd��|j
|_n&|jddd	||j�d�7<d
S)Nr�rGr_r#r`r$r&rJrr2z#eof-in-attribute-value-single-quote)r�rGr_Tr�rpr!r!r"r��s&

��

�z-HTMLTokenizer.attributeValueSingleQuotedStatecCs|j��}|tkr|j|_n�|dkr0|�d�n�|dkrB|��n�|dkr||j�t	ddd��|j
ddd	|7<n�|d
kr�|j�t	ddd��|j
ddd	d7<nV|tkr�|j�t	dd
d��|j|_n.|j
ddd	||j�
td�tB�7<dS)NrGrt)r�r�rMrHr�r#z0unexpected-character-in-unquoted-attribute-valuer$r&rJrr_r`r2z eof-in-attribute-value-no-quotes)rGrtr�r�rMrHr�r_T)rr:rr|rrXr^r'r;rrrrrdr>rpr!r!r"r�s4


���

�
z)HTMLTokenizer.attributeValueUnQuotedStatecCs�|j��}|tkr|j|_n�|dkr.|��np|dkr@|j|_n^|tkrt|j�	t
ddd��|j�|�|j|_n*|j�	t
ddd��|j�|�|j|_dS)Nrtrsr#z$unexpected-EOF-after-attribute-valuer$z*unexpected-character-after-attribute-valueT)
rr:rr|rr^r}rr'r;rrArrpr!r!r"r� s&



�
�z&HTMLTokenizer.afterAttributeValueStatecCs�|j��}|dkr&d|jd<|��n^|tkrZ|j�tddd��|j�|�|j	|_
n*|j�tddd��|j�|�|j|_
dS)NrtTr[r#z#unexpected-EOF-after-solidus-in-tagr$z)unexpected-character-after-solidus-in-tag)rr:rr^rr'r;rrArrr|rpr!r!r"r}4s 


�
�z&HTMLTokenizer.selfClosingStartTagStatecCsD|j�d�}|�dd�}|j�td|d��|j��|j|_dS)Nrtr_r2�Commentr$T)	rrd�replacer'r;rr:rrrpr!r!r"ryFs�
zHTMLTokenizer.bogusCommentStatecCs�|j��g}|ddkrR|�|j���|ddkrPtddd�|_|j|_dSn�|ddkr�d}dD](}|�|j���|d|krfd	}q�qf|r�td
ddddd�|_|j|_dSn�|ddk�rD|jdk	�rD|jj	j
�rD|jj	j
dj|jj	jk�rDd}d
D].}|�|j���|d|k�rd	}�q2�q|�rD|j
|_dS|j�tddd��|�rt|j�|����qZ|j|_dS)NrJr�r�r/r$T)�d�D))�o�O�rD�C��t�T��y�Y��p�P��e�EFZDoctype)r%rY�publicId�systemId�correct�[)r�r��Ar�r�r�r#zexpected-dashes-or-doctype)rr:r;rr�commentStartStater�doctypeStaterZtreeZopenElements�	namespaceZdefaultNamespace�cdataSectionStater'rAr)ry)rrC�matched�expectedr!r!r"rvUs\����
�z(HTMLTokenizer.markupDeclarationOpenStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��|j�|j�|j|_nP|t	kr�|j�tdd
d��|j�|j�|j|_n|jd|7<|j
|_dS)Nr�r_r#r`r$r&r2rt�incorrect-comment�eof-in-commentT)rr:�commentStartDashStaterr'r;rrrr�commentStaterpr!r!r"r��s.

��
�
zHTMLTokenizer.commentStartStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��|j�|j�|j|_nT|t	kr�|j�tdd
d��|j�|j�|j|_n|jdd|7<|j
|_dS)Nr�r_r#r`r$r&�-�rtr�r�T)rr:�commentEndStaterr'r;rrrrr�rpr!r!r"r��s.

��
�
z#HTMLTokenizer.commentStartDashStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<nT|tkr�|j�tddd��|j�|j�|j	|_n|jd||j�
d	�7<d
S)Nr�r_r#r`r$r&r2r�)r�r_T)rr:�commentEndDashStaterr'r;rrrrrdrpr!r!r"r��s$

��

�zHTMLTokenizer.commentStatecCs�|j��}|dkr|j|_n�|dkrV|j�tddd��|jdd7<|j|_nT|t	kr�|j�tddd��|j�|j�|j
|_n|jdd|7<|j|_d	S)
Nr�r_r#r`r$r&r�zeof-in-comment-end-dashT)rr:r�rr'r;rrr�rrrpr!r!r"r��s$

�
�
z!HTMLTokenizer.commentEndDashStatecCs,|j��}|dkr*|j�|j�|j|_n�|dkrd|j�tddd��|jdd7<|j|_n�|dkr�|j�tdd	d��|j	|_n�|d
kr�|j�tddd��|jd|7<nj|t
kr�|j�tddd��|j�|j�|j|_n4|j�tdd
d��|jdd|7<|j|_dS)Nrtr_r#r`r$r&u--�rrz,unexpected-bang-after-double-dash-in-commentr�z,unexpected-dash-after-double-dash-in-commentzeof-in-comment-double-dashzunexpected-char-in-commentz--T)rr:r'r;rrrrr��commentEndBangStaterrpr!r!r"r��s@

�
�
��
�zHTMLTokenizer.commentEndStatecCs�|j��}|dkr*|j�|j�|j|_n�|dkrN|jdd7<|j|_n�|dkr�|j�tddd��|jdd	7<|j	|_nT|t
kr�|j�tdd
d��|j�|j�|j|_n|jdd|7<|j	|_dS)Nrtr�r&z--!r_r#r`r$u--!�zeof-in-comment-end-bang-stateT)rr:r'r;rrrr�rr�rrpr!r!r"r��s,


�
�
z!HTMLTokenizer.commentEndBangStatecCs�|j��}|tkr|j|_nj|tkr\|j�tddd��d|j	d<|j�|j	�|j
|_n*|j�tddd��|j�|�|j|_dS)Nr#�!expected-doctype-name-but-got-eofr$Fr�zneed-space-after-doctypeT)rr:r�beforeDoctypeNameStaterrr'r;rrrrArpr!r!r"r�s 

�

�zHTMLTokenizer.doctypeStatecCs�|j��}|tkrn�|dkrT|j�tddd��d|jd<|j�|j�|j|_n�|dkr�|j�tddd��d	|jd
<|j	|_nR|t
kr�|j�tddd��d|jd<|j�|j�|j|_n||jd
<|j	|_dS)
Nrtr#z+expected-doctype-name-but-got-right-bracketr$Fr�r_r`r2rYr�T)rr:rr'r;rrrr�doctypeNameStaterrpr!r!r"r�s4
�

�

�


z$HTMLTokenizer.beforeDoctypeNameStatecCs|j��}|tkr2|jd�t�|jd<|j|_n�|dkrh|jd�t�|jd<|j�	|j�|j
|_n�|dkr�|j�	tddd��|jdd7<|j|_nh|t
kr�|j�	tddd��d	|jd
<|jd�t�|jd<|j�	|j�|j
|_n|jd|7<dS)NrYrtr_r#r`r$r2zeof-in-doctype-nameFr�T)rr:rrr\r�afterDoctypeNameStaterr'r;rrr�rrpr!r!r"r�6s0


�
�

zHTMLTokenizer.doctypeNameStatecCsH|j��}|tkr�n.|dkr8|j�|j�|j|_�n|tkr�d|jd<|j�	|�|j�t
ddd��|j�|j�|j|_n�|dkr�d}d	D]}|j��}||kr�d}q�q�|r�|j|_dSnD|d
k�r
d}dD]}|j��}||kr�d}q�q�|�r
|j|_dS|j�	|�|j�t
ddd
|id��d|jd<|j
|_dS)NrtFr�r#�eof-in-doctyper$r�T))�u�U)�b�B)�l�L)�i�Ir���s�S)r�r�r�r�)�m�Mz*expected-space-or-right-bracket-in-doctyper&r1)rr:rr'r;rrrrrAr�afterDoctypePublicKeywordState�afterDoctypeSystemKeywordState�bogusDoctypeState)rr&r�r�r!r!r"r�OsT

�



�
z#HTMLTokenizer.afterDoctypeNameStatecCs�|j��}|tkr|j|_n�|dkrP|j�tddd��|j�|�|j|_nT|t	kr�|j�tddd��d|j
d<|j�|j
�|j|_n|j�|�|j|_dS�	N)r�r�r#�unexpected-char-in-doctyper$r�Fr�T)rr:r�"beforeDoctypePublicIdentifierStaterr'r;rrArrrrpr!r!r"r��s&

�
�

z,HTMLTokenizer.afterDoctypePublicKeywordStatecCs�|j��}|tkrn�|dkr0d|jd<|j|_n�|dkrLd|jd<|j|_n�|dkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_nh|tkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_n(|j�t	ddd��d	|jd
<|j|_d
S)Nr�r/r�r�rtr#�unexpected-end-of-doctyper$Fr�r�r�T)
rr:rr�(doctypePublicIdentifierDoubleQuotedStater�(doctypePublicIdentifierSingleQuotedStater'r;rrrr�rpr!r!r"r��s:




�

�

�
z0HTMLTokenizer.beforeDoctypePublicIdentifierStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�T�
rr:�!afterDoctypePublicIdentifierStaterr'r;rrrrrpr!r!r"r��s0

��

�

z6HTMLTokenizer.doctypePublicIdentifierDoubleQuotedStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�Tr�rpr!r!r"r��s0

��

�

z6HTMLTokenizer.doctypePublicIdentifierSingleQuotedStatecCs|j��}|tkr|j|_n�|dkr<|j�|j�|j|_n�|dkrn|j�t	ddd��d|jd<|j
|_n�|dkr�|j�t	ddd��d|jd<|j|_nh|tkr�|j�t	dd	d��d
|jd<|j�|j�|j|_n(|j�t	ddd��d
|jd<|j
|_dS)
Nrtr�r#r�r$r/r�r�r�Fr�T)rr:r�-betweenDoctypePublicAndSystemIdentifiersStaterr'r;rrr�(doctypeSystemIdentifierDoubleQuotedState�(doctypeSystemIdentifierSingleQuotedStaterr�rpr!r!r"r��s>


�

�

�

�
z/HTMLTokenizer.afterDoctypePublicIdentifierStatecCs�|j��}|tkrn�|dkr4|j�|j�|j|_n�|dkrPd|jd<|j|_n�|dkrld|jd<|j	|_nh|t
kr�|j�tddd��d	|jd
<|j�|j�|j|_n(|j�tddd��d	|jd
<|j|_dS)
Nrtr�r/r�r�r#r�r$Fr�r�T)
rr:rr'r;rrrr�r�rrr�rpr!r!r"r�s2





�

�
z;HTMLTokenizer.betweenDoctypePublicAndSystemIdentifiersStatecCs�|j��}|tkr|j|_n�|dkrP|j�tddd��|j�|�|j|_nT|t	kr�|j�tddd��d|j
d<|j�|j
�|j|_n|j�|�|j|_dSr�)rr:r�"beforeDoctypeSystemIdentifierStaterr'r;rrArrrrpr!r!r"r�s&

�
�

z,HTMLTokenizer.afterDoctypeSystemKeywordStatecCs�|j��}|tkrn�|dkr0d|jd<|j|_n�|dkrLd|jd<|j|_n�|dkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_nh|tkr�|j�t	ddd��d	|jd
<|j�|j�|j
|_n(|j�t	ddd��d	|jd
<|j|_dS)
Nr�r/r�r�rtr#r�r$Fr�r�T)
rr:rrr�rr�r'r;rrrr�rpr!r!r"r�/s:




�

�

�
z0HTMLTokenizer.beforeDoctypeSystemIdentifierStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�T�
rr:�!afterDoctypeSystemIdentifierStaterr'r;rrrrrpr!r!r"r�Ls0

��

�

z6HTMLTokenizer.doctypeSystemIdentifierDoubleQuotedStatecCs�|j��}|dkr|j|_n�|dkrN|j�tddd��|jdd7<n�|dkr�|j�tdd	d��d
|jd<|j�|j�|j|_nR|t	kr�|j�tddd��d
|jd<|j�|j�|j|_n|jd|7<d
S)Nr�r_r#r`r$r�r2rtr�Fr�r�Tr�rpr!r!r"r�ds0

��

�

z6HTMLTokenizer.doctypeSystemIdentifierSingleQuotedStatecCs�|j��}|tkrn~|dkr4|j�|j�|j|_n^|tkrt|j�t	ddd��d|jd<|j�|j�|j|_n|j�t	ddd��|j
|_dS)	Nrtr#r�r$Fr�r�T)rr:rr'r;rrrrrr�rpr!r!r"r�|s$

�

�z/HTMLTokenizer.afterDoctypeSystemIdentifierStatecCsZ|j��}|dkr*|j�|j�|j|_n,|tkrV|j�|�|j�|j�|j|_ndS)NrtT)	rr:r'r;rrrrrArpr!r!r"r��s


zHTMLTokenizer.bogusDoctypeStatecCs�g}|�|j�d��|�|j�d��|j��}|tkr>q�q|dksJt�|ddd�dkrv|ddd�|d<q�q|�|�qd�|�}|�d�}|dkr�t|�D]}|j	�t
d	d
d��q�|�dd�}|r�|j	�t
d
|d��|j|_
dS)N�]rtrJ���z]]r/r_rr#r`r$r2rOT)r;rrdr:r�AssertionErrorr=�count�ranger'rr�rr)rr&r:Z	nullCountr�r!r!r"r��s2


�
�zHTMLTokenizer.cdataSectionState)N)NF)N�__name__�
__module__�__qualname__�__doc__rr,rFrWrXr^rrbrjrhrmrorqrcrwrxrir�r�rlr�r�rnr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r}ryrvr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r��
__classcell__r!r!rr"rs�H
P#

6 "-3rN)Z
__future__rrrZpip._vendor.sixrr?�collectionsrZ	constantsrr	r
rrr
rrrrZ_inputstreamrZ_trierrP�objectrr!r!r!r"�<module>ssite-packages/pip/_vendor/html5lib/__pycache__/_inputstream.cpython-38.opt-1.pyc000064400000051724151446177000023557 0ustar00U

��.e(�!@s�ddlmZmZmZddlmZmZddlmZm	Z	ddl
Z
ddlZddlm
Z
ddlmZmZmZmZddlmZdd	lmZdd
lmZzddlmZWnek
r�eZYnXedd
�eD��Zedd
�eD��Zedd
�eD��Zeeddg�BZdZej �r(e�!edd�e"d�d�Z#n
e�!e�Z#e$ddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5g �Z%e�!d6�Z&iZ'Gd7d8�d8e(�Z)d9d:�Z*Gd;d<�d<e(�Z+Gd=d>�d>e+�Z,Gd?d@�d@e-�Z.GdAdB�dBe(�Z/GdCdD�dDe(�Z0dEdF�Z1dS)G�)�absolute_import�division�unicode_literals)�	text_type�binary_type)�http_client�urllibN)�webencodings�)�EOF�spaceCharacters�asciiLetters�asciiUppercase)�_ReparseException)�_utils)�StringIO)�BytesIOcCsg|]}|�d��qS��ascii��encode��.0�item�r�E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_inputstream.py�
<listcomp>srcCsg|]}|�d��qSrrrrrrrscCsg|]}|�d��qSrrrrrrrs�>�<u�[---Ÿ﷐-﷯￾￿🿾🿿𯿾𯿿𿿾𿿿񏿾񏿿񟿾񟿿񯿾񯿿񿿾񿿿򏿾򏿿򟿾򟿿򯿾򯿿򿿾򿿿󏿾󏿿󟿾󟿿󯿾󯿿󿿾󿿿􏿾􏿿]���z"\uD800-\uDFFF"�]i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��	i��	i��
i��
i��i��i��i��i��
i��
i��i��i��i��i��i��z[	-
 -/:-@\[-`{-~]c@sHeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dS)�BufferedStreamz�Buffering for streams that do not have buffering of their own

    The buffer is implemented as a list of chunks on the assumption that
    joining many strings will be slow since it is O(n**2)
    cCs||_g|_ddg|_dS)Nrr)�stream�buffer�position)�selfr"rrr�__init__@szBufferedStream.__init__cCs<d}|jd|jd�D]}|t|�7}q||jd7}|S�Nrr
)r#r$�len)r%�pos�chunkrrr�tellEs
zBufferedStream.tellcCsD|}d}t|j|�|kr6|t|j|�8}|d7}q||g|_dSr')r(r#r$)r%r)�offset�irrr�seekLs
zBufferedStream.seekcCsT|js|�|�S|jdt|j�krF|jdt|jd�krF|�|�S|�|�SdS)Nrr
r)r#�_readStreamr$r(�_readFromBuffer)r%�bytesrrr�readUs
�
zBufferedStream.readcCstdd�|jD��S)NcSsg|]}t|��qSr)r(rrrrr_sz1BufferedStream._bufferedBytes.<locals>.<listcomp>)�sumr#�r%rrr�_bufferedBytes^szBufferedStream._bufferedBytescCs<|j�|�}|j�|�|jdd7<t|�|jd<|Sr')r"r2r#�appendr$r()r%r1�datarrrr/as
zBufferedStream._readStreamcCs�|}g}|jd}|jd}|t|j�kr�|dkr�|j|}|t|�|kr`|}|||g|_n"t|�|}|t|�g|_|d7}|�||||��||8}d}q|r�|�|�|��d�|�S)Nrr
�)r$r(r#r6r/�join)r%r1ZremainingBytes�rvZbufferIndexZbufferOffsetZbufferedDataZbytesToReadrrrr0hs$


zBufferedStream._readFromBufferN)�__name__�
__module__�__qualname__�__doc__r&r+r.r2r5r/r0rrrrr!9s		r!cKs�t|tj�s(t|tjj�r.t|jtj�r.d}n&t|d�rJt|�d�t	�}n
t|t	�}|r�dd�|D�}|rvt
d|��t|f|�St|f|�SdS)NFr2rcSsg|]}|�d�r|�qS)Z	_encoding)�endswith)r�xrrrr�s
z#HTMLInputStream.<locals>.<listcomp>z3Cannot set an encoding with a unicode input, set %r)
�
isinstancerZHTTPResponserZresponseZaddbase�fp�hasattrr2r�	TypeError�HTMLUnicodeInputStream�HTMLBinaryInputStream)�source�kwargsZ	isUnicodeZ	encodingsrrr�HTMLInputStream�s��

rIc@speZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
ddd�Zdd�Zdd�Z
ddd�Zdd�ZdS)rE��Provides a unicode stream of characters to the HTMLTokenizer.

    This class takes care of character encoding and removing or replacing
    incorrect byte-sequences and also provides column and line tracking.

    i(cCsZtjsd|_ntd�dkr$|j|_n|j|_dg|_td�df|_|�	|�|_
|��dS)�Initialises the HTMLInputStream.

        HTMLInputStream(source, [encoding]) -> Normalized stream from source
        for use by html5lib.

        source can be either a file-object, local filename or a string.

        The optional encoding parameter must be a string that indicates
        the encoding.  If specified, that encoding will be used,
        regardless of any BOM or later declaration (such as in a meta
        element)

        Nu􏿿r
r�utf-8�certain)r�supports_lone_surrogates�reportCharacterErrorsr(�characterErrorsUCS4�characterErrorsUCS2ZnewLines�lookupEncoding�charEncoding�
openStream�
dataStream�reset)r%rGrrrr&�s
zHTMLUnicodeInputStream.__init__cCs.d|_d|_d|_g|_d|_d|_d|_dS)N�r)r*�	chunkSize�chunkOffset�errors�prevNumLines�prevNumCols�_bufferedCharacterr4rrrrV�szHTMLUnicodeInputStream.resetcCst|d�r|}nt|�}|S�zvProduces a file object from source.

        source can be either a file object, local filename or a string.

        r2)rCr�r%rGr"rrrrT�s
z!HTMLUnicodeInputStream.openStreamcCsT|j}|�dd|�}|j|}|�dd|�}|dkr@|j|}n||d}||fS)N�
rrr
)r*�countr[�rfindr\)r%r,r*ZnLinesZpositionLineZlastLinePosZpositionColumnrrr�	_position�s
z HTMLUnicodeInputStream._positioncCs|�|j�\}}|d|fS)z:Returns (line, col) of the current position in the stream.r
)rcrY)r%�line�colrrrr$�szHTMLUnicodeInputStream.positioncCs6|j|jkr|��stS|j}|j|}|d|_|S)zo Read one character from the stream or queue if available. Return
            EOF when EOF is reached.
        r
)rYrX�	readChunkrr*)r%rY�charrrrrg�s

zHTMLUnicodeInputStream.charNcCs�|dkr|j}|�|j�\|_|_d|_d|_d|_|j�|�}|j	rX|j	|}d|_	n|s`dSt
|�dkr�t|d�}|dks�d|kr�dkr�nn|d|_	|dd�}|jr�|�|�|�
d	d
�}|�
dd
�}||_t
|�|_dS)
NrWrFr
r�
��i��z
r`�
T)�_defaultChunkSizercrXr[r\r*rYrUr2r]r(�ordrO�replace)r%rXr7Zlastvrrrrf�s0
 


z HTMLUnicodeInputStream.readChunkcCs(ttt�|���D]}|j�d�qdS)N�invalid-codepoint)�ranger(�invalid_unicode_re�findallrZr6)r%r7�_rrrrP%sz*HTMLUnicodeInputStream.characterErrorsUCS4cCs�d}t�|�D]�}|rqt|���}|��}t�|||d��rrt�|||d��}|tkrl|j	�
d�d}q|dkr�|dkr�|t|�dkr�|j	�
d�qd}|j	�
d�qdS)NF�rnTrii��r
)rp�finditerrl�group�startrZisSurrogatePairZsurrogatePairToCodepoint�non_bmp_invalid_codepointsrZr6r()r%r7�skip�matchZ	codepointr)Zchar_valrrrrQ)s"�z*HTMLUnicodeInputStream.characterErrorsUCS2Fc	Cs�zt||f}WnNtk
r^d�dd�|D��}|s@d|}t�d|�}t||f<YnXg}|�|j|j�}|dkr�|j|jkr�q�n0|�	�}||jkr�|�
|j|j|��||_q�|�
|j|jd��|��sdq�qdd�|�}|S)z� Returns a string of characters from the stream up to but not
        including any character in 'characters' or EOF. 'characters' must be
        a container that supports the 'in' method and iteration over its
        characters.
        rWcSsg|]}dt|��qS)z\x%02x)rl)r�crrrrNsz5HTMLUnicodeInputStream.charsUntil.<locals>.<listcomp>z^%sz[%s]+N)�charsUntilRegEx�KeyErrorr9�re�compileryr*rYrX�endr6rf)	r%Z
charactersZopposite�charsZregexr:�mr�rrrr�
charsUntil@s, 

z!HTMLUnicodeInputStream.charsUntilcCs@|dk	r<|jdkr.||j|_|jd7_n|jd8_dSr')rYr*rX)r%rgrrr�ungetos
zHTMLUnicodeInputStream.unget)N)F)r;r<r=r>rkr&rVrTrcr$rgrfrPrQr�r�rrrrrE�s 
&
/rEc@sLeZdZdZddd�Zdd�Zd	d
�Zddd�Zd
d�Zdd�Z	dd�Z
dS)rFrJN�windows-1252TcCs\|�|�|_t�||j�d|_d|_||_||_||_||_	||_
|�|�|_|�
�dS)rKi�dN)rT�	rawStreamrEr&�numBytesMeta�numBytesChardet�override_encoding�transport_encoding�same_origin_parent_encoding�likely_encoding�default_encoding�determineEncodingrSrV)r%rGr�r�r�r�r�Z
useChardetrrrr&�szHTMLBinaryInputStream.__init__cCs&|jdj�|jd�|_t�|�dS)Nrrm)rSZ
codec_info�streamreaderr�rUrErVr4rrrrV�szHTMLBinaryInputStream.resetcCsDt|d�r|}nt|�}z|�|���Wnt|�}YnX|Sr^)rCrr.r+r!r_rrrrT�s
z HTMLBinaryInputStream.openStreamcCs�|��df}|ddk	r|St|j�df}|ddk	r:|St|j�df}|ddk	rX|S|��df}|ddk	rt|St|j�df}|ddk	r�|dj�d�s�|St|j�df}|ddk	r�|S|�r`zddl	m
}Wntk
r�YnvXg}|�}|j�s,|j
�|j�}|�s�q,|�|�|�|�q�|��t|jd�}|j
�d�|dk	�r`|dfSt|j�df}|ddk	�r�|Std�dfS)NrMrZ	tentativezutf-16)�UniversalDetector�encodingr�)�	detectBOMrRr�r��detectEncodingMetar��name�
startswithr�Z%pip._vendor.chardet.universaldetectorr��ImportErrorZdoner�r2r�r6Zfeed�close�resultr.r�)r%ZchardetrSr�ZbuffersZdetectorr#r�rrrr��sP

z'HTMLBinaryInputStream.determineEncodingcCs�t|�}|dkrdS|jdkr(td�}nT||jdkrH|jddf|_n4|j�d�|df|_|��td|jd|f��dS)N��utf-16be�utf-16lerLrrMzEncoding changed from %s to %s)rRr�rSr�r.rVr)r%ZnewEncodingrrr�changeEncodings

z$HTMLBinaryInputStream.changeEncodingc
Cs�tjdtjdtjdtjdtjdi}|j�d�}|�|dd��}d}|sp|�|�}d}|sp|�|dd	��}d	}|r�|j�	|�t
|�S|j�	d
�dSdS)z�Attempts to detect at BOM at the start of the stream. If
        an encoding can be determined from the BOM return the name of the
        encoding otherwise return NonerLr�r�zutf-32lezutf-32be�N�rsr)�codecs�BOM_UTF8�BOM_UTF16_LE�BOM_UTF16_BE�BOM_UTF32_LE�BOM_UTF32_BEr�r2�getr.rR)r%ZbomDict�stringr�r.rrrr�s2�
zHTMLBinaryInputStream.detectBOMcCsH|j�|j�}t|�}|j�d�|��}|dk	rD|jdkrDtd�}|S)z9Report the encoding declared by the meta element
        rNr�rL)r�r2r��EncodingParserr.�getEncodingr�rR)r%r#�parserr�rrrr�9sz(HTMLBinaryInputStream.detectEncodingMeta)NNNNr�T)T)r;r<r=r>r&rVrTr�r�r�r�rrrrrF�s�
*
>"rFc@s�eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zeee
�Z
dd�Zee�Zefdd�Zdd�Zdd�Zdd�ZdS)�
EncodingBytesz�String-like object with an associated position and various extra methods
    If the position is ever greater than the string length then an exception is
    raisedcCst�||���S�N)r1�__new__�lower�r%�valuerrrr�LszEncodingBytes.__new__cCs
d|_dS)Nr)rcr�rrrr&PszEncodingBytes.__init__cCs|Sr�rr4rrr�__iter__TszEncodingBytes.__iter__cCs>|jd}|_|t|�kr"t�n|dkr.t�|||d�S)Nr
r�rcr(�
StopIterationrD�r%�prrr�__next__WszEncodingBytes.__next__cCs|��Sr�)r�r4rrr�next_szEncodingBytes.nextcCsB|j}|t|�krt�n|dkr$t�|d|_}|||d�Sr'r�r�rrr�previouscszEncodingBytes.previouscCs|jt|�krt�||_dSr��rcr(r�)r%r$rrr�setPositionlszEncodingBytes.setPositioncCs*|jt|�krt�|jdkr"|jSdSdS)Nrr�r4rrr�getPositionqs

zEncodingBytes.getPositioncCs||j|jd�S�Nr
)r$r4rrr�getCurrentByte{szEncodingBytes.getCurrentBytecCsH|j}|t|�kr>|||d�}||kr4||_|S|d7}q||_dS)zSkip past a list of charactersr
N�r$r(rc�r%r�r�rzrrrrx�s
zEncodingBytes.skipcCsH|j}|t|�kr>|||d�}||kr4||_|S|d7}q||_dSr�r�r�rrr�	skipUntil�s
zEncodingBytes.skipUntilcCs>|j}|||t|��}|�|�}|r:|jt|�7_|S)z�Look for a sequence of bytes at the start of a string. If the bytes
        are found return True and advance the position to the byte after the
        match. Otherwise return False and leave the position alone)r$r(r�)r%r1r�r7r:rrr�
matchBytes�s
zEncodingBytes.matchBytescCsR||jd��|�}|dkrJ|jdkr,d|_|j|t|�d7_dSt�dS)z�Look for the next sequence of bytes matching a given sequence. If
        a match is found advance the position to the last byte of the matchNrrr
T)r$�findrcr(r�)r%r1ZnewPositionrrr�jumpTo�s
zEncodingBytes.jumpToN)r;r<r=r>r�r&r�r�r�r�r�r��propertyr$r��currentByte�spaceCharactersBytesrxr�r�r�rrrrr�Hs 	
r�c@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)r�z?Mini parser for detecting character encoding from meta elementscCst|�|_d|_dS)z3string - the data to work on for encoding detectionN)r�r7r��r%r7rrrr&�s
zEncodingParser.__init__c
Cs�d|jfd|jfd|jfd|jfd|jfd|jff}|jD]Z}d}|D]D\}}|j�|�rFz|�}Wq�WqFtk
r�d}Yq�YqFXqF|s:q�q:|jS)	Ns<!--s<metas</s<!s<?rTF)	�
handleComment�
handleMeta�handlePossibleEndTag�handleOther�handlePossibleStartTagr7r�r�r�)r%ZmethodDispatchrrZkeepParsing�key�methodrrrr��s(�

zEncodingParser.getEncodingcCs|j�d�S)zSkip over commentss-->�r7r�r4rrrr��szEncodingParser.handleCommentcCs�|jjtkrdSd}d}|��}|dkr,dS|ddkr\|ddk}|r�|dk	r�||_dSq|ddkr�|d}t|�}|dk	r�||_dSq|ddkrtt|d��}|��}|dk	rt|�}|dk	r|r�||_dS|}qdS)	NTFrs
http-equivr
scontent-type�charsetscontent)	r7r�r��getAttributer�rR�ContentAttrParserr��parse)r%Z	hasPragmaZpendingEncoding�attrZtentativeEncoding�codecZ
contentParserrrrr��s8zEncodingParser.handleMetacCs
|�d�S)NF)�handlePossibleTagr4rrrr��sz%EncodingParser.handlePossibleStartTagcCst|j�|�d�S)NT)r�r7r�r4rrrr��s
z#EncodingParser.handlePossibleEndTagcCsb|j}|jtkr(|r$|��|��dS|�t�}|dkrD|��n|��}|dk	r^|��}qLdS)NTr)r7r��asciiLettersBytesr�r�r��spacesAngleBracketsr�)r%ZendTagr7rzr�rrrr��s



z EncodingParser.handlePossibleTagcCs|j�d�S)Nrr�r4rrrr�szEncodingParser.handleOthercCs�|j}|�ttdg�B�}|dkr&dSg}g}|dkr>|r>q�nX|tkrR|��}q�nD|dkrhd�|�dfS|tkr�|�|���n|dkr�dS|�|�t|�}q.|dkr�|�	�d�|�dfSt|�|��}|dk�r2|}t|�}||k�r
t|�d�|�d�|�fS|tk�r$|�|���q�|�|�q�nJ|dk�rJd�|�dfS|tk�rd|�|���n|dk�rrdS|�|�t|�}|t
k�r�d�|�d�|�fS|tk�r�|�|���n|dk�r�dS|�|��q|dS)	z_Return a name,value pair for the next attribute in the stream,
        if one is found, or None�/)rNN�=)r�rr8)�'�"r)r7rxr��	frozensetr9�asciiUppercaseBytesr6r�r�r�r�)r%r7rzZattrNameZ	attrValueZ	quoteCharrrrr�s`











zEncodingParser.getAttributeN)
r;r<r=r>r&r�r�r�r�r�r�r�r�rrrrr��s$r�c@seZdZdd�Zdd�ZdS)r�cCs
||_dSr�)r7r�rrrr&fszContentAttrParser.__init__cCs�z�|j�d�|jjd7_|j��|jjdks<WdS|jjd7_|j��|jjdkr�|jj}|jjd7_|jj}|j�|�r�|j||jj�WSWdSnR|jj}z"|j�t�|j||jj�WWStk
�r�|j|d�YWSXWntk
�rYdSXdS)Nr�r
r�)r�r�)r7r�r$rxr�r�r�r�)r%Z	quoteMarkZoldPositionrrrr�js.

zContentAttrParser.parseN)r;r<r=r&r�rrrrr�esr�cCsft|t�r0z|�d�}Wntk
r.YdSX|dk	r^zt�|�WStk
rZYdSXndSdS)z{Return the python codec name corresponding to an encoding or None if the
    string doesn't correspond to a valid encoding.rN)rAr�decode�UnicodeDecodeErrorr	�lookup�AttributeError)r�rrrrR�s

rR)2Z
__future__rrrZpip._vendor.sixrrZpip._vendor.six.movesrrr�r}Zpip._vendorr	Z	constantsrrr
rrrWr�iorrr�r�r�r�r�r�Zinvalid_unicode_no_surrogaterNr~�evalrp�setrwZascii_punctuation_rer{�objectr!rIrErFr1r�r�r�rRrrrr�<module>s�
��
�
JgIh6'site-packages/pip/_vendor/html5lib/__pycache__/serializer.cpython-38.opt-1.pyc000064400000024752151446177000023217 0ustar00U

��.e�=�@szddlmZmZmZddlmZddlZddlmZm	Z	ddl
mZmZm
Z
ddl
mZmZmZddlmZmZdd	lmZd
�e
�dZe�ded
�Ze�ded�ZiZed�dkZee���D]n\Z Z!er�ee!�dks�es�ee!�dkr�q�e!dkr�ee!�dk�re�"e!�Z!ne#e!�Z!e!ek�s0e �$�r�e ee!<q�dd�Z%ede%�ddd�Z&Gdd�de'�Z(Gdd�de)�Z*dS)�)�absolute_import�division�unicode_literals)�	text_typeN)�register_error�xmlcharrefreplace_errors�)�voidElements�booleanAttributes�spaceCharacters)�rcdataElements�entities�xmlEntities)�treewalkers�_utils)�escape�z"'=<>`�[�]u_	

 /`  ᠎᠏           

   ]u􏿿��&c
	Cst|ttf��rg}g}d}t|j|j|j��D]n\}}|rDd}q2||j}t�|j|t	|j|dg���r�t�
|j||d��}d}nt|�}|�|�q2|D]V}t
�|�}	|	r�|�d�|�|	�|	�d�s�|�d�q�|�dt|�dd��q�d�|�|jfSt|�SdS)NFrTr�;z&#x%s;r)�
isinstance�UnicodeEncodeError�UnicodeTranslateError�	enumerate�object�start�endrZisSurrogatePair�min�surrogatePairToCodepoint�ord�append�_encode_entity_map�get�endswith�hex�joinr)
�exc�resZ
codepoints�skip�i�c�indexZ	codepointZcp�e�r/�C/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/serializer.py�htmlentityreplace_errors*s0
"



r1�htmlentityreplace�etreecKs$t�|�}tf|�}|�||�|�S)a�Serializes the input token stream using the specified treewalker

    :arg input: the token stream to serialize

    :arg tree: the treewalker to use

    :arg encoding: the encoding to use

    :arg serializer_opts: any options to pass to the
        :py:class:`html5lib.serializer.HTMLSerializer` that gets created

    :returns: the tree serialized as a string

    Example:

    >>> from html5lib.html5parser import parse
    >>> from html5lib.serializer import serialize
    >>> token_stream = parse('<html><body><p>Hi!</p></body></html>')
    >>> serialize(token_stream, omit_optional_tags=False)
    '<html><head></head><body><p>Hi!</p></body></html>'

    )rZ
getTreeWalker�HTMLSerializer�render)�inputZtree�encodingZserializer_optsZwalker�sr/r/r0�	serializeKs

r9c@s~eZdZdZdZdZdZdZdZdZ	dZ
dZdZdZ
dZdZdZdZdd�Zdd	�Zd
d�Zdd
d�Zddd�Zddd�ZdS)r4�legacy�"TF)�quote_attr_values�
quote_char�use_best_quote_char�omit_optional_tags�minimize_boolean_attributes�use_trailing_solidus�space_before_trailing_solidus�escape_lt_in_attrs�
escape_rcdata�resolve_entities�alphabetical_attributes�inject_meta_charset�strip_whitespace�sanitizec
Ksvt|�t|j�}t|�dkr2tdtt|����d|kr@d|_|jD]}t|||�|t	||���qFg|_
d|_dS)aB
Initialize HTMLSerializer

        :arg inject_meta_charset: Whether or not to inject the meta charset.

            Defaults to ``True``.

        :arg quote_attr_values: Whether to quote attribute values that don't
            require quoting per legacy browser behavior (``"legacy"``), when
            required by the standard (``"spec"``), or always (``"always"``).

            Defaults to ``"legacy"``.

        :arg quote_char: Use given quote character for attribute quoting.

            Defaults to ``"`` which will use double quotes unless attribute
            value contains a double quote, in which case single quotes are
            used.

        :arg escape_lt_in_attrs: Whether or not to escape ``<`` in attribute
            values.

            Defaults to ``False``.

        :arg escape_rcdata: Whether to escape characters that need to be
            escaped within normal elements within rcdata elements such as
            style.

            Defaults to ``False``.

        :arg resolve_entities: Whether to resolve named character entities that
            appear in the source tree. The XML predefined entities &lt; &gt;
            &amp; &quot; &apos; are unaffected by this setting.

            Defaults to ``True``.

        :arg strip_whitespace: Whether to remove semantically meaningless
            whitespace. (This compresses all whitespace to a single space
            except within ``pre``.)

            Defaults to ``False``.

        :arg minimize_boolean_attributes: Shortens boolean attributes to give
            just the attribute value, for example::

              <input disabled="disabled">

            becomes::

              <input disabled>

            Defaults to ``True``.

        :arg use_trailing_solidus: Includes a close-tag slash at the end of the
            start tag of void elements (empty elements whose end tag is
            forbidden). E.g. ``<hr/>``.

            Defaults to ``False``.

        :arg space_before_trailing_solidus: Places a space immediately before
            the closing slash in a tag using a trailing solidus. E.g.
            ``<hr />``. Requires ``use_trailing_solidus=True``.

            Defaults to ``True``.

        :arg sanitize: Strip all unsafe or unknown constructs from output.
            See :py:class:`html5lib.filters.sanitizer.Filter`.

            Defaults to ``False``.

        :arg omit_optional_tags: Omit start/end tags that are optional.

            Defaults to ``True``.

        :arg alphabetical_attributes: Reorder attributes to be in alphabetical order.

            Defaults to ``False``.

        rz2__init__() got an unexpected keyword argument '%s'r=FN)�	frozenset�options�len�	TypeError�next�iterr>�setattrr$�getattr�errors�strict)�self�kwargsZunexpected_args�attrr/r/r0�__init__�sO
zHTMLSerializer.__init__cCs|jr|�|jd�S|SdS)Nr2�r7�encode�rT�stringr/r/r0rY�szHTMLSerializer.encodecCs|jr|�|jd�S|SdS)NrSrXrZr/r/r0�encodeStrict�szHTMLSerializer.encodeStrictNccs�||_d}g|_|r0|jr0ddlm}|||�}|jrJddlm}||�}|jrdddlm}||�}|j	r~ddl
m}||�}|jr�ddlm}||�}|D�]>}|d}|dk�r\d|d}|dr�|d	|d7}n|d
r�|d7}|d
�rF|d
�
d�d
k�r,|d
�
d�d
k�r&|�d�d}nd}|d||d
|f7}|d7}|�|�Vq�|dk�r�|dk�sv|�r�|�r�|d�
d�d
k�r�|�d�|�|d�Vn|�t|d��Vq�|dk�r�|d}	|�d|	�V|	tk�r�|j�s�d}n|�r|�d�|d��D�]�\\}
}}|}
|}|�d�V|�|
�V|j�rv|
t�|	t��k�r|
t�dt��k�r|�d�V|jdk�s�t|�d
k�r�d}n@|jdk�r�t�|�dk	}n$|jd k�r�t�|�dk	}ntd!��|�d"d#�}|j �r|�d$d%�}|�r�|j!}|j"�rHd|k�r0d|k�r0d}nd|k�rHd|k�rHd}|dk�r`|�dd&�}n|�dd'�}|�|�V|�|�V|�|�Vn|�|�V�q|	t#k�r�|j$�r�|j%�r�|�d(�Vn|�d)�V|�d�Vq�|d*k�r(|d}	|	tk�rd}n|�r|�d�|�d+|	�Vq�|d,k�rj|d}|�
d-�d
k�rT|�d.�|�d/|d�Vq�|d0k�r�|d}	|	d1}|t&k�r�|�d2|	�|j'�r�|t(k�r�t&|}nd3|	}|�|�Vq�|�|d�q�dS)4NFr)�Filter�typeZDoctypez<!DOCTYPE %s�nameZpublicIdz PUBLIC "%s"ZsystemIdz SYSTEMr;r�'zASystem identifer contains both single and double quote charactersz %s%s%s�>)Z
Characters�SpaceCharactersrb�dataz</zUnexpected </ in CDATA)ZStartTagZEmptyTagz<%sTz+Unexpected child element of a CDATA element� r�=�always�specr:z?quote_attr_values must be one of: 'always', 'spec', or 'legacy'rz&amp;�<z&lt;z&#39;z&quot;z /�/ZEndTagz</%s>�Commentz--zComment contains --z	<!--%s-->ZEntityrzEntity %s not recognizedz&%s;))r7rRrGZfilters.inject_meta_charsetr]rFZfilters.alphabeticalattributesrHZfilters.whitespacerIZfilters.sanitizerr?Zfilters.optionaltags�find�serializeErrorr\rYrrrD�itemsr@r
r$�tupler<rL�_quoteAttributeSpec�search�_quoteAttributeLegacy�
ValueError�replacerCr=r>r	rArBr
rEr)rT�
treewalkerr7Zin_cdatar]�tokenr^Zdoctyper=r_�_Z	attr_nameZ
attr_value�k�vZ
quote_attrrc�keyr/r/r0r9�s�









��








zHTMLSerializer.serializecCs2|rd�t|�||���Sd�t|�|���SdS)anSerializes the stream from the treewalker into a string

        :arg treewalker: the treewalker to serialize

        :arg encoding: the string encoding to use

        :returns: the serialized tree

        Example:

        >>> from html5lib import parse, getTreeWalker
        >>> from html5lib.serializer import HTMLSerializer
        >>> token_stream = parse('<html><body>Hi!</body></html>')
        >>> walker = getTreeWalker('etree')
        >>> serializer = HTMLSerializer(omit_optional_tags=False)
        >>> serializer.render(walker(token_stream))
        '<html><head></head><body>Hi!</body></html>'

        �rN)r'�listr9)rTrtr7r/r/r0r5wszHTMLSerializer.render�XXX ERROR MESSAGE NEEDEDcCs|j�|�|jrt�dS)N)rRr"rS�SerializeError)rTrcr/r/r0rl�szHTMLSerializer.serializeError)N)N)r|)�__name__�
__module__�__qualname__r<r=r>r?r@rArBrCrDrErFrGrHrIrKrWrYr\r9r5rlr/r/r/r0r4hs,Y


r4c@seZdZdZdS)r}zError in serialized treeN)r~rr��__doc__r/r/r/r0r}�sr})r3N)+Z
__future__rrrZpip._vendor.sixr�re�codecsrrZ	constantsr	r
rrr
rrrrZxml.sax.saxutilsrr'Z_quoteAttributeSpecChars�compilerorqr#rLZ_is_ucs4r{rmrwrxr r!�islowerr1r9rr4�	Exceptionr}r/r/r/r0�<module>sD
�
�
�


1site-packages/pip/_vendor/html5lib/__pycache__/_inputstream.cpython-38.pyc000064400000052620151446177000022614 0ustar00U

��.e(�!@sddlmZmZmZddlmZmZddlmZm	Z	ddl
Z
ddlZddlm
Z
ddlmZmZmZmZddlmZdd	lmZdd
lmZzddlmZWnek
r�eZYnXedd
�eD��Zedd
�eD��Zedd
�eD��Zeeddg�BZdZej �rJeddk�r&e�!d�dk�s*t"�e�#edd�e$d�d�Z%n
e�#e�Z%e&ddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5g �Z'e�#d6�Z(iZ)Gd7d8�d8e*�Z+d9d:�Z,Gd;d<�d<e*�Z-Gd=d>�d>e-�Z.Gd?d@�d@e/�Z0GdAdB�dBe*�Z1GdCdD�dDe*�Z2dEdF�Z3dS)G�)�absolute_import�division�unicode_literals)�	text_type�binary_type)�http_client�urllibN)�webencodings�)�EOF�spaceCharacters�asciiLetters�asciiUppercase)�_ReparseException)�_utils)�StringIO)�BytesIOcCsg|]}|�d��qS��ascii��encode��.0�item�r�E/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_inputstream.py�
<listcomp>srcCsg|]}|�d��qSrrrrrrrscCsg|]}|�d��qSrrrrrrrs�>�<u�[---Ÿ﷐-﷯￾￿🿾🿿𯿾𯿿𿿾𿿿񏿾񏿿񟿾񟿿񯿾񯿿񿿾񿿿򏿾򏿿򟿾򟿿򯿾򯿿򿿾򿿿󏿾󏿿󟿾󟿿󯿾󯿿󿿾󿿿􏿾􏿿]����]z"\uD800-\uDFFF"i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��i��	i��	i��
i��
i��i��i��i��i��
i��
i��i��i��i��i��i��z[	-
 -/:-@\[-`{-~]c@sHeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dS)�BufferedStreamz�Buffering for streams that do not have buffering of their own

    The buffer is implemented as a list of chunks on the assumption that
    joining many strings will be slow since it is O(n**2)
    cCs||_g|_ddg|_dS)Nrr)�stream�buffer�position)�selfr"rrr�__init__@szBufferedStream.__init__cCs<d}|jd|jd�D]}|t|�7}q||jd7}|S�Nrr
)r#r$�len)r%�pos�chunkrrr�tellEs
zBufferedStream.tellcCsT||��kst�|}d}t|j|�|krF|t|j|�8}|d7}q||g|_dSr')�_bufferedBytes�AssertionErrorr(r#r$)r%r)�offset�irrr�seekLs
zBufferedStream.seekcCsT|js|�|�S|jdt|j�krF|jdt|jd�krF|�|�S|�|�SdS)Nrr
r)r#�_readStreamr$r(�_readFromBuffer)r%�bytesrrr�readUs
�
zBufferedStream.readcCstdd�|jD��S)NcSsg|]}t|��qSr)r(rrrrr_sz1BufferedStream._bufferedBytes.<locals>.<listcomp>)�sumr#�r%rrrr,^szBufferedStream._bufferedBytescCs<|j�|�}|j�|�|jdd7<t|�|jd<|Sr')r"r4r#�appendr$r()r%r3�datarrrr1as
zBufferedStream._readStreamcCs�|}g}|jd}|jd}|t|j�kr�|dkr�|dks>t�|j|}|t|�|krl|}|||g|_n"t|�|}|t|�g|_|d7}|�||||��||8}d}q|r�|�|�|��d�|�S)Nrr
�)r$r(r#r-r7r1�join)r%r3ZremainingBytes�rvZbufferIndexZbufferOffsetZbufferedDataZbytesToReadrrrr2hs&


zBufferedStream._readFromBufferN)�__name__�
__module__�__qualname__�__doc__r&r+r0r4r,r1r2rrrrr!9s		r!cKs�t|tj�s(t|tjj�r.t|jtj�r.d}n&t|d�rJt|�d�t	�}n
t|t	�}|r�dd�|D�}|rvt
d|��t|f|�St|f|�SdS)NFr4rcSsg|]}|�d�r|�qS)Z	_encoding)�endswith)r�xrrrr�s
z#HTMLInputStream.<locals>.<listcomp>z3Cannot set an encoding with a unicode input, set %r)
�
isinstancerZHTTPResponserZresponseZaddbase�fp�hasattrr4r�	TypeError�HTMLUnicodeInputStream�HTMLBinaryInputStream)�source�kwargsZ	isUnicodeZ	encodingsrrr�HTMLInputStream�s��

rJc@speZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
ddd�Zdd�Zdd�Z
ddd�Zdd�ZdS)rF��Provides a unicode stream of characters to the HTMLTokenizer.

    This class takes care of character encoding and removing or replacing
    incorrect byte-sequences and also provides column and line tracking.

    i(cCsZtjsd|_ntd�dkr$|j|_n|j|_dg|_td�df|_|�	|�|_
|��dS)�Initialises the HTMLInputStream.

        HTMLInputStream(source, [encoding]) -> Normalized stream from source
        for use by html5lib.

        source can be either a file-object, local filename or a string.

        The optional encoding parameter must be a string that indicates
        the encoding.  If specified, that encoding will be used,
        regardless of any BOM or later declaration (such as in a meta
        element)

        Nu􏿿r
r�utf-8�certain)r�supports_lone_surrogates�reportCharacterErrorsr(�characterErrorsUCS4�characterErrorsUCS2ZnewLines�lookupEncoding�charEncoding�
openStream�
dataStream�reset)r%rHrrrr&�s
zHTMLUnicodeInputStream.__init__cCs.d|_d|_d|_g|_d|_d|_d|_dS)N�r)r*�	chunkSize�chunkOffset�errors�prevNumLines�prevNumCols�_bufferedCharacterr6rrrrW�szHTMLUnicodeInputStream.resetcCst|d�r|}nt|�}|S�zvProduces a file object from source.

        source can be either a file object, local filename or a string.

        r4)rDr�r%rHr"rrrrU�s
z!HTMLUnicodeInputStream.openStreamcCsT|j}|�dd|�}|j|}|�dd|�}|dkr@|j|}n||d}||fS)N�
rrr
)r*�countr\�rfindr])r%r.r*ZnLinesZpositionLineZlastLinePosZpositionColumnrrr�	_position�s
z HTMLUnicodeInputStream._positioncCs|�|j�\}}|d|fS)z:Returns (line, col) of the current position in the stream.r
)rdrZ)r%�line�colrrrr$�szHTMLUnicodeInputStream.positioncCs6|j|jkr|��stS|j}|j|}|d|_|S)zo Read one character from the stream or queue if available. Return
            EOF when EOF is reached.
        r
)rZrY�	readChunkrr*)r%rZ�charrrrrh�s

zHTMLUnicodeInputStream.charNcCs�|dkr|j}|�|j�\|_|_d|_d|_d|_|j�|�}|j	rX|j	|}d|_	n|s`dSt
|�dkr�t|d�}|dks�d|kr�dkr�nn|d|_	|dd�}|jr�|�|�|�
d	d
�}|�
dd
�}||_t
|�|_dS)
NrXrFr
r�
��i��z
ra�
T)�_defaultChunkSizerdrYr\r]r*rZrVr4r^r(�ordrP�replace)r%rYr8Zlastvrrrrg�s0
 


z HTMLUnicodeInputStream.readChunkcCs(ttt�|���D]}|j�d�qdS)N�invalid-codepoint)�ranger(�invalid_unicode_re�findallr[r7)r%r8�_rrrrQ%sz*HTMLUnicodeInputStream.characterErrorsUCS4cCs�d}t�|�D]�}|rqt|���}|��}t�|||d��rrt�|||d��}|tkrl|j	�
d�d}q|dkr�|dkr�|t|�dkr�|j	�
d�qd}|j	�
d�qdS)NF�roTrji��r
)rq�finditerrm�group�startrZisSurrogatePairZsurrogatePairToCodepoint�non_bmp_invalid_codepointsr[r7r()r%r8�skip�matchZ	codepointr)Zchar_valrrrrR)s"�z*HTMLUnicodeInputStream.characterErrorsUCS2Fc
Cszt||f}Wnhtk
rx|D]}t|�dks$t�q$d�dd�|D��}|sZd|}t�d|�}t||f<YnXg}|�|j|j	�}|dkr�|j	|j
kr�q�n0|��}||j
kr�|�|j|j	|��||_	q�|�|j|j	d��|�
�s~q�q~d�|�}	|	S)z� Returns a string of characters from the stream up to but not
        including any character in 'characters' or EOF. 'characters' must be
        a container that supports the 'in' method and iteration over its
        characters.
        �rXcSsg|]}dt|��qS)z\x%02x)rm)r�crrrrNsz5HTMLUnicodeInputStream.charsUntil.<locals>.<listcomp>z^%sz[%s]+N)�charsUntilRegEx�KeyErrorrmr-r:�re�compilerzr*rZrY�endr7rg)
r%Z
charactersZopposite�charsr|Zregexr;�mr��rrrr�
charsUntil@s0 

z!HTMLUnicodeInputStream.charsUntilcCsT|dk	rP|jdkr.||j|_|jd7_n"|jd8_|j|j|ksPt�dSr')rZr*rYr-)r%rhrrr�ungetos
zHTMLUnicodeInputStream.unget)N)F)r<r=r>r?rlr&rWrUrdr$rhrgrQrRr�r�rrrrrF�s 
&
/rFc@sLeZdZdZddd�Zdd�Zd	d
�Zddd�Zd
d�Zdd�Z	dd�Z
dS)rGrKN�windows-1252TcCsn|�|�|_t�||j�d|_d|_||_||_||_||_	||_
|�|�|_|jddk	sbt
�|��dS)rLi�drN)rU�	rawStreamrFr&�numBytesMeta�numBytesChardet�override_encoding�transport_encoding�same_origin_parent_encoding�likely_encoding�default_encoding�determineEncodingrTr-rW)r%rHr�r�r�r�r�Z
useChardetrrrr&�szHTMLBinaryInputStream.__init__cCs&|jdj�|jd�|_t�|�dS)Nrrn)rTZ
codec_info�streamreaderr�rVrFrWr6rrrrW�szHTMLBinaryInputStream.resetcCsDt|d�r|}nt|�}z|�|���Wnt|�}YnX|Sr_)rDrr0r+r!r`rrrrU�s
z HTMLBinaryInputStream.openStreamcCs�|��df}|ddk	r|St|j�df}|ddk	r:|St|j�df}|ddk	rX|S|��df}|ddk	rt|St|j�df}|ddk	r�|dj�d�s�|St|j�df}|ddk	r�|S|�rpzddl	m
}Wntk
r�Yn�Xg}|�}|j�s<|j
�|j�}t|t��st�|�s&�q<|�|�|�|�q�|��t|jd�}|j
�d�|dk	�rp|dfSt|j�df}|ddk	�r�|Std�dfS)NrNrZ	tentativezutf-16)�UniversalDetector�encodingr�)�	detectBOMrSr�r��detectEncodingMetar��name�
startswithr�Z%pip._vendor.chardet.universaldetectorr��ImportErrorZdoner�r4r�rBr3r-r7Zfeed�close�resultr0r�)r%ZchardetrTr�ZbuffersZdetectorr#r�rrrr��sR

z'HTMLBinaryInputStream.determineEncodingcCs�|jddkst�t|�}|dkr&dS|jdkrFtd�}|dk	s�t�nT||jdkrf|jddf|_n4|j�d�|df|_|��td|jd|f��dS)Nr
rN��utf-16be�utf-16lerMrzEncoding changed from %s to %s)rTr-rSr�r�r0rWr)r%ZnewEncodingrrr�changeEncodings

z$HTMLBinaryInputStream.changeEncodingc
Cs�tjdtjdtjdtjdtjdi}|j�d�}t|t	�s<t
�|�|dd��}d}|s~|�|�}d}|s~|�|dd	��}d	}|r�|j�|�t
|�S|j�d
�dSdS)z�Attempts to detect at BOM at the start of the stream. If
        an encoding can be determined from the BOM return the name of the
        encoding otherwise return NonerMr�r�zutf-32lezutf-32be�N�rtr)�codecs�BOM_UTF8�BOM_UTF16_LE�BOM_UTF16_BE�BOM_UTF32_LE�BOM_UTF32_BEr�r4rBr3r-�getr0rS)r%ZbomDict�stringr�r0rrrr�s4�
zHTMLBinaryInputStream.detectBOMcCsV|j�|j�}t|t�st�t|�}|j�d�|��}|dk	rR|j	dkrRt
d�}|S)z9Report the encoding declared by the meta element
        rNr�rM)r�r4r�rBr3r-�EncodingParserr0�getEncodingr�rS)r%r#�parserr�rrrr�9sz(HTMLBinaryInputStream.detectEncodingMeta)NNNNr�T)T)r<r=r>r?r&rWrUr�r�r�r�rrrrrG�s�
*
>"rGc@s�eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zeee
�Z
dd�Zee�Zefdd�Zdd�Zdd�Zdd�ZdS)�
EncodingBytesz�String-like object with an associated position and various extra methods
    If the position is ever greater than the string length then an exception is
    raisedcCst|t�st�t�||���S�N)rBr3r-�__new__�lower�r%�valuerrrr�LszEncodingBytes.__new__cCs
d|_dS)Nr)rdr�rrrr&PszEncodingBytes.__init__cCs|Sr�rr6rrr�__iter__TszEncodingBytes.__iter__cCs>|jd}|_|t|�kr"t�n|dkr.t�|||d�S)Nr
r�rdr(�
StopIterationrE�r%�prrr�__next__WszEncodingBytes.__next__cCs|��Sr�)r�r6rrr�next_szEncodingBytes.nextcCsB|j}|t|�krt�n|dkr$t�|d|_}|||d�Sr'r�r�rrr�previouscszEncodingBytes.previouscCs|jt|�krt�||_dSr��rdr(r�)r%r$rrr�setPositionlszEncodingBytes.setPositioncCs*|jt|�krt�|jdkr"|jSdSdS)Nrr�r6rrr�getPositionqs

zEncodingBytes.getPositioncCs||j|jd�S�Nr
)r$r6rrr�getCurrentByte{szEncodingBytes.getCurrentBytecCsH|j}|t|�kr>|||d�}||kr4||_|S|d7}q||_dS)zSkip past a list of charactersr
N�r$r(rd�r%r�r�r|rrrry�s
zEncodingBytes.skipcCsH|j}|t|�kr>|||d�}||kr4||_|S|d7}q||_dSr�r�r�rrr�	skipUntil�s
zEncodingBytes.skipUntilcCs>|j}|||t|��}|�|�}|r:|jt|�7_|S)z�Look for a sequence of bytes at the start of a string. If the bytes
        are found return True and advance the position to the byte after the
        match. Otherwise return False and leave the position alone)r$r(r�)r%r3r�r8r;rrr�
matchBytes�s
zEncodingBytes.matchBytescCsR||jd��|�}|dkrJ|jdkr,d|_|j|t|�d7_dSt�dS)z�Look for the next sequence of bytes matching a given sequence. If
        a match is found advance the position to the last byte of the matchNrrr
T)r$�findrdr(r�)r%r3ZnewPositionrrr�jumpTo�s
zEncodingBytes.jumpToN)r<r=r>r?r�r&r�r�r�r�r�r��propertyr$r��currentByte�spaceCharactersBytesryr�r�r�rrrrr�Hs 	
r�c@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)r�z?Mini parser for detecting character encoding from meta elementscCst|�|_d|_dS)z3string - the data to work on for encoding detectionN)r�r8r��r%r8rrrr&�s
zEncodingParser.__init__c
Cs�d|jfd|jfd|jfd|jfd|jfd|jff}|jD]Z}d}|D]D\}}|j�|�rFz|�}Wq�WqFtk
r�d}Yq�YqFXqF|s:q�q:|jS)	Ns<!--s<metas</s<!s<?rTF)	�
handleComment�
handleMeta�handlePossibleEndTag�handleOther�handlePossibleStartTagr8r�r�r�)r%ZmethodDispatchrsZkeepParsing�key�methodrrrr��s(�

zEncodingParser.getEncodingcCs|j�d�S)zSkip over commentss-->�r8r�r6rrrr��szEncodingParser.handleCommentcCs�|jjtkrdSd}d}|��}|dkr,dS|ddkr\|ddk}|r�|dk	r�||_dSq|ddkr�|d}t|�}|dk	r�||_dSq|ddkrtt|d��}|��}|dk	rt|�}|dk	r|r�||_dS|}qdS)	NTFrs
http-equivr
scontent-type�charsetscontent)	r8r�r��getAttributer�rS�ContentAttrParserr��parse)r%Z	hasPragmaZpendingEncoding�attrZtentativeEncoding�codecZ
contentParserrrrr��s8zEncodingParser.handleMetacCs
|�d�S)NF)�handlePossibleTagr6rrrr��sz%EncodingParser.handlePossibleStartTagcCst|j�|�d�S)NT)r�r8r�r6rrrr��s
z#EncodingParser.handlePossibleEndTagcCsb|j}|jtkr(|r$|��|��dS|�t�}|dkrD|��n|��}|dk	r^|��}qLdS)NTr)r8r��asciiLettersBytesr�r�r��spacesAngleBracketsr�)r%ZendTagr8r|r�rrrr��s



z EncodingParser.handlePossibleTagcCs|j�d�S)Nrr�r6rrrr�szEncodingParser.handleOthercCs�|j}|�ttdg�B�}|dks2t|�dks2t�|dkr>dSg}g}|dkrV|rVq�nX|tkrj|��}q�nD|dkr�d�|�dfS|tkr�|�|�	��n|dkr�dS|�|�t
|�}qF|dkr�|��d�|�dfSt
|�|��}|dk�rJ|}t
|�}||k�r"t
|�d�|�d�|�fS|tk�r<|�|�	��q�|�|�q�nJ|d	k�rbd�|�dfS|tk�r||�|�	��n|dk�r�dS|�|�t
|�}|tk�r�d�|�d�|�fS|tk�r�|�|�	��n|dk�r�dS|�|��q�dS)
z_Return a name,value pair for the next attribute in the stream,
        if one is found, or None�/Nr
)rN�=)r�rr9)�'�"r)
r8ryr��	frozensetr(r-r:�asciiUppercaseBytesr7r�r�r�r�)r%r8r|ZattrNameZ	attrValueZ	quoteCharrrrr�sb











zEncodingParser.getAttributeN)
r<r=r>r?r&r�r�r�r�r�r�r�r�rrrrr��s$r�c@seZdZdd�Zdd�ZdS)r�cCst|t�st�||_dSr�)rBr3r-r8r�rrrr&fszContentAttrParser.__init__cCs�z�|j�d�|jjd7_|j��|jjdks<WdS|jjd7_|j��|jjdkr�|jj}|jjd7_|jj}|j�|�r�|j||jj�WSWdSnR|jj}z"|j�t�|j||jj�WWStk
�r�|j|d�YWSXWntk
�rYdSXdS)Nr�r
r�)r�r�)r8r�r$ryr�r�r�r�)r%Z	quoteMarkZoldPositionrrrr�js.

zContentAttrParser.parseN)r<r=r>r&r�rrrrr�esr�cCsft|t�r0z|�d�}Wntk
r.YdSX|dk	r^zt�|�WStk
rZYdSXndSdS)z{Return the python codec name corresponding to an encoding or None if the
    string doesn't correspond to a valid encoding.rN)rBr�decode�UnicodeDecodeErrorr	�lookup�AttributeError)r�rrrrS�s

rS)4Z
__future__rrrZpip._vendor.sixrrZpip._vendor.six.movesrrr�rZpip._vendorr	Z	constantsrrr
rrrXr�iorrr�r�r�r�r�r�Zinvalid_unicode_no_surrogaterOrbr-r��evalrq�setrxZascii_punctuation_rer}�objectr!rJrFrGr3r�r�r�rSrrrr�<module>s�
"��
�
JgIh6'site-packages/pip/_vendor/html5lib/__pycache__/constants.cpython-38.pyc000064400000201415151446177000022114 0ustar00U

��.e>F��@s�-ddlmZmZmZddlZdZddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d,d,d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d���Zd�d�d�d�d�d�d��Zeed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fg�Z	eed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fg�Z
eed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fed�d�fgN�Zeed�d�fed�d�fed�d�fed�d�fg�Zeed�d�fed�d�fed�d�fed�d�fed�d�fg�Z
d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d'�d(�d)�d*�d+�d,�d-�d.�>Z�d/�d0iZ�d1�d2e�d1f�d1�d3e�d1f�d1�d4e�d1f�d1�d5e�d1f�d1�d6e�d1f�d1d�e�d1f�d1�d7e�d1f�d8d�e�d8f�d8�d9e�d8f�d8�d:e�d8fd�d;e�d;f�d;�d1e�d;f�d<�Ze�d=�d>�e��D��Ze�d?�d@�dA�dB�dCg�Zed�d�d�d�d�g�Zeej�Zeej�Zeej�Zeej�Zeej�Ze�dD�d>�ejD��Z�dEZ ed�d��dFd�d�d�d�d�d�d�d�d�dԐdG�dHg�Z!ed�d�g�Z"ed�d�d�d�d�d�d�g�Z#e�dI�dJg�e�dKg�e�dLg�e�dM�dNg�e�dM�dNg�e�dO�dPg�e�dQg�e�dR�dSg�e�dT�dS�dU�dVg�e�dWg�e�dXg�e�dS�dYg�e�dS�dY�dZg�e�dS�dYg�e�dS�d[g�e�dS�dY�d\�d[�dU�dLg�e�dS�dY�d[�dRg�e�dS�dYg�e�d]g��d^�Z$�d_Z%e�d`�da�db�dc�ddg�Z&�de�de�df�df�dg�dg�dh�di�di�dj�dk�dl�dl�dm�dn�do�dp�dq�dr�ds�ds�dt�du�dv�dv�dw�dw�dx�dy�dz�d{�d|�d}�d~�d�d��d��d}�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdȐdɐdʐdːd̐d͐dΐdϐdАdѐdҐd��dӐdԐdՐd֐d֐dאdאdؐdِdِdڐdېdܐdݐdݐdސdߐd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d��d��d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d �d!�d"�d#�d$�d%�d&�d'�d(�d)�d*�d*�d+�d,�d-�d.�d/�d0�d1�d2�d3�d4�d5�d6�d7�d8�d9�d:�d;�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dF�dG�dH�dI�dJ�dK�dL�dM�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dW�dX�dY�dZ�d[�d��d��d\�d]�d^�d_�d`�da�db�dc�dd�de�df�dg�dh�d��d��d��di�dj�dk�d?�dl�dm�dn�do�dp�dq�dr�ds�dt�du�dr�dv�dw�dx�dy�dz�d{�d|�d|�d|�d|�d	�dn�d@�d}�d~�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdǐdȐdȐdɐdʐdʐdːd̐d͐dΐdϐdАdѐdҐdӐdԐd�dՐd֐dאdؐdِdڐdېdܐd��dݐdސdߐd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d��d�d�d�d�d�d�d�d�d��d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�d�d�dƐdE�d�d�d�d�d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d&�d'�d(�d)�d*�d+�d�d,�d-�d.�d/�d-�d0�d0�d1�d2�d3�d?�d4�d5�d6�d7�d8�d9�d:�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dE�dF�dG�dH�dI�dJ�dJ�dK�dL�dM�dN�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dW�d�dX�dY�dZ�d[�d\�d]�dÐdĐd^�d_�d`�da�db�dc�dd�de�de�df�dg�dh�di�dj�dk�dl�dl�dm�dn�do�dp�dq�dr�ds�dt�du�dv�dw�dx�dy�dz�d{�d|�d}�d~�d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d|�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��dr�d��d��d��d��d��d��d��d��df�df�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ds�d��d��d��d@�d��d��d��d��d��d@�d��d��d��d��d��d@�d��d��d��d��d��d��d��ddÐdĐdŐdƐdǐdȐdɐdɐdR�dʐdÐdːd̐d|�d|�d͐dĐd}�dΐdϐdАdѐd!�dҐdT�dӐdԐdՐd֐dאdؐdِdڐdk�dw�dېdܐd�dݐdސdߐd�d�d�d�d�d�d�d�d�d�d\�d\�d�d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d��d�d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�d�d�d�dŐd��d�d�d�d�dƐdǐd�d�d�d�d�d��d�d�d�d�d�d �d!�d"�d#�d$�d%�d&�d�d'�d(�d)�d)�d*�d+�d,�d-�d��d��d.�d/�d/�d��d0�d1�d2�d2�d3�d4�d5�d6�d7�d8�d9�d�d:�d;�d<�d=�d7�d>�d?�d@�dA�dA�dB�du�du�dC�dD�dE�d�dE�d��d?�dF�d��dG�d��d��d��dH�dI�dJ�dK�dL�dM�dN�dO�dP�dQ�dR�dS�dT�dU�dV�dW�dX�dY�dZ�d[�d\�d]�d^�d_�dS�dT�d`�da�db�db�dU�d^�d`�da�d��dc�dd�d��de�df�dg�dƐdh�dP�di�d��dj�dk�d��d��dl�dm�dn�dn�do�dp�dq�dr�dK�d��d��d��ds�ds�d��dt�du�dv�dv�dv�dw�dw�dx�dy�dz�d{�d|�d��d��d}�d~�d�d��dz�dƐdl�dK�d��d�d��d��d��d��d��d��d��d��dސdȐd�d��d��d��dm�d}�d��d��d��d��d��d��d��d��d��d��d�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d�d��d��d��d��d��d��d��d��d��d��d��d�d��d��d��d��d��d��d��d�d�d�d��d��d��d��d��d��d��d��d��d��ddÐdĐdŐd�dƐdǐdȐdɐdɐdʐdːdːd̐d͐dΐdϐdАdѐdѐdҐdӐdԐdՐd֐dאdؐdِdڐd�dېdܐdݐdt�dސdߐd�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d�d	�d��d�d�d�d�d�d�d�d�d�d�d�d�d�d�d��d�d�d��d��d��d��d��d��d��d��d��dސd��d��d�dېd�d�d��d��d��dq�dɐd�d��dN�d��d�d�d�d�d�d�d�d�d�d�d	�d
�d�d�d
�d�d�d�d�d�dh�d�d�d"�d�d�d�d�d�d�d��d�d�d�d�d�d�d�d�d�d�d�d'�d�d�d �d!�dސd"�d#�d$�d�d �d%�d��d%�d&�d'�d(�d)�d*�d+�d'�d,�d,�d-�dސd.�d/�d0�d1�dސd#�d2�d3�d4�d4�d5�d6�d7�d8�d9�d:�d;�d<�d=�d>�d?�d@�dA�dB�dC�dD�dE�dF�dd�d��dG�dH�d]�dI�dJ�dK�dL�d?�dM�dD�dN�dD�dO�dP�dP�dE�dF�dQ�dR�d�dS�dT�dU�dV�dW�dX�dY�dZ�d[�d\�d]�d^�d_�d`�da�db�dc�dH�d]�dd�de�dÐd̐df�dg�dh�di�dE�dV�d̐dZ�dj�dN�dG�d�d�dk�d\�di�d]�d`�d`�dl�dm�dn�do�dp�dq�dO�dr�d\�dI�d^�da�ds�dM�dt�d^�du�d̐dZ�dv�dw�dx�dn�dj�dy�dy�dz�d{�d|�d|�d}�d~�d~�d�d�d}�d��d��d��dI�df�dg�d��dh�dS�d��d��d��d��d��d��dP�d��d��dܐd��d��dG�d��d�d��d��d��d��d��dl�da�d��d��d^�dĐd��d��d;�d;�d��d��dr�dk�d��d��d��d��d��dU�dߐd��d��d��d��d��d��d��d��d��d��d��d��dҐdQ�d]�d��d��d��d��d��d��d��d��d��dm�d��d��d��d��d��d�d~�d��d��d�dt�d��d��dt�d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��d��ddd��d�d�d��d��dÐdĐdŐd��dƐdǐdȐdɐd��dʐdːd_�d_�d̐d��d͐d��d��d��dΐd��d��d��d��d��d��d��d��d��d��dϐdАd�dѐdҐd�dӐd��dԐdՐd֐d��dՐdϐd��dԐd��d��d��d��d��d��d��d��dאdؐdؐd��dِdڐd��dېdܐd��d��dݐdސd��d��dߐd�d�d��d��d��d��d��d��d�d�d�d�d��d��d��d��d��d�d��d��d��d��d��d��d��d��d��d�d�d��d��d��d�d��d��d�d�d��d��d��d�d��d�d�d��d��d��d��d��d�d�d�d�d�d�d�d�d�d�d��d��d��d��d��d��d��d��d��d��d^�d^�d��d:�d�d�d;�d<�d�d�d�d=�d�d�d��d�d�d�d�d	�d
�d
�d�d�d��d��d8�d
�d�dːd�d�d�d�d�d��d�d�d�d��d�d9�d�d�d�d�d�d�d�d�d�d�d�d�d �d �d!�d"�d"�d��d#�d$�d$�d%�dŐd&�d&�dŐd'�d(�dϐd)�d*�d+�d,�d\�d-�d.�d/�d0�dr�d1�d2�dƐd3�d�d4�d�d5�d6�d	�d7�d�d8�d9�dԐdԐd:�d;�dԐd<�d=�d>�d>�dאd?�d@�dِdؐdאd@�dِdؐdA�dB�dC�dڐdD�dՐdB�dA�dC�dܐdE�dF�dG�dݐdݐdڐdH�dI�dJ�dK�dL�d�dM�dN�dO�d�dP�dQ�d��d�d�d
�d��dR�di�dS�dT�dU�d�dV�d�dW�dX�d�dY�dY�d�dZ�d�d[�d\�d]�d�d��d^�d_�d`�da�db�dc�d�dېdd�de�df�dg�dh�di�dj�dk�d��de�dl�dm�dn�d��d��do�d�d�d�d�dp�d�d�dq�d��dr�dϐd�ds�dt�du�d�d`�dϐd�d��d�dv�da�dw�dx�d��d��d�dy�dz�dz�d{�d|�d}�d��d~�d�d��d��d��d��d��dv�d��d��d�df�d��d��dw�d��d��d�d�d��d��d��d��d��d(�d��d��d��d*�d)�d��d��d��d��d��d��d+�d��d��d��d��d��d�dk�dk�d��d��d��d��dx�dx�d��d��dِd��d��d��dm�dŐd��d��d��d��d��d=�d��d>�d>�d��d��d��d��d��d��d��dE�dx�d��d��dm�d��d��d��d��d��d��d��d��d��d��d��dŐd�d��d#�d��d�d �d�d �d!�d"�d!�d"�d�d�d�d�d�d��dx�d��d%�d��dאd��d0�d��d��d��d��d'�d��d��ddÐdĐdŐd��d'�d��dÐddƐdǐdȐd(�d��d*�d)�d��d��d��d+�d,�dɐdʐdʐdːdːd̐d̐d.�d͐dΐdϐd/�dАdѐdҐdӐdԐdՐd֐dאd.�d/�d͐d֐dՐdؐdِdڐdېd�dj�dj�dܐdݐdݐdސdߐd͐d�d�d�dB�d�d�d9�d9�d�d�d�d@�d=�d<�d@�d=�d�d�d��d�d�d
�d�d�d�d͐dѐd�d�d�d�d��d�d1�d�d��d��dU�d�d��d�d�d�d�d�d��d��d��d��d��d��d��dАd@�d�dÐd��d��d��d�d��d��d�d�d�dY�d�d[�d�d�d�d�dX�d�d�d�d�d�d	�d
�d��d��d�d�d�dZ�dX�d�dU�d
�d`�d
�d�d�d�d�d�d�d�d�d�d�dݐd�d�d�d�dĐd�d�dd�d��d>�d��d0�d3�dݐdZ�du�d��d�d�d�d�d�dS�d��d�d��d�d �d!�d"�dn�dn�d#�dS�d��d��d$�dݐd��d%�d�d�d�d�d&�d'�d(�d��d)�d*�d+�d,�d*�dp�dp�d-�d!�dҐdT�dؐd.�d��dg�d/�d��df�d��d0�dӐd1�dԐdՐd��dh�d2�d֐dڐdِdk�dw�d3�d3�d4�d5�d6�d7�d7�d8�d9�d:�d;�d<�d=�d=�d>�d?�d@�dA�d��dB�dC�dD�dE�dF�dG�dH�dI�dJ���Z'�dK�dC�d��dL�d��dĐd̐d�df�d��d6�d,�d�d��d��dM�d��dN�dO�dĐd��dÐd��d�dɐd��d��d1�d��d��d�dP�d?�d��dQ�"Z(d�dR�dS�dT�dU�dV�dW�dX�dY�Z)ee)�dZe)�d[e)�d\g�Z*e�d]�d>�e��D��Z+�d^e+d�<G�d_�d`��d`e,�Z-G�da�db��dbe.�Z/dS(c�)�absolute_import�division�unicode_literalsNz5Null character in input stream, replaced with U+FFFD.zInvalid codepoint in stream.z&Solidus (/) incorrectly placed in tag.z.Incorrect CR newline entity, replaced with LF.z9Entity used with illegal number (windows-1252 reference).zPNumeric entity couldn't be converted to character (codepoint U+%(charAsInt)08x).zBNumeric entity represents an illegal codepoint: U+%(charAsInt)08x.z#Numeric entity didn't end with ';'.z1Numeric entity expected. Got end of file instead.z'Numeric entity expected but none found.z!Named entity didn't end with ';'.z Named entity expected. Got none.z'End tag contains unexpected attributes.z.End tag contains unexpected self-closing flag.z#Expected tag name. Got '>' instead.zSExpected tag name. Got '?' instead. (HTML doesn't support processing instructions.)z-Expected tag name. Got something else insteadz6Expected closing tag. Got '>' instead. Ignoring '</>'.z-Expected closing tag. Unexpected end of file.z<Expected closing tag. Unexpected character '%(data)s' found.z'Unexpected end of file in the tag name.z8Unexpected end of file. Expected attribute name instead.z)Unexpected end of file in attribute name.z#Invalid character in attribute namez#Dropped duplicate attribute on tag.z1Unexpected end of file. Expected = or end of tag.z1Unexpected end of file. Expected attribute value.z*Expected attribute value. Got '>' instead.z"Unexpected = in unquoted attributez*Unexpected character in unquoted attributez*Unexpected character after attribute name.z+Unexpected character after attribute value.z.Unexpected end of file in attribute value (").z.Unexpected end of file in attribute value (').z*Unexpected end of file in attribute value.z)Unexpected end of file in tag. Expected >z/Unexpected character after / in tag. Expected >z&Expected '--' or 'DOCTYPE'. Not found.z Unexpected ! after -- in commentz$Unexpected space after -- in commentzIncorrect comment.z"Unexpected end of file in comment.z%Unexpected end of file in comment (-)z+Unexpected '-' after '--' found in comment.z'Unexpected end of file in comment (--).z&Unexpected character in comment found.z(No space after literal string 'DOCTYPE'.z.Unexpected > character. Expected DOCTYPE name.z.Unexpected end of file. Expected DOCTYPE name.z'Unexpected end of file in DOCTYPE name.z"Unexpected end of file in DOCTYPE.z%Expected space or '>'. Got '%(data)s'zUnexpected end of DOCTYPE.z Unexpected character in DOCTYPE.zXXX innerHTML EOFzUnexpected DOCTYPE. Ignored.z%html needs to be the first start tag.z)Unexpected End of file. Expected DOCTYPE.zErroneous DOCTYPE.z2Unexpected non-space characters. Expected DOCTYPE.z2Unexpected start tag (%(name)s). Expected DOCTYPE.z0Unexpected end tag (%(name)s). Expected DOCTYPE.z?Unexpected end tag (%(name)s) after the (implied) root element.z4Unexpected end of file. Expected end tag (%(name)s).z4Unexpected start tag head in existing head. Ignored.z'Unexpected end tag (%(name)s). Ignored.z;Unexpected start tag (%(name)s) that can be in head. Moved.z Unexpected start tag (%(name)s).zMissing end tag (%(name)s).zMissing end tags (%(name)s).zCUnexpected start tag (%(startName)s) implies end tag (%(endName)s).z@Unexpected start tag (%(originalName)s). Treated as %(newName)s.z,Unexpected start tag %(name)s. Don't use it!z'Unexpected start tag %(name)s. Ignored.zEUnexpected end tag (%(gotName)s). Missing end tag (%(expectedName)s).z:End tag (%(name)s) seen too early. Expected other end tag.zFUnexpected end tag (%(gotName)s). Expected end tag (%(expectedName)s).z+End tag (%(name)s) seen too early. Ignored.zQEnd tag (%(name)s) violates step 1, paragraph 1 of the adoption agency algorithm.zQEnd tag (%(name)s) violates step 1, paragraph 2 of the adoption agency algorithm.zQEnd tag (%(name)s) violates step 1, paragraph 3 of the adoption agency algorithm.zQEnd tag (%(name)s) violates step 4, paragraph 4 of the adoption agency algorithm.z>Unexpected end tag (%(originalName)s). Treated as %(newName)s.z'This element (%(name)s) has no end tag.z9Unexpected implied end tag (%(name)s) in the table phase.z>Unexpected implied end tag (%(name)s) in the table body phase.zDUnexpected non-space characters in table context caused voodoo mode.z3Unexpected input with type hidden in table context.z!Unexpected form in table context.zDUnexpected start tag (%(name)s) in table context caused voodoo mode.zBUnexpected end tag (%(name)s) in table context caused voodoo mode.zCUnexpected table cell start tag (%(name)s) in the table body phase.zFGot table cell end tag (%(name)s) while required end tags are missing.z?Unexpected end tag (%(name)s) in the table body phase. Ignored.z=Unexpected implied end tag (%(name)s) in the table row phase.z>Unexpected end tag (%(name)s) in the table row phase. Ignored.zJUnexpected select start tag in the select phase treated as select end tag.z/Unexpected input start tag in the select phase.zBUnexpected start tag token (%(name)s in the select phase. Ignored.z;Unexpected end tag (%(name)s) in the select phase. Ignored.zKUnexpected table element start tag (%(name)s) in the select in table phase.zIUnexpected table element end tag (%(name)s) in the select in table phase.z8Unexpected non-space characters in the after body phase.z>Unexpected start tag token (%(name)s) in the after body phase.z<Unexpected end tag token (%(name)s) in the after body phase.z@Unexpected characters in the frameset phase. Characters ignored.zEUnexpected start tag token (%(name)s) in the frameset phase. Ignored.zFUnexpected end tag token (frameset) in the frameset phase (innerHTML).zCUnexpected end tag token (%(name)s) in the frameset phase. Ignored.zEUnexpected non-space characters in the after frameset phase. Ignored.zEUnexpected start tag (%(name)s) in the after frameset phase. Ignored.zCUnexpected end tag (%(name)s) in the after frameset phase. Ignored.z(Unexpected end tag after body(innerHtml)z6Unexpected non-space characters. Expected end of file.z6Unexpected start tag (%(name)s). Expected end of file.z4Unexpected end tag (%(name)s). Expected end of file.z/Unexpected end of file. Expected table content.z0Unexpected end of file. Expected select content.z2Unexpected end of file. Expected frameset content.z0Unexpected end of file. Expected script content.z0Unexpected end of file. Expected foreign contentz0Trailing solidus not allowed on element %(name)sz2Element %(name)s not allowed in a non-html contextz*Unexpected end tag (%(name)s) before html.z9Element %(name)s not allowed in a inhead-noscript contextz8Unexpected end of file. Expected inhead-noscript contentz@Unexpected non-space character. Expected inhead-noscript contentz0Undefined error (this sucks and should be fixed))�znull-characterzinvalid-codepointzincorrectly-placed-soliduszincorrect-cr-newline-entityzillegal-windows-1252-entityzcant-convert-numeric-entityz$illegal-codepoint-for-numeric-entityz numeric-entity-without-semicolonz#expected-numeric-entity-but-got-eofzexpected-numeric-entityznamed-entity-without-semicolonzexpected-named-entityzattributes-in-end-tagzself-closing-flag-on-end-tagz'expected-tag-name-but-got-right-bracketz'expected-tag-name-but-got-question-markzexpected-tag-namez*expected-closing-tag-but-got-right-bracketz expected-closing-tag-but-got-eofz!expected-closing-tag-but-got-charzeof-in-tag-namez#expected-attribute-name-but-got-eofzeof-in-attribute-namez#invalid-character-in-attribute-namezduplicate-attributez$expected-end-of-tag-name-but-got-eofz$expected-attribute-value-but-got-eofz.expected-attribute-value-but-got-right-bracketz"equals-in-unquoted-attribute-valuez0unexpected-character-in-unquoted-attribute-valuez&invalid-character-after-attribute-namez*unexpected-character-after-attribute-valuez#eof-in-attribute-value-double-quotez#eof-in-attribute-value-single-quotez eof-in-attribute-value-no-quotesz#unexpected-EOF-after-solidus-in-tagz)unexpected-character-after-solidus-in-tagzexpected-dashes-or-doctypez,unexpected-bang-after-double-dash-in-commentz-unexpected-space-after-double-dash-in-commentzincorrect-commentzeof-in-commentzeof-in-comment-end-dashz,unexpected-dash-after-double-dash-in-commentzeof-in-comment-double-dashzeof-in-comment-end-space-statezeof-in-comment-end-bang-statezunexpected-char-in-commentzneed-space-after-doctypez+expected-doctype-name-but-got-right-bracketz!expected-doctype-name-but-got-eofzeof-in-doctype-namezeof-in-doctypez*expected-space-or-right-bracket-in-doctypezunexpected-end-of-doctypezunexpected-char-in-doctypezeof-in-innerhtmlzunexpected-doctypez
non-html-rootzexpected-doctype-but-got-eofzunknown-doctypezexpected-doctype-but-got-charsz"expected-doctype-but-got-start-tagz expected-doctype-but-got-end-tagzend-tag-after-implied-rootz&expected-named-closing-tag-but-got-eofz!two-heads-are-not-better-than-onezunexpected-end-tagz#unexpected-start-tag-out-of-my-headzunexpected-start-tagzmissing-end-tagzmissing-end-tagsz$unexpected-start-tag-implies-end-tagzunexpected-start-tag-treated-aszdeprecated-tagzunexpected-start-tag-ignoredz$expected-one-end-tag-but-got-anotherzend-tag-too-earlyzend-tag-too-early-namedzend-tag-too-early-ignoredzadoption-agency-1.1zadoption-agency-1.2zadoption-agency-1.3zadoption-agency-4.4zunexpected-end-tag-treated-asz
no-end-tagz#unexpected-implied-end-tag-in-tablez(unexpected-implied-end-tag-in-table-bodyz$unexpected-char-implies-table-voodooz unexpected-hidden-input-in-tablezunexpected-form-in-tablez)unexpected-start-tag-implies-table-voodooz'unexpected-end-tag-implies-table-voodoozunexpected-cell-in-table-bodyzunexpected-cell-end-tagz unexpected-end-tag-in-table-bodyz'unexpected-implied-end-tag-in-table-rowzunexpected-end-tag-in-table-rowzunexpected-select-in-selectzunexpected-input-in-selectzunexpected-start-tag-in-selectzunexpected-end-tag-in-selectz5unexpected-table-element-start-tag-in-select-in-tablez3unexpected-table-element-end-tag-in-select-in-tablezunexpected-char-after-bodyzunexpected-start-tag-after-bodyzunexpected-end-tag-after-bodyzunexpected-char-in-framesetz unexpected-start-tag-in-framesetz)unexpected-frameset-in-frameset-innerhtmlzunexpected-end-tag-in-framesetzunexpected-char-after-framesetz#unexpected-start-tag-after-framesetz!unexpected-end-tag-after-framesetz'unexpected-end-tag-after-body-innerhtmlzexpected-eof-but-got-charzexpected-eof-but-got-start-tagzexpected-eof-but-got-end-tagzeof-in-tablez
eof-in-selectzeof-in-framesetzeof-in-script-in-scriptzeof-in-foreign-landsz&non-void-element-with-trailing-solidusz*unexpected-html-element-in-foreign-contentzunexpected-end-tag-before-htmlzunexpected-inhead-noscript-tagzeof-in-head-noscriptzchar-in-head-noscriptzXXX-undefined-errorzhttp://www.w3.org/1999/xhtmlz"http://www.w3.org/1998/Math/MathMLzhttp://www.w3.org/2000/svgzhttp://www.w3.org/1999/xlinkz$http://www.w3.org/XML/1998/namespacezhttp://www.w3.org/2000/xmlns/)�html�mathml�svg�xlink�xml�xmlnsrZappletZcaptionZmarquee�object�tableZtdZthr�mi�moZmnZmsZmtextzannotation-xmlrZ
foreignObjectZdesc�title�a�bZbig�codeZemZfont�iZnobr�sZsmallZstrikeZstrongZtt�uZaddressZareaZarticleZaside�baseZbasefontZbgsoundZ
blockquoteZbody�br�button�center�colZcolgroup�commandZdd�details�dirZdivZdlZdtZembed�fieldsetZfigureZfooterZform�frameZframeset�h1�h2�h3�h4�h5�h6�head�header�hr�iframeZimage�img�inputZisindexZli�linkZlisting�menu�metaZnavZnoembedZnoframesZnoscriptZol�pZparamZ	plaintextZpre�scriptZsection�select�styleZtbodyZtextareaZtfootZtheadZtrZulZwbrZxmpZ
attributeNameZ
attributeTypeZ
baseFrequencyZbaseProfileZcalcModeZ
clipPathUnitsZcontentScriptTypeZcontentStyleTypeZdiffuseConstantZedgeModeZexternalResourcesRequiredZ	filterResZfilterUnitsZglyphRefZgradientTransformZ
gradientUnitsZkernelMatrixZkernelUnitLengthZ	keyPointsZ
keySplinesZkeyTimesZlengthAdjustZlimitingConeAngleZmarkerHeightZmarkerUnitsZmarkerWidthZmaskContentUnitsZ	maskUnitsZ
numOctavesZ
pathLengthZpatternContentUnitsZpatternTransformZpatternUnitsZ	pointsAtXZ	pointsAtYZ	pointsAtZZ
preserveAlphaZpreserveAspectRatioZprimitiveUnitsZrefXZrefYZrepeatCountZ	repeatDurZrequiredExtensionsZrequiredFeaturesZspecularConstantZspecularExponentZspreadMethodZstartOffsetZstdDeviationZstitchTilesZsurfaceScaleZsystemLanguageZtableValuesZtargetXZtargetYZ
textLengthZviewBoxZ
viewTargetZxChannelSelectorZyChannelSelectorZ
zoomAndPan)>Z
attributenameZ
attributetypeZ
basefrequencyZbaseprofileZcalcmodeZ
clippathunitsZcontentscripttypeZcontentstyletypeZdiffuseconstantZedgemodeZexternalresourcesrequiredZ	filterresZfilterunitsZglyphrefZgradienttransformZ
gradientunitsZkernelmatrixZkernelunitlengthZ	keypointsZ
keysplinesZkeytimesZlengthadjustZlimitingconeangleZmarkerheightZmarkerunitsZmarkerwidthZmaskcontentunitsZ	maskunitsZ
numoctavesZ
pathlengthZpatterncontentunitsZpatterntransformZpatternunitsZ	pointsatxZ	pointsatyZ	pointsatzZ
preservealphaZpreserveaspectratioZprimitiveunitsZrefxZrefyZrepeatcountZ	repeatdurZrequiredextensionsZrequiredfeaturesZspecularconstantZspecularexponentZspreadmethodZstartoffsetZstddeviationZstitchtilesZsurfacescaleZsystemlanguageZtablevaluesZtargetxZtargetyZ
textlengthZviewboxZ
viewtargetZxchannelselectorZychannelselectorZ
zoomandpanZ
definitionurlZ
definitionURLrZactuateZarcroleZhrefZroleZshow�typer	ZlangZspacer
)z
xlink:actuatez
xlink:arcrolez
xlink:hrefz
xlink:rolez
xlink:showzxlink:titlez
xlink:typezxml:basezxml:langz	xml:spacer
zxmlns:xlinkcCs"g|]\}\}}}||f|f�qS�r4)�.0Zqname�prefixZlocal�nsr4r4�B/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/constants.py�
<listcomp>
sr9�	�
�� �
cCs g|]}t|�t|���f�qSr4)�ord�lower)r5�cr4r4r8r9#s�)r r!r"r#r$r%zevent-source�sourceZtrackZ
irrelevantZ	itemscopeZscopedZismapZautoplayZcontrolsZdefer�async�openZmultipleZdisabledZhidden�checked�defaultZnoshadeZ
autosubmit�readonlyZselectedZ	autofocusZrequiredZseamless)�r2r*ZaudioZvideor0rZdatagridrr(r-rZoptionZoptgrouprr+r1�outputr)) i� �i i�i i& i  i! i�i0 i`i9 iRrJi}rJrJi i i i i" i i i�i"!iai: iSrJi~ix�lt;�gt;�amp;�apos;�quot;�Æ�&�ÁuĂ�ÂuАu𝔄�ÀuΑuĀu⩓uĄu𝔸u⁡�Åu𝒜u≔�Ã�Äu∖u⫧u⌆uБu∵uℬuΒu𝔅u𝔹u˘u≎uЧ�©uĆu⋒uⅅuℭuČ�ÇuĈu∰uĊ�¸�·uΧu⊙u⊖u⊕u⊗u∲u”u’u∷u⩴u≡u∯u∮uℂu∐u∳u⨯u𝒞u⋓u≍u⤑uЂuЅuЏu‡u↡u⫤uĎuДu∇uΔu𝔇�´u˙u˝�`u˜u⋄uⅆu𝔻�¨u⃜u≐u⇓u⇐u⇔u⟸u⟺u⟹u⇒u⊨u⇑u⇕u∥u↓u⤓u⇵ȗu⥐u⥞u↽u⥖u⥟u⇁u⥗u⊤u↧u𝒟uĐuŊ�Ð�ÉuĚ�ÊuЭuĖu𝔈�Èu∈uĒu◻u▫uĘu𝔼uΕu⩵u≂u⇌uℰu⩳uΗ�Ëu∃uⅇuФu𝔉u◼u▪u𝔽u∀uℱuЃ�>uΓuϜuĞuĢuĜuГuĠu𝔊u⋙u𝔾u≥u⋛u≧u⪢u≷u⩾u≳u𝒢u≫uЪuˇ�^uĤuℌuℋuℍu─uĦu≏uЕuIJuЁ�Í�ÎuИuİuℑ�ÌuĪuⅈu∬u∫u⋂u⁣u⁢uĮu𝕀uΙuℐuĨuІ�ÏuĴuЙu𝔍u𝕁u𝒥uЈuЄuХuЌuΚuĶuКu𝔎u𝕂u𝒦uЉ�<uĹuΛu⟪uℒu↞uĽuĻuЛu⟨u←u⇤u⇆u⌈u⟦u⥡u⇃u⥙u⌊u↔u⥎u⊣u↤u⥚u⊲u⧏u⊴u⥑u⥠u↿u⥘u↼u⥒u⋚u≦u≶u⪡u⩽u≲u𝔏u⋘u⇚uĿu⟵u⟷u⟶u𝕃u↙u↘u↰uŁu≪u⤅uМu uℳu𝔐u∓u𝕄uΜuЊuŃuŇuŅuНu​u𝔑u⁠� uℕu⫬u≢u≭u∦u∉u≠u≂̸u∄u≯u≱u≧̸u≫̸u≹u⩾̸u≵u≎̸u≏̸u⋪u⧏̸u⋬u≮u≰u≸u≪̸u⩽̸u≴u⪢̸u⪡̸u⊀u⪯̸u⋠u∌u⋫u⧐̸u⋭u⊏̸u⋢u⊐̸u⋣u⊂⃒u⊈u⊁u⪰̸u⋡u≿̸u⊃⃒u⊉u≁u≄u≇u≉u∤u𝒩�ÑuΝuŒ�Ó�ÔuОuŐu𝔒�ÒuŌuΩuΟu𝕆u“u‘u⩔u𝒪�Ø�Õu⨷�Öu‾u⏞u⎴u⏜u∂uПu𝔓uΦuΠ�±uℙu⪻u≺u⪯u≼u≾u″u∏u∝u𝒫uΨ�"u𝔔uℚu𝒬u⤐�®uŔu⟫u↠u⤖uŘuŖuРuℜu∋u⇋u⥯uΡu⟩u→u⇥u⇄u⌉u⟧u⥝u⇂u⥕u⌋u⊢u↦u⥛u⊳u⧐u⊵u⥏u⥜u↾u⥔u⇀u⥓uℝu⥰u⇛uℛu↱u⧴uЩuШuЬuŚu⪼uŠuŞuŜuСu𝔖u↑uΣu∘u𝕊u√u□u⊓u⊏u⊑u⊐u⊒u⊔u𝒮u⋆u⋐u⊆u≻u⪰u≽u≿u∑u⋑u⊃u⊇�Þu™uЋuЦuΤuŤuŢuТu𝔗u∴uΘu  u u∼u≃u≅u≈u𝕋u⃛u𝒯uŦ�Úu↟u⥉uЎuŬ�ÛuУuŰu𝔘�ÙuŪ�_u⏟u⎵u⏝u⋃u⊎uŲu𝕌u⤒u⇅u↕u⥮u⊥u↥u↖u↗uϒuΥuŮu𝒰uŨ�Üu⊫u⫫uВu⊩u⫦u⋁u‖u∣�|u❘u≀u u𝔙u𝕍u𝒱u⊪uŴu⋀u𝔚u𝕎u𝒲u𝔛uΞu𝕏u𝒳uЯuЇuЮ�ÝuŶuЫu𝔜u𝕐u𝒴uŸuЖuŹuŽuЗuŻuΖuℨuℤu𝒵�áuău∾u∾̳u∿�âuа�æu𝔞�àuℵuαuāu⨿u∧u⩕u⩜u⩘u⩚u∠u⦤u∡u⦨u⦩u⦪u⦫u⦬u⦭u⦮u⦯u∟u⊾u⦝u∢u⍼uąu𝕒u⩰u⩯u≊u≋�'�åu𝒶�*�ã�äu⨑u⫭u≌u϶u‵u∽u⋍u⊽u⌅u⎶uбu„u⦰uβuℶu≬u𝔟u◯u⨀u⨁u⨂u⨆u★u▽u△u⨄u⤍u⧫u▴u▾u◂u▸u␣u▒u░u▓u█u=⃥u≡⃥u⌐u𝕓u⋈u╗u╔u╖u╓u═u╦u╩u╤u╧u╝u╚u╜u╙u║u╬u╣u╠u╫u╢u╟u⧉u╕u╒u┐u┌u╥u╨u┬u┴u⊟u⊞u⊠u╛u╘u┘u└u│u╪u╡u╞u┼u┤u├�¦u𝒷u⁏�\u⧅u⟈u•u⪮uću∩u⩄u⩉u⩋u⩇u⩀u∩︀u⁁u⩍uč�çuĉu⩌u⩐uċu⦲�¢u𝔠uчu✓uχu○u⧃uˆu≗u↺u↻uⓈu⊛u⊚u⊝u⨐u⫯u⧂u♣�:�,�@u∁u⩭u𝕔u℗u↵u✗u𝒸u⫏u⫑u⫐u⫒u⋯u⤸u⤵u⋞u⋟u↶u⤽u∪u⩈u⩆u⩊u⊍u⩅u∪︀u↷u⤼u⋎u⋏�¤u∱u⌭u⥥u†uℸu‐u⤏uďuдu⇊u⩷�°uδu⦱u⥿u𝔡u♦uϝu⋲�÷u⋇uђu⌞u⌍�$u𝕕u≑u∸u∔u⊡u⌟u⌌u𝒹uѕu⧶uđu⋱u▿u⦦uџu⟿�éu⩮uěu≖�êu≕uэuėu≒u𝔢u⪚�èu⪖u⪘u⪙u⏧uℓu⪕u⪗uēu∅u u u uŋu uęu𝕖u⋕u⧣u⩱uεuϵ�=u≟u⩸u⧥u≓u⥱uℯuη�ð�ëu€�!uфu♀uffiuffufflu𝔣ufiZfju♭uflu▱uƒu𝕗u⋔u⫙u⨍�½u⅓�¼u⅕u⅙u⅛u⅔u⅖�¾u⅗u⅜u⅘u⅚u⅝u⅞u⁄u⌢u𝒻u⪌uǵuγu⪆uğuĝuгuġu⪩u⪀u⪂u⪄u⋛︀u⪔u𝔤uℷuѓu⪒u⪥u⪤u≩u⪊u⪈u⋧u𝕘uℊu⪎u⪐u⪧u⩺u⋗u⦕u⩼u⥸u≩︀uъu⥈u↭uℏuĥu♥u…u⊹u𝔥u⤥u⤦u⇿u∻u↩u↪u𝕙u―u𝒽uħu⁃�í�îuиuе�¡u𝔦�ìu⨌u∭u⧜u℩uijuīuıu⊷uƵu℅u∞u⧝u⊺u⨗u⨼uёuįu𝕚uι�¿u𝒾u⋹u⋵u⋴u⋳uĩuі�ïuĵuйu𝔧uȷu𝕛u𝒿uјuєuκuϰuķuкu𝔨uĸuхuќu𝕜u𝓀u⤛u⤎u⪋u⥢uĺu⦴uλu⦑u⪅�«u⤟u⤝u↫u⤹u⥳u↢u⪫u⤙u⪭u⪭︀u⤌u❲�{�[u⦋u⦏u⦍uľuļuлu⤶u⥧u⥋u↲u≤u⇇u⋋u⪨u⩿u⪁u⪃u⋚︀u⪓u⋖u⥼u𝔩u⪑u⥪u▄uљu⥫u◺uŀu⎰u≨u⪉u⪇u⋦u⟬u⇽u⟼u↬u⦅u𝕝u⨭u⨴u∗u◊�(u⦓u⥭u‎u⊿u‹u𝓁u⪍u⪏u‚ułu⪦u⩹u⋉u⥶u⩻u⦖u◃u⥊u⥦u≨︀u∺�¯u♂u✠u▮u⨩uмu—u𝔪u℧�µu⫰u−u⨪u⫛u⊧u𝕞u𝓂uμu⊸u⋙̸u≫⃒u⇍u⇎u⋘̸u≪⃒u⇏u⊯u⊮uńu∠⃒u⩰̸u≋̸uʼnu♮u⩃uňuņu⩭̸u⩂uнu–u⇗u⤤u≐̸u⤨u𝔫u↮u⫲u⋼u⋺uњu≦̸u↚u‥u𝕟�¬u⋹̸u⋵̸u⋷u⋶u⋾u⋽u⫽⃥u∂̸u⨔u↛u⤳̸u↝̸u𝓃u⊄u⫅̸u⊅u⫆̸�ñuν�#u№u u⊭u⤄u≍⃒u⊬u≥⃒u>⃒u⧞u⤂u≤⃒u<⃒u⊴⃒u⤃u⊵⃒u∼⃒u⇖u⤣u⤧�ó�ôuоuőu⨸u⦼uœu⦿u𝔬u˛�òu⧁u⦵u⦾u⦻u⧀uōuωuοu⦶u𝕠u⦷u⦹u∨u⩝uℴ�ª�ºu⊶u⩖u⩗u⩛�øu⊘�õu⨶�öu⌽�¶u⫳u⫽uп�%�.u‰u‱u𝔭uφuϕu☎uπuϖuℎ�+u⨣u⨢u⨥u⩲u⨦u⨧u⨕u𝕡�£u⪳u⪷u⪹u⪵u⋨u′u⌮u⌒u⌓u⊰u𝓅uψu u𝔮u𝕢u⁗u𝓆u⨖�?u⤜u⥤u∽̱uŕu⦳u⦒u⦥�»u⥵u⤠u⤳u⤞u⥅u⥴u↣u↝u⤚u∶u❳�}�]u⦌u⦎u⦐uřuŗuрu⤷u⥩u↳u▭u⥽u𝔯u⥬uρuϱu⇉u⋌u˚u‏u⎱u⫮u⟭u⇾u⦆u𝕣u⨮u⨵�)u⦔u⨒u›u𝓇u⋊u▹u⧎u⥨u℞uśu⪴u⪸ušuşuŝu⪶u⪺u⋩u⨓uсu⋅u⩦u⇘�§�;u⤩u✶u𝔰u♯uщuш�­uσuςu⩪u⪞u⪠u⪝u⪟u≆u⨤u⥲u⨳u⧤u⌣u⪪u⪬u⪬︀uь�/u⧄u⌿u𝕤u♠u⊓︀u⊔︀u𝓈u☆u⊂u⫅u⪽u⫃u⫁u⫋u⊊u⪿u⥹u⫇u⫕u⫓u♪�¹�²�³u⫆u⪾u⫘u⫄u⟉u⫗u⥻u⫂u⫌u⊋u⫀u⫈u⫔u⫖u⇙u⤪�ßu⌖uτuťuţuтu⌕u𝔱uθuϑ�þ�×u⨱u⨰u⌶u⫱u𝕥u⫚u‴u▵u≜u◬u⨺u⨹u⧍u⨻u⏢u𝓉uцuћuŧu⥣�úuўuŭ�ûuуuűu⥾u𝔲�ùu▀u⌜u⌏u◸uūuųu𝕦uυu⇈u⌝u⌎uůu◹u𝓊u⋰uũ�üu⦧u⫨u⫩u⦜u⊊︀u⫋︀u⊋︀u⫌︀uвu⊻u≚u⋮u𝔳u𝕧u𝓋u⦚uŵu⩟u≙u℘u𝔴u𝕨u𝓌u𝔵uξu⋻u𝕩u𝓍�ýuяuŷuы�¥u𝔶uїu𝕪u𝓎uю�ÿuźužuзużuζu𝔷uжu⇝u𝕫u𝓏u‍u‌(�ZAEligzAElig;ZAMPzAMP;ZAacutezAacute;zAbreve;ZAcirczAcirc;zAcy;zAfr;ZAgravezAgrave;zAlpha;zAmacr;zAnd;zAogon;zAopf;zApplyFunction;ZAringzAring;zAscr;zAssign;ZAtildezAtilde;ZAumlzAuml;z
Backslash;zBarv;zBarwed;zBcy;zBecause;zBernoullis;zBeta;zBfr;zBopf;zBreve;zBscr;zBumpeq;zCHcy;ZCOPYzCOPY;zCacute;zCap;zCapitalDifferentialD;zCayleys;zCcaron;ZCcedilzCcedil;zCcirc;zCconint;zCdot;zCedilla;z
CenterDot;zCfr;zChi;z
CircleDot;zCircleMinus;zCirclePlus;zCircleTimes;zClockwiseContourIntegral;zCloseCurlyDoubleQuote;zCloseCurlyQuote;zColon;zColone;z
Congruent;zConint;zContourIntegral;zCopf;z
Coproduct;z CounterClockwiseContourIntegral;zCross;zCscr;zCup;zCupCap;zDD;z	DDotrahd;zDJcy;zDScy;zDZcy;zDagger;zDarr;zDashv;zDcaron;zDcy;zDel;zDelta;zDfr;zDiacriticalAcute;zDiacriticalDot;zDiacriticalDoubleAcute;zDiacriticalGrave;zDiacriticalTilde;zDiamond;zDifferentialD;zDopf;zDot;zDotDot;z	DotEqual;zDoubleContourIntegral;z
DoubleDot;zDoubleDownArrow;zDoubleLeftArrow;zDoubleLeftRightArrow;zDoubleLeftTee;zDoubleLongLeftArrow;zDoubleLongLeftRightArrow;zDoubleLongRightArrow;zDoubleRightArrow;zDoubleRightTee;zDoubleUpArrow;zDoubleUpDownArrow;zDoubleVerticalBar;z
DownArrow;z
DownArrowBar;zDownArrowUpArrow;z
DownBreve;zDownLeftRightVector;zDownLeftTeeVector;zDownLeftVector;zDownLeftVectorBar;zDownRightTeeVector;zDownRightVector;zDownRightVectorBar;zDownTee;z
DownTeeArrow;z
Downarrow;zDscr;zDstrok;zENG;ZETHzETH;ZEacutezEacute;zEcaron;ZEcirczEcirc;zEcy;zEdot;zEfr;ZEgravezEgrave;zElement;zEmacr;zEmptySmallSquare;zEmptyVerySmallSquare;zEogon;zEopf;zEpsilon;zEqual;zEqualTilde;zEquilibrium;zEscr;zEsim;zEta;ZEumlzEuml;zExists;z
ExponentialE;zFcy;zFfr;zFilledSmallSquare;zFilledVerySmallSquare;zFopf;zForAll;zFouriertrf;zFscr;zGJcy;ZGTzGT;zGamma;zGammad;zGbreve;zGcedil;zGcirc;zGcy;zGdot;zGfr;zGg;zGopf;z
GreaterEqual;zGreaterEqualLess;zGreaterFullEqual;zGreaterGreater;zGreaterLess;zGreaterSlantEqual;z
GreaterTilde;zGscr;zGt;zHARDcy;zHacek;zHat;zHcirc;zHfr;z
HilbertSpace;zHopf;zHorizontalLine;zHscr;zHstrok;z
HumpDownHump;z
HumpEqual;zIEcy;zIJlig;zIOcy;ZIacutezIacute;ZIcirczIcirc;zIcy;zIdot;zIfr;ZIgravezIgrave;zIm;zImacr;zImaginaryI;zImplies;zInt;z	Integral;z
Intersection;zInvisibleComma;zInvisibleTimes;zIogon;zIopf;zIota;zIscr;zItilde;zIukcy;ZIumlzIuml;zJcirc;zJcy;zJfr;zJopf;zJscr;zJsercy;zJukcy;zKHcy;zKJcy;zKappa;zKcedil;zKcy;zKfr;zKopf;zKscr;zLJcy;ZLTzLT;zLacute;zLambda;zLang;zLaplacetrf;zLarr;zLcaron;zLcedil;zLcy;zLeftAngleBracket;z
LeftArrow;z
LeftArrowBar;zLeftArrowRightArrow;zLeftCeiling;zLeftDoubleBracket;zLeftDownTeeVector;zLeftDownVector;zLeftDownVectorBar;z
LeftFloor;zLeftRightArrow;zLeftRightVector;zLeftTee;z
LeftTeeArrow;zLeftTeeVector;z
LeftTriangle;zLeftTriangleBar;zLeftTriangleEqual;zLeftUpDownVector;zLeftUpTeeVector;z
LeftUpVector;zLeftUpVectorBar;zLeftVector;zLeftVectorBar;z
Leftarrow;zLeftrightarrow;zLessEqualGreater;zLessFullEqual;zLessGreater;z	LessLess;zLessSlantEqual;z
LessTilde;zLfr;zLl;zLleftarrow;zLmidot;zLongLeftArrow;zLongLeftRightArrow;zLongRightArrow;zLongleftarrow;zLongleftrightarrow;zLongrightarrow;zLopf;zLowerLeftArrow;zLowerRightArrow;zLscr;zLsh;zLstrok;zLt;zMap;zMcy;zMediumSpace;z
Mellintrf;zMfr;z
MinusPlus;zMopf;zMscr;zMu;zNJcy;zNacute;zNcaron;zNcedil;zNcy;zNegativeMediumSpace;zNegativeThickSpace;zNegativeThinSpace;zNegativeVeryThinSpace;zNestedGreaterGreater;zNestedLessLess;zNewLine;zNfr;zNoBreak;zNonBreakingSpace;zNopf;zNot;z
NotCongruent;z
NotCupCap;zNotDoubleVerticalBar;zNotElement;z	NotEqual;zNotEqualTilde;z
NotExists;zNotGreater;zNotGreaterEqual;zNotGreaterFullEqual;zNotGreaterGreater;zNotGreaterLess;zNotGreaterSlantEqual;zNotGreaterTilde;zNotHumpDownHump;z
NotHumpEqual;zNotLeftTriangle;zNotLeftTriangleBar;zNotLeftTriangleEqual;zNotLess;z
NotLessEqual;zNotLessGreater;zNotLessLess;zNotLessSlantEqual;z
NotLessTilde;zNotNestedGreaterGreater;zNotNestedLessLess;zNotPrecedes;zNotPrecedesEqual;zNotPrecedesSlantEqual;zNotReverseElement;zNotRightTriangle;zNotRightTriangleBar;zNotRightTriangleEqual;zNotSquareSubset;zNotSquareSubsetEqual;zNotSquareSuperset;zNotSquareSupersetEqual;z
NotSubset;zNotSubsetEqual;zNotSucceeds;zNotSucceedsEqual;zNotSucceedsSlantEqual;zNotSucceedsTilde;zNotSuperset;zNotSupersetEqual;z	NotTilde;zNotTildeEqual;zNotTildeFullEqual;zNotTildeTilde;zNotVerticalBar;zNscr;ZNtildezNtilde;zNu;zOElig;ZOacutezOacute;ZOcirczOcirc;zOcy;zOdblac;zOfr;ZOgravezOgrave;zOmacr;zOmega;zOmicron;zOopf;zOpenCurlyDoubleQuote;zOpenCurlyQuote;zOr;zOscr;ZOslashzOslash;ZOtildezOtilde;zOtimes;ZOumlzOuml;zOverBar;z
OverBrace;zOverBracket;zOverParenthesis;z	PartialD;zPcy;zPfr;zPhi;zPi;z
PlusMinus;zPoincareplane;zPopf;zPr;z	Precedes;zPrecedesEqual;zPrecedesSlantEqual;zPrecedesTilde;zPrime;zProduct;zProportion;z
Proportional;zPscr;zPsi;ZQUOTzQUOT;zQfr;zQopf;zQscr;zRBarr;ZREGzREG;zRacute;zRang;zRarr;zRarrtl;zRcaron;zRcedil;zRcy;zRe;zReverseElement;zReverseEquilibrium;zReverseUpEquilibrium;zRfr;zRho;zRightAngleBracket;zRightArrow;zRightArrowBar;zRightArrowLeftArrow;z
RightCeiling;zRightDoubleBracket;zRightDownTeeVector;zRightDownVector;zRightDownVectorBar;zRightFloor;z	RightTee;zRightTeeArrow;zRightTeeVector;zRightTriangle;zRightTriangleBar;zRightTriangleEqual;zRightUpDownVector;zRightUpTeeVector;zRightUpVector;zRightUpVectorBar;zRightVector;zRightVectorBar;zRightarrow;zRopf;z
RoundImplies;zRrightarrow;zRscr;zRsh;zRuleDelayed;zSHCHcy;zSHcy;zSOFTcy;zSacute;zSc;zScaron;zScedil;zScirc;zScy;zSfr;zShortDownArrow;zShortLeftArrow;zShortRightArrow;z
ShortUpArrow;zSigma;zSmallCircle;zSopf;zSqrt;zSquare;zSquareIntersection;z
SquareSubset;zSquareSubsetEqual;zSquareSuperset;zSquareSupersetEqual;zSquareUnion;zSscr;zStar;zSub;zSubset;zSubsetEqual;z	Succeeds;zSucceedsEqual;zSucceedsSlantEqual;zSucceedsTilde;z	SuchThat;zSum;zSup;z	Superset;zSupersetEqual;zSupset;ZTHORNzTHORN;zTRADE;zTSHcy;zTScy;zTab;zTau;zTcaron;zTcedil;zTcy;zTfr;z
Therefore;zTheta;zThickSpace;z
ThinSpace;zTilde;zTildeEqual;zTildeFullEqual;zTildeTilde;zTopf;z
TripleDot;zTscr;zTstrok;ZUacutezUacute;zUarr;z	Uarrocir;zUbrcy;zUbreve;ZUcirczUcirc;zUcy;zUdblac;zUfr;ZUgravezUgrave;zUmacr;z	UnderBar;zUnderBrace;z
UnderBracket;zUnderParenthesis;zUnion;z
UnionPlus;zUogon;zUopf;zUpArrow;zUpArrowBar;zUpArrowDownArrow;zUpDownArrow;zUpEquilibrium;zUpTee;zUpTeeArrow;zUparrow;zUpdownarrow;zUpperLeftArrow;zUpperRightArrow;zUpsi;zUpsilon;zUring;zUscr;zUtilde;ZUumlzUuml;zVDash;zVbar;zVcy;zVdash;zVdashl;zVee;zVerbar;zVert;zVerticalBar;z
VerticalLine;zVerticalSeparator;zVerticalTilde;zVeryThinSpace;zVfr;zVopf;zVscr;zVvdash;zWcirc;zWedge;zWfr;zWopf;zWscr;zXfr;zXi;zXopf;zXscr;zYAcy;zYIcy;zYUcy;ZYacutezYacute;zYcirc;zYcy;zYfr;zYopf;zYscr;zYuml;zZHcy;zZacute;zZcaron;zZcy;zZdot;zZeroWidthSpace;zZeta;zZfr;zZopf;zZscr;Zaacutezaacute;zabreve;zac;zacE;zacd;Zacirczacirc;Zacutezacute;zacy;Zaeligzaelig;zaf;zafr;Zagravezagrave;zalefsym;zaleph;zalpha;zamacr;zamalg;ZamprMzand;zandand;zandd;z	andslope;zandv;zang;zange;zangle;zangmsd;z	angmsdaa;z	angmsdab;z	angmsdac;z	angmsdad;z	angmsdae;z	angmsdaf;z	angmsdag;z	angmsdah;zangrt;zangrtvb;z	angrtvbd;zangsph;zangst;zangzarr;zaogon;zaopf;zap;zapE;zapacir;zape;zapid;rNzapprox;z	approxeq;Zaringzaring;zascr;zast;zasymp;zasympeq;Zatildezatilde;Zaumlzauml;z	awconint;zawint;zbNot;z	backcong;zbackepsilon;z
backprime;zbacksim;z
backsimeq;zbarvee;zbarwed;z	barwedge;zbbrk;z	bbrktbrk;zbcong;zbcy;zbdquo;zbecaus;zbecause;zbemptyv;zbepsi;zbernou;zbeta;zbeth;zbetween;zbfr;zbigcap;zbigcirc;zbigcup;zbigodot;z	bigoplus;z
bigotimes;z	bigsqcup;zbigstar;zbigtriangledown;zbigtriangleup;z	biguplus;zbigvee;z	bigwedge;zbkarow;z
blacklozenge;zblacksquare;zblacktriangle;zblacktriangledown;zblacktriangleleft;zblacktriangleright;zblank;zblk12;zblk14;zblk34;zblock;zbne;zbnequiv;zbnot;zbopf;zbot;zbottom;zbowtie;zboxDL;zboxDR;zboxDl;zboxDr;zboxH;zboxHD;zboxHU;zboxHd;zboxHu;zboxUL;zboxUR;zboxUl;zboxUr;zboxV;zboxVH;zboxVL;zboxVR;zboxVh;zboxVl;zboxVr;zboxbox;zboxdL;zboxdR;zboxdl;zboxdr;zboxh;zboxhD;zboxhU;zboxhd;zboxhu;z	boxminus;zboxplus;z	boxtimes;zboxuL;zboxuR;zboxul;zboxur;zboxv;zboxvH;zboxvL;zboxvR;zboxvh;zboxvl;zboxvr;zbprime;zbreve;Zbrvbarzbrvbar;zbscr;zbsemi;zbsim;zbsime;zbsol;zbsolb;z	bsolhsub;zbull;zbullet;zbump;zbumpE;zbumpe;zbumpeq;zcacute;zcap;zcapand;z	capbrcup;zcapcap;zcapcup;zcapdot;zcaps;zcaret;zcaron;zccaps;zccaron;Zccedilzccedil;zccirc;zccups;zccupssm;zcdot;Zcedilzcedil;zcemptyv;Zcentzcent;z
centerdot;zcfr;zchcy;zcheck;z
checkmark;zchi;zcir;zcirE;zcirc;zcirceq;zcirclearrowleft;zcirclearrowright;z	circledR;z	circledS;zcircledast;zcircledcirc;zcircleddash;zcire;z	cirfnint;zcirmid;zcirscir;zclubs;z	clubsuit;zcolon;zcolone;zcoloneq;zcomma;zcommat;zcomp;zcompfn;zcomplement;z
complexes;zcong;zcongdot;zconint;zcopf;zcoprod;�copyzcopy;zcopysr;zcrarr;zcross;zcscr;zcsub;zcsube;zcsup;zcsupe;zctdot;zcudarrl;zcudarrr;zcuepr;zcuesc;zcularr;zcularrp;zcup;z	cupbrcap;zcupcap;zcupcup;zcupdot;zcupor;zcups;zcurarr;zcurarrm;zcurlyeqprec;zcurlyeqsucc;z	curlyvee;zcurlywedge;Zcurrenzcurren;zcurvearrowleft;zcurvearrowright;zcuvee;zcuwed;z	cwconint;zcwint;zcylcty;zdArr;zdHar;zdagger;zdaleth;zdarr;zdash;zdashv;zdbkarow;zdblac;zdcaron;zdcy;zdd;zddagger;zddarr;zddotseq;Zdegzdeg;zdelta;zdemptyv;zdfisht;zdfr;zdharl;zdharr;zdiam;zdiamond;zdiamondsuit;zdiams;zdie;zdigamma;zdisin;zdiv;Zdividezdivide;zdivideontimes;zdivonx;zdjcy;zdlcorn;zdlcrop;zdollar;zdopf;zdot;zdoteq;z	doteqdot;z	dotminus;zdotplus;z
dotsquare;zdoublebarwedge;z
downarrow;zdowndownarrows;zdownharpoonleft;zdownharpoonright;z	drbkarow;zdrcorn;zdrcrop;zdscr;zdscy;zdsol;zdstrok;zdtdot;zdtri;zdtrif;zduarr;zduhar;zdwangle;zdzcy;z	dzigrarr;zeDDot;zeDot;Zeacutezeacute;zeaster;zecaron;zecir;Zecirczecirc;zecolon;zecy;zedot;zee;zefDot;zefr;zeg;Zegravezegrave;zegs;zegsdot;zel;z	elinters;zell;zels;zelsdot;zemacr;zempty;z	emptyset;zemptyv;zemsp13;zemsp14;zemsp;zeng;zensp;zeogon;zeopf;zepar;zeparsl;zeplus;zepsi;zepsilon;zepsiv;zeqcirc;zeqcolon;zeqsim;zeqslantgtr;zeqslantless;zequals;zequest;zequiv;zequivDD;z	eqvparsl;zerDot;zerarr;zescr;zesdot;zesim;zeta;Zethzeth;Zeumlzeuml;zeuro;zexcl;zexist;zexpectation;z
exponentiale;zfallingdotseq;zfcy;zfemale;zffilig;zfflig;zffllig;zffr;zfilig;zfjlig;zflat;zfllig;zfltns;zfnof;zfopf;zforall;zfork;zforkv;z	fpartint;Zfrac12zfrac12;zfrac13;Zfrac14zfrac14;zfrac15;zfrac16;zfrac18;zfrac23;zfrac25;Zfrac34zfrac34;zfrac35;zfrac38;zfrac45;zfrac56;zfrac58;zfrac78;zfrasl;zfrown;zfscr;zgE;zgEl;zgacute;zgamma;zgammad;zgap;zgbreve;zgcirc;zgcy;zgdot;zge;zgel;zgeq;zgeqq;z	geqslant;zges;zgescc;zgesdot;zgesdoto;z	gesdotol;zgesl;zgesles;zgfr;zgg;zggg;zgimel;zgjcy;zgl;zglE;zgla;zglj;zgnE;zgnap;z	gnapprox;zgne;zgneq;zgneqq;zgnsim;zgopf;zgrave;zgscr;zgsim;zgsime;zgsiml;�gtrLzgtcc;zgtcir;zgtdot;zgtlPar;zgtquest;z
gtrapprox;zgtrarr;zgtrdot;z
gtreqless;zgtreqqless;zgtrless;zgtrsim;z
gvertneqq;zgvnE;zhArr;zhairsp;zhalf;zhamilt;zhardcy;zharr;zharrcir;zharrw;zhbar;zhcirc;zhearts;z
heartsuit;zhellip;zhercon;zhfr;z	hksearow;z	hkswarow;zhoarr;zhomtht;zhookleftarrow;zhookrightarrow;zhopf;zhorbar;zhscr;zhslash;zhstrok;zhybull;zhyphen;Ziacuteziacute;zic;Zicirczicirc;zicy;ziecy;Ziexclziexcl;ziff;zifr;Zigravezigrave;zii;ziiiint;ziiint;ziinfin;ziiota;zijlig;zimacr;zimage;z	imagline;z	imagpart;zimath;zimof;zimped;zin;zincare;zinfin;z	infintie;zinodot;zint;zintcal;z	integers;z	intercal;z	intlarhk;zintprod;ziocy;ziogon;ziopf;ziota;ziprod;Ziquestziquest;ziscr;zisin;zisinE;zisindot;zisins;zisinsv;zisinv;zit;zitilde;ziukcy;Ziumlziuml;zjcirc;zjcy;zjfr;zjmath;zjopf;zjscr;zjsercy;zjukcy;zkappa;zkappav;zkcedil;zkcy;zkfr;zkgreen;zkhcy;zkjcy;zkopf;zkscr;zlAarr;zlArr;zlAtail;zlBarr;zlE;zlEg;zlHar;zlacute;z	laemptyv;zlagran;zlambda;zlang;zlangd;zlangle;zlap;Zlaquozlaquo;zlarr;zlarrb;zlarrbfs;zlarrfs;zlarrhk;zlarrlp;zlarrpl;zlarrsim;zlarrtl;zlat;zlatail;zlate;zlates;zlbarr;zlbbrk;zlbrace;zlbrack;zlbrke;zlbrksld;zlbrkslu;zlcaron;zlcedil;zlceil;zlcub;zlcy;zldca;zldquo;zldquor;zldrdhar;z	ldrushar;zldsh;zle;z
leftarrow;zleftarrowtail;zleftharpoondown;zleftharpoonup;zleftleftarrows;zleftrightarrow;zleftrightarrows;zleftrightharpoons;zleftrightsquigarrow;zleftthreetimes;zleg;zleq;zleqq;z	leqslant;zles;zlescc;zlesdot;zlesdoto;z	lesdotor;zlesg;zlesges;zlessapprox;zlessdot;z
lesseqgtr;zlesseqqgtr;zlessgtr;zlesssim;zlfisht;zlfloor;zlfr;zlg;zlgE;zlhard;zlharu;zlharul;zlhblk;zljcy;zll;zllarr;z	llcorner;zllhard;zlltri;zlmidot;zlmoust;zlmoustache;zlnE;zlnap;z	lnapprox;zlne;zlneq;zlneqq;zlnsim;zloang;zloarr;zlobrk;zlongleftarrow;zlongleftrightarrow;zlongmapsto;zlongrightarrow;zlooparrowleft;zlooparrowright;zlopar;zlopf;zloplus;zlotimes;zlowast;zlowbar;zloz;zlozenge;zlozf;zlpar;zlparlt;zlrarr;z	lrcorner;zlrhar;zlrhard;zlrm;zlrtri;zlsaquo;zlscr;zlsh;zlsim;zlsime;zlsimg;zlsqb;zlsquo;zlsquor;zlstrok;�ltrKzltcc;zltcir;zltdot;zlthree;zltimes;zltlarr;zltquest;zltrPar;zltri;zltrie;zltrif;z	lurdshar;zluruhar;z
lvertneqq;zlvnE;zmDDot;Zmacrzmacr;zmale;zmalt;zmaltese;zmap;zmapsto;zmapstodown;zmapstoleft;z	mapstoup;zmarker;zmcomma;zmcy;zmdash;zmeasuredangle;zmfr;zmho;�microzmicro;zmid;zmidast;zmidcir;Zmiddotzmiddot;zminus;zminusb;zminusd;zminusdu;zmlcp;zmldr;zmnplus;zmodels;zmopf;zmp;zmscr;zmstpos;zmu;z	multimap;zmumap;znGg;znGt;znGtv;znLeftarrow;znLeftrightarrow;znLl;znLt;znLtv;znRightarrow;znVDash;znVdash;znabla;znacute;znang;znap;znapE;znapid;znapos;znapprox;znatur;znatural;z	naturals;Znbspznbsp;znbump;znbumpe;zncap;zncaron;zncedil;zncong;z	ncongdot;zncup;zncy;zndash;zne;zneArr;znearhk;znearr;znearrow;znedot;znequiv;znesear;znesim;znexist;znexists;znfr;zngE;znge;zngeq;zngeqq;z
ngeqslant;znges;zngsim;zngt;zngtr;znhArr;znharr;znhpar;zni;znis;znisd;zniv;znjcy;znlArr;znlE;znlarr;znldr;znle;znleftarrow;znleftrightarrow;znleq;znleqq;z
nleqslant;znles;znless;znlsim;znlt;znltri;znltrie;znmid;znopf;�notznot;znotin;znotinE;z	notindot;znotinva;znotinvb;znotinvc;znotni;znotniva;znotnivb;znotnivc;znpar;z
nparallel;znparsl;znpart;znpolint;znpr;znprcue;znpre;znprec;znpreceq;znrArr;znrarr;znrarrc;znrarrw;znrightarrow;znrtri;znrtrie;znsc;znsccue;znsce;znscr;z
nshortmid;znshortparallel;znsim;znsime;znsimeq;znsmid;znspar;znsqsube;znsqsupe;znsub;znsubE;znsube;znsubset;z
nsubseteq;znsubseteqq;znsucc;znsucceq;znsup;znsupE;znsupe;znsupset;z
nsupseteq;znsupseteqq;zntgl;Zntildezntilde;zntlg;zntriangleleft;zntrianglelefteq;zntriangleright;zntrianglerighteq;znu;znum;znumero;znumsp;znvDash;znvHarr;znvap;znvdash;znvge;znvgt;znvinfin;znvlArr;znvle;znvlt;znvltrie;znvrArr;znvrtrie;znvsim;znwArr;znwarhk;znwarr;znwarrow;znwnear;zoS;Zoacutezoacute;zoast;zocir;Zocirczocirc;zocy;zodash;zodblac;zodiv;zodot;zodsold;zoelig;zofcir;zofr;zogon;Zogravezograve;zogt;zohbar;zohm;zoint;zolarr;zolcir;zolcross;zoline;zolt;zomacr;zomega;zomicron;zomid;zominus;zoopf;zopar;zoperp;zoplus;zor;zorarr;zord;zorder;zorderof;Zordfzordf;Zordmzordm;zorigof;zoror;zorslope;zorv;zoscr;Zoslashzoslash;zosol;Zotildezotilde;zotimes;z	otimesas;Zoumlzouml;zovbar;zpar;Zparazpara;z	parallel;zparsim;zparsl;zpart;zpcy;zpercnt;zperiod;zpermil;zperp;zpertenk;zpfr;zphi;zphiv;zphmmat;zphone;zpi;z
pitchfork;zpiv;zplanck;zplanckh;zplankv;zplus;z	plusacir;zplusb;zpluscir;zplusdo;zplusdu;zpluse;Zplusmnzplusmn;zplussim;zplustwo;zpm;z	pointint;zpopf;Zpoundzpound;zpr;zprE;zprap;zprcue;zpre;zprec;zprecapprox;zpreccurlyeq;zpreceq;zprecnapprox;z	precneqq;z	precnsim;zprecsim;zprime;zprimes;zprnE;zprnap;zprnsim;zprod;z	profalar;z	profline;z	profsurf;zprop;zpropto;zprsim;zprurel;zpscr;zpsi;zpuncsp;zqfr;zqint;zqopf;zqprime;zqscr;zquaternions;zquatint;zquest;zquesteq;ZquotrOzrAarr;zrArr;zrAtail;zrBarr;zrHar;zrace;zracute;zradic;z	raemptyv;zrang;zrangd;zrange;zrangle;Zraquozraquo;zrarr;zrarrap;zrarrb;zrarrbfs;zrarrc;zrarrfs;zrarrhk;zrarrlp;zrarrpl;zrarrsim;zrarrtl;zrarrw;zratail;zratio;z
rationals;zrbarr;zrbbrk;zrbrace;zrbrack;zrbrke;zrbrksld;zrbrkslu;zrcaron;zrcedil;zrceil;zrcub;zrcy;zrdca;zrdldhar;zrdquo;zrdquor;zrdsh;zreal;zrealine;z	realpart;zreals;zrect;Zregzreg;zrfisht;zrfloor;zrfr;zrhard;zrharu;zrharul;zrho;zrhov;zrightarrow;zrightarrowtail;zrightharpoondown;zrightharpoonup;zrightleftarrows;zrightleftharpoons;zrightrightarrows;zrightsquigarrow;zrightthreetimes;zring;z
risingdotseq;zrlarr;zrlhar;zrlm;zrmoust;zrmoustache;zrnmid;zroang;zroarr;zrobrk;zropar;zropf;zroplus;zrotimes;zrpar;zrpargt;z	rppolint;zrrarr;zrsaquo;zrscr;zrsh;zrsqb;zrsquo;zrsquor;zrthree;zrtimes;zrtri;zrtrie;zrtrif;z	rtriltri;zruluhar;zrx;zsacute;zsbquo;zsc;zscE;zscap;zscaron;zsccue;zsce;zscedil;zscirc;zscnE;zscnap;zscnsim;z	scpolint;zscsim;zscy;zsdot;zsdotb;zsdote;zseArr;zsearhk;zsearr;zsearrow;Zsectzsect;zsemi;zseswar;z	setminus;zsetmn;zsext;zsfr;zsfrown;zsharp;zshchcy;zshcy;z	shortmid;zshortparallel;Zshyzshy;zsigma;zsigmaf;zsigmav;zsim;zsimdot;zsime;zsimeq;zsimg;zsimgE;zsiml;zsimlE;zsimne;zsimplus;zsimrarr;zslarr;zsmallsetminus;zsmashp;z	smeparsl;zsmid;zsmile;zsmt;zsmte;zsmtes;zsoftcy;zsol;zsolb;zsolbar;zsopf;zspades;z
spadesuit;zspar;zsqcap;zsqcaps;zsqcup;zsqcups;zsqsub;zsqsube;z	sqsubset;zsqsubseteq;zsqsup;zsqsupe;z	sqsupset;zsqsupseteq;zsqu;zsquare;zsquarf;zsquf;zsrarr;zsscr;zssetmn;zssmile;zsstarf;zstar;zstarf;zstraightepsilon;zstraightphi;zstrns;zsub;zsubE;zsubdot;zsube;zsubedot;zsubmult;zsubnE;zsubne;zsubplus;zsubrarr;zsubset;z	subseteq;z
subseteqq;z
subsetneq;zsubsetneqq;zsubsim;zsubsub;zsubsup;zsucc;zsuccapprox;zsucccurlyeq;zsucceq;zsuccnapprox;z	succneqq;z	succnsim;zsuccsim;zsum;zsung;Zsup1zsup1;Zsup2zsup2;Zsup3zsup3;zsup;zsupE;zsupdot;zsupdsub;zsupe;zsupedot;zsuphsol;zsuphsub;zsuplarr;zsupmult;zsupnE;zsupne;zsupplus;zsupset;z	supseteq;z
supseteqq;z
supsetneq;zsupsetneqq;zsupsim;zsupsub;zsupsup;zswArr;zswarhk;zswarr;zswarrow;zswnwar;Zszligzszlig;ztarget;ztau;ztbrk;ztcaron;ztcedil;ztcy;ztdot;ztelrec;ztfr;zthere4;z
therefore;ztheta;z	thetasym;zthetav;zthickapprox;z	thicksim;zthinsp;zthkap;zthksim;Zthornzthorn;ztilde;�timesztimes;ztimesb;z	timesbar;ztimesd;ztint;ztoea;ztop;ztopbot;ztopcir;ztopf;ztopfork;ztosa;ztprime;ztrade;z	triangle;z
triangledown;z
triangleleft;ztrianglelefteq;z
triangleq;ztriangleright;ztrianglerighteq;ztridot;ztrie;z	triminus;ztriplus;ztrisb;ztritime;z	trpezium;ztscr;ztscy;ztshcy;ztstrok;ztwixt;ztwoheadleftarrow;ztwoheadrightarrow;zuArr;zuHar;Zuacutezuacute;zuarr;zubrcy;zubreve;Zucirczucirc;zucy;zudarr;zudblac;zudhar;zufisht;zufr;Zugravezugrave;zuharl;zuharr;zuhblk;zulcorn;z	ulcorner;zulcrop;zultri;zumacr;Zumlzuml;zuogon;zuopf;zuparrow;zupdownarrow;zupharpoonleft;zupharpoonright;zuplus;zupsi;zupsih;zupsilon;zupuparrows;zurcorn;z	urcorner;zurcrop;zuring;zurtri;zuscr;zutdot;zutilde;zutri;zutrif;zuuarr;Zuumlzuuml;zuwangle;zvArr;zvBar;zvBarv;zvDash;zvangrt;zvarepsilon;z	varkappa;zvarnothing;zvarphi;zvarpi;z
varpropto;zvarr;zvarrho;z	varsigma;z
varsubsetneq;zvarsubsetneqq;z
varsupsetneq;zvarsupsetneqq;z	vartheta;zvartriangleleft;zvartriangleright;zvcy;zvdash;zvee;zveebar;zveeeq;zvellip;zverbar;zvert;zvfr;zvltri;zvnsub;zvnsup;zvopf;zvprop;zvrtri;zvscr;zvsubnE;zvsubne;zvsupnE;zvsupne;zvzigzag;zwcirc;zwedbar;zwedge;zwedgeq;zweierp;zwfr;zwopf;zwp;zwr;zwreath;zwscr;zxcap;zxcirc;zxcup;zxdtri;zxfr;zxhArr;zxharr;zxi;zxlArr;zxlarr;zxmap;zxnis;zxodot;zxopf;zxoplus;zxotime;zxrArr;zxrarr;zxscr;zxsqcup;zxuplus;zxutri;zxvee;zxwedge;Zyacutezyacute;zyacy;zycirc;zycy;Zyenzyen;zyfr;zyicy;zyopf;zyscr;zyucy;Zyumlzyuml;zzacute;zzcaron;zzcy;zzdot;zzeetrf;zzeta;zzfr;zzhcy;zzigrarr;zzopf;zzscr;zzwj;zzwnj;u������)"r�
���������������������������������������)ZDoctypeZ
CharactersZSpaceCharacters�StartTag�EndTag�EmptyTag�CommentZ
ParseErrorrrrcCsg|]\}}||f�qSr4r4)r5�k�vr4r4r8r9ysZmathc@seZdZdZdS)�DataLossWarningzBRaised when the current tree is unable to represent the input dataN)�__name__�
__module__�__qualname__�__doc__r4r4r4r8r}src@seZdZdS)�_ReparseExceptionN)rr	r
r4r4r4r8r�sr)0Z
__future__rrr�stringZEOF�EZ
namespaces�	frozensetZscopingElementsZformattingElementsZspecialElementsZhtmlIntegrationPointElementsZ"mathmlTextIntegrationPointElementsZadjustSVGAttributesZadjustMathMLAttributesZadjustForeignAttributes�dict�itemsZunadjustForeignAttributesZspaceCharactersZtableInsertModeElementsZascii_lowercaseZasciiLowercaseZascii_uppercaseZasciiUppercaseZ
ascii_lettersZasciiLettersZdigitsZ	hexdigitsZ	hexDigitsZasciiUpper2LowerZheadingElementsZvoidElementsZ
cdataElementsZrcdataElementsZbooleanAttributesZentitiesWindows1252ZxmlEntitiesZentitiesZreplacementCharactersZ
tokenTypesZ
tagTokenTypes�prefixes�UserWarningr�	Exceptionrr4r4r4r8�<module>sj���$�	
















�













�













































































�S



�




�	�A����




�	��





�#������������������
L�&��
site-packages/pip/_vendor/html5lib/__pycache__/html5parser.cpython-38.pyc000064400000271643151446177000022360 0ustar00U

��.e���@sddlmZmZmZddlmZmZddlZddlm	Z	ddl
mZddl
mZddl
m
Z
dd	lmZdd
l
mZddlmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"d!dd�Z#d"dd�Z$dd�Z%Gdd�de&�Z'ej(dd��Z)dd�Z*d#dd�Z+Gdd �d e,�Z-dS)$�)�absolute_import�division�unicode_literals)�with_metaclass�viewkeysN)�OrderedDict�)�_inputstream)�
_tokenizer)�treebuilders)�Marker)�_utils)�spaceCharacters�asciiUpper2Lower�specialElements�headingElements�
cdataElements�rcdataElements�
tokenTypes�
tagTokenTypes�
namespaces�htmlIntegrationPointElements�"mathmlTextIntegrationPointElements�adjustForeignAttributes�adjustMathMLAttributes�adjustSVGAttributes�E�_ReparseException�etreeTcKs$t�|�}t||d�}|j|f|�S)a�Parse an HTML document as a string or file-like object into a tree

    :arg doc: the document to parse as a string or file-like object

    :arg treebuilder: the treebuilder to use when parsing

    :arg namespaceHTMLElements: whether or not to namespace HTML elements

    :returns: parsed tree

    Example:

    >>> from html5lib.html5parser import parse
    >>> parse('<html><body><p>This is a doc</p></body></html>')
    <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>

    ��namespaceHTMLElements)r�getTreeBuilder�
HTMLParser�parse)�doc�treebuilderr �kwargs�tb�p�r)�D/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/html5parser.pyr#s
r#�divcKs,t�|�}t||d�}|j|fd|i|��S)a#Parse an HTML fragment as a string or file-like object into a tree

    :arg doc: the fragment to parse as a string or file-like object

    :arg container: the container context to parse the fragment in

    :arg treebuilder: the treebuilder to use when parsing

    :arg namespaceHTMLElements: whether or not to namespace HTML elements

    :returns: parsed tree

    Example:

    >>> from html5lib.html5libparser import parseFragment
    >>> parseFragment('<b>this is a fragment</b>')
    <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>

    r�	container)rr!r"�
parseFragment)r$r,r%r r&r'r(r)r)r*r-2s
r-csG�fdd�dt�}|S)NcseZdZ�fdd�ZdS)z-method_decorator_metaclass.<locals>.Decoratedcs>|��D]$\}}t|tj�r$�|�}|||<qt�||||�S�N)�items�
isinstance�types�FunctionType�type�__new__)�metaZ	classname�basesZ	classDictZ
attributeNameZ	attribute��functionr)r*r4Ms

z5method_decorator_metaclass.<locals>.Decorated.__new__N)�__name__�
__module__�__qualname__r4r)r7r)r*�	DecoratedLsr<)r3)r8r<r)r7r*�method_decorator_metaclassKsr=c@s�eZdZdZd+dd�Zd,dd	�Zd
d�Zedd
��Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zd-dd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�ZdS).r"z]HTML parser

    Generates a tree structure from a stream of (possibly malformed) HTML.

    NFTcsL|�_|dkrt�d�}||��_g�_t�fdd�t|���D���_dS)a�
        :arg tree: a treebuilder class controlling the type of tree that will be
            returned. Built in treebuilders can be accessed through
            html5lib.treebuilders.getTreeBuilder(treeType)

        :arg strict: raise an exception when a parse error is encountered

        :arg namespaceHTMLElements: whether or not to namespace HTML elements

        :arg debug: whether or not to enable debug mode which logs things

        Example:

        >>> from html5lib.html5parser import HTMLParser
        >>> parser = HTMLParser()                     # generates parser with etree builder
        >>> parser = HTMLParser('lxml', strict=True)  # generates parser with lxml builder which is strict

        Nrcs g|]\}}||��j�f�qSr))�tree)�.0�name�cls��selfr)r*�
<listcomp>zsz'HTMLParser.__init__.<locals>.<listcomp>)	�strictrr!r>�errors�dict�	getPhasesr/�phases)rCr>rEr �debugr)rBr*�__init__^s


�zHTMLParser.__init__r+cKsh||_||_||_tj|fd|i|��|_|��z|��Wn$tk
rb|��|��YnXdS)N�parser)	�
innerHTMLModer,�	scriptingr
Z
HTMLTokenizer�	tokenizer�reset�mainLoopr)rC�stream�	innerHTMLr,rNr&r)r)r*�_parse}szHTMLParser._parsecCs�|j��d|_g|_g|_d|_|jr�|j��|_	|j	t
krL|jj|j_
n0|j	tkrd|jj|j_
n|j	dkr||jj|j_
n|jd|_|j��|��nd|_	|jd|_d|_d|_d|_dS)NFz	no quirks�	plaintext�
beforeHtml�initialT)r>rP�
firstStartTagrF�log�
compatModerMr,�lowerrSrrO�rcdataState�stater�rawtextState�plaintextStaterI�phase�insertHtmlElement�resetInsertionModeZ	lastPhaseZbeforeRCDataPhase�
framesetOKrBr)r)r*rP�s*





zHTMLParser.resetcCst|d�sdS|jjjdjS)z�Name of the character encoding that was used to decode the input stream, or
        :obj:`None` if that is not determined yet

        rONr)�hasattrrOrR�charEncodingr@rBr)r)r*�documentEncoding�s
zHTMLParser.documentEncodingcCsJ|jdkr6|jtdkr6d|jko4|jd�t�dkS|j|jftkSdS)N�annotation-xml�mathml�encoding)z	text/htmlzapplication/xhtml+xml)r@�	namespacer�
attributes�	translaterr�rC�elementr)r)r*�isHTMLIntegrationPoint�s
�

���z!HTMLParser.isHTMLIntegrationPointcCs|j|jftkSr.)rjr@rrmr)r)r*�isMathMLTextIntegrationPoint�sz'HTMLParser.isMathMLTextIntegrationPointcCshtd}td}td}td}td}td}td}|��D�]�}d}	|}
|
dk	�r�|
}	|jjrp|jjdnd}|r~|jnd}|r�|jnd}
|
d	}||kr�|�|
d
|
�di��d}
qNt|jj�dk�sd||jj	k�sd|�
|��r||k�r
|d
tddg�k�sd|||fk�sd|tdk�rH|
dk�rH||k�rH|d
dk�sd|�
|��rl||||fk�rl|j}n
|jd}||k�r�|�|
�}
qN||k�r�|�|
�}
qN||k�r�|�|
�}
qN||k�r�|�|
�}
qN||k�r�|�|
�}
qN||krN|�|
�}
qN||kr@|	dr@|	ds@|�dd
|	d
i�q@d}g}|�rd|�|j�|j��}|�r.|j|k�s.t��q.dS)N�
CharactersZSpaceCharacters�StartTag�EndTag�CommentZDoctype�
ParseError���r3�data�datavarsrr@ZmglyphZ
malignmarkrhrg�svg�inForeignContent�selfClosing�selfClosingAcknowledgedz&non-void-element-with-trailing-solidusT)r�normalizedTokensr>�openElementsrjr@�
parseError�get�len�defaultNamespacerp�	frozensetrror`rI�processCharacters�processSpaceCharacters�processStartTag�
processEndTag�processComment�processDoctype�append�
processEOF�AssertionError)rCZCharactersTokenZSpaceCharactersTokenZ
StartTagTokenZEndTagTokenZCommentTokenZDoctypeTokenZParseErrorToken�tokenZ
prev_token�	new_token�currentNodeZcurrentNodeNamespaceZcurrentNodeNamer3r`Z	reprocessrIr)r)r*rQ�s�

����
�
���	
�
��





�
�
zHTMLParser.mainLoopccs|jD]}|�|�VqdSr.)rO�normalizeToken�rCr�r)r)r*r}s
zHTMLParser.normalizedTokenscOs |j|ddf|�|�|j��S)a�Parse a HTML document into a well-formed tree

        :arg stream: a file-like object or string containing the HTML to be parsed

            The optional encoding parameter must be a string that indicates
            the encoding.  If specified, that encoding will be used,
            regardless of any BOM or later declaration (such as in a meta
            element).

        :arg scripting: treat noscript elements as if JavaScript was turned on

        :returns: parsed tree

        Example:

        >>> from html5lib.html5parser import HTMLParser
        >>> parser = HTMLParser()
        >>> parser.parse('<html><body><p>This is a doc</p></body></html>')
        <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>

        FN)rTr>ZgetDocument�rCrR�argsr&r)r)r*r#szHTMLParser.parsecOs|j|df|�|�|j��S)aZParse a HTML fragment into a well-formed tree fragment

        :arg container: name of the element we're setting the innerHTML
            property if set to None, default to 'div'

        :arg stream: a file-like object or string containing the HTML to be parsed

            The optional encoding parameter must be a string that indicates
            the encoding.  If specified, that encoding will be used,
            regardless of any BOM or later declaration (such as in a meta
            element)

        :arg scripting: treat noscript elements as if JavaScript was turned on

        :returns: parsed tree

        Example:

        >>> from html5lib.html5libparser import HTMLParser
        >>> parser = HTMLParser()
        >>> parser.parseFragment('<b>this is a fragment</b>')
        <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>

        T)rTr>ZgetFragmentr�r)r)r*r-$szHTMLParser.parseFragment�XXX-undefined-errorcCs@|dkri}|j�|jj��||f�|jr<tt||��dSr.)rFr�rOrRZpositionrErur)rCZ	errorcoderxr)r)r*r@s
zHTMLParser.parseErrorcCsT|dtdkrP|d}t|�|d<t|�t|d�krP|d�|ddd��|S)Nr3rrrwrv)rrr��update)rCr��rawr)r)r*r�HszHTMLParser.normalizeTokencCst|t�dSr.)�adjust_attributesrr�r)r)r*rSsz!HTMLParser.adjustMathMLAttributescCst|t�dSr.)r�rr�r)r)r*rVszHTMLParser.adjustSVGAttributescCst|t�dSr.)r��adjustForeignAttributesMapr�r)r)r*rYsz"HTMLParser.adjustForeignAttributescCs|j��dSr.)rLr`r�r)r)r*�reparseTokenNormal\szHTMLParser.reparseTokenNormalcCs�d}ddddddddddd	d	d
dd�}|jjddd
�D]�}|j}d}||jjdkrj|js`t�d}|j}|dkr||js|t�|s�|j|jjkr�q8||kr�|j||}q�q8|r8|jd	}q�q8||_dS)NF�inSelect�inCell�inRow�inTableBody�	inCaption�
inColumnGroup�inTable�inBody�
inFrameset�
beforeHead)�select�td�th�tr�tbody�thead�tfoot�caption�colgroup�table�head�body�frameset�htmlrvrT)r�r�r�r�)	r>r~r@rSr�rjr�rIr`)rCZlastZnewModes�nodeZnodeNameZ	new_phaser)r)r*rb`sD�


zHTMLParser.resetInsertionModecCsR|dkst�|j�|�|dkr.|jj|j_n|jj|j_|j|_|j	d|_dS)N)�RAWTEXT�RCDATAr��text)
r�r>�
insertElementrOr^r]r\r`�
originalPhaserI)rCr�ZcontentTyper)r)r*�parseRCDataRawtext�szHTMLParser.parseRCDataRawtext)NFTF)Fr+F)r�N)r9r:r;�__doc__rKrTrP�propertyrfrorprQr}r#r-rr�rrrr�rbr�r)r)r)r*r"Ws(

"
	
C
,r"cs"dd�}dd�}Gdd�dt|||����Gdd�d��}Gd	d
�d
��}G�fdd�d��}G�fd
d�d��}G�fdd�d��}G�fdd�d��}G�fdd�d��}	G�fdd�d��}
G�fdd�d��}G�fdd�d��}G�fdd�d��}
G�fdd�d��}G�fdd �d ��}G�fd!d"�d"��}G�fd#d$�d$��}G�fd%d&�d&��}G�fd'd(�d(��}G�fd)d*�d*��}G�fd+d,�d,��}G�fd-d.�d.��}G�fd/d0�d0��}G�fd1d2�d2��}G�fd3d4�d4��}|||||||	|
|||
||||||||||||d5�S)6Ncs(tdd�t��D�����fdd�}|S)z4Logger that records which phase processes each tokencss|]\}}||fVqdSr.r))r?�key�valuer)r)r*�	<genexpr>�sz)getPhases.<locals>.log.<locals>.<genexpr>cs��j�d�r�t|�dkr�|d}zd�|di}Wn�YnX|dtkr\|d|d<|jj�|jjjj|jj	j
j|j
j�j|f��|f|�|�S�|f|�|�SdS)NZprocessrr3r@)r9�
startswithr�rrLrYr�rOr]r`�	__class__)rCr�r&r��info�r8Z
type_namesr)r*�wrapped�s 
�z'getPhases.<locals>.log.<locals>.wrapped)rGrr/)r8r�r)r�r*rY�s
�zgetPhases.<locals>.logcSs|rt|�StSdSr.)r=r3)Z
use_metaclassZmetaclass_funcr)r)r*�getMetaclass�szgetPhases.<locals>.getMetaclassc@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)zgetPhases.<locals>.PhasezNBase class for helper object that implements each phase of processing
        cSs||_||_dSr.)rLr>�rCrLr>r)r)r*rK�sz!getPhases.<locals>.Phase.__init__cSst�dSr.)�NotImplementedErrorrBr)r)r*r��sz#getPhases.<locals>.Phase.processEOFcSs|j�||jjd�dS)Nrv�r>�
insertCommentr~r�r)r)r*r��sz'getPhases.<locals>.Phase.processCommentcSs|j�d�dS)Nzunexpected-doctype�rLrr�r)r)r*r��sz'getPhases.<locals>.Phase.processDoctypecSs|j�|d�dS�Nrw�r>�
insertTextr�r)r)r*r��sz*getPhases.<locals>.Phase.processCharacterscSs|j�|d�dSr�r�r�r)r)r*r��sz/getPhases.<locals>.Phase.processSpaceCharacterscSs|j|d|�S�Nr@)�startTagHandlerr�r)r)r*r��sz(getPhases.<locals>.Phase.processStartTagcSsf|jjs |ddkr |j�d�|d��D],\}}||jjdjkr,||jjdj|<q,d|j_dS)Nr@r�z
non-html-rootrwrF)rLrXrr/r>r~rk�rCr��attrr�r)r)r*�startTagHtml�sz%getPhases.<locals>.Phase.startTagHtmlcSs|j|d|�Sr�)�
endTagHandlerr�r)r)r*r��sz&getPhases.<locals>.Phase.processEndTagN)
r9r:r;r�rKr�r�r�r�r�r�r�r�r)r)r)r*�Phase�s
r�c@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)zgetPhases.<locals>.InitialPhasecSsdSr.r)r�r)r)r*r��sz6getPhases.<locals>.InitialPhase.processSpaceCharacterscSs|j�||jj�dSr.�r>r�Zdocumentr�r)r)r*r��sz.getPhases.<locals>.InitialPhase.processCommentcSs�|d}|d}|d}|d}|dks@|dk	s@|dk	rL|dkrL|j�d�|dkrXd}|j�|�|dkrv|�t�}|r�|ddks�|�d	�s�|d
ks�|�d�r�|dks�|r�|��dkr�d
|j_n$|�d�s�|�d�r�|dk	r�d|j_|jj	d|j_
dS)Nr@�publicId�systemId�correctr�zabout:legacy-compatzunknown-doctype�)7z*+//silmaril//dtd html pro v0r11 19970101//z4-//advasoft ltd//dtd html 3.0 aswedit + extensions//z*-//as//dtd html 3.0 aswedit + extensions//z-//ietf//dtd html 2.0 level 1//z-//ietf//dtd html 2.0 level 2//z&-//ietf//dtd html 2.0 strict level 1//z&-//ietf//dtd html 2.0 strict level 2//z-//ietf//dtd html 2.0 strict//z-//ietf//dtd html 2.0//z-//ietf//dtd html 2.1e//z-//ietf//dtd html 3.0//z-//ietf//dtd html 3.2 final//z-//ietf//dtd html 3.2//z-//ietf//dtd html 3//z-//ietf//dtd html level 0//z-//ietf//dtd html level 1//z-//ietf//dtd html level 2//z-//ietf//dtd html level 3//z"-//ietf//dtd html strict level 0//z"-//ietf//dtd html strict level 1//z"-//ietf//dtd html strict level 2//z"-//ietf//dtd html strict level 3//z-//ietf//dtd html strict//z-//ietf//dtd html//z(-//metrius//dtd metrius presentational//z5-//microsoft//dtd internet explorer 2.0 html strict//z.-//microsoft//dtd internet explorer 2.0 html//z0-//microsoft//dtd internet explorer 2.0 tables//z5-//microsoft//dtd internet explorer 3.0 html strict//z.-//microsoft//dtd internet explorer 3.0 html//z0-//microsoft//dtd internet explorer 3.0 tables//z#-//netscape comm. corp.//dtd html//z*-//netscape comm. corp.//dtd strict html//z*-//o'reilly and associates//dtd html 2.0//z3-//o'reilly and associates//dtd html extended 1.0//z;-//o'reilly and associates//dtd html extended relaxed 1.0//zN-//softquad software//dtd hotmetal pro 6.0::19990601::extensions to html 4.0//zE-//softquad//dtd hotmetal pro 4.0::19971010::extensions to html 4.0//z$-//spyglass//dtd html 2.0 extended//z+-//sq//dtd html 2.0 hotmetal + extensions//z--//sun microsystems corp.//dtd hotjava html//z4-//sun microsystems corp.//dtd hotjava strict html//z-//w3c//dtd html 3 1995-03-24//z-//w3c//dtd html 3.2 draft//z-//w3c//dtd html 3.2 final//z-//w3c//dtd html 3.2//z-//w3c//dtd html 3.2s draft//z-//w3c//dtd html 4.0 frameset//z#-//w3c//dtd html 4.0 transitional//z(-//w3c//dtd html experimental 19960712//z&-//w3c//dtd html experimental 970421//z-//w3c//dtd w3 html//z-//w3o//dtd w3 html 3.0//z#-//webtechs//dtd mozilla html 2.0//z-//webtechs//dtd mozilla html//)z$-//w3o//dtd w3 html strict 3.0//en//z"-/w3c/dtd html 4.0 transitional/enr�)z -//w3c//dtd html 4.01 frameset//z$-//w3c//dtd html 4.01 transitional//z:http://www.ibm.com/data/dtd/v11/ibmxhtml1-transitional.dtd�quirks)z -//w3c//dtd xhtml 1.0 frameset//z$-//w3c//dtd xhtml 1.0 transitional//zlimited quirksrV)rLrr>Z
insertDoctyperlrr�r[rZrIr`)rCr�r@r�r�r�r)r)r*r��sX��
��9�<��?�@�@
�A
����z.getPhases.<locals>.InitialPhase.processDoctypecSsd|j_|jjd|j_dS)Nr�rV)rLrZrIr`rBr)r)r*�anythingElseMsz,getPhases.<locals>.InitialPhase.anythingElsecSs|j�d�|��|S)Nzexpected-doctype-but-got-chars�rLrr�r�r)r)r*r�Qsz1getPhases.<locals>.InitialPhase.processCharacterscSs"|j�dd|di�|��|S)Nz"expected-doctype-but-got-start-tagr@r�r�r)r)r*r�Vs

�z/getPhases.<locals>.InitialPhase.processStartTagcSs"|j�dd|di�|��|S)Nz expected-doctype-but-got-end-tagr@r�r�r)r)r*r�\s

�z-getPhases.<locals>.InitialPhase.processEndTagcSs|j�d�|��dS)Nzexpected-doctype-but-got-eofTr�rBr)r)r*r�bsz*getPhases.<locals>.InitialPhase.processEOFN)r9r:r;r�r�r�r�r�r�r�r�r)r)r)r*�InitialPhase�s_r�c@sDeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dS)z"getPhases.<locals>.BeforeHtmlPhasecSs&|j�tdd��|jjd|j_dS)Nr�rrr�)r>Z
insertRoot�impliedTagTokenrLrIr`rBr)r)r*raisz4getPhases.<locals>.BeforeHtmlPhase.insertHtmlElementcSs|��dS�NT�rarBr)r)r*r�nsz-getPhases.<locals>.BeforeHtmlPhase.processEOFcSs|j�||jj�dSr.r�r�r)r)r*r�rsz1getPhases.<locals>.BeforeHtmlPhase.processCommentcSsdSr.r)r�r)r)r*r�usz9getPhases.<locals>.BeforeHtmlPhase.processSpaceCharacterscSs|��|Sr.r�r�r)r)r*r�xsz4getPhases.<locals>.BeforeHtmlPhase.processCharacterscSs |ddkrd|j_|��|S)Nr@r�T)rLrXrar�r)r)r*r�|sz2getPhases.<locals>.BeforeHtmlPhase.processStartTagcSs4|ddkr$|j�dd|di�n|��|SdS)Nr@�r�r�r��brzunexpected-end-tag-before-html)rLrrar�r)r)r*r��s
�z0getPhases.<locals>.BeforeHtmlPhase.processEndTagN)
r9r:r;rar�r�r�r�r�r�r)r)r)r*�BeforeHtmlPhasegsr�csXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z"getPhases.<locals>.BeforeHeadPhasecsV��|||�t�d|jfd|jfg�|_|j|j_t�d|jfg�|_	|j
|j	_dS)Nr�r�r�)rKr
�MethodDispatcherr��startTagHeadr��
startTagOther�default�endTagImplyHeadr��endTagOtherr��r�r)r*rK�s�
�z+getPhases.<locals>.BeforeHeadPhase.__init__cSs|�tdd��dS)Nr�rrT�r�r�rBr)r)r*r��sz-getPhases.<locals>.BeforeHeadPhase.processEOFcSsdSr.r)r�r)r)r*r��sz9getPhases.<locals>.BeforeHeadPhase.processSpaceCharacterscSs|�tdd��|S�Nr�rrr�r�r)r)r*r��sz4getPhases.<locals>.BeforeHeadPhase.processCharacterscSs|jjd�|�S�Nr��rLrIr�r�r)r)r*r��sz/getPhases.<locals>.BeforeHeadPhase.startTagHtmlcSs0|j�|�|jjd|j_|jjd|j_dS)Nrv�inHead)r>r�r~�headPointerrLrIr`r�r)r)r*r��sz/getPhases.<locals>.BeforeHeadPhase.startTagHeadcSs|�tdd��|Sr�r�r�r)r)r*r��sz0getPhases.<locals>.BeforeHeadPhase.startTagOthercSs|�tdd��|Sr�r�r�r)r)r*r��sz2getPhases.<locals>.BeforeHeadPhase.endTagImplyHeadcSs|j�dd|di�dS)Nzend-tag-after-implied-rootr@r�r�r)r)r*r��s
�z.getPhases.<locals>.BeforeHeadPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r)r�r)r*�BeforeHeadPhase�sr�cs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Zd!S)"zgetPhases.<locals>.InHeadPhasecs���|||�t�d|jfd|jfd|jfd|jfd|jfd|jfd|j	fd|j
fg�|_|j|j_
t�d|jfd	|jfg�|_|j|j_
dS)
Nr��title)�noframes�style�noscript�script)�base�basefont�bgsound�command�linkr5r�)r�r�r�)rKr
r�r��
startTagTitle�startTagNoFramesStyle�startTagNoscript�startTagScript�startTagBaseLinkCommand�startTagMetar�r�r�r��
endTagHead�endTagHtmlBodyBrr�r�r�r�r)r*rK�s&��
�z'getPhases.<locals>.InHeadPhase.__init__cSs|��dSr��r�rBr)r)r*r��sz)getPhases.<locals>.InHeadPhase.processEOFcSs|��|Sr.rr�r)r)r*r��sz0getPhases.<locals>.InHeadPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��sz+getPhases.<locals>.InHeadPhase.startTagHtmlcSs|j�d�dS)Nz!two-heads-are-not-better-than-oner�r�r)r)r*r��sz+getPhases.<locals>.InHeadPhase.startTagHeadcSs$|j�|�|jj��d|d<dS�NTr|�r>r�r~�popr�r)r)r*r��sz6getPhases.<locals>.InHeadPhase.startTagBaseLinkCommandcSs�|j�|�|jj��d|d<|d}|jjjjddkr�d|krZ|jjj�|d�nVd|kr�d|kr�|d�	�d	kr�t
�|d�d
��}t
�
|�}|��}|jjj�|�dS)NTr|rwrZ	tentative�charsetZcontentz
http-equivzcontent-typezutf-8)r>r�r~rrLrOrRreZchangeEncodingr[r	Z
EncodingBytes�encodeZContentAttrParserr#)rCr�rkrwrL�codecr)r)r*r��s ��
z+getPhases.<locals>.InHeadPhase.startTagMetacSs|j�|d�dS)Nr��rLr�r�r)r)r*r��sz,getPhases.<locals>.InHeadPhase.startTagTitlecSs|j�|d�dS)Nr�r	r�r)r)r*r��sz4getPhases.<locals>.InHeadPhase.startTagNoFramesStylecSs8|jjr|j�|d�n|j�|�|jjd|j_dS)Nr��inHeadNoscript)rLrNr�r>r�rIr`r�r)r)r*r��sz/getPhases.<locals>.InHeadPhase.startTagNoscriptcSs<|j�|�|jjj|jj_|jj|j_|jjd|j_dS)Nr�)	r>r�rLrOZscriptDataStater]r`r�rIr�r)r)r*r�sz-getPhases.<locals>.InHeadPhase.startTagScriptcSs|��|Sr.rr�r)r)r*r�sz,getPhases.<locals>.InHeadPhase.startTagOthercSs:|jjj��}|jdks&td|j��|jjd|j_dS)Nr�zExpected head got %s�	afterHead�rLr>r~rr@r�rIr`�rCr�r�r)r)r*rsz)getPhases.<locals>.InHeadPhase.endTagHeadcSs|��|Sr.rr�r)r)r*rsz/getPhases.<locals>.InHeadPhase.endTagHtmlBodyBrcSs|j�dd|di�dS�N�unexpected-end-tagr@r�r�r)r)r*r�sz*getPhases.<locals>.InHeadPhase.endTagOthercSs|�td��dS)Nr�)rr�rBr)r)r*r�sz+getPhases.<locals>.InHeadPhase.anythingElseN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�r�rrr�r�r)r�r)r*�InHeadPhase�s rcsxeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS)z&getPhases.<locals>.InHeadNoscriptPhasecsf��|||�t�d|jfd|jfd|jfg�|_|j|j_t�d|j	fd|j
fg�|_|j|j_dS)Nr�)r�r�r�r5r�r�)r�r�r�r�)
rKr
r�r�r��startTagHeadNoscriptr�r�r��endTagNoscript�endTagBrr�r�r�r�r)r*rK s�
�z/getPhases.<locals>.InHeadNoscriptPhase.__init__cSs|j�d�|��dS)Nzeof-in-head-noscriptTr�rBr)r)r*r�0sz1getPhases.<locals>.InHeadNoscriptPhase.processEOFcSs|jjd�|�S�Nr�)rLrIr�r�r)r)r*r�5sz5getPhases.<locals>.InHeadNoscriptPhase.processCommentcSs|j�d�|��|S)Nzchar-in-head-noscriptr�r�r)r)r*r�8sz8getPhases.<locals>.InHeadNoscriptPhase.processCharacterscSs|jjd�|�Sr�rLrIr�r�r)r)r*r�=sz=getPhases.<locals>.InHeadNoscriptPhase.processSpaceCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�@sz3getPhases.<locals>.InHeadNoscriptPhase.startTagHtmlcSs|jjd�|�Srr�r�r)r)r*r�Csz>getPhases.<locals>.InHeadNoscriptPhase.startTagBaseLinkCommandcSs|j�dd|di�dS�N�unexpected-start-tagr@r�r�r)r)r*rFsz;getPhases.<locals>.InHeadNoscriptPhase.startTagHeadNoscriptcSs"|j�dd|di�|��|S�Nzunexpected-inhead-noscript-tagr@r�r�r)r)r*r�Isz4getPhases.<locals>.InHeadNoscriptPhase.startTagOthercSs:|jjj��}|jdks&td|j��|jjd|j_dS)Nr�zExpected noscript got %sr�rr
r)r)r*rNsz5getPhases.<locals>.InHeadNoscriptPhase.endTagNoscriptcSs"|j�dd|di�|��|Srr�r�r)r)r*rSsz/getPhases.<locals>.InHeadNoscriptPhase.endTagBrcSs|j�dd|di�dSrr�r�r)r)r*r�Xsz2getPhases.<locals>.InHeadNoscriptPhase.endTagOthercSs|�td��dS)Nr�)rr�rBr)r)r*r�[sz3getPhases.<locals>.InHeadNoscriptPhase.anythingElseN)r9r:r;rKr�r�r�r�r�r�rr�rrr�r�r)r�r)r*�InHeadNoscriptPhasesrcspeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�ZdS)z!getPhases.<locals>.AfterHeadPhasecsn��|||�t�d|jfd|jfd|jfd|jfd|jfg�|_|j	|j_
t�d|jfg�|_|j
|j_
dS)Nr�r�r�)	r�r�r�r�r5r�r�r�r�r�)r�r�r�)rKr
r�r��startTagBody�startTagFrameset�startTagFromHeadr�r�r�r�rr�r�r�r�r)r*rK`s��	
�
z*getPhases.<locals>.AfterHeadPhase.__init__cSs|��dSr�rrBr)r)r*r�qsz,getPhases.<locals>.AfterHeadPhase.processEOFcSs|��|Sr.rr�r)r)r*r�usz3getPhases.<locals>.AfterHeadPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�ysz.getPhases.<locals>.AfterHeadPhase.startTagHtmlcSs(d|j_|j�|�|jjd|j_dS)NFr�)rLrcr>r�rIr`r�r)r)r*r|sz.getPhases.<locals>.AfterHeadPhase.startTagBodycSs |j�|�|jjd|j_dS)Nr�)r>r�rLrIr`r�r)r)r*r�sz2getPhases.<locals>.AfterHeadPhase.startTagFramesetcSsr|j�dd|di�|jj�|jj�|jjd�|�|jjddd�D] }|jdkrL|jj�	|�qnqLdS)Nz#unexpected-start-tag-out-of-my-headr@r�rvr�)
rLrr>r~r�r�rIr�r@�remover
r)r)r*r�s
�
z2getPhases.<locals>.AfterHeadPhase.startTagFromHeadcSs|j�dd|di�dSrr�r�r)r)r*r��sz.getPhases.<locals>.AfterHeadPhase.startTagHeadcSs|��|Sr.rr�r)r)r*r��sz/getPhases.<locals>.AfterHeadPhase.startTagOthercSs|��|Sr.rr�r)r)r*r�sz2getPhases.<locals>.AfterHeadPhase.endTagHtmlBodyBrcSs|j�dd|di�dSrr�r�r)r)r*r��sz-getPhases.<locals>.AfterHeadPhase.endTagOthercSs.|j�tdd��|jjd|j_d|j_dS)Nr�rrr�T)r>r�r�rLrIr`rcrBr)r)r*r��sz.getPhases.<locals>.AfterHeadPhase.anythingElseN)r9r:r;rKr�r�r�rrrr�r�rr�r�r)r�r)r*�AfterHeadPhase_s
rcs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�Zd7d8�Zd9d:�Zd;d<�Z d=d>�Z!d?d@�Z"dAdB�Z#dCdD�Z$dEdF�Z%dGdH�Z&dIdJ�Z'dKdL�Z(dMdN�Z)dOdP�Z*dQdR�Z+dSdT�Z,dUdV�Z-dWdX�Z.dYdZ�Z/d[d\�Z0d]d^�Z1d_d`�Z2dadb�Z3dcdd�Z4dedf�Z5dgS)hzgetPhases.<locals>.InBodyPhasec$s���|||�|j|_t�d|jfd|jfd|jfd|jfd|j	ft
|jfd|jfd|j
fd|jfd	|jfd
|jfd|jfd|jfd
|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|jfd|j fd|j!fd|j"fd|j#fd|j$fd|j%fd |j&fg!�|_'|j(|j'_)t�d|j*fd|j+fd!|j,fd|j-fd"|j.fd#|j/ft
|j0fd$|j1fd|j2fd%|j3fg
�|_4|j5|j4_)dS)&Nr�)	r�r�r�r�r�r5r�r�r�r�r�)�address�article�aside�
blockquote�center�details�dirr+�dl�fieldset�
figcaption�figure�footer�header�hgroup�main�menu�nav�olr(�section�summary�ul)�pre�listing�form)�li�dd�dtrU�a)�b�big�code�em�font�i�s�small�strike�strong�tt�u�nobr�button)ZappletZmarquee�objectZxmpr�)Zarear��embed�img�keygenZwbr)Zparam�sourceZtrack�input�hr�image�isindex�textareaZiframer�)Znoembedr�r�)�rp�rt)�option�optgroupZmathry)r��colr��framer�r�r�r�r�r�r�)rr r!r"rHr#r$Zdialogr%r+r&r'r(r)r*r+r,r5r-r.r/r0r4r1r2r3r()r8r9r7)r:r;r<r=r>r?r@rGrArBrCrDrErFr�)6rK�processSpaceCharactersNonPrer�r
r�r��startTagProcessInHeadrr�startTagClosePr�startTagHeading�startTagPreListing�startTagForm�startTagListItem�startTagPlaintext�	startTagA�startTagFormatting�startTagNobr�startTagButton�startTagAppletMarqueeObject�startTagXmp�
startTagTable�startTagVoidFormatting�startTagParamSource�
startTagInput�
startTagHr�
startTagImage�startTagIsIndex�startTagTextarea�startTagIFramer��startTagRawtext�startTagSelect�startTagRpRt�startTagOpt�startTagMath�startTagSvg�startTagMisplacedr�r�r��
endTagBody�
endTagHtml�endTagBlock�
endTagForm�endTagP�endTagListItem�
endTagHeading�endTagFormatting�endTagAppletMarqueeObjectrr�r�r�r�r)r*rK�s�������-
���z'getPhases.<locals>.InBodyPhase.__init__cSs$|j|jko"|j|jko"|j|jkSr.)r@rjrk)rCZnode1Znode2r)r)r*�isMatchingFormattingElement�s

�
�z:getPhases.<locals>.InBodyPhase.isMatchingFormattingElementcSs�|j�|�|jjd}g}|jjddd�D](}|tkr@qXq.|�||�r.|�|�q.t|�dksht�t|�dkr�|jj�	|d�|jj�|�dS)Nrv�)
r>r�r~�activeFormattingElementsrr�r�r�r�r)rCr�rnZmatchingElementsr�r)r)r*�addFormattingElement�sz3getPhases.<locals>.InBodyPhase.addFormattingElementcSs>td�}|jjddd�D]}|j|kr|j�d�q:qdS)N)r8r9r7r(r�r�r�r�r�r�r�r�rvz expected-closing-tag-but-got-eof)r�r>r~r@rLr)rCZallowed_elementsr�r)r)r*r�s

z)getPhases.<locals>.InBodyPhase.processEOFcSsf|d}|j|_|�d�rH|jjdjdkrH|jjd��sH|dd�}|rb|j��|j�|�dS)Nrw�
rv)r4r5rRr)	rYr�r�r>r~r@Z
hasContent�#reconstructActiveFormattingElementsr�)rCr�rwr)r)r*�!processSpaceCharactersDropNewline
s
��
z@getPhases.<locals>.InBodyPhase.processSpaceCharactersDropNewlinecSsT|ddkrdS|j��|j�|d�|jjrPtdd�|dD��rPd|j_dS)Nrw�cSsg|]}|tk�qSr)�r�r?�charr)r)r*rD"s�zDgetPhases.<locals>.InBodyPhase.processCharacters.<locals>.<listcomp>F)r>r�r�rLrc�anyr�r)r)r*r�s
��z0getPhases.<locals>.InBodyPhase.processCharacterscSs|j��|j�|d�dSr�)r>r�r�r�r)r)r*rY&s
z;getPhases.<locals>.InBodyPhase.processSpaceCharactersNonPrecSs|jjd�|�Srr�r�r)r)r*rZ*sz4getPhases.<locals>.InBodyPhase.startTagProcessInHeadcSs�|j�dddi�t|jj�dks4|jjdjdkrB|jjs�t�nBd|j_|d�	�D],\}}||jjdj
krV||jjdj
|<qVdS)Nrr@r�rFrw)rLrr�r>r~r@rSr�rcr/rkr�r)r)r*r-s�z+getPhases.<locals>.InBodyPhase.startTagBodycSs�|j�dddi�t|jj�dks4|jjdjdkrB|jjs�t�np|jjsLnf|jjdj	rv|jjdj	�
|jjd�|jjdjdkr�|jj��qv|j�|�|jj
d|j_dS)	Nrr@r�rr�rvr�r�)rLrr�r>r~r@rSr�rc�parent�removeChildrr�rIr`r�r)r)r*r8s"z/getPhases.<locals>.InBodyPhase.startTagFramesetcSs.|jjddd�r|�td��|j�|�dS�Nr(rH��variant)r>�elementInScoper{r�r�r�r)r)r*r[Fsz-getPhases.<locals>.InBodyPhase.startTagClosePcSs>|jjddd�r|�td��|j�|�d|j_|j|_dS)Nr(rHr�F)	r>r�r{r�r�rLrcr�r�r�r)r)r*r]Ks
z1getPhases.<locals>.InBodyPhase.startTagPreListingcSsZ|jjr|j�dddi�n:|jjddd�r:|�td��|j�|�|jjd|j_dS)Nrr@r6r(rHr�rv)	r>�formPointerrLrr�r{r�r�r~r�r)r)r*r^Rsz+getPhases.<locals>.InBodyPhase.startTagFormcSs�d|j_dgddgddgd�}||d}t|jj�D]@}|j|kr^|jj�t|jd��qx|j	t
kr6|jdkr6qxq6|jjd	d
d�r�|jj�td	d��|j�|�dS)NFr7r9r8)r7r9r8r@rs)rr+r(r(rHr�)
rLrc�reversedr>r~r@r`r�r��	nameTuplerr�r�)rCr�ZstopNamesMapZ	stopNamesr�r)r)r*r_[s*�

�
��z/getPhases.<locals>.InBodyPhase.startTagListItemcSs>|jjddd�r|�td��|j�|�|jjj|jj_dSr�)	r>r�r{r�r�rLrOr_r]r�r)r)r*r`qsz0getPhases.<locals>.InBodyPhase.startTagPlaintextcSsb|jjddd�r|�td��|jjdjtkrR|j�dd|di�|jj�	�|j�
|�dS)Nr(rHr�rvrr@)r>r�r{r�r~r@rrLrrr�r�r)r)r*r\wsz.getPhases.<locals>.InBodyPhase.startTagHeadingcSs~|j�d�}|rf|j�dddd��|�td��||jjkrL|jj�|�||jjkrf|jj�|�|j�	�|�
|�dS)Nr:�$unexpected-start-tag-implies-end-tag�Z	startNameZendName)r>�!elementInActiveFormattingElementsrLrr~r�r~rr�r�r�)rCr�ZafeAElementr)r)r*ras�
z(getPhases.<locals>.InBodyPhase.startTagAcSs|j��|�|�dSr.)r>r�r�r�r)r)r*rb�s
z1getPhases.<locals>.InBodyPhase.startTagFormattingcSsP|j��|j�d�rB|j�dddd��|�td��|j��|�|�dS)NrGr�r�)r>r�r�rLrr�r�r�r�r)r)r*rc�s
�
z+getPhases.<locals>.InBodyPhase.startTagNobrcSsT|j�d�r2|j�dddd��|�td��|S|j��|j�|�d|j_dS)NrHr�r�F)	r>r�rLrr�r�r�r�rcr�r)r)r*rd�s�
z-getPhases.<locals>.InBodyPhase.startTagButtoncSs0|j��|j�|�|jj�t�d|j_dS�NF)r>r�r�r�r�rrLrcr�r)r)r*re�s
z:getPhases.<locals>.InBodyPhase.startTagAppletMarqueeObjectcSsB|jjddd�r|�td��|j��d|j_|j�|d�dS)Nr(rHr�Fr�)r>r�r{r�r�rLrcr�r�r)r)r*rf�s

z*getPhases.<locals>.InBodyPhase.startTagXmpcSsR|jjdkr*|jjddd�r*|�td��|j�|�d|j_|jjd|j_	dS)Nr�r(rHr�Fr�)
rLrZr>r�r�r�r�rcrIr`r�r)r)r*rg�sz,getPhases.<locals>.InBodyPhase.startTagTablecSs6|j��|j�|�|jj��d|d<d|j_dS)NTr|F)r>r�r�r~rrLrcr�r)r)r*rh�s

z5getPhases.<locals>.InBodyPhase.startTagVoidFormattingcSs@|jj}|�|�d|dkr<|dd�t�dkr<||j_dS)Nr3rw�hidden)rLrcrhrlr)rCr�rcr)r)r*rj�s
�z,getPhases.<locals>.InBodyPhase.startTagInputcSs$|j�|�|jj��d|d<dSrrr�r)r)r*ri�sz2getPhases.<locals>.InBodyPhase.startTagParamSourcecSsJ|jjddd�r|�td��|j�|�|jj��d|d<d|j_dS)Nr(rHr�Tr|F)	r>r�r{r�r�r~rrLrcr�r)r)r*rk�sz)getPhases.<locals>.InBodyPhase.startTagHrcSs6|j�dddd��|�tdd|d|dd��dS)	Nzunexpected-start-tag-treated-asrPrK�ZoriginalNameZnewNamerrrwr{�rkr{)rLrr�r�r�r)r)r*rl�s�
�z,getPhases.<locals>.InBodyPhase.startTagImagecSs|j�dddi�|jjrdSi}d|dkr>|dd|d<|�tdd|d��|�td	d��|�td
d��d|dkr�|dd}nd}|�td
|d��|d��}d|kr�|d=d|kr�|d=d|d<|�tdd||dd��|�	td
��|�td	d��|�	td��dS)Nzdeprecated-tagr@rQ�actionrwr6rr)rkrOZlabel�promptz3This is a searchable index. Enter search keywords: rq�r3rwrNr{r�)
rLrr>r�r�r�r�r�copyr�)rCr�Z
form_attrsr�rkr)r)r*rm�s<
��
�z.getPhases.<locals>.InBodyPhase.startTagIsIndexcSs0|j�|�|jjj|jj_|j|_d|j_dSr�)	r>r�rLrOr\r]r�r�rcr�r)r)r*rn�sz/getPhases.<locals>.InBodyPhase.startTagTextareacSsd|j_|�|�dSr�)rLrcrpr�r)r)r*rosz-getPhases.<locals>.InBodyPhase.startTagIFramecSs"|jjr|�|�n
|�|�dSr.)rLrNrpr�r�r)r)r*r�sz/getPhases.<locals>.InBodyPhase.startTagNoscriptcSs|j�|d�dS)z8iframe, noembed noframes, noscript(if scripting enabled)r�Nr	r�r)r)r*rp
sz.getPhases.<locals>.InBodyPhase.startTagRawtextcSs@|jjdjdkr$|jj�td��|j��|jj�|�dS�NrvrU)	r>r~r@rLr`r�r�r�r�r�r)r)r*rss
z*getPhases.<locals>.InBodyPhase.startTagOptcSs�|j��|j�|�d|j_|jj|jjd|jjd|jjd|jjd|jjd|jjdfkrx|jjd|j_n|jjd	|j_dS)
NFr�r�r�r�r�r��inSelectInTabler�)r>r�r�rLrcr`rIr�r)r)r*rqs





�z-getPhases.<locals>.InBodyPhase.startTagSelectcSsB|j�d�r2|j��|jjdjdkr2|j��|j�|�dS)N�rubyrv)r>r��generateImpliedEndTagsr~r@rLrr�r�r)r)r*rr%s


z+getPhases.<locals>.InBodyPhase.startTagRpRtcSsZ|j��|j�|�|j�|�td|d<|j�|�|drV|jj��d|d<dS)Nrhrjr{Tr|)	r>r�rLrrrr�r~rr�r)r)r*rt,s
z+getPhases.<locals>.InBodyPhase.startTagMathcSsZ|j��|j�|�|j�|�td|d<|j�|�|drV|jj��d|d<dS)Nryrjr{Tr|)	r>r�rLrrrr�r~rr�r)r)r*ru8s
z*getPhases.<locals>.InBodyPhase.startTagSvgcSs|j�dd|di�dS)a5 Elements that should be children of other elements that have a
            different insertion mode; here they are ignored
            "caption", "col", "colgroup", "frame", "frameset", "head",
            "option", "optgroup", "tbody", "td", "tfoot", "th", "thead",
            "tr", "noscript"
            zunexpected-start-tag-ignoredr@Nr�r�r)r)r*rvDsz0getPhases.<locals>.InBodyPhase.startTagMisplacedcSs|j��|j�|�dSr.)r>r�r�r�r)r)r*r�Ms
z,getPhases.<locals>.InBodyPhase.startTagOthercSs�|jjddd�sD|�tdd��|j�dddi�|�tdd��nT|j�d�|jjdj	dkrt|j�dddi�|jj�
�}|j	dkr�|jj�
�}q�dS)	Nr(rHr�rrrr@rsrv)r>r�r[r�rLrr{r�r~r@rr
r)r)r*r{Qs
z&getPhases.<locals>.InBodyPhase.endTagPcSs~|j�d�s|j��dS|jjdjdkrj|jjdd�D],}|jtd�kr<|j�dd|jd��qjq<|jjd|j_dS)Nr�rv�)r8r9r7rVrUr(rSrTr�r�r�r�r�r�r�r��$expected-one-end-tag-but-got-another�ZgotNameZexpectedName�	afterBody)	r>r�rLrr~r@r�rIr`r
r)r)r*rw^s

�z)getPhases.<locals>.InBodyPhase.endTagBodycSs"|j�d�r|�td��|SdS)Nr�)r>r�rwr�r�r)r)r*rxpsz)getPhases.<locals>.InBodyPhase.endTagHtmlcSs�|ddkr|j|_|j�|d�}|r2|j��|jjdj|dkr^|j�dd|di�|r�|jj�	�}|j|dkr�|jj�	�}qndS)Nr@r4rv�end-tag-too-early)
rYr�r>r�r�r~r@rLrr)rCr�ZinScoper�r)r)r*ryvs
z*getPhases.<locals>.InBodyPhase.endTagBlockcSsv|jj}d|j_|dks$|j�|�s8|j�dddi�n:|j��|jjd|krd|j�dddi�|jj�|�dS)Nrr@r6rvzend-tag-too-early-ignored)r>r�r�rLrr�r~rr
r)r)r*rz�s�
�z)getPhases.<locals>.InBodyPhase.endTagFormcSs�|ddkrd}nd}|jj|d|d�sB|j�dd|di�nf|jj|dd�|jjdj|dkr�|j�dd|di�|jj��}|j|dkr�|jj��}q�dS)	Nr@r7�listr�r��excludervr�)r>r�rLrr�r~r@r)rCr�r�r�r)r)r*r|�s
�z-getPhases.<locals>.InBodyPhase.endTagListItemcSs�tD]}|j�|�r|j��q$q|jjdj|dkrP|j�dd|di�tD]8}|j�|�rT|jj��}|jtkr�|jj��}qpq�qTdS)Nrvr@r�)	rr>r�r�r~r@rLrr)rCr��itemr)r)r*r}�s

z,getPhases.<locals>.InBodyPhase.endTagHeadingcSsd}|dk�r
|d7}|j�|d�}|rD||jjkrR|j�|j�sR|�|�dS||jjkr�|j�dd|di�|jj�	|�dS|j�|j�s�|j�dd|di�dS||jjdkr�|j�d	d|di�|jj�
|�}d}|jj|d�D]}|jtkr�|}�qq�|dk�rR|jj�
�}||k�r@|jj�
�}�q&|jj�	|�dS|jj|d}|jj�
|�}|}	}
d}|jj�
|
�}|d
k�rX|d7}|d8}|jj|}
|
|jjk�r�|jj�	|
��q�|
|k�rސqX|	|k�r�|jj�
|
�d}|
��}
|
|jj|jj�
|
�<|
|jj|jj�
|
�<|
}
|	j�rF|	j�|	�|
�|	�|
}	�q�|	j�rl|	j�|	�|jtd�k�r�|j��\}}|�|	|�n
|�|	�|��}
|�|
�|�|
�|jj�	|�|jj�||
�|jj�	|�|jj�|jj�
|�d|
�qdS)z)The much-feared adoption agency algorithmr�rr@Nzadoption-agency-1.2zadoption-agency-4.4rvzadoption-agency-1.3r��r�r�r�r�r�)r>r�r~r�r@r�rLrr�r�indexr�rrZ	cloneNoder�r�ZappendChildr�ZgetTableMisnestedNodePosition�insertBeforeZreparentChildren�insert)rCr�ZouterLoopCounterZformattingElementZafeIndexZ
furthestBlockrnZcommonAncestorZbookmarkZlastNoder�ZinnerLoopCounterr�Zcloner�r�r)r)r*r~�s�

�
��







����



�z/getPhases.<locals>.InBodyPhase.endTagFormattingcSs�|j�|d�r|j��|jjdj|dkrF|j�dd|di�|j�|d�r�|jj��}|j|dkr~|jj��}qb|j��dS)Nr@rvr�)	r>r�r�r~r@rLrr�clearActiveFormattingElements)rCr�rnr)r)r*rTs
z8getPhases.<locals>.InBodyPhase.endTagAppletMarqueeObjectcSs@|j�dddd��|j��|j�tdd��|jj��dS)Nzunexpected-end-tag-treated-asr�z
br elementr�rr)rLrr>r�r�r�r~rr�r)r)r*r`s�
z'getPhases.<locals>.InBodyPhase.endTagBrcSs�|jjddd�D]�}|j|dkrz|jj|dd�|jjdj|dkrb|j�dd|di�|jj��|krtqbq�q|jtkr|j�dd|di�q�qdS)Nrvr@r�r)	r>r~r@r�rLrrr�rr
r)r)r*r�gs
z*getPhases.<locals>.InBodyPhase.endTagOtherN)6r9r:r;rKr�r�r�r�r�rYrZrrr[r]r^r_r`r\rarbrcrdrerfrgrhrjrirkrlrmrnror�rprsrqrrrtrurvr�r{rwrxryrzr|r}r~rrr�r)r�r)r*�InBodyPhase�shG

	

	

$r�cs@eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
S)zgetPhases.<locals>.TextPhasecsF��|||�t�g�|_|j|j_t�d|jfg�|_|j|j_dS�Nr�)	rKr
r�r�r�r��endTagScriptr�r�r�r�r)r*rKvs
�z%getPhases.<locals>.TextPhase.__init__cSs|j�|d�dSr�r�r�r)r)r*r�~sz.getPhases.<locals>.TextPhase.processCharacterscSs8|j�dd|jjdji�|jj��|jj|j_dS)Nz&expected-named-closing-tag-but-got-eofr@rvT)rLrr>r~r@rr�r`rBr)r)r*r��s�z'getPhases.<locals>.TextPhase.processEOFcSsdstd|d��dS)NFz4Tried to process start tag %s in RCDATA/RAWTEXT moder@)r�r�r)r)r*r��sz*getPhases.<locals>.TextPhase.startTagOthercSs*|jj��}|jdkst�|jj|j_dSr�)r>r~rr@r�rLr�r`r
r)r)r*r��sz)getPhases.<locals>.TextPhase.endTagScriptcSs|jj��|jj|j_dSr.)r>r~rrLr�r`r�r)r)r*r��sz(getPhases.<locals>.TextPhase.endTagOtherN)	r9r:r;rKr�r�r�r�r�r)r�r)r*�	TextPhaseusr�cs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'S)(zgetPhases.<locals>.InTablePhasec
s���|||�t�d|jfd|jfd|jfd|jfd|jfd|jfd|j	fd|j
fd	|jfd
|jfg
�|_
|j|j
_t�d|jfd|jfg�|_|j|j_dS)Nr�r�r�rW�r�r�r�)r�r�r�r�)r�r�rNr6)r�r�rWr�r�r�r�r�r�r�r�)rKr
r�r��startTagCaption�startTagColgroup�startTagCol�startTagRowGroup�startTagImplyTbodyrg�startTagStyleScriptrjr^r�r�r��endTagTable�endTagIgnorer�r�r�r�r)r*rK�s*�
��z(getPhases.<locals>.InTablePhase.__init__cSs$|jjdjdkr |jj��qdS)Nrv)r�r�)r>r~r@rrBr)r)r*�clearStackToTableContext�sz8getPhases.<locals>.InTablePhase.clearStackToTableContextcSs0|jjdjdkr |j�d�n|jjs,t�dS)Nrvr�zeof-in-table�r>r~r@rLrrSr�rBr)r)r*r��sz*getPhases.<locals>.InTablePhase.processEOFcSs4|jj}|jjd|j_||jj_|jj�|�dS�N�inTableText)rLr`rIr�r��rCr�r�r)r)r*r��s
z6getPhases.<locals>.InTablePhase.processSpaceCharacterscSs4|jj}|jjd|j_||jj_|jj�|�dSr�)rLr`rIr�r�r�r)r)r*r��s
z1getPhases.<locals>.InTablePhase.processCharacterscSs&d|j_|jjd�|�d|j_dS)NTr�F)r>�insertFromTablerLrIr�r�r)r)r*r��sz*getPhases.<locals>.InTablePhase.insertTextcSs6|��|jj�t�|j�|�|jjd|j_dS)Nr�)	r�r>r�r�rr�rLrIr`r�r)r)r*r��sz/getPhases.<locals>.InTablePhase.startTagCaptioncSs(|��|j�|�|jjd|j_dS)Nr��r�r>r�rLrIr`r�r)r)r*r��sz0getPhases.<locals>.InTablePhase.startTagColgroupcSs|�tdd��|S)Nr�rr)r�r�r�r)r)r*r��sz+getPhases.<locals>.InTablePhase.startTagColcSs(|��|j�|�|jjd|j_dS�Nr�r�r�r)r)r*r��sz0getPhases.<locals>.InTablePhase.startTagRowGroupcSs|�tdd��|S)Nr�rr)r�r�r�r)r)r*r��sz2getPhases.<locals>.InTablePhase.startTagImplyTbodycSs6|j�dddd��|jj�td��|jjs2|SdS)Nr�r�r�)rLrr`r�r�rSr�r)r)r*rg�s�z-getPhases.<locals>.InTablePhase.startTagTablecSs|jjd�|�Srr�r�r)r)r*r��sz3getPhases.<locals>.InTablePhase.startTagStyleScriptcSsVd|dkrH|dd�t�dkrH|j�d�|j�|�|jj��n
|�|�dS)Nr3rwr�z unexpected-hidden-input-in-table)	rlrrLrr>r�r~rr�r�r)r)r*rj�s�z-getPhases.<locals>.InTablePhase.startTagInputcSsD|j�d�|jjdkr@|j�|�|jjd|j_|jj��dS)Nzunexpected-form-in-tablerv)rLrr>r�r�r~rr�r)r)r*r^�s
z,getPhases.<locals>.InTablePhase.startTagFormcSs<|j�dd|di�d|j_|jjd�|�d|j_dS)Nz)unexpected-start-tag-implies-table-voodoor@Tr�F)rLrr>r�rIr�r�r)r)r*r�sz-getPhases.<locals>.InTablePhase.startTagOthercSs�|jjddd�r�|j��|jjdjdkrJ|j�dd|jjdjd��|jjdjdkrj|jj��qJ|jj��|j��n|jj	s�t
�|j��dS)Nr�r�rvzend-tag-too-early-namedr�)r>r�r�r~r@rLrrrbrSr�r�r)r)r*r�
s
��z+getPhases.<locals>.InTablePhase.endTagTablecSs|j�dd|di�dSrr�r�r)r)r*r�sz,getPhases.<locals>.InTablePhase.endTagIgnorecSs<|j�dd|di�d|j_|jjd�|�d|j_dS)Nz'unexpected-end-tag-implies-table-voodoor@Tr�F)rLrr>r�rIr�r�r)r)r*r� sz+getPhases.<locals>.InTablePhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�rgr�rjr^r�r�r�r�r)r�r)r*�InTablePhase�s&	
r�csPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)z#getPhases.<locals>.InTableTextPhasecs��|||�d|_g|_dSr.)rKr��characterTokensr�r�r)r*rK(sz,getPhases.<locals>.InTableTextPhase.__init__cSsdd�dd�|jD��}tdd�|D��rJtd|d�}|jjd�|�n|rZ|j�|�g|_dS)Nr�cSsg|]}|d�qS)rwr)�r?r�r)r)r*rD.szGgetPhases.<locals>.InTableTextPhase.flushCharacters.<locals>.<listcomp>cSsg|]}|tk�qSr)r�r�r)r)r*rD/srqr�r�)�joinr�r�rrLrIr�r>)rCrwr�r)r)r*�flushCharacters-sz3getPhases.<locals>.InTableTextPhase.flushCharacterscSs|��|j|j_|Sr.�r�r�rLr`r�r)r)r*r�6s
z2getPhases.<locals>.InTableTextPhase.processCommentcSs|��|j|j_dSr�r�rBr)r)r*r�;s
z.getPhases.<locals>.InTableTextPhase.processEOFcSs |ddkrdS|j�|�dS�Nrwr��r�r�r�r)r)r*r�@sz5getPhases.<locals>.InTableTextPhase.processCharacterscSs|j�|�dSr.r�r�r)r)r*r�Esz:getPhases.<locals>.InTableTextPhase.processSpaceCharacterscSs|��|j|j_|Sr.r�r�r)r)r*r�Js
z3getPhases.<locals>.InTableTextPhase.processStartTagcSs|��|j|j_|Sr.r�r�r)r)r*r�Os
z1getPhases.<locals>.InTableTextPhase.processEndTagN)r9r:r;rKr�r�r�r�r�r�r�r)r�r)r*�InTableTextPhase's	r�cs`eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�ZdS)z!getPhases.<locals>.InCaptionPhasecsf��|||�t�d|jfd|jfg�|_|j|j_t�d|jfd|j	fd|j
fg�|_|j|j_dS)Nr��	r�rWr�r�r�r�r�r�r�r�r�)
r�rWr�r�r�r�r�r�r�r�)
rKr
r�r��startTagTableElementr�r�r��
endTagCaptionr�r�r�r�r�r�r)r*rKVs ��
��z*getPhases.<locals>.InCaptionPhase.__init__cSs|jjddd�S)Nr�r�r��r>r�rBr)r)r*�ignoreEndTagCaptionhsz5getPhases.<locals>.InCaptionPhase.ignoreEndTagCaptioncSs|jjd��dSr��rLrIr�rBr)r)r*r�ksz,getPhases.<locals>.InCaptionPhase.processEOFcSs|jjd�|�Sr��rLrIr�r�r)r)r*r�nsz3getPhases.<locals>.InCaptionPhase.processCharacterscSs0|j��|��}|jj�td��|s,|SdS�Nr��rLrr�r`r�r��rCr��ignoreEndTagr)r)r*r�qs

z6getPhases.<locals>.InCaptionPhase.startTagTableElementcSs|jjd�|�Sr�r�r�r)r)r*r�ysz/getPhases.<locals>.InCaptionPhase.startTagOthercSs�|��s�|j��|jjdjdkrB|j�dd|jjdjd��|jjdjdkrb|jj��qB|jj��|j��|jj	d|j_
n|jjs�t�|j��dS)Nrvr�r�r�r�)
r�r>r�r~r@rLrrr�rIr`rSr�r�r)r)r*r�|s
��
z/getPhases.<locals>.InCaptionPhase.endTagCaptioncSs0|j��|��}|jj�td��|s,|SdSr�r�r�r)r)r*r��s

z-getPhases.<locals>.InCaptionPhase.endTagTablecSs|j�dd|di�dSrr�r�r)r)r*r��sz.getPhases.<locals>.InCaptionPhase.endTagIgnorecSs|jjd�|�Sr��rLrIr�r�r)r)r*r��sz-getPhases.<locals>.InCaptionPhase.endTagOtherN)
r9r:r;rKr�r�r�r�r�r�r�r�r�r)r�r)r*�InCaptionPhaseTsr�csXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z%getPhases.<locals>.InColumnGroupPhasecs^��|||�t�d|jfd|jfg�|_|j|j_t�d|jfd|j	fg�|_
|j|j
_dS)Nr�rWr�)rKr
r�r�r�r�r�r��endTagColgroup�	endTagColr�r�r�r�r)r*rK�s�
�z.getPhases.<locals>.InColumnGroupPhase.__init__cSs|jjdjdkS)Nrvr�)r>r~r@rBr)r)r*�ignoreEndTagColgroup�sz:getPhases.<locals>.InColumnGroupPhase.ignoreEndTagColgroupcSsD|jjdjdkr"|jjst�dS|��}|�td��|s@dSdS)Nrvr�r�T)	r>r~r@rLrSr�r�r�r�)rCr�r)r)r*r��sz0getPhases.<locals>.InColumnGroupPhase.processEOFcSs"|��}|�td��|s|SdS�Nr��r�r�r�r�r)r)r*r��sz7getPhases.<locals>.InColumnGroupPhase.processCharacterscSs$|j�|�|jj��d|d<dSrrr�r)r)r*r��sz1getPhases.<locals>.InColumnGroupPhase.startTagColcSs"|��}|�td��|s|SdSr�r�r�r)r)r*r��sz3getPhases.<locals>.InColumnGroupPhase.startTagOthercSs@|��r |jjst�|j��n|jj��|jjd|j_	dS�Nr�)
r�rLrSr�rr>r~rrIr`r�r)r)r*r��s
z4getPhases.<locals>.InColumnGroupPhase.endTagColgroupcSs|j�dddi�dS)Nz
no-end-tagr@rWr�r�r)r)r*r��sz/getPhases.<locals>.InColumnGroupPhase.endTagColcSs"|��}|�td��|s|SdSr�r�r�r)r)r*r��sz1getPhases.<locals>.InColumnGroupPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r)r�r)r*�InColumnGroupPhase�s
	r�csxeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS)z#getPhases.<locals>.InTableBodyPhasecsv��|||�t�d|jfd|jfd|jfd|jfg�|_|j|j_	t�d|j
fd|jfd|jfg�|_
|j|j
_	dS)Nr�r��r�r�)r�rWr�r�r�r�r�r�)r�r�rWr�r�r�r�r�)rKr
r�r��
startTagTr�startTagTableCell�startTagTableOtherr�r�r��endTagTableRowGroupr�r�r�r�r�r�r)r*rK�s$��
��z,getPhases.<locals>.InTableBodyPhase.__init__cSsB|jjdjdkr |jj��q|jjdjdkr>|jjs>t�dS)Nrv)r�r�r�r�r�)r>r~r@rrLrSr�rBr)r)r*�clearStackToTableBodyContext�sz@getPhases.<locals>.InTableBodyPhase.clearStackToTableBodyContextcSs|jjd��dSr�r�rBr)r)r*r��sz.getPhases.<locals>.InTableBodyPhase.processEOFcSs|jjd�|�Sr�rr�r)r)r*r�sz:getPhases.<locals>.InTableBodyPhase.processSpaceCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�sz5getPhases.<locals>.InTableBodyPhase.processCharacterscSs(|��|j�|�|jjd|j_dS)Nr�)r�r>r�rLrIr`r�r)r)r*r�sz.getPhases.<locals>.InTableBodyPhase.startTagTrcSs*|j�dd|di�|�tdd��|S)Nzunexpected-cell-in-table-bodyr@r�rr)rLrr�r�r�r)r)r*r�s

�z5getPhases.<locals>.InTableBodyPhase.startTagTableCellcSsn|jjddd�s0|jjddd�s0|jjddd�rT|��|�t|jjdj��|S|jjs`t	�|j�
�dS�Nr�r�r�r�r�rv�r>r�r�r�r�r~r@rLrSr�rr�r)r)r*r�s���z6getPhases.<locals>.InTableBodyPhase.startTagTableOthercSs|jjd�|�Sr�r�r�r)r)r*r�sz1getPhases.<locals>.InTableBodyPhase.startTagOthercSsT|jj|ddd�r:|��|jj��|jjd|j_n|j�dd|di�dS)Nr@r�r�r�� unexpected-end-tag-in-table-body)	r>r�r�r~rrLrIr`rr�r)r)r*r�"s
�z7getPhases.<locals>.InTableBodyPhase.endTagTableRowGroupcSsn|jjddd�s0|jjddd�s0|jjddd�rT|��|�t|jjdj��|S|jjs`t	�|j�
�dSr�r�r�r)r)r*r�+s���z/getPhases.<locals>.InTableBodyPhase.endTagTablecSs|j�dd|di�dS)Nr�r@r�r�r)r)r*r�8s
�z0getPhases.<locals>.InTableBodyPhase.endTagIgnorecSs|jjd�|�Sr�r�r�r)r)r*r�<sz/getPhases.<locals>.InTableBodyPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�r�r�r)r�r)r*�InTableBodyPhase�s
	
r�cs�eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)zgetPhases.<locals>.InRowPhasecsv��|||�t�d|jfd|jfd|jfg�|_|j|j_t�d|j	fd|j
fd|jfd|jfg�|_
|j|j
_dS)Nr�r�)r�rWr�r�r�r�r�r�r�r�)r�r�rWr�r�r�r�)rKr
r�r�r�r�r�r�r��endTagTrr�r�r�r�r�r�r�r)r*rKAs$��
��z&getPhases.<locals>.InRowPhase.__init__cSs@|jjdjdkr<|j�dd|jjdji�|jj��qdS)Nrv)r�r�z'unexpected-implied-end-tag-in-table-rowr@)r>r~r@rLrrrBr)r)r*�clearStackToTableRowContextUs
�z9getPhases.<locals>.InRowPhase.clearStackToTableRowContextcSs|jjddd�S)Nr�r�r�r�rBr)r)r*�ignoreEndTagTr[sz,getPhases.<locals>.InRowPhase.ignoreEndTagTrcSs|jjd��dSr�r�rBr)r)r*r�_sz(getPhases.<locals>.InRowPhase.processEOFcSs|jjd�|�Sr�rr�r)r)r*r�bsz4getPhases.<locals>.InRowPhase.processSpaceCharacterscSs|jjd�|�Sr�r�r�r)r)r*r�esz/getPhases.<locals>.InRowPhase.processCharacterscSs6|��|j�|�|jjd|j_|jj�t�dS)Nr�)	r�r>r�rLrIr`r�r�rr�r)r)r*r�hsz/getPhases.<locals>.InRowPhase.startTagTableCellcSs"|��}|�td��|s|SdS�Nr��r�r�r�r�r)r)r*r�nsz0getPhases.<locals>.InRowPhase.startTagTableOthercSs|jjd�|�Sr�r�r�r)r)r*r�usz+getPhases.<locals>.InRowPhase.startTagOthercSsH|��s.|��|jj��|jjd|j_n|jjs:t	�|j�
�dSr�)r�r�r>r~rrLrIr`rSr�rr�r)r)r*r�xsz&getPhases.<locals>.InRowPhase.endTagTrcSs"|��}|�td��|s|SdSr�r�r�r)r)r*r��sz)getPhases.<locals>.InRowPhase.endTagTablecSs4|jj|ddd�r&|�td��|S|j��dS)Nr@r�r�r�)r>r�r�r�rLrr�r)r)r*r��sz1getPhases.<locals>.InRowPhase.endTagTableRowGroupcSs|j�dd|di�dS)Nzunexpected-end-tag-in-table-rowr@r�r�r)r)r*r��s
�z*getPhases.<locals>.InRowPhase.endTagIgnorecSs|jjd�|�Sr�r�r�r)r)r*r��sz)getPhases.<locals>.InRowPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�r�r�r�r�r�r�r�r�r)r�r)r*�
InRowPhase?s
r�cs`eZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�ZdS)zgetPhases.<locals>.InCellPhasecsf��|||�t�d|jfd|jfg�|_|j|j_t�d|jfd|j	fd|j
fg�|_|j|j_dS)Nr�r�r�)r�r�rWr�r�r�)
rKr
r�r�r�r�r�r��endTagTableCellr��endTagImplyr�r�r�r�r)r*rK�s��
�z'getPhases.<locals>.InCellPhase.__init__cSsB|jjddd�r |�td��n|jjddd�r>|�td��dS�Nr�r�r�r�)r>r�r�r�rBr)r)r*�	closeCell�sz(getPhases.<locals>.InCellPhase.closeCellcSs|jjd��dSr�r�rBr)r)r*r��sz)getPhases.<locals>.InCellPhase.processEOFcSs|jjd�|�Sr�r�r�r)r)r*r��sz0getPhases.<locals>.InCellPhase.processCharacterscSsF|jjddd�s |jjddd�r,|��|S|jjs8t�|j��dSr�)r>r�r�rLrSr�rr�r)r)r*r��s�z1getPhases.<locals>.InCellPhase.startTagTableOthercSs|jjd�|�Sr�r�r�r)r)r*r��sz,getPhases.<locals>.InCellPhase.startTagOthercSs�|jj|ddd�r�|j�|d�|jjdj|dkrp|j�dd|di�|jj��}|j|dkrPq|qPn|jj��|j��|jj	d|j_
n|j�dd|di�dS)Nr@r�r�rvzunexpected-cell-end-tagr�r)r>r�r�r~r@rLrrr�rIr`r
r)r)r*r��s
�
z.getPhases.<locals>.InCellPhase.endTagTableCellcSs|j�dd|di�dSrr�r�r)r)r*r��sz+getPhases.<locals>.InCellPhase.endTagIgnorecSs.|jj|ddd�r |��|S|j��dS)Nr@r�r�)r>r�r�rLrr�r)r)r*r��sz*getPhases.<locals>.InCellPhase.endTagImplycSs|jjd�|�Sr�r�r�r)r)r*r��sz*getPhases.<locals>.InCellPhase.endTagOtherN)
r9r:r;rKr�r�r�r�r�r�r�r�r�r)r�r)r*�InCellPhase�s
r�csxeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS)z getPhases.<locals>.InSelectPhasec	s���|||�t�d|jfd|jfd|jfd|jfd|jfd|jfg�|_	|j
|j	_t�d|jfd|j
fd|jfg�|_|j|j_dS)Nr�rUrVr�)rNrLrRr�)rKr
r�r��startTagOption�startTagOptgrouprqrjr�r�r�r��endTagOption�endTagOptgroup�endTagSelectr�r�r�r�r)r*rK�s �
�z)getPhases.<locals>.InSelectPhase.__init__cSs0|jjdjdkr |j�d�n|jjs,t�dS)Nrvr�z
eof-in-selectr�rBr)r)r*r��sz+getPhases.<locals>.InSelectPhase.processEOFcSs$|ddkrdS|j�|d�dSr�r�r�r)r)r*r�	sz2getPhases.<locals>.InSelectPhase.processCharacterscSs.|jjdjdkr|jj��|j�|�dSr��r>r~r@rr�r�r)r)r*r�	sz/getPhases.<locals>.InSelectPhase.startTagOptioncSsL|jjdjdkr|jj��|jjdjdkr<|jj��|j�|�dS)NrvrUrVr�r�r)r)r*r�	s
z1getPhases.<locals>.InSelectPhase.startTagOptgroupcSs|j�d�|�td��dS)Nzunexpected-select-in-selectr�)rLrr�r�r�r)r)r*rq	sz/getPhases.<locals>.InSelectPhase.startTagSelectcSs>|j�d�|jjddd�r.|�td��|S|jjs:t�dS)Nzunexpected-input-in-selectr�r�)rLrr>r�r�r�rSr�r�r)r)r*rj	s
z.getPhases.<locals>.InSelectPhase.startTagInputcSs|jjd�|�Srr�r�r)r)r*r�	sz/getPhases.<locals>.InSelectPhase.startTagScriptcSs|j�dd|di�dS)Nzunexpected-start-tag-in-selectr@r�r�r)r)r*r�!	s
�z.getPhases.<locals>.InSelectPhase.startTagOthercSs6|jjdjdkr |jj��n|j�dddi�dS)NrvrU�unexpected-end-tag-in-selectr@�r>r~r@rrLrr�r)r)r*r�%	s
�z-getPhases.<locals>.InSelectPhase.endTagOptioncSsf|jjdjdkr0|jjdjdkr0|jj��|jjdjdkrP|jj��n|j�dddi�dS)NrvrU���rVrr@rr�r)r)r*r�,	s��z/getPhases.<locals>.InSelectPhase.endTagOptgroupcSsZ|jjddd�r@|jj��}|jdkr4|jj��}q|j��n|jjsLt�|j�	�dS)Nr�r�)
r>r�r~rr@rLrbrSr�rr
r)r)r*r�9	s
z-getPhases.<locals>.InSelectPhase.endTagSelectcSs|j�dd|di�dS)Nrr@r�r�r)r)r*r�D	s
�z,getPhases.<locals>.InSelectPhase.endTagOtherN)r9r:r;rKr�r�r�r�rqrjr�r�r�r�r�r�r)r�r)r*�
InSelectPhase�s
rcsHeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dS)z'getPhases.<locals>.InSelectInTablePhasecsN��|||�t�d|jfg�|_|j|j_t�d|jfg�|_|j	|j_dS)N)r�r�r�r�r�r�r�r�)
rKr
r�rgr�r�r�r�r�r�r�r�r)r*rKI	s��
��z0getPhases.<locals>.InSelectInTablePhase.__init__cSs|jjd��dS�Nr�r�rBr)r)r*r�X	sz2getPhases.<locals>.InSelectInTablePhase.processEOFcSs|jjd�|�Srr�r�r)r)r*r�[	sz9getPhases.<locals>.InSelectInTablePhase.processCharacterscSs(|j�dd|di�|�td��|S)Nz5unexpected-table-element-start-tag-in-select-in-tabler@r�)rLrr�r�r�r)r)r*rg^	sz5getPhases.<locals>.InSelectInTablePhase.startTagTablecSs|jjd�|�Srr�r�r)r)r*r�c	sz5getPhases.<locals>.InSelectInTablePhase.startTagOthercSs@|j�dd|di�|jj|ddd�r<|�td��|SdS)Nz3unexpected-table-element-end-tag-in-select-in-tabler@r�r�r�)rLrr>r�r�r�r�r)r)r*r�f	sz3getPhases.<locals>.InSelectInTablePhase.endTagTablecSs|jjd�|�Srr�r�r)r)r*r�l	sz3getPhases.<locals>.InSelectInTablePhase.endTagOtherN)
r9r:r;rKr�r�rgr�r�r�r)r�r)r*�InSelectInTablePhaseH	src-s�eZdZeddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,g,�Z�fd-d.�Zd/d0�Z�fd1d2�Zd3d4�Zd5d6�Z	d7S)8z(getPhases.<locals>.InForeignContentPhaser;r<r"r�r�r#r=r8r+r&r9r>rJZh1Zh2Zh3Zh4Zh5Zh6r�rOr@rKr7r5r.r5rGr0r(r4r�rArB�spanrDrC�subZsupr�rErFr3�varcs��|||�dSr.)rKr�r�r)r*rKy	sz1getPhases.<locals>.InForeignContentPhase.__init__c%Ssnddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%�$}|d&|krj||d&|d&<dS)'NZaltGlyphZaltGlyphDefZaltGlyphItemZanimateColorZ
animateMotionZanimateTransformZclipPathZfeBlendZ
feColorMatrixZfeComponentTransferZfeCompositeZfeConvolveMatrixZfeDiffuseLightingZfeDisplacementMapZfeDistantLightZfeFloodZfeFuncAZfeFuncBZfeFuncGZfeFuncRZfeGaussianBlurZfeImageZfeMergeZfeMergeNodeZfeMorphologyZfeOffsetZfePointLightZfeSpecularLightingZfeSpotLightZfeTileZfeTurbulenceZ
foreignObjectZglyphRefZlinearGradientZradialGradientZtextPath)$ZaltglyphZaltglyphdefZaltglyphitemZanimatecolorZ
animatemotionZanimatetransformZclippathZfeblendZ
fecolormatrixZfecomponenttransferZfecompositeZfeconvolvematrixZfediffuselightingZfedisplacementmapZfedistantlightZfefloodZfefuncaZfefuncbZfefuncgZfefuncrZfegaussianblurZfeimageZfemergeZfemergenodeZfemorphologyZfeoffsetZfepointlightZfespecularlightingZfespotlightZfetileZfeturbulenceZ
foreignobjectZglyphrefZlineargradientZradialgradientZtextpathr@r))rCr��replacementsr)r)r*�adjustSVGTagNames|	sN�%z:getPhases.<locals>.InForeignContentPhase.adjustSVGTagNamescsL|ddkrd|d<n&|jjr<tdd�|dD��r<d|j_��||�dS)Nrwr�u�css|]}|tkVqdSr.r�r�r)r)r*r��	szMgetPhases.<locals>.InForeignContentPhase.processCharacters.<locals>.<genexpr>F)rLrcr�r�r�r�r)r*r��	s
�z:getPhases.<locals>.InForeignContentPhase.processCharacterscSs.|jjd}|d|jksD|ddkr�t|d���tdddg�@r�|j�dd|di�|jjdj|jjkr�|j�	|jjd�s�|j�
|jjd�s�|jj��qZ|S|jtd	kr�|j�
|�n$|jtd
kr�|�|�|j�|�|j�|�|j|d<|j�|�|d�r*|jj��d
|d<dS)Nrvr@r?rwZcolorZface�sizez*unexpected-html-element-in-foreign-contentrhryrjr{Tr|)r>r~�breakoutElements�set�keysrLrrjr�rorprrrr
rrr�)rCr�r�r)r)r*r��	s:
��
����


z8getPhases.<locals>.InForeignContentPhase.processStartTagcSs�t|jj�d}|jjd}|j�t�|dkrF|j�dd|di�|j�t�|dkr�|jj|jj	dkr�|jj�
�|jjj|j_|jj��|kr�|jjs�t
�q�d}q�|d8}|jj|}|j|jjkr�qFqF|jj�|�}q�qF|S)Nrrvr@rr�)r�r>r~r@rlrrLrr`rIr�r�rr�rjr�r�)rCr�Z	nodeIndexr�r�r)r)r*r��	s&z6getPhases.<locals>.InForeignContentPhase.processEndTagN)
r9r:r;r�rrKr
r�r�r�r)r�r)r*�InForeignContentPhaseo	s\�	)rcsPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)z!getPhases.<locals>.AfterBodyPhasecsN��|||�t�d|jfg�|_|j|j_t�d|jfg�|_|j	|j_dS�Nr�)
rKr
r�r�r�r�r�rxr�r�r�r�r)r*rK�	s�
z*getPhases.<locals>.AfterBodyPhase.__init__cSsdSr.r)rBr)r)r*r��	sz,getPhases.<locals>.AfterBodyPhase.processEOFcSs|j�||jjd�dS)Nrr�r�r)r)r*r��	sz0getPhases.<locals>.AfterBodyPhase.processCommentcSs |j�d�|jjd|j_|S)Nzunexpected-char-after-bodyr��rLrrIr`r�r)r)r*r��	sz3getPhases.<locals>.AfterBodyPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��	sz.getPhases.<locals>.AfterBodyPhase.startTagHtmlcSs*|j�dd|di�|jjd|j_|S)Nzunexpected-start-tag-after-bodyr@r�rr�r)r)r*r��	s

�z/getPhases.<locals>.AfterBodyPhase.startTagOthercSs*|jjr|j�d�n|jjd|j_dS)Nz'unexpected-end-tag-after-body-innerhtml�afterAfterBody)rLrSrrIr`)rCr@r)r)r*rx
sz,getPhases.<locals>.AfterBodyPhase.endTagHtmlcSs*|j�dd|di�|jjd|j_|S)Nzunexpected-end-tag-after-bodyr@r�rr�r)r)r*r�
s

�z-getPhases.<locals>.AfterBodyPhase.endTagOtherN)r9r:r;rKr�r�r�r�r�rxr�r)r�r)r*�AfterBodyPhase�	srcsXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z"getPhases.<locals>.InFramesetPhasecsf��|||�t�d|jfd|jfd|jfd|jfg�|_|j|j_	t�d|j
fg�|_|j|j_	dS)Nr�r�rXr�)
rKr
r�r�r�
startTagFrame�startTagNoframesr�r�r��endTagFramesetr�r�r�r�r)r*rK
s�
�z+getPhases.<locals>.InFramesetPhase.__init__cSs0|jjdjdkr |j�d�n|jjs,t�dS)Nrvr�zeof-in-framesetr�rBr)r)r*r�#
sz-getPhases.<locals>.InFramesetPhase.processEOFcSs|j�d�dS)Nzunexpected-char-in-framesetr�r�r)r)r*r�)
sz4getPhases.<locals>.InFramesetPhase.processCharacterscSs|j�|�dSr.)r>r�r�r)r)r*r,
sz3getPhases.<locals>.InFramesetPhase.startTagFramesetcSs|j�|�|jj��dSr.rr�r)r)r*r/
sz0getPhases.<locals>.InFramesetPhase.startTagFramecSs|jjd�|�Sr�r�r�r)r)r*r3
sz3getPhases.<locals>.InFramesetPhase.startTagNoframescSs|j�dd|di�dS)Nz unexpected-start-tag-in-framesetr@r�r�r)r)r*r�6
s
�z0getPhases.<locals>.InFramesetPhase.startTagOthercSsZ|jjdjdkr |j�d�n|jj��|jjsV|jjdjdkrV|jjd|j_dS)Nrvr�z)unexpected-frameset-in-frameset-innerhtmlr��
afterFrameset)	r>r~r@rLrrrSrIr`r�r)r)r*r:
s�z1getPhases.<locals>.InFramesetPhase.endTagFramesetcSs|j�dd|di�dS)Nzunexpected-end-tag-in-framesetr@r�r�r)r)r*r�F
s
�z.getPhases.<locals>.InFramesetPhase.endTagOtherN)r9r:r;rKr�r�rrrr�rr�r)r�r)r*�InFramesetPhase
srcsHeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dS)z%getPhases.<locals>.AfterFramesetPhasecsV��|||�t�d|jfd|jfg�|_|j|j_t�d|jfg�|_	|j
|j	_dS�Nr�r�)rKr
r�r�rr�r�r�rxr�r�r�r�r)r*rKL
s�
�z.getPhases.<locals>.AfterFramesetPhase.__init__cSsdSr.r)rBr)r)r*r�Z
sz0getPhases.<locals>.AfterFramesetPhase.processEOFcSs|j�d�dS)Nzunexpected-char-after-framesetr�r�r)r)r*r�^
sz7getPhases.<locals>.AfterFramesetPhase.processCharacterscSs|jjd�|�Srr�r�r)r)r*ra
sz6getPhases.<locals>.AfterFramesetPhase.startTagNoframescSs|j�dd|di�dS)Nz#unexpected-start-tag-after-framesetr@r�r�r)r)r*r�d
s
�z3getPhases.<locals>.AfterFramesetPhase.startTagOthercSs|jjd|j_dS)N�afterAfterFrameset)rLrIr`r�r)r)r*rxh
sz0getPhases.<locals>.AfterFramesetPhase.endTagHtmlcSs|j�dd|di�dS)Nz!unexpected-end-tag-after-framesetr@r�r�r)r)r*r�k
s
�z1getPhases.<locals>.AfterFramesetPhase.endTagOtherN)
r9r:r;rKr�r�rr�rxr�r)r�r)r*�AfterFramesetPhaseJ
srcsPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)z&getPhases.<locals>.AfterAfterBodyPhasecs0��|||�t�d|jfg�|_|j|j_dSr)rKr
r�r�r�r�r�r�r�r)r*rKp
s
�z/getPhases.<locals>.AfterAfterBodyPhase.__init__cSsdSr.r)rBr)r)r*r�x
sz1getPhases.<locals>.AfterAfterBodyPhase.processEOFcSs|j�||jj�dSr.r�r�r)r)r*r�{
sz5getPhases.<locals>.AfterAfterBodyPhase.processCommentcSs|jjd�|�Sr�rr�r)r)r*r�~
sz=getPhases.<locals>.AfterAfterBodyPhase.processSpaceCharacterscSs |j�d�|jjd|j_|S)N�expected-eof-but-got-charr�rr�r)r)r*r��
sz8getPhases.<locals>.AfterAfterBodyPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��
sz3getPhases.<locals>.AfterAfterBodyPhase.startTagHtmlcSs*|j�dd|di�|jjd|j_|S)N�expected-eof-but-got-start-tagr@r�rr�r)r)r*r��
s

�z4getPhases.<locals>.AfterAfterBodyPhase.startTagOthercSs*|j�dd|di�|jjd|j_|S)N�expected-eof-but-got-end-tagr@r�rr�r)r)r*r��
s

�z4getPhases.<locals>.AfterAfterBodyPhase.processEndTagN)r9r:r;rKr�r�r�r�r�r�r�r)r�r)r*�AfterAfterBodyPhaseo
srcsXeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)z*getPhases.<locals>.AfterAfterFramesetPhasecs8��|||�t�d|jfd|jfg�|_|j|j_dSr)rKr
r�r��startTagNoFramesr�r�r�r�r�r)r*rK�
s�z3getPhases.<locals>.AfterAfterFramesetPhase.__init__cSsdSr.r)rBr)r)r*r��
sz5getPhases.<locals>.AfterAfterFramesetPhase.processEOFcSs|j�||jj�dSr.r�r�r)r)r*r��
sz9getPhases.<locals>.AfterAfterFramesetPhase.processCommentcSs|jjd�|�Sr�rr�r)r)r*r��
szAgetPhases.<locals>.AfterAfterFramesetPhase.processSpaceCharacterscSs|j�d�dS)Nrr�r�r)r)r*r��
sz<getPhases.<locals>.AfterAfterFramesetPhase.processCharacterscSs|jjd�|�Sr�r�r�r)r)r*r��
sz7getPhases.<locals>.AfterAfterFramesetPhase.startTagHtmlcSs|jjd�|�Srr�r�r)r)r*r �
sz;getPhases.<locals>.AfterAfterFramesetPhase.startTagNoFramescSs|j�dd|di�dS)Nrr@r�r�r)r)r*r��
s
�z8getPhases.<locals>.AfterAfterFramesetPhase.startTagOthercSs|j�dd|di�dS)Nrr@r�r�r)r)r*r��
s
�z8getPhases.<locals>.AfterAfterFramesetPhase.processEndTagN)r9r:r;rKr�r�r�r�r�r r�r�r)r�r)r*�AfterAfterFramesetPhase�
s	r!)rWrVr�r�r
rr�r�r�r�r�r�r�r�r�r�r�rzr�r�rrr)r)rJrYr�r�r�r�rrrr�r�r�r�r�r�r�r�r�rrrrrrrr!r)r�r*rH�sr)#.g@CX!-GBbYLd's/9%&&�rHcs>t|d�t��@}|r:t�fdd�|d��D��|d<dS)Nrwc3s"|]\}}��||�|fVqdSr.)r�)r?�k�v�r	r)r*r��
s�z$adjust_attributes.<locals>.<genexpr>)rrr/)r�r	Zneeds_adjustmentr)r$r*r��
s

�r�rsFcCs|dkri}t||||d�S)N)r3r@rwr{)r)r@r3rkr{r)r)r*r��
s

�r�c@seZdZdZdS)ruzError in parsed documentN)r9r:r;r�r)r)r)r*ru�
sru)rT)r+rT)rsNF).Z
__future__rrrZpip._vendor.sixrrr1�collectionsrr�r	r
rZtreebuilders.baserr
Z	constantsrrrrrrrrrrrrr�rrrrr#r-r=rIr"ZmemoizerHr�r��	Exceptionrur)r)r)r*�<module>sPH

G
K�
site-packages/pip/_vendor/html5lib/__pycache__/serializer.cpython-38.pyc000064400000025044151446177000022253 0ustar00U

��.e�=�@szddlmZmZmZddlmZddlZddlmZm	Z	ddl
mZmZm
Z
ddl
mZmZmZddlmZmZdd	lmZd
�e
�dZe�ded
�Ze�ded�ZiZed�dkZee���D]n\Z Z!er�ee!�dks�es�ee!�dkr�q�e!dkr�ee!�dk�re�"e!�Z!ne#e!�Z!e!ek�s0e �$�r�e ee!<q�dd�Z%ede%�ddd�Z&Gdd�de'�Z(Gdd�de)�Z*dS)�)�absolute_import�division�unicode_literals)�	text_typeN)�register_error�xmlcharrefreplace_errors�)�voidElements�booleanAttributes�spaceCharacters)�rcdataElements�entities�xmlEntities)�treewalkers�_utils)�escape�z"'=<>`�[�]u_	

 /`  ᠎᠏           

   ]u􏿿��&c
	Cst|ttf��rg}g}d}t|j|j|j��D]n\}}|rDd}q2||j}t�|j|t	|j|dg���r�t�
|j||d��}d}nt|�}|�|�q2|D]V}t
�|�}	|	r�|�d�|�|	�|	�d�s�|�d�q�|�dt|�dd��q�d�|�|jfSt|�SdS)NFrTr�;z&#x%s;r)�
isinstance�UnicodeEncodeError�UnicodeTranslateError�	enumerate�object�start�endrZisSurrogatePair�min�surrogatePairToCodepoint�ord�append�_encode_entity_map�get�endswith�hex�joinr)
�exc�resZ
codepoints�skip�i�c�indexZ	codepointZcp�e�r/�C/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/serializer.py�htmlentityreplace_errors*s0
"



r1�htmlentityreplace�etreecKs$t�|�}tf|�}|�||�|�S)a�Serializes the input token stream using the specified treewalker

    :arg input: the token stream to serialize

    :arg tree: the treewalker to use

    :arg encoding: the encoding to use

    :arg serializer_opts: any options to pass to the
        :py:class:`html5lib.serializer.HTMLSerializer` that gets created

    :returns: the tree serialized as a string

    Example:

    >>> from html5lib.html5parser import parse
    >>> from html5lib.serializer import serialize
    >>> token_stream = parse('<html><body><p>Hi!</p></body></html>')
    >>> serialize(token_stream, omit_optional_tags=False)
    '<html><head></head><body><p>Hi!</p></body></html>'

    )rZ
getTreeWalker�HTMLSerializer�render)�inputZtree�encodingZserializer_optsZwalker�sr/r/r0�	serializeKs

r9c@s~eZdZdZdZdZdZdZdZdZ	dZ
dZdZdZ
dZdZdZdZdd�Zdd	�Zd
d�Zdd
d�Zddd�Zddd�ZdS)r4�legacy�"TF)�quote_attr_values�
quote_char�use_best_quote_char�omit_optional_tags�minimize_boolean_attributes�use_trailing_solidus�space_before_trailing_solidus�escape_lt_in_attrs�
escape_rcdata�resolve_entities�alphabetical_attributes�inject_meta_charset�strip_whitespace�sanitizec
Ksvt|�t|j�}t|�dkr2tdtt|����d|kr@d|_|jD]}t|||�|t	||���qFg|_
d|_dS)aB
Initialize HTMLSerializer

        :arg inject_meta_charset: Whether or not to inject the meta charset.

            Defaults to ``True``.

        :arg quote_attr_values: Whether to quote attribute values that don't
            require quoting per legacy browser behavior (``"legacy"``), when
            required by the standard (``"spec"``), or always (``"always"``).

            Defaults to ``"legacy"``.

        :arg quote_char: Use given quote character for attribute quoting.

            Defaults to ``"`` which will use double quotes unless attribute
            value contains a double quote, in which case single quotes are
            used.

        :arg escape_lt_in_attrs: Whether or not to escape ``<`` in attribute
            values.

            Defaults to ``False``.

        :arg escape_rcdata: Whether to escape characters that need to be
            escaped within normal elements within rcdata elements such as
            style.

            Defaults to ``False``.

        :arg resolve_entities: Whether to resolve named character entities that
            appear in the source tree. The XML predefined entities &lt; &gt;
            &amp; &quot; &apos; are unaffected by this setting.

            Defaults to ``True``.

        :arg strip_whitespace: Whether to remove semantically meaningless
            whitespace. (This compresses all whitespace to a single space
            except within ``pre``.)

            Defaults to ``False``.

        :arg minimize_boolean_attributes: Shortens boolean attributes to give
            just the attribute value, for example::

              <input disabled="disabled">

            becomes::

              <input disabled>

            Defaults to ``True``.

        :arg use_trailing_solidus: Includes a close-tag slash at the end of the
            start tag of void elements (empty elements whose end tag is
            forbidden). E.g. ``<hr/>``.

            Defaults to ``False``.

        :arg space_before_trailing_solidus: Places a space immediately before
            the closing slash in a tag using a trailing solidus. E.g.
            ``<hr />``. Requires ``use_trailing_solidus=True``.

            Defaults to ``True``.

        :arg sanitize: Strip all unsafe or unknown constructs from output.
            See :py:class:`html5lib.filters.sanitizer.Filter`.

            Defaults to ``False``.

        :arg omit_optional_tags: Omit start/end tags that are optional.

            Defaults to ``True``.

        :arg alphabetical_attributes: Reorder attributes to be in alphabetical order.

            Defaults to ``False``.

        rz2__init__() got an unexpected keyword argument '%s'r=FN)�	frozenset�options�len�	TypeError�next�iterr>�setattrr$�getattr�errors�strict)�self�kwargsZunexpected_args�attrr/r/r0�__init__�sO
zHTMLSerializer.__init__cCs*t|t�st�|jr"|�|jd�S|SdS)Nr2�rr�AssertionErrorr7�encode�rT�stringr/r/r0rZ�szHTMLSerializer.encodecCs*t|t�st�|jr"|�|jd�S|SdS)NrSrXr[r/r/r0�encodeStrict�szHTMLSerializer.encodeStrictNccs�||_d}g|_|r0|jr0ddlm}|||�}|jrJddlm}||�}|jrdddlm}||�}|j	r~ddl
m}||�}|jr�ddlm}||�}|D�]>}|d}|dk�r\d|d}|dr�|d	|d7}n|d
r�|d7}|d
�rF|d
�
d�d
k�r,|d
�
d�d
k�r&|�d�d}nd}|d||d
|f7}|d7}|�|�Vq�|dk�r�|dk�sv|�r�|�r�|d�
d�d
k�r�|�d�|�|d�Vn|�t|d��Vq�|dk�r�|d}	|�d|	�V|	tk�r�|j�s�d}n|�r|�d�|d��D�]�\\}
}}|}
|}|�d�V|�|
�V|j�rv|
t�|	t��k�r|
t�dt��k�r|�d�V|jdk�s�t|�d
k�r�d}n@|jdk�r�t�|�dk	}n$|jd k�r�t�|�dk	}ntd!��|�d"d#�}|j �r|�d$d%�}|�r�|j!}|j"�rHd|k�r0d|k�r0d}nd|k�rHd|k�rHd}|dk�r`|�dd&�}n|�dd'�}|�|�V|�|�V|�|�Vn|�|�V�q|	t#k�r�|j$�r�|j%�r�|�d(�Vn|�d)�V|�d�Vq�|d*k�r(|d}	|	tk�rd}n|�r|�d�|�d+|	�Vq�|d,k�rj|d}|�
d-�d
k�rT|�d.�|�d/|d�Vq�|d0k�r�|d}	|	d1}|t&k�r�|�d2|	�|j'�r�|t(k�r�t&|}nd3|	}|�|�Vq�|�|d�q�dS)4NFr)�Filter�typeZDoctypez<!DOCTYPE %s�nameZpublicIdz PUBLIC "%s"ZsystemIdz SYSTEMr;r�'zASystem identifer contains both single and double quote charactersz %s%s%s�>)Z
Characters�SpaceCharactersrc�dataz</zUnexpected </ in CDATA)ZStartTagZEmptyTagz<%sTz+Unexpected child element of a CDATA element� r�=�always�specr:z?quote_attr_values must be one of: 'always', 'spec', or 'legacy'rz&amp;�<z&lt;z&#39;z&quot;z /�/ZEndTagz</%s>�Commentz--zComment contains --z	<!--%s-->ZEntityrzEntity %s not recognizedz&%s;))r7rRrGZfilters.inject_meta_charsetr^rFZfilters.alphabeticalattributesrHZfilters.whitespacerIZfilters.sanitizerr?Zfilters.optionaltags�find�serializeErrorr]rZrrrD�itemsr@r
r$�tupler<rL�_quoteAttributeSpec�search�_quoteAttributeLegacy�
ValueError�replacerCr=r>r	rArBr
rEr)rT�
treewalkerr7Zin_cdatar^�tokenr_Zdoctyper=r`�_Z	attr_nameZ
attr_value�k�vZ
quote_attrrd�keyr/r/r0r9�s�









��








zHTMLSerializer.serializecCs2|rd�t|�||���Sd�t|�|���SdS)anSerializes the stream from the treewalker into a string

        :arg treewalker: the treewalker to serialize

        :arg encoding: the string encoding to use

        :returns: the serialized tree

        Example:

        >>> from html5lib import parse, getTreeWalker
        >>> from html5lib.serializer import HTMLSerializer
        >>> token_stream = parse('<html><body>Hi!</body></html>')
        >>> walker = getTreeWalker('etree')
        >>> serializer = HTMLSerializer(omit_optional_tags=False)
        >>> serializer.render(walker(token_stream))
        '<html><head></head><body>Hi!</body></html>'

        �rN)r'�listr9)rTrur7r/r/r0r5wszHTMLSerializer.render�XXX ERROR MESSAGE NEEDEDcCs|j�|�|jrt�dS)N)rRr"rS�SerializeError)rTrdr/r/r0rm�szHTMLSerializer.serializeError)N)N)r})�__name__�
__module__�__qualname__r<r=r>r?r@rArBrCrDrErFrGrHrIrKrWrZr]r9r5rmr/r/r/r0r4hs,Y


r4c@seZdZdZdS)r~zError in serialized treeN)rr�r��__doc__r/r/r/r0r~�sr~)r3N)+Z
__future__rrrZpip._vendor.sixr�re�codecsrrZ	constantsr	r
rrr
rrrrZxml.sax.saxutilsrr'Z_quoteAttributeSpecChars�compilerprrr#rLZ_is_ucs4r|rnrxryr r!�islowerr1r9rr4�	Exceptionr~r/r/r/r0�<module>sD
�
�
�


1site-packages/pip/_vendor/html5lib/__pycache__/_utils.cpython-38.pyc000064400000006356151446177000021406 0ustar00U

��.e��@s�ddlmZmZmZddlmZddlmZzddlm	m
ZWn&ek
rhddl
m	mZYnXddddd	d
gZz,ed�Zeee�s�ed�Zeee�s�t�Wnd
ZYnXdZGdd�de�Zdd�Zdd�Zdd	�Zdd�ZdS)�)�absolute_import�division�unicode_literals)�
ModuleType)�	text_typeN�
default_etree�MethodDispatcher�isSurrogatePair�surrogatePairToCodepoint�moduleFactoryFactory�supports_lone_surrogatesz"\uD800"z	u"\uD800"FTc@s"eZdZdZddd�Zdd�ZdS)	rapDict with 2 special properties:

    On initiation, keys that are lists, sets or tuples are converted to
    multiple keys so accessing any one of the items in the original
    list-like object returns the matching value

    md = MethodDispatcher({("foo", "bar"):"baz"})
    md["foo"] == "baz"

    A default value which can be set through the default attribute.
    �cCsvg}|D]B\}}t|ttttf�r<|D]}|�||f�q&q|�||f�qt�||�t|�t|�kslt	�d|_
dS�N)�
isinstance�list�tuple�	frozenset�set�append�dict�__init__�len�AssertionError�default)�self�itemsZ_dictEntries�name�value�itemr
r
�?/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_utils.pyr1szMethodDispatcher.__init__cCst�|||j�Sr)r�getr)r�keyr
r
r�__getitem__@szMethodDispatcher.__getitem__N)r
)�__name__�
__module__�__qualname__�__doc__rr"r
r
r
rr$s
cCsLt|�dkoJt|d�dkoJt|d�dkoJt|d�dkoJt|d�dkS)N�r��i�����i��)r�ord)�datar
r
rr	Gs����cCs,dt|d�ddt|d�d}|S)Nirr(ir)r*)r+)r,Zchar_valr
r
rr
Ms�csi���fdd�}|S)Ncs�ttjtd��rd|j}n
d|j}t|���}z�|||WStk
r�t|�}�|f|�|�}|j�|�d�kr�i�|<d�|kr�i�||<d�||kr�i�|||<|�|||<|YSXdS)N�z_%s_factorys_%s_factoryr�args�kwargs)	rrr#�typerr�KeyError�__dict__�update)Z
baseModuler.r/rZkwargs_tuple�modZobjs��factoryZmoduleCacher
r�
moduleFactoryYs$
z+moduleFactoryFactory.<locals>.moduleFactoryr
)r6r7r
r5rrVscsi���fdd�}|S)Ncs2t|�t|���f}|�kr*�||��|<�|Sr)rr)r.r/r!��cache�funcr
r�wrappedvszmemoize.<locals>.wrappedr
)r:r;r
r8r�memoizessr<)Z
__future__rrr�typesrZpip._vendor.sixrZxml.etree.cElementTreeZetreeZcElementTreer�ImportErrorZxml.etree.ElementTreeZElementTree�__all__�evalZ_xrrrrrr	r
rr<r
r
r
r�<module>s0�

#	site-packages/pip/_vendor/html5lib/__pycache__/_utils.cpython-38.opt-1.pyc000064400000006260151446177000022337 0ustar00U

��.e��@s�ddlmZmZmZddlmZddlmZzddlm	m
ZWn&ek
rhddl
m	mZYnXddddd	d
gZzed�Zeee�s�ed�ZWnd
ZYnXdZGdd�de�Zdd�Zdd�Zdd	�Zdd�ZdS)�)�absolute_import�division�unicode_literals)�
ModuleType)�	text_typeN�
default_etree�MethodDispatcher�isSurrogatePair�surrogatePairToCodepoint�moduleFactoryFactory�supports_lone_surrogatesz"\uD800"z	u"\uD800"FTc@s"eZdZdZddd�Zdd�ZdS)	rapDict with 2 special properties:

    On initiation, keys that are lists, sets or tuples are converted to
    multiple keys so accessing any one of the items in the original
    list-like object returns the matching value

    md = MethodDispatcher({("foo", "bar"):"baz"})
    md["foo"] == "baz"

    A default value which can be set through the default attribute.
    �cCsbg}|D]B\}}t|ttttf�r<|D]}|�||f�q&q|�||f�qt�||�d|_dS�N)	�
isinstance�list�tuple�	frozenset�set�append�dict�__init__�default)�self�itemsZ_dictEntries�name�value�itemr
r
�?/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/_utils.pyr1szMethodDispatcher.__init__cCst�|||j�Sr)r�getr)r�keyr
r
r�__getitem__@szMethodDispatcher.__getitem__N)r
)�__name__�
__module__�__qualname__�__doc__rr r
r
r
rr$s
cCsLt|�dkoJt|d�dkoJt|d�dkoJt|d�dkoJt|d�dkS)N�r��i�����i��)�len�ord)�datar
r
rr	Gs����cCs,dt|d�ddt|d�d}|S)Nirr&ir'r()r*)r+Zchar_valr
r
rr
Ms�csi���fdd�}|S)Ncs�ttjtd��rd|j}n
d|j}t|���}z�|||WStk
r�t|�}�|f|�|�}|j�|�d�kr�i�|<d�|kr�i�||<d�||kr�i�|||<|�|||<|YSXdS)N�z_%s_factorys_%s_factoryr�args�kwargs)	rrr!�typerr�KeyError�__dict__�update)Z
baseModuler-r.rZkwargs_tuple�modZobjs��factoryZmoduleCacher
r�
moduleFactoryYs$
z+moduleFactoryFactory.<locals>.moduleFactoryr
)r5r6r
r4rrVscsi���fdd�}|S)Ncs2t|�t|���f}|�kr*�||��|<�|Sr)rr)r-r.r��cache�funcr
r�wrappedvszmemoize.<locals>.wrappedr
)r9r:r
r7r�memoizessr;)Z
__future__rrr�typesrZpip._vendor.sixrZxml.etree.cElementTreeZetreeZcElementTreer�ImportErrorZxml.etree.ElementTreeZElementTree�__all__�evalZ_xrrrrr	r
rr;r
r
r
r�<module>s0�

#	site-packages/pip/_vendor/html5lib/__pycache__/__init__.cpython-38.pyc000064400000002400151446177000021630 0ustar00U

��.e��@shdZddlmZmZmZddlmZmZmZddl	m
Z
ddlmZddl
mZdd	d
ddd
gZdZdS)a�
HTML parsing library based on the `WHATWG HTML specification
<https://whatwg.org/html>`_. The parser is designed to be compatible with
existing HTML found in the wild and implements well-defined error recovery that
is largely compatible with modern desktop web browsers.

Example usage::

    from pip._vendor import html5lib
    with open("my_document.html", "rb") as f:
        tree = html5lib.parse(f)

For convenience, this module re-exports the following names:

* :func:`~.html5parser.parse`
* :func:`~.html5parser.parseFragment`
* :class:`~.html5parser.HTMLParser`
* :func:`~.treebuilders.getTreeBuilder`
* :func:`~.treewalkers.getTreeWalker`
* :func:`~.serializer.serialize`
�)�absolute_import�division�unicode_literals�)�
HTMLParser�parse�
parseFragment)�getTreeBuilder)�
getTreeWalker)�	serializerrrr	r
rz1.0.1N)�__doc__Z
__future__rrrZhtml5parserrrrZtreebuildersr	Ztreewalkersr
Z
serializerr�__all__�__version__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/__init__.py�<module>s�site-packages/pip/_vendor/html5lib/_ihatexml.py000064400000040501151446177000015561 0ustar00from __future__ import absolute_import, division, unicode_literals

import re
import warnings

from .constants import DataLossWarning

baseChar = """
[#x0041-#x005A] | [#x0061-#x007A] | [#x00C0-#x00D6] | [#x00D8-#x00F6] |
[#x00F8-#x00FF] | [#x0100-#x0131] | [#x0134-#x013E] | [#x0141-#x0148] |
[#x014A-#x017E] | [#x0180-#x01C3] | [#x01CD-#x01F0] | [#x01F4-#x01F5] |
[#x01FA-#x0217] | [#x0250-#x02A8] | [#x02BB-#x02C1] | #x0386 |
[#x0388-#x038A] | #x038C | [#x038E-#x03A1] | [#x03A3-#x03CE] |
[#x03D0-#x03D6] | #x03DA | #x03DC | #x03DE | #x03E0 | [#x03E2-#x03F3] |
[#x0401-#x040C] | [#x040E-#x044F] | [#x0451-#x045C] | [#x045E-#x0481] |
[#x0490-#x04C4] | [#x04C7-#x04C8] | [#x04CB-#x04CC] | [#x04D0-#x04EB] |
[#x04EE-#x04F5] | [#x04F8-#x04F9] | [#x0531-#x0556] | #x0559 |
[#x0561-#x0586] | [#x05D0-#x05EA] | [#x05F0-#x05F2] | [#x0621-#x063A] |
[#x0641-#x064A] | [#x0671-#x06B7] | [#x06BA-#x06BE] | [#x06C0-#x06CE] |
[#x06D0-#x06D3] | #x06D5 | [#x06E5-#x06E6] | [#x0905-#x0939] | #x093D |
[#x0958-#x0961] | [#x0985-#x098C] | [#x098F-#x0990] | [#x0993-#x09A8] |
[#x09AA-#x09B0] | #x09B2 | [#x09B6-#x09B9] | [#x09DC-#x09DD] |
[#x09DF-#x09E1] | [#x09F0-#x09F1] | [#x0A05-#x0A0A] | [#x0A0F-#x0A10] |
[#x0A13-#x0A28] | [#x0A2A-#x0A30] | [#x0A32-#x0A33] | [#x0A35-#x0A36] |
[#x0A38-#x0A39] | [#x0A59-#x0A5C] | #x0A5E | [#x0A72-#x0A74] |
[#x0A85-#x0A8B] | #x0A8D | [#x0A8F-#x0A91] | [#x0A93-#x0AA8] |
[#x0AAA-#x0AB0] | [#x0AB2-#x0AB3] | [#x0AB5-#x0AB9] | #x0ABD | #x0AE0 |
[#x0B05-#x0B0C] | [#x0B0F-#x0B10] | [#x0B13-#x0B28] | [#x0B2A-#x0B30] |
[#x0B32-#x0B33] | [#x0B36-#x0B39] | #x0B3D | [#x0B5C-#x0B5D] |
[#x0B5F-#x0B61] | [#x0B85-#x0B8A] | [#x0B8E-#x0B90] | [#x0B92-#x0B95] |
[#x0B99-#x0B9A] | #x0B9C | [#x0B9E-#x0B9F] | [#x0BA3-#x0BA4] |
[#x0BA8-#x0BAA] | [#x0BAE-#x0BB5] | [#x0BB7-#x0BB9] | [#x0C05-#x0C0C] |
[#x0C0E-#x0C10] | [#x0C12-#x0C28] | [#x0C2A-#x0C33] | [#x0C35-#x0C39] |
[#x0C60-#x0C61] | [#x0C85-#x0C8C] | [#x0C8E-#x0C90] | [#x0C92-#x0CA8] |
[#x0CAA-#x0CB3] | [#x0CB5-#x0CB9] | #x0CDE | [#x0CE0-#x0CE1] |
[#x0D05-#x0D0C] | [#x0D0E-#x0D10] | [#x0D12-#x0D28] | [#x0D2A-#x0D39] |
[#x0D60-#x0D61] | [#x0E01-#x0E2E] | #x0E30 | [#x0E32-#x0E33] |
[#x0E40-#x0E45] | [#x0E81-#x0E82] | #x0E84 | [#x0E87-#x0E88] | #x0E8A |
#x0E8D | [#x0E94-#x0E97] | [#x0E99-#x0E9F] | [#x0EA1-#x0EA3] | #x0EA5 |
#x0EA7 | [#x0EAA-#x0EAB] | [#x0EAD-#x0EAE] | #x0EB0 | [#x0EB2-#x0EB3] |
#x0EBD | [#x0EC0-#x0EC4] | [#x0F40-#x0F47] | [#x0F49-#x0F69] |
[#x10A0-#x10C5] | [#x10D0-#x10F6] | #x1100 | [#x1102-#x1103] |
[#x1105-#x1107] | #x1109 | [#x110B-#x110C] | [#x110E-#x1112] | #x113C |
#x113E | #x1140 | #x114C | #x114E | #x1150 | [#x1154-#x1155] | #x1159 |
[#x115F-#x1161] | #x1163 | #x1165 | #x1167 | #x1169 | [#x116D-#x116E] |
[#x1172-#x1173] | #x1175 | #x119E | #x11A8 | #x11AB | [#x11AE-#x11AF] |
[#x11B7-#x11B8] | #x11BA | [#x11BC-#x11C2] | #x11EB | #x11F0 | #x11F9 |
[#x1E00-#x1E9B] | [#x1EA0-#x1EF9] | [#x1F00-#x1F15] | [#x1F18-#x1F1D] |
[#x1F20-#x1F45] | [#x1F48-#x1F4D] | [#x1F50-#x1F57] | #x1F59 | #x1F5B |
#x1F5D | [#x1F5F-#x1F7D] | [#x1F80-#x1FB4] | [#x1FB6-#x1FBC] | #x1FBE |
[#x1FC2-#x1FC4] | [#x1FC6-#x1FCC] | [#x1FD0-#x1FD3] | [#x1FD6-#x1FDB] |
[#x1FE0-#x1FEC] | [#x1FF2-#x1FF4] | [#x1FF6-#x1FFC] | #x2126 |
[#x212A-#x212B] | #x212E | [#x2180-#x2182] | [#x3041-#x3094] |
[#x30A1-#x30FA] | [#x3105-#x312C] | [#xAC00-#xD7A3]"""

ideographic = """[#x4E00-#x9FA5] | #x3007 | [#x3021-#x3029]"""

combiningCharacter = """
[#x0300-#x0345] | [#x0360-#x0361] | [#x0483-#x0486] | [#x0591-#x05A1] |
[#x05A3-#x05B9] | [#x05BB-#x05BD] | #x05BF | [#x05C1-#x05C2] | #x05C4 |
[#x064B-#x0652] | #x0670 | [#x06D6-#x06DC] | [#x06DD-#x06DF] |
[#x06E0-#x06E4] | [#x06E7-#x06E8] | [#x06EA-#x06ED] | [#x0901-#x0903] |
#x093C | [#x093E-#x094C] | #x094D | [#x0951-#x0954] | [#x0962-#x0963] |
[#x0981-#x0983] | #x09BC | #x09BE | #x09BF | [#x09C0-#x09C4] |
[#x09C7-#x09C8] | [#x09CB-#x09CD] | #x09D7 | [#x09E2-#x09E3] | #x0A02 |
#x0A3C | #x0A3E | #x0A3F | [#x0A40-#x0A42] | [#x0A47-#x0A48] |
[#x0A4B-#x0A4D] | [#x0A70-#x0A71] | [#x0A81-#x0A83] | #x0ABC |
[#x0ABE-#x0AC5] | [#x0AC7-#x0AC9] | [#x0ACB-#x0ACD] | [#x0B01-#x0B03] |
#x0B3C | [#x0B3E-#x0B43] | [#x0B47-#x0B48] | [#x0B4B-#x0B4D] |
[#x0B56-#x0B57] | [#x0B82-#x0B83] | [#x0BBE-#x0BC2] | [#x0BC6-#x0BC8] |
[#x0BCA-#x0BCD] | #x0BD7 | [#x0C01-#x0C03] | [#x0C3E-#x0C44] |
[#x0C46-#x0C48] | [#x0C4A-#x0C4D] | [#x0C55-#x0C56] | [#x0C82-#x0C83] |
[#x0CBE-#x0CC4] | [#x0CC6-#x0CC8] | [#x0CCA-#x0CCD] | [#x0CD5-#x0CD6] |
[#x0D02-#x0D03] | [#x0D3E-#x0D43] | [#x0D46-#x0D48] | [#x0D4A-#x0D4D] |
#x0D57 | #x0E31 | [#x0E34-#x0E3A] | [#x0E47-#x0E4E] | #x0EB1 |
[#x0EB4-#x0EB9] | [#x0EBB-#x0EBC] | [#x0EC8-#x0ECD] | [#x0F18-#x0F19] |
#x0F35 | #x0F37 | #x0F39 | #x0F3E | #x0F3F | [#x0F71-#x0F84] |
[#x0F86-#x0F8B] | [#x0F90-#x0F95] | #x0F97 | [#x0F99-#x0FAD] |
[#x0FB1-#x0FB7] | #x0FB9 | [#x20D0-#x20DC] | #x20E1 | [#x302A-#x302F] |
#x3099 | #x309A"""

digit = """
[#x0030-#x0039] | [#x0660-#x0669] | [#x06F0-#x06F9] | [#x0966-#x096F] |
[#x09E6-#x09EF] | [#x0A66-#x0A6F] | [#x0AE6-#x0AEF] | [#x0B66-#x0B6F] |
[#x0BE7-#x0BEF] | [#x0C66-#x0C6F] | [#x0CE6-#x0CEF] | [#x0D66-#x0D6F] |
[#x0E50-#x0E59] | [#x0ED0-#x0ED9] | [#x0F20-#x0F29]"""

extender = """
#x00B7 | #x02D0 | #x02D1 | #x0387 | #x0640 | #x0E46 | #x0EC6 | #x3005 |
#[#x3031-#x3035] | [#x309D-#x309E] | [#x30FC-#x30FE]"""

letter = " | ".join([baseChar, ideographic])

# Without the
name = " | ".join([letter, digit, ".", "-", "_", combiningCharacter,
                   extender])
nameFirst = " | ".join([letter, "_"])

reChar = re.compile(r"#x([\d|A-F]{4,4})")
reCharRange = re.compile(r"\[#x([\d|A-F]{4,4})-#x([\d|A-F]{4,4})\]")


def charStringToList(chars):
    charRanges = [item.strip() for item in chars.split(" | ")]
    rv = []
    for item in charRanges:
        foundMatch = False
        for regexp in (reChar, reCharRange):
            match = regexp.match(item)
            if match is not None:
                rv.append([hexToInt(item) for item in match.groups()])
                if len(rv[-1]) == 1:
                    rv[-1] = rv[-1] * 2
                foundMatch = True
                break
        if not foundMatch:
            assert len(item) == 1

            rv.append([ord(item)] * 2)
    rv = normaliseCharList(rv)
    return rv


def normaliseCharList(charList):
    charList = sorted(charList)
    for item in charList:
        assert item[1] >= item[0]
    rv = []
    i = 0
    while i < len(charList):
        j = 1
        rv.append(charList[i])
        while i + j < len(charList) and charList[i + j][0] <= rv[-1][1] + 1:
            rv[-1][1] = charList[i + j][1]
            j += 1
        i += j
    return rv

# We don't really support characters above the BMP :(
max_unicode = int("FFFF", 16)


def missingRanges(charList):
    rv = []
    if charList[0] != 0:
        rv.append([0, charList[0][0] - 1])
    for i, item in enumerate(charList[:-1]):
        rv.append([item[1] + 1, charList[i + 1][0] - 1])
    if charList[-1][1] != max_unicode:
        rv.append([charList[-1][1] + 1, max_unicode])
    return rv


def listToRegexpStr(charList):
    rv = []
    for item in charList:
        if item[0] == item[1]:
            rv.append(escapeRegexp(chr(item[0])))
        else:
            rv.append(escapeRegexp(chr(item[0])) + "-" +
                      escapeRegexp(chr(item[1])))
    return "[%s]" % "".join(rv)


def hexToInt(hex_str):
    return int(hex_str, 16)


def escapeRegexp(string):
    specialCharacters = (".", "^", "$", "*", "+", "?", "{", "}",
                         "[", "]", "|", "(", ")", "-")
    for char in specialCharacters:
        string = string.replace(char, "\\" + char)

    return string

# output from the above
nonXmlNameBMPRegexp = re.compile('[\x00-,/:-@\\[-\\^`\\{-\xb6\xb8-\xbf\xd7\xf7\u0132-\u0133\u013f-\u0140\u0149\u017f\u01c4-\u01cc\u01f1-\u01f3\u01f6-\u01f9\u0218-\u024f\u02a9-\u02ba\u02c2-\u02cf\u02d2-\u02ff\u0346-\u035f\u0362-\u0385\u038b\u038d\u03a2\u03cf\u03d7-\u03d9\u03db\u03dd\u03df\u03e1\u03f4-\u0400\u040d\u0450\u045d\u0482\u0487-\u048f\u04c5-\u04c6\u04c9-\u04ca\u04cd-\u04cf\u04ec-\u04ed\u04f6-\u04f7\u04fa-\u0530\u0557-\u0558\u055a-\u0560\u0587-\u0590\u05a2\u05ba\u05be\u05c0\u05c3\u05c5-\u05cf\u05eb-\u05ef\u05f3-\u0620\u063b-\u063f\u0653-\u065f\u066a-\u066f\u06b8-\u06b9\u06bf\u06cf\u06d4\u06e9\u06ee-\u06ef\u06fa-\u0900\u0904\u093a-\u093b\u094e-\u0950\u0955-\u0957\u0964-\u0965\u0970-\u0980\u0984\u098d-\u098e\u0991-\u0992\u09a9\u09b1\u09b3-\u09b5\u09ba-\u09bb\u09bd\u09c5-\u09c6\u09c9-\u09ca\u09ce-\u09d6\u09d8-\u09db\u09de\u09e4-\u09e5\u09f2-\u0a01\u0a03-\u0a04\u0a0b-\u0a0e\u0a11-\u0a12\u0a29\u0a31\u0a34\u0a37\u0a3a-\u0a3b\u0a3d\u0a43-\u0a46\u0a49-\u0a4a\u0a4e-\u0a58\u0a5d\u0a5f-\u0a65\u0a75-\u0a80\u0a84\u0a8c\u0a8e\u0a92\u0aa9\u0ab1\u0ab4\u0aba-\u0abb\u0ac6\u0aca\u0ace-\u0adf\u0ae1-\u0ae5\u0af0-\u0b00\u0b04\u0b0d-\u0b0e\u0b11-\u0b12\u0b29\u0b31\u0b34-\u0b35\u0b3a-\u0b3b\u0b44-\u0b46\u0b49-\u0b4a\u0b4e-\u0b55\u0b58-\u0b5b\u0b5e\u0b62-\u0b65\u0b70-\u0b81\u0b84\u0b8b-\u0b8d\u0b91\u0b96-\u0b98\u0b9b\u0b9d\u0ba0-\u0ba2\u0ba5-\u0ba7\u0bab-\u0bad\u0bb6\u0bba-\u0bbd\u0bc3-\u0bc5\u0bc9\u0bce-\u0bd6\u0bd8-\u0be6\u0bf0-\u0c00\u0c04\u0c0d\u0c11\u0c29\u0c34\u0c3a-\u0c3d\u0c45\u0c49\u0c4e-\u0c54\u0c57-\u0c5f\u0c62-\u0c65\u0c70-\u0c81\u0c84\u0c8d\u0c91\u0ca9\u0cb4\u0cba-\u0cbd\u0cc5\u0cc9\u0cce-\u0cd4\u0cd7-\u0cdd\u0cdf\u0ce2-\u0ce5\u0cf0-\u0d01\u0d04\u0d0d\u0d11\u0d29\u0d3a-\u0d3d\u0d44-\u0d45\u0d49\u0d4e-\u0d56\u0d58-\u0d5f\u0d62-\u0d65\u0d70-\u0e00\u0e2f\u0e3b-\u0e3f\u0e4f\u0e5a-\u0e80\u0e83\u0e85-\u0e86\u0e89\u0e8b-\u0e8c\u0e8e-\u0e93\u0e98\u0ea0\u0ea4\u0ea6\u0ea8-\u0ea9\u0eac\u0eaf\u0eba\u0ebe-\u0ebf\u0ec5\u0ec7\u0ece-\u0ecf\u0eda-\u0f17\u0f1a-\u0f1f\u0f2a-\u0f34\u0f36\u0f38\u0f3a-\u0f3d\u0f48\u0f6a-\u0f70\u0f85\u0f8c-\u0f8f\u0f96\u0f98\u0fae-\u0fb0\u0fb8\u0fba-\u109f\u10c6-\u10cf\u10f7-\u10ff\u1101\u1104\u1108\u110a\u110d\u1113-\u113b\u113d\u113f\u1141-\u114b\u114d\u114f\u1151-\u1153\u1156-\u1158\u115a-\u115e\u1162\u1164\u1166\u1168\u116a-\u116c\u116f-\u1171\u1174\u1176-\u119d\u119f-\u11a7\u11a9-\u11aa\u11ac-\u11ad\u11b0-\u11b6\u11b9\u11bb\u11c3-\u11ea\u11ec-\u11ef\u11f1-\u11f8\u11fa-\u1dff\u1e9c-\u1e9f\u1efa-\u1eff\u1f16-\u1f17\u1f1e-\u1f1f\u1f46-\u1f47\u1f4e-\u1f4f\u1f58\u1f5a\u1f5c\u1f5e\u1f7e-\u1f7f\u1fb5\u1fbd\u1fbf-\u1fc1\u1fc5\u1fcd-\u1fcf\u1fd4-\u1fd5\u1fdc-\u1fdf\u1fed-\u1ff1\u1ff5\u1ffd-\u20cf\u20dd-\u20e0\u20e2-\u2125\u2127-\u2129\u212c-\u212d\u212f-\u217f\u2183-\u3004\u3006\u3008-\u3020\u3030\u3036-\u3040\u3095-\u3098\u309b-\u309c\u309f-\u30a0\u30fb\u30ff-\u3104\u312d-\u4dff\u9fa6-\uabff\ud7a4-\uffff]')  # noqa

nonXmlNameFirstBMPRegexp = re.compile('[\x00-@\\[-\\^`\\{-\xbf\xd7\xf7\u0132-\u0133\u013f-\u0140\u0149\u017f\u01c4-\u01cc\u01f1-\u01f3\u01f6-\u01f9\u0218-\u024f\u02a9-\u02ba\u02c2-\u0385\u0387\u038b\u038d\u03a2\u03cf\u03d7-\u03d9\u03db\u03dd\u03df\u03e1\u03f4-\u0400\u040d\u0450\u045d\u0482-\u048f\u04c5-\u04c6\u04c9-\u04ca\u04cd-\u04cf\u04ec-\u04ed\u04f6-\u04f7\u04fa-\u0530\u0557-\u0558\u055a-\u0560\u0587-\u05cf\u05eb-\u05ef\u05f3-\u0620\u063b-\u0640\u064b-\u0670\u06b8-\u06b9\u06bf\u06cf\u06d4\u06d6-\u06e4\u06e7-\u0904\u093a-\u093c\u093e-\u0957\u0962-\u0984\u098d-\u098e\u0991-\u0992\u09a9\u09b1\u09b3-\u09b5\u09ba-\u09db\u09de\u09e2-\u09ef\u09f2-\u0a04\u0a0b-\u0a0e\u0a11-\u0a12\u0a29\u0a31\u0a34\u0a37\u0a3a-\u0a58\u0a5d\u0a5f-\u0a71\u0a75-\u0a84\u0a8c\u0a8e\u0a92\u0aa9\u0ab1\u0ab4\u0aba-\u0abc\u0abe-\u0adf\u0ae1-\u0b04\u0b0d-\u0b0e\u0b11-\u0b12\u0b29\u0b31\u0b34-\u0b35\u0b3a-\u0b3c\u0b3e-\u0b5b\u0b5e\u0b62-\u0b84\u0b8b-\u0b8d\u0b91\u0b96-\u0b98\u0b9b\u0b9d\u0ba0-\u0ba2\u0ba5-\u0ba7\u0bab-\u0bad\u0bb6\u0bba-\u0c04\u0c0d\u0c11\u0c29\u0c34\u0c3a-\u0c5f\u0c62-\u0c84\u0c8d\u0c91\u0ca9\u0cb4\u0cba-\u0cdd\u0cdf\u0ce2-\u0d04\u0d0d\u0d11\u0d29\u0d3a-\u0d5f\u0d62-\u0e00\u0e2f\u0e31\u0e34-\u0e3f\u0e46-\u0e80\u0e83\u0e85-\u0e86\u0e89\u0e8b-\u0e8c\u0e8e-\u0e93\u0e98\u0ea0\u0ea4\u0ea6\u0ea8-\u0ea9\u0eac\u0eaf\u0eb1\u0eb4-\u0ebc\u0ebe-\u0ebf\u0ec5-\u0f3f\u0f48\u0f6a-\u109f\u10c6-\u10cf\u10f7-\u10ff\u1101\u1104\u1108\u110a\u110d\u1113-\u113b\u113d\u113f\u1141-\u114b\u114d\u114f\u1151-\u1153\u1156-\u1158\u115a-\u115e\u1162\u1164\u1166\u1168\u116a-\u116c\u116f-\u1171\u1174\u1176-\u119d\u119f-\u11a7\u11a9-\u11aa\u11ac-\u11ad\u11b0-\u11b6\u11b9\u11bb\u11c3-\u11ea\u11ec-\u11ef\u11f1-\u11f8\u11fa-\u1dff\u1e9c-\u1e9f\u1efa-\u1eff\u1f16-\u1f17\u1f1e-\u1f1f\u1f46-\u1f47\u1f4e-\u1f4f\u1f58\u1f5a\u1f5c\u1f5e\u1f7e-\u1f7f\u1fb5\u1fbd\u1fbf-\u1fc1\u1fc5\u1fcd-\u1fcf\u1fd4-\u1fd5\u1fdc-\u1fdf\u1fed-\u1ff1\u1ff5\u1ffd-\u2125\u2127-\u2129\u212c-\u212d\u212f-\u217f\u2183-\u3006\u3008-\u3020\u302a-\u3040\u3095-\u30a0\u30fb-\u3104\u312d-\u4dff\u9fa6-\uabff\ud7a4-\uffff]')  # noqa

# Simpler things
nonPubidCharRegexp = re.compile("[^\x20\x0D\x0Aa-zA-Z0-9\\-'()+,./:=?;!*#@$_%]")


class InfosetFilter(object):
    replacementRegexp = re.compile(r"U[\dA-F]{5,5}")

    def __init__(self,
                 dropXmlnsLocalName=False,
                 dropXmlnsAttrNs=False,
                 preventDoubleDashComments=False,
                 preventDashAtCommentEnd=False,
                 replaceFormFeedCharacters=True,
                 preventSingleQuotePubid=False):

        self.dropXmlnsLocalName = dropXmlnsLocalName
        self.dropXmlnsAttrNs = dropXmlnsAttrNs

        self.preventDoubleDashComments = preventDoubleDashComments
        self.preventDashAtCommentEnd = preventDashAtCommentEnd

        self.replaceFormFeedCharacters = replaceFormFeedCharacters

        self.preventSingleQuotePubid = preventSingleQuotePubid

        self.replaceCache = {}

    def coerceAttribute(self, name, namespace=None):
        if self.dropXmlnsLocalName and name.startswith("xmlns:"):
            warnings.warn("Attributes cannot begin with xmlns", DataLossWarning)
            return None
        elif (self.dropXmlnsAttrNs and
              namespace == "http://www.w3.org/2000/xmlns/"):
            warnings.warn("Attributes cannot be in the xml namespace", DataLossWarning)
            return None
        else:
            return self.toXmlName(name)

    def coerceElement(self, name):
        return self.toXmlName(name)

    def coerceComment(self, data):
        if self.preventDoubleDashComments:
            while "--" in data:
                warnings.warn("Comments cannot contain adjacent dashes", DataLossWarning)
                data = data.replace("--", "- -")
            if data.endswith("-"):
                warnings.warn("Comments cannot end in a dash", DataLossWarning)
                data += " "
        return data

    def coerceCharacters(self, data):
        if self.replaceFormFeedCharacters:
            for _ in range(data.count("\x0C")):
                warnings.warn("Text cannot contain U+000C", DataLossWarning)
            data = data.replace("\x0C", " ")
        # Other non-xml characters
        return data

    def coercePubid(self, data):
        dataOutput = data
        for char in nonPubidCharRegexp.findall(data):
            warnings.warn("Coercing non-XML pubid", DataLossWarning)
            replacement = self.getReplacementCharacter(char)
            dataOutput = dataOutput.replace(char, replacement)
        if self.preventSingleQuotePubid and dataOutput.find("'") >= 0:
            warnings.warn("Pubid cannot contain single quote", DataLossWarning)
            dataOutput = dataOutput.replace("'", self.getReplacementCharacter("'"))
        return dataOutput

    def toXmlName(self, name):
        nameFirst = name[0]
        nameRest = name[1:]
        m = nonXmlNameFirstBMPRegexp.match(nameFirst)
        if m:
            warnings.warn("Coercing non-XML name", DataLossWarning)
            nameFirstOutput = self.getReplacementCharacter(nameFirst)
        else:
            nameFirstOutput = nameFirst

        nameRestOutput = nameRest
        replaceChars = set(nonXmlNameBMPRegexp.findall(nameRest))
        for char in replaceChars:
            warnings.warn("Coercing non-XML name", DataLossWarning)
            replacement = self.getReplacementCharacter(char)
            nameRestOutput = nameRestOutput.replace(char, replacement)
        return nameFirstOutput + nameRestOutput

    def getReplacementCharacter(self, char):
        if char in self.replaceCache:
            replacement = self.replaceCache[char]
        else:
            replacement = self.escapeChar(char)
        return replacement

    def fromXmlName(self, name):
        for item in set(self.replacementRegexp.findall(name)):
            name = name.replace(item, self.unescapeChar(item))
        return name

    def escapeChar(self, char):
        replacement = "U%05X" % ord(char)
        self.replaceCache[char] = replacement
        return replacement

    def unescapeChar(self, charcode):
        return chr(int(charcode[1:], 16))
site-packages/pip/_vendor/html5lib/__init__.py000064400000002212151446177000015343 0ustar00"""
HTML parsing library based on the `WHATWG HTML specification
<https://whatwg.org/html>`_. The parser is designed to be compatible with
existing HTML found in the wild and implements well-defined error recovery that
is largely compatible with modern desktop web browsers.

Example usage::

    from pip._vendor import html5lib
    with open("my_document.html", "rb") as f:
        tree = html5lib.parse(f)

For convenience, this module re-exports the following names:

* :func:`~.html5parser.parse`
* :func:`~.html5parser.parseFragment`
* :class:`~.html5parser.HTMLParser`
* :func:`~.treebuilders.getTreeBuilder`
* :func:`~.treewalkers.getTreeWalker`
* :func:`~.serializer.serialize`
"""

from __future__ import absolute_import, division, unicode_literals

from .html5parser import HTMLParser, parse, parseFragment
from .treebuilders import getTreeBuilder
from .treewalkers import getTreeWalker
from .serializer import serialize

__all__ = ["HTMLParser", "parse", "parseFragment", "getTreeBuilder",
           "getTreeWalker", "serialize"]

# this has to be at the top level, see how setup.py parses this
#: Distribution version number.
__version__ = "1.0.1"
site-packages/pip/_vendor/html5lib/_utils.py000064400000007657151446177000015125 0ustar00from __future__ import absolute_import, division, unicode_literals

from types import ModuleType

from pip._vendor.six import text_type

try:
    import xml.etree.cElementTree as default_etree
except ImportError:
    import xml.etree.ElementTree as default_etree


__all__ = ["default_etree", "MethodDispatcher", "isSurrogatePair",
           "surrogatePairToCodepoint", "moduleFactoryFactory",
           "supports_lone_surrogates"]


# Platforms not supporting lone surrogates (\uD800-\uDFFF) should be
# caught by the below test. In general this would be any platform
# using UTF-16 as its encoding of unicode strings, such as
# Jython. This is because UTF-16 itself is based on the use of such
# surrogates, and there is no mechanism to further escape such
# escapes.
try:
    _x = eval('"\\uD800"')  # pylint:disable=eval-used
    if not isinstance(_x, text_type):
        # We need this with u"" because of http://bugs.jython.org/issue2039
        _x = eval('u"\\uD800"')  # pylint:disable=eval-used
        assert isinstance(_x, text_type)
except:  # pylint:disable=bare-except
    supports_lone_surrogates = False
else:
    supports_lone_surrogates = True


class MethodDispatcher(dict):
    """Dict with 2 special properties:

    On initiation, keys that are lists, sets or tuples are converted to
    multiple keys so accessing any one of the items in the original
    list-like object returns the matching value

    md = MethodDispatcher({("foo", "bar"):"baz"})
    md["foo"] == "baz"

    A default value which can be set through the default attribute.
    """

    def __init__(self, items=()):
        # Using _dictEntries instead of directly assigning to self is about
        # twice as fast. Please do careful performance testing before changing
        # anything here.
        _dictEntries = []
        for name, value in items:
            if isinstance(name, (list, tuple, frozenset, set)):
                for item in name:
                    _dictEntries.append((item, value))
            else:
                _dictEntries.append((name, value))
        dict.__init__(self, _dictEntries)
        assert len(self) == len(_dictEntries)
        self.default = None

    def __getitem__(self, key):
        return dict.get(self, key, self.default)


# Some utility functions to deal with weirdness around UCS2 vs UCS4
# python builds

def isSurrogatePair(data):
    return (len(data) == 2 and
            ord(data[0]) >= 0xD800 and ord(data[0]) <= 0xDBFF and
            ord(data[1]) >= 0xDC00 and ord(data[1]) <= 0xDFFF)


def surrogatePairToCodepoint(data):
    char_val = (0x10000 + (ord(data[0]) - 0xD800) * 0x400 +
                (ord(data[1]) - 0xDC00))
    return char_val

# Module Factory Factory (no, this isn't Java, I know)
# Here to stop this being duplicated all over the place.


def moduleFactoryFactory(factory):
    moduleCache = {}

    def moduleFactory(baseModule, *args, **kwargs):
        if isinstance(ModuleType.__name__, type("")):
            name = "_%s_factory" % baseModule.__name__
        else:
            name = b"_%s_factory" % baseModule.__name__

        kwargs_tuple = tuple(kwargs.items())

        try:
            return moduleCache[name][args][kwargs_tuple]
        except KeyError:
            mod = ModuleType(name)
            objs = factory(baseModule, *args, **kwargs)
            mod.__dict__.update(objs)
            if "name" not in moduleCache:
                moduleCache[name] = {}
            if "args" not in moduleCache[name]:
                moduleCache[name][args] = {}
            if "kwargs" not in moduleCache[name][args]:
                moduleCache[name][args][kwargs_tuple] = {}
            moduleCache[name][args][kwargs_tuple] = mod
            return mod

    return moduleFactory


def memoize(func):
    cache = {}

    def wrapped(*args, **kwargs):
        key = (tuple(args), tuple(kwargs.items()))
        if key not in cache:
            cache[key] = func(*args, **kwargs)
        return cache[key]

    return wrapped
site-packages/pip/_vendor/html5lib/treebuilders/base.py000064400000034363151446177000017223 0ustar00from __future__ import absolute_import, division, unicode_literals
from pip._vendor.six import text_type

from ..constants import scopingElements, tableInsertModeElements, namespaces

# The scope markers are inserted when entering object elements,
# marquees, table cells, and table captions, and are used to prevent formatting
# from "leaking" into tables, object elements, and marquees.
Marker = None

listElementsMap = {
    None: (frozenset(scopingElements), False),
    "button": (frozenset(scopingElements | set([(namespaces["html"], "button")])), False),
    "list": (frozenset(scopingElements | set([(namespaces["html"], "ol"),
                                              (namespaces["html"], "ul")])), False),
    "table": (frozenset([(namespaces["html"], "html"),
                         (namespaces["html"], "table")]), False),
    "select": (frozenset([(namespaces["html"], "optgroup"),
                          (namespaces["html"], "option")]), True)
}


class Node(object):
    """Represents an item in the tree"""
    def __init__(self, name):
        """Creates a Node

        :arg name: The tag name associated with the node

        """
        # The tag name assocaited with the node
        self.name = name
        # The parent of the current node (or None for the document node)
        self.parent = None
        # The value of the current node (applies to text nodes and comments)
        self.value = None
        # A dict holding name -> value pairs for attributes of the node
        self.attributes = {}
        # A list of child nodes of the current node. This must include all
        # elements but not necessarily other node types.
        self.childNodes = []
        # A list of miscellaneous flags that can be set on the node.
        self._flags = []

    def __str__(self):
        attributesStr = " ".join(["%s=\"%s\"" % (name, value)
                                  for name, value in
                                  self.attributes.items()])
        if attributesStr:
            return "<%s %s>" % (self.name, attributesStr)
        else:
            return "<%s>" % (self.name)

    def __repr__(self):
        return "<%s>" % (self.name)

    def appendChild(self, node):
        """Insert node as a child of the current node

        :arg node: the node to insert

        """
        raise NotImplementedError

    def insertText(self, data, insertBefore=None):
        """Insert data as text in the current node, positioned before the
        start of node insertBefore or to the end of the node's text.

        :arg data: the data to insert

        :arg insertBefore: True if you want to insert the text before the node
            and False if you want to insert it after the node

        """
        raise NotImplementedError

    def insertBefore(self, node, refNode):
        """Insert node as a child of the current node, before refNode in the
        list of child nodes. Raises ValueError if refNode is not a child of
        the current node

        :arg node: the node to insert

        :arg refNode: the child node to insert the node before

        """
        raise NotImplementedError

    def removeChild(self, node):
        """Remove node from the children of the current node

        :arg node: the child node to remove

        """
        raise NotImplementedError

    def reparentChildren(self, newParent):
        """Move all the children of the current node to newParent.
        This is needed so that trees that don't store text as nodes move the
        text in the correct way

        :arg newParent: the node to move all this node's children to

        """
        # XXX - should this method be made more general?
        for child in self.childNodes:
            newParent.appendChild(child)
        self.childNodes = []

    def cloneNode(self):
        """Return a shallow copy of the current node i.e. a node with the same
        name and attributes but with no parent or child nodes
        """
        raise NotImplementedError

    def hasContent(self):
        """Return true if the node has children or text, false otherwise
        """
        raise NotImplementedError


class ActiveFormattingElements(list):
    def append(self, node):
        equalCount = 0
        if node != Marker:
            for element in self[::-1]:
                if element == Marker:
                    break
                if self.nodesEqual(element, node):
                    equalCount += 1
                if equalCount == 3:
                    self.remove(element)
                    break
        list.append(self, node)

    def nodesEqual(self, node1, node2):
        if not node1.nameTuple == node2.nameTuple:
            return False

        if not node1.attributes == node2.attributes:
            return False

        return True


class TreeBuilder(object):
    """Base treebuilder implementation

    * documentClass - the class to use for the bottommost node of a document
    * elementClass - the class to use for HTML Elements
    * commentClass - the class to use for comments
    * doctypeClass - the class to use for doctypes

    """
    # pylint:disable=not-callable

    # Document class
    documentClass = None

    # The class to use for creating a node
    elementClass = None

    # The class to use for creating comments
    commentClass = None

    # The class to use for creating doctypes
    doctypeClass = None

    # Fragment class
    fragmentClass = None

    def __init__(self, namespaceHTMLElements):
        """Create a TreeBuilder

        :arg namespaceHTMLElements: whether or not to namespace HTML elements

        """
        if namespaceHTMLElements:
            self.defaultNamespace = "http://www.w3.org/1999/xhtml"
        else:
            self.defaultNamespace = None
        self.reset()

    def reset(self):
        self.openElements = []
        self.activeFormattingElements = ActiveFormattingElements()

        # XXX - rename these to headElement, formElement
        self.headPointer = None
        self.formPointer = None

        self.insertFromTable = False

        self.document = self.documentClass()

    def elementInScope(self, target, variant=None):

        # If we pass a node in we match that. if we pass a string
        # match any node with that name
        exactNode = hasattr(target, "nameTuple")
        if not exactNode:
            if isinstance(target, text_type):
                target = (namespaces["html"], target)
            assert isinstance(target, tuple)

        listElements, invert = listElementsMap[variant]

        for node in reversed(self.openElements):
            if exactNode and node == target:
                return True
            elif not exactNode and node.nameTuple == target:
                return True
            elif (invert ^ (node.nameTuple in listElements)):
                return False

        assert False  # We should never reach this point

    def reconstructActiveFormattingElements(self):
        # Within this algorithm the order of steps described in the
        # specification is not quite the same as the order of steps in the
        # code. It should still do the same though.

        # Step 1: stop the algorithm when there's nothing to do.
        if not self.activeFormattingElements:
            return

        # Step 2 and step 3: we start with the last element. So i is -1.
        i = len(self.activeFormattingElements) - 1
        entry = self.activeFormattingElements[i]
        if entry == Marker or entry in self.openElements:
            return

        # Step 6
        while entry != Marker and entry not in self.openElements:
            if i == 0:
                # This will be reset to 0 below
                i = -1
                break
            i -= 1
            # Step 5: let entry be one earlier in the list.
            entry = self.activeFormattingElements[i]

        while True:
            # Step 7
            i += 1

            # Step 8
            entry = self.activeFormattingElements[i]
            clone = entry.cloneNode()  # Mainly to get a new copy of the attributes

            # Step 9
            element = self.insertElement({"type": "StartTag",
                                          "name": clone.name,
                                          "namespace": clone.namespace,
                                          "data": clone.attributes})

            # Step 10
            self.activeFormattingElements[i] = element

            # Step 11
            if element == self.activeFormattingElements[-1]:
                break

    def clearActiveFormattingElements(self):
        entry = self.activeFormattingElements.pop()
        while self.activeFormattingElements and entry != Marker:
            entry = self.activeFormattingElements.pop()

    def elementInActiveFormattingElements(self, name):
        """Check if an element exists between the end of the active
        formatting elements and the last marker. If it does, return it, else
        return false"""

        for item in self.activeFormattingElements[::-1]:
            # Check for Marker first because if it's a Marker it doesn't have a
            # name attribute.
            if item == Marker:
                break
            elif item.name == name:
                return item
        return False

    def insertRoot(self, token):
        element = self.createElement(token)
        self.openElements.append(element)
        self.document.appendChild(element)

    def insertDoctype(self, token):
        name = token["name"]
        publicId = token["publicId"]
        systemId = token["systemId"]

        doctype = self.doctypeClass(name, publicId, systemId)
        self.document.appendChild(doctype)

    def insertComment(self, token, parent=None):
        if parent is None:
            parent = self.openElements[-1]
        parent.appendChild(self.commentClass(token["data"]))

    def createElement(self, token):
        """Create an element but don't insert it anywhere"""
        name = token["name"]
        namespace = token.get("namespace", self.defaultNamespace)
        element = self.elementClass(name, namespace)
        element.attributes = token["data"]
        return element

    def _getInsertFromTable(self):
        return self._insertFromTable

    def _setInsertFromTable(self, value):
        """Switch the function used to insert an element from the
        normal one to the misnested table one and back again"""
        self._insertFromTable = value
        if value:
            self.insertElement = self.insertElementTable
        else:
            self.insertElement = self.insertElementNormal

    insertFromTable = property(_getInsertFromTable, _setInsertFromTable)

    def insertElementNormal(self, token):
        name = token["name"]
        assert isinstance(name, text_type), "Element %s not unicode" % name
        namespace = token.get("namespace", self.defaultNamespace)
        element = self.elementClass(name, namespace)
        element.attributes = token["data"]
        self.openElements[-1].appendChild(element)
        self.openElements.append(element)
        return element

    def insertElementTable(self, token):
        """Create an element and insert it into the tree"""
        element = self.createElement(token)
        if self.openElements[-1].name not in tableInsertModeElements:
            return self.insertElementNormal(token)
        else:
            # We should be in the InTable mode. This means we want to do
            # special magic element rearranging
            parent, insertBefore = self.getTableMisnestedNodePosition()
            if insertBefore is None:
                parent.appendChild(element)
            else:
                parent.insertBefore(element, insertBefore)
            self.openElements.append(element)
        return element

    def insertText(self, data, parent=None):
        """Insert text data."""
        if parent is None:
            parent = self.openElements[-1]

        if (not self.insertFromTable or (self.insertFromTable and
                                         self.openElements[-1].name
                                         not in tableInsertModeElements)):
            parent.insertText(data)
        else:
            # We should be in the InTable mode. This means we want to do
            # special magic element rearranging
            parent, insertBefore = self.getTableMisnestedNodePosition()
            parent.insertText(data, insertBefore)

    def getTableMisnestedNodePosition(self):
        """Get the foster parent element, and sibling to insert before
        (or None) when inserting a misnested table node"""
        # The foster parent element is the one which comes before the most
        # recently opened table element
        # XXX - this is really inelegant
        lastTable = None
        fosterParent = None
        insertBefore = None
        for elm in self.openElements[::-1]:
            if elm.name == "table":
                lastTable = elm
                break
        if lastTable:
            # XXX - we should really check that this parent is actually a
            # node here
            if lastTable.parent:
                fosterParent = lastTable.parent
                insertBefore = lastTable
            else:
                fosterParent = self.openElements[
                    self.openElements.index(lastTable) - 1]
        else:
            fosterParent = self.openElements[0]
        return fosterParent, insertBefore

    def generateImpliedEndTags(self, exclude=None):
        name = self.openElements[-1].name
        # XXX td, th and tr are not actually needed
        if (name in frozenset(("dd", "dt", "li", "option", "optgroup", "p", "rp", "rt")) and
                name != exclude):
            self.openElements.pop()
            # XXX This is not entirely what the specification says. We should
            # investigate it more closely.
            self.generateImpliedEndTags(exclude)

    def getDocument(self):
        """Return the final tree"""
        return self.document

    def getFragment(self):
        """Return the final fragment"""
        # assert self.innerHTML
        fragment = self.fragmentClass()
        self.openElements[0].reparentChildren(fragment)
        return fragment

    def testSerializer(self, node):
        """Serialize the subtree of node in the format required by unit tests

        :arg node: the node from which to start serializing

        """
        raise NotImplementedError
site-packages/pip/_vendor/html5lib/treebuilders/etree_lxml.py000064400000033452151446177000020447 0ustar00"""Module for supporting the lxml.etree library. The idea here is to use as much
of the native library as possible, without using fragile hacks like custom element
names that break between releases. The downside of this is that we cannot represent
all possible trees; specifically the following are known to cause problems:

Text or comments as siblings of the root element
Docypes with no name

When any of these things occur, we emit a DataLossWarning
"""

from __future__ import absolute_import, division, unicode_literals
# pylint:disable=protected-access

import warnings
import re
import sys

from . import base
from ..constants import DataLossWarning
from .. import constants
from . import etree as etree_builders
from .. import _ihatexml

import lxml.etree as etree


fullTree = True
tag_regexp = re.compile("{([^}]*)}(.*)")

comment_type = etree.Comment("asd").tag


class DocumentType(object):
    def __init__(self, name, publicId, systemId):
        self.name = name
        self.publicId = publicId
        self.systemId = systemId


class Document(object):
    def __init__(self):
        self._elementTree = None
        self._childNodes = []

    def appendChild(self, element):
        self._elementTree.getroot().addnext(element._element)

    def _getChildNodes(self):
        return self._childNodes

    childNodes = property(_getChildNodes)


def testSerializer(element):
    rv = []
    infosetFilter = _ihatexml.InfosetFilter(preventDoubleDashComments=True)

    def serializeElement(element, indent=0):
        if not hasattr(element, "tag"):
            if hasattr(element, "getroot"):
                # Full tree case
                rv.append("#document")
                if element.docinfo.internalDTD:
                    if not (element.docinfo.public_id or
                            element.docinfo.system_url):
                        dtd_str = "<!DOCTYPE %s>" % element.docinfo.root_name
                    else:
                        dtd_str = """<!DOCTYPE %s "%s" "%s">""" % (
                            element.docinfo.root_name,
                            element.docinfo.public_id,
                            element.docinfo.system_url)
                    rv.append("|%s%s" % (' ' * (indent + 2), dtd_str))
                next_element = element.getroot()
                while next_element.getprevious() is not None:
                    next_element = next_element.getprevious()
                while next_element is not None:
                    serializeElement(next_element, indent + 2)
                    next_element = next_element.getnext()
            elif isinstance(element, str) or isinstance(element, bytes):
                # Text in a fragment
                assert isinstance(element, str) or sys.version_info[0] == 2
                rv.append("|%s\"%s\"" % (' ' * indent, element))
            else:
                # Fragment case
                rv.append("#document-fragment")
                for next_element in element:
                    serializeElement(next_element, indent + 2)
        elif element.tag == comment_type:
            rv.append("|%s<!-- %s -->" % (' ' * indent, element.text))
            if hasattr(element, "tail") and element.tail:
                rv.append("|%s\"%s\"" % (' ' * indent, element.tail))
        else:
            assert isinstance(element, etree._Element)
            nsmatch = etree_builders.tag_regexp.match(element.tag)
            if nsmatch is not None:
                ns = nsmatch.group(1)
                tag = nsmatch.group(2)
                prefix = constants.prefixes[ns]
                rv.append("|%s<%s %s>" % (' ' * indent, prefix,
                                          infosetFilter.fromXmlName(tag)))
            else:
                rv.append("|%s<%s>" % (' ' * indent,
                                       infosetFilter.fromXmlName(element.tag)))

            if hasattr(element, "attrib"):
                attributes = []
                for name, value in element.attrib.items():
                    nsmatch = tag_regexp.match(name)
                    if nsmatch is not None:
                        ns, name = nsmatch.groups()
                        name = infosetFilter.fromXmlName(name)
                        prefix = constants.prefixes[ns]
                        attr_string = "%s %s" % (prefix, name)
                    else:
                        attr_string = infosetFilter.fromXmlName(name)
                    attributes.append((attr_string, value))

                for name, value in sorted(attributes):
                    rv.append('|%s%s="%s"' % (' ' * (indent + 2), name, value))

            if element.text:
                rv.append("|%s\"%s\"" % (' ' * (indent + 2), element.text))
            indent += 2
            for child in element:
                serializeElement(child, indent)
            if hasattr(element, "tail") and element.tail:
                rv.append("|%s\"%s\"" % (' ' * (indent - 2), element.tail))
    serializeElement(element, 0)

    return "\n".join(rv)


def tostring(element):
    """Serialize an element and its child nodes to a string"""
    rv = []

    def serializeElement(element):
        if not hasattr(element, "tag"):
            if element.docinfo.internalDTD:
                if element.docinfo.doctype:
                    dtd_str = element.docinfo.doctype
                else:
                    dtd_str = "<!DOCTYPE %s>" % element.docinfo.root_name
                rv.append(dtd_str)
            serializeElement(element.getroot())

        elif element.tag == comment_type:
            rv.append("<!--%s-->" % (element.text,))

        else:
            # This is assumed to be an ordinary element
            if not element.attrib:
                rv.append("<%s>" % (element.tag,))
            else:
                attr = " ".join(["%s=\"%s\"" % (name, value)
                                 for name, value in element.attrib.items()])
                rv.append("<%s %s>" % (element.tag, attr))
            if element.text:
                rv.append(element.text)

            for child in element:
                serializeElement(child)

            rv.append("</%s>" % (element.tag,))

        if hasattr(element, "tail") and element.tail:
            rv.append(element.tail)

    serializeElement(element)

    return "".join(rv)


class TreeBuilder(base.TreeBuilder):
    documentClass = Document
    doctypeClass = DocumentType
    elementClass = None
    commentClass = None
    fragmentClass = Document
    implementation = etree

    def __init__(self, namespaceHTMLElements, fullTree=False):
        builder = etree_builders.getETreeModule(etree, fullTree=fullTree)
        infosetFilter = self.infosetFilter = _ihatexml.InfosetFilter(preventDoubleDashComments=True)
        self.namespaceHTMLElements = namespaceHTMLElements

        class Attributes(dict):
            def __init__(self, element, value=None):
                if value is None:
                    value = {}
                self._element = element
                dict.__init__(self, value)  # pylint:disable=non-parent-init-called
                for key, value in self.items():
                    if isinstance(key, tuple):
                        name = "{%s}%s" % (key[2], infosetFilter.coerceAttribute(key[1]))
                    else:
                        name = infosetFilter.coerceAttribute(key)
                    self._element._element.attrib[name] = value

            def __setitem__(self, key, value):
                dict.__setitem__(self, key, value)
                if isinstance(key, tuple):
                    name = "{%s}%s" % (key[2], infosetFilter.coerceAttribute(key[1]))
                else:
                    name = infosetFilter.coerceAttribute(key)
                self._element._element.attrib[name] = value

        class Element(builder.Element):
            def __init__(self, name, namespace):
                name = infosetFilter.coerceElement(name)
                builder.Element.__init__(self, name, namespace=namespace)
                self._attributes = Attributes(self)

            def _setName(self, name):
                self._name = infosetFilter.coerceElement(name)
                self._element.tag = self._getETreeTag(
                    self._name, self._namespace)

            def _getName(self):
                return infosetFilter.fromXmlName(self._name)

            name = property(_getName, _setName)

            def _getAttributes(self):
                return self._attributes

            def _setAttributes(self, attributes):
                self._attributes = Attributes(self, attributes)

            attributes = property(_getAttributes, _setAttributes)

            def insertText(self, data, insertBefore=None):
                data = infosetFilter.coerceCharacters(data)
                builder.Element.insertText(self, data, insertBefore)

            def appendChild(self, child):
                builder.Element.appendChild(self, child)

        class Comment(builder.Comment):
            def __init__(self, data):
                data = infosetFilter.coerceComment(data)
                builder.Comment.__init__(self, data)

            def _setData(self, data):
                data = infosetFilter.coerceComment(data)
                self._element.text = data

            def _getData(self):
                return self._element.text

            data = property(_getData, _setData)

        self.elementClass = Element
        self.commentClass = Comment
        # self.fragmentClass = builder.DocumentFragment
        base.TreeBuilder.__init__(self, namespaceHTMLElements)

    def reset(self):
        base.TreeBuilder.reset(self)
        self.insertComment = self.insertCommentInitial
        self.initial_comments = []
        self.doctype = None

    def testSerializer(self, element):
        return testSerializer(element)

    def getDocument(self):
        if fullTree:
            return self.document._elementTree
        else:
            return self.document._elementTree.getroot()

    def getFragment(self):
        fragment = []
        element = self.openElements[0]._element
        if element.text:
            fragment.append(element.text)
        fragment.extend(list(element))
        if element.tail:
            fragment.append(element.tail)
        return fragment

    def insertDoctype(self, token):
        name = token["name"]
        publicId = token["publicId"]
        systemId = token["systemId"]

        if not name:
            warnings.warn("lxml cannot represent empty doctype", DataLossWarning)
            self.doctype = None
        else:
            coercedName = self.infosetFilter.coerceElement(name)
            if coercedName != name:
                warnings.warn("lxml cannot represent non-xml doctype", DataLossWarning)

            doctype = self.doctypeClass(coercedName, publicId, systemId)
            self.doctype = doctype

    def insertCommentInitial(self, data, parent=None):
        assert parent is None or parent is self.document
        assert self.document._elementTree is None
        self.initial_comments.append(data)

    def insertCommentMain(self, data, parent=None):
        if (parent == self.document and
                self.document._elementTree.getroot()[-1].tag == comment_type):
            warnings.warn("lxml cannot represent adjacent comments beyond the root elements", DataLossWarning)
        super(TreeBuilder, self).insertComment(data, parent)

    def insertRoot(self, token):
        # Because of the way libxml2 works, it doesn't seem to be possible to
        # alter information like the doctype after the tree has been parsed.
        # Therefore we need to use the built-in parser to create our initial
        # tree, after which we can add elements like normal
        docStr = ""
        if self.doctype:
            assert self.doctype.name
            docStr += "<!DOCTYPE %s" % self.doctype.name
            if (self.doctype.publicId is not None or
                    self.doctype.systemId is not None):
                docStr += (' PUBLIC "%s" ' %
                           (self.infosetFilter.coercePubid(self.doctype.publicId or "")))
                if self.doctype.systemId:
                    sysid = self.doctype.systemId
                    if sysid.find("'") >= 0 and sysid.find('"') >= 0:
                        warnings.warn("DOCTYPE system cannot contain single and double quotes", DataLossWarning)
                        sysid = sysid.replace("'", 'U00027')
                    if sysid.find("'") >= 0:
                        docStr += '"%s"' % sysid
                    else:
                        docStr += "'%s'" % sysid
                else:
                    docStr += "''"
            docStr += ">"
            if self.doctype.name != token["name"]:
                warnings.warn("lxml cannot represent doctype with a different name to the root element", DataLossWarning)
        docStr += "<THIS_SHOULD_NEVER_APPEAR_PUBLICLY/>"
        root = etree.fromstring(docStr)

        # Append the initial comments:
        for comment_token in self.initial_comments:
            comment = self.commentClass(comment_token["data"])
            root.addprevious(comment._element)

        # Create the root document and add the ElementTree to it
        self.document = self.documentClass()
        self.document._elementTree = root.getroottree()

        # Give the root element the right name
        name = token["name"]
        namespace = token.get("namespace", self.defaultNamespace)
        if namespace is None:
            etree_tag = name
        else:
            etree_tag = "{%s}%s" % (namespace, name)
        root.tag = etree_tag

        # Add the root element to the internal child/open data structures
        root_element = self.elementClass(name, namespace)
        root_element._element = root
        self.document._childNodes.append(root_element)
        self.openElements.append(root_element)

        # Reset to the default insert comment function
        self.insertComment = self.insertCommentMain
site-packages/pip/_vendor/html5lib/treebuilders/__pycache__/__init__.cpython-38.opt-1.pyc000064400000006330151446177000025266 0ustar00U

��.e�@s6dZddlmZmZmZddlmZiZddd�ZdS)	a)A collection of modules for building different kinds of trees from HTML
documents.

To create a treebuilder for a new type of tree, you need to do
implement several things:

1. A set of classes for various types of elements: Document, Doctype, Comment,
   Element. These must implement the interface of ``base.treebuilders.Node``
   (although comment nodes have a different signature for their constructor,
   see ``treebuilders.etree.Comment``) Textual content may also be implemented
   as another node type, or not, as your tree implementation requires.

2. A treebuilder object (called ``TreeBuilder`` by convention) that inherits
   from ``treebuilders.base.TreeBuilder``. This has 4 required attributes:

   * ``documentClass`` - the class to use for the bottommost node of a document
   * ``elementClass`` - the class to use for HTML Elements
   * ``commentClass`` - the class to use for comments
   * ``doctypeClass`` - the class to use for doctypes

   It also has one required method:

   * ``getDocument`` - Returns the root node of the complete document tree

3. If you wish to run the unit tests, you must also create a ``testSerializer``
   method on your treebuilder which accepts a node and returns a string
   containing Node and its children serialized according to the format used in
   the unittests

�)�absolute_import�division�unicode_literals�)�
default_etreeNcKs�|��}|tkr�|dkrLddlm}|dkr<ddlm}|}|j|f|�jS|dkrlddlm}|jt|<n<|d	kr�dd
lm	}|dkr�t
}|j|f|�jStd|��t�
|�S)aGet a TreeBuilder class for various types of trees with built-in support

    :arg treeType: the name of the tree type required (case-insensitive). Supported
        values are:

        * "dom" - A generic builder for DOM implementations, defaulting to a
          xml.dom.minidom based implementation.
        * "etree" - A generic builder for tree implementations exposing an
          ElementTree-like interface, defaulting to xml.etree.cElementTree if
          available and xml.etree.ElementTree if not.
        * "lxml" - A etree-based builder for lxml.etree, handling limitations
          of lxml's implementation.

    :arg implementation: (Currently applies to the "etree" and "dom" tree
        types). A module implementing the tree type e.g. xml.etree.ElementTree
        or xml.etree.cElementTree.

    :arg kwargs: Any additional options to pass to the TreeBuilder when
        creating it.

    Example:

    >>> from html5lib.treebuilders import getTreeBuilder
    >>> builder = getTreeBuilder('etree')

    �dom�)rNr)�minidomZlxml)�
etree_lxml�etree)rzUnrecognised treebuilder "%s" )�lower�treeBuilderCache�rZxml.domr	ZgetDomModuleZTreeBuilderr
rrZgetETreeModule�
ValueError�get)ZtreeType�implementation�kwargsrr	r
r�r�N/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/__init__.py�getTreeBuilder's$r)N)	�__doc__Z
__future__rrrZ_utilsrr
rrrrr�<module>ssite-packages/pip/_vendor/html5lib/treebuilders/__pycache__/dom.cpython-38.pyc000064400000022315151446177000023350 0ustar00U

��.e�"�@s�ddlmZmZmZzddlmZWn ek
rDddlmZYnXddlm	Z	m
Z
ddlZddlm
Z
ddlmZdd	lmZdd
lmZdd�Zee�ZdS)
�)�absolute_import�division�unicode_literals)�MutableMapping)�minidom�NodeN�)�base�)�	constants)�
namespaces)�moduleFactoryFactorycsV��Gdd�dt��G��fdd�dtj��G����fdd�dtj�}dd��t�S)	Nc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)zgetDomBuilder.<locals>.AttrListcSs
||_dS�N��element��selfr�r�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/dom.py�__init__sz(getDomBuilder.<locals>.AttrList.__init__cSst|jj���Sr)�iterr�
attributes�keys�rrrr�__iter__sz(getDomBuilder.<locals>.AttrList.__iter__cSs4t|t�rt�n |jj�|�}||_||jj|<dSr)�
isinstance�tuple�NotImplementedErrorr�
ownerDocumentZcreateAttribute�valuer)r�namer�attrrrr�__setitem__s

z+getDomBuilder.<locals>.AttrList.__setitem__cSst|jj�Sr)�lenrrrrrr�__len__#sz'getDomBuilder.<locals>.AttrList.__len__cSst|jj���Sr)�listrr�itemsrrrrr&&sz%getDomBuilder.<locals>.AttrList.itemscSst|jj���Sr)r%rr�valuesrrrrr')sz&getDomBuilder.<locals>.AttrList.valuescSs"t|t�rt�n|jj|jSdSr)rrrrrr�rr rrr�__getitem__,s
z+getDomBuilder.<locals>.AttrList.__getitem__cSst|t�rt�n
|jj|=dSr)rrrrrr(rrr�__delitem__2s
z+getDomBuilder.<locals>.AttrList.__delitem__N)�__name__�
__module__�__qualname__rrr"r$r&r'r)r*rrrr�AttrListsr.cs�eZdZdd�Zedd��Zdd�Zddd	�Zd
d�Zdd
�Z	dd�Z
�fdd�Zdd�Zeee�Z
�fdd�Zdd�Zdd�Zee�ZdS)z"getDomBuilder.<locals>.NodeBuildercSstj�||j�||_dSr)r	rr�nodeNamerrrrrr9sz+getDomBuilder.<locals>.NodeBuilder.__init__cSst|jd�r|jjpdS)N�namespaceURI)�hasattrrr0rrrr�<lambda>=s�z+getDomBuilder.<locals>.NodeBuilder.<lambda>cSs||_|j�|j�dSr)�parentr�appendChild�r�noderrrr4@sz.getDomBuilder.<locals>.NodeBuilder.appendChildNcSs4|jj�|�}|r$|j�||j�n|j�|�dSr)rr�createTextNode�insertBeforer4)r�datar8�textrrr�
insertTextDsz-getDomBuilder.<locals>.NodeBuilder.insertTextcSs|j�|j|j�||_dSr)rr8r3)rr6ZrefNoderrrr8Ksz/getDomBuilder.<locals>.NodeBuilder.insertBeforecSs&|jj|jkr|j�|j�d|_dSr)rZ
parentNode�removeChildr3r5rrrr<Osz.getDomBuilder.<locals>.NodeBuilder.removeChildcSs6|j��r,|jj}|j�|�|j�|�qg|_dSr)r�
hasChildNodesZ
firstChildr<r4�
childNodes)rZ	newParent�childrrr�reparentChildrenTs

z3getDomBuilder.<locals>.NodeBuilder.reparentChildrencs
�|j�Srrr)r.rr�
getAttributes[sz0getDomBuilder.<locals>.NodeBuilder.getAttributescSsv|rrt|���D]`\}}t|t�rb|ddk	rD|dd|d}n|d}|j�|d||�q|j�||�qdS)Nr�:rr
)r%r&rrrZsetAttributeNSZsetAttribute)rrr rZ
qualifiedNamerrr�
setAttributes^s
��z0getDomBuilder.<locals>.NodeBuilder.setAttributescs�|j�d��S)NF)r�	cloneNoder��NodeBuilderrrrDmsz,getDomBuilder.<locals>.NodeBuilder.cloneNodecSs
|j��Sr)rr=rrrr�
hasContentpsz-getDomBuilder.<locals>.NodeBuilder.hasContentcSs(|jdkrtd|jfS|j|jfSdS)NZhtml)�	namespacerr rrrr�getNameTupless
z/getDomBuilder.<locals>.NodeBuilder.getNameTuple)N)r+r,r-r�propertyrHr4r;r8r<r@rArCrrDrGrIZ	nameTupler)r.rFrrrF8s

rFcs�eZdZ�fdd�Z��fdd�Zd�fdd�	Z�fdd	�Z�fd
d�Zdd
�Z�fdd�Z	dd�Z
dd�Zddd�Z�Z
dZdS)z"getDomBuilder.<locals>.TreeBuildercs����ddd�|_t�|�Sr)�getDOMImplementationZcreateDocument�dom�weakref�proxyr)�Domrr�
documentClass|sz0getDomBuilder.<locals>.TreeBuilder.documentClasscsR|d}|d}|d}���}|�|||�}|j��|���tkrN|j|_dS)Nr �publicId�systemId)rKZcreateDocumentTypeZdocumentr4rrLr)r�tokenr rQrRZdomimplZdoctype)rOrFrr�
insertDoctype�sz0getDomBuilder.<locals>.TreeBuilder.insertDoctypeNcs6|dkr |jdkr |j�|�}n|j�||�}�|�Sr)ZdefaultNamespacerLZ
createElementZcreateElementNS)rr rHr6rErr�elementClass�sz/getDomBuilder.<locals>.TreeBuilder.elementClasscs�|j�|��Sr)rLZ
createComment)rr9rErr�commentClass�sz/getDomBuilder.<locals>.TreeBuilder.commentClasscs�|j���Sr)rLZcreateDocumentFragmentrrErr�
fragmentClass�sz0getDomBuilder.<locals>.TreeBuilder.fragmentClasscSs|j�|j�dSr)rLr4rr5rrrr4�sz.getDomBuilder.<locals>.TreeBuilder.appendChildcs�|�Srrr)�testSerializerrrrX�sz1getDomBuilder.<locals>.TreeBuilder.testSerializercSs|jSr)rLrrrr�getDocument�sz.getDomBuilder.<locals>.TreeBuilder.getDocumentcSstj�|�jSr)r	�TreeBuilder�getFragmentrrrrrr[�sz.getDomBuilder.<locals>.TreeBuilder.getFragmentcSsp|}||krtj�|||�nNt|jd�rXtj|jjkrXt|jj�|j_|jj�	tj�|j�
|j�|��dS)N�_child_node_types)r	rZr;r1rLr�	TEXT_NODEr\r%�appendr4r7)rr9r3rrrr;�sz-getDomBuilder.<locals>.TreeBuilder.insertText)N)N)r+r,r-rPrTrUrVrWr4rXrYr[r;�implementationr r)rO�DomImplementationrFrXrrrZ{s

rZcs0|��g�d��fdd�	��|d�d���S)Nrcs|jtjkr�|jrj|js|jrP|jp&d}|jp0d}��dd||j||f�q~��dd||jf�n��dd|f��nr|jtjkr���d��nX|jtjkr���d��n>|jtj	krވ�dd||j
f��n|jtjk�r��d	d||j
f�n�t|d
��r6|j
dk	�r6dtj|j
|jf}n|j}��dd||f�|���r�g}tt|j��D]T}|j�|�}|j}|j}|j
}	|	�r�dtj|	|jf}n|j}|�||f��qnt|�D]&\}}��d
d|d||f��q�|d7}|jD]}
�|
|��qdS)N�z|%s<!DOCTYPE %s "%s" "%s">� z|%s<!DOCTYPE %s>z|%s<!DOCTYPE >z	#documentz#document-fragmentz|%s<!-- %s -->z|%s"%s"r0z%s %sz|%s<%s>z
|%s%s="%s"r
)ZnodeTyperZDOCUMENT_TYPE_NODEr rQrRr^Z
DOCUMENT_NODEZDOCUMENT_FRAGMENT_NODEZCOMMENT_NODEZ	nodeValuer]r1r0r�prefixesr/Z
hasAttributes�ranger#r�itemrZ	localName�sortedr>)r�indentrQrRr r�ir!r�nsr?��rv�serializeElementrrrl�sT

���
 
z?getDomBuilder.<locals>.testSerializer.<locals>.serializeElement�
)r)Z	normalize�joinrrrjrrX�s
.
z%getDomBuilder.<locals>.testSerializer)rr	rrZ�locals)r`rZr)r.rOr`rFrXr�
getDomBuilders$C:6rp)Z
__future__rrrZcollections.abcr�ImportError�collectionsZxml.domrrrMrar	rrZ_utilsr
rpZgetDomModulerrrr�<module>s_site-packages/pip/_vendor/html5lib/treebuilders/__pycache__/etree.cpython-38.opt-1.pyc000064400000026667151446177000024652 0ustar00U

��.e�1�@s�ddlmZmZmZddlmZddlZddlmZddlm	Z	ddlm
Z
dd	l
mZdd
lm
Z
e�d�Zdd
d�Ze
e�ZdS)�)�absolute_import�division�unicode_literals)�	text_typeN�)�base�)�	_ihatexml)�	constants)�
namespaces)�moduleFactoryFactoryz
{([^}]*)}(.*)Fc	s�����d�j�G�fdd�dtj��G�fdd�d���G�fdd�d���G�fdd	�d	���G�fd
d�d����fdd
��	��fdd�}G��������	fdd�dtj�}t�S)NZasdcs�eZdZd$�fdd�	Zdd�Zdd�Zdd	�Zeee�Zd
d�Z	dd
�Z
ee
e	�Zdd�Zdd�Z
eee
�Zdd�Zdd�Zeee�Zdd�Zdd�Zdd�Zdd�Zd%dd�Zd d!�Zd"d#�ZdS)&z getETreeBuilder.<locals>.ElementNcs^||_||_��|�||��|_|dkr:td|jf|_n|j|jf|_d|_g|_g|_	dS)N�html)
�_name�
_namespace�Element�_getETreeTag�_elementrZ	nameTuple�parent�_childNodes�_flags)�self�name�	namespace��ElementTree��K/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/etree.py�__init__s
�z)getETreeBuilder.<locals>.Element.__init__cSs|dkr|}nd||f}|S)N�{%s}%sr)rrrZ	etree_tagrrrr#sz-getETreeBuilder.<locals>.Element._getETreeTagcSs||_|�|j|j�|j_dS�N)rrrr�tag)rrrrr�_setName*sz)getETreeBuilder.<locals>.Element._setNamecSs|jSr)r�rrrr�_getName.sz)getETreeBuilder.<locals>.Element._getNamecSs||_|�|j|j�|j_dSr)rrrrr )rrrrr�
_setNamespace3sz.getETreeBuilder.<locals>.Element._setNamespacecSs|jSr)rr"rrr�
_getNamespace7sz.getETreeBuilder.<locals>.Element._getNamespacecSs|jjSr)r�attribr"rrr�_getAttributes<sz/getETreeBuilder.<locals>.Element._getAttributescSsht|jj���D]}|jj|=q|��D]:\}}t|t�rPd|d|df}n|}|j�||�q(dS)Nrrr)�listrr&�keys�items�
isinstance�tuple�set)r�
attributes�key�valuerrrr�_setAttributes?s
z/getETreeBuilder.<locals>.Element._setAttributescSs|jSr)rr"rrr�_getChildNodesMsz/getETreeBuilder.<locals>.Element._getChildNodescSs*|jdd�=g|_|D]}|�|�qdSr)rrZinsertChild)rr0�elementrrr�_setChildNodesPsz/getETreeBuilder.<locals>.Element._setChildNodescSst|jjpt|j��S)z,Return true if the node has children or text)�boolr�text�lenr"rrr�
hasContentXsz+getETreeBuilder.<locals>.Element.hasContentcSs$|j�|�|j�|j�||_dSr)r�appendrr�r�noderrr�appendChild\sz,getETreeBuilder.<locals>.Element.appendChildcSs,t|j��|j�}|j�||j�||_dSr)r(r�index�insertr)rr;ZrefNoder=rrr�insertBeforeasz-getETreeBuilder.<locals>.Element.insertBeforecSs$|j�|�|j�|j�d|_dSr)r�removerrr:rrr�removeChildfsz,getETreeBuilder.<locals>.Element.removeChildcSs�t|j�s,|jjsd|j_|jj|7_n�|dkrb|jdjsLd|jd_|jdj|7_nxt|j�}|�|j�}|dkr�|j|djs�d|j|d_|j|dj|7_n |jjs�d|j_|jj|7_dS)N����rr)r7rr6�tailr(r=)r�datar?Zchildrenr=rrr�
insertTextks"

z+getETreeBuilder.<locals>.Element.insertTextcSs4t|�|j|j�}|j��D]\}}||j|<q|Sr)�typerrr.r*)rr3rr0rrr�	cloneNode�sz*getETreeBuilder.<locals>.Element.cloneNodecSsl|jr"|jdjj|jj7_n0|jjs2d|j_|jjdk	rR|jj|jj7_d|j_tj�||�dS)NrCrB)�
childNodesrrDr6r�Node�reparentChildren)rZ	newParentrrrrK�sz1getETreeBuilder.<locals>.Element.reparentChildren)N)N)�__name__�
__module__�__qualname__rrr!r#�propertyrr$r%rr'r1r.r2r4rIr8r<r?rArFrHrKrrrrrs*





rcs2eZdZ�fdd�Zdd�Zdd�Zeee�ZdS)z getETreeBuilder.<locals>.Commentcs"��|�|_d|_g|_g|_dSr)�Commentrrrr)rrErrrr�sz)getETreeBuilder.<locals>.Comment.__init__cSs|jjSr�rr6r"rrr�_getData�sz)getETreeBuilder.<locals>.Comment._getDatacSs||j_dSrrQ�rr0rrr�_setData�sz)getETreeBuilder.<locals>.Comment._setDataN)rLrMrNrrRrTrOrErrrrrP�srPcsLeZdZ�fdd�Zdd�Zdd�Zeee�Zdd�Zd	d
�Z	eee	�Z
dS)z%getETreeBuilder.<locals>.DocumentTypecs$��|d�||j_||_||_dS)N�
<!DOCTYPE>)rrr6�publicId�systemId)rrrVrW�rrrr�sz.getETreeBuilder.<locals>.DocumentType.__init__cSs|j�dd�S)NrVrB�r�getr"rrr�_getPublicId�sz2getETreeBuilder.<locals>.DocumentType._getPublicIdcSs|dk	r|j�d|�dS)NrV�rr-rSrrr�_setPublicId�sz2getETreeBuilder.<locals>.DocumentType._setPublicIdcSs|j�dd�S)NrWrBrYr"rrr�_getSystemId�sz2getETreeBuilder.<locals>.DocumentType._getSystemIdcSs|dk	r|j�d|�dS)NrWr\rSrrr�_setSystemId�sz2getETreeBuilder.<locals>.DocumentType._setSystemIdN)rLrMrNrr[r]rOrVr^r_rWrrXrr�DocumentType�s
r`cseZdZ�fdd�ZdS)z!getETreeBuilder.<locals>.Documentcs��|d�dS)N�
DOCUMENT_ROOT�rr"rXrrr�sz*getETreeBuilder.<locals>.Document.__init__N�rLrMrNrrrXrr�Document�srdcseZdZ�fdd�ZdS)z)getETreeBuilder.<locals>.DocumentFragmentcs��|d�dS)NZDOCUMENT_FRAGMENTrbr"rXrrr�sz2getETreeBuilder.<locals>.DocumentFragment.__init__NrcrrXrr�DocumentFragment�srecs*g�d���fdd�	��|d�d���S)Nrcsnt|d�s|��}|jdkrz|�d�s0|�d�rd|�d�p<d}|�d�pJd}��d|j||f�n��d|jf��n�|jdkr��d	�|jdk	r���d
d|d|jf�|jdk	r�td
��t|d�r�t|j	�r�td���nB|j�k�r��dd||jf��nt
�|j�}|dk�r,|j}n"|��\}}t
j|}d||f}��dd||f�t|d��rg}|j	��D]T\}}	t
�|�}|dk	�r�|��\}}t
j|}d||f}
n|}
|�|
|	f��q~t|�D]&\}}	��dd|d||	f��q�|j�r(��d
d|d|jf�|d7}|D]}�||��q4|j�rj��d
d|d|jf�dS)Nr rUrVrWrBz<!DOCTYPE %s "%s" "%s">�
<!DOCTYPE %s>raz	#documentz|%s"%s"� r�Document node cannot have tailr&�$Document node cannot have attributesz|%s<!-- %s -->z%s %sz|%s<%s>z
|%s%s="%s")�hasattr�getrootr rZr9r6rD�	TypeErrorr7r&�
tag_regexp�match�groupsr
�prefixesr*�sorted)r3�indentrVrWZnsmatchr�ns�prefixr.r0Zattr_string�child)�ElementTreeCommentType�rv�serializeElementrrrx�s\


�








 zAgetETreeBuilder.<locals>.testSerializer.<locals>.serializeElement�
)r)�join�r3)rv)rwrxr�testSerializer�s7
z'getETreeBuilder.<locals>.testSerializercs2g�t��������fdd���|�d���S)z4Serialize an element and its child nodes to a stringcs�t|�j�r|��}|jdkr||�d�s2|�d�rf|�d�p>d}|�d�pLd}��d|j||f�n��d|jf��n|jdkr�|jdk	r���|j�|jdk	r�td��t	|d	�r�t
|j�r�td
��|D]}�|�q�n�|j�kr���d|jf�n�|j�s��d��|j�f�n2d
�
�fdd�|j��D��}��d|j|f�|j�rd��|j�|D]}�|��qh��d|jf�|j�r���|j�dS)NrUrVrWrBz<!DOCTYPE %s PUBLIC "%s" "%s">rfrarhr&riz	<!--%s-->z<%s>rgcs"g|]\}}d��|�|f�qS)z%s="%s")�fromXmlName)�.0rr0)�filterrr�
<listcomp>&s
��zOgetETreeBuilder.<locals>.tostring.<locals>.serializeElement.<locals>.<listcomp>z<%s %s>z</%s>)r+rrkr rZr9r6rDrlrjr7r&r}rzr*)r3rVrWru�attr)rrvrrwrxrrrxsD

�



�z;getETreeBuilder.<locals>.tostring.<locals>.serializeElementrB)r	Z
InfosetFilterrzr{)rrv)rrwrxr�tostrings
-z!getETreeBuilder.<locals>.tostringcsDeZdZ�Z�Z�Z�Z�Z�Z�fdd�Z	�fdd�Z
dd�ZdS)z$getETreeBuilder.<locals>.TreeBuildercs�|�Srr)rr3)r|rrr|Asz3getETreeBuilder.<locals>.TreeBuilder.testSerializercs<�r|jjS|jdk	r*|jj�d|j�S|jj�d�SdS)Nz{%s}htmlr
)ZdocumentrZdefaultNamespace�findr")�fullTreerr�getDocumentDs
�z0getETreeBuilder.<locals>.TreeBuilder.getDocumentcSstj�|�jSr)r�TreeBuilder�getFragmentrr"rrrr�Nsz0getETreeBuilder.<locals>.TreeBuilder.getFragmentN)rLrMrNZ
documentClassZdoctypeClassZelementClassZcommentClassZ
fragmentClass�implementationr|r�r�r)rPrdrer`r�ElementTreeImplementationr�r|rrr�9s
r�)rPr rrJr��locals)r�r�r�r�r)
rPrdrer`rrrvr�r�r|r�getETreeBuilders~>6$r�)F)Z
__future__rrrZpip._vendor.sixr�rerBrr	r
rZ_utilsr�compilermr�ZgetETreeModulerrrr�<module>s

Esite-packages/pip/_vendor/html5lib/treebuilders/__pycache__/etree_lxml.cpython-38.pyc000064400000027000151446177000024725 0ustar00U

��.e*7�@s�dZddlmZmZmZddlZddlZddlZddlm	Z	ddl
mZddlm
Z
dd	lmZ
dd
lmZddlmZdZe�d�Ze�d
�jZGdd�de�ZGdd�de�Zdd�Zdd�ZGdd�de	j�ZdS)a�Module for supporting the lxml.etree library. The idea here is to use as much
of the native library as possible, without using fragile hacks like custom element
names that break between releases. The downside of this is that we cannot represent
all possible trees; specifically the following are known to cause problems:

Text or comments as siblings of the root element
Docypes with no name

When any of these things occur, we emit a DataLossWarning
�)�absolute_import�division�unicode_literalsN�)�base�)�DataLossWarning)�	constants)�etree)�	_ihatexmlTz
{([^}]*)}(.*)Zasdc@seZdZdd�ZdS)�DocumentTypecCs||_||_||_dS�N)�name�publicId�systemId)�selfrrr�r�P/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/etree_lxml.py�__init__#szDocumentType.__init__N)�__name__�
__module__�__qualname__rrrrrr"src@s,eZdZdd�Zdd�Zdd�Zee�ZdS)�DocumentcCsd|_g|_dSr
)�_elementTree�_childNodes�rrrrr*szDocument.__init__cCs|j���|j�dSr
)r�getrootZaddnext�_element�r�elementrrr�appendChild.szDocument.appendChildcCs|jSr
)rrrrr�_getChildNodes1szDocument._getChildNodesN)rrrrr r!�propertyZ
childNodesrrrrr)srcs6g�tjdd��d���fdd�	��|d�d���S)NT�ZpreventDoubleDashCommentsrc
s,t|d��s,t|d�r���d�|jjrz|jjsF|jjsFd|jj}nd|jj|jj|jjf}��dd|d|f�|��}|��dk	r�|��}q�|dk	r��||d�|�	�}q�nnt
|t�s�t
|t��rt
|t�s�t
jd	dks�t���d
d||f�n$��d�|D]}�||d��q�n�|jtk�r���dd||jf�t|d
��r(|j�r(��d
d||jf��n�t
|tj��s�t�tj�|j�}|dk	�r�|�d�}|�d�}tj|}��dd||��|�f�n��dd|��|j�f�t|d��r�g}|j��D]d\}	}
t�|	�}|dk	�rj|��\}}	��|	�}	tj|}d||	f}n
��|	�}|�||
f��q t |�D]&\}	}
��dd|d|	|
f��q�|j�rڈ�d
d|d|jf�|d7}|D]}�||��q�t|d
��r(|j�r(��d
d|d|jf�dS)N�tagrz	#document�
<!DOCTYPE %s>z<!DOCTYPE %s "%s" "%s">z|%s%s� rrz|%s"%s"z#document-fragmentz|%s<!-- %s -->�tailrz
|%s<%s %s>z|%s<%s>�attribz%s %sz
|%s%s="%s")!�hasattr�append�docinfo�internalDTDZ	public_idZ
system_url�	root_namerZgetpreviousZgetnext�
isinstance�str�bytes�sys�version_info�AssertionErrorr$�comment_type�textr'r
Z_Element�etree_builders�
tag_regexp�match�groupr	�prefixes�fromXmlNamer(�items�groups�sorted)
r�indent�dtd_strZnext_elementZnsmatch�nsr$�prefix�
attributesr�valueZattr_string�child��
infosetFilter�rv�serializeElementrrrI;s|

��





�

�




 z(testSerializer.<locals>.serializeElement�
)r)r�
InfosetFilter�join�rrrFr�testSerializer7s
F
rNcs$g���fdd���|�d���S)z4Serialize an element and its child nodes to a stringcst|d�sH|jjr:|jjr$|jj}nd|jj}��|��|���n�|jtkrf��d|j	f�n~|j
s���d|jf�n.d�dd�|j
��D��}��d|j|f�|j	r���|j	�|D]}�|�qĈ�d	|jf�t|d
��r|j
�r��|j
�dS)Nr$r%z	<!--%s-->z<%s>r&cSsg|]\}}d||f�qS)z%s="%s"r)�.0rrDrrr�
<listcomp>�s�z6tostring.<locals>.serializeElement.<locals>.<listcomp>z<%s %s>z</%s>r')r)r+r,�doctyper-r*rr$r4r5r(rLr<r')rr@�attrrE�rHrIrrrI�s,




�
z"tostring.<locals>.serializeElement�)rLrMrrSr�tostring�s rUcszeZdZeZeZdZdZeZ	e
Zddd�Zdd�Z
dd�Zd	d
�Zdd�Zd
d�Zddd�Zd�fdd�	Zdd�Z�ZS)�TreeBuilderNFcs�tjt|d��tjdd��|_||_G�fdd�dt��G���fdd�d�j�}G��fdd	�d	�j	�}||_
||_tj
�||�dS)
N)�fullTreeTr#cs&eZdZd�fdd�	Z�fdd�ZdS)z(TreeBuilder.__init__.<locals>.AttributesNcsr|dkri}||_t�||�|��D]F\}}t|t�rTd|d��|d�f}n
��|�}||jjj|<q&dS�N�{%s}%srr)r�dictrr<r.�tuple�coerceAttributer()rrrD�keyr�rGrrr�s

z1TreeBuilder.__init__.<locals>.Attributes.__init__csPt�|||�t|t�r4d|d��|d�f}n
��|�}||jjj|<dSrX)rZ�__setitem__r.r[r\rr()rr]rDrr^rrr_�s


z4TreeBuilder.__init__.<locals>.Attributes.__setitem__)N)rrrrr_rr^rr�
Attributes�sr`csxeZdZ���fdd�Z�fdd�Z�fdd�Zeee�Zdd�Z�fd	d
�Z	eee	�Z
d��fdd
�	Z�fdd�ZdS)z%TreeBuilder.__init__.<locals>.Elementcs*��|�}�jj|||d��|�|_dS)N)�	namespace)�
coerceElement�Elementr�_attributes)rrra�r`�builderrGrrr�s
z.TreeBuilder.__init__.<locals>.Element.__init__cs$��|�|_|�|j|j�|j_dSr
)rb�_nameZ_getETreeTagZ
_namespacerr$)rrr^rr�_setName�s
�z.TreeBuilder.__init__.<locals>.Element._setNamecs��|j�Sr
)r;rgrr^rr�_getName�sz.TreeBuilder.__init__.<locals>.Element._getNamecSs|jSr
�rdrrrr�_getAttributes�sz4TreeBuilder.__init__.<locals>.Element._getAttributescs�||�|_dSr
rj)rrC)r`rr�_setAttributes�sz4TreeBuilder.__init__.<locals>.Element._setAttributesNcs��|�}�j�|||�dSr
)ZcoerceCharactersrc�
insertText)r�dataZinsertBefore�rfrGrrrm�s
z0TreeBuilder.__init__.<locals>.Element.insertTextcs�j�||�dSr
)rcr )rrE)rfrrr �sz1TreeBuilder.__init__.<locals>.Element.appendChild)N)
rrrrrhrir"rrkrlrCrmr rrerrrc�s

rccs8eZdZ��fdd�Z�fdd�Zdd�Zeee�ZdS)z%TreeBuilder.__init__.<locals>.Commentcs��|�}�j�||�dSr
)�
coerceComment�Commentr�rrnrorrr�s
z.TreeBuilder.__init__.<locals>.Comment.__init__cs��|�}||j_dSr
)rprr5rrr^rr�_setData�s
z.TreeBuilder.__init__.<locals>.Comment._setDatacSs|jjSr
)rr5rrrr�_getData�sz.TreeBuilder.__init__.<locals>.Comment._getDataN)rrrrrsrtr"rnrrorrrq�srq)r6ZgetETreeModuler
rrKrG�namespaceHTMLElementsrZrcrq�elementClass�commentClassrrVr)rrurWrcrqrrerr�szTreeBuilder.__init__cCs$tj�|�|j|_g|_d|_dSr
)rrV�reset�insertCommentInitial�
insertComment�initial_commentsrQrrrrrxszTreeBuilder.resetcCst|�Sr
)rNrrrrrN	szTreeBuilder.testSerializercCstr|jjS|jj��SdSr
)rW�documentrrrrrr�getDocumentszTreeBuilder.getDocumentcCsFg}|jdj}|jr"|�|j�|�t|��|jrB|�|j�|S)Nr)�openElementsrr5r*�extend�listr')rZfragmentrrrr�getFragmentszTreeBuilder.getFragmentcCsh|d}|d}|d}|s0t�dt�d|_n4|j�|�}||krPt�dt�|�|||�}||_dS)Nrrrz#lxml cannot represent empty doctypez%lxml cannot represent non-xml doctype)�warnings�warnrrQrGrb�doctypeClass)r�tokenrrrZcoercedNamerQrrr�
insertDoctypeszTreeBuilder.insertDoctypecCs6|dks||jkst�|jjdks&t�|j�|�dSr
)r|r3rr{r*�rrn�parentrrrry,sz TreeBuilder.insertCommentInitialcsB||jkr,|jj��djtkr,t�dt�tt	|��
||�dS)N���z@lxml cannot represent adjacent comments beyond the root elements)r|rrr$r4r�r�r�superrVrzr���	__class__rr�insertCommentMain1s

�zTreeBuilder.insertCommentMaincCs�d}|jr�|jjst�|d|jj7}|jjdk	s>|jjdk	r�|d|j�|jjpRd�7}|jjr�|jj}|�d�dkr�|�d�dkr�t�	dt
�|�dd�}|�d�dkr�|d	|7}q�|d
|7}n|d7}|d7}|jj|d
kr�t�	dt
�|d7}t�
|�}|jD] }|�|d�}|�|j��q|��|_|��|j_|d
}|�d|j�}|dk�rj|}	nd||f}	|	|_|�||�}
||
_|jj�|
�|j�|
�|j|_dS)NrTz<!DOCTYPE %sz
 PUBLIC "%s" �'r�"z6DOCTYPE system cannot contain single and double quotesZU00027z"%s"z'%s'z''�>rzGlxml cannot represent doctype with a different name to the root elementz$<THIS_SHOULD_NEVER_APPEAR_PUBLICLY/>rnrarY)rQrr3rrrGZcoercePubid�findr�r�r�replacer
Z
fromstringr{rwZaddpreviousr�
documentClassr|Zgetroottreer�getZdefaultNamespacer$rvrr*r~r�rz)rr�ZdocStrZsysid�root�
comment_tokenZcommentrraZ	etree_tagZroot_elementrrr�
insertRoot7sP
��



zTreeBuilder.insertRoot)F)N)N)rrrrr�rr�rvrwZ
fragmentClassr
�implementationrrxrNr}r�r�ryr�r��
__classcell__rrr�rrV�s
L

rV)�__doc__Z
__future__rrrr��rer1rTrr	rr
r6rZ
lxml.etreerW�compiler7rqr$r4�objectrrrNrUrVrrrr�<module>s$
O)site-packages/pip/_vendor/html5lib/treebuilders/__pycache__/base.cpython-38.pyc000064400000026062151446177000023506 0ustar00U

��.e�8�@s�ddlmZmZmZddlmZddlmZmZm	Z	dZ
ee�dfeeee	ddfg�B�dfeeee	dd	fe	dd
fg�B�dfee	ddfe	ddfg�dfee	ddfe	dd
fg�dfd�Z
Gdd�de�ZGdd�de�ZGdd�de�ZdS)�)�absolute_import�division�unicode_literals)�	text_type�)�scopingElements�tableInsertModeElements�
namespacesNF�html�buttonZolZul�table�optgroup�optionT)Nr�listrZselectc@sbeZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
d
S)�NodezRepresents an item in the treecCs(||_d|_d|_i|_g|_g|_dS)zRCreates a Node

        :arg name: The tag name associated with the node

        N)�name�parent�value�
attributes�
childNodesZ_flags)�selfr�r�J/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/base.py�__init__sz
Node.__init__cCs:d�dd�|j��D��}|r,d|j|fSd|jSdS)N� cSsg|]\}}d||f�qS)z%s="%s"r)�.0rrrrr�
<listcomp>.s�z Node.__str__.<locals>.<listcomp>z<%s %s>�<%s>)�joinr�itemsr)rZ
attributesStrrrr�__str__-s
�zNode.__str__cCs
d|jS)Nr)r�rrrr�__repr__6sz
Node.__repr__cCst�dS)z[Insert node as a child of the current node

        :arg node: the node to insert

        N��NotImplementedError�r�noderrr�appendChild9szNode.appendChildNcCst�dS)aBInsert data as text in the current node, positioned before the
        start of node insertBefore or to the end of the node's text.

        :arg data: the data to insert

        :arg insertBefore: True if you want to insert the text before the node
            and False if you want to insert it after the node

        Nr#)r�data�insertBeforerrr�
insertTextAs
zNode.insertTextcCst�dS)aInsert node as a child of the current node, before refNode in the
        list of child nodes. Raises ValueError if refNode is not a child of
        the current node

        :arg node: the node to insert

        :arg refNode: the child node to insert the node before

        Nr#)rr&ZrefNoderrrr)Ms
zNode.insertBeforecCst�dS)zhRemove node from the children of the current node

        :arg node: the child node to remove

        Nr#r%rrr�removeChildYszNode.removeChildcCs |jD]}|�|�qg|_dS)z�Move all the children of the current node to newParent.
        This is needed so that trees that don't store text as nodes move the
        text in the correct way

        :arg newParent: the node to move all this node's children to

        N)rr')rZ	newParentZchildrrr�reparentChildrenas	
zNode.reparentChildrencCst�dS)z�Return a shallow copy of the current node i.e. a node with the same
        name and attributes but with no parent or child nodes
        Nr#r!rrr�	cloneNodenszNode.cloneNodecCst�dS)zFReturn true if the node has children or text, false otherwise
        Nr#r!rrr�
hasContenttszNode.hasContent)N)�__name__�
__module__�__qualname__�__doc__rr r"r'r*r)r+r,r-r.rrrrrs	

rc@seZdZdd�Zdd�ZdS)�ActiveFormattingElementscCsfd}|tkrV|ddd�D]:}|tkr*qV|�||�r>|d7}|dkr|�|�qVqt�||�dS)Nr�����)�Marker�
nodesEqual�remover�append)rr&Z
equalCount�elementrrrr:{s
zActiveFormattingElements.appendcCs$|j|jksdS|j|jks dSdS)NFT)�	nameTupler)rZnode1Znode2rrrr8�s
z#ActiveFormattingElements.nodesEqualN)r/r0r1r:r8rrrrr3zs
r3c@s�eZdZdZdZdZdZdZdZdd�Z	dd�Z
d+dd�Zd	d
�Zdd�Z
d
d�Zdd�Zdd�Zd,dd�Zdd�Zdd�Zdd�Zeee�Zdd�Zdd�Zd-dd �Zd!d"�Zd.d#d$�Zd%d&�Zd'd(�Zd)d*�ZdS)/�TreeBuilderaBase treebuilder implementation

    * documentClass - the class to use for the bottommost node of a document
    * elementClass - the class to use for HTML Elements
    * commentClass - the class to use for comments
    * doctypeClass - the class to use for doctypes

    NcCs|rd|_nd|_|��dS)zmCreate a TreeBuilder

        :arg namespaceHTMLElements: whether or not to namespace HTML elements

        zhttp://www.w3.org/1999/xhtmlN)�defaultNamespace�reset)rZnamespaceHTMLElementsrrrr�szTreeBuilder.__init__cCs.g|_t�|_d|_d|_d|_|��|_dS)NF)�openElementsr3�activeFormattingElementsZheadPointerZformPointer�insertFromTable�
documentClass�documentr!rrrr?�szTreeBuilder.resetcCs�t|d�}|s2t|t�r$td|f}t|t�s2t�t|\}}t|j�D]>}|r^||kr^dS|sr|j	|krrdS||j	|kArHdSqHds�t�dS)Nr<r
TF)
�hasattr�
isinstancerr	�tuple�AssertionError�listElementsMap�reversedr@r<)r�targetZvariantZ	exactNodeZlistElements�invertr&rrr�elementInScope�s

zTreeBuilder.elementInScopecCs�|js
dSt|j�d}|j|}|tks4||jkr8dS|tkrl||jkrl|dkrXd}ql|d8}|j|}q8|d7}|j|}|��}|�d|j|j|jd��}||j|<||jdkrlq�qldS)Nr5rr4ZStartTag)�typer�	namespacer()	rA�lenr7r@r-�
insertElementrrOr)r�i�entryZcloner;rrr�#reconstructActiveFormattingElements�s.

�
z/TreeBuilder.reconstructActiveFormattingElementscCs(|j��}|jr$|tkr$|j��}q
dS�N)rA�popr7)rrSrrr�clearActiveFormattingElementss
z)TreeBuilder.clearActiveFormattingElementscCs:|jddd�D]$}|tkr"q6q|j|kr|SqdS)z�Check if an element exists between the end of the active
        formatting elements and the last marker. If it does, return it, else
        return falseNr4F)rAr7r)rr�itemrrr�!elementInActiveFormattingElements
s

z-TreeBuilder.elementInActiveFormattingElementscCs&|�|�}|j�|�|j�|�dSrU)�
createElementr@r:rDr')r�tokenr;rrr�
insertRoots
zTreeBuilder.insertRootcCs6|d}|d}|d}|�|||�}|j�|�dS)Nr�publicId�systemId)�doctypeClassrDr')rr[rr]r^Zdoctyperrr�
insertDoctype s
zTreeBuilder.insertDoctypecCs*|dkr|jd}|�|�|d��dS)Nr4r()r@r'�commentClass)rr[rrrr�
insertComment(s
zTreeBuilder.insertCommentcCs0|d}|�d|j�}|�||�}|d|_|S)z.Create an element but don't insert it anywhererrOr()�getr>�elementClassr�rr[rrOr;rrrrZ-s

zTreeBuilder.createElementcCs|jSrU)�_insertFromTabler!rrr�_getInsertFromTable5szTreeBuilder._getInsertFromTablecCs ||_|r|j|_n|j|_dS)zsSwitch the function used to insert an element from the
        normal one to the misnested table one and back againN)rf�insertElementTablerQ�insertElementNormal)rrrrr�_setInsertFromTable8s
zTreeBuilder._setInsertFromTablecCsb|d}t|t�std|��|�d|j�}|�||�}|d|_|jd�|�|j�	|�|S)NrzElement %s not unicoderOr(r4)
rFrrHrcr>rdrr@r'r:rerrrriCs
zTreeBuilder.insertElementNormalcCs`|�|�}|jdjtkr$|�|�S|��\}}|dkrD|�|�n|�||�|j�|�|S)z-Create an element and insert it into the treer4N)	rZr@rrri�getTableMisnestedNodePositionr'r)r:)rr[r;rr)rrrrhMs

zTreeBuilder.insertElementTablecCsV|dkr|jd}|jr.|jr:|jdjtkr:|�|�n|��\}}|�||�dS)zInsert text data.Nr4)r@rBrrr*rk)rr(rr)rrrr*]s

��zTreeBuilder.insertTextcCstd}d}d}|jddd�D]}|jdkr|}q4q|rb|jrJ|j}|}ql|j|j�|�d}n
|jd}||fS)zsGet the foster parent element, and sibling to insert before
        (or None) when inserting a misnested table nodeNr4rr5r)r@rr�index)rZ	lastTableZfosterParentr)Zelmrrrrkls 
�
z)TreeBuilder.getTableMisnestedNodePositioncCs8|jdj}|td�kr4||kr4|j��|�|�dS)Nr4)ZddZdtZlirr
�pZrpZrt)r@r�	frozensetrV�generateImpliedEndTags)r�excluderrrrro�s�
z"TreeBuilder.generateImpliedEndTagscCs|jS)zReturn the final tree)rDr!rrr�getDocument�szTreeBuilder.getDocumentcCs|��}|jd�|�|S)zReturn the final fragmentr)�
fragmentClassr@r,)rZfragmentrrr�getFragment�szTreeBuilder.getFragmentcCst�dS)z�Serialize the subtree of node in the format required by unit tests

        :arg node: the node from which to start serializing

        Nr#r%rrr�testSerializer�szTreeBuilder.testSerializer)N)N)N)N)r/r0r1r2rCrdrar_rrrr?rMrTrWrYr\r`rbrZrgrj�propertyrBrirhr*rkrorqrsrtrrrrr=�s6
.
	




r=)Z
__future__rrrZpip._vendor.sixrZ	constantsrrr	r7rn�setrI�objectrrr3r=rrrr�<module>s0

��
��
���csite-packages/pip/_vendor/html5lib/treebuilders/__pycache__/etree.cpython-38.pyc000064400000027040151446177000023675 0ustar00U

��.e�1�@s�ddlmZmZmZddlmZddlZddlmZddlm	Z	ddlm
Z
dd	l
mZdd
lm
Z
e�d�Zdd
d�Ze
e�ZdS)�)�absolute_import�division�unicode_literals)�	text_typeN�)�base�)�	_ihatexml)�	constants)�
namespaces)�moduleFactoryFactoryz
{([^}]*)}(.*)Fc	s�����d�j�G�fdd�dtj��G�fdd�d���G�fdd�d���G�fdd	�d	���G�fd
d�d����fdd
��	��fdd�}G��������	fdd�dtj�}t�S)NZasdcs�eZdZd$�fdd�	Zdd�Zdd�Zdd	�Zeee�Zd
d�Z	dd
�Z
ee
e	�Zdd�Zdd�Z
eee
�Zdd�Zdd�Zeee�Zdd�Zdd�Zdd�Zdd�Zd%dd�Zd d!�Zd"d#�ZdS)&z getETreeBuilder.<locals>.ElementNcs^||_||_��|�||��|_|dkr:td|jf|_n|j|jf|_d|_g|_g|_	dS)N�html)
�_name�
_namespace�Element�_getETreeTag�_elementrZ	nameTuple�parent�_childNodes�_flags)�self�name�	namespace��ElementTree��K/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/etree.py�__init__s
�z)getETreeBuilder.<locals>.Element.__init__cSs|dkr|}nd||f}|S)N�{%s}%sr)rrrZ	etree_tagrrrr#sz-getETreeBuilder.<locals>.Element._getETreeTagcSs||_|�|j|j�|j_dS�N)rrrr�tag)rrrrr�_setName*sz)getETreeBuilder.<locals>.Element._setNamecSs|jSr)r�rrrr�_getName.sz)getETreeBuilder.<locals>.Element._getNamecSs||_|�|j|j�|j_dSr)rrrrr )rrrrr�
_setNamespace3sz.getETreeBuilder.<locals>.Element._setNamespacecSs|jSr)rr"rrr�
_getNamespace7sz.getETreeBuilder.<locals>.Element._getNamespacecSs|jjSr)r�attribr"rrr�_getAttributes<sz/getETreeBuilder.<locals>.Element._getAttributescSsht|jj���D]}|jj|=q|��D]:\}}t|t�rPd|d|df}n|}|j�||�q(dS)Nrrr)�listrr&�keys�items�
isinstance�tuple�set)r�
attributes�key�valuerrrr�_setAttributes?s
z/getETreeBuilder.<locals>.Element._setAttributescSs|jSr)rr"rrr�_getChildNodesMsz/getETreeBuilder.<locals>.Element._getChildNodescSs*|jdd�=g|_|D]}|�|�qdSr)rrZinsertChild)rr0�elementrrr�_setChildNodesPsz/getETreeBuilder.<locals>.Element._setChildNodescSst|jjpt|j��S)z,Return true if the node has children or text)�boolr�text�lenr"rrr�
hasContentXsz+getETreeBuilder.<locals>.Element.hasContentcSs$|j�|�|j�|j�||_dSr)r�appendrr�r�noderrr�appendChild\sz,getETreeBuilder.<locals>.Element.appendChildcSs,t|j��|j�}|j�||j�||_dSr)r(r�index�insertr)rr;ZrefNoder=rrr�insertBeforeasz-getETreeBuilder.<locals>.Element.insertBeforecSs$|j�|�|j�|j�d|_dSr)r�removerrr:rrr�removeChildfsz,getETreeBuilder.<locals>.Element.removeChildcSs�t|j�s,|jjsd|j_|jj|7_n�|dkrb|jdjsLd|jd_|jdj|7_nxt|j�}|�|j�}|dkr�|j|djs�d|j|d_|j|dj|7_n |jjs�d|j_|jj|7_dS)N����rr)r7rr6�tailr(r=)r�datar?Zchildrenr=rrr�
insertTextks"

z+getETreeBuilder.<locals>.Element.insertTextcSs4t|�|j|j�}|j��D]\}}||j|<q|Sr)�typerrr.r*)rr3rr0rrr�	cloneNode�sz*getETreeBuilder.<locals>.Element.cloneNodecSsl|jr"|jdjj|jj7_n0|jjs2d|j_|jjdk	rR|jj|jj7_d|j_tj�||�dS)NrCrB)�
childNodesrrDr6r�Node�reparentChildren)rZ	newParentrrrrK�sz1getETreeBuilder.<locals>.Element.reparentChildren)N)N)�__name__�
__module__�__qualname__rrr!r#�propertyrr$r%rr'r1r.r2r4rIr8r<r?rArFrHrKrrrrrs*





rcs2eZdZ�fdd�Zdd�Zdd�Zeee�ZdS)z getETreeBuilder.<locals>.Commentcs"��|�|_d|_g|_g|_dSr)�Commentrrrr)rrErrrr�sz)getETreeBuilder.<locals>.Comment.__init__cSs|jjSr�rr6r"rrr�_getData�sz)getETreeBuilder.<locals>.Comment._getDatacSs||j_dSrrQ�rr0rrr�_setData�sz)getETreeBuilder.<locals>.Comment._setDataN)rLrMrNrrRrTrOrErrrrrP�srPcsLeZdZ�fdd�Zdd�Zdd�Zeee�Zdd�Zd	d
�Z	eee	�Z
dS)z%getETreeBuilder.<locals>.DocumentTypecs$��|d�||j_||_||_dS)N�
<!DOCTYPE>)rrr6�publicId�systemId)rrrVrW�rrrr�sz.getETreeBuilder.<locals>.DocumentType.__init__cSs|j�dd�S)NrVrB�r�getr"rrr�_getPublicId�sz2getETreeBuilder.<locals>.DocumentType._getPublicIdcSs|dk	r|j�d|�dS)NrV�rr-rSrrr�_setPublicId�sz2getETreeBuilder.<locals>.DocumentType._setPublicIdcSs|j�dd�S)NrWrBrYr"rrr�_getSystemId�sz2getETreeBuilder.<locals>.DocumentType._getSystemIdcSs|dk	r|j�d|�dS)NrWr\rSrrr�_setSystemId�sz2getETreeBuilder.<locals>.DocumentType._setSystemIdN)rLrMrNrr[r]rOrVr^r_rWrrXrr�DocumentType�s
r`cseZdZ�fdd�ZdS)z!getETreeBuilder.<locals>.Documentcs��|d�dS)N�
DOCUMENT_ROOT�rr"rXrrr�sz*getETreeBuilder.<locals>.Document.__init__N�rLrMrNrrrXrr�Document�srdcseZdZ�fdd�ZdS)z)getETreeBuilder.<locals>.DocumentFragmentcs��|d�dS)NZDOCUMENT_FRAGMENTrbr"rXrrr�sz2getETreeBuilder.<locals>.DocumentFragment.__init__NrcrrXrr�DocumentFragment�srecs*g�d���fdd�	��|d�d���S)Nrcs�t|d�s|��}|jdkrz|�d�s0|�d�rd|�d�p<d}|�d�pJd}��d|j||f�n��d|jf��n�|jdkr��d	�|jdk	r���d
d|d|jf�|jdk	r�td
��t|d�r�t|j	�r�td���nh|j�k�r��dd||jf��n@t
|jt��s4tdt
|j�|jf��t�|j�}|dk�rR|j}n"|��\}}tj|}d||f}��dd||f�t|d��r*g}|j	��D]T\}}	t�|�}|dk	�r�|��\}}tj|}d||f}
n|}
|�|
|	f��q�t|�D]&\}}	��dd|d||	f��q|j�rN��d
d|d|jf�|d7}|D]}�||��qZ|j�r���d
d|d|jf�dS)Nr rUrVrWrBz<!DOCTYPE %s "%s" "%s">�
<!DOCTYPE %s>raz	#documentz|%s"%s"� r�Document node cannot have tailr&�$Document node cannot have attributesz|%s<!-- %s -->zExpected unicode, got %s, %sz%s %sz|%s<%s>z
|%s%s="%s")�hasattr�getrootr rZr9r6rD�	TypeErrorr7r&r+r�AssertionErrorrG�
tag_regexp�match�groupsr
�prefixesr*�sorted)r3�indentrVrWZnsmatchr�ns�prefixr.r0Zattr_string�child)�ElementTreeCommentType�rv�serializeElementrrry�sb


�



�




 zAgetETreeBuilder.<locals>.testSerializer.<locals>.serializeElement�
)r)�join�r3)rw)rxryr�testSerializer�s7
z'getETreeBuilder.<locals>.testSerializercs2g�t��������fdd���|�d���S)z4Serialize an element and its child nodes to a stringcs�t|�j�r|��}|jdkr||�d�s2|�d�rf|�d�p>d}|�d�pLd}��d|j||f�n��d|jf��n|jdkr�|jdk	r���|j�|jdk	r�td��t	|d	�r�t
|j�r�td
��|D]}�|�q�n�|j�kr���d|jf�n�|j�s��d��|j�f�n2d
�
�fdd�|j��D��}��d|j|f�|j�rd��|j�|D]}�|��qh��d|jf�|j�r���|j�dS)NrUrVrWrBz<!DOCTYPE %s PUBLIC "%s" "%s">rfrarhr&riz	<!--%s-->z<%s>rgcs"g|]\}}d��|�|f�qS)z%s="%s")�fromXmlName)�.0rr0)�filterrr�
<listcomp>&s
��zOgetETreeBuilder.<locals>.tostring.<locals>.serializeElement.<locals>.<listcomp>z<%s %s>z</%s>)r+rrkr rZr9r6rDrlrjr7r&r~r{r*)r3rVrWrv�attr)rrwr�rxryrrrysD

�



�z;getETreeBuilder.<locals>.tostring.<locals>.serializeElementrB)r	Z
InfosetFilterr{r|)rrw)r�rxryr�tostrings
-z!getETreeBuilder.<locals>.tostringcsDeZdZ�Z�Z�Z�Z�Z�Z�fdd�Z	�fdd�Z
dd�ZdS)z$getETreeBuilder.<locals>.TreeBuildercs�|�Srr)rr3)r}rrr}Asz3getETreeBuilder.<locals>.TreeBuilder.testSerializercs<�r|jjS|jdk	r*|jj�d|j�S|jj�d�SdS)Nz{%s}htmlr
)ZdocumentrZdefaultNamespace�findr")�fullTreerr�getDocumentDs
�z0getETreeBuilder.<locals>.TreeBuilder.getDocumentcSstj�|�jSr)r�TreeBuilder�getFragmentrr"rrrr�Nsz0getETreeBuilder.<locals>.TreeBuilder.getFragmentN)rLrMrNZ
documentClassZdoctypeClassZelementClassZcommentClassZ
fragmentClass�implementationr}r�r�r)rPrdrer`r�ElementTreeImplementationr�r}rrr�9s
r�)rPr rrJr��locals)r�r�r�r�r)
rPrdrer`rrrwr�r�r}r�getETreeBuilders~>6$r�)F)Z
__future__rrrZpip._vendor.sixr�rerBrr	r
rZ_utilsr�compilernr�ZgetETreeModulerrrr�<module>s

Esite-packages/pip/_vendor/html5lib/treebuilders/__pycache__/etree_lxml.cpython-38.opt-1.pyc000064400000026507151446177000025677 0ustar00U

��.e*7�@s�dZddlmZmZmZddlZddlZddlZddlm	Z	ddl
mZddlm
Z
dd	lmZ
dd
lmZddlmZdZe�d�Ze�d
�jZGdd�de�ZGdd�de�Zdd�Zdd�ZGdd�de	j�ZdS)a�Module for supporting the lxml.etree library. The idea here is to use as much
of the native library as possible, without using fragile hacks like custom element
names that break between releases. The downside of this is that we cannot represent
all possible trees; specifically the following are known to cause problems:

Text or comments as siblings of the root element
Docypes with no name

When any of these things occur, we emit a DataLossWarning
�)�absolute_import�division�unicode_literalsN�)�base�)�DataLossWarning)�	constants)�etree)�	_ihatexmlTz
{([^}]*)}(.*)Zasdc@seZdZdd�ZdS)�DocumentTypecCs||_||_||_dS�N)�name�publicId�systemId)�selfrrr�r�P/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/etree_lxml.py�__init__#szDocumentType.__init__N)�__name__�
__module__�__qualname__rrrrrr"src@s,eZdZdd�Zdd�Zdd�Zee�ZdS)�DocumentcCsd|_g|_dSr
)�_elementTree�_childNodes�rrrrr*szDocument.__init__cCs|j���|j�dSr
)r�getrootZaddnext�_element�r�elementrrr�appendChild.szDocument.appendChildcCs|jSr
)rrrrr�_getChildNodes1szDocument._getChildNodesN)rrrrr r!�propertyZ
childNodesrrrrr)srcs6g�tjdd��d���fdd�	��|d�d���S)NT�ZpreventDoubleDashCommentsrc
s�t|d��st|d�r���d�|jjrz|jjsF|jjsFd|jj}nd|jj|jj|jjf}��dd|d|f�|��}|��dk	r�|��}q�|dk	r��||d�|�	�}q�nNt
|t�s�t
|t�r��d	d||f�n"��d
�|D]}�||d�q�n�|j
tk�r`��dd||jf�t|d��r�|j�r���d	d||jf��n�tj�|j
�}|dk	�r�|�d
�}|�d�}tj|}��dd||��|�f�n��dd|��|j
�f�t|d��r�g}|j��D]d\}	}
t�|	�}|dk	�r8|��\}}	��|	�}	tj|}d||	f}n
��|	�}|�||
f��q�t|�D]&\}	}
��dd|d|	|
f��q\|j�r���d	d|d|jf�|d7}|D]}�||��q�t|d��r�|j�r���d	d|d|jf�dS)N�tagrz	#document�
<!DOCTYPE %s>z<!DOCTYPE %s "%s" "%s">z|%s%s� rz|%s"%s"z#document-fragmentz|%s<!-- %s -->�tailrz
|%s<%s %s>z|%s<%s>�attribz%s %sz
|%s%s="%s")�hasattr�append�docinfo�internalDTDZ	public_idZ
system_url�	root_namerZgetpreviousZgetnext�
isinstance�str�bytesr$�comment_type�textr'�etree_builders�
tag_regexp�match�groupr	�prefixes�fromXmlNamer(�items�groups�sorted)
r�indent�dtd_strZnext_elementZnsmatch�nsr$�prefix�
attributesr�valueZattr_string�child��
infosetFilter�rv�serializeElementrrrF;sx

��





�

�




 z(testSerializer.<locals>.serializeElement�
)r)r�
InfosetFilter�join�rrrCr�testSerializer7s
F
rKcs$g���fdd���|�d���S)z4Serialize an element and its child nodes to a stringcst|d�sH|jjr:|jjr$|jj}nd|jj}��|��|���n�|jtkrf��d|j	f�n~|j
s���d|jf�n.d�dd�|j
��D��}��d|j|f�|j	r���|j	�|D]}�|�qĈ�d	|jf�t|d
��r|j
�r��|j
�dS)Nr$r%z	<!--%s-->z<%s>r&cSsg|]\}}d||f�qS)z%s="%s"r)�.0rrArrr�
<listcomp>�s�z6tostring.<locals>.serializeElement.<locals>.<listcomp>z<%s %s>z</%s>r')r)r+r,�doctyper-r*rr$r1r2r(rIr9r')rr=�attrrB�rErFrrrF�s,




�
z"tostring.<locals>.serializeElement�)rIrJrrPr�tostring�s rRcszeZdZeZeZdZdZeZ	e
Zddd�Zdd�Z
dd�Zd	d
�Zdd�Zd
d�Zddd�Zd�fdd�	Zdd�Z�ZS)�TreeBuilderNFcs�tjt|d��tjdd��|_||_G�fdd�dt��G���fdd�d�j�}G��fdd	�d	�j	�}||_
||_tj
�||�dS)
N)�fullTreeTr#cs&eZdZd�fdd�	Z�fdd�ZdS)z(TreeBuilder.__init__.<locals>.AttributesNcsr|dkri}||_t�||�|��D]F\}}t|t�rTd|d��|d�f}n
��|�}||jjj|<q&dS�N�{%s}%srr)r�dictrr9r.�tuple�coerceAttributer()rrrA�keyr�rDrrr�s

z1TreeBuilder.__init__.<locals>.Attributes.__init__csPt�|||�t|t�r4d|d��|d�f}n
��|�}||jjj|<dSrU)rW�__setitem__r.rXrYrr()rrZrArr[rrr\�s


z4TreeBuilder.__init__.<locals>.Attributes.__setitem__)N)rrrrr\rr[rr�
Attributes�sr]csxeZdZ���fdd�Z�fdd�Z�fdd�Zeee�Zdd�Z�fd	d
�Z	eee	�Z
d��fdd
�	Z�fdd�ZdS)z%TreeBuilder.__init__.<locals>.Elementcs*��|�}�jj|||d��|�|_dS)N)�	namespace)�
coerceElement�Elementr�_attributes)rrr^�r]�builderrDrrr�s
z.TreeBuilder.__init__.<locals>.Element.__init__cs$��|�|_|�|j|j�|j_dSr
)r_�_nameZ_getETreeTagZ
_namespacerr$)rrr[rr�_setName�s
�z.TreeBuilder.__init__.<locals>.Element._setNamecs��|j�Sr
)r8rdrr[rr�_getName�sz.TreeBuilder.__init__.<locals>.Element._getNamecSs|jSr
�rarrrr�_getAttributes�sz4TreeBuilder.__init__.<locals>.Element._getAttributescs�||�|_dSr
rg)rr@)r]rr�_setAttributes�sz4TreeBuilder.__init__.<locals>.Element._setAttributesNcs��|�}�j�|||�dSr
)ZcoerceCharactersr`�
insertText)r�dataZinsertBefore�rcrDrrrj�s
z0TreeBuilder.__init__.<locals>.Element.insertTextcs�j�||�dSr
)r`r )rrB)rcrrr �sz1TreeBuilder.__init__.<locals>.Element.appendChild)N)
rrrrrerfr"rrhrir@rjr rrbrrr`�s

r`cs8eZdZ��fdd�Z�fdd�Zdd�Zeee�ZdS)z%TreeBuilder.__init__.<locals>.Commentcs��|�}�j�||�dSr
)�
coerceComment�Commentr�rrkrlrrr�s
z.TreeBuilder.__init__.<locals>.Comment.__init__cs��|�}||j_dSr
)rmrr2ror[rr�_setData�s
z.TreeBuilder.__init__.<locals>.Comment._setDatacSs|jjSr
)rr2rrrr�_getData�sz.TreeBuilder.__init__.<locals>.Comment._getDataN)rrrrrprqr"rkrrlrrrn�srn)r3ZgetETreeModuler
rrHrD�namespaceHTMLElementsrWr`rn�elementClass�commentClassrrSr)rrrrTr`rnrrbrr�szTreeBuilder.__init__cCs$tj�|�|j|_g|_d|_dSr
)rrS�reset�insertCommentInitial�
insertComment�initial_commentsrNrrrrruszTreeBuilder.resetcCst|�Sr
)rKrrrrrK	szTreeBuilder.testSerializercCstr|jjS|jj��SdSr
)rT�documentrrrrrr�getDocumentszTreeBuilder.getDocumentcCsFg}|jdj}|jr"|�|j�|�t|��|jrB|�|j�|S)Nr)�openElementsrr2r*�extend�listr')rZfragmentrrrr�getFragmentszTreeBuilder.getFragmentcCsh|d}|d}|d}|s0t�dt�d|_n4|j�|�}||krPt�dt�|�|||�}||_dS)Nrrrz#lxml cannot represent empty doctypez%lxml cannot represent non-xml doctype)�warnings�warnrrNrDr_�doctypeClass)r�tokenrrrZcoercedNamerNrrr�
insertDoctypeszTreeBuilder.insertDoctypecCs|j�|�dSr
)rxr*�rrk�parentrrrrv,sz TreeBuilder.insertCommentInitialcsB||jkr,|jj��djtkr,t�dt�tt	|��
||�dS)N���z@lxml cannot represent adjacent comments beyond the root elements)ryrrr$r1rr�r�superrSrwr���	__class__rr�insertCommentMain1s

�zTreeBuilder.insertCommentMaincCs�d}|jr�|d|jj7}|jjdk	s2|jjdk	r�|d|j�|jjpFd�7}|jjr�|jj}|�d�dkr�|�d�dkr�t�dt	�|�
dd�}|�d�dkr�|d	|7}q�|d
|7}n|d7}|d7}|jj|d
kr�t�dt	�|d7}t�|�}|j
D] }|�|d�}|�|j��q|��|_|��|j_|d
}|�d|j�}|dk�r^|}	nd||f}	|	|_|�||�}
||
_|jj�|
�|j�|
�|j|_dS)NrQz<!DOCTYPE %sz
 PUBLIC "%s" �'r�"z6DOCTYPE system cannot contain single and double quotesZU00027z"%s"z'%s'z''�>rzGlxml cannot represent doctype with a different name to the root elementz$<THIS_SHOULD_NEVER_APPEAR_PUBLICLY/>rkr^rV)rNrrrrDZcoercePubid�findrr�r�replacer
Z
fromstringrxrtZaddpreviousr�
documentClassryZgetroottreer�getZdefaultNamespacer$rsrr*r{r�rw)rr�ZdocStrZsysid�root�
comment_tokenZcommentrr^Z	etree_tagZroot_elementrrr�
insertRoot7sN
��



zTreeBuilder.insertRoot)F)N)N)rrrrr�rr�rsrtZ
fragmentClassr
�implementationrrurKrzr~r�rvr�r��
__classcell__rrr�rrS�s
L

rS)�__doc__Z
__future__rrrr�re�sysrQrr	rr
r3rZ
lxml.etreerT�compiler4rnr$r1�objectrrrKrRrSrrrr�<module>s$
O)site-packages/pip/_vendor/html5lib/treebuilders/__pycache__/base.cpython-38.opt-1.pyc000064400000025704151446177000024447 0ustar00U

��.e�8�@s�ddlmZmZmZddlmZddlmZmZm	Z	dZ
ee�dfeeee	ddfg�B�dfeeee	dd	fe	dd
fg�B�dfee	ddfe	ddfg�dfee	ddfe	dd
fg�dfd�Z
Gdd�de�ZGdd�de�ZGdd�de�ZdS)�)�absolute_import�division�unicode_literals)�	text_type�)�scopingElements�tableInsertModeElements�
namespacesNF�html�buttonZolZul�table�optgroup�optionT)Nr�listrZselectc@sbeZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
d
S)�NodezRepresents an item in the treecCs(||_d|_d|_i|_g|_g|_dS)zRCreates a Node

        :arg name: The tag name associated with the node

        N)�name�parent�value�
attributes�
childNodesZ_flags)�selfr�r�J/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/base.py�__init__sz
Node.__init__cCs:d�dd�|j��D��}|r,d|j|fSd|jSdS)N� cSsg|]\}}d||f�qS)z%s="%s"r)�.0rrrrr�
<listcomp>.s�z Node.__str__.<locals>.<listcomp>z<%s %s>�<%s>)�joinr�itemsr)rZ
attributesStrrrr�__str__-s
�zNode.__str__cCs
d|jS)Nr)r�rrrr�__repr__6sz
Node.__repr__cCst�dS)z[Insert node as a child of the current node

        :arg node: the node to insert

        N��NotImplementedError�r�noderrr�appendChild9szNode.appendChildNcCst�dS)aBInsert data as text in the current node, positioned before the
        start of node insertBefore or to the end of the node's text.

        :arg data: the data to insert

        :arg insertBefore: True if you want to insert the text before the node
            and False if you want to insert it after the node

        Nr#)r�data�insertBeforerrr�
insertTextAs
zNode.insertTextcCst�dS)aInsert node as a child of the current node, before refNode in the
        list of child nodes. Raises ValueError if refNode is not a child of
        the current node

        :arg node: the node to insert

        :arg refNode: the child node to insert the node before

        Nr#)rr&ZrefNoderrrr)Ms
zNode.insertBeforecCst�dS)zhRemove node from the children of the current node

        :arg node: the child node to remove

        Nr#r%rrr�removeChildYszNode.removeChildcCs |jD]}|�|�qg|_dS)z�Move all the children of the current node to newParent.
        This is needed so that trees that don't store text as nodes move the
        text in the correct way

        :arg newParent: the node to move all this node's children to

        N)rr')rZ	newParentZchildrrr�reparentChildrenas	
zNode.reparentChildrencCst�dS)z�Return a shallow copy of the current node i.e. a node with the same
        name and attributes but with no parent or child nodes
        Nr#r!rrr�	cloneNodenszNode.cloneNodecCst�dS)zFReturn true if the node has children or text, false otherwise
        Nr#r!rrr�
hasContenttszNode.hasContent)N)�__name__�
__module__�__qualname__�__doc__rr r"r'r*r)r+r,r-r.rrrrrs	

rc@seZdZdd�Zdd�ZdS)�ActiveFormattingElementscCsfd}|tkrV|ddd�D]:}|tkr*qV|�||�r>|d7}|dkr|�|�qVqt�||�dS)Nr�����)�Marker�
nodesEqual�remover�append)rr&Z
equalCount�elementrrrr:{s
zActiveFormattingElements.appendcCs$|j|jksdS|j|jks dSdS)NFT)�	nameTupler)rZnode1Znode2rrrr8�s
z#ActiveFormattingElements.nodesEqualN)r/r0r1r:r8rrrrr3zs
r3c@s�eZdZdZdZdZdZdZdZdd�Z	dd�Z
d+dd�Zd	d
�Zdd�Z
d
d�Zdd�Zdd�Zd,dd�Zdd�Zdd�Zdd�Zeee�Zdd�Zdd�Zd-dd �Zd!d"�Zd.d#d$�Zd%d&�Zd'd(�Zd)d*�ZdS)/�TreeBuilderaBase treebuilder implementation

    * documentClass - the class to use for the bottommost node of a document
    * elementClass - the class to use for HTML Elements
    * commentClass - the class to use for comments
    * doctypeClass - the class to use for doctypes

    NcCs|rd|_nd|_|��dS)zmCreate a TreeBuilder

        :arg namespaceHTMLElements: whether or not to namespace HTML elements

        zhttp://www.w3.org/1999/xhtmlN)�defaultNamespace�reset)rZnamespaceHTMLElementsrrrr�szTreeBuilder.__init__cCs.g|_t�|_d|_d|_d|_|��|_dS)NF)�openElementsr3�activeFormattingElementsZheadPointerZformPointer�insertFromTable�
documentClass�documentr!rrrr?�szTreeBuilder.resetcCs~t|d�}|s$t|t�r$td|f}t|\}}t|j�D]>}|rP||krPdS|sd|j|krddS||j|kAr:dSq:dS)Nr<r
TF)�hasattr�
isinstancerr	�listElementsMap�reversedr@r<)r�targetZvariantZ	exactNodeZlistElements�invertr&rrr�elementInScope�s

zTreeBuilder.elementInScopecCs�|js
dSt|j�d}|j|}|tks4||jkr8dS|tkrl||jkrl|dkrXd}ql|d8}|j|}q8|d7}|j|}|��}|�d|j|j|jd��}||j|<||jdkrlq�qldS)Nr5rr4ZStartTag)�typer�	namespacer()	rA�lenr7r@r-�
insertElementrrMr)r�i�entryZcloner;rrr�#reconstructActiveFormattingElements�s.

�
z/TreeBuilder.reconstructActiveFormattingElementscCs(|j��}|jr$|tkr$|j��}q
dS�N)rA�popr7)rrQrrr�clearActiveFormattingElementss
z)TreeBuilder.clearActiveFormattingElementscCs:|jddd�D]$}|tkr"q6q|j|kr|SqdS)z�Check if an element exists between the end of the active
        formatting elements and the last marker. If it does, return it, else
        return falseNr4F)rAr7r)rr�itemrrr�!elementInActiveFormattingElements
s

z-TreeBuilder.elementInActiveFormattingElementscCs&|�|�}|j�|�|j�|�dSrS)�
createElementr@r:rDr')r�tokenr;rrr�
insertRoots
zTreeBuilder.insertRootcCs6|d}|d}|d}|�|||�}|j�|�dS)Nr�publicId�systemId)�doctypeClassrDr')rrYrr[r\Zdoctyperrr�
insertDoctype s
zTreeBuilder.insertDoctypecCs*|dkr|jd}|�|�|d��dS)Nr4r()r@r'�commentClass)rrYrrrr�
insertComment(s
zTreeBuilder.insertCommentcCs0|d}|�d|j�}|�||�}|d|_|S)z.Create an element but don't insert it anywhererrMr()�getr>�elementClassr�rrYrrMr;rrrrX-s

zTreeBuilder.createElementcCs|jSrS)�_insertFromTabler!rrr�_getInsertFromTable5szTreeBuilder._getInsertFromTablecCs ||_|r|j|_n|j|_dS)zsSwitch the function used to insert an element from the
        normal one to the misnested table one and back againN)rd�insertElementTablerO�insertElementNormal)rrrrr�_setInsertFromTable8s
zTreeBuilder._setInsertFromTablecCsL|d}|�d|j�}|�||�}|d|_|jd�|�|j�|�|S)NrrMr(r4)rar>rbrr@r'r:rcrrrrgCs
zTreeBuilder.insertElementNormalcCs`|�|�}|jdjtkr$|�|�S|��\}}|dkrD|�|�n|�||�|j�|�|S)z-Create an element and insert it into the treer4N)	rXr@rrrg�getTableMisnestedNodePositionr'r)r:)rrYr;rr)rrrrfMs

zTreeBuilder.insertElementTablecCsV|dkr|jd}|jr.|jr:|jdjtkr:|�|�n|��\}}|�||�dS)zInsert text data.Nr4)r@rBrrr*ri)rr(rr)rrrr*]s

��zTreeBuilder.insertTextcCstd}d}d}|jddd�D]}|jdkr|}q4q|rb|jrJ|j}|}ql|j|j�|�d}n
|jd}||fS)zsGet the foster parent element, and sibling to insert before
        (or None) when inserting a misnested table nodeNr4rr5r)r@rr�index)rZ	lastTableZfosterParentr)Zelmrrrrils 
�
z)TreeBuilder.getTableMisnestedNodePositioncCs8|jdj}|td�kr4||kr4|j��|�|�dS)Nr4)ZddZdtZlirr
�pZrpZrt)r@r�	frozensetrT�generateImpliedEndTags)r�excluderrrrrm�s�
z"TreeBuilder.generateImpliedEndTagscCs|jS)zReturn the final tree)rDr!rrr�getDocument�szTreeBuilder.getDocumentcCs|��}|jd�|�|S)zReturn the final fragmentr)�
fragmentClassr@r,)rZfragmentrrr�getFragment�szTreeBuilder.getFragmentcCst�dS)z�Serialize the subtree of node in the format required by unit tests

        :arg node: the node from which to start serializing

        Nr#r%rrr�testSerializer�szTreeBuilder.testSerializer)N)N)N)N)r/r0r1r2rCrbr_r]rprr?rKrRrUrWrZr^r`rXrerh�propertyrBrgrfr*rirmrorqrrrrrrr=�s6
.
	




r=)Z
__future__rrrZpip._vendor.sixrZ	constantsrrr	r7rl�setrG�objectrrr3r=rrrr�<module>s0

��
��
���csite-packages/pip/_vendor/html5lib/treebuilders/__pycache__/dom.cpython-38.opt-1.pyc000064400000022315151446177000024307 0ustar00U

��.e�"�@s�ddlmZmZmZzddlmZWn ek
rDddlmZYnXddlm	Z	m
Z
ddlZddlm
Z
ddlmZdd	lmZdd
lmZdd�Zee�ZdS)
�)�absolute_import�division�unicode_literals)�MutableMapping)�minidom�NodeN�)�base�)�	constants)�
namespaces)�moduleFactoryFactorycsV��Gdd�dt��G��fdd�dtj��G����fdd�dtj�}dd��t�S)	Nc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)zgetDomBuilder.<locals>.AttrListcSs
||_dS�N��element��selfr�r�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/dom.py�__init__sz(getDomBuilder.<locals>.AttrList.__init__cSst|jj���Sr)�iterr�
attributes�keys�rrrr�__iter__sz(getDomBuilder.<locals>.AttrList.__iter__cSs4t|t�rt�n |jj�|�}||_||jj|<dSr)�
isinstance�tuple�NotImplementedErrorr�
ownerDocumentZcreateAttribute�valuer)r�namer�attrrrr�__setitem__s

z+getDomBuilder.<locals>.AttrList.__setitem__cSst|jj�Sr)�lenrrrrrr�__len__#sz'getDomBuilder.<locals>.AttrList.__len__cSst|jj���Sr)�listrr�itemsrrrrr&&sz%getDomBuilder.<locals>.AttrList.itemscSst|jj���Sr)r%rr�valuesrrrrr')sz&getDomBuilder.<locals>.AttrList.valuescSs"t|t�rt�n|jj|jSdSr)rrrrrr�rr rrr�__getitem__,s
z+getDomBuilder.<locals>.AttrList.__getitem__cSst|t�rt�n
|jj|=dSr)rrrrrr(rrr�__delitem__2s
z+getDomBuilder.<locals>.AttrList.__delitem__N)�__name__�
__module__�__qualname__rrr"r$r&r'r)r*rrrr�AttrListsr.cs�eZdZdd�Zedd��Zdd�Zddd	�Zd
d�Zdd
�Z	dd�Z
�fdd�Zdd�Zeee�Z
�fdd�Zdd�Zdd�Zee�ZdS)z"getDomBuilder.<locals>.NodeBuildercSstj�||j�||_dSr)r	rr�nodeNamerrrrrr9sz+getDomBuilder.<locals>.NodeBuilder.__init__cSst|jd�r|jjpdS)N�namespaceURI)�hasattrrr0rrrr�<lambda>=s�z+getDomBuilder.<locals>.NodeBuilder.<lambda>cSs||_|j�|j�dSr)�parentr�appendChild�r�noderrrr4@sz.getDomBuilder.<locals>.NodeBuilder.appendChildNcSs4|jj�|�}|r$|j�||j�n|j�|�dSr)rr�createTextNode�insertBeforer4)r�datar8�textrrr�
insertTextDsz-getDomBuilder.<locals>.NodeBuilder.insertTextcSs|j�|j|j�||_dSr)rr8r3)rr6ZrefNoderrrr8Ksz/getDomBuilder.<locals>.NodeBuilder.insertBeforecSs&|jj|jkr|j�|j�d|_dSr)rZ
parentNode�removeChildr3r5rrrr<Osz.getDomBuilder.<locals>.NodeBuilder.removeChildcSs6|j��r,|jj}|j�|�|j�|�qg|_dSr)r�
hasChildNodesZ
firstChildr<r4�
childNodes)rZ	newParent�childrrr�reparentChildrenTs

z3getDomBuilder.<locals>.NodeBuilder.reparentChildrencs
�|j�Srrr)r.rr�
getAttributes[sz0getDomBuilder.<locals>.NodeBuilder.getAttributescSsv|rrt|���D]`\}}t|t�rb|ddk	rD|dd|d}n|d}|j�|d||�q|j�||�qdS)Nr�:rr
)r%r&rrrZsetAttributeNSZsetAttribute)rrr rZ
qualifiedNamerrr�
setAttributes^s
��z0getDomBuilder.<locals>.NodeBuilder.setAttributescs�|j�d��S)NF)r�	cloneNoder��NodeBuilderrrrDmsz,getDomBuilder.<locals>.NodeBuilder.cloneNodecSs
|j��Sr)rr=rrrr�
hasContentpsz-getDomBuilder.<locals>.NodeBuilder.hasContentcSs(|jdkrtd|jfS|j|jfSdS)NZhtml)�	namespacerr rrrr�getNameTupless
z/getDomBuilder.<locals>.NodeBuilder.getNameTuple)N)r+r,r-r�propertyrHr4r;r8r<r@rArCrrDrGrIZ	nameTupler)r.rFrrrF8s

rFcs�eZdZ�fdd�Z��fdd�Zd�fdd�	Z�fdd	�Z�fd
d�Zdd
�Z�fdd�Z	dd�Z
dd�Zddd�Z�Z
dZdS)z"getDomBuilder.<locals>.TreeBuildercs����ddd�|_t�|�Sr)�getDOMImplementationZcreateDocument�dom�weakref�proxyr)�Domrr�
documentClass|sz0getDomBuilder.<locals>.TreeBuilder.documentClasscsR|d}|d}|d}���}|�|||�}|j��|���tkrN|j|_dS)Nr �publicId�systemId)rKZcreateDocumentTypeZdocumentr4rrLr)r�tokenr rQrRZdomimplZdoctype)rOrFrr�
insertDoctype�sz0getDomBuilder.<locals>.TreeBuilder.insertDoctypeNcs6|dkr |jdkr |j�|�}n|j�||�}�|�Sr)ZdefaultNamespacerLZ
createElementZcreateElementNS)rr rHr6rErr�elementClass�sz/getDomBuilder.<locals>.TreeBuilder.elementClasscs�|j�|��Sr)rLZ
createComment)rr9rErr�commentClass�sz/getDomBuilder.<locals>.TreeBuilder.commentClasscs�|j���Sr)rLZcreateDocumentFragmentrrErr�
fragmentClass�sz0getDomBuilder.<locals>.TreeBuilder.fragmentClasscSs|j�|j�dSr)rLr4rr5rrrr4�sz.getDomBuilder.<locals>.TreeBuilder.appendChildcs�|�Srrr)�testSerializerrrrX�sz1getDomBuilder.<locals>.TreeBuilder.testSerializercSs|jSr)rLrrrr�getDocument�sz.getDomBuilder.<locals>.TreeBuilder.getDocumentcSstj�|�jSr)r	�TreeBuilder�getFragmentrrrrrr[�sz.getDomBuilder.<locals>.TreeBuilder.getFragmentcSsp|}||krtj�|||�nNt|jd�rXtj|jjkrXt|jj�|j_|jj�	tj�|j�
|j�|��dS)N�_child_node_types)r	rZr;r1rLr�	TEXT_NODEr\r%�appendr4r7)rr9r3rrrr;�sz-getDomBuilder.<locals>.TreeBuilder.insertText)N)N)r+r,r-rPrTrUrVrWr4rXrYr[r;�implementationr r)rO�DomImplementationrFrXrrrZ{s

rZcs0|��g�d��fdd�	��|d�d���S)Nrcs|jtjkr�|jrj|js|jrP|jp&d}|jp0d}��dd||j||f�q~��dd||jf�n��dd|f��nr|jtjkr���d��nX|jtjkr���d��n>|jtj	krވ�dd||j
f��n|jtjk�r��d	d||j
f�n�t|d
��r6|j
dk	�r6dtj|j
|jf}n|j}��dd||f�|���r�g}tt|j��D]T}|j�|�}|j}|j}|j
}	|	�r�dtj|	|jf}n|j}|�||f��qnt|�D]&\}}��d
d|d||f��q�|d7}|jD]}
�|
|��qdS)N�z|%s<!DOCTYPE %s "%s" "%s">� z|%s<!DOCTYPE %s>z|%s<!DOCTYPE >z	#documentz#document-fragmentz|%s<!-- %s -->z|%s"%s"r0z%s %sz|%s<%s>z
|%s%s="%s"r
)ZnodeTyperZDOCUMENT_TYPE_NODEr rQrRr^Z
DOCUMENT_NODEZDOCUMENT_FRAGMENT_NODEZCOMMENT_NODEZ	nodeValuer]r1r0r�prefixesr/Z
hasAttributes�ranger#r�itemrZ	localName�sortedr>)r�indentrQrRr r�ir!r�nsr?��rv�serializeElementrrrl�sT

���
 
z?getDomBuilder.<locals>.testSerializer.<locals>.serializeElement�
)r)Z	normalize�joinrrrjrrX�s
.
z%getDomBuilder.<locals>.testSerializer)rr	rrZ�locals)r`rZr)r.rOr`rFrXr�
getDomBuilders$C:6rp)Z
__future__rrrZcollections.abcr�ImportError�collectionsZxml.domrrrMrar	rrZ_utilsr
rpZgetDomModulerrrr�<module>s_site-packages/pip/_vendor/html5lib/treebuilders/__pycache__/__init__.cpython-38.pyc000064400000006330151446177000024327 0ustar00U

��.e�@s6dZddlmZmZmZddlmZiZddd�ZdS)	a)A collection of modules for building different kinds of trees from HTML
documents.

To create a treebuilder for a new type of tree, you need to do
implement several things:

1. A set of classes for various types of elements: Document, Doctype, Comment,
   Element. These must implement the interface of ``base.treebuilders.Node``
   (although comment nodes have a different signature for their constructor,
   see ``treebuilders.etree.Comment``) Textual content may also be implemented
   as another node type, or not, as your tree implementation requires.

2. A treebuilder object (called ``TreeBuilder`` by convention) that inherits
   from ``treebuilders.base.TreeBuilder``. This has 4 required attributes:

   * ``documentClass`` - the class to use for the bottommost node of a document
   * ``elementClass`` - the class to use for HTML Elements
   * ``commentClass`` - the class to use for comments
   * ``doctypeClass`` - the class to use for doctypes

   It also has one required method:

   * ``getDocument`` - Returns the root node of the complete document tree

3. If you wish to run the unit tests, you must also create a ``testSerializer``
   method on your treebuilder which accepts a node and returns a string
   containing Node and its children serialized according to the format used in
   the unittests

�)�absolute_import�division�unicode_literals�)�
default_etreeNcKs�|��}|tkr�|dkrLddlm}|dkr<ddlm}|}|j|f|�jS|dkrlddlm}|jt|<n<|d	kr�dd
lm	}|dkr�t
}|j|f|�jStd|��t�
|�S)aGet a TreeBuilder class for various types of trees with built-in support

    :arg treeType: the name of the tree type required (case-insensitive). Supported
        values are:

        * "dom" - A generic builder for DOM implementations, defaulting to a
          xml.dom.minidom based implementation.
        * "etree" - A generic builder for tree implementations exposing an
          ElementTree-like interface, defaulting to xml.etree.cElementTree if
          available and xml.etree.ElementTree if not.
        * "lxml" - A etree-based builder for lxml.etree, handling limitations
          of lxml's implementation.

    :arg implementation: (Currently applies to the "etree" and "dom" tree
        types). A module implementing the tree type e.g. xml.etree.ElementTree
        or xml.etree.cElementTree.

    :arg kwargs: Any additional options to pass to the TreeBuilder when
        creating it.

    Example:

    >>> from html5lib.treebuilders import getTreeBuilder
    >>> builder = getTreeBuilder('etree')

    �dom�)rNr)�minidomZlxml)�
etree_lxml�etree)rzUnrecognised treebuilder "%s" )�lower�treeBuilderCache�rZxml.domr	ZgetDomModuleZTreeBuilderr
rrZgetETreeModule�
ValueError�get)ZtreeType�implementation�kwargsrr	r
r�r�N/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treebuilders/__init__.py�getTreeBuilder's$r)N)	�__doc__Z
__future__rrrZ_utilsrr
rrrrr�<module>ssite-packages/pip/_vendor/html5lib/treebuilders/etree.py000064400000030734151446177000017413 0ustar00from __future__ import absolute_import, division, unicode_literals
# pylint:disable=protected-access

from pip._vendor.six import text_type

import re

from . import base
from .. import _ihatexml
from .. import constants
from ..constants import namespaces
from .._utils import moduleFactoryFactory

tag_regexp = re.compile("{([^}]*)}(.*)")


def getETreeBuilder(ElementTreeImplementation, fullTree=False):
    ElementTree = ElementTreeImplementation
    ElementTreeCommentType = ElementTree.Comment("asd").tag

    class Element(base.Node):
        def __init__(self, name, namespace=None):
            self._name = name
            self._namespace = namespace
            self._element = ElementTree.Element(self._getETreeTag(name,
                                                                  namespace))
            if namespace is None:
                self.nameTuple = namespaces["html"], self._name
            else:
                self.nameTuple = self._namespace, self._name
            self.parent = None
            self._childNodes = []
            self._flags = []

        def _getETreeTag(self, name, namespace):
            if namespace is None:
                etree_tag = name
            else:
                etree_tag = "{%s}%s" % (namespace, name)
            return etree_tag

        def _setName(self, name):
            self._name = name
            self._element.tag = self._getETreeTag(self._name, self._namespace)

        def _getName(self):
            return self._name

        name = property(_getName, _setName)

        def _setNamespace(self, namespace):
            self._namespace = namespace
            self._element.tag = self._getETreeTag(self._name, self._namespace)

        def _getNamespace(self):
            return self._namespace

        namespace = property(_getNamespace, _setNamespace)

        def _getAttributes(self):
            return self._element.attrib

        def _setAttributes(self, attributes):
            # Delete existing attributes first
            # XXX - there may be a better way to do this...
            for key in list(self._element.attrib.keys()):
                del self._element.attrib[key]
            for key, value in attributes.items():
                if isinstance(key, tuple):
                    name = "{%s}%s" % (key[2], key[1])
                else:
                    name = key
                self._element.set(name, value)

        attributes = property(_getAttributes, _setAttributes)

        def _getChildNodes(self):
            return self._childNodes

        def _setChildNodes(self, value):
            del self._element[:]
            self._childNodes = []
            for element in value:
                self.insertChild(element)

        childNodes = property(_getChildNodes, _setChildNodes)

        def hasContent(self):
            """Return true if the node has children or text"""
            return bool(self._element.text or len(self._element))

        def appendChild(self, node):
            self._childNodes.append(node)
            self._element.append(node._element)
            node.parent = self

        def insertBefore(self, node, refNode):
            index = list(self._element).index(refNode._element)
            self._element.insert(index, node._element)
            node.parent = self

        def removeChild(self, node):
            self._childNodes.remove(node)
            self._element.remove(node._element)
            node.parent = None

        def insertText(self, data, insertBefore=None):
            if not(len(self._element)):
                if not self._element.text:
                    self._element.text = ""
                self._element.text += data
            elif insertBefore is None:
                # Insert the text as the tail of the last child element
                if not self._element[-1].tail:
                    self._element[-1].tail = ""
                self._element[-1].tail += data
            else:
                # Insert the text before the specified node
                children = list(self._element)
                index = children.index(insertBefore._element)
                if index > 0:
                    if not self._element[index - 1].tail:
                        self._element[index - 1].tail = ""
                    self._element[index - 1].tail += data
                else:
                    if not self._element.text:
                        self._element.text = ""
                    self._element.text += data

        def cloneNode(self):
            element = type(self)(self.name, self.namespace)
            for name, value in self.attributes.items():
                element.attributes[name] = value
            return element

        def reparentChildren(self, newParent):
            if newParent.childNodes:
                newParent.childNodes[-1]._element.tail += self._element.text
            else:
                if not newParent._element.text:
                    newParent._element.text = ""
                if self._element.text is not None:
                    newParent._element.text += self._element.text
            self._element.text = ""
            base.Node.reparentChildren(self, newParent)

    class Comment(Element):
        def __init__(self, data):
            # Use the superclass constructor to set all properties on the
            # wrapper element
            self._element = ElementTree.Comment(data)
            self.parent = None
            self._childNodes = []
            self._flags = []

        def _getData(self):
            return self._element.text

        def _setData(self, value):
            self._element.text = value

        data = property(_getData, _setData)

    class DocumentType(Element):
        def __init__(self, name, publicId, systemId):
            Element.__init__(self, "<!DOCTYPE>")
            self._element.text = name
            self.publicId = publicId
            self.systemId = systemId

        def _getPublicId(self):
            return self._element.get("publicId", "")

        def _setPublicId(self, value):
            if value is not None:
                self._element.set("publicId", value)

        publicId = property(_getPublicId, _setPublicId)

        def _getSystemId(self):
            return self._element.get("systemId", "")

        def _setSystemId(self, value):
            if value is not None:
                self._element.set("systemId", value)

        systemId = property(_getSystemId, _setSystemId)

    class Document(Element):
        def __init__(self):
            Element.__init__(self, "DOCUMENT_ROOT")

    class DocumentFragment(Element):
        def __init__(self):
            Element.__init__(self, "DOCUMENT_FRAGMENT")

    def testSerializer(element):
        rv = []

        def serializeElement(element, indent=0):
            if not(hasattr(element, "tag")):
                element = element.getroot()
            if element.tag == "<!DOCTYPE>":
                if element.get("publicId") or element.get("systemId"):
                    publicId = element.get("publicId") or ""
                    systemId = element.get("systemId") or ""
                    rv.append("""<!DOCTYPE %s "%s" "%s">""" %
                              (element.text, publicId, systemId))
                else:
                    rv.append("<!DOCTYPE %s>" % (element.text,))
            elif element.tag == "DOCUMENT_ROOT":
                rv.append("#document")
                if element.text is not None:
                    rv.append("|%s\"%s\"" % (' ' * (indent + 2), element.text))
                if element.tail is not None:
                    raise TypeError("Document node cannot have tail")
                if hasattr(element, "attrib") and len(element.attrib):
                    raise TypeError("Document node cannot have attributes")
            elif element.tag == ElementTreeCommentType:
                rv.append("|%s<!-- %s -->" % (' ' * indent, element.text))
            else:
                assert isinstance(element.tag, text_type), \
                    "Expected unicode, got %s, %s" % (type(element.tag), element.tag)
                nsmatch = tag_regexp.match(element.tag)

                if nsmatch is None:
                    name = element.tag
                else:
                    ns, name = nsmatch.groups()
                    prefix = constants.prefixes[ns]
                    name = "%s %s" % (prefix, name)
                rv.append("|%s<%s>" % (' ' * indent, name))

                if hasattr(element, "attrib"):
                    attributes = []
                    for name, value in element.attrib.items():
                        nsmatch = tag_regexp.match(name)
                        if nsmatch is not None:
                            ns, name = nsmatch.groups()
                            prefix = constants.prefixes[ns]
                            attr_string = "%s %s" % (prefix, name)
                        else:
                            attr_string = name
                        attributes.append((attr_string, value))

                    for name, value in sorted(attributes):
                        rv.append('|%s%s="%s"' % (' ' * (indent + 2), name, value))
                if element.text:
                    rv.append("|%s\"%s\"" % (' ' * (indent + 2), element.text))
            indent += 2
            for child in element:
                serializeElement(child, indent)
            if element.tail:
                rv.append("|%s\"%s\"" % (' ' * (indent - 2), element.tail))
        serializeElement(element, 0)

        return "\n".join(rv)

    def tostring(element):  # pylint:disable=unused-variable
        """Serialize an element and its child nodes to a string"""
        rv = []
        filter = _ihatexml.InfosetFilter()

        def serializeElement(element):
            if isinstance(element, ElementTree.ElementTree):
                element = element.getroot()

            if element.tag == "<!DOCTYPE>":
                if element.get("publicId") or element.get("systemId"):
                    publicId = element.get("publicId") or ""
                    systemId = element.get("systemId") or ""
                    rv.append("""<!DOCTYPE %s PUBLIC "%s" "%s">""" %
                              (element.text, publicId, systemId))
                else:
                    rv.append("<!DOCTYPE %s>" % (element.text,))
            elif element.tag == "DOCUMENT_ROOT":
                if element.text is not None:
                    rv.append(element.text)
                if element.tail is not None:
                    raise TypeError("Document node cannot have tail")
                if hasattr(element, "attrib") and len(element.attrib):
                    raise TypeError("Document node cannot have attributes")

                for child in element:
                    serializeElement(child)

            elif element.tag == ElementTreeCommentType:
                rv.append("<!--%s-->" % (element.text,))
            else:
                # This is assumed to be an ordinary element
                if not element.attrib:
                    rv.append("<%s>" % (filter.fromXmlName(element.tag),))
                else:
                    attr = " ".join(["%s=\"%s\"" % (
                        filter.fromXmlName(name), value)
                        for name, value in element.attrib.items()])
                    rv.append("<%s %s>" % (element.tag, attr))
                if element.text:
                    rv.append(element.text)

                for child in element:
                    serializeElement(child)

                rv.append("</%s>" % (element.tag,))

            if element.tail:
                rv.append(element.tail)

        serializeElement(element)

        return "".join(rv)

    class TreeBuilder(base.TreeBuilder):  # pylint:disable=unused-variable
        documentClass = Document
        doctypeClass = DocumentType
        elementClass = Element
        commentClass = Comment
        fragmentClass = DocumentFragment
        implementation = ElementTreeImplementation

        def testSerializer(self, element):
            return testSerializer(element)

        def getDocument(self):
            if fullTree:
                return self.document._element
            else:
                if self.defaultNamespace is not None:
                    return self.document._element.find(
                        "{%s}html" % self.defaultNamespace)
                else:
                    return self.document._element.find("html")

        def getFragment(self):
            return base.TreeBuilder.getFragment(self)._element

    return locals()


getETreeModule = moduleFactoryFactory(getETreeBuilder)
site-packages/pip/_vendor/html5lib/treebuilders/dom.py000064400000021335151446177000017063 0ustar00from __future__ import absolute_import, division, unicode_literals


try:
    from collections.abc import MutableMapping
except ImportError:  # Python 2.7
    from collections import MutableMapping
from xml.dom import minidom, Node
import weakref

from . import base
from .. import constants
from ..constants import namespaces
from .._utils import moduleFactoryFactory


def getDomBuilder(DomImplementation):
    Dom = DomImplementation

    class AttrList(MutableMapping):
        def __init__(self, element):
            self.element = element

        def __iter__(self):
            return iter(self.element.attributes.keys())

        def __setitem__(self, name, value):
            if isinstance(name, tuple):
                raise NotImplementedError
            else:
                attr = self.element.ownerDocument.createAttribute(name)
                attr.value = value
                self.element.attributes[name] = attr

        def __len__(self):
            return len(self.element.attributes)

        def items(self):
            return list(self.element.attributes.items())

        def values(self):
            return list(self.element.attributes.values())

        def __getitem__(self, name):
            if isinstance(name, tuple):
                raise NotImplementedError
            else:
                return self.element.attributes[name].value

        def __delitem__(self, name):
            if isinstance(name, tuple):
                raise NotImplementedError
            else:
                del self.element.attributes[name]

    class NodeBuilder(base.Node):
        def __init__(self, element):
            base.Node.__init__(self, element.nodeName)
            self.element = element

        namespace = property(lambda self: hasattr(self.element, "namespaceURI") and
                             self.element.namespaceURI or None)

        def appendChild(self, node):
            node.parent = self
            self.element.appendChild(node.element)

        def insertText(self, data, insertBefore=None):
            text = self.element.ownerDocument.createTextNode(data)
            if insertBefore:
                self.element.insertBefore(text, insertBefore.element)
            else:
                self.element.appendChild(text)

        def insertBefore(self, node, refNode):
            self.element.insertBefore(node.element, refNode.element)
            node.parent = self

        def removeChild(self, node):
            if node.element.parentNode == self.element:
                self.element.removeChild(node.element)
            node.parent = None

        def reparentChildren(self, newParent):
            while self.element.hasChildNodes():
                child = self.element.firstChild
                self.element.removeChild(child)
                newParent.element.appendChild(child)
            self.childNodes = []

        def getAttributes(self):
            return AttrList(self.element)

        def setAttributes(self, attributes):
            if attributes:
                for name, value in list(attributes.items()):
                    if isinstance(name, tuple):
                        if name[0] is not None:
                            qualifiedName = (name[0] + ":" + name[1])
                        else:
                            qualifiedName = name[1]
                        self.element.setAttributeNS(name[2], qualifiedName,
                                                    value)
                    else:
                        self.element.setAttribute(
                            name, value)
        attributes = property(getAttributes, setAttributes)

        def cloneNode(self):
            return NodeBuilder(self.element.cloneNode(False))

        def hasContent(self):
            return self.element.hasChildNodes()

        def getNameTuple(self):
            if self.namespace is None:
                return namespaces["html"], self.name
            else:
                return self.namespace, self.name

        nameTuple = property(getNameTuple)

    class TreeBuilder(base.TreeBuilder):  # pylint:disable=unused-variable
        def documentClass(self):
            self.dom = Dom.getDOMImplementation().createDocument(None, None, None)
            return weakref.proxy(self)

        def insertDoctype(self, token):
            name = token["name"]
            publicId = token["publicId"]
            systemId = token["systemId"]

            domimpl = Dom.getDOMImplementation()
            doctype = domimpl.createDocumentType(name, publicId, systemId)
            self.document.appendChild(NodeBuilder(doctype))
            if Dom == minidom:
                doctype.ownerDocument = self.dom

        def elementClass(self, name, namespace=None):
            if namespace is None and self.defaultNamespace is None:
                node = self.dom.createElement(name)
            else:
                node = self.dom.createElementNS(namespace, name)

            return NodeBuilder(node)

        def commentClass(self, data):
            return NodeBuilder(self.dom.createComment(data))

        def fragmentClass(self):
            return NodeBuilder(self.dom.createDocumentFragment())

        def appendChild(self, node):
            self.dom.appendChild(node.element)

        def testSerializer(self, element):
            return testSerializer(element)

        def getDocument(self):
            return self.dom

        def getFragment(self):
            return base.TreeBuilder.getFragment(self).element

        def insertText(self, data, parent=None):
            data = data
            if parent != self:
                base.TreeBuilder.insertText(self, data, parent)
            else:
                # HACK: allow text nodes as children of the document node
                if hasattr(self.dom, '_child_node_types'):
                    # pylint:disable=protected-access
                    if Node.TEXT_NODE not in self.dom._child_node_types:
                        self.dom._child_node_types = list(self.dom._child_node_types)
                        self.dom._child_node_types.append(Node.TEXT_NODE)
                self.dom.appendChild(self.dom.createTextNode(data))

        implementation = DomImplementation
        name = None

    def testSerializer(element):
        element.normalize()
        rv = []

        def serializeElement(element, indent=0):
            if element.nodeType == Node.DOCUMENT_TYPE_NODE:
                if element.name:
                    if element.publicId or element.systemId:
                        publicId = element.publicId or ""
                        systemId = element.systemId or ""
                        rv.append("""|%s<!DOCTYPE %s "%s" "%s">""" %
                                  (' ' * indent, element.name, publicId, systemId))
                    else:
                        rv.append("|%s<!DOCTYPE %s>" % (' ' * indent, element.name))
                else:
                    rv.append("|%s<!DOCTYPE >" % (' ' * indent,))
            elif element.nodeType == Node.DOCUMENT_NODE:
                rv.append("#document")
            elif element.nodeType == Node.DOCUMENT_FRAGMENT_NODE:
                rv.append("#document-fragment")
            elif element.nodeType == Node.COMMENT_NODE:
                rv.append("|%s<!-- %s -->" % (' ' * indent, element.nodeValue))
            elif element.nodeType == Node.TEXT_NODE:
                rv.append("|%s\"%s\"" % (' ' * indent, element.nodeValue))
            else:
                if (hasattr(element, "namespaceURI") and
                        element.namespaceURI is not None):
                    name = "%s %s" % (constants.prefixes[element.namespaceURI],
                                      element.nodeName)
                else:
                    name = element.nodeName
                rv.append("|%s<%s>" % (' ' * indent, name))
                if element.hasAttributes():
                    attributes = []
                    for i in range(len(element.attributes)):
                        attr = element.attributes.item(i)
                        name = attr.nodeName
                        value = attr.value
                        ns = attr.namespaceURI
                        if ns:
                            name = "%s %s" % (constants.prefixes[ns], attr.localName)
                        else:
                            name = attr.nodeName
                        attributes.append((name, value))

                    for name, value in sorted(attributes):
                        rv.append('|%s%s="%s"' % (' ' * (indent + 2), name, value))
            indent += 2
            for child in element.childNodes:
                serializeElement(child, indent)
        serializeElement(element, 0)

        return "\n".join(rv)

    return locals()


# The actual means to get a module!
getDomModule = moduleFactoryFactory(getDomBuilder)
site-packages/pip/_vendor/html5lib/treebuilders/__init__.py000064400000007010151446177000020035 0ustar00"""A collection of modules for building different kinds of trees from HTML
documents.

To create a treebuilder for a new type of tree, you need to do
implement several things:

1. A set of classes for various types of elements: Document, Doctype, Comment,
   Element. These must implement the interface of ``base.treebuilders.Node``
   (although comment nodes have a different signature for their constructor,
   see ``treebuilders.etree.Comment``) Textual content may also be implemented
   as another node type, or not, as your tree implementation requires.

2. A treebuilder object (called ``TreeBuilder`` by convention) that inherits
   from ``treebuilders.base.TreeBuilder``. This has 4 required attributes:

   * ``documentClass`` - the class to use for the bottommost node of a document
   * ``elementClass`` - the class to use for HTML Elements
   * ``commentClass`` - the class to use for comments
   * ``doctypeClass`` - the class to use for doctypes

   It also has one required method:

   * ``getDocument`` - Returns the root node of the complete document tree

3. If you wish to run the unit tests, you must also create a ``testSerializer``
   method on your treebuilder which accepts a node and returns a string
   containing Node and its children serialized according to the format used in
   the unittests

"""

from __future__ import absolute_import, division, unicode_literals

from .._utils import default_etree

treeBuilderCache = {}


def getTreeBuilder(treeType, implementation=None, **kwargs):
    """Get a TreeBuilder class for various types of trees with built-in support

    :arg treeType: the name of the tree type required (case-insensitive). Supported
        values are:

        * "dom" - A generic builder for DOM implementations, defaulting to a
          xml.dom.minidom based implementation.
        * "etree" - A generic builder for tree implementations exposing an
          ElementTree-like interface, defaulting to xml.etree.cElementTree if
          available and xml.etree.ElementTree if not.
        * "lxml" - A etree-based builder for lxml.etree, handling limitations
          of lxml's implementation.

    :arg implementation: (Currently applies to the "etree" and "dom" tree
        types). A module implementing the tree type e.g. xml.etree.ElementTree
        or xml.etree.cElementTree.

    :arg kwargs: Any additional options to pass to the TreeBuilder when
        creating it.

    Example:

    >>> from html5lib.treebuilders import getTreeBuilder
    >>> builder = getTreeBuilder('etree')

    """

    treeType = treeType.lower()
    if treeType not in treeBuilderCache:
        if treeType == "dom":
            from . import dom
            # Come up with a sane default (pref. from the stdlib)
            if implementation is None:
                from xml.dom import minidom
                implementation = minidom
            # NEVER cache here, caching is done in the dom submodule
            return dom.getDomModule(implementation, **kwargs).TreeBuilder
        elif treeType == "lxml":
            from . import etree_lxml
            treeBuilderCache[treeType] = etree_lxml.TreeBuilder
        elif treeType == "etree":
            from . import etree
            if implementation is None:
                implementation = default_etree
            # NEVER cache here, caching is done in the etree submodule
            return etree.getETreeModule(implementation, **kwargs).TreeBuilder
        else:
            raise ValueError("""Unrecognised treebuilder "%s" """ % treeType)
    return treeBuilderCache.get(treeType)
site-packages/pip/_vendor/html5lib/treewalkers/base.py000064400000016464151446177000017064 0ustar00from __future__ import absolute_import, division, unicode_literals

from xml.dom import Node
from ..constants import namespaces, voidElements, spaceCharacters

__all__ = ["DOCUMENT", "DOCTYPE", "TEXT", "ELEMENT", "COMMENT", "ENTITY", "UNKNOWN",
           "TreeWalker", "NonRecursiveTreeWalker"]

DOCUMENT = Node.DOCUMENT_NODE
DOCTYPE = Node.DOCUMENT_TYPE_NODE
TEXT = Node.TEXT_NODE
ELEMENT = Node.ELEMENT_NODE
COMMENT = Node.COMMENT_NODE
ENTITY = Node.ENTITY_NODE
UNKNOWN = "<#UNKNOWN#>"

spaceCharacters = "".join(spaceCharacters)


class TreeWalker(object):
    """Walks a tree yielding tokens

    Tokens are dicts that all have a ``type`` field specifying the type of the
    token.

    """
    def __init__(self, tree):
        """Creates a TreeWalker

        :arg tree: the tree to walk

        """
        self.tree = tree

    def __iter__(self):
        raise NotImplementedError

    def error(self, msg):
        """Generates an error token with the given message

        :arg msg: the error message

        :returns: SerializeError token

        """
        return {"type": "SerializeError", "data": msg}

    def emptyTag(self, namespace, name, attrs, hasChildren=False):
        """Generates an EmptyTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :arg attrs: the attributes of the element as a dict

        :arg hasChildren: whether or not to yield a SerializationError because
            this tag shouldn't have children

        :returns: EmptyTag token

        """
        yield {"type": "EmptyTag", "name": name,
               "namespace": namespace,
               "data": attrs}
        if hasChildren:
            yield self.error("Void element has children")

    def startTag(self, namespace, name, attrs):
        """Generates a StartTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :arg attrs: the attributes of the element as a dict

        :returns: StartTag token

        """
        return {"type": "StartTag",
                "name": name,
                "namespace": namespace,
                "data": attrs}

    def endTag(self, namespace, name):
        """Generates an EndTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :returns: EndTag token

        """
        return {"type": "EndTag",
                "name": name,
                "namespace": namespace}

    def text(self, data):
        """Generates SpaceCharacters and Characters tokens

        Depending on what's in the data, this generates one or more
        ``SpaceCharacters`` and ``Characters`` tokens.

        For example:

            >>> from html5lib.treewalkers.base import TreeWalker
            >>> # Give it an empty tree just so it instantiates
            >>> walker = TreeWalker([])
            >>> list(walker.text(''))
            []
            >>> list(walker.text('  '))
            [{u'data': '  ', u'type': u'SpaceCharacters'}]
            >>> list(walker.text(' abc '))  # doctest: +NORMALIZE_WHITESPACE
            [{u'data': ' ', u'type': u'SpaceCharacters'},
            {u'data': u'abc', u'type': u'Characters'},
            {u'data': u' ', u'type': u'SpaceCharacters'}]

        :arg data: the text data

        :returns: one or more ``SpaceCharacters`` and ``Characters`` tokens

        """
        data = data
        middle = data.lstrip(spaceCharacters)
        left = data[:len(data) - len(middle)]
        if left:
            yield {"type": "SpaceCharacters", "data": left}
        data = middle
        middle = data.rstrip(spaceCharacters)
        right = data[len(middle):]
        if middle:
            yield {"type": "Characters", "data": middle}
        if right:
            yield {"type": "SpaceCharacters", "data": right}

    def comment(self, data):
        """Generates a Comment token

        :arg data: the comment

        :returns: Comment token

        """
        return {"type": "Comment", "data": data}

    def doctype(self, name, publicId=None, systemId=None):
        """Generates a Doctype token

        :arg name:

        :arg publicId:

        :arg systemId:

        :returns: the Doctype token

        """
        return {"type": "Doctype",
                "name": name,
                "publicId": publicId,
                "systemId": systemId}

    def entity(self, name):
        """Generates an Entity token

        :arg name: the entity name

        :returns: an Entity token

        """
        return {"type": "Entity", "name": name}

    def unknown(self, nodeType):
        """Handles unknown node types"""
        return self.error("Unknown node type: " + nodeType)


class NonRecursiveTreeWalker(TreeWalker):
    def getNodeDetails(self, node):
        raise NotImplementedError

    def getFirstChild(self, node):
        raise NotImplementedError

    def getNextSibling(self, node):
        raise NotImplementedError

    def getParentNode(self, node):
        raise NotImplementedError

    def __iter__(self):
        currentNode = self.tree
        while currentNode is not None:
            details = self.getNodeDetails(currentNode)
            type, details = details[0], details[1:]
            hasChildren = False

            if type == DOCTYPE:
                yield self.doctype(*details)

            elif type == TEXT:
                for token in self.text(*details):
                    yield token

            elif type == ELEMENT:
                namespace, name, attributes, hasChildren = details
                if (not namespace or namespace == namespaces["html"]) and name in voidElements:
                    for token in self.emptyTag(namespace, name, attributes,
                                               hasChildren):
                        yield token
                    hasChildren = False
                else:
                    yield self.startTag(namespace, name, attributes)

            elif type == COMMENT:
                yield self.comment(details[0])

            elif type == ENTITY:
                yield self.entity(details[0])

            elif type == DOCUMENT:
                hasChildren = True

            else:
                yield self.unknown(details[0])

            if hasChildren:
                firstChild = self.getFirstChild(currentNode)
            else:
                firstChild = None

            if firstChild is not None:
                currentNode = firstChild
            else:
                while currentNode is not None:
                    details = self.getNodeDetails(currentNode)
                    type, details = details[0], details[1:]
                    if type == ELEMENT:
                        namespace, name, attributes, hasChildren = details
                        if (namespace and namespace != namespaces["html"]) or name not in voidElements:
                            yield self.endTag(namespace, name)
                    if self.tree is currentNode:
                        currentNode = None
                        break
                    nextSibling = self.getNextSibling(currentNode)
                    if nextSibling is not None:
                        currentNode = nextSibling
                        break
                    else:
                        currentNode = self.getParentNode(currentNode)
site-packages/pip/_vendor/html5lib/treewalkers/genshi.py000064400000004405151446177000017417 0ustar00from __future__ import absolute_import, division, unicode_literals

from genshi.core import QName
from genshi.core import START, END, XML_NAMESPACE, DOCTYPE, TEXT
from genshi.core import START_NS, END_NS, START_CDATA, END_CDATA, PI, COMMENT

from . import base

from ..constants import voidElements, namespaces


class TreeWalker(base.TreeWalker):
    def __iter__(self):
        # Buffer the events so we can pass in the following one
        previous = None
        for event in self.tree:
            if previous is not None:
                for token in self.tokens(previous, event):
                    yield token
            previous = event

        # Don't forget the final event!
        if previous is not None:
            for token in self.tokens(previous, None):
                yield token

    def tokens(self, event, next):
        kind, data, _ = event
        if kind == START:
            tag, attribs = data
            name = tag.localname
            namespace = tag.namespace
            converted_attribs = {}
            for k, v in attribs:
                if isinstance(k, QName):
                    converted_attribs[(k.namespace, k.localname)] = v
                else:
                    converted_attribs[(None, k)] = v

            if namespace == namespaces["html"] and name in voidElements:
                for token in self.emptyTag(namespace, name, converted_attribs,
                                           not next or next[0] != END or
                                           next[1] != tag):
                    yield token
            else:
                yield self.startTag(namespace, name, converted_attribs)

        elif kind == END:
            name = data.localname
            namespace = data.namespace
            if namespace != namespaces["html"] or name not in voidElements:
                yield self.endTag(namespace, name)

        elif kind == COMMENT:
            yield self.comment(data)

        elif kind == TEXT:
            for token in self.text(data):
                yield token

        elif kind == DOCTYPE:
            yield self.doctype(*data)

        elif kind in (XML_NAMESPACE, DOCTYPE, START_NS, END_NS,
                      START_CDATA, END_CDATA, PI):
            pass

        else:
            yield self.unknown(kind)
site-packages/pip/_vendor/html5lib/treewalkers/etree_lxml.py000064400000014245151446177000020305 0ustar00from __future__ import absolute_import, division, unicode_literals
from pip._vendor.six import text_type

from lxml import etree
from ..treebuilders.etree import tag_regexp

from . import base

from .. import _ihatexml


def ensure_str(s):
    if s is None:
        return None
    elif isinstance(s, text_type):
        return s
    else:
        return s.decode("ascii", "strict")


class Root(object):
    def __init__(self, et):
        self.elementtree = et
        self.children = []

        try:
            if et.docinfo.internalDTD:
                self.children.append(Doctype(self,
                                             ensure_str(et.docinfo.root_name),
                                             ensure_str(et.docinfo.public_id),
                                             ensure_str(et.docinfo.system_url)))
        except AttributeError:
            pass

        try:
            node = et.getroot()
        except AttributeError:
            node = et

        while node.getprevious() is not None:
            node = node.getprevious()
        while node is not None:
            self.children.append(node)
            node = node.getnext()

        self.text = None
        self.tail = None

    def __getitem__(self, key):
        return self.children[key]

    def getnext(self):
        return None

    def __len__(self):
        return 1


class Doctype(object):
    def __init__(self, root_node, name, public_id, system_id):
        self.root_node = root_node
        self.name = name
        self.public_id = public_id
        self.system_id = system_id

        self.text = None
        self.tail = None

    def getnext(self):
        return self.root_node.children[1]


class FragmentRoot(Root):
    def __init__(self, children):
        self.children = [FragmentWrapper(self, child) for child in children]
        self.text = self.tail = None

    def getnext(self):
        return None


class FragmentWrapper(object):
    def __init__(self, fragment_root, obj):
        self.root_node = fragment_root
        self.obj = obj
        if hasattr(self.obj, 'text'):
            self.text = ensure_str(self.obj.text)
        else:
            self.text = None
        if hasattr(self.obj, 'tail'):
            self.tail = ensure_str(self.obj.tail)
        else:
            self.tail = None

    def __getattr__(self, name):
        return getattr(self.obj, name)

    def getnext(self):
        siblings = self.root_node.children
        idx = siblings.index(self)
        if idx < len(siblings) - 1:
            return siblings[idx + 1]
        else:
            return None

    def __getitem__(self, key):
        return self.obj[key]

    def __bool__(self):
        return bool(self.obj)

    def getparent(self):
        return None

    def __str__(self):
        return str(self.obj)

    def __unicode__(self):
        return str(self.obj)

    def __len__(self):
        return len(self.obj)


class TreeWalker(base.NonRecursiveTreeWalker):
    def __init__(self, tree):
        # pylint:disable=redefined-variable-type
        if isinstance(tree, list):
            self.fragmentChildren = set(tree)
            tree = FragmentRoot(tree)
        else:
            self.fragmentChildren = set()
            tree = Root(tree)
        base.NonRecursiveTreeWalker.__init__(self, tree)
        self.filter = _ihatexml.InfosetFilter()

    def getNodeDetails(self, node):
        if isinstance(node, tuple):  # Text node
            node, key = node
            assert key in ("text", "tail"), "Text nodes are text or tail, found %s" % key
            return base.TEXT, ensure_str(getattr(node, key))

        elif isinstance(node, Root):
            return (base.DOCUMENT,)

        elif isinstance(node, Doctype):
            return base.DOCTYPE, node.name, node.public_id, node.system_id

        elif isinstance(node, FragmentWrapper) and not hasattr(node, "tag"):
            return base.TEXT, ensure_str(node.obj)

        elif node.tag == etree.Comment:
            return base.COMMENT, ensure_str(node.text)

        elif node.tag == etree.Entity:
            return base.ENTITY, ensure_str(node.text)[1:-1]  # strip &;

        else:
            # This is assumed to be an ordinary element
            match = tag_regexp.match(ensure_str(node.tag))
            if match:
                namespace, tag = match.groups()
            else:
                namespace = None
                tag = ensure_str(node.tag)
            attrs = {}
            for name, value in list(node.attrib.items()):
                name = ensure_str(name)
                value = ensure_str(value)
                match = tag_regexp.match(name)
                if match:
                    attrs[(match.group(1), match.group(2))] = value
                else:
                    attrs[(None, name)] = value
            return (base.ELEMENT, namespace, self.filter.fromXmlName(tag),
                    attrs, len(node) > 0 or node.text)

    def getFirstChild(self, node):
        assert not isinstance(node, tuple), "Text nodes have no children"

        assert len(node) or node.text, "Node has no children"
        if node.text:
            return (node, "text")
        else:
            return node[0]

    def getNextSibling(self, node):
        if isinstance(node, tuple):  # Text node
            node, key = node
            assert key in ("text", "tail"), "Text nodes are text or tail, found %s" % key
            if key == "text":
                # XXX: we cannot use a "bool(node) and node[0] or None" construct here
                # because node[0] might evaluate to False if it has no child element
                if len(node):
                    return node[0]
                else:
                    return None
            else:  # tail
                return node.getnext()

        return (node, "tail") if node.tail else node.getnext()

    def getParentNode(self, node):
        if isinstance(node, tuple):  # Text node
            node, key = node
            assert key in ("text", "tail"), "Text nodes are text or tail, found %s" % key
            if key == "text":
                return node
            # else: fallback to "normal" processing
        elif node in self.fragmentChildren:
            return None

        return node.getparent()
site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/__init__.cpython-38.opt-1.pyc000064400000007436151446177000025135 0ustar00U

��.eR�@sZdZddlmZmZmZddlmZddlmZddgZ	iZ
d
d	d�Zd
d�Zdd�Z
dS)a�A collection of modules for iterating through different kinds of
tree, generating tokens identical to those produced by the tokenizer
module.

To create a tree walker for a new type of tree, you need to do
implement a tree walker object (called TreeWalker by convention) that
implements a 'serialize' method taking a tree as sole argument and
returning an iterator generating tokens.
�)�absolute_import�division�unicode_literals�)�	constants)�
default_etree�
getTreeWalker�pprintNcKs�|��}|tkr�|dkr0ddlm}|jt|<np|dkrPddlm}|jt|<nP|dkrpddlm}|jt|<n0|dkr�dd	lm}|d
kr�t}|j	|f|�jSt�
|�S)a;Get a TreeWalker class for various types of tree with built-in support

    :arg str treeType: the name of the tree type required (case-insensitive).
        Supported values are:

        * "dom": The xml.dom.minidom DOM implementation
        * "etree": A generic walker for tree implementations exposing an
          elementtree-like interface (known to work with ElementTree,
          cElementTree and lxml.etree).
        * "lxml": Optimized walker for lxml.etree
        * "genshi": a Genshi stream

    :arg implementation: A module implementing the tree type e.g.
        xml.etree.ElementTree or cElementTree (Currently applies to the "etree"
        tree type only).

    :arg kwargs: keyword arguments passed to the etree walker--for other
        walkers, this has no effect

    :returns: a TreeWalker class

    �dom�)r
�genshi)rZlxml)�
etree_lxml�etree)rN)�lower�treeWalkerCache�r
Z
TreeWalkerrr
rrZgetETreeModule�get)ZtreeType�implementation�kwargsr
rr
r�r�M/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/__init__.pyrs"ccshg}|D]D}|d}|dkr,|�|d�q|rFdd�|�d�Vg}|Vq|rddd�|�d�VdS)N�type)�
Characters�SpaceCharacters�datarr)rr)�append�join)�tokensZpendingCharacters�tokenrrrr�concatenateCharacterTokensAsrc	CsTg}d}t|�D�]6}|d}|dk�r|drz|dtjdkrz|dtjkr`tj|d}n|d}d||df}n|d}|�dd	||f�|d
7}|d}t|���D]T\\}}	}
|r�|tjkr�tj|}n|}d||	f}n|	}|�dd	|||
f�q�|d
k�rH|d
8}q|dk�r2|d
8}q|dk�rX|�dd	||df�q|dk�r
|d�r�|d�r�|�dd	||d|d|d�r�|dndf�nF|d�r�|�dd	||d|df�n|�dd	||df�n|�dd	|f�q|dk�r0|�dd	||df�q|dk�r<qtd|��qd�|�S)z�Pretty printer for tree walkers

    Takes a TreeWalker instance and pretty prints the output of walking the tree.

    :arg walker: a TreeWalker instance

    rr)ZStartTag�EmptyTag�	namespaceZhtmlz%s %s�namez%s<%s>� rrz	%s%s="%s"r ZEndTag�Commentz
%s<!-- %s -->ZDoctypeZpublicIdz%s<!DOCTYPE %s "%s" "%s">ZsystemIdrz%s<!DOCTYPE %s "" "%s">z%s<!DOCTYPE %s>z
%s<!DOCTYPE >rz%s"%s"rzUnknown token type, %s�
)	rrZ
namespaces�prefixesr�sorted�items�
ValueErrorr)Zwalker�output�indentrr�nsr"Zattrsr!Z	localname�valuerrrr	Psn









��
���


)N)�__doc__Z
__future__rrrrrZ_utilsr�__all__rrrr	rrrr�<module>s

,site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/dom.cpython-38.pyc000064400000003242151446177000023205 0ustar00U

��.e��@sBddlmZmZmZddlmZddlmZGdd�dej�Z	dS)�)�absolute_import�division�unicode_literals)�Node�)�basec@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�
TreeWalkercCs�|jtjkr tj|j|j|jfS|jtjtj	fkr>tj
|jfS|jtjkr�i}t
|j���D]8}|�|�}|jr�|j||j|jf<q\|j|d|jf<q\tj|j|j||��fS|jtjkr�tj|jfS|jtjtjfkr�tjfStj|jfSdS�N)ZnodeTyperZDOCUMENT_TYPE_NODErZDOCTYPE�nameZpublicIdZsystemIdZ	TEXT_NODEZCDATA_SECTION_NODEZTEXTZ	nodeValueZELEMENT_NODE�listZ
attributes�keysZgetAttributeNodeZnamespaceURI�valueZ	localNameZELEMENTZnodeNameZ
hasChildNodesZCOMMENT_NODE�COMMENTZ
DOCUMENT_NODEZDOCUMENT_FRAGMENT_NODEZDOCUMENTZUNKNOWN)�self�nodeZattrs�attr�r�H/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/dom.py�getNodeDetails	s(
�zTreeWalker.getNodeDetailscCs|jSr	)Z
firstChild�rrrrr�
getFirstChild$szTreeWalker.getFirstChildcCs|jSr	)ZnextSiblingrrrr�getNextSibling'szTreeWalker.getNextSiblingcCs|jSr	)Z
parentNoderrrr�
getParentNode*szTreeWalker.getParentNodeN)�__name__�
__module__�__qualname__rrrrrrrrrsrN)
Z
__future__rrrZxml.domr�rZNonRecursiveTreeWalkerrrrrr�<module>ssite-packages/pip/_vendor/html5lib/treewalkers/__pycache__/etree.cpython-38.opt-1.pyc000064400000006467151446177000024505 0ustar00U

��.e��@sjddlmZmZmZddlmZddlZddlmZddl	m
Z
ddlmZe�
d	�Zd
d�Zee�ZdS)�)�absolute_import�division�unicode_literals)�OrderedDictN)�string_types�)�base�)�moduleFactoryFactoryz
{([^}]*)}(.*)cs,|}|�d�j�G�fdd�dtj�}t�S)NZasdcs4eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
S)z#getETreeBuilder.<locals>.TreeWalkera�Given the particular ElementTree representation, this implementation,
        to avoid using recursion, returns "nodes" as tuples with the following
        content:

        1. The current element

        2. The index of the element relative to its parent

        3. A stack of ancestor elements

        4. A flag "text", "tail" or None to indicate if the current node is a
           text node; either the text or tail of the current element (1)
        cs.t|t�r2|\}}}}|dkr.tjt||�fS|}t|d�sD|��}|jdkrVtjfS|jdkr|tj	|j
|�d�|�d�fS|j�kr�tj|j
fSt
�|j�}|r�|��\}}n
d}|j}t�}t|j���D]>\}	}
t
�|	�}|�r|
||�d�|�d�f<q�|
|d|	f<q�tj|||t|��p&|j
fSdS)	N��text�tail�tag)Z
DOCUMENT_ROOTZDOCUMENT_FRAGMENTz
<!DOCTYPE>ZpublicIdZsystemIdrr	)�
isinstance�tuplerZTEXT�getattr�hasattrZgetrootrZDOCUMENTZDOCTYPEr�get�COMMENT�
tag_regexp�match�groupsr�listZattrib�items�groupZELEMENT�len)�self�nodeZelt�_�flagr�	namespacerZattrs�name�value�ZElementTreeCommentType��J/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/etree.py�getNodeDetails s>



�

�z2getETreeBuilder.<locals>.TreeWalker.getNodeDetailscSstt|t�r|\}}}}n|dgdf\}}}}|dkr8dS|jrJ|||dfSt|�rl|�|�|dd|dfSdSdS)Nrrr)rrrr�append�rr�element�key�parentsrr$r$r%�
getFirstChildHs

z1getETreeBuilder.<locals>.TreeWalker.getFirstChildcSs�t|t�r|\}}}}ndS|dkrLt|�rF|�|�|dd|dfSdSnN|jrf|dkrf|||dfS|t|d�dkr�|d|d|d|dfSdSdS)Nrrr
���r)rrrr'r
r(r$r$r%�getNextSiblingYs

z2getETreeBuilder.<locals>.TreeWalker.getNextSiblingcSsht|t�r|\}}}}ndS|dkr:|s,|S|||dfSn*|��}|sJ|S|t|d��|�|dfSdS)Nrr-)rr�popr�index)rrr)r*r+r�parentr$r$r%�
getParentNodems
z1getETreeBuilder.<locals>.TreeWalker.getParentNodeN)�__name__�
__module__�__qualname__�__doc__r&r,r.r2r$r#r$r%�
TreeWalkers

(r7)�CommentrrZNonRecursiveTreeWalker�locals)ZElementTreeImplementationZElementTreer7r$r#r%�getETreeBuildersnr:)Z
__future__rrr�collectionsr�reZpip._vendor.sixr�rZ_utilsr
�compilerr:ZgetETreeModuler$r$r$r%�<module>s
tsite-packages/pip/_vendor/html5lib/treewalkers/__pycache__/etree_lxml.cpython-38.pyc000064400000014666151446177000024602 0ustar00U

��.e��@s�ddlmZmZmZddlmZddlmZddlm	Z	ddl
mZddl
mZd	d
�Z
Gdd�de�ZGd
d�de�ZGdd�de�ZGdd�de�ZGdd�dej�ZdS)�)�absolute_import�division�unicode_literals)�	text_type)�etree�)�
tag_regexp�)�base)�	_ihatexmlcCs*|dkrdSt|t�r|S|�dd�SdS)N�ascii�strict)�
isinstancer�decode)�s�r�O/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/etree_lxml.py�
ensure_strs

rc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�RootcCs�||_g|_z:|jjrD|j�t|t|jj�t|jj�t|jj	���Wnt
k
rZYnXz|��}Wnt
k
r�|}YnX|��dk	r�|��}q�|dk	r�|j�|�|�
�}q�d|_d|_dS�N)Zelementtree�childrenZdocinfoZinternalDTD�append�DoctyperZ	root_name�	public_idZ
system_url�AttributeErrorZgetrootZgetprevious�getnext�text�tail)�selfZet�noderrr�__init__s,



�



z
Root.__init__cCs
|j|Sr)r�r�keyrrr�__getitem__1szRoot.__getitem__cCsdSrr�rrrrr4szRoot.getnextcCsdS�Nr	rr$rrr�__len__7szRoot.__len__N)�__name__�
__module__�__qualname__r r#rr&rrrrrsrc@seZdZdd�Zdd�ZdS)rcCs(||_||_||_||_d|_d|_dSr)�	root_node�namer�	system_idrr)rr*r+rr,rrrr <szDoctype.__init__cCs|jjdSr%)r*rr$rrrrEszDoctype.getnextN�r'r(r)r rrrrrr;s	rc@seZdZdd�Zdd�ZdS)�FragmentRootcs$�fdd�|D��_d�_�_dS)Ncsg|]}t�|��qSr)�FragmentWrapper)�.0Zchildr$rr�
<listcomp>Ksz)FragmentRoot.__init__.<locals>.<listcomp>)rrr)rrrr$rr JszFragmentRoot.__init__cCsdSrrr$rrrrNszFragmentRoot.getnextNr-rrrrr.Isr.c@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)r/cCsT||_||_t|jd�r(t|jj�|_nd|_t|jd�rJt|jj�|_nd|_dS)Nrr)r*�obj�hasattrrrr)rZ
fragment_rootr2rrrr SszFragmentWrapper.__init__cCst|j|�Sr)�getattrr2)rr+rrr�__getattr___szFragmentWrapper.__getattr__cCs6|jj}|�|�}|t|�dkr.||dSdSdSr%)r*r�index�len)rZsiblings�idxrrrrbs

zFragmentWrapper.getnextcCs
|j|Sr)r2r!rrrr#jszFragmentWrapper.__getitem__cCs
t|j�Sr)�boolr2r$rrr�__bool__mszFragmentWrapper.__bool__cCsdSrrr$rrr�	getparentpszFragmentWrapper.getparentcCs
t|j�Sr��strr2r$rrr�__str__sszFragmentWrapper.__str__cCs
t|j�Srr<r$rrr�__unicode__vszFragmentWrapper.__unicode__cCs
t|j�Sr)r7r2r$rrrr&yszFragmentWrapper.__len__N)r'r(r)r r5rr#r:r;r>r?r&rrrrr/Rsr/c@s4eZdZdd�Zdd�Zdd�Zdd�Zd	d
�ZdS)�
TreeWalkercCsJt|t�rt|�|_t|�}nt�|_t|�}tj�||�t	�
�|_dSr)r�list�set�fragmentChildrenr.rr
�NonRecursiveTreeWalkerr rZ
InfosetFilter�filter)rZtreerrrr ~s


zTreeWalker.__init__c	Cs�t|t�r:|\}}|dks&td|��tjtt||��fSt|t�rLtjfSt|t	�rjtj
|j|j|j
fSt|t�r�t|d�s�tjt|j�fS|jtjkr�tjt|j�fS|jtjkr�tjt|j�dd�fSt�t|j��}|�r�|��\}}nd}t|j�}i}t|j���D]P\}}t|�}t|�}t�|�}|�rT|||�d�|�d�f<n||d|f<�qtj||j �!|�|t"|�dk�p�|jfSdS)N�rr�%Text nodes are text or tail, found %s�tagr	���rr)#r�tuple�AssertionErrorr
ZTEXTrr4rZDOCUMENTrZDOCTYPEr+rr,r/r3r2rHr�Comment�COMMENTrZEntityZENTITYr�match�groupsrAZattrib�items�groupZELEMENTrEZfromXmlNamer7)	rrr"rN�	namespacerHZattrsr+�valuerrr�getNodeDetails�s>




�zTreeWalker.getNodeDetailscCsBt|t�rtd��t|�s(|js(td��|jr6|dfS|dSdS)NzText nodes have no childrenzNode has no childrenrr)rrJrKr7r)rrrrr�
getFirstChild�s
zTreeWalker.getFirstChildcCsbt|t�rL|\}}|dks&td|��|dkrDt|�r>|dSdSn|��S|jrZ|dfS|��S)NrFrGrrr)rrJrKr7rr�rrr"rrr�getNextSibling�s
zTreeWalker.getNextSiblingcCsJt|t�r4|\}}|dks&td|��|dkrB|Sn||jkrBdS|��S)NrFrGr)rrJrKrCr;rVrrr�
getParentNode�s

zTreeWalker.getParentNodeN)r'r(r)r rTrUrWrXrrrrr@}s
)	r@N)Z
__future__rrrZpip._vendor.sixrZlxmlrZtreebuilders.etreer�r
rr�objectrrr.r/rDr@rrrr�<module>s	&	+site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/base.cpython-38.pyc000064400000015471151446177000023347 0ustar00U

��.e4�	@s�ddlmZmZmZddlmZddlmZmZm	Z	ddddd	d
ddd
g	Z
ejZej
ZejZejZejZejZdZd�e	�Z	Gdd�de�ZGdd
�d
e�ZdS)�)�absolute_import�division�unicode_literals)�Node�)�
namespaces�voidElements�spaceCharacters�DOCUMENT�DOCTYPE�TEXT�ELEMENT�COMMENT�ENTITY�UNKNOWN�
TreeWalker�NonRecursiveTreeWalkerz<#UNKNOWN#>�c@sleZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zddd�Zdd�Z
dd�ZdS)rz}Walks a tree yielding tokens

    Tokens are dicts that all have a ``type`` field specifying the type of the
    token.

    cCs
||_dS)zCCreates a TreeWalker

        :arg tree: the tree to walk

        N)�tree)�selfr�r�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/base.py�__init__szTreeWalker.__init__cCst�dS�N��NotImplementedError)rrrr�__iter__#szTreeWalker.__iter__cCs
d|d�S)z�Generates an error token with the given message

        :arg msg: the error message

        :returns: SerializeError token

        ZSerializeError��type�datar)r�msgrrr�error&szTreeWalker.errorFccs$d|||d�V|r |�d�VdS)arGenerates an EmptyTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :arg attrs: the attributes of the element as a dict

        :arg hasChildren: whether or not to yield a SerializationError because
            this tag shouldn't have children

        :returns: EmptyTag token

        ZEmptyTag�r�name�	namespacerzVoid element has childrenN�r!)rr$r#�attrs�hasChildrenrrr�emptyTag0s�zTreeWalker.emptyTagcCsd|||d�S)z�Generates a StartTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :arg attrs: the attributes of the element as a dict

        :returns: StartTag token

        ZStartTagr"r)rr$r#r&rrr�startTagEs
�zTreeWalker.startTagcCsd||d�S)z�Generates an EndTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :returns: EndTag token

        ZEndTag)rr#r$r)rr$r#rrr�endTagVs
�zTreeWalker.endTagccsx|}|�t�}|dt|�t|��}|r6d|d�V|}|�t�}|t|�d�}|rdd|d�V|rtd|d�VdS)atGenerates SpaceCharacters and Characters tokens

        Depending on what's in the data, this generates one or more
        ``SpaceCharacters`` and ``Characters`` tokens.

        For example:

            >>> from html5lib.treewalkers.base import TreeWalker
            >>> # Give it an empty tree just so it instantiates
            >>> walker = TreeWalker([])
            >>> list(walker.text(''))
            []
            >>> list(walker.text('  '))
            [{u'data': '  ', u'type': u'SpaceCharacters'}]
            >>> list(walker.text(' abc '))  # doctest: +NORMALIZE_WHITESPACE
            [{u'data': ' ', u'type': u'SpaceCharacters'},
            {u'data': u'abc', u'type': u'Characters'},
            {u'data': u' ', u'type': u'SpaceCharacters'}]

        :arg data: the text data

        :returns: one or more ``SpaceCharacters`` and ``Characters`` tokens

        NZSpaceCharactersrZ
Characters)�lstripr	�len�rstrip)rrZmiddle�left�rightrrr�textds

zTreeWalker.textcCs
d|d�S)zdGenerates a Comment token

        :arg data: the comment

        :returns: Comment token

        �Commentrr)rrrrr�comment�szTreeWalker.commentNcCsd|||d�S)z�Generates a Doctype token

        :arg name:

        :arg publicId:

        :arg systemId:

        :returns: the Doctype token

        ZDoctype)rr#�publicId�systemIdr)rr#r3r4rrr�doctype�s
�zTreeWalker.doctypecCs
d|d�S)zjGenerates an Entity token

        :arg name: the entity name

        :returns: an Entity token

        ZEntity)rr#r)rr#rrr�entity�szTreeWalker.entitycCs|�d|�S)zHandles unknown node typeszUnknown node type: r%)rZnodeTyperrr�unknown�szTreeWalker.unknown)F)NN)�__name__�
__module__�__qualname__�__doc__rrr!r(r)r*r0r2r5r6r7rrrrrs

&


c@s4eZdZdd�Zdd�Zdd�Zdd�Zd	d
�ZdS)rcCst�dSrr�rZnoderrr�getNodeDetails�sz%NonRecursiveTreeWalker.getNodeDetailscCst�dSrrr<rrr�
getFirstChild�sz$NonRecursiveTreeWalker.getFirstChildcCst�dSrrr<rrr�getNextSibling�sz%NonRecursiveTreeWalker.getNextSiblingcCst�dSrrr<rrr�
getParentNode�sz$NonRecursiveTreeWalker.getParentNodeccs�|j}|dk	�r�|�|�}|d|dd�}}d}|tkrJ|j|�Vn�|tkrj|j|�D]
}|Vq\n�|tkr�|\}}}}|r�|tdkr�|tkr�|�	||||�D]
}|Vq�d}n|�
|||�VnV|tkr�|�|d�Vn<|t
k�r|�|d�Vn |tk�rd}n|�|d�V|�r2|�|�}	nd}	|	dk	�rF|	}q|dk	r|�|�}|d|dd�}}|tk�r�|\}}}}|�r�|tdk�s�|tk�r�|�||�V|j|k�r�d}q|�|�}
|
dk	�r�|
}qn
|�|�}�qFqdS)Nr�FZhtmlT)rr=rr5rr0r
rrr(r)rr2rr6r
r7r>r*r?r@)rZcurrentNodeZdetailsrr'�tokenr$r#Z
attributesZ
firstChildZnextSiblingrrrr�s\



�






zNonRecursiveTreeWalker.__iter__N)r8r9r:r=r>r?r@rrrrrr�s
N)Z
__future__rrrZxml.domrZ	constantsrrr	�__all__Z
DOCUMENT_NODEr
ZDOCUMENT_TYPE_NODErZ	TEXT_NODErZELEMENT_NODEr
ZCOMMENT_NODErZENTITY_NODErr�join�objectrrrrrr�<module>s"�
!site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/genshi.cpython-38.opt-1.pyc000064400000003500151446177000024637 0ustar00U

��.e	�@s�ddlmZmZmZddlmZddlmZmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZmZddlmZddlmZmZGd	d
�d
ej�ZdS)�)�absolute_import�division�unicode_literals)�QName)�START�END�
XML_NAMESPACE�DOCTYPE�TEXT)�START_NS�END_NS�START_CDATA�	END_CDATA�PI�COMMENT�)�base�)�voidElements�
namespacesc@seZdZdd�Zdd�ZdS)�
TreeWalkerccsXd}|jD](}|dk	r.|�||�D]
}|Vq"|}q
|dk	rT|�|d�D]
}|VqHdS)N)Ztree�tokens)�selfZprevious�event�token�r�K/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/genshi.py�__iter__
s
zTreeWalker.__iter__ccst|\}}}|tkr�|\}}|j}|j}	i}
|D]0\}}t|t�rR||
|j|jf<q.||
d|f<q.|	tdkr�|tkr�|�|	||
|p�|dtkp�|d|k�D]
}
|
Vq�n|�	|	||
�Vn�|tkr�|j}|j}	|	tdks�|tkr�|�
|	|�Vnz|tk�r|�|�Vnb|t
k�r2|�|�D]}
|
V�q"n>|tk�rJ|j|�Vn&|tttttttfk�rdn|�|�VdS)NZhtmlrr)rZ	localname�	namespace�
isinstancerrrZemptyTagrZstartTagZendTagrZcommentr
�textr	Zdoctyperrrr
rr�unknown)rr�nextZkind�data�_�tagZattribs�namerZconverted_attribs�k�vrrrrrsH



�




�zTreeWalker.tokensN)�__name__�
__module__�__qualname__rrrrrrrsrN)Z
__future__rrrZgenshi.corerrrrr	r
rrr
rrr�rZ	constantsrrrrrrr�<module>s site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/etree.cpython-38.pyc000064400000006633151446177000023541 0ustar00U

��.e��@sjddlmZmZmZddlmZddlZddlmZddl	m
Z
ddlmZe�
d	�Zd
d�Zee�ZdS)�)�absolute_import�division�unicode_literals)�OrderedDictN)�string_types�)�base�)�moduleFactoryFactoryz
{([^}]*)}(.*)cs,|}|�d�j�G�fdd�dtj�}t�S)NZasdcs4eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
S)z#getETreeBuilder.<locals>.TreeWalkera�Given the particular ElementTree representation, this implementation,
        to avoid using recursion, returns "nodes" as tuples with the following
        content:

        1. The current element

        2. The index of the element relative to its parent

        3. A stack of ancestor elements

        4. A flag "text", "tail" or None to indicate if the current node is a
           text node; either the text or tail of the current element (1)
        csHt|t�r2|\}}}}|dkr.tjt||�fS|}t|d�sD|��}|jdkrVtjfS|jdkr|tj	|j
|�d�|�d�fS|j�kr�tj|j
fSt|jt
�s�tt|j���t�|j�}|r�|��\}}n
d}|j}t�}t|j���D]>\}	}
t�|	�}|�r|
||�d�|�d�f<q�|
|d|	f<q�tj|||t|��p@|j
fSdS)	N��text�tail�tag)Z
DOCUMENT_ROOTZDOCUMENT_FRAGMENTz
<!DOCTYPE>ZpublicIdZsystemIdrr	)�
isinstance�tuplerZTEXT�getattr�hasattrZgetrootrZDOCUMENTZDOCTYPEr�get�COMMENTr�AssertionError�type�
tag_regexp�match�groupsr�listZattrib�items�groupZELEMENT�len)�self�nodeZelt�_�flagr�	namespacerZattrs�name�value�ZElementTreeCommentType��J/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/etree.py�getNodeDetails s@



�

�z2getETreeBuilder.<locals>.TreeWalker.getNodeDetailscSstt|t�r|\}}}}n|dgdf\}}}}|dkr8dS|jrJ|||dfSt|�rl|�|�|dd|dfSdSdS)Nrrr)rrrr�append�rr�element�key�parentsr!r&r&r'�
getFirstChildHs

z1getETreeBuilder.<locals>.TreeWalker.getFirstChildcSs�t|t�r|\}}}}ndS|dkrLt|�rF|�|�|dd|dfSdSnN|jrf|dkrf|||dfS|t|d�dkr�|d|d|d|dfSdSdS)Nrrr
���r)rrrr)r
r*r&r&r'�getNextSiblingYs

z2getETreeBuilder.<locals>.TreeWalker.getNextSiblingcSs�t|t�r|\}}}}ndS|dkr:|s,|S|||dfSnD|��}|sJ|St|d��|�dksdt�|t|d��|�|dfSdS)Nrr/r)rr�popr�countr�index)rrr+r,r-r!�parentr&r&r'�
getParentNodems
z1getETreeBuilder.<locals>.TreeWalker.getParentNodeN)�__name__�
__module__�__qualname__�__doc__r(r.r0r5r&r%r&r'�
TreeWalkers

(r:)�CommentrrZNonRecursiveTreeWalker�locals)ZElementTreeImplementationZElementTreer:r&r%r'�getETreeBuildersnr=)Z
__future__rrr�collectionsr�reZpip._vendor.sixr�rZ_utilsr
�compilerr=ZgetETreeModuler&r&r&r'�<module>s
tsite-packages/pip/_vendor/html5lib/treewalkers/__pycache__/etree_lxml.cpython-38.opt-1.pyc000064400000014236151446177000025532 0ustar00U

��.e��@s�ddlmZmZmZddlmZddlmZddlm	Z	ddl
mZddl
mZd	d
�Z
Gdd�de�ZGd
d�de�ZGdd�de�ZGdd�de�ZGdd�dej�ZdS)�)�absolute_import�division�unicode_literals)�	text_type)�etree�)�
tag_regexp�)�base)�	_ihatexmlcCs*|dkrdSt|t�r|S|�dd�SdS)N�ascii�strict)�
isinstancer�decode)�s�r�O/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/etree_lxml.py�
ensure_strs

rc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�RootcCs�||_g|_z:|jjrD|j�t|t|jj�t|jj�t|jj	���Wnt
k
rZYnXz|��}Wnt
k
r�|}YnX|��dk	r�|��}q�|dk	r�|j�|�|�
�}q�d|_d|_dS�N)Zelementtree�childrenZdocinfoZinternalDTD�append�DoctyperZ	root_name�	public_idZ
system_url�AttributeErrorZgetrootZgetprevious�getnext�text�tail)�selfZet�noderrr�__init__s,



�



z
Root.__init__cCs
|j|Sr)r�r�keyrrr�__getitem__1szRoot.__getitem__cCsdSrr�rrrrr4szRoot.getnextcCsdS�Nr	rr$rrr�__len__7szRoot.__len__N)�__name__�
__module__�__qualname__r r#rr&rrrrrsrc@seZdZdd�Zdd�ZdS)rcCs(||_||_||_||_d|_d|_dSr)�	root_node�namer�	system_idrr)rr*r+rr,rrrr <szDoctype.__init__cCs|jjdSr%)r*rr$rrrrEszDoctype.getnextN�r'r(r)r rrrrrr;s	rc@seZdZdd�Zdd�ZdS)�FragmentRootcs$�fdd�|D��_d�_�_dS)Ncsg|]}t�|��qSr)�FragmentWrapper)�.0Zchildr$rr�
<listcomp>Ksz)FragmentRoot.__init__.<locals>.<listcomp>)rrr)rrrr$rr JszFragmentRoot.__init__cCsdSrrr$rrrrNszFragmentRoot.getnextNr-rrrrr.Isr.c@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)r/cCsT||_||_t|jd�r(t|jj�|_nd|_t|jd�rJt|jj�|_nd|_dS)Nrr)r*�obj�hasattrrrr)rZ
fragment_rootr2rrrr SszFragmentWrapper.__init__cCst|j|�Sr)�getattrr2)rr+rrr�__getattr___szFragmentWrapper.__getattr__cCs6|jj}|�|�}|t|�dkr.||dSdSdSr%)r*r�index�len)rZsiblings�idxrrrrbs

zFragmentWrapper.getnextcCs
|j|Sr)r2r!rrrr#jszFragmentWrapper.__getitem__cCs
t|j�Sr)�boolr2r$rrr�__bool__mszFragmentWrapper.__bool__cCsdSrrr$rrr�	getparentpszFragmentWrapper.getparentcCs
t|j�Sr��strr2r$rrr�__str__sszFragmentWrapper.__str__cCs
t|j�Srr<r$rrr�__unicode__vszFragmentWrapper.__unicode__cCs
t|j�Sr)r7r2r$rrrr&yszFragmentWrapper.__len__N)r'r(r)r r5rr#r:r;r>r?r&rrrrr/Rsr/c@s4eZdZdd�Zdd�Zdd�Zdd�Zd	d
�ZdS)�
TreeWalkercCsJt|t�rt|�|_t|�}nt�|_t|�}tj�||�t	�
�|_dSr)r�list�set�fragmentChildrenr.rr
�NonRecursiveTreeWalkerr rZ
InfosetFilter�filter)rZtreerrrr ~s


zTreeWalker.__init__c	Cszt|t�r&|\}}tjtt||��fSt|t�r8tjfSt|t�rVtj	|j
|j|jfSt|t
�rzt|d�sztjt|j�fS|jtjkr�tjt|j�fS|jtjkr�tjt|j�dd�fSt�t|j��}|r�|��\}}nd}t|j�}i}t|j���D]P\}}t|�}t|�}t�|�}|�r>|||�d�|�d�f<n||d|f<�q�tj||j� |�|t!|�dk�pr|jfSdS)N�tagr	���rr)"r�tupler
ZTEXTrr4rZDOCUMENTrZDOCTYPEr+rr,r/r3r2rFr�Comment�COMMENTrZEntityZENTITYr�match�groupsrAZattrib�items�groupZELEMENTrEZfromXmlNamer7)	rrr"rK�	namespacerFZattrsr+�valuerrr�getNodeDetails�s<




�zTreeWalker.getNodeDetailscCs|jr|dfS|dSdS)Nrr)r)rrrrr�
getFirstChild�szTreeWalker.getFirstChildcCsNt|t�r8|\}}|dkr0t|�r*|dSdSn|��S|jrF|dfS|��S)Nrrr)rrHr7rr�rrr"rrr�getNextSibling�s
zTreeWalker.getNextSiblingcCs6t|t�r |\}}|dkr.|Sn||jkr.dS|��S)Nr)rrHrCr;rSrrr�
getParentNode�s

zTreeWalker.getParentNodeN)r'r(r)r rQrRrTrUrrrrr@}s
)	r@N)Z
__future__rrrZpip._vendor.sixrZlxmlrZtreebuilders.etreer�r
rr�objectrrr.r/rDr@rrrr�<module>s	&	+site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/base.cpython-38.opt-1.pyc000064400000015471151446177000024306 0ustar00U

��.e4�	@s�ddlmZmZmZddlmZddlmZmZm	Z	ddddd	d
ddd
g	Z
ejZej
ZejZejZejZejZdZd�e	�Z	Gdd�de�ZGdd
�d
e�ZdS)�)�absolute_import�division�unicode_literals)�Node�)�
namespaces�voidElements�spaceCharacters�DOCUMENT�DOCTYPE�TEXT�ELEMENT�COMMENT�ENTITY�UNKNOWN�
TreeWalker�NonRecursiveTreeWalkerz<#UNKNOWN#>�c@sleZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zddd�Zdd�Z
dd�ZdS)rz}Walks a tree yielding tokens

    Tokens are dicts that all have a ``type`` field specifying the type of the
    token.

    cCs
||_dS)zCCreates a TreeWalker

        :arg tree: the tree to walk

        N)�tree)�selfr�r�I/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/base.py�__init__szTreeWalker.__init__cCst�dS�N��NotImplementedError)rrrr�__iter__#szTreeWalker.__iter__cCs
d|d�S)z�Generates an error token with the given message

        :arg msg: the error message

        :returns: SerializeError token

        ZSerializeError��type�datar)r�msgrrr�error&szTreeWalker.errorFccs$d|||d�V|r |�d�VdS)arGenerates an EmptyTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :arg attrs: the attributes of the element as a dict

        :arg hasChildren: whether or not to yield a SerializationError because
            this tag shouldn't have children

        :returns: EmptyTag token

        ZEmptyTag�r�name�	namespacerzVoid element has childrenN�r!)rr$r#�attrs�hasChildrenrrr�emptyTag0s�zTreeWalker.emptyTagcCsd|||d�S)z�Generates a StartTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :arg attrs: the attributes of the element as a dict

        :returns: StartTag token

        ZStartTagr"r)rr$r#r&rrr�startTagEs
�zTreeWalker.startTagcCsd||d�S)z�Generates an EndTag token

        :arg namespace: the namespace of the token--can be ``None``

        :arg name: the name of the element

        :returns: EndTag token

        ZEndTag)rr#r$r)rr$r#rrr�endTagVs
�zTreeWalker.endTagccsx|}|�t�}|dt|�t|��}|r6d|d�V|}|�t�}|t|�d�}|rdd|d�V|rtd|d�VdS)atGenerates SpaceCharacters and Characters tokens

        Depending on what's in the data, this generates one or more
        ``SpaceCharacters`` and ``Characters`` tokens.

        For example:

            >>> from html5lib.treewalkers.base import TreeWalker
            >>> # Give it an empty tree just so it instantiates
            >>> walker = TreeWalker([])
            >>> list(walker.text(''))
            []
            >>> list(walker.text('  '))
            [{u'data': '  ', u'type': u'SpaceCharacters'}]
            >>> list(walker.text(' abc '))  # doctest: +NORMALIZE_WHITESPACE
            [{u'data': ' ', u'type': u'SpaceCharacters'},
            {u'data': u'abc', u'type': u'Characters'},
            {u'data': u' ', u'type': u'SpaceCharacters'}]

        :arg data: the text data

        :returns: one or more ``SpaceCharacters`` and ``Characters`` tokens

        NZSpaceCharactersrZ
Characters)�lstripr	�len�rstrip)rrZmiddle�left�rightrrr�textds

zTreeWalker.textcCs
d|d�S)zdGenerates a Comment token

        :arg data: the comment

        :returns: Comment token

        �Commentrr)rrrrr�comment�szTreeWalker.commentNcCsd|||d�S)z�Generates a Doctype token

        :arg name:

        :arg publicId:

        :arg systemId:

        :returns: the Doctype token

        ZDoctype)rr#�publicId�systemIdr)rr#r3r4rrr�doctype�s
�zTreeWalker.doctypecCs
d|d�S)zjGenerates an Entity token

        :arg name: the entity name

        :returns: an Entity token

        ZEntity)rr#r)rr#rrr�entity�szTreeWalker.entitycCs|�d|�S)zHandles unknown node typeszUnknown node type: r%)rZnodeTyperrr�unknown�szTreeWalker.unknown)F)NN)�__name__�
__module__�__qualname__�__doc__rrr!r(r)r*r0r2r5r6r7rrrrrs

&


c@s4eZdZdd�Zdd�Zdd�Zdd�Zd	d
�ZdS)rcCst�dSrr�rZnoderrr�getNodeDetails�sz%NonRecursiveTreeWalker.getNodeDetailscCst�dSrrr<rrr�
getFirstChild�sz$NonRecursiveTreeWalker.getFirstChildcCst�dSrrr<rrr�getNextSibling�sz%NonRecursiveTreeWalker.getNextSiblingcCst�dSrrr<rrr�
getParentNode�sz$NonRecursiveTreeWalker.getParentNodeccs�|j}|dk	�r�|�|�}|d|dd�}}d}|tkrJ|j|�Vn�|tkrj|j|�D]
}|Vq\n�|tkr�|\}}}}|r�|tdkr�|tkr�|�	||||�D]
}|Vq�d}n|�
|||�VnV|tkr�|�|d�Vn<|t
k�r|�|d�Vn |tk�rd}n|�|d�V|�r2|�|�}	nd}	|	dk	�rF|	}q|dk	r|�|�}|d|dd�}}|tk�r�|\}}}}|�r�|tdk�s�|tk�r�|�||�V|j|k�r�d}q|�|�}
|
dk	�r�|
}qn
|�|�}�qFqdS)Nr�FZhtmlT)rr=rr5rr0r
rrr(r)rr2rr6r
r7r>r*r?r@)rZcurrentNodeZdetailsrr'�tokenr$r#Z
attributesZ
firstChildZnextSiblingrrrr�s\



�






zNonRecursiveTreeWalker.__iter__N)r8r9r:r=r>r?r@rrrrrr�s
N)Z
__future__rrrZxml.domrZ	constantsrrr	�__all__Z
DOCUMENT_NODEr
ZDOCUMENT_TYPE_NODErZ	TEXT_NODErZELEMENT_NODEr
ZCOMMENT_NODErZENTITY_NODErr�join�objectrrrrrr�<module>s"�
!site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/genshi.cpython-38.pyc000064400000003500151446177000023700 0ustar00U

��.e	�@s�ddlmZmZmZddlmZddlmZmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZmZddlmZddlmZmZGd	d
�d
ej�ZdS)�)�absolute_import�division�unicode_literals)�QName)�START�END�
XML_NAMESPACE�DOCTYPE�TEXT)�START_NS�END_NS�START_CDATA�	END_CDATA�PI�COMMENT�)�base�)�voidElements�
namespacesc@seZdZdd�Zdd�ZdS)�
TreeWalkerccsXd}|jD](}|dk	r.|�||�D]
}|Vq"|}q
|dk	rT|�|d�D]
}|VqHdS)N)Ztree�tokens)�selfZprevious�event�token�r�K/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/genshi.py�__iter__
s
zTreeWalker.__iter__ccst|\}}}|tkr�|\}}|j}|j}	i}
|D]0\}}t|t�rR||
|j|jf<q.||
d|f<q.|	tdkr�|tkr�|�|	||
|p�|dtkp�|d|k�D]
}
|
Vq�n|�	|	||
�Vn�|tkr�|j}|j}	|	tdks�|tkr�|�
|	|�Vnz|tk�r|�|�Vnb|t
k�r2|�|�D]}
|
V�q"n>|tk�rJ|j|�Vn&|tttttttfk�rdn|�|�VdS)NZhtmlrr)rZ	localname�	namespace�
isinstancerrrZemptyTagrZstartTagZendTagrZcommentr
�textr	Zdoctyperrrr
rr�unknown)rr�nextZkind�data�_�tagZattribs�namerZconverted_attribs�k�vrrrrrsH



�




�zTreeWalker.tokensN)�__name__�
__module__�__qualname__rrrrrrrsrN)Z
__future__rrrZgenshi.corerrrrr	r
rrr
rrr�rZ	constantsrrrrrrr�<module>s site-packages/pip/_vendor/html5lib/treewalkers/__pycache__/dom.cpython-38.opt-1.pyc000064400000003242151446177000024144 0ustar00U

��.e��@sBddlmZmZmZddlmZddlmZGdd�dej�Z	dS)�)�absolute_import�division�unicode_literals)�Node�)�basec@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�
TreeWalkercCs�|jtjkr tj|j|j|jfS|jtjtj	fkr>tj
|jfS|jtjkr�i}t
|j���D]8}|�|�}|jr�|j||j|jf<q\|j|d|jf<q\tj|j|j||��fS|jtjkr�tj|jfS|jtjtjfkr�tjfStj|jfSdS�N)ZnodeTyperZDOCUMENT_TYPE_NODErZDOCTYPE�nameZpublicIdZsystemIdZ	TEXT_NODEZCDATA_SECTION_NODEZTEXTZ	nodeValueZELEMENT_NODE�listZ
attributes�keysZgetAttributeNodeZnamespaceURI�valueZ	localNameZELEMENTZnodeNameZ
hasChildNodesZCOMMENT_NODE�COMMENTZ
DOCUMENT_NODEZDOCUMENT_FRAGMENT_NODEZDOCUMENTZUNKNOWN)�self�nodeZattrs�attr�r�H/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/dom.py�getNodeDetails	s(
�zTreeWalker.getNodeDetailscCs|jSr	)Z
firstChild�rrrrr�
getFirstChild$szTreeWalker.getFirstChildcCs|jSr	)ZnextSiblingrrrr�getNextSibling'szTreeWalker.getNextSiblingcCs|jSr	)Z
parentNoderrrr�
getParentNode*szTreeWalker.getParentNodeN)�__name__�
__module__�__qualname__rrrrrrrrrsrN)
Z
__future__rrrZxml.domr�rZNonRecursiveTreeWalkerrrrrr�<module>ssite-packages/pip/_vendor/html5lib/treewalkers/__pycache__/__init__.cpython-38.pyc000064400000007601151446177000024170 0ustar00U

��.eR�@sZdZddlmZmZmZddlmZddlmZddgZ	iZ
d
d	d�Zd
d�Zdd�Z
dS)a�A collection of modules for iterating through different kinds of
tree, generating tokens identical to those produced by the tokenizer
module.

To create a tree walker for a new type of tree, you need to do
implement a tree walker object (called TreeWalker by convention) that
implements a 'serialize' method taking a tree as sole argument and
returning an iterator generating tokens.
�)�absolute_import�division�unicode_literals�)�	constants)�
default_etree�
getTreeWalker�pprintNcKs�|��}|tkr�|dkr0ddlm}|jt|<np|dkrPddlm}|jt|<nP|dkrpddlm}|jt|<n0|dkr�dd	lm}|d
kr�t}|j	|f|�jSt�
|�S)a;Get a TreeWalker class for various types of tree with built-in support

    :arg str treeType: the name of the tree type required (case-insensitive).
        Supported values are:

        * "dom": The xml.dom.minidom DOM implementation
        * "etree": A generic walker for tree implementations exposing an
          elementtree-like interface (known to work with ElementTree,
          cElementTree and lxml.etree).
        * "lxml": Optimized walker for lxml.etree
        * "genshi": a Genshi stream

    :arg implementation: A module implementing the tree type e.g.
        xml.etree.ElementTree or cElementTree (Currently applies to the "etree"
        tree type only).

    :arg kwargs: keyword arguments passed to the etree walker--for other
        walkers, this has no effect

    :returns: a TreeWalker class

    �dom�)r
�genshi)rZlxml)�
etree_lxml�etree)rN)�lower�treeWalkerCache�r
Z
TreeWalkerrr
rrZgetETreeModule�get)ZtreeType�implementation�kwargsr
rr
r�r�M/usr/lib/python3.8/site-packages/pip/_vendor/html5lib/treewalkers/__init__.pyrs"ccshg}|D]D}|d}|dkr,|�|d�q|rFdd�|�d�Vg}|Vq|rddd�|�d�VdS)N�type)�
Characters�SpaceCharacters�datarr)rr)�append�join)�tokensZpendingCharacters�tokenrrrr�concatenateCharacterTokensAsrc	Csbg}d}t|�D�]D}|d}|dk�r|drz|dtjdkrz|dtjkr`tj|d}n|d}d||df}n|d}|�dd	||f�|d
7}|d}t|���D]T\\}}	}
|r�|tjkr�tj|}n|}d||	f}n|	}|�dd	|||
f�q�|d
k�rV|d
8}q|dk�r2|d
8}q|dk�rX|�dd	||df�q|dk�r
|d�r�|d�r�|�dd	||d|d|d�r�|dndf�nF|d�r�|�dd	||d|df�n|�dd	||df�n|�dd	|f�q|dk�r0|�dd	||df�q|dk�rJd�sVtd��qtd|��qd�	|�S) z�Pretty printer for tree walkers

    Takes a TreeWalker instance and pretty prints the output of walking the tree.

    :arg walker: a TreeWalker instance

    rr)ZStartTag�EmptyTag�	namespaceZhtmlz%s %s�namez%s<%s>� rrz	%s%s="%s"r ZEndTag�Commentz
%s<!-- %s -->ZDoctypeZpublicIdz%s<!DOCTYPE %s "%s" "%s">ZsystemIdrz%s<!DOCTYPE %s "" "%s">z%s<!DOCTYPE %s>z
%s<!DOCTYPE >rz%s"%s"rFzBconcatenateCharacterTokens should have got rid of all Space tokenszUnknown token type, %s�
)
rrZ
namespaces�prefixesr�sorted�items�AssertionError�
ValueErrorr)Zwalker�output�indentrr�nsr"Zattrsr!Z	localname�valuerrrr	Psn









��
���


)N)�__doc__Z
__future__rrrrrZ_utilsr�__all__rrrr	rrrr�<module>s

,site-packages/pip/_vendor/html5lib/treewalkers/etree.py000064400000010706151446177000017247 0ustar00from __future__ import absolute_import, division, unicode_literals

from collections import OrderedDict
import re

from pip._vendor.six import string_types

from . import base
from .._utils import moduleFactoryFactory

tag_regexp = re.compile("{([^}]*)}(.*)")


def getETreeBuilder(ElementTreeImplementation):
    ElementTree = ElementTreeImplementation
    ElementTreeCommentType = ElementTree.Comment("asd").tag

    class TreeWalker(base.NonRecursiveTreeWalker):  # pylint:disable=unused-variable
        """Given the particular ElementTree representation, this implementation,
        to avoid using recursion, returns "nodes" as tuples with the following
        content:

        1. The current element

        2. The index of the element relative to its parent

        3. A stack of ancestor elements

        4. A flag "text", "tail" or None to indicate if the current node is a
           text node; either the text or tail of the current element (1)
        """
        def getNodeDetails(self, node):
            if isinstance(node, tuple):  # It might be the root Element
                elt, _, _, flag = node
                if flag in ("text", "tail"):
                    return base.TEXT, getattr(elt, flag)
                else:
                    node = elt

            if not(hasattr(node, "tag")):
                node = node.getroot()

            if node.tag in ("DOCUMENT_ROOT", "DOCUMENT_FRAGMENT"):
                return (base.DOCUMENT,)

            elif node.tag == "<!DOCTYPE>":
                return (base.DOCTYPE, node.text,
                        node.get("publicId"), node.get("systemId"))

            elif node.tag == ElementTreeCommentType:
                return base.COMMENT, node.text

            else:
                assert isinstance(node.tag, string_types), type(node.tag)
                # This is assumed to be an ordinary element
                match = tag_regexp.match(node.tag)
                if match:
                    namespace, tag = match.groups()
                else:
                    namespace = None
                    tag = node.tag
                attrs = OrderedDict()
                for name, value in list(node.attrib.items()):
                    match = tag_regexp.match(name)
                    if match:
                        attrs[(match.group(1), match.group(2))] = value
                    else:
                        attrs[(None, name)] = value
                return (base.ELEMENT, namespace, tag,
                        attrs, len(node) or node.text)

        def getFirstChild(self, node):
            if isinstance(node, tuple):
                element, key, parents, flag = node
            else:
                element, key, parents, flag = node, None, [], None

            if flag in ("text", "tail"):
                return None
            else:
                if element.text:
                    return element, key, parents, "text"
                elif len(element):
                    parents.append(element)
                    return element[0], 0, parents, None
                else:
                    return None

        def getNextSibling(self, node):
            if isinstance(node, tuple):
                element, key, parents, flag = node
            else:
                return None

            if flag == "text":
                if len(element):
                    parents.append(element)
                    return element[0], 0, parents, None
                else:
                    return None
            else:
                if element.tail and flag != "tail":
                    return element, key, parents, "tail"
                elif key < len(parents[-1]) - 1:
                    return parents[-1][key + 1], key + 1, parents, None
                else:
                    return None

        def getParentNode(self, node):
            if isinstance(node, tuple):
                element, key, parents, flag = node
            else:
                return None

            if flag == "text":
                if not parents:
                    return element
                else:
                    return element, key, parents, None
            else:
                parent = parents.pop()
                if not parents:
                    return parent
                else:
                    assert list(parents[-1]).count(parent) == 1
                    return parent, list(parents[-1]).index(parent), parents, None

    return locals()

getETreeModule = moduleFactoryFactory(getETreeBuilder)
site-packages/pip/_vendor/html5lib/treewalkers/dom.py000064400000002605151446177000016721 0ustar00from __future__ import absolute_import, division, unicode_literals

from xml.dom import Node

from . import base


class TreeWalker(base.NonRecursiveTreeWalker):
    def getNodeDetails(self, node):
        if node.nodeType == Node.DOCUMENT_TYPE_NODE:
            return base.DOCTYPE, node.name, node.publicId, node.systemId

        elif node.nodeType in (Node.TEXT_NODE, Node.CDATA_SECTION_NODE):
            return base.TEXT, node.nodeValue

        elif node.nodeType == Node.ELEMENT_NODE:
            attrs = {}
            for attr in list(node.attributes.keys()):
                attr = node.getAttributeNode(attr)
                if attr.namespaceURI:
                    attrs[(attr.namespaceURI, attr.localName)] = attr.value
                else:
                    attrs[(None, attr.name)] = attr.value
            return (base.ELEMENT, node.namespaceURI, node.nodeName,
                    attrs, node.hasChildNodes())

        elif node.nodeType == Node.COMMENT_NODE:
            return base.COMMENT, node.nodeValue

        elif node.nodeType in (Node.DOCUMENT_NODE, Node.DOCUMENT_FRAGMENT_NODE):
            return (base.DOCUMENT,)

        else:
            return base.UNKNOWN, node.nodeType

    def getFirstChild(self, node):
        return node.firstChild

    def getNextSibling(self, node):
        return node.nextSibling

    def getParentNode(self, node):
        return node.parentNode
site-packages/pip/_vendor/html5lib/treewalkers/__init__.py000064400000013122151446177000017675 0ustar00"""A collection of modules for iterating through different kinds of
tree, generating tokens identical to those produced by the tokenizer
module.

To create a tree walker for a new type of tree, you need to do
implement a tree walker object (called TreeWalker by convention) that
implements a 'serialize' method taking a tree as sole argument and
returning an iterator generating tokens.
"""

from __future__ import absolute_import, division, unicode_literals

from .. import constants
from .._utils import default_etree

__all__ = ["getTreeWalker", "pprint"]

treeWalkerCache = {}


def getTreeWalker(treeType, implementation=None, **kwargs):
    """Get a TreeWalker class for various types of tree with built-in support

    :arg str treeType: the name of the tree type required (case-insensitive).
        Supported values are:

        * "dom": The xml.dom.minidom DOM implementation
        * "etree": A generic walker for tree implementations exposing an
          elementtree-like interface (known to work with ElementTree,
          cElementTree and lxml.etree).
        * "lxml": Optimized walker for lxml.etree
        * "genshi": a Genshi stream

    :arg implementation: A module implementing the tree type e.g.
        xml.etree.ElementTree or cElementTree (Currently applies to the "etree"
        tree type only).

    :arg kwargs: keyword arguments passed to the etree walker--for other
        walkers, this has no effect

    :returns: a TreeWalker class

    """

    treeType = treeType.lower()
    if treeType not in treeWalkerCache:
        if treeType == "dom":
            from . import dom
            treeWalkerCache[treeType] = dom.TreeWalker
        elif treeType == "genshi":
            from . import genshi
            treeWalkerCache[treeType] = genshi.TreeWalker
        elif treeType == "lxml":
            from . import etree_lxml
            treeWalkerCache[treeType] = etree_lxml.TreeWalker
        elif treeType == "etree":
            from . import etree
            if implementation is None:
                implementation = default_etree
            # XXX: NEVER cache here, caching is done in the etree submodule
            return etree.getETreeModule(implementation, **kwargs).TreeWalker
    return treeWalkerCache.get(treeType)


def concatenateCharacterTokens(tokens):
    pendingCharacters = []
    for token in tokens:
        type = token["type"]
        if type in ("Characters", "SpaceCharacters"):
            pendingCharacters.append(token["data"])
        else:
            if pendingCharacters:
                yield {"type": "Characters", "data": "".join(pendingCharacters)}
                pendingCharacters = []
            yield token
    if pendingCharacters:
        yield {"type": "Characters", "data": "".join(pendingCharacters)}


def pprint(walker):
    """Pretty printer for tree walkers

    Takes a TreeWalker instance and pretty prints the output of walking the tree.

    :arg walker: a TreeWalker instance

    """
    output = []
    indent = 0
    for token in concatenateCharacterTokens(walker):
        type = token["type"]
        if type in ("StartTag", "EmptyTag"):
            # tag name
            if token["namespace"] and token["namespace"] != constants.namespaces["html"]:
                if token["namespace"] in constants.prefixes:
                    ns = constants.prefixes[token["namespace"]]
                else:
                    ns = token["namespace"]
                name = "%s %s" % (ns, token["name"])
            else:
                name = token["name"]
            output.append("%s<%s>" % (" " * indent, name))
            indent += 2
            # attributes (sorted for consistent ordering)
            attrs = token["data"]
            for (namespace, localname), value in sorted(attrs.items()):
                if namespace:
                    if namespace in constants.prefixes:
                        ns = constants.prefixes[namespace]
                    else:
                        ns = namespace
                    name = "%s %s" % (ns, localname)
                else:
                    name = localname
                output.append("%s%s=\"%s\"" % (" " * indent, name, value))
            # self-closing
            if type == "EmptyTag":
                indent -= 2

        elif type == "EndTag":
            indent -= 2

        elif type == "Comment":
            output.append("%s<!-- %s -->" % (" " * indent, token["data"]))

        elif type == "Doctype":
            if token["name"]:
                if token["publicId"]:
                    output.append("""%s<!DOCTYPE %s "%s" "%s">""" %
                                  (" " * indent,
                                   token["name"],
                                   token["publicId"],
                                   token["systemId"] if token["systemId"] else ""))
                elif token["systemId"]:
                    output.append("""%s<!DOCTYPE %s "" "%s">""" %
                                  (" " * indent,
                                   token["name"],
                                   token["systemId"]))
                else:
                    output.append("%s<!DOCTYPE %s>" % (" " * indent,
                                                       token["name"]))
            else:
                output.append("%s<!DOCTYPE >" % (" " * indent,))

        elif type == "Characters":
            output.append("%s\"%s\"" % (" " * indent, token["data"]))

        elif type == "SpaceCharacters":
            assert False, "concatenateCharacterTokens should have got rid of all Space tokens"

        else:
            raise ValueError("Unknown token type, %s" % type)

    return "\n".join(output)
site-packages/pip/_vendor/html5lib/html5parser.py000064400000350263151446177000016066 0ustar00from __future__ import absolute_import, division, unicode_literals
from pip._vendor.six import with_metaclass, viewkeys

import types
from collections import OrderedDict

from . import _inputstream
from . import _tokenizer

from . import treebuilders
from .treebuilders.base import Marker

from . import _utils
from .constants import (
    spaceCharacters, asciiUpper2Lower,
    specialElements, headingElements, cdataElements, rcdataElements,
    tokenTypes, tagTokenTypes,
    namespaces,
    htmlIntegrationPointElements, mathmlTextIntegrationPointElements,
    adjustForeignAttributes as adjustForeignAttributesMap,
    adjustMathMLAttributes, adjustSVGAttributes,
    E,
    _ReparseException
)


def parse(doc, treebuilder="etree", namespaceHTMLElements=True, **kwargs):
    """Parse an HTML document as a string or file-like object into a tree

    :arg doc: the document to parse as a string or file-like object

    :arg treebuilder: the treebuilder to use when parsing

    :arg namespaceHTMLElements: whether or not to namespace HTML elements

    :returns: parsed tree

    Example:

    >>> from html5lib.html5parser import parse
    >>> parse('<html><body><p>This is a doc</p></body></html>')
    <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>

    """
    tb = treebuilders.getTreeBuilder(treebuilder)
    p = HTMLParser(tb, namespaceHTMLElements=namespaceHTMLElements)
    return p.parse(doc, **kwargs)


def parseFragment(doc, container="div", treebuilder="etree", namespaceHTMLElements=True, **kwargs):
    """Parse an HTML fragment as a string or file-like object into a tree

    :arg doc: the fragment to parse as a string or file-like object

    :arg container: the container context to parse the fragment in

    :arg treebuilder: the treebuilder to use when parsing

    :arg namespaceHTMLElements: whether or not to namespace HTML elements

    :returns: parsed tree

    Example:

    >>> from html5lib.html5libparser import parseFragment
    >>> parseFragment('<b>this is a fragment</b>')
    <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>

    """
    tb = treebuilders.getTreeBuilder(treebuilder)
    p = HTMLParser(tb, namespaceHTMLElements=namespaceHTMLElements)
    return p.parseFragment(doc, container=container, **kwargs)


def method_decorator_metaclass(function):
    class Decorated(type):
        def __new__(meta, classname, bases, classDict):
            for attributeName, attribute in classDict.items():
                if isinstance(attribute, types.FunctionType):
                    attribute = function(attribute)

                classDict[attributeName] = attribute
            return type.__new__(meta, classname, bases, classDict)
    return Decorated


class HTMLParser(object):
    """HTML parser

    Generates a tree structure from a stream of (possibly malformed) HTML.

    """

    def __init__(self, tree=None, strict=False, namespaceHTMLElements=True, debug=False):
        """
        :arg tree: a treebuilder class controlling the type of tree that will be
            returned. Built in treebuilders can be accessed through
            html5lib.treebuilders.getTreeBuilder(treeType)

        :arg strict: raise an exception when a parse error is encountered

        :arg namespaceHTMLElements: whether or not to namespace HTML elements

        :arg debug: whether or not to enable debug mode which logs things

        Example:

        >>> from html5lib.html5parser import HTMLParser
        >>> parser = HTMLParser()                     # generates parser with etree builder
        >>> parser = HTMLParser('lxml', strict=True)  # generates parser with lxml builder which is strict

        """

        # Raise an exception on the first error encountered
        self.strict = strict

        if tree is None:
            tree = treebuilders.getTreeBuilder("etree")
        self.tree = tree(namespaceHTMLElements)
        self.errors = []

        self.phases = dict([(name, cls(self, self.tree)) for name, cls in
                            getPhases(debug).items()])

    def _parse(self, stream, innerHTML=False, container="div", scripting=False, **kwargs):

        self.innerHTMLMode = innerHTML
        self.container = container
        self.scripting = scripting
        self.tokenizer = _tokenizer.HTMLTokenizer(stream, parser=self, **kwargs)
        self.reset()

        try:
            self.mainLoop()
        except _ReparseException:
            self.reset()
            self.mainLoop()

    def reset(self):
        self.tree.reset()
        self.firstStartTag = False
        self.errors = []
        self.log = []  # only used with debug mode
        # "quirks" / "limited quirks" / "no quirks"
        self.compatMode = "no quirks"

        if self.innerHTMLMode:
            self.innerHTML = self.container.lower()

            if self.innerHTML in cdataElements:
                self.tokenizer.state = self.tokenizer.rcdataState
            elif self.innerHTML in rcdataElements:
                self.tokenizer.state = self.tokenizer.rawtextState
            elif self.innerHTML == 'plaintext':
                self.tokenizer.state = self.tokenizer.plaintextState
            else:
                # state already is data state
                # self.tokenizer.state = self.tokenizer.dataState
                pass
            self.phase = self.phases["beforeHtml"]
            self.phase.insertHtmlElement()
            self.resetInsertionMode()
        else:
            self.innerHTML = False  # pylint:disable=redefined-variable-type
            self.phase = self.phases["initial"]

        self.lastPhase = None

        self.beforeRCDataPhase = None

        self.framesetOK = True

    @property
    def documentEncoding(self):
        """Name of the character encoding that was used to decode the input stream, or
        :obj:`None` if that is not determined yet

        """
        if not hasattr(self, 'tokenizer'):
            return None
        return self.tokenizer.stream.charEncoding[0].name

    def isHTMLIntegrationPoint(self, element):
        if (element.name == "annotation-xml" and
                element.namespace == namespaces["mathml"]):
            return ("encoding" in element.attributes and
                    element.attributes["encoding"].translate(
                        asciiUpper2Lower) in
                    ("text/html", "application/xhtml+xml"))
        else:
            return (element.namespace, element.name) in htmlIntegrationPointElements

    def isMathMLTextIntegrationPoint(self, element):
        return (element.namespace, element.name) in mathmlTextIntegrationPointElements

    def mainLoop(self):
        CharactersToken = tokenTypes["Characters"]
        SpaceCharactersToken = tokenTypes["SpaceCharacters"]
        StartTagToken = tokenTypes["StartTag"]
        EndTagToken = tokenTypes["EndTag"]
        CommentToken = tokenTypes["Comment"]
        DoctypeToken = tokenTypes["Doctype"]
        ParseErrorToken = tokenTypes["ParseError"]

        for token in self.normalizedTokens():
            prev_token = None
            new_token = token
            while new_token is not None:
                prev_token = new_token
                currentNode = self.tree.openElements[-1] if self.tree.openElements else None
                currentNodeNamespace = currentNode.namespace if currentNode else None
                currentNodeName = currentNode.name if currentNode else None

                type = new_token["type"]

                if type == ParseErrorToken:
                    self.parseError(new_token["data"], new_token.get("datavars", {}))
                    new_token = None
                else:
                    if (len(self.tree.openElements) == 0 or
                        currentNodeNamespace == self.tree.defaultNamespace or
                        (self.isMathMLTextIntegrationPoint(currentNode) and
                         ((type == StartTagToken and
                           token["name"] not in frozenset(["mglyph", "malignmark"])) or
                          type in (CharactersToken, SpaceCharactersToken))) or
                        (currentNodeNamespace == namespaces["mathml"] and
                         currentNodeName == "annotation-xml" and
                         type == StartTagToken and
                         token["name"] == "svg") or
                        (self.isHTMLIntegrationPoint(currentNode) and
                         type in (StartTagToken, CharactersToken, SpaceCharactersToken))):
                        phase = self.phase
                    else:
                        phase = self.phases["inForeignContent"]

                    if type == CharactersToken:
                        new_token = phase.processCharacters(new_token)
                    elif type == SpaceCharactersToken:
                        new_token = phase.processSpaceCharacters(new_token)
                    elif type == StartTagToken:
                        new_token = phase.processStartTag(new_token)
                    elif type == EndTagToken:
                        new_token = phase.processEndTag(new_token)
                    elif type == CommentToken:
                        new_token = phase.processComment(new_token)
                    elif type == DoctypeToken:
                        new_token = phase.processDoctype(new_token)

            if (type == StartTagToken and prev_token["selfClosing"] and
                    not prev_token["selfClosingAcknowledged"]):
                self.parseError("non-void-element-with-trailing-solidus",
                                {"name": prev_token["name"]})

        # When the loop finishes it's EOF
        reprocess = True
        phases = []
        while reprocess:
            phases.append(self.phase)
            reprocess = self.phase.processEOF()
            if reprocess:
                assert self.phase not in phases

    def normalizedTokens(self):
        for token in self.tokenizer:
            yield self.normalizeToken(token)

    def parse(self, stream, *args, **kwargs):
        """Parse a HTML document into a well-formed tree

        :arg stream: a file-like object or string containing the HTML to be parsed

            The optional encoding parameter must be a string that indicates
            the encoding.  If specified, that encoding will be used,
            regardless of any BOM or later declaration (such as in a meta
            element).

        :arg scripting: treat noscript elements as if JavaScript was turned on

        :returns: parsed tree

        Example:

        >>> from html5lib.html5parser import HTMLParser
        >>> parser = HTMLParser()
        >>> parser.parse('<html><body><p>This is a doc</p></body></html>')
        <Element u'{http://www.w3.org/1999/xhtml}html' at 0x7feac4909db0>

        """
        self._parse(stream, False, None, *args, **kwargs)
        return self.tree.getDocument()

    def parseFragment(self, stream, *args, **kwargs):
        """Parse a HTML fragment into a well-formed tree fragment

        :arg container: name of the element we're setting the innerHTML
            property if set to None, default to 'div'

        :arg stream: a file-like object or string containing the HTML to be parsed

            The optional encoding parameter must be a string that indicates
            the encoding.  If specified, that encoding will be used,
            regardless of any BOM or later declaration (such as in a meta
            element)

        :arg scripting: treat noscript elements as if JavaScript was turned on

        :returns: parsed tree

        Example:

        >>> from html5lib.html5libparser import HTMLParser
        >>> parser = HTMLParser()
        >>> parser.parseFragment('<b>this is a fragment</b>')
        <Element u'DOCUMENT_FRAGMENT' at 0x7feac484b090>

        """
        self._parse(stream, True, *args, **kwargs)
        return self.tree.getFragment()

    def parseError(self, errorcode="XXX-undefined-error", datavars=None):
        # XXX The idea is to make errorcode mandatory.
        if datavars is None:
            datavars = {}
        self.errors.append((self.tokenizer.stream.position(), errorcode, datavars))
        if self.strict:
            raise ParseError(E[errorcode] % datavars)

    def normalizeToken(self, token):
        # HTML5 specific normalizations to the token stream
        if token["type"] == tokenTypes["StartTag"]:
            raw = token["data"]
            token["data"] = OrderedDict(raw)
            if len(raw) > len(token["data"]):
                # we had some duplicated attribute, fix so first wins
                token["data"].update(raw[::-1])

        return token

    def adjustMathMLAttributes(self, token):
        adjust_attributes(token, adjustMathMLAttributes)

    def adjustSVGAttributes(self, token):
        adjust_attributes(token, adjustSVGAttributes)

    def adjustForeignAttributes(self, token):
        adjust_attributes(token, adjustForeignAttributesMap)

    def reparseTokenNormal(self, token):
        # pylint:disable=unused-argument
        self.parser.phase()

    def resetInsertionMode(self):
        # The name of this method is mostly historical. (It's also used in the
        # specification.)
        last = False
        newModes = {
            "select": "inSelect",
            "td": "inCell",
            "th": "inCell",
            "tr": "inRow",
            "tbody": "inTableBody",
            "thead": "inTableBody",
            "tfoot": "inTableBody",
            "caption": "inCaption",
            "colgroup": "inColumnGroup",
            "table": "inTable",
            "head": "inBody",
            "body": "inBody",
            "frameset": "inFrameset",
            "html": "beforeHead"
        }
        for node in self.tree.openElements[::-1]:
            nodeName = node.name
            new_phase = None
            if node == self.tree.openElements[0]:
                assert self.innerHTML
                last = True
                nodeName = self.innerHTML
            # Check for conditions that should only happen in the innerHTML
            # case
            if nodeName in ("select", "colgroup", "head", "html"):
                assert self.innerHTML

            if not last and node.namespace != self.tree.defaultNamespace:
                continue

            if nodeName in newModes:
                new_phase = self.phases[newModes[nodeName]]
                break
            elif last:
                new_phase = self.phases["inBody"]
                break

        self.phase = new_phase

    def parseRCDataRawtext(self, token, contentType):
        # Generic RCDATA/RAWTEXT Parsing algorithm
        assert contentType in ("RAWTEXT", "RCDATA")

        self.tree.insertElement(token)

        if contentType == "RAWTEXT":
            self.tokenizer.state = self.tokenizer.rawtextState
        else:
            self.tokenizer.state = self.tokenizer.rcdataState

        self.originalPhase = self.phase

        self.phase = self.phases["text"]


@_utils.memoize
def getPhases(debug):
    def log(function):
        """Logger that records which phase processes each token"""
        type_names = dict((value, key) for key, value in
                          tokenTypes.items())

        def wrapped(self, *args, **kwargs):
            if function.__name__.startswith("process") and len(args) > 0:
                token = args[0]
                try:
                    info = {"type": type_names[token['type']]}
                except:
                    raise
                if token['type'] in tagTokenTypes:
                    info["name"] = token['name']

                self.parser.log.append((self.parser.tokenizer.state.__name__,
                                        self.parser.phase.__class__.__name__,
                                        self.__class__.__name__,
                                        function.__name__,
                                        info))
                return function(self, *args, **kwargs)
            else:
                return function(self, *args, **kwargs)
        return wrapped

    def getMetaclass(use_metaclass, metaclass_func):
        if use_metaclass:
            return method_decorator_metaclass(metaclass_func)
        else:
            return type

    # pylint:disable=unused-argument
    class Phase(with_metaclass(getMetaclass(debug, log))):
        """Base class for helper object that implements each phase of processing
        """

        def __init__(self, parser, tree):
            self.parser = parser
            self.tree = tree

        def processEOF(self):
            raise NotImplementedError

        def processComment(self, token):
            # For most phases the following is correct. Where it's not it will be
            # overridden.
            self.tree.insertComment(token, self.tree.openElements[-1])

        def processDoctype(self, token):
            self.parser.parseError("unexpected-doctype")

        def processCharacters(self, token):
            self.tree.insertText(token["data"])

        def processSpaceCharacters(self, token):
            self.tree.insertText(token["data"])

        def processStartTag(self, token):
            return self.startTagHandler[token["name"]](token)

        def startTagHtml(self, token):
            if not self.parser.firstStartTag and token["name"] == "html":
                self.parser.parseError("non-html-root")
            # XXX Need a check here to see if the first start tag token emitted is
            # this token... If it's not, invoke self.parser.parseError().
            for attr, value in token["data"].items():
                if attr not in self.tree.openElements[0].attributes:
                    self.tree.openElements[0].attributes[attr] = value
            self.parser.firstStartTag = False

        def processEndTag(self, token):
            return self.endTagHandler[token["name"]](token)

    class InitialPhase(Phase):
        def processSpaceCharacters(self, token):
            pass

        def processComment(self, token):
            self.tree.insertComment(token, self.tree.document)

        def processDoctype(self, token):
            name = token["name"]
            publicId = token["publicId"]
            systemId = token["systemId"]
            correct = token["correct"]

            if (name != "html" or publicId is not None or
                    systemId is not None and systemId != "about:legacy-compat"):
                self.parser.parseError("unknown-doctype")

            if publicId is None:
                publicId = ""

            self.tree.insertDoctype(token)

            if publicId != "":
                publicId = publicId.translate(asciiUpper2Lower)

            if (not correct or token["name"] != "html" or
                    publicId.startswith(
                        ("+//silmaril//dtd html pro v0r11 19970101//",
                         "-//advasoft ltd//dtd html 3.0 aswedit + extensions//",
                         "-//as//dtd html 3.0 aswedit + extensions//",
                         "-//ietf//dtd html 2.0 level 1//",
                         "-//ietf//dtd html 2.0 level 2//",
                         "-//ietf//dtd html 2.0 strict level 1//",
                         "-//ietf//dtd html 2.0 strict level 2//",
                         "-//ietf//dtd html 2.0 strict//",
                         "-//ietf//dtd html 2.0//",
                         "-//ietf//dtd html 2.1e//",
                         "-//ietf//dtd html 3.0//",
                         "-//ietf//dtd html 3.2 final//",
                         "-//ietf//dtd html 3.2//",
                         "-//ietf//dtd html 3//",
                         "-//ietf//dtd html level 0//",
                         "-//ietf//dtd html level 1//",
                         "-//ietf//dtd html level 2//",
                         "-//ietf//dtd html level 3//",
                         "-//ietf//dtd html strict level 0//",
                         "-//ietf//dtd html strict level 1//",
                         "-//ietf//dtd html strict level 2//",
                         "-//ietf//dtd html strict level 3//",
                         "-//ietf//dtd html strict//",
                         "-//ietf//dtd html//",
                         "-//metrius//dtd metrius presentational//",
                         "-//microsoft//dtd internet explorer 2.0 html strict//",
                         "-//microsoft//dtd internet explorer 2.0 html//",
                         "-//microsoft//dtd internet explorer 2.0 tables//",
                         "-//microsoft//dtd internet explorer 3.0 html strict//",
                         "-//microsoft//dtd internet explorer 3.0 html//",
                         "-//microsoft//dtd internet explorer 3.0 tables//",
                         "-//netscape comm. corp.//dtd html//",
                         "-//netscape comm. corp.//dtd strict html//",
                         "-//o'reilly and associates//dtd html 2.0//",
                         "-//o'reilly and associates//dtd html extended 1.0//",
                         "-//o'reilly and associates//dtd html extended relaxed 1.0//",
                         "-//softquad software//dtd hotmetal pro 6.0::19990601::extensions to html 4.0//",
                         "-//softquad//dtd hotmetal pro 4.0::19971010::extensions to html 4.0//",
                         "-//spyglass//dtd html 2.0 extended//",
                         "-//sq//dtd html 2.0 hotmetal + extensions//",
                         "-//sun microsystems corp.//dtd hotjava html//",
                         "-//sun microsystems corp.//dtd hotjava strict html//",
                         "-//w3c//dtd html 3 1995-03-24//",
                         "-//w3c//dtd html 3.2 draft//",
                         "-//w3c//dtd html 3.2 final//",
                         "-//w3c//dtd html 3.2//",
                         "-//w3c//dtd html 3.2s draft//",
                         "-//w3c//dtd html 4.0 frameset//",
                         "-//w3c//dtd html 4.0 transitional//",
                         "-//w3c//dtd html experimental 19960712//",
                         "-//w3c//dtd html experimental 970421//",
                         "-//w3c//dtd w3 html//",
                         "-//w3o//dtd w3 html 3.0//",
                         "-//webtechs//dtd mozilla html 2.0//",
                         "-//webtechs//dtd mozilla html//")) or
                    publicId in ("-//w3o//dtd w3 html strict 3.0//en//",
                                 "-/w3c/dtd html 4.0 transitional/en",
                                 "html") or
                    publicId.startswith(
                        ("-//w3c//dtd html 4.01 frameset//",
                         "-//w3c//dtd html 4.01 transitional//")) and
                    systemId is None or
                    systemId and systemId.lower() == "http://www.ibm.com/data/dtd/v11/ibmxhtml1-transitional.dtd"):
                self.parser.compatMode = "quirks"
            elif (publicId.startswith(
                    ("-//w3c//dtd xhtml 1.0 frameset//",
                     "-//w3c//dtd xhtml 1.0 transitional//")) or
                  publicId.startswith(
                      ("-//w3c//dtd html 4.01 frameset//",
                       "-//w3c//dtd html 4.01 transitional//")) and
                  systemId is not None):
                self.parser.compatMode = "limited quirks"

            self.parser.phase = self.parser.phases["beforeHtml"]

        def anythingElse(self):
            self.parser.compatMode = "quirks"
            self.parser.phase = self.parser.phases["beforeHtml"]

        def processCharacters(self, token):
            self.parser.parseError("expected-doctype-but-got-chars")
            self.anythingElse()
            return token

        def processStartTag(self, token):
            self.parser.parseError("expected-doctype-but-got-start-tag",
                                   {"name": token["name"]})
            self.anythingElse()
            return token

        def processEndTag(self, token):
            self.parser.parseError("expected-doctype-but-got-end-tag",
                                   {"name": token["name"]})
            self.anythingElse()
            return token

        def processEOF(self):
            self.parser.parseError("expected-doctype-but-got-eof")
            self.anythingElse()
            return True

    class BeforeHtmlPhase(Phase):
        # helper methods
        def insertHtmlElement(self):
            self.tree.insertRoot(impliedTagToken("html", "StartTag"))
            self.parser.phase = self.parser.phases["beforeHead"]

        # other
        def processEOF(self):
            self.insertHtmlElement()
            return True

        def processComment(self, token):
            self.tree.insertComment(token, self.tree.document)

        def processSpaceCharacters(self, token):
            pass

        def processCharacters(self, token):
            self.insertHtmlElement()
            return token

        def processStartTag(self, token):
            if token["name"] == "html":
                self.parser.firstStartTag = True
            self.insertHtmlElement()
            return token

        def processEndTag(self, token):
            if token["name"] not in ("head", "body", "html", "br"):
                self.parser.parseError("unexpected-end-tag-before-html",
                                       {"name": token["name"]})
            else:
                self.insertHtmlElement()
                return token

    class BeforeHeadPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("head", self.startTagHead)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                (("head", "body", "html", "br"), self.endTagImplyHead)
            ])
            self.endTagHandler.default = self.endTagOther

        def processEOF(self):
            self.startTagHead(impliedTagToken("head", "StartTag"))
            return True

        def processSpaceCharacters(self, token):
            pass

        def processCharacters(self, token):
            self.startTagHead(impliedTagToken("head", "StartTag"))
            return token

        def startTagHtml(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagHead(self, token):
            self.tree.insertElement(token)
            self.tree.headPointer = self.tree.openElements[-1]
            self.parser.phase = self.parser.phases["inHead"]

        def startTagOther(self, token):
            self.startTagHead(impliedTagToken("head", "StartTag"))
            return token

        def endTagImplyHead(self, token):
            self.startTagHead(impliedTagToken("head", "StartTag"))
            return token

        def endTagOther(self, token):
            self.parser.parseError("end-tag-after-implied-root",
                                   {"name": token["name"]})

    class InHeadPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("title", self.startTagTitle),
                (("noframes", "style"), self.startTagNoFramesStyle),
                ("noscript", self.startTagNoscript),
                ("script", self.startTagScript),
                (("base", "basefont", "bgsound", "command", "link"),
                 self.startTagBaseLinkCommand),
                ("meta", self.startTagMeta),
                ("head", self.startTagHead)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("head", self.endTagHead),
                (("br", "html", "body"), self.endTagHtmlBodyBr)
            ])
            self.endTagHandler.default = self.endTagOther

        # the real thing
        def processEOF(self):
            self.anythingElse()
            return True

        def processCharacters(self, token):
            self.anythingElse()
            return token

        def startTagHtml(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagHead(self, token):
            self.parser.parseError("two-heads-are-not-better-than-one")

        def startTagBaseLinkCommand(self, token):
            self.tree.insertElement(token)
            self.tree.openElements.pop()
            token["selfClosingAcknowledged"] = True

        def startTagMeta(self, token):
            self.tree.insertElement(token)
            self.tree.openElements.pop()
            token["selfClosingAcknowledged"] = True

            attributes = token["data"]
            if self.parser.tokenizer.stream.charEncoding[1] == "tentative":
                if "charset" in attributes:
                    self.parser.tokenizer.stream.changeEncoding(attributes["charset"])
                elif ("content" in attributes and
                      "http-equiv" in attributes and
                      attributes["http-equiv"].lower() == "content-type"):
                    # Encoding it as UTF-8 here is a hack, as really we should pass
                    # the abstract Unicode string, and just use the
                    # ContentAttrParser on that, but using UTF-8 allows all chars
                    # to be encoded and as a ASCII-superset works.
                    data = _inputstream.EncodingBytes(attributes["content"].encode("utf-8"))
                    parser = _inputstream.ContentAttrParser(data)
                    codec = parser.parse()
                    self.parser.tokenizer.stream.changeEncoding(codec)

        def startTagTitle(self, token):
            self.parser.parseRCDataRawtext(token, "RCDATA")

        def startTagNoFramesStyle(self, token):
            # Need to decide whether to implement the scripting-disabled case
            self.parser.parseRCDataRawtext(token, "RAWTEXT")

        def startTagNoscript(self, token):
            if self.parser.scripting:
                self.parser.parseRCDataRawtext(token, "RAWTEXT")
            else:
                self.tree.insertElement(token)
                self.parser.phase = self.parser.phases["inHeadNoscript"]

        def startTagScript(self, token):
            self.tree.insertElement(token)
            self.parser.tokenizer.state = self.parser.tokenizer.scriptDataState
            self.parser.originalPhase = self.parser.phase
            self.parser.phase = self.parser.phases["text"]

        def startTagOther(self, token):
            self.anythingElse()
            return token

        def endTagHead(self, token):
            node = self.parser.tree.openElements.pop()
            assert node.name == "head", "Expected head got %s" % node.name
            self.parser.phase = self.parser.phases["afterHead"]

        def endTagHtmlBodyBr(self, token):
            self.anythingElse()
            return token

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

        def anythingElse(self):
            self.endTagHead(impliedTagToken("head"))

    class InHeadNoscriptPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                (("basefont", "bgsound", "link", "meta", "noframes", "style"), self.startTagBaseLinkCommand),
                (("head", "noscript"), self.startTagHeadNoscript),
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("noscript", self.endTagNoscript),
                ("br", self.endTagBr),
            ])
            self.endTagHandler.default = self.endTagOther

        def processEOF(self):
            self.parser.parseError("eof-in-head-noscript")
            self.anythingElse()
            return True

        def processComment(self, token):
            return self.parser.phases["inHead"].processComment(token)

        def processCharacters(self, token):
            self.parser.parseError("char-in-head-noscript")
            self.anythingElse()
            return token

        def processSpaceCharacters(self, token):
            return self.parser.phases["inHead"].processSpaceCharacters(token)

        def startTagHtml(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagBaseLinkCommand(self, token):
            return self.parser.phases["inHead"].processStartTag(token)

        def startTagHeadNoscript(self, token):
            self.parser.parseError("unexpected-start-tag", {"name": token["name"]})

        def startTagOther(self, token):
            self.parser.parseError("unexpected-inhead-noscript-tag", {"name": token["name"]})
            self.anythingElse()
            return token

        def endTagNoscript(self, token):
            node = self.parser.tree.openElements.pop()
            assert node.name == "noscript", "Expected noscript got %s" % node.name
            self.parser.phase = self.parser.phases["inHead"]

        def endTagBr(self, token):
            self.parser.parseError("unexpected-inhead-noscript-tag", {"name": token["name"]})
            self.anythingElse()
            return token

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

        def anythingElse(self):
            # Caller must raise parse error first!
            self.endTagNoscript(impliedTagToken("noscript"))

    class AfterHeadPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("body", self.startTagBody),
                ("frameset", self.startTagFrameset),
                (("base", "basefont", "bgsound", "link", "meta", "noframes", "script",
                  "style", "title"),
                 self.startTagFromHead),
                ("head", self.startTagHead)
            ])
            self.startTagHandler.default = self.startTagOther
            self.endTagHandler = _utils.MethodDispatcher([(("body", "html", "br"),
                                                           self.endTagHtmlBodyBr)])
            self.endTagHandler.default = self.endTagOther

        def processEOF(self):
            self.anythingElse()
            return True

        def processCharacters(self, token):
            self.anythingElse()
            return token

        def startTagHtml(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagBody(self, token):
            self.parser.framesetOK = False
            self.tree.insertElement(token)
            self.parser.phase = self.parser.phases["inBody"]

        def startTagFrameset(self, token):
            self.tree.insertElement(token)
            self.parser.phase = self.parser.phases["inFrameset"]

        def startTagFromHead(self, token):
            self.parser.parseError("unexpected-start-tag-out-of-my-head",
                                   {"name": token["name"]})
            self.tree.openElements.append(self.tree.headPointer)
            self.parser.phases["inHead"].processStartTag(token)
            for node in self.tree.openElements[::-1]:
                if node.name == "head":
                    self.tree.openElements.remove(node)
                    break

        def startTagHead(self, token):
            self.parser.parseError("unexpected-start-tag", {"name": token["name"]})

        def startTagOther(self, token):
            self.anythingElse()
            return token

        def endTagHtmlBodyBr(self, token):
            self.anythingElse()
            return token

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

        def anythingElse(self):
            self.tree.insertElement(impliedTagToken("body", "StartTag"))
            self.parser.phase = self.parser.phases["inBody"]
            self.parser.framesetOK = True

    class InBodyPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#parsing-main-inbody
        # the really-really-really-very crazy mode
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            # Set this to the default handler
            self.processSpaceCharacters = self.processSpaceCharactersNonPre

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                (("base", "basefont", "bgsound", "command", "link", "meta",
                  "script", "style", "title"),
                 self.startTagProcessInHead),
                ("body", self.startTagBody),
                ("frameset", self.startTagFrameset),
                (("address", "article", "aside", "blockquote", "center", "details",
                  "dir", "div", "dl", "fieldset", "figcaption", "figure",
                  "footer", "header", "hgroup", "main", "menu", "nav", "ol", "p",
                  "section", "summary", "ul"),
                 self.startTagCloseP),
                (headingElements, self.startTagHeading),
                (("pre", "listing"), self.startTagPreListing),
                ("form", self.startTagForm),
                (("li", "dd", "dt"), self.startTagListItem),
                ("plaintext", self.startTagPlaintext),
                ("a", self.startTagA),
                (("b", "big", "code", "em", "font", "i", "s", "small", "strike",
                  "strong", "tt", "u"), self.startTagFormatting),
                ("nobr", self.startTagNobr),
                ("button", self.startTagButton),
                (("applet", "marquee", "object"), self.startTagAppletMarqueeObject),
                ("xmp", self.startTagXmp),
                ("table", self.startTagTable),
                (("area", "br", "embed", "img", "keygen", "wbr"),
                 self.startTagVoidFormatting),
                (("param", "source", "track"), self.startTagParamSource),
                ("input", self.startTagInput),
                ("hr", self.startTagHr),
                ("image", self.startTagImage),
                ("isindex", self.startTagIsIndex),
                ("textarea", self.startTagTextarea),
                ("iframe", self.startTagIFrame),
                ("noscript", self.startTagNoscript),
                (("noembed", "noframes"), self.startTagRawtext),
                ("select", self.startTagSelect),
                (("rp", "rt"), self.startTagRpRt),
                (("option", "optgroup"), self.startTagOpt),
                (("math"), self.startTagMath),
                (("svg"), self.startTagSvg),
                (("caption", "col", "colgroup", "frame", "head",
                  "tbody", "td", "tfoot", "th", "thead",
                  "tr"), self.startTagMisplaced)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("body", self.endTagBody),
                ("html", self.endTagHtml),
                (("address", "article", "aside", "blockquote", "button", "center",
                  "details", "dialog", "dir", "div", "dl", "fieldset", "figcaption", "figure",
                  "footer", "header", "hgroup", "listing", "main", "menu", "nav", "ol", "pre",
                  "section", "summary", "ul"), self.endTagBlock),
                ("form", self.endTagForm),
                ("p", self.endTagP),
                (("dd", "dt", "li"), self.endTagListItem),
                (headingElements, self.endTagHeading),
                (("a", "b", "big", "code", "em", "font", "i", "nobr", "s", "small",
                  "strike", "strong", "tt", "u"), self.endTagFormatting),
                (("applet", "marquee", "object"), self.endTagAppletMarqueeObject),
                ("br", self.endTagBr),
            ])
            self.endTagHandler.default = self.endTagOther

        def isMatchingFormattingElement(self, node1, node2):
            return (node1.name == node2.name and
                    node1.namespace == node2.namespace and
                    node1.attributes == node2.attributes)

        # helper
        def addFormattingElement(self, token):
            self.tree.insertElement(token)
            element = self.tree.openElements[-1]

            matchingElements = []
            for node in self.tree.activeFormattingElements[::-1]:
                if node is Marker:
                    break
                elif self.isMatchingFormattingElement(node, element):
                    matchingElements.append(node)

            assert len(matchingElements) <= 3
            if len(matchingElements) == 3:
                self.tree.activeFormattingElements.remove(matchingElements[-1])
            self.tree.activeFormattingElements.append(element)

        # the real deal
        def processEOF(self):
            allowed_elements = frozenset(("dd", "dt", "li", "p", "tbody", "td",
                                          "tfoot", "th", "thead", "tr", "body",
                                          "html"))
            for node in self.tree.openElements[::-1]:
                if node.name not in allowed_elements:
                    self.parser.parseError("expected-closing-tag-but-got-eof")
                    break
            # Stop parsing

        def processSpaceCharactersDropNewline(self, token):
            # Sometimes (start of <pre>, <listing>, and <textarea> blocks) we
            # want to drop leading newlines
            data = token["data"]
            self.processSpaceCharacters = self.processSpaceCharactersNonPre
            if (data.startswith("\n") and
                self.tree.openElements[-1].name in ("pre", "listing", "textarea") and
                    not self.tree.openElements[-1].hasContent()):
                data = data[1:]
            if data:
                self.tree.reconstructActiveFormattingElements()
                self.tree.insertText(data)

        def processCharacters(self, token):
            if token["data"] == "\u0000":
                # The tokenizer should always emit null on its own
                return
            self.tree.reconstructActiveFormattingElements()
            self.tree.insertText(token["data"])
            # This must be bad for performance
            if (self.parser.framesetOK and
                any([char not in spaceCharacters
                     for char in token["data"]])):
                self.parser.framesetOK = False

        def processSpaceCharactersNonPre(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.tree.insertText(token["data"])

        def startTagProcessInHead(self, token):
            return self.parser.phases["inHead"].processStartTag(token)

        def startTagBody(self, token):
            self.parser.parseError("unexpected-start-tag", {"name": "body"})
            if (len(self.tree.openElements) == 1 or
                    self.tree.openElements[1].name != "body"):
                assert self.parser.innerHTML
            else:
                self.parser.framesetOK = False
                for attr, value in token["data"].items():
                    if attr not in self.tree.openElements[1].attributes:
                        self.tree.openElements[1].attributes[attr] = value

        def startTagFrameset(self, token):
            self.parser.parseError("unexpected-start-tag", {"name": "frameset"})
            if (len(self.tree.openElements) == 1 or self.tree.openElements[1].name != "body"):
                assert self.parser.innerHTML
            elif not self.parser.framesetOK:
                pass
            else:
                if self.tree.openElements[1].parent:
                    self.tree.openElements[1].parent.removeChild(self.tree.openElements[1])
                while self.tree.openElements[-1].name != "html":
                    self.tree.openElements.pop()
                self.tree.insertElement(token)
                self.parser.phase = self.parser.phases["inFrameset"]

        def startTagCloseP(self, token):
            if self.tree.elementInScope("p", variant="button"):
                self.endTagP(impliedTagToken("p"))
            self.tree.insertElement(token)

        def startTagPreListing(self, token):
            if self.tree.elementInScope("p", variant="button"):
                self.endTagP(impliedTagToken("p"))
            self.tree.insertElement(token)
            self.parser.framesetOK = False
            self.processSpaceCharacters = self.processSpaceCharactersDropNewline

        def startTagForm(self, token):
            if self.tree.formPointer:
                self.parser.parseError("unexpected-start-tag", {"name": "form"})
            else:
                if self.tree.elementInScope("p", variant="button"):
                    self.endTagP(impliedTagToken("p"))
                self.tree.insertElement(token)
                self.tree.formPointer = self.tree.openElements[-1]

        def startTagListItem(self, token):
            self.parser.framesetOK = False

            stopNamesMap = {"li": ["li"],
                            "dt": ["dt", "dd"],
                            "dd": ["dt", "dd"]}
            stopNames = stopNamesMap[token["name"]]
            for node in reversed(self.tree.openElements):
                if node.name in stopNames:
                    self.parser.phase.processEndTag(
                        impliedTagToken(node.name, "EndTag"))
                    break
                if (node.nameTuple in specialElements and
                        node.name not in ("address", "div", "p")):
                    break

            if self.tree.elementInScope("p", variant="button"):
                self.parser.phase.processEndTag(
                    impliedTagToken("p", "EndTag"))

            self.tree.insertElement(token)

        def startTagPlaintext(self, token):
            if self.tree.elementInScope("p", variant="button"):
                self.endTagP(impliedTagToken("p"))
            self.tree.insertElement(token)
            self.parser.tokenizer.state = self.parser.tokenizer.plaintextState

        def startTagHeading(self, token):
            if self.tree.elementInScope("p", variant="button"):
                self.endTagP(impliedTagToken("p"))
            if self.tree.openElements[-1].name in headingElements:
                self.parser.parseError("unexpected-start-tag", {"name": token["name"]})
                self.tree.openElements.pop()
            self.tree.insertElement(token)

        def startTagA(self, token):
            afeAElement = self.tree.elementInActiveFormattingElements("a")
            if afeAElement:
                self.parser.parseError("unexpected-start-tag-implies-end-tag",
                                       {"startName": "a", "endName": "a"})
                self.endTagFormatting(impliedTagToken("a"))
                if afeAElement in self.tree.openElements:
                    self.tree.openElements.remove(afeAElement)
                if afeAElement in self.tree.activeFormattingElements:
                    self.tree.activeFormattingElements.remove(afeAElement)
            self.tree.reconstructActiveFormattingElements()
            self.addFormattingElement(token)

        def startTagFormatting(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.addFormattingElement(token)

        def startTagNobr(self, token):
            self.tree.reconstructActiveFormattingElements()
            if self.tree.elementInScope("nobr"):
                self.parser.parseError("unexpected-start-tag-implies-end-tag",
                                       {"startName": "nobr", "endName": "nobr"})
                self.processEndTag(impliedTagToken("nobr"))
                # XXX Need tests that trigger the following
                self.tree.reconstructActiveFormattingElements()
            self.addFormattingElement(token)

        def startTagButton(self, token):
            if self.tree.elementInScope("button"):
                self.parser.parseError("unexpected-start-tag-implies-end-tag",
                                       {"startName": "button", "endName": "button"})
                self.processEndTag(impliedTagToken("button"))
                return token
            else:
                self.tree.reconstructActiveFormattingElements()
                self.tree.insertElement(token)
                self.parser.framesetOK = False

        def startTagAppletMarqueeObject(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.tree.insertElement(token)
            self.tree.activeFormattingElements.append(Marker)
            self.parser.framesetOK = False

        def startTagXmp(self, token):
            if self.tree.elementInScope("p", variant="button"):
                self.endTagP(impliedTagToken("p"))
            self.tree.reconstructActiveFormattingElements()
            self.parser.framesetOK = False
            self.parser.parseRCDataRawtext(token, "RAWTEXT")

        def startTagTable(self, token):
            if self.parser.compatMode != "quirks":
                if self.tree.elementInScope("p", variant="button"):
                    self.processEndTag(impliedTagToken("p"))
            self.tree.insertElement(token)
            self.parser.framesetOK = False
            self.parser.phase = self.parser.phases["inTable"]

        def startTagVoidFormatting(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.tree.insertElement(token)
            self.tree.openElements.pop()
            token["selfClosingAcknowledged"] = True
            self.parser.framesetOK = False

        def startTagInput(self, token):
            framesetOK = self.parser.framesetOK
            self.startTagVoidFormatting(token)
            if ("type" in token["data"] and
                    token["data"]["type"].translate(asciiUpper2Lower) == "hidden"):
                # input type=hidden doesn't change framesetOK
                self.parser.framesetOK = framesetOK

        def startTagParamSource(self, token):
            self.tree.insertElement(token)
            self.tree.openElements.pop()
            token["selfClosingAcknowledged"] = True

        def startTagHr(self, token):
            if self.tree.elementInScope("p", variant="button"):
                self.endTagP(impliedTagToken("p"))
            self.tree.insertElement(token)
            self.tree.openElements.pop()
            token["selfClosingAcknowledged"] = True
            self.parser.framesetOK = False

        def startTagImage(self, token):
            # No really...
            self.parser.parseError("unexpected-start-tag-treated-as",
                                   {"originalName": "image", "newName": "img"})
            self.processStartTag(impliedTagToken("img", "StartTag",
                                                 attributes=token["data"],
                                                 selfClosing=token["selfClosing"]))

        def startTagIsIndex(self, token):
            self.parser.parseError("deprecated-tag", {"name": "isindex"})
            if self.tree.formPointer:
                return
            form_attrs = {}
            if "action" in token["data"]:
                form_attrs["action"] = token["data"]["action"]
            self.processStartTag(impliedTagToken("form", "StartTag",
                                                 attributes=form_attrs))
            self.processStartTag(impliedTagToken("hr", "StartTag"))
            self.processStartTag(impliedTagToken("label", "StartTag"))
            # XXX Localization ...
            if "prompt" in token["data"]:
                prompt = token["data"]["prompt"]
            else:
                prompt = "This is a searchable index. Enter search keywords: "
            self.processCharacters(
                {"type": tokenTypes["Characters"], "data": prompt})
            attributes = token["data"].copy()
            if "action" in attributes:
                del attributes["action"]
            if "prompt" in attributes:
                del attributes["prompt"]
            attributes["name"] = "isindex"
            self.processStartTag(impliedTagToken("input", "StartTag",
                                                 attributes=attributes,
                                                 selfClosing=token["selfClosing"]))
            self.processEndTag(impliedTagToken("label"))
            self.processStartTag(impliedTagToken("hr", "StartTag"))
            self.processEndTag(impliedTagToken("form"))

        def startTagTextarea(self, token):
            self.tree.insertElement(token)
            self.parser.tokenizer.state = self.parser.tokenizer.rcdataState
            self.processSpaceCharacters = self.processSpaceCharactersDropNewline
            self.parser.framesetOK = False

        def startTagIFrame(self, token):
            self.parser.framesetOK = False
            self.startTagRawtext(token)

        def startTagNoscript(self, token):
            if self.parser.scripting:
                self.startTagRawtext(token)
            else:
                self.startTagOther(token)

        def startTagRawtext(self, token):
            """iframe, noembed noframes, noscript(if scripting enabled)"""
            self.parser.parseRCDataRawtext(token, "RAWTEXT")

        def startTagOpt(self, token):
            if self.tree.openElements[-1].name == "option":
                self.parser.phase.processEndTag(impliedTagToken("option"))
            self.tree.reconstructActiveFormattingElements()
            self.parser.tree.insertElement(token)

        def startTagSelect(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.tree.insertElement(token)
            self.parser.framesetOK = False
            if self.parser.phase in (self.parser.phases["inTable"],
                                     self.parser.phases["inCaption"],
                                     self.parser.phases["inColumnGroup"],
                                     self.parser.phases["inTableBody"],
                                     self.parser.phases["inRow"],
                                     self.parser.phases["inCell"]):
                self.parser.phase = self.parser.phases["inSelectInTable"]
            else:
                self.parser.phase = self.parser.phases["inSelect"]

        def startTagRpRt(self, token):
            if self.tree.elementInScope("ruby"):
                self.tree.generateImpliedEndTags()
                if self.tree.openElements[-1].name != "ruby":
                    self.parser.parseError()
            self.tree.insertElement(token)

        def startTagMath(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.parser.adjustMathMLAttributes(token)
            self.parser.adjustForeignAttributes(token)
            token["namespace"] = namespaces["mathml"]
            self.tree.insertElement(token)
            # Need to get the parse error right for the case where the token
            # has a namespace not equal to the xmlns attribute
            if token["selfClosing"]:
                self.tree.openElements.pop()
                token["selfClosingAcknowledged"] = True

        def startTagSvg(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.parser.adjustSVGAttributes(token)
            self.parser.adjustForeignAttributes(token)
            token["namespace"] = namespaces["svg"]
            self.tree.insertElement(token)
            # Need to get the parse error right for the case where the token
            # has a namespace not equal to the xmlns attribute
            if token["selfClosing"]:
                self.tree.openElements.pop()
                token["selfClosingAcknowledged"] = True

        def startTagMisplaced(self, token):
            """ Elements that should be children of other elements that have a
            different insertion mode; here they are ignored
            "caption", "col", "colgroup", "frame", "frameset", "head",
            "option", "optgroup", "tbody", "td", "tfoot", "th", "thead",
            "tr", "noscript"
            """
            self.parser.parseError("unexpected-start-tag-ignored", {"name": token["name"]})

        def startTagOther(self, token):
            self.tree.reconstructActiveFormattingElements()
            self.tree.insertElement(token)

        def endTagP(self, token):
            if not self.tree.elementInScope("p", variant="button"):
                self.startTagCloseP(impliedTagToken("p", "StartTag"))
                self.parser.parseError("unexpected-end-tag", {"name": "p"})
                self.endTagP(impliedTagToken("p", "EndTag"))
            else:
                self.tree.generateImpliedEndTags("p")
                if self.tree.openElements[-1].name != "p":
                    self.parser.parseError("unexpected-end-tag", {"name": "p"})
                node = self.tree.openElements.pop()
                while node.name != "p":
                    node = self.tree.openElements.pop()

        def endTagBody(self, token):
            if not self.tree.elementInScope("body"):
                self.parser.parseError()
                return
            elif self.tree.openElements[-1].name != "body":
                for node in self.tree.openElements[2:]:
                    if node.name not in frozenset(("dd", "dt", "li", "optgroup",
                                                   "option", "p", "rp", "rt",
                                                   "tbody", "td", "tfoot",
                                                   "th", "thead", "tr", "body",
                                                   "html")):
                        # Not sure this is the correct name for the parse error
                        self.parser.parseError(
                            "expected-one-end-tag-but-got-another",
                            {"gotName": "body", "expectedName": node.name})
                        break
            self.parser.phase = self.parser.phases["afterBody"]

        def endTagHtml(self, token):
            # We repeat the test for the body end tag token being ignored here
            if self.tree.elementInScope("body"):
                self.endTagBody(impliedTagToken("body"))
                return token

        def endTagBlock(self, token):
            # Put us back in the right whitespace handling mode
            if token["name"] == "pre":
                self.processSpaceCharacters = self.processSpaceCharactersNonPre
            inScope = self.tree.elementInScope(token["name"])
            if inScope:
                self.tree.generateImpliedEndTags()
            if self.tree.openElements[-1].name != token["name"]:
                self.parser.parseError("end-tag-too-early", {"name": token["name"]})
            if inScope:
                node = self.tree.openElements.pop()
                while node.name != token["name"]:
                    node = self.tree.openElements.pop()

        def endTagForm(self, token):
            node = self.tree.formPointer
            self.tree.formPointer = None
            if node is None or not self.tree.elementInScope(node):
                self.parser.parseError("unexpected-end-tag",
                                       {"name": "form"})
            else:
                self.tree.generateImpliedEndTags()
                if self.tree.openElements[-1] != node:
                    self.parser.parseError("end-tag-too-early-ignored",
                                           {"name": "form"})
                self.tree.openElements.remove(node)

        def endTagListItem(self, token):
            if token["name"] == "li":
                variant = "list"
            else:
                variant = None
            if not self.tree.elementInScope(token["name"], variant=variant):
                self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
            else:
                self.tree.generateImpliedEndTags(exclude=token["name"])
                if self.tree.openElements[-1].name != token["name"]:
                    self.parser.parseError(
                        "end-tag-too-early",
                        {"name": token["name"]})
                node = self.tree.openElements.pop()
                while node.name != token["name"]:
                    node = self.tree.openElements.pop()

        def endTagHeading(self, token):
            for item in headingElements:
                if self.tree.elementInScope(item):
                    self.tree.generateImpliedEndTags()
                    break
            if self.tree.openElements[-1].name != token["name"]:
                self.parser.parseError("end-tag-too-early", {"name": token["name"]})

            for item in headingElements:
                if self.tree.elementInScope(item):
                    item = self.tree.openElements.pop()
                    while item.name not in headingElements:
                        item = self.tree.openElements.pop()
                    break

        def endTagFormatting(self, token):
            """The much-feared adoption agency algorithm"""
            # http://svn.whatwg.org/webapps/complete.html#adoptionAgency revision 7867
            # XXX Better parseError messages appreciated.

            # Step 1
            outerLoopCounter = 0

            # Step 2
            while outerLoopCounter < 8:

                # Step 3
                outerLoopCounter += 1

                # Step 4:

                # Let the formatting element be the last element in
                # the list of active formatting elements that:
                # - is between the end of the list and the last scope
                # marker in the list, if any, or the start of the list
                # otherwise, and
                # - has the same tag name as the token.
                formattingElement = self.tree.elementInActiveFormattingElements(
                    token["name"])
                if (not formattingElement or
                    (formattingElement in self.tree.openElements and
                     not self.tree.elementInScope(formattingElement.name))):
                    # If there is no such node, then abort these steps
                    # and instead act as described in the "any other
                    # end tag" entry below.
                    self.endTagOther(token)
                    return

                # Otherwise, if there is such a node, but that node is
                # not in the stack of open elements, then this is a
                # parse error; remove the element from the list, and
                # abort these steps.
                elif formattingElement not in self.tree.openElements:
                    self.parser.parseError("adoption-agency-1.2", {"name": token["name"]})
                    self.tree.activeFormattingElements.remove(formattingElement)
                    return

                # Otherwise, if there is such a node, and that node is
                # also in the stack of open elements, but the element
                # is not in scope, then this is a parse error; ignore
                # the token, and abort these steps.
                elif not self.tree.elementInScope(formattingElement.name):
                    self.parser.parseError("adoption-agency-4.4", {"name": token["name"]})
                    return

                # Otherwise, there is a formatting element and that
                # element is in the stack and is in scope. If the
                # element is not the current node, this is a parse
                # error. In any case, proceed with the algorithm as
                # written in the following steps.
                else:
                    if formattingElement != self.tree.openElements[-1]:
                        self.parser.parseError("adoption-agency-1.3", {"name": token["name"]})

                # Step 5:

                # Let the furthest block be the topmost node in the
                # stack of open elements that is lower in the stack
                # than the formatting element, and is an element in
                # the special category. There might not be one.
                afeIndex = self.tree.openElements.index(formattingElement)
                furthestBlock = None
                for element in self.tree.openElements[afeIndex:]:
                    if element.nameTuple in specialElements:
                        furthestBlock = element
                        break

                # Step 6:

                # If there is no furthest block, then the UA must
                # first pop all the nodes from the bottom of the stack
                # of open elements, from the current node up to and
                # including the formatting element, then remove the
                # formatting element from the list of active
                # formatting elements, and finally abort these steps.
                if furthestBlock is None:
                    element = self.tree.openElements.pop()
                    while element != formattingElement:
                        element = self.tree.openElements.pop()
                    self.tree.activeFormattingElements.remove(element)
                    return

                # Step 7
                commonAncestor = self.tree.openElements[afeIndex - 1]

                # Step 8:
                # The bookmark is supposed to help us identify where to reinsert
                # nodes in step 15. We have to ensure that we reinsert nodes after
                # the node before the active formatting element. Note the bookmark
                # can move in step 9.7
                bookmark = self.tree.activeFormattingElements.index(formattingElement)

                # Step 9
                lastNode = node = furthestBlock
                innerLoopCounter = 0

                index = self.tree.openElements.index(node)
                while innerLoopCounter < 3:
                    innerLoopCounter += 1
                    # Node is element before node in open elements
                    index -= 1
                    node = self.tree.openElements[index]
                    if node not in self.tree.activeFormattingElements:
                        self.tree.openElements.remove(node)
                        continue
                    # Step 9.6
                    if node == formattingElement:
                        break
                    # Step 9.7
                    if lastNode == furthestBlock:
                        bookmark = self.tree.activeFormattingElements.index(node) + 1
                    # Step 9.8
                    clone = node.cloneNode()
                    # Replace node with clone
                    self.tree.activeFormattingElements[
                        self.tree.activeFormattingElements.index(node)] = clone
                    self.tree.openElements[
                        self.tree.openElements.index(node)] = clone
                    node = clone
                    # Step 9.9
                    # Remove lastNode from its parents, if any
                    if lastNode.parent:
                        lastNode.parent.removeChild(lastNode)
                    node.appendChild(lastNode)
                    # Step 9.10
                    lastNode = node

                # Step 10
                # Foster parent lastNode if commonAncestor is a
                # table, tbody, tfoot, thead, or tr we need to foster
                # parent the lastNode
                if lastNode.parent:
                    lastNode.parent.removeChild(lastNode)

                if commonAncestor.name in frozenset(("table", "tbody", "tfoot", "thead", "tr")):
                    parent, insertBefore = self.tree.getTableMisnestedNodePosition()
                    parent.insertBefore(lastNode, insertBefore)
                else:
                    commonAncestor.appendChild(lastNode)

                # Step 11
                clone = formattingElement.cloneNode()

                # Step 12
                furthestBlock.reparentChildren(clone)

                # Step 13
                furthestBlock.appendChild(clone)

                # Step 14
                self.tree.activeFormattingElements.remove(formattingElement)
                self.tree.activeFormattingElements.insert(bookmark, clone)

                # Step 15
                self.tree.openElements.remove(formattingElement)
                self.tree.openElements.insert(
                    self.tree.openElements.index(furthestBlock) + 1, clone)

        def endTagAppletMarqueeObject(self, token):
            if self.tree.elementInScope(token["name"]):
                self.tree.generateImpliedEndTags()
            if self.tree.openElements[-1].name != token["name"]:
                self.parser.parseError("end-tag-too-early", {"name": token["name"]})

            if self.tree.elementInScope(token["name"]):
                element = self.tree.openElements.pop()
                while element.name != token["name"]:
                    element = self.tree.openElements.pop()
                self.tree.clearActiveFormattingElements()

        def endTagBr(self, token):
            self.parser.parseError("unexpected-end-tag-treated-as",
                                   {"originalName": "br", "newName": "br element"})
            self.tree.reconstructActiveFormattingElements()
            self.tree.insertElement(impliedTagToken("br", "StartTag"))
            self.tree.openElements.pop()

        def endTagOther(self, token):
            for node in self.tree.openElements[::-1]:
                if node.name == token["name"]:
                    self.tree.generateImpliedEndTags(exclude=token["name"])
                    if self.tree.openElements[-1].name != token["name"]:
                        self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
                    while self.tree.openElements.pop() != node:
                        pass
                    break
                else:
                    if node.nameTuple in specialElements:
                        self.parser.parseError("unexpected-end-tag", {"name": token["name"]})
                        break

    class TextPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)
            self.startTagHandler = _utils.MethodDispatcher([])
            self.startTagHandler.default = self.startTagOther
            self.endTagHandler = _utils.MethodDispatcher([
                ("script", self.endTagScript)])
            self.endTagHandler.default = self.endTagOther

        def processCharacters(self, token):
            self.tree.insertText(token["data"])

        def processEOF(self):
            self.parser.parseError("expected-named-closing-tag-but-got-eof",
                                   {"name": self.tree.openElements[-1].name})
            self.tree.openElements.pop()
            self.parser.phase = self.parser.originalPhase
            return True

        def startTagOther(self, token):
            assert False, "Tried to process start tag %s in RCDATA/RAWTEXT mode" % token['name']

        def endTagScript(self, token):
            node = self.tree.openElements.pop()
            assert node.name == "script"
            self.parser.phase = self.parser.originalPhase
            # The rest of this method is all stuff that only happens if
            # document.write works

        def endTagOther(self, token):
            self.tree.openElements.pop()
            self.parser.phase = self.parser.originalPhase

    class InTablePhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#in-table
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)
            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("caption", self.startTagCaption),
                ("colgroup", self.startTagColgroup),
                ("col", self.startTagCol),
                (("tbody", "tfoot", "thead"), self.startTagRowGroup),
                (("td", "th", "tr"), self.startTagImplyTbody),
                ("table", self.startTagTable),
                (("style", "script"), self.startTagStyleScript),
                ("input", self.startTagInput),
                ("form", self.startTagForm)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("table", self.endTagTable),
                (("body", "caption", "col", "colgroup", "html", "tbody", "td",
                  "tfoot", "th", "thead", "tr"), self.endTagIgnore)
            ])
            self.endTagHandler.default = self.endTagOther

        # helper methods
        def clearStackToTableContext(self):
            # "clear the stack back to a table context"
            while self.tree.openElements[-1].name not in ("table", "html"):
                # self.parser.parseError("unexpected-implied-end-tag-in-table",
                #  {"name":  self.tree.openElements[-1].name})
                self.tree.openElements.pop()
            # When the current node is <html> it's an innerHTML case

        # processing methods
        def processEOF(self):
            if self.tree.openElements[-1].name != "html":
                self.parser.parseError("eof-in-table")
            else:
                assert self.parser.innerHTML
            # Stop parsing

        def processSpaceCharacters(self, token):
            originalPhase = self.parser.phase
            self.parser.phase = self.parser.phases["inTableText"]
            self.parser.phase.originalPhase = originalPhase
            self.parser.phase.processSpaceCharacters(token)

        def processCharacters(self, token):
            originalPhase = self.parser.phase
            self.parser.phase = self.parser.phases["inTableText"]
            self.parser.phase.originalPhase = originalPhase
            self.parser.phase.processCharacters(token)

        def insertText(self, token):
            # If we get here there must be at least one non-whitespace character
            # Do the table magic!
            self.tree.insertFromTable = True
            self.parser.phases["inBody"].processCharacters(token)
            self.tree.insertFromTable = False

        def startTagCaption(self, token):
            self.clearStackToTableContext()
            self.tree.activeFormattingElements.append(Marker)
            self.tree.insertElement(token)
            self.parser.phase = self.parser.phases["inCaption"]

        def startTagColgroup(self, token):
            self.clearStackToTableContext()
            self.tree.insertElement(token)
            self.parser.phase = self.parser.phases["inColumnGroup"]

        def startTagCol(self, token):
            self.startTagColgroup(impliedTagToken("colgroup", "StartTag"))
            return token

        def startTagRowGroup(self, token):
            self.clearStackToTableContext()
            self.tree.insertElement(token)
            self.parser.phase = self.parser.phases["inTableBody"]

        def startTagImplyTbody(self, token):
            self.startTagRowGroup(impliedTagToken("tbody", "StartTag"))
            return token

        def startTagTable(self, token):
            self.parser.parseError("unexpected-start-tag-implies-end-tag",
                                   {"startName": "table", "endName": "table"})
            self.parser.phase.processEndTag(impliedTagToken("table"))
            if not self.parser.innerHTML:
                return token

        def startTagStyleScript(self, token):
            return self.parser.phases["inHead"].processStartTag(token)

        def startTagInput(self, token):
            if ("type" in token["data"] and
                    token["data"]["type"].translate(asciiUpper2Lower) == "hidden"):
                self.parser.parseError("unexpected-hidden-input-in-table")
                self.tree.insertElement(token)
                # XXX associate with form
                self.tree.openElements.pop()
            else:
                self.startTagOther(token)

        def startTagForm(self, token):
            self.parser.parseError("unexpected-form-in-table")
            if self.tree.formPointer is None:
                self.tree.insertElement(token)
                self.tree.formPointer = self.tree.openElements[-1]
                self.tree.openElements.pop()

        def startTagOther(self, token):
            self.parser.parseError("unexpected-start-tag-implies-table-voodoo", {"name": token["name"]})
            # Do the table magic!
            self.tree.insertFromTable = True
            self.parser.phases["inBody"].processStartTag(token)
            self.tree.insertFromTable = False

        def endTagTable(self, token):
            if self.tree.elementInScope("table", variant="table"):
                self.tree.generateImpliedEndTags()
                if self.tree.openElements[-1].name != "table":
                    self.parser.parseError("end-tag-too-early-named",
                                           {"gotName": "table",
                                            "expectedName": self.tree.openElements[-1].name})
                while self.tree.openElements[-1].name != "table":
                    self.tree.openElements.pop()
                self.tree.openElements.pop()
                self.parser.resetInsertionMode()
            else:
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()

        def endTagIgnore(self, token):
            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag-implies-table-voodoo", {"name": token["name"]})
            # Do the table magic!
            self.tree.insertFromTable = True
            self.parser.phases["inBody"].processEndTag(token)
            self.tree.insertFromTable = False

    class InTableTextPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)
            self.originalPhase = None
            self.characterTokens = []

        def flushCharacters(self):
            data = "".join([item["data"] for item in self.characterTokens])
            if any([item not in spaceCharacters for item in data]):
                token = {"type": tokenTypes["Characters"], "data": data}
                self.parser.phases["inTable"].insertText(token)
            elif data:
                self.tree.insertText(data)
            self.characterTokens = []

        def processComment(self, token):
            self.flushCharacters()
            self.parser.phase = self.originalPhase
            return token

        def processEOF(self):
            self.flushCharacters()
            self.parser.phase = self.originalPhase
            return True

        def processCharacters(self, token):
            if token["data"] == "\u0000":
                return
            self.characterTokens.append(token)

        def processSpaceCharacters(self, token):
            # pretty sure we should never reach here
            self.characterTokens.append(token)
    #        assert False

        def processStartTag(self, token):
            self.flushCharacters()
            self.parser.phase = self.originalPhase
            return token

        def processEndTag(self, token):
            self.flushCharacters()
            self.parser.phase = self.originalPhase
            return token

    class InCaptionPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#in-caption
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                (("caption", "col", "colgroup", "tbody", "td", "tfoot", "th",
                  "thead", "tr"), self.startTagTableElement)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("caption", self.endTagCaption),
                ("table", self.endTagTable),
                (("body", "col", "colgroup", "html", "tbody", "td", "tfoot", "th",
                  "thead", "tr"), self.endTagIgnore)
            ])
            self.endTagHandler.default = self.endTagOther

        def ignoreEndTagCaption(self):
            return not self.tree.elementInScope("caption", variant="table")

        def processEOF(self):
            self.parser.phases["inBody"].processEOF()

        def processCharacters(self, token):
            return self.parser.phases["inBody"].processCharacters(token)

        def startTagTableElement(self, token):
            self.parser.parseError()
            # XXX Have to duplicate logic here to find out if the tag is ignored
            ignoreEndTag = self.ignoreEndTagCaption()
            self.parser.phase.processEndTag(impliedTagToken("caption"))
            if not ignoreEndTag:
                return token

        def startTagOther(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def endTagCaption(self, token):
            if not self.ignoreEndTagCaption():
                # AT this code is quite similar to endTagTable in "InTable"
                self.tree.generateImpliedEndTags()
                if self.tree.openElements[-1].name != "caption":
                    self.parser.parseError("expected-one-end-tag-but-got-another",
                                           {"gotName": "caption",
                                            "expectedName": self.tree.openElements[-1].name})
                while self.tree.openElements[-1].name != "caption":
                    self.tree.openElements.pop()
                self.tree.openElements.pop()
                self.tree.clearActiveFormattingElements()
                self.parser.phase = self.parser.phases["inTable"]
            else:
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()

        def endTagTable(self, token):
            self.parser.parseError()
            ignoreEndTag = self.ignoreEndTagCaption()
            self.parser.phase.processEndTag(impliedTagToken("caption"))
            if not ignoreEndTag:
                return token

        def endTagIgnore(self, token):
            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

        def endTagOther(self, token):
            return self.parser.phases["inBody"].processEndTag(token)

    class InColumnGroupPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#in-column

        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("col", self.startTagCol)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("colgroup", self.endTagColgroup),
                ("col", self.endTagCol)
            ])
            self.endTagHandler.default = self.endTagOther

        def ignoreEndTagColgroup(self):
            return self.tree.openElements[-1].name == "html"

        def processEOF(self):
            if self.tree.openElements[-1].name == "html":
                assert self.parser.innerHTML
                return
            else:
                ignoreEndTag = self.ignoreEndTagColgroup()
                self.endTagColgroup(impliedTagToken("colgroup"))
                if not ignoreEndTag:
                    return True

        def processCharacters(self, token):
            ignoreEndTag = self.ignoreEndTagColgroup()
            self.endTagColgroup(impliedTagToken("colgroup"))
            if not ignoreEndTag:
                return token

        def startTagCol(self, token):
            self.tree.insertElement(token)
            self.tree.openElements.pop()
            token["selfClosingAcknowledged"] = True

        def startTagOther(self, token):
            ignoreEndTag = self.ignoreEndTagColgroup()
            self.endTagColgroup(impliedTagToken("colgroup"))
            if not ignoreEndTag:
                return token

        def endTagColgroup(self, token):
            if self.ignoreEndTagColgroup():
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()
            else:
                self.tree.openElements.pop()
                self.parser.phase = self.parser.phases["inTable"]

        def endTagCol(self, token):
            self.parser.parseError("no-end-tag", {"name": "col"})

        def endTagOther(self, token):
            ignoreEndTag = self.ignoreEndTagColgroup()
            self.endTagColgroup(impliedTagToken("colgroup"))
            if not ignoreEndTag:
                return token

    class InTableBodyPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#in-table0
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)
            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("tr", self.startTagTr),
                (("td", "th"), self.startTagTableCell),
                (("caption", "col", "colgroup", "tbody", "tfoot", "thead"),
                 self.startTagTableOther)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                (("tbody", "tfoot", "thead"), self.endTagTableRowGroup),
                ("table", self.endTagTable),
                (("body", "caption", "col", "colgroup", "html", "td", "th",
                  "tr"), self.endTagIgnore)
            ])
            self.endTagHandler.default = self.endTagOther

        # helper methods
        def clearStackToTableBodyContext(self):
            while self.tree.openElements[-1].name not in ("tbody", "tfoot",
                                                          "thead", "html"):
                # self.parser.parseError("unexpected-implied-end-tag-in-table",
                #  {"name": self.tree.openElements[-1].name})
                self.tree.openElements.pop()
            if self.tree.openElements[-1].name == "html":
                assert self.parser.innerHTML

        # the rest
        def processEOF(self):
            self.parser.phases["inTable"].processEOF()

        def processSpaceCharacters(self, token):
            return self.parser.phases["inTable"].processSpaceCharacters(token)

        def processCharacters(self, token):
            return self.parser.phases["inTable"].processCharacters(token)

        def startTagTr(self, token):
            self.clearStackToTableBodyContext()
            self.tree.insertElement(token)
            self.parser.phase = self.parser.phases["inRow"]

        def startTagTableCell(self, token):
            self.parser.parseError("unexpected-cell-in-table-body",
                                   {"name": token["name"]})
            self.startTagTr(impliedTagToken("tr", "StartTag"))
            return token

        def startTagTableOther(self, token):
            # XXX AT Any ideas on how to share this with endTagTable?
            if (self.tree.elementInScope("tbody", variant="table") or
                self.tree.elementInScope("thead", variant="table") or
                    self.tree.elementInScope("tfoot", variant="table")):
                self.clearStackToTableBodyContext()
                self.endTagTableRowGroup(
                    impliedTagToken(self.tree.openElements[-1].name))
                return token
            else:
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()

        def startTagOther(self, token):
            return self.parser.phases["inTable"].processStartTag(token)

        def endTagTableRowGroup(self, token):
            if self.tree.elementInScope(token["name"], variant="table"):
                self.clearStackToTableBodyContext()
                self.tree.openElements.pop()
                self.parser.phase = self.parser.phases["inTable"]
            else:
                self.parser.parseError("unexpected-end-tag-in-table-body",
                                       {"name": token["name"]})

        def endTagTable(self, token):
            if (self.tree.elementInScope("tbody", variant="table") or
                self.tree.elementInScope("thead", variant="table") or
                    self.tree.elementInScope("tfoot", variant="table")):
                self.clearStackToTableBodyContext()
                self.endTagTableRowGroup(
                    impliedTagToken(self.tree.openElements[-1].name))
                return token
            else:
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()

        def endTagIgnore(self, token):
            self.parser.parseError("unexpected-end-tag-in-table-body",
                                   {"name": token["name"]})

        def endTagOther(self, token):
            return self.parser.phases["inTable"].processEndTag(token)

    class InRowPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#in-row
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)
            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                (("td", "th"), self.startTagTableCell),
                (("caption", "col", "colgroup", "tbody", "tfoot", "thead",
                  "tr"), self.startTagTableOther)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("tr", self.endTagTr),
                ("table", self.endTagTable),
                (("tbody", "tfoot", "thead"), self.endTagTableRowGroup),
                (("body", "caption", "col", "colgroup", "html", "td", "th"),
                 self.endTagIgnore)
            ])
            self.endTagHandler.default = self.endTagOther

        # helper methods (XXX unify this with other table helper methods)
        def clearStackToTableRowContext(self):
            while self.tree.openElements[-1].name not in ("tr", "html"):
                self.parser.parseError("unexpected-implied-end-tag-in-table-row",
                                       {"name": self.tree.openElements[-1].name})
                self.tree.openElements.pop()

        def ignoreEndTagTr(self):
            return not self.tree.elementInScope("tr", variant="table")

        # the rest
        def processEOF(self):
            self.parser.phases["inTable"].processEOF()

        def processSpaceCharacters(self, token):
            return self.parser.phases["inTable"].processSpaceCharacters(token)

        def processCharacters(self, token):
            return self.parser.phases["inTable"].processCharacters(token)

        def startTagTableCell(self, token):
            self.clearStackToTableRowContext()
            self.tree.insertElement(token)
            self.parser.phase = self.parser.phases["inCell"]
            self.tree.activeFormattingElements.append(Marker)

        def startTagTableOther(self, token):
            ignoreEndTag = self.ignoreEndTagTr()
            self.endTagTr(impliedTagToken("tr"))
            # XXX how are we sure it's always ignored in the innerHTML case?
            if not ignoreEndTag:
                return token

        def startTagOther(self, token):
            return self.parser.phases["inTable"].processStartTag(token)

        def endTagTr(self, token):
            if not self.ignoreEndTagTr():
                self.clearStackToTableRowContext()
                self.tree.openElements.pop()
                self.parser.phase = self.parser.phases["inTableBody"]
            else:
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()

        def endTagTable(self, token):
            ignoreEndTag = self.ignoreEndTagTr()
            self.endTagTr(impliedTagToken("tr"))
            # Reprocess the current tag if the tr end tag was not ignored
            # XXX how are we sure it's always ignored in the innerHTML case?
            if not ignoreEndTag:
                return token

        def endTagTableRowGroup(self, token):
            if self.tree.elementInScope(token["name"], variant="table"):
                self.endTagTr(impliedTagToken("tr"))
                return token
            else:
                self.parser.parseError()

        def endTagIgnore(self, token):
            self.parser.parseError("unexpected-end-tag-in-table-row",
                                   {"name": token["name"]})

        def endTagOther(self, token):
            return self.parser.phases["inTable"].processEndTag(token)

    class InCellPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#in-cell
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)
            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                (("caption", "col", "colgroup", "tbody", "td", "tfoot", "th",
                  "thead", "tr"), self.startTagTableOther)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                (("td", "th"), self.endTagTableCell),
                (("body", "caption", "col", "colgroup", "html"), self.endTagIgnore),
                (("table", "tbody", "tfoot", "thead", "tr"), self.endTagImply)
            ])
            self.endTagHandler.default = self.endTagOther

        # helper
        def closeCell(self):
            if self.tree.elementInScope("td", variant="table"):
                self.endTagTableCell(impliedTagToken("td"))
            elif self.tree.elementInScope("th", variant="table"):
                self.endTagTableCell(impliedTagToken("th"))

        # the rest
        def processEOF(self):
            self.parser.phases["inBody"].processEOF()

        def processCharacters(self, token):
            return self.parser.phases["inBody"].processCharacters(token)

        def startTagTableOther(self, token):
            if (self.tree.elementInScope("td", variant="table") or
                    self.tree.elementInScope("th", variant="table")):
                self.closeCell()
                return token
            else:
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()

        def startTagOther(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def endTagTableCell(self, token):
            if self.tree.elementInScope(token["name"], variant="table"):
                self.tree.generateImpliedEndTags(token["name"])
                if self.tree.openElements[-1].name != token["name"]:
                    self.parser.parseError("unexpected-cell-end-tag",
                                           {"name": token["name"]})
                    while True:
                        node = self.tree.openElements.pop()
                        if node.name == token["name"]:
                            break
                else:
                    self.tree.openElements.pop()
                self.tree.clearActiveFormattingElements()
                self.parser.phase = self.parser.phases["inRow"]
            else:
                self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

        def endTagIgnore(self, token):
            self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

        def endTagImply(self, token):
            if self.tree.elementInScope(token["name"], variant="table"):
                self.closeCell()
                return token
            else:
                # sometimes innerHTML case
                self.parser.parseError()

        def endTagOther(self, token):
            return self.parser.phases["inBody"].processEndTag(token)

    class InSelectPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("option", self.startTagOption),
                ("optgroup", self.startTagOptgroup),
                ("select", self.startTagSelect),
                (("input", "keygen", "textarea"), self.startTagInput),
                ("script", self.startTagScript)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("option", self.endTagOption),
                ("optgroup", self.endTagOptgroup),
                ("select", self.endTagSelect)
            ])
            self.endTagHandler.default = self.endTagOther

        # http://www.whatwg.org/specs/web-apps/current-work/#in-select
        def processEOF(self):
            if self.tree.openElements[-1].name != "html":
                self.parser.parseError("eof-in-select")
            else:
                assert self.parser.innerHTML

        def processCharacters(self, token):
            if token["data"] == "\u0000":
                return
            self.tree.insertText(token["data"])

        def startTagOption(self, token):
            # We need to imply </option> if <option> is the current node.
            if self.tree.openElements[-1].name == "option":
                self.tree.openElements.pop()
            self.tree.insertElement(token)

        def startTagOptgroup(self, token):
            if self.tree.openElements[-1].name == "option":
                self.tree.openElements.pop()
            if self.tree.openElements[-1].name == "optgroup":
                self.tree.openElements.pop()
            self.tree.insertElement(token)

        def startTagSelect(self, token):
            self.parser.parseError("unexpected-select-in-select")
            self.endTagSelect(impliedTagToken("select"))

        def startTagInput(self, token):
            self.parser.parseError("unexpected-input-in-select")
            if self.tree.elementInScope("select", variant="select"):
                self.endTagSelect(impliedTagToken("select"))
                return token
            else:
                assert self.parser.innerHTML

        def startTagScript(self, token):
            return self.parser.phases["inHead"].processStartTag(token)

        def startTagOther(self, token):
            self.parser.parseError("unexpected-start-tag-in-select",
                                   {"name": token["name"]})

        def endTagOption(self, token):
            if self.tree.openElements[-1].name == "option":
                self.tree.openElements.pop()
            else:
                self.parser.parseError("unexpected-end-tag-in-select",
                                       {"name": "option"})

        def endTagOptgroup(self, token):
            # </optgroup> implicitly closes <option>
            if (self.tree.openElements[-1].name == "option" and
                    self.tree.openElements[-2].name == "optgroup"):
                self.tree.openElements.pop()
            # It also closes </optgroup>
            if self.tree.openElements[-1].name == "optgroup":
                self.tree.openElements.pop()
            # But nothing else
            else:
                self.parser.parseError("unexpected-end-tag-in-select",
                                       {"name": "optgroup"})

        def endTagSelect(self, token):
            if self.tree.elementInScope("select", variant="select"):
                node = self.tree.openElements.pop()
                while node.name != "select":
                    node = self.tree.openElements.pop()
                self.parser.resetInsertionMode()
            else:
                # innerHTML case
                assert self.parser.innerHTML
                self.parser.parseError()

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag-in-select",
                                   {"name": token["name"]})

    class InSelectInTablePhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                (("caption", "table", "tbody", "tfoot", "thead", "tr", "td", "th"),
                 self.startTagTable)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                (("caption", "table", "tbody", "tfoot", "thead", "tr", "td", "th"),
                 self.endTagTable)
            ])
            self.endTagHandler.default = self.endTagOther

        def processEOF(self):
            self.parser.phases["inSelect"].processEOF()

        def processCharacters(self, token):
            return self.parser.phases["inSelect"].processCharacters(token)

        def startTagTable(self, token):
            self.parser.parseError("unexpected-table-element-start-tag-in-select-in-table", {"name": token["name"]})
            self.endTagOther(impliedTagToken("select"))
            return token

        def startTagOther(self, token):
            return self.parser.phases["inSelect"].processStartTag(token)

        def endTagTable(self, token):
            self.parser.parseError("unexpected-table-element-end-tag-in-select-in-table", {"name": token["name"]})
            if self.tree.elementInScope(token["name"], variant="table"):
                self.endTagOther(impliedTagToken("select"))
                return token

        def endTagOther(self, token):
            return self.parser.phases["inSelect"].processEndTag(token)

    class InForeignContentPhase(Phase):
        breakoutElements = frozenset(["b", "big", "blockquote", "body", "br",
                                      "center", "code", "dd", "div", "dl", "dt",
                                      "em", "embed", "h1", "h2", "h3",
                                      "h4", "h5", "h6", "head", "hr", "i", "img",
                                      "li", "listing", "menu", "meta", "nobr",
                                      "ol", "p", "pre", "ruby", "s", "small",
                                      "span", "strong", "strike", "sub", "sup",
                                      "table", "tt", "u", "ul", "var"])

        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

        def adjustSVGTagNames(self, token):
            replacements = {"altglyph": "altGlyph",
                            "altglyphdef": "altGlyphDef",
                            "altglyphitem": "altGlyphItem",
                            "animatecolor": "animateColor",
                            "animatemotion": "animateMotion",
                            "animatetransform": "animateTransform",
                            "clippath": "clipPath",
                            "feblend": "feBlend",
                            "fecolormatrix": "feColorMatrix",
                            "fecomponenttransfer": "feComponentTransfer",
                            "fecomposite": "feComposite",
                            "feconvolvematrix": "feConvolveMatrix",
                            "fediffuselighting": "feDiffuseLighting",
                            "fedisplacementmap": "feDisplacementMap",
                            "fedistantlight": "feDistantLight",
                            "feflood": "feFlood",
                            "fefunca": "feFuncA",
                            "fefuncb": "feFuncB",
                            "fefuncg": "feFuncG",
                            "fefuncr": "feFuncR",
                            "fegaussianblur": "feGaussianBlur",
                            "feimage": "feImage",
                            "femerge": "feMerge",
                            "femergenode": "feMergeNode",
                            "femorphology": "feMorphology",
                            "feoffset": "feOffset",
                            "fepointlight": "fePointLight",
                            "fespecularlighting": "feSpecularLighting",
                            "fespotlight": "feSpotLight",
                            "fetile": "feTile",
                            "feturbulence": "feTurbulence",
                            "foreignobject": "foreignObject",
                            "glyphref": "glyphRef",
                            "lineargradient": "linearGradient",
                            "radialgradient": "radialGradient",
                            "textpath": "textPath"}

            if token["name"] in replacements:
                token["name"] = replacements[token["name"]]

        def processCharacters(self, token):
            if token["data"] == "\u0000":
                token["data"] = "\uFFFD"
            elif (self.parser.framesetOK and
                  any(char not in spaceCharacters for char in token["data"])):
                self.parser.framesetOK = False
            Phase.processCharacters(self, token)

        def processStartTag(self, token):
            currentNode = self.tree.openElements[-1]
            if (token["name"] in self.breakoutElements or
                (token["name"] == "font" and
                 set(token["data"].keys()) & set(["color", "face", "size"]))):
                self.parser.parseError("unexpected-html-element-in-foreign-content",
                                       {"name": token["name"]})
                while (self.tree.openElements[-1].namespace !=
                       self.tree.defaultNamespace and
                       not self.parser.isHTMLIntegrationPoint(self.tree.openElements[-1]) and
                       not self.parser.isMathMLTextIntegrationPoint(self.tree.openElements[-1])):
                    self.tree.openElements.pop()
                return token

            else:
                if currentNode.namespace == namespaces["mathml"]:
                    self.parser.adjustMathMLAttributes(token)
                elif currentNode.namespace == namespaces["svg"]:
                    self.adjustSVGTagNames(token)
                    self.parser.adjustSVGAttributes(token)
                self.parser.adjustForeignAttributes(token)
                token["namespace"] = currentNode.namespace
                self.tree.insertElement(token)
                if token["selfClosing"]:
                    self.tree.openElements.pop()
                    token["selfClosingAcknowledged"] = True

        def processEndTag(self, token):
            nodeIndex = len(self.tree.openElements) - 1
            node = self.tree.openElements[-1]
            if node.name.translate(asciiUpper2Lower) != token["name"]:
                self.parser.parseError("unexpected-end-tag", {"name": token["name"]})

            while True:
                if node.name.translate(asciiUpper2Lower) == token["name"]:
                    # XXX this isn't in the spec but it seems necessary
                    if self.parser.phase == self.parser.phases["inTableText"]:
                        self.parser.phase.flushCharacters()
                        self.parser.phase = self.parser.phase.originalPhase
                    while self.tree.openElements.pop() != node:
                        assert self.tree.openElements
                    new_token = None
                    break
                nodeIndex -= 1

                node = self.tree.openElements[nodeIndex]
                if node.namespace != self.tree.defaultNamespace:
                    continue
                else:
                    new_token = self.parser.phase.processEndTag(token)
                    break
            return new_token

    class AfterBodyPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([("html", self.endTagHtml)])
            self.endTagHandler.default = self.endTagOther

        def processEOF(self):
            # Stop parsing
            pass

        def processComment(self, token):
            # This is needed because data is to be appended to the <html> element
            # here and not to whatever is currently open.
            self.tree.insertComment(token, self.tree.openElements[0])

        def processCharacters(self, token):
            self.parser.parseError("unexpected-char-after-body")
            self.parser.phase = self.parser.phases["inBody"]
            return token

        def startTagHtml(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagOther(self, token):
            self.parser.parseError("unexpected-start-tag-after-body",
                                   {"name": token["name"]})
            self.parser.phase = self.parser.phases["inBody"]
            return token

        def endTagHtml(self, name):
            if self.parser.innerHTML:
                self.parser.parseError("unexpected-end-tag-after-body-innerhtml")
            else:
                self.parser.phase = self.parser.phases["afterAfterBody"]

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag-after-body",
                                   {"name": token["name"]})
            self.parser.phase = self.parser.phases["inBody"]
            return token

    class InFramesetPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#in-frameset
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("frameset", self.startTagFrameset),
                ("frame", self.startTagFrame),
                ("noframes", self.startTagNoframes)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("frameset", self.endTagFrameset)
            ])
            self.endTagHandler.default = self.endTagOther

        def processEOF(self):
            if self.tree.openElements[-1].name != "html":
                self.parser.parseError("eof-in-frameset")
            else:
                assert self.parser.innerHTML

        def processCharacters(self, token):
            self.parser.parseError("unexpected-char-in-frameset")

        def startTagFrameset(self, token):
            self.tree.insertElement(token)

        def startTagFrame(self, token):
            self.tree.insertElement(token)
            self.tree.openElements.pop()

        def startTagNoframes(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagOther(self, token):
            self.parser.parseError("unexpected-start-tag-in-frameset",
                                   {"name": token["name"]})

        def endTagFrameset(self, token):
            if self.tree.openElements[-1].name == "html":
                # innerHTML case
                self.parser.parseError("unexpected-frameset-in-frameset-innerhtml")
            else:
                self.tree.openElements.pop()
            if (not self.parser.innerHTML and
                    self.tree.openElements[-1].name != "frameset"):
                # If we're not in innerHTML mode and the current node is not a
                # "frameset" element (anymore) then switch.
                self.parser.phase = self.parser.phases["afterFrameset"]

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag-in-frameset",
                                   {"name": token["name"]})

    class AfterFramesetPhase(Phase):
        # http://www.whatwg.org/specs/web-apps/current-work/#after3
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("noframes", self.startTagNoframes)
            ])
            self.startTagHandler.default = self.startTagOther

            self.endTagHandler = _utils.MethodDispatcher([
                ("html", self.endTagHtml)
            ])
            self.endTagHandler.default = self.endTagOther

        def processEOF(self):
            # Stop parsing
            pass

        def processCharacters(self, token):
            self.parser.parseError("unexpected-char-after-frameset")

        def startTagNoframes(self, token):
            return self.parser.phases["inHead"].processStartTag(token)

        def startTagOther(self, token):
            self.parser.parseError("unexpected-start-tag-after-frameset",
                                   {"name": token["name"]})

        def endTagHtml(self, token):
            self.parser.phase = self.parser.phases["afterAfterFrameset"]

        def endTagOther(self, token):
            self.parser.parseError("unexpected-end-tag-after-frameset",
                                   {"name": token["name"]})

    class AfterAfterBodyPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml)
            ])
            self.startTagHandler.default = self.startTagOther

        def processEOF(self):
            pass

        def processComment(self, token):
            self.tree.insertComment(token, self.tree.document)

        def processSpaceCharacters(self, token):
            return self.parser.phases["inBody"].processSpaceCharacters(token)

        def processCharacters(self, token):
            self.parser.parseError("expected-eof-but-got-char")
            self.parser.phase = self.parser.phases["inBody"]
            return token

        def startTagHtml(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagOther(self, token):
            self.parser.parseError("expected-eof-but-got-start-tag",
                                   {"name": token["name"]})
            self.parser.phase = self.parser.phases["inBody"]
            return token

        def processEndTag(self, token):
            self.parser.parseError("expected-eof-but-got-end-tag",
                                   {"name": token["name"]})
            self.parser.phase = self.parser.phases["inBody"]
            return token

    class AfterAfterFramesetPhase(Phase):
        def __init__(self, parser, tree):
            Phase.__init__(self, parser, tree)

            self.startTagHandler = _utils.MethodDispatcher([
                ("html", self.startTagHtml),
                ("noframes", self.startTagNoFrames)
            ])
            self.startTagHandler.default = self.startTagOther

        def processEOF(self):
            pass

        def processComment(self, token):
            self.tree.insertComment(token, self.tree.document)

        def processSpaceCharacters(self, token):
            return self.parser.phases["inBody"].processSpaceCharacters(token)

        def processCharacters(self, token):
            self.parser.parseError("expected-eof-but-got-char")

        def startTagHtml(self, token):
            return self.parser.phases["inBody"].processStartTag(token)

        def startTagNoFrames(self, token):
            return self.parser.phases["inHead"].processStartTag(token)

        def startTagOther(self, token):
            self.parser.parseError("expected-eof-but-got-start-tag",
                                   {"name": token["name"]})

        def processEndTag(self, token):
            self.parser.parseError("expected-eof-but-got-end-tag",
                                   {"name": token["name"]})
    # pylint:enable=unused-argument

    return {
        "initial": InitialPhase,
        "beforeHtml": BeforeHtmlPhase,
        "beforeHead": BeforeHeadPhase,
        "inHead": InHeadPhase,
        "inHeadNoscript": InHeadNoscriptPhase,
        "afterHead": AfterHeadPhase,
        "inBody": InBodyPhase,
        "text": TextPhase,
        "inTable": InTablePhase,
        "inTableText": InTableTextPhase,
        "inCaption": InCaptionPhase,
        "inColumnGroup": InColumnGroupPhase,
        "inTableBody": InTableBodyPhase,
        "inRow": InRowPhase,
        "inCell": InCellPhase,
        "inSelect": InSelectPhase,
        "inSelectInTable": InSelectInTablePhase,
        "inForeignContent": InForeignContentPhase,
        "afterBody": AfterBodyPhase,
        "inFrameset": InFramesetPhase,
        "afterFrameset": AfterFramesetPhase,
        "afterAfterBody": AfterAfterBodyPhase,
        "afterAfterFrameset": AfterAfterFramesetPhase,
        # XXX after after frameset
    }


def adjust_attributes(token, replacements):
    needs_adjustment = viewkeys(token['data']) & viewkeys(replacements)
    if needs_adjustment:
        token['data'] = OrderedDict((replacements.get(k, k), v)
                                    for k, v in token['data'].items())


def impliedTagToken(name, type="EndTag", attributes=None,
                    selfClosing=False):
    if attributes is None:
        attributes = {}
    return {"type": tokenTypes[type], "name": name, "data": attributes,
            "selfClosing": selfClosing}


class ParseError(Exception):
    """Error in parsed document"""
    pass
site-packages/pip/_vendor/six.py000064400000077304151446177000012705 0ustar00# Copyright (c) 2010-2018 Benjamin Peterson
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.

"""Utilities for writing code that runs on Python 2 and 3"""

from __future__ import absolute_import

import functools
import itertools
import operator
import sys
import types

__author__ = "Benjamin Peterson <benjamin@python.org>"
__version__ = "1.12.0"


# Useful for very coarse version differentiation.
PY2 = sys.version_info[0] == 2
PY3 = sys.version_info[0] == 3
PY34 = sys.version_info[0:2] >= (3, 4)

if PY3:
    string_types = str,
    integer_types = int,
    class_types = type,
    text_type = str
    binary_type = bytes

    MAXSIZE = sys.maxsize
else:
    string_types = basestring,
    integer_types = (int, long)
    class_types = (type, types.ClassType)
    text_type = unicode
    binary_type = str

    if sys.platform.startswith("java"):
        # Jython always uses 32 bits.
        MAXSIZE = int((1 << 31) - 1)
    else:
        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
        class X(object):

            def __len__(self):
                return 1 << 31
        try:
            len(X())
        except OverflowError:
            # 32-bit
            MAXSIZE = int((1 << 31) - 1)
        else:
            # 64-bit
            MAXSIZE = int((1 << 63) - 1)
        del X


def _add_doc(func, doc):
    """Add documentation to a function."""
    func.__doc__ = doc


def _import_module(name):
    """Import module, returning the module after the last dot."""
    __import__(name)
    return sys.modules[name]


class _LazyDescr(object):

    def __init__(self, name):
        self.name = name

    def __get__(self, obj, tp):
        result = self._resolve()
        setattr(obj, self.name, result)  # Invokes __set__.
        try:
            # This is a bit ugly, but it avoids running this again by
            # removing this descriptor.
            delattr(obj.__class__, self.name)
        except AttributeError:
            pass
        return result


class MovedModule(_LazyDescr):

    def __init__(self, name, old, new=None):
        super(MovedModule, self).__init__(name)
        if PY3:
            if new is None:
                new = name
            self.mod = new
        else:
            self.mod = old

    def _resolve(self):
        return _import_module(self.mod)

    def __getattr__(self, attr):
        _module = self._resolve()
        value = getattr(_module, attr)
        setattr(self, attr, value)
        return value


class _LazyModule(types.ModuleType):

    def __init__(self, name):
        super(_LazyModule, self).__init__(name)
        self.__doc__ = self.__class__.__doc__

    def __dir__(self):
        attrs = ["__doc__", "__name__"]
        attrs += [attr.name for attr in self._moved_attributes]
        return attrs

    # Subclasses should override this
    _moved_attributes = []


class MovedAttribute(_LazyDescr):

    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
        super(MovedAttribute, self).__init__(name)
        if PY3:
            if new_mod is None:
                new_mod = name
            self.mod = new_mod
            if new_attr is None:
                if old_attr is None:
                    new_attr = name
                else:
                    new_attr = old_attr
            self.attr = new_attr
        else:
            self.mod = old_mod
            if old_attr is None:
                old_attr = name
            self.attr = old_attr

    def _resolve(self):
        module = _import_module(self.mod)
        return getattr(module, self.attr)


class _SixMetaPathImporter(object):

    """
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    """

    def __init__(self, six_module_name):
        self.name = six_module_name
        self.known_modules = {}

    def _add_module(self, mod, *fullnames):
        for fullname in fullnames:
            self.known_modules[self.name + "." + fullname] = mod

    def _get_module(self, fullname):
        return self.known_modules[self.name + "." + fullname]

    def find_module(self, fullname, path=None):
        if fullname in self.known_modules:
            return self
        return None

    def __get_module(self, fullname):
        try:
            return self.known_modules[fullname]
        except KeyError:
            raise ImportError("This loader does not know module " + fullname)

    def load_module(self, fullname):
        try:
            # in case of a reload
            return sys.modules[fullname]
        except KeyError:
            pass
        mod = self.__get_module(fullname)
        if isinstance(mod, MovedModule):
            mod = mod._resolve()
        else:
            mod.__loader__ = self
        sys.modules[fullname] = mod
        return mod

    def is_package(self, fullname):
        """
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        """
        return hasattr(self.__get_module(fullname), "__path__")

    def get_code(self, fullname):
        """Return None

        Required, if is_package is implemented"""
        self.__get_module(fullname)  # eventually raises ImportError
        return None
    get_source = get_code  # same as get_code

_importer = _SixMetaPathImporter(__name__)


class _MovedItems(_LazyModule):

    """Lazy loading of moved objects"""
    __path__ = []  # mark as package


_moved_attributes = [
    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
    MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"),
    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
    MovedAttribute("intern", "__builtin__", "sys"),
    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
    MovedAttribute("getoutput", "commands", "subprocess"),
    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"),
    MovedAttribute("reduce", "__builtin__", "functools"),
    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
    MovedAttribute("StringIO", "StringIO", "io"),
    MovedAttribute("UserDict", "UserDict", "collections"),
    MovedAttribute("UserList", "UserList", "collections"),
    MovedAttribute("UserString", "UserString", "collections"),
    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
    MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"),
    MovedModule("builtins", "__builtin__"),
    MovedModule("configparser", "ConfigParser"),
    MovedModule("copyreg", "copy_reg"),
    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
    MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"),
    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
    MovedModule("http_cookies", "Cookie", "http.cookies"),
    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
    MovedModule("html_parser", "HTMLParser", "html.parser"),
    MovedModule("http_client", "httplib", "http.client"),
    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
    MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"),
    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
    MovedModule("cPickle", "cPickle", "pickle"),
    MovedModule("queue", "Queue"),
    MovedModule("reprlib", "repr"),
    MovedModule("socketserver", "SocketServer"),
    MovedModule("_thread", "thread", "_thread"),
    MovedModule("tkinter", "Tkinter"),
    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
    MovedModule("tkinter_colorchooser", "tkColorChooser",
                "tkinter.colorchooser"),
    MovedModule("tkinter_commondialog", "tkCommonDialog",
                "tkinter.commondialog"),
    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog",
                "tkinter.simpledialog"),
    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
]
# Add windows specific modules.
if sys.platform == "win32":
    _moved_attributes += [
        MovedModule("winreg", "_winreg"),
    ]

for attr in _moved_attributes:
    setattr(_MovedItems, attr.name, attr)
    if isinstance(attr, MovedModule):
        _importer._add_module(attr, "moves." + attr.name)
del attr

_MovedItems._moved_attributes = _moved_attributes

moves = _MovedItems(__name__ + ".moves")
_importer._add_module(moves, "moves")


class Module_six_moves_urllib_parse(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_parse"""


_urllib_parse_moved_attributes = [
    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
    MovedAttribute("quote", "urllib", "urllib.parse"),
    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
    MovedAttribute("unquote", "urllib", "urllib.parse"),
    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
    MovedAttribute("unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"),
    MovedAttribute("urlencode", "urllib", "urllib.parse"),
    MovedAttribute("splitquery", "urllib", "urllib.parse"),
    MovedAttribute("splittag", "urllib", "urllib.parse"),
    MovedAttribute("splituser", "urllib", "urllib.parse"),
    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
]
for attr in _urllib_parse_moved_attributes:
    setattr(Module_six_moves_urllib_parse, attr.name, attr)
del attr

Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes

_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
                      "moves.urllib_parse", "moves.urllib.parse")


class Module_six_moves_urllib_error(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_error"""


_urllib_error_moved_attributes = [
    MovedAttribute("URLError", "urllib2", "urllib.error"),
    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
]
for attr in _urllib_error_moved_attributes:
    setattr(Module_six_moves_urllib_error, attr.name, attr)
del attr

Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes

_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
                      "moves.urllib_error", "moves.urllib.error")


class Module_six_moves_urllib_request(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_request"""


_urllib_request_moved_attributes = [
    MovedAttribute("urlopen", "urllib2", "urllib.request"),
    MovedAttribute("install_opener", "urllib2", "urllib.request"),
    MovedAttribute("build_opener", "urllib2", "urllib.request"),
    MovedAttribute("pathname2url", "urllib", "urllib.request"),
    MovedAttribute("url2pathname", "urllib", "urllib.request"),
    MovedAttribute("getproxies", "urllib", "urllib.request"),
    MovedAttribute("Request", "urllib2", "urllib.request"),
    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
    MovedAttribute("URLopener", "urllib", "urllib.request"),
    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
]
for attr in _urllib_request_moved_attributes:
    setattr(Module_six_moves_urllib_request, attr.name, attr)
del attr

Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes

_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
                      "moves.urllib_request", "moves.urllib.request")


class Module_six_moves_urllib_response(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_response"""


_urllib_response_moved_attributes = [
    MovedAttribute("addbase", "urllib", "urllib.response"),
    MovedAttribute("addclosehook", "urllib", "urllib.response"),
    MovedAttribute("addinfo", "urllib", "urllib.response"),
    MovedAttribute("addinfourl", "urllib", "urllib.response"),
]
for attr in _urllib_response_moved_attributes:
    setattr(Module_six_moves_urllib_response, attr.name, attr)
del attr

Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes

_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
                      "moves.urllib_response", "moves.urllib.response")


class Module_six_moves_urllib_robotparser(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_robotparser"""


_urllib_robotparser_moved_attributes = [
    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
]
for attr in _urllib_robotparser_moved_attributes:
    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
del attr

Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes

_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
                      "moves.urllib_robotparser", "moves.urllib.robotparser")


class Module_six_moves_urllib(types.ModuleType):

    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
    __path__ = []  # mark as package
    parse = _importer._get_module("moves.urllib_parse")
    error = _importer._get_module("moves.urllib_error")
    request = _importer._get_module("moves.urllib_request")
    response = _importer._get_module("moves.urllib_response")
    robotparser = _importer._get_module("moves.urllib_robotparser")

    def __dir__(self):
        return ['parse', 'error', 'request', 'response', 'robotparser']

_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"),
                      "moves.urllib")


def add_move(move):
    """Add an item to six.moves."""
    setattr(_MovedItems, move.name, move)


def remove_move(name):
    """Remove item from six.moves."""
    try:
        delattr(_MovedItems, name)
    except AttributeError:
        try:
            del moves.__dict__[name]
        except KeyError:
            raise AttributeError("no such move, %r" % (name,))


if PY3:
    _meth_func = "__func__"
    _meth_self = "__self__"

    _func_closure = "__closure__"
    _func_code = "__code__"
    _func_defaults = "__defaults__"
    _func_globals = "__globals__"
else:
    _meth_func = "im_func"
    _meth_self = "im_self"

    _func_closure = "func_closure"
    _func_code = "func_code"
    _func_defaults = "func_defaults"
    _func_globals = "func_globals"


try:
    advance_iterator = next
except NameError:
    def advance_iterator(it):
        return it.next()
next = advance_iterator


try:
    callable = callable
except NameError:
    def callable(obj):
        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)


if PY3:
    def get_unbound_function(unbound):
        return unbound

    create_bound_method = types.MethodType

    def create_unbound_method(func, cls):
        return func

    Iterator = object
else:
    def get_unbound_function(unbound):
        return unbound.im_func

    def create_bound_method(func, obj):
        return types.MethodType(func, obj, obj.__class__)

    def create_unbound_method(func, cls):
        return types.MethodType(func, None, cls)

    class Iterator(object):

        def next(self):
            return type(self).__next__(self)

    callable = callable
_add_doc(get_unbound_function,
         """Get the function out of a possibly unbound function""")


get_method_function = operator.attrgetter(_meth_func)
get_method_self = operator.attrgetter(_meth_self)
get_function_closure = operator.attrgetter(_func_closure)
get_function_code = operator.attrgetter(_func_code)
get_function_defaults = operator.attrgetter(_func_defaults)
get_function_globals = operator.attrgetter(_func_globals)


if PY3:
    def iterkeys(d, **kw):
        return iter(d.keys(**kw))

    def itervalues(d, **kw):
        return iter(d.values(**kw))

    def iteritems(d, **kw):
        return iter(d.items(**kw))

    def iterlists(d, **kw):
        return iter(d.lists(**kw))

    viewkeys = operator.methodcaller("keys")

    viewvalues = operator.methodcaller("values")

    viewitems = operator.methodcaller("items")
else:
    def iterkeys(d, **kw):
        return d.iterkeys(**kw)

    def itervalues(d, **kw):
        return d.itervalues(**kw)

    def iteritems(d, **kw):
        return d.iteritems(**kw)

    def iterlists(d, **kw):
        return d.iterlists(**kw)

    viewkeys = operator.methodcaller("viewkeys")

    viewvalues = operator.methodcaller("viewvalues")

    viewitems = operator.methodcaller("viewitems")

_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
_add_doc(iteritems,
         "Return an iterator over the (key, value) pairs of a dictionary.")
_add_doc(iterlists,
         "Return an iterator over the (key, [values]) pairs of a dictionary.")


if PY3:
    def b(s):
        return s.encode("latin-1")

    def u(s):
        return s
    unichr = chr
    import struct
    int2byte = struct.Struct(">B").pack
    del struct
    byte2int = operator.itemgetter(0)
    indexbytes = operator.getitem
    iterbytes = iter
    import io
    StringIO = io.StringIO
    BytesIO = io.BytesIO
    _assertCountEqual = "assertCountEqual"
    if sys.version_info[1] <= 1:
        _assertRaisesRegex = "assertRaisesRegexp"
        _assertRegex = "assertRegexpMatches"
    else:
        _assertRaisesRegex = "assertRaisesRegex"
        _assertRegex = "assertRegex"
else:
    def b(s):
        return s
    # Workaround for standalone backslash

    def u(s):
        return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape")
    unichr = unichr
    int2byte = chr

    def byte2int(bs):
        return ord(bs[0])

    def indexbytes(buf, i):
        return ord(buf[i])
    iterbytes = functools.partial(itertools.imap, ord)
    import StringIO
    StringIO = BytesIO = StringIO.StringIO
    _assertCountEqual = "assertItemsEqual"
    _assertRaisesRegex = "assertRaisesRegexp"
    _assertRegex = "assertRegexpMatches"
_add_doc(b, """Byte literal""")
_add_doc(u, """Text literal""")


def assertCountEqual(self, *args, **kwargs):
    return getattr(self, _assertCountEqual)(*args, **kwargs)


def assertRaisesRegex(self, *args, **kwargs):
    return getattr(self, _assertRaisesRegex)(*args, **kwargs)


def assertRegex(self, *args, **kwargs):
    return getattr(self, _assertRegex)(*args, **kwargs)


if PY3:
    exec_ = getattr(moves.builtins, "exec")

    def reraise(tp, value, tb=None):
        try:
            if value is None:
                value = tp()
            if value.__traceback__ is not tb:
                raise value.with_traceback(tb)
            raise value
        finally:
            value = None
            tb = None

else:
    def exec_(_code_, _globs_=None, _locs_=None):
        """Execute code in a namespace."""
        if _globs_ is None:
            frame = sys._getframe(1)
            _globs_ = frame.f_globals
            if _locs_ is None:
                _locs_ = frame.f_locals
            del frame
        elif _locs_ is None:
            _locs_ = _globs_
        exec("""exec _code_ in _globs_, _locs_""")

    exec_("""def reraise(tp, value, tb=None):
    try:
        raise tp, value, tb
    finally:
        tb = None
""")


if sys.version_info[:2] == (3, 2):
    exec_("""def raise_from(value, from_value):
    try:
        if from_value is None:
            raise value
        raise value from from_value
    finally:
        value = None
""")
elif sys.version_info[:2] > (3, 2):
    exec_("""def raise_from(value, from_value):
    try:
        raise value from from_value
    finally:
        value = None
""")
else:
    def raise_from(value, from_value):
        raise value


print_ = getattr(moves.builtins, "print", None)
if print_ is None:
    def print_(*args, **kwargs):
        """The new-style print function for Python 2.4 and 2.5."""
        fp = kwargs.pop("file", sys.stdout)
        if fp is None:
            return

        def write(data):
            if not isinstance(data, basestring):
                data = str(data)
            # If the file has an encoding, encode unicode with it.
            if (isinstance(fp, file) and
                    isinstance(data, unicode) and
                    fp.encoding is not None):
                errors = getattr(fp, "errors", None)
                if errors is None:
                    errors = "strict"
                data = data.encode(fp.encoding, errors)
            fp.write(data)
        want_unicode = False
        sep = kwargs.pop("sep", None)
        if sep is not None:
            if isinstance(sep, unicode):
                want_unicode = True
            elif not isinstance(sep, str):
                raise TypeError("sep must be None or a string")
        end = kwargs.pop("end", None)
        if end is not None:
            if isinstance(end, unicode):
                want_unicode = True
            elif not isinstance(end, str):
                raise TypeError("end must be None or a string")
        if kwargs:
            raise TypeError("invalid keyword arguments to print()")
        if not want_unicode:
            for arg in args:
                if isinstance(arg, unicode):
                    want_unicode = True
                    break
        if want_unicode:
            newline = unicode("\n")
            space = unicode(" ")
        else:
            newline = "\n"
            space = " "
        if sep is None:
            sep = space
        if end is None:
            end = newline
        for i, arg in enumerate(args):
            if i:
                write(sep)
            write(arg)
        write(end)
if sys.version_info[:2] < (3, 3):
    _print = print_

    def print_(*args, **kwargs):
        fp = kwargs.get("file", sys.stdout)
        flush = kwargs.pop("flush", False)
        _print(*args, **kwargs)
        if flush and fp is not None:
            fp.flush()

_add_doc(reraise, """Reraise an exception.""")

if sys.version_info[0:2] < (3, 4):
    def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS,
              updated=functools.WRAPPER_UPDATES):
        def wrapper(f):
            f = functools.wraps(wrapped, assigned, updated)(f)
            f.__wrapped__ = wrapped
            return f
        return wrapper
else:
    wraps = functools.wraps


def with_metaclass(meta, *bases):
    """Create a base class with a metaclass."""
    # This requires a bit of explanation: the basic idea is to make a dummy
    # metaclass for one level of class instantiation that replaces itself with
    # the actual metaclass.
    class metaclass(type):

        def __new__(cls, name, this_bases, d):
            return meta(name, bases, d)

        @classmethod
        def __prepare__(cls, name, this_bases):
            return meta.__prepare__(name, bases)
    return type.__new__(metaclass, 'temporary_class', (), {})


def add_metaclass(metaclass):
    """Class decorator for creating a class with a metaclass."""
    def wrapper(cls):
        orig_vars = cls.__dict__.copy()
        slots = orig_vars.get('__slots__')
        if slots is not None:
            if isinstance(slots, str):
                slots = [slots]
            for slots_var in slots:
                orig_vars.pop(slots_var)
        orig_vars.pop('__dict__', None)
        orig_vars.pop('__weakref__', None)
        if hasattr(cls, '__qualname__'):
            orig_vars['__qualname__'] = cls.__qualname__
        return metaclass(cls.__name__, cls.__bases__, orig_vars)
    return wrapper


def ensure_binary(s, encoding='utf-8', errors='strict'):
    """Coerce **s** to six.binary_type.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> encoded to `bytes`
      - `bytes` -> `bytes`
    """
    if isinstance(s, text_type):
        return s.encode(encoding, errors)
    elif isinstance(s, binary_type):
        return s
    else:
        raise TypeError("not expecting type '%s'" % type(s))


def ensure_str(s, encoding='utf-8', errors='strict'):
    """Coerce *s* to `str`.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    """
    if not isinstance(s, (text_type, binary_type)):
        raise TypeError("not expecting type '%s'" % type(s))
    if PY2 and isinstance(s, text_type):
        s = s.encode(encoding, errors)
    elif PY3 and isinstance(s, binary_type):
        s = s.decode(encoding, errors)
    return s


def ensure_text(s, encoding='utf-8', errors='strict'):
    """Coerce *s* to six.text_type.

    For Python 2:
      - `unicode` -> `unicode`
      - `str` -> `unicode`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    """
    if isinstance(s, binary_type):
        return s.decode(encoding, errors)
    elif isinstance(s, text_type):
        return s
    else:
        raise TypeError("not expecting type '%s'" % type(s))



def python_2_unicode_compatible(klass):
    """
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    """
    if PY2:
        if '__str__' not in klass.__dict__:
            raise ValueError("@python_2_unicode_compatible cannot be applied "
                             "to %s because it doesn't define __str__()." %
                             klass.__name__)
        klass.__unicode__ = klass.__str__
        klass.__str__ = lambda self: self.__unicode__().encode('utf-8')
    return klass


# Complete the moves implementation.
# This code is at the end of this module to speed up module loading.
# Turn this module into a package.
__path__ = []  # required for PEP 302 and PEP 451
__package__ = __name__  # see PEP 366 @ReservedAssignment
if globals().get("__spec__") is not None:
    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
# Remove other six meta path importers, since they cause problems. This can
# happen if six is removed from sys.modules and then reloaded. (Setuptools does
# this for some reason.)
if sys.meta_path:
    for i, importer in enumerate(sys.meta_path):
        # Here's some real nastiness: Another "instance" of the six module might
        # be floating around. Therefore, we can't use isinstance() to check for
        # the six meta path importer, since the other six instance will have
        # inserted an importer with different class.
        if (type(importer).__name__ == "_SixMetaPathImporter" and
                importer.name == __name__):
            del sys.meta_path[i]
            break
    del i, importer
# Finally, add the importer to the meta path import hook.
sys.meta_path.append(_importer)
site-packages/pip/_vendor/cachecontrol/heuristics.py000064400000007746151446177000016733 0ustar00import calendar
import time

from email.utils import formatdate, parsedate, parsedate_tz

from datetime import datetime, timedelta

TIME_FMT = "%a, %d %b %Y %H:%M:%S GMT"


def expire_after(delta, date=None):
    date = date or datetime.utcnow()
    return date + delta


def datetime_to_header(dt):
    return formatdate(calendar.timegm(dt.timetuple()))


class BaseHeuristic(object):

    def warning(self, response):
        """
        Return a valid 1xx warning header value describing the cache
        adjustments.

        The response is provided too allow warnings like 113
        http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need
        to explicitly say response is over 24 hours old.
        """
        return '110 - "Response is Stale"'

    def update_headers(self, response):
        """Update the response headers with any new headers.

        NOTE: This SHOULD always include some Warning header to
              signify that the response was cached by the client, not
              by way of the provided headers.
        """
        return {}

    def apply(self, response):
        updated_headers = self.update_headers(response)

        if updated_headers:
            response.headers.update(updated_headers)
            warning_header_value = self.warning(response)
            if warning_header_value is not None:
                response.headers.update({"Warning": warning_header_value})

        return response


class OneDayCache(BaseHeuristic):
    """
    Cache the response by providing an expires 1 day in the
    future.
    """

    def update_headers(self, response):
        headers = {}

        if "expires" not in response.headers:
            date = parsedate(response.headers["date"])
            expires = expire_after(timedelta(days=1), date=datetime(*date[:6]))
            headers["expires"] = datetime_to_header(expires)
            headers["cache-control"] = "public"
        return headers


class ExpiresAfter(BaseHeuristic):
    """
    Cache **all** requests for a defined time period.
    """

    def __init__(self, **kw):
        self.delta = timedelta(**kw)

    def update_headers(self, response):
        expires = expire_after(self.delta)
        return {"expires": datetime_to_header(expires), "cache-control": "public"}

    def warning(self, response):
        tmpl = "110 - Automatically cached for %s. Response might be stale"
        return tmpl % self.delta


class LastModified(BaseHeuristic):
    """
    If there is no Expires header already, fall back on Last-Modified
    using the heuristic from
    http://tools.ietf.org/html/rfc7234#section-4.2.2
    to calculate a reasonable value.

    Firefox also does something like this per
    https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ
    http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397
    Unlike mozilla we limit this to 24-hr.
    """
    cacheable_by_default_statuses = {
        200, 203, 204, 206, 300, 301, 404, 405, 410, 414, 501
    }

    def update_headers(self, resp):
        headers = resp.headers

        if "expires" in headers:
            return {}

        if "cache-control" in headers and headers["cache-control"] != "public":
            return {}

        if resp.status not in self.cacheable_by_default_statuses:
            return {}

        if "date" not in headers or "last-modified" not in headers:
            return {}

        date = calendar.timegm(parsedate_tz(headers["date"]))
        last_modified = parsedate(headers["last-modified"])
        if date is None or last_modified is None:
            return {}

        now = time.time()
        current_age = max(0, now - date)
        delta = date - calendar.timegm(last_modified)
        freshness_lifetime = max(0, min(delta / 10, 24 * 3600))
        if freshness_lifetime <= current_age:
            return {}

        expires = date + freshness_lifetime
        return {"expires": time.strftime(TIME_FMT, time.gmtime(expires))}

    def warning(self, resp):
        return None
site-packages/pip/_vendor/cachecontrol/caches/file_cache.py000064400000010071151446177000020022 0ustar00import hashlib
import os
from textwrap import dedent

from ..cache import BaseCache
from ..controller import CacheController

try:
    FileNotFoundError
except NameError:
    # py2.X
    FileNotFoundError = (IOError, OSError)


def _secure_open_write(filename, fmode):
    # We only want to write to this file, so open it in write only mode
    flags = os.O_WRONLY

    # os.O_CREAT | os.O_EXCL will fail if the file already exists, so we only
    #  will open *new* files.
    # We specify this because we want to ensure that the mode we pass is the
    # mode of the file.
    flags |= os.O_CREAT | os.O_EXCL

    # Do not follow symlinks to prevent someone from making a symlink that
    # we follow and insecurely open a cache file.
    if hasattr(os, "O_NOFOLLOW"):
        flags |= os.O_NOFOLLOW

    # On Windows we'll mark this file as binary
    if hasattr(os, "O_BINARY"):
        flags |= os.O_BINARY

    # Before we open our file, we want to delete any existing file that is
    # there
    try:
        os.remove(filename)
    except (IOError, OSError):
        # The file must not exist already, so we can just skip ahead to opening
        pass

    # Open our file, the use of os.O_CREAT | os.O_EXCL will ensure that if a
    # race condition happens between the os.remove and this line, that an
    # error will be raised. Because we utilize a lockfile this should only
    # happen if someone is attempting to attack us.
    fd = os.open(filename, flags, fmode)
    try:
        return os.fdopen(fd, "wb")

    except:
        # An error occurred wrapping our FD in a file object
        os.close(fd)
        raise


class FileCache(BaseCache):

    def __init__(
        self,
        directory,
        forever=False,
        filemode=0o0600,
        dirmode=0o0700,
        use_dir_lock=None,
        lock_class=None,
    ):

        if use_dir_lock is not None and lock_class is not None:
            raise ValueError("Cannot use use_dir_lock and lock_class together")

        try:
            from lockfile import LockFile
            from lockfile.mkdirlockfile import MkdirLockFile
        except ImportError:
            notice = dedent(
                """
            NOTE: In order to use the FileCache you must have
            lockfile installed. You can install it via pip:
              pip install lockfile
            """
            )
            raise ImportError(notice)

        else:
            if use_dir_lock:
                lock_class = MkdirLockFile

            elif lock_class is None:
                lock_class = LockFile

        self.directory = directory
        self.forever = forever
        self.filemode = filemode
        self.dirmode = dirmode
        self.lock_class = lock_class

    @staticmethod
    def encode(x):
        return hashlib.sha224(x.encode()).hexdigest()

    def _fn(self, name):
        # NOTE: This method should not change as some may depend on it.
        #       See: https://github.com/ionrock/cachecontrol/issues/63
        hashed = self.encode(name)
        parts = list(hashed[:5]) + [hashed]
        return os.path.join(self.directory, *parts)

    def get(self, key):
        name = self._fn(key)
        try:
            with open(name, "rb") as fh:
                return fh.read()

        except FileNotFoundError:
            return None

    def set(self, key, value):
        name = self._fn(key)

        # Make sure the directory exists
        try:
            os.makedirs(os.path.dirname(name), self.dirmode)
        except (IOError, OSError):
            pass

        with self.lock_class(name) as lock:
            # Write our actual file
            with _secure_open_write(lock.path, self.filemode) as fh:
                fh.write(value)

    def delete(self, key):
        name = self._fn(key)
        if not self.forever:
            try:
                os.remove(name)
            except FileNotFoundError:
                pass


def url_to_file_path(url, filecache):
    """Return the file cache path based on the URL.

    This does not ensure the file exists!
    """
    key = CacheController.cache_url(url)
    return filecache._fn(key)
site-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000401151446177000024740 0ustar00U

��.eV�@sddlmZddlmZdS)�)�	FileCache)�
RedisCacheN)Z
file_cacherZredis_cacher�rr�L/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/caches/__init__.py�<module>ssite-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-38.opt-1.pyc000064400000002771151446177000025446 0ustar00U

��.eX�@s8ddlmZddlmZddlmZGdd�de�ZdS)�)�division)�datetime)�	BaseCachec@s>eZdZdd�Zdd�Zddd�Zdd	�Zd
d�Zdd
�ZdS)�
RedisCachecCs
||_dS�N)�conn)�selfr�r	�O/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py�__init__	szRedisCache.__init__cCs|j�|�Sr)r�get�r�keyr	r	r
rszRedisCache.getNcCs<|s|j�||�n$|t��}|j�|t|���|�dSr)r�setrZutcnowZsetex�intZ
total_seconds)rr�valueZexpiresr	r	r
rszRedisCache.setcCs|j�|�dSr)r�deleter
r	r	r
rszRedisCache.deletecCs |j��D]}|j�|�q
dS)zIHelper for clearing all the keys in a database. Use with
        caution!N)r�keysrr
r	r	r
�clearszRedisCache.clearcCsdS)z?Redis uses connection pooling, no need to close the connection.Nr	)rr	r	r
�closeszRedisCache.close)N)	�__name__�
__module__�__qualname__rrrrrrr	r	r	r
rs
rN)Z
__future__rrZpip._vendor.cachecontrol.cacherrr	r	r	r
�<module>ssite-packages/pip/_vendor/cachecontrol/caches/__pycache__/redis_cache.cpython-38.pyc000064400000002771151446177000024507 0ustar00U

��.eX�@s8ddlmZddlmZddlmZGdd�de�ZdS)�)�division)�datetime)�	BaseCachec@s>eZdZdd�Zdd�Zddd�Zdd	�Zd
d�Zdd
�ZdS)�
RedisCachecCs
||_dS�N)�conn)�selfr�r	�O/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py�__init__	szRedisCache.__init__cCs|j�|�Sr)r�get�r�keyr	r	r
rszRedisCache.getNcCs<|s|j�||�n$|t��}|j�|t|���|�dSr)r�setrZutcnowZsetex�intZ
total_seconds)rr�valueZexpiresr	r	r
rszRedisCache.setcCs|j�|�dSr)r�deleter
r	r	r
rszRedisCache.deletecCs |j��D]}|j�|�q
dS)zIHelper for clearing all the keys in a database. Use with
        caution!N)r�keysrr
r	r	r
�clearszRedisCache.clearcCsdS)z?Redis uses connection pooling, no need to close the connection.Nr	)rr	r	r
�closeszRedisCache.close)N)	�__name__�
__module__�__qualname__rrrrrrr	r	r	r
rs
rN)Z
__future__rrZpip._vendor.cachecontrol.cacherrr	r	r	r
�<module>ssite-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-38.opt-1.pyc000064400000006237151446177000025260 0ustar00U

��.e9�@s~ddlZddlZddlmZddlmZddlmZzeWne	k
rXe
efZYnXdd�ZGdd	�d	e�Z
d
d�ZdS)�N)�dedent�)�	BaseCache)�CacheControllerc	Cs�tj}|tjtjBO}ttd�r*|tjO}ttd�r>|tjO}zt�|�Wntt	fk
rdYnXt�
|||�}zt�|d�WSt�|��YnXdS)N�
O_NOFOLLOW�O_BINARY�wb)
�os�O_WRONLY�O_CREAT�O_EXCL�hasattrrr�remove�IOError�OSError�open�fdopen�close)�filenameZfmode�flags�fd�r�N/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py�_secure_open_writes 




rc@sBeZdZddd�Zedd��Zd	d
�Zdd�Zd
d�Zdd�Z	dS)�	FileCacheF��Nc
Cs�|dk	r|dk	rtd��zddlm}ddlm}Wn$tk
rXtd�}	t|	��YnX|rd|}n|dkrp|}||_||_||_	||_
||_dS)Nz/Cannot use use_dir_lock and lock_class togetherr)�LockFile)�
MkdirLockFilez�
            NOTE: In order to use the FileCache you must have
            lockfile installed. You can install it via pip:
              pip install lockfile
            )�
ValueErrorZlockfilerZlockfile.mkdirlockfiler�ImportErrorr�	directory�forever�filemode�dirmode�
lock_class)
�selfr!r"r#r$Zuse_dir_lockr%rrZnoticerrr�__init__:s&
�zFileCache.__init__cCst�|�����S�N)�hashlibZsha224�encodeZ	hexdigest)�xrrrr*aszFileCache.encodecCs4|�|�}t|dd��|g}tjj|jf|��S)N�)r*�listr	�path�joinr!)r&�nameZhashed�partsrrr�_fnes
z
FileCache._fnc
CsR|�|�}z,t|d��}|��W5QR�WSQRXWntk
rLYdSXdS)N�rb)r2r�read�FileNotFoundError)r&�keyr0�fhrrr�getls
 z
FileCache.getc
Cs||�|�}zt�tj�|�|j�Wnttfk
r<YnX|�|��*}t	|j|j
��}|�|�W5QRXW5QRXdSr()r2r	�makedirsr.�dirnamer$rrr%rr#�write)r&r6�valuer0�lockr7rrr�setus
z
FileCache.setcCs8|�|�}|js4zt�|�Wntk
r2YnXdSr()r2r"r	rr5)r&r6r0rrr�delete�s
zFileCache.delete)FrrNN)
�__name__�
__module__�__qualname__r'�staticmethodr*r2r8r>r?rrrrr8s�
'
	rcCst�|�}|�|�S)z\Return the file cache path based on the URL.

    This does not ensure the file exists!
    )rZ	cache_urlr2)ZurlZ	filecacher6rrr�url_to_file_path�s
rD)r)r	�textwrapr�cacherZ
controllerrr5�	NameErrorrrrrrDrrrr�<module>s)Tsite-packages/pip/_vendor/cachecontrol/caches/__pycache__/file_cache.cpython-38.pyc000064400000006237151446177000024321 0ustar00U

��.e9�@s~ddlZddlZddlmZddlmZddlmZzeWne	k
rXe
efZYnXdd�ZGdd	�d	e�Z
d
d�ZdS)�N)�dedent�)�	BaseCache)�CacheControllerc	Cs�tj}|tjtjBO}ttd�r*|tjO}ttd�r>|tjO}zt�|�Wntt	fk
rdYnXt�
|||�}zt�|d�WSt�|��YnXdS)N�
O_NOFOLLOW�O_BINARY�wb)
�os�O_WRONLY�O_CREAT�O_EXCL�hasattrrr�remove�IOError�OSError�open�fdopen�close)�filenameZfmode�flags�fd�r�N/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/caches/file_cache.py�_secure_open_writes 




rc@sBeZdZddd�Zedd��Zd	d
�Zdd�Zd
d�Zdd�Z	dS)�	FileCacheF��Nc
Cs�|dk	r|dk	rtd��zddlm}ddlm}Wn$tk
rXtd�}	t|	��YnX|rd|}n|dkrp|}||_||_||_	||_
||_dS)Nz/Cannot use use_dir_lock and lock_class togetherr)�LockFile)�
MkdirLockFilez�
            NOTE: In order to use the FileCache you must have
            lockfile installed. You can install it via pip:
              pip install lockfile
            )�
ValueErrorZlockfilerZlockfile.mkdirlockfiler�ImportErrorr�	directory�forever�filemode�dirmode�
lock_class)
�selfr!r"r#r$Zuse_dir_lockr%rrZnoticerrr�__init__:s&
�zFileCache.__init__cCst�|�����S�N)�hashlibZsha224�encodeZ	hexdigest)�xrrrr*aszFileCache.encodecCs4|�|�}t|dd��|g}tjj|jf|��S)N�)r*�listr	�path�joinr!)r&�nameZhashed�partsrrr�_fnes
z
FileCache._fnc
CsR|�|�}z,t|d��}|��W5QR�WSQRXWntk
rLYdSXdS)N�rb)r2r�read�FileNotFoundError)r&�keyr0�fhrrr�getls
 z
FileCache.getc
Cs||�|�}zt�tj�|�|j�Wnttfk
r<YnX|�|��*}t	|j|j
��}|�|�W5QRXW5QRXdSr()r2r	�makedirsr.�dirnamer$rrr%rr#�write)r&r6�valuer0�lockr7rrr�setus
z
FileCache.setcCs8|�|�}|js4zt�|�Wntk
r2YnXdSr()r2r"r	rr5)r&r6r0rrr�delete�s
zFileCache.delete)FrrNN)
�__name__�
__module__�__qualname__r'�staticmethodr*r2r8r>r?rrrrr8s�
'
	rcCst�|�}|�|�S)z\Return the file cache path based on the URL.

    This does not ensure the file exists!
    )rZ	cache_urlr2)ZurlZ	filecacher6rrr�url_to_file_path�s
rD)r)r	�textwrapr�cacherZ
controllerrr5�	NameErrorrrrrrDrrrr�<module>s)Tsite-packages/pip/_vendor/cachecontrol/caches/__pycache__/__init__.cpython-38.pyc000064400000000401151446177000024001 0ustar00U

��.eV�@sddlmZddlmZdS)�)�	FileCache)�
RedisCacheN)Z
file_cacherZredis_cacher�rr�L/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/caches/__init__.py�<module>ssite-packages/pip/_vendor/cachecontrol/caches/__init__.py000064400000000126151446177000017517 0ustar00from .file_cache import FileCache  # noqa
from .redis_cache import RedisCache  # noqa
site-packages/pip/_vendor/cachecontrol/caches/redis_cache.py000064400000001530151446177000020211 0ustar00from __future__ import division

from datetime import datetime
from pip._vendor.cachecontrol.cache import BaseCache


class RedisCache(BaseCache):

    def __init__(self, conn):
        self.conn = conn

    def get(self, key):
        return self.conn.get(key)

    def set(self, key, value, expires=None):
        if not expires:
            self.conn.set(key, value)
        else:
            expires = expires - datetime.utcnow()
            self.conn.setex(key, int(expires.total_seconds()), value)

    def delete(self, key):
        self.conn.delete(key)

    def clear(self):
        """Helper for clearing all the keys in a database. Use with
        caution!"""
        for key in self.conn.keys():
            self.conn.delete(key)

    def close(self):
        """Redis uses connection pooling, no need to close the connection."""
        pass
site-packages/pip/_vendor/cachecontrol/compat.py000064400000001267151446177000016024 0ustar00try:
    from urllib.parse import urljoin
except ImportError:
    from urlparse import urljoin


try:
    import cPickle as pickle
except ImportError:
    import pickle


# Handle the case where the requests module has been patched to not have
# urllib3 bundled as part of its source.
try:
    from pip._vendor.requests.packages.urllib3.response import HTTPResponse
except ImportError:
    from pip._vendor.urllib3.response import HTTPResponse

try:
    from pip._vendor.requests.packages.urllib3.util import is_fp_closed
except ImportError:
    from pip._vendor.urllib3.util import is_fp_closed

# Replicate some six behaviour
try:
    text_type = unicode
except NameError:
    text_type = str
site-packages/pip/_vendor/cachecontrol/filewrapper.py000064400000004745151446177000017065 0ustar00from io import BytesIO


class CallbackFileWrapper(object):
    """
    Small wrapper around a fp object which will tee everything read into a
    buffer, and when that file is closed it will execute a callback with the
    contents of that buffer.

    All attributes are proxied to the underlying file object.

    This class uses members with a double underscore (__) leading prefix so as
    not to accidentally shadow an attribute.
    """

    def __init__(self, fp, callback):
        self.__buf = BytesIO()
        self.__fp = fp
        self.__callback = callback

    def __getattr__(self, name):
        # The vaguaries of garbage collection means that self.__fp is
        # not always set.  By using __getattribute__ and the private
        # name[0] allows looking up the attribute value and raising an
        # AttributeError when it doesn't exist. This stop thigns from
        # infinitely recursing calls to getattr in the case where
        # self.__fp hasn't been set.
        #
        # [0] https://docs.python.org/2/reference/expressions.html#atom-identifiers
        fp = self.__getattribute__("_CallbackFileWrapper__fp")
        return getattr(fp, name)

    def __is_fp_closed(self):
        try:
            return self.__fp.fp is None

        except AttributeError:
            pass

        try:
            return self.__fp.closed

        except AttributeError:
            pass

        # We just don't cache it then.
        # TODO: Add some logging here...
        return False

    def _close(self):
        if self.__callback:
            self.__callback(self.__buf.getvalue())

        # We assign this to None here, because otherwise we can get into
        # really tricky problems where the CPython interpreter dead locks
        # because the callback is holding a reference to something which
        # has a __del__ method. Setting this to None breaks the cycle
        # and allows the garbage collector to do it's thing normally.
        self.__callback = None

    def read(self, amt=None):
        data = self.__fp.read(amt)
        self.__buf.write(data)
        if self.__is_fp_closed():
            self._close()

        return data

    def _safe_read(self, amt):
        data = self.__fp._safe_read(amt)
        if amt == 2 and data == b"\r\n":
            # urllib executes this read to toss the CRLF at the end
            # of the chunk.
            return data

        self.__buf.write(data)
        if self.__is_fp_closed():
            self._close()

        return data
site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001001151446177000023507 0ustar00U

��.e.�@s8dZdZdZdZddlmZddlmZddlm	Z	dS)	zbCacheControl import Interface.

Make it easy to import from cachecontrol without long namespaces.
zEric Larsonzeric@ionrock.orgz0.12.5�)�CacheControl)�CacheControlAdapter)�CacheControllerN)
�__doc__�
__author__Z	__email__�__version__�wrapperrZadapterrZ
controllerr�r	r	�E/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/__init__.py�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-38.opt-1.pyc000064400000004133151446177000024301 0ustar00U

��.e�	�@s ddlmZGdd�de�ZdS)�)�BytesIOc@sBeZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	d
S)�CallbackFileWrapperav
    Small wrapper around a fp object which will tee everything read into a
    buffer, and when that file is closed it will execute a callback with the
    contents of that buffer.

    All attributes are proxied to the underlying file object.

    This class uses members with a double underscore (__) leading prefix so as
    not to accidentally shadow an attribute.
    cCst�|_||_||_dS�N)r�_CallbackFileWrapper__buf�_CallbackFileWrapper__fp�_CallbackFileWrapper__callback)�self�fp�callback�r�H/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/filewrapper.py�__init__szCallbackFileWrapper.__init__cCs|�d�}t||�S)Nr)�__getattribute__�getattr)r�namer	rrr�__getattr__s	
zCallbackFileWrapper.__getattr__cCsHz|jjdkWStk
r"YnXz
|jjWStk
rBYnXdS)NF)rr	�AttributeError�closed�rrrrZ__is_fp_closed!s
z"CallbackFileWrapper.__is_fp_closedcCs |jr|�|j���d|_dSr)rr�getvaluerrrr�_close2szCallbackFileWrapper._closeNcCs,|j�|�}|j�|�|��r(|��|Sr)r�readr�write�"_CallbackFileWrapper__is_fp_closedr�rZamt�datarrrr=s
zCallbackFileWrapper.readcCs@|j�|�}|dkr |dkr |S|j�|�|��r<|��|S)N�s
)r�
_safe_readrrrrrrrrrEszCallbackFileWrapper._safe_read)N)
�__name__�
__module__�__qualname__�__doc__r
rrrrrrrrrrs
rN)�ior�objectrrrrr�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/compat.cpython-38.pyc000064400000001320151446177000022300 0ustar00U

��.e��@s�zddlmZWn ek
r0ddlmZYnXzddlZWnek
rZddlZYnXzddlmZWn ek
r�ddlmZYnXzddl	m
Z
Wn ek
r�ddlm
Z
YnXzeZ
Wnek
r�eZ
YnXdS)�)�urljoinN)�HTTPResponse)�is_fp_closed)Zurllib.parser�ImportErrorZurlparseZcPickle�pickleZ.pip._vendor.requests.packages.urllib3.responserZpip._vendor.urllib3.responseZ*pip._vendor.requests.packages.urllib3.utilrZpip._vendor.urllib3.utilZunicodeZ	text_type�	NameError�str�r	r	�C/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/compat.py�<module>s&site-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-38.opt-1.pyc000064400000010163151446177000023750 0ustar00U

��.e*�@spddlZddlZddlZddlZddlmZddlmZddlm	Z	m
Z
mZdd�Zdd	�Z
Gd
d�de�ZdS)�N)�msgpack)�CaseInsensitiveDict�)�HTTPResponse�pickle�	text_typecCst�|�d��S)N�ascii)�base64Z	b64decode�encode)�b�r�F/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/serialize.py�_b64_decode_bytessrcCst|��d�S)N�utf8)r�decode)�srrr
�_b64_decode_strsrc@sNeZdZddd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dS)�
SerializerNc		Cs�t|j�}|dkr*|jdd�}t�|�|_d|tdd�|j��D��|j|j	t
|j�|j|j
d�i}i|d<d|kr�|d�d�}|D]:}t
|���}|j�|d�}|dk	r�t
|�}||d|<q�d	�d
tj|dd�g�S)
NF)�decode_content�responsecss"|]\}}t|�t|�fVqdS�N)r��.0�k�vrrr
�	<genexpr>2sz#Serializer.dumps.<locals>.<genexpr>)�body�headers�status�version�reason�strictr�vary�,�,scc=4T)Zuse_bin_type)rr�read�io�BytesIOZ_fp�dict�itemsrrrr r!r�split�strip�get�joinr�dumps)	�self�requestrrZresponse_headers�dataZvaried_headers�headerZheader_valuerrr
r.s4

���zSerializer.dumpscCs�|sdSz|�dd�\}}Wntk
r4d}YnX|dd�dkrR||}d}|�dd�d�d�}zt|d	�|��||�WStk
r�YdSXdS)
Nr$rscc=0�scc=�=���rz
_loads_v{})r*�
ValueErrorr�getattr�format�AttributeError)r/r0r1Zverrrr
�loadsJs
zSerializer.loadscCs�d|�di�krdS|�di���D] \}}|j�|d�|kr$dSq$|d�d�}t|ddd�}|�dd	�d
kr�|�d�||dd<zt�|�}Wn$tk
r�t�|�d��}YnXt	f|dd
�|d��S)z`Verify our vary headers match and construct a real urllib3
        HTTPResponse object.
        �*r"Nrrr)r1ztransfer-encoding�ZchunkedrF)rZpreload_content)
r,r)r�poprr&r'�	TypeErrorr
r)r/r0�cachedr2�valueZbody_rawrrrrr
�prepare_responsehs
zSerializer.prepare_responsecCsdSrr�r/r0r1rrr
�	_loads_v0�szSerializer._loads_v0cCs2zt�|�}Wntk
r$YdSX|�||�Sr)rr:r6rA�r/r0r1r?rrr
�	_loads_v1�s
zSerializer._loads_v1c	Cs�zt�t�|��d��}Wnttjfk
r6YdSXt|dd�|dd<tdd�|dd�	�D��|dd<t
|dd�|dd<tdd�|d	�	�D��|d	<|�||�S)
Nrrrcss"|]\}}t|�t|�fVqdSr�rrrrr
r�s�z'Serializer._loads_v2.<locals>.<genexpr>rr css.|]&\}}t|�|dk	r t|�n|fVqdSrrFrrrr
r�s�r")�jsonr:�zlib�
decompressrr6�errorrr(r)rrArDrrr
�	_loads_v2�s�
�zSerializer._loads_v2cCsdSrrrBrrr
�	_loads_v3�szSerializer._loads_v3cCs6ztj|dd�}Wntk
r(YdSX|�||�S)Nzutf-8)�encoding)rr:r6rArDrrr
�	_loads_v4�s
zSerializer._loads_v4)N)�__name__�
__module__�__qualname__r.r:rArCrErKrLrNrrrr
rs
4$r)r	r&rGrHZpip._vendorrZpip._vendor.requests.structuresr�compatrrrrr�objectrrrrr
�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/adapter.cpython-38.pyc000064400000005737151446177000022455 0ustar00U

��.e��@s\ddlZddlZddlZddlmZddlmZddlmZddl	m
Z
Gdd�de�ZdS)	�N)�HTTPAdapter�)�CacheController)�	DictCache)�CallbackFileWrappercsNeZdZddhZd�fdd�	Zd�fdd�	Zd�fd
d�	Z�fdd
�Z�ZS)�CacheControlAdapterZPUTZDELETENTc
sLtt|�j||�|pt�|_||_|p*d|_|p4t}	|	|j||d�|_dS)N)ZGET)�cache_etags�
serializer)	�superr�__init__r�cache�	heuristic�cacheable_methodsr�
controller)
�selfrrZcontroller_classr	r
r�args�kwZcontroller_factory��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/adapter.pyrs
�zCacheControlAdapter.__init__cs�|p|j}|j|krhz|j�|�}Wntjk
r>d}YnX|rT|j||dd�S|j�|j�	|��t
t|�j|f|�}|S)z�
        Send a request. Use the request information to see if it
        exists in the cache and cache the response if we need to and can.
        NT)�
from_cache)
r�methodrZcached_request�zlib�error�build_responseZheaders�updateZconditional_headersr
r�send)r�requestrr�	cacheable�cached_response�resprrrr$s


zCacheControlAdapter.sendFc
s|p|j}|s�|j|kr�|jr*|j�|�}|jdkrh|j�||�}||k	rNd}|jdd�|��|}n\|jdkr�|j�	||�nBt
|jt�
|jj	||��|_|jr�|j��fdd�}t�||�|_tt|��||�}|j|jk�r|j�r|j�|j�}	|j�|	�||_|S)z�
        Build a response by making a request or using the cache.

        This will end up calling send and returning a potentially
        cached response
        i0TF)Zdecode_contenti-cs��|jdkr|j��dS)Nr)Z
chunk_left�_fpZ_close�r�Zsuper_update_chunk_lengthrr�_update_chunk_lengthns
z@CacheControlAdapter.build_response.<locals>._update_chunk_length)rrr
ZapplyZstatusrZupdate_cached_response�readZrelease_connZcache_responserr"�	functools�partialZchunkedr%�types�
MethodTyper
rr�invalidating_methods�ok�	cache_urlZurlr�deleter)
rrZresponserrrr r%r!r-rr$rr9sJ	

�
���z"CacheControlAdapter.build_responsecs|j��tt|���dS)N)r�closer
rr#rrrr/�s
zCacheControlAdapter.close)NTNNNN)N)FN)	�__name__�
__module__�__qualname__r+rrrr/�
__classcell__rrrrrs��Jr)r)r'rZpip._vendor.requests.adaptersrrrrrZfilewrapperrrrrrr�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-38.opt-1.pyc000064400000011132151446177000024140 0ustar00U

��.e��@s�ddlZddlZddlmZmZmZddlmZmZdZddd�Z	dd�Z
Gd	d
�d
e�ZGdd�de�Z
Gd
d�de�ZGdd�de�ZdS)�N)�
formatdate�	parsedate�parsedate_tz)�datetime�	timedeltaz%a, %d %b %Y %H:%M:%S GMTcCs|p
t��}||S�N)rZutcnow)�delta�date�r
�G/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/heuristics.py�expire_aftersrcCstt�|����Sr)r�calendar�timegmZ	timetuple)Zdtr
r
r�datetime_to_headersrc@s$eZdZdd�Zdd�Zdd�ZdS)�
BaseHeuristiccCsdS)a!
        Return a valid 1xx warning header value describing the cache
        adjustments.

        The response is provided too allow warnings like 113
        http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need
        to explicitly say response is over 24 hours old.
        z110 - "Response is Stale"r
��self�responser
r
r�warnings	zBaseHeuristic.warningcCsiS)z�Update the response headers with any new headers.

        NOTE: This SHOULD always include some Warning header to
              signify that the response was cached by the client, not
              by way of the provided headers.
        r
rr
r
r�update_headers!szBaseHeuristic.update_headerscCs@|�|�}|r<|j�|�|�|�}|dk	r<|j�d|i�|S)N�Warning)r�headers�updater)rrZupdated_headersZwarning_header_valuer
r
r�apply*s

zBaseHeuristic.applyN)�__name__�
__module__�__qualname__rrrr
r
r
rrs	rc@seZdZdZdd�ZdS)�OneDayCachezM
    Cache the response by providing an expires 1 day in the
    future.
    cCsRi}d|jkrNt|jd�}ttdd�t|dd��d�}t|�|d<d|d<|S)	N�expiresr	�)Zdays�)r	�public�
cache-control)rrrrrr)rrrr	rr
r
rr<s
zOneDayCache.update_headersN)rrr�__doc__rr
r
r
rr6src@s(eZdZdZdd�Zdd�Zdd�ZdS)	�ExpiresAfterz;
    Cache **all** requests for a defined time period.
    cKstf|�|_dSr)rr)r�kwr
r
r�__init__LszExpiresAfter.__init__cCst|j�}t|�dd�S)Nr!)rr")rrr)rrrr
r
rrOs
zExpiresAfter.update_headerscCsd}||jS)Nz:110 - Automatically cached for %s. Response might be stale)r)rrZtmplr
r
rrSszExpiresAfter.warningN)rrrr#r&rrr
r
r
rr$Gsr$c@s:eZdZdZdddddddd	d
ddhZd
d�Zdd�ZdS)�LastModifieda�
    If there is no Expires header already, fall back on Last-Modified
    using the heuristic from
    http://tools.ietf.org/html/rfc7234#section-4.2.2
    to calculate a reasonable value.

    Firefox also does something like this per
    https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ
    http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397
    Unlike mozilla we limit this to 24-hr.
    ��������i,i-i�i�i�i�i�c
Cs�|j}d|kriSd|kr*|ddkr*iS|j|jkr:iSd|ksJd|krNiSt�t|d��}t|d�}|dks||dkr�iSt��}td||�}|t�|�}tdt	|dd��}||kr�iS||}	dt�
tt�|	��iS)	Nrr"r!r	z
last-modifiedr�
i�Q)
rZstatus�cacheable_by_default_statusesr
rrr�time�max�min�strftime�TIME_FMT�gmtime)
r�resprr	Z
last_modifiedZnowZcurrent_agerZfreshness_lifetimerr
r
rrhs*zLastModified.update_headerscCsdSrr
)rr4r
r
rr�szLastModified.warningN)rrrr#r-rrr
r
r
rr'Xs�r')N)r
r.Zemail.utilsrrrrrr2rr�objectrrr$r'r
r
r
r�<module>s
"site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-38.opt-1.pyc000064400000003004151446177000022657 0ustar00U

��.e�@sxddlZddlmZddlmZddlmZddlmZddl	m
Z
dd�Zd	d
�Zdd�Z
dd
d�Zedkrte�dS)�N)�requests)�CacheControlAdapter)�	DictCache)�logger)�ArgumentParsercCs"t�tj�t��}t�|�dS)N)rZsetLevel�logging�DEBUGZ
StreamHandlerZ
addHandler)Zhandler�r	�A/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/_cmd.py�
setup_loggingsrcCs>tt�dddd�}t��}|�d|�|�d|�|j|_|S)NT)Zcache_etagsZ
serializerZ	heuristiczhttp://zhttps://)rrrZSessionZmountZ
controller�cache_controller)Zadapter�sessr	r	r
�get_sessions�rcCst�}|jddd�|��S)N�urlzThe URL to try and cache)�help)r�add_argument�
parse_args)�parserr	r	r
�get_argssrcCsTt�}t�}|�|j�}t�|j�|j|j�|j�	|j�rHt
d�nt
d�dS)NzCached!z
Not cached :()rr�getrrrZcache_responseZrequest�rawZcached_request�print)�argsr
Zrespr	r	r
�main$s
r�__main__)N)rZpip._vendorrZ pip._vendor.cachecontrol.adapterrZpip._vendor.cachecontrol.cacherZ#pip._vendor.cachecontrol.controllerr�argparserrrrr�__name__r	r	r	r
�<module>s
site-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-38.opt-1.pyc000064400000003322151446177000023023 0ustar00U

��.e%�@s4dZddlmZGdd�de�ZGdd�de�ZdS)zb
The cache object API for implementing caches. The default is a thread
safe in-memory dictionary.
�)�Lockc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�	BaseCachecCs
t��dS�N��NotImplementedError��self�key�r
�B/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/cache.py�get
sz
BaseCache.getcCs
t��dSrr�rr	�valuer
r
r�set
sz
BaseCache.setcCs
t��dSrrrr
r
r�deleteszBaseCache.deletecCsdSrr
)rr
r
r�closeszBaseCache.closeN)�__name__�
__module__�__qualname__rrrrr
r
r
rrsrc@s.eZdZd
dd�Zdd�Zdd�Zdd	�ZdS)�	DictCacheNcCst�|_|pi|_dSr)r�lock�data)rZ	init_dictr
r
r�__init__szDictCache.__init__cCs|j�|d�Sr)rrrr
r
rrsz
DictCache.getc	Cs&|j�|j�||i�W5QRXdSr)rr�updater
r
r
rr sz
DictCache.setc	Cs,|j�||jkr|j�|�W5QRXdSr)rr�poprr
r
rr$s
zDictCache.delete)N)rrrrrrrr
r
r
rrs
rN)�__doc__Z	threadingr�objectrrr
r
r
r�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/controller.cpython-38.pyc000064400000016754151446177000023221 0ustar00U

��.e�5�@s�dZddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZe�
e�Ze�d�Zd	d
�ZGdd�de�ZdS)
z7
The httplib2 algorithms ported for use with requests.
�N)�parsedate_tz)�CaseInsensitiveDict�)�	DictCache)�
Serializerz9^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?cCs0t�|���}|d|d|d|d|dfS)z�Parses a URI using the regex given in Appendix B of RFC 3986.

        (scheme, authority, path, query, fragment) = parse_uri(uri)
    r����)�URI�match�groups)�urir
�r�G/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/controller.py�	parse_urisrc@s\eZdZdZddd�Zedd��Zedd	��Zd
d�Zdd
�Z	dd�Z
ddd�Zdd�ZdS)�CacheControllerz9An interface to see if request should cached or not.
    NTcCs,|pt�|_||_|pt�|_|p$d|_dS)N)����i,�-)r�cache�cache_etagsr�
serializer�cacheable_status_codes)�selfrrr�status_codesrrr�__init__"szCacheController.__init__c	Csht|�\}}}}}|r|s&td|��|��}|��}|s>d}|rPd�||g�pR|}|d||}|S)z4Normalize the URL to create a safe key for the cachez(Only absolute URIs are allowed. uri = %s�/�?z://)r�	Exception�lower�join)	�clsrZschemeZ	authority�pathZqueryZfragmentZrequest_uriZ
defrag_urirrr�_urlnorm*szCacheController._urlnormcCs
|�|�S�N)r$)r"rrrr�	cache_url>szCacheController.cache_urlc

Cs(tdftdftdfddddddddtdfd�}|�d|�dd��}i}|�d�D]�}|��s^qP|�d	d
�}|d��}z||\}}	Wn$tk
r�t�d|�YqPYnX|r�|	s�d||<|rPz||d
���||<WqPtk
r�|	r�t�d
|�YqPtk
�r t�d||j	�YqPXqP|S)NTF)NF)�max-agez	max-stale�	min-fresh�no-cache�no-storezno-transformzonly-if-cachedzmust-revalidateZpublicZprivatezproxy-revalidatezs-maxagez
cache-controlz
Cache-Control��,�=rrz,Ignoring unknown cache-control directive: %sz-Missing value for cache-control directive: %sz8Invalid value for cache-control directive %s, must be %s)
�int�get�split�strip�KeyError�logger�debug�
IndexError�
ValueError�__name__)
r�headersZknown_directivesZ
cc_headersZretvalZcc_directive�partsZ	directive�typZrequiredrrr�parse_cache_controlBsV�
��z#CacheController.parse_cache_controlcCs0|�|j�}t�d|�|�|j�}d|kr:t�d�dSd|kr\|ddkr\t�d�dS|j�|�}|dkr~t�d	�dS|j�	||�}|s�t�
d
�dS|jdkr�d}t�|�|St|j�}|r�d
|kr�d|kr�t�d�|j�
|�t�d�dSt��}t�t|d
��}	td||	�}
t�d|
�|�|�}d}d|k�r^|d}t�d|�nDd|k�r�t|d�}
|
dk	�r�t�|
�|	}td|�}t�d|�d|k�r�|d}t�d|�d|k�r�|d}|
|7}
t�d|
�||
k�rt�d�t�d||
�|Sd|k�r,t�d�|j�
|�dS)ze
        Return a cached response if it exists in the cache, otherwise
        return False.
        zLooking up "%s" in the cacher)z-Request header has "no-cache", cache bypassedFr'rz1Request header has "max_age" as 0, cache bypassedNzNo cache entry availablez1Cache entry deserialization failed, entry ignoredrzVReturning cached "301 Moved Permanently" response (ignoring date and etag information)�date�etagz(Purging cached response: no date or etagz!Ignoring cached response: no datezCurrent age based on date: %iz#Freshness lifetime from max-age: %i�expiresz#Freshness lifetime from expires: %iz+Freshness lifetime from request max-age: %ir(z'Adjusted current age from min-fresh: %iz2The response is "fresh", returning cached responsez%i > %iz4The cached response is "stale" with no etag, purging)r&�urlr3r4r;r8rr/r�loadsZwarning�statusr�delete�time�calendarZtimegmr�max)r�requestr&�ccZ
cache_data�resp�msgr8Znowr<Zcurrent_ageZresp_ccZfreshness_lifetimer>Zexpire_timeZ	min_freshrrr�cached_requestxs|





�









�




zCacheController.cached_requestcCs`|�|j�}|j�||j�|��}i}|r\t|j�}d|krH|d|d<d|kr\|d|d<|S)Nr=ZETagz
If-None-Matchz
last-modifiedz
Last-ModifiedzIf-Modified-Since)r&r?rr@rr/rr8)rrFr&rHZnew_headersr8rrr�conditional_headers�s
z#CacheController.conditional_headerscCs�|p|j}|j|kr(t�d|j|�dSt|j�}|dk	rfd|krf|d��rft|d�t|�krfdS|�	|j�}|�	|�}|�
|j�}	t�d|	�d}
d|kr�d}
t�d�d|kr�d}
t�d	�|
r�|j�
|	�r�t�d
�|j�|	�|
r�dS|j�r,d|k�r,t�d�|j�|	|jj|||d
��n�|jdk�r\t�d�|j�|	|j�||��n�d|k�r�d|k�r�|ddk�r�t�d�|j�|	|jj|||d
��n:d|k�r�|d�r�t�d�|j�|	|jj|||d
��dS)zc
        Algorithm for caching requests.

        This assumes a requests Response object.
        zStatus code %s not in %sN�content-lengthz&Updating cache with response from "%s"Fr*TzResponse header has "no-store"zRequest header has "no-store"z0Purging existing cache entry to honor "no-store"r=zCaching due to etag)�bodyrzCaching permanant redirectr<r'rz'Caching b/c date exists and max-age > 0r>zCaching b/c of expires header)rrAr3r4rr8�isdigitr.�lenr;r&r?rr/rBr�setr�dumps)rrF�responserMrrZresponse_headersZcc_reqrGr&Zno_storerrr�cache_response�sr

�
��
��




�


�


�zCacheController.cache_responsecsv|�|j�}|j�||j�|��}|s*|Sdg�|j�t�fdd�|j�	�D���d|_
|j�||j�||��|S)z�On a 304 we will get a new set of headers that we want to
        update our cached value with, assuming we have one.

        This should only ever be called when we've sent an ETag and
        gotten a 304 as the response.
        rLc3s&|]\}}|���kr||fVqdSr%)r )�.0�k�v�Zexcluded_headersrr�	<genexpr>bs�z9CacheController.update_cached_response.<locals>.<genexpr>r)
r&r?rr@rr/r8�update�dict�itemsrArPrQ)rrFrRr&Zcached_responserrWr�update_cached_responseIs	��	z&CacheController.update_cached_response)NTNN)NN)
r7�
__module__�__qualname__�__doc__r�classmethodr$r&r;rJrKrSr\rrrrrs�


6o
Rr)r_Zlogging�rerDrCZemail.utilsrZpip._vendor.requests.structuresrrrZ	serializerZ	getLoggerr7r3�compilerr�objectrrrrr�<module>s

	site-packages/pip/_vendor/cachecontrol/__pycache__/controller.cpython-38.opt-1.pyc000064400000016754151446177000024160 0ustar00U

��.e�5�@s�dZddlZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZe�
e�Ze�d�Zd	d
�ZGdd�de�ZdS)
z7
The httplib2 algorithms ported for use with requests.
�N)�parsedate_tz)�CaseInsensitiveDict�)�	DictCache)�
Serializerz9^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?cCs0t�|���}|d|d|d|d|dfS)z�Parses a URI using the regex given in Appendix B of RFC 3986.

        (scheme, authority, path, query, fragment) = parse_uri(uri)
    r����)�URI�match�groups)�urir
�r�G/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/controller.py�	parse_urisrc@s\eZdZdZddd�Zedd��Zedd	��Zd
d�Zdd
�Z	dd�Z
ddd�Zdd�ZdS)�CacheControllerz9An interface to see if request should cached or not.
    NTcCs,|pt�|_||_|pt�|_|p$d|_dS)N)����i,�-)r�cache�cache_etagsr�
serializer�cacheable_status_codes)�selfrrr�status_codesrrr�__init__"szCacheController.__init__c	Csht|�\}}}}}|r|s&td|��|��}|��}|s>d}|rPd�||g�pR|}|d||}|S)z4Normalize the URL to create a safe key for the cachez(Only absolute URIs are allowed. uri = %s�/�?z://)r�	Exception�lower�join)	�clsrZschemeZ	authority�pathZqueryZfragmentZrequest_uriZ
defrag_urirrr�_urlnorm*szCacheController._urlnormcCs
|�|�S�N)r$)r"rrrr�	cache_url>szCacheController.cache_urlc

Cs(tdftdftdfddddddddtdfd�}|�d|�dd��}i}|�d�D]�}|��s^qP|�d	d
�}|d��}z||\}}	Wn$tk
r�t�d|�YqPYnX|r�|	s�d||<|rPz||d
���||<WqPtk
r�|	r�t�d
|�YqPtk
�r t�d||j	�YqPXqP|S)NTF)NF)�max-agez	max-stale�	min-fresh�no-cache�no-storezno-transformzonly-if-cachedzmust-revalidateZpublicZprivatezproxy-revalidatezs-maxagez
cache-controlz
Cache-Control��,�=rrz,Ignoring unknown cache-control directive: %sz-Missing value for cache-control directive: %sz8Invalid value for cache-control directive %s, must be %s)
�int�get�split�strip�KeyError�logger�debug�
IndexError�
ValueError�__name__)
r�headersZknown_directivesZ
cc_headersZretvalZcc_directive�partsZ	directive�typZrequiredrrr�parse_cache_controlBsV�
��z#CacheController.parse_cache_controlcCs0|�|j�}t�d|�|�|j�}d|kr:t�d�dSd|kr\|ddkr\t�d�dS|j�|�}|dkr~t�d	�dS|j�	||�}|s�t�
d
�dS|jdkr�d}t�|�|St|j�}|r�d
|kr�d|kr�t�d�|j�
|�t�d�dSt��}t�t|d
��}	td||	�}
t�d|
�|�|�}d}d|k�r^|d}t�d|�nDd|k�r�t|d�}
|
dk	�r�t�|
�|	}td|�}t�d|�d|k�r�|d}t�d|�d|k�r�|d}|
|7}
t�d|
�||
k�rt�d�t�d||
�|Sd|k�r,t�d�|j�
|�dS)ze
        Return a cached response if it exists in the cache, otherwise
        return False.
        zLooking up "%s" in the cacher)z-Request header has "no-cache", cache bypassedFr'rz1Request header has "max_age" as 0, cache bypassedNzNo cache entry availablez1Cache entry deserialization failed, entry ignoredrzVReturning cached "301 Moved Permanently" response (ignoring date and etag information)�date�etagz(Purging cached response: no date or etagz!Ignoring cached response: no datezCurrent age based on date: %iz#Freshness lifetime from max-age: %i�expiresz#Freshness lifetime from expires: %iz+Freshness lifetime from request max-age: %ir(z'Adjusted current age from min-fresh: %iz2The response is "fresh", returning cached responsez%i > %iz4The cached response is "stale" with no etag, purging)r&�urlr3r4r;r8rr/r�loadsZwarning�statusr�delete�time�calendarZtimegmr�max)r�requestr&�ccZ
cache_data�resp�msgr8Znowr<Zcurrent_ageZresp_ccZfreshness_lifetimer>Zexpire_timeZ	min_freshrrr�cached_requestxs|





�









�




zCacheController.cached_requestcCs`|�|j�}|j�||j�|��}i}|r\t|j�}d|krH|d|d<d|kr\|d|d<|S)Nr=ZETagz
If-None-Matchz
last-modifiedz
Last-ModifiedzIf-Modified-Since)r&r?rr@rr/rr8)rrFr&rHZnew_headersr8rrr�conditional_headers�s
z#CacheController.conditional_headerscCs�|p|j}|j|kr(t�d|j|�dSt|j�}|dk	rfd|krf|d��rft|d�t|�krfdS|�	|j�}|�	|�}|�
|j�}	t�d|	�d}
d|kr�d}
t�d�d|kr�d}
t�d	�|
r�|j�
|	�r�t�d
�|j�|	�|
r�dS|j�r,d|k�r,t�d�|j�|	|jj|||d
��n�|jdk�r\t�d�|j�|	|j�||��n�d|k�r�d|k�r�|ddk�r�t�d�|j�|	|jj|||d
��n:d|k�r�|d�r�t�d�|j�|	|jj|||d
��dS)zc
        Algorithm for caching requests.

        This assumes a requests Response object.
        zStatus code %s not in %sN�content-lengthz&Updating cache with response from "%s"Fr*TzResponse header has "no-store"zRequest header has "no-store"z0Purging existing cache entry to honor "no-store"r=zCaching due to etag)�bodyrzCaching permanant redirectr<r'rz'Caching b/c date exists and max-age > 0r>zCaching b/c of expires header)rrAr3r4rr8�isdigitr.�lenr;r&r?rr/rBr�setr�dumps)rrF�responserMrrZresponse_headersZcc_reqrGr&Zno_storerrr�cache_response�sr

�
��
��




�


�


�zCacheController.cache_responsecsv|�|j�}|j�||j�|��}|s*|Sdg�|j�t�fdd�|j�	�D���d|_
|j�||j�||��|S)z�On a 304 we will get a new set of headers that we want to
        update our cached value with, assuming we have one.

        This should only ever be called when we've sent an ETag and
        gotten a 304 as the response.
        rLc3s&|]\}}|���kr||fVqdSr%)r )�.0�k�v�Zexcluded_headersrr�	<genexpr>bs�z9CacheController.update_cached_response.<locals>.<genexpr>r)
r&r?rr@rr/r8�update�dict�itemsrArPrQ)rrFrRr&Zcached_responserrWr�update_cached_responseIs	��	z&CacheController.update_cached_response)NTNN)NN)
r7�
__module__�__qualname__�__doc__r�classmethodr$r&r;rJrKrSr\rrrrrs�


6o
Rr)r_Zlogging�rerDrCZemail.utilsrZpip._vendor.requests.structuresrrrZ	serializerZ	getLoggerr7r3�compilerr�objectrrrrr�<module>s

	site-packages/pip/_vendor/cachecontrol/__pycache__/heuristics.cpython-38.pyc000064400000011132151446177000023201 0ustar00U

��.e��@s�ddlZddlZddlmZmZmZddlmZmZdZddd�Z	dd�Z
Gd	d
�d
e�ZGdd�de�Z
Gd
d�de�ZGdd�de�ZdS)�N)�
formatdate�	parsedate�parsedate_tz)�datetime�	timedeltaz%a, %d %b %Y %H:%M:%S GMTcCs|p
t��}||S�N)rZutcnow)�delta�date�r
�G/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/heuristics.py�expire_aftersrcCstt�|����Sr)r�calendar�timegmZ	timetuple)Zdtr
r
r�datetime_to_headersrc@s$eZdZdd�Zdd�Zdd�ZdS)�
BaseHeuristiccCsdS)a!
        Return a valid 1xx warning header value describing the cache
        adjustments.

        The response is provided too allow warnings like 113
        http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need
        to explicitly say response is over 24 hours old.
        z110 - "Response is Stale"r
��self�responser
r
r�warnings	zBaseHeuristic.warningcCsiS)z�Update the response headers with any new headers.

        NOTE: This SHOULD always include some Warning header to
              signify that the response was cached by the client, not
              by way of the provided headers.
        r
rr
r
r�update_headers!szBaseHeuristic.update_headerscCs@|�|�}|r<|j�|�|�|�}|dk	r<|j�d|i�|S)N�Warning)r�headers�updater)rrZupdated_headersZwarning_header_valuer
r
r�apply*s

zBaseHeuristic.applyN)�__name__�
__module__�__qualname__rrrr
r
r
rrs	rc@seZdZdZdd�ZdS)�OneDayCachezM
    Cache the response by providing an expires 1 day in the
    future.
    cCsRi}d|jkrNt|jd�}ttdd�t|dd��d�}t|�|d<d|d<|S)	N�expiresr	�)Zdays�)r	�public�
cache-control)rrrrrr)rrrr	rr
r
rr<s
zOneDayCache.update_headersN)rrr�__doc__rr
r
r
rr6src@s(eZdZdZdd�Zdd�Zdd�ZdS)	�ExpiresAfterz;
    Cache **all** requests for a defined time period.
    cKstf|�|_dSr)rr)r�kwr
r
r�__init__LszExpiresAfter.__init__cCst|j�}t|�dd�S)Nr!)rr")rrr)rrrr
r
rrOs
zExpiresAfter.update_headerscCsd}||jS)Nz:110 - Automatically cached for %s. Response might be stale)r)rrZtmplr
r
rrSszExpiresAfter.warningN)rrrr#r&rrr
r
r
rr$Gsr$c@s:eZdZdZdddddddd	d
ddhZd
d�Zdd�ZdS)�LastModifieda�
    If there is no Expires header already, fall back on Last-Modified
    using the heuristic from
    http://tools.ietf.org/html/rfc7234#section-4.2.2
    to calculate a reasonable value.

    Firefox also does something like this per
    https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ
    http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397
    Unlike mozilla we limit this to 24-hr.
    ��������i,i-i�i�i�i�i�c
Cs�|j}d|kriSd|kr*|ddkr*iS|j|jkr:iSd|ksJd|krNiSt�t|d��}t|d�}|dks||dkr�iSt��}td||�}|t�|�}tdt	|dd��}||kr�iS||}	dt�
tt�|	��iS)	Nrr"r!r	z
last-modifiedr�
i�Q)
rZstatus�cacheable_by_default_statusesr
rrr�time�max�min�strftime�TIME_FMT�gmtime)
r�resprr	Z
last_modifiedZnowZcurrent_agerZfreshness_lifetimerr
r
rrhs*zLastModified.update_headerscCsdSrr
)rr4r
r
rr�szLastModified.warningN)rrrr#r-rrr
r
r
rr'Xs�r')N)r
r.Zemail.utilsrrrrrr2rr�objectrrr$r'r
r
r
r�<module>s
"site-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-38.opt-1.pyc000064400000001165151446177000023443 0ustar00U

��.e��@s&ddlmZddlmZddd�ZdS)�)�CacheControlAdapter)�	DictCacheNTc	CsB|pt�}|pt}|||||||d�}|�d|�|�d|�|S)N)�cache_etags�
serializer�	heuristic�controller_class�cacheable_methodszhttp://zhttps://)rrZmount)	Zsess�cacherrrrZ
adapter_classr�adapter�r�D/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/wrapper.py�CacheControls
�r
)NTNNNNN)r
rr	rr
rrrr�<module>s�site-packages/pip/_vendor/cachecontrol/__pycache__/compat.cpython-38.opt-1.pyc000064400000001320151446177000023237 0ustar00U

��.e��@s�zddlmZWn ek
r0ddlmZYnXzddlZWnek
rZddlZYnXzddlmZWn ek
r�ddlmZYnXzddl	m
Z
Wn ek
r�ddlm
Z
YnXzeZ
Wnek
r�eZ
YnXdS)�)�urljoinN)�HTTPResponse)�is_fp_closed)Zurllib.parser�ImportErrorZurlparseZcPickle�pickleZ.pip._vendor.requests.packages.urllib3.responserZpip._vendor.urllib3.responseZ*pip._vendor.requests.packages.urllib3.utilrZpip._vendor.urllib3.utilZunicodeZ	text_type�	NameError�str�r	r	�C/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/compat.py�<module>s&site-packages/pip/_vendor/cachecontrol/__pycache__/adapter.cpython-38.opt-1.pyc000064400000005737151446177000023414 0ustar00U

��.e��@s\ddlZddlZddlZddlmZddlmZddlmZddl	m
Z
Gdd�de�ZdS)	�N)�HTTPAdapter�)�CacheController)�	DictCache)�CallbackFileWrappercsNeZdZddhZd�fdd�	Zd�fdd�	Zd�fd
d�	Z�fdd
�Z�ZS)�CacheControlAdapterZPUTZDELETENTc
sLtt|�j||�|pt�|_||_|p*d|_|p4t}	|	|j||d�|_dS)N)ZGET)�cache_etags�
serializer)	�superr�__init__r�cache�	heuristic�cacheable_methodsr�
controller)
�selfrrZcontroller_classr	r
r�args�kwZcontroller_factory��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/adapter.pyrs
�zCacheControlAdapter.__init__cs�|p|j}|j|krhz|j�|�}Wntjk
r>d}YnX|rT|j||dd�S|j�|j�	|��t
t|�j|f|�}|S)z�
        Send a request. Use the request information to see if it
        exists in the cache and cache the response if we need to and can.
        NT)�
from_cache)
r�methodrZcached_request�zlib�error�build_responseZheaders�updateZconditional_headersr
r�send)r�requestrr�	cacheable�cached_response�resprrrr$s


zCacheControlAdapter.sendFc
s|p|j}|s�|j|kr�|jr*|j�|�}|jdkrh|j�||�}||k	rNd}|jdd�|��|}n\|jdkr�|j�	||�nBt
|jt�
|jj	||��|_|jr�|j��fdd�}t�||�|_tt|��||�}|j|jk�r|j�r|j�|j�}	|j�|	�||_|S)z�
        Build a response by making a request or using the cache.

        This will end up calling send and returning a potentially
        cached response
        i0TF)Zdecode_contenti-cs��|jdkr|j��dS)Nr)Z
chunk_left�_fpZ_close�r�Zsuper_update_chunk_lengthrr�_update_chunk_lengthns
z@CacheControlAdapter.build_response.<locals>._update_chunk_length)rrr
ZapplyZstatusrZupdate_cached_response�readZrelease_connZcache_responserr"�	functools�partialZchunkedr%�types�
MethodTyper
rr�invalidating_methods�ok�	cache_urlZurlr�deleter)
rrZresponserrrr r%r!r-rr$rr9sJ	

�
���z"CacheControlAdapter.build_responsecs|j��tt|���dS)N)r�closer
rr#rrrr/�s
zCacheControlAdapter.close)NTNNNN)N)FN)	�__name__�
__module__�__qualname__r+rrrr/�
__classcell__rrrrrs��Jr)r)r'rZpip._vendor.requests.adaptersrrrrrZfilewrapperrrrrrr�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/serialize.cpython-38.pyc000064400000010163151446177000023011 0ustar00U

��.e*�@spddlZddlZddlZddlZddlmZddlmZddlm	Z	m
Z
mZdd�Zdd	�Z
Gd
d�de�ZdS)�N)�msgpack)�CaseInsensitiveDict�)�HTTPResponse�pickle�	text_typecCst�|�d��S)N�ascii)�base64Z	b64decode�encode)�b�r�F/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/serialize.py�_b64_decode_bytessrcCst|��d�S)N�utf8)r�decode)�srrr
�_b64_decode_strsrc@sNeZdZddd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dS)�
SerializerNc		Cs�t|j�}|dkr*|jdd�}t�|�|_d|tdd�|j��D��|j|j	t
|j�|j|j
d�i}i|d<d|kr�|d�d�}|D]:}t
|���}|j�|d�}|dk	r�t
|�}||d|<q�d	�d
tj|dd�g�S)
NF)�decode_content�responsecss"|]\}}t|�t|�fVqdS�N)r��.0�k�vrrr
�	<genexpr>2sz#Serializer.dumps.<locals>.<genexpr>)�body�headers�status�version�reason�strictr�vary�,�,scc=4T)Zuse_bin_type)rr�read�io�BytesIOZ_fp�dict�itemsrrrr r!r�split�strip�get�joinr�dumps)	�self�requestrrZresponse_headers�dataZvaried_headers�headerZheader_valuerrr
r.s4

���zSerializer.dumpscCs�|sdSz|�dd�\}}Wntk
r4d}YnX|dd�dkrR||}d}|�dd�d�d�}zt|d	�|��||�WStk
r�YdSXdS)
Nr$rscc=0�scc=�=���rz
_loads_v{})r*�
ValueErrorr�getattr�format�AttributeError)r/r0r1Zverrrr
�loadsJs
zSerializer.loadscCs�d|�di�krdS|�di���D] \}}|j�|d�|kr$dSq$|d�d�}t|ddd�}|�dd	�d
kr�|�d�||dd<zt�|�}Wn$tk
r�t�|�d��}YnXt	f|dd
�|d��S)z`Verify our vary headers match and construct a real urllib3
        HTTPResponse object.
        �*r"Nrrr)r1ztransfer-encoding�ZchunkedrF)rZpreload_content)
r,r)r�poprr&r'�	TypeErrorr
r)r/r0�cachedr2�valueZbody_rawrrrrr
�prepare_responsehs
zSerializer.prepare_responsecCsdSrr�r/r0r1rrr
�	_loads_v0�szSerializer._loads_v0cCs2zt�|�}Wntk
r$YdSX|�||�Sr)rr:r6rA�r/r0r1r?rrr
�	_loads_v1�s
zSerializer._loads_v1c	Cs�zt�t�|��d��}Wnttjfk
r6YdSXt|dd�|dd<tdd�|dd�	�D��|dd<t
|dd�|dd<tdd�|d	�	�D��|d	<|�||�S)
Nrrrcss"|]\}}t|�t|�fVqdSr�rrrrr
r�s�z'Serializer._loads_v2.<locals>.<genexpr>rr css.|]&\}}t|�|dk	r t|�n|fVqdSrrFrrrr
r�s�r")�jsonr:�zlib�
decompressrr6�errorrr(r)rrArDrrr
�	_loads_v2�s�
�zSerializer._loads_v2cCsdSrrrBrrr
�	_loads_v3�szSerializer._loads_v3cCs6ztj|dd�}Wntk
r(YdSX|�||�S)Nzutf-8)�encoding)rr:r6rArDrrr
�	_loads_v4�s
zSerializer._loads_v4)N)�__name__�
__module__�__qualname__r.r:rArCrErKrLrNrrrr
rs
4$r)r	r&rGrHZpip._vendorrZpip._vendor.requests.structuresr�compatrrrrr�objectrrrrr
�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/cache.cpython-38.pyc000064400000003322151446177000022064 0ustar00U

��.e%�@s4dZddlmZGdd�de�ZGdd�de�ZdS)zb
The cache object API for implementing caches. The default is a thread
safe in-memory dictionary.
�)�Lockc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�	BaseCachecCs
t��dS�N��NotImplementedError��self�key�r
�B/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/cache.py�get
sz
BaseCache.getcCs
t��dSrr�rr	�valuer
r
r�set
sz
BaseCache.setcCs
t��dSrrrr
r
r�deleteszBaseCache.deletecCsdSrr
)rr
r
r�closeszBaseCache.closeN)�__name__�
__module__�__qualname__rrrrr
r
r
rrsrc@s.eZdZd
dd�Zdd�Zdd�Zdd	�ZdS)�	DictCacheNcCst�|_|pi|_dSr)r�lock�data)rZ	init_dictr
r
r�__init__szDictCache.__init__cCs|j�|d�Sr)rrrr
r
rrsz
DictCache.getc	Cs&|j�|j�||i�W5QRXdSr)rr�updater
r
r
rr sz
DictCache.setc	Cs,|j�||jkr|j�|�W5QRXdSr)rr�poprr
r
rr$s
zDictCache.delete)N)rrrrrrrr
r
r
rrs
rN)�__doc__Z	threadingr�objectrrr
r
r
r�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/wrapper.cpython-38.pyc000064400000001165151446177000022504 0ustar00U

��.e��@s&ddlmZddlmZddd�ZdS)�)�CacheControlAdapter)�	DictCacheNTc	CsB|pt�}|pt}|||||||d�}|�d|�|�d|�|S)N)�cache_etags�
serializer�	heuristic�controller_class�cacheable_methodszhttp://zhttps://)rrZmount)	Zsess�cacherrrrZ
adapter_classr�adapter�r�D/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/wrapper.py�CacheControls
�r
)NTNNNNN)r
rr	rr
rrrr�<module>s�site-packages/pip/_vendor/cachecontrol/__pycache__/_cmd.cpython-38.pyc000064400000003004151446177000021720 0ustar00U

��.e�@sxddlZddlmZddlmZddlmZddlmZddl	m
Z
dd�Zd	d
�Zdd�Z
dd
d�Zedkrte�dS)�N)�requests)�CacheControlAdapter)�	DictCache)�logger)�ArgumentParsercCs"t�tj�t��}t�|�dS)N)rZsetLevel�logging�DEBUGZ
StreamHandlerZ
addHandler)Zhandler�r	�A/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/_cmd.py�
setup_loggingsrcCs>tt�dddd�}t��}|�d|�|�d|�|j|_|S)NT)Zcache_etagsZ
serializerZ	heuristiczhttp://zhttps://)rrrZSessionZmountZ
controller�cache_controller)Zadapter�sessr	r	r
�get_sessions�rcCst�}|jddd�|��S)N�urlzThe URL to try and cache)�help)r�add_argument�
parse_args)�parserr	r	r
�get_argssrcCsTt�}t�}|�|j�}t�|j�|j|j�|j�	|j�rHt
d�nt
d�dS)NzCached!z
Not cached :()rr�getrrrZcache_responseZrequest�rawZcached_request�print)�argsr
Zrespr	r	r
�main$s
r�__main__)N)rZpip._vendorrZ pip._vendor.cachecontrol.adapterrZpip._vendor.cachecontrol.cacherZ#pip._vendor.cachecontrol.controllerr�argparserrrrr�__name__r	r	r	r
�<module>s
site-packages/pip/_vendor/cachecontrol/__pycache__/__init__.cpython-38.pyc000064400000001001151446177000022550 0ustar00U

��.e.�@s8dZdZdZdZddlmZddlmZddlm	Z	dS)	zbCacheControl import Interface.

Make it easy to import from cachecontrol without long namespaces.
zEric Larsonzeric@ionrock.orgz0.12.5�)�CacheControl)�CacheControlAdapter)�CacheControllerN)
�__doc__�
__author__Z	__email__�__version__�wrapperrZadapterrZ
controllerr�r	r	�E/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/__init__.py�<module>ssite-packages/pip/_vendor/cachecontrol/__pycache__/filewrapper.cpython-38.pyc000064400000004133151446177000023342 0ustar00U

��.e�	�@s ddlmZGdd�de�ZdS)�)�BytesIOc@sBeZdZdZdd�Zdd�Zdd�Zdd	�Zddd�Zd
d�Z	d
S)�CallbackFileWrapperav
    Small wrapper around a fp object which will tee everything read into a
    buffer, and when that file is closed it will execute a callback with the
    contents of that buffer.

    All attributes are proxied to the underlying file object.

    This class uses members with a double underscore (__) leading prefix so as
    not to accidentally shadow an attribute.
    cCst�|_||_||_dS�N)r�_CallbackFileWrapper__buf�_CallbackFileWrapper__fp�_CallbackFileWrapper__callback)�self�fp�callback�r�H/usr/lib/python3.8/site-packages/pip/_vendor/cachecontrol/filewrapper.py�__init__szCallbackFileWrapper.__init__cCs|�d�}t||�S)Nr)�__getattribute__�getattr)r�namer	rrr�__getattr__s	
zCallbackFileWrapper.__getattr__cCsHz|jjdkWStk
r"YnXz
|jjWStk
rBYnXdS)NF)rr	�AttributeError�closed�rrrrZ__is_fp_closed!s
z"CallbackFileWrapper.__is_fp_closedcCs |jr|�|j���d|_dSr)rr�getvaluerrrr�_close2szCallbackFileWrapper._closeNcCs,|j�|�}|j�|�|��r(|��|Sr)r�readr�write�"_CallbackFileWrapper__is_fp_closedr�rZamt�datarrrr=s
zCallbackFileWrapper.readcCs@|j�|�}|dkr |dkr |S|j�|�|��r<|��|S)N�s
)r�
_safe_readrrrrrrrrrEszCallbackFileWrapper._safe_read)N)
�__name__�
__module__�__qualname__�__doc__r
rrrrrrrrrrs
rN)�ior�objectrrrrr�<module>ssite-packages/pip/_vendor/cachecontrol/controller.py000064400000032602151446177000016721 0ustar00"""
The httplib2 algorithms ported for use with requests.
"""
import logging
import re
import calendar
import time
from email.utils import parsedate_tz

from pip._vendor.requests.structures import CaseInsensitiveDict

from .cache import DictCache
from .serialize import Serializer


logger = logging.getLogger(__name__)

URI = re.compile(r"^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?")


def parse_uri(uri):
    """Parses a URI using the regex given in Appendix B of RFC 3986.

        (scheme, authority, path, query, fragment) = parse_uri(uri)
    """
    groups = URI.match(uri).groups()
    return (groups[1], groups[3], groups[4], groups[6], groups[8])


class CacheController(object):
    """An interface to see if request should cached or not.
    """

    def __init__(
        self, cache=None, cache_etags=True, serializer=None, status_codes=None
    ):
        self.cache = cache or DictCache()
        self.cache_etags = cache_etags
        self.serializer = serializer or Serializer()
        self.cacheable_status_codes = status_codes or (200, 203, 300, 301)

    @classmethod
    def _urlnorm(cls, uri):
        """Normalize the URL to create a safe key for the cache"""
        (scheme, authority, path, query, fragment) = parse_uri(uri)
        if not scheme or not authority:
            raise Exception("Only absolute URIs are allowed. uri = %s" % uri)

        scheme = scheme.lower()
        authority = authority.lower()

        if not path:
            path = "/"

        # Could do syntax based normalization of the URI before
        # computing the digest. See Section 6.2.2 of Std 66.
        request_uri = query and "?".join([path, query]) or path
        defrag_uri = scheme + "://" + authority + request_uri

        return defrag_uri

    @classmethod
    def cache_url(cls, uri):
        return cls._urlnorm(uri)

    def parse_cache_control(self, headers):
        known_directives = {
            # https://tools.ietf.org/html/rfc7234#section-5.2
            "max-age": (int, True),
            "max-stale": (int, False),
            "min-fresh": (int, True),
            "no-cache": (None, False),
            "no-store": (None, False),
            "no-transform": (None, False),
            "only-if-cached": (None, False),
            "must-revalidate": (None, False),
            "public": (None, False),
            "private": (None, False),
            "proxy-revalidate": (None, False),
            "s-maxage": (int, True),
        }

        cc_headers = headers.get("cache-control", headers.get("Cache-Control", ""))

        retval = {}

        for cc_directive in cc_headers.split(","):
            if not cc_directive.strip():
                continue

            parts = cc_directive.split("=", 1)
            directive = parts[0].strip()

            try:
                typ, required = known_directives[directive]
            except KeyError:
                logger.debug("Ignoring unknown cache-control directive: %s", directive)
                continue

            if not typ or not required:
                retval[directive] = None
            if typ:
                try:
                    retval[directive] = typ(parts[1].strip())
                except IndexError:
                    if required:
                        logger.debug(
                            "Missing value for cache-control " "directive: %s",
                            directive,
                        )
                except ValueError:
                    logger.debug(
                        "Invalid value for cache-control directive " "%s, must be %s",
                        directive,
                        typ.__name__,
                    )

        return retval

    def cached_request(self, request):
        """
        Return a cached response if it exists in the cache, otherwise
        return False.
        """
        cache_url = self.cache_url(request.url)
        logger.debug('Looking up "%s" in the cache', cache_url)
        cc = self.parse_cache_control(request.headers)

        # Bail out if the request insists on fresh data
        if "no-cache" in cc:
            logger.debug('Request header has "no-cache", cache bypassed')
            return False

        if "max-age" in cc and cc["max-age"] == 0:
            logger.debug('Request header has "max_age" as 0, cache bypassed')
            return False

        # Request allows serving from the cache, let's see if we find something
        cache_data = self.cache.get(cache_url)
        if cache_data is None:
            logger.debug("No cache entry available")
            return False

        # Check whether it can be deserialized
        resp = self.serializer.loads(request, cache_data)
        if not resp:
            logger.warning("Cache entry deserialization failed, entry ignored")
            return False

        # If we have a cached 301, return it immediately. We don't
        # need to test our response for other headers b/c it is
        # intrinsically "cacheable" as it is Permanent.
        # See:
        #   https://tools.ietf.org/html/rfc7231#section-6.4.2
        #
        # Client can try to refresh the value by repeating the request
        # with cache busting headers as usual (ie no-cache).
        if resp.status == 301:
            msg = (
                'Returning cached "301 Moved Permanently" response '
                "(ignoring date and etag information)"
            )
            logger.debug(msg)
            return resp

        headers = CaseInsensitiveDict(resp.headers)
        if not headers or "date" not in headers:
            if "etag" not in headers:
                # Without date or etag, the cached response can never be used
                # and should be deleted.
                logger.debug("Purging cached response: no date or etag")
                self.cache.delete(cache_url)
            logger.debug("Ignoring cached response: no date")
            return False

        now = time.time()
        date = calendar.timegm(parsedate_tz(headers["date"]))
        current_age = max(0, now - date)
        logger.debug("Current age based on date: %i", current_age)

        # TODO: There is an assumption that the result will be a
        #       urllib3 response object. This may not be best since we
        #       could probably avoid instantiating or constructing the
        #       response until we know we need it.
        resp_cc = self.parse_cache_control(headers)

        # determine freshness
        freshness_lifetime = 0

        # Check the max-age pragma in the cache control header
        if "max-age" in resp_cc:
            freshness_lifetime = resp_cc["max-age"]
            logger.debug("Freshness lifetime from max-age: %i", freshness_lifetime)

        # If there isn't a max-age, check for an expires header
        elif "expires" in headers:
            expires = parsedate_tz(headers["expires"])
            if expires is not None:
                expire_time = calendar.timegm(expires) - date
                freshness_lifetime = max(0, expire_time)
                logger.debug("Freshness lifetime from expires: %i", freshness_lifetime)

        # Determine if we are setting freshness limit in the
        # request. Note, this overrides what was in the response.
        if "max-age" in cc:
            freshness_lifetime = cc["max-age"]
            logger.debug(
                "Freshness lifetime from request max-age: %i", freshness_lifetime
            )

        if "min-fresh" in cc:
            min_fresh = cc["min-fresh"]
            # adjust our current age by our min fresh
            current_age += min_fresh
            logger.debug("Adjusted current age from min-fresh: %i", current_age)

        # Return entry if it is fresh enough
        if freshness_lifetime > current_age:
            logger.debug('The response is "fresh", returning cached response')
            logger.debug("%i > %i", freshness_lifetime, current_age)
            return resp

        # we're not fresh. If we don't have an Etag, clear it out
        if "etag" not in headers:
            logger.debug('The cached response is "stale" with no etag, purging')
            self.cache.delete(cache_url)

        # return the original handler
        return False

    def conditional_headers(self, request):
        cache_url = self.cache_url(request.url)
        resp = self.serializer.loads(request, self.cache.get(cache_url))
        new_headers = {}

        if resp:
            headers = CaseInsensitiveDict(resp.headers)

            if "etag" in headers:
                new_headers["If-None-Match"] = headers["ETag"]

            if "last-modified" in headers:
                new_headers["If-Modified-Since"] = headers["Last-Modified"]

        return new_headers

    def cache_response(self, request, response, body=None, status_codes=None):
        """
        Algorithm for caching requests.

        This assumes a requests Response object.
        """
        # From httplib2: Don't cache 206's since we aren't going to
        #                handle byte range requests
        cacheable_status_codes = status_codes or self.cacheable_status_codes
        if response.status not in cacheable_status_codes:
            logger.debug(
                "Status code %s not in %s", response.status, cacheable_status_codes
            )
            return

        response_headers = CaseInsensitiveDict(response.headers)

        # If we've been given a body, our response has a Content-Length, that
        # Content-Length is valid then we can check to see if the body we've
        # been given matches the expected size, and if it doesn't we'll just
        # skip trying to cache it.
        if (
            body is not None
            and "content-length" in response_headers
            and response_headers["content-length"].isdigit()
            and int(response_headers["content-length"]) != len(body)
        ):
            return

        cc_req = self.parse_cache_control(request.headers)
        cc = self.parse_cache_control(response_headers)

        cache_url = self.cache_url(request.url)
        logger.debug('Updating cache with response from "%s"', cache_url)

        # Delete it from the cache if we happen to have it stored there
        no_store = False
        if "no-store" in cc:
            no_store = True
            logger.debug('Response header has "no-store"')
        if "no-store" in cc_req:
            no_store = True
            logger.debug('Request header has "no-store"')
        if no_store and self.cache.get(cache_url):
            logger.debug('Purging existing cache entry to honor "no-store"')
            self.cache.delete(cache_url)
        if no_store:
            return

        # If we've been given an etag, then keep the response
        if self.cache_etags and "etag" in response_headers:
            logger.debug("Caching due to etag")
            self.cache.set(
                cache_url, self.serializer.dumps(request, response, body=body)
            )

        # Add to the cache any 301s. We do this before looking that
        # the Date headers.
        elif response.status == 301:
            logger.debug("Caching permanant redirect")
            self.cache.set(cache_url, self.serializer.dumps(request, response))

        # Add to the cache if the response headers demand it. If there
        # is no date header then we can't do anything about expiring
        # the cache.
        elif "date" in response_headers:
            # cache when there is a max-age > 0
            if "max-age" in cc and cc["max-age"] > 0:
                logger.debug("Caching b/c date exists and max-age > 0")
                self.cache.set(
                    cache_url, self.serializer.dumps(request, response, body=body)
                )

            # If the request can expire, it means we should cache it
            # in the meantime.
            elif "expires" in response_headers:
                if response_headers["expires"]:
                    logger.debug("Caching b/c of expires header")
                    self.cache.set(
                        cache_url, self.serializer.dumps(request, response, body=body)
                    )

    def update_cached_response(self, request, response):
        """On a 304 we will get a new set of headers that we want to
        update our cached value with, assuming we have one.

        This should only ever be called when we've sent an ETag and
        gotten a 304 as the response.
        """
        cache_url = self.cache_url(request.url)

        cached_response = self.serializer.loads(request, self.cache.get(cache_url))

        if not cached_response:
            # we didn't have a cached response
            return response

        # Lets update our headers with the headers from the new request:
        # http://tools.ietf.org/html/draft-ietf-httpbis-p4-conditional-26#section-4.1
        #
        # The server isn't supposed to send headers that would make
        # the cached body invalid. But... just in case, we'll be sure
        # to strip out ones we know that might be problmatic due to
        # typical assumptions.
        excluded_headers = ["content-length"]

        cached_response.headers.update(
            dict(
                (k, v)
                for k, v in response.headers.items()
                if k.lower() not in excluded_headers
            )
        )

        # we want a 200 b/c we have content via the cache
        cached_response.status = 200

        # update our cache
        self.cache.set(cache_url, self.serializer.dumps(request, cached_response))

        return cached_response
site-packages/pip/_vendor/cachecontrol/__init__.py000064400000000456151446177000016277 0ustar00"""CacheControl import Interface.

Make it easy to import from cachecontrol without long namespaces.
"""
__author__ = "Eric Larson"
__email__ = "eric@ionrock.org"
__version__ = "0.12.5"

from .wrapper import CacheControl
from .adapter import CacheControlAdapter
from .controller import CacheController
site-packages/pip/_vendor/cachecontrol/cache.py000064400000001445151446177000015602 0ustar00"""
The cache object API for implementing caches. The default is a thread
safe in-memory dictionary.
"""
from threading import Lock


class BaseCache(object):

    def get(self, key):
        raise NotImplementedError()

    def set(self, key, value):
        raise NotImplementedError()

    def delete(self, key):
        raise NotImplementedError()

    def close(self):
        pass


class DictCache(BaseCache):

    def __init__(self, init_dict=None):
        self.lock = Lock()
        self.data = init_dict or {}

    def get(self, key):
        return self.data.get(key, None)

    def set(self, key, value):
        with self.lock:
            self.data.update({key: value})

    def delete(self, key):
        with self.lock:
            if key in self.data:
                self.data.pop(key)
site-packages/pip/_vendor/cachecontrol/wrapper.py000064400000001237151446177000016216 0ustar00from .adapter import CacheControlAdapter
from .cache import DictCache


def CacheControl(
    sess,
    cache=None,
    cache_etags=True,
    serializer=None,
    heuristic=None,
    controller_class=None,
    adapter_class=None,
    cacheable_methods=None,
):

    cache = cache or DictCache()
    adapter_class = adapter_class or CacheControlAdapter
    adapter = adapter_class(
        cache,
        cache_etags=cache_etags,
        serializer=serializer,
        heuristic=heuristic,
        controller_class=controller_class,
        cacheable_methods=cacheable_methods,
    )
    sess.mount("http://", adapter)
    sess.mount("https://", adapter)

    return sess
site-packages/pip/_vendor/cachecontrol/serialize.py000064400000015452151446177000016531 0ustar00import base64
import io
import json
import zlib

from pip._vendor import msgpack
from pip._vendor.requests.structures import CaseInsensitiveDict

from .compat import HTTPResponse, pickle, text_type


def _b64_decode_bytes(b):
    return base64.b64decode(b.encode("ascii"))


def _b64_decode_str(s):
    return _b64_decode_bytes(s).decode("utf8")


class Serializer(object):

    def dumps(self, request, response, body=None):
        response_headers = CaseInsensitiveDict(response.headers)

        if body is None:
            body = response.read(decode_content=False)

            # NOTE: 99% sure this is dead code. I'm only leaving it
            #       here b/c I don't have a test yet to prove
            #       it. Basically, before using
            #       `cachecontrol.filewrapper.CallbackFileWrapper`,
            #       this made an effort to reset the file handle. The
            #       `CallbackFileWrapper` short circuits this code by
            #       setting the body as the content is consumed, the
            #       result being a `body` argument is *always* passed
            #       into cache_response, and in turn,
            #       `Serializer.dump`.
            response._fp = io.BytesIO(body)

        # NOTE: This is all a bit weird, but it's really important that on
        #       Python 2.x these objects are unicode and not str, even when
        #       they contain only ascii. The problem here is that msgpack
        #       understands the difference between unicode and bytes and we
        #       have it set to differentiate between them, however Python 2
        #       doesn't know the difference. Forcing these to unicode will be
        #       enough to have msgpack know the difference.
        data = {
            u"response": {
                u"body": body,
                u"headers": dict(
                    (text_type(k), text_type(v)) for k, v in response.headers.items()
                ),
                u"status": response.status,
                u"version": response.version,
                u"reason": text_type(response.reason),
                u"strict": response.strict,
                u"decode_content": response.decode_content,
            }
        }

        # Construct our vary headers
        data[u"vary"] = {}
        if u"vary" in response_headers:
            varied_headers = response_headers[u"vary"].split(",")
            for header in varied_headers:
                header = text_type(header).strip()
                header_value = request.headers.get(header, None)
                if header_value is not None:
                    header_value = text_type(header_value)
                data[u"vary"][header] = header_value

        return b",".join([b"cc=4", msgpack.dumps(data, use_bin_type=True)])

    def loads(self, request, data):
        # Short circuit if we've been given an empty set of data
        if not data:
            return

        # Determine what version of the serializer the data was serialized
        # with
        try:
            ver, data = data.split(b",", 1)
        except ValueError:
            ver = b"cc=0"

        # Make sure that our "ver" is actually a version and isn't a false
        # positive from a , being in the data stream.
        if ver[:3] != b"cc=":
            data = ver + data
            ver = b"cc=0"

        # Get the version number out of the cc=N
        ver = ver.split(b"=", 1)[-1].decode("ascii")

        # Dispatch to the actual load method for the given version
        try:
            return getattr(self, "_loads_v{}".format(ver))(request, data)

        except AttributeError:
            # This is a version we don't have a loads function for, so we'll
            # just treat it as a miss and return None
            return

    def prepare_response(self, request, cached):
        """Verify our vary headers match and construct a real urllib3
        HTTPResponse object.
        """
        # Special case the '*' Vary value as it means we cannot actually
        # determine if the cached response is suitable for this request.
        if "*" in cached.get("vary", {}):
            return

        # Ensure that the Vary headers for the cached response match our
        # request
        for header, value in cached.get("vary", {}).items():
            if request.headers.get(header, None) != value:
                return

        body_raw = cached["response"].pop("body")

        headers = CaseInsensitiveDict(data=cached["response"]["headers"])
        if headers.get("transfer-encoding", "") == "chunked":
            headers.pop("transfer-encoding")

        cached["response"]["headers"] = headers

        try:
            body = io.BytesIO(body_raw)
        except TypeError:
            # This can happen if cachecontrol serialized to v1 format (pickle)
            # using Python 2. A Python 2 str(byte string) will be unpickled as
            # a Python 3 str (unicode string), which will cause the above to
            # fail with:
            #
            #     TypeError: 'str' does not support the buffer interface
            body = io.BytesIO(body_raw.encode("utf8"))

        return HTTPResponse(body=body, preload_content=False, **cached["response"])

    def _loads_v0(self, request, data):
        # The original legacy cache data. This doesn't contain enough
        # information to construct everything we need, so we'll treat this as
        # a miss.
        return

    def _loads_v1(self, request, data):
        try:
            cached = pickle.loads(data)
        except ValueError:
            return

        return self.prepare_response(request, cached)

    def _loads_v2(self, request, data):
        try:
            cached = json.loads(zlib.decompress(data).decode("utf8"))
        except (ValueError, zlib.error):
            return

        # We need to decode the items that we've base64 encoded
        cached["response"]["body"] = _b64_decode_bytes(cached["response"]["body"])
        cached["response"]["headers"] = dict(
            (_b64_decode_str(k), _b64_decode_str(v))
            for k, v in cached["response"]["headers"].items()
        )
        cached["response"]["reason"] = _b64_decode_str(cached["response"]["reason"])
        cached["vary"] = dict(
            (_b64_decode_str(k), _b64_decode_str(v) if v is not None else v)
            for k, v in cached["vary"].items()
        )

        return self.prepare_response(request, cached)

    def _loads_v3(self, request, data):
        # Due to Python 2 encoding issues, it's impossible to know for sure
        # exactly how to load v3 entries, thus we'll treat these as a miss so
        # that they get rewritten out as v4 entries.
        return

    def _loads_v4(self, request, data):
        try:
            cached = msgpack.loads(data, encoding="utf-8")
        except ValueError:
            return

        return self.prepare_response(request, cached)
site-packages/pip/_vendor/cachecontrol/_cmd.py000064400000002417151446177000015441 0ustar00import logging

from pip._vendor import requests

from pip._vendor.cachecontrol.adapter import CacheControlAdapter
from pip._vendor.cachecontrol.cache import DictCache
from pip._vendor.cachecontrol.controller import logger

from argparse import ArgumentParser


def setup_logging():
    logger.setLevel(logging.DEBUG)
    handler = logging.StreamHandler()
    logger.addHandler(handler)


def get_session():
    adapter = CacheControlAdapter(
        DictCache(), cache_etags=True, serializer=None, heuristic=None
    )
    sess = requests.Session()
    sess.mount("http://", adapter)
    sess.mount("https://", adapter)

    sess.cache_controller = adapter.controller
    return sess


def get_args():
    parser = ArgumentParser()
    parser.add_argument("url", help="The URL to try and cache")
    return parser.parse_args()


def main(args=None):
    args = get_args()
    sess = get_session()

    # Make a request to get a response
    resp = sess.get(args.url)

    # Turn on logging
    setup_logging()

    # try setting the cache
    sess.cache_controller.cache_response(resp.request, resp.raw)

    # Now try to get it
    if sess.cache_controller.cached_request(resp.request):
        print("Cached!")
    else:
        print("Not cached :(")


if __name__ == "__main__":
    main()
site-packages/pip/_vendor/cachecontrol/adapter.py000064400000011377151446177000016164 0ustar00import types
import functools
import zlib

from pip._vendor.requests.adapters import HTTPAdapter

from .controller import CacheController
from .cache import DictCache
from .filewrapper import CallbackFileWrapper


class CacheControlAdapter(HTTPAdapter):
    invalidating_methods = {"PUT", "DELETE"}

    def __init__(
        self,
        cache=None,
        cache_etags=True,
        controller_class=None,
        serializer=None,
        heuristic=None,
        cacheable_methods=None,
        *args,
        **kw
    ):
        super(CacheControlAdapter, self).__init__(*args, **kw)
        self.cache = cache or DictCache()
        self.heuristic = heuristic
        self.cacheable_methods = cacheable_methods or ("GET",)

        controller_factory = controller_class or CacheController
        self.controller = controller_factory(
            self.cache, cache_etags=cache_etags, serializer=serializer
        )

    def send(self, request, cacheable_methods=None, **kw):
        """
        Send a request. Use the request information to see if it
        exists in the cache and cache the response if we need to and can.
        """
        cacheable = cacheable_methods or self.cacheable_methods
        if request.method in cacheable:
            try:
                cached_response = self.controller.cached_request(request)
            except zlib.error:
                cached_response = None
            if cached_response:
                return self.build_response(request, cached_response, from_cache=True)

            # check for etags and add headers if appropriate
            request.headers.update(self.controller.conditional_headers(request))

        resp = super(CacheControlAdapter, self).send(request, **kw)

        return resp

    def build_response(
        self, request, response, from_cache=False, cacheable_methods=None
    ):
        """
        Build a response by making a request or using the cache.

        This will end up calling send and returning a potentially
        cached response
        """
        cacheable = cacheable_methods or self.cacheable_methods
        if not from_cache and request.method in cacheable:
            # Check for any heuristics that might update headers
            # before trying to cache.
            if self.heuristic:
                response = self.heuristic.apply(response)

            # apply any expiration heuristics
            if response.status == 304:
                # We must have sent an ETag request. This could mean
                # that we've been expired already or that we simply
                # have an etag. In either case, we want to try and
                # update the cache if that is the case.
                cached_response = self.controller.update_cached_response(
                    request, response
                )

                if cached_response is not response:
                    from_cache = True

                # We are done with the server response, read a
                # possible response body (compliant servers will
                # not return one, but we cannot be 100% sure) and
                # release the connection back to the pool.
                response.read(decode_content=False)
                response.release_conn()

                response = cached_response

            # We always cache the 301 responses
            elif response.status == 301:
                self.controller.cache_response(request, response)
            else:
                # Wrap the response file with a wrapper that will cache the
                #   response when the stream has been consumed.
                response._fp = CallbackFileWrapper(
                    response._fp,
                    functools.partial(
                        self.controller.cache_response, request, response
                    ),
                )
                if response.chunked:
                    super_update_chunk_length = response._update_chunk_length

                    def _update_chunk_length(self):
                        super_update_chunk_length()
                        if self.chunk_left == 0:
                            self._fp._close()

                    response._update_chunk_length = types.MethodType(
                        _update_chunk_length, response
                    )

        resp = super(CacheControlAdapter, self).build_response(request, response)

        # See if we should invalidate the cache.
        if request.method in self.invalidating_methods and resp.ok:
            cache_url = self.controller.cache_url(request.url)
            self.cache.delete(cache_url)

        # Give the request a from_cache attr to let people use it
        resp.from_cache = from_cache

        return resp

    def close(self):
        self.cache.close()
        super(CacheControlAdapter, self).close()
site-packages/pip/_vendor/idna/codec.py000064400000006343151446177000014065 0ustar00from .core import encode, decode, alabel, ulabel, IDNAError
import codecs
import re

_unicode_dots_re = re.compile(u'[\u002e\u3002\uff0e\uff61]')

class Codec(codecs.Codec):

    def encode(self, data, errors='strict'):

        if errors != 'strict':
            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))

        if not data:
            return "", 0

        return encode(data), len(data)

    def decode(self, data, errors='strict'):

        if errors != 'strict':
            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))

        if not data:
            return u"", 0

        return decode(data), len(data)

class IncrementalEncoder(codecs.BufferedIncrementalEncoder):
    def _buffer_encode(self, data, errors, final):
        if errors != 'strict':
            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))

        if not data:
            return ("", 0)

        labels = _unicode_dots_re.split(data)
        trailing_dot = u''
        if labels:
            if not labels[-1]:
                trailing_dot = '.'
                del labels[-1]
            elif not final:
                # Keep potentially unfinished label until the next call
                del labels[-1]
                if labels:
                    trailing_dot = '.'

        result = []
        size = 0
        for label in labels:
            result.append(alabel(label))
            if size:
                size += 1
            size += len(label)

        # Join with U+002E
        result = ".".join(result) + trailing_dot
        size += len(trailing_dot)
        return (result, size)

class IncrementalDecoder(codecs.BufferedIncrementalDecoder):
    def _buffer_decode(self, data, errors, final):
        if errors != 'strict':
            raise IDNAError("Unsupported error handling \"{0}\"".format(errors))

        if not data:
            return (u"", 0)

        # IDNA allows decoding to operate on Unicode strings, too.
        if isinstance(data, unicode):
            labels = _unicode_dots_re.split(data)
        else:
            # Must be ASCII string
            data = str(data)
            unicode(data, "ascii")
            labels = data.split(".")

        trailing_dot = u''
        if labels:
            if not labels[-1]:
                trailing_dot = u'.'
                del labels[-1]
            elif not final:
                # Keep potentially unfinished label until the next call
                del labels[-1]
                if labels:
                    trailing_dot = u'.'

        result = []
        size = 0
        for label in labels:
            result.append(ulabel(label))
            if size:
                size += 1
            size += len(label)

        result = u".".join(result) + trailing_dot
        size += len(trailing_dot)
        return (result, size)


class StreamWriter(Codec, codecs.StreamWriter):
    pass

class StreamReader(Codec, codecs.StreamReader):
    pass

def getregentry():
    return codecs.CodecInfo(
        name='idna',
        encode=Codec().encode,
        decode=Codec().decode,
        incrementalencoder=IncrementalEncoder,
        incrementaldecoder=IncrementalDecoder,
        streamwriter=StreamWriter,
        streamreader=StreamReader,
    )
site-packages/pip/_vendor/idna/uts46data.py000064400000603224151446177000014630 0ustar00# This file is automatically generated by tools/idna-data
# vim: set fileencoding=utf-8 :

"""IDNA Mapping Table from UTS46."""


__version__ = "11.0.0"
def _seg_0():
    return [
    (0x0, '3'),
    (0x1, '3'),
    (0x2, '3'),
    (0x3, '3'),
    (0x4, '3'),
    (0x5, '3'),
    (0x6, '3'),
    (0x7, '3'),
    (0x8, '3'),
    (0x9, '3'),
    (0xA, '3'),
    (0xB, '3'),
    (0xC, '3'),
    (0xD, '3'),
    (0xE, '3'),
    (0xF, '3'),
    (0x10, '3'),
    (0x11, '3'),
    (0x12, '3'),
    (0x13, '3'),
    (0x14, '3'),
    (0x15, '3'),
    (0x16, '3'),
    (0x17, '3'),
    (0x18, '3'),
    (0x19, '3'),
    (0x1A, '3'),
    (0x1B, '3'),
    (0x1C, '3'),
    (0x1D, '3'),
    (0x1E, '3'),
    (0x1F, '3'),
    (0x20, '3'),
    (0x21, '3'),
    (0x22, '3'),
    (0x23, '3'),
    (0x24, '3'),
    (0x25, '3'),
    (0x26, '3'),
    (0x27, '3'),
    (0x28, '3'),
    (0x29, '3'),
    (0x2A, '3'),
    (0x2B, '3'),
    (0x2C, '3'),
    (0x2D, 'V'),
    (0x2E, 'V'),
    (0x2F, '3'),
    (0x30, 'V'),
    (0x31, 'V'),
    (0x32, 'V'),
    (0x33, 'V'),
    (0x34, 'V'),
    (0x35, 'V'),
    (0x36, 'V'),
    (0x37, 'V'),
    (0x38, 'V'),
    (0x39, 'V'),
    (0x3A, '3'),
    (0x3B, '3'),
    (0x3C, '3'),
    (0x3D, '3'),
    (0x3E, '3'),
    (0x3F, '3'),
    (0x40, '3'),
    (0x41, 'M', u'a'),
    (0x42, 'M', u'b'),
    (0x43, 'M', u'c'),
    (0x44, 'M', u'd'),
    (0x45, 'M', u'e'),
    (0x46, 'M', u'f'),
    (0x47, 'M', u'g'),
    (0x48, 'M', u'h'),
    (0x49, 'M', u'i'),
    (0x4A, 'M', u'j'),
    (0x4B, 'M', u'k'),
    (0x4C, 'M', u'l'),
    (0x4D, 'M', u'm'),
    (0x4E, 'M', u'n'),
    (0x4F, 'M', u'o'),
    (0x50, 'M', u'p'),
    (0x51, 'M', u'q'),
    (0x52, 'M', u'r'),
    (0x53, 'M', u's'),
    (0x54, 'M', u't'),
    (0x55, 'M', u'u'),
    (0x56, 'M', u'v'),
    (0x57, 'M', u'w'),
    (0x58, 'M', u'x'),
    (0x59, 'M', u'y'),
    (0x5A, 'M', u'z'),
    (0x5B, '3'),
    (0x5C, '3'),
    (0x5D, '3'),
    (0x5E, '3'),
    (0x5F, '3'),
    (0x60, '3'),
    (0x61, 'V'),
    (0x62, 'V'),
    (0x63, 'V'),
    ]

def _seg_1():
    return [
    (0x64, 'V'),
    (0x65, 'V'),
    (0x66, 'V'),
    (0x67, 'V'),
    (0x68, 'V'),
    (0x69, 'V'),
    (0x6A, 'V'),
    (0x6B, 'V'),
    (0x6C, 'V'),
    (0x6D, 'V'),
    (0x6E, 'V'),
    (0x6F, 'V'),
    (0x70, 'V'),
    (0x71, 'V'),
    (0x72, 'V'),
    (0x73, 'V'),
    (0x74, 'V'),
    (0x75, 'V'),
    (0x76, 'V'),
    (0x77, 'V'),
    (0x78, 'V'),
    (0x79, 'V'),
    (0x7A, 'V'),
    (0x7B, '3'),
    (0x7C, '3'),
    (0x7D, '3'),
    (0x7E, '3'),
    (0x7F, '3'),
    (0x80, 'X'),
    (0x81, 'X'),
    (0x82, 'X'),
    (0x83, 'X'),
    (0x84, 'X'),
    (0x85, 'X'),
    (0x86, 'X'),
    (0x87, 'X'),
    (0x88, 'X'),
    (0x89, 'X'),
    (0x8A, 'X'),
    (0x8B, 'X'),
    (0x8C, 'X'),
    (0x8D, 'X'),
    (0x8E, 'X'),
    (0x8F, 'X'),
    (0x90, 'X'),
    (0x91, 'X'),
    (0x92, 'X'),
    (0x93, 'X'),
    (0x94, 'X'),
    (0x95, 'X'),
    (0x96, 'X'),
    (0x97, 'X'),
    (0x98, 'X'),
    (0x99, 'X'),
    (0x9A, 'X'),
    (0x9B, 'X'),
    (0x9C, 'X'),
    (0x9D, 'X'),
    (0x9E, 'X'),
    (0x9F, 'X'),
    (0xA0, '3', u' '),
    (0xA1, 'V'),
    (0xA2, 'V'),
    (0xA3, 'V'),
    (0xA4, 'V'),
    (0xA5, 'V'),
    (0xA6, 'V'),
    (0xA7, 'V'),
    (0xA8, '3', u' ̈'),
    (0xA9, 'V'),
    (0xAA, 'M', u'a'),
    (0xAB, 'V'),
    (0xAC, 'V'),
    (0xAD, 'I'),
    (0xAE, 'V'),
    (0xAF, '3', u' ̄'),
    (0xB0, 'V'),
    (0xB1, 'V'),
    (0xB2, 'M', u'2'),
    (0xB3, 'M', u'3'),
    (0xB4, '3', u' ́'),
    (0xB5, 'M', u'μ'),
    (0xB6, 'V'),
    (0xB7, 'V'),
    (0xB8, '3', u' ̧'),
    (0xB9, 'M', u'1'),
    (0xBA, 'M', u'o'),
    (0xBB, 'V'),
    (0xBC, 'M', u'1⁄4'),
    (0xBD, 'M', u'1⁄2'),
    (0xBE, 'M', u'3⁄4'),
    (0xBF, 'V'),
    (0xC0, 'M', u'à'),
    (0xC1, 'M', u'á'),
    (0xC2, 'M', u'â'),
    (0xC3, 'M', u'ã'),
    (0xC4, 'M', u'ä'),
    (0xC5, 'M', u'å'),
    (0xC6, 'M', u'æ'),
    (0xC7, 'M', u'ç'),
    ]

def _seg_2():
    return [
    (0xC8, 'M', u'è'),
    (0xC9, 'M', u'é'),
    (0xCA, 'M', u'ê'),
    (0xCB, 'M', u'ë'),
    (0xCC, 'M', u'ì'),
    (0xCD, 'M', u'í'),
    (0xCE, 'M', u'î'),
    (0xCF, 'M', u'ï'),
    (0xD0, 'M', u'ð'),
    (0xD1, 'M', u'ñ'),
    (0xD2, 'M', u'ò'),
    (0xD3, 'M', u'ó'),
    (0xD4, 'M', u'ô'),
    (0xD5, 'M', u'õ'),
    (0xD6, 'M', u'ö'),
    (0xD7, 'V'),
    (0xD8, 'M', u'ø'),
    (0xD9, 'M', u'ù'),
    (0xDA, 'M', u'ú'),
    (0xDB, 'M', u'û'),
    (0xDC, 'M', u'ü'),
    (0xDD, 'M', u'ý'),
    (0xDE, 'M', u'þ'),
    (0xDF, 'D', u'ss'),
    (0xE0, 'V'),
    (0xE1, 'V'),
    (0xE2, 'V'),
    (0xE3, 'V'),
    (0xE4, 'V'),
    (0xE5, 'V'),
    (0xE6, 'V'),
    (0xE7, 'V'),
    (0xE8, 'V'),
    (0xE9, 'V'),
    (0xEA, 'V'),
    (0xEB, 'V'),
    (0xEC, 'V'),
    (0xED, 'V'),
    (0xEE, 'V'),
    (0xEF, 'V'),
    (0xF0, 'V'),
    (0xF1, 'V'),
    (0xF2, 'V'),
    (0xF3, 'V'),
    (0xF4, 'V'),
    (0xF5, 'V'),
    (0xF6, 'V'),
    (0xF7, 'V'),
    (0xF8, 'V'),
    (0xF9, 'V'),
    (0xFA, 'V'),
    (0xFB, 'V'),
    (0xFC, 'V'),
    (0xFD, 'V'),
    (0xFE, 'V'),
    (0xFF, 'V'),
    (0x100, 'M', u'ā'),
    (0x101, 'V'),
    (0x102, 'M', u'ă'),
    (0x103, 'V'),
    (0x104, 'M', u'ą'),
    (0x105, 'V'),
    (0x106, 'M', u'ć'),
    (0x107, 'V'),
    (0x108, 'M', u'ĉ'),
    (0x109, 'V'),
    (0x10A, 'M', u'ċ'),
    (0x10B, 'V'),
    (0x10C, 'M', u'č'),
    (0x10D, 'V'),
    (0x10E, 'M', u'ď'),
    (0x10F, 'V'),
    (0x110, 'M', u'đ'),
    (0x111, 'V'),
    (0x112, 'M', u'ē'),
    (0x113, 'V'),
    (0x114, 'M', u'ĕ'),
    (0x115, 'V'),
    (0x116, 'M', u'ė'),
    (0x117, 'V'),
    (0x118, 'M', u'ę'),
    (0x119, 'V'),
    (0x11A, 'M', u'ě'),
    (0x11B, 'V'),
    (0x11C, 'M', u'ĝ'),
    (0x11D, 'V'),
    (0x11E, 'M', u'ğ'),
    (0x11F, 'V'),
    (0x120, 'M', u'ġ'),
    (0x121, 'V'),
    (0x122, 'M', u'ģ'),
    (0x123, 'V'),
    (0x124, 'M', u'ĥ'),
    (0x125, 'V'),
    (0x126, 'M', u'ħ'),
    (0x127, 'V'),
    (0x128, 'M', u'ĩ'),
    (0x129, 'V'),
    (0x12A, 'M', u'ī'),
    (0x12B, 'V'),
    ]

def _seg_3():
    return [
    (0x12C, 'M', u'ĭ'),
    (0x12D, 'V'),
    (0x12E, 'M', u'į'),
    (0x12F, 'V'),
    (0x130, 'M', u'i̇'),
    (0x131, 'V'),
    (0x132, 'M', u'ij'),
    (0x134, 'M', u'ĵ'),
    (0x135, 'V'),
    (0x136, 'M', u'ķ'),
    (0x137, 'V'),
    (0x139, 'M', u'ĺ'),
    (0x13A, 'V'),
    (0x13B, 'M', u'ļ'),
    (0x13C, 'V'),
    (0x13D, 'M', u'ľ'),
    (0x13E, 'V'),
    (0x13F, 'M', u'l·'),
    (0x141, 'M', u'ł'),
    (0x142, 'V'),
    (0x143, 'M', u'ń'),
    (0x144, 'V'),
    (0x145, 'M', u'ņ'),
    (0x146, 'V'),
    (0x147, 'M', u'ň'),
    (0x148, 'V'),
    (0x149, 'M', u'ʼn'),
    (0x14A, 'M', u'ŋ'),
    (0x14B, 'V'),
    (0x14C, 'M', u'ō'),
    (0x14D, 'V'),
    (0x14E, 'M', u'ŏ'),
    (0x14F, 'V'),
    (0x150, 'M', u'ő'),
    (0x151, 'V'),
    (0x152, 'M', u'œ'),
    (0x153, 'V'),
    (0x154, 'M', u'ŕ'),
    (0x155, 'V'),
    (0x156, 'M', u'ŗ'),
    (0x157, 'V'),
    (0x158, 'M', u'ř'),
    (0x159, 'V'),
    (0x15A, 'M', u'ś'),
    (0x15B, 'V'),
    (0x15C, 'M', u'ŝ'),
    (0x15D, 'V'),
    (0x15E, 'M', u'ş'),
    (0x15F, 'V'),
    (0x160, 'M', u'š'),
    (0x161, 'V'),
    (0x162, 'M', u'ţ'),
    (0x163, 'V'),
    (0x164, 'M', u'ť'),
    (0x165, 'V'),
    (0x166, 'M', u'ŧ'),
    (0x167, 'V'),
    (0x168, 'M', u'ũ'),
    (0x169, 'V'),
    (0x16A, 'M', u'ū'),
    (0x16B, 'V'),
    (0x16C, 'M', u'ŭ'),
    (0x16D, 'V'),
    (0x16E, 'M', u'ů'),
    (0x16F, 'V'),
    (0x170, 'M', u'ű'),
    (0x171, 'V'),
    (0x172, 'M', u'ų'),
    (0x173, 'V'),
    (0x174, 'M', u'ŵ'),
    (0x175, 'V'),
    (0x176, 'M', u'ŷ'),
    (0x177, 'V'),
    (0x178, 'M', u'ÿ'),
    (0x179, 'M', u'ź'),
    (0x17A, 'V'),
    (0x17B, 'M', u'ż'),
    (0x17C, 'V'),
    (0x17D, 'M', u'ž'),
    (0x17E, 'V'),
    (0x17F, 'M', u's'),
    (0x180, 'V'),
    (0x181, 'M', u'ɓ'),
    (0x182, 'M', u'ƃ'),
    (0x183, 'V'),
    (0x184, 'M', u'ƅ'),
    (0x185, 'V'),
    (0x186, 'M', u'ɔ'),
    (0x187, 'M', u'ƈ'),
    (0x188, 'V'),
    (0x189, 'M', u'ɖ'),
    (0x18A, 'M', u'ɗ'),
    (0x18B, 'M', u'ƌ'),
    (0x18C, 'V'),
    (0x18E, 'M', u'ǝ'),
    (0x18F, 'M', u'ə'),
    (0x190, 'M', u'ɛ'),
    (0x191, 'M', u'ƒ'),
    (0x192, 'V'),
    (0x193, 'M', u'ɠ'),
    ]

def _seg_4():
    return [
    (0x194, 'M', u'ɣ'),
    (0x195, 'V'),
    (0x196, 'M', u'ɩ'),
    (0x197, 'M', u'ɨ'),
    (0x198, 'M', u'ƙ'),
    (0x199, 'V'),
    (0x19C, 'M', u'ɯ'),
    (0x19D, 'M', u'ɲ'),
    (0x19E, 'V'),
    (0x19F, 'M', u'ɵ'),
    (0x1A0, 'M', u'ơ'),
    (0x1A1, 'V'),
    (0x1A2, 'M', u'ƣ'),
    (0x1A3, 'V'),
    (0x1A4, 'M', u'ƥ'),
    (0x1A5, 'V'),
    (0x1A6, 'M', u'ʀ'),
    (0x1A7, 'M', u'ƨ'),
    (0x1A8, 'V'),
    (0x1A9, 'M', u'ʃ'),
    (0x1AA, 'V'),
    (0x1AC, 'M', u'ƭ'),
    (0x1AD, 'V'),
    (0x1AE, 'M', u'ʈ'),
    (0x1AF, 'M', u'ư'),
    (0x1B0, 'V'),
    (0x1B1, 'M', u'ʊ'),
    (0x1B2, 'M', u'ʋ'),
    (0x1B3, 'M', u'ƴ'),
    (0x1B4, 'V'),
    (0x1B5, 'M', u'ƶ'),
    (0x1B6, 'V'),
    (0x1B7, 'M', u'ʒ'),
    (0x1B8, 'M', u'ƹ'),
    (0x1B9, 'V'),
    (0x1BC, 'M', u'ƽ'),
    (0x1BD, 'V'),
    (0x1C4, 'M', u'dž'),
    (0x1C7, 'M', u'lj'),
    (0x1CA, 'M', u'nj'),
    (0x1CD, 'M', u'ǎ'),
    (0x1CE, 'V'),
    (0x1CF, 'M', u'ǐ'),
    (0x1D0, 'V'),
    (0x1D1, 'M', u'ǒ'),
    (0x1D2, 'V'),
    (0x1D3, 'M', u'ǔ'),
    (0x1D4, 'V'),
    (0x1D5, 'M', u'ǖ'),
    (0x1D6, 'V'),
    (0x1D7, 'M', u'ǘ'),
    (0x1D8, 'V'),
    (0x1D9, 'M', u'ǚ'),
    (0x1DA, 'V'),
    (0x1DB, 'M', u'ǜ'),
    (0x1DC, 'V'),
    (0x1DE, 'M', u'ǟ'),
    (0x1DF, 'V'),
    (0x1E0, 'M', u'ǡ'),
    (0x1E1, 'V'),
    (0x1E2, 'M', u'ǣ'),
    (0x1E3, 'V'),
    (0x1E4, 'M', u'ǥ'),
    (0x1E5, 'V'),
    (0x1E6, 'M', u'ǧ'),
    (0x1E7, 'V'),
    (0x1E8, 'M', u'ǩ'),
    (0x1E9, 'V'),
    (0x1EA, 'M', u'ǫ'),
    (0x1EB, 'V'),
    (0x1EC, 'M', u'ǭ'),
    (0x1ED, 'V'),
    (0x1EE, 'M', u'ǯ'),
    (0x1EF, 'V'),
    (0x1F1, 'M', u'dz'),
    (0x1F4, 'M', u'ǵ'),
    (0x1F5, 'V'),
    (0x1F6, 'M', u'ƕ'),
    (0x1F7, 'M', u'ƿ'),
    (0x1F8, 'M', u'ǹ'),
    (0x1F9, 'V'),
    (0x1FA, 'M', u'ǻ'),
    (0x1FB, 'V'),
    (0x1FC, 'M', u'ǽ'),
    (0x1FD, 'V'),
    (0x1FE, 'M', u'ǿ'),
    (0x1FF, 'V'),
    (0x200, 'M', u'ȁ'),
    (0x201, 'V'),
    (0x202, 'M', u'ȃ'),
    (0x203, 'V'),
    (0x204, 'M', u'ȅ'),
    (0x205, 'V'),
    (0x206, 'M', u'ȇ'),
    (0x207, 'V'),
    (0x208, 'M', u'ȉ'),
    (0x209, 'V'),
    (0x20A, 'M', u'ȋ'),
    (0x20B, 'V'),
    (0x20C, 'M', u'ȍ'),
    ]

def _seg_5():
    return [
    (0x20D, 'V'),
    (0x20E, 'M', u'ȏ'),
    (0x20F, 'V'),
    (0x210, 'M', u'ȑ'),
    (0x211, 'V'),
    (0x212, 'M', u'ȓ'),
    (0x213, 'V'),
    (0x214, 'M', u'ȕ'),
    (0x215, 'V'),
    (0x216, 'M', u'ȗ'),
    (0x217, 'V'),
    (0x218, 'M', u'ș'),
    (0x219, 'V'),
    (0x21A, 'M', u'ț'),
    (0x21B, 'V'),
    (0x21C, 'M', u'ȝ'),
    (0x21D, 'V'),
    (0x21E, 'M', u'ȟ'),
    (0x21F, 'V'),
    (0x220, 'M', u'ƞ'),
    (0x221, 'V'),
    (0x222, 'M', u'ȣ'),
    (0x223, 'V'),
    (0x224, 'M', u'ȥ'),
    (0x225, 'V'),
    (0x226, 'M', u'ȧ'),
    (0x227, 'V'),
    (0x228, 'M', u'ȩ'),
    (0x229, 'V'),
    (0x22A, 'M', u'ȫ'),
    (0x22B, 'V'),
    (0x22C, 'M', u'ȭ'),
    (0x22D, 'V'),
    (0x22E, 'M', u'ȯ'),
    (0x22F, 'V'),
    (0x230, 'M', u'ȱ'),
    (0x231, 'V'),
    (0x232, 'M', u'ȳ'),
    (0x233, 'V'),
    (0x23A, 'M', u'ⱥ'),
    (0x23B, 'M', u'ȼ'),
    (0x23C, 'V'),
    (0x23D, 'M', u'ƚ'),
    (0x23E, 'M', u'ⱦ'),
    (0x23F, 'V'),
    (0x241, 'M', u'ɂ'),
    (0x242, 'V'),
    (0x243, 'M', u'ƀ'),
    (0x244, 'M', u'ʉ'),
    (0x245, 'M', u'ʌ'),
    (0x246, 'M', u'ɇ'),
    (0x247, 'V'),
    (0x248, 'M', u'ɉ'),
    (0x249, 'V'),
    (0x24A, 'M', u'ɋ'),
    (0x24B, 'V'),
    (0x24C, 'M', u'ɍ'),
    (0x24D, 'V'),
    (0x24E, 'M', u'ɏ'),
    (0x24F, 'V'),
    (0x2B0, 'M', u'h'),
    (0x2B1, 'M', u'ɦ'),
    (0x2B2, 'M', u'j'),
    (0x2B3, 'M', u'r'),
    (0x2B4, 'M', u'ɹ'),
    (0x2B5, 'M', u'ɻ'),
    (0x2B6, 'M', u'ʁ'),
    (0x2B7, 'M', u'w'),
    (0x2B8, 'M', u'y'),
    (0x2B9, 'V'),
    (0x2D8, '3', u' ̆'),
    (0x2D9, '3', u' ̇'),
    (0x2DA, '3', u' ̊'),
    (0x2DB, '3', u' ̨'),
    (0x2DC, '3', u' ̃'),
    (0x2DD, '3', u' ̋'),
    (0x2DE, 'V'),
    (0x2E0, 'M', u'ɣ'),
    (0x2E1, 'M', u'l'),
    (0x2E2, 'M', u's'),
    (0x2E3, 'M', u'x'),
    (0x2E4, 'M', u'ʕ'),
    (0x2E5, 'V'),
    (0x340, 'M', u'̀'),
    (0x341, 'M', u'́'),
    (0x342, 'V'),
    (0x343, 'M', u'̓'),
    (0x344, 'M', u'̈́'),
    (0x345, 'M', u'ι'),
    (0x346, 'V'),
    (0x34F, 'I'),
    (0x350, 'V'),
    (0x370, 'M', u'ͱ'),
    (0x371, 'V'),
    (0x372, 'M', u'ͳ'),
    (0x373, 'V'),
    (0x374, 'M', u'ʹ'),
    (0x375, 'V'),
    (0x376, 'M', u'ͷ'),
    (0x377, 'V'),
    ]

def _seg_6():
    return [
    (0x378, 'X'),
    (0x37A, '3', u' ι'),
    (0x37B, 'V'),
    (0x37E, '3', u';'),
    (0x37F, 'M', u'ϳ'),
    (0x380, 'X'),
    (0x384, '3', u' ́'),
    (0x385, '3', u' ̈́'),
    (0x386, 'M', u'ά'),
    (0x387, 'M', u'·'),
    (0x388, 'M', u'έ'),
    (0x389, 'M', u'ή'),
    (0x38A, 'M', u'ί'),
    (0x38B, 'X'),
    (0x38C, 'M', u'ό'),
    (0x38D, 'X'),
    (0x38E, 'M', u'ύ'),
    (0x38F, 'M', u'ώ'),
    (0x390, 'V'),
    (0x391, 'M', u'α'),
    (0x392, 'M', u'β'),
    (0x393, 'M', u'γ'),
    (0x394, 'M', u'δ'),
    (0x395, 'M', u'ε'),
    (0x396, 'M', u'ζ'),
    (0x397, 'M', u'η'),
    (0x398, 'M', u'θ'),
    (0x399, 'M', u'ι'),
    (0x39A, 'M', u'κ'),
    (0x39B, 'M', u'λ'),
    (0x39C, 'M', u'μ'),
    (0x39D, 'M', u'ν'),
    (0x39E, 'M', u'ξ'),
    (0x39F, 'M', u'ο'),
    (0x3A0, 'M', u'π'),
    (0x3A1, 'M', u'ρ'),
    (0x3A2, 'X'),
    (0x3A3, 'M', u'σ'),
    (0x3A4, 'M', u'τ'),
    (0x3A5, 'M', u'υ'),
    (0x3A6, 'M', u'φ'),
    (0x3A7, 'M', u'χ'),
    (0x3A8, 'M', u'ψ'),
    (0x3A9, 'M', u'ω'),
    (0x3AA, 'M', u'ϊ'),
    (0x3AB, 'M', u'ϋ'),
    (0x3AC, 'V'),
    (0x3C2, 'D', u'σ'),
    (0x3C3, 'V'),
    (0x3CF, 'M', u'ϗ'),
    (0x3D0, 'M', u'β'),
    (0x3D1, 'M', u'θ'),
    (0x3D2, 'M', u'υ'),
    (0x3D3, 'M', u'ύ'),
    (0x3D4, 'M', u'ϋ'),
    (0x3D5, 'M', u'φ'),
    (0x3D6, 'M', u'π'),
    (0x3D7, 'V'),
    (0x3D8, 'M', u'ϙ'),
    (0x3D9, 'V'),
    (0x3DA, 'M', u'ϛ'),
    (0x3DB, 'V'),
    (0x3DC, 'M', u'ϝ'),
    (0x3DD, 'V'),
    (0x3DE, 'M', u'ϟ'),
    (0x3DF, 'V'),
    (0x3E0, 'M', u'ϡ'),
    (0x3E1, 'V'),
    (0x3E2, 'M', u'ϣ'),
    (0x3E3, 'V'),
    (0x3E4, 'M', u'ϥ'),
    (0x3E5, 'V'),
    (0x3E6, 'M', u'ϧ'),
    (0x3E7, 'V'),
    (0x3E8, 'M', u'ϩ'),
    (0x3E9, 'V'),
    (0x3EA, 'M', u'ϫ'),
    (0x3EB, 'V'),
    (0x3EC, 'M', u'ϭ'),
    (0x3ED, 'V'),
    (0x3EE, 'M', u'ϯ'),
    (0x3EF, 'V'),
    (0x3F0, 'M', u'κ'),
    (0x3F1, 'M', u'ρ'),
    (0x3F2, 'M', u'σ'),
    (0x3F3, 'V'),
    (0x3F4, 'M', u'θ'),
    (0x3F5, 'M', u'ε'),
    (0x3F6, 'V'),
    (0x3F7, 'M', u'ϸ'),
    (0x3F8, 'V'),
    (0x3F9, 'M', u'σ'),
    (0x3FA, 'M', u'ϻ'),
    (0x3FB, 'V'),
    (0x3FD, 'M', u'ͻ'),
    (0x3FE, 'M', u'ͼ'),
    (0x3FF, 'M', u'ͽ'),
    (0x400, 'M', u'ѐ'),
    (0x401, 'M', u'ё'),
    (0x402, 'M', u'ђ'),
    ]

def _seg_7():
    return [
    (0x403, 'M', u'ѓ'),
    (0x404, 'M', u'є'),
    (0x405, 'M', u'ѕ'),
    (0x406, 'M', u'і'),
    (0x407, 'M', u'ї'),
    (0x408, 'M', u'ј'),
    (0x409, 'M', u'љ'),
    (0x40A, 'M', u'њ'),
    (0x40B, 'M', u'ћ'),
    (0x40C, 'M', u'ќ'),
    (0x40D, 'M', u'ѝ'),
    (0x40E, 'M', u'ў'),
    (0x40F, 'M', u'џ'),
    (0x410, 'M', u'а'),
    (0x411, 'M', u'б'),
    (0x412, 'M', u'в'),
    (0x413, 'M', u'г'),
    (0x414, 'M', u'д'),
    (0x415, 'M', u'е'),
    (0x416, 'M', u'ж'),
    (0x417, 'M', u'з'),
    (0x418, 'M', u'и'),
    (0x419, 'M', u'й'),
    (0x41A, 'M', u'к'),
    (0x41B, 'M', u'л'),
    (0x41C, 'M', u'м'),
    (0x41D, 'M', u'н'),
    (0x41E, 'M', u'о'),
    (0x41F, 'M', u'п'),
    (0x420, 'M', u'р'),
    (0x421, 'M', u'с'),
    (0x422, 'M', u'т'),
    (0x423, 'M', u'у'),
    (0x424, 'M', u'ф'),
    (0x425, 'M', u'х'),
    (0x426, 'M', u'ц'),
    (0x427, 'M', u'ч'),
    (0x428, 'M', u'ш'),
    (0x429, 'M', u'щ'),
    (0x42A, 'M', u'ъ'),
    (0x42B, 'M', u'ы'),
    (0x42C, 'M', u'ь'),
    (0x42D, 'M', u'э'),
    (0x42E, 'M', u'ю'),
    (0x42F, 'M', u'я'),
    (0x430, 'V'),
    (0x460, 'M', u'ѡ'),
    (0x461, 'V'),
    (0x462, 'M', u'ѣ'),
    (0x463, 'V'),
    (0x464, 'M', u'ѥ'),
    (0x465, 'V'),
    (0x466, 'M', u'ѧ'),
    (0x467, 'V'),
    (0x468, 'M', u'ѩ'),
    (0x469, 'V'),
    (0x46A, 'M', u'ѫ'),
    (0x46B, 'V'),
    (0x46C, 'M', u'ѭ'),
    (0x46D, 'V'),
    (0x46E, 'M', u'ѯ'),
    (0x46F, 'V'),
    (0x470, 'M', u'ѱ'),
    (0x471, 'V'),
    (0x472, 'M', u'ѳ'),
    (0x473, 'V'),
    (0x474, 'M', u'ѵ'),
    (0x475, 'V'),
    (0x476, 'M', u'ѷ'),
    (0x477, 'V'),
    (0x478, 'M', u'ѹ'),
    (0x479, 'V'),
    (0x47A, 'M', u'ѻ'),
    (0x47B, 'V'),
    (0x47C, 'M', u'ѽ'),
    (0x47D, 'V'),
    (0x47E, 'M', u'ѿ'),
    (0x47F, 'V'),
    (0x480, 'M', u'ҁ'),
    (0x481, 'V'),
    (0x48A, 'M', u'ҋ'),
    (0x48B, 'V'),
    (0x48C, 'M', u'ҍ'),
    (0x48D, 'V'),
    (0x48E, 'M', u'ҏ'),
    (0x48F, 'V'),
    (0x490, 'M', u'ґ'),
    (0x491, 'V'),
    (0x492, 'M', u'ғ'),
    (0x493, 'V'),
    (0x494, 'M', u'ҕ'),
    (0x495, 'V'),
    (0x496, 'M', u'җ'),
    (0x497, 'V'),
    (0x498, 'M', u'ҙ'),
    (0x499, 'V'),
    (0x49A, 'M', u'қ'),
    (0x49B, 'V'),
    (0x49C, 'M', u'ҝ'),
    (0x49D, 'V'),
    ]

def _seg_8():
    return [
    (0x49E, 'M', u'ҟ'),
    (0x49F, 'V'),
    (0x4A0, 'M', u'ҡ'),
    (0x4A1, 'V'),
    (0x4A2, 'M', u'ң'),
    (0x4A3, 'V'),
    (0x4A4, 'M', u'ҥ'),
    (0x4A5, 'V'),
    (0x4A6, 'M', u'ҧ'),
    (0x4A7, 'V'),
    (0x4A8, 'M', u'ҩ'),
    (0x4A9, 'V'),
    (0x4AA, 'M', u'ҫ'),
    (0x4AB, 'V'),
    (0x4AC, 'M', u'ҭ'),
    (0x4AD, 'V'),
    (0x4AE, 'M', u'ү'),
    (0x4AF, 'V'),
    (0x4B0, 'M', u'ұ'),
    (0x4B1, 'V'),
    (0x4B2, 'M', u'ҳ'),
    (0x4B3, 'V'),
    (0x4B4, 'M', u'ҵ'),
    (0x4B5, 'V'),
    (0x4B6, 'M', u'ҷ'),
    (0x4B7, 'V'),
    (0x4B8, 'M', u'ҹ'),
    (0x4B9, 'V'),
    (0x4BA, 'M', u'һ'),
    (0x4BB, 'V'),
    (0x4BC, 'M', u'ҽ'),
    (0x4BD, 'V'),
    (0x4BE, 'M', u'ҿ'),
    (0x4BF, 'V'),
    (0x4C0, 'X'),
    (0x4C1, 'M', u'ӂ'),
    (0x4C2, 'V'),
    (0x4C3, 'M', u'ӄ'),
    (0x4C4, 'V'),
    (0x4C5, 'M', u'ӆ'),
    (0x4C6, 'V'),
    (0x4C7, 'M', u'ӈ'),
    (0x4C8, 'V'),
    (0x4C9, 'M', u'ӊ'),
    (0x4CA, 'V'),
    (0x4CB, 'M', u'ӌ'),
    (0x4CC, 'V'),
    (0x4CD, 'M', u'ӎ'),
    (0x4CE, 'V'),
    (0x4D0, 'M', u'ӑ'),
    (0x4D1, 'V'),
    (0x4D2, 'M', u'ӓ'),
    (0x4D3, 'V'),
    (0x4D4, 'M', u'ӕ'),
    (0x4D5, 'V'),
    (0x4D6, 'M', u'ӗ'),
    (0x4D7, 'V'),
    (0x4D8, 'M', u'ә'),
    (0x4D9, 'V'),
    (0x4DA, 'M', u'ӛ'),
    (0x4DB, 'V'),
    (0x4DC, 'M', u'ӝ'),
    (0x4DD, 'V'),
    (0x4DE, 'M', u'ӟ'),
    (0x4DF, 'V'),
    (0x4E0, 'M', u'ӡ'),
    (0x4E1, 'V'),
    (0x4E2, 'M', u'ӣ'),
    (0x4E3, 'V'),
    (0x4E4, 'M', u'ӥ'),
    (0x4E5, 'V'),
    (0x4E6, 'M', u'ӧ'),
    (0x4E7, 'V'),
    (0x4E8, 'M', u'ө'),
    (0x4E9, 'V'),
    (0x4EA, 'M', u'ӫ'),
    (0x4EB, 'V'),
    (0x4EC, 'M', u'ӭ'),
    (0x4ED, 'V'),
    (0x4EE, 'M', u'ӯ'),
    (0x4EF, 'V'),
    (0x4F0, 'M', u'ӱ'),
    (0x4F1, 'V'),
    (0x4F2, 'M', u'ӳ'),
    (0x4F3, 'V'),
    (0x4F4, 'M', u'ӵ'),
    (0x4F5, 'V'),
    (0x4F6, 'M', u'ӷ'),
    (0x4F7, 'V'),
    (0x4F8, 'M', u'ӹ'),
    (0x4F9, 'V'),
    (0x4FA, 'M', u'ӻ'),
    (0x4FB, 'V'),
    (0x4FC, 'M', u'ӽ'),
    (0x4FD, 'V'),
    (0x4FE, 'M', u'ӿ'),
    (0x4FF, 'V'),
    (0x500, 'M', u'ԁ'),
    (0x501, 'V'),
    (0x502, 'M', u'ԃ'),
    ]

def _seg_9():
    return [
    (0x503, 'V'),
    (0x504, 'M', u'ԅ'),
    (0x505, 'V'),
    (0x506, 'M', u'ԇ'),
    (0x507, 'V'),
    (0x508, 'M', u'ԉ'),
    (0x509, 'V'),
    (0x50A, 'M', u'ԋ'),
    (0x50B, 'V'),
    (0x50C, 'M', u'ԍ'),
    (0x50D, 'V'),
    (0x50E, 'M', u'ԏ'),
    (0x50F, 'V'),
    (0x510, 'M', u'ԑ'),
    (0x511, 'V'),
    (0x512, 'M', u'ԓ'),
    (0x513, 'V'),
    (0x514, 'M', u'ԕ'),
    (0x515, 'V'),
    (0x516, 'M', u'ԗ'),
    (0x517, 'V'),
    (0x518, 'M', u'ԙ'),
    (0x519, 'V'),
    (0x51A, 'M', u'ԛ'),
    (0x51B, 'V'),
    (0x51C, 'M', u'ԝ'),
    (0x51D, 'V'),
    (0x51E, 'M', u'ԟ'),
    (0x51F, 'V'),
    (0x520, 'M', u'ԡ'),
    (0x521, 'V'),
    (0x522, 'M', u'ԣ'),
    (0x523, 'V'),
    (0x524, 'M', u'ԥ'),
    (0x525, 'V'),
    (0x526, 'M', u'ԧ'),
    (0x527, 'V'),
    (0x528, 'M', u'ԩ'),
    (0x529, 'V'),
    (0x52A, 'M', u'ԫ'),
    (0x52B, 'V'),
    (0x52C, 'M', u'ԭ'),
    (0x52D, 'V'),
    (0x52E, 'M', u'ԯ'),
    (0x52F, 'V'),
    (0x530, 'X'),
    (0x531, 'M', u'ա'),
    (0x532, 'M', u'բ'),
    (0x533, 'M', u'գ'),
    (0x534, 'M', u'դ'),
    (0x535, 'M', u'ե'),
    (0x536, 'M', u'զ'),
    (0x537, 'M', u'է'),
    (0x538, 'M', u'ը'),
    (0x539, 'M', u'թ'),
    (0x53A, 'M', u'ժ'),
    (0x53B, 'M', u'ի'),
    (0x53C, 'M', u'լ'),
    (0x53D, 'M', u'խ'),
    (0x53E, 'M', u'ծ'),
    (0x53F, 'M', u'կ'),
    (0x540, 'M', u'հ'),
    (0x541, 'M', u'ձ'),
    (0x542, 'M', u'ղ'),
    (0x543, 'M', u'ճ'),
    (0x544, 'M', u'մ'),
    (0x545, 'M', u'յ'),
    (0x546, 'M', u'ն'),
    (0x547, 'M', u'շ'),
    (0x548, 'M', u'ո'),
    (0x549, 'M', u'չ'),
    (0x54A, 'M', u'պ'),
    (0x54B, 'M', u'ջ'),
    (0x54C, 'M', u'ռ'),
    (0x54D, 'M', u'ս'),
    (0x54E, 'M', u'վ'),
    (0x54F, 'M', u'տ'),
    (0x550, 'M', u'ր'),
    (0x551, 'M', u'ց'),
    (0x552, 'M', u'ւ'),
    (0x553, 'M', u'փ'),
    (0x554, 'M', u'ք'),
    (0x555, 'M', u'օ'),
    (0x556, 'M', u'ֆ'),
    (0x557, 'X'),
    (0x559, 'V'),
    (0x587, 'M', u'եւ'),
    (0x588, 'V'),
    (0x58B, 'X'),
    (0x58D, 'V'),
    (0x590, 'X'),
    (0x591, 'V'),
    (0x5C8, 'X'),
    (0x5D0, 'V'),
    (0x5EB, 'X'),
    (0x5EF, 'V'),
    (0x5F5, 'X'),
    (0x606, 'V'),
    (0x61C, 'X'),
    (0x61E, 'V'),
    ]

def _seg_10():
    return [
    (0x675, 'M', u'اٴ'),
    (0x676, 'M', u'وٴ'),
    (0x677, 'M', u'ۇٴ'),
    (0x678, 'M', u'يٴ'),
    (0x679, 'V'),
    (0x6DD, 'X'),
    (0x6DE, 'V'),
    (0x70E, 'X'),
    (0x710, 'V'),
    (0x74B, 'X'),
    (0x74D, 'V'),
    (0x7B2, 'X'),
    (0x7C0, 'V'),
    (0x7FB, 'X'),
    (0x7FD, 'V'),
    (0x82E, 'X'),
    (0x830, 'V'),
    (0x83F, 'X'),
    (0x840, 'V'),
    (0x85C, 'X'),
    (0x85E, 'V'),
    (0x85F, 'X'),
    (0x860, 'V'),
    (0x86B, 'X'),
    (0x8A0, 'V'),
    (0x8B5, 'X'),
    (0x8B6, 'V'),
    (0x8BE, 'X'),
    (0x8D3, 'V'),
    (0x8E2, 'X'),
    (0x8E3, 'V'),
    (0x958, 'M', u'क़'),
    (0x959, 'M', u'ख़'),
    (0x95A, 'M', u'ग़'),
    (0x95B, 'M', u'ज़'),
    (0x95C, 'M', u'ड़'),
    (0x95D, 'M', u'ढ़'),
    (0x95E, 'M', u'फ़'),
    (0x95F, 'M', u'य़'),
    (0x960, 'V'),
    (0x984, 'X'),
    (0x985, 'V'),
    (0x98D, 'X'),
    (0x98F, 'V'),
    (0x991, 'X'),
    (0x993, 'V'),
    (0x9A9, 'X'),
    (0x9AA, 'V'),
    (0x9B1, 'X'),
    (0x9B2, 'V'),
    (0x9B3, 'X'),
    (0x9B6, 'V'),
    (0x9BA, 'X'),
    (0x9BC, 'V'),
    (0x9C5, 'X'),
    (0x9C7, 'V'),
    (0x9C9, 'X'),
    (0x9CB, 'V'),
    (0x9CF, 'X'),
    (0x9D7, 'V'),
    (0x9D8, 'X'),
    (0x9DC, 'M', u'ড়'),
    (0x9DD, 'M', u'ঢ়'),
    (0x9DE, 'X'),
    (0x9DF, 'M', u'য়'),
    (0x9E0, 'V'),
    (0x9E4, 'X'),
    (0x9E6, 'V'),
    (0x9FF, 'X'),
    (0xA01, 'V'),
    (0xA04, 'X'),
    (0xA05, 'V'),
    (0xA0B, 'X'),
    (0xA0F, 'V'),
    (0xA11, 'X'),
    (0xA13, 'V'),
    (0xA29, 'X'),
    (0xA2A, 'V'),
    (0xA31, 'X'),
    (0xA32, 'V'),
    (0xA33, 'M', u'ਲ਼'),
    (0xA34, 'X'),
    (0xA35, 'V'),
    (0xA36, 'M', u'ਸ਼'),
    (0xA37, 'X'),
    (0xA38, 'V'),
    (0xA3A, 'X'),
    (0xA3C, 'V'),
    (0xA3D, 'X'),
    (0xA3E, 'V'),
    (0xA43, 'X'),
    (0xA47, 'V'),
    (0xA49, 'X'),
    (0xA4B, 'V'),
    (0xA4E, 'X'),
    (0xA51, 'V'),
    (0xA52, 'X'),
    (0xA59, 'M', u'ਖ਼'),
    (0xA5A, 'M', u'ਗ਼'),
    (0xA5B, 'M', u'ਜ਼'),
    ]

def _seg_11():
    return [
    (0xA5C, 'V'),
    (0xA5D, 'X'),
    (0xA5E, 'M', u'ਫ਼'),
    (0xA5F, 'X'),
    (0xA66, 'V'),
    (0xA77, 'X'),
    (0xA81, 'V'),
    (0xA84, 'X'),
    (0xA85, 'V'),
    (0xA8E, 'X'),
    (0xA8F, 'V'),
    (0xA92, 'X'),
    (0xA93, 'V'),
    (0xAA9, 'X'),
    (0xAAA, 'V'),
    (0xAB1, 'X'),
    (0xAB2, 'V'),
    (0xAB4, 'X'),
    (0xAB5, 'V'),
    (0xABA, 'X'),
    (0xABC, 'V'),
    (0xAC6, 'X'),
    (0xAC7, 'V'),
    (0xACA, 'X'),
    (0xACB, 'V'),
    (0xACE, 'X'),
    (0xAD0, 'V'),
    (0xAD1, 'X'),
    (0xAE0, 'V'),
    (0xAE4, 'X'),
    (0xAE6, 'V'),
    (0xAF2, 'X'),
    (0xAF9, 'V'),
    (0xB00, 'X'),
    (0xB01, 'V'),
    (0xB04, 'X'),
    (0xB05, 'V'),
    (0xB0D, 'X'),
    (0xB0F, 'V'),
    (0xB11, 'X'),
    (0xB13, 'V'),
    (0xB29, 'X'),
    (0xB2A, 'V'),
    (0xB31, 'X'),
    (0xB32, 'V'),
    (0xB34, 'X'),
    (0xB35, 'V'),
    (0xB3A, 'X'),
    (0xB3C, 'V'),
    (0xB45, 'X'),
    (0xB47, 'V'),
    (0xB49, 'X'),
    (0xB4B, 'V'),
    (0xB4E, 'X'),
    (0xB56, 'V'),
    (0xB58, 'X'),
    (0xB5C, 'M', u'ଡ଼'),
    (0xB5D, 'M', u'ଢ଼'),
    (0xB5E, 'X'),
    (0xB5F, 'V'),
    (0xB64, 'X'),
    (0xB66, 'V'),
    (0xB78, 'X'),
    (0xB82, 'V'),
    (0xB84, 'X'),
    (0xB85, 'V'),
    (0xB8B, 'X'),
    (0xB8E, 'V'),
    (0xB91, 'X'),
    (0xB92, 'V'),
    (0xB96, 'X'),
    (0xB99, 'V'),
    (0xB9B, 'X'),
    (0xB9C, 'V'),
    (0xB9D, 'X'),
    (0xB9E, 'V'),
    (0xBA0, 'X'),
    (0xBA3, 'V'),
    (0xBA5, 'X'),
    (0xBA8, 'V'),
    (0xBAB, 'X'),
    (0xBAE, 'V'),
    (0xBBA, 'X'),
    (0xBBE, 'V'),
    (0xBC3, 'X'),
    (0xBC6, 'V'),
    (0xBC9, 'X'),
    (0xBCA, 'V'),
    (0xBCE, 'X'),
    (0xBD0, 'V'),
    (0xBD1, 'X'),
    (0xBD7, 'V'),
    (0xBD8, 'X'),
    (0xBE6, 'V'),
    (0xBFB, 'X'),
    (0xC00, 'V'),
    (0xC0D, 'X'),
    (0xC0E, 'V'),
    (0xC11, 'X'),
    (0xC12, 'V'),
    ]

def _seg_12():
    return [
    (0xC29, 'X'),
    (0xC2A, 'V'),
    (0xC3A, 'X'),
    (0xC3D, 'V'),
    (0xC45, 'X'),
    (0xC46, 'V'),
    (0xC49, 'X'),
    (0xC4A, 'V'),
    (0xC4E, 'X'),
    (0xC55, 'V'),
    (0xC57, 'X'),
    (0xC58, 'V'),
    (0xC5B, 'X'),
    (0xC60, 'V'),
    (0xC64, 'X'),
    (0xC66, 'V'),
    (0xC70, 'X'),
    (0xC78, 'V'),
    (0xC8D, 'X'),
    (0xC8E, 'V'),
    (0xC91, 'X'),
    (0xC92, 'V'),
    (0xCA9, 'X'),
    (0xCAA, 'V'),
    (0xCB4, 'X'),
    (0xCB5, 'V'),
    (0xCBA, 'X'),
    (0xCBC, 'V'),
    (0xCC5, 'X'),
    (0xCC6, 'V'),
    (0xCC9, 'X'),
    (0xCCA, 'V'),
    (0xCCE, 'X'),
    (0xCD5, 'V'),
    (0xCD7, 'X'),
    (0xCDE, 'V'),
    (0xCDF, 'X'),
    (0xCE0, 'V'),
    (0xCE4, 'X'),
    (0xCE6, 'V'),
    (0xCF0, 'X'),
    (0xCF1, 'V'),
    (0xCF3, 'X'),
    (0xD00, 'V'),
    (0xD04, 'X'),
    (0xD05, 'V'),
    (0xD0D, 'X'),
    (0xD0E, 'V'),
    (0xD11, 'X'),
    (0xD12, 'V'),
    (0xD45, 'X'),
    (0xD46, 'V'),
    (0xD49, 'X'),
    (0xD4A, 'V'),
    (0xD50, 'X'),
    (0xD54, 'V'),
    (0xD64, 'X'),
    (0xD66, 'V'),
    (0xD80, 'X'),
    (0xD82, 'V'),
    (0xD84, 'X'),
    (0xD85, 'V'),
    (0xD97, 'X'),
    (0xD9A, 'V'),
    (0xDB2, 'X'),
    (0xDB3, 'V'),
    (0xDBC, 'X'),
    (0xDBD, 'V'),
    (0xDBE, 'X'),
    (0xDC0, 'V'),
    (0xDC7, 'X'),
    (0xDCA, 'V'),
    (0xDCB, 'X'),
    (0xDCF, 'V'),
    (0xDD5, 'X'),
    (0xDD6, 'V'),
    (0xDD7, 'X'),
    (0xDD8, 'V'),
    (0xDE0, 'X'),
    (0xDE6, 'V'),
    (0xDF0, 'X'),
    (0xDF2, 'V'),
    (0xDF5, 'X'),
    (0xE01, 'V'),
    (0xE33, 'M', u'ํา'),
    (0xE34, 'V'),
    (0xE3B, 'X'),
    (0xE3F, 'V'),
    (0xE5C, 'X'),
    (0xE81, 'V'),
    (0xE83, 'X'),
    (0xE84, 'V'),
    (0xE85, 'X'),
    (0xE87, 'V'),
    (0xE89, 'X'),
    (0xE8A, 'V'),
    (0xE8B, 'X'),
    (0xE8D, 'V'),
    (0xE8E, 'X'),
    (0xE94, 'V'),
    ]

def _seg_13():
    return [
    (0xE98, 'X'),
    (0xE99, 'V'),
    (0xEA0, 'X'),
    (0xEA1, 'V'),
    (0xEA4, 'X'),
    (0xEA5, 'V'),
    (0xEA6, 'X'),
    (0xEA7, 'V'),
    (0xEA8, 'X'),
    (0xEAA, 'V'),
    (0xEAC, 'X'),
    (0xEAD, 'V'),
    (0xEB3, 'M', u'ໍາ'),
    (0xEB4, 'V'),
    (0xEBA, 'X'),
    (0xEBB, 'V'),
    (0xEBE, 'X'),
    (0xEC0, 'V'),
    (0xEC5, 'X'),
    (0xEC6, 'V'),
    (0xEC7, 'X'),
    (0xEC8, 'V'),
    (0xECE, 'X'),
    (0xED0, 'V'),
    (0xEDA, 'X'),
    (0xEDC, 'M', u'ຫນ'),
    (0xEDD, 'M', u'ຫມ'),
    (0xEDE, 'V'),
    (0xEE0, 'X'),
    (0xF00, 'V'),
    (0xF0C, 'M', u'་'),
    (0xF0D, 'V'),
    (0xF43, 'M', u'གྷ'),
    (0xF44, 'V'),
    (0xF48, 'X'),
    (0xF49, 'V'),
    (0xF4D, 'M', u'ཌྷ'),
    (0xF4E, 'V'),
    (0xF52, 'M', u'དྷ'),
    (0xF53, 'V'),
    (0xF57, 'M', u'བྷ'),
    (0xF58, 'V'),
    (0xF5C, 'M', u'ཛྷ'),
    (0xF5D, 'V'),
    (0xF69, 'M', u'ཀྵ'),
    (0xF6A, 'V'),
    (0xF6D, 'X'),
    (0xF71, 'V'),
    (0xF73, 'M', u'ཱི'),
    (0xF74, 'V'),
    (0xF75, 'M', u'ཱུ'),
    (0xF76, 'M', u'ྲྀ'),
    (0xF77, 'M', u'ྲཱྀ'),
    (0xF78, 'M', u'ླྀ'),
    (0xF79, 'M', u'ླཱྀ'),
    (0xF7A, 'V'),
    (0xF81, 'M', u'ཱྀ'),
    (0xF82, 'V'),
    (0xF93, 'M', u'ྒྷ'),
    (0xF94, 'V'),
    (0xF98, 'X'),
    (0xF99, 'V'),
    (0xF9D, 'M', u'ྜྷ'),
    (0xF9E, 'V'),
    (0xFA2, 'M', u'ྡྷ'),
    (0xFA3, 'V'),
    (0xFA7, 'M', u'ྦྷ'),
    (0xFA8, 'V'),
    (0xFAC, 'M', u'ྫྷ'),
    (0xFAD, 'V'),
    (0xFB9, 'M', u'ྐྵ'),
    (0xFBA, 'V'),
    (0xFBD, 'X'),
    (0xFBE, 'V'),
    (0xFCD, 'X'),
    (0xFCE, 'V'),
    (0xFDB, 'X'),
    (0x1000, 'V'),
    (0x10A0, 'X'),
    (0x10C7, 'M', u'ⴧ'),
    (0x10C8, 'X'),
    (0x10CD, 'M', u'ⴭ'),
    (0x10CE, 'X'),
    (0x10D0, 'V'),
    (0x10FC, 'M', u'ნ'),
    (0x10FD, 'V'),
    (0x115F, 'X'),
    (0x1161, 'V'),
    (0x1249, 'X'),
    (0x124A, 'V'),
    (0x124E, 'X'),
    (0x1250, 'V'),
    (0x1257, 'X'),
    (0x1258, 'V'),
    (0x1259, 'X'),
    (0x125A, 'V'),
    (0x125E, 'X'),
    (0x1260, 'V'),
    (0x1289, 'X'),
    (0x128A, 'V'),
    ]

def _seg_14():
    return [
    (0x128E, 'X'),
    (0x1290, 'V'),
    (0x12B1, 'X'),
    (0x12B2, 'V'),
    (0x12B6, 'X'),
    (0x12B8, 'V'),
    (0x12BF, 'X'),
    (0x12C0, 'V'),
    (0x12C1, 'X'),
    (0x12C2, 'V'),
    (0x12C6, 'X'),
    (0x12C8, 'V'),
    (0x12D7, 'X'),
    (0x12D8, 'V'),
    (0x1311, 'X'),
    (0x1312, 'V'),
    (0x1316, 'X'),
    (0x1318, 'V'),
    (0x135B, 'X'),
    (0x135D, 'V'),
    (0x137D, 'X'),
    (0x1380, 'V'),
    (0x139A, 'X'),
    (0x13A0, 'V'),
    (0x13F6, 'X'),
    (0x13F8, 'M', u'Ᏸ'),
    (0x13F9, 'M', u'Ᏹ'),
    (0x13FA, 'M', u'Ᏺ'),
    (0x13FB, 'M', u'Ᏻ'),
    (0x13FC, 'M', u'Ᏼ'),
    (0x13FD, 'M', u'Ᏽ'),
    (0x13FE, 'X'),
    (0x1400, 'V'),
    (0x1680, 'X'),
    (0x1681, 'V'),
    (0x169D, 'X'),
    (0x16A0, 'V'),
    (0x16F9, 'X'),
    (0x1700, 'V'),
    (0x170D, 'X'),
    (0x170E, 'V'),
    (0x1715, 'X'),
    (0x1720, 'V'),
    (0x1737, 'X'),
    (0x1740, 'V'),
    (0x1754, 'X'),
    (0x1760, 'V'),
    (0x176D, 'X'),
    (0x176E, 'V'),
    (0x1771, 'X'),
    (0x1772, 'V'),
    (0x1774, 'X'),
    (0x1780, 'V'),
    (0x17B4, 'X'),
    (0x17B6, 'V'),
    (0x17DE, 'X'),
    (0x17E0, 'V'),
    (0x17EA, 'X'),
    (0x17F0, 'V'),
    (0x17FA, 'X'),
    (0x1800, 'V'),
    (0x1806, 'X'),
    (0x1807, 'V'),
    (0x180B, 'I'),
    (0x180E, 'X'),
    (0x1810, 'V'),
    (0x181A, 'X'),
    (0x1820, 'V'),
    (0x1879, 'X'),
    (0x1880, 'V'),
    (0x18AB, 'X'),
    (0x18B0, 'V'),
    (0x18F6, 'X'),
    (0x1900, 'V'),
    (0x191F, 'X'),
    (0x1920, 'V'),
    (0x192C, 'X'),
    (0x1930, 'V'),
    (0x193C, 'X'),
    (0x1940, 'V'),
    (0x1941, 'X'),
    (0x1944, 'V'),
    (0x196E, 'X'),
    (0x1970, 'V'),
    (0x1975, 'X'),
    (0x1980, 'V'),
    (0x19AC, 'X'),
    (0x19B0, 'V'),
    (0x19CA, 'X'),
    (0x19D0, 'V'),
    (0x19DB, 'X'),
    (0x19DE, 'V'),
    (0x1A1C, 'X'),
    (0x1A1E, 'V'),
    (0x1A5F, 'X'),
    (0x1A60, 'V'),
    (0x1A7D, 'X'),
    (0x1A7F, 'V'),
    (0x1A8A, 'X'),
    (0x1A90, 'V'),
    ]

def _seg_15():
    return [
    (0x1A9A, 'X'),
    (0x1AA0, 'V'),
    (0x1AAE, 'X'),
    (0x1AB0, 'V'),
    (0x1ABF, 'X'),
    (0x1B00, 'V'),
    (0x1B4C, 'X'),
    (0x1B50, 'V'),
    (0x1B7D, 'X'),
    (0x1B80, 'V'),
    (0x1BF4, 'X'),
    (0x1BFC, 'V'),
    (0x1C38, 'X'),
    (0x1C3B, 'V'),
    (0x1C4A, 'X'),
    (0x1C4D, 'V'),
    (0x1C80, 'M', u'в'),
    (0x1C81, 'M', u'д'),
    (0x1C82, 'M', u'о'),
    (0x1C83, 'M', u'с'),
    (0x1C84, 'M', u'т'),
    (0x1C86, 'M', u'ъ'),
    (0x1C87, 'M', u'ѣ'),
    (0x1C88, 'M', u'ꙋ'),
    (0x1C89, 'X'),
    (0x1CC0, 'V'),
    (0x1CC8, 'X'),
    (0x1CD0, 'V'),
    (0x1CFA, 'X'),
    (0x1D00, 'V'),
    (0x1D2C, 'M', u'a'),
    (0x1D2D, 'M', u'æ'),
    (0x1D2E, 'M', u'b'),
    (0x1D2F, 'V'),
    (0x1D30, 'M', u'd'),
    (0x1D31, 'M', u'e'),
    (0x1D32, 'M', u'ǝ'),
    (0x1D33, 'M', u'g'),
    (0x1D34, 'M', u'h'),
    (0x1D35, 'M', u'i'),
    (0x1D36, 'M', u'j'),
    (0x1D37, 'M', u'k'),
    (0x1D38, 'M', u'l'),
    (0x1D39, 'M', u'm'),
    (0x1D3A, 'M', u'n'),
    (0x1D3B, 'V'),
    (0x1D3C, 'M', u'o'),
    (0x1D3D, 'M', u'ȣ'),
    (0x1D3E, 'M', u'p'),
    (0x1D3F, 'M', u'r'),
    (0x1D40, 'M', u't'),
    (0x1D41, 'M', u'u'),
    (0x1D42, 'M', u'w'),
    (0x1D43, 'M', u'a'),
    (0x1D44, 'M', u'ɐ'),
    (0x1D45, 'M', u'ɑ'),
    (0x1D46, 'M', u'ᴂ'),
    (0x1D47, 'M', u'b'),
    (0x1D48, 'M', u'd'),
    (0x1D49, 'M', u'e'),
    (0x1D4A, 'M', u'ə'),
    (0x1D4B, 'M', u'ɛ'),
    (0x1D4C, 'M', u'ɜ'),
    (0x1D4D, 'M', u'g'),
    (0x1D4E, 'V'),
    (0x1D4F, 'M', u'k'),
    (0x1D50, 'M', u'm'),
    (0x1D51, 'M', u'ŋ'),
    (0x1D52, 'M', u'o'),
    (0x1D53, 'M', u'ɔ'),
    (0x1D54, 'M', u'ᴖ'),
    (0x1D55, 'M', u'ᴗ'),
    (0x1D56, 'M', u'p'),
    (0x1D57, 'M', u't'),
    (0x1D58, 'M', u'u'),
    (0x1D59, 'M', u'ᴝ'),
    (0x1D5A, 'M', u'ɯ'),
    (0x1D5B, 'M', u'v'),
    (0x1D5C, 'M', u'ᴥ'),
    (0x1D5D, 'M', u'β'),
    (0x1D5E, 'M', u'γ'),
    (0x1D5F, 'M', u'δ'),
    (0x1D60, 'M', u'φ'),
    (0x1D61, 'M', u'χ'),
    (0x1D62, 'M', u'i'),
    (0x1D63, 'M', u'r'),
    (0x1D64, 'M', u'u'),
    (0x1D65, 'M', u'v'),
    (0x1D66, 'M', u'β'),
    (0x1D67, 'M', u'γ'),
    (0x1D68, 'M', u'ρ'),
    (0x1D69, 'M', u'φ'),
    (0x1D6A, 'M', u'χ'),
    (0x1D6B, 'V'),
    (0x1D78, 'M', u'н'),
    (0x1D79, 'V'),
    (0x1D9B, 'M', u'ɒ'),
    (0x1D9C, 'M', u'c'),
    (0x1D9D, 'M', u'ɕ'),
    (0x1D9E, 'M', u'ð'),
    ]

def _seg_16():
    return [
    (0x1D9F, 'M', u'ɜ'),
    (0x1DA0, 'M', u'f'),
    (0x1DA1, 'M', u'ɟ'),
    (0x1DA2, 'M', u'ɡ'),
    (0x1DA3, 'M', u'ɥ'),
    (0x1DA4, 'M', u'ɨ'),
    (0x1DA5, 'M', u'ɩ'),
    (0x1DA6, 'M', u'ɪ'),
    (0x1DA7, 'M', u'ᵻ'),
    (0x1DA8, 'M', u'ʝ'),
    (0x1DA9, 'M', u'ɭ'),
    (0x1DAA, 'M', u'ᶅ'),
    (0x1DAB, 'M', u'ʟ'),
    (0x1DAC, 'M', u'ɱ'),
    (0x1DAD, 'M', u'ɰ'),
    (0x1DAE, 'M', u'ɲ'),
    (0x1DAF, 'M', u'ɳ'),
    (0x1DB0, 'M', u'ɴ'),
    (0x1DB1, 'M', u'ɵ'),
    (0x1DB2, 'M', u'ɸ'),
    (0x1DB3, 'M', u'ʂ'),
    (0x1DB4, 'M', u'ʃ'),
    (0x1DB5, 'M', u'ƫ'),
    (0x1DB6, 'M', u'ʉ'),
    (0x1DB7, 'M', u'ʊ'),
    (0x1DB8, 'M', u'ᴜ'),
    (0x1DB9, 'M', u'ʋ'),
    (0x1DBA, 'M', u'ʌ'),
    (0x1DBB, 'M', u'z'),
    (0x1DBC, 'M', u'ʐ'),
    (0x1DBD, 'M', u'ʑ'),
    (0x1DBE, 'M', u'ʒ'),
    (0x1DBF, 'M', u'θ'),
    (0x1DC0, 'V'),
    (0x1DFA, 'X'),
    (0x1DFB, 'V'),
    (0x1E00, 'M', u'ḁ'),
    (0x1E01, 'V'),
    (0x1E02, 'M', u'ḃ'),
    (0x1E03, 'V'),
    (0x1E04, 'M', u'ḅ'),
    (0x1E05, 'V'),
    (0x1E06, 'M', u'ḇ'),
    (0x1E07, 'V'),
    (0x1E08, 'M', u'ḉ'),
    (0x1E09, 'V'),
    (0x1E0A, 'M', u'ḋ'),
    (0x1E0B, 'V'),
    (0x1E0C, 'M', u'ḍ'),
    (0x1E0D, 'V'),
    (0x1E0E, 'M', u'ḏ'),
    (0x1E0F, 'V'),
    (0x1E10, 'M', u'ḑ'),
    (0x1E11, 'V'),
    (0x1E12, 'M', u'ḓ'),
    (0x1E13, 'V'),
    (0x1E14, 'M', u'ḕ'),
    (0x1E15, 'V'),
    (0x1E16, 'M', u'ḗ'),
    (0x1E17, 'V'),
    (0x1E18, 'M', u'ḙ'),
    (0x1E19, 'V'),
    (0x1E1A, 'M', u'ḛ'),
    (0x1E1B, 'V'),
    (0x1E1C, 'M', u'ḝ'),
    (0x1E1D, 'V'),
    (0x1E1E, 'M', u'ḟ'),
    (0x1E1F, 'V'),
    (0x1E20, 'M', u'ḡ'),
    (0x1E21, 'V'),
    (0x1E22, 'M', u'ḣ'),
    (0x1E23, 'V'),
    (0x1E24, 'M', u'ḥ'),
    (0x1E25, 'V'),
    (0x1E26, 'M', u'ḧ'),
    (0x1E27, 'V'),
    (0x1E28, 'M', u'ḩ'),
    (0x1E29, 'V'),
    (0x1E2A, 'M', u'ḫ'),
    (0x1E2B, 'V'),
    (0x1E2C, 'M', u'ḭ'),
    (0x1E2D, 'V'),
    (0x1E2E, 'M', u'ḯ'),
    (0x1E2F, 'V'),
    (0x1E30, 'M', u'ḱ'),
    (0x1E31, 'V'),
    (0x1E32, 'M', u'ḳ'),
    (0x1E33, 'V'),
    (0x1E34, 'M', u'ḵ'),
    (0x1E35, 'V'),
    (0x1E36, 'M', u'ḷ'),
    (0x1E37, 'V'),
    (0x1E38, 'M', u'ḹ'),
    (0x1E39, 'V'),
    (0x1E3A, 'M', u'ḻ'),
    (0x1E3B, 'V'),
    (0x1E3C, 'M', u'ḽ'),
    (0x1E3D, 'V'),
    (0x1E3E, 'M', u'ḿ'),
    (0x1E3F, 'V'),
    ]

def _seg_17():
    return [
    (0x1E40, 'M', u'ṁ'),
    (0x1E41, 'V'),
    (0x1E42, 'M', u'ṃ'),
    (0x1E43, 'V'),
    (0x1E44, 'M', u'ṅ'),
    (0x1E45, 'V'),
    (0x1E46, 'M', u'ṇ'),
    (0x1E47, 'V'),
    (0x1E48, 'M', u'ṉ'),
    (0x1E49, 'V'),
    (0x1E4A, 'M', u'ṋ'),
    (0x1E4B, 'V'),
    (0x1E4C, 'M', u'ṍ'),
    (0x1E4D, 'V'),
    (0x1E4E, 'M', u'ṏ'),
    (0x1E4F, 'V'),
    (0x1E50, 'M', u'ṑ'),
    (0x1E51, 'V'),
    (0x1E52, 'M', u'ṓ'),
    (0x1E53, 'V'),
    (0x1E54, 'M', u'ṕ'),
    (0x1E55, 'V'),
    (0x1E56, 'M', u'ṗ'),
    (0x1E57, 'V'),
    (0x1E58, 'M', u'ṙ'),
    (0x1E59, 'V'),
    (0x1E5A, 'M', u'ṛ'),
    (0x1E5B, 'V'),
    (0x1E5C, 'M', u'ṝ'),
    (0x1E5D, 'V'),
    (0x1E5E, 'M', u'ṟ'),
    (0x1E5F, 'V'),
    (0x1E60, 'M', u'ṡ'),
    (0x1E61, 'V'),
    (0x1E62, 'M', u'ṣ'),
    (0x1E63, 'V'),
    (0x1E64, 'M', u'ṥ'),
    (0x1E65, 'V'),
    (0x1E66, 'M', u'ṧ'),
    (0x1E67, 'V'),
    (0x1E68, 'M', u'ṩ'),
    (0x1E69, 'V'),
    (0x1E6A, 'M', u'ṫ'),
    (0x1E6B, 'V'),
    (0x1E6C, 'M', u'ṭ'),
    (0x1E6D, 'V'),
    (0x1E6E, 'M', u'ṯ'),
    (0x1E6F, 'V'),
    (0x1E70, 'M', u'ṱ'),
    (0x1E71, 'V'),
    (0x1E72, 'M', u'ṳ'),
    (0x1E73, 'V'),
    (0x1E74, 'M', u'ṵ'),
    (0x1E75, 'V'),
    (0x1E76, 'M', u'ṷ'),
    (0x1E77, 'V'),
    (0x1E78, 'M', u'ṹ'),
    (0x1E79, 'V'),
    (0x1E7A, 'M', u'ṻ'),
    (0x1E7B, 'V'),
    (0x1E7C, 'M', u'ṽ'),
    (0x1E7D, 'V'),
    (0x1E7E, 'M', u'ṿ'),
    (0x1E7F, 'V'),
    (0x1E80, 'M', u'ẁ'),
    (0x1E81, 'V'),
    (0x1E82, 'M', u'ẃ'),
    (0x1E83, 'V'),
    (0x1E84, 'M', u'ẅ'),
    (0x1E85, 'V'),
    (0x1E86, 'M', u'ẇ'),
    (0x1E87, 'V'),
    (0x1E88, 'M', u'ẉ'),
    (0x1E89, 'V'),
    (0x1E8A, 'M', u'ẋ'),
    (0x1E8B, 'V'),
    (0x1E8C, 'M', u'ẍ'),
    (0x1E8D, 'V'),
    (0x1E8E, 'M', u'ẏ'),
    (0x1E8F, 'V'),
    (0x1E90, 'M', u'ẑ'),
    (0x1E91, 'V'),
    (0x1E92, 'M', u'ẓ'),
    (0x1E93, 'V'),
    (0x1E94, 'M', u'ẕ'),
    (0x1E95, 'V'),
    (0x1E9A, 'M', u'aʾ'),
    (0x1E9B, 'M', u'ṡ'),
    (0x1E9C, 'V'),
    (0x1E9E, 'M', u'ss'),
    (0x1E9F, 'V'),
    (0x1EA0, 'M', u'ạ'),
    (0x1EA1, 'V'),
    (0x1EA2, 'M', u'ả'),
    (0x1EA3, 'V'),
    (0x1EA4, 'M', u'ấ'),
    (0x1EA5, 'V'),
    (0x1EA6, 'M', u'ầ'),
    (0x1EA7, 'V'),
    (0x1EA8, 'M', u'ẩ'),
    ]

def _seg_18():
    return [
    (0x1EA9, 'V'),
    (0x1EAA, 'M', u'ẫ'),
    (0x1EAB, 'V'),
    (0x1EAC, 'M', u'ậ'),
    (0x1EAD, 'V'),
    (0x1EAE, 'M', u'ắ'),
    (0x1EAF, 'V'),
    (0x1EB0, 'M', u'ằ'),
    (0x1EB1, 'V'),
    (0x1EB2, 'M', u'ẳ'),
    (0x1EB3, 'V'),
    (0x1EB4, 'M', u'ẵ'),
    (0x1EB5, 'V'),
    (0x1EB6, 'M', u'ặ'),
    (0x1EB7, 'V'),
    (0x1EB8, 'M', u'ẹ'),
    (0x1EB9, 'V'),
    (0x1EBA, 'M', u'ẻ'),
    (0x1EBB, 'V'),
    (0x1EBC, 'M', u'ẽ'),
    (0x1EBD, 'V'),
    (0x1EBE, 'M', u'ế'),
    (0x1EBF, 'V'),
    (0x1EC0, 'M', u'ề'),
    (0x1EC1, 'V'),
    (0x1EC2, 'M', u'ể'),
    (0x1EC3, 'V'),
    (0x1EC4, 'M', u'ễ'),
    (0x1EC5, 'V'),
    (0x1EC6, 'M', u'ệ'),
    (0x1EC7, 'V'),
    (0x1EC8, 'M', u'ỉ'),
    (0x1EC9, 'V'),
    (0x1ECA, 'M', u'ị'),
    (0x1ECB, 'V'),
    (0x1ECC, 'M', u'ọ'),
    (0x1ECD, 'V'),
    (0x1ECE, 'M', u'ỏ'),
    (0x1ECF, 'V'),
    (0x1ED0, 'M', u'ố'),
    (0x1ED1, 'V'),
    (0x1ED2, 'M', u'ồ'),
    (0x1ED3, 'V'),
    (0x1ED4, 'M', u'ổ'),
    (0x1ED5, 'V'),
    (0x1ED6, 'M', u'ỗ'),
    (0x1ED7, 'V'),
    (0x1ED8, 'M', u'ộ'),
    (0x1ED9, 'V'),
    (0x1EDA, 'M', u'ớ'),
    (0x1EDB, 'V'),
    (0x1EDC, 'M', u'ờ'),
    (0x1EDD, 'V'),
    (0x1EDE, 'M', u'ở'),
    (0x1EDF, 'V'),
    (0x1EE0, 'M', u'ỡ'),
    (0x1EE1, 'V'),
    (0x1EE2, 'M', u'ợ'),
    (0x1EE3, 'V'),
    (0x1EE4, 'M', u'ụ'),
    (0x1EE5, 'V'),
    (0x1EE6, 'M', u'ủ'),
    (0x1EE7, 'V'),
    (0x1EE8, 'M', u'ứ'),
    (0x1EE9, 'V'),
    (0x1EEA, 'M', u'ừ'),
    (0x1EEB, 'V'),
    (0x1EEC, 'M', u'ử'),
    (0x1EED, 'V'),
    (0x1EEE, 'M', u'ữ'),
    (0x1EEF, 'V'),
    (0x1EF0, 'M', u'ự'),
    (0x1EF1, 'V'),
    (0x1EF2, 'M', u'ỳ'),
    (0x1EF3, 'V'),
    (0x1EF4, 'M', u'ỵ'),
    (0x1EF5, 'V'),
    (0x1EF6, 'M', u'ỷ'),
    (0x1EF7, 'V'),
    (0x1EF8, 'M', u'ỹ'),
    (0x1EF9, 'V'),
    (0x1EFA, 'M', u'ỻ'),
    (0x1EFB, 'V'),
    (0x1EFC, 'M', u'ỽ'),
    (0x1EFD, 'V'),
    (0x1EFE, 'M', u'ỿ'),
    (0x1EFF, 'V'),
    (0x1F08, 'M', u'ἀ'),
    (0x1F09, 'M', u'ἁ'),
    (0x1F0A, 'M', u'ἂ'),
    (0x1F0B, 'M', u'ἃ'),
    (0x1F0C, 'M', u'ἄ'),
    (0x1F0D, 'M', u'ἅ'),
    (0x1F0E, 'M', u'ἆ'),
    (0x1F0F, 'M', u'ἇ'),
    (0x1F10, 'V'),
    (0x1F16, 'X'),
    (0x1F18, 'M', u'ἐ'),
    (0x1F19, 'M', u'ἑ'),
    (0x1F1A, 'M', u'ἒ'),
    ]

def _seg_19():
    return [
    (0x1F1B, 'M', u'ἓ'),
    (0x1F1C, 'M', u'ἔ'),
    (0x1F1D, 'M', u'ἕ'),
    (0x1F1E, 'X'),
    (0x1F20, 'V'),
    (0x1F28, 'M', u'ἠ'),
    (0x1F29, 'M', u'ἡ'),
    (0x1F2A, 'M', u'ἢ'),
    (0x1F2B, 'M', u'ἣ'),
    (0x1F2C, 'M', u'ἤ'),
    (0x1F2D, 'M', u'ἥ'),
    (0x1F2E, 'M', u'ἦ'),
    (0x1F2F, 'M', u'ἧ'),
    (0x1F30, 'V'),
    (0x1F38, 'M', u'ἰ'),
    (0x1F39, 'M', u'ἱ'),
    (0x1F3A, 'M', u'ἲ'),
    (0x1F3B, 'M', u'ἳ'),
    (0x1F3C, 'M', u'ἴ'),
    (0x1F3D, 'M', u'ἵ'),
    (0x1F3E, 'M', u'ἶ'),
    (0x1F3F, 'M', u'ἷ'),
    (0x1F40, 'V'),
    (0x1F46, 'X'),
    (0x1F48, 'M', u'ὀ'),
    (0x1F49, 'M', u'ὁ'),
    (0x1F4A, 'M', u'ὂ'),
    (0x1F4B, 'M', u'ὃ'),
    (0x1F4C, 'M', u'ὄ'),
    (0x1F4D, 'M', u'ὅ'),
    (0x1F4E, 'X'),
    (0x1F50, 'V'),
    (0x1F58, 'X'),
    (0x1F59, 'M', u'ὑ'),
    (0x1F5A, 'X'),
    (0x1F5B, 'M', u'ὓ'),
    (0x1F5C, 'X'),
    (0x1F5D, 'M', u'ὕ'),
    (0x1F5E, 'X'),
    (0x1F5F, 'M', u'ὗ'),
    (0x1F60, 'V'),
    (0x1F68, 'M', u'ὠ'),
    (0x1F69, 'M', u'ὡ'),
    (0x1F6A, 'M', u'ὢ'),
    (0x1F6B, 'M', u'ὣ'),
    (0x1F6C, 'M', u'ὤ'),
    (0x1F6D, 'M', u'ὥ'),
    (0x1F6E, 'M', u'ὦ'),
    (0x1F6F, 'M', u'ὧ'),
    (0x1F70, 'V'),
    (0x1F71, 'M', u'ά'),
    (0x1F72, 'V'),
    (0x1F73, 'M', u'έ'),
    (0x1F74, 'V'),
    (0x1F75, 'M', u'ή'),
    (0x1F76, 'V'),
    (0x1F77, 'M', u'ί'),
    (0x1F78, 'V'),
    (0x1F79, 'M', u'ό'),
    (0x1F7A, 'V'),
    (0x1F7B, 'M', u'ύ'),
    (0x1F7C, 'V'),
    (0x1F7D, 'M', u'ώ'),
    (0x1F7E, 'X'),
    (0x1F80, 'M', u'ἀι'),
    (0x1F81, 'M', u'ἁι'),
    (0x1F82, 'M', u'ἂι'),
    (0x1F83, 'M', u'ἃι'),
    (0x1F84, 'M', u'ἄι'),
    (0x1F85, 'M', u'ἅι'),
    (0x1F86, 'M', u'ἆι'),
    (0x1F87, 'M', u'ἇι'),
    (0x1F88, 'M', u'ἀι'),
    (0x1F89, 'M', u'ἁι'),
    (0x1F8A, 'M', u'ἂι'),
    (0x1F8B, 'M', u'ἃι'),
    (0x1F8C, 'M', u'ἄι'),
    (0x1F8D, 'M', u'ἅι'),
    (0x1F8E, 'M', u'ἆι'),
    (0x1F8F, 'M', u'ἇι'),
    (0x1F90, 'M', u'ἠι'),
    (0x1F91, 'M', u'ἡι'),
    (0x1F92, 'M', u'ἢι'),
    (0x1F93, 'M', u'ἣι'),
    (0x1F94, 'M', u'ἤι'),
    (0x1F95, 'M', u'ἥι'),
    (0x1F96, 'M', u'ἦι'),
    (0x1F97, 'M', u'ἧι'),
    (0x1F98, 'M', u'ἠι'),
    (0x1F99, 'M', u'ἡι'),
    (0x1F9A, 'M', u'ἢι'),
    (0x1F9B, 'M', u'ἣι'),
    (0x1F9C, 'M', u'ἤι'),
    (0x1F9D, 'M', u'ἥι'),
    (0x1F9E, 'M', u'ἦι'),
    (0x1F9F, 'M', u'ἧι'),
    (0x1FA0, 'M', u'ὠι'),
    (0x1FA1, 'M', u'ὡι'),
    (0x1FA2, 'M', u'ὢι'),
    (0x1FA3, 'M', u'ὣι'),
    ]

def _seg_20():
    return [
    (0x1FA4, 'M', u'ὤι'),
    (0x1FA5, 'M', u'ὥι'),
    (0x1FA6, 'M', u'ὦι'),
    (0x1FA7, 'M', u'ὧι'),
    (0x1FA8, 'M', u'ὠι'),
    (0x1FA9, 'M', u'ὡι'),
    (0x1FAA, 'M', u'ὢι'),
    (0x1FAB, 'M', u'ὣι'),
    (0x1FAC, 'M', u'ὤι'),
    (0x1FAD, 'M', u'ὥι'),
    (0x1FAE, 'M', u'ὦι'),
    (0x1FAF, 'M', u'ὧι'),
    (0x1FB0, 'V'),
    (0x1FB2, 'M', u'ὰι'),
    (0x1FB3, 'M', u'αι'),
    (0x1FB4, 'M', u'άι'),
    (0x1FB5, 'X'),
    (0x1FB6, 'V'),
    (0x1FB7, 'M', u'ᾶι'),
    (0x1FB8, 'M', u'ᾰ'),
    (0x1FB9, 'M', u'ᾱ'),
    (0x1FBA, 'M', u'ὰ'),
    (0x1FBB, 'M', u'ά'),
    (0x1FBC, 'M', u'αι'),
    (0x1FBD, '3', u' ̓'),
    (0x1FBE, 'M', u'ι'),
    (0x1FBF, '3', u' ̓'),
    (0x1FC0, '3', u' ͂'),
    (0x1FC1, '3', u' ̈͂'),
    (0x1FC2, 'M', u'ὴι'),
    (0x1FC3, 'M', u'ηι'),
    (0x1FC4, 'M', u'ήι'),
    (0x1FC5, 'X'),
    (0x1FC6, 'V'),
    (0x1FC7, 'M', u'ῆι'),
    (0x1FC8, 'M', u'ὲ'),
    (0x1FC9, 'M', u'έ'),
    (0x1FCA, 'M', u'ὴ'),
    (0x1FCB, 'M', u'ή'),
    (0x1FCC, 'M', u'ηι'),
    (0x1FCD, '3', u' ̓̀'),
    (0x1FCE, '3', u' ̓́'),
    (0x1FCF, '3', u' ̓͂'),
    (0x1FD0, 'V'),
    (0x1FD3, 'M', u'ΐ'),
    (0x1FD4, 'X'),
    (0x1FD6, 'V'),
    (0x1FD8, 'M', u'ῐ'),
    (0x1FD9, 'M', u'ῑ'),
    (0x1FDA, 'M', u'ὶ'),
    (0x1FDB, 'M', u'ί'),
    (0x1FDC, 'X'),
    (0x1FDD, '3', u' ̔̀'),
    (0x1FDE, '3', u' ̔́'),
    (0x1FDF, '3', u' ̔͂'),
    (0x1FE0, 'V'),
    (0x1FE3, 'M', u'ΰ'),
    (0x1FE4, 'V'),
    (0x1FE8, 'M', u'ῠ'),
    (0x1FE9, 'M', u'ῡ'),
    (0x1FEA, 'M', u'ὺ'),
    (0x1FEB, 'M', u'ύ'),
    (0x1FEC, 'M', u'ῥ'),
    (0x1FED, '3', u' ̈̀'),
    (0x1FEE, '3', u' ̈́'),
    (0x1FEF, '3', u'`'),
    (0x1FF0, 'X'),
    (0x1FF2, 'M', u'ὼι'),
    (0x1FF3, 'M', u'ωι'),
    (0x1FF4, 'M', u'ώι'),
    (0x1FF5, 'X'),
    (0x1FF6, 'V'),
    (0x1FF7, 'M', u'ῶι'),
    (0x1FF8, 'M', u'ὸ'),
    (0x1FF9, 'M', u'ό'),
    (0x1FFA, 'M', u'ὼ'),
    (0x1FFB, 'M', u'ώ'),
    (0x1FFC, 'M', u'ωι'),
    (0x1FFD, '3', u' ́'),
    (0x1FFE, '3', u' ̔'),
    (0x1FFF, 'X'),
    (0x2000, '3', u' '),
    (0x200B, 'I'),
    (0x200C, 'D', u''),
    (0x200E, 'X'),
    (0x2010, 'V'),
    (0x2011, 'M', u'‐'),
    (0x2012, 'V'),
    (0x2017, '3', u' ̳'),
    (0x2018, 'V'),
    (0x2024, 'X'),
    (0x2027, 'V'),
    (0x2028, 'X'),
    (0x202F, '3', u' '),
    (0x2030, 'V'),
    (0x2033, 'M', u'′′'),
    (0x2034, 'M', u'′′′'),
    (0x2035, 'V'),
    (0x2036, 'M', u'‵‵'),
    (0x2037, 'M', u'‵‵‵'),
    ]

def _seg_21():
    return [
    (0x2038, 'V'),
    (0x203C, '3', u'!!'),
    (0x203D, 'V'),
    (0x203E, '3', u' ̅'),
    (0x203F, 'V'),
    (0x2047, '3', u'??'),
    (0x2048, '3', u'?!'),
    (0x2049, '3', u'!?'),
    (0x204A, 'V'),
    (0x2057, 'M', u'′′′′'),
    (0x2058, 'V'),
    (0x205F, '3', u' '),
    (0x2060, 'I'),
    (0x2061, 'X'),
    (0x2064, 'I'),
    (0x2065, 'X'),
    (0x2070, 'M', u'0'),
    (0x2071, 'M', u'i'),
    (0x2072, 'X'),
    (0x2074, 'M', u'4'),
    (0x2075, 'M', u'5'),
    (0x2076, 'M', u'6'),
    (0x2077, 'M', u'7'),
    (0x2078, 'M', u'8'),
    (0x2079, 'M', u'9'),
    (0x207A, '3', u'+'),
    (0x207B, 'M', u'−'),
    (0x207C, '3', u'='),
    (0x207D, '3', u'('),
    (0x207E, '3', u')'),
    (0x207F, 'M', u'n'),
    (0x2080, 'M', u'0'),
    (0x2081, 'M', u'1'),
    (0x2082, 'M', u'2'),
    (0x2083, 'M', u'3'),
    (0x2084, 'M', u'4'),
    (0x2085, 'M', u'5'),
    (0x2086, 'M', u'6'),
    (0x2087, 'M', u'7'),
    (0x2088, 'M', u'8'),
    (0x2089, 'M', u'9'),
    (0x208A, '3', u'+'),
    (0x208B, 'M', u'−'),
    (0x208C, '3', u'='),
    (0x208D, '3', u'('),
    (0x208E, '3', u')'),
    (0x208F, 'X'),
    (0x2090, 'M', u'a'),
    (0x2091, 'M', u'e'),
    (0x2092, 'M', u'o'),
    (0x2093, 'M', u'x'),
    (0x2094, 'M', u'ə'),
    (0x2095, 'M', u'h'),
    (0x2096, 'M', u'k'),
    (0x2097, 'M', u'l'),
    (0x2098, 'M', u'm'),
    (0x2099, 'M', u'n'),
    (0x209A, 'M', u'p'),
    (0x209B, 'M', u's'),
    (0x209C, 'M', u't'),
    (0x209D, 'X'),
    (0x20A0, 'V'),
    (0x20A8, 'M', u'rs'),
    (0x20A9, 'V'),
    (0x20C0, 'X'),
    (0x20D0, 'V'),
    (0x20F1, 'X'),
    (0x2100, '3', u'a/c'),
    (0x2101, '3', u'a/s'),
    (0x2102, 'M', u'c'),
    (0x2103, 'M', u'°c'),
    (0x2104, 'V'),
    (0x2105, '3', u'c/o'),
    (0x2106, '3', u'c/u'),
    (0x2107, 'M', u'ɛ'),
    (0x2108, 'V'),
    (0x2109, 'M', u'°f'),
    (0x210A, 'M', u'g'),
    (0x210B, 'M', u'h'),
    (0x210F, 'M', u'ħ'),
    (0x2110, 'M', u'i'),
    (0x2112, 'M', u'l'),
    (0x2114, 'V'),
    (0x2115, 'M', u'n'),
    (0x2116, 'M', u'no'),
    (0x2117, 'V'),
    (0x2119, 'M', u'p'),
    (0x211A, 'M', u'q'),
    (0x211B, 'M', u'r'),
    (0x211E, 'V'),
    (0x2120, 'M', u'sm'),
    (0x2121, 'M', u'tel'),
    (0x2122, 'M', u'tm'),
    (0x2123, 'V'),
    (0x2124, 'M', u'z'),
    (0x2125, 'V'),
    (0x2126, 'M', u'ω'),
    (0x2127, 'V'),
    (0x2128, 'M', u'z'),
    (0x2129, 'V'),
    ]

def _seg_22():
    return [
    (0x212A, 'M', u'k'),
    (0x212B, 'M', u'å'),
    (0x212C, 'M', u'b'),
    (0x212D, 'M', u'c'),
    (0x212E, 'V'),
    (0x212F, 'M', u'e'),
    (0x2131, 'M', u'f'),
    (0x2132, 'X'),
    (0x2133, 'M', u'm'),
    (0x2134, 'M', u'o'),
    (0x2135, 'M', u'א'),
    (0x2136, 'M', u'ב'),
    (0x2137, 'M', u'ג'),
    (0x2138, 'M', u'ד'),
    (0x2139, 'M', u'i'),
    (0x213A, 'V'),
    (0x213B, 'M', u'fax'),
    (0x213C, 'M', u'π'),
    (0x213D, 'M', u'γ'),
    (0x213F, 'M', u'π'),
    (0x2140, 'M', u'∑'),
    (0x2141, 'V'),
    (0x2145, 'M', u'd'),
    (0x2147, 'M', u'e'),
    (0x2148, 'M', u'i'),
    (0x2149, 'M', u'j'),
    (0x214A, 'V'),
    (0x2150, 'M', u'1⁄7'),
    (0x2151, 'M', u'1⁄9'),
    (0x2152, 'M', u'1⁄10'),
    (0x2153, 'M', u'1⁄3'),
    (0x2154, 'M', u'2⁄3'),
    (0x2155, 'M', u'1⁄5'),
    (0x2156, 'M', u'2⁄5'),
    (0x2157, 'M', u'3⁄5'),
    (0x2158, 'M', u'4⁄5'),
    (0x2159, 'M', u'1⁄6'),
    (0x215A, 'M', u'5⁄6'),
    (0x215B, 'M', u'1⁄8'),
    (0x215C, 'M', u'3⁄8'),
    (0x215D, 'M', u'5⁄8'),
    (0x215E, 'M', u'7⁄8'),
    (0x215F, 'M', u'1⁄'),
    (0x2160, 'M', u'i'),
    (0x2161, 'M', u'ii'),
    (0x2162, 'M', u'iii'),
    (0x2163, 'M', u'iv'),
    (0x2164, 'M', u'v'),
    (0x2165, 'M', u'vi'),
    (0x2166, 'M', u'vii'),
    (0x2167, 'M', u'viii'),
    (0x2168, 'M', u'ix'),
    (0x2169, 'M', u'x'),
    (0x216A, 'M', u'xi'),
    (0x216B, 'M', u'xii'),
    (0x216C, 'M', u'l'),
    (0x216D, 'M', u'c'),
    (0x216E, 'M', u'd'),
    (0x216F, 'M', u'm'),
    (0x2170, 'M', u'i'),
    (0x2171, 'M', u'ii'),
    (0x2172, 'M', u'iii'),
    (0x2173, 'M', u'iv'),
    (0x2174, 'M', u'v'),
    (0x2175, 'M', u'vi'),
    (0x2176, 'M', u'vii'),
    (0x2177, 'M', u'viii'),
    (0x2178, 'M', u'ix'),
    (0x2179, 'M', u'x'),
    (0x217A, 'M', u'xi'),
    (0x217B, 'M', u'xii'),
    (0x217C, 'M', u'l'),
    (0x217D, 'M', u'c'),
    (0x217E, 'M', u'd'),
    (0x217F, 'M', u'm'),
    (0x2180, 'V'),
    (0x2183, 'X'),
    (0x2184, 'V'),
    (0x2189, 'M', u'0⁄3'),
    (0x218A, 'V'),
    (0x218C, 'X'),
    (0x2190, 'V'),
    (0x222C, 'M', u'∫∫'),
    (0x222D, 'M', u'∫∫∫'),
    (0x222E, 'V'),
    (0x222F, 'M', u'∮∮'),
    (0x2230, 'M', u'∮∮∮'),
    (0x2231, 'V'),
    (0x2260, '3'),
    (0x2261, 'V'),
    (0x226E, '3'),
    (0x2270, 'V'),
    (0x2329, 'M', u'〈'),
    (0x232A, 'M', u'〉'),
    (0x232B, 'V'),
    (0x2427, 'X'),
    (0x2440, 'V'),
    (0x244B, 'X'),
    (0x2460, 'M', u'1'),
    (0x2461, 'M', u'2'),
    ]

def _seg_23():
    return [
    (0x2462, 'M', u'3'),
    (0x2463, 'M', u'4'),
    (0x2464, 'M', u'5'),
    (0x2465, 'M', u'6'),
    (0x2466, 'M', u'7'),
    (0x2467, 'M', u'8'),
    (0x2468, 'M', u'9'),
    (0x2469, 'M', u'10'),
    (0x246A, 'M', u'11'),
    (0x246B, 'M', u'12'),
    (0x246C, 'M', u'13'),
    (0x246D, 'M', u'14'),
    (0x246E, 'M', u'15'),
    (0x246F, 'M', u'16'),
    (0x2470, 'M', u'17'),
    (0x2471, 'M', u'18'),
    (0x2472, 'M', u'19'),
    (0x2473, 'M', u'20'),
    (0x2474, '3', u'(1)'),
    (0x2475, '3', u'(2)'),
    (0x2476, '3', u'(3)'),
    (0x2477, '3', u'(4)'),
    (0x2478, '3', u'(5)'),
    (0x2479, '3', u'(6)'),
    (0x247A, '3', u'(7)'),
    (0x247B, '3', u'(8)'),
    (0x247C, '3', u'(9)'),
    (0x247D, '3', u'(10)'),
    (0x247E, '3', u'(11)'),
    (0x247F, '3', u'(12)'),
    (0x2480, '3', u'(13)'),
    (0x2481, '3', u'(14)'),
    (0x2482, '3', u'(15)'),
    (0x2483, '3', u'(16)'),
    (0x2484, '3', u'(17)'),
    (0x2485, '3', u'(18)'),
    (0x2486, '3', u'(19)'),
    (0x2487, '3', u'(20)'),
    (0x2488, 'X'),
    (0x249C, '3', u'(a)'),
    (0x249D, '3', u'(b)'),
    (0x249E, '3', u'(c)'),
    (0x249F, '3', u'(d)'),
    (0x24A0, '3', u'(e)'),
    (0x24A1, '3', u'(f)'),
    (0x24A2, '3', u'(g)'),
    (0x24A3, '3', u'(h)'),
    (0x24A4, '3', u'(i)'),
    (0x24A5, '3', u'(j)'),
    (0x24A6, '3', u'(k)'),
    (0x24A7, '3', u'(l)'),
    (0x24A8, '3', u'(m)'),
    (0x24A9, '3', u'(n)'),
    (0x24AA, '3', u'(o)'),
    (0x24AB, '3', u'(p)'),
    (0x24AC, '3', u'(q)'),
    (0x24AD, '3', u'(r)'),
    (0x24AE, '3', u'(s)'),
    (0x24AF, '3', u'(t)'),
    (0x24B0, '3', u'(u)'),
    (0x24B1, '3', u'(v)'),
    (0x24B2, '3', u'(w)'),
    (0x24B3, '3', u'(x)'),
    (0x24B4, '3', u'(y)'),
    (0x24B5, '3', u'(z)'),
    (0x24B6, 'M', u'a'),
    (0x24B7, 'M', u'b'),
    (0x24B8, 'M', u'c'),
    (0x24B9, 'M', u'd'),
    (0x24BA, 'M', u'e'),
    (0x24BB, 'M', u'f'),
    (0x24BC, 'M', u'g'),
    (0x24BD, 'M', u'h'),
    (0x24BE, 'M', u'i'),
    (0x24BF, 'M', u'j'),
    (0x24C0, 'M', u'k'),
    (0x24C1, 'M', u'l'),
    (0x24C2, 'M', u'm'),
    (0x24C3, 'M', u'n'),
    (0x24C4, 'M', u'o'),
    (0x24C5, 'M', u'p'),
    (0x24C6, 'M', u'q'),
    (0x24C7, 'M', u'r'),
    (0x24C8, 'M', u's'),
    (0x24C9, 'M', u't'),
    (0x24CA, 'M', u'u'),
    (0x24CB, 'M', u'v'),
    (0x24CC, 'M', u'w'),
    (0x24CD, 'M', u'x'),
    (0x24CE, 'M', u'y'),
    (0x24CF, 'M', u'z'),
    (0x24D0, 'M', u'a'),
    (0x24D1, 'M', u'b'),
    (0x24D2, 'M', u'c'),
    (0x24D3, 'M', u'd'),
    (0x24D4, 'M', u'e'),
    (0x24D5, 'M', u'f'),
    (0x24D6, 'M', u'g'),
    (0x24D7, 'M', u'h'),
    (0x24D8, 'M', u'i'),
    ]

def _seg_24():
    return [
    (0x24D9, 'M', u'j'),
    (0x24DA, 'M', u'k'),
    (0x24DB, 'M', u'l'),
    (0x24DC, 'M', u'm'),
    (0x24DD, 'M', u'n'),
    (0x24DE, 'M', u'o'),
    (0x24DF, 'M', u'p'),
    (0x24E0, 'M', u'q'),
    (0x24E1, 'M', u'r'),
    (0x24E2, 'M', u's'),
    (0x24E3, 'M', u't'),
    (0x24E4, 'M', u'u'),
    (0x24E5, 'M', u'v'),
    (0x24E6, 'M', u'w'),
    (0x24E7, 'M', u'x'),
    (0x24E8, 'M', u'y'),
    (0x24E9, 'M', u'z'),
    (0x24EA, 'M', u'0'),
    (0x24EB, 'V'),
    (0x2A0C, 'M', u'∫∫∫∫'),
    (0x2A0D, 'V'),
    (0x2A74, '3', u'::='),
    (0x2A75, '3', u'=='),
    (0x2A76, '3', u'==='),
    (0x2A77, 'V'),
    (0x2ADC, 'M', u'⫝̸'),
    (0x2ADD, 'V'),
    (0x2B74, 'X'),
    (0x2B76, 'V'),
    (0x2B96, 'X'),
    (0x2B98, 'V'),
    (0x2BC9, 'X'),
    (0x2BCA, 'V'),
    (0x2BFF, 'X'),
    (0x2C00, 'M', u'ⰰ'),
    (0x2C01, 'M', u'ⰱ'),
    (0x2C02, 'M', u'ⰲ'),
    (0x2C03, 'M', u'ⰳ'),
    (0x2C04, 'M', u'ⰴ'),
    (0x2C05, 'M', u'ⰵ'),
    (0x2C06, 'M', u'ⰶ'),
    (0x2C07, 'M', u'ⰷ'),
    (0x2C08, 'M', u'ⰸ'),
    (0x2C09, 'M', u'ⰹ'),
    (0x2C0A, 'M', u'ⰺ'),
    (0x2C0B, 'M', u'ⰻ'),
    (0x2C0C, 'M', u'ⰼ'),
    (0x2C0D, 'M', u'ⰽ'),
    (0x2C0E, 'M', u'ⰾ'),
    (0x2C0F, 'M', u'ⰿ'),
    (0x2C10, 'M', u'ⱀ'),
    (0x2C11, 'M', u'ⱁ'),
    (0x2C12, 'M', u'ⱂ'),
    (0x2C13, 'M', u'ⱃ'),
    (0x2C14, 'M', u'ⱄ'),
    (0x2C15, 'M', u'ⱅ'),
    (0x2C16, 'M', u'ⱆ'),
    (0x2C17, 'M', u'ⱇ'),
    (0x2C18, 'M', u'ⱈ'),
    (0x2C19, 'M', u'ⱉ'),
    (0x2C1A, 'M', u'ⱊ'),
    (0x2C1B, 'M', u'ⱋ'),
    (0x2C1C, 'M', u'ⱌ'),
    (0x2C1D, 'M', u'ⱍ'),
    (0x2C1E, 'M', u'ⱎ'),
    (0x2C1F, 'M', u'ⱏ'),
    (0x2C20, 'M', u'ⱐ'),
    (0x2C21, 'M', u'ⱑ'),
    (0x2C22, 'M', u'ⱒ'),
    (0x2C23, 'M', u'ⱓ'),
    (0x2C24, 'M', u'ⱔ'),
    (0x2C25, 'M', u'ⱕ'),
    (0x2C26, 'M', u'ⱖ'),
    (0x2C27, 'M', u'ⱗ'),
    (0x2C28, 'M', u'ⱘ'),
    (0x2C29, 'M', u'ⱙ'),
    (0x2C2A, 'M', u'ⱚ'),
    (0x2C2B, 'M', u'ⱛ'),
    (0x2C2C, 'M', u'ⱜ'),
    (0x2C2D, 'M', u'ⱝ'),
    (0x2C2E, 'M', u'ⱞ'),
    (0x2C2F, 'X'),
    (0x2C30, 'V'),
    (0x2C5F, 'X'),
    (0x2C60, 'M', u'ⱡ'),
    (0x2C61, 'V'),
    (0x2C62, 'M', u'ɫ'),
    (0x2C63, 'M', u'ᵽ'),
    (0x2C64, 'M', u'ɽ'),
    (0x2C65, 'V'),
    (0x2C67, 'M', u'ⱨ'),
    (0x2C68, 'V'),
    (0x2C69, 'M', u'ⱪ'),
    (0x2C6A, 'V'),
    (0x2C6B, 'M', u'ⱬ'),
    (0x2C6C, 'V'),
    (0x2C6D, 'M', u'ɑ'),
    (0x2C6E, 'M', u'ɱ'),
    (0x2C6F, 'M', u'ɐ'),
    (0x2C70, 'M', u'ɒ'),
    ]

def _seg_25():
    return [
    (0x2C71, 'V'),
    (0x2C72, 'M', u'ⱳ'),
    (0x2C73, 'V'),
    (0x2C75, 'M', u'ⱶ'),
    (0x2C76, 'V'),
    (0x2C7C, 'M', u'j'),
    (0x2C7D, 'M', u'v'),
    (0x2C7E, 'M', u'ȿ'),
    (0x2C7F, 'M', u'ɀ'),
    (0x2C80, 'M', u'ⲁ'),
    (0x2C81, 'V'),
    (0x2C82, 'M', u'ⲃ'),
    (0x2C83, 'V'),
    (0x2C84, 'M', u'ⲅ'),
    (0x2C85, 'V'),
    (0x2C86, 'M', u'ⲇ'),
    (0x2C87, 'V'),
    (0x2C88, 'M', u'ⲉ'),
    (0x2C89, 'V'),
    (0x2C8A, 'M', u'ⲋ'),
    (0x2C8B, 'V'),
    (0x2C8C, 'M', u'ⲍ'),
    (0x2C8D, 'V'),
    (0x2C8E, 'M', u'ⲏ'),
    (0x2C8F, 'V'),
    (0x2C90, 'M', u'ⲑ'),
    (0x2C91, 'V'),
    (0x2C92, 'M', u'ⲓ'),
    (0x2C93, 'V'),
    (0x2C94, 'M', u'ⲕ'),
    (0x2C95, 'V'),
    (0x2C96, 'M', u'ⲗ'),
    (0x2C97, 'V'),
    (0x2C98, 'M', u'ⲙ'),
    (0x2C99, 'V'),
    (0x2C9A, 'M', u'ⲛ'),
    (0x2C9B, 'V'),
    (0x2C9C, 'M', u'ⲝ'),
    (0x2C9D, 'V'),
    (0x2C9E, 'M', u'ⲟ'),
    (0x2C9F, 'V'),
    (0x2CA0, 'M', u'ⲡ'),
    (0x2CA1, 'V'),
    (0x2CA2, 'M', u'ⲣ'),
    (0x2CA3, 'V'),
    (0x2CA4, 'M', u'ⲥ'),
    (0x2CA5, 'V'),
    (0x2CA6, 'M', u'ⲧ'),
    (0x2CA7, 'V'),
    (0x2CA8, 'M', u'ⲩ'),
    (0x2CA9, 'V'),
    (0x2CAA, 'M', u'ⲫ'),
    (0x2CAB, 'V'),
    (0x2CAC, 'M', u'ⲭ'),
    (0x2CAD, 'V'),
    (0x2CAE, 'M', u'ⲯ'),
    (0x2CAF, 'V'),
    (0x2CB0, 'M', u'ⲱ'),
    (0x2CB1, 'V'),
    (0x2CB2, 'M', u'ⲳ'),
    (0x2CB3, 'V'),
    (0x2CB4, 'M', u'ⲵ'),
    (0x2CB5, 'V'),
    (0x2CB6, 'M', u'ⲷ'),
    (0x2CB7, 'V'),
    (0x2CB8, 'M', u'ⲹ'),
    (0x2CB9, 'V'),
    (0x2CBA, 'M', u'ⲻ'),
    (0x2CBB, 'V'),
    (0x2CBC, 'M', u'ⲽ'),
    (0x2CBD, 'V'),
    (0x2CBE, 'M', u'ⲿ'),
    (0x2CBF, 'V'),
    (0x2CC0, 'M', u'ⳁ'),
    (0x2CC1, 'V'),
    (0x2CC2, 'M', u'ⳃ'),
    (0x2CC3, 'V'),
    (0x2CC4, 'M', u'ⳅ'),
    (0x2CC5, 'V'),
    (0x2CC6, 'M', u'ⳇ'),
    (0x2CC7, 'V'),
    (0x2CC8, 'M', u'ⳉ'),
    (0x2CC9, 'V'),
    (0x2CCA, 'M', u'ⳋ'),
    (0x2CCB, 'V'),
    (0x2CCC, 'M', u'ⳍ'),
    (0x2CCD, 'V'),
    (0x2CCE, 'M', u'ⳏ'),
    (0x2CCF, 'V'),
    (0x2CD0, 'M', u'ⳑ'),
    (0x2CD1, 'V'),
    (0x2CD2, 'M', u'ⳓ'),
    (0x2CD3, 'V'),
    (0x2CD4, 'M', u'ⳕ'),
    (0x2CD5, 'V'),
    (0x2CD6, 'M', u'ⳗ'),
    (0x2CD7, 'V'),
    (0x2CD8, 'M', u'ⳙ'),
    (0x2CD9, 'V'),
    (0x2CDA, 'M', u'ⳛ'),
    ]

def _seg_26():
    return [
    (0x2CDB, 'V'),
    (0x2CDC, 'M', u'ⳝ'),
    (0x2CDD, 'V'),
    (0x2CDE, 'M', u'ⳟ'),
    (0x2CDF, 'V'),
    (0x2CE0, 'M', u'ⳡ'),
    (0x2CE1, 'V'),
    (0x2CE2, 'M', u'ⳣ'),
    (0x2CE3, 'V'),
    (0x2CEB, 'M', u'ⳬ'),
    (0x2CEC, 'V'),
    (0x2CED, 'M', u'ⳮ'),
    (0x2CEE, 'V'),
    (0x2CF2, 'M', u'ⳳ'),
    (0x2CF3, 'V'),
    (0x2CF4, 'X'),
    (0x2CF9, 'V'),
    (0x2D26, 'X'),
    (0x2D27, 'V'),
    (0x2D28, 'X'),
    (0x2D2D, 'V'),
    (0x2D2E, 'X'),
    (0x2D30, 'V'),
    (0x2D68, 'X'),
    (0x2D6F, 'M', u'ⵡ'),
    (0x2D70, 'V'),
    (0x2D71, 'X'),
    (0x2D7F, 'V'),
    (0x2D97, 'X'),
    (0x2DA0, 'V'),
    (0x2DA7, 'X'),
    (0x2DA8, 'V'),
    (0x2DAF, 'X'),
    (0x2DB0, 'V'),
    (0x2DB7, 'X'),
    (0x2DB8, 'V'),
    (0x2DBF, 'X'),
    (0x2DC0, 'V'),
    (0x2DC7, 'X'),
    (0x2DC8, 'V'),
    (0x2DCF, 'X'),
    (0x2DD0, 'V'),
    (0x2DD7, 'X'),
    (0x2DD8, 'V'),
    (0x2DDF, 'X'),
    (0x2DE0, 'V'),
    (0x2E4F, 'X'),
    (0x2E80, 'V'),
    (0x2E9A, 'X'),
    (0x2E9B, 'V'),
    (0x2E9F, 'M', u'母'),
    (0x2EA0, 'V'),
    (0x2EF3, 'M', u'龟'),
    (0x2EF4, 'X'),
    (0x2F00, 'M', u'一'),
    (0x2F01, 'M', u'丨'),
    (0x2F02, 'M', u'丶'),
    (0x2F03, 'M', u'丿'),
    (0x2F04, 'M', u'乙'),
    (0x2F05, 'M', u'亅'),
    (0x2F06, 'M', u'二'),
    (0x2F07, 'M', u'亠'),
    (0x2F08, 'M', u'人'),
    (0x2F09, 'M', u'儿'),
    (0x2F0A, 'M', u'入'),
    (0x2F0B, 'M', u'八'),
    (0x2F0C, 'M', u'冂'),
    (0x2F0D, 'M', u'冖'),
    (0x2F0E, 'M', u'冫'),
    (0x2F0F, 'M', u'几'),
    (0x2F10, 'M', u'凵'),
    (0x2F11, 'M', u'刀'),
    (0x2F12, 'M', u'力'),
    (0x2F13, 'M', u'勹'),
    (0x2F14, 'M', u'匕'),
    (0x2F15, 'M', u'匚'),
    (0x2F16, 'M', u'匸'),
    (0x2F17, 'M', u'十'),
    (0x2F18, 'M', u'卜'),
    (0x2F19, 'M', u'卩'),
    (0x2F1A, 'M', u'厂'),
    (0x2F1B, 'M', u'厶'),
    (0x2F1C, 'M', u'又'),
    (0x2F1D, 'M', u'口'),
    (0x2F1E, 'M', u'囗'),
    (0x2F1F, 'M', u'土'),
    (0x2F20, 'M', u'士'),
    (0x2F21, 'M', u'夂'),
    (0x2F22, 'M', u'夊'),
    (0x2F23, 'M', u'夕'),
    (0x2F24, 'M', u'大'),
    (0x2F25, 'M', u'女'),
    (0x2F26, 'M', u'子'),
    (0x2F27, 'M', u'宀'),
    (0x2F28, 'M', u'寸'),
    (0x2F29, 'M', u'小'),
    (0x2F2A, 'M', u'尢'),
    (0x2F2B, 'M', u'尸'),
    (0x2F2C, 'M', u'屮'),
    (0x2F2D, 'M', u'山'),
    ]

def _seg_27():
    return [
    (0x2F2E, 'M', u'巛'),
    (0x2F2F, 'M', u'工'),
    (0x2F30, 'M', u'己'),
    (0x2F31, 'M', u'巾'),
    (0x2F32, 'M', u'干'),
    (0x2F33, 'M', u'幺'),
    (0x2F34, 'M', u'广'),
    (0x2F35, 'M', u'廴'),
    (0x2F36, 'M', u'廾'),
    (0x2F37, 'M', u'弋'),
    (0x2F38, 'M', u'弓'),
    (0x2F39, 'M', u'彐'),
    (0x2F3A, 'M', u'彡'),
    (0x2F3B, 'M', u'彳'),
    (0x2F3C, 'M', u'心'),
    (0x2F3D, 'M', u'戈'),
    (0x2F3E, 'M', u'戶'),
    (0x2F3F, 'M', u'手'),
    (0x2F40, 'M', u'支'),
    (0x2F41, 'M', u'攴'),
    (0x2F42, 'M', u'文'),
    (0x2F43, 'M', u'斗'),
    (0x2F44, 'M', u'斤'),
    (0x2F45, 'M', u'方'),
    (0x2F46, 'M', u'无'),
    (0x2F47, 'M', u'日'),
    (0x2F48, 'M', u'曰'),
    (0x2F49, 'M', u'月'),
    (0x2F4A, 'M', u'木'),
    (0x2F4B, 'M', u'欠'),
    (0x2F4C, 'M', u'止'),
    (0x2F4D, 'M', u'歹'),
    (0x2F4E, 'M', u'殳'),
    (0x2F4F, 'M', u'毋'),
    (0x2F50, 'M', u'比'),
    (0x2F51, 'M', u'毛'),
    (0x2F52, 'M', u'氏'),
    (0x2F53, 'M', u'气'),
    (0x2F54, 'M', u'水'),
    (0x2F55, 'M', u'火'),
    (0x2F56, 'M', u'爪'),
    (0x2F57, 'M', u'父'),
    (0x2F58, 'M', u'爻'),
    (0x2F59, 'M', u'爿'),
    (0x2F5A, 'M', u'片'),
    (0x2F5B, 'M', u'牙'),
    (0x2F5C, 'M', u'牛'),
    (0x2F5D, 'M', u'犬'),
    (0x2F5E, 'M', u'玄'),
    (0x2F5F, 'M', u'玉'),
    (0x2F60, 'M', u'瓜'),
    (0x2F61, 'M', u'瓦'),
    (0x2F62, 'M', u'甘'),
    (0x2F63, 'M', u'生'),
    (0x2F64, 'M', u'用'),
    (0x2F65, 'M', u'田'),
    (0x2F66, 'M', u'疋'),
    (0x2F67, 'M', u'疒'),
    (0x2F68, 'M', u'癶'),
    (0x2F69, 'M', u'白'),
    (0x2F6A, 'M', u'皮'),
    (0x2F6B, 'M', u'皿'),
    (0x2F6C, 'M', u'目'),
    (0x2F6D, 'M', u'矛'),
    (0x2F6E, 'M', u'矢'),
    (0x2F6F, 'M', u'石'),
    (0x2F70, 'M', u'示'),
    (0x2F71, 'M', u'禸'),
    (0x2F72, 'M', u'禾'),
    (0x2F73, 'M', u'穴'),
    (0x2F74, 'M', u'立'),
    (0x2F75, 'M', u'竹'),
    (0x2F76, 'M', u'米'),
    (0x2F77, 'M', u'糸'),
    (0x2F78, 'M', u'缶'),
    (0x2F79, 'M', u'网'),
    (0x2F7A, 'M', u'羊'),
    (0x2F7B, 'M', u'羽'),
    (0x2F7C, 'M', u'老'),
    (0x2F7D, 'M', u'而'),
    (0x2F7E, 'M', u'耒'),
    (0x2F7F, 'M', u'耳'),
    (0x2F80, 'M', u'聿'),
    (0x2F81, 'M', u'肉'),
    (0x2F82, 'M', u'臣'),
    (0x2F83, 'M', u'自'),
    (0x2F84, 'M', u'至'),
    (0x2F85, 'M', u'臼'),
    (0x2F86, 'M', u'舌'),
    (0x2F87, 'M', u'舛'),
    (0x2F88, 'M', u'舟'),
    (0x2F89, 'M', u'艮'),
    (0x2F8A, 'M', u'色'),
    (0x2F8B, 'M', u'艸'),
    (0x2F8C, 'M', u'虍'),
    (0x2F8D, 'M', u'虫'),
    (0x2F8E, 'M', u'血'),
    (0x2F8F, 'M', u'行'),
    (0x2F90, 'M', u'衣'),
    (0x2F91, 'M', u'襾'),
    ]

def _seg_28():
    return [
    (0x2F92, 'M', u'見'),
    (0x2F93, 'M', u'角'),
    (0x2F94, 'M', u'言'),
    (0x2F95, 'M', u'谷'),
    (0x2F96, 'M', u'豆'),
    (0x2F97, 'M', u'豕'),
    (0x2F98, 'M', u'豸'),
    (0x2F99, 'M', u'貝'),
    (0x2F9A, 'M', u'赤'),
    (0x2F9B, 'M', u'走'),
    (0x2F9C, 'M', u'足'),
    (0x2F9D, 'M', u'身'),
    (0x2F9E, 'M', u'車'),
    (0x2F9F, 'M', u'辛'),
    (0x2FA0, 'M', u'辰'),
    (0x2FA1, 'M', u'辵'),
    (0x2FA2, 'M', u'邑'),
    (0x2FA3, 'M', u'酉'),
    (0x2FA4, 'M', u'釆'),
    (0x2FA5, 'M', u'里'),
    (0x2FA6, 'M', u'金'),
    (0x2FA7, 'M', u'長'),
    (0x2FA8, 'M', u'門'),
    (0x2FA9, 'M', u'阜'),
    (0x2FAA, 'M', u'隶'),
    (0x2FAB, 'M', u'隹'),
    (0x2FAC, 'M', u'雨'),
    (0x2FAD, 'M', u'靑'),
    (0x2FAE, 'M', u'非'),
    (0x2FAF, 'M', u'面'),
    (0x2FB0, 'M', u'革'),
    (0x2FB1, 'M', u'韋'),
    (0x2FB2, 'M', u'韭'),
    (0x2FB3, 'M', u'音'),
    (0x2FB4, 'M', u'頁'),
    (0x2FB5, 'M', u'風'),
    (0x2FB6, 'M', u'飛'),
    (0x2FB7, 'M', u'食'),
    (0x2FB8, 'M', u'首'),
    (0x2FB9, 'M', u'香'),
    (0x2FBA, 'M', u'馬'),
    (0x2FBB, 'M', u'骨'),
    (0x2FBC, 'M', u'高'),
    (0x2FBD, 'M', u'髟'),
    (0x2FBE, 'M', u'鬥'),
    (0x2FBF, 'M', u'鬯'),
    (0x2FC0, 'M', u'鬲'),
    (0x2FC1, 'M', u'鬼'),
    (0x2FC2, 'M', u'魚'),
    (0x2FC3, 'M', u'鳥'),
    (0x2FC4, 'M', u'鹵'),
    (0x2FC5, 'M', u'鹿'),
    (0x2FC6, 'M', u'麥'),
    (0x2FC7, 'M', u'麻'),
    (0x2FC8, 'M', u'黃'),
    (0x2FC9, 'M', u'黍'),
    (0x2FCA, 'M', u'黑'),
    (0x2FCB, 'M', u'黹'),
    (0x2FCC, 'M', u'黽'),
    (0x2FCD, 'M', u'鼎'),
    (0x2FCE, 'M', u'鼓'),
    (0x2FCF, 'M', u'鼠'),
    (0x2FD0, 'M', u'鼻'),
    (0x2FD1, 'M', u'齊'),
    (0x2FD2, 'M', u'齒'),
    (0x2FD3, 'M', u'龍'),
    (0x2FD4, 'M', u'龜'),
    (0x2FD5, 'M', u'龠'),
    (0x2FD6, 'X'),
    (0x3000, '3', u' '),
    (0x3001, 'V'),
    (0x3002, 'M', u'.'),
    (0x3003, 'V'),
    (0x3036, 'M', u'〒'),
    (0x3037, 'V'),
    (0x3038, 'M', u'十'),
    (0x3039, 'M', u'卄'),
    (0x303A, 'M', u'卅'),
    (0x303B, 'V'),
    (0x3040, 'X'),
    (0x3041, 'V'),
    (0x3097, 'X'),
    (0x3099, 'V'),
    (0x309B, '3', u' ゙'),
    (0x309C, '3', u' ゚'),
    (0x309D, 'V'),
    (0x309F, 'M', u'より'),
    (0x30A0, 'V'),
    (0x30FF, 'M', u'コト'),
    (0x3100, 'X'),
    (0x3105, 'V'),
    (0x3130, 'X'),
    (0x3131, 'M', u'ᄀ'),
    (0x3132, 'M', u'ᄁ'),
    (0x3133, 'M', u'ᆪ'),
    (0x3134, 'M', u'ᄂ'),
    (0x3135, 'M', u'ᆬ'),
    (0x3136, 'M', u'ᆭ'),
    (0x3137, 'M', u'ᄃ'),
    (0x3138, 'M', u'ᄄ'),
    ]

def _seg_29():
    return [
    (0x3139, 'M', u'ᄅ'),
    (0x313A, 'M', u'ᆰ'),
    (0x313B, 'M', u'ᆱ'),
    (0x313C, 'M', u'ᆲ'),
    (0x313D, 'M', u'ᆳ'),
    (0x313E, 'M', u'ᆴ'),
    (0x313F, 'M', u'ᆵ'),
    (0x3140, 'M', u'ᄚ'),
    (0x3141, 'M', u'ᄆ'),
    (0x3142, 'M', u'ᄇ'),
    (0x3143, 'M', u'ᄈ'),
    (0x3144, 'M', u'ᄡ'),
    (0x3145, 'M', u'ᄉ'),
    (0x3146, 'M', u'ᄊ'),
    (0x3147, 'M', u'ᄋ'),
    (0x3148, 'M', u'ᄌ'),
    (0x3149, 'M', u'ᄍ'),
    (0x314A, 'M', u'ᄎ'),
    (0x314B, 'M', u'ᄏ'),
    (0x314C, 'M', u'ᄐ'),
    (0x314D, 'M', u'ᄑ'),
    (0x314E, 'M', u'ᄒ'),
    (0x314F, 'M', u'ᅡ'),
    (0x3150, 'M', u'ᅢ'),
    (0x3151, 'M', u'ᅣ'),
    (0x3152, 'M', u'ᅤ'),
    (0x3153, 'M', u'ᅥ'),
    (0x3154, 'M', u'ᅦ'),
    (0x3155, 'M', u'ᅧ'),
    (0x3156, 'M', u'ᅨ'),
    (0x3157, 'M', u'ᅩ'),
    (0x3158, 'M', u'ᅪ'),
    (0x3159, 'M', u'ᅫ'),
    (0x315A, 'M', u'ᅬ'),
    (0x315B, 'M', u'ᅭ'),
    (0x315C, 'M', u'ᅮ'),
    (0x315D, 'M', u'ᅯ'),
    (0x315E, 'M', u'ᅰ'),
    (0x315F, 'M', u'ᅱ'),
    (0x3160, 'M', u'ᅲ'),
    (0x3161, 'M', u'ᅳ'),
    (0x3162, 'M', u'ᅴ'),
    (0x3163, 'M', u'ᅵ'),
    (0x3164, 'X'),
    (0x3165, 'M', u'ᄔ'),
    (0x3166, 'M', u'ᄕ'),
    (0x3167, 'M', u'ᇇ'),
    (0x3168, 'M', u'ᇈ'),
    (0x3169, 'M', u'ᇌ'),
    (0x316A, 'M', u'ᇎ'),
    (0x316B, 'M', u'ᇓ'),
    (0x316C, 'M', u'ᇗ'),
    (0x316D, 'M', u'ᇙ'),
    (0x316E, 'M', u'ᄜ'),
    (0x316F, 'M', u'ᇝ'),
    (0x3170, 'M', u'ᇟ'),
    (0x3171, 'M', u'ᄝ'),
    (0x3172, 'M', u'ᄞ'),
    (0x3173, 'M', u'ᄠ'),
    (0x3174, 'M', u'ᄢ'),
    (0x3175, 'M', u'ᄣ'),
    (0x3176, 'M', u'ᄧ'),
    (0x3177, 'M', u'ᄩ'),
    (0x3178, 'M', u'ᄫ'),
    (0x3179, 'M', u'ᄬ'),
    (0x317A, 'M', u'ᄭ'),
    (0x317B, 'M', u'ᄮ'),
    (0x317C, 'M', u'ᄯ'),
    (0x317D, 'M', u'ᄲ'),
    (0x317E, 'M', u'ᄶ'),
    (0x317F, 'M', u'ᅀ'),
    (0x3180, 'M', u'ᅇ'),
    (0x3181, 'M', u'ᅌ'),
    (0x3182, 'M', u'ᇱ'),
    (0x3183, 'M', u'ᇲ'),
    (0x3184, 'M', u'ᅗ'),
    (0x3185, 'M', u'ᅘ'),
    (0x3186, 'M', u'ᅙ'),
    (0x3187, 'M', u'ᆄ'),
    (0x3188, 'M', u'ᆅ'),
    (0x3189, 'M', u'ᆈ'),
    (0x318A, 'M', u'ᆑ'),
    (0x318B, 'M', u'ᆒ'),
    (0x318C, 'M', u'ᆔ'),
    (0x318D, 'M', u'ᆞ'),
    (0x318E, 'M', u'ᆡ'),
    (0x318F, 'X'),
    (0x3190, 'V'),
    (0x3192, 'M', u'一'),
    (0x3193, 'M', u'二'),
    (0x3194, 'M', u'三'),
    (0x3195, 'M', u'四'),
    (0x3196, 'M', u'上'),
    (0x3197, 'M', u'中'),
    (0x3198, 'M', u'下'),
    (0x3199, 'M', u'甲'),
    (0x319A, 'M', u'乙'),
    (0x319B, 'M', u'丙'),
    (0x319C, 'M', u'丁'),
    (0x319D, 'M', u'天'),
    ]

def _seg_30():
    return [
    (0x319E, 'M', u'地'),
    (0x319F, 'M', u'人'),
    (0x31A0, 'V'),
    (0x31BB, 'X'),
    (0x31C0, 'V'),
    (0x31E4, 'X'),
    (0x31F0, 'V'),
    (0x3200, '3', u'(ᄀ)'),
    (0x3201, '3', u'(ᄂ)'),
    (0x3202, '3', u'(ᄃ)'),
    (0x3203, '3', u'(ᄅ)'),
    (0x3204, '3', u'(ᄆ)'),
    (0x3205, '3', u'(ᄇ)'),
    (0x3206, '3', u'(ᄉ)'),
    (0x3207, '3', u'(ᄋ)'),
    (0x3208, '3', u'(ᄌ)'),
    (0x3209, '3', u'(ᄎ)'),
    (0x320A, '3', u'(ᄏ)'),
    (0x320B, '3', u'(ᄐ)'),
    (0x320C, '3', u'(ᄑ)'),
    (0x320D, '3', u'(ᄒ)'),
    (0x320E, '3', u'(가)'),
    (0x320F, '3', u'(나)'),
    (0x3210, '3', u'(다)'),
    (0x3211, '3', u'(라)'),
    (0x3212, '3', u'(마)'),
    (0x3213, '3', u'(바)'),
    (0x3214, '3', u'(사)'),
    (0x3215, '3', u'(아)'),
    (0x3216, '3', u'(자)'),
    (0x3217, '3', u'(차)'),
    (0x3218, '3', u'(카)'),
    (0x3219, '3', u'(타)'),
    (0x321A, '3', u'(파)'),
    (0x321B, '3', u'(하)'),
    (0x321C, '3', u'(주)'),
    (0x321D, '3', u'(오전)'),
    (0x321E, '3', u'(오후)'),
    (0x321F, 'X'),
    (0x3220, '3', u'(一)'),
    (0x3221, '3', u'(二)'),
    (0x3222, '3', u'(三)'),
    (0x3223, '3', u'(四)'),
    (0x3224, '3', u'(五)'),
    (0x3225, '3', u'(六)'),
    (0x3226, '3', u'(七)'),
    (0x3227, '3', u'(八)'),
    (0x3228, '3', u'(九)'),
    (0x3229, '3', u'(十)'),
    (0x322A, '3', u'(月)'),
    (0x322B, '3', u'(火)'),
    (0x322C, '3', u'(水)'),
    (0x322D, '3', u'(木)'),
    (0x322E, '3', u'(金)'),
    (0x322F, '3', u'(土)'),
    (0x3230, '3', u'(日)'),
    (0x3231, '3', u'(株)'),
    (0x3232, '3', u'(有)'),
    (0x3233, '3', u'(社)'),
    (0x3234, '3', u'(名)'),
    (0x3235, '3', u'(特)'),
    (0x3236, '3', u'(財)'),
    (0x3237, '3', u'(祝)'),
    (0x3238, '3', u'(労)'),
    (0x3239, '3', u'(代)'),
    (0x323A, '3', u'(呼)'),
    (0x323B, '3', u'(学)'),
    (0x323C, '3', u'(監)'),
    (0x323D, '3', u'(企)'),
    (0x323E, '3', u'(資)'),
    (0x323F, '3', u'(協)'),
    (0x3240, '3', u'(祭)'),
    (0x3241, '3', u'(休)'),
    (0x3242, '3', u'(自)'),
    (0x3243, '3', u'(至)'),
    (0x3244, 'M', u'問'),
    (0x3245, 'M', u'幼'),
    (0x3246, 'M', u'文'),
    (0x3247, 'M', u'箏'),
    (0x3248, 'V'),
    (0x3250, 'M', u'pte'),
    (0x3251, 'M', u'21'),
    (0x3252, 'M', u'22'),
    (0x3253, 'M', u'23'),
    (0x3254, 'M', u'24'),
    (0x3255, 'M', u'25'),
    (0x3256, 'M', u'26'),
    (0x3257, 'M', u'27'),
    (0x3258, 'M', u'28'),
    (0x3259, 'M', u'29'),
    (0x325A, 'M', u'30'),
    (0x325B, 'M', u'31'),
    (0x325C, 'M', u'32'),
    (0x325D, 'M', u'33'),
    (0x325E, 'M', u'34'),
    (0x325F, 'M', u'35'),
    (0x3260, 'M', u'ᄀ'),
    (0x3261, 'M', u'ᄂ'),
    (0x3262, 'M', u'ᄃ'),
    (0x3263, 'M', u'ᄅ'),
    ]

def _seg_31():
    return [
    (0x3264, 'M', u'ᄆ'),
    (0x3265, 'M', u'ᄇ'),
    (0x3266, 'M', u'ᄉ'),
    (0x3267, 'M', u'ᄋ'),
    (0x3268, 'M', u'ᄌ'),
    (0x3269, 'M', u'ᄎ'),
    (0x326A, 'M', u'ᄏ'),
    (0x326B, 'M', u'ᄐ'),
    (0x326C, 'M', u'ᄑ'),
    (0x326D, 'M', u'ᄒ'),
    (0x326E, 'M', u'가'),
    (0x326F, 'M', u'나'),
    (0x3270, 'M', u'다'),
    (0x3271, 'M', u'라'),
    (0x3272, 'M', u'마'),
    (0x3273, 'M', u'바'),
    (0x3274, 'M', u'사'),
    (0x3275, 'M', u'아'),
    (0x3276, 'M', u'자'),
    (0x3277, 'M', u'차'),
    (0x3278, 'M', u'카'),
    (0x3279, 'M', u'타'),
    (0x327A, 'M', u'파'),
    (0x327B, 'M', u'하'),
    (0x327C, 'M', u'참고'),
    (0x327D, 'M', u'주의'),
    (0x327E, 'M', u'우'),
    (0x327F, 'V'),
    (0x3280, 'M', u'一'),
    (0x3281, 'M', u'二'),
    (0x3282, 'M', u'三'),
    (0x3283, 'M', u'四'),
    (0x3284, 'M', u'五'),
    (0x3285, 'M', u'六'),
    (0x3286, 'M', u'七'),
    (0x3287, 'M', u'八'),
    (0x3288, 'M', u'九'),
    (0x3289, 'M', u'十'),
    (0x328A, 'M', u'月'),
    (0x328B, 'M', u'火'),
    (0x328C, 'M', u'水'),
    (0x328D, 'M', u'木'),
    (0x328E, 'M', u'金'),
    (0x328F, 'M', u'土'),
    (0x3290, 'M', u'日'),
    (0x3291, 'M', u'株'),
    (0x3292, 'M', u'有'),
    (0x3293, 'M', u'社'),
    (0x3294, 'M', u'名'),
    (0x3295, 'M', u'特'),
    (0x3296, 'M', u'財'),
    (0x3297, 'M', u'祝'),
    (0x3298, 'M', u'労'),
    (0x3299, 'M', u'秘'),
    (0x329A, 'M', u'男'),
    (0x329B, 'M', u'女'),
    (0x329C, 'M', u'適'),
    (0x329D, 'M', u'優'),
    (0x329E, 'M', u'印'),
    (0x329F, 'M', u'注'),
    (0x32A0, 'M', u'項'),
    (0x32A1, 'M', u'休'),
    (0x32A2, 'M', u'写'),
    (0x32A3, 'M', u'正'),
    (0x32A4, 'M', u'上'),
    (0x32A5, 'M', u'中'),
    (0x32A6, 'M', u'下'),
    (0x32A7, 'M', u'左'),
    (0x32A8, 'M', u'右'),
    (0x32A9, 'M', u'医'),
    (0x32AA, 'M', u'宗'),
    (0x32AB, 'M', u'学'),
    (0x32AC, 'M', u'監'),
    (0x32AD, 'M', u'企'),
    (0x32AE, 'M', u'資'),
    (0x32AF, 'M', u'協'),
    (0x32B0, 'M', u'夜'),
    (0x32B1, 'M', u'36'),
    (0x32B2, 'M', u'37'),
    (0x32B3, 'M', u'38'),
    (0x32B4, 'M', u'39'),
    (0x32B5, 'M', u'40'),
    (0x32B6, 'M', u'41'),
    (0x32B7, 'M', u'42'),
    (0x32B8, 'M', u'43'),
    (0x32B9, 'M', u'44'),
    (0x32BA, 'M', u'45'),
    (0x32BB, 'M', u'46'),
    (0x32BC, 'M', u'47'),
    (0x32BD, 'M', u'48'),
    (0x32BE, 'M', u'49'),
    (0x32BF, 'M', u'50'),
    (0x32C0, 'M', u'1月'),
    (0x32C1, 'M', u'2月'),
    (0x32C2, 'M', u'3月'),
    (0x32C3, 'M', u'4月'),
    (0x32C4, 'M', u'5月'),
    (0x32C5, 'M', u'6月'),
    (0x32C6, 'M', u'7月'),
    (0x32C7, 'M', u'8月'),
    ]

def _seg_32():
    return [
    (0x32C8, 'M', u'9月'),
    (0x32C9, 'M', u'10月'),
    (0x32CA, 'M', u'11月'),
    (0x32CB, 'M', u'12月'),
    (0x32CC, 'M', u'hg'),
    (0x32CD, 'M', u'erg'),
    (0x32CE, 'M', u'ev'),
    (0x32CF, 'M', u'ltd'),
    (0x32D0, 'M', u'ア'),
    (0x32D1, 'M', u'イ'),
    (0x32D2, 'M', u'ウ'),
    (0x32D3, 'M', u'エ'),
    (0x32D4, 'M', u'オ'),
    (0x32D5, 'M', u'カ'),
    (0x32D6, 'M', u'キ'),
    (0x32D7, 'M', u'ク'),
    (0x32D8, 'M', u'ケ'),
    (0x32D9, 'M', u'コ'),
    (0x32DA, 'M', u'サ'),
    (0x32DB, 'M', u'シ'),
    (0x32DC, 'M', u'ス'),
    (0x32DD, 'M', u'セ'),
    (0x32DE, 'M', u'ソ'),
    (0x32DF, 'M', u'タ'),
    (0x32E0, 'M', u'チ'),
    (0x32E1, 'M', u'ツ'),
    (0x32E2, 'M', u'テ'),
    (0x32E3, 'M', u'ト'),
    (0x32E4, 'M', u'ナ'),
    (0x32E5, 'M', u'ニ'),
    (0x32E6, 'M', u'ヌ'),
    (0x32E7, 'M', u'ネ'),
    (0x32E8, 'M', u'ノ'),
    (0x32E9, 'M', u'ハ'),
    (0x32EA, 'M', u'ヒ'),
    (0x32EB, 'M', u'フ'),
    (0x32EC, 'M', u'ヘ'),
    (0x32ED, 'M', u'ホ'),
    (0x32EE, 'M', u'マ'),
    (0x32EF, 'M', u'ミ'),
    (0x32F0, 'M', u'ム'),
    (0x32F1, 'M', u'メ'),
    (0x32F2, 'M', u'モ'),
    (0x32F3, 'M', u'ヤ'),
    (0x32F4, 'M', u'ユ'),
    (0x32F5, 'M', u'ヨ'),
    (0x32F6, 'M', u'ラ'),
    (0x32F7, 'M', u'リ'),
    (0x32F8, 'M', u'ル'),
    (0x32F9, 'M', u'レ'),
    (0x32FA, 'M', u'ロ'),
    (0x32FB, 'M', u'ワ'),
    (0x32FC, 'M', u'ヰ'),
    (0x32FD, 'M', u'ヱ'),
    (0x32FE, 'M', u'ヲ'),
    (0x32FF, 'X'),
    (0x3300, 'M', u'アパート'),
    (0x3301, 'M', u'アルファ'),
    (0x3302, 'M', u'アンペア'),
    (0x3303, 'M', u'アール'),
    (0x3304, 'M', u'イニング'),
    (0x3305, 'M', u'インチ'),
    (0x3306, 'M', u'ウォン'),
    (0x3307, 'M', u'エスクード'),
    (0x3308, 'M', u'エーカー'),
    (0x3309, 'M', u'オンス'),
    (0x330A, 'M', u'オーム'),
    (0x330B, 'M', u'カイリ'),
    (0x330C, 'M', u'カラット'),
    (0x330D, 'M', u'カロリー'),
    (0x330E, 'M', u'ガロン'),
    (0x330F, 'M', u'ガンマ'),
    (0x3310, 'M', u'ギガ'),
    (0x3311, 'M', u'ギニー'),
    (0x3312, 'M', u'キュリー'),
    (0x3313, 'M', u'ギルダー'),
    (0x3314, 'M', u'キロ'),
    (0x3315, 'M', u'キログラム'),
    (0x3316, 'M', u'キロメートル'),
    (0x3317, 'M', u'キロワット'),
    (0x3318, 'M', u'グラム'),
    (0x3319, 'M', u'グラムトン'),
    (0x331A, 'M', u'クルゼイロ'),
    (0x331B, 'M', u'クローネ'),
    (0x331C, 'M', u'ケース'),
    (0x331D, 'M', u'コルナ'),
    (0x331E, 'M', u'コーポ'),
    (0x331F, 'M', u'サイクル'),
    (0x3320, 'M', u'サンチーム'),
    (0x3321, 'M', u'シリング'),
    (0x3322, 'M', u'センチ'),
    (0x3323, 'M', u'セント'),
    (0x3324, 'M', u'ダース'),
    (0x3325, 'M', u'デシ'),
    (0x3326, 'M', u'ドル'),
    (0x3327, 'M', u'トン'),
    (0x3328, 'M', u'ナノ'),
    (0x3329, 'M', u'ノット'),
    (0x332A, 'M', u'ハイツ'),
    (0x332B, 'M', u'パーセント'),
    ]

def _seg_33():
    return [
    (0x332C, 'M', u'パーツ'),
    (0x332D, 'M', u'バーレル'),
    (0x332E, 'M', u'ピアストル'),
    (0x332F, 'M', u'ピクル'),
    (0x3330, 'M', u'ピコ'),
    (0x3331, 'M', u'ビル'),
    (0x3332, 'M', u'ファラッド'),
    (0x3333, 'M', u'フィート'),
    (0x3334, 'M', u'ブッシェル'),
    (0x3335, 'M', u'フラン'),
    (0x3336, 'M', u'ヘクタール'),
    (0x3337, 'M', u'ペソ'),
    (0x3338, 'M', u'ペニヒ'),
    (0x3339, 'M', u'ヘルツ'),
    (0x333A, 'M', u'ペンス'),
    (0x333B, 'M', u'ページ'),
    (0x333C, 'M', u'ベータ'),
    (0x333D, 'M', u'ポイント'),
    (0x333E, 'M', u'ボルト'),
    (0x333F, 'M', u'ホン'),
    (0x3340, 'M', u'ポンド'),
    (0x3341, 'M', u'ホール'),
    (0x3342, 'M', u'ホーン'),
    (0x3343, 'M', u'マイクロ'),
    (0x3344, 'M', u'マイル'),
    (0x3345, 'M', u'マッハ'),
    (0x3346, 'M', u'マルク'),
    (0x3347, 'M', u'マンション'),
    (0x3348, 'M', u'ミクロン'),
    (0x3349, 'M', u'ミリ'),
    (0x334A, 'M', u'ミリバール'),
    (0x334B, 'M', u'メガ'),
    (0x334C, 'M', u'メガトン'),
    (0x334D, 'M', u'メートル'),
    (0x334E, 'M', u'ヤード'),
    (0x334F, 'M', u'ヤール'),
    (0x3350, 'M', u'ユアン'),
    (0x3351, 'M', u'リットル'),
    (0x3352, 'M', u'リラ'),
    (0x3353, 'M', u'ルピー'),
    (0x3354, 'M', u'ルーブル'),
    (0x3355, 'M', u'レム'),
    (0x3356, 'M', u'レントゲン'),
    (0x3357, 'M', u'ワット'),
    (0x3358, 'M', u'0点'),
    (0x3359, 'M', u'1点'),
    (0x335A, 'M', u'2点'),
    (0x335B, 'M', u'3点'),
    (0x335C, 'M', u'4点'),
    (0x335D, 'M', u'5点'),
    (0x335E, 'M', u'6点'),
    (0x335F, 'M', u'7点'),
    (0x3360, 'M', u'8点'),
    (0x3361, 'M', u'9点'),
    (0x3362, 'M', u'10点'),
    (0x3363, 'M', u'11点'),
    (0x3364, 'M', u'12点'),
    (0x3365, 'M', u'13点'),
    (0x3366, 'M', u'14点'),
    (0x3367, 'M', u'15点'),
    (0x3368, 'M', u'16点'),
    (0x3369, 'M', u'17点'),
    (0x336A, 'M', u'18点'),
    (0x336B, 'M', u'19点'),
    (0x336C, 'M', u'20点'),
    (0x336D, 'M', u'21点'),
    (0x336E, 'M', u'22点'),
    (0x336F, 'M', u'23点'),
    (0x3370, 'M', u'24点'),
    (0x3371, 'M', u'hpa'),
    (0x3372, 'M', u'da'),
    (0x3373, 'M', u'au'),
    (0x3374, 'M', u'bar'),
    (0x3375, 'M', u'ov'),
    (0x3376, 'M', u'pc'),
    (0x3377, 'M', u'dm'),
    (0x3378, 'M', u'dm2'),
    (0x3379, 'M', u'dm3'),
    (0x337A, 'M', u'iu'),
    (0x337B, 'M', u'平成'),
    (0x337C, 'M', u'昭和'),
    (0x337D, 'M', u'大正'),
    (0x337E, 'M', u'明治'),
    (0x337F, 'M', u'株式会社'),
    (0x3380, 'M', u'pa'),
    (0x3381, 'M', u'na'),
    (0x3382, 'M', u'μa'),
    (0x3383, 'M', u'ma'),
    (0x3384, 'M', u'ka'),
    (0x3385, 'M', u'kb'),
    (0x3386, 'M', u'mb'),
    (0x3387, 'M', u'gb'),
    (0x3388, 'M', u'cal'),
    (0x3389, 'M', u'kcal'),
    (0x338A, 'M', u'pf'),
    (0x338B, 'M', u'nf'),
    (0x338C, 'M', u'μf'),
    (0x338D, 'M', u'μg'),
    (0x338E, 'M', u'mg'),
    (0x338F, 'M', u'kg'),
    ]

def _seg_34():
    return [
    (0x3390, 'M', u'hz'),
    (0x3391, 'M', u'khz'),
    (0x3392, 'M', u'mhz'),
    (0x3393, 'M', u'ghz'),
    (0x3394, 'M', u'thz'),
    (0x3395, 'M', u'μl'),
    (0x3396, 'M', u'ml'),
    (0x3397, 'M', u'dl'),
    (0x3398, 'M', u'kl'),
    (0x3399, 'M', u'fm'),
    (0x339A, 'M', u'nm'),
    (0x339B, 'M', u'μm'),
    (0x339C, 'M', u'mm'),
    (0x339D, 'M', u'cm'),
    (0x339E, 'M', u'km'),
    (0x339F, 'M', u'mm2'),
    (0x33A0, 'M', u'cm2'),
    (0x33A1, 'M', u'm2'),
    (0x33A2, 'M', u'km2'),
    (0x33A3, 'M', u'mm3'),
    (0x33A4, 'M', u'cm3'),
    (0x33A5, 'M', u'm3'),
    (0x33A6, 'M', u'km3'),
    (0x33A7, 'M', u'm∕s'),
    (0x33A8, 'M', u'm∕s2'),
    (0x33A9, 'M', u'pa'),
    (0x33AA, 'M', u'kpa'),
    (0x33AB, 'M', u'mpa'),
    (0x33AC, 'M', u'gpa'),
    (0x33AD, 'M', u'rad'),
    (0x33AE, 'M', u'rad∕s'),
    (0x33AF, 'M', u'rad∕s2'),
    (0x33B0, 'M', u'ps'),
    (0x33B1, 'M', u'ns'),
    (0x33B2, 'M', u'μs'),
    (0x33B3, 'M', u'ms'),
    (0x33B4, 'M', u'pv'),
    (0x33B5, 'M', u'nv'),
    (0x33B6, 'M', u'μv'),
    (0x33B7, 'M', u'mv'),
    (0x33B8, 'M', u'kv'),
    (0x33B9, 'M', u'mv'),
    (0x33BA, 'M', u'pw'),
    (0x33BB, 'M', u'nw'),
    (0x33BC, 'M', u'μw'),
    (0x33BD, 'M', u'mw'),
    (0x33BE, 'M', u'kw'),
    (0x33BF, 'M', u'mw'),
    (0x33C0, 'M', u'kω'),
    (0x33C1, 'M', u'mω'),
    (0x33C2, 'X'),
    (0x33C3, 'M', u'bq'),
    (0x33C4, 'M', u'cc'),
    (0x33C5, 'M', u'cd'),
    (0x33C6, 'M', u'c∕kg'),
    (0x33C7, 'X'),
    (0x33C8, 'M', u'db'),
    (0x33C9, 'M', u'gy'),
    (0x33CA, 'M', u'ha'),
    (0x33CB, 'M', u'hp'),
    (0x33CC, 'M', u'in'),
    (0x33CD, 'M', u'kk'),
    (0x33CE, 'M', u'km'),
    (0x33CF, 'M', u'kt'),
    (0x33D0, 'M', u'lm'),
    (0x33D1, 'M', u'ln'),
    (0x33D2, 'M', u'log'),
    (0x33D3, 'M', u'lx'),
    (0x33D4, 'M', u'mb'),
    (0x33D5, 'M', u'mil'),
    (0x33D6, 'M', u'mol'),
    (0x33D7, 'M', u'ph'),
    (0x33D8, 'X'),
    (0x33D9, 'M', u'ppm'),
    (0x33DA, 'M', u'pr'),
    (0x33DB, 'M', u'sr'),
    (0x33DC, 'M', u'sv'),
    (0x33DD, 'M', u'wb'),
    (0x33DE, 'M', u'v∕m'),
    (0x33DF, 'M', u'a∕m'),
    (0x33E0, 'M', u'1日'),
    (0x33E1, 'M', u'2日'),
    (0x33E2, 'M', u'3日'),
    (0x33E3, 'M', u'4日'),
    (0x33E4, 'M', u'5日'),
    (0x33E5, 'M', u'6日'),
    (0x33E6, 'M', u'7日'),
    (0x33E7, 'M', u'8日'),
    (0x33E8, 'M', u'9日'),
    (0x33E9, 'M', u'10日'),
    (0x33EA, 'M', u'11日'),
    (0x33EB, 'M', u'12日'),
    (0x33EC, 'M', u'13日'),
    (0x33ED, 'M', u'14日'),
    (0x33EE, 'M', u'15日'),
    (0x33EF, 'M', u'16日'),
    (0x33F0, 'M', u'17日'),
    (0x33F1, 'M', u'18日'),
    (0x33F2, 'M', u'19日'),
    (0x33F3, 'M', u'20日'),
    ]

def _seg_35():
    return [
    (0x33F4, 'M', u'21日'),
    (0x33F5, 'M', u'22日'),
    (0x33F6, 'M', u'23日'),
    (0x33F7, 'M', u'24日'),
    (0x33F8, 'M', u'25日'),
    (0x33F9, 'M', u'26日'),
    (0x33FA, 'M', u'27日'),
    (0x33FB, 'M', u'28日'),
    (0x33FC, 'M', u'29日'),
    (0x33FD, 'M', u'30日'),
    (0x33FE, 'M', u'31日'),
    (0x33FF, 'M', u'gal'),
    (0x3400, 'V'),
    (0x4DB6, 'X'),
    (0x4DC0, 'V'),
    (0x9FF0, 'X'),
    (0xA000, 'V'),
    (0xA48D, 'X'),
    (0xA490, 'V'),
    (0xA4C7, 'X'),
    (0xA4D0, 'V'),
    (0xA62C, 'X'),
    (0xA640, 'M', u'ꙁ'),
    (0xA641, 'V'),
    (0xA642, 'M', u'ꙃ'),
    (0xA643, 'V'),
    (0xA644, 'M', u'ꙅ'),
    (0xA645, 'V'),
    (0xA646, 'M', u'ꙇ'),
    (0xA647, 'V'),
    (0xA648, 'M', u'ꙉ'),
    (0xA649, 'V'),
    (0xA64A, 'M', u'ꙋ'),
    (0xA64B, 'V'),
    (0xA64C, 'M', u'ꙍ'),
    (0xA64D, 'V'),
    (0xA64E, 'M', u'ꙏ'),
    (0xA64F, 'V'),
    (0xA650, 'M', u'ꙑ'),
    (0xA651, 'V'),
    (0xA652, 'M', u'ꙓ'),
    (0xA653, 'V'),
    (0xA654, 'M', u'ꙕ'),
    (0xA655, 'V'),
    (0xA656, 'M', u'ꙗ'),
    (0xA657, 'V'),
    (0xA658, 'M', u'ꙙ'),
    (0xA659, 'V'),
    (0xA65A, 'M', u'ꙛ'),
    (0xA65B, 'V'),
    (0xA65C, 'M', u'ꙝ'),
    (0xA65D, 'V'),
    (0xA65E, 'M', u'ꙟ'),
    (0xA65F, 'V'),
    (0xA660, 'M', u'ꙡ'),
    (0xA661, 'V'),
    (0xA662, 'M', u'ꙣ'),
    (0xA663, 'V'),
    (0xA664, 'M', u'ꙥ'),
    (0xA665, 'V'),
    (0xA666, 'M', u'ꙧ'),
    (0xA667, 'V'),
    (0xA668, 'M', u'ꙩ'),
    (0xA669, 'V'),
    (0xA66A, 'M', u'ꙫ'),
    (0xA66B, 'V'),
    (0xA66C, 'M', u'ꙭ'),
    (0xA66D, 'V'),
    (0xA680, 'M', u'ꚁ'),
    (0xA681, 'V'),
    (0xA682, 'M', u'ꚃ'),
    (0xA683, 'V'),
    (0xA684, 'M', u'ꚅ'),
    (0xA685, 'V'),
    (0xA686, 'M', u'ꚇ'),
    (0xA687, 'V'),
    (0xA688, 'M', u'ꚉ'),
    (0xA689, 'V'),
    (0xA68A, 'M', u'ꚋ'),
    (0xA68B, 'V'),
    (0xA68C, 'M', u'ꚍ'),
    (0xA68D, 'V'),
    (0xA68E, 'M', u'ꚏ'),
    (0xA68F, 'V'),
    (0xA690, 'M', u'ꚑ'),
    (0xA691, 'V'),
    (0xA692, 'M', u'ꚓ'),
    (0xA693, 'V'),
    (0xA694, 'M', u'ꚕ'),
    (0xA695, 'V'),
    (0xA696, 'M', u'ꚗ'),
    (0xA697, 'V'),
    (0xA698, 'M', u'ꚙ'),
    (0xA699, 'V'),
    (0xA69A, 'M', u'ꚛ'),
    (0xA69B, 'V'),
    (0xA69C, 'M', u'ъ'),
    (0xA69D, 'M', u'ь'),
    (0xA69E, 'V'),
    (0xA6F8, 'X'),
    ]

def _seg_36():
    return [
    (0xA700, 'V'),
    (0xA722, 'M', u'ꜣ'),
    (0xA723, 'V'),
    (0xA724, 'M', u'ꜥ'),
    (0xA725, 'V'),
    (0xA726, 'M', u'ꜧ'),
    (0xA727, 'V'),
    (0xA728, 'M', u'ꜩ'),
    (0xA729, 'V'),
    (0xA72A, 'M', u'ꜫ'),
    (0xA72B, 'V'),
    (0xA72C, 'M', u'ꜭ'),
    (0xA72D, 'V'),
    (0xA72E, 'M', u'ꜯ'),
    (0xA72F, 'V'),
    (0xA732, 'M', u'ꜳ'),
    (0xA733, 'V'),
    (0xA734, 'M', u'ꜵ'),
    (0xA735, 'V'),
    (0xA736, 'M', u'ꜷ'),
    (0xA737, 'V'),
    (0xA738, 'M', u'ꜹ'),
    (0xA739, 'V'),
    (0xA73A, 'M', u'ꜻ'),
    (0xA73B, 'V'),
    (0xA73C, 'M', u'ꜽ'),
    (0xA73D, 'V'),
    (0xA73E, 'M', u'ꜿ'),
    (0xA73F, 'V'),
    (0xA740, 'M', u'ꝁ'),
    (0xA741, 'V'),
    (0xA742, 'M', u'ꝃ'),
    (0xA743, 'V'),
    (0xA744, 'M', u'ꝅ'),
    (0xA745, 'V'),
    (0xA746, 'M', u'ꝇ'),
    (0xA747, 'V'),
    (0xA748, 'M', u'ꝉ'),
    (0xA749, 'V'),
    (0xA74A, 'M', u'ꝋ'),
    (0xA74B, 'V'),
    (0xA74C, 'M', u'ꝍ'),
    (0xA74D, 'V'),
    (0xA74E, 'M', u'ꝏ'),
    (0xA74F, 'V'),
    (0xA750, 'M', u'ꝑ'),
    (0xA751, 'V'),
    (0xA752, 'M', u'ꝓ'),
    (0xA753, 'V'),
    (0xA754, 'M', u'ꝕ'),
    (0xA755, 'V'),
    (0xA756, 'M', u'ꝗ'),
    (0xA757, 'V'),
    (0xA758, 'M', u'ꝙ'),
    (0xA759, 'V'),
    (0xA75A, 'M', u'ꝛ'),
    (0xA75B, 'V'),
    (0xA75C, 'M', u'ꝝ'),
    (0xA75D, 'V'),
    (0xA75E, 'M', u'ꝟ'),
    (0xA75F, 'V'),
    (0xA760, 'M', u'ꝡ'),
    (0xA761, 'V'),
    (0xA762, 'M', u'ꝣ'),
    (0xA763, 'V'),
    (0xA764, 'M', u'ꝥ'),
    (0xA765, 'V'),
    (0xA766, 'M', u'ꝧ'),
    (0xA767, 'V'),
    (0xA768, 'M', u'ꝩ'),
    (0xA769, 'V'),
    (0xA76A, 'M', u'ꝫ'),
    (0xA76B, 'V'),
    (0xA76C, 'M', u'ꝭ'),
    (0xA76D, 'V'),
    (0xA76E, 'M', u'ꝯ'),
    (0xA76F, 'V'),
    (0xA770, 'M', u'ꝯ'),
    (0xA771, 'V'),
    (0xA779, 'M', u'ꝺ'),
    (0xA77A, 'V'),
    (0xA77B, 'M', u'ꝼ'),
    (0xA77C, 'V'),
    (0xA77D, 'M', u'ᵹ'),
    (0xA77E, 'M', u'ꝿ'),
    (0xA77F, 'V'),
    (0xA780, 'M', u'ꞁ'),
    (0xA781, 'V'),
    (0xA782, 'M', u'ꞃ'),
    (0xA783, 'V'),
    (0xA784, 'M', u'ꞅ'),
    (0xA785, 'V'),
    (0xA786, 'M', u'ꞇ'),
    (0xA787, 'V'),
    (0xA78B, 'M', u'ꞌ'),
    (0xA78C, 'V'),
    (0xA78D, 'M', u'ɥ'),
    (0xA78E, 'V'),
    (0xA790, 'M', u'ꞑ'),
    (0xA791, 'V'),
    ]

def _seg_37():
    return [
    (0xA792, 'M', u'ꞓ'),
    (0xA793, 'V'),
    (0xA796, 'M', u'ꞗ'),
    (0xA797, 'V'),
    (0xA798, 'M', u'ꞙ'),
    (0xA799, 'V'),
    (0xA79A, 'M', u'ꞛ'),
    (0xA79B, 'V'),
    (0xA79C, 'M', u'ꞝ'),
    (0xA79D, 'V'),
    (0xA79E, 'M', u'ꞟ'),
    (0xA79F, 'V'),
    (0xA7A0, 'M', u'ꞡ'),
    (0xA7A1, 'V'),
    (0xA7A2, 'M', u'ꞣ'),
    (0xA7A3, 'V'),
    (0xA7A4, 'M', u'ꞥ'),
    (0xA7A5, 'V'),
    (0xA7A6, 'M', u'ꞧ'),
    (0xA7A7, 'V'),
    (0xA7A8, 'M', u'ꞩ'),
    (0xA7A9, 'V'),
    (0xA7AA, 'M', u'ɦ'),
    (0xA7AB, 'M', u'ɜ'),
    (0xA7AC, 'M', u'ɡ'),
    (0xA7AD, 'M', u'ɬ'),
    (0xA7AE, 'M', u'ɪ'),
    (0xA7AF, 'V'),
    (0xA7B0, 'M', u'ʞ'),
    (0xA7B1, 'M', u'ʇ'),
    (0xA7B2, 'M', u'ʝ'),
    (0xA7B3, 'M', u'ꭓ'),
    (0xA7B4, 'M', u'ꞵ'),
    (0xA7B5, 'V'),
    (0xA7B6, 'M', u'ꞷ'),
    (0xA7B7, 'V'),
    (0xA7B8, 'X'),
    (0xA7B9, 'V'),
    (0xA7BA, 'X'),
    (0xA7F7, 'V'),
    (0xA7F8, 'M', u'ħ'),
    (0xA7F9, 'M', u'œ'),
    (0xA7FA, 'V'),
    (0xA82C, 'X'),
    (0xA830, 'V'),
    (0xA83A, 'X'),
    (0xA840, 'V'),
    (0xA878, 'X'),
    (0xA880, 'V'),
    (0xA8C6, 'X'),
    (0xA8CE, 'V'),
    (0xA8DA, 'X'),
    (0xA8E0, 'V'),
    (0xA954, 'X'),
    (0xA95F, 'V'),
    (0xA97D, 'X'),
    (0xA980, 'V'),
    (0xA9CE, 'X'),
    (0xA9CF, 'V'),
    (0xA9DA, 'X'),
    (0xA9DE, 'V'),
    (0xA9FF, 'X'),
    (0xAA00, 'V'),
    (0xAA37, 'X'),
    (0xAA40, 'V'),
    (0xAA4E, 'X'),
    (0xAA50, 'V'),
    (0xAA5A, 'X'),
    (0xAA5C, 'V'),
    (0xAAC3, 'X'),
    (0xAADB, 'V'),
    (0xAAF7, 'X'),
    (0xAB01, 'V'),
    (0xAB07, 'X'),
    (0xAB09, 'V'),
    (0xAB0F, 'X'),
    (0xAB11, 'V'),
    (0xAB17, 'X'),
    (0xAB20, 'V'),
    (0xAB27, 'X'),
    (0xAB28, 'V'),
    (0xAB2F, 'X'),
    (0xAB30, 'V'),
    (0xAB5C, 'M', u'ꜧ'),
    (0xAB5D, 'M', u'ꬷ'),
    (0xAB5E, 'M', u'ɫ'),
    (0xAB5F, 'M', u'ꭒ'),
    (0xAB60, 'V'),
    (0xAB66, 'X'),
    (0xAB70, 'M', u'Ꭰ'),
    (0xAB71, 'M', u'Ꭱ'),
    (0xAB72, 'M', u'Ꭲ'),
    (0xAB73, 'M', u'Ꭳ'),
    (0xAB74, 'M', u'Ꭴ'),
    (0xAB75, 'M', u'Ꭵ'),
    (0xAB76, 'M', u'Ꭶ'),
    (0xAB77, 'M', u'Ꭷ'),
    (0xAB78, 'M', u'Ꭸ'),
    (0xAB79, 'M', u'Ꭹ'),
    (0xAB7A, 'M', u'Ꭺ'),
    ]

def _seg_38():
    return [
    (0xAB7B, 'M', u'Ꭻ'),
    (0xAB7C, 'M', u'Ꭼ'),
    (0xAB7D, 'M', u'Ꭽ'),
    (0xAB7E, 'M', u'Ꭾ'),
    (0xAB7F, 'M', u'Ꭿ'),
    (0xAB80, 'M', u'Ꮀ'),
    (0xAB81, 'M', u'Ꮁ'),
    (0xAB82, 'M', u'Ꮂ'),
    (0xAB83, 'M', u'Ꮃ'),
    (0xAB84, 'M', u'Ꮄ'),
    (0xAB85, 'M', u'Ꮅ'),
    (0xAB86, 'M', u'Ꮆ'),
    (0xAB87, 'M', u'Ꮇ'),
    (0xAB88, 'M', u'Ꮈ'),
    (0xAB89, 'M', u'Ꮉ'),
    (0xAB8A, 'M', u'Ꮊ'),
    (0xAB8B, 'M', u'Ꮋ'),
    (0xAB8C, 'M', u'Ꮌ'),
    (0xAB8D, 'M', u'Ꮍ'),
    (0xAB8E, 'M', u'Ꮎ'),
    (0xAB8F, 'M', u'Ꮏ'),
    (0xAB90, 'M', u'Ꮐ'),
    (0xAB91, 'M', u'Ꮑ'),
    (0xAB92, 'M', u'Ꮒ'),
    (0xAB93, 'M', u'Ꮓ'),
    (0xAB94, 'M', u'Ꮔ'),
    (0xAB95, 'M', u'Ꮕ'),
    (0xAB96, 'M', u'Ꮖ'),
    (0xAB97, 'M', u'Ꮗ'),
    (0xAB98, 'M', u'Ꮘ'),
    (0xAB99, 'M', u'Ꮙ'),
    (0xAB9A, 'M', u'Ꮚ'),
    (0xAB9B, 'M', u'Ꮛ'),
    (0xAB9C, 'M', u'Ꮜ'),
    (0xAB9D, 'M', u'Ꮝ'),
    (0xAB9E, 'M', u'Ꮞ'),
    (0xAB9F, 'M', u'Ꮟ'),
    (0xABA0, 'M', u'Ꮠ'),
    (0xABA1, 'M', u'Ꮡ'),
    (0xABA2, 'M', u'Ꮢ'),
    (0xABA3, 'M', u'Ꮣ'),
    (0xABA4, 'M', u'Ꮤ'),
    (0xABA5, 'M', u'Ꮥ'),
    (0xABA6, 'M', u'Ꮦ'),
    (0xABA7, 'M', u'Ꮧ'),
    (0xABA8, 'M', u'Ꮨ'),
    (0xABA9, 'M', u'Ꮩ'),
    (0xABAA, 'M', u'Ꮪ'),
    (0xABAB, 'M', u'Ꮫ'),
    (0xABAC, 'M', u'Ꮬ'),
    (0xABAD, 'M', u'Ꮭ'),
    (0xABAE, 'M', u'Ꮮ'),
    (0xABAF, 'M', u'Ꮯ'),
    (0xABB0, 'M', u'Ꮰ'),
    (0xABB1, 'M', u'Ꮱ'),
    (0xABB2, 'M', u'Ꮲ'),
    (0xABB3, 'M', u'Ꮳ'),
    (0xABB4, 'M', u'Ꮴ'),
    (0xABB5, 'M', u'Ꮵ'),
    (0xABB6, 'M', u'Ꮶ'),
    (0xABB7, 'M', u'Ꮷ'),
    (0xABB8, 'M', u'Ꮸ'),
    (0xABB9, 'M', u'Ꮹ'),
    (0xABBA, 'M', u'Ꮺ'),
    (0xABBB, 'M', u'Ꮻ'),
    (0xABBC, 'M', u'Ꮼ'),
    (0xABBD, 'M', u'Ꮽ'),
    (0xABBE, 'M', u'Ꮾ'),
    (0xABBF, 'M', u'Ꮿ'),
    (0xABC0, 'V'),
    (0xABEE, 'X'),
    (0xABF0, 'V'),
    (0xABFA, 'X'),
    (0xAC00, 'V'),
    (0xD7A4, 'X'),
    (0xD7B0, 'V'),
    (0xD7C7, 'X'),
    (0xD7CB, 'V'),
    (0xD7FC, 'X'),
    (0xF900, 'M', u'豈'),
    (0xF901, 'M', u'更'),
    (0xF902, 'M', u'車'),
    (0xF903, 'M', u'賈'),
    (0xF904, 'M', u'滑'),
    (0xF905, 'M', u'串'),
    (0xF906, 'M', u'句'),
    (0xF907, 'M', u'龜'),
    (0xF909, 'M', u'契'),
    (0xF90A, 'M', u'金'),
    (0xF90B, 'M', u'喇'),
    (0xF90C, 'M', u'奈'),
    (0xF90D, 'M', u'懶'),
    (0xF90E, 'M', u'癩'),
    (0xF90F, 'M', u'羅'),
    (0xF910, 'M', u'蘿'),
    (0xF911, 'M', u'螺'),
    (0xF912, 'M', u'裸'),
    (0xF913, 'M', u'邏'),
    (0xF914, 'M', u'樂'),
    (0xF915, 'M', u'洛'),
    ]

def _seg_39():
    return [
    (0xF916, 'M', u'烙'),
    (0xF917, 'M', u'珞'),
    (0xF918, 'M', u'落'),
    (0xF919, 'M', u'酪'),
    (0xF91A, 'M', u'駱'),
    (0xF91B, 'M', u'亂'),
    (0xF91C, 'M', u'卵'),
    (0xF91D, 'M', u'欄'),
    (0xF91E, 'M', u'爛'),
    (0xF91F, 'M', u'蘭'),
    (0xF920, 'M', u'鸞'),
    (0xF921, 'M', u'嵐'),
    (0xF922, 'M', u'濫'),
    (0xF923, 'M', u'藍'),
    (0xF924, 'M', u'襤'),
    (0xF925, 'M', u'拉'),
    (0xF926, 'M', u'臘'),
    (0xF927, 'M', u'蠟'),
    (0xF928, 'M', u'廊'),
    (0xF929, 'M', u'朗'),
    (0xF92A, 'M', u'浪'),
    (0xF92B, 'M', u'狼'),
    (0xF92C, 'M', u'郎'),
    (0xF92D, 'M', u'來'),
    (0xF92E, 'M', u'冷'),
    (0xF92F, 'M', u'勞'),
    (0xF930, 'M', u'擄'),
    (0xF931, 'M', u'櫓'),
    (0xF932, 'M', u'爐'),
    (0xF933, 'M', u'盧'),
    (0xF934, 'M', u'老'),
    (0xF935, 'M', u'蘆'),
    (0xF936, 'M', u'虜'),
    (0xF937, 'M', u'路'),
    (0xF938, 'M', u'露'),
    (0xF939, 'M', u'魯'),
    (0xF93A, 'M', u'鷺'),
    (0xF93B, 'M', u'碌'),
    (0xF93C, 'M', u'祿'),
    (0xF93D, 'M', u'綠'),
    (0xF93E, 'M', u'菉'),
    (0xF93F, 'M', u'錄'),
    (0xF940, 'M', u'鹿'),
    (0xF941, 'M', u'論'),
    (0xF942, 'M', u'壟'),
    (0xF943, 'M', u'弄'),
    (0xF944, 'M', u'籠'),
    (0xF945, 'M', u'聾'),
    (0xF946, 'M', u'牢'),
    (0xF947, 'M', u'磊'),
    (0xF948, 'M', u'賂'),
    (0xF949, 'M', u'雷'),
    (0xF94A, 'M', u'壘'),
    (0xF94B, 'M', u'屢'),
    (0xF94C, 'M', u'樓'),
    (0xF94D, 'M', u'淚'),
    (0xF94E, 'M', u'漏'),
    (0xF94F, 'M', u'累'),
    (0xF950, 'M', u'縷'),
    (0xF951, 'M', u'陋'),
    (0xF952, 'M', u'勒'),
    (0xF953, 'M', u'肋'),
    (0xF954, 'M', u'凜'),
    (0xF955, 'M', u'凌'),
    (0xF956, 'M', u'稜'),
    (0xF957, 'M', u'綾'),
    (0xF958, 'M', u'菱'),
    (0xF959, 'M', u'陵'),
    (0xF95A, 'M', u'讀'),
    (0xF95B, 'M', u'拏'),
    (0xF95C, 'M', u'樂'),
    (0xF95D, 'M', u'諾'),
    (0xF95E, 'M', u'丹'),
    (0xF95F, 'M', u'寧'),
    (0xF960, 'M', u'怒'),
    (0xF961, 'M', u'率'),
    (0xF962, 'M', u'異'),
    (0xF963, 'M', u'北'),
    (0xF964, 'M', u'磻'),
    (0xF965, 'M', u'便'),
    (0xF966, 'M', u'復'),
    (0xF967, 'M', u'不'),
    (0xF968, 'M', u'泌'),
    (0xF969, 'M', u'數'),
    (0xF96A, 'M', u'索'),
    (0xF96B, 'M', u'參'),
    (0xF96C, 'M', u'塞'),
    (0xF96D, 'M', u'省'),
    (0xF96E, 'M', u'葉'),
    (0xF96F, 'M', u'說'),
    (0xF970, 'M', u'殺'),
    (0xF971, 'M', u'辰'),
    (0xF972, 'M', u'沈'),
    (0xF973, 'M', u'拾'),
    (0xF974, 'M', u'若'),
    (0xF975, 'M', u'掠'),
    (0xF976, 'M', u'略'),
    (0xF977, 'M', u'亮'),
    (0xF978, 'M', u'兩'),
    (0xF979, 'M', u'凉'),
    ]

def _seg_40():
    return [
    (0xF97A, 'M', u'梁'),
    (0xF97B, 'M', u'糧'),
    (0xF97C, 'M', u'良'),
    (0xF97D, 'M', u'諒'),
    (0xF97E, 'M', u'量'),
    (0xF97F, 'M', u'勵'),
    (0xF980, 'M', u'呂'),
    (0xF981, 'M', u'女'),
    (0xF982, 'M', u'廬'),
    (0xF983, 'M', u'旅'),
    (0xF984, 'M', u'濾'),
    (0xF985, 'M', u'礪'),
    (0xF986, 'M', u'閭'),
    (0xF987, 'M', u'驪'),
    (0xF988, 'M', u'麗'),
    (0xF989, 'M', u'黎'),
    (0xF98A, 'M', u'力'),
    (0xF98B, 'M', u'曆'),
    (0xF98C, 'M', u'歷'),
    (0xF98D, 'M', u'轢'),
    (0xF98E, 'M', u'年'),
    (0xF98F, 'M', u'憐'),
    (0xF990, 'M', u'戀'),
    (0xF991, 'M', u'撚'),
    (0xF992, 'M', u'漣'),
    (0xF993, 'M', u'煉'),
    (0xF994, 'M', u'璉'),
    (0xF995, 'M', u'秊'),
    (0xF996, 'M', u'練'),
    (0xF997, 'M', u'聯'),
    (0xF998, 'M', u'輦'),
    (0xF999, 'M', u'蓮'),
    (0xF99A, 'M', u'連'),
    (0xF99B, 'M', u'鍊'),
    (0xF99C, 'M', u'列'),
    (0xF99D, 'M', u'劣'),
    (0xF99E, 'M', u'咽'),
    (0xF99F, 'M', u'烈'),
    (0xF9A0, 'M', u'裂'),
    (0xF9A1, 'M', u'說'),
    (0xF9A2, 'M', u'廉'),
    (0xF9A3, 'M', u'念'),
    (0xF9A4, 'M', u'捻'),
    (0xF9A5, 'M', u'殮'),
    (0xF9A6, 'M', u'簾'),
    (0xF9A7, 'M', u'獵'),
    (0xF9A8, 'M', u'令'),
    (0xF9A9, 'M', u'囹'),
    (0xF9AA, 'M', u'寧'),
    (0xF9AB, 'M', u'嶺'),
    (0xF9AC, 'M', u'怜'),
    (0xF9AD, 'M', u'玲'),
    (0xF9AE, 'M', u'瑩'),
    (0xF9AF, 'M', u'羚'),
    (0xF9B0, 'M', u'聆'),
    (0xF9B1, 'M', u'鈴'),
    (0xF9B2, 'M', u'零'),
    (0xF9B3, 'M', u'靈'),
    (0xF9B4, 'M', u'領'),
    (0xF9B5, 'M', u'例'),
    (0xF9B6, 'M', u'禮'),
    (0xF9B7, 'M', u'醴'),
    (0xF9B8, 'M', u'隸'),
    (0xF9B9, 'M', u'惡'),
    (0xF9BA, 'M', u'了'),
    (0xF9BB, 'M', u'僚'),
    (0xF9BC, 'M', u'寮'),
    (0xF9BD, 'M', u'尿'),
    (0xF9BE, 'M', u'料'),
    (0xF9BF, 'M', u'樂'),
    (0xF9C0, 'M', u'燎'),
    (0xF9C1, 'M', u'療'),
    (0xF9C2, 'M', u'蓼'),
    (0xF9C3, 'M', u'遼'),
    (0xF9C4, 'M', u'龍'),
    (0xF9C5, 'M', u'暈'),
    (0xF9C6, 'M', u'阮'),
    (0xF9C7, 'M', u'劉'),
    (0xF9C8, 'M', u'杻'),
    (0xF9C9, 'M', u'柳'),
    (0xF9CA, 'M', u'流'),
    (0xF9CB, 'M', u'溜'),
    (0xF9CC, 'M', u'琉'),
    (0xF9CD, 'M', u'留'),
    (0xF9CE, 'M', u'硫'),
    (0xF9CF, 'M', u'紐'),
    (0xF9D0, 'M', u'類'),
    (0xF9D1, 'M', u'六'),
    (0xF9D2, 'M', u'戮'),
    (0xF9D3, 'M', u'陸'),
    (0xF9D4, 'M', u'倫'),
    (0xF9D5, 'M', u'崙'),
    (0xF9D6, 'M', u'淪'),
    (0xF9D7, 'M', u'輪'),
    (0xF9D8, 'M', u'律'),
    (0xF9D9, 'M', u'慄'),
    (0xF9DA, 'M', u'栗'),
    (0xF9DB, 'M', u'率'),
    (0xF9DC, 'M', u'隆'),
    (0xF9DD, 'M', u'利'),
    ]

def _seg_41():
    return [
    (0xF9DE, 'M', u'吏'),
    (0xF9DF, 'M', u'履'),
    (0xF9E0, 'M', u'易'),
    (0xF9E1, 'M', u'李'),
    (0xF9E2, 'M', u'梨'),
    (0xF9E3, 'M', u'泥'),
    (0xF9E4, 'M', u'理'),
    (0xF9E5, 'M', u'痢'),
    (0xF9E6, 'M', u'罹'),
    (0xF9E7, 'M', u'裏'),
    (0xF9E8, 'M', u'裡'),
    (0xF9E9, 'M', u'里'),
    (0xF9EA, 'M', u'離'),
    (0xF9EB, 'M', u'匿'),
    (0xF9EC, 'M', u'溺'),
    (0xF9ED, 'M', u'吝'),
    (0xF9EE, 'M', u'燐'),
    (0xF9EF, 'M', u'璘'),
    (0xF9F0, 'M', u'藺'),
    (0xF9F1, 'M', u'隣'),
    (0xF9F2, 'M', u'鱗'),
    (0xF9F3, 'M', u'麟'),
    (0xF9F4, 'M', u'林'),
    (0xF9F5, 'M', u'淋'),
    (0xF9F6, 'M', u'臨'),
    (0xF9F7, 'M', u'立'),
    (0xF9F8, 'M', u'笠'),
    (0xF9F9, 'M', u'粒'),
    (0xF9FA, 'M', u'狀'),
    (0xF9FB, 'M', u'炙'),
    (0xF9FC, 'M', u'識'),
    (0xF9FD, 'M', u'什'),
    (0xF9FE, 'M', u'茶'),
    (0xF9FF, 'M', u'刺'),
    (0xFA00, 'M', u'切'),
    (0xFA01, 'M', u'度'),
    (0xFA02, 'M', u'拓'),
    (0xFA03, 'M', u'糖'),
    (0xFA04, 'M', u'宅'),
    (0xFA05, 'M', u'洞'),
    (0xFA06, 'M', u'暴'),
    (0xFA07, 'M', u'輻'),
    (0xFA08, 'M', u'行'),
    (0xFA09, 'M', u'降'),
    (0xFA0A, 'M', u'見'),
    (0xFA0B, 'M', u'廓'),
    (0xFA0C, 'M', u'兀'),
    (0xFA0D, 'M', u'嗀'),
    (0xFA0E, 'V'),
    (0xFA10, 'M', u'塚'),
    (0xFA11, 'V'),
    (0xFA12, 'M', u'晴'),
    (0xFA13, 'V'),
    (0xFA15, 'M', u'凞'),
    (0xFA16, 'M', u'猪'),
    (0xFA17, 'M', u'益'),
    (0xFA18, 'M', u'礼'),
    (0xFA19, 'M', u'神'),
    (0xFA1A, 'M', u'祥'),
    (0xFA1B, 'M', u'福'),
    (0xFA1C, 'M', u'靖'),
    (0xFA1D, 'M', u'精'),
    (0xFA1E, 'M', u'羽'),
    (0xFA1F, 'V'),
    (0xFA20, 'M', u'蘒'),
    (0xFA21, 'V'),
    (0xFA22, 'M', u'諸'),
    (0xFA23, 'V'),
    (0xFA25, 'M', u'逸'),
    (0xFA26, 'M', u'都'),
    (0xFA27, 'V'),
    (0xFA2A, 'M', u'飯'),
    (0xFA2B, 'M', u'飼'),
    (0xFA2C, 'M', u'館'),
    (0xFA2D, 'M', u'鶴'),
    (0xFA2E, 'M', u'郞'),
    (0xFA2F, 'M', u'隷'),
    (0xFA30, 'M', u'侮'),
    (0xFA31, 'M', u'僧'),
    (0xFA32, 'M', u'免'),
    (0xFA33, 'M', u'勉'),
    (0xFA34, 'M', u'勤'),
    (0xFA35, 'M', u'卑'),
    (0xFA36, 'M', u'喝'),
    (0xFA37, 'M', u'嘆'),
    (0xFA38, 'M', u'器'),
    (0xFA39, 'M', u'塀'),
    (0xFA3A, 'M', u'墨'),
    (0xFA3B, 'M', u'層'),
    (0xFA3C, 'M', u'屮'),
    (0xFA3D, 'M', u'悔'),
    (0xFA3E, 'M', u'慨'),
    (0xFA3F, 'M', u'憎'),
    (0xFA40, 'M', u'懲'),
    (0xFA41, 'M', u'敏'),
    (0xFA42, 'M', u'既'),
    (0xFA43, 'M', u'暑'),
    (0xFA44, 'M', u'梅'),
    (0xFA45, 'M', u'海'),
    (0xFA46, 'M', u'渚'),
    ]

def _seg_42():
    return [
    (0xFA47, 'M', u'漢'),
    (0xFA48, 'M', u'煮'),
    (0xFA49, 'M', u'爫'),
    (0xFA4A, 'M', u'琢'),
    (0xFA4B, 'M', u'碑'),
    (0xFA4C, 'M', u'社'),
    (0xFA4D, 'M', u'祉'),
    (0xFA4E, 'M', u'祈'),
    (0xFA4F, 'M', u'祐'),
    (0xFA50, 'M', u'祖'),
    (0xFA51, 'M', u'祝'),
    (0xFA52, 'M', u'禍'),
    (0xFA53, 'M', u'禎'),
    (0xFA54, 'M', u'穀'),
    (0xFA55, 'M', u'突'),
    (0xFA56, 'M', u'節'),
    (0xFA57, 'M', u'練'),
    (0xFA58, 'M', u'縉'),
    (0xFA59, 'M', u'繁'),
    (0xFA5A, 'M', u'署'),
    (0xFA5B, 'M', u'者'),
    (0xFA5C, 'M', u'臭'),
    (0xFA5D, 'M', u'艹'),
    (0xFA5F, 'M', u'著'),
    (0xFA60, 'M', u'褐'),
    (0xFA61, 'M', u'視'),
    (0xFA62, 'M', u'謁'),
    (0xFA63, 'M', u'謹'),
    (0xFA64, 'M', u'賓'),
    (0xFA65, 'M', u'贈'),
    (0xFA66, 'M', u'辶'),
    (0xFA67, 'M', u'逸'),
    (0xFA68, 'M', u'難'),
    (0xFA69, 'M', u'響'),
    (0xFA6A, 'M', u'頻'),
    (0xFA6B, 'M', u'恵'),
    (0xFA6C, 'M', u'𤋮'),
    (0xFA6D, 'M', u'舘'),
    (0xFA6E, 'X'),
    (0xFA70, 'M', u'並'),
    (0xFA71, 'M', u'况'),
    (0xFA72, 'M', u'全'),
    (0xFA73, 'M', u'侀'),
    (0xFA74, 'M', u'充'),
    (0xFA75, 'M', u'冀'),
    (0xFA76, 'M', u'勇'),
    (0xFA77, 'M', u'勺'),
    (0xFA78, 'M', u'喝'),
    (0xFA79, 'M', u'啕'),
    (0xFA7A, 'M', u'喙'),
    (0xFA7B, 'M', u'嗢'),
    (0xFA7C, 'M', u'塚'),
    (0xFA7D, 'M', u'墳'),
    (0xFA7E, 'M', u'奄'),
    (0xFA7F, 'M', u'奔'),
    (0xFA80, 'M', u'婢'),
    (0xFA81, 'M', u'嬨'),
    (0xFA82, 'M', u'廒'),
    (0xFA83, 'M', u'廙'),
    (0xFA84, 'M', u'彩'),
    (0xFA85, 'M', u'徭'),
    (0xFA86, 'M', u'惘'),
    (0xFA87, 'M', u'慎'),
    (0xFA88, 'M', u'愈'),
    (0xFA89, 'M', u'憎'),
    (0xFA8A, 'M', u'慠'),
    (0xFA8B, 'M', u'懲'),
    (0xFA8C, 'M', u'戴'),
    (0xFA8D, 'M', u'揄'),
    (0xFA8E, 'M', u'搜'),
    (0xFA8F, 'M', u'摒'),
    (0xFA90, 'M', u'敖'),
    (0xFA91, 'M', u'晴'),
    (0xFA92, 'M', u'朗'),
    (0xFA93, 'M', u'望'),
    (0xFA94, 'M', u'杖'),
    (0xFA95, 'M', u'歹'),
    (0xFA96, 'M', u'殺'),
    (0xFA97, 'M', u'流'),
    (0xFA98, 'M', u'滛'),
    (0xFA99, 'M', u'滋'),
    (0xFA9A, 'M', u'漢'),
    (0xFA9B, 'M', u'瀞'),
    (0xFA9C, 'M', u'煮'),
    (0xFA9D, 'M', u'瞧'),
    (0xFA9E, 'M', u'爵'),
    (0xFA9F, 'M', u'犯'),
    (0xFAA0, 'M', u'猪'),
    (0xFAA1, 'M', u'瑱'),
    (0xFAA2, 'M', u'甆'),
    (0xFAA3, 'M', u'画'),
    (0xFAA4, 'M', u'瘝'),
    (0xFAA5, 'M', u'瘟'),
    (0xFAA6, 'M', u'益'),
    (0xFAA7, 'M', u'盛'),
    (0xFAA8, 'M', u'直'),
    (0xFAA9, 'M', u'睊'),
    (0xFAAA, 'M', u'着'),
    (0xFAAB, 'M', u'磌'),
    (0xFAAC, 'M', u'窱'),
    ]

def _seg_43():
    return [
    (0xFAAD, 'M', u'節'),
    (0xFAAE, 'M', u'类'),
    (0xFAAF, 'M', u'絛'),
    (0xFAB0, 'M', u'練'),
    (0xFAB1, 'M', u'缾'),
    (0xFAB2, 'M', u'者'),
    (0xFAB3, 'M', u'荒'),
    (0xFAB4, 'M', u'華'),
    (0xFAB5, 'M', u'蝹'),
    (0xFAB6, 'M', u'襁'),
    (0xFAB7, 'M', u'覆'),
    (0xFAB8, 'M', u'視'),
    (0xFAB9, 'M', u'調'),
    (0xFABA, 'M', u'諸'),
    (0xFABB, 'M', u'請'),
    (0xFABC, 'M', u'謁'),
    (0xFABD, 'M', u'諾'),
    (0xFABE, 'M', u'諭'),
    (0xFABF, 'M', u'謹'),
    (0xFAC0, 'M', u'變'),
    (0xFAC1, 'M', u'贈'),
    (0xFAC2, 'M', u'輸'),
    (0xFAC3, 'M', u'遲'),
    (0xFAC4, 'M', u'醙'),
    (0xFAC5, 'M', u'鉶'),
    (0xFAC6, 'M', u'陼'),
    (0xFAC7, 'M', u'難'),
    (0xFAC8, 'M', u'靖'),
    (0xFAC9, 'M', u'韛'),
    (0xFACA, 'M', u'響'),
    (0xFACB, 'M', u'頋'),
    (0xFACC, 'M', u'頻'),
    (0xFACD, 'M', u'鬒'),
    (0xFACE, 'M', u'龜'),
    (0xFACF, 'M', u'𢡊'),
    (0xFAD0, 'M', u'𢡄'),
    (0xFAD1, 'M', u'𣏕'),
    (0xFAD2, 'M', u'㮝'),
    (0xFAD3, 'M', u'䀘'),
    (0xFAD4, 'M', u'䀹'),
    (0xFAD5, 'M', u'𥉉'),
    (0xFAD6, 'M', u'𥳐'),
    (0xFAD7, 'M', u'𧻓'),
    (0xFAD8, 'M', u'齃'),
    (0xFAD9, 'M', u'龎'),
    (0xFADA, 'X'),
    (0xFB00, 'M', u'ff'),
    (0xFB01, 'M', u'fi'),
    (0xFB02, 'M', u'fl'),
    (0xFB03, 'M', u'ffi'),
    (0xFB04, 'M', u'ffl'),
    (0xFB05, 'M', u'st'),
    (0xFB07, 'X'),
    (0xFB13, 'M', u'մն'),
    (0xFB14, 'M', u'մե'),
    (0xFB15, 'M', u'մի'),
    (0xFB16, 'M', u'վն'),
    (0xFB17, 'M', u'մխ'),
    (0xFB18, 'X'),
    (0xFB1D, 'M', u'יִ'),
    (0xFB1E, 'V'),
    (0xFB1F, 'M', u'ײַ'),
    (0xFB20, 'M', u'ע'),
    (0xFB21, 'M', u'א'),
    (0xFB22, 'M', u'ד'),
    (0xFB23, 'M', u'ה'),
    (0xFB24, 'M', u'כ'),
    (0xFB25, 'M', u'ל'),
    (0xFB26, 'M', u'ם'),
    (0xFB27, 'M', u'ר'),
    (0xFB28, 'M', u'ת'),
    (0xFB29, '3', u'+'),
    (0xFB2A, 'M', u'שׁ'),
    (0xFB2B, 'M', u'שׂ'),
    (0xFB2C, 'M', u'שּׁ'),
    (0xFB2D, 'M', u'שּׂ'),
    (0xFB2E, 'M', u'אַ'),
    (0xFB2F, 'M', u'אָ'),
    (0xFB30, 'M', u'אּ'),
    (0xFB31, 'M', u'בּ'),
    (0xFB32, 'M', u'גּ'),
    (0xFB33, 'M', u'דּ'),
    (0xFB34, 'M', u'הּ'),
    (0xFB35, 'M', u'וּ'),
    (0xFB36, 'M', u'זּ'),
    (0xFB37, 'X'),
    (0xFB38, 'M', u'טּ'),
    (0xFB39, 'M', u'יּ'),
    (0xFB3A, 'M', u'ךּ'),
    (0xFB3B, 'M', u'כּ'),
    (0xFB3C, 'M', u'לּ'),
    (0xFB3D, 'X'),
    (0xFB3E, 'M', u'מּ'),
    (0xFB3F, 'X'),
    (0xFB40, 'M', u'נּ'),
    (0xFB41, 'M', u'סּ'),
    (0xFB42, 'X'),
    (0xFB43, 'M', u'ףּ'),
    (0xFB44, 'M', u'פּ'),
    (0xFB45, 'X'),
    ]

def _seg_44():
    return [
    (0xFB46, 'M', u'צּ'),
    (0xFB47, 'M', u'קּ'),
    (0xFB48, 'M', u'רּ'),
    (0xFB49, 'M', u'שּ'),
    (0xFB4A, 'M', u'תּ'),
    (0xFB4B, 'M', u'וֹ'),
    (0xFB4C, 'M', u'בֿ'),
    (0xFB4D, 'M', u'כֿ'),
    (0xFB4E, 'M', u'פֿ'),
    (0xFB4F, 'M', u'אל'),
    (0xFB50, 'M', u'ٱ'),
    (0xFB52, 'M', u'ٻ'),
    (0xFB56, 'M', u'پ'),
    (0xFB5A, 'M', u'ڀ'),
    (0xFB5E, 'M', u'ٺ'),
    (0xFB62, 'M', u'ٿ'),
    (0xFB66, 'M', u'ٹ'),
    (0xFB6A, 'M', u'ڤ'),
    (0xFB6E, 'M', u'ڦ'),
    (0xFB72, 'M', u'ڄ'),
    (0xFB76, 'M', u'ڃ'),
    (0xFB7A, 'M', u'چ'),
    (0xFB7E, 'M', u'ڇ'),
    (0xFB82, 'M', u'ڍ'),
    (0xFB84, 'M', u'ڌ'),
    (0xFB86, 'M', u'ڎ'),
    (0xFB88, 'M', u'ڈ'),
    (0xFB8A, 'M', u'ژ'),
    (0xFB8C, 'M', u'ڑ'),
    (0xFB8E, 'M', u'ک'),
    (0xFB92, 'M', u'گ'),
    (0xFB96, 'M', u'ڳ'),
    (0xFB9A, 'M', u'ڱ'),
    (0xFB9E, 'M', u'ں'),
    (0xFBA0, 'M', u'ڻ'),
    (0xFBA4, 'M', u'ۀ'),
    (0xFBA6, 'M', u'ہ'),
    (0xFBAA, 'M', u'ھ'),
    (0xFBAE, 'M', u'ے'),
    (0xFBB0, 'M', u'ۓ'),
    (0xFBB2, 'V'),
    (0xFBC2, 'X'),
    (0xFBD3, 'M', u'ڭ'),
    (0xFBD7, 'M', u'ۇ'),
    (0xFBD9, 'M', u'ۆ'),
    (0xFBDB, 'M', u'ۈ'),
    (0xFBDD, 'M', u'ۇٴ'),
    (0xFBDE, 'M', u'ۋ'),
    (0xFBE0, 'M', u'ۅ'),
    (0xFBE2, 'M', u'ۉ'),
    (0xFBE4, 'M', u'ې'),
    (0xFBE8, 'M', u'ى'),
    (0xFBEA, 'M', u'ئا'),
    (0xFBEC, 'M', u'ئە'),
    (0xFBEE, 'M', u'ئو'),
    (0xFBF0, 'M', u'ئۇ'),
    (0xFBF2, 'M', u'ئۆ'),
    (0xFBF4, 'M', u'ئۈ'),
    (0xFBF6, 'M', u'ئې'),
    (0xFBF9, 'M', u'ئى'),
    (0xFBFC, 'M', u'ی'),
    (0xFC00, 'M', u'ئج'),
    (0xFC01, 'M', u'ئح'),
    (0xFC02, 'M', u'ئم'),
    (0xFC03, 'M', u'ئى'),
    (0xFC04, 'M', u'ئي'),
    (0xFC05, 'M', u'بج'),
    (0xFC06, 'M', u'بح'),
    (0xFC07, 'M', u'بخ'),
    (0xFC08, 'M', u'بم'),
    (0xFC09, 'M', u'بى'),
    (0xFC0A, 'M', u'بي'),
    (0xFC0B, 'M', u'تج'),
    (0xFC0C, 'M', u'تح'),
    (0xFC0D, 'M', u'تخ'),
    (0xFC0E, 'M', u'تم'),
    (0xFC0F, 'M', u'تى'),
    (0xFC10, 'M', u'تي'),
    (0xFC11, 'M', u'ثج'),
    (0xFC12, 'M', u'ثم'),
    (0xFC13, 'M', u'ثى'),
    (0xFC14, 'M', u'ثي'),
    (0xFC15, 'M', u'جح'),
    (0xFC16, 'M', u'جم'),
    (0xFC17, 'M', u'حج'),
    (0xFC18, 'M', u'حم'),
    (0xFC19, 'M', u'خج'),
    (0xFC1A, 'M', u'خح'),
    (0xFC1B, 'M', u'خم'),
    (0xFC1C, 'M', u'سج'),
    (0xFC1D, 'M', u'سح'),
    (0xFC1E, 'M', u'سخ'),
    (0xFC1F, 'M', u'سم'),
    (0xFC20, 'M', u'صح'),
    (0xFC21, 'M', u'صم'),
    (0xFC22, 'M', u'ضج'),
    (0xFC23, 'M', u'ضح'),
    (0xFC24, 'M', u'ضخ'),
    (0xFC25, 'M', u'ضم'),
    (0xFC26, 'M', u'طح'),
    ]

def _seg_45():
    return [
    (0xFC27, 'M', u'طم'),
    (0xFC28, 'M', u'ظم'),
    (0xFC29, 'M', u'عج'),
    (0xFC2A, 'M', u'عم'),
    (0xFC2B, 'M', u'غج'),
    (0xFC2C, 'M', u'غم'),
    (0xFC2D, 'M', u'فج'),
    (0xFC2E, 'M', u'فح'),
    (0xFC2F, 'M', u'فخ'),
    (0xFC30, 'M', u'فم'),
    (0xFC31, 'M', u'فى'),
    (0xFC32, 'M', u'في'),
    (0xFC33, 'M', u'قح'),
    (0xFC34, 'M', u'قم'),
    (0xFC35, 'M', u'قى'),
    (0xFC36, 'M', u'قي'),
    (0xFC37, 'M', u'كا'),
    (0xFC38, 'M', u'كج'),
    (0xFC39, 'M', u'كح'),
    (0xFC3A, 'M', u'كخ'),
    (0xFC3B, 'M', u'كل'),
    (0xFC3C, 'M', u'كم'),
    (0xFC3D, 'M', u'كى'),
    (0xFC3E, 'M', u'كي'),
    (0xFC3F, 'M', u'لج'),
    (0xFC40, 'M', u'لح'),
    (0xFC41, 'M', u'لخ'),
    (0xFC42, 'M', u'لم'),
    (0xFC43, 'M', u'لى'),
    (0xFC44, 'M', u'لي'),
    (0xFC45, 'M', u'مج'),
    (0xFC46, 'M', u'مح'),
    (0xFC47, 'M', u'مخ'),
    (0xFC48, 'M', u'مم'),
    (0xFC49, 'M', u'مى'),
    (0xFC4A, 'M', u'مي'),
    (0xFC4B, 'M', u'نج'),
    (0xFC4C, 'M', u'نح'),
    (0xFC4D, 'M', u'نخ'),
    (0xFC4E, 'M', u'نم'),
    (0xFC4F, 'M', u'نى'),
    (0xFC50, 'M', u'ني'),
    (0xFC51, 'M', u'هج'),
    (0xFC52, 'M', u'هم'),
    (0xFC53, 'M', u'هى'),
    (0xFC54, 'M', u'هي'),
    (0xFC55, 'M', u'يج'),
    (0xFC56, 'M', u'يح'),
    (0xFC57, 'M', u'يخ'),
    (0xFC58, 'M', u'يم'),
    (0xFC59, 'M', u'يى'),
    (0xFC5A, 'M', u'يي'),
    (0xFC5B, 'M', u'ذٰ'),
    (0xFC5C, 'M', u'رٰ'),
    (0xFC5D, 'M', u'ىٰ'),
    (0xFC5E, '3', u' ٌّ'),
    (0xFC5F, '3', u' ٍّ'),
    (0xFC60, '3', u' َّ'),
    (0xFC61, '3', u' ُّ'),
    (0xFC62, '3', u' ِّ'),
    (0xFC63, '3', u' ّٰ'),
    (0xFC64, 'M', u'ئر'),
    (0xFC65, 'M', u'ئز'),
    (0xFC66, 'M', u'ئم'),
    (0xFC67, 'M', u'ئن'),
    (0xFC68, 'M', u'ئى'),
    (0xFC69, 'M', u'ئي'),
    (0xFC6A, 'M', u'بر'),
    (0xFC6B, 'M', u'بز'),
    (0xFC6C, 'M', u'بم'),
    (0xFC6D, 'M', u'بن'),
    (0xFC6E, 'M', u'بى'),
    (0xFC6F, 'M', u'بي'),
    (0xFC70, 'M', u'تر'),
    (0xFC71, 'M', u'تز'),
    (0xFC72, 'M', u'تم'),
    (0xFC73, 'M', u'تن'),
    (0xFC74, 'M', u'تى'),
    (0xFC75, 'M', u'تي'),
    (0xFC76, 'M', u'ثر'),
    (0xFC77, 'M', u'ثز'),
    (0xFC78, 'M', u'ثم'),
    (0xFC79, 'M', u'ثن'),
    (0xFC7A, 'M', u'ثى'),
    (0xFC7B, 'M', u'ثي'),
    (0xFC7C, 'M', u'فى'),
    (0xFC7D, 'M', u'في'),
    (0xFC7E, 'M', u'قى'),
    (0xFC7F, 'M', u'قي'),
    (0xFC80, 'M', u'كا'),
    (0xFC81, 'M', u'كل'),
    (0xFC82, 'M', u'كم'),
    (0xFC83, 'M', u'كى'),
    (0xFC84, 'M', u'كي'),
    (0xFC85, 'M', u'لم'),
    (0xFC86, 'M', u'لى'),
    (0xFC87, 'M', u'لي'),
    (0xFC88, 'M', u'ما'),
    (0xFC89, 'M', u'مم'),
    (0xFC8A, 'M', u'نر'),
    ]

def _seg_46():
    return [
    (0xFC8B, 'M', u'نز'),
    (0xFC8C, 'M', u'نم'),
    (0xFC8D, 'M', u'نن'),
    (0xFC8E, 'M', u'نى'),
    (0xFC8F, 'M', u'ني'),
    (0xFC90, 'M', u'ىٰ'),
    (0xFC91, 'M', u'ير'),
    (0xFC92, 'M', u'يز'),
    (0xFC93, 'M', u'يم'),
    (0xFC94, 'M', u'ين'),
    (0xFC95, 'M', u'يى'),
    (0xFC96, 'M', u'يي'),
    (0xFC97, 'M', u'ئج'),
    (0xFC98, 'M', u'ئح'),
    (0xFC99, 'M', u'ئخ'),
    (0xFC9A, 'M', u'ئم'),
    (0xFC9B, 'M', u'ئه'),
    (0xFC9C, 'M', u'بج'),
    (0xFC9D, 'M', u'بح'),
    (0xFC9E, 'M', u'بخ'),
    (0xFC9F, 'M', u'بم'),
    (0xFCA0, 'M', u'به'),
    (0xFCA1, 'M', u'تج'),
    (0xFCA2, 'M', u'تح'),
    (0xFCA3, 'M', u'تخ'),
    (0xFCA4, 'M', u'تم'),
    (0xFCA5, 'M', u'ته'),
    (0xFCA6, 'M', u'ثم'),
    (0xFCA7, 'M', u'جح'),
    (0xFCA8, 'M', u'جم'),
    (0xFCA9, 'M', u'حج'),
    (0xFCAA, 'M', u'حم'),
    (0xFCAB, 'M', u'خج'),
    (0xFCAC, 'M', u'خم'),
    (0xFCAD, 'M', u'سج'),
    (0xFCAE, 'M', u'سح'),
    (0xFCAF, 'M', u'سخ'),
    (0xFCB0, 'M', u'سم'),
    (0xFCB1, 'M', u'صح'),
    (0xFCB2, 'M', u'صخ'),
    (0xFCB3, 'M', u'صم'),
    (0xFCB4, 'M', u'ضج'),
    (0xFCB5, 'M', u'ضح'),
    (0xFCB6, 'M', u'ضخ'),
    (0xFCB7, 'M', u'ضم'),
    (0xFCB8, 'M', u'طح'),
    (0xFCB9, 'M', u'ظم'),
    (0xFCBA, 'M', u'عج'),
    (0xFCBB, 'M', u'عم'),
    (0xFCBC, 'M', u'غج'),
    (0xFCBD, 'M', u'غم'),
    (0xFCBE, 'M', u'فج'),
    (0xFCBF, 'M', u'فح'),
    (0xFCC0, 'M', u'فخ'),
    (0xFCC1, 'M', u'فم'),
    (0xFCC2, 'M', u'قح'),
    (0xFCC3, 'M', u'قم'),
    (0xFCC4, 'M', u'كج'),
    (0xFCC5, 'M', u'كح'),
    (0xFCC6, 'M', u'كخ'),
    (0xFCC7, 'M', u'كل'),
    (0xFCC8, 'M', u'كم'),
    (0xFCC9, 'M', u'لج'),
    (0xFCCA, 'M', u'لح'),
    (0xFCCB, 'M', u'لخ'),
    (0xFCCC, 'M', u'لم'),
    (0xFCCD, 'M', u'له'),
    (0xFCCE, 'M', u'مج'),
    (0xFCCF, 'M', u'مح'),
    (0xFCD0, 'M', u'مخ'),
    (0xFCD1, 'M', u'مم'),
    (0xFCD2, 'M', u'نج'),
    (0xFCD3, 'M', u'نح'),
    (0xFCD4, 'M', u'نخ'),
    (0xFCD5, 'M', u'نم'),
    (0xFCD6, 'M', u'نه'),
    (0xFCD7, 'M', u'هج'),
    (0xFCD8, 'M', u'هم'),
    (0xFCD9, 'M', u'هٰ'),
    (0xFCDA, 'M', u'يج'),
    (0xFCDB, 'M', u'يح'),
    (0xFCDC, 'M', u'يخ'),
    (0xFCDD, 'M', u'يم'),
    (0xFCDE, 'M', u'يه'),
    (0xFCDF, 'M', u'ئم'),
    (0xFCE0, 'M', u'ئه'),
    (0xFCE1, 'M', u'بم'),
    (0xFCE2, 'M', u'به'),
    (0xFCE3, 'M', u'تم'),
    (0xFCE4, 'M', u'ته'),
    (0xFCE5, 'M', u'ثم'),
    (0xFCE6, 'M', u'ثه'),
    (0xFCE7, 'M', u'سم'),
    (0xFCE8, 'M', u'سه'),
    (0xFCE9, 'M', u'شم'),
    (0xFCEA, 'M', u'شه'),
    (0xFCEB, 'M', u'كل'),
    (0xFCEC, 'M', u'كم'),
    (0xFCED, 'M', u'لم'),
    (0xFCEE, 'M', u'نم'),
    ]

def _seg_47():
    return [
    (0xFCEF, 'M', u'نه'),
    (0xFCF0, 'M', u'يم'),
    (0xFCF1, 'M', u'يه'),
    (0xFCF2, 'M', u'ـَّ'),
    (0xFCF3, 'M', u'ـُّ'),
    (0xFCF4, 'M', u'ـِّ'),
    (0xFCF5, 'M', u'طى'),
    (0xFCF6, 'M', u'طي'),
    (0xFCF7, 'M', u'عى'),
    (0xFCF8, 'M', u'عي'),
    (0xFCF9, 'M', u'غى'),
    (0xFCFA, 'M', u'غي'),
    (0xFCFB, 'M', u'سى'),
    (0xFCFC, 'M', u'سي'),
    (0xFCFD, 'M', u'شى'),
    (0xFCFE, 'M', u'شي'),
    (0xFCFF, 'M', u'حى'),
    (0xFD00, 'M', u'حي'),
    (0xFD01, 'M', u'جى'),
    (0xFD02, 'M', u'جي'),
    (0xFD03, 'M', u'خى'),
    (0xFD04, 'M', u'خي'),
    (0xFD05, 'M', u'صى'),
    (0xFD06, 'M', u'صي'),
    (0xFD07, 'M', u'ضى'),
    (0xFD08, 'M', u'ضي'),
    (0xFD09, 'M', u'شج'),
    (0xFD0A, 'M', u'شح'),
    (0xFD0B, 'M', u'شخ'),
    (0xFD0C, 'M', u'شم'),
    (0xFD0D, 'M', u'شر'),
    (0xFD0E, 'M', u'سر'),
    (0xFD0F, 'M', u'صر'),
    (0xFD10, 'M', u'ضر'),
    (0xFD11, 'M', u'طى'),
    (0xFD12, 'M', u'طي'),
    (0xFD13, 'M', u'عى'),
    (0xFD14, 'M', u'عي'),
    (0xFD15, 'M', u'غى'),
    (0xFD16, 'M', u'غي'),
    (0xFD17, 'M', u'سى'),
    (0xFD18, 'M', u'سي'),
    (0xFD19, 'M', u'شى'),
    (0xFD1A, 'M', u'شي'),
    (0xFD1B, 'M', u'حى'),
    (0xFD1C, 'M', u'حي'),
    (0xFD1D, 'M', u'جى'),
    (0xFD1E, 'M', u'جي'),
    (0xFD1F, 'M', u'خى'),
    (0xFD20, 'M', u'خي'),
    (0xFD21, 'M', u'صى'),
    (0xFD22, 'M', u'صي'),
    (0xFD23, 'M', u'ضى'),
    (0xFD24, 'M', u'ضي'),
    (0xFD25, 'M', u'شج'),
    (0xFD26, 'M', u'شح'),
    (0xFD27, 'M', u'شخ'),
    (0xFD28, 'M', u'شم'),
    (0xFD29, 'M', u'شر'),
    (0xFD2A, 'M', u'سر'),
    (0xFD2B, 'M', u'صر'),
    (0xFD2C, 'M', u'ضر'),
    (0xFD2D, 'M', u'شج'),
    (0xFD2E, 'M', u'شح'),
    (0xFD2F, 'M', u'شخ'),
    (0xFD30, 'M', u'شم'),
    (0xFD31, 'M', u'سه'),
    (0xFD32, 'M', u'شه'),
    (0xFD33, 'M', u'طم'),
    (0xFD34, 'M', u'سج'),
    (0xFD35, 'M', u'سح'),
    (0xFD36, 'M', u'سخ'),
    (0xFD37, 'M', u'شج'),
    (0xFD38, 'M', u'شح'),
    (0xFD39, 'M', u'شخ'),
    (0xFD3A, 'M', u'طم'),
    (0xFD3B, 'M', u'ظم'),
    (0xFD3C, 'M', u'اً'),
    (0xFD3E, 'V'),
    (0xFD40, 'X'),
    (0xFD50, 'M', u'تجم'),
    (0xFD51, 'M', u'تحج'),
    (0xFD53, 'M', u'تحم'),
    (0xFD54, 'M', u'تخم'),
    (0xFD55, 'M', u'تمج'),
    (0xFD56, 'M', u'تمح'),
    (0xFD57, 'M', u'تمخ'),
    (0xFD58, 'M', u'جمح'),
    (0xFD5A, 'M', u'حمي'),
    (0xFD5B, 'M', u'حمى'),
    (0xFD5C, 'M', u'سحج'),
    (0xFD5D, 'M', u'سجح'),
    (0xFD5E, 'M', u'سجى'),
    (0xFD5F, 'M', u'سمح'),
    (0xFD61, 'M', u'سمج'),
    (0xFD62, 'M', u'سمم'),
    (0xFD64, 'M', u'صحح'),
    (0xFD66, 'M', u'صمم'),
    (0xFD67, 'M', u'شحم'),
    (0xFD69, 'M', u'شجي'),
    ]

def _seg_48():
    return [
    (0xFD6A, 'M', u'شمخ'),
    (0xFD6C, 'M', u'شمم'),
    (0xFD6E, 'M', u'ضحى'),
    (0xFD6F, 'M', u'ضخم'),
    (0xFD71, 'M', u'طمح'),
    (0xFD73, 'M', u'طمم'),
    (0xFD74, 'M', u'طمي'),
    (0xFD75, 'M', u'عجم'),
    (0xFD76, 'M', u'عمم'),
    (0xFD78, 'M', u'عمى'),
    (0xFD79, 'M', u'غمم'),
    (0xFD7A, 'M', u'غمي'),
    (0xFD7B, 'M', u'غمى'),
    (0xFD7C, 'M', u'فخم'),
    (0xFD7E, 'M', u'قمح'),
    (0xFD7F, 'M', u'قمم'),
    (0xFD80, 'M', u'لحم'),
    (0xFD81, 'M', u'لحي'),
    (0xFD82, 'M', u'لحى'),
    (0xFD83, 'M', u'لجج'),
    (0xFD85, 'M', u'لخم'),
    (0xFD87, 'M', u'لمح'),
    (0xFD89, 'M', u'محج'),
    (0xFD8A, 'M', u'محم'),
    (0xFD8B, 'M', u'محي'),
    (0xFD8C, 'M', u'مجح'),
    (0xFD8D, 'M', u'مجم'),
    (0xFD8E, 'M', u'مخج'),
    (0xFD8F, 'M', u'مخم'),
    (0xFD90, 'X'),
    (0xFD92, 'M', u'مجخ'),
    (0xFD93, 'M', u'همج'),
    (0xFD94, 'M', u'همم'),
    (0xFD95, 'M', u'نحم'),
    (0xFD96, 'M', u'نحى'),
    (0xFD97, 'M', u'نجم'),
    (0xFD99, 'M', u'نجى'),
    (0xFD9A, 'M', u'نمي'),
    (0xFD9B, 'M', u'نمى'),
    (0xFD9C, 'M', u'يمم'),
    (0xFD9E, 'M', u'بخي'),
    (0xFD9F, 'M', u'تجي'),
    (0xFDA0, 'M', u'تجى'),
    (0xFDA1, 'M', u'تخي'),
    (0xFDA2, 'M', u'تخى'),
    (0xFDA3, 'M', u'تمي'),
    (0xFDA4, 'M', u'تمى'),
    (0xFDA5, 'M', u'جمي'),
    (0xFDA6, 'M', u'جحى'),
    (0xFDA7, 'M', u'جمى'),
    (0xFDA8, 'M', u'سخى'),
    (0xFDA9, 'M', u'صحي'),
    (0xFDAA, 'M', u'شحي'),
    (0xFDAB, 'M', u'ضحي'),
    (0xFDAC, 'M', u'لجي'),
    (0xFDAD, 'M', u'لمي'),
    (0xFDAE, 'M', u'يحي'),
    (0xFDAF, 'M', u'يجي'),
    (0xFDB0, 'M', u'يمي'),
    (0xFDB1, 'M', u'ممي'),
    (0xFDB2, 'M', u'قمي'),
    (0xFDB3, 'M', u'نحي'),
    (0xFDB4, 'M', u'قمح'),
    (0xFDB5, 'M', u'لحم'),
    (0xFDB6, 'M', u'عمي'),
    (0xFDB7, 'M', u'كمي'),
    (0xFDB8, 'M', u'نجح'),
    (0xFDB9, 'M', u'مخي'),
    (0xFDBA, 'M', u'لجم'),
    (0xFDBB, 'M', u'كمم'),
    (0xFDBC, 'M', u'لجم'),
    (0xFDBD, 'M', u'نجح'),
    (0xFDBE, 'M', u'جحي'),
    (0xFDBF, 'M', u'حجي'),
    (0xFDC0, 'M', u'مجي'),
    (0xFDC1, 'M', u'فمي'),
    (0xFDC2, 'M', u'بحي'),
    (0xFDC3, 'M', u'كمم'),
    (0xFDC4, 'M', u'عجم'),
    (0xFDC5, 'M', u'صمم'),
    (0xFDC6, 'M', u'سخي'),
    (0xFDC7, 'M', u'نجي'),
    (0xFDC8, 'X'),
    (0xFDF0, 'M', u'صلے'),
    (0xFDF1, 'M', u'قلے'),
    (0xFDF2, 'M', u'الله'),
    (0xFDF3, 'M', u'اكبر'),
    (0xFDF4, 'M', u'محمد'),
    (0xFDF5, 'M', u'صلعم'),
    (0xFDF6, 'M', u'رسول'),
    (0xFDF7, 'M', u'عليه'),
    (0xFDF8, 'M', u'وسلم'),
    (0xFDF9, 'M', u'صلى'),
    (0xFDFA, '3', u'صلى الله عليه وسلم'),
    (0xFDFB, '3', u'جل جلاله'),
    (0xFDFC, 'M', u'ریال'),
    (0xFDFD, 'V'),
    (0xFDFE, 'X'),
    (0xFE00, 'I'),
    (0xFE10, '3', u','),
    ]

def _seg_49():
    return [
    (0xFE11, 'M', u'、'),
    (0xFE12, 'X'),
    (0xFE13, '3', u':'),
    (0xFE14, '3', u';'),
    (0xFE15, '3', u'!'),
    (0xFE16, '3', u'?'),
    (0xFE17, 'M', u'〖'),
    (0xFE18, 'M', u'〗'),
    (0xFE19, 'X'),
    (0xFE20, 'V'),
    (0xFE30, 'X'),
    (0xFE31, 'M', u'—'),
    (0xFE32, 'M', u'–'),
    (0xFE33, '3', u'_'),
    (0xFE35, '3', u'('),
    (0xFE36, '3', u')'),
    (0xFE37, '3', u'{'),
    (0xFE38, '3', u'}'),
    (0xFE39, 'M', u'〔'),
    (0xFE3A, 'M', u'〕'),
    (0xFE3B, 'M', u'【'),
    (0xFE3C, 'M', u'】'),
    (0xFE3D, 'M', u'《'),
    (0xFE3E, 'M', u'》'),
    (0xFE3F, 'M', u'〈'),
    (0xFE40, 'M', u'〉'),
    (0xFE41, 'M', u'「'),
    (0xFE42, 'M', u'」'),
    (0xFE43, 'M', u'『'),
    (0xFE44, 'M', u'』'),
    (0xFE45, 'V'),
    (0xFE47, '3', u'['),
    (0xFE48, '3', u']'),
    (0xFE49, '3', u' ̅'),
    (0xFE4D, '3', u'_'),
    (0xFE50, '3', u','),
    (0xFE51, 'M', u'、'),
    (0xFE52, 'X'),
    (0xFE54, '3', u';'),
    (0xFE55, '3', u':'),
    (0xFE56, '3', u'?'),
    (0xFE57, '3', u'!'),
    (0xFE58, 'M', u'—'),
    (0xFE59, '3', u'('),
    (0xFE5A, '3', u')'),
    (0xFE5B, '3', u'{'),
    (0xFE5C, '3', u'}'),
    (0xFE5D, 'M', u'〔'),
    (0xFE5E, 'M', u'〕'),
    (0xFE5F, '3', u'#'),
    (0xFE60, '3', u'&'),
    (0xFE61, '3', u'*'),
    (0xFE62, '3', u'+'),
    (0xFE63, 'M', u'-'),
    (0xFE64, '3', u'<'),
    (0xFE65, '3', u'>'),
    (0xFE66, '3', u'='),
    (0xFE67, 'X'),
    (0xFE68, '3', u'\\'),
    (0xFE69, '3', u'$'),
    (0xFE6A, '3', u'%'),
    (0xFE6B, '3', u'@'),
    (0xFE6C, 'X'),
    (0xFE70, '3', u' ً'),
    (0xFE71, 'M', u'ـً'),
    (0xFE72, '3', u' ٌ'),
    (0xFE73, 'V'),
    (0xFE74, '3', u' ٍ'),
    (0xFE75, 'X'),
    (0xFE76, '3', u' َ'),
    (0xFE77, 'M', u'ـَ'),
    (0xFE78, '3', u' ُ'),
    (0xFE79, 'M', u'ـُ'),
    (0xFE7A, '3', u' ِ'),
    (0xFE7B, 'M', u'ـِ'),
    (0xFE7C, '3', u' ّ'),
    (0xFE7D, 'M', u'ـّ'),
    (0xFE7E, '3', u' ْ'),
    (0xFE7F, 'M', u'ـْ'),
    (0xFE80, 'M', u'ء'),
    (0xFE81, 'M', u'آ'),
    (0xFE83, 'M', u'أ'),
    (0xFE85, 'M', u'ؤ'),
    (0xFE87, 'M', u'إ'),
    (0xFE89, 'M', u'ئ'),
    (0xFE8D, 'M', u'ا'),
    (0xFE8F, 'M', u'ب'),
    (0xFE93, 'M', u'ة'),
    (0xFE95, 'M', u'ت'),
    (0xFE99, 'M', u'ث'),
    (0xFE9D, 'M', u'ج'),
    (0xFEA1, 'M', u'ح'),
    (0xFEA5, 'M', u'خ'),
    (0xFEA9, 'M', u'د'),
    (0xFEAB, 'M', u'ذ'),
    (0xFEAD, 'M', u'ر'),
    (0xFEAF, 'M', u'ز'),
    (0xFEB1, 'M', u'س'),
    (0xFEB5, 'M', u'ش'),
    (0xFEB9, 'M', u'ص'),
    ]

def _seg_50():
    return [
    (0xFEBD, 'M', u'ض'),
    (0xFEC1, 'M', u'ط'),
    (0xFEC5, 'M', u'ظ'),
    (0xFEC9, 'M', u'ع'),
    (0xFECD, 'M', u'غ'),
    (0xFED1, 'M', u'ف'),
    (0xFED5, 'M', u'ق'),
    (0xFED9, 'M', u'ك'),
    (0xFEDD, 'M', u'ل'),
    (0xFEE1, 'M', u'م'),
    (0xFEE5, 'M', u'ن'),
    (0xFEE9, 'M', u'ه'),
    (0xFEED, 'M', u'و'),
    (0xFEEF, 'M', u'ى'),
    (0xFEF1, 'M', u'ي'),
    (0xFEF5, 'M', u'لآ'),
    (0xFEF7, 'M', u'لأ'),
    (0xFEF9, 'M', u'لإ'),
    (0xFEFB, 'M', u'لا'),
    (0xFEFD, 'X'),
    (0xFEFF, 'I'),
    (0xFF00, 'X'),
    (0xFF01, '3', u'!'),
    (0xFF02, '3', u'"'),
    (0xFF03, '3', u'#'),
    (0xFF04, '3', u'$'),
    (0xFF05, '3', u'%'),
    (0xFF06, '3', u'&'),
    (0xFF07, '3', u'\''),
    (0xFF08, '3', u'('),
    (0xFF09, '3', u')'),
    (0xFF0A, '3', u'*'),
    (0xFF0B, '3', u'+'),
    (0xFF0C, '3', u','),
    (0xFF0D, 'M', u'-'),
    (0xFF0E, 'M', u'.'),
    (0xFF0F, '3', u'/'),
    (0xFF10, 'M', u'0'),
    (0xFF11, 'M', u'1'),
    (0xFF12, 'M', u'2'),
    (0xFF13, 'M', u'3'),
    (0xFF14, 'M', u'4'),
    (0xFF15, 'M', u'5'),
    (0xFF16, 'M', u'6'),
    (0xFF17, 'M', u'7'),
    (0xFF18, 'M', u'8'),
    (0xFF19, 'M', u'9'),
    (0xFF1A, '3', u':'),
    (0xFF1B, '3', u';'),
    (0xFF1C, '3', u'<'),
    (0xFF1D, '3', u'='),
    (0xFF1E, '3', u'>'),
    (0xFF1F, '3', u'?'),
    (0xFF20, '3', u'@'),
    (0xFF21, 'M', u'a'),
    (0xFF22, 'M', u'b'),
    (0xFF23, 'M', u'c'),
    (0xFF24, 'M', u'd'),
    (0xFF25, 'M', u'e'),
    (0xFF26, 'M', u'f'),
    (0xFF27, 'M', u'g'),
    (0xFF28, 'M', u'h'),
    (0xFF29, 'M', u'i'),
    (0xFF2A, 'M', u'j'),
    (0xFF2B, 'M', u'k'),
    (0xFF2C, 'M', u'l'),
    (0xFF2D, 'M', u'm'),
    (0xFF2E, 'M', u'n'),
    (0xFF2F, 'M', u'o'),
    (0xFF30, 'M', u'p'),
    (0xFF31, 'M', u'q'),
    (0xFF32, 'M', u'r'),
    (0xFF33, 'M', u's'),
    (0xFF34, 'M', u't'),
    (0xFF35, 'M', u'u'),
    (0xFF36, 'M', u'v'),
    (0xFF37, 'M', u'w'),
    (0xFF38, 'M', u'x'),
    (0xFF39, 'M', u'y'),
    (0xFF3A, 'M', u'z'),
    (0xFF3B, '3', u'['),
    (0xFF3C, '3', u'\\'),
    (0xFF3D, '3', u']'),
    (0xFF3E, '3', u'^'),
    (0xFF3F, '3', u'_'),
    (0xFF40, '3', u'`'),
    (0xFF41, 'M', u'a'),
    (0xFF42, 'M', u'b'),
    (0xFF43, 'M', u'c'),
    (0xFF44, 'M', u'd'),
    (0xFF45, 'M', u'e'),
    (0xFF46, 'M', u'f'),
    (0xFF47, 'M', u'g'),
    (0xFF48, 'M', u'h'),
    (0xFF49, 'M', u'i'),
    (0xFF4A, 'M', u'j'),
    (0xFF4B, 'M', u'k'),
    (0xFF4C, 'M', u'l'),
    (0xFF4D, 'M', u'm'),
    (0xFF4E, 'M', u'n'),
    ]

def _seg_51():
    return [
    (0xFF4F, 'M', u'o'),
    (0xFF50, 'M', u'p'),
    (0xFF51, 'M', u'q'),
    (0xFF52, 'M', u'r'),
    (0xFF53, 'M', u's'),
    (0xFF54, 'M', u't'),
    (0xFF55, 'M', u'u'),
    (0xFF56, 'M', u'v'),
    (0xFF57, 'M', u'w'),
    (0xFF58, 'M', u'x'),
    (0xFF59, 'M', u'y'),
    (0xFF5A, 'M', u'z'),
    (0xFF5B, '3', u'{'),
    (0xFF5C, '3', u'|'),
    (0xFF5D, '3', u'}'),
    (0xFF5E, '3', u'~'),
    (0xFF5F, 'M', u'⦅'),
    (0xFF60, 'M', u'⦆'),
    (0xFF61, 'M', u'.'),
    (0xFF62, 'M', u'「'),
    (0xFF63, 'M', u'」'),
    (0xFF64, 'M', u'、'),
    (0xFF65, 'M', u'・'),
    (0xFF66, 'M', u'ヲ'),
    (0xFF67, 'M', u'ァ'),
    (0xFF68, 'M', u'ィ'),
    (0xFF69, 'M', u'ゥ'),
    (0xFF6A, 'M', u'ェ'),
    (0xFF6B, 'M', u'ォ'),
    (0xFF6C, 'M', u'ャ'),
    (0xFF6D, 'M', u'ュ'),
    (0xFF6E, 'M', u'ョ'),
    (0xFF6F, 'M', u'ッ'),
    (0xFF70, 'M', u'ー'),
    (0xFF71, 'M', u'ア'),
    (0xFF72, 'M', u'イ'),
    (0xFF73, 'M', u'ウ'),
    (0xFF74, 'M', u'エ'),
    (0xFF75, 'M', u'オ'),
    (0xFF76, 'M', u'カ'),
    (0xFF77, 'M', u'キ'),
    (0xFF78, 'M', u'ク'),
    (0xFF79, 'M', u'ケ'),
    (0xFF7A, 'M', u'コ'),
    (0xFF7B, 'M', u'サ'),
    (0xFF7C, 'M', u'シ'),
    (0xFF7D, 'M', u'ス'),
    (0xFF7E, 'M', u'セ'),
    (0xFF7F, 'M', u'ソ'),
    (0xFF80, 'M', u'タ'),
    (0xFF81, 'M', u'チ'),
    (0xFF82, 'M', u'ツ'),
    (0xFF83, 'M', u'テ'),
    (0xFF84, 'M', u'ト'),
    (0xFF85, 'M', u'ナ'),
    (0xFF86, 'M', u'ニ'),
    (0xFF87, 'M', u'ヌ'),
    (0xFF88, 'M', u'ネ'),
    (0xFF89, 'M', u'ノ'),
    (0xFF8A, 'M', u'ハ'),
    (0xFF8B, 'M', u'ヒ'),
    (0xFF8C, 'M', u'フ'),
    (0xFF8D, 'M', u'ヘ'),
    (0xFF8E, 'M', u'ホ'),
    (0xFF8F, 'M', u'マ'),
    (0xFF90, 'M', u'ミ'),
    (0xFF91, 'M', u'ム'),
    (0xFF92, 'M', u'メ'),
    (0xFF93, 'M', u'モ'),
    (0xFF94, 'M', u'ヤ'),
    (0xFF95, 'M', u'ユ'),
    (0xFF96, 'M', u'ヨ'),
    (0xFF97, 'M', u'ラ'),
    (0xFF98, 'M', u'リ'),
    (0xFF99, 'M', u'ル'),
    (0xFF9A, 'M', u'レ'),
    (0xFF9B, 'M', u'ロ'),
    (0xFF9C, 'M', u'ワ'),
    (0xFF9D, 'M', u'ン'),
    (0xFF9E, 'M', u'゙'),
    (0xFF9F, 'M', u'゚'),
    (0xFFA0, 'X'),
    (0xFFA1, 'M', u'ᄀ'),
    (0xFFA2, 'M', u'ᄁ'),
    (0xFFA3, 'M', u'ᆪ'),
    (0xFFA4, 'M', u'ᄂ'),
    (0xFFA5, 'M', u'ᆬ'),
    (0xFFA6, 'M', u'ᆭ'),
    (0xFFA7, 'M', u'ᄃ'),
    (0xFFA8, 'M', u'ᄄ'),
    (0xFFA9, 'M', u'ᄅ'),
    (0xFFAA, 'M', u'ᆰ'),
    (0xFFAB, 'M', u'ᆱ'),
    (0xFFAC, 'M', u'ᆲ'),
    (0xFFAD, 'M', u'ᆳ'),
    (0xFFAE, 'M', u'ᆴ'),
    (0xFFAF, 'M', u'ᆵ'),
    (0xFFB0, 'M', u'ᄚ'),
    (0xFFB1, 'M', u'ᄆ'),
    (0xFFB2, 'M', u'ᄇ'),
    ]

def _seg_52():
    return [
    (0xFFB3, 'M', u'ᄈ'),
    (0xFFB4, 'M', u'ᄡ'),
    (0xFFB5, 'M', u'ᄉ'),
    (0xFFB6, 'M', u'ᄊ'),
    (0xFFB7, 'M', u'ᄋ'),
    (0xFFB8, 'M', u'ᄌ'),
    (0xFFB9, 'M', u'ᄍ'),
    (0xFFBA, 'M', u'ᄎ'),
    (0xFFBB, 'M', u'ᄏ'),
    (0xFFBC, 'M', u'ᄐ'),
    (0xFFBD, 'M', u'ᄑ'),
    (0xFFBE, 'M', u'ᄒ'),
    (0xFFBF, 'X'),
    (0xFFC2, 'M', u'ᅡ'),
    (0xFFC3, 'M', u'ᅢ'),
    (0xFFC4, 'M', u'ᅣ'),
    (0xFFC5, 'M', u'ᅤ'),
    (0xFFC6, 'M', u'ᅥ'),
    (0xFFC7, 'M', u'ᅦ'),
    (0xFFC8, 'X'),
    (0xFFCA, 'M', u'ᅧ'),
    (0xFFCB, 'M', u'ᅨ'),
    (0xFFCC, 'M', u'ᅩ'),
    (0xFFCD, 'M', u'ᅪ'),
    (0xFFCE, 'M', u'ᅫ'),
    (0xFFCF, 'M', u'ᅬ'),
    (0xFFD0, 'X'),
    (0xFFD2, 'M', u'ᅭ'),
    (0xFFD3, 'M', u'ᅮ'),
    (0xFFD4, 'M', u'ᅯ'),
    (0xFFD5, 'M', u'ᅰ'),
    (0xFFD6, 'M', u'ᅱ'),
    (0xFFD7, 'M', u'ᅲ'),
    (0xFFD8, 'X'),
    (0xFFDA, 'M', u'ᅳ'),
    (0xFFDB, 'M', u'ᅴ'),
    (0xFFDC, 'M', u'ᅵ'),
    (0xFFDD, 'X'),
    (0xFFE0, 'M', u'¢'),
    (0xFFE1, 'M', u'£'),
    (0xFFE2, 'M', u'¬'),
    (0xFFE3, '3', u' ̄'),
    (0xFFE4, 'M', u'¦'),
    (0xFFE5, 'M', u'¥'),
    (0xFFE6, 'M', u'₩'),
    (0xFFE7, 'X'),
    (0xFFE8, 'M', u'│'),
    (0xFFE9, 'M', u'←'),
    (0xFFEA, 'M', u'↑'),
    (0xFFEB, 'M', u'→'),
    (0xFFEC, 'M', u'↓'),
    (0xFFED, 'M', u'■'),
    (0xFFEE, 'M', u'○'),
    (0xFFEF, 'X'),
    (0x10000, 'V'),
    (0x1000C, 'X'),
    (0x1000D, 'V'),
    (0x10027, 'X'),
    (0x10028, 'V'),
    (0x1003B, 'X'),
    (0x1003C, 'V'),
    (0x1003E, 'X'),
    (0x1003F, 'V'),
    (0x1004E, 'X'),
    (0x10050, 'V'),
    (0x1005E, 'X'),
    (0x10080, 'V'),
    (0x100FB, 'X'),
    (0x10100, 'V'),
    (0x10103, 'X'),
    (0x10107, 'V'),
    (0x10134, 'X'),
    (0x10137, 'V'),
    (0x1018F, 'X'),
    (0x10190, 'V'),
    (0x1019C, 'X'),
    (0x101A0, 'V'),
    (0x101A1, 'X'),
    (0x101D0, 'V'),
    (0x101FE, 'X'),
    (0x10280, 'V'),
    (0x1029D, 'X'),
    (0x102A0, 'V'),
    (0x102D1, 'X'),
    (0x102E0, 'V'),
    (0x102FC, 'X'),
    (0x10300, 'V'),
    (0x10324, 'X'),
    (0x1032D, 'V'),
    (0x1034B, 'X'),
    (0x10350, 'V'),
    (0x1037B, 'X'),
    (0x10380, 'V'),
    (0x1039E, 'X'),
    (0x1039F, 'V'),
    (0x103C4, 'X'),
    (0x103C8, 'V'),
    (0x103D6, 'X'),
    (0x10400, 'M', u'𐐨'),
    (0x10401, 'M', u'𐐩'),
    ]

def _seg_53():
    return [
    (0x10402, 'M', u'𐐪'),
    (0x10403, 'M', u'𐐫'),
    (0x10404, 'M', u'𐐬'),
    (0x10405, 'M', u'𐐭'),
    (0x10406, 'M', u'𐐮'),
    (0x10407, 'M', u'𐐯'),
    (0x10408, 'M', u'𐐰'),
    (0x10409, 'M', u'𐐱'),
    (0x1040A, 'M', u'𐐲'),
    (0x1040B, 'M', u'𐐳'),
    (0x1040C, 'M', u'𐐴'),
    (0x1040D, 'M', u'𐐵'),
    (0x1040E, 'M', u'𐐶'),
    (0x1040F, 'M', u'𐐷'),
    (0x10410, 'M', u'𐐸'),
    (0x10411, 'M', u'𐐹'),
    (0x10412, 'M', u'𐐺'),
    (0x10413, 'M', u'𐐻'),
    (0x10414, 'M', u'𐐼'),
    (0x10415, 'M', u'𐐽'),
    (0x10416, 'M', u'𐐾'),
    (0x10417, 'M', u'𐐿'),
    (0x10418, 'M', u'𐑀'),
    (0x10419, 'M', u'𐑁'),
    (0x1041A, 'M', u'𐑂'),
    (0x1041B, 'M', u'𐑃'),
    (0x1041C, 'M', u'𐑄'),
    (0x1041D, 'M', u'𐑅'),
    (0x1041E, 'M', u'𐑆'),
    (0x1041F, 'M', u'𐑇'),
    (0x10420, 'M', u'𐑈'),
    (0x10421, 'M', u'𐑉'),
    (0x10422, 'M', u'𐑊'),
    (0x10423, 'M', u'𐑋'),
    (0x10424, 'M', u'𐑌'),
    (0x10425, 'M', u'𐑍'),
    (0x10426, 'M', u'𐑎'),
    (0x10427, 'M', u'𐑏'),
    (0x10428, 'V'),
    (0x1049E, 'X'),
    (0x104A0, 'V'),
    (0x104AA, 'X'),
    (0x104B0, 'M', u'𐓘'),
    (0x104B1, 'M', u'𐓙'),
    (0x104B2, 'M', u'𐓚'),
    (0x104B3, 'M', u'𐓛'),
    (0x104B4, 'M', u'𐓜'),
    (0x104B5, 'M', u'𐓝'),
    (0x104B6, 'M', u'𐓞'),
    (0x104B7, 'M', u'𐓟'),
    (0x104B8, 'M', u'𐓠'),
    (0x104B9, 'M', u'𐓡'),
    (0x104BA, 'M', u'𐓢'),
    (0x104BB, 'M', u'𐓣'),
    (0x104BC, 'M', u'𐓤'),
    (0x104BD, 'M', u'𐓥'),
    (0x104BE, 'M', u'𐓦'),
    (0x104BF, 'M', u'𐓧'),
    (0x104C0, 'M', u'𐓨'),
    (0x104C1, 'M', u'𐓩'),
    (0x104C2, 'M', u'𐓪'),
    (0x104C3, 'M', u'𐓫'),
    (0x104C4, 'M', u'𐓬'),
    (0x104C5, 'M', u'𐓭'),
    (0x104C6, 'M', u'𐓮'),
    (0x104C7, 'M', u'𐓯'),
    (0x104C8, 'M', u'𐓰'),
    (0x104C9, 'M', u'𐓱'),
    (0x104CA, 'M', u'𐓲'),
    (0x104CB, 'M', u'𐓳'),
    (0x104CC, 'M', u'𐓴'),
    (0x104CD, 'M', u'𐓵'),
    (0x104CE, 'M', u'𐓶'),
    (0x104CF, 'M', u'𐓷'),
    (0x104D0, 'M', u'𐓸'),
    (0x104D1, 'M', u'𐓹'),
    (0x104D2, 'M', u'𐓺'),
    (0x104D3, 'M', u'𐓻'),
    (0x104D4, 'X'),
    (0x104D8, 'V'),
    (0x104FC, 'X'),
    (0x10500, 'V'),
    (0x10528, 'X'),
    (0x10530, 'V'),
    (0x10564, 'X'),
    (0x1056F, 'V'),
    (0x10570, 'X'),
    (0x10600, 'V'),
    (0x10737, 'X'),
    (0x10740, 'V'),
    (0x10756, 'X'),
    (0x10760, 'V'),
    (0x10768, 'X'),
    (0x10800, 'V'),
    (0x10806, 'X'),
    (0x10808, 'V'),
    (0x10809, 'X'),
    (0x1080A, 'V'),
    (0x10836, 'X'),
    (0x10837, 'V'),
    ]

def _seg_54():
    return [
    (0x10839, 'X'),
    (0x1083C, 'V'),
    (0x1083D, 'X'),
    (0x1083F, 'V'),
    (0x10856, 'X'),
    (0x10857, 'V'),
    (0x1089F, 'X'),
    (0x108A7, 'V'),
    (0x108B0, 'X'),
    (0x108E0, 'V'),
    (0x108F3, 'X'),
    (0x108F4, 'V'),
    (0x108F6, 'X'),
    (0x108FB, 'V'),
    (0x1091C, 'X'),
    (0x1091F, 'V'),
    (0x1093A, 'X'),
    (0x1093F, 'V'),
    (0x10940, 'X'),
    (0x10980, 'V'),
    (0x109B8, 'X'),
    (0x109BC, 'V'),
    (0x109D0, 'X'),
    (0x109D2, 'V'),
    (0x10A04, 'X'),
    (0x10A05, 'V'),
    (0x10A07, 'X'),
    (0x10A0C, 'V'),
    (0x10A14, 'X'),
    (0x10A15, 'V'),
    (0x10A18, 'X'),
    (0x10A19, 'V'),
    (0x10A36, 'X'),
    (0x10A38, 'V'),
    (0x10A3B, 'X'),
    (0x10A3F, 'V'),
    (0x10A49, 'X'),
    (0x10A50, 'V'),
    (0x10A59, 'X'),
    (0x10A60, 'V'),
    (0x10AA0, 'X'),
    (0x10AC0, 'V'),
    (0x10AE7, 'X'),
    (0x10AEB, 'V'),
    (0x10AF7, 'X'),
    (0x10B00, 'V'),
    (0x10B36, 'X'),
    (0x10B39, 'V'),
    (0x10B56, 'X'),
    (0x10B58, 'V'),
    (0x10B73, 'X'),
    (0x10B78, 'V'),
    (0x10B92, 'X'),
    (0x10B99, 'V'),
    (0x10B9D, 'X'),
    (0x10BA9, 'V'),
    (0x10BB0, 'X'),
    (0x10C00, 'V'),
    (0x10C49, 'X'),
    (0x10C80, 'M', u'𐳀'),
    (0x10C81, 'M', u'𐳁'),
    (0x10C82, 'M', u'𐳂'),
    (0x10C83, 'M', u'𐳃'),
    (0x10C84, 'M', u'𐳄'),
    (0x10C85, 'M', u'𐳅'),
    (0x10C86, 'M', u'𐳆'),
    (0x10C87, 'M', u'𐳇'),
    (0x10C88, 'M', u'𐳈'),
    (0x10C89, 'M', u'𐳉'),
    (0x10C8A, 'M', u'𐳊'),
    (0x10C8B, 'M', u'𐳋'),
    (0x10C8C, 'M', u'𐳌'),
    (0x10C8D, 'M', u'𐳍'),
    (0x10C8E, 'M', u'𐳎'),
    (0x10C8F, 'M', u'𐳏'),
    (0x10C90, 'M', u'𐳐'),
    (0x10C91, 'M', u'𐳑'),
    (0x10C92, 'M', u'𐳒'),
    (0x10C93, 'M', u'𐳓'),
    (0x10C94, 'M', u'𐳔'),
    (0x10C95, 'M', u'𐳕'),
    (0x10C96, 'M', u'𐳖'),
    (0x10C97, 'M', u'𐳗'),
    (0x10C98, 'M', u'𐳘'),
    (0x10C99, 'M', u'𐳙'),
    (0x10C9A, 'M', u'𐳚'),
    (0x10C9B, 'M', u'𐳛'),
    (0x10C9C, 'M', u'𐳜'),
    (0x10C9D, 'M', u'𐳝'),
    (0x10C9E, 'M', u'𐳞'),
    (0x10C9F, 'M', u'𐳟'),
    (0x10CA0, 'M', u'𐳠'),
    (0x10CA1, 'M', u'𐳡'),
    (0x10CA2, 'M', u'𐳢'),
    (0x10CA3, 'M', u'𐳣'),
    (0x10CA4, 'M', u'𐳤'),
    (0x10CA5, 'M', u'𐳥'),
    (0x10CA6, 'M', u'𐳦'),
    (0x10CA7, 'M', u'𐳧'),
    (0x10CA8, 'M', u'𐳨'),
    ]

def _seg_55():
    return [
    (0x10CA9, 'M', u'𐳩'),
    (0x10CAA, 'M', u'𐳪'),
    (0x10CAB, 'M', u'𐳫'),
    (0x10CAC, 'M', u'𐳬'),
    (0x10CAD, 'M', u'𐳭'),
    (0x10CAE, 'M', u'𐳮'),
    (0x10CAF, 'M', u'𐳯'),
    (0x10CB0, 'M', u'𐳰'),
    (0x10CB1, 'M', u'𐳱'),
    (0x10CB2, 'M', u'𐳲'),
    (0x10CB3, 'X'),
    (0x10CC0, 'V'),
    (0x10CF3, 'X'),
    (0x10CFA, 'V'),
    (0x10D28, 'X'),
    (0x10D30, 'V'),
    (0x10D3A, 'X'),
    (0x10E60, 'V'),
    (0x10E7F, 'X'),
    (0x10F00, 'V'),
    (0x10F28, 'X'),
    (0x10F30, 'V'),
    (0x10F5A, 'X'),
    (0x11000, 'V'),
    (0x1104E, 'X'),
    (0x11052, 'V'),
    (0x11070, 'X'),
    (0x1107F, 'V'),
    (0x110BD, 'X'),
    (0x110BE, 'V'),
    (0x110C2, 'X'),
    (0x110D0, 'V'),
    (0x110E9, 'X'),
    (0x110F0, 'V'),
    (0x110FA, 'X'),
    (0x11100, 'V'),
    (0x11135, 'X'),
    (0x11136, 'V'),
    (0x11147, 'X'),
    (0x11150, 'V'),
    (0x11177, 'X'),
    (0x11180, 'V'),
    (0x111CE, 'X'),
    (0x111D0, 'V'),
    (0x111E0, 'X'),
    (0x111E1, 'V'),
    (0x111F5, 'X'),
    (0x11200, 'V'),
    (0x11212, 'X'),
    (0x11213, 'V'),
    (0x1123F, 'X'),
    (0x11280, 'V'),
    (0x11287, 'X'),
    (0x11288, 'V'),
    (0x11289, 'X'),
    (0x1128A, 'V'),
    (0x1128E, 'X'),
    (0x1128F, 'V'),
    (0x1129E, 'X'),
    (0x1129F, 'V'),
    (0x112AA, 'X'),
    (0x112B0, 'V'),
    (0x112EB, 'X'),
    (0x112F0, 'V'),
    (0x112FA, 'X'),
    (0x11300, 'V'),
    (0x11304, 'X'),
    (0x11305, 'V'),
    (0x1130D, 'X'),
    (0x1130F, 'V'),
    (0x11311, 'X'),
    (0x11313, 'V'),
    (0x11329, 'X'),
    (0x1132A, 'V'),
    (0x11331, 'X'),
    (0x11332, 'V'),
    (0x11334, 'X'),
    (0x11335, 'V'),
    (0x1133A, 'X'),
    (0x1133B, 'V'),
    (0x11345, 'X'),
    (0x11347, 'V'),
    (0x11349, 'X'),
    (0x1134B, 'V'),
    (0x1134E, 'X'),
    (0x11350, 'V'),
    (0x11351, 'X'),
    (0x11357, 'V'),
    (0x11358, 'X'),
    (0x1135D, 'V'),
    (0x11364, 'X'),
    (0x11366, 'V'),
    (0x1136D, 'X'),
    (0x11370, 'V'),
    (0x11375, 'X'),
    (0x11400, 'V'),
    (0x1145A, 'X'),
    (0x1145B, 'V'),
    (0x1145C, 'X'),
    (0x1145D, 'V'),
    ]

def _seg_56():
    return [
    (0x1145F, 'X'),
    (0x11480, 'V'),
    (0x114C8, 'X'),
    (0x114D0, 'V'),
    (0x114DA, 'X'),
    (0x11580, 'V'),
    (0x115B6, 'X'),
    (0x115B8, 'V'),
    (0x115DE, 'X'),
    (0x11600, 'V'),
    (0x11645, 'X'),
    (0x11650, 'V'),
    (0x1165A, 'X'),
    (0x11660, 'V'),
    (0x1166D, 'X'),
    (0x11680, 'V'),
    (0x116B8, 'X'),
    (0x116C0, 'V'),
    (0x116CA, 'X'),
    (0x11700, 'V'),
    (0x1171B, 'X'),
    (0x1171D, 'V'),
    (0x1172C, 'X'),
    (0x11730, 'V'),
    (0x11740, 'X'),
    (0x11800, 'V'),
    (0x1183C, 'X'),
    (0x118A0, 'M', u'𑣀'),
    (0x118A1, 'M', u'𑣁'),
    (0x118A2, 'M', u'𑣂'),
    (0x118A3, 'M', u'𑣃'),
    (0x118A4, 'M', u'𑣄'),
    (0x118A5, 'M', u'𑣅'),
    (0x118A6, 'M', u'𑣆'),
    (0x118A7, 'M', u'𑣇'),
    (0x118A8, 'M', u'𑣈'),
    (0x118A9, 'M', u'𑣉'),
    (0x118AA, 'M', u'𑣊'),
    (0x118AB, 'M', u'𑣋'),
    (0x118AC, 'M', u'𑣌'),
    (0x118AD, 'M', u'𑣍'),
    (0x118AE, 'M', u'𑣎'),
    (0x118AF, 'M', u'𑣏'),
    (0x118B0, 'M', u'𑣐'),
    (0x118B1, 'M', u'𑣑'),
    (0x118B2, 'M', u'𑣒'),
    (0x118B3, 'M', u'𑣓'),
    (0x118B4, 'M', u'𑣔'),
    (0x118B5, 'M', u'𑣕'),
    (0x118B6, 'M', u'𑣖'),
    (0x118B7, 'M', u'𑣗'),
    (0x118B8, 'M', u'𑣘'),
    (0x118B9, 'M', u'𑣙'),
    (0x118BA, 'M', u'𑣚'),
    (0x118BB, 'M', u'𑣛'),
    (0x118BC, 'M', u'𑣜'),
    (0x118BD, 'M', u'𑣝'),
    (0x118BE, 'M', u'𑣞'),
    (0x118BF, 'M', u'𑣟'),
    (0x118C0, 'V'),
    (0x118F3, 'X'),
    (0x118FF, 'V'),
    (0x11900, 'X'),
    (0x11A00, 'V'),
    (0x11A48, 'X'),
    (0x11A50, 'V'),
    (0x11A84, 'X'),
    (0x11A86, 'V'),
    (0x11AA3, 'X'),
    (0x11AC0, 'V'),
    (0x11AF9, 'X'),
    (0x11C00, 'V'),
    (0x11C09, 'X'),
    (0x11C0A, 'V'),
    (0x11C37, 'X'),
    (0x11C38, 'V'),
    (0x11C46, 'X'),
    (0x11C50, 'V'),
    (0x11C6D, 'X'),
    (0x11C70, 'V'),
    (0x11C90, 'X'),
    (0x11C92, 'V'),
    (0x11CA8, 'X'),
    (0x11CA9, 'V'),
    (0x11CB7, 'X'),
    (0x11D00, 'V'),
    (0x11D07, 'X'),
    (0x11D08, 'V'),
    (0x11D0A, 'X'),
    (0x11D0B, 'V'),
    (0x11D37, 'X'),
    (0x11D3A, 'V'),
    (0x11D3B, 'X'),
    (0x11D3C, 'V'),
    (0x11D3E, 'X'),
    (0x11D3F, 'V'),
    (0x11D48, 'X'),
    (0x11D50, 'V'),
    (0x11D5A, 'X'),
    (0x11D60, 'V'),
    ]

def _seg_57():
    return [
    (0x11D66, 'X'),
    (0x11D67, 'V'),
    (0x11D69, 'X'),
    (0x11D6A, 'V'),
    (0x11D8F, 'X'),
    (0x11D90, 'V'),
    (0x11D92, 'X'),
    (0x11D93, 'V'),
    (0x11D99, 'X'),
    (0x11DA0, 'V'),
    (0x11DAA, 'X'),
    (0x11EE0, 'V'),
    (0x11EF9, 'X'),
    (0x12000, 'V'),
    (0x1239A, 'X'),
    (0x12400, 'V'),
    (0x1246F, 'X'),
    (0x12470, 'V'),
    (0x12475, 'X'),
    (0x12480, 'V'),
    (0x12544, 'X'),
    (0x13000, 'V'),
    (0x1342F, 'X'),
    (0x14400, 'V'),
    (0x14647, 'X'),
    (0x16800, 'V'),
    (0x16A39, 'X'),
    (0x16A40, 'V'),
    (0x16A5F, 'X'),
    (0x16A60, 'V'),
    (0x16A6A, 'X'),
    (0x16A6E, 'V'),
    (0x16A70, 'X'),
    (0x16AD0, 'V'),
    (0x16AEE, 'X'),
    (0x16AF0, 'V'),
    (0x16AF6, 'X'),
    (0x16B00, 'V'),
    (0x16B46, 'X'),
    (0x16B50, 'V'),
    (0x16B5A, 'X'),
    (0x16B5B, 'V'),
    (0x16B62, 'X'),
    (0x16B63, 'V'),
    (0x16B78, 'X'),
    (0x16B7D, 'V'),
    (0x16B90, 'X'),
    (0x16E60, 'V'),
    (0x16E9B, 'X'),
    (0x16F00, 'V'),
    (0x16F45, 'X'),
    (0x16F50, 'V'),
    (0x16F7F, 'X'),
    (0x16F8F, 'V'),
    (0x16FA0, 'X'),
    (0x16FE0, 'V'),
    (0x16FE2, 'X'),
    (0x17000, 'V'),
    (0x187F2, 'X'),
    (0x18800, 'V'),
    (0x18AF3, 'X'),
    (0x1B000, 'V'),
    (0x1B11F, 'X'),
    (0x1B170, 'V'),
    (0x1B2FC, 'X'),
    (0x1BC00, 'V'),
    (0x1BC6B, 'X'),
    (0x1BC70, 'V'),
    (0x1BC7D, 'X'),
    (0x1BC80, 'V'),
    (0x1BC89, 'X'),
    (0x1BC90, 'V'),
    (0x1BC9A, 'X'),
    (0x1BC9C, 'V'),
    (0x1BCA0, 'I'),
    (0x1BCA4, 'X'),
    (0x1D000, 'V'),
    (0x1D0F6, 'X'),
    (0x1D100, 'V'),
    (0x1D127, 'X'),
    (0x1D129, 'V'),
    (0x1D15E, 'M', u'𝅗𝅥'),
    (0x1D15F, 'M', u'𝅘𝅥'),
    (0x1D160, 'M', u'𝅘𝅥𝅮'),
    (0x1D161, 'M', u'𝅘𝅥𝅯'),
    (0x1D162, 'M', u'𝅘𝅥𝅰'),
    (0x1D163, 'M', u'𝅘𝅥𝅱'),
    (0x1D164, 'M', u'𝅘𝅥𝅲'),
    (0x1D165, 'V'),
    (0x1D173, 'X'),
    (0x1D17B, 'V'),
    (0x1D1BB, 'M', u'𝆹𝅥'),
    (0x1D1BC, 'M', u'𝆺𝅥'),
    (0x1D1BD, 'M', u'𝆹𝅥𝅮'),
    (0x1D1BE, 'M', u'𝆺𝅥𝅮'),
    (0x1D1BF, 'M', u'𝆹𝅥𝅯'),
    (0x1D1C0, 'M', u'𝆺𝅥𝅯'),
    (0x1D1C1, 'V'),
    (0x1D1E9, 'X'),
    (0x1D200, 'V'),
    ]

def _seg_58():
    return [
    (0x1D246, 'X'),
    (0x1D2E0, 'V'),
    (0x1D2F4, 'X'),
    (0x1D300, 'V'),
    (0x1D357, 'X'),
    (0x1D360, 'V'),
    (0x1D379, 'X'),
    (0x1D400, 'M', u'a'),
    (0x1D401, 'M', u'b'),
    (0x1D402, 'M', u'c'),
    (0x1D403, 'M', u'd'),
    (0x1D404, 'M', u'e'),
    (0x1D405, 'M', u'f'),
    (0x1D406, 'M', u'g'),
    (0x1D407, 'M', u'h'),
    (0x1D408, 'M', u'i'),
    (0x1D409, 'M', u'j'),
    (0x1D40A, 'M', u'k'),
    (0x1D40B, 'M', u'l'),
    (0x1D40C, 'M', u'm'),
    (0x1D40D, 'M', u'n'),
    (0x1D40E, 'M', u'o'),
    (0x1D40F, 'M', u'p'),
    (0x1D410, 'M', u'q'),
    (0x1D411, 'M', u'r'),
    (0x1D412, 'M', u's'),
    (0x1D413, 'M', u't'),
    (0x1D414, 'M', u'u'),
    (0x1D415, 'M', u'v'),
    (0x1D416, 'M', u'w'),
    (0x1D417, 'M', u'x'),
    (0x1D418, 'M', u'y'),
    (0x1D419, 'M', u'z'),
    (0x1D41A, 'M', u'a'),
    (0x1D41B, 'M', u'b'),
    (0x1D41C, 'M', u'c'),
    (0x1D41D, 'M', u'd'),
    (0x1D41E, 'M', u'e'),
    (0x1D41F, 'M', u'f'),
    (0x1D420, 'M', u'g'),
    (0x1D421, 'M', u'h'),
    (0x1D422, 'M', u'i'),
    (0x1D423, 'M', u'j'),
    (0x1D424, 'M', u'k'),
    (0x1D425, 'M', u'l'),
    (0x1D426, 'M', u'm'),
    (0x1D427, 'M', u'n'),
    (0x1D428, 'M', u'o'),
    (0x1D429, 'M', u'p'),
    (0x1D42A, 'M', u'q'),
    (0x1D42B, 'M', u'r'),
    (0x1D42C, 'M', u's'),
    (0x1D42D, 'M', u't'),
    (0x1D42E, 'M', u'u'),
    (0x1D42F, 'M', u'v'),
    (0x1D430, 'M', u'w'),
    (0x1D431, 'M', u'x'),
    (0x1D432, 'M', u'y'),
    (0x1D433, 'M', u'z'),
    (0x1D434, 'M', u'a'),
    (0x1D435, 'M', u'b'),
    (0x1D436, 'M', u'c'),
    (0x1D437, 'M', u'd'),
    (0x1D438, 'M', u'e'),
    (0x1D439, 'M', u'f'),
    (0x1D43A, 'M', u'g'),
    (0x1D43B, 'M', u'h'),
    (0x1D43C, 'M', u'i'),
    (0x1D43D, 'M', u'j'),
    (0x1D43E, 'M', u'k'),
    (0x1D43F, 'M', u'l'),
    (0x1D440, 'M', u'm'),
    (0x1D441, 'M', u'n'),
    (0x1D442, 'M', u'o'),
    (0x1D443, 'M', u'p'),
    (0x1D444, 'M', u'q'),
    (0x1D445, 'M', u'r'),
    (0x1D446, 'M', u's'),
    (0x1D447, 'M', u't'),
    (0x1D448, 'M', u'u'),
    (0x1D449, 'M', u'v'),
    (0x1D44A, 'M', u'w'),
    (0x1D44B, 'M', u'x'),
    (0x1D44C, 'M', u'y'),
    (0x1D44D, 'M', u'z'),
    (0x1D44E, 'M', u'a'),
    (0x1D44F, 'M', u'b'),
    (0x1D450, 'M', u'c'),
    (0x1D451, 'M', u'd'),
    (0x1D452, 'M', u'e'),
    (0x1D453, 'M', u'f'),
    (0x1D454, 'M', u'g'),
    (0x1D455, 'X'),
    (0x1D456, 'M', u'i'),
    (0x1D457, 'M', u'j'),
    (0x1D458, 'M', u'k'),
    (0x1D459, 'M', u'l'),
    (0x1D45A, 'M', u'm'),
    (0x1D45B, 'M', u'n'),
    (0x1D45C, 'M', u'o'),
    ]

def _seg_59():
    return [
    (0x1D45D, 'M', u'p'),
    (0x1D45E, 'M', u'q'),
    (0x1D45F, 'M', u'r'),
    (0x1D460, 'M', u's'),
    (0x1D461, 'M', u't'),
    (0x1D462, 'M', u'u'),
    (0x1D463, 'M', u'v'),
    (0x1D464, 'M', u'w'),
    (0x1D465, 'M', u'x'),
    (0x1D466, 'M', u'y'),
    (0x1D467, 'M', u'z'),
    (0x1D468, 'M', u'a'),
    (0x1D469, 'M', u'b'),
    (0x1D46A, 'M', u'c'),
    (0x1D46B, 'M', u'd'),
    (0x1D46C, 'M', u'e'),
    (0x1D46D, 'M', u'f'),
    (0x1D46E, 'M', u'g'),
    (0x1D46F, 'M', u'h'),
    (0x1D470, 'M', u'i'),
    (0x1D471, 'M', u'j'),
    (0x1D472, 'M', u'k'),
    (0x1D473, 'M', u'l'),
    (0x1D474, 'M', u'm'),
    (0x1D475, 'M', u'n'),
    (0x1D476, 'M', u'o'),
    (0x1D477, 'M', u'p'),
    (0x1D478, 'M', u'q'),
    (0x1D479, 'M', u'r'),
    (0x1D47A, 'M', u's'),
    (0x1D47B, 'M', u't'),
    (0x1D47C, 'M', u'u'),
    (0x1D47D, 'M', u'v'),
    (0x1D47E, 'M', u'w'),
    (0x1D47F, 'M', u'x'),
    (0x1D480, 'M', u'y'),
    (0x1D481, 'M', u'z'),
    (0x1D482, 'M', u'a'),
    (0x1D483, 'M', u'b'),
    (0x1D484, 'M', u'c'),
    (0x1D485, 'M', u'd'),
    (0x1D486, 'M', u'e'),
    (0x1D487, 'M', u'f'),
    (0x1D488, 'M', u'g'),
    (0x1D489, 'M', u'h'),
    (0x1D48A, 'M', u'i'),
    (0x1D48B, 'M', u'j'),
    (0x1D48C, 'M', u'k'),
    (0x1D48D, 'M', u'l'),
    (0x1D48E, 'M', u'm'),
    (0x1D48F, 'M', u'n'),
    (0x1D490, 'M', u'o'),
    (0x1D491, 'M', u'p'),
    (0x1D492, 'M', u'q'),
    (0x1D493, 'M', u'r'),
    (0x1D494, 'M', u's'),
    (0x1D495, 'M', u't'),
    (0x1D496, 'M', u'u'),
    (0x1D497, 'M', u'v'),
    (0x1D498, 'M', u'w'),
    (0x1D499, 'M', u'x'),
    (0x1D49A, 'M', u'y'),
    (0x1D49B, 'M', u'z'),
    (0x1D49C, 'M', u'a'),
    (0x1D49D, 'X'),
    (0x1D49E, 'M', u'c'),
    (0x1D49F, 'M', u'd'),
    (0x1D4A0, 'X'),
    (0x1D4A2, 'M', u'g'),
    (0x1D4A3, 'X'),
    (0x1D4A5, 'M', u'j'),
    (0x1D4A6, 'M', u'k'),
    (0x1D4A7, 'X'),
    (0x1D4A9, 'M', u'n'),
    (0x1D4AA, 'M', u'o'),
    (0x1D4AB, 'M', u'p'),
    (0x1D4AC, 'M', u'q'),
    (0x1D4AD, 'X'),
    (0x1D4AE, 'M', u's'),
    (0x1D4AF, 'M', u't'),
    (0x1D4B0, 'M', u'u'),
    (0x1D4B1, 'M', u'v'),
    (0x1D4B2, 'M', u'w'),
    (0x1D4B3, 'M', u'x'),
    (0x1D4B4, 'M', u'y'),
    (0x1D4B5, 'M', u'z'),
    (0x1D4B6, 'M', u'a'),
    (0x1D4B7, 'M', u'b'),
    (0x1D4B8, 'M', u'c'),
    (0x1D4B9, 'M', u'd'),
    (0x1D4BA, 'X'),
    (0x1D4BB, 'M', u'f'),
    (0x1D4BC, 'X'),
    (0x1D4BD, 'M', u'h'),
    (0x1D4BE, 'M', u'i'),
    (0x1D4BF, 'M', u'j'),
    (0x1D4C0, 'M', u'k'),
    (0x1D4C1, 'M', u'l'),
    (0x1D4C2, 'M', u'm'),
    (0x1D4C3, 'M', u'n'),
    ]

def _seg_60():
    return [
    (0x1D4C4, 'X'),
    (0x1D4C5, 'M', u'p'),
    (0x1D4C6, 'M', u'q'),
    (0x1D4C7, 'M', u'r'),
    (0x1D4C8, 'M', u's'),
    (0x1D4C9, 'M', u't'),
    (0x1D4CA, 'M', u'u'),
    (0x1D4CB, 'M', u'v'),
    (0x1D4CC, 'M', u'w'),
    (0x1D4CD, 'M', u'x'),
    (0x1D4CE, 'M', u'y'),
    (0x1D4CF, 'M', u'z'),
    (0x1D4D0, 'M', u'a'),
    (0x1D4D1, 'M', u'b'),
    (0x1D4D2, 'M', u'c'),
    (0x1D4D3, 'M', u'd'),
    (0x1D4D4, 'M', u'e'),
    (0x1D4D5, 'M', u'f'),
    (0x1D4D6, 'M', u'g'),
    (0x1D4D7, 'M', u'h'),
    (0x1D4D8, 'M', u'i'),
    (0x1D4D9, 'M', u'j'),
    (0x1D4DA, 'M', u'k'),
    (0x1D4DB, 'M', u'l'),
    (0x1D4DC, 'M', u'm'),
    (0x1D4DD, 'M', u'n'),
    (0x1D4DE, 'M', u'o'),
    (0x1D4DF, 'M', u'p'),
    (0x1D4E0, 'M', u'q'),
    (0x1D4E1, 'M', u'r'),
    (0x1D4E2, 'M', u's'),
    (0x1D4E3, 'M', u't'),
    (0x1D4E4, 'M', u'u'),
    (0x1D4E5, 'M', u'v'),
    (0x1D4E6, 'M', u'w'),
    (0x1D4E7, 'M', u'x'),
    (0x1D4E8, 'M', u'y'),
    (0x1D4E9, 'M', u'z'),
    (0x1D4EA, 'M', u'a'),
    (0x1D4EB, 'M', u'b'),
    (0x1D4EC, 'M', u'c'),
    (0x1D4ED, 'M', u'd'),
    (0x1D4EE, 'M', u'e'),
    (0x1D4EF, 'M', u'f'),
    (0x1D4F0, 'M', u'g'),
    (0x1D4F1, 'M', u'h'),
    (0x1D4F2, 'M', u'i'),
    (0x1D4F3, 'M', u'j'),
    (0x1D4F4, 'M', u'k'),
    (0x1D4F5, 'M', u'l'),
    (0x1D4F6, 'M', u'm'),
    (0x1D4F7, 'M', u'n'),
    (0x1D4F8, 'M', u'o'),
    (0x1D4F9, 'M', u'p'),
    (0x1D4FA, 'M', u'q'),
    (0x1D4FB, 'M', u'r'),
    (0x1D4FC, 'M', u's'),
    (0x1D4FD, 'M', u't'),
    (0x1D4FE, 'M', u'u'),
    (0x1D4FF, 'M', u'v'),
    (0x1D500, 'M', u'w'),
    (0x1D501, 'M', u'x'),
    (0x1D502, 'M', u'y'),
    (0x1D503, 'M', u'z'),
    (0x1D504, 'M', u'a'),
    (0x1D505, 'M', u'b'),
    (0x1D506, 'X'),
    (0x1D507, 'M', u'd'),
    (0x1D508, 'M', u'e'),
    (0x1D509, 'M', u'f'),
    (0x1D50A, 'M', u'g'),
    (0x1D50B, 'X'),
    (0x1D50D, 'M', u'j'),
    (0x1D50E, 'M', u'k'),
    (0x1D50F, 'M', u'l'),
    (0x1D510, 'M', u'm'),
    (0x1D511, 'M', u'n'),
    (0x1D512, 'M', u'o'),
    (0x1D513, 'M', u'p'),
    (0x1D514, 'M', u'q'),
    (0x1D515, 'X'),
    (0x1D516, 'M', u's'),
    (0x1D517, 'M', u't'),
    (0x1D518, 'M', u'u'),
    (0x1D519, 'M', u'v'),
    (0x1D51A, 'M', u'w'),
    (0x1D51B, 'M', u'x'),
    (0x1D51C, 'M', u'y'),
    (0x1D51D, 'X'),
    (0x1D51E, 'M', u'a'),
    (0x1D51F, 'M', u'b'),
    (0x1D520, 'M', u'c'),
    (0x1D521, 'M', u'd'),
    (0x1D522, 'M', u'e'),
    (0x1D523, 'M', u'f'),
    (0x1D524, 'M', u'g'),
    (0x1D525, 'M', u'h'),
    (0x1D526, 'M', u'i'),
    (0x1D527, 'M', u'j'),
    (0x1D528, 'M', u'k'),
    ]

def _seg_61():
    return [
    (0x1D529, 'M', u'l'),
    (0x1D52A, 'M', u'm'),
    (0x1D52B, 'M', u'n'),
    (0x1D52C, 'M', u'o'),
    (0x1D52D, 'M', u'p'),
    (0x1D52E, 'M', u'q'),
    (0x1D52F, 'M', u'r'),
    (0x1D530, 'M', u's'),
    (0x1D531, 'M', u't'),
    (0x1D532, 'M', u'u'),
    (0x1D533, 'M', u'v'),
    (0x1D534, 'M', u'w'),
    (0x1D535, 'M', u'x'),
    (0x1D536, 'M', u'y'),
    (0x1D537, 'M', u'z'),
    (0x1D538, 'M', u'a'),
    (0x1D539, 'M', u'b'),
    (0x1D53A, 'X'),
    (0x1D53B, 'M', u'd'),
    (0x1D53C, 'M', u'e'),
    (0x1D53D, 'M', u'f'),
    (0x1D53E, 'M', u'g'),
    (0x1D53F, 'X'),
    (0x1D540, 'M', u'i'),
    (0x1D541, 'M', u'j'),
    (0x1D542, 'M', u'k'),
    (0x1D543, 'M', u'l'),
    (0x1D544, 'M', u'm'),
    (0x1D545, 'X'),
    (0x1D546, 'M', u'o'),
    (0x1D547, 'X'),
    (0x1D54A, 'M', u's'),
    (0x1D54B, 'M', u't'),
    (0x1D54C, 'M', u'u'),
    (0x1D54D, 'M', u'v'),
    (0x1D54E, 'M', u'w'),
    (0x1D54F, 'M', u'x'),
    (0x1D550, 'M', u'y'),
    (0x1D551, 'X'),
    (0x1D552, 'M', u'a'),
    (0x1D553, 'M', u'b'),
    (0x1D554, 'M', u'c'),
    (0x1D555, 'M', u'd'),
    (0x1D556, 'M', u'e'),
    (0x1D557, 'M', u'f'),
    (0x1D558, 'M', u'g'),
    (0x1D559, 'M', u'h'),
    (0x1D55A, 'M', u'i'),
    (0x1D55B, 'M', u'j'),
    (0x1D55C, 'M', u'k'),
    (0x1D55D, 'M', u'l'),
    (0x1D55E, 'M', u'm'),
    (0x1D55F, 'M', u'n'),
    (0x1D560, 'M', u'o'),
    (0x1D561, 'M', u'p'),
    (0x1D562, 'M', u'q'),
    (0x1D563, 'M', u'r'),
    (0x1D564, 'M', u's'),
    (0x1D565, 'M', u't'),
    (0x1D566, 'M', u'u'),
    (0x1D567, 'M', u'v'),
    (0x1D568, 'M', u'w'),
    (0x1D569, 'M', u'x'),
    (0x1D56A, 'M', u'y'),
    (0x1D56B, 'M', u'z'),
    (0x1D56C, 'M', u'a'),
    (0x1D56D, 'M', u'b'),
    (0x1D56E, 'M', u'c'),
    (0x1D56F, 'M', u'd'),
    (0x1D570, 'M', u'e'),
    (0x1D571, 'M', u'f'),
    (0x1D572, 'M', u'g'),
    (0x1D573, 'M', u'h'),
    (0x1D574, 'M', u'i'),
    (0x1D575, 'M', u'j'),
    (0x1D576, 'M', u'k'),
    (0x1D577, 'M', u'l'),
    (0x1D578, 'M', u'm'),
    (0x1D579, 'M', u'n'),
    (0x1D57A, 'M', u'o'),
    (0x1D57B, 'M', u'p'),
    (0x1D57C, 'M', u'q'),
    (0x1D57D, 'M', u'r'),
    (0x1D57E, 'M', u's'),
    (0x1D57F, 'M', u't'),
    (0x1D580, 'M', u'u'),
    (0x1D581, 'M', u'v'),
    (0x1D582, 'M', u'w'),
    (0x1D583, 'M', u'x'),
    (0x1D584, 'M', u'y'),
    (0x1D585, 'M', u'z'),
    (0x1D586, 'M', u'a'),
    (0x1D587, 'M', u'b'),
    (0x1D588, 'M', u'c'),
    (0x1D589, 'M', u'd'),
    (0x1D58A, 'M', u'e'),
    (0x1D58B, 'M', u'f'),
    (0x1D58C, 'M', u'g'),
    (0x1D58D, 'M', u'h'),
    (0x1D58E, 'M', u'i'),
    ]

def _seg_62():
    return [
    (0x1D58F, 'M', u'j'),
    (0x1D590, 'M', u'k'),
    (0x1D591, 'M', u'l'),
    (0x1D592, 'M', u'm'),
    (0x1D593, 'M', u'n'),
    (0x1D594, 'M', u'o'),
    (0x1D595, 'M', u'p'),
    (0x1D596, 'M', u'q'),
    (0x1D597, 'M', u'r'),
    (0x1D598, 'M', u's'),
    (0x1D599, 'M', u't'),
    (0x1D59A, 'M', u'u'),
    (0x1D59B, 'M', u'v'),
    (0x1D59C, 'M', u'w'),
    (0x1D59D, 'M', u'x'),
    (0x1D59E, 'M', u'y'),
    (0x1D59F, 'M', u'z'),
    (0x1D5A0, 'M', u'a'),
    (0x1D5A1, 'M', u'b'),
    (0x1D5A2, 'M', u'c'),
    (0x1D5A3, 'M', u'd'),
    (0x1D5A4, 'M', u'e'),
    (0x1D5A5, 'M', u'f'),
    (0x1D5A6, 'M', u'g'),
    (0x1D5A7, 'M', u'h'),
    (0x1D5A8, 'M', u'i'),
    (0x1D5A9, 'M', u'j'),
    (0x1D5AA, 'M', u'k'),
    (0x1D5AB, 'M', u'l'),
    (0x1D5AC, 'M', u'm'),
    (0x1D5AD, 'M', u'n'),
    (0x1D5AE, 'M', u'o'),
    (0x1D5AF, 'M', u'p'),
    (0x1D5B0, 'M', u'q'),
    (0x1D5B1, 'M', u'r'),
    (0x1D5B2, 'M', u's'),
    (0x1D5B3, 'M', u't'),
    (0x1D5B4, 'M', u'u'),
    (0x1D5B5, 'M', u'v'),
    (0x1D5B6, 'M', u'w'),
    (0x1D5B7, 'M', u'x'),
    (0x1D5B8, 'M', u'y'),
    (0x1D5B9, 'M', u'z'),
    (0x1D5BA, 'M', u'a'),
    (0x1D5BB, 'M', u'b'),
    (0x1D5BC, 'M', u'c'),
    (0x1D5BD, 'M', u'd'),
    (0x1D5BE, 'M', u'e'),
    (0x1D5BF, 'M', u'f'),
    (0x1D5C0, 'M', u'g'),
    (0x1D5C1, 'M', u'h'),
    (0x1D5C2, 'M', u'i'),
    (0x1D5C3, 'M', u'j'),
    (0x1D5C4, 'M', u'k'),
    (0x1D5C5, 'M', u'l'),
    (0x1D5C6, 'M', u'm'),
    (0x1D5C7, 'M', u'n'),
    (0x1D5C8, 'M', u'o'),
    (0x1D5C9, 'M', u'p'),
    (0x1D5CA, 'M', u'q'),
    (0x1D5CB, 'M', u'r'),
    (0x1D5CC, 'M', u's'),
    (0x1D5CD, 'M', u't'),
    (0x1D5CE, 'M', u'u'),
    (0x1D5CF, 'M', u'v'),
    (0x1D5D0, 'M', u'w'),
    (0x1D5D1, 'M', u'x'),
    (0x1D5D2, 'M', u'y'),
    (0x1D5D3, 'M', u'z'),
    (0x1D5D4, 'M', u'a'),
    (0x1D5D5, 'M', u'b'),
    (0x1D5D6, 'M', u'c'),
    (0x1D5D7, 'M', u'd'),
    (0x1D5D8, 'M', u'e'),
    (0x1D5D9, 'M', u'f'),
    (0x1D5DA, 'M', u'g'),
    (0x1D5DB, 'M', u'h'),
    (0x1D5DC, 'M', u'i'),
    (0x1D5DD, 'M', u'j'),
    (0x1D5DE, 'M', u'k'),
    (0x1D5DF, 'M', u'l'),
    (0x1D5E0, 'M', u'm'),
    (0x1D5E1, 'M', u'n'),
    (0x1D5E2, 'M', u'o'),
    (0x1D5E3, 'M', u'p'),
    (0x1D5E4, 'M', u'q'),
    (0x1D5E5, 'M', u'r'),
    (0x1D5E6, 'M', u's'),
    (0x1D5E7, 'M', u't'),
    (0x1D5E8, 'M', u'u'),
    (0x1D5E9, 'M', u'v'),
    (0x1D5EA, 'M', u'w'),
    (0x1D5EB, 'M', u'x'),
    (0x1D5EC, 'M', u'y'),
    (0x1D5ED, 'M', u'z'),
    (0x1D5EE, 'M', u'a'),
    (0x1D5EF, 'M', u'b'),
    (0x1D5F0, 'M', u'c'),
    (0x1D5F1, 'M', u'd'),
    (0x1D5F2, 'M', u'e'),
    ]

def _seg_63():
    return [
    (0x1D5F3, 'M', u'f'),
    (0x1D5F4, 'M', u'g'),
    (0x1D5F5, 'M', u'h'),
    (0x1D5F6, 'M', u'i'),
    (0x1D5F7, 'M', u'j'),
    (0x1D5F8, 'M', u'k'),
    (0x1D5F9, 'M', u'l'),
    (0x1D5FA, 'M', u'm'),
    (0x1D5FB, 'M', u'n'),
    (0x1D5FC, 'M', u'o'),
    (0x1D5FD, 'M', u'p'),
    (0x1D5FE, 'M', u'q'),
    (0x1D5FF, 'M', u'r'),
    (0x1D600, 'M', u's'),
    (0x1D601, 'M', u't'),
    (0x1D602, 'M', u'u'),
    (0x1D603, 'M', u'v'),
    (0x1D604, 'M', u'w'),
    (0x1D605, 'M', u'x'),
    (0x1D606, 'M', u'y'),
    (0x1D607, 'M', u'z'),
    (0x1D608, 'M', u'a'),
    (0x1D609, 'M', u'b'),
    (0x1D60A, 'M', u'c'),
    (0x1D60B, 'M', u'd'),
    (0x1D60C, 'M', u'e'),
    (0x1D60D, 'M', u'f'),
    (0x1D60E, 'M', u'g'),
    (0x1D60F, 'M', u'h'),
    (0x1D610, 'M', u'i'),
    (0x1D611, 'M', u'j'),
    (0x1D612, 'M', u'k'),
    (0x1D613, 'M', u'l'),
    (0x1D614, 'M', u'm'),
    (0x1D615, 'M', u'n'),
    (0x1D616, 'M', u'o'),
    (0x1D617, 'M', u'p'),
    (0x1D618, 'M', u'q'),
    (0x1D619, 'M', u'r'),
    (0x1D61A, 'M', u's'),
    (0x1D61B, 'M', u't'),
    (0x1D61C, 'M', u'u'),
    (0x1D61D, 'M', u'v'),
    (0x1D61E, 'M', u'w'),
    (0x1D61F, 'M', u'x'),
    (0x1D620, 'M', u'y'),
    (0x1D621, 'M', u'z'),
    (0x1D622, 'M', u'a'),
    (0x1D623, 'M', u'b'),
    (0x1D624, 'M', u'c'),
    (0x1D625, 'M', u'd'),
    (0x1D626, 'M', u'e'),
    (0x1D627, 'M', u'f'),
    (0x1D628, 'M', u'g'),
    (0x1D629, 'M', u'h'),
    (0x1D62A, 'M', u'i'),
    (0x1D62B, 'M', u'j'),
    (0x1D62C, 'M', u'k'),
    (0x1D62D, 'M', u'l'),
    (0x1D62E, 'M', u'm'),
    (0x1D62F, 'M', u'n'),
    (0x1D630, 'M', u'o'),
    (0x1D631, 'M', u'p'),
    (0x1D632, 'M', u'q'),
    (0x1D633, 'M', u'r'),
    (0x1D634, 'M', u's'),
    (0x1D635, 'M', u't'),
    (0x1D636, 'M', u'u'),
    (0x1D637, 'M', u'v'),
    (0x1D638, 'M', u'w'),
    (0x1D639, 'M', u'x'),
    (0x1D63A, 'M', u'y'),
    (0x1D63B, 'M', u'z'),
    (0x1D63C, 'M', u'a'),
    (0x1D63D, 'M', u'b'),
    (0x1D63E, 'M', u'c'),
    (0x1D63F, 'M', u'd'),
    (0x1D640, 'M', u'e'),
    (0x1D641, 'M', u'f'),
    (0x1D642, 'M', u'g'),
    (0x1D643, 'M', u'h'),
    (0x1D644, 'M', u'i'),
    (0x1D645, 'M', u'j'),
    (0x1D646, 'M', u'k'),
    (0x1D647, 'M', u'l'),
    (0x1D648, 'M', u'm'),
    (0x1D649, 'M', u'n'),
    (0x1D64A, 'M', u'o'),
    (0x1D64B, 'M', u'p'),
    (0x1D64C, 'M', u'q'),
    (0x1D64D, 'M', u'r'),
    (0x1D64E, 'M', u's'),
    (0x1D64F, 'M', u't'),
    (0x1D650, 'M', u'u'),
    (0x1D651, 'M', u'v'),
    (0x1D652, 'M', u'w'),
    (0x1D653, 'M', u'x'),
    (0x1D654, 'M', u'y'),
    (0x1D655, 'M', u'z'),
    (0x1D656, 'M', u'a'),
    ]

def _seg_64():
    return [
    (0x1D657, 'M', u'b'),
    (0x1D658, 'M', u'c'),
    (0x1D659, 'M', u'd'),
    (0x1D65A, 'M', u'e'),
    (0x1D65B, 'M', u'f'),
    (0x1D65C, 'M', u'g'),
    (0x1D65D, 'M', u'h'),
    (0x1D65E, 'M', u'i'),
    (0x1D65F, 'M', u'j'),
    (0x1D660, 'M', u'k'),
    (0x1D661, 'M', u'l'),
    (0x1D662, 'M', u'm'),
    (0x1D663, 'M', u'n'),
    (0x1D664, 'M', u'o'),
    (0x1D665, 'M', u'p'),
    (0x1D666, 'M', u'q'),
    (0x1D667, 'M', u'r'),
    (0x1D668, 'M', u's'),
    (0x1D669, 'M', u't'),
    (0x1D66A, 'M', u'u'),
    (0x1D66B, 'M', u'v'),
    (0x1D66C, 'M', u'w'),
    (0x1D66D, 'M', u'x'),
    (0x1D66E, 'M', u'y'),
    (0x1D66F, 'M', u'z'),
    (0x1D670, 'M', u'a'),
    (0x1D671, 'M', u'b'),
    (0x1D672, 'M', u'c'),
    (0x1D673, 'M', u'd'),
    (0x1D674, 'M', u'e'),
    (0x1D675, 'M', u'f'),
    (0x1D676, 'M', u'g'),
    (0x1D677, 'M', u'h'),
    (0x1D678, 'M', u'i'),
    (0x1D679, 'M', u'j'),
    (0x1D67A, 'M', u'k'),
    (0x1D67B, 'M', u'l'),
    (0x1D67C, 'M', u'm'),
    (0x1D67D, 'M', u'n'),
    (0x1D67E, 'M', u'o'),
    (0x1D67F, 'M', u'p'),
    (0x1D680, 'M', u'q'),
    (0x1D681, 'M', u'r'),
    (0x1D682, 'M', u's'),
    (0x1D683, 'M', u't'),
    (0x1D684, 'M', u'u'),
    (0x1D685, 'M', u'v'),
    (0x1D686, 'M', u'w'),
    (0x1D687, 'M', u'x'),
    (0x1D688, 'M', u'y'),
    (0x1D689, 'M', u'z'),
    (0x1D68A, 'M', u'a'),
    (0x1D68B, 'M', u'b'),
    (0x1D68C, 'M', u'c'),
    (0x1D68D, 'M', u'd'),
    (0x1D68E, 'M', u'e'),
    (0x1D68F, 'M', u'f'),
    (0x1D690, 'M', u'g'),
    (0x1D691, 'M', u'h'),
    (0x1D692, 'M', u'i'),
    (0x1D693, 'M', u'j'),
    (0x1D694, 'M', u'k'),
    (0x1D695, 'M', u'l'),
    (0x1D696, 'M', u'm'),
    (0x1D697, 'M', u'n'),
    (0x1D698, 'M', u'o'),
    (0x1D699, 'M', u'p'),
    (0x1D69A, 'M', u'q'),
    (0x1D69B, 'M', u'r'),
    (0x1D69C, 'M', u's'),
    (0x1D69D, 'M', u't'),
    (0x1D69E, 'M', u'u'),
    (0x1D69F, 'M', u'v'),
    (0x1D6A0, 'M', u'w'),
    (0x1D6A1, 'M', u'x'),
    (0x1D6A2, 'M', u'y'),
    (0x1D6A3, 'M', u'z'),
    (0x1D6A4, 'M', u'ı'),
    (0x1D6A5, 'M', u'ȷ'),
    (0x1D6A6, 'X'),
    (0x1D6A8, 'M', u'α'),
    (0x1D6A9, 'M', u'β'),
    (0x1D6AA, 'M', u'γ'),
    (0x1D6AB, 'M', u'δ'),
    (0x1D6AC, 'M', u'ε'),
    (0x1D6AD, 'M', u'ζ'),
    (0x1D6AE, 'M', u'η'),
    (0x1D6AF, 'M', u'θ'),
    (0x1D6B0, 'M', u'ι'),
    (0x1D6B1, 'M', u'κ'),
    (0x1D6B2, 'M', u'λ'),
    (0x1D6B3, 'M', u'μ'),
    (0x1D6B4, 'M', u'ν'),
    (0x1D6B5, 'M', u'ξ'),
    (0x1D6B6, 'M', u'ο'),
    (0x1D6B7, 'M', u'π'),
    (0x1D6B8, 'M', u'ρ'),
    (0x1D6B9, 'M', u'θ'),
    (0x1D6BA, 'M', u'σ'),
    (0x1D6BB, 'M', u'τ'),
    ]

def _seg_65():
    return [
    (0x1D6BC, 'M', u'υ'),
    (0x1D6BD, 'M', u'φ'),
    (0x1D6BE, 'M', u'χ'),
    (0x1D6BF, 'M', u'ψ'),
    (0x1D6C0, 'M', u'ω'),
    (0x1D6C1, 'M', u'∇'),
    (0x1D6C2, 'M', u'α'),
    (0x1D6C3, 'M', u'β'),
    (0x1D6C4, 'M', u'γ'),
    (0x1D6C5, 'M', u'δ'),
    (0x1D6C6, 'M', u'ε'),
    (0x1D6C7, 'M', u'ζ'),
    (0x1D6C8, 'M', u'η'),
    (0x1D6C9, 'M', u'θ'),
    (0x1D6CA, 'M', u'ι'),
    (0x1D6CB, 'M', u'κ'),
    (0x1D6CC, 'M', u'λ'),
    (0x1D6CD, 'M', u'μ'),
    (0x1D6CE, 'M', u'ν'),
    (0x1D6CF, 'M', u'ξ'),
    (0x1D6D0, 'M', u'ο'),
    (0x1D6D1, 'M', u'π'),
    (0x1D6D2, 'M', u'ρ'),
    (0x1D6D3, 'M', u'σ'),
    (0x1D6D5, 'M', u'τ'),
    (0x1D6D6, 'M', u'υ'),
    (0x1D6D7, 'M', u'φ'),
    (0x1D6D8, 'M', u'χ'),
    (0x1D6D9, 'M', u'ψ'),
    (0x1D6DA, 'M', u'ω'),
    (0x1D6DB, 'M', u'∂'),
    (0x1D6DC, 'M', u'ε'),
    (0x1D6DD, 'M', u'θ'),
    (0x1D6DE, 'M', u'κ'),
    (0x1D6DF, 'M', u'φ'),
    (0x1D6E0, 'M', u'ρ'),
    (0x1D6E1, 'M', u'π'),
    (0x1D6E2, 'M', u'α'),
    (0x1D6E3, 'M', u'β'),
    (0x1D6E4, 'M', u'γ'),
    (0x1D6E5, 'M', u'δ'),
    (0x1D6E6, 'M', u'ε'),
    (0x1D6E7, 'M', u'ζ'),
    (0x1D6E8, 'M', u'η'),
    (0x1D6E9, 'M', u'θ'),
    (0x1D6EA, 'M', u'ι'),
    (0x1D6EB, 'M', u'κ'),
    (0x1D6EC, 'M', u'λ'),
    (0x1D6ED, 'M', u'μ'),
    (0x1D6EE, 'M', u'ν'),
    (0x1D6EF, 'M', u'ξ'),
    (0x1D6F0, 'M', u'ο'),
    (0x1D6F1, 'M', u'π'),
    (0x1D6F2, 'M', u'ρ'),
    (0x1D6F3, 'M', u'θ'),
    (0x1D6F4, 'M', u'σ'),
    (0x1D6F5, 'M', u'τ'),
    (0x1D6F6, 'M', u'υ'),
    (0x1D6F7, 'M', u'φ'),
    (0x1D6F8, 'M', u'χ'),
    (0x1D6F9, 'M', u'ψ'),
    (0x1D6FA, 'M', u'ω'),
    (0x1D6FB, 'M', u'∇'),
    (0x1D6FC, 'M', u'α'),
    (0x1D6FD, 'M', u'β'),
    (0x1D6FE, 'M', u'γ'),
    (0x1D6FF, 'M', u'δ'),
    (0x1D700, 'M', u'ε'),
    (0x1D701, 'M', u'ζ'),
    (0x1D702, 'M', u'η'),
    (0x1D703, 'M', u'θ'),
    (0x1D704, 'M', u'ι'),
    (0x1D705, 'M', u'κ'),
    (0x1D706, 'M', u'λ'),
    (0x1D707, 'M', u'μ'),
    (0x1D708, 'M', u'ν'),
    (0x1D709, 'M', u'ξ'),
    (0x1D70A, 'M', u'ο'),
    (0x1D70B, 'M', u'π'),
    (0x1D70C, 'M', u'ρ'),
    (0x1D70D, 'M', u'σ'),
    (0x1D70F, 'M', u'τ'),
    (0x1D710, 'M', u'υ'),
    (0x1D711, 'M', u'φ'),
    (0x1D712, 'M', u'χ'),
    (0x1D713, 'M', u'ψ'),
    (0x1D714, 'M', u'ω'),
    (0x1D715, 'M', u'∂'),
    (0x1D716, 'M', u'ε'),
    (0x1D717, 'M', u'θ'),
    (0x1D718, 'M', u'κ'),
    (0x1D719, 'M', u'φ'),
    (0x1D71A, 'M', u'ρ'),
    (0x1D71B, 'M', u'π'),
    (0x1D71C, 'M', u'α'),
    (0x1D71D, 'M', u'β'),
    (0x1D71E, 'M', u'γ'),
    (0x1D71F, 'M', u'δ'),
    (0x1D720, 'M', u'ε'),
    (0x1D721, 'M', u'ζ'),
    ]

def _seg_66():
    return [
    (0x1D722, 'M', u'η'),
    (0x1D723, 'M', u'θ'),
    (0x1D724, 'M', u'ι'),
    (0x1D725, 'M', u'κ'),
    (0x1D726, 'M', u'λ'),
    (0x1D727, 'M', u'μ'),
    (0x1D728, 'M', u'ν'),
    (0x1D729, 'M', u'ξ'),
    (0x1D72A, 'M', u'ο'),
    (0x1D72B, 'M', u'π'),
    (0x1D72C, 'M', u'ρ'),
    (0x1D72D, 'M', u'θ'),
    (0x1D72E, 'M', u'σ'),
    (0x1D72F, 'M', u'τ'),
    (0x1D730, 'M', u'υ'),
    (0x1D731, 'M', u'φ'),
    (0x1D732, 'M', u'χ'),
    (0x1D733, 'M', u'ψ'),
    (0x1D734, 'M', u'ω'),
    (0x1D735, 'M', u'∇'),
    (0x1D736, 'M', u'α'),
    (0x1D737, 'M', u'β'),
    (0x1D738, 'M', u'γ'),
    (0x1D739, 'M', u'δ'),
    (0x1D73A, 'M', u'ε'),
    (0x1D73B, 'M', u'ζ'),
    (0x1D73C, 'M', u'η'),
    (0x1D73D, 'M', u'θ'),
    (0x1D73E, 'M', u'ι'),
    (0x1D73F, 'M', u'κ'),
    (0x1D740, 'M', u'λ'),
    (0x1D741, 'M', u'μ'),
    (0x1D742, 'M', u'ν'),
    (0x1D743, 'M', u'ξ'),
    (0x1D744, 'M', u'ο'),
    (0x1D745, 'M', u'π'),
    (0x1D746, 'M', u'ρ'),
    (0x1D747, 'M', u'σ'),
    (0x1D749, 'M', u'τ'),
    (0x1D74A, 'M', u'υ'),
    (0x1D74B, 'M', u'φ'),
    (0x1D74C, 'M', u'χ'),
    (0x1D74D, 'M', u'ψ'),
    (0x1D74E, 'M', u'ω'),
    (0x1D74F, 'M', u'∂'),
    (0x1D750, 'M', u'ε'),
    (0x1D751, 'M', u'θ'),
    (0x1D752, 'M', u'κ'),
    (0x1D753, 'M', u'φ'),
    (0x1D754, 'M', u'ρ'),
    (0x1D755, 'M', u'π'),
    (0x1D756, 'M', u'α'),
    (0x1D757, 'M', u'β'),
    (0x1D758, 'M', u'γ'),
    (0x1D759, 'M', u'δ'),
    (0x1D75A, 'M', u'ε'),
    (0x1D75B, 'M', u'ζ'),
    (0x1D75C, 'M', u'η'),
    (0x1D75D, 'M', u'θ'),
    (0x1D75E, 'M', u'ι'),
    (0x1D75F, 'M', u'κ'),
    (0x1D760, 'M', u'λ'),
    (0x1D761, 'M', u'μ'),
    (0x1D762, 'M', u'ν'),
    (0x1D763, 'M', u'ξ'),
    (0x1D764, 'M', u'ο'),
    (0x1D765, 'M', u'π'),
    (0x1D766, 'M', u'ρ'),
    (0x1D767, 'M', u'θ'),
    (0x1D768, 'M', u'σ'),
    (0x1D769, 'M', u'τ'),
    (0x1D76A, 'M', u'υ'),
    (0x1D76B, 'M', u'φ'),
    (0x1D76C, 'M', u'χ'),
    (0x1D76D, 'M', u'ψ'),
    (0x1D76E, 'M', u'ω'),
    (0x1D76F, 'M', u'∇'),
    (0x1D770, 'M', u'α'),
    (0x1D771, 'M', u'β'),
    (0x1D772, 'M', u'γ'),
    (0x1D773, 'M', u'δ'),
    (0x1D774, 'M', u'ε'),
    (0x1D775, 'M', u'ζ'),
    (0x1D776, 'M', u'η'),
    (0x1D777, 'M', u'θ'),
    (0x1D778, 'M', u'ι'),
    (0x1D779, 'M', u'κ'),
    (0x1D77A, 'M', u'λ'),
    (0x1D77B, 'M', u'μ'),
    (0x1D77C, 'M', u'ν'),
    (0x1D77D, 'M', u'ξ'),
    (0x1D77E, 'M', u'ο'),
    (0x1D77F, 'M', u'π'),
    (0x1D780, 'M', u'ρ'),
    (0x1D781, 'M', u'σ'),
    (0x1D783, 'M', u'τ'),
    (0x1D784, 'M', u'υ'),
    (0x1D785, 'M', u'φ'),
    (0x1D786, 'M', u'χ'),
    (0x1D787, 'M', u'ψ'),
    ]

def _seg_67():
    return [
    (0x1D788, 'M', u'ω'),
    (0x1D789, 'M', u'∂'),
    (0x1D78A, 'M', u'ε'),
    (0x1D78B, 'M', u'θ'),
    (0x1D78C, 'M', u'κ'),
    (0x1D78D, 'M', u'φ'),
    (0x1D78E, 'M', u'ρ'),
    (0x1D78F, 'M', u'π'),
    (0x1D790, 'M', u'α'),
    (0x1D791, 'M', u'β'),
    (0x1D792, 'M', u'γ'),
    (0x1D793, 'M', u'δ'),
    (0x1D794, 'M', u'ε'),
    (0x1D795, 'M', u'ζ'),
    (0x1D796, 'M', u'η'),
    (0x1D797, 'M', u'θ'),
    (0x1D798, 'M', u'ι'),
    (0x1D799, 'M', u'κ'),
    (0x1D79A, 'M', u'λ'),
    (0x1D79B, 'M', u'μ'),
    (0x1D79C, 'M', u'ν'),
    (0x1D79D, 'M', u'ξ'),
    (0x1D79E, 'M', u'ο'),
    (0x1D79F, 'M', u'π'),
    (0x1D7A0, 'M', u'ρ'),
    (0x1D7A1, 'M', u'θ'),
    (0x1D7A2, 'M', u'σ'),
    (0x1D7A3, 'M', u'τ'),
    (0x1D7A4, 'M', u'υ'),
    (0x1D7A5, 'M', u'φ'),
    (0x1D7A6, 'M', u'χ'),
    (0x1D7A7, 'M', u'ψ'),
    (0x1D7A8, 'M', u'ω'),
    (0x1D7A9, 'M', u'∇'),
    (0x1D7AA, 'M', u'α'),
    (0x1D7AB, 'M', u'β'),
    (0x1D7AC, 'M', u'γ'),
    (0x1D7AD, 'M', u'δ'),
    (0x1D7AE, 'M', u'ε'),
    (0x1D7AF, 'M', u'ζ'),
    (0x1D7B0, 'M', u'η'),
    (0x1D7B1, 'M', u'θ'),
    (0x1D7B2, 'M', u'ι'),
    (0x1D7B3, 'M', u'κ'),
    (0x1D7B4, 'M', u'λ'),
    (0x1D7B5, 'M', u'μ'),
    (0x1D7B6, 'M', u'ν'),
    (0x1D7B7, 'M', u'ξ'),
    (0x1D7B8, 'M', u'ο'),
    (0x1D7B9, 'M', u'π'),
    (0x1D7BA, 'M', u'ρ'),
    (0x1D7BB, 'M', u'σ'),
    (0x1D7BD, 'M', u'τ'),
    (0x1D7BE, 'M', u'υ'),
    (0x1D7BF, 'M', u'φ'),
    (0x1D7C0, 'M', u'χ'),
    (0x1D7C1, 'M', u'ψ'),
    (0x1D7C2, 'M', u'ω'),
    (0x1D7C3, 'M', u'∂'),
    (0x1D7C4, 'M', u'ε'),
    (0x1D7C5, 'M', u'θ'),
    (0x1D7C6, 'M', u'κ'),
    (0x1D7C7, 'M', u'φ'),
    (0x1D7C8, 'M', u'ρ'),
    (0x1D7C9, 'M', u'π'),
    (0x1D7CA, 'M', u'ϝ'),
    (0x1D7CC, 'X'),
    (0x1D7CE, 'M', u'0'),
    (0x1D7CF, 'M', u'1'),
    (0x1D7D0, 'M', u'2'),
    (0x1D7D1, 'M', u'3'),
    (0x1D7D2, 'M', u'4'),
    (0x1D7D3, 'M', u'5'),
    (0x1D7D4, 'M', u'6'),
    (0x1D7D5, 'M', u'7'),
    (0x1D7D6, 'M', u'8'),
    (0x1D7D7, 'M', u'9'),
    (0x1D7D8, 'M', u'0'),
    (0x1D7D9, 'M', u'1'),
    (0x1D7DA, 'M', u'2'),
    (0x1D7DB, 'M', u'3'),
    (0x1D7DC, 'M', u'4'),
    (0x1D7DD, 'M', u'5'),
    (0x1D7DE, 'M', u'6'),
    (0x1D7DF, 'M', u'7'),
    (0x1D7E0, 'M', u'8'),
    (0x1D7E1, 'M', u'9'),
    (0x1D7E2, 'M', u'0'),
    (0x1D7E3, 'M', u'1'),
    (0x1D7E4, 'M', u'2'),
    (0x1D7E5, 'M', u'3'),
    (0x1D7E6, 'M', u'4'),
    (0x1D7E7, 'M', u'5'),
    (0x1D7E8, 'M', u'6'),
    (0x1D7E9, 'M', u'7'),
    (0x1D7EA, 'M', u'8'),
    (0x1D7EB, 'M', u'9'),
    (0x1D7EC, 'M', u'0'),
    (0x1D7ED, 'M', u'1'),
    (0x1D7EE, 'M', u'2'),
    ]

def _seg_68():
    return [
    (0x1D7EF, 'M', u'3'),
    (0x1D7F0, 'M', u'4'),
    (0x1D7F1, 'M', u'5'),
    (0x1D7F2, 'M', u'6'),
    (0x1D7F3, 'M', u'7'),
    (0x1D7F4, 'M', u'8'),
    (0x1D7F5, 'M', u'9'),
    (0x1D7F6, 'M', u'0'),
    (0x1D7F7, 'M', u'1'),
    (0x1D7F8, 'M', u'2'),
    (0x1D7F9, 'M', u'3'),
    (0x1D7FA, 'M', u'4'),
    (0x1D7FB, 'M', u'5'),
    (0x1D7FC, 'M', u'6'),
    (0x1D7FD, 'M', u'7'),
    (0x1D7FE, 'M', u'8'),
    (0x1D7FF, 'M', u'9'),
    (0x1D800, 'V'),
    (0x1DA8C, 'X'),
    (0x1DA9B, 'V'),
    (0x1DAA0, 'X'),
    (0x1DAA1, 'V'),
    (0x1DAB0, 'X'),
    (0x1E000, 'V'),
    (0x1E007, 'X'),
    (0x1E008, 'V'),
    (0x1E019, 'X'),
    (0x1E01B, 'V'),
    (0x1E022, 'X'),
    (0x1E023, 'V'),
    (0x1E025, 'X'),
    (0x1E026, 'V'),
    (0x1E02B, 'X'),
    (0x1E800, 'V'),
    (0x1E8C5, 'X'),
    (0x1E8C7, 'V'),
    (0x1E8D7, 'X'),
    (0x1E900, 'M', u'𞤢'),
    (0x1E901, 'M', u'𞤣'),
    (0x1E902, 'M', u'𞤤'),
    (0x1E903, 'M', u'𞤥'),
    (0x1E904, 'M', u'𞤦'),
    (0x1E905, 'M', u'𞤧'),
    (0x1E906, 'M', u'𞤨'),
    (0x1E907, 'M', u'𞤩'),
    (0x1E908, 'M', u'𞤪'),
    (0x1E909, 'M', u'𞤫'),
    (0x1E90A, 'M', u'𞤬'),
    (0x1E90B, 'M', u'𞤭'),
    (0x1E90C, 'M', u'𞤮'),
    (0x1E90D, 'M', u'𞤯'),
    (0x1E90E, 'M', u'𞤰'),
    (0x1E90F, 'M', u'𞤱'),
    (0x1E910, 'M', u'𞤲'),
    (0x1E911, 'M', u'𞤳'),
    (0x1E912, 'M', u'𞤴'),
    (0x1E913, 'M', u'𞤵'),
    (0x1E914, 'M', u'𞤶'),
    (0x1E915, 'M', u'𞤷'),
    (0x1E916, 'M', u'𞤸'),
    (0x1E917, 'M', u'𞤹'),
    (0x1E918, 'M', u'𞤺'),
    (0x1E919, 'M', u'𞤻'),
    (0x1E91A, 'M', u'𞤼'),
    (0x1E91B, 'M', u'𞤽'),
    (0x1E91C, 'M', u'𞤾'),
    (0x1E91D, 'M', u'𞤿'),
    (0x1E91E, 'M', u'𞥀'),
    (0x1E91F, 'M', u'𞥁'),
    (0x1E920, 'M', u'𞥂'),
    (0x1E921, 'M', u'𞥃'),
    (0x1E922, 'V'),
    (0x1E94B, 'X'),
    (0x1E950, 'V'),
    (0x1E95A, 'X'),
    (0x1E95E, 'V'),
    (0x1E960, 'X'),
    (0x1EC71, 'V'),
    (0x1ECB5, 'X'),
    (0x1EE00, 'M', u'ا'),
    (0x1EE01, 'M', u'ب'),
    (0x1EE02, 'M', u'ج'),
    (0x1EE03, 'M', u'د'),
    (0x1EE04, 'X'),
    (0x1EE05, 'M', u'و'),
    (0x1EE06, 'M', u'ز'),
    (0x1EE07, 'M', u'ح'),
    (0x1EE08, 'M', u'ط'),
    (0x1EE09, 'M', u'ي'),
    (0x1EE0A, 'M', u'ك'),
    (0x1EE0B, 'M', u'ل'),
    (0x1EE0C, 'M', u'م'),
    (0x1EE0D, 'M', u'ن'),
    (0x1EE0E, 'M', u'س'),
    (0x1EE0F, 'M', u'ع'),
    (0x1EE10, 'M', u'ف'),
    (0x1EE11, 'M', u'ص'),
    (0x1EE12, 'M', u'ق'),
    (0x1EE13, 'M', u'ر'),
    (0x1EE14, 'M', u'ش'),
    ]

def _seg_69():
    return [
    (0x1EE15, 'M', u'ت'),
    (0x1EE16, 'M', u'ث'),
    (0x1EE17, 'M', u'خ'),
    (0x1EE18, 'M', u'ذ'),
    (0x1EE19, 'M', u'ض'),
    (0x1EE1A, 'M', u'ظ'),
    (0x1EE1B, 'M', u'غ'),
    (0x1EE1C, 'M', u'ٮ'),
    (0x1EE1D, 'M', u'ں'),
    (0x1EE1E, 'M', u'ڡ'),
    (0x1EE1F, 'M', u'ٯ'),
    (0x1EE20, 'X'),
    (0x1EE21, 'M', u'ب'),
    (0x1EE22, 'M', u'ج'),
    (0x1EE23, 'X'),
    (0x1EE24, 'M', u'ه'),
    (0x1EE25, 'X'),
    (0x1EE27, 'M', u'ح'),
    (0x1EE28, 'X'),
    (0x1EE29, 'M', u'ي'),
    (0x1EE2A, 'M', u'ك'),
    (0x1EE2B, 'M', u'ل'),
    (0x1EE2C, 'M', u'م'),
    (0x1EE2D, 'M', u'ن'),
    (0x1EE2E, 'M', u'س'),
    (0x1EE2F, 'M', u'ع'),
    (0x1EE30, 'M', u'ف'),
    (0x1EE31, 'M', u'ص'),
    (0x1EE32, 'M', u'ق'),
    (0x1EE33, 'X'),
    (0x1EE34, 'M', u'ش'),
    (0x1EE35, 'M', u'ت'),
    (0x1EE36, 'M', u'ث'),
    (0x1EE37, 'M', u'خ'),
    (0x1EE38, 'X'),
    (0x1EE39, 'M', u'ض'),
    (0x1EE3A, 'X'),
    (0x1EE3B, 'M', u'غ'),
    (0x1EE3C, 'X'),
    (0x1EE42, 'M', u'ج'),
    (0x1EE43, 'X'),
    (0x1EE47, 'M', u'ح'),
    (0x1EE48, 'X'),
    (0x1EE49, 'M', u'ي'),
    (0x1EE4A, 'X'),
    (0x1EE4B, 'M', u'ل'),
    (0x1EE4C, 'X'),
    (0x1EE4D, 'M', u'ن'),
    (0x1EE4E, 'M', u'س'),
    (0x1EE4F, 'M', u'ع'),
    (0x1EE50, 'X'),
    (0x1EE51, 'M', u'ص'),
    (0x1EE52, 'M', u'ق'),
    (0x1EE53, 'X'),
    (0x1EE54, 'M', u'ش'),
    (0x1EE55, 'X'),
    (0x1EE57, 'M', u'خ'),
    (0x1EE58, 'X'),
    (0x1EE59, 'M', u'ض'),
    (0x1EE5A, 'X'),
    (0x1EE5B, 'M', u'غ'),
    (0x1EE5C, 'X'),
    (0x1EE5D, 'M', u'ں'),
    (0x1EE5E, 'X'),
    (0x1EE5F, 'M', u'ٯ'),
    (0x1EE60, 'X'),
    (0x1EE61, 'M', u'ب'),
    (0x1EE62, 'M', u'ج'),
    (0x1EE63, 'X'),
    (0x1EE64, 'M', u'ه'),
    (0x1EE65, 'X'),
    (0x1EE67, 'M', u'ح'),
    (0x1EE68, 'M', u'ط'),
    (0x1EE69, 'M', u'ي'),
    (0x1EE6A, 'M', u'ك'),
    (0x1EE6B, 'X'),
    (0x1EE6C, 'M', u'م'),
    (0x1EE6D, 'M', u'ن'),
    (0x1EE6E, 'M', u'س'),
    (0x1EE6F, 'M', u'ع'),
    (0x1EE70, 'M', u'ف'),
    (0x1EE71, 'M', u'ص'),
    (0x1EE72, 'M', u'ق'),
    (0x1EE73, 'X'),
    (0x1EE74, 'M', u'ش'),
    (0x1EE75, 'M', u'ت'),
    (0x1EE76, 'M', u'ث'),
    (0x1EE77, 'M', u'خ'),
    (0x1EE78, 'X'),
    (0x1EE79, 'M', u'ض'),
    (0x1EE7A, 'M', u'ظ'),
    (0x1EE7B, 'M', u'غ'),
    (0x1EE7C, 'M', u'ٮ'),
    (0x1EE7D, 'X'),
    (0x1EE7E, 'M', u'ڡ'),
    (0x1EE7F, 'X'),
    (0x1EE80, 'M', u'ا'),
    (0x1EE81, 'M', u'ب'),
    (0x1EE82, 'M', u'ج'),
    (0x1EE83, 'M', u'د'),
    ]

def _seg_70():
    return [
    (0x1EE84, 'M', u'ه'),
    (0x1EE85, 'M', u'و'),
    (0x1EE86, 'M', u'ز'),
    (0x1EE87, 'M', u'ح'),
    (0x1EE88, 'M', u'ط'),
    (0x1EE89, 'M', u'ي'),
    (0x1EE8A, 'X'),
    (0x1EE8B, 'M', u'ل'),
    (0x1EE8C, 'M', u'م'),
    (0x1EE8D, 'M', u'ن'),
    (0x1EE8E, 'M', u'س'),
    (0x1EE8F, 'M', u'ع'),
    (0x1EE90, 'M', u'ف'),
    (0x1EE91, 'M', u'ص'),
    (0x1EE92, 'M', u'ق'),
    (0x1EE93, 'M', u'ر'),
    (0x1EE94, 'M', u'ش'),
    (0x1EE95, 'M', u'ت'),
    (0x1EE96, 'M', u'ث'),
    (0x1EE97, 'M', u'خ'),
    (0x1EE98, 'M', u'ذ'),
    (0x1EE99, 'M', u'ض'),
    (0x1EE9A, 'M', u'ظ'),
    (0x1EE9B, 'M', u'غ'),
    (0x1EE9C, 'X'),
    (0x1EEA1, 'M', u'ب'),
    (0x1EEA2, 'M', u'ج'),
    (0x1EEA3, 'M', u'د'),
    (0x1EEA4, 'X'),
    (0x1EEA5, 'M', u'و'),
    (0x1EEA6, 'M', u'ز'),
    (0x1EEA7, 'M', u'ح'),
    (0x1EEA8, 'M', u'ط'),
    (0x1EEA9, 'M', u'ي'),
    (0x1EEAA, 'X'),
    (0x1EEAB, 'M', u'ل'),
    (0x1EEAC, 'M', u'م'),
    (0x1EEAD, 'M', u'ن'),
    (0x1EEAE, 'M', u'س'),
    (0x1EEAF, 'M', u'ع'),
    (0x1EEB0, 'M', u'ف'),
    (0x1EEB1, 'M', u'ص'),
    (0x1EEB2, 'M', u'ق'),
    (0x1EEB3, 'M', u'ر'),
    (0x1EEB4, 'M', u'ش'),
    (0x1EEB5, 'M', u'ت'),
    (0x1EEB6, 'M', u'ث'),
    (0x1EEB7, 'M', u'خ'),
    (0x1EEB8, 'M', u'ذ'),
    (0x1EEB9, 'M', u'ض'),
    (0x1EEBA, 'M', u'ظ'),
    (0x1EEBB, 'M', u'غ'),
    (0x1EEBC, 'X'),
    (0x1EEF0, 'V'),
    (0x1EEF2, 'X'),
    (0x1F000, 'V'),
    (0x1F02C, 'X'),
    (0x1F030, 'V'),
    (0x1F094, 'X'),
    (0x1F0A0, 'V'),
    (0x1F0AF, 'X'),
    (0x1F0B1, 'V'),
    (0x1F0C0, 'X'),
    (0x1F0C1, 'V'),
    (0x1F0D0, 'X'),
    (0x1F0D1, 'V'),
    (0x1F0F6, 'X'),
    (0x1F101, '3', u'0,'),
    (0x1F102, '3', u'1,'),
    (0x1F103, '3', u'2,'),
    (0x1F104, '3', u'3,'),
    (0x1F105, '3', u'4,'),
    (0x1F106, '3', u'5,'),
    (0x1F107, '3', u'6,'),
    (0x1F108, '3', u'7,'),
    (0x1F109, '3', u'8,'),
    (0x1F10A, '3', u'9,'),
    (0x1F10B, 'V'),
    (0x1F10D, 'X'),
    (0x1F110, '3', u'(a)'),
    (0x1F111, '3', u'(b)'),
    (0x1F112, '3', u'(c)'),
    (0x1F113, '3', u'(d)'),
    (0x1F114, '3', u'(e)'),
    (0x1F115, '3', u'(f)'),
    (0x1F116, '3', u'(g)'),
    (0x1F117, '3', u'(h)'),
    (0x1F118, '3', u'(i)'),
    (0x1F119, '3', u'(j)'),
    (0x1F11A, '3', u'(k)'),
    (0x1F11B, '3', u'(l)'),
    (0x1F11C, '3', u'(m)'),
    (0x1F11D, '3', u'(n)'),
    (0x1F11E, '3', u'(o)'),
    (0x1F11F, '3', u'(p)'),
    (0x1F120, '3', u'(q)'),
    (0x1F121, '3', u'(r)'),
    (0x1F122, '3', u'(s)'),
    (0x1F123, '3', u'(t)'),
    (0x1F124, '3', u'(u)'),
    ]

def _seg_71():
    return [
    (0x1F125, '3', u'(v)'),
    (0x1F126, '3', u'(w)'),
    (0x1F127, '3', u'(x)'),
    (0x1F128, '3', u'(y)'),
    (0x1F129, '3', u'(z)'),
    (0x1F12A, 'M', u'〔s〕'),
    (0x1F12B, 'M', u'c'),
    (0x1F12C, 'M', u'r'),
    (0x1F12D, 'M', u'cd'),
    (0x1F12E, 'M', u'wz'),
    (0x1F12F, 'V'),
    (0x1F130, 'M', u'a'),
    (0x1F131, 'M', u'b'),
    (0x1F132, 'M', u'c'),
    (0x1F133, 'M', u'd'),
    (0x1F134, 'M', u'e'),
    (0x1F135, 'M', u'f'),
    (0x1F136, 'M', u'g'),
    (0x1F137, 'M', u'h'),
    (0x1F138, 'M', u'i'),
    (0x1F139, 'M', u'j'),
    (0x1F13A, 'M', u'k'),
    (0x1F13B, 'M', u'l'),
    (0x1F13C, 'M', u'm'),
    (0x1F13D, 'M', u'n'),
    (0x1F13E, 'M', u'o'),
    (0x1F13F, 'M', u'p'),
    (0x1F140, 'M', u'q'),
    (0x1F141, 'M', u'r'),
    (0x1F142, 'M', u's'),
    (0x1F143, 'M', u't'),
    (0x1F144, 'M', u'u'),
    (0x1F145, 'M', u'v'),
    (0x1F146, 'M', u'w'),
    (0x1F147, 'M', u'x'),
    (0x1F148, 'M', u'y'),
    (0x1F149, 'M', u'z'),
    (0x1F14A, 'M', u'hv'),
    (0x1F14B, 'M', u'mv'),
    (0x1F14C, 'M', u'sd'),
    (0x1F14D, 'M', u'ss'),
    (0x1F14E, 'M', u'ppv'),
    (0x1F14F, 'M', u'wc'),
    (0x1F150, 'V'),
    (0x1F16A, 'M', u'mc'),
    (0x1F16B, 'M', u'md'),
    (0x1F16C, 'X'),
    (0x1F170, 'V'),
    (0x1F190, 'M', u'dj'),
    (0x1F191, 'V'),
    (0x1F1AD, 'X'),
    (0x1F1E6, 'V'),
    (0x1F200, 'M', u'ほか'),
    (0x1F201, 'M', u'ココ'),
    (0x1F202, 'M', u'サ'),
    (0x1F203, 'X'),
    (0x1F210, 'M', u'手'),
    (0x1F211, 'M', u'字'),
    (0x1F212, 'M', u'双'),
    (0x1F213, 'M', u'デ'),
    (0x1F214, 'M', u'二'),
    (0x1F215, 'M', u'多'),
    (0x1F216, 'M', u'解'),
    (0x1F217, 'M', u'天'),
    (0x1F218, 'M', u'交'),
    (0x1F219, 'M', u'映'),
    (0x1F21A, 'M', u'無'),
    (0x1F21B, 'M', u'料'),
    (0x1F21C, 'M', u'前'),
    (0x1F21D, 'M', u'後'),
    (0x1F21E, 'M', u'再'),
    (0x1F21F, 'M', u'新'),
    (0x1F220, 'M', u'初'),
    (0x1F221, 'M', u'終'),
    (0x1F222, 'M', u'生'),
    (0x1F223, 'M', u'販'),
    (0x1F224, 'M', u'声'),
    (0x1F225, 'M', u'吹'),
    (0x1F226, 'M', u'演'),
    (0x1F227, 'M', u'投'),
    (0x1F228, 'M', u'捕'),
    (0x1F229, 'M', u'一'),
    (0x1F22A, 'M', u'三'),
    (0x1F22B, 'M', u'遊'),
    (0x1F22C, 'M', u'左'),
    (0x1F22D, 'M', u'中'),
    (0x1F22E, 'M', u'右'),
    (0x1F22F, 'M', u'指'),
    (0x1F230, 'M', u'走'),
    (0x1F231, 'M', u'打'),
    (0x1F232, 'M', u'禁'),
    (0x1F233, 'M', u'空'),
    (0x1F234, 'M', u'合'),
    (0x1F235, 'M', u'満'),
    (0x1F236, 'M', u'有'),
    (0x1F237, 'M', u'月'),
    (0x1F238, 'M', u'申'),
    (0x1F239, 'M', u'割'),
    (0x1F23A, 'M', u'営'),
    (0x1F23B, 'M', u'配'),
    ]

def _seg_72():
    return [
    (0x1F23C, 'X'),
    (0x1F240, 'M', u'〔本〕'),
    (0x1F241, 'M', u'〔三〕'),
    (0x1F242, 'M', u'〔二〕'),
    (0x1F243, 'M', u'〔安〕'),
    (0x1F244, 'M', u'〔点〕'),
    (0x1F245, 'M', u'〔打〕'),
    (0x1F246, 'M', u'〔盗〕'),
    (0x1F247, 'M', u'〔勝〕'),
    (0x1F248, 'M', u'〔敗〕'),
    (0x1F249, 'X'),
    (0x1F250, 'M', u'得'),
    (0x1F251, 'M', u'可'),
    (0x1F252, 'X'),
    (0x1F260, 'V'),
    (0x1F266, 'X'),
    (0x1F300, 'V'),
    (0x1F6D5, 'X'),
    (0x1F6E0, 'V'),
    (0x1F6ED, 'X'),
    (0x1F6F0, 'V'),
    (0x1F6FA, 'X'),
    (0x1F700, 'V'),
    (0x1F774, 'X'),
    (0x1F780, 'V'),
    (0x1F7D9, 'X'),
    (0x1F800, 'V'),
    (0x1F80C, 'X'),
    (0x1F810, 'V'),
    (0x1F848, 'X'),
    (0x1F850, 'V'),
    (0x1F85A, 'X'),
    (0x1F860, 'V'),
    (0x1F888, 'X'),
    (0x1F890, 'V'),
    (0x1F8AE, 'X'),
    (0x1F900, 'V'),
    (0x1F90C, 'X'),
    (0x1F910, 'V'),
    (0x1F93F, 'X'),
    (0x1F940, 'V'),
    (0x1F971, 'X'),
    (0x1F973, 'V'),
    (0x1F977, 'X'),
    (0x1F97A, 'V'),
    (0x1F97B, 'X'),
    (0x1F97C, 'V'),
    (0x1F9A3, 'X'),
    (0x1F9B0, 'V'),
    (0x1F9BA, 'X'),
    (0x1F9C0, 'V'),
    (0x1F9C3, 'X'),
    (0x1F9D0, 'V'),
    (0x1FA00, 'X'),
    (0x1FA60, 'V'),
    (0x1FA6E, 'X'),
    (0x20000, 'V'),
    (0x2A6D7, 'X'),
    (0x2A700, 'V'),
    (0x2B735, 'X'),
    (0x2B740, 'V'),
    (0x2B81E, 'X'),
    (0x2B820, 'V'),
    (0x2CEA2, 'X'),
    (0x2CEB0, 'V'),
    (0x2EBE1, 'X'),
    (0x2F800, 'M', u'丽'),
    (0x2F801, 'M', u'丸'),
    (0x2F802, 'M', u'乁'),
    (0x2F803, 'M', u'𠄢'),
    (0x2F804, 'M', u'你'),
    (0x2F805, 'M', u'侮'),
    (0x2F806, 'M', u'侻'),
    (0x2F807, 'M', u'倂'),
    (0x2F808, 'M', u'偺'),
    (0x2F809, 'M', u'備'),
    (0x2F80A, 'M', u'僧'),
    (0x2F80B, 'M', u'像'),
    (0x2F80C, 'M', u'㒞'),
    (0x2F80D, 'M', u'𠘺'),
    (0x2F80E, 'M', u'免'),
    (0x2F80F, 'M', u'兔'),
    (0x2F810, 'M', u'兤'),
    (0x2F811, 'M', u'具'),
    (0x2F812, 'M', u'𠔜'),
    (0x2F813, 'M', u'㒹'),
    (0x2F814, 'M', u'內'),
    (0x2F815, 'M', u'再'),
    (0x2F816, 'M', u'𠕋'),
    (0x2F817, 'M', u'冗'),
    (0x2F818, 'M', u'冤'),
    (0x2F819, 'M', u'仌'),
    (0x2F81A, 'M', u'冬'),
    (0x2F81B, 'M', u'况'),
    (0x2F81C, 'M', u'𩇟'),
    (0x2F81D, 'M', u'凵'),
    (0x2F81E, 'M', u'刃'),
    (0x2F81F, 'M', u'㓟'),
    (0x2F820, 'M', u'刻'),
    (0x2F821, 'M', u'剆'),
    ]

def _seg_73():
    return [
    (0x2F822, 'M', u'割'),
    (0x2F823, 'M', u'剷'),
    (0x2F824, 'M', u'㔕'),
    (0x2F825, 'M', u'勇'),
    (0x2F826, 'M', u'勉'),
    (0x2F827, 'M', u'勤'),
    (0x2F828, 'M', u'勺'),
    (0x2F829, 'M', u'包'),
    (0x2F82A, 'M', u'匆'),
    (0x2F82B, 'M', u'北'),
    (0x2F82C, 'M', u'卉'),
    (0x2F82D, 'M', u'卑'),
    (0x2F82E, 'M', u'博'),
    (0x2F82F, 'M', u'即'),
    (0x2F830, 'M', u'卽'),
    (0x2F831, 'M', u'卿'),
    (0x2F834, 'M', u'𠨬'),
    (0x2F835, 'M', u'灰'),
    (0x2F836, 'M', u'及'),
    (0x2F837, 'M', u'叟'),
    (0x2F838, 'M', u'𠭣'),
    (0x2F839, 'M', u'叫'),
    (0x2F83A, 'M', u'叱'),
    (0x2F83B, 'M', u'吆'),
    (0x2F83C, 'M', u'咞'),
    (0x2F83D, 'M', u'吸'),
    (0x2F83E, 'M', u'呈'),
    (0x2F83F, 'M', u'周'),
    (0x2F840, 'M', u'咢'),
    (0x2F841, 'M', u'哶'),
    (0x2F842, 'M', u'唐'),
    (0x2F843, 'M', u'啓'),
    (0x2F844, 'M', u'啣'),
    (0x2F845, 'M', u'善'),
    (0x2F847, 'M', u'喙'),
    (0x2F848, 'M', u'喫'),
    (0x2F849, 'M', u'喳'),
    (0x2F84A, 'M', u'嗂'),
    (0x2F84B, 'M', u'圖'),
    (0x2F84C, 'M', u'嘆'),
    (0x2F84D, 'M', u'圗'),
    (0x2F84E, 'M', u'噑'),
    (0x2F84F, 'M', u'噴'),
    (0x2F850, 'M', u'切'),
    (0x2F851, 'M', u'壮'),
    (0x2F852, 'M', u'城'),
    (0x2F853, 'M', u'埴'),
    (0x2F854, 'M', u'堍'),
    (0x2F855, 'M', u'型'),
    (0x2F856, 'M', u'堲'),
    (0x2F857, 'M', u'報'),
    (0x2F858, 'M', u'墬'),
    (0x2F859, 'M', u'𡓤'),
    (0x2F85A, 'M', u'売'),
    (0x2F85B, 'M', u'壷'),
    (0x2F85C, 'M', u'夆'),
    (0x2F85D, 'M', u'多'),
    (0x2F85E, 'M', u'夢'),
    (0x2F85F, 'M', u'奢'),
    (0x2F860, 'M', u'𡚨'),
    (0x2F861, 'M', u'𡛪'),
    (0x2F862, 'M', u'姬'),
    (0x2F863, 'M', u'娛'),
    (0x2F864, 'M', u'娧'),
    (0x2F865, 'M', u'姘'),
    (0x2F866, 'M', u'婦'),
    (0x2F867, 'M', u'㛮'),
    (0x2F868, 'X'),
    (0x2F869, 'M', u'嬈'),
    (0x2F86A, 'M', u'嬾'),
    (0x2F86C, 'M', u'𡧈'),
    (0x2F86D, 'M', u'寃'),
    (0x2F86E, 'M', u'寘'),
    (0x2F86F, 'M', u'寧'),
    (0x2F870, 'M', u'寳'),
    (0x2F871, 'M', u'𡬘'),
    (0x2F872, 'M', u'寿'),
    (0x2F873, 'M', u'将'),
    (0x2F874, 'X'),
    (0x2F875, 'M', u'尢'),
    (0x2F876, 'M', u'㞁'),
    (0x2F877, 'M', u'屠'),
    (0x2F878, 'M', u'屮'),
    (0x2F879, 'M', u'峀'),
    (0x2F87A, 'M', u'岍'),
    (0x2F87B, 'M', u'𡷤'),
    (0x2F87C, 'M', u'嵃'),
    (0x2F87D, 'M', u'𡷦'),
    (0x2F87E, 'M', u'嵮'),
    (0x2F87F, 'M', u'嵫'),
    (0x2F880, 'M', u'嵼'),
    (0x2F881, 'M', u'巡'),
    (0x2F882, 'M', u'巢'),
    (0x2F883, 'M', u'㠯'),
    (0x2F884, 'M', u'巽'),
    (0x2F885, 'M', u'帨'),
    (0x2F886, 'M', u'帽'),
    (0x2F887, 'M', u'幩'),
    (0x2F888, 'M', u'㡢'),
    (0x2F889, 'M', u'𢆃'),
    ]

def _seg_74():
    return [
    (0x2F88A, 'M', u'㡼'),
    (0x2F88B, 'M', u'庰'),
    (0x2F88C, 'M', u'庳'),
    (0x2F88D, 'M', u'庶'),
    (0x2F88E, 'M', u'廊'),
    (0x2F88F, 'M', u'𪎒'),
    (0x2F890, 'M', u'廾'),
    (0x2F891, 'M', u'𢌱'),
    (0x2F893, 'M', u'舁'),
    (0x2F894, 'M', u'弢'),
    (0x2F896, 'M', u'㣇'),
    (0x2F897, 'M', u'𣊸'),
    (0x2F898, 'M', u'𦇚'),
    (0x2F899, 'M', u'形'),
    (0x2F89A, 'M', u'彫'),
    (0x2F89B, 'M', u'㣣'),
    (0x2F89C, 'M', u'徚'),
    (0x2F89D, 'M', u'忍'),
    (0x2F89E, 'M', u'志'),
    (0x2F89F, 'M', u'忹'),
    (0x2F8A0, 'M', u'悁'),
    (0x2F8A1, 'M', u'㤺'),
    (0x2F8A2, 'M', u'㤜'),
    (0x2F8A3, 'M', u'悔'),
    (0x2F8A4, 'M', u'𢛔'),
    (0x2F8A5, 'M', u'惇'),
    (0x2F8A6, 'M', u'慈'),
    (0x2F8A7, 'M', u'慌'),
    (0x2F8A8, 'M', u'慎'),
    (0x2F8A9, 'M', u'慌'),
    (0x2F8AA, 'M', u'慺'),
    (0x2F8AB, 'M', u'憎'),
    (0x2F8AC, 'M', u'憲'),
    (0x2F8AD, 'M', u'憤'),
    (0x2F8AE, 'M', u'憯'),
    (0x2F8AF, 'M', u'懞'),
    (0x2F8B0, 'M', u'懲'),
    (0x2F8B1, 'M', u'懶'),
    (0x2F8B2, 'M', u'成'),
    (0x2F8B3, 'M', u'戛'),
    (0x2F8B4, 'M', u'扝'),
    (0x2F8B5, 'M', u'抱'),
    (0x2F8B6, 'M', u'拔'),
    (0x2F8B7, 'M', u'捐'),
    (0x2F8B8, 'M', u'𢬌'),
    (0x2F8B9, 'M', u'挽'),
    (0x2F8BA, 'M', u'拼'),
    (0x2F8BB, 'M', u'捨'),
    (0x2F8BC, 'M', u'掃'),
    (0x2F8BD, 'M', u'揤'),
    (0x2F8BE, 'M', u'𢯱'),
    (0x2F8BF, 'M', u'搢'),
    (0x2F8C0, 'M', u'揅'),
    (0x2F8C1, 'M', u'掩'),
    (0x2F8C2, 'M', u'㨮'),
    (0x2F8C3, 'M', u'摩'),
    (0x2F8C4, 'M', u'摾'),
    (0x2F8C5, 'M', u'撝'),
    (0x2F8C6, 'M', u'摷'),
    (0x2F8C7, 'M', u'㩬'),
    (0x2F8C8, 'M', u'敏'),
    (0x2F8C9, 'M', u'敬'),
    (0x2F8CA, 'M', u'𣀊'),
    (0x2F8CB, 'M', u'旣'),
    (0x2F8CC, 'M', u'書'),
    (0x2F8CD, 'M', u'晉'),
    (0x2F8CE, 'M', u'㬙'),
    (0x2F8CF, 'M', u'暑'),
    (0x2F8D0, 'M', u'㬈'),
    (0x2F8D1, 'M', u'㫤'),
    (0x2F8D2, 'M', u'冒'),
    (0x2F8D3, 'M', u'冕'),
    (0x2F8D4, 'M', u'最'),
    (0x2F8D5, 'M', u'暜'),
    (0x2F8D6, 'M', u'肭'),
    (0x2F8D7, 'M', u'䏙'),
    (0x2F8D8, 'M', u'朗'),
    (0x2F8D9, 'M', u'望'),
    (0x2F8DA, 'M', u'朡'),
    (0x2F8DB, 'M', u'杞'),
    (0x2F8DC, 'M', u'杓'),
    (0x2F8DD, 'M', u'𣏃'),
    (0x2F8DE, 'M', u'㭉'),
    (0x2F8DF, 'M', u'柺'),
    (0x2F8E0, 'M', u'枅'),
    (0x2F8E1, 'M', u'桒'),
    (0x2F8E2, 'M', u'梅'),
    (0x2F8E3, 'M', u'𣑭'),
    (0x2F8E4, 'M', u'梎'),
    (0x2F8E5, 'M', u'栟'),
    (0x2F8E6, 'M', u'椔'),
    (0x2F8E7, 'M', u'㮝'),
    (0x2F8E8, 'M', u'楂'),
    (0x2F8E9, 'M', u'榣'),
    (0x2F8EA, 'M', u'槪'),
    (0x2F8EB, 'M', u'檨'),
    (0x2F8EC, 'M', u'𣚣'),
    (0x2F8ED, 'M', u'櫛'),
    (0x2F8EE, 'M', u'㰘'),
    (0x2F8EF, 'M', u'次'),
    ]

def _seg_75():
    return [
    (0x2F8F0, 'M', u'𣢧'),
    (0x2F8F1, 'M', u'歔'),
    (0x2F8F2, 'M', u'㱎'),
    (0x2F8F3, 'M', u'歲'),
    (0x2F8F4, 'M', u'殟'),
    (0x2F8F5, 'M', u'殺'),
    (0x2F8F6, 'M', u'殻'),
    (0x2F8F7, 'M', u'𣪍'),
    (0x2F8F8, 'M', u'𡴋'),
    (0x2F8F9, 'M', u'𣫺'),
    (0x2F8FA, 'M', u'汎'),
    (0x2F8FB, 'M', u'𣲼'),
    (0x2F8FC, 'M', u'沿'),
    (0x2F8FD, 'M', u'泍'),
    (0x2F8FE, 'M', u'汧'),
    (0x2F8FF, 'M', u'洖'),
    (0x2F900, 'M', u'派'),
    (0x2F901, 'M', u'海'),
    (0x2F902, 'M', u'流'),
    (0x2F903, 'M', u'浩'),
    (0x2F904, 'M', u'浸'),
    (0x2F905, 'M', u'涅'),
    (0x2F906, 'M', u'𣴞'),
    (0x2F907, 'M', u'洴'),
    (0x2F908, 'M', u'港'),
    (0x2F909, 'M', u'湮'),
    (0x2F90A, 'M', u'㴳'),
    (0x2F90B, 'M', u'滋'),
    (0x2F90C, 'M', u'滇'),
    (0x2F90D, 'M', u'𣻑'),
    (0x2F90E, 'M', u'淹'),
    (0x2F90F, 'M', u'潮'),
    (0x2F910, 'M', u'𣽞'),
    (0x2F911, 'M', u'𣾎'),
    (0x2F912, 'M', u'濆'),
    (0x2F913, 'M', u'瀹'),
    (0x2F914, 'M', u'瀞'),
    (0x2F915, 'M', u'瀛'),
    (0x2F916, 'M', u'㶖'),
    (0x2F917, 'M', u'灊'),
    (0x2F918, 'M', u'災'),
    (0x2F919, 'M', u'灷'),
    (0x2F91A, 'M', u'炭'),
    (0x2F91B, 'M', u'𠔥'),
    (0x2F91C, 'M', u'煅'),
    (0x2F91D, 'M', u'𤉣'),
    (0x2F91E, 'M', u'熜'),
    (0x2F91F, 'X'),
    (0x2F920, 'M', u'爨'),
    (0x2F921, 'M', u'爵'),
    (0x2F922, 'M', u'牐'),
    (0x2F923, 'M', u'𤘈'),
    (0x2F924, 'M', u'犀'),
    (0x2F925, 'M', u'犕'),
    (0x2F926, 'M', u'𤜵'),
    (0x2F927, 'M', u'𤠔'),
    (0x2F928, 'M', u'獺'),
    (0x2F929, 'M', u'王'),
    (0x2F92A, 'M', u'㺬'),
    (0x2F92B, 'M', u'玥'),
    (0x2F92C, 'M', u'㺸'),
    (0x2F92E, 'M', u'瑇'),
    (0x2F92F, 'M', u'瑜'),
    (0x2F930, 'M', u'瑱'),
    (0x2F931, 'M', u'璅'),
    (0x2F932, 'M', u'瓊'),
    (0x2F933, 'M', u'㼛'),
    (0x2F934, 'M', u'甤'),
    (0x2F935, 'M', u'𤰶'),
    (0x2F936, 'M', u'甾'),
    (0x2F937, 'M', u'𤲒'),
    (0x2F938, 'M', u'異'),
    (0x2F939, 'M', u'𢆟'),
    (0x2F93A, 'M', u'瘐'),
    (0x2F93B, 'M', u'𤾡'),
    (0x2F93C, 'M', u'𤾸'),
    (0x2F93D, 'M', u'𥁄'),
    (0x2F93E, 'M', u'㿼'),
    (0x2F93F, 'M', u'䀈'),
    (0x2F940, 'M', u'直'),
    (0x2F941, 'M', u'𥃳'),
    (0x2F942, 'M', u'𥃲'),
    (0x2F943, 'M', u'𥄙'),
    (0x2F944, 'M', u'𥄳'),
    (0x2F945, 'M', u'眞'),
    (0x2F946, 'M', u'真'),
    (0x2F948, 'M', u'睊'),
    (0x2F949, 'M', u'䀹'),
    (0x2F94A, 'M', u'瞋'),
    (0x2F94B, 'M', u'䁆'),
    (0x2F94C, 'M', u'䂖'),
    (0x2F94D, 'M', u'𥐝'),
    (0x2F94E, 'M', u'硎'),
    (0x2F94F, 'M', u'碌'),
    (0x2F950, 'M', u'磌'),
    (0x2F951, 'M', u'䃣'),
    (0x2F952, 'M', u'𥘦'),
    (0x2F953, 'M', u'祖'),
    (0x2F954, 'M', u'𥚚'),
    (0x2F955, 'M', u'𥛅'),
    ]

def _seg_76():
    return [
    (0x2F956, 'M', u'福'),
    (0x2F957, 'M', u'秫'),
    (0x2F958, 'M', u'䄯'),
    (0x2F959, 'M', u'穀'),
    (0x2F95A, 'M', u'穊'),
    (0x2F95B, 'M', u'穏'),
    (0x2F95C, 'M', u'𥥼'),
    (0x2F95D, 'M', u'𥪧'),
    (0x2F95F, 'X'),
    (0x2F960, 'M', u'䈂'),
    (0x2F961, 'M', u'𥮫'),
    (0x2F962, 'M', u'篆'),
    (0x2F963, 'M', u'築'),
    (0x2F964, 'M', u'䈧'),
    (0x2F965, 'M', u'𥲀'),
    (0x2F966, 'M', u'糒'),
    (0x2F967, 'M', u'䊠'),
    (0x2F968, 'M', u'糨'),
    (0x2F969, 'M', u'糣'),
    (0x2F96A, 'M', u'紀'),
    (0x2F96B, 'M', u'𥾆'),
    (0x2F96C, 'M', u'絣'),
    (0x2F96D, 'M', u'䌁'),
    (0x2F96E, 'M', u'緇'),
    (0x2F96F, 'M', u'縂'),
    (0x2F970, 'M', u'繅'),
    (0x2F971, 'M', u'䌴'),
    (0x2F972, 'M', u'𦈨'),
    (0x2F973, 'M', u'𦉇'),
    (0x2F974, 'M', u'䍙'),
    (0x2F975, 'M', u'𦋙'),
    (0x2F976, 'M', u'罺'),
    (0x2F977, 'M', u'𦌾'),
    (0x2F978, 'M', u'羕'),
    (0x2F979, 'M', u'翺'),
    (0x2F97A, 'M', u'者'),
    (0x2F97B, 'M', u'𦓚'),
    (0x2F97C, 'M', u'𦔣'),
    (0x2F97D, 'M', u'聠'),
    (0x2F97E, 'M', u'𦖨'),
    (0x2F97F, 'M', u'聰'),
    (0x2F980, 'M', u'𣍟'),
    (0x2F981, 'M', u'䏕'),
    (0x2F982, 'M', u'育'),
    (0x2F983, 'M', u'脃'),
    (0x2F984, 'M', u'䐋'),
    (0x2F985, 'M', u'脾'),
    (0x2F986, 'M', u'媵'),
    (0x2F987, 'M', u'𦞧'),
    (0x2F988, 'M', u'𦞵'),
    (0x2F989, 'M', u'𣎓'),
    (0x2F98A, 'M', u'𣎜'),
    (0x2F98B, 'M', u'舁'),
    (0x2F98C, 'M', u'舄'),
    (0x2F98D, 'M', u'辞'),
    (0x2F98E, 'M', u'䑫'),
    (0x2F98F, 'M', u'芑'),
    (0x2F990, 'M', u'芋'),
    (0x2F991, 'M', u'芝'),
    (0x2F992, 'M', u'劳'),
    (0x2F993, 'M', u'花'),
    (0x2F994, 'M', u'芳'),
    (0x2F995, 'M', u'芽'),
    (0x2F996, 'M', u'苦'),
    (0x2F997, 'M', u'𦬼'),
    (0x2F998, 'M', u'若'),
    (0x2F999, 'M', u'茝'),
    (0x2F99A, 'M', u'荣'),
    (0x2F99B, 'M', u'莭'),
    (0x2F99C, 'M', u'茣'),
    (0x2F99D, 'M', u'莽'),
    (0x2F99E, 'M', u'菧'),
    (0x2F99F, 'M', u'著'),
    (0x2F9A0, 'M', u'荓'),
    (0x2F9A1, 'M', u'菊'),
    (0x2F9A2, 'M', u'菌'),
    (0x2F9A3, 'M', u'菜'),
    (0x2F9A4, 'M', u'𦰶'),
    (0x2F9A5, 'M', u'𦵫'),
    (0x2F9A6, 'M', u'𦳕'),
    (0x2F9A7, 'M', u'䔫'),
    (0x2F9A8, 'M', u'蓱'),
    (0x2F9A9, 'M', u'蓳'),
    (0x2F9AA, 'M', u'蔖'),
    (0x2F9AB, 'M', u'𧏊'),
    (0x2F9AC, 'M', u'蕤'),
    (0x2F9AD, 'M', u'𦼬'),
    (0x2F9AE, 'M', u'䕝'),
    (0x2F9AF, 'M', u'䕡'),
    (0x2F9B0, 'M', u'𦾱'),
    (0x2F9B1, 'M', u'𧃒'),
    (0x2F9B2, 'M', u'䕫'),
    (0x2F9B3, 'M', u'虐'),
    (0x2F9B4, 'M', u'虜'),
    (0x2F9B5, 'M', u'虧'),
    (0x2F9B6, 'M', u'虩'),
    (0x2F9B7, 'M', u'蚩'),
    (0x2F9B8, 'M', u'蚈'),
    (0x2F9B9, 'M', u'蜎'),
    (0x2F9BA, 'M', u'蛢'),
    ]

def _seg_77():
    return [
    (0x2F9BB, 'M', u'蝹'),
    (0x2F9BC, 'M', u'蜨'),
    (0x2F9BD, 'M', u'蝫'),
    (0x2F9BE, 'M', u'螆'),
    (0x2F9BF, 'X'),
    (0x2F9C0, 'M', u'蟡'),
    (0x2F9C1, 'M', u'蠁'),
    (0x2F9C2, 'M', u'䗹'),
    (0x2F9C3, 'M', u'衠'),
    (0x2F9C4, 'M', u'衣'),
    (0x2F9C5, 'M', u'𧙧'),
    (0x2F9C6, 'M', u'裗'),
    (0x2F9C7, 'M', u'裞'),
    (0x2F9C8, 'M', u'䘵'),
    (0x2F9C9, 'M', u'裺'),
    (0x2F9CA, 'M', u'㒻'),
    (0x2F9CB, 'M', u'𧢮'),
    (0x2F9CC, 'M', u'𧥦'),
    (0x2F9CD, 'M', u'䚾'),
    (0x2F9CE, 'M', u'䛇'),
    (0x2F9CF, 'M', u'誠'),
    (0x2F9D0, 'M', u'諭'),
    (0x2F9D1, 'M', u'變'),
    (0x2F9D2, 'M', u'豕'),
    (0x2F9D3, 'M', u'𧲨'),
    (0x2F9D4, 'M', u'貫'),
    (0x2F9D5, 'M', u'賁'),
    (0x2F9D6, 'M', u'贛'),
    (0x2F9D7, 'M', u'起'),
    (0x2F9D8, 'M', u'𧼯'),
    (0x2F9D9, 'M', u'𠠄'),
    (0x2F9DA, 'M', u'跋'),
    (0x2F9DB, 'M', u'趼'),
    (0x2F9DC, 'M', u'跰'),
    (0x2F9DD, 'M', u'𠣞'),
    (0x2F9DE, 'M', u'軔'),
    (0x2F9DF, 'M', u'輸'),
    (0x2F9E0, 'M', u'𨗒'),
    (0x2F9E1, 'M', u'𨗭'),
    (0x2F9E2, 'M', u'邔'),
    (0x2F9E3, 'M', u'郱'),
    (0x2F9E4, 'M', u'鄑'),
    (0x2F9E5, 'M', u'𨜮'),
    (0x2F9E6, 'M', u'鄛'),
    (0x2F9E7, 'M', u'鈸'),
    (0x2F9E8, 'M', u'鋗'),
    (0x2F9E9, 'M', u'鋘'),
    (0x2F9EA, 'M', u'鉼'),
    (0x2F9EB, 'M', u'鏹'),
    (0x2F9EC, 'M', u'鐕'),
    (0x2F9ED, 'M', u'𨯺'),
    (0x2F9EE, 'M', u'開'),
    (0x2F9EF, 'M', u'䦕'),
    (0x2F9F0, 'M', u'閷'),
    (0x2F9F1, 'M', u'𨵷'),
    (0x2F9F2, 'M', u'䧦'),
    (0x2F9F3, 'M', u'雃'),
    (0x2F9F4, 'M', u'嶲'),
    (0x2F9F5, 'M', u'霣'),
    (0x2F9F6, 'M', u'𩅅'),
    (0x2F9F7, 'M', u'𩈚'),
    (0x2F9F8, 'M', u'䩮'),
    (0x2F9F9, 'M', u'䩶'),
    (0x2F9FA, 'M', u'韠'),
    (0x2F9FB, 'M', u'𩐊'),
    (0x2F9FC, 'M', u'䪲'),
    (0x2F9FD, 'M', u'𩒖'),
    (0x2F9FE, 'M', u'頋'),
    (0x2FA00, 'M', u'頩'),
    (0x2FA01, 'M', u'𩖶'),
    (0x2FA02, 'M', u'飢'),
    (0x2FA03, 'M', u'䬳'),
    (0x2FA04, 'M', u'餩'),
    (0x2FA05, 'M', u'馧'),
    (0x2FA06, 'M', u'駂'),
    (0x2FA07, 'M', u'駾'),
    (0x2FA08, 'M', u'䯎'),
    (0x2FA09, 'M', u'𩬰'),
    (0x2FA0A, 'M', u'鬒'),
    (0x2FA0B, 'M', u'鱀'),
    (0x2FA0C, 'M', u'鳽'),
    (0x2FA0D, 'M', u'䳎'),
    (0x2FA0E, 'M', u'䳭'),
    (0x2FA0F, 'M', u'鵧'),
    (0x2FA10, 'M', u'𪃎'),
    (0x2FA11, 'M', u'䳸'),
    (0x2FA12, 'M', u'𪄅'),
    (0x2FA13, 'M', u'𪈎'),
    (0x2FA14, 'M', u'𪊑'),
    (0x2FA15, 'M', u'麻'),
    (0x2FA16, 'M', u'䵖'),
    (0x2FA17, 'M', u'黹'),
    (0x2FA18, 'M', u'黾'),
    (0x2FA19, 'M', u'鼅'),
    (0x2FA1A, 'M', u'鼏'),
    (0x2FA1B, 'M', u'鼖'),
    (0x2FA1C, 'M', u'鼻'),
    (0x2FA1D, 'M', u'𪘀'),
    (0x2FA1E, 'X'),
    (0xE0100, 'I'),
    ]

def _seg_78():
    return [
    (0xE01F0, 'X'),
    ]

uts46data = tuple(
    _seg_0()
    + _seg_1()
    + _seg_2()
    + _seg_3()
    + _seg_4()
    + _seg_5()
    + _seg_6()
    + _seg_7()
    + _seg_8()
    + _seg_9()
    + _seg_10()
    + _seg_11()
    + _seg_12()
    + _seg_13()
    + _seg_14()
    + _seg_15()
    + _seg_16()
    + _seg_17()
    + _seg_18()
    + _seg_19()
    + _seg_20()
    + _seg_21()
    + _seg_22()
    + _seg_23()
    + _seg_24()
    + _seg_25()
    + _seg_26()
    + _seg_27()
    + _seg_28()
    + _seg_29()
    + _seg_30()
    + _seg_31()
    + _seg_32()
    + _seg_33()
    + _seg_34()
    + _seg_35()
    + _seg_36()
    + _seg_37()
    + _seg_38()
    + _seg_39()
    + _seg_40()
    + _seg_41()
    + _seg_42()
    + _seg_43()
    + _seg_44()
    + _seg_45()
    + _seg_46()
    + _seg_47()
    + _seg_48()
    + _seg_49()
    + _seg_50()
    + _seg_51()
    + _seg_52()
    + _seg_53()
    + _seg_54()
    + _seg_55()
    + _seg_56()
    + _seg_57()
    + _seg_58()
    + _seg_59()
    + _seg_60()
    + _seg_61()
    + _seg_62()
    + _seg_63()
    + _seg_64()
    + _seg_65()
    + _seg_66()
    + _seg_67()
    + _seg_68()
    + _seg_69()
    + _seg_70()
    + _seg_71()
    + _seg_72()
    + _seg_73()
    + _seg_74()
    + _seg_75()
    + _seg_76()
    + _seg_77()
    + _seg_78()
)
site-packages/pip/_vendor/idna/idnadata.py000064400000117703151446177000014560 0ustar00# This file is automatically generated by tools/idna-data

__version__ = "11.0.0"
scripts = {
    'Greek': (
        0x37000000374,
        0x37500000378,
        0x37a0000037e,
        0x37f00000380,
        0x38400000385,
        0x38600000387,
        0x3880000038b,
        0x38c0000038d,
        0x38e000003a2,
        0x3a3000003e2,
        0x3f000000400,
        0x1d2600001d2b,
        0x1d5d00001d62,
        0x1d6600001d6b,
        0x1dbf00001dc0,
        0x1f0000001f16,
        0x1f1800001f1e,
        0x1f2000001f46,
        0x1f4800001f4e,
        0x1f5000001f58,
        0x1f5900001f5a,
        0x1f5b00001f5c,
        0x1f5d00001f5e,
        0x1f5f00001f7e,
        0x1f8000001fb5,
        0x1fb600001fc5,
        0x1fc600001fd4,
        0x1fd600001fdc,
        0x1fdd00001ff0,
        0x1ff200001ff5,
        0x1ff600001fff,
        0x212600002127,
        0xab650000ab66,
        0x101400001018f,
        0x101a0000101a1,
        0x1d2000001d246,
    ),
    'Han': (
        0x2e8000002e9a,
        0x2e9b00002ef4,
        0x2f0000002fd6,
        0x300500003006,
        0x300700003008,
        0x30210000302a,
        0x30380000303c,
        0x340000004db6,
        0x4e0000009ff0,
        0xf9000000fa6e,
        0xfa700000fada,
        0x200000002a6d7,
        0x2a7000002b735,
        0x2b7400002b81e,
        0x2b8200002cea2,
        0x2ceb00002ebe1,
        0x2f8000002fa1e,
    ),
    'Hebrew': (
        0x591000005c8,
        0x5d0000005eb,
        0x5ef000005f5,
        0xfb1d0000fb37,
        0xfb380000fb3d,
        0xfb3e0000fb3f,
        0xfb400000fb42,
        0xfb430000fb45,
        0xfb460000fb50,
    ),
    'Hiragana': (
        0x304100003097,
        0x309d000030a0,
        0x1b0010001b11f,
        0x1f2000001f201,
    ),
    'Katakana': (
        0x30a1000030fb,
        0x30fd00003100,
        0x31f000003200,
        0x32d0000032ff,
        0x330000003358,
        0xff660000ff70,
        0xff710000ff9e,
        0x1b0000001b001,
    ),
}
joining_types = {
    0x600: 85,
    0x601: 85,
    0x602: 85,
    0x603: 85,
    0x604: 85,
    0x605: 85,
    0x608: 85,
    0x60b: 85,
    0x620: 68,
    0x621: 85,
    0x622: 82,
    0x623: 82,
    0x624: 82,
    0x625: 82,
    0x626: 68,
    0x627: 82,
    0x628: 68,
    0x629: 82,
    0x62a: 68,
    0x62b: 68,
    0x62c: 68,
    0x62d: 68,
    0x62e: 68,
    0x62f: 82,
    0x630: 82,
    0x631: 82,
    0x632: 82,
    0x633: 68,
    0x634: 68,
    0x635: 68,
    0x636: 68,
    0x637: 68,
    0x638: 68,
    0x639: 68,
    0x63a: 68,
    0x63b: 68,
    0x63c: 68,
    0x63d: 68,
    0x63e: 68,
    0x63f: 68,
    0x640: 67,
    0x641: 68,
    0x642: 68,
    0x643: 68,
    0x644: 68,
    0x645: 68,
    0x646: 68,
    0x647: 68,
    0x648: 82,
    0x649: 68,
    0x64a: 68,
    0x66e: 68,
    0x66f: 68,
    0x671: 82,
    0x672: 82,
    0x673: 82,
    0x674: 85,
    0x675: 82,
    0x676: 82,
    0x677: 82,
    0x678: 68,
    0x679: 68,
    0x67a: 68,
    0x67b: 68,
    0x67c: 68,
    0x67d: 68,
    0x67e: 68,
    0x67f: 68,
    0x680: 68,
    0x681: 68,
    0x682: 68,
    0x683: 68,
    0x684: 68,
    0x685: 68,
    0x686: 68,
    0x687: 68,
    0x688: 82,
    0x689: 82,
    0x68a: 82,
    0x68b: 82,
    0x68c: 82,
    0x68d: 82,
    0x68e: 82,
    0x68f: 82,
    0x690: 82,
    0x691: 82,
    0x692: 82,
    0x693: 82,
    0x694: 82,
    0x695: 82,
    0x696: 82,
    0x697: 82,
    0x698: 82,
    0x699: 82,
    0x69a: 68,
    0x69b: 68,
    0x69c: 68,
    0x69d: 68,
    0x69e: 68,
    0x69f: 68,
    0x6a0: 68,
    0x6a1: 68,
    0x6a2: 68,
    0x6a3: 68,
    0x6a4: 68,
    0x6a5: 68,
    0x6a6: 68,
    0x6a7: 68,
    0x6a8: 68,
    0x6a9: 68,
    0x6aa: 68,
    0x6ab: 68,
    0x6ac: 68,
    0x6ad: 68,
    0x6ae: 68,
    0x6af: 68,
    0x6b0: 68,
    0x6b1: 68,
    0x6b2: 68,
    0x6b3: 68,
    0x6b4: 68,
    0x6b5: 68,
    0x6b6: 68,
    0x6b7: 68,
    0x6b8: 68,
    0x6b9: 68,
    0x6ba: 68,
    0x6bb: 68,
    0x6bc: 68,
    0x6bd: 68,
    0x6be: 68,
    0x6bf: 68,
    0x6c0: 82,
    0x6c1: 68,
    0x6c2: 68,
    0x6c3: 82,
    0x6c4: 82,
    0x6c5: 82,
    0x6c6: 82,
    0x6c7: 82,
    0x6c8: 82,
    0x6c9: 82,
    0x6ca: 82,
    0x6cb: 82,
    0x6cc: 68,
    0x6cd: 82,
    0x6ce: 68,
    0x6cf: 82,
    0x6d0: 68,
    0x6d1: 68,
    0x6d2: 82,
    0x6d3: 82,
    0x6d5: 82,
    0x6dd: 85,
    0x6ee: 82,
    0x6ef: 82,
    0x6fa: 68,
    0x6fb: 68,
    0x6fc: 68,
    0x6ff: 68,
    0x70f: 84,
    0x710: 82,
    0x712: 68,
    0x713: 68,
    0x714: 68,
    0x715: 82,
    0x716: 82,
    0x717: 82,
    0x718: 82,
    0x719: 82,
    0x71a: 68,
    0x71b: 68,
    0x71c: 68,
    0x71d: 68,
    0x71e: 82,
    0x71f: 68,
    0x720: 68,
    0x721: 68,
    0x722: 68,
    0x723: 68,
    0x724: 68,
    0x725: 68,
    0x726: 68,
    0x727: 68,
    0x728: 82,
    0x729: 68,
    0x72a: 82,
    0x72b: 68,
    0x72c: 82,
    0x72d: 68,
    0x72e: 68,
    0x72f: 82,
    0x74d: 82,
    0x74e: 68,
    0x74f: 68,
    0x750: 68,
    0x751: 68,
    0x752: 68,
    0x753: 68,
    0x754: 68,
    0x755: 68,
    0x756: 68,
    0x757: 68,
    0x758: 68,
    0x759: 82,
    0x75a: 82,
    0x75b: 82,
    0x75c: 68,
    0x75d: 68,
    0x75e: 68,
    0x75f: 68,
    0x760: 68,
    0x761: 68,
    0x762: 68,
    0x763: 68,
    0x764: 68,
    0x765: 68,
    0x766: 68,
    0x767: 68,
    0x768: 68,
    0x769: 68,
    0x76a: 68,
    0x76b: 82,
    0x76c: 82,
    0x76d: 68,
    0x76e: 68,
    0x76f: 68,
    0x770: 68,
    0x771: 82,
    0x772: 68,
    0x773: 82,
    0x774: 82,
    0x775: 68,
    0x776: 68,
    0x777: 68,
    0x778: 82,
    0x779: 82,
    0x77a: 68,
    0x77b: 68,
    0x77c: 68,
    0x77d: 68,
    0x77e: 68,
    0x77f: 68,
    0x7ca: 68,
    0x7cb: 68,
    0x7cc: 68,
    0x7cd: 68,
    0x7ce: 68,
    0x7cf: 68,
    0x7d0: 68,
    0x7d1: 68,
    0x7d2: 68,
    0x7d3: 68,
    0x7d4: 68,
    0x7d5: 68,
    0x7d6: 68,
    0x7d7: 68,
    0x7d8: 68,
    0x7d9: 68,
    0x7da: 68,
    0x7db: 68,
    0x7dc: 68,
    0x7dd: 68,
    0x7de: 68,
    0x7df: 68,
    0x7e0: 68,
    0x7e1: 68,
    0x7e2: 68,
    0x7e3: 68,
    0x7e4: 68,
    0x7e5: 68,
    0x7e6: 68,
    0x7e7: 68,
    0x7e8: 68,
    0x7e9: 68,
    0x7ea: 68,
    0x7fa: 67,
    0x840: 82,
    0x841: 68,
    0x842: 68,
    0x843: 68,
    0x844: 68,
    0x845: 68,
    0x846: 82,
    0x847: 82,
    0x848: 68,
    0x849: 82,
    0x84a: 68,
    0x84b: 68,
    0x84c: 68,
    0x84d: 68,
    0x84e: 68,
    0x84f: 68,
    0x850: 68,
    0x851: 68,
    0x852: 68,
    0x853: 68,
    0x854: 82,
    0x855: 68,
    0x856: 85,
    0x857: 85,
    0x858: 85,
    0x860: 68,
    0x861: 85,
    0x862: 68,
    0x863: 68,
    0x864: 68,
    0x865: 68,
    0x866: 85,
    0x867: 82,
    0x868: 68,
    0x869: 82,
    0x86a: 82,
    0x8a0: 68,
    0x8a1: 68,
    0x8a2: 68,
    0x8a3: 68,
    0x8a4: 68,
    0x8a5: 68,
    0x8a6: 68,
    0x8a7: 68,
    0x8a8: 68,
    0x8a9: 68,
    0x8aa: 82,
    0x8ab: 82,
    0x8ac: 82,
    0x8ad: 85,
    0x8ae: 82,
    0x8af: 68,
    0x8b0: 68,
    0x8b1: 82,
    0x8b2: 82,
    0x8b3: 68,
    0x8b4: 68,
    0x8b6: 68,
    0x8b7: 68,
    0x8b8: 68,
    0x8b9: 82,
    0x8ba: 68,
    0x8bb: 68,
    0x8bc: 68,
    0x8bd: 68,
    0x8e2: 85,
    0x1806: 85,
    0x1807: 68,
    0x180a: 67,
    0x180e: 85,
    0x1820: 68,
    0x1821: 68,
    0x1822: 68,
    0x1823: 68,
    0x1824: 68,
    0x1825: 68,
    0x1826: 68,
    0x1827: 68,
    0x1828: 68,
    0x1829: 68,
    0x182a: 68,
    0x182b: 68,
    0x182c: 68,
    0x182d: 68,
    0x182e: 68,
    0x182f: 68,
    0x1830: 68,
    0x1831: 68,
    0x1832: 68,
    0x1833: 68,
    0x1834: 68,
    0x1835: 68,
    0x1836: 68,
    0x1837: 68,
    0x1838: 68,
    0x1839: 68,
    0x183a: 68,
    0x183b: 68,
    0x183c: 68,
    0x183d: 68,
    0x183e: 68,
    0x183f: 68,
    0x1840: 68,
    0x1841: 68,
    0x1842: 68,
    0x1843: 68,
    0x1844: 68,
    0x1845: 68,
    0x1846: 68,
    0x1847: 68,
    0x1848: 68,
    0x1849: 68,
    0x184a: 68,
    0x184b: 68,
    0x184c: 68,
    0x184d: 68,
    0x184e: 68,
    0x184f: 68,
    0x1850: 68,
    0x1851: 68,
    0x1852: 68,
    0x1853: 68,
    0x1854: 68,
    0x1855: 68,
    0x1856: 68,
    0x1857: 68,
    0x1858: 68,
    0x1859: 68,
    0x185a: 68,
    0x185b: 68,
    0x185c: 68,
    0x185d: 68,
    0x185e: 68,
    0x185f: 68,
    0x1860: 68,
    0x1861: 68,
    0x1862: 68,
    0x1863: 68,
    0x1864: 68,
    0x1865: 68,
    0x1866: 68,
    0x1867: 68,
    0x1868: 68,
    0x1869: 68,
    0x186a: 68,
    0x186b: 68,
    0x186c: 68,
    0x186d: 68,
    0x186e: 68,
    0x186f: 68,
    0x1870: 68,
    0x1871: 68,
    0x1872: 68,
    0x1873: 68,
    0x1874: 68,
    0x1875: 68,
    0x1876: 68,
    0x1877: 68,
    0x1878: 68,
    0x1880: 85,
    0x1881: 85,
    0x1882: 85,
    0x1883: 85,
    0x1884: 85,
    0x1885: 84,
    0x1886: 84,
    0x1887: 68,
    0x1888: 68,
    0x1889: 68,
    0x188a: 68,
    0x188b: 68,
    0x188c: 68,
    0x188d: 68,
    0x188e: 68,
    0x188f: 68,
    0x1890: 68,
    0x1891: 68,
    0x1892: 68,
    0x1893: 68,
    0x1894: 68,
    0x1895: 68,
    0x1896: 68,
    0x1897: 68,
    0x1898: 68,
    0x1899: 68,
    0x189a: 68,
    0x189b: 68,
    0x189c: 68,
    0x189d: 68,
    0x189e: 68,
    0x189f: 68,
    0x18a0: 68,
    0x18a1: 68,
    0x18a2: 68,
    0x18a3: 68,
    0x18a4: 68,
    0x18a5: 68,
    0x18a6: 68,
    0x18a7: 68,
    0x18a8: 68,
    0x18aa: 68,
    0x200c: 85,
    0x200d: 67,
    0x202f: 85,
    0x2066: 85,
    0x2067: 85,
    0x2068: 85,
    0x2069: 85,
    0xa840: 68,
    0xa841: 68,
    0xa842: 68,
    0xa843: 68,
    0xa844: 68,
    0xa845: 68,
    0xa846: 68,
    0xa847: 68,
    0xa848: 68,
    0xa849: 68,
    0xa84a: 68,
    0xa84b: 68,
    0xa84c: 68,
    0xa84d: 68,
    0xa84e: 68,
    0xa84f: 68,
    0xa850: 68,
    0xa851: 68,
    0xa852: 68,
    0xa853: 68,
    0xa854: 68,
    0xa855: 68,
    0xa856: 68,
    0xa857: 68,
    0xa858: 68,
    0xa859: 68,
    0xa85a: 68,
    0xa85b: 68,
    0xa85c: 68,
    0xa85d: 68,
    0xa85e: 68,
    0xa85f: 68,
    0xa860: 68,
    0xa861: 68,
    0xa862: 68,
    0xa863: 68,
    0xa864: 68,
    0xa865: 68,
    0xa866: 68,
    0xa867: 68,
    0xa868: 68,
    0xa869: 68,
    0xa86a: 68,
    0xa86b: 68,
    0xa86c: 68,
    0xa86d: 68,
    0xa86e: 68,
    0xa86f: 68,
    0xa870: 68,
    0xa871: 68,
    0xa872: 76,
    0xa873: 85,
    0x10ac0: 68,
    0x10ac1: 68,
    0x10ac2: 68,
    0x10ac3: 68,
    0x10ac4: 68,
    0x10ac5: 82,
    0x10ac6: 85,
    0x10ac7: 82,
    0x10ac8: 85,
    0x10ac9: 82,
    0x10aca: 82,
    0x10acb: 85,
    0x10acc: 85,
    0x10acd: 76,
    0x10ace: 82,
    0x10acf: 82,
    0x10ad0: 82,
    0x10ad1: 82,
    0x10ad2: 82,
    0x10ad3: 68,
    0x10ad4: 68,
    0x10ad5: 68,
    0x10ad6: 68,
    0x10ad7: 76,
    0x10ad8: 68,
    0x10ad9: 68,
    0x10ada: 68,
    0x10adb: 68,
    0x10adc: 68,
    0x10add: 82,
    0x10ade: 68,
    0x10adf: 68,
    0x10ae0: 68,
    0x10ae1: 82,
    0x10ae2: 85,
    0x10ae3: 85,
    0x10ae4: 82,
    0x10aeb: 68,
    0x10aec: 68,
    0x10aed: 68,
    0x10aee: 68,
    0x10aef: 82,
    0x10b80: 68,
    0x10b81: 82,
    0x10b82: 68,
    0x10b83: 82,
    0x10b84: 82,
    0x10b85: 82,
    0x10b86: 68,
    0x10b87: 68,
    0x10b88: 68,
    0x10b89: 82,
    0x10b8a: 68,
    0x10b8b: 68,
    0x10b8c: 82,
    0x10b8d: 68,
    0x10b8e: 82,
    0x10b8f: 82,
    0x10b90: 68,
    0x10b91: 82,
    0x10ba9: 82,
    0x10baa: 82,
    0x10bab: 82,
    0x10bac: 82,
    0x10bad: 68,
    0x10bae: 68,
    0x10baf: 85,
    0x10d00: 76,
    0x10d01: 68,
    0x10d02: 68,
    0x10d03: 68,
    0x10d04: 68,
    0x10d05: 68,
    0x10d06: 68,
    0x10d07: 68,
    0x10d08: 68,
    0x10d09: 68,
    0x10d0a: 68,
    0x10d0b: 68,
    0x10d0c: 68,
    0x10d0d: 68,
    0x10d0e: 68,
    0x10d0f: 68,
    0x10d10: 68,
    0x10d11: 68,
    0x10d12: 68,
    0x10d13: 68,
    0x10d14: 68,
    0x10d15: 68,
    0x10d16: 68,
    0x10d17: 68,
    0x10d18: 68,
    0x10d19: 68,
    0x10d1a: 68,
    0x10d1b: 68,
    0x10d1c: 68,
    0x10d1d: 68,
    0x10d1e: 68,
    0x10d1f: 68,
    0x10d20: 68,
    0x10d21: 68,
    0x10d22: 82,
    0x10d23: 68,
    0x10f30: 68,
    0x10f31: 68,
    0x10f32: 68,
    0x10f33: 82,
    0x10f34: 68,
    0x10f35: 68,
    0x10f36: 68,
    0x10f37: 68,
    0x10f38: 68,
    0x10f39: 68,
    0x10f3a: 68,
    0x10f3b: 68,
    0x10f3c: 68,
    0x10f3d: 68,
    0x10f3e: 68,
    0x10f3f: 68,
    0x10f40: 68,
    0x10f41: 68,
    0x10f42: 68,
    0x10f43: 68,
    0x10f44: 68,
    0x10f45: 85,
    0x10f51: 68,
    0x10f52: 68,
    0x10f53: 68,
    0x10f54: 82,
    0x110bd: 85,
    0x110cd: 85,
    0x1e900: 68,
    0x1e901: 68,
    0x1e902: 68,
    0x1e903: 68,
    0x1e904: 68,
    0x1e905: 68,
    0x1e906: 68,
    0x1e907: 68,
    0x1e908: 68,
    0x1e909: 68,
    0x1e90a: 68,
    0x1e90b: 68,
    0x1e90c: 68,
    0x1e90d: 68,
    0x1e90e: 68,
    0x1e90f: 68,
    0x1e910: 68,
    0x1e911: 68,
    0x1e912: 68,
    0x1e913: 68,
    0x1e914: 68,
    0x1e915: 68,
    0x1e916: 68,
    0x1e917: 68,
    0x1e918: 68,
    0x1e919: 68,
    0x1e91a: 68,
    0x1e91b: 68,
    0x1e91c: 68,
    0x1e91d: 68,
    0x1e91e: 68,
    0x1e91f: 68,
    0x1e920: 68,
    0x1e921: 68,
    0x1e922: 68,
    0x1e923: 68,
    0x1e924: 68,
    0x1e925: 68,
    0x1e926: 68,
    0x1e927: 68,
    0x1e928: 68,
    0x1e929: 68,
    0x1e92a: 68,
    0x1e92b: 68,
    0x1e92c: 68,
    0x1e92d: 68,
    0x1e92e: 68,
    0x1e92f: 68,
    0x1e930: 68,
    0x1e931: 68,
    0x1e932: 68,
    0x1e933: 68,
    0x1e934: 68,
    0x1e935: 68,
    0x1e936: 68,
    0x1e937: 68,
    0x1e938: 68,
    0x1e939: 68,
    0x1e93a: 68,
    0x1e93b: 68,
    0x1e93c: 68,
    0x1e93d: 68,
    0x1e93e: 68,
    0x1e93f: 68,
    0x1e940: 68,
    0x1e941: 68,
    0x1e942: 68,
    0x1e943: 68,
}
codepoint_classes = {
    'PVALID': (
        0x2d0000002e,
        0x300000003a,
        0x610000007b,
        0xdf000000f7,
        0xf800000100,
        0x10100000102,
        0x10300000104,
        0x10500000106,
        0x10700000108,
        0x1090000010a,
        0x10b0000010c,
        0x10d0000010e,
        0x10f00000110,
        0x11100000112,
        0x11300000114,
        0x11500000116,
        0x11700000118,
        0x1190000011a,
        0x11b0000011c,
        0x11d0000011e,
        0x11f00000120,
        0x12100000122,
        0x12300000124,
        0x12500000126,
        0x12700000128,
        0x1290000012a,
        0x12b0000012c,
        0x12d0000012e,
        0x12f00000130,
        0x13100000132,
        0x13500000136,
        0x13700000139,
        0x13a0000013b,
        0x13c0000013d,
        0x13e0000013f,
        0x14200000143,
        0x14400000145,
        0x14600000147,
        0x14800000149,
        0x14b0000014c,
        0x14d0000014e,
        0x14f00000150,
        0x15100000152,
        0x15300000154,
        0x15500000156,
        0x15700000158,
        0x1590000015a,
        0x15b0000015c,
        0x15d0000015e,
        0x15f00000160,
        0x16100000162,
        0x16300000164,
        0x16500000166,
        0x16700000168,
        0x1690000016a,
        0x16b0000016c,
        0x16d0000016e,
        0x16f00000170,
        0x17100000172,
        0x17300000174,
        0x17500000176,
        0x17700000178,
        0x17a0000017b,
        0x17c0000017d,
        0x17e0000017f,
        0x18000000181,
        0x18300000184,
        0x18500000186,
        0x18800000189,
        0x18c0000018e,
        0x19200000193,
        0x19500000196,
        0x1990000019c,
        0x19e0000019f,
        0x1a1000001a2,
        0x1a3000001a4,
        0x1a5000001a6,
        0x1a8000001a9,
        0x1aa000001ac,
        0x1ad000001ae,
        0x1b0000001b1,
        0x1b4000001b5,
        0x1b6000001b7,
        0x1b9000001bc,
        0x1bd000001c4,
        0x1ce000001cf,
        0x1d0000001d1,
        0x1d2000001d3,
        0x1d4000001d5,
        0x1d6000001d7,
        0x1d8000001d9,
        0x1da000001db,
        0x1dc000001de,
        0x1df000001e0,
        0x1e1000001e2,
        0x1e3000001e4,
        0x1e5000001e6,
        0x1e7000001e8,
        0x1e9000001ea,
        0x1eb000001ec,
        0x1ed000001ee,
        0x1ef000001f1,
        0x1f5000001f6,
        0x1f9000001fa,
        0x1fb000001fc,
        0x1fd000001fe,
        0x1ff00000200,
        0x20100000202,
        0x20300000204,
        0x20500000206,
        0x20700000208,
        0x2090000020a,
        0x20b0000020c,
        0x20d0000020e,
        0x20f00000210,
        0x21100000212,
        0x21300000214,
        0x21500000216,
        0x21700000218,
        0x2190000021a,
        0x21b0000021c,
        0x21d0000021e,
        0x21f00000220,
        0x22100000222,
        0x22300000224,
        0x22500000226,
        0x22700000228,
        0x2290000022a,
        0x22b0000022c,
        0x22d0000022e,
        0x22f00000230,
        0x23100000232,
        0x2330000023a,
        0x23c0000023d,
        0x23f00000241,
        0x24200000243,
        0x24700000248,
        0x2490000024a,
        0x24b0000024c,
        0x24d0000024e,
        0x24f000002b0,
        0x2b9000002c2,
        0x2c6000002d2,
        0x2ec000002ed,
        0x2ee000002ef,
        0x30000000340,
        0x34200000343,
        0x3460000034f,
        0x35000000370,
        0x37100000372,
        0x37300000374,
        0x37700000378,
        0x37b0000037e,
        0x39000000391,
        0x3ac000003cf,
        0x3d7000003d8,
        0x3d9000003da,
        0x3db000003dc,
        0x3dd000003de,
        0x3df000003e0,
        0x3e1000003e2,
        0x3e3000003e4,
        0x3e5000003e6,
        0x3e7000003e8,
        0x3e9000003ea,
        0x3eb000003ec,
        0x3ed000003ee,
        0x3ef000003f0,
        0x3f3000003f4,
        0x3f8000003f9,
        0x3fb000003fd,
        0x43000000460,
        0x46100000462,
        0x46300000464,
        0x46500000466,
        0x46700000468,
        0x4690000046a,
        0x46b0000046c,
        0x46d0000046e,
        0x46f00000470,
        0x47100000472,
        0x47300000474,
        0x47500000476,
        0x47700000478,
        0x4790000047a,
        0x47b0000047c,
        0x47d0000047e,
        0x47f00000480,
        0x48100000482,
        0x48300000488,
        0x48b0000048c,
        0x48d0000048e,
        0x48f00000490,
        0x49100000492,
        0x49300000494,
        0x49500000496,
        0x49700000498,
        0x4990000049a,
        0x49b0000049c,
        0x49d0000049e,
        0x49f000004a0,
        0x4a1000004a2,
        0x4a3000004a4,
        0x4a5000004a6,
        0x4a7000004a8,
        0x4a9000004aa,
        0x4ab000004ac,
        0x4ad000004ae,
        0x4af000004b0,
        0x4b1000004b2,
        0x4b3000004b4,
        0x4b5000004b6,
        0x4b7000004b8,
        0x4b9000004ba,
        0x4bb000004bc,
        0x4bd000004be,
        0x4bf000004c0,
        0x4c2000004c3,
        0x4c4000004c5,
        0x4c6000004c7,
        0x4c8000004c9,
        0x4ca000004cb,
        0x4cc000004cd,
        0x4ce000004d0,
        0x4d1000004d2,
        0x4d3000004d4,
        0x4d5000004d6,
        0x4d7000004d8,
        0x4d9000004da,
        0x4db000004dc,
        0x4dd000004de,
        0x4df000004e0,
        0x4e1000004e2,
        0x4e3000004e4,
        0x4e5000004e6,
        0x4e7000004e8,
        0x4e9000004ea,
        0x4eb000004ec,
        0x4ed000004ee,
        0x4ef000004f0,
        0x4f1000004f2,
        0x4f3000004f4,
        0x4f5000004f6,
        0x4f7000004f8,
        0x4f9000004fa,
        0x4fb000004fc,
        0x4fd000004fe,
        0x4ff00000500,
        0x50100000502,
        0x50300000504,
        0x50500000506,
        0x50700000508,
        0x5090000050a,
        0x50b0000050c,
        0x50d0000050e,
        0x50f00000510,
        0x51100000512,
        0x51300000514,
        0x51500000516,
        0x51700000518,
        0x5190000051a,
        0x51b0000051c,
        0x51d0000051e,
        0x51f00000520,
        0x52100000522,
        0x52300000524,
        0x52500000526,
        0x52700000528,
        0x5290000052a,
        0x52b0000052c,
        0x52d0000052e,
        0x52f00000530,
        0x5590000055a,
        0x56000000587,
        0x58800000589,
        0x591000005be,
        0x5bf000005c0,
        0x5c1000005c3,
        0x5c4000005c6,
        0x5c7000005c8,
        0x5d0000005eb,
        0x5ef000005f3,
        0x6100000061b,
        0x62000000640,
        0x64100000660,
        0x66e00000675,
        0x679000006d4,
        0x6d5000006dd,
        0x6df000006e9,
        0x6ea000006f0,
        0x6fa00000700,
        0x7100000074b,
        0x74d000007b2,
        0x7c0000007f6,
        0x7fd000007fe,
        0x8000000082e,
        0x8400000085c,
        0x8600000086b,
        0x8a0000008b5,
        0x8b6000008be,
        0x8d3000008e2,
        0x8e300000958,
        0x96000000964,
        0x96600000970,
        0x97100000984,
        0x9850000098d,
        0x98f00000991,
        0x993000009a9,
        0x9aa000009b1,
        0x9b2000009b3,
        0x9b6000009ba,
        0x9bc000009c5,
        0x9c7000009c9,
        0x9cb000009cf,
        0x9d7000009d8,
        0x9e0000009e4,
        0x9e6000009f2,
        0x9fc000009fd,
        0x9fe000009ff,
        0xa0100000a04,
        0xa0500000a0b,
        0xa0f00000a11,
        0xa1300000a29,
        0xa2a00000a31,
        0xa3200000a33,
        0xa3500000a36,
        0xa3800000a3a,
        0xa3c00000a3d,
        0xa3e00000a43,
        0xa4700000a49,
        0xa4b00000a4e,
        0xa5100000a52,
        0xa5c00000a5d,
        0xa6600000a76,
        0xa8100000a84,
        0xa8500000a8e,
        0xa8f00000a92,
        0xa9300000aa9,
        0xaaa00000ab1,
        0xab200000ab4,
        0xab500000aba,
        0xabc00000ac6,
        0xac700000aca,
        0xacb00000ace,
        0xad000000ad1,
        0xae000000ae4,
        0xae600000af0,
        0xaf900000b00,
        0xb0100000b04,
        0xb0500000b0d,
        0xb0f00000b11,
        0xb1300000b29,
        0xb2a00000b31,
        0xb3200000b34,
        0xb3500000b3a,
        0xb3c00000b45,
        0xb4700000b49,
        0xb4b00000b4e,
        0xb5600000b58,
        0xb5f00000b64,
        0xb6600000b70,
        0xb7100000b72,
        0xb8200000b84,
        0xb8500000b8b,
        0xb8e00000b91,
        0xb9200000b96,
        0xb9900000b9b,
        0xb9c00000b9d,
        0xb9e00000ba0,
        0xba300000ba5,
        0xba800000bab,
        0xbae00000bba,
        0xbbe00000bc3,
        0xbc600000bc9,
        0xbca00000bce,
        0xbd000000bd1,
        0xbd700000bd8,
        0xbe600000bf0,
        0xc0000000c0d,
        0xc0e00000c11,
        0xc1200000c29,
        0xc2a00000c3a,
        0xc3d00000c45,
        0xc4600000c49,
        0xc4a00000c4e,
        0xc5500000c57,
        0xc5800000c5b,
        0xc6000000c64,
        0xc6600000c70,
        0xc8000000c84,
        0xc8500000c8d,
        0xc8e00000c91,
        0xc9200000ca9,
        0xcaa00000cb4,
        0xcb500000cba,
        0xcbc00000cc5,
        0xcc600000cc9,
        0xcca00000cce,
        0xcd500000cd7,
        0xcde00000cdf,
        0xce000000ce4,
        0xce600000cf0,
        0xcf100000cf3,
        0xd0000000d04,
        0xd0500000d0d,
        0xd0e00000d11,
        0xd1200000d45,
        0xd4600000d49,
        0xd4a00000d4f,
        0xd5400000d58,
        0xd5f00000d64,
        0xd6600000d70,
        0xd7a00000d80,
        0xd8200000d84,
        0xd8500000d97,
        0xd9a00000db2,
        0xdb300000dbc,
        0xdbd00000dbe,
        0xdc000000dc7,
        0xdca00000dcb,
        0xdcf00000dd5,
        0xdd600000dd7,
        0xdd800000de0,
        0xde600000df0,
        0xdf200000df4,
        0xe0100000e33,
        0xe3400000e3b,
        0xe4000000e4f,
        0xe5000000e5a,
        0xe8100000e83,
        0xe8400000e85,
        0xe8700000e89,
        0xe8a00000e8b,
        0xe8d00000e8e,
        0xe9400000e98,
        0xe9900000ea0,
        0xea100000ea4,
        0xea500000ea6,
        0xea700000ea8,
        0xeaa00000eac,
        0xead00000eb3,
        0xeb400000eba,
        0xebb00000ebe,
        0xec000000ec5,
        0xec600000ec7,
        0xec800000ece,
        0xed000000eda,
        0xede00000ee0,
        0xf0000000f01,
        0xf0b00000f0c,
        0xf1800000f1a,
        0xf2000000f2a,
        0xf3500000f36,
        0xf3700000f38,
        0xf3900000f3a,
        0xf3e00000f43,
        0xf4400000f48,
        0xf4900000f4d,
        0xf4e00000f52,
        0xf5300000f57,
        0xf5800000f5c,
        0xf5d00000f69,
        0xf6a00000f6d,
        0xf7100000f73,
        0xf7400000f75,
        0xf7a00000f81,
        0xf8200000f85,
        0xf8600000f93,
        0xf9400000f98,
        0xf9900000f9d,
        0xf9e00000fa2,
        0xfa300000fa7,
        0xfa800000fac,
        0xfad00000fb9,
        0xfba00000fbd,
        0xfc600000fc7,
        0x10000000104a,
        0x10500000109e,
        0x10d0000010fb,
        0x10fd00001100,
        0x120000001249,
        0x124a0000124e,
        0x125000001257,
        0x125800001259,
        0x125a0000125e,
        0x126000001289,
        0x128a0000128e,
        0x1290000012b1,
        0x12b2000012b6,
        0x12b8000012bf,
        0x12c0000012c1,
        0x12c2000012c6,
        0x12c8000012d7,
        0x12d800001311,
        0x131200001316,
        0x13180000135b,
        0x135d00001360,
        0x138000001390,
        0x13a0000013f6,
        0x14010000166d,
        0x166f00001680,
        0x16810000169b,
        0x16a0000016eb,
        0x16f1000016f9,
        0x17000000170d,
        0x170e00001715,
        0x172000001735,
        0x174000001754,
        0x17600000176d,
        0x176e00001771,
        0x177200001774,
        0x1780000017b4,
        0x17b6000017d4,
        0x17d7000017d8,
        0x17dc000017de,
        0x17e0000017ea,
        0x18100000181a,
        0x182000001879,
        0x1880000018ab,
        0x18b0000018f6,
        0x19000000191f,
        0x19200000192c,
        0x19300000193c,
        0x19460000196e,
        0x197000001975,
        0x1980000019ac,
        0x19b0000019ca,
        0x19d0000019da,
        0x1a0000001a1c,
        0x1a2000001a5f,
        0x1a6000001a7d,
        0x1a7f00001a8a,
        0x1a9000001a9a,
        0x1aa700001aa8,
        0x1ab000001abe,
        0x1b0000001b4c,
        0x1b5000001b5a,
        0x1b6b00001b74,
        0x1b8000001bf4,
        0x1c0000001c38,
        0x1c4000001c4a,
        0x1c4d00001c7e,
        0x1cd000001cd3,
        0x1cd400001cfa,
        0x1d0000001d2c,
        0x1d2f00001d30,
        0x1d3b00001d3c,
        0x1d4e00001d4f,
        0x1d6b00001d78,
        0x1d7900001d9b,
        0x1dc000001dfa,
        0x1dfb00001e00,
        0x1e0100001e02,
        0x1e0300001e04,
        0x1e0500001e06,
        0x1e0700001e08,
        0x1e0900001e0a,
        0x1e0b00001e0c,
        0x1e0d00001e0e,
        0x1e0f00001e10,
        0x1e1100001e12,
        0x1e1300001e14,
        0x1e1500001e16,
        0x1e1700001e18,
        0x1e1900001e1a,
        0x1e1b00001e1c,
        0x1e1d00001e1e,
        0x1e1f00001e20,
        0x1e2100001e22,
        0x1e2300001e24,
        0x1e2500001e26,
        0x1e2700001e28,
        0x1e2900001e2a,
        0x1e2b00001e2c,
        0x1e2d00001e2e,
        0x1e2f00001e30,
        0x1e3100001e32,
        0x1e3300001e34,
        0x1e3500001e36,
        0x1e3700001e38,
        0x1e3900001e3a,
        0x1e3b00001e3c,
        0x1e3d00001e3e,
        0x1e3f00001e40,
        0x1e4100001e42,
        0x1e4300001e44,
        0x1e4500001e46,
        0x1e4700001e48,
        0x1e4900001e4a,
        0x1e4b00001e4c,
        0x1e4d00001e4e,
        0x1e4f00001e50,
        0x1e5100001e52,
        0x1e5300001e54,
        0x1e5500001e56,
        0x1e5700001e58,
        0x1e5900001e5a,
        0x1e5b00001e5c,
        0x1e5d00001e5e,
        0x1e5f00001e60,
        0x1e6100001e62,
        0x1e6300001e64,
        0x1e6500001e66,
        0x1e6700001e68,
        0x1e6900001e6a,
        0x1e6b00001e6c,
        0x1e6d00001e6e,
        0x1e6f00001e70,
        0x1e7100001e72,
        0x1e7300001e74,
        0x1e7500001e76,
        0x1e7700001e78,
        0x1e7900001e7a,
        0x1e7b00001e7c,
        0x1e7d00001e7e,
        0x1e7f00001e80,
        0x1e8100001e82,
        0x1e8300001e84,
        0x1e8500001e86,
        0x1e8700001e88,
        0x1e8900001e8a,
        0x1e8b00001e8c,
        0x1e8d00001e8e,
        0x1e8f00001e90,
        0x1e9100001e92,
        0x1e9300001e94,
        0x1e9500001e9a,
        0x1e9c00001e9e,
        0x1e9f00001ea0,
        0x1ea100001ea2,
        0x1ea300001ea4,
        0x1ea500001ea6,
        0x1ea700001ea8,
        0x1ea900001eaa,
        0x1eab00001eac,
        0x1ead00001eae,
        0x1eaf00001eb0,
        0x1eb100001eb2,
        0x1eb300001eb4,
        0x1eb500001eb6,
        0x1eb700001eb8,
        0x1eb900001eba,
        0x1ebb00001ebc,
        0x1ebd00001ebe,
        0x1ebf00001ec0,
        0x1ec100001ec2,
        0x1ec300001ec4,
        0x1ec500001ec6,
        0x1ec700001ec8,
        0x1ec900001eca,
        0x1ecb00001ecc,
        0x1ecd00001ece,
        0x1ecf00001ed0,
        0x1ed100001ed2,
        0x1ed300001ed4,
        0x1ed500001ed6,
        0x1ed700001ed8,
        0x1ed900001eda,
        0x1edb00001edc,
        0x1edd00001ede,
        0x1edf00001ee0,
        0x1ee100001ee2,
        0x1ee300001ee4,
        0x1ee500001ee6,
        0x1ee700001ee8,
        0x1ee900001eea,
        0x1eeb00001eec,
        0x1eed00001eee,
        0x1eef00001ef0,
        0x1ef100001ef2,
        0x1ef300001ef4,
        0x1ef500001ef6,
        0x1ef700001ef8,
        0x1ef900001efa,
        0x1efb00001efc,
        0x1efd00001efe,
        0x1eff00001f08,
        0x1f1000001f16,
        0x1f2000001f28,
        0x1f3000001f38,
        0x1f4000001f46,
        0x1f5000001f58,
        0x1f6000001f68,
        0x1f7000001f71,
        0x1f7200001f73,
        0x1f7400001f75,
        0x1f7600001f77,
        0x1f7800001f79,
        0x1f7a00001f7b,
        0x1f7c00001f7d,
        0x1fb000001fb2,
        0x1fb600001fb7,
        0x1fc600001fc7,
        0x1fd000001fd3,
        0x1fd600001fd8,
        0x1fe000001fe3,
        0x1fe400001fe8,
        0x1ff600001ff7,
        0x214e0000214f,
        0x218400002185,
        0x2c3000002c5f,
        0x2c6100002c62,
        0x2c6500002c67,
        0x2c6800002c69,
        0x2c6a00002c6b,
        0x2c6c00002c6d,
        0x2c7100002c72,
        0x2c7300002c75,
        0x2c7600002c7c,
        0x2c8100002c82,
        0x2c8300002c84,
        0x2c8500002c86,
        0x2c8700002c88,
        0x2c8900002c8a,
        0x2c8b00002c8c,
        0x2c8d00002c8e,
        0x2c8f00002c90,
        0x2c9100002c92,
        0x2c9300002c94,
        0x2c9500002c96,
        0x2c9700002c98,
        0x2c9900002c9a,
        0x2c9b00002c9c,
        0x2c9d00002c9e,
        0x2c9f00002ca0,
        0x2ca100002ca2,
        0x2ca300002ca4,
        0x2ca500002ca6,
        0x2ca700002ca8,
        0x2ca900002caa,
        0x2cab00002cac,
        0x2cad00002cae,
        0x2caf00002cb0,
        0x2cb100002cb2,
        0x2cb300002cb4,
        0x2cb500002cb6,
        0x2cb700002cb8,
        0x2cb900002cba,
        0x2cbb00002cbc,
        0x2cbd00002cbe,
        0x2cbf00002cc0,
        0x2cc100002cc2,
        0x2cc300002cc4,
        0x2cc500002cc6,
        0x2cc700002cc8,
        0x2cc900002cca,
        0x2ccb00002ccc,
        0x2ccd00002cce,
        0x2ccf00002cd0,
        0x2cd100002cd2,
        0x2cd300002cd4,
        0x2cd500002cd6,
        0x2cd700002cd8,
        0x2cd900002cda,
        0x2cdb00002cdc,
        0x2cdd00002cde,
        0x2cdf00002ce0,
        0x2ce100002ce2,
        0x2ce300002ce5,
        0x2cec00002ced,
        0x2cee00002cf2,
        0x2cf300002cf4,
        0x2d0000002d26,
        0x2d2700002d28,
        0x2d2d00002d2e,
        0x2d3000002d68,
        0x2d7f00002d97,
        0x2da000002da7,
        0x2da800002daf,
        0x2db000002db7,
        0x2db800002dbf,
        0x2dc000002dc7,
        0x2dc800002dcf,
        0x2dd000002dd7,
        0x2dd800002ddf,
        0x2de000002e00,
        0x2e2f00002e30,
        0x300500003008,
        0x302a0000302e,
        0x303c0000303d,
        0x304100003097,
        0x30990000309b,
        0x309d0000309f,
        0x30a1000030fb,
        0x30fc000030ff,
        0x310500003130,
        0x31a0000031bb,
        0x31f000003200,
        0x340000004db6,
        0x4e0000009ff0,
        0xa0000000a48d,
        0xa4d00000a4fe,
        0xa5000000a60d,
        0xa6100000a62c,
        0xa6410000a642,
        0xa6430000a644,
        0xa6450000a646,
        0xa6470000a648,
        0xa6490000a64a,
        0xa64b0000a64c,
        0xa64d0000a64e,
        0xa64f0000a650,
        0xa6510000a652,
        0xa6530000a654,
        0xa6550000a656,
        0xa6570000a658,
        0xa6590000a65a,
        0xa65b0000a65c,
        0xa65d0000a65e,
        0xa65f0000a660,
        0xa6610000a662,
        0xa6630000a664,
        0xa6650000a666,
        0xa6670000a668,
        0xa6690000a66a,
        0xa66b0000a66c,
        0xa66d0000a670,
        0xa6740000a67e,
        0xa67f0000a680,
        0xa6810000a682,
        0xa6830000a684,
        0xa6850000a686,
        0xa6870000a688,
        0xa6890000a68a,
        0xa68b0000a68c,
        0xa68d0000a68e,
        0xa68f0000a690,
        0xa6910000a692,
        0xa6930000a694,
        0xa6950000a696,
        0xa6970000a698,
        0xa6990000a69a,
        0xa69b0000a69c,
        0xa69e0000a6e6,
        0xa6f00000a6f2,
        0xa7170000a720,
        0xa7230000a724,
        0xa7250000a726,
        0xa7270000a728,
        0xa7290000a72a,
        0xa72b0000a72c,
        0xa72d0000a72e,
        0xa72f0000a732,
        0xa7330000a734,
        0xa7350000a736,
        0xa7370000a738,
        0xa7390000a73a,
        0xa73b0000a73c,
        0xa73d0000a73e,
        0xa73f0000a740,
        0xa7410000a742,
        0xa7430000a744,
        0xa7450000a746,
        0xa7470000a748,
        0xa7490000a74a,
        0xa74b0000a74c,
        0xa74d0000a74e,
        0xa74f0000a750,
        0xa7510000a752,
        0xa7530000a754,
        0xa7550000a756,
        0xa7570000a758,
        0xa7590000a75a,
        0xa75b0000a75c,
        0xa75d0000a75e,
        0xa75f0000a760,
        0xa7610000a762,
        0xa7630000a764,
        0xa7650000a766,
        0xa7670000a768,
        0xa7690000a76a,
        0xa76b0000a76c,
        0xa76d0000a76e,
        0xa76f0000a770,
        0xa7710000a779,
        0xa77a0000a77b,
        0xa77c0000a77d,
        0xa77f0000a780,
        0xa7810000a782,
        0xa7830000a784,
        0xa7850000a786,
        0xa7870000a789,
        0xa78c0000a78d,
        0xa78e0000a790,
        0xa7910000a792,
        0xa7930000a796,
        0xa7970000a798,
        0xa7990000a79a,
        0xa79b0000a79c,
        0xa79d0000a79e,
        0xa79f0000a7a0,
        0xa7a10000a7a2,
        0xa7a30000a7a4,
        0xa7a50000a7a6,
        0xa7a70000a7a8,
        0xa7a90000a7aa,
        0xa7af0000a7b0,
        0xa7b50000a7b6,
        0xa7b70000a7b8,
        0xa7b90000a7ba,
        0xa7f70000a7f8,
        0xa7fa0000a828,
        0xa8400000a874,
        0xa8800000a8c6,
        0xa8d00000a8da,
        0xa8e00000a8f8,
        0xa8fb0000a8fc,
        0xa8fd0000a92e,
        0xa9300000a954,
        0xa9800000a9c1,
        0xa9cf0000a9da,
        0xa9e00000a9ff,
        0xaa000000aa37,
        0xaa400000aa4e,
        0xaa500000aa5a,
        0xaa600000aa77,
        0xaa7a0000aac3,
        0xaadb0000aade,
        0xaae00000aaf0,
        0xaaf20000aaf7,
        0xab010000ab07,
        0xab090000ab0f,
        0xab110000ab17,
        0xab200000ab27,
        0xab280000ab2f,
        0xab300000ab5b,
        0xab600000ab66,
        0xabc00000abeb,
        0xabec0000abee,
        0xabf00000abfa,
        0xac000000d7a4,
        0xfa0e0000fa10,
        0xfa110000fa12,
        0xfa130000fa15,
        0xfa1f0000fa20,
        0xfa210000fa22,
        0xfa230000fa25,
        0xfa270000fa2a,
        0xfb1e0000fb1f,
        0xfe200000fe30,
        0xfe730000fe74,
        0x100000001000c,
        0x1000d00010027,
        0x100280001003b,
        0x1003c0001003e,
        0x1003f0001004e,
        0x100500001005e,
        0x10080000100fb,
        0x101fd000101fe,
        0x102800001029d,
        0x102a0000102d1,
        0x102e0000102e1,
        0x1030000010320,
        0x1032d00010341,
        0x103420001034a,
        0x103500001037b,
        0x103800001039e,
        0x103a0000103c4,
        0x103c8000103d0,
        0x104280001049e,
        0x104a0000104aa,
        0x104d8000104fc,
        0x1050000010528,
        0x1053000010564,
        0x1060000010737,
        0x1074000010756,
        0x1076000010768,
        0x1080000010806,
        0x1080800010809,
        0x1080a00010836,
        0x1083700010839,
        0x1083c0001083d,
        0x1083f00010856,
        0x1086000010877,
        0x108800001089f,
        0x108e0000108f3,
        0x108f4000108f6,
        0x1090000010916,
        0x109200001093a,
        0x10980000109b8,
        0x109be000109c0,
        0x10a0000010a04,
        0x10a0500010a07,
        0x10a0c00010a14,
        0x10a1500010a18,
        0x10a1900010a36,
        0x10a3800010a3b,
        0x10a3f00010a40,
        0x10a6000010a7d,
        0x10a8000010a9d,
        0x10ac000010ac8,
        0x10ac900010ae7,
        0x10b0000010b36,
        0x10b4000010b56,
        0x10b6000010b73,
        0x10b8000010b92,
        0x10c0000010c49,
        0x10cc000010cf3,
        0x10d0000010d28,
        0x10d3000010d3a,
        0x10f0000010f1d,
        0x10f2700010f28,
        0x10f3000010f51,
        0x1100000011047,
        0x1106600011070,
        0x1107f000110bb,
        0x110d0000110e9,
        0x110f0000110fa,
        0x1110000011135,
        0x1113600011140,
        0x1114400011147,
        0x1115000011174,
        0x1117600011177,
        0x11180000111c5,
        0x111c9000111cd,
        0x111d0000111db,
        0x111dc000111dd,
        0x1120000011212,
        0x1121300011238,
        0x1123e0001123f,
        0x1128000011287,
        0x1128800011289,
        0x1128a0001128e,
        0x1128f0001129e,
        0x1129f000112a9,
        0x112b0000112eb,
        0x112f0000112fa,
        0x1130000011304,
        0x113050001130d,
        0x1130f00011311,
        0x1131300011329,
        0x1132a00011331,
        0x1133200011334,
        0x113350001133a,
        0x1133b00011345,
        0x1134700011349,
        0x1134b0001134e,
        0x1135000011351,
        0x1135700011358,
        0x1135d00011364,
        0x113660001136d,
        0x1137000011375,
        0x114000001144b,
        0x114500001145a,
        0x1145e0001145f,
        0x11480000114c6,
        0x114c7000114c8,
        0x114d0000114da,
        0x11580000115b6,
        0x115b8000115c1,
        0x115d8000115de,
        0x1160000011641,
        0x1164400011645,
        0x116500001165a,
        0x11680000116b8,
        0x116c0000116ca,
        0x117000001171b,
        0x1171d0001172c,
        0x117300001173a,
        0x118000001183b,
        0x118c0000118ea,
        0x118ff00011900,
        0x11a0000011a3f,
        0x11a4700011a48,
        0x11a5000011a84,
        0x11a8600011a9a,
        0x11a9d00011a9e,
        0x11ac000011af9,
        0x11c0000011c09,
        0x11c0a00011c37,
        0x11c3800011c41,
        0x11c5000011c5a,
        0x11c7200011c90,
        0x11c9200011ca8,
        0x11ca900011cb7,
        0x11d0000011d07,
        0x11d0800011d0a,
        0x11d0b00011d37,
        0x11d3a00011d3b,
        0x11d3c00011d3e,
        0x11d3f00011d48,
        0x11d5000011d5a,
        0x11d6000011d66,
        0x11d6700011d69,
        0x11d6a00011d8f,
        0x11d9000011d92,
        0x11d9300011d99,
        0x11da000011daa,
        0x11ee000011ef7,
        0x120000001239a,
        0x1248000012544,
        0x130000001342f,
        0x1440000014647,
        0x1680000016a39,
        0x16a4000016a5f,
        0x16a6000016a6a,
        0x16ad000016aee,
        0x16af000016af5,
        0x16b0000016b37,
        0x16b4000016b44,
        0x16b5000016b5a,
        0x16b6300016b78,
        0x16b7d00016b90,
        0x16e6000016e80,
        0x16f0000016f45,
        0x16f5000016f7f,
        0x16f8f00016fa0,
        0x16fe000016fe2,
        0x17000000187f2,
        0x1880000018af3,
        0x1b0000001b11f,
        0x1b1700001b2fc,
        0x1bc000001bc6b,
        0x1bc700001bc7d,
        0x1bc800001bc89,
        0x1bc900001bc9a,
        0x1bc9d0001bc9f,
        0x1da000001da37,
        0x1da3b0001da6d,
        0x1da750001da76,
        0x1da840001da85,
        0x1da9b0001daa0,
        0x1daa10001dab0,
        0x1e0000001e007,
        0x1e0080001e019,
        0x1e01b0001e022,
        0x1e0230001e025,
        0x1e0260001e02b,
        0x1e8000001e8c5,
        0x1e8d00001e8d7,
        0x1e9220001e94b,
        0x1e9500001e95a,
        0x200000002a6d7,
        0x2a7000002b735,
        0x2b7400002b81e,
        0x2b8200002cea2,
        0x2ceb00002ebe1,
    ),
    'CONTEXTJ': (
        0x200c0000200e,
    ),
    'CONTEXTO': (
        0xb7000000b8,
        0x37500000376,
        0x5f3000005f5,
        0x6600000066a,
        0x6f0000006fa,
        0x30fb000030fc,
    ),
}
site-packages/pip/_vendor/idna/package_data.py000064400000000025151446177000015363 0ustar00__version__ = '2.8'

site-packages/pip/_vendor/idna/compat.py000064400000000350151446177000014263 0ustar00from .core import *
from .codec import *

def ToASCII(label):
    return encode(label)

def ToUnicode(label):
    return decode(label)

def nameprep(s):
    raise NotImplementedError("IDNA 2008 does not utilise nameprep protocol")

site-packages/pip/_vendor/idna/intranges.py000064400000003325151446177000014777 0ustar00"""
Given a list of integers, made up of (hopefully) a small number of long runs
of consecutive integers, compute a representation of the form
((start1, end1), (start2, end2) ...). Then answer the question "was x present
in the original list?" in time O(log(# runs)).
"""

import bisect

def intranges_from_list(list_):
    """Represent a list of integers as a sequence of ranges:
    ((start_0, end_0), (start_1, end_1), ...), such that the original
    integers are exactly those x such that start_i <= x < end_i for some i.

    Ranges are encoded as single integers (start << 32 | end), not as tuples.
    """

    sorted_list = sorted(list_)
    ranges = []
    last_write = -1
    for i in range(len(sorted_list)):
        if i+1 < len(sorted_list):
            if sorted_list[i] == sorted_list[i+1]-1:
                continue
        current_range = sorted_list[last_write+1:i+1]
        ranges.append(_encode_range(current_range[0], current_range[-1] + 1))
        last_write = i

    return tuple(ranges)

def _encode_range(start, end):
    return (start << 32) | end

def _decode_range(r):
    return (r >> 32), (r & ((1 << 32) - 1))


def intranges_contain(int_, ranges):
    """Determine if `int_` falls into one of the ranges in `ranges`."""
    tuple_ = _encode_range(int_, 0)
    pos = bisect.bisect_left(ranges, tuple_)
    # we could be immediately ahead of a tuple (start, end)
    # with start < int_ <= end
    if pos > 0:
        left, right = _decode_range(ranges[pos-1])
        if left <= int_ < right:
            return True
    # or we could be immediately behind a tuple (int_, end)
    if pos < len(ranges):
        left, _ = _decode_range(ranges[pos])
        if left == int_:
            return True
    return False
site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000335151446177000021767 0ustar00U

��.e:�@sddlmZddlTdS)�)�__version__)�*N)Zpackage_datarZcore�rr�=/usr/lib/python3.8/site-packages/pip/_vendor/idna/__init__.py�<module>ssite-packages/pip/_vendor/idna/__pycache__/compat.cpython-38.pyc000064400000001121151446177000020546 0ustar00U

��.e��@s,ddlTddlTdd�Zdd�Zdd�ZdS)	�)�*cCst|�S�N)�encode�Zlabel�r�;/usr/lib/python3.8/site-packages/pip/_vendor/idna/compat.py�ToASCIIsrcCst|�Sr)�decoderrrr�	ToUnicodesr
cCstd��dS)Nz,IDNA 2008 does not utilise nameprep protocol)�NotImplementedError)�srrr�nameprep
sr
N)Zcore�codecrr
r
rrrr�<module>ssite-packages/pip/_vendor/idna/__pycache__/core.cpython-38.pyc000064400000021461151446177000020224 0ustar00U

��.e�-�@s>ddlmZddlZddlZddlZddlZddlmZdZdZ	e�
d�Zejddkr`e
ZeZGd	d
�d
e�ZGdd�de�ZGd
d�de�ZGdd�de�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd7dd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Z d8d(d)�Z!d*d+�Z"d,d-�Z#d.d/�Z$d9d1d2�Z%d:d3d4�Z&d;d5d6�Z'dS)<�)�idnadata�N)�intranges_contain�	sxn--u[.。.。]�c@seZdZdZdS)�	IDNAErrorz7 Base exception for all IDNA-encoding related problems N��__name__�
__module__�__qualname__�__doc__�r
r
�9/usr/lib/python3.8/site-packages/pip/_vendor/idna/core.pyrsrc@seZdZdZdS)�
IDNABidiErrorz= Exception when bidirectional requirements are not satisfied Nrr
r
r
rrsrc@seZdZdZdS)�InvalidCodepointz> Exception when a disallowed or unallocated codepoint is used Nrr
r
r
rrsrc@seZdZdZdS)�InvalidCodepointContextzE Exception when the codepoint is not valid in the context it is used Nrr
r
r
rrsrcCs0t�t|��}|dkr,t�t|��s,td��|S)Nrz Unknown character in unicodedata)�unicodedataZ	combining�unichr�name�
ValueError)�cp�vr
r
r�_combining_class$s
rcCstt|�tj|�S)N)r�ordrZscripts)rZscriptr
r
r�
_is_script+srcCs
|�d�S)N�punycode)�encode��sr
r
r�	_punycode.srcCs
d�|�S)Nz	U+{0:04X})�formatrr
r
r�_unot1sr!cCst|�dkrdSdS)N�?FT��len��labelr
r
r�valid_label_length5sr'cCst|�|rdndkrdSdS)N��FTr#)r&�trailing_dotr
r
r�valid_string_length<sr+Fc	Cs^d}t|d�D]:\}}t�|�}|dkr<td�t|�|���|dkrd}q|sV|sVdSt�|d�}|dkrrd}n |d	kr�d}ntd
�t|����d}d}t|d�D]�\}}t�|�}|�r|dkr�td�|���|d
kr�d}n|dkr�d}|dk�rJ|�s|}n||k�rJtd��q�|dk�r.td�|���|dk�r>d}q�|dkr�d}q�|�sZtd��dS)NFr�z3Unknown directionality in label {0} at position {1})�R�AL�ANTr)r-r.�Lz>First codepoint in label {0} must be directionality L, R or AL)
r-r.r/�EN�ES�CS�ET�ON�BN�NSMzHInvalid direction for codepoint at position {0} in a right-to-left label)r-r.r1r/r7)r/r1z2Can not mix numeral types in a right-to-left label)r0r1r2r3r4r5r6r7zHInvalid direction for codepoint at position {0} in a left-to-right label)r0r1z0Label ends with illegal codepoint directionality)�	enumeraterZ
bidirectionalrr �repr)	r&Z	check_ltrZ
bidi_label�idxr�	directionZrtlZvalid_endingZnumber_typer
r
r�
check_bidiCsP






r<cCs"t�|d�ddkrtd��dS)Nr�Mz0Label begins with an illegal combining characterT)r�categoryrr%r
r
r�check_initial_combinersr?cCs<|dd�dkrtd��|ddks0|ddkr8td��d	S)
N��z--z4Label has disallowed hyphens in 3rd and 4th positionr�-���z)Label must not start or end with a hyphenT)rr%r
r
r�check_hyphen_ok�s
rDcCst�d|�|krtd��dS)N�NFCz%Label must be in Normalization Form C)r�	normalizerr%r
r
r�	check_nfc�srGcCs4t||�}|dkr�|dkr8tt||d��tkr8dSd}t|ddd�D]B}tj�t||��}|td�krrqL|td�td	�fkrLd}q�qL|s�dSd}t|dt|��D]B}tj�t||��}|td�kr�q�|td
�td	�fkr�d}q�q�|S|dk�r,|dk�r(tt||d��tk�r(dSdSdSdS)Ni rrTFrC�Tr0�Dr-i
 )rr�_virama_combining_class�rangerZ
joining_types�getr$)r&�pos�cp_value�ok�iZjoining_typer
r
r�valid_contextj�s<

rQcCs�t||�}|dkrdd|kr0t|�dkr`nn,t||d�dkr`t||d�dkr`dSdS|dkr�|t|�dkr�t|�dkr�t||dd�SdS|d	ks�|d
kr�|dkr�t||dd�SdS|dk�r|D]6}|d
kr�q�t|d��s
t|d��s
t|d�r�dSq�dSd|k�r.dk�rhnn6|D],}dt|�k�rVdk�r6nndS�q6dSd|k�r�dk�r�nn6|D],}dt|�k�r�dk�r�nndS�q�dSdS)N�rr�lTFiuZGreeki�i�ZHebrewi�0u・ZHiraganaZKatakanaZHani`iii�i�)rr$r)r&rMZ	exceptionrNrr
r
r�valid_contexto�s> (
" 
 
rTcCsLt|ttf�r|�d�}t|�dkr,td��t|�t|�t|�t	|�D]�\}}t
|�}t|tj
d�rpqLqLt|tj
d�r�z,t||�s�td�t|�|dt|����Wn2tk
r�td�t|�|dt|����YnXqLt|tj
d	��r t||��s>td
�t|�|dt|����qLtd�t|�|dt|����qLt|�dS)Nzutf-8rzEmpty LabelZPVALIDZCONTEXTJz-Joiner {0} not allowed at position {1} in {2}rz?Unknown codepoint adjacent to joiner {0} at position {1} in {2}ZCONTEXTO�0Codepoint {0} not allowed at position {1} in {2}z0Codepoint {0} at position {1} of {2} not allowed)�
isinstance�bytes�	bytearray�decoder$rrGrDr?r8rrrZcodepoint_classesrQrr r!r9rrTrr<)r&rMrrNr
r
r�check_label�s<

�
�  rZcCs~z(|�d�}t|�t|�s$td��|WStk
r<YnX|sJtd��t|�}t|�t|�}t|}t|�sztd��|S)N�asciizLabel too longzNo Input)	r�ulabelr'r�UnicodeEncodeError�unicoderZr�_alabel_prefixr%r
r
r�alabel
s"
r`cCs�t|ttf�s>z|�d�}Wn tk
r<t|�|YSX|��}|�t�rb|t	t�d�}nt|�|�
d�S|�
d�}t|�|S)Nr[r)rVrWrXrr]rZ�lower�
startswithr_r$rYr%r
r
rr\#s



r\Tc
Cs(ddlm}d}z�t|�D]�\}}t|�}||dkr8|nt�||df�d}|d}	t|�dkrj|dnd}
|	d	ks�|	d
kr�|r�|	dkr�|s�|
dkr�||7}q|
dk	r�|	dks�|	dkr�|r�|	d
kr�|r�||
7}q|	d
krt��qt�d|�WStk
�r"t	d�
t|�|dt|����YnXdS)zBRe-map the characters in the string according to UTS46 processing.r)�	uts46datar,��Zrr@N�VrI�3r=�IrErU)
rcr8r�bisectZbisect_leftr$�
IndexErrorrrFrr r!r9)Zdomain�
std3_rules�transitionalrc�outputrM�charZ
code_pointZuts46rowZstatusZreplacementr
r
r�uts46_remap8sV������
����
��roc	Cs�t|ttf�r|�d�}|r(t|||�}d}g}|r@|�d�}n
t�|�}|rX|dgkr`td��|ddkrv|d=d}|D]$}t|�}|r�|�	|�qztd��qz|r�|�	d	�d
�
|�}t||�s�td��|S)Nr[F�.r,�Empty domainrCT�Empty label��.zDomain too long)rVrWrXrYro�split�_unicode_dots_rerr`�append�joinr+)	r�strict�uts46rkrlr*�result�labelsr&r
r
rrTs2





rcCs�t|ttf�r|�d�}|r(t||d�}d}g}|s@t�|�}n
|�d�}|rX|dgkr`td��|dsr|d=d}|D]$}t|�}|r�|�	|�qvtd��qv|r�|�	d�d�
|�S)	Nr[Frpr,rqrCTrr)rVrWrXrYrorvrurr\rwrx)rryrzrkr*r{r|r&r
r
rrYss,



rY)F)F)TF)FFFF)FFF)(r,rrir�re�sysZ	intrangesrrJr_�compilerv�version_info�strr^�chrr�UnicodeErrorrrrrrrrr!r'r+r<r?rDrGrQrTrZr`r\rorrYr
r
r
r�<module>sB

<	,
) 

site-packages/pip/_vendor/idna/__pycache__/uts46data.cpython-38.opt-1.pyc000064400000524104151446177000022054 0ustar00U

��.e��@sbdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Zd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Zd>d?�Z d@dA�Z!dBdC�Z"dDdE�Z#dFdG�Z$dHdI�Z%dJdK�Z&dLdM�Z'dNdO�Z(dPdQ�Z)dRdS�Z*dTdU�Z+dVdW�Z,dXdY�Z-dZd[�Z.d\d]�Z/d^d_�Z0d`da�Z1dbdc�Z2ddde�Z3dfdg�Z4dhdi�Z5djdk�Z6dldm�Z7dndo�Z8dpdq�Z9drds�Z:dtdu�Z;dvdw�Z<dxdy�Z=dzd{�Z>d|d}�Z?d~d�Z@d�d��ZAd�d��ZBd�d��ZCd�d��ZDd�d��ZEd�d��ZFd�d��ZGd�d��ZHd�d��ZId�d��ZJd�d��ZKd�d��ZLd�d��ZMd�d��ZNd�d��ZOd�d��ZPeQe�e�e�e�e�e�e�e	�e
�e�e�e
�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e �e!�e"�e#�e$�e%�e&�e'�e(�e)�e*�e+�e,�e-�e.�e/�e0�e1�e2�e3�e4�e5�e6�e7�e8�e9�e:�e;�e<�e=�e>�e?�e@�eA�eB�eC�eD�eE�eF�eG�eH�eI�eJ�eK�eL�eM�eN�eO�eP��ZRd�S)�zIDNA Mapping Table from UTS46.z11.0.0cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)��3)�r)�r)�r)�r)�r)�r)�r)�r)�	r)�
r)�r)�r)�
r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)� r)�!r)�"r)�#r)�$r)�%r)�&r)�'r)�(r)�)r)�*r)�+r)�,r)�-�V)�.r0)�/r)�0r0)�1r0)�2r0)�3r0)�4r0)�5r0)�6r0)�7r0)�8r0)�9r0)�:r)�;r)�<r)�=r)�>r)�?r)�@r)�A�M�a)�BrE�b)�CrE�c)�DrE�d)�ErE�e)�FrE�f)�GrE�g)�HrE�h)�IrE�i)�JrE�j)�KrE�k)�LrE�l)�MrE�m)�NrE�n)�OrE�o)�PrE�p)�QrE�q)�RrE�r)�SrE�s)�TrE�t)�UrE�u)�VrE�v)�WrE�w)�XrE�x)�YrE�y)�ZrE�z)�[r)�\r)�]r)�^r)�_r)�`r)�ar0)�br0)�cr0�r�r�r��>/usr/lib/python3.8/site-packages/pip/_vendor/idna/uts46data.py�_seg_0s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)�dr0)�er0)�fr0)�gr0)�hr0)�ir0)�jr0)�kr0)�lr0)�mr0)�nr0)�or0)�pr0)�qr0)�rr0)�sr0)�tr0)�ur0)�vr0)�wr0)�xr0)�yr0)�zr0)�{r)�|r)�}r)�~r)�r)��X)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r� )�r0)�r0)�r0)�r0)�r0)�r0)�r0)�ru ̈)�r0)�rErF)�r0)�r0)��I)�r0)�r� ̄)�r0)�r0)�rE�2)�rEr)�r� ́)�rE�μ)�r0)�r0)�ru ̧)�rE�1)�rErb)�r0)�rEu1⁄4)�rEu1⁄2)�rEu3⁄4)�r0)�rE�à)�rE�á)��rE�â)��rE�ã)��rE�ä)��rE�å)��rE�æ)��rE�çr�r�r�r�r��_seg_1ps��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)��rE�è)��rE�é)��rE�ê)��rE�ë)��rE�ì)��rE�í)��rE�î)��rE�ï)��rE�ð)��rE�ñ)��rE�ò)��rE�ó)��rE�ô)��rE�õ)��rE�ö)��r0)��rE�ø)��rE�ù)��rE�ú)��rE�û)��rE�ü)��rE�ý)��rE�þ)���D�ss)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�rEuā)ir0)irEuă)ir0)irEuą)ir0)irEuć)ir0)irEuĉ)i	r0)i
rEuċ)ir0)irEuč)i
r0)irEuď)ir0)irEuđ)ir0)irEuē)ir0)irEuĕ)ir0)irEuė)ir0)irEuę)ir0)irEuě)ir0)irEuĝ)ir0)irEuğ)ir0)i rEuġ)i!r0)i"rEuģ)i#r0)i$rEuĥ)i%r0)i&rE�ħ)i'r0)i(rEuĩ)i)r0)i*rEuī)i+r0r�r�r�r�r��_seg_2�s��rLcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i,rEuĭ)i-r0)i.rEuį)i/r0)i0rEui̇)i1r0)i2rEZij)i4rEuĵ)i5r0)i6rEuķ)i7r0)i9rEuĺ)i:r0)i;rEuļ)i<r0)i=rEuľ)i>r0)i?rEul·)iArEuł)iBr0)iCrEuń)iDr0)iErEuņ)iFr0)iGrEuň)iHr0)iIrEuʼn)iJrE�ŋ)iKr0)iLrEuō)iMr0)iNrEuŏ)iOr0)iPrEuő)iQr0)iRrE�œ)iSr0)iTrEuŕ)iUr0)iVrEuŗ)iWr0)iXrEuř)iYr0)iZrEuś)i[r0)i\rEuŝ)i]r0)i^rEuş)i_r0)i`rEuš)iar0)ibrEuţ)icr0)idrEuť)ier0)ifrEuŧ)igr0)ihrEuũ)iir0)ijrEuū)ikr0)ilrEuŭ)imr0)inrEuů)ior0)iprEuű)iqr0)irrEuų)isr0)itrEuŵ)iur0)ivrEuŷ)iwr0)ixrE�ÿ)iyrEuź)izr0)i{rEuż)i|r0)i}rEuž)i~r0)irErj)i�r0)i�rEuɓ)i�rEuƃ)i�r0)i�rEuƅ)i�r0)i�rE�ɔ)i�rEuƈ)i�r0)i�rEuɖ)i�rEuɗ)i�rEuƌ)i�r0)i�rE�ǝ)i�rE�ə)i�rE�ɛ)i�rEuƒ)i�r0)i�rEuɠr�r�r�r�r��_seg_3@s��rTcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rE�ɣ)i�r0)i�rE�ɩ)i�rE�ɨ)i�rEuƙ)i�r0)i�rE�ɯ)i�rE�ɲ)i�r0)i�rE�ɵ)i�rEuơ)i�r0)i�rEuƣ)i�r0)i�rEuƥ)i�r0)i�rEuʀ)i�rEuƨ)i�r0)i�rE�ʃ)i�r0)i�rEuƭ)i�r0)i�rEuʈ)i�rEuư)i�r0)i�rE�ʊ)i�rE�ʋ)i�rEuƴ)i�r0)i�rEuƶ)i�r0)i�rE�ʒ)i�rEuƹ)i�r0)i�rEuƽ)i�r0)i�rEudž)i�rEZlj)i�rEZnj)i�rEuǎ)i�r0)i�rEuǐ)i�r0)i�rEuǒ)i�r0)i�rEuǔ)i�r0)i�rEuǖ)i�r0)i�rEuǘ)i�r0)i�rEuǚ)i�r0)i�rEuǜ)i�r0)i�rEuǟ)i�r0)i�rEuǡ)i�r0)i�rEuǣ)i�r0)i�rEuǥ)i�r0)i�rEuǧ)i�r0)i�rEuǩ)i�r0)i�rEuǫ)i�r0)i�rEuǭ)i�r0)i�rEuǯ)i�r0)i�rEZdz)i�rEuǵ)i�r0)i�rEuƕ)i�rEuƿ)i�rEuǹ)i�r0)i�rEuǻ)i�r0)i�rEuǽ)i�r0)i�rEuǿ)i�r0)irEuȁ)ir0)irEuȃ)ir0)irEuȅ)ir0)irEuȇ)ir0)irEuȉ)i	r0)i
rEuȋ)ir0)irEuȍr�r�r�r�r��_seg_4�s��r_cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i
r0)irEuȏ)ir0)irEuȑ)ir0)irEuȓ)ir0)irEuȕ)ir0)irEuȗ)ir0)irEuș)ir0)irEuț)ir0)irEuȝ)ir0)irEuȟ)ir0)i rEuƞ)i!r0)i"rE�ȣ)i#r0)i$rEuȥ)i%r0)i&rEuȧ)i'r0)i(rEuȩ)i)r0)i*rEuȫ)i+r0)i,rEuȭ)i-r0)i.rEuȯ)i/r0)i0rEuȱ)i1r0)i2rEuȳ)i3r0)i:rEuⱥ)i;rEuȼ)i<r0)i=rEuƚ)i>rEuⱦ)i?r0)iArEuɂ)iBr0)iCrEuƀ)iDrE�ʉ)iErE�ʌ)iFrEuɇ)iGr0)iHrEuɉ)iIr0)iJrEuɋ)iKr0)iLrEuɍ)iMr0)iNrEuɏ)iOr0)i�rErT)i�rE�ɦ)i�rErX)i�rErh)i�rEuɹ)i�rEuɻ)i�rEuʁ)i�rErr)i�rErv)i�r0)i�ru ̆)i�ru ̇)i�ru ̊)i�ru ̨)i�ru ̃)i�ru ̋)i�r0)i�rErU)i�rEr\)i�rErj)i�rErt)i�rEuʕ)i�r0)i@rEù)iArEú)iBr0)iCrEu̓)iDrEǘ)iErE�ι)iFr0)iOr�)iPr0)iprEuͱ)iqr0)irrEuͳ)isr0)itrEuʹ)iur0)ivrEuͷ)iwr0r�r�r�r�r��_seg_5s��recdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ixr�)izru ι)i{r0)i~r�;)irEuϳ)i�r�)i�rr�)i�r� ̈́)i�rE�ά)i�rE�·)i�rE�έ)i�rE�ή)i�rE�ί)i�r�)i�rE�ό)i�r�)i�rE�ύ)i�rE�ώ)i�r0)i�rE�α)i�rE�β)i�rE�γ)i�rE�δ)i�rE�ε)i�rE�ζ)i�rE�η)i�rE�θ)i�rErd)i�rE�κ)i�rE�λ)i�rEr�)i�rE�ν)i�rE�ξ)i�rE�ο)i�rE�π)i�rE�ρ)i�r�)i�rE�σ)i�rE�τ)i�rE�υ)i�rE�φ)i�rE�χ)i�rE�ψ)i�rE�ω)i�rEuϊ)i�rE�ϋ)i�r0)i�r(r)i�r0)i�rEuϗ)i�rErq)i�rErw)i�rEr�)i�rErn)i�rEr�)i�rEr�)i�rEr})i�r0)i�rEuϙ)i�r0)i�rEuϛ)i�r0)i�rE�ϝ)i�r0)i�rEuϟ)i�r0)i�rEuϡ)i�r0)i�rEuϣ)i�r0)i�rEuϥ)i�r0)i�rEuϧ)i�r0)i�rEuϩ)i�r0)i�rEuϫ)i�r0)i�rEuϭ)i�r0)i�rEuϯ)i�r0)i�rErx)i�rEr~)i�rEr)i�r0)i�rErw)i�rErt)i�r0)i�rEuϸ)i�r0)i�rEr)i�rEuϻ)i�r0)i�rEuͻ)i�rEuͼ)i�rEuͽ)irEuѐ)irEuё)irEuђr�r�r�r�r��_seg_6xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)irEuѓ)irEuє)irEuѕ)irEuі)irEuї)irEuј)i	rEuљ)i
rEuњ)irEuћ)irEuќ)i
rEuѝ)irEuў)irEuџ)irEuа)irEuб)irE�в)irEuг)irE�д)irEuе)irEuж)irEuз)irEuи)irEuй)irEuк)irEuл)irEuм)irE�н)irE�о)irEuп)i rEuр)i!rE�с)i"rE�т)i#rEuу)i$rEuф)i%rEuх)i&rEuц)i'rEuч)i(rEuш)i)rEuщ)i*rE�ъ)i+rEuы)i,rE�ь)i-rEuэ)i.rEuю)i/rEuя)i0r0)i`rEuѡ)iar0)ibrE�ѣ)icr0)idrEuѥ)ier0)ifrEuѧ)igr0)ihrEuѩ)iir0)ijrEuѫ)ikr0)ilrEuѭ)imr0)inrEuѯ)ior0)iprEuѱ)iqr0)irrEuѳ)isr0)itrEuѵ)iur0)ivrEuѷ)iwr0)ixrEuѹ)iyr0)izrEuѻ)i{r0)i|rEuѽ)i}r0)i~rEuѿ)ir0)i�rEuҁ)i�r0)i�rEuҋ)i�r0)i�rEuҍ)i�r0)i�rEuҏ)i�r0)i�rEuґ)i�r0)i�rEuғ)i�r0)i�rEuҕ)i�r0)i�rEuҗ)i�r0)i�rEuҙ)i�r0)i�rEuқ)i�r0)i�rEuҝ)i�r0r�r�r�r�r��_seg_7�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEuҟ)i�r0)i�rEuҡ)i�r0)i�rEuң)i�r0)i�rEuҥ)i�r0)i�rEuҧ)i�r0)i�rEuҩ)i�r0)i�rEuҫ)i�r0)i�rEuҭ)i�r0)i�rEuү)i�r0)i�rEuұ)i�r0)i�rEuҳ)i�r0)i�rEuҵ)i�r0)i�rEuҷ)i�r0)i�rEuҹ)i�r0)i�rEuһ)i�r0)i�rEuҽ)i�r0)i�rEuҿ)i�r0)i�r�)i�rEuӂ)i�r0)i�rEuӄ)i�r0)i�rEuӆ)i�r0)i�rEuӈ)i�r0)i�rEuӊ)i�r0)i�rEuӌ)i�r0)i�rEuӎ)i�r0)i�rEuӑ)i�r0)i�rEuӓ)i�r0)i�rEuӕ)i�r0)i�rEuӗ)i�r0)i�rEuә)i�r0)i�rEuӛ)i�r0)i�rEuӝ)i�r0)i�rEuӟ)i�r0)i�rEuӡ)i�r0)i�rEuӣ)i�r0)i�rEuӥ)i�r0)i�rEuӧ)i�r0)i�rEuө)i�r0)i�rEuӫ)i�r0)i�rEuӭ)i�r0)i�rEuӯ)i�r0)i�rEuӱ)i�r0)i�rEuӳ)i�r0)i�rEuӵ)i�r0)i�rEuӷ)i�r0)i�rEuӹ)i�r0)i�rEuӻ)i�r0)i�rEuӽ)i�r0)i�rEuӿ)i�r0)irEuԁ)ir0)irEuԃr�r�r�r�r��_seg_8Hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ir0)irEuԅ)ir0)irEuԇ)ir0)irEuԉ)i	r0)i
rEuԋ)ir0)irEuԍ)i
r0)irEuԏ)ir0)irEuԑ)ir0)irEuԓ)ir0)irEuԕ)ir0)irEuԗ)ir0)irEuԙ)ir0)irEuԛ)ir0)irEuԝ)ir0)irEuԟ)ir0)i rEuԡ)i!r0)i"rEuԣ)i#r0)i$rEuԥ)i%r0)i&rEuԧ)i'r0)i(rEuԩ)i)r0)i*rEuԫ)i+r0)i,rEuԭ)i-r0)i.rEuԯ)i/r0)i0r�)i1rEuա)i2rEuբ)i3rEuգ)i4rEuդ)i5rEuե)i6rEuզ)i7rEuէ)i8rEuը)i9rEuթ)i:rEuժ)i;rEuի)i<rEuլ)i=rEuխ)i>rEuծ)i?rEuկ)i@rEuհ)iArEuձ)iBrEuղ)iCrEuճ)iDrEuմ)iErEuյ)iFrEuն)iGrEuշ)iHrEuո)iIrEuչ)iJrEuպ)iKrEuջ)iLrEuռ)iMrEuս)iNrEuվ)iOrEuտ)iPrEuր)iQrEuց)iRrEuւ)iSrEuփ)iTrEuք)iUrEuօ)iVrEuֆ)iWr�)iYr0)i�rEuեւ)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0r�r�r�r�r��_seg_9�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iurEuاٴ)ivrEuوٴ)iwrE�ۇٴ)ixrEuيٴ)iyr0)i�r�)i�r0)ir�)ir0)iKr�)iMr0)i�r�)i�r0)i�r�)i�r0)i.r�)i0r0)i?r�)i@r0)i\r�)i^r0)i_r�)i`r0)ikr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)iX	rEuक़)iY	rEuख़)iZ	rEuग़)i[	rEuज़)i\	rEuड़)i]	rEuढ़)i^	rEuफ़)i_	rEuय़)i`	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	rEuড়)i�	rEuঢ়)i�	r�)i�	rEuয়)i�	r0)i�	r�)i�	r0)i�	r�)i
r0)i
r�)i
r0)i
r�)i
r0)i
r�)i
r0)i)
r�)i*
r0)i1
r�)i2
r0)i3
rEuਲ਼)i4
r�)i5
r0)i6
rEuਸ਼)i7
r�)i8
r0)i:
r�)i<
r0)i=
r�)i>
r0)iC
r�)iG
r0)iI
r�)iK
r0)iN
r�)iQ
r0)iR
r�)iY
rEuਖ਼)iZ
rEuਗ਼)i[
rEuਜ਼r�r�r�r�r��_seg_10s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i\
r0)i]
r�)i^
rEuਫ਼)i_
r�)if
r0)iw
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)ir�)ir0)ir�)ir0)i
r�)ir0)ir�)ir0)i)r�)i*r0)i1r�)i2r0)i4r�)i5r0)i:r�)i<r0)iEr�)iGr0)iIr�)iKr0)iNr�)iVr0)iXr�)i\rEuଡ଼)i]rEuଢ଼)i^r�)i_r0)idr�)ifr0)ixr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i
r�)ir0)ir�)ir0r�r�r�r�r��_seg_11�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i)r�)i*r0)i:r�)i=r0)iEr�)iFr0)iIr�)iJr0)iNr�)iUr0)iWr�)iXr0)i[r�)i`r0)idr�)ifr0)ipr�)ixr0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i
r0)i
r�)i
r0)i

r�)i
r0)i
r�)i
r0)iE
r�)iF
r0)iI
r�)iJ
r0)iP
r�)iT
r0)id
r�)if
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)ir0)i3rEuํา)i4r0)i;r�)i?r0)i\r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0r�r�r�r�r��_seg_12�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�rEuໍາ)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�rEuຫນ)i�rEuຫມ)i�r0)i�r�)ir0)irEu་)i
r0)iCrEuགྷ)iDr0)iHr�)iIr0)iMrEuཌྷ)iNr0)iRrEuདྷ)iSr0)iWrEuབྷ)iXr0)i\rEuཛྷ)i]r0)iirEuཀྵ)ijr0)imr�)iqr0)isrEuཱི)itr0)iurEuཱུ)ivrEuྲྀ)iwrEu	ྲཱྀ)ixrEuླྀ)iyrEu	ླཱྀ)izr0)i�rEuཱྀ)i�r0)i�rEuྒྷ)i�r0)i�r�)i�r0)i�rEuྜྷ)i�r0)i�rEuྡྷ)i�r0)i�rEuྦྷ)i�r0)i�rEuྫྷ)i�r0)i�rEuྐྵ)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i�r�)i�rEuⴧ)i�r�)i�rEuⴭ)i�r�)i�r0)i�rEuნ)i�r0)i_r�)iar0)iIr�)iJr0)iNr�)iPr0)iWr�)iXr0)iYr�)iZr0)i^r�)i`r0)i�r�)i�r0r�r�r�r�r��_seg_13Ps��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)ir�)ir0)ir�)ir0)i[r�)i]r0)i}r�)i�r0)i�r�)i�r0)i�r�)i�rEuᏰ)i�rEuᏱ)i�rEuᏲ)i�rEuᏳ)i�rEuᏴ)i�rEuᏵ)i�r�)ir0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i
r�)ir0)ir�)i r0)i7r�)i@r0)iTr�)i`r0)imr�)inr0)iqr�)irr0)itr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)ir�)ir�)ir0)ir�)i r0)iyr�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)i r0)i,r�)i0r0)i<r�)i@r0)iAr�)iDr0)inr�)ipr0)iur�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)ir�)ir0)i_r�)i`r0)i}r�)ir0)i�r�)i�r0r�r�r�r�r��_seg_14�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)iLr�)iPr0)i}r�)i�r0)i�r�)i�r0)i8r�)i;r0)iJr�)iMr0)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ꙋ)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i,rErF)i-rEr�)i.rErH)i/r0)i0rErL)i1rErN)i2rErQ)i3rErR)i4rErT)i5rErV)i6rErX)i7rErZ)i8rEr\)i9rEr^)i:rEr`)i;r0)i<rErb)i=rEr`)i>rErd)i?rErh)i@rErl)iArErn)iBrErr)iCrErF)iDrE�ɐ)iErE�ɑ)iFrEuᴂ)iGrErH)iHrErL)iIrErN)iJrErR)iKrErS)iLrE�ɜ)iMrErR)iNr0)iOrErZ)iPrEr^)iQrErM)iRrErb)iSrErP)iTrEuᴖ)iUrEuᴗ)iVrErd)iWrErl)iXrErn)iYrEuᴝ)iZrErX)i[rErp)i\rEuᴥ)i]rErq)i^rErr)i_rErs)i`rEr�)iarEr�)ibrErV)icrErh)idrErn)ierErp)ifrErq)igrErr)ihrEr~)iirEr�)ijrEr�)ikr0)ixrEr�)iyr0)i�rE�ɒ)i�rErJ)i�rEuɕ)i�rErr�r�r�r�r��_seg_15 s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEr�)i�rErP)i�rEuɟ)i�rE�ɡ)i�rE�ɥ)i�rErW)i�rErV)i�rE�ɪ)i�rEuᵻ)i�rE�ʝ)i�rEuɭ)i�rEuᶅ)i�rEuʟ)i�rE�ɱ)i�rEuɰ)i�rErY)i�rEuɳ)i�rEuɴ)i�rErZ)i�rEuɸ)i�rEuʂ)i�rEr[)i�rEuƫ)i�rEra)i�rEr\)i�rEuᴜ)i�rEr])i�rErb)i�rErx)i�rEuʐ)i�rEuʑ)i�rEr^)i�rErw)i�r0)i�r�)i�r0)irEuḁ)ir0)irEuḃ)ir0)irEuḅ)ir0)irEuḇ)ir0)irEuḉ)i	r0)i
rEuḋ)ir0)irEuḍ)i
r0)irEuḏ)ir0)irEuḑ)ir0)irEuḓ)ir0)irEuḕ)ir0)irEuḗ)ir0)irEuḙ)ir0)irEuḛ)ir0)irEuḝ)ir0)irEuḟ)ir0)i rEuḡ)i!r0)i"rEuḣ)i#r0)i$rEuḥ)i%r0)i&rEuḧ)i'r0)i(rEuḩ)i)r0)i*rEuḫ)i+r0)i,rEuḭ)i-r0)i.rEuḯ)i/r0)i0rEuḱ)i1r0)i2rEuḳ)i3r0)i4rEuḵ)i5r0)i6rEuḷ)i7r0)i8rEuḹ)i9r0)i:rEuḻ)i;r0)i<rEuḽ)i=r0)i>rEuḿ)i?r0r�r�r�r�r��_seg_16�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i@rEuṁ)iAr0)iBrEuṃ)iCr0)iDrEuṅ)iEr0)iFrEuṇ)iGr0)iHrEuṉ)iIr0)iJrEuṋ)iKr0)iLrEuṍ)iMr0)iNrEuṏ)iOr0)iPrEuṑ)iQr0)iRrEuṓ)iSr0)iTrEuṕ)iUr0)iVrEuṗ)iWr0)iXrEuṙ)iYr0)iZrEuṛ)i[r0)i\rEuṝ)i]r0)i^rEuṟ)i_r0)i`rE�ṡ)iar0)ibrEuṣ)icr0)idrEuṥ)ier0)ifrEuṧ)igr0)ihrEuṩ)iir0)ijrEuṫ)ikr0)ilrEuṭ)imr0)inrEuṯ)ior0)iprEuṱ)iqr0)irrEuṳ)isr0)itrEuṵ)iur0)ivrEuṷ)iwr0)ixrEuṹ)iyr0)izrEuṻ)i{r0)i|rEuṽ)i}r0)i~rEuṿ)ir0)i�rEuẁ)i�r0)i�rEuẃ)i�r0)i�rEuẅ)i�r0)i�rEuẇ)i�r0)i�rEuẉ)i�r0)i�rEuẋ)i�r0)i�rEuẍ)i�r0)i�rEuẏ)i�r0)i�rEuẑ)i�r0)i�rEuẓ)i�r0)i�rEuẕ)i�r0)i�rEuaʾ)i�rEr�)i�r0)i�rEr))i�r0)i�rEuạ)i�r0)i�rEuả)i�r0)i�rEuấ)i�r0)i�rEuầ)i�r0)i�rEuẩr�r�r�r�r��_seg_17�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r0)i�rEuẫ)i�r0)i�rEuậ)i�r0)i�rEuắ)i�r0)i�rEuằ)i�r0)i�rEuẳ)i�r0)i�rEuẵ)i�r0)i�rEuặ)i�r0)i�rEuẹ)i�r0)i�rEuẻ)i�r0)i�rEuẽ)i�r0)i�rEuế)i�r0)i�rEuề)i�r0)i�rEuể)i�r0)i�rEuễ)i�r0)i�rEuệ)i�r0)i�rEuỉ)i�r0)i�rEuị)i�r0)i�rEuọ)i�r0)i�rEuỏ)i�r0)i�rEuố)i�r0)i�rEuồ)i�r0)i�rEuổ)i�r0)i�rEuỗ)i�r0)i�rEuộ)i�r0)i�rEuớ)i�r0)i�rEuờ)i�r0)i�rEuở)i�r0)i�rEuỡ)i�r0)i�rEuợ)i�r0)i�rEuụ)i�r0)i�rEuủ)i�r0)i�rEuứ)i�r0)i�rEuừ)i�r0)i�rEuử)i�r0)i�rEuữ)i�r0)i�rEuự)i�r0)i�rEuỳ)i�r0)i�rEuỵ)i�r0)i�rEuỷ)i�r0)i�rEuỹ)i�r0)i�rEuỻ)i�r0)i�rEuỽ)i�r0)i�rEuỿ)i�r0)irEuἀ)i	rEuἁ)i
rEuἂ)irEuἃ)irEuἄ)i
rEuἅ)irEuἆ)irEuἇ)ir0)ir�)irEuἐ)irEuἑ)irEuἒr�r�r�r�r��_seg_18Xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)irEuἓ)irEuἔ)irEuἕ)ir�)i r0)i(rEuἠ)i)rEuἡ)i*rEuἢ)i+rEuἣ)i,rEuἤ)i-rEuἥ)i.rEuἦ)i/rEuἧ)i0r0)i8rEuἰ)i9rEuἱ)i:rEuἲ)i;rEuἳ)i<rEuἴ)i=rEuἵ)i>rEuἶ)i?rEuἷ)i@r0)iFr�)iHrEuὀ)iIrEuὁ)iJrEuὂ)iKrEuὃ)iLrEuὄ)iMrEuὅ)iNr�)iPr0)iXr�)iYrEuὑ)iZr�)i[rEuὓ)i\r�)i]rEuὕ)i^r�)i_rEuὗ)i`r0)ihrEuὠ)iirEuὡ)ijrEuὢ)ikrEuὣ)ilrEuὤ)imrEuὥ)inrEuὦ)iorEuὧ)ipr0)iqrErh)irr0)isrErj)itr0)iurErk)ivr0)iwrErl)ixr0)iyrErm)izr0)i{rErn)i|r0)i}rEro)i~r�)i�rE�ἀι)i�rE�ἁι)i�rE�ἂι)i�rE�ἃι)i�rE�ἄι)i�rE�ἅι)i�rE�ἆι)i�rE�ἇι)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ἠι)i�rE�ἡι)i�rE�ἢι)i�rE�ἣι)i�rE�ἤι)i�rE�ἥι)i�rE�ἦι)i�rE�ἧι)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ὠι)i�rE�ὡι)i�rE�ὢι)i�rE�ὣιr�r�r�r�r��_seg_19�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rE�ὤι)i�rE�ὥι)i�rE�ὦι)i�rE�ὧι)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�r0)i�rEuὰι)i�rE�αι)i�rEuάι)i�r�)i�r0)i�rEuᾶι)i�rEuᾰ)i�rEuᾱ)i�rEuὰ)i�rErh)i�rEr�)i�r� ̓)i�rErd)i�rr�)i�ru ͂)i�ru ̈͂)i�rEuὴι)i�rE�ηι)i�rEuήι)i�r�)i�r0)i�rEuῆι)i�rEuὲ)i�rErj)i�rEuὴ)i�rErk)i�rEr�)i�ru ̓̀)i�ru ̓́)i�ru ̓͂)i�r0)i�rEuΐ)i�r�)i�r0)i�rEuῐ)i�rEuῑ)i�rEuὶ)i�rErl)i�r�)i�ru ̔̀)i�ru ̔́)i�ru ̔͂)i�r0)i�rEuΰ)i�r0)i�rEuῠ)i�rEuῡ)i�rEuὺ)i�rErn)i�rEuῥ)i�ru ̈̀)i�rrg)i�r�`)i�r�)i�rEuὼι)i�rE�ωι)i�rEuώι)i�r�)i�r0)i�rEuῶι)i�rEuὸ)i�rErm)i�rEuὼ)i�rEro)i�rEr�)i�rr�)i�ru ̔)i�r�)i rr�)i r�)i r(�)i r�)i r0)i rEu‐)i r0)i ru ̳)i r0)i$ r�)i' r0)i( r�)i/ rr�)i0 r0)i3 rEu′′)i4 rEu	′′′)i5 r0)i6 rEu‵‵)i7 rEu	‵‵‵r�r�r�r�r��_seg_20(s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i8 r0)i< rz!!)i= r0)i> r� ̅)i? r0)iG rz??)iH rz?!)iI rz!?)iJ r0)iW rEu′′′′)iX r0)i_ rr�)i` r�)ia r�)id r�)ie r�)ip rE�0)iq rErV)ir r�)it rE�4)iu rE�5)iv rE�6)iw rE�7)ix rE�8)iy rE�9)iz r�+)i{ rE�−)i| r�=)i} r�()i~ r�))i rEr`)i� rEr�)i� rEr�)i� rEr�)i� rEr)i� rEr�)i� rEr�)i� rEr�)i� rEr�)i� rEr�)i� rEr�)i� rr�)i� rEr�)i� rr�)i� rr�)i� rr�)i� r�)i� rErF)i� rErN)i� rErb)i� rErt)i� rErR)i� rErT)i� rErZ)i� rEr\)i� rEr^)i� rEr`)i� rErd)i� rErj)i� rErl)i� r�)i� r0)i� rEZrs)i� r0)i� r�)i� r0)i� r�)i!rza/c)i!rza/s)i!rErJ)i!rEu°c)i!r0)i!rzc/o)i!rzc/u)i!rErS)i!r0)i	!rEu°f)i
!rErR)i!rErT)i!rErK)i!rErV)i!rEr\)i!r0)i!rEr`)i!rEZno)i!r0)i!rErd)i!rErf)i!rErh)i!r0)i !rEZsm)i!!rEZtel)i"!rEZtm)i#!r0)i$!rErx)i%!r0)i&!rEr�)i'!r0)i(!rErx)i)!r0r�r�r�r�r��_seg_21�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i*!rErZ)i+!rEr�)i,!rErH)i-!rErJ)i.!r0)i/!rErN)i1!rErP)i2!r�)i3!rEr^)i4!rErb)i5!rE�א)i6!rEuב)i7!rEuג)i8!rE�ד)i9!rErV)i:!r0)i;!rEZfax)i<!rEr})i=!rErr)i?!rEr})i@!rEu∑)iA!r0)iE!rErL)iG!rErN)iH!rErV)iI!rErX)iJ!r0)iP!rEu1⁄7)iQ!rEu1⁄9)iR!rEu1⁄10)iS!rEu1⁄3)iT!rEu2⁄3)iU!rEu1⁄5)iV!rEu2⁄5)iW!rEu3⁄5)iX!rEu4⁄5)iY!rEu1⁄6)iZ!rEu5⁄6)i[!rEu1⁄8)i\!rEu3⁄8)i]!rEu5⁄8)i^!rEu7⁄8)i_!rEu1⁄)i`!rErV)ia!rE�ii)ib!rE�iii)ic!rE�iv)id!rErp)ie!rE�vi)if!rE�vii)ig!rE�viii)ih!rE�ix)ii!rErt)ij!rE�xi)ik!rE�xii)il!rEr\)im!rErJ)in!rErL)io!rEr^)ip!rErV)iq!rEr�)ir!rEr�)is!rEr�)it!rErp)iu!rEr�)iv!rEr�)iw!rEr�)ix!rEr�)iy!rErt)iz!rEr�)i{!rEr�)i|!rEr\)i}!rErJ)i~!rErL)i!rEr^)i�!r0)i�!r�)i�!r0)i�!rEu0⁄3)i�!r0)i�!r�)i�!r0)i,"rEu∫∫)i-"rEu	∫∫∫)i."r0)i/"rEu∮∮)i0"rEu	∮∮∮)i1"r0)i`"r)ia"r0)in"r)ip"r0)i)#rE�〈)i*#rE�〉)i+#r0)i'$r�)i@$r0)iK$r�)i`$rEr�)ia$rEr�r�r�r�r�r��_seg_22�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ib$rEr)ic$rEr�)id$rEr�)ie$rEr�)if$rEr�)ig$rEr�)ih$rEr�)ii$rEZ10)ij$rEZ11)ik$rEZ12)il$rEZ13)im$rEZ14)in$rEZ15)io$rEZ16)ip$rEZ17)iq$rEZ18)ir$rEZ19)is$rEZ20)it$rz(1))iu$rz(2))iv$rz(3))iw$rz(4))ix$rz(5))iy$rz(6))iz$rz(7))i{$rz(8))i|$rz(9))i}$rz(10))i~$rz(11))i$rz(12))i�$rz(13))i�$rz(14))i�$rz(15))i�$rz(16))i�$rz(17))i�$rz(18))i�$rz(19))i�$rz(20))i�$r�)i�$r�(a))i�$r�(b))i�$r�(c))i�$r�(d))i�$r�(e))i�$r�(f))i�$r�(g))i�$r�(h))i�$r�(i))i�$r�(j))i�$r�(k))i�$r�(l))i�$r�(m))i�$r�(n))i�$r�(o))i�$r�(p))i�$r�(q))i�$r�(r))i�$r�(s))i�$r�(t))i�$r�(u))i�$r�(v))i�$r�(w))i�$r�(x))i�$r�(y))i�$r�(z))i�$rErF)i�$rErH)i�$rErJ)i�$rErL)i�$rErN)i�$rErP)i�$rErR)i�$rErT)i�$rErV)i�$rErX)i�$rErZ)i�$rEr\)i�$rEr^)i�$rEr`)i�$rErb)i�$rErd)i�$rErf)i�$rErh)i�$rErj)i�$rErl)i�$rErn)i�$rErp)i�$rErr)i�$rErt)i�$rErv)i�$rErx)i�$rErF)i�$rErH)i�$rErJ)i�$rErL)i�$rErN)i�$rErP)i�$rErR)i�$rErT)i�$rErVr�r�r�r�r��_seg_23`	s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�$rErX)i�$rErZ)i�$rEr\)i�$rEr^)i�$rEr`)i�$rErb)i�$rErd)i�$rErf)i�$rErh)i�$rErj)i�$rErl)i�$rErn)i�$rErp)i�$rErr)i�$rErt)i�$rErv)i�$rErx)i�$rEr�)i�$r0)i*rEu∫∫∫∫)i
*r0)it*rz::=)iu*rz==)iv*rz===)iw*r0)i�*rEu⫝̸)i�*r0)it+r�)iv+r0)i�+r�)i�+r0)i�+r�)i�+r0)i�+r�)i,rEuⰰ)i,rEuⰱ)i,rEuⰲ)i,rEuⰳ)i,rEuⰴ)i,rEuⰵ)i,rEuⰶ)i,rEuⰷ)i,rEuⰸ)i	,rEuⰹ)i
,rEuⰺ)i,rEuⰻ)i,rEuⰼ)i
,rEuⰽ)i,rEuⰾ)i,rEuⰿ)i,rEuⱀ)i,rEuⱁ)i,rEuⱂ)i,rEuⱃ)i,rEuⱄ)i,rEuⱅ)i,rEuⱆ)i,rEuⱇ)i,rEuⱈ)i,rEuⱉ)i,rEuⱊ)i,rEuⱋ)i,rEuⱌ)i,rEuⱍ)i,rEuⱎ)i,rEuⱏ)i ,rEuⱐ)i!,rEuⱑ)i",rEuⱒ)i#,rEuⱓ)i$,rEuⱔ)i%,rEuⱕ)i&,rEuⱖ)i',rEuⱗ)i(,rEuⱘ)i),rEuⱙ)i*,rEuⱚ)i+,rEuⱛ)i,,rEuⱜ)i-,rEuⱝ)i.,rEuⱞ)i/,r�)i0,r0)i_,r�)i`,rEuⱡ)ia,r0)ib,rE�ɫ)ic,rEuᵽ)id,rEuɽ)ie,r0)ig,rEuⱨ)ih,r0)ii,rEuⱪ)ij,r0)ik,rEuⱬ)il,r0)im,rEr�)in,rEr�)io,rEr�)ip,rEr�r�r�r�r�r��_seg_24�	s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iq,r0)ir,rEuⱳ)is,r0)iu,rEuⱶ)iv,r0)i|,rErX)i},rErp)i~,rEuȿ)i,rEuɀ)i�,rEuⲁ)i�,r0)i�,rEuⲃ)i�,r0)i�,rEuⲅ)i�,r0)i�,rEuⲇ)i�,r0)i�,rEuⲉ)i�,r0)i�,rEuⲋ)i�,r0)i�,rEuⲍ)i�,r0)i�,rEuⲏ)i�,r0)i�,rEuⲑ)i�,r0)i�,rEuⲓ)i�,r0)i�,rEuⲕ)i�,r0)i�,rEuⲗ)i�,r0)i�,rEuⲙ)i�,r0)i�,rEuⲛ)i�,r0)i�,rEuⲝ)i�,r0)i�,rEuⲟ)i�,r0)i�,rEuⲡ)i�,r0)i�,rEuⲣ)i�,r0)i�,rEuⲥ)i�,r0)i�,rEuⲧ)i�,r0)i�,rEuⲩ)i�,r0)i�,rEuⲫ)i�,r0)i�,rEuⲭ)i�,r0)i�,rEuⲯ)i�,r0)i�,rEuⲱ)i�,r0)i�,rEuⲳ)i�,r0)i�,rEuⲵ)i�,r0)i�,rEuⲷ)i�,r0)i�,rEuⲹ)i�,r0)i�,rEuⲻ)i�,r0)i�,rEuⲽ)i�,r0)i�,rEuⲿ)i�,r0)i�,rEuⳁ)i�,r0)i�,rEuⳃ)i�,r0)i�,rEuⳅ)i�,r0)i�,rEuⳇ)i�,r0)i�,rEuⳉ)i�,r0)i�,rEuⳋ)i�,r0)i�,rEuⳍ)i�,r0)i�,rEuⳏ)i�,r0)i�,rEuⳑ)i�,r0)i�,rEuⳓ)i�,r0)i�,rEuⳕ)i�,r0)i�,rEuⳗ)i�,r0)i�,rEuⳙ)i�,r0)i�,rEuⳛr�r�r�r�r��_seg_250
s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�,r0)i�,rEuⳝ)i�,r0)i�,rEuⳟ)i�,r0)i�,rEuⳡ)i�,r0)i�,rEuⳣ)i�,r0)i�,rEuⳬ)i�,r0)i�,rEuⳮ)i�,r0)i�,rEuⳳ)i�,r0)i�,r�)i�,r0)i&-r�)i'-r0)i(-r�)i--r0)i.-r�)i0-r0)ih-r�)io-rEuⵡ)ip-r0)iq-r�)i-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)iO.r�)i�.r0)i�.r�)i�.r0)i�.rEu母)i�.r0)i�.rEu龟)i�.r�)i/rE�一)i/rEu丨)i/rEu丶)i/rEu丿)i/rE�乙)i/rEu亅)i/rE�二)i/rEu亠)i/rE�人)i	/rEu儿)i
/rEu入)i/rE�八)i/rEu冂)i
/rEu冖)i/rEu冫)i/rEu几)i/rE�凵)i/rEu刀)i/rE�力)i/rEu勹)i/rEu匕)i/rEu匚)i/rEu匸)i/rE�十)i/rEu卜)i/rEu卩)i/rEu厂)i/rEu厶)i/rEu又)i/rEu口)i/rEu囗)i/rE�土)i /rEu士)i!/rEu夂)i"/rEu夊)i#/rEu夕)i$/rEu大)i%/rE�女)i&/rEu子)i'/rEu宀)i(/rEu寸)i)/rEu小)i*/rE�尢)i+/rEu尸)i,/rE�屮)i-/rEu山r�r�r�r�r��_seg_26�
s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i./rEu巛)i//rEu工)i0/rEu己)i1/rEu巾)i2/rEu干)i3/rEu幺)i4/rEu广)i5/rEu廴)i6/rE�廾)i7/rEu弋)i8/rEu弓)i9/rEu彐)i:/rEu彡)i;/rEu彳)i</rEu心)i=/rEu戈)i>/rEu戶)i?/rE�手)i@/rEu支)iA/rEu攴)iB/rE�文)iC/rEu斗)iD/rEu斤)iE/rEu方)iF/rEu无)iG/rE�日)iH/rEu曰)iI/rE�月)iJ/rE�木)iK/rEu欠)iL/rEu止)iM/rE�歹)iN/rEu殳)iO/rEu毋)iP/rEu比)iQ/rEu毛)iR/rEu氏)iS/rEu气)iT/rE�水)iU/rE�火)iV/rEu爪)iW/rEu父)iX/rEu爻)iY/rEu爿)iZ/rEu片)i[/rEu牙)i\/rEu牛)i]/rEu犬)i^/rEu玄)i_/rEu玉)i`/rEu瓜)ia/rEu瓦)ib/rEu甘)ic/rE�生)id/rEu用)ie/rEu田)if/rEu疋)ig/rEu疒)ih/rEu癶)ii/rEu白)ij/rEu皮)ik/rEu皿)il/rEu目)im/rEu矛)in/rEu矢)io/rEu石)ip/rEu示)iq/rEu禸)ir/rEu禾)is/rEu穴)it/rE�立)iu/rEu竹)iv/rEu米)iw/rEu糸)ix/rEu缶)iy/rEu网)iz/rEu羊)i{/rE�羽)i|/rE�老)i}/rEu而)i~/rEu耒)i/rEu耳)i�/rEu聿)i�/rEu肉)i�/rEu臣)i�/rEu自)i�/rEu至)i�/rEu臼)i�/rEu舌)i�/rEu舛)i�/rEu舟)i�/rEu艮)i�/rEu色)i�/rEu艸)i�/rEu虍)i�/rEu虫)i�/rEu血)i�/rE�行)i�/rE�衣)i�/rEu襾r�r�r�r�r��_seg_27s��r cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�/rE�見)i�/rEu角)i�/rEu言)i�/rEu谷)i�/rEu豆)i�/rE�豕)i�/rEu豸)i�/rEu貝)i�/rEu赤)i�/rE�走)i�/rEu足)i�/rEu身)i�/rE�車)i�/rEu辛)i�/rE�辰)i�/rEu辵)i�/rEu邑)i�/rEu酉)i�/rEu釆)i�/rE�里)i�/rE�金)i�/rEu長)i�/rEu門)i�/rEu阜)i�/rEu隶)i�/rEu隹)i�/rEu雨)i�/rEu靑)i�/rEu非)i�/rEu面)i�/rEu革)i�/rEu韋)i�/rEu韭)i�/rEu音)i�/rEu頁)i�/rEu風)i�/rEu飛)i�/rEu食)i�/rEu首)i�/rEu香)i�/rEu馬)i�/rEu骨)i�/rEu高)i�/rEu髟)i�/rEu鬥)i�/rEu鬯)i�/rEu鬲)i�/rEu鬼)i�/rEu魚)i�/rEu鳥)i�/rEu鹵)i�/rE�鹿)i�/rEu麥)i�/rE�麻)i�/rEu黃)i�/rEu黍)i�/rEu黑)i�/rE�黹)i�/rEu黽)i�/rEu鼎)i�/rEu鼓)i�/rEu鼠)i�/rE�鼻)i�/rEu齊)i�/rEu齒)i�/rE�龍)i�/rE�龜)i�/rEu龠)i�/r�)i0rr�)i0r0)i0rE�.)i0r0)i60rEu〒)i70r0)i80rEr)i90rEu卄)i:0rEu卅)i;0r0)i@0r�)iA0r0)i�0r�)i�0r0)i�0ru ゙)i�0ru ゚)i�0r0)i�0rEuより)i�0r0)i�0rEuコト)i1r�)i1r0)i01r�)i11rE�ᄀ)i21rE�ᄁ)i31rE�ᆪ)i41rE�ᄂ)i51rE�ᆬ)i61rE�ᆭ)i71rE�ᄃ)i81rE�ᄄr�r�r�r�r��_seg_28hs��r7cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i91rE�ᄅ)i:1rE�ᆰ)i;1rE�ᆱ)i<1rE�ᆲ)i=1rE�ᆳ)i>1rE�ᆴ)i?1rE�ᆵ)i@1rE�ᄚ)iA1rE�ᄆ)iB1rE�ᄇ)iC1rE�ᄈ)iD1rE�ᄡ)iE1rE�ᄉ)iF1rE�ᄊ)iG1rE�ᄋ)iH1rE�ᄌ)iI1rE�ᄍ)iJ1rE�ᄎ)iK1rE�ᄏ)iL1rE�ᄐ)iM1rE�ᄑ)iN1rE�ᄒ)iO1rE�ᅡ)iP1rE�ᅢ)iQ1rE�ᅣ)iR1rE�ᅤ)iS1rE�ᅥ)iT1rE�ᅦ)iU1rE�ᅧ)iV1rE�ᅨ)iW1rE�ᅩ)iX1rE�ᅪ)iY1rE�ᅫ)iZ1rE�ᅬ)i[1rE�ᅭ)i\1rE�ᅮ)i]1rE�ᅯ)i^1rE�ᅰ)i_1rE�ᅱ)i`1rE�ᅲ)ia1rE�ᅳ)ib1rE�ᅴ)ic1rE�ᅵ)id1r�)ie1rEuᄔ)if1rEuᄕ)ig1rEuᇇ)ih1rEuᇈ)ii1rEuᇌ)ij1rEuᇎ)ik1rEuᇓ)il1rEuᇗ)im1rEuᇙ)in1rEuᄜ)io1rEuᇝ)ip1rEuᇟ)iq1rEuᄝ)ir1rEuᄞ)is1rEuᄠ)it1rEuᄢ)iu1rEuᄣ)iv1rEuᄧ)iw1rEuᄩ)ix1rEuᄫ)iy1rEuᄬ)iz1rEuᄭ)i{1rEuᄮ)i|1rEuᄯ)i}1rEuᄲ)i~1rEuᄶ)i1rEuᅀ)i�1rEuᅇ)i�1rEuᅌ)i�1rEuᇱ)i�1rEuᇲ)i�1rEuᅗ)i�1rEuᅘ)i�1rEuᅙ)i�1rEuᆄ)i�1rEuᆅ)i�1rEuᆈ)i�1rEuᆑ)i�1rEuᆒ)i�1rEuᆔ)i�1rEuᆞ)i�1rEuᆡ)i�1r�)i�1r0)i�1rEr)i�1rEr)i�1rE�三)i�1rE�四)i�1rE�上)i�1rE�中)i�1rE�下)i�1rEu甲)i�1rEr)i�1rEu丙)i�1rEu丁)i�1rE�天r�r�r�r�r��_seg_29�s��ricdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�1rEu地)i�1rEr)i�1r0)i�1r�)i�1r0)i�1r�)i�1r0)i2ru(ᄀ))i2ru(ᄂ))i2ru(ᄃ))i2ru(ᄅ))i2ru(ᄆ))i2ru(ᄇ))i2ru(ᄉ))i2ru(ᄋ))i2ru(ᄌ))i	2ru(ᄎ))i
2ru(ᄏ))i2ru(ᄐ))i2ru(ᄑ))i
2ru(ᄒ))i2ru(가))i2ru(나))i2ru(다))i2ru(라))i2ru(마))i2ru(바))i2ru(사))i2ru(아))i2ru(자))i2ru(차))i2ru(카))i2ru(타))i2ru(파))i2ru(하))i2ru(주))i2ru(오전))i2ru(오후))i2r�)i 2ru(一))i!2ru(二))i"2ru(三))i#2ru(四))i$2ru(五))i%2ru(六))i&2ru(七))i'2ru(八))i(2ru(九))i)2ru(十))i*2ru(月))i+2ru(火))i,2ru(水))i-2ru(木))i.2ru(金))i/2ru(土))i02ru(日))i12ru(株))i22ru(有))i32ru(社))i42ru(名))i52ru(特))i62ru(財))i72ru(祝))i82ru(労))i92ru(代))i:2ru(呼))i;2ru(学))i<2ru(監))i=2ru(企))i>2ru(資))i?2ru(協))i@2ru(祭))iA2ru(休))iB2ru(自))iC2ru(至))iD2rEu問)iE2rEu幼)iF2rEr)iG2rEu箏)iH2r0)iP2rEZpte)iQ2rEZ21)iR2rEZ22)iS2rEZ23)iT2rEZ24)iU2rEZ25)iV2rEZ26)iW2rEZ27)iX2rEZ28)iY2rEZ29)iZ2rEZ30)i[2rEZ31)i\2rEZ32)i]2rEZ33)i^2rEZ34)i_2rEZ35)i`2rEr/)ia2rEr2)ib2rEr5)ic2rEr8r�r�r�r�r��_seg_308s��rjcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)id2rEr@)ie2rErA)if2rErD)ig2rErF)ih2rErG)ii2rErI)ij2rErJ)ik2rErK)il2rErL)im2rErM)in2rEu가)io2rEu나)ip2rEu다)iq2rEu라)ir2rEu마)is2rEu바)it2rEu사)iu2rEu아)iv2rEu자)iw2rEu차)ix2rEu카)iy2rEu타)iz2rEu파)i{2rEu하)i|2rEu참고)i}2rEu주의)i~2rEu우)i2r0)i�2rEr)i�2rEr)i�2rErc)i�2rErd)i�2rEu五)i�2rE�六)i�2rEu七)i�2rEr)i�2rEu九)i�2rEr)i�2rEr)i�2rEr)i�2rEr)i�2rEr)i�2rEr')i�2rEr)i�2rEr)i�2rEu株)i�2rE�有)i�2rE�社)i�2rEu名)i�2rEu特)i�2rEu財)i�2rE�祝)i�2rEu労)i�2rEu秘)i�2rEu男)i�2rEr
)i�2rEu適)i�2rEu優)i�2rEu印)i�2rEu注)i�2rEu項)i�2rEu休)i�2rEu写)i�2rEu正)i�2rEre)i�2rErf)i�2rErg)i�2rE�左)i�2rE�右)i�2rEu医)i�2rEu宗)i�2rEu学)i�2rEu監)i�2rEu企)i�2rEu資)i�2rEu協)i�2rEu夜)i�2rEZ36)i�2rEZ37)i�2rEZ38)i�2rEZ39)i�2rEZ40)i�2rEZ41)i�2rEZ42)i�2rEZ43)i�2rEZ44)i�2rEZ45)i�2rEZ46)i�2rEZ47)i�2rEZ48)i�2rEZ49)i�2rEZ50)i�2rEu1月)i�2rEu2月)i�2rEu3月)i�2rEu4月)i�2rEu5月)i�2rEu6月)i�2rEu7月)i�2rEu8月r�r�r�r�r��_seg_31�s��rqcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�2rEu9月)i�2rEu10月)i�2rEu11月)i�2rEu12月)i�2rEZhg)i�2rEZerg)i�2rEZev)i�2rEZltd)i�2rE�ア)i�2rE�イ)i�2rE�ウ)i�2rE�エ)i�2rE�オ)i�2rE�カ)i�2rE�キ)i�2rE�ク)i�2rE�ケ)i�2rE�コ)i�2rE�サ)i�2rE�シ)i�2rE�ス)i�2rE�セ)i�2rE�ソ)i�2rE�タ)i�2rE�チ)i�2rE�ツ)i�2rE�テ)i�2rE�ト)i�2rE�ナ)i�2rE�ニ)i�2rE�ヌ)i�2rE�ネ)i�2rE�ノ)i�2rE�ハ)i�2rE�ヒ)i�2rE�フ)i�2rE�ヘ)i�2rE�ホ)i�2rE�マ)i�2rE�ミ)i�2rE�ム)i�2rE�メ)i�2rE�モ)i�2rE�ヤ)i�2rE�ユ)i�2rE�ヨ)i�2rE�ラ)i�2rE�リ)i�2rE�ル)i�2rE�レ)i�2rE�ロ)i�2rE�ワ)i�2rEuヰ)i�2rEuヱ)i�2rE�ヲ)i�2r�)i3rEuアパート)i3rEuアルファ)i3rEuアンペア)i3rEu	アール)i3rEuイニング)i3rEu	インチ)i3rEu	ウォン)i3rEuエスクード)i3rEuエーカー)i	3rEu	オンス)i
3rEu	オーム)i3rEu	カイリ)i3rEuカラット)i
3rEuカロリー)i3rEu	ガロン)i3rEu	ガンマ)i3rEuギガ)i3rEu	ギニー)i3rEuキュリー)i3rEuギルダー)i3rEuキロ)i3rEuキログラム)i3rEuキロメートル)i3rEuキロワット)i3rEu	グラム)i3rEuグラムトン)i3rEuクルゼイロ)i3rEuクローネ)i3rEu	ケース)i3rEu	コルナ)i3rEu	コーポ)i3rEuサイクル)i 3rEuサンチーム)i!3rEuシリング)i"3rEu	センチ)i#3rEu	セント)i$3rEu	ダース)i%3rEuデシ)i&3rEuドル)i'3rEuトン)i(3rEuナノ)i)3rEu	ノット)i*3rEu	ハイツ)i+3rEuパーセントr�r�r�r�r��_seg_32
s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i,3rEu	パーツ)i-3rEuバーレル)i.3rEuピアストル)i/3rEu	ピクル)i03rEuピコ)i13rEuビル)i23rEuファラッド)i33rEuフィート)i43rEuブッシェル)i53rEu	フラン)i63rEuヘクタール)i73rEuペソ)i83rEu	ペニヒ)i93rEu	ヘルツ)i:3rEu	ペンス)i;3rEu	ページ)i<3rEu	ベータ)i=3rEuポイント)i>3rEu	ボルト)i?3rEuホン)i@3rEu	ポンド)iA3rEu	ホール)iB3rEu	ホーン)iC3rEuマイクロ)iD3rEu	マイル)iE3rEu	マッハ)iF3rEu	マルク)iG3rEuマンション)iH3rEuミクロン)iI3rEuミリ)iJ3rEuミリバール)iK3rEuメガ)iL3rEuメガトン)iM3rEuメートル)iN3rEu	ヤード)iO3rEu	ヤール)iP3rEu	ユアン)iQ3rEuリットル)iR3rEuリラ)iS3rEu	ルピー)iT3rEuルーブル)iU3rEuレム)iV3rEuレントゲン)iW3rEu	ワット)iX3rEu0点)iY3rEu1点)iZ3rEu2点)i[3rEu3点)i\3rEu4点)i]3rEu5点)i^3rEu6点)i_3rEu7点)i`3rEu8点)ia3rEu9点)ib3rEu10点)ic3rEu11点)id3rEu12点)ie3rEu13点)if3rEu14点)ig3rEu15点)ih3rEu16点)ii3rEu17点)ij3rEu18点)ik3rEu19点)il3rEu20点)im3rEu21点)in3rEu22点)io3rEu23点)ip3rEu24点)iq3rEZhpa)ir3rEZda)is3rEZau)it3rEZbar)iu3rEZov)iv3rEZpc)iw3rEZdm)ix3rEZdm2)iy3rEZdm3)iz3rEZiu)i{3rEu平成)i|3rEu昭和)i}3rEu大正)i~3rEu明治)i3rEu株式会社)i�3rE�pa)i�3rEZna)i�3rEuμa)i�3rEZma)i�3rEZka)i�3rEZkb)i�3rE�mb)i�3rEZgb)i�3rEZcal)i�3rEZkcal)i�3rEZpf)i�3rEZnf)i�3rEuμf)i�3rEuμg)i�3rEZmg)i�3rEZkgr�r�r�r�r��_seg_33p
s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�3rE�hz)i�3rEZkhz)i�3rEZmhz)i�3rEZghz)i�3rEZthz)i�3rEuμl)i�3rEZml)i�3rEZdl)i�3rEZkl)i�3rEZfm)i�3rEZnm)i�3rEuμm)i�3rEZmm)i�3rE�cm)i�3rE�km)i�3rEZmm2)i�3rEZcm2)i�3rEZm2)i�3rEZkm2)i�3rEZmm3)i�3rEZcm3)i�3rEZm3)i�3rEZkm3)i�3rEum∕s)i�3rEum∕s2)i�3rEr�)i�3rEZkpa)i�3rEZmpa)i�3rEZgpa)i�3rEZrad)i�3rEurad∕s)i�3rEurad∕s2)i�3rEZps)i�3rE�ns)i�3rEuμs)i�3rEZms)i�3rEZpv)i�3rEZnv)i�3rEuμv)i�3rE�mv)i�3rEZkv)i�3rEr�)i�3rEZpw)i�3rEZnw)i�3rEuμw)i�3rE�mw)i�3rE�kw)i�3rEr�)i�3rEukω)i�3rEumω)i�3r�)i�3rEZbq)i�3rEZcc)i�3rE�cd)i�3rEuc∕kg)i�3r�)i�3rEZdb)i�3rEZgy)i�3rEZha)i�3rEZhp)i�3rE�in)i�3rEZkk)i�3rEr�)i�3rEZkt)i�3rEZlm)i�3rEZln)i�3rE�log)i�3rEZlx)i�3rEr�)i�3rEZmil)i�3rEZmol)i�3rEZph)i�3r�)i�3rEZppm)i�3rEZpr)i�3rE�sr)i�3rEZsv)i�3rE�wb)i�3rEuv∕m)i�3rEua∕m)i�3rEu1日)i�3rEu2日)i�3rEu3日)i�3rEu4日)i�3rEu5日)i�3rEu6日)i�3rEu7日)i�3rEu8日)i�3rEu9日)i�3rEu10日)i�3rEu11日)i�3rEu12日)i�3rEu13日)i�3rEu14日)i�3rEu15日)i�3rEu16日)i�3rEu17日)i�3rEu18日)i�3rEu19日)i�3rEu20日r�r�r�r�r��_seg_34�
s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�3rEu21日)i�3rEu22日)i�3rEu23日)i�3rEu24日)i�3rEu25日)i�3rEu26日)i�3rEu27日)i�3rEu28日)i�3rEu29日)i�3rEu30日)i�3rEu31日)i�3rEZgal)i4r0)i�Mr�)i�Mr0)i�r�)i�r0)i��r�)i��r0)iǤr�)iФr0)i,�r�)i@�rEuꙁ)iA�r0)iB�rEuꙃ)iC�r0)iD�rEuꙅ)iE�r0)iF�rEuꙇ)iG�r0)iH�rEuꙉ)iI�r0)iJ�rEr�)iK�r0)iL�rEuꙍ)iM�r0)iN�rEuꙏ)iO�r0)iP�rEuꙑ)iQ�r0)iR�rEuꙓ)iS�r0)iT�rEuꙕ)iU�r0)iV�rEuꙗ)iW�r0)iX�rEuꙙ)iY�r0)iZ�rEuꙛ)i[�r0)i\�rEuꙝ)i]�r0)i^�rEuꙟ)i_�r0)i`�rEuꙡ)ia�r0)ib�rEuꙣ)ic�r0)id�rEuꙥ)ie�r0)if�rEuꙧ)ig�r0)ih�rEuꙩ)ii�r0)ij�rEuꙫ)ik�r0)il�rEuꙭ)im�r0)i��rEuꚁ)i��r0)i��rEuꚃ)i��r0)i��rEuꚅ)i��r0)i��rEuꚇ)i��r0)i��rEuꚉ)i��r0)i��rEuꚋ)i��r0)i��rEuꚍ)i��r0)i��rEuꚏ)i��r0)i��rEuꚑ)i��r0)i��rEuꚓ)i��r0)i��rEuꚕ)i��r0)i��rEuꚗ)i��r0)i��rEuꚙ)i��r0)i��rEuꚛ)i��r0)i��rEr�)i��rEr�)i��r0)i��r�r�r�r�r�r��_seg_35@s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r0)i"�rEuꜣ)i#�r0)i$�rEuꜥ)i%�r0)i&�rE�ꜧ)i'�r0)i(�rEuꜩ)i)�r0)i*�rEuꜫ)i+�r0)i,�rEuꜭ)i-�r0)i.�rEuꜯ)i/�r0)i2�rEuꜳ)i3�r0)i4�rEuꜵ)i5�r0)i6�rEuꜷ)i7�r0)i8�rEuꜹ)i9�r0)i:�rEuꜻ)i;�r0)i<�rEuꜽ)i=�r0)i>�rEuꜿ)i?�r0)i@�rEuꝁ)iA�r0)iB�rEuꝃ)iC�r0)iD�rEuꝅ)iE�r0)iF�rEuꝇ)iG�r0)iH�rEuꝉ)iI�r0)iJ�rEuꝋ)iK�r0)iL�rEuꝍ)iM�r0)iN�rEuꝏ)iO�r0)iP�rEuꝑ)iQ�r0)iR�rEuꝓ)iS�r0)iT�rEuꝕ)iU�r0)iV�rEuꝗ)iW�r0)iX�rEuꝙ)iY�r0)iZ�rEuꝛ)i[�r0)i\�rEuꝝ)i]�r0)i^�rEuꝟ)i_�r0)i`�rEuꝡ)ia�r0)ib�rEuꝣ)ic�r0)id�rEuꝥ)ie�r0)if�rEuꝧ)ig�r0)ih�rEuꝩ)ii�r0)ij�rEuꝫ)ik�r0)il�rEuꝭ)im�r0)in�rE�ꝯ)io�r0)ip�rEr�)iq�r0)iy�rEuꝺ)iz�r0)i{�rEuꝼ)i|�r0)i}�rEuᵹ)i~�rEuꝿ)i�r0)i��rEuꞁ)i��r0)i��rEuꞃ)i��r0)i��rEuꞅ)i��r0)i��rEuꞇ)i��r0)i��rEuꞌ)i��r0)i��rEr�)i��r0)i��rEuꞑ)i��r0r�r�r�r�r��_seg_36�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEuꞓ)i��r0)i��rEuꞗ)i��r0)i��rEuꞙ)i��r0)i��rEuꞛ)i��r0)i��rEuꞝ)i��r0)i��rEuꞟ)i��r0)i��rEuꞡ)i��r0)i��rEuꞣ)i��r0)i��rEuꞥ)i��r0)i��rEuꞧ)i��r0)i��rEuꞩ)i��r0)i��rErc)i��rEr�)i��rEr�)i��rEuɬ)i��rEr�)i��r0)i��rEuʞ)i��rEuʇ)i��rEr�)i��rEuꭓ)i��rEuꞵ)i��r0)i��rEuꞷ)i��r0)i��r�)i��r0)i��r�)i��r0)i��rErK)i��rErN)i��r0)i,�r�)i0�r0)i:�r�)i@�r0)ix�r�)i��r0)iƨr�)iΨr0)iڨr�)i�r0)iT�r�)i_�r0)i}�r�)i��r0)iΩr�)iϩr0)iکr�)iީr0)i��r�)i�r0)i7�r�)i@�r0)iN�r�)iP�r0)iZ�r�)i\�r0)iêr�)i۪r0)i��r�)i�r0)i�r�)i	�r0)i�r�)i�r0)i�r�)i �r0)i'�r�)i(�r0)i/�r�)i0�r0)i\�rEr�)i]�rEuꬷ)i^�rEr)i_�rEuꭒ)i`�r0)if�r�)ip�rEuᎠ)iq�rEuᎡ)ir�rEuᎢ)is�rEuᎣ)it�rEuᎤ)iu�rEuᎥ)iv�rEuᎦ)iw�rEuᎧ)ix�rEuᎨ)iy�rEuᎩ)iz�rEuᎪr�r�r�r�r��_seg_37s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i{�rEuᎫ)i|�rEuᎬ)i}�rEuᎭ)i~�rEuᎮ)i�rEuᎯ)i��rEuᎰ)i��rEuᎱ)i��rEuᎲ)i��rEuᎳ)i��rEuᎴ)i��rEuᎵ)i��rEuᎶ)i��rEuᎷ)i��rEuᎸ)i��rEuᎹ)i��rEuᎺ)i��rEuᎻ)i��rEuᎼ)i��rEuᎽ)i��rEuᎾ)i��rEuᎿ)i��rEuᏀ)i��rEuᏁ)i��rEuᏂ)i��rEuᏃ)i��rEuᏄ)i��rEuᏅ)i��rEuᏆ)i��rEuᏇ)i��rEuᏈ)i��rEuᏉ)i��rEuᏊ)i��rEuᏋ)i��rEuᏌ)i��rEuᏍ)i��rEuᏎ)i��rEuᏏ)i��rEuᏐ)i��rEuᏑ)i��rEuᏒ)i��rEuᏓ)i��rEuᏔ)i��rEuᏕ)i��rEuᏖ)i��rEuᏗ)i��rEuᏘ)i��rEuᏙ)i��rEuᏚ)i��rEuᏛ)i��rEuᏜ)i��rEuᏝ)i��rEuᏞ)i��rEuᏟ)i��rEuᏠ)i��rEuᏡ)i��rEuᏢ)i��rEuᏣ)i��rEuᏤ)i��rEuᏥ)i��rEuᏦ)i��rEuᏧ)i��rEuᏨ)i��rEuᏩ)i��rEuᏪ)i��rEuᏫ)i��rEuᏬ)i��rEuᏭ)i��rEuᏮ)i��rEuᏯ)i��r0)i�r�)i�r0)i��r�)i�r0)i��r�)i��r0)i��r�)i��r0)i��r�)i�rEu豈)i�rEu更)i�rEr$)i�rEu賈)i�rEu滑)i�rEu串)i�rEu句)i�rEr-)i	�rEu契)i
�rEr')i�rEu喇)i�rEu奈)i
�rE�懶)i�rEu癩)i�rEu羅)i�rEu蘿)i�rEu螺)i�rEu裸)i�rEu邏)i�rE�樂)i�rEu洛r�r�r�r�r��_seg_38xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu烙)i�rEu珞)i�rEu落)i�rEu酪)i�rEu駱)i�rEu亂)i�rEu卵)i�rEu欄)i�rEu爛)i�rEu蘭)i �rEu鸞)i!�rEu嵐)i"�rEu濫)i#�rEu藍)i$�rEu襤)i%�rEu拉)i&�rEu臘)i'�rEu蠟)i(�rE�廊)i)�rE�朗)i*�rEu浪)i+�rEu狼)i,�rEu郎)i-�rEu來)i.�rEu冷)i/�rEu勞)i0�rEu擄)i1�rEu櫓)i2�rEu爐)i3�rEu盧)i4�rEr)i5�rEu蘆)i6�rE�虜)i7�rEu路)i8�rEu露)i9�rEu魯)i:�rEu鷺)i;�rE�碌)i<�rEu祿)i=�rEu綠)i>�rEu菉)i?�rEu錄)i@�rEr()iA�rEu論)iB�rEu壟)iC�rEu弄)iD�rEu籠)iE�rEu聾)iF�rEu牢)iG�rEu磊)iH�rEu賂)iI�rEu雷)iJ�rEu壘)iK�rEu屢)iL�rEu樓)iM�rEu淚)iN�rEu漏)iO�rEu累)iP�rEu縷)iQ�rEu陋)iR�rEu勒)iS�rEu肋)iT�rEu凜)iU�rEu凌)iV�rEu稜)iW�rEu綾)iX�rEu菱)iY�rEu陵)iZ�rEu讀)i[�rEu拏)i\�rEr�)i]�rE�諾)i^�rEu丹)i_�rE�寧)i`�rEu怒)ia�rE�率)ib�rE�異)ic�rE�北)id�rEu磻)ie�rEu便)if�rEu復)ig�rEu不)ih�rEu泌)ii�rEu數)ij�rEu索)ik�rEu參)il�rEu塞)im�rEu省)in�rEu葉)io�rE�說)ip�rE�殺)iq�rEr%)ir�rEu沈)is�rEu拾)it�rE�若)iu�rEu掠)iv�rEu略)iw�rEu亮)ix�rEu兩)iy�rEu凉r�r�r�r�r��_seg_39�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iz�rEu梁)i{�rEu糧)i|�rEu良)i}�rEu諒)i~�rEu量)i�rEu勵)i��rEu呂)i��rEr
)i��rEu廬)i��rEu旅)i��rEu濾)i��rEu礪)i��rEu閭)i��rEu驪)i��rEu麗)i��rEu黎)i��rEr
)i��rEu曆)i��rEu歷)i��rEu轢)i��rEu年)i��rEu憐)i��rEu戀)i��rEu撚)i��rEu漣)i��rEu煉)i��rEu璉)i��rEu秊)i��rE�練)i��rEu聯)i��rEu輦)i��rEu蓮)i��rEu連)i��rEu鍊)i��rEu列)i��rEu劣)i��rEu咽)i��rEu烈)i��rEu裂)i��rEr�)i��rEu廉)i��rEu念)i��rEu捻)i��rEu殮)i��rEu簾)i��rEu獵)i��rEu令)i��rEu囹)i��rEr�)i��rEu嶺)i��rEu怜)i��rEu玲)i��rEu瑩)i��rEu羚)i��rEu聆)i��rEu鈴)i��rEu零)i��rEu靈)i��rEu領)i��rEu例)i��rEu禮)i��rEu醴)i��rEu隸)i��rEu惡)i��rEu了)i��rEu僚)i��rEu寮)i��rEu尿)i��rE�料)i��rEr�)i��rEu燎)i��rEu療)i�rEu蓼)i�rEu遼)i�rEr,)i�rEu暈)i�rEu阮)i�rEu劉)i�rEu杻)i�rEu柳)i�rE�流)i�rEu溜)i�rEu琉)i�rEu留)i�rEu硫)i�rEu紐)i�rEu類)i�rErk)i�rEu戮)i�rEu陸)i�rEu倫)i�rEu崙)i�rEu淪)i�rEu輪)i�rEu律)i�rEu慄)i�rEu栗)i�rEr�)i�rEu隆)i�rEu利r�r�r�r�r��_seg_40Hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu吏)i�rEu履)i�rEu易)i�rEu李)i�rEu梨)i�rEu泥)i�rEu理)i�rEu痢)i�rEu罹)i�rEu裏)i�rEu裡)i�rEr&)i�rEu離)i�rEu匿)i�rEu溺)i�rEu吝)i�rEu燐)i�rEu璘)i�rEu藺)i�rEu隣)i�rEu鱗)i�rEu麟)i�rEu林)i��rEu淋)i��rEu臨)i��rEr)i��rEu笠)i��rEu粒)i��rEu狀)i��rEu炙)i��rEu識)i��rEu什)i��rEu茶)i��rEu刺)i�rE�切)i�rEu度)i�rEu拓)i�rEu糖)i�rEu宅)i�rEu洞)i�rEu暴)i�rEu輻)i�rEr)i	�rEu降)i
�rEr!)i�rEu廓)i�rEu兀)i
�rEu嗀)i�r0)i�rE�塚)i�r0)i�rE�晴)i�r0)i�rEu凞)i�rE�猪)i�rE�益)i�rEu礼)i�rEu神)i�rEu祥)i�rE�福)i�rE�靖)i�rEu精)i�rEr)i�r0)i �rEu蘒)i!�r0)i"�rE�諸)i#�r0)i%�rE�逸)i&�rEu都)i'�r0)i*�rEu飯)i+�rEu飼)i,�rEu館)i-�rEu鶴)i.�rEu郞)i/�rEu隷)i0�rE�侮)i1�rE�僧)i2�rE�免)i3�rE�勉)i4�rE�勤)i5�rE�卑)i6�rE�喝)i7�rE�嘆)i8�rEu器)i9�rEu塀)i:�rEu墨)i;�rEu層)i<�rEr)i=�rE�悔)i>�rEu慨)i?�rE�憎)i@�rE�懲)iA�rE�敏)iB�rEu既)iC�rE�暑)iD�rE�梅)iE�rE�海)iF�rEu渚r�r�r�r�r��_seg_41�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iG�rE�漢)iH�rE�煮)iI�rEu爫)iJ�rEu琢)iK�rEu碑)iL�rErm)iM�rEu祉)iN�rEu祈)iO�rEu祐)iP�rE�祖)iQ�rErn)iR�rEu禍)iS�rEu禎)iT�rE�穀)iU�rEu突)iV�rE�節)iW�rEr�)iX�rEu縉)iY�rEu繁)iZ�rEu署)i[�rE�者)i\�rEu臭)i]�rEu艹)i_�rE�著)i`�rEu褐)ia�rE�視)ib�rE�謁)ic�rE�謹)id�rEu賓)ie�rE�贈)if�rEu辶)ig�rEr�)ih�rE�難)ii�rE�響)ij�rE�頻)ik�rEu恵)il�rEu𤋮)im�rEu舘)in�r�)ip�rEu並)iq�rE�况)ir�rEu全)is�rEu侀)it�rEu充)iu�rEu冀)iv�rE�勇)iw�rE�勺)ix�rEr�)iy�rEu啕)iz�rE�喙)i{�rEu嗢)i|�rEr�)i}�rEu墳)i~�rEu奄)i�rEu奔)i��rEu婢)i��rEu嬨)i��rEu廒)i��rEu廙)i��rEu彩)i��rEu徭)i��rEu惘)i��rE�慎)i��rEu愈)i��rEr�)i��rEu慠)i��rEr�)i��rEu戴)i��rEu揄)i��rEu搜)i��rEu摒)i��rEu敖)i��rEr�)i��rEr�)i��rE�望)i��rEu杖)i��rEr)i��rEr�)i��rEr�)i��rEu滛)i��rE�滋)i��rEr�)i��rE�瀞)i��rEr�)i��rEu瞧)i��rE�爵)i��rEu犯)i��rEr�)i��rE�瑱)i��rEu甆)i��rEu画)i��rEu瘝)i��rEu瘟)i��rEr�)i��rEu盛)i��rE�直)i��rE�睊)i��rEu着)i��rE�磌)i��rEu窱r�r�r�r�r��_seg_42s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEu类)i��rEu絛)i��rEr�)i��rEu缾)i��rEr�)i��rEu荒)i��rEu華)i��rE�蝹)i��rEu襁)i��rEu覆)i��rEr�)i��rEu調)i��rEr�)i��rEu請)i��rEr�)i��rEr�)i��rE�諭)i��rEr�)i��rE�變)i��rEr�)i�rE�輸)i�rEu遲)i�rEu醙)i�rEu鉶)i�rEu陼)i�rEr�)i�rEr�)i�rEu韛)i�rEr�)i�rE�頋)i�rEr�)i�rE�鬒)i�rEr-)i�rEu𢡊)i�rEu𢡄)i�rEu𣏕)i�rE�㮝)i�rEu䀘)i�rE�䀹)i�rEu𥉉)i�rEu𥳐)i�rEu𧻓)i�rEu齃)i�rEu龎)i�r�)i�rEZff)i�rEZfi)i�rEZfl)i�rEZffi)i�rEZffl)i�rE�st)i�r�)i�rEuմն)i�rEuմե)i�rEuմի)i�rEuվն)i�rEuմխ)i�r�)i�rEuיִ)i�r0)i�rEuײַ)i �rEuע)i!�rEr�)i"�rEr�)i#�rEuה)i$�rEuכ)i%�rEuל)i&�rEuם)i'�rEuר)i(�rEuת)i)�rr�)i*�rEuשׁ)i+�rEuשׂ)i,�rEuשּׁ)i-�rEuשּׂ)i.�rEuאַ)i/�rEuאָ)i0�rEuאּ)i1�rEuבּ)i2�rEuגּ)i3�rEuדּ)i4�rEuהּ)i5�rEuוּ)i6�rEuזּ)i7�r�)i8�rEuטּ)i9�rEuיּ)i:�rEuךּ)i;�rEuכּ)i<�rEuלּ)i=�r�)i>�rEuמּ)i?�r�)i@�rEuנּ)iA�rEuסּ)iB�r�)iC�rEuףּ)iD�rEuפּ)iE�r�r�r�r�r�r��_seg_43�s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iF�rEuצּ)iG�rEuקּ)iH�rEuרּ)iI�rEuשּ)iJ�rEuתּ)iK�rEuוֹ)iL�rEuבֿ)iM�rEuכֿ)iN�rEuפֿ)iO�rEuאל)iP�rEuٱ)iR�rEuٻ)iV�rEuپ)iZ�rEuڀ)i^�rEuٺ)ib�rEuٿ)if�rEuٹ)ij�rEuڤ)in�rEuڦ)ir�rEuڄ)iv�rEuڃ)iz�rEuچ)i~�rEuڇ)i��rEuڍ)i��rEuڌ)i��rEuڎ)i��rEuڈ)i��rEuژ)i��rEuڑ)i��rEuک)i��rEuگ)i��rEuڳ)i��rEuڱ)i��rE�ں)i��rEuڻ)i��rEuۀ)i��rEuہ)i��rEuھ)i��rEuے)i��rEuۓ)i��r0)i�r�)i�rEuڭ)i�rEuۇ)i�rEuۆ)i�rEuۈ)i�rEr�)i�rEuۋ)i�rEuۅ)i�rEuۉ)i�rEuې)i�rE�ى)i�rEuئا)i�rEuئە)i�rEuئو)i�rEuئۇ)i�rEuئۆ)i�rEuئۈ)i��rEuئې)i��rE�ئى)i��rEuی)i�rE�ئج)i�rE�ئح)i�rE�ئم)i�rEr
)i�rE�ئي)i�rE�بج)i�rE�بح)i�rE�بخ)i�rE�بم)i	�rE�بى)i
�rE�بي)i�rE�تج)i�rE�تح)i
�rE�تخ)i�rE�تم)i�rE�تى)i�rE�تي)i�rEuثج)i�rE�ثم)i�rE�ثى)i�rE�ثي)i�rE�جح)i�rE�جم)i�rE�حج)i�rE�حم)i�rE�خج)i�rEuخح)i�rE�خم)i�rE�سج)i�rE�سح)i�rE�سخ)i�rE�سم)i �rE�صح)i!�rE�صم)i"�rE�ضج)i#�rE�ضح)i$�rE�ضخ)i%�rE�ضم)i&�rE�طحr�r�r�r�r��_seg_44�s��r/cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i'�rE�طم)i(�rE�ظم)i)�rE�عج)i*�rE�عم)i+�rE�غج)i,�rE�غم)i-�rE�فج)i.�rE�فح)i/�rE�فخ)i0�rE�فم)i1�rE�فى)i2�rE�في)i3�rE�قح)i4�rE�قم)i5�rE�قى)i6�rE�قي)i7�rE�كا)i8�rE�كج)i9�rE�كح)i:�rE�كخ)i;�rE�كل)i<�rE�كم)i=�rE�كى)i>�rE�كي)i?�rE�لج)i@�rE�لح)iA�rE�لخ)iB�rE�لم)iC�rE�لى)iD�rE�لي)iE�rE�مج)iF�rE�مح)iG�rE�مخ)iH�rE�مم)iI�rEuمى)iJ�rEuمي)iK�rE�نج)iL�rE�نح)iM�rE�نخ)iN�rE�نم)iO�rE�نى)iP�rE�ني)iQ�rE�هج)iR�rE�هم)iS�rEuهى)iT�rEuهي)iU�rE�يج)iV�rE�يح)iW�rE�يخ)iX�rE�يم)iY�rE�يى)iZ�rE�يي)i[�rEuذٰ)i\�rEuرٰ)i]�rE�ىٰ)i^�ru ٌّ)i_�ru ٍّ)i`�ru َّ)ia�ru ُّ)ib�ru ِّ)ic�ru ّٰ)id�rEuئر)ie�rEuئز)if�rEr
)ig�rEuئن)ih�rEr
)ii�rEr)ij�rEuبر)ik�rEuبز)il�rEr)im�rEuبن)in�rEr)io�rEr)ip�rEuتر)iq�rEuتز)ir�rEr)is�rEuتن)it�rEr)iu�rEr)iv�rEuثر)iw�rEuثز)ix�rEr)iy�rEuثن)iz�rEr)i{�rEr)i|�rEr:)i}�rEr;)i~�rEr>)i�rEr?)i��rEr@)i��rErD)i��rErE)i��rErF)i��rErG)i��rErK)i��rErL)i��rErM)i��rEuما)i��rErQ)i��rEuنرr�r�r�r�r��_seg_45Ps��racdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEuنز)i��rErU)i��rEuنن)i��rErV)i��rErW)i��rEr`)i��rEuير)i��rEuيز)i��rEr])i��rEuين)i��rEr^)i��rEr_)i��rEr)i��rEr)i��rEuئخ)i��rEr
)i��rE�ئه)i��rEr)i��rEr)i��rEr)i��rEr)i��rE�به)i��rEr)i��rEr)i��rEr)i��rEr)i��rE�ته)i��rEr)i��rEr)i��rEr)i��rEr )i��rEr!)i��rEr")i��rEr#)i��rEr$)i��rEr%)i��rEr&)i��rEr')i��rEr()i��rEuصخ)i��rEr))i��rEr*)i��rEr+)i��rEr,)i��rEr-)i��rEr.)i��rEr1)i��rEr2)i��rEr3)i��rEr4)i��rEr5)i��rEr6)i��rEr7)i��rEr8)i��rEr9)i�rEr<)i�rEr=)i�rErA)i�rErB)i�rErC)i�rErD)i�rErE)i�rErH)i�rErI)i�rErJ)i�rErK)i�rEuله)i�rErN)i�rErO)i�rErP)i�rErQ)i�rErR)i�rErS)i�rErT)i�rErU)i�rE�نه)i�rErX)i�rErY)i�rEuهٰ)i�rErZ)i�rEr[)i�rEr\)i�rEr])i�rE�يه)i�rEr
)i�rErb)i�rEr)i�rErc)i�rEr)i�rErd)i�rEr)i�rEuثه)i�rEr')i�rE�سه)i�rE�شم)i�rE�شه)i�rErD)i�rErE)i�rErK)i�rErUr�r�r�r�r��_seg_46�s��rjcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEre)i�rEr])i�rErf)i�rEuـَّ)i�rEuـُّ)i�rEuـِّ)i��rE�طى)i��rE�طي)i��rE�عى)i��rE�عي)i��rE�غى)i��rE�غي)i��rE�سى)i��rE�سي)i��rE�شى)i��rE�شي)i��rE�حى)i�rE�حي)i�rE�جى)i�rE�جي)i�rE�خى)i�rE�خي)i�rE�صى)i�rE�صي)i�rE�ضى)i�rE�ضي)i	�rE�شج)i
�rE�شح)i�rE�شخ)i�rErh)i
�rE�شر)i�rE�سر)i�rE�صر)i�rE�ضر)i�rErk)i�rErl)i�rErm)i�rErn)i�rEro)i�rErp)i�rErq)i�rErr)i�rErs)i�rErt)i�rEru)i�rErv)i�rErw)i�rErx)i�rEry)i �rErz)i!�rEr{)i"�rEr|)i#�rEr})i$�rEr~)i%�rEr)i&�rEr�)i'�rEr�)i(�rErh)i)�rEr�)i*�rEr�)i+�rEr�)i,�rEr�)i-�rEr)i.�rEr�)i/�rEr�)i0�rErh)i1�rErg)i2�rEri)i3�rEr0)i4�rEr$)i5�rEr%)i6�rEr&)i7�rEr)i8�rEr�)i9�rEr�)i:�rEr0)i;�rEr1)i<�rEuاً)i>�r0)i@�r�)iP�rEuتجم)iQ�rEuتحج)iS�rEuتحم)iT�rEuتخم)iU�rEuتمج)iV�rEuتمح)iW�rEuتمخ)iX�rEuجمح)iZ�rEuحمي)i[�rEuحمى)i\�rEuسحج)i]�rEuسجح)i^�rEuسجى)i_�rEuسمح)ia�rEuسمج)ib�rEuسمم)id�rEuصحح)if�rE�صمم)ig�rEuشحم)ii�rEuشجيr�r�r�r�r��_seg_47 s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ij�rEuشمخ)il�rEuشمم)in�rEuضحى)io�rEuضخم)iq�rEuطمح)is�rEuطمم)it�rEuطمي)iu�rE�عجم)iv�rEuعمم)ix�rEuعمى)iy�rEuغمم)iz�rEuغمي)i{�rEuغمى)i|�rEuفخم)i~�rE�قمح)i�rEuقمم)i��rE�لحم)i��rEuلحي)i��rEuلحى)i��rEuلجج)i��rEuلخم)i��rEuلمح)i��rEuمحج)i��rEuمحم)i��rEuمحي)i��rEuمجح)i��rEuمجم)i��rEuمخج)i��rEuمخم)i��r�)i��rEuمجخ)i��rEuهمج)i��rEuهمم)i��rEuنحم)i��rEuنحى)i��rEuنجم)i��rEuنجى)i��rEuنمي)i��rEuنمى)i��rEuيمم)i��rEuبخي)i��rEuتجي)i��rEuتجى)i��rEuتخي)i��rEuتخى)i��rEuتمي)i��rEuتمى)i��rEuجمي)i��rEuجحى)i��rEuجمى)i��rEuسخى)i��rEuصحي)i��rEuشحي)i��rEuضحي)i��rEuلجي)i��rEuلمي)i��rEuيحي)i��rEuيجي)i��rEuيمي)i��rEuممي)i��rEuقمي)i��rEuنحي)i��rEr�)i��rEr�)i��rEuعمي)i��rEuكمي)i��rE�نجح)i��rEuمخي)i��rE�لجم)i��rE�كمم)i��rEr�)i��rEr�)i��rEuجحي)i��rEuحجي)i��rEuمجي)i��rEuفمي)i�rEuبحي)i�rEr�)i�rEr�)i�rEr�)i�rEuسخي)i�rEuنجي)i�r�)i�rEuصلے)i�rEuقلے)i�rEuالله)i�rEuاكبر)i�rEuمحمد)i��rEuصلعم)i��rEuرسول)i��rEuعليه)i��rEuوسلم)i��rEuصلى)i��ru!صلى الله عليه وسلم)i��ruجل جلاله)i��rEuریال)i��r0)i��r�)i�r�)i�r�,r�r�r�r�r��_seg_48�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rE�、)i�r�)i�r�:)i�rrf)i�r�!)i�r�?)i�rEu〖)i�rEu〗)i�r�)i �r0)i0�r�)i1�rE�—)i2�rEu–)i3�r�_)i5�rr�)i6�rr�)i7�r�{)i8�r�})i9�rE�〔)i:�rE�〕)i;�rEu【)i<�rEu】)i=�rEu《)i>�rEu》)i?�rEr�)i@�rEr�)iA�rE�「)iB�rE�」)iC�rEu『)iD�rEu』)iE�r0)iG�r�[)iH�r�])iI�rr�)iM�rr�)iP�rr�)iQ�rEr�)iR�r�)iT�rrf)iU�rr�)iV�rr�)iW�rr�)iX�rEr�)iY�rr�)iZ�rr�)i[�rr�)i\�rr�)i]�rEr�)i^�rEr�)i_�r�#)i`�r�&)ia�r�*)ib�rr�)ic�rE�-)id�r�<)ie�r�>)if�rr�)ig�r�)ih�r�\)ii�r�$)ij�r�%)ik�r�@)il�r�)ip�ru ً)iq�rEuـً)ir�ru ٌ)is�r0)it�ru ٍ)iu�r�)iv�ru َ)iw�rEuـَ)ix�ru ُ)iy�rEuـُ)iz�ru ِ)i{�rEuـِ)i|�ru ّ)i}�rEuـّ)i~�ru ْ)i�rEuـْ)i��rEuء)i��rEuآ)i��rEuأ)i��rEuؤ)i��rEuإ)i��rEuئ)i��rE�ا)i��rE�ب)i��rEuة)i��rE�ت)i��rE�ث)i��rE�ج)i��rE�ح)i��rE�خ)i��rE�د)i��rE�ذ)i��rE�ر)i��rE�ز)i��rE�س)i��rE�ش)i��rE�صr�r�r�r�r��_seg_49�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rE�ض)i��rE�ط)i�rE�ظ)i�rE�ع)i�rE�غ)i�rE�ف)i�rE�ق)i�rE�ك)i�rE�ل)i�rE�م)i�rE�ن)i�rE�ه)i�rE�و)i�rEr	)i�rE�ي)i��rEuلآ)i��rEuلأ)i��rEuلإ)i��rEuلا)i��r�)i��r�)i�r�)i�rr�)i�r�")i�rr�)i�rr�)i�rr�)i�rr�)i�r�')i�rr�)i	�rr�)i
�rr�)i�rr�)i�rr�)i
�rEr�)i�rEr.)i�r�/)i�rEr�)i�rEr�)i�rEr�)i�rEr)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rr�)i�rrf)i�rr�)i�rr�)i�rr�)i�rr�)i �rr�)i!�rErF)i"�rErH)i#�rErJ)i$�rErL)i%�rErN)i&�rErP)i'�rErR)i(�rErT)i)�rErV)i*�rErX)i+�rErZ)i,�rEr\)i-�rEr^)i.�rEr`)i/�rErb)i0�rErd)i1�rErf)i2�rErh)i3�rErj)i4�rErl)i5�rErn)i6�rErp)i7�rErr)i8�rErt)i9�rErv)i:�rErx)i;�rr�)i<�rr�)i=�rr�)i>�r�^)i?�rr�)i@�rr�)iA�rErF)iB�rErH)iC�rErJ)iD�rErL)iE�rErN)iF�rErP)iG�rErR)iH�rErT)iI�rErV)iJ�rErX)iK�rErZ)iL�rEr\)iM�rEr^)iN�rEr`r�r�r�r�r��_seg_50Xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iO�rErb)iP�rErd)iQ�rErf)iR�rErh)iS�rErj)iT�rErl)iU�rErn)iV�rErp)iW�rErr)iX�rErt)iY�rErv)iZ�rErx)i[�rr�)i\�r�|)i]�rr�)i^�r�~)i_�rEu⦅)i`�rEu⦆)ia�rEr.)ib�rEr�)ic�rEr�)id�rEr�)ie�rEu・)if�rEr�)ig�rEuァ)ih�rEuィ)ii�rEuゥ)ij�rEuェ)ik�rEuォ)il�rEuャ)im�rEuュ)in�rEuョ)io�rEuッ)ip�rEuー)iq�rErr)ir�rErs)is�rErt)it�rEru)iu�rErv)iv�rErw)iw�rErx)ix�rEry)iy�rErz)iz�rEr{)i{�rEr|)i|�rEr})i}�rEr~)i~�rEr)i�rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEuン)i��rEu゙)i��rEu゚)i��r�)i��rEr/)i��rEr0)i��rEr1)i��rEr2)i��rEr3)i��rEr4)i��rEr5)i��rEr6)i��rEr8)i��rEr9)i��rEr:)i��rEr;)i��rEr<)i��rEr=)i��rEr>)i��rEr?)i��rEr@)i��rErAr�r�r�r�r��_seg_51�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rErB)i��rErC)i��rErD)i��rErE)i��rErF)i��rErG)i��rErH)i��rErI)i��rErJ)i��rErK)i��rErL)i��rErM)i��r�)i�rErN)i�rErO)i�rErP)i�rErQ)i�rErR)i�rErS)i�r�)i�rErT)i�rErU)i�rErV)i�rErW)i�rErX)i�rErY)i�r�)i�rErZ)i�rEr[)i�rEr\)i�rEr])i�rEr^)i�rEr_)i�r�)i�rEr`)i�rEra)i�rErb)i�r�)i�rE�¢)i�rE�£)i�rE�¬)i�rr�)i�rE�¦)i�rE�¥)i�rEu₩)i�r�)i�rEu│)i�rEu←)i�rEu↑)i�rEu→)i�rEu↓)i�rEu■)i�rEu○)i�r�)ir0)ir�)i
r0)i'r�)i(r0)i;r�)i<r0)i>r�)i?r0)iNr�)iPr0)i^r�)i�r0)i�r�)ir0)ir�)ir0)i4r�)i7r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i$r�)i-r0)iKr�)iPr0)i{r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)irEu𐐨)irEu𐐩r�r�r�r�r��_seg_52(s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)irEu𐐪)irEu𐐫)irEu𐐬)irEu𐐭)irEu𐐮)irEu𐐯)irEu𐐰)i	rEu𐐱)i
rEu𐐲)irEu𐐳)irEu𐐴)i
rEu𐐵)irEu𐐶)irEu𐐷)irEu𐐸)irEu𐐹)irEu𐐺)irEu𐐻)irEu𐐼)irEu𐐽)irEu𐐾)irEu𐐿)irEu𐑀)irEu𐑁)irEu𐑂)irEu𐑃)irEu𐑄)irEu𐑅)irEu𐑆)irEu𐑇)i rEu𐑈)i!rEu𐑉)i"rEu𐑊)i#rEu𐑋)i$rEu𐑌)i%rEu𐑍)i&rEu𐑎)i'rEu𐑏)i(r0)i�r�)i�r0)i�r�)i�rEu𐓘)i�rEu𐓙)i�rEu𐓚)i�rEu𐓛)i�rEu𐓜)i�rEu𐓝)i�rEu𐓞)i�rEu𐓟)i�rEu𐓠)i�rEu𐓡)i�rEu𐓢)i�rEu𐓣)i�rEu𐓤)i�rEu𐓥)i�rEu𐓦)i�rEu𐓧)i�rEu𐓨)i�rEu𐓩)i�rEu𐓪)i�rEu𐓫)i�rEu𐓬)i�rEu𐓭)i�rEu𐓮)i�rEu𐓯)i�rEu𐓰)i�rEu𐓱)i�rEu𐓲)i�rEu𐓳)i�rEu𐓴)i�rEu𐓵)i�rEu𐓶)i�rEu𐓷)i�rEu𐓸)i�rEu𐓹)i�rEu𐓺)i�rEu𐓻)i�r�)i�r0)i�r�)ir0)i(r�)i0r0)idr�)ior0)ipr�)ir0)i7r�)i@r0)iVr�)i`r0)ihr�)ir0)ir�)ir0)i	r�)i
r0)i6r�)i7r0r�r�r�r�r��_seg_53�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i9r�)i<r0)i=r�)i?r0)iVr�)iWr0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i	r�)i	r0)i:	r�)i?	r0)i@	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i
r�)i
r0)i
r�)i
r0)i
r�)i
r0)i
r�)i
r0)i6
r�)i8
r0)i;
r�)i?
r0)iI
r�)iP
r0)iY
r�)i`
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)ir0)i6r�)i9r0)iVr�)iXr0)isr�)ixr0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)iIr�)i�rEu𐳀)i�rEu𐳁)i�rEu𐳂)i�rEu𐳃)i�rEu𐳄)i�rEu𐳅)i�rEu𐳆)i�rEu𐳇)i�rEu𐳈)i�rEu𐳉)i�rEu𐳊)i�rEu𐳋)i�rEu𐳌)i�rEu𐳍)i�rEu𐳎)i�rEu𐳏)i�rEu𐳐)i�rEu𐳑)i�rEu𐳒)i�rEu𐳓)i�rEu𐳔)i�rEu𐳕)i�rEu𐳖)i�rEu𐳗)i�rEu𐳘)i�rEu𐳙)i�rEu𐳚)i�rEu𐳛)i�rEu𐳜)i�rEu𐳝)i�rEu𐳞)i�rEu𐳟)i�rEu𐳠)i�rEu𐳡)i�rEu𐳢)i�rEu𐳣)i�rEu𐳤)i�rEu𐳥)i�rEu𐳦)i�rEu𐳧)i�rEu𐳨r�r�r�r�r��_seg_54�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu𐳩)i�rEu𐳪)i�rEu𐳫)i�rEu𐳬)i�rEu𐳭)i�rEu𐳮)i�rEu𐳯)i�rEu𐳰)i�rEu𐳱)i�rEu𐳲)i�r�)i�r0)i�r�)i�r0)i(
r�)i0
r0)i:
r�)i`r0)ir�)ir0)i(r�)i0r0)iZr�)ir0)iNr�)iRr0)ipr�)ir0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i5r�)i6r0)iGr�)iPr0)iwr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i?r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i
r�)ir0)ir�)ir0)i)r�)i*r0)i1r�)i2r0)i4r�)i5r0)i:r�)i;r0)iEr�)iGr0)iIr�)iKr0)iNr�)iPr0)iQr�)iWr0)iXr�)i]r0)idr�)ifr0)imr�)ipr0)iur�)ir0)iZr�)i[r0)i\r�)i]r0r�r�r�r�r��_seg_55`s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i_r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)iEr�)iPr0)iZr�)i`r0)imr�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i,r�)i0r0)i@r�)ir0)i<r�)i�rEu𑣀)i�rEu𑣁)i�rEu𑣂)i�rEu𑣃)i�rEu𑣄)i�rEu𑣅)i�rEu𑣆)i�rEu𑣇)i�rEu𑣈)i�rEu𑣉)i�rEu𑣊)i�rEu𑣋)i�rEu𑣌)i�rEu𑣍)i�rEu𑣎)i�rEu𑣏)i�rEu𑣐)i�rEu𑣑)i�rEu𑣒)i�rEu𑣓)i�rEu𑣔)i�rEu𑣕)i�rEu𑣖)i�rEu𑣗)i�rEu𑣘)i�rEu𑣙)i�rEu𑣚)i�rEu𑣛)i�rEu𑣜)i�rEu𑣝)i�rEu𑣞)i�rEu𑣟)i�r0)i�r�)i�r0)ir�)ir0)iHr�)iPr0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i	r�)i
r0)i7r�)i8r0)iFr�)iPr0)imr�)ipr0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i
r�)ir0)i7r�)i:r0)i;r�)i<r0)i>r�)i?r0)iHr�)iPr0)iZr�)i`r0r�r�r�r�r��_seg_56�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ifr�)igr0)iir�)ijr0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i r0)i�#r�)i$r0)io$r�)ip$r0)iu$r�)i�$r0)iD%r�)i0r0)i/4r�)iDr0)iGFr�)ihr0)i9jr�)i@jr0)i_jr�)i`jr0)ijjr�)injr0)ipjr�)i�jr0)i�jr�)i�jr0)i�jr�)ikr0)iFkr�)iPkr0)iZkr�)i[kr0)ibkr�)ickr0)ixkr�)i}kr0)i�kr�)i`nr0)i�nr�)ior0)iEor�)iPor0)ior�)i�or0)i�or�)i�or0)i�or�)ipr0)i�r�)i�r0)i�r�)i�r0)i�r�)ip�r0)i��r�)i�r0)ik�r�)ip�r0)i}�r�)i��r0)i��r�)i��r0)i��r�)i��r0)i��r�)i��r�)i�r0)i��r�)i�r0)i'�r�)i)�r0)i^�rEu𝅗𝅥)i_�rEu𝅘𝅥)i`�rEu𝅘𝅥𝅮)ia�rEu𝅘𝅥𝅯)ib�rEu𝅘𝅥𝅰)ic�rEu𝅘𝅥𝅱)id�rEu𝅘𝅥𝅲)ie�r0)is�r�)i{�r0)i��rEu𝆹𝅥)i��rEu𝆺𝅥)i��rEu𝆹𝅥𝅮)i��rEu𝆺𝅥𝅮)i��rEu𝆹𝅥𝅯)i��rEu𝆺𝅥𝅯)i��r0)i��r�)i�r0r�r�r�r�r��_seg_570s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iF�r�)i��r0)i��r�)i�r0)iW�r�)i`�r0)iy�r�)i�rErF)i�rErH)i�rErJ)i�rErL)i�rErN)i�rErP)i�rErR)i�rErT)i�rErV)i	�rErX)i
�rErZ)i�rEr\)i�rEr^)i
�rEr`)i�rErb)i�rErd)i�rErf)i�rErh)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i�rErv)i�rErx)i�rErF)i�rErH)i�rErJ)i�rErL)i�rErN)i�rErP)i �rErR)i!�rErT)i"�rErV)i#�rErX)i$�rErZ)i%�rEr\)i&�rEr^)i'�rEr`)i(�rErb)i)�rErd)i*�rErf)i+�rErh)i,�rErj)i-�rErl)i.�rErn)i/�rErp)i0�rErr)i1�rErt)i2�rErv)i3�rErx)i4�rErF)i5�rErH)i6�rErJ)i7�rErL)i8�rErN)i9�rErP)i:�rErR)i;�rErT)i<�rErV)i=�rErX)i>�rErZ)i?�rEr\)i@�rEr^)iA�rEr`)iB�rErb)iC�rErd)iD�rErf)iE�rErh)iF�rErj)iG�rErl)iH�rErn)iI�rErp)iJ�rErr)iK�rErt)iL�rErv)iM�rErx)iN�rErF)iO�rErH)iP�rErJ)iQ�rErL)iR�rErN)iS�rErP)iT�rErR)iU�r�)iV�rErV)iW�rErX)iX�rErZ)iY�rEr\)iZ�rEr^)i[�rEr`)i\�rErbr�r�r�r�r��_seg_58�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i]�rErd)i^�rErf)i_�rErh)i`�rErj)ia�rErl)ib�rErn)ic�rErp)id�rErr)ie�rErt)if�rErv)ig�rErx)ih�rErF)ii�rErH)ij�rErJ)ik�rErL)il�rErN)im�rErP)in�rErR)io�rErT)ip�rErV)iq�rErX)ir�rErZ)is�rEr\)it�rEr^)iu�rEr`)iv�rErb)iw�rErd)ix�rErf)iy�rErh)iz�rErj)i{�rErl)i|�rErn)i}�rErp)i~�rErr)i�rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��r�)i��rErJ)i��rErL)i��r�)i��rErR)i��r�)i��rErX)i��rErZ)i��r�)i��rEr`)i��rErb)i��rErd)i��rErf)i��r�)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��r�)i��rErP)i��r�)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`r�r�r�r�r��_seg_59s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��r�)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i�rErr)i�rErt)i�rErv)i�rErx)i�rErF)i�rErH)i�r�)i�rErL)i�rErN)i	�rErP)i
�rErR)i�r�)i
�rErX)i�rErZ)i�rEr\)i�rEr^)i�rEr`)i�rErb)i�rErd)i�rErf)i�r�)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i�rErv)i�r�)i�rErF)i�rErH)i �rErJ)i!�rErL)i"�rErN)i#�rErP)i$�rErR)i%�rErT)i&�rErV)i'�rErX)i(�rErZr�r�r�r�r��_seg_60hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i)�rEr\)i*�rEr^)i+�rEr`)i,�rErb)i-�rErd)i.�rErf)i/�rErh)i0�rErj)i1�rErl)i2�rErn)i3�rErp)i4�rErr)i5�rErt)i6�rErv)i7�rErx)i8�rErF)i9�rErH)i:�r�)i;�rErL)i<�rErN)i=�rErP)i>�rErR)i?�r�)i@�rErV)iA�rErX)iB�rErZ)iC�rEr\)iD�rEr^)iE�r�)iF�rErb)iG�r�)iJ�rErj)iK�rErl)iL�rErn)iM�rErp)iN�rErr)iO�rErt)iP�rErv)iQ�r�)iR�rErF)iS�rErH)iT�rErJ)iU�rErL)iV�rErN)iW�rErP)iX�rErR)iY�rErT)iZ�rErV)i[�rErX)i\�rErZ)i]�rEr\)i^�rEr^)i_�rEr`)i`�rErb)ia�rErd)ib�rErf)ic�rErh)id�rErj)ie�rErl)if�rErn)ig�rErp)ih�rErr)ii�rErt)ij�rErv)ik�rErx)il�rErF)im�rErH)in�rErJ)io�rErL)ip�rErN)iq�rErP)ir�rErR)is�rErT)it�rErV)iu�rErX)iv�rErZ)iw�rEr\)ix�rEr^)iy�rEr`)iz�rErb)i{�rErd)i|�rErf)i}�rErh)i~�rErj)i�rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErVr�r�r�r�r��_seg_61�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErNr�r�r�r�r��_seg_628s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i�rErv)i�rErx)i�rErF)i	�rErH)i
�rErJ)i�rErL)i�rErN)i
�rErP)i�rErR)i�rErT)i�rErV)i�rErX)i�rErZ)i�rEr\)i�rEr^)i�rEr`)i�rErb)i�rErd)i�rErf)i�rErh)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i �rErv)i!�rErx)i"�rErF)i#�rErH)i$�rErJ)i%�rErL)i&�rErN)i'�rErP)i(�rErR)i)�rErT)i*�rErV)i+�rErX)i,�rErZ)i-�rEr\)i.�rEr^)i/�rEr`)i0�rErb)i1�rErd)i2�rErf)i3�rErh)i4�rErj)i5�rErl)i6�rErn)i7�rErp)i8�rErr)i9�rErt)i:�rErv)i;�rErx)i<�rErF)i=�rErH)i>�rErJ)i?�rErL)i@�rErN)iA�rErP)iB�rErR)iC�rErT)iD�rErV)iE�rErX)iF�rErZ)iG�rEr\)iH�rEr^)iI�rEr`)iJ�rErb)iK�rErd)iL�rErf)iM�rErh)iN�rErj)iO�rErl)iP�rErn)iQ�rErp)iR�rErr)iS�rErt)iT�rErv)iU�rErx)iV�rErFr�r�r�r�r��_seg_63�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iW�rErH)iX�rErJ)iY�rErL)iZ�rErN)i[�rErP)i\�rErR)i]�rErT)i^�rErV)i_�rErX)i`�rErZ)ia�rEr\)ib�rEr^)ic�rEr`)id�rErb)ie�rErd)if�rErf)ig�rErh)ih�rErj)ii�rErl)ij�rErn)ik�rErp)il�rErr)im�rErt)in�rErv)io�rErx)ip�rErF)iq�rErH)ir�rErJ)is�rErL)it�rErN)iu�rErP)iv�rErR)iw�rErT)ix�rErV)iy�rErX)iz�rErZ)i{�rEr\)i|�rEr^)i}�rEr`)i~�rErb)i�rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rEuı)i��rEuȷ)i��r�)i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rErw)i��rEr)i��rEr�r�r�r�r�r��_seg_64s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rE�∇)i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rE�∂)i��rErt)i��rErw)i��rErx)i��rEr�)i��rEr~)i��rEr})i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rErw)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rErp)i��rErq)i��rErr)i��rErs)i�rErt)i�rEru)i�rErv)i�rErw)i�rErd)i�rErx)i�rEry)i�rEr�)i�rErz)i	�rEr{)i
�rEr|)i�rEr})i�rEr~)i
�rEr)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rErt)i�rErw)i�rErx)i�rEr�)i�rEr~)i�rEr})i�rErp)i�rErq)i�rErr)i�rErs)i �rErt)i!�rErur�r�r�r�r��_seg_65ps��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i"�rErv)i#�rErw)i$�rErd)i%�rErx)i&�rEry)i'�rEr�)i(�rErz)i)�rEr{)i*�rEr|)i+�rEr})i,�rEr~)i-�rErw)i.�rEr)i/�rEr�)i0�rEr�)i1�rEr�)i2�rEr�)i3�rEr�)i4�rEr�)i5�rEr�)i6�rErp)i7�rErq)i8�rErr)i9�rErs)i:�rErt)i;�rEru)i<�rErv)i=�rErw)i>�rErd)i?�rErx)i@�rEry)iA�rEr�)iB�rErz)iC�rEr{)iD�rEr|)iE�rEr})iF�rEr~)iG�rEr)iI�rEr�)iJ�rEr�)iK�rEr�)iL�rEr�)iM�rEr�)iN�rEr�)iO�rEr�)iP�rErt)iQ�rErw)iR�rErx)iS�rEr�)iT�rEr~)iU�rEr})iV�rErp)iW�rErq)iX�rErr)iY�rErs)iZ�rErt)i[�rEru)i\�rErv)i]�rErw)i^�rErd)i_�rErx)i`�rEry)ia�rEr�)ib�rErz)ic�rEr{)id�rEr|)ie�rEr})if�rEr~)ig�rErw)ih�rEr)ii�rEr�)ij�rEr�)ik�rEr�)il�rEr�)im�rEr�)in�rEr�)io�rEr�)ip�rErp)iq�rErq)ir�rErr)is�rErs)it�rErt)iu�rEru)iv�rErv)iw�rErw)ix�rErd)iy�rErx)iz�rEry)i{�rEr�)i|�rErz)i}�rEr{)i~�rEr|)i�rEr})i��rEr~)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�r�r�r�r�r��_seg_66�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEr�)i��rErt)i��rErw)i��rErx)i��rEr�)i��rEr~)i��rEr})i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rErw)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rErt)i��rErw)i��rErx)i��rEr�)i��rEr~)i��rEr})i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�r�r�r�r�r��_seg_67@s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i�r0)i��r�)i��r0)i��r�)i��r0)i��r�)i�r0)i�r�)i�r0)i�r�)i�r0)i"�r�)i#�r0)i%�r�)i&�r0)i+�r�)i�r0)i��r�)i��r0)i��r�)i�rEu𞤢)i�rEu𞤣)i�rEu𞤤)i�rEu𞤥)i�rEu𞤦)i�rEu𞤧)i�rEu𞤨)i�rEu𞤩)i�rEu𞤪)i	�rEu𞤫)i
�rEu𞤬)i�rEu𞤭)i�rEu𞤮)i
�rEu𞤯)i�rEu𞤰)i�rEu𞤱)i�rEu𞤲)i�rEu𞤳)i�rEu𞤴)i�rEu𞤵)i�rEu𞤶)i�rEu𞤷)i�rEu𞤸)i�rEu𞤹)i�rEu𞤺)i�rEu𞤻)i�rEu𞤼)i�rEu𞤽)i�rEu𞤾)i�rEu𞤿)i�rEu𞥀)i�rEu𞥁)i �rEu𞥂)i!�rEu𞥃)i"�r0)iK�r�)iP�r0)iZ�r�)i^�r0)i`�r�)iq�r0)i��r�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�r�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i	�rEr�)i
�rEr�)i�rEr�)i�rEr�)i
�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�r�r�r�r�r��_seg_68�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ٮ)i�rEr)i�rE�ڡ)i�rE�ٯ)i �r�)i!�rEr�)i"�rEr�)i#�r�)i$�rEr�)i%�r�)i'�rEr�)i(�r�)i)�rEr�)i*�rEr�)i+�rEr�)i,�rEr�)i-�rEr�)i.�rEr�)i/�rEr�)i0�rEr�)i1�rEr�)i2�rEr�)i3�r�)i4�rEr�)i5�rEr�)i6�rEr�)i7�rEr�)i8�r�)i9�rEr�)i:�r�)i;�rEr�)i<�r�)iB�rEr�)iC�r�)iG�rEr�)iH�r�)iI�rEr�)iJ�r�)iK�rEr�)iL�r�)iM�rEr�)iN�rEr�)iO�rEr�)iP�r�)iQ�rEr�)iR�rEr�)iS�r�)iT�rEr�)iU�r�)iW�rEr�)iX�r�)iY�rEr�)iZ�r�)i[�rEr�)i\�r�)i]�rEr)i^�r�)i_�rEr�)i`�r�)ia�rEr�)ib�rEr�)ic�r�)id�rEr�)ie�r�)ig�rEr�)ih�rEr�)ii�rEr�)ij�rEr�)ik�r�)il�rEr�)im�rEr�)in�rEr�)io�rEr�)ip�rEr�)iq�rEr�)ir�rEr�)is�r�)it�rEr�)iu�rEr�)iv�rEr�)iw�rEr�)ix�r�)iy�rEr�)iz�rEr�)i{�rEr�)i|�rEr�)i}�r�)i~�rEr�)i�r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�r�r�r�r�r��_seg_69s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��r0)i��r�)i�r0)i,�r�)i0�r0)i��r�)i��r0)i��r�)i��r0)i��r�)i��r0)i��r�)i��r0)i��r�)i�rz0,)i�rz1,)i�rz2,)i�rz3,)i�rz4,)i�rz5,)i�rz6,)i�rz7,)i	�rz8,)i
�rz9,)i�r0)i
�r�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i �rr�)i!�rr�)i"�rr�)i#�rr�)i$�rr�r�r�r�r�r��_seg_70xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i%�rr�)i&�rr�)i'�rr�)i(�rr�)i)�rr�)i*�rEu〔s〕)i+�rErJ)i,�rErh)i-�rEr�)i.�rEZwz)i/�r0)i0�rErF)i1�rErH)i2�rErJ)i3�rErL)i4�rErN)i5�rErP)i6�rErR)i7�rErT)i8�rErV)i9�rErX)i:�rErZ)i;�rEr\)i<�rEr^)i=�rEr`)i>�rErb)i?�rErd)i@�rErf)iA�rErh)iB�rErj)iC�rErl)iD�rErn)iE�rErp)iF�rErr)iG�rErt)iH�rErv)iI�rErx)iJ�rEZhv)iK�rEr�)iL�rEZsd)iM�rEr))iN�rEZppv)iO�rEZwc)iP�r0)ij�rEZmc)ik�rEZmd)il�r�)ip�r0)i��rEZdj)i��r0)i��r�)i��r0)i�rEuほか)i�rEuココ)i�rEr|)i�r�)i�rEr)i�rEu字)i�rEu双)i�rEuデ)i�rEr)i�rE�多)i�rEu解)i�rErh)i�rEu交)i�rEu映)i�rEu無)i�rEr�)i�rEu前)i�rEu後)i�rE�再)i�rEu新)i �rEu初)i!�rEu終)i"�rEr)i#�rEu販)i$�rEu声)i%�rEu吹)i&�rEu演)i'�rEu投)i(�rEu捕)i)�rEr)i*�rErc)i+�rEu遊)i,�rEro)i-�rErf)i.�rErp)i/�rEu指)i0�rEr#)i1�rEu打)i2�rEu禁)i3�rEu空)i4�rEu合)i5�rEu満)i6�rErl)i7�rEr)i8�rEu申)i9�rE�割)i:�rEu営)i;�rEu配r�r�r�r�r��_seg_71�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i<�r�)i@�rEu	〔本〕)iA�rEu	〔三〕)iB�rEu	〔二〕)iC�rEu	〔安〕)iD�rEu	〔点〕)iE�rEu	〔打〕)iF�rEu	〔盗〕)iG�rEu	〔勝〕)iH�rEu	〔敗〕)iI�r�)iP�rEu得)iQ�rEu可)iR�r�)i`�r0)if�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i��r�)i�r0)it�r�)i��r0)i�r�)i�r0)i�r�)i�r0)iH�r�)iP�r0)iZ�r�)i`�r0)i��r�)i��r0)i��r�)i�r0)i�r�)i�r0)i?�r�)i@�r0)iq�r�)is�r0)iw�r�)iz�r0)i{�r�)i|�r0)i��r�)i��r0)i��r�)i��r0)i�r�)i�r0)i�r�)i`�r0)in�r�)ir0)iצr�)i�r0)i5�r�)i@�r0)i�r�)i �r0)i��r�)i��r0)i��r�)i�rEu丽)i�rEu丸)i�rEu乁)i�rEu𠄢)i�rEu你)i�rEr�)i�rEu侻)i�rEu倂)i�rEu偺)i	�rEu備)i
�rEr�)i�rEu像)i�rEu㒞)i
�rEu𠘺)i�rEr�)i�rEu兔)i�rEu兤)i�rEu具)i�rEu𠔜)i�rEu㒹)i�rEu內)i�rEr�)i�rEu𠕋)i�rEu冗)i�rEu冤)i�rEu仌)i�rEu冬)i�rEr�)i�rEu𩇟)i�rEr	)i�rEu刃)i�rEu㓟)i �rEu刻)i!�rEu剆r�r�r�r�r��_seg_72Hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i"�rEr�)i#�rEu剷)i$�rEu㔕)i%�rEr�)i&�rEr�)i'�rEr�)i(�rEr�)i)�rEu包)i*�rEu匆)i+�rEr�)i,�rEu卉)i-�rEr�)i.�rEu博)i/�rEu即)i0�rEu卽)i1�rEu卿)i4�rEu𠨬)i5�rEu灰)i6�rEu及)i7�rEu叟)i8�rEu𠭣)i9�rEu叫)i:�rEu叱)i;�rEu吆)i<�rEu咞)i=�rEu吸)i>�rEu呈)i?�rEu周)i@�rEu咢)iA�rEu哶)iB�rEu唐)iC�rEu啓)iD�rEu啣)iE�rEu善)iG�rEr�)iH�rEu喫)iI�rEu喳)iJ�rEu嗂)iK�rEu圖)iL�rEr�)iM�rEu圗)iN�rEu噑)iO�rEu噴)iP�rEr�)iQ�rEu壮)iR�rEu城)iS�rEu埴)iT�rEu堍)iU�rEu型)iV�rEu堲)iW�rEu報)iX�rEu墬)iY�rEu𡓤)iZ�rEu売)i[�rEu壷)i\�rEu夆)i]�rEr�)i^�rEu夢)i_�rEu奢)i`�rEu𡚨)ia�rEu𡛪)ib�rEu姬)ic�rEu娛)id�rEu娧)ie�rEu姘)if�rEu婦)ig�rEu㛮)ih�r�)ii�rEu嬈)ij�rEu嬾)il�rEu𡧈)im�rEu寃)in�rEu寘)io�rEr�)ip�rEu寳)iq�rEu𡬘)ir�rEu寿)is�rEu将)it�r�)iu�rEr)iv�rEu㞁)iw�rEu屠)ix�rEr)iy�rEu峀)iz�rEu岍)i{�rEu𡷤)i|�rEu嵃)i}�rEu𡷦)i~�rEu嵮)i�rEu嵫)i��rEu嵼)i��rEu巡)i��rEu巢)i��rEu㠯)i��rEu巽)i��rEu帨)i��rEu帽)i��rEu幩)i��rEu㡢)i��rEu𢆃r�r�r�r�r��_seg_73�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEu㡼)i��rEu庰)i��rEu庳)i��rEu庶)i��rEr�)i��rEu𪎒)i��rEr)i��rEu𢌱)i��rE�舁)i��rEu弢)i��rEu㣇)i��rEu𣊸)i��rEu𦇚)i��rEu形)i��rEu彫)i��rEu㣣)i��rEu徚)i��rEu忍)i��rEu志)i��rEu忹)i��rEu悁)i��rEu㤺)i��rEu㤜)i��rEr�)i��rEu𢛔)i��rEu惇)i��rEu慈)i��rE�慌)i��rEr�)i��rEr�)i��rEu慺)i��rEr�)i��rEu憲)i��rEu憤)i��rEu憯)i��rEu懞)i��rEr�)i��rEr�)i��rEu成)i��rEu戛)i��rEu扝)i��rEu抱)i��rEu拔)i��rEu捐)i��rEu𢬌)i��rEu挽)i��rEu拼)i��rEu捨)i��rEu掃)i��rEu揤)i��rEu𢯱)i��rEu搢)i��rEu揅)i��rEu掩)i�rEu㨮)i�rEu摩)i�rEu摾)i�rEu撝)i�rEu摷)i�rEu㩬)i�rEr�)i�rEu敬)i�rEu𣀊)i�rEu旣)i�rEu書)i�rEu晉)i�rEu㬙)i�rEr�)i�rEu㬈)i�rEu㫤)i�rEu冒)i�rEu冕)i�rEu最)i�rEu暜)i�rEu肭)i�rEu䏙)i�rEr�)i�rEr�)i�rEu朡)i�rEu杞)i�rEu杓)i�rEu𣏃)i�rEu㭉)i�rEu柺)i�rEu枅)i�rEu桒)i�rEr�)i�rEu𣑭)i�rEu梎)i�rEu栟)i�rEu椔)i�rEr)i�rEu楂)i�rEu榣)i�rEu槪)i�rEu檨)i�rEu𣚣)i�rEu櫛)i�rEu㰘)i�rEu次r�r�r�r�r��_seg_74s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu𣢧)i�rEu歔)i�rEu㱎)i�rEu歲)i�rEu殟)i��rEr�)i��rEu殻)i��rEu𣪍)i��rEu𡴋)i��rEu𣫺)i��rEu汎)i��rEu𣲼)i��rEu沿)i��rEu泍)i��rEu汧)i��rEu洖)i�rEu派)i�rEr�)i�rEr�)i�rEu浩)i�rEu浸)i�rEu涅)i�rEu𣴞)i�rEu洴)i�rEu港)i	�rEu湮)i
�rEu㴳)i�rEr�)i�rEu滇)i
�rEu𣻑)i�rEu淹)i�rEu潮)i�rEu𣽞)i�rEu𣾎)i�rEu濆)i�rEu瀹)i�rEr�)i�rEu瀛)i�rEu㶖)i�rEu灊)i�rEu災)i�rEu灷)i�rEu炭)i�rEu𠔥)i�rEu煅)i�rEu𤉣)i�rEu熜)i�r�)i �rEu爨)i!�rEr�)i"�rEu牐)i#�rEu𤘈)i$�rEu犀)i%�rEu犕)i&�rEu𤜵)i'�rEu𤠔)i(�rEu獺)i)�rEu王)i*�rEu㺬)i+�rEu玥)i,�rEu㺸)i.�rEu瑇)i/�rEu瑜)i0�rEr�)i1�rEu璅)i2�rEu瓊)i3�rEu㼛)i4�rEu甤)i5�rEu𤰶)i6�rEu甾)i7�rEu𤲒)i8�rEr�)i9�rEu𢆟)i:�rEu瘐)i;�rEu𤾡)i<�rEu𤾸)i=�rEu𥁄)i>�rEu㿼)i?�rEu䀈)i@�rEr�)iA�rEu𥃳)iB�rEu𥃲)iC�rEu𥄙)iD�rEu𥄳)iE�rEu眞)iF�rEu真)iH�rEr�)iI�rEr)iJ�rEu瞋)iK�rEu䁆)iL�rEu䂖)iM�rEu𥐝)iN�rEu硎)iO�rEr�)iP�rEr�)iQ�rEu䃣)iR�rEu𥘦)iS�rEr�)iT�rEu𥚚)iU�rEu𥛅r�r�r�r�r��_seg_75�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iV�rEr�)iW�rEu秫)iX�rEu䄯)iY�rEr�)iZ�rEu穊)i[�rEu穏)i\�rEu𥥼)i]�rEu𥪧)i_�r�)i`�rEu䈂)ia�rEu𥮫)ib�rEu篆)ic�rEu築)id�rEu䈧)ie�rEu𥲀)if�rEu糒)ig�rEu䊠)ih�rEu糨)ii�rEu糣)ij�rEu紀)ik�rEu𥾆)il�rEu絣)im�rEu䌁)in�rEu緇)io�rEu縂)ip�rEu繅)iq�rEu䌴)ir�rEu𦈨)is�rEu𦉇)it�rEu䍙)iu�rEu𦋙)iv�rEu罺)iw�rEu𦌾)ix�rEu羕)iy�rEu翺)iz�rEr�)i{�rEu𦓚)i|�rEu𦔣)i}�rEu聠)i~�rEu𦖨)i�rEu聰)i��rEu𣍟)i��rEu䏕)i��rEu育)i��rEu脃)i��rEu䐋)i��rEu脾)i��rEu媵)i��rEu𦞧)i��rEu𦞵)i��rEu𣎓)i��rEu𣎜)i��rEr�)i��rEu舄)i��rEu辞)i��rEu䑫)i��rEu芑)i��rEu芋)i��rEu芝)i��rEu劳)i��rEu花)i��rEu芳)i��rEu芽)i��rEu苦)i��rEu𦬼)i��rEr�)i��rEu茝)i��rEu荣)i��rEu莭)i��rEu茣)i��rEu莽)i��rEu菧)i��rEr�)i��rEu荓)i��rEu菊)i��rEu菌)i��rEu菜)i��rEu𦰶)i��rEu𦵫)i��rEu𦳕)i��rEu䔫)i��rEu蓱)i��rEu蓳)i��rEu蔖)i��rEu𧏊)i��rEu蕤)i��rEu𦼬)i��rEu䕝)i��rEu䕡)i��rEu𦾱)i��rEu𧃒)i��rEu䕫)i��rEu虐)i��rEr�)i��rEu虧)i��rEu虩)i��rEu蚩)i��rEu蚈)i��rEu蜎)i��rEu蛢r�r�r�r�r��_seg_76�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEu蜨)i��rEu蝫)i��rEu螆)i��r�)i��rEu蟡)i��rEu蠁)i�rEu䗹)i�rEu衠)i�rEr)i�rEu𧙧)i�rEu裗)i�rEu裞)i�rEu䘵)i�rEu裺)i�rEu㒻)i�rEu𧢮)i�rEu𧥦)i�rEu䚾)i�rEu䛇)i�rEu誠)i�rEr�)i�rEr)i�rEr")i�rEu𧲨)i�rEu貫)i�rEu賁)i�rEu贛)i�rEu起)i�rEu𧼯)i�rEu𠠄)i�rEu跋)i�rEu趼)i�rEu跰)i�rEu𠣞)i�rEu軔)i�rEr)i�rEu𨗒)i�rEu𨗭)i�rEu邔)i�rEu郱)i�rEu鄑)i�rEu𨜮)i�rEu鄛)i�rEu鈸)i�rEu鋗)i�rEu鋘)i�rEu鉼)i�rEu鏹)i�rEu鐕)i�rEu𨯺)i�rEu開)i�rEu䦕)i�rEu閷)i�rEu𨵷)i�rEu䧦)i�rEu雃)i�rEu嶲)i��rEu霣)i��rEu𩅅)i��rEu𩈚)i��rEu䩮)i��rEu䩶)i��rEu韠)i��rEu𩐊)i��rEu䪲)i��rEu𩒖)i��rEr)i�rEu頩)i�rEu𩖶)i�rEu飢)i�rEu䬳)i�rEu餩)i�rEu馧)i�rEu駂)i�rEu駾)i�rEu䯎)i	�rEu𩬰)i
�rEr)i�rEu鱀)i�rEu鳽)i
�rEu䳎)i�rEu䳭)i�rEu鵧)i�rEu𪃎)i�rEu䳸)i�rEu𪄅)i�rEu𪈎)i�rEu𪊑)i�rEr))i�rEu䵖)i�rEr*)i�rEu黾)i�rEu鼅)i�rEu鼏)i�rEu鼖)i�rEr+)i�rEu𪘀)i�r�)ir�r�r�r�r�r��_seg_77Ps��r�cCsdgS)N)i�r�r�r�r�r�r��_seg_78�s�r�N)S�__doc__�__version__r�r�rLrTr_rer�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr r7rirjrqr�r�r�r�r�r�r�r�r�r�r�rr/rarjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r��tupleZ	uts46datar�r�r�r��<module>s�hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh��������	�
���
������������������� �!�"�#�$�%�&�'�(�)�*�+�,�-�.�/�0�1�2�3�4�5�6�7�8�9�:�;�<�=�>�?�@�A�B�C�D�E�F�G�H�I�J�K�L�M�N��site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-38.opt-1.pyc000064400000003355151446177000022227 0ustar00U

��.e��@s0dZddlZdd�Zdd�Zdd�Zd	d
�ZdS)a	
Given a list of integers, made up of (hopefully) a small number of long runs
of consecutive integers, compute a representation of the form
((start1, end1), (start2, end2) ...). Then answer the question "was x present
in the original list?" in time O(log(# runs)).
�NcCs�t|�}g}d}tt|��D]b}|dt|�krJ||||ddkrJq||d|d�}|�t|d|dd��|}qt|�S)aRepresent a list of integers as a sequence of ranges:
    ((start_0, end_0), (start_1, end_1), ...), such that the original
    integers are exactly those x such that start_i <= x < end_i for some i.

    Ranges are encoded as single integers (start << 32 | end), not as tuples.
    ����r)�sorted�range�len�append�
_encode_range�tuple)Zlist_Zsorted_list�rangesZ
last_write�iZ
current_range�r�>/usr/lib/python3.8/site-packages/pip/_vendor/idna/intranges.py�intranges_from_list
srcCs|d>|BS)N� r)�start�endrrr
rsrcCs|d?|d@fS)Nrl��r)�rrrr
�
_decode_range"srcCszt|d�}t�||�}|dkrNt||d�\}}||krF|krNnndS|t|�krvt||�\}}||krvdSdS)z=Determine if `int_` falls into one of the ranges in `ranges`.rrTF)r�bisectZbisect_leftrr)Zint_r
Ztuple_�pos�left�right�_rrr
�intranges_contain&s
r)�__doc__rrrrrrrrr
�<module>s
site-packages/pip/_vendor/idna/__pycache__/intranges.cpython-38.pyc000064400000003355151446177000021270 0ustar00U

��.e��@s0dZddlZdd�Zdd�Zdd�Zd	d
�ZdS)a	
Given a list of integers, made up of (hopefully) a small number of long runs
of consecutive integers, compute a representation of the form
((start1, end1), (start2, end2) ...). Then answer the question "was x present
in the original list?" in time O(log(# runs)).
�NcCs�t|�}g}d}tt|��D]b}|dt|�krJ||||ddkrJq||d|d�}|�t|d|dd��|}qt|�S)aRepresent a list of integers as a sequence of ranges:
    ((start_0, end_0), (start_1, end_1), ...), such that the original
    integers are exactly those x such that start_i <= x < end_i for some i.

    Ranges are encoded as single integers (start << 32 | end), not as tuples.
    ����r)�sorted�range�len�append�
_encode_range�tuple)Zlist_Zsorted_list�rangesZ
last_write�iZ
current_range�r�>/usr/lib/python3.8/site-packages/pip/_vendor/idna/intranges.py�intranges_from_list
srcCs|d>|BS)N� r)�start�endrrr
rsrcCs|d?|d@fS)Nrl��r)�rrrr
�
_decode_range"srcCszt|d�}t�||�}|dkrNt||d�\}}||krF|krNnndS|t|�krvt||�\}}||krvdSdS)z=Determine if `int_` falls into one of the ranges in `ranges`.rrTF)r�bisectZbisect_leftrr)Zint_r
Ztuple_�pos�left�right�_rrr
�intranges_contain&s
r)�__doc__rrrrrrrrr
�<module>s
site-packages/pip/_vendor/idna/__pycache__/codec.cpython-38.opt-1.pyc000064400000005473151446177000021315 0ustar00U

��.e��@s�ddlmZmZmZmZmZddlZddlZe�d�Z	Gdd�dej
�Z
Gdd�dej�ZGd	d
�d
ej
�ZGdd�de
ej�ZGd
d�de
ej�Zdd�ZdS)�)�encode�decode�alabel�ulabel�	IDNAError�Nu[.。.。]c@s eZdZddd�Zddd�ZdS)	�Codec�strictcCs.|dkrtd�|���|sdSt|�t|�fS�Nr	� Unsupported error handling "{0}"��r)r�formatr�len��self�data�errors�r�:/usr/lib/python3.8/site-packages/pip/_vendor/idna/codec.pyr	s
zCodec.encodecCs.|dkrtd�|���|sdSt|�t|�fSr
)rrrrrrrrrs
zCodec.decodeN)r	)r	)�__name__�
__module__�__qualname__rrrrrrrs

rc@seZdZdd�ZdS)�IncrementalEncoderc	Cs�|dkrtd�|���|sdSt�|�}d}|rV|dsDd}|d=n|sV|d=|rVd}g}d}|D]*}|�t|��|r�|d7}|t|�7}qbd�|�|}|t|�7}||fS)	Nr	rrr
����.rr)rr�_unicode_dots_re�split�appendrr�join�	rrr�final�labelsZtrailing_dot�result�sizeZlabelrrr�_buffer_encodes0
z!IncrementalEncoder._buffer_encodeN)rrrr%rrrrrsrc@seZdZdd�ZdS)�IncrementalDecoderc	Cs�|dkrtd�|���|sdSt|t�r4t�|�}nt|�}t|d�|�d�}d}|r~|dsld}|d=n|s~|d=|r~d}g}d}|D]*}|�t|��|r�|d	7}|t	|�7}q�d�
|�|}|t	|�7}||fS)
Nr	rr�asciirr
rrr)rr�
isinstanceZunicoderr�strrrrrr rrr�_buffer_decode?s8


z!IncrementalDecoder._buffer_decodeN)rrrr*rrrrr&>sr&c@seZdZdS)�StreamWriterN�rrrrrrrr+gsr+c@seZdZdS)�StreamReaderNr,rrrrr-jsr-c	Cs tjdt�jt�jttttd�S)NZidna)�namerr�incrementalencoder�incrementaldecoder�streamwriter�streamreader)	�codecs�	CodecInforrrrr&r+r-rrrr�getregentryms�r5)Zcorerrrrrr3�re�compilerr�BufferedIncrementalEncoderr�BufferedIncrementalDecoderr&r+r-r5rrrr�<module>s
!)site-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-38.opt-1.pyc000064400000051541151446177000022002 0ustar00U

��.e��@s�dZdddddd�Zddddddddddd	d	d	d	dd	dd	dddddd	d	d	d	dddddddddddddd
dddddddd	ddddd	d	d	dd	d	d	ddddddddddddddddd	d	d	d	d	d	d	d	d	d	d	d	d	d	d	d	d	d	ddddddddddddddddddddddddddddddddddddddd	ddd	d	d	d	d	d	d	d	d	dd	dd	ddd	d	d	dd	d	dddddd	dddd	d	d	d	d	ddddd	dddddddddd	dd	dd	ddd	d	dddddddddddd	d	d	dddddddddddddddd	d	ddddd	dd	d	dddd	d	dddddddddddddddddddddddddddddddddddddddd
d	dddddd	d	dd	ddddddddddd	dddddddddddd	dd	d	ddddddddddd	d	d	dd	ddd	d	dddddd	dddddddd
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd
ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd	dd	dd	d	dddd	d	d	d	d	ddddddddddd	dddd	ddd	ddddd	dd	dd	d	d	dddd	ddd	dd	d	dd	d	d	d	d	dddddddddddddddddddddddddddddddddddddd	ddddd	dddddddddddddddddddddd	ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd
���Zdddd�ZdS)z11.0.0)$lt�
lx�
l~�
l��
l�l�l� l�0l�8l��l�l+�tlbtulk�ul��vl|l`|lF�|lN }�X@}lZd}l\l}l^t}l~|}l�~l��~l�l�Xl�tl��l��l'!�lf+�-l�l��lFRH)l�.:l�.l:l�/<l0@l0@l*0�@l<0�@��MP��8lnzdl�z�i��&�57�8]��N�`��k�:lz`)	l�D��@l��l7{tll={�ll?{�llB{mlE{mlP{m)��0Al�0tBl1@
lrH)��0�Bl1�C�2�Gl�2@KlX3Llp�}l��}l0@
)ZGreekZHanZHebrewZHiraganaZKatakana�U�D�R�C�T�L(�iiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJinioiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/iMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXi`iaibicidieifigihiiiji�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iii
ii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i i
 i/ if ig ih ii i@�iA�iB�iC�iD�iE�iF�iG�iH�iI�iJ�iK�iL�iM�iN�iO�iP�iQ�iR�iS�iT�iU�iV�iW�iX�iY�iZ�i[�i\�i]�i^�i_�i`�ia�ib�ic�id�ie�if�ig�ih�ii�ij�ik�il�im�in�io�ip�iq�ir�is�i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i
i
i
i
i
i
i
i
i
i	
i

i
i
i

i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i 
i!
i"
i#
i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiQiRiSiTi�i�i�i�i�i�i�i�i�i�i�i	�i
�i�i�i
�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i �i!�i"�i#�i$�i%�i&�i'�i(�i)�i*�i+�i,�i-�i.�i/�i0�i1�i2�i3�i4�i5�i6�i7�i8�i9�i:�i;�i<�i=�i>�i?�i@�iA�iB�iC�(ql.�l:�l{�l�|l�lllll
$l,l4l<lDlLlTl\ldllltl |l"�l$�l&�l(�l*�l,�l.�l0�l2�l6�l9�l;�l=�l?�lClElGlI lL,lN4lP<lRDlTLlVTlX\lZdl\ll^tl`|lb�ld�lf�lh�lj�ll�ln�lp�lr�lt�lv�lx�l{�l}�l�l�l�l�l� l�0l�Hl�Tl�dl�xl��l��l��l��l��l��l��l��l��l��l��l�8l�@l�Hl�Pl�Xl�`l�hl�pl�|l��l��l��l��l��l��l��l��l��l��l��l��l�lllll
$l,l4l<lDlLlTl\ldllltl |l"�l$�l&�l(�l*�l,�l.�l0�l2�l:�l=�lA�lC	lH	lJ$	lL,	lN4	l�<	l��
l�l��l��l@lC
lO
lp@
lr�
lt�
lx�
l~�
l�@l��l�\l�dl�ll�tl�|l��l��l��l��l��l��l��l��l��l��l��l`�lb�ld�lf�lh�lj�ll�ln�lp�lr�lt�lv�lx�lz�l|�l~�l��l�l�l�,l�4l�<l�Dl�Ll�Tl�\l�dl�ll�tl�|l��l��l��l��l��l��l��l��l��l��l��l��l��l��l��l��l�l�l�l� l�(l�0l�8l�Dl�Ll�Tl�\l�dl�ll�tl�|l��l��l��l��l��l��l��l��l��l��l��l��l��l��l��l�lllll
$l,l4l<lDlLlTl\ldllltl |l"�l$�l&�l(�l*�l,�l.�l0�lZdl��l� l�Dl��l�l�l�r	l��l@l@�l`lu�l��l�Tl�|l��l�lK@l�4l�l��l. l\!lk�!l��"l��"l�L#lX	�#ld	�%lp	�%l�	�%l�	&l�	<&l�	L&l�	�&l�	�&l�	�&l�	�&l�	'l�	,'l�	\'l�	�'l�	�'l�	�'l�	�'l
(l
(l
<(l)
L(l1
�(l3
�(l6
�(l:
�(l=
�(lC
�(lI
)lN
,)lR
D)l]
p)lv
�)l�
*l�
*l�
<*l�
L*l�
�*l�
�*l�
�*l�
�*l�
+l�
,+l�
@+l�
�+l�
�+l�+l,l
,l<,l)L,l1�,l4�,l:�,lE�,lI-lN,-lXX-ld|-lp�-lr�-l�.l�.l�8.l�H.l�d.l�p.l�x.l��.l��.l��.l��.l�/l�(/l�@/l�\/l��/l
0l80l)H0l:�0lE�0lI1lN(1lWT1l[`1ld�1lp�1l�2l�2l�82l�H2l��2l��2l��2l�3l�(3l�T3l�x3l��3l��3l��3l
4l

4l
84lE
H4lI
5lO
(5lX
P5ld
|5lp
�5l�
�5l�
6l�
6l�
h6l�
�6l�
�6l�
7l�
(7l�
<7l�
X7l�
`7l�
�7l�
�7l38l;�8lO9lZ@9l�:l�:l�:l�(:l�4:l�P:l�d:l��:l��:l��:l��:l��:l��:l��:l�;l�;l� ;l�@;l�x;l<l,<l`<l*�<l6�<l8�<l:�<lC�<lH=lM$=lR8=lWL=l\`=lit=lm�=ls�=lu�=l��=l�>l�>l�P>l�d>l�x>l��>l��>l��>l��>l�?lJ@l�@Al�@Cl�ClIHlN(IlW@IlY`Il^hIl��Il�(Jl�@Jl��Jl��Jl�Kl�Kl� Kl`KlHLl[`Ll`tMl�Nl��NlmPl��Yl�Zl��Zl��[l
\l8\l5�\lT]lm�]lq�]lt�]l�^l��^l�\_l�p_l��_l@`ly�`l�bl��bldl,�dl<�dlnelu�el�fl��fl�@glhl_�hl}�il��il�@jl��jl��jlLllZ@mlt�ml�nl8plJql~4ql�@sl�Psl,tl0�tl<�tlO8ulx�ul��ul�wl�wlxlxlxlxl
$xl,xl4xl<xlDxlLxlTxl\xldxllxltxl |xl"�xl$�xl&�xl(�xl*�xl,�xl.�xl0�xl2�xl4�xl6�xl8�xl:�xl<�xl>�xl@�xlBylDylFylHylJ$ylL,ylN4ylP<ylRDylTLylVTylX\ylZdyl\lyl^tyl`|ylb�yld�ylf�ylh�ylj�yll�yln�ylp�ylr�ylt�ylv�ylx�ylz�yl|�yl~�yl��yl�zl�zl�zl�zl�$zl�,zl�4zl�<zl�Dzl�Lzl�Tzl�pzl�|zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl�{l�{l�{l�{l�${l�,{l�4{l�<{l�D{l�L{l�T{l�\{l�d{l�l{l�t{l�|{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l�{l@|l(�|l8�|lF}rlh�}lq�}ls�}lu�}lw�}ly�}l{�}l}�}l��~l��~l�l�@l�Xl��l��l��lO!8l�!l_,�0lb,�1lg,�1li,�1lk,�1lm,�1lr,�1lu,�1l|,�1l�,2l�,2l�,2l�,2l�,$2l�,,2l�,42l�,<2l�,D2l�,L2l�,T2l�,\2l�,d2l�,l2l�,t2l�,|2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,3l�,3l�,3l�,3l�,$3l�,,3l�,43l�,<3l�,D3l�,L3l�,T3l�,\3l�,d3l�,l3l�,t3l�,|3l�,�3l�,�3l�,�3l�,�3l�,�3l&-4l(-�4l.-�4lh-�4l�-�5l�-�6l�-�6l�-�6l�-�6l�-7l�- 7l�-@7l�-`7l.�7l0.�8l0@l.0�@l=0�@r
l�0dBl�0tBrl�0�Cl01Dl�1�Frrrl�$l�$@l
&l,&@lB&lD&lF&lH&lJ&$lL&,lN&4lP&<lR&DlT&LlV&TlX&\lZ&dl\&ll^&tl`&|lb&�ld&�lf&�lh&�lj&�ll&�lp&�l~&�l�&�l�&l�&l�&l�&l�&$l�&,l�&4l�&<l�&Dl�&Ll�&Tl�&\l�&dl�&ll�&xl�&�l '\l$'�l&'�l('�l*'�l,'�l.'�l2'�l4'�l6'�l8'�l:'�l<'�l>'�l@'�lB'lD'lF'lH'lJ'$lL',lN'4lP'<lR'DlT'LlV'TlX'\lZ'dl\'ll^'tl`'|lb'�ld'�lf'�lh'�lj'�ll'�ln'�lp'�ly'�l{'�l}'�l�'�l�'l�'l�'l�'l�'0l�'8l�'Dl�'Ll�'\l�'dl�'ll�'tl�'|l�'�l�'�l�'�l�'�l�'�l�'�l�'�l�'�l�'�l�'�l((�lt(!l�("l�(@#l�(�#l�(�#l.)�#lT)�$l�)&l�)<'l�)�'l7*(lN*)lZ*@)lw*�)l�*�)l�*l+l�*�+l�*�+l+,l+$,l+D,l'+�,l/+�,l[+�,lf+�-l�+/l�+�/l�+�/l�W0lz8hlzDhlzLhl z|hl"z�hl%z�hl*z�hl{xll0~�xlt~�yll'4l;�l>�lN�l^@l�l��l�
l��
l��l lA�lJ
l{@
l�l��l� l��l��l�`l(ld�l7lVlh�l l	  l6( l9� l=� lV� lw�!l�"l��#l��#l	$l:	�$l�	&l�	�&l
(l
(l
0(l
T(l6
d(l;
�(l@
�(l}
�)l�
*l�
+l�
$+l6,lV-ls�-l�.lI0l�3l(
4l:
�4l<l(�<lQ�<lG@lp�Al��Al�@Cl��Cl5Dl@�DlGElt@Elw�El�Fl�$Gl�@Gl�pGlHl8LHl?�Hl�Jl� Jl�(Jl�<Jl�|Jl��Jl��KlLl
Ll<Ll)LLl1�Ll4�Ll:�LlE�LlIMlN,MlQ@MlX\MldtMlm�Mlu�MlKPlZ@Ql_xQl�Rl�Sl�@Sl�Vl��Vl�`WlAXlEYlZ@Yl�Zl�[l\l,t\l:�\l;`l�cl�cl?hlHil�@il�jl�tjl�kl	pl7(plA�plZ@ql��ql�Hrl��rltl
 tl7,tl;�tl>�tlH�tlZ@ulf�uli�ul��ul�@vl�Lvl��vl��{l�#	lD%	l/4@	lGF
l9j l_j)ljj�)l�j@+l�j�+l7k,lDk-lZk@-lxk�-l�k�-l�n�9lEo<lo@=l�o<>l�o�?l�@l�
 l1@
l�2�E
lk<p
l}<�q
l�<r
l�<@r
l�<tr
l7ZhlmZ�hlvZ�il�Zjl�Zljl�Z�jl`l` l"`ll%`�l+`�l�h l�h@#lKi�$lZi@%rrrrr)l 0)l��lv�
l��lj�l��l�0�C)ZPVALIDZCONTEXTJZCONTEXTON)�__version__ZscriptsZ
joining_typesZcodepoint_classes�rr�=/usr/lib/python3.8/site-packages/pip/_vendor/idna/idnadata.py�<module>s
&�W������h{���������site-packages/pip/_vendor/idna/__pycache__/codec.cpython-38.pyc000064400000005473151446177000020356 0ustar00U

��.e��@s�ddlmZmZmZmZmZddlZddlZe�d�Z	Gdd�dej
�Z
Gdd�dej�ZGd	d
�d
ej
�ZGdd�de
ej�ZGd
d�de
ej�Zdd�ZdS)�)�encode�decode�alabel�ulabel�	IDNAError�Nu[.。.。]c@s eZdZddd�Zddd�ZdS)	�Codec�strictcCs.|dkrtd�|���|sdSt|�t|�fS�Nr	� Unsupported error handling "{0}"��r)r�formatr�len��self�data�errors�r�:/usr/lib/python3.8/site-packages/pip/_vendor/idna/codec.pyr	s
zCodec.encodecCs.|dkrtd�|���|sdSt|�t|�fSr
)rrrrrrrrrs
zCodec.decodeN)r	)r	)�__name__�
__module__�__qualname__rrrrrrrs

rc@seZdZdd�ZdS)�IncrementalEncoderc	Cs�|dkrtd�|���|sdSt�|�}d}|rV|dsDd}|d=n|sV|d=|rVd}g}d}|D]*}|�t|��|r�|d7}|t|�7}qbd�|�|}|t|�7}||fS)	Nr	rrr
����.rr)rr�_unicode_dots_re�split�appendrr�join�	rrr�final�labelsZtrailing_dot�result�sizeZlabelrrr�_buffer_encodes0
z!IncrementalEncoder._buffer_encodeN)rrrr%rrrrrsrc@seZdZdd�ZdS)�IncrementalDecoderc	Cs�|dkrtd�|���|sdSt|t�r4t�|�}nt|�}t|d�|�d�}d}|r~|dsld}|d=n|s~|d=|r~d}g}d}|D]*}|�t|��|r�|d	7}|t	|�7}q�d�
|�|}|t	|�7}||fS)
Nr	rr�asciirr
rrr)rr�
isinstanceZunicoderr�strrrrrr rrr�_buffer_decode?s8


z!IncrementalDecoder._buffer_decodeN)rrrr*rrrrr&>sr&c@seZdZdS)�StreamWriterN�rrrrrrrr+gsr+c@seZdZdS)�StreamReaderNr,rrrrr-jsr-c	Cs tjdt�jt�jttttd�S)NZidna)�namerr�incrementalencoder�incrementaldecoder�streamwriter�streamreader)	�codecs�	CodecInforrrrr&r+r-rrrr�getregentryms�r5)Zcorerrrrrr3�re�compilerr�BufferedIncrementalEncoderr�BufferedIncrementalDecoderr&r+r-r5rrrr�<module>s
!)site-packages/pip/_vendor/idna/__pycache__/uts46data.cpython-38.pyc000064400000524104151446177000021115 0ustar00U

��.e��@sbdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Zd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Zd>d?�Z d@dA�Z!dBdC�Z"dDdE�Z#dFdG�Z$dHdI�Z%dJdK�Z&dLdM�Z'dNdO�Z(dPdQ�Z)dRdS�Z*dTdU�Z+dVdW�Z,dXdY�Z-dZd[�Z.d\d]�Z/d^d_�Z0d`da�Z1dbdc�Z2ddde�Z3dfdg�Z4dhdi�Z5djdk�Z6dldm�Z7dndo�Z8dpdq�Z9drds�Z:dtdu�Z;dvdw�Z<dxdy�Z=dzd{�Z>d|d}�Z?d~d�Z@d�d��ZAd�d��ZBd�d��ZCd�d��ZDd�d��ZEd�d��ZFd�d��ZGd�d��ZHd�d��ZId�d��ZJd�d��ZKd�d��ZLd�d��ZMd�d��ZNd�d��ZOd�d��ZPeQe�e�e�e�e�e�e�e	�e
�e�e�e
�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e�e �e!�e"�e#�e$�e%�e&�e'�e(�e)�e*�e+�e,�e-�e.�e/�e0�e1�e2�e3�e4�e5�e6�e7�e8�e9�e:�e;�e<�e=�e>�e?�e@�eA�eB�eC�eD�eE�eF�eG�eH�eI�eJ�eK�eL�eM�eN�eO�eP��ZRd�S)�zIDNA Mapping Table from UTS46.z11.0.0cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)��3)�r)�r)�r)�r)�r)�r)�r)�r)�	r)�
r)�r)�r)�
r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)�r)� r)�!r)�"r)�#r)�$r)�%r)�&r)�'r)�(r)�)r)�*r)�+r)�,r)�-�V)�.r0)�/r)�0r0)�1r0)�2r0)�3r0)�4r0)�5r0)�6r0)�7r0)�8r0)�9r0)�:r)�;r)�<r)�=r)�>r)�?r)�@r)�A�M�a)�BrE�b)�CrE�c)�DrE�d)�ErE�e)�FrE�f)�GrE�g)�HrE�h)�IrE�i)�JrE�j)�KrE�k)�LrE�l)�MrE�m)�NrE�n)�OrE�o)�PrE�p)�QrE�q)�RrE�r)�SrE�s)�TrE�t)�UrE�u)�VrE�v)�WrE�w)�XrE�x)�YrE�y)�ZrE�z)�[r)�\r)�]r)�^r)�_r)�`r)�ar0)�br0)�cr0�r�r�r��>/usr/lib/python3.8/site-packages/pip/_vendor/idna/uts46data.py�_seg_0s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)�dr0)�er0)�fr0)�gr0)�hr0)�ir0)�jr0)�kr0)�lr0)�mr0)�nr0)�or0)�pr0)�qr0)�rr0)�sr0)�tr0)�ur0)�vr0)�wr0)�xr0)�yr0)�zr0)�{r)�|r)�}r)�~r)�r)��X)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r�)�r� )�r0)�r0)�r0)�r0)�r0)�r0)�r0)�ru ̈)�r0)�rErF)�r0)�r0)��I)�r0)�r� ̄)�r0)�r0)�rE�2)�rEr)�r� ́)�rE�μ)�r0)�r0)�ru ̧)�rE�1)�rErb)�r0)�rEu1⁄4)�rEu1⁄2)�rEu3⁄4)�r0)�rE�à)�rE�á)��rE�â)��rE�ã)��rE�ä)��rE�å)��rE�æ)��rE�çr�r�r�r�r��_seg_1ps��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)��rE�è)��rE�é)��rE�ê)��rE�ë)��rE�ì)��rE�í)��rE�î)��rE�ï)��rE�ð)��rE�ñ)��rE�ò)��rE�ó)��rE�ô)��rE�õ)��rE�ö)��r0)��rE�ø)��rE�ù)��rE�ú)��rE�û)��rE�ü)��rE�ý)��rE�þ)���D�ss)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)��r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�r0)�rEuā)ir0)irEuă)ir0)irEuą)ir0)irEuć)ir0)irEuĉ)i	r0)i
rEuċ)ir0)irEuč)i
r0)irEuď)ir0)irEuđ)ir0)irEuē)ir0)irEuĕ)ir0)irEuė)ir0)irEuę)ir0)irEuě)ir0)irEuĝ)ir0)irEuğ)ir0)i rEuġ)i!r0)i"rEuģ)i#r0)i$rEuĥ)i%r0)i&rE�ħ)i'r0)i(rEuĩ)i)r0)i*rEuī)i+r0r�r�r�r�r��_seg_2�s��rLcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i,rEuĭ)i-r0)i.rEuį)i/r0)i0rEui̇)i1r0)i2rEZij)i4rEuĵ)i5r0)i6rEuķ)i7r0)i9rEuĺ)i:r0)i;rEuļ)i<r0)i=rEuľ)i>r0)i?rEul·)iArEuł)iBr0)iCrEuń)iDr0)iErEuņ)iFr0)iGrEuň)iHr0)iIrEuʼn)iJrE�ŋ)iKr0)iLrEuō)iMr0)iNrEuŏ)iOr0)iPrEuő)iQr0)iRrE�œ)iSr0)iTrEuŕ)iUr0)iVrEuŗ)iWr0)iXrEuř)iYr0)iZrEuś)i[r0)i\rEuŝ)i]r0)i^rEuş)i_r0)i`rEuš)iar0)ibrEuţ)icr0)idrEuť)ier0)ifrEuŧ)igr0)ihrEuũ)iir0)ijrEuū)ikr0)ilrEuŭ)imr0)inrEuů)ior0)iprEuű)iqr0)irrEuų)isr0)itrEuŵ)iur0)ivrEuŷ)iwr0)ixrE�ÿ)iyrEuź)izr0)i{rEuż)i|r0)i}rEuž)i~r0)irErj)i�r0)i�rEuɓ)i�rEuƃ)i�r0)i�rEuƅ)i�r0)i�rE�ɔ)i�rEuƈ)i�r0)i�rEuɖ)i�rEuɗ)i�rEuƌ)i�r0)i�rE�ǝ)i�rE�ə)i�rE�ɛ)i�rEuƒ)i�r0)i�rEuɠr�r�r�r�r��_seg_3@s��rTcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rE�ɣ)i�r0)i�rE�ɩ)i�rE�ɨ)i�rEuƙ)i�r0)i�rE�ɯ)i�rE�ɲ)i�r0)i�rE�ɵ)i�rEuơ)i�r0)i�rEuƣ)i�r0)i�rEuƥ)i�r0)i�rEuʀ)i�rEuƨ)i�r0)i�rE�ʃ)i�r0)i�rEuƭ)i�r0)i�rEuʈ)i�rEuư)i�r0)i�rE�ʊ)i�rE�ʋ)i�rEuƴ)i�r0)i�rEuƶ)i�r0)i�rE�ʒ)i�rEuƹ)i�r0)i�rEuƽ)i�r0)i�rEudž)i�rEZlj)i�rEZnj)i�rEuǎ)i�r0)i�rEuǐ)i�r0)i�rEuǒ)i�r0)i�rEuǔ)i�r0)i�rEuǖ)i�r0)i�rEuǘ)i�r0)i�rEuǚ)i�r0)i�rEuǜ)i�r0)i�rEuǟ)i�r0)i�rEuǡ)i�r0)i�rEuǣ)i�r0)i�rEuǥ)i�r0)i�rEuǧ)i�r0)i�rEuǩ)i�r0)i�rEuǫ)i�r0)i�rEuǭ)i�r0)i�rEuǯ)i�r0)i�rEZdz)i�rEuǵ)i�r0)i�rEuƕ)i�rEuƿ)i�rEuǹ)i�r0)i�rEuǻ)i�r0)i�rEuǽ)i�r0)i�rEuǿ)i�r0)irEuȁ)ir0)irEuȃ)ir0)irEuȅ)ir0)irEuȇ)ir0)irEuȉ)i	r0)i
rEuȋ)ir0)irEuȍr�r�r�r�r��_seg_4�s��r_cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i
r0)irEuȏ)ir0)irEuȑ)ir0)irEuȓ)ir0)irEuȕ)ir0)irEuȗ)ir0)irEuș)ir0)irEuț)ir0)irEuȝ)ir0)irEuȟ)ir0)i rEuƞ)i!r0)i"rE�ȣ)i#r0)i$rEuȥ)i%r0)i&rEuȧ)i'r0)i(rEuȩ)i)r0)i*rEuȫ)i+r0)i,rEuȭ)i-r0)i.rEuȯ)i/r0)i0rEuȱ)i1r0)i2rEuȳ)i3r0)i:rEuⱥ)i;rEuȼ)i<r0)i=rEuƚ)i>rEuⱦ)i?r0)iArEuɂ)iBr0)iCrEuƀ)iDrE�ʉ)iErE�ʌ)iFrEuɇ)iGr0)iHrEuɉ)iIr0)iJrEuɋ)iKr0)iLrEuɍ)iMr0)iNrEuɏ)iOr0)i�rErT)i�rE�ɦ)i�rErX)i�rErh)i�rEuɹ)i�rEuɻ)i�rEuʁ)i�rErr)i�rErv)i�r0)i�ru ̆)i�ru ̇)i�ru ̊)i�ru ̨)i�ru ̃)i�ru ̋)i�r0)i�rErU)i�rEr\)i�rErj)i�rErt)i�rEuʕ)i�r0)i@rEù)iArEú)iBr0)iCrEu̓)iDrEǘ)iErE�ι)iFr0)iOr�)iPr0)iprEuͱ)iqr0)irrEuͳ)isr0)itrEuʹ)iur0)ivrEuͷ)iwr0r�r�r�r�r��_seg_5s��recdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ixr�)izru ι)i{r0)i~r�;)irEuϳ)i�r�)i�rr�)i�r� ̈́)i�rE�ά)i�rE�·)i�rE�έ)i�rE�ή)i�rE�ί)i�r�)i�rE�ό)i�r�)i�rE�ύ)i�rE�ώ)i�r0)i�rE�α)i�rE�β)i�rE�γ)i�rE�δ)i�rE�ε)i�rE�ζ)i�rE�η)i�rE�θ)i�rErd)i�rE�κ)i�rE�λ)i�rEr�)i�rE�ν)i�rE�ξ)i�rE�ο)i�rE�π)i�rE�ρ)i�r�)i�rE�σ)i�rE�τ)i�rE�υ)i�rE�φ)i�rE�χ)i�rE�ψ)i�rE�ω)i�rEuϊ)i�rE�ϋ)i�r0)i�r(r)i�r0)i�rEuϗ)i�rErq)i�rErw)i�rEr�)i�rErn)i�rEr�)i�rEr�)i�rEr})i�r0)i�rEuϙ)i�r0)i�rEuϛ)i�r0)i�rE�ϝ)i�r0)i�rEuϟ)i�r0)i�rEuϡ)i�r0)i�rEuϣ)i�r0)i�rEuϥ)i�r0)i�rEuϧ)i�r0)i�rEuϩ)i�r0)i�rEuϫ)i�r0)i�rEuϭ)i�r0)i�rEuϯ)i�r0)i�rErx)i�rEr~)i�rEr)i�r0)i�rErw)i�rErt)i�r0)i�rEuϸ)i�r0)i�rEr)i�rEuϻ)i�r0)i�rEuͻ)i�rEuͼ)i�rEuͽ)irEuѐ)irEuё)irEuђr�r�r�r�r��_seg_6xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)irEuѓ)irEuє)irEuѕ)irEuі)irEuї)irEuј)i	rEuљ)i
rEuњ)irEuћ)irEuќ)i
rEuѝ)irEuў)irEuџ)irEuа)irEuб)irE�в)irEuг)irE�д)irEuе)irEuж)irEuз)irEuи)irEuй)irEuк)irEuл)irEuм)irE�н)irE�о)irEuп)i rEuр)i!rE�с)i"rE�т)i#rEuу)i$rEuф)i%rEuх)i&rEuц)i'rEuч)i(rEuш)i)rEuщ)i*rE�ъ)i+rEuы)i,rE�ь)i-rEuэ)i.rEuю)i/rEuя)i0r0)i`rEuѡ)iar0)ibrE�ѣ)icr0)idrEuѥ)ier0)ifrEuѧ)igr0)ihrEuѩ)iir0)ijrEuѫ)ikr0)ilrEuѭ)imr0)inrEuѯ)ior0)iprEuѱ)iqr0)irrEuѳ)isr0)itrEuѵ)iur0)ivrEuѷ)iwr0)ixrEuѹ)iyr0)izrEuѻ)i{r0)i|rEuѽ)i}r0)i~rEuѿ)ir0)i�rEuҁ)i�r0)i�rEuҋ)i�r0)i�rEuҍ)i�r0)i�rEuҏ)i�r0)i�rEuґ)i�r0)i�rEuғ)i�r0)i�rEuҕ)i�r0)i�rEuҗ)i�r0)i�rEuҙ)i�r0)i�rEuқ)i�r0)i�rEuҝ)i�r0r�r�r�r�r��_seg_7�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEuҟ)i�r0)i�rEuҡ)i�r0)i�rEuң)i�r0)i�rEuҥ)i�r0)i�rEuҧ)i�r0)i�rEuҩ)i�r0)i�rEuҫ)i�r0)i�rEuҭ)i�r0)i�rEuү)i�r0)i�rEuұ)i�r0)i�rEuҳ)i�r0)i�rEuҵ)i�r0)i�rEuҷ)i�r0)i�rEuҹ)i�r0)i�rEuһ)i�r0)i�rEuҽ)i�r0)i�rEuҿ)i�r0)i�r�)i�rEuӂ)i�r0)i�rEuӄ)i�r0)i�rEuӆ)i�r0)i�rEuӈ)i�r0)i�rEuӊ)i�r0)i�rEuӌ)i�r0)i�rEuӎ)i�r0)i�rEuӑ)i�r0)i�rEuӓ)i�r0)i�rEuӕ)i�r0)i�rEuӗ)i�r0)i�rEuә)i�r0)i�rEuӛ)i�r0)i�rEuӝ)i�r0)i�rEuӟ)i�r0)i�rEuӡ)i�r0)i�rEuӣ)i�r0)i�rEuӥ)i�r0)i�rEuӧ)i�r0)i�rEuө)i�r0)i�rEuӫ)i�r0)i�rEuӭ)i�r0)i�rEuӯ)i�r0)i�rEuӱ)i�r0)i�rEuӳ)i�r0)i�rEuӵ)i�r0)i�rEuӷ)i�r0)i�rEuӹ)i�r0)i�rEuӻ)i�r0)i�rEuӽ)i�r0)i�rEuӿ)i�r0)irEuԁ)ir0)irEuԃr�r�r�r�r��_seg_8Hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ir0)irEuԅ)ir0)irEuԇ)ir0)irEuԉ)i	r0)i
rEuԋ)ir0)irEuԍ)i
r0)irEuԏ)ir0)irEuԑ)ir0)irEuԓ)ir0)irEuԕ)ir0)irEuԗ)ir0)irEuԙ)ir0)irEuԛ)ir0)irEuԝ)ir0)irEuԟ)ir0)i rEuԡ)i!r0)i"rEuԣ)i#r0)i$rEuԥ)i%r0)i&rEuԧ)i'r0)i(rEuԩ)i)r0)i*rEuԫ)i+r0)i,rEuԭ)i-r0)i.rEuԯ)i/r0)i0r�)i1rEuա)i2rEuբ)i3rEuգ)i4rEuդ)i5rEuե)i6rEuզ)i7rEuէ)i8rEuը)i9rEuթ)i:rEuժ)i;rEuի)i<rEuլ)i=rEuխ)i>rEuծ)i?rEuկ)i@rEuհ)iArEuձ)iBrEuղ)iCrEuճ)iDrEuմ)iErEuյ)iFrEuն)iGrEuշ)iHrEuո)iIrEuչ)iJrEuպ)iKrEuջ)iLrEuռ)iMrEuս)iNrEuվ)iOrEuտ)iPrEuր)iQrEuց)iRrEuւ)iSrEuփ)iTrEuք)iUrEuօ)iVrEuֆ)iWr�)iYr0)i�rEuեւ)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0r�r�r�r�r��_seg_9�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iurEuاٴ)ivrEuوٴ)iwrE�ۇٴ)ixrEuيٴ)iyr0)i�r�)i�r0)ir�)ir0)iKr�)iMr0)i�r�)i�r0)i�r�)i�r0)i.r�)i0r0)i?r�)i@r0)i\r�)i^r0)i_r�)i`r0)ikr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)iX	rEuक़)iY	rEuख़)iZ	rEuग़)i[	rEuज़)i\	rEuड़)i]	rEuढ़)i^	rEuफ़)i_	rEuय़)i`	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	rEuড়)i�	rEuঢ়)i�	r�)i�	rEuয়)i�	r0)i�	r�)i�	r0)i�	r�)i
r0)i
r�)i
r0)i
r�)i
r0)i
r�)i
r0)i)
r�)i*
r0)i1
r�)i2
r0)i3
rEuਲ਼)i4
r�)i5
r0)i6
rEuਸ਼)i7
r�)i8
r0)i:
r�)i<
r0)i=
r�)i>
r0)iC
r�)iG
r0)iI
r�)iK
r0)iN
r�)iQ
r0)iR
r�)iY
rEuਖ਼)iZ
rEuਗ਼)i[
rEuਜ਼r�r�r�r�r��_seg_10s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i\
r0)i]
r�)i^
rEuਫ਼)i_
r�)if
r0)iw
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)ir�)ir0)ir�)ir0)i
r�)ir0)ir�)ir0)i)r�)i*r0)i1r�)i2r0)i4r�)i5r0)i:r�)i<r0)iEr�)iGr0)iIr�)iKr0)iNr�)iVr0)iXr�)i\rEuଡ଼)i]rEuଢ଼)i^r�)i_r0)idr�)ifr0)ixr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i
r�)ir0)ir�)ir0r�r�r�r�r��_seg_11�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i)r�)i*r0)i:r�)i=r0)iEr�)iFr0)iIr�)iJr0)iNr�)iUr0)iWr�)iXr0)i[r�)i`r0)idr�)ifr0)ipr�)ixr0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i
r0)i
r�)i
r0)i

r�)i
r0)i
r�)i
r0)iE
r�)iF
r0)iI
r�)iJ
r0)iP
r�)iT
r0)id
r�)if
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)ir0)i3rEuํา)i4r0)i;r�)i?r0)i\r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0r�r�r�r�r��_seg_12�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�rEuໍາ)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�rEuຫນ)i�rEuຫມ)i�r0)i�r�)ir0)irEu་)i
r0)iCrEuགྷ)iDr0)iHr�)iIr0)iMrEuཌྷ)iNr0)iRrEuདྷ)iSr0)iWrEuབྷ)iXr0)i\rEuཛྷ)i]r0)iirEuཀྵ)ijr0)imr�)iqr0)isrEuཱི)itr0)iurEuཱུ)ivrEuྲྀ)iwrEu	ྲཱྀ)ixrEuླྀ)iyrEu	ླཱྀ)izr0)i�rEuཱྀ)i�r0)i�rEuྒྷ)i�r0)i�r�)i�r0)i�rEuྜྷ)i�r0)i�rEuྡྷ)i�r0)i�rEuྦྷ)i�r0)i�rEuྫྷ)i�r0)i�rEuྐྵ)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i�r�)i�rEuⴧ)i�r�)i�rEuⴭ)i�r�)i�r0)i�rEuნ)i�r0)i_r�)iar0)iIr�)iJr0)iNr�)iPr0)iWr�)iXr0)iYr�)iZr0)i^r�)i`r0)i�r�)i�r0r�r�r�r�r��_seg_13Ps��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)ir�)ir0)ir�)ir0)i[r�)i]r0)i}r�)i�r0)i�r�)i�r0)i�r�)i�rEuᏰ)i�rEuᏱ)i�rEuᏲ)i�rEuᏳ)i�rEuᏴ)i�rEuᏵ)i�r�)ir0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i
r�)ir0)ir�)i r0)i7r�)i@r0)iTr�)i`r0)imr�)inr0)iqr�)irr0)itr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)ir�)ir�)ir0)ir�)i r0)iyr�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)i r0)i,r�)i0r0)i<r�)i@r0)iAr�)iDr0)inr�)ipr0)iur�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)ir�)ir0)i_r�)i`r0)i}r�)ir0)i�r�)i�r0r�r�r�r�r��_seg_14�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)iLr�)iPr0)i}r�)i�r0)i�r�)i�r0)i8r�)i;r0)iJr�)iMr0)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ꙋ)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i,rErF)i-rEr�)i.rErH)i/r0)i0rErL)i1rErN)i2rErQ)i3rErR)i4rErT)i5rErV)i6rErX)i7rErZ)i8rEr\)i9rEr^)i:rEr`)i;r0)i<rErb)i=rEr`)i>rErd)i?rErh)i@rErl)iArErn)iBrErr)iCrErF)iDrE�ɐ)iErE�ɑ)iFrEuᴂ)iGrErH)iHrErL)iIrErN)iJrErR)iKrErS)iLrE�ɜ)iMrErR)iNr0)iOrErZ)iPrEr^)iQrErM)iRrErb)iSrErP)iTrEuᴖ)iUrEuᴗ)iVrErd)iWrErl)iXrErn)iYrEuᴝ)iZrErX)i[rErp)i\rEuᴥ)i]rErq)i^rErr)i_rErs)i`rEr�)iarEr�)ibrErV)icrErh)idrErn)ierErp)ifrErq)igrErr)ihrEr~)iirEr�)ijrEr�)ikr0)ixrEr�)iyr0)i�rE�ɒ)i�rErJ)i�rEuɕ)i�rErr�r�r�r�r��_seg_15 s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEr�)i�rErP)i�rEuɟ)i�rE�ɡ)i�rE�ɥ)i�rErW)i�rErV)i�rE�ɪ)i�rEuᵻ)i�rE�ʝ)i�rEuɭ)i�rEuᶅ)i�rEuʟ)i�rE�ɱ)i�rEuɰ)i�rErY)i�rEuɳ)i�rEuɴ)i�rErZ)i�rEuɸ)i�rEuʂ)i�rEr[)i�rEuƫ)i�rEra)i�rEr\)i�rEuᴜ)i�rEr])i�rErb)i�rErx)i�rEuʐ)i�rEuʑ)i�rEr^)i�rErw)i�r0)i�r�)i�r0)irEuḁ)ir0)irEuḃ)ir0)irEuḅ)ir0)irEuḇ)ir0)irEuḉ)i	r0)i
rEuḋ)ir0)irEuḍ)i
r0)irEuḏ)ir0)irEuḑ)ir0)irEuḓ)ir0)irEuḕ)ir0)irEuḗ)ir0)irEuḙ)ir0)irEuḛ)ir0)irEuḝ)ir0)irEuḟ)ir0)i rEuḡ)i!r0)i"rEuḣ)i#r0)i$rEuḥ)i%r0)i&rEuḧ)i'r0)i(rEuḩ)i)r0)i*rEuḫ)i+r0)i,rEuḭ)i-r0)i.rEuḯ)i/r0)i0rEuḱ)i1r0)i2rEuḳ)i3r0)i4rEuḵ)i5r0)i6rEuḷ)i7r0)i8rEuḹ)i9r0)i:rEuḻ)i;r0)i<rEuḽ)i=r0)i>rEuḿ)i?r0r�r�r�r�r��_seg_16�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i@rEuṁ)iAr0)iBrEuṃ)iCr0)iDrEuṅ)iEr0)iFrEuṇ)iGr0)iHrEuṉ)iIr0)iJrEuṋ)iKr0)iLrEuṍ)iMr0)iNrEuṏ)iOr0)iPrEuṑ)iQr0)iRrEuṓ)iSr0)iTrEuṕ)iUr0)iVrEuṗ)iWr0)iXrEuṙ)iYr0)iZrEuṛ)i[r0)i\rEuṝ)i]r0)i^rEuṟ)i_r0)i`rE�ṡ)iar0)ibrEuṣ)icr0)idrEuṥ)ier0)ifrEuṧ)igr0)ihrEuṩ)iir0)ijrEuṫ)ikr0)ilrEuṭ)imr0)inrEuṯ)ior0)iprEuṱ)iqr0)irrEuṳ)isr0)itrEuṵ)iur0)ivrEuṷ)iwr0)ixrEuṹ)iyr0)izrEuṻ)i{r0)i|rEuṽ)i}r0)i~rEuṿ)ir0)i�rEuẁ)i�r0)i�rEuẃ)i�r0)i�rEuẅ)i�r0)i�rEuẇ)i�r0)i�rEuẉ)i�r0)i�rEuẋ)i�r0)i�rEuẍ)i�r0)i�rEuẏ)i�r0)i�rEuẑ)i�r0)i�rEuẓ)i�r0)i�rEuẕ)i�r0)i�rEuaʾ)i�rEr�)i�r0)i�rEr))i�r0)i�rEuạ)i�r0)i�rEuả)i�r0)i�rEuấ)i�r0)i�rEuầ)i�r0)i�rEuẩr�r�r�r�r��_seg_17�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r0)i�rEuẫ)i�r0)i�rEuậ)i�r0)i�rEuắ)i�r0)i�rEuằ)i�r0)i�rEuẳ)i�r0)i�rEuẵ)i�r0)i�rEuặ)i�r0)i�rEuẹ)i�r0)i�rEuẻ)i�r0)i�rEuẽ)i�r0)i�rEuế)i�r0)i�rEuề)i�r0)i�rEuể)i�r0)i�rEuễ)i�r0)i�rEuệ)i�r0)i�rEuỉ)i�r0)i�rEuị)i�r0)i�rEuọ)i�r0)i�rEuỏ)i�r0)i�rEuố)i�r0)i�rEuồ)i�r0)i�rEuổ)i�r0)i�rEuỗ)i�r0)i�rEuộ)i�r0)i�rEuớ)i�r0)i�rEuờ)i�r0)i�rEuở)i�r0)i�rEuỡ)i�r0)i�rEuợ)i�r0)i�rEuụ)i�r0)i�rEuủ)i�r0)i�rEuứ)i�r0)i�rEuừ)i�r0)i�rEuử)i�r0)i�rEuữ)i�r0)i�rEuự)i�r0)i�rEuỳ)i�r0)i�rEuỵ)i�r0)i�rEuỷ)i�r0)i�rEuỹ)i�r0)i�rEuỻ)i�r0)i�rEuỽ)i�r0)i�rEuỿ)i�r0)irEuἀ)i	rEuἁ)i
rEuἂ)irEuἃ)irEuἄ)i
rEuἅ)irEuἆ)irEuἇ)ir0)ir�)irEuἐ)irEuἑ)irEuἒr�r�r�r�r��_seg_18Xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)irEuἓ)irEuἔ)irEuἕ)ir�)i r0)i(rEuἠ)i)rEuἡ)i*rEuἢ)i+rEuἣ)i,rEuἤ)i-rEuἥ)i.rEuἦ)i/rEuἧ)i0r0)i8rEuἰ)i9rEuἱ)i:rEuἲ)i;rEuἳ)i<rEuἴ)i=rEuἵ)i>rEuἶ)i?rEuἷ)i@r0)iFr�)iHrEuὀ)iIrEuὁ)iJrEuὂ)iKrEuὃ)iLrEuὄ)iMrEuὅ)iNr�)iPr0)iXr�)iYrEuὑ)iZr�)i[rEuὓ)i\r�)i]rEuὕ)i^r�)i_rEuὗ)i`r0)ihrEuὠ)iirEuὡ)ijrEuὢ)ikrEuὣ)ilrEuὤ)imrEuὥ)inrEuὦ)iorEuὧ)ipr0)iqrErh)irr0)isrErj)itr0)iurErk)ivr0)iwrErl)ixr0)iyrErm)izr0)i{rErn)i|r0)i}rEro)i~r�)i�rE�ἀι)i�rE�ἁι)i�rE�ἂι)i�rE�ἃι)i�rE�ἄι)i�rE�ἅι)i�rE�ἆι)i�rE�ἇι)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ἠι)i�rE�ἡι)i�rE�ἢι)i�rE�ἣι)i�rE�ἤι)i�rE�ἥι)i�rE�ἦι)i�rE�ἧι)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ὠι)i�rE�ὡι)i�rE�ὢι)i�rE�ὣιr�r�r�r�r��_seg_19�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rE�ὤι)i�rE�ὥι)i�rE�ὦι)i�rE�ὧι)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�r0)i�rEuὰι)i�rE�αι)i�rEuάι)i�r�)i�r0)i�rEuᾶι)i�rEuᾰ)i�rEuᾱ)i�rEuὰ)i�rErh)i�rEr�)i�r� ̓)i�rErd)i�rr�)i�ru ͂)i�ru ̈͂)i�rEuὴι)i�rE�ηι)i�rEuήι)i�r�)i�r0)i�rEuῆι)i�rEuὲ)i�rErj)i�rEuὴ)i�rErk)i�rEr�)i�ru ̓̀)i�ru ̓́)i�ru ̓͂)i�r0)i�rEuΐ)i�r�)i�r0)i�rEuῐ)i�rEuῑ)i�rEuὶ)i�rErl)i�r�)i�ru ̔̀)i�ru ̔́)i�ru ̔͂)i�r0)i�rEuΰ)i�r0)i�rEuῠ)i�rEuῡ)i�rEuὺ)i�rErn)i�rEuῥ)i�ru ̈̀)i�rrg)i�r�`)i�r�)i�rEuὼι)i�rE�ωι)i�rEuώι)i�r�)i�r0)i�rEuῶι)i�rEuὸ)i�rErm)i�rEuὼ)i�rEro)i�rEr�)i�rr�)i�ru ̔)i�r�)i rr�)i r�)i r(�)i r�)i r0)i rEu‐)i r0)i ru ̳)i r0)i$ r�)i' r0)i( r�)i/ rr�)i0 r0)i3 rEu′′)i4 rEu	′′′)i5 r0)i6 rEu‵‵)i7 rEu	‵‵‵r�r�r�r�r��_seg_20(s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i8 r0)i< rz!!)i= r0)i> r� ̅)i? r0)iG rz??)iH rz?!)iI rz!?)iJ r0)iW rEu′′′′)iX r0)i_ rr�)i` r�)ia r�)id r�)ie r�)ip rE�0)iq rErV)ir r�)it rE�4)iu rE�5)iv rE�6)iw rE�7)ix rE�8)iy rE�9)iz r�+)i{ rE�−)i| r�=)i} r�()i~ r�))i rEr`)i� rEr�)i� rEr�)i� rEr�)i� rEr)i� rEr�)i� rEr�)i� rEr�)i� rEr�)i� rEr�)i� rEr�)i� rr�)i� rEr�)i� rr�)i� rr�)i� rr�)i� r�)i� rErF)i� rErN)i� rErb)i� rErt)i� rErR)i� rErT)i� rErZ)i� rEr\)i� rEr^)i� rEr`)i� rErd)i� rErj)i� rErl)i� r�)i� r0)i� rEZrs)i� r0)i� r�)i� r0)i� r�)i!rza/c)i!rza/s)i!rErJ)i!rEu°c)i!r0)i!rzc/o)i!rzc/u)i!rErS)i!r0)i	!rEu°f)i
!rErR)i!rErT)i!rErK)i!rErV)i!rEr\)i!r0)i!rEr`)i!rEZno)i!r0)i!rErd)i!rErf)i!rErh)i!r0)i !rEZsm)i!!rEZtel)i"!rEZtm)i#!r0)i$!rErx)i%!r0)i&!rEr�)i'!r0)i(!rErx)i)!r0r�r�r�r�r��_seg_21�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i*!rErZ)i+!rEr�)i,!rErH)i-!rErJ)i.!r0)i/!rErN)i1!rErP)i2!r�)i3!rEr^)i4!rErb)i5!rE�א)i6!rEuב)i7!rEuג)i8!rE�ד)i9!rErV)i:!r0)i;!rEZfax)i<!rEr})i=!rErr)i?!rEr})i@!rEu∑)iA!r0)iE!rErL)iG!rErN)iH!rErV)iI!rErX)iJ!r0)iP!rEu1⁄7)iQ!rEu1⁄9)iR!rEu1⁄10)iS!rEu1⁄3)iT!rEu2⁄3)iU!rEu1⁄5)iV!rEu2⁄5)iW!rEu3⁄5)iX!rEu4⁄5)iY!rEu1⁄6)iZ!rEu5⁄6)i[!rEu1⁄8)i\!rEu3⁄8)i]!rEu5⁄8)i^!rEu7⁄8)i_!rEu1⁄)i`!rErV)ia!rE�ii)ib!rE�iii)ic!rE�iv)id!rErp)ie!rE�vi)if!rE�vii)ig!rE�viii)ih!rE�ix)ii!rErt)ij!rE�xi)ik!rE�xii)il!rEr\)im!rErJ)in!rErL)io!rEr^)ip!rErV)iq!rEr�)ir!rEr�)is!rEr�)it!rErp)iu!rEr�)iv!rEr�)iw!rEr�)ix!rEr�)iy!rErt)iz!rEr�)i{!rEr�)i|!rEr\)i}!rErJ)i~!rErL)i!rEr^)i�!r0)i�!r�)i�!r0)i�!rEu0⁄3)i�!r0)i�!r�)i�!r0)i,"rEu∫∫)i-"rEu	∫∫∫)i."r0)i/"rEu∮∮)i0"rEu	∮∮∮)i1"r0)i`"r)ia"r0)in"r)ip"r0)i)#rE�〈)i*#rE�〉)i+#r0)i'$r�)i@$r0)iK$r�)i`$rEr�)ia$rEr�r�r�r�r�r��_seg_22�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ib$rEr)ic$rEr�)id$rEr�)ie$rEr�)if$rEr�)ig$rEr�)ih$rEr�)ii$rEZ10)ij$rEZ11)ik$rEZ12)il$rEZ13)im$rEZ14)in$rEZ15)io$rEZ16)ip$rEZ17)iq$rEZ18)ir$rEZ19)is$rEZ20)it$rz(1))iu$rz(2))iv$rz(3))iw$rz(4))ix$rz(5))iy$rz(6))iz$rz(7))i{$rz(8))i|$rz(9))i}$rz(10))i~$rz(11))i$rz(12))i�$rz(13))i�$rz(14))i�$rz(15))i�$rz(16))i�$rz(17))i�$rz(18))i�$rz(19))i�$rz(20))i�$r�)i�$r�(a))i�$r�(b))i�$r�(c))i�$r�(d))i�$r�(e))i�$r�(f))i�$r�(g))i�$r�(h))i�$r�(i))i�$r�(j))i�$r�(k))i�$r�(l))i�$r�(m))i�$r�(n))i�$r�(o))i�$r�(p))i�$r�(q))i�$r�(r))i�$r�(s))i�$r�(t))i�$r�(u))i�$r�(v))i�$r�(w))i�$r�(x))i�$r�(y))i�$r�(z))i�$rErF)i�$rErH)i�$rErJ)i�$rErL)i�$rErN)i�$rErP)i�$rErR)i�$rErT)i�$rErV)i�$rErX)i�$rErZ)i�$rEr\)i�$rEr^)i�$rEr`)i�$rErb)i�$rErd)i�$rErf)i�$rErh)i�$rErj)i�$rErl)i�$rErn)i�$rErp)i�$rErr)i�$rErt)i�$rErv)i�$rErx)i�$rErF)i�$rErH)i�$rErJ)i�$rErL)i�$rErN)i�$rErP)i�$rErR)i�$rErT)i�$rErVr�r�r�r�r��_seg_23`	s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�$rErX)i�$rErZ)i�$rEr\)i�$rEr^)i�$rEr`)i�$rErb)i�$rErd)i�$rErf)i�$rErh)i�$rErj)i�$rErl)i�$rErn)i�$rErp)i�$rErr)i�$rErt)i�$rErv)i�$rErx)i�$rEr�)i�$r0)i*rEu∫∫∫∫)i
*r0)it*rz::=)iu*rz==)iv*rz===)iw*r0)i�*rEu⫝̸)i�*r0)it+r�)iv+r0)i�+r�)i�+r0)i�+r�)i�+r0)i�+r�)i,rEuⰰ)i,rEuⰱ)i,rEuⰲ)i,rEuⰳ)i,rEuⰴ)i,rEuⰵ)i,rEuⰶ)i,rEuⰷ)i,rEuⰸ)i	,rEuⰹ)i
,rEuⰺ)i,rEuⰻ)i,rEuⰼ)i
,rEuⰽ)i,rEuⰾ)i,rEuⰿ)i,rEuⱀ)i,rEuⱁ)i,rEuⱂ)i,rEuⱃ)i,rEuⱄ)i,rEuⱅ)i,rEuⱆ)i,rEuⱇ)i,rEuⱈ)i,rEuⱉ)i,rEuⱊ)i,rEuⱋ)i,rEuⱌ)i,rEuⱍ)i,rEuⱎ)i,rEuⱏ)i ,rEuⱐ)i!,rEuⱑ)i",rEuⱒ)i#,rEuⱓ)i$,rEuⱔ)i%,rEuⱕ)i&,rEuⱖ)i',rEuⱗ)i(,rEuⱘ)i),rEuⱙ)i*,rEuⱚ)i+,rEuⱛ)i,,rEuⱜ)i-,rEuⱝ)i.,rEuⱞ)i/,r�)i0,r0)i_,r�)i`,rEuⱡ)ia,r0)ib,rE�ɫ)ic,rEuᵽ)id,rEuɽ)ie,r0)ig,rEuⱨ)ih,r0)ii,rEuⱪ)ij,r0)ik,rEuⱬ)il,r0)im,rEr�)in,rEr�)io,rEr�)ip,rEr�r�r�r�r�r��_seg_24�	s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iq,r0)ir,rEuⱳ)is,r0)iu,rEuⱶ)iv,r0)i|,rErX)i},rErp)i~,rEuȿ)i,rEuɀ)i�,rEuⲁ)i�,r0)i�,rEuⲃ)i�,r0)i�,rEuⲅ)i�,r0)i�,rEuⲇ)i�,r0)i�,rEuⲉ)i�,r0)i�,rEuⲋ)i�,r0)i�,rEuⲍ)i�,r0)i�,rEuⲏ)i�,r0)i�,rEuⲑ)i�,r0)i�,rEuⲓ)i�,r0)i�,rEuⲕ)i�,r0)i�,rEuⲗ)i�,r0)i�,rEuⲙ)i�,r0)i�,rEuⲛ)i�,r0)i�,rEuⲝ)i�,r0)i�,rEuⲟ)i�,r0)i�,rEuⲡ)i�,r0)i�,rEuⲣ)i�,r0)i�,rEuⲥ)i�,r0)i�,rEuⲧ)i�,r0)i�,rEuⲩ)i�,r0)i�,rEuⲫ)i�,r0)i�,rEuⲭ)i�,r0)i�,rEuⲯ)i�,r0)i�,rEuⲱ)i�,r0)i�,rEuⲳ)i�,r0)i�,rEuⲵ)i�,r0)i�,rEuⲷ)i�,r0)i�,rEuⲹ)i�,r0)i�,rEuⲻ)i�,r0)i�,rEuⲽ)i�,r0)i�,rEuⲿ)i�,r0)i�,rEuⳁ)i�,r0)i�,rEuⳃ)i�,r0)i�,rEuⳅ)i�,r0)i�,rEuⳇ)i�,r0)i�,rEuⳉ)i�,r0)i�,rEuⳋ)i�,r0)i�,rEuⳍ)i�,r0)i�,rEuⳏ)i�,r0)i�,rEuⳑ)i�,r0)i�,rEuⳓ)i�,r0)i�,rEuⳕ)i�,r0)i�,rEuⳗ)i�,r0)i�,rEuⳙ)i�,r0)i�,rEuⳛr�r�r�r�r��_seg_250
s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�,r0)i�,rEuⳝ)i�,r0)i�,rEuⳟ)i�,r0)i�,rEuⳡ)i�,r0)i�,rEuⳣ)i�,r0)i�,rEuⳬ)i�,r0)i�,rEuⳮ)i�,r0)i�,rEuⳳ)i�,r0)i�,r�)i�,r0)i&-r�)i'-r0)i(-r�)i--r0)i.-r�)i0-r0)ih-r�)io-rEuⵡ)ip-r0)iq-r�)i-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)i�-r�)i�-r0)iO.r�)i�.r0)i�.r�)i�.r0)i�.rEu母)i�.r0)i�.rEu龟)i�.r�)i/rE�一)i/rEu丨)i/rEu丶)i/rEu丿)i/rE�乙)i/rEu亅)i/rE�二)i/rEu亠)i/rE�人)i	/rEu儿)i
/rEu入)i/rE�八)i/rEu冂)i
/rEu冖)i/rEu冫)i/rEu几)i/rE�凵)i/rEu刀)i/rE�力)i/rEu勹)i/rEu匕)i/rEu匚)i/rEu匸)i/rE�十)i/rEu卜)i/rEu卩)i/rEu厂)i/rEu厶)i/rEu又)i/rEu口)i/rEu囗)i/rE�土)i /rEu士)i!/rEu夂)i"/rEu夊)i#/rEu夕)i$/rEu大)i%/rE�女)i&/rEu子)i'/rEu宀)i(/rEu寸)i)/rEu小)i*/rE�尢)i+/rEu尸)i,/rE�屮)i-/rEu山r�r�r�r�r��_seg_26�
s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i./rEu巛)i//rEu工)i0/rEu己)i1/rEu巾)i2/rEu干)i3/rEu幺)i4/rEu广)i5/rEu廴)i6/rE�廾)i7/rEu弋)i8/rEu弓)i9/rEu彐)i:/rEu彡)i;/rEu彳)i</rEu心)i=/rEu戈)i>/rEu戶)i?/rE�手)i@/rEu支)iA/rEu攴)iB/rE�文)iC/rEu斗)iD/rEu斤)iE/rEu方)iF/rEu无)iG/rE�日)iH/rEu曰)iI/rE�月)iJ/rE�木)iK/rEu欠)iL/rEu止)iM/rE�歹)iN/rEu殳)iO/rEu毋)iP/rEu比)iQ/rEu毛)iR/rEu氏)iS/rEu气)iT/rE�水)iU/rE�火)iV/rEu爪)iW/rEu父)iX/rEu爻)iY/rEu爿)iZ/rEu片)i[/rEu牙)i\/rEu牛)i]/rEu犬)i^/rEu玄)i_/rEu玉)i`/rEu瓜)ia/rEu瓦)ib/rEu甘)ic/rE�生)id/rEu用)ie/rEu田)if/rEu疋)ig/rEu疒)ih/rEu癶)ii/rEu白)ij/rEu皮)ik/rEu皿)il/rEu目)im/rEu矛)in/rEu矢)io/rEu石)ip/rEu示)iq/rEu禸)ir/rEu禾)is/rEu穴)it/rE�立)iu/rEu竹)iv/rEu米)iw/rEu糸)ix/rEu缶)iy/rEu网)iz/rEu羊)i{/rE�羽)i|/rE�老)i}/rEu而)i~/rEu耒)i/rEu耳)i�/rEu聿)i�/rEu肉)i�/rEu臣)i�/rEu自)i�/rEu至)i�/rEu臼)i�/rEu舌)i�/rEu舛)i�/rEu舟)i�/rEu艮)i�/rEu色)i�/rEu艸)i�/rEu虍)i�/rEu虫)i�/rEu血)i�/rE�行)i�/rE�衣)i�/rEu襾r�r�r�r�r��_seg_27s��r cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�/rE�見)i�/rEu角)i�/rEu言)i�/rEu谷)i�/rEu豆)i�/rE�豕)i�/rEu豸)i�/rEu貝)i�/rEu赤)i�/rE�走)i�/rEu足)i�/rEu身)i�/rE�車)i�/rEu辛)i�/rE�辰)i�/rEu辵)i�/rEu邑)i�/rEu酉)i�/rEu釆)i�/rE�里)i�/rE�金)i�/rEu長)i�/rEu門)i�/rEu阜)i�/rEu隶)i�/rEu隹)i�/rEu雨)i�/rEu靑)i�/rEu非)i�/rEu面)i�/rEu革)i�/rEu韋)i�/rEu韭)i�/rEu音)i�/rEu頁)i�/rEu風)i�/rEu飛)i�/rEu食)i�/rEu首)i�/rEu香)i�/rEu馬)i�/rEu骨)i�/rEu高)i�/rEu髟)i�/rEu鬥)i�/rEu鬯)i�/rEu鬲)i�/rEu鬼)i�/rEu魚)i�/rEu鳥)i�/rEu鹵)i�/rE�鹿)i�/rEu麥)i�/rE�麻)i�/rEu黃)i�/rEu黍)i�/rEu黑)i�/rE�黹)i�/rEu黽)i�/rEu鼎)i�/rEu鼓)i�/rEu鼠)i�/rE�鼻)i�/rEu齊)i�/rEu齒)i�/rE�龍)i�/rE�龜)i�/rEu龠)i�/r�)i0rr�)i0r0)i0rE�.)i0r0)i60rEu〒)i70r0)i80rEr)i90rEu卄)i:0rEu卅)i;0r0)i@0r�)iA0r0)i�0r�)i�0r0)i�0ru ゙)i�0ru ゚)i�0r0)i�0rEuより)i�0r0)i�0rEuコト)i1r�)i1r0)i01r�)i11rE�ᄀ)i21rE�ᄁ)i31rE�ᆪ)i41rE�ᄂ)i51rE�ᆬ)i61rE�ᆭ)i71rE�ᄃ)i81rE�ᄄr�r�r�r�r��_seg_28hs��r7cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i91rE�ᄅ)i:1rE�ᆰ)i;1rE�ᆱ)i<1rE�ᆲ)i=1rE�ᆳ)i>1rE�ᆴ)i?1rE�ᆵ)i@1rE�ᄚ)iA1rE�ᄆ)iB1rE�ᄇ)iC1rE�ᄈ)iD1rE�ᄡ)iE1rE�ᄉ)iF1rE�ᄊ)iG1rE�ᄋ)iH1rE�ᄌ)iI1rE�ᄍ)iJ1rE�ᄎ)iK1rE�ᄏ)iL1rE�ᄐ)iM1rE�ᄑ)iN1rE�ᄒ)iO1rE�ᅡ)iP1rE�ᅢ)iQ1rE�ᅣ)iR1rE�ᅤ)iS1rE�ᅥ)iT1rE�ᅦ)iU1rE�ᅧ)iV1rE�ᅨ)iW1rE�ᅩ)iX1rE�ᅪ)iY1rE�ᅫ)iZ1rE�ᅬ)i[1rE�ᅭ)i\1rE�ᅮ)i]1rE�ᅯ)i^1rE�ᅰ)i_1rE�ᅱ)i`1rE�ᅲ)ia1rE�ᅳ)ib1rE�ᅴ)ic1rE�ᅵ)id1r�)ie1rEuᄔ)if1rEuᄕ)ig1rEuᇇ)ih1rEuᇈ)ii1rEuᇌ)ij1rEuᇎ)ik1rEuᇓ)il1rEuᇗ)im1rEuᇙ)in1rEuᄜ)io1rEuᇝ)ip1rEuᇟ)iq1rEuᄝ)ir1rEuᄞ)is1rEuᄠ)it1rEuᄢ)iu1rEuᄣ)iv1rEuᄧ)iw1rEuᄩ)ix1rEuᄫ)iy1rEuᄬ)iz1rEuᄭ)i{1rEuᄮ)i|1rEuᄯ)i}1rEuᄲ)i~1rEuᄶ)i1rEuᅀ)i�1rEuᅇ)i�1rEuᅌ)i�1rEuᇱ)i�1rEuᇲ)i�1rEuᅗ)i�1rEuᅘ)i�1rEuᅙ)i�1rEuᆄ)i�1rEuᆅ)i�1rEuᆈ)i�1rEuᆑ)i�1rEuᆒ)i�1rEuᆔ)i�1rEuᆞ)i�1rEuᆡ)i�1r�)i�1r0)i�1rEr)i�1rEr)i�1rE�三)i�1rE�四)i�1rE�上)i�1rE�中)i�1rE�下)i�1rEu甲)i�1rEr)i�1rEu丙)i�1rEu丁)i�1rE�天r�r�r�r�r��_seg_29�s��ricdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�1rEu地)i�1rEr)i�1r0)i�1r�)i�1r0)i�1r�)i�1r0)i2ru(ᄀ))i2ru(ᄂ))i2ru(ᄃ))i2ru(ᄅ))i2ru(ᄆ))i2ru(ᄇ))i2ru(ᄉ))i2ru(ᄋ))i2ru(ᄌ))i	2ru(ᄎ))i
2ru(ᄏ))i2ru(ᄐ))i2ru(ᄑ))i
2ru(ᄒ))i2ru(가))i2ru(나))i2ru(다))i2ru(라))i2ru(마))i2ru(바))i2ru(사))i2ru(아))i2ru(자))i2ru(차))i2ru(카))i2ru(타))i2ru(파))i2ru(하))i2ru(주))i2ru(오전))i2ru(오후))i2r�)i 2ru(一))i!2ru(二))i"2ru(三))i#2ru(四))i$2ru(五))i%2ru(六))i&2ru(七))i'2ru(八))i(2ru(九))i)2ru(十))i*2ru(月))i+2ru(火))i,2ru(水))i-2ru(木))i.2ru(金))i/2ru(土))i02ru(日))i12ru(株))i22ru(有))i32ru(社))i42ru(名))i52ru(特))i62ru(財))i72ru(祝))i82ru(労))i92ru(代))i:2ru(呼))i;2ru(学))i<2ru(監))i=2ru(企))i>2ru(資))i?2ru(協))i@2ru(祭))iA2ru(休))iB2ru(自))iC2ru(至))iD2rEu問)iE2rEu幼)iF2rEr)iG2rEu箏)iH2r0)iP2rEZpte)iQ2rEZ21)iR2rEZ22)iS2rEZ23)iT2rEZ24)iU2rEZ25)iV2rEZ26)iW2rEZ27)iX2rEZ28)iY2rEZ29)iZ2rEZ30)i[2rEZ31)i\2rEZ32)i]2rEZ33)i^2rEZ34)i_2rEZ35)i`2rEr/)ia2rEr2)ib2rEr5)ic2rEr8r�r�r�r�r��_seg_308s��rjcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)id2rEr@)ie2rErA)if2rErD)ig2rErF)ih2rErG)ii2rErI)ij2rErJ)ik2rErK)il2rErL)im2rErM)in2rEu가)io2rEu나)ip2rEu다)iq2rEu라)ir2rEu마)is2rEu바)it2rEu사)iu2rEu아)iv2rEu자)iw2rEu차)ix2rEu카)iy2rEu타)iz2rEu파)i{2rEu하)i|2rEu참고)i}2rEu주의)i~2rEu우)i2r0)i�2rEr)i�2rEr)i�2rErc)i�2rErd)i�2rEu五)i�2rE�六)i�2rEu七)i�2rEr)i�2rEu九)i�2rEr)i�2rEr)i�2rEr)i�2rEr)i�2rEr)i�2rEr')i�2rEr)i�2rEr)i�2rEu株)i�2rE�有)i�2rE�社)i�2rEu名)i�2rEu特)i�2rEu財)i�2rE�祝)i�2rEu労)i�2rEu秘)i�2rEu男)i�2rEr
)i�2rEu適)i�2rEu優)i�2rEu印)i�2rEu注)i�2rEu項)i�2rEu休)i�2rEu写)i�2rEu正)i�2rEre)i�2rErf)i�2rErg)i�2rE�左)i�2rE�右)i�2rEu医)i�2rEu宗)i�2rEu学)i�2rEu監)i�2rEu企)i�2rEu資)i�2rEu協)i�2rEu夜)i�2rEZ36)i�2rEZ37)i�2rEZ38)i�2rEZ39)i�2rEZ40)i�2rEZ41)i�2rEZ42)i�2rEZ43)i�2rEZ44)i�2rEZ45)i�2rEZ46)i�2rEZ47)i�2rEZ48)i�2rEZ49)i�2rEZ50)i�2rEu1月)i�2rEu2月)i�2rEu3月)i�2rEu4月)i�2rEu5月)i�2rEu6月)i�2rEu7月)i�2rEu8月r�r�r�r�r��_seg_31�s��rqcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�2rEu9月)i�2rEu10月)i�2rEu11月)i�2rEu12月)i�2rEZhg)i�2rEZerg)i�2rEZev)i�2rEZltd)i�2rE�ア)i�2rE�イ)i�2rE�ウ)i�2rE�エ)i�2rE�オ)i�2rE�カ)i�2rE�キ)i�2rE�ク)i�2rE�ケ)i�2rE�コ)i�2rE�サ)i�2rE�シ)i�2rE�ス)i�2rE�セ)i�2rE�ソ)i�2rE�タ)i�2rE�チ)i�2rE�ツ)i�2rE�テ)i�2rE�ト)i�2rE�ナ)i�2rE�ニ)i�2rE�ヌ)i�2rE�ネ)i�2rE�ノ)i�2rE�ハ)i�2rE�ヒ)i�2rE�フ)i�2rE�ヘ)i�2rE�ホ)i�2rE�マ)i�2rE�ミ)i�2rE�ム)i�2rE�メ)i�2rE�モ)i�2rE�ヤ)i�2rE�ユ)i�2rE�ヨ)i�2rE�ラ)i�2rE�リ)i�2rE�ル)i�2rE�レ)i�2rE�ロ)i�2rE�ワ)i�2rEuヰ)i�2rEuヱ)i�2rE�ヲ)i�2r�)i3rEuアパート)i3rEuアルファ)i3rEuアンペア)i3rEu	アール)i3rEuイニング)i3rEu	インチ)i3rEu	ウォン)i3rEuエスクード)i3rEuエーカー)i	3rEu	オンス)i
3rEu	オーム)i3rEu	カイリ)i3rEuカラット)i
3rEuカロリー)i3rEu	ガロン)i3rEu	ガンマ)i3rEuギガ)i3rEu	ギニー)i3rEuキュリー)i3rEuギルダー)i3rEuキロ)i3rEuキログラム)i3rEuキロメートル)i3rEuキロワット)i3rEu	グラム)i3rEuグラムトン)i3rEuクルゼイロ)i3rEuクローネ)i3rEu	ケース)i3rEu	コルナ)i3rEu	コーポ)i3rEuサイクル)i 3rEuサンチーム)i!3rEuシリング)i"3rEu	センチ)i#3rEu	セント)i$3rEu	ダース)i%3rEuデシ)i&3rEuドル)i'3rEuトン)i(3rEuナノ)i)3rEu	ノット)i*3rEu	ハイツ)i+3rEuパーセントr�r�r�r�r��_seg_32
s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i,3rEu	パーツ)i-3rEuバーレル)i.3rEuピアストル)i/3rEu	ピクル)i03rEuピコ)i13rEuビル)i23rEuファラッド)i33rEuフィート)i43rEuブッシェル)i53rEu	フラン)i63rEuヘクタール)i73rEuペソ)i83rEu	ペニヒ)i93rEu	ヘルツ)i:3rEu	ペンス)i;3rEu	ページ)i<3rEu	ベータ)i=3rEuポイント)i>3rEu	ボルト)i?3rEuホン)i@3rEu	ポンド)iA3rEu	ホール)iB3rEu	ホーン)iC3rEuマイクロ)iD3rEu	マイル)iE3rEu	マッハ)iF3rEu	マルク)iG3rEuマンション)iH3rEuミクロン)iI3rEuミリ)iJ3rEuミリバール)iK3rEuメガ)iL3rEuメガトン)iM3rEuメートル)iN3rEu	ヤード)iO3rEu	ヤール)iP3rEu	ユアン)iQ3rEuリットル)iR3rEuリラ)iS3rEu	ルピー)iT3rEuルーブル)iU3rEuレム)iV3rEuレントゲン)iW3rEu	ワット)iX3rEu0点)iY3rEu1点)iZ3rEu2点)i[3rEu3点)i\3rEu4点)i]3rEu5点)i^3rEu6点)i_3rEu7点)i`3rEu8点)ia3rEu9点)ib3rEu10点)ic3rEu11点)id3rEu12点)ie3rEu13点)if3rEu14点)ig3rEu15点)ih3rEu16点)ii3rEu17点)ij3rEu18点)ik3rEu19点)il3rEu20点)im3rEu21点)in3rEu22点)io3rEu23点)ip3rEu24点)iq3rEZhpa)ir3rEZda)is3rEZau)it3rEZbar)iu3rEZov)iv3rEZpc)iw3rEZdm)ix3rEZdm2)iy3rEZdm3)iz3rEZiu)i{3rEu平成)i|3rEu昭和)i}3rEu大正)i~3rEu明治)i3rEu株式会社)i�3rE�pa)i�3rEZna)i�3rEuμa)i�3rEZma)i�3rEZka)i�3rEZkb)i�3rE�mb)i�3rEZgb)i�3rEZcal)i�3rEZkcal)i�3rEZpf)i�3rEZnf)i�3rEuμf)i�3rEuμg)i�3rEZmg)i�3rEZkgr�r�r�r�r��_seg_33p
s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�3rE�hz)i�3rEZkhz)i�3rEZmhz)i�3rEZghz)i�3rEZthz)i�3rEuμl)i�3rEZml)i�3rEZdl)i�3rEZkl)i�3rEZfm)i�3rEZnm)i�3rEuμm)i�3rEZmm)i�3rE�cm)i�3rE�km)i�3rEZmm2)i�3rEZcm2)i�3rEZm2)i�3rEZkm2)i�3rEZmm3)i�3rEZcm3)i�3rEZm3)i�3rEZkm3)i�3rEum∕s)i�3rEum∕s2)i�3rEr�)i�3rEZkpa)i�3rEZmpa)i�3rEZgpa)i�3rEZrad)i�3rEurad∕s)i�3rEurad∕s2)i�3rEZps)i�3rE�ns)i�3rEuμs)i�3rEZms)i�3rEZpv)i�3rEZnv)i�3rEuμv)i�3rE�mv)i�3rEZkv)i�3rEr�)i�3rEZpw)i�3rEZnw)i�3rEuμw)i�3rE�mw)i�3rE�kw)i�3rEr�)i�3rEukω)i�3rEumω)i�3r�)i�3rEZbq)i�3rEZcc)i�3rE�cd)i�3rEuc∕kg)i�3r�)i�3rEZdb)i�3rEZgy)i�3rEZha)i�3rEZhp)i�3rE�in)i�3rEZkk)i�3rEr�)i�3rEZkt)i�3rEZlm)i�3rEZln)i�3rE�log)i�3rEZlx)i�3rEr�)i�3rEZmil)i�3rEZmol)i�3rEZph)i�3r�)i�3rEZppm)i�3rEZpr)i�3rE�sr)i�3rEZsv)i�3rE�wb)i�3rEuv∕m)i�3rEua∕m)i�3rEu1日)i�3rEu2日)i�3rEu3日)i�3rEu4日)i�3rEu5日)i�3rEu6日)i�3rEu7日)i�3rEu8日)i�3rEu9日)i�3rEu10日)i�3rEu11日)i�3rEu12日)i�3rEu13日)i�3rEu14日)i�3rEu15日)i�3rEu16日)i�3rEu17日)i�3rEu18日)i�3rEu19日)i�3rEu20日r�r�r�r�r��_seg_34�
s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�3rEu21日)i�3rEu22日)i�3rEu23日)i�3rEu24日)i�3rEu25日)i�3rEu26日)i�3rEu27日)i�3rEu28日)i�3rEu29日)i�3rEu30日)i�3rEu31日)i�3rEZgal)i4r0)i�Mr�)i�Mr0)i�r�)i�r0)i��r�)i��r0)iǤr�)iФr0)i,�r�)i@�rEuꙁ)iA�r0)iB�rEuꙃ)iC�r0)iD�rEuꙅ)iE�r0)iF�rEuꙇ)iG�r0)iH�rEuꙉ)iI�r0)iJ�rEr�)iK�r0)iL�rEuꙍ)iM�r0)iN�rEuꙏ)iO�r0)iP�rEuꙑ)iQ�r0)iR�rEuꙓ)iS�r0)iT�rEuꙕ)iU�r0)iV�rEuꙗ)iW�r0)iX�rEuꙙ)iY�r0)iZ�rEuꙛ)i[�r0)i\�rEuꙝ)i]�r0)i^�rEuꙟ)i_�r0)i`�rEuꙡ)ia�r0)ib�rEuꙣ)ic�r0)id�rEuꙥ)ie�r0)if�rEuꙧ)ig�r0)ih�rEuꙩ)ii�r0)ij�rEuꙫ)ik�r0)il�rEuꙭ)im�r0)i��rEuꚁ)i��r0)i��rEuꚃ)i��r0)i��rEuꚅ)i��r0)i��rEuꚇ)i��r0)i��rEuꚉ)i��r0)i��rEuꚋ)i��r0)i��rEuꚍ)i��r0)i��rEuꚏ)i��r0)i��rEuꚑ)i��r0)i��rEuꚓ)i��r0)i��rEuꚕ)i��r0)i��rEuꚗ)i��r0)i��rEuꚙ)i��r0)i��rEuꚛ)i��r0)i��rEr�)i��rEr�)i��r0)i��r�r�r�r�r�r��_seg_35@s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�r0)i"�rEuꜣ)i#�r0)i$�rEuꜥ)i%�r0)i&�rE�ꜧ)i'�r0)i(�rEuꜩ)i)�r0)i*�rEuꜫ)i+�r0)i,�rEuꜭ)i-�r0)i.�rEuꜯ)i/�r0)i2�rEuꜳ)i3�r0)i4�rEuꜵ)i5�r0)i6�rEuꜷ)i7�r0)i8�rEuꜹ)i9�r0)i:�rEuꜻ)i;�r0)i<�rEuꜽ)i=�r0)i>�rEuꜿ)i?�r0)i@�rEuꝁ)iA�r0)iB�rEuꝃ)iC�r0)iD�rEuꝅ)iE�r0)iF�rEuꝇ)iG�r0)iH�rEuꝉ)iI�r0)iJ�rEuꝋ)iK�r0)iL�rEuꝍ)iM�r0)iN�rEuꝏ)iO�r0)iP�rEuꝑ)iQ�r0)iR�rEuꝓ)iS�r0)iT�rEuꝕ)iU�r0)iV�rEuꝗ)iW�r0)iX�rEuꝙ)iY�r0)iZ�rEuꝛ)i[�r0)i\�rEuꝝ)i]�r0)i^�rEuꝟ)i_�r0)i`�rEuꝡ)ia�r0)ib�rEuꝣ)ic�r0)id�rEuꝥ)ie�r0)if�rEuꝧ)ig�r0)ih�rEuꝩ)ii�r0)ij�rEuꝫ)ik�r0)il�rEuꝭ)im�r0)in�rE�ꝯ)io�r0)ip�rEr�)iq�r0)iy�rEuꝺ)iz�r0)i{�rEuꝼ)i|�r0)i}�rEuᵹ)i~�rEuꝿ)i�r0)i��rEuꞁ)i��r0)i��rEuꞃ)i��r0)i��rEuꞅ)i��r0)i��rEuꞇ)i��r0)i��rEuꞌ)i��r0)i��rEr�)i��r0)i��rEuꞑ)i��r0r�r�r�r�r��_seg_36�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEuꞓ)i��r0)i��rEuꞗ)i��r0)i��rEuꞙ)i��r0)i��rEuꞛ)i��r0)i��rEuꞝ)i��r0)i��rEuꞟ)i��r0)i��rEuꞡ)i��r0)i��rEuꞣ)i��r0)i��rEuꞥ)i��r0)i��rEuꞧ)i��r0)i��rEuꞩ)i��r0)i��rErc)i��rEr�)i��rEr�)i��rEuɬ)i��rEr�)i��r0)i��rEuʞ)i��rEuʇ)i��rEr�)i��rEuꭓ)i��rEuꞵ)i��r0)i��rEuꞷ)i��r0)i��r�)i��r0)i��r�)i��r0)i��rErK)i��rErN)i��r0)i,�r�)i0�r0)i:�r�)i@�r0)ix�r�)i��r0)iƨr�)iΨr0)iڨr�)i�r0)iT�r�)i_�r0)i}�r�)i��r0)iΩr�)iϩr0)iکr�)iީr0)i��r�)i�r0)i7�r�)i@�r0)iN�r�)iP�r0)iZ�r�)i\�r0)iêr�)i۪r0)i��r�)i�r0)i�r�)i	�r0)i�r�)i�r0)i�r�)i �r0)i'�r�)i(�r0)i/�r�)i0�r0)i\�rEr�)i]�rEuꬷ)i^�rEr)i_�rEuꭒ)i`�r0)if�r�)ip�rEuᎠ)iq�rEuᎡ)ir�rEuᎢ)is�rEuᎣ)it�rEuᎤ)iu�rEuᎥ)iv�rEuᎦ)iw�rEuᎧ)ix�rEuᎨ)iy�rEuᎩ)iz�rEuᎪr�r�r�r�r��_seg_37s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i{�rEuᎫ)i|�rEuᎬ)i}�rEuᎭ)i~�rEuᎮ)i�rEuᎯ)i��rEuᎰ)i��rEuᎱ)i��rEuᎲ)i��rEuᎳ)i��rEuᎴ)i��rEuᎵ)i��rEuᎶ)i��rEuᎷ)i��rEuᎸ)i��rEuᎹ)i��rEuᎺ)i��rEuᎻ)i��rEuᎼ)i��rEuᎽ)i��rEuᎾ)i��rEuᎿ)i��rEuᏀ)i��rEuᏁ)i��rEuᏂ)i��rEuᏃ)i��rEuᏄ)i��rEuᏅ)i��rEuᏆ)i��rEuᏇ)i��rEuᏈ)i��rEuᏉ)i��rEuᏊ)i��rEuᏋ)i��rEuᏌ)i��rEuᏍ)i��rEuᏎ)i��rEuᏏ)i��rEuᏐ)i��rEuᏑ)i��rEuᏒ)i��rEuᏓ)i��rEuᏔ)i��rEuᏕ)i��rEuᏖ)i��rEuᏗ)i��rEuᏘ)i��rEuᏙ)i��rEuᏚ)i��rEuᏛ)i��rEuᏜ)i��rEuᏝ)i��rEuᏞ)i��rEuᏟ)i��rEuᏠ)i��rEuᏡ)i��rEuᏢ)i��rEuᏣ)i��rEuᏤ)i��rEuᏥ)i��rEuᏦ)i��rEuᏧ)i��rEuᏨ)i��rEuᏩ)i��rEuᏪ)i��rEuᏫ)i��rEuᏬ)i��rEuᏭ)i��rEuᏮ)i��rEuᏯ)i��r0)i�r�)i�r0)i��r�)i�r0)i��r�)i��r0)i��r�)i��r0)i��r�)i�rEu豈)i�rEu更)i�rEr$)i�rEu賈)i�rEu滑)i�rEu串)i�rEu句)i�rEr-)i	�rEu契)i
�rEr')i�rEu喇)i�rEu奈)i
�rE�懶)i�rEu癩)i�rEu羅)i�rEu蘿)i�rEu螺)i�rEu裸)i�rEu邏)i�rE�樂)i�rEu洛r�r�r�r�r��_seg_38xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu烙)i�rEu珞)i�rEu落)i�rEu酪)i�rEu駱)i�rEu亂)i�rEu卵)i�rEu欄)i�rEu爛)i�rEu蘭)i �rEu鸞)i!�rEu嵐)i"�rEu濫)i#�rEu藍)i$�rEu襤)i%�rEu拉)i&�rEu臘)i'�rEu蠟)i(�rE�廊)i)�rE�朗)i*�rEu浪)i+�rEu狼)i,�rEu郎)i-�rEu來)i.�rEu冷)i/�rEu勞)i0�rEu擄)i1�rEu櫓)i2�rEu爐)i3�rEu盧)i4�rEr)i5�rEu蘆)i6�rE�虜)i7�rEu路)i8�rEu露)i9�rEu魯)i:�rEu鷺)i;�rE�碌)i<�rEu祿)i=�rEu綠)i>�rEu菉)i?�rEu錄)i@�rEr()iA�rEu論)iB�rEu壟)iC�rEu弄)iD�rEu籠)iE�rEu聾)iF�rEu牢)iG�rEu磊)iH�rEu賂)iI�rEu雷)iJ�rEu壘)iK�rEu屢)iL�rEu樓)iM�rEu淚)iN�rEu漏)iO�rEu累)iP�rEu縷)iQ�rEu陋)iR�rEu勒)iS�rEu肋)iT�rEu凜)iU�rEu凌)iV�rEu稜)iW�rEu綾)iX�rEu菱)iY�rEu陵)iZ�rEu讀)i[�rEu拏)i\�rEr�)i]�rE�諾)i^�rEu丹)i_�rE�寧)i`�rEu怒)ia�rE�率)ib�rE�異)ic�rE�北)id�rEu磻)ie�rEu便)if�rEu復)ig�rEu不)ih�rEu泌)ii�rEu數)ij�rEu索)ik�rEu參)il�rEu塞)im�rEu省)in�rEu葉)io�rE�說)ip�rE�殺)iq�rEr%)ir�rEu沈)is�rEu拾)it�rE�若)iu�rEu掠)iv�rEu略)iw�rEu亮)ix�rEu兩)iy�rEu凉r�r�r�r�r��_seg_39�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iz�rEu梁)i{�rEu糧)i|�rEu良)i}�rEu諒)i~�rEu量)i�rEu勵)i��rEu呂)i��rEr
)i��rEu廬)i��rEu旅)i��rEu濾)i��rEu礪)i��rEu閭)i��rEu驪)i��rEu麗)i��rEu黎)i��rEr
)i��rEu曆)i��rEu歷)i��rEu轢)i��rEu年)i��rEu憐)i��rEu戀)i��rEu撚)i��rEu漣)i��rEu煉)i��rEu璉)i��rEu秊)i��rE�練)i��rEu聯)i��rEu輦)i��rEu蓮)i��rEu連)i��rEu鍊)i��rEu列)i��rEu劣)i��rEu咽)i��rEu烈)i��rEu裂)i��rEr�)i��rEu廉)i��rEu念)i��rEu捻)i��rEu殮)i��rEu簾)i��rEu獵)i��rEu令)i��rEu囹)i��rEr�)i��rEu嶺)i��rEu怜)i��rEu玲)i��rEu瑩)i��rEu羚)i��rEu聆)i��rEu鈴)i��rEu零)i��rEu靈)i��rEu領)i��rEu例)i��rEu禮)i��rEu醴)i��rEu隸)i��rEu惡)i��rEu了)i��rEu僚)i��rEu寮)i��rEu尿)i��rE�料)i��rEr�)i��rEu燎)i��rEu療)i�rEu蓼)i�rEu遼)i�rEr,)i�rEu暈)i�rEu阮)i�rEu劉)i�rEu杻)i�rEu柳)i�rE�流)i�rEu溜)i�rEu琉)i�rEu留)i�rEu硫)i�rEu紐)i�rEu類)i�rErk)i�rEu戮)i�rEu陸)i�rEu倫)i�rEu崙)i�rEu淪)i�rEu輪)i�rEu律)i�rEu慄)i�rEu栗)i�rEr�)i�rEu隆)i�rEu利r�r�r�r�r��_seg_40Hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu吏)i�rEu履)i�rEu易)i�rEu李)i�rEu梨)i�rEu泥)i�rEu理)i�rEu痢)i�rEu罹)i�rEu裏)i�rEu裡)i�rEr&)i�rEu離)i�rEu匿)i�rEu溺)i�rEu吝)i�rEu燐)i�rEu璘)i�rEu藺)i�rEu隣)i�rEu鱗)i�rEu麟)i�rEu林)i��rEu淋)i��rEu臨)i��rEr)i��rEu笠)i��rEu粒)i��rEu狀)i��rEu炙)i��rEu識)i��rEu什)i��rEu茶)i��rEu刺)i�rE�切)i�rEu度)i�rEu拓)i�rEu糖)i�rEu宅)i�rEu洞)i�rEu暴)i�rEu輻)i�rEr)i	�rEu降)i
�rEr!)i�rEu廓)i�rEu兀)i
�rEu嗀)i�r0)i�rE�塚)i�r0)i�rE�晴)i�r0)i�rEu凞)i�rE�猪)i�rE�益)i�rEu礼)i�rEu神)i�rEu祥)i�rE�福)i�rE�靖)i�rEu精)i�rEr)i�r0)i �rEu蘒)i!�r0)i"�rE�諸)i#�r0)i%�rE�逸)i&�rEu都)i'�r0)i*�rEu飯)i+�rEu飼)i,�rEu館)i-�rEu鶴)i.�rEu郞)i/�rEu隷)i0�rE�侮)i1�rE�僧)i2�rE�免)i3�rE�勉)i4�rE�勤)i5�rE�卑)i6�rE�喝)i7�rE�嘆)i8�rEu器)i9�rEu塀)i:�rEu墨)i;�rEu層)i<�rEr)i=�rE�悔)i>�rEu慨)i?�rE�憎)i@�rE�懲)iA�rE�敏)iB�rEu既)iC�rE�暑)iD�rE�梅)iE�rE�海)iF�rEu渚r�r�r�r�r��_seg_41�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iG�rE�漢)iH�rE�煮)iI�rEu爫)iJ�rEu琢)iK�rEu碑)iL�rErm)iM�rEu祉)iN�rEu祈)iO�rEu祐)iP�rE�祖)iQ�rErn)iR�rEu禍)iS�rEu禎)iT�rE�穀)iU�rEu突)iV�rE�節)iW�rEr�)iX�rEu縉)iY�rEu繁)iZ�rEu署)i[�rE�者)i\�rEu臭)i]�rEu艹)i_�rE�著)i`�rEu褐)ia�rE�視)ib�rE�謁)ic�rE�謹)id�rEu賓)ie�rE�贈)if�rEu辶)ig�rEr�)ih�rE�難)ii�rE�響)ij�rE�頻)ik�rEu恵)il�rEu𤋮)im�rEu舘)in�r�)ip�rEu並)iq�rE�况)ir�rEu全)is�rEu侀)it�rEu充)iu�rEu冀)iv�rE�勇)iw�rE�勺)ix�rEr�)iy�rEu啕)iz�rE�喙)i{�rEu嗢)i|�rEr�)i}�rEu墳)i~�rEu奄)i�rEu奔)i��rEu婢)i��rEu嬨)i��rEu廒)i��rEu廙)i��rEu彩)i��rEu徭)i��rEu惘)i��rE�慎)i��rEu愈)i��rEr�)i��rEu慠)i��rEr�)i��rEu戴)i��rEu揄)i��rEu搜)i��rEu摒)i��rEu敖)i��rEr�)i��rEr�)i��rE�望)i��rEu杖)i��rEr)i��rEr�)i��rEr�)i��rEu滛)i��rE�滋)i��rEr�)i��rE�瀞)i��rEr�)i��rEu瞧)i��rE�爵)i��rEu犯)i��rEr�)i��rE�瑱)i��rEu甆)i��rEu画)i��rEu瘝)i��rEu瘟)i��rEr�)i��rEu盛)i��rE�直)i��rE�睊)i��rEu着)i��rE�磌)i��rEu窱r�r�r�r�r��_seg_42s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEu类)i��rEu絛)i��rEr�)i��rEu缾)i��rEr�)i��rEu荒)i��rEu華)i��rE�蝹)i��rEu襁)i��rEu覆)i��rEr�)i��rEu調)i��rEr�)i��rEu請)i��rEr�)i��rEr�)i��rE�諭)i��rEr�)i��rE�變)i��rEr�)i�rE�輸)i�rEu遲)i�rEu醙)i�rEu鉶)i�rEu陼)i�rEr�)i�rEr�)i�rEu韛)i�rEr�)i�rE�頋)i�rEr�)i�rE�鬒)i�rEr-)i�rEu𢡊)i�rEu𢡄)i�rEu𣏕)i�rE�㮝)i�rEu䀘)i�rE�䀹)i�rEu𥉉)i�rEu𥳐)i�rEu𧻓)i�rEu齃)i�rEu龎)i�r�)i�rEZff)i�rEZfi)i�rEZfl)i�rEZffi)i�rEZffl)i�rE�st)i�r�)i�rEuմն)i�rEuմե)i�rEuմի)i�rEuվն)i�rEuմխ)i�r�)i�rEuיִ)i�r0)i�rEuײַ)i �rEuע)i!�rEr�)i"�rEr�)i#�rEuה)i$�rEuכ)i%�rEuל)i&�rEuם)i'�rEuר)i(�rEuת)i)�rr�)i*�rEuשׁ)i+�rEuשׂ)i,�rEuשּׁ)i-�rEuשּׂ)i.�rEuאַ)i/�rEuאָ)i0�rEuאּ)i1�rEuבּ)i2�rEuגּ)i3�rEuדּ)i4�rEuהּ)i5�rEuוּ)i6�rEuזּ)i7�r�)i8�rEuטּ)i9�rEuיּ)i:�rEuךּ)i;�rEuכּ)i<�rEuלּ)i=�r�)i>�rEuמּ)i?�r�)i@�rEuנּ)iA�rEuסּ)iB�r�)iC�rEuףּ)iD�rEuפּ)iE�r�r�r�r�r�r��_seg_43�s��rcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iF�rEuצּ)iG�rEuקּ)iH�rEuרּ)iI�rEuשּ)iJ�rEuתּ)iK�rEuוֹ)iL�rEuבֿ)iM�rEuכֿ)iN�rEuפֿ)iO�rEuאל)iP�rEuٱ)iR�rEuٻ)iV�rEuپ)iZ�rEuڀ)i^�rEuٺ)ib�rEuٿ)if�rEuٹ)ij�rEuڤ)in�rEuڦ)ir�rEuڄ)iv�rEuڃ)iz�rEuچ)i~�rEuڇ)i��rEuڍ)i��rEuڌ)i��rEuڎ)i��rEuڈ)i��rEuژ)i��rEuڑ)i��rEuک)i��rEuگ)i��rEuڳ)i��rEuڱ)i��rE�ں)i��rEuڻ)i��rEuۀ)i��rEuہ)i��rEuھ)i��rEuے)i��rEuۓ)i��r0)i�r�)i�rEuڭ)i�rEuۇ)i�rEuۆ)i�rEuۈ)i�rEr�)i�rEuۋ)i�rEuۅ)i�rEuۉ)i�rEuې)i�rE�ى)i�rEuئا)i�rEuئە)i�rEuئو)i�rEuئۇ)i�rEuئۆ)i�rEuئۈ)i��rEuئې)i��rE�ئى)i��rEuی)i�rE�ئج)i�rE�ئح)i�rE�ئم)i�rEr
)i�rE�ئي)i�rE�بج)i�rE�بح)i�rE�بخ)i�rE�بم)i	�rE�بى)i
�rE�بي)i�rE�تج)i�rE�تح)i
�rE�تخ)i�rE�تم)i�rE�تى)i�rE�تي)i�rEuثج)i�rE�ثم)i�rE�ثى)i�rE�ثي)i�rE�جح)i�rE�جم)i�rE�حج)i�rE�حم)i�rE�خج)i�rEuخح)i�rE�خم)i�rE�سج)i�rE�سح)i�rE�سخ)i�rE�سم)i �rE�صح)i!�rE�صم)i"�rE�ضج)i#�rE�ضح)i$�rE�ضخ)i%�rE�ضم)i&�rE�طحr�r�r�r�r��_seg_44�s��r/cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i'�rE�طم)i(�rE�ظم)i)�rE�عج)i*�rE�عم)i+�rE�غج)i,�rE�غم)i-�rE�فج)i.�rE�فح)i/�rE�فخ)i0�rE�فم)i1�rE�فى)i2�rE�في)i3�rE�قح)i4�rE�قم)i5�rE�قى)i6�rE�قي)i7�rE�كا)i8�rE�كج)i9�rE�كح)i:�rE�كخ)i;�rE�كل)i<�rE�كم)i=�rE�كى)i>�rE�كي)i?�rE�لج)i@�rE�لح)iA�rE�لخ)iB�rE�لم)iC�rE�لى)iD�rE�لي)iE�rE�مج)iF�rE�مح)iG�rE�مخ)iH�rE�مم)iI�rEuمى)iJ�rEuمي)iK�rE�نج)iL�rE�نح)iM�rE�نخ)iN�rE�نم)iO�rE�نى)iP�rE�ني)iQ�rE�هج)iR�rE�هم)iS�rEuهى)iT�rEuهي)iU�rE�يج)iV�rE�يح)iW�rE�يخ)iX�rE�يم)iY�rE�يى)iZ�rE�يي)i[�rEuذٰ)i\�rEuرٰ)i]�rE�ىٰ)i^�ru ٌّ)i_�ru ٍّ)i`�ru َّ)ia�ru ُّ)ib�ru ِّ)ic�ru ّٰ)id�rEuئر)ie�rEuئز)if�rEr
)ig�rEuئن)ih�rEr
)ii�rEr)ij�rEuبر)ik�rEuبز)il�rEr)im�rEuبن)in�rEr)io�rEr)ip�rEuتر)iq�rEuتز)ir�rEr)is�rEuتن)it�rEr)iu�rEr)iv�rEuثر)iw�rEuثز)ix�rEr)iy�rEuثن)iz�rEr)i{�rEr)i|�rEr:)i}�rEr;)i~�rEr>)i�rEr?)i��rEr@)i��rErD)i��rErE)i��rErF)i��rErG)i��rErK)i��rErL)i��rErM)i��rEuما)i��rErQ)i��rEuنرr�r�r�r�r��_seg_45Ps��racdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEuنز)i��rErU)i��rEuنن)i��rErV)i��rErW)i��rEr`)i��rEuير)i��rEuيز)i��rEr])i��rEuين)i��rEr^)i��rEr_)i��rEr)i��rEr)i��rEuئخ)i��rEr
)i��rE�ئه)i��rEr)i��rEr)i��rEr)i��rEr)i��rE�به)i��rEr)i��rEr)i��rEr)i��rEr)i��rE�ته)i��rEr)i��rEr)i��rEr)i��rEr )i��rEr!)i��rEr")i��rEr#)i��rEr$)i��rEr%)i��rEr&)i��rEr')i��rEr()i��rEuصخ)i��rEr))i��rEr*)i��rEr+)i��rEr,)i��rEr-)i��rEr.)i��rEr1)i��rEr2)i��rEr3)i��rEr4)i��rEr5)i��rEr6)i��rEr7)i��rEr8)i��rEr9)i�rEr<)i�rEr=)i�rErA)i�rErB)i�rErC)i�rErD)i�rErE)i�rErH)i�rErI)i�rErJ)i�rErK)i�rEuله)i�rErN)i�rErO)i�rErP)i�rErQ)i�rErR)i�rErS)i�rErT)i�rErU)i�rE�نه)i�rErX)i�rErY)i�rEuهٰ)i�rErZ)i�rEr[)i�rEr\)i�rEr])i�rE�يه)i�rEr
)i�rErb)i�rEr)i�rErc)i�rEr)i�rErd)i�rEr)i�rEuثه)i�rEr')i�rE�سه)i�rE�شم)i�rE�شه)i�rErD)i�rErE)i�rErK)i�rErUr�r�r�r�r��_seg_46�s��rjcdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEre)i�rEr])i�rErf)i�rEuـَّ)i�rEuـُّ)i�rEuـِّ)i��rE�طى)i��rE�طي)i��rE�عى)i��rE�عي)i��rE�غى)i��rE�غي)i��rE�سى)i��rE�سي)i��rE�شى)i��rE�شي)i��rE�حى)i�rE�حي)i�rE�جى)i�rE�جي)i�rE�خى)i�rE�خي)i�rE�صى)i�rE�صي)i�rE�ضى)i�rE�ضي)i	�rE�شج)i
�rE�شح)i�rE�شخ)i�rErh)i
�rE�شر)i�rE�سر)i�rE�صر)i�rE�ضر)i�rErk)i�rErl)i�rErm)i�rErn)i�rEro)i�rErp)i�rErq)i�rErr)i�rErs)i�rErt)i�rEru)i�rErv)i�rErw)i�rErx)i�rEry)i �rErz)i!�rEr{)i"�rEr|)i#�rEr})i$�rEr~)i%�rEr)i&�rEr�)i'�rEr�)i(�rErh)i)�rEr�)i*�rEr�)i+�rEr�)i,�rEr�)i-�rEr)i.�rEr�)i/�rEr�)i0�rErh)i1�rErg)i2�rEri)i3�rEr0)i4�rEr$)i5�rEr%)i6�rEr&)i7�rEr)i8�rEr�)i9�rEr�)i:�rEr0)i;�rEr1)i<�rEuاً)i>�r0)i@�r�)iP�rEuتجم)iQ�rEuتحج)iS�rEuتحم)iT�rEuتخم)iU�rEuتمج)iV�rEuتمح)iW�rEuتمخ)iX�rEuجمح)iZ�rEuحمي)i[�rEuحمى)i\�rEuسحج)i]�rEuسجح)i^�rEuسجى)i_�rEuسمح)ia�rEuسمج)ib�rEuسمم)id�rEuصحح)if�rE�صمم)ig�rEuشحم)ii�rEuشجيr�r�r�r�r��_seg_47 s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ij�rEuشمخ)il�rEuشمم)in�rEuضحى)io�rEuضخم)iq�rEuطمح)is�rEuطمم)it�rEuطمي)iu�rE�عجم)iv�rEuعمم)ix�rEuعمى)iy�rEuغمم)iz�rEuغمي)i{�rEuغمى)i|�rEuفخم)i~�rE�قمح)i�rEuقمم)i��rE�لحم)i��rEuلحي)i��rEuلحى)i��rEuلجج)i��rEuلخم)i��rEuلمح)i��rEuمحج)i��rEuمحم)i��rEuمحي)i��rEuمجح)i��rEuمجم)i��rEuمخج)i��rEuمخم)i��r�)i��rEuمجخ)i��rEuهمج)i��rEuهمم)i��rEuنحم)i��rEuنحى)i��rEuنجم)i��rEuنجى)i��rEuنمي)i��rEuنمى)i��rEuيمم)i��rEuبخي)i��rEuتجي)i��rEuتجى)i��rEuتخي)i��rEuتخى)i��rEuتمي)i��rEuتمى)i��rEuجمي)i��rEuجحى)i��rEuجمى)i��rEuسخى)i��rEuصحي)i��rEuشحي)i��rEuضحي)i��rEuلجي)i��rEuلمي)i��rEuيحي)i��rEuيجي)i��rEuيمي)i��rEuممي)i��rEuقمي)i��rEuنحي)i��rEr�)i��rEr�)i��rEuعمي)i��rEuكمي)i��rE�نجح)i��rEuمخي)i��rE�لجم)i��rE�كمم)i��rEr�)i��rEr�)i��rEuجحي)i��rEuحجي)i��rEuمجي)i��rEuفمي)i�rEuبحي)i�rEr�)i�rEr�)i�rEr�)i�rEuسخي)i�rEuنجي)i�r�)i�rEuصلے)i�rEuقلے)i�rEuالله)i�rEuاكبر)i�rEuمحمد)i��rEuصلعم)i��rEuرسول)i��rEuعليه)i��rEuوسلم)i��rEuصلى)i��ru!صلى الله عليه وسلم)i��ruجل جلاله)i��rEuریال)i��r0)i��r�)i�r�)i�r�,r�r�r�r�r��_seg_48�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rE�、)i�r�)i�r�:)i�rrf)i�r�!)i�r�?)i�rEu〖)i�rEu〗)i�r�)i �r0)i0�r�)i1�rE�—)i2�rEu–)i3�r�_)i5�rr�)i6�rr�)i7�r�{)i8�r�})i9�rE�〔)i:�rE�〕)i;�rEu【)i<�rEu】)i=�rEu《)i>�rEu》)i?�rEr�)i@�rEr�)iA�rE�「)iB�rE�」)iC�rEu『)iD�rEu』)iE�r0)iG�r�[)iH�r�])iI�rr�)iM�rr�)iP�rr�)iQ�rEr�)iR�r�)iT�rrf)iU�rr�)iV�rr�)iW�rr�)iX�rEr�)iY�rr�)iZ�rr�)i[�rr�)i\�rr�)i]�rEr�)i^�rEr�)i_�r�#)i`�r�&)ia�r�*)ib�rr�)ic�rE�-)id�r�<)ie�r�>)if�rr�)ig�r�)ih�r�\)ii�r�$)ij�r�%)ik�r�@)il�r�)ip�ru ً)iq�rEuـً)ir�ru ٌ)is�r0)it�ru ٍ)iu�r�)iv�ru َ)iw�rEuـَ)ix�ru ُ)iy�rEuـُ)iz�ru ِ)i{�rEuـِ)i|�ru ّ)i}�rEuـّ)i~�ru ْ)i�rEuـْ)i��rEuء)i��rEuآ)i��rEuأ)i��rEuؤ)i��rEuإ)i��rEuئ)i��rE�ا)i��rE�ب)i��rEuة)i��rE�ت)i��rE�ث)i��rE�ج)i��rE�ح)i��rE�خ)i��rE�د)i��rE�ذ)i��rE�ر)i��rE�ز)i��rE�س)i��rE�ش)i��rE�صr�r�r�r�r��_seg_49�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rE�ض)i��rE�ط)i�rE�ظ)i�rE�ع)i�rE�غ)i�rE�ف)i�rE�ق)i�rE�ك)i�rE�ل)i�rE�م)i�rE�ن)i�rE�ه)i�rE�و)i�rEr	)i�rE�ي)i��rEuلآ)i��rEuلأ)i��rEuلإ)i��rEuلا)i��r�)i��r�)i�r�)i�rr�)i�r�")i�rr�)i�rr�)i�rr�)i�rr�)i�r�')i�rr�)i	�rr�)i
�rr�)i�rr�)i�rr�)i
�rEr�)i�rEr.)i�r�/)i�rEr�)i�rEr�)i�rEr�)i�rEr)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rr�)i�rrf)i�rr�)i�rr�)i�rr�)i�rr�)i �rr�)i!�rErF)i"�rErH)i#�rErJ)i$�rErL)i%�rErN)i&�rErP)i'�rErR)i(�rErT)i)�rErV)i*�rErX)i+�rErZ)i,�rEr\)i-�rEr^)i.�rEr`)i/�rErb)i0�rErd)i1�rErf)i2�rErh)i3�rErj)i4�rErl)i5�rErn)i6�rErp)i7�rErr)i8�rErt)i9�rErv)i:�rErx)i;�rr�)i<�rr�)i=�rr�)i>�r�^)i?�rr�)i@�rr�)iA�rErF)iB�rErH)iC�rErJ)iD�rErL)iE�rErN)iF�rErP)iG�rErR)iH�rErT)iI�rErV)iJ�rErX)iK�rErZ)iL�rEr\)iM�rEr^)iN�rEr`r�r�r�r�r��_seg_50Xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iO�rErb)iP�rErd)iQ�rErf)iR�rErh)iS�rErj)iT�rErl)iU�rErn)iV�rErp)iW�rErr)iX�rErt)iY�rErv)iZ�rErx)i[�rr�)i\�r�|)i]�rr�)i^�r�~)i_�rEu⦅)i`�rEu⦆)ia�rEr.)ib�rEr�)ic�rEr�)id�rEr�)ie�rEu・)if�rEr�)ig�rEuァ)ih�rEuィ)ii�rEuゥ)ij�rEuェ)ik�rEuォ)il�rEuャ)im�rEuュ)in�rEuョ)io�rEuッ)ip�rEuー)iq�rErr)ir�rErs)is�rErt)it�rEru)iu�rErv)iv�rErw)iw�rErx)ix�rEry)iy�rErz)iz�rEr{)i{�rEr|)i|�rEr})i}�rEr~)i~�rEr)i�rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEuン)i��rEu゙)i��rEu゚)i��r�)i��rEr/)i��rEr0)i��rEr1)i��rEr2)i��rEr3)i��rEr4)i��rEr5)i��rEr6)i��rEr8)i��rEr9)i��rEr:)i��rEr;)i��rEr<)i��rEr=)i��rEr>)i��rEr?)i��rEr@)i��rErAr�r�r�r�r��_seg_51�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rErB)i��rErC)i��rErD)i��rErE)i��rErF)i��rErG)i��rErH)i��rErI)i��rErJ)i��rErK)i��rErL)i��rErM)i��r�)i�rErN)i�rErO)i�rErP)i�rErQ)i�rErR)i�rErS)i�r�)i�rErT)i�rErU)i�rErV)i�rErW)i�rErX)i�rErY)i�r�)i�rErZ)i�rEr[)i�rEr\)i�rEr])i�rEr^)i�rEr_)i�r�)i�rEr`)i�rEra)i�rErb)i�r�)i�rE�¢)i�rE�£)i�rE�¬)i�rr�)i�rE�¦)i�rE�¥)i�rEu₩)i�r�)i�rEu│)i�rEu←)i�rEu↑)i�rEu→)i�rEu↓)i�rEu■)i�rEu○)i�r�)ir0)ir�)i
r0)i'r�)i(r0)i;r�)i<r0)i>r�)i?r0)iNr�)iPr0)i^r�)i�r0)i�r�)ir0)ir�)ir0)i4r�)i7r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i$r�)i-r0)iKr�)iPr0)i{r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)irEu𐐨)irEu𐐩r�r�r�r�r��_seg_52(s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)irEu𐐪)irEu𐐫)irEu𐐬)irEu𐐭)irEu𐐮)irEu𐐯)irEu𐐰)i	rEu𐐱)i
rEu𐐲)irEu𐐳)irEu𐐴)i
rEu𐐵)irEu𐐶)irEu𐐷)irEu𐐸)irEu𐐹)irEu𐐺)irEu𐐻)irEu𐐼)irEu𐐽)irEu𐐾)irEu𐐿)irEu𐑀)irEu𐑁)irEu𐑂)irEu𐑃)irEu𐑄)irEu𐑅)irEu𐑆)irEu𐑇)i rEu𐑈)i!rEu𐑉)i"rEu𐑊)i#rEu𐑋)i$rEu𐑌)i%rEu𐑍)i&rEu𐑎)i'rEu𐑏)i(r0)i�r�)i�r0)i�r�)i�rEu𐓘)i�rEu𐓙)i�rEu𐓚)i�rEu𐓛)i�rEu𐓜)i�rEu𐓝)i�rEu𐓞)i�rEu𐓟)i�rEu𐓠)i�rEu𐓡)i�rEu𐓢)i�rEu𐓣)i�rEu𐓤)i�rEu𐓥)i�rEu𐓦)i�rEu𐓧)i�rEu𐓨)i�rEu𐓩)i�rEu𐓪)i�rEu𐓫)i�rEu𐓬)i�rEu𐓭)i�rEu𐓮)i�rEu𐓯)i�rEu𐓰)i�rEu𐓱)i�rEu𐓲)i�rEu𐓳)i�rEu𐓴)i�rEu𐓵)i�rEu𐓶)i�rEu𐓷)i�rEu𐓸)i�rEu𐓹)i�rEu𐓺)i�rEu𐓻)i�r�)i�r0)i�r�)ir0)i(r�)i0r0)idr�)ior0)ipr�)ir0)i7r�)i@r0)iVr�)i`r0)ihr�)ir0)ir�)ir0)i	r�)i
r0)i6r�)i7r0r�r�r�r�r��_seg_53�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i9r�)i<r0)i=r�)i?r0)iVr�)iWr0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i	r�)i	r0)i:	r�)i?	r0)i@	r�)i�	r0)i�	r�)i�	r0)i�	r�)i�	r0)i
r�)i
r0)i
r�)i
r0)i
r�)i
r0)i
r�)i
r0)i6
r�)i8
r0)i;
r�)i?
r0)iI
r�)iP
r0)iY
r�)i`
r0)i�
r�)i�
r0)i�
r�)i�
r0)i�
r�)ir0)i6r�)i9r0)iVr�)iXr0)isr�)ixr0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)iIr�)i�rEu𐳀)i�rEu𐳁)i�rEu𐳂)i�rEu𐳃)i�rEu𐳄)i�rEu𐳅)i�rEu𐳆)i�rEu𐳇)i�rEu𐳈)i�rEu𐳉)i�rEu𐳊)i�rEu𐳋)i�rEu𐳌)i�rEu𐳍)i�rEu𐳎)i�rEu𐳏)i�rEu𐳐)i�rEu𐳑)i�rEu𐳒)i�rEu𐳓)i�rEu𐳔)i�rEu𐳕)i�rEu𐳖)i�rEu𐳗)i�rEu𐳘)i�rEu𐳙)i�rEu𐳚)i�rEu𐳛)i�rEu𐳜)i�rEu𐳝)i�rEu𐳞)i�rEu𐳟)i�rEu𐳠)i�rEu𐳡)i�rEu𐳢)i�rEu𐳣)i�rEu𐳤)i�rEu𐳥)i�rEu𐳦)i�rEu𐳧)i�rEu𐳨r�r�r�r�r��_seg_54�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu𐳩)i�rEu𐳪)i�rEu𐳫)i�rEu𐳬)i�rEu𐳭)i�rEu𐳮)i�rEu𐳯)i�rEu𐳰)i�rEu𐳱)i�rEu𐳲)i�r�)i�r0)i�r�)i�r0)i(
r�)i0
r0)i:
r�)i`r0)ir�)ir0)i(r�)i0r0)iZr�)ir0)iNr�)iRr0)ipr�)ir0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i5r�)i6r0)iGr�)iPr0)iwr�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i?r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i
r�)ir0)ir�)ir0)i)r�)i*r0)i1r�)i2r0)i4r�)i5r0)i:r�)i;r0)iEr�)iGr0)iIr�)iKr0)iNr�)iPr0)iQr�)iWr0)iXr�)i]r0)idr�)ifr0)imr�)ipr0)iur�)ir0)iZr�)i[r0)i\r�)i]r0r�r�r�r�r��_seg_55`s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i_r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)iEr�)iPr0)iZr�)i`r0)imr�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i,r�)i0r0)i@r�)ir0)i<r�)i�rEu𑣀)i�rEu𑣁)i�rEu𑣂)i�rEu𑣃)i�rEu𑣄)i�rEu𑣅)i�rEu𑣆)i�rEu𑣇)i�rEu𑣈)i�rEu𑣉)i�rEu𑣊)i�rEu𑣋)i�rEu𑣌)i�rEu𑣍)i�rEu𑣎)i�rEu𑣏)i�rEu𑣐)i�rEu𑣑)i�rEu𑣒)i�rEu𑣓)i�rEu𑣔)i�rEu𑣕)i�rEu𑣖)i�rEu𑣗)i�rEu𑣘)i�rEu𑣙)i�rEu𑣚)i�rEu𑣛)i�rEu𑣜)i�rEu𑣝)i�rEu𑣞)i�rEu𑣟)i�r0)i�r�)i�r0)ir�)ir0)iHr�)iPr0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)i	r�)i
r0)i7r�)i8r0)iFr�)iPr0)imr�)ipr0)i�r�)i�r0)i�r�)i�r0)i�r�)ir0)ir�)ir0)i
r�)ir0)i7r�)i:r0)i;r�)i<r0)i>r�)i?r0)iHr�)iPr0)iZr�)i`r0r�r�r�r�r��_seg_56�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)ifr�)igr0)iir�)ijr0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i�r�)i r0)i�#r�)i$r0)io$r�)ip$r0)iu$r�)i�$r0)iD%r�)i0r0)i/4r�)iDr0)iGFr�)ihr0)i9jr�)i@jr0)i_jr�)i`jr0)ijjr�)injr0)ipjr�)i�jr0)i�jr�)i�jr0)i�jr�)ikr0)iFkr�)iPkr0)iZkr�)i[kr0)ibkr�)ickr0)ixkr�)i}kr0)i�kr�)i`nr0)i�nr�)ior0)iEor�)iPor0)ior�)i�or0)i�or�)i�or0)i�or�)ipr0)i�r�)i�r0)i�r�)i�r0)i�r�)ip�r0)i��r�)i�r0)ik�r�)ip�r0)i}�r�)i��r0)i��r�)i��r0)i��r�)i��r0)i��r�)i��r�)i�r0)i��r�)i�r0)i'�r�)i)�r0)i^�rEu𝅗𝅥)i_�rEu𝅘𝅥)i`�rEu𝅘𝅥𝅮)ia�rEu𝅘𝅥𝅯)ib�rEu𝅘𝅥𝅰)ic�rEu𝅘𝅥𝅱)id�rEu𝅘𝅥𝅲)ie�r0)is�r�)i{�r0)i��rEu𝆹𝅥)i��rEu𝆺𝅥)i��rEu𝆹𝅥𝅮)i��rEu𝆺𝅥𝅮)i��rEu𝆹𝅥𝅯)i��rEu𝆺𝅥𝅯)i��r0)i��r�)i�r0r�r�r�r�r��_seg_570s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iF�r�)i��r0)i��r�)i�r0)iW�r�)i`�r0)iy�r�)i�rErF)i�rErH)i�rErJ)i�rErL)i�rErN)i�rErP)i�rErR)i�rErT)i�rErV)i	�rErX)i
�rErZ)i�rEr\)i�rEr^)i
�rEr`)i�rErb)i�rErd)i�rErf)i�rErh)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i�rErv)i�rErx)i�rErF)i�rErH)i�rErJ)i�rErL)i�rErN)i�rErP)i �rErR)i!�rErT)i"�rErV)i#�rErX)i$�rErZ)i%�rEr\)i&�rEr^)i'�rEr`)i(�rErb)i)�rErd)i*�rErf)i+�rErh)i,�rErj)i-�rErl)i.�rErn)i/�rErp)i0�rErr)i1�rErt)i2�rErv)i3�rErx)i4�rErF)i5�rErH)i6�rErJ)i7�rErL)i8�rErN)i9�rErP)i:�rErR)i;�rErT)i<�rErV)i=�rErX)i>�rErZ)i?�rEr\)i@�rEr^)iA�rEr`)iB�rErb)iC�rErd)iD�rErf)iE�rErh)iF�rErj)iG�rErl)iH�rErn)iI�rErp)iJ�rErr)iK�rErt)iL�rErv)iM�rErx)iN�rErF)iO�rErH)iP�rErJ)iQ�rErL)iR�rErN)iS�rErP)iT�rErR)iU�r�)iV�rErV)iW�rErX)iX�rErZ)iY�rEr\)iZ�rEr^)i[�rEr`)i\�rErbr�r�r�r�r��_seg_58�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i]�rErd)i^�rErf)i_�rErh)i`�rErj)ia�rErl)ib�rErn)ic�rErp)id�rErr)ie�rErt)if�rErv)ig�rErx)ih�rErF)ii�rErH)ij�rErJ)ik�rErL)il�rErN)im�rErP)in�rErR)io�rErT)ip�rErV)iq�rErX)ir�rErZ)is�rEr\)it�rEr^)iu�rEr`)iv�rErb)iw�rErd)ix�rErf)iy�rErh)iz�rErj)i{�rErl)i|�rErn)i}�rErp)i~�rErr)i�rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��r�)i��rErJ)i��rErL)i��r�)i��rErR)i��r�)i��rErX)i��rErZ)i��r�)i��rEr`)i��rErb)i��rErd)i��rErf)i��r�)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��r�)i��rErP)i��r�)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`r�r�r�r�r��_seg_59s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��r�)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i�rErr)i�rErt)i�rErv)i�rErx)i�rErF)i�rErH)i�r�)i�rErL)i�rErN)i	�rErP)i
�rErR)i�r�)i
�rErX)i�rErZ)i�rEr\)i�rEr^)i�rEr`)i�rErb)i�rErd)i�rErf)i�r�)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i�rErv)i�r�)i�rErF)i�rErH)i �rErJ)i!�rErL)i"�rErN)i#�rErP)i$�rErR)i%�rErT)i&�rErV)i'�rErX)i(�rErZr�r�r�r�r��_seg_60hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i)�rEr\)i*�rEr^)i+�rEr`)i,�rErb)i-�rErd)i.�rErf)i/�rErh)i0�rErj)i1�rErl)i2�rErn)i3�rErp)i4�rErr)i5�rErt)i6�rErv)i7�rErx)i8�rErF)i9�rErH)i:�r�)i;�rErL)i<�rErN)i=�rErP)i>�rErR)i?�r�)i@�rErV)iA�rErX)iB�rErZ)iC�rEr\)iD�rEr^)iE�r�)iF�rErb)iG�r�)iJ�rErj)iK�rErl)iL�rErn)iM�rErp)iN�rErr)iO�rErt)iP�rErv)iQ�r�)iR�rErF)iS�rErH)iT�rErJ)iU�rErL)iV�rErN)iW�rErP)iX�rErR)iY�rErT)iZ�rErV)i[�rErX)i\�rErZ)i]�rEr\)i^�rEr^)i_�rEr`)i`�rErb)ia�rErd)ib�rErf)ic�rErh)id�rErj)ie�rErl)if�rErn)ig�rErp)ih�rErr)ii�rErt)ij�rErv)ik�rErx)il�rErF)im�rErH)in�rErJ)io�rErL)ip�rErN)iq�rErP)ir�rErR)is�rErT)it�rErV)iu�rErX)iv�rErZ)iw�rEr\)ix�rEr^)iy�rEr`)iz�rErb)i{�rErd)i|�rErf)i}�rErh)i~�rErj)i�rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErVr�r�r�r�r��_seg_61�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErNr�r�r�r�r��_seg_628s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i�rErv)i�rErx)i�rErF)i	�rErH)i
�rErJ)i�rErL)i�rErN)i
�rErP)i�rErR)i�rErT)i�rErV)i�rErX)i�rErZ)i�rEr\)i�rEr^)i�rEr`)i�rErb)i�rErd)i�rErf)i�rErh)i�rErj)i�rErl)i�rErn)i�rErp)i�rErr)i�rErt)i �rErv)i!�rErx)i"�rErF)i#�rErH)i$�rErJ)i%�rErL)i&�rErN)i'�rErP)i(�rErR)i)�rErT)i*�rErV)i+�rErX)i,�rErZ)i-�rEr\)i.�rEr^)i/�rEr`)i0�rErb)i1�rErd)i2�rErf)i3�rErh)i4�rErj)i5�rErl)i6�rErn)i7�rErp)i8�rErr)i9�rErt)i:�rErv)i;�rErx)i<�rErF)i=�rErH)i>�rErJ)i?�rErL)i@�rErN)iA�rErP)iB�rErR)iC�rErT)iD�rErV)iE�rErX)iF�rErZ)iG�rEr\)iH�rEr^)iI�rEr`)iJ�rErb)iK�rErd)iL�rErf)iM�rErh)iN�rErj)iO�rErl)iP�rErn)iQ�rErp)iR�rErr)iS�rErt)iT�rErv)iU�rErx)iV�rErFr�r�r�r�r��_seg_63�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iW�rErH)iX�rErJ)iY�rErL)iZ�rErN)i[�rErP)i\�rErR)i]�rErT)i^�rErV)i_�rErX)i`�rErZ)ia�rEr\)ib�rEr^)ic�rEr`)id�rErb)ie�rErd)if�rErf)ig�rErh)ih�rErj)ii�rErl)ij�rErn)ik�rErp)il�rErr)im�rErt)in�rErv)io�rErx)ip�rErF)iq�rErH)ir�rErJ)is�rErL)it�rErN)iu�rErP)iv�rErR)iw�rErT)ix�rErV)iy�rErX)iz�rErZ)i{�rEr\)i|�rEr^)i}�rEr`)i~�rErb)i�rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rErF)i��rErH)i��rErJ)i��rErL)i��rErN)i��rErP)i��rErR)i��rErT)i��rErV)i��rErX)i��rErZ)i��rEr\)i��rEr^)i��rEr`)i��rErb)i��rErd)i��rErf)i��rErh)i��rErj)i��rErl)i��rErn)i��rErp)i��rErr)i��rErt)i��rErv)i��rErx)i��rEuı)i��rEuȷ)i��r�)i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rErw)i��rEr)i��rEr�r�r�r�r�r��_seg_64s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rE�∇)i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rE�∂)i��rErt)i��rErw)i��rErx)i��rEr�)i��rEr~)i��rEr})i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rErw)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rErp)i��rErq)i��rErr)i��rErs)i�rErt)i�rEru)i�rErv)i�rErw)i�rErd)i�rErx)i�rEry)i�rEr�)i�rErz)i	�rEr{)i
�rEr|)i�rEr})i�rEr~)i
�rEr)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rErt)i�rErw)i�rErx)i�rEr�)i�rEr~)i�rEr})i�rErp)i�rErq)i�rErr)i�rErs)i �rErt)i!�rErur�r�r�r�r��_seg_65ps��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i"�rErv)i#�rErw)i$�rErd)i%�rErx)i&�rEry)i'�rEr�)i(�rErz)i)�rEr{)i*�rEr|)i+�rEr})i,�rEr~)i-�rErw)i.�rEr)i/�rEr�)i0�rEr�)i1�rEr�)i2�rEr�)i3�rEr�)i4�rEr�)i5�rEr�)i6�rErp)i7�rErq)i8�rErr)i9�rErs)i:�rErt)i;�rEru)i<�rErv)i=�rErw)i>�rErd)i?�rErx)i@�rEry)iA�rEr�)iB�rErz)iC�rEr{)iD�rEr|)iE�rEr})iF�rEr~)iG�rEr)iI�rEr�)iJ�rEr�)iK�rEr�)iL�rEr�)iM�rEr�)iN�rEr�)iO�rEr�)iP�rErt)iQ�rErw)iR�rErx)iS�rEr�)iT�rEr~)iU�rEr})iV�rErp)iW�rErq)iX�rErr)iY�rErs)iZ�rErt)i[�rEru)i\�rErv)i]�rErw)i^�rErd)i_�rErx)i`�rEry)ia�rEr�)ib�rErz)ic�rEr{)id�rEr|)ie�rEr})if�rEr~)ig�rErw)ih�rEr)ii�rEr�)ij�rEr�)ik�rEr�)il�rEr�)im�rEr�)in�rEr�)io�rEr�)ip�rErp)iq�rErq)ir�rErr)is�rErs)it�rErt)iu�rEru)iv�rErv)iw�rErw)ix�rErd)iy�rErx)iz�rEry)i{�rEr�)i|�rErz)i}�rEr{)i~�rEr|)i�rEr})i��rEr~)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�r�r�r�r�r��_seg_66�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEr�)i��rErt)i��rErw)i��rErx)i��rEr�)i��rEr~)i��rEr})i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rErw)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rErp)i��rErq)i��rErr)i��rErs)i��rErt)i��rEru)i��rErv)i��rErw)i��rErd)i��rErx)i��rEry)i��rEr�)i��rErz)i��rEr{)i��rEr|)i��rEr})i��rEr~)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rErt)i��rErw)i��rErx)i��rEr�)i��rEr~)i��rEr})i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�r�r�r�r�r��_seg_67@s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i�r0)i��r�)i��r0)i��r�)i��r0)i��r�)i�r0)i�r�)i�r0)i�r�)i�r0)i"�r�)i#�r0)i%�r�)i&�r0)i+�r�)i�r0)i��r�)i��r0)i��r�)i�rEu𞤢)i�rEu𞤣)i�rEu𞤤)i�rEu𞤥)i�rEu𞤦)i�rEu𞤧)i�rEu𞤨)i�rEu𞤩)i�rEu𞤪)i	�rEu𞤫)i
�rEu𞤬)i�rEu𞤭)i�rEu𞤮)i
�rEu𞤯)i�rEu𞤰)i�rEu𞤱)i�rEu𞤲)i�rEu𞤳)i�rEu𞤴)i�rEu𞤵)i�rEu𞤶)i�rEu𞤷)i�rEu𞤸)i�rEu𞤹)i�rEu𞤺)i�rEu𞤻)i�rEu𞤼)i�rEu𞤽)i�rEu𞤾)i�rEu𞤿)i�rEu𞥀)i�rEu𞥁)i �rEu𞥂)i!�rEu𞥃)i"�r0)iK�r�)iP�r0)iZ�r�)i^�r0)i`�r�)iq�r0)i��r�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�r�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i	�rEr�)i
�rEr�)i�rEr�)i�rEr�)i
�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�r�r�r�r�r��_seg_68�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rEr�)i�rE�ٮ)i�rEr)i�rE�ڡ)i�rE�ٯ)i �r�)i!�rEr�)i"�rEr�)i#�r�)i$�rEr�)i%�r�)i'�rEr�)i(�r�)i)�rEr�)i*�rEr�)i+�rEr�)i,�rEr�)i-�rEr�)i.�rEr�)i/�rEr�)i0�rEr�)i1�rEr�)i2�rEr�)i3�r�)i4�rEr�)i5�rEr�)i6�rEr�)i7�rEr�)i8�r�)i9�rEr�)i:�r�)i;�rEr�)i<�r�)iB�rEr�)iC�r�)iG�rEr�)iH�r�)iI�rEr�)iJ�r�)iK�rEr�)iL�r�)iM�rEr�)iN�rEr�)iO�rEr�)iP�r�)iQ�rEr�)iR�rEr�)iS�r�)iT�rEr�)iU�r�)iW�rEr�)iX�r�)iY�rEr�)iZ�r�)i[�rEr�)i\�r�)i]�rEr)i^�r�)i_�rEr�)i`�r�)ia�rEr�)ib�rEr�)ic�r�)id�rEr�)ie�r�)ig�rEr�)ih�rEr�)ii�rEr�)ij�rEr�)ik�r�)il�rEr�)im�rEr�)in�rEr�)io�rEr�)ip�rEr�)iq�rEr�)ir�rEr�)is�r�)it�rEr�)iu�rEr�)iv�rEr�)iw�rEr�)ix�r�)iy�rEr�)iz�rEr�)i{�rEr�)i|�rEr�)i}�r�)i~�rEr�)i�r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�r�r�r�r�r��_seg_69s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��rEr�)i��r�)i��r0)i��r�)i�r0)i,�r�)i0�r0)i��r�)i��r0)i��r�)i��r0)i��r�)i��r0)i��r�)i��r0)i��r�)i�rz0,)i�rz1,)i�rz2,)i�rz3,)i�rz4,)i�rz5,)i�rz6,)i�rz7,)i	�rz8,)i
�rz9,)i�r0)i
�r�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i�rr�)i �rr�)i!�rr�)i"�rr�)i#�rr�)i$�rr�r�r�r�r�r��_seg_70xs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i%�rr�)i&�rr�)i'�rr�)i(�rr�)i)�rr�)i*�rEu〔s〕)i+�rErJ)i,�rErh)i-�rEr�)i.�rEZwz)i/�r0)i0�rErF)i1�rErH)i2�rErJ)i3�rErL)i4�rErN)i5�rErP)i6�rErR)i7�rErT)i8�rErV)i9�rErX)i:�rErZ)i;�rEr\)i<�rEr^)i=�rEr`)i>�rErb)i?�rErd)i@�rErf)iA�rErh)iB�rErj)iC�rErl)iD�rErn)iE�rErp)iF�rErr)iG�rErt)iH�rErv)iI�rErx)iJ�rEZhv)iK�rEr�)iL�rEZsd)iM�rEr))iN�rEZppv)iO�rEZwc)iP�r0)ij�rEZmc)ik�rEZmd)il�r�)ip�r0)i��rEZdj)i��r0)i��r�)i��r0)i�rEuほか)i�rEuココ)i�rEr|)i�r�)i�rEr)i�rEu字)i�rEu双)i�rEuデ)i�rEr)i�rE�多)i�rEu解)i�rErh)i�rEu交)i�rEu映)i�rEu無)i�rEr�)i�rEu前)i�rEu後)i�rE�再)i�rEu新)i �rEu初)i!�rEu終)i"�rEr)i#�rEu販)i$�rEu声)i%�rEu吹)i&�rEu演)i'�rEu投)i(�rEu捕)i)�rEr)i*�rErc)i+�rEu遊)i,�rEro)i-�rErf)i.�rErp)i/�rEu指)i0�rEr#)i1�rEu打)i2�rEu禁)i3�rEu空)i4�rEu合)i5�rEu満)i6�rErl)i7�rEr)i8�rEu申)i9�rE�割)i:�rEu営)i;�rEu配r�r�r�r�r��_seg_71�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i<�r�)i@�rEu	〔本〕)iA�rEu	〔三〕)iB�rEu	〔二〕)iC�rEu	〔安〕)iD�rEu	〔点〕)iE�rEu	〔打〕)iF�rEu	〔盗〕)iG�rEu	〔勝〕)iH�rEu	〔敗〕)iI�r�)iP�rEu得)iQ�rEu可)iR�r�)i`�r0)if�r�)i�r0)i�r�)i�r0)i�r�)i�r0)i��r�)i�r0)it�r�)i��r0)i�r�)i�r0)i�r�)i�r0)iH�r�)iP�r0)iZ�r�)i`�r0)i��r�)i��r0)i��r�)i�r0)i�r�)i�r0)i?�r�)i@�r0)iq�r�)is�r0)iw�r�)iz�r0)i{�r�)i|�r0)i��r�)i��r0)i��r�)i��r0)i�r�)i�r0)i�r�)i`�r0)in�r�)ir0)iצr�)i�r0)i5�r�)i@�r0)i�r�)i �r0)i��r�)i��r0)i��r�)i�rEu丽)i�rEu丸)i�rEu乁)i�rEu𠄢)i�rEu你)i�rEr�)i�rEu侻)i�rEu倂)i�rEu偺)i	�rEu備)i
�rEr�)i�rEu像)i�rEu㒞)i
�rEu𠘺)i�rEr�)i�rEu兔)i�rEu兤)i�rEu具)i�rEu𠔜)i�rEu㒹)i�rEu內)i�rEr�)i�rEu𠕋)i�rEu冗)i�rEu冤)i�rEu仌)i�rEu冬)i�rEr�)i�rEu𩇟)i�rEr	)i�rEu刃)i�rEu㓟)i �rEu刻)i!�rEu剆r�r�r�r�r��_seg_72Hs��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i"�rEr�)i#�rEu剷)i$�rEu㔕)i%�rEr�)i&�rEr�)i'�rEr�)i(�rEr�)i)�rEu包)i*�rEu匆)i+�rEr�)i,�rEu卉)i-�rEr�)i.�rEu博)i/�rEu即)i0�rEu卽)i1�rEu卿)i4�rEu𠨬)i5�rEu灰)i6�rEu及)i7�rEu叟)i8�rEu𠭣)i9�rEu叫)i:�rEu叱)i;�rEu吆)i<�rEu咞)i=�rEu吸)i>�rEu呈)i?�rEu周)i@�rEu咢)iA�rEu哶)iB�rEu唐)iC�rEu啓)iD�rEu啣)iE�rEu善)iG�rEr�)iH�rEu喫)iI�rEu喳)iJ�rEu嗂)iK�rEu圖)iL�rEr�)iM�rEu圗)iN�rEu噑)iO�rEu噴)iP�rEr�)iQ�rEu壮)iR�rEu城)iS�rEu埴)iT�rEu堍)iU�rEu型)iV�rEu堲)iW�rEu報)iX�rEu墬)iY�rEu𡓤)iZ�rEu売)i[�rEu壷)i\�rEu夆)i]�rEr�)i^�rEu夢)i_�rEu奢)i`�rEu𡚨)ia�rEu𡛪)ib�rEu姬)ic�rEu娛)id�rEu娧)ie�rEu姘)if�rEu婦)ig�rEu㛮)ih�r�)ii�rEu嬈)ij�rEu嬾)il�rEu𡧈)im�rEu寃)in�rEu寘)io�rEr�)ip�rEu寳)iq�rEu𡬘)ir�rEu寿)is�rEu将)it�r�)iu�rEr)iv�rEu㞁)iw�rEu屠)ix�rEr)iy�rEu峀)iz�rEu岍)i{�rEu𡷤)i|�rEu嵃)i}�rEu𡷦)i~�rEu嵮)i�rEu嵫)i��rEu嵼)i��rEu巡)i��rEu巢)i��rEu㠯)i��rEu巽)i��rEu帨)i��rEu帽)i��rEu幩)i��rEu㡢)i��rEu𢆃r�r�r�r�r��_seg_73�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEu㡼)i��rEu庰)i��rEu庳)i��rEu庶)i��rEr�)i��rEu𪎒)i��rEr)i��rEu𢌱)i��rE�舁)i��rEu弢)i��rEu㣇)i��rEu𣊸)i��rEu𦇚)i��rEu形)i��rEu彫)i��rEu㣣)i��rEu徚)i��rEu忍)i��rEu志)i��rEu忹)i��rEu悁)i��rEu㤺)i��rEu㤜)i��rEr�)i��rEu𢛔)i��rEu惇)i��rEu慈)i��rE�慌)i��rEr�)i��rEr�)i��rEu慺)i��rEr�)i��rEu憲)i��rEu憤)i��rEu憯)i��rEu懞)i��rEr�)i��rEr�)i��rEu成)i��rEu戛)i��rEu扝)i��rEu抱)i��rEu拔)i��rEu捐)i��rEu𢬌)i��rEu挽)i��rEu拼)i��rEu捨)i��rEu掃)i��rEu揤)i��rEu𢯱)i��rEu搢)i��rEu揅)i��rEu掩)i�rEu㨮)i�rEu摩)i�rEu摾)i�rEu撝)i�rEu摷)i�rEu㩬)i�rEr�)i�rEu敬)i�rEu𣀊)i�rEu旣)i�rEu書)i�rEu晉)i�rEu㬙)i�rEr�)i�rEu㬈)i�rEu㫤)i�rEu冒)i�rEu冕)i�rEu最)i�rEu暜)i�rEu肭)i�rEu䏙)i�rEr�)i�rEr�)i�rEu朡)i�rEu杞)i�rEu杓)i�rEu𣏃)i�rEu㭉)i�rEu柺)i�rEu枅)i�rEu桒)i�rEr�)i�rEu𣑭)i�rEu梎)i�rEu栟)i�rEu椔)i�rEr)i�rEu楂)i�rEu榣)i�rEu槪)i�rEu檨)i�rEu𣚣)i�rEu櫛)i�rEu㰘)i�rEu次r�r�r�r�r��_seg_74s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i�rEu𣢧)i�rEu歔)i�rEu㱎)i�rEu歲)i�rEu殟)i��rEr�)i��rEu殻)i��rEu𣪍)i��rEu𡴋)i��rEu𣫺)i��rEu汎)i��rEu𣲼)i��rEu沿)i��rEu泍)i��rEu汧)i��rEu洖)i�rEu派)i�rEr�)i�rEr�)i�rEu浩)i�rEu浸)i�rEu涅)i�rEu𣴞)i�rEu洴)i�rEu港)i	�rEu湮)i
�rEu㴳)i�rEr�)i�rEu滇)i
�rEu𣻑)i�rEu淹)i�rEu潮)i�rEu𣽞)i�rEu𣾎)i�rEu濆)i�rEu瀹)i�rEr�)i�rEu瀛)i�rEu㶖)i�rEu灊)i�rEu災)i�rEu灷)i�rEu炭)i�rEu𠔥)i�rEu煅)i�rEu𤉣)i�rEu熜)i�r�)i �rEu爨)i!�rEr�)i"�rEu牐)i#�rEu𤘈)i$�rEu犀)i%�rEu犕)i&�rEu𤜵)i'�rEu𤠔)i(�rEu獺)i)�rEu王)i*�rEu㺬)i+�rEu玥)i,�rEu㺸)i.�rEu瑇)i/�rEu瑜)i0�rEr�)i1�rEu璅)i2�rEu瓊)i3�rEu㼛)i4�rEu甤)i5�rEu𤰶)i6�rEu甾)i7�rEu𤲒)i8�rEr�)i9�rEu𢆟)i:�rEu瘐)i;�rEu𤾡)i<�rEu𤾸)i=�rEu𥁄)i>�rEu㿼)i?�rEu䀈)i@�rEr�)iA�rEu𥃳)iB�rEu𥃲)iC�rEu𥄙)iD�rEu𥄳)iE�rEu眞)iF�rEu真)iH�rEr�)iI�rEr)iJ�rEu瞋)iK�rEu䁆)iL�rEu䂖)iM�rEu𥐝)iN�rEu硎)iO�rEr�)iP�rEr�)iQ�rEu䃣)iR�rEu𥘦)iS�rEr�)iT�rEu𥚚)iU�rEu𥛅r�r�r�r�r��_seg_75�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)iV�rEr�)iW�rEu秫)iX�rEu䄯)iY�rEr�)iZ�rEu穊)i[�rEu穏)i\�rEu𥥼)i]�rEu𥪧)i_�r�)i`�rEu䈂)ia�rEu𥮫)ib�rEu篆)ic�rEu築)id�rEu䈧)ie�rEu𥲀)if�rEu糒)ig�rEu䊠)ih�rEu糨)ii�rEu糣)ij�rEu紀)ik�rEu𥾆)il�rEu絣)im�rEu䌁)in�rEu緇)io�rEu縂)ip�rEu繅)iq�rEu䌴)ir�rEu𦈨)is�rEu𦉇)it�rEu䍙)iu�rEu𦋙)iv�rEu罺)iw�rEu𦌾)ix�rEu羕)iy�rEu翺)iz�rEr�)i{�rEu𦓚)i|�rEu𦔣)i}�rEu聠)i~�rEu𦖨)i�rEu聰)i��rEu𣍟)i��rEu䏕)i��rEu育)i��rEu脃)i��rEu䐋)i��rEu脾)i��rEu媵)i��rEu𦞧)i��rEu𦞵)i��rEu𣎓)i��rEu𣎜)i��rEr�)i��rEu舄)i��rEu辞)i��rEu䑫)i��rEu芑)i��rEu芋)i��rEu芝)i��rEu劳)i��rEu花)i��rEu芳)i��rEu芽)i��rEu苦)i��rEu𦬼)i��rEr�)i��rEu茝)i��rEu荣)i��rEu莭)i��rEu茣)i��rEu莽)i��rEu菧)i��rEr�)i��rEu荓)i��rEu菊)i��rEu菌)i��rEu菜)i��rEu𦰶)i��rEu𦵫)i��rEu𦳕)i��rEu䔫)i��rEu蓱)i��rEu蓳)i��rEu蔖)i��rEu𧏊)i��rEu蕤)i��rEu𦼬)i��rEu䕝)i��rEu䕡)i��rEu𦾱)i��rEu𧃒)i��rEu䕫)i��rEu虐)i��rEr�)i��rEu虧)i��rEu虩)i��rEu蚩)i��rEu蚈)i��rEu蜎)i��rEu蛢r�r�r�r�r��_seg_76�s��r�cdCs�ddddddddd	d
ddd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcddgdS)eN)i��rEr�)i��rEu蜨)i��rEu蝫)i��rEu螆)i��r�)i��rEu蟡)i��rEu蠁)i�rEu䗹)i�rEu衠)i�rEr)i�rEu𧙧)i�rEu裗)i�rEu裞)i�rEu䘵)i�rEu裺)i�rEu㒻)i�rEu𧢮)i�rEu𧥦)i�rEu䚾)i�rEu䛇)i�rEu誠)i�rEr�)i�rEr)i�rEr")i�rEu𧲨)i�rEu貫)i�rEu賁)i�rEu贛)i�rEu起)i�rEu𧼯)i�rEu𠠄)i�rEu跋)i�rEu趼)i�rEu跰)i�rEu𠣞)i�rEu軔)i�rEr)i�rEu𨗒)i�rEu𨗭)i�rEu邔)i�rEu郱)i�rEu鄑)i�rEu𨜮)i�rEu鄛)i�rEu鈸)i�rEu鋗)i�rEu鋘)i�rEu鉼)i�rEu鏹)i�rEu鐕)i�rEu𨯺)i�rEu開)i�rEu䦕)i�rEu閷)i�rEu𨵷)i�rEu䧦)i�rEu雃)i�rEu嶲)i��rEu霣)i��rEu𩅅)i��rEu𩈚)i��rEu䩮)i��rEu䩶)i��rEu韠)i��rEu𩐊)i��rEu䪲)i��rEu𩒖)i��rEr)i�rEu頩)i�rEu𩖶)i�rEu飢)i�rEu䬳)i�rEu餩)i�rEu馧)i�rEu駂)i�rEu駾)i�rEu䯎)i	�rEu𩬰)i
�rEr)i�rEu鱀)i�rEu鳽)i
�rEu䳎)i�rEu䳭)i�rEu鵧)i�rEu𪃎)i�rEu䳸)i�rEu𪄅)i�rEu𪈎)i�rEu𪊑)i�rEr))i�rEu䵖)i�rEr*)i�rEu黾)i�rEu鼅)i�rEu鼏)i�rEu鼖)i�rEr+)i�rEu𪘀)i�r�)ir�r�r�r�r�r��_seg_77Ps��r�cCsdgS)N)i�r�r�r�r�r�r��_seg_78�s�r�N)S�__doc__�__version__r�r�rLrTr_rer�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr r7rirjrqr�r�r�r�r�r�r�r�r�r�r�rr/rarjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r��tupleZ	uts46datar�r�r�r��<module>s�hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh��������	�
���
������������������� �!�"�#�$�%�&�'�(�)�*�+�,�-�.�/�0�1�2�3�4�5�6�7�8�9�:�;�<�=�>�?�@�A�B�C�D�E�F�G�H�I�J�K�L�M�N��site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-38.opt-1.pyc000064400000000257151446177000022617 0ustar00U

��.e�@sdZdS)z2.8N)�__version__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/idna/package_data.py�<module>�site-packages/pip/_vendor/idna/__pycache__/compat.cpython-38.opt-1.pyc000064400000001121151446177000021505 0ustar00U

��.e��@s,ddlTddlTdd�Zdd�Zdd�ZdS)	�)�*cCst|�S�N)�encode�Zlabel�r�;/usr/lib/python3.8/site-packages/pip/_vendor/idna/compat.py�ToASCIIsrcCst|�Sr)�decoderrrr�	ToUnicodesr
cCstd��dS)Nz,IDNA 2008 does not utilise nameprep protocol)�NotImplementedError)�srrr�nameprep
sr
N)Zcore�codecrr
r
rrrr�<module>ssite-packages/pip/_vendor/idna/__pycache__/idnadata.cpython-38.pyc000064400000051541151446177000021043 0ustar00U

��.e��@s�dZdddddd�Zddddddddddd	d	d	d	dd	dd	dddddd	d	d	d	dddddddddddddd
dddddddd	ddddd	d	d	dd	d	d	ddddddddddddddddd	d	d	d	d	d	d	d	d	d	d	d	d	d	d	d	d	d	ddddddddddddddddddddddddddddddddddddddd	ddd	d	d	d	d	d	d	d	d	dd	dd	ddd	d	d	dd	d	dddddd	dddd	d	d	d	d	ddddd	dddddddddd	dd	dd	ddd	d	dddddddddddd	d	d	dddddddddddddddd	d	ddddd	dd	d	dddd	d	dddddddddddddddddddddddddddddddddddddddd
d	dddddd	d	dd	ddddddddddd	dddddddddddd	dd	d	ddddddddddd	d	d	dd	ddd	d	dddddd	dddddddd
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd
ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd	dd	dd	d	dddd	d	d	d	d	ddddddddddd	dddd	ddd	ddddd	dd	dd	d	d	dddd	ddd	dd	d	dd	d	d	d	d	dddddddddddddddddddddddddddddddddddddd	ddddd	dddddddddddddddddddddd	ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd
���Zdddd�ZdS)z11.0.0)$lt�
lx�
l~�
l��
l�l�l� l�0l�8l��l�l+�tlbtulk�ul��vl|l`|lF�|lN }�X@}lZd}l\l}l^t}l~|}l�~l��~l�l�Xl�tl��l��l'!�lf+�-l�l��lFRH)l�.:l�.l:l�/<l0@l0@l*0�@l<0�@��MP��8lnzdl�z�i��&�57�8]��N�`��k�:lz`)	l�D��@l��l7{tll={�ll?{�llB{mlE{mlP{m)��0Al�0tBl1@
lrH)��0�Bl1�C�2�Gl�2@KlX3Llp�}l��}l0@
)ZGreekZHanZHebrewZHiraganaZKatakana�U�D�R�C�T�L(�iiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJinioiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/iMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXi`iaibicidieifigihiiiji�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iii
ii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i i
 i/ if ig ih ii i@�iA�iB�iC�iD�iE�iF�iG�iH�iI�iJ�iK�iL�iM�iN�iO�iP�iQ�iR�iS�iT�iU�iV�iW�iX�iY�iZ�i[�i\�i]�i^�i_�i`�ia�ib�ic�id�ie�if�ig�ih�ii�ij�ik�il�im�in�io�ip�iq�ir�is�i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�
i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i
i
i
i
i
i
i
i
i
i	
i

i
i
i

i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i
i 
i!
i"
i#
i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiQiRiSiTi�i�i�i�i�i�i�i�i�i�i�i	�i
�i�i�i
�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i �i!�i"�i#�i$�i%�i&�i'�i(�i)�i*�i+�i,�i-�i.�i/�i0�i1�i2�i3�i4�i5�i6�i7�i8�i9�i:�i;�i<�i=�i>�i?�i@�iA�iB�iC�(ql.�l:�l{�l�|l�lllll
$l,l4l<lDlLlTl\ldllltl |l"�l$�l&�l(�l*�l,�l.�l0�l2�l6�l9�l;�l=�l?�lClElGlI lL,lN4lP<lRDlTLlVTlX\lZdl\ll^tl`|lb�ld�lf�lh�lj�ll�ln�lp�lr�lt�lv�lx�l{�l}�l�l�l�l�l� l�0l�Hl�Tl�dl�xl��l��l��l��l��l��l��l��l��l��l��l�8l�@l�Hl�Pl�Xl�`l�hl�pl�|l��l��l��l��l��l��l��l��l��l��l��l��l�lllll
$l,l4l<lDlLlTl\ldllltl |l"�l$�l&�l(�l*�l,�l.�l0�l2�l:�l=�lA�lC	lH	lJ$	lL,	lN4	l�<	l��
l�l��l��l@lC
lO
lp@
lr�
lt�
lx�
l~�
l�@l��l�\l�dl�ll�tl�|l��l��l��l��l��l��l��l��l��l��l��l`�lb�ld�lf�lh�lj�ll�ln�lp�lr�lt�lv�lx�lz�l|�l~�l��l�l�l�,l�4l�<l�Dl�Ll�Tl�\l�dl�ll�tl�|l��l��l��l��l��l��l��l��l��l��l��l��l��l��l��l��l�l�l�l� l�(l�0l�8l�Dl�Ll�Tl�\l�dl�ll�tl�|l��l��l��l��l��l��l��l��l��l��l��l��l��l��l��l�lllll
$l,l4l<lDlLlTl\ldllltl |l"�l$�l&�l(�l*�l,�l.�l0�lZdl��l� l�Dl��l�l�l�r	l��l@l@�l`lu�l��l�Tl�|l��l�lK@l�4l�l��l. l\!lk�!l��"l��"l�L#lX	�#ld	�%lp	�%l�	�%l�	&l�	<&l�	L&l�	�&l�	�&l�	�&l�	�&l�	'l�	,'l�	\'l�	�'l�	�'l�	�'l�	�'l
(l
(l
<(l)
L(l1
�(l3
�(l6
�(l:
�(l=
�(lC
�(lI
)lN
,)lR
D)l]
p)lv
�)l�
*l�
*l�
<*l�
L*l�
�*l�
�*l�
�*l�
�*l�
+l�
,+l�
@+l�
�+l�
�+l�+l,l
,l<,l)L,l1�,l4�,l:�,lE�,lI-lN,-lXX-ld|-lp�-lr�-l�.l�.l�8.l�H.l�d.l�p.l�x.l��.l��.l��.l��.l�/l�(/l�@/l�\/l��/l
0l80l)H0l:�0lE�0lI1lN(1lWT1l[`1ld�1lp�1l�2l�2l�82l�H2l��2l��2l��2l�3l�(3l�T3l�x3l��3l��3l��3l
4l

4l
84lE
H4lI
5lO
(5lX
P5ld
|5lp
�5l�
�5l�
6l�
6l�
h6l�
�6l�
�6l�
7l�
(7l�
<7l�
X7l�
`7l�
�7l�
�7l38l;�8lO9lZ@9l�:l�:l�:l�(:l�4:l�P:l�d:l��:l��:l��:l��:l��:l��:l��:l�;l�;l� ;l�@;l�x;l<l,<l`<l*�<l6�<l8�<l:�<lC�<lH=lM$=lR8=lWL=l\`=lit=lm�=ls�=lu�=l��=l�>l�>l�P>l�d>l�x>l��>l��>l��>l��>l�?lJ@l�@Al�@Cl�ClIHlN(IlW@IlY`Il^hIl��Il�(Jl�@Jl��Jl��Jl�Kl�Kl� Kl`KlHLl[`Ll`tMl�Nl��NlmPl��Yl�Zl��Zl��[l
\l8\l5�\lT]lm�]lq�]lt�]l�^l��^l�\_l�p_l��_l@`ly�`l�bl��bldl,�dl<�dlnelu�el�fl��fl�@glhl_�hl}�il��il�@jl��jl��jlLllZ@mlt�ml�nl8plJql~4ql�@sl�Psl,tl0�tl<�tlO8ulx�ul��ul�wl�wlxlxlxlxl
$xl,xl4xl<xlDxlLxlTxl\xldxllxltxl |xl"�xl$�xl&�xl(�xl*�xl,�xl.�xl0�xl2�xl4�xl6�xl8�xl:�xl<�xl>�xl@�xlBylDylFylHylJ$ylL,ylN4ylP<ylRDylTLylVTylX\ylZdyl\lyl^tyl`|ylb�yld�ylf�ylh�ylj�yll�yln�ylp�ylr�ylt�ylv�ylx�ylz�yl|�yl~�yl��yl�zl�zl�zl�zl�$zl�,zl�4zl�<zl�Dzl�Lzl�Tzl�pzl�|zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl��zl�{l�{l�{l�{l�${l�,{l�4{l�<{l�D{l�L{l�T{l�\{l�d{l�l{l�t{l�|{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l��{l�{l@|l(�|l8�|lF}rlh�}lq�}ls�}lu�}lw�}ly�}l{�}l}�}l��~l��~l�l�@l�Xl��l��l��lO!8l�!l_,�0lb,�1lg,�1li,�1lk,�1lm,�1lr,�1lu,�1l|,�1l�,2l�,2l�,2l�,2l�,$2l�,,2l�,42l�,<2l�,D2l�,L2l�,T2l�,\2l�,d2l�,l2l�,t2l�,|2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,�2l�,3l�,3l�,3l�,3l�,$3l�,,3l�,43l�,<3l�,D3l�,L3l�,T3l�,\3l�,d3l�,l3l�,t3l�,|3l�,�3l�,�3l�,�3l�,�3l�,�3l&-4l(-�4l.-�4lh-�4l�-�5l�-�6l�-�6l�-�6l�-�6l�-7l�- 7l�-@7l�-`7l.�7l0.�8l0@l.0�@l=0�@r
l�0dBl�0tBrl�0�Cl01Dl�1�Frrrl�$l�$@l
&l,&@lB&lD&lF&lH&lJ&$lL&,lN&4lP&<lR&DlT&LlV&TlX&\lZ&dl\&ll^&tl`&|lb&�ld&�lf&�lh&�lj&�ll&�lp&�l~&�l�&�l�&l�&l�&l�&l�&$l�&,l�&4l�&<l�&Dl�&Ll�&Tl�&\l�&dl�&ll�&xl�&�l '\l$'�l&'�l('�l*'�l,'�l.'�l2'�l4'�l6'�l8'�l:'�l<'�l>'�l@'�lB'lD'lF'lH'lJ'$lL',lN'4lP'<lR'DlT'LlV'TlX'\lZ'dl\'ll^'tl`'|lb'�ld'�lf'�lh'�lj'�ll'�ln'�lp'�ly'�l{'�l}'�l�'�l�'l�'l�'l�'l�'0l�'8l�'Dl�'Ll�'\l�'dl�'ll�'tl�'|l�'�l�'�l�'�l�'�l�'�l�'�l�'�l�'�l�'�l�'�l((�lt(!l�("l�(@#l�(�#l�(�#l.)�#lT)�$l�)&l�)<'l�)�'l7*(lN*)lZ*@)lw*�)l�*�)l�*l+l�*�+l�*�+l+,l+$,l+D,l'+�,l/+�,l[+�,lf+�-l�+/l�+�/l�+�/l�W0lz8hlzDhlzLhl z|hl"z�hl%z�hl*z�hl{xll0~�xlt~�yll'4l;�l>�lN�l^@l�l��l�
l��
l��l lA�lJ
l{@
l�l��l� l��l��l�`l(ld�l7lVlh�l l	  l6( l9� l=� lV� lw�!l�"l��#l��#l	$l:	�$l�	&l�	�&l
(l
(l
0(l
T(l6
d(l;
�(l@
�(l}
�)l�
*l�
+l�
$+l6,lV-ls�-l�.lI0l�3l(
4l:
�4l<l(�<lQ�<lG@lp�Al��Al�@Cl��Cl5Dl@�DlGElt@Elw�El�Fl�$Gl�@Gl�pGlHl8LHl?�Hl�Jl� Jl�(Jl�<Jl�|Jl��Jl��KlLl
Ll<Ll)LLl1�Ll4�Ll:�LlE�LlIMlN,MlQ@MlX\MldtMlm�Mlu�MlKPlZ@Ql_xQl�Rl�Sl�@Sl�Vl��Vl�`WlAXlEYlZ@Yl�Zl�[l\l,t\l:�\l;`l�cl�cl?hlHil�@il�jl�tjl�kl	pl7(plA�plZ@ql��ql�Hrl��rltl
 tl7,tl;�tl>�tlH�tlZ@ulf�uli�ul��ul�@vl�Lvl��vl��{l�#	lD%	l/4@	lGF
l9j l_j)ljj�)l�j@+l�j�+l7k,lDk-lZk@-lxk�-l�k�-l�n�9lEo<lo@=l�o<>l�o�?l�@l�
 l1@
l�2�E
lk<p
l}<�q
l�<r
l�<@r
l�<tr
l7ZhlmZ�hlvZ�il�Zjl�Zljl�Z�jl`l` l"`ll%`�l+`�l�h l�h@#lKi�$lZi@%rrrrr)l 0)l��lv�
l��lj�l��l�0�C)ZPVALIDZCONTEXTJZCONTEXTON)�__version__ZscriptsZ
joining_typesZcodepoint_classes�rr�=/usr/lib/python3.8/site-packages/pip/_vendor/idna/idnadata.py�<module>s
&�W������h{���������site-packages/pip/_vendor/idna/__pycache__/package_data.cpython-38.pyc000064400000000257151446177000021660 0ustar00U

��.e�@sdZdS)z2.8N)�__version__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/idna/package_data.py�<module>�site-packages/pip/_vendor/idna/__pycache__/__init__.cpython-38.pyc000064400000000335151446177000021030 0ustar00U

��.e:�@sddlmZddlTdS)�)�__version__)�*N)Zpackage_datarZcore�rr�=/usr/lib/python3.8/site-packages/pip/_vendor/idna/__init__.py�<module>ssite-packages/pip/_vendor/idna/__pycache__/core.cpython-38.opt-1.pyc000064400000021461151446177000021163 0ustar00U

��.e�-�@s>ddlmZddlZddlZddlZddlZddlmZdZdZ	e�
d�Zejddkr`e
ZeZGd	d
�d
e�ZGdd�de�ZGd
d�de�ZGdd�de�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd7dd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Z d8d(d)�Z!d*d+�Z"d,d-�Z#d.d/�Z$d9d1d2�Z%d:d3d4�Z&d;d5d6�Z'dS)<�)�idnadata�N)�intranges_contain�	sxn--u[.。.。]�c@seZdZdZdS)�	IDNAErrorz7 Base exception for all IDNA-encoding related problems N��__name__�
__module__�__qualname__�__doc__�r
r
�9/usr/lib/python3.8/site-packages/pip/_vendor/idna/core.pyrsrc@seZdZdZdS)�
IDNABidiErrorz= Exception when bidirectional requirements are not satisfied Nrr
r
r
rrsrc@seZdZdZdS)�InvalidCodepointz> Exception when a disallowed or unallocated codepoint is used Nrr
r
r
rrsrc@seZdZdZdS)�InvalidCodepointContextzE Exception when the codepoint is not valid in the context it is used Nrr
r
r
rrsrcCs0t�t|��}|dkr,t�t|��s,td��|S)Nrz Unknown character in unicodedata)�unicodedataZ	combining�unichr�name�
ValueError)�cp�vr
r
r�_combining_class$s
rcCstt|�tj|�S)N)r�ordrZscripts)rZscriptr
r
r�
_is_script+srcCs
|�d�S)N�punycode)�encode��sr
r
r�	_punycode.srcCs
d�|�S)Nz	U+{0:04X})�formatrr
r
r�_unot1sr!cCst|�dkrdSdS)N�?FT��len��labelr
r
r�valid_label_length5sr'cCst|�|rdndkrdSdS)N��FTr#)r&�trailing_dotr
r
r�valid_string_length<sr+Fc	Cs^d}t|d�D]:\}}t�|�}|dkr<td�t|�|���|dkrd}q|sV|sVdSt�|d�}|dkrrd}n |d	kr�d}ntd
�t|����d}d}t|d�D]�\}}t�|�}|�r|dkr�td�|���|d
kr�d}n|dkr�d}|dk�rJ|�s|}n||k�rJtd��q�|dk�r.td�|���|dk�r>d}q�|dkr�d}q�|�sZtd��dS)NFr�z3Unknown directionality in label {0} at position {1})�R�AL�ANTr)r-r.�Lz>First codepoint in label {0} must be directionality L, R or AL)
r-r.r/�EN�ES�CS�ET�ON�BN�NSMzHInvalid direction for codepoint at position {0} in a right-to-left label)r-r.r1r/r7)r/r1z2Can not mix numeral types in a right-to-left label)r0r1r2r3r4r5r6r7zHInvalid direction for codepoint at position {0} in a left-to-right label)r0r1z0Label ends with illegal codepoint directionality)�	enumeraterZ
bidirectionalrr �repr)	r&Z	check_ltrZ
bidi_label�idxr�	directionZrtlZvalid_endingZnumber_typer
r
r�
check_bidiCsP






r<cCs"t�|d�ddkrtd��dS)Nr�Mz0Label begins with an illegal combining characterT)r�categoryrr%r
r
r�check_initial_combinersr?cCs<|dd�dkrtd��|ddks0|ddkr8td��d	S)
N��z--z4Label has disallowed hyphens in 3rd and 4th positionr�-���z)Label must not start or end with a hyphenT)rr%r
r
r�check_hyphen_ok�s
rDcCst�d|�|krtd��dS)N�NFCz%Label must be in Normalization Form C)r�	normalizerr%r
r
r�	check_nfc�srGcCs4t||�}|dkr�|dkr8tt||d��tkr8dSd}t|ddd�D]B}tj�t||��}|td�krrqL|td�td	�fkrLd}q�qL|s�dSd}t|dt|��D]B}tj�t||��}|td�kr�q�|td
�td	�fkr�d}q�q�|S|dk�r,|dk�r(tt||d��tk�r(dSdSdSdS)Ni rrTFrC�Tr0�Dr-i
 )rr�_virama_combining_class�rangerZ
joining_types�getr$)r&�pos�cp_value�ok�iZjoining_typer
r
r�valid_contextj�s<

rQcCs�t||�}|dkrdd|kr0t|�dkr`nn,t||d�dkr`t||d�dkr`dSdS|dkr�|t|�dkr�t|�dkr�t||dd�SdS|d	ks�|d
kr�|dkr�t||dd�SdS|dk�r|D]6}|d
kr�q�t|d��s
t|d��s
t|d�r�dSq�dSd|k�r.dk�rhnn6|D],}dt|�k�rVdk�r6nndS�q6dSd|k�r�dk�r�nn6|D],}dt|�k�r�dk�r�nndS�q�dSdS)N�rr�lTFiuZGreeki�i�ZHebrewi�0u・ZHiraganaZKatakanaZHani`iii�i�)rr$r)r&rMZ	exceptionrNrr
r
r�valid_contexto�s> (
" 
 
rTcCsLt|ttf�r|�d�}t|�dkr,td��t|�t|�t|�t	|�D]�\}}t
|�}t|tj
d�rpqLqLt|tj
d�r�z,t||�s�td�t|�|dt|����Wn2tk
r�td�t|�|dt|����YnXqLt|tj
d	��r t||��s>td
�t|�|dt|����qLtd�t|�|dt|����qLt|�dS)Nzutf-8rzEmpty LabelZPVALIDZCONTEXTJz-Joiner {0} not allowed at position {1} in {2}rz?Unknown codepoint adjacent to joiner {0} at position {1} in {2}ZCONTEXTO�0Codepoint {0} not allowed at position {1} in {2}z0Codepoint {0} at position {1} of {2} not allowed)�
isinstance�bytes�	bytearray�decoder$rrGrDr?r8rrrZcodepoint_classesrQrr r!r9rrTrr<)r&rMrrNr
r
r�check_label�s<

�
�  rZcCs~z(|�d�}t|�t|�s$td��|WStk
r<YnX|sJtd��t|�}t|�t|�}t|}t|�sztd��|S)N�asciizLabel too longzNo Input)	r�ulabelr'r�UnicodeEncodeError�unicoderZr�_alabel_prefixr%r
r
r�alabel
s"
r`cCs�t|ttf�s>z|�d�}Wn tk
r<t|�|YSX|��}|�t�rb|t	t�d�}nt|�|�
d�S|�
d�}t|�|S)Nr[r)rVrWrXrr]rZ�lower�
startswithr_r$rYr%r
r
rr\#s



r\Tc
Cs(ddlm}d}z�t|�D]�\}}t|�}||dkr8|nt�||df�d}|d}	t|�dkrj|dnd}
|	d	ks�|	d
kr�|r�|	dkr�|s�|
dkr�||7}q|
dk	r�|	dks�|	dkr�|r�|	d
kr�|r�||
7}q|	d
krt��qt�d|�WStk
�r"t	d�
t|�|dt|����YnXdS)zBRe-map the characters in the string according to UTS46 processing.r)�	uts46datar,��Zrr@N�VrI�3r=�IrErU)
rcr8r�bisectZbisect_leftr$�
IndexErrorrrFrr r!r9)Zdomain�
std3_rules�transitionalrc�outputrM�charZ
code_pointZuts46rowZstatusZreplacementr
r
r�uts46_remap8sV������
����
��roc	Cs�t|ttf�r|�d�}|r(t|||�}d}g}|r@|�d�}n
t�|�}|rX|dgkr`td��|ddkrv|d=d}|D]$}t|�}|r�|�	|�qztd��qz|r�|�	d	�d
�
|�}t||�s�td��|S)Nr[F�.r,�Empty domainrCT�Empty label��.zDomain too long)rVrWrXrYro�split�_unicode_dots_rerr`�append�joinr+)	r�strict�uts46rkrlr*�result�labelsr&r
r
rrTs2





rcCs�t|ttf�r|�d�}|r(t||d�}d}g}|s@t�|�}n
|�d�}|rX|dgkr`td��|dsr|d=d}|D]$}t|�}|r�|�	|�qvtd��qv|r�|�	d�d�
|�S)	Nr[Frpr,rqrCTrr)rVrWrXrYrorvrurr\rwrx)rryrzrkr*r{r|r&r
r
rrYss,



rY)F)F)TF)FFFF)FFF)(r,rrir�re�sysZ	intrangesrrJr_�compilerv�version_info�strr^�chrr�UnicodeErrorrrrrrrrr!r'r+r<r?rDrGrQrTrZr`r\rorrYr
r
r
r�<module>sB

<	,
) 

site-packages/pip/_vendor/idna/__init__.py000064400000000072151446177000014540 0ustar00from .package_data import __version__
from .core import *
site-packages/pip/_vendor/idna/core.py000064400000026725151446177000013746 0ustar00from . import idnadata
import bisect
import unicodedata
import re
import sys
from .intranges import intranges_contain

_virama_combining_class = 9
_alabel_prefix = b'xn--'
_unicode_dots_re = re.compile(u'[\u002e\u3002\uff0e\uff61]')

if sys.version_info[0] == 3:
    unicode = str
    unichr = chr

class IDNAError(UnicodeError):
    """ Base exception for all IDNA-encoding related problems """
    pass


class IDNABidiError(IDNAError):
    """ Exception when bidirectional requirements are not satisfied """
    pass


class InvalidCodepoint(IDNAError):
    """ Exception when a disallowed or unallocated codepoint is used """
    pass


class InvalidCodepointContext(IDNAError):
    """ Exception when the codepoint is not valid in the context it is used """
    pass


def _combining_class(cp):
    v = unicodedata.combining(unichr(cp))
    if v == 0:
        if not unicodedata.name(unichr(cp)):
            raise ValueError("Unknown character in unicodedata")
    return v

def _is_script(cp, script):
    return intranges_contain(ord(cp), idnadata.scripts[script])

def _punycode(s):
    return s.encode('punycode')

def _unot(s):
    return 'U+{0:04X}'.format(s)


def valid_label_length(label):

    if len(label) > 63:
        return False
    return True


def valid_string_length(label, trailing_dot):

    if len(label) > (254 if trailing_dot else 253):
        return False
    return True


def check_bidi(label, check_ltr=False):

    # Bidi rules should only be applied if string contains RTL characters
    bidi_label = False
    for (idx, cp) in enumerate(label, 1):
        direction = unicodedata.bidirectional(cp)
        if direction == '':
            # String likely comes from a newer version of Unicode
            raise IDNABidiError('Unknown directionality in label {0} at position {1}'.format(repr(label), idx))
        if direction in ['R', 'AL', 'AN']:
            bidi_label = True
    if not bidi_label and not check_ltr:
        return True

    # Bidi rule 1
    direction = unicodedata.bidirectional(label[0])
    if direction in ['R', 'AL']:
        rtl = True
    elif direction == 'L':
        rtl = False
    else:
        raise IDNABidiError('First codepoint in label {0} must be directionality L, R or AL'.format(repr(label)))

    valid_ending = False
    number_type = False
    for (idx, cp) in enumerate(label, 1):
        direction = unicodedata.bidirectional(cp)

        if rtl:
            # Bidi rule 2
            if not direction in ['R', 'AL', 'AN', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
                raise IDNABidiError('Invalid direction for codepoint at position {0} in a right-to-left label'.format(idx))
            # Bidi rule 3
            if direction in ['R', 'AL', 'EN', 'AN']:
                valid_ending = True
            elif direction != 'NSM':
                valid_ending = False
            # Bidi rule 4
            if direction in ['AN', 'EN']:
                if not number_type:
                    number_type = direction
                else:
                    if number_type != direction:
                        raise IDNABidiError('Can not mix numeral types in a right-to-left label')
        else:
            # Bidi rule 5
            if not direction in ['L', 'EN', 'ES', 'CS', 'ET', 'ON', 'BN', 'NSM']:
                raise IDNABidiError('Invalid direction for codepoint at position {0} in a left-to-right label'.format(idx))
            # Bidi rule 6
            if direction in ['L', 'EN']:
                valid_ending = True
            elif direction != 'NSM':
                valid_ending = False

    if not valid_ending:
        raise IDNABidiError('Label ends with illegal codepoint directionality')

    return True


def check_initial_combiner(label):

    if unicodedata.category(label[0])[0] == 'M':
        raise IDNAError('Label begins with an illegal combining character')
    return True


def check_hyphen_ok(label):

    if label[2:4] == '--':
        raise IDNAError('Label has disallowed hyphens in 3rd and 4th position')
    if label[0] == '-' or label[-1] == '-':
        raise IDNAError('Label must not start or end with a hyphen')
    return True


def check_nfc(label):

    if unicodedata.normalize('NFC', label) != label:
        raise IDNAError('Label must be in Normalization Form C')


def valid_contextj(label, pos):

    cp_value = ord(label[pos])

    if cp_value == 0x200c:

        if pos > 0:
            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
                return True

        ok = False
        for i in range(pos-1, -1, -1):
            joining_type = idnadata.joining_types.get(ord(label[i]))
            if joining_type == ord('T'):
                continue
            if joining_type in [ord('L'), ord('D')]:
                ok = True
                break

        if not ok:
            return False

        ok = False
        for i in range(pos+1, len(label)):
            joining_type = idnadata.joining_types.get(ord(label[i]))
            if joining_type == ord('T'):
                continue
            if joining_type in [ord('R'), ord('D')]:
                ok = True
                break
        return ok

    if cp_value == 0x200d:

        if pos > 0:
            if _combining_class(ord(label[pos - 1])) == _virama_combining_class:
                return True
        return False

    else:

        return False


def valid_contexto(label, pos, exception=False):

    cp_value = ord(label[pos])

    if cp_value == 0x00b7:
        if 0 < pos < len(label)-1:
            if ord(label[pos - 1]) == 0x006c and ord(label[pos + 1]) == 0x006c:
                return True
        return False

    elif cp_value == 0x0375:
        if pos < len(label)-1 and len(label) > 1:
            return _is_script(label[pos + 1], 'Greek')
        return False

    elif cp_value == 0x05f3 or cp_value == 0x05f4:
        if pos > 0:
            return _is_script(label[pos - 1], 'Hebrew')
        return False

    elif cp_value == 0x30fb:
        for cp in label:
            if cp == u'\u30fb':
                continue
            if _is_script(cp, 'Hiragana') or _is_script(cp, 'Katakana') or _is_script(cp, 'Han'):
                return True
        return False

    elif 0x660 <= cp_value <= 0x669:
        for cp in label:
            if 0x6f0 <= ord(cp) <= 0x06f9:
                return False
        return True

    elif 0x6f0 <= cp_value <= 0x6f9:
        for cp in label:
            if 0x660 <= ord(cp) <= 0x0669:
                return False
        return True


def check_label(label):

    if isinstance(label, (bytes, bytearray)):
        label = label.decode('utf-8')
    if len(label) == 0:
        raise IDNAError('Empty Label')

    check_nfc(label)
    check_hyphen_ok(label)
    check_initial_combiner(label)

    for (pos, cp) in enumerate(label):
        cp_value = ord(cp)
        if intranges_contain(cp_value, idnadata.codepoint_classes['PVALID']):
            continue
        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTJ']):
            try:
                if not valid_contextj(label, pos):
                    raise InvalidCodepointContext('Joiner {0} not allowed at position {1} in {2}'.format(
                        _unot(cp_value), pos+1, repr(label)))
            except ValueError:
                raise IDNAError('Unknown codepoint adjacent to joiner {0} at position {1} in {2}'.format(
                    _unot(cp_value), pos+1, repr(label)))
        elif intranges_contain(cp_value, idnadata.codepoint_classes['CONTEXTO']):
            if not valid_contexto(label, pos):
                raise InvalidCodepointContext('Codepoint {0} not allowed at position {1} in {2}'.format(_unot(cp_value), pos+1, repr(label)))
        else:
            raise InvalidCodepoint('Codepoint {0} at position {1} of {2} not allowed'.format(_unot(cp_value), pos+1, repr(label)))

    check_bidi(label)


def alabel(label):

    try:
        label = label.encode('ascii')
        ulabel(label)
        if not valid_label_length(label):
            raise IDNAError('Label too long')
        return label
    except UnicodeEncodeError:
        pass

    if not label:
        raise IDNAError('No Input')

    label = unicode(label)
    check_label(label)
    label = _punycode(label)
    label = _alabel_prefix + label

    if not valid_label_length(label):
        raise IDNAError('Label too long')

    return label


def ulabel(label):

    if not isinstance(label, (bytes, bytearray)):
        try:
            label = label.encode('ascii')
        except UnicodeEncodeError:
            check_label(label)
            return label

    label = label.lower()
    if label.startswith(_alabel_prefix):
        label = label[len(_alabel_prefix):]
    else:
        check_label(label)
        return label.decode('ascii')

    label = label.decode('punycode')
    check_label(label)
    return label


def uts46_remap(domain, std3_rules=True, transitional=False):
    """Re-map the characters in the string according to UTS46 processing."""
    from .uts46data import uts46data
    output = u""
    try:
        for pos, char in enumerate(domain):
            code_point = ord(char)
            uts46row = uts46data[code_point if code_point < 256 else
                bisect.bisect_left(uts46data, (code_point, "Z")) - 1]
            status = uts46row[1]
            replacement = uts46row[2] if len(uts46row) == 3 else None
            if (status == "V" or
                    (status == "D" and not transitional) or
                    (status == "3" and not std3_rules and replacement is None)):
                output += char
            elif replacement is not None and (status == "M" or
                    (status == "3" and not std3_rules) or
                    (status == "D" and transitional)):
                output += replacement
            elif status != "I":
                raise IndexError()
        return unicodedata.normalize("NFC", output)
    except IndexError:
        raise InvalidCodepoint(
            "Codepoint {0} not allowed at position {1} in {2}".format(
            _unot(code_point), pos + 1, repr(domain)))


def encode(s, strict=False, uts46=False, std3_rules=False, transitional=False):

    if isinstance(s, (bytes, bytearray)):
        s = s.decode("ascii")
    if uts46:
        s = uts46_remap(s, std3_rules, transitional)
    trailing_dot = False
    result = []
    if strict:
        labels = s.split('.')
    else:
        labels = _unicode_dots_re.split(s)
    if not labels or labels == ['']:
        raise IDNAError('Empty domain')
    if labels[-1] == '':
        del labels[-1]
        trailing_dot = True
    for label in labels:
        s = alabel(label)
        if s:
            result.append(s)
        else:
            raise IDNAError('Empty label')
    if trailing_dot:
        result.append(b'')
    s = b'.'.join(result)
    if not valid_string_length(s, trailing_dot):
        raise IDNAError('Domain too long')
    return s


def decode(s, strict=False, uts46=False, std3_rules=False):

    if isinstance(s, (bytes, bytearray)):
        s = s.decode("ascii")
    if uts46:
        s = uts46_remap(s, std3_rules, False)
    trailing_dot = False
    result = []
    if not strict:
        labels = _unicode_dots_re.split(s)
    else:
        labels = s.split(u'.')
    if not labels or labels == ['']:
        raise IDNAError('Empty domain')
    if not labels[-1]:
        del labels[-1]
        trailing_dot = True
    for label in labels:
        s = ulabel(label)
        if s:
            result.append(s)
        else:
            raise IDNAError('Empty label')
    if trailing_dot:
        result.append(u'')
    return u'.'.join(result)
site-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000334151446177000022500 0ustar00U

��.e4�@sddlmZdZdS)�)�wherez
2019.09.11N)Zcorer�__version__�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/certifi/__init__.py�<module>ssite-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-38.opt-1.pyc000064400000000337151446177000022464 0ustar00U

��.e5�@sddlmZee��dS)�)�whereN)Zpip._vendor.certifir�print�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/certifi/__main__.py�<module>ssite-packages/pip/_vendor/certifi/__pycache__/__main__.cpython-38.pyc000064400000000337151446177000021525 0ustar00U

��.e5�@sddlmZee��dS)�)�whereN)Zpip._vendor.certifir�print�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/certifi/__main__.py�<module>ssite-packages/pip/_vendor/certifi/__pycache__/core.cpython-38.pyc000064400000000621151446177000020731 0ustar00U

��.e��@sdZddlZdd�ZdS)zU
certifi.py
~~~~~~~~~~

This module returns the installation location of cacert.pem.
�NcCsdS)Nz /etc/pki/tls/certs/ca-bundle.crt�rrr�</usr/lib/python3.8/site-packages/pip/_vendor/certifi/core.py�wheresr)�__doc__�osrrrrr�<module>ssite-packages/pip/_vendor/certifi/__pycache__/__init__.cpython-38.pyc000064400000000334151446177000021541 0ustar00U

��.e4�@sddlmZdZdS)�)�wherez
2019.09.11N)Zcorer�__version__�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/certifi/__init__.py�<module>ssite-packages/pip/_vendor/certifi/__pycache__/core.cpython-38.opt-1.pyc000064400000000621151446177000021670 0ustar00U

��.e��@sdZddlZdd�ZdS)zU
certifi.py
~~~~~~~~~~

This module returns the installation location of cacert.pem.
�NcCsdS)Nz /etc/pki/tls/certs/ca-bundle.crt�rrr�</usr/lib/python3.8/site-packages/pip/_vendor/certifi/core.py�wheresr)�__doc__�osrrrrr�<module>ssite-packages/pip/_vendor/certifi/__init__.py000064400000000064151446177000015253 0ustar00from .core import where

__version__ = "2019.09.11"
site-packages/pip/_vendor/certifi/core.py000064400000000274151446177000014447 0ustar00# -*- coding: utf-8 -*-

"""
certifi.py
~~~~~~~~~~

This module returns the installation location of cacert.pem.
"""
import os


def where():
    return '/etc/pki/tls/certs/ca-bundle.crt'
site-packages/pip/_vendor/certifi/__main__.py000064400000000065151446177000015235 0ustar00from pip._vendor.certifi import where
print(where())
site-packages/pip/_vendor/chardet/universaldetector.py000064400000030305151446177000017244 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 2001
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################
"""
Module containing the UniversalDetector detector class, which is the primary
class a user of ``chardet`` should use.

:author: Mark Pilgrim (initial port to Python)
:author: Shy Shalom (original C code)
:author: Dan Blanchard (major refactoring for 3.0)
:author: Ian Cordasco
"""


import codecs
import logging
import re

from .charsetgroupprober import CharSetGroupProber
from .enums import InputState, LanguageFilter, ProbingState
from .escprober import EscCharSetProber
from .latin1prober import Latin1Prober
from .mbcsgroupprober import MBCSGroupProber
from .sbcsgroupprober import SBCSGroupProber


class UniversalDetector(object):
    """
    The ``UniversalDetector`` class underlies the ``chardet.detect`` function
    and coordinates all of the different charset probers.

    To get a ``dict`` containing an encoding and its confidence, you can simply
    run:

    .. code::

            u = UniversalDetector()
            u.feed(some_bytes)
            u.close()
            detected = u.result

    """

    MINIMUM_THRESHOLD = 0.20
    HIGH_BYTE_DETECTOR = re.compile(b'[\x80-\xFF]')
    ESC_DETECTOR = re.compile(b'(\033|~{)')
    WIN_BYTE_DETECTOR = re.compile(b'[\x80-\x9F]')
    ISO_WIN_MAP = {'iso-8859-1': 'Windows-1252',
                   'iso-8859-2': 'Windows-1250',
                   'iso-8859-5': 'Windows-1251',
                   'iso-8859-6': 'Windows-1256',
                   'iso-8859-7': 'Windows-1253',
                   'iso-8859-8': 'Windows-1255',
                   'iso-8859-9': 'Windows-1254',
                   'iso-8859-13': 'Windows-1257'}

    def __init__(self, lang_filter=LanguageFilter.ALL):
        self._esc_charset_prober = None
        self._charset_probers = []
        self.result = None
        self.done = None
        self._got_data = None
        self._input_state = None
        self._last_char = None
        self.lang_filter = lang_filter
        self.logger = logging.getLogger(__name__)
        self._has_win_bytes = None
        self.reset()

    def reset(self):
        """
        Reset the UniversalDetector and all of its probers back to their
        initial states.  This is called by ``__init__``, so you only need to
        call this directly in between analyses of different documents.
        """
        self.result = {'encoding': None, 'confidence': 0.0, 'language': None}
        self.done = False
        self._got_data = False
        self._has_win_bytes = False
        self._input_state = InputState.PURE_ASCII
        self._last_char = b''
        if self._esc_charset_prober:
            self._esc_charset_prober.reset()
        for prober in self._charset_probers:
            prober.reset()

    def feed(self, byte_str):
        """
        Takes a chunk of a document and feeds it through all of the relevant
        charset probers.

        After calling ``feed``, you can check the value of the ``done``
        attribute to see if you need to continue feeding the
        ``UniversalDetector`` more data, or if it has made a prediction
        (in the ``result`` attribute).

        .. note::
           You should always call ``close`` when you're done feeding in your
           document if ``done`` is not already ``True``.
        """
        if self.done:
            return

        if not len(byte_str):
            return

        if not isinstance(byte_str, bytearray):
            byte_str = bytearray(byte_str)

        # First check for known BOMs, since these are guaranteed to be correct
        if not self._got_data:
            # If the data starts with BOM, we know it is UTF
            if byte_str.startswith(codecs.BOM_UTF8):
                # EF BB BF  UTF-8 with BOM
                self.result = {'encoding': "UTF-8-SIG",
                               'confidence': 1.0,
                               'language': ''}
            elif byte_str.startswith((codecs.BOM_UTF32_LE,
                                      codecs.BOM_UTF32_BE)):
                # FF FE 00 00  UTF-32, little-endian BOM
                # 00 00 FE FF  UTF-32, big-endian BOM
                self.result = {'encoding': "UTF-32",
                               'confidence': 1.0,
                               'language': ''}
            elif byte_str.startswith(b'\xFE\xFF\x00\x00'):
                # FE FF 00 00  UCS-4, unusual octet order BOM (3412)
                self.result = {'encoding': "X-ISO-10646-UCS-4-3412",
                               'confidence': 1.0,
                               'language': ''}
            elif byte_str.startswith(b'\x00\x00\xFF\xFE'):
                # 00 00 FF FE  UCS-4, unusual octet order BOM (2143)
                self.result = {'encoding': "X-ISO-10646-UCS-4-2143",
                               'confidence': 1.0,
                               'language': ''}
            elif byte_str.startswith((codecs.BOM_LE, codecs.BOM_BE)):
                # FF FE  UTF-16, little endian BOM
                # FE FF  UTF-16, big endian BOM
                self.result = {'encoding': "UTF-16",
                               'confidence': 1.0,
                               'language': ''}

            self._got_data = True
            if self.result['encoding'] is not None:
                self.done = True
                return

        # If none of those matched and we've only see ASCII so far, check
        # for high bytes and escape sequences
        if self._input_state == InputState.PURE_ASCII:
            if self.HIGH_BYTE_DETECTOR.search(byte_str):
                self._input_state = InputState.HIGH_BYTE
            elif self._input_state == InputState.PURE_ASCII and \
                    self.ESC_DETECTOR.search(self._last_char + byte_str):
                self._input_state = InputState.ESC_ASCII

        self._last_char = byte_str[-1:]

        # If we've seen escape sequences, use the EscCharSetProber, which
        # uses a simple state machine to check for known escape sequences in
        # HZ and ISO-2022 encodings, since those are the only encodings that
        # use such sequences.
        if self._input_state == InputState.ESC_ASCII:
            if not self._esc_charset_prober:
                self._esc_charset_prober = EscCharSetProber(self.lang_filter)
            if self._esc_charset_prober.feed(byte_str) == ProbingState.FOUND_IT:
                self.result = {'encoding':
                               self._esc_charset_prober.charset_name,
                               'confidence':
                               self._esc_charset_prober.get_confidence(),
                               'language':
                               self._esc_charset_prober.language}
                self.done = True
        # If we've seen high bytes (i.e., those with values greater than 127),
        # we need to do more complicated checks using all our multi-byte and
        # single-byte probers that are left.  The single-byte probers
        # use character bigram distributions to determine the encoding, whereas
        # the multi-byte probers use a combination of character unigram and
        # bigram distributions.
        elif self._input_state == InputState.HIGH_BYTE:
            if not self._charset_probers:
                self._charset_probers = [MBCSGroupProber(self.lang_filter)]
                # If we're checking non-CJK encodings, use single-byte prober
                if self.lang_filter & LanguageFilter.NON_CJK:
                    self._charset_probers.append(SBCSGroupProber())
                self._charset_probers.append(Latin1Prober())
            for prober in self._charset_probers:
                if prober.feed(byte_str) == ProbingState.FOUND_IT:
                    self.result = {'encoding': prober.charset_name,
                                   'confidence': prober.get_confidence(),
                                   'language': prober.language}
                    self.done = True
                    break
            if self.WIN_BYTE_DETECTOR.search(byte_str):
                self._has_win_bytes = True

    def close(self):
        """
        Stop analyzing the current document and come up with a final
        prediction.

        :returns:  The ``result`` attribute, a ``dict`` with the keys
                   `encoding`, `confidence`, and `language`.
        """
        # Don't bother with checks if we're already done
        if self.done:
            return self.result
        self.done = True

        if not self._got_data:
            self.logger.debug('no data received!')

        # Default to ASCII if it is all we've seen so far
        elif self._input_state == InputState.PURE_ASCII:
            self.result = {'encoding': 'ascii',
                           'confidence': 1.0,
                           'language': ''}

        # If we have seen non-ASCII, return the best that met MINIMUM_THRESHOLD
        elif self._input_state == InputState.HIGH_BYTE:
            prober_confidence = None
            max_prober_confidence = 0.0
            max_prober = None
            for prober in self._charset_probers:
                if not prober:
                    continue
                prober_confidence = prober.get_confidence()
                if prober_confidence > max_prober_confidence:
                    max_prober_confidence = prober_confidence
                    max_prober = prober
            if max_prober and (max_prober_confidence > self.MINIMUM_THRESHOLD):
                charset_name = max_prober.charset_name
                lower_charset_name = max_prober.charset_name.lower()
                confidence = max_prober.get_confidence()
                # Use Windows encoding name instead of ISO-8859 if we saw any
                # extra Windows-specific bytes
                if lower_charset_name.startswith('iso-8859'):
                    if self._has_win_bytes:
                        charset_name = self.ISO_WIN_MAP.get(lower_charset_name,
                                                            charset_name)
                self.result = {'encoding': charset_name,
                               'confidence': confidence,
                               'language': max_prober.language}

        # Log all prober confidences if none met MINIMUM_THRESHOLD
        if self.logger.getEffectiveLevel() == logging.DEBUG:
            if self.result['encoding'] is None:
                self.logger.debug('no probers hit minimum threshold')
                for group_prober in self._charset_probers:
                    if not group_prober:
                        continue
                    if isinstance(group_prober, CharSetGroupProber):
                        for prober in group_prober.probers:
                            self.logger.debug('%s %s confidence = %s',
                                              prober.charset_name,
                                              prober.language,
                                              prober.get_confidence())
                    else:
                        self.logger.debug('%s %s confidence = %s',
                                          prober.charset_name,
                                          prober.language,
                                          prober.get_confidence())
        return self.result
site-packages/pip/_vendor/chardet/euckrfreq.py000064400000032352151446177000015475 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# Sampling from about 20M text materials include literature and computer technology

# 128  --> 0.79
# 256  --> 0.92
# 512  --> 0.986
# 1024 --> 0.99944
# 2048 --> 0.99999
#
# Idea Distribution Ratio = 0.98653 / (1-0.98653) = 73.24
# Random Distribution Ration = 512 / (2350-512) = 0.279.
#
# Typical Distribution Ratio

EUCKR_TYPICAL_DISTRIBUTION_RATIO = 6.0

EUCKR_TABLE_SIZE = 2352

# Char to FreqOrder table ,
EUCKR_CHAR_TO_FREQ_ORDER = (
  13, 130, 120,1396, 481,1719,1720, 328, 609, 212,1721, 707, 400, 299,1722,  87,
1397,1723, 104, 536,1117,1203,1724,1267, 685,1268, 508,1725,1726,1727,1728,1398,
1399,1729,1730,1731, 141, 621, 326,1057, 368,1732, 267, 488,  20,1733,1269,1734,
 945,1400,1735,  47, 904,1270,1736,1737, 773, 248,1738, 409, 313, 786, 429,1739,
 116, 987, 813,1401, 683,  75,1204, 145,1740,1741,1742,1743,  16, 847, 667, 622,
 708,1744,1745,1746, 966, 787, 304, 129,1747,  60, 820, 123, 676,1748,1749,1750,
1751, 617,1752, 626,1753,1754,1755,1756, 653,1757,1758,1759,1760,1761,1762, 856,
 344,1763,1764,1765,1766,  89, 401, 418, 806, 905, 848,1767,1768,1769, 946,1205,
 709,1770,1118,1771, 241,1772,1773,1774,1271,1775, 569,1776, 999,1777,1778,1779,
1780, 337, 751,1058,  28, 628, 254,1781, 177, 906, 270, 349, 891,1079,1782,  19,
1783, 379,1784, 315,1785, 629, 754,1402, 559,1786, 636, 203,1206,1787, 710, 567,
1788, 935, 814,1789,1790,1207, 766, 528,1791,1792,1208,1793,1794,1795,1796,1797,
1403,1798,1799, 533,1059,1404,1405,1156,1406, 936, 884,1080,1800, 351,1801,1802,
1803,1804,1805, 801,1806,1807,1808,1119,1809,1157, 714, 474,1407,1810, 298, 899,
 885,1811,1120, 802,1158,1812, 892,1813,1814,1408, 659,1815,1816,1121,1817,1818,
1819,1820,1821,1822, 319,1823, 594, 545,1824, 815, 937,1209,1825,1826, 573,1409,
1022,1827,1210,1828,1829,1830,1831,1832,1833, 556, 722, 807,1122,1060,1834, 697,
1835, 900, 557, 715,1836,1410, 540,1411, 752,1159, 294, 597,1211, 976, 803, 770,
1412,1837,1838,  39, 794,1413, 358,1839, 371, 925,1840, 453, 661, 788, 531, 723,
 544,1023,1081, 869,  91,1841, 392, 430, 790, 602,1414, 677,1082, 457,1415,1416,
1842,1843, 475, 327,1024,1417, 795, 121,1844, 733, 403,1418,1845,1846,1847, 300,
 119, 711,1212, 627,1848,1272, 207,1849,1850, 796,1213, 382,1851, 519,1852,1083,
 893,1853,1854,1855, 367, 809, 487, 671,1856, 663,1857,1858, 956, 471, 306, 857,
1859,1860,1160,1084,1861,1862,1863,1864,1865,1061,1866,1867,1868,1869,1870,1871,
 282,  96, 574,1872, 502,1085,1873,1214,1874, 907,1875,1876, 827, 977,1419,1420,
1421, 268,1877,1422,1878,1879,1880, 308,1881,   2, 537,1882,1883,1215,1884,1885,
 127, 791,1886,1273,1423,1887,  34, 336, 404, 643,1888, 571, 654, 894, 840,1889,
   0, 886,1274, 122, 575, 260, 908, 938,1890,1275, 410, 316,1891,1892, 100,1893,
1894,1123,  48,1161,1124,1025,1895, 633, 901,1276,1896,1897, 115, 816,1898, 317,
1899, 694,1900, 909, 734,1424, 572, 866,1425, 691,  85, 524,1010, 543, 394, 841,
1901,1902,1903,1026,1904,1905,1906,1907,1908,1909,  30, 451, 651, 988, 310,1910,
1911,1426, 810,1216,  93,1912,1913,1277,1217,1914, 858, 759,  45,  58, 181, 610,
 269,1915,1916, 131,1062, 551, 443,1000, 821,1427, 957, 895,1086,1917,1918, 375,
1919, 359,1920, 687,1921, 822,1922, 293,1923,1924,  40, 662, 118, 692,  29, 939,
 887, 640, 482, 174,1925,  69,1162, 728,1428, 910,1926,1278,1218,1279, 386, 870,
 217, 854,1163, 823,1927,1928,1929,1930, 834,1931,  78,1932, 859,1933,1063,1934,
1935,1936,1937, 438,1164, 208, 595,1938,1939,1940,1941,1219,1125,1942, 280, 888,
1429,1430,1220,1431,1943,1944,1945,1946,1947,1280, 150, 510,1432,1948,1949,1950,
1951,1952,1953,1954,1011,1087,1955,1433,1043,1956, 881,1957, 614, 958,1064,1065,
1221,1958, 638,1001, 860, 967, 896,1434, 989, 492, 553,1281,1165,1959,1282,1002,
1283,1222,1960,1961,1962,1963,  36, 383, 228, 753, 247, 454,1964, 876, 678,1965,
1966,1284, 126, 464, 490, 835, 136, 672, 529, 940,1088,1435, 473,1967,1968, 467,
  50, 390, 227, 587, 279, 378, 598, 792, 968, 240, 151, 160, 849, 882,1126,1285,
 639,1044, 133, 140, 288, 360, 811, 563,1027, 561, 142, 523,1969,1970,1971,   7,
 103, 296, 439, 407, 506, 634, 990,1972,1973,1974,1975, 645,1976,1977,1978,1979,
1980,1981, 236,1982,1436,1983,1984,1089, 192, 828, 618, 518,1166, 333,1127,1985,
 818,1223,1986,1987,1988,1989,1990,1991,1992,1993, 342,1128,1286, 746, 842,1994,
1995, 560, 223,1287,  98,   8, 189, 650, 978,1288,1996,1437,1997,  17, 345, 250,
 423, 277, 234, 512, 226,  97, 289,  42, 167,1998, 201,1999,2000, 843, 836, 824,
 532, 338, 783,1090, 182, 576, 436,1438,1439, 527, 500,2001, 947, 889,2002,2003,
2004,2005, 262, 600, 314, 447,2006, 547,2007, 693, 738,1129,2008,  71,1440, 745,
 619, 688,2009, 829,2010,2011, 147,2012,  33, 948,2013,2014,  74, 224,2015,  61,
 191, 918, 399, 637,2016,1028,1130, 257, 902,2017,2018,2019,2020,2021,2022,2023,
2024,2025,2026, 837,2027,2028,2029,2030, 179, 874, 591,  52, 724, 246,2031,2032,
2033,2034,1167, 969,2035,1289, 630, 605, 911,1091,1168,2036,2037,2038,1441, 912,
2039, 623,2040,2041, 253,1169,1290,2042,1442, 146, 620, 611, 577, 433,2043,1224,
 719,1170, 959, 440, 437, 534,  84, 388, 480,1131, 159, 220, 198, 679,2044,1012,
 819,1066,1443, 113,1225, 194, 318,1003,1029,2045,2046,2047,2048,1067,2049,2050,
2051,2052,2053,  59, 913, 112,2054, 632,2055, 455, 144, 739,1291,2056, 273, 681,
 499,2057, 448,2058,2059, 760,2060,2061, 970, 384, 169, 245,1132,2062,2063, 414,
1444,2064,2065,  41, 235,2066, 157, 252, 877, 568, 919, 789, 580,2067, 725,2068,
2069,1292,2070,2071,1445,2072,1446,2073,2074,  55, 588,  66,1447, 271,1092,2075,
1226,2076, 960,1013, 372,2077,2078,2079,2080,2081,1293,2082,2083,2084,2085, 850,
2086,2087,2088,2089,2090, 186,2091,1068, 180,2092,2093,2094, 109,1227, 522, 606,
2095, 867,1448,1093, 991,1171, 926, 353,1133,2096, 581,2097,2098,2099,1294,1449,
1450,2100, 596,1172,1014,1228,2101,1451,1295,1173,1229,2102,2103,1296,1134,1452,
 949,1135,2104,2105,1094,1453,1454,1455,2106,1095,2107,2108,2109,2110,2111,2112,
2113,2114,2115,2116,2117, 804,2118,2119,1230,1231, 805,1456, 405,1136,2120,2121,
2122,2123,2124, 720, 701,1297, 992,1457, 927,1004,2125,2126,2127,2128,2129,2130,
  22, 417,2131, 303,2132, 385,2133, 971, 520, 513,2134,1174,  73,1096, 231, 274,
 962,1458, 673,2135,1459,2136, 152,1137,2137,2138,2139,2140,1005,1138,1460,1139,
2141,2142,2143,2144,  11, 374, 844,2145, 154,1232,  46,1461,2146, 838, 830, 721,
1233, 106,2147,  90, 428, 462, 578, 566,1175, 352,2148,2149, 538,1234, 124,1298,
2150,1462, 761, 565,2151, 686,2152, 649,2153,  72, 173,2154, 460, 415,2155,1463,
2156,1235, 305,2157,2158,2159,2160,2161,2162, 579,2163,2164,2165,2166,2167, 747,
2168,2169,2170,2171,1464, 669,2172,2173,2174,2175,2176,1465,2177,  23, 530, 285,
2178, 335, 729,2179, 397,2180,2181,2182,1030,2183,2184, 698,2185,2186, 325,2187,
2188, 369,2189, 799,1097,1015, 348,2190,1069, 680,2191, 851,1466,2192,2193,  10,
2194, 613, 424,2195, 979, 108, 449, 589,  27, 172,  81,1031,  80, 774, 281, 350,
1032, 525, 301, 582,1176,2196, 674,1045,2197,2198,1467, 730, 762,2199,2200,2201,
2202,1468,2203, 993,2204,2205, 266,1070, 963,1140,2206,2207,2208, 664,1098, 972,
2209,2210,2211,1177,1469,1470, 871,2212,2213,2214,2215,2216,1471,2217,2218,2219,
2220,2221,2222,2223,2224,2225,2226,2227,1472,1236,2228,2229,2230,2231,2232,2233,
2234,2235,1299,2236,2237, 200,2238, 477, 373,2239,2240, 731, 825, 777,2241,2242,
2243, 521, 486, 548,2244,2245,2246,1473,1300,  53, 549, 137, 875,  76, 158,2247,
1301,1474, 469, 396,1016, 278, 712,2248, 321, 442, 503, 767, 744, 941,1237,1178,
1475,2249,  82, 178,1141,1179, 973,2250,1302,2251, 297,2252,2253, 570,2254,2255,
2256,  18, 450, 206,2257, 290, 292,1142,2258, 511, 162,  99, 346, 164, 735,2259,
1476,1477,   4, 554, 343, 798,1099,2260,1100,2261,  43, 171,1303, 139, 215,2262,
2263, 717, 775,2264,1033, 322, 216,2265, 831,2266, 149,2267,1304,2268,2269, 702,
1238, 135, 845, 347, 309,2270, 484,2271, 878, 655, 238,1006,1478,2272,  67,2273,
 295,2274,2275, 461,2276, 478, 942, 412,2277,1034,2278,2279,2280, 265,2281, 541,
2282,2283,2284,2285,2286,  70, 852,1071,2287,2288,2289,2290,  21,  56, 509, 117,
 432,2291,2292, 331, 980, 552,1101, 148, 284, 105, 393,1180,1239, 755,2293, 187,
2294,1046,1479,2295, 340,2296,  63,1047, 230,2297,2298,1305, 763,1306, 101, 800,
 808, 494,2299,2300,2301, 903,2302,  37,1072,  14,   5,2303,  79, 675,2304, 312,
2305,2306,2307,2308,2309,1480,   6,1307,2310,2311,2312,   1, 470,  35,  24, 229,
2313, 695, 210,  86, 778,  15, 784, 592, 779,  32,  77, 855, 964,2314, 259,2315,
 501, 380,2316,2317,  83, 981, 153, 689,1308,1481,1482,1483,2318,2319, 716,1484,
2320,2321,2322,2323,2324,2325,1485,2326,2327, 128,  57,  68, 261,1048, 211, 170,
1240,  31,2328,  51, 435, 742,2329,2330,2331, 635,2332, 264, 456,2333,2334,2335,
 425,2336,1486, 143, 507, 263, 943,2337, 363, 920,1487, 256,1488,1102, 243, 601,
1489,2338,2339,2340,2341,2342,2343,2344, 861,2345,2346,2347,2348,2349,2350, 395,
2351,1490,1491,  62, 535, 166, 225,2352,2353, 668, 419,1241, 138, 604, 928,2354,
1181,2355,1492,1493,2356,2357,2358,1143,2359, 696,2360, 387, 307,1309, 682, 476,
2361,2362, 332,  12, 222, 156,2363, 232,2364, 641, 276, 656, 517,1494,1495,1035,
 416, 736,1496,2365,1017, 586,2366,2367,2368,1497,2369, 242,2370,2371,2372,1498,
2373, 965, 713,2374,2375,2376,2377, 740, 982,1499, 944,1500,1007,2378,2379,1310,
1501,2380,2381,2382, 785, 329,2383,2384,1502,2385,2386,2387, 932,2388,1503,2389,
2390,2391,2392,1242,2393,2394,2395,2396,2397, 994, 950,2398,2399,2400,2401,1504,
1311,2402,2403,2404,2405,1049, 749,2406,2407, 853, 718,1144,1312,2408,1182,1505,
2409,2410, 255, 516, 479, 564, 550, 214,1506,1507,1313, 413, 239, 444, 339,1145,
1036,1508,1509,1314,1037,1510,1315,2411,1511,2412,2413,2414, 176, 703, 497, 624,
 593, 921, 302,2415, 341, 165,1103,1512,2416,1513,2417,2418,2419, 376,2420, 700,
2421,2422,2423, 258, 768,1316,2424,1183,2425, 995, 608,2426,2427,2428,2429, 221,
2430,2431,2432,2433,2434,2435,2436,2437, 195, 323, 726, 188, 897, 983,1317, 377,
 644,1050, 879,2438, 452,2439,2440,2441,2442,2443,2444, 914,2445,2446,2447,2448,
 915, 489,2449,1514,1184,2450,2451, 515,  64, 427, 495,2452, 583,2453, 483, 485,
1038, 562, 213,1515, 748, 666,2454,2455,2456,2457, 334,2458, 780, 996,1008, 705,
1243,2459,2460,2461,2462,2463, 114,2464, 493,1146, 366, 163,1516, 961,1104,2465,
 291,2466,1318,1105,2467,1517, 365,2468, 355, 951,1244,2469,1319,2470, 631,2471,
2472, 218,1320, 364, 320, 756,1518,1519,1321,1520,1322,2473,2474,2475,2476, 997,
2477,2478,2479,2480, 665,1185,2481, 916,1521,2482,2483,2484, 584, 684,2485,2486,
 797,2487,1051,1186,2488,2489,2490,1522,2491,2492, 370,2493,1039,1187,  65,2494,
 434, 205, 463,1188,2495, 125, 812, 391, 402, 826, 699, 286, 398, 155, 781, 771,
 585,2496, 590, 505,1073,2497, 599, 244, 219, 917,1018, 952, 646,1523,2498,1323,
2499,2500,  49, 984, 354, 741,2501, 625,2502,1324,2503,1019, 190, 357, 757, 491,
  95, 782, 868,2504,2505,2506,2507,2508,2509, 134,1524,1074, 422,1525, 898,2510,
 161,2511,2512,2513,2514, 769,2515,1526,2516,2517, 411,1325,2518, 472,1527,2519,
2520,2521,2522,2523,2524, 985,2525,2526,2527,2528,2529,2530, 764,2531,1245,2532,
2533,  25, 204, 311,2534, 496,2535,1052,2536,2537,2538,2539,2540,2541,2542, 199,
 704, 504, 468, 758, 657,1528, 196,  44, 839,1246, 272, 750,2543, 765, 862,2544,
2545,1326,2546, 132, 615, 933,2547, 732,2548,2549,2550,1189,1529,2551, 283,1247,
1053, 607, 929,2552,2553,2554, 930, 183, 872, 616,1040,1147,2555,1148,1020, 441,
 249,1075,2556,2557,2558, 466, 743,2559,2560,2561,  92, 514, 426, 420, 526,2562,
2563,2564,2565,2566,2567,2568, 185,2569,2570,2571,2572, 776,1530, 658,2573, 362,
2574, 361, 922,1076, 793,2575,2576,2577,2578,2579,2580,1531, 251,2581,2582,2583,
2584,1532,  54, 612, 237,1327,2585,2586, 275, 408, 647, 111,2587,1533,1106, 465,
   3, 458,   9,  38,2588, 107, 110, 890, 209,  26, 737, 498,2589,1534,2590, 431,
 202,  88,1535, 356, 287,1107, 660,1149,2591, 381,1536, 986,1150, 445,1248,1151,
 974,2592,2593, 846,2594, 446, 953, 184,1249,1250, 727,2595, 923, 193, 883,2596,
2597,2598, 102, 324, 539, 817,2599, 421,1041,2600, 832,2601,  94, 175, 197, 406,
2602, 459,2603,2604,2605,2606,2607, 330, 555,2608,2609,2610, 706,1108, 389,2611,
2612,2613,2614, 233,2615, 833, 558, 931, 954,1251,2616,2617,1537, 546,2618,2619,
1009,2620,2621,2622,1538, 690,1328,2623, 955,2624,1539,2625,2626, 772,2627,2628,
2629,2630,2631, 924, 648, 863, 603,2632,2633, 934,1540, 864, 865,2634, 642,1042,
 670,1190,2635,2636,2637,2638, 168,2639, 652, 873, 542,1054,1541,2640,2641,2642,  # 512, 256
)

site-packages/pip/_vendor/chardet/jpcntx.py000064400000046273151446177000015023 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################


# This is hiragana 2-char sequence table, the number in each cell represents its frequency category
jp2CharContext = (
(0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1),
(2,4,0,4,0,3,0,4,0,3,4,4,4,2,4,3,3,4,3,2,3,3,4,2,3,3,3,2,4,1,4,3,3,1,5,4,3,4,3,4,3,5,3,0,3,5,4,2,0,3,1,0,3,3,0,3,3,0,1,1,0,4,3,0,3,3,0,4,0,2,0,3,5,5,5,5,4,0,4,1,0,3,4),
(0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2),
(0,4,0,5,0,5,0,4,0,4,5,4,4,3,5,3,5,1,5,3,4,3,4,4,3,4,3,3,4,3,5,4,4,3,5,5,3,5,5,5,3,5,5,3,4,5,5,3,1,3,2,0,3,4,0,4,2,0,4,2,1,5,3,2,3,5,0,4,0,2,0,5,4,4,5,4,5,0,4,0,0,4,4),
(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
(0,3,0,4,0,3,0,3,0,4,5,4,3,3,3,3,4,3,5,4,4,3,5,4,4,3,4,3,4,4,4,4,5,3,4,4,3,4,5,5,4,5,5,1,4,5,4,3,0,3,3,1,3,3,0,4,4,0,3,3,1,5,3,3,3,5,0,4,0,3,0,4,4,3,4,3,3,0,4,1,1,3,4),
(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
(0,4,0,3,0,3,0,4,0,3,4,4,3,2,2,1,2,1,3,1,3,3,3,3,3,4,3,1,3,3,5,3,3,0,4,3,0,5,4,3,3,5,4,4,3,4,4,5,0,1,2,0,1,2,0,2,2,0,1,0,0,5,2,2,1,4,0,3,0,1,0,4,4,3,5,4,3,0,2,1,0,4,3),
(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
(0,3,0,5,0,4,0,2,1,4,4,2,4,1,4,2,4,2,4,3,3,3,4,3,3,3,3,1,4,2,3,3,3,1,4,4,1,1,1,4,3,3,2,0,2,4,3,2,0,3,3,0,3,1,1,0,0,0,3,3,0,4,2,2,3,4,0,4,0,3,0,4,4,5,3,4,4,0,3,0,0,1,4),
(1,4,0,4,0,4,0,4,0,3,5,4,4,3,4,3,5,4,3,3,4,3,5,4,4,4,4,3,4,2,4,3,3,1,5,4,3,2,4,5,4,5,5,4,4,5,4,4,0,3,2,2,3,3,0,4,3,1,3,2,1,4,3,3,4,5,0,3,0,2,0,4,5,5,4,5,4,0,4,0,0,5,4),
(0,5,0,5,0,4,0,3,0,4,4,3,4,3,3,3,4,0,4,4,4,3,4,3,4,3,3,1,4,2,4,3,4,0,5,4,1,4,5,4,4,5,3,2,4,3,4,3,2,4,1,3,3,3,2,3,2,0,4,3,3,4,3,3,3,4,0,4,0,3,0,4,5,4,4,4,3,0,4,1,0,1,3),
(0,3,1,4,0,3,0,2,0,3,4,4,3,1,4,2,3,3,4,3,4,3,4,3,4,4,3,2,3,1,5,4,4,1,4,4,3,5,4,4,3,5,5,4,3,4,4,3,1,2,3,1,2,2,0,3,2,0,3,1,0,5,3,3,3,4,3,3,3,3,4,4,4,4,5,4,2,0,3,3,2,4,3),
(0,2,0,3,0,1,0,1,0,0,3,2,0,0,2,0,1,0,2,1,3,3,3,1,2,3,1,0,1,0,4,2,1,1,3,3,0,4,3,3,1,4,3,3,0,3,3,2,0,0,0,0,1,0,0,2,0,0,0,0,0,4,1,0,2,3,2,2,2,1,3,3,3,4,4,3,2,0,3,1,0,3,3),
(0,4,0,4,0,3,0,3,0,4,4,4,3,3,3,3,3,3,4,3,4,2,4,3,4,3,3,2,4,3,4,5,4,1,4,5,3,5,4,5,3,5,4,0,3,5,5,3,1,3,3,2,2,3,0,3,4,1,3,3,2,4,3,3,3,4,0,4,0,3,0,4,5,4,4,5,3,0,4,1,0,3,4),
(0,2,0,3,0,3,0,0,0,2,2,2,1,0,1,0,0,0,3,0,3,0,3,0,1,3,1,0,3,1,3,3,3,1,3,3,3,0,1,3,1,3,4,0,0,3,1,1,0,3,2,0,0,0,0,1,3,0,1,0,0,3,3,2,0,3,0,0,0,0,0,3,4,3,4,3,3,0,3,0,0,2,3),
(2,3,0,3,0,2,0,1,0,3,3,4,3,1,3,1,1,1,3,1,4,3,4,3,3,3,0,0,3,1,5,4,3,1,4,3,2,5,5,4,4,4,4,3,3,4,4,4,0,2,1,1,3,2,0,1,2,0,0,1,0,4,1,3,3,3,0,3,0,1,0,4,4,4,5,5,3,0,2,0,0,4,4),
(0,2,0,1,0,3,1,3,0,2,3,3,3,0,3,1,0,0,3,0,3,2,3,1,3,2,1,1,0,0,4,2,1,0,2,3,1,4,3,2,0,4,4,3,1,3,1,3,0,1,0,0,1,0,0,0,1,0,0,0,0,4,1,1,1,2,0,3,0,0,0,3,4,2,4,3,2,0,1,0,0,3,3),
(0,1,0,4,0,5,0,4,0,2,4,4,2,3,3,2,3,3,5,3,3,3,4,3,4,2,3,0,4,3,3,3,4,1,4,3,2,1,5,5,3,4,5,1,3,5,4,2,0,3,3,0,1,3,0,4,2,0,1,3,1,4,3,3,3,3,0,3,0,1,0,3,4,4,4,5,5,0,3,0,1,4,5),
(0,2,0,3,0,3,0,0,0,2,3,1,3,0,4,0,1,1,3,0,3,4,3,2,3,1,0,3,3,2,3,1,3,0,2,3,0,2,1,4,1,2,2,0,0,3,3,0,0,2,0,0,0,1,0,0,0,0,2,2,0,3,2,1,3,3,0,2,0,2,0,0,3,3,1,2,4,0,3,0,2,2,3),
(2,4,0,5,0,4,0,4,0,2,4,4,4,3,4,3,3,3,1,2,4,3,4,3,4,4,5,0,3,3,3,3,2,0,4,3,1,4,3,4,1,4,4,3,3,4,4,3,1,2,3,0,4,2,0,4,1,0,3,3,0,4,3,3,3,4,0,4,0,2,0,3,5,3,4,5,2,0,3,0,0,4,5),
(0,3,0,4,0,1,0,1,0,1,3,2,2,1,3,0,3,0,2,0,2,0,3,0,2,0,0,0,1,0,1,1,0,0,3,1,0,0,0,4,0,3,1,0,2,1,3,0,0,0,0,0,0,3,0,0,0,0,0,0,0,4,2,2,3,1,0,3,0,0,0,1,4,4,4,3,0,0,4,0,0,1,4),
(1,4,1,5,0,3,0,3,0,4,5,4,4,3,5,3,3,4,4,3,4,1,3,3,3,3,2,1,4,1,5,4,3,1,4,4,3,5,4,4,3,5,4,3,3,4,4,4,0,3,3,1,2,3,0,3,1,0,3,3,0,5,4,4,4,4,4,4,3,3,5,4,4,3,3,5,4,0,3,2,0,4,4),
(0,2,0,3,0,1,0,0,0,1,3,3,3,2,4,1,3,0,3,1,3,0,2,2,1,1,0,0,2,0,4,3,1,0,4,3,0,4,4,4,1,4,3,1,1,3,3,1,0,2,0,0,1,3,0,0,0,0,2,0,0,4,3,2,4,3,5,4,3,3,3,4,3,3,4,3,3,0,2,1,0,3,3),
(0,2,0,4,0,3,0,2,0,2,5,5,3,4,4,4,4,1,4,3,3,0,4,3,4,3,1,3,3,2,4,3,0,3,4,3,0,3,4,4,2,4,4,0,4,5,3,3,2,2,1,1,1,2,0,1,5,0,3,3,2,4,3,3,3,4,0,3,0,2,0,4,4,3,5,5,0,0,3,0,2,3,3),
(0,3,0,4,0,3,0,1,0,3,4,3,3,1,3,3,3,0,3,1,3,0,4,3,3,1,1,0,3,0,3,3,0,0,4,4,0,1,5,4,3,3,5,0,3,3,4,3,0,2,0,1,1,1,0,1,3,0,1,2,1,3,3,2,3,3,0,3,0,1,0,1,3,3,4,4,1,0,1,2,2,1,3),
(0,1,0,4,0,4,0,3,0,1,3,3,3,2,3,1,1,0,3,0,3,3,4,3,2,4,2,0,1,0,4,3,2,0,4,3,0,5,3,3,2,4,4,4,3,3,3,4,0,1,3,0,0,1,0,0,1,0,0,0,0,4,2,3,3,3,0,3,0,0,0,4,4,4,5,3,2,0,3,3,0,3,5),
(0,2,0,3,0,0,0,3,0,1,3,0,2,0,0,0,1,0,3,1,1,3,3,0,0,3,0,0,3,0,2,3,1,0,3,1,0,3,3,2,0,4,2,2,0,2,0,0,0,4,0,0,0,0,0,0,0,0,0,0,0,2,1,2,0,1,0,1,0,0,0,1,3,1,2,0,0,0,1,0,0,1,4),
(0,3,0,3,0,5,0,1,0,2,4,3,1,3,3,2,1,1,5,2,1,0,5,1,2,0,0,0,3,3,2,2,3,2,4,3,0,0,3,3,1,3,3,0,2,5,3,4,0,3,3,0,1,2,0,2,2,0,3,2,0,2,2,3,3,3,0,2,0,1,0,3,4,4,2,5,4,0,3,0,0,3,5),
(0,3,0,3,0,3,0,1,0,3,3,3,3,0,3,0,2,0,2,1,1,0,2,0,1,0,0,0,2,1,0,0,1,0,3,2,0,0,3,3,1,2,3,1,0,3,3,0,0,1,0,0,0,0,0,2,0,0,0,0,0,2,3,1,2,3,0,3,0,1,0,3,2,1,0,4,3,0,1,1,0,3,3),
(0,4,0,5,0,3,0,3,0,4,5,5,4,3,5,3,4,3,5,3,3,2,5,3,4,4,4,3,4,3,4,5,5,3,4,4,3,4,4,5,4,4,4,3,4,5,5,4,2,3,4,2,3,4,0,3,3,1,4,3,2,4,3,3,5,5,0,3,0,3,0,5,5,5,5,4,4,0,4,0,1,4,4),
(0,4,0,4,0,3,0,3,0,3,5,4,4,2,3,2,5,1,3,2,5,1,4,2,3,2,3,3,4,3,3,3,3,2,5,4,1,3,3,5,3,4,4,0,4,4,3,1,1,3,1,0,2,3,0,2,3,0,3,0,0,4,3,1,3,4,0,3,0,2,0,4,4,4,3,4,5,0,4,0,0,3,4),
(0,3,0,3,0,3,1,2,0,3,4,4,3,3,3,0,2,2,4,3,3,1,3,3,3,1,1,0,3,1,4,3,2,3,4,4,2,4,4,4,3,4,4,3,2,4,4,3,1,3,3,1,3,3,0,4,1,0,2,2,1,4,3,2,3,3,5,4,3,3,5,4,4,3,3,0,4,0,3,2,2,4,4),
(0,2,0,1,0,0,0,0,0,1,2,1,3,0,0,0,0,0,2,0,1,2,1,0,0,1,0,0,0,0,3,0,0,1,0,1,1,3,1,0,0,0,1,1,0,1,1,0,0,0,0,0,2,0,0,0,0,0,0,0,0,1,1,2,2,0,3,4,0,0,0,1,1,0,0,1,0,0,0,0,0,1,1),
(0,1,0,0,0,1,0,0,0,0,4,0,4,1,4,0,3,0,4,0,3,0,4,0,3,0,3,0,4,1,5,1,4,0,0,3,0,5,0,5,2,0,1,0,0,0,2,1,4,0,1,3,0,0,3,0,0,3,1,1,4,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0),
(1,4,0,5,0,3,0,2,0,3,5,4,4,3,4,3,5,3,4,3,3,0,4,3,3,3,3,3,3,2,4,4,3,1,3,4,4,5,4,4,3,4,4,1,3,5,4,3,3,3,1,2,2,3,3,1,3,1,3,3,3,5,3,3,4,5,0,3,0,3,0,3,4,3,4,4,3,0,3,0,2,4,3),
(0,1,0,4,0,0,0,0,0,1,4,0,4,1,4,2,4,0,3,0,1,0,1,0,0,0,0,0,2,0,3,1,1,1,0,3,0,0,0,1,2,1,0,0,1,1,1,1,0,1,0,0,0,1,0,0,3,0,0,0,0,3,2,0,2,2,0,1,0,0,0,2,3,2,3,3,0,0,0,0,2,1,0),
(0,5,1,5,0,3,0,3,0,5,4,4,5,1,5,3,3,0,4,3,4,3,5,3,4,3,3,2,4,3,4,3,3,0,3,3,1,4,4,3,4,4,4,3,4,5,5,3,2,3,1,1,3,3,1,3,1,1,3,3,2,4,5,3,3,5,0,4,0,3,0,4,4,3,5,3,3,0,3,4,0,4,3),
(0,5,0,5,0,3,0,2,0,4,4,3,5,2,4,3,3,3,4,4,4,3,5,3,5,3,3,1,4,0,4,3,3,0,3,3,0,4,4,4,4,5,4,3,3,5,5,3,2,3,1,2,3,2,0,1,0,0,3,2,2,4,4,3,1,5,0,4,0,3,0,4,3,1,3,2,1,0,3,3,0,3,3),
(0,4,0,5,0,5,0,4,0,4,5,5,5,3,4,3,3,2,5,4,4,3,5,3,5,3,4,0,4,3,4,4,3,2,4,4,3,4,5,4,4,5,5,0,3,5,5,4,1,3,3,2,3,3,1,3,1,0,4,3,1,4,4,3,4,5,0,4,0,2,0,4,3,4,4,3,3,0,4,0,0,5,5),
(0,4,0,4,0,5,0,1,1,3,3,4,4,3,4,1,3,0,5,1,3,0,3,1,3,1,1,0,3,0,3,3,4,0,4,3,0,4,4,4,3,4,4,0,3,5,4,1,0,3,0,0,2,3,0,3,1,0,3,1,0,3,2,1,3,5,0,3,0,1,0,3,2,3,3,4,4,0,2,2,0,4,4),
(2,4,0,5,0,4,0,3,0,4,5,5,4,3,5,3,5,3,5,3,5,2,5,3,4,3,3,4,3,4,5,3,2,1,5,4,3,2,3,4,5,3,4,1,2,5,4,3,0,3,3,0,3,2,0,2,3,0,4,1,0,3,4,3,3,5,0,3,0,1,0,4,5,5,5,4,3,0,4,2,0,3,5),
(0,5,0,4,0,4,0,2,0,5,4,3,4,3,4,3,3,3,4,3,4,2,5,3,5,3,4,1,4,3,4,4,4,0,3,5,0,4,4,4,4,5,3,1,3,4,5,3,3,3,3,3,3,3,0,2,2,0,3,3,2,4,3,3,3,5,3,4,1,3,3,5,3,2,0,0,0,0,4,3,1,3,3),
(0,1,0,3,0,3,0,1,0,1,3,3,3,2,3,3,3,0,3,0,0,0,3,1,3,0,0,0,2,2,2,3,0,0,3,2,0,1,2,4,1,3,3,0,0,3,3,3,0,1,0,0,2,1,0,0,3,0,3,1,0,3,0,0,1,3,0,2,0,1,0,3,3,1,3,3,0,0,1,1,0,3,3),
(0,2,0,3,0,2,1,4,0,2,2,3,1,1,3,1,1,0,2,0,3,1,2,3,1,3,0,0,1,0,4,3,2,3,3,3,1,4,2,3,3,3,3,1,0,3,1,4,0,1,1,0,1,2,0,1,1,0,1,1,0,3,1,3,2,2,0,1,0,0,0,2,3,3,3,1,0,0,0,0,0,2,3),
(0,5,0,4,0,5,0,2,0,4,5,5,3,3,4,3,3,1,5,4,4,2,4,4,4,3,4,2,4,3,5,5,4,3,3,4,3,3,5,5,4,5,5,1,3,4,5,3,1,4,3,1,3,3,0,3,3,1,4,3,1,4,5,3,3,5,0,4,0,3,0,5,3,3,1,4,3,0,4,0,1,5,3),
(0,5,0,5,0,4,0,2,0,4,4,3,4,3,3,3,3,3,5,4,4,4,4,4,4,5,3,3,5,2,4,4,4,3,4,4,3,3,4,4,5,5,3,3,4,3,4,3,3,4,3,3,3,3,1,2,2,1,4,3,3,5,4,4,3,4,0,4,0,3,0,4,4,4,4,4,1,0,4,2,0,2,4),
(0,4,0,4,0,3,0,1,0,3,5,2,3,0,3,0,2,1,4,2,3,3,4,1,4,3,3,2,4,1,3,3,3,0,3,3,0,0,3,3,3,5,3,3,3,3,3,2,0,2,0,0,2,0,0,2,0,0,1,0,0,3,1,2,2,3,0,3,0,2,0,4,4,3,3,4,1,0,3,0,0,2,4),
(0,0,0,4,0,0,0,0,0,0,1,0,1,0,2,0,0,0,0,0,1,0,2,0,1,0,0,0,0,0,3,1,3,0,3,2,0,0,0,1,0,3,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,4,0,2,0,0,0,0,0,0,2),
(0,2,1,3,0,2,0,2,0,3,3,3,3,1,3,1,3,3,3,3,3,3,4,2,2,1,2,1,4,0,4,3,1,3,3,3,2,4,3,5,4,3,3,3,3,3,3,3,0,1,3,0,2,0,0,1,0,0,1,0,0,4,2,0,2,3,0,3,3,0,3,3,4,2,3,1,4,0,1,2,0,2,3),
(0,3,0,3,0,1,0,3,0,2,3,3,3,0,3,1,2,0,3,3,2,3,3,2,3,2,3,1,3,0,4,3,2,0,3,3,1,4,3,3,2,3,4,3,1,3,3,1,1,0,1,1,0,1,0,1,0,1,0,0,0,4,1,1,0,3,0,3,1,0,2,3,3,3,3,3,1,0,0,2,0,3,3),
(0,0,0,0,0,0,0,0,0,0,3,0,2,0,3,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,3,0,3,0,3,1,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,2,0,2,3,0,0,0,0,0,0,0,0,3),
(0,2,0,3,1,3,0,3,0,2,3,3,3,1,3,1,3,1,3,1,3,3,3,1,3,0,2,3,1,1,4,3,3,2,3,3,1,2,2,4,1,3,3,0,1,4,2,3,0,1,3,0,3,0,0,1,3,0,2,0,0,3,3,2,1,3,0,3,0,2,0,3,4,4,4,3,1,0,3,0,0,3,3),
(0,2,0,1,0,2,0,0,0,1,3,2,2,1,3,0,1,1,3,0,3,2,3,1,2,0,2,0,1,1,3,3,3,0,3,3,1,1,2,3,2,3,3,1,2,3,2,0,0,1,0,0,0,0,0,0,3,0,1,0,0,2,1,2,1,3,0,3,0,0,0,3,4,4,4,3,2,0,2,0,0,2,4),
(0,0,0,1,0,1,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,2,2,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,3,1,0,0,0,0,0,0,0,3),
(0,3,0,3,0,2,0,3,0,3,3,3,2,3,2,2,2,0,3,1,3,3,3,2,3,3,0,0,3,0,3,2,2,0,2,3,1,4,3,4,3,3,2,3,1,5,4,4,0,3,1,2,1,3,0,3,1,1,2,0,2,3,1,3,1,3,0,3,0,1,0,3,3,4,4,2,1,0,2,1,0,2,4),
(0,1,0,3,0,1,0,2,0,1,4,2,5,1,4,0,2,0,2,1,3,1,4,0,2,1,0,0,2,1,4,1,1,0,3,3,0,5,1,3,2,3,3,1,0,3,2,3,0,1,0,0,0,0,0,0,1,0,0,0,0,4,0,1,0,3,0,2,0,1,0,3,3,3,4,3,3,0,0,0,0,2,3),
(0,0,0,1,0,0,0,0,0,0,2,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,1,0,0,1,0,0,0,0,0,3),
(0,1,0,3,0,4,0,3,0,2,4,3,1,0,3,2,2,1,3,1,2,2,3,1,1,1,2,1,3,0,1,2,0,1,3,2,1,3,0,5,5,1,0,0,1,3,2,1,0,3,0,0,1,0,0,0,0,0,3,4,0,1,1,1,3,2,0,2,0,1,0,2,3,3,1,2,3,0,1,0,1,0,4),
(0,0,0,1,0,3,0,3,0,2,2,1,0,0,4,0,3,0,3,1,3,0,3,0,3,0,1,0,3,0,3,1,3,0,3,3,0,0,1,2,1,1,1,0,1,2,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,2,2,1,2,0,0,2,0,0,0,0,2,3,3,3,3,0,0,0,0,1,4),
(0,0,0,3,0,3,0,0,0,0,3,1,1,0,3,0,1,0,2,0,1,0,0,0,0,0,0,0,1,0,3,0,2,0,2,3,0,0,2,2,3,1,2,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,2,0,0,0,0,2,3),
(2,4,0,5,0,5,0,4,0,3,4,3,3,3,4,3,3,3,4,3,4,4,5,4,5,5,5,2,3,0,5,5,4,1,5,4,3,1,5,4,3,4,4,3,3,4,3,3,0,3,2,0,2,3,0,3,0,0,3,3,0,5,3,2,3,3,0,3,0,3,0,3,4,5,4,5,3,0,4,3,0,3,4),
(0,3,0,3,0,3,0,3,0,3,3,4,3,2,3,2,3,0,4,3,3,3,3,3,3,3,3,0,3,2,4,3,3,1,3,4,3,4,4,4,3,4,4,3,2,4,4,1,0,2,0,0,1,1,0,2,0,0,3,1,0,5,3,2,1,3,0,3,0,1,2,4,3,2,4,3,3,0,3,2,0,4,4),
(0,3,0,3,0,1,0,0,0,1,4,3,3,2,3,1,3,1,4,2,3,2,4,2,3,4,3,0,2,2,3,3,3,0,3,3,3,0,3,4,1,3,3,0,3,4,3,3,0,1,1,0,1,0,0,0,4,0,3,0,0,3,1,2,1,3,0,4,0,1,0,4,3,3,4,3,3,0,2,0,0,3,3),
(0,3,0,4,0,1,0,3,0,3,4,3,3,0,3,3,3,1,3,1,3,3,4,3,3,3,0,0,3,1,5,3,3,1,3,3,2,5,4,3,3,4,5,3,2,5,3,4,0,1,0,0,0,0,0,2,0,0,1,1,0,4,2,2,1,3,0,3,0,2,0,4,4,3,5,3,2,0,1,1,0,3,4),
(0,5,0,4,0,5,0,2,0,4,4,3,3,2,3,3,3,1,4,3,4,1,5,3,4,3,4,0,4,2,4,3,4,1,5,4,0,4,4,4,4,5,4,1,3,5,4,2,1,4,1,1,3,2,0,3,1,0,3,2,1,4,3,3,3,4,0,4,0,3,0,4,4,4,3,3,3,0,4,2,0,3,4),
(1,4,0,4,0,3,0,1,0,3,3,3,1,1,3,3,2,2,3,3,1,0,3,2,2,1,2,0,3,1,2,1,2,0,3,2,0,2,2,3,3,4,3,0,3,3,1,2,0,1,1,3,1,2,0,0,3,0,1,1,0,3,2,2,3,3,0,3,0,0,0,2,3,3,4,3,3,0,1,0,0,1,4),
(0,4,0,4,0,4,0,0,0,3,4,4,3,1,4,2,3,2,3,3,3,1,4,3,4,0,3,0,4,2,3,3,2,2,5,4,2,1,3,4,3,4,3,1,3,3,4,2,0,2,1,0,3,3,0,0,2,0,3,1,0,4,4,3,4,3,0,4,0,1,0,2,4,4,4,4,4,0,3,2,0,3,3),
(0,0,0,1,0,4,0,0,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,3,2,0,0,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,2),
(0,2,0,3,0,4,0,4,0,1,3,3,3,0,4,0,2,1,2,1,1,1,2,0,3,1,1,0,1,0,3,1,0,0,3,3,2,0,1,1,0,0,0,0,0,1,0,2,0,2,2,0,3,1,0,0,1,0,1,1,0,1,2,0,3,0,0,0,0,1,0,0,3,3,4,3,1,0,1,0,3,0,2),
(0,0,0,3,0,5,0,0,0,0,1,0,2,0,3,1,0,1,3,0,0,0,2,0,0,0,1,0,0,0,1,1,0,0,4,0,0,0,2,3,0,1,4,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,1,0,0,0,0,0,0,0,2,0,0,3,0,0,0,0,0,3),
(0,2,0,5,0,5,0,1,0,2,4,3,3,2,5,1,3,2,3,3,3,0,4,1,2,0,3,0,4,0,2,2,1,1,5,3,0,0,1,4,2,3,2,0,3,3,3,2,0,2,4,1,1,2,0,1,1,0,3,1,0,1,3,1,2,3,0,2,0,0,0,1,3,5,4,4,4,0,3,0,0,1,3),
(0,4,0,5,0,4,0,4,0,4,5,4,3,3,4,3,3,3,4,3,4,4,5,3,4,5,4,2,4,2,3,4,3,1,4,4,1,3,5,4,4,5,5,4,4,5,5,5,2,3,3,1,4,3,1,3,3,0,3,3,1,4,3,4,4,4,0,3,0,4,0,3,3,4,4,5,0,0,4,3,0,4,5),
(0,4,0,4,0,3,0,3,0,3,4,4,4,3,3,2,4,3,4,3,4,3,5,3,4,3,2,1,4,2,4,4,3,1,3,4,2,4,5,5,3,4,5,4,1,5,4,3,0,3,2,2,3,2,1,3,1,0,3,3,3,5,3,3,3,5,4,4,2,3,3,4,3,3,3,2,1,0,3,2,1,4,3),
(0,4,0,5,0,4,0,3,0,3,5,5,3,2,4,3,4,0,5,4,4,1,4,4,4,3,3,3,4,3,5,5,2,3,3,4,1,2,5,5,3,5,5,2,3,5,5,4,0,3,2,0,3,3,1,1,5,1,4,1,0,4,3,2,3,5,0,4,0,3,0,5,4,3,4,3,0,0,4,1,0,4,4),
(1,3,0,4,0,2,0,2,0,2,5,5,3,3,3,3,3,0,4,2,3,4,4,4,3,4,0,0,3,4,5,4,3,3,3,3,2,5,5,4,5,5,5,4,3,5,5,5,1,3,1,0,1,0,0,3,2,0,4,2,0,5,2,3,2,4,1,3,0,3,0,4,5,4,5,4,3,0,4,2,0,5,4),
(0,3,0,4,0,5,0,3,0,3,4,4,3,2,3,2,3,3,3,3,3,2,4,3,3,2,2,0,3,3,3,3,3,1,3,3,3,0,4,4,3,4,4,1,1,4,4,2,0,3,1,0,1,1,0,4,1,0,2,3,1,3,3,1,3,4,0,3,0,1,0,3,1,3,0,0,1,0,2,0,0,4,4),
(0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0),
(0,3,0,3,0,2,0,3,0,1,5,4,3,3,3,1,4,2,1,2,3,4,4,2,4,4,5,0,3,1,4,3,4,0,4,3,3,3,2,3,2,5,3,4,3,2,2,3,0,0,3,0,2,1,0,1,2,0,0,0,0,2,1,1,3,1,0,2,0,4,0,3,4,4,4,5,2,0,2,0,0,1,3),
(0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,1,1,0,0,1,1,0,0,0,4,2,1,1,0,1,0,3,2,0,0,3,1,1,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,3,0,1,0,0,0,2,0,0,0,1,4,0,4,2,1,0,0,0,0,0,1),
(0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,1,0,0,0,0,0,0,1,0,1,0,0,0,0,3,1,0,0,0,2,0,2,1,0,0,1,2,1,0,1,1,0,0,3,0,0,0,0,0,0,0,0,0,0,0,1,3,1,0,0,0,0,0,1,0,0,2,1,0,0,0,0,0,0,0,0,2),
(0,4,0,4,0,4,0,3,0,4,4,3,4,2,4,3,2,0,4,4,4,3,5,3,5,3,3,2,4,2,4,3,4,3,1,4,0,2,3,4,4,4,3,3,3,4,4,4,3,4,1,3,4,3,2,1,2,1,3,3,3,4,4,3,3,5,0,4,0,3,0,4,3,3,3,2,1,0,3,0,0,3,3),
(0,4,0,3,0,3,0,3,0,3,5,5,3,3,3,3,4,3,4,3,3,3,4,4,4,3,3,3,3,4,3,5,3,3,1,3,2,4,5,5,5,5,4,3,4,5,5,3,2,2,3,3,3,3,2,3,3,1,2,3,2,4,3,3,3,4,0,4,0,2,0,4,3,2,2,1,2,0,3,0,0,4,1),
)

class JapaneseContextAnalysis(object):
    NUM_OF_CATEGORY = 6
    DONT_KNOW = -1
    ENOUGH_REL_THRESHOLD = 100
    MAX_REL_THRESHOLD = 1000
    MINIMUM_DATA_THRESHOLD = 4

    def __init__(self):
        self._total_rel = None
        self._rel_sample = None
        self._need_to_skip_char_num = None
        self._last_char_order = None
        self._done = None
        self.reset()

    def reset(self):
        self._total_rel = 0  # total sequence received
        # category counters, each integer counts sequence in its category
        self._rel_sample = [0] * self.NUM_OF_CATEGORY
        # if last byte in current buffer is not the last byte of a character,
        # we need to know how many bytes to skip in next buffer
        self._need_to_skip_char_num = 0
        self._last_char_order = -1  # The order of previous char
        # If this flag is set to True, detection is done and conclusion has
        # been made
        self._done = False

    def feed(self, byte_str, num_bytes):
        if self._done:
            return

        # The buffer we got is byte oriented, and a character may span in more than one
        # buffers. In case the last one or two byte in last buffer is not
        # complete, we record how many byte needed to complete that character
        # and skip these bytes here.  We can choose to record those bytes as
        # well and analyse the character once it is complete, but since a
        # character will not make much difference, by simply skipping
        # this character will simply our logic and improve performance.
        i = self._need_to_skip_char_num
        while i < num_bytes:
            order, char_len = self.get_order(byte_str[i:i + 2])
            i += char_len
            if i > num_bytes:
                self._need_to_skip_char_num = i - num_bytes
                self._last_char_order = -1
            else:
                if (order != -1) and (self._last_char_order != -1):
                    self._total_rel += 1
                    if self._total_rel > self.MAX_REL_THRESHOLD:
                        self._done = True
                        break
                    self._rel_sample[jp2CharContext[self._last_char_order][order]] += 1
                self._last_char_order = order

    def got_enough_data(self):
        return self._total_rel > self.ENOUGH_REL_THRESHOLD

    def get_confidence(self):
        # This is just one way to calculate confidence. It works well for me.
        if self._total_rel > self.MINIMUM_DATA_THRESHOLD:
            return (self._total_rel - self._rel_sample[0]) / self._total_rel
        else:
            return self.DONT_KNOW

    def get_order(self, byte_str):
        return -1, 1

class SJISContextAnalysis(JapaneseContextAnalysis):
    def __init__(self):
        super(SJISContextAnalysis, self).__init__()
        self._charset_name = "SHIFT_JIS"

    @property
    def charset_name(self):
        return self._charset_name

    def get_order(self, byte_str):
        if not byte_str:
            return -1, 1
        # find out current char's byte length
        first_char = byte_str[0]
        if (0x81 <= first_char <= 0x9F) or (0xE0 <= first_char <= 0xFC):
            char_len = 2
            if (first_char == 0x87) or (0xFA <= first_char <= 0xFC):
                self._charset_name = "CP932"
        else:
            char_len = 1

        # return its order if it is hiragana
        if len(byte_str) > 1:
            second_char = byte_str[1]
            if (first_char == 202) and (0x9F <= second_char <= 0xF1):
                return second_char - 0x9F, char_len

        return -1, char_len

class EUCJPContextAnalysis(JapaneseContextAnalysis):
    def get_order(self, byte_str):
        if not byte_str:
            return -1, 1
        # find out current char's byte length
        first_char = byte_str[0]
        if (first_char == 0x8E) or (0xA1 <= first_char <= 0xFE):
            char_len = 2
        elif first_char == 0x8F:
            char_len = 3
        else:
            char_len = 1

        # return its order if it is hiragana
        if len(byte_str) > 1:
            second_char = byte_str[1]
            if (first_char == 0xA4) and (0xA1 <= second_char <= 0xF3):
                return second_char - 0xA1, char_len

        return -1, char_len


site-packages/pip/_vendor/chardet/mbcharsetprober.py000064400000006525151446177000016673 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 2001
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#   Proofpoint, Inc.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetprober import CharSetProber
from .enums import ProbingState, MachineState


class MultiByteCharSetProber(CharSetProber):
    """
    MultiByteCharSetProber
    """

    def __init__(self, lang_filter=None):
        super(MultiByteCharSetProber, self).__init__(lang_filter=lang_filter)
        self.distribution_analyzer = None
        self.coding_sm = None
        self._last_char = [0, 0]

    def reset(self):
        super(MultiByteCharSetProber, self).reset()
        if self.coding_sm:
            self.coding_sm.reset()
        if self.distribution_analyzer:
            self.distribution_analyzer.reset()
        self._last_char = [0, 0]

    @property
    def charset_name(self):
        raise NotImplementedError

    @property
    def language(self):
        raise NotImplementedError

    def feed(self, byte_str):
        for i in range(len(byte_str)):
            coding_state = self.coding_sm.next_state(byte_str[i])
            if coding_state == MachineState.ERROR:
                self.logger.debug('%s %s prober hit error at byte %s',
                                  self.charset_name, self.language, i)
                self._state = ProbingState.NOT_ME
                break
            elif coding_state == MachineState.ITS_ME:
                self._state = ProbingState.FOUND_IT
                break
            elif coding_state == MachineState.START:
                char_len = self.coding_sm.get_current_charlen()
                if i == 0:
                    self._last_char[1] = byte_str[0]
                    self.distribution_analyzer.feed(self._last_char, char_len)
                else:
                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
                                                    char_len)

        self._last_char[0] = byte_str[-1]

        if self.state == ProbingState.DETECTING:
            if (self.distribution_analyzer.got_enough_data() and
                    (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
                self._state = ProbingState.FOUND_IT

        return self.state

    def get_confidence(self):
        return self.distribution_analyzer.get_confidence()
site-packages/pip/_vendor/chardet/enums.py000064400000003175151446177000014636 0ustar00"""
All of the Enums that are used throughout the chardet package.

:author: Dan Blanchard (dan.blanchard@gmail.com)
"""


class InputState(object):
    """
    This enum represents the different states a universal detector can be in.
    """
    PURE_ASCII = 0
    ESC_ASCII = 1
    HIGH_BYTE = 2


class LanguageFilter(object):
    """
    This enum represents the different language filters we can apply to a
    ``UniversalDetector``.
    """
    CHINESE_SIMPLIFIED = 0x01
    CHINESE_TRADITIONAL = 0x02
    JAPANESE = 0x04
    KOREAN = 0x08
    NON_CJK = 0x10
    ALL = 0x1F
    CHINESE = CHINESE_SIMPLIFIED | CHINESE_TRADITIONAL
    CJK = CHINESE | JAPANESE | KOREAN


class ProbingState(object):
    """
    This enum represents the different states a prober can be in.
    """
    DETECTING = 0
    FOUND_IT = 1
    NOT_ME = 2


class MachineState(object):
    """
    This enum represents the different states a state machine can be in.
    """
    START = 0
    ERROR = 1
    ITS_ME = 2


class SequenceLikelihood(object):
    """
    This enum represents the likelihood of a character following the previous one.
    """
    NEGATIVE = 0
    UNLIKELY = 1
    LIKELY = 2
    POSITIVE = 3

    @classmethod
    def get_num_categories(cls):
        """:returns: The number of likelihood categories in the enum."""
        return 4


class CharacterCategory(object):
    """
    This enum represents the different categories language models for
    ``SingleByteCharsetProber`` put characters into.

    Anything less than CONTROL is considered a letter.
    """
    UNDEFINED = 255
    LINE_BREAK = 254
    SYMBOL = 253
    DIGIT = 252
    CONTROL = 251
site-packages/pip/_vendor/chardet/jisfreq.py000064400000062261151446177000015153 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# Sampling from about 20M text materials include literature and computer technology
#
# Japanese frequency table, applied to both S-JIS and EUC-JP
# They are sorted in order.

# 128  --> 0.77094
# 256  --> 0.85710
# 512  --> 0.92635
# 1024 --> 0.97130
# 2048 --> 0.99431
#
# Ideal Distribution Ratio = 0.92635 / (1-0.92635) = 12.58
# Random Distribution Ration = 512 / (2965+62+83+86-512) = 0.191
#
# Typical Distribution Ratio, 25% of IDR

JIS_TYPICAL_DISTRIBUTION_RATIO = 3.0

# Char to FreqOrder table ,
JIS_TABLE_SIZE = 4368

JIS_CHAR_TO_FREQ_ORDER = (
  40,   1,   6, 182, 152, 180, 295,2127, 285, 381,3295,4304,3068,4606,3165,3510, #   16
3511,1822,2785,4607,1193,2226,5070,4608, 171,2996,1247,  18, 179,5071, 856,1661, #   32
1262,5072, 619, 127,3431,3512,3230,1899,1700, 232, 228,1294,1298, 284, 283,2041, #   48
2042,1061,1062,  48,  49,  44,  45, 433, 434,1040,1041, 996, 787,2997,1255,4305, #   64
2108,4609,1684,1648,5073,5074,5075,5076,5077,5078,3687,5079,4610,5080,3927,3928, #   80
5081,3296,3432, 290,2285,1471,2187,5082,2580,2825,1303,2140,1739,1445,2691,3375, #   96
1691,3297,4306,4307,4611, 452,3376,1182,2713,3688,3069,4308,5083,5084,5085,5086, #  112
5087,5088,5089,5090,5091,5092,5093,5094,5095,5096,5097,5098,5099,5100,5101,5102, #  128
5103,5104,5105,5106,5107,5108,5109,5110,5111,5112,4097,5113,5114,5115,5116,5117, #  144
5118,5119,5120,5121,5122,5123,5124,5125,5126,5127,5128,5129,5130,5131,5132,5133, #  160
5134,5135,5136,5137,5138,5139,5140,5141,5142,5143,5144,5145,5146,5147,5148,5149, #  176
5150,5151,5152,4612,5153,5154,5155,5156,5157,5158,5159,5160,5161,5162,5163,5164, #  192
5165,5166,5167,5168,5169,5170,5171,5172,5173,5174,5175,1472, 598, 618, 820,1205, #  208
1309,1412,1858,1307,1692,5176,5177,5178,5179,5180,5181,5182,1142,1452,1234,1172, #  224
1875,2043,2149,1793,1382,2973, 925,2404,1067,1241, 960,1377,2935,1491, 919,1217, #  240
1865,2030,1406,1499,2749,4098,5183,5184,5185,5186,5187,5188,2561,4099,3117,1804, #  256
2049,3689,4309,3513,1663,5189,3166,3118,3298,1587,1561,3433,5190,3119,1625,2998, #  272
3299,4613,1766,3690,2786,4614,5191,5192,5193,5194,2161,  26,3377,   2,3929,  20, #  288
3691,  47,4100,  50,  17,  16,  35, 268,  27, 243,  42, 155,  24, 154,  29, 184, #  304
   4,  91,  14,  92,  53, 396,  33, 289,   9,  37,  64, 620,  21,  39, 321,   5, #  320
  12,  11,  52,  13,   3, 208, 138,   0,   7,  60, 526, 141, 151,1069, 181, 275, #  336
1591,  83, 132,1475, 126, 331, 829,  15,  69, 160,  59,  22, 157,  55,1079, 312, #  352
 109,  38,  23,  25,  10,  19,  79,5195,  61, 382,1124,   8,  30,5196,5197,5198, #  368
5199,5200,5201,5202,5203,5204,5205,5206,  89,  62,  74,  34,2416, 112, 139, 196, #  384
 271, 149,  84, 607, 131, 765,  46,  88, 153, 683,  76, 874, 101, 258,  57,  80, #  400
  32, 364, 121,1508, 169,1547,  68, 235, 145,2999,  41, 360,3027,  70,  63,  31, #  416
  43, 259, 262,1383,  99, 533, 194,  66,  93, 846, 217, 192,  56, 106,  58, 565, #  432
 280, 272, 311, 256, 146,  82, 308,  71, 100, 128, 214, 655, 110, 261, 104,1140, #  448
  54,  51,  36,  87,  67,3070, 185,2618,2936,2020,  28,1066,2390,2059,5207,5208, #  464
5209,5210,5211,5212,5213,5214,5215,5216,4615,5217,5218,5219,5220,5221,5222,5223, #  480
5224,5225,5226,5227,5228,5229,5230,5231,5232,5233,5234,5235,5236,3514,5237,5238, #  496
5239,5240,5241,5242,5243,5244,2297,2031,4616,4310,3692,5245,3071,5246,3598,5247, #  512
4617,3231,3515,5248,4101,4311,4618,3808,4312,4102,5249,4103,4104,3599,5250,5251, #  528
5252,5253,5254,5255,5256,5257,5258,5259,5260,5261,5262,5263,5264,5265,5266,5267, #  544
5268,5269,5270,5271,5272,5273,5274,5275,5276,5277,5278,5279,5280,5281,5282,5283, #  560
5284,5285,5286,5287,5288,5289,5290,5291,5292,5293,5294,5295,5296,5297,5298,5299, #  576
5300,5301,5302,5303,5304,5305,5306,5307,5308,5309,5310,5311,5312,5313,5314,5315, #  592
5316,5317,5318,5319,5320,5321,5322,5323,5324,5325,5326,5327,5328,5329,5330,5331, #  608
5332,5333,5334,5335,5336,5337,5338,5339,5340,5341,5342,5343,5344,5345,5346,5347, #  624
5348,5349,5350,5351,5352,5353,5354,5355,5356,5357,5358,5359,5360,5361,5362,5363, #  640
5364,5365,5366,5367,5368,5369,5370,5371,5372,5373,5374,5375,5376,5377,5378,5379, #  656
5380,5381, 363, 642,2787,2878,2788,2789,2316,3232,2317,3434,2011, 165,1942,3930, #  672
3931,3932,3933,5382,4619,5383,4620,5384,5385,5386,5387,5388,5389,5390,5391,5392, #  688
5393,5394,5395,5396,5397,5398,5399,5400,5401,5402,5403,5404,5405,5406,5407,5408, #  704
5409,5410,5411,5412,5413,5414,5415,5416,5417,5418,5419,5420,5421,5422,5423,5424, #  720
5425,5426,5427,5428,5429,5430,5431,5432,5433,5434,5435,5436,5437,5438,5439,5440, #  736
5441,5442,5443,5444,5445,5446,5447,5448,5449,5450,5451,5452,5453,5454,5455,5456, #  752
5457,5458,5459,5460,5461,5462,5463,5464,5465,5466,5467,5468,5469,5470,5471,5472, #  768
5473,5474,5475,5476,5477,5478,5479,5480,5481,5482,5483,5484,5485,5486,5487,5488, #  784
5489,5490,5491,5492,5493,5494,5495,5496,5497,5498,5499,5500,5501,5502,5503,5504, #  800
5505,5506,5507,5508,5509,5510,5511,5512,5513,5514,5515,5516,5517,5518,5519,5520, #  816
5521,5522,5523,5524,5525,5526,5527,5528,5529,5530,5531,5532,5533,5534,5535,5536, #  832
5537,5538,5539,5540,5541,5542,5543,5544,5545,5546,5547,5548,5549,5550,5551,5552, #  848
5553,5554,5555,5556,5557,5558,5559,5560,5561,5562,5563,5564,5565,5566,5567,5568, #  864
5569,5570,5571,5572,5573,5574,5575,5576,5577,5578,5579,5580,5581,5582,5583,5584, #  880
5585,5586,5587,5588,5589,5590,5591,5592,5593,5594,5595,5596,5597,5598,5599,5600, #  896
5601,5602,5603,5604,5605,5606,5607,5608,5609,5610,5611,5612,5613,5614,5615,5616, #  912
5617,5618,5619,5620,5621,5622,5623,5624,5625,5626,5627,5628,5629,5630,5631,5632, #  928
5633,5634,5635,5636,5637,5638,5639,5640,5641,5642,5643,5644,5645,5646,5647,5648, #  944
5649,5650,5651,5652,5653,5654,5655,5656,5657,5658,5659,5660,5661,5662,5663,5664, #  960
5665,5666,5667,5668,5669,5670,5671,5672,5673,5674,5675,5676,5677,5678,5679,5680, #  976
5681,5682,5683,5684,5685,5686,5687,5688,5689,5690,5691,5692,5693,5694,5695,5696, #  992
5697,5698,5699,5700,5701,5702,5703,5704,5705,5706,5707,5708,5709,5710,5711,5712, # 1008
5713,5714,5715,5716,5717,5718,5719,5720,5721,5722,5723,5724,5725,5726,5727,5728, # 1024
5729,5730,5731,5732,5733,5734,5735,5736,5737,5738,5739,5740,5741,5742,5743,5744, # 1040
5745,5746,5747,5748,5749,5750,5751,5752,5753,5754,5755,5756,5757,5758,5759,5760, # 1056
5761,5762,5763,5764,5765,5766,5767,5768,5769,5770,5771,5772,5773,5774,5775,5776, # 1072
5777,5778,5779,5780,5781,5782,5783,5784,5785,5786,5787,5788,5789,5790,5791,5792, # 1088
5793,5794,5795,5796,5797,5798,5799,5800,5801,5802,5803,5804,5805,5806,5807,5808, # 1104
5809,5810,5811,5812,5813,5814,5815,5816,5817,5818,5819,5820,5821,5822,5823,5824, # 1120
5825,5826,5827,5828,5829,5830,5831,5832,5833,5834,5835,5836,5837,5838,5839,5840, # 1136
5841,5842,5843,5844,5845,5846,5847,5848,5849,5850,5851,5852,5853,5854,5855,5856, # 1152
5857,5858,5859,5860,5861,5862,5863,5864,5865,5866,5867,5868,5869,5870,5871,5872, # 1168
5873,5874,5875,5876,5877,5878,5879,5880,5881,5882,5883,5884,5885,5886,5887,5888, # 1184
5889,5890,5891,5892,5893,5894,5895,5896,5897,5898,5899,5900,5901,5902,5903,5904, # 1200
5905,5906,5907,5908,5909,5910,5911,5912,5913,5914,5915,5916,5917,5918,5919,5920, # 1216
5921,5922,5923,5924,5925,5926,5927,5928,5929,5930,5931,5932,5933,5934,5935,5936, # 1232
5937,5938,5939,5940,5941,5942,5943,5944,5945,5946,5947,5948,5949,5950,5951,5952, # 1248
5953,5954,5955,5956,5957,5958,5959,5960,5961,5962,5963,5964,5965,5966,5967,5968, # 1264
5969,5970,5971,5972,5973,5974,5975,5976,5977,5978,5979,5980,5981,5982,5983,5984, # 1280
5985,5986,5987,5988,5989,5990,5991,5992,5993,5994,5995,5996,5997,5998,5999,6000, # 1296
6001,6002,6003,6004,6005,6006,6007,6008,6009,6010,6011,6012,6013,6014,6015,6016, # 1312
6017,6018,6019,6020,6021,6022,6023,6024,6025,6026,6027,6028,6029,6030,6031,6032, # 1328
6033,6034,6035,6036,6037,6038,6039,6040,6041,6042,6043,6044,6045,6046,6047,6048, # 1344
6049,6050,6051,6052,6053,6054,6055,6056,6057,6058,6059,6060,6061,6062,6063,6064, # 1360
6065,6066,6067,6068,6069,6070,6071,6072,6073,6074,6075,6076,6077,6078,6079,6080, # 1376
6081,6082,6083,6084,6085,6086,6087,6088,6089,6090,6091,6092,6093,6094,6095,6096, # 1392
6097,6098,6099,6100,6101,6102,6103,6104,6105,6106,6107,6108,6109,6110,6111,6112, # 1408
6113,6114,2044,2060,4621, 997,1235, 473,1186,4622, 920,3378,6115,6116, 379,1108, # 1424
4313,2657,2735,3934,6117,3809, 636,3233, 573,1026,3693,3435,2974,3300,2298,4105, # 1440
 854,2937,2463, 393,2581,2417, 539, 752,1280,2750,2480, 140,1161, 440, 708,1569, # 1456
 665,2497,1746,1291,1523,3000, 164,1603, 847,1331, 537,1997, 486, 508,1693,2418, # 1472
1970,2227, 878,1220, 299,1030, 969, 652,2751, 624,1137,3301,2619,  65,3302,2045, # 1488
1761,1859,3120,1930,3694,3516, 663,1767, 852, 835,3695, 269, 767,2826,2339,1305, # 1504
 896,1150, 770,1616,6118, 506,1502,2075,1012,2519, 775,2520,2975,2340,2938,4314, # 1520
3028,2086,1224,1943,2286,6119,3072,4315,2240,1273,1987,3935,1557, 175, 597, 985, # 1536
3517,2419,2521,1416,3029, 585, 938,1931,1007,1052,1932,1685,6120,3379,4316,4623, # 1552
 804, 599,3121,1333,2128,2539,1159,1554,2032,3810, 687,2033,2904, 952, 675,1467, # 1568
3436,6121,2241,1096,1786,2440,1543,1924, 980,1813,2228, 781,2692,1879, 728,1918, # 1584
3696,4624, 548,1950,4625,1809,1088,1356,3303,2522,1944, 502, 972, 373, 513,2827, # 1600
 586,2377,2391,1003,1976,1631,6122,2464,1084, 648,1776,4626,2141, 324, 962,2012, # 1616
2177,2076,1384, 742,2178,1448,1173,1810, 222, 102, 301, 445, 125,2420, 662,2498, # 1632
 277, 200,1476,1165,1068, 224,2562,1378,1446, 450,1880, 659, 791, 582,4627,2939, # 1648
3936,1516,1274, 555,2099,3697,1020,1389,1526,3380,1762,1723,1787,2229, 412,2114, # 1664
1900,2392,3518, 512,2597, 427,1925,2341,3122,1653,1686,2465,2499, 697, 330, 273, # 1680
 380,2162, 951, 832, 780, 991,1301,3073, 965,2270,3519, 668,2523,2636,1286, 535, # 1696
1407, 518, 671, 957,2658,2378, 267, 611,2197,3030,6123, 248,2299, 967,1799,2356, # 1712
 850,1418,3437,1876,1256,1480,2828,1718,6124,6125,1755,1664,2405,6126,4628,2879, # 1728
2829, 499,2179, 676,4629, 557,2329,2214,2090, 325,3234, 464, 811,3001, 992,2342, # 1744
2481,1232,1469, 303,2242, 466,1070,2163, 603,1777,2091,4630,2752,4631,2714, 322, # 1760
2659,1964,1768, 481,2188,1463,2330,2857,3600,2092,3031,2421,4632,2318,2070,1849, # 1776
2598,4633,1302,2254,1668,1701,2422,3811,2905,3032,3123,2046,4106,1763,1694,4634, # 1792
1604, 943,1724,1454, 917, 868,2215,1169,2940, 552,1145,1800,1228,1823,1955, 316, # 1808
1080,2510, 361,1807,2830,4107,2660,3381,1346,1423,1134,4108,6127, 541,1263,1229, # 1824
1148,2540, 545, 465,1833,2880,3438,1901,3074,2482, 816,3937, 713,1788,2500, 122, # 1840
1575, 195,1451,2501,1111,6128, 859, 374,1225,2243,2483,4317, 390,1033,3439,3075, # 1856
2524,1687, 266, 793,1440,2599, 946, 779, 802, 507, 897,1081, 528,2189,1292, 711, # 1872
1866,1725,1167,1640, 753, 398,2661,1053, 246, 348,4318, 137,1024,3440,1600,2077, # 1888
2129, 825,4319, 698, 238, 521, 187,2300,1157,2423,1641,1605,1464,1610,1097,2541, # 1904
1260,1436, 759,2255,1814,2150, 705,3235, 409,2563,3304, 561,3033,2005,2564, 726, # 1920
1956,2343,3698,4109, 949,3812,3813,3520,1669, 653,1379,2525, 881,2198, 632,2256, # 1936
1027, 778,1074, 733,1957, 514,1481,2466, 554,2180, 702,3938,1606,1017,1398,6129, # 1952
1380,3521, 921, 993,1313, 594, 449,1489,1617,1166, 768,1426,1360, 495,1794,3601, # 1968
1177,3602,1170,4320,2344, 476, 425,3167,4635,3168,1424, 401,2662,1171,3382,1998, # 1984
1089,4110, 477,3169, 474,6130,1909, 596,2831,1842, 494, 693,1051,1028,1207,3076, # 2000
 606,2115, 727,2790,1473,1115, 743,3522, 630, 805,1532,4321,2021, 366,1057, 838, # 2016
 684,1114,2142,4322,2050,1492,1892,1808,2271,3814,2424,1971,1447,1373,3305,1090, # 2032
1536,3939,3523,3306,1455,2199, 336, 369,2331,1035, 584,2393, 902, 718,2600,6131, # 2048
2753, 463,2151,1149,1611,2467, 715,1308,3124,1268, 343,1413,3236,1517,1347,2663, # 2064
2093,3940,2022,1131,1553,2100,2941,1427,3441,2942,1323,2484,6132,1980, 872,2368, # 2080
2441,2943, 320,2369,2116,1082, 679,1933,3941,2791,3815, 625,1143,2023, 422,2200, # 2096
3816,6133, 730,1695, 356,2257,1626,2301,2858,2637,1627,1778, 937, 883,2906,2693, # 2112
3002,1769,1086, 400,1063,1325,3307,2792,4111,3077, 456,2345,1046, 747,6134,1524, # 2128
 884,1094,3383,1474,2164,1059, 974,1688,2181,2258,1047, 345,1665,1187, 358, 875, # 2144
3170, 305, 660,3524,2190,1334,1135,3171,1540,1649,2542,1527, 927, 968,2793, 885, # 2160
1972,1850, 482, 500,2638,1218,1109,1085,2543,1654,2034, 876,  78,2287,1482,1277, # 2176
 861,1675,1083,1779, 724,2754, 454, 397,1132,1612,2332, 893, 672,1237, 257,2259, # 2192
2370, 135,3384, 337,2244, 547, 352, 340, 709,2485,1400, 788,1138,2511, 540, 772, # 2208
1682,2260,2272,2544,2013,1843,1902,4636,1999,1562,2288,4637,2201,1403,1533, 407, # 2224
 576,3308,1254,2071, 978,3385, 170, 136,1201,3125,2664,3172,2394, 213, 912, 873, # 2240
3603,1713,2202, 699,3604,3699, 813,3442, 493, 531,1054, 468,2907,1483, 304, 281, # 2256
4112,1726,1252,2094, 339,2319,2130,2639, 756,1563,2944, 748, 571,2976,1588,2425, # 2272
2715,1851,1460,2426,1528,1392,1973,3237, 288,3309, 685,3386, 296, 892,2716,2216, # 2288
1570,2245, 722,1747,2217, 905,3238,1103,6135,1893,1441,1965, 251,1805,2371,3700, # 2304
2601,1919,1078,  75,2182,1509,1592,1270,2640,4638,2152,6136,3310,3817, 524, 706, # 2320
1075, 292,3818,1756,2602, 317,  98,3173,3605,3525,1844,2218,3819,2502, 814, 567, # 2336
 385,2908,1534,6137, 534,1642,3239, 797,6138,1670,1529, 953,4323, 188,1071, 538, # 2352
 178, 729,3240,2109,1226,1374,2000,2357,2977, 731,2468,1116,2014,2051,6139,1261, # 2368
1593, 803,2859,2736,3443, 556, 682, 823,1541,6140,1369,2289,1706,2794, 845, 462, # 2384
2603,2665,1361, 387, 162,2358,1740, 739,1770,1720,1304,1401,3241,1049, 627,1571, # 2400
2427,3526,1877,3942,1852,1500, 431,1910,1503, 677, 297,2795, 286,1433,1038,1198, # 2416
2290,1133,1596,4113,4639,2469,1510,1484,3943,6141,2442, 108, 712,4640,2372, 866, # 2432
3701,2755,3242,1348, 834,1945,1408,3527,2395,3243,1811, 824, 994,1179,2110,1548, # 2448
1453, 790,3003, 690,4324,4325,2832,2909,3820,1860,3821, 225,1748, 310, 346,1780, # 2464
2470, 821,1993,2717,2796, 828, 877,3528,2860,2471,1702,2165,2910,2486,1789, 453, # 2480
 359,2291,1676,  73,1164,1461,1127,3311, 421, 604, 314,1037, 589, 116,2487, 737, # 2496
 837,1180, 111, 244, 735,6142,2261,1861,1362, 986, 523, 418, 581,2666,3822, 103, # 2512
 855, 503,1414,1867,2488,1091, 657,1597, 979, 605,1316,4641,1021,2443,2078,2001, # 2528
1209,  96, 587,2166,1032, 260,1072,2153, 173,  94, 226,3244, 819,2006,4642,4114, # 2544
2203, 231,1744, 782,  97,2667, 786,3387, 887, 391, 442,2219,4326,1425,6143,2694, # 2560
 633,1544,1202, 483,2015, 592,2052,1958,2472,1655, 419, 129,4327,3444,3312,1714, # 2576
1257,3078,4328,1518,1098, 865,1310,1019,1885,1512,1734, 469,2444, 148, 773, 436, # 2592
1815,1868,1128,1055,4329,1245,2756,3445,2154,1934,1039,4643, 579,1238, 932,2320, # 2608
 353, 205, 801, 115,2428, 944,2321,1881, 399,2565,1211, 678, 766,3944, 335,2101, # 2624
1459,1781,1402,3945,2737,2131,1010, 844, 981,1326,1013, 550,1816,1545,2620,1335, # 2640
1008, 371,2881, 936,1419,1613,3529,1456,1395,2273,1834,2604,1317,2738,2503, 416, # 2656
1643,4330, 806,1126, 229, 591,3946,1314,1981,1576,1837,1666, 347,1790, 977,3313, # 2672
 764,2861,1853, 688,2429,1920,1462,  77, 595, 415,2002,3034, 798,1192,4115,6144, # 2688
2978,4331,3035,2695,2582,2072,2566, 430,2430,1727, 842,1396,3947,3702, 613, 377, # 2704
 278, 236,1417,3388,3314,3174, 757,1869, 107,3530,6145,1194, 623,2262, 207,1253, # 2720
2167,3446,3948, 492,1117,1935, 536,1838,2757,1246,4332, 696,2095,2406,1393,1572, # 2736
3175,1782, 583, 190, 253,1390,2230, 830,3126,3389, 934,3245,1703,1749,2979,1870, # 2752
2545,1656,2204, 869,2346,4116,3176,1817, 496,1764,4644, 942,1504, 404,1903,1122, # 2768
1580,3606,2945,1022, 515, 372,1735, 955,2431,3036,6146,2797,1110,2302,2798, 617, # 2784
6147, 441, 762,1771,3447,3607,3608,1904, 840,3037,  86, 939,1385, 572,1370,2445, # 2800
1336, 114,3703, 898, 294, 203,3315, 703,1583,2274, 429, 961,4333,1854,1951,3390, # 2816
2373,3704,4334,1318,1381, 966,1911,2322,1006,1155, 309, 989, 458,2718,1795,1372, # 2832
1203, 252,1689,1363,3177, 517,1936, 168,1490, 562, 193,3823,1042,4117,1835, 551, # 2848
 470,4645, 395, 489,3448,1871,1465,2583,2641, 417,1493, 279,1295, 511,1236,1119, # 2864
  72,1231,1982,1812,3004, 871,1564, 984,3449,1667,2696,2096,4646,2347,2833,1673, # 2880
3609, 695,3246,2668, 807,1183,4647, 890, 388,2333,1801,1457,2911,1765,1477,1031, # 2896
3316,3317,1278,3391,2799,2292,2526, 163,3450,4335,2669,1404,1802,6148,2323,2407, # 2912
1584,1728,1494,1824,1269, 298, 909,3318,1034,1632, 375, 776,1683,2061, 291, 210, # 2928
1123, 809,1249,1002,2642,3038, 206,1011,2132, 144, 975, 882,1565, 342, 667, 754, # 2944
1442,2143,1299,2303,2062, 447, 626,2205,1221,2739,2912,1144,1214,2206,2584, 760, # 2960
1715, 614, 950,1281,2670,2621, 810, 577,1287,2546,4648, 242,2168, 250,2643, 691, # 2976
 123,2644, 647, 313,1029, 689,1357,2946,1650, 216, 771,1339,1306, 808,2063, 549, # 2992
 913,1371,2913,2914,6149,1466,1092,1174,1196,1311,2605,2396,1783,1796,3079, 406, # 3008
2671,2117,3949,4649, 487,1825,2220,6150,2915, 448,2348,1073,6151,2397,1707, 130, # 3024
 900,1598, 329, 176,1959,2527,1620,6152,2275,4336,3319,1983,2191,3705,3610,2155, # 3040
3706,1912,1513,1614,6153,1988, 646, 392,2304,1589,3320,3039,1826,1239,1352,1340, # 3056
2916, 505,2567,1709,1437,2408,2547, 906,6154,2672, 384,1458,1594,1100,1329, 710, # 3072
 423,3531,2064,2231,2622,1989,2673,1087,1882, 333, 841,3005,1296,2882,2379, 580, # 3088
1937,1827,1293,2585, 601, 574, 249,1772,4118,2079,1120, 645, 901,1176,1690, 795, # 3104
2207, 478,1434, 516,1190,1530, 761,2080, 930,1264, 355, 435,1552, 644,1791, 987, # 3120
 220,1364,1163,1121,1538, 306,2169,1327,1222, 546,2645, 218, 241, 610,1704,3321, # 3136
1984,1839,1966,2528, 451,6155,2586,3707,2568, 907,3178, 254,2947, 186,1845,4650, # 3152
 745, 432,1757, 428,1633, 888,2246,2221,2489,3611,2118,1258,1265, 956,3127,1784, # 3168
4337,2490, 319, 510, 119, 457,3612, 274,2035,2007,4651,1409,3128, 970,2758, 590, # 3184
2800, 661,2247,4652,2008,3950,1420,1549,3080,3322,3951,1651,1375,2111, 485,2491, # 3200
1429,1156,6156,2548,2183,1495, 831,1840,2529,2446, 501,1657, 307,1894,3247,1341, # 3216
 666, 899,2156,1539,2549,1559, 886, 349,2208,3081,2305,1736,3824,2170,2759,1014, # 3232
1913,1386, 542,1397,2948, 490, 368, 716, 362, 159, 282,2569,1129,1658,1288,1750, # 3248
2674, 276, 649,2016, 751,1496, 658,1818,1284,1862,2209,2087,2512,3451, 622,2834, # 3264
 376, 117,1060,2053,1208,1721,1101,1443, 247,1250,3179,1792,3952,2760,2398,3953, # 3280
6157,2144,3708, 446,2432,1151,2570,3452,2447,2761,2835,1210,2448,3082, 424,2222, # 3296
1251,2449,2119,2836, 504,1581,4338, 602, 817, 857,3825,2349,2306, 357,3826,1470, # 3312
1883,2883, 255, 958, 929,2917,3248, 302,4653,1050,1271,1751,2307,1952,1430,2697, # 3328
2719,2359, 354,3180, 777, 158,2036,4339,1659,4340,4654,2308,2949,2248,1146,2232, # 3344
3532,2720,1696,2623,3827,6158,3129,1550,2698,1485,1297,1428, 637, 931,2721,2145, # 3360
 914,2550,2587,  81,2450, 612, 827,2646,1242,4655,1118,2884, 472,1855,3181,3533, # 3376
3534, 569,1353,2699,1244,1758,2588,4119,2009,2762,2171,3709,1312,1531,6159,1152, # 3392
1938, 134,1830, 471,3710,2276,1112,1535,3323,3453,3535, 982,1337,2950, 488, 826, # 3408
 674,1058,1628,4120,2017, 522,2399, 211, 568,1367,3454, 350, 293,1872,1139,3249, # 3424
1399,1946,3006,1300,2360,3324, 588, 736,6160,2606, 744, 669,3536,3828,6161,1358, # 3440
 199, 723, 848, 933, 851,1939,1505,1514,1338,1618,1831,4656,1634,3613, 443,2740, # 3456
3829, 717,1947, 491,1914,6162,2551,1542,4121,1025,6163,1099,1223, 198,3040,2722, # 3472
 370, 410,1905,2589, 998,1248,3182,2380, 519,1449,4122,1710, 947, 928,1153,4341, # 3488
2277, 344,2624,1511, 615, 105, 161,1212,1076,1960,3130,2054,1926,1175,1906,2473, # 3504
 414,1873,2801,6164,2309, 315,1319,3325, 318,2018,2146,2157, 963, 631, 223,4342, # 3520
4343,2675, 479,3711,1197,2625,3712,2676,2361,6165,4344,4123,6166,2451,3183,1886, # 3536
2184,1674,1330,1711,1635,1506, 799, 219,3250,3083,3954,1677,3713,3326,2081,3614, # 3552
1652,2073,4657,1147,3041,1752, 643,1961, 147,1974,3955,6167,1716,2037, 918,3007, # 3568
1994, 120,1537, 118, 609,3184,4345, 740,3455,1219, 332,1615,3830,6168,1621,2980, # 3584
1582, 783, 212, 553,2350,3714,1349,2433,2082,4124, 889,6169,2310,1275,1410, 973, # 3600
 166,1320,3456,1797,1215,3185,2885,1846,2590,2763,4658, 629, 822,3008, 763, 940, # 3616
1990,2862, 439,2409,1566,1240,1622, 926,1282,1907,2764, 654,2210,1607, 327,1130, # 3632
3956,1678,1623,6170,2434,2192, 686, 608,3831,3715, 903,3957,3042,6171,2741,1522, # 3648
1915,1105,1555,2552,1359, 323,3251,4346,3457, 738,1354,2553,2311,2334,1828,2003, # 3664
3832,1753,2351,1227,6172,1887,4125,1478,6173,2410,1874,1712,1847, 520,1204,2607, # 3680
 264,4659, 836,2677,2102, 600,4660,3833,2278,3084,6174,4347,3615,1342, 640, 532, # 3696
 543,2608,1888,2400,2591,1009,4348,1497, 341,1737,3616,2723,1394, 529,3252,1321, # 3712
 983,4661,1515,2120, 971,2592, 924, 287,1662,3186,4349,2700,4350,1519, 908,1948, # 3728
2452, 156, 796,1629,1486,2223,2055, 694,4126,1259,1036,3392,1213,2249,2742,1889, # 3744
1230,3958,1015, 910, 408, 559,3617,4662, 746, 725, 935,4663,3959,3009,1289, 563, # 3760
 867,4664,3960,1567,2981,2038,2626, 988,2263,2381,4351, 143,2374, 704,1895,6175, # 3776
1188,3716,2088, 673,3085,2362,4352, 484,1608,1921,2765,2918, 215, 904,3618,3537, # 3792
 894, 509, 976,3043,2701,3961,4353,2837,2982, 498,6176,6177,1102,3538,1332,3393, # 3808
1487,1636,1637, 233, 245,3962, 383, 650, 995,3044, 460,1520,1206,2352, 749,3327, # 3824
 530, 700, 389,1438,1560,1773,3963,2264, 719,2951,2724,3834, 870,1832,1644,1000, # 3840
 839,2474,3717, 197,1630,3394, 365,2886,3964,1285,2133, 734, 922, 818,1106, 732, # 3856
 480,2083,1774,3458, 923,2279,1350, 221,3086,  85,2233,2234,3835,1585,3010,2147, # 3872
1387,1705,2382,1619,2475, 133, 239,2802,1991,1016,2084,2383, 411,2838,1113, 651, # 3888
1985,1160,3328, 990,1863,3087,1048,1276,2647, 265,2627,1599,3253,2056, 150, 638, # 3904
2019, 656, 853, 326,1479, 680,1439,4354,1001,1759, 413,3459,3395,2492,1431, 459, # 3920
4355,1125,3329,2265,1953,1450,2065,2863, 849, 351,2678,3131,3254,3255,1104,1577, # 3936
 227,1351,1645,2453,2193,1421,2887, 812,2121, 634,  95,2435, 201,2312,4665,1646, # 3952
1671,2743,1601,2554,2702,2648,2280,1315,1366,2089,3132,1573,3718,3965,1729,1189, # 3968
 328,2679,1077,1940,1136, 558,1283, 964,1195, 621,2074,1199,1743,3460,3619,1896, # 3984
1916,1890,3836,2952,1154,2112,1064, 862, 378,3011,2066,2113,2803,1568,2839,6178, # 4000
3088,2919,1941,1660,2004,1992,2194, 142, 707,1590,1708,1624,1922,1023,1836,1233, # 4016
1004,2313, 789, 741,3620,6179,1609,2411,1200,4127,3719,3720,4666,2057,3721, 593, # 4032
2840, 367,2920,1878,6180,3461,1521, 628,1168, 692,2211,2649, 300, 720,2067,2571, # 4048
2953,3396, 959,2504,3966,3539,3462,1977, 701,6181, 954,1043, 800, 681, 183,3722, # 4064
1803,1730,3540,4128,2103, 815,2314, 174, 467, 230,2454,1093,2134, 755,3541,3397, # 4080
1141,1162,6182,1738,2039, 270,3256,2513,1005,1647,2185,3837, 858,1679,1897,1719, # 4096
2954,2324,1806, 402, 670, 167,4129,1498,2158,2104, 750,6183, 915, 189,1680,1551, # 4112
 455,4356,1501,2455, 405,1095,2955, 338,1586,1266,1819, 570, 641,1324, 237,1556, # 4128
2650,1388,3723,6184,1368,2384,1343,1978,3089,2436, 879,3724, 792,1191, 758,3012, # 4144
1411,2135,1322,4357, 240,4667,1848,3725,1574,6185, 420,3045,1546,1391, 714,4358, # 4160
1967, 941,1864, 863, 664, 426, 560,1731,2680,1785,2864,1949,2363, 403,3330,1415, # 4176
1279,2136,1697,2335, 204, 721,2097,3838,  90,6186,2085,2505, 191,3967, 124,2148, # 4192
1376,1798,1178,1107,1898,1405, 860,4359,1243,1272,2375,2983,1558,2456,1638, 113, # 4208
3621, 578,1923,2609, 880, 386,4130, 784,2186,2266,1422,2956,2172,1722, 497, 263, # 4224
2514,1267,2412,2610, 177,2703,3542, 774,1927,1344, 616,1432,1595,1018, 172,4360, # 4240
2325, 911,4361, 438,1468,3622, 794,3968,2024,2173,1681,1829,2957, 945, 895,3090, # 4256
 575,2212,2476, 475,2401,2681, 785,2744,1745,2293,2555,1975,3133,2865, 394,4668, # 4272
3839, 635,4131, 639, 202,1507,2195,2766,1345,1435,2572,3726,1908,1184,1181,2457, # 4288
3727,3134,4362, 843,2611, 437, 916,4669, 234, 769,1884,3046,3047,3623, 833,6187, # 4304
1639,2250,2402,1355,1185,2010,2047, 999, 525,1732,1290,1488,2612, 948,1578,3728, # 4320
2413,2477,1216,2725,2159, 334,3840,1328,3624,2921,1525,4132, 564,1056, 891,4363, # 4336
1444,1698,2385,2251,3729,1365,2281,2235,1717,6188, 864,3841,2515, 444, 527,2767, # 4352
2922,3625, 544, 461,6189, 566, 209,2437,3398,2098,1065,2068,3331,3626,3257,2137, # 4368  #last 512
)


site-packages/pip/_vendor/chardet/escsm.py000064400000024416151446177000014622 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .enums import MachineState

HZ_CLS = (
1,0,0,0,0,0,0,0,  # 00 - 07
0,0,0,0,0,0,0,0,  # 08 - 0f
0,0,0,0,0,0,0,0,  # 10 - 17
0,0,0,1,0,0,0,0,  # 18 - 1f
0,0,0,0,0,0,0,0,  # 20 - 27
0,0,0,0,0,0,0,0,  # 28 - 2f
0,0,0,0,0,0,0,0,  # 30 - 37
0,0,0,0,0,0,0,0,  # 38 - 3f
0,0,0,0,0,0,0,0,  # 40 - 47
0,0,0,0,0,0,0,0,  # 48 - 4f
0,0,0,0,0,0,0,0,  # 50 - 57
0,0,0,0,0,0,0,0,  # 58 - 5f
0,0,0,0,0,0,0,0,  # 60 - 67
0,0,0,0,0,0,0,0,  # 68 - 6f
0,0,0,0,0,0,0,0,  # 70 - 77
0,0,0,4,0,5,2,0,  # 78 - 7f
1,1,1,1,1,1,1,1,  # 80 - 87
1,1,1,1,1,1,1,1,  # 88 - 8f
1,1,1,1,1,1,1,1,  # 90 - 97
1,1,1,1,1,1,1,1,  # 98 - 9f
1,1,1,1,1,1,1,1,  # a0 - a7
1,1,1,1,1,1,1,1,  # a8 - af
1,1,1,1,1,1,1,1,  # b0 - b7
1,1,1,1,1,1,1,1,  # b8 - bf
1,1,1,1,1,1,1,1,  # c0 - c7
1,1,1,1,1,1,1,1,  # c8 - cf
1,1,1,1,1,1,1,1,  # d0 - d7
1,1,1,1,1,1,1,1,  # d8 - df
1,1,1,1,1,1,1,1,  # e0 - e7
1,1,1,1,1,1,1,1,  # e8 - ef
1,1,1,1,1,1,1,1,  # f0 - f7
1,1,1,1,1,1,1,1,  # f8 - ff
)

HZ_ST = (
MachineState.START,MachineState.ERROR,     3,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,# 00-07
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 08-0f
MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,     4,MachineState.ERROR,# 10-17
     5,MachineState.ERROR,     6,MachineState.ERROR,     5,     5,     4,MachineState.ERROR,# 18-1f
     4,MachineState.ERROR,     4,     4,     4,MachineState.ERROR,     4,MachineState.ERROR,# 20-27
     4,MachineState.ITS_ME,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 28-2f
)

HZ_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0)

HZ_SM_MODEL = {'class_table': HZ_CLS,
               'class_factor': 6,
               'state_table': HZ_ST,
               'char_len_table': HZ_CHAR_LEN_TABLE,
               'name': "HZ-GB-2312",
               'language': 'Chinese'}

ISO2022CN_CLS = (
2,0,0,0,0,0,0,0,  # 00 - 07
0,0,0,0,0,0,0,0,  # 08 - 0f
0,0,0,0,0,0,0,0,  # 10 - 17
0,0,0,1,0,0,0,0,  # 18 - 1f
0,0,0,0,0,0,0,0,  # 20 - 27
0,3,0,0,0,0,0,0,  # 28 - 2f
0,0,0,0,0,0,0,0,  # 30 - 37
0,0,0,0,0,0,0,0,  # 38 - 3f
0,0,0,4,0,0,0,0,  # 40 - 47
0,0,0,0,0,0,0,0,  # 48 - 4f
0,0,0,0,0,0,0,0,  # 50 - 57
0,0,0,0,0,0,0,0,  # 58 - 5f
0,0,0,0,0,0,0,0,  # 60 - 67
0,0,0,0,0,0,0,0,  # 68 - 6f
0,0,0,0,0,0,0,0,  # 70 - 77
0,0,0,0,0,0,0,0,  # 78 - 7f
2,2,2,2,2,2,2,2,  # 80 - 87
2,2,2,2,2,2,2,2,  # 88 - 8f
2,2,2,2,2,2,2,2,  # 90 - 97
2,2,2,2,2,2,2,2,  # 98 - 9f
2,2,2,2,2,2,2,2,  # a0 - a7
2,2,2,2,2,2,2,2,  # a8 - af
2,2,2,2,2,2,2,2,  # b0 - b7
2,2,2,2,2,2,2,2,  # b8 - bf
2,2,2,2,2,2,2,2,  # c0 - c7
2,2,2,2,2,2,2,2,  # c8 - cf
2,2,2,2,2,2,2,2,  # d0 - d7
2,2,2,2,2,2,2,2,  # d8 - df
2,2,2,2,2,2,2,2,  # e0 - e7
2,2,2,2,2,2,2,2,  # e8 - ef
2,2,2,2,2,2,2,2,  # f0 - f7
2,2,2,2,2,2,2,2,  # f8 - ff
)

ISO2022CN_ST = (
MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 00-07
MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 08-0f
MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 10-17
MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,# 18-1f
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 20-27
     5,     6,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 28-2f
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 30-37
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,# 38-3f
)

ISO2022CN_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0, 0, 0, 0)

ISO2022CN_SM_MODEL = {'class_table': ISO2022CN_CLS,
                      'class_factor': 9,
                      'state_table': ISO2022CN_ST,
                      'char_len_table': ISO2022CN_CHAR_LEN_TABLE,
                      'name': "ISO-2022-CN",
                      'language': 'Chinese'}

ISO2022JP_CLS = (
2,0,0,0,0,0,0,0,  # 00 - 07
0,0,0,0,0,0,2,2,  # 08 - 0f
0,0,0,0,0,0,0,0,  # 10 - 17
0,0,0,1,0,0,0,0,  # 18 - 1f
0,0,0,0,7,0,0,0,  # 20 - 27
3,0,0,0,0,0,0,0,  # 28 - 2f
0,0,0,0,0,0,0,0,  # 30 - 37
0,0,0,0,0,0,0,0,  # 38 - 3f
6,0,4,0,8,0,0,0,  # 40 - 47
0,9,5,0,0,0,0,0,  # 48 - 4f
0,0,0,0,0,0,0,0,  # 50 - 57
0,0,0,0,0,0,0,0,  # 58 - 5f
0,0,0,0,0,0,0,0,  # 60 - 67
0,0,0,0,0,0,0,0,  # 68 - 6f
0,0,0,0,0,0,0,0,  # 70 - 77
0,0,0,0,0,0,0,0,  # 78 - 7f
2,2,2,2,2,2,2,2,  # 80 - 87
2,2,2,2,2,2,2,2,  # 88 - 8f
2,2,2,2,2,2,2,2,  # 90 - 97
2,2,2,2,2,2,2,2,  # 98 - 9f
2,2,2,2,2,2,2,2,  # a0 - a7
2,2,2,2,2,2,2,2,  # a8 - af
2,2,2,2,2,2,2,2,  # b0 - b7
2,2,2,2,2,2,2,2,  # b8 - bf
2,2,2,2,2,2,2,2,  # c0 - c7
2,2,2,2,2,2,2,2,  # c8 - cf
2,2,2,2,2,2,2,2,  # d0 - d7
2,2,2,2,2,2,2,2,  # d8 - df
2,2,2,2,2,2,2,2,  # e0 - e7
2,2,2,2,2,2,2,2,  # e8 - ef
2,2,2,2,2,2,2,2,  # f0 - f7
2,2,2,2,2,2,2,2,  # f8 - ff
)

ISO2022JP_ST = (
MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 00-07
MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 08-0f
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 10-17
MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,# 18-1f
MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,MachineState.ERROR,# 20-27
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     6,MachineState.ITS_ME,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,# 28-2f
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,# 30-37
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 38-3f
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,MachineState.START,# 40-47
)

ISO2022JP_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0, 0, 0, 0, 0)

ISO2022JP_SM_MODEL = {'class_table': ISO2022JP_CLS,
                      'class_factor': 10,
                      'state_table': ISO2022JP_ST,
                      'char_len_table': ISO2022JP_CHAR_LEN_TABLE,
                      'name': "ISO-2022-JP",
                      'language': 'Japanese'}

ISO2022KR_CLS = (
2,0,0,0,0,0,0,0,  # 00 - 07
0,0,0,0,0,0,0,0,  # 08 - 0f
0,0,0,0,0,0,0,0,  # 10 - 17
0,0,0,1,0,0,0,0,  # 18 - 1f
0,0,0,0,3,0,0,0,  # 20 - 27
0,4,0,0,0,0,0,0,  # 28 - 2f
0,0,0,0,0,0,0,0,  # 30 - 37
0,0,0,0,0,0,0,0,  # 38 - 3f
0,0,0,5,0,0,0,0,  # 40 - 47
0,0,0,0,0,0,0,0,  # 48 - 4f
0,0,0,0,0,0,0,0,  # 50 - 57
0,0,0,0,0,0,0,0,  # 58 - 5f
0,0,0,0,0,0,0,0,  # 60 - 67
0,0,0,0,0,0,0,0,  # 68 - 6f
0,0,0,0,0,0,0,0,  # 70 - 77
0,0,0,0,0,0,0,0,  # 78 - 7f
2,2,2,2,2,2,2,2,  # 80 - 87
2,2,2,2,2,2,2,2,  # 88 - 8f
2,2,2,2,2,2,2,2,  # 90 - 97
2,2,2,2,2,2,2,2,  # 98 - 9f
2,2,2,2,2,2,2,2,  # a0 - a7
2,2,2,2,2,2,2,2,  # a8 - af
2,2,2,2,2,2,2,2,  # b0 - b7
2,2,2,2,2,2,2,2,  # b8 - bf
2,2,2,2,2,2,2,2,  # c0 - c7
2,2,2,2,2,2,2,2,  # c8 - cf
2,2,2,2,2,2,2,2,  # d0 - d7
2,2,2,2,2,2,2,2,  # d8 - df
2,2,2,2,2,2,2,2,  # e0 - e7
2,2,2,2,2,2,2,2,  # e8 - ef
2,2,2,2,2,2,2,2,  # f0 - f7
2,2,2,2,2,2,2,2,  # f8 - ff
)

ISO2022KR_ST = (
MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,# 00-07
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,# 08-0f
MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     4,MachineState.ERROR,MachineState.ERROR,# 10-17
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,# 18-1f
MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.START,MachineState.START,MachineState.START,MachineState.START,# 20-27
)

ISO2022KR_CHAR_LEN_TABLE = (0, 0, 0, 0, 0, 0)

ISO2022KR_SM_MODEL = {'class_table': ISO2022KR_CLS,
                      'class_factor': 6,
                      'state_table': ISO2022KR_ST,
                      'char_len_table': ISO2022KR_CHAR_LEN_TABLE,
                      'name': "ISO-2022-KR",
                      'language': 'Korean'}


site-packages/pip/_vendor/chardet/langhebrewmodel.py000064400000026121151446177000016642 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
#          Simon Montagu
# Portions created by the Initial Developer are Copyright (C) 2005
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#   Shoshannah Forbes - original C code (?)
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# 255: Control characters that usually does not exist in any text
# 254: Carriage/Return
# 253: symbol (punctuation) that does not belong to word
# 252: 0 - 9

# Windows-1255 language model
# Character Mapping Table:
WIN1255_CHAR_TO_ORDER_MAP = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253, 69, 91, 79, 80, 92, 89, 97, 90, 68,111,112, 82, 73, 95, 85,  # 40
 78,121, 86, 71, 67,102,107, 84,114,103,115,253,253,253,253,253,  # 50
253, 50, 74, 60, 61, 42, 76, 70, 64, 53,105, 93, 56, 65, 54, 49,  # 60
 66,110, 51, 43, 44, 63, 81, 77, 98, 75,108,253,253,253,253,253,  # 70
124,202,203,204,205, 40, 58,206,207,208,209,210,211,212,213,214,
215, 83, 52, 47, 46, 72, 32, 94,216,113,217,109,218,219,220,221,
 34,116,222,118,100,223,224,117,119,104,125,225,226, 87, 99,227,
106,122,123,228, 55,229,230,101,231,232,120,233, 48, 39, 57,234,
 30, 59, 41, 88, 33, 37, 36, 31, 29, 35,235, 62, 28,236,126,237,
238, 38, 45,239,240,241,242,243,127,244,245,246,247,248,249,250,
  9,  8, 20, 16,  3,  2, 24, 14, 22,  1, 25, 15,  4, 11,  6, 23,
 12, 19, 13, 26, 18, 27, 21, 17,  7, 10,  5,251,252,128, 96,253,
)

# Model Table:
# total sequences: 100%
# first 512 sequences: 98.4004%
# first 1024 sequences: 1.5981%
# rest  sequences:      0.087%
# negative sequences:   0.0015%
HEBREW_LANG_MODEL = (
0,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,2,3,2,1,2,0,1,0,0,
3,0,3,1,0,0,1,3,2,0,1,1,2,0,2,2,2,1,1,1,1,2,1,1,1,2,0,0,2,2,0,1,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,
1,2,1,2,1,2,0,0,2,0,0,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,
1,2,1,3,1,1,0,0,2,0,0,0,1,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,0,1,2,2,1,3,
1,2,1,1,2,2,0,0,2,2,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,1,0,1,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,2,2,2,2,3,2,
1,2,1,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,2,3,2,2,3,2,2,2,1,2,2,2,2,
1,2,1,1,2,2,0,1,2,0,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,0,2,2,2,2,2,
0,2,0,2,2,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,0,2,2,2,
0,2,1,2,2,2,0,0,2,1,0,0,0,0,1,0,1,0,0,0,0,0,0,2,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,2,1,2,3,2,2,2,
1,2,1,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,1,0,
3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,1,0,2,0,2,
0,2,1,2,2,2,0,0,1,2,0,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,2,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,2,3,2,2,3,2,1,2,1,1,1,
0,1,1,1,1,1,3,0,1,0,0,0,0,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,1,1,0,0,1,0,0,1,0,0,0,0,
0,0,1,0,0,0,0,0,2,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,2,2,2,
0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,2,3,3,3,2,1,2,3,3,2,3,3,3,3,2,3,2,1,2,0,2,1,2,
0,2,0,2,2,2,0,0,1,2,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,
3,3,3,3,3,3,3,3,3,2,3,3,3,1,2,2,3,3,2,3,2,3,2,2,3,1,2,2,0,2,2,2,
0,2,1,2,2,2,0,0,1,2,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,1,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,2,2,2,3,3,3,3,1,3,2,2,2,
0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,3,3,3,2,3,2,2,2,1,2,2,0,2,2,2,2,
0,2,0,2,2,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,1,3,2,3,3,2,3,3,2,2,1,2,2,2,2,2,2,
0,2,1,2,1,2,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,2,3,2,3,3,2,3,3,3,3,2,3,2,3,3,3,3,3,2,2,2,2,2,2,2,1,
0,2,0,1,2,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,2,1,2,3,3,3,3,3,3,3,2,3,2,3,2,1,2,3,0,2,1,2,2,
0,2,1,1,2,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,2,0,
3,3,3,3,3,3,3,3,3,2,3,3,3,3,2,1,3,1,2,2,2,1,2,3,3,1,2,1,2,2,2,2,
0,1,1,1,1,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,0,2,3,3,3,1,3,3,3,1,2,2,2,2,1,1,2,2,2,2,2,2,
0,2,0,1,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,2,3,3,3,2,2,3,3,3,2,1,2,3,2,3,2,2,2,2,1,2,1,1,1,2,2,
0,2,1,1,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,1,0,0,0,0,0,
1,0,1,0,0,0,0,0,2,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,2,3,3,2,3,1,2,2,2,2,3,2,3,1,1,2,2,1,2,2,1,1,0,2,2,2,2,
0,1,0,1,2,2,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,
3,0,0,1,1,0,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,2,2,0,
0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,1,0,1,0,1,1,0,1,1,0,0,0,1,1,0,1,1,1,0,0,0,0,0,0,1,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,0,0,1,1,0,1,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
3,2,2,1,2,2,2,2,2,2,2,1,2,2,1,2,2,1,1,1,1,1,1,1,1,2,1,1,0,3,3,3,
0,3,0,2,2,2,2,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
2,2,2,3,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,1,2,2,1,2,2,2,1,1,1,2,0,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,2,2,2,2,2,2,2,2,1,2,2,2,2,2,2,2,2,2,2,2,0,2,2,0,0,0,0,0,0,
0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,3,1,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,1,2,1,0,2,1,0,
0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,1,0,1,1,1,1,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
0,3,1,1,2,2,2,2,2,1,2,2,2,1,1,2,2,2,2,2,2,2,1,2,2,1,0,1,1,1,1,0,
0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,2,1,1,1,1,2,1,1,2,1,0,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,0,0,0,0,
0,0,2,0,0,0,0,0,0,0,0,1,1,0,0,0,0,1,1,0,0,1,1,0,0,0,0,0,0,1,0,0,
2,1,1,2,2,2,2,2,2,2,2,2,2,2,1,2,2,2,2,2,1,2,1,2,1,1,1,1,0,0,0,0,
0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,2,1,2,2,2,2,2,2,2,2,2,2,1,2,1,2,1,1,2,1,1,1,2,1,2,1,2,0,1,0,1,
0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,1,2,2,2,1,2,2,2,2,2,2,2,2,1,2,1,1,1,1,1,1,2,1,2,1,1,0,1,0,1,
0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,1,2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,2,2,
0,2,0,1,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,1,1,1,1,1,1,1,0,1,1,0,1,0,0,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,2,0,1,1,1,0,1,0,0,0,1,1,0,1,1,0,0,0,0,0,1,1,0,0,
0,1,1,1,2,1,2,2,2,0,2,0,2,0,1,1,2,1,1,1,1,2,1,0,1,1,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,1,0,0,0,0,0,1,0,1,2,2,0,1,0,0,1,1,2,2,1,2,0,2,0,0,0,1,2,0,1,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,2,0,2,1,2,0,2,0,0,1,1,1,1,1,1,0,1,0,0,0,1,0,0,1,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,1,0,0,0,0,0,1,0,2,1,1,0,1,0,0,1,1,1,2,2,0,0,1,0,0,0,1,0,0,1,
1,1,2,1,0,1,1,1,0,1,0,1,1,1,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,2,2,1,
0,2,0,1,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,1,0,0,1,0,1,1,1,1,0,0,0,0,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,1,1,1,1,1,1,1,1,2,1,0,1,1,1,1,1,1,1,1,1,1,1,0,1,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,1,1,0,0,0,0,1,1,1,0,1,1,0,1,0,0,0,1,1,0,1,
2,0,1,0,1,0,1,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,1,1,1,0,1,0,0,1,1,2,1,1,2,0,1,0,0,0,1,1,0,1,
1,0,0,1,0,0,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,0,0,2,1,1,2,0,2,0,0,0,1,1,0,1,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,2,1,1,0,1,0,0,2,2,1,2,1,1,0,1,0,0,0,1,1,0,1,
2,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,2,2,0,0,0,0,0,1,1,0,1,0,0,1,0,0,0,0,1,0,1,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,2,2,0,0,0,0,2,1,1,1,0,2,1,1,0,0,0,2,1,0,1,
1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,1,1,0,2,1,1,0,1,0,0,0,1,1,0,1,
2,2,1,1,1,0,1,1,0,1,1,0,1,0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,2,1,1,0,1,0,0,1,1,0,1,2,1,0,2,0,0,0,1,1,0,1,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,
0,1,0,0,2,0,2,1,1,0,1,0,1,0,0,1,0,0,0,0,1,0,0,0,1,0,0,0,0,0,1,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,1,0,0,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,1,0,1,1,2,0,1,0,0,1,1,1,0,1,0,0,1,0,0,0,1,0,0,1,
1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,0,0,0,0,0,1,0,1,1,0,0,1,0,0,2,1,1,1,1,1,0,1,0,0,0,0,1,0,1,
0,1,1,1,2,1,1,1,1,0,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,2,1,0,0,0,0,0,1,1,1,1,1,0,1,0,0,0,1,1,0,0,
)

Win1255HebrewModel = {
  'char_to_order_map': WIN1255_CHAR_TO_ORDER_MAP,
  'precedence_matrix': HEBREW_LANG_MODEL,
  'typical_positive_ratio': 0.984004,
  'keep_english_letter': False,
  'charset_name': "windows-1255",
  'language': 'Hebrew',
}
site-packages/pip/_vendor/chardet/version.py000064400000000362151446177000015167 0ustar00"""
This module exists only to simplify retrieving the version number of chardet
from within setup.py and from chardet subpackages.

:author: Dan Blanchard (dan.blanchard@gmail.com)
"""

__version__ = "3.0.4"
VERSION = __version__.split('.')
site-packages/pip/_vendor/chardet/langgreekmodel.py000064400000030620151446177000016462 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# 255: Control characters that usually does not exist in any text
# 254: Carriage/Return
# 253: symbol (punctuation) that does not belong to word
# 252: 0 - 9

# Character Mapping Table:
Latin7_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253, 82,100,104, 94, 98,101,116,102,111,187,117, 92, 88,113, 85,  # 40
 79,118,105, 83, 67,114,119, 95, 99,109,188,253,253,253,253,253,  # 50
253, 72, 70, 80, 81, 60, 96, 93, 89, 68,120, 97, 77, 86, 69, 55,  # 60
 78,115, 65, 66, 58, 76,106,103, 87,107,112,253,253,253,253,253,  # 70
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 80
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 90
253,233, 90,253,253,253,253,253,253,253,253,253,253, 74,253,253,  # a0
253,253,253,253,247,248, 61, 36, 46, 71, 73,253, 54,253,108,123,  # b0
110, 31, 51, 43, 41, 34, 91, 40, 52, 47, 44, 53, 38, 49, 59, 39,  # c0
 35, 48,250, 37, 33, 45, 56, 50, 84, 57,120,121, 17, 18, 22, 15,  # d0
124,  1, 29, 20, 21,  3, 32, 13, 25,  5, 11, 16, 10,  6, 30,  4,  # e0
  9,  8, 14,  7,  2, 12, 28, 23, 42, 24, 64, 75, 19, 26, 27,253,  # f0
)

win1253_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253, 82,100,104, 94, 98,101,116,102,111,187,117, 92, 88,113, 85,  # 40
 79,118,105, 83, 67,114,119, 95, 99,109,188,253,253,253,253,253,  # 50
253, 72, 70, 80, 81, 60, 96, 93, 89, 68,120, 97, 77, 86, 69, 55,  # 60
 78,115, 65, 66, 58, 76,106,103, 87,107,112,253,253,253,253,253,  # 70
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 80
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 90
253,233, 61,253,253,253,253,253,253,253,253,253,253, 74,253,253,  # a0
253,253,253,253,247,253,253, 36, 46, 71, 73,253, 54,253,108,123,  # b0
110, 31, 51, 43, 41, 34, 91, 40, 52, 47, 44, 53, 38, 49, 59, 39,  # c0
 35, 48,250, 37, 33, 45, 56, 50, 84, 57,120,121, 17, 18, 22, 15,  # d0
124,  1, 29, 20, 21,  3, 32, 13, 25,  5, 11, 16, 10,  6, 30,  4,  # e0
  9,  8, 14,  7,  2, 12, 28, 23, 42, 24, 64, 75, 19, 26, 27,253,  # f0
)

# Model Table:
# total sequences: 100%
# first 512 sequences: 98.2851%
# first 1024 sequences:1.7001%
# rest  sequences:     0.0359%
# negative sequences:  0.0148%
GreekLangModel = (
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,3,2,2,3,3,3,3,3,3,3,3,1,3,3,3,0,2,2,3,3,0,3,0,3,2,0,3,3,3,0,
3,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,0,3,3,0,3,2,3,3,0,3,2,3,3,3,0,0,3,0,3,0,3,3,2,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
0,2,3,2,2,3,3,3,3,3,3,3,3,0,3,3,3,3,0,2,3,3,0,3,3,3,3,2,3,3,3,0,
2,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,2,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,0,2,1,3,3,3,3,2,3,3,2,3,3,2,0,
0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,0,3,3,3,3,3,3,0,3,3,0,3,3,3,3,3,3,3,3,3,3,0,3,2,3,3,0,
2,0,1,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,2,3,0,0,0,0,3,3,0,3,1,3,3,3,0,3,3,0,3,3,3,3,0,0,0,0,
2,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,0,3,0,3,3,3,3,3,0,3,2,2,2,3,0,2,3,3,3,3,3,2,3,3,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,3,2,2,2,3,3,3,3,0,3,1,3,3,3,3,2,3,3,3,3,3,3,3,2,2,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,2,0,3,0,0,0,3,3,2,3,3,3,3,3,0,0,3,2,3,0,2,3,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,0,3,3,3,3,0,0,3,3,0,2,3,0,3,0,3,3,3,0,0,3,0,3,0,2,2,3,3,0,0,
0,0,1,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,2,0,3,2,3,3,3,3,0,3,3,3,3,3,0,3,3,2,3,2,3,3,2,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,2,3,2,3,3,3,3,3,3,0,2,3,2,3,2,2,2,3,2,3,3,2,3,0,2,2,2,3,0,
2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,3,0,0,0,3,3,3,2,3,3,0,0,3,0,3,0,0,0,3,2,0,3,0,3,0,0,2,0,2,0,
0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,0,3,3,3,3,3,3,0,3,3,0,3,0,0,0,3,3,0,3,3,3,0,0,1,2,3,0,
3,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,2,0,0,3,2,2,3,3,0,3,3,3,3,3,2,1,3,0,3,2,3,3,2,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,3,3,0,2,3,3,3,3,3,3,0,0,3,0,3,0,0,0,3,3,0,3,2,3,0,0,3,3,3,0,
3,0,0,0,2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,0,3,3,3,3,3,3,0,0,3,0,3,0,0,0,3,2,0,3,2,3,0,0,3,2,3,0,
2,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,3,1,2,2,3,3,3,3,3,3,0,2,3,0,3,0,0,0,3,3,0,3,0,2,0,0,2,3,1,0,
2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,0,3,3,3,3,0,3,0,3,3,2,3,0,3,3,3,3,3,3,0,3,3,3,0,2,3,0,0,3,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,0,3,3,3,0,0,3,0,0,0,3,3,0,3,0,2,3,3,0,0,3,0,3,0,3,3,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,3,0,0,0,3,3,3,3,3,3,0,0,3,0,2,0,0,0,3,3,0,3,0,3,0,0,2,0,2,0,
0,0,0,0,1,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,3,0,3,0,2,0,3,2,0,3,2,3,2,3,0,0,3,2,3,2,3,3,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,3,0,0,2,3,3,3,3,3,0,0,0,3,0,2,1,0,0,3,2,2,2,0,3,0,0,2,2,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,0,3,3,3,2,0,3,0,3,0,3,3,0,2,1,2,3,3,0,0,3,0,3,0,3,3,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,2,3,3,3,0,3,3,3,3,3,3,0,2,3,0,3,0,0,0,2,1,0,2,2,3,0,0,2,2,2,0,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,3,0,0,2,3,3,3,2,3,0,0,1,3,0,2,0,0,0,0,3,0,1,0,2,0,0,1,1,1,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,3,1,0,3,0,0,0,3,2,0,3,2,3,3,3,0,0,3,0,3,2,2,2,1,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,0,3,3,3,0,0,3,0,0,0,0,2,0,2,3,3,2,2,2,2,3,0,2,0,2,2,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,3,3,3,2,0,0,0,0,0,0,2,3,0,2,0,2,3,2,0,0,3,0,3,0,3,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,3,2,3,3,2,2,3,0,2,0,3,0,0,0,2,0,0,0,0,1,2,0,2,0,2,0,
0,2,0,2,0,2,2,0,0,1,0,2,2,2,0,2,2,2,0,2,2,2,0,0,2,0,0,1,0,0,0,0,
0,2,0,3,3,2,0,0,0,0,0,0,1,3,0,2,0,2,2,2,0,0,2,0,3,0,0,2,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,3,0,2,3,2,0,2,2,0,2,0,2,2,0,2,0,2,2,2,0,0,0,0,0,0,2,3,0,0,0,2,
0,1,2,0,0,0,0,2,2,0,0,0,2,1,0,2,2,0,0,0,0,0,0,1,0,2,0,0,0,0,0,0,
0,0,2,1,0,2,3,2,2,3,2,3,2,0,0,3,3,3,0,0,3,2,0,0,0,1,1,0,2,0,2,2,
0,2,0,2,0,2,2,0,0,2,0,2,2,2,0,2,2,2,2,0,0,2,0,0,0,2,0,1,0,0,0,0,
0,3,0,3,3,2,2,0,3,0,0,0,2,2,0,2,2,2,1,2,0,0,1,2,2,0,0,3,0,0,0,2,
0,1,2,0,0,0,1,2,0,0,0,0,0,0,0,2,2,0,1,0,0,2,0,0,0,2,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,2,3,3,2,2,0,0,0,2,0,2,3,3,0,2,0,0,0,0,0,0,2,2,2,0,2,2,0,2,0,2,
0,2,2,0,0,2,2,2,2,1,0,0,2,2,0,2,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,
0,2,0,3,2,3,0,0,0,3,0,0,2,2,0,2,0,2,2,2,0,0,2,0,0,0,0,0,0,0,0,2,
0,0,2,2,0,0,2,2,2,0,0,0,0,0,0,2,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,2,0,0,3,2,0,2,2,2,2,2,0,0,0,2,0,0,0,0,2,0,1,0,0,2,0,1,0,0,0,
0,2,2,2,0,2,2,0,1,2,0,2,2,2,0,2,2,2,2,1,2,2,0,0,2,0,0,0,0,0,0,0,
0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
0,2,0,2,0,2,2,0,0,0,0,1,2,1,0,0,2,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,3,2,3,0,0,2,0,0,0,2,2,0,2,0,0,0,1,0,0,2,0,2,0,2,2,0,0,0,0,
0,0,2,0,0,0,0,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,
0,2,2,3,2,2,0,0,0,0,0,0,1,3,0,2,0,2,2,0,0,0,1,0,2,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,2,0,2,0,3,2,0,2,0,0,0,0,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
0,0,2,0,0,0,0,1,1,0,0,2,1,2,0,2,2,0,1,0,0,1,0,0,0,2,0,0,0,0,0,0,
0,3,0,2,2,2,0,0,2,0,0,0,2,0,0,0,2,3,0,2,0,0,0,0,0,0,2,2,0,0,0,2,
0,1,2,0,0,0,1,2,2,1,0,0,0,2,0,0,2,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,2,1,2,0,2,2,0,2,0,0,2,0,0,0,0,1,2,1,0,2,1,0,0,0,0,0,0,0,0,0,0,
0,0,2,0,0,0,3,1,2,2,0,2,0,0,0,0,2,0,0,0,2,0,0,3,0,0,0,0,2,2,2,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,2,1,0,2,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,2,
0,2,2,0,0,2,2,2,2,2,0,1,2,0,0,0,2,2,0,1,0,2,0,0,2,2,0,0,0,0,0,0,
0,0,0,0,1,0,0,0,0,0,0,0,3,0,0,2,0,0,0,0,0,0,0,0,2,0,2,0,0,0,0,2,
0,1,2,0,0,0,0,2,2,1,0,1,0,1,0,2,2,2,1,0,0,0,0,0,0,1,0,0,0,0,0,0,
0,2,0,1,2,0,0,0,0,0,0,0,0,0,0,2,0,0,2,2,0,0,0,0,1,0,0,0,0,0,0,2,
0,2,2,0,0,0,0,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,2,0,0,0,
0,2,2,2,2,0,0,0,3,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,1,
0,0,2,0,0,0,0,1,2,0,0,0,0,0,0,2,2,1,1,0,0,0,0,0,0,1,0,0,0,0,0,0,
0,2,0,2,2,2,0,0,2,0,0,0,0,0,0,0,2,2,2,0,0,0,2,0,0,0,0,0,0,0,0,2,
0,0,1,0,0,0,0,2,1,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
0,3,0,2,0,0,0,0,0,0,0,0,2,0,0,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,2,
0,0,2,0,0,0,0,2,2,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,2,0,2,2,1,0,0,0,0,0,0,2,0,0,2,0,2,2,2,0,0,0,0,0,0,2,0,0,0,0,2,
0,0,2,0,0,2,0,2,2,0,0,0,0,2,0,2,0,0,0,0,0,2,0,0,0,2,0,0,0,0,0,0,
0,0,3,0,0,0,2,2,0,2,2,0,0,0,0,0,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,2,0,0,0,0,0,
0,2,2,2,2,2,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1,
0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,2,2,0,0,0,0,0,2,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
0,2,0,0,0,2,0,0,0,0,0,1,0,0,0,0,2,2,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,2,0,0,0,
0,2,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,2,0,2,0,0,0,
0,0,0,0,0,0,0,0,2,1,0,0,0,0,0,0,2,0,0,0,1,2,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
)

Latin7GreekModel = {
  'char_to_order_map': Latin7_char_to_order_map,
  'precedence_matrix': GreekLangModel,
  'typical_positive_ratio': 0.982851,
  'keep_english_letter': False,
  'charset_name': "ISO-8859-7",
  'language': 'Greek',
}

Win1253GreekModel = {
  'char_to_order_map': win1253_char_to_order_map,
  'precedence_matrix': GreekLangModel,
  'typical_positive_ratio': 0.982851,
  'keep_english_letter': False,
  'charset_name': "windows-1253",
  'language': 'Greek',
}
site-packages/pip/_vendor/chardet/euctwprober.py000064400000003323151446177000016043 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .mbcharsetprober import MultiByteCharSetProber
from .codingstatemachine import CodingStateMachine
from .chardistribution import EUCTWDistributionAnalysis
from .mbcssm import EUCTW_SM_MODEL

class EUCTWProber(MultiByteCharSetProber):
    def __init__(self):
        super(EUCTWProber, self).__init__()
        self.coding_sm = CodingStateMachine(EUCTW_SM_MODEL)
        self.distribution_analyzer = EUCTWDistributionAnalysis()
        self.reset()

    @property
    def charset_name(self):
        return "EUC-TW"

    @property
    def language(self):
        return "Taiwan"
site-packages/pip/_vendor/chardet/euctwfreq.py000064400000075605151446177000015523 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# EUCTW frequency table
# Converted from big5 work
# by Taiwan's Mandarin Promotion Council
# <http:#www.edu.tw:81/mandr/>

# 128  --> 0.42261
# 256  --> 0.57851
# 512  --> 0.74851
# 1024 --> 0.89384
# 2048 --> 0.97583
#
# Idea Distribution Ratio = 0.74851/(1-0.74851) =2.98
# Random Distribution Ration = 512/(5401-512)=0.105
#
# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR

EUCTW_TYPICAL_DISTRIBUTION_RATIO = 0.75

# Char to FreqOrder table ,
EUCTW_TABLE_SIZE = 5376

EUCTW_CHAR_TO_FREQ_ORDER = (
   1,1800,1506, 255,1431, 198,   9,  82,   6,7310, 177, 202,3615,1256,2808, 110,  # 2742
3735,  33,3241, 261,  76,  44,2113,  16,2931,2184,1176, 659,3868,  26,3404,2643,  # 2758
1198,3869,3313,4060, 410,2211, 302, 590, 361,1963,   8, 204,  58,4296,7311,1931,  # 2774
  63,7312,7313, 317,1614,  75, 222, 159,4061,2412,1480,7314,3500,3068, 224,2809,  # 2790
3616,   3,  10,3870,1471,  29,2774,1135,2852,1939, 873, 130,3242,1123, 312,7315,  # 2806
4297,2051, 507, 252, 682,7316, 142,1914, 124, 206,2932,  34,3501,3173,  64, 604,  # 2822
7317,2494,1976,1977, 155,1990, 645, 641,1606,7318,3405, 337,  72, 406,7319,  80,  # 2838
 630, 238,3174,1509, 263, 939,1092,2644, 756,1440,1094,3406, 449,  69,2969, 591,  # 2854
 179,2095, 471, 115,2034,1843,  60,  50,2970, 134, 806,1868, 734,2035,3407, 180,  # 2870
 995,1607, 156, 537,2893, 688,7320, 319,1305, 779,2144, 514,2374, 298,4298, 359,  # 2886
2495,  90,2707,1338, 663,  11, 906,1099,2545,  20,2436, 182, 532,1716,7321, 732,  # 2902
1376,4062,1311,1420,3175,  25,2312,1056, 113, 399, 382,1949, 242,3408,2467, 529,  # 2918
3243, 475,1447,3617,7322, 117,  21, 656, 810,1297,2295,2329,3502,7323, 126,4063,  # 2934
 706, 456, 150, 613,4299,  71,1118,2036,4064, 145,3069,  85, 835, 486,2114,1246,  # 2950
1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,7324,2127,2354, 347,3736, 221,  # 2966
3503,3110,7325,1955,1153,4065,  83, 296,1199,3070, 192, 624,  93,7326, 822,1897,  # 2982
2810,3111, 795,2064, 991,1554,1542,1592,  27,  43,2853, 859, 139,1456, 860,4300,  # 2998
 437, 712,3871, 164,2392,3112, 695, 211,3017,2096, 195,3872,1608,3504,3505,3618,  # 3014
3873, 234, 811,2971,2097,3874,2229,1441,3506,1615,2375, 668,2076,1638, 305, 228,  # 3030
1664,4301, 467, 415,7327, 262,2098,1593, 239, 108, 300, 200,1033, 512,1247,2077,  # 3046
7328,7329,2173,3176,3619,2673, 593, 845,1062,3244,  88,1723,2037,3875,1950, 212,  # 3062
 266, 152, 149, 468,1898,4066,4302,  77, 187,7330,3018,  37,   5,2972,7331,3876,  # 3078
7332,7333,  39,2517,4303,2894,3177,2078,  55, 148,  74,4304, 545, 483,1474,1029,  # 3094
1665, 217,1869,1531,3113,1104,2645,4067,  24, 172,3507, 900,3877,3508,3509,4305,  # 3110
  32,1408,2811,1312, 329, 487,2355,2247,2708, 784,2674,   4,3019,3314,1427,1788,  # 3126
 188, 109, 499,7334,3620,1717,1789, 888,1217,3020,4306,7335,3510,7336,3315,1520,  # 3142
3621,3878, 196,1034, 775,7337,7338, 929,1815, 249, 439,  38,7339,1063,7340, 794,  # 3158
3879,1435,2296,  46, 178,3245,2065,7341,2376,7342, 214,1709,4307, 804,  35, 707,  # 3174
 324,3622,1601,2546, 140, 459,4068,7343,7344,1365, 839, 272, 978,2257,2572,3409,  # 3190
2128,1363,3623,1423, 697, 100,3071,  48,  70,1231, 495,3114,2193,7345,1294,7346,  # 3206
2079, 462, 586,1042,3246, 853, 256, 988, 185,2377,3410,1698, 434,1084,7347,3411,  # 3222
 314,2615,2775,4308,2330,2331, 569,2280, 637,1816,2518, 757,1162,1878,1616,3412,  # 3238
 287,1577,2115, 768,4309,1671,2854,3511,2519,1321,3737, 909,2413,7348,4069, 933,  # 3254
3738,7349,2052,2356,1222,4310, 765,2414,1322, 786,4311,7350,1919,1462,1677,2895,  # 3270
1699,7351,4312,1424,2437,3115,3624,2590,3316,1774,1940,3413,3880,4070, 309,1369,  # 3286
1130,2812, 364,2230,1653,1299,3881,3512,3882,3883,2646, 525,1085,3021, 902,2000,  # 3302
1475, 964,4313, 421,1844,1415,1057,2281, 940,1364,3116, 376,4314,4315,1381,   7,  # 3318
2520, 983,2378, 336,1710,2675,1845, 321,3414, 559,1131,3022,2742,1808,1132,1313,  # 3334
 265,1481,1857,7352, 352,1203,2813,3247, 167,1089, 420,2814, 776, 792,1724,3513,  # 3350
4071,2438,3248,7353,4072,7354, 446, 229, 333,2743, 901,3739,1200,1557,4316,2647,  # 3366
1920, 395,2744,2676,3740,4073,1835, 125, 916,3178,2616,4317,7355,7356,3741,7357,  # 3382
7358,7359,4318,3117,3625,1133,2547,1757,3415,1510,2313,1409,3514,7360,2145, 438,  # 3398
2591,2896,2379,3317,1068, 958,3023, 461, 311,2855,2677,4074,1915,3179,4075,1978,  # 3414
 383, 750,2745,2617,4076, 274, 539, 385,1278,1442,7361,1154,1964, 384, 561, 210,  # 3430
  98,1295,2548,3515,7362,1711,2415,1482,3416,3884,2897,1257, 129,7363,3742, 642,  # 3446
 523,2776,2777,2648,7364, 141,2231,1333,  68, 176, 441, 876, 907,4077, 603,2592,  # 3462
 710, 171,3417, 404, 549,  18,3118,2393,1410,3626,1666,7365,3516,4319,2898,4320,  # 3478
7366,2973, 368,7367, 146, 366,  99, 871,3627,1543, 748, 807,1586,1185,  22,2258,  # 3494
 379,3743,3180,7368,3181, 505,1941,2618,1991,1382,2314,7369, 380,2357, 218, 702,  # 3510
1817,1248,3418,3024,3517,3318,3249,7370,2974,3628, 930,3250,3744,7371,  59,7372,  # 3526
 585, 601,4078, 497,3419,1112,1314,4321,1801,7373,1223,1472,2174,7374, 749,1836,  # 3542
 690,1899,3745,1772,3885,1476, 429,1043,1790,2232,2116, 917,4079, 447,1086,1629,  # 3558
7375, 556,7376,7377,2020,1654, 844,1090, 105, 550, 966,1758,2815,1008,1782, 686,  # 3574
1095,7378,2282, 793,1602,7379,3518,2593,4322,4080,2933,2297,4323,3746, 980,2496,  # 3590
 544, 353, 527,4324, 908,2678,2899,7380, 381,2619,1942,1348,7381,1341,1252, 560,  # 3606
3072,7382,3420,2856,7383,2053, 973, 886,2080, 143,4325,7384,7385, 157,3886, 496,  # 3622
4081,  57, 840, 540,2038,4326,4327,3421,2117,1445, 970,2259,1748,1965,2081,4082,  # 3638
3119,1234,1775,3251,2816,3629, 773,1206,2129,1066,2039,1326,3887,1738,1725,4083,  # 3654
 279,3120,  51,1544,2594, 423,1578,2130,2066, 173,4328,1879,7386,7387,1583, 264,  # 3670
 610,3630,4329,2439, 280, 154,7388,7389,7390,1739, 338,1282,3073, 693,2857,1411,  # 3686
1074,3747,2440,7391,4330,7392,7393,1240, 952,2394,7394,2900,1538,2679, 685,1483,  # 3702
4084,2468,1436, 953,4085,2054,4331, 671,2395,  79,4086,2441,3252, 608, 567,2680,  # 3718
3422,4087,4088,1691, 393,1261,1791,2396,7395,4332,7396,7397,7398,7399,1383,1672,  # 3734
3748,3182,1464, 522,1119, 661,1150, 216, 675,4333,3888,1432,3519, 609,4334,2681,  # 3750
2397,7400,7401,7402,4089,3025,   0,7403,2469, 315, 231,2442, 301,3319,4335,2380,  # 3766
7404, 233,4090,3631,1818,4336,4337,7405,  96,1776,1315,2082,7406, 257,7407,1809,  # 3782
3632,2709,1139,1819,4091,2021,1124,2163,2778,1777,2649,7408,3074, 363,1655,3183,  # 3798
7409,2975,7410,7411,7412,3889,1567,3890, 718, 103,3184, 849,1443, 341,3320,2934,  # 3814
1484,7413,1712, 127,  67, 339,4092,2398, 679,1412, 821,7414,7415, 834, 738, 351,  # 3830
2976,2146, 846, 235,1497,1880, 418,1992,3749,2710, 186,1100,2147,2746,3520,1545,  # 3846
1355,2935,2858,1377, 583,3891,4093,2573,2977,7416,1298,3633,1078,2549,3634,2358,  # 3862
  78,3750,3751, 267,1289,2099,2001,1594,4094, 348, 369,1274,2194,2175,1837,4338,  # 3878
1820,2817,3635,2747,2283,2002,4339,2936,2748, 144,3321, 882,4340,3892,2749,3423,  # 3894
4341,2901,7417,4095,1726, 320,7418,3893,3026, 788,2978,7419,2818,1773,1327,2859,  # 3910
3894,2819,7420,1306,4342,2003,1700,3752,3521,2359,2650, 787,2022, 506, 824,3636,  # 3926
 534, 323,4343,1044,3322,2023,1900, 946,3424,7421,1778,1500,1678,7422,1881,4344,  # 3942
 165, 243,4345,3637,2521, 123, 683,4096, 764,4346,  36,3895,1792, 589,2902, 816,  # 3958
 626,1667,3027,2233,1639,1555,1622,3753,3896,7423,3897,2860,1370,1228,1932, 891,  # 3974
2083,2903, 304,4097,7424, 292,2979,2711,3522, 691,2100,4098,1115,4347, 118, 662,  # 3990
7425, 611,1156, 854,2381,1316,2861,   2, 386, 515,2904,7426,7427,3253, 868,2234,  # 4006
1486, 855,2651, 785,2212,3028,7428,1040,3185,3523,7429,3121, 448,7430,1525,7431,  # 4022
2164,4348,7432,3754,7433,4099,2820,3524,3122, 503, 818,3898,3123,1568, 814, 676,  # 4038
1444, 306,1749,7434,3755,1416,1030, 197,1428, 805,2821,1501,4349,7435,7436,7437,  # 4054
1993,7438,4350,7439,7440,2195,  13,2779,3638,2980,3124,1229,1916,7441,3756,2131,  # 4070
7442,4100,4351,2399,3525,7443,2213,1511,1727,1120,7444,7445, 646,3757,2443, 307,  # 4086
7446,7447,1595,3186,7448,7449,7450,3639,1113,1356,3899,1465,2522,2523,7451, 519,  # 4102
7452, 128,2132,  92,2284,1979,7453,3900,1512, 342,3125,2196,7454,2780,2214,1980,  # 4118
3323,7455, 290,1656,1317, 789, 827,2360,7456,3758,4352, 562, 581,3901,7457, 401,  # 4134
4353,2248,  94,4354,1399,2781,7458,1463,2024,4355,3187,1943,7459, 828,1105,4101,  # 4150
1262,1394,7460,4102, 605,4356,7461,1783,2862,7462,2822, 819,2101, 578,2197,2937,  # 4166
7463,1502, 436,3254,4103,3255,2823,3902,2905,3425,3426,7464,2712,2315,7465,7466,  # 4182
2332,2067,  23,4357, 193, 826,3759,2102, 699,1630,4104,3075, 390,1793,1064,3526,  # 4198
7467,1579,3076,3077,1400,7468,4105,1838,1640,2863,7469,4358,4359, 137,4106, 598,  # 4214
3078,1966, 780, 104, 974,2938,7470, 278, 899, 253, 402, 572, 504, 493,1339,7471,  # 4230
3903,1275,4360,2574,2550,7472,3640,3029,3079,2249, 565,1334,2713, 863,  41,7473,  # 4246
7474,4361,7475,1657,2333,  19, 463,2750,4107, 606,7476,2981,3256,1087,2084,1323,  # 4262
2652,2982,7477,1631,1623,1750,4108,2682,7478,2864, 791,2714,2653,2334, 232,2416,  # 4278
7479,2983,1498,7480,2654,2620, 755,1366,3641,3257,3126,2025,1609, 119,1917,3427,  # 4294
 862,1026,4109,7481,3904,3760,4362,3905,4363,2260,1951,2470,7482,1125, 817,4110,  # 4310
4111,3906,1513,1766,2040,1487,4112,3030,3258,2824,3761,3127,7483,7484,1507,7485,  # 4326
2683, 733,  40,1632,1106,2865, 345,4113, 841,2524, 230,4364,2984,1846,3259,3428,  # 4342
7486,1263, 986,3429,7487, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562,3907,  # 4358
3908,2939, 967,2751,2655,1349, 592,2133,1692,3324,2985,1994,4114,1679,3909,1901,  # 4374
2185,7488, 739,3642,2715,1296,1290,7489,4115,2198,2199,1921,1563,2595,2551,1870,  # 4390
2752,2986,7490, 435,7491, 343,1108, 596,  17,1751,4365,2235,3430,3643,7492,4366,  # 4406
 294,3527,2940,1693, 477, 979, 281,2041,3528, 643,2042,3644,2621,2782,2261,1031,  # 4422
2335,2134,2298,3529,4367, 367,1249,2552,7493,3530,7494,4368,1283,3325,2004, 240,  # 4438
1762,3326,4369,4370, 836,1069,3128, 474,7495,2148,2525, 268,3531,7496,3188,1521,  # 4454
1284,7497,1658,1546,4116,7498,3532,3533,7499,4117,3327,2684,1685,4118, 961,1673,  # 4470
2622, 190,2005,2200,3762,4371,4372,7500, 570,2497,3645,1490,7501,4373,2623,3260,  # 4486
1956,4374, 584,1514, 396,1045,1944,7502,4375,1967,2444,7503,7504,4376,3910, 619,  # 4502
7505,3129,3261, 215,2006,2783,2553,3189,4377,3190,4378, 763,4119,3763,4379,7506,  # 4518
7507,1957,1767,2941,3328,3646,1174, 452,1477,4380,3329,3130,7508,2825,1253,2382,  # 4534
2186,1091,2285,4120, 492,7509, 638,1169,1824,2135,1752,3911, 648, 926,1021,1324,  # 4550
4381, 520,4382, 997, 847,1007, 892,4383,3764,2262,1871,3647,7510,2400,1784,4384,  # 4566
1952,2942,3080,3191,1728,4121,2043,3648,4385,2007,1701,3131,1551,  30,2263,4122,  # 4582
7511,2026,4386,3534,7512, 501,7513,4123, 594,3431,2165,1821,3535,3432,3536,3192,  # 4598
 829,2826,4124,7514,1680,3132,1225,4125,7515,3262,4387,4126,3133,2336,7516,4388,  # 4614
4127,7517,3912,3913,7518,1847,2383,2596,3330,7519,4389, 374,3914, 652,4128,4129,  # 4630
 375,1140, 798,7520,7521,7522,2361,4390,2264, 546,1659, 138,3031,2445,4391,7523,  # 4646
2250, 612,1848, 910, 796,3765,1740,1371, 825,3766,3767,7524,2906,2554,7525, 692,  # 4662
 444,3032,2624, 801,4392,4130,7526,1491, 244,1053,3033,4131,4132, 340,7527,3915,  # 4678
1041,2987, 293,1168,  87,1357,7528,1539, 959,7529,2236, 721, 694,4133,3768, 219,  # 4694
1478, 644,1417,3331,2656,1413,1401,1335,1389,3916,7530,7531,2988,2362,3134,1825,  # 4710
 730,1515, 184,2827,  66,4393,7532,1660,2943, 246,3332, 378,1457, 226,3433, 975,  # 4726
3917,2944,1264,3537, 674, 696,7533, 163,7534,1141,2417,2166, 713,3538,3333,4394,  # 4742
3918,7535,7536,1186,  15,7537,1079,1070,7538,1522,3193,3539, 276,1050,2716, 758,  # 4758
1126, 653,2945,3263,7539,2337, 889,3540,3919,3081,2989, 903,1250,4395,3920,3434,  # 4774
3541,1342,1681,1718, 766,3264, 286,  89,2946,3649,7540,1713,7541,2597,3334,2990,  # 4790
7542,2947,2215,3194,2866,7543,4396,2498,2526, 181, 387,1075,3921, 731,2187,3335,  # 4806
7544,3265, 310, 313,3435,2299, 770,4134,  54,3034, 189,4397,3082,3769,3922,7545,  # 4822
1230,1617,1849, 355,3542,4135,4398,3336, 111,4136,3650,1350,3135,3436,3035,4137,  # 4838
2149,3266,3543,7546,2784,3923,3924,2991, 722,2008,7547,1071, 247,1207,2338,2471,  # 4854
1378,4399,2009, 864,1437,1214,4400, 373,3770,1142,2216, 667,4401, 442,2753,2555,  # 4870
3771,3925,1968,4138,3267,1839, 837, 170,1107, 934,1336,1882,7548,7549,2118,4139,  # 4886
2828, 743,1569,7550,4402,4140, 582,2384,1418,3437,7551,1802,7552, 357,1395,1729,  # 4902
3651,3268,2418,1564,2237,7553,3083,3772,1633,4403,1114,2085,4141,1532,7554, 482,  # 4918
2446,4404,7555,7556,1492, 833,1466,7557,2717,3544,1641,2829,7558,1526,1272,3652,  # 4934
4142,1686,1794, 416,2556,1902,1953,1803,7559,3773,2785,3774,1159,2316,7560,2867,  # 4950
4405,1610,1584,3036,2419,2754, 443,3269,1163,3136,7561,7562,3926,7563,4143,2499,  # 4966
3037,4406,3927,3137,2103,1647,3545,2010,1872,4144,7564,4145, 431,3438,7565, 250,  # 4982
  97,  81,4146,7566,1648,1850,1558, 160, 848,7567, 866, 740,1694,7568,2201,2830,  # 4998
3195,4147,4407,3653,1687, 950,2472, 426, 469,3196,3654,3655,3928,7569,7570,1188,  # 5014
 424,1995, 861,3546,4148,3775,2202,2685, 168,1235,3547,4149,7571,2086,1674,4408,  # 5030
3337,3270, 220,2557,1009,7572,3776, 670,2992, 332,1208, 717,7573,7574,3548,2447,  # 5046
3929,3338,7575, 513,7576,1209,2868,3339,3138,4409,1080,7577,7578,7579,7580,2527,  # 5062
3656,3549, 815,1587,3930,3931,7581,3550,3439,3777,1254,4410,1328,3038,1390,3932,  # 5078
1741,3933,3778,3934,7582, 236,3779,2448,3271,7583,7584,3657,3780,1273,3781,4411,  # 5094
7585, 308,7586,4412, 245,4413,1851,2473,1307,2575, 430, 715,2136,2449,7587, 270,  # 5110
 199,2869,3935,7588,3551,2718,1753, 761,1754, 725,1661,1840,4414,3440,3658,7589,  # 5126
7590, 587,  14,3272, 227,2598, 326, 480,2265, 943,2755,3552, 291, 650,1883,7591,  # 5142
1702,1226, 102,1547,  62,3441, 904,4415,3442,1164,4150,7592,7593,1224,1548,2756,  # 5158
 391, 498,1493,7594,1386,1419,7595,2055,1177,4416, 813, 880,1081,2363, 566,1145,  # 5174
4417,2286,1001,1035,2558,2599,2238, 394,1286,7596,7597,2068,7598,  86,1494,1730,  # 5190
3936, 491,1588, 745, 897,2948, 843,3340,3937,2757,2870,3273,1768, 998,2217,2069,  # 5206
 397,1826,1195,1969,3659,2993,3341, 284,7599,3782,2500,2137,2119,1903,7600,3938,  # 5222
2150,3939,4151,1036,3443,1904, 114,2559,4152, 209,1527,7601,7602,2949,2831,2625,  # 5238
2385,2719,3139, 812,2560,7603,3274,7604,1559, 737,1884,3660,1210, 885,  28,2686,  # 5254
3553,3783,7605,4153,1004,1779,4418,7606, 346,1981,2218,2687,4419,3784,1742, 797,  # 5270
1642,3940,1933,1072,1384,2151, 896,3941,3275,3661,3197,2871,3554,7607,2561,1958,  # 5286
4420,2450,1785,7608,7609,7610,3942,4154,1005,1308,3662,4155,2720,4421,4422,1528,  # 5302
2600, 161,1178,4156,1982, 987,4423,1101,4157, 631,3943,1157,3198,2420,1343,1241,  # 5318
1016,2239,2562, 372, 877,2339,2501,1160, 555,1934, 911,3944,7611, 466,1170, 169,  # 5334
1051,2907,2688,3663,2474,2994,1182,2011,2563,1251,2626,7612, 992,2340,3444,1540,  # 5350
2721,1201,2070,2401,1996,2475,7613,4424, 528,1922,2188,1503,1873,1570,2364,3342,  # 5366
3276,7614, 557,1073,7615,1827,3445,2087,2266,3140,3039,3084, 767,3085,2786,4425,  # 5382
1006,4158,4426,2341,1267,2176,3664,3199, 778,3945,3200,2722,1597,2657,7616,4427,  # 5398
7617,3446,7618,7619,7620,3277,2689,1433,3278, 131,  95,1504,3946, 723,4159,3141,  # 5414
1841,3555,2758,2189,3947,2027,2104,3665,7621,2995,3948,1218,7622,3343,3201,3949,  # 5430
4160,2576, 248,1634,3785, 912,7623,2832,3666,3040,3786, 654,  53,7624,2996,7625,  # 5446
1688,4428, 777,3447,1032,3950,1425,7626, 191, 820,2120,2833, 971,4429, 931,3202,  # 5462
 135, 664, 783,3787,1997, 772,2908,1935,3951,3788,4430,2909,3203, 282,2723, 640,  # 5478
1372,3448,1127, 922, 325,3344,7627,7628, 711,2044,7629,7630,3952,2219,2787,1936,  # 5494
3953,3345,2220,2251,3789,2300,7631,4431,3790,1258,3279,3954,3204,2138,2950,3955,  # 5510
3956,7632,2221, 258,3205,4432, 101,1227,7633,3280,1755,7634,1391,3281,7635,2910,  # 5526
2056, 893,7636,7637,7638,1402,4161,2342,7639,7640,3206,3556,7641,7642, 878,1325,  # 5542
1780,2788,4433, 259,1385,2577, 744,1183,2267,4434,7643,3957,2502,7644, 684,1024,  # 5558
4162,7645, 472,3557,3449,1165,3282,3958,3959, 322,2152, 881, 455,1695,1152,1340,  # 5574
 660, 554,2153,4435,1058,4436,4163, 830,1065,3346,3960,4437,1923,7646,1703,1918,  # 5590
7647, 932,2268, 122,7648,4438, 947, 677,7649,3791,2627, 297,1905,1924,2269,4439,  # 5606
2317,3283,7650,7651,4164,7652,4165,  84,4166, 112, 989,7653, 547,1059,3961, 701,  # 5622
3558,1019,7654,4167,7655,3450, 942, 639, 457,2301,2451, 993,2951, 407, 851, 494,  # 5638
4440,3347, 927,7656,1237,7657,2421,3348, 573,4168, 680, 921,2911,1279,1874, 285,  # 5654
 790,1448,1983, 719,2167,7658,7659,4441,3962,3963,1649,7660,1541, 563,7661,1077,  # 5670
7662,3349,3041,3451, 511,2997,3964,3965,3667,3966,1268,2564,3350,3207,4442,4443,  # 5686
7663, 535,1048,1276,1189,2912,2028,3142,1438,1373,2834,2952,1134,2012,7664,4169,  # 5702
1238,2578,3086,1259,7665, 700,7666,2953,3143,3668,4170,7667,4171,1146,1875,1906,  # 5718
4444,2601,3967, 781,2422, 132,1589, 203, 147, 273,2789,2402, 898,1786,2154,3968,  # 5734
3969,7668,3792,2790,7669,7670,4445,4446,7671,3208,7672,1635,3793, 965,7673,1804,  # 5750
2690,1516,3559,1121,1082,1329,3284,3970,1449,3794,  65,1128,2835,2913,2759,1590,  # 5766
3795,7674,7675,  12,2658,  45, 976,2579,3144,4447, 517,2528,1013,1037,3209,7676,  # 5782
3796,2836,7677,3797,7678,3452,7679,2602, 614,1998,2318,3798,3087,2724,2628,7680,  # 5798
2580,4172, 599,1269,7681,1810,3669,7682,2691,3088, 759,1060, 489,1805,3351,3285,  # 5814
1358,7683,7684,2386,1387,1215,2629,2252, 490,7685,7686,4173,1759,2387,2343,7687,  # 5830
4448,3799,1907,3971,2630,1806,3210,4449,3453,3286,2760,2344, 874,7688,7689,3454,  # 5846
3670,1858,  91,2914,3671,3042,3800,4450,7690,3145,3972,2659,7691,3455,1202,1403,  # 5862
3801,2954,2529,1517,2503,4451,3456,2504,7692,4452,7693,2692,1885,1495,1731,3973,  # 5878
2365,4453,7694,2029,7695,7696,3974,2693,1216, 237,2581,4174,2319,3975,3802,4454,  # 5894
4455,2694,3560,3457, 445,4456,7697,7698,7699,7700,2761,  61,3976,3672,1822,3977,  # 5910
7701, 687,2045, 935, 925, 405,2660, 703,1096,1859,2725,4457,3978,1876,1367,2695,  # 5926
3352, 918,2105,1781,2476, 334,3287,1611,1093,4458, 564,3146,3458,3673,3353, 945,  # 5942
2631,2057,4459,7702,1925, 872,4175,7703,3459,2696,3089, 349,4176,3674,3979,4460,  # 5958
3803,4177,3675,2155,3980,4461,4462,4178,4463,2403,2046, 782,3981, 400, 251,4179,  # 5974
1624,7704,7705, 277,3676, 299,1265, 476,1191,3804,2121,4180,4181,1109, 205,7706,  # 5990
2582,1000,2156,3561,1860,7707,7708,7709,4464,7710,4465,2565, 107,2477,2157,3982,  # 6006
3460,3147,7711,1533, 541,1301, 158, 753,4182,2872,3562,7712,1696, 370,1088,4183,  # 6022
4466,3563, 579, 327, 440, 162,2240, 269,1937,1374,3461, 968,3043,  56,1396,3090,  # 6038
2106,3288,3354,7713,1926,2158,4467,2998,7714,3564,7715,7716,3677,4468,2478,7717,  # 6054
2791,7718,1650,4469,7719,2603,7720,7721,3983,2661,3355,1149,3356,3984,3805,3985,  # 6070
7722,1076,  49,7723, 951,3211,3289,3290, 450,2837, 920,7724,1811,2792,2366,4184,  # 6086
1908,1138,2367,3806,3462,7725,3212,4470,1909,1147,1518,2423,4471,3807,7726,4472,  # 6102
2388,2604, 260,1795,3213,7727,7728,3808,3291, 708,7729,3565,1704,7730,3566,1351,  # 6118
1618,3357,2999,1886, 944,4185,3358,4186,3044,3359,4187,7731,3678, 422, 413,1714,  # 6134
3292, 500,2058,2345,4188,2479,7732,1344,1910, 954,7733,1668,7734,7735,3986,2404,  # 6150
4189,3567,3809,4190,7736,2302,1318,2505,3091, 133,3092,2873,4473, 629,  31,2838,  # 6166
2697,3810,4474, 850, 949,4475,3987,2955,1732,2088,4191,1496,1852,7737,3988, 620,  # 6182
3214, 981,1242,3679,3360,1619,3680,1643,3293,2139,2452,1970,1719,3463,2168,7738,  # 6198
3215,7739,7740,3361,1828,7741,1277,4476,1565,2047,7742,1636,3568,3093,7743, 869,  # 6214
2839, 655,3811,3812,3094,3989,3000,3813,1310,3569,4477,7744,7745,7746,1733, 558,  # 6230
4478,3681, 335,1549,3045,1756,4192,3682,1945,3464,1829,1291,1192, 470,2726,2107,  # 6246
2793, 913,1054,3990,7747,1027,7748,3046,3991,4479, 982,2662,3362,3148,3465,3216,  # 6262
3217,1946,2794,7749, 571,4480,7750,1830,7751,3570,2583,1523,2424,7752,2089, 984,  # 6278
4481,3683,1959,7753,3684, 852, 923,2795,3466,3685, 969,1519, 999,2048,2320,1705,  # 6294
7754,3095, 615,1662, 151, 597,3992,2405,2321,1049, 275,4482,3686,4193, 568,3687,  # 6310
3571,2480,4194,3688,7755,2425,2270, 409,3218,7756,1566,2874,3467,1002, 769,2840,  # 6326
 194,2090,3149,3689,2222,3294,4195, 628,1505,7757,7758,1763,2177,3001,3993, 521,  # 6342
1161,2584,1787,2203,2406,4483,3994,1625,4196,4197, 412,  42,3096, 464,7759,2632,  # 6358
4484,3363,1760,1571,2875,3468,2530,1219,2204,3814,2633,2140,2368,4485,4486,3295,  # 6374
1651,3364,3572,7760,7761,3573,2481,3469,7762,3690,7763,7764,2271,2091, 460,7765,  # 6390
4487,7766,3002, 962, 588,3574, 289,3219,2634,1116,  52,7767,3047,1796,7768,7769,  # 6406
7770,1467,7771,1598,1143,3691,4198,1984,1734,1067,4488,1280,3365, 465,4489,1572,  # 6422
 510,7772,1927,2241,1812,1644,3575,7773,4490,3692,7774,7775,2663,1573,1534,7776,  # 6438
7777,4199, 536,1807,1761,3470,3815,3150,2635,7778,7779,7780,4491,3471,2915,1911,  # 6454
2796,7781,3296,1122, 377,3220,7782, 360,7783,7784,4200,1529, 551,7785,2059,3693,  # 6470
1769,2426,7786,2916,4201,3297,3097,2322,2108,2030,4492,1404, 136,1468,1479, 672,  # 6486
1171,3221,2303, 271,3151,7787,2762,7788,2049, 678,2727, 865,1947,4493,7789,2013,  # 6502
3995,2956,7790,2728,2223,1397,3048,3694,4494,4495,1735,2917,3366,3576,7791,3816,  # 6518
 509,2841,2453,2876,3817,7792,7793,3152,3153,4496,4202,2531,4497,2304,1166,1010,  # 6534
 552, 681,1887,7794,7795,2957,2958,3996,1287,1596,1861,3154, 358, 453, 736, 175,  # 6550
 478,1117, 905,1167,1097,7796,1853,1530,7797,1706,7798,2178,3472,2287,3695,3473,  # 6566
3577,4203,2092,4204,7799,3367,1193,2482,4205,1458,2190,2205,1862,1888,1421,3298,  # 6582
2918,3049,2179,3474, 595,2122,7800,3997,7801,7802,4206,1707,2636, 223,3696,1359,  # 6598
 751,3098, 183,3475,7803,2797,3003, 419,2369, 633, 704,3818,2389, 241,7804,7805,  # 6614
7806, 838,3004,3697,2272,2763,2454,3819,1938,2050,3998,1309,3099,2242,1181,7807,  # 6630
1136,2206,3820,2370,1446,4207,2305,4498,7808,7809,4208,1055,2605, 484,3698,7810,  # 6646
3999, 625,4209,2273,3368,1499,4210,4000,7811,4001,4211,3222,2274,2275,3476,7812,  # 6662
7813,2764, 808,2606,3699,3369,4002,4212,3100,2532, 526,3370,3821,4213, 955,7814,  # 6678
1620,4214,2637,2427,7815,1429,3700,1669,1831, 994, 928,7816,3578,1260,7817,7818,  # 6694
7819,1948,2288, 741,2919,1626,4215,2729,2455, 867,1184, 362,3371,1392,7820,7821,  # 6710
4003,4216,1770,1736,3223,2920,4499,4500,1928,2698,1459,1158,7822,3050,3372,2877,  # 6726
1292,1929,2506,2842,3701,1985,1187,2071,2014,2607,4217,7823,2566,2507,2169,3702,  # 6742
2483,3299,7824,3703,4501,7825,7826, 666,1003,3005,1022,3579,4218,7827,4502,1813,  # 6758
2253, 574,3822,1603, 295,1535, 705,3823,4219, 283, 858, 417,7828,7829,3224,4503,  # 6774
4504,3051,1220,1889,1046,2276,2456,4004,1393,1599, 689,2567, 388,4220,7830,2484,  # 6790
 802,7831,2798,3824,2060,1405,2254,7832,4505,3825,2109,1052,1345,3225,1585,7833,  # 6806
 809,7834,7835,7836, 575,2730,3477, 956,1552,1469,1144,2323,7837,2324,1560,2457,  # 6822
3580,3226,4005, 616,2207,3155,2180,2289,7838,1832,7839,3478,4506,7840,1319,3704,  # 6838
3705,1211,3581,1023,3227,1293,2799,7841,7842,7843,3826, 607,2306,3827, 762,2878,  # 6854
1439,4221,1360,7844,1485,3052,7845,4507,1038,4222,1450,2061,2638,4223,1379,4508,  # 6870
2585,7846,7847,4224,1352,1414,2325,2921,1172,7848,7849,3828,3829,7850,1797,1451,  # 6886
7851,7852,7853,7854,2922,4006,4007,2485,2346, 411,4008,4009,3582,3300,3101,4509,  # 6902
1561,2664,1452,4010,1375,7855,7856,  47,2959, 316,7857,1406,1591,2923,3156,7858,  # 6918
1025,2141,3102,3157, 354,2731, 884,2224,4225,2407, 508,3706, 726,3583, 996,2428,  # 6934
3584, 729,7859, 392,2191,1453,4011,4510,3707,7860,7861,2458,3585,2608,1675,2800,  # 6950
 919,2347,2960,2348,1270,4511,4012,  73,7862,7863, 647,7864,3228,2843,2255,1550,  # 6966
1346,3006,7865,1332, 883,3479,7866,7867,7868,7869,3301,2765,7870,1212, 831,1347,  # 6982
4226,4512,2326,3830,1863,3053, 720,3831,4513,4514,3832,7871,4227,7872,7873,4515,  # 6998
7874,7875,1798,4516,3708,2609,4517,3586,1645,2371,7876,7877,2924, 669,2208,2665,  # 7014
2429,7878,2879,7879,7880,1028,3229,7881,4228,2408,7882,2256,1353,7883,7884,4518,  # 7030
3158, 518,7885,4013,7886,4229,1960,7887,2142,4230,7888,7889,3007,2349,2350,3833,  # 7046
 516,1833,1454,4014,2699,4231,4519,2225,2610,1971,1129,3587,7890,2766,7891,2961,  # 7062
1422, 577,1470,3008,1524,3373,7892,7893, 432,4232,3054,3480,7894,2586,1455,2508,  # 7078
2226,1972,1175,7895,1020,2732,4015,3481,4520,7896,2733,7897,1743,1361,3055,3482,  # 7094
2639,4016,4233,4521,2290, 895, 924,4234,2170, 331,2243,3056, 166,1627,3057,1098,  # 7110
7898,1232,2880,2227,3374,4522, 657, 403,1196,2372, 542,3709,3375,1600,4235,3483,  # 7126
7899,4523,2767,3230, 576, 530,1362,7900,4524,2533,2666,3710,4017,7901, 842,3834,  # 7142
7902,2801,2031,1014,4018, 213,2700,3376, 665, 621,4236,7903,3711,2925,2430,7904,  # 7158
2431,3302,3588,3377,7905,4237,2534,4238,4525,3589,1682,4239,3484,1380,7906, 724,  # 7174
2277, 600,1670,7907,1337,1233,4526,3103,2244,7908,1621,4527,7909, 651,4240,7910,  # 7190
1612,4241,2611,7911,2844,7912,2734,2307,3058,7913, 716,2459,3059, 174,1255,2701,  # 7206
4019,3590, 548,1320,1398, 728,4020,1574,7914,1890,1197,3060,4021,7915,3061,3062,  # 7222
3712,3591,3713, 747,7916, 635,4242,4528,7917,7918,7919,4243,7920,7921,4529,7922,  # 7238
3378,4530,2432, 451,7923,3714,2535,2072,4244,2735,4245,4022,7924,1764,4531,7925,  # 7254
4246, 350,7926,2278,2390,2486,7927,4247,4023,2245,1434,4024, 488,4532, 458,4248,  # 7270
4025,3715, 771,1330,2391,3835,2568,3159,2159,2409,1553,2667,3160,4249,7928,2487,  # 7286
2881,2612,1720,2702,4250,3379,4533,7929,2536,4251,7930,3231,4252,2768,7931,2015,  # 7302
2736,7932,1155,1017,3716,3836,7933,3303,2308, 201,1864,4253,1430,7934,4026,7935,  # 7318
7936,7937,7938,7939,4254,1604,7940, 414,1865, 371,2587,4534,4535,3485,2016,3104,  # 7334
4536,1708, 960,4255, 887, 389,2171,1536,1663,1721,7941,2228,4027,2351,2926,1580,  # 7350
7942,7943,7944,1744,7945,2537,4537,4538,7946,4539,7947,2073,7948,7949,3592,3380,  # 7366
2882,4256,7950,4257,2640,3381,2802, 673,2703,2460, 709,3486,4028,3593,4258,7951,  # 7382
1148, 502, 634,7952,7953,1204,4540,3594,1575,4541,2613,3717,7954,3718,3105, 948,  # 7398
3232, 121,1745,3837,1110,7955,4259,3063,2509,3009,4029,3719,1151,1771,3838,1488,  # 7414
4030,1986,7956,2433,3487,7957,7958,2093,7959,4260,3839,1213,1407,2803, 531,2737,  # 7430
2538,3233,1011,1537,7960,2769,4261,3106,1061,7961,3720,3721,1866,2883,7962,2017,  # 7446
 120,4262,4263,2062,3595,3234,2309,3840,2668,3382,1954,4542,7963,7964,3488,1047,  # 7462
2704,1266,7965,1368,4543,2845, 649,3383,3841,2539,2738,1102,2846,2669,7966,7967,  # 7478
1999,7968,1111,3596,2962,7969,2488,3842,3597,2804,1854,3384,3722,7970,7971,3385,  # 7494
2410,2884,3304,3235,3598,7972,2569,7973,3599,2805,4031,1460, 856,7974,3600,7975,  # 7510
2885,2963,7976,2886,3843,7977,4264, 632,2510, 875,3844,1697,3845,2291,7978,7979,  # 7526
4544,3010,1239, 580,4545,4265,7980, 914, 936,2074,1190,4032,1039,2123,7981,7982,  # 7542
7983,3386,1473,7984,1354,4266,3846,7985,2172,3064,4033, 915,3305,4267,4268,3306,  # 7558
1605,1834,7986,2739, 398,3601,4269,3847,4034, 328,1912,2847,4035,3848,1331,4270,  # 7574
3011, 937,4271,7987,3602,4036,4037,3387,2160,4546,3388, 524, 742, 538,3065,1012,  # 7590
7988,7989,3849,2461,7990, 658,1103, 225,3850,7991,7992,4547,7993,4548,7994,3236,  # 7606
1243,7995,4038, 963,2246,4549,7996,2705,3603,3161,7997,7998,2588,2327,7999,4550,  # 7622
8000,8001,8002,3489,3307, 957,3389,2540,2032,1930,2927,2462, 870,2018,3604,1746,  # 7638
2770,2771,2434,2463,8003,3851,8004,3723,3107,3724,3490,3390,3725,8005,1179,3066,  # 7654
8006,3162,2373,4272,3726,2541,3163,3108,2740,4039,8007,3391,1556,2542,2292, 977,  # 7670
2887,2033,4040,1205,3392,8008,1765,3393,3164,2124,1271,1689, 714,4551,3491,8009,  # 7686
2328,3852, 533,4273,3605,2181, 617,8010,2464,3308,3492,2310,8011,8012,3165,8013,  # 7702
8014,3853,1987, 618, 427,2641,3493,3394,8015,8016,1244,1690,8017,2806,4274,4552,  # 7718
8018,3494,8019,8020,2279,1576, 473,3606,4275,3395, 972,8021,3607,8022,3067,8023,  # 7734
8024,4553,4554,8025,3727,4041,4042,8026, 153,4555, 356,8027,1891,2888,4276,2143,  # 7750
 408, 803,2352,8028,3854,8029,4277,1646,2570,2511,4556,4557,3855,8030,3856,4278,  # 7766
8031,2411,3396, 752,8032,8033,1961,2964,8034, 746,3012,2465,8035,4279,3728, 698,  # 7782
4558,1892,4280,3608,2543,4559,3609,3857,8036,3166,3397,8037,1823,1302,4043,2706,  # 7798
3858,1973,4281,8038,4282,3167, 823,1303,1288,1236,2848,3495,4044,3398, 774,3859,  # 7814
8039,1581,4560,1304,2849,3860,4561,8040,2435,2161,1083,3237,4283,4045,4284, 344,  # 7830
1173, 288,2311, 454,1683,8041,8042,1461,4562,4046,2589,8043,8044,4563, 985, 894,  # 7846
8045,3399,3168,8046,1913,2928,3729,1988,8047,2110,1974,8048,4047,8049,2571,1194,  # 7862
 425,8050,4564,3169,1245,3730,4285,8051,8052,2850,8053, 636,4565,1855,3861, 760,  # 7878
1799,8054,4286,2209,1508,4566,4048,1893,1684,2293,8055,8056,8057,4287,4288,2210,  # 7894
 479,8058,8059, 832,8060,4049,2489,8061,2965,2490,3731, 990,3109, 627,1814,2642,  # 7910
4289,1582,4290,2125,2111,3496,4567,8062, 799,4291,3170,8063,4568,2112,1737,3013,  # 7926
1018, 543, 754,4292,3309,1676,4569,4570,4050,8064,1489,8065,3497,8066,2614,2889,  # 7942
4051,8067,8068,2966,8069,8070,8071,8072,3171,4571,4572,2182,1722,8073,3238,3239,  # 7958
1842,3610,1715, 481, 365,1975,1856,8074,8075,1962,2491,4573,8076,2126,3611,3240,  # 7974
 433,1894,2063,2075,8077, 602,2741,8078,8079,8080,8081,8082,3014,1628,3400,8083,  # 7990
3172,4574,4052,2890,4575,2512,8084,2544,2772,8085,8086,8087,3310,4576,2891,8088,  # 8006
4577,8089,2851,4578,4579,1221,2967,4053,2513,8090,8091,8092,1867,1989,8093,8094,  # 8022
8095,1895,8096,8097,4580,1896,4054, 318,8098,2094,4055,4293,8099,8100, 485,8101,  # 8038
 938,3862, 553,2670, 116,8102,3863,3612,8103,3498,2671,2773,3401,3311,2807,8104,  # 8054
3613,2929,4056,1747,2930,2968,8105,8106, 207,8107,8108,2672,4581,2514,8109,3015,  # 8070
 890,3614,3864,8110,1877,3732,3402,8111,2183,2353,3403,1652,8112,8113,8114, 941,  # 8086
2294, 208,3499,4057,2019, 330,4294,3865,2892,2492,3733,4295,8115,8116,8117,8118,  # 8102
)

site-packages/pip/_vendor/chardet/langthaimodel.py000064400000026032151446177000016314 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# 255: Control characters that usually does not exist in any text
# 254: Carriage/Return
# 253: symbol (punctuation) that does not belong to word
# 252: 0 - 9

# The following result for thai was collected from a limited sample (1M).

# Character Mapping Table:
TIS620CharToOrderMap = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253,182,106,107,100,183,184,185,101, 94,186,187,108,109,110,111,  # 40
188,189,190, 89, 95,112,113,191,192,193,194,253,253,253,253,253,  # 50
253, 64, 72, 73,114, 74,115,116,102, 81,201,117, 90,103, 78, 82,  # 60
 96,202, 91, 79, 84,104,105, 97, 98, 92,203,253,253,253,253,253,  # 70
209,210,211,212,213, 88,214,215,216,217,218,219,220,118,221,222,
223,224, 99, 85, 83,225,226,227,228,229,230,231,232,233,234,235,
236,  5, 30,237, 24,238, 75,  8, 26, 52, 34, 51,119, 47, 58, 57,
 49, 53, 55, 43, 20, 19, 44, 14, 48,  3, 17, 25, 39, 62, 31, 54,
 45,  9, 16,  2, 61, 15,239, 12, 42, 46, 18, 21, 76,  4, 66, 63,
 22, 10,  1, 36, 23, 13, 40, 27, 32, 35, 86,240,241,242,243,244,
 11, 28, 41, 29, 33,245, 50, 37,  6,  7, 67, 77, 38, 93,246,247,
 68, 56, 59, 65, 69, 60, 70, 80, 71, 87,248,249,250,251,252,253,
)

# Model Table:
# total sequences: 100%
# first 512 sequences: 92.6386%
# first 1024 sequences:7.3177%
# rest  sequences:     1.0230%
# negative sequences:  0.0436%
ThaiLangModel = (
0,1,3,3,3,3,0,0,3,3,0,3,3,0,3,3,3,3,3,3,3,3,0,0,3,3,3,0,3,3,3,3,
0,3,3,0,0,0,1,3,0,3,3,2,3,3,0,1,2,3,3,3,3,0,2,0,2,0,0,3,2,1,2,2,
3,0,3,3,2,3,0,0,3,3,0,3,3,0,3,3,3,3,3,3,3,3,3,0,3,2,3,0,2,2,2,3,
0,2,3,0,0,0,0,1,0,1,2,3,1,1,3,2,2,0,1,1,0,0,1,0,0,0,0,0,0,0,1,1,
3,3,3,2,3,3,3,3,3,3,3,3,3,3,3,2,2,2,2,2,2,2,3,3,2,3,2,3,3,2,2,2,
3,1,2,3,0,3,3,2,2,1,2,3,3,1,2,0,1,3,0,1,0,0,1,0,0,0,0,0,0,0,1,1,
3,3,2,2,3,3,3,3,1,2,3,3,3,3,3,2,2,2,2,3,3,2,2,3,3,2,2,3,2,3,2,2,
3,3,1,2,3,1,2,2,3,3,1,0,2,1,0,0,3,1,2,1,0,0,1,0,0,0,0,0,0,1,0,1,
3,3,3,3,3,3,2,2,3,3,3,3,2,3,2,2,3,3,2,2,3,2,2,2,2,1,1,3,1,2,1,1,
3,2,1,0,2,1,0,1,0,1,1,0,1,1,0,0,1,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,
3,3,3,2,3,2,3,3,2,2,3,2,3,3,2,3,1,1,2,3,2,2,2,3,2,2,2,2,2,1,2,1,
2,2,1,1,3,3,2,1,0,1,2,2,0,1,3,0,0,0,1,1,0,0,0,0,0,2,3,0,0,2,1,1,
3,3,2,3,3,2,0,0,3,3,0,3,3,0,2,2,3,1,2,2,1,1,1,0,2,2,2,0,2,2,1,1,
0,2,1,0,2,0,0,2,0,1,0,0,1,0,0,0,1,1,1,1,0,0,0,0,0,0,0,0,0,0,1,0,
3,3,2,3,3,2,0,0,3,3,0,2,3,0,2,1,2,2,2,2,1,2,0,0,2,2,2,0,2,2,1,1,
0,2,1,0,2,0,0,2,0,1,1,0,1,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,
3,3,2,3,2,3,2,0,2,2,1,3,2,1,3,2,1,2,3,2,2,3,0,2,3,2,2,1,2,2,2,2,
1,2,2,0,0,0,0,2,0,1,2,0,1,1,1,0,1,0,3,1,1,0,0,0,0,0,0,0,0,0,1,0,
3,3,2,3,3,2,3,2,2,2,3,2,2,3,2,2,1,2,3,2,2,3,1,3,2,2,2,3,2,2,2,3,
3,2,1,3,0,1,1,1,0,2,1,1,1,1,1,0,1,0,1,1,0,0,0,0,0,0,0,0,0,2,0,0,
1,0,0,3,0,3,3,3,3,3,0,0,3,0,2,2,3,3,3,3,3,0,0,0,1,1,3,0,0,0,0,2,
0,0,1,0,0,0,0,0,0,0,2,3,0,0,0,3,0,2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,
2,0,3,3,3,3,0,0,2,3,0,0,3,0,3,3,2,3,3,3,3,3,0,0,3,3,3,0,0,0,3,3,
0,0,3,0,0,0,0,2,0,0,2,1,1,3,0,0,1,0,0,2,3,0,1,0,0,0,0,0,0,0,1,0,
3,3,3,3,2,3,3,3,3,3,3,3,1,2,1,3,3,2,2,1,2,2,2,3,1,1,2,0,2,1,2,1,
2,2,1,0,0,0,1,1,0,1,0,1,1,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,
3,0,2,1,2,3,3,3,0,2,0,2,2,0,2,1,3,2,2,1,2,1,0,0,2,2,1,0,2,1,2,2,
0,1,1,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,2,1,3,3,1,1,3,0,2,3,1,1,3,2,1,1,2,0,2,2,3,2,1,1,1,1,1,2,
3,0,0,1,3,1,2,1,2,0,3,0,0,0,1,0,3,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,
3,3,1,1,3,2,3,3,3,1,3,2,1,3,2,1,3,2,2,2,2,1,3,3,1,2,1,3,1,2,3,0,
2,1,1,3,2,2,2,1,2,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,
3,3,2,3,2,3,3,2,3,2,3,2,3,3,2,1,0,3,2,2,2,1,2,2,2,1,2,2,1,2,1,1,
2,2,2,3,0,1,3,1,1,1,1,0,1,1,0,2,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,2,3,2,2,1,1,3,2,3,2,3,2,0,3,2,2,1,2,0,2,2,2,1,2,2,2,2,1,
3,2,1,2,2,1,0,2,0,1,0,0,1,1,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,2,3,1,2,3,3,2,2,3,0,1,1,2,0,3,3,2,2,3,0,1,1,3,0,0,0,0,
3,1,0,3,3,0,2,0,2,1,0,0,3,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,2,3,2,3,3,0,1,3,1,1,2,1,2,1,1,3,1,1,0,2,3,1,1,1,1,1,1,1,1,
3,1,1,2,2,2,2,1,1,1,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
3,2,2,1,1,2,1,3,3,2,3,2,2,3,2,2,3,1,2,2,1,2,0,3,2,1,2,2,2,2,2,1,
3,2,1,2,2,2,1,1,1,1,0,0,1,1,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,1,3,3,0,2,1,0,3,2,0,0,3,1,0,1,1,0,1,0,0,0,0,0,1,
1,0,0,1,0,3,2,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,2,2,2,3,0,0,1,3,0,3,2,0,3,2,2,3,3,3,3,3,1,0,2,2,2,0,2,2,1,2,
0,2,3,0,0,0,0,1,0,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
3,0,2,3,1,3,3,2,3,3,0,3,3,0,3,2,2,3,2,3,3,3,0,0,2,2,3,0,1,1,1,3,
0,0,3,0,0,0,2,2,0,1,3,0,1,2,2,2,3,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,
3,2,3,3,2,0,3,3,2,2,3,1,3,2,1,3,2,0,1,2,2,0,2,3,2,1,0,3,0,0,0,0,
3,0,0,2,3,1,3,0,0,3,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,3,2,2,2,1,2,0,1,3,1,1,3,1,3,0,0,2,1,1,1,1,2,1,1,1,0,2,1,0,1,
1,2,0,0,0,3,1,1,0,0,0,0,1,0,1,0,0,1,0,1,0,0,0,0,0,3,1,0,0,0,1,0,
3,3,3,3,2,2,2,2,2,1,3,1,1,1,2,0,1,1,2,1,2,1,3,2,0,0,3,1,1,1,1,1,
3,1,0,2,3,0,0,0,3,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,2,3,0,3,3,0,2,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,2,3,1,3,0,0,1,2,0,0,2,0,3,3,2,3,3,3,2,3,0,0,2,2,2,0,0,0,2,2,
0,0,1,0,0,0,0,3,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
0,0,0,3,0,2,0,0,0,0,0,0,0,0,0,0,1,2,3,1,3,3,0,0,1,0,3,0,0,0,0,0,
0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,1,2,3,1,2,3,1,0,3,0,2,2,1,0,2,1,1,2,0,1,0,0,1,1,1,1,0,1,0,0,
1,0,0,0,0,1,1,0,3,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,2,1,0,1,1,1,3,1,2,2,2,2,2,2,1,1,1,1,0,3,1,0,1,3,1,1,1,1,
1,1,0,2,0,1,3,1,1,0,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,1,
3,0,2,2,1,3,3,2,3,3,0,1,1,0,2,2,1,2,1,3,3,1,0,0,3,2,0,0,0,0,2,1,
0,1,0,0,0,0,1,2,0,1,1,3,1,1,2,2,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
0,0,3,0,0,1,0,0,0,3,0,0,3,0,3,1,0,1,1,1,3,2,0,0,0,3,0,0,0,0,2,0,
0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,
3,3,1,3,2,1,3,3,1,2,2,0,1,2,1,0,1,2,0,0,0,0,0,3,0,0,0,3,0,0,0,0,
3,0,0,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,1,2,0,3,3,3,2,2,0,1,1,0,1,3,0,0,0,2,2,0,0,0,0,3,1,0,1,0,0,0,
0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,2,3,1,2,0,0,2,1,0,3,1,0,1,2,0,1,1,1,1,3,0,0,3,1,1,0,2,2,1,1,
0,2,0,0,0,0,0,1,0,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,0,3,1,2,0,0,2,2,0,1,2,0,1,0,1,3,1,2,1,0,0,0,2,0,3,0,0,0,1,0,
0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,1,1,2,2,0,0,0,2,0,2,1,0,1,1,0,1,1,1,2,1,0,0,1,1,1,0,2,1,1,1,
0,1,1,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,1,0,1,
0,0,0,2,0,1,3,1,1,1,1,0,0,0,0,3,2,0,1,0,0,0,1,2,0,0,0,1,0,0,0,0,
0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,3,3,3,3,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,2,3,2,2,0,0,0,1,0,0,0,0,2,3,2,1,2,2,3,0,0,0,2,3,1,0,0,0,1,1,
0,0,1,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0,
3,3,2,2,0,1,0,0,0,0,2,0,2,0,1,0,0,0,1,1,0,0,0,2,1,0,1,0,1,1,0,0,
0,1,0,2,0,0,1,0,3,0,1,0,0,0,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,1,0,0,1,0,0,0,0,0,1,1,2,0,0,0,0,1,0,0,1,3,1,0,0,0,0,1,1,0,0,
0,1,0,0,0,0,3,0,0,0,0,0,0,3,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,
3,3,1,1,1,1,2,3,0,0,2,1,1,1,1,1,0,2,1,1,0,0,0,2,1,0,1,2,1,1,0,1,
2,1,0,3,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,3,1,0,0,0,0,0,0,0,3,0,0,0,3,0,0,0,0,0,0,0,0,1,1,0,0,0,0,0,0,1,
0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,2,0,0,0,0,0,0,1,2,1,0,1,1,0,2,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,2,0,0,0,1,3,0,1,0,0,0,2,0,0,0,0,0,0,0,1,2,0,0,0,0,0,
3,3,0,0,1,1,2,0,0,1,2,1,0,1,1,1,0,1,1,0,0,2,1,1,0,1,0,0,1,1,1,0,
0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,1,0,0,0,0,1,0,0,0,0,3,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,
2,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,3,0,0,1,1,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,1,0,1,2,0,1,2,0,0,1,1,0,2,0,1,0,0,1,0,0,0,0,1,0,0,0,2,0,0,0,0,
1,0,0,1,0,1,1,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,1,0,0,0,0,0,0,0,1,1,0,1,1,0,2,1,3,0,0,0,0,1,1,0,0,0,0,0,0,0,3,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,0,1,0,1,0,0,2,0,0,2,0,0,1,1,2,0,0,1,1,0,0,0,1,0,0,0,1,1,0,0,0,
1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
1,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,1,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,0,0,0,0,2,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,1,3,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,
1,0,0,0,0,0,0,0,0,1,0,0,0,0,2,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,1,1,0,0,2,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
)

TIS620ThaiModel = {
  'char_to_order_map': TIS620CharToOrderMap,
  'precedence_matrix': ThaiLangModel,
  'typical_positive_ratio': 0.926386,
  'keep_english_letter': False,
  'charset_name': "TIS-620",
  'language': 'Thai',
}
site-packages/pip/_vendor/chardet/compat.py000064400000002156151446177000014770 0ustar00######################## BEGIN LICENSE BLOCK ########################
# Contributor(s):
#   Dan Blanchard
#   Ian Cordasco
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

import sys


if sys.version_info < (3, 0):
    PY2 = True
    PY3 = False
    base_str = (str, unicode)
    text_type = unicode
else:
    PY2 = False
    PY3 = True
    base_str = (bytes, str)
    text_type = str
site-packages/pip/_vendor/chardet/langcyrillicmodel.py000064400000043034151446177000017202 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# KOI8-R language model
# Character Mapping Table:
KOI8R_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,  # 80
207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,  # 90
223,224,225, 68,226,227,228,229,230,231,232,233,234,235,236,237,  # a0
238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,  # b0
 27,  3, 21, 28, 13,  2, 39, 19, 26,  4, 23, 11,  8, 12,  5,  1,  # c0
 15, 16,  9,  7,  6, 14, 24, 10, 17, 18, 20, 25, 30, 29, 22, 54,  # d0
 59, 37, 44, 58, 41, 48, 53, 46, 55, 42, 60, 36, 49, 38, 31, 34,  # e0
 35, 43, 45, 32, 40, 52, 56, 33, 61, 62, 51, 57, 47, 63, 50, 70,  # f0
)

win1251_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
239,240,241,242,243,244,245,246, 68,247,248,249,250,251,252,253,
 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16,
)

latin5_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16,
239, 68,240,241,242,243,244,245,246,247,248,249,250,251,252,255,
)

macCyrillic_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
239,240,241,242,243,244,245,246,247,248,249,250,251,252, 68, 16,
  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27,255,
)

IBM855_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
191,192,193,194, 68,195,196,197,198,199,200,201,202,203,204,205,
206,207,208,209,210,211,212,213,214,215,216,217, 27, 59, 54, 70,
  3, 37, 21, 44, 28, 58, 13, 41,  2, 48, 39, 53, 19, 46,218,219,
220,221,222,223,224, 26, 55,  4, 42,225,226,227,228, 23, 60,229,
230,231,232,233,234,235, 11, 36,236,237,238,239,240,241,242,243,
  8, 49, 12, 38,  5, 31,  1, 34, 15,244,245,246,247, 35, 16,248,
 43,  9, 45,  7, 32,  6, 40, 14, 52, 24, 56, 10, 33, 17, 61,249,
250, 18, 62, 20, 51, 25, 57, 30, 47, 29, 63, 22, 50,251,252,255,
)

IBM866_char_to_order_map = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253,142,143,144,145,146,147,148,149,150,151,152, 74,153, 75,154,  # 40
155,156,157,158,159,160,161,162,163,164,165,253,253,253,253,253,  # 50
253, 71,172, 66,173, 65,174, 76,175, 64,176,177, 77, 72,178, 69,  # 60
 67,179, 78, 73,180,181, 79,182,183,184,185,253,253,253,253,253,  # 70
 37, 44, 33, 46, 41, 48, 56, 51, 42, 60, 36, 49, 38, 31, 34, 35,
 45, 32, 40, 52, 53, 55, 58, 50, 57, 63, 70, 62, 61, 47, 59, 43,
  3, 21, 10, 19, 13,  2, 24, 20,  4, 23, 11,  8, 12,  5,  1, 15,
191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,
207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,
223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,
  9,  7,  6, 14, 39, 26, 28, 22, 25, 29, 54, 18, 17, 30, 27, 16,
239, 68,240,241,242,243,244,245,246,247,248,249,250,251,252,255,
)

# Model Table:
# total sequences: 100%
# first 512 sequences: 97.6601%
# first 1024 sequences: 2.3389%
# rest  sequences:      0.1237%
# negative sequences:   0.0009%
RussianLangModel = (
0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,1,3,3,3,3,1,3,3,3,2,3,2,3,3,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,2,2,2,2,2,0,0,2,
3,3,3,2,3,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,3,2,3,2,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,2,2,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,2,3,3,1,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,2,3,2,3,3,3,3,3,3,3,3,3,3,3,3,3,0,0,3,3,3,3,3,3,3,3,3,3,3,2,1,
0,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,0,0,3,3,3,3,3,3,3,3,3,3,3,2,1,
0,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,2,2,2,3,1,3,3,1,3,3,3,3,2,2,3,0,2,2,2,3,3,2,1,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,3,3,3,3,3,2,2,3,2,3,3,3,2,1,2,2,0,1,2,2,2,2,2,2,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,2,2,3,0,2,2,3,3,2,1,2,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,3,3,1,2,3,2,2,3,2,3,3,3,3,2,2,3,0,3,2,2,3,1,1,1,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,2,3,3,3,3,2,2,2,0,3,3,3,2,2,2,2,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,2,3,2,3,3,3,3,3,3,2,3,2,2,0,1,3,2,1,2,2,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,2,1,1,3,0,1,1,1,1,2,1,1,0,2,2,2,1,2,0,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,3,3,2,2,2,2,1,3,2,3,2,3,2,1,2,2,0,1,1,2,1,2,1,2,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,3,2,2,3,2,3,3,3,2,2,2,2,0,2,2,2,2,3,1,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
3,2,3,2,2,3,3,3,3,3,3,3,3,3,1,3,2,0,0,3,3,3,3,2,3,3,3,3,2,3,2,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,3,3,3,3,3,2,2,3,3,0,2,1,0,3,2,3,2,3,0,0,1,2,0,0,1,0,1,2,1,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,3,0,2,3,3,3,3,2,3,3,3,3,1,2,2,0,0,2,3,2,2,2,3,2,3,2,2,3,0,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,2,3,0,2,3,2,3,0,1,2,3,3,2,0,2,3,0,0,2,3,2,2,0,1,3,1,3,2,2,1,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,3,0,2,3,3,3,3,3,3,3,3,2,1,3,2,0,0,2,2,3,3,3,2,3,3,0,2,2,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,2,3,3,2,2,2,3,3,0,0,1,1,1,1,1,2,0,0,1,1,1,1,0,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,2,3,3,3,3,3,3,3,0,3,2,3,3,2,3,2,0,2,1,0,1,1,0,1,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,3,3,3,2,2,2,2,3,1,3,2,3,1,1,2,1,0,2,2,2,2,1,3,1,0,
0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
2,2,3,3,3,3,3,1,2,2,1,3,1,0,3,0,0,3,0,0,0,1,1,0,1,2,1,0,0,0,0,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,2,2,1,1,3,3,3,2,2,1,2,2,3,1,1,2,0,0,2,2,1,3,0,0,2,1,1,2,1,1,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,2,3,3,3,3,1,2,2,2,1,2,1,3,3,1,1,2,1,2,1,2,2,0,2,0,0,1,1,0,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,3,3,3,3,3,2,1,3,2,2,3,2,0,3,2,0,3,0,1,0,1,1,0,0,1,1,1,1,0,1,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,2,3,3,3,2,2,2,3,3,1,2,1,2,1,0,1,0,1,1,0,1,0,0,2,1,1,1,0,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
3,1,1,2,1,2,3,3,2,2,1,2,2,3,0,2,1,0,0,2,2,3,2,1,2,2,2,2,2,3,1,0,
0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,1,1,0,1,1,2,2,1,1,3,0,0,1,3,1,1,1,0,0,0,1,0,1,1,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,1,3,3,3,2,0,0,0,2,1,0,1,0,2,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,0,1,0,0,2,3,2,2,2,1,2,2,2,1,2,1,0,0,1,1,1,0,2,0,1,1,1,0,0,1,1,
1,0,0,0,0,0,1,2,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,
2,3,3,3,3,0,0,0,0,1,0,0,0,0,3,0,1,2,1,0,0,0,0,0,0,0,1,1,0,0,1,1,
1,0,1,0,1,2,0,0,1,1,2,1,0,1,1,1,1,0,1,1,1,1,0,1,0,0,1,0,0,1,1,0,
2,2,3,2,2,2,3,1,2,2,2,2,2,2,2,2,1,1,1,1,1,1,1,0,1,0,1,1,1,0,2,1,
1,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,1,1,1,0,1,0,1,1,0,1,1,1,0,1,1,0,
3,3,3,2,2,2,2,3,2,2,1,1,2,2,2,2,1,1,3,1,2,1,2,0,0,1,1,0,1,0,2,1,
1,1,1,1,1,2,1,0,1,1,1,1,0,1,0,0,1,1,0,0,1,0,1,0,0,1,0,0,0,1,1,0,
2,0,0,1,0,3,2,2,2,2,1,2,1,2,1,2,0,0,0,2,1,2,2,1,1,2,2,0,1,1,0,2,
1,1,1,1,1,0,1,1,1,2,1,1,1,2,1,0,1,2,1,1,1,1,0,1,1,1,0,0,1,0,0,1,
1,3,2,2,2,1,1,1,2,3,0,0,0,0,2,0,2,2,1,0,0,0,0,0,0,1,0,0,0,0,1,1,
1,0,1,1,0,1,0,1,1,0,1,1,0,2,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0,
2,3,2,3,2,1,2,2,2,2,1,0,0,0,2,0,0,1,1,0,0,0,0,0,0,0,1,1,0,0,2,1,
1,1,2,1,0,2,0,0,1,0,1,0,0,1,0,0,1,1,0,1,1,0,0,0,0,0,1,0,0,0,0,0,
3,0,0,1,0,2,2,2,3,2,2,2,2,2,2,2,0,0,0,2,1,2,1,1,1,2,2,0,0,0,1,2,
1,1,1,1,1,0,1,2,1,1,1,1,1,1,1,0,1,1,1,1,1,1,0,1,1,1,1,1,1,0,0,1,
2,3,2,3,3,2,0,1,1,1,0,0,1,0,2,0,1,1,3,1,0,0,0,0,0,0,0,1,0,0,2,1,
1,1,1,1,1,1,1,0,1,0,1,1,1,1,0,1,1,1,0,0,1,1,0,1,0,0,0,0,0,0,1,0,
2,3,3,3,3,1,2,2,2,2,0,1,1,0,2,1,1,1,2,1,0,1,1,0,0,1,0,1,0,0,2,0,
0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,3,3,3,2,0,0,1,1,2,2,1,0,0,2,0,1,1,3,0,0,1,0,0,0,0,0,1,0,1,2,1,
1,1,2,0,1,1,1,0,1,0,1,1,0,1,0,1,1,1,1,0,1,0,0,0,0,0,0,1,0,1,1,0,
1,3,2,3,2,1,0,0,2,2,2,0,1,0,2,0,1,1,1,0,1,0,0,0,3,0,1,1,0,0,2,1,
1,1,1,0,1,1,0,0,0,0,1,1,0,1,0,0,2,1,1,0,1,0,0,0,1,0,1,0,0,1,1,0,
3,1,2,1,1,2,2,2,2,2,2,1,2,2,1,1,0,0,0,2,2,2,0,0,0,1,2,1,0,1,0,1,
2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,2,1,1,1,0,1,0,1,1,0,1,1,1,0,0,1,
3,0,0,0,0,2,0,1,1,1,1,1,1,1,0,1,0,0,0,1,1,1,0,1,0,1,1,0,0,1,0,1,
1,1,0,0,1,0,0,0,1,0,1,1,0,0,1,0,1,0,1,0,0,0,0,1,0,0,0,1,0,0,0,1,
1,3,3,2,2,0,0,0,2,2,0,0,0,1,2,0,1,1,2,0,0,0,0,0,0,0,0,1,0,0,2,1,
0,1,1,0,0,1,1,0,0,0,1,1,0,1,1,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,1,0,
2,3,2,3,2,0,0,0,0,1,1,0,0,0,2,0,2,0,2,0,0,0,0,0,1,0,0,1,0,0,1,1,
1,1,2,0,1,2,1,0,1,1,2,1,1,1,1,1,2,1,1,0,1,0,0,1,1,1,1,1,0,1,1,0,
1,3,2,2,2,1,0,0,2,2,1,0,1,2,2,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,1,1,
0,0,1,1,0,1,1,0,0,1,1,0,1,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,1,0,2,3,1,2,2,2,2,2,2,1,1,0,0,0,1,0,1,0,2,1,1,1,0,0,0,0,1,
1,1,0,1,1,0,1,1,1,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
2,0,2,0,0,1,0,3,2,1,2,1,2,2,0,1,0,0,0,2,1,0,0,2,1,1,1,1,0,2,0,2,
2,1,1,1,1,1,1,1,1,1,1,1,1,2,1,0,1,1,1,1,0,0,0,1,1,1,1,0,1,0,0,1,
1,2,2,2,2,1,0,0,1,0,0,0,0,0,2,0,1,1,1,1,0,0,0,0,1,0,1,2,0,0,2,0,
1,0,1,1,1,2,1,0,1,0,1,1,0,0,1,0,1,1,1,0,1,0,0,0,1,0,0,1,0,1,1,0,
2,1,2,2,2,0,3,0,1,1,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
0,0,0,1,1,1,0,0,1,0,1,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,
1,2,2,3,2,2,0,0,1,1,2,0,1,2,1,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,1,
0,1,1,0,0,1,1,0,0,1,1,0,0,1,1,0,1,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0,
2,2,1,1,2,1,2,2,2,2,2,1,2,2,0,1,0,0,0,1,2,2,2,1,2,1,1,1,1,1,2,1,
1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,0,1,1,1,0,0,0,0,1,1,1,0,1,1,0,0,1,
1,2,2,2,2,0,1,0,2,2,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,
0,0,1,0,0,1,0,0,0,0,1,0,1,1,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,2,2,2,2,0,0,0,2,2,2,0,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,1,
0,1,1,0,0,1,1,0,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,2,2,2,2,0,0,0,0,1,0,0,1,1,2,0,0,0,0,1,0,1,0,0,1,0,0,2,0,0,0,1,
0,0,1,0,0,1,0,0,0,1,1,0,0,0,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
1,2,2,2,1,1,2,0,2,1,1,1,1,0,2,2,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1,1,
0,0,1,0,1,1,0,0,0,0,1,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
1,0,2,1,2,0,0,0,0,0,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,
0,0,1,0,1,1,0,0,0,0,1,0,0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,
1,0,0,0,0,2,0,1,2,1,0,1,1,1,0,1,0,0,0,1,0,1,0,0,1,0,1,0,0,0,0,1,
0,0,0,0,0,1,0,0,1,1,0,0,1,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,
2,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
1,0,0,0,1,0,0,0,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,0,1,0,0,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
1,1,1,0,1,0,1,0,0,1,1,1,1,0,0,0,1,0,0,0,0,1,0,0,0,1,0,1,0,0,0,0,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
1,1,0,1,1,0,1,0,1,0,0,0,0,1,1,0,1,1,0,0,0,0,0,1,0,1,1,0,1,0,0,0,
0,1,1,1,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,
)

Koi8rModel = {
  'char_to_order_map': KOI8R_char_to_order_map,
  'precedence_matrix': RussianLangModel,
  'typical_positive_ratio': 0.976601,
  'keep_english_letter': False,
  'charset_name': "KOI8-R",
  'language': 'Russian',
}

Win1251CyrillicModel = {
  'char_to_order_map': win1251_char_to_order_map,
  'precedence_matrix': RussianLangModel,
  'typical_positive_ratio': 0.976601,
  'keep_english_letter': False,
  'charset_name': "windows-1251",
  'language': 'Russian',
}

Latin5CyrillicModel = {
  'char_to_order_map': latin5_char_to_order_map,
  'precedence_matrix': RussianLangModel,
  'typical_positive_ratio': 0.976601,
  'keep_english_letter': False,
  'charset_name': "ISO-8859-5",
  'language': 'Russian',
}

MacCyrillicModel = {
  'char_to_order_map': macCyrillic_char_to_order_map,
  'precedence_matrix': RussianLangModel,
  'typical_positive_ratio': 0.976601,
  'keep_english_letter': False,
  'charset_name': "MacCyrillic",
  'language': 'Russian',
}

Ibm866Model = {
  'char_to_order_map': IBM866_char_to_order_map,
  'precedence_matrix': RussianLangModel,
  'typical_positive_ratio': 0.976601,
  'keep_english_letter': False,
  'charset_name': "IBM866",
  'language': 'Russian',
}

Ibm855Model = {
  'char_to_order_map': IBM855_char_to_order_map,
  'precedence_matrix': RussianLangModel,
  'typical_positive_ratio': 0.976601,
  'keep_english_letter': False,
  'charset_name': "IBM855",
  'language': 'Russian',
}
site-packages/pip/_vendor/chardet/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001455151446177000022472 0ustar00U

��.e�@s8ddlmZmZddlmZddlmZmZdd�ZdS)�)�PY2�PY3)�UniversalDetector)�__version__�VERSIONcCsHt|t�s0t|t�s(td�t|����nt|�}t�}|�|�|��S)z�
    Detect the encoding of the given byte string.

    :param byte_str:     The byte sequence to examine.
    :type byte_str:      ``bytes`` or ``bytearray``
    z4Expected object of type bytes or bytearray, got: {0})	�
isinstance�	bytearray�bytes�	TypeError�format�typerZfeed�close)Zbyte_strZdetector�r�@/usr/lib/python3.8/site-packages/pip/_vendor/chardet/__init__.py�detects

�
rN)	�compatrrZuniversaldetectorr�versionrrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/codingstatemachine.cpython-38.opt-1.pyc000064400000005471151446177000024566 0ustar00U

��.e�@s(ddlZddlmZGdd�de�ZdS)�N�)�MachineStatec@sDeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Ze	dd
��Z
dS)�CodingStateMachinea�
    A state machine to verify a byte sequence for a particular encoding. For
    each byte the detector receives, it will feed that byte to every active
    state machine available, one byte at a time. The state machine changes its
    state based on its previous state and the byte it receives. There are 3
    states in a state machine that are of interest to an auto-detector:

    START state: This is the state to start with, or a legal byte sequence
                 (i.e. a valid code point) for character has been identified.

    ME state:  This indicates that the state machine identified a byte sequence
               that is specific to the charset it is designed for and that
               there is no other possible encoding which can contain this byte
               sequence. This will to lead to an immediate positive answer for
               the detector.

    ERROR state: This indicates the state machine identified an illegal byte
                 sequence for that encoding. This will lead to an immediate
                 negative answer for this encoding. Detector will exclude this
                 encoding from consideration from here on.
    cCs0||_d|_d|_d|_t�t�|_|��dS)Nr)	�_model�_curr_byte_pos�_curr_char_len�_curr_state�loggingZ	getLogger�__name__Zlogger�reset)�selfZsm�r
�J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/codingstatemachine.py�__init__7szCodingStateMachine.__init__cCstj|_dS�N)r�STARTr�rr
r
rr?szCodingStateMachine.resetcCsh|jd|}|jtjkr0d|_|jd||_|j|jd|}|jd||_|jd7_|jS)NZclass_tablerZchar_len_tableZclass_factorZstate_tabler)rrrrrr)r�cZ
byte_classZ
curr_stater
r
r�
next_stateBs�zCodingStateMachine.next_statecCs|jSr)rrr
r
r�get_current_charlenPsz&CodingStateMachine.get_current_charlencCs
|jdS)N�name�rrr
r
r�get_coding_state_machineSsz+CodingStateMachine.get_coding_state_machinecCs
|jdS)N�languagerrr
r
rrVszCodingStateMachine.languageN)r
�
__module__�__qualname__�__doc__rrrrr�propertyrr
r
r
rr!sr)r	Zenumsr�objectrr
r
r
r�<module>ssite-packages/pip/_vendor/chardet/__pycache__/jpcntx.cpython-38.opt-1.pyc000064400000111303151446177000022233 0ustar00U

��.e�L�@s8dZGdd�de�ZGdd�de�ZGdd�de�ZdS))S)S�rr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Sr�rrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrc@sPeZdZdZdZdZdZdZdd�Zdd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
dS)�JapaneseContextAnalysis�����di�rcCs*d|_d|_d|_d|_d|_|��dS�N)�
_total_rel�_rel_sample�_need_to_skip_char_num�_last_char_order�_done�reset��self�r�>/usr/lib/python3.8/site-packages/pip/_vendor/chardet/jpcntx.py�__init__{sz JapaneseContextAnalysis.__init__cCs*d|_dg|j|_d|_d|_d|_dS)Nrr
F)r
�NUM_OF_CATEGORYrrrrrrrrr�s
zJapaneseContextAnalysis.resetcCs�|jr
dS|j}||kr�|�|||d��\}}||7}||krT|||_d|_q|dkr�|jdkr�|jd7_|j|jkr�d|_q�|jt|j|d7<||_qdS)Nrr
rT)rr�	get_orderrr
�MAX_REL_THRESHOLDr�jp2CharContext)r�byte_strZ	num_bytes�i�order�char_lenrrr�feed�s 	
zJapaneseContextAnalysis.feedcCs|j|jkSr)r
�ENOUGH_REL_THRESHOLDrrrr�got_enough_data�sz'JapaneseContextAnalysis.got_enough_datacCs,|j|jkr"|j|jd|jS|jSdS)Nr)r
�MINIMUM_DATA_THRESHOLDr�	DONT_KNOWrrrr�get_confidence�sz&JapaneseContextAnalysis.get_confidencecCsdS)N�r
rr)rrrrrr�sz!JapaneseContextAnalysis.get_orderN)�__name__�
__module__�__qualname__rr$r!rr#rrr r"r%rrrrrrtsrcs0eZdZ�fdd�Zedd��Zdd�Z�ZS)�SJISContextAnalysiscstt|���d|_dS)NZ	SHIFT_JIS)�superr*r�
_charset_namer��	__class__rrr�szSJISContextAnalysis.__init__cCs|jSr)r,rrrr�charset_name�sz SJISContextAnalysis.charset_namecCs�|sdS|d}d|kr$dks>nd|kr:dkrjnn,d}|dksbd	|kr^dkrnnqnd
|_nd}t|�dkr�|d}|dkr�d|kr�d
kr�nn|d|fSd|fS)Nr&r�����r��ZCP932r����r
)r,�len�rrZ
first_charrZsecond_charrrrr�s.  zSJISContextAnalysis.get_order)r'r(r)r�propertyr/r�
__classcell__rrr-rr*�s
r*c@seZdZdd�ZdS)�EUCJPContextAnalysiscCs�|sdS|d}|dks0d|kr,dkr6nnd}n|dkrDd}nd	}t|�d	kr�|d	}|d
kr�d|krxdkr�nn|d|fSd|fS)
Nr&r���r�rr���r
)r8r9rrrr�s  zEUCJPContextAnalysis.get_orderN)r'r(r)rrrrrr<�sr<N)r�objectrr*r<rrrr�<module>sVCsite-packages/pip/_vendor/chardet/__pycache__/langcyrillicmodel.cpython-38.pyc000064400000070603151446177000023472 0ustar00U

��.eF�@s�dZdZdZdZdZdZdZeeddd	d
d�Zeedddd
d�Zeeddd
d
d�Z	eedddd
d�Z
eedddd
d�Zeedddd
d�ZdS)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr������������J��K������������rrrrrr�G��B��A��L��@���M�H��E�C��N�I���O����rrrrr��������������������������������������������������������������������D���������������������������������������������rr�����
��'������������	�����
��������6�;�%�,�:�)�0�5�.�7�*�<�$�1�&��"�#�+�-� �(�4�8�!�=�>�3�9�/�?�2�F(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrirjrkrlrmrnrorprqr\rrrsrtrurvrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r}rrzr�r�r�r�r�r�r�rwr�(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrir�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r}rrzr�r�r�r�r�r�r�rwr�rjr\rkrlrmrnrorprqrrrsrtrurvrr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtrurvrr\r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r}rrzr�r�r�r�r�r�r�rwr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr9r:r;r<r\r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrwr�r�r�rxr�ryr�rzr�r{r�r|r�r}r�r~r�rTrUrVrWrXrYrZrr�r�r�r[r]r^r_r�r�r`rarbrcrdrerfr�r�rgrhrirjrkrlrmrnr�r�r�r�r�r�r�r�r�rorprqrrr�r�rsr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rtrur�r�r�r�r�r�r�r�r�r�r�r�rvrr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrir�r�r�r�r}rrzr�r�r�r�r�r�r�rwr�rjr\rkrlrmrnrorprqrrrsrtrurvrr(�rxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxr�r�rxrxrxrxr�rxrxrxr|rxr|rxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxr�rxr|r|r|r|r|r�r�r|rxrxrxr|rxrxrxrxrxrxrxrxrxrxr|rxrxr�r�rxrxrxrxrxrxrxrxrxr|rxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxr|r|rxrxrxrxrxrxrxrxrxr|rxrxr�r�rxrxrxrxrxrxrxrxr|rxrxr�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxr|rxrxrxrxrxrxrxrxrxrxrxrxrxr�r�rxrxrxrxrxrxrxrxrxrxrxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxrxrxrxr|rxrxr�r�rxrxrxrxrxrxrxrxrxrxrxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxr|r|r|rxr�rxrxr�rxrxrxrxr|r|rxr�r|r|r|rxrxr|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxrxrxrxr|r|rxr|rxrxrxr|r�r|r|r�r�r|r|r|r|r|r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxr|r|r|rxr�r|r|rxrxr|r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxr�r|rxr|r|rxr|rxrxrxrxr|r|rxr�rxr|r|rxr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxr|r|rxrxrxrxrxr|rxrxrxrxr|r|r|r�rxrxrxr|r|r|r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxr|rxr|rxrxrxrxrxrxr|rxr|r|r�r�rxr|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxr|r�r�rxr�r�r�r�r�r|r�r�r�r|r|r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxr|r|r|r|r�rxr|rxr|rxr|r�r|r|r�r�r�r|r�r|r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxrxr|r|rxr|rxrxrxr|r|r|r|r�r|r|r|r|rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxr|rxr|r|rxrxrxrxrxrxrxrxrxr�rxr|r�r�rxrxrxrxr|rxrxrxrxr|rxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxrxr|r|rxrxr�r|r�r�rxr|rxr|rxr�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�rxr�r|rxrxrxrxr|rxrxrxrxr�r|r|r�r�r|rxr|r|r|rxr|rxr|r|rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxr�r|rxr|rxr�r�r|rxrxr|r�r|rxr�r�r|rxr|r|r�r�rxr�rxr|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�rxr�r|rxrxrxrxrxrxrxrxr|r�rxr|r�r�r|r|rxrxrxr|rxrxr�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|r|rxrxr|r|r|rxrxr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|r|rxrxrxrxrxrxrxr�rxr|rxrxr|rxr|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxrxr|r|r|r|rxr�rxr|rxr�r�r|r�r�r|r|r|r|r�rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r|rxrxrxrxrxr�r|r|r�rxr�r�rxr�r�rxr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|r|r�r�rxrxrxr|r|r�r|r|rxr�r�r|r�r�r|r|r�rxr�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxrxrxrxr�r|r|r|r�r|r�rxrxr�r�r|r�r|r�r|r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxrxr|r�rxr|r|rxr|r�rxr|r�rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxr|rxrxrxr|r|r|rxrxr�r|r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r�r|r�r|rxrxr|r|r�r|r|rxr�r|r�r�r�r|r|rxr|r�r|r|r|r|r|rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxr�r�r�r�r�r|r|r�r�rxr�r�r�rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�rxrxrxr|r�r�r�r|r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|rxr|r|r|r�r|r|r|r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxr�r�r�r�r�r�r�r�r�rxr�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|rxr|r|r|rxr�r|r|r|r|r|r|r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxr|r|r|r|rxr|r|r�r�r|r|r|r|r�r�rxr�r|r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�rxr|r|r|r|r�r|r�r|r�r|r�r�r�r|r�r|r|r�r�r|r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|r|r|r�r�r�r|rxr�r�r�r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr|rxr|r�r|r|r|r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r�r�r�r|r|r|rxr|r|r|r|r|r|r|r�r�r�r|r�r|r�r�r�r|r|r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr|rxrxr|r�r�r�r�r�r�r�r�r|r�r�r�rxr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxr�r|r|r|r|r�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxr|r�r�r�r�r|r|r�r�r�r|r�r�r�rxr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxr|r�r�r�r|r|r|r�r�r�r|r�r�r�r�r�r�r�r�r�rxr�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r|r�r�r|r|r|r|r|r|r�r|r|r�r�r�r�r�r|r|r|r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxr|r|r�r�r�r|r|r�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr|rxr|r�r�r�r�r�r�r�r�r�r|r�r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|r|r|r�r�r�r|r|r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr�r|r|r|r|r|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r|r�r�r�r�rxr|r�r|r�r|r|r�r�r�r�r�r|r�r�r�r|r�r�r�r�r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r|r|r|r�rxr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|rxr|r|r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r�r�r|r�r|r|r|r|r|r�r|r|r�r�r�r�r�r�r|r|r|r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r|r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r|r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r�r�r|r�r|r�r�r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�gl���P@�?FzKOI8-RZRussian)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1251z
ISO-8859-5ZMacCyrillicZIBM866ZIBM855N)
ZKOI8R_char_to_order_mapZwin1251_char_to_order_mapZlatin5_char_to_order_mapZmacCyrillic_char_to_order_mapZIBM855_char_to_order_mapZIBM866_char_to_order_mapZRussianLangModelZ
Koi8rModelZWin1251CyrillicModelZLatin5CyrillicModelZMacCyrillicModelZIbm866ModelZIbm855Model�r�r��I/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langcyrillicmodel.py�<module>sb�
�
�
�
�
�site-packages/pip/_vendor/chardet/__pycache__/langhungarianmodel.cpython-38.pyc000064400000056040151446177000023633 0ustar00U

��.e01�@s4dZdZdZeeddddd�Zeeddddd�Zd	S)
(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr��(�6�-� �2�1�&�'�5�$�)�"�#�/�.�G�+�!�%�9�0�@�D�7�4rrrrrr���������	����
����C�
�����A�>��rrrrr��������������������������������������������K�����������������O���������������������������������3�Q���N���������,�������=�����������:���B�;�������<�E�?�������R��J���F�P���H����S�M�T��L�U�����I�*������8��rr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrr�rrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNr}rOr�rPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r�rarbrcrdrerfrgrhr{rjrkrlrmrnrorprqrrrsrtrurvrwrxryrzr�r|r�r~rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r`r�rr�r�r�r�r�r�ri�Vr�r��Wr�r�r�r�r�r�r�r�r�r�r�r�r�r�rr(�r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r#r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2rr2r2r2r2r2r2r2r2rrr2r2r#r#rrrrrr#rr2rrr2r2r2r2r2rr2r2r2r2r2r2r#rr2r2r2r2rr2r2r#r#r2r2r�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r2rr#r2r2r2r2r2rr2r2r2r2r2r#r#rr2r2r2r2r2r2r2r#r#r2rr�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r2r2r2r2r2r2r2r2r2r2r2r#r#rr2r2r2r#r2r2r2r2r2r#r2r2rrr�r2rr2r�r�r�r�r�r�r�r�r�r�r2r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r2r2r2r2r2r2rr2r2r2rr2r2rr2r2r2r2r2rr2r2rrr2rr2rr�r2rrr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r#r�r2r2r2r2r2r2rr2r2r2r2r2rr2r2r2r#rr2rrr2r#rr2r2rrr�r2r2r2r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r2r2r2r2r2r2r2rrr2r2r2r2r2r2rr2r2r2r2rr2r2r2r2r�rr2rr�r�r�r#r#r�r�r�r�r�r2r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r2r2r2r2r2r2r2r2r#r#r#r2r2rr#r2rrr2rr#r2rrr#r�r2r2r#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2rrr2r2r2r2r2r#rr2r2r2r2r#rr#r2r2r2r2rrr2r#r#r2rr�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r2r2r2r2r2r2r2r2rrr2r2r2r2r2rr#r2r2r2r2r2rrr#r2r2r2r�r#r#rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r#r�r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2rr2r2r2rr2r2rr2r2r2rr�r2rr2r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r#r�r2r2r2r2r2r2rr2r2r2rr2rr2r2r2r#r2rrrr2r#r#r2r2r#r#r�r2r2rr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r2r2r2r2rr2r2r2rr2rr2r2r2rr2r2r2r2r2r#rr2rrr�rrrr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2rrrr2r#r2r2rrr#r2r2r2r#r#r2r#rr2rr2rrrr#r�rrrr�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r2r#r#r2r2r2r2r2r#rr2r2r2r2r#rr#r2r2r2rrr2rr#r�r2rr�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#r#r2r2r2r2r2r#rr2r2r2r2r#r#r�r2r2r2r2r�rr2r�r�rr#r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r2r2r2r2r2rrr2r2rrrrr2r2r�r#rr2rr2rrr2rr#rr�rrrr�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r2r2r2r2r2r2r#rr2r2r2rr#rr2r2rrrr2rr2r2r#r2r2r#r#r�rr2rr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r#rrrrr2r2r2r#r#r#r2r2r#r#r2r#r#r2rr#rr2r#r#r�rrrr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2rr#rr#r#r2r2r#r#r#r#r2r2r#r#rrr#rr#r#rrr#r#r�rrr#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r#r#rr#r#r2r2r#r�r#r#r2r2rr�r#r#rr2r#r�rrr#r�r�r#r2rr�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2rr#r2r2r2r2r2r#rr2rr2r2rr#r#r2rr2rr#rrr�r#rr#r�r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r2r2r2r2rrrrr2r#rrr#r#r2r2r�r2rr#rr2rr#r2r2r#r#r�rr#r2r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2rrrr2rr2r2r2rr#r#r2r2r#r#r#rrr2rr2rrrr#r�rrr#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r#r�r�r2r2r2r2r2r�r�r2r2rr2r�r�r�rr2r2r#r�r#rr�r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#rr2r2r2r2r2r#rr2r2rrr#r#r�r2r2rrr#rrr#r�rrr�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r2rrr#r2r#rr2r2rrr#r#rrr#r#r#r#r2rr#r#r#r#rr#r�r#rr#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r#r�r�r�r�r�r�r�r�r�rr2r2r#r#r#r#r#r2r2r2r�r#r#r2r2r#r#r#r#r#rrr�r2r#r#rr�rr#r#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r#r�r#rr#rrr�r#rr2r#rr�r�r�rr#r#r#r#r#rr�r�r#r#r�r�r�r�r#rr#rrrr#rr#rr�rr�rrr#r#rr#r#rr#r#r#r�r#r�r�r�r#r#r�r#r#r#rr2rr2r2r�r#rrr2r#r�r#r�rr#rrr�r#r#r�r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r2r2rrr#r�r�r2rr2rr�r�r�r#r#r2r�r�r#r#r�r�rr#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#r#rrr2r2r#r�r#r2rr2r#r#r#r�r#r#r#r#r#r2r#r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#r#r#rrrr#r�r#rr2r2rr�r�r�rr#r#r#rr#r#r#r�r#r#r#r�r�r�r#rrrrrr#r#r#rr�rr#r#r#r#r#rr#r#r#r#r#r#r�r#r#r#r�r�r#r#r2rrr#r�r�r#r#rrr�r2r�r#rr#r#r�r�r#r#r#r�r#r#r#r#r�rr#r#r#rrr#r#r#rr#rr#r#r#r#r#r#r#rr#r#r#rr2r#r#r#r#r#r#r#r#r#r�r#rr2r2r�r#r�r�r�r2r2r#r�r�r#rrr#r�r�r�r�rr�r�r#r#r#r�rr#r#r#rr#r#r#r#r#r#rr#r#r�r#r#r�r#r#r#r�r#rr#r#r�r#r#r#r#r#r#r#r�r#rr2r2r�r#r�r�r�rrr�r�r�r�r#rrr�r�r�r�r#r�r�r#r#r�r�rr�r#r�rr#r#r#r#rr#r#r#r#r#r#r#rr#r#r#r#r#r#r#r#r#rr�r#r#r#r#r#r�r#r2rrr�r#r�r#r�rr2rr�r�r#rrr#r�r�r#r#r#r�r�rr#r�r#rrr#r#rr#r#r#r#r#r#rr#r#r#r#r#r#r�rr#r�r#r#r�r#r#r#r�r#r#rr#r#r�r#rrrr�r�r#r�r�rrr#r#r�r�rr#r#r�r�r�r#rr�r�rr#r�r�rr#r#r#rr#r#r#r#rr#rr#r#r#rrr#r#rr#r#r#rr#r#r#r#r#r#r#r#r#r#r�r#r#rr2r�r�r�r#r�r2rr#r�r�r#rr#r#r�r�r�r�rr#r�r#r#r�r�rr#rr#r#r#r�r�r�r#r�r#r#r#r#r#rr�r�r#r�r�r�rr�r�r#r#r#r#r#r#r#r#r�r#r2r�r�rr#rrr#r�r�rr#rrr�r�r�rr#r#r#r�r#r#r�r�r#r#rr�r�r�r#rr#rrr#r#rr#rr�r#r#r#r#r#r#r#r#r#rr#r#r�r�r#r#r#r#r�r�r#r#r2rr�r�r�r#r�rrrr�r�r�rrr#r�r�r�r�r2r#r#r#r#r�r�rr#r#r#rr#r�r#r#r#r�r#r#r#r#r#r#r#r�rr#r�r�r#r�r#r#r�r#r#r#r#r#r#r�r#rr2rr�r�r�r#r�rrr�r�r�r�rr#r#r�r�r�r�rr#r�r#r#r�r�rr#r#r�rr#r#r#r#rr#rr#rr�r#r#r#r�rr#r#r#rr#r#r#r#r�r#r#r#r#r#r�r#r2r#r#rrrr2rr#r#rrr#r#r�r#r�rrr#r#r#r#r#r�r�r#r#r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrr�r�r�r�r�rrr�r�r�r�rrr#r�r�r�r#r#r�r�r#rr�r�rr#r#r#rrr#r#r#rr#rr#r#r�r#r#r#r#rr#r#r#rr#r#r#r#r�r#rr#r#r#r�r#r#r�r�r#rr2rr#r�r�rr�r#r#r�r�r�r#r#r#r#r�r#r#r�r�r#r�r�r�r�r�r#rr#rr#rr#r#r#rr�rr#r#r#r�r#rr�r�r#r#r#r�r�r�r�r�r�r�r�r�rr2rr�r�r�r�r�r#r#rr#r�r�r#r#r#r�r�r�r�rr�r�r#r#r�r�rr#r#r#rr#r#r#r#r#r#rr#r�r#r#r#r#r�rr#r#r#r#r#r#r�r#r�r#r#r#r#r#r�r#r#rrr�r#r#r#r�rrrr�r�r�r2rr#r�r�r�r#r#r�r�r#r#r�r#r#r#r�r�r#r#r�r#r#r#r#r#r#r#r#rr#r#r#r#r#r#r#rr#r#r#r�r�r#r#r#r�r#r�r#rr#r�rr#r#rrr#r#rr#r#r#r�r�r�r#r#r�r#r#r#r#r�r�r#r#r#r�r�r�r#rrrrrr#r#r#rr�rr#r#r#r#r#r#r#r#r#r#r#r#r�r#r#r�r�r�r#r�r#rr2r�r�r�r#r�rrr�r�r�r�rrr�r�r�r�r�r#r�r�r#r�r�r�rr�r#r�rr#r#r#r#r#r�rr�r�r�r#rr#r#r#r#r�r#rr�r#r�r#r�r#r#r#r�r#r�r#rrrr�r�r�r#r�rr#rr�r�r�r#r#rr�r�r�r�r#r�r�r#r#r�r�rr#r�r#rr#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#rr�r#r#r#r#r#r�r#r#rrr�r�r�r#r�rrrr�r�r�r#r#r�r�r�r�r�r#r#r�rr�r�r#r#r#r�r#r#r�r#r#r#r#r#r#r�r#r#r#r#r�r�r#r�r�r#r#r�r#r�r#r#r#r#r#r�r�r�r#r#r�r�r#r�r#rr#r�r�r#r#r#rr�r�r�r#r#r�r#r�r#r#r�r�r#r�r�r�r�r�r�rr#rr#r#r#r#r#rr�rr�r#r#r�r#rr#r�r#r#r#r�r�r�r�r�r�r#r�r�rr#r#r�r#rr�r�r#r#r#r�r�r�r#r#r�r�r�r�r�r#r�r�r#r�r�r�rr#r�r#rrr#r#r#r#r#rr#r#r�r#r#r#r#rr#r#r#rr#r#r�r#r�r#r#r#r#r#r�r#r#rrr�r�r�r�r�r#r#r�r�r�r�rr#r�r�r�r�r�rr�r�rrr�r�rr�r�r#rr#r#r#r#r#r#r#r�r#r#r�r#r#r�r#r�r�r�r#r#r#r#r�r�r#r#r#r#r�r�r#r#r#rr�r�r2r#r�rr#r#r#r�r�r#r#r#r�r�r�r#r#r�r�r�r#r�r�r#r�r#r�r#rr#r�r#r#r#rr#r#r�r#r#r#r#r#r�r�r�r#r#r#r#r#r�r#r�r�r�r#r�r�rr#r#r�r�r�r�r�r#r�r�r�r�r�r�r�r�r#r�r#r�r�r�r#r�r�r�r�rr�r�r�rr#r#r#r#r#r#r#r#r#r�r#r#r#r#r#r#r#r#r#rr#r#r�r�r#r#r#r#r#r�r#rr#r#r#rr#r#r#r�r#r#rr#r�r�r�r�r#r#r#r#r�r#r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r#r�r#r#r#r#r#r�r�r#r#rr#r�r�r�r#r#r�r�r�r#r#r�r�r#r�r#r�r�r�r#rr#r#r#r#r#r#r#r#r�r#r�r#r#r#r#r#r#r�r#r#r#r�r�r�r�r�r�r#r�r�rr�r�r�r#r#r#r#r�r�r#r#r�r�r�r�r�r#r#r#rr�r�r#r�r�r#r�r#r�r�r�r�r#r#r#r#r#r#r#r#rr�r#r#r#r#r�r#r#r#r�r#r#r#r�r�r�r�r�r�r�r�r�r#r�r�r#r#r#r#r#r�r�rr#r�r#r�r�r�r#r�r#r�r�r�r�r�r�r#r�r�r�r�r�r�r#r#r#r#r#r#r�r#r#r�r#r�r#r#r�r#r#r�r�r#r#r#r�r�r�r�r�r�r�r�r�r#r�r�r#r#r#r�r�r�r�r#r�rr�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r#r#r#r#r#r�r�r#r#r�r#r�r#r�r�r#r#r#r�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r#r#rr#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r#r#r�r#r�r�r#r#r�r#r�r#r#r�r#r#r#r�r#r#r#r�r�r�r�r�r�r�r�r�rr#r#r#r#r#r#r#r#r#r#r�r�r#r#r#r�r�r#r�r�r#r�r#r�r#r#r#r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r#r#r#r#r�r�r�r#r#r#r�r�r�r�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r#r#r#r#r#r�r#r#r�r#r�r#r�r�r#r#r�r�r#r#r�r�r�r�r�r�r�r�r�r�g��(��P�?Tz
ISO-8859-2Z	Hungarian)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1250N)ZLatin2_HungarianCharToOrderMapZwin1250HungarianCharToOrderMapZHungarianLangModelZLatin2HungarianModelZWin1250HungarianModel�r�r��J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langhungarianmodel.py�<module>"s"�
�site-packages/pip/_vendor/chardet/__pycache__/utf8prober.cpython-38.pyc000064400000003643151446177000022075 0ustar00U

��.e�
�@sHddlmZddlmZmZddlmZddlmZGdd�de�Z	dS)�)�
CharSetProber)�ProbingState�MachineState)�CodingStateMachine)�
UTF8_SM_MODELcsTeZdZdZ�fdd�Z�fdd�Zedd��Zedd	��Zd
d�Z	dd
�Z
�ZS)�
UTF8Proberg�?cs*tt|���tt�|_d|_|��dS)N)�superr�__init__rr�	coding_sm�
_num_mb_chars�reset��self��	__class__��B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/utf8prober.pyr	&s
zUTF8Prober.__init__cs"tt|���|j��d|_dS)N�)rrrr
rr
rrrr,s
zUTF8Prober.resetcCsdS)Nzutf-8rr
rrr�charset_name1szUTF8Prober.charset_namecCsdS)N�rr
rrr�language5szUTF8Prober.languagecCs�|D]f}|j�|�}|tjkr,tj|_qlq|tjkrDtj|_qlq|tj	kr|j�
�dkr|jd7_q|jtj
kr�|��|jkr�tj|_|jS)N�r)r
Z
next_staterZERRORrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenr�stateZ	DETECTING�get_confidenceZSHORTCUT_THRESHOLD)rZbyte_str�cZcoding_staterrr�feed9s


zUTF8Prober.feedcCs.d}|jdkr&||j|j9}d|S|SdS)Ng�G�z��?�g�?)r�
ONE_CHAR_PROB)rZunlikerrrrLs

zUTF8Prober.get_confidence)�__name__�
__module__�__qualname__rr	r�propertyrrrr�
__classcell__rrrrr#s

rN)
Z
charsetproberrZenumsrrZcodingstatemachinerZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/compat.cpython-38.pyc000064400000000476151446177000021261 0ustar00U

��.en�@s@ddlZejdkr(dZdZeefZeZndZdZeefZeZdS)�N)�rTF)	�sys�version_infoZPY2ZPY3�strZunicodeZbase_strZ	text_type�bytes�rr�>/usr/lib/python3.8/site-packages/pip/_vendor/chardet/compat.py�<module>s
site-packages/pip/_vendor/chardet/__pycache__/enums.cpython-38.opt-1.pyc000064400000005063151446177000022061 0ustar00U

��.e}�@shdZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGd	d
�d
e�ZGdd�de�Zd
S)zr
All of the Enums that are used throughout the chardet package.

:author: Dan Blanchard (dan.blanchard@gmail.com)
c@seZdZdZdZdZdZdS)�
InputStatezS
    This enum represents the different states a universal detector can be in.
    ���N)�__name__�
__module__�__qualname__�__doc__Z
PURE_ASCIIZ	ESC_ASCIIZ	HIGH_BYTE�r	r	�=/usr/lib/python3.8/site-packages/pip/_vendor/chardet/enums.pyrsrc@s<eZdZdZdZdZdZdZdZdZ	eeBZ
e
eBeBZdS)	�LanguageFilterzj
    This enum represents the different language filters we can apply to a
    ``UniversalDetector``.
    rr����N)rrrrZCHINESE_SIMPLIFIEDZCHINESE_TRADITIONALZJAPANESEZKOREANZNON_CJKZALLZCHINESEZCJKr	r	r	r
rsrc@seZdZdZdZdZdZdS)�ProbingStatezG
    This enum represents the different states a prober can be in.
    rrrN)rrrrZ	DETECTINGZFOUND_ITZNOT_MEr	r	r	r
r src@seZdZdZdZdZdZdS)�MachineStatezN
    This enum represents the different states a state machine can be in.
    rrrN)rrrrZSTARTZERRORZITS_MEr	r	r	r
r)src@s,eZdZdZdZdZdZdZedd��Z	dS)	�SequenceLikelihoodzX
    This enum represents the likelihood of a character following the previous one.
    rrr�cCsdS)z::returns: The number of likelihood categories in the enum.rr	)�clsr	r	r
�get_num_categories;sz%SequenceLikelihood.get_num_categoriesN)
rrrrZNEGATIVEZUNLIKELYZLIKELYZPOSITIVE�classmethodrr	r	r	r
r2src@s$eZdZdZdZdZdZdZdZdS)�CharacterCategoryz�
    This enum represents the different categories language models for
    ``SingleByteCharsetProber`` put characters into.

    Anything less than CONTROL is considered a letter.
    �����N)	rrrrZ	UNDEFINEDZ
LINE_BREAKZSYMBOLZDIGITZCONTROLr	r	r	r
rAsrN)r�objectrrrrrrr	r	r	r
�<module>s			site-packages/pip/_vendor/chardet/__pycache__/latin1prober.cpython-38.opt-1.pyc000064400000006446151446177000023342 0ustar00U

��.e��@s^ddlmZddlmZdZdZdZdZdZdZ	dZ
dZd	Zd
Z
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
ee
ee
eeeeeeeeeeeeeeeee
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee	e	e	e	e	e	e
e
e	e	e	e	e	e	e	e	e
e
e	e	e	e	e	ee	e	e	e	e	e
e
e
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee�fZdZGdd
�d
e�ZdS)�)�
CharSetProber)�ProbingState��������)@rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrcsLeZdZ�fdd�Zdd�Zedd��Zedd��Zd	d
�Zdd�Z	�Z
S)
�Latin1Probercs&tt|���d|_d|_|��dS)N)�superr�__init__�_last_char_class�
_freq_counter�reset��self��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/latin1prober.pyraszLatin1Prober.__init__cCs t|_dgt|_t�|�dS)Nr)�OTHr�FREQ_CAT_NUMrrrrrrrrgszLatin1Prober.resetcCsdS)Nz
ISO-8859-1rrrrr�charset_namelszLatin1Prober.charset_namecCsdS)N�rrrrr�languagepszLatin1Prober.languagecCs`|�|�}|D]J}t|}t|jt|}|dkr@tj|_qZ|j|d7<||_q|j	S)Nrr)
Zfilter_with_english_letters�Latin1_CharToClass�Latin1ClassModelr�	CLASS_NUMr�NOT_MEZ_stater�state)rZbyte_str�cZ
char_classZfreqrrr�feedts

�zLatin1Prober.feedcCs\|jtjkrdSt|j�}|dkr(d}n|jd|jdd|}|dkrPd}|d}|S)Ng{�G�z�?grrg4@g\��(\�?)r!rr �sumr)rZtotalZ
confidencerrr�get_confidence�s
�zLatin1Prober.get_confidence)�__name__�
__module__�__qualname__rr�propertyrrr#r%�
__classcell__rrrrr`s

rN)Z
charsetproberrZenumsrrZUDFrZASCZASSZACVZACOZASVZASOrrrrrrrr�<module>s�'
site-packages/pip/_vendor/chardet/__pycache__/langhebrewmodel.cpython-38.opt-1.pyc000064400000053244151446177000024075 0ustar00U

��.eQ,�@sdZdZeeddddd�ZdS)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr�E�[�O�P�\�Y�a�Z�D�o�p�R�I�_�U�N�y�V�G�C�f�k�T�r�g�srrrrrr�2�J�<�=�*�L�F�@�5�i�]�8�A�6�1�B�n�3�+�,�?�Q�M�b�K�lrrrrr�|���������(�:���������������������S�4�/�.�H� �^���q���m���������"�t���v�d�����u�w�h�}�����W�c���j�z�{���7�����e�����x���0�'�9����;�)�X�!�%�$���#���>����~�����&�-��������������������	������������������
�������
��r��`r(�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�gC��|�?Fzwindows-1255ZHebrew)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguageN)ZWIN1255_CHAR_TO_ORDER_MAPZHEBREW_LANG_MODELZWin1255HebrewModel�r�r��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langhebrewmodel.py�<module>%s�site-packages/pip/_vendor/chardet/__pycache__/eucjpprober.cpython-38.pyc000064400000004556151446177000022321 0ustar00U

��.e��@s`ddlmZmZddlmZddlmZddlmZddl	m
Z
ddlmZGdd�de�Z
d	S)
�)�ProbingState�MachineState)�MultiByteCharSetProber)�CodingStateMachine)�EUCJPDistributionAnalysis)�EUCJPContextAnalysis)�EUCJP_SM_MODELcsPeZdZ�fdd�Z�fdd�Zedd��Zedd��Zd	d
�Zdd�Z	�Z
S)
�EUCJPProbercs4tt|���tt�|_t�|_t�|_	|�
�dS�N)�superr	�__init__rr�	coding_smr�distribution_analyzerr�context_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/eucjpprober.pyr%s

zEUCJPProber.__init__cstt|���|j��dSr
)rr	rrrrrrr,szEUCJPProber.resetcCsdS)NzEUC-JPrrrrr�charset_name0szEUCJPProber.charset_namecCsdS)NZJapaneserrrrr�language4szEUCJPProber.languagecCs6tt|��D]�}|j�||�}|tjkrN|j�d|j|j	|�t
j|_q�q|tj
krft
j|_q�q|tjkr|j��}|dkr�|d|jd<|j�|j|�|j�|j|�q|j�||d|d�|�|j�||d|d�|�q|d|jd<|jt
jk�r0|j���r0|��|jk�r0t
j|_|jS)Nz!%s %s prober hit error at byte %s�r���)�range�lenr
Z
next_staterZERRORZlogger�debugrrrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenZ
_last_charr�feedr�stateZ	DETECTINGZgot_enough_data�get_confidenceZSHORTCUT_THRESHOLD)rZbyte_str�iZcoding_stateZchar_lenrrrr8s@
�


���zEUCJPProber.feedcCs|j��}|j��}t||�Sr
)rr r�max)rZcontext_confZdistrib_confrrrr Ys

zEUCJPProber.get_confidence)�__name__�
__module__�__qualname__rr�propertyrrrr �
__classcell__rrrrr	$s

!r	N)ZenumsrrZmbcharsetproberrZcodingstatemachinerZchardistributionrZjpcntxrZmbcssmrr	rrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/cp949prober.cpython-38.opt-1.pyc000064400000002120151446177000023003 0ustar00U

��.e?�@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�EUCKRDistributionAnalysis)�CodingStateMachine)�MultiByteCharSetProber)�CP949_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�CP949Probercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/cp949prober.pyr#s
zCP949Prober.__init__cCsdS)NZCP949rr
rrr�charset_name+szCP949Prober.charset_namecCsdS)NZKoreanrr
rrr�language/szCP949Prober.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr"s

rN)	ZchardistributionrZcodingstatemachinerZmbcharsetproberrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/charsetprober.cpython-38.pyc000064400000006566151446177000022647 0ustar00U

��.e��@s0ddlZddlZddlmZGdd�de�ZdS)�N�)�ProbingStatec@sneZdZdZddd�Zdd�Zedd��Zd	d
�Zedd��Z	d
d�Z
edd��Zedd��Z
edd��ZdS)�
CharSetProbergffffff�?NcCsd|_||_t�t�|_dS�N)�_state�lang_filter�loggingZ	getLogger�__name__Zlogger)�selfr�r�E/usr/lib/python3.8/site-packages/pip/_vendor/chardet/charsetprober.py�__init__'szCharSetProber.__init__cCstj|_dSr)rZ	DETECTINGr�r
rrr�reset,szCharSetProber.resetcCsdSrrrrrr�charset_name/szCharSetProber.charset_namecCsdSrr)r
�bufrrr�feed3szCharSetProber.feedcCs|jSr)rrrrr�state6szCharSetProber.statecCsdS)Ngrrrrr�get_confidence:szCharSetProber.get_confidencecCst�dd|�}|S)Ns([-])+� )�re�sub)rrrr�filter_high_byte_only=sz#CharSetProber.filter_high_byte_onlycCs\t�}t�d|�}|D]@}|�|dd��|dd�}|��sL|dkrLd}|�|�q|S)u9
        We define three types of bytes:
        alphabet: english alphabets [a-zA-Z]
        international: international characters [€-ÿ]
        marker: everything else [^a-zA-Z€-ÿ]

        The input buffer can be thought to contain a series of words delimited
        by markers. This function works to filter all words that contain at
        least one international character. All contiguous sequences of markers
        are replaced by a single space ascii character.

        This filter applies to all scripts which do not use English characters.
        s%[a-zA-Z]*[�-�]+[a-zA-Z]*[^a-zA-Z�-�]?N�����r)�	bytearrayr�findall�extend�isalpha)r�filteredZwordsZwordZ	last_charrrr�filter_international_wordsBs�z(CharSetProber.filter_international_wordscCs�t�}d}d}tt|��D]n}|||d�}|dkr<d}n|dkrHd}|dkr|��s||kr�|s�|�|||��|�d�|d}q|s�|�||d	��|S)
a�
        Returns a copy of ``buf`` that retains only the sequences of English
        alphabet and high byte characters that are not between <> characters.
        Also retains English alphabet and high byte characters immediately
        before occurrences of >.

        This filter can be applied to all scripts which contain both English
        characters and extended ASCII characters, but is currently only used by
        ``Latin1Prober``.
        Frr�>�<TrrN)r�range�lenrr)rrZin_tag�prevZcurrZbuf_charrrr�filter_with_english_lettersgs"

z)CharSetProber.filter_with_english_letters)N)r	�
__module__�__qualname__ZSHORTCUT_THRESHOLDr
r�propertyrrrr�staticmethodrr r&rrrrr#s




$r)rrZenumsr�objectrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/langgreekmodel.cpython-38.pyc000064400000056001151446177000022751 0ustar00U

��.e�1�@s4dZdZdZeeddddd�Zeeddddd�Zd	S)
(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr�R�d�h�^�b�e�t�f�o��u�\�X�q�U�O�v�i�S�C�r�w�_�c�m�rrrrrr�H�F�P�Q�<�`�]�Y�D�x�a�M�V�E�7�N�s�A�B�:�L�j�g�W�k�prrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr���Zrrrrrrrrrr�Jrrrrrr���=�$�.�G�Ir�6r�l�{�n��3�+�)�"�[�(�4�/�,�5�&�1�;�'�#�0��%�!�-�8�2�T�9r(�y�����|������ �
�����
����	��������*��@�K���r(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr9r>rrrrrrrrrrr;rrrrrrr<rrr?r@rArBrrCrrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r(r`rarbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtrurvrwrxryrzr{r|r}r~rr�r�r�r�r(�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjryryrjrjrjrjrjrjrjrjrfrjrjrjr�ryryrjrjr�rjr�rjryr�rjrjrjr�rjr�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjr�rjrjr�rjryrjrjr�rjryrjrjrjr�r�rjr�rjr�rjrjryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�ryrjryryrjrjrjrjrjrjrjrjr�rjrjrjrjr�ryrjrjr�rjrjrjrjryrjrjrjr�ryr�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrjrjryrjrjrjrjrjrjrjrjrjrjrjrjr�ryrfrjrjrjrjryrjrjryrjrjryr�r�r�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjr�rjrjrjrjrjrjr�rjrjr�rjrjrjrjrjrjrjrjrjrjr�rjryrjrjr�ryr�rfr�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�rjrjrjrjrjryrjr�r�r�r�rjrjr�rjrfrjrjrjr�rjrjr�rjrjrjrjr�r�r�r�ryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjr�rjr�rjrjrjrjrjr�rjryryryrjr�ryrjrjrjrjrjryrjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjrjryryryrjrjrjrjr�rjrfrjrjrjrjryrjrjrjrjrjrjrjryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjryr�rjr�r�r�rjrjryrjrjrjrjrjr�r�rjryrjr�ryrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjrjr�r�rjrjr�ryrjr�rjr�rjrjrjr�r�rjr�rjr�ryryrjrjr�r�r�r�rfr�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjryr�rjryrjrjrjrjr�rjrjrjrjrjr�rjrjryrjryrjrjryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjryrjryrjrjrjrjrjrjr�ryrjryrjryryryrjryrjrjryrjr�ryryryrjr�ryr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�r�rjrjrjryrjrjr�r�rjr�rjr�r�r�rjryr�rjr�rjr�r�ryr�ryr�r�r�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjr�rjrjrjrjrjrjr�rjrjr�rjr�r�r�rjrjr�rjrjrjr�r�rfryrjr�rjr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjryr�r�rjryryrjrjr�rjrjrjrjrjryrfrjr�rjryrjrjryrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjr�ryrjrjrjrjrjrjr�r�rjr�rjr�r�r�rjrjr�rjryrjr�r�rjrjrjr�rjr�r�r�ryr�r�r�r�r�rjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjr�rjrjrjrjrjrjr�r�rjr�rjr�r�r�rjryr�rjryrjr�r�rjryrjr�ryr�r�r�r�r�r�r�r�r�rjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrfryryrjrjrjrjrjrjr�ryrjr�rjr�r�r�rjrjr�rjr�ryr�r�ryrjrfr�ryr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjrjr�rjr�rjrjryrjr�rjrjrjrjrjrjr�rjrjrjr�ryrjr�r�rjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjr�r�rjr�r�r�rjrjr�rjr�ryrjrjr�r�rjr�rjr�rjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�r�rjrjrjrjrjrjr�r�rjr�ryr�r�r�rjrjr�rjr�rjr�r�ryr�ryr�r�r�r�r�rfr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjrjr�rjr�ryr�rjryr�rjryrjryrjr�r�rjryrjryrjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�ryrjrjrjrjrjr�r�r�rjr�ryrfr�r�rjryryryr�rjr�r�ryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjryr�rjr�rjr�rjrjr�ryrfryrjrjr�r�rjr�rjr�rjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrjrjrjr�rjrjrjrjrjrjr�ryrjr�rjr�r�r�ryrfr�ryryrjr�r�ryryryr�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�ryrjrjrjryrjr�r�rfrjr�ryr�r�r�r�rjr�rfr�ryr�r�rfrfrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjrfr�rjr�r�r�rjryr�rjryrjrjrjr�r�rjr�rjryryryrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjr�r�rjr�r�r�r�ryr�ryrjrjryryryryrjr�ryr�ryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjryr�r�r�r�r�r�ryrjr�ryr�ryrjryr�r�rjr�rjr�rjrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjryrjrjryryrjr�ryr�rjr�r�r�ryr�r�r�r�rfryr�ryr�ryr�r�ryr�ryr�ryryr�r�rfr�ryryryr�ryryryr�ryryryr�r�ryr�r�rfr�r�r�r�r�ryr�rjrjryr�r�r�r�r�r�rfrjr�ryr�ryryryr�r�ryr�rjr�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�ryrjryr�ryryr�ryr�ryryr�ryr�ryryryr�r�r�r�r�r�ryrjr�r�r�ryr�rfryr�r�r�r�ryryr�r�r�ryrfr�ryryr�r�r�r�r�r�rfr�ryr�r�r�r�r�r�r�r�ryrfr�ryrjryryrjryrjryr�r�rjrjrjr�r�rjryr�r�r�rfrfr�ryr�ryryr�ryr�ryr�ryryr�r�ryr�ryryryr�ryryryryr�r�ryr�r�r�ryr�rfr�r�r�r�r�rjr�rjrjryryr�rjr�r�r�ryryr�ryryryrfryr�r�rfryryr�r�rjr�r�r�ryr�rfryr�r�r�rfryr�r�r�r�r�r�r�ryryr�rfr�r�ryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrjrjryryr�r�r�ryr�ryrjrjr�ryr�r�r�r�r�r�ryryryr�ryryr�ryr�ryr�ryryr�r�ryryryryrfr�r�ryryr�ryr�r�ryr�r�r�r�r�r�ryr�r�r�r�r�r�r�ryr�rjryrjr�r�r�rjr�r�ryryr�ryr�ryryryr�r�ryr�r�r�r�r�r�r�r�ryr�r�ryryr�r�ryryryr�r�r�r�r�r�ryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�rjryr�ryryryryryr�r�r�ryr�r�r�r�ryr�rfr�r�ryr�rfr�r�r�r�ryryryr�ryryr�rfryr�ryryryr�ryryryryrfryryr�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�ryr�ryr�ryryr�r�r�r�rfryrfr�r�ryryr�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�rjryrjr�r�ryr�r�r�ryryr�ryr�r�r�rfr�r�ryr�ryr�ryryr�r�r�r�r�r�ryr�r�r�r�ryryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�ryryrjryryr�r�r�r�r�r�rfrjr�ryr�ryryr�r�r�rfr�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�ryr�rjryr�ryr�r�r�r�r�r�ryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�ryr�r�r�r�rfrfr�r�ryrfryr�ryryr�rfr�r�rfr�r�r�ryr�r�r�r�r�r�r�rjr�ryryryr�r�ryr�r�r�ryr�r�r�ryrjr�ryr�r�r�r�r�r�ryryr�r�r�ryr�rfryr�r�r�rfryryrfr�r�r�ryr�r�ryr�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrfryr�ryryr�ryr�r�ryr�r�r�r�rfryrfr�ryrfr�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�rjrfryryr�ryr�r�r�r�ryr�r�r�ryr�r�rjr�r�r�r�ryryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrfr�ryr�rfryr�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�rfr�r�r�r�r�r�ryr�ryryr�r�ryryryryryr�rfryr�r�r�ryryr�rfr�ryr�r�ryryr�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�rjr�r�ryr�r�r�r�r�r�r�r�ryr�ryr�r�r�r�ryr�rfryr�r�r�r�ryryrfr�rfr�rfr�ryryryrfr�r�r�r�r�r�rfr�r�r�r�r�r�r�ryr�rfryr�r�r�r�r�r�r�r�r�r�ryr�r�ryryr�r�r�r�rfr�r�r�r�r�r�ryr�ryryr�r�r�r�ryryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�ryr�r�ryr�r�r�r�ryryryryr�r�r�rjr�r�r�r�r�r�r�r�ryr�r�r�r�r�r�ryr�r�r�r�r�r�rfr�r�ryr�r�r�r�rfryr�r�r�r�r�r�ryryrfrfr�r�r�r�r�r�rfr�r�r�r�r�r�r�ryr�ryryryr�r�ryr�r�r�r�r�r�r�ryryryr�r�r�ryr�r�r�r�r�r�r�r�ryr�r�rfr�r�r�r�ryrfr�r�r�r�r�r�rfr�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�rjr�ryr�r�r�r�r�r�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�ryr�r�r�r�ryr�r�ryr�r�r�r�ryryr�r�r�r�rfr�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�ryryrfr�r�r�r�r�r�ryr�r�ryr�ryryryr�r�r�r�r�r�ryr�r�r�r�ryr�r�ryr�r�ryr�ryryr�r�r�r�ryr�ryr�r�r�r�r�ryr�r�r�ryr�r�r�r�r�r�r�r�rjr�r�r�ryryr�ryryr�r�r�r�r�ryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�ryr�r�r�r�r�r�ryryryryryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�rfrfr�r�r�rfr�r�r�r�r�r�r�ryrfr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryryr�r�r�r�r�ryr�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�ryr�r�r�ryr�r�r�r�r�rfr�r�r�r�ryryr�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�rfr�ryr�r�r�r�ryr�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�rfrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�rfr�r�ryr�ryr�r�r�r�r�r�r�r�r�r�r�ryrfr�r�r�r�r�r�ryr�r�r�rfryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g���s�?Fz
ISO-8859-7ZGreek)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1253N)ZLatin7_char_to_order_mapZwin1253_char_to_order_mapZGreekLangModelZLatin7GreekModelZWin1253GreekModel�r�r��F/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langgreekmodel.py�<module>"s"�
�site-packages/pip/_vendor/chardet/__pycache__/escprober.cpython-38.opt-1.pyc000064400000005044151446177000022715 0ustar00U

��.en�@sXddlmZddlmZddlmZmZmZddlm	Z	m
Z
mZmZGdd�de�Z
dS)�)�
CharSetProber)�CodingStateMachine)�LanguageFilter�ProbingState�MachineState)�HZ_SM_MODEL�ISO2022CN_SM_MODEL�ISO2022JP_SM_MODEL�ISO2022KR_SM_MODELcsVeZdZdZd�fdd�	Z�fdd�Zedd��Zed	d
��Zdd�Z	d
d�Z
�ZS)�EscCharSetProberz�
    This CharSetProber uses a "code scheme" approach for detecting encodings,
    whereby easily recognizable escape or shift sequences are relied on to
    identify these encodings.
    Ncs�tt|�j|d�g|_|jtj@rD|j�tt	��|j�tt
��|jtj@r`|j�tt��|jtj
@r||j�tt��d|_d|_d|_d|_|��dS)N)�lang_filter)�superr�__init__�	coding_smrrZCHINESE_SIMPLIFIED�appendrrrZJAPANESEr	ZKOREANr
�active_sm_count�_detected_charset�_detected_language�_state�reset)�selfr��	__class__��A/usr/lib/python3.8/site-packages/pip/_vendor/chardet/escprober.pyr*szEscCharSetProber.__init__csJtt|���|jD]}|sqd|_|��qt|j�|_d|_d|_dS)NT)	r
rrr�active�lenrrr)rrrrrr:s

zEscCharSetProber.resetcCs|jS�N�r�rrrr�charset_nameEszEscCharSetProber.charset_namecCs|jSr)rrrrr�languageIszEscCharSetProber.languagecCs|jr
dSdSdS)Ng�G�z��?grrrrr�get_confidenceMszEscCharSetProber.get_confidencecCs�|D]�}|jD]�}|r|jsq|�|�}|tjkrhd|_|jd8_|jdkr�tj|_|j	Sq|tj
krtj|_|��|_
|j|_|j	Sqq|j	S)NFr�)rrZ
next_staterZERRORrrZNOT_MEr�stateZITS_MEZFOUND_ITZget_coding_state_machinerr!r)rZbyte_str�crZcoding_staterrr�feedSs"






zEscCharSetProber.feed)N)�__name__�
__module__�__qualname__�__doc__rr�propertyr r!r"r&�
__classcell__rrrrr#s

rN)Z
charsetproberrZcodingstatemachinerZenumsrrrZescsmrrr	r
rrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/mbcsgroupprober.cpython-38.opt-1.pyc000064400000002106151446177000024140 0ustar00U

��.e��@s�ddlmZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZdd	lmZGd
d�de�ZdS)
�)�CharSetGroupProber)�
UTF8Prober)�
SJISProber)�EUCJPProber)�GB2312Prober)�EUCKRProber)�CP949Prober)�
Big5Prober)�EUCTWProbercseZdZd�fdd�	Z�ZS)�MBCSGroupProberNcsDtt|�j|d�t�t�t�t�t�t�t	�t
�g|_|��dS)N)�lang_filter)
�superr�__init__rrrrrrr	r
Zprobers�reset)�selfr��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/mbcsgroupprober.pyr*s�
zMBCSGroupProber.__init__)N)�__name__�
__module__�__qualname__r�
__classcell__rrrrr)srN)ZcharsetgroupproberrZ
utf8proberrZ
sjisproberrZeucjpproberrZgb2312proberrZeuckrproberrZcp949proberrZ
big5proberr	Zeuctwproberr
rrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/jpcntx.cpython-38.pyc000064400000111303151446177000021274 0ustar00U

��.e�L�@s8dZGdd�de�ZGdd�de�ZGdd�de�ZdS))S)S�rr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Sr�rrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)Srrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrc@sPeZdZdZdZdZdZdZdd�Zdd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
dS)�JapaneseContextAnalysis�����di�rcCs*d|_d|_d|_d|_d|_|��dS�N)�
_total_rel�_rel_sample�_need_to_skip_char_num�_last_char_order�_done�reset��self�r�>/usr/lib/python3.8/site-packages/pip/_vendor/chardet/jpcntx.py�__init__{sz JapaneseContextAnalysis.__init__cCs*d|_dg|j|_d|_d|_d|_dS)Nrr
F)r
�NUM_OF_CATEGORYrrrrrrrrr�s
zJapaneseContextAnalysis.resetcCs�|jr
dS|j}||kr�|�|||d��\}}||7}||krT|||_d|_q|dkr�|jdkr�|jd7_|j|jkr�d|_q�|jt|j|d7<||_qdS)Nrr
rT)rr�	get_orderrr
�MAX_REL_THRESHOLDr�jp2CharContext)r�byte_strZ	num_bytes�i�order�char_lenrrr�feed�s 	
zJapaneseContextAnalysis.feedcCs|j|jkSr)r
�ENOUGH_REL_THRESHOLDrrrr�got_enough_data�sz'JapaneseContextAnalysis.got_enough_datacCs,|j|jkr"|j|jd|jS|jSdS)Nr)r
�MINIMUM_DATA_THRESHOLDr�	DONT_KNOWrrrr�get_confidence�sz&JapaneseContextAnalysis.get_confidencecCsdS)N�r
rr)rrrrrr�sz!JapaneseContextAnalysis.get_orderN)�__name__�
__module__�__qualname__rr$r!rr#rrr r"r%rrrrrrtsrcs0eZdZ�fdd�Zedd��Zdd�Z�ZS)�SJISContextAnalysiscstt|���d|_dS)NZ	SHIFT_JIS)�superr*r�
_charset_namer��	__class__rrr�szSJISContextAnalysis.__init__cCs|jSr)r,rrrr�charset_name�sz SJISContextAnalysis.charset_namecCs�|sdS|d}d|kr$dks>nd|kr:dkrjnn,d}|dksbd	|kr^dkrnnqnd
|_nd}t|�dkr�|d}|dkr�d|kr�d
kr�nn|d|fSd|fS)Nr&r�����r��ZCP932r����r
)r,�len�rrZ
first_charrZsecond_charrrrr�s.  zSJISContextAnalysis.get_order)r'r(r)r�propertyr/r�
__classcell__rrr-rr*�s
r*c@seZdZdd�ZdS)�EUCJPContextAnalysiscCs�|sdS|d}|dks0d|kr,dkr6nnd}n|dkrDd}nd	}t|�d	kr�|d	}|d
kr�d|krxdkr�nn|d|fSd|fS)
Nr&r���r�rr���r
)r8r9rrrr�s  zEUCJPContextAnalysis.get_orderN)r'r(r)rrrrrr<�sr<N)r�objectrr*r<rrrr�<module>sVCsite-packages/pip/_vendor/chardet/__pycache__/sbcsgroupprober.cpython-38.opt-1.pyc000064400000003070151446177000024147 0ustar00U

��.e�
�@s�ddlmZddlmZddlmZmZmZmZm	Z	m
Z
ddlmZm
Z
ddlmZmZddlmZddlmZddlmZdd	lmZGd
d�de�ZdS)
�)�CharSetGroupProber)�SingleByteCharSetProber)�Win1251CyrillicModel�
Koi8rModel�Latin5CyrillicModel�MacCyrillicModel�Ibm866Model�Ibm855Model)�Latin7GreekModel�Win1253GreekModel)�Latin5BulgarianModel�Win1251BulgarianModel)�TIS620ThaiModel)�Win1255HebrewModel)�HebrewProber)�Latin5TurkishModelcseZdZ�fdd�Z�ZS)�SBCSGroupProberc
s�tt|���tt�tt�tt�tt�tt�tt	�tt
�tt�tt�tt
�tt�tt�g|_t�}ttd|�}ttd|�}|�||�|j�|||g�|��dS)NFT)�superr�__init__rrrrrrr	r
rrr
rrZprobersrrZset_model_probers�extend�reset)�selfZ
hebrew_proberZlogical_hebrew_proberZvisual_hebrew_prober��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/sbcsgroupprober.pyr,s6���
�zSBCSGroupProber.__init__)�__name__�
__module__�__qualname__r�
__classcell__rrrrr+srN)ZcharsetgroupproberrZsbcharsetproberrZlangcyrillicmodelrrrrrr	Zlanggreekmodelr
rZlangbulgarianmodelrr
Z
langthaimodelrZlanghebrewmodelrZhebrewproberrZlangturkishmodelrrrrrr�<module>s site-packages/pip/_vendor/chardet/__pycache__/mbcsgroupprober.cpython-38.pyc000064400000002106151446177000023201 0ustar00U

��.e��@s�ddlmZddlmZddlmZddlmZddlm	Z	ddl
mZddlm
Z
ddlmZdd	lmZGd
d�de�ZdS)
�)�CharSetGroupProber)�
UTF8Prober)�
SJISProber)�EUCJPProber)�GB2312Prober)�EUCKRProber)�CP949Prober)�
Big5Prober)�EUCTWProbercseZdZd�fdd�	Z�ZS)�MBCSGroupProberNcsDtt|�j|d�t�t�t�t�t�t�t	�t
�g|_|��dS)N)�lang_filter)
�superr�__init__rrrrrrr	r
Zprobers�reset)�selfr��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/mbcsgroupprober.pyr*s�
zMBCSGroupProber.__init__)N)�__name__�
__module__�__qualname__r�
__classcell__rrrrr)srN)ZcharsetgroupproberrZ
utf8proberrZ
sjisproberrZeucjpproberrZgb2312proberrZeuckrproberrZcp949proberrZ
big5proberr	Zeuctwproberr
rrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/euckrprober.cpython-38.opt-1.pyc000064400000002121151446177000023245 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�EUCKRDistributionAnalysis)�EUCKR_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�EUCKRProbercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euckrprober.pyr#s
zEUCKRProber.__init__cCsdS)NzEUC-KRrr
rrr�charset_name)szEUCKRProber.charset_namecCsdS)NZKoreanrr
rrr�language-szEUCKRProber.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr"s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/euckrprober.cpython-38.pyc000064400000002121151446177000022306 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�EUCKRDistributionAnalysis)�EUCKR_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�EUCKRProbercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euckrprober.pyr#s
zEUCKRProber.__init__cCsdS)NzEUC-KRrr
rrr�charset_name)szEUCKRProber.charset_namecCsdS)NZKoreanrr
rrr�language-szEUCKRProber.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr"s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/sbcsgroupprober.cpython-38.pyc000064400000003070151446177000023210 0ustar00U

��.e�
�@s�ddlmZddlmZddlmZmZmZmZm	Z	m
Z
ddlmZm
Z
ddlmZmZddlmZddlmZddlmZdd	lmZGd
d�de�ZdS)
�)�CharSetGroupProber)�SingleByteCharSetProber)�Win1251CyrillicModel�
Koi8rModel�Latin5CyrillicModel�MacCyrillicModel�Ibm866Model�Ibm855Model)�Latin7GreekModel�Win1253GreekModel)�Latin5BulgarianModel�Win1251BulgarianModel)�TIS620ThaiModel)�Win1255HebrewModel)�HebrewProber)�Latin5TurkishModelcseZdZ�fdd�Z�ZS)�SBCSGroupProberc
s�tt|���tt�tt�tt�tt�tt�tt	�tt
�tt�tt�tt
�tt�tt�g|_t�}ttd|�}ttd|�}|�||�|j�|||g�|��dS)NFT)�superr�__init__rrrrrrr	r
rrr
rrZprobersrrZset_model_probers�extend�reset)�selfZ
hebrew_proberZlogical_hebrew_proberZvisual_hebrew_prober��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/sbcsgroupprober.pyr,s6���
�zSBCSGroupProber.__init__)�__name__�
__module__�__qualname__r�
__classcell__rrrrr+srN)ZcharsetgroupproberrZsbcharsetproberrZlangcyrillicmodelrrrrrr	Zlanggreekmodelr
rZlangbulgarianmodelrr
Z
langthaimodelrZlanghebrewmodelrZhebrewproberrZlangturkishmodelrrrrrr�<module>s site-packages/pip/_vendor/chardet/__pycache__/big5prober.cpython-38.pyc000064400000002111151446177000022022 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�Big5DistributionAnalysis)�
BIG5_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�
Big5Probercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/big5prober.pyr#s
zBig5Prober.__init__cCsdS)NZBig5rr
rrr�charset_name)szBig5Prober.charset_namecCsdS)NZChineserr
rrr�language-szBig5Prober.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr"s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/langcyrillicmodel.cpython-38.opt-1.pyc000064400000070603151446177000024431 0ustar00U

��.eF�@s�dZdZdZdZdZdZdZeeddd	d
d�Zeedddd
d�Zeeddd
d
d�Z	eedddd
d�Z
eedddd
d�Zeedddd
d�ZdS)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr������������J��K������������rrrrrr�G��B��A��L��@���M�H��E�C��N�I���O����rrrrr��������������������������������������������������������������������D���������������������������������������������rr�����
��'������������	�����
��������6�;�%�,�:�)�0�5�.�7�*�<�$�1�&��"�#�+�-� �(�4�8�!�=�>�3�9�/�?�2�F(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrirjrkrlrmrnrorprqr\rrrsrtrurvrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r}rrzr�r�r�r�r�r�r�rwr�(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrir�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r}rrzr�r�r�r�r�r�r�rwr�rjr\rkrlrmrnrorprqrrrsrtrurvrr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtrurvrr\r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r}rrzr�r�r�r�r�r�r�rwr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr9r:r;r<r\r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrwr�r�r�rxr�ryr�rzr�r{r�r|r�r}r�r~r�rTrUrVrWrXrYrZrr�r�r�r[r]r^r_r�r�r`rarbrcrdrerfr�r�rgrhrirjrkrlrmrnr�r�r�r�r�r�r�r�r�rorprqrrr�r�rsr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rtrur�r�r�r�r�r�r�r�r�r�r�r�rvrr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxryr�r~r{r|r�r�r�r�r�r�r�r�r�r�r9r:r;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r]r^r_r`rarbrcrdrerfrgrhrir�r�r�r�r}rrzr�r�r�r�r�r�r�rwr�rjr\rkrlrmrnrorprqrrrsrtrurvrr(�rxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxr�r�rxrxrxrxr�rxrxrxr|rxr|rxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxr�rxr|r|r|r|r|r�r�r|rxrxrxr|rxrxrxrxrxrxrxrxrxrxr|rxrxr�r�rxrxrxrxrxrxrxrxrxr|rxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxr|r|rxrxrxrxrxrxrxrxrxr|rxrxr�r�rxrxrxrxrxrxrxrxr|rxrxr�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxr|rxrxrxrxrxrxrxrxrxrxrxrxrxr�r�rxrxrxrxrxrxrxrxrxrxrxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxrxrxrxr|rxrxr�r�rxrxrxrxrxrxrxrxrxrxrxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxr|r|r|rxr�rxrxr�rxrxrxrxr|r|rxr�r|r|r|rxrxr|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxrxrxrxr|r|rxr|rxrxrxr|r�r|r|r�r�r|r|r|r|r|r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxrxr|r|r|rxr�r|r|rxrxr|r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxr�r|rxr|r|rxr|rxrxrxrxr|r|rxr�rxr|r|rxr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxr|r|rxrxrxrxrxr|rxrxrxrxr|r|r|r�rxrxrxr|r|r|r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxr|rxr|rxrxrxrxrxrxr|rxr|r|r�r�rxr|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxr|r�r�rxr�r�r�r�r�r|r�r�r�r|r|r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxr|r|r|r|r�rxr|rxr|rxr|r�r|r|r�r�r�r|r�r|r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxrxrxrxrxrxrxr|r|rxr|rxrxrxr|r|r|r|r�r|r|r|r|rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxr|rxr|r|rxrxrxrxrxrxrxrxrxr�rxr|r�r�rxrxrxrxr|rxrxrxrxr|rxr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxrxr|r|rxrxr�r|r�r�rxr|rxr|rxr�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�rxr�r|rxrxrxrxr|rxrxrxrxr�r|r|r�r�r|rxr|r|r|rxr|rxr|r|rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxr�r|rxr|rxr�r�r|rxrxr|r�r|rxr�r�r|rxr|r|r�r�rxr�rxr|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�rxr�r|rxrxrxrxrxrxrxrxr|r�rxr|r�r�r|r|rxrxrxr|rxrxr�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|r|rxrxr|r|r|rxrxr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|r|rxrxrxrxrxrxrxr�rxr|rxrxr|rxr|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rxrxrxrxrxrxr|rxrxrxr|r|r|r|rxr�rxr|rxr�r�r|r�r�r|r|r|r|r�rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r|rxrxrxrxrxr�r|r|r�rxr�r�rxr�r�rxr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|r|r�r�rxrxrxr|r|r�r|r|rxr�r�r|r�r�r|r|r�rxr�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxrxrxrxr�r|r|r|r�r|r�rxrxr�r�r|r�r|r�r|r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxrxr|r�rxr|r|rxr|r�rxr|r�rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxr|rxrxrxr|r|r|rxrxr�r|r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r�r|r�r|rxrxr|r|r�r|r|rxr�r|r�r�r�r|r|rxr|r�r|r|r|r|r|rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxrxrxr�r�r�r�r�r|r|r�r�rxr�r�r�rxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�rxrxrxr|r�r�r�r|r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|rxr|r|r|r�r|r|r|r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxr�r�r�r�r�r�r�r�r�rxr�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|rxr|r|r|rxr�r|r|r|r|r|r|r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxrxr|r|r|r|rxr|r|r�r�r|r|r|r|r�r�rxr�r|r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�rxr|r|r|r|r�r|r�r|r�r|r�r�r�r|r�r|r|r�r�r|r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|r|r|r�r�r�r|rxr�r�r�r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr|rxr|r�r|r|r|r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r�r�r�r|r|r|rxr|r|r|r|r|r|r|r�r�r�r|r�r|r�r�r�r|r|r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr|rxrxr|r�r�r�r�r�r�r�r�r|r�r�r�rxr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxrxr�r|r|r|r|r�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxrxrxr|r�r�r�r�r|r|r�r�r�r|r�r�r�rxr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|rxr|r�r�r�r|r|r|r�r�r�r|r�r�r�r�r�r�r�r�r�rxr�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r|r�r�r|r|r|r|r|r|r�r|r|r�r�r�r�r�r|r|r|r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxrxr|r|r�r�r�r|r|r�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr|rxr|r�r�r�r�r�r�r�r�r�r|r�r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rxr|r|r|r�r�r�r|r|r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rxr�r|r|r|r|r|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r|r�r�r�r�rxr|r�r|r�r|r|r�r�r�r�r�r|r�r�r�r|r�r�r�r�r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r|r|r|r�rxr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|rxr|r|r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r�r�r|r�r|r|r|r|r|r�r|r|r�r�r�r�r�r�r|r|r|r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r|r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r|r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r�r�r|r�r|r�r�r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�gl���P@�?FzKOI8-RZRussian)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1251z
ISO-8859-5ZMacCyrillicZIBM866ZIBM855N)
ZKOI8R_char_to_order_mapZwin1251_char_to_order_mapZlatin5_char_to_order_mapZmacCyrillic_char_to_order_mapZIBM855_char_to_order_mapZIBM866_char_to_order_mapZRussianLangModelZ
Koi8rModelZWin1251CyrillicModelZLatin5CyrillicModelZMacCyrillicModelZIbm866ModelZIbm855Model�r�r��I/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langcyrillicmodel.py�<module>sb�
�
�
�
�
�site-packages/pip/_vendor/chardet/__pycache__/langthaimodel.cpython-38.pyc000064400000053217151446177000022607 0ustar00U

��.e,�@sdZdZeeddddd�ZdS)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr��j�k�d����e�^���l�m�n�o����Y�_�p�q�����rrrrrr�@�H�I�r�J�s�t�f�Q���u�Z�g�N�R�`���[�O�T�h�i�a�b�\��rrrrr�����������X���������������v���������c�U�S��������������������������������K���4�"�3�w�/�:�9�1�5�7�+���,��0����'�>��6�-�	���=�����*�.���L��B�?��
��$��
�(�� �#�V�������������)��!��2�%���C�M�&�]���D�8�;�A�E�<�F�P�G�W����rr(�r�rrrrrrrrr�r�rrrrr�rrrrr�rrrrrrrrrrrrrrrrr�r�rrrrrrr�rrrrrrrrr�rrrrr�r�r�r�rrr�rrrrr|rrrrr�r�r|rrrrrrrrr�r|r�r|r�r�rrr|r�r|r|rrr�rrrrr|rrr�r�rrrrr�rrrrr�rrrrrrrrrrrrrrrrrrr�rrr|rrr�r|r|r|rrr�r|rrr�r�r�r�r�r�r�r|rrr�r�rrr|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrr|rrrrrrrrrrrrrrrrrrrrrrr|r|r|r|r|r|r|rrrrr|rrr|rrrrr|r|r|rrr�r|rrr�rrrrr|r|r�r|rrrrr�r|r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|r|rrrrrrrrr�r|rrrrrrrrrrr|r|r|r|rrrrr|r|rrrrr|r|rrr|rrr|r|rrrrr�r|rrr�r|r|rrrrr�r�r|r�r�r�rrr�r|r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrrrrrr|r|rrrrrrrrr|rrr|r|rrrrr|r|rrr|r|r|r|r�r�rrr�r|r�r�rrr|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrr|rrr|rrrrr|r|rrr|rrrrr|rrr�r�r|rrr|r|r|rrr|r|r|r|r|r�r|r�r|r|r�r�rrrrr|r�r�r�r|r|r�r�rrr�r�r�r�r�r�r�r�r�r�r|rrr�r�r|r�r�rrrrr|rrrrr|r�r�rrrrr�rrrrr�r|r|rrr�r|r|r�r�r�r�r|r|r|r�r|r|r�r�r�r|r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|rrrrr|r�r�rrrrr�r|rrr�r|r�r|r|r|r|r�r|r�r�r|r|r|r�r|r|r�r�r�r|r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|rrr|rrr|r�r|r|r�rrr|r�rrr|r�r|rrr|r|rrr�r|rrr|r|r�r|r|r|r|r�r|r|r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|rrrrr|rrr|r|r|rrr|r|rrr|r|r�r|rrr|r|rrr�rrr|r|r|rrr|r|r|rrrrr|r�rrr�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�rrr�rrrrrrrrrrr�r�rrr�r|r|rrrrrrrrrrr�r�r�r�r�rrr�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r|rrr�r�r�rrr�r|r�r�r�r�r�rrr�r�r�r�r�r�r�r�r|r�rrrrrrrrr�r�r|rrr�r�rrr�rrrrr|rrrrrrrrrrr�r�rrrrrrr�r�r�rrrrr�r�rrr�r�r�r�r|r�r�r|r�r�rrr�r�r�r�r�r|rrr�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|rrrrrrrrrrrrrrr�r|r�rrrrr|r|r�r|r|r|rrr�r�r|r�r|r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|r�r|rrrrrrr�r|r�r|r|r�r|r�rrr|r|r�r|r�r�r�r|r|r�r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|r�rrrrr�r�rrr�r|rrr�r�rrr|r�r�r|r�r|r|rrr|r�r�r�r�r�r|rrr�r�r�rrr�r|r�r|r�rrr�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�r�rrr|rrrrrrr�rrr|r�rrr|r�rrr|r|r|r|r�rrrrr�r|r�rrr�r|rrr�r|r�r�rrr|r|r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrrrr|rrr|rrrrr|rrr|rrr|rrrrr|r�r�rrr|r|r|r�r|r|r|r�r|r|r�r|r�r�r|r|r|rrr�r�rrr�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|rrr|r|r�r�rrr|rrr|rrr|r�rrr|r|r�r|r�r|r|r|r�r|r|r|r|r�rrr|r�r|r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrrrr|rrr�r|rrrrr|r|rrr�r�r�r|r�rrrrr|r|rrr�r�r�rrr�r�r�r�rrr�r�rrrrr�r|r�r|r�r�r�rrr|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrr|rrr|rrrrr�r�rrr�r�r|r�r|r�r�rrr�r�r�r|rrr�r�r�r�r�r�r�r�rrr�r�r|r|r|r|r�r�r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr|r|r�r�r|r�rrrrr|rrr|r|rrr|r|rrr�r|r|r�r|r�rrr|r�r|r|r|r|r|r�rrr|r�r|r|r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrrrrrrrrrr�rrrrr�r|r�r�rrr|r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|r|r|rrr�r�r�rrr�rrr|r�rrr|r|rrrrrrrrrrr�r�r|r|r|r�r|r|r�r|r�r|rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|rrr�rrrrr|rrrrr�rrrrr�rrr|r|rrr|rrrrrrr�r�r|r|rrr�r�r�r�rrr�r�rrr�r�r�r|r|r�r�rrr�r�r|r|r|rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr|rrrrr|r�rrrrr|r|rrr�rrr|r�rrr|r�r�r|r|r�r|rrr|r�r�rrr�r�r�r�rrr�r�r|rrr�rrr�r�rrr�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�rrr|r|r|r�r|r�r�rrr�r�rrr�rrr�r�r|r�r�r�r�r|r�r�r�r�r|r�r�r�r�r|r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�rrrrrrrrr|r|r|r|r|r�rrr�r�r�r|r�r�r�r|r�r|r�rrr|r�r�rrr�r�r�r�r�rrr�r�r|rrr�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr�rrrrr�r|r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr�rrr�r�r�r|r�r�r|r�rrrrr|rrrrrrr|rrr�r�r|r|r|r�r�r�r|r|r�r�r�r�r�r�r�rrr�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|r�r�r�r�r�r�r�r�r�r�r�r|rrr�rrrrr�r�r�r�rrr�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�r|rrr�r|rrr�r�rrr�r|r|r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|r�r�r�r�r�rrr�r|r|r|r|r|r|r�r�r�r�r�rrr�r�r�rrr�r�r�r�r�r�r�r|r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�rrr�r|r|r�rrrrr|rrrrr�r�r�r�r|r|r�r|r�rrrrr�r�r�rrr|r�r�r�r�r|r�r�r�r�r�r�r�r�r|r�r�r�rrr�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�rrr�r�rrr�rrr�r�r�r�r�rrr|r�r�r�rrr�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rrrrr�rrr|r�rrrrr�r|r|r�r�r|r�r�r�r|r�r�r�r�r�rrr�r�r�rrr�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r|r�rrrrrrr|r|r�r�r�r�r�rrr�r�r�r|r|r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|rrr�r|r�r�r|r�r�rrr�r�r�r|r�r�r�r�r�rrr�r�rrr�r�r�r|r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�rrr�r|r�r�r|r|r�r�r|r�r�r�r�rrr�r|r�r�r�r�r|r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r|r|r�r�r�r|r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�rrr�r�r�r�r�r�r�r�rrr|r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr|r|r�r�r�r�r�r�r�r�r|rrr|r�r|r|rrr�r�r�r|rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|r|r�r�r�r�r�r�r|r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�rrr�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�rrr�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�rrrrr�r�r�r�r|rrr�r�r|r�r�r�r�r�r�r|r�r�r�r�r�r|r�r�r�r|r�r�r�r�r|r�r�rrr�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�rrr�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|r�r�r�r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�rrr�r�r�r�r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�rrrrr�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r|r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r|r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g��@��?FzTIS-620ZThai)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguageN)ZTIS620CharToOrderMapZ
ThaiLangModelZTIS620ThaiModel�r�r��E/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langthaimodel.py�<module>$s�site-packages/pip/_vendor/chardet/__pycache__/mbcssm.cpython-38.opt-1.pyc000064400000040515151446177000022217 0ustar00U

��.e�c��@sl	ddlmZdZejejejdejejejejejejejejejejejejejejejejejejejejfZdZedeedd�ZdZ	ejejdejejejd	dejd
ejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejfFZ
dZe	de
ed
d�ZdZ
dd	ddejejejejejejejejejejejejejejejejejejejejejejejejejejdejdejejejejejejejf(ZdZe
d
eedd�ZdZejejdejejejejejejejejejejejejejfZdZed	eedd�ZdZejejejdddd	ejejejejejejejejejejejejejejejejejejejejejejejejejdejejejejejejejejejejejejejejejf0ZdZedeedd�ZdZejejejejejejdejejejejejejejejejejejejejejejejejd	ejejejejejejejejejdejejejejejejejejejejejejejf0ZdZedeedd�ZdZejejejdejejejejejejejejejejejejejejejejejejejejfZdZed
eedd�Z dZ!dddejd	dejejejejejejejejejejejejd
d
d
d
ejejd
d
d
d
d
ejd
d
d
d
d
d
dddejddd
d
ejd
d
d
d
d
d
d
ejejejejf8Z"d Z#e!d
e"e#d!d�Z$dZ%d
d
dd
d	dejejejejejejejejejejejejdddejejejdddejdejd
d
dd
dddddejdddejejejdddddejdejejejf8Z&d"Z'e%d
e&e'd#d�Z(d$Z)ejejejejejejd%dd&d'ddd
dd	dejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejddddejejejejejejejejejejejejejdddejejejejejejejejejejejejddddejejejejejejejejejejejejejejddejejejejejejejejejejejejd&d&d&d&ejejejejejejejejejejejejejejejd&ejejejejejejejejejejejejd%d%d%d%ejejejejejejejejejejejejejejejd%ejejejejejejejejejejejejd%d%d%ejejejejejejejejejejejejejejejejejejejejejejejejejejejf�Z*d(Z+e)d)e*e+d*d�Z,d+S),�)�MachineState(rrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrr�ZBig5)Zclass_tableZclass_factorZstate_tableZchar_len_table�name(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	�r
r
r
r
r
r
r
r
r
r
r
�rrr
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
�	rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	)
rrrrrrrrrr�
ZCP949(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrzEUC-JP(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrzEUC-KR(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrrr
zx-euc-tw(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r)rrrrrrrZGB2312(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrZ	Shift_JIS(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrzUTF-16BE)rrrrrrzUTF-16LE(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r
rrrrrrrrrrrrrrrr
�rrrrrr��
rr��rrrrr)rrrrrrrrrrrrrrr	r	�zUTF-8N)-ZenumsrZBIG5_CLSZERRORZSTARTZITS_MEZBIG5_STZBIG5_CHAR_LEN_TABLEZ
BIG5_SM_MODELZ	CP949_CLSZCP949_STZCP949_CHAR_LEN_TABLEZCP949_SM_MODELZ	EUCJP_CLSZEUCJP_STZEUCJP_CHAR_LEN_TABLEZEUCJP_SM_MODELZ	EUCKR_CLSZEUCKR_STZEUCKR_CHAR_LEN_TABLEZEUCKR_SM_MODELZ	EUCTW_CLSZEUCTW_STZEUCTW_CHAR_LEN_TABLEZEUCTW_SM_MODELZ
GB2312_CLSZ	GB2312_STZGB2312_CHAR_LEN_TABLEZGB2312_SM_MODELZSJIS_CLSZSJIS_STZSJIS_CHAR_LEN_TABLEZ
SJIS_SM_MODELZ
UCS2BE_CLSZ	UCS2BE_STZUCS2BE_CHAR_LEN_TABLEZUCS2BE_SM_MODELZ
UCS2LE_CLSZ	UCS2LE_STZUCS2LE_CHAR_LEN_TABLEZUCS2LE_SM_MODELZUTF8_CLSZUTF8_STZUTF8_CHAR_LEN_TABLEZ
UTF8_SM_MODEL�rr�>/usr/lib/python3.8/site-packages/pip/_vendor/chardet/mbcssm.py�<module>sP$����$��$��$�	�$��&��$�
�$�
�$��site-packages/pip/_vendor/chardet/__pycache__/version.cpython-38.pyc000064400000000622151446177000021454 0ustar00U

��.e��@sdZdZe�d�ZdS)z�
This module exists only to simplify retrieving the version number of chardet
from within setup.py and from chardet subpackages.

:author: Dan Blanchard (dan.blanchard@gmail.com)
z3.0.4�.N)�__doc__�__version__�splitZVERSION�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/chardet/version.py�<module>ssite-packages/pip/_vendor/chardet/__pycache__/latin1prober.cpython-38.pyc000064400000006446151446177000022403 0ustar00U

��.e��@s^ddlmZddlmZdZdZdZdZdZdZ	dZ
dZd	Zd
Z
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee
ee
ee
eeeeeeeeeeeeeeeee
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee	e	e	e	e	e	e
e
e	e	e	e	e	e	e	e	e
e
e	e	e	e	e	ee	e	e	e	e	e
e
e
eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee�fZdZGdd
�d
e�ZdS)�)�
CharSetProber)�ProbingState��������)@rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrcsLeZdZ�fdd�Zdd�Zedd��Zedd��Zd	d
�Zdd�Z	�Z
S)
�Latin1Probercs&tt|���d|_d|_|��dS)N)�superr�__init__�_last_char_class�
_freq_counter�reset��self��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/latin1prober.pyraszLatin1Prober.__init__cCs t|_dgt|_t�|�dS)Nr)�OTHr�FREQ_CAT_NUMrrrrrrrrgszLatin1Prober.resetcCsdS)Nz
ISO-8859-1rrrrr�charset_namelszLatin1Prober.charset_namecCsdS)N�rrrrr�languagepszLatin1Prober.languagecCs`|�|�}|D]J}t|}t|jt|}|dkr@tj|_qZ|j|d7<||_q|j	S)Nrr)
Zfilter_with_english_letters�Latin1_CharToClass�Latin1ClassModelr�	CLASS_NUMr�NOT_MEZ_stater�state)rZbyte_str�cZ
char_classZfreqrrr�feedts

�zLatin1Prober.feedcCs\|jtjkrdSt|j�}|dkr(d}n|jd|jdd|}|dkrPd}|d}|S)Ng{�G�z�?grrg4@g\��(\�?)r!rr �sumr)rZtotalZ
confidencerrr�get_confidence�s
�zLatin1Prober.get_confidence)�__name__�
__module__�__qualname__rr�propertyrrr#r%�
__classcell__rrrrr`s

rN)Z
charsetproberrZenumsrrZUDFrZASCZASSZACVZACOZASVZASOrrrrrrrr�<module>s�'
site-packages/pip/_vendor/chardet/__pycache__/big5freq.cpython-38.pyc000064400000065006151446177000021502 0ustar00U

��.ez�@sdZdZdZdS)g�?�(�i	i��i����	�R�i����iai�i�ni��!i�i�L�,iB�i�i�i�i�i��i{
i]
i�i�i
iji�i�i.iNiii�����:i�i�i��?i�i�i=iN�K���ikiq	i�i�i�
i��iib��
i�i��i�
ioi2i�ii�i�ici8i�i�ii��i�i��i{�|��i��"i�
i��@i\i�i�	i�i��i�i�i�iFi�i|
iQ�Hi�i��Piv��i�i�ii�iDi^
i�i�iFi}
i��Ei�iO�i0i��si�i4�<�2i��i&iMi�i�i~
�i�iG�ii[i�i�i?iiiaiiK	i*i�igi�	�Zi�
i:i��i�iKi�	�i�	�ii�i�i�i`ilii�i��i
	i �qi�i~i���i
i�	ii�i�i�ici��u�i�i*ii�i	i�
i��~imi�i��iei��Gi^i�in�i�UiCi�iCi�i�i�i�ii�i �jioi/ii�iPi7	i[i���i�
i?i�i�i�io�Si(i�i�ip�]i�i6ijii@iii�iii8��+i3i[�i�i\i�i�i�i��i]	iAi���i�i1��i�iHi�
i�
idi���i+i�i2i�i�i�i�
iOiL	i�iifi1��i�i�i�i�i�ii3i9���li,��i	ii�ii�i�i�i�ieiz
iQiMi&i��Xi�i�i�i���i
��i�ikipi��M�i�i��%�i�i�i�i�i��'i�	i�i\i�i�7��Ji�i!i�i�ii���iNi�iBiPi_
iq��i�
i�i�i�
i�
i�� i�ii iIi�i8	i�i�
ii{
�i�i
i�i���mi�i�ifi�i�ixi�i�i�i�i�
i�i
i�igi���i
ii�i�i�i�i��&i�i'i�ii�i�i��.�i�ii�iM	i���i�i�i$�#i�iDihiAi�	�i�iri�i�iUiGii�i�i
i�
iQiSiii�i��di�0�Fi�i�iCi�i�ii�i i�iJii�iU�i��iN	i�
i�i�i<i�i�
i:iA
i�
i�i	i 	i9i�i}ii�	i�i�iWiPi�
ii)iDii�i�i4i�
i�	i)i�i�ir	i�isi�i�itii9	i�i�i�is	i*ii�i�i�i�i�i]i�i�i�i�i�	iDiji(
i
i�i�i�
i�iui5iYiji	ili�iuii�i�
i�i�i`
i
i=i�i�i�i�i�i�i�i5i�i!i�i�iTiEixi�i�ie�i�	i�iO	iPi�i|
i6iAi�
i/iki�i�
iili!i	i�iBi�i`i�i
i��iAi�iiii�i�
ivi�	i�i�iwi�i���iMi�
i�i�i�ii�ia
i�i�i�
i}
i�ixi,�}i�i�iB
i�i�i�i�i�i�i�i�iFikimi�	i�i�
i�i	i�i�
i�ibi�i)
i^iP	i
i,i�i�i�i7i5i~
iyi|i�izi�ii�i�
iC
i{iii�i�i�i�i�i�i�i1���bii�	i�
i�i�it	i�i�
i�i_i��i�i�i�ii�
i�
ib
i��i�i5�D�i�ili�i|i[i*
i��i�
i�i%�iGi^	i�ili�i�i�
i�i`i�i�i�ipi��in�cigimii�i'i2i��i�i{i�i�i�i�i�i�iD
i�ifi	i�i|i:	��i�ii�i�
i�i�
i
i�i�i�ini�i�i�i��;i�iIiYi}i�i�
iXi"i�i
i�i�i�i�i�i�i-i�ili�i�i�i�i�ii�i�iEi�i~i�i>i]i�i,i�i�i�iviLiB�ii&i�i�ii�i�i�iGi�i�iiBi�i�
i+
i�ii�i�i�i�i�i�	i iaii�i�i
iai�i}iE
i�iDi�i=i�i0ii�i�
i6i�ii�ivi!�i�i�i��i�i�i��9iHii�i�i�i�
iFi�i�i�i�i�i"i�iHi�i�i�i
ioii�iRi*i�i.i�i�i�i�iiI�3ii,
i�i*iSi�i�iXi�i�i/iibipi�i�	i�i�i�i�i�iRiii�i7i�i2i�i�	i�i�i�i�i�i�i_	i�ibii�
i�i�i�i�	i�i�i�ii�i�i`	�Oi�i�	i�i`i7i�
i�
i�i�i�i�i�iia	i�i�i�i�i�i�igi�i�i�i�i
i_i�i~��i�i�i�i�i�
iai�i�
ib	i�i�i�i�i��i�i�	i;��i�	i-i
i�iQ	i���i�iqii�i�i��`i�i#i#i�ii�iiri�
isii�i�iditi�
i�ic
i�iikiwi�i�i�i�i�i�i�ii�i��gi�iQi�iUi
i�i�i�i���CiSi�ic	i�i�i5i�i�iBi�i_i�iciN��i�iYi�i�i�i�
�iLidi�
i�
i	iKi�i8iaiGi�i�i
i�i�iisi6i�	iti;	�Ni�i�ii	i4i�i:i�i\iqi�i�i�i.i�iiiui�
i�i�i�i�i�
�i
iri�i�i�
i�
i�ici�i�i�i@i�i�i�ii�i�ii�i/i9i�ii�ii�i�i�i�i�
i<	id
ii�i�i8iviiCi�ii
i�imi�i�
i�i�i�i�i�iZi����i�iwi�	�{i�i�i�i��$i�iiMidi0iri�i�i�igiiVi�i�ii�i:iZi�i�i{i$iei0i�ii$i�i�
i�
i�i5i�i[i��vi�iici�iViR	i$i;�i�iifiii�idi�i�iWie
ii�i�iii�i�
iiJi�ii�iiui�i	i�i
i�ii�
iKi�i2i�iLi i.i�i�i2i�ii�i�i��i�i%ii�i�ii
ii�ii�iii��
i�
ixi�iMi�i}ii�iTii�i�id	i�
ii�i�i�i`iii�i�i�	i3iii;i�iiiiyiYiLi�i�i�	i�	iii�iU�\i�i�ii�i�iViNi�ii�
i�i�i 
i�i"ixi%ii;i=	i i�i�i2iEi�i!i�i�i��^i�i"iwi�
i#i�i�i�i�i�i$i<iQi�i�iri%i�i]i�i&i�i<i'ii3i6iBi�i�i(i�i�i�i�i�ii�igi�
i�
i)i�
i	i*i+i!	i�i��i:i�i7i�i^i�ii�ii(i�
i,i+iiixi-i�i/ihi=i.i�i��i�iVii�i�hi�i�i/ii��i�i<i�i�i;i0i�i�i�i
i�	i1izi�ii�i5i6i�
i_�)i2i3i�i4iyi"	�i�i�
i�i^i5i�i�i?i%i+if
i�i6i_iWi�i�i�
i7i>ii�
ig
i#	��iu	i8i�i�i9ih
iF
i�iVi{i�iOi�iI�wi~i�
i^ii�i:i�i�i�i�i�i�i�i�	i;iei1i�i�i�i�i�i�i�i�i�i�iiiPi<i=i�i>i�
i��(i`iRi?iYi�iIi�	��i�i�i7i�i�
i?i�i�i�
i@i�io�iqiYinii�ilii�i�i�i�i�
ii
iEiPiVi�i!
i�i�i�i�i�ini�iAi�i|i�
ii
iBi�i�i�i�ii-
i�	iOi�
i�iCi�iDiWiTiT�i�i�i�i�
i}iEi�i&i�
i�i�i�i�ii�i�
i�i�i~iG
i�
i�ii$	iWi�ii�ioi�i
iFiiGi�ii"
i���i�i#
i�i�iDi-iQi�iHiei�	iiiIi�i�iiJizi
i�iKiiiLi�i$
i�
i�i�i�i�iH
�i�i�ii�i�iMi:i�	ii�iNi�iI
i�i�i�iHi�i�ii�iOi�i�i�	iPiQi�i�ikiRiRi���i�i�
i
i�i�i�i�i�i�ii�iSiTi�i�i�i%
i�i�i�i�i�i&
iSiUii�iS	i�iCi�i�i�iVi~i�i!iXi�i�i�i�i�i,i�ii�i�iOi�i|i�ii�iPi�ie	i�i�i�i�ii�i�i�i�i�i�i�i�iTi�i�i�iWi�i�iiXi�iYi�iRi�
iviii�
ii�i=ii�iZi�iUi�i�i[i�i�i�iVi%	i\i�i�i]i�i�i^i8iT	i.
i'
i_i�ivi�i�i�i�iwitii`iaibi>	i�i�i"i{�i�i�	i�ici�idi9i�iii�i[i9iiidihi
iei�i�i�iJ
i!i�i�ifi���ii�i�i�iTigi�ii�i%i��WiMihii�iii�i�i�i�i��i�i�i�i(
ij
i�iyi7imi�ijiki�i?	iWi"i�i��i�Bi�ili|i��i)
izi���i�
i�i�i�i�ii�i�im�iniuiv	iwi�i	i*
ii�ioipi��iqi7i.iri�i�i
iii�
i�ifi�i�i�isi&	iyii�i i�i�i�ii�i�
ii>i�i�i�i�i�Yi�i�iti�iui/
i+
i�ivi�i�i�i@iwii�	i�	�i�i3i�i�i�i,
ixi�i6i9i�
i	ii��6i��ii!ii�iyi�iQi:ici
i�ii-
�oi�i�iFiXi�
i�i�ifi�iizi�
i�i�i�i�i�i{i/�i�i'	i�	ibii�i`i�i�iiui	ivi�i�ii�i�
i
i
i�i�i�i�i0iE�iSi�i8i[i|i}iGi�ii�i!i~ii�iFiU	i�i�
iii�ieisi�i�i�iw	ii�i�i"iiai	iZi&i�i�i�i�i�	i
i�i�i�iAi�i�i�
iiiii�i�i�i�i�i�ii�i
ioi�ii�ii�
i
i�i	i�iAiiJi0i�ix	i�
i�i�i�iYi�i�i�i�i�i�	i�ii�iZi8ioii�iQi�i�i�i�i�
i���a�Qi�i�ipi;i�iPi�ibi�i�i�i�ii�i�i
i�i�i�i�	i�i�i�i�i�i�i�i�i�i�i�i]ii�ii�i�
�i�ii�i�i'i�ii.
i���i
i�i�ii�i�iLi�i�i�i�ii�	i�i/
i�ii�i�iBi0
i[ii8i�i�i�i�i�	i�ii/i3i�i�i�ii�
ii�ii0i�ini�i�i�ii�i���ii�	i�i�i�i�ii�iii�i4i�i�ii<i�	ii
i�i�iYi�	i�i��iCi�i�ii�
i�i�i�i�i}i1ii�
i�i�i�iK�i���i0
iFi�i�i�i�
ii#i�i\i�i�i��fi�>i�
i�ii�
i�i�i�i�i�ii�
i�i�i�i�iji�i�ii�ii-ipi9i@	i6iyii�i�ii
i1
i�i�ii�i�ii��Vi�i�i�i�i4i�i�i�iKi1
i�i�
iDi�i�i�i�ii�i#i�i�i�i�i2
ii�ii�	iZiHipi�i�igi�i�ii�
iq�ri
i���i�i�i�i�iiK
iV	i�
i\i,i
i�i�i�ii�i]i�i�iu�i�
iii�i�i�i�ii�iZi�i�i�
iii�iiji�i�i0ihihi�i�i�i�i�iEii�i	
i�ii�	i�i�i�i�i�i�i�ii�i�i�
iii�i2
�i�i�i�i�iiMi�iwi�i�i�iy	i?i�i�i�i

itimi(	i�	i�i+i�i�i�i�i�i��iiii�
i�i�	i�i�i�i
i�iL
i�i�i)	i�
ii�
i�iif	i�i�	i�iii�i�i�iRi"iA	i3
i�i�i-i1i�i$i�
i(i�i]i�i#i�i$i�
ii�i�i i*	i�i�i�i�i
i�i�i�
i=ik
i�i!i�i�
i�i�i�i�i�
i�i���_i�i�i�i�i^i2ii�
i�i�i�i9i�i�i�i�i�i�i4
i�i�i�i
�ibii�i�ii�i�ii��5i�i�i�i�i"i	i�
ii�i�i��i4iIii�i#i�i��i�iii�iiji�i�ii$iki�ii�
i�i\i�
igi�iEi5
i�i�i�i�i�i�i�i�i�
i�i�i6
i�i�ii	i�i%ii�i�i�i�i[i�i�i�i�i�ii�i&�ei�i�i�i�i�ioi�i�ili	i}i�i�i�izi�i+	i�i�i�ii�i�ini-i�i�
i'iiii
i�i�i�i(i�i�i�	i�i�ii�i�i�ii�
i�i�i�i�iBiiiqi�i�i�i<i�i*iji)i"i*i�i>i)i7
i�i+i�i�i�ii�i�i��zi�i,i�i�i�iiM
i)iri�i�i-i	i�i�i�i�i�i��Ti��pi�i�i#i#i�i�ii�i�i�i�i�
i�ii�i	i�	i�i�i�iSi�i.i8
i�i�i�i�iz	i9
i=i�i�i�imi�iSiii�i�i�ixi�i�i/i�i�iqi�ii3i�i5i�i:
i�i�
i�i�i�i�i�i�i�i
i;
i�i0i1i�iii�i�ini�i_i�i]ii�ini�i�i�i�i
i%i�i�i�i�i�i`i�i�i�i�iziTisi2i3
i�i
i{	�i5���ii�
ig	i�i�iki�i�i�ii�
i�i�i3i4i�i�i�ici i�i�i
i�
i�iiai:i1i�i�i�i!�Aihi ioi�
i6i"i�i��il
�-i�i
iai5ii�	i�i
i�i�i#i!i�i$i�i�
i�i4
ifi�i	i%i&i�
iN
ri
i�iWi�iii�ii�
i'i�i$i�ii<
i�iNiiiW	iki�iO
i�i�iii�i�iX	i,	ii6i&iti�iP
ii�i7i�
i�i�
i-	ijii	i�
i�iC�[ipi�i�i'i8i
ibi�im
ii�
i�i{i(i�i�	i�i�	i9i�
i�	ii:i
i�
i^i�i�i�iB	i;ii�iii�i�
i���i
i�i	i�i)i<i=i�
ii�
i�i>iiiii�
�=i�i�ii�ii�i�i�i�i�in
i�iHiDi�
i?i�iUiWi�
i=
i�i:i�i�	iNi�iKiEi@i4ici�
i�i>
i�iQ
i
iAii�ihi�ii�
i�
i(i]i�i�i�iBi*i�i�ili�iCiDi�iEih	i�ii�i��i�iXiiii�i+i�i�i�i+iJi�i�iU��ii
i�imi iEiiiiFiiGi
�ki�	ini�i�
idii�ii�i�i�iFi!i i�iri@i�iHi"iCiGi��i�i
i�i^i�
i�i��8iti)i;i�i?
i!i�ioiIi�i"i#i#i$i�iJi�	i%i�
i&iriKi'i5
i(i)i�io
i@
i}iA
i�i,i�i*i4�1i+i�i�i�i�i�i"i�i,ii�
iC	i�iuiriD	i-i�
i-i�iLivi{i�i|	iMi.i.iNiY	i6
iii�i/i0i/i�i�i1i$i�i2i%iGiRiB
i�i_i�i�iC
i�i�iD
i�i3i�i�i�i�i�i�ii.	i�i�	i4i@iwi�i5i�i6i7i�ii	i�i&i0i�i8i	i&i�	i*�i+iGiOiu�i#i�
i1iPiRi�iQi�i�i�i)i�i�i=i9i�ili�i�i�i�iE
iSi�iki�i\i�	i�i�i�
iyi:i�i;i<iF
i%i=i�iRiii>idi'i,i?iei$i�i2i3i-i�i�i4ii(iSi@iAiBi�i.iTi�iOi
i�i�i�i�i�i�
i&ii�i�i�
i<i�
i�ii�iCiiDi�i�iUi�ip
iG
iei�
i�i�i�i�
iEi;iViFi'iGi)i
i�i}	iHi*i�iWi�i�iIi�iTi�i�
i�
i�i�i�i�ii	i�iJi.igi~�iUi�ij	i	iiiXi�i�i8i�i*i�	i�i�iKi~	i�i�i�iLiiHi�
i�ii%��i+ifi�i�i�i�iti�iMiNi�i�i�ii	i�i 
i�i�ik	iYiiYi�i�i��*i/i�iOiR
iZiH
i�i#iIi�
i�	i�i�i5iS
i]iE	i[i\i
isiI
i+iPiQi,i�	i�
iRi�iSiTi�i,i�iUi]iVi�i�iLi-i!i�iT
i\�4iWi�iiXiYiZi�i[i>iwi�i�i�i�i+i^iiJ
i�i_i$i�i\i�i�iili.i]i`i�i^i_iq
i%i�i`iaiii�i�
i6igiU
ibicidiai�
iqixi�
iei
ibiyi�ifihigihi�i�i'iiii�i�i	ijiri�i
i0i	i=i�ibi|�i�i�i�i�i�i	iihiki�
ilii�i�
iai�icimi�ii�ini�
i�iui�i�idiei�isiK
i/ioi7i�i&i�	iJi8ipiqiiijifi�i�	igi	i�i�i(i�i`irisi�i�iii<iFikifi�i��i�i]i�i�iIiti>i�iui�ivi�i�
i�i�i�
i0i�i-i�iwiL
i�i�	i�i�i�i�iGiai�i
iti�i�i�
iSiKixiiyizi�i�iV
��i�iOi�i1�i�
i{i�
i�i�iF	iyi�i9iZ	��i|i}i~iFi�i�i�i�
i�	i:i�iiii2i�i�iipi�i;iG	i�i�i	ihi�i�i�ii7
i�i�i�iiqii�iM
i�iii�iii�i�i�i�
i�i�i�
i(i8
i�iN
i	ii3i�	iiO
i<ii�i�iTiiW
i�	i�i�i�i�i(i�i�i�i1i�i�i�i�i�i�i�iuiZii�
i�	ici�ijiP
ipi�i�i
ii�i�i�iviiiji�i�
i�i�i�i�iQ
iKii�i�	i'i�i�i�ii�i9
ii�i
i�	izi�i�	i
i�i�iki�i�i�i�i�i�i2i	i�ilii�i>i=iCi'i�i�i>i
iiZi�i�i�i�imini�i�ibii�i�	iiqi?i�i
i�ii�i�	i"i�i�
i?i
i}i�i�ioi@i>iiAi�i1i�i)i�i�i�i?i�
i�
i�ii�ixi	i�i	ii�	i3i�iihi�iili�i�i�i)i�i�
ipi�i'i�i�i�i4i�i�i
i�
i�i�i�iAi_i	iBi�iLi�i
iPiqi�ii�iriii�iiX
iicisi!
i�i�iiHi�i	iwi�i�i�iCiDitii�i�i�i�i�ixi
ii�	i/	i�iii5i
i4iuiir
i�ii_i�i��/i�i<i�i~i7iyimi�ii^i5inibi�
iti�iil	i�i�i�i6i�i�	i7i�i�i�i�i�iivi�i�i�i�	i8i:
i�i�
i�i0	i�i1	i�iwi�Ii�i�i�i�i�i(i�iiBi�i�i4isi�
i�i�i�i�i
i�
i�i�i?iCiixi	iEiHii�iFiyiziGi�ii�i�i{i�i�ii|i�i;
i}i9imiH	i~i�izi�i�is
i�	i�iMi�i�ii�i�iim	i�i�iIi�i�iioii�ii�ii�i�i_ii�i�i�i2	i3	iHii*i�ii�
ii�i�i<
i�iii:i�i�
i�i�i�iAi�i�i�iR
i�i�i�iii�
i�i"
i�i�	i�i�i�i�i�i�
ii�
i�i�i�
i�i�iQii�
iY
iii�i�ii�ii{iKi�i�i[iiJi�i�iNi�iS
i�i�i�i�iI	ii�iT
i@ii�
i�i�i�
i�i@iiRi�i�i�	it
i�ii�iJiIi�i�
i�i�i��i�
iU
i�imii�i�i{i�	i�i�	i
i;iV
i�ii�	ii�i<i�ii�
idi�i�i�iXi�i�i9i�i�i6i�i�iUi�i�i�i i�iLi!i=
i�i)i�i�
i	ii�i�i�	i�i�i�
ii=i$i(ivi�ii&i�ici�iii�i	i
i�i>i�i�i�i{i"i�i�i�i�i#i�i�i�i�iW
i�i�	i�i�i�i�	ii$i�
i%ii�i�i�i�i&i^i�i�i[	i�	i�i'ii�i�ii�i�i�i(i i�ii2i\	iJi
ipipin	iiu
iqi)i�i�	iOi>
i�i�
i*iX
i�i�i�	i+i�i�i,i�
i�i�i�
i�i�i�i�iKi�i
i		��iIi-i�i�i!i�i�i�i�i�i.iDi�i�iJisi#
i�i�i�
i�i7i�i�i�i/iwi�i|iii�i�i�i"i4	i|i,iii�i�i�	i�i�ii�iiii�i?iY
iPi0ii1iZ
iZ
i�
i�i�
i�	i�i�
i#i@i2ii|i�iziii�i�iAi'i�i?
i�i	i�i8i�i��yi�iLiVi
i3ii�	i�i$i�ii�iMi�i%i�ii�	i�
ii
i.ii4iNi�iiii�
i�	i�i�ii�i�
i5i9i%ii�i�iKiQii��xi6i7iiBi�i
	iOiv
i[
i�i�i&ii�
ii�
i�iiXi�i*i�i\
iPi�	i�
iNi+iw
iii�iiWiCi�ii�	iQiDii?i]
i�iii^
io	iRi	
i�iEii
iiFii'i�iXiiGiiSi�iiTiRii8ixi�	ikiSi�iTi�ii i�i�i�iDi�i9i!i�i�ii�i(iiLi"i#i$i%i_
i�i&iJi:iUi�i}ii)i�i

i;i<i
iEi+i'i�
i�iHi=iVi*iHiyi,i+iWi3i>i�i�i?i(iIi,i-i`
iqi�ia
ii�ii
i�i)i*iXi�	i+i�iO��iYi,i-i�i.i�i/i�i�i0i.i�i�i�i1i�
iJiri2i3i$
i	i4i�i5i6i7i�
i�ib
i�	i�i�i}i�	ifi�iKi�i�
i�
i�	i�	i8iZi9i�i:i�i�
ic
i�i:i�ii;isiJ	i@i�i�	iti;i�
i/i<id
ii�	i�i�iUi�i0i�ie
i=i�if
iuiMi�i�i�i�i�
i>i	i[iiAiLi�iii?i�	i
i�
i	i@iAiviBiCi\i�iji�i[
i�
ig
iDiEi�i�iFiiBi�iGi�
i�iHi�i(i�iMiCih
i�iIiNiJiiKiLi�i�iMi�i1i2iN�i�idiOidiViDi`i�i#i5	iPi]iQiEini
i�	i�i�i^iRi_iFiSip	ii
i�iTiUi�i

i�iVi�i�i�	i�iGi�i�i�ieiHiOi�	i�iPi`iWiwij
iXi ii3i�
iai�iIiYiJixi7iii�i-i�
i4ik
iibiZi-i�ii.ici�i[i�	iri;i�iKi5iLiXi�i i	i�i�i\i]i�i�i6i%
i^i_i�i�i~i`il
iyiaizi~i�i�ibi?i�ici7idi
i�i�iei�izi�i�iMifigi/ihi|i�i@idi�iiiiNi�i�i�i8ifi�i�ijiki�iOiPi�i�ilimi@ini9i�	ioi�i�	i�i�i<isii\
iQi.iRiNi@i�
i�ipiiSi{iqi�iAi�i�i�ii�iTi
i�i�i�i:i�i�iri�
isi@
iWi;itiui�iviwixiyi|i�i�i�i�izi�i�i3iQi�i�imi�iAi{i|i�i�	i�i}iOiRi�i�igiii~iZi�
ii�i�i�i�i�i\im
i�i}i�i<iXi�i�	i�i�	i�
i�i�i�i
i�iYi�i�i�i0i�i�i�i�i=i�	i�i�i�iLi�i�i�i�ihi�i�i�iii>i>i�i/i?iUi�i�i�i�i�iei)ix
�ti�ifiSi�i�
iy
i�
in
i
ii�iTii@i�i�i�i�i���i�i�i�i�i�	i�i�iziUigi�iVi�io
i�i�i6	ip
iti�i�i�i�i���i�
iAi�iJiVihiZi�	i�iWi�i�i�i�N)ZBIG5_TYPICAL_DISTRIBUTION_RATIOZBIG5_TABLE_SIZEZBIG5_CHAR_TO_FREQ_ORDER�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/chardet/big5freq.py�<module>+ssite-packages/pip/_vendor/chardet/__pycache__/escprober.cpython-38.pyc000064400000005044151446177000021756 0ustar00U

��.en�@sXddlmZddlmZddlmZmZmZddlm	Z	m
Z
mZmZGdd�de�Z
dS)�)�
CharSetProber)�CodingStateMachine)�LanguageFilter�ProbingState�MachineState)�HZ_SM_MODEL�ISO2022CN_SM_MODEL�ISO2022JP_SM_MODEL�ISO2022KR_SM_MODELcsVeZdZdZd�fdd�	Z�fdd�Zedd��Zed	d
��Zdd�Z	d
d�Z
�ZS)�EscCharSetProberz�
    This CharSetProber uses a "code scheme" approach for detecting encodings,
    whereby easily recognizable escape or shift sequences are relied on to
    identify these encodings.
    Ncs�tt|�j|d�g|_|jtj@rD|j�tt	��|j�tt
��|jtj@r`|j�tt��|jtj
@r||j�tt��d|_d|_d|_d|_|��dS)N)�lang_filter)�superr�__init__�	coding_smrrZCHINESE_SIMPLIFIED�appendrrrZJAPANESEr	ZKOREANr
�active_sm_count�_detected_charset�_detected_language�_state�reset)�selfr��	__class__��A/usr/lib/python3.8/site-packages/pip/_vendor/chardet/escprober.pyr*szEscCharSetProber.__init__csJtt|���|jD]}|sqd|_|��qt|j�|_d|_d|_dS)NT)	r
rrr�active�lenrrr)rrrrrr:s

zEscCharSetProber.resetcCs|jS�N�r�rrrr�charset_nameEszEscCharSetProber.charset_namecCs|jSr)rrrrr�languageIszEscCharSetProber.languagecCs|jr
dSdSdS)Ng�G�z��?grrrrr�get_confidenceMszEscCharSetProber.get_confidencecCs�|D]�}|jD]�}|r|jsq|�|�}|tjkrhd|_|jd8_|jdkr�tj|_|j	Sq|tj
krtj|_|��|_
|j|_|j	Sqq|j	S)NFr�)rrZ
next_staterZERRORrrZNOT_MEr�stateZITS_MEZFOUND_ITZget_coding_state_machinerr!r)rZbyte_str�crZcoding_staterrr�feedSs"






zEscCharSetProber.feed)N)�__name__�
__module__�__qualname__�__doc__rr�propertyr r!r"r&�
__classcell__rrrrr#s

rN)Z
charsetproberrZcodingstatemachinerZenumsrrrZescsmrrr	r
rrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/euckrfreq.cpython-38.pyc000064400000027372151446177000021771 0ustar00U

��.e�4�@sdZdZdZdS)g@�0	(0	�
��xiti�i�i�iHia��i�i�i�i+i��Wiui��hii]i�i�i�i�i�i�i�i�i�i�iviwi�i�i��imiFi!ipi�ii��i�i�i�i�ixi��/i�i�i�i�i�i�i�i9ii�i��ti�i-iyi��Ki��i�i�i�i��iOi�ini�i�i�i�i�ii0�i��<i4�{i�i�i�i�i�iii�iri�i�i�i�i�i�i�i�i�i�i�iXiXi�i�i�i��Yi�i�i&i�iPi�i�i�i�i�i�i�i^i���i�i�i�i�i�i9i�i�i�i�i�i�iQi�i"�it�i��i�ii]i{i7i��i�i{i�i;i�iui�izi/i�i|��i�i�i�i7i�i�i.i�i�i�i�ii�ii�iiiiii{iiii#i|i}i�i~i�iti8ii_i	i
iii
i!iiii_ii�i�i�iii*i�iuii`i"i�ii|iii�i�iiiaiiiiiii?iiRi!i i/i�i�i!i"i=i�i�i#i�i$i%i&i'i(i)i,i�i'ibi$i*i�i+i�i-i�i,i�ii�i�i�i&iUi�i�i#ii�i-i.�'ii�ifi/isi�i0i�i�iii�i i�i9ie�[i1i�i�iiZi�i�i:i�i�i�i2i3i�iGii�i�yi4i�i�i�i5i6i7i,�wi�i�isi8i���i9i:ii�i~i;ii<i;i}i=i>i?ioi)i�i�i@i�iAiBi�i�i2iYiCiDi�i<iEiFiGiHiIi%iJiKiLiMiNiOi�`i>iPi�i=iQi�iRi�iSiTi;i�i�i�i�iiUi�iViWiXi4iY�iiZi[i�i\i]�ii^i�i�i_�"iPi�i�i`i;i�i~iHia�ivi��zi?ii�i�ibi�i�i<icid�dieific�0i�idiigiyi�i�ihii�si0iji=iki�ili�i�i�i<ibi�i��Uii�ii�iIiminioiipiqirisitiu�i�i�i�i6iviwi�i*i��]ixiyi�i�iziZi��-�:�ibi
i{i|�i&i'i�i�i5i�i�ii>i}i~iwiigi�i�i�i6i�i%i�i��(i��vi��i�iwi�i��i��Ei�i�i�i�i�i�i�i�i�if��iVi�i7i�i�i�i�iBi��Ni�i[i�i'i�i�i�i�i�i���iSi�i�i�i�i�iei�iixi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i?i�i�ii�iqi�ifi�i(i)i�i�i~i�i\i�i�i�i�i�i)ii�i�ii�ii�i�i�i�i��$i��i��i�i�ili�i�i�i�~i�i�iC�i�ii�i@i�i�i�i�i��2i���iKiiziVii�����iQirifiii��i ihi+i3ii1�ii�i�i���gi(i�i�i�izi�i�i�i�i�i�i�i�i�i�i�i���i�i�i�i�iA�i<ijii�iMigi�i2i�i�i�i�i�i�i�i�i�iVihii�iJi�i�i0��i�b��i�i�ii�i�i��iY�i�i��i���ai!�*�i���i�i�iKiDi8iiRiiB�i@i�i�i�ii�i�i�iyi�i�i�i�iiXi:i�i�i#i�i�i�iii��Gi�i�iki�i�i=i�i��i��!i�i�i��J��i��=�i�i�i}i�iijii�i�i�i�i�i�i�i�i�i�i�iEi�i�i�i��ijiO�4i��i�i�i�i�i�i�i�i	ivi]i�iCi�i�i�i�i�i�i�ioi�i��i�i
i�i��iliciAi�i�i�i�i�i�i�i�i�Ti�i�ik�����i�i�i�i3i*i��qi���i>i�ii�i�i�ii+iiiii�;i��piixii��i�iiii�i�i	i�i
ii�ii
i�i���iliii�i�ii�)��i��imi8i�iiDii�iiiiii�ii�ii�7iL�Bi�iiDii�ii�i�itiiii i!i
i"i#i$i%iRi&i'i(i)i*�i+i,�i,i-i.�mi�i
i^i/ici�iEi�i�i�iaimi0iEi1i2i3ii�i�i4iTi�i�i�i5i�ii�i�i6i7iini�i�ioi8i9iFi�i�i�i:iGi;i<i=i>i?i@iAiBiCiDiEi$iFiGi�i�i%i�i�ipiHiIiJiKiLi�i�ii�i�i�i�iMiNiOiPiQiR�i�iSi/iTi�iUi�iiiVi��IiH��ii�i�i�iWi�iX�iqiYiZi[i\i�iri�isi]i^i_i`�iviLia�i��.i�ibiFi>i�i��jic�Zi�i�iBi6i�i`idieii��|iifi�i�i5igi�ihi�ii�H�iji�i�iki�ili�i1iminioipiqiriCisitiuiviwi�ixiyizi{i�i�i|i}i~ii�i�i��iii�iOi�i�i�i�i�i�ii�i�i�i�i�iEi�i�iqi�iiIi�i\i�i-i�i�iSi�i�i��
i�iei�i�i��li�iM���Qi�Piii^ii
i-iFi�i�i�ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i
i.i�iti�i�i�i�iJi�i�i�i�i�i�i�igi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ii�i���i�i�iui�i�i�i9i	i�i�i�i	i�i$i�i�i�i�i�5i%�ik�L�i�ii�i�i�i�ii�i�iAi�i�i�i�i�i�i�i�i��R�iui�i�i�ii�i)i�i�i:i�i�i��i���i�i"i$ivi�i���ciZ�i�i�i�i��i*iWiiKi�iLi��+�i���i�i�i�ii�i	iB��i�i?i��i�ii�i�i�i��iMi[i5i�i�i�ini���i�i�i��Ci�i'i�i�i�i�i�i�i�i�i
i�i�i�i	i�ii�i�i�i�i��FiTi/i�i�i�i���8i��ui�i�i�iKi�i(iM�i�ii�i�i�i�i��i�ii�i�iTi��?i��i�i�ii�i�ei i(i�i�i�i�i�i��%i0��i��Oi�i	i8i	i	i	i	i	i��ii	i	i	�i��#���i		i����Vi
�iiPi� �MiWi�i
	ii	i�i|i	i
	�Si��i�ii�i�i�i	i	i�i�i	i	i	i	i	i	i�i	i	��9�Dii���i��i	�3i�i�i	i	i	i{i	ii�i	i	i	i�i 	i��i�ii�i!	iki�i��i�iN��iYi�i"	i#	i$	i%	i&	i'	i(	i]i)	i*	i+	i,	i-	i.	i�i/	i�i��>i���ri1	i�i�i��i\i�i2	i�i3	i�i�i4	i5	i6	iwi7	i�i8	i�i3ii�i�i9	i:	iL����i;	��i<	i�ii�ii�i�ii�i�i�i=	i�iJi>	i?	i@	i�iA	��iB	iC	iD	i�iE	i�i�iF	iG	iH	iI	i�i�i�i�i�i�iJ	iK	ii�iL	iM	iN	iiIiO	iP	i�iQ	iR	iS	i�iT	i�iU	iV	iW	iX	i�iY	iZ	i[	i\	i]	i�i�i^	i_	i`	ia	i�iib	ic	id	ie	ii�if	ig	iUi�ixi ih	i�i�ii	ij	�ii�i4i&��i�i�i!i���i�iSiyii�i�i"i
i�i#ik	i�il	im	in	�i�i�ipiQi�i.io	iU�iOi�ip	i�iq	ir	is	ixit	i�iu	iv	iw	iii$ix	i�iy	i�i`iz	i{	i|	i}	��i~	i	i�	i�	i�	i�	i�	i�	��iCi��i�i�i%iyi�iioi�	i�i�	i�	i�	i�	i�	i�	i�i�	i�	i�	i�	i�i�i�	i�i�i�	i�	i�@i�i�i�	iGi�	i�i�ii2��i�i�i�i�	i�	i�	i�	iNi�	ii�i�i�i�i�	i�	i�	i�	i�	�ri�	i�izin�i�i�iPi�	i#i�	i&iQi�	i�imi�	ici�i�i�	i'i�	iwi�	i�	��i(ili@i�i�i�i)i�i*i�	i�	i�	i�	i�i�	i�	i�	i�	i�i�i�	i�i�i�	i�	i�	iHi�i�	i�	ii�	ii�i�	i�	i�	i�i�	i�	iri�	ii��Ai�	i���i�i�i�	�}i,i�i�i:i�ii��i
iiIi�	iNi�i1i�	iW����i�i�i�i�i�i�	i+i�	i�	�1i�ibi�i�	iqi�	i,i�	i��iei�i��_iidi�	i�	i�	i�	i�	i�	�i�i2i�i�i�i�	�i�	i�	i�	i�	ii�	i�i�	i�	i�i-i�	i�i�i�	i�	i�	i�	i�	i�	i�i�	i�	i�	i�	i�	i�	i�i�	i�i�	i�	���i7i�	i�i�	ii�	i�	i�	i�	i�	i�	i�	��i�i�i�i�i�i����,iGi�ii�i�	i�i^i�	i�	i.i�	�igi�i�	i�i�	i�	i�	i�i�i�	ii�ii_i�i�	i�	i�	i��ihihii{i�	i|i�i��i3i�	i�	i�	i�i�i�	i
i
�\ii�i�ii
i
i
i
i
i
i
�i	
i

i
i
ii�i�i
iji
iii�i4ii
i
i
i
i
i
i��i
i
i
i
i��6id��i/i
i
ii�i��oi
i�iRi��i��	�&i
�k�niz���i�i�i
i�i
i����Xi�idiiSi�i}i
i}ii�i~i�i�ii�i 
i!
iNi"
i�i��i�i�i�i#
i��isi$
i%
i&
�fiDii1i'
i�ii(
i@i)
�^���i�i*
i�i+
i,
i-
i.
i/
iJi+i0
i1
i2
i�iTi�i3
i4
i5
i6
��i7
iAi.i�i�i�i8
i9
ii"i:
i;
i�i<
i=
i>
ii�i0i?
i�i@
iiA
iB
iiC
iD
iE
iF
iG
i�i�i_i[iH
iI
i�ii`iaiJ
i�ii�i�iK
iL
iM
iN
�iO
i�iiiiiiP
iQ
iR
N)Z EUCKR_TYPICAL_DISTRIBUTION_RATIOZEUCKR_TABLE_SIZEZEUCKR_CHAR_TO_FREQ_ORDER�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euckrfreq.py�<module>)ssite-packages/pip/_vendor/chardet/__pycache__/langgreekmodel.cpython-38.opt-1.pyc000064400000056001151446177000023710 0ustar00U

��.e�1�@s4dZdZdZeeddddd�Zeeddddd�Zd	S)
(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr�R�d�h�^�b�e�t�f�o��u�\�X�q�U�O�v�i�S�C�r�w�_�c�m�rrrrrr�H�F�P�Q�<�`�]�Y�D�x�a�M�V�E�7�N�s�A�B�:�L�j�g�W�k�prrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr���Zrrrrrrrrrr�Jrrrrrr���=�$�.�G�Ir�6r�l�{�n��3�+�)�"�[�(�4�/�,�5�&�1�;�'�#�0��%�!�-�8�2�T�9r(�y�����|������ �
�����
����	��������*��@�K���r(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr9r>rrrrrrrrrrr;rrrrrrr<rrr?r@rArBrrCrrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r(r`rarbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtrurvrwrxryrzr{r|r}r~rr�r�r�r�r(�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjryryrjrjrjrjrjrjrjrjrfrjrjrjr�ryryrjrjr�rjr�rjryr�rjrjrjr�rjr�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjr�rjrjr�rjryrjrjr�rjryrjrjrjr�r�rjr�rjr�rjrjryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�ryrjryryrjrjrjrjrjrjrjrjr�rjrjrjrjr�ryrjrjr�rjrjrjrjryrjrjrjr�ryr�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrjrjryrjrjrjrjrjrjrjrjrjrjrjrjr�ryrfrjrjrjrjryrjrjryrjrjryr�r�r�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjr�rjrjrjrjrjrjr�rjrjr�rjrjrjrjrjrjrjrjrjrjr�rjryrjrjr�ryr�rfr�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�rjrjrjrjrjryrjr�r�r�r�rjrjr�rjrfrjrjrjr�rjrjr�rjrjrjrjr�r�r�r�ryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjr�rjr�rjrjrjrjrjr�rjryryryrjr�ryrjrjrjrjrjryrjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjrjryryryrjrjrjrjr�rjrfrjrjrjrjryrjrjrjrjrjrjrjryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjryr�rjr�r�r�rjrjryrjrjrjrjrjr�r�rjryrjr�ryrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjrjr�r�rjrjr�ryrjr�rjr�rjrjrjr�r�rjr�rjr�ryryrjrjr�r�r�r�rfr�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjryr�rjryrjrjrjrjr�rjrjrjrjrjr�rjrjryrjryrjrjryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjryrjryrjrjrjrjrjrjr�ryrjryrjryryryrjryrjrjryrjr�ryryryrjr�ryr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�r�rjrjrjryrjrjr�r�rjr�rjr�r�r�rjryr�rjr�rjr�r�ryr�ryr�r�r�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjr�rjrjrjrjrjrjr�rjrjr�rjr�r�r�rjrjr�rjrjrjr�r�rfryrjr�rjr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjryr�r�rjryryrjrjr�rjrjrjrjrjryrfrjr�rjryrjrjryrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjr�ryrjrjrjrjrjrjr�r�rjr�rjr�r�r�rjrjr�rjryrjr�r�rjrjrjr�rjr�r�r�ryr�r�r�r�r�rjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjr�rjrjrjrjrjrjr�r�rjr�rjr�r�r�rjryr�rjryrjr�r�rjryrjr�ryr�r�r�r�r�r�r�r�r�rjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrfryryrjrjrjrjrjrjr�ryrjr�rjr�r�r�rjrjr�rjr�ryr�r�ryrjrfr�ryr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjrjr�rjr�rjrjryrjr�rjrjrjrjrjrjr�rjrjrjr�ryrjr�r�rjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjr�r�rjr�r�r�rjrjr�rjr�ryrjrjr�r�rjr�rjr�rjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�r�rjrjrjrjrjrjr�r�rjr�ryr�r�r�rjrjr�rjr�rjr�r�ryr�ryr�r�r�r�r�rfr�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjrjr�rjr�ryr�rjryr�rjryrjryrjr�r�rjryrjryrjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�ryrjrjrjrjrjr�r�r�rjr�ryrfr�r�rjryryryr�rjr�r�ryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjryr�rjr�rjr�rjrjr�ryrfryrjrjr�r�rjr�rjr�rjrjr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrjrjrjr�rjrjrjrjrjrjr�ryrjr�rjr�r�r�ryrfr�ryryrjr�r�ryryryr�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�ryrjrjrjryrjr�r�rfrjr�ryr�r�r�r�rjr�rfr�ryr�r�rfrfrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjrjrfr�rjr�r�r�rjryr�rjryrjrjrjr�r�rjr�rjryryryrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�rjrjrjr�r�rjr�r�r�r�ryr�ryrjrjryryryryrjr�ryr�ryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjrjrjrjryr�r�r�r�r�r�ryrjr�ryr�ryrjryr�r�rjr�rjr�rjrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjryrjrjryryrjr�ryr�rjr�r�r�ryr�r�r�r�rfryr�ryr�ryr�r�ryr�ryr�ryryr�r�rfr�ryryryr�ryryryr�ryryryr�r�ryr�r�rfr�r�r�r�r�ryr�rjrjryr�r�r�r�r�r�rfrjr�ryr�ryryryr�r�ryr�rjr�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�ryrjryr�ryryr�ryr�ryryr�ryr�ryryryr�r�r�r�r�r�ryrjr�r�r�ryr�rfryr�r�r�r�ryryr�r�r�ryrfr�ryryr�r�r�r�r�r�rfr�ryr�r�r�r�r�r�r�r�ryrfr�ryrjryryrjryrjryr�r�rjrjrjr�r�rjryr�r�r�rfrfr�ryr�ryryr�ryr�ryr�ryryr�r�ryr�ryryryr�ryryryryr�r�ryr�r�r�ryr�rfr�r�r�r�r�rjr�rjrjryryr�rjr�r�r�ryryr�ryryryrfryr�r�rfryryr�r�rjr�r�r�ryr�rfryr�r�r�rfryr�r�r�r�r�r�r�ryryr�rfr�r�ryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrjrjryryr�r�r�ryr�ryrjrjr�ryr�r�r�r�r�r�ryryryr�ryryr�ryr�ryr�ryryr�r�ryryryryrfr�r�ryryr�ryr�r�ryr�r�r�r�r�r�ryr�r�r�r�r�r�r�ryr�rjryrjr�r�r�rjr�r�ryryr�ryr�ryryryr�r�ryr�r�r�r�r�r�r�r�ryr�r�ryryr�r�ryryryr�r�r�r�r�r�ryr�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�rjryr�ryryryryryr�r�r�ryr�r�r�r�ryr�rfr�r�ryr�rfr�r�r�r�ryryryr�ryryr�rfryr�ryryryr�ryryryryrfryryr�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�ryr�ryr�ryryr�r�r�r�rfryrfr�r�ryryr�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�rjryrjr�r�ryr�r�r�ryryr�ryr�r�r�rfr�r�ryr�ryr�ryryr�r�r�r�r�r�ryr�r�r�r�ryryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�ryryrjryryr�r�r�r�r�r�rfrjr�ryr�ryryr�r�r�rfr�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�ryr�rjryr�ryr�r�r�r�r�r�ryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�ryr�r�r�r�rfrfr�r�ryrfryr�ryryr�rfr�r�rfr�r�r�ryr�r�r�r�r�r�r�rjr�ryryryr�r�ryr�r�r�ryr�r�r�ryrjr�ryr�r�r�r�r�r�ryryr�r�r�ryr�rfryr�r�r�rfryryrfr�r�r�ryr�r�ryr�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rjr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrfryr�ryryr�ryr�r�ryr�r�r�r�rfryrfr�ryrfr�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�rjrfryryr�ryr�r�r�r�ryr�r�r�ryr�r�rjr�r�r�r�ryryryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrfr�ryr�rfryr�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�rfr�r�r�r�r�r�ryr�ryryr�r�ryryryryryr�rfryr�r�r�ryryr�rfr�ryr�r�ryryr�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�rjr�r�ryr�r�r�r�r�r�r�r�ryr�ryr�r�r�r�ryr�rfryr�r�r�r�ryryrfr�rfr�rfr�ryryryrfr�r�r�r�r�r�rfr�r�r�r�r�r�r�ryr�rfryr�r�r�r�r�r�r�r�r�r�ryr�r�ryryr�r�r�r�rfr�r�r�r�r�r�ryr�ryryr�r�r�r�ryryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�ryr�r�ryr�r�r�r�ryryryryr�r�r�rjr�r�r�r�r�r�r�r�ryr�r�r�r�r�r�ryr�r�r�r�r�r�rfr�r�ryr�r�r�r�rfryr�r�r�r�r�r�ryryrfrfr�r�r�r�r�r�rfr�r�r�r�r�r�r�ryr�ryryryr�r�ryr�r�r�r�r�r�r�ryryryr�r�r�ryr�r�r�r�r�r�r�r�ryr�r�rfr�r�r�r�ryrfr�r�r�r�r�r�rfr�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�rjr�ryr�r�r�r�r�r�r�r�ryr�r�r�r�r�ryr�r�r�r�r�r�r�ryr�r�r�r�ryr�r�ryr�r�r�r�ryryr�r�r�r�rfr�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�ryryrfr�r�r�r�r�r�ryr�r�ryr�ryryryr�r�r�r�r�r�ryr�r�r�r�ryr�r�ryr�r�ryr�ryryr�r�r�r�ryr�ryr�r�r�r�r�ryr�r�r�ryr�r�r�r�r�r�r�r�rjr�r�r�ryryr�ryryr�r�r�r�r�ryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�ryr�r�r�r�r�r�ryryryryryr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�rfrfr�r�r�rfr�r�r�r�r�r�r�ryrfr�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryryr�r�r�r�r�ryr�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�ryr�r�r�ryr�r�r�r�r�rfr�r�r�r�ryryr�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�rfr�ryr�r�r�r�ryr�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�ryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�rfrfr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�r�r�r�r�r�r�r�r�r�rfr�r�r�r�rfr�r�ryr�ryr�r�r�r�r�r�r�r�r�r�r�ryrfr�r�r�r�r�r�ryr�r�r�rfryr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g���s�?Fz
ISO-8859-7ZGreek)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1253N)ZLatin7_char_to_order_mapZwin1253_char_to_order_mapZGreekLangModelZLatin7GreekModelZWin1253GreekModel�r�r��F/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langgreekmodel.py�<module>"s"�
�site-packages/pip/_vendor/chardet/__pycache__/langhungarianmodel.cpython-38.opt-1.pyc000064400000056040151446177000024572 0ustar00U

��.e01�@s4dZdZdZeeddddd�Zeeddddd�Zd	S)
(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr��(�6�-� �2�1�&�'�5�$�)�"�#�/�.�G�+�!�%�9�0�@�D�7�4rrrrrr���������	����
����C�
�����A�>��rrrrr��������������������������������������������K�����������������O���������������������������������3�Q���N���������,�������=�����������:���B�;�������<�E�?�������R��J���F�P���H����S�M�T��L�U�����I�*������8��rr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrr�rrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr;r<r=r>r?r@rArBrCrDrErFrGrHrIrJrKrLrMrNr}rOr�rPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_r�rarbrcrdrerfrgrhr{rjrkrlrmrnrorprqrrrsrtrurvrwrxryrzr�r|r�r~rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r`r�rr�r�r�r�r�r�ri�Vr�r��Wr�r�r�r�r�r�r�r�r�r�r�r�r�r�rr(�r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r#r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2rr2r2r2r2r2r2r2r2rrr2r2r#r#rrrrrr#rr2rrr2r2r2r2r2rr2r2r2r2r2r2r#rr2r2r2r2rr2r2r#r#r2r2r�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r2rr#r2r2r2r2r2rr2r2r2r2r2r#r#rr2r2r2r2r2r2r2r#r#r2rr�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r2r2r2r2r2r2r2r2r2r2r2r#r#rr2r2r2r#r2r2r2r2r2r#r2r2rrr�r2rr2r�r�r�r�r�r�r�r�r�r�r2r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r2r2r2r2r2r2rr2r2r2rr2r2rr2r2r2r2r2rr2r2rrr2rr2rr�r2rrr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r#r�r2r2r2r2r2r2rr2r2r2r2r2rr2r2r2r#rr2rrr2r#rr2r2rrr�r2r2r2r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r2r2r2r2r2r2r2rrr2r2r2r2r2r2rr2r2r2r2rr2r2r2r2r�rr2rr�r�r�r#r#r�r�r�r�r�r2r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r2r2r2r2r2r2r2r2r#r#r#r2r2rr#r2rrr2rr#r2rrr#r�r2r2r#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2rrr2r2r2r2r2r#rr2r2r2r2r#rr#r2r2r2r2rrr2r#r#r2rr�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r2r2r2r2r2r2r2r2rrr2r2r2r2r2rr#r2r2r2r2r2rrr#r2r2r2r�r#r#rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r#r�r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2r2rr2r2r2rr2r2rr2r2r2rr�r2rr2r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r#r�r2r2r2r2r2r2rr2r2r2rr2rr2r2r2r#r2rrrr2r#r#r2r2r#r#r�r2r2rr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r2r2r2r2rr2r2r2rr2rr2r2r2rr2r2r2r2r2r#rr2rrr�rrrr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2rrrr2r#r2r2rrr#r2r2r2r#r#r2r#rr2rr2rrrr#r�rrrr�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r2r#r#r2r2r2r2r2r#rr2r2r2r2r#rr#r2r2r2rrr2rr#r�r2rr�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#r#r2r2r2r2r2r#rr2r2r2r2r#r#r�r2r2r2r2r�rr2r�r�rr#r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r2r2r2r2r2rrr2r2rrrrr2r2r�r#rr2rr2rrr2rr#rr�rrrr�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r2r2r2r2r2r2r#rr2r2r2rr#rr2r2rrrr2rr2r2r#r2r2r#r#r�rr2rr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r#rrrrr2r2r2r#r#r#r2r2r#r#r2r#r#r2rr#rr2r#r#r�rrrr�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2rr#rr#r#r2r2r#r#r#r#r2r2r#r#rrr#rr#r#rrr#r#r�rrr#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2r#r#rr#r#r2r2r#r�r#r#r2r2rr�r#r#rr2r#r�rrr#r�r�r#r2rr�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2rr#r2r2r2r2r2r#rr2rr2r2rr#r#r2rr2rr#rrr�r#rr#r�r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r2r2r2r2rrrrr2r#rrr#r#r2r2r�r2rr#rr2rr#r2r2r#r#r�rr#r2r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r2r2rrrr2rr2r2r2rr#r#r2r2r#r#r#rrr2rr2rrrr#r�rrr#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r#r�r�r2r2r2r2r2r�r�r2r2rr2r�r�r�rr2r2r#r�r#rr�r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#rr2r2r2r2r2r#rr2r2rrr#r#r�r2r2rrr#rrr#r�rrr�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r2rrr#r2r#rr2r2rrr#r#rrr#r#r#r#r2rr#r#r#r#rr#r�r#rr#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r#r�r�r�r�r�r�r�r�r�rr2r2r#r#r#r#r#r2r2r2r�r#r#r2r2r#r#r#r#r#rrr�r2r#r#rr�rr#r#r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r�r2r#r�r#rr#rrr�r#rr2r#rr�r�r�rr#r#r#r#r#rr�r�r#r#r�r�r�r�r#rr#rrrr#rr#rr�rr�rrr#r#rr#r#rr#r#r#r�r#r�r�r�r#r#r�r#r#r#rr2rr2r2r�r#rrr2r#r�r#r�rr#rrr�r#r#r�r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r2r2rrr#r�r�r2rr2rr�r�r�r#r#r2r�r�r#r#r�r�rr#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#r#rrr2r2r#r�r#r2rr2r#r#r#r�r#r#r#r#r#r2r#r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r#r#r#rrrr#r�r#rr2r2rr�r�r�rr#r#r#rr#r#r#r�r#r#r#r�r�r�r#rrrrrr#r#r#rr�rr#r#r#r#r#rr#r#r#r#r#r#r�r#r#r#r�r�r#r#r2rrr#r�r�r#r#rrr�r2r�r#rr#r#r�r�r#r#r#r�r#r#r#r#r�rr#r#r#rrr#r#r#rr#rr#r#r#r#r#r#r#rr#r#r#rr2r#r#r#r#r#r#r#r#r#r�r#rr2r2r�r#r�r�r�r2r2r#r�r�r#rrr#r�r�r�r�rr�r�r#r#r#r�rr#r#r#rr#r#r#r#r#r#rr#r#r�r#r#r�r#r#r#r�r#rr#r#r�r#r#r#r#r#r#r#r�r#rr2r2r�r#r�r�r�rrr�r�r�r�r#rrr�r�r�r�r#r�r�r#r#r�r�rr�r#r�rr#r#r#r#rr#r#r#r#r#r#r#rr#r#r#r#r#r#r#r#r#rr�r#r#r#r#r#r�r#r2rrr�r#r�r#r�rr2rr�r�r#rrr#r�r�r#r#r#r�r�rr#r�r#rrr#r#rr#r#r#r#r#r#rr#r#r#r#r#r#r�rr#r�r#r#r�r#r#r#r�r#r#rr#r#r�r#rrrr�r�r#r�r�rrr#r#r�r�rr#r#r�r�r�r#rr�r�rr#r�r�rr#r#r#rr#r#r#r#rr#rr#r#r#rrr#r#rr#r#r#rr#r#r#r#r#r#r#r#r#r#r�r#r#rr2r�r�r�r#r�r2rr#r�r�r#rr#r#r�r�r�r�rr#r�r#r#r�r�rr#rr#r#r#r�r�r�r#r�r#r#r#r#r#rr�r�r#r�r�r�rr�r�r#r#r#r#r#r#r#r#r�r#r2r�r�rr#rrr#r�r�rr#rrr�r�r�rr#r#r#r�r#r#r�r�r#r#rr�r�r�r#rr#rrr#r#rr#rr�r#r#r#r#r#r#r#r#r#rr#r#r�r�r#r#r#r#r�r�r#r#r2rr�r�r�r#r�rrrr�r�r�rrr#r�r�r�r�r2r#r#r#r#r�r�rr#r#r#rr#r�r#r#r#r�r#r#r#r#r#r#r#r�rr#r�r�r#r�r#r#r�r#r#r#r#r#r#r�r#rr2rr�r�r�r#r�rrr�r�r�r�rr#r#r�r�r�r�rr#r�r#r#r�r�rr#r#r�rr#r#r#r#rr#rr#rr�r#r#r#r�rr#r#r#rr#r#r#r#r�r#r#r#r#r#r�r#r2r#r#rrrr2rr#r#rrr#r#r�r#r�rrr#r#r#r#r#r�r�r#r#r�r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrr�r�r�r�r�rrr�r�r�r�rrr#r�r�r�r#r#r�r�r#rr�r�rr#r#r#rrr#r#r#rr#rr#r#r�r#r#r#r#rr#r#r#rr#r#r#r#r�r#rr#r#r#r�r#r#r�r�r#rr2rr#r�r�rr�r#r#r�r�r�r#r#r#r#r�r#r#r�r�r#r�r�r�r�r�r#rr#rr#rr#r#r#rr�rr#r#r#r�r#rr�r�r#r#r#r�r�r�r�r�r�r�r�r�rr2rr�r�r�r�r�r#r#rr#r�r�r#r#r#r�r�r�r�rr�r�r#r#r�r�rr#r#r#rr#r#r#r#r#r#rr#r�r#r#r#r#r�rr#r#r#r#r#r#r�r#r�r#r#r#r#r#r�r#r#rrr�r#r#r#r�rrrr�r�r�r2rr#r�r�r�r#r#r�r�r#r#r�r#r#r#r�r�r#r#r�r#r#r#r#r#r#r#r#rr#r#r#r#r#r#r#rr#r#r#r�r�r#r#r#r�r#r�r#rr#r�rr#r#rrr#r#rr#r#r#r�r�r�r#r#r�r#r#r#r#r�r�r#r#r#r�r�r�r#rrrrrr#r#r#rr�rr#r#r#r#r#r#r#r#r#r#r#r#r�r#r#r�r�r�r#r�r#rr2r�r�r�r#r�rrr�r�r�r�rrr�r�r�r�r�r#r�r�r#r�r�r�rr�r#r�rr#r#r#r#r#r�rr�r�r�r#rr#r#r#r#r�r#rr�r#r�r#r�r#r#r#r�r#r�r#rrrr�r�r�r#r�rr#rr�r�r�r#r#rr�r�r�r�r#r�r�r#r#r�r�rr#r�r#rr#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#r#rr�r#r#r#r#r#r�r#r#rrr�r�r�r#r�rrrr�r�r�r#r#r�r�r�r�r�r#r#r�rr�r�r#r#r#r�r#r#r�r#r#r#r#r#r#r�r#r#r#r#r�r�r#r�r�r#r#r�r#r�r#r#r#r#r#r�r�r�r#r#r�r�r#r�r#rr#r�r�r#r#r#rr�r�r�r#r#r�r#r�r#r#r�r�r#r�r�r�r�r�r�rr#rr#r#r#r#r#rr�rr�r#r#r�r#rr#r�r#r#r#r�r�r�r�r�r�r#r�r�rr#r#r�r#rr�r�r#r#r#r�r�r�r#r#r�r�r�r�r�r#r�r�r#r�r�r�rr#r�r#rrr#r#r#r#r#rr#r#r�r#r#r#r#rr#r#r#rr#r#r�r#r�r#r#r#r#r#r�r#r#rrr�r�r�r�r�r#r#r�r�r�r�rr#r�r�r�r�r�rr�r�rrr�r�rr�r�r#rr#r#r#r#r#r#r#r�r#r#r�r#r#r�r#r�r�r�r#r#r#r#r�r�r#r#r#r#r�r�r#r#r#rr�r�r2r#r�rr#r#r#r�r�r#r#r#r�r�r�r#r#r�r�r�r#r�r�r#r�r#r�r#rr#r�r#r#r#rr#r#r�r#r#r#r#r#r�r�r�r#r#r#r#r#r�r#r�r�r�r#r�r�rr#r#r�r�r�r�r�r#r�r�r�r�r�r�r�r�r#r�r#r�r�r�r#r�r�r�r�rr�r�r�rr#r#r#r#r#r#r#r#r#r�r#r#r#r#r#r#r#r#r#rr#r#r�r�r#r#r#r#r#r�r#rr#r#r#rr#r#r#r�r#r#rr#r�r�r�r�r#r#r#r#r�r#r�r�r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r#r�r#r#r#r#r#r�r�r#r#rr#r�r�r�r#r#r�r�r�r#r#r�r�r#r�r#r�r�r�r#rr#r#r#r#r#r#r#r#r�r#r�r#r#r#r#r#r#r�r#r#r#r�r�r�r�r�r�r#r�r�rr�r�r�r#r#r#r#r�r�r#r#r�r�r�r�r�r#r#r#rr�r�r#r�r�r#r�r#r�r�r�r�r#r#r#r#r#r#r#r#rr�r#r#r#r#r�r#r#r#r�r#r#r#r�r�r�r�r�r�r�r�r�r#r�r�r#r#r#r#r#r�r�rr#r�r#r�r�r�r#r�r#r�r�r�r�r�r�r#r�r�r�r�r�r�r#r#r#r#r#r#r�r#r#r�r#r�r#r#r�r#r#r�r�r#r#r#r�r�r�r�r�r�r�r�r�r#r�r�r#r#r#r�r�r�r�r#r�rr�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r#r#r#r#r#r�r�r#r#r�r#r�r#r�r�r#r#r#r�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r�r�r�r�r#r#rr#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r#r#r�r#r�r�r#r#r�r#r�r#r#r�r#r#r#r�r#r#r#r�r�r�r�r�r�r�r�r�rr#r#r#r#r#r#r#r#r#r#r�r�r#r#r#r�r�r#r�r�r#r�r#r�r#r#r#r�r�r#r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r#r�r�r#r#r#r#r�r�r�r#r#r#r�r�r�r�r#r#r#r�r�r�r�r�r�r�r�r�r�r�r�r�r#r#r#r#r#r#r�r#r#r�r#r�r#r�r�r#r#r�r�r#r#r�r�r�r�r�r�r�r�r�r�g��(��P�?Tz
ISO-8859-2Z	Hungarian)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1250N)ZLatin2_HungarianCharToOrderMapZwin1250HungarianCharToOrderMapZHungarianLangModelZLatin2HungarianModelZWin1250HungarianModel�r�r��J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langhungarianmodel.py�<module>"s"�
�site-packages/pip/_vendor/chardet/__pycache__/sbcharsetprober.cpython-38.opt-1.pyc000064400000005646151446177000024131 0ustar00U

��.e�@s4ddlmZddlmZmZmZGdd�de�ZdS)�)�
CharSetProber)�CharacterCategory�ProbingState�SequenceLikelihoodcsbeZdZdZdZdZdZd�fdd�	Z�fd	d
�Ze	dd��Z
e	d
d��Zdd�Zdd�Z
�ZS)�SingleByteCharSetProber�@igffffff�?g�������?FNcsJtt|���||_||_||_d|_d|_d|_d|_	d|_
|��dS)N)�superr�__init__�_model�	_reversed�_name_prober�_last_order�
_seq_counters�_total_seqs�_total_char�
_freq_char�reset)�self�model�reversedZname_prober��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/sbcharsetprober.pyr	'sz SingleByteCharSetProber.__init__cs:tt|���d|_dgt��|_d|_d|_d|_	dS)N��)
rrrr
rZget_num_categoriesrrrr�rrrrr5szSingleByteCharSetProber.resetcCs|jr|jjS|jdSdS)N�charset_name)rrr
rrrrr?sz$SingleByteCharSetProber.charset_namecCs|jr|jjS|j�d�SdS)N�language)rrr
�getrrrrrFsz SingleByteCharSetProber.languagec	Csj|jds|�|�}|s|jS|jd}t|�D]�\}}||}|tjkrX|jd7_||jkr�|jd7_|j	|jkr�|j
d7_
|js�|j	|j|}|jd|}n||j|j	}|jd|}|j|d7<||_	q0|jd}|jt
jk�rd|j
|jk�rd|��}||jk�r<|j�d||�t
j|_n(||jk�rd|j�d|||j�t
j|_|jS)NZkeep_english_letter�char_to_order_maprZprecedence_matrixrz$%s confidence = %s, we have a winnerz9%s confidence = %s, below negative shortcut threshhold %s)r
Zfilter_international_words�state�	enumeraterZCONTROLr�SAMPLE_SIZErr
rrrrZ	DETECTING�SB_ENOUGH_REL_THRESHOLD�get_confidence�POSITIVE_SHORTCUT_THRESHOLDZlogger�debugZFOUND_ITZ_state�NEGATIVE_SHORTCUT_THRESHOLDZNOT_ME)	rZbyte_strr �i�c�orderrrZ
confidencerrr�feedMsL





�
�zSingleByteCharSetProber.feedcCsNd}|jdkrJd|jtj|j|jd}||j|j}|dkrJd}|S)Ng{�G�z�?rg�?Ztypical_positive_ratiog�G�z��?)rrrZPOSITIVEr
rr)r�rrrrr%|s
��z&SingleByteCharSetProber.get_confidence)FN)�__name__�
__module__�__qualname__r#r$r&r(r	r�propertyrrr,r%�
__classcell__rrrrr!s


/rN)Z
charsetproberrZenumsrrrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/langturkishmodel.cpython-38.opt-1.pyc000064400000053246151446177000024314 0ustar00U

��.e^+�@sdZdZeeddddd�ZdS)(�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr��%�/�'��4�$�-�5�<��1��.�*�0�E�,�#��3�&�>�A�+�8rrrrrr�����������
��
����@���	�� �9�:��rrrrr�����������������������e���������j��������d���������^�P�]��i���?�������~�}�|�h�I�c�O�U�{�6�z�b�\�y�x�[�g�w�D�v�u�a�t�s�2�Z�r�q�p�o�7�)�(�V�Y�F�;�N�G�R�X�!�M�B�T�S�n�K�=�`��C�m�J�W�f�"�_�Q�l�L�H����k(r$r r$r$r$rr$r$r$r$r$r$r$r$r rrr$r$rr$r$�r$r$r$r$r$r�r$rr$r$r rr�r�rrr�r�r�rr�r�rrrrr�r�r�r�r�r�r�r r r�r�rr�r�rr$r r r$r$r�r$r$r$r$r$r$r$r r$rr�r$r$rr$r$r�r$r$r$r$r$r�r$r�r$r$rrr�rr�rr�r�r�r�r�r�rrrrr�r�r�r�r�r�r�r r r�r�r�rr�rr$r$r r$r$r�r$r$r$r$r$r$r$r r$rrr$r$r�r$r$rr r$r$r$r$r�r$r�r$r$rrr�r�r�rr�r�r�r�rrr�rr rr�r�r�rr�r�r�r�r r�r�r�r�r�rr$r$r$r$r$r$r r$r$r$r$r$r$r$r$rr$r$r r�r$r rr r rr$r$r�r�r�r r r r�rr�r�rr�r�rrr�r�r�r�r�r�r�r�r�r�r�r�rr�rrr�rr�r�rr$r$r$r r$r$rr r$r$r$r$r$r$r$rr$r rr�r$r r�rr r$r$r rr�r�r r rr�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r r�r r�r�r�rr�rr$r$rr$r$r$r$r$r$r$rr r�r�r r$r�r r$r�r�r r r r$r�r$r�rr rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$r$r$r$r$r$r$r$r$r$r$r$r$r�r$r$r$r�r$r r�r r$r r$r$rr�r�r r$r r�r�rr�r�r�r�r�r�r r�r�rr�r�r�r�r�r�r�r�r�rrrr�r r�r�rr$r$r$r r$r$r r$r$r$r$r r$r$r$r�r$r$r�r�r rr�r�r r$r r r�r�r�r r r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�rr�rr�r r�r�rr$r$r$r r$r$r$r$r$r$r$r r$r$r$r�r$r r�rr$r rrr$r r$r rr�r�r r r r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�rr�r�r�r�r�r$r$r$r r$r$r$r$r$r$r$r r$r$r$r�r$r r r�r r$r�r�r r r r r�r�r�r r$r$r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r r�rr�r�r�r$r$r$r$r$r$r$r r r r r$r r$r$r�r$r$rrr r r�r�r r r$r r�r�rr$r�r$rr�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�rr�r�r�r�rr$r$r$r r$r$r$r rr r r$r r$r$r�r$r r�r�rrr�rrr rr r�r�r�rr�r$r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�rr�rr�rr�r�r�r$r$r$r r$r$r r$r r r r$r$r$r$rr$rrr�r$r rrr$r$r r$rr�r�rrr�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r r�r�rr$r r r$r$r�r$r$r$r$r$r$r$r r rr�r$r$rr$r$r�rr$r$r r$r�r$r�r$r r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r r r r$r$r�r$r$r$r$r$r$r$r$r$r�r�r$r r�r$r$r�r$r r$r$r$r�r$rr$r r�r�r�r�r�r�r�r�r�r�rr�rr r�rr�r�r�r�r�r�r�r r r�r�rr�r�rr$r$r$rr r$r$rr�r�rr�r�r$r$r r$r�r�r r�r�r r�r r�r�r�r r�r r�r�r$rr�rr�r�r�r r rr�rrr rr r r r�r rrr�r�r�r r�r�r�r�r�rr rr$r$r�r$r$r$r$r$r r$r�r�r�r�r r$r�r r$rr�r r$rr$r�r$r�r r$r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$rr$r$r r r$r r r�rr r$r�rr rr�rr�r�r�rr�r r r�r�r�rrrr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�rrr�r�rr�r�r�r$r$r$rr$r$rrr$r$rrr$r$rr�r rr r�r rr�r�rrr rr�r�r�r r rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$rr�r rr$r�r�r r�r�r$r$r�r$r�r�rr�rr r�r�rrr r r�rr�r�rr rrr�rr�rrrrrr�rrrr r rr r�rr�r�r�r�r�r�rr�r�r$r$r$r r$r r$r$r�r r r r$r$r$r�r$r�r�r�r r r�rr rrrr�r�r�rr�r$r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r$r$r$r$r$r$r rr r r$r$r$r$r r�r r�r�r�r r r�r�r rr$r$r�r�rrrrr�r�rr�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�rr�r�r�rrr r$r$r�r$r$r$r$r$r$r r r�r r�r r$r r$r r r r r r r rr$r r$r r�r rr r r r rrr r rr r rr r�r�r rrr�r rr�r�rr�r�r�rr r$r$rrrr�rrrr r$r rrr�r�r�r�r�r�r�r�r�r�rr�rr�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$r r r r$r r$r r rr$r$r$r�r rr r�r rr�r�rrrrrr�r�rr rr�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�rr�r r�rr�r�r�r$r$r$r r$r$r$r$r$r r$rr r$r$rr r�r�r�r�r�r�r�r$r rrr�r�r�r�r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r$r$r$r r r$r$r rrrrrr$r$r�r$rr�r�rrr�r�r$rr rr�r�r�r�r�r$r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r$r$r$r r r$r r r r$r rrr$r$r�r$r�r�r�r�rr�r�r$rrr r�r�r�rrr�r�rr�r�r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr$r$r�r$r$r$r$r$r r r rr r�r rr r rrr�rr r r r r r r r�r�r rr rr rr�rrr$rr rrr r�r�r r�rr�rr�rr�r�r�rr�rr$r$r$rr$r$r$r�rrr�r r r$rr�r$r�r�r�rr�r�r�rr�r�rr�rr�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r r�r�r r rr�r�rr�r�r$r$rr$r�r�rrr�r r�r$r�r�r�r r�rrr�rr r�rr r r�r r r r rr�r rrr�r r�r rr r�r�r�r�r�r�r�r�r�r$r$r$rr$r r$r r�r r r rr$r r�r rr r�rr r�r�rr�r r r�r�r�r rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�rr�r�r�r$r$r$r�r$r$rrr r$rr�r$r r$r�r$r�r�r�rr�r�r�rr�rr�r�r�r�r�rr r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r�r$r$r r$r$r r r�r�r�r�rr r�rr$r�r�r�r$rrr�r$r�r r r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$rr r rr�r$rrrrr$r$r r$r�r�rr�rr r�r r r�r r r�r rr�r r rrrrr�r rrr�rrrrr rr rr r�rr�rr�r�r�r�r�r�r�r$r$r$r�rrr$r�r�rrr�r�r r r�r$r�r�rrr�rr�r�r�r�r�r r�r�r�r�r$rr�rr�rr�r r�r�rr�rr�rrrr rrr�r r�r�r�r�r�r�r�r�r�r$r$r$r�r r�r r�rrrr�r�r$r$r�r r�r�rr�r�r rrr�rr�rr�rr�r�r r�rr r�r r�r rrr�rr�r rrr�r rrr�rr�r�r�rrr�r�r�r�r$r r$r�rr�r�r�r�r�r�r�r�rr r�rr�r�rr�r�rr�r�r�r�r�r r�r�r�r�r�rrr�r�rr�rr�r�rr�r�r�r rr�rr�r r�r�r�r�r�r�r�r�r�r�r�r$r$r$r�r�r r$r�r�rr�rr�r r$r r$r�r�rr$r�r rr�r�r�r�r r�rr�r�r rr�r�rrr�r rr�r�rr�r�rrr�rrr r�rr�r�r�r�rr�r�r�r�r$r r r�r�rrr�r�r�r�r�r�r$rrrr�r�r�r�r�rr�r�r�r�r�r r�rr�r�rr�r�r�r�r�r�rr�r�r�r�r�r�r�rr�r�r�rr�rr�r�r�r�r�r�r�r�r�r�r�r�r$r$r�r r$r r rr r rrr r�rr$r r r r�r�r r r�r�r�rr rr$r�r rrr�rrrr�rr r r rrr r�r�r�r�rr�rrr�r�r�r�r�r�r�r�rrr r$r�r$r$r$r r r r rr�rr�rr�rr r r�r�r r rr$rrr rr�r�rrr r�rrr�r�rr r�r rrr r�r�rr�r�r�rr�rr�rr�r�r�r�r$r$r r�r�r$rr�r�r�r�r�r�r$r rr r�r�rr�r�r r�r�r�r�r�r r�rr�r�r rrr�r�rr�rr r�r�rrr�r�r rrrrr�r r�r�r�r�r�r�r�r�r�r$r$r r�r�rr�r�r�r�rr�r�r$r$r r r�r�rr�r�r r�rr�r�r�r r�rr�r�r�rrr�r�r r�r rr�r�rrr rr r�r rr rrrr�r�rrr�r�r�r�r$r$r r�r�r r r�r�r�rrr�r r rr$rr�rr�rr r�r�r�r�r�rr�rr�r�rrr�r�r�r�r�rr�r�rr�r�r�rrr�rr�rr�r�r�r�r�r�r�r�r�r�r�r$r$r$r r�r�r�rr�r�rr�r�r r$rr r�r�rr�r�r r�r�r�rr�r r�r r�r�rrr r rr r�r rrr�r�rrr�rrrrr rrr�r�r�r�r�r�r�r�r�r$r$r$r�r rr rr�r�rrr�r$r$rr r�r�rr�r�r r�r r�rrr r�r�r�r�r�rrrrr r�rrr�rrrrr�r�r�rrrr�rr�r�r�rr�r�r�r�r�r$r$r$r�r r r$r r�r�rr�r�r r$rr�r�r�r�r�r�r r�r r�r�r�r r�r�r�r�rrr�r�r�rr�r�rr�rrr�rr�rrrr�rr�r�r�r�r�r�r�r�r�r�r�r$r r$r�r�r�r�r�r�r�rr�r�r r r r r�r�rr�r�r r�r�r�r�r�r r�rr�r�r�r rrr�rr�r rrr�r�rrr rr�r r�r r�rr�r�r�r r�r�r�r�r�r�r�r�r r r�r rrrrr r r�r�rr�rr�r�rr$r�r�r�r�rr�r�r rr�r�r�rr�rr�r�r�r�r�r rr�rr�r�r�r�r�r�r�r�r�r r�r�r�r�r�r�r�r�r r�r�r r$r�r r$rr r r�r r�r�r r�r rrrr rr�r�rr rrr rr�rr�r r�rr�rrr�r�r r rr rrr r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r$r$r$r�r rr r�r�r�rr�r�r$r r�rr�r�rr�r�r r�r�r�rr rr�rr�r�r�r�r�rr�rr�r�rr�r�r�r�rr�rr�rrrr�rr�r�r�r�r�r�r�r�r�r�r�r�r r r�r r rrr�rrrrrr�r�rr rrrr�rr�r�r�rrrrr�r�r rr�rrrr�rrr rr rrr r�rrr rr�r r�r�r�r�r�r�r�r�r$r r r�r�r r�r�r�r�r�r�r�r r r�r r�r�rr�r�r r�r�r�r�r�r r�r�r�r�r rr�r�r�r�r�rr�r�r�r�r�r�r�rr�r�r�rr�rr�r�r�r�r�r�r�r�r�r�r�r�r$r r�r r r�rrr�rr�r�rr�r�r�rr�rr�r�r�r�r�rr�r�r�r�r r�rr�rr�rrr�r�rr r�rr�rrr�r�rr�rr�r r�r�r�r�r�r�r�r�r r r r�rrr�r�r�rr�r�r�rr r�rr�r�rr�r�rr�r�r�r�rr r�rr�r�r�rr�r�r�rr�r�rr�r�r�r�r�r�rr�rr�r r�r�r�r�r�r�r�r�r�r�r�r r r r rr�rrrr�r�r�r�rr r�r�rr�r�r�rr�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r r�r�r�r�r�r�r�rrr r�rr�r�r�rr�rr�r�r�rr�r�rr�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r r�r�r�r�r�rr�r�rr r r�r rr rrr r r�r�r�r�rr�r�rrr�r�r r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r r r r�r�r�rr�r�r�r�r�r�r r rrr�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�rr�r�r�rr�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r r r r�rr�rr�r�r�r�r�r�rrr�r�r�r�r�r�r�rr�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g�X4���?Tz
ISO-8859-9ZTurkish)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguageN)ZLatin5_TurkishCharToOrderMapZTurkishLangModelZLatin5TurkishModel�r�r��H/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langturkishmodel.py�<module>$s�site-packages/pip/_vendor/chardet/__pycache__/langturkishmodel.cpython-38.pyc000064400000053246151446177000023355 0ustar00U

��.e^+�@sdZdZeeddddd�ZdS)(�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr��%�/�'��4�$�-�5�<��1��.�*�0�E�,�#��3�&�>�A�+�8rrrrrr�����������
��
����@���	�� �9�:��rrrrr�����������������������e���������j��������d���������^�P�]��i���?�������~�}�|�h�I�c�O�U�{�6�z�b�\�y�x�[�g�w�D�v�u�a�t�s�2�Z�r�q�p�o�7�)�(�V�Y�F�;�N�G�R�X�!�M�B�T�S�n�K�=�`��C�m�J�W�f�"�_�Q�l�L�H����k(r$r r$r$r$rr$r$r$r$r$r$r$r$r rrr$r$rr$r$�r$r$r$r$r$r�r$rr$r$r rr�r�rrr�r�r�rr�r�rrrrr�r�r�r�r�r�r�r r r�r�rr�r�rr$r r r$r$r�r$r$r$r$r$r$r$r r$rr�r$r$rr$r$r�r$r$r$r$r$r�r$r�r$r$rrr�rr�rr�r�r�r�r�r�rrrrr�r�r�r�r�r�r�r r r�r�r�rr�rr$r$r r$r$r�r$r$r$r$r$r$r$r r$rrr$r$r�r$r$rr r$r$r$r$r�r$r�r$r$rrr�r�r�rr�r�r�r�rrr�rr rr�r�r�rr�r�r�r�r r�r�r�r�r�rr$r$r$r$r$r$r r$r$r$r$r$r$r$r$rr$r$r r�r$r rr r rr$r$r�r�r�r r r r�rr�r�rr�r�rrr�r�r�r�r�r�r�r�r�r�r�r�rr�rrr�rr�r�rr$r$r$r r$r$rr r$r$r$r$r$r$r$rr$r rr�r$r r�rr r$r$r rr�r�r r rr�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r r�r r�r�r�rr�rr$r$rr$r$r$r$r$r$r$rr r�r�r r$r�r r$r�r�r r r r$r�r$r�rr rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$r$r$r$r$r$r$r$r$r$r$r$r$r�r$r$r$r�r$r r�r r$r r$r$rr�r�r r$r r�r�rr�r�r�r�r�r�r r�r�rr�r�r�r�r�r�r�r�r�rrrr�r r�r�rr$r$r$r r$r$r r$r$r$r$r r$r$r$r�r$r$r�r�r rr�r�r r$r r r�r�r�r r r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�rr�rr�r r�r�rr$r$r$r r$r$r$r$r$r$r$r r$r$r$r�r$r r�rr$r rrr$r r$r rr�r�r r r r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�rr�r�r�r�r�r$r$r$r r$r$r$r$r$r$r$r r$r$r$r�r$r r r�r r$r�r�r r r r r�r�r�r r$r$r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r r�rr�r�r�r$r$r$r$r$r$r$r r r r r$r r$r$r�r$r$rrr r r�r�r r r$r r�r�rr$r�r$rr�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�rr�r�r�r�rr$r$r$r r$r$r$r rr r r$r r$r$r�r$r r�r�rrr�rrr rr r�r�r�rr�r$r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�rr�rr�rr�r�r�r$r$r$r r$r$r r$r r r r$r$r$r$rr$rrr�r$r rrr$r$r r$rr�r�rrr�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r r�r�rr$r r r$r$r�r$r$r$r$r$r$r$r r rr�r$r$rr$r$r�rr$r$r r$r�r$r�r$r r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r r r r$r$r�r$r$r$r$r$r$r$r$r$r�r�r$r r�r$r$r�r$r r$r$r$r�r$rr$r r�r�r�r�r�r�r�r�r�r�rr�rr r�rr�r�r�r�r�r�r�r r r�r�rr�r�rr$r$r$rr r$r$rr�r�rr�r�r$r$r r$r�r�r r�r�r r�r r�r�r�r r�r r�r�r$rr�rr�r�r�r r rr�rrr rr r r r�r rrr�r�r�r r�r�r�r�r�rr rr$r$r�r$r$r$r$r$r r$r�r�r�r�r r$r�r r$rr�r r$rr$r�r$r�r r$r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$rr$r$r r r$r r r�rr r$r�rr rr�rr�r�r�rr�r r r�r�r�rrrr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�rrr�r�rr�r�r�r$r$r$rr$r$rrr$r$rrr$r$rr�r rr r�r rr�r�rrr rr�r�r�r r rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$rr�r rr$r�r�r r�r�r$r$r�r$r�r�rr�rr r�r�rrr r r�rr�r�rr rrr�rr�rrrrrr�rrrr r rr r�rr�r�r�r�r�r�rr�r�r$r$r$r r$r r$r$r�r r r r$r$r$r�r$r�r�r�r r r�rr rrrr�r�r�rr�r$r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r$r$r$r$r$r$r rr r r$r$r$r$r r�r r�r�r�r r r�r�r rr$r$r�r�rrrrr�r�rr�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�rr�r�r�rrr r$r$r�r$r$r$r$r$r$r r r�r r�r r$r r$r r r r r r r rr$r r$r r�r rr r r r rrr r rr r rr r�r�r rrr�r rr�r�rr�r�r�rr r$r$rrrr�rrrr r$r rrr�r�r�r�r�r�r�r�r�r�rr�rr�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$r r r r$r r$r r rr$r$r$r�r rr r�r rr�r�rrrrrr�r�rr rr�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�rr�r r�rr�r�r�r$r$r$r r$r$r$r$r$r r$rr r$r$rr r�r�r�r�r�r�r�r$r rrr�r�r�r�r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r$r$r$r r r$r$r rrrrrr$r$r�r$rr�r�rrr�r�r$rr rr�r�r�r�r�r$r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r$r$r$r r r$r r r r$r rrr$r$r�r$r�r�r�r�rr�r�r$rrr r�r�r�rrr�r�rr�r�r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr$r$r�r$r$r$r$r$r r r rr r�r rr r rrr�rr r r r r r r r�r�r rr rr rr�rrr$rr rrr r�r�r r�rr�rr�rr�r�r�rr�rr$r$r$rr$r$r$r�rrr�r r r$rr�r$r�r�r�rr�r�r�rr�r�rr�rr�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r r�r�r r rr�r�rr�r�r$r$rr$r�r�rrr�r r�r$r�r�r�r r�rrr�rr r�rr r r�r r r r rr�r rrr�r r�r rr r�r�r�r�r�r�r�r�r�r$r$r$rr$r r$r r�r r r rr$r r�r rr r�rr r�r�rr�r r r�r�r�r rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�rr�r�r�r$r$r$r�r$r$rrr r$rr�r$r r$r�r$r�r�r�rr�r�r�rr�rr�r�r�r�r�rr r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r�r$r$r r$r$r r r�r�r�r�rr r�rr$r�r�r�r$rrr�r$r�r r r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r$r$r$rr r rr�r$rrrrr$r$r r$r�r�rr�rr r�r r r�r r r�r rr�r r rrrrr�r rrr�rrrrr rr rr r�rr�rr�r�r�r�r�r�r�r$r$r$r�rrr$r�r�rrr�r�r r r�r$r�r�rrr�rr�r�r�r�r�r r�r�r�r�r$rr�rr�rr�r r�r�rr�rr�rrrr rrr�r r�r�r�r�r�r�r�r�r�r$r$r$r�r r�r r�rrrr�r�r$r$r�r r�r�rr�r�r rrr�rr�rr�rr�r�r r�rr r�r r�r rrr�rr�r rrr�r rrr�rr�r�r�rrr�r�r�r�r$r r$r�rr�r�r�r�r�r�r�r�rr r�rr�r�rr�r�rr�r�r�r�r�r r�r�r�r�r�rrr�r�rr�rr�r�rr�r�r�r rr�rr�r r�r�r�r�r�r�r�r�r�r�r�r$r$r$r�r�r r$r�r�rr�rr�r r$r r$r�r�rr$r�r rr�r�r�r�r r�rr�r�r rr�r�rrr�r rr�r�rr�r�rrr�rrr r�rr�r�r�r�rr�r�r�r�r$r r r�r�rrr�r�r�r�r�r�r$rrrr�r�r�r�r�rr�r�r�r�r�r r�rr�r�rr�r�r�r�r�r�rr�r�r�r�r�r�r�rr�r�r�rr�rr�r�r�r�r�r�r�r�r�r�r�r�r$r$r�r r$r r rr r rrr r�rr$r r r r�r�r r r�r�r�rr rr$r�r rrr�rrrr�rr r r rrr r�r�r�r�rr�rrr�r�r�r�r�r�r�r�rrr r$r�r$r$r$r r r r rr�rr�rr�rr r r�r�r r rr$rrr rr�r�rrr r�rrr�r�rr r�r rrr r�r�rr�r�r�rr�rr�rr�r�r�r�r$r$r r�r�r$rr�r�r�r�r�r�r$r rr r�r�rr�r�r r�r�r�r�r�r r�rr�r�r rrr�r�rr�rr r�r�rrr�r�r rrrrr�r r�r�r�r�r�r�r�r�r�r$r$r r�r�rr�r�r�r�rr�r�r$r$r r r�r�rr�r�r r�rr�r�r�r r�rr�r�r�rrr�r�r r�r rr�r�rrr rr r�r rr rrrr�r�rrr�r�r�r�r$r$r r�r�r r r�r�r�rrr�r r rr$rr�rr�rr r�r�r�r�r�rr�rr�r�rrr�r�r�r�r�rr�r�rr�r�r�rrr�rr�rr�r�r�r�r�r�r�r�r�r�r�r$r$r$r r�r�r�rr�r�rr�r�r r$rr r�r�rr�r�r r�r�r�rr�r r�r r�r�rrr r rr r�r rrr�r�rrr�rrrrr rrr�r�r�r�r�r�r�r�r�r$r$r$r�r rr rr�r�rrr�r$r$rr r�r�rr�r�r r�r r�rrr r�r�r�r�r�rrrrr r�rrr�rrrrr�r�r�rrrr�rr�r�r�rr�r�r�r�r�r$r$r$r�r r r$r r�r�rr�r�r r$rr�r�r�r�r�r�r r�r r�r�r�r r�r�r�r�rrr�r�r�rr�r�rr�rrr�rr�rrrr�rr�r�r�r�r�r�r�r�r�r�r�r$r r$r�r�r�r�r�r�r�rr�r�r r r r r�r�rr�r�r r�r�r�r�r�r r�rr�r�r�r rrr�rr�r rrr�r�rrr rr�r r�r r�rr�r�r�r r�r�r�r�r�r�r�r�r r r�r rrrrr r r�r�rr�rr�r�rr$r�r�r�r�rr�r�r rr�r�r�rr�rr�r�r�r�r�r rr�rr�r�r�r�r�r�r�r�r�r r�r�r�r�r�r�r�r�r r�r�r r$r�r r$rr r r�r r�r�r r�r rrrr rr�r�rr rrr rr�rr�r r�rr�rrr�r�r r rr rrr r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r$r$r$r�r rr r�r�r�rr�r�r$r r�rr�r�rr�r�r r�r�r�rr rr�rr�r�r�r�r�rr�rr�r�rr�r�r�r�rr�rr�rrrr�rr�r�r�r�r�r�r�r�r�r�r�r�r r r�r r rrr�rrrrrr�r�rr rrrr�rr�r�r�rrrrr�r�r rr�rrrr�rrr rr rrr r�rrr rr�r r�r�r�r�r�r�r�r�r$r r r�r�r r�r�r�r�r�r�r�r r r�r r�r�rr�r�r r�r�r�r�r�r r�r�r�r�r rr�r�r�r�r�rr�r�r�r�r�r�r�rr�r�r�rr�rr�r�r�r�r�r�r�r�r�r�r�r�r$r r�r r r�rrr�rr�r�rr�r�r�rr�rr�r�r�r�r�rr�r�r�r�r r�rr�rr�rrr�r�rr r�rr�rrr�r�rr�rr�r r�r�r�r�r�r�r�r�r r r r�rrr�r�r�rr�r�r�rr r�rr�r�rr�r�rr�r�r�r�rr r�rr�r�r�rr�r�r�rr�r�rr�r�r�r�r�r�rr�rr�r r�r�r�r�r�r�r�r�r�r�r�r r r r rr�rrrr�r�r�r�rr r�r�rr�r�r�rr�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r r�r�r�r�r�r�r�rrr r�rr�r�r�rr�rr�r�r�rr�r�rr�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r r�r�r�r�r�rr�r�rr r r�r rr rrr r r�r�r�r�rr�r�rrr�r�r r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r r r r�r�r�rr�r�r�r�r�r�r r rrr�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�rr�r�r�rr�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r r r r�rr�rr�r�r�r�r�r�rrr�r�r�r�r�r�r�rr�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�rr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r�r�r�r r r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g�X4���?Tz
ISO-8859-9ZTurkish)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguageN)ZLatin5_TurkishCharToOrderMapZTurkishLangModelZLatin5TurkishModel�r�r��H/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langturkishmodel.py�<module>$s�site-packages/pip/_vendor/chardet/__pycache__/sjisprober.cpython-38.opt-1.pyc000064400000004622151446177000023114 0ustar00U

��.e��@s`ddlmZddlmZddlmZddlmZddlm	Z	ddl
mZmZGdd�de�Z
d	S)
�)�MultiByteCharSetProber)�CodingStateMachine)�SJISDistributionAnalysis)�SJISContextAnalysis)�
SJIS_SM_MODEL)�ProbingState�MachineStatecsPeZdZ�fdd�Z�fdd�Zedd��Zedd��Zd	d
�Zdd�Z	�Z
S)
�
SJISProbercs4tt|���tt�|_t�|_t�|_	|�
�dS�N)�superr	�__init__rr�	coding_smr�distribution_analyzerr�context_analyzer�reset��self��	__class__��B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/sjisprober.pyr%s

zSJISProber.__init__cstt|���|j��dSr
)rr	rrrrrrr,szSJISProber.resetcCs|jjSr
)r�charset_namerrrrr0szSJISProber.charset_namecCsdS)NZJapaneserrrrr�language4szSJISProber.languagecCsNtt|��D]�}|j�||�}|tjkrP|j�d|j|j	|�t
j|_�qq|tj
krjt
j|_�qq|tjkr|j��}|dkr�|d|jd<|j�|jd|d�|�|j�|j|�q|j�||d||d|�|�|j�||d|d�|�q|d|jd<|jt
jk�rH|j���rH|��|jk�rHt
j|_|jS)Nz!%s %s prober hit error at byte %s�r�����)�range�lenr
Z
next_staterZERRORZlogger�debugrrrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenZ
_last_charr�feedr�stateZ	DETECTINGZgot_enough_data�get_confidenceZSHORTCUT_THRESHOLD)rZbyte_str�iZcoding_stateZchar_lenrrrr 8sH
�


�����zSJISProber.feedcCs|j��}|j��}t||�Sr
)rr"r�max)rZcontext_confZdistrib_confrrrr"Ys

zSJISProber.get_confidence)�__name__�
__module__�__qualname__rr�propertyrrr r"�
__classcell__rrrrr	$s

!r	N)ZmbcharsetproberrZcodingstatemachinerZchardistributionrZjpcntxrZmbcssmrZenumsrrr	rrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/euckrfreq.cpython-38.opt-1.pyc000064400000027372151446177000022730 0ustar00U

��.e�4�@sdZdZdZdS)g@�0	(0	�
��xiti�i�i�iHia��i�i�i�i+i��Wiui��hii]i�i�i�i�i�i�i�i�i�i�iviwi�i�i��imiFi!ipi�ii��i�i�i�i�ixi��/i�i�i�i�i�i�i�i9ii�i��ti�i-iyi��Ki��i�i�i�i��iOi�ini�i�i�i�i�ii0�i��<i4�{i�i�i�i�i�iii�iri�i�i�i�i�i�i�i�i�i�i�iXiXi�i�i�i��Yi�i�i&i�iPi�i�i�i�i�i�i�i^i���i�i�i�i�i�i9i�i�i�i�i�i�iQi�i"�it�i��i�ii]i{i7i��i�i{i�i;i�iui�izi/i�i|��i�i�i�i7i�i�i.i�i�i�i�ii�ii�iiiiii{iiii#i|i}i�i~i�iti8ii_i	i
iii
i!iiii_ii�i�i�iii*i�iuii`i"i�ii|iii�i�iiiaiiiiiii?iiRi!i i/i�i�i!i"i=i�i�i#i�i$i%i&i'i(i)i,i�i'ibi$i*i�i+i�i-i�i,i�ii�i�i�i&iUi�i�i#ii�i-i.�'ii�ifi/isi�i0i�i�iii�i i�i9ie�[i1i�i�iiZi�i�i:i�i�i�i2i3i�iGii�i�yi4i�i�i�i5i6i7i,�wi�i�isi8i���i9i:ii�i~i;ii<i;i}i=i>i?ioi)i�i�i@i�iAiBi�i�i2iYiCiDi�i<iEiFiGiHiIi%iJiKiLiMiNiOi�`i>iPi�i=iQi�iRi�iSiTi;i�i�i�i�iiUi�iViWiXi4iY�iiZi[i�i\i]�ii^i�i�i_�"iPi�i�i`i;i�i~iHia�ivi��zi?ii�i�ibi�i�i<icid�dieific�0i�idiigiyi�i�ihii�si0iji=iki�ili�i�i�i<ibi�i��Uii�ii�iIiminioiipiqirisitiu�i�i�i�i6iviwi�i*i��]ixiyi�i�iziZi��-�:�ibi
i{i|�i&i'i�i�i5i�i�ii>i}i~iwiigi�i�i�i6i�i%i�i��(i��vi��i�iwi�i��i��Ei�i�i�i�i�i�i�i�i�if��iVi�i7i�i�i�i�iBi��Ni�i[i�i'i�i�i�i�i�i���iSi�i�i�i�i�iei�iixi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i?i�i�ii�iqi�ifi�i(i)i�i�i~i�i\i�i�i�i�i�i)ii�i�ii�ii�i�i�i�i��$i��i��i�i�ili�i�i�i�~i�i�iC�i�ii�i@i�i�i�i�i��2i���iKiiziVii�����iQirifiii��i ihi+i3ii1�ii�i�i���gi(i�i�i�izi�i�i�i�i�i�i�i�i�i�i�i���i�i�i�i�iA�i<ijii�iMigi�i2i�i�i�i�i�i�i�i�i�iVihii�iJi�i�i0��i�b��i�i�ii�i�i��iY�i�i��i���ai!�*�i���i�i�iKiDi8iiRiiB�i@i�i�i�ii�i�i�iyi�i�i�i�iiXi:i�i�i#i�i�i�iii��Gi�i�iki�i�i=i�i��i��!i�i�i��J��i��=�i�i�i}i�iijii�i�i�i�i�i�i�i�i�i�i�iEi�i�i�i��ijiO�4i��i�i�i�i�i�i�i�i	ivi]i�iCi�i�i�i�i�i�i�ioi�i��i�i
i�i��iliciAi�i�i�i�i�i�i�i�i�Ti�i�ik�����i�i�i�i3i*i��qi���i>i�ii�i�i�ii+iiiii�;i��piixii��i�iiii�i�i	i�i
ii�ii
i�i���iliii�i�ii�)��i��imi8i�iiDii�iiiiii�ii�ii�7iL�Bi�iiDii�ii�i�itiiii i!i
i"i#i$i%iRi&i'i(i)i*�i+i,�i,i-i.�mi�i
i^i/ici�iEi�i�i�iaimi0iEi1i2i3ii�i�i4iTi�i�i�i5i�ii�i�i6i7iini�i�ioi8i9iFi�i�i�i:iGi;i<i=i>i?i@iAiBiCiDiEi$iFiGi�i�i%i�i�ipiHiIiJiKiLi�i�ii�i�i�i�iMiNiOiPiQiR�i�iSi/iTi�iUi�iiiVi��IiH��ii�i�i�iWi�iX�iqiYiZi[i\i�iri�isi]i^i_i`�iviLia�i��.i�ibiFi>i�i��jic�Zi�i�iBi6i�i`idieii��|iifi�i�i5igi�ihi�ii�H�iji�i�iki�ili�i1iminioipiqiriCisitiuiviwi�ixiyizi{i�i�i|i}i~ii�i�i��iii�iOi�i�i�i�i�i�ii�i�i�i�i�iEi�i�iqi�iiIi�i\i�i-i�i�iSi�i�i��
i�iei�i�i��li�iM���Qi�Piii^ii
i-iFi�i�i�ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i
i.i�iti�i�i�i�iJi�i�i�i�i�i�i�igi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ii�i���i�i�iui�i�i�i9i	i�i�i�i	i�i$i�i�i�i�i�5i%�ik�L�i�ii�i�i�i�ii�i�iAi�i�i�i�i�i�i�i�i��R�iui�i�i�ii�i)i�i�i:i�i�i��i���i�i"i$ivi�i���ciZ�i�i�i�i��i*iWiiKi�iLi��+�i���i�i�i�ii�i	iB��i�i?i��i�ii�i�i�i��iMi[i5i�i�i�ini���i�i�i��Ci�i'i�i�i�i�i�i�i�i�i
i�i�i�i	i�ii�i�i�i�i��FiTi/i�i�i�i���8i��ui�i�i�iKi�i(iM�i�ii�i�i�i�i��i�ii�i�iTi��?i��i�i�ii�i�ei i(i�i�i�i�i�i��%i0��i��Oi�i	i8i	i	i	i	i	i��ii	i	i	�i��#���i		i����Vi
�iiPi� �MiWi�i
	ii	i�i|i	i
	�Si��i�ii�i�i�i	i	i�i�i	i	i	i	i	i	i�i	i	��9�Dii���i��i	�3i�i�i	i	i	i{i	ii�i	i	i	i�i 	i��i�ii�i!	iki�i��i�iN��iYi�i"	i#	i$	i%	i&	i'	i(	i]i)	i*	i+	i,	i-	i.	i�i/	i�i��>i���ri1	i�i�i��i\i�i2	i�i3	i�i�i4	i5	i6	iwi7	i�i8	i�i3ii�i�i9	i:	iL����i;	��i<	i�ii�ii�i�ii�i�i�i=	i�iJi>	i?	i@	i�iA	��iB	iC	iD	i�iE	i�i�iF	iG	iH	iI	i�i�i�i�i�i�iJ	iK	ii�iL	iM	iN	iiIiO	iP	i�iQ	iR	iS	i�iT	i�iU	iV	iW	iX	i�iY	iZ	i[	i\	i]	i�i�i^	i_	i`	ia	i�iib	ic	id	ie	ii�if	ig	iUi�ixi ih	i�i�ii	ij	�ii�i4i&��i�i�i!i���i�iSiyii�i�i"i
i�i#ik	i�il	im	in	�i�i�ipiQi�i.io	iU�iOi�ip	i�iq	ir	is	ixit	i�iu	iv	iw	iii$ix	i�iy	i�i`iz	i{	i|	i}	��i~	i	i�	i�	i�	i�	i�	i�	��iCi��i�i�i%iyi�iioi�	i�i�	i�	i�	i�	i�	i�	i�i�	i�	i�	i�	i�i�i�	i�i�i�	i�	i�@i�i�i�	iGi�	i�i�ii2��i�i�i�i�	i�	i�	i�	iNi�	ii�i�i�i�i�	i�	i�	i�	i�	�ri�	i�izin�i�i�iPi�	i#i�	i&iQi�	i�imi�	ici�i�i�	i'i�	iwi�	i�	��i(ili@i�i�i�i)i�i*i�	i�	i�	i�	i�i�	i�	i�	i�	i�i�i�	i�i�i�	i�	i�	iHi�i�	i�	ii�	ii�i�	i�	i�	i�i�	i�	iri�	ii��Ai�	i���i�i�i�	�}i,i�i�i:i�ii��i
iiIi�	iNi�i1i�	iW����i�i�i�i�i�i�	i+i�	i�	�1i�ibi�i�	iqi�	i,i�	i��iei�i��_iidi�	i�	i�	i�	i�	i�	�i�i2i�i�i�i�	�i�	i�	i�	i�	ii�	i�i�	i�	i�i-i�	i�i�i�	i�	i�	i�	i�	i�	i�i�	i�	i�	i�	i�	i�	i�i�	i�i�	i�	���i7i�	i�i�	ii�	i�	i�	i�	i�	i�	i�	��i�i�i�i�i�i����,iGi�ii�i�	i�i^i�	i�	i.i�	�igi�i�	i�i�	i�	i�	i�i�i�	ii�ii_i�i�	i�	i�	i��ihihii{i�	i|i�i��i3i�	i�	i�	i�i�i�	i
i
�\ii�i�ii
i
i
i
i
i
i
�i	
i

i
i
ii�i�i
iji
iii�i4ii
i
i
i
i
i
i��i
i
i
i
i��6id��i/i
i
ii�i��oi
i�iRi��i��	�&i
�k�niz���i�i�i
i�i
i����Xi�idiiSi�i}i
i}ii�i~i�i�ii�i 
i!
iNi"
i�i��i�i�i�i#
i��isi$
i%
i&
�fiDii1i'
i�ii(
i@i)
�^���i�i*
i�i+
i,
i-
i.
i/
iJi+i0
i1
i2
i�iTi�i3
i4
i5
i6
��i7
iAi.i�i�i�i8
i9
ii"i:
i;
i�i<
i=
i>
ii�i0i?
i�i@
iiA
iB
iiC
iD
iE
iF
iG
i�i�i_i[iH
iI
i�ii`iaiJ
i�ii�i�iK
iL
iM
iN
�iO
i�iiiiiiP
iQ
iR
N)Z EUCKR_TYPICAL_DISTRIBUTION_RATIOZEUCKR_TABLE_SIZEZEUCKR_CHAR_TO_FREQ_ORDER�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euckrfreq.py�<module>)ssite-packages/pip/_vendor/chardet/__pycache__/cp949prober.cpython-38.pyc000064400000002120151446177000022044 0ustar00U

��.e?�@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�EUCKRDistributionAnalysis)�CodingStateMachine)�MultiByteCharSetProber)�CP949_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�CP949Probercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/cp949prober.pyr#s
zCP949Prober.__init__cCsdS)NZCP949rr
rrr�charset_name+szCP949Prober.charset_namecCsdS)NZKoreanrr
rrr�language/szCP949Prober.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr"s

rN)	ZchardistributionrZcodingstatemachinerZmbcharsetproberrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/gb2312freq.cpython-38.pyc000064400000045176151446177000021562 0ustar00U

��.e�P�@sdZdZdZdS)g�������?i�(�i�i�i�i<	iTi�i	iQi�i�
i�
i�i�i<iwi�i9	��i�	i�i�i�iZi�i�iqi�i�i�
iW
iyii�ieioi�iv
i�i�i�i�i�iiiLiBiiQ
�i�i�iQi�i�iEiifi�ii�ii�i�i�idi(iyii�i,i	i�i
iEie�i�
iWiRi�i�i|	iR
i�i�
i�i
iX
i�
ijiEi�ii+iPi�i�ii�i�;i�imi�ili�i�i�i��iieiHi�i�i�i�i^iki6i�i"�Fi�i�
i�
i�
i^	i�i�
i�i���i?i`iui$i1i�
i�i�i iUi�i1i�i�igili�ii		i�iGi�i2i�iq	i�i iPi�iL	i�i�i�iiy	i�i�
i�iMi�iki�i4	i�ii�i�i�i
i�	i@	i`i�i5��i�iN
i�i7i3i�iniiuiGi&ibihi0i�iMiNii�	i
iY	i�
i�i�	�
i��i�
�&i�
iQi
i7i^ihi�i�iJi�iPi�i�i�iri�i�i�ii�i�iT	i-iGi,iuii�	i�i$ii�i<iBii$i>ii�ixiLiWii�ini
i�iTi�iZi�i�
i�	i{ii�i�	i��ii�
i?i�
�0ibi;�Di�i��i�iCiSi�iUi>	i|igi�i�i�	i�
iK��i

i�i�i�i%
i5
i�i�ii�ili�ihi
ii�i?�i� iUi���i�i�	i�i*i<
i�i�
i�i
�i
i�i�i�
i�i�
i!	iX
i�i�i�	i�iQigi�i�i�i�	i�iri�
i�i�iqi�i�
i�iz
i�i�	i3�i�i�i�i
i�
i]iciziii7i�i_ii�iCi�i&iaiHi|
ili
i�i=i�i�iIiPi�
i�i~
i8i`i�iw	i�i�
iTi�i�
i�i�i�i�i�
i�ii�i���i[iq�ii�	igi��|iCi	i�i�iNiIi�i�i5i�
i(i�i/iHiK
i
i��ii�i9i�iIi�i�i|i��i�i�
i��iWii�i�i�i^�~iii�i�	i�i=iXi�i3i�
iIi�ii�
�i�i�i�i3ir�i���ioii�i�i{iiiiC���!iHi�	��i�i��f�i=
ii1�[i�i|iDii%i�iti�i�i�
i�i i�i.i��i�yiiTi�i�i9
i�
ii#�i�iJi��ni�ii�i
i�i>iBi"i�i�iai�i�iMiK��iiWi�i�	i�	i!
ir	iFi+	i�
i
ii�ix
�HiJi���i�i�i2�Ki�iR
i$ii9i�
it
i�i�
i�i�i��i�ii�i�ii�i�i%i~i�
i`	�i�i�i�i'iviii�i�i|i�'ii�in
i*i�i�i�iFi�i%i��)i~i�i
i�i�iJi&i�i
i!iDi�iwii[iii�	i�i	i'	i�	i��kii�i	i�
i�
��i��i�ii�i�ih
�Bi_i�i?iigihi�i'i�i�i�i�i�ii�i�i�ii�i��5i]i�ii�i�ii���i�i�i1	i�i)ia	ii�i�i�i;	ii�i_i�i��Qi/iu
i�
i�
iji[i�i}i�i
i�i�i�	ii�i�iQi^
i�iGi�izi�i�i�iViOi�ii�i�i�i�imiui�	i6i�i�i-i$i�i�iRi�i}	i
ipiri]
i�
iDiii�i�i�iiiii�i�ii1ini�i�iitiYiG	i�i�i/i|�ti0i�
i�i�ii�i\i�
i�i�ivi�i�i�ici�ii�i�
i~iAi"i�i"	i!i8�Ci8	ii�	iji�
i1i�ili>i�
ii]
i�i�
i~�iLi(i�i�iKid��viDi�i�i�i%i�	i�i�i�	i,�i2i�i�
i�i�ij�-i.i�imiKii���ioi	i;i	i�i�idi@iai	iM	i1
iLi@i2i�iwi�itiQi
i/i�i i�i~i�i�i�i�i�
i/i�i�
i_	i#i��Oi�iOiG�i�iki[iOioi���i-
i
�ii�	i!i�i�iIi�i�i�i{iri�i.ihi�
iiT
ii�i'iL
�ai�i�
i@�i�i�i�i�i�
iTi/
i�ii�i�ii�iMi�ii
ili�ii�
i{i8i#i�
i�i�i9i�iSiRi�	�wi�iZi�i0
iEigigi�i��
i��Li�i�ipi�i�iSi
i�i�i�i�i�	i@i�iI	iLi;
iOiqi�i�i)	ii:iFi�i5iJidiA
i�i
i)
iEiL�Yi�i�i�i�
im	i�i�i�i�i�i�ici�iRi�i!i�i�i�i�
��i(i�i�i]�Ii�i�
i�	i�iei�ii�i��i�i�i`i�ii�i�i
i�i[i�iC
i(iPi,i�i}iO	i'iLi\
i�
i�ii�i�iiZi�i�isi'i�	iUi�i�i�i�iN
�i�i�i�
i�i�iMi�i�i�i�i�i���i�iii�igi'i�i�i	i�i
��Pi0is	iii�ip	i�	inii�i�ii\i�
i�i�i�
i!ih���imi(i&i
iCiiBi)i5	i�i��ii�i�i
i�i��>i�i���ii�	��i{iNi�iiiEi3��Ji#i�ici�i�
ii$
��i5i�ixii]i�i�ik��i�i�i�i�iP
i�i
iiiri�iLi�izidi�i�i#i�
ii�i[iSiihiiGi�i�ii�i�
iU�+i�	iy�iwi"i�iVi2
i&izi�	i�	i�iJ
iP	i�	i�i���i�i%	iZi$ioiTiKi1i�
i�i`iVi�ii�id�i�i�i�i+i�i�iAi�i�i�i�i�i$i�i�	i_i3i\i�i�����i�ibi�if�i�i�i�i�
iAinii��x�iFi�
iOi[i�i��(i�ii
i#i7i2	ixiif	i�	i�
i!i6i{
��i�iYi��i�i+i�i�i�i�i i�i�i�i�	i	iKiei�i�i�
iTi$i�i�iihii	iRi�i�i"i�i��Zi 
i_i�i@i�iaii�ii3
i�
iki)iji�iiiei�i
iAi^i�i
iW	i�i�ihi:
iz
i)
i�i|i�i�ii�ii8ij��i�
ii�i3i�	i
izi�ipiyi�i�i2ioiD	i=i��.i�i9iaifi�i*i_i�i	i*i�ii�
i�
i�i�i-ii�
i}i�i�
i�i�i*	i�
it�iti6
�qi�i�i�i�i�i�i�iSi 	i�i�i!i)iiyi�
��iiij	i�i�	i�iViIi�i�ig
iiiLi�i�i�ipiDi�i�i�i�i%i�i�iMi�i�i�i$i�i�i�iE	i"iU	i�ie
i	i|i�	iQii�i�i�ii�i�
i1
i�i�i�i��$i i]i4i&i�i�izi�i�i`i�iwi�
iiii�
i)i%
i&i�i�i�i*i�i�i8i2i>
iSi
i�i�i1i#i�i�i
i�i#i	i�
i�i�ii�iF
iii,	i>i+i
ii�iZ�3iq�i�
i$i�i�
iVi�	i;i�i�iNi��miKiWi�i��i5i�
i�	�Ri4i�iIiiDi�i�i�i�
i�i�
i�i�i�ii%iKi|ii�i�
i��i��i9i�in	i�i�i�
i-i3i2
ipi�i?
i�i~i�i�i�i�i�iCi�i[i�i�
i�i�i�i3	i>i�ili
i`ix	i�i�i�i�i#
i�i�i�i0��i�i�i�	iL
i�i�iQi�iRi�i?i(imi�i`
i�i3ii�ii&
i�
iiisiDi�i0	ib	ifi@i�	i�i�i�
ii=i�i
i<��i�i�i�
i�i6ii�isi�i�i�iSi�i�i�
i8iZ
i�i�i�i�i�i�i�ii�
i�i�
i�ii�iNi�	i�i
iLi�
iJ	i�i�i�	ibiigii�i[
i�i�ii�ii~i�i�	i�	i�i�ifi�i�iii�
ii`i4i=	i�i�i�ili?	i�ici�ii�iiii�i�i�i�i�i�i�i�iwi�i�i�i%ii�id	i^i+i�i�i�iZ�iFiI
i�it�i�	�/i�	ii�iyi*
isi&i+ii�i)ii�i�	i�i�ii�
i�ie	i�i�iQi]	ii	i_i7	ii0�ciui�i�iLiki
i�i�i�i��#ii�ii�i��i�i?i��ii�
ini
i�i�i�i	i�i�i�	iHi�iYi�iu	i�i�
i�	i�iJi�i_i_i&i�i�ii�i�i�iZi%�i�	isi�iSiiiiVi�i�i�i�i�i1i'��i�iFi\i
i|i�	iWi�i�i|�iS�Wi�	i*i	iRiliPi#i�ii-iq
i�i��	i�i�i4i�i�i�i�i�iai�i�ii�i@
i�iXiii%i�i�i8
i3i,i�i}i�i�i��dixi�	i�i#	i�i6i�
i�
i.ii�iAi�
i�ir
i�
i�iRidi�ii+
i�i�i�i�
i{i{iHi�	i
i�i�i�i�i�ici	i
i�i�i�i,i�iI
i�icii�i�i�i�i=i�iJi.i,i>iii�iLiei]i�i�
iCi�i�i�i*i;i
i�i i�ipi�
i�i�iRi�i9i�
i�
ii�
i�i�i?i:i�	i�i�iQi'isi�iwi[i�
i�i-i�
i)i�i��Mi�i�i�i�i]�}i6i@i
iiUi�i�i�i/i�i�is
i�	i�i�ik	i?i�i,
i=
i1iMi�i�i�i/iS
id��i�io
i6	ikiui�i�i�iW�{iixiWi�i�ii�i�ixi^i��i[	i+�7i:i�iUi�i�i!i�i�i�
i.iHiTi�iYi�i�i	ii@i"iCisi	i�	iiG
�bi�i7i~i.
iUiiqi�	i�i�i�i{i�i��iYi/i�
i�i�iAi�
i�i*i:i8i'i�i�i�i�iiAi_i0i�i�i�iiii�iKi�
i�i�iti*i�i�i�
i�i�i�i�i�	i�
��i�iDii�ii>i�i�ivii

i�
i'i��Vi�i�i�
i�i�ikiii\i�i�i�i!ii��*iU
i�i�i�i�iizi�i\if
i�i�i�	i
i���i�i�i�i�i�i�i�iiB	iii�i�i�i{�i=i�
��i&i�
i�iVi�	i��"i!i�
i�	i�i�i�
i(	i=i�i�
i�
i�i9ii�i4ia��i�i-iQ	�i�
i�i�
imi�i�i�i�iCi�i�i7i}iqiDi4i��uii�	i�i�ivii�iF	i�iuia
i�iHioi�
i
	iliKiA	i�i�i�	izi4i�	i!
iH
i�i�	��i5iiji�i`i�i�
iBi:iOiai�i#i��i�id�i�i(i�
i&
i�i^imig
iE
iio	i�i(iGi$i@i
iIii�iAii�`�Xii7i�i/i�i$i�i�i�ihi�i�i�i�	iUi"iT�i�i�i�im�i�i!ii�i�ii�i i�iMi�	i��i�i�	�2iqi�i��9i�i�i��i�ii�i/i�i���i�pi@iX	i�ij�ii
i^
ibi�
i�iniiv�i�i�ioio�iivi�i�i0i�i9i�i$	i�ifiSizi
iiDi{i�iX�ii�iVi3iYi
i�i�
iAi�i��i�i�iqiUi�
i:	ii2iji�iii{	i�i�	iFi�i�
i�	ii	i��i�iciiiR	i;ik�hi�ii�
i�iYiOixi��ziZi<iv	ii�
i
i�
i�iIi�i�i4
iMi�i�i�i�ibi�ii�ii�i�i�iCi�i�
i�i�iOi�i8i�i�i�	i.i]iiVic
i�	i�i�i
iH	i�iTi�i�i�	i�i>
i
i�i�i3i�i��,i�i�ifi�i�iiliTiWiHi.i'i>ipi�i�i�i"i�i�	iJi�i�
i�
ivi2i�i�i	ixi	i2i�igi i4i�i�i�
i�
i�i�i{
iz	i�i�	i�
i�i�i�	i�i�ii�i�i?ii��i�	iJi�i�i�i�
i�	i8��iEij
�\i�i8i8
ii i�ii`i�i>ibiSii��i�i�ii�i0i�i�i�iEi�i�idi�i�i�i1�i�i�in�@i�i�i�iTii�	��i�iQ��iCi�i�iKi;iki�i�i�i�i�i_i\	ieiiwi�i�ii�iMi�i.	iriaii�i�
i�i�i�
i�i�i�igi�i�i'i�
i�iii�	�Tii�i4ioi�i�	iXiyi�ixii�	i�
i
iU
�^i:i�i�i�i�ii"i#i�i�iii�	i�i�i�iNiUi�i�ip�i"
i-i�i�	�i�i:i�i
ii�	i�i�i�i�	i��iWi
iG
iLi�i�
iGiw�oi�i�iiMir�i�ii�iQ
i�iIiN�%i
iXiii�i7
i�
iai�i�i�i�	i'
iiihi�i}iNiyi?iti�i�iDi�i�i��i��li�i�i�i	i��ieiJisi2i*iyi�i�i�i�i�ii�iqi�i�i5i}isi$i�i�i�i5
iBi�i��i#idisi}i�i~i�iib
i�iO
i/	�]i�i�i�	i]i2��iifi7i�i�iOi

iRii#
i	i[i��Ei�iif
iS
i�	idiFi�i��iC	iV
i>i�i	i�iBi�ii	i1i6im��ii	i��i�i�ip
i�ii�
i�i<izi�
i|
iX�i�i�isiei]ii��i
i�
iiOi�i+i�	iii�i�i�i:i�	iAi�ii�i�i�i(
i�
imi�4iP�i	ini�i�
ioioi�i�imiiy�ii8i	��i<i�i�i<ic	iCi�i�i&iwi
i�	i$i 
i9i&i�i�i)i`i�i�ii�i�iGibiEi�i:iQioiFi�
i�i�i�	i�
iFi|i;i�
i�ii3i4i%i��:i�	ici�ipi6
i\iCi�i0i9
i�i�i�i�i�i~	i�ii"ihi�i�i�i�	i)ii�	i�
i�i�i*
i�ii
i
i%i�i	i�i�ii�
i.i�i�i9i	i�i�i�
i�i�i	i�i"i!i�i,
i�ig	iJigiF
i�ii�i�
i�i;ii	iZiEi^iA
i�iili5i�i�i�i4i'
i�iiki	i�i�	i2i�i�
i�i	iXi7�i�i�
i{i�iBixi=�ei(i�i�i�i'i�i��i�i�ii�iiii�iD
iiikii�i�i�i-i,i�
iei7
i��i�i��i�i�ini}
ipi7iji�i�	i�i9i�i�
��i�i���i0iPi���i�i�ii�iO
i�
i�i�	��iUi
ii�i<
i�i�i�
iJi�itiNi�i)ii.i��i*iiA��ir
i]i)i�ii�i�iGi�i_
ipik
i�i�i
	i%i
i�i�
i�i>ibi_i^�?ii:iYiDi%�i�i�
i�ii�i��iYi�i�
i�i�ii�i�il
�Ai�i�	i�
i�	iDiBi�	i
i�i	i@
i(iv
i�i�i��gi�
i�	i}ivi�i�i�i�
i�ii�i�ii�i�ii�ii�i�i i-i~i�iyi%i�	i�
�_i�i�ii�i�i�jiMi�i�iGi+i�	ii���i�	i�i�ii3
i;i
�Gi)i�i
i�i�ii�i�ii�i
i
i�i,iIi�	i�i�iiXiAi\i��i�iPivi�i�	iVii=i�
i�
i6i<i�iXii�
i	ii8i-	iY
i�i�i�i�i�i��ici�i�i�i9i�	i-
iui�i	i�i�
iRi�
iii6i�i�	i�ih	i}ii?
iw
ii�i�	iai(i�i�1i�i�
i�i>i�i�i�i�i�i]i�
iXiriPi0i,ii+iji�i`i�i�i�ii.iii
i�i&	iWiB
i�ii|i7�Ui�i�	�iWi�iYi�i�
i�iw
i�
ii�ii�ii�i�iui�ibi�iq
i�i�ibi�i�i���=i$
i�iNiJi�i�iUi�ii�i�	ii��iiKi,i�i�i4iri{i�iiHi�ipi5ii�i=i�	i�iEi9i�i;i�<ii5i�
iiii�i\ii��ipi�ii�i��ri��Ni�ii^i�i�i�i�iKii�i*ii{i+
i�	i�i*i8ii�ii	ii�i�i�ij
ii@il	�6i�i2i8i�i�	i�ii�i'i�i�i�iB
i�iii\i�i�iSiV	ii~i�i�i�i�i�i�
i�iVi�
izi�i^i	i�i�i�i_
i}
iGiq�iIi�i�i��8itihiS	i�i}iRi�	i9��Sin
iPi�iBiii��si�iXi}ifi�i�ii�i�i�i�i���i�iniIi^�iTi�ixi�iri�i�i_�ibi�iOiPiQiRiSN)Z!GB2312_TYPICAL_DISTRIBUTION_RATIOZGB2312_TABLE_SIZEZGB2312_CHAR_TO_FREQ_ORDER�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/gb2312freq.py�<module>*ssite-packages/pip/_vendor/chardet/__pycache__/hebrewprober.cpython-38.pyc000064400000005652151446177000022465 0ustar00U

��.e6�@s,ddlmZddlmZGdd�de�ZdS)�)�
CharSetProber)�ProbingStatecs�eZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZd
ZdZ�fdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zedd��Zedd��Zedd ��Z�ZS)!�HebrewProber�������������������g{�G�z�?z
ISO-8859-8zwindows-1255cs>tt|���d|_d|_d|_d|_d|_d|_|�	�dS�N)
�superr�__init__�_final_char_logical_score�_final_char_visual_score�_prev�_before_prev�_logical_prober�_visual_prober�reset��self��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/hebrewprober.pyr�szHebrewProber.__init__cCsd|_d|_d|_d|_dS)N�� )rrrrrrrrr�szHebrewProber.resetcCs||_||_dSr)rr)rZ
logicalProberZvisualProberrrr�set_model_probers�szHebrewProber.set_model_proberscCs||j|j|j|j|jfkSr)�	FINAL_KAF�	FINAL_MEM�	FINAL_NUN�FINAL_PE�FINAL_TSADI�r�crrr�is_final�s�zHebrewProber.is_finalcCs||j|j|j|jfkSr)�
NORMAL_KAF�
NORMAL_MEM�
NORMAL_NUN�	NORMAL_PEr(rrr�is_non_final�s
�zHebrewProber.is_non_finalcCs�|jtjkrtjS|�|�}|D]�}|dkrn|jdkr�|�|j�rR|jd7_q�|�|j�r�|j	d7_	n,|jdkr�|�|j�r�|dkr�|j	d7_	|j|_||_q tj
S)Nr!r)�stater�NOT_MEZfilter_high_byte_onlyrr*rrr/r�	DETECTING)rZbyte_strZcurrrr�feed�s&



��zHebrewProber.feedcCsx|j|j}||jkr|jS||jkr.|jS|j��|j��}||jkrR|jS||jkrd|jS|dkrr|jS|jS)Ng)	rr�MIN_FINAL_CHAR_DISTANCE�LOGICAL_HEBREW_NAME�VISUAL_HEBREW_NAMErZget_confidencer�MIN_MODEL_DISTANCE)rZfinalsubZmodelsubrrr�charset_name�s
�
zHebrewProber.charset_namecCsdS)NZHebrewrrrrr�languageszHebrewProber.languagecCs(|jjtjkr"|jjtjkr"tjStjSr)rr0rr1rr2rrrrr0s
�zHebrewProber.state)�__name__�
__module__�__qualname__r#r+r$r,r%r-r&r.r'ZNORMAL_TSADIr4r7r6r5rrr"r*r/r3�propertyr8r9r0�
__classcell__rrrrr�s4

;

rN)Z
charsetproberrZenumsrrrrrr�<module>scsite-packages/pip/_vendor/chardet/__pycache__/escsm.cpython-38.opt-1.pyc000064400000016415151446177000022047 0ustar00U

��.e)�H@s�ddlmZdZejejdejejejejejejejejejejejejejejejejejejejdejdejdejdddejdejdddejdejdejejejejejejejf0ZdZedeedd	d
�ZdZ	ejdejejejejejejejejejejejejejejejejejejejejejejejejejejejejdejejejejejejejejejddejejejejejejejejejejejejejejejejejejejejejejf@Z
dZe	d
e
edd	d
�ZdZ
ejdejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejdejejejdejejejejejdejejejejejejejejejejejejejejejejejejejejejejejejejejejejfHZdZe
deeddd
�ZdZejdejejejejejejejejejejejejejejejejejejejdejejejejejejdejejejejejejejejejejejf(ZdZedeeddd
�ZdS)�)�MachineState(r�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�r��rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rr�)rrrrrrz
HZ-GB-2312ZChinese)Zclass_tableZclass_factorZstate_tableZchar_len_table�nameZlanguage(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)	rrrrrrrrr�	zISO-2022-CN(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrr
rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)
rrrrrrrrrr�
zISO-2022-JPZJapanese(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrzISO-2022-KRZKoreanN)ZenumsrZHZ_CLSZSTARTZERRORZITS_MEZHZ_STZHZ_CHAR_LEN_TABLEZHZ_SM_MODELZ
ISO2022CN_CLSZISO2022CN_STZISO2022CN_CHAR_LEN_TABLEZISO2022CN_SM_MODELZ
ISO2022JP_CLSZISO2022JP_STZISO2022JP_CHAR_LEN_TABLEZISO2022JP_SM_MODELZ
ISO2022KR_CLSZISO2022KR_STZISO2022KR_CHAR_LEN_TABLEZISO2022KR_SM_MODEL�rr�=/usr/lib/python3.8/site-packages/pip/_vendor/chardet/escsm.py�<module>s$�	�$��$��$��site-packages/pip/_vendor/chardet/__pycache__/utf8prober.cpython-38.opt-1.pyc000064400000003643151446177000023034 0ustar00U

��.e�
�@sHddlmZddlmZmZddlmZddlmZGdd�de�Z	dS)�)�
CharSetProber)�ProbingState�MachineState)�CodingStateMachine)�
UTF8_SM_MODELcsTeZdZdZ�fdd�Z�fdd�Zedd��Zedd	��Zd
d�Z	dd
�Z
�ZS)�
UTF8Proberg�?cs*tt|���tt�|_d|_|��dS)N)�superr�__init__rr�	coding_sm�
_num_mb_chars�reset��self��	__class__��B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/utf8prober.pyr	&s
zUTF8Prober.__init__cs"tt|���|j��d|_dS)N�)rrrr
rr
rrrr,s
zUTF8Prober.resetcCsdS)Nzutf-8rr
rrr�charset_name1szUTF8Prober.charset_namecCsdS)N�rr
rrr�language5szUTF8Prober.languagecCs�|D]f}|j�|�}|tjkr,tj|_qlq|tjkrDtj|_qlq|tj	kr|j�
�dkr|jd7_q|jtj
kr�|��|jkr�tj|_|jS)N�r)r
Z
next_staterZERRORrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenr�stateZ	DETECTING�get_confidenceZSHORTCUT_THRESHOLD)rZbyte_str�cZcoding_staterrr�feed9s


zUTF8Prober.feedcCs.d}|jdkr&||j|j9}d|S|SdS)Ng�G�z��?�g�?)r�
ONE_CHAR_PROB)rZunlikerrrrLs

zUTF8Prober.get_confidence)�__name__�
__module__�__qualname__rr	r�propertyrrrr�
__classcell__rrrrr#s

rN)
Z
charsetproberrZenumsrrZcodingstatemachinerZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/big5prober.cpython-38.opt-1.pyc000064400000002111151446177000022761 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�Big5DistributionAnalysis)�
BIG5_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�
Big5Probercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/big5prober.pyr#s
zBig5Prober.__init__cCsdS)NZBig5rr
rrr�charset_name)szBig5Prober.charset_namecCsdS)NZChineserr
rrr�language-szBig5Prober.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr"s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/euctwfreq.cpython-38.pyc000064400000065012151446177000022000 0ustar00U

��.e�{�@sdZdZdZdS)g�?i(�ii��i����	�R�i����ii�i�
�ni��!i�i�L�,iA�isi�i�i�i�iL
iS
i�ii�i�i�i�i.iNiii�����:i�i�i��?i�i�i=iN�K���i�il	i�i�i�
i���i�
i ��
ii��i�
ioi$i�ii�i�ici8i�i�ii��i�i��iz�|��it�"i�
ie�@i\i�i�	i�i��i�i�i�iFi�iM
iQ�Hi�i��Piv��ifi�ii�iDiT
i�i�iFiN
i��Ei�iO�i/i��si�i3�<�2i��i&iLi�i�iO
�i�iG�iiMi�i�i?iii`iiF	i*i�igi�	�Zi�
i:i��i�iKi�	�i�	�ii�i�i�i`i�ii�ig�i	i �qi�i~i���iP
i�	ii�i�i�i!i��u�i�i*ii�i	i�
i��~i�i�i��iei��Gi^i�i��i��UiCi�iBi�i�i�i�ii�i �jioi/ii�iOi2	i[i���i�
i&i�i�i�i��Si(i�i��ip�]i�i6iii�
i'iii�iii8��+i%i[�i�i\i�i�i�i�iX	i(i���i�i0��i iHi�
i�
i"i!��i+i�i1i"i�i�i�
iOiG	i�iifi1��i�i�i�i�i�ii2i9���li,��i	ii�ii�i�i}ihi#iq
iQiMi&i��Xi�i�i#i���i
��i�iji�i��M�i�i��%�i�i�i$i�i��'i�	i�iNiii�7��Ji�i!i�i�ii���iMi�i)iPiU
i���i�
i�i%i�
i�
i�� i�i�
i iIi�i3	i�i�
iir
�i�i�i�i���mi�i�i$i�i�ixi�i�i�i�i�
i�i�i�i%i&��i
ii�i�i�i�i��&i�i'i�ii'i�i��.�i�ii�iH	i���i�i�i$�#i�iDi&iAi�	�i�i�i�i�iUiGii�i�i
iQ
iPiSi'i�i��di��0�Fi�i�i*i�i�ii�ii�iJii�iU�i��iI	iR
i�i�i<i�iS
i:i7
i�
i�i	i	i9i�i}ii�	i�i�iViPiT
ii)iCii�i�i&i�
i�	i)i�i�im	i�i�i�i�i�ii4	i�i�i�in	i*ii�i�ii�i�iOi�i�i�i�i�	i+i(i
i�i�i�iU
i(i�i5iYiji�
ili�iuii)i�
i*i+iV
i
i=i�i�i�i�i�i�i�i4i�i!i�i�iTi,ixi�i�ie�i�	i�iJ	iPi�is
i5iAiV
i/iki�i�
iili!i	i�iAi�i`i�i�
i��iAi�i�
iii�i�
i�i�	i�i�i�i�i���iMi�
i�i�i�ii�iW
i�i�i�
it
i�i�i+�}i�iji8
i�i�i�i�i�i�i�i�i-i)imi�	i�iW
i�i		i�i�
i�iai�i
iPiK	i�i,i�i�i�i7i'iu
i�i{iki�i�ii�i�
i9
i�iii�i�i�i�i�i�i�i1���bii�	i�
i�i�io	i�iX
i,iQi��i�i�i�ii�
i�
iX
i��i�i5�D�i�ili�i�i[i 
i��iY
i�i%�i.iY	i�i*i�i�i�
i�iRi�i�i�ipi��in�cigi+ii�i'i2i��i�i{i�ili�imi�i�i:
i�ifi
	i�i|i5	��i�ii�iZ
i�i�
i�i�i�i�i,i�i�i�i��;i�iIiYi�i�i[
iXi"i�i	i�i�i�i~i�i�i,i�iki�i�i-i�i�ii�i�iDi�i�i�i>i]i�i,i�i�i�iviLiB�ii&i�i�i�
i�i�i�iGi�i�iiBi�i�
i!
i�i�iui�i�i�i�i�	i iaii�i�iv
iSi�i}i;
i�iDi�i=i�i0ii�i\
i(i�ii�ivi �i�i�i��i.i�i��9iHii�i�i�i]
iEi�i�i�i�i�i!i�i/i�i�i�ii-ii�iQi*i�i.i/i�i�i�ii0�3ii"
i�i*iRi�i�iWi�i�i/iibi.i�i�	i�i�i�i�i�iRiii�i)i�i2i�i�	i�i�i�i�i�i�iZ	i�iTiiw
i�i�i�i�	i�i�i�ii�i�i[	�Oi�i�	i�i`i7ix
i^
i�i�i�i�i�i�i\	i�i�i�i�i�i�igi�i�ini�i
i_i�i~��i�i�i0i�i�
iai�iy
i]	i�i�i�i�i��i�i�	i;��i�	i-i�i�iL	i���i�i/ii�i�i��`i�i#i"i�ii�ii0i�
isii�i�idisi�
i�iY
i�iikiwioi�i�i�i�i�i1ii2i��gipiQi�iUi�ivi�i�i���CiSi�i^	i�i�i5i�i�iBi�i_i�ibiN��i�iXi�i�i�i�
�iLici�
i�
i	iKiwi*iaiGi3i�i
i�i�ii1i6i�	i2i6	�Ni�i�ii	i3i�i:i�i\iqi�i�ii-i�iii3i�
i�i�i�ixi�
�i�iri�i4i�
i_
i�iUi�i�i�i@i�i5i�ii�i�ii�i/i+i6ii�ii�i�i�i�i�
i7	iZ
ii�i�i8i4iiCi�ii�i�ili�i`
i�i�i�i�i�iYi����i�i5i�	�{i�ii�i��$i7iiMiVi0iri�i�i�igiiVi�i8i�i9i,iZi�i�i{i#iWi0iii$i�i�
i�
i�i4ii[i��vi�iici�iViM	i$i-�i�iiXiii�idi�i�iWi[
ii�i�iiiqi�
ii1i�ii�iiti�ii�i	iii�
i2i�i2i:i3i i.i�i�i2i�i
i�i�i��i�i%ii�i�iii
i�ii�iii��
i�
i6i�i4i�i|ii�iSiii�i_	i�
ii�i�i�i`iii�i�i�	i3iii;iriiii7iYiLi;i�i�	i�	iii�iT�\i�i�ii<i�iVi5i�ii�
i�i�i�ii"ixi%ii;i8	i i�ii2iEi=i!i�ii��^iiwi�
i"i�i�iisi�i#i<iQii�iri$ii]ii%i�i.i&ii3i5iBi�iyi'i�i�i�ii�ii>iYia
ib
i(i�
i	i)i*i	i�i�i:i�i6i�i^iii�ii(i�
i+i+iiixi,i	i.ihi/i-ii�i
iVii�i�hi�izi.ii��i�i<i�i�i;i/i?i�ii
i�	i0i8i�ii�i5i6i�
i_�)i1i2i	i3iyi	�i�i�
ii^i4i�i�i?i$i+i\
i�i5i_iWi�iiz
i6i0ii�
i]
i	��ip	i7i�i�i8i^
i<
i�iVi9i�i6i�iI�wi}ic
i^ii
i9i@i�i
iAii�i�i�	i:iei1iiiBi�i�i�i�ii�i�ii�i7i;i<i�i=i{
i��(i`iRi1iYiiIi�	��ii�i6i�id
i>i�i�ie
i?i�io�iqiYinii�iliiCiDi{i�i�
i_
iEiPiUi�i�i�i�ii�iEimi�i@i�i:i�
ii
iAii�i�i�ii#
i�	iNi�
i�iBi�iCiWiTiT�i�i
i�if
i;iDii&i�
i|i�i�i�ii�i�
i�i�i<i=
i�
i�ii	iVi�i�
iioi�i�	iEi�
iFiii�i���i�i�iiiDi-i8i�iGidi�	ii�
iHiti�iiIizi
iiJi�
i�
iKii�i|
i�ii�i�i>
�i�i�i�iiiLi:i�	i=i�iMii?
i�i�iiHi�i�ii�iNii�i�	iOiPiiFikiQi9i���i�i�
i�	iuiivii�ii�iiRiSi�i�i}i
i>i�i�i�ii
i:iTi	i�iN	i�iCi�ii�iUi~i�i iWi�iGi�i�i�i,iiii�iOi�i|ii�i�iOi?iVi`	i�i i�i~iiwi�ii�i@i!i�i�i;i�i�iiWi�i"i�
iXi�iYiiRig
iuii�
ih
i�
ixi=i
iiZi�i<i�ii[i�i#ii=i 	i\i$ii]iHiIi^i7iO	i$
i
i_i%iviJi�i i!iwitii`iaibi9	i&i�i"i{�i�i�	i'ici�idi8i�ii�i�i[i9i�i�idiZi�	iei�i�i�i@
i!i(i"ifi���ii�i#i$iTigiKii�i%i��WiMihii�iii�i�i�i%i���i�i�i�i
i`
i�iyi7imiLijiki�i:	i>i!i�i��i�Bi)ili|i�i
izi���ii
i�iMi�i�i�
i�i�im�iniuiq	ivi�i�
i
i*iNioipi��iqi7i.iri�iyi�
iii�
i�ifi�i�i�isi!	iyi�
iOi	i�i�i�i+iPij
i�
i>i�i�i�i�i�Yi�iAiti�iui%
i
i�ivi�i�izi2iwi,i�	i�	�i�i3iQi�i�i
ixi�i6i9ik
i�ii&�6i��i-i
i�iRiyi�iQi9ici�
i'i.i
�oi(iBiFi?il
i�i)iei�i�
izi�
iSiTi�i�i�i{i/�i�i"	i�	ibi/i�i`i�i�i0iui�ivi�i�i1i�i�
i�	i�iUi�i*i�i/iE�iSi�i8iZi|i}iFi+ii�i!i~i2i,iFiP	i�im
ii
i�ieisi�iCi�ir	ii�i�ii�iai3iZi%i-i�i�i�i�	i4i�i�i�iAi�i�i�
i�
iii
i�i�i�iDi.i�ii�i�	ini�ii�i�i�
i�i�i	i�i3i5iJi0i�is	i�
i�i�i�i@i�i�iVi�i/i�	i�i6iWiAi7ioi�
i�iPi0i�i1i�in
i���a�Qi2i�ipi:i�iPi�ibi�i�i�i�ii{i3i7iEi�i�i�	i�i�i|iFiGiXi�i�i�i�i�i]i�
i4i�i�i}
�i�i�
i5i�i&i�i8i	
i���i�	i�i�i�i�i�iLi�i�i�i�i�
i�	iYi

i�ii�i�i4i
iBi9i8i�i�i�i�i�	iHi�
i/i3iZi[i�i�
io
i�i�i:i0i�ini\i�i]i�i^i���i�i�	i�i�i�iIi�i�i�i;i�i4i�i<�i=i;i�	ii
i�i�iXi�	i�i��i5i_i�i�
i�
i�i�i�i�i}i0i>ip
iJi�i�iK�i���i&
iFi�i�i�i�
i�
i#i�i[i�i�i��fi�>iq
i�i?ir
i�i6i�i�i�ii�
i�i�i�i�iji�i�ii�i@i-ipi9i;	i6iyiAi�i�ii�	i'
i�i�ii�i�ii��Vi�i�i`i�i4i�i�i�iKi
iai�
i6i�i�i�i�ii�i"i�i�iKi�i

ii�i�i�	iYiGioi�ibifici7iis
ip�ri�	i8��i�i�i�i�iiA
iQ	i�
iCi,i
i�i�i�ii�i\iLi�iu�i~
i�
i�i�i9i�i�iBi�iZi�i�i
iCi�i�iijidi�i0ihigi�iei�iMi}i7i�
i�i
i�iDi�	i�i�i�i�ifi:i�iiNi;i�
iEiFi�i(
�i�i<i�i�iGiMi=iwigi�i~it	i?i�i�i�i
itimi#	i�	i�i+i�i�ihi�i�i��ii[i�
iOi�	i�i�i�i
i�iB
i�i�i$	it
ii�
i�iia	i�i�	i�iHii�i�i�iQi"i<	i
i�i�i-i1i�i#iu
i'i�iDi�ii�i
i�
iIi�i>iJi%	i�i�iPii
iii�i�
i=ia
i�iKi�iv
i�i�i�i�i�
i�i���_i�iji�i?iEi1i�
i�
i�iki�i8iQi�i�ili�i�i
i�imi@i
�ibi�i�i�iiRi�i�i��5i�i�i�i�iLi	iw
iini�i��i4iHii�iMi�i��i�ii�i�ii\i�ioi�iNi]i�ii�
i�i\ix
igi�iEi
i�i�i�i�i�i�ipi�i�
i�iqi
i�i�i�i�i�iOi�i�i�iri�iZi�isiti�i�ii�iP�ei�i�i�i�i�ioi�i�i^ii}i�i�i�iziAi&	i�i�i�i�
i�i�ini-i�i�
iQiiii
i�i�i�iRi�iui�	i�i�iiBi�i�i�
iy
i�i�iviwiBihiqi�i�i�i<i�i*iiiSi"iTiCi>i)i
ixiUi�i�i�i~i�i�i��zi�iVi�i�i�i�iC
i)iqi�i�iWi
	i�i�i�iDi�iE�TiF�pi�i�i#i#iyi�i�
i�i�iGi�iz
i�ii�i�i�	i�i�i�iSi�iXi
i�i�i�i�iu	i
i=iHi�i�i_i�iRiii�i�i�iwi�i�iYizi{iqi�ii3i�i5i�i
i�i{
i�i�i|i}iSi~i�i
i
i�iZi[i�iii�i�i`i�iFi�i]ii�ini�i�iIi�i
ii�i�i�i�i�iGiTiJi�iKiziSiri\i)
ii
iv	�i5���ii�
ib	i�i�iji�i�i�i�i�
i�i�i]i^i�i�i�ici�i�i�ii�
i�i�
iai:i1i�i�i�i��Aihiiai�
i6i�i�i��ib
�-i�i
iHi_ii�	i�i
i�i�i�ii�i�i�i|
i�i*
ifi�i	i�ii�
iD
ii
iLiWi�iiiUii�
ii�i$i�i
i
i�iNiiiR	iki�iE
i�i�iiiMi�iS	i'	ii`i�isi�iF
ii�iai}
i�i�
i(	ijii	i~
iViB�[ibiWi�i�ibi
iIi�ic
ii
i�i{i�i�i�	i�i�	ici�
i�	iidi
i�
i]i�i�i�i=	ieii�iii�i�
i���i
iNi	i�i�ifigi�
i�
i�
i�ihiiiii�
�=i�iXii�ii�i�i�i�i�id
i�iHiCi�
iii�iTiWi�
i
i�i9i�i�	iNi�iKiEiji4iJi�
iYi
i�iG
i	ikii�ihiOii�
i�
ii]iPiZi�ili�iQi[iki�iminiRioic	i�ii�i��iSiXiiii\i+i�i�i�i�iIiTiUiU��ii
i�ili�
iDiiiipiiqi
�ki�	imi�i�
iKii�ii�i�iVi8i�
i i�iri@iWiri�
iCiGi��i�i
i�i^i�
i�i��8itii:i�i
i!i�inisi�i"i�
i#i$i]iti�	i%i�
i&iriui'i+
i(i)i�ie
i
i}i
i�i�i�i*i4�1i+i�i�i�i�i�ii�i,ii�
i>	iXitiri?	i�i�
i-i�iviui{i�iw	iwi�i.ixiT	i,
iii�i/i0i�i�i�i1i�
i�i2i�
iGiRi
i�i^i�iYi
iZi�i
i[i3i^i�i�i�i�i�i
i)	i\i�	i4i@ivi�i5i�i6i7i�id	i]i�
i�i^i8i�i&i�	i�ii9iyiu�ii�
i�iziRi�i{i�i�i�i(i_i�i<i9i�ili�i�i�i_i 
iSi`iki�i[i�	i�i�i�
ixi:i�i;i<i!
i$i=i�i|ii�i>idi�
ii?ieii�i�i�ii�i�i�ii�
i}i@iAiBi�i.i~iaiOi
i�i�i`ibi�i�
i%ii�i�i�
i;i�
i�ii�iCiiDi�i�ii�if
i"
iLi�
i�i�i�i�
iEi;i�iFi&iGi�
i
i�ix	iHi)i�i�ici�iIidiTi�i�
i�
iei�i�i�ii	i�iJiigi~�iUi�ie	i	iii�ifiai8igi�
i�	ibihiKiy	i�i�i�iLii:i�
i�ii��i*iMiii�i�iciti�iMiNi�i�i�i�i	i�i
i�i�if	i�i�iYidiei��*ii�iOiH
i�i#
i�i#i;i�
i�	i�i�i�iI
i\i@	i�i�i�isi$
i�
iPiQi�
i�	i�
iRijiSiTi�i+i�iUi�iVi�i�iLi�
i!i�iJ
i\�4iWi�iiXiYiZi�i[i>iwikifi�i�i+i�ii%
i�i�i$i�i\i�i�iili�
i]i�ili^i_ig
i%i�i`iaigiii�i�
i�iNiK
ibicidi�i�
iciwi�
iei�ibiyi�ifihigihihi�i'iiiimi�iz	ijidiii�ii	i<i�i�i|�i�i�i�i�i�i�iiOiki�
ilii�i�
iai�i�imi�i�i�ini�
i�iui�ini�i�i�iei&
i�
ioi�i�ii�	i<i�ipiqiPiQi�iji�	i�i	i�i�i(i�i_irisi�i�i�ii<iEiRifi�i��i�i]i�i�iIiti=i�iui�ivi�i�
i�ioi�
i�
iki,iliwi'
i�i�	imi�i�i�iFi`i�i�ifi�i�i�
iSiJixi�iyizini�iL
��ipiOi�i�i�
i{i�
i�i�iA	iyi�i�iU	��i|i}i~iFi�iqi�i�
i�	i�i�ii�iii�i�iipi�i�iB	i�ioi	i�i�i�ipii-
i�iri�i�iqiqi�i(
i�iri�i�i�isi�i�i�i�
i�i�i�
i(i.
isi)
i�itii�	ii*
i�iui�i�iTiviM
i{	i�i�iti�i'i�i�i�i�
i�i�i�i�i�i�i�igiZiwi�
i�	ici�iji+
ipi�i�i�ixi�i�i�ihi�i�i�i�
i�i�i�i�i,
i=ii�i�	iiui�i�ii�i/
iyi�i
i�	iyivi�	i�i�iwi�i�i�i�i�i�i�i�
izi�i�ii�i>i�iCi'i�i�i�i{iiZi�i�i�i�i�i�i�i�iaii�i�	i�iqi?i�i
i�i|i�i�	i"i�i�
i�ii}i�i�i�i�i=iiAi�i1i�i)i�i�i�i?i�
i�
i�ii�ixi	i�i	ii�	i�
i�i�ihi�iSi�i�i�i(i�i�
i�i�i'ixiyi�i�
i�i�i
i�
i�i�i�i�i_i	i�i�i>i�i}iPi�i�i�i�i�ii~i�i
iN
iici�i
i�i�i�iHi�i	iii�i�i�i�i�i�ii�i�i�i�i�iji�i�i�	i*	i�i�i�i�
i�ii�iih
i�i�i_i�i��/i�i<i�i~i7ikiTi�ii]iiUibi�
iti�i�ig	i�izi�i�
i�i|	ii�i�i�i�i�i�i�i{i�i�i�	ii0
i�i�
i�i+	i�i,	i�i�i��Ii�i�i�i�i�ii�iiBi�i�i4isi�
i�i�i�i�i�i�
i�i�i?iCi�i�i	i�iGi�i�i�i�i�i�i�i�i�i�i�i�i�ii�i|i1
i�iimiC	i�i�ili�i�ii
i}	i�i?i�i�ii�i�i�ih	i�i�iIi�i�i�iVii�i�i�i�i�i�i^i�i�i�i�i-	i.	i�ii)i�i�i�
i�i�i�i2
i�iiii�i�
i�i�i�iAi�i�i�i-
i�i�i�i�i�i�
i�i
i�i�	i�i�i�i�i�i�
i�i�
i�i�i�
i�i�iQi�i�
iO
i�i�i�i�ii�i�iziKi�i��i[i�iJi�i�i@i�i.
i�i�i�i�iD	ii}i/
i@i�i�
i�i�i�
i�i@iiRi�i�i�	ij
i~i�i�iJi�i�i�
i�i�i���i�
i0
i�imi�i�iimi~	i�i	i�ii1
i�i�i�	i�i�ii�i�i�
idi�i�i�iXi�i�i9i�i�ii�i�iUi�i�i�i�i�iLi�i3
i�ii�i�
i	i�i�i�i�	i��i�i�
i�ii$i(ivi�i�i&i�ibi�i�i�i�i�i�i�ii�i�i�i{i�i�i�i�i�i�i�i�i�i�i2
i�i�	i�i�i�i�	ii�i�
i�i�i�i�i�i�i�i^i�i�iV	i�	i�i�i�i�i�i�i�i�i�i�i�i�ii2iW	i�i
iWioii	iik
iXi�i�i�	iAi4
i�i�
i�i3
i�i�i�	i�i�i�i�i�
i�i�i�
i�i�i�i�i�i�i�i	��iHi�i�i�i�i�iiiii�iDii�iIisi
i�i�i�
i�i i�i�i�i�iwi�i{iii�ii�i�i/	ini,iiii�i	i�	i�i�i
i�iiii
ii4
iBi�ii�iP
i5
i�
i�i�
i�	i�i�
i�i	i�ii|i�iziii�i�i
i'i�i5
i�ii�i!i�i��yi�i�iVii�i�i�	i�i�i�ii�i�i�i�i�ii�	i�
iii-ii�i�i�ii�
ii�
i�	i�i�iii�
i�i"i%ii�i�iJiCii��xi�i�iii�i	iil
i6
i�i�iii�
ii�
i�iiXi�ii�i7
ii�	i�
iNiim
iii�i iWii�i!i�	ii
i�
i>i8
i�i"i#i9
ij	iDi�i�ii$i	
i%ii�
i�i�iXi&ii'iEi�i(iFii)i�ixi�	ikii�ii�i*i+i�i�i�iDi�i�i,i�i�ii�i�iiKi-i.i/i:
i�i0iJi�ii1i|i�i�i�i�i�i�i�iEi*i2i�
i�ii�ii�iHixii�ii3i�i�i�i�i3ii�i�i;
ipi�i<
ii�ii�i�i4i5i	i�	i6i�iO��i
i7i8i�i9i�i:i�i�i;i�i�i�i�i<i�
iiYi=i>i
i	i?i�i@iAiBi�
i�i�i=
i�	i�i�ioi�	ifi�ii�i�
i�
i�	i�	iCiiDi�i#i�i�
i>
i�iEi�i�iFiZiE	i�i�i�	i[i$i�
i�iGi?
ii�	i�i�iGi�i�i�i@
iHi�iA
i\iLi�i�i�i�i�
iIi	iii�ii�iiiJi�	i�i�
i	iKiLi]iMiNi
i�iji�iQ
i�
iB
iOiPi�i�iQi�
i�i�iRi�
iSiTi�i(i�ii�iC
i�iUiiVi�iWiXi�i�iYi�i�i�iZ�i�idi[iciHi�i_i�i#i0	i\ii]i�ini

i�	i�i�ii^ii�i_ik	iD
i�i`iai�i�ibi�i�i�	ici�i�i�i�idi�ii�	i�iiidi^iE
ieiii�i�
ii�i�ifi�i_i7iii�i i�
i�iF
iiigi-i�ii!ii�ihi�	iqi;i�i�i�i�iXi�i i	i�i�iiiji�i�i�i
ikili�i�i~imiG
i`iniyipi�i�ioi>i�ipi�iqi
i�i�iri�iai�i�i�isiti"iui|i�i?ii�iivi�i�i�i�i�iei�i�iwixiyi�i�i�i�izi{i@i|i�i�	i}i�i�	i�i�i%isiiR
i�i.i�iMi?i�
i�i~ii�ibii�i@i�i�i�ii�i�i�i�i�i�i�i�i�i�i�
i�i6
iIi�i�i�i�i�i�i�i�ici�i�i�i�i�i�i�i2ii�i�imi�i@i�i�i�i�	i�i�iNii�i�ifiii�iZi�
i�i�i�i�i�i�i\iH
i�idi�i�iJi�i�	i�i�	i�
i�i�i�i�i�iKi�i�i�i#i�i�i�i�i�i�	i�i�i�iKi�i�i�i�igi�i�i�ihi�i>i�i.i�i�i�i�i�i�i�ii)in
�ti�iii�i�
io
i�
iI
i�i�
i�iiqi�i�iri�i�i���i�i�ip
i�i�	i�i�iziii�iUi�iJ
i�i�i1	iK
iti�i�i�i�i���i�
i�i�iJi�iiLi�	i�i�i�i�i�i�N)Z EUCTW_TYPICAL_DISTRIBUTION_RATIOZEUCTW_TABLE_SIZEZEUCTW_CHAR_TO_FREQ_ORDER�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euctwfreq.py�<module>,ssite-packages/pip/_vendor/chardet/__pycache__/escsm.cpython-38.pyc000064400000016415151446177000021110 0ustar00U

��.e)�H@s�ddlmZdZejejdejejejejejejejejejejejejejejejejejejejdejdejdejdddejdejdddejdejdejejejejejejejf0ZdZedeedd	d
�ZdZ	ejdejejejejejejejejejejejejejejejejejejejejejejejejejejejejdejejejejejejejejejddejejejejejejejejejejejejejejejejejejejejejejf@Z
dZe	d
e
edd	d
�ZdZ
ejdejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejdejejejdejejejejejdejejejejejejejejejejejejejejejejejejejejejejejejejejejejfHZdZe
deeddd
�ZdZejdejejejejejejejejejejejejejejejejejejejdejejejejejejdejejejejejejejejejejejf(ZdZedeeddd
�ZdS)�)�MachineState(r�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�r��rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rr�)rrrrrrz
HZ-GB-2312ZChinese)Zclass_tableZclass_factorZstate_tableZchar_len_table�nameZlanguage(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)	rrrrrrrrr�	zISO-2022-CN(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrr
rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)
rrrrrrrrrr�
zISO-2022-JPZJapanese(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrzISO-2022-KRZKoreanN)ZenumsrZHZ_CLSZSTARTZERRORZITS_MEZHZ_STZHZ_CHAR_LEN_TABLEZHZ_SM_MODELZ
ISO2022CN_CLSZISO2022CN_STZISO2022CN_CHAR_LEN_TABLEZISO2022CN_SM_MODELZ
ISO2022JP_CLSZISO2022JP_STZISO2022JP_CHAR_LEN_TABLEZISO2022JP_SM_MODELZ
ISO2022KR_CLSZISO2022KR_STZISO2022KR_CHAR_LEN_TABLEZISO2022KR_SM_MODEL�rr�=/usr/lib/python3.8/site-packages/pip/_vendor/chardet/escsm.py�<module>s$�	�$��$��$��site-packages/pip/_vendor/chardet/__pycache__/euctwfreq.cpython-38.opt-1.pyc000064400000065012151446177000022737 0ustar00U

��.e�{�@sdZdZdZdS)g�?i(�ii��i����	�R�i����ii�i�
�ni��!i�i�L�,iA�isi�i�i�i�iL
iS
i�ii�i�i�i�i.iNiii�����:i�i�i��?i�i�i=iN�K���i�il	i�i�i�
i���i�
i ��
ii��i�
ioi$i�ii�i�ici8i�i�ii��i�i��iz�|��it�"i�
ie�@i\i�i�	i�i��i�i�i�iFi�iM
iQ�Hi�i��Piv��ifi�ii�iDiT
i�i�iFiN
i��Ei�iO�i/i��si�i3�<�2i��i&iLi�i�iO
�i�iG�iiMi�i�i?iii`iiF	i*i�igi�	�Zi�
i:i��i�iKi�	�i�	�ii�i�i�i`i�ii�ig�i	i �qi�i~i���iP
i�	ii�i�i�i!i��u�i�i*ii�i	i�
i��~i�i�i��iei��Gi^i�i��i��UiCi�iBi�i�i�i�ii�i �jioi/ii�iOi2	i[i���i�
i&i�i�i�i��Si(i�i��ip�]i�i6iii�
i'iii�iii8��+i%i[�i�i\i�i�i�i�iX	i(i���i�i0��i iHi�
i�
i"i!��i+i�i1i"i�i�i�
iOiG	i�iifi1��i�i�i�i�i�ii2i9���li,��i	ii�ii�i�i}ihi#iq
iQiMi&i��Xi�i�i#i���i
��i�iji�i��M�i�i��%�i�i�i$i�i��'i�	i�iNiii�7��Ji�i!i�i�ii���iMi�i)iPiU
i���i�
i�i%i�
i�
i�� i�i�
i iIi�i3	i�i�
iir
�i�i�i�i���mi�i�i$i�i�ixi�i�i�i�i�
i�i�i�i%i&��i
ii�i�i�i�i��&i�i'i�ii'i�i��.�i�ii�iH	i���i�i�i$�#i�iDi&iAi�	�i�i�i�i�iUiGii�i�i
iQ
iPiSi'i�i��di��0�Fi�i�i*i�i�ii�ii�iJii�iU�i��iI	iR
i�i�i<i�iS
i:i7
i�
i�i	i	i9i�i}ii�	i�i�iViPiT
ii)iCii�i�i&i�
i�	i)i�i�im	i�i�i�i�i�ii4	i�i�i�in	i*ii�i�ii�i�iOi�i�i�i�i�	i+i(i
i�i�i�iU
i(i�i5iYiji�
ili�iuii)i�
i*i+iV
i
i=i�i�i�i�i�i�i�i4i�i!i�i�iTi,ixi�i�ie�i�	i�iJ	iPi�is
i5iAiV
i/iki�i�
iili!i	i�iAi�i`i�i�
i��iAi�i�
iii�i�
i�i�	i�i�i�i�i���iMi�
i�i�i�ii�iW
i�i�i�
it
i�i�i+�}i�iji8
i�i�i�i�i�i�i�i�i-i)imi�	i�iW
i�i		i�i�
i�iai�i
iPiK	i�i,i�i�i�i7i'iu
i�i{iki�i�ii�i�
i9
i�iii�i�i�i�i�i�i�i1���bii�	i�
i�i�io	i�iX
i,iQi��i�i�i�ii�
i�
iX
i��i�i5�D�i�ili�i�i[i 
i��iY
i�i%�i.iY	i�i*i�i�i�
i�iRi�i�i�ipi��in�cigi+ii�i'i2i��i�i{i�ili�imi�i�i:
i�ifi
	i�i|i5	��i�ii�iZ
i�i�
i�i�i�i�i,i�i�i�i��;i�iIiYi�i�i[
iXi"i�i	i�i�i�i~i�i�i,i�iki�i�i-i�i�ii�i�iDi�i�i�i>i]i�i,i�i�i�iviLiB�ii&i�i�i�
i�i�i�iGi�i�iiBi�i�
i!
i�i�iui�i�i�i�i�	i iaii�i�iv
iSi�i}i;
i�iDi�i=i�i0ii�i\
i(i�ii�ivi �i�i�i��i.i�i��9iHii�i�i�i]
iEi�i�i�i�i�i!i�i/i�i�i�ii-ii�iQi*i�i.i/i�i�i�ii0�3ii"
i�i*iRi�i�iWi�i�i/iibi.i�i�	i�i�i�i�i�iRiii�i)i�i2i�i�	i�i�i�i�i�i�iZ	i�iTiiw
i�i�i�i�	i�i�i�ii�i�i[	�Oi�i�	i�i`i7ix
i^
i�i�i�i�i�i�i\	i�i�i�i�i�i�igi�i�ini�i
i_i�i~��i�i�i0i�i�
iai�iy
i]	i�i�i�i�i��i�i�	i;��i�	i-i�i�iL	i���i�i/ii�i�i��`i�i#i"i�ii�ii0i�
isii�i�idisi�
i�iY
i�iikiwioi�i�i�i�i�i1ii2i��gipiQi�iUi�ivi�i�i���CiSi�i^	i�i�i5i�i�iBi�i_i�ibiN��i�iXi�i�i�i�
�iLici�
i�
i	iKiwi*iaiGi3i�i
i�i�ii1i6i�	i2i6	�Ni�i�ii	i3i�i:i�i\iqi�i�ii-i�iii3i�
i�i�i�ixi�
�i�iri�i4i�
i_
i�iUi�i�i�i@i�i5i�ii�i�ii�i/i+i6ii�ii�i�i�i�i�
i7	iZ
ii�i�i8i4iiCi�ii�i�ili�i`
i�i�i�i�i�iYi����i�i5i�	�{i�ii�i��$i7iiMiVi0iri�i�i�igiiVi�i8i�i9i,iZi�i�i{i#iWi0iii$i�i�
i�
i�i4ii[i��vi�iici�iViM	i$i-�i�iiXiii�idi�i�iWi[
ii�i�iiiqi�
ii1i�ii�iiti�ii�i	iii�
i2i�i2i:i3i i.i�i�i2i�i
i�i�i��i�i%ii�i�iii
i�ii�iii��
i�
i6i�i4i�i|ii�iSiii�i_	i�
ii�i�i�i`iii�i�i�	i3iii;iriiii7iYiLi;i�i�	i�	iii�iT�\i�i�ii<i�iVi5i�ii�
i�i�i�ii"ixi%ii;i8	i i�ii2iEi=i!i�ii��^iiwi�
i"i�i�iisi�i#i<iQii�iri$ii]ii%i�i.i&ii3i5iBi�iyi'i�i�i�ii�ii>iYia
ib
i(i�
i	i)i*i	i�i�i:i�i6i�i^iii�ii(i�
i+i+iiixi,i	i.ihi/i-ii�i
iVii�i�hi�izi.ii��i�i<i�i�i;i/i?i�ii
i�	i0i8i�ii�i5i6i�
i_�)i1i2i	i3iyi	�i�i�
ii^i4i�i�i?i$i+i\
i�i5i_iWi�iiz
i6i0ii�
i]
i	��ip	i7i�i�i8i^
i<
i�iVi9i�i6i�iI�wi}ic
i^ii
i9i@i�i
iAii�i�i�	i:iei1iiiBi�i�i�i�ii�i�ii�i7i;i<i�i=i{
i��(i`iRi1iYiiIi�	��ii�i6i�id
i>i�i�ie
i?i�io�iqiYinii�iliiCiDi{i�i�
i_
iEiPiUi�i�i�i�ii�iEimi�i@i�i:i�
ii
iAii�i�i�ii#
i�	iNi�
i�iBi�iCiWiTiT�i�i
i�if
i;iDii&i�
i|i�i�i�ii�i�
i�i�i<i=
i�
i�ii	iVi�i�
iioi�i�	iEi�
iFiii�i���i�i�iiiDi-i8i�iGidi�	ii�
iHiti�iiIizi
iiJi�
i�
iKii�i|
i�ii�i�i>
�i�i�i�iiiLi:i�	i=i�iMii?
i�i�iiHi�i�ii�iNii�i�	iOiPiiFikiQi9i���i�i�
i�	iuiivii�ii�iiRiSi�i�i}i
i>i�i�i�ii
i:iTi	i�iN	i�iCi�ii�iUi~i�i iWi�iGi�i�i�i,iiii�iOi�i|ii�i�iOi?iVi`	i�i i�i~iiwi�ii�i@i!i�i�i;i�i�iiWi�i"i�
iXi�iYiiRig
iuii�
ih
i�
ixi=i
iiZi�i<i�ii[i�i#ii=i 	i\i$ii]iHiIi^i7iO	i$
i
i_i%iviJi�i i!iwitii`iaibi9	i&i�i"i{�i�i�	i'ici�idi8i�ii�i�i[i9i�i�idiZi�	iei�i�i�i@
i!i(i"ifi���ii�i#i$iTigiKii�i%i��WiMihii�iii�i�i�i%i���i�i�i�i
i`
i�iyi7imiLijiki�i:	i>i!i�i��i�Bi)ili|i�i
izi���ii
i�iMi�i�i�
i�i�im�iniuiq	ivi�i�
i
i*iNioipi��iqi7i.iri�iyi�
iii�
i�ifi�i�i�isi!	iyi�
iOi	i�i�i�i+iPij
i�
i>i�i�i�i�i�Yi�iAiti�iui%
i
i�ivi�i�izi2iwi,i�	i�	�i�i3iQi�i�i
ixi�i6i9ik
i�ii&�6i��i-i
i�iRiyi�iQi9ici�
i'i.i
�oi(iBiFi?il
i�i)iei�i�
izi�
iSiTi�i�i�i{i/�i�i"	i�	ibi/i�i`i�i�i0iui�ivi�i�i1i�i�
i�	i�iUi�i*i�i/iE�iSi�i8iZi|i}iFi+ii�i!i~i2i,iFiP	i�im
ii
i�ieisi�iCi�ir	ii�i�ii�iai3iZi%i-i�i�i�i�	i4i�i�i�iAi�i�i�
i�
iii
i�i�i�iDi.i�ii�i�	ini�ii�i�i�
i�i�i	i�i3i5iJi0i�is	i�
i�i�i�i@i�i�iVi�i/i�	i�i6iWiAi7ioi�
i�iPi0i�i1i�in
i���a�Qi2i�ipi:i�iPi�ibi�i�i�i�ii{i3i7iEi�i�i�	i�i�i|iFiGiXi�i�i�i�i�i]i�
i4i�i�i}
�i�i�
i5i�i&i�i8i	
i���i�	i�i�i�i�i�iLi�i�i�i�i�
i�	iYi

i�ii�i�i4i
iBi9i8i�i�i�i�i�	iHi�
i/i3iZi[i�i�
io
i�i�i:i0i�ini\i�i]i�i^i���i�i�	i�i�i�iIi�i�i�i;i�i4i�i<�i=i;i�	ii
i�i�iXi�	i�i��i5i_i�i�
i�
i�i�i�i�i}i0i>ip
iJi�i�iK�i���i&
iFi�i�i�i�
i�
i#i�i[i�i�i��fi�>iq
i�i?ir
i�i6i�i�i�ii�
i�i�i�i�iji�i�ii�i@i-ipi9i;	i6iyiAi�i�ii�	i'
i�i�ii�i�ii��Vi�i�i`i�i4i�i�i�iKi
iai�
i6i�i�i�i�ii�i"i�i�iKi�i

ii�i�i�	iYiGioi�ibifici7iis
ip�ri�	i8��i�i�i�i�iiA
iQ	i�
iCi,i
i�i�i�ii�i\iLi�iu�i~
i�
i�i�i9i�i�iBi�iZi�i�i
iCi�i�iijidi�i0ihigi�iei�iMi}i7i�
i�i
i�iDi�	i�i�i�i�ifi:i�iiNi;i�
iEiFi�i(
�i�i<i�i�iGiMi=iwigi�i~it	i?i�i�i�i
itimi#	i�	i�i+i�i�ihi�i�i��ii[i�
iOi�	i�i�i�i
i�iB
i�i�i$	it
ii�
i�iia	i�i�	i�iHii�i�i�iQi"i<	i
i�i�i-i1i�i#iu
i'i�iDi�ii�i
i�
iIi�i>iJi%	i�i�iPii
iii�i�
i=ia
i�iKi�iv
i�i�i�i�i�
i�i���_i�iji�i?iEi1i�
i�
i�iki�i8iQi�i�ili�i�i
i�imi@i
�ibi�i�i�iiRi�i�i��5i�i�i�i�iLi	iw
iini�i��i4iHii�iMi�i��i�ii�i�ii\i�ioi�iNi]i�ii�
i�i\ix
igi�iEi
i�i�i�i�i�i�ipi�i�
i�iqi
i�i�i�i�i�iOi�i�i�iri�iZi�isiti�i�ii�iP�ei�i�i�i�i�ioi�i�i^ii}i�i�i�iziAi&	i�i�i�i�
i�i�ini-i�i�
iQiiii
i�i�i�iRi�iui�	i�i�iiBi�i�i�
iy
i�i�iviwiBihiqi�i�i�i<i�i*iiiSi"iTiCi>i)i
ixiUi�i�i�i~i�i�i��zi�iVi�i�i�i�iC
i)iqi�i�iWi
	i�i�i�iDi�iE�TiF�pi�i�i#i#iyi�i�
i�i�iGi�iz
i�ii�i�i�	i�i�i�iSi�iXi
i�i�i�i�iu	i
i=iHi�i�i_i�iRiii�i�i�iwi�i�iYizi{iqi�ii3i�i5i�i
i�i{
i�i�i|i}iSi~i�i
i
i�iZi[i�iii�i�i`i�iFi�i]ii�ini�i�iIi�i
ii�i�i�i�i�iGiTiJi�iKiziSiri\i)
ii
iv	�i5���ii�
ib	i�i�iji�i�i�i�i�
i�i�i]i^i�i�i�ici�i�i�ii�
i�i�
iai:i1i�i�i�i��Aihiiai�
i6i�i�i��ib
�-i�i
iHi_ii�	i�i
i�i�i�ii�i�i�i|
i�i*
ifi�i	i�ii�
iD
ii
iLiWi�iiiUii�
ii�i$i�i
i
i�iNiiiR	iki�iE
i�i�iiiMi�iS	i'	ii`i�isi�iF
ii�iai}
i�i�
i(	ijii	i~
iViB�[ibiWi�i�ibi
iIi�ic
ii
i�i{i�i�i�	i�i�	ici�
i�	iidi
i�
i]i�i�i�i=	ieii�iii�i�
i���i
iNi	i�i�ifigi�
i�
i�
i�ihiiiii�
�=i�iXii�ii�i�i�i�i�id
i�iHiCi�
iii�iTiWi�
i
i�i9i�i�	iNi�iKiEiji4iJi�
iYi
i�iG
i	ikii�ihiOii�
i�
ii]iPiZi�ili�iQi[iki�iminiRioic	i�ii�i��iSiXiiii\i+i�i�i�i�iIiTiUiU��ii
i�ili�
iDiiiipiiqi
�ki�	imi�i�
iKii�ii�i�iVi8i�
i i�iri@iWiri�
iCiGi��i�i
i�i^i�
i�i��8itii:i�i
i!i�inisi�i"i�
i#i$i]iti�	i%i�
i&iriui'i+
i(i)i�ie
i
i}i
i�i�i�i*i4�1i+i�i�i�i�i�ii�i,ii�
i>	iXitiri?	i�i�
i-i�iviui{i�iw	iwi�i.ixiT	i,
iii�i/i0i�i�i�i1i�
i�i2i�
iGiRi
i�i^i�iYi
iZi�i
i[i3i^i�i�i�i�i�i
i)	i\i�	i4i@ivi�i5i�i6i7i�id	i]i�
i�i^i8i�i&i�	i�ii9iyiu�ii�
i�iziRi�i{i�i�i�i(i_i�i<i9i�ili�i�i�i_i 
iSi`iki�i[i�	i�i�i�
ixi:i�i;i<i!
i$i=i�i|ii�i>idi�
ii?ieii�i�i�ii�i�i�ii�
i}i@iAiBi�i.i~iaiOi
i�i�i`ibi�i�
i%ii�i�i�
i;i�
i�ii�iCiiDi�i�ii�if
i"
iLi�
i�i�i�i�
iEi;i�iFi&iGi�
i
i�ix	iHi)i�i�ici�iIidiTi�i�
i�
iei�i�i�ii	i�iJiigi~�iUi�ie	i	iii�ifiai8igi�
i�	ibihiKiy	i�i�i�iLii:i�
i�ii��i*iMiii�i�iciti�iMiNi�i�i�i�i	i�i
i�i�if	i�i�iYidiei��*ii�iOiH
i�i#
i�i#i;i�
i�	i�i�i�iI
i\i@	i�i�i�isi$
i�
iPiQi�
i�	i�
iRijiSiTi�i+i�iUi�iVi�i�iLi�
i!i�iJ
i\�4iWi�iiXiYiZi�i[i>iwikifi�i�i+i�ii%
i�i�i$i�i\i�i�iili�
i]i�ili^i_ig
i%i�i`iaigiii�i�
i�iNiK
ibicidi�i�
iciwi�
iei�ibiyi�ifihigihihi�i'iiiimi�iz	ijidiii�ii	i<i�i�i|�i�i�i�i�i�i�iiOiki�
ilii�i�
iai�i�imi�i�i�ini�
i�iui�ini�i�i�iei&
i�
ioi�i�ii�	i<i�ipiqiPiQi�iji�	i�i	i�i�i(i�i_irisi�i�i�ii<iEiRifi�i��i�i]i�i�iIiti=i�iui�ivi�i�
i�ioi�
i�
iki,iliwi'
i�i�	imi�i�i�iFi`i�i�ifi�i�i�
iSiJixi�iyizini�iL
��ipiOi�i�i�
i{i�
i�i�iA	iyi�i�iU	��i|i}i~iFi�iqi�i�
i�	i�i�ii�iii�i�iipi�i�iB	i�ioi	i�i�i�ipii-
i�iri�i�iqiqi�i(
i�iri�i�i�isi�i�i�i�
i�i�i�
i(i.
isi)
i�itii�	ii*
i�iui�i�iTiviM
i{	i�i�iti�i'i�i�i�i�
i�i�i�i�i�i�i�igiZiwi�
i�	ici�iji+
ipi�i�i�ixi�i�i�ihi�i�i�i�
i�i�i�i�i,
i=ii�i�	iiui�i�ii�i/
iyi�i
i�	iyivi�	i�i�iwi�i�i�i�i�i�i�i�
izi�i�ii�i>i�iCi'i�i�i�i{iiZi�i�i�i�i�i�i�i�iaii�i�	i�iqi?i�i
i�i|i�i�	i"i�i�
i�ii}i�i�i�i�i=iiAi�i1i�i)i�i�i�i?i�
i�
i�ii�ixi	i�i	ii�	i�
i�i�ihi�iSi�i�i�i(i�i�
i�i�i'ixiyi�i�
i�i�i
i�
i�i�i�i�i_i	i�i�i>i�i}iPi�i�i�i�i�ii~i�i
iN
iici�i
i�i�i�iHi�i	iii�i�i�i�i�i�ii�i�i�i�i�iji�i�i�	i*	i�i�i�i�
i�ii�iih
i�i�i_i�i��/i�i<i�i~i7ikiTi�ii]iiUibi�
iti�i�ig	i�izi�i�
i�i|	ii�i�i�i�i�i�i�i{i�i�i�	ii0
i�i�
i�i+	i�i,	i�i�i��Ii�i�i�i�i�ii�iiBi�i�i4isi�
i�i�i�i�i�i�
i�i�i?iCi�i�i	i�iGi�i�i�i�i�i�i�i�i�i�i�i�i�ii�i|i1
i�iimiC	i�i�ili�i�ii
i}	i�i?i�i�ii�i�i�ih	i�i�iIi�i�i�iVii�i�i�i�i�i�i^i�i�i�i�i-	i.	i�ii)i�i�i�
i�i�i�i2
i�iiii�i�
i�i�i�iAi�i�i�i-
i�i�i�i�i�i�
i�i
i�i�	i�i�i�i�i�i�
i�i�
i�i�i�
i�i�iQi�i�
iO
i�i�i�i�ii�i�iziKi�i��i[i�iJi�i�i@i�i.
i�i�i�i�iD	ii}i/
i@i�i�
i�i�i�
i�i@iiRi�i�i�	ij
i~i�i�iJi�i�i�
i�i�i���i�
i0
i�imi�i�iimi~	i�i	i�ii1
i�i�i�	i�i�ii�i�i�
idi�i�i�iXi�i�i9i�i�ii�i�iUi�i�i�i�i�iLi�i3
i�ii�i�
i	i�i�i�i�	i��i�i�
i�ii$i(ivi�i�i&i�ibi�i�i�i�i�i�i�ii�i�i�i{i�i�i�i�i�i�i�i�i�i�i2
i�i�	i�i�i�i�	ii�i�
i�i�i�i�i�i�i�i^i�i�iV	i�	i�i�i�i�i�i�i�i�i�i�i�i�ii2iW	i�i
iWioii	iik
iXi�i�i�	iAi4
i�i�
i�i3
i�i�i�	i�i�i�i�i�
i�i�i�
i�i�i�i�i�i�i�i	��iHi�i�i�i�i�iiiii�iDii�iIisi
i�i�i�
i�i i�i�i�i�iwi�i{iii�ii�i�i/	ini,iiii�i	i�	i�i�i
i�iiii
ii4
iBi�ii�iP
i5
i�
i�i�
i�	i�i�
i�i	i�ii|i�iziii�i�i
i'i�i5
i�ii�i!i�i��yi�i�iVii�i�i�	i�i�i�ii�i�i�i�i�ii�	i�
iii-ii�i�i�ii�
ii�
i�	i�i�iii�
i�i"i%ii�i�iJiCii��xi�i�iii�i	iil
i6
i�i�iii�
ii�
i�iiXi�ii�i7
ii�	i�
iNiim
iii�i iWii�i!i�	ii
i�
i>i8
i�i"i#i9
ij	iDi�i�ii$i	
i%ii�
i�i�iXi&ii'iEi�i(iFii)i�ixi�	ikii�ii�i*i+i�i�i�iDi�i�i,i�i�ii�i�iiKi-i.i/i:
i�i0iJi�ii1i|i�i�i�i�i�i�i�iEi*i2i�
i�ii�ii�iHixii�ii3i�i�i�i�i3ii�i�i;
ipi�i<
ii�ii�i�i4i5i	i�	i6i�iO��i
i7i8i�i9i�i:i�i�i;i�i�i�i�i<i�
iiYi=i>i
i	i?i�i@iAiBi�
i�i�i=
i�	i�i�ioi�	ifi�ii�i�
i�
i�	i�	iCiiDi�i#i�i�
i>
i�iEi�i�iFiZiE	i�i�i�	i[i$i�
i�iGi?
ii�	i�i�iGi�i�i�i@
iHi�iA
i\iLi�i�i�i�i�
iIi	iii�ii�iiiJi�	i�i�
i	iKiLi]iMiNi
i�iji�iQ
i�
iB
iOiPi�i�iQi�
i�i�iRi�
iSiTi�i(i�ii�iC
i�iUiiVi�iWiXi�i�iYi�i�i�iZ�i�idi[iciHi�i_i�i#i0	i\ii]i�ini

i�	i�i�ii^ii�i_ik	iD
i�i`iai�i�ibi�i�i�	ici�i�i�i�idi�ii�	i�iiidi^iE
ieiii�i�
ii�i�ifi�i_i7iii�i i�
i�iF
iiigi-i�ii!ii�ihi�	iqi;i�i�i�i�iXi�i i	i�i�iiiji�i�i�i
ikili�i�i~imiG
i`iniyipi�i�ioi>i�ipi�iqi
i�i�iri�iai�i�i�isiti"iui|i�i?ii�iivi�i�i�i�i�iei�i�iwixiyi�i�i�i�izi{i@i|i�i�	i}i�i�	i�i�i%isiiR
i�i.i�iMi?i�
i�i~ii�ibii�i@i�i�i�ii�i�i�i�i�i�i�i�i�i�i�
i�i6
iIi�i�i�i�i�i�i�i�ici�i�i�i�i�i�i�i2ii�i�imi�i@i�i�i�i�	i�i�iNii�i�ifiii�iZi�
i�i�i�i�i�i�i\iH
i�idi�i�iJi�i�	i�i�	i�
i�i�i�i�i�iKi�i�i�i#i�i�i�i�i�i�	i�i�i�iKi�i�i�i�igi�i�i�ihi�i>i�i.i�i�i�i�i�i�i�ii)in
�ti�iii�i�
io
i�
iI
i�i�
i�iiqi�i�iri�i�i���i�i�ip
i�i�	i�i�iziii�iUi�iJ
i�i�i1	iK
iti�i�i�i�i���i�
i�i�iJi�iiLi�	i�i�i�i�i�i�N)Z EUCTW_TYPICAL_DISTRIBUTION_RATIOZEUCTW_TABLE_SIZEZEUCTW_CHAR_TO_FREQ_ORDER�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euctwfreq.py�<module>,ssite-packages/pip/_vendor/chardet/__pycache__/mbcharsetprober.cpython-38.opt-1.pyc000064400000004265151446177000024117 0ustar00U

��.eU
�@s0ddlmZddlmZmZGdd�de�ZdS)�)�
CharSetProber)�ProbingState�MachineStatecsVeZdZdZd�fdd�	Z�fdd�Zedd��Zed	d
��Zdd�Z	d
d�Z
�ZS)�MultiByteCharSetProberz 
    MultiByteCharSetProber
    Ncs,tt|�j|d�d|_d|_ddg|_dS)N)�lang_filter�)�superr�__init__�distribution_analyzer�	coding_sm�
_last_char)�selfr��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/mbcharsetprober.pyr	'szMultiByteCharSetProber.__init__cs<tt|���|jr|j��|jr.|j��ddg|_dS)Nr)rr�resetrr
r�r
rrrr-s

zMultiByteCharSetProber.resetcCst�dS�N��NotImplementedErrorrrrr�charset_name5sz#MultiByteCharSetProber.charset_namecCst�dSrrrrrr�language9szMultiByteCharSetProber.languagecCstt|��D]�}|j�||�}|tjkrN|j�d|j|j	|�t
j|_q�q|tj
krft
j|_q�q|tjkr|j��}|dkr�|d|jd<|j�|j|�q|j�||d|d�|�q|d|jd<|jt
jkr�|j��r�|��|jkr�t
j|_|jS)Nz!%s %s prober hit error at byte %srr���)�range�lenrZ
next_staterZERRORZlogger�debugrrrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenrr
�feed�stateZ	DETECTINGZgot_enough_data�get_confidenceZSHORTCUT_THRESHOLD)r
Zbyte_str�iZcoding_stateZchar_lenrrrr=s8
�


�
�zMultiByteCharSetProber.feedcCs
|j��Sr)r
rrrrrrZsz%MultiByteCharSetProber.get_confidence)N)�__name__�
__module__�__qualname__�__doc__r	r�propertyrrrr�
__classcell__rrrrr"s

rN)Z
charsetproberrZenumsrrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/chardistribution.cpython-38.opt-1.pyc000064400000014047151446177000024311 0ustar00U

��.e�$�@s�ddlmZmZmZddlmZmZmZddlm	Z	m
Z
mZddlm
Z
mZmZddlmZmZmZGdd�de�ZGdd	�d	e�ZGd
d�de�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)�)�EUCTW_CHAR_TO_FREQ_ORDER�EUCTW_TABLE_SIZE� EUCTW_TYPICAL_DISTRIBUTION_RATIO)�EUCKR_CHAR_TO_FREQ_ORDER�EUCKR_TABLE_SIZE� EUCKR_TYPICAL_DISTRIBUTION_RATIO)�GB2312_CHAR_TO_FREQ_ORDER�GB2312_TABLE_SIZE�!GB2312_TYPICAL_DISTRIBUTION_RATIO)�BIG5_CHAR_TO_FREQ_ORDER�BIG5_TABLE_SIZE�BIG5_TYPICAL_DISTRIBUTION_RATIO)�JIS_CHAR_TO_FREQ_ORDER�JIS_TABLE_SIZE�JIS_TYPICAL_DISTRIBUTION_RATIOc@sLeZdZdZdZdZdZdd�Zdd�Zd	d
�Z	dd�Z
d
d�Zdd�ZdS)�CharDistributionAnalysisig�G�z��?g{�G�z�?�cCs0d|_d|_d|_d|_d|_d|_|��dS�N)�_char_to_freq_order�_table_size�typical_distribution_ratio�_done�_total_chars�_freq_chars�reset��self�r�H/usr/lib/python3.8/site-packages/pip/_vendor/chardet/chardistribution.py�__init__.sz!CharDistributionAnalysis.__init__cCsd|_d|_d|_dS)zreset analyser, clear any stateF�N)rrrrrrrr=szCharDistributionAnalysis.resetcCsX|dkr|�|�}nd}|dkrT|jd7_||jkrTd|j|krT|jd7_dS)z"feed a character with known length����r riN)�	get_orderrrrr)r�charZchar_len�orderrrr�feedFs
zCharDistributionAnalysis.feedcCsT|jdks|j|jkr|jS|j|jkrN|j|j|j|j}||jkrN|S|jS)z(return confidence based on existing datar )rr�MINIMUM_DATA_THRESHOLD�SURE_NOr�SURE_YES)r�rrrr�get_confidenceTs�
z'CharDistributionAnalysis.get_confidencecCs|j|jkSr)r�ENOUGH_DATA_THRESHOLDrrrr�got_enough_datadsz(CharDistributionAnalysis.got_enough_datacCsdS)Nr"r)r�byte_strrrrr#isz"CharDistributionAnalysis.get_orderN)
�__name__�
__module__�__qualname__r,r)r(r'rrr&r+r-r#rrrrr(s	rcs$eZdZ�fdd�Zdd�Z�ZS)�EUCTWDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	�superr2rrrrrrrr��	__class__rrrrsz"EUCTWDistributionAnalysis.__init__cCs0|d}|dkr(d|d|ddSdSdS)Nr ���^r�r"r�rr.�
first_charrrrr#xsz#EUCTWDistributionAnalysis.get_order�r/r0r1rr#�
__classcell__rrr4rr2qsr2cs$eZdZ�fdd�Zdd�Z�ZS)�EUCKRDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3r=rrrrrrrrr4rrr�sz"EUCKRDistributionAnalysis.__init__cCs0|d}|dkr(d|d|ddSdSdS)Nr �r7rr8r"rr9rrrr#�sz#EUCKRDistributionAnalysis.get_orderr;rrr4rr=�sr=cs$eZdZ�fdd�Zdd�Z�ZS)�GB2312DistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3r?rrrr	rr
rrr4rrr�sz#GB2312DistributionAnalysis.__init__cCs>|d|d}}|dkr6|dkr6d|d|dSdSdS)Nr rr>r8r7r"r�rr.r:�second_charrrrr#�sz$GB2312DistributionAnalysis.get_orderr;rrr4rr?�sr?cs$eZdZ�fdd�Zdd�Z�ZS)�Big5DistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3rBrrrrrr
rrr4rrr�sz!Big5DistributionAnalysis.__init__cCsX|d|d}}|dkrP|dkr:d|d|ddSd|d|dSndSdS)	Nr r�r8��?�@r"rr@rrrr#�sz"Big5DistributionAnalysis.get_orderr;rrr4rrB�srBcs$eZdZ�fdd�Zdd�Z�ZS)�SJISDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3rGrrrrrrrrr4rrr�sz!SJISDistributionAnalysis.__init__cCsr|d|d}}|dkr0|dkr0d|d}n&|dkrR|dkrRd|dd}nd	S||d
}|dkrnd	}|S)Nr r��������r"rF�r)rr.r:rAr%rrrr#�sz"SJISDistributionAnalysis.get_orderr;rrr4rrG�srGcs$eZdZ�fdd�Zdd�Z�ZS)�EUCJPDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3rOrrrrrrrrr4rrr�sz"EUCJPDistributionAnalysis.__init__cCs0|d}|dkr(d|d|ddSdSdS)Nr �r7r8rr"r)rr.r$rrrr#�sz#EUCJPDistributionAnalysis.get_orderr;rrr4rrO�srON)Z	euctwfreqrrrZ	euckrfreqrrrZ
gb2312freqrr	r
Zbig5freqrrr
Zjisfreqrrr�objectrr2r=r?rBrGrOrrrr�<module>sIsite-packages/pip/_vendor/chardet/__pycache__/charsetprober.cpython-38.opt-1.pyc000064400000006566151446177000023606 0ustar00U

��.e��@s0ddlZddlZddlmZGdd�de�ZdS)�N�)�ProbingStatec@sneZdZdZddd�Zdd�Zedd��Zd	d
�Zedd��Z	d
d�Z
edd��Zedd��Z
edd��ZdS)�
CharSetProbergffffff�?NcCsd|_||_t�t�|_dS�N)�_state�lang_filter�loggingZ	getLogger�__name__Zlogger)�selfr�r�E/usr/lib/python3.8/site-packages/pip/_vendor/chardet/charsetprober.py�__init__'szCharSetProber.__init__cCstj|_dSr)rZ	DETECTINGr�r
rrr�reset,szCharSetProber.resetcCsdSrrrrrr�charset_name/szCharSetProber.charset_namecCsdSrr)r
�bufrrr�feed3szCharSetProber.feedcCs|jSr)rrrrr�state6szCharSetProber.statecCsdS)Ngrrrrr�get_confidence:szCharSetProber.get_confidencecCst�dd|�}|S)Ns([-])+� )�re�sub)rrrr�filter_high_byte_only=sz#CharSetProber.filter_high_byte_onlycCs\t�}t�d|�}|D]@}|�|dd��|dd�}|��sL|dkrLd}|�|�q|S)u9
        We define three types of bytes:
        alphabet: english alphabets [a-zA-Z]
        international: international characters [€-ÿ]
        marker: everything else [^a-zA-Z€-ÿ]

        The input buffer can be thought to contain a series of words delimited
        by markers. This function works to filter all words that contain at
        least one international character. All contiguous sequences of markers
        are replaced by a single space ascii character.

        This filter applies to all scripts which do not use English characters.
        s%[a-zA-Z]*[�-�]+[a-zA-Z]*[^a-zA-Z�-�]?N�����r)�	bytearrayr�findall�extend�isalpha)r�filteredZwordsZwordZ	last_charrrr�filter_international_wordsBs�z(CharSetProber.filter_international_wordscCs�t�}d}d}tt|��D]n}|||d�}|dkr<d}n|dkrHd}|dkr|��s||kr�|s�|�|||��|�d�|d}q|s�|�||d	��|S)
a�
        Returns a copy of ``buf`` that retains only the sequences of English
        alphabet and high byte characters that are not between <> characters.
        Also retains English alphabet and high byte characters immediately
        before occurrences of >.

        This filter can be applied to all scripts which contain both English
        characters and extended ASCII characters, but is currently only used by
        ``Latin1Prober``.
        Frr�>�<TrrN)r�range�lenrr)rrZin_tag�prevZcurrZbuf_charrrr�filter_with_english_lettersgs"

z)CharSetProber.filter_with_english_letters)N)r	�
__module__�__qualname__ZSHORTCUT_THRESHOLDr
r�propertyrrrr�staticmethodrr r&rrrrr#s




$r)rrZenumsr�objectrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/big5freq.cpython-38.opt-1.pyc000064400000065006151446177000022441 0ustar00U

��.ez�@sdZdZdZdS)g�?�(�i	i��i����	�R�i����iai�i�ni��!i�i�L�,iB�i�i�i�i�i��i{
i]
i�i�i
iji�i�i.iNiii�����:i�i�i��?i�i�i=iN�K���ikiq	i�i�i�
i��iib��
i�i��i�
ioi2i�ii�i�ici8i�i�ii��i�i��i{�|��i��"i�
i��@i\i�i�	i�i��i�i�i�iFi�i|
iQ�Hi�i��Piv��i�i�ii�iDi^
i�i�iFi}
i��Ei�iO�i0i��si�i4�<�2i��i&iMi�i�i~
�i�iG�ii[i�i�i?iiiaiiK	i*i�igi�	�Zi�
i:i��i�iKi�	�i�	�ii�i�i�i`ilii�i��i
	i �qi�i~i���i
i�	ii�i�i�ici��u�i�i*ii�i	i�
i��~imi�i��iei��Gi^i�in�i�UiCi�iCi�i�i�i�ii�i �jioi/ii�iPi7	i[i���i�
i?i�i�i�io�Si(i�i�ip�]i�i6ijii@iii�iii8��+i3i[�i�i\i�i�i�i��i]	iAi���i�i1��i�iHi�
i�
idi���i+i�i2i�i�i�i�
iOiL	i�iifi1��i�i�i�i�i�ii3i9���li,��i	ii�ii�i�i�i�ieiz
iQiMi&i��Xi�i�i�i���i
��i�ikipi��M�i�i��%�i�i�i�i�i��'i�	i�i\i�i�7��Ji�i!i�i�ii���iNi�iBiPi_
iq��i�
i�i�i�
i�
i�� i�ii iIi�i8	i�i�
ii{
�i�i
i�i���mi�i�ifi�i�ixi�i�i�i�i�
i�i
i�igi���i
ii�i�i�i�i��&i�i'i�ii�i�i��.�i�ii�iM	i���i�i�i$�#i�iDihiAi�	�i�iri�i�iUiGii�i�i
i�
iQiSiii�i��di�0�Fi�i�iCi�i�ii�i i�iJii�iU�i��iN	i�
i�i�i<i�i�
i:iA
i�
i�i	i 	i9i�i}ii�	i�i�iWiPi�
ii)iDii�i�i4i�
i�	i)i�i�ir	i�isi�i�itii9	i�i�i�is	i*ii�i�i�i�i�i]i�i�i�i�i�	iDiji(
i
i�i�i�
i�iui5iYiji	ili�iuii�i�
i�i�i`
i
i=i�i�i�i�i�i�i�i5i�i!i�i�iTiEixi�i�ie�i�	i�iO	iPi�i|
i6iAi�
i/iki�i�
iili!i	i�iBi�i`i�i
i��iAi�iiii�i�
ivi�	i�i�iwi�i���iMi�
i�i�i�ii�ia
i�i�i�
i}
i�ixi,�}i�i�iB
i�i�i�i�i�i�i�i�iFikimi�	i�i�
i�i	i�i�
i�ibi�i)
i^iP	i
i,i�i�i�i7i5i~
iyi|i�izi�ii�i�
iC
i{iii�i�i�i�i�i�i�i1���bii�	i�
i�i�it	i�i�
i�i_i��i�i�i�ii�
i�
ib
i��i�i5�D�i�ili�i|i[i*
i��i�
i�i%�iGi^	i�ili�i�i�
i�i`i�i�i�ipi��in�cigimii�i'i2i��i�i{i�i�i�i�i�i�iD
i�ifi	i�i|i:	��i�ii�i�
i�i�
i
i�i�i�ini�i�i�i��;i�iIiYi}i�i�
iXi"i�i
i�i�i�i�i�i�i-i�ili�i�i�i�i�ii�i�iEi�i~i�i>i]i�i,i�i�i�iviLiB�ii&i�i�ii�i�i�iGi�i�iiBi�i�
i+
i�ii�i�i�i�i�i�	i iaii�i�i
iai�i}iE
i�iDi�i=i�i0ii�i�
i6i�ii�ivi!�i�i�i��i�i�i��9iHii�i�i�i�
iFi�i�i�i�i�i"i�iHi�i�i�i
ioii�iRi*i�i.i�i�i�i�iiI�3ii,
i�i*iSi�i�iXi�i�i/iibipi�i�	i�i�i�i�i�iRiii�i7i�i2i�i�	i�i�i�i�i�i�i_	i�ibii�
i�i�i�i�	i�i�i�ii�i�i`	�Oi�i�	i�i`i7i�
i�
i�i�i�i�i�iia	i�i�i�i�i�i�igi�i�i�i�i
i_i�i~��i�i�i�i�i�
iai�i�
ib	i�i�i�i�i��i�i�	i;��i�	i-i
i�iQ	i���i�iqii�i�i��`i�i#i#i�ii�iiri�
isii�i�iditi�
i�ic
i�iikiwi�i�i�i�i�i�i�ii�i��gi�iQi�iUi
i�i�i�i���CiSi�ic	i�i�i5i�i�iBi�i_i�iciN��i�iYi�i�i�i�
�iLidi�
i�
i	iKi�i8iaiGi�i�i
i�i�iisi6i�	iti;	�Ni�i�ii	i4i�i:i�i\iqi�i�i�i.i�iiiui�
i�i�i�i�i�
�i
iri�i�i�
i�
i�ici�i�i�i@i�i�i�ii�i�ii�i/i9i�ii�ii�i�i�i�i�
i<	id
ii�i�i8iviiCi�ii
i�imi�i�
i�i�i�i�i�iZi����i�iwi�	�{i�i�i�i��$i�iiMidi0iri�i�i�igiiVi�i�ii�i:iZi�i�i{i$iei0i�ii$i�i�
i�
i�i5i�i[i��vi�iici�iViR	i$i;�i�iifiii�idi�i�iWie
ii�i�iii�i�
iiJi�ii�iiui�i	i�i
i�ii�
iKi�i2i�iLi i.i�i�i2i�ii�i�i��i�i%ii�i�ii
ii�ii�iii��
i�
ixi�iMi�i}ii�iTii�i�id	i�
ii�i�i�i`iii�i�i�	i3iii;i�iiiiyiYiLi�i�i�	i�	iii�iU�\i�i�ii�i�iViNi�ii�
i�i�i 
i�i"ixi%ii;i=	i i�i�i2iEi�i!i�i�i��^i�i"iwi�
i#i�i�i�i�i�i$i<iQi�i�iri%i�i]i�i&i�i<i'ii3i6iBi�i�i(i�i�i�i�i�ii�igi�
i�
i)i�
i	i*i+i!	i�i��i:i�i7i�i^i�ii�ii(i�
i,i+iiixi-i�i/ihi=i.i�i��i�iVii�i�hi�i�i/ii��i�i<i�i�i;i0i�i�i�i
i�	i1izi�ii�i5i6i�
i_�)i2i3i�i4iyi"	�i�i�
i�i^i5i�i�i?i%i+if
i�i6i_iWi�i�i�
i7i>ii�
ig
i#	��iu	i8i�i�i9ih
iF
i�iVi{i�iOi�iI�wi~i�
i^ii�i:i�i�i�i�i�i�i�i�	i;iei1i�i�i�i�i�i�i�i�i�i�iiiPi<i=i�i>i�
i��(i`iRi?iYi�iIi�	��i�i�i7i�i�
i?i�i�i�
i@i�io�iqiYinii�ilii�i�i�i�i�
ii
iEiPiVi�i!
i�i�i�i�i�ini�iAi�i|i�
ii
iBi�i�i�i�ii-
i�	iOi�
i�iCi�iDiWiTiT�i�i�i�i�
i}iEi�i&i�
i�i�i�i�ii�i�
i�i�i~iG
i�
i�ii$	iWi�ii�ioi�i
iFiiGi�ii"
i���i�i#
i�i�iDi-iQi�iHiei�	iiiIi�i�iiJizi
i�iKiiiLi�i$
i�
i�i�i�i�iH
�i�i�ii�i�iMi:i�	ii�iNi�iI
i�i�i�iHi�i�ii�iOi�i�i�	iPiQi�i�ikiRiRi���i�i�
i
i�i�i�i�i�i�ii�iSiTi�i�i�i%
i�i�i�i�i�i&
iSiUii�iS	i�iCi�i�i�iVi~i�i!iXi�i�i�i�i�i,i�ii�i�iOi�i|i�ii�iPi�ie	i�i�i�i�ii�i�i�i�i�i�i�i�iTi�i�i�iWi�i�iiXi�iYi�iRi�
iviii�
ii�i=ii�iZi�iUi�i�i[i�i�i�iVi%	i\i�i�i]i�i�i^i8iT	i.
i'
i_i�ivi�i�i�i�iwitii`iaibi>	i�i�i"i{�i�i�	i�ici�idi9i�iii�i[i9iiidihi
iei�i�i�iJ
i!i�i�ifi���ii�i�i�iTigi�ii�i%i��WiMihii�iii�i�i�i�i��i�i�i�i(
ij
i�iyi7imi�ijiki�i?	iWi"i�i��i�Bi�ili|i��i)
izi���i�
i�i�i�i�ii�i�im�iniuiv	iwi�i	i*
ii�ioipi��iqi7i.iri�i�i
iii�
i�ifi�i�i�isi&	iyii�i i�i�i�ii�i�
ii>i�i�i�i�i�Yi�i�iti�iui/
i+
i�ivi�i�i�i@iwii�	i�	�i�i3i�i�i�i,
ixi�i6i9i�
i	ii��6i��ii!ii�iyi�iQi:ici
i�ii-
�oi�i�iFiXi�
i�i�ifi�iizi�
i�i�i�i�i�i{i/�i�i'	i�	ibii�i`i�i�iiui	ivi�i�ii�i�
i
i
i�i�i�i�i0iE�iSi�i8i[i|i}iGi�ii�i!i~ii�iFiU	i�i�
iii�ieisi�i�i�iw	ii�i�i"iiai	iZi&i�i�i�i�i�	i
i�i�i�iAi�i�i�
iiiii�i�i�i�i�i�ii�i
ioi�ii�ii�
i
i�i	i�iAiiJi0i�ix	i�
i�i�i�iYi�i�i�i�i�i�	i�ii�iZi8ioii�iQi�i�i�i�i�
i���a�Qi�i�ipi;i�iPi�ibi�i�i�i�ii�i�i
i�i�i�i�	i�i�i�i�i�i�i�i�i�i�i�i]ii�ii�i�
�i�ii�i�i'i�ii.
i���i
i�i�ii�i�iLi�i�i�i�ii�	i�i/
i�ii�i�iBi0
i[ii8i�i�i�i�i�	i�ii/i3i�i�i�ii�
ii�ii0i�ini�i�i�ii�i���ii�	i�i�i�i�ii�iii�i4i�i�ii<i�	ii
i�i�iYi�	i�i��iCi�i�ii�
i�i�i�i�i}i1ii�
i�i�i�iK�i���i0
iFi�i�i�i�
ii#i�i\i�i�i��fi�>i�
i�ii�
i�i�i�i�i�ii�
i�i�i�i�iji�i�ii�ii-ipi9i@	i6iyii�i�ii
i1
i�i�ii�i�ii��Vi�i�i�i�i4i�i�i�iKi1
i�i�
iDi�i�i�i�ii�i#i�i�i�i�i2
ii�ii�	iZiHipi�i�igi�i�ii�
iq�ri
i���i�i�i�i�iiK
iV	i�
i\i,i
i�i�i�ii�i]i�i�iu�i�
iii�i�i�i�ii�iZi�i�i�
iii�iiji�i�i0ihihi�i�i�i�i�iEii�i	
i�ii�	i�i�i�i�i�i�i�ii�i�i�
iii�i2
�i�i�i�i�iiMi�iwi�i�i�iy	i?i�i�i�i

itimi(	i�	i�i+i�i�i�i�i�i��iiii�
i�i�	i�i�i�i
i�iL
i�i�i)	i�
ii�
i�iif	i�i�	i�iii�i�i�iRi"iA	i3
i�i�i-i1i�i$i�
i(i�i]i�i#i�i$i�
ii�i�i i*	i�i�i�i�i
i�i�i�
i=ik
i�i!i�i�
i�i�i�i�i�
i�i���_i�i�i�i�i^i2ii�
i�i�i�i9i�i�i�i�i�i�i4
i�i�i�i
�ibii�i�ii�i�ii��5i�i�i�i�i"i	i�
ii�i�i��i4iIii�i#i�i��i�iii�iiji�i�ii$iki�ii�
i�i\i�
igi�iEi5
i�i�i�i�i�i�i�i�i�
i�i�i6
i�i�ii	i�i%ii�i�i�i�i[i�i�i�i�i�ii�i&�ei�i�i�i�i�ioi�i�ili	i}i�i�i�izi�i+	i�i�i�ii�i�ini-i�i�
i'iiii
i�i�i�i(i�i�i�	i�i�ii�i�i�ii�
i�i�i�i�iBiiiqi�i�i�i<i�i*iji)i"i*i�i>i)i7
i�i+i�i�i�ii�i�i��zi�i,i�i�i�iiM
i)iri�i�i-i	i�i�i�i�i�i��Ti��pi�i�i#i#i�i�ii�i�i�i�i�
i�ii�i	i�	i�i�i�iSi�i.i8
i�i�i�i�iz	i9
i=i�i�i�imi�iSiii�i�i�ixi�i�i/i�i�iqi�ii3i�i5i�i:
i�i�
i�i�i�i�i�i�i�i
i;
i�i0i1i�iii�i�ini�i_i�i]ii�ini�i�i�i�i
i%i�i�i�i�i�i`i�i�i�i�iziTisi2i3
i�i
i{	�i5���ii�
ig	i�i�iki�i�i�ii�
i�i�i3i4i�i�i�ici i�i�i
i�
i�iiai:i1i�i�i�i!�Aihi ioi�
i6i"i�i��il
�-i�i
iai5ii�	i�i
i�i�i#i!i�i$i�i�
i�i4
ifi�i	i%i&i�
iN
ri
i�iWi�iii�ii�
i'i�i$i�ii<
i�iNiiiW	iki�iO
i�i�iii�i�iX	i,	ii6i&iti�iP
ii�i7i�
i�i�
i-	ijii	i�
i�iC�[ipi�i�i'i8i
ibi�im
ii�
i�i{i(i�i�	i�i�	i9i�
i�	ii:i
i�
i^i�i�i�iB	i;ii�iii�i�
i���i
i�i	i�i)i<i=i�
ii�
i�i>iiiii�
�=i�i�ii�ii�i�i�i�i�in
i�iHiDi�
i?i�iUiWi�
i=
i�i:i�i�	iNi�iKiEi@i4ici�
i�i>
i�iQ
i
iAii�ihi�ii�
i�
i(i]i�i�i�iBi*i�i�ili�iCiDi�iEih	i�ii�i��i�iXiiii�i+i�i�i�i+iJi�i�iU��ii
i�imi iEiiiiFiiGi
�ki�	ini�i�
idii�ii�i�i�iFi!i i�iri@i�iHi"iCiGi��i�i
i�i^i�
i�i��8iti)i;i�i?
i!i�ioiIi�i"i#i#i$i�iJi�	i%i�
i&iriKi'i5
i(i)i�io
i@
i}iA
i�i,i�i*i4�1i+i�i�i�i�i�i"i�i,ii�
iC	i�iuiriD	i-i�
i-i�iLivi{i�i|	iMi.i.iNiY	i6
iii�i/i0i/i�i�i1i$i�i2i%iGiRiB
i�i_i�i�iC
i�i�iD
i�i3i�i�i�i�i�i�ii.	i�i�	i4i@iwi�i5i�i6i7i�ii	i�i&i0i�i8i	i&i�	i*�i+iGiOiu�i#i�
i1iPiRi�iQi�i�i�i)i�i�i=i9i�ili�i�i�i�iE
iSi�iki�i\i�	i�i�i�
iyi:i�i;i<iF
i%i=i�iRiii>idi'i,i?iei$i�i2i3i-i�i�i4ii(iSi@iAiBi�i.iTi�iOi
i�i�i�i�i�i�
i&ii�i�i�
i<i�
i�ii�iCiiDi�i�iUi�ip
iG
iei�
i�i�i�i�
iEi;iViFi'iGi)i
i�i}	iHi*i�iWi�i�iIi�iTi�i�
i�
i�i�i�i�ii	i�iJi.igi~�iUi�ij	i	iiiXi�i�i8i�i*i�	i�i�iKi~	i�i�i�iLiiHi�
i�ii%��i+ifi�i�i�i�iti�iMiNi�i�i�ii	i�i 
i�i�ik	iYiiYi�i�i��*i/i�iOiR
iZiH
i�i#iIi�
i�	i�i�i5iS
i]iE	i[i\i
isiI
i+iPiQi,i�	i�
iRi�iSiTi�i,i�iUi]iVi�i�iLi-i!i�iT
i\�4iWi�iiXiYiZi�i[i>iwi�i�i�i�i+i^iiJ
i�i_i$i�i\i�i�iili.i]i`i�i^i_iq
i%i�i`iaiii�i�
i6igiU
ibicidiai�
iqixi�
iei
ibiyi�ifihigihi�i�i'iiii�i�i	ijiri�i
i0i	i=i�ibi|�i�i�i�i�i�i	iihiki�
ilii�i�
iai�icimi�ii�ini�
i�iui�i�idiei�isiK
i/ioi7i�i&i�	iJi8ipiqiiijifi�i�	igi	i�i�i(i�i`irisi�i�iii<iFikifi�i��i�i]i�i�iIiti>i�iui�ivi�i�
i�i�i�
i0i�i-i�iwiL
i�i�	i�i�i�i�iGiai�i
iti�i�i�
iSiKixiiyizi�i�iV
��i�iOi�i1�i�
i{i�
i�i�iF	iyi�i9iZ	��i|i}i~iFi�i�i�i�
i�	i:i�iiii2i�i�iipi�i;iG	i�i�i	ihi�i�i�ii7
i�i�i�iiqii�iM
i�iii�iii�i�i�i�
i�i�i�
i(i8
i�iN
i	ii3i�	iiO
i<ii�i�iTiiW
i�	i�i�i�i�i(i�i�i�i1i�i�i�i�i�i�i�iuiZii�
i�	ici�ijiP
ipi�i�i
ii�i�i�iviiiji�i�
i�i�i�i�iQ
iKii�i�	i'i�i�i�ii�i9
ii�i
i�	izi�i�	i
i�i�iki�i�i�i�i�i�i2i	i�ilii�i>i=iCi'i�i�i>i
iiZi�i�i�i�imini�i�ibii�i�	iiqi?i�i
i�ii�i�	i"i�i�
i?i
i}i�i�ioi@i>iiAi�i1i�i)i�i�i�i?i�
i�
i�ii�ixi	i�i	ii�	i3i�iihi�iili�i�i�i)i�i�
ipi�i'i�i�i�i4i�i�i
i�
i�i�i�iAi_i	iBi�iLi�i
iPiqi�ii�iriii�iiX
iicisi!
i�i�iiHi�i	iwi�i�i�iCiDitii�i�i�i�i�ixi
ii�	i/	i�iii5i
i4iuiir
i�ii_i�i��/i�i<i�i~i7iyimi�ii^i5inibi�
iti�iil	i�i�i�i6i�i�	i7i�i�i�i�i�iivi�i�i�i�	i8i:
i�i�
i�i0	i�i1	i�iwi�Ii�i�i�i�i�i(i�iiBi�i�i4isi�
i�i�i�i�i
i�
i�i�i?iCiixi	iEiHii�iFiyiziGi�ii�i�i{i�i�ii|i�i;
i}i9imiH	i~i�izi�i�is
i�	i�iMi�i�ii�i�iim	i�i�iIi�i�iioii�ii�ii�i�i_ii�i�i�i2	i3	iHii*i�ii�
ii�i�i<
i�iii:i�i�
i�i�i�iAi�i�i�iR
i�i�i�iii�
i�i"
i�i�	i�i�i�i�i�i�
ii�
i�i�i�
i�i�iQii�
iY
iii�i�ii�ii{iKi�i�i[iiJi�i�iNi�iS
i�i�i�i�iI	ii�iT
i@ii�
i�i�i�
i�i@iiRi�i�i�	it
i�ii�iJiIi�i�
i�i�i��i�
iU
i�imii�i�i{i�	i�i�	i
i;iV
i�ii�	ii�i<i�ii�
idi�i�i�iXi�i�i9i�i�i6i�i�iUi�i�i�i i�iLi!i=
i�i)i�i�
i	ii�i�i�	i�i�i�
ii=i$i(ivi�ii&i�ici�iii�i	i
i�i>i�i�i�i{i"i�i�i�i�i#i�i�i�i�iW
i�i�	i�i�i�i�	ii$i�
i%ii�i�i�i�i&i^i�i�i[	i�	i�i'ii�i�ii�i�i�i(i i�ii2i\	iJi
ipipin	iiu
iqi)i�i�	iOi>
i�i�
i*iX
i�i�i�	i+i�i�i,i�
i�i�i�
i�i�i�i�iKi�i
i		��iIi-i�i�i!i�i�i�i�i�i.iDi�i�iJisi#
i�i�i�
i�i7i�i�i�i/iwi�i|iii�i�i�i"i4	i|i,iii�i�i�	i�i�ii�iiii�i?iY
iPi0ii1iZ
iZ
i�
i�i�
i�	i�i�
i#i@i2ii|i�iziii�i�iAi'i�i?
i�i	i�i8i�i��yi�iLiVi
i3ii�	i�i$i�ii�iMi�i%i�ii�	i�
ii
i.ii4iNi�iiii�
i�	i�i�ii�i�
i5i9i%ii�i�iKiQii��xi6i7iiBi�i
	iOiv
i[
i�i�i&ii�
ii�
i�iiXi�i*i�i\
iPi�	i�
iNi+iw
iii�iiWiCi�ii�	iQiDii?i]
i�iii^
io	iRi	
i�iEii
iiFii'i�iXiiGiiSi�iiTiRii8ixi�	ikiSi�iTi�ii i�i�i�iDi�i9i!i�i�ii�i(iiLi"i#i$i%i_
i�i&iJi:iUi�i}ii)i�i

i;i<i
iEi+i'i�
i�iHi=iVi*iHiyi,i+iWi3i>i�i�i?i(iIi,i-i`
iqi�ia
ii�ii
i�i)i*iXi�	i+i�iO��iYi,i-i�i.i�i/i�i�i0i.i�i�i�i1i�
iJiri2i3i$
i	i4i�i5i6i7i�
i�ib
i�	i�i�i}i�	ifi�iKi�i�
i�
i�	i�	i8iZi9i�i:i�i�
ic
i�i:i�ii;isiJ	i@i�i�	iti;i�
i/i<id
ii�	i�i�iUi�i0i�ie
i=i�if
iuiMi�i�i�i�i�
i>i	i[iiAiLi�iii?i�	i
i�
i	i@iAiviBiCi\i�iji�i[
i�
ig
iDiEi�i�iFiiBi�iGi�
i�iHi�i(i�iMiCih
i�iIiNiJiiKiLi�i�iMi�i1i2iN�i�idiOidiViDi`i�i#i5	iPi]iQiEini
i�	i�i�i^iRi_iFiSip	ii
i�iTiUi�i

i�iVi�i�i�	i�iGi�i�i�ieiHiOi�	i�iPi`iWiwij
iXi ii3i�
iai�iIiYiJixi7iii�i-i�
i4ik
iibiZi-i�ii.ici�i[i�	iri;i�iKi5iLiXi�i i	i�i�i\i]i�i�i6i%
i^i_i�i�i~i`il
iyiaizi~i�i�ibi?i�ici7idi
i�i�iei�izi�i�iMifigi/ihi|i�i@idi�iiiiNi�i�i�i8ifi�i�ijiki�iOiPi�i�ilimi@ini9i�	ioi�i�	i�i�i<isii\
iQi.iRiNi@i�
i�ipiiSi{iqi�iAi�i�i�ii�iTi
i�i�i�i:i�i�iri�
isi@
iWi;itiui�iviwixiyi|i�i�i�i�izi�i�i3iQi�i�imi�iAi{i|i�i�	i�i}iOiRi�i�igiii~iZi�
ii�i�i�i�i�i\im
i�i}i�i<iXi�i�	i�i�	i�
i�i�i�i
i�iYi�i�i�i0i�i�i�i�i=i�	i�i�i�iLi�i�i�i�ihi�i�i�iii>i>i�i/i?iUi�i�i�i�i�iei)ix
�ti�ifiSi�i�
iy
i�
in
i
ii�iTii@i�i�i�i�i���i�i�i�i�i�	i�i�iziUigi�iVi�io
i�i�i6	ip
iti�i�i�i�i���i�
iAi�iJiVihiZi�	i�iWi�i�i�i�N)ZBIG5_TYPICAL_DISTRIBUTION_RATIOZBIG5_TABLE_SIZEZBIG5_CHAR_TO_FREQ_ORDER�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/chardet/big5freq.py�<module>+ssite-packages/pip/_vendor/chardet/__pycache__/eucjpprober.cpython-38.opt-1.pyc000064400000004556151446177000023260 0ustar00U

��.e��@s`ddlmZmZddlmZddlmZddlmZddl	m
Z
ddlmZGdd�de�Z
d	S)
�)�ProbingState�MachineState)�MultiByteCharSetProber)�CodingStateMachine)�EUCJPDistributionAnalysis)�EUCJPContextAnalysis)�EUCJP_SM_MODELcsPeZdZ�fdd�Z�fdd�Zedd��Zedd��Zd	d
�Zdd�Z	�Z
S)
�EUCJPProbercs4tt|���tt�|_t�|_t�|_	|�
�dS�N)�superr	�__init__rr�	coding_smr�distribution_analyzerr�context_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/eucjpprober.pyr%s

zEUCJPProber.__init__cstt|���|j��dSr
)rr	rrrrrrr,szEUCJPProber.resetcCsdS)NzEUC-JPrrrrr�charset_name0szEUCJPProber.charset_namecCsdS)NZJapaneserrrrr�language4szEUCJPProber.languagecCs6tt|��D]�}|j�||�}|tjkrN|j�d|j|j	|�t
j|_q�q|tj
krft
j|_q�q|tjkr|j��}|dkr�|d|jd<|j�|j|�|j�|j|�q|j�||d|d�|�|j�||d|d�|�q|d|jd<|jt
jk�r0|j���r0|��|jk�r0t
j|_|jS)Nz!%s %s prober hit error at byte %s�r���)�range�lenr
Z
next_staterZERRORZlogger�debugrrrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenZ
_last_charr�feedr�stateZ	DETECTINGZgot_enough_data�get_confidenceZSHORTCUT_THRESHOLD)rZbyte_str�iZcoding_stateZchar_lenrrrr8s@
�


���zEUCJPProber.feedcCs|j��}|j��}t||�Sr
)rr r�max)rZcontext_confZdistrib_confrrrr Ys

zEUCJPProber.get_confidence)�__name__�
__module__�__qualname__rr�propertyrrrr �
__classcell__rrrrr	$s

!r	N)ZenumsrrZmbcharsetproberrZcodingstatemachinerZchardistributionrZjpcntxrZmbcssmrr	rrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/codingstatemachine.cpython-38.pyc000064400000005471151446177000023627 0ustar00U

��.e�@s(ddlZddlmZGdd�de�ZdS)�N�)�MachineStatec@sDeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Ze	dd
��Z
dS)�CodingStateMachinea�
    A state machine to verify a byte sequence for a particular encoding. For
    each byte the detector receives, it will feed that byte to every active
    state machine available, one byte at a time. The state machine changes its
    state based on its previous state and the byte it receives. There are 3
    states in a state machine that are of interest to an auto-detector:

    START state: This is the state to start with, or a legal byte sequence
                 (i.e. a valid code point) for character has been identified.

    ME state:  This indicates that the state machine identified a byte sequence
               that is specific to the charset it is designed for and that
               there is no other possible encoding which can contain this byte
               sequence. This will to lead to an immediate positive answer for
               the detector.

    ERROR state: This indicates the state machine identified an illegal byte
                 sequence for that encoding. This will lead to an immediate
                 negative answer for this encoding. Detector will exclude this
                 encoding from consideration from here on.
    cCs0||_d|_d|_d|_t�t�|_|��dS)Nr)	�_model�_curr_byte_pos�_curr_char_len�_curr_state�loggingZ	getLogger�__name__Zlogger�reset)�selfZsm�r
�J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/codingstatemachine.py�__init__7szCodingStateMachine.__init__cCstj|_dS�N)r�STARTr�rr
r
rr?szCodingStateMachine.resetcCsh|jd|}|jtjkr0d|_|jd||_|j|jd|}|jd||_|jd7_|jS)NZclass_tablerZchar_len_tableZclass_factorZstate_tabler)rrrrrr)r�cZ
byte_classZ
curr_stater
r
r�
next_stateBs�zCodingStateMachine.next_statecCs|jSr)rrr
r
r�get_current_charlenPsz&CodingStateMachine.get_current_charlencCs
|jdS)N�name�rrr
r
r�get_coding_state_machineSsz+CodingStateMachine.get_coding_state_machinecCs
|jdS)N�languagerrr
r
rrVszCodingStateMachine.languageN)r
�
__module__�__qualname__�__doc__rrrrr�propertyrr
r
r
rr!sr)r	Zenumsr�objectrr
r
r
r�<module>ssite-packages/pip/_vendor/chardet/__pycache__/langbulgarianmodel.cpython-38.opt-1.pyc000064400000056053151446177000024566 0ustar00U

��.e'2�@s4dZdZdZeeddddd�Zeedddd	d�Zd
S)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr�M�Z�c�d�H�m�k�e�O��Q�f�L�^�R�n��l�[�J�w�T�`�o��srrrrrr�A�E�F�B�?�D�p�g�\���h�_�V�W�G�t���U�]�a�q����������rrrrrr(r/r4r5r6r7r8��������������������������������������������������r�����������i�������������-������ �#�+�%�,�7�/�(�;�!�.�&�$�)��'��"�3�0�1�5�2�6�9�=���C���<�8���	���������
����
������������K�4���*��>�������:��b������rrr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr>r?r@rArBrCrDrE�xrFrGrHrIrJrKrLrM�N�@�S�yr��urWrNrOrPrQrRrSrTrU�XrVrXrYrZ�z�Y�jr[r\r]r_r`r^r|r~�I�P�v�rr�r�r�r�r�r�r�r�r�r�r�r�rarbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtrurvrwrxryrzr{r�r}rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�(�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g! _B�?Fz
ISO-8859-5Z	Bulgairan)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1251Z	BulgarianN)ZLatin5_BulgarianCharToOrderMapZwin1251BulgarianCharToOrderMapZBulgarianLangModelZLatin5BulgarianModelZWin1251BulgarianModel�r�r��J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langbulgarianmodel.py�<module>%s"�
�site-packages/pip/_vendor/chardet/__pycache__/chardistribution.cpython-38.pyc000064400000014047151446177000023352 0ustar00U

��.e�$�@s�ddlmZmZmZddlmZmZmZddlm	Z	m
Z
mZddlm
Z
mZmZddlmZmZmZGdd�de�ZGdd	�d	e�ZGd
d�de�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)�)�EUCTW_CHAR_TO_FREQ_ORDER�EUCTW_TABLE_SIZE� EUCTW_TYPICAL_DISTRIBUTION_RATIO)�EUCKR_CHAR_TO_FREQ_ORDER�EUCKR_TABLE_SIZE� EUCKR_TYPICAL_DISTRIBUTION_RATIO)�GB2312_CHAR_TO_FREQ_ORDER�GB2312_TABLE_SIZE�!GB2312_TYPICAL_DISTRIBUTION_RATIO)�BIG5_CHAR_TO_FREQ_ORDER�BIG5_TABLE_SIZE�BIG5_TYPICAL_DISTRIBUTION_RATIO)�JIS_CHAR_TO_FREQ_ORDER�JIS_TABLE_SIZE�JIS_TYPICAL_DISTRIBUTION_RATIOc@sLeZdZdZdZdZdZdd�Zdd�Zd	d
�Z	dd�Z
d
d�Zdd�ZdS)�CharDistributionAnalysisig�G�z��?g{�G�z�?�cCs0d|_d|_d|_d|_d|_d|_|��dS�N)�_char_to_freq_order�_table_size�typical_distribution_ratio�_done�_total_chars�_freq_chars�reset��self�r�H/usr/lib/python3.8/site-packages/pip/_vendor/chardet/chardistribution.py�__init__.sz!CharDistributionAnalysis.__init__cCsd|_d|_d|_dS)zreset analyser, clear any stateF�N)rrrrrrrr=szCharDistributionAnalysis.resetcCsX|dkr|�|�}nd}|dkrT|jd7_||jkrTd|j|krT|jd7_dS)z"feed a character with known length����r riN)�	get_orderrrrr)r�charZchar_len�orderrrr�feedFs
zCharDistributionAnalysis.feedcCsT|jdks|j|jkr|jS|j|jkrN|j|j|j|j}||jkrN|S|jS)z(return confidence based on existing datar )rr�MINIMUM_DATA_THRESHOLD�SURE_NOr�SURE_YES)r�rrrr�get_confidenceTs�
z'CharDistributionAnalysis.get_confidencecCs|j|jkSr)r�ENOUGH_DATA_THRESHOLDrrrr�got_enough_datadsz(CharDistributionAnalysis.got_enough_datacCsdS)Nr"r)r�byte_strrrrr#isz"CharDistributionAnalysis.get_orderN)
�__name__�
__module__�__qualname__r,r)r(r'rrr&r+r-r#rrrrr(s	rcs$eZdZ�fdd�Zdd�Z�ZS)�EUCTWDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	�superr2rrrrrrrr��	__class__rrrrsz"EUCTWDistributionAnalysis.__init__cCs0|d}|dkr(d|d|ddSdSdS)Nr ���^r�r"r�rr.�
first_charrrrr#xsz#EUCTWDistributionAnalysis.get_order�r/r0r1rr#�
__classcell__rrr4rr2qsr2cs$eZdZ�fdd�Zdd�Z�ZS)�EUCKRDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3r=rrrrrrrrr4rrr�sz"EUCKRDistributionAnalysis.__init__cCs0|d}|dkr(d|d|ddSdSdS)Nr �r7rr8r"rr9rrrr#�sz#EUCKRDistributionAnalysis.get_orderr;rrr4rr=�sr=cs$eZdZ�fdd�Zdd�Z�ZS)�GB2312DistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3r?rrrr	rr
rrr4rrr�sz#GB2312DistributionAnalysis.__init__cCs>|d|d}}|dkr6|dkr6d|d|dSdSdS)Nr rr>r8r7r"r�rr.r:�second_charrrrr#�sz$GB2312DistributionAnalysis.get_orderr;rrr4rr?�sr?cs$eZdZ�fdd�Zdd�Z�ZS)�Big5DistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3rBrrrrrr
rrr4rrr�sz!Big5DistributionAnalysis.__init__cCsX|d|d}}|dkrP|dkr:d|d|ddSd|d|dSndSdS)	Nr r�r8��?�@r"rr@rrrr#�sz"Big5DistributionAnalysis.get_orderr;rrr4rrB�srBcs$eZdZ�fdd�Zdd�Z�ZS)�SJISDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3rGrrrrrrrrr4rrr�sz!SJISDistributionAnalysis.__init__cCsr|d|d}}|dkr0|dkr0d|d}n&|dkrR|dkrRd|dd}nd	S||d
}|dkrnd	}|S)Nr r��������r"rF�r)rr.r:rAr%rrrr#�sz"SJISDistributionAnalysis.get_orderr;rrr4rrG�srGcs$eZdZ�fdd�Zdd�Z�ZS)�EUCJPDistributionAnalysiscs$tt|���t|_t|_t|_dSr)	r3rOrrrrrrrrr4rrr�sz"EUCJPDistributionAnalysis.__init__cCs0|d}|dkr(d|d|ddSdSdS)Nr �r7r8rr"r)rr.r$rrrr#�sz#EUCJPDistributionAnalysis.get_orderr;rrr4rrO�srON)Z	euctwfreqrrrZ	euckrfreqrrrZ
gb2312freqrr	r
Zbig5freqrrr
Zjisfreqrrr�objectrr2r=r?rBrGrOrrrr�<module>sIsite-packages/pip/_vendor/chardet/__pycache__/sjisprober.cpython-38.pyc000064400000004622151446177000022155 0ustar00U

��.e��@s`ddlmZddlmZddlmZddlmZddlm	Z	ddl
mZmZGdd�de�Z
d	S)
�)�MultiByteCharSetProber)�CodingStateMachine)�SJISDistributionAnalysis)�SJISContextAnalysis)�
SJIS_SM_MODEL)�ProbingState�MachineStatecsPeZdZ�fdd�Z�fdd�Zedd��Zedd��Zd	d
�Zdd�Z	�Z
S)
�
SJISProbercs4tt|���tt�|_t�|_t�|_	|�
�dS�N)�superr	�__init__rr�	coding_smr�distribution_analyzerr�context_analyzer�reset��self��	__class__��B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/sjisprober.pyr%s

zSJISProber.__init__cstt|���|j��dSr
)rr	rrrrrrr,szSJISProber.resetcCs|jjSr
)r�charset_namerrrrr0szSJISProber.charset_namecCsdS)NZJapaneserrrrr�language4szSJISProber.languagecCsNtt|��D]�}|j�||�}|tjkrP|j�d|j|j	|�t
j|_�qq|tj
krjt
j|_�qq|tjkr|j��}|dkr�|d|jd<|j�|jd|d�|�|j�|j|�q|j�||d||d|�|�|j�||d|d�|�q|d|jd<|jt
jk�rH|j���rH|��|jk�rHt
j|_|jS)Nz!%s %s prober hit error at byte %s�r�����)�range�lenr
Z
next_staterZERRORZlogger�debugrrrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenZ
_last_charr�feedr�stateZ	DETECTINGZgot_enough_data�get_confidenceZSHORTCUT_THRESHOLD)rZbyte_str�iZcoding_stateZchar_lenrrrr 8sH
�


�����zSJISProber.feedcCs|j��}|j��}t||�Sr
)rr"r�max)rZcontext_confZdistrib_confrrrr"Ys

zSJISProber.get_confidence)�__name__�
__module__�__qualname__rr�propertyrrr r"�
__classcell__rrrrr	$s

!r	N)ZmbcharsetproberrZcodingstatemachinerZchardistributionrZjpcntxrZmbcssmrZenumsrrr	rrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/euctwprober.cpython-38.opt-1.pyc000064400000002121151446177000023263 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�EUCTWDistributionAnalysis)�EUCTW_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�EUCTWProbercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euctwprober.pyr"s
zEUCTWProber.__init__cCsdS)NzEUC-TWrr
rrr�charset_name(szEUCTWProber.charset_namecCsdS)NZTaiwanrr
rrr�language,szEUCTWProber.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr!s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/compat.cpython-38.opt-1.pyc000064400000000476151446177000022220 0ustar00U

��.en�@s@ddlZejdkr(dZdZeefZeZndZdZeefZeZdS)�N)�rTF)	�sys�version_infoZPY2ZPY3�strZunicodeZbase_strZ	text_type�bytes�rr�>/usr/lib/python3.8/site-packages/pip/_vendor/chardet/compat.py�<module>s
site-packages/pip/_vendor/chardet/__pycache__/mbcharsetprober.cpython-38.pyc000064400000004265151446177000023160 0ustar00U

��.eU
�@s0ddlmZddlmZmZGdd�de�ZdS)�)�
CharSetProber)�ProbingState�MachineStatecsVeZdZdZd�fdd�	Z�fdd�Zedd��Zed	d
��Zdd�Z	d
d�Z
�ZS)�MultiByteCharSetProberz 
    MultiByteCharSetProber
    Ncs,tt|�j|d�d|_d|_ddg|_dS)N)�lang_filter�)�superr�__init__�distribution_analyzer�	coding_sm�
_last_char)�selfr��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/mbcharsetprober.pyr	'szMultiByteCharSetProber.__init__cs<tt|���|jr|j��|jr.|j��ddg|_dS)Nr)rr�resetrr
r�r
rrrr-s

zMultiByteCharSetProber.resetcCst�dS�N��NotImplementedErrorrrrr�charset_name5sz#MultiByteCharSetProber.charset_namecCst�dSrrrrrr�language9szMultiByteCharSetProber.languagecCstt|��D]�}|j�||�}|tjkrN|j�d|j|j	|�t
j|_q�q|tj
krft
j|_q�q|tjkr|j��}|dkr�|d|jd<|j�|j|�q|j�||d|d�|�q|d|jd<|jt
jkr�|j��r�|��|jkr�t
j|_|jS)Nz!%s %s prober hit error at byte %srr���)�range�lenrZ
next_staterZERRORZlogger�debugrrrZNOT_MEZ_stateZITS_MEZFOUND_ITZSTARTZget_current_charlenrr
�feed�stateZ	DETECTINGZgot_enough_data�get_confidenceZSHORTCUT_THRESHOLD)r
Zbyte_str�iZcoding_stateZchar_lenrrrr=s8
�


�
�zMultiByteCharSetProber.feedcCs
|j��Sr)r
rrrrrrZsz%MultiByteCharSetProber.get_confidence)N)�__name__�
__module__�__qualname__�__doc__r	r�propertyrrrr�
__classcell__rrrrr"s

rN)Z
charsetproberrZenumsrrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/gb2312prober.cpython-38.pyc000064400000002131151446177000022076 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�GB2312DistributionAnalysis)�GB2312_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�GB2312Probercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/gb2312prober.pyr"s
zGB2312Prober.__init__cCsdS)NZGB2312rr
rrr�charset_name(szGB2312Prober.charset_namecCsdS)NZChineserr
rrr�language,szGB2312Prober.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr!s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/mbcssm.cpython-38.pyc000064400000040515151446177000021260 0ustar00U

��.e�c��@sl	ddlmZdZejejejdejejejejejejejejejejejejejejejejejejejejfZdZedeedd�ZdZ	ejejdejejejd	dejd
ejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejfFZ
dZe	de
ed
d�ZdZ
dd	ddejejejejejejejejejejejejejejejejejejejejejejejejejejdejdejejejejejejejf(ZdZe
d
eedd�ZdZejejdejejejejejejejejejejejejejfZdZed	eedd�ZdZejejejdddd	ejejejejejejejejejejejejejejejejejejejejejejejejejdejejejejejejejejejejejejejejejf0ZdZedeedd�ZdZejejejejejejdejejejejejejejejejejejejejejejejejd	ejejejejejejejejejdejejejejejejejejejejejejejf0ZdZedeedd�ZdZejejejdejejejejejejejejejejejejejejejejejejejejfZdZed
eedd�Z dZ!dddejd	dejejejejejejejejejejejejd
d
d
d
ejejd
d
d
d
d
ejd
d
d
d
d
d
dddejddd
d
ejd
d
d
d
d
d
d
ejejejejf8Z"d Z#e!d
e"e#d!d�Z$dZ%d
d
dd
d	dejejejejejejejejejejejejdddejejejdddejdejd
d
dd
dddddejdddejejejdddddejdejejejf8Z&d"Z'e%d
e&e'd#d�Z(d$Z)ejejejejejejd%dd&d'ddd
dd	dejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejejddddejejejejejejejejejejejejejdddejejejejejejejejejejejejddddejejejejejejejejejejejejejejddejejejejejejejejejejejejd&d&d&d&ejejejejejejejejejejejejejejejd&ejejejejejejejejejejejejd%d%d%d%ejejejejejejejejejejejejejejejd%ejejejejejejejejejejejejd%d%d%ejejejejejejejejejejejejejejejejejejejejejejejejejejejf�Z*d(Z+e)d)e*e+d*d�Z,d+S),�)�MachineState(rrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrr�ZBig5)Zclass_tableZclass_factorZstate_tableZchar_len_table�name(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr�r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	�r
r
r
r
r
r
r
r
r
r
r
�rrr
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
r
�	rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	)
rrrrrrrrrr�
ZCP949(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrzEUC-JP(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrzEUC-KR(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrrr
zx-euc-tw(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r)rrrrrrrZGB2312(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrZ	Shift_JIS(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr)rrrrrrzUTF-16BE)rrrrrrzUTF-16LE(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r	r
rrrrrrrrrrrrrrrr
�rrrrrr��
rr��rrrrr)rrrrrrrrrrrrrrr	r	�zUTF-8N)-ZenumsrZBIG5_CLSZERRORZSTARTZITS_MEZBIG5_STZBIG5_CHAR_LEN_TABLEZ
BIG5_SM_MODELZ	CP949_CLSZCP949_STZCP949_CHAR_LEN_TABLEZCP949_SM_MODELZ	EUCJP_CLSZEUCJP_STZEUCJP_CHAR_LEN_TABLEZEUCJP_SM_MODELZ	EUCKR_CLSZEUCKR_STZEUCKR_CHAR_LEN_TABLEZEUCKR_SM_MODELZ	EUCTW_CLSZEUCTW_STZEUCTW_CHAR_LEN_TABLEZEUCTW_SM_MODELZ
GB2312_CLSZ	GB2312_STZGB2312_CHAR_LEN_TABLEZGB2312_SM_MODELZSJIS_CLSZSJIS_STZSJIS_CHAR_LEN_TABLEZ
SJIS_SM_MODELZ
UCS2BE_CLSZ	UCS2BE_STZUCS2BE_CHAR_LEN_TABLEZUCS2BE_SM_MODELZ
UCS2LE_CLSZ	UCS2LE_STZUCS2LE_CHAR_LEN_TABLEZUCS2LE_SM_MODELZUTF8_CLSZUTF8_STZUTF8_CHAR_LEN_TABLEZ
UTF8_SM_MODEL�rr�>/usr/lib/python3.8/site-packages/pip/_vendor/chardet/mbcssm.py�<module>sP$����$��$��$�	�$��&��$�
�$�
�$��site-packages/pip/_vendor/chardet/__pycache__/langthaimodel.cpython-38.opt-1.pyc000064400000053217151446177000023546 0ustar00U

��.e,�@sdZdZeeddddd�ZdS)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr��j�k�d����e�^���l�m�n�o����Y�_�p�q�����rrrrrr�@�H�I�r�J�s�t�f�Q���u�Z�g�N�R�`���[�O�T�h�i�a�b�\��rrrrr�����������X���������������v���������c�U�S��������������������������������K���4�"�3�w�/�:�9�1�5�7�+���,��0����'�>��6�-�	���=�����*�.���L��B�?��
��$��
�(�� �#�V�������������)��!��2�%���C�M�&�]���D�8�;�A�E�<�F�P�G�W����rr(�r�rrrrrrrrr�r�rrrrr�rrrrr�rrrrrrrrrrrrrrrrr�r�rrrrrrr�rrrrrrrrr�rrrrr�r�r�r�rrr�rrrrr|rrrrr�r�r|rrrrrrrrr�r|r�r|r�r�rrr|r�r|r|rrr�rrrrr|rrr�r�rrrrr�rrrrr�rrrrrrrrrrrrrrrrrrr�rrr|rrr�r|r|r|rrr�r|rrr�r�r�r�r�r�r�r|rrr�r�rrr|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrr|rrrrrrrrrrrrrrrrrrrrrrr|r|r|r|r|r|r|rrrrr|rrr|rrrrr|r|r|rrr�r|rrr�rrrrr|r|r�r|rrrrr�r|r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|r|rrrrrrrrr�r|rrrrrrrrrrr|r|r|r|rrrrr|r|rrrrr|r|rrr|rrr|r|rrrrr�r|rrr�r|r|rrrrr�r�r|r�r�r�rrr�r|r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrrrrrr|r|rrrrrrrrr|rrr|r|rrrrr|r|rrr|r|r|r|r�r�rrr�r|r�r�rrr|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrr|rrr|rrrrr|r|rrr|rrrrr|rrr�r�r|rrr|r|r|rrr|r|r|r|r|r�r|r�r|r|r�r�rrrrr|r�r�r�r|r|r�r�rrr�r�r�r�r�r�r�r�r�r�r|rrr�r�r|r�r�rrrrr|rrrrr|r�r�rrrrr�rrrrr�r|r|rrr�r|r|r�r�r�r�r|r|r|r�r|r|r�r�r�r|r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|rrrrr|r�r�rrrrr�r|rrr�r|r�r|r|r|r|r�r|r�r�r|r|r|r�r|r|r�r�r�r|r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|rrr|rrr|r�r|r|r�rrr|r�rrr|r�r|rrr|r|rrr�r|rrr|r|r�r|r|r|r|r�r|r|r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|rrrrr|rrr|r|r|rrr|r|rrr|r|r�r|rrr|r|rrr�rrr|r|r|rrr|r|r|rrrrr|r�rrr�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�rrr�rrrrrrrrrrr�r�rrr�r|r|rrrrrrrrrrr�r�r�r�r�rrr�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r|rrr�r�r�rrr�r|r�r�r�r�r�rrr�r�r�r�r�r�r�r�r|r�rrrrrrrrr�r�r|rrr�r�rrr�rrrrr|rrrrrrrrrrr�r�rrrrrrr�r�r�rrrrr�r�rrr�r�r�r�r|r�r�r|r�r�rrr�r�r�r�r�r|rrr�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|rrrrrrrrrrrrrrr�r|r�rrrrr|r|r�r|r|r|rrr�r�r|r�r|r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|r�r|rrrrrrr�r|r�r|r|r�r|r�rrr|r|r�r|r�r�r�r|r|r�r�r|r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|r�rrrrr�r�rrr�r|rrr�r�rrr|r�r�r|r�r|r|rrr|r�r�r�r�r�r|rrr�r�r�rrr�r|r�r|r�rrr�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�r�rrr|rrrrrrr�rrr|r�rrr|r�rrr|r|r|r|r�rrrrr�r|r�rrr�r|rrr�r|r�r�rrr|r|r|r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrrrr|rrr|rrrrr|rrr|rrr|rrrrr|r�r�rrr|r|r|r�r|r|r|r�r|r|r�r|r�r�r|r|r|rrr�r�rrr�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|rrr|r|r�r�rrr|rrr|rrr|r�rrr|r|r�r|r�r|r|r|r�r|r|r|r|r�rrr|r�r|r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrrrr|rrr�r|rrrrr|r|rrr�r�r�r|r�rrrrr|r|rrr�r�r�rrr�r�r�r�rrr�r�rrrrr�r|r�r|r�r�r�rrr|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrr|rrr|rrrrr�r�rrr�r�r|r�r|r�r�rrr�r�r�r|rrr�r�r�r�r�r�r�r�rrr�r�r|r|r|r|r�r�r�r�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr|r|r�r�r|r�rrrrr|rrr|r|rrr|r|rrr�r|r|r�r|r�rrr|r�r|r|r|r|r|r�rrr|r�r|r|r|r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrrrrrrrrrr�rrrrr�r|r�r�rrr|r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|r|r|rrr�r�r�rrr�rrr|r�rrr|r|rrrrrrrrrrr�r�r|r|r|r�r|r|r�r|r�r|rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|rrr�rrrrr|rrrrr�rrrrr�rrr|r|rrr|rrrrrrr�r�r|r|rrr�r�r�r�rrr�r�rrr�r�r�r|r|r�r�rrr�r�r|r|r|rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr|rrrrr|r�rrrrr|r|rrr�rrr|r�rrr|r�r�r|r|r�r|rrr|r�r�rrr�r�r�r�rrr�r�r|rrr�rrr�r�rrr�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�rrr|r|r|r�r|r�r�rrr�r�rrr�rrr�r�r|r�r�r�r�r|r�r�r�r�r|r�r�r�r�r|r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�rrrrrrrrr|r|r|r|r|r�rrr�r�r�r|r�r�r�r|r�r|r�rrr|r�r�rrr�r�r�r�r�rrr�r�r|rrr�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr�rrrrr�r|r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr�rrr�r�r�r|r�r�r|r�rrrrr|rrrrrrr|rrr�r�r|r|r|r�r�r�r|r|r�r�r�r�r�r�r�rrr�r�r�r�r|r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|r�r�r�r�r�r�r�r�r�r�r�r|rrr�rrrrr�r�r�r�rrr�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�r|rrr�r|rrr�r�rrr�r|r|r�r�r|r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr|r�r�r�r�r�rrr�r|r|r|r|r|r|r�r�r�r�r�rrr�r�r�rrr�r�r�r�r�r�r�r|r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�rrr�r|r|r�rrrrr|rrrrr�r�r�r�r|r|r�r|r�rrrrr�r�r�rrr|r�r�r�r�r|r�r�r�r�r�r�r�r�r|r�r�r�rrr�r�r|r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�rrr�r�rrr�rrr�r�r�r�r�rrr|r�r�r�rrr�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�rrrrr�rrr|r�rrrrr�r|r|r�r�r|r�r�r�r|r�r�r�r�r�rrr�r�r�rrr�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r|r�rrrrrrr|r|r�r�r�r�r�rrr�r�r�r|r|r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r|rrr�r|r�r�r|r�r�rrr�r�r�r|r�r�r�r�r�rrr�r�rrr�r�r�r|r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�rrr�r|r�r�r|r|r�r�r|r�r�r�r�rrr�r|r�r�r�r�r|r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r|r|r�r�r�r|r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�rrr�r�r�r�r�r�r�r�rrr|r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr|r|r�r�r�r�r�r�r�r�r|rrr|r�r|r|rrr�r�r�r|rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|r|r�r�r�r�r�r�r|r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�rrr�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�rrr�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�rrrrr�r�r�r�r|rrr�r�r|r�r�r�r�r�r�r|r�r�r�r�r�r|r�r�r�r|r�r�r�r�r|r�r�rrr�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�rrr�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr|r�r�r�r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�rrr�r�r�r�r�r|r�r�r�r�r�r�r�r�r|r�r�r�r�r�rrrrr�r�r�r�r|r�r�r�r|r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r|r|r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r|r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|rrr�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r|r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r|r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r|r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g��@��?FzTIS-620ZThai)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguageN)ZTIS620CharToOrderMapZ
ThaiLangModelZTIS620ThaiModel�r�r��E/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langthaimodel.py�<module>$s�site-packages/pip/_vendor/chardet/__pycache__/euctwprober.cpython-38.pyc000064400000002121151446177000022324 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�EUCTWDistributionAnalysis)�EUCTW_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�EUCTWProbercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��C/usr/lib/python3.8/site-packages/pip/_vendor/chardet/euctwprober.pyr"s
zEUCTWProber.__init__cCsdS)NzEUC-TWrr
rrr�charset_name(szEUCTWProber.charset_namecCsdS)NZTaiwanrr
rrr�language,szEUCTWProber.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr!s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/jisfreq.cpython-38.opt-1.pyc000064400000053122151446177000022374 0ustar00U

��.e�d�@sdZdZdZdS)g@i(�(�����i'iOii}i�i�i�i�i]i�
i�
ii�
i�i�i�i�i�i�i���i�iXi}i�i�ik�ig
i�
i�iki�����iiiii�i�i%i&�0�1�,�-i�i�iii�ii�i�i�i<ii�ipi�i�i�i�i�i�igi�ii�iWiXi�i�ih
i"i�i�i�i�i
i	ii\i�i�i�
i/
i�i�i�i�ii�i0
i�i�
ihi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ii�i�i�i�i�i�i�iiiiiiiiii	i
iii
iiiiiiiiiiiiiiiiiii ii!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i�iViji4i�ii�iBii�i8i9i:i;i<i=i>ivi�i�i�iSi�ieiifi�i�id	i+i�i�iaiwi�i�i�iIi�i~i�i�
ii?i@iAiBiCiDi
ii-iiiii�i�
iiEi^i.i�i3iii
iFi/iYi�i�ii�iji�
iiGiHiIiJiq�i1
�iY�ik�/i�2���#i����*�������[��\�5i��!i!�	�%�@il��'iA����4�
�������<i��i-�ii7�S�i��~iKi=��E��;���7i7i8�m�&���
��OiK�=i~id��iLiMiNiOiPiQiRiSiTiUiV�Y�>�J�"ip	�p���i��Ti_�i��.�X�i��Lij�ei�9�P� il�yi��i�D���i��)ihi��F�?��+iiig�ci���B�]iN����8�j�:i5iii7���Ri4�G�d���i��ni�hit�6�3�$�W�Ci��i:
ixi��i*iV	iiWiXiYiZi[i\i]i^i_i`iiaibicidieifigihiiijikiliminioipiqirisiti�
iuiviwixiyizi{i|i�i�ii�ili}i�i~iii	i�i�
i�ii�i
i�i�ii�iiii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiki�i�
i>i�
i�
i	i�i
	ij
i��i�iZi[i\i]iiiiii	i
iii
iiiiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiiii	i
iii
iiiiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiiii	i
iii
iiiiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ii
i�i�i�i�ii�i2
i�i�i{iTi�ia
i�
i^i�i�i|i�i=iimik
i�i�i�i	iViyi�	i�i
iq	ii�ii�
i�	�i�i�i�i!i�i�	i�ii�i��iCiOi3ii�i�i�i�ir	i�i�ini�i+ii�i�i�
ipiqi�i;
�Ai�i�i�iCi0i�ini�
i�i�iTiCioi
i�i
i#	ii�i~iiPi�i�i�ii�i�	ii�	i�i$	izi�i�i&i�i�i�i�ii�i�i�i�i_i�iUi�i�
is	i�	i�i�iIi�i�i�ii�i�i�i3
i�ii$iWi1i5iPi�	i�ii�i�i�i�iXi�i�i�il
i�i�iHi�i�	ii�i�ii�i
i�
iWi�i~ipii$i�iii@iLi�i�	i�i�i�iuiiiJiI	iW	i�i�i_i�i�	i<i�i�ii]iDi�i�i�iihi�i�i�i�i���fi-i��}it	i�i�	i��i�i�i,��i
ibi�i�iXi�iiFii{i`i�i�i+i3iqi�imi�i4
i�i�i�i�i�iBiliX	i�
ii%
i�i�i%	i2iui�i�	i�	i�iJii|iri�i@ii�iii�i�i�
i�i�	iL
iiiii�i�ib
iJ	iici�i�i��i�i�ii4	iRi�im
iTi�i�ii�i�i�i�i�ie	i�ii?i
i�i�i�ii-i	i�i*iEi�i�i+i�i�i&	i�	i�i�i/i�i�i.isi[i�i+ii�
ii�
iBic
i�i�i�i�i�i	i)ii,i�iu	ii	ii9i&
iii�i�i�iv	i�iYi�i3i�i
i�i�iiDi�i�i�i�idi�i�i|i(iyii�ii�i<i8i�	iiiiiid
i5
iBi�inii�ii�i�i|i�	i!i�i)i@in
imii�	i0iai�i�i�	�zi'��i�i�	iWi�i[ivi�i�i�	i�i�i	io
ii�	i�i
ii�i'
i�ii"i�i�i9ii�ii�iJi�i�ihi�i�ie
i�i\i��iip
i@iiQi9i�i���i	�i�i�iw	iiiEi�iJiIi�	i�i�i�i�iifi�i�i�i
i�i1i�i�i
i�i�i'	iri
i�i�i�i�
i�i�ici�	iqi�ixi�ii
i2i�i�ii�i�	i*i�i�ibiFi�ivi�idi�
i�i�i!iRi�i�iQi�ii�iPi�iii�ii�i�i(	i�i�i_ii`i�i�if
i�i6
i�iAii�iai�i�iuiTii2i�i�iii�ii^iCi�i�
i�i[i�i�
ivi%i�i�i�ini!iFi�iZi^i�ii�idii�i�ix	i�i�i]i�iBiici�
i�i�i�iPiqi	iiHiY	i�i�i(
i�i�
i�igi}iKi�	i�ii4i�iWi�i�i�iCig
i-idi�ikii4i}i�iq
i~i+i�	i�i�ihi@	i�	ii@iA	iDi:i�i�iei�
i�iqiwi�i�i�i�i�i�i�idi�iZi�i*iM
i[i�i�isiZi�
i�i�i>i�i'i-i�i�
iii�i)	ii�i�i�itiFi7
i�iti#i�i�i�i�iiYi�i�ifikibi1i�i�
i�i6ioiciiqi�	i�i�i�i�
iui�i:i�i�iN
i�iUi=i�	ivi�il�Ni�i�i�i]i�i;i�i�i�
i�i�iliLi	i}i�i�ii�iB	�i8
iQi�i#i`iTi�i�	ixiiri�	iii�i�i�i�	i�i3inii�ii�ii�i{i�i�i@i�i�ii�i9
��i�i5ih
idiZ	��i�iiii�i�i�iisi-ir
i�iii�i[i�i0iii�i�i.iSi	iRiO
i�ii�i�i;i�i4iy	i�
i;i�iz	i�ipi�i�i i�i�i:
i(i|i�
i�i"i�i�i�i�i�i�iOi�iei�i��i
iC	iti)
ii6�Ki�i�i8i�iP
iihi�i�i�ii�i3i$i�i�i*
i=�bieii�
i4i�i�i�	i.i7i�i\i�i�iiji�ii�i�i�i�i��i/i�i�i�i=i�i^i�i5	i�i�i�	i\i�ii�i�i9i#i+i�
is
i,i�i7ii�iYi�i�i�
iMi�i+
ii
iQi��i6	i�i�i�i�iiyi�iisi#i{	i�
iUifi<i�i�ivi�i�i)i�
ii�ii�i�imi<iii�	i�i�igi�i�	�li�i iD	ibiui�
i�iDiBi�i�i�
i[	i�ii8i�i�i>ii�ii�i�i�i�ii]i�iDi���i�i6iZi�i�	i5i�i�
i�
i<imi�
i,i�	i�iui^i�	i�i�igi�i��Ii�i�igi�i�i\i:i
iM�ti�	i�iEi��o��i�i�i�iEiRi�ii�iEij
i��giWi�i�iKi�	iCi�i=i�i]i$i!i�i�	ii�i��`iKiviii0ii��^��i�i3i�i"ii���i�i�aik
ii;
iwi�i�i�i�i�i�i�
iyii�i�i�iPii�i�	iwi��i�it
i�i�i�ii�i�iJiaii�i]i�i�i�i�	�ii�iiLihii�i�i�
iu
iji�ii#iCi�i�i	ia��i!�si|	i�i	iYi�i
i�i�i�ihiOi5i�i�iziii�
iSi�iLi�i.i�i&ii	i<
i7i�isiAi�i�iMi�
i�isi�i*i,
i%i�
i�	i�iki�i&if��iOiji"i�i(i-i�i[i�i�i�i�i-i=i�i}	i�i��MiSi�i�i�ii�iii�i�i�i�
i
ii
i�i~	i�iJitikivieiyi��i�i<
i�ifi�iM�ki�
ii�ioi���i�iwiv
ili�i]i�ii.i�
i�i�i�i/if	iqi$igi�iG��ini�i>i6i=
i�i�i�i�i�iNi�	ixi�iei*	iihii�i�i$i�i�i�ioibi,ii�i�iiti�i�i	i�ii�
iVi�i�
iiii�i�i�iw
iiipiHi��Vi�iii<iZi�	i8�riwi�i&��i�i�i/i�i�i�i�i>i�i>
iE	ixi�i&iei�iwi	i�i�i5i�i�i�
ii\i��i�iSiiii��i�i2�i�iii+i'i�i%i�i�ix
iOi�i
iQ
i�i�iii�i�i_�Hi�i�ii�igii�iy
i�i�
i0i&i+	ii�ii�i�il
i'i�i'izi�i	i	i�i_i�i�ii�i�i�i?
i�
i�i�	�iz
i�im
i|i
ii	ig	i0i�i�i i�i*i�i�i
i`iwii�i
i#��ici)i�i�iR
i���i�iT�i�iriiVi�i�i�i_ii�ii�iri�i�i�
i`ixi�i�i
i�i�ifi�iin
i=
i*iAii�	i(��ix�iS
i��{iT
i�i9ii�iMi�ir��ii;ii(ii%i�i[iaibii�iDi�i�ii-
i\	i�iii�io
iEimi)i�i!i�iici�i,	i1ii]	i��i�i>iI�i�i�	iTii�i�i�i�i�iyiikizixi�iNi	i�i�i�i	i5i�i�i"i�iHi<idi�i
i�i�ih	i�	i�i
ip
i�i�i:iLi1i�i�i�
ii�i>
i�iq
i?iZiMiIi�iiBiK	iDi�i#i
i
iYi>�i�iii`i�i�i�i�ii�i�i�ii�i�i�i i�i�ici�ii�i�i���iTi�iaii2iyi/i�i"iU
����ibi�i�i�i/i�i�	i�ii
i{i
i�ij�i��i5i*i�i�i�i�iaixi�i�i�	iiFi�i�i�i7i�i�i�	i?i��wi�iii�i�i+i�i8i�i�
iNi�
i�i�i,i�ini�i
ii�ioisi_i?i�i�	i�i�ii�	i�i�i?i0i�	i�	i�iyi3ifi�i=i�i�ilii�	iivi]i�i	i	i�i�izi�
i�iyijiiui�i�ipi�ij�ii	
iiizii�ir
ii�i�i�i�i�iiiFi�i'i�	i{
iniix�ui$ii�i�iMi��i�ikiipi�
i^	iqi
i`i|i�i�	ii

i|
i�	i�
ii�i�	i
i�i�i�i�	iGii�i-i�iZi1iYi�i-	i	iei�i�i[iC�i�i�iei�i.i-ii�i�i	i�i�i�
i�
i7	ibili	�i�i�i{i�i.i	i�i�izi�i�
i�
i�i?
i�ii9ii�
i�ii�i}i�i�
iai�i�	i
�Qi�	idi;iV
i�i/i^iDi�i?imi�
i�
i9iIi�
i�i�i
ii�i�
i{i}i i�ii�i��i&i�i~i�iXi�i�i}
i�
i�i9i�i�i:i�i"i\ii�i
i_	��i8iWi~
i^i%iPisi�iwi�i�ii8	i�iLi�ii.
i�i�i�
i�iiN��i�iPi�iSi�i�i�i:iRi'i0ibii�i�
i�i�i�i�izii�	iiiiiKi���i�i�
iri�iqi
i�i�iniL	ii�ii�i�i�i�i�i�iXi@
i�ig�i�i�i4i�i:ii�i�iri�	i�iQi�
ii	i;i'i�i>i�ibimi�iw��i�i�is
i�ii�iA
i�it
i9	ii�iii�	ioi^i�i�i2i�ici�i��i�iiri�i�i�i!iitii1i{i�i�i�i��i�isii�i�i�i�i��xi�viaipi�i�i
i�iLiOi�iiUi�i.i��i)i.	i�iEi�	i"iiyii	i�i�i��i(i�
ii�iqiEi6i
i�
i2iui6i�i�i�i�i.i�ii	ii�iVi�iisi�
i�i�iGiGijiti�iWii�	i�i�i`i�i�i�iui�ii�
i�i{iQii�	iOiCi�i�i�
i�iJi�	i	i	i$i�i�i�i/	i�ii_ii�iij	iRi�i7ii�i/
ii3iDiu
i6iXi4i�i�iii�ii>i�iii0
i`i`	i
i�i�i�iUi�i i�
irii�i)i�i5i�iHi�i 
i�ii~iri�i�
i�i�i�i�i�	�ii]i�i�ii�ii�ii@
i�i�i�
iai�ivi�i�i�i/i!i6i�i�i�i7iwi�i	i3ici8ixii�i�iB
i�i�iM	i��iF	i�igii�i�i(i�i
i:	ii�iHi�i�
if��i�i"i�
i~i�i�i�i�
iyiii�i�i i!iNi�
i4iA
i�idie���izii�i�i�i�i�i�i0	i�i�ii�i�i�ii�i{i�i�i�i�
i�ifi(ili�iGi�	i���i^iB
imiFi|iiUi�i�i2iRi�i�i#i�i�
i�i�iF��i�Ui�i�i�i1i�iciki�iN	iSi�	���i�
i�i�i$iO	i�iiYi�i�i�i
i�iGiii�iW
i	iC
i?i�i�i~i�i�iUiFi�i�i�ii�i�i�i�
iC
i�	i�i�iiei
i�i�i�ii/iQi_iv
i;i�i�iPi)��iGimi�	i�i�iGi,iIiz�_i�	��i	i9ini�i�
iAi�	i�
iX
i�i#iVi)i<i%i�i}i�i�iHiw
i5i�ipi.ii�i�imii�i�i�
i#ihi|ibi�i�i�i@i(i^izi�iiAi�
i ii"iigi�i|i�i�i��i�i6i�iXi�i�i,i�i�i		ii�i$i#iIik	i�ii�i�i:i	i�iQiioihiVi$i�
i�iti�i�i�iY
i,i�ii
i�iD
i�i�	i~i�
i�
i�i�i%i�ii i��i�ii�i�
i i7i/i
	�i���i�	iEiVi�i�
iE
iui�i&i�i�ii�i�	i�ioi�i�iZi�iii�i�i	ii�i��i!i�ini8i�i'i��i�ii�ii�i�	i�iGi�iRi2i�ii:i�i,��iiZ
ili�i(iXiP	i?i�ii�	ioi�ii�i�i�i�iWi*i��i;i8i�i&i)i�i�i
ioi�ii�i�iHi_i�i�i0i�ix
i�i0i�i;	i�i
i�i�iXi�i	��i�i1i��Zi*i%i�	�i�|idi`ii�iSiji}i\ii�i�iG	i�ii�	if�qi%iBi�i1
ipi�i"ii�i�i�i�i|i�i�ii�	i�il	i2
�i�
i�
ii�i@ihi�i;i��ii	i�i	i�i�i&ii�i�i}i�i%i�i�iii?i�i�	i�ia	iy
ii�
i�i�i�	i�i=i1i�i<i�i{i#i��i�i�i�
iAi�i
i�iti�i�i�	i�i>i
iKi3
i�i�i=��ii\i�i�i'iAi+igi�ib	iKi�i�i�i�i
i�i
i�i4
i�i*i�im	i�	i�i�
ioiNii0i(iii�i$i4i i{ii�i�iQ	i�i�iUi�i�i�i,i`ii�	i�ii�
iji)i i�i-i6��i�	iF
i2i)ii
i*i�iYN)ZJIS_TYPICAL_DISTRIBUTION_RATIOZJIS_TABLE_SIZEZJIS_CHAR_TO_FREQ_ORDER�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/chardet/jisfreq.py�<module>,ssite-packages/pip/_vendor/chardet/__pycache__/version.cpython-38.opt-1.pyc000064400000000622151446177000022413 0ustar00U

��.e��@sdZdZe�d�ZdS)z�
This module exists only to simplify retrieving the version number of chardet
from within setup.py and from chardet subpackages.

:author: Dan Blanchard (dan.blanchard@gmail.com)
z3.0.4�.N)�__doc__�__version__�splitZVERSION�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/chardet/version.py�<module>ssite-packages/pip/_vendor/chardet/__pycache__/universaldetector.cpython-38.pyc000064400000013242151446177000023533 0ustar00U

��.e�0�@s�dZddlZddlZddlZddlmZddlmZmZm	Z	ddl
mZddlm
Z
ddlmZdd	lmZGd
d�de�ZdS)a
Module containing the UniversalDetector detector class, which is the primary
class a user of ``chardet`` should use.

:author: Mark Pilgrim (initial port to Python)
:author: Shy Shalom (original C code)
:author: Dan Blanchard (major refactoring for 3.0)
:author: Ian Cordasco
�N�)�CharSetGroupProber)�
InputState�LanguageFilter�ProbingState)�EscCharSetProber)�Latin1Prober)�MBCSGroupProber)�SBCSGroupProberc	@sneZdZdZdZe�d�Ze�d�Ze�d�Z	dddd	d
ddd
d�Z
ejfdd�Z
dd�Zdd�Zdd�ZdS)�UniversalDetectoraq
    The ``UniversalDetector`` class underlies the ``chardet.detect`` function
    and coordinates all of the different charset probers.

    To get a ``dict`` containing an encoding and its confidence, you can simply
    run:

    .. code::

            u = UniversalDetector()
            u.feed(some_bytes)
            u.close()
            detected = u.result

    g�������?s[�-�]s(|~{)s[�-�]zWindows-1252zWindows-1250zWindows-1251zWindows-1256zWindows-1253zWindows-1255zWindows-1254zWindows-1257)z
iso-8859-1z
iso-8859-2z
iso-8859-5z
iso-8859-6z
iso-8859-7z
iso-8859-8z
iso-8859-9ziso-8859-13cCsNd|_g|_d|_d|_d|_d|_d|_||_t�	t
�|_d|_|�
�dS)N)�_esc_charset_prober�_charset_probers�result�done�	_got_data�_input_state�
_last_char�lang_filter�loggingZ	getLogger�__name__�logger�_has_win_bytes�reset)�selfr�r�I/usr/lib/python3.8/site-packages/pip/_vendor/chardet/universaldetector.py�__init__QszUniversalDetector.__init__cCsVdddd�|_d|_d|_d|_tj|_d|_|jr>|j�	�|j
D]}|�	�qDdS)z�
        Reset the UniversalDetector and all of its probers back to their
        initial states.  This is called by ``__init__``, so you only need to
        call this directly in between analyses of different documents.
        N���encoding�
confidence�languageF�)rrrrr�
PURE_ASCIIrrrrr
)r�proberrrrr^s

zUniversalDetector.resetcCs>|jr
dSt|�sdSt|t�s(t|�}|js�|�tj�rJdddd�|_nv|�tj	tj
f�rldddd�|_nT|�d�r�dddd�|_n:|�d	�r�d
ddd�|_n |�tjtjf�r�dddd�|_d|_|jd
dk	r�d|_dS|j
tjk�r.|j�|��rtj|_
n*|j
tjk�r.|j�|j|��r.tj|_
|dd�|_|j
tjk�r�|j�s^t|j�|_|j�|�tjk�r:|jj|j��|jjd�|_d|_n�|j
tjk�r:|j�s�t |j�g|_|jt!j"@�r�|j�#t$��|j�#t%��|jD]:}|�|�tjk�r�|j|��|jd�|_d|_�q&�q�|j&�|��r:d|_'dS)a�
        Takes a chunk of a document and feeds it through all of the relevant
        charset probers.

        After calling ``feed``, you can check the value of the ``done``
        attribute to see if you need to continue feeding the
        ``UniversalDetector`` more data, or if it has made a prediction
        (in the ``result`` attribute).

        .. note::
           You should always call ``close`` when you're done feeding in your
           document if ``done`` is not already ``True``.
        Nz	UTF-8-SIG��?�rzUTF-32s��zX-ISO-10646-UCS-4-3412s��zX-ISO-10646-UCS-4-2143zUTF-16Tr���)(r�len�
isinstance�	bytearrayr�
startswith�codecs�BOM_UTF8r�BOM_UTF32_LE�BOM_UTF32_BE�BOM_LE�BOM_BErrr#�HIGH_BYTE_DETECTOR�search�	HIGH_BYTE�ESC_DETECTORrZ	ESC_ASCIIrrr�feedrZFOUND_IT�charset_name�get_confidencer!r
r	rZNON_CJK�appendr
r�WIN_BYTE_DETECTORr)rZbyte_strr$rrrr6os�
�
��

�

�
�
��
�
zUniversalDetector.feedc		Cst|jr|jSd|_|js&|j�d�n�|jtjkrBdddd�|_n�|jtjkr�d}d}d}|j	D]"}|sjq`|�
�}||kr`|}|}q`|r�||jkr�|j}|j�
�}|�
�}|�d	�r�|jr�|j�||�}|||jd�|_|j��tjk�rn|jd
dk�rn|j�d�|j	D]`}|�s�qt|t��rP|jD] }|j�d|j|j|�
���q,n|j�d|j|j|�
���q|jS)
z�
        Stop analyzing the current document and come up with a final
        prediction.

        :returns:  The ``result`` attribute, a ``dict`` with the keys
                   `encoding`, `confidence`, and `language`.
        Tzno data received!�asciir%r&rNrziso-8859rz no probers hit minimum thresholdz%s %s confidence = %s)rrrr�debugrrr#r4r
r8�MINIMUM_THRESHOLDr7�lowerr+r�ISO_WIN_MAP�getr!ZgetEffectiveLevelr�DEBUGr)rZprobers)	rZprober_confidenceZmax_prober_confidenceZ
max_proberr$r7Zlower_charset_namer Zgroup_proberrrr�close�sj	�



��

�
�zUniversalDetector.closeN)r�
__module__�__qualname__�__doc__r=�re�compiler2r5r:r?rZALLrrr6rBrrrrr3s$


�	
mr)rEr,rrFZcharsetgroupproberrZenumsrrrZ	escproberrZlatin1proberrZmbcsgroupproberr	Zsbcsgroupproberr
�objectrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/hebrewprober.cpython-38.opt-1.pyc000064400000005652151446177000023424 0ustar00U

��.e6�@s,ddlmZddlmZGdd�de�ZdS)�)�
CharSetProber)�ProbingStatecs�eZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZd
ZdZ�fdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zedd��Zedd��Zedd ��Z�ZS)!�HebrewProber�������������������g{�G�z�?z
ISO-8859-8zwindows-1255cs>tt|���d|_d|_d|_d|_d|_d|_|�	�dS�N)
�superr�__init__�_final_char_logical_score�_final_char_visual_score�_prev�_before_prev�_logical_prober�_visual_prober�reset��self��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/hebrewprober.pyr�szHebrewProber.__init__cCsd|_d|_d|_d|_dS)N�� )rrrrrrrrr�szHebrewProber.resetcCs||_||_dSr)rr)rZ
logicalProberZvisualProberrrr�set_model_probers�szHebrewProber.set_model_proberscCs||j|j|j|j|jfkSr)�	FINAL_KAF�	FINAL_MEM�	FINAL_NUN�FINAL_PE�FINAL_TSADI�r�crrr�is_final�s�zHebrewProber.is_finalcCs||j|j|j|jfkSr)�
NORMAL_KAF�
NORMAL_MEM�
NORMAL_NUN�	NORMAL_PEr(rrr�is_non_final�s
�zHebrewProber.is_non_finalcCs�|jtjkrtjS|�|�}|D]�}|dkrn|jdkr�|�|j�rR|jd7_q�|�|j�r�|j	d7_	n,|jdkr�|�|j�r�|dkr�|j	d7_	|j|_||_q tj
S)Nr!r)�stater�NOT_MEZfilter_high_byte_onlyrr*rrr/r�	DETECTING)rZbyte_strZcurrrr�feed�s&



��zHebrewProber.feedcCsx|j|j}||jkr|jS||jkr.|jS|j��|j��}||jkrR|jS||jkrd|jS|dkrr|jS|jS)Ng)	rr�MIN_FINAL_CHAR_DISTANCE�LOGICAL_HEBREW_NAME�VISUAL_HEBREW_NAMErZget_confidencer�MIN_MODEL_DISTANCE)rZfinalsubZmodelsubrrr�charset_name�s
�
zHebrewProber.charset_namecCsdS)NZHebrewrrrrr�languageszHebrewProber.languagecCs(|jjtjkr"|jjtjkr"tjStjSr)rr0rr1rr2rrrrr0s
�zHebrewProber.state)�__name__�
__module__�__qualname__r#r+r$r,r%r-r&r.r'ZNORMAL_TSADIr4r7r6r5rrr"r*r/r3�propertyr8r9r0�
__classcell__rrrrr�s4

;

rN)Z
charsetproberrZenumsrrrrrr�<module>scsite-packages/pip/_vendor/chardet/__pycache__/universaldetector.cpython-38.opt-1.pyc000064400000013242151446177000024472 0ustar00U

��.e�0�@s�dZddlZddlZddlZddlmZddlmZmZm	Z	ddl
mZddlm
Z
ddlmZdd	lmZGd
d�de�ZdS)a
Module containing the UniversalDetector detector class, which is the primary
class a user of ``chardet`` should use.

:author: Mark Pilgrim (initial port to Python)
:author: Shy Shalom (original C code)
:author: Dan Blanchard (major refactoring for 3.0)
:author: Ian Cordasco
�N�)�CharSetGroupProber)�
InputState�LanguageFilter�ProbingState)�EscCharSetProber)�Latin1Prober)�MBCSGroupProber)�SBCSGroupProberc	@sneZdZdZdZe�d�Ze�d�Ze�d�Z	dddd	d
ddd
d�Z
ejfdd�Z
dd�Zdd�Zdd�ZdS)�UniversalDetectoraq
    The ``UniversalDetector`` class underlies the ``chardet.detect`` function
    and coordinates all of the different charset probers.

    To get a ``dict`` containing an encoding and its confidence, you can simply
    run:

    .. code::

            u = UniversalDetector()
            u.feed(some_bytes)
            u.close()
            detected = u.result

    g�������?s[�-�]s(|~{)s[�-�]zWindows-1252zWindows-1250zWindows-1251zWindows-1256zWindows-1253zWindows-1255zWindows-1254zWindows-1257)z
iso-8859-1z
iso-8859-2z
iso-8859-5z
iso-8859-6z
iso-8859-7z
iso-8859-8z
iso-8859-9ziso-8859-13cCsNd|_g|_d|_d|_d|_d|_d|_||_t�	t
�|_d|_|�
�dS)N)�_esc_charset_prober�_charset_probers�result�done�	_got_data�_input_state�
_last_char�lang_filter�loggingZ	getLogger�__name__�logger�_has_win_bytes�reset)�selfr�r�I/usr/lib/python3.8/site-packages/pip/_vendor/chardet/universaldetector.py�__init__QszUniversalDetector.__init__cCsVdddd�|_d|_d|_d|_tj|_d|_|jr>|j�	�|j
D]}|�	�qDdS)z�
        Reset the UniversalDetector and all of its probers back to their
        initial states.  This is called by ``__init__``, so you only need to
        call this directly in between analyses of different documents.
        N���encoding�
confidence�languageF�)rrrrr�
PURE_ASCIIrrrrr
)r�proberrrrr^s

zUniversalDetector.resetcCs>|jr
dSt|�sdSt|t�s(t|�}|js�|�tj�rJdddd�|_nv|�tj	tj
f�rldddd�|_nT|�d�r�dddd�|_n:|�d	�r�d
ddd�|_n |�tjtjf�r�dddd�|_d|_|jd
dk	r�d|_dS|j
tjk�r.|j�|��rtj|_
n*|j
tjk�r.|j�|j|��r.tj|_
|dd�|_|j
tjk�r�|j�s^t|j�|_|j�|�tjk�r:|jj|j��|jjd�|_d|_n�|j
tjk�r:|j�s�t |j�g|_|jt!j"@�r�|j�#t$��|j�#t%��|jD]:}|�|�tjk�r�|j|��|jd�|_d|_�q&�q�|j&�|��r:d|_'dS)a�
        Takes a chunk of a document and feeds it through all of the relevant
        charset probers.

        After calling ``feed``, you can check the value of the ``done``
        attribute to see if you need to continue feeding the
        ``UniversalDetector`` more data, or if it has made a prediction
        (in the ``result`` attribute).

        .. note::
           You should always call ``close`` when you're done feeding in your
           document if ``done`` is not already ``True``.
        Nz	UTF-8-SIG��?�rzUTF-32s��zX-ISO-10646-UCS-4-3412s��zX-ISO-10646-UCS-4-2143zUTF-16Tr���)(r�len�
isinstance�	bytearrayr�
startswith�codecs�BOM_UTF8r�BOM_UTF32_LE�BOM_UTF32_BE�BOM_LE�BOM_BErrr#�HIGH_BYTE_DETECTOR�search�	HIGH_BYTE�ESC_DETECTORrZ	ESC_ASCIIrrr�feedrZFOUND_IT�charset_name�get_confidencer!r
r	rZNON_CJK�appendr
r�WIN_BYTE_DETECTORr)rZbyte_strr$rrrr6os�
�
��

�

�
�
��
�
zUniversalDetector.feedc		Cst|jr|jSd|_|js&|j�d�n�|jtjkrBdddd�|_n�|jtjkr�d}d}d}|j	D]"}|sjq`|�
�}||kr`|}|}q`|r�||jkr�|j}|j�
�}|�
�}|�d	�r�|jr�|j�||�}|||jd�|_|j��tjk�rn|jd
dk�rn|j�d�|j	D]`}|�s�qt|t��rP|jD] }|j�d|j|j|�
���q,n|j�d|j|j|�
���q|jS)
z�
        Stop analyzing the current document and come up with a final
        prediction.

        :returns:  The ``result`` attribute, a ``dict`` with the keys
                   `encoding`, `confidence`, and `language`.
        Tzno data received!�asciir%r&rNrziso-8859rz no probers hit minimum thresholdz%s %s confidence = %s)rrrr�debugrrr#r4r
r8�MINIMUM_THRESHOLDr7�lowerr+r�ISO_WIN_MAP�getr!ZgetEffectiveLevelr�DEBUGr)rZprobers)	rZprober_confidenceZmax_prober_confidenceZ
max_proberr$r7Zlower_charset_namer Zgroup_proberrrr�close�sj	�



��

�
�zUniversalDetector.closeN)r�
__module__�__qualname__�__doc__r=�re�compiler2r5r:r?rZALLrrr6rBrrrrr3s$


�	
mr)rEr,rrFZcharsetgroupproberrZenumsrrrZ	escproberrZlatin1proberrZmbcsgroupproberr	Zsbcsgroupproberr
�objectrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/langbulgarianmodel.cpython-38.pyc000064400000056053151446177000023627 0ustar00U

��.e'2�@s4dZdZdZeeddddd�Zeedddd	d�Zd
S)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr�M�Z�c�d�H�m�k�e�O��Q�f�L�^�R�n��l�[�J�w�T�`�o��srrrrrr�A�E�F�B�?�D�p�g�\���h�_�V�W�G�t���U�]�a�q����������rrrrrr(r/r4r5r6r7r8��������������������������������������������������r�����������i�������������-������ �#�+�%�,�7�/�(�;�!�.�&�$�)��'��"�3�0�1�5�2�6�9�=���C���<�8���	���������
����
������������K�4���*��>�������:��b������rrr(rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr	r
rrr
rrrrrrrrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0r1r2r3r4r5r6r7r8rrrrrr>r?r@rArBrCrDrE�xrFrGrHrIrJrKrLrM�N�@�S�yr��urWrNrOrPrQrRrSrTrU�XrVrXrYrZ�z�Y�jr[r\r]r_r`r^r|r~�I�P�v�rr�r�r�r�r�r�r�r�r�r�r�r�rarbrcrdrerfrgrhrirjrkrlrmrnrorprqrrrsrtrurvrwrxryrzr{r�r}rrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�(�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�g! _B�?Fz
ISO-8859-5Z	Bulgairan)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguagezwindows-1251Z	BulgarianN)ZLatin5_BulgarianCharToOrderMapZwin1251BulgarianCharToOrderMapZBulgarianLangModelZLatin5BulgarianModelZWin1251BulgarianModel�r�r��J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langbulgarianmodel.py�<module>%s"�
�site-packages/pip/_vendor/chardet/__pycache__/gb2312freq.cpython-38.opt-1.pyc000064400000045176151446177000022521 0ustar00U

��.e�P�@sdZdZdZdS)g�������?i�(�i�i�i�i<	iTi�i	iQi�i�
i�
i�i�i<iwi�i9	��i�	i�i�i�iZi�i�iqi�i�i�
iW
iyii�ieioi�iv
i�i�i�i�i�iiiLiBiiQ
�i�i�iQi�i�iEiifi�ii�ii�i�i�idi(iyii�i,i	i�i
iEie�i�
iWiRi�i�i|	iR
i�i�
i�i
iX
i�
ijiEi�ii+iPi�i�ii�i�;i�imi�ili�i�i�i��iieiHi�i�i�i�i^iki6i�i"�Fi�i�
i�
i�
i^	i�i�
i�i���i?i`iui$i1i�
i�i�i iUi�i1i�i�igili�ii		i�iGi�i2i�iq	i�i iPi�iL	i�i�i�iiy	i�i�
i�iMi�iki�i4	i�ii�i�i�i
i�	i@	i`i�i5��i�iN
i�i7i3i�iniiuiGi&ibihi0i�iMiNii�	i
iY	i�
i�i�	�
i��i�
�&i�
iQi
i7i^ihi�i�iJi�iPi�i�i�iri�i�i�ii�i�iT	i-iGi,iuii�	i�i$ii�i<iBii$i>ii�ixiLiWii�ini
i�iTi�iZi�i�
i�	i{ii�i�	i��ii�
i?i�
�0ibi;�Di�i��i�iCiSi�iUi>	i|igi�i�i�	i�
iK��i

i�i�i�i%
i5
i�i�ii�ili�ihi
ii�i?�i� iUi���i�i�	i�i*i<
i�i�
i�i
�i
i�i�i�
i�i�
i!	iX
i�i�i�	i�iQigi�i�i�i�	i�iri�
i�i�iqi�i�
i�iz
i�i�	i3�i�i�i�i
i�
i]iciziii7i�i_ii�iCi�i&iaiHi|
ili
i�i=i�i�iIiPi�
i�i~
i8i`i�iw	i�i�
iTi�i�
i�i�i�i�i�
i�ii�i���i[iq�ii�	igi��|iCi	i�i�iNiIi�i�i5i�
i(i�i/iHiK
i
i��ii�i9i�iIi�i�i|i��i�i�
i��iWii�i�i�i^�~iii�i�	i�i=iXi�i3i�
iIi�ii�
�i�i�i�i3ir�i���ioii�i�i{iiiiC���!iHi�	��i�i��f�i=
ii1�[i�i|iDii%i�iti�i�i�
i�i i�i.i��i�yiiTi�i�i9
i�
ii#�i�iJi��ni�ii�i
i�i>iBi"i�i�iai�i�iMiK��iiWi�i�	i�	i!
ir	iFi+	i�
i
ii�ix
�HiJi���i�i�i2�Ki�iR
i$ii9i�
it
i�i�
i�i�i��i�ii�i�ii�i�i%i~i�
i`	�i�i�i�i'iviii�i�i|i�'ii�in
i*i�i�i�iFi�i%i��)i~i�i
i�i�iJi&i�i
i!iDi�iwii[iii�	i�i	i'	i�	i��kii�i	i�
i�
��i��i�ii�i�ih
�Bi_i�i?iigihi�i'i�i�i�i�i�ii�i�i�ii�i��5i]i�ii�i�ii���i�i�i1	i�i)ia	ii�i�i�i;	ii�i_i�i��Qi/iu
i�
i�
iji[i�i}i�i
i�i�i�	ii�i�iQi^
i�iGi�izi�i�i�iViOi�ii�i�i�i�imiui�	i6i�i�i-i$i�i�iRi�i}	i
ipiri]
i�
iDiii�i�i�iiiii�i�ii1ini�i�iitiYiG	i�i�i/i|�ti0i�
i�i�ii�i\i�
i�i�ivi�i�i�ici�ii�i�
i~iAi"i�i"	i!i8�Ci8	ii�	iji�
i1i�ili>i�
ii]
i�i�
i~�iLi(i�i�iKid��viDi�i�i�i%i�	i�i�i�	i,�i2i�i�
i�i�ij�-i.i�imiKii���ioi	i;i	i�i�idi@iai	iM	i1
iLi@i2i�iwi�itiQi
i/i�i i�i~i�i�i�i�i�
i/i�i�
i_	i#i��Oi�iOiG�i�iki[iOioi���i-
i
�ii�	i!i�i�iIi�i�i�i{iri�i.ihi�
iiT
ii�i'iL
�ai�i�
i@�i�i�i�i�i�
iTi/
i�ii�i�ii�iMi�ii
ili�ii�
i{i8i#i�
i�i�i9i�iSiRi�	�wi�iZi�i0
iEigigi�i��
i��Li�i�ipi�i�iSi
i�i�i�i�i�	i@i�iI	iLi;
iOiqi�i�i)	ii:iFi�i5iJidiA
i�i
i)
iEiL�Yi�i�i�i�
im	i�i�i�i�i�i�ici�iRi�i!i�i�i�i�
��i(i�i�i]�Ii�i�
i�	i�iei�ii�i��i�i�i`i�ii�i�i
i�i[i�iC
i(iPi,i�i}iO	i'iLi\
i�
i�ii�i�iiZi�i�isi'i�	iUi�i�i�i�iN
�i�i�i�
i�i�iMi�i�i�i�i�i���i�iii�igi'i�i�i	i�i
��Pi0is	iii�ip	i�	inii�i�ii\i�
i�i�i�
i!ih���imi(i&i
iCiiBi)i5	i�i��ii�i�i
i�i��>i�i���ii�	��i{iNi�iiiEi3��Ji#i�ici�i�
ii$
��i5i�ixii]i�i�ik��i�i�i�i�iP
i�i
iiiri�iLi�izidi�i�i#i�
ii�i[iSiihiiGi�i�ii�i�
iU�+i�	iy�iwi"i�iVi2
i&izi�	i�	i�iJ
iP	i�	i�i���i�i%	iZi$ioiTiKi1i�
i�i`iVi�ii�id�i�i�i�i+i�i�iAi�i�i�i�i�i$i�i�	i_i3i\i�i�����i�ibi�if�i�i�i�i�
iAinii��x�iFi�
iOi[i�i��(i�ii
i#i7i2	ixiif	i�	i�
i!i6i{
��i�iYi��i�i+i�i�i�i�i i�i�i�i�	i	iKiei�i�i�
iTi$i�i�iihii	iRi�i�i"i�i��Zi 
i_i�i@i�iaii�ii3
i�
iki)iji�iiiei�i
iAi^i�i
iW	i�i�ihi:
iz
i)
i�i|i�i�ii�ii8ij��i�
ii�i3i�	i
izi�ipiyi�i�i2ioiD	i=i��.i�i9iaifi�i*i_i�i	i*i�ii�
i�
i�i�i-ii�
i}i�i�
i�i�i*	i�
it�iti6
�qi�i�i�i�i�i�i�iSi 	i�i�i!i)iiyi�
��iiij	i�i�	i�iViIi�i�ig
iiiLi�i�i�ipiDi�i�i�i�i%i�i�iMi�i�i�i$i�i�i�iE	i"iU	i�ie
i	i|i�	iQii�i�i�ii�i�
i1
i�i�i�i��$i i]i4i&i�i�izi�i�i`i�iwi�
iiii�
i)i%
i&i�i�i�i*i�i�i8i2i>
iSi
i�i�i1i#i�i�i
i�i#i	i�
i�i�ii�iF
iii,	i>i+i
ii�iZ�3iq�i�
i$i�i�
iVi�	i;i�i�iNi��miKiWi�i��i5i�
i�	�Ri4i�iIiiDi�i�i�i�
i�i�
i�i�i�ii%iKi|ii�i�
i��i��i9i�in	i�i�i�
i-i3i2
ipi�i?
i�i~i�i�i�i�i�iCi�i[i�i�
i�i�i�i3	i>i�ili
i`ix	i�i�i�i�i#
i�i�i�i0��i�i�i�	iL
i�i�iQi�iRi�i?i(imi�i`
i�i3ii�ii&
i�
iiisiDi�i0	ib	ifi@i�	i�i�i�
ii=i�i
i<��i�i�i�
i�i6ii�isi�i�i�iSi�i�i�
i8iZ
i�i�i�i�i�i�i�ii�
i�i�
i�ii�iNi�	i�i
iLi�
iJ	i�i�i�	ibiigii�i[
i�i�ii�ii~i�i�	i�	i�i�ifi�i�iii�
ii`i4i=	i�i�i�ili?	i�ici�ii�iiii�i�i�i�i�i�i�i�iwi�i�i�i%ii�id	i^i+i�i�i�iZ�iFiI
i�it�i�	�/i�	ii�iyi*
isi&i+ii�i)ii�i�	i�i�ii�
i�ie	i�i�iQi]	ii	i_i7	ii0�ciui�i�iLiki
i�i�i�i��#ii�ii�i��i�i?i��ii�
ini
i�i�i�i	i�i�i�	iHi�iYi�iu	i�i�
i�	i�iJi�i_i_i&i�i�ii�i�i�iZi%�i�	isi�iSiiiiVi�i�i�i�i�i1i'��i�iFi\i
i|i�	iWi�i�i|�iS�Wi�	i*i	iRiliPi#i�ii-iq
i�i��	i�i�i4i�i�i�i�i�iai�i�ii�i@
i�iXiii%i�i�i8
i3i,i�i}i�i�i��dixi�	i�i#	i�i6i�
i�
i.ii�iAi�
i�ir
i�
i�iRidi�ii+
i�i�i�i�
i{i{iHi�	i
i�i�i�i�i�ici	i
i�i�i�i,i�iI
i�icii�i�i�i�i=i�iJi.i,i>iii�iLiei]i�i�
iCi�i�i�i*i;i
i�i i�ipi�
i�i�iRi�i9i�
i�
ii�
i�i�i?i:i�	i�i�iQi'isi�iwi[i�
i�i-i�
i)i�i��Mi�i�i�i�i]�}i6i@i
iiUi�i�i�i/i�i�is
i�	i�i�ik	i?i�i,
i=
i1iMi�i�i�i/iS
id��i�io
i6	ikiui�i�i�iW�{iixiWi�i�ii�i�ixi^i��i[	i+�7i:i�iUi�i�i!i�i�i�
i.iHiTi�iYi�i�i	ii@i"iCisi	i�	iiG
�bi�i7i~i.
iUiiqi�	i�i�i�i{i�i��iYi/i�
i�i�iAi�
i�i*i:i8i'i�i�i�i�iiAi_i0i�i�i�iiii�iKi�
i�i�iti*i�i�i�
i�i�i�i�i�	i�
��i�iDii�ii>i�i�ivii

i�
i'i��Vi�i�i�
i�i�ikiii\i�i�i�i!ii��*iU
i�i�i�i�iizi�i\if
i�i�i�	i
i���i�i�i�i�i�i�i�iiB	iii�i�i�i{�i=i�
��i&i�
i�iVi�	i��"i!i�
i�	i�i�i�
i(	i=i�i�
i�
i�i9ii�i4ia��i�i-iQ	�i�
i�i�
imi�i�i�i�iCi�i�i7i}iqiDi4i��uii�	i�i�ivii�iF	i�iuia
i�iHioi�
i
	iliKiA	i�i�i�	izi4i�	i!
iH
i�i�	��i5iiji�i`i�i�
iBi:iOiai�i#i��i�id�i�i(i�
i&
i�i^imig
iE
iio	i�i(iGi$i@i
iIii�iAii�`�Xii7i�i/i�i$i�i�i�ihi�i�i�i�	iUi"iT�i�i�i�im�i�i!ii�i�ii�i i�iMi�	i��i�i�	�2iqi�i��9i�i�i��i�ii�i/i�i���i�pi@iX	i�ij�ii
i^
ibi�
i�iniiv�i�i�ioio�iivi�i�i0i�i9i�i$	i�ifiSizi
iiDi{i�iX�ii�iVi3iYi
i�i�
iAi�i��i�i�iqiUi�
i:	ii2iji�iii{	i�i�	iFi�i�
i�	ii	i��i�iciiiR	i;ik�hi�ii�
i�iYiOixi��ziZi<iv	ii�
i
i�
i�iIi�i�i4
iMi�i�i�i�ibi�ii�ii�i�i�iCi�i�
i�i�iOi�i8i�i�i�	i.i]iiVic
i�	i�i�i
iH	i�iTi�i�i�	i�i>
i
i�i�i3i�i��,i�i�ifi�i�iiliTiWiHi.i'i>ipi�i�i�i"i�i�	iJi�i�
i�
ivi2i�i�i	ixi	i2i�igi i4i�i�i�
i�
i�i�i{
iz	i�i�	i�
i�i�i�	i�i�ii�i�i?ii��i�	iJi�i�i�i�
i�	i8��iEij
�\i�i8i8
ii i�ii`i�i>ibiSii��i�i�ii�i0i�i�i�iEi�i�idi�i�i�i1�i�i�in�@i�i�i�iTii�	��i�iQ��iCi�i�iKi;iki�i�i�i�i�i_i\	ieiiwi�i�ii�iMi�i.	iriaii�i�
i�i�i�
i�i�i�igi�i�i'i�
i�iii�	�Tii�i4ioi�i�	iXiyi�ixii�	i�
i
iU
�^i:i�i�i�i�ii"i#i�i�iii�	i�i�i�iNiUi�i�ip�i"
i-i�i�	�i�i:i�i
ii�	i�i�i�i�	i��iWi
iG
iLi�i�
iGiw�oi�i�iiMir�i�ii�iQ
i�iIiN�%i
iXiii�i7
i�
iai�i�i�i�	i'
iiihi�i}iNiyi?iti�i�iDi�i�i��i��li�i�i�i	i��ieiJisi2i*iyi�i�i�i�i�ii�iqi�i�i5i}isi$i�i�i�i5
iBi�i��i#idisi}i�i~i�iib
i�iO
i/	�]i�i�i�	i]i2��iifi7i�i�iOi

iRii#
i	i[i��Ei�iif
iS
i�	idiFi�i��iC	iV
i>i�i	i�iBi�ii	i1i6im��ii	i��i�i�ip
i�ii�
i�i<izi�
i|
iX�i�i�isiei]ii��i
i�
iiOi�i+i�	iii�i�i�i:i�	iAi�ii�i�i�i(
i�
imi�4iP�i	ini�i�
ioioi�i�imiiy�ii8i	��i<i�i�i<ic	iCi�i�i&iwi
i�	i$i 
i9i&i�i�i)i`i�i�ii�i�iGibiEi�i:iQioiFi�
i�i�i�	i�
iFi|i;i�
i�ii3i4i%i��:i�	ici�ipi6
i\iCi�i0i9
i�i�i�i�i�i~	i�ii"ihi�i�i�i�	i)ii�	i�
i�i�i*
i�ii
i
i%i�i	i�i�ii�
i.i�i�i9i	i�i�i�
i�i�i	i�i"i!i�i,
i�ig	iJigiF
i�ii�i�
i�i;ii	iZiEi^iA
i�iili5i�i�i�i4i'
i�iiki	i�i�	i2i�i�
i�i	iXi7�i�i�
i{i�iBixi=�ei(i�i�i�i'i�i��i�i�ii�iiii�iD
iiikii�i�i�i-i,i�
iei7
i��i�i��i�i�ini}
ipi7iji�i�	i�i9i�i�
��i�i���i0iPi���i�i�ii�iO
i�
i�i�	��iUi
ii�i<
i�i�i�
iJi�itiNi�i)ii.i��i*iiA��ir
i]i)i�ii�i�iGi�i_
ipik
i�i�i
	i%i
i�i�
i�i>ibi_i^�?ii:iYiDi%�i�i�
i�ii�i��iYi�i�
i�i�ii�i�il
�Ai�i�	i�
i�	iDiBi�	i
i�i	i@
i(iv
i�i�i��gi�
i�	i}ivi�i�i�i�
i�ii�i�ii�i�ii�ii�i�i i-i~i�iyi%i�	i�
�_i�i�ii�i�i�jiMi�i�iGi+i�	ii���i�	i�i�ii3
i;i
�Gi)i�i
i�i�ii�i�ii�i
i
i�i,iIi�	i�i�iiXiAi\i��i�iPivi�i�	iVii=i�
i�
i6i<i�iXii�
i	ii8i-	iY
i�i�i�i�i�i��ici�i�i�i9i�	i-
iui�i	i�i�
iRi�
iii6i�i�	i�ih	i}ii?
iw
ii�i�	iai(i�i�1i�i�
i�i>i�i�i�i�i�i]i�
iXiriPi0i,ii+iji�i`i�i�i�ii.iii
i�i&	iWiB
i�ii|i7�Ui�i�	�iWi�iYi�i�
i�iw
i�
ii�ii�ii�i�iui�ibi�iq
i�i�ibi�i�i���=i$
i�iNiJi�i�iUi�ii�i�	ii��iiKi,i�i�i4iri{i�iiHi�ipi5ii�i=i�	i�iEi9i�i;i�<ii5i�
iiii�i\ii��ipi�ii�i��ri��Ni�ii^i�i�i�i�iKii�i*ii{i+
i�	i�i*i8ii�ii	ii�i�i�ij
ii@il	�6i�i2i8i�i�	i�ii�i'i�i�i�iB
i�iii\i�i�iSiV	ii~i�i�i�i�i�i�
i�iVi�
izi�i^i	i�i�i�i_
i}
iGiq�iIi�i�i��8itihiS	i�i}iRi�	i9��Sin
iPi�iBiii��si�iXi}ifi�i�ii�i�i�i�i���i�iniIi^�iTi�ixi�iri�i�i_�ibi�iOiPiQiRiSN)Z!GB2312_TYPICAL_DISTRIBUTION_RATIOZGB2312_TABLE_SIZEZGB2312_CHAR_TO_FREQ_ORDER�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/chardet/gb2312freq.py�<module>*ssite-packages/pip/_vendor/chardet/__pycache__/sbcharsetprober.cpython-38.pyc000064400000005646151446177000023172 0ustar00U

��.e�@s4ddlmZddlmZmZmZGdd�de�ZdS)�)�
CharSetProber)�CharacterCategory�ProbingState�SequenceLikelihoodcsbeZdZdZdZdZdZd�fdd�	Z�fd	d
�Ze	dd��Z
e	d
d��Zdd�Zdd�Z
�ZS)�SingleByteCharSetProber�@igffffff�?g�������?FNcsJtt|���||_||_||_d|_d|_d|_d|_	d|_
|��dS)N)�superr�__init__�_model�	_reversed�_name_prober�_last_order�
_seq_counters�_total_seqs�_total_char�
_freq_char�reset)�self�model�reversedZname_prober��	__class__��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/sbcharsetprober.pyr	'sz SingleByteCharSetProber.__init__cs:tt|���d|_dgt��|_d|_d|_d|_	dS)N��)
rrrr
rZget_num_categoriesrrrr�rrrrr5szSingleByteCharSetProber.resetcCs|jr|jjS|jdSdS)N�charset_name)rrr
rrrrr?sz$SingleByteCharSetProber.charset_namecCs|jr|jjS|j�d�SdS)N�language)rrr
�getrrrrrFsz SingleByteCharSetProber.languagec	Csj|jds|�|�}|s|jS|jd}t|�D]�\}}||}|tjkrX|jd7_||jkr�|jd7_|j	|jkr�|j
d7_
|js�|j	|j|}|jd|}n||j|j	}|jd|}|j|d7<||_	q0|jd}|jt
jk�rd|j
|jk�rd|��}||jk�r<|j�d||�t
j|_n(||jk�rd|j�d|||j�t
j|_|jS)NZkeep_english_letter�char_to_order_maprZprecedence_matrixrz$%s confidence = %s, we have a winnerz9%s confidence = %s, below negative shortcut threshhold %s)r
Zfilter_international_words�state�	enumeraterZCONTROLr�SAMPLE_SIZErr
rrrrZ	DETECTING�SB_ENOUGH_REL_THRESHOLD�get_confidence�POSITIVE_SHORTCUT_THRESHOLDZlogger�debugZFOUND_ITZ_state�NEGATIVE_SHORTCUT_THRESHOLDZNOT_ME)	rZbyte_strr �i�c�orderrrZ
confidencerrr�feedMsL





�
�zSingleByteCharSetProber.feedcCsNd}|jdkrJd|jtj|j|jd}||j|j}|dkrJd}|S)Ng{�G�z�?rg�?Ztypical_positive_ratiog�G�z��?)rrrZPOSITIVEr
rr)r�rrrrr%|s
��z&SingleByteCharSetProber.get_confidence)FN)�__name__�
__module__�__qualname__r#r$r&r(r	r�propertyrrr,r%�
__classcell__rrrrr!s


/rN)Z
charsetproberrZenumsrrrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/langhebrewmodel.cpython-38.pyc000064400000053244151446177000023136 0ustar00U

��.eQ,�@sdZdZeeddddd�ZdS)(�rrrrrrrrr�rrrrrrrrrrrrrrrrrrrrr�rrrrrrrrrrrrrrr�rrrrrrrrrrrrrrrr�E�[�O�P�\�Y�a�Z�D�o�p�R�I�_�U�N�y�V�G�C�f�k�T�r�g�srrrrrr�2�J�<�=�*�L�F�@�5�i�]�8�A�6�1�B�n�3�+�,�?�Q�M�b�K�lrrrrr�|���������(�:���������������������S�4�/�.�H� �^���q���m���������"�t���v�d�����u�w�h�}�����W�c���j�z�{���7�����e�����x���0�'�9����;�)�X�!�%�$���#���>����~�����&�-��������������������	������������������
�������
��r��`r(�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�gC��|�?Fzwindows-1255ZHebrew)Zchar_to_order_mapZprecedence_matrixZtypical_positive_ratioZkeep_english_letterZcharset_nameZlanguageN)ZWIN1255_CHAR_TO_ORDER_MAPZHEBREW_LANG_MODELZWin1255HebrewModel�r�r��G/usr/lib/python3.8/site-packages/pip/_vendor/chardet/langhebrewmodel.py�<module>%s�site-packages/pip/_vendor/chardet/__pycache__/gb2312prober.cpython-38.opt-1.pyc000064400000002131151446177000023035 0ustar00U

��.e��@sDddlmZddlmZddlmZddlmZGdd�de�ZdS)�)�MultiByteCharSetProber)�CodingStateMachine)�GB2312DistributionAnalysis)�GB2312_SM_MODELcs4eZdZ�fdd�Zedd��Zedd��Z�ZS)�GB2312Probercs,tt|���tt�|_t�|_|��dS)N)	�superr�__init__rrZ	coding_smrZdistribution_analyzer�reset��self��	__class__��D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/gb2312prober.pyr"s
zGB2312Prober.__init__cCsdS)NZGB2312rr
rrr�charset_name(szGB2312Prober.charset_namecCsdS)NZChineserr
rrr�language,szGB2312Prober.language)�__name__�
__module__�__qualname__r�propertyrr�
__classcell__rrrrr!s

rN)	ZmbcharsetproberrZcodingstatemachinerZchardistributionrZmbcssmrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/charsetgroupprober.cpython-38.opt-1.pyc000064400000004246151446177000024654 0ustar00U

��.e��@s,ddlmZddlmZGdd�de�ZdS)�)�ProbingState)�
CharSetProbercsReZdZd�fdd�	Z�fdd�Zedd��Zedd	��Zd
d�Zdd
�Z	�Z
S)�CharSetGroupProberNcs(tt|�j|d�d|_g|_d|_dS)N)�lang_filter�)�superr�__init__�_active_num�probers�_best_guess_prober)�selfr��	__class__��J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/charsetgroupprober.pyr!szCharSetGroupProber.__init__csJtt|���d|_|jD]$}|r|��d|_|jd7_qd|_dS)NrTr)rr�resetr	r
�activer)r�proberr
rrr's
zCharSetGroupProber.resetcCs |js|��|jsdS|jjS�N)r�get_confidence�charset_name�rrrrr1s
zCharSetGroupProber.charset_namecCs |js|��|jsdS|jjSr)rr�languagerrrrr9s
zCharSetGroupProber.languagecCs�|jD]v}|sq|jsq|�|�}|s(q|tjkrB||_|jS|tjkrd|_|jd8_|jdkrtj|_	|jSq|jS)NFrr)
r
r�feedr�FOUND_ITr�state�NOT_MEr	Z_state)rZbyte_strrrrrrrAs$





zCharSetGroupProber.feedcCs�|j}|tjkrdS|tjkr"dSd}d|_|jD]R}|s<q2|jsT|j�d|j	�q2|�
�}|j�d|j	|j|�||kr2|}||_q2|js�dS|S)Ng�G�z��?g{�G�z�?gz
%s not activez%s %s confidence = %s)rrrrrr
rZlogger�debugrrr)rrZ	best_confrZconfrrrrUs*


z!CharSetGroupProber.get_confidence)N)�__name__�
__module__�__qualname__rr�propertyrrrr�
__classcell__rrr
rr s


rN)ZenumsrZ
charsetproberrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/enums.cpython-38.pyc000064400000005063151446177000021122 0ustar00U

��.e}�@shdZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZGd	d
�d
e�ZGdd�de�Zd
S)zr
All of the Enums that are used throughout the chardet package.

:author: Dan Blanchard (dan.blanchard@gmail.com)
c@seZdZdZdZdZdZdS)�
InputStatezS
    This enum represents the different states a universal detector can be in.
    ���N)�__name__�
__module__�__qualname__�__doc__Z
PURE_ASCIIZ	ESC_ASCIIZ	HIGH_BYTE�r	r	�=/usr/lib/python3.8/site-packages/pip/_vendor/chardet/enums.pyrsrc@s<eZdZdZdZdZdZdZdZdZ	eeBZ
e
eBeBZdS)	�LanguageFilterzj
    This enum represents the different language filters we can apply to a
    ``UniversalDetector``.
    rr����N)rrrrZCHINESE_SIMPLIFIEDZCHINESE_TRADITIONALZJAPANESEZKOREANZNON_CJKZALLZCHINESEZCJKr	r	r	r
rsrc@seZdZdZdZdZdZdS)�ProbingStatezG
    This enum represents the different states a prober can be in.
    rrrN)rrrrZ	DETECTINGZFOUND_ITZNOT_MEr	r	r	r
r src@seZdZdZdZdZdZdS)�MachineStatezN
    This enum represents the different states a state machine can be in.
    rrrN)rrrrZSTARTZERRORZITS_MEr	r	r	r
r)src@s,eZdZdZdZdZdZdZedd��Z	dS)	�SequenceLikelihoodzX
    This enum represents the likelihood of a character following the previous one.
    rrr�cCsdS)z::returns: The number of likelihood categories in the enum.rr	)�clsr	r	r
�get_num_categories;sz%SequenceLikelihood.get_num_categoriesN)
rrrrZNEGATIVEZUNLIKELYZLIKELYZPOSITIVE�classmethodrr	r	r	r
r2src@s$eZdZdZdZdZdZdZdZdS)�CharacterCategoryz�
    This enum represents the different categories language models for
    ``SingleByteCharsetProber`` put characters into.

    Anything less than CONTROL is considered a letter.
    �����N)	rrrrZ	UNDEFINEDZ
LINE_BREAKZSYMBOLZDIGITZCONTROLr	r	r	r
rAsrN)r�objectrrrrrrr	r	r	r
�<module>s			site-packages/pip/_vendor/chardet/__pycache__/jisfreq.cpython-38.pyc000064400000053122151446177000021435 0ustar00U

��.e�d�@sdZdZdZdS)g@i(�(�����i'iOii}i�i�i�i�i]i�
i�
ii�
i�i�i�i�i�i�i���i�iXi}i�i�ik�ig
i�
i�iki�����iiiii�i�i%i&�0�1�,�-i�i�iii�ii�i�i�i<ii�ipi�i�i�i�i�i�igi�ii�iWiXi�i�ih
i"i�i�i�i�i
i	ii\i�i�i�
i/
i�i�i�i�ii�i0
i�i�
ihi�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ii�i�i�i�i�i�i�iiiiiiiiii	i
iii
iiiiiiiiiiiiiiiiiii ii!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i�iViji4i�ii�iBii�i8i9i:i;i<i=i>ivi�i�i�iSi�ieiifi�i�id	i+i�i�iaiwi�i�i�iIi�i~i�i�
ii?i@iAiBiCiDi
ii-iiiii�i�
iiEi^i.i�i3iii
iFi/iYi�i�ii�iji�
iiGiHiIiJiq�i1
�iY�ik�/i�2���#i����*�������[��\�5i��!i!�	�%�@il��'iA����4�
�������<i��i-�ii7�S�i��~iKi=��E��;���7i7i8�m�&���
��OiK�=i~id��iLiMiNiOiPiQiRiSiTiUiV�Y�>�J�"ip	�p���i��Ti_�i��.�X�i��Lij�ei�9�P� il�yi��i�D���i��)ihi��F�?��+iiig�ci���B�]iN����8�j�:i5iii7���Ri4�G�d���i��ni�hit�6�3�$�W�Ci��i:
ixi��i*iV	iiWiXiYiZi[i\i]i^i_i`iiaibicidieifigihiiijikiliminioipiqirisiti�
iuiviwixiyizi{i|i�i�ii�ili}i�i~iii	i�i�
i�ii�i
i�i�ii�iiii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiki�i�
i>i�
i�
i	i�i
	ij
i��i�iZi[i\i]iiiiii	i
iii
iiiiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiiii	i
iii
iiiiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�iiiiiiiiii	i
iii
iiiiiiiiiiiiiiiiiii i!i"i#i$i%i&i'i(i)i*i+i,i-i.i/i0i1i2i3i4i5i6i7i8i9i:i;i<i=i>i?i@iAiBiCiDiEiFiGiHiIiJiKiLiMiNiOiPiQiRiSiTiUiViWiXiYiZi[i\i]i^i_i`iaibicidieifigihiiijikiliminioipiqirisitiuiviwixiyizi{i|i}i~ii�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�i�ii
i�i�i�i�ii�i2
i�i�i{iTi�ia
i�
i^i�i�i|i�i=iimik
i�i�i�i	iViyi�	i�i
iq	ii�ii�
i�	�i�i�i�i!i�i�	i�ii�i��iCiOi3ii�i�i�i�ir	i�i�ini�i+ii�i�i�
ipiqi�i;
�Ai�i�i�iCi0i�ini�
i�i�iTiCioi
i�i
i#	ii�i~iiPi�i�i�ii�i�	ii�	i�i$	izi�i�i&i�i�i�i�ii�i�i�i�i_i�iUi�i�
is	i�	i�i�iIi�i�i�ii�i�i�i3
i�ii$iWi1i5iPi�	i�ii�i�i�i�iXi�i�i�il
i�i�iHi�i�	ii�i�ii�i
i�
iWi�i~ipii$i�iii@iLi�i�	i�i�i�iuiiiJiI	iW	i�i�i_i�i�	i<i�i�ii]iDi�i�i�iihi�i�i�i�i���fi-i��}it	i�i�	i��i�i�i,��i
ibi�i�iXi�iiFii{i`i�i�i+i3iqi�imi�i4
i�i�i�i�i�iBiliX	i�
ii%
i�i�i%	i2iui�i�	i�	i�iJii|iri�i@ii�iii�i�i�
i�i�	iL
iiiii�i�ib
iJ	iici�i�i��i�i�ii4	iRi�im
iTi�i�ii�i�i�i�i�ie	i�ii?i
i�i�i�ii-i	i�i*iEi�i�i+i�i�i&	i�	i�i�i/i�i�i.isi[i�i+ii�
ii�
iBic
i�i�i�i�i�i	i)ii,i�iu	ii	ii9i&
iii�i�i�iv	i�iYi�i3i�i
i�i�iiDi�i�i�i�idi�i�i|i(iyii�ii�i<i8i�	iiiiiid
i5
iBi�inii�ii�i�i|i�	i!i�i)i@in
imii�	i0iai�i�i�	�zi'��i�i�	iWi�i[ivi�i�i�	i�i�i	io
ii�	i�i
ii�i'
i�ii"i�i�i9ii�ii�iJi�i�ihi�i�ie
i�i\i��iip
i@iiQi9i�i���i	�i�i�iw	iiiEi�iJiIi�	i�i�i�i�iifi�i�i�i
i�i1i�i�i
i�i�i'	iri
i�i�i�i�
i�i�ici�	iqi�ixi�ii
i2i�i�ii�i�	i*i�i�ibiFi�ivi�idi�
i�i�i!iRi�i�iQi�ii�iPi�iii�ii�i�i(	i�i�i_ii`i�i�if
i�i6
i�iAii�iai�i�iuiTii2i�i�iii�ii^iCi�i�
i�i[i�i�
ivi%i�i�i�ini!iFi�iZi^i�ii�idii�i�ix	i�i�i]i�iBiici�
i�i�i�iPiqi	iiHiY	i�i�i(
i�i�
i�igi}iKi�	i�ii4i�iWi�i�i�iCig
i-idi�ikii4i}i�iq
i~i+i�	i�i�ihi@	i�	ii@iA	iDi:i�i�iei�
i�iqiwi�i�i�i�i�i�i�idi�iZi�i*iM
i[i�i�isiZi�
i�i�i>i�i'i-i�i�
iii�i)	ii�i�i�itiFi7
i�iti#i�i�i�i�iiYi�i�ifikibi1i�i�
i�i6ioiciiqi�	i�i�i�i�
iui�i:i�i�iN
i�iUi=i�	ivi�il�Ni�i�i�i]i�i;i�i�i�
i�i�iliLi	i}i�i�ii�iB	�i8
iQi�i#i`iTi�i�	ixiiri�	iii�i�i�i�	i�i3inii�ii�ii�i{i�i�i@i�i�ii�i9
��i�i5ih
idiZ	��i�iiii�i�i�iisi-ir
i�iii�i[i�i0iii�i�i.iSi	iRiO
i�ii�i�i;i�i4iy	i�
i;i�iz	i�ipi�i�i i�i�i:
i(i|i�
i�i"i�i�i�i�i�i�iOi�iei�i��i
iC	iti)
ii6�Ki�i�i8i�iP
iihi�i�i�ii�i3i$i�i�i*
i=�bieii�
i4i�i�i�	i.i7i�i\i�i�iiji�ii�i�i�i�i��i/i�i�i�i=i�i^i�i5	i�i�i�	i\i�ii�i�i9i#i+i�
is
i,i�i7ii�iYi�i�i�
iMi�i+
ii
iQi��i6	i�i�i�i�iiyi�iisi#i{	i�
iUifi<i�i�ivi�i�i)i�
ii�ii�i�imi<iii�	i�i�igi�i�	�li�i iD	ibiui�
i�iDiBi�i�i�
i[	i�ii8i�i�i>ii�ii�i�i�i�ii]i�iDi���i�i6iZi�i�	i5i�i�
i�
i<imi�
i,i�	i�iui^i�	i�i�igi�i��Ii�i�igi�i�i\i:i
iM�ti�	i�iEi��o��i�i�i�iEiRi�ii�iEij
i��giWi�i�iKi�	iCi�i=i�i]i$i!i�i�	ii�i��`iKiviii0ii��^��i�i3i�i"ii���i�i�aik
ii;
iwi�i�i�i�i�i�i�
iyii�i�i�iPii�i�	iwi��i�it
i�i�i�ii�i�iJiaii�i]i�i�i�i�	�ii�iiLihii�i�i�
iu
iji�ii#iCi�i�i	ia��i!�si|	i�i	iYi�i
i�i�i�ihiOi5i�i�iziii�
iSi�iLi�i.i�i&ii	i<
i7i�isiAi�i�iMi�
i�isi�i*i,
i%i�
i�	i�iki�i&if��iOiji"i�i(i-i�i[i�i�i�i�i-i=i�i}	i�i��MiSi�i�i�ii�iii�i�i�i�
i
ii
i�i~	i�iJitikivieiyi��i�i<
i�ifi�iM�ki�
ii�ioi���i�iwiv
ili�i]i�ii.i�
i�i�i�i/if	iqi$igi�iG��ini�i>i6i=
i�i�i�i�i�iNi�	ixi�iei*	iihii�i�i$i�i�i�ioibi,ii�i�iiti�i�i	i�ii�
iVi�i�
iiii�i�i�iw
iiipiHi��Vi�iii<iZi�	i8�riwi�i&��i�i�i/i�i�i�i�i>i�i>
iE	ixi�i&iei�iwi	i�i�i5i�i�i�
ii\i��i�iSiiii��i�i2�i�iii+i'i�i%i�i�ix
iOi�i
iQ
i�i�iii�i�i_�Hi�i�ii�igii�iy
i�i�
i0i&i+	ii�ii�i�il
i'i�i'izi�i	i	i�i_i�i�ii�i�i�i?
i�
i�i�	�iz
i�im
i|i
ii	ig	i0i�i�i i�i*i�i�i
i`iwii�i
i#��ici)i�i�iR
i���i�iT�i�iriiVi�i�i�i_ii�ii�iri�i�i�
i`ixi�i�i
i�i�ifi�iin
i=
i*iAii�	i(��ix�iS
i��{iT
i�i9ii�iMi�ir��ii;ii(ii%i�i[iaibii�iDi�i�ii-
i\	i�iii�io
iEimi)i�i!i�iici�i,	i1ii]	i��i�i>iI�i�i�	iTii�i�i�i�i�iyiikizixi�iNi	i�i�i�i	i5i�i�i"i�iHi<idi�i
i�i�ih	i�	i�i
ip
i�i�i:iLi1i�i�i�
ii�i>
i�iq
i?iZiMiIi�iiBiK	iDi�i#i
i
iYi>�i�iii`i�i�i�i�ii�i�i�ii�i�i�i i�i�ici�ii�i�i���iTi�iaii2iyi/i�i"iU
����ibi�i�i�i/i�i�	i�ii
i{i
i�ij�i��i5i*i�i�i�i�iaixi�i�i�	iiFi�i�i�i7i�i�i�	i?i��wi�iii�i�i+i�i8i�i�
iNi�
i�i�i,i�ini�i
ii�ioisi_i?i�i�	i�i�ii�	i�i�i?i0i�	i�	i�iyi3ifi�i=i�i�ilii�	iivi]i�i	i	i�i�izi�
i�iyijiiui�i�ipi�ij�ii	
iiizii�ir
ii�i�i�i�i�iiiFi�i'i�	i{
iniix�ui$ii�i�iMi��i�ikiipi�
i^	iqi
i`i|i�i�	ii

i|
i�	i�
ii�i�	i
i�i�i�i�	iGii�i-i�iZi1iYi�i-	i	iei�i�i[iC�i�i�iei�i.i-ii�i�i	i�i�i�
i�
i7	ibili	�i�i�i{i�i.i	i�i�izi�i�
i�
i�i?
i�ii9ii�
i�ii�i}i�i�
iai�i�	i
�Qi�	idi;iV
i�i/i^iDi�i?imi�
i�
i9iIi�
i�i�i
ii�i�
i{i}i i�ii�i��i&i�i~i�iXi�i�i}
i�
i�i9i�i�i:i�i"i\ii�i
i_	��i8iWi~
i^i%iPisi�iwi�i�ii8	i�iLi�ii.
i�i�i�
i�iiN��i�iPi�iSi�i�i�i:iRi'i0ibii�i�
i�i�i�i�izii�	iiiiiKi���i�i�
iri�iqi
i�i�iniL	ii�ii�i�i�i�i�i�iXi@
i�ig�i�i�i4i�i:ii�i�iri�	i�iQi�
ii	i;i'i�i>i�ibimi�iw��i�i�is
i�ii�iA
i�it
i9	ii�iii�	ioi^i�i�i2i�ici�i��i�iiri�i�i�i!iitii1i{i�i�i�i��i�isii�i�i�i�i��xi�viaipi�i�i
i�iLiOi�iiUi�i.i��i)i.	i�iEi�	i"iiyii	i�i�i��i(i�
ii�iqiEi6i
i�
i2iui6i�i�i�i�i.i�ii	ii�iVi�iisi�
i�i�iGiGijiti�iWii�	i�i�i`i�i�i�iui�ii�
i�i{iQii�	iOiCi�i�i�
i�iJi�	i	i	i$i�i�i�i/	i�ii_ii�iij	iRi�i7ii�i/
ii3iDiu
i6iXi4i�i�iii�ii>i�iii0
i`i`	i
i�i�i�iUi�i i�
irii�i)i�i5i�iHi�i 
i�ii~iri�i�
i�i�i�i�i�	�ii]i�i�ii�ii�ii@
i�i�i�
iai�ivi�i�i�i/i!i6i�i�i�i7iwi�i	i3ici8ixii�i�iB
i�i�iM	i��iF	i�igii�i�i(i�i
i:	ii�iHi�i�
if��i�i"i�
i~i�i�i�i�
iyiii�i�i i!iNi�
i4iA
i�idie���izii�i�i�i�i�i�i0	i�i�ii�i�i�ii�i{i�i�i�i�
i�ifi(ili�iGi�	i���i^iB
imiFi|iiUi�i�i2iRi�i�i#i�i�
i�i�iF��i�Ui�i�i�i1i�iciki�iN	iSi�	���i�
i�i�i$iO	i�iiYi�i�i�i
i�iGiii�iW
i	iC
i?i�i�i~i�i�iUiFi�i�i�ii�i�i�i�
iC
i�	i�i�iiei
i�i�i�ii/iQi_iv
i;i�i�iPi)��iGimi�	i�i�iGi,iIiz�_i�	��i	i9ini�i�
iAi�	i�
iX
i�i#iVi)i<i%i�i}i�i�iHiw
i5i�ipi.ii�i�imii�i�i�
i#ihi|ibi�i�i�i@i(i^izi�iiAi�
i ii"iigi�i|i�i�i��i�i6i�iXi�i�i,i�i�i		ii�i$i#iIik	i�ii�i�i:i	i�iQiioihiVi$i�
i�iti�i�i�iY
i,i�ii
i�iD
i�i�	i~i�
i�
i�i�i%i�ii i��i�ii�i�
i i7i/i
	�i���i�	iEiVi�i�
iE
iui�i&i�i�ii�i�	i�ioi�i�iZi�iii�i�i	ii�i��i!i�ini8i�i'i��i�ii�ii�i�	i�iGi�iRi2i�ii:i�i,��iiZ
ili�i(iXiP	i?i�ii�	ioi�ii�i�i�i�iWi*i��i;i8i�i&i)i�i�i
ioi�ii�i�iHi_i�i�i0i�ix
i�i0i�i;	i�i
i�i�iXi�i	��i�i1i��Zi*i%i�	�i�|idi`ii�iSiji}i\ii�i�iG	i�ii�	if�qi%iBi�i1
ipi�i"ii�i�i�i�i|i�i�ii�	i�il	i2
�i�
i�
ii�i@ihi�i;i��ii	i�i	i�i�i&ii�i�i}i�i%i�i�iii?i�i�	i�ia	iy
ii�
i�i�i�	i�i=i1i�i<i�i{i#i��i�i�i�
iAi�i
i�iti�i�i�	i�i>i
iKi3
i�i�i=��ii\i�i�i'iAi+igi�ib	iKi�i�i�i�i
i�i
i�i4
i�i*i�im	i�	i�i�
ioiNii0i(iii�i$i4i i{ii�i�iQ	i�i�iUi�i�i�i,i`ii�	i�ii�
iji)i i�i-i6��i�	iF
i2i)ii
i*i�iYN)ZJIS_TYPICAL_DISTRIBUTION_RATIOZJIS_TABLE_SIZEZJIS_CHAR_TO_FREQ_ORDER�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/chardet/jisfreq.py�<module>,ssite-packages/pip/_vendor/chardet/__pycache__/charsetgroupprober.cpython-38.pyc000064400000004246151446177000023715 0ustar00U

��.e��@s,ddlmZddlmZGdd�de�ZdS)�)�ProbingState)�
CharSetProbercsReZdZd�fdd�	Z�fdd�Zedd��Zedd	��Zd
d�Zdd
�Z	�Z
S)�CharSetGroupProberNcs(tt|�j|d�d|_g|_d|_dS)N)�lang_filter�)�superr�__init__�_active_num�probers�_best_guess_prober)�selfr��	__class__��J/usr/lib/python3.8/site-packages/pip/_vendor/chardet/charsetgroupprober.pyr!szCharSetGroupProber.__init__csJtt|���d|_|jD]$}|r|��d|_|jd7_qd|_dS)NrTr)rr�resetr	r
�activer)r�proberr
rrr's
zCharSetGroupProber.resetcCs |js|��|jsdS|jjS�N)r�get_confidence�charset_name�rrrrr1s
zCharSetGroupProber.charset_namecCs |js|��|jsdS|jjSr)rr�languagerrrrr9s
zCharSetGroupProber.languagecCs�|jD]v}|sq|jsq|�|�}|s(q|tjkrB||_|jS|tjkrd|_|jd8_|jdkrtj|_	|jSq|jS)NFrr)
r
r�feedr�FOUND_ITr�state�NOT_MEr	Z_state)rZbyte_strrrrrrrAs$





zCharSetGroupProber.feedcCs�|j}|tjkrdS|tjkr"dSd}d|_|jD]R}|s<q2|jsT|j�d|j	�q2|�
�}|j�d|j	|j|�||kr2|}||_q2|js�dS|S)Ng�G�z��?g{�G�z�?gz
%s not activez%s %s confidence = %s)rrrrrr
rZlogger�debugrrr)rrZ	best_confrZconfrrrrUs*


z!CharSetGroupProber.get_confidence)N)�__name__�
__module__�__qualname__rr�propertyrrrr�
__classcell__rrr
rr s


rN)ZenumsrZ
charsetproberrrrrrr�<module>ssite-packages/pip/_vendor/chardet/__pycache__/__init__.cpython-38.pyc000064400000001455151446177000021533 0ustar00U

��.e�@s8ddlmZmZddlmZddlmZmZdd�ZdS)�)�PY2�PY3)�UniversalDetector)�__version__�VERSIONcCsHt|t�s0t|t�s(td�t|����nt|�}t�}|�|�|��S)z�
    Detect the encoding of the given byte string.

    :param byte_str:     The byte sequence to examine.
    :type byte_str:      ``bytes`` or ``bytearray``
    z4Expected object of type bytes or bytearray, got: {0})	�
isinstance�	bytearray�bytes�	TypeError�format�typerZfeed�close)Zbyte_strZdetector�r�@/usr/lib/python3.8/site-packages/pip/_vendor/chardet/__init__.py�detects

�
rN)	�compatrrZuniversaldetectorr�versionrrrrrrr�<module>ssite-packages/pip/_vendor/chardet/langbulgarianmodel.py000064400000031047151446177000017335 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# 255: Control characters that usually does not exist in any text
# 254: Carriage/Return
# 253: symbol (punctuation) that does not belong to word
# 252: 0 - 9

# Character Mapping Table:
# this table is modified base on win1251BulgarianCharToOrderMap, so
# only number <64 is sure valid

Latin5_BulgarianCharToOrderMap = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253, 77, 90, 99,100, 72,109,107,101, 79,185, 81,102, 76, 94, 82,  # 40
110,186,108, 91, 74,119, 84, 96,111,187,115,253,253,253,253,253,  # 50
253, 65, 69, 70, 66, 63, 68,112,103, 92,194,104, 95, 86, 87, 71,  # 60
116,195, 85, 93, 97,113,196,197,198,199,200,253,253,253,253,253,  # 70
194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,  # 80
210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,  # 90
 81,226,227,228,229,230,105,231,232,233,234,235,236, 45,237,238,  # a0
 31, 32, 35, 43, 37, 44, 55, 47, 40, 59, 33, 46, 38, 36, 41, 30,  # b0
 39, 28, 34, 51, 48, 49, 53, 50, 54, 57, 61,239, 67,240, 60, 56,  # c0
  1, 18,  9, 20, 11,  3, 23, 15,  2, 26, 12, 10, 14,  6,  4, 13,  # d0
  7,  8,  5, 19, 29, 25, 22, 21, 27, 24, 17, 75, 52,241, 42, 16,  # e0
 62,242,243,244, 58,245, 98,246,247,248,249,250,251, 91,252,253,  # f0
)

win1251BulgarianCharToOrderMap = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253, 77, 90, 99,100, 72,109,107,101, 79,185, 81,102, 76, 94, 82,  # 40
110,186,108, 91, 74,119, 84, 96,111,187,115,253,253,253,253,253,  # 50
253, 65, 69, 70, 66, 63, 68,112,103, 92,194,104, 95, 86, 87, 71,  # 60
116,195, 85, 93, 97,113,196,197,198,199,200,253,253,253,253,253,  # 70
206,207,208,209,210,211,212,213,120,214,215,216,217,218,219,220,  # 80
221, 78, 64, 83,121, 98,117,105,222,223,224,225,226,227,228,229,  # 90
 88,230,231,232,233,122, 89,106,234,235,236,237,238, 45,239,240,  # a0
 73, 80,118,114,241,242,243,244,245, 62, 58,246,247,248,249,250,  # b0
 31, 32, 35, 43, 37, 44, 55, 47, 40, 59, 33, 46, 38, 36, 41, 30,  # c0
 39, 28, 34, 51, 48, 49, 53, 50, 54, 57, 61,251, 67,252, 60, 56,  # d0
  1, 18,  9, 20, 11,  3, 23, 15,  2, 26, 12, 10, 14,  6,  4, 13,  # e0
  7,  8,  5, 19, 29, 25, 22, 21, 27, 24, 17, 75, 52,253, 42, 16,  # f0
)

# Model Table:
# total sequences: 100%
# first 512 sequences: 96.9392%
# first 1024 sequences:3.0618%
# rest  sequences:     0.2992%
# negative sequences:  0.0020%
BulgarianLangModel = (
0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,2,3,3,3,3,3,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,2,2,3,2,2,1,2,2,
3,1,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,3,3,3,3,3,3,3,0,3,0,1,
0,0,0,0,0,0,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,2,3,3,3,3,3,3,3,3,0,3,1,0,
0,1,0,0,0,0,0,0,0,0,1,1,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
3,2,2,2,3,3,3,3,3,3,3,3,3,3,3,3,3,1,3,2,3,3,3,3,3,3,3,3,0,3,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,2,3,3,2,3,3,3,3,3,3,3,3,3,3,3,3,1,3,2,3,3,3,3,3,3,3,3,0,3,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,2,3,2,2,1,3,3,3,3,2,2,2,1,1,2,0,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,2,3,2,2,3,3,1,1,2,3,3,2,3,3,3,3,2,1,2,0,2,0,3,0,0,
0,0,0,0,0,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,1,3,3,3,3,3,2,3,2,3,3,3,3,3,2,3,3,1,3,0,3,0,2,0,0,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,3,1,3,3,2,3,3,3,1,3,3,2,3,2,2,2,0,0,2,0,2,0,2,0,0,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,3,3,0,3,3,3,2,2,3,3,3,1,2,2,3,2,1,1,2,0,2,0,0,0,0,
1,0,0,0,0,0,0,0,0,0,2,0,0,1,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,2,3,3,1,2,3,2,2,2,3,3,3,3,3,2,2,3,1,2,0,2,1,2,0,0,
0,0,0,0,0,0,0,0,0,0,3,0,0,1,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,1,3,3,3,3,3,2,3,3,3,2,3,3,2,3,2,2,2,3,1,2,0,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,3,3,3,3,1,1,1,2,2,1,3,1,3,2,2,3,0,0,1,0,1,0,1,0,0,
0,0,0,1,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,2,2,3,2,2,3,1,2,1,1,1,2,3,1,3,1,2,2,0,1,1,1,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,1,3,2,2,3,3,1,2,3,1,1,3,3,3,3,1,2,2,1,1,1,0,2,0,2,0,1,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,2,2,3,3,3,2,2,1,1,2,0,2,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,0,1,2,1,3,3,2,3,3,3,3,3,2,3,2,1,0,3,1,2,1,2,1,2,3,2,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,1,1,2,3,3,3,3,3,3,3,3,3,3,3,3,0,0,3,1,3,3,2,3,3,2,2,2,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,3,3,3,3,0,3,3,3,3,3,2,1,1,2,1,3,3,0,3,1,1,1,1,3,2,0,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,2,2,2,3,3,3,3,3,3,3,3,3,3,3,1,1,3,1,3,3,2,3,2,2,2,3,0,2,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,2,3,3,2,2,3,2,1,1,1,1,1,3,1,3,1,1,0,0,0,1,0,0,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,2,3,2,0,3,2,0,3,0,2,0,0,2,1,3,1,0,0,1,0,0,0,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,2,1,1,1,1,2,1,1,2,1,1,1,2,2,1,2,1,1,1,0,1,1,0,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,2,1,3,1,1,2,1,3,2,1,1,0,1,2,3,2,1,1,1,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,3,3,3,3,2,2,1,0,1,0,0,1,0,0,0,2,1,0,3,0,0,1,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,2,3,2,3,3,1,3,2,1,1,1,2,1,1,2,1,3,0,1,0,0,0,1,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,1,2,2,3,3,2,3,2,2,2,3,1,2,2,1,1,2,1,1,2,2,0,1,1,0,1,0,2,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,2,1,3,1,0,2,2,1,3,2,1,0,0,2,0,2,0,1,0,0,0,0,0,0,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,
3,3,3,3,3,3,1,2,0,2,3,1,2,3,2,0,1,3,1,2,1,1,1,0,0,1,0,0,2,2,2,3,
2,2,2,2,1,2,1,1,2,2,1,1,2,0,1,1,1,0,0,1,1,0,0,1,1,0,0,0,1,1,0,1,
3,3,3,3,3,2,1,2,2,1,2,0,2,0,1,0,1,2,1,2,1,1,0,0,0,1,0,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,1,
3,3,2,3,3,1,1,3,1,0,3,2,1,0,0,0,1,2,0,2,0,1,0,0,0,1,0,1,2,1,2,2,
1,1,1,1,1,1,1,2,2,2,1,1,1,1,1,1,1,0,1,2,1,1,1,0,0,0,0,0,1,1,0,0,
3,1,0,1,0,2,3,2,2,2,3,2,2,2,2,2,1,0,2,1,2,1,1,1,0,1,2,1,2,2,2,1,
1,1,2,2,2,2,1,2,1,1,0,1,2,1,2,2,2,1,1,1,0,1,1,1,1,2,0,1,0,0,0,0,
2,3,2,3,3,0,0,2,1,0,2,1,0,0,0,0,2,3,0,2,0,0,0,0,0,1,0,0,2,0,1,2,
2,1,2,1,2,2,1,1,1,2,1,1,1,0,1,2,2,1,1,1,1,1,0,1,1,1,0,0,1,2,0,0,
3,3,2,2,3,0,2,3,1,1,2,0,0,0,1,0,0,2,0,2,0,0,0,1,0,1,0,1,2,0,2,2,
1,1,1,1,2,1,0,1,2,2,2,1,1,1,1,1,1,1,0,1,1,1,0,0,0,0,0,0,1,1,0,0,
2,3,2,3,3,0,0,3,0,1,1,0,1,0,0,0,2,2,1,2,0,0,0,0,0,0,0,0,2,0,1,2,
2,2,1,1,1,1,1,2,2,2,1,0,2,0,1,0,1,0,0,1,0,1,0,0,1,0,0,0,0,1,0,0,
3,3,3,3,2,2,2,2,2,0,2,1,1,1,1,2,1,2,1,1,0,2,0,1,0,1,0,0,2,0,1,2,
1,1,1,1,1,1,1,2,2,1,1,0,2,0,1,0,2,0,0,1,1,1,0,0,2,0,0,0,1,1,0,0,
2,3,3,3,3,1,0,0,0,0,0,0,0,0,0,0,2,0,0,1,1,0,0,0,0,0,0,1,2,0,1,2,
2,2,2,1,1,2,1,1,2,2,2,1,2,0,1,1,1,1,1,1,0,1,1,1,1,0,0,1,1,1,0,0,
2,3,3,3,3,0,2,2,0,2,1,0,0,0,1,1,1,2,0,2,0,0,0,3,0,0,0,0,2,0,2,2,
1,1,1,2,1,2,1,1,2,2,2,1,2,0,1,1,1,0,1,1,1,1,0,2,1,0,0,0,1,1,0,0,
2,3,3,3,3,0,2,1,0,0,2,0,0,0,0,0,1,2,0,2,0,0,0,0,0,0,0,0,2,0,1,2,
1,1,1,2,1,1,1,1,2,2,2,0,1,0,1,1,1,0,0,1,1,1,0,0,1,0,0,0,0,1,0,0,
3,3,2,2,3,0,1,0,1,0,0,0,0,0,0,0,1,1,0,3,0,0,0,0,0,0,0,0,1,0,2,2,
1,1,1,1,1,2,1,1,2,2,1,2,2,1,0,1,1,1,1,1,0,1,0,0,1,0,0,0,1,1,0,0,
3,1,0,1,0,2,2,2,2,3,2,1,1,1,2,3,0,0,1,0,2,1,1,0,1,1,1,1,2,1,1,1,
1,2,2,1,2,1,2,2,1,1,0,1,2,1,2,2,1,1,1,0,0,1,1,1,2,1,0,1,0,0,0,0,
2,1,0,1,0,3,1,2,2,2,2,1,2,2,1,1,1,0,2,1,2,2,1,1,2,1,1,0,2,1,1,1,
1,2,2,2,2,2,2,2,1,2,0,1,1,0,2,1,1,1,1,1,0,0,1,1,1,1,0,1,0,0,0,0,
2,1,1,1,1,2,2,2,2,1,2,2,2,1,2,2,1,1,2,1,2,3,2,2,1,1,1,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,3,2,0,1,2,0,1,2,1,1,0,1,0,1,2,1,2,0,0,0,1,1,0,0,0,1,0,0,2,
1,1,0,0,1,1,0,1,1,1,1,0,2,0,1,1,1,0,0,1,1,0,0,0,0,1,0,0,0,1,0,0,
2,0,0,0,0,1,2,2,2,2,2,2,2,1,2,1,1,1,1,1,1,1,0,1,1,1,1,1,2,1,1,1,
1,2,2,2,2,1,1,2,1,2,1,1,1,0,2,1,2,1,1,1,0,2,1,1,1,1,0,1,0,0,0,0,
3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,
1,1,0,1,0,1,1,1,1,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,3,2,0,0,0,0,1,0,0,0,0,0,0,1,1,0,2,0,0,0,0,0,0,0,0,1,0,1,2,
1,1,1,1,1,1,0,0,2,2,2,2,2,0,1,1,0,1,1,1,1,1,0,0,1,0,0,0,1,1,0,1,
2,3,1,2,1,0,1,1,0,2,2,2,0,0,1,0,0,1,1,1,1,0,0,0,0,0,0,0,1,0,1,2,
1,1,1,1,2,1,1,1,1,1,1,1,1,0,1,1,0,1,0,1,0,1,0,0,1,0,0,0,0,1,0,0,
2,2,2,2,2,0,0,2,0,0,2,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,0,2,0,2,2,
1,1,1,1,1,0,0,1,2,1,1,0,1,0,1,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
1,2,2,2,2,0,0,2,0,1,1,0,0,0,1,0,0,2,0,2,0,0,0,0,0,0,0,0,0,0,1,1,
0,0,0,1,1,1,1,1,1,1,1,1,1,0,1,0,0,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,
1,2,2,3,2,0,0,1,0,0,1,0,0,0,0,0,0,1,0,2,0,0,0,1,0,0,0,0,0,0,0,2,
1,1,0,0,1,0,0,0,1,1,0,0,1,0,1,1,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
2,1,2,2,2,1,2,1,2,2,1,1,2,1,1,1,0,1,1,1,1,2,0,1,0,1,1,1,1,0,1,1,
1,1,2,1,1,1,1,1,1,0,0,1,2,1,1,1,1,1,1,0,0,1,1,1,0,0,0,0,0,0,0,0,
1,0,0,1,3,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,2,1,0,0,1,0,2,0,0,0,0,0,1,1,1,0,1,0,0,0,0,0,0,0,0,2,0,0,1,
0,2,0,1,0,0,1,1,2,0,1,0,1,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,
1,2,2,2,2,0,1,1,0,2,1,0,1,1,1,0,0,1,0,2,0,1,0,0,0,0,0,0,0,0,0,1,
0,1,0,0,1,0,0,0,1,1,0,0,1,0,0,1,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,2,2,0,0,1,0,0,0,1,0,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,1,
0,1,0,1,1,1,0,0,1,1,1,0,1,0,0,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,
2,0,1,0,0,1,2,1,1,1,1,1,1,2,2,1,0,0,1,0,1,0,0,0,0,1,1,1,1,0,0,0,
1,1,2,1,1,1,1,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,1,2,1,0,0,1,0,0,0,0,0,0,0,0,1,1,0,1,0,0,0,0,0,0,0,0,0,0,0,1,
0,0,0,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,1,2,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
0,1,1,0,1,1,1,0,0,1,0,0,1,0,1,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,0,0,
1,0,1,0,0,1,1,1,1,1,1,1,1,1,1,1,0,0,1,0,2,0,0,2,0,1,0,0,1,0,0,1,
1,1,0,0,1,1,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,
1,1,1,1,1,1,1,2,0,0,0,0,0,0,2,1,0,1,1,0,0,1,1,1,0,1,0,0,0,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,1,0,1,1,0,1,1,1,1,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
)

Latin5BulgarianModel = {
  'char_to_order_map': Latin5_BulgarianCharToOrderMap,
  'precedence_matrix': BulgarianLangModel,
  'typical_positive_ratio': 0.969392,
  'keep_english_letter': False,
  'charset_name': "ISO-8859-5",
  'language': 'Bulgairan',
}

Win1251BulgarianModel = {
  'char_to_order_map': win1251BulgarianCharToOrderMap,
  'precedence_matrix': BulgarianLangModel,
  'typical_positive_ratio': 0.969392,
  'keep_english_letter': False,
  'charset_name': "windows-1251",
  'language': 'Bulgarian',
}
site-packages/pip/_vendor/chardet/hebrewprober.py000064400000033016151446177000016172 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
#          Shy Shalom
# Portions created by the Initial Developer are Copyright (C) 2005
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetprober import CharSetProber
from .enums import ProbingState

# This prober doesn't actually recognize a language or a charset.
# It is a helper prober for the use of the Hebrew model probers

### General ideas of the Hebrew charset recognition ###
#
# Four main charsets exist in Hebrew:
# "ISO-8859-8" - Visual Hebrew
# "windows-1255" - Logical Hebrew
# "ISO-8859-8-I" - Logical Hebrew
# "x-mac-hebrew" - ?? Logical Hebrew ??
#
# Both "ISO" charsets use a completely identical set of code points, whereas
# "windows-1255" and "x-mac-hebrew" are two different proper supersets of
# these code points. windows-1255 defines additional characters in the range
# 0x80-0x9F as some misc punctuation marks as well as some Hebrew-specific
# diacritics and additional 'Yiddish' ligature letters in the range 0xc0-0xd6.
# x-mac-hebrew defines similar additional code points but with a different
# mapping.
#
# As far as an average Hebrew text with no diacritics is concerned, all four
# charsets are identical with respect to code points. Meaning that for the
# main Hebrew alphabet, all four map the same values to all 27 Hebrew letters
# (including final letters).
#
# The dominant difference between these charsets is their directionality.
# "Visual" directionality means that the text is ordered as if the renderer is
# not aware of a BIDI rendering algorithm. The renderer sees the text and
# draws it from left to right. The text itself when ordered naturally is read
# backwards. A buffer of Visual Hebrew generally looks like so:
# "[last word of first line spelled backwards] [whole line ordered backwards
# and spelled backwards] [first word of first line spelled backwards]
# [end of line] [last word of second line] ... etc' "
# adding punctuation marks, numbers and English text to visual text is
# naturally also "visual" and from left to right.
#
# "Logical" directionality means the text is ordered "naturally" according to
# the order it is read. It is the responsibility of the renderer to display
# the text from right to left. A BIDI algorithm is used to place general
# punctuation marks, numbers and English text in the text.
#
# Texts in x-mac-hebrew are almost impossible to find on the Internet. From
# what little evidence I could find, it seems that its general directionality
# is Logical.
#
# To sum up all of the above, the Hebrew probing mechanism knows about two
# charsets:
# Visual Hebrew - "ISO-8859-8" - backwards text - Words and sentences are
#    backwards while line order is natural. For charset recognition purposes
#    the line order is unimportant (In fact, for this implementation, even
#    word order is unimportant).
# Logical Hebrew - "windows-1255" - normal, naturally ordered text.
#
# "ISO-8859-8-I" is a subset of windows-1255 and doesn't need to be
#    specifically identified.
# "x-mac-hebrew" is also identified as windows-1255. A text in x-mac-hebrew
#    that contain special punctuation marks or diacritics is displayed with
#    some unconverted characters showing as question marks. This problem might
#    be corrected using another model prober for x-mac-hebrew. Due to the fact
#    that x-mac-hebrew texts are so rare, writing another model prober isn't
#    worth the effort and performance hit.
#
#### The Prober ####
#
# The prober is divided between two SBCharSetProbers and a HebrewProber,
# all of which are managed, created, fed data, inquired and deleted by the
# SBCSGroupProber. The two SBCharSetProbers identify that the text is in
# fact some kind of Hebrew, Logical or Visual. The final decision about which
# one is it is made by the HebrewProber by combining final-letter scores
# with the scores of the two SBCharSetProbers to produce a final answer.
#
# The SBCSGroupProber is responsible for stripping the original text of HTML
# tags, English characters, numbers, low-ASCII punctuation characters, spaces
# and new lines. It reduces any sequence of such characters to a single space.
# The buffer fed to each prober in the SBCS group prober is pure text in
# high-ASCII.
# The two SBCharSetProbers (model probers) share the same language model:
# Win1255Model.
# The first SBCharSetProber uses the model normally as any other
# SBCharSetProber does, to recognize windows-1255, upon which this model was
# built. The second SBCharSetProber is told to make the pair-of-letter
# lookup in the language model backwards. This in practice exactly simulates
# a visual Hebrew model using the windows-1255 logical Hebrew model.
#
# The HebrewProber is not using any language model. All it does is look for
# final-letter evidence suggesting the text is either logical Hebrew or visual
# Hebrew. Disjointed from the model probers, the results of the HebrewProber
# alone are meaningless. HebrewProber always returns 0.00 as confidence
# since it never identifies a charset by itself. Instead, the pointer to the
# HebrewProber is passed to the model probers as a helper "Name Prober".
# When the Group prober receives a positive identification from any prober,
# it asks for the name of the charset identified. If the prober queried is a
# Hebrew model prober, the model prober forwards the call to the
# HebrewProber to make the final decision. In the HebrewProber, the
# decision is made according to the final-letters scores maintained and Both
# model probers scores. The answer is returned in the form of the name of the
# charset identified, either "windows-1255" or "ISO-8859-8".

class HebrewProber(CharSetProber):
    # windows-1255 / ISO-8859-8 code points of interest
    FINAL_KAF = 0xea
    NORMAL_KAF = 0xeb
    FINAL_MEM = 0xed
    NORMAL_MEM = 0xee
    FINAL_NUN = 0xef
    NORMAL_NUN = 0xf0
    FINAL_PE = 0xf3
    NORMAL_PE = 0xf4
    FINAL_TSADI = 0xf5
    NORMAL_TSADI = 0xf6

    # Minimum Visual vs Logical final letter score difference.
    # If the difference is below this, don't rely solely on the final letter score
    # distance.
    MIN_FINAL_CHAR_DISTANCE = 5

    # Minimum Visual vs Logical model score difference.
    # If the difference is below this, don't rely at all on the model score
    # distance.
    MIN_MODEL_DISTANCE = 0.01

    VISUAL_HEBREW_NAME = "ISO-8859-8"
    LOGICAL_HEBREW_NAME = "windows-1255"

    def __init__(self):
        super(HebrewProber, self).__init__()
        self._final_char_logical_score = None
        self._final_char_visual_score = None
        self._prev = None
        self._before_prev = None
        self._logical_prober = None
        self._visual_prober = None
        self.reset()

    def reset(self):
        self._final_char_logical_score = 0
        self._final_char_visual_score = 0
        # The two last characters seen in the previous buffer,
        # mPrev and mBeforePrev are initialized to space in order to simulate
        # a word delimiter at the beginning of the data
        self._prev = ' '
        self._before_prev = ' '
        # These probers are owned by the group prober.

    def set_model_probers(self, logicalProber, visualProber):
        self._logical_prober = logicalProber
        self._visual_prober = visualProber

    def is_final(self, c):
        return c in [self.FINAL_KAF, self.FINAL_MEM, self.FINAL_NUN,
                     self.FINAL_PE, self.FINAL_TSADI]

    def is_non_final(self, c):
        # The normal Tsadi is not a good Non-Final letter due to words like
        # 'lechotet' (to chat) containing an apostrophe after the tsadi. This
        # apostrophe is converted to a space in FilterWithoutEnglishLetters
        # causing the Non-Final tsadi to appear at an end of a word even
        # though this is not the case in the original text.
        # The letters Pe and Kaf rarely display a related behavior of not being
        # a good Non-Final letter. Words like 'Pop', 'Winamp' and 'Mubarak'
        # for example legally end with a Non-Final Pe or Kaf. However, the
        # benefit of these letters as Non-Final letters outweighs the damage
        # since these words are quite rare.
        return c in [self.NORMAL_KAF, self.NORMAL_MEM,
                     self.NORMAL_NUN, self.NORMAL_PE]

    def feed(self, byte_str):
        # Final letter analysis for logical-visual decision.
        # Look for evidence that the received buffer is either logical Hebrew
        # or visual Hebrew.
        # The following cases are checked:
        # 1) A word longer than 1 letter, ending with a final letter. This is
        #    an indication that the text is laid out "naturally" since the
        #    final letter really appears at the end. +1 for logical score.
        # 2) A word longer than 1 letter, ending with a Non-Final letter. In
        #    normal Hebrew, words ending with Kaf, Mem, Nun, Pe or Tsadi,
        #    should not end with the Non-Final form of that letter. Exceptions
        #    to this rule are mentioned above in isNonFinal(). This is an
        #    indication that the text is laid out backwards. +1 for visual
        #    score
        # 3) A word longer than 1 letter, starting with a final letter. Final
        #    letters should not appear at the beginning of a word. This is an
        #    indication that the text is laid out backwards. +1 for visual
        #    score.
        #
        # The visual score and logical score are accumulated throughout the
        # text and are finally checked against each other in GetCharSetName().
        # No checking for final letters in the middle of words is done since
        # that case is not an indication for either Logical or Visual text.
        #
        # We automatically filter out all 7-bit characters (replace them with
        # spaces) so the word boundary detection works properly. [MAP]

        if self.state == ProbingState.NOT_ME:
            # Both model probers say it's not them. No reason to continue.
            return ProbingState.NOT_ME

        byte_str = self.filter_high_byte_only(byte_str)

        for cur in byte_str:
            if cur == ' ':
                # We stand on a space - a word just ended
                if self._before_prev != ' ':
                    # next-to-last char was not a space so self._prev is not a
                    # 1 letter word
                    if self.is_final(self._prev):
                        # case (1) [-2:not space][-1:final letter][cur:space]
                        self._final_char_logical_score += 1
                    elif self.is_non_final(self._prev):
                        # case (2) [-2:not space][-1:Non-Final letter][
                        #  cur:space]
                        self._final_char_visual_score += 1
            else:
                # Not standing on a space
                if ((self._before_prev == ' ') and
                        (self.is_final(self._prev)) and (cur != ' ')):
                    # case (3) [-2:space][-1:final letter][cur:not space]
                    self._final_char_visual_score += 1
            self._before_prev = self._prev
            self._prev = cur

        # Forever detecting, till the end or until both model probers return
        # ProbingState.NOT_ME (handled above)
        return ProbingState.DETECTING

    @property
    def charset_name(self):
        # Make the decision: is it Logical or Visual?
        # If the final letter score distance is dominant enough, rely on it.
        finalsub = self._final_char_logical_score - self._final_char_visual_score
        if finalsub >= self.MIN_FINAL_CHAR_DISTANCE:
            return self.LOGICAL_HEBREW_NAME
        if finalsub <= -self.MIN_FINAL_CHAR_DISTANCE:
            return self.VISUAL_HEBREW_NAME

        # It's not dominant enough, try to rely on the model scores instead.
        modelsub = (self._logical_prober.get_confidence()
                    - self._visual_prober.get_confidence())
        if modelsub > self.MIN_MODEL_DISTANCE:
            return self.LOGICAL_HEBREW_NAME
        if modelsub < -self.MIN_MODEL_DISTANCE:
            return self.VISUAL_HEBREW_NAME

        # Still no good, back to final letter distance, maybe it'll save the
        # day.
        if finalsub < 0.0:
            return self.VISUAL_HEBREW_NAME

        # (finalsub > 0 - Logical) or (don't know what to do) default to
        # Logical.
        return self.LOGICAL_HEBREW_NAME

    @property
    def language(self):
        return 'Hebrew'

    @property
    def state(self):
        # Remain active as long as any of the model probers are active.
        if (self._logical_prober.state == ProbingState.NOT_ME) and \
           (self._visual_prober.state == ProbingState.NOT_ME):
            return ProbingState.NOT_ME
        return ProbingState.DETECTING
site-packages/pip/_vendor/chardet/__init__.py000064400000003027151446177000015242 0ustar00######################## BEGIN LICENSE BLOCK ########################
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################


from .compat import PY2, PY3
from .universaldetector import UniversalDetector
from .version import __version__, VERSION


def detect(byte_str):
    """
    Detect the encoding of the given byte string.

    :param byte_str:     The byte sequence to examine.
    :type byte_str:      ``bytes`` or ``bytearray``
    """
    if not isinstance(byte_str, bytearray):
        if not isinstance(byte_str, bytes):
            raise TypeError('Expected object of type bytes or bytearray, got: '
                            '{0}'.format(type(byte_str)))
        else:
            byte_str = bytearray(byte_str)
    detector = UniversalDetector()
    detector.feed(byte_str)
    return detector.close()
site-packages/pip/_vendor/chardet/gb2312prober.py000064400000003332151446177000015614 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .mbcharsetprober import MultiByteCharSetProber
from .codingstatemachine import CodingStateMachine
from .chardistribution import GB2312DistributionAnalysis
from .mbcssm import GB2312_SM_MODEL

class GB2312Prober(MultiByteCharSetProber):
    def __init__(self):
        super(GB2312Prober, self).__init__()
        self.coding_sm = CodingStateMachine(GB2312_SM_MODEL)
        self.distribution_analyzer = GB2312DistributionAnalysis()
        self.reset()

    @property
    def charset_name(self):
        return "GB2312"

    @property
    def language(self):
        return "Chinese"
site-packages/pip/_vendor/chardet/langturkishmodel.py000064400000025536151446177000017070 0ustar00# -*- coding: utf-8 -*-
######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Özgür Baskın - Turkish Language Model
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# 255: Control characters that usually does not exist in any text
# 254: Carriage/Return
# 253: symbol (punctuation) that does not belong to word
# 252: 0 - 9

# Character Mapping Table:
Latin5_TurkishCharToOrderMap = (
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,
255, 23, 37, 47, 39, 29, 52, 36, 45, 53, 60, 16, 49, 20, 46, 42,
 48, 69, 44, 35, 31, 51, 38, 62, 65, 43, 56,255,255,255,255,255,
255,  1, 21, 28, 12,  2, 18, 27, 25,  3, 24, 10,  5, 13,  4, 15,
 26, 64,  7,  8,  9, 14, 32, 57, 58, 11, 22,255,255,255,255,255,
180,179,178,177,176,175,174,173,172,171,170,169,168,167,166,165,
164,163,162,161,160,159,101,158,157,156,155,154,153,152,151,106,
150,149,148,147,146,145,144,100,143,142,141,140,139,138,137,136,
 94, 80, 93,135,105,134,133, 63,132,131,130,129,128,127,126,125,
124,104, 73, 99, 79, 85,123, 54,122, 98, 92,121,120, 91,103,119,
 68,118,117, 97,116,115, 50, 90,114,113,112,111, 55, 41, 40, 86,
 89, 70, 59, 78, 71, 82, 88, 33, 77, 66, 84, 83,110, 75, 61, 96,
 30, 67,109, 74, 87,102, 34, 95, 81,108, 76, 72, 17,  6, 19,107,
)

TurkishLangModel = (
3,2,3,3,3,1,3,3,3,3,3,3,3,3,2,1,1,3,3,1,3,3,0,3,3,3,3,3,0,3,1,3,
3,2,1,0,0,1,1,0,0,0,1,0,0,1,1,1,1,0,0,0,0,0,0,0,2,2,0,0,1,0,0,1,
3,2,2,3,3,0,3,3,3,3,3,3,3,2,3,1,0,3,3,1,3,3,0,3,3,3,3,3,0,3,0,3,
3,1,1,0,1,0,1,0,0,0,0,0,0,1,1,1,1,0,0,0,0,0,0,0,2,2,0,0,0,1,0,1,
3,3,2,3,3,0,3,3,3,3,3,3,3,2,3,1,1,3,3,0,3,3,1,2,3,3,3,3,0,3,0,3,
3,1,1,0,0,0,1,0,0,0,0,1,1,0,1,2,1,0,0,0,1,0,0,0,0,2,0,0,0,0,0,1,
3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,1,3,3,2,0,3,2,1,2,2,1,3,3,0,0,0,2,
2,2,0,1,0,0,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,1,0,1,0,0,1,
3,3,3,2,3,3,1,2,3,3,3,3,3,3,3,1,3,2,1,0,3,2,0,1,2,3,3,2,1,0,0,2,
2,1,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,2,0,2,0,0,0,
1,0,1,3,3,1,3,3,3,3,3,3,3,1,2,0,0,2,3,0,2,3,0,0,2,2,2,3,0,3,0,1,
2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,0,3,3,3,0,3,2,0,2,3,2,3,3,1,0,0,2,
3,2,0,0,1,0,0,0,0,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,1,1,1,0,2,0,0,1,
3,3,3,2,3,3,2,3,3,3,3,2,3,3,3,0,3,3,0,0,2,1,0,0,2,3,2,2,0,0,0,2,
2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,0,0,0,1,0,1,0,2,0,0,1,
3,3,3,2,3,3,3,3,3,3,3,2,3,3,3,0,3,2,0,1,3,2,1,1,3,2,3,2,1,0,0,2,
2,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,0,
3,3,3,2,3,3,3,3,3,3,3,2,3,3,3,0,3,2,2,0,2,3,0,0,2,2,2,2,0,0,0,2,
3,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,2,0,1,0,0,0,
3,3,3,3,3,3,3,2,2,2,2,3,2,3,3,0,3,3,1,1,2,2,0,0,2,2,3,2,0,0,1,3,
0,3,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,1,
3,3,3,2,3,3,3,2,1,2,2,3,2,3,3,0,3,2,0,0,1,1,0,1,1,2,1,2,0,0,0,1,
0,3,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,1,0,0,0,
3,3,3,2,3,3,2,3,2,2,2,3,3,3,3,1,3,1,1,0,3,2,1,1,3,3,2,3,1,0,0,1,
1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,2,0,0,1,
3,2,2,3,3,0,3,3,3,3,3,3,3,2,2,1,0,3,3,1,3,3,0,1,3,3,2,3,0,3,0,3,
2,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
2,2,2,3,3,0,3,3,3,3,3,3,3,3,3,0,0,3,2,0,3,3,0,3,2,3,3,3,0,3,1,3,
2,0,0,0,0,0,0,0,0,0,0,1,0,1,2,0,1,0,0,0,0,0,0,0,2,2,0,0,1,0,0,1,
3,3,3,1,2,3,3,1,0,0,1,0,0,3,3,2,3,0,0,2,0,0,2,0,2,0,0,0,2,0,2,0,
0,3,1,0,1,0,0,0,2,2,1,0,1,1,2,1,2,2,2,0,2,1,1,0,0,0,2,0,0,0,0,0,
1,2,1,3,3,0,3,3,3,3,3,2,3,0,0,0,0,2,3,0,2,3,1,0,2,3,1,3,0,3,0,2,
3,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,1,3,3,2,2,3,2,2,0,1,2,3,0,1,2,1,0,1,0,0,0,1,0,2,2,0,0,0,1,
1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,1,0,0,1,0,0,0,
3,3,3,1,3,3,1,1,3,3,1,1,3,3,1,0,2,1,2,0,2,1,0,0,1,1,2,1,0,0,0,2,
2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,1,0,2,1,3,0,0,2,0,0,3,3,0,3,0,0,1,0,1,2,0,0,1,1,2,2,0,1,0,
0,1,2,1,1,0,1,0,1,1,1,1,1,0,1,1,1,2,2,1,2,0,1,0,0,0,0,0,0,1,0,0,
3,3,3,2,3,2,3,3,0,2,2,2,3,3,3,0,3,0,0,0,2,2,0,1,2,1,1,1,0,0,0,1,
0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
3,3,3,3,3,3,2,1,2,2,3,3,3,3,2,0,2,0,0,0,2,2,0,0,2,1,3,3,0,0,1,1,
1,1,0,0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,
1,1,2,3,3,0,3,3,3,3,3,3,2,2,0,2,0,2,3,2,3,2,2,2,2,2,2,2,1,3,2,3,
2,0,2,1,2,2,2,2,1,1,2,2,1,2,2,1,2,0,0,2,1,1,0,2,1,0,0,1,0,0,0,1,
2,3,3,1,1,1,0,1,1,1,2,3,2,1,1,0,0,0,0,0,0,0,0,0,0,1,0,1,0,0,0,0,
0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,2,2,2,3,2,3,2,2,1,3,3,3,0,2,1,2,0,2,1,0,0,1,1,1,1,1,0,0,1,
2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,2,0,1,0,0,0,
3,3,3,2,3,3,3,3,3,2,3,1,2,3,3,1,2,0,0,0,0,0,0,0,3,2,1,1,0,0,0,0,
2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
3,3,3,2,2,3,3,2,1,1,1,1,1,3,3,0,3,1,0,0,1,1,0,0,3,1,2,1,0,0,0,0,
0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,
3,3,3,2,2,3,2,2,2,3,2,1,1,3,3,0,3,0,0,0,0,1,0,0,3,1,1,2,0,0,0,1,
1,0,0,1,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,
1,1,1,3,3,0,3,3,3,3,3,2,2,2,1,2,0,2,1,2,2,1,1,0,1,2,2,2,2,2,2,2,
0,0,2,1,2,1,2,1,0,1,1,3,1,2,1,1,2,0,0,2,0,1,0,1,0,1,0,0,0,1,0,1,
3,3,3,1,3,3,3,0,1,1,0,2,2,3,1,0,3,0,0,0,1,0,0,0,1,0,0,1,0,1,0,0,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,2,0,0,2,2,1,0,0,1,0,0,3,3,1,3,0,0,1,1,0,2,0,3,0,0,0,2,0,1,1,
0,1,2,0,1,2,2,0,2,2,2,2,1,0,2,1,1,0,2,0,2,1,2,0,0,0,0,0,0,0,0,0,
3,3,3,1,3,2,3,2,0,2,2,2,1,3,2,0,2,1,2,0,1,2,0,0,1,0,2,2,0,0,0,2,
1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,1,0,1,0,0,0,
3,3,3,0,3,3,1,1,2,3,1,0,3,2,3,0,3,0,0,0,1,0,0,0,1,0,1,0,0,0,0,0,
1,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,3,3,0,3,3,2,3,3,2,2,0,0,0,0,1,2,0,1,3,0,0,0,3,1,1,0,3,0,2,
2,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,1,2,2,1,0,3,1,1,1,1,3,3,2,3,0,0,1,0,1,2,0,2,2,0,2,2,0,2,1,
0,2,2,1,1,1,1,0,2,1,1,0,1,1,1,1,2,1,2,1,2,0,1,0,1,0,0,0,0,0,0,0,
3,3,3,0,1,1,3,0,0,1,1,0,0,2,2,0,3,0,0,1,1,0,1,0,0,0,0,0,2,0,0,0,
0,3,1,0,1,0,1,0,2,0,0,1,0,1,0,1,1,1,2,1,1,0,2,0,0,0,0,0,0,0,0,0,
3,3,3,0,2,0,2,0,1,1,1,0,0,3,3,0,2,0,0,1,0,0,2,1,1,0,1,0,1,0,1,0,
0,2,0,1,2,0,2,0,2,1,1,0,1,0,2,1,1,0,2,1,1,0,1,0,0,0,1,1,0,0,0,0,
3,2,3,0,1,0,0,0,0,0,0,0,0,1,2,0,1,0,0,1,0,0,1,0,0,0,0,0,2,0,0,0,
0,0,1,1,0,0,1,0,1,0,0,1,0,0,0,2,1,0,1,0,2,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,0,0,2,3,0,0,1,0,1,0,2,3,2,3,0,0,1,3,0,2,1,0,0,0,0,2,0,1,0,
0,2,1,0,0,1,1,0,2,1,0,0,1,0,0,1,1,0,1,1,2,0,1,0,0,0,0,1,0,0,0,0,
3,2,2,0,0,1,1,0,0,0,0,0,0,3,1,1,1,0,0,0,0,0,1,0,0,0,0,0,2,0,1,0,
0,1,0,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,
0,0,0,3,3,0,2,3,2,2,1,2,2,1,1,2,0,1,3,2,2,2,0,0,2,2,0,0,0,1,2,1,
3,0,2,1,1,0,1,1,1,0,1,2,2,2,1,1,2,0,0,0,0,1,0,1,1,0,0,0,0,0,0,0,
0,1,1,2,3,0,3,3,3,2,2,2,2,1,0,1,0,1,0,1,2,2,0,0,2,2,1,3,1,1,2,1,
0,0,1,1,2,0,1,1,0,0,1,2,0,2,1,1,2,0,0,1,0,0,0,1,0,1,0,1,0,0,0,0,
3,3,2,0,0,3,1,0,0,0,0,0,0,3,2,1,2,0,0,1,0,0,2,0,0,0,0,0,2,0,1,0,
0,2,1,1,0,0,1,0,1,2,0,0,1,1,0,0,2,1,1,1,1,0,2,0,0,0,0,0,0,0,0,0,
3,3,2,0,0,1,0,0,0,0,1,0,0,3,3,2,2,0,0,1,0,0,2,0,1,0,0,0,2,0,1,0,
0,0,1,1,0,0,2,0,2,1,0,0,1,1,2,1,2,0,2,1,2,1,1,1,0,0,1,1,0,0,0,0,
3,3,2,0,0,2,2,0,0,0,1,1,0,2,2,1,3,1,0,1,0,1,2,0,0,0,0,0,1,0,1,0,
0,1,1,0,0,0,0,0,1,0,0,1,0,0,0,1,1,0,1,0,1,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,2,0,0,0,1,0,0,1,0,0,2,3,1,2,0,0,1,0,0,2,0,0,0,1,0,2,0,2,0,
0,1,1,2,2,1,2,0,2,1,1,0,0,1,1,0,1,1,1,1,2,1,1,0,0,0,0,0,0,0,0,0,
3,3,3,0,2,1,2,1,0,0,1,1,0,3,3,1,2,0,0,1,0,0,2,0,2,0,1,1,2,0,0,0,
0,0,1,1,1,1,2,0,1,1,0,1,1,1,1,0,0,0,1,1,1,0,1,0,0,0,1,0,0,0,0,0,
3,3,3,0,2,2,3,2,0,0,1,0,0,2,3,1,0,0,0,0,0,0,2,0,2,0,0,0,2,0,0,0,
0,1,1,0,0,0,1,0,0,1,0,1,1,0,1,0,1,1,1,0,1,0,0,0,0,0,0,0,0,0,0,0,
3,2,3,0,0,0,0,0,0,0,1,0,0,2,2,2,2,0,0,1,0,0,2,0,0,0,0,0,2,0,1,0,
0,0,2,1,1,0,1,0,2,1,1,0,0,1,1,2,1,0,2,0,2,0,1,0,0,0,2,0,0,0,0,0,
0,0,0,2,2,0,2,1,1,1,1,2,2,0,0,1,0,1,0,0,1,3,0,0,0,0,1,0,0,2,1,0,
0,0,1,0,1,0,0,0,0,0,2,1,0,1,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,
2,0,0,2,3,0,2,3,1,2,2,0,2,0,0,2,0,2,1,1,1,2,1,0,0,1,2,1,1,2,1,0,
1,0,2,0,1,0,1,1,0,0,2,2,1,2,1,1,2,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,0,2,1,2,0,0,0,1,0,0,3,2,0,1,0,0,1,0,0,2,0,0,0,1,2,1,0,1,0,
0,0,0,0,1,0,1,0,0,1,0,0,0,0,1,0,1,0,1,1,1,0,1,0,0,0,0,0,0,0,0,0,
0,0,0,2,2,0,2,2,1,1,0,1,1,1,1,1,0,0,1,2,1,1,1,0,1,0,0,0,1,1,1,1,
0,0,2,1,0,1,1,1,0,1,1,2,1,2,1,1,2,0,1,1,2,1,0,2,0,0,0,0,0,0,0,0,
3,2,2,0,0,2,0,0,0,0,0,0,0,2,2,0,2,0,0,1,0,0,2,0,0,0,0,0,2,0,0,0,
0,2,1,0,0,0,0,0,1,0,0,0,0,0,0,0,1,0,0,0,1,0,1,0,0,0,0,0,0,0,0,0,
0,0,0,3,2,0,2,2,0,1,1,0,1,0,0,1,0,0,0,1,0,1,0,0,0,0,0,1,0,0,0,0,
2,0,1,0,1,0,1,1,0,0,1,2,0,1,0,1,1,0,0,1,0,1,0,2,0,0,0,0,0,0,0,0,
2,2,2,0,1,1,0,0,0,1,0,0,0,1,2,0,1,0,0,1,0,0,1,0,0,0,0,1,2,0,1,0,
0,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,1,0,1,0,2,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,2,1,0,1,1,1,0,0,0,0,1,2,0,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
1,1,2,0,1,0,0,0,1,0,1,0,0,0,1,0,0,1,0,0,0,0,0,0,0,1,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,2,0,0,0,0,0,1,
0,0,1,2,2,0,2,1,2,1,1,2,2,0,0,0,0,1,0,0,1,1,0,0,2,0,0,0,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,
2,2,2,0,0,0,1,0,0,0,0,0,0,2,2,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
0,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,1,1,0,0,0,1,0,0,0,1,0,0,0,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,0,1,0,1,0,0,0,0,0,0,1,1,0,0,0,0,0,0,0,1,0,1,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,1,0,0,0,0,0,0,0,0,0,0,2,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
)

Latin5TurkishModel = {
  'char_to_order_map': Latin5_TurkishCharToOrderMap,
  'precedence_matrix': TurkishLangModel,
  'typical_positive_ratio': 0.970290,
  'keep_english_letter': True,
  'charset_name': "ISO-8859-9",
  'language': 'Turkish',
}
site-packages/pip/_vendor/chardet/latin1prober.py000064400000012372151446177000016110 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 2001
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetprober import CharSetProber
from .enums import ProbingState

FREQ_CAT_NUM = 4

UDF = 0  # undefined
OTH = 1  # other
ASC = 2  # ascii capital letter
ASS = 3  # ascii small letter
ACV = 4  # accent capital vowel
ACO = 5  # accent capital other
ASV = 6  # accent small vowel
ASO = 7  # accent small other
CLASS_NUM = 8  # total classes

Latin1_CharToClass = (
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 00 - 07
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 08 - 0F
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 10 - 17
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 18 - 1F
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 20 - 27
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 28 - 2F
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 30 - 37
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 38 - 3F
    OTH, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 40 - 47
    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 48 - 4F
    ASC, ASC, ASC, ASC, ASC, ASC, ASC, ASC,   # 50 - 57
    ASC, ASC, ASC, OTH, OTH, OTH, OTH, OTH,   # 58 - 5F
    OTH, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 60 - 67
    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 68 - 6F
    ASS, ASS, ASS, ASS, ASS, ASS, ASS, ASS,   # 70 - 77
    ASS, ASS, ASS, OTH, OTH, OTH, OTH, OTH,   # 78 - 7F
    OTH, UDF, OTH, ASO, OTH, OTH, OTH, OTH,   # 80 - 87
    OTH, OTH, ACO, OTH, ACO, UDF, ACO, UDF,   # 88 - 8F
    UDF, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # 90 - 97
    OTH, OTH, ASO, OTH, ASO, UDF, ASO, ACO,   # 98 - 9F
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # A0 - A7
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # A8 - AF
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # B0 - B7
    OTH, OTH, OTH, OTH, OTH, OTH, OTH, OTH,   # B8 - BF
    ACV, ACV, ACV, ACV, ACV, ACV, ACO, ACO,   # C0 - C7
    ACV, ACV, ACV, ACV, ACV, ACV, ACV, ACV,   # C8 - CF
    ACO, ACO, ACV, ACV, ACV, ACV, ACV, OTH,   # D0 - D7
    ACV, ACV, ACV, ACV, ACV, ACO, ACO, ACO,   # D8 - DF
    ASV, ASV, ASV, ASV, ASV, ASV, ASO, ASO,   # E0 - E7
    ASV, ASV, ASV, ASV, ASV, ASV, ASV, ASV,   # E8 - EF
    ASO, ASO, ASV, ASV, ASV, ASV, ASV, OTH,   # F0 - F7
    ASV, ASV, ASV, ASV, ASV, ASO, ASO, ASO,   # F8 - FF
)

# 0 : illegal
# 1 : very unlikely
# 2 : normal
# 3 : very likely
Latin1ClassModel = (
# UDF OTH ASC ASS ACV ACO ASV ASO
    0,  0,  0,  0,  0,  0,  0,  0,  # UDF
    0,  3,  3,  3,  3,  3,  3,  3,  # OTH
    0,  3,  3,  3,  3,  3,  3,  3,  # ASC
    0,  3,  3,  3,  1,  1,  3,  3,  # ASS
    0,  3,  3,  3,  1,  2,  1,  2,  # ACV
    0,  3,  3,  3,  3,  3,  3,  3,  # ACO
    0,  3,  1,  3,  1,  1,  1,  3,  # ASV
    0,  3,  1,  3,  1,  1,  3,  3,  # ASO
)


class Latin1Prober(CharSetProber):
    def __init__(self):
        super(Latin1Prober, self).__init__()
        self._last_char_class = None
        self._freq_counter = None
        self.reset()

    def reset(self):
        self._last_char_class = OTH
        self._freq_counter = [0] * FREQ_CAT_NUM
        CharSetProber.reset(self)

    @property
    def charset_name(self):
        return "ISO-8859-1"

    @property
    def language(self):
        return ""

    def feed(self, byte_str):
        byte_str = self.filter_with_english_letters(byte_str)
        for c in byte_str:
            char_class = Latin1_CharToClass[c]
            freq = Latin1ClassModel[(self._last_char_class * CLASS_NUM)
                                    + char_class]
            if freq == 0:
                self._state = ProbingState.NOT_ME
                break
            self._freq_counter[freq] += 1
            self._last_char_class = char_class

        return self.state

    def get_confidence(self):
        if self.state == ProbingState.NOT_ME:
            return 0.01

        total = sum(self._freq_counter)
        if total < 0.01:
            confidence = 0.0
        else:
            confidence = ((self._freq_counter[3] - self._freq_counter[1] * 20.0)
                          / total)
        if confidence < 0.0:
            confidence = 0.0
        # lower the confidence of latin1 so that other more accurate
        # detector can take priority.
        confidence = confidence * 0.73
        return confidence
site-packages/pip/_vendor/chardet/sbcharsetprober.py000064400000013031151446177000016667 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 2001
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetprober import CharSetProber
from .enums import CharacterCategory, ProbingState, SequenceLikelihood


class SingleByteCharSetProber(CharSetProber):
    SAMPLE_SIZE = 64
    SB_ENOUGH_REL_THRESHOLD = 1024  #  0.25 * SAMPLE_SIZE^2
    POSITIVE_SHORTCUT_THRESHOLD = 0.95
    NEGATIVE_SHORTCUT_THRESHOLD = 0.05

    def __init__(self, model, reversed=False, name_prober=None):
        super(SingleByteCharSetProber, self).__init__()
        self._model = model
        # TRUE if we need to reverse every pair in the model lookup
        self._reversed = reversed
        # Optional auxiliary prober for name decision
        self._name_prober = name_prober
        self._last_order = None
        self._seq_counters = None
        self._total_seqs = None
        self._total_char = None
        self._freq_char = None
        self.reset()

    def reset(self):
        super(SingleByteCharSetProber, self).reset()
        # char order of last character
        self._last_order = 255
        self._seq_counters = [0] * SequenceLikelihood.get_num_categories()
        self._total_seqs = 0
        self._total_char = 0
        # characters that fall in our sampling range
        self._freq_char = 0

    @property
    def charset_name(self):
        if self._name_prober:
            return self._name_prober.charset_name
        else:
            return self._model['charset_name']

    @property
    def language(self):
        if self._name_prober:
            return self._name_prober.language
        else:
            return self._model.get('language')

    def feed(self, byte_str):
        if not self._model['keep_english_letter']:
            byte_str = self.filter_international_words(byte_str)
        if not byte_str:
            return self.state
        char_to_order_map = self._model['char_to_order_map']
        for i, c in enumerate(byte_str):
            # XXX: Order is in range 1-64, so one would think we want 0-63 here,
            #      but that leads to 27 more test failures than before.
            order = char_to_order_map[c]
            # XXX: This was SYMBOL_CAT_ORDER before, with a value of 250, but
            #      CharacterCategory.SYMBOL is actually 253, so we use CONTROL
            #      to make it closer to the original intent. The only difference
            #      is whether or not we count digits and control characters for
            #      _total_char purposes.
            if order < CharacterCategory.CONTROL:
                self._total_char += 1
            if order < self.SAMPLE_SIZE:
                self._freq_char += 1
                if self._last_order < self.SAMPLE_SIZE:
                    self._total_seqs += 1
                    if not self._reversed:
                        i = (self._last_order * self.SAMPLE_SIZE) + order
                        model = self._model['precedence_matrix'][i]
                    else:  # reverse the order of the letters in the lookup
                        i = (order * self.SAMPLE_SIZE) + self._last_order
                        model = self._model['precedence_matrix'][i]
                    self._seq_counters[model] += 1
            self._last_order = order

        charset_name = self._model['charset_name']
        if self.state == ProbingState.DETECTING:
            if self._total_seqs > self.SB_ENOUGH_REL_THRESHOLD:
                confidence = self.get_confidence()
                if confidence > self.POSITIVE_SHORTCUT_THRESHOLD:
                    self.logger.debug('%s confidence = %s, we have a winner',
                                      charset_name, confidence)
                    self._state = ProbingState.FOUND_IT
                elif confidence < self.NEGATIVE_SHORTCUT_THRESHOLD:
                    self.logger.debug('%s confidence = %s, below negative '
                                      'shortcut threshhold %s', charset_name,
                                      confidence,
                                      self.NEGATIVE_SHORTCUT_THRESHOLD)
                    self._state = ProbingState.NOT_ME

        return self.state

    def get_confidence(self):
        r = 0.01
        if self._total_seqs > 0:
            r = ((1.0 * self._seq_counters[SequenceLikelihood.POSITIVE]) /
                 self._total_seqs / self._model['typical_positive_ratio'])
            r = r * self._freq_char / self._total_char
            if r >= 1.0:
                r = 0.99
        return r
site-packages/pip/_vendor/chardet/sbcsgroupprober.py000064400000006732151446177000016732 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 2001
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetgroupprober import CharSetGroupProber
from .sbcharsetprober import SingleByteCharSetProber
from .langcyrillicmodel import (Win1251CyrillicModel, Koi8rModel,
                                Latin5CyrillicModel, MacCyrillicModel,
                                Ibm866Model, Ibm855Model)
from .langgreekmodel import Latin7GreekModel, Win1253GreekModel
from .langbulgarianmodel import Latin5BulgarianModel, Win1251BulgarianModel
# from .langhungarianmodel import Latin2HungarianModel, Win1250HungarianModel
from .langthaimodel import TIS620ThaiModel
from .langhebrewmodel import Win1255HebrewModel
from .hebrewprober import HebrewProber
from .langturkishmodel import Latin5TurkishModel


class SBCSGroupProber(CharSetGroupProber):
    def __init__(self):
        super(SBCSGroupProber, self).__init__()
        self.probers = [
            SingleByteCharSetProber(Win1251CyrillicModel),
            SingleByteCharSetProber(Koi8rModel),
            SingleByteCharSetProber(Latin5CyrillicModel),
            SingleByteCharSetProber(MacCyrillicModel),
            SingleByteCharSetProber(Ibm866Model),
            SingleByteCharSetProber(Ibm855Model),
            SingleByteCharSetProber(Latin7GreekModel),
            SingleByteCharSetProber(Win1253GreekModel),
            SingleByteCharSetProber(Latin5BulgarianModel),
            SingleByteCharSetProber(Win1251BulgarianModel),
            # TODO: Restore Hungarian encodings (iso-8859-2 and windows-1250)
            #       after we retrain model.
            # SingleByteCharSetProber(Latin2HungarianModel),
            # SingleByteCharSetProber(Win1250HungarianModel),
            SingleByteCharSetProber(TIS620ThaiModel),
            SingleByteCharSetProber(Latin5TurkishModel),
        ]
        hebrew_prober = HebrewProber()
        logical_hebrew_prober = SingleByteCharSetProber(Win1255HebrewModel,
                                                        False, hebrew_prober)
        visual_hebrew_prober = SingleByteCharSetProber(Win1255HebrewModel, True,
                                                       hebrew_prober)
        hebrew_prober.set_model_probers(logical_hebrew_prober, visual_hebrew_prober)
        self.probers.extend([hebrew_prober, logical_hebrew_prober,
                             visual_hebrew_prober])

        self.reset()
site-packages/pip/_vendor/chardet/mbcsgroupprober.py000064400000003734151446177000016723 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 2001
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#   Proofpoint, Inc.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetgroupprober import CharSetGroupProber
from .utf8prober import UTF8Prober
from .sjisprober import SJISProber
from .eucjpprober import EUCJPProber
from .gb2312prober import GB2312Prober
from .euckrprober import EUCKRProber
from .cp949prober import CP949Prober
from .big5prober import Big5Prober
from .euctwprober import EUCTWProber


class MBCSGroupProber(CharSetGroupProber):
    def __init__(self, lang_filter=None):
        super(MBCSGroupProber, self).__init__(lang_filter=lang_filter)
        self.probers = [
            UTF8Prober(),
            SJISProber(),
            EUCJPProber(),
            GB2312Prober(),
            EUCKRProber(),
            CP949Prober(),
            Big5Prober(),
            EUCTWProber()
        ]
        self.reset()
site-packages/pip/_vendor/chardet/charsetprober.py000064400000011766151446177000016357 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Universal charset detector code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 2001
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#   Shy Shalom - original C code
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

import logging
import re

from .enums import ProbingState


class CharSetProber(object):

    SHORTCUT_THRESHOLD = 0.95

    def __init__(self, lang_filter=None):
        self._state = None
        self.lang_filter = lang_filter
        self.logger = logging.getLogger(__name__)

    def reset(self):
        self._state = ProbingState.DETECTING

    @property
    def charset_name(self):
        return None

    def feed(self, buf):
        pass

    @property
    def state(self):
        return self._state

    def get_confidence(self):
        return 0.0

    @staticmethod
    def filter_high_byte_only(buf):
        buf = re.sub(b'([\x00-\x7F])+', b' ', buf)
        return buf

    @staticmethod
    def filter_international_words(buf):
        """
        We define three types of bytes:
        alphabet: english alphabets [a-zA-Z]
        international: international characters [\x80-\xFF]
        marker: everything else [^a-zA-Z\x80-\xFF]

        The input buffer can be thought to contain a series of words delimited
        by markers. This function works to filter all words that contain at
        least one international character. All contiguous sequences of markers
        are replaced by a single space ascii character.

        This filter applies to all scripts which do not use English characters.
        """
        filtered = bytearray()

        # This regex expression filters out only words that have at-least one
        # international character. The word may include one marker character at
        # the end.
        words = re.findall(b'[a-zA-Z]*[\x80-\xFF]+[a-zA-Z]*[^a-zA-Z\x80-\xFF]?',
                           buf)

        for word in words:
            filtered.extend(word[:-1])

            # If the last character in the word is a marker, replace it with a
            # space as markers shouldn't affect our analysis (they are used
            # similarly across all languages and may thus have similar
            # frequencies).
            last_char = word[-1:]
            if not last_char.isalpha() and last_char < b'\x80':
                last_char = b' '
            filtered.extend(last_char)

        return filtered

    @staticmethod
    def filter_with_english_letters(buf):
        """
        Returns a copy of ``buf`` that retains only the sequences of English
        alphabet and high byte characters that are not between <> characters.
        Also retains English alphabet and high byte characters immediately
        before occurrences of >.

        This filter can be applied to all scripts which contain both English
        characters and extended ASCII characters, but is currently only used by
        ``Latin1Prober``.
        """
        filtered = bytearray()
        in_tag = False
        prev = 0

        for curr in range(len(buf)):
            # Slice here to get bytes instead of an int with Python 3
            buf_char = buf[curr:curr + 1]
            # Check if we're coming out of or entering an HTML tag
            if buf_char == b'>':
                in_tag = False
            elif buf_char == b'<':
                in_tag = True

            # If current character is not extended-ASCII and not alphabetic...
            if buf_char < b'\x80' and not buf_char.isalpha():
                # ...and we're not in a tag
                if curr > prev and not in_tag:
                    # Keep everything after last non-extended-ASCII,
                    # non-alphabetic character
                    filtered.extend(buf[prev:curr])
                    # Output a space to delimit stretch we kept
                    filtered.extend(b' ')
                prev = curr + 1

        # If we're not in a tag...
        if not in_tag:
            # Keep everything after last non-extended-ASCII, non-alphabetic
            # character
            filtered.extend(buf[prev:])

        return filtered
site-packages/pip/_vendor/chardet/big5prober.py000064400000003335151446177000015545 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .mbcharsetprober import MultiByteCharSetProber
from .codingstatemachine import CodingStateMachine
from .chardistribution import Big5DistributionAnalysis
from .mbcssm import BIG5_SM_MODEL


class Big5Prober(MultiByteCharSetProber):
    def __init__(self):
        super(Big5Prober, self).__init__()
        self.coding_sm = CodingStateMachine(BIG5_SM_MODEL)
        self.distribution_analyzer = Big5DistributionAnalysis()
        self.reset()

    @property
    def charset_name(self):
        return "Big5"

    @property
    def language(self):
        return "Chinese"
site-packages/pip/_vendor/chardet/big5freq.py000064400000075026151446177000015217 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# Big5 frequency table
# by Taiwan's Mandarin Promotion Council
# <http://www.edu.tw:81/mandr/>
#
# 128  --> 0.42261
# 256  --> 0.57851
# 512  --> 0.74851
# 1024 --> 0.89384
# 2048 --> 0.97583
#
# Ideal Distribution Ratio = 0.74851/(1-0.74851) =2.98
# Random Distribution Ration = 512/(5401-512)=0.105
#
# Typical Distribution Ratio about 25% of Ideal one, still much higher than RDR

BIG5_TYPICAL_DISTRIBUTION_RATIO = 0.75

#Char to FreqOrder table
BIG5_TABLE_SIZE = 5376

BIG5_CHAR_TO_FREQ_ORDER = (
   1,1801,1506, 255,1431, 198,   9,  82,   6,5008, 177, 202,3681,1256,2821, 110, #   16
3814,  33,3274, 261,  76,  44,2114,  16,2946,2187,1176, 659,3971,  26,3451,2653, #   32
1198,3972,3350,4202, 410,2215, 302, 590, 361,1964,   8, 204,  58,4510,5009,1932, #   48
  63,5010,5011, 317,1614,  75, 222, 159,4203,2417,1480,5012,3555,3091, 224,2822, #   64
3682,   3,  10,3973,1471,  29,2787,1135,2866,1940, 873, 130,3275,1123, 312,5013, #   80
4511,2052, 507, 252, 682,5014, 142,1915, 124, 206,2947,  34,3556,3204,  64, 604, #   96
5015,2501,1977,1978, 155,1991, 645, 641,1606,5016,3452, 337,  72, 406,5017,  80, #  112
 630, 238,3205,1509, 263, 939,1092,2654, 756,1440,1094,3453, 449,  69,2987, 591, #  128
 179,2096, 471, 115,2035,1844,  60,  50,2988, 134, 806,1869, 734,2036,3454, 180, #  144
 995,1607, 156, 537,2907, 688,5018, 319,1305, 779,2145, 514,2379, 298,4512, 359, #  160
2502,  90,2716,1338, 663,  11, 906,1099,2553,  20,2441, 182, 532,1716,5019, 732, #  176
1376,4204,1311,1420,3206,  25,2317,1056, 113, 399, 382,1950, 242,3455,2474, 529, #  192
3276, 475,1447,3683,5020, 117,  21, 656, 810,1297,2300,2334,3557,5021, 126,4205, #  208
 706, 456, 150, 613,4513,  71,1118,2037,4206, 145,3092,  85, 835, 486,2115,1246, #  224
1426, 428, 727,1285,1015, 800, 106, 623, 303,1281,5022,2128,2359, 347,3815, 221, #  240
3558,3135,5023,1956,1153,4207,  83, 296,1199,3093, 192, 624,  93,5024, 822,1898, #  256
2823,3136, 795,2065, 991,1554,1542,1592,  27,  43,2867, 859, 139,1456, 860,4514, #  272
 437, 712,3974, 164,2397,3137, 695, 211,3037,2097, 195,3975,1608,3559,3560,3684, #  288
3976, 234, 811,2989,2098,3977,2233,1441,3561,1615,2380, 668,2077,1638, 305, 228, #  304
1664,4515, 467, 415,5025, 262,2099,1593, 239, 108, 300, 200,1033, 512,1247,2078, #  320
5026,5027,2176,3207,3685,2682, 593, 845,1062,3277,  88,1723,2038,3978,1951, 212, #  336
 266, 152, 149, 468,1899,4208,4516,  77, 187,5028,3038,  37,   5,2990,5029,3979, #  352
5030,5031,  39,2524,4517,2908,3208,2079,  55, 148,  74,4518, 545, 483,1474,1029, #  368
1665, 217,1870,1531,3138,1104,2655,4209,  24, 172,3562, 900,3980,3563,3564,4519, #  384
  32,1408,2824,1312, 329, 487,2360,2251,2717, 784,2683,   4,3039,3351,1427,1789, #  400
 188, 109, 499,5032,3686,1717,1790, 888,1217,3040,4520,5033,3565,5034,3352,1520, #  416
3687,3981, 196,1034, 775,5035,5036, 929,1816, 249, 439,  38,5037,1063,5038, 794, #  432
3982,1435,2301,  46, 178,3278,2066,5039,2381,5040, 214,1709,4521, 804,  35, 707, #  448
 324,3688,1601,2554, 140, 459,4210,5041,5042,1365, 839, 272, 978,2262,2580,3456, #  464
2129,1363,3689,1423, 697, 100,3094,  48,  70,1231, 495,3139,2196,5043,1294,5044, #  480
2080, 462, 586,1042,3279, 853, 256, 988, 185,2382,3457,1698, 434,1084,5045,3458, #  496
 314,2625,2788,4522,2335,2336, 569,2285, 637,1817,2525, 757,1162,1879,1616,3459, #  512
 287,1577,2116, 768,4523,1671,2868,3566,2526,1321,3816, 909,2418,5046,4211, 933, #  528
3817,4212,2053,2361,1222,4524, 765,2419,1322, 786,4525,5047,1920,1462,1677,2909, #  544
1699,5048,4526,1424,2442,3140,3690,2600,3353,1775,1941,3460,3983,4213, 309,1369, #  560
1130,2825, 364,2234,1653,1299,3984,3567,3985,3986,2656, 525,1085,3041, 902,2001, #  576
1475, 964,4527, 421,1845,1415,1057,2286, 940,1364,3141, 376,4528,4529,1381,   7, #  592
2527, 983,2383, 336,1710,2684,1846, 321,3461, 559,1131,3042,2752,1809,1132,1313, #  608
 265,1481,1858,5049, 352,1203,2826,3280, 167,1089, 420,2827, 776, 792,1724,3568, #  624
4214,2443,3281,5050,4215,5051, 446, 229, 333,2753, 901,3818,1200,1557,4530,2657, #  640
1921, 395,2754,2685,3819,4216,1836, 125, 916,3209,2626,4531,5052,5053,3820,5054, #  656
5055,5056,4532,3142,3691,1133,2555,1757,3462,1510,2318,1409,3569,5057,2146, 438, #  672
2601,2910,2384,3354,1068, 958,3043, 461, 311,2869,2686,4217,1916,3210,4218,1979, #  688
 383, 750,2755,2627,4219, 274, 539, 385,1278,1442,5058,1154,1965, 384, 561, 210, #  704
  98,1295,2556,3570,5059,1711,2420,1482,3463,3987,2911,1257, 129,5060,3821, 642, #  720
 523,2789,2790,2658,5061, 141,2235,1333,  68, 176, 441, 876, 907,4220, 603,2602, #  736
 710, 171,3464, 404, 549,  18,3143,2398,1410,3692,1666,5062,3571,4533,2912,4534, #  752
5063,2991, 368,5064, 146, 366,  99, 871,3693,1543, 748, 807,1586,1185,  22,2263, #  768
 379,3822,3211,5065,3212, 505,1942,2628,1992,1382,2319,5066, 380,2362, 218, 702, #  784
1818,1248,3465,3044,3572,3355,3282,5067,2992,3694, 930,3283,3823,5068,  59,5069, #  800
 585, 601,4221, 497,3466,1112,1314,4535,1802,5070,1223,1472,2177,5071, 749,1837, #  816
 690,1900,3824,1773,3988,1476, 429,1043,1791,2236,2117, 917,4222, 447,1086,1629, #  832
5072, 556,5073,5074,2021,1654, 844,1090, 105, 550, 966,1758,2828,1008,1783, 686, #  848
1095,5075,2287, 793,1602,5076,3573,2603,4536,4223,2948,2302,4537,3825, 980,2503, #  864
 544, 353, 527,4538, 908,2687,2913,5077, 381,2629,1943,1348,5078,1341,1252, 560, #  880
3095,5079,3467,2870,5080,2054, 973, 886,2081, 143,4539,5081,5082, 157,3989, 496, #  896
4224,  57, 840, 540,2039,4540,4541,3468,2118,1445, 970,2264,1748,1966,2082,4225, #  912
3144,1234,1776,3284,2829,3695, 773,1206,2130,1066,2040,1326,3990,1738,1725,4226, #  928
 279,3145,  51,1544,2604, 423,1578,2131,2067, 173,4542,1880,5083,5084,1583, 264, #  944
 610,3696,4543,2444, 280, 154,5085,5086,5087,1739, 338,1282,3096, 693,2871,1411, #  960
1074,3826,2445,5088,4544,5089,5090,1240, 952,2399,5091,2914,1538,2688, 685,1483, #  976
4227,2475,1436, 953,4228,2055,4545, 671,2400,  79,4229,2446,3285, 608, 567,2689, #  992
3469,4230,4231,1691, 393,1261,1792,2401,5092,4546,5093,5094,5095,5096,1383,1672, # 1008
3827,3213,1464, 522,1119, 661,1150, 216, 675,4547,3991,1432,3574, 609,4548,2690, # 1024
2402,5097,5098,5099,4232,3045,   0,5100,2476, 315, 231,2447, 301,3356,4549,2385, # 1040
5101, 233,4233,3697,1819,4550,4551,5102,  96,1777,1315,2083,5103, 257,5104,1810, # 1056
3698,2718,1139,1820,4234,2022,1124,2164,2791,1778,2659,5105,3097, 363,1655,3214, # 1072
5106,2993,5107,5108,5109,3992,1567,3993, 718, 103,3215, 849,1443, 341,3357,2949, # 1088
1484,5110,1712, 127,  67, 339,4235,2403, 679,1412, 821,5111,5112, 834, 738, 351, # 1104
2994,2147, 846, 235,1497,1881, 418,1993,3828,2719, 186,1100,2148,2756,3575,1545, # 1120
1355,2950,2872,1377, 583,3994,4236,2581,2995,5113,1298,3699,1078,2557,3700,2363, # 1136
  78,3829,3830, 267,1289,2100,2002,1594,4237, 348, 369,1274,2197,2178,1838,4552, # 1152
1821,2830,3701,2757,2288,2003,4553,2951,2758, 144,3358, 882,4554,3995,2759,3470, # 1168
4555,2915,5114,4238,1726, 320,5115,3996,3046, 788,2996,5116,2831,1774,1327,2873, # 1184
3997,2832,5117,1306,4556,2004,1700,3831,3576,2364,2660, 787,2023, 506, 824,3702, # 1200
 534, 323,4557,1044,3359,2024,1901, 946,3471,5118,1779,1500,1678,5119,1882,4558, # 1216
 165, 243,4559,3703,2528, 123, 683,4239, 764,4560,  36,3998,1793, 589,2916, 816, # 1232
 626,1667,3047,2237,1639,1555,1622,3832,3999,5120,4000,2874,1370,1228,1933, 891, # 1248
2084,2917, 304,4240,5121, 292,2997,2720,3577, 691,2101,4241,1115,4561, 118, 662, # 1264
5122, 611,1156, 854,2386,1316,2875,   2, 386, 515,2918,5123,5124,3286, 868,2238, # 1280
1486, 855,2661, 785,2216,3048,5125,1040,3216,3578,5126,3146, 448,5127,1525,5128, # 1296
2165,4562,5129,3833,5130,4242,2833,3579,3147, 503, 818,4001,3148,1568, 814, 676, # 1312
1444, 306,1749,5131,3834,1416,1030, 197,1428, 805,2834,1501,4563,5132,5133,5134, # 1328
1994,5135,4564,5136,5137,2198,  13,2792,3704,2998,3149,1229,1917,5138,3835,2132, # 1344
5139,4243,4565,2404,3580,5140,2217,1511,1727,1120,5141,5142, 646,3836,2448, 307, # 1360
5143,5144,1595,3217,5145,5146,5147,3705,1113,1356,4002,1465,2529,2530,5148, 519, # 1376
5149, 128,2133,  92,2289,1980,5150,4003,1512, 342,3150,2199,5151,2793,2218,1981, # 1392
3360,4244, 290,1656,1317, 789, 827,2365,5152,3837,4566, 562, 581,4004,5153, 401, # 1408
4567,2252,  94,4568,5154,1399,2794,5155,1463,2025,4569,3218,1944,5156, 828,1105, # 1424
4245,1262,1394,5157,4246, 605,4570,5158,1784,2876,5159,2835, 819,2102, 578,2200, # 1440
2952,5160,1502, 436,3287,4247,3288,2836,4005,2919,3472,3473,5161,2721,2320,5162, # 1456
5163,2337,2068,  23,4571, 193, 826,3838,2103, 699,1630,4248,3098, 390,1794,1064, # 1472
3581,5164,1579,3099,3100,1400,5165,4249,1839,1640,2877,5166,4572,4573, 137,4250, # 1488
 598,3101,1967, 780, 104, 974,2953,5167, 278, 899, 253, 402, 572, 504, 493,1339, # 1504
5168,4006,1275,4574,2582,2558,5169,3706,3049,3102,2253, 565,1334,2722, 863,  41, # 1520
5170,5171,4575,5172,1657,2338,  19, 463,2760,4251, 606,5173,2999,3289,1087,2085, # 1536
1323,2662,3000,5174,1631,1623,1750,4252,2691,5175,2878, 791,2723,2663,2339, 232, # 1552
2421,5176,3001,1498,5177,2664,2630, 755,1366,3707,3290,3151,2026,1609, 119,1918, # 1568
3474, 862,1026,4253,5178,4007,3839,4576,4008,4577,2265,1952,2477,5179,1125, 817, # 1584
4254,4255,4009,1513,1766,2041,1487,4256,3050,3291,2837,3840,3152,5180,5181,1507, # 1600
5182,2692, 733,  40,1632,1106,2879, 345,4257, 841,2531, 230,4578,3002,1847,3292, # 1616
3475,5183,1263, 986,3476,5184, 735, 879, 254,1137, 857, 622,1300,1180,1388,1562, # 1632
4010,4011,2954, 967,2761,2665,1349, 592,2134,1692,3361,3003,1995,4258,1679,4012, # 1648
1902,2188,5185, 739,3708,2724,1296,1290,5186,4259,2201,2202,1922,1563,2605,2559, # 1664
1871,2762,3004,5187, 435,5188, 343,1108, 596,  17,1751,4579,2239,3477,3709,5189, # 1680
4580, 294,3582,2955,1693, 477, 979, 281,2042,3583, 643,2043,3710,2631,2795,2266, # 1696
1031,2340,2135,2303,3584,4581, 367,1249,2560,5190,3585,5191,4582,1283,3362,2005, # 1712
 240,1762,3363,4583,4584, 836,1069,3153, 474,5192,2149,2532, 268,3586,5193,3219, # 1728
1521,1284,5194,1658,1546,4260,5195,3587,3588,5196,4261,3364,2693,1685,4262, 961, # 1744
1673,2632, 190,2006,2203,3841,4585,4586,5197, 570,2504,3711,1490,5198,4587,2633, # 1760
3293,1957,4588, 584,1514, 396,1045,1945,5199,4589,1968,2449,5200,5201,4590,4013, # 1776
 619,5202,3154,3294, 215,2007,2796,2561,3220,4591,3221,4592, 763,4263,3842,4593, # 1792
5203,5204,1958,1767,2956,3365,3712,1174, 452,1477,4594,3366,3155,5205,2838,1253, # 1808
2387,2189,1091,2290,4264, 492,5206, 638,1169,1825,2136,1752,4014, 648, 926,1021, # 1824
1324,4595, 520,4596, 997, 847,1007, 892,4597,3843,2267,1872,3713,2405,1785,4598, # 1840
1953,2957,3103,3222,1728,4265,2044,3714,4599,2008,1701,3156,1551,  30,2268,4266, # 1856
5207,2027,4600,3589,5208, 501,5209,4267, 594,3478,2166,1822,3590,3479,3591,3223, # 1872
 829,2839,4268,5210,1680,3157,1225,4269,5211,3295,4601,4270,3158,2341,5212,4602, # 1888
4271,5213,4015,4016,5214,1848,2388,2606,3367,5215,4603, 374,4017, 652,4272,4273, # 1904
 375,1140, 798,5216,5217,5218,2366,4604,2269, 546,1659, 138,3051,2450,4605,5219, # 1920
2254, 612,1849, 910, 796,3844,1740,1371, 825,3845,3846,5220,2920,2562,5221, 692, # 1936
 444,3052,2634, 801,4606,4274,5222,1491, 244,1053,3053,4275,4276, 340,5223,4018, # 1952
1041,3005, 293,1168,  87,1357,5224,1539, 959,5225,2240, 721, 694,4277,3847, 219, # 1968
1478, 644,1417,3368,2666,1413,1401,1335,1389,4019,5226,5227,3006,2367,3159,1826, # 1984
 730,1515, 184,2840,  66,4607,5228,1660,2958, 246,3369, 378,1457, 226,3480, 975, # 2000
4020,2959,1264,3592, 674, 696,5229, 163,5230,1141,2422,2167, 713,3593,3370,4608, # 2016
4021,5231,5232,1186,  15,5233,1079,1070,5234,1522,3224,3594, 276,1050,2725, 758, # 2032
1126, 653,2960,3296,5235,2342, 889,3595,4022,3104,3007, 903,1250,4609,4023,3481, # 2048
3596,1342,1681,1718, 766,3297, 286,  89,2961,3715,5236,1713,5237,2607,3371,3008, # 2064
5238,2962,2219,3225,2880,5239,4610,2505,2533, 181, 387,1075,4024, 731,2190,3372, # 2080
5240,3298, 310, 313,3482,2304, 770,4278,  54,3054, 189,4611,3105,3848,4025,5241, # 2096
1230,1617,1850, 355,3597,4279,4612,3373, 111,4280,3716,1350,3160,3483,3055,4281, # 2112
2150,3299,3598,5242,2797,4026,4027,3009, 722,2009,5243,1071, 247,1207,2343,2478, # 2128
1378,4613,2010, 864,1437,1214,4614, 373,3849,1142,2220, 667,4615, 442,2763,2563, # 2144
3850,4028,1969,4282,3300,1840, 837, 170,1107, 934,1336,1883,5244,5245,2119,4283, # 2160
2841, 743,1569,5246,4616,4284, 582,2389,1418,3484,5247,1803,5248, 357,1395,1729, # 2176
3717,3301,2423,1564,2241,5249,3106,3851,1633,4617,1114,2086,4285,1532,5250, 482, # 2192
2451,4618,5251,5252,1492, 833,1466,5253,2726,3599,1641,2842,5254,1526,1272,3718, # 2208
4286,1686,1795, 416,2564,1903,1954,1804,5255,3852,2798,3853,1159,2321,5256,2881, # 2224
4619,1610,1584,3056,2424,2764, 443,3302,1163,3161,5257,5258,4029,5259,4287,2506, # 2240
3057,4620,4030,3162,2104,1647,3600,2011,1873,4288,5260,4289, 431,3485,5261, 250, # 2256
  97,  81,4290,5262,1648,1851,1558, 160, 848,5263, 866, 740,1694,5264,2204,2843, # 2272
3226,4291,4621,3719,1687, 950,2479, 426, 469,3227,3720,3721,4031,5265,5266,1188, # 2288
 424,1996, 861,3601,4292,3854,2205,2694, 168,1235,3602,4293,5267,2087,1674,4622, # 2304
3374,3303, 220,2565,1009,5268,3855, 670,3010, 332,1208, 717,5269,5270,3603,2452, # 2320
4032,3375,5271, 513,5272,1209,2882,3376,3163,4623,1080,5273,5274,5275,5276,2534, # 2336
3722,3604, 815,1587,4033,4034,5277,3605,3486,3856,1254,4624,1328,3058,1390,4035, # 2352
1741,4036,3857,4037,5278, 236,3858,2453,3304,5279,5280,3723,3859,1273,3860,4625, # 2368
5281, 308,5282,4626, 245,4627,1852,2480,1307,2583, 430, 715,2137,2454,5283, 270, # 2384
 199,2883,4038,5284,3606,2727,1753, 761,1754, 725,1661,1841,4628,3487,3724,5285, # 2400
5286, 587,  14,3305, 227,2608, 326, 480,2270, 943,2765,3607, 291, 650,1884,5287, # 2416
1702,1226, 102,1547,  62,3488, 904,4629,3489,1164,4294,5288,5289,1224,1548,2766, # 2432
 391, 498,1493,5290,1386,1419,5291,2056,1177,4630, 813, 880,1081,2368, 566,1145, # 2448
4631,2291,1001,1035,2566,2609,2242, 394,1286,5292,5293,2069,5294,  86,1494,1730, # 2464
4039, 491,1588, 745, 897,2963, 843,3377,4040,2767,2884,3306,1768, 998,2221,2070, # 2480
 397,1827,1195,1970,3725,3011,3378, 284,5295,3861,2507,2138,2120,1904,5296,4041, # 2496
2151,4042,4295,1036,3490,1905, 114,2567,4296, 209,1527,5297,5298,2964,2844,2635, # 2512
2390,2728,3164, 812,2568,5299,3307,5300,1559, 737,1885,3726,1210, 885,  28,2695, # 2528
3608,3862,5301,4297,1004,1780,4632,5302, 346,1982,2222,2696,4633,3863,1742, 797, # 2544
1642,4043,1934,1072,1384,2152, 896,4044,3308,3727,3228,2885,3609,5303,2569,1959, # 2560
4634,2455,1786,5304,5305,5306,4045,4298,1005,1308,3728,4299,2729,4635,4636,1528, # 2576
2610, 161,1178,4300,1983, 987,4637,1101,4301, 631,4046,1157,3229,2425,1343,1241, # 2592
1016,2243,2570, 372, 877,2344,2508,1160, 555,1935, 911,4047,5307, 466,1170, 169, # 2608
1051,2921,2697,3729,2481,3012,1182,2012,2571,1251,2636,5308, 992,2345,3491,1540, # 2624
2730,1201,2071,2406,1997,2482,5309,4638, 528,1923,2191,1503,1874,1570,2369,3379, # 2640
3309,5310, 557,1073,5311,1828,3492,2088,2271,3165,3059,3107, 767,3108,2799,4639, # 2656
1006,4302,4640,2346,1267,2179,3730,3230, 778,4048,3231,2731,1597,2667,5312,4641, # 2672
5313,3493,5314,5315,5316,3310,2698,1433,3311, 131,  95,1504,4049, 723,4303,3166, # 2688
1842,3610,2768,2192,4050,2028,2105,3731,5317,3013,4051,1218,5318,3380,3232,4052, # 2704
4304,2584, 248,1634,3864, 912,5319,2845,3732,3060,3865, 654,  53,5320,3014,5321, # 2720
1688,4642, 777,3494,1032,4053,1425,5322, 191, 820,2121,2846, 971,4643, 931,3233, # 2736
 135, 664, 783,3866,1998, 772,2922,1936,4054,3867,4644,2923,3234, 282,2732, 640, # 2752
1372,3495,1127, 922, 325,3381,5323,5324, 711,2045,5325,5326,4055,2223,2800,1937, # 2768
4056,3382,2224,2255,3868,2305,5327,4645,3869,1258,3312,4057,3235,2139,2965,4058, # 2784
4059,5328,2225, 258,3236,4646, 101,1227,5329,3313,1755,5330,1391,3314,5331,2924, # 2800
2057, 893,5332,5333,5334,1402,4305,2347,5335,5336,3237,3611,5337,5338, 878,1325, # 2816
1781,2801,4647, 259,1385,2585, 744,1183,2272,4648,5339,4060,2509,5340, 684,1024, # 2832
4306,5341, 472,3612,3496,1165,3315,4061,4062, 322,2153, 881, 455,1695,1152,1340, # 2848
 660, 554,2154,4649,1058,4650,4307, 830,1065,3383,4063,4651,1924,5342,1703,1919, # 2864
5343, 932,2273, 122,5344,4652, 947, 677,5345,3870,2637, 297,1906,1925,2274,4653, # 2880
2322,3316,5346,5347,4308,5348,4309,  84,4310, 112, 989,5349, 547,1059,4064, 701, # 2896
3613,1019,5350,4311,5351,3497, 942, 639, 457,2306,2456, 993,2966, 407, 851, 494, # 2912
4654,3384, 927,5352,1237,5353,2426,3385, 573,4312, 680, 921,2925,1279,1875, 285, # 2928
 790,1448,1984, 719,2168,5354,5355,4655,4065,4066,1649,5356,1541, 563,5357,1077, # 2944
5358,3386,3061,3498, 511,3015,4067,4068,3733,4069,1268,2572,3387,3238,4656,4657, # 2960
5359, 535,1048,1276,1189,2926,2029,3167,1438,1373,2847,2967,1134,2013,5360,4313, # 2976
1238,2586,3109,1259,5361, 700,5362,2968,3168,3734,4314,5363,4315,1146,1876,1907, # 2992
4658,2611,4070, 781,2427, 132,1589, 203, 147, 273,2802,2407, 898,1787,2155,4071, # 3008
4072,5364,3871,2803,5365,5366,4659,4660,5367,3239,5368,1635,3872, 965,5369,1805, # 3024
2699,1516,3614,1121,1082,1329,3317,4073,1449,3873,  65,1128,2848,2927,2769,1590, # 3040
3874,5370,5371,  12,2668,  45, 976,2587,3169,4661, 517,2535,1013,1037,3240,5372, # 3056
3875,2849,5373,3876,5374,3499,5375,2612, 614,1999,2323,3877,3110,2733,2638,5376, # 3072
2588,4316, 599,1269,5377,1811,3735,5378,2700,3111, 759,1060, 489,1806,3388,3318, # 3088
1358,5379,5380,2391,1387,1215,2639,2256, 490,5381,5382,4317,1759,2392,2348,5383, # 3104
4662,3878,1908,4074,2640,1807,3241,4663,3500,3319,2770,2349, 874,5384,5385,3501, # 3120
3736,1859,  91,2928,3737,3062,3879,4664,5386,3170,4075,2669,5387,3502,1202,1403, # 3136
3880,2969,2536,1517,2510,4665,3503,2511,5388,4666,5389,2701,1886,1495,1731,4076, # 3152
2370,4667,5390,2030,5391,5392,4077,2702,1216, 237,2589,4318,2324,4078,3881,4668, # 3168
4669,2703,3615,3504, 445,4670,5393,5394,5395,5396,2771,  61,4079,3738,1823,4080, # 3184
5397, 687,2046, 935, 925, 405,2670, 703,1096,1860,2734,4671,4081,1877,1367,2704, # 3200
3389, 918,2106,1782,2483, 334,3320,1611,1093,4672, 564,3171,3505,3739,3390, 945, # 3216
2641,2058,4673,5398,1926, 872,4319,5399,3506,2705,3112, 349,4320,3740,4082,4674, # 3232
3882,4321,3741,2156,4083,4675,4676,4322,4677,2408,2047, 782,4084, 400, 251,4323, # 3248
1624,5400,5401, 277,3742, 299,1265, 476,1191,3883,2122,4324,4325,1109, 205,5402, # 3264
2590,1000,2157,3616,1861,5403,5404,5405,4678,5406,4679,2573, 107,2484,2158,4085, # 3280
3507,3172,5407,1533, 541,1301, 158, 753,4326,2886,3617,5408,1696, 370,1088,4327, # 3296
4680,3618, 579, 327, 440, 162,2244, 269,1938,1374,3508, 968,3063,  56,1396,3113, # 3312
2107,3321,3391,5409,1927,2159,4681,3016,5410,3619,5411,5412,3743,4682,2485,5413, # 3328
2804,5414,1650,4683,5415,2613,5416,5417,4086,2671,3392,1149,3393,4087,3884,4088, # 3344
5418,1076,  49,5419, 951,3242,3322,3323, 450,2850, 920,5420,1812,2805,2371,4328, # 3360
1909,1138,2372,3885,3509,5421,3243,4684,1910,1147,1518,2428,4685,3886,5422,4686, # 3376
2393,2614, 260,1796,3244,5423,5424,3887,3324, 708,5425,3620,1704,5426,3621,1351, # 3392
1618,3394,3017,1887, 944,4329,3395,4330,3064,3396,4331,5427,3744, 422, 413,1714, # 3408
3325, 500,2059,2350,4332,2486,5428,1344,1911, 954,5429,1668,5430,5431,4089,2409, # 3424
4333,3622,3888,4334,5432,2307,1318,2512,3114, 133,3115,2887,4687, 629,  31,2851, # 3440
2706,3889,4688, 850, 949,4689,4090,2970,1732,2089,4335,1496,1853,5433,4091, 620, # 3456
3245, 981,1242,3745,3397,1619,3746,1643,3326,2140,2457,1971,1719,3510,2169,5434, # 3472
3246,5435,5436,3398,1829,5437,1277,4690,1565,2048,5438,1636,3623,3116,5439, 869, # 3488
2852, 655,3890,3891,3117,4092,3018,3892,1310,3624,4691,5440,5441,5442,1733, 558, # 3504
4692,3747, 335,1549,3065,1756,4336,3748,1946,3511,1830,1291,1192, 470,2735,2108, # 3520
2806, 913,1054,4093,5443,1027,5444,3066,4094,4693, 982,2672,3399,3173,3512,3247, # 3536
3248,1947,2807,5445, 571,4694,5446,1831,5447,3625,2591,1523,2429,5448,2090, 984, # 3552
4695,3749,1960,5449,3750, 852, 923,2808,3513,3751, 969,1519, 999,2049,2325,1705, # 3568
5450,3118, 615,1662, 151, 597,4095,2410,2326,1049, 275,4696,3752,4337, 568,3753, # 3584
3626,2487,4338,3754,5451,2430,2275, 409,3249,5452,1566,2888,3514,1002, 769,2853, # 3600
 194,2091,3174,3755,2226,3327,4339, 628,1505,5453,5454,1763,2180,3019,4096, 521, # 3616
1161,2592,1788,2206,2411,4697,4097,1625,4340,4341, 412,  42,3119, 464,5455,2642, # 3632
4698,3400,1760,1571,2889,3515,2537,1219,2207,3893,2643,2141,2373,4699,4700,3328, # 3648
1651,3401,3627,5456,5457,3628,2488,3516,5458,3756,5459,5460,2276,2092, 460,5461, # 3664
4701,5462,3020, 962, 588,3629, 289,3250,2644,1116,  52,5463,3067,1797,5464,5465, # 3680
5466,1467,5467,1598,1143,3757,4342,1985,1734,1067,4702,1280,3402, 465,4703,1572, # 3696
 510,5468,1928,2245,1813,1644,3630,5469,4704,3758,5470,5471,2673,1573,1534,5472, # 3712
5473, 536,1808,1761,3517,3894,3175,2645,5474,5475,5476,4705,3518,2929,1912,2809, # 3728
5477,3329,1122, 377,3251,5478, 360,5479,5480,4343,1529, 551,5481,2060,3759,1769, # 3744
2431,5482,2930,4344,3330,3120,2327,2109,2031,4706,1404, 136,1468,1479, 672,1171, # 3760
3252,2308, 271,3176,5483,2772,5484,2050, 678,2736, 865,1948,4707,5485,2014,4098, # 3776
2971,5486,2737,2227,1397,3068,3760,4708,4709,1735,2931,3403,3631,5487,3895, 509, # 3792
2854,2458,2890,3896,5488,5489,3177,3178,4710,4345,2538,4711,2309,1166,1010, 552, # 3808
 681,1888,5490,5491,2972,2973,4099,1287,1596,1862,3179, 358, 453, 736, 175, 478, # 3824
1117, 905,1167,1097,5492,1854,1530,5493,1706,5494,2181,3519,2292,3761,3520,3632, # 3840
4346,2093,4347,5495,3404,1193,2489,4348,1458,2193,2208,1863,1889,1421,3331,2932, # 3856
3069,2182,3521, 595,2123,5496,4100,5497,5498,4349,1707,2646, 223,3762,1359, 751, # 3872
3121, 183,3522,5499,2810,3021, 419,2374, 633, 704,3897,2394, 241,5500,5501,5502, # 3888
 838,3022,3763,2277,2773,2459,3898,1939,2051,4101,1309,3122,2246,1181,5503,1136, # 3904
2209,3899,2375,1446,4350,2310,4712,5504,5505,4351,1055,2615, 484,3764,5506,4102, # 3920
 625,4352,2278,3405,1499,4353,4103,5507,4104,4354,3253,2279,2280,3523,5508,5509, # 3936
2774, 808,2616,3765,3406,4105,4355,3123,2539, 526,3407,3900,4356, 955,5510,1620, # 3952
4357,2647,2432,5511,1429,3766,1669,1832, 994, 928,5512,3633,1260,5513,5514,5515, # 3968
1949,2293, 741,2933,1626,4358,2738,2460, 867,1184, 362,3408,1392,5516,5517,4106, # 3984
4359,1770,1736,3254,2934,4713,4714,1929,2707,1459,1158,5518,3070,3409,2891,1292, # 4000
1930,2513,2855,3767,1986,1187,2072,2015,2617,4360,5519,2574,2514,2170,3768,2490, # 4016
3332,5520,3769,4715,5521,5522, 666,1003,3023,1022,3634,4361,5523,4716,1814,2257, # 4032
 574,3901,1603, 295,1535, 705,3902,4362, 283, 858, 417,5524,5525,3255,4717,4718, # 4048
3071,1220,1890,1046,2281,2461,4107,1393,1599, 689,2575, 388,4363,5526,2491, 802, # 4064
5527,2811,3903,2061,1405,2258,5528,4719,3904,2110,1052,1345,3256,1585,5529, 809, # 4080
5530,5531,5532, 575,2739,3524, 956,1552,1469,1144,2328,5533,2329,1560,2462,3635, # 4096
3257,4108, 616,2210,4364,3180,2183,2294,5534,1833,5535,3525,4720,5536,1319,3770, # 4112
3771,1211,3636,1023,3258,1293,2812,5537,5538,5539,3905, 607,2311,3906, 762,2892, # 4128
1439,4365,1360,4721,1485,3072,5540,4722,1038,4366,1450,2062,2648,4367,1379,4723, # 4144
2593,5541,5542,4368,1352,1414,2330,2935,1172,5543,5544,3907,3908,4724,1798,1451, # 4160
5545,5546,5547,5548,2936,4109,4110,2492,2351, 411,4111,4112,3637,3333,3124,4725, # 4176
1561,2674,1452,4113,1375,5549,5550,  47,2974, 316,5551,1406,1591,2937,3181,5552, # 4192
1025,2142,3125,3182, 354,2740, 884,2228,4369,2412, 508,3772, 726,3638, 996,2433, # 4208
3639, 729,5553, 392,2194,1453,4114,4726,3773,5554,5555,2463,3640,2618,1675,2813, # 4224
 919,2352,2975,2353,1270,4727,4115,  73,5556,5557, 647,5558,3259,2856,2259,1550, # 4240
1346,3024,5559,1332, 883,3526,5560,5561,5562,5563,3334,2775,5564,1212, 831,1347, # 4256
4370,4728,2331,3909,1864,3073, 720,3910,4729,4730,3911,5565,4371,5566,5567,4731, # 4272
5568,5569,1799,4732,3774,2619,4733,3641,1645,2376,4734,5570,2938, 669,2211,2675, # 4288
2434,5571,2893,5572,5573,1028,3260,5574,4372,2413,5575,2260,1353,5576,5577,4735, # 4304
3183, 518,5578,4116,5579,4373,1961,5580,2143,4374,5581,5582,3025,2354,2355,3912, # 4320
 516,1834,1454,4117,2708,4375,4736,2229,2620,1972,1129,3642,5583,2776,5584,2976, # 4336
1422, 577,1470,3026,1524,3410,5585,5586, 432,4376,3074,3527,5587,2594,1455,2515, # 4352
2230,1973,1175,5588,1020,2741,4118,3528,4737,5589,2742,5590,1743,1361,3075,3529, # 4368
2649,4119,4377,4738,2295, 895, 924,4378,2171, 331,2247,3076, 166,1627,3077,1098, # 4384
5591,1232,2894,2231,3411,4739, 657, 403,1196,2377, 542,3775,3412,1600,4379,3530, # 4400
5592,4740,2777,3261, 576, 530,1362,4741,4742,2540,2676,3776,4120,5593, 842,3913, # 4416
5594,2814,2032,1014,4121, 213,2709,3413, 665, 621,4380,5595,3777,2939,2435,5596, # 4432
2436,3335,3643,3414,4743,4381,2541,4382,4744,3644,1682,4383,3531,1380,5597, 724, # 4448
2282, 600,1670,5598,1337,1233,4745,3126,2248,5599,1621,4746,5600, 651,4384,5601, # 4464
1612,4385,2621,5602,2857,5603,2743,2312,3078,5604, 716,2464,3079, 174,1255,2710, # 4480
4122,3645, 548,1320,1398, 728,4123,1574,5605,1891,1197,3080,4124,5606,3081,3082, # 4496
3778,3646,3779, 747,5607, 635,4386,4747,5608,5609,5610,4387,5611,5612,4748,5613, # 4512
3415,4749,2437, 451,5614,3780,2542,2073,4388,2744,4389,4125,5615,1764,4750,5616, # 4528
4390, 350,4751,2283,2395,2493,5617,4391,4126,2249,1434,4127, 488,4752, 458,4392, # 4544
4128,3781, 771,1330,2396,3914,2576,3184,2160,2414,1553,2677,3185,4393,5618,2494, # 4560
2895,2622,1720,2711,4394,3416,4753,5619,2543,4395,5620,3262,4396,2778,5621,2016, # 4576
2745,5622,1155,1017,3782,3915,5623,3336,2313, 201,1865,4397,1430,5624,4129,5625, # 4592
5626,5627,5628,5629,4398,1604,5630, 414,1866, 371,2595,4754,4755,3532,2017,3127, # 4608
4756,1708, 960,4399, 887, 389,2172,1536,1663,1721,5631,2232,4130,2356,2940,1580, # 4624
5632,5633,1744,4757,2544,4758,4759,5634,4760,5635,2074,5636,4761,3647,3417,2896, # 4640
4400,5637,4401,2650,3418,2815, 673,2712,2465, 709,3533,4131,3648,4402,5638,1148, # 4656
 502, 634,5639,5640,1204,4762,3649,1575,4763,2623,3783,5641,3784,3128, 948,3263, # 4672
 121,1745,3916,1110,5642,4403,3083,2516,3027,4132,3785,1151,1771,3917,1488,4133, # 4688
1987,5643,2438,3534,5644,5645,2094,5646,4404,3918,1213,1407,2816, 531,2746,2545, # 4704
3264,1011,1537,4764,2779,4405,3129,1061,5647,3786,3787,1867,2897,5648,2018, 120, # 4720
4406,4407,2063,3650,3265,2314,3919,2678,3419,1955,4765,4134,5649,3535,1047,2713, # 4736
1266,5650,1368,4766,2858, 649,3420,3920,2546,2747,1102,2859,2679,5651,5652,2000, # 4752
5653,1111,3651,2977,5654,2495,3921,3652,2817,1855,3421,3788,5655,5656,3422,2415, # 4768
2898,3337,3266,3653,5657,2577,5658,3654,2818,4135,1460, 856,5659,3655,5660,2899, # 4784
2978,5661,2900,3922,5662,4408, 632,2517, 875,3923,1697,3924,2296,5663,5664,4767, # 4800
3028,1239, 580,4768,4409,5665, 914, 936,2075,1190,4136,1039,2124,5666,5667,5668, # 4816
5669,3423,1473,5670,1354,4410,3925,4769,2173,3084,4137, 915,3338,4411,4412,3339, # 4832
1605,1835,5671,2748, 398,3656,4413,3926,4138, 328,1913,2860,4139,3927,1331,4414, # 4848
3029, 937,4415,5672,3657,4140,4141,3424,2161,4770,3425, 524, 742, 538,3085,1012, # 4864
5673,5674,3928,2466,5675, 658,1103, 225,3929,5676,5677,4771,5678,4772,5679,3267, # 4880
1243,5680,4142, 963,2250,4773,5681,2714,3658,3186,5682,5683,2596,2332,5684,4774, # 4896
5685,5686,5687,3536, 957,3426,2547,2033,1931,2941,2467, 870,2019,3659,1746,2780, # 4912
2781,2439,2468,5688,3930,5689,3789,3130,3790,3537,3427,3791,5690,1179,3086,5691, # 4928
3187,2378,4416,3792,2548,3188,3131,2749,4143,5692,3428,1556,2549,2297, 977,2901, # 4944
2034,4144,1205,3429,5693,1765,3430,3189,2125,1271, 714,1689,4775,3538,5694,2333, # 4960
3931, 533,4417,3660,2184, 617,5695,2469,3340,3539,2315,5696,5697,3190,5698,5699, # 4976
3932,1988, 618, 427,2651,3540,3431,5700,5701,1244,1690,5702,2819,4418,4776,5703, # 4992
3541,4777,5704,2284,1576, 473,3661,4419,3432, 972,5705,3662,5706,3087,5707,5708, # 5008
4778,4779,5709,3793,4145,4146,5710, 153,4780, 356,5711,1892,2902,4420,2144, 408, # 5024
 803,2357,5712,3933,5713,4421,1646,2578,2518,4781,4782,3934,5714,3935,4422,5715, # 5040
2416,3433, 752,5716,5717,1962,3341,2979,5718, 746,3030,2470,4783,4423,3794, 698, # 5056
4784,1893,4424,3663,2550,4785,3664,3936,5719,3191,3434,5720,1824,1302,4147,2715, # 5072
3937,1974,4425,5721,4426,3192, 823,1303,1288,1236,2861,3542,4148,3435, 774,3938, # 5088
5722,1581,4786,1304,2862,3939,4787,5723,2440,2162,1083,3268,4427,4149,4428, 344, # 5104
1173, 288,2316, 454,1683,5724,5725,1461,4788,4150,2597,5726,5727,4789, 985, 894, # 5120
5728,3436,3193,5729,1914,2942,3795,1989,5730,2111,1975,5731,4151,5732,2579,1194, # 5136
 425,5733,4790,3194,1245,3796,4429,5734,5735,2863,5736, 636,4791,1856,3940, 760, # 5152
1800,5737,4430,2212,1508,4792,4152,1894,1684,2298,5738,5739,4793,4431,4432,2213, # 5168
 479,5740,5741, 832,5742,4153,2496,5743,2980,2497,3797, 990,3132, 627,1815,2652, # 5184
4433,1582,4434,2126,2112,3543,4794,5744, 799,4435,3195,5745,4795,2113,1737,3031, # 5200
1018, 543, 754,4436,3342,1676,4796,4797,4154,4798,1489,5746,3544,5747,2624,2903, # 5216
4155,5748,5749,2981,5750,5751,5752,5753,3196,4799,4800,2185,1722,5754,3269,3270, # 5232
1843,3665,1715, 481, 365,1976,1857,5755,5756,1963,2498,4801,5757,2127,3666,3271, # 5248
 433,1895,2064,2076,5758, 602,2750,5759,5760,5761,5762,5763,3032,1628,3437,5764, # 5264
3197,4802,4156,2904,4803,2519,5765,2551,2782,5766,5767,5768,3343,4804,2905,5769, # 5280
4805,5770,2864,4806,4807,1221,2982,4157,2520,5771,5772,5773,1868,1990,5774,5775, # 5296
5776,1896,5777,5778,4808,1897,4158, 318,5779,2095,4159,4437,5780,5781, 485,5782, # 5312
 938,3941, 553,2680, 116,5783,3942,3667,5784,3545,2681,2783,3438,3344,2820,5785, # 5328
3668,2943,4160,1747,2944,2983,5786,5787, 207,5788,4809,5789,4810,2521,5790,3033, # 5344
 890,3669,3943,5791,1878,3798,3439,5792,2186,2358,3440,1652,5793,5794,5795, 941, # 5360
2299, 208,3546,4161,2020, 330,4438,3944,2906,2499,3799,4439,4811,5796,5797,5798, # 5376
)

site-packages/pip/_vendor/chardet/sjisprober.py000064400000007276151446177000015677 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .mbcharsetprober import MultiByteCharSetProber
from .codingstatemachine import CodingStateMachine
from .chardistribution import SJISDistributionAnalysis
from .jpcntx import SJISContextAnalysis
from .mbcssm import SJIS_SM_MODEL
from .enums import ProbingState, MachineState


class SJISProber(MultiByteCharSetProber):
    def __init__(self):
        super(SJISProber, self).__init__()
        self.coding_sm = CodingStateMachine(SJIS_SM_MODEL)
        self.distribution_analyzer = SJISDistributionAnalysis()
        self.context_analyzer = SJISContextAnalysis()
        self.reset()

    def reset(self):
        super(SJISProber, self).reset()
        self.context_analyzer.reset()

    @property
    def charset_name(self):
        return self.context_analyzer.charset_name

    @property
    def language(self):
        return "Japanese"

    def feed(self, byte_str):
        for i in range(len(byte_str)):
            coding_state = self.coding_sm.next_state(byte_str[i])
            if coding_state == MachineState.ERROR:
                self.logger.debug('%s %s prober hit error at byte %s',
                                  self.charset_name, self.language, i)
                self._state = ProbingState.NOT_ME
                break
            elif coding_state == MachineState.ITS_ME:
                self._state = ProbingState.FOUND_IT
                break
            elif coding_state == MachineState.START:
                char_len = self.coding_sm.get_current_charlen()
                if i == 0:
                    self._last_char[1] = byte_str[0]
                    self.context_analyzer.feed(self._last_char[2 - char_len:],
                                               char_len)
                    self.distribution_analyzer.feed(self._last_char, char_len)
                else:
                    self.context_analyzer.feed(byte_str[i + 1 - char_len:i + 3
                                                        - char_len], char_len)
                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
                                                    char_len)

        self._last_char[0] = byte_str[-1]

        if self.state == ProbingState.DETECTING:
            if (self.context_analyzer.got_enough_data() and
               (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
                self._state = ProbingState.FOUND_IT

        return self.state

    def get_confidence(self):
        context_conf = self.context_analyzer.get_confidence()
        distrib_conf = self.distribution_analyzer.get_confidence()
        return max(context_conf, distrib_conf)
site-packages/pip/_vendor/chardet/cp949prober.py000064400000003477151446177000015576 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .chardistribution import EUCKRDistributionAnalysis
from .codingstatemachine import CodingStateMachine
from .mbcharsetprober import MultiByteCharSetProber
from .mbcssm import CP949_SM_MODEL


class CP949Prober(MultiByteCharSetProber):
    def __init__(self):
        super(CP949Prober, self).__init__()
        self.coding_sm = CodingStateMachine(CP949_SM_MODEL)
        # NOTE: CP949 is a superset of EUC-KR, so the distribution should be
        #       not different.
        self.distribution_analyzer = EUCKRDistributionAnalysis()
        self.reset()

    @property
    def charset_name(self):
        return "CP949"

    @property
    def language(self):
        return "Korean"
site-packages/pip/_vendor/chardet/eucjpprober.py000064400000007245151446177000016031 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .enums import ProbingState, MachineState
from .mbcharsetprober import MultiByteCharSetProber
from .codingstatemachine import CodingStateMachine
from .chardistribution import EUCJPDistributionAnalysis
from .jpcntx import EUCJPContextAnalysis
from .mbcssm import EUCJP_SM_MODEL


class EUCJPProber(MultiByteCharSetProber):
    def __init__(self):
        super(EUCJPProber, self).__init__()
        self.coding_sm = CodingStateMachine(EUCJP_SM_MODEL)
        self.distribution_analyzer = EUCJPDistributionAnalysis()
        self.context_analyzer = EUCJPContextAnalysis()
        self.reset()

    def reset(self):
        super(EUCJPProber, self).reset()
        self.context_analyzer.reset()

    @property
    def charset_name(self):
        return "EUC-JP"

    @property
    def language(self):
        return "Japanese"

    def feed(self, byte_str):
        for i in range(len(byte_str)):
            # PY3K: byte_str is a byte array, so byte_str[i] is an int, not a byte
            coding_state = self.coding_sm.next_state(byte_str[i])
            if coding_state == MachineState.ERROR:
                self.logger.debug('%s %s prober hit error at byte %s',
                                  self.charset_name, self.language, i)
                self._state = ProbingState.NOT_ME
                break
            elif coding_state == MachineState.ITS_ME:
                self._state = ProbingState.FOUND_IT
                break
            elif coding_state == MachineState.START:
                char_len = self.coding_sm.get_current_charlen()
                if i == 0:
                    self._last_char[1] = byte_str[0]
                    self.context_analyzer.feed(self._last_char, char_len)
                    self.distribution_analyzer.feed(self._last_char, char_len)
                else:
                    self.context_analyzer.feed(byte_str[i - 1:i + 1],
                                                char_len)
                    self.distribution_analyzer.feed(byte_str[i - 1:i + 1],
                                                     char_len)

        self._last_char[0] = byte_str[-1]

        if self.state == ProbingState.DETECTING:
            if (self.context_analyzer.got_enough_data() and
               (self.get_confidence() > self.SHORTCUT_THRESHOLD)):
                self._state = ProbingState.FOUND_IT

        return self.state

    def get_confidence(self):
        context_conf = self.context_analyzer.get_confidence()
        distrib_conf = self.distribution_analyzer.get_confidence()
        return max(context_conf, distrib_conf)
site-packages/pip/_vendor/chardet/charsetgroupprober.py000064400000007313151446177000017425 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .enums import ProbingState
from .charsetprober import CharSetProber


class CharSetGroupProber(CharSetProber):
    def __init__(self, lang_filter=None):
        super(CharSetGroupProber, self).__init__(lang_filter=lang_filter)
        self._active_num = 0
        self.probers = []
        self._best_guess_prober = None

    def reset(self):
        super(CharSetGroupProber, self).reset()
        self._active_num = 0
        for prober in self.probers:
            if prober:
                prober.reset()
                prober.active = True
                self._active_num += 1
        self._best_guess_prober = None

    @property
    def charset_name(self):
        if not self._best_guess_prober:
            self.get_confidence()
            if not self._best_guess_prober:
                return None
        return self._best_guess_prober.charset_name

    @property
    def language(self):
        if not self._best_guess_prober:
            self.get_confidence()
            if not self._best_guess_prober:
                return None
        return self._best_guess_prober.language

    def feed(self, byte_str):
        for prober in self.probers:
            if not prober:
                continue
            if not prober.active:
                continue
            state = prober.feed(byte_str)
            if not state:
                continue
            if state == ProbingState.FOUND_IT:
                self._best_guess_prober = prober
                return self.state
            elif state == ProbingState.NOT_ME:
                prober.active = False
                self._active_num -= 1
                if self._active_num <= 0:
                    self._state = ProbingState.NOT_ME
                    return self.state
        return self.state

    def get_confidence(self):
        state = self.state
        if state == ProbingState.FOUND_IT:
            return 0.99
        elif state == ProbingState.NOT_ME:
            return 0.01
        best_conf = 0.0
        self._best_guess_prober = None
        for prober in self.probers:
            if not prober:
                continue
            if not prober.active:
                self.logger.debug('%s not active', prober.charset_name)
                continue
            conf = prober.get_confidence()
            self.logger.debug('%s %s confidence = %s', prober.charset_name, prober.language, conf)
            if best_conf < conf:
                best_conf = conf
                self._best_guess_prober = prober
        if not self._best_guess_prober:
            return 0.0
        return best_conf
site-packages/pip/_vendor/chardet/langhungarianmodel.py000064400000030460151446177000017343 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# 255: Control characters that usually does not exist in any text
# 254: Carriage/Return
# 253: symbol (punctuation) that does not belong to word
# 252: 0 - 9

# Character Mapping Table:
Latin2_HungarianCharToOrderMap = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253, 28, 40, 54, 45, 32, 50, 49, 38, 39, 53, 36, 41, 34, 35, 47,
 46, 71, 43, 33, 37, 57, 48, 64, 68, 55, 52,253,253,253,253,253,
253,  2, 18, 26, 17,  1, 27, 12, 20,  9, 22,  7,  6, 13,  4,  8,
 23, 67, 10,  5,  3, 21, 19, 65, 62, 16, 11,253,253,253,253,253,
159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,
175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,
191,192,193,194,195,196,197, 75,198,199,200,201,202,203,204,205,
 79,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,
221, 51, 81,222, 78,223,224,225,226, 44,227,228,229, 61,230,231,
232,233,234, 58,235, 66, 59,236,237,238, 60, 69, 63,239,240,241,
 82, 14, 74,242, 70, 80,243, 72,244, 15, 83, 77, 84, 30, 76, 85,
245,246,247, 25, 73, 42, 24,248,249,250, 31, 56, 29,251,252,253,
)

win1250HungarianCharToOrderMap = (
255,255,255,255,255,255,255,255,255,255,254,255,255,254,255,255,  # 00
255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,255,  # 10
253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,253,  # 20
252,252,252,252,252,252,252,252,252,252,253,253,253,253,253,253,  # 30
253, 28, 40, 54, 45, 32, 50, 49, 38, 39, 53, 36, 41, 34, 35, 47,
 46, 72, 43, 33, 37, 57, 48, 64, 68, 55, 52,253,253,253,253,253,
253,  2, 18, 26, 17,  1, 27, 12, 20,  9, 22,  7,  6, 13,  4,  8,
 23, 67, 10,  5,  3, 21, 19, 65, 62, 16, 11,253,253,253,253,253,
161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,
177,178,179,180, 78,181, 69,182,183,184,185,186,187,188,189,190,
191,192,193,194,195,196,197, 76,198,199,200,201,202,203,204,205,
 81,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,
221, 51, 83,222, 80,223,224,225,226, 44,227,228,229, 61,230,231,
232,233,234, 58,235, 66, 59,236,237,238, 60, 70, 63,239,240,241,
 84, 14, 75,242, 71, 82,243, 73,244, 15, 85, 79, 86, 30, 77, 87,
245,246,247, 25, 74, 42, 24,248,249,250, 31, 56, 29,251,252,253,
)

# Model Table:
# total sequences: 100%
# first 512 sequences: 94.7368%
# first 1024 sequences:5.2623%
# rest  sequences:     0.8894%
# negative sequences:  0.0009%
HungarianLangModel = (
0,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,1,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
3,3,3,3,3,3,3,3,3,3,2,3,3,3,3,3,3,3,3,2,2,3,3,1,1,2,2,2,2,2,1,2,
3,2,2,3,3,3,3,3,2,3,3,3,3,3,3,1,2,3,3,3,3,2,3,3,1,1,3,3,0,1,1,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,
3,2,1,3,3,3,3,3,2,3,3,3,3,3,1,1,2,3,3,3,3,3,3,3,1,1,3,2,0,1,1,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,1,1,2,3,3,3,1,3,3,3,3,3,1,3,3,2,2,0,3,2,3,
0,0,0,0,0,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,3,3,3,2,3,3,2,3,3,3,3,3,2,3,3,2,2,3,2,3,2,0,3,2,2,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,
3,3,3,3,3,3,2,3,3,3,3,3,2,3,3,3,1,2,3,2,2,3,1,2,3,3,2,2,0,3,3,3,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,3,2,3,3,3,3,2,3,3,3,3,0,2,3,2,
0,0,0,1,1,0,0,0,0,0,3,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,3,3,3,3,1,1,1,3,3,2,1,3,2,2,3,2,1,3,2,2,1,0,3,3,1,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,2,2,3,3,3,3,3,1,2,3,3,3,3,1,2,1,3,3,3,3,2,2,3,1,1,3,2,0,1,1,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,2,2,3,3,3,3,3,2,1,3,3,3,3,3,2,2,1,3,3,3,0,1,1,2,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,1,0,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,2,3,3,3,2,3,3,2,3,3,3,2,0,3,2,3,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,1,0,
3,3,3,3,3,3,2,3,3,3,2,3,2,3,3,3,1,3,2,2,2,3,1,1,3,3,1,1,0,3,3,2,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,3,3,3,3,2,3,3,3,2,3,2,3,3,3,2,3,3,3,3,3,1,2,3,2,2,0,2,2,2,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,2,2,2,3,1,3,3,2,2,1,3,3,3,1,1,3,1,2,3,2,3,2,2,2,1,0,2,2,2,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
3,1,1,3,3,3,3,3,1,2,3,3,3,3,1,2,1,3,3,3,2,2,3,2,1,0,3,2,0,1,1,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,1,3,3,3,3,3,1,2,3,3,3,3,1,1,0,3,3,3,3,0,2,3,0,0,2,1,0,1,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,3,3,3,3,2,2,3,3,2,2,2,2,3,3,0,1,2,3,2,3,2,2,3,2,1,2,0,2,2,2,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,
3,3,3,3,3,3,1,2,3,3,3,2,1,2,3,3,2,2,2,3,2,3,3,1,3,3,1,1,0,2,3,2,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,1,2,2,2,2,3,3,3,1,1,1,3,3,1,1,3,1,1,3,2,1,2,3,1,1,0,2,2,2,
0,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,2,1,2,1,1,3,3,1,1,1,1,3,3,1,1,2,2,1,2,1,1,2,2,1,1,0,2,2,1,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,1,1,2,1,1,3,3,1,0,1,1,3,3,2,0,1,1,2,3,1,0,2,2,1,0,0,1,3,2,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,2,1,3,3,3,3,3,1,2,3,2,3,3,2,1,1,3,2,3,2,1,2,2,0,1,2,1,0,0,1,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,
3,3,3,3,2,2,2,2,3,1,2,2,1,1,3,3,0,3,2,1,2,3,2,1,3,3,1,1,0,2,1,3,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,3,3,2,2,2,3,2,3,3,3,2,1,1,3,3,1,1,1,2,2,3,2,3,2,2,2,1,0,2,2,1,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
1,0,0,3,3,3,3,3,0,0,3,3,2,3,0,0,0,2,3,3,1,0,1,2,0,0,1,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,2,3,3,3,3,3,1,2,3,3,2,2,1,1,0,3,3,2,2,1,2,2,1,0,2,2,0,1,1,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,3,2,2,1,3,1,2,3,3,2,2,1,1,2,2,1,1,1,1,3,2,1,1,1,1,2,1,0,1,2,1,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,1,0,0,0,0,0,0,0,0,0,
2,3,3,1,1,1,1,1,3,3,3,0,1,1,3,3,1,1,1,1,1,2,2,0,3,1,1,2,0,2,1,1,
0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,0,0,0,0,0,0,
3,1,0,1,2,1,2,2,0,1,2,3,1,2,0,0,0,2,1,1,1,1,1,2,0,0,1,1,0,0,0,0,
1,2,1,2,2,2,1,2,1,2,0,2,0,2,2,1,1,2,1,1,2,1,1,1,0,1,0,0,0,1,1,0,
1,1,1,2,3,2,3,3,0,1,2,2,3,1,0,1,0,2,1,2,2,0,1,1,0,0,1,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,3,3,2,2,1,0,0,3,2,3,2,0,0,0,1,1,3,0,0,1,1,0,0,2,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,1,2,2,3,3,1,0,1,3,2,3,1,1,1,0,1,1,1,1,1,3,1,0,0,2,2,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
3,1,1,1,2,2,2,1,0,1,2,3,3,2,0,0,0,2,1,1,1,2,1,1,1,0,1,1,1,0,0,0,
1,2,2,2,2,2,1,1,1,2,0,2,1,1,1,1,1,2,1,1,1,1,1,1,0,1,1,1,0,0,1,1,
3,2,2,1,0,0,1,1,2,2,0,3,0,1,2,1,1,0,0,1,1,1,0,1,1,1,1,0,2,1,1,1,
2,2,1,1,1,2,1,2,1,1,1,1,1,1,1,2,1,1,1,2,3,1,1,1,1,1,1,1,1,1,0,1,
2,3,3,0,1,0,0,0,3,3,1,0,0,1,2,2,1,0,0,0,0,2,0,0,1,1,1,0,2,1,1,1,
2,1,1,1,1,1,1,2,1,1,0,1,1,0,1,1,1,0,1,2,1,1,0,1,1,1,1,1,1,1,0,1,
2,3,3,0,1,0,0,0,2,2,0,0,0,0,1,2,2,0,0,0,0,1,0,0,1,1,0,0,2,0,1,0,
2,1,1,1,1,2,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,1,1,2,0,1,1,1,1,1,0,1,
3,2,2,0,1,0,1,0,2,3,2,0,0,1,2,2,1,0,0,1,1,1,0,0,2,1,0,1,2,2,1,1,
2,1,1,1,1,1,1,2,1,1,1,1,1,1,0,2,1,0,1,1,0,1,1,1,0,1,1,2,1,1,0,1,
2,2,2,0,0,1,0,0,2,2,1,1,0,0,2,1,1,0,0,0,1,2,0,0,2,1,0,0,2,1,1,1,
2,1,1,1,1,2,1,2,1,1,1,2,2,1,1,2,1,1,1,2,1,1,1,1,1,1,1,1,1,1,0,1,
1,2,3,0,0,0,1,0,3,2,1,0,0,1,2,1,1,0,0,0,0,2,1,0,1,1,0,0,2,1,2,1,
1,1,0,0,0,1,0,1,1,1,1,1,2,0,0,1,0,0,0,2,0,0,1,1,1,1,1,1,1,1,0,1,
3,0,0,2,1,2,2,1,0,0,2,1,2,2,0,0,0,2,1,1,1,0,1,1,0,0,1,1,2,0,0,0,
1,2,1,2,2,1,1,2,1,2,0,1,1,1,1,1,1,1,1,1,2,1,1,0,0,1,1,1,1,0,0,1,
1,3,2,0,0,0,1,0,2,2,2,0,0,0,2,2,1,0,0,0,0,3,1,1,1,1,0,0,2,1,1,1,
2,1,0,1,1,1,0,1,1,1,1,1,1,1,0,2,1,0,0,1,0,1,1,0,1,1,1,1,1,1,0,1,
2,3,2,0,0,0,1,0,2,2,0,0,0,0,2,1,1,0,0,0,0,2,1,0,1,1,0,0,2,1,1,0,
2,1,1,1,1,2,1,2,1,2,0,1,1,1,0,2,1,1,1,2,1,1,1,1,0,1,1,1,1,1,0,1,
3,1,1,2,2,2,3,2,1,1,2,2,1,1,0,1,0,2,2,1,1,1,1,1,0,0,1,1,0,1,1,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
2,2,2,0,0,0,0,0,2,2,0,0,0,0,2,2,1,0,0,0,1,1,0,0,1,2,0,0,2,1,1,1,
2,2,1,1,1,2,1,2,1,1,0,1,1,1,1,2,1,1,1,2,1,1,1,1,0,1,2,1,1,1,0,1,
1,0,0,1,2,3,2,1,0,0,2,0,1,1,0,0,0,1,1,1,1,0,1,1,0,0,1,0,0,0,0,0,
1,2,1,2,1,2,1,1,1,2,0,2,1,1,1,0,1,2,0,0,1,1,1,0,0,0,0,0,0,0,0,0,
2,3,2,0,0,0,0,0,1,1,2,1,0,0,1,1,1,0,0,0,0,2,0,0,1,1,0,0,2,1,1,1,
2,1,1,1,1,1,1,2,1,0,1,1,1,1,0,2,1,1,1,1,1,1,0,1,0,1,1,1,1,1,0,1,
1,2,2,0,1,1,1,0,2,2,2,0,0,0,3,2,1,0,0,0,1,1,0,0,1,1,0,1,1,1,0,0,
1,1,0,1,1,1,1,1,1,1,1,2,1,1,1,1,1,1,1,2,1,1,1,0,0,1,1,1,0,1,0,1,
2,1,0,2,1,1,2,2,1,1,2,1,1,1,0,0,0,1,1,0,1,1,1,1,0,0,1,1,1,0,0,0,
1,2,2,2,2,2,1,1,1,2,0,2,1,1,1,1,1,1,1,1,1,1,1,1,0,1,1,0,0,0,1,0,
1,2,3,0,0,0,1,0,2,2,0,0,0,0,2,2,0,0,0,0,0,1,0,0,1,0,0,0,2,0,1,0,
2,1,1,1,1,1,0,2,0,0,0,1,2,1,1,1,1,0,1,2,0,1,0,1,0,1,1,1,0,1,0,1,
2,2,2,0,0,0,1,0,2,1,2,0,0,0,1,1,2,0,0,0,0,1,0,0,1,1,0,0,2,1,0,1,
2,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,2,0,1,1,1,1,1,0,1,
1,2,2,0,0,0,1,0,2,2,2,0,0,0,1,1,0,0,0,0,0,1,1,0,2,0,0,1,1,1,0,1,
1,0,1,1,1,1,1,1,0,1,1,1,1,0,0,1,0,0,1,1,0,1,0,1,1,1,1,1,0,0,0,1,
1,0,0,1,0,1,2,1,0,0,1,1,1,2,0,0,0,1,1,0,1,0,1,1,0,0,1,0,0,0,0,0,
0,2,1,2,1,1,1,1,1,2,0,2,0,1,1,0,1,2,1,0,1,1,1,0,0,0,0,0,0,1,0,0,
2,1,1,0,1,2,0,0,1,1,1,0,0,0,1,1,0,0,0,0,0,1,0,0,1,0,0,0,2,1,0,1,
2,2,1,1,1,1,1,2,1,1,0,1,1,1,1,2,1,1,1,2,1,1,0,1,0,1,1,1,1,1,0,1,
1,2,2,0,0,0,0,0,1,1,0,0,0,0,2,1,0,0,0,0,0,2,0,0,2,2,0,0,2,0,0,1,
2,1,1,1,1,1,1,1,0,1,1,0,1,1,0,1,0,0,0,1,1,1,1,0,0,1,1,1,1,0,0,1,
1,1,2,0,0,3,1,0,2,1,1,1,0,0,1,1,1,0,0,0,1,1,0,0,0,1,0,0,1,0,1,0,
1,2,1,0,1,1,1,2,1,1,0,1,1,1,1,1,0,0,0,1,1,1,1,1,0,1,0,0,0,1,0,0,
2,1,1,0,0,0,0,0,1,0,0,0,0,0,0,0,0,1,0,1,0,0,0,1,0,0,0,0,2,0,0,0,
2,1,1,1,1,1,1,1,1,1,0,1,1,1,1,1,1,1,1,1,2,1,1,0,0,1,1,1,1,1,0,1,
2,1,1,1,2,1,1,1,0,1,1,2,1,0,0,0,0,1,1,1,1,0,1,0,0,0,0,1,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,1,0,1,1,1,1,1,0,0,1,1,2,1,0,0,0,1,1,0,0,0,1,1,0,0,1,0,1,0,0,0,
1,2,1,1,1,1,1,1,1,1,0,1,0,1,1,1,1,1,1,0,1,1,1,0,0,0,0,0,0,1,0,0,
2,0,0,0,1,1,1,1,0,0,1,1,0,0,0,0,0,1,1,1,2,0,0,1,0,0,1,0,1,0,0,0,
0,1,1,1,1,1,1,1,1,2,0,1,1,1,1,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0,
1,0,0,1,1,1,1,1,0,0,2,1,0,1,0,0,0,1,0,1,0,0,0,0,0,0,1,0,0,0,0,0,
0,1,1,1,1,1,1,0,1,1,0,1,0,1,1,0,1,1,0,0,1,1,1,0,0,0,0,0,0,0,0,0,
1,0,0,1,1,1,0,0,0,0,1,0,2,0,0,0,0,0,0,0,0,0,2,0,0,0,0,0,0,0,0,0,
0,1,1,1,1,1,0,0,1,1,0,1,0,1,0,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0,
0,0,0,1,0,0,0,0,0,0,1,1,2,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,1,1,1,0,1,0,0,1,1,0,1,0,1,1,0,1,1,1,0,1,1,1,0,0,0,0,0,0,0,0,0,
2,1,1,1,1,1,1,1,1,1,1,0,0,1,1,1,0,0,1,0,0,1,0,1,0,1,1,1,0,0,1,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,0,0,1,1,1,1,0,0,0,1,1,1,0,0,0,0,1,1,1,0,0,0,0,0,0,0,0,0,0,0,0,
0,1,1,1,1,1,1,0,1,1,0,1,0,1,0,0,1,1,0,0,1,1,0,0,0,0,0,0,0,0,0,0,
)

Latin2HungarianModel = {
  'char_to_order_map': Latin2_HungarianCharToOrderMap,
  'precedence_matrix': HungarianLangModel,
  'typical_positive_ratio': 0.947368,
  'keep_english_letter': True,
  'charset_name': "ISO-8859-2",
  'language': 'Hungarian',
}

Win1250HungarianModel = {
  'char_to_order_map': win1250HungarianCharToOrderMap,
  'precedence_matrix': HungarianLangModel,
  'typical_positive_ratio': 0.947368,
  'keep_english_letter': True,
  'charset_name': "windows-1250",
  'language': 'Hungarian',
}
site-packages/pip/_vendor/chardet/cli/__pycache__/chardetect.cpython-38.pyc000064400000005144151446177000022650 0ustar00U

��.e�
�@srdZddlmZmZmZddlZddlZddlmZddl	m
Z
ddlmZd
dd	�Z
dd
d�Zedkrne�dS)a
Script which takes one or more file paths and reports on their detected
encodings

Example::

    % chardetect somefile someotherfile
    somefile: windows-1252 with confidence 0.5
    someotherfile: ascii with confidence 1.0

If no paths are provided, it takes its input from stdin.

�)�absolute_import�print_function�unicode_literalsN)�__version__)�PY2)�UniversalDetector�stdincCszt�}|D] }t|�}|�|�|jr
q,q
|��|j}trN|�t�	�d�}|drld�
||d|d�Sd�
|�SdS)z�
    Return a string describing the probable encoding of a file or
    list of strings.

    :param lines: The lines to get the encoding of.
    :type lines: Iterable of bytes
    :param name: Name of file or collection of lines
    :type name: str
    �ignore�encodingz{0}: {1} with confidence {2}Z
confidencez{0}: no resultN)r�	bytearrayZfeedZdone�close�resultr�decode�sys�getfilesystemencoding�format)�lines�name�u�liner
�r�F/usr/lib/python3.8/site-packages/pip/_vendor/chardet/cli/chardetect.py�description_ofs

�rcCs�tjdd�}|jddt�d�dtr(tjntjjgd�|jdd	d
�t	�d�|�
|�}|jD]*}|��rvt
dtjd
�t
t||j��q\dS)z�
    Handles command line arguments and gets things started.

    :param argv: List of arguments, as if specified on the command-line.
                 If None, ``sys.argv[1:]`` is used instead.
    :type argv: list of str
    zVTakes one or more file paths and reports their detected                      encodings)�description�inputz^File whose encoding we would like to determine.                               (default: stdin)�rb�*)�help�type�nargs�defaultz	--version�versionz%(prog)s {0})�actionr!z�You are running chardetect interactively. Press CTRL-D twice at the start of a blank line to signal the end of your input. If you want help, run chardetect --help
)�fileN)�argparse�ArgumentParser�add_argumentZFileTyperrr�bufferrr�
parse_argsr�isatty�print�stderrrr)�argv�parser�args�frrr�main6s&	���

�r0�__main__)r)N)�__doc__Z
__future__rrrr$rZpip._vendor.chardetrZpip._vendor.chardet.compatrZ%pip._vendor.chardet.universaldetectorrrr0�__name__rrrr�<module>s

site-packages/pip/_vendor/chardet/cli/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000237151446177000023236 0ustar00U

��.e�@sdS)N�rrr�D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/cli/__init__.py�<module>�site-packages/pip/_vendor/chardet/cli/__pycache__/chardetect.cpython-38.opt-1.pyc000064400000005144151446177000023607 0ustar00U

��.e�
�@srdZddlmZmZmZddlZddlZddlmZddl	m
Z
ddlmZd
dd	�Z
dd
d�Zedkrne�dS)a
Script which takes one or more file paths and reports on their detected
encodings

Example::

    % chardetect somefile someotherfile
    somefile: windows-1252 with confidence 0.5
    someotherfile: ascii with confidence 1.0

If no paths are provided, it takes its input from stdin.

�)�absolute_import�print_function�unicode_literalsN)�__version__)�PY2)�UniversalDetector�stdincCszt�}|D] }t|�}|�|�|jr
q,q
|��|j}trN|�t�	�d�}|drld�
||d|d�Sd�
|�SdS)z�
    Return a string describing the probable encoding of a file or
    list of strings.

    :param lines: The lines to get the encoding of.
    :type lines: Iterable of bytes
    :param name: Name of file or collection of lines
    :type name: str
    �ignore�encodingz{0}: {1} with confidence {2}Z
confidencez{0}: no resultN)r�	bytearrayZfeedZdone�close�resultr�decode�sys�getfilesystemencoding�format)�lines�name�u�liner
�r�F/usr/lib/python3.8/site-packages/pip/_vendor/chardet/cli/chardetect.py�description_ofs

�rcCs�tjdd�}|jddt�d�dtr(tjntjjgd�|jdd	d
�t	�d�|�
|�}|jD]*}|��rvt
dtjd
�t
t||j��q\dS)z�
    Handles command line arguments and gets things started.

    :param argv: List of arguments, as if specified on the command-line.
                 If None, ``sys.argv[1:]`` is used instead.
    :type argv: list of str
    zVTakes one or more file paths and reports their detected                      encodings)�description�inputz^File whose encoding we would like to determine.                               (default: stdin)�rb�*)�help�type�nargs�defaultz	--version�versionz%(prog)s {0})�actionr!z�You are running chardetect interactively. Press CTRL-D twice at the start of a blank line to signal the end of your input. If you want help, run chardetect --help
)�fileN)�argparse�ArgumentParser�add_argumentZFileTyperrr�bufferrr�
parse_argsr�isatty�print�stderrrr)�argv�parser�args�frrr�main6s&	���

�r0�__main__)r)N)�__doc__Z
__future__rrrr$rZpip._vendor.chardetrZpip._vendor.chardet.compatrZ%pip._vendor.chardet.universaldetectorrrr0�__name__rrrr�<module>s

site-packages/pip/_vendor/chardet/cli/__pycache__/__init__.cpython-38.pyc000064400000000237151446177000022277 0ustar00U

��.e�@sdS)N�rrr�D/usr/lib/python3.8/site-packages/pip/_vendor/chardet/cli/__init__.py�<module>�site-packages/pip/_vendor/chardet/cli/__init__.py000064400000000001151446177000015776 0ustar00
site-packages/pip/_vendor/chardet/cli/chardetect.py000064400000005326151446177000016364 0ustar00#!/usr/bin/env python
"""
Script which takes one or more file paths and reports on their detected
encodings

Example::

    % chardetect somefile someotherfile
    somefile: windows-1252 with confidence 0.5
    someotherfile: ascii with confidence 1.0

If no paths are provided, it takes its input from stdin.

"""

from __future__ import absolute_import, print_function, unicode_literals

import argparse
import sys

from pip._vendor.chardet import __version__
from pip._vendor.chardet.compat import PY2
from pip._vendor.chardet.universaldetector import UniversalDetector


def description_of(lines, name='stdin'):
    """
    Return a string describing the probable encoding of a file or
    list of strings.

    :param lines: The lines to get the encoding of.
    :type lines: Iterable of bytes
    :param name: Name of file or collection of lines
    :type name: str
    """
    u = UniversalDetector()
    for line in lines:
        line = bytearray(line)
        u.feed(line)
        # shortcut out of the loop to save reading further - particularly useful if we read a BOM.
        if u.done:
            break
    u.close()
    result = u.result
    if PY2:
        name = name.decode(sys.getfilesystemencoding(), 'ignore')
    if result['encoding']:
        return '{0}: {1} with confidence {2}'.format(name, result['encoding'],
                                                     result['confidence'])
    else:
        return '{0}: no result'.format(name)


def main(argv=None):
    """
    Handles command line arguments and gets things started.

    :param argv: List of arguments, as if specified on the command-line.
                 If None, ``sys.argv[1:]`` is used instead.
    :type argv: list of str
    """
    # Get command line arguments
    parser = argparse.ArgumentParser(
        description="Takes one or more file paths and reports their detected \
                     encodings")
    parser.add_argument('input',
                        help='File whose encoding we would like to determine. \
                              (default: stdin)',
                        type=argparse.FileType('rb'), nargs='*',
                        default=[sys.stdin if PY2 else sys.stdin.buffer])
    parser.add_argument('--version', action='version',
                        version='%(prog)s {0}'.format(__version__))
    args = parser.parse_args(argv)

    for f in args.input:
        if f.isatty():
            print("You are running chardetect interactively. Press " +
                  "CTRL-D twice at the start of a blank line to signal the " +
                  "end of your input. If you want help, run chardetect " +
                  "--help\n", file=sys.stderr)
        print(description_of(f, f.name))


if __name__ == '__main__':
    main()
site-packages/pip/_vendor/chardet/escprober.py000064400000007556151446177000015502 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetprober import CharSetProber
from .codingstatemachine import CodingStateMachine
from .enums import LanguageFilter, ProbingState, MachineState
from .escsm import (HZ_SM_MODEL, ISO2022CN_SM_MODEL, ISO2022JP_SM_MODEL,
                    ISO2022KR_SM_MODEL)


class EscCharSetProber(CharSetProber):
    """
    This CharSetProber uses a "code scheme" approach for detecting encodings,
    whereby easily recognizable escape or shift sequences are relied on to
    identify these encodings.
    """

    def __init__(self, lang_filter=None):
        super(EscCharSetProber, self).__init__(lang_filter=lang_filter)
        self.coding_sm = []
        if self.lang_filter & LanguageFilter.CHINESE_SIMPLIFIED:
            self.coding_sm.append(CodingStateMachine(HZ_SM_MODEL))
            self.coding_sm.append(CodingStateMachine(ISO2022CN_SM_MODEL))
        if self.lang_filter & LanguageFilter.JAPANESE:
            self.coding_sm.append(CodingStateMachine(ISO2022JP_SM_MODEL))
        if self.lang_filter & LanguageFilter.KOREAN:
            self.coding_sm.append(CodingStateMachine(ISO2022KR_SM_MODEL))
        self.active_sm_count = None
        self._detected_charset = None
        self._detected_language = None
        self._state = None
        self.reset()

    def reset(self):
        super(EscCharSetProber, self).reset()
        for coding_sm in self.coding_sm:
            if not coding_sm:
                continue
            coding_sm.active = True
            coding_sm.reset()
        self.active_sm_count = len(self.coding_sm)
        self._detected_charset = None
        self._detected_language = None

    @property
    def charset_name(self):
        return self._detected_charset

    @property
    def language(self):
        return self._detected_language

    def get_confidence(self):
        if self._detected_charset:
            return 0.99
        else:
            return 0.00

    def feed(self, byte_str):
        for c in byte_str:
            for coding_sm in self.coding_sm:
                if not coding_sm or not coding_sm.active:
                    continue
                coding_state = coding_sm.next_state(c)
                if coding_state == MachineState.ERROR:
                    coding_sm.active = False
                    self.active_sm_count -= 1
                    if self.active_sm_count <= 0:
                        self._state = ProbingState.NOT_ME
                        return self.state
                elif coding_state == MachineState.ITS_ME:
                    self._state = ProbingState.FOUND_IT
                    self._detected_charset = coding_sm.get_coding_state_machine()
                    self._detected_language = coding_sm.language
                    return self.state

        return self.state
site-packages/pip/_vendor/chardet/utf8prober.py000064400000005316151446177000015606 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .charsetprober import CharSetProber
from .enums import ProbingState, MachineState
from .codingstatemachine import CodingStateMachine
from .mbcssm import UTF8_SM_MODEL



class UTF8Prober(CharSetProber):
    ONE_CHAR_PROB = 0.5

    def __init__(self):
        super(UTF8Prober, self).__init__()
        self.coding_sm = CodingStateMachine(UTF8_SM_MODEL)
        self._num_mb_chars = None
        self.reset()

    def reset(self):
        super(UTF8Prober, self).reset()
        self.coding_sm.reset()
        self._num_mb_chars = 0

    @property
    def charset_name(self):
        return "utf-8"

    @property
    def language(self):
        return ""

    def feed(self, byte_str):
        for c in byte_str:
            coding_state = self.coding_sm.next_state(c)
            if coding_state == MachineState.ERROR:
                self._state = ProbingState.NOT_ME
                break
            elif coding_state == MachineState.ITS_ME:
                self._state = ProbingState.FOUND_IT
                break
            elif coding_state == MachineState.START:
                if self.coding_sm.get_current_charlen() >= 2:
                    self._num_mb_chars += 1

        if self.state == ProbingState.DETECTING:
            if self.get_confidence() > self.SHORTCUT_THRESHOLD:
                self._state = ProbingState.FOUND_IT

        return self.state

    def get_confidence(self):
        unlike = 0.99
        if self._num_mb_chars < 6:
            unlike *= self.ONE_CHAR_PROB ** self._num_mb_chars
            return 1.0 - unlike
        else:
            return unlike
site-packages/pip/_vendor/chardet/mbcssm.py000064400000061611151446177000014772 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .enums import MachineState

# BIG5

BIG5_CLS = (
    1,1,1,1,1,1,1,1,  # 00 - 07    #allow 0x00 as legal value
    1,1,1,1,1,1,0,0,  # 08 - 0f
    1,1,1,1,1,1,1,1,  # 10 - 17
    1,1,1,0,1,1,1,1,  # 18 - 1f
    1,1,1,1,1,1,1,1,  # 20 - 27
    1,1,1,1,1,1,1,1,  # 28 - 2f
    1,1,1,1,1,1,1,1,  # 30 - 37
    1,1,1,1,1,1,1,1,  # 38 - 3f
    2,2,2,2,2,2,2,2,  # 40 - 47
    2,2,2,2,2,2,2,2,  # 48 - 4f
    2,2,2,2,2,2,2,2,  # 50 - 57
    2,2,2,2,2,2,2,2,  # 58 - 5f
    2,2,2,2,2,2,2,2,  # 60 - 67
    2,2,2,2,2,2,2,2,  # 68 - 6f
    2,2,2,2,2,2,2,2,  # 70 - 77
    2,2,2,2,2,2,2,1,  # 78 - 7f
    4,4,4,4,4,4,4,4,  # 80 - 87
    4,4,4,4,4,4,4,4,  # 88 - 8f
    4,4,4,4,4,4,4,4,  # 90 - 97
    4,4,4,4,4,4,4,4,  # 98 - 9f
    4,3,3,3,3,3,3,3,  # a0 - a7
    3,3,3,3,3,3,3,3,  # a8 - af
    3,3,3,3,3,3,3,3,  # b0 - b7
    3,3,3,3,3,3,3,3,  # b8 - bf
    3,3,3,3,3,3,3,3,  # c0 - c7
    3,3,3,3,3,3,3,3,  # c8 - cf
    3,3,3,3,3,3,3,3,  # d0 - d7
    3,3,3,3,3,3,3,3,  # d8 - df
    3,3,3,3,3,3,3,3,  # e0 - e7
    3,3,3,3,3,3,3,3,  # e8 - ef
    3,3,3,3,3,3,3,3,  # f0 - f7
    3,3,3,3,3,3,3,0  # f8 - ff
)

BIG5_ST = (
    MachineState.ERROR,MachineState.START,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
    MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,#08-0f
    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START#10-17
)

BIG5_CHAR_LEN_TABLE = (0, 1, 1, 2, 0)

BIG5_SM_MODEL = {'class_table': BIG5_CLS,
                 'class_factor': 5,
                 'state_table': BIG5_ST,
                 'char_len_table': BIG5_CHAR_LEN_TABLE,
                 'name': 'Big5'}

# CP949

CP949_CLS  = (
    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,0,0,  # 00 - 0f
    1,1,1,1,1,1,1,1, 1,1,1,0,1,1,1,1,  # 10 - 1f
    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,  # 20 - 2f
    1,1,1,1,1,1,1,1, 1,1,1,1,1,1,1,1,  # 30 - 3f
    1,4,4,4,4,4,4,4, 4,4,4,4,4,4,4,4,  # 40 - 4f
    4,4,5,5,5,5,5,5, 5,5,5,1,1,1,1,1,  # 50 - 5f
    1,5,5,5,5,5,5,5, 5,5,5,5,5,5,5,5,  # 60 - 6f
    5,5,5,5,5,5,5,5, 5,5,5,1,1,1,1,1,  # 70 - 7f
    0,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6,  # 80 - 8f
    6,6,6,6,6,6,6,6, 6,6,6,6,6,6,6,6,  # 90 - 9f
    6,7,7,7,7,7,7,7, 7,7,7,7,7,8,8,8,  # a0 - af
    7,7,7,7,7,7,7,7, 7,7,7,7,7,7,7,7,  # b0 - bf
    7,7,7,7,7,7,9,2, 2,3,2,2,2,2,2,2,  # c0 - cf
    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,  # d0 - df
    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,2,  # e0 - ef
    2,2,2,2,2,2,2,2, 2,2,2,2,2,2,2,0,  # f0 - ff
)

CP949_ST = (
#cls=    0      1      2      3      4      5      6      7      8      9  # previous state =
    MachineState.ERROR,MachineState.START,     3,MachineState.ERROR,MachineState.START,MachineState.START,     4,     5,MachineState.ERROR,     6, # MachineState.START
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR, # MachineState.ERROR
    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME, # MachineState.ITS_ME
    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START, # 3
    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START, # 4
    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START, # 5
    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START, # 6
)

CP949_CHAR_LEN_TABLE = (0, 1, 2, 0, 1, 1, 2, 2, 0, 2)

CP949_SM_MODEL = {'class_table': CP949_CLS,
                  'class_factor': 10,
                  'state_table': CP949_ST,
                  'char_len_table': CP949_CHAR_LEN_TABLE,
                  'name': 'CP949'}

# EUC-JP

EUCJP_CLS = (
    4,4,4,4,4,4,4,4,  # 00 - 07
    4,4,4,4,4,4,5,5,  # 08 - 0f
    4,4,4,4,4,4,4,4,  # 10 - 17
    4,4,4,5,4,4,4,4,  # 18 - 1f
    4,4,4,4,4,4,4,4,  # 20 - 27
    4,4,4,4,4,4,4,4,  # 28 - 2f
    4,4,4,4,4,4,4,4,  # 30 - 37
    4,4,4,4,4,4,4,4,  # 38 - 3f
    4,4,4,4,4,4,4,4,  # 40 - 47
    4,4,4,4,4,4,4,4,  # 48 - 4f
    4,4,4,4,4,4,4,4,  # 50 - 57
    4,4,4,4,4,4,4,4,  # 58 - 5f
    4,4,4,4,4,4,4,4,  # 60 - 67
    4,4,4,4,4,4,4,4,  # 68 - 6f
    4,4,4,4,4,4,4,4,  # 70 - 77
    4,4,4,4,4,4,4,4,  # 78 - 7f
    5,5,5,5,5,5,5,5,  # 80 - 87
    5,5,5,5,5,5,1,3,  # 88 - 8f
    5,5,5,5,5,5,5,5,  # 90 - 97
    5,5,5,5,5,5,5,5,  # 98 - 9f
    5,2,2,2,2,2,2,2,  # a0 - a7
    2,2,2,2,2,2,2,2,  # a8 - af
    2,2,2,2,2,2,2,2,  # b0 - b7
    2,2,2,2,2,2,2,2,  # b8 - bf
    2,2,2,2,2,2,2,2,  # c0 - c7
    2,2,2,2,2,2,2,2,  # c8 - cf
    2,2,2,2,2,2,2,2,  # d0 - d7
    2,2,2,2,2,2,2,2,  # d8 - df
    0,0,0,0,0,0,0,0,  # e0 - e7
    0,0,0,0,0,0,0,0,  # e8 - ef
    0,0,0,0,0,0,0,0,  # f0 - f7
    0,0,0,0,0,0,0,5  # f8 - ff
)

EUCJP_ST = (
          3,     4,     3,     5,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
     MachineState.ITS_ME,MachineState.ITS_ME,MachineState.START,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#10-17
     MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     3,MachineState.ERROR,#18-1f
          3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START#20-27
)

EUCJP_CHAR_LEN_TABLE = (2, 2, 2, 3, 1, 0)

EUCJP_SM_MODEL = {'class_table': EUCJP_CLS,
                  'class_factor': 6,
                  'state_table': EUCJP_ST,
                  'char_len_table': EUCJP_CHAR_LEN_TABLE,
                  'name': 'EUC-JP'}

# EUC-KR

EUCKR_CLS  = (
    1,1,1,1,1,1,1,1,  # 00 - 07
    1,1,1,1,1,1,0,0,  # 08 - 0f
    1,1,1,1,1,1,1,1,  # 10 - 17
    1,1,1,0,1,1,1,1,  # 18 - 1f
    1,1,1,1,1,1,1,1,  # 20 - 27
    1,1,1,1,1,1,1,1,  # 28 - 2f
    1,1,1,1,1,1,1,1,  # 30 - 37
    1,1,1,1,1,1,1,1,  # 38 - 3f
    1,1,1,1,1,1,1,1,  # 40 - 47
    1,1,1,1,1,1,1,1,  # 48 - 4f
    1,1,1,1,1,1,1,1,  # 50 - 57
    1,1,1,1,1,1,1,1,  # 58 - 5f
    1,1,1,1,1,1,1,1,  # 60 - 67
    1,1,1,1,1,1,1,1,  # 68 - 6f
    1,1,1,1,1,1,1,1,  # 70 - 77
    1,1,1,1,1,1,1,1,  # 78 - 7f
    0,0,0,0,0,0,0,0,  # 80 - 87
    0,0,0,0,0,0,0,0,  # 88 - 8f
    0,0,0,0,0,0,0,0,  # 90 - 97
    0,0,0,0,0,0,0,0,  # 98 - 9f
    0,2,2,2,2,2,2,2,  # a0 - a7
    2,2,2,2,2,3,3,3,  # a8 - af
    2,2,2,2,2,2,2,2,  # b0 - b7
    2,2,2,2,2,2,2,2,  # b8 - bf
    2,2,2,2,2,2,2,2,  # c0 - c7
    2,3,2,2,2,2,2,2,  # c8 - cf
    2,2,2,2,2,2,2,2,  # d0 - d7
    2,2,2,2,2,2,2,2,  # d8 - df
    2,2,2,2,2,2,2,2,  # e0 - e7
    2,2,2,2,2,2,2,2,  # e8 - ef
    2,2,2,2,2,2,2,2,  # f0 - f7
    2,2,2,2,2,2,2,0   # f8 - ff
)

EUCKR_ST = (
    MachineState.ERROR,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START #08-0f
)

EUCKR_CHAR_LEN_TABLE = (0, 1, 2, 0)

EUCKR_SM_MODEL = {'class_table': EUCKR_CLS,
                'class_factor': 4,
                'state_table': EUCKR_ST,
                'char_len_table': EUCKR_CHAR_LEN_TABLE,
                'name': 'EUC-KR'}

# EUC-TW

EUCTW_CLS = (
    2,2,2,2,2,2,2,2,  # 00 - 07
    2,2,2,2,2,2,0,0,  # 08 - 0f
    2,2,2,2,2,2,2,2,  # 10 - 17
    2,2,2,0,2,2,2,2,  # 18 - 1f
    2,2,2,2,2,2,2,2,  # 20 - 27
    2,2,2,2,2,2,2,2,  # 28 - 2f
    2,2,2,2,2,2,2,2,  # 30 - 37
    2,2,2,2,2,2,2,2,  # 38 - 3f
    2,2,2,2,2,2,2,2,  # 40 - 47
    2,2,2,2,2,2,2,2,  # 48 - 4f
    2,2,2,2,2,2,2,2,  # 50 - 57
    2,2,2,2,2,2,2,2,  # 58 - 5f
    2,2,2,2,2,2,2,2,  # 60 - 67
    2,2,2,2,2,2,2,2,  # 68 - 6f
    2,2,2,2,2,2,2,2,  # 70 - 77
    2,2,2,2,2,2,2,2,  # 78 - 7f
    0,0,0,0,0,0,0,0,  # 80 - 87
    0,0,0,0,0,0,6,0,  # 88 - 8f
    0,0,0,0,0,0,0,0,  # 90 - 97
    0,0,0,0,0,0,0,0,  # 98 - 9f
    0,3,4,4,4,4,4,4,  # a0 - a7
    5,5,1,1,1,1,1,1,  # a8 - af
    1,1,1,1,1,1,1,1,  # b0 - b7
    1,1,1,1,1,1,1,1,  # b8 - bf
    1,1,3,1,3,3,3,3,  # c0 - c7
    3,3,3,3,3,3,3,3,  # c8 - cf
    3,3,3,3,3,3,3,3,  # d0 - d7
    3,3,3,3,3,3,3,3,  # d8 - df
    3,3,3,3,3,3,3,3,  # e0 - e7
    3,3,3,3,3,3,3,3,  # e8 - ef
    3,3,3,3,3,3,3,3,  # f0 - f7
    3,3,3,3,3,3,3,0   # f8 - ff
)

EUCTW_ST = (
    MachineState.ERROR,MachineState.ERROR,MachineState.START,     3,     3,     3,     4,MachineState.ERROR,#00-07
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.START,MachineState.ERROR,#10-17
    MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
         5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.START,MachineState.START,#20-27
    MachineState.START,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START #28-2f
)

EUCTW_CHAR_LEN_TABLE = (0, 0, 1, 2, 2, 2, 3)

EUCTW_SM_MODEL = {'class_table': EUCTW_CLS,
                'class_factor': 7,
                'state_table': EUCTW_ST,
                'char_len_table': EUCTW_CHAR_LEN_TABLE,
                'name': 'x-euc-tw'}

# GB2312

GB2312_CLS = (
    1,1,1,1,1,1,1,1,  # 00 - 07
    1,1,1,1,1,1,0,0,  # 08 - 0f
    1,1,1,1,1,1,1,1,  # 10 - 17
    1,1,1,0,1,1,1,1,  # 18 - 1f
    1,1,1,1,1,1,1,1,  # 20 - 27
    1,1,1,1,1,1,1,1,  # 28 - 2f
    3,3,3,3,3,3,3,3,  # 30 - 37
    3,3,1,1,1,1,1,1,  # 38 - 3f
    2,2,2,2,2,2,2,2,  # 40 - 47
    2,2,2,2,2,2,2,2,  # 48 - 4f
    2,2,2,2,2,2,2,2,  # 50 - 57
    2,2,2,2,2,2,2,2,  # 58 - 5f
    2,2,2,2,2,2,2,2,  # 60 - 67
    2,2,2,2,2,2,2,2,  # 68 - 6f
    2,2,2,2,2,2,2,2,  # 70 - 77
    2,2,2,2,2,2,2,4,  # 78 - 7f
    5,6,6,6,6,6,6,6,  # 80 - 87
    6,6,6,6,6,6,6,6,  # 88 - 8f
    6,6,6,6,6,6,6,6,  # 90 - 97
    6,6,6,6,6,6,6,6,  # 98 - 9f
    6,6,6,6,6,6,6,6,  # a0 - a7
    6,6,6,6,6,6,6,6,  # a8 - af
    6,6,6,6,6,6,6,6,  # b0 - b7
    6,6,6,6,6,6,6,6,  # b8 - bf
    6,6,6,6,6,6,6,6,  # c0 - c7
    6,6,6,6,6,6,6,6,  # c8 - cf
    6,6,6,6,6,6,6,6,  # d0 - d7
    6,6,6,6,6,6,6,6,  # d8 - df
    6,6,6,6,6,6,6,6,  # e0 - e7
    6,6,6,6,6,6,6,6,  # e8 - ef
    6,6,6,6,6,6,6,6,  # f0 - f7
    6,6,6,6,6,6,6,0   # f8 - ff
)

GB2312_ST = (
    MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,     3,MachineState.ERROR,#00-07
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,#10-17
         4,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
    MachineState.ERROR,MachineState.ERROR,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,#20-27
    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.START #28-2f
)

# To be accurate, the length of class 6 can be either 2 or 4.
# But it is not necessary to discriminate between the two since
# it is used for frequency analysis only, and we are validating
# each code range there as well. So it is safe to set it to be
# 2 here.
GB2312_CHAR_LEN_TABLE = (0, 1, 1, 1, 1, 1, 2)

GB2312_SM_MODEL = {'class_table': GB2312_CLS,
                   'class_factor': 7,
                   'state_table': GB2312_ST,
                   'char_len_table': GB2312_CHAR_LEN_TABLE,
                   'name': 'GB2312'}

# Shift_JIS

SJIS_CLS = (
    1,1,1,1,1,1,1,1,  # 00 - 07
    1,1,1,1,1,1,0,0,  # 08 - 0f
    1,1,1,1,1,1,1,1,  # 10 - 17
    1,1,1,0,1,1,1,1,  # 18 - 1f
    1,1,1,1,1,1,1,1,  # 20 - 27
    1,1,1,1,1,1,1,1,  # 28 - 2f
    1,1,1,1,1,1,1,1,  # 30 - 37
    1,1,1,1,1,1,1,1,  # 38 - 3f
    2,2,2,2,2,2,2,2,  # 40 - 47
    2,2,2,2,2,2,2,2,  # 48 - 4f
    2,2,2,2,2,2,2,2,  # 50 - 57
    2,2,2,2,2,2,2,2,  # 58 - 5f
    2,2,2,2,2,2,2,2,  # 60 - 67
    2,2,2,2,2,2,2,2,  # 68 - 6f
    2,2,2,2,2,2,2,2,  # 70 - 77
    2,2,2,2,2,2,2,1,  # 78 - 7f
    3,3,3,3,3,2,2,3,  # 80 - 87
    3,3,3,3,3,3,3,3,  # 88 - 8f
    3,3,3,3,3,3,3,3,  # 90 - 97
    3,3,3,3,3,3,3,3,  # 98 - 9f
    #0xa0 is illegal in sjis encoding, but some pages does
    #contain such byte. We need to be more error forgiven.
    2,2,2,2,2,2,2,2,  # a0 - a7
    2,2,2,2,2,2,2,2,  # a8 - af
    2,2,2,2,2,2,2,2,  # b0 - b7
    2,2,2,2,2,2,2,2,  # b8 - bf
    2,2,2,2,2,2,2,2,  # c0 - c7
    2,2,2,2,2,2,2,2,  # c8 - cf
    2,2,2,2,2,2,2,2,  # d0 - d7
    2,2,2,2,2,2,2,2,  # d8 - df
    3,3,3,3,3,3,3,3,  # e0 - e7
    3,3,3,3,3,4,4,4,  # e8 - ef
    3,3,3,3,3,3,3,3,  # f0 - f7
    3,3,3,3,3,0,0,0)  # f8 - ff


SJIS_ST = (
    MachineState.ERROR,MachineState.START,MachineState.START,     3,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#00-07
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START #10-17
)

SJIS_CHAR_LEN_TABLE = (0, 1, 1, 2, 0, 0)

SJIS_SM_MODEL = {'class_table': SJIS_CLS,
               'class_factor': 6,
               'state_table': SJIS_ST,
               'char_len_table': SJIS_CHAR_LEN_TABLE,
               'name': 'Shift_JIS'}

# UCS2-BE

UCS2BE_CLS = (
    0,0,0,0,0,0,0,0,  # 00 - 07
    0,0,1,0,0,2,0,0,  # 08 - 0f
    0,0,0,0,0,0,0,0,  # 10 - 17
    0,0,0,3,0,0,0,0,  # 18 - 1f
    0,0,0,0,0,0,0,0,  # 20 - 27
    0,3,3,3,3,3,0,0,  # 28 - 2f
    0,0,0,0,0,0,0,0,  # 30 - 37
    0,0,0,0,0,0,0,0,  # 38 - 3f
    0,0,0,0,0,0,0,0,  # 40 - 47
    0,0,0,0,0,0,0,0,  # 48 - 4f
    0,0,0,0,0,0,0,0,  # 50 - 57
    0,0,0,0,0,0,0,0,  # 58 - 5f
    0,0,0,0,0,0,0,0,  # 60 - 67
    0,0,0,0,0,0,0,0,  # 68 - 6f
    0,0,0,0,0,0,0,0,  # 70 - 77
    0,0,0,0,0,0,0,0,  # 78 - 7f
    0,0,0,0,0,0,0,0,  # 80 - 87
    0,0,0,0,0,0,0,0,  # 88 - 8f
    0,0,0,0,0,0,0,0,  # 90 - 97
    0,0,0,0,0,0,0,0,  # 98 - 9f
    0,0,0,0,0,0,0,0,  # a0 - a7
    0,0,0,0,0,0,0,0,  # a8 - af
    0,0,0,0,0,0,0,0,  # b0 - b7
    0,0,0,0,0,0,0,0,  # b8 - bf
    0,0,0,0,0,0,0,0,  # c0 - c7
    0,0,0,0,0,0,0,0,  # c8 - cf
    0,0,0,0,0,0,0,0,  # d0 - d7
    0,0,0,0,0,0,0,0,  # d8 - df
    0,0,0,0,0,0,0,0,  # e0 - e7
    0,0,0,0,0,0,0,0,  # e8 - ef
    0,0,0,0,0,0,0,0,  # f0 - f7
    0,0,0,0,0,0,4,5   # f8 - ff
)

UCS2BE_ST  = (
          5,     7,     7,MachineState.ERROR,     4,     3,MachineState.ERROR,MachineState.ERROR,#00-07
     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
     MachineState.ITS_ME,MachineState.ITS_ME,     6,     6,     6,     6,MachineState.ERROR,MachineState.ERROR,#10-17
          6,     6,     6,     6,     6,MachineState.ITS_ME,     6,     6,#18-1f
          6,     6,     6,     6,     5,     7,     7,MachineState.ERROR,#20-27
          5,     8,     6,     6,MachineState.ERROR,     6,     6,     6,#28-2f
          6,     6,     6,     6,MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START #30-37
)

UCS2BE_CHAR_LEN_TABLE = (2, 2, 2, 0, 2, 2)

UCS2BE_SM_MODEL = {'class_table': UCS2BE_CLS,
                   'class_factor': 6,
                   'state_table': UCS2BE_ST,
                   'char_len_table': UCS2BE_CHAR_LEN_TABLE,
                   'name': 'UTF-16BE'}

# UCS2-LE

UCS2LE_CLS = (
    0,0,0,0,0,0,0,0,  # 00 - 07
    0,0,1,0,0,2,0,0,  # 08 - 0f
    0,0,0,0,0,0,0,0,  # 10 - 17
    0,0,0,3,0,0,0,0,  # 18 - 1f
    0,0,0,0,0,0,0,0,  # 20 - 27
    0,3,3,3,3,3,0,0,  # 28 - 2f
    0,0,0,0,0,0,0,0,  # 30 - 37
    0,0,0,0,0,0,0,0,  # 38 - 3f
    0,0,0,0,0,0,0,0,  # 40 - 47
    0,0,0,0,0,0,0,0,  # 48 - 4f
    0,0,0,0,0,0,0,0,  # 50 - 57
    0,0,0,0,0,0,0,0,  # 58 - 5f
    0,0,0,0,0,0,0,0,  # 60 - 67
    0,0,0,0,0,0,0,0,  # 68 - 6f
    0,0,0,0,0,0,0,0,  # 70 - 77
    0,0,0,0,0,0,0,0,  # 78 - 7f
    0,0,0,0,0,0,0,0,  # 80 - 87
    0,0,0,0,0,0,0,0,  # 88 - 8f
    0,0,0,0,0,0,0,0,  # 90 - 97
    0,0,0,0,0,0,0,0,  # 98 - 9f
    0,0,0,0,0,0,0,0,  # a0 - a7
    0,0,0,0,0,0,0,0,  # a8 - af
    0,0,0,0,0,0,0,0,  # b0 - b7
    0,0,0,0,0,0,0,0,  # b8 - bf
    0,0,0,0,0,0,0,0,  # c0 - c7
    0,0,0,0,0,0,0,0,  # c8 - cf
    0,0,0,0,0,0,0,0,  # d0 - d7
    0,0,0,0,0,0,0,0,  # d8 - df
    0,0,0,0,0,0,0,0,  # e0 - e7
    0,0,0,0,0,0,0,0,  # e8 - ef
    0,0,0,0,0,0,0,0,  # f0 - f7
    0,0,0,0,0,0,4,5   # f8 - ff
)

UCS2LE_ST = (
          6,     6,     7,     6,     4,     3,MachineState.ERROR,MachineState.ERROR,#00-07
     MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#08-0f
     MachineState.ITS_ME,MachineState.ITS_ME,     5,     5,     5,MachineState.ERROR,MachineState.ITS_ME,MachineState.ERROR,#10-17
          5,     5,     5,MachineState.ERROR,     5,MachineState.ERROR,     6,     6,#18-1f
          7,     6,     8,     8,     5,     5,     5,MachineState.ERROR,#20-27
          5,     5,     5,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,     5,#28-2f
          5,     5,     5,MachineState.ERROR,     5,MachineState.ERROR,MachineState.START,MachineState.START #30-37
)

UCS2LE_CHAR_LEN_TABLE = (2, 2, 2, 2, 2, 2)

UCS2LE_SM_MODEL = {'class_table': UCS2LE_CLS,
                 'class_factor': 6,
                 'state_table': UCS2LE_ST,
                 'char_len_table': UCS2LE_CHAR_LEN_TABLE,
                 'name': 'UTF-16LE'}

# UTF-8

UTF8_CLS = (
    1,1,1,1,1,1,1,1,  # 00 - 07  #allow 0x00 as a legal value
    1,1,1,1,1,1,0,0,  # 08 - 0f
    1,1,1,1,1,1,1,1,  # 10 - 17
    1,1,1,0,1,1,1,1,  # 18 - 1f
    1,1,1,1,1,1,1,1,  # 20 - 27
    1,1,1,1,1,1,1,1,  # 28 - 2f
    1,1,1,1,1,1,1,1,  # 30 - 37
    1,1,1,1,1,1,1,1,  # 38 - 3f
    1,1,1,1,1,1,1,1,  # 40 - 47
    1,1,1,1,1,1,1,1,  # 48 - 4f
    1,1,1,1,1,1,1,1,  # 50 - 57
    1,1,1,1,1,1,1,1,  # 58 - 5f
    1,1,1,1,1,1,1,1,  # 60 - 67
    1,1,1,1,1,1,1,1,  # 68 - 6f
    1,1,1,1,1,1,1,1,  # 70 - 77
    1,1,1,1,1,1,1,1,  # 78 - 7f
    2,2,2,2,3,3,3,3,  # 80 - 87
    4,4,4,4,4,4,4,4,  # 88 - 8f
    4,4,4,4,4,4,4,4,  # 90 - 97
    4,4,4,4,4,4,4,4,  # 98 - 9f
    5,5,5,5,5,5,5,5,  # a0 - a7
    5,5,5,5,5,5,5,5,  # a8 - af
    5,5,5,5,5,5,5,5,  # b0 - b7
    5,5,5,5,5,5,5,5,  # b8 - bf
    0,0,6,6,6,6,6,6,  # c0 - c7
    6,6,6,6,6,6,6,6,  # c8 - cf
    6,6,6,6,6,6,6,6,  # d0 - d7
    6,6,6,6,6,6,6,6,  # d8 - df
    7,8,8,8,8,8,8,8,  # e0 - e7
    8,8,8,8,8,9,8,8,  # e8 - ef
    10,11,11,11,11,11,11,11,  # f0 - f7
    12,13,13,13,14,15,0,0    # f8 - ff
)

UTF8_ST = (
    MachineState.ERROR,MachineState.START,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     12,   10,#00-07
         9,     11,     8,     7,     6,     5,     4,    3,#08-0f
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#10-17
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#18-1f
    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#20-27
    MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,MachineState.ITS_ME,#28-2f
    MachineState.ERROR,MachineState.ERROR,     5,     5,     5,     5,MachineState.ERROR,MachineState.ERROR,#30-37
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#38-3f
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     5,     5,     5,MachineState.ERROR,MachineState.ERROR,#40-47
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#48-4f
    MachineState.ERROR,MachineState.ERROR,     7,     7,     7,     7,MachineState.ERROR,MachineState.ERROR,#50-57
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#58-5f
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     7,     7,MachineState.ERROR,MachineState.ERROR,#60-67
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#68-6f
    MachineState.ERROR,MachineState.ERROR,     9,     9,     9,     9,MachineState.ERROR,MachineState.ERROR,#70-77
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#78-7f
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,     9,MachineState.ERROR,MachineState.ERROR,#80-87
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#88-8f
    MachineState.ERROR,MachineState.ERROR,    12,    12,    12,    12,MachineState.ERROR,MachineState.ERROR,#90-97
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#98-9f
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,    12,MachineState.ERROR,MachineState.ERROR,#a0-a7
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#a8-af
    MachineState.ERROR,MachineState.ERROR,    12,    12,    12,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#b0-b7
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,#b8-bf
    MachineState.ERROR,MachineState.ERROR,MachineState.START,MachineState.START,MachineState.START,MachineState.START,MachineState.ERROR,MachineState.ERROR,#c0-c7
    MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR,MachineState.ERROR #c8-cf
)

UTF8_CHAR_LEN_TABLE = (0, 1, 0, 0, 0, 0, 2, 3, 3, 3, 4, 4, 5, 5, 6, 6)

UTF8_SM_MODEL = {'class_table': UTF8_CLS,
                 'class_factor': 16,
                 'state_table': UTF8_ST,
                 'char_len_table': UTF8_CHAR_LEN_TABLE,
                 'name': 'UTF-8'}
site-packages/pip/_vendor/chardet/euckrprober.py000064400000003324151446177000016026 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .mbcharsetprober import MultiByteCharSetProber
from .codingstatemachine import CodingStateMachine
from .chardistribution import EUCKRDistributionAnalysis
from .mbcssm import EUCKR_SM_MODEL


class EUCKRProber(MultiByteCharSetProber):
    def __init__(self):
        super(EUCKRProber, self).__init__()
        self.coding_sm = CodingStateMachine(EUCKR_SM_MODEL)
        self.distribution_analyzer = EUCKRDistributionAnalysis()
        self.reset()

    @property
    def charset_name(self):
        return "EUC-KR"

    @property
    def language(self):
        return "Korean"
site-packages/pip/_vendor/chardet/codingstatemachine.py000064400000007006151446177000017335 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is mozilla.org code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

import logging

from .enums import MachineState


class CodingStateMachine(object):
    """
    A state machine to verify a byte sequence for a particular encoding. For
    each byte the detector receives, it will feed that byte to every active
    state machine available, one byte at a time. The state machine changes its
    state based on its previous state and the byte it receives. There are 3
    states in a state machine that are of interest to an auto-detector:

    START state: This is the state to start with, or a legal byte sequence
                 (i.e. a valid code point) for character has been identified.

    ME state:  This indicates that the state machine identified a byte sequence
               that is specific to the charset it is designed for and that
               there is no other possible encoding which can contain this byte
               sequence. This will to lead to an immediate positive answer for
               the detector.

    ERROR state: This indicates the state machine identified an illegal byte
                 sequence for that encoding. This will lead to an immediate
                 negative answer for this encoding. Detector will exclude this
                 encoding from consideration from here on.
    """
    def __init__(self, sm):
        self._model = sm
        self._curr_byte_pos = 0
        self._curr_char_len = 0
        self._curr_state = None
        self.logger = logging.getLogger(__name__)
        self.reset()

    def reset(self):
        self._curr_state = MachineState.START

    def next_state(self, c):
        # for each byte we get its class
        # if it is first byte, we also get byte length
        byte_class = self._model['class_table'][c]
        if self._curr_state == MachineState.START:
            self._curr_byte_pos = 0
            self._curr_char_len = self._model['char_len_table'][byte_class]
        # from byte's class and state_table, we get its next state
        curr_state = (self._curr_state * self._model['class_factor']
                      + byte_class)
        self._curr_state = self._model['state_table'][curr_state]
        self._curr_byte_pos += 1
        return self._curr_state

    def get_current_charlen(self):
        return self._curr_char_len

    def get_coding_state_machine(self):
        return self._model['name']

    @property
    def language(self):
        return self._model['language']
site-packages/pip/_vendor/chardet/gb2312freq.py000064400000050353151446177000015265 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

# GB2312 most frequently used character table
#
# Char to FreqOrder table , from hz6763

# 512  --> 0.79  -- 0.79
# 1024 --> 0.92  -- 0.13
# 2048 --> 0.98  -- 0.06
# 6768 --> 1.00  -- 0.02
#
# Ideal Distribution Ratio = 0.79135/(1-0.79135) = 3.79
# Random Distribution Ration = 512 / (3755 - 512) = 0.157
#
# Typical Distribution Ratio about 25% of Ideal one, still much higher that RDR

GB2312_TYPICAL_DISTRIBUTION_RATIO = 0.9

GB2312_TABLE_SIZE = 3760

GB2312_CHAR_TO_FREQ_ORDER = (
1671, 749,1443,2364,3924,3807,2330,3921,1704,3463,2691,1511,1515, 572,3191,2205,
2361, 224,2558, 479,1711, 963,3162, 440,4060,1905,2966,2947,3580,2647,3961,3842,
2204, 869,4207, 970,2678,5626,2944,2956,1479,4048, 514,3595, 588,1346,2820,3409,
 249,4088,1746,1873,2047,1774, 581,1813, 358,1174,3590,1014,1561,4844,2245, 670,
1636,3112, 889,1286, 953, 556,2327,3060,1290,3141, 613, 185,3477,1367, 850,3820,
1715,2428,2642,2303,2732,3041,2562,2648,3566,3946,1349, 388,3098,2091,1360,3585,
 152,1687,1539, 738,1559,  59,1232,2925,2267,1388,1249,1741,1679,2960, 151,1566,
1125,1352,4271, 924,4296, 385,3166,4459, 310,1245,2850,  70,3285,2729,3534,3575,
2398,3298,3466,1960,2265, 217,3647, 864,1909,2084,4401,2773,1010,3269,5152, 853,
3051,3121,1244,4251,1895, 364,1499,1540,2313,1180,3655,2268, 562, 715,2417,3061,
 544, 336,3768,2380,1752,4075, 950, 280,2425,4382, 183,2759,3272, 333,4297,2155,
1688,2356,1444,1039,4540, 736,1177,3349,2443,2368,2144,2225, 565, 196,1482,3406,
 927,1335,4147, 692, 878,1311,1653,3911,3622,1378,4200,1840,2969,3149,2126,1816,
2534,1546,2393,2760, 737,2494,  13, 447, 245,2747,  38,2765,2129,2589,1079, 606,
 360, 471,3755,2890, 404, 848, 699,1785,1236, 370,2221,1023,3746,2074,2026,2023,
2388,1581,2119, 812,1141,3091,2536,1519, 804,2053, 406,1596,1090, 784, 548,4414,
1806,2264,2936,1100, 343,4114,5096, 622,3358, 743,3668,1510,1626,5020,3567,2513,
3195,4115,5627,2489,2991,  24,2065,2697,1087,2719,  48,1634, 315,  68, 985,2052,
 198,2239,1347,1107,1439, 597,2366,2172, 871,3307, 919,2487,2790,1867, 236,2570,
1413,3794, 906,3365,3381,1701,1982,1818,1524,2924,1205, 616,2586,2072,2004, 575,
 253,3099,  32,1365,1182, 197,1714,2454,1201, 554,3388,3224,2748, 756,2587, 250,
2567,1507,1517,3529,1922,2761,2337,3416,1961,1677,2452,2238,3153, 615, 911,1506,
1474,2495,1265,1906,2749,3756,3280,2161, 898,2714,1759,3450,2243,2444, 563,  26,
3286,2266,3769,3344,2707,3677, 611,1402, 531,1028,2871,4548,1375, 261,2948, 835,
1190,4134, 353, 840,2684,1900,3082,1435,2109,1207,1674, 329,1872,2781,4055,2686,
2104, 608,3318,2423,2957,2768,1108,3739,3512,3271,3985,2203,1771,3520,1418,2054,
1681,1153, 225,1627,2929, 162,2050,2511,3687,1954, 124,1859,2431,1684,3032,2894,
 585,4805,3969,2869,2704,2088,2032,2095,3656,2635,4362,2209, 256, 518,2042,2105,
3777,3657, 643,2298,1148,1779, 190, 989,3544, 414,  11,2135,2063,2979,1471, 403,
3678, 126, 770,1563, 671,2499,3216,2877, 600,1179, 307,2805,4937,1268,1297,2694,
 252,4032,1448,1494,1331,1394, 127,2256, 222,1647,1035,1481,3056,1915,1048, 873,
3651, 210,  33,1608,2516, 200,1520, 415, 102,   0,3389,1287, 817,  91,3299,2940,
 836,1814, 549,2197,1396,1669,2987,3582,2297,2848,4528,1070, 687,  20,1819, 121,
1552,1364,1461,1968,2617,3540,2824,2083, 177, 948,4938,2291, 110,4549,2066, 648,
3359,1755,2110,2114,4642,4845,1693,3937,3308,1257,1869,2123, 208,1804,3159,2992,
2531,2549,3361,2418,1350,2347,2800,2568,1291,2036,2680,  72, 842,1990, 212,1233,
1154,1586,  75,2027,3410,4900,1823,1337,2710,2676, 728,2810,1522,3026,4995, 157,
 755,1050,4022, 710, 785,1936,2194,2085,1406,2777,2400, 150,1250,4049,1206, 807,
1910, 534, 529,3309,1721,1660, 274,  39,2827, 661,2670,1578, 925,3248,3815,1094,
4278,4901,4252,  41,1150,3747,2572,2227,4501,3658,4902,3813,3357,3617,2884,2258,
 887, 538,4187,3199,1294,2439,3042,2329,2343,2497,1255, 107, 543,1527, 521,3478,
3568, 194,5062,  15, 961,3870,1241,1192,2664,  66,5215,3260,2111,1295,1127,2152,
3805,4135, 901,1164,1976, 398,1278, 530,1460, 748, 904,1054,1966,1426,  53,2909,
 509, 523,2279,1534, 536,1019, 239,1685, 460,2353, 673,1065,2401,3600,4298,2272,
1272,2363, 284,1753,3679,4064,1695,  81, 815,2677,2757,2731,1386, 859, 500,4221,
2190,2566, 757,1006,2519,2068,1166,1455, 337,2654,3203,1863,1682,1914,3025,1252,
1409,1366, 847, 714,2834,2038,3209, 964,2970,1901, 885,2553,1078,1756,3049, 301,
1572,3326, 688,2130,1996,2429,1805,1648,2930,3421,2750,3652,3088, 262,1158,1254,
 389,1641,1812, 526,1719, 923,2073,1073,1902, 468, 489,4625,1140, 857,2375,3070,
3319,2863, 380, 116,1328,2693,1161,2244, 273,1212,1884,2769,3011,1775,1142, 461,
3066,1200,2147,2212, 790, 702,2695,4222,1601,1058, 434,2338,5153,3640,  67,2360,
4099,2502, 618,3472,1329, 416,1132, 830,2782,1807,2653,3211,3510,1662, 192,2124,
 296,3979,1739,1611,3684,  23, 118, 324, 446,1239,1225, 293,2520,3814,3795,2535,
3116,  17,1074, 467,2692,2201, 387,2922,  45,1326,3055,1645,3659,2817, 958, 243,
1903,2320,1339,2825,1784,3289, 356, 576, 865,2315,2381,3377,3916,1088,3122,1713,
1655, 935, 628,4689,1034,1327, 441, 800, 720, 894,1979,2183,1528,5289,2702,1071,
4046,3572,2399,1571,3281,  79, 761,1103, 327, 134, 758,1899,1371,1615, 879, 442,
 215,2605,2579, 173,2048,2485,1057,2975,3317,1097,2253,3801,4263,1403,1650,2946,
 814,4968,3487,1548,2644,1567,1285,   2, 295,2636,  97, 946,3576, 832, 141,4257,
3273, 760,3821,3521,3156,2607, 949,1024,1733,1516,1803,1920,2125,2283,2665,3180,
1501,2064,3560,2171,1592, 803,3518,1416, 732,3897,4258,1363,1362,2458, 119,1427,
 602,1525,2608,1605,1639,3175, 694,3064,  10, 465,  76,2000,4846,4208, 444,3781,
1619,3353,2206,1273,3796, 740,2483, 320,1723,2377,3660,2619,1359,1137,1762,1724,
2345,2842,1850,1862, 912, 821,1866, 612,2625,1735,2573,3369,1093, 844,  89, 937,
 930,1424,3564,2413,2972,1004,3046,3019,2011, 711,3171,1452,4178, 428, 801,1943,
 432, 445,2811, 206,4136,1472, 730, 349,  73, 397,2802,2547, 998,1637,1167, 789,
 396,3217, 154,1218, 716,1120,1780,2819,4826,1931,3334,3762,2139,1215,2627, 552,
3664,3628,3232,1405,2383,3111,1356,2652,3577,3320,3101,1703, 640,1045,1370,1246,
4996, 371,1575,2436,1621,2210, 984,4033,1734,2638,  16,4529, 663,2755,3255,1451,
3917,2257,1253,1955,2234,1263,2951, 214,1229, 617, 485, 359,1831,1969, 473,2310,
 750,2058, 165,  80,2864,2419, 361,4344,2416,2479,1134, 796,3726,1266,2943, 860,
2715, 938, 390,2734,1313,1384, 248, 202, 877,1064,2854, 522,3907, 279,1602, 297,
2357, 395,3740, 137,2075, 944,4089,2584,1267,3802,  62,1533,2285, 178, 176, 780,
2440, 201,3707, 590, 478,1560,4354,2117,1075,  30,  74,4643,4004,1635,1441,2745,
 776,2596, 238,1077,1692,1912,2844, 605, 499,1742,3947, 241,3053, 980,1749, 936,
2640,4511,2582, 515,1543,2162,5322,2892,2993, 890,2148,1924, 665,1827,3581,1032,
 968,3163, 339,1044,1896, 270, 583,1791,1720,4367,1194,3488,3669,  43,2523,1657,
 163,2167, 290,1209,1622,3378, 550, 634,2508,2510, 695,2634,2384,2512,1476,1414,
 220,1469,2341,2138,2852,3183,2900,4939,2865,3502,1211,3680, 854,3227,1299,2976,
3172, 186,2998,1459, 443,1067,3251,1495, 321,1932,3054, 909, 753,1410,1828, 436,
2441,1119,1587,3164,2186,1258, 227, 231,1425,1890,3200,3942, 247, 959, 725,5254,
2741, 577,2158,2079, 929, 120, 174, 838,2813, 591,1115, 417,2024,  40,3240,1536,
1037, 291,4151,2354, 632,1298,2406,2500,3535,1825,1846,3451, 205,1171, 345,4238,
  18,1163, 811, 685,2208,1217, 425,1312,1508,1175,4308,2552,1033, 587,1381,3059,
2984,3482, 340,1316,4023,3972, 792,3176, 519, 777,4690, 918, 933,4130,2981,3741,
  90,3360,2911,2200,5184,4550, 609,3079,2030, 272,3379,2736, 363,3881,1130,1447,
 286, 779, 357,1169,3350,3137,1630,1220,2687,2391, 747,1277,3688,2618,2682,2601,
1156,3196,5290,4034,3102,1689,3596,3128, 874, 219,2783, 798, 508,1843,2461, 269,
1658,1776,1392,1913,2983,3287,2866,2159,2372, 829,4076,  46,4253,2873,1889,1894,
 915,1834,1631,2181,2318, 298, 664,2818,3555,2735, 954,3228,3117, 527,3511,2173,
 681,2712,3033,2247,2346,3467,1652, 155,2164,3382, 113,1994, 450, 899, 494, 994,
1237,2958,1875,2336,1926,3727, 545,1577,1550, 633,3473, 204,1305,3072,2410,1956,
2471, 707,2134, 841,2195,2196,2663,3843,1026,4940, 990,3252,4997, 368,1092, 437,
3212,3258,1933,1829, 675,2977,2893, 412, 943,3723,4644,3294,3283,2230,2373,5154,
2389,2241,2661,2323,1404,2524, 593, 787, 677,3008,1275,2059, 438,2709,2609,2240,
2269,2246,1446,  36,1568,1373,3892,1574,2301,1456,3962, 693,2276,5216,2035,1143,
2720,1919,1797,1811,2763,4137,2597,1830,1699,1488,1198,2090, 424,1694, 312,3634,
3390,4179,3335,2252,1214, 561,1059,3243,2295,2561, 975,5155,2321,2751,3772, 472,
1537,3282,3398,1047,2077,2348,2878,1323,3340,3076, 690,2906,  51, 369, 170,3541,
1060,2187,2688,3670,2541,1083,1683, 928,3918, 459, 109,4427, 599,3744,4286, 143,
2101,2730,2490,  82,1588,3036,2121, 281,1860, 477,4035,1238,2812,3020,2716,3312,
1530,2188,2055,1317, 843, 636,1808,1173,3495, 649, 181,1002, 147,3641,1159,2414,
3750,2289,2795, 813,3123,2610,1136,4368,   5,3391,4541,2174, 420, 429,1728, 754,
1228,2115,2219, 347,2223,2733, 735,1518,3003,2355,3134,1764,3948,3329,1888,2424,
1001,1234,1972,3321,3363,1672,1021,1450,1584, 226, 765, 655,2526,3404,3244,2302,
3665, 731, 594,2184, 319,1576, 621, 658,2656,4299,2099,3864,1279,2071,2598,2739,
 795,3086,3699,3908,1707,2352,2402,1382,3136,2475,1465,4847,3496,3865,1085,3004,
2591,1084, 213,2287,1963,3565,2250, 822, 793,4574,3187,1772,1789,3050, 595,1484,
1959,2770,1080,2650, 456, 422,2996, 940,3322,4328,4345,3092,2742, 965,2784, 739,
4124, 952,1358,2498,2949,2565, 332,2698,2378, 660,2260,2473,4194,3856,2919, 535,
1260,2651,1208,1428,1300,1949,1303,2942, 433,2455,2450,1251,1946, 614,1269, 641,
1306,1810,2737,3078,2912, 564,2365,1419,1415,1497,4460,2367,2185,1379,3005,1307,
3218,2175,1897,3063, 682,1157,4040,4005,1712,1160,1941,1399, 394, 402,2952,1573,
1151,2986,2404, 862, 299,2033,1489,3006, 346, 171,2886,3401,1726,2932, 168,2533,
  47,2507,1030,3735,1145,3370,1395,1318,1579,3609,4560,2857,4116,1457,2529,1965,
 504,1036,2690,2988,2405, 745,5871, 849,2397,2056,3081, 863,2359,3857,2096,  99,
1397,1769,2300,4428,1643,3455,1978,1757,3718,1440,  35,4879,3742,1296,4228,2280,
 160,5063,1599,2013, 166, 520,3479,1646,3345,3012, 490,1937,1545,1264,2182,2505,
1096,1188,1369,1436,2421,1667,2792,2460,1270,2122, 727,3167,2143, 806,1706,1012,
1800,3037, 960,2218,1882, 805, 139,2456,1139,1521, 851,1052,3093,3089, 342,2039,
 744,5097,1468,1502,1585,2087, 223, 939, 326,2140,2577, 892,2481,1623,4077, 982,
3708, 135,2131,  87,2503,3114,2326,1106, 876,1616, 547,2997,2831,2093,3441,4530,
4314,   9,3256,4229,4148, 659,1462,1986,1710,2046,2913,2231,4090,4880,5255,3392,
3274,1368,3689,4645,1477, 705,3384,3635,1068,1529,2941,1458,3782,1509, 100,1656,
2548, 718,2339, 408,1590,2780,3548,1838,4117,3719,1345,3530, 717,3442,2778,3220,
2898,1892,4590,3614,3371,2043,1998,1224,3483, 891, 635, 584,2559,3355, 733,1766,
1729,1172,3789,1891,2307, 781,2982,2271,1957,1580,5773,2633,2005,4195,3097,1535,
3213,1189,1934,5693,3262, 586,3118,1324,1598, 517,1564,2217,1868,1893,4445,3728,
2703,3139,1526,1787,1992,3882,2875,1549,1199,1056,2224,1904,2711,5098,4287, 338,
1993,3129,3489,2689,1809,2815,1997, 957,1855,3898,2550,3275,3057,1105,1319, 627,
1505,1911,1883,3526, 698,3629,3456,1833,1431, 746,  77,1261,2017,2296,1977,1885,
 125,1334,1600, 525,1798,1109,2222,1470,1945, 559,2236,1186,3443,2476,1929,1411,
2411,3135,1777,3372,2621,1841,1613,3229, 668,1430,1839,2643,2916, 195,1989,2671,
2358,1387, 629,3205,2293,5256,4439, 123,1310, 888,1879,4300,3021,3605,1003,1162,
3192,2910,2010, 140,2395,2859,  55,1082,2012,2901, 662, 419,2081,1438, 680,2774,
4654,3912,1620,1731,1625,5035,4065,2328, 512,1344, 802,5443,2163,2311,2537, 524,
3399,  98,1155,2103,1918,2606,3925,2816,1393,2465,1504,3773,2177,3963,1478,4346,
 180,1113,4655,3461,2028,1698, 833,2696,1235,1322,1594,4408,3623,3013,3225,2040,
3022, 541,2881, 607,3632,2029,1665,1219, 639,1385,1686,1099,2803,3231,1938,3188,
2858, 427, 676,2772,1168,2025, 454,3253,2486,3556, 230,1950, 580, 791,1991,1280,
1086,1974,2034, 630, 257,3338,2788,4903,1017,  86,4790, 966,2789,1995,1696,1131,
 259,3095,4188,1308, 179,1463,5257, 289,4107,1248,  42,3413,1725,2288, 896,1947,
 774,4474,4254, 604,3430,4264, 392,2514,2588, 452, 237,1408,3018, 988,4531,1970,
3034,3310, 540,2370,1562,1288,2990, 502,4765,1147,   4,1853,2708, 207, 294,2814,
4078,2902,2509, 684,  34,3105,3532,2551, 644, 709,2801,2344, 573,1727,3573,3557,
2021,1081,3100,4315,2100,3681, 199,2263,1837,2385, 146,3484,1195,2776,3949, 997,
1939,3973,1008,1091,1202,1962,1847,1149,4209,5444,1076, 493, 117,5400,2521, 972,
1490,2934,1796,4542,2374,1512,2933,2657, 413,2888,1135,2762,2314,2156,1355,2369,
 766,2007,2527,2170,3124,2491,2593,2632,4757,2437, 234,3125,3591,1898,1750,1376,
1942,3468,3138, 570,2127,2145,3276,4131, 962, 132,1445,4196,  19, 941,3624,3480,
3366,1973,1374,4461,3431,2629, 283,2415,2275, 808,2887,3620,2112,2563,1353,3610,
 955,1089,3103,1053,  96,  88,4097, 823,3808,1583, 399, 292,4091,3313, 421,1128,
 642,4006, 903,2539,1877,2082, 596,  29,4066,1790, 722,2157, 130, 995,1569, 769,
1485, 464, 513,2213, 288,1923,1101,2453,4316, 133, 486,2445,  50, 625, 487,2207,
  57, 423, 481,2962, 159,3729,1558, 491, 303, 482, 501, 240,2837, 112,3648,2392,
1783, 362,   8,3433,3422, 610,2793,3277,1390,1284,1654,  21,3823, 734, 367, 623,
 193, 287, 374,1009,1483, 816, 476, 313,2255,2340,1262,2150,2899,1146,2581, 782,
2116,1659,2018,1880, 255,3586,3314,1110,2867,2137,2564, 986,2767,5185,2006, 650,
 158, 926, 762, 881,3157,2717,2362,3587, 306,3690,3245,1542,3077,2427,1691,2478,
2118,2985,3490,2438, 539,2305, 983, 129,1754, 355,4201,2386, 827,2923, 104,1773,
2838,2771, 411,2905,3919, 376, 767, 122,1114, 828,2422,1817,3506, 266,3460,1007,
1609,4998, 945,2612,4429,2274, 726,1247,1964,2914,2199,2070,4002,4108, 657,3323,
1422, 579, 455,2764,4737,1222,2895,1670, 824,1223,1487,2525, 558, 861,3080, 598,
2659,2515,1967, 752,2583,2376,2214,4180, 977, 704,2464,4999,2622,4109,1210,2961,
 819,1541, 142,2284,  44, 418, 457,1126,3730,4347,4626,1644,1876,3671,1864, 302,
1063,5694, 624, 723,1984,3745,1314,1676,2488,1610,1449,3558,3569,2166,2098, 409,
1011,2325,3704,2306, 818,1732,1383,1824,1844,3757, 999,2705,3497,1216,1423,2683,
2426,2954,2501,2726,2229,1475,2554,5064,1971,1794,1666,2014,1343, 783, 724, 191,
2434,1354,2220,5065,1763,2752,2472,4152, 131, 175,2885,3434,  92,1466,4920,2616,
3871,3872,3866, 128,1551,1632, 669,1854,3682,4691,4125,1230, 188,2973,3290,1302,
1213, 560,3266, 917, 763,3909,3249,1760, 868,1958, 764,1782,2097, 145,2277,3774,
4462,  64,1491,3062, 971,2132,3606,2442, 221,1226,1617, 218, 323,1185,3207,3147,
 571, 619,1473,1005,1744,2281, 449,1887,2396,3685, 275, 375,3816,1743,3844,3731,
 845,1983,2350,4210,1377, 773, 967,3499,3052,3743,2725,4007,1697,1022,3943,1464,
3264,2855,2722,1952,1029,2839,2467,  84,4383,2215, 820,1391,2015,2448,3672, 377,
1948,2168, 797,2545,3536,2578,2645,  94,2874,1678, 405,1259,3071, 771, 546,1315,
 470,1243,3083, 895,2468, 981, 969,2037, 846,4181, 653,1276,2928,  14,2594, 557,
3007,2474, 156, 902,1338,1740,2574, 537,2518, 973,2282,2216,2433,1928, 138,2903,
1293,2631,1612, 646,3457, 839,2935, 111, 496,2191,2847, 589,3186, 149,3994,2060,
4031,2641,4067,3145,1870,  37,3597,2136,1025,2051,3009,3383,3549,1121,1016,3261,
1301, 251,2446,2599,2153, 872,3246, 637, 334,3705, 831, 884, 921,3065,3140,4092,
2198,1944, 246,2964, 108,2045,1152,1921,2308,1031, 203,3173,4170,1907,3890, 810,
1401,2003,1690, 506, 647,1242,2828,1761,1649,3208,2249,1589,3709,2931,5156,1708,
 498, 666,2613, 834,3817,1231, 184,2851,1124, 883,3197,2261,3710,1765,1553,2658,
1178,2639,2351,  93,1193, 942,2538,2141,4402, 235,1821, 870,1591,2192,1709,1871,
3341,1618,4126,2595,2334, 603, 651,  69, 701, 268,2662,3411,2555,1380,1606, 503,
 448, 254,2371,2646, 574,1187,2309,1770, 322,2235,1292,1801, 305, 566,1133, 229,
2067,2057, 706, 167, 483,2002,2672,3295,1820,3561,3067, 316, 378,2746,3452,1112,
 136,1981, 507,1651,2917,1117, 285,4591, 182,2580,3522,1304, 335,3303,1835,2504,
1795,1792,2248, 674,1018,2106,2449,1857,2292,2845, 976,3047,1781,2600,2727,1389,
1281,  52,3152, 153, 265,3950, 672,3485,3951,4463, 430,1183, 365, 278,2169,  27,
1407,1336,2304, 209,1340,1730,2202,1852,2403,2883, 979,1737,1062, 631,2829,2542,
3876,2592, 825,2086,2226,3048,3625, 352,1417,3724, 542, 991, 431,1351,3938,1861,
2294, 826,1361,2927,3142,3503,1738, 463,2462,2723, 582,1916,1595,2808, 400,3845,
3891,2868,3621,2254,  58,2492,1123, 910,2160,2614,1372,1603,1196,1072,3385,1700,
3267,1980, 696, 480,2430, 920, 799,1570,2920,1951,2041,4047,2540,1321,4223,2469,
3562,2228,1271,2602, 401,2833,3351,2575,5157, 907,2312,1256, 410, 263,3507,1582,
 996, 678,1849,2316,1480, 908,3545,2237, 703,2322, 667,1826,2849,1531,2604,2999,
2407,3146,2151,2630,1786,3711, 469,3542, 497,3899,2409, 858, 837,4446,3393,1274,
 786, 620,1845,2001,3311, 484, 308,3367,1204,1815,3691,2332,1532,2557,1842,2020,
2724,1927,2333,4440, 567,  22,1673,2728,4475,1987,1858,1144,1597, 101,1832,3601,
  12, 974,3783,4391, 951,1412,   1,3720, 453,4608,4041, 528,1041,1027,3230,2628,
1129, 875,1051,3291,1203,2262,1069,2860,2799,2149,2615,3278, 144,1758,3040,  31,
 475,1680, 366,2685,3184, 311,1642,4008,2466,5036,1593,1493,2809, 216,1420,1668,
 233, 304,2128,3284, 232,1429,1768,1040,2008,3407,2740,2967,2543, 242,2133, 778,
1565,2022,2620, 505,2189,2756,1098,2273, 372,1614, 708, 553,2846,2094,2278, 169,
3626,2835,4161, 228,2674,3165, 809,1454,1309, 466,1705,1095, 900,3423, 880,2667,
3751,5258,2317,3109,2571,4317,2766,1503,1342, 866,4447,1118,  63,2076, 314,1881,
1348,1061, 172, 978,3515,1747, 532, 511,3970,   6, 601, 905,2699,3300,1751, 276,
1467,3725,2668,  65,4239,2544,2779,2556,1604, 578,2451,1802, 992,2331,2624,1320,
3446, 713,1513,1013, 103,2786,2447,1661, 886,1702, 916, 654,3574,2031,1556, 751,
2178,2821,2179,1498,1538,2176, 271, 914,2251,2080,1325, 638,1953,2937,3877,2432,
2754,  95,3265,1716, 260,1227,4083, 775, 106,1357,3254, 426,1607, 555,2480, 772,
1985, 244,2546, 474, 495,1046,2611,1851,2061,  71,2089,1675,2590, 742,3758,2843,
3222,1433, 267,2180,2576,2826,2233,2092,3913,2435, 956,1745,3075, 856,2113,1116,
 451,   3,1988,2896,1398, 993,2463,1878,2049,1341,2718,2721,2870,2108, 712,2904,
4363,2753,2324, 277,2872,2349,2649, 384, 987, 435, 691,3000, 922, 164,3939, 652,
1500,1184,4153,2482,3373,2165,4848,2335,3775,3508,3154,2806,2830,1554,2102,1664,
2530,1434,2408, 893,1547,2623,3447,2832,2242,2532,3169,2856,3223,2078,  49,3770,
3469, 462, 318, 656,2259,3250,3069, 679,1629,2758, 344,1138,1104,3120,1836,1283,
3115,2154,1437,4448, 934, 759,1999, 794,2862,1038, 533,2560,1722,2342, 855,2626,
1197,1663,4476,3127,  85,4240,2528,  25,1111,1181,3673, 407,3470,4561,2679,2713,
 768,1925,2841,3986,1544,1165, 932, 373,1240,2146,1930,2673, 721,4766, 354,4333,
 391,2963, 187,  61,3364,1442,1102, 330,1940,1767, 341,3809,4118, 393,2496,2062,
2211, 105, 331, 300, 439, 913,1332, 626, 379,3304,1557, 328, 689,3952, 309,1555,
 931, 317,2517,3027, 325, 569, 686,2107,3084,  60,1042,1333,2794, 264,3177,4014,
1628, 258,3712,   7,4464,1176,1043,1778, 683, 114,1975,  78,1492, 383,1886, 510,
 386, 645,5291,2891,2069,3305,4138,3867,2939,2603,2493,1935,1066,1848,3588,1015,
1282,1289,4609, 697,1453,3044,2666,3611,1856,2412,  54, 719,1330, 568,3778,2459,
1748, 788, 492, 551,1191,1000, 488,3394,3763, 282,1799, 348,2016,1523,3155,2390,
1049, 382,2019,1788,1170, 729,2968,3523, 897,3926,2785,2938,3292, 350,2319,3238,
1718,1717,2655,3453,3143,4465, 161,2889,2980,2009,1421,  56,1908,1640,2387,2232,
1917,1874,2477,4921, 148,  83,3438, 592,4245,2882,1822,1055, 741, 115,1496,1624,
 381,1638,4592,1020, 516,3214, 458, 947,4575,1432, 211,1514,2926,1865,2142, 189,
 852,1221,1400,1486, 882,2299,4036, 351,  28,1122, 700,6479,6480,6481,6482,6483,  #last 512
)

site-packages/pip/_vendor/chardet/chardistribution.py000064400000022303151446177000017056 0ustar00######################## BEGIN LICENSE BLOCK ########################
# The Original Code is Mozilla Communicator client code.
#
# The Initial Developer of the Original Code is
# Netscape Communications Corporation.
# Portions created by the Initial Developer are Copyright (C) 1998
# the Initial Developer. All Rights Reserved.
#
# Contributor(s):
#   Mark Pilgrim - port to Python
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
# 02110-1301  USA
######################### END LICENSE BLOCK #########################

from .euctwfreq import (EUCTW_CHAR_TO_FREQ_ORDER, EUCTW_TABLE_SIZE,
                        EUCTW_TYPICAL_DISTRIBUTION_RATIO)
from .euckrfreq import (EUCKR_CHAR_TO_FREQ_ORDER, EUCKR_TABLE_SIZE,
                        EUCKR_TYPICAL_DISTRIBUTION_RATIO)
from .gb2312freq import (GB2312_CHAR_TO_FREQ_ORDER, GB2312_TABLE_SIZE,
                         GB2312_TYPICAL_DISTRIBUTION_RATIO)
from .big5freq import (BIG5_CHAR_TO_FREQ_ORDER, BIG5_TABLE_SIZE,
                       BIG5_TYPICAL_DISTRIBUTION_RATIO)
from .jisfreq import (JIS_CHAR_TO_FREQ_ORDER, JIS_TABLE_SIZE,
                      JIS_TYPICAL_DISTRIBUTION_RATIO)


class CharDistributionAnalysis(object):
    ENOUGH_DATA_THRESHOLD = 1024
    SURE_YES = 0.99
    SURE_NO = 0.01
    MINIMUM_DATA_THRESHOLD = 3

    def __init__(self):
        # Mapping table to get frequency order from char order (get from
        # GetOrder())
        self._char_to_freq_order = None
        self._table_size = None  # Size of above table
        # This is a constant value which varies from language to language,
        # used in calculating confidence.  See
        # http://www.mozilla.org/projects/intl/UniversalCharsetDetection.html
        # for further detail.
        self.typical_distribution_ratio = None
        self._done = None
        self._total_chars = None
        self._freq_chars = None
        self.reset()

    def reset(self):
        """reset analyser, clear any state"""
        # If this flag is set to True, detection is done and conclusion has
        # been made
        self._done = False
        self._total_chars = 0  # Total characters encountered
        # The number of characters whose frequency order is less than 512
        self._freq_chars = 0

    def feed(self, char, char_len):
        """feed a character with known length"""
        if char_len == 2:
            # we only care about 2-bytes character in our distribution analysis
            order = self.get_order(char)
        else:
            order = -1
        if order >= 0:
            self._total_chars += 1
            # order is valid
            if order < self._table_size:
                if 512 > self._char_to_freq_order[order]:
                    self._freq_chars += 1

    def get_confidence(self):
        """return confidence based on existing data"""
        # if we didn't receive any character in our consideration range,
        # return negative answer
        if self._total_chars <= 0 or self._freq_chars <= self.MINIMUM_DATA_THRESHOLD:
            return self.SURE_NO

        if self._total_chars != self._freq_chars:
            r = (self._freq_chars / ((self._total_chars - self._freq_chars)
                 * self.typical_distribution_ratio))
            if r < self.SURE_YES:
                return r

        # normalize confidence (we don't want to be 100% sure)
        return self.SURE_YES

    def got_enough_data(self):
        # It is not necessary to receive all data to draw conclusion.
        # For charset detection, certain amount of data is enough
        return self._total_chars > self.ENOUGH_DATA_THRESHOLD

    def get_order(self, byte_str):
        # We do not handle characters based on the original encoding string,
        # but convert this encoding string to a number, here called order.
        # This allows multiple encodings of a language to share one frequency
        # table.
        return -1


class EUCTWDistributionAnalysis(CharDistributionAnalysis):
    def __init__(self):
        super(EUCTWDistributionAnalysis, self).__init__()
        self._char_to_freq_order = EUCTW_CHAR_TO_FREQ_ORDER
        self._table_size = EUCTW_TABLE_SIZE
        self.typical_distribution_ratio = EUCTW_TYPICAL_DISTRIBUTION_RATIO

    def get_order(self, byte_str):
        # for euc-TW encoding, we are interested
        #   first  byte range: 0xc4 -- 0xfe
        #   second byte range: 0xa1 -- 0xfe
        # no validation needed here. State machine has done that
        first_char = byte_str[0]
        if first_char >= 0xC4:
            return 94 * (first_char - 0xC4) + byte_str[1] - 0xA1
        else:
            return -1


class EUCKRDistributionAnalysis(CharDistributionAnalysis):
    def __init__(self):
        super(EUCKRDistributionAnalysis, self).__init__()
        self._char_to_freq_order = EUCKR_CHAR_TO_FREQ_ORDER
        self._table_size = EUCKR_TABLE_SIZE
        self.typical_distribution_ratio = EUCKR_TYPICAL_DISTRIBUTION_RATIO

    def get_order(self, byte_str):
        # for euc-KR encoding, we are interested
        #   first  byte range: 0xb0 -- 0xfe
        #   second byte range: 0xa1 -- 0xfe
        # no validation needed here. State machine has done that
        first_char = byte_str[0]
        if first_char >= 0xB0:
            return 94 * (first_char - 0xB0) + byte_str[1] - 0xA1
        else:
            return -1


class GB2312DistributionAnalysis(CharDistributionAnalysis):
    def __init__(self):
        super(GB2312DistributionAnalysis, self).__init__()
        self._char_to_freq_order = GB2312_CHAR_TO_FREQ_ORDER
        self._table_size = GB2312_TABLE_SIZE
        self.typical_distribution_ratio = GB2312_TYPICAL_DISTRIBUTION_RATIO

    def get_order(self, byte_str):
        # for GB2312 encoding, we are interested
        #  first  byte range: 0xb0 -- 0xfe
        #  second byte range: 0xa1 -- 0xfe
        # no validation needed here. State machine has done that
        first_char, second_char = byte_str[0], byte_str[1]
        if (first_char >= 0xB0) and (second_char >= 0xA1):
            return 94 * (first_char - 0xB0) + second_char - 0xA1
        else:
            return -1


class Big5DistributionAnalysis(CharDistributionAnalysis):
    def __init__(self):
        super(Big5DistributionAnalysis, self).__init__()
        self._char_to_freq_order = BIG5_CHAR_TO_FREQ_ORDER
        self._table_size = BIG5_TABLE_SIZE
        self.typical_distribution_ratio = BIG5_TYPICAL_DISTRIBUTION_RATIO

    def get_order(self, byte_str):
        # for big5 encoding, we are interested
        #   first  byte range: 0xa4 -- 0xfe
        #   second byte range: 0x40 -- 0x7e , 0xa1 -- 0xfe
        # no validation needed here. State machine has done that
        first_char, second_char = byte_str[0], byte_str[1]
        if first_char >= 0xA4:
            if second_char >= 0xA1:
                return 157 * (first_char - 0xA4) + second_char - 0xA1 + 63
            else:
                return 157 * (first_char - 0xA4) + second_char - 0x40
        else:
            return -1


class SJISDistributionAnalysis(CharDistributionAnalysis):
    def __init__(self):
        super(SJISDistributionAnalysis, self).__init__()
        self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
        self._table_size = JIS_TABLE_SIZE
        self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO

    def get_order(self, byte_str):
        # for sjis encoding, we are interested
        #   first  byte range: 0x81 -- 0x9f , 0xe0 -- 0xfe
        #   second byte range: 0x40 -- 0x7e,  0x81 -- oxfe
        # no validation needed here. State machine has done that
        first_char, second_char = byte_str[0], byte_str[1]
        if (first_char >= 0x81) and (first_char <= 0x9F):
            order = 188 * (first_char - 0x81)
        elif (first_char >= 0xE0) and (first_char <= 0xEF):
            order = 188 * (first_char - 0xE0 + 31)
        else:
            return -1
        order = order + second_char - 0x40
        if second_char > 0x7F:
            order = -1
        return order


class EUCJPDistributionAnalysis(CharDistributionAnalysis):
    def __init__(self):
        super(EUCJPDistributionAnalysis, self).__init__()
        self._char_to_freq_order = JIS_CHAR_TO_FREQ_ORDER
        self._table_size = JIS_TABLE_SIZE
        self.typical_distribution_ratio = JIS_TYPICAL_DISTRIBUTION_RATIO

    def get_order(self, byte_str):
        # for euc-JP encoding, we are interested
        #   first  byte range: 0xa0 -- 0xfe
        #   second byte range: 0xa1 -- 0xfe
        # no validation needed here. State machine has done that
        char = byte_str[0]
        if char >= 0xA0:
            return 94 * (char - 0xA1) + byte_str[1] - 0xa1
        else:
            return -1
site-packages/pip/_vendor/__pycache__/ipaddress.cpython-38.pyc000064400000176416151446177000020352 0ustar00U

��.e�7�@sldZddlmZddlZddlZdZefZzeefZWne	k
rJYnXze
ZWn$e	k
rxeZe
ekstt�YnXddkr�dd�Zndd�Zz
ejZWnek
r�dd	�ZYnXd
d�Zeed�r�d
d�Zndd�ZdNdd�ZGdd�de�ZdZdZGdd�de�ZGdd�de�Zdd�ZdOdd�Zd d!�Z d"d#�Z!d$d%�Z"d&d'�Z#d(d)�Z$d*d+�Z%d,d-�Z&d.d/�Z'd0d1�Z(d2d3�Z)Gd4d5�d5e�Z*Gd6d7�d7e*�Z+Gd8d9�d9e*�Z,Gd:d;�d;e�Z-Gd<d=�d=e-e+�Z.Gd>d?�d?e.�Z/Gd@dA�dAe-e,�Z0GdBdC�dCe�Z1e1e._2GdDdE�dEe�Z3GdFdG�dGe3e+�Z4GdHdI�dIe4�Z5GdJdK�dKe3e,�Z6GdLdM�dMe�Z7e7e4_2dS)Pz�A fast, lightweight IPv4/IPv6 manipulation library in Python.

This library is used to create/poke/manipulate IPv4 and IPv6 addresses
and networks.

�)�unicode_literalsNz1.0.22cCs|S�N��Zbytrr�9/usr/lib/python3.8/site-packages/pip/_vendor/ipaddress.py�_compat_bytes_to_byte_valssrcCsdd�|D�S)NcSsg|]}t�d|�d�qS)�!Br)�struct�unpack��.0�brrr�
<listcomp>#sz._compat_bytes_to_byte_vals.<locals>.<listcomp>rrrrrr"scCs8|dkst�d}|D]}t|t�s&t�|d>|}q|S)N�bigr�)�AssertionError�
isinstance�_compat_int_types)Zbytvals�	endianess�resZbvrrr�_compat_int_from_byte_vals'srcCs�t|t�st�|dkst�|dkrH|dks2|dkr<t�d��t�d|�S|dkr�|dksd|dd	krnt�d
��t�d|d?|d
@�St��dS)Nr�rlz(integer out of range for 'I' format codes!I���z)integer out of range for 'QQ' format codes!QQ�@l����)rrrr	�error�pack�NotImplementedError)ZintvalZlengthrrrr�_compat_to_bytes0s

r�
bit_lengthcCs|��Sr)r )�irrr�_compat_bit_lengthAsr"cCs&t��D]}||?dkr|SqdS�Nr)�	itertools�count)r!rrrrr"Ds�ccs,|dkst�|}||kr(|V||7}qdSr#)r)�start�end�stepr!rrr�
_compat_rangeJs
r*c@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)�_TotalOrderingMixinrcCst�dSr�r��self�otherrrr�__eq__Ysz_TotalOrderingMixin.__eq__cCs|�|�}|tkrtS|Sr)r0�NotImplemented)r.r/�equalrrr�__ne__\s
z_TotalOrderingMixin.__ne__cCst�dSrr,r-rrr�__lt__bsz_TotalOrderingMixin.__lt__cCs$|�|�}|tks|s |�|�S|Sr�r4r1r0�r.r/�lessrrr�__le__es

z_TotalOrderingMixin.__le__cCs6|�|�}|tkrtS|�|�}|tkr,tS|p2|Srr5)r.r/r7r2rrr�__gt__ks

z_TotalOrderingMixin.__gt__cCs|�|�}|tkrtS|Sr)r4r1r6rrr�__ge__ts
z_TotalOrderingMixin.__ge__N)
�__name__�
__module__�__qualname__�	__slots__r0r3r4r8r9r:rrrrr+Rs	r+� rc@seZdZdZdS)�AddressValueErrorz%A Value Error related to the address.N�r;r<r=�__doc__rrrrr@sr@c@seZdZdZdS)�NetmaskValueErrorz%A Value Error related to the netmask.NrArrrrrC�srCc	Csnz
t|�WSttfk
r"YnXz
t|�WSttfk
rFYnXt|t�r^td|��td|��dS)a�Take an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP address.  Either IPv4 or
          IPv6 addresses may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Address or IPv6Address object.

    Raises:
        ValueError: if the *address* passed isn't either a v4 or a v6
          address

    zx%r does not appear to be an IPv4 or IPv6 address. Did you pass in a bytes (str in Python 2) instead of a unicode object?z0%r does not appear to be an IPv4 or IPv6 addressN)�IPv4Addressr@rC�IPv6Addressr�bytes�
ValueError��addressrrr�
ip_address�s"


���rJTc	Csrzt||�WSttfk
r$YnXzt||�WSttfk
rJYnXt|t�rbtd|��td|��dS)a�Take an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP network.  Either IPv4 or
          IPv6 networks may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Network or IPv6Network object.

    Raises:
        ValueError: if the string passed isn't either a v4 or a v6
          address. Or if the network has host bits set.

    zx%r does not appear to be an IPv4 or IPv6 network. Did you pass in a bytes (str in Python 2) instead of a unicode object?z0%r does not appear to be an IPv4 or IPv6 networkN)�IPv4Networkr@rC�IPv6NetworkrrFrG)rI�strictrrr�
ip_network�s"
���rNc	CsXz
t|�WSttfk
r"YnXz
t|�WSttfk
rFYnXtd|��dS)agTake an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP address.  Either IPv4 or
          IPv6 addresses may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Interface or IPv6Interface object.

    Raises:
        ValueError: if the string passed isn't either a v4 or a v6
          address.

    Notes:
        The IPv?Interface classes describe an Address on a particular
        Network, so they're basically a combination of both the Address
        and Network classes.

    z2%r does not appear to be an IPv4 or IPv6 interfaceN)�
IPv4Interfacer@rC�
IPv6InterfacerGrHrrr�ip_interface�s

�rQc	Cs6zt|dd�WStjtfk
r0td��YnXdS)a`Represent an address as 4 packed bytes in network (big-endian) order.

    Args:
        address: An integer representation of an IPv4 IP address.

    Returns:
        The integer address packed as 4 bytes in network (big-endian) order.

    Raises:
        ValueError: If the integer is negative or too large to be an
          IPv4 IP address.

    rrz&Address negative or too large for IPv4N�rr	r�
OverflowErrorrGrHrrr�v4_int_to_packed�srTc	Cs6zt|dd�WStjtfk
r0td��YnXdS)z�Represent an address as 16 packed bytes in network (big-endian) order.

    Args:
        address: An integer representation of an IPv6 IP address.

    Returns:
        The integer address packed as 16 bytes in network (big-endian) order.

    rrz&Address negative or too large for IPv6NrRrHrrr�v6_int_to_packeds
rUcCs*t|��d�}t|�dkr&td|��|S)zAHelper to split the netmask and raise AddressValueError if needed�/rzOnly one '/' permitted in %r)�_compat_str�split�lenr@)rI�addrrrr�_split_optional_netmasksr[ccsNt|�}t|�}}|D]&}|j|jdkr:||fV|}|}q||fVdS)z�Find a sequence of sorted deduplicated IPv#Address.

    Args:
        addresses: a list of IPv#Address objects.

    Yields:
        A tuple containing the first and last IP addresses in the sequence.

    r&N)�iter�next�_ip)�	addresses�it�first�last�iprrr�_find_address_ranges

rdcCs$|dkr|St|t||d@��S)z�Count the number of zero bits on the right hand side.

    Args:
        number: an integer.
        bits: maximum number of bits to count.

    Returns:
        The number of zero bits on the right hand side of the number.

    rr&)�minr")Znumber�bitsrrr�_count_righthand_zero_bits2srgccs�t|t�rt|t�std��|j|jkr8td||f��||krHtd��|jdkrXt}n|jdkrht}ntd��|j}|j}|j}||kr�t	t
||�t||d�d�}||||f�}|V|d|>7}|d|jkr�q�q�dS)	a�Summarize a network range given the first and last IP addresses.

    Example:
        >>> list(summarize_address_range(IPv4Address('192.0.2.0'),
        ...                              IPv4Address('192.0.2.130')))
        ...                                #doctest: +NORMALIZE_WHITESPACE
        [IPv4Network('192.0.2.0/25'), IPv4Network('192.0.2.128/31'),
         IPv4Network('192.0.2.130/32')]

    Args:
        first: the first IPv4Address or IPv6Address in the range.
        last: the last IPv4Address or IPv6Address in the range.

    Returns:
        An iterator of the summarized IPv(4|6) network objects.

    Raise:
        TypeError:
            If the first and last objects are not IP addresses.
            If the first and last objects are not the same version.
        ValueError:
            If the last object is not greater than the first.
            If the version of the first address is not 4 or 6.

    z1first and last must be IP addresses, not networks�%%s and %s are not of the same versionz*last IP address must be greater than firstr�zunknown IP versionr&N)
r�_BaseAddress�	TypeError�versionrGrKrL�_max_prefixlenr^rergr"�	_ALL_ONES)rarbrcZip_bitsZ	first_intZlast_intZnbits�netrrr�summarize_address_rangeBs8
��


�rpccs�t|�}i}|rV|��}|��}|�|�}|dkr<|||<q||kr||=|�|�qd}t|���D]$}|dk	r�|j|jkr�qf|V|}qfdS)auLoops through the addresses, collapsing concurrent netblocks.

    Example:

        ip1 = IPv4Network('192.0.2.0/26')
        ip2 = IPv4Network('192.0.2.64/26')
        ip3 = IPv4Network('192.0.2.128/26')
        ip4 = IPv4Network('192.0.2.192/26')

        _collapse_addresses_internal([ip1, ip2, ip3, ip4]) ->
          [IPv4Network('192.0.2.0/24')]

        This shouldn't be called directly; it is called via
          collapse_addresses([]).

    Args:
        addresses: A list of IPv4Network's or IPv6Network's

    Returns:
        A list of IPv4Network's or IPv6Network's depending on what we were
        passed.

    N)�list�pop�supernet�get�append�sorted�values�broadcast_address)r_Zto_merge�subnetsrorsZexistingrbrrr�_collapse_addresses_internalys$

rzc	Cs0g}g}g}|D]�}t|t�rR|rF|dj|jkrFtd||df��|�|�q|j|jkr�|r�|dj|jkr�td||df��z|�|j�Wq�tk
r�|�|j	�Yq�Xq|r�|dj|jkr�td||df��|�|�qt
t|��}|�r$t|�D]\}}|�
t||���qt||�S)a�Collapse a list of IP objects.

    Example:
        collapse_addresses([IPv4Network('192.0.2.0/25'),
                            IPv4Network('192.0.2.128/25')]) ->
                           [IPv4Network('192.0.2.0/24')]

    Args:
        addresses: An iterator of IPv4Network or IPv6Network objects.

    Returns:
        An iterator of the collapsed IPv(4|6)Network objects.

    Raises:
        TypeError: If passed a list of mixed version objects.

    ���rh)rrj�_versionrkru�
_prefixlenrmrc�AttributeError�network_addressrv�setrd�extendrprz)r_ZaddrsZipsZnetsrcrarbrrr�collapse_addresses�s@
���r�cCs(t|t�r|��St|t�r$|��StS)a2Return a key suitable for sorting between networks and addresses.

    Address and Network objects are not sortable by default; they're
    fundamentally different so the expression

        IPv4Address('192.0.2.0') <= IPv4Network('192.0.2.0/24')

    doesn't make any sense.  There are some times however, where you may wish
    to have ipaddress sort these for you anyway. If you need to do this, you
    can use this function as the key= argument to sorted().

    Args:
      obj: either a Network or Address object.
    Returns:
      appropriate key.

    )r�_BaseNetwork�_get_networks_keyrj�_get_address_keyr1)�objrrr�get_mixed_type_key�s


r�c@s�eZdZdZdZedd��Zedd��Zedd��Zed	d
��Z	dd�Z
d
d�Zedd��Z
edd��Zedd��Zedd��Zedd��Zdd�ZdS)�_IPAddressBasezThe mother class.rcCs|��S)z:Return the longhand version of the IP address as a string.)�_explode_shorthand_ip_string�r.rrr�exploded�sz_IPAddressBase.explodedcCst|�S)z;Return the shorthand version of the IP address as a string.�rWr�rrr�
compressedsz_IPAddressBase.compressedcCs|��S)aIThe name of the reverse DNS pointer for the IP address, e.g.:
            >>> ipaddress.ip_address("127.0.0.1").reverse_pointer
            '1.0.0.127.in-addr.arpa'
            >>> ipaddress.ip_address("2001:db8::1").reverse_pointer
            '1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa'

        )�_reverse_pointerr�rrr�reverse_pointer	s	z_IPAddressBase.reverse_pointercCsdt|�f}t|��dS)Nz%200s has no version specified��typer�r.�msgrrrrlsz_IPAddressBase.versioncCsF|dkrd}t|||jf��||jkrBd}t|||j|jf��dS)Nrz-%d (< 0) is not permitted as an IPv%d addressz2%d (>= 2**%d) is not permitted as an IPv%d address)r@r|rnrm)r.rIr�rrr�_check_int_addresss

�z!_IPAddressBase._check_int_addresscCs.t|�}||kr*d}t|||||jf��dS)Nz~%r (len %d != %d) is not permitted as an IPv%d address. Did you pass in a bytes (str in Python 2) instead of a unicode object?)rYr@r|)r.rIZexpected_lenZaddress_lenr�rrr�_check_packed_address"s��z$_IPAddressBase._check_packed_addresscCs|j|j|?AS)z�Turn the prefix length into a bitwise netmask

        Args:
            prefixlen: An integer, the prefix length.

        Returns:
            An integer.

        )rn)�cls�	prefixlenrrr�_ip_int_from_prefix,sz"_IPAddressBase._ip_int_from_prefixc	Cs\t||j�}|j|}||?}d|>d}||krX|jd}t||d�}d}t||��|S)aReturn prefix length from the bitwise netmask.

        Args:
            ip_int: An integer, the netmask in expanded bitwise format

        Returns:
            An integer, the prefix length.

        Raises:
            ValueError: If the input intermingles zeroes & ones
        r&rrz&Netmask pattern %r mixes zeroes & ones)rgrmrrG)	r��ip_intZtrailing_zeroesr�Zleading_onesZall_onesZbyteslenZdetailsr�rrr�_prefix_from_ip_int9s
�

z"_IPAddressBase._prefix_from_ip_intcCsd|}t|��dS)Nz%r is not a valid netmask)rC)r�Znetmask_strr�rrr�_report_invalid_netmaskRsz&_IPAddressBase._report_invalid_netmaskcCshtj�|�s|�|�zt|�}Wntk
r@|�|�YnXd|krX|jksdn|�|�|S)a	Return prefix length from a numeric string

        Args:
            prefixlen_str: The string to be converted

        Returns:
            An integer, the prefix length.

        Raises:
            NetmaskValueError: If the input is not a valid netmask
        r)�_BaseV4�_DECIMAL_DIGITS�
issupersetr��intrGrm)r�Z
prefixlen_strr�rrr�_prefix_from_prefix_stringWs

z)_IPAddressBase._prefix_from_prefix_stringcCs�z|�|�}Wntk
r,|�|�YnXz|�|�WStk
rNYnX||jN}z|�|�WStk
r�|�|�YnXdS)aTurn a netmask/hostmask string into a prefix length

        Args:
            ip_str: The netmask/hostmask to be converted

        Returns:
            An integer, the prefix length.

        Raises:
            NetmaskValueError: If the input is not a valid netmask/hostmask
        N)�_ip_int_from_stringr@r�r�rGrn)r��ip_strr�rrr�_prefix_from_ip_stringps
z%_IPAddressBase._prefix_from_ip_stringcCs|jt|�ffSr)�	__class__rWr�rrr�
__reduce__�sz_IPAddressBase.__reduce__N)r;r<r=rBr>�propertyr�r�r�rlr�r��classmethodr�r�r�r�r�r�rrrrr��s.




	





!r�c@sdeZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
dd�ZdS)rjz�A generic IP object.

    This IP class contains the version independent methods which are
    used by single IP addresses.
    rcCs|jSr�r^r�rrr�__int__�sz_BaseAddress.__int__cCs8z|j|jko|j|jkWStk
r2tYSXdSr)r^r|r~r1r-rrrr0�s
�z_BaseAddress.__eq__cCs`t|t�stSt|t�s(td||f��|j|jkrDtd||f��|j|jkr\|j|jkSdS�N�"%s and %s are not of the same typerhF)rr�r1rjrkr|r^r-rrrr4�s

��z_BaseAddress.__lt__cCs t|t�stS|�t|�|�Sr�rrr1r�r�r-rrr�__add__�s
z_BaseAddress.__add__cCs t|t�stS|�t|�|�Srr�r-rrr�__sub__�s
z_BaseAddress.__sub__cCsd|jjt|�fS�Nz%s(%r)�r�r;rWr�rrr�__repr__�sz_BaseAddress.__repr__cCst|�|j��Sr)rW�_string_from_ip_intr^r�rrr�__str__�sz_BaseAddress.__str__cCsttt|j���Sr)�hash�hexr�r^r�rrr�__hash__�sz_BaseAddress.__hash__cCs
|j|fSr�r|r�rrrr��sz_BaseAddress._get_address_keycCs|j|jffSr)r�r^r�rrrr��sz_BaseAddress.__reduce__N)r;r<r=rBr>r�r0r4r�r�r�r�r�r�r�rrrrrj�srjc@sdeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zedd��Zedd��Zedd��Zedd��Zed d!��Zed"d#��Zed$d%��Zed&d'��Zd(d)�Zd*d+�Zd,d-�ZdHd0d1�ZdId2d3�Zed4d5��Zed6d7��Zd8d9�Z d:d;�Z!ed<d=��Z"ed>d?��Z#ed@dA��Z$edBdC��Z%edDdE��Z&edFdG��Z'd/S)Jr�z~A generic IP network object.

    This IP class contains the version independent methods which are
    used by networks.

    cCs
i|_dSr)�_cache)r.rIrrr�__init__�sz_BaseNetwork.__init__cCsd|jjt|�fSr�r�r�rrrr��sz_BaseNetwork.__repr__cCsd|j|jfS�N�%s/%d)rr�r�rrrr��sz_BaseNetwork.__str__ccs8t|j�}t|j�}t|d|�D]}|�|�Vq"dS)z�Generate Iterator over usable hosts in a network.

        This is like __iter__ except it doesn't return the network
        or broadcast addresses.

        r&N�r�rrxr*�_address_class�r.�network�	broadcast�xrrr�hosts�s

z_BaseNetwork.hostsccs8t|j�}t|j�}t||d�D]}|�|�Vq"dS�Nr&r�r�rrr�__iter__�s

z_BaseNetwork.__iter__cCslt|j�}t|j�}|dkr>|||kr0td��|�||�S|d7}|||krZtd��|�||�SdS)Nrzaddress out of ranger&)r�rrx�
IndexErrorr�)r.�nr�r�rrr�__getitem__�s

z_BaseNetwork.__getitem__cCsxt|t�stSt|t�s(td||f��|j|jkrDtd||f��|j|jkr\|j|jkS|j|jkrt|j|jkSdSr�)rr�r1r�rkr|r�netmaskr-rrrr4s"

��z_BaseNetwork.__lt__cCsLz.|j|jko,|j|jko,t|j�t|j�kWStk
rFtYSXdSr)r|rr�r�r~r1r-rrrr0s
��z_BaseNetwork.__eq__cCstt|j�t|j�A�Sr)r�r�rr�r�rrrr�sz_BaseNetwork.__hash__cCsL|j|jkrdSt|t�rdSt|j�t|j�koBt|j�kSSdS�NF)r|rr�r�rr^rxr-rrr�__contains__s
�z_BaseNetwork.__contains__cCs(|j|kp&|j|kp&|j|kp&|j|kS)z*Tell if self is partly contained in other.)rrxr-rrr�overlaps*s



�z_BaseNetwork.overlapscCs<|j�d�}|dkr8|�t|j�t|j�B�}||jd<|S)Nrx)r�rtr�r�r�hostmask�r.r�rrrrx1s�
z_BaseNetwork.broadcast_addresscCs8|j�d�}|dkr4|�t|j�|jA�}||jd<|S)Nr�)r�rtr�r�r�rnr�rrrr�:s

z_BaseNetwork.hostmaskcCsd|j|jfSr�)rr}r�rrr�with_prefixlenBsz_BaseNetwork.with_prefixlencCsd|j|jfS�N�%s/%s)rr�r�rrr�with_netmaskFsz_BaseNetwork.with_netmaskcCsd|j|jfSr�)rr�r�rrr�
with_hostmaskJsz_BaseNetwork.with_hostmaskcCst|j�t|j�dS)z&Number of hosts in the current subnet.r&)r�rxrr�rrr�
num_addressesNsz_BaseNetwork.num_addressescCsdt|�f}t|��dS)Nz%%200s has no associated address classr�r�rrrr�Ssz_BaseNetwork._address_classcCs|jSr)r}r�rrrr�[sz_BaseNetwork.prefixlenccs|j|jkstd||f��t|t�s2td|��|�|�sLtd||f��||krXdS|�d|j|jf�}|�	�\}}||kr�||kr�|�|�r�|V|�	�\}}qz|�|�r�|V|�	�\}}qzt
d|||f��qz||kr�|Vn"||kr�|Vnt
d|||f��dS)a�Remove an address from a larger block.

        For example:

            addr1 = ip_network('192.0.2.0/28')
            addr2 = ip_network('192.0.2.1/32')
            list(addr1.address_exclude(addr2)) =
                [IPv4Network('192.0.2.0/32'), IPv4Network('192.0.2.2/31'),
                 IPv4Network('192.0.2.4/30'), IPv4Network('192.0.2.8/29')]

        or IPv6:

            addr1 = ip_network('2001:db8::1/32')
            addr2 = ip_network('2001:db8::1/128')
            list(addr1.address_exclude(addr2)) =
                [ip_network('2001:db8::1/128'),
                 ip_network('2001:db8::2/127'),
                 ip_network('2001:db8::4/126'),
                 ip_network('2001:db8::8/125'),
                 ...
                 ip_network('2001:db8:8000::/33')]

        Args:
            other: An IPv4Network or IPv6Network object of the same type.

        Returns:
            An iterator of the IPv(4|6)Network objects which is self
            minus other.

        Raises:
            TypeError: If self and other are of differing address
              versions, or if other is not a network object.
            ValueError: If other is not completely contained by self.

        rhz%s is not a network objectz%s not contained in %sNr�z3Error performing exclusion: s1: %s s2: %s other: %s)r|rkrr��	subnet_ofrGr�rr�ryr)r.r/�s1�s2rrr�address_exclude_s@$�


�

��z_BaseNetwork.address_excludecCs`|j|jkrtd||f��|j|jkr,dS|j|jkr<dS|j|jkrLdS|j|jkr\dSdS)a�Compare two IP objects.

        This is only concerned about the comparison of the integer
        representation of the network addresses.  This means that the
        host bits aren't considered at all in this method.  If you want
        to compare host bits, you can easily enough do a
        'HostA._ip < HostB._ip'

        Args:
            other: An IP object.

        Returns:
            If the IP versions of self and other are the same, returns:

            -1 if self < other:
              eg: IPv4Network('192.0.2.0/25') < IPv4Network('192.0.2.128/25')
              IPv6Network('2001:db8::1000/124') <
                  IPv6Network('2001:db8::2000/124')
            0 if self == other
              eg: IPv4Network('192.0.2.0/24') == IPv4Network('192.0.2.0/24')
              IPv6Network('2001:db8::1000/124') ==
                  IPv6Network('2001:db8::1000/124')
            1 if self > other
              eg: IPv4Network('192.0.2.128/25') > IPv4Network('192.0.2.0/25')
                  IPv6Network('2001:db8::2000/124') >
                      IPv6Network('2001:db8::1000/124')

          Raises:
              TypeError if the IP versions are different.

        r�r{r&r)r|rkrr�r-rrr�compare_networks�s!�z_BaseNetwork.compare_networkscCs|j|j|jfS)z�Network-only key function.

        Returns an object that identifies this address' network and
        netmask. This function is a suitable "key" argument for sorted()
        and list.sort().

        )r|rr�r�rrrr��sz_BaseNetwork._get_networks_keyr&Nc	cs�|j|jkr|VdS|dk	rJ||jkr0td��|dkr@td��||j}|dkrZtd��|j|}||jkr~td||f��t|j�}t|j�d}t|j�d|?}t|||�D]}|�||f�}|Vq�dS)a�The subnets which join to make the current subnet.

        In the case that self contains only one IP
        (self._prefixlen == 32 for IPv4 or self._prefixlen == 128
        for IPv6), yield an iterator with just ourself.

        Args:
            prefixlen_diff: An integer, the amount the prefix length
              should be increased by. This should not be set if
              new_prefix is also set.
            new_prefix: The desired new prefix length. This must be a
              larger number (smaller prefix) than the existing prefix.
              This should not be set if prefixlen_diff is also set.

        Returns:
            An iterator of IPv(4|6) objects.

        Raises:
            ValueError: The prefixlen_diff is too small or too large.
                OR
            prefixlen_diff and new_prefix are both set or new_prefix
              is a smaller number than the current prefix (smaller
              number means a larger network)

        Nznew prefix must be longerr&�(cannot set prefixlen_diff and new_prefixrzprefix length diff must be > 0z0prefix length diff %d is invalid for netblock %s)	r}rmrGr�rrxr�r*r�)	r.�prefixlen_diff�
new_prefix�
new_prefixlenr'r(r)Znew_addrZcurrentrrrry�s2



��
z_BaseNetwork.subnetscCs�|jdkr|S|dk	rB||jkr(td��|dkr8td��|j|}|j|}|dkrftd|j|f��|�t|j�t|j�|>@|f�S)a�The supernet containing the current network.

        Args:
            prefixlen_diff: An integer, the amount the prefix length of
              the network should be decreased by.  For example, given a
              /24 network and a prefixlen_diff of 3, a supernet with a
              /21 netmask is returned.

        Returns:
            An IPv4 network object.

        Raises:
            ValueError: If self.prefixlen - prefixlen_diff < 0. I.e., you have
              a negative prefix length.
                OR
            If prefixlen_diff and new_prefix are both set or new_prefix is a
              larger number than the current prefix (larger number means a
              smaller network)

        rNznew prefix must be shorterr&r�z;current prefixlen is %d, cannot have a prefixlen_diff of %d)r}rGr�r�r�rr�)r.r�r�r�rrrrss&



���z_BaseNetwork.supernetcCs|jjo|jjS�z�Test if the address is reserved for multicast use.

        Returns:
            A boolean, True if the address is a multicast address.
            See RFC 2373 2.7 for details.

        )r�is_multicastrxr�rrrr�As	�z_BaseNetwork.is_multicastcCs^z4|j|jkrtd||���|j|jko2|j|jkWStk
rXtd||f��YnXdS)Nrhz3Unable to test subnet containment between %s and %s)r|rkrrxr~)�ar
rrr�
_is_subnet_ofMs
��z_BaseNetwork._is_subnet_ofcCs|�||�S)z1Return True if this network is a subnet of other.�r�r-rrrr�Ysz_BaseNetwork.subnet_ofcCs|�||�S)z3Return True if this network is a supernet of other.r�r-rrr�supernet_of]sz_BaseNetwork.supernet_ofcCs|jjo|jjS)��Test if the address is otherwise IETF reserved.

        Returns:
            A boolean, True if the address is within one of the
            reserved IPv6 Network ranges.

        )r�is_reservedrxr�rrrr�as	�z_BaseNetwork.is_reservedcCs|jjo|jjS�z�Test if the address is reserved for link-local.

        Returns:
            A boolean, True if the address is reserved per RFC 4291.

        )r�
is_link_localrxr�rrrr�ms�z_BaseNetwork.is_link_localcCs|jjo|jjS)z�Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv4-special-registry or iana-ipv6-special-registry.

        )r�
is_privaterxr�rrrr�xs	�z_BaseNetwork.is_privatecCs|jS)z�Test if this address is allocated for public networks.

        Returns:
            A boolean, True if the address is not reserved per
            iana-ipv4-special-registry or iana-ipv6-special-registry.

        �r�r�rrr�	is_global�s	z_BaseNetwork.is_globalcCs|jjo|jjS)��Test if the address is unspecified.

        Returns:
            A boolean, True if this is the unspecified address as defined in
            RFC 2373 2.5.2.

        )r�is_unspecifiedrxr�rrrr��s	�z_BaseNetwork.is_unspecifiedcCs|jjo|jjS)��Test if the address is a loopback address.

        Returns:
            A boolean, True if the address is a loopback address as defined in
            RFC 2373 2.5.3.

        )r�is_loopbackrxr�rrrr��s	�z_BaseNetwork.is_loopback)r&N)r&N)(r;r<r=rBr�r�r�r�r�r�r4r0r�r�r�r�rxr�r�r�r�r�r�r�r�r�r�ryrsr��staticmethodr�r�r�r�r�r�r�r�r�rrrrr��sf









K0

5
(








r�c
@s�eZdZdZdZdZdedZed�Z	eddd	d
ddd
ddg	�Z
eZiZdd�Z
edd��Zedd��Zedd��Zedd��Zdd�Zdd�Zedd��Zed d!��Zd"S)#r�zyBase IPv4 object.

    The following methods are used by IPv4 objects in both single IP
    addresses and networks.

    rrrr&�
0123456789���������rrcCst|�Srr�r�rrrr��sz$_BaseV4._explode_shorthand_ip_stringcCsn||jkrdt|t�r|}n.z|�|�}Wntk
rF|�|�}YnXt|�|��}||f|j|<|j|S�aMake a (netmask, prefix_len) tuple from the given argument.

        Argument can be:
        - an integer (the prefix length)
        - a string representing the prefix length (e.g. "24")
        - a string representing the prefix netmask (e.g. "255.255.255.0")
        )�_netmask_cacherrr�rCr�rDr��r��argr�r�rrr�
_make_netmask�s	

z_BaseV4._make_netmaskc
Csz|std��|�d�}t|�dkr.td|��ztt|j|�d�WStk
rt}ztd||f��W5d}~XYnXdS)aTurn the given IP string into an integer for comparison.

        Args:
            ip_str: A string, the IP ip_str.

        Returns:
            The IP ip_str as an integer.

        Raises:
            AddressValueError: if ip_str isn't a valid IPv4 Address.

        �Address cannot be empty�.rzExpected 4 octets in %rr�%s in %rN)r@rXrYr�map�_parse_octetrG)r�r�Zoctets�excrrrr��s

�z_BaseV4._ip_int_from_stringcCs�|std��|j�|�s(d}t||��t|�dkrDd}t||��t|d�}|dkrr|ddkrrd	}t||��|d
kr�td|��|S)aConvert a decimal octet into an integer.

        Args:
            octet_str: A string, the number to parse.

        Returns:
            The octet as an integer.

        Raises:
            ValueError: if the octet isn't strictly a decimal from [0..255].

        zEmpty octet not permittedz#Only decimal digits permitted in %r�z$At most 3 characters permitted in %r�
�r�0z3Ambiguous (octal/decimal) value in %r not permittedr�zOctet %d (> 255) not permitted)rGr�r�rYr�)r�Z	octet_strr�Z	octet_intrrrr�s
z_BaseV4._parse_octetcCsd�dd�t|dd�D��S)z�Turns a 32-bit integer into dotted decimal notation.

        Args:
            ip_int: An integer, the IP address.

        Returns:
            The IP address as a string in dotted decimal notation.

        r�css0|](}tt|t�r"t�d|�dn|�VqdS)rrN)rWrrFr	r
rrrr�	<genexpr>%s���z._BaseV4._string_from_ip_int.<locals>.<genexpr>rr)�joinr)r�r�rrrr�s

�z_BaseV4._string_from_ip_intcsj|�d�}z�fdd�tt|�D�}Wntk
r<YdSXt|�t|�krRdS|d|dkrfdSdS)z�Test if the IP string is a hostmask (rather than a netmask).

        Args:
            ip_str: A string, the potential hostmask.

        Returns:
            A boolean, True if the IP string is a hostmask.

        r�csg|]}|�jkr|�qSr)�_valid_mask_octets�rr�r�rrr6s
z(_BaseV4._is_hostmask.<locals>.<listcomp>Frr{T)rXr�r�rGrY)r.r�rf�partsrr�r�_is_hostmask*s

z_BaseV4._is_hostmaskcCs&t|��d�ddd�}d�|�dS)z�Return the reverse DNS pointer name for the IPv4 address.

        This implements the method described in RFC1035 3.5.

        r�Nr{z
.in-addr.arpa)rWrXr)r.Zreverse_octetsrrrr�?sz_BaseV4._reverse_pointercCs|jSr�rmr�rrr�
max_prefixlenHsz_BaseV4.max_prefixlencCs|jSrr�r�rrrrlLsz_BaseV4.versionN)r;r<r=rBr>r|�
IPV4LENGTHrn�	frozensetr�rrmr�r�r�r�r�rr�rr�r�r
rlrrrrr��s.


$
	
r�c@s|eZdZdZdZdd�Zedd��Zedd��Zed	d
��Z	edd��Z
ed
d��Zedd��Zedd��Z
edd��ZdS)rDz/Represent and manipulate single IPv4 Addresses.�r^�__weakref__cCsxt|t�r|�|�||_dSt|t�rL|�|d�t|�}t|d�|_dSt|�}d|krht	d|��|�
|�|_dS)a�
        Args:
            address: A string or integer representing the IP

              Additionally, an integer can be passed, so
              IPv4Address('192.0.2.1') == IPv4Address(3221225985).
              or, more generally
              IPv4Address(int(IPv4Address('192.0.2.1'))) ==
                IPv4Address('192.0.2.1')

        Raises:
            AddressValueError: If ipaddress isn't a valid IPv4 address.

        NrrrV�Unexpected '/' in %r�rrr�r^rFr�rrrWr@r��r.rIZbvsZaddr_strrrrr�Ws


zIPv4Address.__init__cCs
t|j�S�z*The binary representation of this address.)rTr^r�rrr�packed{szIPv4Address.packedcCs||jjkS)z�Test if the address is otherwise IETF reserved.

         Returns:
             A boolean, True if the address is within the
             reserved IPv4 Network range.

        )�
_constants�_reserved_networkr�rrrr��s	zIPv4Address.is_reservedcst�fdd��jjD��S)z�Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv4-special-registry.

        c3s|]}�|kVqdSrr�rror�rrr�sz)IPv4Address.is_private.<locals>.<genexpr>��anyr�_private_networksr�rr�rr��s	zIPv4Address.is_privatecCs||jjko|jSr)r�_public_networkr�r�rrrr��s�zIPv4Address.is_globalcCs||jjkS)z�Test if the address is reserved for multicast use.

        Returns:
            A boolean, True if the address is multicast.
            See RFC 3171 for details.

        �r�_multicast_networkr�rrrr��s	zIPv4Address.is_multicastcCs||jjkS)z�Test if the address is unspecified.

        Returns:
            A boolean, True if this is the unspecified address as defined in
            RFC 5735 3.

        )r�_unspecified_addressr�rrrr��s	zIPv4Address.is_unspecifiedcCs||jjkS)z�Test if the address is a loopback address.

        Returns:
            A boolean, True if the address is a loopback per RFC 3330.

        )r�_loopback_networkr�rrrr��szIPv4Address.is_loopbackcCs||jjkS)z�Test if the address is reserved for link-local.

        Returns:
            A boolean, True if the address is link-local per RFC 3927.

        �r�_linklocal_networkr�rrrr��szIPv4Address.is_link_localN)r;r<r=rBr>r�r�rr�r�r�r�r�r�r�rrrrrDQs&$










	rDc@sjeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zej	Z	e
dd��Ze
d
d��Ze
dd��Z
e
dd��ZdS)rOcCs�t|ttf�r2t�||�t|j�|_|j|_	dSt|t
�r�t�||d�t|�dkrht|d�|_	n|j|_	t|dd�|_|jj
|_
|jj|_dSt|�}t�||d�t|dd�|_|jj	|_	|jj
|_
|jj|_dS�Nrr&F)rM)rrFrrDr�rKr^r�rmr}�tuplerYr�r�r�r[�r.rIrZrrrr��s(




zIPv4Interface.__init__cCsd|�|j�|jjfSr��r�r^r�r�r�rrrr��s�zIPv4Interface.__str__cCsFt�||�}|r|tkr|Sz|j|jkWStk
r@YdSXdSr�)rDr0r1r�r~�r.r/Z
address_equalrrrr0�szIPv4Interface.__eq__cCsRt�||�}|tkrtSz|j|jkp4|j|jko4|WStk
rLYdSXdSr�)rDr4r1r�r~�r.r/Zaddress_lessrrrr4�s�zIPv4Interface.__lt__cCs|j|jAt|jj�ASr�r^r}r�r�rr�rrrr�szIPv4Interface.__hash__cCs
t|j�Sr)rDr^r�rrrrcszIPv4Interface.ipcCsd|�|j�|jfSr��r�r^r}r�rrrr�
s�zIPv4Interface.with_prefixlencCsd|�|j�|jfSr��r�r^r�r�rrrr�s�zIPv4Interface.with_netmaskcCsd|�|j�|jfSr��r�r^r�r�rrrr�s�zIPv4Interface.with_hostmaskN)r;r<r=r�r�r0r4r�r�r�r�rcr�r�r�rrrrrO�s


rOc@s*eZdZdZeZddd�Zedd��ZdS)	rKaeThis class represents and manipulates 32-bit IPv4 network + addresses..

    Attributes: [examples for IPv4Network('192.0.2.0/27')]
        .network_address: IPv4Address('192.0.2.0')
        .hostmask: IPv4Address('0.0.0.31')
        .broadcast_address: IPv4Address('192.0.2.32')
        .netmask: IPv4Address('255.255.255.224')
        .prefixlen: 27

    TcCs|t�||�t|ttf�r<t|�|_|�|j�\|_	|_
dSt|t�r�t|�dkr\|d}n|j}t|d�|_|�|�\|_	|_
t
|j�}|t
|j	�@|kr�|r�td|��nt|t
|j	�@�|_dSt|�}t|�|d��|_t|�dkr�|d}n|j}|�|�\|_	|_
|�rDtt
|j�t
|j	�@�|jk�rDtd|��tt
|j�t
|j	�@�|_|j
|jdk�rx|j|_dS)aInstantiate a new IPv4 network object.

        Args:
            address: A string or integer representing the IP [& network].
              '192.0.2.0/24'
              '192.0.2.0/255.255.255.0'
              '192.0.0.2/0.0.0.255'
              are all functionally the same in IPv4. Similarly,
              '192.0.2.1'
              '192.0.2.1/255.255.255.255'
              '192.0.2.1/32'
              are also functionally equivalent. That is to say, failing to
              provide a subnetmask will create an object with a mask of /32.

              If the mask (portion after the / in the argument) is given in
              dotted quad form, it is treated as a netmask if it starts with a
              non-zero field (e.g. /255.0.0.0 == /8) and as a hostmask if it
              starts with a zero field (e.g. 0.255.255.255 == /8), with the
              single exception of an all-zero mask which is treated as a
              netmask == /0. If no mask is given, a default of /32 is used.

              Additionally, an integer can be passed, so
              IPv4Network('192.0.2.1') == IPv4Network(3221225985)
              or, more generally
              IPv4Interface(int(IPv4Interface('192.0.2.1'))) ==
                IPv4Interface('192.0.2.1')

        Raises:
            AddressValueError: If ipaddress isn't a valid IPv4 address.
            NetmaskValueError: If the netmask isn't valid for
              an IPv4 address.
            ValueError: If strict is True and a network address is not
              supplied.

        Nr&r�%s has host bits setr)r�r�rrrFrDrr�rmr�r}r%rYr�rGr[r�r�r��r.rIrMr�rrZrrrr�)sJ%
�


�
�
�zIPv4Network.__init__cCs&|jtd�ko|jtd�ko$|jS)z�Test if this address is allocated for public networks.

        Returns:
            A boolean, True if the address is not reserved per
            iana-ipv4-special-registry.

        �
100.64.0.0/10)rrKrxr�r�rrrr�~s
	��zIPv4Network.is_globalN)T)	r;r<r=rBrDr�r�r�r�rrrrrKs

UrKc@s�eZdZed�Zed�Zed�Zed�Zed�ed�ed�ed�ed�ed�ed	�ed
�ed�ed�ed
�ed�ed�ed�gZed�Z	e
d�ZdS)�_IPv4Constantsz169.254.0.0/16z127.0.0.0/8z224.0.0.0/4r0z	0.0.0.0/8z
10.0.0.0/8z
172.16.0.0/12z192.0.0.0/29z192.0.0.170/31z192.0.2.0/24z192.168.0.0/16z
198.18.0.0/15z198.51.100.0/24z203.0.113.0/24z240.0.0.0/4z255.255.255.255/32z0.0.0.0N)r;r<r=rKr#r!rrrrrDr rrrrr1�s*�r1c@s�eZdZdZdZdZdedZdZe	d�Z
eZiZe
dd	��Ze
d
d��Ze
dd
��Ze
dd��Ze
ddd��Zdd�Zdd�Zedd��Zedd��ZdS)�_BaseV6zyBase IPv6 object.

    The following methods are used by IPv6 objects in both single IP
    addresses and networks.

    rrirr&rZ0123456789ABCDEFabcdefcCsJ||jkr@t|t�r|}n
|�|�}t|�|��}||f|j|<|j|Sr�)r�rrr�rEr�r�rrrr��s	


z_BaseV6._make_netmaskc
Cs�|std��|�d�}d}t|�|kr:d||f}t|��d|dkr�zt|���j}Wn2tk
r�}ztd||f��W5d}~XYnX|�d	|d
?d@�|�d	|d@�|jd}t|�|kr�d
|d|f}t|��d}tdt|�d�D]*}	||	s�|dk	�rd|}t|��|	}q�|dk	�r�|}
t|�|d}|d�sj|
d8}
|
�rjd}t||��|d�s�|d8}|�r�d}t||��|j|
|}|dk�r0d}t||jd|f��njt|�|jk�r�d}t||j|f��|d�sd}t||��|d�s d}t||��t|�}
d}d}znd}
t	|
�D] }	|
d
K}
|
|�
||	�O}
�q>|
d
|K}
t	|d�D] }	|
d
K}
|
|�
||	�O}
�qx|
WStk
�r�}ztd||f��W5d}~XYnXdS)z�Turn an IPv6 ip_str into an integer.

        Args:
            ip_str: A string, the IPv6 ip_str.

        Returns:
            An int, the IPv6 address

        Raises:
            AddressValueError: if ip_str isn't a valid IPv6 Address.

        r��:rz At least %d parts expected in %rr�r{r�N�%xr�r&z!At most %d colons permitted in %rz At most one '::' permitted in %rrz0Leading ':' only permitted as part of '::' in %rz1Trailing ':' only permitted as part of '::' in %rz/Expected at most %d other parts with '::' in %rz,Exactly %d parts expected without '::' in %r)r@rXrYrDrrr^ru�
_HEXTET_COUNTr*�range�
_parse_hextetrG)r�r�r
Z
_min_partsr�Zipv4_intrZ
_max_partsZ
skip_indexr!Zparts_hiZparts_loZ
parts_skippedr�rrrr��s�
"
�






z_BaseV6._ip_int_from_stringcCs>|j�|�std|��t|�dkr4d}t||��t|d�S)a&Convert an IPv6 hextet string into an integer.

        Args:
            hextet_str: A string, the number to parse.

        Returns:
            The hextet as an integer.

        Raises:
            ValueError: if the input isn't strictly a hex number from
              [0..FFFF].

        zOnly hex digits permitted in %rrz$At most 4 characters permitted in %rr)�_HEX_DIGITSr�rGrYr�)r�Z
hextet_strr�rrrr8>sz_BaseV6._parse_hextetc	Cs�d}d}d}d}t|�D]>\}}|dkrN|d7}|dkr<|}||krV|}|}qd}d}q|dkr�||}|t|�kr~|dg7}dg|||�<|dkr�dg|}|S)a�Compresses a list of hextets.

        Compresses a list of strings, replacing the longest continuous
        sequence of "0" in the list with "" and adding empty strings at
        the beginning or at the end of the string such that subsequently
        calling ":".join(hextets) will produce the compressed version of
        the IPv6 address.

        Args:
            hextets: A list of strings, the hextets to compress.

        Returns:
            A list of strings.

        r{rrr&�)�	enumeraterY)	r��hextetsZbest_doublecolon_startZbest_doublecolon_lenZdoublecolon_startZdoublecolon_len�indexZhextetZbest_doublecolon_endrrr�_compress_hextetsXs0�

z_BaseV6._compress_hextetsNcsZ|dkrt|j�}||jkr$td��d|��fdd�tddd�D�}|�|�}d	�|�S)
a,Turns a 128-bit integer into hexadecimal notation.

        Args:
            ip_int: An integer, the IP address.

        Returns:
            A string, the hexadecimal representation of the address.

        Raises:
            ValueError: The address is bigger than 128 bits of all ones.

        NzIPv6 address is too large�%032xcs&g|]}dt�||d�d��qS)r4rr)r�r	�Zhex_strrrr�sz/_BaseV6._string_from_ip_int.<locals>.<listcomp>rr?rr3)r�r^rnrGr7r>r)r�r�r<rr@rr��s


z_BaseV6._string_from_ip_intcs�t|t�rt|j�}nt|t�r,t|j�}nt|�}|�|�}d|��fdd�tddd�D�}t|ttf�r�dd�	|�|j
fSd�	|�S)	z�Expand a shortened IPv6 address.

        Args:
            ip_str: A string, the IPv6 address.

        Returns:
            A string, the expanded IPv6 address.

        r?csg|]}�||d��qS)rrr	r@rrr�sz8_BaseV6._explode_shorthand_ip_string.<locals>.<listcomp>rr?rr�r3)rrLrWrrPrcr�r7r�rr})r.r�r�r
rr@rr��s



z$_BaseV6._explode_shorthand_ip_stringcCs&|jddd��dd�}d�|�dS)z�Return the reverse DNS pointer name for the IPv6 address.

        This implements the method described in RFC3596 2.5.

        Nr{r3r:r�z	.ip6.arpa)r��replacer)r.Z
reverse_charsrrrr��sz_BaseV6._reverse_pointercCs|jSrrr�rrrr
�sz_BaseV6.max_prefixlencCs|jSrr�r�rrrrl�sz_BaseV6.version)N)r;r<r=rBr>r|�
IPV6LENGTHrnr6rr9rmr�r�r�r�r8r>r�r�r�r�r
rlrrrrr2�s0

h

/	
r2c@s�eZdZdZdZdd�Zedd��Zedd��Zed	d
��Z	edd��Z
ed
d��Zedd��Zedd��Z
edd��Zedd��Zedd��Zedd��Zedd��ZdS)rEz/Represent and manipulate single IPv6 Addresses.rcCsxt|t�r|�|�||_dSt|t�rL|�|d�t|�}t|d�|_dSt|�}d|krht	d|��|�
|�|_dS)aInstantiate a new IPv6 address object.

        Args:
            address: A string or integer representing the IP

              Additionally, an integer can be passed, so
              IPv6Address('2001:db8::') ==
                IPv6Address(42540766411282592856903984951653826560)
              or, more generally
              IPv6Address(int(IPv6Address('2001:db8::'))) ==
                IPv6Address('2001:db8::')

        Raises:
            AddressValueError: If address isn't a valid IPv6 address.

        NrrrVrrrrrrr��s


zIPv6Address.__init__cCs
t|j�Sr)rUr^r�rrrr�szIPv6Address.packedcCs||jjkSr�rr�rrrr��s	zIPv6Address.is_multicastcst�fdd��jjD��S)r�c3s|]}�|kVqdSrrr	r�rrrsz*IPv6Address.is_reserved.<locals>.<genexpr>)rr�_reserved_networksr�rr�rr�s	zIPv6Address.is_reservedcCs||jjkSr�r"r�rrrr�szIPv6Address.is_link_localcCs||jjkS�a`Test if the address is reserved for site-local.

        Note that the site-local address space has been deprecated by RFC 3879.
        Use is_private to test if this address is in the space of unique local
        addresses as defined by RFC 4193.

        Returns:
            A boolean, True if the address is reserved per RFC 3513 2.5.6.

        )r�_sitelocal_networkr�rrr�
is_site_localszIPv6Address.is_site_localcst�fdd��jjD��S)z�Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv6-special-registry.

        c3s|]}�|kVqdSrrrr�rrr3sz)IPv6Address.is_private.<locals>.<genexpr>rr�rr�rr�*s	zIPv6Address.is_privatecCs|jS)z�Test if this address is allocated for public networks.

        Returns:
            A boolean, true if the address is not reserved per
            iana-ipv6-special-registry.

        r�r�rrrr�5s	zIPv6Address.is_globalcCs
|jdkS)r�rr�r�rrrr�@s	zIPv6Address.is_unspecifiedcCs
|jdkS)r�r&r�r�rrrr�Ks	zIPv6Address.is_loopbackcCs |jd?dkrdSt|jd@�S)z�Return the IPv4 mapped address.

        Returns:
            If the IPv6 address is a v4 mapped address, return the
            IPv4 mapped address. Return None otherwise.

        r?r5N����r^rDr�rrr�ipv4_mappedVs	zIPv6Address.ipv4_mappedcCs4|jd?dkrdSt|jd?d@�t|jd@�fS)z�Tuple of embedded teredo IPs.

        Returns:
            Tuple of the (server, client) IPs or None if the address
            doesn't appear to be a teredo address (doesn't start with
            2001::/32)

        �`i NrrGrHr�rrr�teredocs

�zIPv6Address.teredocCs$|jd?dkrdSt|jd?d@�S)z�Return the IPv4 6to4 embedded address.

        Returns:
            The IPv4 6to4-embedded address if present or None if the
            address doesn't appear to contain a 6to4 embedded address.

        �pi N�PrGrHr�rrr�	sixtofourrs	zIPv6Address.sixtofourN)r;r<r=rBr>r�r�rr�r�r�rFr�r�r�r�rIrKrNrrrrrE�s6%





	











rEc@s�eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zej	Z	e
dd��Ze
d
d��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��ZdS)rPcCs�t|ttf�r2t�||�t|j�|_|j|_	dSt|t
�r�t�||d�t|�dkrht|d�|_	n|j|_	t|dd�|_|jj
|_
|jj|_dSt|�}t�||d�t|dd�|_|jj
|_
|jj	|_	|jj|_dSr$)rrFrrEr�rLr^r�rmr}r%rYr�r�r�r[r&rrrr��s(




zIPv6Interface.__init__cCsd|�|j�|jjfSr�r'r�rrrr��s�zIPv6Interface.__str__cCsFt�||�}|r|tkr|Sz|j|jkWStk
r@YdSXdSr�)rEr0r1r�r~r(rrrr0�szIPv6Interface.__eq__cCsRt�||�}|tkrtSz|j|jkp4|j|jko4|WStk
rLYdSXdSr�)rEr4r1r�r~r)rrrr4�s�zIPv6Interface.__lt__cCs|j|jAt|jj�ASrr*r�rrrr��szIPv6Interface.__hash__cCs
t|j�Sr)rEr^r�rrrrc�szIPv6Interface.ipcCsd|�|j�|jfSr�r+r�rrrr��s�zIPv6Interface.with_prefixlencCsd|�|j�|jfSr�r,r�rrrr��s�zIPv6Interface.with_netmaskcCsd|�|j�|jfSr�r-r�rrrr��s�zIPv6Interface.with_hostmaskcCs|jdko|jjSr#)r^r�r�r�rrrr��szIPv6Interface.is_unspecifiedcCs|jdko|jjSr�)r^r�r�r�rrrr��szIPv6Interface.is_loopbackN)r;r<r=r�r�r0r4r�r�r�r�rcr�r�r�r�r�rrrrrP�s$




rPc@s2eZdZdZeZd
dd�Zdd�Zedd��Z	d	S)rLavThis class represents and manipulates 128-bit IPv6 networks.

    Attributes: [examples for IPv6('2001:db8::1000/124')]
        .network_address: IPv6Address('2001:db8::1000')
        .hostmask: IPv6Address('::f')
        .broadcast_address: IPv6Address('2001:db8::100f')
        .netmask: IPv6Address('ffff:ffff:ffff:ffff:ffff:ffff:ffff:fff0')
        .prefixlen: 124

    TcCs|t�||�t|ttf�r<t|�|_|�|j�\|_	|_
dSt|t�r�t|�dkr\|d}n|j}|�|�\|_	|_
t|d�|_t
|j�}|t
|j	�@|kr�|r�td|��nt|t
|j	�@�|_dSt|�}t|�|d��|_t|�dkr�|d}n|j}|�|�\|_	|_
|�rDtt
|j�t
|j	�@�|jk�rDtd|��tt
|j�t
|j	�@�|_|j
|jdk�rx|j|_dS)a�Instantiate a new IPv6 Network object.

        Args:
            address: A string or integer representing the IPv6 network or the
              IP and prefix/netmask.
              '2001:db8::/128'
              '2001:db8:0000:0000:0000:0000:0000:0000/128'
              '2001:db8::'
              are all functionally the same in IPv6.  That is to say,
              failing to provide a subnetmask will create an object with
              a mask of /128.

              Additionally, an integer can be passed, so
              IPv6Network('2001:db8::') ==
                IPv6Network(42540766411282592856903984951653826560)
              or, more generally
              IPv6Network(int(IPv6Network('2001:db8::'))) ==
                IPv6Network('2001:db8::')

            strict: A boolean. If true, ensure that we have been passed
              A true network address, eg, 2001:db8::1000/124 and not an
              IP address on a network, eg, 2001:db8::1/124.

        Raises:
            AddressValueError: If address isn't a valid IPv6 address.
            NetmaskValueError: If the netmask isn't valid for
              an IPv6 address.
            ValueError: If strict was True and a network address was not
              supplied.

        Nr&rr.r)r�r�rrFrrErr�rmr�r}r%rYr�rGr[r�r�r�r/rrrr��sJ 
�


�
�
�zIPv6Network.__init__ccs<t|j�}t|j�}t|d|d�D]}|�|�Vq&dS)z�Generate Iterator over usable hosts in a network.

          This is like __iter__ except it doesn't return the
          Subnet-Router anycast address.

        r&Nr�r�rrrr�6	s

zIPv6Network.hostscCs|jjo|jjSrD)rrFrxr�rrrrFB	s�zIPv6Network.is_site_localN)T)
r;r<r=rBrEr�r�r�r�rFrrrrrL�s
OrLc@s�eZdZed�Zed�Zed�ed�ed�ed�ed�ed�ed	�ed
�ed�ed�g
Zed�ed
�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�gZed�ZdS)�_IPv6Constantsz	fe80::/10zff00::/8z::1/128z::/128z
::ffff:0:0/96z100::/64z	2001::/23z2001:2::/48z
2001:db8::/32z2001:10::/28zfc00::/7z::/8z100::/8z200::/7z400::/6z800::/5z1000::/4z4000::/3z6000::/3z8000::/3zA000::/3zC000::/3zE000::/4zF000::/5zF800::/6zFE00::/9z	fec0::/10N)	r;r<r=rLr#rrrCrErrrrrOR	s<��rO)r&)T)8rBZ
__future__rr$r	�__version__r�rZlong�	NameErrorZunicoderW�strrFrr�
from_bytesrr~r�hasattrr"r*�objectr+rrBrGr@rCrJrNrQrTrUr[rdrgrprzr�r�r�rjr�r�rDrOrKr1rr2rErPrLrOrrrr�<module>s�

	


)$
$#716=X*vSr 5W{!site-packages/pip/_vendor/__pycache__/__init__.cpython-38.opt-1.pyc000064400000005415151446177000021060 0ustar00U

��.e1�@s�dZddlmZddlZddlZddlZdZej�	ej�
e��Zdd�Z
e�r�e�ej�ed��ejejdd�<e
d�e
d	�e
d
�e
d�e
d�e
d
�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d �e
d!�e
d"�e
d#�e
d$�e
d%�e
d&�e
d'�e
d(�e
d)�e
d*�e
d+�e
d,�e
d-�e
d.�e
d/�e
d0�e
d1�e
d2�e
d3�e
d4�e
d5�e
d6�e
d7�dS)8z�
pip._vendor is for vendoring dependencies of pip to prevent needing pip to
depend on something external.

Files inside of pip._vendor should be considered immutable and should only be
updated to versions from upstream.
�)�absolute_importNFcCsvd�t|�}zt|t�t�dd�Wntk
r8Yn:Xtj|tj|<|�dd�\}}t	tj||tj|�dS)Nz{0}.{1}r)�level�.�)
�format�__name__�
__import__�globals�locals�ImportError�sys�modules�rsplit�setattr)Z
modulenameZ
vendored_name�base�head�r�8/usr/lib/python3.8/site-packages/pip/_vendor/__init__.py�vendoreds	rz*.whlZcachecontrolZcoloramaZcontextlib2ZdistlibZdistroZhtml5libZsixz	six.moveszsix.moves.urllibzsix.moves.urllib.parseZ	packagingzpackaging.versionzpackaging.specifiersZpep517Z
pkg_resourcesZprogressZpytomlZretryingZrequestszrequests.exceptionszrequests.packageszrequests.packages.urllib3z&requests.packages.urllib3._collectionsz$requests.packages.urllib3.connectionz(requests.packages.urllib3.connectionpoolz!requests.packages.urllib3.contribz*requests.packages.urllib3.contrib.ntlmpoolz+requests.packages.urllib3.contrib.pyopensslz$requests.packages.urllib3.exceptionsz requests.packages.urllib3.fieldsz"requests.packages.urllib3.filepostz"requests.packages.urllib3.packagesz/requests.packages.urllib3.packages.ordered_dictz&requests.packages.urllib3.packages.sixz5requests.packages.urllib3.packages.ssl_match_hostnamezErequests.packages.urllib3.packages.ssl_match_hostname._implementationz%requests.packages.urllib3.poolmanagerz!requests.packages.urllib3.requestz"requests.packages.urllib3.responsezrequests.packages.urllib3.utilz)requests.packages.urllib3.util.connectionz&requests.packages.urllib3.util.requestz'requests.packages.urllib3.util.responsez$requests.packages.urllib3.util.retryz#requests.packages.urllib3.util.ssl_z&requests.packages.urllib3.util.timeoutz"requests.packages.urllib3.util.urlZurllib3)�__doc__Z
__future__rZglobZos.path�osrZ	DEBUNDLED�path�abspath�dirname�__file__Z	WHEEL_DIRr�joinrrrr�<module>sr$site-packages/pip/_vendor/__pycache__/retrying.cpython-38.pyc000064400000017506151446177000020231 0ustar00U

��.e�&�@slddlZddlmZddlZddlZddlZdZdd�ZGdd�de�Z	Gdd	�d	e�Z
Gd
d�de�ZdS)�N)�sixi���?csBt��dkr,t�d�r,dd�}|�d�S��fdd�}|SdS)z�
    Decorator function that instantiates the Retrying object
    @param *dargs: positional arguments passed to Retrying object
    @param **dkw: keyword arguments passed to the Retrying object
    �rcst����fdd��}|S)Ncst�j�f|�|�S�N��Retrying�call��args�kw��f��8/usr/lib/python3.8/site-packages/pip/_vendor/retrying.py�	wrapped_f$sz-retry.<locals>.wrap_simple.<locals>.wrapped_f�r�wraps�rrr
rr�wrap_simple"szretry.<locals>.wrap_simplecst������fdd��}|S)Ncst���j�f|�|�Srrr)�dargs�dkwrr
rr/sz&retry.<locals>.wrap.<locals>.wrapped_frr�rrrr�wrap-szretry.<locals>.wrapN)�len�callable)rrrrr
rr�retrys
rc@sneZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�ZdS)rNFcs|dkrdn||_|dkrdn||_|dkr0dn||_|dkrBdn||_|dkrTdn||_|dkrfdn||_|	dkrxdn|	|_|
dkr�dn|
|_|dkr�tn||_	|dkr�dn||_
g�|dk	r̈�|j�|dk	r��|j
�|dk	r�||_n&|dk�r
�fdd�|_nt||�|_dd�g�|dk	�r6��|j�|dk	�sJ|dk	�rV��|j�|dk	�sj|	dk	�rv��|j�|
dk	�s�|dk	�r���|j�|dk	�r�||_n&|dk�r‡fd	d�|_nt||�|_|dk�r�|j|_n||_|
dk�r�|j|_n|
|_||_dS)
N��d��rrcst��fdd��D��S)Nc3s|]}|���VqdSrr
��.0r�ZattemptsZdelayr
r�	<genexpr>as�6Retrying.__init__.<locals>.<lambda>.<locals>.<genexpr>)�anyr )�
stop_funcsr r�<lambda>a�z#Retrying.__init__.<locals>.<lambda>c_sdS)Nrr
)r	�kwargsr
r
rr%hr&cst��fdd��D��S)Nc3s|]}|���VqdSrr
rr r
rr!ysr")�maxr )�
wait_funcsr rr%yr&)�_stop_max_attempt_number�_stop_max_delay�_wait_fixed�_wait_random_min�_wait_random_max�_wait_incrementing_start�_wait_incrementing_increment�_wait_exponential_multiplier�MAX_WAIT�_wait_exponential_max�_wait_jitter_max�append�stop_after_attempt�stop_after_delay�stop�getattr�fixed_sleep�random_sleep�incrementing_sleep�exponential_sleep�wait�
always_reject�_retry_on_exception�never_reject�_retry_on_result�_wrap_exception)�selfr8r>Zstop_max_attempt_numberZstop_max_delayZ
wait_fixedZwait_random_minZwait_random_maxZwait_incrementing_startZwait_incrementing_incrementZwait_exponential_multiplierZwait_exponential_maxZretry_on_exceptionZretry_on_result�wrap_exceptionZ	stop_funcZ	wait_funcZwait_jitter_maxr
)r$r)r�__init__:sR








zRetrying.__init__cCs
||jkS)z;Stop after the previous attempt >= stop_max_attempt_number.)r*�rD�previous_attempt_number�delay_since_first_attempt_msr
r
rr6�szRetrying.stop_after_attemptcCs
||jkS)z=Stop after the time from the first attempt >= stop_max_delay.)r+rGr
r
rr7�szRetrying.stop_after_delaycCsdS)z#Don't sleep at all before retrying.rr
rGr
r
r�no_sleep�szRetrying.no_sleepcCs|jS)z0Sleep a fixed amount of time between each retry.)r,rGr
r
rr:�szRetrying.fixed_sleepcCst�|j|j�S)zISleep a random amount of time between wait_random_min and wait_random_max)�randomZrandintr-r.rGr
r
rr;�szRetrying.random_sleepcCs$|j|j|d}|dkr d}|S)z�
        Sleep an incremental amount of time after each attempt, starting at
        wait_incrementing_start and incrementing by wait_incrementing_increment
        rr)r/r0)rDrHrI�resultr
r
rr<�szRetrying.incrementing_sleepcCs2d|}|j|}||jkr"|j}|dkr.d}|S)N�r)r1r3)rDrHrIZexprLr
r
rr=�s

zRetrying.exponential_sleepcCsdS)NFr
�rDrLr
r
rrA�szRetrying.never_rejectcCsdS)NTr
rNr
r
rr?�szRetrying.always_rejectcCs4d}|jr ||�|jd�O}n||�|j�O}|S)NFr)�
has_exceptionr@�valuerB)rD�attemptZrejectr
r
r�
should_reject�s
zRetrying.should_rejectcOs�ttt��d��}d}zt|||�|d�}Wn t��}t||d�}YnX|�|�sf|�|j�Sttt��d��|}|�	||�r�|js�|j
r�|���q�t|��n<|�||�}	|j
r�t��|j
}
|	td|
�}	t�|	d�|d7}qdS)NrrFTrg@�@)�int�round�time�Attempt�sys�exc_inforR�getrCr8rO�
RetryErrorr>r4rKr(�sleep)rD�fnr	r'Z
start_time�attempt_numberrQ�tbrIr[Zjitterr
r
rr�s(


z
Retrying.call)NNNNNNNNNNNNNFNNN)�__name__�
__module__�__qualname__rFr6r7rJr:r;r<r=rAr?rRrr
r
r
rr8s:�
S
		rc@s*eZdZdZdd�Zd
dd�Zdd�Zd	S)rVz�
    An Attempt encapsulates a call to a target function that may end as a
    normal return value from the function or an Exception depending on what
    occurred during the execution.
    cCs||_||_||_dSr)rPr]rO)rDrPr]rOr
r
rrF�szAttempt.__init__FcCs@|jr6|rt|��q<t�|jd|jd|jd�n|jSdS)z�
        Return the return value of this Attempt instance or raise an Exception.
        If wrap_exception is true, this Attempt is wrapped inside of a
        RetryError before being raised.
        rrrMN)rOrZrZreraiserP)rDrEr
r
rrY�s

"zAttempt.getc	Cs:|jr&d�|jd�t�|jd���Sd�|j|j�SdS)NzAttempts: {0}, Error:
{1}�rMzAttempts: {0}, Value: {1})rO�formatr]�join�	traceback�	format_tbrP�rDr
r
r�__repr__�s zAttempt.__repr__N)F)r_r`ra�__doc__rFrYrhr
r
r
rrV�s
rVc@s eZdZdZdd�Zdd�ZdS)rZzU
    A RetryError encapsulates the last Attempt instance right before giving up.
    cCs
||_dSr)�last_attempt)rDrjr
r
rrFszRetryError.__init__cCsd�|j�S)NzRetryError[{0}])rcrjrgr
r
r�__str__
szRetryError.__str__N)r_r`rarirFrkr
r
r
rrZsrZ)
rKZpip._vendorrrWrUrer2r�objectrrV�	ExceptionrZr
r
r
r�<module>s*!site-packages/pip/_vendor/__pycache__/appdirs.cpython-38.opt-1.pyc000064400000047725151446177000020775 0ustar00U

��.e�_�@s`dZdZd�eee��ZddlZddlZejddkZ	e	r>eZ
ej�d�r�ddlZe�
�ddZe�d�rrdZq�e�d	�r�d
Zq�dZnejZd4d
d�Zd5dd�Zd6dd�Zd7dd�Zd8dd�Zd9dd�Zd:dd�ZGdd�de�Zdd�Zd d!�Zd"d#�Zd$d%�Zedk�rfzdd&lmZeZWnBe k
�rdzddl!Z"eZWne k
�r^eZYnXYnXe#d'k�r\d(Z$d)Z%d*Z&e'd+e�e'd,�ee$e%d-d.�Z(e&D]Z)e'd/e)e*e(e)�f��q�e'd0�ee$e%�Z(e&D]Z)e'd/e)e*e(e)�f��q�e'd1�ee$�Z(e&D]Z)e'd/e)e*e(e)�f��qe'd2�ee$dd3�Z(e&D]Z)e'd/e)e*e(e)�f��q>dS);zyUtilities for determining application-specific dirs.

See <http://github.com/ActiveState/appdirs> for details and usage.
)����.�Nr�javaZWindows�win32ZMac�darwinZlinux2FcCs�tdkr^|dkr|}|rdpd}tj�t|��}|r�|dk	rNtj�|||�}q�tj�||�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aJReturn full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        Mac OS X:               ~/Library/Application Support/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    rN�
CSIDL_APPDATA�CSIDL_LOCAL_APPDATAFrz~/Library/Application Support/Z
XDG_DATA_HOMEz~/.local/share��system�os�path�normpath�_get_win_folder�join�
expanduser�getenv)�appname�	appauthor�version�roaming�constr�r�7/usr/lib/python3.8/site-packages/pip/_vendor/appdirs.py�
user_data_dir-s& rcstdkrR|dkr�}tj�td��}�r�|dk	rBtj�||��}q�tj�|��}n�tdkrztj�d�}�r�tj�|��}ntt�dtj�dd	g��}d
d�|�	tj�D�}�r�|r�tj��|���fdd�|D�}|r�tj�|�}n|d
}|S��r|�rtj�||�}|S)aiReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of data dirs should be
            returned. By default, the first item from XDG_DATA_DIRS is
            returned, or '/usr/local/share/<AppName>',
            if XDG_DATA_DIRS is not set

    Typical site data directories are:
        Mac OS X:   /Library/Application Support/<AppName>
        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.

    For Unix, this is using the $XDG_DATA_DIRS[0] default.

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    rN�CSIDL_COMMON_APPDATAFrz/Library/Application SupportZ
XDG_DATA_DIRSz/usr/local/sharez
/usr/sharecSs g|]}tj�|�tj���qSr�r
rr�rstrip�sep��.0�xrrr�
<listcomp>�sz!site_data_dir.<locals>.<listcomp>csg|]}tj�|�g��qSr�r
rrr �rrrr#�sr)
rr
rrrrrr�pathsep�split�rrr�	multipathrZpathlistrr%r�
site_data_dirds6�r*cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)a�Return full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user config directories are:
        Mac OS X:               same as user_data_dir
        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    �rrNZXDG_CONFIG_HOMEz	~/.config�rrr
rrrr�rrrrrrrr�user_config_dir�sr.cs�tdkr*t�|�}�r�|r�tj�||�}ndt�dd�}dd�|�tj�D�}�rt|rbtj��|���fdd�|D�}|r�tj�|�}n|d}|S)aReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of config dirs should be
            returned. By default, the first item from XDG_CONFIG_DIRS is
            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set

    Typical site config directories are:
        Mac OS X:   same as site_data_dir
        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
                    $XDG_CONFIG_DIRS
        Win *:      same as site_data_dir
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)

    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    r+ZXDG_CONFIG_DIRSz/etc/xdgcSs g|]}tj�|�tj���qSrrr rrrr#�sz#site_config_dir.<locals>.<listcomp>csg|]}tj�|�g��qSrr$r r%rrr#�sr)rr*r
rrrr'r&r(rr%r�site_config_dir�s
r/TcCs�tdkrd|dkr|}tj�td��}|r�|dk	rBtj�|||�}ntj�||�}|r�tj�|d�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aReturn full path to the user-specific cache dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Cache" to the base app data dir for Windows. See
            discussion below.

    Typical user cache directories are:
        Mac OS X:   ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go in
    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
    app data dir (the default returned by `user_data_dir` above). Apps typically
    put cache data somewhere *under* the given dir here. Some examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0
    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    This can be disabled with the `opinion=False` option.
    rNr
FZCacherz~/Library/CachesZXDG_CACHE_HOMEz~/.cacher�rrrZopinionrrrr�user_cache_dirs(!r1cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)aReturn full path to the user-specific state dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user state directories are:
        Mac OS X:  same as user_data_dir
        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
        Win *:     same as user_data_dir

    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
    to extend the XDG spec and support $XDG_STATE_HOME.

    That means, by default "~/.local/state/<AppName>".
    r+NZXDG_STATE_HOMEz~/.local/stater,r-rrr�user_state_dir:sr2cCs�tdkr tj�tj�d�|�}nNtdkrLt|||�}d}|rntj�|d�}n"t|||�}d}|rntj�|d�}|r�|r�tj�||�}|S)a�Return full path to the user-specific log dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Logs" to the base app data dir for Windows, and "log" to the
            base cache dir for Unix. See discussion below.

    Typical user log directories are:
        Mac OS X:   ~/Library/Logs/<AppName>
        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs

    On Windows the only suggestion in the MSDN docs is that local settings
    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
    examples of what some windows apps use for a logs dir.)

    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
    value for Windows and appends "log" to the user cache dir for Unix.
    This can be disabled with the `opinion=False` option.
    rz~/Library/LogsrFZLogs�log)rr
rrrrr1r0rrr�user_log_dirds" 
�r4c@sneZdZdZddd�Zedd��Zedd	��Zed
d��Zedd
��Z	edd��Z
edd��Zedd��ZdS)�AppDirsz1Convenience wrapper for getting application dirs.NFcCs"||_||_||_||_||_dS)N)rrrrr))�selfrrrrr)rrr�__init__�s
zAppDirs.__init__cCst|j|j|j|jd�S�N)rr)rrrrr�r6rrrr�s
�zAppDirs.user_data_dircCst|j|j|j|jd�S�N)rr))r*rrrr)r9rrrr*�s
�zAppDirs.site_data_dircCst|j|j|j|jd�Sr8)r.rrrrr9rrrr.�s
�zAppDirs.user_config_dircCst|j|j|j|jd�Sr:)r/rrrr)r9rrrr/�s
�zAppDirs.site_config_dircCst|j|j|jd�S�N�r)r1rrrr9rrrr1�s
�zAppDirs.user_cache_dircCst|j|j|jd�Sr;)r2rrrr9rrrr2�s
�zAppDirs.user_state_dircCst|j|j|jd�Sr;)r4rrrr9rrrr4�s
�zAppDirs.user_log_dir)NNNFF)
�__name__�
__module__�__qualname__�__doc__r7�propertyrr*r.r/r1r2r4rrrrr5�s&�






r5cCsHtrddl}nddl}dddd�|}|�|jd�}|�||�\}}|S)z�This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    rNZAppDatazCommon AppDataz
Local AppData�r	rr
z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)�PY3�winreg�_winreg�OpenKey�HKEY_CURRENT_USERZQueryValueEx)�
csidl_namerEZshell_folder_name�key�dir�typerrr�_get_win_folder_from_registry�s
���rLcCs�ddlm}m}|�dt||�dd�}z^t|�}d}|D]}t|�dkr8d}qRq8|r�zddl}|�|�}Wnt	k
r�YnXWnt
k
r�YnX|S)Nr)�shellcon�shellF�T)Zwin32com.shellrMrN�SHGetFolderPath�getattr�unicode�ord�win32api�GetShortPathName�ImportError�UnicodeError)rHrMrNrJ�
has_high_char�crTrrr�_get_win_folder_with_pywin32�s$
rZcCs�ddl}dddd�|}|�d�}|jj�d|dd|�d}|D]}t|�dkr@d	}qZq@|r�|�d�}|jj�|j|d�r�|}|jS)
Nr��#�rBiFrOT)	�ctypesZcreate_unicode_buffer�windllZshell32ZSHGetFolderPathWrSZkernel32ZGetShortPathNameW�value)rHr^Zcsidl_const�bufrXrYZbuf2rrr�_get_win_folder_with_ctypes�s&��

rbcCs�ddl}ddlm}ddlm}|jjd}|�d|�}|jj	}|�
dt|j|�d|jj
|�|j�|����d�}d}|D]}	t|	�dkr|d	}q�q||r�|�d|�}|jj	}
|
�|||�r�|j�|����d�}|S)
Nr)�jna)r�rY�FrOT)�arrayZcom.sunrcZcom.sun.jna.platformrZWinDefZMAX_PATHZzerosZShell32ZINSTANCErPrQZShlObjZSHGFP_TYPE_CURRENTZNativeZtoStringZtostringrrSZKernel32rU)rHrfrcrZbuf_sizerarNrJrXrYZkernelrrr�_get_win_folder_with_jnas&rg)r_�__main__ZMyAppZ	MyCompany)rr.r1r2r4r*r/z-- app dirs %s --z%-- app dirs (with optional 'version')z1.0r<z%s: %sz)
-- app dirs (without optional 'version')z+
-- app dirs (without optional 'appauthor')z(
-- app dirs (with disabled 'appauthor'))r)NNNF)NNNF)NNNF)NNNF)NNNT)NNNF)NNNT)+r@Z__version_info__r�map�str�__version__�sysr
�version_inforCrR�platform�
startswithZjava_verZos_namerrr*r.r/r1r2r4�objectr5rLrZrbrgr^r_rrVZcom.sun.jnaZcomr=rrZprops�print�dirsZproprQrrrr�<module>sv



7
B
(
3
9
*
30


site-packages/pip/_vendor/__pycache__/distro.cpython-38.pyc000064400000107275151446177000017675 0ustar00U

��.e��@s~dZddlZddlZddlZddlZddlZddlZddlZddlZej	�
dd�ZdZddiZ
dddd	�Zd
diZe�d�Ze�d�Zd
ddedfZd@dd�Zdd�ZdAdd�ZdBdd�ZdCdd�ZdDdd�ZdEdd �ZdFd!d"�Zd#d$�Zd%d&�ZdGd'd(�Zd)d*�Zd+d,�Z d-d.�Z!d/d0�Z"d1d2�Z#d3d4�Z$d5d6�Z%d7d8�Z&Gd9d:�d:e'�Z(Gd;d<�d<e'�Z)e)�Z*d=d>�Z+e,d?k�rze+�dS)Ha
The ``distro`` package (``distro`` stands for Linux Distribution) provides
information about the Linux distribution it runs on, such as a reliable
machine-readable distro ID, or version information.

It is the recommended replacement for Python's original
:py:func:`platform.linux_distribution` function, but it provides much more
functionality. An alternative implementation became necessary because Python
3.5 deprecated this function, and Python 3.8 will remove it altogether.
Its predecessor function :py:func:`platform.dist` was already
deprecated since Python 2.6 and will also be removed in Python 3.8.
Still, there are many cases in which access to OS distribution information
is needed. See `Python issue 1322 <https://bugs.python.org/issue1322>`_ for
more information.
�NZUNIXCONFDIRz/etcz
os-releaseZolZoracleZrhel)ZenterpriseenterpriseZredhatenterpriseworkstationZredhatenterpriseserverZredhatzA(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)z(\w+)[-_](release|version)$Zdebian_versionzlsb-releasezoem-releasezsystem-releaseTcCs
t�|�S)a
    Return information about the current OS distribution as a tuple
    ``(id_name, version, codename)`` with items as follows:

    * ``id_name``:  If *full_distribution_name* is false, the result of
      :func:`distro.id`. Otherwise, the result of :func:`distro.name`.

    * ``version``:  The result of :func:`distro.version`.

    * ``codename``:  The result of :func:`distro.codename`.

    The interface of this function is compatible with the original
    :py:func:`platform.linux_distribution` function, supporting a subset of
    its parameters.

    The data it returns may not exactly be the same, because it uses more data
    sources than the original function, and that may lead to different data if
    the OS distribution is not consistent across multiple data sources it
    provides (there are indeed such distributions ...).

    Another reason for differences is the fact that the :func:`distro.id`
    method normalizes the distro ID string to a reliable machine-readable value
    for a number of popular OS distributions.
    )�_distro�linux_distribution)�full_distribution_name�r�6/usr/lib/python3.8/site-packages/pip/_vendor/distro.pyrasrcCst��S)a$
    Return the distro ID of the current distribution, as a
    machine-readable string.

    For a number of OS distributions, the returned distro ID value is
    *reliable*, in the sense that it is documented and that it does not change
    across releases of the distribution.

    This package maintains the following reliable distro ID values:

    ==============  =========================================
    Distro ID       Distribution
    ==============  =========================================
    "ubuntu"        Ubuntu
    "debian"        Debian
    "rhel"          RedHat Enterprise Linux
    "centos"        CentOS
    "fedora"        Fedora
    "sles"          SUSE Linux Enterprise Server
    "opensuse"      openSUSE
    "amazon"        Amazon Linux
    "arch"          Arch Linux
    "cloudlinux"    CloudLinux OS
    "exherbo"       Exherbo Linux
    "gentoo"        GenToo Linux
    "ibm_powerkvm"  IBM PowerKVM
    "kvmibm"        KVM for IBM z Systems
    "linuxmint"     Linux Mint
    "mageia"        Mageia
    "mandriva"      Mandriva Linux
    "parallels"     Parallels
    "pidora"        Pidora
    "raspbian"      Raspbian
    "oracle"        Oracle Linux (and Oracle Enterprise Linux)
    "scientific"    Scientific Linux
    "slackware"     Slackware
    "xenserver"     XenServer
    "openbsd"       OpenBSD
    "netbsd"        NetBSD
    "freebsd"       FreeBSD
    ==============  =========================================

    If you have a need to get distros for reliable IDs added into this set,
    or if you find that the :func:`distro.id` function returns a different
    distro ID for one of the listed distros, please create an issue in the
    `distro issue tracker`_.

    **Lookup hierarchy and transformations:**

    First, the ID is obtained from the following sources, in the specified
    order. The first available and non-empty value is used:

    * the value of the "ID" attribute of the os-release file,

    * the value of the "Distributor ID" attribute returned by the lsb_release
      command,

    * the first part of the file name of the distro release file,

    The so determined ID value then passes the following transformations,
    before it is returned by this method:

    * it is translated to lower case,

    * blanks (which should not be there anyway) are translated to underscores,

    * a normalization of the ID is performed, based upon
      `normalization tables`_. The purpose of this normalization is to ensure
      that the ID is as reliable as possible, even across incompatible changes
      in the OS distributions. A common reason for an incompatible change is
      the addition of an os-release file, or the addition of the lsb_release
      command, with ID values that differ from what was previously determined
      from the distro release file name.
    )r�idrrrrr}sKrFcCs
t�|�S)ak
    Return the name of the current OS distribution, as a human-readable
    string.

    If *pretty* is false, the name is returned without version or codename.
    (e.g. "CentOS Linux")

    If *pretty* is true, the version and codename are appended.
    (e.g. "CentOS Linux 7.1.1503 (Core)")

    **Lookup hierarchy:**

    The name is obtained from the following sources, in the specified order.
    The first available and non-empty value is used:

    * If *pretty* is false:

      - the value of the "NAME" attribute of the os-release file,

      - the value of the "Distributor ID" attribute returned by the lsb_release
        command,

      - the value of the "<name>" field of the distro release file.

    * If *pretty* is true:

      - the value of the "PRETTY_NAME" attribute of the os-release file,

      - the value of the "Description" attribute returned by the lsb_release
        command,

      - the value of the "<name>" field of the distro release file, appended
        with the value of the pretty version ("<version_id>" and "<codename>"
        fields) of the distro release file, if available.
    )r�name��prettyrrrr�s$rcCst�||�S)av
    Return the version of the current OS distribution, as a human-readable
    string.

    If *pretty* is false, the version is returned without codename (e.g.
    "7.0").

    If *pretty* is true, the codename in parenthesis is appended, if the
    codename is non-empty (e.g. "7.0 (Maipo)").

    Some distributions provide version numbers with different precisions in
    the different sources of distribution information. Examining the different
    sources in a fixed priority order does not always yield the most precise
    version (e.g. for Debian 8.2, or CentOS 7.1).

    The *best* parameter can be used to control the approach for the returned
    version:

    If *best* is false, the first non-empty version number in priority order of
    the examined sources is returned.

    If *best* is true, the most precise version number out of all examined
    sources is returned.

    **Lookup hierarchy:**

    In all cases, the version number is obtained from the following sources.
    If *best* is false, this order represents the priority order:

    * the value of the "VERSION_ID" attribute of the os-release file,
    * the value of the "Release" attribute returned by the lsb_release
      command,
    * the version number parsed from the "<version_id>" field of the first line
      of the distro release file,
    * the version number parsed from the "PRETTY_NAME" attribute of the
      os-release file, if it follows the format of the distro release files.
    * the version number parsed from the "Description" attribute returned by
      the lsb_release command, if it follows the format of the distro release
      files.
    )r�version�r
�bestrrrr�s)rcCs
t�|�S)a�
    Return the version of the current OS distribution as a tuple
    ``(major, minor, build_number)`` with items as follows:

    * ``major``:  The result of :func:`distro.major_version`.

    * ``minor``:  The result of :func:`distro.minor_version`.

    * ``build_number``:  The result of :func:`distro.build_number`.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�
version_parts�r
rrrrsrcCs
t�|�S)a5
    Return the major version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The major version is the first
    part of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�
major_versionrrrrr/s
rcCs
t�|�S)a6
    Return the minor version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The minor version is the second
    part of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�
minor_versionrrrrr<s
rcCs
t�|�S)a3
    Return the build number of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The build number is the third part
    of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�build_numberrrrrrIs
rcCst��S)a
    Return a space-separated list of distro IDs of distributions that are
    closely related to the current OS distribution in regards to packaging
    and programming interfaces, for example distributions the current
    distribution is a derivative from.

    **Lookup hierarchy:**

    This information item is only provided by the os-release file.
    For details, see the description of the "ID_LIKE" attribute in the
    `os-release man page
    <http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
    )r�likerrrrrVsrcCst��S)a�
    Return the codename for the release of the current OS distribution,
    as a string.

    If the distribution does not have a codename, an empty string is returned.

    Note that the returned codename is not always really a codename. For
    example, openSUSE returns "x86_64". This function does not handle such
    cases in any special way and just returns the string it finds, if any.

    **Lookup hierarchy:**

    * the codename within the "VERSION" attribute of the os-release file, if
      provided,

    * the value of the "Codename" attribute returned by the lsb_release
      command,

    * the value of the "<codename>" field of the distro release file.
    )r�codenamerrrrrgsrcCst�||�S)a�
    Return certain machine-readable information items about the current OS
    distribution in a dictionary, as shown in the following example:

    .. sourcecode:: python

        {
            'id': 'rhel',
            'version': '7.0',
            'version_parts': {
                'major': '7',
                'minor': '0',
                'build_number': ''
            },
            'like': 'fedora',
            'codename': 'Maipo'
        }

    The dictionary structure and keys are always the same, regardless of which
    information items are available in the underlying data sources. The values
    for the various keys are as follows:

    * ``id``:  The result of :func:`distro.id`.

    * ``version``:  The result of :func:`distro.version`.

    * ``version_parts -> major``:  The result of :func:`distro.major_version`.

    * ``version_parts -> minor``:  The result of :func:`distro.minor_version`.

    * ``version_parts -> build_number``:  The result of
      :func:`distro.build_number`.

    * ``like``:  The result of :func:`distro.like`.

    * ``codename``:  The result of :func:`distro.codename`.

    For a description of the *pretty* and *best* parameters, see the
    :func:`distro.version` method.
    )r�inforrrrrs)rcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the os-release file data source of the current OS distribution.

    See `os-release file`_ for details about these information items.
    )r�os_release_inforrrrr�srcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the lsb_release command data source of the current OS distribution.

    See `lsb_release command output`_ for details about these information
    items.
    )r�lsb_release_inforrrrr�srcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.

    See `distro release file`_ for details about these information items.
    )r�distro_release_inforrrrr�srcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.
    )r�
uname_inforrrrr�srcCs
t�|�S)a�
    Return a single named information item from the os-release file data source
    of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `os-release file`_ for details about these information items.
    )r�os_release_attr��	attributerrrr�srcCs
t�|�S)a�
    Return a single named information item from the lsb_release command output
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `lsb_release command output`_ for details about these information
    items.
    )r�lsb_release_attrrrrrr�srcCs
t�|�S)a�
    Return a single named information item from the distro release file
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `distro release file`_ for details about these information items.
    )r�distro_release_attrrrrrr�srcCs
t�|�S)aZ
    Return a single named information item from the distro release file
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
                The empty string, if the item does not exist.
    )r�
uname_attrrrrrrsrc@s eZdZdZdd�Zdd�ZdS)�cached_propertyz�A version of @property which caches the value.  On access, it calls the
    underlying function and sets the value in `__dict__` so future accesses
    will not re-call the property.
    cCs|j|_||_dS)N)�__name__�_fname�_f)�self�frrr�__init__"szcached_property.__init__cCs2|dk	std�|j���|�|�}|j|j<|S)Nzcall {} on an instance)�AssertionError�formatr"r#�__dict__)r$�obj�owner�retrrr�__get__&szcached_property.__get__N)r!�
__module__�__qualname__�__doc__r&r-rrrrr sr c@s2eZdZdZdBdd�Zdd�ZdCdd	�Zd
d�ZdDd
d�ZdEdd�Z	dFdd�Z
dGdd�ZdHdd�ZdIdd�Z
dd�Zdd�ZdJdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zed/d0��Zed1d2��Zed3d4��Zed5d6��Zed7d8��Zed9d:��Z ed;d<��Z!d=d>�Z"ed?d@��Z#dAS)K�LinuxDistributiona
    Provides information about a OS distribution.

    This package creates a private module-global instance of this class with
    default initialization arguments, that is used by the
    `consolidated accessor functions`_ and `single source accessor functions`_.
    By using default initialization arguments, that module-global instance
    returns data about the current OS distribution (i.e. the distro this
    package runs on).

    Normally, it is not necessary to create additional instances of this class.
    However, in situations where control is needed over the exact data sources
    that are used, instances of this class can be created with a specific
    distro release file, or a specific os-release file, or without invoking the
    lsb_release command.
    T�cCs.|ptj�tt�|_|pd|_||_||_dS)ao
        The initialization method of this class gathers information from the
        available data sources, and stores that in private instance attributes.
        Subsequent access to the information items uses these private instance
        attributes, so that the data sources are read only once.

        Parameters:

        * ``include_lsb`` (bool): Controls whether the
          `lsb_release command output`_ is included as a data source.

          If the lsb_release command is not available in the program execution
          path, the data source for the lsb_release command will be empty.

        * ``os_release_file`` (string): The path name of the
          `os-release file`_ that is to be used as a data source.

          An empty string (the default) will cause the default path name to
          be used (see `os-release file`_ for details).

          If the specified or defaulted os-release file does not exist, the
          data source for the os-release file will be empty.

        * ``distro_release_file`` (string): The path name of the
          `distro release file`_ that is to be used as a data source.

          An empty string (the default) will cause a default search algorithm
          to be used (see `distro release file`_ for details).

          If the specified distro release file does not exist, or if no default
          distro release file can be found, the data source for the distro
          release file will be empty.

        * ``include_name`` (bool): Controls whether uname command output is
          included as a data source. If the uname command is not available in
          the program execution path the data source for the uname command will
          be empty.

        Public instance attributes:

        * ``os_release_file`` (string): The path name of the
          `os-release file`_ that is actually used as a data source. The
          empty string if no distro release file is used as a data source.

        * ``distro_release_file`` (string): The path name of the
          `distro release file`_ that is actually used as a data source. The
          empty string if no distro release file is used as a data source.

        * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
          This controls whether the lsb information will be loaded.

        * ``include_uname`` (bool): The result of the ``include_uname``
          parameter. This controls whether the uname information will
          be loaded.

        Raises:

        * :py:exc:`IOError`: Some I/O issue with an os-release file or distro
          release file.

        * :py:exc:`subprocess.CalledProcessError`: The lsb_release command had
          some issue (other than not being available in the program execution
          path).

        * :py:exc:`UnicodeError`: A data source has unexpected characters or
          uses an unexpected encoding.
        r2N)	�os�path�join�_UNIXCONFDIR�_OS_RELEASE_BASENAME�os_release_file�distro_release_file�include_lsb�
include_uname)r$r:r8r9r;rrrr&>sH�
zLinuxDistribution.__init__cCsdj|d�S)z Return repr of all info
        aeLinuxDistribution(os_release_file={self.os_release_file!r}, distro_release_file={self.distro_release_file!r}, include_lsb={self.include_lsb!r}, include_uname={self.include_uname!r}, _os_release_info={self._os_release_info!r}, _lsb_release_info={self._lsb_release_info!r}, _distro_release_info={self._distro_release_info!r}, _uname_info={self._uname_info!r})�r$)r(r<rrr�__repr__�s	��zLinuxDistribution.__repr__cCs"|r|��n|��|��|��fS)z�
        Return information about the OS distribution that is compatible
        with Python's :func:`platform.linux_distribution`, supporting a subset
        of its parameters.

        For details, see :func:`distro.linux_distribution`.
        )rrrr)r$rrrrr�s	�z$LinuxDistribution.linux_distributioncCsldd�}|�d�}|r ||t�S|�d�}|r8||t�S|�d�}|rP||t�S|�d�}|rh||t�SdS)zoReturn the distro ID of the OS distribution, as a string.

        For details, see :func:`distro.id`.
        cSs|���dd�}|�||�S)N� �_)�lower�replace�get)�	distro_id�tablerrr�	normalize�sz'LinuxDistribution.id.<locals>.normalizer�distributor_idr2)r�NORMALIZED_OS_IDr�NORMALIZED_LSB_IDr�NORMALIZED_DISTRO_IDr)r$rErCrrrr�s







zLinuxDistribution.idFcCs||�d�p&|�d�p&|�d�p&|�d�}|rt|�d�p>|�d�}|st|�d�pV|�d�}|jdd�}|rt|d|}|pzdS)	zu
        Return the name of the OS distribution, as a string.

        For details, see :func:`distro.name`.
        rrF�pretty_name�descriptionTr	r>r2)rrrrr)r$r
rrrrrr�s&
���
�
�zLinuxDistribution.namec	Cs�|�d�|�d�|�d�|�|�d���dd�|�|�d���dd�|�d�g}d}|r�|D]$}|�d�|�d�ks||dkr\|}q\n|D]}|dkr�|}q�q�|r�|r�|��r�d�||���}|S)z{
        Return the version of the OS distribution, as a string.

        For details, see :func:`distro.version`.
        �
version_id�releaserJr2rK�.z	{0} ({1}))	rrr�_parse_distro_release_contentrBr�countrr()r$r
r
Zversionsr�vrrrr�s:�����
zLinuxDistribution.versioncCsL|j|d�}|rHt�d�}|�|�}|rH|��\}}}||p>d|pDdfSdS)z�
        Return the version of the OS distribution, as a tuple of version
        numbers.

        For details, see :func:`distro.version_parts`.
        rz(\d+)\.?(\d+)?\.?(\d+)?r2)r2r2r2)r�re�compile�match�groups)r$r
Zversion_strZ
version_regex�matches�major�minorrrrrr�s

zLinuxDistribution.version_partscCs|�|�dS)z�
        Return the major version number of the current distribution.

        For details, see :func:`distro.major_version`.
        r�r�r$r
rrrrszLinuxDistribution.major_versioncCs|�|�dS)z�
        Return the minor version number of the current distribution.

        For details, see :func:`distro.minor_version`.
        �rYrZrrrrszLinuxDistribution.minor_versioncCs|�|�dS)z}
        Return the build number of the current distribution.

        For details, see :func:`distro.build_number`.
        �rYrZrrrrszLinuxDistribution.build_numbercCs|�d�pdS)z�
        Return the IDs of distributions that are like the OS distribution.

        For details, see :func:`distro.like`.
        Zid_liker2)rr<rrrr#szLinuxDistribution.likecCs>z|jdWStk
r8|�d�p2|�d�p2dYSXdS)zp
        Return the codename of the OS distribution.

        For details, see :func:`distro.codename`.
        rr2N)�_os_release_info�KeyErrorrrr<rrrr+s
��zLinuxDistribution.codenamec	CsBt|��|�||�t|�|�|�|�|�|�d�|��|��d�S)z�
        Return certain machine-readable information about the OS
        distribution.

        For details, see :func:`distro.info`.
        )rWrXr)rrrrr)�dictrrrrrrr)r$r
r
rrrr:s
��zLinuxDistribution.infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the os-release file data source of the OS distribution.

        For details, see :func:`distro.os_release_info`.
        )r]r<rrrrMsz!LinuxDistribution.os_release_infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the lsb_release command data source of the OS
        distribution.

        For details, see :func:`distro.lsb_release_info`.
        )�_lsb_release_infor<rrrrVsz"LinuxDistribution.lsb_release_infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the distro release file data source of the OS
        distribution.

        For details, see :func:`distro.distro_release_info`.
        )�_distro_release_infor<rrrr`sz%LinuxDistribution.distro_release_infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the uname command data source of the OS distribution.

        For details, see :func:`distro.uname_info`.
        )�_uname_infor<rrrrjszLinuxDistribution.uname_infocCs|j�|d�S)z�
        Return a single named information item from the os-release file data
        source of the OS distribution.

        For details, see :func:`distro.os_release_attr`.
        r2)r]rB�r$rrrrrssz!LinuxDistribution.os_release_attrcCs|j�|d�S)z�
        Return a single named information item from the lsb_release command
        output data source of the OS distribution.

        For details, see :func:`distro.lsb_release_attr`.
        r2)r`rBrcrrrr|sz"LinuxDistribution.lsb_release_attrcCs|j�|d�S)z�
        Return a single named information item from the distro release file
        data source of the OS distribution.

        For details, see :func:`distro.distro_release_attr`.
        r2)rarBrcrrrr�sz%LinuxDistribution.distro_release_attrcCs|j�|d�S)z�
        Return a single named information item from the uname command
        output data source of the OS distribution.

        For details, see :func:`distro.uname_release_attr`.
        r2)rbrBrcrrrr�szLinuxDistribution.uname_attrc
Cs:tj�|j�r6t|j��}|�|�W5QR�SQRXiS)z�
        Get the information items from the specified os-release file.

        Returns:
            A dictionary containing all information items.
        )r3r4�isfiler8�open�_parse_os_release_content)r$Zrelease_filerrrr]�sz"LinuxDistribution._os_release_infocCsi}tj|dd�}d|_tjddkr@t|jt�r@|j�d�|_t|�}|D]>}d|krL|�	dd�\}}t|t�r||�d�}|||�
�<qLqLd	|kr�|d	|d
<nbd|kr�|d|d
<nLd|k�rt�d
|d�}|�r|�
�}|�d�}|�d�}|��}||d
<|S)aD
        Parse the lines of an os-release file.

        Parameters:

        * lines: Iterable through the lines in the os-release file.
                 Each line must be a unicode string or a UTF-8 encoded byte
                 string.

        Returns:
            A dictionary containing all information items.
        T)�posixrr\z
iso-8859-1�=r[�utf-8Zversion_codenamerZubuntu_codenamerz(\(\D+\))|,(\s+)?\D+z()�,)�shlexZwhitespace_split�sys�version_info�
isinstanceZ	wordchars�bytes�decode�list�splitr@rR�search�group�strip)�lines�propsZlexer�tokens�token�krQrrrrrf�s4	




z+LinuxDistribution._parse_os_release_contentc
Csz|js
iSttjd��B}zd}tj||d�}Wn$tk
rRiYW5QR�SXW5QRX|�t�	���
�}|�|�S)z�
        Get the information items from the lsb_release command output.

        Returns:
            A dictionary containing all information items.
        �w)Zlsb_releasez-a��stderr)r:rer3�devnull�
subprocess�check_output�OSErrorrprl�getfilesystemencoding�
splitlines�_parse_lsb_release_content�r$r~�cmd�stdoutZcontentrrrr`�s z#LinuxDistribution._lsb_release_infocCsXi}|D]J}|�d��dd�}t|�dkr,q|\}}|�|�dd���|��i�q|S)aM
        Parse the output of the lsb_release command.

        Parameters:

        * lines: Iterable through the lines of the lsb_release output.
                 Each line must be a unicode string or a UTF-8 encoded byte
                 string.

        Returns:
            A dictionary containing all information items.
        �
�:r[r\r>r?)rurr�len�updaterAr@)rvrw�lineZkvrzrQrrrr��s z,LinuxDistribution._parse_lsb_release_contentc
Cspttjd��B}zd}tj||d�}Wn$tk
rHiYW5QR�SXW5QRX|�t����	�}|�
|�S)Nr{)�unamez-rsr|)rer3r~rr�r�rprlr�r��_parse_uname_contentr�rrrrbs zLinuxDistribution._uname_infocCsTi}t�d|d���}|rP|��\}}|dkr4iS|��|d<||d<||d<|S)Nz^([^\s]+)\s+([\d\.]+)rZLinuxrrrM)rRrsrurUr@)rvrwrTrrrrrr�sz&LinuxDistribution._parse_uname_contentcCs0|jrb|�|j�}tj�|j�}t�|�}d|krLd|d��krLd|d<n|r^|�d�|d<|Szt�	t
�}|��Wn6tk
r�ddddd	d
ddd
ddddddg}YnX|D]r}|t
kr�q�t�|�}|r�tj�t
|�}|�|�}d|kr�||_|�d�|d<d|d��k�rd|d<|Sq�iSdS)z�
        Get the information items from the specified distro release file.

        Returns:
            A dictionary containing all information items.
        rZ
cloudlinuxrr[zSuSE-releasezarch-releasezbase-releasezcentos-releasezfedora-releasezgentoo-releasezmageia-releasezmandrake-releasezmandriva-releasezmandrivalinux-releasezmanjaro-releasezoracle-releasezredhat-releasez
sl-releasezslackware-versionN)r9�_parse_distro_release_filer3r4�basename� _DISTRO_RELEASE_BASENAME_PATTERNrTr@rt�listdirr6�sortr�� _DISTRO_RELEASE_IGNORE_BASENAMESr5)r$�distro_infor�rTZ	basenames�filepathrrrra.s^�
�

�



z&LinuxDistribution._distro_release_infoc
CsRz0t|��}|�|���W5QR�WSQRXWnttfk
rLiYSXdS)z�
        Parse a distro release file.

        Parameters:

        * filepath: Path name of the distro release file.

        Returns:
            A dictionary containing all information items.
        N)rerO�readliner��IOError)r$r��fprrrr�rs

&z,LinuxDistribution._parse_distro_release_filecCs�t|t�r|�d�}t�|��ddd��}i}|r�|�d�ddd�|d<|�d�rn|�d�ddd�|d<|�d�r�|�d�ddd�|d	<n|r�|��|d<|S)
a
        Parse a line from a distro release file.

        Parameters:
        * line: Line from the distro release file. Must be a unicode string
                or a UTF-8 encoded byte string.

        Returns:
            A dictionary containing all information items.
        riN����rr\rLr[r)rnrorp�(_DISTRO_RELEASE_CONTENT_REVERSED_PATTERNrTrurt)r�rVr�rrrrO�s

�

z/LinuxDistribution._parse_distro_release_contentN)Tr2r2T)T)F)FF)F)F)F)F)FF)$r!r.r/r0r&r=rrrrrrrrrrrrrrrrrrrr r]�staticmethodrfr`r�rbr�rar�rOrrrrr1,sV�
N


"




	

					

B





Cr1cCs�t�t�}|�tj�|�t�tj��t	j
dd�}|jddddd�|��}|j
rn|�t
jt�dd	d
��n:|�dtd	d��td	d�}|�d
|�t�}|�d|�dS)NzOS distro info tool)rKz--jsonz-jz!Output in machine readable format�
store_true)�help�action�T)�indentZ	sort_keyszName: %sr	zVersion: %szCodename: %s)�loggingZ	getLoggerr!ZsetLevel�DEBUGZ
addHandlerZ
StreamHandlerrlr��argparse�ArgumentParser�add_argument�
parse_args�jsonr�dumpsrrr)Zlogger�parser�argsZdistribution_versionZdistribution_codenamerrr�main�s$
�
r��__main__)T)F)FF)F)F)F)F)FF)-r0r3rRrlr�rkr�r�r�environrBr6r7rGrHrIrSr�r�r�rrrrrrrrrrrrrrrrrrr�objectr r1rr�r!rrrr�<module>sz
������	
N
'
,





,

}
site-packages/pip/_vendor/__pycache__/six.cpython-38.pyc000064400000063434151446177000017172 0ustar00U

��.e�~�C@s�dZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d3d4�e)d5d(d#d6d5�e)d7d(e
�rd8nd9d:�e)d;d(d<�e)d=d>d?d@�e)d d d�e)dAdAdB�e)dCdCdB�e)dDdDdB�e)d6d(d#d6d5�e)dEd"d#dFdE�e)dGd"d"dHdG�e&d#d(�e&dIdJ�e&dKdL�e&dMdNdO�e&dPdQdP�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdkdl�e&dmdndo�e&dpdpdq�e&drdrdq�e&dsdsdq�e&dtdtdu�e&dvdw�e&dxdy�e&dzd{�e&d|d}d|�e&d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g@Z.ejd�k�rfe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rje,�3e/d�e/j1��qj[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d@d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d�d�d΃e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dڡGd�d܄d�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q>[/e8e7_.e,�3e7e+d��d�d�Gd�d�d�e(�Z9e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�d	d�d�g#Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d
��d�d�G�d
�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�dd��d�gZ<e<D]Z/e0e;e/j1e/��q�[/e<e;_.e,�3e;e+�d��d�d�G�d�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d �d!�Z@�d"�d#�ZAe�	r��d$ZB�d%ZC�d&ZD�d'ZE�d(ZF�d)ZGn$�d*ZB�d+ZC�d,ZD�d-ZE�d.ZF�d/ZGzeHZIWn"eJk
�	r��d0�d1�ZIYnXeIZHzeKZKWn"eJk
�
r�d2�d3�ZKYnXe�
rF�d4�d5�ZLejMZN�d6�d7�ZOeZPn>�d8�d5�ZL�d9�d:�ZN�d;�d7�ZOG�d<�d=��d=e�ZPeKZKe#eL�d>�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�r(�d?�d@�ZX�dA�dB�ZY�dC�dD�ZZ�dE�dF�Z[e�\�dG�Z]e�\�dH�Z^e�\�dI�Z_nT�dJ�d@�ZX�dK�dB�ZY�dL�dD�ZZ�dM�dF�Z[e�\�dN�Z]e�\�dO�Z^e�\�dP�Z_e#eX�dQ�e#eY�dR�e#eZ�dS�e#e[�dT�e�rD�dU�dV�Z`�dW�dX�ZaebZcddldZded�e�dY�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp�dZZqej
�d[�d[k�r6�d\Zr�d]Zsn�d^Zr�d_Zsnj�d`�dV�Z`�da�dX�ZaecZcebZg�db�dc�Zi�dd�de�Zke�tejuev�ZmddloZoeojoZoZp�dfZq�d\Zr�d]Zse#e`�dg�e#ea�dh��di�dZ�Zw�dj�d^�Zx�dk�d_�Zye�
reze4j{�dl�Z|�d��dm�dn�Z}n�d��do�dp�Z|e|�dq�ej
dd��drk�
rLe|�ds�n.ej
dd��drk�
rne|�dt�n�du�dv�Z~eze4j{�dwd�Zedk�
r��dx�dy�Zej
dd��dzk�
r�eZ��d{�dy�Ze#e}�d|�ej
dd�dk�
r�ej�ej�f�d}�d~�Z�nej�Z��d�d��Z��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��Z�gZ�e+Z�e�����d��dk	�rzge�_�ej��r�e�ej��D]4\Z�Z�ee��j+dk�r�e�j1e+k�r�ej�e�=�qq�[�[�ej���e,�dS(�z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.12.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�3/usr/lib/python3.8/site-packages/pip/_vendor/six.py�__len__>sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Xsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__[sz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrriszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrrszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__us
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'gs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr~sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__�sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4|sr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdbZ	getoutputZcommands�
subprocess�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_basezemail.MIMEBasezemail.mime.baseZemail_mime_imagezemail.MIMEImagezemail.mime.imageZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrruBsruZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZunquote_to_bytesZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
splitvalueZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrvrrrrrxlsrxZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrvrrrrrz�srzZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassZparse_http_listZparse_keqv_listz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrvrrrrr|�sr|Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrvrrrrr~�sr~ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacerwryr{r}rcCsdddddgS)N�parse�error�request�responserqrr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rqr8rrrrr��s




r�zmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_move�sr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rt�__dict__rFrrrr�remove_move�sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iteratorsr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callablesr�cCs|Srr�Zunboundrrr�get_unbound_functionsr�cCs|Srr�r�clsrrr�create_unbound_method#sr�cCs|jSr)r�r�rrrr�(scCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_method+sr�cCst�|d|�Sr)r�r�r�rrrr�.sc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�3sz
Iterator.nextN)r
rrr�rrrrr�1sr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeysDsr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesGsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsJsr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistsMsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�VscKs|jf|�Sr)r�r�rrrr�YscKs|jf|�Sr)r�r�rrrr�\scKs|jf|�Sr)r�r�rrrr�_s�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�bqsr�cCs|Srrr�rrr�utsr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs:z*|dkr|�}|j|k	r$|�|��|�W5d}d}XdSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s

r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�zedef reraise(tp, value, tb=None):
    try:
        raise tp, value, tb
    finally:
        tb = None
)rrz�def raise_from(value, from_value):
    try:
        if from_value is None:
            raise value
        raise value from from_value
    finally:
        value = None
zrdef raise_from(value, from_value):
    try:
        raise value from from_value
    finally:
        value = None
cCs|�dSrr)r1Z
from_valuerrr�
raise_from�sr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr��s

��zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_�sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�s

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rd�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapper*szwraps.<locals>.wrapperr)r�r�r�r�rr�rr�(sr�cs&G��fdd�dt�}t�|ddi�S)z%Create a base class with a metaclass.cs,eZdZ��fdd�Ze��fdd��ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�r�
this_basesr���bases�metarr�__new__:sz)with_metaclass.<locals>.metaclass.__new__cs��|��Sr)�__prepare__)r�rr�r�rrr�=sz-with_metaclass.<locals>.metaclass.__prepare__N)r
rrr��classmethodr�rr�rr�	metaclass8sr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclass3sr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.cs||j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd�t|d�rl|j|d<�|j|j	|�S)N�	__slots__r��__weakref__r)
r��copyr�rIr�r�rMrr
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr�Es




zadd_metaclass.<locals>.wrapperr)r�r�rrr�
add_metaclassCs
r�utf-8r�cCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce **s** to six.binary_type.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> encoded to `bytes`
      - `bytes` -> `bytes`
    �not expecting type '%s'N)rI�	text_typer��binary_typer�r��r�r�r�rrr�
ensure_binaryUs


r	cCsXt|ttf�stdt|���tr:t|t�r:|�||�}ntrTt|t�rT|�||�}|S)z�Coerce *s* to `str`.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    r)	rIrrr�r��PY2r�r)�decoderrrr�
ensure_strhsrcCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce *s* to six.text_type.

    For Python 2:
      - `unicode` -> `unicode`
      - `str` -> `unicode`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    rN)rIrrrr�r�rrrr�ensure_text|s


r
cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nr)�__unicode__r�r	rrr�<lambda>��z-python_2_unicode_compatible.<locals>.<lambda>)r
r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible�s
�
r�__spec__)N)NN)rr�)rr�)rr�)�rZ
__future__rrdrU�operatorrr��
__author__�__version__�version_infor
r)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesr�bytesr�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArtruZ_urllib_parse_moved_attributesrxZ_urllib_error_moved_attributesrzZ _urllib_request_moved_attributesr|Z!_urllib_response_moved_attributesr~Z$_urllib_robotparser_moved_attributesr�r�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�rr	rr
rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>s


>































��


�


�F�























��


��
























�%�����
��





��



5��
site-packages/pip/_vendor/__pycache__/pyparsing.cpython-38.opt-1.pyc000064400000705501151446177000021340 0ustar00U

��.e,�s@s�dZdZdZdZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZddlmZddlZdd	lmZzdd
lmZWn ek
r�ddlmZYnXzddlmZWn ek
r�ddlmZYnXz dd
lmZddlmZm Z Wn2ek
�rNdd
l
mZddl
mZm Z YnXzddl
m!Z"WnBek
�r�zddl#m!Z"Wnek
�r�dZ"YnXYnXzddlm$Z$Wn$ek
�r�Gdd�d�Z$YnXe$�Z%de%_de%_&e$�Z'de'_de'_(de'_)de'_*de'_+de'_,dddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�gsZ-e.e	j/�dd��Z0e0dd�kZ1e1�rVe	j2Z3e4Z5e6Z7e4Z8e4Z9e:e;e<e=e>e.e?e@eAeBeCgZDn`e	jEZ3eFZGd�d��Z9gZDddlHZHd��I�D]8ZJzeD�KeLeHeJ��WneMk
�r�Y�q|YnX�q|eNd�d��eGd��D��ZOd�d��ZPejQejRZSd�ZTeTd�ZUeSeTZVe6d��ZWd��Xd�d��ejYD��ZZ�dYd�d��Z[Gd�d4�d4e\�Z]Gd�d6�d6e]�Z^Gd�d8�d8e]�Z_Gd�d:�d:e_�Z`Gd�d=�d=e\�ZaGd�d��d�eb�ZcGd�d9�d9eb�Zde�eed�d�dQ�Zfd�db�Zgd�d_�Zhd�d��Zid�d��Zjd�d��Zkd�di�Zl�dZd�d��ZmGd�d;�d;eb�ZnGd�d��d�en�ZoGd�dC�dCen�ZpGd�d#�d#ep�ZqGd�d.�d.ep�ZrGd�d+�d+ep�ZsGd�d��d�es�ZtesZuesen_vGd�d(�d(ep�ZwGd�d�des�ZxGd�d�dew�ZyGd�d��d�ep�ZzGd�dF�dFep�Z{Gd�d��d�e{�Z|Gd�dJ�dJe|�Z}Gd�d>�d>ep�Z~Gd�d<�d<ep�ZGd�d�dep�Z�Gd�dE�dEep�Z�Gd�dĄd�ep�Z�Gd�d&�d&e��Z�Gd�d*�d*e��Z�Gd�d)�d)e��Z�Gd�dA�dAe��Z�Gd�d@�d@e��Z�Gd�dH�dHe��Z�Gd�dG�dGe��Z�Gd�d7�d7en�Z�Gd�d�de��Z�Gd�d3�d3e��Z�Gd�d-�d-e��Z�Gd�d"�d"e��Z�Gd�d5�d5en�Z�Gd�d$�d$e��Z�Gd�d,�d,e��Z�Gd�d/�d/e��Z�Gd�dքd�e��Z�Gd�d0�d0e��Z�Gd�dI�dIe��Z�Gd�dڄd�eb�Z�Gd�d2�d2e��Z�Gd�d?�d?e��Z�Gd�d%�d%e��Z�Gd�dD�dDe��Z�Gd�d �d e��Z�Gd�d'�d'e��Z�Gd�d!�d!e��Z�Gd�dB�dBe��Z�Gd�d1�d1eb�Z�d�dz�Z��d[d�dX�Z��d\d�dT�Z�d�d�Z�d�dg�Z�d�df�Z�d�d�Z��d]d�dk�Z�d�dY�Z��d^d�d�Z�d�d��Z�d�d��Z�eq���d[�Z�e����da�Z�e����d`�Z�e����dy�Z�e����dx�Z�e{eWd�d�d���d�d���Z�e~d����d�d���Z�e~d����d�d���Z�e�e�Be�Be�d�d�d�BZ�e�e�e�d��e��Z�esd��e�d����d��e�e�e�e�B�����d��dZ��ddw�Z��dde�Z��ddt�Z��ddr�Z��dd��Z�e��dd���Z�e��dd���Z�e��d	�e��d
�f�d�d�Z��d
dc�Zddd�ZÐdd}�Z�eb�e�_Őd_�dd��Z�e$�Z�eb�e�_�eb�e�_�e��d�e��d�f�dd��Z�e�Z�e�e~�d��d����d�Z�e�e~�d��d����d�Z�e�e~�d��de~�d��dB����d�Z�e�eu�d�eΠ�����d�Zϐd�ddeΠ�f�ddh�ZАd`�dd~�Z�e��d�Z�e��d �Z�e�e{eSeV�d!����d"��\Z�Z�e�eאd#�I��d$��Z�e~�d%�d&�Xeؠ١��d'����d(�Zڐd)ds�Z�e�e~�d*��d+����d,�Z�e~�d-����d.�Z�e~�d/��ޡ���d0�Z�e~�d1����d2�Z�e�e~�d*��d+e�B����d3�Z�e�Z�e~�d4����d5�Z�e�e�e{eZd�d6�e�e{�d7�esd�e����������d8�Z�e�e�eΠ�e�Bd��d9����dR�Z�G�d:d��d��Z�G�d;�d<��d<eb�Z�G�d=d��d�eb�Z�G�d>d��d�e�Z�e�j�j�j�e�j�j�j�e�j�j�j�e�j�_�e1�
rXe�e�d?e�j�e�e�d@e�j�e�e�dAe�j�e�e�dBe�j�e�e�dCe�j��e�e�dDe�j�e�e�j�dEe�j�j�e�e�j�dFe�j�j�e�e�j�dGe�j�j�e�e�dHe�j��e�e�dIe�j��e�e�dJe�j��e��dKk�r�ex�dL�Z�ex�dM�Z�e{eSeV�dN�Z�e�e��dOd�dP���e��Z�e�e�e������dQ�Z��dRe�BZ�e�e��dOd�dP���e���Ze�e��e�����dS��Ze��dT�e��dQ�e��e�dS��Z�e���dU�e�j���dV�e�j���dV�e�j���dW�dd�l�Ze�j��e��e�j��e�j���dX�dS(aa�

pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and
executing simple grammars, vs. the traditional lex/yacc approach, or the
use of regular expressions.  With pyparsing, you don't need to learn
a new syntax for defining grammars or matching expressions - the parsing
module provides a library of classes that you use to construct the
grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form
``"<salutation>, <addressee>!"``), built up using :class:`Word`,
:class:`Literal`, and :class:`And` elements
(the :class:`'+'<ParserElement.__add__>` operators create :class:`And` expressions,
and the strings are auto-converted to :class:`Literal` expressions)::

    from pip._vendor.pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the
self-explanatory class names, and the use of '+', '|' and '^' operators.

The :class:`ParseResults` object returned from
:class:`ParserElement.parseString` can be
accessed as a nested list, a dictionary, or an object with named
attributes.

The pyparsing module handles some of the problems that are typically
vexing when writing text parsers:

  - extra or missing whitespace (the above program will also handle
    "Hello,World!", "Hello  ,  World  !", etc.)
  - quoted strings
  - embedded comments


Getting Started -
-----------------
Visit the classes :class:`ParserElement` and :class:`ParseResults` to
see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:

 - construct literal match expressions from :class:`Literal` and
   :class:`CaselessLiteral` classes
 - construct character word-group expressions using the :class:`Word`
   class
 - see how to create repetitive expressions using :class:`ZeroOrMore`
   and :class:`OneOrMore` classes
 - use :class:`'+'<And>`, :class:`'|'<MatchFirst>`, :class:`'^'<Or>`,
   and :class:`'&'<Each>` operators to combine simple expressions into
   more complex ones
 - associate names with your parsed results using
   :class:`ParserElement.setResultsName`
 - access the parsed data, which is returned as a :class:`ParseResults`
   object
 - find some helpful expression short-cuts like :class:`delimitedList`
   and :class:`oneOf`
 - find more useful common expressions in the :class:`pyparsing_common`
   namespace class
z2.4.2z29 Jul 2019 02:58 UTCz*Paul McGuire <ptmcg@users.sourceforge.net>�N)�ref)�datetime)�
itemgetter)�wraps)�filterfalse)�ifilterfalse)�RLock)�Iterable)�MutableMapping�Mapping)�OrderedDict)�SimpleNamespacec@seZdZdS)r
N)�__name__�
__module__�__qualname__�rr�9/usr/lib/python3.8/site-packages/pip/_vendor/pyparsing.pyr
�sr
aA
    A cross-version compatibility configuration for pyparsing features that will be
    released in a future version. By setting values in this configuration to True,
    those features can be enabled in prior versions for compatibility development
    and testing.

     - collect_all_And_tokens - flag to enable fix for Issue #63 that fixes erroneous grouping
       of results names when an And expression is nested within an Or or MatchFirst; set to
       True to enable bugfix released in pyparsing 2.3.0, or False to preserve
       pre-2.3.0 handling of named results
Ta�
Diagnostic configuration (all default to False)
     - warn_multiple_tokens_in_named_alternation - flag to enable warnings when a results
       name is defined on a MatchFirst or Or expression with one or more And subexpressions
       (only warns if __compat__.collect_all_And_tokens is False)
     - warn_ungrouped_named_tokens_in_collection - flag to enable warnings when a results
       name is defined on a containing expression with ungrouped subexpressions that also
       have results names
     - warn_name_set_on_empty_Forward - flag to enable warnings whan a Forward is defined
       with a results name, but has no contents defined
     - warn_on_multiple_string_args_to_oneof - flag to enable warnings whan oneOf is
       incorrectly called with multiple str arguments
     - enable_debug_on_named_expressions - flag to auto-enable debug on all subsequent
       calls to ParserElement.setName()
F�__version__�__versionTime__�
__author__�
__compat__�__diag__�And�CaselessKeyword�CaselessLiteral�
CharsNotIn�Combine�Dict�Each�Empty�
FollowedBy�Forward�
GoToColumn�Group�Keyword�LineEnd�	LineStart�Literal�
PrecededBy�
MatchFirst�NoMatch�NotAny�	OneOrMore�OnlyOnce�Optional�Or�ParseBaseException�ParseElementEnhance�ParseException�ParseExpression�ParseFatalException�ParseResults�ParseSyntaxException�
ParserElement�QuotedString�RecursiveGrammarException�Regex�SkipTo�	StringEnd�StringStart�Suppress�Token�TokenConverter�White�Word�WordEnd�	WordStart�
ZeroOrMore�Char�	alphanums�alphas�
alphas8bit�anyCloseTag�
anyOpenTag�
cStyleComment�col�commaSeparatedList�commonHTMLEntity�countedArray�cppStyleComment�dblQuotedString�dblSlashComment�
delimitedList�dictOf�downcaseTokens�empty�hexnums�htmlComment�javaStyleComment�line�lineEnd�	lineStart�lineno�makeHTMLTags�makeXMLTags�matchOnlyAtCol�matchPreviousExpr�matchPreviousLiteral�
nestedExpr�nullDebugAction�nums�oneOf�opAssoc�operatorPrecedence�
printables�punc8bit�pythonStyleComment�quotedString�removeQuotes�replaceHTMLEntity�replaceWith�
restOfLine�sglQuotedString�srange�	stringEnd�stringStart�traceParseAction�
unicodeString�upcaseTokens�
withAttribute�
indentedBlock�originalTextFor�ungroup�
infixNotation�locatedExpr�	withClass�
CloseMatch�tokenMap�pyparsing_common�pyparsing_unicode�unicode_set�conditionAsParseAction�cCsft|t�r|Sz
t|�WStk
r`t|��t��d�}td�}|�dd��|�	|�YSXdS)aDrop-in replacement for str(obj) that tries to be Unicode
        friendly. It first tries str(obj). If that fails with
        a UnicodeEncodeError, then it tries unicode(obj). It then
        < returns the unicode object | encodes it with the default
        encoding | ... >.
        �xmlcharrefreplacez&#\d+;cSs$dtt|ddd���dd�S)Nz\ur����)�hex�int��trrr�<lambda>��z_ustr.<locals>.<lambda>N)
�
isinstance�unicode�str�UnicodeEncodeError�encode�sys�getdefaultencodingr:�setParseAction�transformString)�obj�retZ
xmlcharrefrrr�_ustr�s

r�z6sum len sorted reversed list tuple set any all min maxccs|]
}|VqdS�Nr)�.0�yrrr�	<genexpr>sr��cCs:d}dd�d��D�}t||�D]\}}|�||�}q |S)z/Escape &, <, >, ", ', etc. in a string of data.z&><"'css|]}d|dVqdS)�&�;Nr)r��srrrr�sz_xml_escape.<locals>.<genexpr>zamp gt lt quot apos)�split�zip�replace)�dataZfrom_symbolsZ
to_symbolsZfrom_Zto_rrr�_xml_escapes
r��
0123456789ZABCDEFabcdef�\�ccs|]}|tjkr|VqdSr�)�stringZ
whitespace�r��crrrr�s
cs@|dk	r|nd�|rtnt�t���t�����fdd��}|S)Nzfailed user-defined conditioncs t�|||��s�||���dSr�)�bool�r��lr���exc_type�fn�msgrr�pasz"conditionAsParseAction.<locals>.pa)r4r2�_trim_arityr)r��message�fatalr�rr�rr�sc@sPeZdZdZddd�Zedd��Zdd	�Zd
d�Zdd
�Z	ddd�Z
dd�ZdS)r0z7base exception class for all parsing runtime exceptionsrNcCs>||_|dkr||_d|_n||_||_||_|||f|_dS�Nr�)�locr��pstr�
parserElement�args)�selfr�r�r��elemrrr�__init__(szParseBaseException.__init__cCs||j|j|j|j�S)z�
        internal factory method to simplify creating one type of ParseException
        from another - avoids having __init__ signature conflicts among subclasses
        )r�r�r�r�)�cls�perrr�_from_exception3sz"ParseBaseException._from_exceptioncCsN|dkrt|j|j�S|dkr,t|j|j�S|dkrBt|j|j�St|��dS)z�supported attributes by name are:
           - lineno - returns the line number of the exception text
           - col - returns the column number of the exception text
           - line - returns the line containing the exception text
        r^)rM�columnr[N)r^r�r�rMr[�AttributeError)r�Zanamerrr�__getattr__;szParseBaseException.__getattr__cCs^|jr@|jt|j�krd}qDd|j|j|jd��dd�}nd}d|j||j|j|jfS)Nz, found end of textz
, found %rr�z\\�\r�z%%s%s  (at char %d), (line:%d, col:%d))r�r��lenr�r�r^r�)r�Zfoundstrrrr�__str__Js$�zParseBaseException.__str__cCst|�Sr��r��r�rrr�__repr__TszParseBaseException.__repr__�>!<cCs<|j}|jd}|r4d�|d|�|||d�f�}|��S)z�Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        r�r�N)r[r��join�strip)r�ZmarkerStringZline_strZline_columnrrr�
markInputlineVs

�z ParseBaseException.markInputlinecCsd��tt|��S)Nzlineno col line)r��dir�typer�rrr�__dir__`szParseBaseException.__dir__)rNN)r�)rrr�__doc__r��classmethodr�r�r�r�r�r�rrrrr0$s




c@seZdZdZeddd��ZdS)r2a:
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
    - lineno - returns the line number of the exception text
    - col - returns the column number of the exception text
    - line - returns the line containing the exception text

    Example::

        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))

    prints::

       Expected integer (at char 0), (line:1, col:1)
        column: 1

    �cCspddl}|dkrt��}g}t|t�rJ|�|j�|�d|jdd�|�d�t	|�j
|��|dk�rf|j|j|d�}t
�}t||d��D]�\}}|d}|j�dd�}	t|	t��r|jjd	kr�q�|	|kr�q�|�|	�t	|	�}
|�d
�|
j|
j
|	��nP|	dk	�r,t	|	�}
|�d�|
j|
j
��n&|j}|jdk�r@q�|�d
�|j��|d8}|s��qfq�d�|�S)ap
        Method to take an exception and translate the Python internal traceback into a list
        of the pyparsing expressions that caused the exception to be raised.

        Parameters:

         - exc - exception raised during parsing (need not be a ParseException, in support
           of Python exceptions that might be raised in a parse action)
         - depth (default=16) - number of levels back in the stack trace to list expression
           and function names; if None, the full stack trace names will be listed; if 0, only
           the failing input line, marker, and exception string will be shown

        Returns a multi-line string listing the ParserElements and/or function names in the
        exception's stack trace.

        Note: the diagnostic output will include string representations of the expressions
        that failed to parse. These representations will be more helpful if you use `setName` to
        give identifiable names to your expressions. Otherwise they will use the default string
        forms, which may be cryptic to read.

        explain() is only supported under Python 3.
        rN� r��^z{0}: {1})�contextr�)�	parseImpl�
_parseNoCachez
{0}.{1} - {2}z{0}.{1})�wrapperz<module>z{0}�
)�inspectr��getrecursionlimitr�r0�appendr[rM�formatr�rZgetinnerframes�
__traceback__�set�	enumerate�f_locals�getr7�f_code�co_name�addrr�)�exc�depthr�r�Zcallers�seen�iZffZfrmZf_selfZ	self_type�coderrr�explainzsL


�
�zParseException.explainN)r�)rrrr��staticmethodr�rrrrr2csc@seZdZdZdS)r4znuser-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediatelyN�rrrr�rrrrr4�sc@seZdZdZdS)r6z�just like :class:`ParseFatalException`, but thrown internally
    when an :class:`ErrorStop<And._ErrorStop>` ('-' operator) indicates
    that parsing is to stop immediately because an unbacktrackable
    syntax error has been found.
    Nr�rrrrr6�sc@s eZdZdZdd�Zdd�ZdS)r9ziexception thrown by :class:`ParserElement.validate` if the
    grammar could be improperly recursive
    cCs
||_dSr��ZparseElementTrace�r��parseElementListrrrr��sz"RecursiveGrammarException.__init__cCs
d|jS)NzRecursiveGrammarException: %sr�r�rrrr��sz!RecursiveGrammarException.__str__N)rrrr�r�r�rrrrr9�sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�_ParseResultsWithOffsetcCs||f|_dSr���tup)r�Zp1Zp2rrrr��sz _ParseResultsWithOffset.__init__cCs
|j|Sr�r��r�r�rrr�__getitem__�sz#_ParseResultsWithOffset.__getitem__cCst|jd�S�Nr)�reprr�r�rrrr��sz _ParseResultsWithOffset.__repr__cCs|jd|f|_dSr�r�r�rrr�	setOffset�sz!_ParseResultsWithOffset.setOffsetN)rrrr�r�r�r�rrrrr��sr�c@s�eZdZdZd]dd�Zddddefdd�Zdd	�Zefd
d�Zdd
�Z	dd�Z
dd�Zdd�ZeZ
dd�Zdd�Zdd�Zdd�Zdd�Zer�eZeZeZn$eZeZeZdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd^d(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Z d2d3�Z!d4d5�Z"d6d7�Z#d8d9�Z$d:d;�Z%d<d=�Z&d_d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*d`dHdI�Z+dJdK�Z,dLdM�Z-dadOdP�Z.dQdR�Z/dSdT�Z0dUdV�Z1dWdX�Z2dYdZ�Z3e4dbd[d\��Z5dS)cr5aSStructured parse results, to provide multiple means of access to
    the parsed data:

       - as a list (``len(results)``)
       - by list index (``results[0], results[1]``, etc.)
       - by attribute (``results.<resultsName>`` - see :class:`ParserElement.setResultsName`)

    Example::

        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/'
                        + integer.setResultsName("month") + '/'
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)

    prints::

        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    NTcCs"t||�r|St�|�}d|_|S�NT)r��object�__new__�_ParseResults__doinit)r��toklist�name�asList�modalZretobjrrrrs


zParseResults.__new__c
Csd|jrvd|_d|_d|_i|_||_||_|dkr6g}||t�rP|dd�|_n||t�rft|�|_n|g|_t	�|_
|dk	�r`|�r`|s�d|j|<||t�r�t|�}||_||t
d�ttf�r�|ddgfk�s`||t�r�|g}|�r*||t��rtt|j�d�||<ntt|d�d�||<|||_n6z|d||<Wn$tttfk
�r^|||<YnXdS)NFrr�)r�_ParseResults__name�_ParseResults__parent�_ParseResults__accumNames�_ParseResults__asList�_ParseResults__modal�list�_ParseResults__toklist�_generatorType�dict�_ParseResults__tokdictr�r�r��
basestringr5r��KeyError�	TypeError�
IndexError)r�rrrrr�rrrr�"sB



$
zParseResults.__init__cCsPt|ttf�r|j|S||jkr4|j|ddStdd�|j|D��SdS)Nr�rcSsg|]}|d�qS�rr�r��vrrr�
<listcomp>Psz,ParseResults.__getitem__.<locals>.<listcomp>)r�r��slicerrrr5r�rrrr�Is


zParseResults.__getitem__cCs�||t�r0|j�|t��|g|j|<|d}nD||ttf�rN||j|<|}n&|j�|t��t|d�g|j|<|}||t�r�t|�|_	dSr�)
r�rr�rr�rrr5�wkrefr)r��krr��subrrr�__setitem__Rs


"
zParseResults.__setitem__c
Cs�t|ttf�r�t|j�}|j|=t|t�rH|dkr:||7}t||d�}tt|�|���}|��|j	�
�D]>\}}|D]0}t|�D]"\}\}}	t||	|	|k�||<q�qxqln|j	|=dS�Nrr�)
r�r�rr�rr�range�indices�reverser�itemsr�r�)
r�r�ZmylenZremovedr�occurrences�jr�value�positionrrr�__delitem___s

zParseResults.__delitem__cCs
||jkSr�)r)r�rrrr�__contains__tszParseResults.__contains__cCs
t|j�Sr�)r�rr�rrr�__len__wszParseResults.__len__cCs
|jSr��rr�rrr�__bool__zszParseResults.__bool__cCs
t|j�Sr���iterrr�rrr�__iter__~szParseResults.__iter__cCst|jddd��S�Nr�r+r�rrr�__reversed__�szParseResults.__reversed__cCs$t|jd�r|j��St|j�SdS)N�iterkeys)�hasattrrr0r,r�rrr�	_iterkeys�s
zParseResults._iterkeyscs�fdd����D�S)Nc3s|]}�|VqdSr�r�r�rr�rrr��sz+ParseResults._itervalues.<locals>.<genexpr>�r2r�rr�r�_itervalues�szParseResults._itervaluescs�fdd����D�S)Nc3s|]}|�|fVqdSr�rr3r�rrr��sz*ParseResults._iteritems.<locals>.<genexpr>r4r�rr�r�
_iteritems�szParseResults._iteritemscCst|���S)zVReturns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x).)rr0r�rrr�keys�szParseResults.keyscCst|���S)zXReturns all named result values (as a list in Python 2.x, as an iterator in Python 3.x).)r�
itervaluesr�rrr�values�szParseResults.valuescCst|���S)zfReturns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x).)r�	iteritemsr�rrrr!�szParseResults.itemscCs
t|j�S)z�Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names.)r�rr�rrr�haskeys�szParseResults.haskeyscOs�|s
dg}|��D]*\}}|dkr0|d|f}qtd|��qt|dt�sdt|�dksd|d|kr~|d}||}||=|S|d}|SdS)a�
        Removes and returns item at specified index (default= ``last``).
        Supports both ``list`` and ``dict`` semantics for ``pop()``. If
        passed no argument or an integer argument, it will use ``list``
        semantics and pop tokens from the list of parsed tokens. If passed
        a non-integer argument (most likely a string), it will use ``dict``
        semantics and pop the corresponding value from any defined results
        names. A second default return value argument is supported, just as in
        ``dict.pop()``.

        Example::

            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())

        prints::

            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        r��defaultrz-pop() got an unexpected keyword argument '%s'r�N)r!rr�r�r�)r�r��kwargsrr�indexr�Zdefaultvaluerrr�pop�s"%
�
�zParseResults.popcCs||kr||S|SdS)a[
        Returns named result matching the given key, or if there is no
        such name, then returns the given ``defaultValue`` or ``None`` if no
        ``defaultValue`` is specified.

        Similar to ``dict.get()``.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        Nr)r��key�defaultValuerrrr��szParseResults.getcCsR|j�||�|j��D]4\}}t|�D]"\}\}}t||||k�||<q(qdS)a
        Inserts new element at location index in the list of parsed tokens.

        Similar to ``list.insert()``.

        Example::

            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        N)r�insertrr!r�r�)r�r>ZinsStrrr"rr$r%rrrrBszParseResults.insertcCs|j�|�dS)a�
        Add single element to end of ParseResults list of elements.

        Example::

            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        N)rr�)r��itemrrrr�s
zParseResults.appendcCs&t|t�r|�|�n|j�|�dS)a	
        Add sequence of elements to end of ParseResults list of elements.

        Example::

            patt = OneOrMore(Word(alphas))

            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        N)r�r5�__iadd__r�extend)r�ZitemseqrrrrE's
zParseResults.extendcCs|jdd�=|j��dS)z7
        Clear all elements and results names.
        N)rr�clearr�rrrrF:szParseResults.clearcCs&z
||WStk
r YdSXdSr�)r�r�rrrrr�As
zParseResults.__getattr__cCs|��}||7}|Sr���copy)r��otherr�rrr�__add__GszParseResults.__add__cs�|jrjt|j���fdd��|j��}�fdd�|D�}|D],\}}|||<t|dt�r<t|�|d_q<|j|j7_|j�	|j�|S)Ncs|dkr�S|�Sr�r)�a)�offsetrrr�Or�z'ParseResults.__iadd__.<locals>.<lambda>c	s4g|],\}}|D]}|t|d�|d��f�qqS�rr�)r��r�r�vlistr)�	addoffsetrrrQs�z)ParseResults.__iadd__.<locals>.<listcomp>r)
rr�rr!r�r5rrr�update)r�rJZ
otheritemsZotherdictitemsrrr)rQrMrrDLs


�zParseResults.__iadd__cCs&t|t�r|dkr|��S||SdSr�)r�r�rI�r�rJrrr�__radd__\szParseResults.__radd__cCsdt|j�t|j�fS)Nz(%s, %s))r�rrr�rrrr�dszParseResults.__repr__cCsdd�dd�|jD��dS)N�[�, css(|] }t|t�rt|�nt|�VqdSr�)r�r5r�r��r�r�rrrr�hsz'ParseResults.__str__.<locals>.<genexpr>�])r�rr�rrrr�gszParseResults.__str__r�cCsLg}|jD]<}|r |r |�|�t|t�r8||��7}q
|�t|��q
|Sr�)rr�r�r5�
_asStringListr�)r��sep�outrCrrrrYjs


zParseResults._asStringListcCsdd�|jD�S)ax
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::

            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']

            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        cSs"g|]}t|t�r|��n|�qSr)r�r5r)r��resrrrr�sz'ParseResults.asList.<locals>.<listcomp>r)r�rrrruszParseResults.asListcs6tr|j}n|j}�fdd��t�fdd�|�D��S)a�
        Returns the named parse results as a nested dictionary.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})

            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        cs6t|t�r.|��r|��S�fdd�|D�Sn|SdS)Ncsg|]}�|��qSrrr��toItemrrr�sz7ParseResults.asDict.<locals>.toItem.<locals>.<listcomp>)r�r5r;�asDict�r�r]rrr^�s

z#ParseResults.asDict.<locals>.toItemc3s|]\}}|�|�fVqdSr�r�r�rrr]rrr��sz&ParseResults.asDict.<locals>.<genexpr>)�PY_3r!r:r)r�Zitem_fnrr]rr_�s
	zParseResults.asDictcCs<t|j�}t|j���|_|j|_|j�|j�|j|_|S)zG
        Returns a new copy of a :class:`ParseResults` object.
        )	r5rrrr!rrrRr�r�r�rrrrI�s
zParseResults.copyFcCsLd}g}tdd�|j��D��}|d}|s8d}d}d}d}	|dk	rJ|}	n|jrV|j}	|	sf|rbdSd}	|||d|	d	g7}t|j�D]�\}
}t|t�r�|
|kr�||�||
|o�|dk||�g7}n||�d|o�|dk||�g7}q�d}|
|kr�||
}|�s|�rq�nd}t	t
|��}
|||d|d	|
d
|d	g	7}q�|||d
|	d	g7}d�|�S)z�
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        r�css(|] \}}|D]}|d|fVqqdS�r�NrrOrrrr��s�z%ParseResults.asXML.<locals>.<genexpr>�  r�NZITEM�<�>�</)rrr!rr�rr�r5�asXMLr�r�r�)r�ZdoctagZnamedItemsOnly�indentZ	formatted�nlr[Z
namedItemsZnextLevelIndentZselfTagr�r\ZresTagZxmlBodyTextrrrri�s^

�

�
�zParseResults.asXMLcCs:|j��D]*\}}|D]\}}||kr|Sqq
dSr�)rr!)r�rrrPrr�rrrZ__lookup�s
zParseResults.__lookupcCs�|jr|jS|jr.|��}|r(|�|�SdSnNt|�dkrxt|j�dkrxtt|j����dddkrxtt|j����SdSdS)a
        Returns the results name for this token expression. Useful when several
        different expressions might match at a particular location.

        Example::

            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number")
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)

            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])

        prints::

            age : 22
            ssn : 111-22-3333
            house_number : 221B
        Nr�r)rr�)	rr�_ParseResults__lookupr�r�nextr,r9r7)r��parrrr�getName�s
��zParseResults.getNamercCsvg}d}|r$|�|t|����n
|�d�|�rl|��r�tdd�|��D��}|D]x\}}	|rl|�|�|�d|d||f�t|	t�r�|	r�|�|	j||||dd��q�|�t|	��qV|�t	|	��qVn�t
d	d�|D���rl|}	t|	�D]x\}
}t|t��r@|�d
|d||
|d|d|j||||dd�f�q�|�d
|d||
|d|dt|�f�q�d�|�S)aF
        Diagnostic method for listing out the contents of
        a :class:`ParseResults`. Accepts an optional ``indent`` argument so
        that this string can be embedded in a nested display of other data.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString('12/31/1999')
            print(result.dump())

        prints::

            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        r�r�css|]\}}t|�|fVqdSr�)r�rarrrr�?sz$ParseResults.dump.<locals>.<genexpr>z
%s%s- %s: rer�)rj�full�include_list�_depthcss|]}t|t�VqdSr�)r�r5)r��vvrrrr�Ksz
%s%s[%d]:
%s%s%s)
r�r�rr;�sortedr!r�r5�dumpr��anyr�r�)r�rjrprqrrr[�NLr!rrr�rsrrrru!sP



��


�
zParseResults.dumpcOstj|��f|�|�dS)a#
        Pretty-printer for parsed results as a list, using the
        `pprint <https://docs.python.org/3/library/pprint.html>`_ module.
        Accepts additional positional or keyword args as defined for
        `pprint.pprint <https://docs.python.org/3/library/pprint.html#pprint.pprint>`_ .

        Example::

            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)

        prints::

            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        N)�pprintr�r�r�r=rrrrxbszParseResults.pprintcCs.|j|j��|jdk	r|��p d|j|jffSr�)rrrIrrrr�rrr�__getstate__~s��zParseResults.__getstate__cCsN|d|_|d\|_}}|_i|_|j�|�|dk	rDt|�|_nd|_dSr)rrrrrRrr)r��staternZinAccumNamesrrr�__setstate__�s
zParseResults.__setstate__cCs|j|j|j|jfSr�)rrr	r
r�rrr�__getnewargs__�szParseResults.__getnewargs__cCstt|��t|���Sr�)r�r�rr7r�rrrr��szParseResults.__dir__cCsrdd�}|g�}|��D]>\}}t|t�r>||j||d�7}q|||g|||�d�7}q|dk	rn||g|d�}|S)z�
        Helper classmethod to construct a ParseResults from a dict, preserving the
        name-value relations as results names. If an optional 'name' argument is
        given, a nested ParseResults will be returned
        cSsHzt|�Wntk
r"YdSXtr8t|ttf�St|t�SdS�NF)r,�	Exceptionrbr�r��bytesrr`rrr�is_iterable�sz+ParseResults.from_dict.<locals>.is_iterable�r)rrN)r!r�r�	from_dict)r�rJrr�r�rrrrrr��s
zParseResults.from_dict)NNTT)N)r�)NFr�T)r�TTr)N)6rrrr�rr�r�r�rr&r'r(r*�__nonzero__r-r/r2r5r6rbr7r9r!r0r8r:r;r?r�rBr�rErFr�rKrDrTr�r�rYrr_rIrirlrorurxrzr|r}r�r�r�rrrrr5�sl*
	'	
7

$
=(
A
cCsF|}d|krt|�kr4nn||ddkr4dS||�dd|�S)a�Returns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See
   :class:`ParserElement.parseString` for more
   information on parsing strings containing ``<TAB>`` s, and suggested
   methods to maintain a consistent view of the parsed string, the parse
   location, and line and column positions within the parsed string.
   rr�r�)r��rfind)r��strgr�rrrrM�scCs|�dd|�dS)a�Returns current line number within a string, counting newlines as line separators.
    The first line is number 1.

    Note - the default parsing behavior is to expand tabs in the input string
    before starting the parsing process.  See :class:`ParserElement.parseString`
    for more information on parsing strings containing ``<TAB>`` s, and
    suggested methods to maintain a consistent view of the parsed string, the
    parse location, and line and column positions within the parsed string.
    r�rr�)�count)r�r�rrrr^�s
cCsF|�dd|�}|�d|�}|dkr2||d|�S||dd�SdS)zfReturns the line of text containing loc within a string, counting newlines as line separators.
       r�rr�N)r��find)r�r�ZlastCRZnextCRrrrr[�s
cCs8tdt|�dt|�dt||�t||�f�dS)NzMatch z at loc z(%d,%d))�printr�r^rM)�instringr��exprrrr�_defaultStartDebugAction�sr�cCs$tdt|�dt|����dS)NzMatched z -> )r�r�r�r)r��startlocZendlocr��toksrrr�_defaultSuccessDebugAction�sr�cCstdt|��dS)NzException raised:)r�r�)r�r�r�r�rrr�_defaultExceptionDebugAction�sr�cGsdS)zG'Do-nothing' debug action, to suppress debugging output during parsing.Nr)r�rrrre�sr�cs��tkr�fdd�Sdg�dg�tdd�dkrFddd�}dd	d
��ntj}tj�d}|dd�d
}|d|d|f�������fdd�}d}zt�dt�d�j�}Wntk
r�t��}YnX||_|S)Ncs�|�Sr�rr�)�funcrrr��r�z_trim_arity.<locals>.<lambda>rFr�)r��cSs8tdkrdnd}tj||dd�|}|dd�gS)N)r�r�r������r���limitr�)�system_version�	traceback�
extract_stack)r�rM�
frame_summaryrrrr�sz"_trim_arity.<locals>.extract_stackcSs$tj||d�}|d}|dd�gS)Nr�r�r�)r��
extract_tb)�tbr�Zframesr�rrrr�sz_trim_arity.<locals>.extract_tb�r�r�r�cs�z"�|�dd��}d�d<|WStk
r��dr>�nNz.t��d}�|dd�ddd��ksj�W5z~Wntk
r�YnXX�d�kr��dd7<Yq�YqXqdS)NrTr�r�r�r�)r�	NameErrorr��exc_info)r�r�r��r�Z
foundArityr�r��maxargsZpa_call_line_synthrrr�s&z_trim_arity.<locals>.wrapperz<parse action>r�	__class__)r)r)	�singleArgBuiltinsr�r�r�r��getattrrrr�)r�r�r�Z	LINE_DIFFZ	this_liner��	func_namerr�rr��s,

�r�cs�eZdZdZdZdZedd��Zedd��Zd�dd	�Z	d
d�Z
dd
�Zd�dd�Zd�dd�Z
d�dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd�d!d"�Zd#d$�Zd�d%d&�Zd'd(�Zd)d*�ZGd+d,�d,e�Zed-k	r�Gd.d/�d/e�ZnGd0d/�d/e�ZiZe�Z d1d1gZ!d�d2d3�Z"eZ#ed4d5��Z$dZ%ed�d7d8��Z&d�d9d:�Z'e(dfd;d<�Z)d=d>�Z*e(fd?d@�Z+e(dfdAdB�Z,dCdD�Z-dEdF�Z.dGdH�Z/dIdJ�Z0dKdL�Z1dMdN�Z2dOdP�Z3dQdR�Z4dSdT�Z5dUdV�Z6dWdX�Z7dYdZ�Z8d[d\�Z9d]d^�Z:d_d`�Z;d�dadb�Z<dcdd�Z=dedf�Z>dgdh�Z?didj�Z@dkdl�ZAdmdn�ZBd�dodp�ZCdqdr�ZDdsdt�ZEdudv�ZFdwdx�ZGd�dydz�ZHd�d{d|�ZI�fd}d~�ZJdd��ZKd�d��ZLd�d��ZMd�d��ZNd�d�d��ZOd�d�d��ZP�ZQS)�r7z)Abstract base level parser element class.z 
	
FcCs
|t_dS)a�
        Overrides the default whitespace chars

        Example::

            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']

            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        N)r7�DEFAULT_WHITE_CHARS��charsrrr�setDefaultWhitespaceCharsDsz'ParserElement.setDefaultWhitespaceCharscCs
|t_dS)ah
        Set class to be used for inclusion of string literals into a parser.

        Example::

            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        N)r7�_literalStringClass�r�rrr�inlineLiteralsUsingTsz!ParserElement.inlineLiteralsUsingcCs�t�|_d|_d|_d|_||_d|_ttj	�|_
d|_d|_d|_
t�|_d|_d|_d|_d|_d|_d|_d|_d|_d|_dS)NTFr�)NNN)r�parseAction�
failAction�strRepr�resultsName�
saveAsList�skipWhitespacer�r7r��
whiteChars�copyDefaultWhiteChars�mayReturnEmpty�keepTabs�ignoreExprs�debug�streamlined�
mayIndexError�errmsg�modalResults�debugActions�re�callPreparse�
callDuringTry)r��savelistrrrr�js(zParserElement.__init__cCs<t�|�}|jdd�|_|jdd�|_|jr8tj|_|S)a/
        Make a copy of this :class:`ParserElement`.  Useful for defining
        different parse actions for the same parsing pattern, using copies of
        the original parse element.

        Example::

            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0] * 1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")

            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))

        prints::

            [5120, 100, 655360, 268435456]

        Equivalent form of ``expr.copy()`` is just ``expr()``::

            integerM = integer().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")
        N)rIr�r�r�r7r�r�)r�ZcpyrrrrI�s
zParserElement.copycCs$||_d|j|_tjr |��|S)a_
        Define name for this expression, makes debugging and exception messages clearer.

        Example::

            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        �	Expected )rr�r�!enable_debug_on_named_expressions�setDebugrGrrr�setName�s
	zParserElement.setNamecCs|�||�S)aO
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original :class:`ParserElement` object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        ``expr("name")`` in place of ``expr.setResultsName("name")``
        - see :class:`__call__`.

        Example::

            date_str = (integer.setResultsName("year") + '/'
                        + integer.setResultsName("month") + '/'
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        )�_setResultsName�r�r�listAllMatchesrrr�setResultsName�szParserElement.setResultsNamecCs4|��}|�d�r"|dd�}d}||_||_|S)N�*r�T)rI�endswithr�r�)r�rr�Znewselfrrrr��s
zParserElement._setResultsNameTcs@|r&|j�d�fdd�	}�|_||_nt|jd�r<|jj|_|S)z�Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set ``breakFlag`` to True to enable, False to
           disable.
        Tcsddl}|���||||�Sr�)�pdbZ	set_trace)r�r��	doActions�callPreParser��Z_parseMethodrr�breaker�sz'ParserElement.setBreak.<locals>.breaker�_originalParseMethod)TT)�_parser�r1)r�Z	breakFlagr�rr�r�setBreak�s
zParserElement.setBreakcOsVt|�dgkrg|_n<tdd�|D��s0td��tttt|���|_|�dd�|_|S)a�
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as ``fn(s, loc, toks)`` ,
        ``fn(loc, toks)`` , ``fn(toks)`` , or just ``fn()`` , where:

        - s   = the original string being parsed (see note below)
        - loc = the location of the matching substring
        - toks = a list of the matched tokens, packaged as a :class:`ParseResults` object

        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        If None is passed as the parse action, all previously added parse actions for this
        expression are cleared.

        Optional keyword arguments:
        - callDuringTry = (default= ``False``) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See :class:`parseString for more
        information on parsing strings containing ``<TAB>`` s, and suggested
        methods to maintain a consistent view of the parsed string, the parse
        location, and line and column positions within the parsed string.

        Example::

            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        Ncss|]}t|�VqdSr�)�callable)r�r�rrrr�sz/ParserElement.setParseAction.<locals>.<genexpr>zparse actions must be callabler�F)rr��allr�mapr�r�r��r��fnsr=rrrr��s(zParserElement.setParseActioncOs4|jtttt|���7_|jp,|�dd�|_|S)z�
        Add one or more parse actions to expression's list of parse actions. See :class:`setParseAction`.

        See examples in :class:`copy`.
        r�F)r�rr�r�r�r�r�rrr�addParseActionszParserElement.addParseActionc
OsF|D](}|j�t||�d�|�dd�d��q|jp>|�dd�|_|S)a�Add a boolean predicate function to expression's list of parse actions. See
        :class:`setParseAction` for function call signatures. Unlike ``setParseAction``,
        functions passed to ``addCondition`` need to return boolean success/fail of the condition.

        Optional keyword arguments:
        - message = define a custom message to be used in the raised exception
        - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException

        Example::

            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        r�r�F)r�r�r�)r�r�r�r�r�)r�r�r=r�rrr�addConditions
�
zParserElement.addConditioncCs
||_|S)aDefine action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           ``fn(s, loc, expr, err)`` where:
           - s = string being parsed
           - loc = location where expression match was attempted and failed
           - expr = the parse expression that failed
           - err = the exception thrown
           The function returns no value.  It may throw :class:`ParseFatalException`
           if it is desired to stop parsing immediately.)r��r�r�rrr�
setFailAction4s
zParserElement.setFailActionc	CsNd}|rJd}|jD]4}z|�||�\}}d}qWqtk
rDYqXqq|S�NTF)r�r�r2)r�r�r�Z
exprsFound�eZdummyrrr�_skipIgnorablesAs


zParserElement._skipIgnorablescCsH|jr|�||�}|jrD|j}t|�}||krD|||krD|d7}q&|S�Nr�)r�r�r�r�r�)r�r�r�Zwt�instrlenrrr�preParseNs
zParserElement.preParsecCs|gfSr�r�r�r�r�r�rrrr�ZszParserElement.parseImplcCs|Sr�r�r�r�r��	tokenlistrrr�	postParse]szParserElement.postParsecCs�d\}}}|j}|s|j�r"|j|r8|j||||�z�|rR|jrR|�||�}	n|}	|	}
|jsl|	t|�kr�z|�||	|�\}}Wq�tk
r�t	|t|�|j
|��Yq�Xn|�||	|�\}}Wn\tk
�r}z<|j|r�|j|||
||�|j�r|�||
||��W5d}~XYnXn�|�r>|j�r>|�||�}	n|}	|	}
|j�s\|	t|�k�r�z|�||	|�\}}Wn*tk
�r�t	|t|�|j
|��YnXn|�||	|�\}}|�|||�}t
||j|j|jd�}
|j�r`|�s�|j�r`|�r�z�|jD]�}z|||
|
�}Wn6tk
�rD}zt	d�}||_|�W5d}~XYnX|dk	�r�||
k	�r�t
||j|j�ovt|t
tf�|jd�}
�q�WnFtk
�r�}z&|j|�r�|j|||
||��W5d}~XYnXn�|jD]�}z|||
|
�}Wn6tk
�r }zt	d�}||_|�W5d}~XYnX|dk	�r�||
k	�r�t
||j|j�oRt|t
tf�|jd�}
�q�|�r�|j|�r�|j|||
|||
�||
fS)N)rr�r�)rrz exception raised in parse action)r�r�r�r�r�r�r�r�rr2r�rr�r5r�r�r�r�r��	__cause__r�r)r�r�r�r�r�ZTRYZMATCHZFAILZ	debugging�prelocZtokensStart�tokens�errZ	retTokensr�Zparse_action_excr�rrrr�as�




�
�
zParserElement._parseNoCachecCs@z|j||dd�dWStk
r:t|||j|��YnXdS)NF�r�r)r�r4r2r��r�r�r�rrr�tryParse�szParserElement.tryParsec	Cs4z|�||�Wnttfk
r*YdSXdSdS)NFT)r�r2rr�rrr�canParseNext�s
zParserElement.canParseNextc@seZdZdd�ZdS)zParserElement._UnboundedCachecs~i�t�|_���fdd�}�fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr��r��r�r@��cache�not_in_cacherrr��sz3ParserElement._UnboundedCache.__init__.<locals>.getcs|�|<dSr�r�r�r@r$�r�rrr��sz3ParserElement._UnboundedCache.__init__.<locals>.setcs���dSr��rFr�r�rrrF�sz5ParserElement._UnboundedCache.__init__.<locals>.clearcst��Sr��r�r�r�rr�	cache_len�sz9ParserElement._UnboundedCache.__init__.<locals>.cache_len)r�r��types�
MethodTyper�r�rFr()r�r�r�rFr�rr�rr��sz&ParserElement._UnboundedCache.__init__N�rrrr�rrrr�_UnboundedCache�sr�Nc@seZdZdd�ZdS)�ParserElement._FifoCachecs�t�|_�t����fdd�}��fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr�r�r�r�rrr��s�.ParserElement._FifoCache.__init__.<locals>.getcs>|�|<t���kr:z��d�Wqtk
r6YqXqdSr~)r��popitemrr�)r��sizerrr��s�.ParserElement._FifoCache.__init__.<locals>.setcs���dSr�r�r�r�rrrF�s�0ParserElement._FifoCache.__init__.<locals>.clearcst��Sr�r�r�r�rrr��s�4ParserElement._FifoCache.__init__.<locals>.cache_len)	r�r��_OrderedDictr�r�r�r�rFr(�r�rr�r�rFr�r)r�r�rrr��s�!ParserElement._FifoCache.__init__Nr�rrrr�
_FifoCache�src@seZdZdd�ZdS)r�cs�t�|_�i�t�g�����fdd�}���fdd�}��fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_	dS)	Ncs��|��Sr�r�r�r�rrr�sr�cs4|�|<t���kr&�����d�q��|�dSr�)r�r?�popleftr�r�)r��key_fiforrrr�srcs������dSr�r�r�)r�r	rrrF
srcst��Sr�r�r�r�rrr�sr)
r�r��collections�dequer�r�r�r�rFr(rr)r�r	r�rrr��srNr�rrrrr�srcCsd\}}|||||f}tj��tj}|�|�}	|	|jkr�tj|d7<z|�||||�}	Wn8tk
r�}
z|�||
j	|
j
���W5d}
~
XYn.X|�||	d|	d��f�|	W5QR�Sn@tj|d7<t|	t
�r�|	�|	d|	d��fW5QR�SW5QRXdS)NrNr�r)r7�packrat_cache_lock�
packrat_cacher�r��packrat_cache_statsr�r0r�r�r�rIr�r)r�r�r�r�r�ZHITZMISS�lookupr�r$r�rrr�_parseCaches$


zParserElement._parseCachecCs(tj��dgttj�tjdd�<dSr�)r7r
rFr�rrrrr�
resetCache6s
zParserElement.resetCache�cCs8tjs4dt_|dkr t��t_nt�|�t_tjt_dS)a�Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.

           Parameters:

           - cache_size_limit - (default= ``128``) - if an integer value is provided
             will limit the size of the packrat cache; if None is passed, then
             the cache size will be unbounded; if 0 is passed, the cache will
             be effectively disabled.

           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method :class:`ParserElement.enablePackrat`.
           For best results, call ``enablePackrat()`` immediately after
           importing pyparsing.

           Example::

               from pip._vendor import pyparsing
               pyparsing.ParserElement.enablePackrat()
        TN)r7�_packratEnabledr�r
rrr�)Zcache_size_limitrrr�
enablePackrat<szParserElement.enablePackratc
Cs�t��|js|��|jD]}|��q|js8|��}z<|�|d�\}}|rr|�||�}t	�t
�}|�||�Wn0tk
r�}ztjr��n|�W5d}~XYnX|SdS)a�
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        Returns the parsed data as a :class:`ParseResults` object, which may be
        accessed as a list, or as a dict or object with attributes if the given parser
        includes results names.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set ``parseAll`` to True (equivalent to ending
        the grammar with ``StringEnd()``).

        Note: ``parseString`` implicitly calls ``expandtabs()`` on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the ``loc`` argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:

        - calling ``parseWithTabs`` on your grammar before calling ``parseString``
          (see :class:`parseWithTabs`)
        - define your parse action using the full ``(s, loc, toks)`` signature, and
          reference the input string using the parse action's ``s`` argument
        - explictly expand the tabs in your input string before calling
          ``parseString``

        Example::

            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        rN)
r7rr��
streamliner�r��
expandtabsr�r�rr<r0�verbose_stacktrace)r�r��parseAllr�r�r�Zser�rrr�parseString_s$!

zParserElement.parseStringc
cs6|js|��|jD]}|��q|js4t|���}t|�}d}|j}|j}t	�
�d}	z�||kr�|	|kr�z |||�}
|||
dd�\}}Wntk
r�|
d}YqZX||kr�|	d7}	||
|fV|r�|||�}
|
|kr�|}q�|d7}q�|}qZ|
d}qZWn4tk
�r0}zt	j
�r�n|�W5d}~XYnXdS)aq
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        ``maxMatches`` argument, to clip scanning after 'n' matches are found.  If
        ``overlap`` is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See :class:`parseString` for more information on parsing
        strings with embedded tabs.

        Example::

            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens, start, end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])

        prints::

            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        rF�r�r�N)r�rr�r�r�rr�r�r�r7rr2r0r)r�r��
maxMatchesZoverlapr�r�r�Z
preparseFnZparseFn�matchesr�ZnextLocr�Znextlocr�rrr�
scanString�sB




zParserElement.scanStringc
Cs�g}d}d|_z�|�|�D]Z\}}}|�|||��|rpt|t�rR||��7}nt|t�rf||7}n
|�|�|}q|�||d��dd�|D�}d�tt	t
|���WStk
r�}ztj
rƂn|�W5d}~XYnXdS)a[
        Extension to :class:`scanString`, to modify matching text with modified tokens that may
        be returned from a parse action.  To use ``transformString``, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking ``transformString()`` on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  ``transformString()`` returns the resulting transformed string.

        Example::

            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())

            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))

        prints::

            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        rTNcSsg|]}|r|�qSrr�r��orrrrsz1ParserElement.transformString.<locals>.<listcomp>r�)r�rr�r�r5rrr�r�r��_flattenr0r7r)r�r�r[ZlastEr�r�r�r�rrrr��s(



zParserElement.transformStringc
CsRztdd�|�||�D��WStk
rL}ztjr8�n|�W5d}~XYnXdS)a�
        Another extension to :class:`scanString`, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        ``maxMatches`` argument, to clip searching after 'n' matches are found.

        Example::

            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())

            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))

        prints::

            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        cSsg|]\}}}|�qSrr)r�r�r�r�rrrr#sz.ParserElement.searchString.<locals>.<listcomp>N)r5rr0r7r)r�r�rr�rrr�searchString
szParserElement.searchStringc	csTd}d}|j||d�D]*\}}}|||�V|r<|dV|}q||d�VdS)aR
        Generator method to split a string using the given expression as a separator.
        May be called with optional ``maxsplit`` argument, to limit the number of splits;
        and the optional ``includeSeparators`` argument (default= ``False``), if the separating
        matching text should be included in the split results.

        Example::

            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))

        prints::

            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        r)rN)r)	r�r��maxsplitZincludeSeparatorsZsplitsZlastr�r�r�rrrr�+s
zParserElement.splitcCsV|tkrt|�St|t�r$|�|�}t|t�sJtjdt|�t	dd�dSt
||g�S)a[
        Implementation of + operator - returns :class:`And`. Adding strings to a ParserElement
        converts them to :class:`Literal`s by default.

        Example::

            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))

        prints::

            Hello, World! -> ['Hello', ',', 'World', '!']

        ``...`` may be used as a parse expression as a short form of :class:`SkipTo`.

            Literal('start') + ... + Literal('end')

        is equivalent to:

            Literal('start') + SkipTo('end')("_skipped*") + Literal('end')

        Note that the skipped text is returned with '_skipped' as a results name,
        and to support having multiple skips in the same parser, the value returned is
        a list of all skipped text.
        �4Cannot combine element of type %s with ParserElementr���
stacklevelN)�Ellipsis�_PendingSkipr�rr�r7�warnings�warnr��
SyntaxWarningrrSrrrrKDs


�zParserElement.__add__cCsZ|tkrt|�d�|St|t�r,|�|�}t|t�sRtjdt|�t	dd�dS||S)z`
        Implementation of + operator when left operand is not a :class:`ParserElement`
        �	_skipped*r#r�r$N)
r&r;r�rr�r7r(r)r�r*rSrrrrTjs


�zParserElement.__radd__cCsJt|t�r|�|�}t|t�s:tjdt|�tdd�dS|t�	�|S)zT
        Implementation of - operator, returns :class:`And` with error stop
        r#r�r$N)
r�rr�r7r(r)r�r*r�
_ErrorStoprSrrr�__sub__ys


�zParserElement.__sub__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||S)z`
        Implementation of - operator when left operand is not a :class:`ParserElement`
        r#r�r$N�r�rr�r7r(r)r�r*rSrrr�__rsub__�s


�zParserElement.__rsub__cs|tkrd}n8t|t�rF|dd�tfkrFd|dd�ddd�}t|t�r\|d}}n�t|t��rJtdd	�|D��}|d
dd�}|ddkr�d|df}t|dt�r�|ddkr�|ddkr�t��S|ddkr�t��S�|dt��SnNt|dt��r,t|dt��r,|\}}||8}ntdt|d�t|d���ntdt|���|dk�rjtd
��|dk�r|td��||k�r�dk�r�nntd��|�r��fdd��|�r�|dk�r҈�|�}nt	�g|��|�}n�|�}n|dk�r�}nt	�g|�}|S)a�
        Implementation of * operator, allows use of ``expr * 3`` in place of
        ``expr + expr + expr``.  Expressions may also me multiplied by a 2-integer
        tuple, similar to ``{min, max}`` multipliers in regular expressions.  Tuples
        may also include ``None`` as in:
         - ``expr*(n, None)`` or ``expr*(n, )`` is equivalent
              to ``expr*n + ZeroOrMore(expr)``
              (read as "at least n instances of ``expr``")
         - ``expr*(None, n)`` is equivalent to ``expr*(0, n)``
              (read as "0 to n instances of ``expr``")
         - ``expr*(None, None)`` is equivalent to ``ZeroOrMore(expr)``
         - ``expr*(1, None)`` is equivalent to ``OneOrMore(expr)``

        Note that ``expr*(None, n)`` does not raise an exception if
        more than n exprs exist in the input stream; that is,
        ``expr*(None, n)`` does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        ``expr*(None, n) + ~expr``
        )rNNr�rr�r�rcss|]}|tk	r|ndVqdSr�)r&rrrrr��sz(ParserElement.__mul__.<locals>.<genexpr>)NNz8cannot multiply 'ParserElement' and ('%s', '%s') objectsz0cannot multiply 'ParserElement' and '%s' objectsz/cannot multiply ParserElement by negative valuez@second tuple value must be greater or equal to first tuple valuez,cannot multiply ParserElement by 0 or (0, 0)cs(|dkrt��|d��St��SdSr�)r.��n��makeOptionalListr�rrr3�sz/ParserElement.__mul__.<locals>.makeOptionalList)
r&r��tupler�rEr,rr��
ValueErrorr)r�rJZminElementsZoptElementsr�rr2r�__mul__�sN
 





zParserElement.__mul__cCs
|�|�Sr�)r6rSrrr�__rmul__�szParserElement.__rmul__cCsZ|tkrt|dd�St|t�r(|�|�}t|t�sNtjdt|�t	dd�dSt
||g�S)zL
        Implementation of | operator - returns :class:`MatchFirst`
        T)�	must_skipr#r�r$N)r&r'r�rr�r7r(r)r�r*r)rSrrr�__or__�s


�zParserElement.__or__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||BS)z`
        Implementation of | operator when left operand is not a :class:`ParserElement`
        r#r�r$Nr.rSrrr�__ror__�s


�zParserElement.__ror__cCsFt|t�r|�|�}t|t�s:tjdt|�tdd�dSt||g�S)zD
        Implementation of ^ operator - returns :class:`Or`
        r#r�r$N)	r�rr�r7r(r)r�r*r/rSrrr�__xor__�s


�zParserElement.__xor__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||AS)z`
        Implementation of ^ operator when left operand is not a :class:`ParserElement`
        r#r�r$Nr.rSrrr�__rxor__	s


�zParserElement.__rxor__cCsFt|t�r|�|�}t|t�s:tjdt|�tdd�dSt||g�S)zF
        Implementation of & operator - returns :class:`Each`
        r#r�r$N)	r�rr�r7r(r)r�r*rrSrrr�__and__	s


�zParserElement.__and__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||@S)z`
        Implementation of & operator when left operand is not a :class:`ParserElement`
        r#r�r$Nr.rSrrr�__rand__	s


�zParserElement.__rand__cCst|�S)zH
        Implementation of ~ operator - returns :class:`NotAny`
        )r+r�rrr�
__invert__)	szParserElement.__invert__cCstd|jj��dS)Nz%r object is not iterable)rr�rr�rrrr-/	szParserElement.__iter__c	Cs�zt|t�r|f}t|�Wntk
r8||f}YnXt|�dkrzt�d�|dd�t|�dkrrd�t|��nd��|t|dd��}|S)a�
        use ``[]`` indexing notation as a short form for expression repetition:
         - ``expr[n]`` is equivalent to ``expr*n``
         - ``expr[m, n]`` is equivalent to ``expr*(m, n)``
         - ``expr[n, ...]`` or ``expr[n,]`` is equivalent
              to ``expr*n + ZeroOrMore(expr)``
              (read as "at least n instances of ``expr``")
         - ``expr[..., n]`` is equivalent to ``expr*(0, n)``
              (read as "0 to n instances of ``expr``")
         - ``expr[...]`` and ``expr[0, ...]`` are equivalent to ``ZeroOrMore(expr)``
         - ``expr[1, ...]`` is equivalent to ``OneOrMore(expr)``
         ``None`` may be used in place of ``...``.

        Note that ``expr[..., n]`` and ``expr[m, n]``do not raise an exception
        if more than ``n`` ``expr``s exist in the input stream.  If this behavior is
        desired, then write ``expr[..., n] + ~expr``.
       r�z.only 1 or 2 index arguments supported ({0}{1})Nr�z	... [{0}]r�)	r�r�r,rr�r(r)r�r4)r�r@r�rrrr�4	s

��zParserElement.__getitem__cCs|dk	r|�|�S|��SdS)a�
        Shortcut for :class:`setResultsName`, with ``listAllMatches=False``.

        If ``name`` is given with a trailing ``'*'`` character, then ``listAllMatches`` will be
        passed as ``True``.

        If ``name` is omitted, same as calling :class:`copy`.

        Example::

            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums + "-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums + "-")("socsecno")
        N)r�rIrGrrr�__call__X	s
zParserElement.__call__cCst|�S)z�
        Suppresses the output of this :class:`ParserElement`; useful to keep punctuation from
        cluttering up returned output.
        )r>r�rrr�suppressl	szParserElement.suppresscCs
d|_|S)a
        Disables the skipping of whitespace before matching the characters in the
        :class:`ParserElement`'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        F�r�r�rrr�leaveWhitespaces	szParserElement.leaveWhitespacecCsd|_||_d|_|S)z8
        Overrides the default whitespace chars
        TF)r�r�r�)r�r�rrr�setWhitespaceChars|	sz ParserElement.setWhitespaceCharscCs
d|_|S)z�
        Overrides default behavior to expand ``<TAB>``s to spaces before parsing the input string.
        Must be called before ``parseString`` when the input grammar contains elements that
        match ``<TAB>`` characters.
        T)r�r�rrr�
parseWithTabs�	szParserElement.parseWithTabscCsLt|t�rt|�}t|t�r4||jkrH|j�|�n|j�t|����|S)a�
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.

        Example::

            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']

            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        )r�rr>r�r�rIrSrrr�ignore�	s


zParserElement.ignorecCs"|pt|pt|ptf|_d|_|S)zT
        Enable display of debugging messages while doing pattern matching.
        T)r�r�r�r�r�)r�ZstartActionZ
successActionZexceptionActionrrr�setDebugActions�	s�zParserElement.setDebugActionscCs|r|�ttt�nd|_|S)a�
        Enable display of debugging messages while doing pattern matching.
        Set ``flag`` to True to enable, False to disable.

        Example::

            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer

            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")

        prints::

            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using :class:`setDebugActions`. Prior to attempting
        to match the ``wd`` expression, the debugging message ``"Match <exprname> at loc <n>(<line>,<col>)"``
        is shown. Then if the parse succeeds, a ``"Matched"`` message is shown, or an ``"Exception raised"``
        message is shown. Also note the use of :class:`setName` to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the :class:`Word` expression without calling ``setName`` is ``"W:(ABCD...)"``.
        F)rGr�r�r�r�)r��flagrrrr��	s%zParserElement.setDebugcCs|jSr�r�r�rrrr��	szParserElement.__str__cCst|�Sr�r�r�rrrr��	szParserElement.__repr__cCsd|_d|_|Sr�)r�r�r�rrrr�	szParserElement.streamlinecCsdSr�rr�rrr�checkRecursion�	szParserElement.checkRecursioncCs|�g�dS)zj
        Check defined expressions for valid structure, check for infinite recursive definitions.
        N)rI)r��
validateTracerrr�validate�	szParserElement.validatecCs�z|��}Wn2tk
r>t|d��}|��}W5QRXYnXz|�||�WStk
r~}ztjrj�n|�W5d}~XYnXdS)z�
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        �rN)�readr��openrr0r7r)r�Zfile_or_filenamerZ
file_contents�fr�rrr�	parseFile�	szParserElement.parseFilecsht|t�rBtr(||kp$tt|��|�qd||kp>t|�t|�kSn"t|t�rV|�|�Stt|�|kSdSr�)r�r7rb�super�__eq__�varsrrrS�r�rrrR
s


zParserElement.__eq__cCs
||kSr�rrSrrr�__ne__
szParserElement.__ne__cCst|�Sr�)�idr�rrr�__hash__
szParserElement.__hash__cCs||kSr�rrSrrr�__req__
szParserElement.__req__cCs
||kSr�rrSrrr�__rne__
szParserElement.__rne__cCs4z|jt|�|d�WdStk
r.YdSXdS)a�
        Method for quick testing of a parser against a test string. Good for simple
        inline microtests of sub expressions while building up larger parser.

        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests

        Example::

            expr = Word(nums)
            assert expr.matches("100")
        �rTFN)rr�r0)r�Z
testStringrrrrr
s
zParserElement.matches�#c	Cs�t|t�r"tttj|������}t|t�r4t|�}|dkrBt	j
}|j}	g}
g}d}td��t
d���t�}
d}|D�]\}|dk	r�|�|d�s�|r�|s�|�|�qt|s�qtd�|�|g}g}z"|
�|�|��}|j||d�}Wn�tk
�r�}z�t|t�r�dnd	}d|k�rB|�t|j|��|�d
t|j|�dd|�n|�d
|jd|�|�d
t|��|�ot|}|}W5d}~XY�ntk
�r�}z$|�dt|��|�o�|}|}W5d}~XYn�X|�o�|}|dk	�r�zR|||�}|dk	�r(t|t��r|�|���n|�t|��n|�|���WnRtk
�r�}z2|�|j|d��|�d�|jt |�j|��W5d}~XYnXn|�|j|d��|�r�|�r�|�d	�|	d�|��|
�||f�qt||
fS)as

        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.

        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests
         - comment - (default= ``'#'``) - expression for indicating embedded comments in the test
              string; pass None to disable comment filtering
         - fullDump - (default= ``True``) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default= ``True``) prints test output to stdout
         - failureTests - (default= ``False``) indicates if these tests are expected to fail parsing
         - postParse - (default= ``None``) optional callback for successful parse results; called as
              `fn(test_string, parse_results)` and returns a string to be added to the test output
         - file - (default=``None``) optional file-like object to which test output will be written;
              if None, will default to ``sys.stdout``

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if ``failureTests`` is True), and the results contain a list of lines of each
        test's output

        Example::

            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")

        prints::

            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success

            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\n of strings that spans \n 3 lines")

        (Note that this is a raw string literal, you must include the leading 'r'.)
        NT�\nr�uFrZz(FATAL)r�r�r�r�zFAIL: zFAIL-EXCEPTION: )rpz{0} failed: {1}: {2})!r�rrr�r�r��rstrip�
splitlinesr'r��stdout�writer�rprFrmrr�r�r��lstriprr0r4r[r�rMrr5rur�rr�)r�ZtestsrZcommentZfullDumpZprintResultsZfailureTestsr��file�print_Z
allResultsZcomments�successrw�BOMr�r[�resultr�r�r�Zpp_valuer�rrr�runTests.
sn`




$




0
zParserElement.runTests)F)F)F)T)T)TT)TT)r)F)N)T)N)F)T)Tr[TTFNN)Rrrrr�r�rr�r�r�r�rIr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr
rrrrr�rrrr�_MAX_INTrr�r!r�rKrTr-r/r6r7r9r:r;r<r=r>r?r-r�r@rArCrDrErFrGr�r�r�rrIrKrPrRrUrWrXrYrrg�
__classcell__rrrTrr7?s�




	
1




W

"
8H.&J$
			

+


�cs6eZdZd
�fdd�	Zdd�Zdd�Zdd	�Z�ZS)r'Fcs>tt|���t|t���dd�|_|j|_||_||_	dS)Nr�...)
rQr'r�r�rr�r�r�anchorr8)r�r�r8rTrrr��
s
z_PendingSkip.__init__cs\t|��d�d�}�jrNdd�}�fdd�}�j|��|�|��|�B|S�j||S)Nrjr+cSs,|jr|j��dgkr(|d=|�dd�dS)Nr�r�_skipped)rlrr?r�rrrr8�
sz'_PendingSkip.__add__.<locals>.must_skipcs<|j��dd�dgkr8|�d�}dt�j�d|d<dS)Nr�r�rlz	missing <rg)rlrr?r�rk)r�Zskippedr�rr�	show_skip�
s
z'_PendingSkip.__add__.<locals>.show_skip)r;r�r8rkr�)r�rJZskipperr8rmrr�rrK�
s
��z_PendingSkip.__add__cCs|jSr�)r�r�rrrr��
sz_PendingSkip.__repr__cGstd��dS)NzBuse of `...` expression without following SkipTo target expression)r)r�r�rrrr��
sz_PendingSkip.parseImpl)F)rrrr�rKr�r�rirrrTrr'�
sr'cs eZdZdZ�fdd�Z�ZS)r?zYAbstract :class:`ParserElement` subclass, for defining atomic
    matching patterns.
    cstt|�jdd�dS�NF�r�)rQr?r�r�rTrrr��
szToken.__init__�rrrr�r�rirrrTrr?�
scs eZdZdZ�fdd�Z�ZS)rz'An empty token, will always match.
    cs$tt|���d|_d|_d|_dS)NrTF)rQrr�rr�r�r�rTrrr��
szEmpty.__init__rprrrTrr�
scs*eZdZdZ�fdd�Zddd�Z�ZS)r*z#A token that will never match.
    cs*tt|���d|_d|_d|_d|_dS)Nr*TFzUnmatchable token)rQr*r�rr�r�r�r�rTrrr�s
zNoMatch.__init__TcCst|||j|��dSr�)r2r�r�rrrr�szNoMatch.parseImpl)T�rrrr�r�r�rirrrTrr*scs*eZdZdZ�fdd�Zddd�Z�ZS)r'a�Token to exactly match a specified string.

    Example::

        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"

    For case-insensitive matching, use :class:`CaselessLiteral`.

    For keyword matching (force word break before and after the matched string),
    use :class:`Keyword` or :class:`CaselessKeyword`.
    cs�tt|���||_t|�|_z|d|_Wn*tk
rVtj	dt
dd�t|_YnXdt
|j�|_d|j|_d|_d|_|jdkr�t|�tkr�t|_dS)	Nrz2null string passed to Literal; use Empty() insteadr�r$�"%s"r�Fr�)rQr'r��matchr��matchLen�firstMatchCharrr(r)r*rr�r�rr�r�r�r��_SingleCharLiteral�r��matchStringrTrrr� s"
�zLiteral.__init__TcCs@|||jkr,|�|j|�r,||j|jfSt|||j|��dSr�)ru�
startswithrsrtr2r�r�rrrr�4szLiteral.parseImpl)TrqrrrTrr's
c@seZdZddd�ZdS)rvTcCs0|||jkr|d|jfSt|||j|��dSr�)rursr2r�r�rrrr�:sz_SingleCharLiteral.parseImplN)T�rrrr�rrrrrv9srvcsLeZdZdZedZd�fdd�	Zddd	�Z�fd
d�Ze	dd
��Z
�ZS)r$a�Token to exactly match a specified string as a keyword, that is,
    it must be immediately followed by a non-keyword character.  Compare
    with :class:`Literal`:

     - ``Literal("if")`` will match the leading ``'if'`` in
       ``'ifAndOnlyIf'``.
     - ``Keyword("if")`` will not; it will only match the leading
       ``'if'`` in ``'if x=1'``, or ``'if(y==2)'``

    Accepts two optional constructor arguments in addition to the
    keyword string:

     - ``identChars`` is a string of characters that would be valid
       identifier characters, defaulting to all alphanumerics + "_" and
       "$"
     - ``caseless`` allows case-insensitive matching, default is ``False``.

    Example::

        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use :class:`CaselessKeyword`.
    �_$NFcs�tt|���|dkrtj}||_t|�|_z|d|_Wn$tk
r^t	j
dtdd�YnXd|j|_d|j|_
d|_d|_||_|r�|��|_|��}t|�|_dS)Nrz2null string passed to Keyword; use Empty() insteadr�r$rrr�F)rQr$r��DEFAULT_KEYWORD_CHARSrsr�rtrurr(r)r*rr�r�r��caseless�upper�
caselessmatchr��
identChars)r�rxr�r}rTrrr�]s*
�
zKeyword.__init__TcCs|jr|||||j���|jkr�|t|�|jksL|||j��|jkr�|dksj||d��|jkr�||j|jfSnv|||jkr�|jdks�|�|j|�r�|t|�|jks�|||j|jkr�|dks�||d|jkr�||j|jfSt	|||j
|��dSr)r}rtr~rr�r�rsruryr2r�r�rrrr�rs.��������zKeyword.parseImplcstt|���}tj|_|Sr�)rQr$rIr|r�)r�r�rTrrrI�szKeyword.copycCs
|t_dS)z,Overrides the default Keyword chars
        N)r$r|r�rrr�setDefaultKeywordChars�szKeyword.setDefaultKeywordChars)NF)T)rrrr�rGr|r�r�rIr�r�rirrrTrr$Bs
cs*eZdZdZ�fdd�Zddd�Z�ZS)rafToken to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::

        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']

    (Contrast with example for :class:`CaselessKeyword`.)
    cs6tt|��|���||_d|j|_d|j|_dS)Nz'%s'r�)rQrr�r~�returnStringrr�rwrTrrr��szCaselessLiteral.__init__TcCs@||||j���|jkr,||j|jfSt|||j|��dSr�)rtr~rsr�r2r�r�rrrr��szCaselessLiteral.parseImpl)TrqrrrTrr�s
cs"eZdZdZd�fdd�	Z�ZS)rz�
    Caseless version of :class:`Keyword`.

    Example::

        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']

    (Contrast with example for :class:`CaselessLiteral`.)
    Ncstt|�j||dd�dS)NT�r})rQrr�)r�rxr�rTrrr��szCaselessKeyword.__init__)NrprrrTrr�s	cs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
r�a�A variation on :class:`Literal` which matches "close" matches,
    that is, strings with at most 'n' mismatching characters.
    :class:`CloseMatch` takes parameters:

     - ``match_string`` - string to be matched
     - ``maxMismatches`` - (``default=1``) maximum number of
       mismatches allowed to count as a match

    The results from a successful parse will contain the matched text
    from the input string and the following named results:

     - ``mismatches`` - a list of the positions within the
       match_string where mismatches were found
     - ``original`` - the original match_string used to compare
       against the input string

    If ``mismatches`` is an empty list, then the match was an exact
    match.

    Example::

        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    r�csBtt|���||_||_||_d|j|jf|_d|_d|_dS)Nz&Expected %r (with up to %d mismatches)F)	rQr�r�r�match_string�
maxMismatchesr�r�r�)r�r�r�rTrrr��szCloseMatch.__init__TcCs�|}t|�}|t|j�}||kr�|j}d}g}	|j}
tt|||�|��D]2\}}|\}}
||
krL|	�|�t|	�|
krLq�qL|d}t|||�g�}||d<|	|d<||fSt|||j|��dS)Nrr��original�
mismatches)	r�r�r�r�r�r�r5r2r�)r�r�r�r��startr��maxlocr�Zmatch_stringlocr�r�Zs_m�src�mat�resultsrrrr��s(
zCloseMatch.parseImpl)r�)TrqrrrTrr��s 	cs8eZdZdZd
�fdd�	Zdd	d
�Z�fdd�Z�ZS)rBaX	Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters, an
    optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for ``min`` is
    1 (a minimum value < 1 is not valid); the default values for
    ``max`` and ``exact`` are 0, meaning no maximum or exact
    length restriction. An optional ``excludeChars`` parameter can
    list characters that might be found in the input ``bodyChars``
    string; useful to define a word of all printables except for one or
    two characters, for instance.

    :class:`srange` is useful for defining custom character set strings
    for defining ``Word`` expressions, using range notation from
    regular expression character sets.

    A common mistake is to use :class:`Word` to match a specific literal
    string, as in ``Word("Address")``. Remember that :class:`Word`
    uses the string argument to define *sets* of matchable characters.
    This expression would match "Add", "AAA", "dAred", or any other word
    made up of the characters 'A', 'd', 'r', 'e', and 's'. To match an
    exact literal string, use :class:`Literal` or :class:`Keyword`.

    pyparsing includes helper strings for building Words:

     - :class:`alphas`
     - :class:`nums`
     - :class:`alphanums`
     - :class:`hexnums`
     - :class:`alphas8bit` (alphabetic characters in ASCII range 128-255
       - accented, tilded, umlauted, etc.)
     - :class:`punc8bit` (non-alphabetic characters in ASCII range
       128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - :class:`printables` (any non-whitespace character)

    Example::

        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))

        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums + '-')

        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")

        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    Nr�rFcs�tt|����rNt���d��fdd�|D��}|rNd��fdd�|D��}||_t|�|_|rt||_t|�|_n||_t|�|_|dk|_	|dkr�t
d��||_|dkr�||_nt
|_|dkr�||_||_t|�|_d|j|_d	|_||_d
|j|jk�r�|dk�r�|dk�r�|dk�r�|j|jk�r@dt|j�|_nHt|j�dk�rndt�|j�t|j�f|_nd
t|j�t|j�f|_|j�r�d|jd|_zt�|j�|_Wntk
�r�d|_YnX|jj|_t|_dS)Nr�c3s|]}|�kr|VqdSr�rr���excludeCharsrrr�2sz Word.__init__.<locals>.<genexpr>c3s|]}|�kr|VqdSr�rr�r�rrr�4srr�zZcannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permittedr�Fr�z[%s]+z%s[%s]*z	[%s][%s]*z\b)rQrBr�r�r��
initCharsOrig�	initChars�
bodyCharsOrig�	bodyChars�maxSpecifiedr5�minLen�maxLenrhr�rr�r��	asKeyword�_escapeRegexRangeChars�reStringr�r��escape�compilerrs�re_match�
_WordRegexr�)r�r�r��min�max�exactr�r�rTr�rr�.sZ



0�

�
z
Word.__init__Tc	Cs�|||jkrt|||j|��|}|d7}t|�}|j}||j}t||�}||krj|||krj|d7}qLd}|||jkr�d}nV|jr�||kr�|||kr�d}n6|j	r�|dkr�||d|ks�||kr�|||kr�d}|r�t|||j|��||||�fS)Nr�FTr)
r�r2r�r�r�r�r�r�r�r�)	r�r�r�r�r�r�Z	bodycharsr�ZthrowExceptionrrrr�gs2


�
�zWord.parseImplcsvztt|���WStk
r$YnX|jdkrpdd�}|j|jkr`d||j�||j�f|_nd||j�|_|jS)NcSs$t|�dkr|dd�dS|SdS)N�rjr��r�rrr�
charsAsStr�sz Word.__str__.<locals>.charsAsStrz
W:(%s, %s)zW:(%s))rQrBr�rr�r�r�)r�r�rTrrr��s
zWord.__str__)Nr�rrFN)T�rrrr�r�r�r�rirrrTrrB�s49
c@seZdZddd�ZdS)r�TcCs4|�||�}|s t|||j|��|��}||��fSr�)r�r2r��end�group)r�r�r�r�rfrrrr��s
z_WordRegex.parseImplN)Trzrrrrr��sr�cs"eZdZdZd�fdd�	Z�ZS)rFz�A short-cut class for defining ``Word(characters, exact=1)``,
    when defining a match of any single character in a string of
    characters.
    FNcsZtt|�j|d||d�dtd�|j��|_|r>d|j|_t�|j�|_|jj	|_
dS)Nr�)r�r�r��[%s]r�z\b%s\b)rQrFr�r�r�r�r�r�r�rsr�)r��charsetr�r�rTrrr��sz
Char.__init__)FNrprrrTrrF�scsbeZdZdZee�d��Zd�fdd�	Zddd	�Z	dd
d�Z
ddd
�Z�fdd�Zdd�Z
�ZS)r:a�Token for matching strings that match a given regular
    expression. Defined with string specifying the regular expression in
    a form recognized by the stdlib Python  `re module <https://docs.python.org/3/library/re.html>`_.
    If the given regex contains named groups (defined using ``(?P<name>...)``),
    these will be preserved as named parse results.

    Example::

        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: https://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    z[A-Z]rFcstt|���t|t�r�|s,tjdtdd�||_||_	zt
�|j|j	�|_
|j|_Wq�t
jk
r�tjd|tdd��Yq�Xn2t|tj�r�||_
t|�|_|_||_	ntd��|j
j|_t|�|_d|j|_d|_d|_||_||_|jr�|j|_|j�r|j|_d	S)
aThe parameters ``pattern`` and ``flags`` are passed
        to the ``re.compile()`` function as-is. See the Python
        `re module <https://docs.python.org/3/library/re.html>`_ module for an
        explanation of the acceptable patterns and flags.
        z0null string passed to Regex; use Empty() insteadr�r$�$invalid pattern (%s) passed to RegexzCRegex may only be constructed with a string or a compiled RE objectr�FTN)rQr:r�r�rr(r)r*�pattern�flagsr�r�r��
sre_constants�error�compiledREtyper�r5rsr�r�rr�r�r��asGroupList�asMatch�parseImplAsGroupListr��parseImplAsMatch)r�r�r�r�r�rTrrr��sD
�
�


zRegex.__init__Tc	Csb|�||�}|s t|||j|��|��}t|���}|��}|rZ|��D]\}}|||<qH||fSr�)r�r2r�r�r5r��	groupdictr!)	r�r�r�r�rfr��drrrrrr��s
zRegex.parseImplcCs8|�||�}|s t|||j|��|��}|��}||fSr�)r�r2r�r��groups�r�r�r�r�rfr�rrrr��szRegex.parseImplAsGroupListcCs4|�||�}|s t|||j|��|��}|}||fSr�)r�r2r�r�r�rrrr�
szRegex.parseImplAsMatchcsFztt|���WStk
r$YnX|jdkr@dt|j�|_|jS)NzRe:(%s))rQr:r�rr�r�r�r�rTrrr�
s
z
Regex.__str__csl�jrtjdtdd�t���jr@t��r@tjdtdd�t���jrT�fdd�}n��fdd�}��|�S)a�
        Return Regex with an attached parse action to transform the parsed
        result as if called using `re.sub(expr, repl, string) <https://docs.python.org/3/library/re.html#re.sub>`_.

        Example::

            make_html = Regex(r"(\w+):(.*?):").sub(r"<\1>\2</\1>")
            print(make_html.transformString("h1:main title:"))
            # prints "<h1>main title</h1>"
        z-cannot use sub() with Regex(asGroupList=True)r�r$z9cannot use sub() with a callable with Regex(asMatch=True)cs|d���Sr�)�expand�r�)�replrrr�,
szRegex.sub.<locals>.pacs�j��|d�Sr�)r�rr��r�r�rrr�/
s)r�r(r)r*�SyntaxErrorr�r�r�)r�r�r�rr�rr
s ��z	Regex.sub)rFF)T)T)T)rrrr�r�r�r�r�r�r�r�r�r�rrirrrTrr:�s
-

	
	cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
r8a&
    Token for matching strings that are delimited by quoting characters.

    Defined with the following parameters:

        - quoteChar - string of one or more characters defining the
          quote delimiting string
        - escChar - character to escape quotes, typically backslash
          (default= ``None``)
        - escQuote - special quote sequence to escape an embedded quote
          string (such as SQL's ``""`` to escape an embedded ``"``)
          (default= ``None``)
        - multiline - boolean indicating whether quotes can span
          multiple lines (default= ``False``)
        - unquoteResults - boolean indicating whether the matched text
          should be unquoted (default= ``True``)
        - endQuoteChar - string of one or more characters defining the
          end of the quote delimited string (default= ``None``  => same as
          quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace
          (``'\t'``, ``'\n'``, etc.) to actual whitespace
          (default= ``True``)

    Example::

        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))

    prints::

        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    NFTc
sXtt����|��}|s0tjdtdd�t��|dkr>|}n"|��}|s`tjdtdd�t��|�_t	|��_
|d�_|�_t	|��_
|�_|�_|�_|�_|r�tjtjB�_dt��j�t�jd�|dk	r�t|�p�df�_n<d�_dt��j�t�jd�|dk	�rt|��pdf�_t	�j�d	k�rp�jd
d��fdd
�tt	�j�d	dd�D��d7_|�r��jdt�|�7_|�r��jdt�|�7_t��j�d�_�jdt��j�7_z(t��j�j��_�j�_�jj�_Wn0t j!k
�r0tjd�jtdd��YnXt"���_#d�j#�_$d�_%d�_&dS)Nz$quoteChar cannot be the empty stringr�r$z'endQuoteChar cannot be the empty stringrz%s(?:[^%s%s]r�z%s(?:[^%s\n\r%s]r�z|(?:z)|(?:c3s4|],}dt��jd|��t�j|�fVqdS)z%s[^%s]N)r�r��endQuoteCharr�rWr�rrr��
s��z(QuotedString.__init__.<locals>.<genexpr>r��)z|(?:%s)z|(?:%s.)z(.)z)*%sr�r�FT)'rQr8r�r�r(r)r*r��	quoteCharr��quoteCharLen�firstQuoteCharr��endQuoteCharLen�escChar�escQuote�unquoteResults�convertWhitespaceEscapesr��	MULTILINE�DOTALLr�r�r�r�r�r�escCharReplacePatternr�r�rsr�r�r�r�rr�r�r�)r�r�r�r�Z	multiliner�r�r�rTr�rr�Z
sv


�
�����
zQuotedString.__init__c	Cs�|||jkr|�||�pd}|s2t|||j|��|��}|��}|jr�||j|j�}t	|t
�r�d|kr�|jr�ddddd�}|��D]\}}|�
||�}q�|jr�t�|jd|�}|jr�|�
|j|j�}||fS)Nr��	r���
)�\tr\z\fz\rz\g<1>)r�r�r2r�r�r�r�r�r�r�rr�r!r�r�r�rr�r�r�)	r�r�r�r�rfr�Zws_mapZwslitZwscharrrrr��
s*
�zQuotedString.parseImplcsHztt|���WStk
r$YnX|jdkrBd|j|jf|_|jS)Nz.quoted string, starting with %s ending with %s)rQr8r�rr�r�r�r�rTrrr��
s
zQuotedString.__str__)NNFTNT)Tr�rrrTrr83
s&�A
#cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
ra�Token for matching words composed of characters *not* in a given
    set (will include whitespace in matched characters if not listed in
    the provided exclusion set - see example). Defined with string
    containing all disallowed characters, and an optional minimum,
    maximum, and/or exact length.  The default value for ``min`` is
    1 (a minimum value < 1 is not valid); the default values for
    ``max`` and ``exact`` are 0, meaning no maximum or exact
    length restriction.

    Example::

        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))

    prints::

        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    r�rcs�tt|���d|_||_|dkr*td��||_|dkr@||_nt|_|dkrZ||_||_t	|�|_
d|j
|_|jdk|_d|_
dS)NFr�zfcannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permittedrr�)rQrr�r��notCharsr5r�r�rhr�rr�r�r�)r�r�r�r�r�rTrrr��
s 
zCharsNotIn.__init__TcCs�|||jkrt|||j|��|}|d7}|j}t||jt|��}||krb|||krb|d7}qD|||jkr�t|||j|��||||�fSr�)r�r2r�r�r�r�r�)r�r�r�r�r�Znotchars�maxlenrrrr��
s
zCharsNotIn.parseImplcsfztt|���WStk
r$YnX|jdkr`t|j�dkrTd|jdd�|_nd|j|_|jS)Nr�z
!W:(%s...)z!W:(%s))rQrr�rr�r�r�r�rTrrr�s
zCharsNotIn.__str__)r�rr)Tr�rrrTrr�
s
cs`eZdZdZdddddddd	d
ddd
dddddddddddd�Zd"�fdd�	Zd#d d!�Z�ZS)$rAa�Special matching class for matching whitespace.  Normally,
    whitespace is ignored by pyparsing grammars.  This class is included
    when some whitespace structures are significant.  Define with
    a string containing the whitespace characters to be matched; default
    is ``" \t\r\n"``.  Also takes optional ``min``,
    ``max``, and ``exact`` arguments, as defined for the
    :class:`Word` class.
    z<SP>z<TAB>z<LF>z<CR>z<FF>z<NBSP>z<OGHAM_SPACE_MARK>z<MONGOLIAN_VOWEL_SEPARATOR>z	<EN_QUAD>z	<EM_QUAD>z
<EN_SPACE>z
<EM_SPACE>z<THREE-PER-EM_SPACE>z<FOUR-PER-EM_SPACE>z<SIX-PER-EM_SPACE>z<FIGURE_SPACE>z<PUNCTUATION_SPACE>z<THIN_SPACE>z<HAIR_SPACE>z<ZERO_WIDTH_SPACE>z<NNBSP>z<MMSP>z<IDEOGRAPHIC_SPACE>)r�r�r�r�r�zuA0zu80zu80Euu€0uu€1uu€2uu€3uu€4uu€5uu€6uu€7uu€8uu€9uu€Auu€Buu‚Fuu…FuuÀ0� 	
r�rcs�tt����|�_��d��fdd��jD���d�dd��jD���_d�_d�j�_	|�_
|dkrt|�_nt�_|dkr�|�_|�_
dS)Nr�c3s|]}|�jkr|VqdSr�)�
matchWhiter�r�rrr�:s
z!White.__init__.<locals>.<genexpr>css|]}tj|VqdSr�)rA�	whiteStrsr�rrrr�<sTr�r)
rQrAr�r�rDr�r�rr�r�r�r�rh)r�Zwsr�r�r�rTr�rr�7s zWhite.__init__TcCs�|||jkrt|||j|��|}|d7}||j}t|t|��}||krb|||jkrb|d7}qB|||jkr�t|||j|��||||�fSr�)r�r2r�r�r�r�r�)r�r�r�r�r�r�rrrr�Ks

zWhite.parseImpl)r�r�rr)T)rrrr�r�r�r�rirrrTrrAs6	�cseZdZ�fdd�Z�ZS)�_PositionTokencs(tt|���|jj|_d|_d|_dSr�)rQr�r�r�rrr�r�r�rTrrr�\s
z_PositionToken.__init__�rrrr�rirrrTrr�[sr�cs2eZdZdZ�fdd�Zdd�Zd	dd�Z�ZS)
r"zaToken to advance to a specific column of input text; useful for
    tabular report scraping.
    cstt|���||_dSr�)rQr"r�rM)r��colnorTrrr�fszGoToColumn.__init__cCs\t||�|jkrXt|�}|jr*|�||�}||krX||��rXt||�|jkrX|d7}q*|Sr�)rMr�r�r��isspace)r�r�r�r�rrrr�js$
zGoToColumn.preParseTcCsDt||�}||jkr"t||d|��||j|}|||�}||fS)NzText not in expected column�rMr2)r�r�r�r�ZthiscolZnewlocr�rrrr�ss

zGoToColumn.parseImpl)T)rrrr�r�r�r�rirrrTrr"bs	cs*eZdZdZ�fdd�Zddd�Z�ZS)r&a�Matches if current position is at the beginning of a line within
    the parse string

    Example::

        test = '''\
        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)

    prints::

        ['AAA', ' this line']
        ['AAA', ' and this line']

    cstt|���d|_dS)NzExpected start of line)rQr&r�r�r�rTrrr��szLineStart.__init__TcCs*t||�dkr|gfSt|||j|��dSr�)rMr2r�r�rrrr��szLineStart.parseImpl)TrqrrrTrr&|scs*eZdZdZ�fdd�Zddd�Z�ZS)r%zTMatches if current position is at the end of a line within the
    parse string
    cs,tt|���|�tj�dd��d|_dS)Nr�r�zExpected end of line)rQr%r�rDr7r�r�r�r�rTrrr��szLineEnd.__init__TcCsb|t|�kr6||dkr$|ddfSt|||j|��n(|t|�krN|dgfSt|||j|��dS)Nr�r��r�r2r�r�rrrr��szLineEnd.parseImpl)TrqrrrTrr%�scs*eZdZdZ�fdd�Zddd�Z�ZS)r=zLMatches if current position is at the beginning of the parse
    string
    cstt|���d|_dS)NzExpected start of text)rQr=r�r�r�rTrrr��szStringStart.__init__TcCs0|dkr(||�|d�kr(t|||j|��|gfSr�)r�r2r�r�rrrr��szStringStart.parseImpl)TrqrrrTrr=�scs*eZdZdZ�fdd�Zddd�Z�ZS)r<zBMatches if current position is at the end of the parse string
    cstt|���d|_dS)NzExpected end of text)rQr<r�r�r�rTrrr��szStringEnd.__init__TcCs^|t|�krt|||j|��n<|t|�kr6|dgfS|t|�krJ|gfSt|||j|��dSr�r�r�rrrr��szStringEnd.parseImpl)TrqrrrTrr<�scs.eZdZdZef�fdd�	Zddd�Z�ZS)rDayMatches if the current position is at the beginning of a Word,
    and is not preceded by any character in a given set of
    ``wordChars`` (default= ``printables``). To emulate the
    ```` behavior of regular expressions, use
    ``WordStart(alphanums)``. ``WordStart`` will also match at
    the beginning of the string being parsed, or at the beginning of
    a line.
    cs"tt|���t|�|_d|_dS)NzNot at the start of a word)rQrDr�r��	wordCharsr��r�r�rTrrr��s
zWordStart.__init__TcCs@|dkr8||d|jks(|||jkr8t|||j|��|gfSr)r�r2r�r�rrrr��s�zWordStart.parseImpl)T�rrrr�rjr�r�rirrrTrrD�scs.eZdZdZef�fdd�	Zddd�Z�ZS)rCa_Matches if the current position is at the end of a Word, and is
    not followed by any character in a given set of ``wordChars``
    (default= ``printables``). To emulate the ```` behavior of
    regular expressions, use ``WordEnd(alphanums)``. ``WordEnd``
    will also match at the end of the string being parsed, or at the end
    of a line.
    cs(tt|���t|�|_d|_d|_dS)NFzNot at the end of a word)rQrCr�r�r�r�r�r�rTrrr��s
zWordEnd.__init__TcCsPt|�}|dkrH||krH|||jks8||d|jkrHt|||j|��|gfSr)r�r�r2r�)r�r�r�r�r�rrrr��s�zWordEnd.parseImpl)Tr�rrrTrrC�scszeZdZdZd�fdd�	Zdd�Zdd�Z�fd	d
�Z�fdd�Z�fd
d�Z	ddd�Z
�fdd�Zd�fdd�	Z�Z
S)r3z]Abstract subclass of ParserElement, for combining and
    post-processing parsed tokens.
    Fcs�tt���|�t|t�r"t|�}t|t�r<��|�g�_n�t|t	�rP|g�_nnt|t
�r�t|�}tdd�|D��r��fdd�|D�}t|��_n,zt|��_Wntk
r�|g�_YnXd�_
dS)Ncss|]}t|t�VqdSr�)r�r)r�r�rrrr�sz+ParseExpression.__init__.<locals>.<genexpr>c3s&|]}t|t�r��|�n|VqdSr�)r�rr��r�r�r�rrr�sF)rQr3r�r�r
rrr��exprsr7r	rvrr��r�r�r�rTr�rr��s"




zParseExpression.__init__cCs|j�|�d|_|Sr�)r�r�r�rSrrrr�szParseExpression.appendcCs0d|_dd�|jD�|_|jD]}|��q|S)z�Extends ``leaveWhitespace`` defined in base class, and also invokes ``leaveWhitespace`` on
           all contained expressions.FcSsg|]}|���qSrrHr�rrrrsz3ParseExpression.leaveWhitespace.<locals>.<listcomp>)r�r�rC)r�r�rrrrCs


zParseExpression.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jD]}|�|jd�q*n,tt|��|�|jD]}|�|jd�qX|Sr.)r�r>r�rQr3rFr�)r�rJr�rTrrrF#s



zParseExpression.ignorecsNztt|���WStk
r$YnX|jdkrHd|jjt|j�f|_|jS�Nz%s:(%s))	rQr3r�rr�r�rr�r�r�rTrrr�/s
zParseExpression.__str__cs*tt|���|jD]}|��qt|j�dk�r|jd}t||j�r�|js�|jdkr�|j	s�|jdd�|jdg|_d|_
|j|jO_|j|jO_|jd}t||j��r|j�s|jdk�r|j	�s|jdd�|jdd�|_d|_
|j|jO_|j|jO_dt
|�|_|S)Nr�rr�r�r�)rQr3rr�r�r�r�r�r�r�r�r�r�r�r�)r�r�rJrTrrr9s<


���
���zParseExpression.streamlineNcCsB|dk	r|ngdd�|g}|jD]}|�|�q$|�g�dSr�)r�rKrI)r�rJ�tmpr�rrrrK[s
zParseExpression.validatecs$tt|���}dd�|jD�|_|S)NcSsg|]}|���qSrrHr�rrrrcsz(ParseExpression.copy.<locals>.<listcomp>)rQr3rIr�rcrTrrrIaszParseExpression.copycsVtjrD|jD]6}t|t�r|jrtjd�d|t	|�j
|j�dd�qtt|��
||�S)N�]{0}: setting results name {1!r} on {2} expression collides with {3!r} on contained expression�)warn_ungrouped_named_tokens_in_collectionr�r$)rr�r�r�r7r�r(r)r�r�rrQr3r��r�rr�r�rTrrr�fs
��zParseExpression._setResultsName)F)N)F)rrrr�r�r�rCrFr�rrKrIr�rirrrTrr3�s	
"
cs`eZdZdZGdd�de�Zd�fdd�	Z�fdd�Zdd	d
�Zdd�Z	d
d�Z
dd�Z�ZS)ra
    Requires all given :class:`ParseExpression` s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the ``'+'`` operator.
    May also be constructed using the ``'-'`` operator, which will
    suppress backtracking.

    Example::

        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"), name_expr("name"), integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    cseZdZ�fdd�Z�ZS)zAnd._ErrorStopcs&ttj|�j||�d|_|��dS)N�-)rQrr,r�rrCryrTrrr��szAnd._ErrorStop.__init__r�rrrTrr,�sr,Tcs�|r�t|kr�g}t|�D]`\}}|tkrn|t|�dkrdt�||djd}|�t|�d��qxtd��q|�|�q||dd�<tt	|��
||�tdd�|jD��|_|�
|jdj�|jdj|_d|_dS)	Nr�r�r+z0cannot construct And with sequence ending in ...css|]}|jVqdSr��r�r�rrrr��szAnd.__init__.<locals>.<genexpr>rT)r&r�r�rr�r�r;rrQrr�r�r�rDr�r�r�)r�r�r�r�r�r�Z
skipto_argrTrrr��s
zAnd.__init__cs�|jr�tdd�|jdd�D��r�t|jdd��D]^\}}|dkrFq4t|t�r4|jr4t|jdt�r4|jd|j|d|jd<d|j|d<q4dd�|jD�|_tt|���t	dd�|jD��|_
|S)Ncss.|]&}t|t�o$|jo$t|jdt�VqdS�r�N)r�r3r�r'r�rrrr��s�z!And.streamline.<locals>.<genexpr>r�r�cSsg|]}|dk	r|�qSr�rr�rrrr�sz"And.streamline.<locals>.<listcomp>css|]}|jVqdSr�r�r�rrrr��s)r�rvr�r�r3r'rQrrr�r�)r�r�r�rTrrr�s$�
��zAnd.streamlinec	Cs�|jdj|||dd�\}}d}|jdd�D]�}t|tj�rDd}q.|r�z|�|||�\}}Wq�tk
rt�Yq�tk
r�}zd|_t�|��W5d}~XYq�t	k
r�t|t
|�|j|��Yq�Xn|�|||�\}}|s�|��r.||7}q.||fS)NrFrr�T)
r�r�r�rr,r6r0r�r�rr�r�r;)	r�r�r�r��
resultlistZ	errorStopr�Z
exprtokensr�rrrr��s(
z
And.parseImplcCst|t�r|�|�}|�|�Sr��r�rr�r�rSrrrrD�s

zAnd.__iadd__cCs6|dd�|g}|jD]}|�|�|jsq2qdSr�)r�rIr��r�r��subRecCheckListr�rrrrI�s


zAnd.checkRecursioncCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�{r�css|]}t|�VqdSr�r�r�rrrr��szAnd.__str__.<locals>.<genexpr>�}�r1rr�r�r�r�rrrr��s


 zAnd.__str__)T)T)
rrrr�rr,r�rr�rDrIr�rirrrTrrts
cs^eZdZdZd�fdd�	Z�fdd�Zddd	�Zd
d�Zdd
�Zdd�Z	d�fdd�	Z
�ZS)r/a�Requires that at least one :class:`ParseExpression` is found. If
    two expressions match, the expression that matches the longest
    string will be used. May be constructed using the ``'^'``
    operator.

    Example::

        # construct Or using '^' operator

        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))

    prints::

        [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�rrrr��szOr.__init__.<locals>.<genexpr>T)rQr/r�r�rvr�r�rTrrr��szOr.__init__cs.tt|���tjr*tdd�|jD��|_|S)Ncss|]}|jVqdSr��r�r�rrrr��sz Or.streamline.<locals>.<genexpr>)rQr/rr�collect_all_And_tokensrvr�r�r�rTrrr�sz
Or.streamlineTcCs�d}d}g}|jD]�}z|�||�}Wnvtk
rb}	zd|	_|	j|krR|	}|	j}W5d}	~	XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqX|�||f�q|�r�|j	t
d�dd�|s�|dd}
|
�|||�Sd}|D]�\}}
||dk�r
|Sz|
�|||�\}}Wn@tk
�r`}	z d|	_|	j|k�rP|	}|	j}W5d}	~	XYq�X||k�rx||fS||dkr�||f}q�|dk�r�|S|dk	�r�|j|_|�nt||d|��dS)Nr�rT)r@r r�r�� no defined alternatives to match)
r�r�r2r�r�rr�r�r��sortrr�r�)r�r�r�r��	maxExcLoc�maxExceptionrr�Zloc2r�Z	best_exprZlongestZloc1Zexpr1r�rrrr��sT





zOr.parseImplcCst|t�r|�|�}|�|�Sr�r�rSrrr�__ixor__;s

zOr.__ixor__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nrr�z ^ css|]}t|�VqdSr�r�r�rrrr�EszOr.__str__.<locals>.<genexpr>r�r�r�rrrr�@s


 z
Or.__str__cCs,|dd�|g}|jD]}|�|�qdSr��r�rIr�rrrrIIs
zOr.checkRecursioncsPtjs>tjr>tdd�|jD��r>tjd�d|t	|�j
�dd�tt|��
||�S)Ncss|]}t|t�VqdSr��r�rr�rrrr�Qsz%Or._setResultsName.<locals>.<genexpr>��{0}: setting results name {1!r} on {2} expression may only return a single token for an And alternative, in future will return the full list of tokens�)warn_multiple_tokens_in_named_alternationr�r$)rr�rr�rvr�r(r)r�r�rrQr/r�r�rTrrr�Ns���zOr._setResultsName)F)T)F)rrrr�r�rr�r�r�rIr�rirrrTrr/�s
=	cs^eZdZdZd�fdd�	Z�fdd�Zddd	�Zd
d�Zdd
�Zdd�Z	d�fdd�	Z
�ZS)r)a�Requires that at least one :class:`ParseExpression` is found. If
    two expressions match, the first one listed is the one that will
    match. May be constructed using the ``'|'`` operator.

    Example::

        # construct MatchFirst using '|' operator

        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�rrrr�osz&MatchFirst.__init__.<locals>.<genexpr>T)rQr)r�r�rvr�r�rTrrr�lszMatchFirst.__init__cs.tt|���tjr*tdd�|jD��|_|S)Ncss|]}|jVqdSr�r�r�rrrr�vsz(MatchFirst.streamline.<locals>.<genexpr>)rQr)rrr�rvr�r�r�rTrrrsszMatchFirst.streamlineTc	Cs�d}d}|jD]�}z|�|||�}|WStk
r`}z|j|krP|}|j}W5d}~XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqXq|dk	r�|j|_|�nt||d|��dS)Nr�r�)r�r�r2r�rr�r�r�)	r�r�r�r�r�r�r�r�r�rrrr�ys$


zMatchFirst.parseImplcCst|t�r|�|�}|�|�Sr�r�rSrrr�__ior__�s

zMatchFirst.__ior__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nrr�� | css|]}t|�VqdSr�r�r�rrrr��sz%MatchFirst.__str__.<locals>.<genexpr>r�r�r�rrrr��s


 zMatchFirst.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�rrrrI�s
zMatchFirst.checkRecursioncsPtjs>tjr>tdd�|jD��r>tjd�d|t	|�j
�dd�tt|��
||�S)Ncss|]}t|t�VqdSr�r�r�rrrr��sz-MatchFirst._setResultsName.<locals>.<genexpr>r�r�r�r$)rr�rr�rvr�r(r)r�r�rrQr)r�r�rTrrr��s���zMatchFirst._setResultsName)F)T)F)rrrr�r�rr�r�r�rIr�rirrrTrr)[s
	csHeZdZdZd
�fdd�	Z�fdd�Zddd�Zd	d
�Zdd�Z�Z	S)rasRequires all given :class:`ParseExpression` s to be found, but in
    any order. Expressions may be separated by whitespace.

    May be constructed using the ``'&'`` operator.

    Example::

        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )

    prints::

        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    Tcs>tt|��||�tdd�|jD��|_d|_d|_d|_dS)Ncss|]}|jVqdSr�r�r�rrrr��sz Each.__init__.<locals>.<genexpr>T)	rQrr�r�r�r�r��initExprGroupsr�r�rTrrr��s
z
Each.__init__cs(tt|���tdd�|jD��|_|S)Ncss|]}|jVqdSr�r�r�rrrr��sz"Each.streamline.<locals>.<genexpr>)rQrrr�r�r�r�rTrrr�szEach.streamlinec	s�|jr�tdd�|jD��|_dd�|jD�}dd�|jD�}|||_dd�|jD�|_dd�|jD�|_dd�|jD�|_|j|j7_d	|_|}|jdd�}|jdd��g}d
}	|	�rj|�|j|j}
g}|
D]v}z|�||�}Wn t	k
�r|�
|�Yq�X|�
|j�t|�|��||k�r@|�
|�q�|�kr܈�
|�q�t|�t|
�kr�d	}	q�|�r�d�dd�|D��}
t	||d
|
��|�fdd�|jD�7}g}|D]"}|�|||�\}}|�
|��q�t|tg��}||fS)Ncss&|]}t|t�rt|j�|fVqdSr�)r�r.rVr�r�rrrr��s
z!Each.parseImpl.<locals>.<genexpr>cSsg|]}t|t�r|j�qSr�r�r.r�r�rrrr�s
z"Each.parseImpl.<locals>.<listcomp>cSs g|]}|jrt|t�s|�qSr)r�r�r.r�rrrr�s
cSsg|]}t|t�r|j�qSr)r�rEr�r�rrrr�s
cSsg|]}t|t�r|j�qSr)r�r,r�r�rrrr�s
cSs g|]}t|tttf�s|�qSr)r�r.rEr,r�rrrr�sFTrVcss|]}t|�VqdSr�r�r�rrrr�sz*Missing one or more required elements (%s)cs$g|]}t|t�r|j�kr|�qSrr�r��ZtmpOptrrrs

)r�rr�Zopt1mapZ	optionalsZmultioptionalsZ
multirequiredZrequiredr�r2r�r�rV�remover�r�r��sumr5)r�r�r�r�Zopt1Zopt2ZtmpLocZtmpReqdZ
matchOrderZkeepMatchingZtmpExprsZfailedr�Zmissingr�r�ZfinalResultsrr�rr��sP

zEach.parseImplcCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nrr�z & css|]}t|�VqdSr�r�r�rrrr�,szEach.__str__.<locals>.<genexpr>r�r�r�rrrr�'s


 zEach.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�rrrrI0s
zEach.checkRecursion)T)T)
rrrr�r�rr�r�rIrirrrTrr�s8
1	csjeZdZdZd�fdd�	Zddd�Zdd	�Z�fd
d�Z�fdd
�Zdd�Z	ddd�Z
�fdd�Z�ZS)r1zfAbstract subclass of :class:`ParserElement`, for combining and
    post-processing parsed tokens.
    Fcs�tt|��|�t|t�r@t|jt�r2|�|�}n|�t|��}||_	d|_
|dk	r�|j|_|j|_|�
|j�|j|_|j|_|j|_|j�|j�dSr�)rQr1r�r�r�
issubclassr�r?r'r�r�r�r�rDr�r�r�r�r�rE�r�r�r�rTrrr�:s
zParseElementEnhance.__init__TcCs2|jdk	r|jj|||dd�Std||j|��dS)NFrr�)r�r�r2r�r�rrrr�Ls
zParseElementEnhance.parseImplcCs*d|_|j��|_|jdk	r&|j��|Sr~)r�r�rIrCr�rrrrCRs


z#ParseElementEnhance.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jdk	rn|j�|jd�n,tt|��|�|jdk	rn|j�|jd�|Sr.)r�r>r�rQr1rFr�rSrTrrrFYs



zParseElementEnhance.ignorecs&tt|���|jdk	r"|j��|Sr�)rQr1rr�r�rTrrres

zParseElementEnhance.streamlinecCsB||krt||g��|dd�|g}|jdk	r>|j�|�dSr�)r9r�rI)r�r�r�rrrrIks

z"ParseElementEnhance.checkRecursionNcCsB|dkrg}|dd�|g}|jdk	r4|j�|�|�g�dSr��r�rKrI�r�rJr�rrrrKrs
zParseElementEnhance.validatecsXztt|���WStk
r$YnX|jdkrR|jdk	rRd|jjt|j�f|_|jSr�)	rQr1r�rr�r�r�rr�r�rTrrr�zszParseElementEnhance.__str__)F)T)N)
rrrr�r�r�rCrFrrIrKr�rirrrTrr16s

cs*eZdZdZ�fdd�Zddd�Z�ZS)r abLookahead matching of the given parse expression.
    ``FollowedBy`` does *not* advance the parsing position within
    the input string, it only verifies that the specified parse
    expression matches at the current position.  ``FollowedBy``
    always returns a null token list. If any results names are defined
    in the lookahead expression, those *will* be returned for access by
    name.

    Example::

        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))

        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()

    prints::

        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    cstt|��|�d|_dSr�)rQr r�r��r�r�rTrrr��szFollowedBy.__init__TcCs(|jj|||d�\}}|dd�=||fS)Nr�)r�r�)r�r�r�r��_r�rrrr��s
zFollowedBy.parseImpl)TrqrrrTrr �scs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r(apLookbehind matching of the given parse expression.
    ``PrecededBy`` does not advance the parsing position within the
    input string, it only verifies that the specified parse expression
    matches prior to the current position.  ``PrecededBy`` always
    returns a null token list, but if a results name is defined on the
    given expression, it is returned.

    Parameters:

     - expr - expression that must match prior to the current parse
       location
     - retreat - (default= ``None``) - (int) maximum number of characters
       to lookbehind prior to the current parse location

    If the lookbehind expression is a string, Literal, Keyword, or
    a Word or CharsNotIn with a specified exact or maximum length, then
    the retreat parameter is not required. Otherwise, retreat must be
    specified to give a maximum number of characters to look back from
    the current parse position for a lookbehind match.

    Example::

        # VB-style variable names with type prefixes
        int_var = PrecededBy("#") + pyparsing_common.identifier
        str_var = PrecededBy("$") + pyparsing_common.identifier

    Ncs�tt|��|�|����|_d|_d|_d|_t|t	�rJt
|�}d|_nVt|ttf�rf|j
}d|_n:t|ttf�r�|jtkr�|j}d|_nt|t�r�d}d|_||_dt	|�|_d|_dS)NTFrznot preceded by )rQr(r�r�rCr�r�r�r�r�r�r'r$rtrBrr�rhr��retreatr�r�)r�r�rrTrrr��s(

zPrecededBy.__init__rTcCs�|jr<||jkrt|||j��||j}|j�||�\}}n�|jt�}|d|�}t|||j�}	tdt||jd��D]H}
z|�|||
�\}}Wn&t	k
r�}z|}	W5d}~XYqxXq�qx|	�|dd�=||fSr�)
r�rr2r�r�r�r<rr�r0)r�r�r�r�r�rr�Z	test_exprZinstring_sliceZ	last_exprrMZpberrrr��s"


zPrecededBy.parseImpl)N)rTrqrrrTrr(�scs2eZdZdZ�fdd�Zd	dd�Zdd�Z�ZS)
r+a�Lookahead to disallow matching with the given parse expression.
    ``NotAny`` does *not* advance the parsing position within the
    input string, it only verifies that the specified parse expression
    does *not* match at the current position.  Also, ``NotAny`` does
    *not* skip over leading whitespace. ``NotAny`` always returns
    a null token list.  May be constructed using the '~' operator.

    Example::

        AND, OR, NOT = map(CaselessKeyword, "AND OR NOT".split())

        # take care not to mistake keywords for identifiers
        ident = ~(AND | OR | NOT) + Word(alphas)
        boolean_term = Optional(NOT) + ident

        # very crude boolean expression - to support parenthesis groups and
        # operation hierarchy, use infixNotation
        boolean_expr = boolean_term + ZeroOrMore((AND | OR) + boolean_term)

        # integers that are followed by "." are actually floats
        integer = Word(nums) + ~Char(".")
    cs0tt|��|�d|_d|_dt|j�|_dS)NFTzFound unwanted token, )rQr+r�r�r�r�r�r�rrTrrr�
szNotAny.__init__TcCs&|j�||�rt|||j|��|gfSr�)r�r�r2r�r�rrrr�szNotAny.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nrz~{r��r1rr�r�r�r�rrrr�s


zNotAny.__str__)Tr�rrrTrr+�s
cs>eZdZd�fdd�	Zdd�Zd
dd�Zd�fd
d�	Z�ZS)�_MultipleMatchNcs<tt|��|�d|_|}t|t�r.|�|�}|�|�dSr�)rQrr�r�r�rr��stopOn)r�r�r�enderrTrrr� s

z_MultipleMatch.__init__cCs,t|t�r|�|�}|dk	r"|nd|_|Sr�)r�rr��	not_ender)r�rrrrr(s

z_MultipleMatch.stopOnTc	Cs�|jj}|j}|jdk	}|r$|jj}|r2|||�||||dd�\}}zV|j}	|r`|||�|	rp|||�}
n|}
|||
|�\}}|s�|��rR||7}qRWnttfk
r�YnX||fS�NFr)	r�r�r�r	r�r�r;r2r)r�r�r�r�Zself_expr_parseZself_skip_ignorablesZcheck_enderZ
try_not_enderr�ZhasIgnoreExprsr�Z	tmptokensrrrr�.s*



z_MultipleMatch.parseImplFcsftjrT|jgt|jdg�D]6}t|t�r|jrtjd�	d|t
|�j|j�dd�qtt
|��||�S)Nr�r�r�r�r$)rr�r�r�r�r7r�r(r)r�r�rrQrr�r�rTrrr�Ks��z_MultipleMatch._setResultsName)N)T)F)rrrr�rr�r�rirrrTrrs
rc@seZdZdZdd�ZdS)r,ajRepetition of one or more of the given expression.

    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default= ``None``) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition
          expression)

    Example::

        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]

        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    cCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nrr�z}...rr�rrrr�ss


zOneOrMore.__str__N)rrrr�r�rrrrr,Yscs8eZdZdZd
�fdd�	Zd�fdd�	Zdd	�Z�ZS)rEakOptional repetition of zero or more of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default= ``None``) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition
          expression)

    Example: similar to :class:`OneOrMore`
    Ncstt|�j||d�d|_dS)N)rT)rQrEr�r�)r�r�rrTrrr��szZeroOrMore.__init__Tc	s<ztt|��|||�WSttfk
r6|gfYSXdSr�)rQrEr�r2rr�rTrrr��szZeroOrMore.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)NrrU�]...rr�rrrr��s


zZeroOrMore.__str__)N)Tr�rrrTrrE|s
c@s eZdZdd�ZeZdd�ZdS)�
_NullTokencCsdSr~rr�rrrr*�sz_NullToken.__bool__cCsdSr�rr�rrrr��sz_NullToken.__str__N)rrrr*r�r�rrrrr�srcs<eZdZdZe�Zef�fdd�	Zd	dd�Zdd�Z�Z	S)
r.aGOptional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::

        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345

            # ZIP+4 form
            12101-0001

            # invalid ZIP
            98765-
            ''')

    prints::

        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    cs.tt|�j|dd�|jj|_||_d|_dS)NFroT)rQr.r�r�r�rAr�)r�r�r<rTrrr��s
zOptional.__init__Tc	Cs|z|jj|||dd�\}}WnVttfk
rr|j|jk	rj|jjr`t|jg�}|j||jj<qn|jg}ng}YnX||fSr
)r�r�r2rrA�_Optional__optionalNotMatchedr�r5)r�r�r�r�r�rrrr��s

zOptional.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)NrrUrXrr�rrrr��s


zOptional.__str__)T)
rrrr�rr
r�r�r�rirrrTrr.�s
$
cs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r;a�	Token for skipping over all undefined text until the matched
    expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default= ``False``) if True, the target expression is also parsed
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default= ``None``) used to define grammars (typically quoted strings and
          comments) that might contain false matches to the target expression
     - failOn - (default= ``None``) define expressions that are not allowed to be
          included in the skipped test; if found before the target expression is found,
          the SkipTo is not a match

    Example::

        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP
                      + string_data("sev") + SEP
                      + string_data("desc") + SEP
                      + integer("days_open"))

        for tkt in ticket_expr.searchString(report):
            print tkt.dump()

    prints::

        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    FNcs`tt|��|�||_d|_d|_||_d|_t|t	�rF|�
|�|_n||_dt|j
�|_dS)NTFzNo match found for )rQr;r��
ignoreExprr�r��includeMatchr�r�rr��failOnr�r�r�)r�rJZincluderFrrTrrr� s
zSkipTo.__init__Tc	Cs&|}t|�}|j}|jj}|jdk	r,|jjnd}|jdk	rB|jjnd}	|}
|
|kr�|dk	rf|||
�rfq�|	dk	r�z|	||
�}
Wqntk
r�Yq�YqnXqnz|||
ddd�Wq�tt	fk
r�|
d7}
YqJXq�qJt|||j
|��|
}|||�}t|�}|j�r||||dd�\}}
||
7}||fS)NF)r�r�r�r)
r�r�r�rr�rr�r0r2rr�r5r)r�r�r�r�r�r�r�Z
expr_parseZself_failOn_canParseNextZself_ignoreExpr_tryParseZtmplocZskiptextZ
skipresultr�rrrr�-s:
zSkipTo.parseImpl)FNN)TrqrrrTrr;�s9
csneZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zdd
d�Z	dd�Z
�fdd�Zd�fdd�	Z�Z
S)r!a_Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the ``Forward``
    variable using the '<<' operator.

    Note: take care when assigning to ``Forward`` not to overlook
    precedence of operators.

    Specifically, '|' has a lower precedence than '<<', so that::

        fwdExpr << a | b | c

    will actually be evaluated as::

        (fwdExpr << a) | b | c

    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the ``Forward``::

        fwdExpr << (a | b | c)

    Converting to use the '<<=' operator instead will avoid this problem.

    See :class:`ParseResults.pprint` for an example of a recursive
    parser created using ``Forward``.
    Ncstt|�j|dd�dSrn)rQr!r�rSrTrrr�wszForward.__init__cCsjt|t�r|�|�}||_d|_|jj|_|jj|_|�|jj�|jj	|_	|jj
|_
|j�|jj�|Sr�)
r�rr�r�r�r�r�rDr�r�r�r�rErSrrr�
__lshift__zs





zForward.__lshift__cCs||>Sr�rrSrrr�__ilshift__�szForward.__ilshift__cCs
d|_|Sr~rBr�rrrrC�szForward.leaveWhitespacecCs$|js d|_|jdk	r |j��|Sr�)r�r�rr�rrrr�s


zForward.streamlinecCsJ|dkrg}||kr<|dd�|g}|jdk	r<|j�|�|�g�dSr�rrrrrrK�s
zForward.validatecCslt|d�r|jS|jdk	r |jSd|_d}z&|jdk	rJt|j�dd�}nd}W5|jjd||_X|jS)Nrz: ...rjz: i��None)r1rr�r�rr�r�)r�Z	retStringrrrr��s


zForward.__str__cs.|jdk	rtt|���St�}||K}|SdSr�)r�rQr!rIrcrTrrrI�s

zForward.copyFcs@tjr.|jdkr.tjd�d|t|�j�dd�tt	|��
||�S)NzR{0}: setting results name {0!r} on {1} expression that has no contained expression�warn_name_set_on_empty_Forwardr�r$)rrr�r(r)r�r�rrQr!r�r�rTrrr��s
��zForward._setResultsName)N)N)F)rrrr�r�rrrCrrKr�rIr�rirrrTrr!\s


cs"eZdZdZd�fdd�	Z�ZS)r@zW
    Abstract subclass of :class:`ParseExpression`, for converting parsed results.
    Fcstt|��|�d|_dSr~)rQr@r�r�r�rTrrr��szTokenConverter.__init__)FrprrrTrr@�scs6eZdZdZd
�fdd�	Z�fdd�Zdd	�Z�ZS)ra�Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the
    input string; this can be disabled by specifying
    ``'adjacent=False'`` in the constructor.

    Example::

        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    r�Tcs8tt|��|�|r|��||_d|_||_d|_dSr�)rQrr�rC�adjacentr��
joinStringr�)r�r�rrrTrrr��szCombine.__init__cs(|jrt�||�ntt|��|�|Sr�)rr7rFrQrrSrTrrrF�szCombine.ignorecCsP|��}|dd�=|td�|�|j��g|jd�7}|jrH|��rH|gS|SdS)Nr�)r)rIr5r�rYrr�r�r;)r�r�r�r�ZretToksrrrr��s
"zCombine.postParse)r�T)rrrr�r�rFr�rirrrTrr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)r#aConverter to return the matched tokens as a list - useful for
    returning tokens of :class:`ZeroOrMore` and :class:`OneOrMore` expressions.

    Example::

        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a, b, 100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a, b, 100"))  # -> ['fn', ['a', 'b', '100']]
    cstt|��|�d|_dSr�)rQr#r�r�rrTrrr�
szGroup.__init__cCs|gSr�rr�rrrr�szGroup.postParse�rrrr�r�r�rirrrTrr#�scs(eZdZdZ�fdd�Zdd�Z�ZS)ra?Converter to return a repetitive expression as a list, but also
    as a dictionary. Each element can also be referenced using the first
    token in the expression as its key. Useful for tabular report
    scraping when the first column can be used as a item key.

    Example::

        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))

        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())

        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())

        # access named fields as dict entries, or output as dict
        print(result['shape'])
        print(result.asDict())

    prints::

        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}

    See more examples at :class:`ParseResults` of accessing fields by results name.
    cstt|��|�d|_dSr�)rQrr�r�rrTrrr�8sz
Dict.__init__cCs�t|�D]�\}}t|�dkrq|d}t|t�r@t|d���}t|�dkr\td|�||<qt|�dkr�t|dt�s�t|d|�||<q|��}|d=t|�dks�t|t�r�|�	�r�t||�||<qt|d|�||<q|j
r�|gS|SdS)Nrr�r�r�)r�r�r�r�r�r�r�r5rIr;r�)r�r�r�r�r��tokZikeyZ	dictvaluerrrr�<s$
zDict.postParserrrrTrrs&c@s eZdZdZdd�Zdd�ZdS)r>a[Converter for ignoring the results of a parsed expression.

    Example::

        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))

    prints::

        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']

    (See also :class:`delimitedList`.)
    cCsgSr�rr�rrrr�kszSuppress.postParsecCs|Sr�rr�rrrrAnszSuppress.suppressN)rrrr�r�rArrrrr>Usc@s(eZdZdZdd�Zdd�Zdd�ZdS)	r-zDWrapper for parse actions, to ensure they are only called once.
    cCst|�|_d|_dSr~)r�r��called)r�Z
methodCallrrrr�us
zOnlyOnce.__init__cCs.|js|�|||�}d|_|St||d��dS)NTr�)rr�r2)r�r�r�r�r�rrrr@xs
zOnlyOnce.__call__cCs
d|_dSr~)rr�rrr�reset~szOnlyOnce.resetN)rrrr�r�r@rrrrrr-rscs:t����fdd�}z�j|_Wntk
r4YnX|S)aqDecorator for debugging parse actions.

    When the parse action is called, this decorator will print
    ``">> entering method-name(line:<current_source_line>, <parse_location>, <matched_tokens>)"``.
    When the parse action completes, the decorator will print
    ``"<<"`` followed by the returned value, or any exception that the parse action raised.

    Example::

        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))

    prints::

        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    c
s��j}|dd�\}}}t|�dkr8|djjd|}tj�d|t||�||f�z�|�}Wn8tk
r�}ztj�d||f��W5d}~XYnXtj�d||f�|S)Nr�r�r�.z">>entering %s(line: '%s', %d, %r)
z<<leaving %s (exception: %s)
z<<leaving %s (ret: %r)
)rr�r�r��stderrr`r[r)ZpaArgsZthisFuncr�r�r�r�r��rOrr�z�sztraceParseAction.<locals>.z)r�rr�)rOrrrrrv�s
�,cCs`t|�dt|�dt|�d}|rBt|t||���|�S|tt|�|��|�SdS)a�Helper to define a delimited list of expressions - the delimiter
    defaults to ','. By default, the list elements and delimiters can
    have intervening whitespace, and comments, but this can be
    overridden by passing ``combine=True`` in the constructor. If
    ``combine`` is set to ``True``, the matching tokens are
    returned as a single token string, with the delimiters included;
    otherwise, the matching tokens are returned as a list of tokens,
    with the delimiters suppressed.

    Example::

        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    z [r�rN)r�rrEr�r>)r�Zdelim�combineZdlNamerrrrT�s$csjt����fdd�}|dkr0tt��dd��}n|��}|�d�|j|dd�|��d	t��d
�S)a>Helper to define a counted list of expressions.

    This helper defines a pattern of the form::

        integer expr expr expr...

    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the
    leading count token is suppressed.

    If ``intExpr`` is specified, it should be a pyparsing expression
    that produces an integer value.

    Example::

        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    cs.|d}�|r tt�g|��p&tt�>gSr�)r#rrW)r�r�r�r1�Z	arrayExprr�rr�countFieldParseAction�s"z+countedArray.<locals>.countFieldParseActionNcSst|d�Sr�)r�r�rrrr��r�zcountedArray.<locals>.<lambda>ZarrayLenT�r�z(len) rj)r!rBrfr�rIr�r�r�)r�ZintExprr"rr!rrP�s
cCs6g}|D](}t|t�r&|�t|��q|�|�q|Sr�)r�rrEr r�)�Lr�r�rrrr �s
r cs6t���fdd�}|j|dd���dt|���S)a4Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks for
    a 'repeat' of a previous expression.  For example::

        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second

    will match ``"1:1"``, but not ``"1:2"``.  Because this
    matches a previous literal, will also match the leading
    ``"1:1"`` in ``"1:10"``. If this is not desired, use
    :class:`matchPreviousExpr`. Do *not* use with packrat parsing
    enabled.
    csP|rBt|�dkr�|d>qLt|���}�tdd�|D��>n
�t�>dS)Nr�rcss|]}t|�VqdSr�)r'�r�Zttrrrr�
szDmatchPreviousLiteral.<locals>.copyTokenToRepeater.<locals>.<genexpr>)r�r rrr)r�r�r�Ztflat�Zreprr�copyTokenToRepeatersz1matchPreviousLiteral.<locals>.copyTokenToRepeaterTr#�(prev) )r!r�r�r�)r�r'rr&rrc�s

csFt��|��}�|K��fdd�}|j|dd���dt|���S)aTHelper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks for
    a 'repeat' of a previous expression.  For example::

        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second

    will match ``"1:1"``, but not ``"1:2"``.  Because this
    matches by expressions, will *not* match the leading ``"1:1"``
    in ``"1:10"``; the expressions are evaluated first, and then
    compared, so ``"1"`` is compared with ``"10"``. Do *not* use
    with packrat parsing enabled.
    cs*t|�����fdd�}�j|dd�dS)Ncs$t|���}|�kr tddd��dS)Nr�r)r rr2)r�r�r�ZtheseTokens�ZmatchTokensrr�mustMatchTheseTokens%szLmatchPreviousExpr.<locals>.copyTokenToRepeater.<locals>.mustMatchTheseTokensTr#)r rr�)r�r�r�r*r&r)rr'#sz.matchPreviousExpr.<locals>.copyTokenToRepeaterTr#r()r!rIr�r�r�)r�Ze2r'rr&rrbscCs:dD]}|�|t|�}q|�dd�}|�dd�}t|�S)Nz\^-]r�r\r�r�)r��_bslashr�)r�r�rrrr�.s
r�cs�t|t�rtjddd�|r:dd�}dd�}|r4tnt�ndd�}dd�}|rRtnt�g}t|t�rn|��}n$t|t	�r�t
|�}ntjd	tdd�|s�t�S|�s.d
}|t
|�dk�r.||}t||dd��D]N\}	}
||
|�r�|||	d=q�q�|||
�r�|||	d=|�||
�q�q�|d7}q�|�s�|�s�|�r�zlt
|�t
d
�|��k�r�tdd
�dd�|D����d�|��WStd�dd�|D����d�|��WSWn&tk
�r�tjdtdd�YnXt�fdd�|D���d�|��S)a�Helper to quickly define a set of alternative Literals, and makes
    sure to do longest-first testing when there is a conflict,
    regardless of the input order, but returns
    a :class:`MatchFirst` for best performance.

    Parameters:

     - strs - a string of space-delimited literals, or a collection of
       string literals
     - caseless - (default= ``False``) - treat all literals as
       caseless
     - useRegex - (default= ``True``) - as an optimization, will
       generate a Regex object; otherwise, will generate
       a :class:`MatchFirst` object (if ``caseless=True`` or ``asKeyword=True``, or if
       creating a :class:`Regex` raises an exception)
     - asKeyword - (default=``False``) - enforce Keyword-style matching on the
       generated expressions

    Example::

        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))

    prints::

        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    z_More than one string argument passed to oneOf, pass choices as a list or space-delimited stringr�r$cSs|��|��kSr�)r~�rL�brrrr�[r�zoneOf.<locals>.<lambda>cSs|���|���Sr�)r~ryr,rrrr�\r�cSs||kSr�rr,rrrr�_r�cSs
|�|�Sr�)ryr,rrrr�`r�z6Invalid argument to oneOf, expected string or iterablerr�Nr�r�css|]}t|�VqdSr�)r��r�Zsymrrrr��szoneOf.<locals>.<genexpr>r��|css|]}t�|�VqdSr�)r�r�r.rrrr��sz7Exception creating Regex for oneOf, building MatchFirstc3s|]}�|�VqdSr�rr.�ZparseElementClassrrr��s)r�rr(r)rrr$r'r�r	rr*r*r�r�rBr�r:r�rr))Zstrsr}ZuseRegexr�ZisequalZmasksZsymbolsr�Zcurr#rJrr0rrg6s\ 
�



�


**�cCsttt||���S)a�Helper to easily and clearly define a dictionary by specifying
    the respective patterns for the key and value.  Takes care of
    defining the :class:`Dict`, :class:`ZeroOrMore`, and
    :class:`Group` tokens in the proper order.  The key pattern
    can include delimiting markers or punctuation, as long as they are
    suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the :class:`Dict` results
    can include named token fields.

    Example::

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())

        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())

    prints::

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    )rr,r#)r@r$rrrrU�s%cCs^t��dd��}|��}d|_|d�||d�}|r@dd�}ndd�}|�|�|j|_|S)	a�Helper to return the original, untokenized text for a given
    expression.  Useful to restore the parsed fields of an HTML start
    tag into the raw tag text itself, or to revert separate tokens with
    intervening whitespace back to the original matching input text. By
    default, returns astring containing the original parsed text.

    If the optional ``asString`` argument is passed as
    ``False``, then the return value is
    a :class:`ParseResults` containing any results names that
    were originally matched, and a single token containing the original
    matched text from the input string.  So if the expression passed to
    :class:`originalTextFor` contains expressions with defined
    results names, you must set ``asString`` to ``False`` if you
    want to preserve those results name values.

    Example::

        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b", "i"):
            opener, closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])

    prints::

        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    cSs|Sr�r)r�r�r�rrrr��r�z!originalTextFor.<locals>.<lambda>F�_original_start�
_original_endcSs||j|j�Sr�)r1r2r�rrrr��r�cSs&||�d�|�d��g|dd�<dS)Nr1r2)r?r�rrr�extractText�sz$originalTextFor.<locals>.extractText)rr�rIr�r�)r�ZasStringZ	locMarkerZendlocMarker�	matchExprr3rrrr{�s

cCst|��dd��S)zkHelper to undo pyparsing's default grouping of And expressions,
    even if all but one are non-empty.
    cSs|dSr�rr�rrrr��r�zungroup.<locals>.<lambda>)r@r�)r�rrrr|�scCs4t��dd��}t|d�|d�|����d��S)a�Helper to decorate a returned token with its starting and ending
    locations in the input string.

    This helper adds the following results names:

     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains ``<TAB>`` characters, you
    may want to call :class:`ParserElement.parseWithTabs`

    Example::

        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)

    prints::

        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    cSs|Sr�rr�rrrr��r�zlocatedExpr.<locals>.<lambda>Z
locn_startr$Zlocn_end)rr�r#rIrC)r�Zlocatorrrrr~�sz\[]-*.$+^?()~ �r�cCs|ddSrrr�rrrr�r�r�z\\0?[xX][0-9a-fA-F]+cCstt|d�d�d��S)Nrz\0xr�)�unichrr�rar�rrrr�	r�z	\\0[0-7]+cCstt|ddd�d��S)Nrr��)r6r�r�rrrr�
r�z\]r�rUr��negate�bodyrXcsFdd��z"d��fdd�t�|�jD��WStk
r@YdSXdS)aHelper to easily define string ranges for use in Word
    construction. Borrows syntax from regexp '[]' string range
    definitions::

        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"

    The input string must be enclosed in []'s, and the returned string
    is the expanded character set joined into a single string. The
    values enclosed in the []'s may be:

     - a single character
     - an escaped character with a leading backslash (such as ``\-``
       or ``\]``)
     - an escaped hex character with a leading ``'\x'``
       (``\x21``, which is a ``'!'`` character) (``\0x##``
       is also supported for backwards compatibility)
     - an escaped octal character with a leading ``'\0'``
       (``\041``, which is a ``'!'`` character)
     - a range of any of the above, separated by a dash (``'a-z'``,
       etc.)
     - any combination of the above (``'aeiouy'``,
       ``'a-zA-Z0-9_$'``, etc.)
    cSs<t|t�s|Sd�dd�tt|d�t|d�d�D��S)Nr�css|]}t|�VqdSr��r6r�rrrr�)sz+srange.<locals>.<lambda>.<locals>.<genexpr>rr�)r�r5r�r�ord)�prrrr�)r�zsrange.<locals>.<lambda>r�c3s|]}�|�VqdSr�r)r��part�Z	_expandedrrr�+szsrange.<locals>.<genexpr>N)r��_reBracketExprrr9rr�rr>rrss
"cs�fdd�}|S)zoHelper method for defining parse actions that require matching at
    a specific column in the input text.
    cs"t||��krt||d���dS)Nzmatched token not at column %dr�)r�Zlocnr�r0rr�	verifyCol3sz!matchOnlyAtCol.<locals>.verifyColr)r1r@rr0rra/scs�fdd�S)a�Helper method for common parse actions that simply return
    a literal value.  Especially useful when used with
    :class:`transformString<ParserElement.transformString>` ().

    Example::

        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num

        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    cs�gSr�rr��ZreplStrrrr�Er�zreplaceWith.<locals>.<lambda>rrArrArrp8s
cCs|ddd�S)aHelper parse action for removing quotation marks from parsed
    quoted strings.

    Example::

        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    rr�r�rr�rrrrnGs
csN��fdd�}zt�dt�d�j�}Wntk
rBt��}YnX||_|S)aLHelper to define a parse action by mapping a function to all
    elements of a ParseResults list. If any additional args are passed,
    they are forwarded to the given function as additional arguments
    after the token, as in
    ``hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))``,
    which will convert the parsed data to an integer using base 16.

    Example (compare the last to example in :class:`ParserElement.transformString`::

        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')

        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')

    prints::

        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    cs��fdd�|D�S)Ncsg|]}�|f����qSrr)r�Ztokn�r�r�rrr{sz(tokenMap.<locals>.pa.<locals>.<listcomp>rr�rBrrr�zsztokenMap.<locals>.parr�)r�rrr�)r�r�r�r�rrBrr�Vs$
�cCst|���Sr��r�r~r�rrrr��r�cCst|���Sr��r��lowerr�rrrr��r�rfrgcs~t|t�r|�t||d�}n|j�tttd�}|r�t���	t
�}||d�ttt
|td�|���tddgd�d��	d	d
��|}nlt���	t
�ttdd�B}||d�ttt
|�	t�ttd�|����tddgd�d��	d
d
��|}ttd�|ddd�}|�d��|��fdd
��|dd���dd��������d��}�|_�|_t|��|_||fS)zRInternal helper to construct opening and closing tag expressions, given a tag namer�z_-:�tag�=�/F�r<rWcSs|ddkS�NrrHrr�rrrr��r�z_makeTags.<locals>.<lambda>rgr�cSs|ddkSrJrr�rrrr��r�rh)rz<%s>c	s*|�dd���dd������|���S)Nr�r��:r�)rr�r��titler�rIr��Zresnamerrr��r�r�r�rKr�z</%s>)r�rr$rrBrHrGrRrIr�rnrrEr#r>r.rmrjrVr�_Lr�r�r�r�rLr�rFr;Ztag_body)�tagStrZxmlZsuppress_LTZsuppress_GTZtagAttrNameZtagAttrValueZopenTagZcloseTagrrMr�	_makeTags�sH
���������,rPcCs
t|d�S)aKHelper to construct opening and closing tag expressions for HTML,
    given a tag name. Matches tags in either upper or lower case,
    attributes with namespaces and with quoted or unquoted values.

    Example::

        text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and
        # closing tags as a 2-tuple
        a, a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end

        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are
            # also accessible as named results
            print(link.link_text, '->', link.href)

    prints::

        pyparsing -> https://github.com/pyparsing/pyparsing/wiki
    F�rP�rOrrrr_�scCs
t|d�S)z�Helper to construct opening and closing tag expressions for XML,
    given a tag name. Matches tags only in the given upper/lower case.

    Example: similar to :class:`makeHTMLTags`
    TrQrRrrrr`�scs8|r|dd��n|���dd��D���fdd�}|S)a7Helper to create a validating parse action to be used with start
    tags created with :class:`makeXMLTags` or
    :class:`makeHTMLTags`. Use ``withAttribute`` to qualify
    a starting tag with a required attribute value, to avoid false
    matches on common tags such as ``<TD>`` or ``<DIV>``.

    Call ``withAttribute`` with a series of attribute names and
    values. Specify the list of filter attributes names and values as:

     - keyword arguments, as in ``(align="right")``, or
     - as an explicit dict with ``**`` operator, when an attribute
       name is also a Python reserved word, as in ``**{"class":"Customer", "align":"right"}``
     - a list of name-value tuples, as in ``(("ns1:class", "Customer"), ("ns2:align", "right"))``

    For attribute names with a namespace prefix, you must use the second
    form.  Attribute names are matched insensitive to upper/lower case.

    If just testing for ``class`` (with or without a namespace), use
    :class:`withClass`.

    To verify that the attribute exists, but without specifying a value,
    pass ``withAttribute.ANY_VALUE`` as the value.

    Example::

        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>

        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)

        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)

    prints::

        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    NcSsg|]\}}||f�qSrrrarrrrsz!withAttribute.<locals>.<listcomp>csZ�D]P\}}||kr$t||d|��|tjkr|||krt||d||||f��qdS)Nzno matching attribute z+attribute '%s' has value '%s', must be '%s')r2ry�	ANY_VALUE)r�r�r�ZattrNameZ	attrValue�Zattrsrrr�s�zwithAttribute.<locals>.pa)r!)r�ZattrDictr�rrTrry�s8cCs|rd|nd}tf||i�S)a�Simplified version of :class:`withAttribute` when
    matching on a div class - made difficult because ``class`` is
    a reserved word in Python.

    Example::

        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>

        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))

        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)

        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)

    prints::

        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    z%s:class�class)ry)Z	classname�	namespaceZ	classattrrrrrs#�(r�cCs�Gdd�dt�}t�}||||B}t|�D�]n\}}|ddd�\}	}
}}|
dkr`d|	nd|	}
|
dkr�|	dks�t|	�d	kr�td
��|	\}}t��|
�}|tjk�rp|
dkr�|||	�t|t	|	��}n�|
d	k�r*|	dk	�r|||	|�t|t	|	|��}n|||�t|t	|��}nD|
dk�rf||||||�t|||||�}ntd��n�|tj
k�rT|
dk�r�t|	t��s�t|	�}	||	j
|�t|	|�}n�|
d	k�r|	dk	�r�|||	|�t|t	|	|��}n|||�t|t	|��}nD|
dk�rJ||||||�t|||||�}ntd��ntd
��|�r�t|ttf��r~|j|�n
|�|�||�|
�|BK}|}q.||K}|S)al
Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary
    or binary, left- or right-associative.  Parse actions can also be
    attached to operator expressions. The generated parser will also
    recognize the use of parentheses to override operator precedences
    (see example below).

    Note: if you define a deep operator list, you may see performance
    issues when using infixNotation. See
    :class:`ParserElement.enablePackrat` for a mechanism to potentially
    improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the
       nested
     - opList - list of tuples, one for each operator precedence level
       in the expression grammar; each tuple is of the form ``(opExpr,
       numTerms, rightLeftAssoc, parseAction)``, where:

       - opExpr is the pyparsing expression for the operator; may also
         be a string, which will be converted to a Literal; if numTerms
         is 3, opExpr is a tuple of two expressions, for the two
         operators separating the 3 terms
       - numTerms is the number of terms for this operator (must be 1,
         2, or 3)
       - rightLeftAssoc is the indicator whether the operator is right
         or left associative, using the pyparsing-defined constants
         ``opAssoc.RIGHT`` and ``opAssoc.LEFT``.
       - parseAction is the parse action to be associated with
         expressions matching this operator expression (the parse action
         tuple member may be omitted); if the parse action is passed
         a tuple or list of functions, this is equivalent to calling
         ``setParseAction(*fn)``
         (:class:`ParserElement.setParseAction`)
     - lpar - expression for matching left-parentheses
       (default= ``Suppress('(')``)
     - rpar - expression for matching right-parentheses
       (default= ``Suppress(')')``)

    Example::

        # simple example of four-function arithmetic with ints and
        # variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier

        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])

        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)

    prints::

        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    c@seZdZddd�ZdS)zinfixNotation.<locals>._FBTcSs|j�||�|gfSr�)r�r�r�rrrr��sz$infixNotation.<locals>._FB.parseImplN)Trzrrrr�_FB�srXr�Nr�r�z%s termz	%s%s termr�z@if numterms=3, opExpr must be a tuple or list of two expressionsr�z6operator must be unary (1), binary (2), or ternary (3)z2operator must indicate right or left associativity)r r!r�r�r5r�rh�LEFTr#r,�RIGHTr�r.r�r4rr�)ZbaseExprZopListZlparZrparrXr�ZlastExprr�ZoperDefZopExprZarityZrightLeftAssocr�ZtermNameZopExpr1ZopExpr2ZthisExprr4rrrr}Ds`H�

&
�



&
�

z4"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�"z string enclosed in double quotesz4'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�'z string enclosed in single quotesz*quotedString using single or double quotes�uzunicode string literalcCs�||krtd��|dk�r*t|t��r"t|t��r"t|�dkr�t|�dkr�|dk	r�tt|t||tjdd����	dd��}n$t
��t||tj��	dd��}nx|dk	r�tt|t|�t|�ttjdd����	dd��}n4ttt|�t|�ttjdd����	d	d��}ntd
��t
�}|dk	�rd|tt|�t||B|B�t|��K}n$|tt|�t||B�t|��K}|�d||f�|S)a�	Helper method for defining nested lists enclosed in opening and
    closing delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list
       (default= ``"("``); can also be a pyparsing expression
     - closer - closing character for a nested list
       (default= ``")"``); can also be a pyparsing expression
     - content - expression for items within the nested lists
       (default= ``None``)
     - ignoreExpr - expression for ignoring opening and closing
       delimiters (default= :class:`quotedString`)

    If an expression is not provided for the content argument, the
    nested expression will capture all whitespace-delimited content
    between delimiters as a list of separate values.

    Use the ``ignoreExpr`` argument to define expressions that may
    contain opening or closing characters that should not be treated as
    opening or closing characters for nesting, such as quotedString or
    a comment expression.  Specify multiple expressions using an
    :class:`Or` or :class:`MatchFirst`. The default is
    :class:`quotedString`, but if no expressions are to be ignored, then
    pass ``None`` for this argument.

    Example::

        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR, RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type")
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR
                      + code_body("body"))
        c_function.ignore(cStyleComment)

        source_code = '''
            int is_odd(int x) {
                return (x%2);
            }

            int dec_to_hex(char hchar) {
                if (hchar >= '0' && hchar <= '9') {
                    return (ord(hchar)-ord('0'));
                } else {
                    return (10+ord(hchar)-ord('A'));
                }
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)


    prints::

        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    z.opening and closing strings cannot be the sameNr�r5cSs|d��Sr��r�r�rrrr�r�znestedExpr.<locals>.<lambda>cSs|d��Sr�r^r�rrrr� r�cSs|d��Sr�r^r�rrrr�'r�cSs|d��Sr�r^r�rrrr�,r�zOopening and closing arguments must be strings if no content expression is givenznested %s%s expression)r5r�rr�rr,rr7r�r�rWrIr'r!r#r>rEr�)ZopenerZcloserZcontentrr�rrrrd�s`A
�����
����������
*$cs�dd����fdd���fdd�}�fdd�}�fdd	�}tt��d
����}t�t��|��d�}t��|��d�}t��|��d
�}	|r�tt|�|t|t|�t|��|	�}
n(tt|�t|t|�t|��|	�}
|
�	�fdd��|�
tt��|
�d�S)a�Helper method for defining space-delimited indentation blocks,
    such as those used to define block statements in Python source code.

    Parameters:

     - blockStatementExpr - expression defining syntax of statement that
       is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
       (multiple statementWithIndentedBlock expressions within a single
       grammar should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond
       the current level; set to False for block of left-most
       statements (default= ``True``)

    A valid block must contain at least one ``blockStatement``.

    Example::

        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group("(" + Optional(delimitedList(identifier)) + ")") + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group(funcDecl + func_body)

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << (funcDef | assignment | identifier)

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()

    prints::

        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]]
    Ncs��dd�<dSr�rr)�backup_stack�indentStackrr�reset_stack�sz"indentedBlock.<locals>.reset_stackcsN|t|�krdSt||�}|�dkrJ|�dkr>t||d��t||d��dS)Nr�zillegal nestingznot a peer entry)r�rMr2�r�r�r�ZcurCol�r`rr�checkPeerIndent�s
z&indentedBlock.<locals>.checkPeerIndentcs2t||�}|�dkr"��|�nt||d��dS)Nr�znot a subentry)rMr�r2rbrcrr�checkSubIndent�s
z%indentedBlock.<locals>.checkSubIndentcsJ|t|�krdSt||�}�r&|�ks2t||d��|�dkrF���dS)Nznot an unindentr�)r�rMr2r?rbrcrr�
checkUnindent�s
z$indentedBlock.<locals>.checkUnindentz	 �INDENTr�ZUNINDENTcs��Sr�r)rLr-r�r�)rarrr��r�zindentedBlock.<locals>.<lambda>zindented block)r,r%rDrArr�r�r#r.r�rFr+)ZblockStatementExprr`rjrdrerfrwrgZPEERZUNDENTZsmExprr)r_r`rarrz7s2Q�����z#[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]z[\0xa1-\0xbf\0xd7\0xf7]z_:zany tagzgt lt amp nbsp quot aposz><& "'z&(?P<entity>r/z);zcommon HTML entitycCst�|j�S)zRHelper parser action to replace common HTML entities with their special characters)�_htmlEntityMapr�Zentityr�rrrro�sz/\*(?:[^*]|\*(?!/))*z*/zC style commentz<!--[\s\S]*?-->zHTML commentz.*zrest of linez//(?:\\\n|[^\n])*z
// commentzC++ style commentz#.*zPython style commentr�� 	�	commaItemrIc@s�eZdZdZee�Zee�Ze	e
��d��e�Z
e	e��d��eed��Zed��d��e�Ze��e�de��e��d�Ze�d	d
��eeeed���e�B�d�Ze�e�ed
��d��e�Zed��d��e�ZeeBeB��Zed��d��e�Ze	eded��d�Zed��d�Z ed��d�Z!e!de!d�d�Z"ee!de!d�dee!de!d��d�Z#e#�$dd
��d e �d!�Z%e&e"e%Be#B�d"���d"�Z'ed#��d$�Z(e)d=d&d'��Z*e)d>d)d*��Z+ed+��d,�Z,ed-��d.�Z-ed/��d0�Z.e/��e0��BZ1e)d1d2��Z2e&e3e4d3�e5�e	e6d3d4�ee7d5�������d6�Z8e9ee:�;�e8Bd7d8���d9�Z<e)ed:d
���Z=e)ed;d
���Z>d<S)?r�aHere are some common low-level expressions that may be useful in
    jump-starting parser development:

     - numeric forms (:class:`integers<integer>`, :class:`reals<real>`,
       :class:`scientific notation<sci_real>`)
     - common :class:`programming identifiers<identifier>`
     - network addresses (:class:`MAC<mac_address>`,
       :class:`IPv4<ipv4_address>`, :class:`IPv6<ipv6_address>`)
     - ISO8601 :class:`dates<iso8601_date>` and
       :class:`datetime<iso8601_datetime>`
     - :class:`UUID<uuid>`
     - :class:`comma-separated list<comma_separated_list>`

    Parse actions:

     - :class:`convertToInteger`
     - :class:`convertToFloat`
     - :class:`convertToDate`
     - :class:`convertToDatetime`
     - :class:`stripHTMLTags`
     - :class:`upcaseTokens`
     - :class:`downcaseTokens`

    Example::

        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')

    prints::

        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    �integerzhex integerr�z[+-]?\d+zsigned integerrH�fractioncCs|d|dS)Nrr�rr�rrrr��r�zpyparsing_common.<lambda>r�z"fraction or mixed integer-fractionz[+-]?(:?\d+\.\d*|\.\d+)zreal numberz@[+-]?(:?\d+(:?[eE][+-]?\d+)|(:?\d+\.\d*|\.\d+)(:?[eE][+-]?\d+)?)z$real number with scientific notationz[+-]?\d+\.?\d*([eE][+-]?\d+)?�fnumberr�
identifierzK(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}zIPv4 addressz[0-9a-fA-F]{1,4}�hex_integerrK�zfull IPv6 address)rr�z::zshort IPv6 addresscCstdd�|D��dkS)Ncss|]}tj�|�rdVqdSrd)r��
_ipv6_partrr%rrrr��sz,pyparsing_common.<lambda>.<locals>.<genexpr>r7)r�r�rrrr��r�z::ffff:zmixed IPv6 addresszIPv6 addressz:[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}zMAC address�%Y-%m-%dcs�fdd�}|S)a�
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%d"``)

        Example::

            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))

        prints::

            [datetime.date(1999, 12, 31)]
        c
sNzt�|d����WStk
rH}zt||t|���W5d}~XYnXdSr�)r�strptime�dater5r2r��r�r�r�Zve��fmtrr�cvt_fn�sz.pyparsing_common.convertToDate.<locals>.cvt_fnr�rwrxrrvr�
convertToDate�szpyparsing_common.convertToDate�%Y-%m-%dT%H:%M:%S.%fcs�fdd�}|S)aHelper to create a parse action for converting parsed
        datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%dT%H:%M:%S.%f"``)

        Example::

            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))

        prints::

            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        c
sJzt�|d��WStk
rD}zt||t|���W5d}~XYnXdSr�)rrsr5r2r�rurvrrrx�sz2pyparsing_common.convertToDatetime.<locals>.cvt_fnrryrrvr�convertToDatetime�sz"pyparsing_common.convertToDatetimez7(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?zISO8601 datez�(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?zISO8601 datetimez2[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}�UUIDcCstj�|d�S)aParse action to remove HTML tags from web page HTML source

        Example::

            # strip HTML links from normal text
            text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
            td, td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            print(table_text.parseString(text).body)

        Prints::

            More info at the pyparsing wiki page
        r)r��_html_stripperr�)r�r�r�rrr�
stripHTMLTags�szpyparsing_common.stripHTMLTagsrr�rirjr�rIzcomma separated listcCst|���Sr�rCr�rrrr�r�cCst|���Sr�rDr�rrrr�r�N)rr)r{)?rrrr�r�r�ZconvertToInteger�floatZconvertToFloatrBrfr�r�rkrXror:Zsigned_integerrlr�r.rAZ
mixed_integerr��realZsci_realr�numberrmrHrGrnZipv4_addressrqZ_full_ipv6_addressZ_short_ipv6_addressr�Z_mixed_ipv6_addressrZipv6_addressZmac_addressr�rzr|Ziso8601_dateZiso8601_datetime�uuidrKrJr~rr,r'r%rjrA�
_commasepitemrTrmrIZcomma_separated_listrxrVrrrrr��sv""
���
�
�
��
���c@seZdZdd�Zdd�ZdS)�_lazyclasspropertycCs||_|j|_|j|_dSr�)r�r�rr�rrrr�sz_lazyclassproperty.__init__csl�dkrt|��t�d�r:t�fdd��jdd�D��r@i�_|jj}|�jkrb|����j|<�j|S)N�_internc3s |]}�jt|dg�kVqdS)r�N)r�r�)r�Z
superclassr�rrr�s�z-_lazyclassproperty.__get__.<locals>.<genexpr>r�)r�r1rv�__mro__r�r�r)r�r�r��attrnamerr�r�__get__s�
z_lazyclassproperty.__get__N)rrrr�r�rrrrr�
sr�c@sPeZdZdZgZedd��Zedd��Zedd��Z	edd	��Z
ed
d��ZdS)
r�a�
    A set of Unicode characters, for language-specific strings for
    ``alphas``, ``nums``, ``alphanums``, and ``printables``.
    A unicode_set is defined by a list of ranges in the Unicode character
    set, in a class attribute ``_ranges``, such as::

        _ranges = [(0x0020, 0x007e), (0x00a0, 0x00ff),]

    A unicode set can also be defined using multiple inheritance of other unicode sets::

        class CJK(Chinese, Japanese, Korean):
            pass
    cCsZg}|jD]8}|tkrqD|jD] }|�t|d|dd��q q
dd�tt|��D�S)Nrr�r�cSsg|]}t|��qSrr:r�rrrr4sz5unicode_set._get_chars_for_ranges.<locals>.<listcomp>)r�r��_rangesrErrtr�)r�r�ZccZrrrrr�_get_chars_for_ranges,s

 z!unicode_set._get_chars_for_rangescCsd�ttj|����S)z+all non-whitespace characters in this ranger�)r�rr�r�r�r�rrrrj6szunicode_set.printablescCsd�ttj|����S)z'all alphabetic characters in this ranger�)r��filterr��isalphar�r�rrrrH;szunicode_set.alphascCsd�ttj|����S)z*all numeric digit characters in this ranger�)r�r�r��isdigitr�r�rrrrf@szunicode_set.numscCs|j|jS)z)all alphanumeric characters in this range)rHrfr�rrrrGEszunicode_set.alphanumsN)rrrr�r�r�r�r�rjrHrfrGrrrrr�s

	


c@s�eZdZdZdejfgZGdd�de�ZGdd�de�Z	Gdd�de�Z
Gd	d
�d
e�ZGdd�de�ZGd
d�de�Z
Gdd�de�ZGdd�de�ZGdd�de
ee�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)r�zF
    A namespace class for defining common language unicode_sets.
    � c@seZdZdZddgZdS)zpyparsing_unicode.Latin1z/Unicode set for Latin-1 Unicode Character Range)r��~)��N�rrrr�r�rrrr�Latin1Qsr�c@seZdZdZdgZdS)zpyparsing_unicode.LatinAz/Unicode set for Latin-A Unicode Character Range)�iNr�rrrr�LatinAUsr�c@seZdZdZdgZdS)zpyparsing_unicode.LatinBz/Unicode set for Latin-B Unicode Character Range)i�iONr�rrrr�LatinBYsr�c@s6eZdZdZdddddddd	d
ddd
dddddgZdS)zpyparsing_unicode.Greekz.Unicode set for Greek Unicode Character Ranges)ipi�)ii)ii)i iE)iHiM)iPiW)iY)i[)i])i_i})i�i�)i�i�)i�i�)i�i�)i�i�)i�i�)i�i�Nr�rrrr�Greek]s&�r�c@seZdZdZdgZdS)zpyparsing_unicode.Cyrillicz0Unicode set for Cyrillic Unicode Character Range)ii�Nr�rrrr�Cyrillicesr�c@seZdZdZddgZdS)zpyparsing_unicode.Chinesez/Unicode set for Chinese Unicode Character Range)�Ni���i0i?0Nr�rrrr�Chineseisr�c@sDeZdZdZgZGdd�de�ZGdd�de�ZGdd�de�ZdS)	zpyparsing_unicode.Japanesez`Unicode set for Japanese Unicode Character Range, combining Kanji, Hiragana, and Katakana rangesc@seZdZdZddgZdS)z pyparsing_unicode.Japanese.Kanjiz-Unicode set for Kanji Unicode Character Range)r�i��r�Nr�rrrr�Kanjiqsr�c@seZdZdZdgZdS)z#pyparsing_unicode.Japanese.Hiraganaz0Unicode set for Hiragana Unicode Character Range)i@0i�0Nr�rrrr�Hiraganausr�c@seZdZdZdgZdS)z#pyparsing_unicode.Japanese.Katakanaz1Unicode set for Katakana  Unicode Character Range)i�0i�0Nr�rrrr�Katakanaysr�N)	rrrr�r�r�r�r�r�rrrr�Japanesems
r�c@s eZdZdZddddddgZdS)	zpyparsing_unicode.Koreanz.Unicode set for Korean Unicode Character Range)i�i��)ii�)i01i�1)i`�i�)i��i��r�Nr�rrrr�Korean}sr�c@seZdZdZdS)zpyparsing_unicode.CJKzTUnicode set for combined Chinese, Japanese, and Korean (CJK) Unicode Character RangeNr�rrrr�CJK�sr�c@seZdZdZddgZdS)zpyparsing_unicode.Thaiz,Unicode set for Thai Unicode Character Range)ii:)i?i[Nr�rrrr�Thai�sr�c@seZdZdZdddgZdS)zpyparsing_unicode.Arabicz.Unicode set for Arabic Unicode Character Range)ii)ii�)iiNr�rrrr�Arabic�sr�c@seZdZdZdgZdS)zpyparsing_unicode.Hebrewz.Unicode set for Hebrew Unicode Character Range)i�i�Nr�rrrr�Hebrew�sr�c@seZdZdZddgZdS)zpyparsing_unicode.Devanagariz2Unicode set for Devanagari Unicode Character Range)i	i	)i�i��Nr�rrrr�
Devanagari�sr�N)rrrr�r��
maxunicoder�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�Ksuالعربيةu中文uкириллицаuΕλληνικάuעִברִיתu	日本語u漢字uカタカナuひらがなu	한국어u	ไทยuदेवनागरी�__main__Zselect�fromr{r)r �columnsr�ZtablesZcommandaK
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        z]
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        z 
        100
        FF
        z6
        12345678-1234-5678-1234-567812345678
        )NF)r�)rF)N)FTF)T)r�)T(	r�rrrr��weakrefrrrIr�r(r�r�r
rxr�r�r�operatorr�	itertools�	functoolsrr�ImportErrorr�_threadrZ	threadingZcollections.abcr	r
rrrZordereddictr
rr�rr�r�rZ%warn_on_multiple_string_args_to_oneofr��__all__r4�version_infor�rb�maxsizerhr�r�chrr6r�r�r�r�rt�reversedrr�rvr�r�r�r�ZmaxintZxrangerZ__builtin__r�Zfnamer�r�r�r�r
r�Zascii_uppercaseZascii_lowercaserHrfrXrGr+r�Z	printablerjr�rr0r2r4r6r9r�r�r5�registerrMr^r[r�r�r�rer�r7r'r?rr*r'rvrNr�r$rrr�rBr�rFr:r8rrAr�r"r&r%r=r<rDrCr3rr/r)rr1r r(r+rr,rErr.r;r!r@rr#rr>r-rvrTrPr rcrbr�rgrUr{r|r~r�rWr]r\rurtr�Z_escapedPuncZ_escapedHexCharZ_escapedOctCharZ_singleCharZ
_charRanger�r?rsrarprnr�rxrVrPr_r`ryrSrrhrYrZr}rirRrrrmrwrdrzrIrkrKrJrr�rhr7rOrorLrYrCrqrSrQrZrlrr�rNr�r�r�r�r�r�r�r�r��setattrr�r�r�r�r�r�r�r�rZselectTokenZ	fromTokenZidentZ
columnNameZcolumnNameListZ
columnSpecZ	tableNameZ
tableNameListZ	simpleSQLrgr�rmror�r}rrrr�<module>s�H
�
?]

H

D!
'N
E 
KFyl{VO#K,:#Dvj-D0$	W'*4
 
	


0�%


E&��h~

 (
 
���� ./J��


&
	site-packages/pip/_vendor/__pycache__/contextlib2.cpython-38.opt-1.pyc000064400000036202151446177000021554 0ustar00U

��.eB�	@s�dZddlZddlZddlZddlmZddlmZddddd	d
ddd
g	Zedg7Zej	dd�dkrnej
Zne�de
fddi�Zdd�Zdd�ZGdd�de�ZGdd	�d	e
�ZGdd�de�Zdd�ZGdd�de
�ZGdd�de
�ZGd d�de�ZGd!d�de�ZGd"d
�d
e
�Zej	dd#kZe�r@d$d%�Zd&d'�Znd(d%�Zd)d'�Zzdd*lmZWnek
�rzeZ Yn
Xd+d,�Z Gd-d
�d
e
�Z!Gd.d�de!�Z"Gd/d�de�Z#dS)0zAcontextlib2 - backports and enhancements to the contextlib module�N)�deque��wraps�contextmanager�closing�nullcontext�AbstractContextManager�ContextDecorator�	ExitStack�redirect_stdout�redirect_stderr�suppress�ContextStack�)���ABC�	__slots__�cCs0||krdS|�|�|jD]}t||�q|S�N)�append�	__bases__�_classic_mro)�C�result�Brr�;/usr/lib/python3.8/site-packages/pip/_vendor/contextlib2.pyrs

rcGsvz
|j}Wn"tk
r,tt|g��}YnX|D]>}|D],}||jkr:|j|dkrbtSq2q:tSq2dS)NT)�__mro__�AttributeError�tupler�__dict__�NotImplemented)r�methods�mro�methodrrrr�_check_methods$s


r%c@s2eZdZdZdd�Zejdd��Zedd��Z	dS)	rz,An abstract base class for context managers.cCs|S)z0Return `self` upon entering the runtime context.r��selfrrr�	__enter__8sz AbstractContextManager.__enter__cCsdS)z9Raise any exception triggered within the runtime context.Nr)r'�exc_type�	exc_value�	tracebackrrr�__exit__<szAbstractContextManager.__exit__cCs|tkrt|dd�StS)z<Check whether subclass is considered a subclass of this ABC.r(r,)rr%r!)�clsrrrr�__subclasshook__Asz'AbstractContextManager.__subclasshook__N)
�__name__�
__module__�__qualname__�__doc__r(�abc�abstractmethodr,�classmethodr.rrrrr5s
c@s(eZdZdZdd�Zdd�Zdd�ZdS)	r	zJA base class or mixin that enables context managers to work as decorators.cCst�dt�|��S)a�Returns the context manager used to actually wrap the call to the
        decorated function.

        The default implementation just returns *self*.

        Overriding this method allows otherwise one-shot context managers
        like _GeneratorContextManager to support use as decorators via
        implicit recreation.

        DEPRECATED: refresh_cm was never added to the standard library's
                    ContextDecorator API
        z2refresh_cm was never added to the standard library)�warnings�warn�DeprecationWarning�_recreate_cmr&rrr�
refresh_cmLs
�zContextDecorator.refresh_cmcCs|S)a6Return a recreated instance of self.

        Allows an otherwise one-shot context manager like
        _GeneratorContextManager to support use as
        a decorator via implicit recreation.

        This is a private interface just for _GeneratorContextManager.
        See issue #11647 for details.
        rr&rrrr9]s
zContextDecorator._recreate_cmcst����fdd��}|S)Nc
s*�����||�W5QR�SQRXdSr)r9��args�kwds��funcr'rr�innerjs
z(ContextDecorator.__call__.<locals>.innerr)r'r?r@rr>r�__call__iszContextDecorator.__call__N)r/r0r1r2r:r9rArrrrr	Isc@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�_GeneratorContextManagerz%Helper for @contextmanager decorator.cCsJ|||�|_||||_|_|_t|dd�}|dkr@t|�j}||_dS)Nr2)�genr?r<r=�getattr�typer2)r'r?r<r=�docrrr�__init__ts
z!_GeneratorContextManager.__init__cCs|�|j|j|j�Sr)�	__class__r?r<r=r&rrrr9�sz%_GeneratorContextManager._recreate_cmcCs.zt|j�WStk
r(td��YnXdS)Nzgenerator didn't yield)�nextrC�
StopIteration�RuntimeErrorr&rrrr(�sz"_GeneratorContextManager.__enter__c
Cs�|dkr8zt|j�Wntk
r,YdSXtd��n�|dkrF|�}z|j�|||�td��Wn�tk
r�}z||k	WY�Sd}~XYnjtk
r�}z0||kr�WY�"dStr�|j|kr�WY�
dS�W5d}~XYnt��d|k	r�YnXdS)Nzgenerator didn't stopz#generator didn't stop after throw()F�)	rIrCrJrK�throw�_HAVE_EXCEPTION_CHAINING�	__cause__�sys�exc_info)r'rE�valuer+�excrrrr,�s,


z!_GeneratorContextManager.__exit__N)r/r0r1r2rGr9r(r,rrrrrBqs
rBcst���fdd��}|S)a�@contextmanager decorator.

    Typical usage:

        @contextmanager
        def some_generator(<arguments>):
            <setup>
            try:
                yield <value>
            finally:
                <cleanup>

    This makes this:

        with some_generator(<arguments>) as <variable>:
            <body>

    equivalent to this:

        <setup>
        try:
            <variable> = <value>
            <body>
        finally:
            <cleanup>

    cst�||�Sr)rBr;�r?rr�helper�szcontextmanager.<locals>.helperr)r?rUrrTrr�sc@s(eZdZdZdd�Zdd�Zdd�ZdS)	ra2Context to automatically close something at the end of a block.

    Code like this:

        with closing(<module>.open(<arguments>)) as f:
            <block>

    is equivalent to this:

        f = <module>.open(<arguments>)
        try:
            <block>
        finally:
            f.close()

    cCs
||_dSr��thing)r'rWrrrrG�szclosing.__init__cCs|jSrrVr&rrrr(�szclosing.__enter__cGs|j��dSr)rW�close)r'rQrrrr,�szclosing.__exit__N�r/r0r1r2rGr(r,rrrrr�sc@s(eZdZdZdd�Zdd�Zdd�ZdS)�_RedirectStreamNcCs||_g|_dSr)�_new_target�_old_targets)r'�
new_targetrrrrG�sz_RedirectStream.__init__cCs*|j�tt|j��tt|j|j�|jSr)r\rrDrP�_stream�setattrr[r&rrrr(�sz_RedirectStream.__enter__cCstt|j|j���dSr)r_rPr^r\�pop�r'�exctype�excinst�exctbrrrr,sz_RedirectStream.__exit__)r/r0r1r^rGr(r,rrrrrZ�srZc@seZdZdZdZdS)raAContext manager for temporarily redirecting stdout to another file.

        # How to send help() to stderr
        with redirect_stdout(sys.stderr):
            help(dir)

        # How to write help() to a file
        with open('help.txt', 'w') as f:
            with redirect_stdout(f):
                help(pow)
    �stdoutN�r/r0r1r2r^rrrrrsc@seZdZdZdZdS)rzCContext manager for temporarily redirecting stderr to another file.�stderrNrfrrrrrsc@s(eZdZdZdd�Zdd�Zdd�ZdS)	r
a?Context manager to suppress specified exceptions

    After the exception is suppressed, execution proceeds with the next
    statement following the with statement.

         with suppress(FileNotFoundError):
             os.remove(somefile)
         # Execution still resumes here if the file was already removed
    cGs
||_dSr)�_exceptions)r'�
exceptionsrrrrG)szsuppress.__init__cCsdSrrr&rrrr(,szsuppress.__enter__cCs|dk	ot||j�Sr)�
issubclassrhrarrrr,/s
zsuppress.__exit__NrYrrrrr
s
rcs�fdd�}|S)Ncs4|j}||krdS|dks*|�kr$q*|}q||_dSr)�__context__)�new_exc�old_exc�exc_context��	frame_excrr�_fix_exception_context@sz3_make_context_fixer.<locals>._fix_exception_contextr)rprqrror�_make_context_fixer?s
rrcCs<z|dj}|d�Wn tk
r6||d_�YnXdS)NrL)rk�
BaseException)�exc_details�	fixed_ctxrrr�_reraise_with_existing_contextOs

rvcCsdd�S)NcSsdSrr)rlrmrrr�<lambda>[�z%_make_context_fixer.<locals>.<lambda>rrorrrrrZscCs|\}}}td�dS)Nz!raise exc_type, exc_value, exc_tb)�exec)rtr)r*Zexc_tbrrrrv_s
)�InstanceTypecCst|�}|tkr|jS|Sr)rErzrH)�objZobj_typerrr�	_get_typeksr|c@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)r
a�Context manager for dynamic management of a stack of exit callbacks

    For example:

        with ExitStack() as stack:
            files = [stack.enter_context(open(fname)) for fname in filenames]
            # All opened files will automatically be closed at the end of
            # the with statement, even if attempts to open files later
            # in the list raise an exception

    cCst�|_dSr)r�_exit_callbacksr&rrrrGszExitStack.__init__cCst|��}|j|_t�|_|S)z?Preserve the context stack by transferring it to a new instance)rEr}r)r'�	new_stackrrr�pop_all�s
zExitStack.pop_allcs"��fdd�}�|_|�|�dS)z:Helper to correctly register callbacks to __exit__ methodscs��f|��Srr)rt��cm�cm_exitrr�
_exit_wrapper�sz.ExitStack._push_cm_exit.<locals>._exit_wrapperN)�__self__�push)r'r�r�r�rr�r�
_push_cm_exit�szExitStack._push_cm_exitcCsDt|�}z
|j}Wn tk
r2|j�|�YnX|�||�|S)aRegisters a callback with the standard __exit__ method signature

        Can suppress exceptions the same way __exit__ methods can.

        Also accepts any object with an __exit__ method (registering a call
        to the method instead of the object itself)
        )r|r,rr}rr�)r'�exit�_cb_type�exit_methodrrrr��s

zExitStack.pushcs$���fdd�}�|_|�|��S)z\Registers an arbitrary callback and arguments.

        Cannot suppress exceptions.
        cs����dSrr)r)rS�tb�r<�callbackr=rrr��sz)ExitStack.callback.<locals>._exit_wrapper)�__wrapped__r�)r'r�r<r=r�rr�rr��s
zExitStack.callbackcCs(t|�}|j}|�|�}|�||�|S)z�Enters the supplied context manager

        If successful, also pushes its __exit__ method as a callback and
        returns the result of the __enter__ method.
        )r|r,r(r�)r'r��_cm_type�_exitrrrr�
enter_context�s

zExitStack.enter_contextcCs|�ddd�dS)z$Immediately unwind the context stackN)r,r&rrrrX�szExitStack.closecCs|Srrr&rrrr(�szExitStack.__enter__c	Gs�|ddk	}t��d}t|�}d}d}|jr�|j��}z||�rNd}d}d}Wq(t��}||d|d�d}|}Yq(Xq(|r�t|�|o�|S)NrrLFT)NNN)rPrQrrr}r`rv)	r'rt�received_excrprq�suppressed_exc�
pending_raise�cb�new_exc_detailsrrrr,�s(
zExitStack.__exit__N)
r/r0r1r2rGrr�r�r�r�rXr(r,rrrrr
ss

cs8eZdZdZ�fdd�Zdd�Zdd�Zdd	�Z�ZS)
rz+Backwards compatibility alias for ExitStackcst�dt�tt|���dS)Nz*ContextStack has been renamed to ExitStack)r6r7r8�superrrGr&�rHrrrG�s�zContextStack.__init__cCs
|�|�Sr)r�)r'r�rrr�
register_exit�szContextStack.register_exitcOs|j|f|�|�Sr)r�)r'r�r<r=rrr�register�szContextStack.registercCs|��Sr)rr&rrr�preserve�szContextStack.preserve)	r/r0r1r2rGr�r�r��
__classcell__rrr�rr�s
c@s*eZdZdZd	dd�Zdd�Zdd�ZdS)
raMContext manager that does no additional processing.
    Used as a stand-in for a normal context manager, when a particular
    block of code is only sometimes used with a normal context manager:
    cm = optional_cm if condition else nullcontext()
    with cm:
        # Perform operation, using optional_cm if condition is True
    NcCs
||_dSr��enter_result)r'r�rrrrG�sznullcontext.__init__cCs|jSrr�r&rrrr(sznullcontext.__enter__cGsdSrr)r'�excinforrrr,sznullcontext.__exit__)NrYrrrrr�s
)$r2r3rPr6�collectionsr�	functoolsr�__all__�version_inforZ_abc_ABC�ABCMeta�objectrr%rr	rBrrrZrrr
rNrrrv�typesrz�ImportErrorrEr|r
rrrrrr�<module>sT�

(H"

qsite-packages/pip/_vendor/__pycache__/appdirs.cpython-38.pyc000064400000047725151446177000020036 0ustar00U

��.e�_�@s`dZdZd�eee��ZddlZddlZejddkZ	e	r>eZ
ej�d�r�ddlZe�
�ddZe�d�rrdZq�e�d	�r�d
Zq�dZnejZd4d
d�Zd5dd�Zd6dd�Zd7dd�Zd8dd�Zd9dd�Zd:dd�ZGdd�de�Zdd�Zd d!�Zd"d#�Zd$d%�Zedk�rfzdd&lmZeZWnBe k
�rdzddl!Z"eZWne k
�r^eZYnXYnXe#d'k�r\d(Z$d)Z%d*Z&e'd+e�e'd,�ee$e%d-d.�Z(e&D]Z)e'd/e)e*e(e)�f��q�e'd0�ee$e%�Z(e&D]Z)e'd/e)e*e(e)�f��q�e'd1�ee$�Z(e&D]Z)e'd/e)e*e(e)�f��qe'd2�ee$dd3�Z(e&D]Z)e'd/e)e*e(e)�f��q>dS);zyUtilities for determining application-specific dirs.

See <http://github.com/ActiveState/appdirs> for details and usage.
)����.�Nr�javaZWindows�win32ZMac�darwinZlinux2FcCs�tdkr^|dkr|}|rdpd}tj�t|��}|r�|dk	rNtj�|||�}q�tj�||�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aJReturn full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        Mac OS X:               ~/Library/Application Support/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    rN�
CSIDL_APPDATA�CSIDL_LOCAL_APPDATAFrz~/Library/Application Support/Z
XDG_DATA_HOMEz~/.local/share��system�os�path�normpath�_get_win_folder�join�
expanduser�getenv)�appname�	appauthor�version�roaming�constr�r�7/usr/lib/python3.8/site-packages/pip/_vendor/appdirs.py�
user_data_dir-s& rcstdkrR|dkr�}tj�td��}�r�|dk	rBtj�||��}q�tj�|��}n�tdkrztj�d�}�r�tj�|��}ntt�dtj�dd	g��}d
d�|�	tj�D�}�r�|r�tj��|���fdd�|D�}|r�tj�|�}n|d
}|S��r|�rtj�||�}|S)aiReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of data dirs should be
            returned. By default, the first item from XDG_DATA_DIRS is
            returned, or '/usr/local/share/<AppName>',
            if XDG_DATA_DIRS is not set

    Typical site data directories are:
        Mac OS X:   /Library/Application Support/<AppName>
        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.

    For Unix, this is using the $XDG_DATA_DIRS[0] default.

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    rN�CSIDL_COMMON_APPDATAFrz/Library/Application SupportZ
XDG_DATA_DIRSz/usr/local/sharez
/usr/sharecSs g|]}tj�|�tj���qSr�r
rr�rstrip�sep��.0�xrrr�
<listcomp>�sz!site_data_dir.<locals>.<listcomp>csg|]}tj�|�g��qSr�r
rrr �rrrr#�sr)
rr
rrrrrr�pathsep�split�rrr�	multipathrZpathlistrr%r�
site_data_dirds6�r*cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)a�Return full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user config directories are:
        Mac OS X:               same as user_data_dir
        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    �rrNZXDG_CONFIG_HOMEz	~/.config�rrr
rrrr�rrrrrrrr�user_config_dir�sr.cs�tdkr*t�|�}�r�|r�tj�||�}ndt�dd�}dd�|�tj�D�}�rt|rbtj��|���fdd�|D�}|r�tj�|�}n|d}|S)aReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of config dirs should be
            returned. By default, the first item from XDG_CONFIG_DIRS is
            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set

    Typical site config directories are:
        Mac OS X:   same as site_data_dir
        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
                    $XDG_CONFIG_DIRS
        Win *:      same as site_data_dir
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)

    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    r+ZXDG_CONFIG_DIRSz/etc/xdgcSs g|]}tj�|�tj���qSrrr rrrr#�sz#site_config_dir.<locals>.<listcomp>csg|]}tj�|�g��qSrr$r r%rrr#�sr)rr*r
rrrr'r&r(rr%r�site_config_dir�s
r/TcCs�tdkrd|dkr|}tj�td��}|r�|dk	rBtj�|||�}ntj�||�}|r�tj�|d�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aReturn full path to the user-specific cache dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Cache" to the base app data dir for Windows. See
            discussion below.

    Typical user cache directories are:
        Mac OS X:   ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go in
    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
    app data dir (the default returned by `user_data_dir` above). Apps typically
    put cache data somewhere *under* the given dir here. Some examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0
    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    This can be disabled with the `opinion=False` option.
    rNr
FZCacherz~/Library/CachesZXDG_CACHE_HOMEz~/.cacher�rrrZopinionrrrr�user_cache_dirs(!r1cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)aReturn full path to the user-specific state dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user state directories are:
        Mac OS X:  same as user_data_dir
        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
        Win *:     same as user_data_dir

    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
    to extend the XDG spec and support $XDG_STATE_HOME.

    That means, by default "~/.local/state/<AppName>".
    r+NZXDG_STATE_HOMEz~/.local/stater,r-rrr�user_state_dir:sr2cCs�tdkr tj�tj�d�|�}nNtdkrLt|||�}d}|rntj�|d�}n"t|||�}d}|rntj�|d�}|r�|r�tj�||�}|S)a�Return full path to the user-specific log dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Logs" to the base app data dir for Windows, and "log" to the
            base cache dir for Unix. See discussion below.

    Typical user log directories are:
        Mac OS X:   ~/Library/Logs/<AppName>
        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs

    On Windows the only suggestion in the MSDN docs is that local settings
    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
    examples of what some windows apps use for a logs dir.)

    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
    value for Windows and appends "log" to the user cache dir for Unix.
    This can be disabled with the `opinion=False` option.
    rz~/Library/LogsrFZLogs�log)rr
rrrrr1r0rrr�user_log_dirds" 
�r4c@sneZdZdZddd�Zedd��Zedd	��Zed
d��Zedd
��Z	edd��Z
edd��Zedd��ZdS)�AppDirsz1Convenience wrapper for getting application dirs.NFcCs"||_||_||_||_||_dS)N)rrrrr))�selfrrrrr)rrr�__init__�s
zAppDirs.__init__cCst|j|j|j|jd�S�N)rr)rrrrr�r6rrrr�s
�zAppDirs.user_data_dircCst|j|j|j|jd�S�N)rr))r*rrrr)r9rrrr*�s
�zAppDirs.site_data_dircCst|j|j|j|jd�Sr8)r.rrrrr9rrrr.�s
�zAppDirs.user_config_dircCst|j|j|j|jd�Sr:)r/rrrr)r9rrrr/�s
�zAppDirs.site_config_dircCst|j|j|jd�S�N�r)r1rrrr9rrrr1�s
�zAppDirs.user_cache_dircCst|j|j|jd�Sr;)r2rrrr9rrrr2�s
�zAppDirs.user_state_dircCst|j|j|jd�Sr;)r4rrrr9rrrr4�s
�zAppDirs.user_log_dir)NNNFF)
�__name__�
__module__�__qualname__�__doc__r7�propertyrr*r.r/r1r2r4rrrrr5�s&�






r5cCsHtrddl}nddl}dddd�|}|�|jd�}|�||�\}}|S)z�This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    rNZAppDatazCommon AppDataz
Local AppData�r	rr
z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)�PY3�winreg�_winreg�OpenKey�HKEY_CURRENT_USERZQueryValueEx)�
csidl_namerEZshell_folder_name�key�dir�typerrr�_get_win_folder_from_registry�s
���rLcCs�ddlm}m}|�dt||�dd�}z^t|�}d}|D]}t|�dkr8d}qRq8|r�zddl}|�|�}Wnt	k
r�YnXWnt
k
r�YnX|S)Nr)�shellcon�shellF�T)Zwin32com.shellrMrN�SHGetFolderPath�getattr�unicode�ord�win32api�GetShortPathName�ImportError�UnicodeError)rHrMrNrJ�
has_high_char�crTrrr�_get_win_folder_with_pywin32�s$
rZcCs�ddl}dddd�|}|�d�}|jj�d|dd|�d}|D]}t|�dkr@d	}qZq@|r�|�d�}|jj�|j|d�r�|}|jS)
Nr��#�rBiFrOT)	�ctypesZcreate_unicode_buffer�windllZshell32ZSHGetFolderPathWrSZkernel32ZGetShortPathNameW�value)rHr^Zcsidl_const�bufrXrYZbuf2rrr�_get_win_folder_with_ctypes�s&��

rbcCs�ddl}ddlm}ddlm}|jjd}|�d|�}|jj	}|�
dt|j|�d|jj
|�|j�|����d�}d}|D]}	t|	�dkr|d	}q�q||r�|�d|�}|jj	}
|
�|||�r�|j�|����d�}|S)
Nr)�jna)r�rY�FrOT)�arrayZcom.sunrcZcom.sun.jna.platformrZWinDefZMAX_PATHZzerosZShell32ZINSTANCErPrQZShlObjZSHGFP_TYPE_CURRENTZNativeZtoStringZtostringrrSZKernel32rU)rHrfrcrZbuf_sizerarNrJrXrYZkernelrrr�_get_win_folder_with_jnas&rg)r_�__main__ZMyAppZ	MyCompany)rr.r1r2r4r*r/z-- app dirs %s --z%-- app dirs (with optional 'version')z1.0r<z%s: %sz)
-- app dirs (without optional 'version')z+
-- app dirs (without optional 'appauthor')z(
-- app dirs (with disabled 'appauthor'))r)NNNF)NNNF)NNNF)NNNF)NNNT)NNNF)NNNT)+r@Z__version_info__r�map�str�__version__�sysr
�version_inforCrR�platform�
startswithZjava_verZos_namerrr*r.r/r1r2r4�objectr5rLrZrbrgr^r_rrVZcom.sun.jnaZcomr=rrZprops�print�dirsZproprQrrrr�<module>sv



7
B
(
3
9
*
30


site-packages/pip/_vendor/__pycache__/six.cpython-38.opt-1.pyc000064400000063434151446177000020131 0ustar00U

��.e�~�C@s�dZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d3d4�e)d5d(d#d6d5�e)d7d(e
�rd8nd9d:�e)d;d(d<�e)d=d>d?d@�e)d d d�e)dAdAdB�e)dCdCdB�e)dDdDdB�e)d6d(d#d6d5�e)dEd"d#dFdE�e)dGd"d"dHdG�e&d#d(�e&dIdJ�e&dKdL�e&dMdNdO�e&dPdQdP�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdkdl�e&dmdndo�e&dpdpdq�e&drdrdq�e&dsdsdq�e&dtdtdu�e&dvdw�e&dxdy�e&dzd{�e&d|d}d|�e&d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g@Z.ejd�k�rfe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rje,�3e/d�e/j1��qj[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d@d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d�d�d΃e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dڡGd�d܄d�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q>[/e8e7_.e,�3e7e+d��d�d�Gd�d�d�e(�Z9e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�d	d�d�g#Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d
��d�d�G�d
�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�dd��d�gZ<e<D]Z/e0e;e/j1e/��q�[/e<e;_.e,�3e;e+�d��d�d�G�d�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d �d!�Z@�d"�d#�ZAe�	r��d$ZB�d%ZC�d&ZD�d'ZE�d(ZF�d)ZGn$�d*ZB�d+ZC�d,ZD�d-ZE�d.ZF�d/ZGzeHZIWn"eJk
�	r��d0�d1�ZIYnXeIZHzeKZKWn"eJk
�
r�d2�d3�ZKYnXe�
rF�d4�d5�ZLejMZN�d6�d7�ZOeZPn>�d8�d5�ZL�d9�d:�ZN�d;�d7�ZOG�d<�d=��d=e�ZPeKZKe#eL�d>�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�r(�d?�d@�ZX�dA�dB�ZY�dC�dD�ZZ�dE�dF�Z[e�\�dG�Z]e�\�dH�Z^e�\�dI�Z_nT�dJ�d@�ZX�dK�dB�ZY�dL�dD�ZZ�dM�dF�Z[e�\�dN�Z]e�\�dO�Z^e�\�dP�Z_e#eX�dQ�e#eY�dR�e#eZ�dS�e#e[�dT�e�rD�dU�dV�Z`�dW�dX�ZaebZcddldZded�e�dY�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp�dZZqej
�d[�d[k�r6�d\Zr�d]Zsn�d^Zr�d_Zsnj�d`�dV�Z`�da�dX�ZaecZcebZg�db�dc�Zi�dd�de�Zke�tejuev�ZmddloZoeojoZoZp�dfZq�d\Zr�d]Zse#e`�dg�e#ea�dh��di�dZ�Zw�dj�d^�Zx�dk�d_�Zye�
reze4j{�dl�Z|�d��dm�dn�Z}n�d��do�dp�Z|e|�dq�ej
dd��drk�
rLe|�ds�n.ej
dd��drk�
rne|�dt�n�du�dv�Z~eze4j{�dwd�Zedk�
r��dx�dy�Zej
dd��dzk�
r�eZ��d{�dy�Ze#e}�d|�ej
dd�dk�
r�ej�ej�f�d}�d~�Z�nej�Z��d�d��Z��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��Z�gZ�e+Z�e�����d��dk	�rzge�_�ej��r�e�ej��D]4\Z�Z�ee��j+dk�r�e�j1e+k�r�ej�e�=�qq�[�[�ej���e,�dS(�z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.12.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�3/usr/lib/python3.8/site-packages/pip/_vendor/six.py�__len__>sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Xsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__[sz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrriszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrrszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__us
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'gs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr~sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__�sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4|sr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdbZ	getoutputZcommands�
subprocess�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_basezemail.MIMEBasezemail.mime.baseZemail_mime_imagezemail.MIMEImagezemail.mime.imageZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrruBsruZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZunquote_to_bytesZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
splitvalueZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrvrrrrrxlsrxZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrvrrrrrz�srzZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassZparse_http_listZparse_keqv_listz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrvrrrrr|�sr|Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrvrrrrr~�sr~ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacerwryr{r}rcCsdddddgS)N�parse�error�request�responserqrr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rqr8rrrrr��s




r�zmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_move�sr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rt�__dict__rFrrrr�remove_move�sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iteratorsr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callablesr�cCs|Srr�Zunboundrrr�get_unbound_functionsr�cCs|Srr�r�clsrrr�create_unbound_method#sr�cCs|jSr)r�r�rrrr�(scCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_method+sr�cCst�|d|�Sr)r�r�r�rrrr�.sc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�3sz
Iterator.nextN)r
rrr�rrrrr�1sr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeysDsr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesGsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsJsr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistsMsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�VscKs|jf|�Sr)r�r�rrrr�YscKs|jf|�Sr)r�r�rrrr�\scKs|jf|�Sr)r�r�rrrr�_s�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�bqsr�cCs|Srrr�rrr�utsr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs:z*|dkr|�}|j|k	r$|�|��|�W5d}d}XdSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s

r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�zedef reraise(tp, value, tb=None):
    try:
        raise tp, value, tb
    finally:
        tb = None
)rrz�def raise_from(value, from_value):
    try:
        if from_value is None:
            raise value
        raise value from from_value
    finally:
        value = None
zrdef raise_from(value, from_value):
    try:
        raise value from from_value
    finally:
        value = None
cCs|�dSrr)r1Z
from_valuerrr�
raise_from�sr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr��s

��zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_�sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�s

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rd�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapper*szwraps.<locals>.wrapperr)r�r�r�r�rr�rr�(sr�cs&G��fdd�dt�}t�|ddi�S)z%Create a base class with a metaclass.cs,eZdZ��fdd�Ze��fdd��ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�r�
this_basesr���bases�metarr�__new__:sz)with_metaclass.<locals>.metaclass.__new__cs��|��Sr)�__prepare__)r�rr�r�rrr�=sz-with_metaclass.<locals>.metaclass.__prepare__N)r
rrr��classmethodr�rr�rr�	metaclass8sr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclass3sr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.cs||j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd�t|d�rl|j|d<�|j|j	|�S)N�	__slots__r��__weakref__r)
r��copyr�rIr�r�rMrr
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr�Es




zadd_metaclass.<locals>.wrapperr)r�r�rrr�
add_metaclassCs
r�utf-8r�cCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce **s** to six.binary_type.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> encoded to `bytes`
      - `bytes` -> `bytes`
    �not expecting type '%s'N)rI�	text_typer��binary_typer�r��r�r�r�rrr�
ensure_binaryUs


r	cCsXt|ttf�stdt|���tr:t|t�r:|�||�}ntrTt|t�rT|�||�}|S)z�Coerce *s* to `str`.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    r)	rIrrr�r��PY2r�r)�decoderrrr�
ensure_strhsrcCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce *s* to six.text_type.

    For Python 2:
      - `unicode` -> `unicode`
      - `str` -> `unicode`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    rN)rIrrrr�r�rrrr�ensure_text|s


r
cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nr)�__unicode__r�r	rrr�<lambda>��z-python_2_unicode_compatible.<locals>.<lambda>)r
r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible�s
�
r�__spec__)N)NN)rr�)rr�)rr�)�rZ
__future__rrdrU�operatorrr��
__author__�__version__�version_infor
r)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesr�bytesr�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArtruZ_urllib_parse_moved_attributesrxZ_urllib_error_moved_attributesrzZ _urllib_request_moved_attributesr|Z!_urllib_response_moved_attributesr~Z$_urllib_robotparser_moved_attributesr�r�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�rr	rr
rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>s


>































��


�


�F�























��


��
























�%�����
��





��



5��
site-packages/pip/_vendor/__pycache__/retrying.cpython-38.opt-1.pyc000064400000017506151446177000021170 0ustar00U

��.e�&�@slddlZddlmZddlZddlZddlZdZdd�ZGdd�de�Z	Gdd	�d	e�Z
Gd
d�de�ZdS)�N)�sixi���?csBt��dkr,t�d�r,dd�}|�d�S��fdd�}|SdS)z�
    Decorator function that instantiates the Retrying object
    @param *dargs: positional arguments passed to Retrying object
    @param **dkw: keyword arguments passed to the Retrying object
    �rcst����fdd��}|S)Ncst�j�f|�|�S�N��Retrying�call��args�kw��f��8/usr/lib/python3.8/site-packages/pip/_vendor/retrying.py�	wrapped_f$sz-retry.<locals>.wrap_simple.<locals>.wrapped_f�r�wraps�rrr
rr�wrap_simple"szretry.<locals>.wrap_simplecst������fdd��}|S)Ncst���j�f|�|�Srrr)�dargs�dkwrr
rr/sz&retry.<locals>.wrap.<locals>.wrapped_frr�rrrr�wrap-szretry.<locals>.wrapN)�len�callable)rrrrr
rr�retrys
rc@sneZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�ZdS)rNFcs|dkrdn||_|dkrdn||_|dkr0dn||_|dkrBdn||_|dkrTdn||_|dkrfdn||_|	dkrxdn|	|_|
dkr�dn|
|_|dkr�tn||_	|dkr�dn||_
g�|dk	r̈�|j�|dk	r��|j
�|dk	r�||_n&|dk�r
�fdd�|_nt||�|_dd�g�|dk	�r6��|j�|dk	�sJ|dk	�rV��|j�|dk	�sj|	dk	�rv��|j�|
dk	�s�|dk	�r���|j�|dk	�r�||_n&|dk�r‡fd	d�|_nt||�|_|dk�r�|j|_n||_|
dk�r�|j|_n|
|_||_dS)
N��d��rrcst��fdd��D��S)Nc3s|]}|���VqdSrr
��.0r�ZattemptsZdelayr
r�	<genexpr>as�6Retrying.__init__.<locals>.<lambda>.<locals>.<genexpr>)�anyr )�
stop_funcsr r�<lambda>a�z#Retrying.__init__.<locals>.<lambda>c_sdS)Nrr
)r	�kwargsr
r
rr%hr&cst��fdd��D��S)Nc3s|]}|���VqdSrr
rr r
rr!ysr")�maxr )�
wait_funcsr rr%yr&)�_stop_max_attempt_number�_stop_max_delay�_wait_fixed�_wait_random_min�_wait_random_max�_wait_incrementing_start�_wait_incrementing_increment�_wait_exponential_multiplier�MAX_WAIT�_wait_exponential_max�_wait_jitter_max�append�stop_after_attempt�stop_after_delay�stop�getattr�fixed_sleep�random_sleep�incrementing_sleep�exponential_sleep�wait�
always_reject�_retry_on_exception�never_reject�_retry_on_result�_wrap_exception)�selfr8r>Zstop_max_attempt_numberZstop_max_delayZ
wait_fixedZwait_random_minZwait_random_maxZwait_incrementing_startZwait_incrementing_incrementZwait_exponential_multiplierZwait_exponential_maxZretry_on_exceptionZretry_on_result�wrap_exceptionZ	stop_funcZ	wait_funcZwait_jitter_maxr
)r$r)r�__init__:sR








zRetrying.__init__cCs
||jkS)z;Stop after the previous attempt >= stop_max_attempt_number.)r*�rD�previous_attempt_number�delay_since_first_attempt_msr
r
rr6�szRetrying.stop_after_attemptcCs
||jkS)z=Stop after the time from the first attempt >= stop_max_delay.)r+rGr
r
rr7�szRetrying.stop_after_delaycCsdS)z#Don't sleep at all before retrying.rr
rGr
r
r�no_sleep�szRetrying.no_sleepcCs|jS)z0Sleep a fixed amount of time between each retry.)r,rGr
r
rr:�szRetrying.fixed_sleepcCst�|j|j�S)zISleep a random amount of time between wait_random_min and wait_random_max)�randomZrandintr-r.rGr
r
rr;�szRetrying.random_sleepcCs$|j|j|d}|dkr d}|S)z�
        Sleep an incremental amount of time after each attempt, starting at
        wait_incrementing_start and incrementing by wait_incrementing_increment
        rr)r/r0)rDrHrI�resultr
r
rr<�szRetrying.incrementing_sleepcCs2d|}|j|}||jkr"|j}|dkr.d}|S)N�r)r1r3)rDrHrIZexprLr
r
rr=�s

zRetrying.exponential_sleepcCsdS)NFr
�rDrLr
r
rrA�szRetrying.never_rejectcCsdS)NTr
rNr
r
rr?�szRetrying.always_rejectcCs4d}|jr ||�|jd�O}n||�|j�O}|S)NFr)�
has_exceptionr@�valuerB)rD�attemptZrejectr
r
r�
should_reject�s
zRetrying.should_rejectcOs�ttt��d��}d}zt|||�|d�}Wn t��}t||d�}YnX|�|�sf|�|j�Sttt��d��|}|�	||�r�|js�|j
r�|���q�t|��n<|�||�}	|j
r�t��|j
}
|	td|
�}	t�|	d�|d7}qdS)NrrFTrg@�@)�int�round�time�Attempt�sys�exc_inforR�getrCr8rO�
RetryErrorr>r4rKr(�sleep)rD�fnr	r'Z
start_time�attempt_numberrQ�tbrIr[Zjitterr
r
rr�s(


z
Retrying.call)NNNNNNNNNNNNNFNNN)�__name__�
__module__�__qualname__rFr6r7rJr:r;r<r=rAr?rRrr
r
r
rr8s:�
S
		rc@s*eZdZdZdd�Zd
dd�Zdd�Zd	S)rVz�
    An Attempt encapsulates a call to a target function that may end as a
    normal return value from the function or an Exception depending on what
    occurred during the execution.
    cCs||_||_||_dSr)rPr]rO)rDrPr]rOr
r
rrF�szAttempt.__init__FcCs@|jr6|rt|��q<t�|jd|jd|jd�n|jSdS)z�
        Return the return value of this Attempt instance or raise an Exception.
        If wrap_exception is true, this Attempt is wrapped inside of a
        RetryError before being raised.
        rrrMN)rOrZrZreraiserP)rDrEr
r
rrY�s

"zAttempt.getc	Cs:|jr&d�|jd�t�|jd���Sd�|j|j�SdS)NzAttempts: {0}, Error:
{1}�rMzAttempts: {0}, Value: {1})rO�formatr]�join�	traceback�	format_tbrP�rDr
r
r�__repr__�s zAttempt.__repr__N)F)r_r`ra�__doc__rFrYrhr
r
r
rrV�s
rVc@s eZdZdZdd�Zdd�ZdS)rZzU
    A RetryError encapsulates the last Attempt instance right before giving up.
    cCs
||_dSr)�last_attempt)rDrjr
r
rrFszRetryError.__init__cCsd�|j�S)NzRetryError[{0}])rcrjrgr
r
r�__str__
szRetryError.__str__N)r_r`rarirFrkr
r
r
rrZsrZ)
rKZpip._vendorrrWrUrer2r�objectrrV�	ExceptionrZr
r
r
r�<module>s*!site-packages/pip/_vendor/__pycache__/pyparsing.cpython-38.pyc000064400000705501151446177000020401 0ustar00U

��.e,�s@s�dZdZdZdZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZddlmZddlZdd	lmZzdd
lmZWn ek
r�ddlmZYnXzddlmZWn ek
r�ddlmZYnXz dd
lmZddlmZm Z Wn2ek
�rNdd
l
mZddl
mZm Z YnXzddl
m!Z"WnBek
�r�zddl#m!Z"Wnek
�r�dZ"YnXYnXzddlm$Z$Wn$ek
�r�Gdd�d�Z$YnXe$�Z%de%_de%_&e$�Z'de'_de'_(de'_)de'_*de'_+de'_,dddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{d|d}d~dd�d�d�d�d�d�d�d�d�d�gsZ-e.e	j/�dd��Z0e0dd�kZ1e1�rVe	j2Z3e4Z5e6Z7e4Z8e4Z9e:e;e<e=e>e.e?e@eAeBeCgZDn`e	jEZ3eFZGd�d��Z9gZDddlHZHd��I�D]8ZJzeD�KeLeHeJ��WneMk
�r�Y�q|YnX�q|eNd�d��eGd��D��ZOd�d��ZPejQejRZSd�ZTeTd�ZUeSeTZVe6d��ZWd��Xd�d��ejYD��ZZ�dYd�d��Z[Gd�d4�d4e\�Z]Gd�d6�d6e]�Z^Gd�d8�d8e]�Z_Gd�d:�d:e_�Z`Gd�d=�d=e\�ZaGd�d��d�eb�ZcGd�d9�d9eb�Zde�eed�d�dQ�Zfd�db�Zgd�d_�Zhd�d��Zid�d��Zjd�d��Zkd�di�Zl�dZd�d��ZmGd�d;�d;eb�ZnGd�d��d�en�ZoGd�dC�dCen�ZpGd�d#�d#ep�ZqGd�d.�d.ep�ZrGd�d+�d+ep�ZsGd�d��d�es�ZtesZuesen_vGd�d(�d(ep�ZwGd�d�des�ZxGd�d�dew�ZyGd�d��d�ep�ZzGd�dF�dFep�Z{Gd�d��d�e{�Z|Gd�dJ�dJe|�Z}Gd�d>�d>ep�Z~Gd�d<�d<ep�ZGd�d�dep�Z�Gd�dE�dEep�Z�Gd�dĄd�ep�Z�Gd�d&�d&e��Z�Gd�d*�d*e��Z�Gd�d)�d)e��Z�Gd�dA�dAe��Z�Gd�d@�d@e��Z�Gd�dH�dHe��Z�Gd�dG�dGe��Z�Gd�d7�d7en�Z�Gd�d�de��Z�Gd�d3�d3e��Z�Gd�d-�d-e��Z�Gd�d"�d"e��Z�Gd�d5�d5en�Z�Gd�d$�d$e��Z�Gd�d,�d,e��Z�Gd�d/�d/e��Z�Gd�dքd�e��Z�Gd�d0�d0e��Z�Gd�dI�dIe��Z�Gd�dڄd�eb�Z�Gd�d2�d2e��Z�Gd�d?�d?e��Z�Gd�d%�d%e��Z�Gd�dD�dDe��Z�Gd�d �d e��Z�Gd�d'�d'e��Z�Gd�d!�d!e��Z�Gd�dB�dBe��Z�Gd�d1�d1eb�Z�d�dz�Z��d[d�dX�Z��d\d�dT�Z�d�d�Z�d�dg�Z�d�df�Z�d�d�Z��d]d�dk�Z�d�dY�Z��d^d�d�Z�d�d��Z�d�d��Z�eq���d[�Z�e����da�Z�e����d`�Z�e����dy�Z�e����dx�Z�e{eWd�d�d���d�d���Z�e~d����d�d���Z�e~d����d�d���Z�e�e�Be�Be�d�d�d�BZ�e�e�e�d��e��Z�esd��e�d����d��e�e�e�e�B�����d��dZ��ddw�Z��dde�Z��ddt�Z��ddr�Z��dd��Z�e��dd���Z�e��dd���Z�e��d	�e��d
�f�d�d�Z��d
dc�Zddd�ZÐdd}�Z�eb�e�_Őd_�dd��Z�e$�Z�eb�e�_�eb�e�_�e��d�e��d�f�dd��Z�e�Z�e�e~�d��d����d�Z�e�e~�d��d����d�Z�e�e~�d��de~�d��dB����d�Z�e�eu�d�eΠ�����d�Zϐd�ddeΠ�f�ddh�ZАd`�dd~�Z�e��d�Z�e��d �Z�e�e{eSeV�d!����d"��\Z�Z�e�eאd#�I��d$��Z�e~�d%�d&�Xeؠ١��d'����d(�Zڐd)ds�Z�e�e~�d*��d+����d,�Z�e~�d-����d.�Z�e~�d/��ޡ���d0�Z�e~�d1����d2�Z�e�e~�d*��d+e�B����d3�Z�e�Z�e~�d4����d5�Z�e�e�e{eZd�d6�e�e{�d7�esd�e����������d8�Z�e�e�eΠ�e�Bd��d9����dR�Z�G�d:d��d��Z�G�d;�d<��d<eb�Z�G�d=d��d�eb�Z�G�d>d��d�e�Z�e�j�j�j�e�j�j�j�e�j�j�j�e�j�_�e1�
rXe�e�d?e�j�e�e�d@e�j�e�e�dAe�j�e�e�dBe�j�e�e�dCe�j��e�e�dDe�j�e�e�j�dEe�j�j�e�e�j�dFe�j�j�e�e�j�dGe�j�j�e�e�dHe�j��e�e�dIe�j��e�e�dJe�j��e��dKk�r�ex�dL�Z�ex�dM�Z�e{eSeV�dN�Z�e�e��dOd�dP���e��Z�e�e�e������dQ�Z��dRe�BZ�e�e��dOd�dP���e���Ze�e��e�����dS��Ze��dT�e��dQ�e��e�dS��Z�e���dU�e�j���dV�e�j���dV�e�j���dW�dd�l�Ze�j��e��e�j��e�j���dX�dS(aa�

pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and
executing simple grammars, vs. the traditional lex/yacc approach, or the
use of regular expressions.  With pyparsing, you don't need to learn
a new syntax for defining grammars or matching expressions - the parsing
module provides a library of classes that you use to construct the
grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form
``"<salutation>, <addressee>!"``), built up using :class:`Word`,
:class:`Literal`, and :class:`And` elements
(the :class:`'+'<ParserElement.__add__>` operators create :class:`And` expressions,
and the strings are auto-converted to :class:`Literal` expressions)::

    from pip._vendor.pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the
self-explanatory class names, and the use of '+', '|' and '^' operators.

The :class:`ParseResults` object returned from
:class:`ParserElement.parseString` can be
accessed as a nested list, a dictionary, or an object with named
attributes.

The pyparsing module handles some of the problems that are typically
vexing when writing text parsers:

  - extra or missing whitespace (the above program will also handle
    "Hello,World!", "Hello  ,  World  !", etc.)
  - quoted strings
  - embedded comments


Getting Started -
-----------------
Visit the classes :class:`ParserElement` and :class:`ParseResults` to
see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:

 - construct literal match expressions from :class:`Literal` and
   :class:`CaselessLiteral` classes
 - construct character word-group expressions using the :class:`Word`
   class
 - see how to create repetitive expressions using :class:`ZeroOrMore`
   and :class:`OneOrMore` classes
 - use :class:`'+'<And>`, :class:`'|'<MatchFirst>`, :class:`'^'<Or>`,
   and :class:`'&'<Each>` operators to combine simple expressions into
   more complex ones
 - associate names with your parsed results using
   :class:`ParserElement.setResultsName`
 - access the parsed data, which is returned as a :class:`ParseResults`
   object
 - find some helpful expression short-cuts like :class:`delimitedList`
   and :class:`oneOf`
 - find more useful common expressions in the :class:`pyparsing_common`
   namespace class
z2.4.2z29 Jul 2019 02:58 UTCz*Paul McGuire <ptmcg@users.sourceforge.net>�N)�ref)�datetime)�
itemgetter)�wraps)�filterfalse)�ifilterfalse)�RLock)�Iterable)�MutableMapping�Mapping)�OrderedDict)�SimpleNamespacec@seZdZdS)r
N)�__name__�
__module__�__qualname__�rr�9/usr/lib/python3.8/site-packages/pip/_vendor/pyparsing.pyr
�sr
aA
    A cross-version compatibility configuration for pyparsing features that will be
    released in a future version. By setting values in this configuration to True,
    those features can be enabled in prior versions for compatibility development
    and testing.

     - collect_all_And_tokens - flag to enable fix for Issue #63 that fixes erroneous grouping
       of results names when an And expression is nested within an Or or MatchFirst; set to
       True to enable bugfix released in pyparsing 2.3.0, or False to preserve
       pre-2.3.0 handling of named results
Ta�
Diagnostic configuration (all default to False)
     - warn_multiple_tokens_in_named_alternation - flag to enable warnings when a results
       name is defined on a MatchFirst or Or expression with one or more And subexpressions
       (only warns if __compat__.collect_all_And_tokens is False)
     - warn_ungrouped_named_tokens_in_collection - flag to enable warnings when a results
       name is defined on a containing expression with ungrouped subexpressions that also
       have results names
     - warn_name_set_on_empty_Forward - flag to enable warnings whan a Forward is defined
       with a results name, but has no contents defined
     - warn_on_multiple_string_args_to_oneof - flag to enable warnings whan oneOf is
       incorrectly called with multiple str arguments
     - enable_debug_on_named_expressions - flag to auto-enable debug on all subsequent
       calls to ParserElement.setName()
F�__version__�__versionTime__�
__author__�
__compat__�__diag__�And�CaselessKeyword�CaselessLiteral�
CharsNotIn�Combine�Dict�Each�Empty�
FollowedBy�Forward�
GoToColumn�Group�Keyword�LineEnd�	LineStart�Literal�
PrecededBy�
MatchFirst�NoMatch�NotAny�	OneOrMore�OnlyOnce�Optional�Or�ParseBaseException�ParseElementEnhance�ParseException�ParseExpression�ParseFatalException�ParseResults�ParseSyntaxException�
ParserElement�QuotedString�RecursiveGrammarException�Regex�SkipTo�	StringEnd�StringStart�Suppress�Token�TokenConverter�White�Word�WordEnd�	WordStart�
ZeroOrMore�Char�	alphanums�alphas�
alphas8bit�anyCloseTag�
anyOpenTag�
cStyleComment�col�commaSeparatedList�commonHTMLEntity�countedArray�cppStyleComment�dblQuotedString�dblSlashComment�
delimitedList�dictOf�downcaseTokens�empty�hexnums�htmlComment�javaStyleComment�line�lineEnd�	lineStart�lineno�makeHTMLTags�makeXMLTags�matchOnlyAtCol�matchPreviousExpr�matchPreviousLiteral�
nestedExpr�nullDebugAction�nums�oneOf�opAssoc�operatorPrecedence�
printables�punc8bit�pythonStyleComment�quotedString�removeQuotes�replaceHTMLEntity�replaceWith�
restOfLine�sglQuotedString�srange�	stringEnd�stringStart�traceParseAction�
unicodeString�upcaseTokens�
withAttribute�
indentedBlock�originalTextFor�ungroup�
infixNotation�locatedExpr�	withClass�
CloseMatch�tokenMap�pyparsing_common�pyparsing_unicode�unicode_set�conditionAsParseAction�cCsft|t�r|Sz
t|�WStk
r`t|��t��d�}td�}|�dd��|�	|�YSXdS)aDrop-in replacement for str(obj) that tries to be Unicode
        friendly. It first tries str(obj). If that fails with
        a UnicodeEncodeError, then it tries unicode(obj). It then
        < returns the unicode object | encodes it with the default
        encoding | ... >.
        �xmlcharrefreplacez&#\d+;cSs$dtt|ddd���dd�S)Nz\ur����)�hex�int��trrr�<lambda>��z_ustr.<locals>.<lambda>N)
�
isinstance�unicode�str�UnicodeEncodeError�encode�sys�getdefaultencodingr:�setParseAction�transformString)�obj�retZ
xmlcharrefrrr�_ustr�s

r�z6sum len sorted reversed list tuple set any all min maxccs|]
}|VqdS�Nr)�.0�yrrr�	<genexpr>sr��cCs:d}dd�d��D�}t||�D]\}}|�||�}q |S)z/Escape &, <, >, ", ', etc. in a string of data.z&><"'css|]}d|dVqdS)�&�;Nr)r��srrrr�sz_xml_escape.<locals>.<genexpr>zamp gt lt quot apos)�split�zip�replace)�dataZfrom_symbolsZ
to_symbolsZfrom_Zto_rrr�_xml_escapes
r��
0123456789ZABCDEFabcdef�\�ccs|]}|tjkr|VqdSr�)�stringZ
whitespace�r��crrrr�s
cs@|dk	r|nd�|rtnt�t���t�����fdd��}|S)Nzfailed user-defined conditioncs t�|||��s�||���dSr�)�bool�r��lr���exc_type�fn�msgrr�pasz"conditionAsParseAction.<locals>.pa)r4r2�_trim_arityr)r��message�fatalr�rr�rr�sc@sPeZdZdZddd�Zedd��Zdd	�Zd
d�Zdd
�Z	ddd�Z
dd�ZdS)r0z7base exception class for all parsing runtime exceptionsrNcCs>||_|dkr||_d|_n||_||_||_|||f|_dS�Nr�)�locr��pstr�
parserElement�args)�selfr�r�r��elemrrr�__init__(szParseBaseException.__init__cCs||j|j|j|j�S)z�
        internal factory method to simplify creating one type of ParseException
        from another - avoids having __init__ signature conflicts among subclasses
        )r�r�r�r�)�cls�perrr�_from_exception3sz"ParseBaseException._from_exceptioncCsN|dkrt|j|j�S|dkr,t|j|j�S|dkrBt|j|j�St|��dS)z�supported attributes by name are:
           - lineno - returns the line number of the exception text
           - col - returns the column number of the exception text
           - line - returns the line containing the exception text
        r^)rM�columnr[N)r^r�r�rMr[�AttributeError)r�Zanamerrr�__getattr__;szParseBaseException.__getattr__cCs^|jr@|jt|j�krd}qDd|j|j|jd��dd�}nd}d|j||j|j|jfS)Nz, found end of textz
, found %rr�z\\�\r�z%%s%s  (at char %d), (line:%d, col:%d))r�r��lenr�r�r^r�)r�Zfoundstrrrr�__str__Js$�zParseBaseException.__str__cCst|�Sr��r��r�rrr�__repr__TszParseBaseException.__repr__�>!<cCs<|j}|jd}|r4d�|d|�|||d�f�}|��S)z�Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        r�r�N)r[r��join�strip)r�ZmarkerStringZline_strZline_columnrrr�
markInputlineVs

�z ParseBaseException.markInputlinecCsd��tt|��S)Nzlineno col line)r��dir�typer�rrr�__dir__`szParseBaseException.__dir__)rNN)r�)rrr�__doc__r��classmethodr�r�r�r�r�r�rrrrr0$s




c@seZdZdZeddd��ZdS)r2a:
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
    - lineno - returns the line number of the exception text
    - col - returns the column number of the exception text
    - line - returns the line containing the exception text

    Example::

        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))

    prints::

       Expected integer (at char 0), (line:1, col:1)
        column: 1

    �cCspddl}|dkrt��}g}t|t�rJ|�|j�|�d|jdd�|�d�t	|�j
|��|dk�rf|j|j|d�}t
�}t||d��D]�\}}|d}|j�dd�}	t|	t��r|jjd	kr�q�|	|kr�q�|�|	�t	|	�}
|�d
�|
j|
j
|	��nP|	dk	�r,t	|	�}
|�d�|
j|
j
��n&|j}|jdk�r@q�|�d
�|j��|d8}|s��qfq�d�|�S)ap
        Method to take an exception and translate the Python internal traceback into a list
        of the pyparsing expressions that caused the exception to be raised.

        Parameters:

         - exc - exception raised during parsing (need not be a ParseException, in support
           of Python exceptions that might be raised in a parse action)
         - depth (default=16) - number of levels back in the stack trace to list expression
           and function names; if None, the full stack trace names will be listed; if 0, only
           the failing input line, marker, and exception string will be shown

        Returns a multi-line string listing the ParserElements and/or function names in the
        exception's stack trace.

        Note: the diagnostic output will include string representations of the expressions
        that failed to parse. These representations will be more helpful if you use `setName` to
        give identifiable names to your expressions. Otherwise they will use the default string
        forms, which may be cryptic to read.

        explain() is only supported under Python 3.
        rN� r��^z{0}: {1})�contextr�)�	parseImpl�
_parseNoCachez
{0}.{1} - {2}z{0}.{1})�wrapperz<module>z{0}�
)�inspectr��getrecursionlimitr�r0�appendr[rM�formatr�rZgetinnerframes�
__traceback__�set�	enumerate�f_locals�getr7�f_code�co_name�addrr�)�exc�depthr�r�Zcallers�seen�iZffZfrmZf_selfZ	self_type�coderrr�explainzsL


�
�zParseException.explainN)r�)rrrr��staticmethodr�rrrrr2csc@seZdZdZdS)r4znuser-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediatelyN�rrrr�rrrrr4�sc@seZdZdZdS)r6z�just like :class:`ParseFatalException`, but thrown internally
    when an :class:`ErrorStop<And._ErrorStop>` ('-' operator) indicates
    that parsing is to stop immediately because an unbacktrackable
    syntax error has been found.
    Nr�rrrrr6�sc@s eZdZdZdd�Zdd�ZdS)r9ziexception thrown by :class:`ParserElement.validate` if the
    grammar could be improperly recursive
    cCs
||_dSr��ZparseElementTrace�r��parseElementListrrrr��sz"RecursiveGrammarException.__init__cCs
d|jS)NzRecursiveGrammarException: %sr�r�rrrr��sz!RecursiveGrammarException.__str__N)rrrr�r�r�rrrrr9�sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�_ParseResultsWithOffsetcCs||f|_dSr���tup)r�Zp1Zp2rrrr��sz _ParseResultsWithOffset.__init__cCs
|j|Sr�r��r�r�rrr�__getitem__�sz#_ParseResultsWithOffset.__getitem__cCst|jd�S�Nr)�reprr�r�rrrr��sz _ParseResultsWithOffset.__repr__cCs|jd|f|_dSr�r�r�rrr�	setOffset�sz!_ParseResultsWithOffset.setOffsetN)rrrr�r�r�r�rrrrr��sr�c@s�eZdZdZd]dd�Zddddefdd�Zdd	�Zefd
d�Zdd
�Z	dd�Z
dd�Zdd�ZeZ
dd�Zdd�Zdd�Zdd�Zdd�Zer�eZeZeZn$eZeZeZdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd^d(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Z d2d3�Z!d4d5�Z"d6d7�Z#d8d9�Z$d:d;�Z%d<d=�Z&d_d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*d`dHdI�Z+dJdK�Z,dLdM�Z-dadOdP�Z.dQdR�Z/dSdT�Z0dUdV�Z1dWdX�Z2dYdZ�Z3e4dbd[d\��Z5dS)cr5aSStructured parse results, to provide multiple means of access to
    the parsed data:

       - as a list (``len(results)``)
       - by list index (``results[0], results[1]``, etc.)
       - by attribute (``results.<resultsName>`` - see :class:`ParserElement.setResultsName`)

    Example::

        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/'
                        + integer.setResultsName("month") + '/'
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)

    prints::

        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    NTcCs"t||�r|St�|�}d|_|S�NT)r��object�__new__�_ParseResults__doinit)r��toklist�name�asList�modalZretobjrrrrs


zParseResults.__new__c
Csd|jrvd|_d|_d|_i|_||_||_|dkr6g}||t�rP|dd�|_n||t�rft|�|_n|g|_t	�|_
|dk	�r`|�r`|s�d|j|<||t�r�t|�}||_||t
d�ttf�r�|ddgfk�s`||t�r�|g}|�r*||t��rtt|j�d�||<ntt|d�d�||<|||_n6z|d||<Wn$tttfk
�r^|||<YnXdS)NFrr�)r�_ParseResults__name�_ParseResults__parent�_ParseResults__accumNames�_ParseResults__asList�_ParseResults__modal�list�_ParseResults__toklist�_generatorType�dict�_ParseResults__tokdictr�r�r��
basestringr5r��KeyError�	TypeError�
IndexError)r�rrrrr�rrrr�"sB



$
zParseResults.__init__cCsPt|ttf�r|j|S||jkr4|j|ddStdd�|j|D��SdS)Nr�rcSsg|]}|d�qS�rr�r��vrrr�
<listcomp>Psz,ParseResults.__getitem__.<locals>.<listcomp>)r�r��slicerrrr5r�rrrr�Is


zParseResults.__getitem__cCs�||t�r0|j�|t��|g|j|<|d}nD||ttf�rN||j|<|}n&|j�|t��t|d�g|j|<|}||t�r�t|�|_	dSr�)
r�rr�rr�rrr5�wkrefr)r��krr��subrrr�__setitem__Rs


"
zParseResults.__setitem__c
Cs�t|ttf�r�t|j�}|j|=t|t�rH|dkr:||7}t||d�}tt|�|���}|��|j	�
�D]>\}}|D]0}t|�D]"\}\}}	t||	|	|k�||<q�qxqln|j	|=dS�Nrr�)
r�r�rr�rr�range�indices�reverser�itemsr�r�)
r�r�ZmylenZremovedr�occurrences�jr�value�positionrrr�__delitem___s

zParseResults.__delitem__cCs
||jkSr�)r)r�rrrr�__contains__tszParseResults.__contains__cCs
t|j�Sr�)r�rr�rrr�__len__wszParseResults.__len__cCs
|jSr��rr�rrr�__bool__zszParseResults.__bool__cCs
t|j�Sr���iterrr�rrr�__iter__~szParseResults.__iter__cCst|jddd��S�Nr�r+r�rrr�__reversed__�szParseResults.__reversed__cCs$t|jd�r|j��St|j�SdS)N�iterkeys)�hasattrrr0r,r�rrr�	_iterkeys�s
zParseResults._iterkeyscs�fdd����D�S)Nc3s|]}�|VqdSr�r�r�rr�rrr��sz+ParseResults._itervalues.<locals>.<genexpr>�r2r�rr�r�_itervalues�szParseResults._itervaluescs�fdd����D�S)Nc3s|]}|�|fVqdSr�rr3r�rrr��sz*ParseResults._iteritems.<locals>.<genexpr>r4r�rr�r�
_iteritems�szParseResults._iteritemscCst|���S)zVReturns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x).)rr0r�rrr�keys�szParseResults.keyscCst|���S)zXReturns all named result values (as a list in Python 2.x, as an iterator in Python 3.x).)r�
itervaluesr�rrr�values�szParseResults.valuescCst|���S)zfReturns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x).)r�	iteritemsr�rrrr!�szParseResults.itemscCs
t|j�S)z�Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names.)r�rr�rrr�haskeys�szParseResults.haskeyscOs�|s
dg}|��D]*\}}|dkr0|d|f}qtd|��qt|dt�sdt|�dksd|d|kr~|d}||}||=|S|d}|SdS)a�
        Removes and returns item at specified index (default= ``last``).
        Supports both ``list`` and ``dict`` semantics for ``pop()``. If
        passed no argument or an integer argument, it will use ``list``
        semantics and pop tokens from the list of parsed tokens. If passed
        a non-integer argument (most likely a string), it will use ``dict``
        semantics and pop the corresponding value from any defined results
        names. A second default return value argument is supported, just as in
        ``dict.pop()``.

        Example::

            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())

        prints::

            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        r��defaultrz-pop() got an unexpected keyword argument '%s'r�N)r!rr�r�r�)r�r��kwargsrr�indexr�Zdefaultvaluerrr�pop�s"%
�
�zParseResults.popcCs||kr||S|SdS)a[
        Returns named result matching the given key, or if there is no
        such name, then returns the given ``defaultValue`` or ``None`` if no
        ``defaultValue`` is specified.

        Similar to ``dict.get()``.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        Nr)r��key�defaultValuerrrr��szParseResults.getcCsR|j�||�|j��D]4\}}t|�D]"\}\}}t||||k�||<q(qdS)a
        Inserts new element at location index in the list of parsed tokens.

        Similar to ``list.insert()``.

        Example::

            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        N)r�insertrr!r�r�)r�r>ZinsStrrr"rr$r%rrrrBszParseResults.insertcCs|j�|�dS)a�
        Add single element to end of ParseResults list of elements.

        Example::

            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        N)rr�)r��itemrrrr�s
zParseResults.appendcCs&t|t�r|�|�n|j�|�dS)a	
        Add sequence of elements to end of ParseResults list of elements.

        Example::

            patt = OneOrMore(Word(alphas))

            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        N)r�r5�__iadd__r�extend)r�ZitemseqrrrrE's
zParseResults.extendcCs|jdd�=|j��dS)z7
        Clear all elements and results names.
        N)rr�clearr�rrrrF:szParseResults.clearcCs&z
||WStk
r YdSXdSr�)r�r�rrrrr�As
zParseResults.__getattr__cCs|��}||7}|Sr���copy)r��otherr�rrr�__add__GszParseResults.__add__cs�|jrjt|j���fdd��|j��}�fdd�|D�}|D],\}}|||<t|dt�r<t|�|d_q<|j|j7_|j�	|j�|S)Ncs|dkr�S|�Sr�r)�a)�offsetrrr�Or�z'ParseResults.__iadd__.<locals>.<lambda>c	s4g|],\}}|D]}|t|d�|d��f�qqS�rr�)r��r�r�vlistr)�	addoffsetrrrQs�z)ParseResults.__iadd__.<locals>.<listcomp>r)
rr�rr!r�r5rrr�update)r�rJZ
otheritemsZotherdictitemsrrr)rQrMrrDLs


�zParseResults.__iadd__cCs&t|t�r|dkr|��S||SdSr�)r�r�rI�r�rJrrr�__radd__\szParseResults.__radd__cCsdt|j�t|j�fS)Nz(%s, %s))r�rrr�rrrr�dszParseResults.__repr__cCsdd�dd�|jD��dS)N�[�, css(|] }t|t�rt|�nt|�VqdSr�)r�r5r�r��r�r�rrrr�hsz'ParseResults.__str__.<locals>.<genexpr>�])r�rr�rrrr�gszParseResults.__str__r�cCsLg}|jD]<}|r |r |�|�t|t�r8||��7}q
|�t|��q
|Sr�)rr�r�r5�
_asStringListr�)r��sep�outrCrrrrYjs


zParseResults._asStringListcCsdd�|jD�S)ax
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::

            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']

            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        cSs"g|]}t|t�r|��n|�qSr)r�r5r)r��resrrrr�sz'ParseResults.asList.<locals>.<listcomp>r)r�rrrruszParseResults.asListcs6tr|j}n|j}�fdd��t�fdd�|�D��S)a�
        Returns the named parse results as a nested dictionary.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})

            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        cs6t|t�r.|��r|��S�fdd�|D�Sn|SdS)Ncsg|]}�|��qSrrr��toItemrrr�sz7ParseResults.asDict.<locals>.toItem.<locals>.<listcomp>)r�r5r;�asDict�r�r]rrr^�s

z#ParseResults.asDict.<locals>.toItemc3s|]\}}|�|�fVqdSr�r�r�rrr]rrr��sz&ParseResults.asDict.<locals>.<genexpr>)�PY_3r!r:r)r�Zitem_fnrr]rr_�s
	zParseResults.asDictcCs<t|j�}t|j���|_|j|_|j�|j�|j|_|S)zG
        Returns a new copy of a :class:`ParseResults` object.
        )	r5rrrr!rrrRr�r�r�rrrrI�s
zParseResults.copyFcCsLd}g}tdd�|j��D��}|d}|s8d}d}d}d}	|dk	rJ|}	n|jrV|j}	|	sf|rbdSd}	|||d|	d	g7}t|j�D]�\}
}t|t�r�|
|kr�||�||
|o�|dk||�g7}n||�d|o�|dk||�g7}q�d}|
|kr�||
}|�s|�rq�nd}t	t
|��}
|||d|d	|
d
|d	g	7}q�|||d
|	d	g7}d�|�S)z�
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        r�css(|] \}}|D]}|d|fVqqdS�r�NrrOrrrr��s�z%ParseResults.asXML.<locals>.<genexpr>�  r�NZITEM�<�>�</)rrr!rr�rr�r5�asXMLr�r�r�)r�ZdoctagZnamedItemsOnly�indentZ	formatted�nlr[Z
namedItemsZnextLevelIndentZselfTagr�r\ZresTagZxmlBodyTextrrrri�s^

�

�
�zParseResults.asXMLcCs:|j��D]*\}}|D]\}}||kr|Sqq
dSr�)rr!)r�rrrPrr�rrrZ__lookup�s
zParseResults.__lookupcCs�|jr|jS|jr.|��}|r(|�|�SdSnNt|�dkrxt|j�dkrxtt|j����dddkrxtt|j����SdSdS)a
        Returns the results name for this token expression. Useful when several
        different expressions might match at a particular location.

        Example::

            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number")
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)

            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])

        prints::

            age : 22
            ssn : 111-22-3333
            house_number : 221B
        Nr�r)rr�)	rr�_ParseResults__lookupr�r�nextr,r9r7)r��parrrr�getName�s
��zParseResults.getNamercCsvg}d}|r$|�|t|����n
|�d�|�rl|��r�tdd�|��D��}|D]x\}}	|rl|�|�|�d|d||f�t|	t�r�|	r�|�|	j||||dd��q�|�t|	��qV|�t	|	��qVn�t
d	d�|D���rl|}	t|	�D]x\}
}t|t��r@|�d
|d||
|d|d|j||||dd�f�q�|�d
|d||
|d|dt|�f�q�d�|�S)aF
        Diagnostic method for listing out the contents of
        a :class:`ParseResults`. Accepts an optional ``indent`` argument so
        that this string can be embedded in a nested display of other data.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString('12/31/1999')
            print(result.dump())

        prints::

            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        r�r�css|]\}}t|�|fVqdSr�)r�rarrrr�?sz$ParseResults.dump.<locals>.<genexpr>z
%s%s- %s: rer�)rj�full�include_list�_depthcss|]}t|t�VqdSr�)r�r5)r��vvrrrr�Ksz
%s%s[%d]:
%s%s%s)
r�r�rr;�sortedr!r�r5�dumpr��anyr�r�)r�rjrprqrrr[�NLr!rrr�rsrrrru!sP



��


�
zParseResults.dumpcOstj|��f|�|�dS)a#
        Pretty-printer for parsed results as a list, using the
        `pprint <https://docs.python.org/3/library/pprint.html>`_ module.
        Accepts additional positional or keyword args as defined for
        `pprint.pprint <https://docs.python.org/3/library/pprint.html#pprint.pprint>`_ .

        Example::

            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)

        prints::

            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        N)�pprintr�r�r�r=rrrrxbszParseResults.pprintcCs.|j|j��|jdk	r|��p d|j|jffSr�)rrrIrrrr�rrr�__getstate__~s��zParseResults.__getstate__cCsN|d|_|d\|_}}|_i|_|j�|�|dk	rDt|�|_nd|_dSr)rrrrrRrr)r��staternZinAccumNamesrrr�__setstate__�s
zParseResults.__setstate__cCs|j|j|j|jfSr�)rrr	r
r�rrr�__getnewargs__�szParseResults.__getnewargs__cCstt|��t|���Sr�)r�r�rr7r�rrrr��szParseResults.__dir__cCsrdd�}|g�}|��D]>\}}t|t�r>||j||d�7}q|||g|||�d�7}q|dk	rn||g|d�}|S)z�
        Helper classmethod to construct a ParseResults from a dict, preserving the
        name-value relations as results names. If an optional 'name' argument is
        given, a nested ParseResults will be returned
        cSsHzt|�Wntk
r"YdSXtr8t|ttf�St|t�SdS�NF)r,�	Exceptionrbr�r��bytesrr`rrr�is_iterable�sz+ParseResults.from_dict.<locals>.is_iterable�r)rrN)r!r�r�	from_dict)r�rJrr�r�rrrrrr��s
zParseResults.from_dict)NNTT)N)r�)NFr�T)r�TTr)N)6rrrr�rr�r�r�rr&r'r(r*�__nonzero__r-r/r2r5r6rbr7r9r!r0r8r:r;r?r�rBr�rErFr�rKrDrTr�r�rYrr_rIrirlrorurxrzr|r}r�r�r�rrrrr5�sl*
	'	
7

$
=(
A
cCsF|}d|krt|�kr4nn||ddkr4dS||�dd|�S)a�Returns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See
   :class:`ParserElement.parseString` for more
   information on parsing strings containing ``<TAB>`` s, and suggested
   methods to maintain a consistent view of the parsed string, the parse
   location, and line and column positions within the parsed string.
   rr�r�)r��rfind)r��strgr�rrrrM�scCs|�dd|�dS)a�Returns current line number within a string, counting newlines as line separators.
    The first line is number 1.

    Note - the default parsing behavior is to expand tabs in the input string
    before starting the parsing process.  See :class:`ParserElement.parseString`
    for more information on parsing strings containing ``<TAB>`` s, and
    suggested methods to maintain a consistent view of the parsed string, the
    parse location, and line and column positions within the parsed string.
    r�rr�)�count)r�r�rrrr^�s
cCsF|�dd|�}|�d|�}|dkr2||d|�S||dd�SdS)zfReturns the line of text containing loc within a string, counting newlines as line separators.
       r�rr�N)r��find)r�r�ZlastCRZnextCRrrrr[�s
cCs8tdt|�dt|�dt||�t||�f�dS)NzMatch z at loc z(%d,%d))�printr�r^rM)�instringr��exprrrr�_defaultStartDebugAction�sr�cCs$tdt|�dt|����dS)NzMatched z -> )r�r�r�r)r��startlocZendlocr��toksrrr�_defaultSuccessDebugAction�sr�cCstdt|��dS)NzException raised:)r�r�)r�r�r�r�rrr�_defaultExceptionDebugAction�sr�cGsdS)zG'Do-nothing' debug action, to suppress debugging output during parsing.Nr)r�rrrre�sr�cs��tkr�fdd�Sdg�dg�tdd�dkrFddd�}dd	d
��ntj}tj�d}|dd�d
}|d|d|f�������fdd�}d}zt�dt�d�j�}Wntk
r�t��}YnX||_|S)Ncs�|�Sr�rr�)�funcrrr��r�z_trim_arity.<locals>.<lambda>rFr�)r��cSs8tdkrdnd}tj||dd�|}|dd�gS)N)r�r�r������r���limitr�)�system_version�	traceback�
extract_stack)r�rM�
frame_summaryrrrr�sz"_trim_arity.<locals>.extract_stackcSs$tj||d�}|d}|dd�gS)Nr�r�r�)r��
extract_tb)�tbr�Zframesr�rrrr�sz_trim_arity.<locals>.extract_tb�r�r�r�cs�z"�|�dd��}d�d<|WStk
r��dr>�nNz.t��d}�|dd�ddd��ksj�W5z~Wntk
r�YnXX�d�kr��dd7<Yq�YqXqdS)NrTr�r�r�r�)r�	NameErrorr��exc_info)r�r�r��r�Z
foundArityr�r��maxargsZpa_call_line_synthrrr�s&z_trim_arity.<locals>.wrapperz<parse action>r�	__class__)r)r)	�singleArgBuiltinsr�r�r�r��getattrrrr�)r�r�r�Z	LINE_DIFFZ	this_liner��	func_namerr�rr��s,

�r�cs�eZdZdZdZdZedd��Zedd��Zd�dd	�Z	d
d�Z
dd
�Zd�dd�Zd�dd�Z
d�dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd�d!d"�Zd#d$�Zd�d%d&�Zd'd(�Zd)d*�ZGd+d,�d,e�Zed-k	r�Gd.d/�d/e�ZnGd0d/�d/e�ZiZe�Z d1d1gZ!d�d2d3�Z"eZ#ed4d5��Z$dZ%ed�d7d8��Z&d�d9d:�Z'e(dfd;d<�Z)d=d>�Z*e(fd?d@�Z+e(dfdAdB�Z,dCdD�Z-dEdF�Z.dGdH�Z/dIdJ�Z0dKdL�Z1dMdN�Z2dOdP�Z3dQdR�Z4dSdT�Z5dUdV�Z6dWdX�Z7dYdZ�Z8d[d\�Z9d]d^�Z:d_d`�Z;d�dadb�Z<dcdd�Z=dedf�Z>dgdh�Z?didj�Z@dkdl�ZAdmdn�ZBd�dodp�ZCdqdr�ZDdsdt�ZEdudv�ZFdwdx�ZGd�dydz�ZHd�d{d|�ZI�fd}d~�ZJdd��ZKd�d��ZLd�d��ZMd�d��ZNd�d�d��ZOd�d�d��ZP�ZQS)�r7z)Abstract base level parser element class.z 
	
FcCs
|t_dS)a�
        Overrides the default whitespace chars

        Example::

            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']

            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        N)r7�DEFAULT_WHITE_CHARS��charsrrr�setDefaultWhitespaceCharsDsz'ParserElement.setDefaultWhitespaceCharscCs
|t_dS)ah
        Set class to be used for inclusion of string literals into a parser.

        Example::

            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        N)r7�_literalStringClass�r�rrr�inlineLiteralsUsingTsz!ParserElement.inlineLiteralsUsingcCs�t�|_d|_d|_d|_||_d|_ttj	�|_
d|_d|_d|_
t�|_d|_d|_d|_d|_d|_d|_d|_d|_d|_dS)NTFr�)NNN)r�parseAction�
failAction�strRepr�resultsName�
saveAsList�skipWhitespacer�r7r��
whiteChars�copyDefaultWhiteChars�mayReturnEmpty�keepTabs�ignoreExprs�debug�streamlined�
mayIndexError�errmsg�modalResults�debugActions�re�callPreparse�
callDuringTry)r��savelistrrrr�js(zParserElement.__init__cCs<t�|�}|jdd�|_|jdd�|_|jr8tj|_|S)a/
        Make a copy of this :class:`ParserElement`.  Useful for defining
        different parse actions for the same parsing pattern, using copies of
        the original parse element.

        Example::

            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0] * 1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")

            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))

        prints::

            [5120, 100, 655360, 268435456]

        Equivalent form of ``expr.copy()`` is just ``expr()``::

            integerM = integer().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")
        N)rIr�r�r�r7r�r�)r�ZcpyrrrrI�s
zParserElement.copycCs$||_d|j|_tjr |��|S)a_
        Define name for this expression, makes debugging and exception messages clearer.

        Example::

            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        �	Expected )rr�r�!enable_debug_on_named_expressions�setDebugrGrrr�setName�s
	zParserElement.setNamecCs|�||�S)aO
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original :class:`ParserElement` object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        ``expr("name")`` in place of ``expr.setResultsName("name")``
        - see :class:`__call__`.

        Example::

            date_str = (integer.setResultsName("year") + '/'
                        + integer.setResultsName("month") + '/'
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        )�_setResultsName�r�r�listAllMatchesrrr�setResultsName�szParserElement.setResultsNamecCs4|��}|�d�r"|dd�}d}||_||_|S)N�*r�T)rI�endswithr�r�)r�rr�Znewselfrrrr��s
zParserElement._setResultsNameTcs@|r&|j�d�fdd�	}�|_||_nt|jd�r<|jj|_|S)z�Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set ``breakFlag`` to True to enable, False to
           disable.
        Tcsddl}|���||||�Sr�)�pdbZ	set_trace)r�r��	doActions�callPreParser��Z_parseMethodrr�breaker�sz'ParserElement.setBreak.<locals>.breaker�_originalParseMethod)TT)�_parser�r1)r�Z	breakFlagr�rr�r�setBreak�s
zParserElement.setBreakcOsVt|�dgkrg|_n<tdd�|D��s0td��tttt|���|_|�dd�|_|S)a�
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as ``fn(s, loc, toks)`` ,
        ``fn(loc, toks)`` , ``fn(toks)`` , or just ``fn()`` , where:

        - s   = the original string being parsed (see note below)
        - loc = the location of the matching substring
        - toks = a list of the matched tokens, packaged as a :class:`ParseResults` object

        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        If None is passed as the parse action, all previously added parse actions for this
        expression are cleared.

        Optional keyword arguments:
        - callDuringTry = (default= ``False``) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See :class:`parseString for more
        information on parsing strings containing ``<TAB>`` s, and suggested
        methods to maintain a consistent view of the parsed string, the parse
        location, and line and column positions within the parsed string.

        Example::

            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        Ncss|]}t|�VqdSr�)�callable)r�r�rrrr�sz/ParserElement.setParseAction.<locals>.<genexpr>zparse actions must be callabler�F)rr��allr�mapr�r�r��r��fnsr=rrrr��s(zParserElement.setParseActioncOs4|jtttt|���7_|jp,|�dd�|_|S)z�
        Add one or more parse actions to expression's list of parse actions. See :class:`setParseAction`.

        See examples in :class:`copy`.
        r�F)r�rr�r�r�r�r�rrr�addParseActionszParserElement.addParseActionc
OsF|D](}|j�t||�d�|�dd�d��q|jp>|�dd�|_|S)a�Add a boolean predicate function to expression's list of parse actions. See
        :class:`setParseAction` for function call signatures. Unlike ``setParseAction``,
        functions passed to ``addCondition`` need to return boolean success/fail of the condition.

        Optional keyword arguments:
        - message = define a custom message to be used in the raised exception
        - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException

        Example::

            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        r�r�F)r�r�r�)r�r�r�r�r�)r�r�r=r�rrr�addConditions
�
zParserElement.addConditioncCs
||_|S)aDefine action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           ``fn(s, loc, expr, err)`` where:
           - s = string being parsed
           - loc = location where expression match was attempted and failed
           - expr = the parse expression that failed
           - err = the exception thrown
           The function returns no value.  It may throw :class:`ParseFatalException`
           if it is desired to stop parsing immediately.)r��r�r�rrr�
setFailAction4s
zParserElement.setFailActionc	CsNd}|rJd}|jD]4}z|�||�\}}d}qWqtk
rDYqXqq|S�NTF)r�r�r2)r�r�r�Z
exprsFound�eZdummyrrr�_skipIgnorablesAs


zParserElement._skipIgnorablescCsH|jr|�||�}|jrD|j}t|�}||krD|||krD|d7}q&|S�Nr�)r�r�r�r�r�)r�r�r�Zwt�instrlenrrr�preParseNs
zParserElement.preParsecCs|gfSr�r�r�r�r�r�rrrr�ZszParserElement.parseImplcCs|Sr�r�r�r�r��	tokenlistrrr�	postParse]szParserElement.postParsecCs�d\}}}|j}|s|j�r"|j|r8|j||||�z�|rR|jrR|�||�}	n|}	|	}
|jsl|	t|�kr�z|�||	|�\}}Wq�tk
r�t	|t|�|j
|��Yq�Xn|�||	|�\}}Wn\tk
�r}z<|j|r�|j|||
||�|j�r|�||
||��W5d}~XYnXn�|�r>|j�r>|�||�}	n|}	|	}
|j�s\|	t|�k�r�z|�||	|�\}}Wn*tk
�r�t	|t|�|j
|��YnXn|�||	|�\}}|�|||�}t
||j|j|jd�}
|j�r`|�s�|j�r`|�r�z�|jD]�}z|||
|
�}Wn6tk
�rD}zt	d�}||_|�W5d}~XYnX|dk	�r�||
k	�r�t
||j|j�ovt|t
tf�|jd�}
�q�WnFtk
�r�}z&|j|�r�|j|||
||��W5d}~XYnXn�|jD]�}z|||
|
�}Wn6tk
�r }zt	d�}||_|�W5d}~XYnX|dk	�r�||
k	�r�t
||j|j�oRt|t
tf�|jd�}
�q�|�r�|j|�r�|j|||
|||
�||
fS)N)rr�r�)rrz exception raised in parse action)r�r�r�r�r�r�r�r�rr2r�rr�r5r�r�r�r�r��	__cause__r�r)r�r�r�r�r�ZTRYZMATCHZFAILZ	debugging�prelocZtokensStart�tokens�errZ	retTokensr�Zparse_action_excr�rrrr�as�




�
�
zParserElement._parseNoCachecCs@z|j||dd�dWStk
r:t|||j|��YnXdS)NF�r�r)r�r4r2r��r�r�r�rrr�tryParse�szParserElement.tryParsec	Cs4z|�||�Wnttfk
r*YdSXdSdS)NFT)r�r2rr�rrr�canParseNext�s
zParserElement.canParseNextc@seZdZdd�ZdS)zParserElement._UnboundedCachecs~i�t�|_���fdd�}�fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr��r��r�r@��cache�not_in_cacherrr��sz3ParserElement._UnboundedCache.__init__.<locals>.getcs|�|<dSr�r�r�r@r$�r�rrr��sz3ParserElement._UnboundedCache.__init__.<locals>.setcs���dSr��rFr�r�rrrF�sz5ParserElement._UnboundedCache.__init__.<locals>.clearcst��Sr��r�r�r�rr�	cache_len�sz9ParserElement._UnboundedCache.__init__.<locals>.cache_len)r�r��types�
MethodTyper�r�rFr()r�r�r�rFr�rr�rr��sz&ParserElement._UnboundedCache.__init__N�rrrr�rrrr�_UnboundedCache�sr�Nc@seZdZdd�ZdS)�ParserElement._FifoCachecs�t�|_�t����fdd�}��fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr�r�r�r�rrr��s�.ParserElement._FifoCache.__init__.<locals>.getcs>|�|<t���kr:z��d�Wqtk
r6YqXqdSr~)r��popitemrr�)r��sizerrr��s�.ParserElement._FifoCache.__init__.<locals>.setcs���dSr�r�r�r�rrrF�s�0ParserElement._FifoCache.__init__.<locals>.clearcst��Sr�r�r�r�rrr��s�4ParserElement._FifoCache.__init__.<locals>.cache_len)	r�r��_OrderedDictr�r�r�r�rFr(�r�rr�r�rFr�r)r�r�rrr��s�!ParserElement._FifoCache.__init__Nr�rrrr�
_FifoCache�src@seZdZdd�ZdS)r�cs�t�|_�i�t�g�����fdd�}���fdd�}��fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_	dS)	Ncs��|��Sr�r�r�r�rrr�sr�cs4|�|<t���kr&�����d�q��|�dSr�)r�r?�popleftr�r�)r��key_fiforrrr�srcs������dSr�r�r�)r�r	rrrF
srcst��Sr�r�r�r�rrr�sr)
r�r��collections�dequer�r�r�r�rFr(rr)r�r	r�rrr��srNr�rrrrr�srcCsd\}}|||||f}tj��tj}|�|�}	|	|jkr�tj|d7<z|�||||�}	Wn8tk
r�}
z|�||
j	|
j
���W5d}
~
XYn.X|�||	d|	d��f�|	W5QR�Sn@tj|d7<t|	t
�r�|	�|	d|	d��fW5QR�SW5QRXdS)NrNr�r)r7�packrat_cache_lock�
packrat_cacher�r��packrat_cache_statsr�r0r�r�r�rIr�r)r�r�r�r�r�ZHITZMISS�lookupr�r$r�rrr�_parseCaches$


zParserElement._parseCachecCs(tj��dgttj�tjdd�<dSr�)r7r
rFr�rrrrr�
resetCache6s
zParserElement.resetCache�cCs8tjs4dt_|dkr t��t_nt�|�t_tjt_dS)a�Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.

           Parameters:

           - cache_size_limit - (default= ``128``) - if an integer value is provided
             will limit the size of the packrat cache; if None is passed, then
             the cache size will be unbounded; if 0 is passed, the cache will
             be effectively disabled.

           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method :class:`ParserElement.enablePackrat`.
           For best results, call ``enablePackrat()`` immediately after
           importing pyparsing.

           Example::

               from pip._vendor import pyparsing
               pyparsing.ParserElement.enablePackrat()
        TN)r7�_packratEnabledr�r
rrr�)Zcache_size_limitrrr�
enablePackrat<szParserElement.enablePackratc
Cs�t��|js|��|jD]}|��q|js8|��}z<|�|d�\}}|rr|�||�}t	�t
�}|�||�Wn0tk
r�}ztjr��n|�W5d}~XYnX|SdS)a�
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        Returns the parsed data as a :class:`ParseResults` object, which may be
        accessed as a list, or as a dict or object with attributes if the given parser
        includes results names.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set ``parseAll`` to True (equivalent to ending
        the grammar with ``StringEnd()``).

        Note: ``parseString`` implicitly calls ``expandtabs()`` on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the ``loc`` argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:

        - calling ``parseWithTabs`` on your grammar before calling ``parseString``
          (see :class:`parseWithTabs`)
        - define your parse action using the full ``(s, loc, toks)`` signature, and
          reference the input string using the parse action's ``s`` argument
        - explictly expand the tabs in your input string before calling
          ``parseString``

        Example::

            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        rN)
r7rr��
streamliner�r��
expandtabsr�r�rr<r0�verbose_stacktrace)r�r��parseAllr�r�r�Zser�rrr�parseString_s$!

zParserElement.parseStringc
cs6|js|��|jD]}|��q|js4t|���}t|�}d}|j}|j}t	�
�d}	z�||kr�|	|kr�z |||�}
|||
dd�\}}Wntk
r�|
d}YqZX||kr�|	d7}	||
|fV|r�|||�}
|
|kr�|}q�|d7}q�|}qZ|
d}qZWn4tk
�r0}zt	j
�r�n|�W5d}~XYnXdS)aq
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        ``maxMatches`` argument, to clip scanning after 'n' matches are found.  If
        ``overlap`` is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See :class:`parseString` for more information on parsing
        strings with embedded tabs.

        Example::

            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens, start, end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])

        prints::

            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        rF�r�r�N)r�rr�r�r�rr�r�r�r7rr2r0r)r�r��
maxMatchesZoverlapr�r�r�Z
preparseFnZparseFn�matchesr�ZnextLocr�Znextlocr�rrr�
scanString�sB




zParserElement.scanStringc
Cs�g}d}d|_z�|�|�D]Z\}}}|�|||��|rpt|t�rR||��7}nt|t�rf||7}n
|�|�|}q|�||d��dd�|D�}d�tt	t
|���WStk
r�}ztj
rƂn|�W5d}~XYnXdS)a[
        Extension to :class:`scanString`, to modify matching text with modified tokens that may
        be returned from a parse action.  To use ``transformString``, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking ``transformString()`` on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  ``transformString()`` returns the resulting transformed string.

        Example::

            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())

            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))

        prints::

            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        rTNcSsg|]}|r|�qSrr�r��orrrrsz1ParserElement.transformString.<locals>.<listcomp>r�)r�rr�r�r5rrr�r�r��_flattenr0r7r)r�r�r[ZlastEr�r�r�r�rrrr��s(



zParserElement.transformStringc
CsRztdd�|�||�D��WStk
rL}ztjr8�n|�W5d}~XYnXdS)a�
        Another extension to :class:`scanString`, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        ``maxMatches`` argument, to clip searching after 'n' matches are found.

        Example::

            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())

            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))

        prints::

            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        cSsg|]\}}}|�qSrr)r�r�r�r�rrrr#sz.ParserElement.searchString.<locals>.<listcomp>N)r5rr0r7r)r�r�rr�rrr�searchString
szParserElement.searchStringc	csTd}d}|j||d�D]*\}}}|||�V|r<|dV|}q||d�VdS)aR
        Generator method to split a string using the given expression as a separator.
        May be called with optional ``maxsplit`` argument, to limit the number of splits;
        and the optional ``includeSeparators`` argument (default= ``False``), if the separating
        matching text should be included in the split results.

        Example::

            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))

        prints::

            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        r)rN)r)	r�r��maxsplitZincludeSeparatorsZsplitsZlastr�r�r�rrrr�+s
zParserElement.splitcCsV|tkrt|�St|t�r$|�|�}t|t�sJtjdt|�t	dd�dSt
||g�S)a[
        Implementation of + operator - returns :class:`And`. Adding strings to a ParserElement
        converts them to :class:`Literal`s by default.

        Example::

            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))

        prints::

            Hello, World! -> ['Hello', ',', 'World', '!']

        ``...`` may be used as a parse expression as a short form of :class:`SkipTo`.

            Literal('start') + ... + Literal('end')

        is equivalent to:

            Literal('start') + SkipTo('end')("_skipped*") + Literal('end')

        Note that the skipped text is returned with '_skipped' as a results name,
        and to support having multiple skips in the same parser, the value returned is
        a list of all skipped text.
        �4Cannot combine element of type %s with ParserElementr���
stacklevelN)�Ellipsis�_PendingSkipr�rr�r7�warnings�warnr��
SyntaxWarningrrSrrrrKDs


�zParserElement.__add__cCsZ|tkrt|�d�|St|t�r,|�|�}t|t�sRtjdt|�t	dd�dS||S)z`
        Implementation of + operator when left operand is not a :class:`ParserElement`
        �	_skipped*r#r�r$N)
r&r;r�rr�r7r(r)r�r*rSrrrrTjs


�zParserElement.__radd__cCsJt|t�r|�|�}t|t�s:tjdt|�tdd�dS|t�	�|S)zT
        Implementation of - operator, returns :class:`And` with error stop
        r#r�r$N)
r�rr�r7r(r)r�r*r�
_ErrorStoprSrrr�__sub__ys


�zParserElement.__sub__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||S)z`
        Implementation of - operator when left operand is not a :class:`ParserElement`
        r#r�r$N�r�rr�r7r(r)r�r*rSrrr�__rsub__�s


�zParserElement.__rsub__cs|tkrd}n8t|t�rF|dd�tfkrFd|dd�ddd�}t|t�r\|d}}n�t|t��rJtdd	�|D��}|d
dd�}|ddkr�d|df}t|dt�r�|ddkr�|ddkr�t��S|ddkr�t��S�|dt��SnNt|dt��r,t|dt��r,|\}}||8}ntdt|d�t|d���ntdt|���|dk�rjtd
��|dk�r|td��||k�r�dk�r�nntd��|�r��fdd��|�r�|dk�r҈�|�}nt	�g|��|�}n�|�}n|dk�r�}nt	�g|�}|S)a�
        Implementation of * operator, allows use of ``expr * 3`` in place of
        ``expr + expr + expr``.  Expressions may also me multiplied by a 2-integer
        tuple, similar to ``{min, max}`` multipliers in regular expressions.  Tuples
        may also include ``None`` as in:
         - ``expr*(n, None)`` or ``expr*(n, )`` is equivalent
              to ``expr*n + ZeroOrMore(expr)``
              (read as "at least n instances of ``expr``")
         - ``expr*(None, n)`` is equivalent to ``expr*(0, n)``
              (read as "0 to n instances of ``expr``")
         - ``expr*(None, None)`` is equivalent to ``ZeroOrMore(expr)``
         - ``expr*(1, None)`` is equivalent to ``OneOrMore(expr)``

        Note that ``expr*(None, n)`` does not raise an exception if
        more than n exprs exist in the input stream; that is,
        ``expr*(None, n)`` does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        ``expr*(None, n) + ~expr``
        )rNNr�rr�r�rcss|]}|tk	r|ndVqdSr�)r&rrrrr��sz(ParserElement.__mul__.<locals>.<genexpr>)NNz8cannot multiply 'ParserElement' and ('%s', '%s') objectsz0cannot multiply 'ParserElement' and '%s' objectsz/cannot multiply ParserElement by negative valuez@second tuple value must be greater or equal to first tuple valuez,cannot multiply ParserElement by 0 or (0, 0)cs(|dkrt��|d��St��SdSr�)r.��n��makeOptionalListr�rrr3�sz/ParserElement.__mul__.<locals>.makeOptionalList)
r&r��tupler�rEr,rr��
ValueErrorr)r�rJZminElementsZoptElementsr�rr2r�__mul__�sN
 





zParserElement.__mul__cCs
|�|�Sr�)r6rSrrr�__rmul__�szParserElement.__rmul__cCsZ|tkrt|dd�St|t�r(|�|�}t|t�sNtjdt|�t	dd�dSt
||g�S)zL
        Implementation of | operator - returns :class:`MatchFirst`
        T)�	must_skipr#r�r$N)r&r'r�rr�r7r(r)r�r*r)rSrrr�__or__�s


�zParserElement.__or__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||BS)z`
        Implementation of | operator when left operand is not a :class:`ParserElement`
        r#r�r$Nr.rSrrr�__ror__�s


�zParserElement.__ror__cCsFt|t�r|�|�}t|t�s:tjdt|�tdd�dSt||g�S)zD
        Implementation of ^ operator - returns :class:`Or`
        r#r�r$N)	r�rr�r7r(r)r�r*r/rSrrr�__xor__�s


�zParserElement.__xor__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||AS)z`
        Implementation of ^ operator when left operand is not a :class:`ParserElement`
        r#r�r$Nr.rSrrr�__rxor__	s


�zParserElement.__rxor__cCsFt|t�r|�|�}t|t�s:tjdt|�tdd�dSt||g�S)zF
        Implementation of & operator - returns :class:`Each`
        r#r�r$N)	r�rr�r7r(r)r�r*rrSrrr�__and__	s


�zParserElement.__and__cCsBt|t�r|�|�}t|t�s:tjdt|�tdd�dS||@S)z`
        Implementation of & operator when left operand is not a :class:`ParserElement`
        r#r�r$Nr.rSrrr�__rand__	s


�zParserElement.__rand__cCst|�S)zH
        Implementation of ~ operator - returns :class:`NotAny`
        )r+r�rrr�
__invert__)	szParserElement.__invert__cCstd|jj��dS)Nz%r object is not iterable)rr�rr�rrrr-/	szParserElement.__iter__c	Cs�zt|t�r|f}t|�Wntk
r8||f}YnXt|�dkrzt�d�|dd�t|�dkrrd�t|��nd��|t|dd��}|S)a�
        use ``[]`` indexing notation as a short form for expression repetition:
         - ``expr[n]`` is equivalent to ``expr*n``
         - ``expr[m, n]`` is equivalent to ``expr*(m, n)``
         - ``expr[n, ...]`` or ``expr[n,]`` is equivalent
              to ``expr*n + ZeroOrMore(expr)``
              (read as "at least n instances of ``expr``")
         - ``expr[..., n]`` is equivalent to ``expr*(0, n)``
              (read as "0 to n instances of ``expr``")
         - ``expr[...]`` and ``expr[0, ...]`` are equivalent to ``ZeroOrMore(expr)``
         - ``expr[1, ...]`` is equivalent to ``OneOrMore(expr)``
         ``None`` may be used in place of ``...``.

        Note that ``expr[..., n]`` and ``expr[m, n]``do not raise an exception
        if more than ``n`` ``expr``s exist in the input stream.  If this behavior is
        desired, then write ``expr[..., n] + ~expr``.
       r�z.only 1 or 2 index arguments supported ({0}{1})Nr�z	... [{0}]r�)	r�r�r,rr�r(r)r�r4)r�r@r�rrrr�4	s

��zParserElement.__getitem__cCs|dk	r|�|�S|��SdS)a�
        Shortcut for :class:`setResultsName`, with ``listAllMatches=False``.

        If ``name`` is given with a trailing ``'*'`` character, then ``listAllMatches`` will be
        passed as ``True``.

        If ``name` is omitted, same as calling :class:`copy`.

        Example::

            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums + "-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums + "-")("socsecno")
        N)r�rIrGrrr�__call__X	s
zParserElement.__call__cCst|�S)z�
        Suppresses the output of this :class:`ParserElement`; useful to keep punctuation from
        cluttering up returned output.
        )r>r�rrr�suppressl	szParserElement.suppresscCs
d|_|S)a
        Disables the skipping of whitespace before matching the characters in the
        :class:`ParserElement`'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        F�r�r�rrr�leaveWhitespaces	szParserElement.leaveWhitespacecCsd|_||_d|_|S)z8
        Overrides the default whitespace chars
        TF)r�r�r�)r�r�rrr�setWhitespaceChars|	sz ParserElement.setWhitespaceCharscCs
d|_|S)z�
        Overrides default behavior to expand ``<TAB>``s to spaces before parsing the input string.
        Must be called before ``parseString`` when the input grammar contains elements that
        match ``<TAB>`` characters.
        T)r�r�rrr�
parseWithTabs�	szParserElement.parseWithTabscCsLt|t�rt|�}t|t�r4||jkrH|j�|�n|j�t|����|S)a�
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.

        Example::

            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']

            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        )r�rr>r�r�rIrSrrr�ignore�	s


zParserElement.ignorecCs"|pt|pt|ptf|_d|_|S)zT
        Enable display of debugging messages while doing pattern matching.
        T)r�r�r�r�r�)r�ZstartActionZ
successActionZexceptionActionrrr�setDebugActions�	s�zParserElement.setDebugActionscCs|r|�ttt�nd|_|S)a�
        Enable display of debugging messages while doing pattern matching.
        Set ``flag`` to True to enable, False to disable.

        Example::

            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer

            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")

        prints::

            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using :class:`setDebugActions`. Prior to attempting
        to match the ``wd`` expression, the debugging message ``"Match <exprname> at loc <n>(<line>,<col>)"``
        is shown. Then if the parse succeeds, a ``"Matched"`` message is shown, or an ``"Exception raised"``
        message is shown. Also note the use of :class:`setName` to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the :class:`Word` expression without calling ``setName`` is ``"W:(ABCD...)"``.
        F)rGr�r�r�r�)r��flagrrrr��	s%zParserElement.setDebugcCs|jSr�r�r�rrrr��	szParserElement.__str__cCst|�Sr�r�r�rrrr��	szParserElement.__repr__cCsd|_d|_|Sr�)r�r�r�rrrr�	szParserElement.streamlinecCsdSr�rr�rrr�checkRecursion�	szParserElement.checkRecursioncCs|�g�dS)zj
        Check defined expressions for valid structure, check for infinite recursive definitions.
        N)rI)r��
validateTracerrr�validate�	szParserElement.validatecCs�z|��}Wn2tk
r>t|d��}|��}W5QRXYnXz|�||�WStk
r~}ztjrj�n|�W5d}~XYnXdS)z�
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        �rN)�readr��openrr0r7r)r�Zfile_or_filenamerZ
file_contents�fr�rrr�	parseFile�	szParserElement.parseFilecsht|t�rBtr(||kp$tt|��|�qd||kp>t|�t|�kSn"t|t�rV|�|�Stt|�|kSdSr�)r�r7rb�super�__eq__�varsrrrS�r�rrrR
s


zParserElement.__eq__cCs
||kSr�rrSrrr�__ne__
szParserElement.__ne__cCst|�Sr�)�idr�rrr�__hash__
szParserElement.__hash__cCs||kSr�rrSrrr�__req__
szParserElement.__req__cCs
||kSr�rrSrrr�__rne__
szParserElement.__rne__cCs4z|jt|�|d�WdStk
r.YdSXdS)a�
        Method for quick testing of a parser against a test string. Good for simple
        inline microtests of sub expressions while building up larger parser.

        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests

        Example::

            expr = Word(nums)
            assert expr.matches("100")
        �rTFN)rr�r0)r�Z
testStringrrrrr
s
zParserElement.matches�#c	Cs�t|t�r"tttj|������}t|t�r4t|�}|dkrBt	j
}|j}	g}
g}d}td��t
d���t�}
d}|D�]\}|dk	r�|�|d�s�|r�|s�|�|�qt|s�qtd�|�|g}g}z"|
�|�|��}|j||d�}Wn�tk
�r�}z�t|t�r�dnd	}d|k�rB|�t|j|��|�d
t|j|�dd|�n|�d
|jd|�|�d
t|��|�ot|}|}W5d}~XY�ntk
�r�}z$|�dt|��|�o�|}|}W5d}~XYn�X|�o�|}|dk	�r�zR|||�}|dk	�r(t|t��r|�|���n|�t|��n|�|���WnRtk
�r�}z2|�|j|d��|�d�|jt |�j|��W5d}~XYnXn|�|j|d��|�r�|�r�|�d	�|	d�|��|
�||f�qt||
fS)as

        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.

        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests
         - comment - (default= ``'#'``) - expression for indicating embedded comments in the test
              string; pass None to disable comment filtering
         - fullDump - (default= ``True``) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default= ``True``) prints test output to stdout
         - failureTests - (default= ``False``) indicates if these tests are expected to fail parsing
         - postParse - (default= ``None``) optional callback for successful parse results; called as
              `fn(test_string, parse_results)` and returns a string to be added to the test output
         - file - (default=``None``) optional file-like object to which test output will be written;
              if None, will default to ``sys.stdout``

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if ``failureTests`` is True), and the results contain a list of lines of each
        test's output

        Example::

            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")

        prints::

            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success

            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\n of strings that spans \n 3 lines")

        (Note that this is a raw string literal, you must include the leading 'r'.)
        NT�\nr�uFrZz(FATAL)r�r�r�r�zFAIL: zFAIL-EXCEPTION: )rpz{0} failed: {1}: {2})!r�rrr�r�r��rstrip�
splitlinesr'r��stdout�writer�rprFrmrr�r�r��lstriprr0r4r[r�rMrr5rur�rr�)r�ZtestsrZcommentZfullDumpZprintResultsZfailureTestsr��file�print_Z
allResultsZcomments�successrw�BOMr�r[�resultr�r�r�Zpp_valuer�rrr�runTests.
sn`




$




0
zParserElement.runTests)F)F)F)T)T)TT)TT)r)F)N)T)N)F)T)Tr[TTFNN)Rrrrr�r�rr�r�r�r�rIr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr
rrrrr�rrrr�_MAX_INTrr�r!r�rKrTr-r/r6r7r9r:r;r<r=r>r?r-r�r@rArCrDrErFrGr�r�r�rrIrKrPrRrUrWrXrYrrg�
__classcell__rrrTrr7?s�




	
1




W

"
8H.&J$
			

+


�cs6eZdZd
�fdd�	Zdd�Zdd�Zdd	�Z�ZS)r'Fcs>tt|���t|t���dd�|_|j|_||_||_	dS)Nr�...)
rQr'r�r�rr�r�r�anchorr8)r�r�r8rTrrr��
s
z_PendingSkip.__init__cs\t|��d�d�}�jrNdd�}�fdd�}�j|��|�|��|�B|S�j||S)Nrjr+cSs,|jr|j��dgkr(|d=|�dd�dS)Nr�r�_skipped)rlrr?r�rrrr8�
sz'_PendingSkip.__add__.<locals>.must_skipcs<|j��dd�dgkr8|�d�}dt�j�d|d<dS)Nr�r�rlz	missing <rg)rlrr?r�rk)r�Zskippedr�rr�	show_skip�
s
z'_PendingSkip.__add__.<locals>.show_skip)r;r�r8rkr�)r�rJZskipperr8rmrr�rrK�
s
��z_PendingSkip.__add__cCs|jSr�)r�r�rrrr��
sz_PendingSkip.__repr__cGstd��dS)NzBuse of `...` expression without following SkipTo target expression)r)r�r�rrrr��
sz_PendingSkip.parseImpl)F)rrrr�rKr�r�rirrrTrr'�
sr'cs eZdZdZ�fdd�Z�ZS)r?zYAbstract :class:`ParserElement` subclass, for defining atomic
    matching patterns.
    cstt|�jdd�dS�NF�r�)rQr?r�r�rTrrr��
szToken.__init__�rrrr�r�rirrrTrr?�
scs eZdZdZ�fdd�Z�ZS)rz'An empty token, will always match.
    cs$tt|���d|_d|_d|_dS)NrTF)rQrr�rr�r�r�rTrrr��
szEmpty.__init__rprrrTrr�
scs*eZdZdZ�fdd�Zddd�Z�ZS)r*z#A token that will never match.
    cs*tt|���d|_d|_d|_d|_dS)Nr*TFzUnmatchable token)rQr*r�rr�r�r�r�rTrrr�s
zNoMatch.__init__TcCst|||j|��dSr�)r2r�r�rrrr�szNoMatch.parseImpl)T�rrrr�r�r�rirrrTrr*scs*eZdZdZ�fdd�Zddd�Z�ZS)r'a�Token to exactly match a specified string.

    Example::

        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"

    For case-insensitive matching, use :class:`CaselessLiteral`.

    For keyword matching (force word break before and after the matched string),
    use :class:`Keyword` or :class:`CaselessKeyword`.
    cs�tt|���||_t|�|_z|d|_Wn*tk
rVtj	dt
dd�t|_YnXdt
|j�|_d|j|_d|_d|_|jdkr�t|�tkr�t|_dS)	Nrz2null string passed to Literal; use Empty() insteadr�r$�"%s"r�Fr�)rQr'r��matchr��matchLen�firstMatchCharrr(r)r*rr�r�rr�r�r�r��_SingleCharLiteral�r��matchStringrTrrr� s"
�zLiteral.__init__TcCs@|||jkr,|�|j|�r,||j|jfSt|||j|��dSr�)ru�
startswithrsrtr2r�r�rrrr�4szLiteral.parseImpl)TrqrrrTrr's
c@seZdZddd�ZdS)rvTcCs0|||jkr|d|jfSt|||j|��dSr�)rursr2r�r�rrrr�:sz_SingleCharLiteral.parseImplN)T�rrrr�rrrrrv9srvcsLeZdZdZedZd�fdd�	Zddd	�Z�fd
d�Ze	dd
��Z
�ZS)r$a�Token to exactly match a specified string as a keyword, that is,
    it must be immediately followed by a non-keyword character.  Compare
    with :class:`Literal`:

     - ``Literal("if")`` will match the leading ``'if'`` in
       ``'ifAndOnlyIf'``.
     - ``Keyword("if")`` will not; it will only match the leading
       ``'if'`` in ``'if x=1'``, or ``'if(y==2)'``

    Accepts two optional constructor arguments in addition to the
    keyword string:

     - ``identChars`` is a string of characters that would be valid
       identifier characters, defaulting to all alphanumerics + "_" and
       "$"
     - ``caseless`` allows case-insensitive matching, default is ``False``.

    Example::

        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use :class:`CaselessKeyword`.
    �_$NFcs�tt|���|dkrtj}||_t|�|_z|d|_Wn$tk
r^t	j
dtdd�YnXd|j|_d|j|_
d|_d|_||_|r�|��|_|��}t|�|_dS)Nrz2null string passed to Keyword; use Empty() insteadr�r$rrr�F)rQr$r��DEFAULT_KEYWORD_CHARSrsr�rtrurr(r)r*rr�r�r��caseless�upper�
caselessmatchr��
identChars)r�rxr�r}rTrrr�]s*
�
zKeyword.__init__TcCs|jr|||||j���|jkr�|t|�|jksL|||j��|jkr�|dksj||d��|jkr�||j|jfSnv|||jkr�|jdks�|�|j|�r�|t|�|jks�|||j|jkr�|dks�||d|jkr�||j|jfSt	|||j
|��dSr)r}rtr~rr�r�rsruryr2r�r�rrrr�rs.��������zKeyword.parseImplcstt|���}tj|_|Sr�)rQr$rIr|r�)r�r�rTrrrI�szKeyword.copycCs
|t_dS)z,Overrides the default Keyword chars
        N)r$r|r�rrr�setDefaultKeywordChars�szKeyword.setDefaultKeywordChars)NF)T)rrrr�rGr|r�r�rIr�r�rirrrTrr$Bs
cs*eZdZdZ�fdd�Zddd�Z�ZS)rafToken to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::

        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']

    (Contrast with example for :class:`CaselessKeyword`.)
    cs6tt|��|���||_d|j|_d|j|_dS)Nz'%s'r�)rQrr�r~�returnStringrr�rwrTrrr��szCaselessLiteral.__init__TcCs@||||j���|jkr,||j|jfSt|||j|��dSr�)rtr~rsr�r2r�r�rrrr��szCaselessLiteral.parseImpl)TrqrrrTrr�s
cs"eZdZdZd�fdd�	Z�ZS)rz�
    Caseless version of :class:`Keyword`.

    Example::

        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']

    (Contrast with example for :class:`CaselessLiteral`.)
    Ncstt|�j||dd�dS)NT�r})rQrr�)r�rxr�rTrrr��szCaselessKeyword.__init__)NrprrrTrr�s	cs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
r�a�A variation on :class:`Literal` which matches "close" matches,
    that is, strings with at most 'n' mismatching characters.
    :class:`CloseMatch` takes parameters:

     - ``match_string`` - string to be matched
     - ``maxMismatches`` - (``default=1``) maximum number of
       mismatches allowed to count as a match

    The results from a successful parse will contain the matched text
    from the input string and the following named results:

     - ``mismatches`` - a list of the positions within the
       match_string where mismatches were found
     - ``original`` - the original match_string used to compare
       against the input string

    If ``mismatches`` is an empty list, then the match was an exact
    match.

    Example::

        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    r�csBtt|���||_||_||_d|j|jf|_d|_d|_dS)Nz&Expected %r (with up to %d mismatches)F)	rQr�r�r�match_string�
maxMismatchesr�r�r�)r�r�r�rTrrr��szCloseMatch.__init__TcCs�|}t|�}|t|j�}||kr�|j}d}g}	|j}
tt|||�|��D]2\}}|\}}
||
krL|	�|�t|	�|
krLq�qL|d}t|||�g�}||d<|	|d<||fSt|||j|��dS)Nrr��original�
mismatches)	r�r�r�r�r�r�r5r2r�)r�r�r�r��startr��maxlocr�Zmatch_stringlocr�r�Zs_m�src�mat�resultsrrrr��s(
zCloseMatch.parseImpl)r�)TrqrrrTrr��s 	cs8eZdZdZd
�fdd�	Zdd	d
�Z�fdd�Z�ZS)rBaX	Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters, an
    optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for ``min`` is
    1 (a minimum value < 1 is not valid); the default values for
    ``max`` and ``exact`` are 0, meaning no maximum or exact
    length restriction. An optional ``excludeChars`` parameter can
    list characters that might be found in the input ``bodyChars``
    string; useful to define a word of all printables except for one or
    two characters, for instance.

    :class:`srange` is useful for defining custom character set strings
    for defining ``Word`` expressions, using range notation from
    regular expression character sets.

    A common mistake is to use :class:`Word` to match a specific literal
    string, as in ``Word("Address")``. Remember that :class:`Word`
    uses the string argument to define *sets* of matchable characters.
    This expression would match "Add", "AAA", "dAred", or any other word
    made up of the characters 'A', 'd', 'r', 'e', and 's'. To match an
    exact literal string, use :class:`Literal` or :class:`Keyword`.

    pyparsing includes helper strings for building Words:

     - :class:`alphas`
     - :class:`nums`
     - :class:`alphanums`
     - :class:`hexnums`
     - :class:`alphas8bit` (alphabetic characters in ASCII range 128-255
       - accented, tilded, umlauted, etc.)
     - :class:`punc8bit` (non-alphabetic characters in ASCII range
       128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - :class:`printables` (any non-whitespace character)

    Example::

        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))

        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums + '-')

        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")

        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    Nr�rFcs�tt|����rNt���d��fdd�|D��}|rNd��fdd�|D��}||_t|�|_|rt||_t|�|_n||_t|�|_|dk|_	|dkr�t
d��||_|dkr�||_nt
|_|dkr�||_||_t|�|_d|j|_d	|_||_d
|j|jk�r�|dk�r�|dk�r�|dk�r�|j|jk�r@dt|j�|_nHt|j�dk�rndt�|j�t|j�f|_nd
t|j�t|j�f|_|j�r�d|jd|_zt�|j�|_Wntk
�r�d|_YnX|jj|_t|_dS)Nr�c3s|]}|�kr|VqdSr�rr���excludeCharsrrr�2sz Word.__init__.<locals>.<genexpr>c3s|]}|�kr|VqdSr�rr�r�rrr�4srr�zZcannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permittedr�Fr�z[%s]+z%s[%s]*z	[%s][%s]*z\b)rQrBr�r�r��
initCharsOrig�	initChars�
bodyCharsOrig�	bodyChars�maxSpecifiedr5�minLen�maxLenrhr�rr�r��	asKeyword�_escapeRegexRangeChars�reStringr�r��escape�compilerrs�re_match�
_WordRegexr�)r�r�r��min�max�exactr�r�rTr�rr�.sZ



0�

�
z
Word.__init__Tc	Cs�|||jkrt|||j|��|}|d7}t|�}|j}||j}t||�}||krj|||krj|d7}qLd}|||jkr�d}nV|jr�||kr�|||kr�d}n6|j	r�|dkr�||d|ks�||kr�|||kr�d}|r�t|||j|��||||�fS)Nr�FTr)
r�r2r�r�r�r�r�r�r�r�)	r�r�r�r�r�r�Z	bodycharsr�ZthrowExceptionrrrr�gs2


�
�zWord.parseImplcsvztt|���WStk
r$YnX|jdkrpdd�}|j|jkr`d||j�||j�f|_nd||j�|_|jS)NcSs$t|�dkr|dd�dS|SdS)N�rjr��r�rrr�
charsAsStr�sz Word.__str__.<locals>.charsAsStrz
W:(%s, %s)zW:(%s))rQrBr�rr�r�r�)r�r�rTrrr��s
zWord.__str__)Nr�rrFN)T�rrrr�r�r�r�rirrrTrrB�s49
c@seZdZddd�ZdS)r�TcCs4|�||�}|s t|||j|��|��}||��fSr�)r�r2r��end�group)r�r�r�r�rfrrrr��s
z_WordRegex.parseImplN)Trzrrrrr��sr�cs"eZdZdZd�fdd�	Z�ZS)rFz�A short-cut class for defining ``Word(characters, exact=1)``,
    when defining a match of any single character in a string of
    characters.
    FNcsZtt|�j|d||d�dtd�|j��|_|r>d|j|_t�|j�|_|jj	|_
dS)Nr�)r�r�r��[%s]r�z\b%s\b)rQrFr�r�r�r�r�r�r�rsr�)r��charsetr�r�rTrrr��sz
Char.__init__)FNrprrrTrrF�scsbeZdZdZee�d��Zd�fdd�	Zddd	�Z	dd
d�Z
ddd
�Z�fdd�Zdd�Z
�ZS)r:a�Token for matching strings that match a given regular
    expression. Defined with string specifying the regular expression in
    a form recognized by the stdlib Python  `re module <https://docs.python.org/3/library/re.html>`_.
    If the given regex contains named groups (defined using ``(?P<name>...)``),
    these will be preserved as named parse results.

    Example::

        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: https://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    z[A-Z]rFcstt|���t|t�r�|s,tjdtdd�||_||_	zt
�|j|j	�|_
|j|_Wq�t
jk
r�tjd|tdd��Yq�Xn2t|tj�r�||_
t|�|_|_||_	ntd��|j
j|_t|�|_d|j|_d|_d|_||_||_|jr�|j|_|j�r|j|_d	S)
aThe parameters ``pattern`` and ``flags`` are passed
        to the ``re.compile()`` function as-is. See the Python
        `re module <https://docs.python.org/3/library/re.html>`_ module for an
        explanation of the acceptable patterns and flags.
        z0null string passed to Regex; use Empty() insteadr�r$�$invalid pattern (%s) passed to RegexzCRegex may only be constructed with a string or a compiled RE objectr�FTN)rQr:r�r�rr(r)r*�pattern�flagsr�r�r��
sre_constants�error�compiledREtyper�r5rsr�r�rr�r�r��asGroupList�asMatch�parseImplAsGroupListr��parseImplAsMatch)r�r�r�r�r�rTrrr��sD
�
�


zRegex.__init__Tc	Csb|�||�}|s t|||j|��|��}t|���}|��}|rZ|��D]\}}|||<qH||fSr�)r�r2r�r�r5r��	groupdictr!)	r�r�r�r�rfr��drrrrrr��s
zRegex.parseImplcCs8|�||�}|s t|||j|��|��}|��}||fSr�)r�r2r�r��groups�r�r�r�r�rfr�rrrr��szRegex.parseImplAsGroupListcCs4|�||�}|s t|||j|��|��}|}||fSr�)r�r2r�r�r�rrrr�
szRegex.parseImplAsMatchcsFztt|���WStk
r$YnX|jdkr@dt|j�|_|jS)NzRe:(%s))rQr:r�rr�r�r�r�rTrrr�
s
z
Regex.__str__csl�jrtjdtdd�t���jr@t��r@tjdtdd�t���jrT�fdd�}n��fdd�}��|�S)a�
        Return Regex with an attached parse action to transform the parsed
        result as if called using `re.sub(expr, repl, string) <https://docs.python.org/3/library/re.html#re.sub>`_.

        Example::

            make_html = Regex(r"(\w+):(.*?):").sub(r"<\1>\2</\1>")
            print(make_html.transformString("h1:main title:"))
            # prints "<h1>main title</h1>"
        z-cannot use sub() with Regex(asGroupList=True)r�r$z9cannot use sub() with a callable with Regex(asMatch=True)cs|d���Sr�)�expand�r�)�replrrr�,
szRegex.sub.<locals>.pacs�j��|d�Sr�)r�rr��r�r�rrr�/
s)r�r(r)r*�SyntaxErrorr�r�r�)r�r�r�rr�rr
s ��z	Regex.sub)rFF)T)T)T)rrrr�r�r�r�r�r�r�r�r�r�rrirrrTrr:�s
-

	
	cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
r8a&
    Token for matching strings that are delimited by quoting characters.

    Defined with the following parameters:

        - quoteChar - string of one or more characters defining the
          quote delimiting string
        - escChar - character to escape quotes, typically backslash
          (default= ``None``)
        - escQuote - special quote sequence to escape an embedded quote
          string (such as SQL's ``""`` to escape an embedded ``"``)
          (default= ``None``)
        - multiline - boolean indicating whether quotes can span
          multiple lines (default= ``False``)
        - unquoteResults - boolean indicating whether the matched text
          should be unquoted (default= ``True``)
        - endQuoteChar - string of one or more characters defining the
          end of the quote delimited string (default= ``None``  => same as
          quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace
          (``'\t'``, ``'\n'``, etc.) to actual whitespace
          (default= ``True``)

    Example::

        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))

    prints::

        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    NFTc
sXtt����|��}|s0tjdtdd�t��|dkr>|}n"|��}|s`tjdtdd�t��|�_t	|��_
|d�_|�_t	|��_
|�_|�_|�_|�_|r�tjtjB�_dt��j�t�jd�|dk	r�t|�p�df�_n<d�_dt��j�t�jd�|dk	�rt|��pdf�_t	�j�d	k�rp�jd
d��fdd
�tt	�j�d	dd�D��d7_|�r��jdt�|�7_|�r��jdt�|�7_t��j�d�_�jdt��j�7_z(t��j�j��_�j�_�jj�_Wn0t j!k
�r0tjd�jtdd��YnXt"���_#d�j#�_$d�_%d�_&dS)Nz$quoteChar cannot be the empty stringr�r$z'endQuoteChar cannot be the empty stringrz%s(?:[^%s%s]r�z%s(?:[^%s\n\r%s]r�z|(?:z)|(?:c3s4|],}dt��jd|��t�j|�fVqdS)z%s[^%s]N)r�r��endQuoteCharr�rWr�rrr��
s��z(QuotedString.__init__.<locals>.<genexpr>r��)z|(?:%s)z|(?:%s.)z(.)z)*%sr�r�FT)'rQr8r�r�r(r)r*r��	quoteCharr��quoteCharLen�firstQuoteCharr��endQuoteCharLen�escChar�escQuote�unquoteResults�convertWhitespaceEscapesr��	MULTILINE�DOTALLr�r�r�r�r�r�escCharReplacePatternr�r�rsr�r�r�r�rr�r�r�)r�r�r�r�Z	multiliner�r�r�rTr�rr�Z
sv


�
�����
zQuotedString.__init__c	Cs�|||jkr|�||�pd}|s2t|||j|��|��}|��}|jr�||j|j�}t	|t
�r�d|kr�|jr�ddddd�}|��D]\}}|�
||�}q�|jr�t�|jd|�}|jr�|�
|j|j�}||fS)Nr��	r���
)�\tr\z\fz\rz\g<1>)r�r�r2r�r�r�r�r�r�r�rr�r!r�r�r�rr�r�r�)	r�r�r�r�rfr�Zws_mapZwslitZwscharrrrr��
s*
�zQuotedString.parseImplcsHztt|���WStk
r$YnX|jdkrBd|j|jf|_|jS)Nz.quoted string, starting with %s ending with %s)rQr8r�rr�r�r�r�rTrrr��
s
zQuotedString.__str__)NNFTNT)Tr�rrrTrr83
s&�A
#cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
ra�Token for matching words composed of characters *not* in a given
    set (will include whitespace in matched characters if not listed in
    the provided exclusion set - see example). Defined with string
    containing all disallowed characters, and an optional minimum,
    maximum, and/or exact length.  The default value for ``min`` is
    1 (a minimum value < 1 is not valid); the default values for
    ``max`` and ``exact`` are 0, meaning no maximum or exact
    length restriction.

    Example::

        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))

    prints::

        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    r�rcs�tt|���d|_||_|dkr*td��||_|dkr@||_nt|_|dkrZ||_||_t	|�|_
d|j
|_|jdk|_d|_
dS)NFr�zfcannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permittedrr�)rQrr�r��notCharsr5r�r�rhr�rr�r�r�)r�r�r�r�r�rTrrr��
s 
zCharsNotIn.__init__TcCs�|||jkrt|||j|��|}|d7}|j}t||jt|��}||krb|||krb|d7}qD|||jkr�t|||j|��||||�fSr�)r�r2r�r�r�r�r�)r�r�r�r�r�Znotchars�maxlenrrrr��
s
zCharsNotIn.parseImplcsfztt|���WStk
r$YnX|jdkr`t|j�dkrTd|jdd�|_nd|j|_|jS)Nr�z
!W:(%s...)z!W:(%s))rQrr�rr�r�r�r�rTrrr�s
zCharsNotIn.__str__)r�rr)Tr�rrrTrr�
s
cs`eZdZdZdddddddd	d
ddd
dddddddddddd�Zd"�fdd�	Zd#d d!�Z�ZS)$rAa�Special matching class for matching whitespace.  Normally,
    whitespace is ignored by pyparsing grammars.  This class is included
    when some whitespace structures are significant.  Define with
    a string containing the whitespace characters to be matched; default
    is ``" \t\r\n"``.  Also takes optional ``min``,
    ``max``, and ``exact`` arguments, as defined for the
    :class:`Word` class.
    z<SP>z<TAB>z<LF>z<CR>z<FF>z<NBSP>z<OGHAM_SPACE_MARK>z<MONGOLIAN_VOWEL_SEPARATOR>z	<EN_QUAD>z	<EM_QUAD>z
<EN_SPACE>z
<EM_SPACE>z<THREE-PER-EM_SPACE>z<FOUR-PER-EM_SPACE>z<SIX-PER-EM_SPACE>z<FIGURE_SPACE>z<PUNCTUATION_SPACE>z<THIN_SPACE>z<HAIR_SPACE>z<ZERO_WIDTH_SPACE>z<NNBSP>z<MMSP>z<IDEOGRAPHIC_SPACE>)r�r�r�r�r�zuA0zu80zu80Euu€0uu€1uu€2uu€3uu€4uu€5uu€6uu€7uu€8uu€9uu€Auu€Buu‚Fuu…FuuÀ0� 	
r�rcs�tt����|�_��d��fdd��jD���d�dd��jD���_d�_d�j�_	|�_
|dkrt|�_nt�_|dkr�|�_|�_
dS)Nr�c3s|]}|�jkr|VqdSr�)�
matchWhiter�r�rrr�:s
z!White.__init__.<locals>.<genexpr>css|]}tj|VqdSr�)rA�	whiteStrsr�rrrr�<sTr�r)
rQrAr�r�rDr�r�rr�r�r�r�rh)r�Zwsr�r�r�rTr�rr�7s zWhite.__init__TcCs�|||jkrt|||j|��|}|d7}||j}t|t|��}||krb|||jkrb|d7}qB|||jkr�t|||j|��||||�fSr�)r�r2r�r�r�r�r�)r�r�r�r�r�r�rrrr�Ks

zWhite.parseImpl)r�r�rr)T)rrrr�r�r�r�rirrrTrrAs6	�cseZdZ�fdd�Z�ZS)�_PositionTokencs(tt|���|jj|_d|_d|_dSr�)rQr�r�r�rrr�r�r�rTrrr�\s
z_PositionToken.__init__�rrrr�rirrrTrr�[sr�cs2eZdZdZ�fdd�Zdd�Zd	dd�Z�ZS)
r"zaToken to advance to a specific column of input text; useful for
    tabular report scraping.
    cstt|���||_dSr�)rQr"r�rM)r��colnorTrrr�fszGoToColumn.__init__cCs\t||�|jkrXt|�}|jr*|�||�}||krX||��rXt||�|jkrX|d7}q*|Sr�)rMr�r�r��isspace)r�r�r�r�rrrr�js$
zGoToColumn.preParseTcCsDt||�}||jkr"t||d|��||j|}|||�}||fS)NzText not in expected column�rMr2)r�r�r�r�ZthiscolZnewlocr�rrrr�ss

zGoToColumn.parseImpl)T)rrrr�r�r�r�rirrrTrr"bs	cs*eZdZdZ�fdd�Zddd�Z�ZS)r&a�Matches if current position is at the beginning of a line within
    the parse string

    Example::

        test = '''\
        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)

    prints::

        ['AAA', ' this line']
        ['AAA', ' and this line']

    cstt|���d|_dS)NzExpected start of line)rQr&r�r�r�rTrrr��szLineStart.__init__TcCs*t||�dkr|gfSt|||j|��dSr�)rMr2r�r�rrrr��szLineStart.parseImpl)TrqrrrTrr&|scs*eZdZdZ�fdd�Zddd�Z�ZS)r%zTMatches if current position is at the end of a line within the
    parse string
    cs,tt|���|�tj�dd��d|_dS)Nr�r�zExpected end of line)rQr%r�rDr7r�r�r�r�rTrrr��szLineEnd.__init__TcCsb|t|�kr6||dkr$|ddfSt|||j|��n(|t|�krN|dgfSt|||j|��dS)Nr�r��r�r2r�r�rrrr��szLineEnd.parseImpl)TrqrrrTrr%�scs*eZdZdZ�fdd�Zddd�Z�ZS)r=zLMatches if current position is at the beginning of the parse
    string
    cstt|���d|_dS)NzExpected start of text)rQr=r�r�r�rTrrr��szStringStart.__init__TcCs0|dkr(||�|d�kr(t|||j|��|gfSr�)r�r2r�r�rrrr��szStringStart.parseImpl)TrqrrrTrr=�scs*eZdZdZ�fdd�Zddd�Z�ZS)r<zBMatches if current position is at the end of the parse string
    cstt|���d|_dS)NzExpected end of text)rQr<r�r�r�rTrrr��szStringEnd.__init__TcCs^|t|�krt|||j|��n<|t|�kr6|dgfS|t|�krJ|gfSt|||j|��dSr�r�r�rrrr��szStringEnd.parseImpl)TrqrrrTrr<�scs.eZdZdZef�fdd�	Zddd�Z�ZS)rDayMatches if the current position is at the beginning of a Word,
    and is not preceded by any character in a given set of
    ``wordChars`` (default= ``printables``). To emulate the
    ```` behavior of regular expressions, use
    ``WordStart(alphanums)``. ``WordStart`` will also match at
    the beginning of the string being parsed, or at the beginning of
    a line.
    cs"tt|���t|�|_d|_dS)NzNot at the start of a word)rQrDr�r��	wordCharsr��r�r�rTrrr��s
zWordStart.__init__TcCs@|dkr8||d|jks(|||jkr8t|||j|��|gfSr)r�r2r�r�rrrr��s�zWordStart.parseImpl)T�rrrr�rjr�r�rirrrTrrD�scs.eZdZdZef�fdd�	Zddd�Z�ZS)rCa_Matches if the current position is at the end of a Word, and is
    not followed by any character in a given set of ``wordChars``
    (default= ``printables``). To emulate the ```` behavior of
    regular expressions, use ``WordEnd(alphanums)``. ``WordEnd``
    will also match at the end of the string being parsed, or at the end
    of a line.
    cs(tt|���t|�|_d|_d|_dS)NFzNot at the end of a word)rQrCr�r�r�r�r�r�rTrrr��s
zWordEnd.__init__TcCsPt|�}|dkrH||krH|||jks8||d|jkrHt|||j|��|gfSr)r�r�r2r�)r�r�r�r�r�rrrr��s�zWordEnd.parseImpl)Tr�rrrTrrC�scszeZdZdZd�fdd�	Zdd�Zdd�Z�fd	d
�Z�fdd�Z�fd
d�Z	ddd�Z
�fdd�Zd�fdd�	Z�Z
S)r3z]Abstract subclass of ParserElement, for combining and
    post-processing parsed tokens.
    Fcs�tt���|�t|t�r"t|�}t|t�r<��|�g�_n�t|t	�rP|g�_nnt|t
�r�t|�}tdd�|D��r��fdd�|D�}t|��_n,zt|��_Wntk
r�|g�_YnXd�_
dS)Ncss|]}t|t�VqdSr�)r�r)r�r�rrrr�sz+ParseExpression.__init__.<locals>.<genexpr>c3s&|]}t|t�r��|�n|VqdSr�)r�rr��r�r�r�rrr�sF)rQr3r�r�r
rrr��exprsr7r	rvrr��r�r�r�rTr�rr��s"




zParseExpression.__init__cCs|j�|�d|_|Sr�)r�r�r�rSrrrr�szParseExpression.appendcCs0d|_dd�|jD�|_|jD]}|��q|S)z�Extends ``leaveWhitespace`` defined in base class, and also invokes ``leaveWhitespace`` on
           all contained expressions.FcSsg|]}|���qSrrHr�rrrrsz3ParseExpression.leaveWhitespace.<locals>.<listcomp>)r�r�rC)r�r�rrrrCs


zParseExpression.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jD]}|�|jd�q*n,tt|��|�|jD]}|�|jd�qX|Sr.)r�r>r�rQr3rFr�)r�rJr�rTrrrF#s



zParseExpression.ignorecsNztt|���WStk
r$YnX|jdkrHd|jjt|j�f|_|jS�Nz%s:(%s))	rQr3r�rr�r�rr�r�r�rTrrr�/s
zParseExpression.__str__cs*tt|���|jD]}|��qt|j�dk�r|jd}t||j�r�|js�|jdkr�|j	s�|jdd�|jdg|_d|_
|j|jO_|j|jO_|jd}t||j��r|j�s|jdk�r|j	�s|jdd�|jdd�|_d|_
|j|jO_|j|jO_dt
|�|_|S)Nr�rr�r�r�)rQr3rr�r�r�r�r�r�r�r�r�r�r�r�)r�r�rJrTrrr9s<


���
���zParseExpression.streamlineNcCsB|dk	r|ngdd�|g}|jD]}|�|�q$|�g�dSr�)r�rKrI)r�rJ�tmpr�rrrrK[s
zParseExpression.validatecs$tt|���}dd�|jD�|_|S)NcSsg|]}|���qSrrHr�rrrrcsz(ParseExpression.copy.<locals>.<listcomp>)rQr3rIr�rcrTrrrIaszParseExpression.copycsVtjrD|jD]6}t|t�r|jrtjd�d|t	|�j
|j�dd�qtt|��
||�S)N�]{0}: setting results name {1!r} on {2} expression collides with {3!r} on contained expression�)warn_ungrouped_named_tokens_in_collectionr�r$)rr�r�r�r7r�r(r)r�r�rrQr3r��r�rr�r�rTrrr�fs
��zParseExpression._setResultsName)F)N)F)rrrr�r�r�rCrFr�rrKrIr�rirrrTrr3�s	
"
cs`eZdZdZGdd�de�Zd�fdd�	Z�fdd�Zdd	d
�Zdd�Z	d
d�Z
dd�Z�ZS)ra
    Requires all given :class:`ParseExpression` s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the ``'+'`` operator.
    May also be constructed using the ``'-'`` operator, which will
    suppress backtracking.

    Example::

        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"), name_expr("name"), integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    cseZdZ�fdd�Z�ZS)zAnd._ErrorStopcs&ttj|�j||�d|_|��dS)N�-)rQrr,r�rrCryrTrrr��szAnd._ErrorStop.__init__r�rrrTrr,�sr,Tcs�|r�t|kr�g}t|�D]`\}}|tkrn|t|�dkrdt�||djd}|�t|�d��qxtd��q|�|�q||dd�<tt	|��
||�tdd�|jD��|_|�
|jdj�|jdj|_d|_dS)	Nr�r�r+z0cannot construct And with sequence ending in ...css|]}|jVqdSr��r�r�rrrr��szAnd.__init__.<locals>.<genexpr>rT)r&r�r�rr�r�r;rrQrr�r�r�rDr�r�r�)r�r�r�r�r�r�Z
skipto_argrTrrr��s
zAnd.__init__cs�|jr�tdd�|jdd�D��r�t|jdd��D]^\}}|dkrFq4t|t�r4|jr4t|jdt�r4|jd|j|d|jd<d|j|d<q4dd�|jD�|_tt|���t	dd�|jD��|_
|S)Ncss.|]&}t|t�o$|jo$t|jdt�VqdS�r�N)r�r3r�r'r�rrrr��s�z!And.streamline.<locals>.<genexpr>r�r�cSsg|]}|dk	r|�qSr�rr�rrrr�sz"And.streamline.<locals>.<listcomp>css|]}|jVqdSr�r�r�rrrr��s)r�rvr�r�r3r'rQrrr�r�)r�r�r�rTrrr�s$�
��zAnd.streamlinec	Cs�|jdj|||dd�\}}d}|jdd�D]�}t|tj�rDd}q.|r�z|�|||�\}}Wq�tk
rt�Yq�tk
r�}zd|_t�|��W5d}~XYq�t	k
r�t|t
|�|j|��Yq�Xn|�|||�\}}|s�|��r.||7}q.||fS)NrFrr�T)
r�r�r�rr,r6r0r�r�rr�r�r;)	r�r�r�r��
resultlistZ	errorStopr�Z
exprtokensr�rrrr��s(
z
And.parseImplcCst|t�r|�|�}|�|�Sr��r�rr�r�rSrrrrD�s

zAnd.__iadd__cCs6|dd�|g}|jD]}|�|�|jsq2qdSr�)r�rIr��r�r��subRecCheckListr�rrrrI�s


zAnd.checkRecursioncCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�{r�css|]}t|�VqdSr�r�r�rrrr��szAnd.__str__.<locals>.<genexpr>�}�r1rr�r�r�r�rrrr��s


 zAnd.__str__)T)T)
rrrr�rr,r�rr�rDrIr�rirrrTrrts
cs^eZdZdZd�fdd�	Z�fdd�Zddd	�Zd
d�Zdd
�Zdd�Z	d�fdd�	Z
�ZS)r/a�Requires that at least one :class:`ParseExpression` is found. If
    two expressions match, the expression that matches the longest
    string will be used. May be constructed using the ``'^'``
    operator.

    Example::

        # construct Or using '^' operator

        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))

    prints::

        [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�rrrr��szOr.__init__.<locals>.<genexpr>T)rQr/r�r�rvr�r�rTrrr��szOr.__init__cs.tt|���tjr*tdd�|jD��|_|S)Ncss|]}|jVqdSr��r�r�rrrr��sz Or.streamline.<locals>.<genexpr>)rQr/rr�collect_all_And_tokensrvr�r�r�rTrrr�sz
Or.streamlineTcCs�d}d}g}|jD]�}z|�||�}Wnvtk
rb}	zd|	_|	j|krR|	}|	j}W5d}	~	XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqX|�||f�q|�r�|j	t
d�dd�|s�|dd}
|
�|||�Sd}|D]�\}}
||dk�r
|Sz|
�|||�\}}Wn@tk
�r`}	z d|	_|	j|k�rP|	}|	j}W5d}	~	XYq�X||k�rx||fS||dkr�||f}q�|dk�r�|S|dk	�r�|j|_|�nt||d|��dS)Nr�rT)r@r r�r�� no defined alternatives to match)
r�r�r2r�r�rr�r�r��sortrr�r�)r�r�r�r��	maxExcLoc�maxExceptionrr�Zloc2r�Z	best_exprZlongestZloc1Zexpr1r�rrrr��sT





zOr.parseImplcCst|t�r|�|�}|�|�Sr�r�rSrrr�__ixor__;s

zOr.__ixor__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nrr�z ^ css|]}t|�VqdSr�r�r�rrrr�EszOr.__str__.<locals>.<genexpr>r�r�r�rrrr�@s


 z
Or.__str__cCs,|dd�|g}|jD]}|�|�qdSr��r�rIr�rrrrIIs
zOr.checkRecursioncsPtjs>tjr>tdd�|jD��r>tjd�d|t	|�j
�dd�tt|��
||�S)Ncss|]}t|t�VqdSr��r�rr�rrrr�Qsz%Or._setResultsName.<locals>.<genexpr>��{0}: setting results name {1!r} on {2} expression may only return a single token for an And alternative, in future will return the full list of tokens�)warn_multiple_tokens_in_named_alternationr�r$)rr�rr�rvr�r(r)r�r�rrQr/r�r�rTrrr�Ns���zOr._setResultsName)F)T)F)rrrr�r�rr�r�r�rIr�rirrrTrr/�s
=	cs^eZdZdZd�fdd�	Z�fdd�Zddd	�Zd
d�Zdd
�Zdd�Z	d�fdd�	Z
�ZS)r)a�Requires that at least one :class:`ParseExpression` is found. If
    two expressions match, the first one listed is the one that will
    match. May be constructed using the ``'|'`` operator.

    Example::

        # construct MatchFirst using '|' operator

        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�rrrr�osz&MatchFirst.__init__.<locals>.<genexpr>T)rQr)r�r�rvr�r�rTrrr�lszMatchFirst.__init__cs.tt|���tjr*tdd�|jD��|_|S)Ncss|]}|jVqdSr�r�r�rrrr�vsz(MatchFirst.streamline.<locals>.<genexpr>)rQr)rrr�rvr�r�r�rTrrrsszMatchFirst.streamlineTc	Cs�d}d}|jD]�}z|�|||�}|WStk
r`}z|j|krP|}|j}W5d}~XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqXq|dk	r�|j|_|�nt||d|��dS)Nr�r�)r�r�r2r�rr�r�r�)	r�r�r�r�r�r�r�r�r�rrrr�ys$


zMatchFirst.parseImplcCst|t�r|�|�}|�|�Sr�r�rSrrr�__ior__�s

zMatchFirst.__ior__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nrr�� | css|]}t|�VqdSr�r�r�rrrr��sz%MatchFirst.__str__.<locals>.<genexpr>r�r�r�rrrr��s


 zMatchFirst.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�rrrrI�s
zMatchFirst.checkRecursioncsPtjs>tjr>tdd�|jD��r>tjd�d|t	|�j
�dd�tt|��
||�S)Ncss|]}t|t�VqdSr�r�r�rrrr��sz-MatchFirst._setResultsName.<locals>.<genexpr>r�r�r�r$)rr�rr�rvr�r(r)r�r�rrQr)r�r�rTrrr��s���zMatchFirst._setResultsName)F)T)F)rrrr�r�rr�r�r�rIr�rirrrTrr)[s
	csHeZdZdZd
�fdd�	Z�fdd�Zddd�Zd	d
�Zdd�Z�Z	S)rasRequires all given :class:`ParseExpression` s to be found, but in
    any order. Expressions may be separated by whitespace.

    May be constructed using the ``'&'`` operator.

    Example::

        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )

    prints::

        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    Tcs>tt|��||�tdd�|jD��|_d|_d|_d|_dS)Ncss|]}|jVqdSr�r�r�rrrr��sz Each.__init__.<locals>.<genexpr>T)	rQrr�r�r�r�r��initExprGroupsr�r�rTrrr��s
z
Each.__init__cs(tt|���tdd�|jD��|_|S)Ncss|]}|jVqdSr�r�r�rrrr��sz"Each.streamline.<locals>.<genexpr>)rQrrr�r�r�r�rTrrr�szEach.streamlinec	s�|jr�tdd�|jD��|_dd�|jD�}dd�|jD�}|||_dd�|jD�|_dd�|jD�|_dd�|jD�|_|j|j7_d	|_|}|jdd�}|jdd��g}d
}	|	�rj|�|j|j}
g}|
D]v}z|�||�}Wn t	k
�r|�
|�Yq�X|�
|j�t|�|��||k�r@|�
|�q�|�kr܈�
|�q�t|�t|
�kr�d	}	q�|�r�d�dd�|D��}
t	||d
|
��|�fdd�|jD�7}g}|D]"}|�|||�\}}|�
|��q�t|tg��}||fS)Ncss&|]}t|t�rt|j�|fVqdSr�)r�r.rVr�r�rrrr��s
z!Each.parseImpl.<locals>.<genexpr>cSsg|]}t|t�r|j�qSr�r�r.r�r�rrrr�s
z"Each.parseImpl.<locals>.<listcomp>cSs g|]}|jrt|t�s|�qSr)r�r�r.r�rrrr�s
cSsg|]}t|t�r|j�qSr)r�rEr�r�rrrr�s
cSsg|]}t|t�r|j�qSr)r�r,r�r�rrrr�s
cSs g|]}t|tttf�s|�qSr)r�r.rEr,r�rrrr�sFTrVcss|]}t|�VqdSr�r�r�rrrr�sz*Missing one or more required elements (%s)cs$g|]}t|t�r|j�kr|�qSrr�r��ZtmpOptrrrs

)r�rr�Zopt1mapZ	optionalsZmultioptionalsZ
multirequiredZrequiredr�r2r�r�rV�remover�r�r��sumr5)r�r�r�r�Zopt1Zopt2ZtmpLocZtmpReqdZ
matchOrderZkeepMatchingZtmpExprsZfailedr�Zmissingr�r�ZfinalResultsrr�rr��sP

zEach.parseImplcCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nrr�z & css|]}t|�VqdSr�r�r�rrrr�,szEach.__str__.<locals>.<genexpr>r�r�r�rrrr�'s


 zEach.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�rrrrI0s
zEach.checkRecursion)T)T)
rrrr�r�rr�r�rIrirrrTrr�s8
1	csjeZdZdZd�fdd�	Zddd�Zdd	�Z�fd
d�Z�fdd
�Zdd�Z	ddd�Z
�fdd�Z�ZS)r1zfAbstract subclass of :class:`ParserElement`, for combining and
    post-processing parsed tokens.
    Fcs�tt|��|�t|t�r@t|jt�r2|�|�}n|�t|��}||_	d|_
|dk	r�|j|_|j|_|�
|j�|j|_|j|_|j|_|j�|j�dSr�)rQr1r�r�r�
issubclassr�r?r'r�r�r�r�rDr�r�r�r�r�rE�r�r�r�rTrrr�:s
zParseElementEnhance.__init__TcCs2|jdk	r|jj|||dd�Std||j|��dS)NFrr�)r�r�r2r�r�rrrr�Ls
zParseElementEnhance.parseImplcCs*d|_|j��|_|jdk	r&|j��|Sr~)r�r�rIrCr�rrrrCRs


z#ParseElementEnhance.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jdk	rn|j�|jd�n,tt|��|�|jdk	rn|j�|jd�|Sr.)r�r>r�rQr1rFr�rSrTrrrFYs



zParseElementEnhance.ignorecs&tt|���|jdk	r"|j��|Sr�)rQr1rr�r�rTrrres

zParseElementEnhance.streamlinecCsB||krt||g��|dd�|g}|jdk	r>|j�|�dSr�)r9r�rI)r�r�r�rrrrIks

z"ParseElementEnhance.checkRecursionNcCsB|dkrg}|dd�|g}|jdk	r4|j�|�|�g�dSr��r�rKrI�r�rJr�rrrrKrs
zParseElementEnhance.validatecsXztt|���WStk
r$YnX|jdkrR|jdk	rRd|jjt|j�f|_|jSr�)	rQr1r�rr�r�r�rr�r�rTrrr�zszParseElementEnhance.__str__)F)T)N)
rrrr�r�r�rCrFrrIrKr�rirrrTrr16s

cs*eZdZdZ�fdd�Zddd�Z�ZS)r abLookahead matching of the given parse expression.
    ``FollowedBy`` does *not* advance the parsing position within
    the input string, it only verifies that the specified parse
    expression matches at the current position.  ``FollowedBy``
    always returns a null token list. If any results names are defined
    in the lookahead expression, those *will* be returned for access by
    name.

    Example::

        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))

        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()

    prints::

        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    cstt|��|�d|_dSr�)rQr r�r��r�r�rTrrr��szFollowedBy.__init__TcCs(|jj|||d�\}}|dd�=||fS)Nr�)r�r�)r�r�r�r��_r�rrrr��s
zFollowedBy.parseImpl)TrqrrrTrr �scs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r(apLookbehind matching of the given parse expression.
    ``PrecededBy`` does not advance the parsing position within the
    input string, it only verifies that the specified parse expression
    matches prior to the current position.  ``PrecededBy`` always
    returns a null token list, but if a results name is defined on the
    given expression, it is returned.

    Parameters:

     - expr - expression that must match prior to the current parse
       location
     - retreat - (default= ``None``) - (int) maximum number of characters
       to lookbehind prior to the current parse location

    If the lookbehind expression is a string, Literal, Keyword, or
    a Word or CharsNotIn with a specified exact or maximum length, then
    the retreat parameter is not required. Otherwise, retreat must be
    specified to give a maximum number of characters to look back from
    the current parse position for a lookbehind match.

    Example::

        # VB-style variable names with type prefixes
        int_var = PrecededBy("#") + pyparsing_common.identifier
        str_var = PrecededBy("$") + pyparsing_common.identifier

    Ncs�tt|��|�|����|_d|_d|_d|_t|t	�rJt
|�}d|_nVt|ttf�rf|j
}d|_n:t|ttf�r�|jtkr�|j}d|_nt|t�r�d}d|_||_dt	|�|_d|_dS)NTFrznot preceded by )rQr(r�r�rCr�r�r�r�r�r�r'r$rtrBrr�rhr��retreatr�r�)r�r�rrTrrr��s(

zPrecededBy.__init__rTcCs�|jr<||jkrt|||j��||j}|j�||�\}}n�|jt�}|d|�}t|||j�}	tdt||jd��D]H}
z|�|||
�\}}Wn&t	k
r�}z|}	W5d}~XYqxXq�qx|	�|dd�=||fSr�)
r�rr2r�r�r�r<rr�r0)r�r�r�r�r�rr�Z	test_exprZinstring_sliceZ	last_exprrMZpberrrr��s"


zPrecededBy.parseImpl)N)rTrqrrrTrr(�scs2eZdZdZ�fdd�Zd	dd�Zdd�Z�ZS)
r+a�Lookahead to disallow matching with the given parse expression.
    ``NotAny`` does *not* advance the parsing position within the
    input string, it only verifies that the specified parse expression
    does *not* match at the current position.  Also, ``NotAny`` does
    *not* skip over leading whitespace. ``NotAny`` always returns
    a null token list.  May be constructed using the '~' operator.

    Example::

        AND, OR, NOT = map(CaselessKeyword, "AND OR NOT".split())

        # take care not to mistake keywords for identifiers
        ident = ~(AND | OR | NOT) + Word(alphas)
        boolean_term = Optional(NOT) + ident

        # very crude boolean expression - to support parenthesis groups and
        # operation hierarchy, use infixNotation
        boolean_expr = boolean_term + ZeroOrMore((AND | OR) + boolean_term)

        # integers that are followed by "." are actually floats
        integer = Word(nums) + ~Char(".")
    cs0tt|��|�d|_d|_dt|j�|_dS)NFTzFound unwanted token, )rQr+r�r�r�r�r�r�rrTrrr�
szNotAny.__init__TcCs&|j�||�rt|||j|��|gfSr�)r�r�r2r�r�rrrr�szNotAny.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nrz~{r��r1rr�r�r�r�rrrr�s


zNotAny.__str__)Tr�rrrTrr+�s
cs>eZdZd�fdd�	Zdd�Zd
dd�Zd�fd
d�	Z�ZS)�_MultipleMatchNcs<tt|��|�d|_|}t|t�r.|�|�}|�|�dSr�)rQrr�r�r�rr��stopOn)r�r�r�enderrTrrr� s

z_MultipleMatch.__init__cCs,t|t�r|�|�}|dk	r"|nd|_|Sr�)r�rr��	not_ender)r�rrrrr(s

z_MultipleMatch.stopOnTc	Cs�|jj}|j}|jdk	}|r$|jj}|r2|||�||||dd�\}}zV|j}	|r`|||�|	rp|||�}
n|}
|||
|�\}}|s�|��rR||7}qRWnttfk
r�YnX||fS�NFr)	r�r�r�r	r�r�r;r2r)r�r�r�r�Zself_expr_parseZself_skip_ignorablesZcheck_enderZ
try_not_enderr�ZhasIgnoreExprsr�Z	tmptokensrrrr�.s*



z_MultipleMatch.parseImplFcsftjrT|jgt|jdg�D]6}t|t�r|jrtjd�	d|t
|�j|j�dd�qtt
|��||�S)Nr�r�r�r�r$)rr�r�r�r�r7r�r(r)r�r�rrQrr�r�rTrrr�Ks��z_MultipleMatch._setResultsName)N)T)F)rrrr�rr�r�rirrrTrrs
rc@seZdZdZdd�ZdS)r,ajRepetition of one or more of the given expression.

    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default= ``None``) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition
          expression)

    Example::

        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]

        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    cCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nrr�z}...rr�rrrr�ss


zOneOrMore.__str__N)rrrr�r�rrrrr,Yscs8eZdZdZd
�fdd�	Zd�fdd�	Zdd	�Z�ZS)rEakOptional repetition of zero or more of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default= ``None``) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition
          expression)

    Example: similar to :class:`OneOrMore`
    Ncstt|�j||d�d|_dS)N)rT)rQrEr�r�)r�r�rrTrrr��szZeroOrMore.__init__Tc	s<ztt|��|||�WSttfk
r6|gfYSXdSr�)rQrEr�r2rr�rTrrr��szZeroOrMore.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)NrrU�]...rr�rrrr��s


zZeroOrMore.__str__)N)Tr�rrrTrrE|s
c@s eZdZdd�ZeZdd�ZdS)�
_NullTokencCsdSr~rr�rrrr*�sz_NullToken.__bool__cCsdSr�rr�rrrr��sz_NullToken.__str__N)rrrr*r�r�rrrrr�srcs<eZdZdZe�Zef�fdd�	Zd	dd�Zdd�Z�Z	S)
r.aGOptional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::

        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345

            # ZIP+4 form
            12101-0001

            # invalid ZIP
            98765-
            ''')

    prints::

        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    cs.tt|�j|dd�|jj|_||_d|_dS)NFroT)rQr.r�r�r�rAr�)r�r�r<rTrrr��s
zOptional.__init__Tc	Cs|z|jj|||dd�\}}WnVttfk
rr|j|jk	rj|jjr`t|jg�}|j||jj<qn|jg}ng}YnX||fSr
)r�r�r2rrA�_Optional__optionalNotMatchedr�r5)r�r�r�r�r�rrrr��s

zOptional.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)NrrUrXrr�rrrr��s


zOptional.__str__)T)
rrrr�rr
r�r�r�rirrrTrr.�s
$
cs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r;a�	Token for skipping over all undefined text until the matched
    expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default= ``False``) if True, the target expression is also parsed
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default= ``None``) used to define grammars (typically quoted strings and
          comments) that might contain false matches to the target expression
     - failOn - (default= ``None``) define expressions that are not allowed to be
          included in the skipped test; if found before the target expression is found,
          the SkipTo is not a match

    Example::

        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP
                      + string_data("sev") + SEP
                      + string_data("desc") + SEP
                      + integer("days_open"))

        for tkt in ticket_expr.searchString(report):
            print tkt.dump()

    prints::

        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    FNcs`tt|��|�||_d|_d|_||_d|_t|t	�rF|�
|�|_n||_dt|j
�|_dS)NTFzNo match found for )rQr;r��
ignoreExprr�r��includeMatchr�r�rr��failOnr�r�r�)r�rJZincluderFrrTrrr� s
zSkipTo.__init__Tc	Cs&|}t|�}|j}|jj}|jdk	r,|jjnd}|jdk	rB|jjnd}	|}
|
|kr�|dk	rf|||
�rfq�|	dk	r�z|	||
�}
Wqntk
r�Yq�YqnXqnz|||
ddd�Wq�tt	fk
r�|
d7}
YqJXq�qJt|||j
|��|
}|||�}t|�}|j�r||||dd�\}}
||
7}||fS)NF)r�r�r�r)
r�r�r�rr�rr�r0r2rr�r5r)r�r�r�r�r�r�r�Z
expr_parseZself_failOn_canParseNextZself_ignoreExpr_tryParseZtmplocZskiptextZ
skipresultr�rrrr�-s:
zSkipTo.parseImpl)FNN)TrqrrrTrr;�s9
csneZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zdd
d�Z	dd�Z
�fdd�Zd�fdd�	Z�Z
S)r!a_Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the ``Forward``
    variable using the '<<' operator.

    Note: take care when assigning to ``Forward`` not to overlook
    precedence of operators.

    Specifically, '|' has a lower precedence than '<<', so that::

        fwdExpr << a | b | c

    will actually be evaluated as::

        (fwdExpr << a) | b | c

    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the ``Forward``::

        fwdExpr << (a | b | c)

    Converting to use the '<<=' operator instead will avoid this problem.

    See :class:`ParseResults.pprint` for an example of a recursive
    parser created using ``Forward``.
    Ncstt|�j|dd�dSrn)rQr!r�rSrTrrr�wszForward.__init__cCsjt|t�r|�|�}||_d|_|jj|_|jj|_|�|jj�|jj	|_	|jj
|_
|j�|jj�|Sr�)
r�rr�r�r�r�r�rDr�r�r�r�rErSrrr�
__lshift__zs





zForward.__lshift__cCs||>Sr�rrSrrr�__ilshift__�szForward.__ilshift__cCs
d|_|Sr~rBr�rrrrC�szForward.leaveWhitespacecCs$|js d|_|jdk	r |j��|Sr�)r�r�rr�rrrr�s


zForward.streamlinecCsJ|dkrg}||kr<|dd�|g}|jdk	r<|j�|�|�g�dSr�rrrrrrK�s
zForward.validatecCslt|d�r|jS|jdk	r |jSd|_d}z&|jdk	rJt|j�dd�}nd}W5|jjd||_X|jS)Nrz: ...rjz: i��None)r1rr�r�rr�r�)r�Z	retStringrrrr��s


zForward.__str__cs.|jdk	rtt|���St�}||K}|SdSr�)r�rQr!rIrcrTrrrI�s

zForward.copyFcs@tjr.|jdkr.tjd�d|t|�j�dd�tt	|��
||�S)NzR{0}: setting results name {0!r} on {1} expression that has no contained expression�warn_name_set_on_empty_Forwardr�r$)rrr�r(r)r�r�rrQr!r�r�rTrrr��s
��zForward._setResultsName)N)N)F)rrrr�r�rrrCrrKr�rIr�rirrrTrr!\s


cs"eZdZdZd�fdd�	Z�ZS)r@zW
    Abstract subclass of :class:`ParseExpression`, for converting parsed results.
    Fcstt|��|�d|_dSr~)rQr@r�r�r�rTrrr��szTokenConverter.__init__)FrprrrTrr@�scs6eZdZdZd
�fdd�	Z�fdd�Zdd	�Z�ZS)ra�Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the
    input string; this can be disabled by specifying
    ``'adjacent=False'`` in the constructor.

    Example::

        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    r�Tcs8tt|��|�|r|��||_d|_||_d|_dSr�)rQrr�rC�adjacentr��
joinStringr�)r�r�rrrTrrr��szCombine.__init__cs(|jrt�||�ntt|��|�|Sr�)rr7rFrQrrSrTrrrF�szCombine.ignorecCsP|��}|dd�=|td�|�|j��g|jd�7}|jrH|��rH|gS|SdS)Nr�)r)rIr5r�rYrr�r�r;)r�r�r�r�ZretToksrrrr��s
"zCombine.postParse)r�T)rrrr�r�rFr�rirrrTrr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)r#aConverter to return the matched tokens as a list - useful for
    returning tokens of :class:`ZeroOrMore` and :class:`OneOrMore` expressions.

    Example::

        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a, b, 100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a, b, 100"))  # -> ['fn', ['a', 'b', '100']]
    cstt|��|�d|_dSr�)rQr#r�r�rrTrrr�
szGroup.__init__cCs|gSr�rr�rrrr�szGroup.postParse�rrrr�r�r�rirrrTrr#�scs(eZdZdZ�fdd�Zdd�Z�ZS)ra?Converter to return a repetitive expression as a list, but also
    as a dictionary. Each element can also be referenced using the first
    token in the expression as its key. Useful for tabular report
    scraping when the first column can be used as a item key.

    Example::

        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))

        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())

        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())

        # access named fields as dict entries, or output as dict
        print(result['shape'])
        print(result.asDict())

    prints::

        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}

    See more examples at :class:`ParseResults` of accessing fields by results name.
    cstt|��|�d|_dSr�)rQrr�r�rrTrrr�8sz
Dict.__init__cCs�t|�D]�\}}t|�dkrq|d}t|t�r@t|d���}t|�dkr\td|�||<qt|�dkr�t|dt�s�t|d|�||<q|��}|d=t|�dks�t|t�r�|�	�r�t||�||<qt|d|�||<q|j
r�|gS|SdS)Nrr�r�r�)r�r�r�r�r�r�r�r5rIr;r�)r�r�r�r�r��tokZikeyZ	dictvaluerrrr�<s$
zDict.postParserrrrTrrs&c@s eZdZdZdd�Zdd�ZdS)r>a[Converter for ignoring the results of a parsed expression.

    Example::

        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))

    prints::

        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']

    (See also :class:`delimitedList`.)
    cCsgSr�rr�rrrr�kszSuppress.postParsecCs|Sr�rr�rrrrAnszSuppress.suppressN)rrrr�r�rArrrrr>Usc@s(eZdZdZdd�Zdd�Zdd�ZdS)	r-zDWrapper for parse actions, to ensure they are only called once.
    cCst|�|_d|_dSr~)r�r��called)r�Z
methodCallrrrr�us
zOnlyOnce.__init__cCs.|js|�|||�}d|_|St||d��dS)NTr�)rr�r2)r�r�r�r�r�rrrr@xs
zOnlyOnce.__call__cCs
d|_dSr~)rr�rrr�reset~szOnlyOnce.resetN)rrrr�r�r@rrrrrr-rscs:t����fdd�}z�j|_Wntk
r4YnX|S)aqDecorator for debugging parse actions.

    When the parse action is called, this decorator will print
    ``">> entering method-name(line:<current_source_line>, <parse_location>, <matched_tokens>)"``.
    When the parse action completes, the decorator will print
    ``"<<"`` followed by the returned value, or any exception that the parse action raised.

    Example::

        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))

    prints::

        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    c
s��j}|dd�\}}}t|�dkr8|djjd|}tj�d|t||�||f�z�|�}Wn8tk
r�}ztj�d||f��W5d}~XYnXtj�d||f�|S)Nr�r�r�.z">>entering %s(line: '%s', %d, %r)
z<<leaving %s (exception: %s)
z<<leaving %s (ret: %r)
)rr�r�r��stderrr`r[r)ZpaArgsZthisFuncr�r�r�r�r��rOrr�z�sztraceParseAction.<locals>.z)r�rr�)rOrrrrrv�s
�,cCs`t|�dt|�dt|�d}|rBt|t||���|�S|tt|�|��|�SdS)a�Helper to define a delimited list of expressions - the delimiter
    defaults to ','. By default, the list elements and delimiters can
    have intervening whitespace, and comments, but this can be
    overridden by passing ``combine=True`` in the constructor. If
    ``combine`` is set to ``True``, the matching tokens are
    returned as a single token string, with the delimiters included;
    otherwise, the matching tokens are returned as a list of tokens,
    with the delimiters suppressed.

    Example::

        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    z [r�rN)r�rrEr�r>)r�Zdelim�combineZdlNamerrrrT�s$csjt����fdd�}|dkr0tt��dd��}n|��}|�d�|j|dd�|��d	t��d
�S)a>Helper to define a counted list of expressions.

    This helper defines a pattern of the form::

        integer expr expr expr...

    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the
    leading count token is suppressed.

    If ``intExpr`` is specified, it should be a pyparsing expression
    that produces an integer value.

    Example::

        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    cs.|d}�|r tt�g|��p&tt�>gSr�)r#rrW)r�r�r�r1�Z	arrayExprr�rr�countFieldParseAction�s"z+countedArray.<locals>.countFieldParseActionNcSst|d�Sr�)r�r�rrrr��r�zcountedArray.<locals>.<lambda>ZarrayLenT�r�z(len) rj)r!rBrfr�rIr�r�r�)r�ZintExprr"rr!rrP�s
cCs6g}|D](}t|t�r&|�t|��q|�|�q|Sr�)r�rrEr r�)�Lr�r�rrrr �s
r cs6t���fdd�}|j|dd���dt|���S)a4Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks for
    a 'repeat' of a previous expression.  For example::

        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second

    will match ``"1:1"``, but not ``"1:2"``.  Because this
    matches a previous literal, will also match the leading
    ``"1:1"`` in ``"1:10"``. If this is not desired, use
    :class:`matchPreviousExpr`. Do *not* use with packrat parsing
    enabled.
    csP|rBt|�dkr�|d>qLt|���}�tdd�|D��>n
�t�>dS)Nr�rcss|]}t|�VqdSr�)r'�r�Zttrrrr�
szDmatchPreviousLiteral.<locals>.copyTokenToRepeater.<locals>.<genexpr>)r�r rrr)r�r�r�Ztflat�Zreprr�copyTokenToRepeatersz1matchPreviousLiteral.<locals>.copyTokenToRepeaterTr#�(prev) )r!r�r�r�)r�r'rr&rrc�s

csFt��|��}�|K��fdd�}|j|dd���dt|���S)aTHelper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks for
    a 'repeat' of a previous expression.  For example::

        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second

    will match ``"1:1"``, but not ``"1:2"``.  Because this
    matches by expressions, will *not* match the leading ``"1:1"``
    in ``"1:10"``; the expressions are evaluated first, and then
    compared, so ``"1"`` is compared with ``"10"``. Do *not* use
    with packrat parsing enabled.
    cs*t|�����fdd�}�j|dd�dS)Ncs$t|���}|�kr tddd��dS)Nr�r)r rr2)r�r�r�ZtheseTokens�ZmatchTokensrr�mustMatchTheseTokens%szLmatchPreviousExpr.<locals>.copyTokenToRepeater.<locals>.mustMatchTheseTokensTr#)r rr�)r�r�r�r*r&r)rr'#sz.matchPreviousExpr.<locals>.copyTokenToRepeaterTr#r()r!rIr�r�r�)r�Ze2r'rr&rrbscCs:dD]}|�|t|�}q|�dd�}|�dd�}t|�S)Nz\^-]r�r\r�r�)r��_bslashr�)r�r�rrrr�.s
r�cs�t|t�rtjddd�|r:dd�}dd�}|r4tnt�ndd�}dd�}|rRtnt�g}t|t�rn|��}n$t|t	�r�t
|�}ntjd	tdd�|s�t�S|�s.d
}|t
|�dk�r.||}t||dd��D]N\}	}
||
|�r�|||	d=q�q�|||
�r�|||	d=|�||
�q�q�|d7}q�|�s�|�s�|�r�zlt
|�t
d
�|��k�r�tdd
�dd�|D����d�|��WStd�dd�|D����d�|��WSWn&tk
�r�tjdtdd�YnXt�fdd�|D���d�|��S)a�Helper to quickly define a set of alternative Literals, and makes
    sure to do longest-first testing when there is a conflict,
    regardless of the input order, but returns
    a :class:`MatchFirst` for best performance.

    Parameters:

     - strs - a string of space-delimited literals, or a collection of
       string literals
     - caseless - (default= ``False``) - treat all literals as
       caseless
     - useRegex - (default= ``True``) - as an optimization, will
       generate a Regex object; otherwise, will generate
       a :class:`MatchFirst` object (if ``caseless=True`` or ``asKeyword=True``, or if
       creating a :class:`Regex` raises an exception)
     - asKeyword - (default=``False``) - enforce Keyword-style matching on the
       generated expressions

    Example::

        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))

    prints::

        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    z_More than one string argument passed to oneOf, pass choices as a list or space-delimited stringr�r$cSs|��|��kSr�)r~�rL�brrrr�[r�zoneOf.<locals>.<lambda>cSs|���|���Sr�)r~ryr,rrrr�\r�cSs||kSr�rr,rrrr�_r�cSs
|�|�Sr�)ryr,rrrr�`r�z6Invalid argument to oneOf, expected string or iterablerr�Nr�r�css|]}t|�VqdSr�)r��r�Zsymrrrr��szoneOf.<locals>.<genexpr>r��|css|]}t�|�VqdSr�)r�r�r.rrrr��sz7Exception creating Regex for oneOf, building MatchFirstc3s|]}�|�VqdSr�rr.�ZparseElementClassrrr��s)r�rr(r)rrr$r'r�r	rr*r*r�r�rBr�r:r�rr))Zstrsr}ZuseRegexr�ZisequalZmasksZsymbolsr�Zcurr#rJrr0rrg6s\ 
�



�


**�cCsttt||���S)a�Helper to easily and clearly define a dictionary by specifying
    the respective patterns for the key and value.  Takes care of
    defining the :class:`Dict`, :class:`ZeroOrMore`, and
    :class:`Group` tokens in the proper order.  The key pattern
    can include delimiting markers or punctuation, as long as they are
    suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the :class:`Dict` results
    can include named token fields.

    Example::

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())

        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())

    prints::

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    )rr,r#)r@r$rrrrU�s%cCs^t��dd��}|��}d|_|d�||d�}|r@dd�}ndd�}|�|�|j|_|S)	a�Helper to return the original, untokenized text for a given
    expression.  Useful to restore the parsed fields of an HTML start
    tag into the raw tag text itself, or to revert separate tokens with
    intervening whitespace back to the original matching input text. By
    default, returns astring containing the original parsed text.

    If the optional ``asString`` argument is passed as
    ``False``, then the return value is
    a :class:`ParseResults` containing any results names that
    were originally matched, and a single token containing the original
    matched text from the input string.  So if the expression passed to
    :class:`originalTextFor` contains expressions with defined
    results names, you must set ``asString`` to ``False`` if you
    want to preserve those results name values.

    Example::

        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b", "i"):
            opener, closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])

    prints::

        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    cSs|Sr�r)r�r�r�rrrr��r�z!originalTextFor.<locals>.<lambda>F�_original_start�
_original_endcSs||j|j�Sr�)r1r2r�rrrr��r�cSs&||�d�|�d��g|dd�<dS)Nr1r2)r?r�rrr�extractText�sz$originalTextFor.<locals>.extractText)rr�rIr�r�)r�ZasStringZ	locMarkerZendlocMarker�	matchExprr3rrrr{�s

cCst|��dd��S)zkHelper to undo pyparsing's default grouping of And expressions,
    even if all but one are non-empty.
    cSs|dSr�rr�rrrr��r�zungroup.<locals>.<lambda>)r@r�)r�rrrr|�scCs4t��dd��}t|d�|d�|����d��S)a�Helper to decorate a returned token with its starting and ending
    locations in the input string.

    This helper adds the following results names:

     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains ``<TAB>`` characters, you
    may want to call :class:`ParserElement.parseWithTabs`

    Example::

        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)

    prints::

        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    cSs|Sr�rr�rrrr��r�zlocatedExpr.<locals>.<lambda>Z
locn_startr$Zlocn_end)rr�r#rIrC)r�Zlocatorrrrr~�sz\[]-*.$+^?()~ �r�cCs|ddSrrr�rrrr�r�r�z\\0?[xX][0-9a-fA-F]+cCstt|d�d�d��S)Nrz\0xr�)�unichrr�rar�rrrr�	r�z	\\0[0-7]+cCstt|ddd�d��S)Nrr��)r6r�r�rrrr�
r�z\]r�rUr��negate�bodyrXcsFdd��z"d��fdd�t�|�jD��WStk
r@YdSXdS)aHelper to easily define string ranges for use in Word
    construction. Borrows syntax from regexp '[]' string range
    definitions::

        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"

    The input string must be enclosed in []'s, and the returned string
    is the expanded character set joined into a single string. The
    values enclosed in the []'s may be:

     - a single character
     - an escaped character with a leading backslash (such as ``\-``
       or ``\]``)
     - an escaped hex character with a leading ``'\x'``
       (``\x21``, which is a ``'!'`` character) (``\0x##``
       is also supported for backwards compatibility)
     - an escaped octal character with a leading ``'\0'``
       (``\041``, which is a ``'!'`` character)
     - a range of any of the above, separated by a dash (``'a-z'``,
       etc.)
     - any combination of the above (``'aeiouy'``,
       ``'a-zA-Z0-9_$'``, etc.)
    cSs<t|t�s|Sd�dd�tt|d�t|d�d�D��S)Nr�css|]}t|�VqdSr��r6r�rrrr�)sz+srange.<locals>.<lambda>.<locals>.<genexpr>rr�)r�r5r�r�ord)�prrrr�)r�zsrange.<locals>.<lambda>r�c3s|]}�|�VqdSr�r)r��part�Z	_expandedrrr�+szsrange.<locals>.<genexpr>N)r��_reBracketExprrr9rr�rr>rrss
"cs�fdd�}|S)zoHelper method for defining parse actions that require matching at
    a specific column in the input text.
    cs"t||��krt||d���dS)Nzmatched token not at column %dr�)r�Zlocnr�r0rr�	verifyCol3sz!matchOnlyAtCol.<locals>.verifyColr)r1r@rr0rra/scs�fdd�S)a�Helper method for common parse actions that simply return
    a literal value.  Especially useful when used with
    :class:`transformString<ParserElement.transformString>` ().

    Example::

        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num

        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    cs�gSr�rr��ZreplStrrrr�Er�zreplaceWith.<locals>.<lambda>rrArrArrp8s
cCs|ddd�S)aHelper parse action for removing quotation marks from parsed
    quoted strings.

    Example::

        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    rr�r�rr�rrrrnGs
csN��fdd�}zt�dt�d�j�}Wntk
rBt��}YnX||_|S)aLHelper to define a parse action by mapping a function to all
    elements of a ParseResults list. If any additional args are passed,
    they are forwarded to the given function as additional arguments
    after the token, as in
    ``hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))``,
    which will convert the parsed data to an integer using base 16.

    Example (compare the last to example in :class:`ParserElement.transformString`::

        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')

        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')

    prints::

        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    cs��fdd�|D�S)Ncsg|]}�|f����qSrr)r�Ztokn�r�r�rrr{sz(tokenMap.<locals>.pa.<locals>.<listcomp>rr�rBrrr�zsztokenMap.<locals>.parr�)r�rrr�)r�r�r�r�rrBrr�Vs$
�cCst|���Sr��r�r~r�rrrr��r�cCst|���Sr��r��lowerr�rrrr��r�rfrgcs~t|t�r|�t||d�}n|j�tttd�}|r�t���	t
�}||d�ttt
|td�|���tddgd�d��	d	d
��|}nlt���	t
�ttdd�B}||d�ttt
|�	t�ttd�|����tddgd�d��	d
d
��|}ttd�|ddd�}|�d��|��fdd
��|dd���dd��������d��}�|_�|_t|��|_||fS)zRInternal helper to construct opening and closing tag expressions, given a tag namer�z_-:�tag�=�/F�r<rWcSs|ddkS�NrrHrr�rrrr��r�z_makeTags.<locals>.<lambda>rgr�cSs|ddkSrJrr�rrrr��r�rh)rz<%s>c	s*|�dd���dd������|���S)Nr�r��:r�)rr�r��titler�rIr��Zresnamerrr��r�r�r�rKr�z</%s>)r�rr$rrBrHrGrRrIr�rnrrEr#r>r.rmrjrVr�_Lr�r�r�r�rLr�rFr;Ztag_body)�tagStrZxmlZsuppress_LTZsuppress_GTZtagAttrNameZtagAttrValueZopenTagZcloseTagrrMr�	_makeTags�sH
���������,rPcCs
t|d�S)aKHelper to construct opening and closing tag expressions for HTML,
    given a tag name. Matches tags in either upper or lower case,
    attributes with namespaces and with quoted or unquoted values.

    Example::

        text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and
        # closing tags as a 2-tuple
        a, a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end

        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are
            # also accessible as named results
            print(link.link_text, '->', link.href)

    prints::

        pyparsing -> https://github.com/pyparsing/pyparsing/wiki
    F�rP�rOrrrr_�scCs
t|d�S)z�Helper to construct opening and closing tag expressions for XML,
    given a tag name. Matches tags only in the given upper/lower case.

    Example: similar to :class:`makeHTMLTags`
    TrQrRrrrr`�scs8|r|dd��n|���dd��D���fdd�}|S)a7Helper to create a validating parse action to be used with start
    tags created with :class:`makeXMLTags` or
    :class:`makeHTMLTags`. Use ``withAttribute`` to qualify
    a starting tag with a required attribute value, to avoid false
    matches on common tags such as ``<TD>`` or ``<DIV>``.

    Call ``withAttribute`` with a series of attribute names and
    values. Specify the list of filter attributes names and values as:

     - keyword arguments, as in ``(align="right")``, or
     - as an explicit dict with ``**`` operator, when an attribute
       name is also a Python reserved word, as in ``**{"class":"Customer", "align":"right"}``
     - a list of name-value tuples, as in ``(("ns1:class", "Customer"), ("ns2:align", "right"))``

    For attribute names with a namespace prefix, you must use the second
    form.  Attribute names are matched insensitive to upper/lower case.

    If just testing for ``class`` (with or without a namespace), use
    :class:`withClass`.

    To verify that the attribute exists, but without specifying a value,
    pass ``withAttribute.ANY_VALUE`` as the value.

    Example::

        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>

        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)

        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)

    prints::

        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    NcSsg|]\}}||f�qSrrrarrrrsz!withAttribute.<locals>.<listcomp>csZ�D]P\}}||kr$t||d|��|tjkr|||krt||d||||f��qdS)Nzno matching attribute z+attribute '%s' has value '%s', must be '%s')r2ry�	ANY_VALUE)r�r�r�ZattrNameZ	attrValue�Zattrsrrr�s�zwithAttribute.<locals>.pa)r!)r�ZattrDictr�rrTrry�s8cCs|rd|nd}tf||i�S)a�Simplified version of :class:`withAttribute` when
    matching on a div class - made difficult because ``class`` is
    a reserved word in Python.

    Example::

        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>

        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))

        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)

        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)

    prints::

        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    z%s:class�class)ry)Z	classname�	namespaceZ	classattrrrrrs#�(r�cCs�Gdd�dt�}t�}||||B}t|�D�]n\}}|ddd�\}	}
}}|
dkr`d|	nd|	}
|
dkr�|	dks�t|	�d	kr�td
��|	\}}t��|
�}|tjk�rp|
dkr�|||	�t|t	|	��}n�|
d	k�r*|	dk	�r|||	|�t|t	|	|��}n|||�t|t	|��}nD|
dk�rf||||||�t|||||�}ntd��n�|tj
k�rT|
dk�r�t|	t��s�t|	�}	||	j
|�t|	|�}n�|
d	k�r|	dk	�r�|||	|�t|t	|	|��}n|||�t|t	|��}nD|
dk�rJ||||||�t|||||�}ntd��ntd
��|�r�t|ttf��r~|j|�n
|�|�||�|
�|BK}|}q.||K}|S)al
Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary
    or binary, left- or right-associative.  Parse actions can also be
    attached to operator expressions. The generated parser will also
    recognize the use of parentheses to override operator precedences
    (see example below).

    Note: if you define a deep operator list, you may see performance
    issues when using infixNotation. See
    :class:`ParserElement.enablePackrat` for a mechanism to potentially
    improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the
       nested
     - opList - list of tuples, one for each operator precedence level
       in the expression grammar; each tuple is of the form ``(opExpr,
       numTerms, rightLeftAssoc, parseAction)``, where:

       - opExpr is the pyparsing expression for the operator; may also
         be a string, which will be converted to a Literal; if numTerms
         is 3, opExpr is a tuple of two expressions, for the two
         operators separating the 3 terms
       - numTerms is the number of terms for this operator (must be 1,
         2, or 3)
       - rightLeftAssoc is the indicator whether the operator is right
         or left associative, using the pyparsing-defined constants
         ``opAssoc.RIGHT`` and ``opAssoc.LEFT``.
       - parseAction is the parse action to be associated with
         expressions matching this operator expression (the parse action
         tuple member may be omitted); if the parse action is passed
         a tuple or list of functions, this is equivalent to calling
         ``setParseAction(*fn)``
         (:class:`ParserElement.setParseAction`)
     - lpar - expression for matching left-parentheses
       (default= ``Suppress('(')``)
     - rpar - expression for matching right-parentheses
       (default= ``Suppress(')')``)

    Example::

        # simple example of four-function arithmetic with ints and
        # variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier

        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])

        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)

    prints::

        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    c@seZdZddd�ZdS)zinfixNotation.<locals>._FBTcSs|j�||�|gfSr�)r�r�r�rrrr��sz$infixNotation.<locals>._FB.parseImplN)Trzrrrr�_FB�srXr�Nr�r�z%s termz	%s%s termr�z@if numterms=3, opExpr must be a tuple or list of two expressionsr�z6operator must be unary (1), binary (2), or ternary (3)z2operator must indicate right or left associativity)r r!r�r�r5r�rh�LEFTr#r,�RIGHTr�r.r�r4rr�)ZbaseExprZopListZlparZrparrXr�ZlastExprr�ZoperDefZopExprZarityZrightLeftAssocr�ZtermNameZopExpr1ZopExpr2ZthisExprr4rrrr}Ds`H�

&
�



&
�

z4"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�"z string enclosed in double quotesz4'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�'z string enclosed in single quotesz*quotedString using single or double quotes�uzunicode string literalcCs�||krtd��|dk�r*t|t��r"t|t��r"t|�dkr�t|�dkr�|dk	r�tt|t||tjdd����	dd��}n$t
��t||tj��	dd��}nx|dk	r�tt|t|�t|�ttjdd����	dd��}n4ttt|�t|�ttjdd����	d	d��}ntd
��t
�}|dk	�rd|tt|�t||B|B�t|��K}n$|tt|�t||B�t|��K}|�d||f�|S)a�	Helper method for defining nested lists enclosed in opening and
    closing delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list
       (default= ``"("``); can also be a pyparsing expression
     - closer - closing character for a nested list
       (default= ``")"``); can also be a pyparsing expression
     - content - expression for items within the nested lists
       (default= ``None``)
     - ignoreExpr - expression for ignoring opening and closing
       delimiters (default= :class:`quotedString`)

    If an expression is not provided for the content argument, the
    nested expression will capture all whitespace-delimited content
    between delimiters as a list of separate values.

    Use the ``ignoreExpr`` argument to define expressions that may
    contain opening or closing characters that should not be treated as
    opening or closing characters for nesting, such as quotedString or
    a comment expression.  Specify multiple expressions using an
    :class:`Or` or :class:`MatchFirst`. The default is
    :class:`quotedString`, but if no expressions are to be ignored, then
    pass ``None`` for this argument.

    Example::

        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR, RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type")
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR
                      + code_body("body"))
        c_function.ignore(cStyleComment)

        source_code = '''
            int is_odd(int x) {
                return (x%2);
            }

            int dec_to_hex(char hchar) {
                if (hchar >= '0' && hchar <= '9') {
                    return (ord(hchar)-ord('0'));
                } else {
                    return (10+ord(hchar)-ord('A'));
                }
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)


    prints::

        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    z.opening and closing strings cannot be the sameNr�r5cSs|d��Sr��r�r�rrrr�r�znestedExpr.<locals>.<lambda>cSs|d��Sr�r^r�rrrr� r�cSs|d��Sr�r^r�rrrr�'r�cSs|d��Sr�r^r�rrrr�,r�zOopening and closing arguments must be strings if no content expression is givenznested %s%s expression)r5r�rr�rr,rr7r�r�rWrIr'r!r#r>rEr�)ZopenerZcloserZcontentrr�rrrrd�s`A
�����
����������
*$cs�dd����fdd���fdd�}�fdd�}�fdd	�}tt��d
����}t�t��|��d�}t��|��d�}t��|��d
�}	|r�tt|�|t|t|�t|��|	�}
n(tt|�t|t|�t|��|	�}
|
�	�fdd��|�
tt��|
�d�S)a�Helper method for defining space-delimited indentation blocks,
    such as those used to define block statements in Python source code.

    Parameters:

     - blockStatementExpr - expression defining syntax of statement that
       is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
       (multiple statementWithIndentedBlock expressions within a single
       grammar should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond
       the current level; set to False for block of left-most
       statements (default= ``True``)

    A valid block must contain at least one ``blockStatement``.

    Example::

        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group("(" + Optional(delimitedList(identifier)) + ")") + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group(funcDecl + func_body)

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << (funcDef | assignment | identifier)

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()

    prints::

        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]]
    Ncs��dd�<dSr�rr)�backup_stack�indentStackrr�reset_stack�sz"indentedBlock.<locals>.reset_stackcsN|t|�krdSt||�}|�dkrJ|�dkr>t||d��t||d��dS)Nr�zillegal nestingznot a peer entry)r�rMr2�r�r�r�ZcurCol�r`rr�checkPeerIndent�s
z&indentedBlock.<locals>.checkPeerIndentcs2t||�}|�dkr"��|�nt||d��dS)Nr�znot a subentry)rMr�r2rbrcrr�checkSubIndent�s
z%indentedBlock.<locals>.checkSubIndentcsJ|t|�krdSt||�}�r&|�ks2t||d��|�dkrF���dS)Nznot an unindentr�)r�rMr2r?rbrcrr�
checkUnindent�s
z$indentedBlock.<locals>.checkUnindentz	 �INDENTr�ZUNINDENTcs��Sr�r)rLr-r�r�)rarrr��r�zindentedBlock.<locals>.<lambda>zindented block)r,r%rDrArr�r�r#r.r�rFr+)ZblockStatementExprr`rjrdrerfrwrgZPEERZUNDENTZsmExprr)r_r`rarrz7s2Q�����z#[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]z[\0xa1-\0xbf\0xd7\0xf7]z_:zany tagzgt lt amp nbsp quot aposz><& "'z&(?P<entity>r/z);zcommon HTML entitycCst�|j�S)zRHelper parser action to replace common HTML entities with their special characters)�_htmlEntityMapr�Zentityr�rrrro�sz/\*(?:[^*]|\*(?!/))*z*/zC style commentz<!--[\s\S]*?-->zHTML commentz.*zrest of linez//(?:\\\n|[^\n])*z
// commentzC++ style commentz#.*zPython style commentr�� 	�	commaItemrIc@s�eZdZdZee�Zee�Ze	e
��d��e�Z
e	e��d��eed��Zed��d��e�Ze��e�de��e��d�Ze�d	d
��eeeed���e�B�d�Ze�e�ed
��d��e�Zed��d��e�ZeeBeB��Zed��d��e�Ze	eded��d�Zed��d�Z ed��d�Z!e!de!d�d�Z"ee!de!d�dee!de!d��d�Z#e#�$dd
��d e �d!�Z%e&e"e%Be#B�d"���d"�Z'ed#��d$�Z(e)d=d&d'��Z*e)d>d)d*��Z+ed+��d,�Z,ed-��d.�Z-ed/��d0�Z.e/��e0��BZ1e)d1d2��Z2e&e3e4d3�e5�e	e6d3d4�ee7d5�������d6�Z8e9ee:�;�e8Bd7d8���d9�Z<e)ed:d
���Z=e)ed;d
���Z>d<S)?r�aHere are some common low-level expressions that may be useful in
    jump-starting parser development:

     - numeric forms (:class:`integers<integer>`, :class:`reals<real>`,
       :class:`scientific notation<sci_real>`)
     - common :class:`programming identifiers<identifier>`
     - network addresses (:class:`MAC<mac_address>`,
       :class:`IPv4<ipv4_address>`, :class:`IPv6<ipv6_address>`)
     - ISO8601 :class:`dates<iso8601_date>` and
       :class:`datetime<iso8601_datetime>`
     - :class:`UUID<uuid>`
     - :class:`comma-separated list<comma_separated_list>`

    Parse actions:

     - :class:`convertToInteger`
     - :class:`convertToFloat`
     - :class:`convertToDate`
     - :class:`convertToDatetime`
     - :class:`stripHTMLTags`
     - :class:`upcaseTokens`
     - :class:`downcaseTokens`

    Example::

        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')

    prints::

        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    �integerzhex integerr�z[+-]?\d+zsigned integerrH�fractioncCs|d|dS)Nrr�rr�rrrr��r�zpyparsing_common.<lambda>r�z"fraction or mixed integer-fractionz[+-]?(:?\d+\.\d*|\.\d+)zreal numberz@[+-]?(:?\d+(:?[eE][+-]?\d+)|(:?\d+\.\d*|\.\d+)(:?[eE][+-]?\d+)?)z$real number with scientific notationz[+-]?\d+\.?\d*([eE][+-]?\d+)?�fnumberr�
identifierzK(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}zIPv4 addressz[0-9a-fA-F]{1,4}�hex_integerrK�zfull IPv6 address)rr�z::zshort IPv6 addresscCstdd�|D��dkS)Ncss|]}tj�|�rdVqdSrd)r��
_ipv6_partrr%rrrr��sz,pyparsing_common.<lambda>.<locals>.<genexpr>r7)r�r�rrrr��r�z::ffff:zmixed IPv6 addresszIPv6 addressz:[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}zMAC address�%Y-%m-%dcs�fdd�}|S)a�
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%d"``)

        Example::

            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))

        prints::

            [datetime.date(1999, 12, 31)]
        c
sNzt�|d����WStk
rH}zt||t|���W5d}~XYnXdSr�)r�strptime�dater5r2r��r�r�r�Zve��fmtrr�cvt_fn�sz.pyparsing_common.convertToDate.<locals>.cvt_fnr�rwrxrrvr�
convertToDate�szpyparsing_common.convertToDate�%Y-%m-%dT%H:%M:%S.%fcs�fdd�}|S)aHelper to create a parse action for converting parsed
        datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%dT%H:%M:%S.%f"``)

        Example::

            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))

        prints::

            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        c
sJzt�|d��WStk
rD}zt||t|���W5d}~XYnXdSr�)rrsr5r2r�rurvrrrx�sz2pyparsing_common.convertToDatetime.<locals>.cvt_fnrryrrvr�convertToDatetime�sz"pyparsing_common.convertToDatetimez7(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?zISO8601 datez�(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?zISO8601 datetimez2[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}�UUIDcCstj�|d�S)aParse action to remove HTML tags from web page HTML source

        Example::

            # strip HTML links from normal text
            text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
            td, td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            print(table_text.parseString(text).body)

        Prints::

            More info at the pyparsing wiki page
        r)r��_html_stripperr�)r�r�r�rrr�
stripHTMLTags�szpyparsing_common.stripHTMLTagsrr�rirjr�rIzcomma separated listcCst|���Sr�rCr�rrrr�r�cCst|���Sr�rDr�rrrr�r�N)rr)r{)?rrrr�r�r�ZconvertToInteger�floatZconvertToFloatrBrfr�r�rkrXror:Zsigned_integerrlr�r.rAZ
mixed_integerr��realZsci_realr�numberrmrHrGrnZipv4_addressrqZ_full_ipv6_addressZ_short_ipv6_addressr�Z_mixed_ipv6_addressrZipv6_addressZmac_addressr�rzr|Ziso8601_dateZiso8601_datetime�uuidrKrJr~rr,r'r%rjrA�
_commasepitemrTrmrIZcomma_separated_listrxrVrrrrr��sv""
���
�
�
��
���c@seZdZdd�Zdd�ZdS)�_lazyclasspropertycCs||_|j|_|j|_dSr�)r�r�rr�rrrr�sz_lazyclassproperty.__init__csl�dkrt|��t�d�r:t�fdd��jdd�D��r@i�_|jj}|�jkrb|����j|<�j|S)N�_internc3s |]}�jt|dg�kVqdS)r�N)r�r�)r�Z
superclassr�rrr�s�z-_lazyclassproperty.__get__.<locals>.<genexpr>r�)r�r1rv�__mro__r�r�r)r�r�r��attrnamerr�r�__get__s�
z_lazyclassproperty.__get__N)rrrr�r�rrrrr�
sr�c@sPeZdZdZgZedd��Zedd��Zedd��Z	edd	��Z
ed
d��ZdS)
r�a�
    A set of Unicode characters, for language-specific strings for
    ``alphas``, ``nums``, ``alphanums``, and ``printables``.
    A unicode_set is defined by a list of ranges in the Unicode character
    set, in a class attribute ``_ranges``, such as::

        _ranges = [(0x0020, 0x007e), (0x00a0, 0x00ff),]

    A unicode set can also be defined using multiple inheritance of other unicode sets::

        class CJK(Chinese, Japanese, Korean):
            pass
    cCsZg}|jD]8}|tkrqD|jD] }|�t|d|dd��q q
dd�tt|��D�S)Nrr�r�cSsg|]}t|��qSrr:r�rrrr4sz5unicode_set._get_chars_for_ranges.<locals>.<listcomp>)r�r��_rangesrErrtr�)r�r�ZccZrrrrr�_get_chars_for_ranges,s

 z!unicode_set._get_chars_for_rangescCsd�ttj|����S)z+all non-whitespace characters in this ranger�)r�rr�r�r�r�rrrrj6szunicode_set.printablescCsd�ttj|����S)z'all alphabetic characters in this ranger�)r��filterr��isalphar�r�rrrrH;szunicode_set.alphascCsd�ttj|����S)z*all numeric digit characters in this ranger�)r�r�r��isdigitr�r�rrrrf@szunicode_set.numscCs|j|jS)z)all alphanumeric characters in this range)rHrfr�rrrrGEszunicode_set.alphanumsN)rrrr�r�r�r�r�rjrHrfrGrrrrr�s

	


c@s�eZdZdZdejfgZGdd�de�ZGdd�de�Z	Gdd�de�Z
Gd	d
�d
e�ZGdd�de�ZGd
d�de�Z
Gdd�de�ZGdd�de�ZGdd�de
ee�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)r�zF
    A namespace class for defining common language unicode_sets.
    � c@seZdZdZddgZdS)zpyparsing_unicode.Latin1z/Unicode set for Latin-1 Unicode Character Range)r��~)��N�rrrr�r�rrrr�Latin1Qsr�c@seZdZdZdgZdS)zpyparsing_unicode.LatinAz/Unicode set for Latin-A Unicode Character Range)�iNr�rrrr�LatinAUsr�c@seZdZdZdgZdS)zpyparsing_unicode.LatinBz/Unicode set for Latin-B Unicode Character Range)i�iONr�rrrr�LatinBYsr�c@s6eZdZdZdddddddd	d
ddd
dddddgZdS)zpyparsing_unicode.Greekz.Unicode set for Greek Unicode Character Ranges)ipi�)ii)ii)i iE)iHiM)iPiW)iY)i[)i])i_i})i�i�)i�i�)i�i�)i�i�)i�i�)i�i�)i�i�Nr�rrrr�Greek]s&�r�c@seZdZdZdgZdS)zpyparsing_unicode.Cyrillicz0Unicode set for Cyrillic Unicode Character Range)ii�Nr�rrrr�Cyrillicesr�c@seZdZdZddgZdS)zpyparsing_unicode.Chinesez/Unicode set for Chinese Unicode Character Range)�Ni���i0i?0Nr�rrrr�Chineseisr�c@sDeZdZdZgZGdd�de�ZGdd�de�ZGdd�de�ZdS)	zpyparsing_unicode.Japanesez`Unicode set for Japanese Unicode Character Range, combining Kanji, Hiragana, and Katakana rangesc@seZdZdZddgZdS)z pyparsing_unicode.Japanese.Kanjiz-Unicode set for Kanji Unicode Character Range)r�i��r�Nr�rrrr�Kanjiqsr�c@seZdZdZdgZdS)z#pyparsing_unicode.Japanese.Hiraganaz0Unicode set for Hiragana Unicode Character Range)i@0i�0Nr�rrrr�Hiraganausr�c@seZdZdZdgZdS)z#pyparsing_unicode.Japanese.Katakanaz1Unicode set for Katakana  Unicode Character Range)i�0i�0Nr�rrrr�Katakanaysr�N)	rrrr�r�r�r�r�r�rrrr�Japanesems
r�c@s eZdZdZddddddgZdS)	zpyparsing_unicode.Koreanz.Unicode set for Korean Unicode Character Range)i�i��)ii�)i01i�1)i`�i�)i��i��r�Nr�rrrr�Korean}sr�c@seZdZdZdS)zpyparsing_unicode.CJKzTUnicode set for combined Chinese, Japanese, and Korean (CJK) Unicode Character RangeNr�rrrr�CJK�sr�c@seZdZdZddgZdS)zpyparsing_unicode.Thaiz,Unicode set for Thai Unicode Character Range)ii:)i?i[Nr�rrrr�Thai�sr�c@seZdZdZdddgZdS)zpyparsing_unicode.Arabicz.Unicode set for Arabic Unicode Character Range)ii)ii�)iiNr�rrrr�Arabic�sr�c@seZdZdZdgZdS)zpyparsing_unicode.Hebrewz.Unicode set for Hebrew Unicode Character Range)i�i�Nr�rrrr�Hebrew�sr�c@seZdZdZddgZdS)zpyparsing_unicode.Devanagariz2Unicode set for Devanagari Unicode Character Range)i	i	)i�i��Nr�rrrr�
Devanagari�sr�N)rrrr�r��
maxunicoder�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrr�Ksuالعربيةu中文uкириллицаuΕλληνικάuעִברִיתu	日本語u漢字uカタカナuひらがなu	한국어u	ไทยuदेवनागरी�__main__Zselect�fromr{r)r �columnsr�ZtablesZcommandaK
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        z]
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        z 
        100
        FF
        z6
        12345678-1234-5678-1234-567812345678
        )NF)r�)rF)N)FTF)T)r�)T(	r�rrrr��weakrefrrrIr�r(r�r�r
rxr�r�r�operatorr�	itertools�	functoolsrr�ImportErrorr�_threadrZ	threadingZcollections.abcr	r
rrrZordereddictr
rr�rr�r�rZ%warn_on_multiple_string_args_to_oneofr��__all__r4�version_infor�rb�maxsizerhr�r�chrr6r�r�r�r�rt�reversedrr�rvr�r�r�r�ZmaxintZxrangerZ__builtin__r�Zfnamer�r�r�r�r
r�Zascii_uppercaseZascii_lowercaserHrfrXrGr+r�Z	printablerjr�rr0r2r4r6r9r�r�r5�registerrMr^r[r�r�r�rer�r7r'r?rr*r'rvrNr�r$rrr�rBr�rFr:r8rrAr�r"r&r%r=r<rDrCr3rr/r)rr1r r(r+rr,rErr.r;r!r@rr#rr>r-rvrTrPr rcrbr�rgrUr{r|r~r�rWr]r\rurtr�Z_escapedPuncZ_escapedHexCharZ_escapedOctCharZ_singleCharZ
_charRanger�r?rsrarprnr�rxrVrPr_r`ryrSrrhrYrZr}rirRrrrmrwrdrzrIrkrKrJrr�rhr7rOrorLrYrCrqrSrQrZrlrr�rNr�r�r�r�r�r�r�r�r��setattrr�r�r�r�r�r�r�r�rZselectTokenZ	fromTokenZidentZ
columnNameZcolumnNameListZ
columnSpecZ	tableNameZ
tableNameListZ	simpleSQLrgr�rmror�r}rrrr�<module>s�H
�
?]

H

D!
'N
E 
KFyl{VO#K,:#Dvj-D0$	W'*4
 
	


0�%


E&��h~

 (
 
���� ./J��


&
	site-packages/pip/_vendor/__pycache__/distro.cpython-38.opt-1.pyc000064400000107170151446177000020626 0ustar00U

��.e��@s~dZddlZddlZddlZddlZddlZddlZddlZddlZej	�
dd�ZdZddiZ
dddd	�Zd
diZe�d�Ze�d�Zd
ddedfZd@dd�Zdd�ZdAdd�ZdBdd�ZdCdd�ZdDdd�ZdEdd �ZdFd!d"�Zd#d$�Zd%d&�ZdGd'd(�Zd)d*�Zd+d,�Z d-d.�Z!d/d0�Z"d1d2�Z#d3d4�Z$d5d6�Z%d7d8�Z&Gd9d:�d:e'�Z(Gd;d<�d<e'�Z)e)�Z*d=d>�Z+e,d?k�rze+�dS)Ha
The ``distro`` package (``distro`` stands for Linux Distribution) provides
information about the Linux distribution it runs on, such as a reliable
machine-readable distro ID, or version information.

It is the recommended replacement for Python's original
:py:func:`platform.linux_distribution` function, but it provides much more
functionality. An alternative implementation became necessary because Python
3.5 deprecated this function, and Python 3.8 will remove it altogether.
Its predecessor function :py:func:`platform.dist` was already
deprecated since Python 2.6 and will also be removed in Python 3.8.
Still, there are many cases in which access to OS distribution information
is needed. See `Python issue 1322 <https://bugs.python.org/issue1322>`_ for
more information.
�NZUNIXCONFDIRz/etcz
os-releaseZolZoracleZrhel)ZenterpriseenterpriseZredhatenterpriseworkstationZredhatenterpriseserverZredhatzA(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)z(\w+)[-_](release|version)$Zdebian_versionzlsb-releasezoem-releasezsystem-releaseTcCs
t�|�S)a
    Return information about the current OS distribution as a tuple
    ``(id_name, version, codename)`` with items as follows:

    * ``id_name``:  If *full_distribution_name* is false, the result of
      :func:`distro.id`. Otherwise, the result of :func:`distro.name`.

    * ``version``:  The result of :func:`distro.version`.

    * ``codename``:  The result of :func:`distro.codename`.

    The interface of this function is compatible with the original
    :py:func:`platform.linux_distribution` function, supporting a subset of
    its parameters.

    The data it returns may not exactly be the same, because it uses more data
    sources than the original function, and that may lead to different data if
    the OS distribution is not consistent across multiple data sources it
    provides (there are indeed such distributions ...).

    Another reason for differences is the fact that the :func:`distro.id`
    method normalizes the distro ID string to a reliable machine-readable value
    for a number of popular OS distributions.
    )�_distro�linux_distribution)�full_distribution_name�r�6/usr/lib/python3.8/site-packages/pip/_vendor/distro.pyrasrcCst��S)a$
    Return the distro ID of the current distribution, as a
    machine-readable string.

    For a number of OS distributions, the returned distro ID value is
    *reliable*, in the sense that it is documented and that it does not change
    across releases of the distribution.

    This package maintains the following reliable distro ID values:

    ==============  =========================================
    Distro ID       Distribution
    ==============  =========================================
    "ubuntu"        Ubuntu
    "debian"        Debian
    "rhel"          RedHat Enterprise Linux
    "centos"        CentOS
    "fedora"        Fedora
    "sles"          SUSE Linux Enterprise Server
    "opensuse"      openSUSE
    "amazon"        Amazon Linux
    "arch"          Arch Linux
    "cloudlinux"    CloudLinux OS
    "exherbo"       Exherbo Linux
    "gentoo"        GenToo Linux
    "ibm_powerkvm"  IBM PowerKVM
    "kvmibm"        KVM for IBM z Systems
    "linuxmint"     Linux Mint
    "mageia"        Mageia
    "mandriva"      Mandriva Linux
    "parallels"     Parallels
    "pidora"        Pidora
    "raspbian"      Raspbian
    "oracle"        Oracle Linux (and Oracle Enterprise Linux)
    "scientific"    Scientific Linux
    "slackware"     Slackware
    "xenserver"     XenServer
    "openbsd"       OpenBSD
    "netbsd"        NetBSD
    "freebsd"       FreeBSD
    ==============  =========================================

    If you have a need to get distros for reliable IDs added into this set,
    or if you find that the :func:`distro.id` function returns a different
    distro ID for one of the listed distros, please create an issue in the
    `distro issue tracker`_.

    **Lookup hierarchy and transformations:**

    First, the ID is obtained from the following sources, in the specified
    order. The first available and non-empty value is used:

    * the value of the "ID" attribute of the os-release file,

    * the value of the "Distributor ID" attribute returned by the lsb_release
      command,

    * the first part of the file name of the distro release file,

    The so determined ID value then passes the following transformations,
    before it is returned by this method:

    * it is translated to lower case,

    * blanks (which should not be there anyway) are translated to underscores,

    * a normalization of the ID is performed, based upon
      `normalization tables`_. The purpose of this normalization is to ensure
      that the ID is as reliable as possible, even across incompatible changes
      in the OS distributions. A common reason for an incompatible change is
      the addition of an os-release file, or the addition of the lsb_release
      command, with ID values that differ from what was previously determined
      from the distro release file name.
    )r�idrrrrr}sKrFcCs
t�|�S)ak
    Return the name of the current OS distribution, as a human-readable
    string.

    If *pretty* is false, the name is returned without version or codename.
    (e.g. "CentOS Linux")

    If *pretty* is true, the version and codename are appended.
    (e.g. "CentOS Linux 7.1.1503 (Core)")

    **Lookup hierarchy:**

    The name is obtained from the following sources, in the specified order.
    The first available and non-empty value is used:

    * If *pretty* is false:

      - the value of the "NAME" attribute of the os-release file,

      - the value of the "Distributor ID" attribute returned by the lsb_release
        command,

      - the value of the "<name>" field of the distro release file.

    * If *pretty* is true:

      - the value of the "PRETTY_NAME" attribute of the os-release file,

      - the value of the "Description" attribute returned by the lsb_release
        command,

      - the value of the "<name>" field of the distro release file, appended
        with the value of the pretty version ("<version_id>" and "<codename>"
        fields) of the distro release file, if available.
    )r�name��prettyrrrr�s$rcCst�||�S)av
    Return the version of the current OS distribution, as a human-readable
    string.

    If *pretty* is false, the version is returned without codename (e.g.
    "7.0").

    If *pretty* is true, the codename in parenthesis is appended, if the
    codename is non-empty (e.g. "7.0 (Maipo)").

    Some distributions provide version numbers with different precisions in
    the different sources of distribution information. Examining the different
    sources in a fixed priority order does not always yield the most precise
    version (e.g. for Debian 8.2, or CentOS 7.1).

    The *best* parameter can be used to control the approach for the returned
    version:

    If *best* is false, the first non-empty version number in priority order of
    the examined sources is returned.

    If *best* is true, the most precise version number out of all examined
    sources is returned.

    **Lookup hierarchy:**

    In all cases, the version number is obtained from the following sources.
    If *best* is false, this order represents the priority order:

    * the value of the "VERSION_ID" attribute of the os-release file,
    * the value of the "Release" attribute returned by the lsb_release
      command,
    * the version number parsed from the "<version_id>" field of the first line
      of the distro release file,
    * the version number parsed from the "PRETTY_NAME" attribute of the
      os-release file, if it follows the format of the distro release files.
    * the version number parsed from the "Description" attribute returned by
      the lsb_release command, if it follows the format of the distro release
      files.
    )r�version�r
�bestrrrr�s)rcCs
t�|�S)a�
    Return the version of the current OS distribution as a tuple
    ``(major, minor, build_number)`` with items as follows:

    * ``major``:  The result of :func:`distro.major_version`.

    * ``minor``:  The result of :func:`distro.minor_version`.

    * ``build_number``:  The result of :func:`distro.build_number`.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�
version_parts�r
rrrrsrcCs
t�|�S)a5
    Return the major version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The major version is the first
    part of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�
major_versionrrrrr/s
rcCs
t�|�S)a6
    Return the minor version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The minor version is the second
    part of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�
minor_versionrrrrr<s
rcCs
t�|�S)a3
    Return the build number of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The build number is the third part
    of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    )r�build_numberrrrrrIs
rcCst��S)a
    Return a space-separated list of distro IDs of distributions that are
    closely related to the current OS distribution in regards to packaging
    and programming interfaces, for example distributions the current
    distribution is a derivative from.

    **Lookup hierarchy:**

    This information item is only provided by the os-release file.
    For details, see the description of the "ID_LIKE" attribute in the
    `os-release man page
    <http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
    )r�likerrrrrVsrcCst��S)a�
    Return the codename for the release of the current OS distribution,
    as a string.

    If the distribution does not have a codename, an empty string is returned.

    Note that the returned codename is not always really a codename. For
    example, openSUSE returns "x86_64". This function does not handle such
    cases in any special way and just returns the string it finds, if any.

    **Lookup hierarchy:**

    * the codename within the "VERSION" attribute of the os-release file, if
      provided,

    * the value of the "Codename" attribute returned by the lsb_release
      command,

    * the value of the "<codename>" field of the distro release file.
    )r�codenamerrrrrgsrcCst�||�S)a�
    Return certain machine-readable information items about the current OS
    distribution in a dictionary, as shown in the following example:

    .. sourcecode:: python

        {
            'id': 'rhel',
            'version': '7.0',
            'version_parts': {
                'major': '7',
                'minor': '0',
                'build_number': ''
            },
            'like': 'fedora',
            'codename': 'Maipo'
        }

    The dictionary structure and keys are always the same, regardless of which
    information items are available in the underlying data sources. The values
    for the various keys are as follows:

    * ``id``:  The result of :func:`distro.id`.

    * ``version``:  The result of :func:`distro.version`.

    * ``version_parts -> major``:  The result of :func:`distro.major_version`.

    * ``version_parts -> minor``:  The result of :func:`distro.minor_version`.

    * ``version_parts -> build_number``:  The result of
      :func:`distro.build_number`.

    * ``like``:  The result of :func:`distro.like`.

    * ``codename``:  The result of :func:`distro.codename`.

    For a description of the *pretty* and *best* parameters, see the
    :func:`distro.version` method.
    )r�inforrrrrs)rcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the os-release file data source of the current OS distribution.

    See `os-release file`_ for details about these information items.
    )r�os_release_inforrrrr�srcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the lsb_release command data source of the current OS distribution.

    See `lsb_release command output`_ for details about these information
    items.
    )r�lsb_release_inforrrrr�srcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.

    See `distro release file`_ for details about these information items.
    )r�distro_release_inforrrrr�srcCst��S)z�
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.
    )r�
uname_inforrrrr�srcCs
t�|�S)a�
    Return a single named information item from the os-release file data source
    of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `os-release file`_ for details about these information items.
    )r�os_release_attr��	attributerrrr�srcCs
t�|�S)a�
    Return a single named information item from the lsb_release command output
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `lsb_release command output`_ for details about these information
    items.
    )r�lsb_release_attrrrrrr�srcCs
t�|�S)a�
    Return a single named information item from the distro release file
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `distro release file`_ for details about these information items.
    )r�distro_release_attrrrrrr�srcCs
t�|�S)aZ
    Return a single named information item from the distro release file
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
                The empty string, if the item does not exist.
    )r�
uname_attrrrrrrsrc@s eZdZdZdd�Zdd�ZdS)�cached_propertyz�A version of @property which caches the value.  On access, it calls the
    underlying function and sets the value in `__dict__` so future accesses
    will not re-call the property.
    cCs|j|_||_dS�N)�__name__�_fname�_f)�self�frrr�__init__"szcached_property.__init__cCs|�|�}|j|j<|Sr!)r$�__dict__r#)r%�obj�owner�retrrr�__get__&szcached_property.__get__N)r"�
__module__�__qualname__�__doc__r'r,rrrrr sr c@s2eZdZdZdBdd�Zdd�ZdCdd	�Zd
d�ZdDd
d�ZdEdd�Z	dFdd�Z
dGdd�ZdHdd�ZdIdd�Z
dd�Zdd�ZdJdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zed/d0��Zed1d2��Zed3d4��Zed5d6��Zed7d8��Zed9d:��Z ed;d<��Z!d=d>�Z"ed?d@��Z#dAS)K�LinuxDistributiona
    Provides information about a OS distribution.

    This package creates a private module-global instance of this class with
    default initialization arguments, that is used by the
    `consolidated accessor functions`_ and `single source accessor functions`_.
    By using default initialization arguments, that module-global instance
    returns data about the current OS distribution (i.e. the distro this
    package runs on).

    Normally, it is not necessary to create additional instances of this class.
    However, in situations where control is needed over the exact data sources
    that are used, instances of this class can be created with a specific
    distro release file, or a specific os-release file, or without invoking the
    lsb_release command.
    T�cCs.|ptj�tt�|_|pd|_||_||_dS)ao
        The initialization method of this class gathers information from the
        available data sources, and stores that in private instance attributes.
        Subsequent access to the information items uses these private instance
        attributes, so that the data sources are read only once.

        Parameters:

        * ``include_lsb`` (bool): Controls whether the
          `lsb_release command output`_ is included as a data source.

          If the lsb_release command is not available in the program execution
          path, the data source for the lsb_release command will be empty.

        * ``os_release_file`` (string): The path name of the
          `os-release file`_ that is to be used as a data source.

          An empty string (the default) will cause the default path name to
          be used (see `os-release file`_ for details).

          If the specified or defaulted os-release file does not exist, the
          data source for the os-release file will be empty.

        * ``distro_release_file`` (string): The path name of the
          `distro release file`_ that is to be used as a data source.

          An empty string (the default) will cause a default search algorithm
          to be used (see `distro release file`_ for details).

          If the specified distro release file does not exist, or if no default
          distro release file can be found, the data source for the distro
          release file will be empty.

        * ``include_name`` (bool): Controls whether uname command output is
          included as a data source. If the uname command is not available in
          the program execution path the data source for the uname command will
          be empty.

        Public instance attributes:

        * ``os_release_file`` (string): The path name of the
          `os-release file`_ that is actually used as a data source. The
          empty string if no distro release file is used as a data source.

        * ``distro_release_file`` (string): The path name of the
          `distro release file`_ that is actually used as a data source. The
          empty string if no distro release file is used as a data source.

        * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
          This controls whether the lsb information will be loaded.

        * ``include_uname`` (bool): The result of the ``include_uname``
          parameter. This controls whether the uname information will
          be loaded.

        Raises:

        * :py:exc:`IOError`: Some I/O issue with an os-release file or distro
          release file.

        * :py:exc:`subprocess.CalledProcessError`: The lsb_release command had
          some issue (other than not being available in the program execution
          path).

        * :py:exc:`UnicodeError`: A data source has unexpected characters or
          uses an unexpected encoding.
        r1N)	�os�path�join�_UNIXCONFDIR�_OS_RELEASE_BASENAME�os_release_file�distro_release_file�include_lsb�
include_uname)r%r9r7r8r:rrrr'>sH�
zLinuxDistribution.__init__cCsdj|d�S)z Return repr of all info
        aeLinuxDistribution(os_release_file={self.os_release_file!r}, distro_release_file={self.distro_release_file!r}, include_lsb={self.include_lsb!r}, include_uname={self.include_uname!r}, _os_release_info={self._os_release_info!r}, _lsb_release_info={self._lsb_release_info!r}, _distro_release_info={self._distro_release_info!r}, _uname_info={self._uname_info!r})�r%)�formatr;rrr�__repr__�s	��zLinuxDistribution.__repr__cCs"|r|��n|��|��|��fS)z�
        Return information about the OS distribution that is compatible
        with Python's :func:`platform.linux_distribution`, supporting a subset
        of its parameters.

        For details, see :func:`distro.linux_distribution`.
        )rrrr)r%rrrrr�s	�z$LinuxDistribution.linux_distributioncCsldd�}|�d�}|r ||t�S|�d�}|r8||t�S|�d�}|rP||t�S|�d�}|rh||t�SdS)zoReturn the distro ID of the OS distribution, as a string.

        For details, see :func:`distro.id`.
        cSs|���dd�}|�||�S)N� �_)�lower�replace�get)�	distro_id�tablerrr�	normalize�sz'LinuxDistribution.id.<locals>.normalizer�distributor_idr1)r�NORMALIZED_OS_IDr�NORMALIZED_LSB_IDr�NORMALIZED_DISTRO_IDr)r%rErCrrrr�s







zLinuxDistribution.idFcCs||�d�p&|�d�p&|�d�p&|�d�}|rt|�d�p>|�d�}|st|�d�pV|�d�}|jdd�}|rt|d|}|pzdS)	zu
        Return the name of the OS distribution, as a string.

        For details, see :func:`distro.name`.
        rrF�pretty_name�descriptionTr	r>r1)rrrrr)r%r
rrrrrr�s&
���
�
�zLinuxDistribution.namec	Cs�|�d�|�d�|�d�|�|�d���dd�|�|�d���dd�|�d�g}d}|r�|D]$}|�d�|�d�ks||dkr\|}q\n|D]}|dkr�|}q�q�|r�|r�|��r�d�||���}|S)z{
        Return the version of the OS distribution, as a string.

        For details, see :func:`distro.version`.
        �
version_id�releaserJr1rK�.z	{0} ({1}))	rrr�_parse_distro_release_contentrBr�countrr<)r%r
r
Zversionsr�vrrrr�s:�����
zLinuxDistribution.versioncCsL|j|d�}|rHt�d�}|�|�}|rH|��\}}}||p>d|pDdfSdS)z�
        Return the version of the OS distribution, as a tuple of version
        numbers.

        For details, see :func:`distro.version_parts`.
        rz(\d+)\.?(\d+)?\.?(\d+)?r1)r1r1r1)r�re�compile�match�groups)r%r
Zversion_strZ
version_regex�matches�major�minorrrrrr�s

zLinuxDistribution.version_partscCs|�|�dS)z�
        Return the major version number of the current distribution.

        For details, see :func:`distro.major_version`.
        r�r�r%r
rrrrszLinuxDistribution.major_versioncCs|�|�dS)z�
        Return the minor version number of the current distribution.

        For details, see :func:`distro.minor_version`.
        �rYrZrrrrszLinuxDistribution.minor_versioncCs|�|�dS)z}
        Return the build number of the current distribution.

        For details, see :func:`distro.build_number`.
        �rYrZrrrrszLinuxDistribution.build_numbercCs|�d�pdS)z�
        Return the IDs of distributions that are like the OS distribution.

        For details, see :func:`distro.like`.
        Zid_liker1)rr;rrrr#szLinuxDistribution.likecCs>z|jdWStk
r8|�d�p2|�d�p2dYSXdS)zp
        Return the codename of the OS distribution.

        For details, see :func:`distro.codename`.
        rr1N)�_os_release_info�KeyErrorrrr;rrrr+s
��zLinuxDistribution.codenamec	CsBt|��|�||�t|�|�|�|�|�|�d�|��|��d�S)z�
        Return certain machine-readable information about the OS
        distribution.

        For details, see :func:`distro.info`.
        )rWrXr)rrrrr)�dictrrrrrrr)r%r
r
rrrr:s
��zLinuxDistribution.infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the os-release file data source of the OS distribution.

        For details, see :func:`distro.os_release_info`.
        )r]r;rrrrMsz!LinuxDistribution.os_release_infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the lsb_release command data source of the OS
        distribution.

        For details, see :func:`distro.lsb_release_info`.
        )�_lsb_release_infor;rrrrVsz"LinuxDistribution.lsb_release_infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the distro release file data source of the OS
        distribution.

        For details, see :func:`distro.distro_release_info`.
        )�_distro_release_infor;rrrr`sz%LinuxDistribution.distro_release_infocCs|jS)z�
        Return a dictionary containing key-value pairs for the information
        items from the uname command data source of the OS distribution.

        For details, see :func:`distro.uname_info`.
        )�_uname_infor;rrrrjszLinuxDistribution.uname_infocCs|j�|d�S)z�
        Return a single named information item from the os-release file data
        source of the OS distribution.

        For details, see :func:`distro.os_release_attr`.
        r1)r]rB�r%rrrrrssz!LinuxDistribution.os_release_attrcCs|j�|d�S)z�
        Return a single named information item from the lsb_release command
        output data source of the OS distribution.

        For details, see :func:`distro.lsb_release_attr`.
        r1)r`rBrcrrrr|sz"LinuxDistribution.lsb_release_attrcCs|j�|d�S)z�
        Return a single named information item from the distro release file
        data source of the OS distribution.

        For details, see :func:`distro.distro_release_attr`.
        r1)rarBrcrrrr�sz%LinuxDistribution.distro_release_attrcCs|j�|d�S)z�
        Return a single named information item from the uname command
        output data source of the OS distribution.

        For details, see :func:`distro.uname_release_attr`.
        r1)rbrBrcrrrr�szLinuxDistribution.uname_attrc
Cs:tj�|j�r6t|j��}|�|�W5QR�SQRXiS)z�
        Get the information items from the specified os-release file.

        Returns:
            A dictionary containing all information items.
        )r2r3�isfiler7�open�_parse_os_release_content)r%Zrelease_filerrrr]�sz"LinuxDistribution._os_release_infocCsi}tj|dd�}d|_tjddkr@t|jt�r@|j�d�|_t|�}|D]>}d|krL|�	dd�\}}t|t�r||�d�}|||�
�<qLqLd	|kr�|d	|d
<nbd|kr�|d|d
<nLd|k�rt�d
|d�}|�r|�
�}|�d�}|�d�}|��}||d
<|S)aD
        Parse the lines of an os-release file.

        Parameters:

        * lines: Iterable through the lines in the os-release file.
                 Each line must be a unicode string or a UTF-8 encoded byte
                 string.

        Returns:
            A dictionary containing all information items.
        T)�posixrr\z
iso-8859-1�=r[�utf-8Zversion_codenamerZubuntu_codenamerz(\(\D+\))|,(\s+)?\D+z()�,)�shlexZwhitespace_split�sys�version_info�
isinstanceZ	wordchars�bytes�decode�list�splitr@rR�search�group�strip)�lines�propsZlexer�tokens�token�krQrrrrrf�s4	




z+LinuxDistribution._parse_os_release_contentc
Csz|js
iSttjd��B}zd}tj||d�}Wn$tk
rRiYW5QR�SXW5QRX|�t�	���
�}|�|�S)z�
        Get the information items from the lsb_release command output.

        Returns:
            A dictionary containing all information items.
        �w)Zlsb_releasez-a��stderr)r9rer2�devnull�
subprocess�check_output�OSErrorrprl�getfilesystemencoding�
splitlines�_parse_lsb_release_content�r%r~�cmd�stdoutZcontentrrrr`�s z#LinuxDistribution._lsb_release_infocCsXi}|D]J}|�d��dd�}t|�dkr,q|\}}|�|�dd���|��i�q|S)aM
        Parse the output of the lsb_release command.

        Parameters:

        * lines: Iterable through the lines of the lsb_release output.
                 Each line must be a unicode string or a UTF-8 encoded byte
                 string.

        Returns:
            A dictionary containing all information items.
        �
�:r[r\r>r?)rurr�len�updaterAr@)rvrw�lineZkvrzrQrrrr��s z,LinuxDistribution._parse_lsb_release_contentc
Cspttjd��B}zd}tj||d�}Wn$tk
rHiYW5QR�SXW5QRX|�t����	�}|�
|�S)Nr{)�unamez-rsr|)rer2r~rr�r�rprlr�r��_parse_uname_contentr�rrrrbs zLinuxDistribution._uname_infocCsTi}t�d|d���}|rP|��\}}|dkr4iS|��|d<||d<||d<|S)Nz^([^\s]+)\s+([\d\.]+)rZLinuxrrrM)rRrsrurUr@)rvrwrTrrrrrr�sz&LinuxDistribution._parse_uname_contentcCs0|jrb|�|j�}tj�|j�}t�|�}d|krLd|d��krLd|d<n|r^|�d�|d<|Szt�	t
�}|��Wn6tk
r�ddddd	d
ddd
ddddddg}YnX|D]r}|t
kr�q�t�|�}|r�tj�t
|�}|�|�}d|kr�||_|�d�|d<d|d��k�rd|d<|Sq�iSdS)z�
        Get the information items from the specified distro release file.

        Returns:
            A dictionary containing all information items.
        rZ
cloudlinuxrr[zSuSE-releasezarch-releasezbase-releasezcentos-releasezfedora-releasezgentoo-releasezmageia-releasezmandrake-releasezmandriva-releasezmandrivalinux-releasezmanjaro-releasezoracle-releasezredhat-releasez
sl-releasezslackware-versionN)r8�_parse_distro_release_filer2r3�basename� _DISTRO_RELEASE_BASENAME_PATTERNrTr@rt�listdirr5�sortr�� _DISTRO_RELEASE_IGNORE_BASENAMESr4)r%�distro_infor�rTZ	basenames�filepathrrrra.s^�
�

�



z&LinuxDistribution._distro_release_infoc
CsRz0t|��}|�|���W5QR�WSQRXWnttfk
rLiYSXdS)z�
        Parse a distro release file.

        Parameters:

        * filepath: Path name of the distro release file.

        Returns:
            A dictionary containing all information items.
        N)rerO�readliner��IOError)r%r��fprrrr�rs

&z,LinuxDistribution._parse_distro_release_filecCs�t|t�r|�d�}t�|��ddd��}i}|r�|�d�ddd�|d<|�d�rn|�d�ddd�|d<|�d�r�|�d�ddd�|d	<n|r�|��|d<|S)
a
        Parse a line from a distro release file.

        Parameters:
        * line: Line from the distro release file. Must be a unicode string
                or a UTF-8 encoded byte string.

        Returns:
            A dictionary containing all information items.
        riN����rr\rLr[r)rnrorp�(_DISTRO_RELEASE_CONTENT_REVERSED_PATTERNrTrurt)r�rVr�rrrrO�s

�

z/LinuxDistribution._parse_distro_release_contentN)Tr1r1T)T)F)FF)F)F)F)F)FF)$r"r-r.r/r'r=rrrrrrrrrrrrrrrrrrrr r]�staticmethodrfr`r�rbr�rar�rOrrrrr0,sV�
N


"




	

					

B





Cr0cCs�t�t�}|�tj�|�t�tj��t	j
dd�}|jddddd�|��}|j
rn|�t
jt�dd	d
��n:|�dtd	d��td	d�}|�d
|�t�}|�d|�dS)NzOS distro info tool)rKz--jsonz-jz!Output in machine readable format�
store_true)�help�action�T)�indentZ	sort_keyszName: %sr	zVersion: %szCodename: %s)�loggingZ	getLoggerr"ZsetLevel�DEBUGZ
addHandlerZ
StreamHandlerrlr��argparse�ArgumentParser�add_argument�
parse_args�jsonr�dumpsrrr)Zlogger�parser�argsZdistribution_versionZdistribution_codenamerrr�main�s$
�
r��__main__)T)F)FF)F)F)F)F)FF)-r/r2rRrlr�rkr�r�r�environrBr5r6rGrHrIrSr�r�r�rrrrrrrrrrrrrrrrrrr�objectr r0rr�r"rrrr�<module>sz
������	
N
'
,





,

}
site-packages/pip/_vendor/__pycache__/contextlib2.cpython-38.pyc000064400000036202151446177000020615 0ustar00U

��.eB�	@s�dZddlZddlZddlZddlmZddlmZddddd	d
ddd
g	Zedg7Zej	dd�dkrnej
Zne�de
fddi�Zdd�Zdd�ZGdd�de�ZGdd	�d	e
�ZGdd�de�Zdd�ZGdd�de
�ZGdd�de
�ZGd d�de�ZGd!d�de�ZGd"d
�d
e
�Zej	dd#kZe�r@d$d%�Zd&d'�Znd(d%�Zd)d'�Zzdd*lmZWnek
�rzeZ Yn
Xd+d,�Z Gd-d
�d
e
�Z!Gd.d�de!�Z"Gd/d�de�Z#dS)0zAcontextlib2 - backports and enhancements to the contextlib module�N)�deque��wraps�contextmanager�closing�nullcontext�AbstractContextManager�ContextDecorator�	ExitStack�redirect_stdout�redirect_stderr�suppress�ContextStack�)���ABC�	__slots__�cCs0||krdS|�|�|jD]}t||�q|S�N)�append�	__bases__�_classic_mro)�C�result�Brr�;/usr/lib/python3.8/site-packages/pip/_vendor/contextlib2.pyrs

rcGsvz
|j}Wn"tk
r,tt|g��}YnX|D]>}|D],}||jkr:|j|dkrbtSq2q:tSq2dS)NT)�__mro__�AttributeError�tupler�__dict__�NotImplemented)r�methods�mro�methodrrrr�_check_methods$s


r%c@s2eZdZdZdd�Zejdd��Zedd��Z	dS)	rz,An abstract base class for context managers.cCs|S)z0Return `self` upon entering the runtime context.r��selfrrr�	__enter__8sz AbstractContextManager.__enter__cCsdS)z9Raise any exception triggered within the runtime context.Nr)r'�exc_type�	exc_value�	tracebackrrr�__exit__<szAbstractContextManager.__exit__cCs|tkrt|dd�StS)z<Check whether subclass is considered a subclass of this ABC.r(r,)rr%r!)�clsrrrr�__subclasshook__Asz'AbstractContextManager.__subclasshook__N)
�__name__�
__module__�__qualname__�__doc__r(�abc�abstractmethodr,�classmethodr.rrrrr5s
c@s(eZdZdZdd�Zdd�Zdd�ZdS)	r	zJA base class or mixin that enables context managers to work as decorators.cCst�dt�|��S)a�Returns the context manager used to actually wrap the call to the
        decorated function.

        The default implementation just returns *self*.

        Overriding this method allows otherwise one-shot context managers
        like _GeneratorContextManager to support use as decorators via
        implicit recreation.

        DEPRECATED: refresh_cm was never added to the standard library's
                    ContextDecorator API
        z2refresh_cm was never added to the standard library)�warnings�warn�DeprecationWarning�_recreate_cmr&rrr�
refresh_cmLs
�zContextDecorator.refresh_cmcCs|S)a6Return a recreated instance of self.

        Allows an otherwise one-shot context manager like
        _GeneratorContextManager to support use as
        a decorator via implicit recreation.

        This is a private interface just for _GeneratorContextManager.
        See issue #11647 for details.
        rr&rrrr9]s
zContextDecorator._recreate_cmcst����fdd��}|S)Nc
s*�����||�W5QR�SQRXdSr)r9��args�kwds��funcr'rr�innerjs
z(ContextDecorator.__call__.<locals>.innerr)r'r?r@rr>r�__call__iszContextDecorator.__call__N)r/r0r1r2r:r9rArrrrr	Isc@s0eZdZdZdd�Zdd�Zdd�Zdd	�Zd
S)�_GeneratorContextManagerz%Helper for @contextmanager decorator.cCsJ|||�|_||||_|_|_t|dd�}|dkr@t|�j}||_dS)Nr2)�genr?r<r=�getattr�typer2)r'r?r<r=�docrrr�__init__ts
z!_GeneratorContextManager.__init__cCs|�|j|j|j�Sr)�	__class__r?r<r=r&rrrr9�sz%_GeneratorContextManager._recreate_cmcCs.zt|j�WStk
r(td��YnXdS)Nzgenerator didn't yield)�nextrC�
StopIteration�RuntimeErrorr&rrrr(�sz"_GeneratorContextManager.__enter__c
Cs�|dkr8zt|j�Wntk
r,YdSXtd��n�|dkrF|�}z|j�|||�td��Wn�tk
r�}z||k	WY�Sd}~XYnjtk
r�}z0||kr�WY�"dStr�|j|kr�WY�
dS�W5d}~XYnt��d|k	r�YnXdS)Nzgenerator didn't stopz#generator didn't stop after throw()F�)	rIrCrJrK�throw�_HAVE_EXCEPTION_CHAINING�	__cause__�sys�exc_info)r'rE�valuer+�excrrrr,�s,


z!_GeneratorContextManager.__exit__N)r/r0r1r2rGr9r(r,rrrrrBqs
rBcst���fdd��}|S)a�@contextmanager decorator.

    Typical usage:

        @contextmanager
        def some_generator(<arguments>):
            <setup>
            try:
                yield <value>
            finally:
                <cleanup>

    This makes this:

        with some_generator(<arguments>) as <variable>:
            <body>

    equivalent to this:

        <setup>
        try:
            <variable> = <value>
            <body>
        finally:
            <cleanup>

    cst�||�Sr)rBr;�r?rr�helper�szcontextmanager.<locals>.helperr)r?rUrrTrr�sc@s(eZdZdZdd�Zdd�Zdd�ZdS)	ra2Context to automatically close something at the end of a block.

    Code like this:

        with closing(<module>.open(<arguments>)) as f:
            <block>

    is equivalent to this:

        f = <module>.open(<arguments>)
        try:
            <block>
        finally:
            f.close()

    cCs
||_dSr��thing)r'rWrrrrG�szclosing.__init__cCs|jSrrVr&rrrr(�szclosing.__enter__cGs|j��dSr)rW�close)r'rQrrrr,�szclosing.__exit__N�r/r0r1r2rGr(r,rrrrr�sc@s(eZdZdZdd�Zdd�Zdd�ZdS)�_RedirectStreamNcCs||_g|_dSr)�_new_target�_old_targets)r'�
new_targetrrrrG�sz_RedirectStream.__init__cCs*|j�tt|j��tt|j|j�|jSr)r\rrDrP�_stream�setattrr[r&rrrr(�sz_RedirectStream.__enter__cCstt|j|j���dSr)r_rPr^r\�pop�r'�exctype�excinst�exctbrrrr,sz_RedirectStream.__exit__)r/r0r1r^rGr(r,rrrrrZ�srZc@seZdZdZdZdS)raAContext manager for temporarily redirecting stdout to another file.

        # How to send help() to stderr
        with redirect_stdout(sys.stderr):
            help(dir)

        # How to write help() to a file
        with open('help.txt', 'w') as f:
            with redirect_stdout(f):
                help(pow)
    �stdoutN�r/r0r1r2r^rrrrrsc@seZdZdZdZdS)rzCContext manager for temporarily redirecting stderr to another file.�stderrNrfrrrrrsc@s(eZdZdZdd�Zdd�Zdd�ZdS)	r
a?Context manager to suppress specified exceptions

    After the exception is suppressed, execution proceeds with the next
    statement following the with statement.

         with suppress(FileNotFoundError):
             os.remove(somefile)
         # Execution still resumes here if the file was already removed
    cGs
||_dSr)�_exceptions)r'�
exceptionsrrrrG)szsuppress.__init__cCsdSrrr&rrrr(,szsuppress.__enter__cCs|dk	ot||j�Sr)�
issubclassrhrarrrr,/s
zsuppress.__exit__NrYrrrrr
s
rcs�fdd�}|S)Ncs4|j}||krdS|dks*|�kr$q*|}q||_dSr)�__context__)�new_exc�old_exc�exc_context��	frame_excrr�_fix_exception_context@sz3_make_context_fixer.<locals>._fix_exception_contextr)rprqrror�_make_context_fixer?s
rrcCs<z|dj}|d�Wn tk
r6||d_�YnXdS)NrL)rk�
BaseException)�exc_details�	fixed_ctxrrr�_reraise_with_existing_contextOs

rvcCsdd�S)NcSsdSrr)rlrmrrr�<lambda>[�z%_make_context_fixer.<locals>.<lambda>rrorrrrrZscCs|\}}}td�dS)Nz!raise exc_type, exc_value, exc_tb)�exec)rtr)r*Zexc_tbrrrrv_s
)�InstanceTypecCst|�}|tkr|jS|Sr)rErzrH)�objZobj_typerrr�	_get_typeksr|c@sXeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�ZdS)r
a�Context manager for dynamic management of a stack of exit callbacks

    For example:

        with ExitStack() as stack:
            files = [stack.enter_context(open(fname)) for fname in filenames]
            # All opened files will automatically be closed at the end of
            # the with statement, even if attempts to open files later
            # in the list raise an exception

    cCst�|_dSr)r�_exit_callbacksr&rrrrGszExitStack.__init__cCst|��}|j|_t�|_|S)z?Preserve the context stack by transferring it to a new instance)rEr}r)r'�	new_stackrrr�pop_all�s
zExitStack.pop_allcs"��fdd�}�|_|�|�dS)z:Helper to correctly register callbacks to __exit__ methodscs��f|��Srr)rt��cm�cm_exitrr�
_exit_wrapper�sz.ExitStack._push_cm_exit.<locals>._exit_wrapperN)�__self__�push)r'r�r�r�rr�r�
_push_cm_exit�szExitStack._push_cm_exitcCsDt|�}z
|j}Wn tk
r2|j�|�YnX|�||�|S)aRegisters a callback with the standard __exit__ method signature

        Can suppress exceptions the same way __exit__ methods can.

        Also accepts any object with an __exit__ method (registering a call
        to the method instead of the object itself)
        )r|r,rr}rr�)r'�exit�_cb_type�exit_methodrrrr��s

zExitStack.pushcs$���fdd�}�|_|�|��S)z\Registers an arbitrary callback and arguments.

        Cannot suppress exceptions.
        cs����dSrr)r)rS�tb�r<�callbackr=rrr��sz)ExitStack.callback.<locals>._exit_wrapper)�__wrapped__r�)r'r�r<r=r�rr�rr��s
zExitStack.callbackcCs(t|�}|j}|�|�}|�||�|S)z�Enters the supplied context manager

        If successful, also pushes its __exit__ method as a callback and
        returns the result of the __enter__ method.
        )r|r,r(r�)r'r��_cm_type�_exitrrrr�
enter_context�s

zExitStack.enter_contextcCs|�ddd�dS)z$Immediately unwind the context stackN)r,r&rrrrX�szExitStack.closecCs|Srrr&rrrr(�szExitStack.__enter__c	Gs�|ddk	}t��d}t|�}d}d}|jr�|j��}z||�rNd}d}d}Wq(t��}||d|d�d}|}Yq(Xq(|r�t|�|o�|S)NrrLFT)NNN)rPrQrrr}r`rv)	r'rt�received_excrprq�suppressed_exc�
pending_raise�cb�new_exc_detailsrrrr,�s(
zExitStack.__exit__N)
r/r0r1r2rGrr�r�r�r�rXr(r,rrrrr
ss

cs8eZdZdZ�fdd�Zdd�Zdd�Zdd	�Z�ZS)
rz+Backwards compatibility alias for ExitStackcst�dt�tt|���dS)Nz*ContextStack has been renamed to ExitStack)r6r7r8�superrrGr&�rHrrrG�s�zContextStack.__init__cCs
|�|�Sr)r�)r'r�rrr�
register_exit�szContextStack.register_exitcOs|j|f|�|�Sr)r�)r'r�r<r=rrr�register�szContextStack.registercCs|��Sr)rr&rrr�preserve�szContextStack.preserve)	r/r0r1r2rGr�r�r��
__classcell__rrr�rr�s
c@s*eZdZdZd	dd�Zdd�Zdd�ZdS)
raMContext manager that does no additional processing.
    Used as a stand-in for a normal context manager, when a particular
    block of code is only sometimes used with a normal context manager:
    cm = optional_cm if condition else nullcontext()
    with cm:
        # Perform operation, using optional_cm if condition is True
    NcCs
||_dSr��enter_result)r'r�rrrrG�sznullcontext.__init__cCs|jSrr�r&rrrr(sznullcontext.__enter__cGsdSrr)r'�excinforrrr,sznullcontext.__exit__)NrYrrrrr�s
)$r2r3rPr6�collectionsr�	functoolsr�__all__�version_inforZ_abc_ABC�ABCMeta�objectrr%rr	rBrrrZrrr
rNrrrv�typesrz�ImportErrorrEr|r
rrrrrr�<module>sT�

(H"

qsite-packages/pip/_vendor/__pycache__/ipaddress.cpython-38.opt-1.pyc000064400000176207151446177000021307 0ustar00U

��.e�7�@s`dZddlmZddlZddlZdZefZzeefZWne	k
rJYnXze
ZWne	k
rleZYnXddkr�dd�Z
ndd�Z
z
ejZWnek
r�dd	�ZYnXd
d�Zeed�r�d
d�Zndd�ZdNdd�ZGdd�de�ZdZdZGdd�de�ZGdd�de�Zdd�ZdOdd�Zd d!�Zd"d#�Zd$d%�Z d&d'�Z!d(d)�Z"d*d+�Z#d,d-�Z$d.d/�Z%d0d1�Z&d2d3�Z'Gd4d5�d5e�Z(Gd6d7�d7e(�Z)Gd8d9�d9e(�Z*Gd:d;�d;e�Z+Gd<d=�d=e+e)�Z,Gd>d?�d?e,�Z-Gd@dA�dAe+e*�Z.GdBdC�dCe�Z/e/e,_0GdDdE�dEe�Z1GdFdG�dGe1e)�Z2GdHdI�dIe2�Z3GdJdK�dKe1e*�Z4GdLdM�dMe�Z5e5e2_0dS)Pz�A fast, lightweight IPv4/IPv6 manipulation library in Python.

This library is used to create/poke/manipulate IPv4 and IPv6 addresses
and networks.

�)�unicode_literalsNz1.0.22cCs|S�N��Zbytrr�9/usr/lib/python3.8/site-packages/pip/_vendor/ipaddress.py�_compat_bytes_to_byte_valssrcCsdd�|D�S)NcSsg|]}t�d|�d�qS)�!Br)�struct�unpack��.0�brrr�
<listcomp>#sz._compat_bytes_to_byte_vals.<locals>.<listcomp>rrrrrr"scCsd}|D]}|d>|}q|S)Nr�r)Zbytvals�	endianess�resZbvrrr�_compat_int_from_byte_vals'srcCst|dkr.|dks|dkr"t�d��t�d|�S|dkrj|dksJ|ddkrTt�d	��t�d
|d?|d@�St��dS)
N�rlz(integer out of range for 'I' format codes!I���z)integer out of range for 'QQ' format codes!QQ�@l����)r	�error�pack�NotImplementedError)ZintvalZlengthrrrr�_compat_to_bytes0s

r�
bit_lengthcCs|��Sr)r)�irrr�_compat_bit_lengthAsrcCs&t��D]}||?dkr|SqdS�Nr)�	itertools�count)rrrrrrDs�ccs |}||kr|V||7}qdSrr)�start�end�steprrrr�
_compat_rangeJsr&c@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)�_TotalOrderingMixinrcCst�dSr�r��self�otherrrr�__eq__Ysz_TotalOrderingMixin.__eq__cCs|�|�}|tkrtS|Sr)r,�NotImplemented)r*r+�equalrrr�__ne__\s
z_TotalOrderingMixin.__ne__cCst�dSrr(r)rrr�__lt__bsz_TotalOrderingMixin.__lt__cCs$|�|�}|tks|s |�|�S|Sr�r0r-r,�r*r+�lessrrr�__le__es

z_TotalOrderingMixin.__le__cCs6|�|�}|tkrtS|�|�}|tkr,tS|p2|Srr1)r*r+r3r.rrr�__gt__ks

z_TotalOrderingMixin.__gt__cCs|�|�}|tkrtS|Sr)r0r-r2rrr�__ge__ts
z_TotalOrderingMixin.__ge__N)
�__name__�
__module__�__qualname__�	__slots__r,r/r0r4r5r6rrrrr'Rs	r'� rc@seZdZdZdS)�AddressValueErrorz%A Value Error related to the address.N�r7r8r9�__doc__rrrrr<sr<c@seZdZdZdS)�NetmaskValueErrorz%A Value Error related to the netmask.Nr=rrrrr?�sr?c	Csnz
t|�WSttfk
r"YnXz
t|�WSttfk
rFYnXt|t�r^td|��td|��dS)a�Take an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP address.  Either IPv4 or
          IPv6 addresses may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Address or IPv6Address object.

    Raises:
        ValueError: if the *address* passed isn't either a v4 or a v6
          address

    zx%r does not appear to be an IPv4 or IPv6 address. Did you pass in a bytes (str in Python 2) instead of a unicode object?z0%r does not appear to be an IPv4 or IPv6 addressN)�IPv4Addressr<r?�IPv6Address�
isinstance�bytes�
ValueError��addressrrr�
ip_address�s"


���rGTc	Csrzt||�WSttfk
r$YnXzt||�WSttfk
rJYnXt|t�rbtd|��td|��dS)a�Take an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP network.  Either IPv4 or
          IPv6 networks may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Network or IPv6Network object.

    Raises:
        ValueError: if the string passed isn't either a v4 or a v6
          address. Or if the network has host bits set.

    zx%r does not appear to be an IPv4 or IPv6 network. Did you pass in a bytes (str in Python 2) instead of a unicode object?z0%r does not appear to be an IPv4 or IPv6 networkN)�IPv4Networkr<r?�IPv6NetworkrBrCrD)rF�strictrrr�
ip_network�s"
���rKc	CsXz
t|�WSttfk
r"YnXz
t|�WSttfk
rFYnXtd|��dS)agTake an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP address.  Either IPv4 or
          IPv6 addresses may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Interface or IPv6Interface object.

    Raises:
        ValueError: if the string passed isn't either a v4 or a v6
          address.

    Notes:
        The IPv?Interface classes describe an Address on a particular
        Network, so they're basically a combination of both the Address
        and Network classes.

    z2%r does not appear to be an IPv4 or IPv6 interfaceN)�
IPv4Interfacer<r?�
IPv6InterfacerDrErrr�ip_interface�s

�rNc	Cs6zt|dd�WStjtfk
r0td��YnXdS)a`Represent an address as 4 packed bytes in network (big-endian) order.

    Args:
        address: An integer representation of an IPv4 IP address.

    Returns:
        The integer address packed as 4 bytes in network (big-endian) order.

    Raises:
        ValueError: If the integer is negative or too large to be an
          IPv4 IP address.

    r�bigz&Address negative or too large for IPv4N�rr	r�
OverflowErrorrDrErrr�v4_int_to_packed�srRc	Cs6zt|dd�WStjtfk
r0td��YnXdS)z�Represent an address as 16 packed bytes in network (big-endian) order.

    Args:
        address: An integer representation of an IPv6 IP address.

    Returns:
        The integer address packed as 16 bytes in network (big-endian) order.

    rrOz&Address negative or too large for IPv6NrPrErrr�v6_int_to_packeds
rScCs*t|��d�}t|�dkr&td|��|S)zAHelper to split the netmask and raise AddressValueError if needed�/rzOnly one '/' permitted in %r)�_compat_str�split�lenr<)rF�addrrrr�_split_optional_netmasksrYccsNt|�}t|�}}|D]&}|j|jdkr:||fV|}|}q||fVdS)z�Find a sequence of sorted deduplicated IPv#Address.

    Args:
        addresses: a list of IPv#Address objects.

    Yields:
        A tuple containing the first and last IP addresses in the sequence.

    r"N)�iter�next�_ip)�	addresses�it�first�last�iprrr�_find_address_ranges

rbcCs$|dkr|St|t||d@��S)z�Count the number of zero bits on the right hand side.

    Args:
        number: an integer.
        bits: maximum number of bits to count.

    Returns:
        The number of zero bits on the right hand side of the number.

    rr")�minr)Znumber�bitsrrr�_count_righthand_zero_bits2sreccs�t|t�rt|t�std��|j|jkr8td||f��||krHtd��|jdkrXt}n|jdkrht}ntd��|j}|j}|j}||kr�t	t
||�t||d�d�}||||f�}|V|d|>7}|d|jkr�q�q�dS)	a�Summarize a network range given the first and last IP addresses.

    Example:
        >>> list(summarize_address_range(IPv4Address('192.0.2.0'),
        ...                              IPv4Address('192.0.2.130')))
        ...                                #doctest: +NORMALIZE_WHITESPACE
        [IPv4Network('192.0.2.0/25'), IPv4Network('192.0.2.128/31'),
         IPv4Network('192.0.2.130/32')]

    Args:
        first: the first IPv4Address or IPv6Address in the range.
        last: the last IPv4Address or IPv6Address in the range.

    Returns:
        An iterator of the summarized IPv(4|6) network objects.

    Raise:
        TypeError:
            If the first and last objects are not IP addresses.
            If the first and last objects are not the same version.
        ValueError:
            If the last object is not greater than the first.
            If the version of the first address is not 4 or 6.

    z1first and last must be IP addresses, not networks�%%s and %s are not of the same versionz*last IP address must be greater than firstr�zunknown IP versionr"N)
rB�_BaseAddress�	TypeError�versionrDrHrI�_max_prefixlenr\rcrer�	_ALL_ONES)r_r`raZip_bitsZ	first_intZlast_intZnbits�netrrr�summarize_address_rangeBs8
��


�rnccs�t|�}i}|rV|��}|��}|�|�}|dkr<|||<q||kr||=|�|�qd}t|���D]$}|dk	r�|j|jkr�qf|V|}qfdS)auLoops through the addresses, collapsing concurrent netblocks.

    Example:

        ip1 = IPv4Network('192.0.2.0/26')
        ip2 = IPv4Network('192.0.2.64/26')
        ip3 = IPv4Network('192.0.2.128/26')
        ip4 = IPv4Network('192.0.2.192/26')

        _collapse_addresses_internal([ip1, ip2, ip3, ip4]) ->
          [IPv4Network('192.0.2.0/24')]

        This shouldn't be called directly; it is called via
          collapse_addresses([]).

    Args:
        addresses: A list of IPv4Network's or IPv6Network's

    Returns:
        A list of IPv4Network's or IPv6Network's depending on what we were
        passed.

    N)�list�pop�supernet�get�append�sorted�values�broadcast_address)r]Zto_merge�subnetsrmrqZexistingr`rrr�_collapse_addresses_internalys$

rxc	Cs0g}g}g}|D]�}t|t�rR|rF|dj|jkrFtd||df��|�|�q|j|jkr�|r�|dj|jkr�td||df��z|�|j�Wq�tk
r�|�|j	�Yq�Xq|r�|dj|jkr�td||df��|�|�qt
t|��}|�r$t|�D]\}}|�
t||���qt||�S)a�Collapse a list of IP objects.

    Example:
        collapse_addresses([IPv4Network('192.0.2.0/25'),
                            IPv4Network('192.0.2.128/25')]) ->
                           [IPv4Network('192.0.2.0/24')]

    Args:
        addresses: An iterator of IPv4Network or IPv6Network objects.

    Returns:
        An iterator of the collapsed IPv(4|6)Network objects.

    Raises:
        TypeError: If passed a list of mixed version objects.

    ���rf)rBrh�_versionrirs�
_prefixlenrkra�AttributeError�network_addressrt�setrb�extendrnrx)r]ZaddrsZipsZnetsrar_r`rrr�collapse_addresses�s@
���r�cCs(t|t�r|��St|t�r$|��StS)a2Return a key suitable for sorting between networks and addresses.

    Address and Network objects are not sortable by default; they're
    fundamentally different so the expression

        IPv4Address('192.0.2.0') <= IPv4Network('192.0.2.0/24')

    doesn't make any sense.  There are some times however, where you may wish
    to have ipaddress sort these for you anyway. If you need to do this, you
    can use this function as the key= argument to sorted().

    Args:
      obj: either a Network or Address object.
    Returns:
      appropriate key.

    )rB�_BaseNetwork�_get_networks_keyrh�_get_address_keyr-)�objrrr�get_mixed_type_key�s


r�c@s�eZdZdZdZedd��Zedd��Zedd��Zed	d
��Z	dd�Z
d
d�Zedd��Z
edd��Zedd��Zedd��Zedd��Zdd�ZdS)�_IPAddressBasezThe mother class.rcCs|��S)z:Return the longhand version of the IP address as a string.)�_explode_shorthand_ip_string�r*rrr�exploded�sz_IPAddressBase.explodedcCst|�S)z;Return the shorthand version of the IP address as a string.�rUr�rrr�
compressedsz_IPAddressBase.compressedcCs|��S)aIThe name of the reverse DNS pointer for the IP address, e.g.:
            >>> ipaddress.ip_address("127.0.0.1").reverse_pointer
            '1.0.0.127.in-addr.arpa'
            >>> ipaddress.ip_address("2001:db8::1").reverse_pointer
            '1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa'

        )�_reverse_pointerr�rrr�reverse_pointer	s	z_IPAddressBase.reverse_pointercCsdt|�f}t|��dS)Nz%200s has no version specified��typer�r*�msgrrrrjsz_IPAddressBase.versioncCsF|dkrd}t|||jf��||jkrBd}t|||j|jf��dS)Nrz-%d (< 0) is not permitted as an IPv%d addressz2%d (>= 2**%d) is not permitted as an IPv%d address)r<rzrlrk)r*rFr�rrr�_check_int_addresss

�z!_IPAddressBase._check_int_addresscCs.t|�}||kr*d}t|||||jf��dS)Nz~%r (len %d != %d) is not permitted as an IPv%d address. Did you pass in a bytes (str in Python 2) instead of a unicode object?)rWr<rz)r*rFZexpected_lenZaddress_lenr�rrr�_check_packed_address"s��z$_IPAddressBase._check_packed_addresscCs|j|j|?AS)z�Turn the prefix length into a bitwise netmask

        Args:
            prefixlen: An integer, the prefix length.

        Returns:
            An integer.

        )rl)�cls�	prefixlenrrr�_ip_int_from_prefix,sz"_IPAddressBase._ip_int_from_prefixc	Cs\t||j�}|j|}||?}d|>d}||krX|jd}t||d�}d}t||��|S)aReturn prefix length from the bitwise netmask.

        Args:
            ip_int: An integer, the netmask in expanded bitwise format

        Returns:
            An integer, the prefix length.

        Raises:
            ValueError: If the input intermingles zeroes & ones
        r"rrOz&Netmask pattern %r mixes zeroes & ones)rerkrrD)	r��ip_intZtrailing_zeroesr�Zleading_onesZall_onesZbyteslenZdetailsr�rrr�_prefix_from_ip_int9s
�

z"_IPAddressBase._prefix_from_ip_intcCsd|}t|��dS)Nz%r is not a valid netmask)r?)r�Znetmask_strr�rrr�_report_invalid_netmaskRsz&_IPAddressBase._report_invalid_netmaskcCshtj�|�s|�|�zt|�}Wntk
r@|�|�YnXd|krX|jksdn|�|�|S)a	Return prefix length from a numeric string

        Args:
            prefixlen_str: The string to be converted

        Returns:
            An integer, the prefix length.

        Raises:
            NetmaskValueError: If the input is not a valid netmask
        r)�_BaseV4�_DECIMAL_DIGITS�
issupersetr��intrDrk)r�Z
prefixlen_strr�rrr�_prefix_from_prefix_stringWs

z)_IPAddressBase._prefix_from_prefix_stringcCs�z|�|�}Wntk
r,|�|�YnXz|�|�WStk
rNYnX||jN}z|�|�WStk
r�|�|�YnXdS)aTurn a netmask/hostmask string into a prefix length

        Args:
            ip_str: The netmask/hostmask to be converted

        Returns:
            An integer, the prefix length.

        Raises:
            NetmaskValueError: If the input is not a valid netmask/hostmask
        N)�_ip_int_from_stringr<r�r�rDrl)r��ip_strr�rrr�_prefix_from_ip_stringps
z%_IPAddressBase._prefix_from_ip_stringcCs|jt|�ffSr)�	__class__rUr�rrr�
__reduce__�sz_IPAddressBase.__reduce__N)r7r8r9r>r:�propertyr�r�r�rjr�r��classmethodr�r�r�r�r�r�rrrrr��s.




	





!r�c@sdeZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zdd�Z
dd�ZdS)rhz�A generic IP object.

    This IP class contains the version independent methods which are
    used by single IP addresses.
    rcCs|jSr�r\r�rrr�__int__�sz_BaseAddress.__int__cCs8z|j|jko|j|jkWStk
r2tYSXdSr)r\rzr|r-r)rrrr,�s
�z_BaseAddress.__eq__cCs`t|t�stSt|t�s(td||f��|j|jkrDtd||f��|j|jkr\|j|jkSdS�N�"%s and %s are not of the same typerfF)rBr�r-rhrirzr\r)rrrr0�s

��z_BaseAddress.__lt__cCs t|t�stS|�t|�|�Sr�rB�_compat_int_typesr-r�r�r)rrr�__add__�s
z_BaseAddress.__add__cCs t|t�stS|�t|�|�Srr�r)rrr�__sub__�s
z_BaseAddress.__sub__cCsd|jjt|�fS�Nz%s(%r)�r�r7rUr�rrr�__repr__�sz_BaseAddress.__repr__cCst|�|j��Sr)rU�_string_from_ip_intr\r�rrr�__str__�sz_BaseAddress.__str__cCsttt|j���Sr)�hash�hexr�r\r�rrr�__hash__�sz_BaseAddress.__hash__cCs
|j|fSr�rzr�rrrr��sz_BaseAddress._get_address_keycCs|j|jffSr)r�r\r�rrrr��sz_BaseAddress.__reduce__N)r7r8r9r>r:r�r,r0r�r�r�r�r�r�r�rrrrrh�srhc@sdeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zedd��Zedd��Zedd��Zedd��Zed d!��Zed"d#��Zed$d%��Zed&d'��Zd(d)�Zd*d+�Zd,d-�ZdHd0d1�ZdId2d3�Zed4d5��Zed6d7��Zd8d9�Z d:d;�Z!ed<d=��Z"ed>d?��Z#ed@dA��Z$edBdC��Z%edDdE��Z&edFdG��Z'd/S)Jr�z~A generic IP network object.

    This IP class contains the version independent methods which are
    used by networks.

    cCs
i|_dSr)�_cache)r*rFrrr�__init__�sz_BaseNetwork.__init__cCsd|jjt|�fSr�r�r�rrrr��sz_BaseNetwork.__repr__cCsd|j|jfS�N�%s/%d)r}r�r�rrrr��sz_BaseNetwork.__str__ccs8t|j�}t|j�}t|d|�D]}|�|�Vq"dS)z�Generate Iterator over usable hosts in a network.

        This is like __iter__ except it doesn't return the network
        or broadcast addresses.

        r"N�r�r}rvr&�_address_class�r*�network�	broadcast�xrrr�hosts�s

z_BaseNetwork.hostsccs8t|j�}t|j�}t||d�D]}|�|�Vq"dS�Nr"r�r�rrr�__iter__�s

z_BaseNetwork.__iter__cCslt|j�}t|j�}|dkr>|||kr0td��|�||�S|d7}|||krZtd��|�||�SdS)Nrzaddress out of ranger")r�r}rv�
IndexErrorr�)r*�nr�r�rrr�__getitem__�s

z_BaseNetwork.__getitem__cCsxt|t�stSt|t�s(td||f��|j|jkrDtd||f��|j|jkr\|j|jkS|j|jkrt|j|jkSdSr�)rBr�r-r�rirzr}�netmaskr)rrrr0s"

��z_BaseNetwork.__lt__cCsLz.|j|jko,|j|jko,t|j�t|j�kWStk
rFtYSXdSr)rzr}r�r�r|r-r)rrrr,s
��z_BaseNetwork.__eq__cCstt|j�t|j�A�Sr)r�r�r}r�r�rrrr�sz_BaseNetwork.__hash__cCsL|j|jkrdSt|t�rdSt|j�t|j�koBt|j�kSSdS�NF)rzrBr�r�r}r\rvr)rrr�__contains__s
�z_BaseNetwork.__contains__cCs(|j|kp&|j|kp&|j|kp&|j|kS)z*Tell if self is partly contained in other.)r}rvr)rrr�overlaps*s



�z_BaseNetwork.overlapscCs<|j�d�}|dkr8|�t|j�t|j�B�}||jd<|S)Nrv)r�rrr�r�r}�hostmask�r*r�rrrrv1s�
z_BaseNetwork.broadcast_addresscCs8|j�d�}|dkr4|�t|j�|jA�}||jd<|S)Nr�)r�rrr�r�r�rlr�rrrr�:s

z_BaseNetwork.hostmaskcCsd|j|jfSr�)r}r{r�rrr�with_prefixlenBsz_BaseNetwork.with_prefixlencCsd|j|jfS�N�%s/%s)r}r�r�rrr�with_netmaskFsz_BaseNetwork.with_netmaskcCsd|j|jfSr�)r}r�r�rrr�
with_hostmaskJsz_BaseNetwork.with_hostmaskcCst|j�t|j�dS)z&Number of hosts in the current subnet.r")r�rvr}r�rrr�
num_addressesNsz_BaseNetwork.num_addressescCsdt|�f}t|��dS)Nz%%200s has no associated address classr�r�rrrr�Ssz_BaseNetwork._address_classcCs|jSr)r{r�rrrr�[sz_BaseNetwork.prefixlenccs|j|jkstd||f��t|t�s2td|��|�|�sLtd||f��||krXdS|�d|j|jf�}|�	�\}}||kr�||kr�|�|�r�|V|�	�\}}qz|�|�r�|V|�	�\}}qzt
d|||f��qz||kr�|Vn"||kr�|Vnt
d|||f��dS)a�Remove an address from a larger block.

        For example:

            addr1 = ip_network('192.0.2.0/28')
            addr2 = ip_network('192.0.2.1/32')
            list(addr1.address_exclude(addr2)) =
                [IPv4Network('192.0.2.0/32'), IPv4Network('192.0.2.2/31'),
                 IPv4Network('192.0.2.4/30'), IPv4Network('192.0.2.8/29')]

        or IPv6:

            addr1 = ip_network('2001:db8::1/32')
            addr2 = ip_network('2001:db8::1/128')
            list(addr1.address_exclude(addr2)) =
                [ip_network('2001:db8::1/128'),
                 ip_network('2001:db8::2/127'),
                 ip_network('2001:db8::4/126'),
                 ip_network('2001:db8::8/125'),
                 ...
                 ip_network('2001:db8:8000::/33')]

        Args:
            other: An IPv4Network or IPv6Network object of the same type.

        Returns:
            An iterator of the IPv(4|6)Network objects which is self
            minus other.

        Raises:
            TypeError: If self and other are of differing address
              versions, or if other is not a network object.
            ValueError: If other is not completely contained by self.

        rfz%s is not a network objectz%s not contained in %sNr�z3Error performing exclusion: s1: %s s2: %s other: %s)rzrirBr��	subnet_ofrDr�r}r�rw�AssertionError)r*r+�s1�s2rrr�address_exclude_s@$�


�

��z_BaseNetwork.address_excludecCs`|j|jkrtd||f��|j|jkr,dS|j|jkr<dS|j|jkrLdS|j|jkr\dSdS)a�Compare two IP objects.

        This is only concerned about the comparison of the integer
        representation of the network addresses.  This means that the
        host bits aren't considered at all in this method.  If you want
        to compare host bits, you can easily enough do a
        'HostA._ip < HostB._ip'

        Args:
            other: An IP object.

        Returns:
            If the IP versions of self and other are the same, returns:

            -1 if self < other:
              eg: IPv4Network('192.0.2.0/25') < IPv4Network('192.0.2.128/25')
              IPv6Network('2001:db8::1000/124') <
                  IPv6Network('2001:db8::2000/124')
            0 if self == other
              eg: IPv4Network('192.0.2.0/24') == IPv4Network('192.0.2.0/24')
              IPv6Network('2001:db8::1000/124') ==
                  IPv6Network('2001:db8::1000/124')
            1 if self > other
              eg: IPv4Network('192.0.2.128/25') > IPv4Network('192.0.2.0/25')
                  IPv6Network('2001:db8::2000/124') >
                      IPv6Network('2001:db8::1000/124')

          Raises:
              TypeError if the IP versions are different.

        r�ryr"r)rzrir}r�r)rrr�compare_networks�s!�z_BaseNetwork.compare_networkscCs|j|j|jfS)z�Network-only key function.

        Returns an object that identifies this address' network and
        netmask. This function is a suitable "key" argument for sorted()
        and list.sort().

        )rzr}r�r�rrrr��sz_BaseNetwork._get_networks_keyr"Nc	cs�|j|jkr|VdS|dk	rJ||jkr0td��|dkr@td��||j}|dkrZtd��|j|}||jkr~td||f��t|j�}t|j�d}t|j�d|?}t|||�D]}|�||f�}|Vq�dS)a�The subnets which join to make the current subnet.

        In the case that self contains only one IP
        (self._prefixlen == 32 for IPv4 or self._prefixlen == 128
        for IPv6), yield an iterator with just ourself.

        Args:
            prefixlen_diff: An integer, the amount the prefix length
              should be increased by. This should not be set if
              new_prefix is also set.
            new_prefix: The desired new prefix length. This must be a
              larger number (smaller prefix) than the existing prefix.
              This should not be set if prefixlen_diff is also set.

        Returns:
            An iterator of IPv(4|6) objects.

        Raises:
            ValueError: The prefixlen_diff is too small or too large.
                OR
            prefixlen_diff and new_prefix are both set or new_prefix
              is a smaller number than the current prefix (smaller
              number means a larger network)

        Nznew prefix must be longerr"�(cannot set prefixlen_diff and new_prefixrzprefix length diff must be > 0z0prefix length diff %d is invalid for netblock %s)	r{rkrDr�r}rvr�r&r�)	r*�prefixlen_diff�
new_prefix�
new_prefixlenr#r$r%Znew_addrZcurrentrrrrw�s2



��
z_BaseNetwork.subnetscCs�|jdkr|S|dk	rB||jkr(td��|dkr8td��|j|}|j|}|dkrftd|j|f��|�t|j�t|j�|>@|f�S)a�The supernet containing the current network.

        Args:
            prefixlen_diff: An integer, the amount the prefix length of
              the network should be decreased by.  For example, given a
              /24 network and a prefixlen_diff of 3, a supernet with a
              /21 netmask is returned.

        Returns:
            An IPv4 network object.

        Raises:
            ValueError: If self.prefixlen - prefixlen_diff < 0. I.e., you have
              a negative prefix length.
                OR
            If prefixlen_diff and new_prefix are both set or new_prefix is a
              larger number than the current prefix (larger number means a
              smaller network)

        rNznew prefix must be shorterr"r�z;current prefixlen is %d, cannot have a prefixlen_diff of %d)r{rDr�r�r�r}r�)r*r�r�r�rrrrqs&



���z_BaseNetwork.supernetcCs|jjo|jjS�z�Test if the address is reserved for multicast use.

        Returns:
            A boolean, True if the address is a multicast address.
            See RFC 2373 2.7 for details.

        )r}�is_multicastrvr�rrrr�As	�z_BaseNetwork.is_multicastcCs^z4|j|jkrtd||���|j|jko2|j|jkWStk
rXtd||f��YnXdS)Nrfz3Unable to test subnet containment between %s and %s)rzrir}rvr|)�ar
rrr�
_is_subnet_ofMs
��z_BaseNetwork._is_subnet_ofcCs|�||�S)z1Return True if this network is a subnet of other.�r�r)rrrr�Ysz_BaseNetwork.subnet_ofcCs|�||�S)z3Return True if this network is a supernet of other.r�r)rrr�supernet_of]sz_BaseNetwork.supernet_ofcCs|jjo|jjS)��Test if the address is otherwise IETF reserved.

        Returns:
            A boolean, True if the address is within one of the
            reserved IPv6 Network ranges.

        )r}�is_reservedrvr�rrrr�as	�z_BaseNetwork.is_reservedcCs|jjo|jjS�z�Test if the address is reserved for link-local.

        Returns:
            A boolean, True if the address is reserved per RFC 4291.

        )r}�
is_link_localrvr�rrrr�ms�z_BaseNetwork.is_link_localcCs|jjo|jjS)z�Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv4-special-registry or iana-ipv6-special-registry.

        )r}�
is_privatervr�rrrr�xs	�z_BaseNetwork.is_privatecCs|jS)z�Test if this address is allocated for public networks.

        Returns:
            A boolean, True if the address is not reserved per
            iana-ipv4-special-registry or iana-ipv6-special-registry.

        �r�r�rrr�	is_global�s	z_BaseNetwork.is_globalcCs|jjo|jjS)��Test if the address is unspecified.

        Returns:
            A boolean, True if this is the unspecified address as defined in
            RFC 2373 2.5.2.

        )r}�is_unspecifiedrvr�rrrr��s	�z_BaseNetwork.is_unspecifiedcCs|jjo|jjS)��Test if the address is a loopback address.

        Returns:
            A boolean, True if the address is a loopback address as defined in
            RFC 2373 2.5.3.

        )r}�is_loopbackrvr�rrrr��s	�z_BaseNetwork.is_loopback)r"N)r"N)(r7r8r9r>r�r�r�r�r�r�r0r,r�r�r�r�rvr�r�r�r�r�r�r�r�r�r�rwrqr��staticmethodr�r�r�r�r�r�r�r�r�rrrrr��sf









K0

5
(








r�c
@s�eZdZdZdZdZdedZed�Z	eddd	d
ddd
ddg	�Z
eZiZdd�Z
edd��Zedd��Zedd��Zedd��Zdd�Zdd�Zedd��Zed d!��Zd"S)#r�zyBase IPv4 object.

    The following methods are used by IPv4 objects in both single IP
    addresses and networks.

    rrrr"�
0123456789���������rrcCst|�Srr�r�rrrr��sz$_BaseV4._explode_shorthand_ip_stringcCsn||jkrdt|t�r|}n.z|�|�}Wntk
rF|�|�}YnXt|�|��}||f|j|<|j|S�aMake a (netmask, prefix_len) tuple from the given argument.

        Argument can be:
        - an integer (the prefix length)
        - a string representing the prefix length (e.g. "24")
        - a string representing the prefix netmask (e.g. "255.255.255.0")
        )�_netmask_cacherBr�r�r?r�r@r��r��argr�r�rrr�
_make_netmask�s	

z_BaseV4._make_netmaskc
Csz|std��|�d�}t|�dkr.td|��ztt|j|�d�WStk
rt}ztd||f��W5d}~XYnXdS)aTurn the given IP string into an integer for comparison.

        Args:
            ip_str: A string, the IP ip_str.

        Returns:
            The IP ip_str as an integer.

        Raises:
            AddressValueError: if ip_str isn't a valid IPv4 Address.

        �Address cannot be empty�.rzExpected 4 octets in %rrO�%s in %rN)r<rVrWr�map�_parse_octetrD)r�r�Zoctets�excrrrr��s

�z_BaseV4._ip_int_from_stringcCs�|std��|j�|�s(d}t||��t|�dkrDd}t||��t|d�}|dkrr|ddkrrd	}t||��|d
kr�td|��|S)aConvert a decimal octet into an integer.

        Args:
            octet_str: A string, the number to parse.

        Returns:
            The octet as an integer.

        Raises:
            ValueError: if the octet isn't strictly a decimal from [0..255].

        zEmpty octet not permittedz#Only decimal digits permitted in %r�z$At most 3 characters permitted in %r�
�r�0z3Ambiguous (octal/decimal) value in %r not permittedr�zOctet %d (> 255) not permitted)rDr�r�rWr�)r�Z	octet_strr�Z	octet_intrrrr�s
z_BaseV4._parse_octetcCsd�dd�t|dd�D��S)z�Turns a 32-bit integer into dotted decimal notation.

        Args:
            ip_int: An integer, the IP address.

        Returns:
            The IP address as a string in dotted decimal notation.

        r�css0|](}tt|t�r"t�d|�dn|�VqdS)rrN)rUrBrCr	r
rrrr�	<genexpr>%s���z._BaseV4._string_from_ip_int.<locals>.<genexpr>rrO)�joinr)r�r�rrrr�s

�z_BaseV4._string_from_ip_intcsj|�d�}z�fdd�tt|�D�}Wntk
r<YdSXt|�t|�krRdS|d|dkrfdSdS)z�Test if the IP string is a hostmask (rather than a netmask).

        Args:
            ip_str: A string, the potential hostmask.

        Returns:
            A boolean, True if the IP string is a hostmask.

        r�csg|]}|�jkr|�qSr)�_valid_mask_octets�rr�r�rrr6s
z(_BaseV4._is_hostmask.<locals>.<listcomp>FrryT)rVr�r�rDrW)r*r�rd�partsrr�r�_is_hostmask*s

z_BaseV4._is_hostmaskcCs&t|��d�ddd�}d�|�dS)z�Return the reverse DNS pointer name for the IPv4 address.

        This implements the method described in RFC1035 3.5.

        r�Nryz
.in-addr.arpa)rUrVr)r*Zreverse_octetsrrrr�?sz_BaseV4._reverse_pointercCs|jSr�rkr�rrr�
max_prefixlenHsz_BaseV4.max_prefixlencCs|jSrr�r�rrrrjLsz_BaseV4.versionN)r7r8r9r>r:rz�
IPV4LENGTHrl�	frozensetr�rrkr�r�r�r�r�rr�rr�r�r
rjrrrrr��s.


$
	
r�c@s|eZdZdZdZdd�Zedd��Zedd��Zed	d
��Z	edd��Z
ed
d��Zedd��Zedd��Z
edd��ZdS)r@z/Represent and manipulate single IPv4 Addresses.�r\�__weakref__cCsxt|t�r|�|�||_dSt|t�rL|�|d�t|�}t|d�|_dSt|�}d|krht	d|��|�
|�|_dS)a�
        Args:
            address: A string or integer representing the IP

              Additionally, an integer can be passed, so
              IPv4Address('192.0.2.1') == IPv4Address(3221225985).
              or, more generally
              IPv4Address(int(IPv4Address('192.0.2.1'))) ==
                IPv4Address('192.0.2.1')

        Raises:
            AddressValueError: If ipaddress isn't a valid IPv4 address.

        NrrOrT�Unexpected '/' in %r�rBr�r�r\rCr�rrrUr<r��r*rFZbvsZaddr_strrrrr�Ws


zIPv4Address.__init__cCs
t|j�S�z*The binary representation of this address.)rRr\r�rrr�packed{szIPv4Address.packedcCs||jjkS)z�Test if the address is otherwise IETF reserved.

         Returns:
             A boolean, True if the address is within the
             reserved IPv4 Network range.

        )�
_constants�_reserved_networkr�rrrr��s	zIPv4Address.is_reservedcst�fdd��jjD��S)z�Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv4-special-registry.

        c3s|]}�|kVqdSrr�rrmr�rrr�sz)IPv4Address.is_private.<locals>.<genexpr>��anyr�_private_networksr�rr�rr��s	zIPv4Address.is_privatecCs||jjko|jSr)r�_public_networkr�r�rrrr��s�zIPv4Address.is_globalcCs||jjkS)z�Test if the address is reserved for multicast use.

        Returns:
            A boolean, True if the address is multicast.
            See RFC 3171 for details.

        �r�_multicast_networkr�rrrr��s	zIPv4Address.is_multicastcCs||jjkS)z�Test if the address is unspecified.

        Returns:
            A boolean, True if this is the unspecified address as defined in
            RFC 5735 3.

        )r�_unspecified_addressr�rrrr��s	zIPv4Address.is_unspecifiedcCs||jjkS)z�Test if the address is a loopback address.

        Returns:
            A boolean, True if the address is a loopback per RFC 3330.

        )r�_loopback_networkr�rrrr��szIPv4Address.is_loopbackcCs||jjkS)z�Test if the address is reserved for link-local.

        Returns:
            A boolean, True if the address is link-local per RFC 3927.

        �r�_linklocal_networkr�rrrr��szIPv4Address.is_link_localN)r7r8r9r>r:r�r�rr�r�r�r�r�r�r�rrrrr@Qs&$










	r@c@sjeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zej	Z	e
dd��Ze
d
d��Ze
dd��Z
e
dd��ZdS)rLcCs�t|ttf�r2t�||�t|j�|_|j|_	dSt|t
�r�t�||d�t|�dkrht|d�|_	n|j|_	t|dd�|_|jj
|_
|jj|_dSt|�}t�||d�t|dd�|_|jj	|_	|jj
|_
|jj|_dS�Nrr"F)rJ)rBrCr�r@r�rHr\r�rkr{�tuplerWr�r�r�rY�r*rFrXrrrr��s(




zIPv4Interface.__init__cCsd|�|j�|jjfSr��r�r\r�r�r�rrrr��s�zIPv4Interface.__str__cCsFt�||�}|r|tkr|Sz|j|jkWStk
r@YdSXdSr�)r@r,r-r�r|�r*r+Z
address_equalrrrr,�szIPv4Interface.__eq__cCsRt�||�}|tkrtSz|j|jkp4|j|jko4|WStk
rLYdSXdSr�)r@r0r-r�r|�r*r+Zaddress_lessrrrr0�s�zIPv4Interface.__lt__cCs|j|jAt|jj�ASr�r\r{r�r�r}r�rrrr�szIPv4Interface.__hash__cCs
t|j�Sr)r@r\r�rrrraszIPv4Interface.ipcCsd|�|j�|jfSr��r�r\r{r�rrrr�
s�zIPv4Interface.with_prefixlencCsd|�|j�|jfSr��r�r\r�r�rrrr�s�zIPv4Interface.with_netmaskcCsd|�|j�|jfSr��r�r\r�r�rrrr�s�zIPv4Interface.with_hostmaskN)r7r8r9r�r�r,r0r�r�r�r�rar�r�r�rrrrrL�s


rLc@s*eZdZdZeZddd�Zedd��ZdS)	rHaeThis class represents and manipulates 32-bit IPv4 network + addresses..

    Attributes: [examples for IPv4Network('192.0.2.0/27')]
        .network_address: IPv4Address('192.0.2.0')
        .hostmask: IPv4Address('0.0.0.31')
        .broadcast_address: IPv4Address('192.0.2.32')
        .netmask: IPv4Address('255.255.255.224')
        .prefixlen: 27

    TcCs|t�||�t|ttf�r<t|�|_|�|j�\|_	|_
dSt|t�r�t|�dkr\|d}n|j}t|d�|_|�|�\|_	|_
t
|j�}|t
|j	�@|kr�|r�td|��nt|t
|j	�@�|_dSt|�}t|�|d��|_t|�dkr�|d}n|j}|�|�\|_	|_
|�rDtt
|j�t
|j	�@�|jk�rDtd|��tt
|j�t
|j	�@�|_|j
|jdk�rx|j|_dS)aInstantiate a new IPv4 network object.

        Args:
            address: A string or integer representing the IP [& network].
              '192.0.2.0/24'
              '192.0.2.0/255.255.255.0'
              '192.0.0.2/0.0.0.255'
              are all functionally the same in IPv4. Similarly,
              '192.0.2.1'
              '192.0.2.1/255.255.255.255'
              '192.0.2.1/32'
              are also functionally equivalent. That is to say, failing to
              provide a subnetmask will create an object with a mask of /32.

              If the mask (portion after the / in the argument) is given in
              dotted quad form, it is treated as a netmask if it starts with a
              non-zero field (e.g. /255.0.0.0 == /8) and as a hostmask if it
              starts with a zero field (e.g. 0.255.255.255 == /8), with the
              single exception of an all-zero mask which is treated as a
              netmask == /0. If no mask is given, a default of /32 is used.

              Additionally, an integer can be passed, so
              IPv4Network('192.0.2.1') == IPv4Network(3221225985)
              or, more generally
              IPv4Interface(int(IPv4Interface('192.0.2.1'))) ==
                IPv4Interface('192.0.2.1')

        Raises:
            AddressValueError: If ipaddress isn't a valid IPv4 address.
            NetmaskValueError: If the netmask isn't valid for
              an IPv4 address.
            ValueError: If strict is True and a network address is not
              supplied.

        Nr"r�%s has host bits setr)r�r�rBr�rCr@r}r�rkr�r{r%rWr�rDrYr�r�r��r*rFrJr�rrXrrrr�)sJ%
�


�
�
�zIPv4Network.__init__cCs&|jtd�ko|jtd�ko$|jS)z�Test if this address is allocated for public networks.

        Returns:
            A boolean, True if the address is not reserved per
            iana-ipv4-special-registry.

        �
100.64.0.0/10)r}rHrvr�r�rrrr�~s
	��zIPv4Network.is_globalN)T)	r7r8r9r>r@r�r�r�r�rrrrrHs

UrHc@s�eZdZed�Zed�Zed�Zed�Zed�ed�ed�ed�ed�ed�ed	�ed
�ed�ed�ed
�ed�ed�ed�gZed�Z	e
d�ZdS)�_IPv4Constantsz169.254.0.0/16z127.0.0.0/8z224.0.0.0/4r0z	0.0.0.0/8z
10.0.0.0/8z
172.16.0.0/12z192.0.0.0/29z192.0.0.170/31z192.0.2.0/24z192.168.0.0/16z
198.18.0.0/15z198.51.100.0/24z203.0.113.0/24z240.0.0.0/4z255.255.255.255/32z0.0.0.0N)r7r8r9rHr#r!rrrrr@r rrrrr1�s*�r1c@s�eZdZdZdZdZdedZdZe	d�Z
eZiZe
dd	��Ze
d
d��Ze
dd
��Ze
dd��Ze
ddd��Zdd�Zdd�Zedd��Zedd��ZdS)�_BaseV6zyBase IPv6 object.

    The following methods are used by IPv6 objects in both single IP
    addresses and networks.

    rrgrr"rZ0123456789ABCDEFabcdefcCsJ||jkr@t|t�r|}n
|�|�}t|�|��}||f|j|<|j|Sr�)r�rBr�r�rAr�r�rrrr��s	


z_BaseV6._make_netmaskc
Cs�|std��|�d�}d}t|�|kr:d||f}t|��d|dkr�zt|���j}Wn2tk
r�}ztd||f��W5d}~XYnX|�d	|d
?d@�|�d	|d@�|jd}t|�|kr�d
|d|f}t|��d}tdt|�d�D]*}	||	s�|dk	�rd|}t|��|	}q�|dk	�r�|}
t|�|d}|d�sj|
d8}
|
�rjd}t||��|d�s�|d8}|�r�d}t||��|j|
|}|dk�r0d}t||jd|f��njt|�|jk�r�d}t||j|f��|d�sd}t||��|d�s d}t||��t|�}
d}d}znd}
t	|
�D] }	|
d
K}
|
|�
||	�O}
�q>|
d
|K}
t	|d�D] }	|
d
K}
|
|�
||	�O}
�qx|
WStk
�r�}ztd||f��W5d}~XYnXdS)z�Turn an IPv6 ip_str into an integer.

        Args:
            ip_str: A string, the IPv6 ip_str.

        Returns:
            An int, the IPv6 address

        Raises:
            AddressValueError: if ip_str isn't a valid IPv6 Address.

        r��:rz At least %d parts expected in %rr�ryr�N�%xr�r"z!At most %d colons permitted in %rz At most one '::' permitted in %rrz0Leading ':' only permitted as part of '::' in %rz1Trailing ':' only permitted as part of '::' in %rz/Expected at most %d other parts with '::' in %rz,Exactly %d parts expected without '::' in %r)r<rVrWr@rpr\rs�
_HEXTET_COUNTr&�range�
_parse_hextetrD)r�r�r
Z
_min_partsr�Zipv4_intrZ
_max_partsZ
skip_indexrZparts_hiZparts_loZ
parts_skippedr�rrrr��s�
"
�






z_BaseV6._ip_int_from_stringcCs>|j�|�std|��t|�dkr4d}t||��t|d�S)a&Convert an IPv6 hextet string into an integer.

        Args:
            hextet_str: A string, the number to parse.

        Returns:
            The hextet as an integer.

        Raises:
            ValueError: if the input isn't strictly a hex number from
              [0..FFFF].

        zOnly hex digits permitted in %rrz$At most 4 characters permitted in %rr)�_HEX_DIGITSr�rDrWr�)r�Z
hextet_strr�rrrr8>sz_BaseV6._parse_hextetc	Cs�d}d}d}d}t|�D]>\}}|dkrN|d7}|dkr<|}||krV|}|}qd}d}q|dkr�||}|t|�kr~|dg7}dg|||�<|dkr�dg|}|S)a�Compresses a list of hextets.

        Compresses a list of strings, replacing the longest continuous
        sequence of "0" in the list with "" and adding empty strings at
        the beginning or at the end of the string such that subsequently
        calling ":".join(hextets) will produce the compressed version of
        the IPv6 address.

        Args:
            hextets: A list of strings, the hextets to compress.

        Returns:
            A list of strings.

        ryrrr"�)�	enumeraterW)	r��hextetsZbest_doublecolon_startZbest_doublecolon_lenZdoublecolon_startZdoublecolon_len�indexZhextetZbest_doublecolon_endrrr�_compress_hextetsXs0�

z_BaseV6._compress_hextetsNcsZ|dkrt|j�}||jkr$td��d|��fdd�tddd�D�}|�|�}d	�|�S)
a,Turns a 128-bit integer into hexadecimal notation.

        Args:
            ip_int: An integer, the IP address.

        Returns:
            A string, the hexadecimal representation of the address.

        Raises:
            ValueError: The address is bigger than 128 bits of all ones.

        NzIPv6 address is too large�%032xcs&g|]}dt�||d�d��qS)r4rr)r�r	�Zhex_strrrr�sz/_BaseV6._string_from_ip_int.<locals>.<listcomp>rr;rr3)r�r\rlrDr7r>r)r�r�r<rr@rr��s


z_BaseV6._string_from_ip_intcs�t|t�rt|j�}nt|t�r,t|j�}nt|�}|�|�}d|��fdd�tddd�D�}t|ttf�r�dd�	|�|j
fSd�	|�S)	z�Expand a shortened IPv6 address.

        Args:
            ip_str: A string, the IPv6 address.

        Returns:
            A string, the expanded IPv6 address.

        r?csg|]}�||d��qS)rrr	r@rrr�sz8_BaseV6._explode_shorthand_ip_string.<locals>.<listcomp>rr;rr�r3)rBrIrUr}rMrar�r7r�rr{)r*r�r�r
rr@rr��s



z$_BaseV6._explode_shorthand_ip_stringcCs&|jddd��dd�}d�|�dS)z�Return the reverse DNS pointer name for the IPv6 address.

        This implements the method described in RFC3596 2.5.

        Nryr3r:r�z	.ip6.arpa)r��replacer)r*Z
reverse_charsrrrr��sz_BaseV6._reverse_pointercCs|jSrrr�rrrr
�sz_BaseV6.max_prefixlencCs|jSrr�r�rrrrj�sz_BaseV6.version)N)r7r8r9r>r:rz�
IPV6LENGTHrlr6rr9rkr�r�r�r�r8r>r�r�r�r�r
rjrrrrr2�s0

h

/	
r2c@s�eZdZdZdZdd�Zedd��Zedd��Zed	d
��Z	edd��Z
ed
d��Zedd��Zedd��Z
edd��Zedd��Zedd��Zedd��Zedd��ZdS)rAz/Represent and manipulate single IPv6 Addresses.rcCsxt|t�r|�|�||_dSt|t�rL|�|d�t|�}t|d�|_dSt|�}d|krht	d|��|�
|�|_dS)aInstantiate a new IPv6 address object.

        Args:
            address: A string or integer representing the IP

              Additionally, an integer can be passed, so
              IPv6Address('2001:db8::') ==
                IPv6Address(42540766411282592856903984951653826560)
              or, more generally
              IPv6Address(int(IPv6Address('2001:db8::'))) ==
                IPv6Address('2001:db8::')

        Raises:
            AddressValueError: If address isn't a valid IPv6 address.

        NrrOrTrrrrrrr��s


zIPv6Address.__init__cCs
t|j�Sr)rSr\r�rrrr�szIPv6Address.packedcCs||jjkSr�rr�rrrr��s	zIPv6Address.is_multicastcst�fdd��jjD��S)r�c3s|]}�|kVqdSrrr	r�rrrsz*IPv6Address.is_reserved.<locals>.<genexpr>)rr�_reserved_networksr�rr�rr�s	zIPv6Address.is_reservedcCs||jjkSr�r"r�rrrr�szIPv6Address.is_link_localcCs||jjkS�a`Test if the address is reserved for site-local.

        Note that the site-local address space has been deprecated by RFC 3879.
        Use is_private to test if this address is in the space of unique local
        addresses as defined by RFC 4193.

        Returns:
            A boolean, True if the address is reserved per RFC 3513 2.5.6.

        )r�_sitelocal_networkr�rrr�
is_site_localszIPv6Address.is_site_localcst�fdd��jjD��S)z�Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv6-special-registry.

        c3s|]}�|kVqdSrrrr�rrr3sz)IPv6Address.is_private.<locals>.<genexpr>rr�rr�rr�*s	zIPv6Address.is_privatecCs|jS)z�Test if this address is allocated for public networks.

        Returns:
            A boolean, true if the address is not reserved per
            iana-ipv6-special-registry.

        r�r�rrrr�5s	zIPv6Address.is_globalcCs
|jdkS)r�rr�r�rrrr�@s	zIPv6Address.is_unspecifiedcCs
|jdkS)r�r"r�r�rrrr�Ks	zIPv6Address.is_loopbackcCs |jd?dkrdSt|jd@�S)z�Return the IPv4 mapped address.

        Returns:
            If the IPv6 address is a v4 mapped address, return the
            IPv4 mapped address. Return None otherwise.

        r;r5N����r\r@r�rrr�ipv4_mappedVs	zIPv6Address.ipv4_mappedcCs4|jd?dkrdSt|jd?d@�t|jd@�fS)z�Tuple of embedded teredo IPs.

        Returns:
            Tuple of the (server, client) IPs or None if the address
            doesn't appear to be a teredo address (doesn't start with
            2001::/32)

        �`i NrrGrHr�rrr�teredocs

�zIPv6Address.teredocCs$|jd?dkrdSt|jd?d@�S)z�Return the IPv4 6to4 embedded address.

        Returns:
            The IPv4 6to4-embedded address if present or None if the
            address doesn't appear to contain a 6to4 embedded address.

        �pi N�PrGrHr�rrr�	sixtofourrs	zIPv6Address.sixtofourN)r7r8r9r>r:r�r�rr�r�r�rFr�r�r�r�rIrKrNrrrrrA�s6%





	











rAc@s�eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zej	Z	e
dd��Ze
d
d��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��ZdS)rMcCs�t|ttf�r2t�||�t|j�|_|j|_	dSt|t
�r�t�||d�t|�dkrht|d�|_	n|j|_	t|dd�|_|jj
|_
|jj|_dSt|�}t�||d�t|dd�|_|jj
|_
|jj	|_	|jj|_dSr$)rBrCr�rAr�rIr\r�rkr{r%rWr�r�r�rYr&rrrr��s(




zIPv6Interface.__init__cCsd|�|j�|jjfSr�r'r�rrrr��s�zIPv6Interface.__str__cCsFt�||�}|r|tkr|Sz|j|jkWStk
r@YdSXdSr�)rAr,r-r�r|r(rrrr,�szIPv6Interface.__eq__cCsRt�||�}|tkrtSz|j|jkp4|j|jko4|WStk
rLYdSXdSr�)rAr0r-r�r|r)rrrr0�s�zIPv6Interface.__lt__cCs|j|jAt|jj�ASrr*r�rrrr��szIPv6Interface.__hash__cCs
t|j�Sr)rAr\r�rrrra�szIPv6Interface.ipcCsd|�|j�|jfSr�r+r�rrrr��s�zIPv6Interface.with_prefixlencCsd|�|j�|jfSr�r,r�rrrr��s�zIPv6Interface.with_netmaskcCsd|�|j�|jfSr�r-r�rrrr��s�zIPv6Interface.with_hostmaskcCs|jdko|jjSr)r\r�r�r�rrrr��szIPv6Interface.is_unspecifiedcCs|jdko|jjSr�)r\r�r�r�rrrr��szIPv6Interface.is_loopbackN)r7r8r9r�r�r,r0r�r�r�r�rar�r�r�r�r�rrrrrM�s$




rMc@s2eZdZdZeZd
dd�Zdd�Zedd��Z	d	S)rIavThis class represents and manipulates 128-bit IPv6 networks.

    Attributes: [examples for IPv6('2001:db8::1000/124')]
        .network_address: IPv6Address('2001:db8::1000')
        .hostmask: IPv6Address('::f')
        .broadcast_address: IPv6Address('2001:db8::100f')
        .netmask: IPv6Address('ffff:ffff:ffff:ffff:ffff:ffff:ffff:fff0')
        .prefixlen: 124

    TcCs|t�||�t|ttf�r<t|�|_|�|j�\|_	|_
dSt|t�r�t|�dkr\|d}n|j}|�|�\|_	|_
t|d�|_t
|j�}|t
|j	�@|kr�|r�td|��nt|t
|j	�@�|_dSt|�}t|�|d��|_t|�dkr�|d}n|j}|�|�\|_	|_
|�rDtt
|j�t
|j	�@�|jk�rDtd|��tt
|j�t
|j	�@�|_|j
|jdk�rx|j|_dS)a�Instantiate a new IPv6 Network object.

        Args:
            address: A string or integer representing the IPv6 network or the
              IP and prefix/netmask.
              '2001:db8::/128'
              '2001:db8:0000:0000:0000:0000:0000:0000/128'
              '2001:db8::'
              are all functionally the same in IPv6.  That is to say,
              failing to provide a subnetmask will create an object with
              a mask of /128.

              Additionally, an integer can be passed, so
              IPv6Network('2001:db8::') ==
                IPv6Network(42540766411282592856903984951653826560)
              or, more generally
              IPv6Network(int(IPv6Network('2001:db8::'))) ==
                IPv6Network('2001:db8::')

            strict: A boolean. If true, ensure that we have been passed
              A true network address, eg, 2001:db8::1000/124 and not an
              IP address on a network, eg, 2001:db8::1/124.

        Raises:
            AddressValueError: If address isn't a valid IPv6 address.
            NetmaskValueError: If the netmask isn't valid for
              an IPv6 address.
            ValueError: If strict was True and a network address was not
              supplied.

        Nr"rr.r)r�r�rBrCr�rAr}r�rkr�r{r%rWr�rDrYr�r�r�r/rrrr��sJ 
�


�
�
�zIPv6Network.__init__ccs<t|j�}t|j�}t|d|d�D]}|�|�Vq&dS)z�Generate Iterator over usable hosts in a network.

          This is like __iter__ except it doesn't return the
          Subnet-Router anycast address.

        r"Nr�r�rrrr�6	s

zIPv6Network.hostscCs|jjo|jjSrD)r}rFrvr�rrrrFB	s�zIPv6Network.is_site_localN)T)
r7r8r9r>rAr�r�r�r�rFrrrrrI�s
OrIc@s�eZdZed�Zed�Zed�ed�ed�ed�ed�ed�ed	�ed
�ed�ed�g
Zed�ed
�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�ed�gZed�ZdS)�_IPv6Constantsz	fe80::/10zff00::/8z::1/128z::/128z
::ffff:0:0/96z100::/64z	2001::/23z2001:2::/48z
2001:db8::/32z2001:10::/28zfc00::/7z::/8z100::/8z200::/7z400::/6z800::/5z1000::/4z4000::/3z6000::/3z8000::/3zA000::/3zC000::/3zE000::/4zF000::/5zF800::/6zFE00::/9z	fec0::/10N)	r7r8r9rIr#rrrCrErrrrrOR	s<��rO)r")T)6r>Z
__future__rr r	�__version__r�r�Zlong�	NameErrorZunicoderU�strr�
from_bytesrr|r�hasattrrr&�objectr'rrBrDr<r?rGrKrNrRrSrYrbrernrxr�r�r�rhr�r�r@rLrHr1rr2rArMrIrOrrrr�<module>s�

	


)$
$#716=X*vSr 5W{!site-packages/pip/_vendor/__pycache__/__init__.cpython-38.pyc000064400000005415151446177000020121 0ustar00U

��.e1�@s�dZddlmZddlZddlZddlZdZej�	ej�
e��Zdd�Z
e�r�e�ej�ed��ejejdd�<e
d�e
d	�e
d
�e
d�e
d�e
d
�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d�e
d �e
d!�e
d"�e
d#�e
d$�e
d%�e
d&�e
d'�e
d(�e
d)�e
d*�e
d+�e
d,�e
d-�e
d.�e
d/�e
d0�e
d1�e
d2�e
d3�e
d4�e
d5�e
d6�e
d7�dS)8z�
pip._vendor is for vendoring dependencies of pip to prevent needing pip to
depend on something external.

Files inside of pip._vendor should be considered immutable and should only be
updated to versions from upstream.
�)�absolute_importNFcCsvd�t|�}zt|t�t�dd�Wntk
r8Yn:Xtj|tj|<|�dd�\}}t	tj||tj|�dS)Nz{0}.{1}r)�level�.�)
�format�__name__�
__import__�globals�locals�ImportError�sys�modules�rsplit�setattr)Z
modulenameZ
vendored_name�base�head�r�8/usr/lib/python3.8/site-packages/pip/_vendor/__init__.py�vendoreds	rz*.whlZcachecontrolZcoloramaZcontextlib2ZdistlibZdistroZhtml5libZsixz	six.moveszsix.moves.urllibzsix.moves.urllib.parseZ	packagingzpackaging.versionzpackaging.specifiersZpep517Z
pkg_resourcesZprogressZpytomlZretryingZrequestszrequests.exceptionszrequests.packageszrequests.packages.urllib3z&requests.packages.urllib3._collectionsz$requests.packages.urllib3.connectionz(requests.packages.urllib3.connectionpoolz!requests.packages.urllib3.contribz*requests.packages.urllib3.contrib.ntlmpoolz+requests.packages.urllib3.contrib.pyopensslz$requests.packages.urllib3.exceptionsz requests.packages.urllib3.fieldsz"requests.packages.urllib3.filepostz"requests.packages.urllib3.packagesz/requests.packages.urllib3.packages.ordered_dictz&requests.packages.urllib3.packages.sixz5requests.packages.urllib3.packages.ssl_match_hostnamezErequests.packages.urllib3.packages.ssl_match_hostname._implementationz%requests.packages.urllib3.poolmanagerz!requests.packages.urllib3.requestz"requests.packages.urllib3.responsezrequests.packages.urllib3.utilz)requests.packages.urllib3.util.connectionz&requests.packages.urllib3.util.requestz'requests.packages.urllib3.util.responsez$requests.packages.urllib3.util.retryz#requests.packages.urllib3.util.ssl_z&requests.packages.urllib3.util.timeoutz"requests.packages.urllib3.util.urlZurllib3)�__doc__Z
__future__rZglobZos.path�osrZ	DEBUNDLED�path�abspath�dirname�__file__Z	WHEEL_DIRr�joinrrrr�<module>sr$site-packages/pip/_vendor/webencodings/x_user_defined.py000064400000010323151446177000017520 0ustar00# coding: utf-8
"""

    webencodings.x_user_defined
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~

    An implementation of the x-user-defined encoding.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

from __future__ import unicode_literals

import codecs


### Codec APIs

class Codec(codecs.Codec):

    def encode(self, input, errors='strict'):
        return codecs.charmap_encode(input, errors, encoding_table)

    def decode(self, input, errors='strict'):
        return codecs.charmap_decode(input, errors, decoding_table)


class IncrementalEncoder(codecs.IncrementalEncoder):
    def encode(self, input, final=False):
        return codecs.charmap_encode(input, self.errors, encoding_table)[0]


class IncrementalDecoder(codecs.IncrementalDecoder):
    def decode(self, input, final=False):
        return codecs.charmap_decode(input, self.errors, decoding_table)[0]


class StreamWriter(Codec, codecs.StreamWriter):
    pass


class StreamReader(Codec, codecs.StreamReader):
    pass


### encodings module API

codec_info = codecs.CodecInfo(
    name='x-user-defined',
    encode=Codec().encode,
    decode=Codec().decode,
    incrementalencoder=IncrementalEncoder,
    incrementaldecoder=IncrementalDecoder,
    streamreader=StreamReader,
    streamwriter=StreamWriter,
)


### Decoding Table

# Python 3:
# for c in range(256): print('    %r' % chr(c if c < 128 else c + 0xF700))
decoding_table = (
    '\x00'
    '\x01'
    '\x02'
    '\x03'
    '\x04'
    '\x05'
    '\x06'
    '\x07'
    '\x08'
    '\t'
    '\n'
    '\x0b'
    '\x0c'
    '\r'
    '\x0e'
    '\x0f'
    '\x10'
    '\x11'
    '\x12'
    '\x13'
    '\x14'
    '\x15'
    '\x16'
    '\x17'
    '\x18'
    '\x19'
    '\x1a'
    '\x1b'
    '\x1c'
    '\x1d'
    '\x1e'
    '\x1f'
    ' '
    '!'
    '"'
    '#'
    '$'
    '%'
    '&'
    "'"
    '('
    ')'
    '*'
    '+'
    ','
    '-'
    '.'
    '/'
    '0'
    '1'
    '2'
    '3'
    '4'
    '5'
    '6'
    '7'
    '8'
    '9'
    ':'
    ';'
    '<'
    '='
    '>'
    '?'
    '@'
    'A'
    'B'
    'C'
    'D'
    'E'
    'F'
    'G'
    'H'
    'I'
    'J'
    'K'
    'L'
    'M'
    'N'
    'O'
    'P'
    'Q'
    'R'
    'S'
    'T'
    'U'
    'V'
    'W'
    'X'
    'Y'
    'Z'
    '['
    '\\'
    ']'
    '^'
    '_'
    '`'
    'a'
    'b'
    'c'
    'd'
    'e'
    'f'
    'g'
    'h'
    'i'
    'j'
    'k'
    'l'
    'm'
    'n'
    'o'
    'p'
    'q'
    'r'
    's'
    't'
    'u'
    'v'
    'w'
    'x'
    'y'
    'z'
    '{'
    '|'
    '}'
    '~'
    '\x7f'
    '\uf780'
    '\uf781'
    '\uf782'
    '\uf783'
    '\uf784'
    '\uf785'
    '\uf786'
    '\uf787'
    '\uf788'
    '\uf789'
    '\uf78a'
    '\uf78b'
    '\uf78c'
    '\uf78d'
    '\uf78e'
    '\uf78f'
    '\uf790'
    '\uf791'
    '\uf792'
    '\uf793'
    '\uf794'
    '\uf795'
    '\uf796'
    '\uf797'
    '\uf798'
    '\uf799'
    '\uf79a'
    '\uf79b'
    '\uf79c'
    '\uf79d'
    '\uf79e'
    '\uf79f'
    '\uf7a0'
    '\uf7a1'
    '\uf7a2'
    '\uf7a3'
    '\uf7a4'
    '\uf7a5'
    '\uf7a6'
    '\uf7a7'
    '\uf7a8'
    '\uf7a9'
    '\uf7aa'
    '\uf7ab'
    '\uf7ac'
    '\uf7ad'
    '\uf7ae'
    '\uf7af'
    '\uf7b0'
    '\uf7b1'
    '\uf7b2'
    '\uf7b3'
    '\uf7b4'
    '\uf7b5'
    '\uf7b6'
    '\uf7b7'
    '\uf7b8'
    '\uf7b9'
    '\uf7ba'
    '\uf7bb'
    '\uf7bc'
    '\uf7bd'
    '\uf7be'
    '\uf7bf'
    '\uf7c0'
    '\uf7c1'
    '\uf7c2'
    '\uf7c3'
    '\uf7c4'
    '\uf7c5'
    '\uf7c6'
    '\uf7c7'
    '\uf7c8'
    '\uf7c9'
    '\uf7ca'
    '\uf7cb'
    '\uf7cc'
    '\uf7cd'
    '\uf7ce'
    '\uf7cf'
    '\uf7d0'
    '\uf7d1'
    '\uf7d2'
    '\uf7d3'
    '\uf7d4'
    '\uf7d5'
    '\uf7d6'
    '\uf7d7'
    '\uf7d8'
    '\uf7d9'
    '\uf7da'
    '\uf7db'
    '\uf7dc'
    '\uf7dd'
    '\uf7de'
    '\uf7df'
    '\uf7e0'
    '\uf7e1'
    '\uf7e2'
    '\uf7e3'
    '\uf7e4'
    '\uf7e5'
    '\uf7e6'
    '\uf7e7'
    '\uf7e8'
    '\uf7e9'
    '\uf7ea'
    '\uf7eb'
    '\uf7ec'
    '\uf7ed'
    '\uf7ee'
    '\uf7ef'
    '\uf7f0'
    '\uf7f1'
    '\uf7f2'
    '\uf7f3'
    '\uf7f4'
    '\uf7f5'
    '\uf7f6'
    '\uf7f7'
    '\uf7f8'
    '\uf7f9'
    '\uf7fa'
    '\uf7fb'
    '\uf7fc'
    '\uf7fd'
    '\uf7fe'
    '\uf7ff'
)

### Encoding table
encoding_table = codecs.charmap_build(decoding_table)
site-packages/pip/_vendor/webencodings/labels.py000064400000021423151446177000016002 0ustar00"""

    webencodings.labels
    ~~~~~~~~~~~~~~~~~~~

    Map encoding labels to their name.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

# XXX Do not edit!
# This file is automatically generated by mklabels.py

LABELS = {
    'unicode-1-1-utf-8':   'utf-8',
    'utf-8':               'utf-8',
    'utf8':                'utf-8',
    '866':                 'ibm866',
    'cp866':               'ibm866',
    'csibm866':            'ibm866',
    'ibm866':              'ibm866',
    'csisolatin2':         'iso-8859-2',
    'iso-8859-2':          'iso-8859-2',
    'iso-ir-101':          'iso-8859-2',
    'iso8859-2':           'iso-8859-2',
    'iso88592':            'iso-8859-2',
    'iso_8859-2':          'iso-8859-2',
    'iso_8859-2:1987':     'iso-8859-2',
    'l2':                  'iso-8859-2',
    'latin2':              'iso-8859-2',
    'csisolatin3':         'iso-8859-3',
    'iso-8859-3':          'iso-8859-3',
    'iso-ir-109':          'iso-8859-3',
    'iso8859-3':           'iso-8859-3',
    'iso88593':            'iso-8859-3',
    'iso_8859-3':          'iso-8859-3',
    'iso_8859-3:1988':     'iso-8859-3',
    'l3':                  'iso-8859-3',
    'latin3':              'iso-8859-3',
    'csisolatin4':         'iso-8859-4',
    'iso-8859-4':          'iso-8859-4',
    'iso-ir-110':          'iso-8859-4',
    'iso8859-4':           'iso-8859-4',
    'iso88594':            'iso-8859-4',
    'iso_8859-4':          'iso-8859-4',
    'iso_8859-4:1988':     'iso-8859-4',
    'l4':                  'iso-8859-4',
    'latin4':              'iso-8859-4',
    'csisolatincyrillic':  'iso-8859-5',
    'cyrillic':            'iso-8859-5',
    'iso-8859-5':          'iso-8859-5',
    'iso-ir-144':          'iso-8859-5',
    'iso8859-5':           'iso-8859-5',
    'iso88595':            'iso-8859-5',
    'iso_8859-5':          'iso-8859-5',
    'iso_8859-5:1988':     'iso-8859-5',
    'arabic':              'iso-8859-6',
    'asmo-708':            'iso-8859-6',
    'csiso88596e':         'iso-8859-6',
    'csiso88596i':         'iso-8859-6',
    'csisolatinarabic':    'iso-8859-6',
    'ecma-114':            'iso-8859-6',
    'iso-8859-6':          'iso-8859-6',
    'iso-8859-6-e':        'iso-8859-6',
    'iso-8859-6-i':        'iso-8859-6',
    'iso-ir-127':          'iso-8859-6',
    'iso8859-6':           'iso-8859-6',
    'iso88596':            'iso-8859-6',
    'iso_8859-6':          'iso-8859-6',
    'iso_8859-6:1987':     'iso-8859-6',
    'csisolatingreek':     'iso-8859-7',
    'ecma-118':            'iso-8859-7',
    'elot_928':            'iso-8859-7',
    'greek':               'iso-8859-7',
    'greek8':              'iso-8859-7',
    'iso-8859-7':          'iso-8859-7',
    'iso-ir-126':          'iso-8859-7',
    'iso8859-7':           'iso-8859-7',
    'iso88597':            'iso-8859-7',
    'iso_8859-7':          'iso-8859-7',
    'iso_8859-7:1987':     'iso-8859-7',
    'sun_eu_greek':        'iso-8859-7',
    'csiso88598e':         'iso-8859-8',
    'csisolatinhebrew':    'iso-8859-8',
    'hebrew':              'iso-8859-8',
    'iso-8859-8':          'iso-8859-8',
    'iso-8859-8-e':        'iso-8859-8',
    'iso-ir-138':          'iso-8859-8',
    'iso8859-8':           'iso-8859-8',
    'iso88598':            'iso-8859-8',
    'iso_8859-8':          'iso-8859-8',
    'iso_8859-8:1988':     'iso-8859-8',
    'visual':              'iso-8859-8',
    'csiso88598i':         'iso-8859-8-i',
    'iso-8859-8-i':        'iso-8859-8-i',
    'logical':             'iso-8859-8-i',
    'csisolatin6':         'iso-8859-10',
    'iso-8859-10':         'iso-8859-10',
    'iso-ir-157':          'iso-8859-10',
    'iso8859-10':          'iso-8859-10',
    'iso885910':           'iso-8859-10',
    'l6':                  'iso-8859-10',
    'latin6':              'iso-8859-10',
    'iso-8859-13':         'iso-8859-13',
    'iso8859-13':          'iso-8859-13',
    'iso885913':           'iso-8859-13',
    'iso-8859-14':         'iso-8859-14',
    'iso8859-14':          'iso-8859-14',
    'iso885914':           'iso-8859-14',
    'csisolatin9':         'iso-8859-15',
    'iso-8859-15':         'iso-8859-15',
    'iso8859-15':          'iso-8859-15',
    'iso885915':           'iso-8859-15',
    'iso_8859-15':         'iso-8859-15',
    'l9':                  'iso-8859-15',
    'iso-8859-16':         'iso-8859-16',
    'cskoi8r':             'koi8-r',
    'koi':                 'koi8-r',
    'koi8':                'koi8-r',
    'koi8-r':              'koi8-r',
    'koi8_r':              'koi8-r',
    'koi8-u':              'koi8-u',
    'csmacintosh':         'macintosh',
    'mac':                 'macintosh',
    'macintosh':           'macintosh',
    'x-mac-roman':         'macintosh',
    'dos-874':             'windows-874',
    'iso-8859-11':         'windows-874',
    'iso8859-11':          'windows-874',
    'iso885911':           'windows-874',
    'tis-620':             'windows-874',
    'windows-874':         'windows-874',
    'cp1250':              'windows-1250',
    'windows-1250':        'windows-1250',
    'x-cp1250':            'windows-1250',
    'cp1251':              'windows-1251',
    'windows-1251':        'windows-1251',
    'x-cp1251':            'windows-1251',
    'ansi_x3.4-1968':      'windows-1252',
    'ascii':               'windows-1252',
    'cp1252':              'windows-1252',
    'cp819':               'windows-1252',
    'csisolatin1':         'windows-1252',
    'ibm819':              'windows-1252',
    'iso-8859-1':          'windows-1252',
    'iso-ir-100':          'windows-1252',
    'iso8859-1':           'windows-1252',
    'iso88591':            'windows-1252',
    'iso_8859-1':          'windows-1252',
    'iso_8859-1:1987':     'windows-1252',
    'l1':                  'windows-1252',
    'latin1':              'windows-1252',
    'us-ascii':            'windows-1252',
    'windows-1252':        'windows-1252',
    'x-cp1252':            'windows-1252',
    'cp1253':              'windows-1253',
    'windows-1253':        'windows-1253',
    'x-cp1253':            'windows-1253',
    'cp1254':              'windows-1254',
    'csisolatin5':         'windows-1254',
    'iso-8859-9':          'windows-1254',
    'iso-ir-148':          'windows-1254',
    'iso8859-9':           'windows-1254',
    'iso88599':            'windows-1254',
    'iso_8859-9':          'windows-1254',
    'iso_8859-9:1989':     'windows-1254',
    'l5':                  'windows-1254',
    'latin5':              'windows-1254',
    'windows-1254':        'windows-1254',
    'x-cp1254':            'windows-1254',
    'cp1255':              'windows-1255',
    'windows-1255':        'windows-1255',
    'x-cp1255':            'windows-1255',
    'cp1256':              'windows-1256',
    'windows-1256':        'windows-1256',
    'x-cp1256':            'windows-1256',
    'cp1257':              'windows-1257',
    'windows-1257':        'windows-1257',
    'x-cp1257':            'windows-1257',
    'cp1258':              'windows-1258',
    'windows-1258':        'windows-1258',
    'x-cp1258':            'windows-1258',
    'x-mac-cyrillic':      'x-mac-cyrillic',
    'x-mac-ukrainian':     'x-mac-cyrillic',
    'chinese':             'gbk',
    'csgb2312':            'gbk',
    'csiso58gb231280':     'gbk',
    'gb2312':              'gbk',
    'gb_2312':             'gbk',
    'gb_2312-80':          'gbk',
    'gbk':                 'gbk',
    'iso-ir-58':           'gbk',
    'x-gbk':               'gbk',
    'gb18030':             'gb18030',
    'hz-gb-2312':          'hz-gb-2312',
    'big5':                'big5',
    'big5-hkscs':          'big5',
    'cn-big5':             'big5',
    'csbig5':              'big5',
    'x-x-big5':            'big5',
    'cseucpkdfmtjapanese': 'euc-jp',
    'euc-jp':              'euc-jp',
    'x-euc-jp':            'euc-jp',
    'csiso2022jp':         'iso-2022-jp',
    'iso-2022-jp':         'iso-2022-jp',
    'csshiftjis':          'shift_jis',
    'ms_kanji':            'shift_jis',
    'shift-jis':           'shift_jis',
    'shift_jis':           'shift_jis',
    'sjis':                'shift_jis',
    'windows-31j':         'shift_jis',
    'x-sjis':              'shift_jis',
    'cseuckr':             'euc-kr',
    'csksc56011987':       'euc-kr',
    'euc-kr':              'euc-kr',
    'iso-ir-149':          'euc-kr',
    'korean':              'euc-kr',
    'ks_c_5601-1987':      'euc-kr',
    'ks_c_5601-1989':      'euc-kr',
    'ksc5601':             'euc-kr',
    'ksc_5601':            'euc-kr',
    'windows-949':         'euc-kr',
    'csiso2022kr':         'iso-2022-kr',
    'iso-2022-kr':         'iso-2022-kr',
    'utf-16be':            'utf-16be',
    'utf-16':              'utf-16le',
    'utf-16le':            'utf-16le',
    'x-user-defined':      'x-user-defined',
}
site-packages/pip/_vendor/webencodings/tests.py000064400000014643151446177000015710 0ustar00# coding: utf-8
"""

    webencodings.tests
    ~~~~~~~~~~~~~~~~~~

    A basic test suite for Encoding.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

from __future__ import unicode_literals

from . import (lookup, LABELS, decode, encode, iter_decode, iter_encode,
               IncrementalDecoder, IncrementalEncoder, UTF8)


def assert_raises(exception, function, *args, **kwargs):
    try:
        function(*args, **kwargs)
    except exception:
        return
    else:  # pragma: no cover
        raise AssertionError('Did not raise %s.' % exception)


def test_labels():
    assert lookup('utf-8').name == 'utf-8'
    assert lookup('Utf-8').name == 'utf-8'
    assert lookup('UTF-8').name == 'utf-8'
    assert lookup('utf8').name == 'utf-8'
    assert lookup('utf8').name == 'utf-8'
    assert lookup('utf8 ').name == 'utf-8'
    assert lookup(' \r\nutf8\t').name == 'utf-8'
    assert lookup('u8') is None  # Python label.
    assert lookup('utf-8 ') is None  # Non-ASCII white space.

    assert lookup('US-ASCII').name == 'windows-1252'
    assert lookup('iso-8859-1').name == 'windows-1252'
    assert lookup('latin1').name == 'windows-1252'
    assert lookup('LATIN1').name == 'windows-1252'
    assert lookup('latin-1') is None
    assert lookup('LATİN1') is None  # ASCII-only case insensitivity.


def test_all_labels():
    for label in LABELS:
        assert decode(b'', label) == ('', lookup(label))
        assert encode('', label) == b''
        for repeat in [0, 1, 12]:
            output, _ = iter_decode([b''] * repeat, label)
            assert list(output) == []
            assert list(iter_encode([''] * repeat, label)) == []
        decoder = IncrementalDecoder(label)
        assert decoder.decode(b'') == ''
        assert decoder.decode(b'', final=True) == ''
        encoder = IncrementalEncoder(label)
        assert encoder.encode('') == b''
        assert encoder.encode('', final=True) == b''
    # All encoding names are valid labels too:
    for name in set(LABELS.values()):
        assert lookup(name).name == name


def test_invalid_label():
    assert_raises(LookupError, decode, b'\xEF\xBB\xBF\xc3\xa9', 'invalid')
    assert_raises(LookupError, encode, 'é', 'invalid')
    assert_raises(LookupError, iter_decode, [], 'invalid')
    assert_raises(LookupError, iter_encode, [], 'invalid')
    assert_raises(LookupError, IncrementalDecoder, 'invalid')
    assert_raises(LookupError, IncrementalEncoder, 'invalid')


def test_decode():
    assert decode(b'\x80', 'latin1') == ('€', lookup('latin1'))
    assert decode(b'\x80', lookup('latin1')) == ('€', lookup('latin1'))
    assert decode(b'\xc3\xa9', 'utf8') == ('é', lookup('utf8'))
    assert decode(b'\xc3\xa9', UTF8) == ('é', lookup('utf8'))
    assert decode(b'\xc3\xa9', 'ascii') == ('é', lookup('ascii'))
    assert decode(b'\xEF\xBB\xBF\xc3\xa9', 'ascii') == ('é', lookup('utf8'))  # UTF-8 with BOM

    assert decode(b'\xFE\xFF\x00\xe9', 'ascii') == ('é', lookup('utf-16be'))  # UTF-16-BE with BOM
    assert decode(b'\xFF\xFE\xe9\x00', 'ascii') == ('é', lookup('utf-16le'))  # UTF-16-LE with BOM
    assert decode(b'\xFE\xFF\xe9\x00', 'ascii') == ('\ue900', lookup('utf-16be'))
    assert decode(b'\xFF\xFE\x00\xe9', 'ascii') == ('\ue900', lookup('utf-16le'))

    assert decode(b'\x00\xe9', 'UTF-16BE') == ('é', lookup('utf-16be'))
    assert decode(b'\xe9\x00', 'UTF-16LE') == ('é', lookup('utf-16le'))
    assert decode(b'\xe9\x00', 'UTF-16') == ('é', lookup('utf-16le'))

    assert decode(b'\xe9\x00', 'UTF-16BE') == ('\ue900', lookup('utf-16be'))
    assert decode(b'\x00\xe9', 'UTF-16LE') == ('\ue900', lookup('utf-16le'))
    assert decode(b'\x00\xe9', 'UTF-16') == ('\ue900', lookup('utf-16le'))


def test_encode():
    assert encode('é', 'latin1') == b'\xe9'
    assert encode('é', 'utf8') == b'\xc3\xa9'
    assert encode('é', 'utf8') == b'\xc3\xa9'
    assert encode('é', 'utf-16') == b'\xe9\x00'
    assert encode('é', 'utf-16le') == b'\xe9\x00'
    assert encode('é', 'utf-16be') == b'\x00\xe9'


def test_iter_decode():
    def iter_decode_to_string(input, fallback_encoding):
        output, _encoding = iter_decode(input, fallback_encoding)
        return ''.join(output)
    assert iter_decode_to_string([], 'latin1') == ''
    assert iter_decode_to_string([b''], 'latin1') == ''
    assert iter_decode_to_string([b'\xe9'], 'latin1') == 'é'
    assert iter_decode_to_string([b'hello'], 'latin1') == 'hello'
    assert iter_decode_to_string([b'he', b'llo'], 'latin1') == 'hello'
    assert iter_decode_to_string([b'hell', b'o'], 'latin1') == 'hello'
    assert iter_decode_to_string([b'\xc3\xa9'], 'latin1') == 'é'
    assert iter_decode_to_string([b'\xEF\xBB\xBF\xc3\xa9'], 'latin1') == 'é'
    assert iter_decode_to_string([
        b'\xEF\xBB\xBF', b'\xc3', b'\xa9'], 'latin1') == 'é'
    assert iter_decode_to_string([
        b'\xEF\xBB\xBF', b'a', b'\xc3'], 'latin1') == 'a\uFFFD'
    assert iter_decode_to_string([
        b'', b'\xEF', b'', b'', b'\xBB\xBF\xc3', b'\xa9'], 'latin1') == 'é'
    assert iter_decode_to_string([b'\xEF\xBB\xBF'], 'latin1') == ''
    assert iter_decode_to_string([b'\xEF\xBB'], 'latin1') == 'ï»'
    assert iter_decode_to_string([b'\xFE\xFF\x00\xe9'], 'latin1') == 'é'
    assert iter_decode_to_string([b'\xFF\xFE\xe9\x00'], 'latin1') == 'é'
    assert iter_decode_to_string([
        b'', b'\xFF', b'', b'', b'\xFE\xe9', b'\x00'], 'latin1') == 'é'
    assert iter_decode_to_string([
        b'', b'h\xe9', b'llo'], 'x-user-defined') == 'h\uF7E9llo'


def test_iter_encode():
    assert b''.join(iter_encode([], 'latin1')) == b''
    assert b''.join(iter_encode([''], 'latin1')) == b''
    assert b''.join(iter_encode(['é'], 'latin1')) == b'\xe9'
    assert b''.join(iter_encode(['', 'é', '', ''], 'latin1')) == b'\xe9'
    assert b''.join(iter_encode(['', 'é', '', ''], 'utf-16')) == b'\xe9\x00'
    assert b''.join(iter_encode(['', 'é', '', ''], 'utf-16le')) == b'\xe9\x00'
    assert b''.join(iter_encode(['', 'é', '', ''], 'utf-16be')) == b'\x00\xe9'
    assert b''.join(iter_encode([
        '', 'h\uF7E9', '', 'llo'], 'x-user-defined')) == b'h\xe9llo'


def test_x_user_defined():
    encoded = b'2,\x0c\x0b\x1aO\xd9#\xcb\x0f\xc9\xbbt\xcf\xa8\xca'
    decoded = '2,\x0c\x0b\x1aO\uf7d9#\uf7cb\x0f\uf7c9\uf7bbt\uf7cf\uf7a8\uf7ca'
    encoded = b'aa'
    decoded = 'aa'
    assert decode(encoded, 'x-user-defined') == (decoded, lookup('x-user-defined'))
    assert encode(decoded, 'x-user-defined') == encoded
site-packages/pip/_vendor/webencodings/__pycache__/labels.cpython-38.opt-1.pyc000064400000007331151446177000023231 0ustar00U

��.e#��@s�dZddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd	d	d	d	d	d	d	d	d	d	d	d
d
d
ddddddddddd
d
d
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd d!d!d!d!d!d"d"d"d#d#d$d$d$d$d$d$d$d%d%d%d%d%d%d%d%d%d%d&d&d'd(d(d)d*��Zd+S),z�

    webencodings.labels
    ~~~~~~~~~~~~~~~~~~~

    Map encoding labels to their name.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�utf-8�ibm866�
iso-8859-2�
iso-8859-3�
iso-8859-4�
iso-8859-5�
iso-8859-6�
iso-8859-7�
iso-8859-8�iso-8859-8-i�iso-8859-10�iso-8859-13�iso-8859-14�iso-8859-15�iso-8859-16�koi8-r�koi8-u�	macintosh�windows-874�windows-1250�windows-1251�windows-1252�windows-1253�windows-1254�windows-1255�windows-1256�windows-1257�windows-1258�x-mac-cyrillic�gbk�gb18030�
hz-gb-2312�big5�euc-jp�iso-2022-jp�	shift_jis�euc-kr�iso-2022-kr�utf-16be�utf-16le�x-user-defined)�zunicode-1-1-utf-8r�utf8�866�cp866�csibm866r�csisolatin2rz
iso-ir-101z	iso8859-2Ziso88592z
iso_8859-2ziso_8859-2:1987�l2�latin2�csisolatin3rz
iso-ir-109z	iso8859-3Ziso88593z
iso_8859-3ziso_8859-3:1988�l3�latin3�csisolatin4rz
iso-ir-110z	iso8859-4Ziso88594z
iso_8859-4ziso_8859-4:1988�l4�latin4�csisolatincyrillic�cyrillicrz
iso-ir-144z	iso8859-5Ziso88595z
iso_8859-5ziso_8859-5:1988�arabiczasmo-708Zcsiso88596eZcsiso88596i�csisolatinarabiczecma-114rziso-8859-6-eziso-8859-6-iz
iso-ir-127z	iso8859-6Ziso88596z
iso_8859-6ziso_8859-6:1987�csisolatingreekzecma-118�elot_928�greek�greek8rz
iso-ir-126z	iso8859-7Ziso88597z
iso_8859-7ziso_8859-7:1987Zsun_eu_greekZcsiso88598e�csisolatinhebrew�hebrewr	ziso-8859-8-ez
iso-ir-138z	iso8859-8Ziso88598z
iso_8859-8ziso_8859-8:1988ZvisualZcsiso88598ir
Zlogical�csisolatin6rz
iso-ir-157z
iso8859-10Z	iso885910�l6�latin6rz
iso8859-13Z	iso885913r
z
iso8859-14Z	iso885914Zcsisolatin9rz
iso8859-15Z	iso885915ziso_8859-15�l9r�cskoi8rZkoiZkoi8r�koi8_rrZcsmacintoshZmacrzx-mac-romanzdos-874ziso-8859-11z
iso8859-11Z	iso885911ztis-620r�cp1250rzx-cp1250�cp1251rzx-cp1251zansi_x3.4-1968�ascii�cp1252�cp819�csisolatin1�ibm819z
iso-8859-1z
iso-ir-100z	iso8859-1Ziso88591z
iso_8859-1ziso_8859-1:1987�l1�latin1zus-asciirzx-cp1252�cp1253rzx-cp1253�cp1254�csisolatin5z
iso-8859-9z
iso-ir-148z	iso8859-9Ziso88599z
iso_8859-9ziso_8859-9:1989�l5�latin5rzx-cp1254�cp1255rzx-cp1255�cp1256rzx-cp1256�cp1257rzx-cp1257�cp1258rzx-cp1258rzx-mac-ukrainian�chineseZcsgb2312�csiso58gb231280�gb2312Zgb_2312z
gb_2312-80rz	iso-ir-58zx-gbkrr r!z
big5-hkscszcn-big5�csbig5zx-x-big5Zcseucpkdfmtjapaneser"zx-euc-jp�csiso2022jpr#�
csshiftjis�ms_kanjiz	shift-jisr$�sjiszwindows-31jzx-sjisZcseuckrZ
csksc56011987r%z
iso-ir-149�koreanzks_c_5601-1987zks_c_5601-1989�ksc5601Zksc_5601zwindows-949�csiso2022krr&r'zutf-16r(r)N)�__doc__ZLABELS�rere�C/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/labels.py�<module>s���site-packages/pip/_vendor/webencodings/__pycache__/__init__.cpython-38.opt-1.pyc000064400000022667151446177000023537 0ustar00U

��.eS)�@s�dZddlmZddlZddlmZdZddd	d
d�ZiZdd
�Z	dd�Z
dd�ZGdd�de�Z
e
d�Ze
d�Ze
d�Zd+dd�Zdd�Zedfdd�Zd,dd �Zd!d"�Zedfd#d$�Zd%d&�ZGd'd(�d(e�ZGd)d*�d*e�ZdS)-a

    webencodings
    ~~~~~~~~~~~~

    This is a Python implementation of the `WHATWG Encoding standard
    <http://encoding.spec.whatwg.org/>`. See README for details.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�)�unicode_literalsN�)�LABELSz0.5.1z
iso-8859-8zmac-cyrillicz	mac-romanZcp874)ziso-8859-8-izx-mac-cyrillic�	macintoshzwindows-874cCs|�d����d�S)a9Transform (only) ASCII letters to lower case: A-Z is mapped to a-z.

    :param string: An Unicode string.
    :returns: A new Unicode string.

    This is used for `ASCII case-insensitive
    <http://encoding.spec.whatwg.org/#ascii-case-insensitive>`_
    matching of encoding labels.
    The same matching is also used, among other things,
    for `CSS keywords <http://dev.w3.org/csswg/css-values/#keywords>`_.

    This is different from the :meth:`~py:str.lower` method of Unicode strings
    which also affect non-ASCII characters,
    sometimes mapping them into the ASCII range:

        >>> keyword = u'Bac\N{KELVIN SIGN}ground'
        >>> assert keyword.lower() == u'background'
        >>> assert ascii_lower(keyword) != keyword.lower()
        >>> assert ascii_lower(keyword) == u'bac\N{KELVIN SIGN}ground'

    �utf8)�encode�lower�decode)�string�r�E/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/__init__.py�ascii_lower#sr
cCsxt|�d��}t�|�}|dkr$dSt�|�}|dkrt|dkrLddlm}nt�||�}t�	|�}t
||�}|t|<|S)u<
    Look for an encoding by its label.
    This is the spec’s `get an encoding
    <http://encoding.spec.whatwg.org/#concept-encoding-get>`_ algorithm.
    Supported labels are listed there.

    :param label: A string.
    :returns:
        An :class:`Encoding` object, or :obj:`None` for an unknown label.

    z	

 Nzx-user-definedr)�
codec_info)r
�stripr�get�CACHEZx_user_definedr�PYTHON_NAMES�codecs�lookup�Encoding)Zlabel�name�encodingrZpython_namerrrr=s




rcCs.t|d�r|St|�}|dkr*td|��|S)z�
    Accept either an encoding object or label.

    :param encoding: An :class:`Encoding` object or a label string.
    :returns: An :class:`Encoding` object.
    :raises: :exc:`~exceptions.LookupError` for an unknown label.

    rNzUnknown encoding label: %r)�hasattrr�LookupError)Zencoding_or_labelrrrr�
_get_encoding[s	
rc@s eZdZdZdd�Zdd�ZdS)raOReresents a character encoding such as UTF-8,
    that can be used for decoding or encoding.

    .. attribute:: name

        Canonical name of the encoding

    .. attribute:: codec_info

        The actual implementation of the encoding,
        a stdlib :class:`~codecs.CodecInfo` object.
        See :func:`codecs.register`.

    cCs||_||_dS�N)rr)�selfrrrrr�__init__|szEncoding.__init__cCs
d|jS)Nz
<Encoding %s>)r)rrrr�__repr__�szEncoding.__repr__N)�__name__�
__module__�__qualname__�__doc__rrrrrrrmsrzutf-8zutf-16lezutf-16be�replacecCs2t|�}t|�\}}|p|}|j�||�d|fS)a�
    Decode a single string.

    :param input: A byte string
    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :return:
        A ``(output, encoding)`` tuple of an Unicode string
        and an :obj:`Encoding`.

    r)r�_detect_bomrr	)�input�fallback_encoding�errorsZbom_encodingrrrrr	�sr	cCsV|�d�rt|dd�fS|�d�r4t|dd�fS|�d�rNt|dd�fSd|fS)zBReturn (bom_encoding, input), with any BOM removed from the input.s���Ns��s�)�
startswith�_UTF16LE�_UTF16BE�UTF8)r%rrrr$�s


r$�strictcCst|�j�||�dS)a;
    Encode a single string.

    :param input: An Unicode string.
    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :return: A byte string.

    r)rrr)r%rr'rrrr�srcCs$t||�}t||�}t|�}||fS)a�
    "Pull"-based decoder.

    :param input:
        An iterable of byte strings.

        The input is first consumed just enough to determine the encoding
        based on the precense of a BOM,
        then consumed on demand when the return value is.
    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :returns:
        An ``(output, encoding)`` tuple.
        :obj:`output` is an iterable of Unicode strings,
        :obj:`encoding` is the :obj:`Encoding` that is being used.

    )�IncrementalDecoder�_iter_decode_generator�next)r%r&r'�decoder�	generatorrrrr�iter_decode�s

r4ccs�|j}t|�}|D]"}||�}|r|jV|VqXq|ddd�}|jV|rT|VdS|D]}||�}|r\|Vq\|ddd�}|r�|VdS)zqReturn a generator that first yields the :obj:`Encoding`,
    then yields output chukns as Unicode strings.

    �T��finalN)r	�iterr)r%r2r	�chunck�outputrrrr0�s(r0cCst||�j}t||�S)uY
    “Pull”-based encoder.

    :param input: An iterable of Unicode strings.
    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :returns: An iterable of byte strings.

    )�IncrementalEncoderr�_iter_encode_generator)r%rr'rrrr�iter_encode�sr=ccs6|D]}||�}|r|Vq|ddd�}|r2|VdS)N�Tr6r)r%rr9r:rrrr<sr<c@s$eZdZdZd	dd�Zd
dd�ZdS)r/uO
    “Push”-based decoder.

    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.

    r#cCs&t|�|_||_d|_d|_d|_dS)Nr5)r�_fallback_encoding�_errors�_buffer�_decoderr)rr&r'rrrrs

zIncrementalDecoder.__init__FcCs||j}|dk	r|||�S|j|}t|�\}}|dkrVt|�dkrP|sP||_dS|j}|j�|j�j}||_||_	|||�S)z�Decode one chunk of the input.

        :param input: A byte string.
        :param final:
            Indicate that no more input is available.
            Must be :obj:`True` if this is the last call.
        :returns: An Unicode string.

        Nr)r>)
rBrAr$�lenr?r�incrementaldecoderr@r	r)rr%r7r2rrrrr	's


zIncrementalDecoder.decodeN)r#)F)rr r!r"rr	rrrrr/s

r/c@seZdZdZedfdd�ZdS)r;u�
    “Push”-based encoder.

    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.

    .. method:: encode(input, final=False)

        :param input: An Unicode string.
        :param final:
            Indicate that no more input is available.
            Must be :obj:`True` if this is the last call.
        :returns: A byte string.

    r.cCst|�}|j�|�j|_dSr)rr�incrementalencoderr)rrr'rrrrTszIncrementalEncoder.__init__N)rr r!r"r-rrrrrr;Csr;)r#)r#)r"Z
__future__rr�labelsrZVERSIONrrr
rr�objectrr-r+r,r	r$rr4r0r=r<r/r;rrrr�<module>s4
�

 
3site-packages/pip/_vendor/webencodings/__pycache__/mklabels.cpython-38.opt-1.pyc000064400000003503151446177000023556 0ustar00U

��.e�@sfdZddlZzddlmZWn ek
r<ddlmZYnXdd�Zdd�Zedkrbe	ed	��dS)
z�

    webencodings.mklabels
    ~~~~~~~~~~~~~~~~~~~~~

    Regenarate the webencodings.labels module.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�N)�urlopencCs|S�N�)�stringrr�E/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/mklabels.py�assert_lowersrcsfdg}dd�t�t|����d��D�}tdd�|D���|��fdd�|D��|�d�d	�|�S)
Na"""

    webencodings.labels
    ~~~~~~~~~~~~~~~~~~~

    Map encoding labels to their name.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

# XXX Do not edit!
# This file is automatically generated by mklabels.py

LABELS = {
cSsLg|]D}|dD]6}|dD](}tt|���d�t|d��d�f�qqqS)Z	encodings�labels�u�name)�reprr�lstrip)�.0�category�encoding�labelrrr�
<listcomp>,s

��zgenerate.<locals>.<listcomp>�asciicss|]\}}t|�VqdSr��len�r
rr
rrr�	<genexpr>2szgenerate.<locals>.<genexpr>c3s,|]$\}}d|d�t|�|fVqdS)z    %s:%s %s,
� Nrr�Zmax_lenrrr3s��}�)	�json�loadsr�read�decode�max�extend�append�join)Zurl�partsrrrr�generates��
r$�__main__z.http://encoding.spec.whatwg.org/encodings.json)
�__doc__rZurllibr�ImportErrorZurllib.requestrr$�__name__�printrrrr�<module>s!site-packages/pip/_vendor/webencodings/__pycache__/mklabels.cpython-38.pyc000064400000003551151446177000022622 0ustar00U

��.e�@sfdZddlZzddlmZWn ek
r<ddlmZYnXdd�Zdd�Zedkrbe	ed	��dS)
z�

    webencodings.mklabels
    ~~~~~~~~~~~~~~~~~~~~~

    Regenarate the webencodings.labels module.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�N)�urlopencCs||��kst�|S�N)�lower�AssertionError)�string�r�E/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/mklabels.py�assert_lowersr	csfdg}dd�t�t|����d��D�}tdd�|D���|��fdd�|D��|�d�d	�|�S)
Na"""

    webencodings.labels
    ~~~~~~~~~~~~~~~~~~~

    Map encoding labels to their name.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

# XXX Do not edit!
# This file is automatically generated by mklabels.py

LABELS = {
cSsLg|]D}|dD]6}|dD](}tt|���d�t|d��d�f�qqqS)Z	encodings�labels�u�name)�reprr	�lstrip)�.0�category�encoding�labelrrr�
<listcomp>,s

��zgenerate.<locals>.<listcomp>�asciicss|]\}}t|�VqdSr��len�rrrrrr�	<genexpr>2szgenerate.<locals>.<genexpr>c3s,|]$\}}d|d�t|�|fVqdS)z    %s:%s %s,
� Nrr�Zmax_lenrrr3s��}�)	�json�loadsr�read�decode�max�extend�append�join)Zurl�partsr
rrr�generates��
r&�__main__z.http://encoding.spec.whatwg.org/encodings.json)
�__doc__rZurllibr�ImportErrorZurllib.requestr	r&�__name__�printrrrr�<module>s!site-packages/pip/_vendor/webencodings/__pycache__/tests.cpython-38.opt-1.pyc000064400000004547151446177000023137 0ustar00U

��.e��@s�dZddlmZddlmZmZmZmZmZm	Z	m
Z
mZmZdd�Z
dd�Zd	d
�Zdd�Zd
d�Zdd�Zdd�Zdd�Zdd�ZdS)z�

    webencodings.tests
    ~~~~~~~~~~~~~~~~~~

    A basic test suite for Encoding.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�)�unicode_literals�)	�lookup�LABELS�decode�encode�iter_decode�iter_encode�IncrementalDecoder�IncrementalEncoder�UTF8cOs6z|||�Wn|k
r$YdSXtd|��dS)NzDid not raise %s.)�AssertionError)Z	exceptionZfunction�args�kwargs�r�B/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/tests.py�
assert_raisess
rcCsdS�Nrrrrr�test_labelssrcCsNtD]2}dD]}tdg||�\}}qt|�}t|�}qtt���D]}qDdS)N)rr��)rrr
r�set�values)Zlabel�repeat�output�_�decoder�encoder�namerrr�test_all_labels0srcCsTtttdd�tttdd�tttgd�tttgd�tttd�tttd�dS)NséZinvalid�é)r�LookupErrorrrrr	r
rrrrr�test_invalid_labelCsr"cCsdSrrrrrr�test_decodeLsr#cCsdSrrrrrr�test_encodebsr$cCsdd�}dS)NcSst||�\}}d�|�S)N�)r�join)�inputZfallback_encodingrZ	_encodingrrr�iter_decode_to_stringlsz/test_iter_decode.<locals>.iter_decode_to_stringr)r(rrr�test_iter_decodeksr)cCsdSrrrrrr�test_iter_encode�sr*cCsd}d}d}d}dS)Ns2,O�#�ɻtϨ�u2,O#tsaaZaar)ZencodedZdecodedrrr�test_x_user_defined�s
r+N)�__doc__Z
__future__rr%rrrrrr	r
rrrrrr"r#r$r)r*r+rrrr�<module>s,			site-packages/pip/_vendor/webencodings/__pycache__/labels.cpython-38.pyc000064400000007331151446177000022272 0ustar00U

��.e#��@s�dZddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd	d	d	d	d	d	d	d	d	d	d	d
d
d
ddddddddddd
d
d
dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd d!d!d!d!d!d"d"d"d#d#d$d$d$d$d$d$d$d%d%d%d%d%d%d%d%d%d%d&d&d'd(d(d)d*��Zd+S),z�

    webencodings.labels
    ~~~~~~~~~~~~~~~~~~~

    Map encoding labels to their name.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�utf-8�ibm866�
iso-8859-2�
iso-8859-3�
iso-8859-4�
iso-8859-5�
iso-8859-6�
iso-8859-7�
iso-8859-8�iso-8859-8-i�iso-8859-10�iso-8859-13�iso-8859-14�iso-8859-15�iso-8859-16�koi8-r�koi8-u�	macintosh�windows-874�windows-1250�windows-1251�windows-1252�windows-1253�windows-1254�windows-1255�windows-1256�windows-1257�windows-1258�x-mac-cyrillic�gbk�gb18030�
hz-gb-2312�big5�euc-jp�iso-2022-jp�	shift_jis�euc-kr�iso-2022-kr�utf-16be�utf-16le�x-user-defined)�zunicode-1-1-utf-8r�utf8�866�cp866�csibm866r�csisolatin2rz
iso-ir-101z	iso8859-2Ziso88592z
iso_8859-2ziso_8859-2:1987�l2�latin2�csisolatin3rz
iso-ir-109z	iso8859-3Ziso88593z
iso_8859-3ziso_8859-3:1988�l3�latin3�csisolatin4rz
iso-ir-110z	iso8859-4Ziso88594z
iso_8859-4ziso_8859-4:1988�l4�latin4�csisolatincyrillic�cyrillicrz
iso-ir-144z	iso8859-5Ziso88595z
iso_8859-5ziso_8859-5:1988�arabiczasmo-708Zcsiso88596eZcsiso88596i�csisolatinarabiczecma-114rziso-8859-6-eziso-8859-6-iz
iso-ir-127z	iso8859-6Ziso88596z
iso_8859-6ziso_8859-6:1987�csisolatingreekzecma-118�elot_928�greek�greek8rz
iso-ir-126z	iso8859-7Ziso88597z
iso_8859-7ziso_8859-7:1987Zsun_eu_greekZcsiso88598e�csisolatinhebrew�hebrewr	ziso-8859-8-ez
iso-ir-138z	iso8859-8Ziso88598z
iso_8859-8ziso_8859-8:1988ZvisualZcsiso88598ir
Zlogical�csisolatin6rz
iso-ir-157z
iso8859-10Z	iso885910�l6�latin6rz
iso8859-13Z	iso885913r
z
iso8859-14Z	iso885914Zcsisolatin9rz
iso8859-15Z	iso885915ziso_8859-15�l9r�cskoi8rZkoiZkoi8r�koi8_rrZcsmacintoshZmacrzx-mac-romanzdos-874ziso-8859-11z
iso8859-11Z	iso885911ztis-620r�cp1250rzx-cp1250�cp1251rzx-cp1251zansi_x3.4-1968�ascii�cp1252�cp819�csisolatin1�ibm819z
iso-8859-1z
iso-ir-100z	iso8859-1Ziso88591z
iso_8859-1ziso_8859-1:1987�l1�latin1zus-asciirzx-cp1252�cp1253rzx-cp1253�cp1254�csisolatin5z
iso-8859-9z
iso-ir-148z	iso8859-9Ziso88599z
iso_8859-9ziso_8859-9:1989�l5�latin5rzx-cp1254�cp1255rzx-cp1255�cp1256rzx-cp1256�cp1257rzx-cp1257�cp1258rzx-cp1258rzx-mac-ukrainian�chineseZcsgb2312�csiso58gb231280�gb2312Zgb_2312z
gb_2312-80rz	iso-ir-58zx-gbkrr r!z
big5-hkscszcn-big5�csbig5zx-x-big5Zcseucpkdfmtjapaneser"zx-euc-jp�csiso2022jpr#�
csshiftjis�ms_kanjiz	shift-jisr$�sjiszwindows-31jzx-sjisZcseuckrZ
csksc56011987r%z
iso-ir-149�koreanzks_c_5601-1987zks_c_5601-1989�ksc5601Zksc_5601zwindows-949�csiso2022krr&r'zutf-16r(r)N)�__doc__ZLABELS�rere�C/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/labels.py�<module>s���site-packages/pip/_vendor/webencodings/__pycache__/x_user_defined.cpython-38.pyc000064400000005107151446177000024012 0ustar00U

��.e��	@s�dZddlmZddlZGdd�dej�ZGdd�dej�ZGdd	�d	ej�ZGd
d�deej�ZGdd
�d
eej�Zej	de�j
e�jeeeed�ZdZ
e�e
�ZdS)z�

    webencodings.x_user_defined
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~

    An implementation of the x-user-defined encoding.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�)�unicode_literalsNc@s eZdZddd�Zddd�ZdS)	�Codec�strictcCst�||t�S�N)�codecs�charmap_encode�encoding_table��self�input�errors�r
�K/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/x_user_defined.py�encodeszCodec.encodecCst�||t�Sr)r�charmap_decode�decoding_tabler	r
r
r�decodeszCodec.decodeN)r)r)�__name__�
__module__�__qualname__rrr
r
r
rrs
rc@seZdZddd�ZdS)�IncrementalEncoderFcCst�||jt�dS�Nr)rrrr�r
r�finalr
r
rrszIncrementalEncoder.encodeN)F)rrrrr
r
r
rrsrc@seZdZddd�ZdS)�IncrementalDecoderFcCst�||jt�dSr)rrrrrr
r
rr$szIncrementalDecoder.decodeN)F)rrrrr
r
r
rr#src@seZdZdS)�StreamWriterN�rrrr
r
r
rr(src@seZdZdS)�StreamReaderNrr
r
r
rr,srzx-user-defined)�namerr�incrementalencoder�incrementaldecoder�streamreader�streamwriteru	

 !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~)�__doc__Z
__future__rrrrrrr�	CodecInforrZ
codec_infor�
charmap_buildrr
r
r
r�<module>s*	��site-packages/pip/_vendor/webencodings/__pycache__/tests.cpython-38.pyc000064400000011707151446177000022174 0ustar00U

��.e��@s�dZddlmZddlmZmZmZmZmZm	Z	m
Z
mZmZdd�Z
dd�Zd	d
�Zdd�Zd
d�Zdd�Zdd�Zdd�Zdd�ZdS)z�

    webencodings.tests
    ~~~~~~~~~~~~~~~~~~

    A basic test suite for Encoding.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�)�unicode_literals�)	�lookup�LABELS�decode�encode�iter_decode�iter_encode�IncrementalDecoder�IncrementalEncoder�UTF8cOs6z|||�Wn|k
r$YdSXtd|��dS)NzDid not raise %s.��AssertionError)Z	exceptionZfunction�args�kwargs�r�B/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/tests.py�
assert_raisess
rcCstd�jdkst�td�jdks$t�td�jdks6t�td�jdksHt�td�jdksZt�td�jdkslt�td�jdks~t�td�dks�t�td�dks�t�td	�jd
ks�t�td�jd
ks�t�td�jd
ks�t�td
�jd
ks�t�td�dks�t�td�dk�st�dS)Nzutf-8zUtf-8zUTF-8�utf8zutf8 z 
utf8	�u8uutf-8 zUS-ASCIIzwindows-1252z
iso-8859-1�latin1ZLATIN1zlatin-1uLATİN1)r�namerrrrr�test_labelssrcCstD]�}td|�dt|�fks"t�td|�dks4t�dD]D}tdg||�\}}t|�gks`t�ttdg||��gks8t�q8t|�}|�d�dks�t�|jddd�dks�t�t	|�}|�d�dks�t�|jddd�dkst�qt
t���D]}t|�j|ks�t�q�dS)N��)rr�T)�final)
rrrrrr�listr	r
r�set�valuesr)Zlabel�repeat�output�_�decoder�encoderrrrr�test_all_labels0sr%cCsTtttdd�tttdd�tttgd�tttgd�tttd�tttd�dS)N�éZinvalid�é)r�LookupErrorrrrr	r
rrrrr�test_invalid_labelCsr)cCs�tdd�dtd�fkst�tdtd��dtd�fks8t�tdd�dtd�fksRt�tdt�dtd�fkslt�tdd�dtd�fks�t�td	d�dtd�fks�t�td
d�dtd�fks�t�tdd�dtd
�fks�t�tdd�dtd�fks�t�tdd�dtd
�fk�s
t�tdd�dtd�fk�s&t�tdd�dtd
�fk�sBt�tdd�dtd
�fk�s^t�tdd�dtd�fk�szt�tdd�dtd
�fk�s�t�tdd�dtd
�fk�s�t�dS)N��ru€�érr'�ascii�ér&����utf-16be�����utf-16les���us�����zUTF-16BE��zUTF-16LEzUTF-16)rrrrrrrr�test_decodeLs r4cCsptdd�dkst�tdd�dks$t�tdd�dks6t�tdd�dksHt�tdd�dksZt�tdd	�d
kslt�dS)Nr'r��rr+�utf-16r3r1r/r2)rrrrrr�test_encodebsr7cCs�dd�}|gd�dkst�|dgd�dks.t�|dgd�dksBt�|dgd�d	ksVt�|d
dgd�d	kslt�|dd
gd�d	ks�t�|dgd�dks�t�|dgd�dks�t�|dddgd�dks�t�|dddgd�dks�t�|ddddddgd�dks�t�|dgd�dk�st�|dgd�dk�s$t�|dgd�dk�s:t�|dgd�dk�sPt�|ddddddgd�dk�spt�|dddgd �d!k�s�t�dS)"NcSst||�\}}d�|�S)Nr)r�join)�inputZfallback_encodingr!Z	_encodingrrr�iter_decode_to_stringlsz/test_iter_decode.<locals>.iter_decode_to_stringrrrr5r'shelloZhellosheslloshell�or+r-r&s�����aua���s���s�uï»r.r0��s���sh�x-user-defineduhllor
)r:rrr�test_iter_decodeks�������������
���rCcCs�d�tgd��dkst�d�tdgd��dks2t�d�tdgd��dksLt�d�tddddgd��dkslt�d�tddddgd��dks�t�d�tddddgd��dks�t�d�tddddgd	��d
ks�t�d�tddddgd
��dks�t�dS)Nrrrr'r5r6r3r1r/r2uhZllorBsh�llo)r8r	rrrrr�test_iter_encode�s"    ���rDcCs@d}d}d}d}t|d�|td�fks*t�t|d�|ks<t�dS)Ns2,O�#�ɻtϨ�u2,O#tsaaZaarB)rrrr)ZencodedZdecodedrrr�test_x_user_defined�srEN)�__doc__Z
__future__rrrrrrrr	r
rrrrr%r)r4r7rCrDrErrrr�<module>s,			site-packages/pip/_vendor/webencodings/__pycache__/x_user_defined.cpython-38.opt-1.pyc000064400000005107151446177000024751 0ustar00U

��.e��	@s�dZddlmZddlZGdd�dej�ZGdd�dej�ZGdd	�d	ej�ZGd
d�deej�ZGdd
�d
eej�Zej	de�j
e�jeeeed�ZdZ
e�e
�ZdS)z�

    webencodings.x_user_defined
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~

    An implementation of the x-user-defined encoding.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�)�unicode_literalsNc@s eZdZddd�Zddd�ZdS)	�Codec�strictcCst�||t�S�N)�codecs�charmap_encode�encoding_table��self�input�errors�r
�K/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/x_user_defined.py�encodeszCodec.encodecCst�||t�Sr)r�charmap_decode�decoding_tabler	r
r
r�decodeszCodec.decodeN)r)r)�__name__�
__module__�__qualname__rrr
r
r
rrs
rc@seZdZddd�ZdS)�IncrementalEncoderFcCst�||jt�dS�Nr)rrrr�r
r�finalr
r
rrszIncrementalEncoder.encodeN)F)rrrrr
r
r
rrsrc@seZdZddd�ZdS)�IncrementalDecoderFcCst�||jt�dSr)rrrrrr
r
rr$szIncrementalDecoder.decodeN)F)rrrrr
r
r
rr#src@seZdZdS)�StreamWriterN�rrrr
r
r
rr(src@seZdZdS)�StreamReaderNrr
r
r
rr,srzx-user-defined)�namerr�incrementalencoder�incrementaldecoder�streamreader�streamwriteru	

 !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~)�__doc__Z
__future__rrrrrrr�	CodecInforrZ
codec_infor�
charmap_buildrr
r
r
r�<module>s*	��site-packages/pip/_vendor/webencodings/__pycache__/__init__.cpython-38.pyc000064400000022747151446177000022577 0ustar00U

��.eS)�@s�dZddlmZddlZddlmZdZddd	d
d�ZiZdd
�Z	dd�Z
dd�ZGdd�de�Z
e
d�Ze
d�Ze
d�Zd+dd�Zdd�Zedfdd�Zd,dd �Zd!d"�Zedfd#d$�Zd%d&�ZGd'd(�d(e�ZGd)d*�d*e�ZdS)-a

    webencodings
    ~~~~~~~~~~~~

    This is a Python implementation of the `WHATWG Encoding standard
    <http://encoding.spec.whatwg.org/>`. See README for details.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

�)�unicode_literalsN�)�LABELSz0.5.1z
iso-8859-8zmac-cyrillicz	mac-romanZcp874)ziso-8859-8-izx-mac-cyrillic�	macintoshzwindows-874cCs|�d����d�S)a9Transform (only) ASCII letters to lower case: A-Z is mapped to a-z.

    :param string: An Unicode string.
    :returns: A new Unicode string.

    This is used for `ASCII case-insensitive
    <http://encoding.spec.whatwg.org/#ascii-case-insensitive>`_
    matching of encoding labels.
    The same matching is also used, among other things,
    for `CSS keywords <http://dev.w3.org/csswg/css-values/#keywords>`_.

    This is different from the :meth:`~py:str.lower` method of Unicode strings
    which also affect non-ASCII characters,
    sometimes mapping them into the ASCII range:

        >>> keyword = u'Bac\N{KELVIN SIGN}ground'
        >>> assert keyword.lower() == u'background'
        >>> assert ascii_lower(keyword) != keyword.lower()
        >>> assert ascii_lower(keyword) == u'bac\N{KELVIN SIGN}ground'

    �utf8)�encode�lower�decode)�string�r�E/usr/lib/python3.8/site-packages/pip/_vendor/webencodings/__init__.py�ascii_lower#sr
cCsxt|�d��}t�|�}|dkr$dSt�|�}|dkrt|dkrLddlm}nt�||�}t�	|�}t
||�}|t|<|S)u<
    Look for an encoding by its label.
    This is the spec’s `get an encoding
    <http://encoding.spec.whatwg.org/#concept-encoding-get>`_ algorithm.
    Supported labels are listed there.

    :param label: A string.
    :returns:
        An :class:`Encoding` object, or :obj:`None` for an unknown label.

    z	

 Nzx-user-definedr)�
codec_info)r
�stripr�get�CACHEZx_user_definedr�PYTHON_NAMES�codecs�lookup�Encoding)Zlabel�name�encodingrZpython_namerrrr=s




rcCs.t|d�r|St|�}|dkr*td|��|S)z�
    Accept either an encoding object or label.

    :param encoding: An :class:`Encoding` object or a label string.
    :returns: An :class:`Encoding` object.
    :raises: :exc:`~exceptions.LookupError` for an unknown label.

    rNzUnknown encoding label: %r)�hasattrr�LookupError)Zencoding_or_labelrrrr�
_get_encoding[s	
rc@s eZdZdZdd�Zdd�ZdS)raOReresents a character encoding such as UTF-8,
    that can be used for decoding or encoding.

    .. attribute:: name

        Canonical name of the encoding

    .. attribute:: codec_info

        The actual implementation of the encoding,
        a stdlib :class:`~codecs.CodecInfo` object.
        See :func:`codecs.register`.

    cCs||_||_dS�N)rr)�selfrrrrr�__init__|szEncoding.__init__cCs
d|jS)Nz
<Encoding %s>)r)rrrr�__repr__�szEncoding.__repr__N)�__name__�
__module__�__qualname__�__doc__rrrrrrrmsrzutf-8zutf-16lezutf-16be�replacecCs2t|�}t|�\}}|p|}|j�||�d|fS)a�
    Decode a single string.

    :param input: A byte string
    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :return:
        A ``(output, encoding)`` tuple of an Unicode string
        and an :obj:`Encoding`.

    r)r�_detect_bomrr	)�input�fallback_encoding�errorsZbom_encodingrrrrr	�sr	cCsV|�d�rt|dd�fS|�d�r4t|dd�fS|�d�rNt|dd�fSd|fS)zBReturn (bom_encoding, input), with any BOM removed from the input.s���Ns��s�)�
startswith�_UTF16LE�_UTF16BE�UTF8)r%rrrr$�s


r$�strictcCst|�j�||�dS)a;
    Encode a single string.

    :param input: An Unicode string.
    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :return: A byte string.

    r)rrr)r%rr'rrrr�srcCs$t||�}t||�}t|�}||fS)a�
    "Pull"-based decoder.

    :param input:
        An iterable of byte strings.

        The input is first consumed just enough to determine the encoding
        based on the precense of a BOM,
        then consumed on demand when the return value is.
    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :returns:
        An ``(output, encoding)`` tuple.
        :obj:`output` is an iterable of Unicode strings,
        :obj:`encoding` is the :obj:`Encoding` that is being used.

    )�IncrementalDecoder�_iter_decode_generator�next)r%r&r'�decoder�	generatorrrrr�iter_decode�s

r4ccs�|j}t|�}|D]0}||�}|r|jdk	s0t�|jV|Vqtq|ddd�}|jdk	s^t�|jV|rp|VdS|D]}||�}|rx|Vqx|ddd�}|r�|VdS)zqReturn a generator that first yields the :obj:`Encoding`,
    then yields output chukns as Unicode strings.

    N�T��final)r	�iterr�AssertionError)r%r2r	�chunck�outputrrrr0�s,r0cCst||�j}t||�S)uY
    “Pull”-based encoder.

    :param input: An iterable of Unicode strings.
    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :returns: An iterable of byte strings.

    )�IncrementalEncoderr�_iter_encode_generator)r%rr'rrrr�iter_encode�sr>ccs6|D]}||�}|r|Vq|ddd�}|r2|VdS)N�Tr6r)r%rr:r;rrrr=sr=c@s$eZdZdZd	dd�Zd
dd�ZdS)r/uO
    “Push”-based decoder.

    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.

    r#cCs&t|�|_||_d|_d|_d|_dS)Nr5)r�_fallback_encoding�_errors�_buffer�_decoderr)rr&r'rrrrs

zIncrementalDecoder.__init__FcCs||j}|dk	r|||�S|j|}t|�\}}|dkrVt|�dkrP|sP||_dS|j}|j�|j�j}||_||_	|||�S)z�Decode one chunk of the input.

        :param input: A byte string.
        :param final:
            Indicate that no more input is available.
            Must be :obj:`True` if this is the last call.
        :returns: An Unicode string.

        Nr)r?)
rCrBr$�lenr@r�incrementaldecoderrAr	r)rr%r7r2rrrrr	's


zIncrementalDecoder.decodeN)r#)F)rr r!r"rr	rrrrr/s

r/c@seZdZdZedfdd�ZdS)r<u�
    “Push”-based encoder.

    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.

    .. method:: encode(input, final=False)

        :param input: An Unicode string.
        :param final:
            Indicate that no more input is available.
            Must be :obj:`True` if this is the last call.
        :returns: A byte string.

    r.cCst|�}|j�|�j|_dSr)rr�incrementalencoderr)rrr'rrrrTszIncrementalEncoder.__init__N)rr r!r"r-rrrrrr<Csr<)r#)r#)r"Z
__future__rr�labelsrZVERSIONrrr
rr�objectrr-r+r,r	r$rr4r0r>r=r/r<rrrr�<module>s4
�

 
3site-packages/pip/_vendor/webencodings/__init__.py000064400000024523151446177000016303 0ustar00# coding: utf-8
"""

    webencodings
    ~~~~~~~~~~~~

    This is a Python implementation of the `WHATWG Encoding standard
    <http://encoding.spec.whatwg.org/>`. See README for details.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

from __future__ import unicode_literals

import codecs

from .labels import LABELS


VERSION = '0.5.1'


# Some names in Encoding are not valid Python aliases. Remap these.
PYTHON_NAMES = {
    'iso-8859-8-i': 'iso-8859-8',
    'x-mac-cyrillic': 'mac-cyrillic',
    'macintosh': 'mac-roman',
    'windows-874': 'cp874'}

CACHE = {}


def ascii_lower(string):
    r"""Transform (only) ASCII letters to lower case: A-Z is mapped to a-z.

    :param string: An Unicode string.
    :returns: A new Unicode string.

    This is used for `ASCII case-insensitive
    <http://encoding.spec.whatwg.org/#ascii-case-insensitive>`_
    matching of encoding labels.
    The same matching is also used, among other things,
    for `CSS keywords <http://dev.w3.org/csswg/css-values/#keywords>`_.

    This is different from the :meth:`~py:str.lower` method of Unicode strings
    which also affect non-ASCII characters,
    sometimes mapping them into the ASCII range:

        >>> keyword = u'Bac\N{KELVIN SIGN}ground'
        >>> assert keyword.lower() == u'background'
        >>> assert ascii_lower(keyword) != keyword.lower()
        >>> assert ascii_lower(keyword) == u'bac\N{KELVIN SIGN}ground'

    """
    # This turns out to be faster than unicode.translate()
    return string.encode('utf8').lower().decode('utf8')


def lookup(label):
    """
    Look for an encoding by its label.
    This is the spec’s `get an encoding
    <http://encoding.spec.whatwg.org/#concept-encoding-get>`_ algorithm.
    Supported labels are listed there.

    :param label: A string.
    :returns:
        An :class:`Encoding` object, or :obj:`None` for an unknown label.

    """
    # Only strip ASCII whitespace: U+0009, U+000A, U+000C, U+000D, and U+0020.
    label = ascii_lower(label.strip('\t\n\f\r '))
    name = LABELS.get(label)
    if name is None:
        return None
    encoding = CACHE.get(name)
    if encoding is None:
        if name == 'x-user-defined':
            from .x_user_defined import codec_info
        else:
            python_name = PYTHON_NAMES.get(name, name)
            # Any python_name value that gets to here should be valid.
            codec_info = codecs.lookup(python_name)
        encoding = Encoding(name, codec_info)
        CACHE[name] = encoding
    return encoding


def _get_encoding(encoding_or_label):
    """
    Accept either an encoding object or label.

    :param encoding: An :class:`Encoding` object or a label string.
    :returns: An :class:`Encoding` object.
    :raises: :exc:`~exceptions.LookupError` for an unknown label.

    """
    if hasattr(encoding_or_label, 'codec_info'):
        return encoding_or_label

    encoding = lookup(encoding_or_label)
    if encoding is None:
        raise LookupError('Unknown encoding label: %r' % encoding_or_label)
    return encoding


class Encoding(object):
    """Reresents a character encoding such as UTF-8,
    that can be used for decoding or encoding.

    .. attribute:: name

        Canonical name of the encoding

    .. attribute:: codec_info

        The actual implementation of the encoding,
        a stdlib :class:`~codecs.CodecInfo` object.
        See :func:`codecs.register`.

    """
    def __init__(self, name, codec_info):
        self.name = name
        self.codec_info = codec_info

    def __repr__(self):
        return '<Encoding %s>' % self.name


#: The UTF-8 encoding. Should be used for new content and formats.
UTF8 = lookup('utf-8')

_UTF16LE = lookup('utf-16le')
_UTF16BE = lookup('utf-16be')


def decode(input, fallback_encoding, errors='replace'):
    """
    Decode a single string.

    :param input: A byte string
    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :return:
        A ``(output, encoding)`` tuple of an Unicode string
        and an :obj:`Encoding`.

    """
    # Fail early if `encoding` is an invalid label.
    fallback_encoding = _get_encoding(fallback_encoding)
    bom_encoding, input = _detect_bom(input)
    encoding = bom_encoding or fallback_encoding
    return encoding.codec_info.decode(input, errors)[0], encoding


def _detect_bom(input):
    """Return (bom_encoding, input), with any BOM removed from the input."""
    if input.startswith(b'\xFF\xFE'):
        return _UTF16LE, input[2:]
    if input.startswith(b'\xFE\xFF'):
        return _UTF16BE, input[2:]
    if input.startswith(b'\xEF\xBB\xBF'):
        return UTF8, input[3:]
    return None, input


def encode(input, encoding=UTF8, errors='strict'):
    """
    Encode a single string.

    :param input: An Unicode string.
    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :return: A byte string.

    """
    return _get_encoding(encoding).codec_info.encode(input, errors)[0]


def iter_decode(input, fallback_encoding, errors='replace'):
    """
    "Pull"-based decoder.

    :param input:
        An iterable of byte strings.

        The input is first consumed just enough to determine the encoding
        based on the precense of a BOM,
        then consumed on demand when the return value is.
    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :returns:
        An ``(output, encoding)`` tuple.
        :obj:`output` is an iterable of Unicode strings,
        :obj:`encoding` is the :obj:`Encoding` that is being used.

    """

    decoder = IncrementalDecoder(fallback_encoding, errors)
    generator = _iter_decode_generator(input, decoder)
    encoding = next(generator)
    return generator, encoding


def _iter_decode_generator(input, decoder):
    """Return a generator that first yields the :obj:`Encoding`,
    then yields output chukns as Unicode strings.

    """
    decode = decoder.decode
    input = iter(input)
    for chunck in input:
        output = decode(chunck)
        if output:
            assert decoder.encoding is not None
            yield decoder.encoding
            yield output
            break
    else:
        # Input exhausted without determining the encoding
        output = decode(b'', final=True)
        assert decoder.encoding is not None
        yield decoder.encoding
        if output:
            yield output
        return

    for chunck in input:
        output = decode(chunck)
        if output:
            yield output
    output = decode(b'', final=True)
    if output:
        yield output


def iter_encode(input, encoding=UTF8, errors='strict'):
    """
    “Pull”-based encoder.

    :param input: An iterable of Unicode strings.
    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.
    :returns: An iterable of byte strings.

    """
    # Fail early if `encoding` is an invalid label.
    encode = IncrementalEncoder(encoding, errors).encode
    return _iter_encode_generator(input, encode)


def _iter_encode_generator(input, encode):
    for chunck in input:
        output = encode(chunck)
        if output:
            yield output
    output = encode('', final=True)
    if output:
        yield output


class IncrementalDecoder(object):
    """
    “Push”-based decoder.

    :param fallback_encoding:
        An :class:`Encoding` object or a label string.
        The encoding to use if :obj:`input` does note have a BOM.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.

    """
    def __init__(self, fallback_encoding, errors='replace'):
        # Fail early if `encoding` is an invalid label.
        self._fallback_encoding = _get_encoding(fallback_encoding)
        self._errors = errors
        self._buffer = b''
        self._decoder = None
        #: The actual :class:`Encoding` that is being used,
        #: or :obj:`None` if that is not determined yet.
        #: (Ie. if there is not enough input yet to determine
        #: if there is a BOM.)
        self.encoding = None  # Not known yet.

    def decode(self, input, final=False):
        """Decode one chunk of the input.

        :param input: A byte string.
        :param final:
            Indicate that no more input is available.
            Must be :obj:`True` if this is the last call.
        :returns: An Unicode string.

        """
        decoder = self._decoder
        if decoder is not None:
            return decoder(input, final)

        input = self._buffer + input
        encoding, input = _detect_bom(input)
        if encoding is None:
            if len(input) < 3 and not final:  # Not enough data yet.
                self._buffer = input
                return ''
            else:  # No BOM
                encoding = self._fallback_encoding
        decoder = encoding.codec_info.incrementaldecoder(self._errors).decode
        self._decoder = decoder
        self.encoding = encoding
        return decoder(input, final)


class IncrementalEncoder(object):
    """
    “Push”-based encoder.

    :param encoding: An :class:`Encoding` object or a label string.
    :param errors: Type of error handling. See :func:`codecs.register`.
    :raises: :exc:`~exceptions.LookupError` for an unknown encoding label.

    .. method:: encode(input, final=False)

        :param input: An Unicode string.
        :param final:
            Indicate that no more input is available.
            Must be :obj:`True` if this is the last call.
        :returns: A byte string.

    """
    def __init__(self, encoding=UTF8, errors='strict'):
        encoding = _get_encoding(encoding)
        self.encode = encoding.codec_info.incrementalencoder(errors).encode
site-packages/pip/_vendor/webencodings/mklabels.py000064400000002431151446177000016330 0ustar00"""

    webencodings.mklabels
    ~~~~~~~~~~~~~~~~~~~~~

    Regenarate the webencodings.labels module.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

import json
try:
    from urllib import urlopen
except ImportError:
    from urllib.request import urlopen


def assert_lower(string):
    assert string == string.lower()
    return string


def generate(url):
    parts = ['''\
"""

    webencodings.labels
    ~~~~~~~~~~~~~~~~~~~

    Map encoding labels to their name.

    :copyright: Copyright 2012 by Simon Sapin
    :license: BSD, see LICENSE for details.

"""

# XXX Do not edit!
# This file is automatically generated by mklabels.py

LABELS = {
''']
    labels = [
        (repr(assert_lower(label)).lstrip('u'),
         repr(encoding['name']).lstrip('u'))
        for category in json.loads(urlopen(url).read().decode('ascii'))
        for encoding in category['encodings']
        for label in encoding['labels']]
    max_len = max(len(label) for label, name in labels)
    parts.extend(
        '    %s:%s %s,\n' % (label, ' ' * (max_len - len(label)), name)
        for label, name in labels)
    parts.append('}')
    return ''.join(parts)


if __name__ == '__main__':
    print(generate('http://encoding.spec.whatwg.org/encodings.json'))
site-packages/pip/_vendor/__init__.py000064400000011061151446177000013625 0ustar00"""
pip._vendor is for vendoring dependencies of pip to prevent needing pip to
depend on something external.

Files inside of pip._vendor should be considered immutable and should only be
updated to versions from upstream.
"""
from __future__ import absolute_import

import glob
import os.path
import sys

# Downstream redistributors which have debundled our dependencies should also
# patch this value to be true. This will trigger the additional patching
# to cause things like "six" to be available as pip.
DEBUNDLED = False

# By default, look in this directory for a bunch of .whl files which we will
# add to the beginning of sys.path before attempting to import anything. This
# is done to support downstream re-distributors like Debian and Fedora who
# wish to create their own Wheels for our dependencies to aid in debundling.
WHEEL_DIR = os.path.abspath(os.path.dirname(__file__))


# Define a small helper function to alias our vendored modules to the real ones
# if the vendored ones do not exist. This idea of this was taken from
# https://github.com/kennethreitz/requests/pull/2567.
def vendored(modulename):
    vendored_name = "{0}.{1}".format(__name__, modulename)

    try:
        __import__(modulename, globals(), locals(), level=0)
    except ImportError:
        # We can just silently allow import failures to pass here. If we
        # got to this point it means that ``import pip._vendor.whatever``
        # failed and so did ``import whatever``. Since we're importing this
        # upfront in an attempt to alias imports, not erroring here will
        # just mean we get a regular import error whenever pip *actually*
        # tries to import one of these modules to use it, which actually
        # gives us a better error message than we would have otherwise
        # gotten.
        pass
    else:
        sys.modules[vendored_name] = sys.modules[modulename]
        base, head = vendored_name.rsplit(".", 1)
        setattr(sys.modules[base], head, sys.modules[modulename])


# If we're operating in a debundled setup, then we want to go ahead and trigger
# the aliasing of our vendored libraries as well as looking for wheels to add
# to our sys.path. This will cause all of this code to be a no-op typically
# however downstream redistributors can enable it in a consistent way across
# all platforms.
if DEBUNDLED:
    # Actually look inside of WHEEL_DIR to find .whl files and add them to the
    # front of our sys.path.
    sys.path[:] = glob.glob(os.path.join(WHEEL_DIR, "*.whl")) + sys.path

    # Actually alias all of our vendored dependencies.
    vendored("cachecontrol")
    vendored("colorama")
    vendored("contextlib2")
    vendored("distlib")
    vendored("distro")
    vendored("html5lib")
    vendored("six")
    vendored("six.moves")
    vendored("six.moves.urllib")
    vendored("six.moves.urllib.parse")
    vendored("packaging")
    vendored("packaging.version")
    vendored("packaging.specifiers")
    vendored("pep517")
    vendored("pkg_resources")
    vendored("progress")
    vendored("pytoml")
    vendored("retrying")
    vendored("requests")
    vendored("requests.exceptions")
    vendored("requests.packages")
    vendored("requests.packages.urllib3")
    vendored("requests.packages.urllib3._collections")
    vendored("requests.packages.urllib3.connection")
    vendored("requests.packages.urllib3.connectionpool")
    vendored("requests.packages.urllib3.contrib")
    vendored("requests.packages.urllib3.contrib.ntlmpool")
    vendored("requests.packages.urllib3.contrib.pyopenssl")
    vendored("requests.packages.urllib3.exceptions")
    vendored("requests.packages.urllib3.fields")
    vendored("requests.packages.urllib3.filepost")
    vendored("requests.packages.urllib3.packages")
    vendored("requests.packages.urllib3.packages.ordered_dict")
    vendored("requests.packages.urllib3.packages.six")
    vendored("requests.packages.urllib3.packages.ssl_match_hostname")
    vendored("requests.packages.urllib3.packages.ssl_match_hostname."
             "_implementation")
    vendored("requests.packages.urllib3.poolmanager")
    vendored("requests.packages.urllib3.request")
    vendored("requests.packages.urllib3.response")
    vendored("requests.packages.urllib3.util")
    vendored("requests.packages.urllib3.util.connection")
    vendored("requests.packages.urllib3.util.request")
    vendored("requests.packages.urllib3.util.response")
    vendored("requests.packages.urllib3.util.retry")
    vendored("requests.packages.urllib3.util.ssl_")
    vendored("requests.packages.urllib3.util.timeout")
    vendored("requests.packages.urllib3.util.url")
    vendored("urllib3")
site-packages/pip/_vendor/appdirs.py000064400000057743151446177000013551 0ustar00#!/usr/bin/env python
# -*- coding: utf-8 -*-
# Copyright (c) 2005-2010 ActiveState Software Inc.
# Copyright (c) 2013 Eddy Petrișor

"""Utilities for determining application-specific dirs.

See <http://github.com/ActiveState/appdirs> for details and usage.
"""
# Dev Notes:
# - MSDN on where to store app data files:
#   http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120
# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html
# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html

__version_info__ = (1, 4, 3)
__version__ = '.'.join(map(str, __version_info__))


import sys
import os

PY3 = sys.version_info[0] == 3

if PY3:
    unicode = str

if sys.platform.startswith('java'):
    import platform
    os_name = platform.java_ver()[3][0]
    if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc.
        system = 'win32'
    elif os_name.startswith('Mac'): # "Mac OS X", etc.
        system = 'darwin'
    else: # "Linux", "SunOS", "FreeBSD", etc.
        # Setting this to "linux2" is not ideal, but only Windows or Mac
        # are actually checked for and the rest of the module expects
        # *sys.platform* style strings.
        system = 'linux2'
else:
    system = sys.platform



def user_data_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        Mac OS X:               ~/Library/Application Support/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA"
        path = os.path.normpath(_get_win_folder(const))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
    elif system == 'darwin':
        path = os.path.expanduser('~/Library/Application Support/')
        if appname:
            path = os.path.join(path, appname)
    else:
        path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def site_data_dir(appname=None, appauthor=None, version=None, multipath=False):
    r"""Return full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of data dirs should be
            returned. By default, the first item from XDG_DATA_DIRS is
            returned, or '/usr/local/share/<AppName>',
            if XDG_DATA_DIRS is not set

    Typical site data directories are:
        Mac OS X:   /Library/Application Support/<AppName>
        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.

    For Unix, this is using the $XDG_DATA_DIRS[0] default.

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA"))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
    elif system == 'darwin':
        path = os.path.expanduser('/Library/Application Support')
        if appname:
            path = os.path.join(path, appname)
    else:
        # XDG default for $XDG_DATA_DIRS
        # only first, if multipath is False
        path = os.getenv('XDG_DATA_DIRS',
                         os.pathsep.join(['/usr/local/share', '/usr/share']))
        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
        if appname:
            if version:
                appname = os.path.join(appname, version)
            pathlist = [os.sep.join([x, appname]) for x in pathlist]

        if multipath:
            path = os.pathsep.join(pathlist)
        else:
            path = pathlist[0]
        return path

    if appname and version:
        path = os.path.join(path, version)
    return path


def user_config_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user config directories are:
        Mac OS X:               same as user_data_dir
        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    """
    if system in ["win32", "darwin"]:
        path = user_data_dir(appname, appauthor, None, roaming)
    else:
        path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def site_config_dir(appname=None, appauthor=None, version=None, multipath=False):
    r"""Return full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of config dirs should be
            returned. By default, the first item from XDG_CONFIG_DIRS is
            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set

    Typical site config directories are:
        Mac OS X:   same as site_data_dir
        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
                    $XDG_CONFIG_DIRS
        Win *:      same as site_data_dir
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)

    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    """
    if system in ["win32", "darwin"]:
        path = site_data_dir(appname, appauthor)
        if appname and version:
            path = os.path.join(path, version)
    else:
        # XDG default for $XDG_CONFIG_DIRS
        # only first, if multipath is False
        path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg')
        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
        if appname:
            if version:
                appname = os.path.join(appname, version)
            pathlist = [os.sep.join([x, appname]) for x in pathlist]

        if multipath:
            path = os.pathsep.join(pathlist)
        else:
            path = pathlist[0]
    return path


def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True):
    r"""Return full path to the user-specific cache dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Cache" to the base app data dir for Windows. See
            discussion below.

    Typical user cache directories are:
        Mac OS X:   ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go in
    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
    app data dir (the default returned by `user_data_dir` above). Apps typically
    put cache data somewhere *under* the given dir here. Some examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0
    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    This can be disabled with the `opinion=False` option.
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA"))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
            if opinion:
                path = os.path.join(path, "Cache")
    elif system == 'darwin':
        path = os.path.expanduser('~/Library/Caches')
        if appname:
            path = os.path.join(path, appname)
    else:
        path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache'))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def user_state_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific state dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user state directories are:
        Mac OS X:  same as user_data_dir
        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
        Win *:     same as user_data_dir

    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
    to extend the XDG spec and support $XDG_STATE_HOME.

    That means, by default "~/.local/state/<AppName>".
    """
    if system in ["win32", "darwin"]:
        path = user_data_dir(appname, appauthor, None, roaming)
    else:
        path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def user_log_dir(appname=None, appauthor=None, version=None, opinion=True):
    r"""Return full path to the user-specific log dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Logs" to the base app data dir for Windows, and "log" to the
            base cache dir for Unix. See discussion below.

    Typical user log directories are:
        Mac OS X:   ~/Library/Logs/<AppName>
        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs

    On Windows the only suggestion in the MSDN docs is that local settings
    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
    examples of what some windows apps use for a logs dir.)

    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
    value for Windows and appends "log" to the user cache dir for Unix.
    This can be disabled with the `opinion=False` option.
    """
    if system == "darwin":
        path = os.path.join(
            os.path.expanduser('~/Library/Logs'),
            appname)
    elif system == "win32":
        path = user_data_dir(appname, appauthor, version)
        version = False
        if opinion:
            path = os.path.join(path, "Logs")
    else:
        path = user_cache_dir(appname, appauthor, version)
        version = False
        if opinion:
            path = os.path.join(path, "log")
    if appname and version:
        path = os.path.join(path, version)
    return path


class AppDirs(object):
    """Convenience wrapper for getting application dirs."""
    def __init__(self, appname=None, appauthor=None, version=None,
            roaming=False, multipath=False):
        self.appname = appname
        self.appauthor = appauthor
        self.version = version
        self.roaming = roaming
        self.multipath = multipath

    @property
    def user_data_dir(self):
        return user_data_dir(self.appname, self.appauthor,
                             version=self.version, roaming=self.roaming)

    @property
    def site_data_dir(self):
        return site_data_dir(self.appname, self.appauthor,
                             version=self.version, multipath=self.multipath)

    @property
    def user_config_dir(self):
        return user_config_dir(self.appname, self.appauthor,
                               version=self.version, roaming=self.roaming)

    @property
    def site_config_dir(self):
        return site_config_dir(self.appname, self.appauthor,
                             version=self.version, multipath=self.multipath)

    @property
    def user_cache_dir(self):
        return user_cache_dir(self.appname, self.appauthor,
                              version=self.version)

    @property
    def user_state_dir(self):
        return user_state_dir(self.appname, self.appauthor,
                              version=self.version)

    @property
    def user_log_dir(self):
        return user_log_dir(self.appname, self.appauthor,
                            version=self.version)


#---- internal support stuff

def _get_win_folder_from_registry(csidl_name):
    """This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    """
    if PY3:
      import winreg as _winreg
    else:
      import _winreg

    shell_folder_name = {
        "CSIDL_APPDATA": "AppData",
        "CSIDL_COMMON_APPDATA": "Common AppData",
        "CSIDL_LOCAL_APPDATA": "Local AppData",
    }[csidl_name]

    key = _winreg.OpenKey(
        _winreg.HKEY_CURRENT_USER,
        r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders"
    )
    dir, type = _winreg.QueryValueEx(key, shell_folder_name)
    return dir


def _get_win_folder_with_pywin32(csidl_name):
    from win32com.shell import shellcon, shell
    dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0)
    # Try to make this a unicode path because SHGetFolderPath does
    # not return unicode strings when there is unicode data in the
    # path.
    try:
        dir = unicode(dir)

        # Downgrade to short path name if have highbit chars. See
        # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
        has_high_char = False
        for c in dir:
            if ord(c) > 255:
                has_high_char = True
                break
        if has_high_char:
            try:
                import win32api
                dir = win32api.GetShortPathName(dir)
            except ImportError:
                pass
    except UnicodeError:
        pass
    return dir


def _get_win_folder_with_ctypes(csidl_name):
    import ctypes

    csidl_const = {
        "CSIDL_APPDATA": 26,
        "CSIDL_COMMON_APPDATA": 35,
        "CSIDL_LOCAL_APPDATA": 28,
    }[csidl_name]

    buf = ctypes.create_unicode_buffer(1024)
    ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)

    # Downgrade to short path name if have highbit chars. See
    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
    has_high_char = False
    for c in buf:
        if ord(c) > 255:
            has_high_char = True
            break
    if has_high_char:
        buf2 = ctypes.create_unicode_buffer(1024)
        if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
            buf = buf2

    return buf.value

def _get_win_folder_with_jna(csidl_name):
    import array
    from com.sun import jna
    from com.sun.jna.platform import win32

    buf_size = win32.WinDef.MAX_PATH * 2
    buf = array.zeros('c', buf_size)
    shell = win32.Shell32.INSTANCE
    shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf)
    dir = jna.Native.toString(buf.tostring()).rstrip("\0")

    # Downgrade to short path name if have highbit chars. See
    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
    has_high_char = False
    for c in dir:
        if ord(c) > 255:
            has_high_char = True
            break
    if has_high_char:
        buf = array.zeros('c', buf_size)
        kernel = win32.Kernel32.INSTANCE
        if kernel.GetShortPathName(dir, buf, buf_size):
            dir = jna.Native.toString(buf.tostring()).rstrip("\0")

    return dir

if system == "win32":
    try:
        from ctypes import windll
        _get_win_folder = _get_win_folder_with_ctypes
    except ImportError:
        try:
            import com.sun.jna
            _get_win_folder = _get_win_folder_with_jna
        except ImportError:
            _get_win_folder = _get_win_folder_from_registry


#---- self test code

if __name__ == "__main__":
    appname = "MyApp"
    appauthor = "MyCompany"

    props = ("user_data_dir",
             "user_config_dir",
             "user_cache_dir",
             "user_state_dir",
             "user_log_dir",
             "site_data_dir",
             "site_config_dir")

    print("-- app dirs %s --" % __version__)

    print("-- app dirs (with optional 'version')")
    dirs = AppDirs(appname, appauthor, version="1.0")
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

    print("\n-- app dirs (without optional 'version')")
    dirs = AppDirs(appname, appauthor)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

    print("\n-- app dirs (without optional 'appauthor')")
    dirs = AppDirs(appname)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

    print("\n-- app dirs (with disabled 'appauthor')")
    dirs = AppDirs(appname, appauthor=False)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))
site-packages/pip/_vendor/distro.py000064400000124363151446177000013404 0ustar00# Copyright 2015,2016,2017 Nir Cohen
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

"""
The ``distro`` package (``distro`` stands for Linux Distribution) provides
information about the Linux distribution it runs on, such as a reliable
machine-readable distro ID, or version information.

It is the recommended replacement for Python's original
:py:func:`platform.linux_distribution` function, but it provides much more
functionality. An alternative implementation became necessary because Python
3.5 deprecated this function, and Python 3.8 will remove it altogether.
Its predecessor function :py:func:`platform.dist` was already
deprecated since Python 2.6 and will also be removed in Python 3.8.
Still, there are many cases in which access to OS distribution information
is needed. See `Python issue 1322 <https://bugs.python.org/issue1322>`_ for
more information.
"""

import os
import re
import sys
import json
import shlex
import logging
import argparse
import subprocess


_UNIXCONFDIR = os.environ.get('UNIXCONFDIR', '/etc')
_OS_RELEASE_BASENAME = 'os-release'

#: Translation table for normalizing the "ID" attribute defined in os-release
#: files, for use by the :func:`distro.id` method.
#:
#: * Key: Value as defined in the os-release file, translated to lower case,
#:   with blanks translated to underscores.
#:
#: * Value: Normalized value.
NORMALIZED_OS_ID = {
    'ol': 'oracle',  # Oracle Enterprise Linux
}

#: Translation table for normalizing the "Distributor ID" attribute returned by
#: the lsb_release command, for use by the :func:`distro.id` method.
#:
#: * Key: Value as returned by the lsb_release command, translated to lower
#:   case, with blanks translated to underscores.
#:
#: * Value: Normalized value.
NORMALIZED_LSB_ID = {
    'enterpriseenterprise': 'oracle',  # Oracle Enterprise Linux
    'redhatenterpriseworkstation': 'rhel',  # RHEL 6, 7 Workstation
    'redhatenterpriseserver': 'rhel',  # RHEL 6, 7 Server
}

#: Translation table for normalizing the distro ID derived from the file name
#: of distro release files, for use by the :func:`distro.id` method.
#:
#: * Key: Value as derived from the file name of a distro release file,
#:   translated to lower case, with blanks translated to underscores.
#:
#: * Value: Normalized value.
NORMALIZED_DISTRO_ID = {
    'redhat': 'rhel',  # RHEL 6.x, 7.x
}

# Pattern for content of distro release file (reversed)
_DISTRO_RELEASE_CONTENT_REVERSED_PATTERN = re.compile(
    r'(?:[^)]*\)(.*)\()? *(?:STL )?([\d.+\-a-z]*\d) *(?:esaeler *)?(.+)')

# Pattern for base file name of distro release file
_DISTRO_RELEASE_BASENAME_PATTERN = re.compile(
    r'(\w+)[-_](release|version)$')

# Base file names to be ignored when searching for distro release file
_DISTRO_RELEASE_IGNORE_BASENAMES = (
    'debian_version',
    'lsb-release',
    'oem-release',
    _OS_RELEASE_BASENAME,
    'system-release'
)


def linux_distribution(full_distribution_name=True):
    """
    Return information about the current OS distribution as a tuple
    ``(id_name, version, codename)`` with items as follows:

    * ``id_name``:  If *full_distribution_name* is false, the result of
      :func:`distro.id`. Otherwise, the result of :func:`distro.name`.

    * ``version``:  The result of :func:`distro.version`.

    * ``codename``:  The result of :func:`distro.codename`.

    The interface of this function is compatible with the original
    :py:func:`platform.linux_distribution` function, supporting a subset of
    its parameters.

    The data it returns may not exactly be the same, because it uses more data
    sources than the original function, and that may lead to different data if
    the OS distribution is not consistent across multiple data sources it
    provides (there are indeed such distributions ...).

    Another reason for differences is the fact that the :func:`distro.id`
    method normalizes the distro ID string to a reliable machine-readable value
    for a number of popular OS distributions.
    """
    return _distro.linux_distribution(full_distribution_name)


def id():
    """
    Return the distro ID of the current distribution, as a
    machine-readable string.

    For a number of OS distributions, the returned distro ID value is
    *reliable*, in the sense that it is documented and that it does not change
    across releases of the distribution.

    This package maintains the following reliable distro ID values:

    ==============  =========================================
    Distro ID       Distribution
    ==============  =========================================
    "ubuntu"        Ubuntu
    "debian"        Debian
    "rhel"          RedHat Enterprise Linux
    "centos"        CentOS
    "fedora"        Fedora
    "sles"          SUSE Linux Enterprise Server
    "opensuse"      openSUSE
    "amazon"        Amazon Linux
    "arch"          Arch Linux
    "cloudlinux"    CloudLinux OS
    "exherbo"       Exherbo Linux
    "gentoo"        GenToo Linux
    "ibm_powerkvm"  IBM PowerKVM
    "kvmibm"        KVM for IBM z Systems
    "linuxmint"     Linux Mint
    "mageia"        Mageia
    "mandriva"      Mandriva Linux
    "parallels"     Parallels
    "pidora"        Pidora
    "raspbian"      Raspbian
    "oracle"        Oracle Linux (and Oracle Enterprise Linux)
    "scientific"    Scientific Linux
    "slackware"     Slackware
    "xenserver"     XenServer
    "openbsd"       OpenBSD
    "netbsd"        NetBSD
    "freebsd"       FreeBSD
    ==============  =========================================

    If you have a need to get distros for reliable IDs added into this set,
    or if you find that the :func:`distro.id` function returns a different
    distro ID for one of the listed distros, please create an issue in the
    `distro issue tracker`_.

    **Lookup hierarchy and transformations:**

    First, the ID is obtained from the following sources, in the specified
    order. The first available and non-empty value is used:

    * the value of the "ID" attribute of the os-release file,

    * the value of the "Distributor ID" attribute returned by the lsb_release
      command,

    * the first part of the file name of the distro release file,

    The so determined ID value then passes the following transformations,
    before it is returned by this method:

    * it is translated to lower case,

    * blanks (which should not be there anyway) are translated to underscores,

    * a normalization of the ID is performed, based upon
      `normalization tables`_. The purpose of this normalization is to ensure
      that the ID is as reliable as possible, even across incompatible changes
      in the OS distributions. A common reason for an incompatible change is
      the addition of an os-release file, or the addition of the lsb_release
      command, with ID values that differ from what was previously determined
      from the distro release file name.
    """
    return _distro.id()


def name(pretty=False):
    """
    Return the name of the current OS distribution, as a human-readable
    string.

    If *pretty* is false, the name is returned without version or codename.
    (e.g. "CentOS Linux")

    If *pretty* is true, the version and codename are appended.
    (e.g. "CentOS Linux 7.1.1503 (Core)")

    **Lookup hierarchy:**

    The name is obtained from the following sources, in the specified order.
    The first available and non-empty value is used:

    * If *pretty* is false:

      - the value of the "NAME" attribute of the os-release file,

      - the value of the "Distributor ID" attribute returned by the lsb_release
        command,

      - the value of the "<name>" field of the distro release file.

    * If *pretty* is true:

      - the value of the "PRETTY_NAME" attribute of the os-release file,

      - the value of the "Description" attribute returned by the lsb_release
        command,

      - the value of the "<name>" field of the distro release file, appended
        with the value of the pretty version ("<version_id>" and "<codename>"
        fields) of the distro release file, if available.
    """
    return _distro.name(pretty)


def version(pretty=False, best=False):
    """
    Return the version of the current OS distribution, as a human-readable
    string.

    If *pretty* is false, the version is returned without codename (e.g.
    "7.0").

    If *pretty* is true, the codename in parenthesis is appended, if the
    codename is non-empty (e.g. "7.0 (Maipo)").

    Some distributions provide version numbers with different precisions in
    the different sources of distribution information. Examining the different
    sources in a fixed priority order does not always yield the most precise
    version (e.g. for Debian 8.2, or CentOS 7.1).

    The *best* parameter can be used to control the approach for the returned
    version:

    If *best* is false, the first non-empty version number in priority order of
    the examined sources is returned.

    If *best* is true, the most precise version number out of all examined
    sources is returned.

    **Lookup hierarchy:**

    In all cases, the version number is obtained from the following sources.
    If *best* is false, this order represents the priority order:

    * the value of the "VERSION_ID" attribute of the os-release file,
    * the value of the "Release" attribute returned by the lsb_release
      command,
    * the version number parsed from the "<version_id>" field of the first line
      of the distro release file,
    * the version number parsed from the "PRETTY_NAME" attribute of the
      os-release file, if it follows the format of the distro release files.
    * the version number parsed from the "Description" attribute returned by
      the lsb_release command, if it follows the format of the distro release
      files.
    """
    return _distro.version(pretty, best)


def version_parts(best=False):
    """
    Return the version of the current OS distribution as a tuple
    ``(major, minor, build_number)`` with items as follows:

    * ``major``:  The result of :func:`distro.major_version`.

    * ``minor``:  The result of :func:`distro.minor_version`.

    * ``build_number``:  The result of :func:`distro.build_number`.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.version_parts(best)


def major_version(best=False):
    """
    Return the major version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The major version is the first
    part of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.major_version(best)


def minor_version(best=False):
    """
    Return the minor version of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The minor version is the second
    part of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.minor_version(best)


def build_number(best=False):
    """
    Return the build number of the current OS distribution, as a string,
    if provided.
    Otherwise, the empty string is returned. The build number is the third part
    of the dot-separated version string.

    For a description of the *best* parameter, see the :func:`distro.version`
    method.
    """
    return _distro.build_number(best)


def like():
    """
    Return a space-separated list of distro IDs of distributions that are
    closely related to the current OS distribution in regards to packaging
    and programming interfaces, for example distributions the current
    distribution is a derivative from.

    **Lookup hierarchy:**

    This information item is only provided by the os-release file.
    For details, see the description of the "ID_LIKE" attribute in the
    `os-release man page
    <http://www.freedesktop.org/software/systemd/man/os-release.html>`_.
    """
    return _distro.like()


def codename():
    """
    Return the codename for the release of the current OS distribution,
    as a string.

    If the distribution does not have a codename, an empty string is returned.

    Note that the returned codename is not always really a codename. For
    example, openSUSE returns "x86_64". This function does not handle such
    cases in any special way and just returns the string it finds, if any.

    **Lookup hierarchy:**

    * the codename within the "VERSION" attribute of the os-release file, if
      provided,

    * the value of the "Codename" attribute returned by the lsb_release
      command,

    * the value of the "<codename>" field of the distro release file.
    """
    return _distro.codename()


def info(pretty=False, best=False):
    """
    Return certain machine-readable information items about the current OS
    distribution in a dictionary, as shown in the following example:

    .. sourcecode:: python

        {
            'id': 'rhel',
            'version': '7.0',
            'version_parts': {
                'major': '7',
                'minor': '0',
                'build_number': ''
            },
            'like': 'fedora',
            'codename': 'Maipo'
        }

    The dictionary structure and keys are always the same, regardless of which
    information items are available in the underlying data sources. The values
    for the various keys are as follows:

    * ``id``:  The result of :func:`distro.id`.

    * ``version``:  The result of :func:`distro.version`.

    * ``version_parts -> major``:  The result of :func:`distro.major_version`.

    * ``version_parts -> minor``:  The result of :func:`distro.minor_version`.

    * ``version_parts -> build_number``:  The result of
      :func:`distro.build_number`.

    * ``like``:  The result of :func:`distro.like`.

    * ``codename``:  The result of :func:`distro.codename`.

    For a description of the *pretty* and *best* parameters, see the
    :func:`distro.version` method.
    """
    return _distro.info(pretty, best)


def os_release_info():
    """
    Return a dictionary containing key-value pairs for the information items
    from the os-release file data source of the current OS distribution.

    See `os-release file`_ for details about these information items.
    """
    return _distro.os_release_info()


def lsb_release_info():
    """
    Return a dictionary containing key-value pairs for the information items
    from the lsb_release command data source of the current OS distribution.

    See `lsb_release command output`_ for details about these information
    items.
    """
    return _distro.lsb_release_info()


def distro_release_info():
    """
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.

    See `distro release file`_ for details about these information items.
    """
    return _distro.distro_release_info()


def uname_info():
    """
    Return a dictionary containing key-value pairs for the information items
    from the distro release file data source of the current OS distribution.
    """
    return _distro.uname_info()


def os_release_attr(attribute):
    """
    Return a single named information item from the os-release file data source
    of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `os-release file`_ for details about these information items.
    """
    return _distro.os_release_attr(attribute)


def lsb_release_attr(attribute):
    """
    Return a single named information item from the lsb_release command output
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `lsb_release command output`_ for details about these information
    items.
    """
    return _distro.lsb_release_attr(attribute)


def distro_release_attr(attribute):
    """
    Return a single named information item from the distro release file
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
      The empty string, if the item does not exist.

    See `distro release file`_ for details about these information items.
    """
    return _distro.distro_release_attr(attribute)


def uname_attr(attribute):
    """
    Return a single named information item from the distro release file
    data source of the current OS distribution.

    Parameters:

    * ``attribute`` (string): Key of the information item.

    Returns:

    * (string): Value of the information item, if the item exists.
                The empty string, if the item does not exist.
    """
    return _distro.uname_attr(attribute)


class cached_property(object):
    """A version of @property which caches the value.  On access, it calls the
    underlying function and sets the value in `__dict__` so future accesses
    will not re-call the property.
    """
    def __init__(self, f):
        self._fname = f.__name__
        self._f = f

    def __get__(self, obj, owner):
        assert obj is not None, 'call {} on an instance'.format(self._fname)
        ret = obj.__dict__[self._fname] = self._f(obj)
        return ret


class LinuxDistribution(object):
    """
    Provides information about a OS distribution.

    This package creates a private module-global instance of this class with
    default initialization arguments, that is used by the
    `consolidated accessor functions`_ and `single source accessor functions`_.
    By using default initialization arguments, that module-global instance
    returns data about the current OS distribution (i.e. the distro this
    package runs on).

    Normally, it is not necessary to create additional instances of this class.
    However, in situations where control is needed over the exact data sources
    that are used, instances of this class can be created with a specific
    distro release file, or a specific os-release file, or without invoking the
    lsb_release command.
    """

    def __init__(self,
                 include_lsb=True,
                 os_release_file='',
                 distro_release_file='',
                 include_uname=True):
        """
        The initialization method of this class gathers information from the
        available data sources, and stores that in private instance attributes.
        Subsequent access to the information items uses these private instance
        attributes, so that the data sources are read only once.

        Parameters:

        * ``include_lsb`` (bool): Controls whether the
          `lsb_release command output`_ is included as a data source.

          If the lsb_release command is not available in the program execution
          path, the data source for the lsb_release command will be empty.

        * ``os_release_file`` (string): The path name of the
          `os-release file`_ that is to be used as a data source.

          An empty string (the default) will cause the default path name to
          be used (see `os-release file`_ for details).

          If the specified or defaulted os-release file does not exist, the
          data source for the os-release file will be empty.

        * ``distro_release_file`` (string): The path name of the
          `distro release file`_ that is to be used as a data source.

          An empty string (the default) will cause a default search algorithm
          to be used (see `distro release file`_ for details).

          If the specified distro release file does not exist, or if no default
          distro release file can be found, the data source for the distro
          release file will be empty.

        * ``include_name`` (bool): Controls whether uname command output is
          included as a data source. If the uname command is not available in
          the program execution path the data source for the uname command will
          be empty.

        Public instance attributes:

        * ``os_release_file`` (string): The path name of the
          `os-release file`_ that is actually used as a data source. The
          empty string if no distro release file is used as a data source.

        * ``distro_release_file`` (string): The path name of the
          `distro release file`_ that is actually used as a data source. The
          empty string if no distro release file is used as a data source.

        * ``include_lsb`` (bool): The result of the ``include_lsb`` parameter.
          This controls whether the lsb information will be loaded.

        * ``include_uname`` (bool): The result of the ``include_uname``
          parameter. This controls whether the uname information will
          be loaded.

        Raises:

        * :py:exc:`IOError`: Some I/O issue with an os-release file or distro
          release file.

        * :py:exc:`subprocess.CalledProcessError`: The lsb_release command had
          some issue (other than not being available in the program execution
          path).

        * :py:exc:`UnicodeError`: A data source has unexpected characters or
          uses an unexpected encoding.
        """
        self.os_release_file = os_release_file or \
            os.path.join(_UNIXCONFDIR, _OS_RELEASE_BASENAME)
        self.distro_release_file = distro_release_file or ''  # updated later
        self.include_lsb = include_lsb
        self.include_uname = include_uname

    def __repr__(self):
        """Return repr of all info
        """
        return \
            "LinuxDistribution(" \
            "os_release_file={self.os_release_file!r}, " \
            "distro_release_file={self.distro_release_file!r}, " \
            "include_lsb={self.include_lsb!r}, " \
            "include_uname={self.include_uname!r}, " \
            "_os_release_info={self._os_release_info!r}, " \
            "_lsb_release_info={self._lsb_release_info!r}, " \
            "_distro_release_info={self._distro_release_info!r}, " \
            "_uname_info={self._uname_info!r})".format(
                self=self)

    def linux_distribution(self, full_distribution_name=True):
        """
        Return information about the OS distribution that is compatible
        with Python's :func:`platform.linux_distribution`, supporting a subset
        of its parameters.

        For details, see :func:`distro.linux_distribution`.
        """
        return (
            self.name() if full_distribution_name else self.id(),
            self.version(),
            self.codename()
        )

    def id(self):
        """Return the distro ID of the OS distribution, as a string.

        For details, see :func:`distro.id`.
        """
        def normalize(distro_id, table):
            distro_id = distro_id.lower().replace(' ', '_')
            return table.get(distro_id, distro_id)

        distro_id = self.os_release_attr('id')
        if distro_id:
            return normalize(distro_id, NORMALIZED_OS_ID)

        distro_id = self.lsb_release_attr('distributor_id')
        if distro_id:
            return normalize(distro_id, NORMALIZED_LSB_ID)

        distro_id = self.distro_release_attr('id')
        if distro_id:
            return normalize(distro_id, NORMALIZED_DISTRO_ID)

        distro_id = self.uname_attr('id')
        if distro_id:
            return normalize(distro_id, NORMALIZED_DISTRO_ID)

        return ''

    def name(self, pretty=False):
        """
        Return the name of the OS distribution, as a string.

        For details, see :func:`distro.name`.
        """
        name = self.os_release_attr('name') \
            or self.lsb_release_attr('distributor_id') \
            or self.distro_release_attr('name') \
            or self.uname_attr('name')
        if pretty:
            name = self.os_release_attr('pretty_name') \
                or self.lsb_release_attr('description')
            if not name:
                name = self.distro_release_attr('name') \
                       or self.uname_attr('name')
                version = self.version(pretty=True)
                if version:
                    name = name + ' ' + version
        return name or ''

    def version(self, pretty=False, best=False):
        """
        Return the version of the OS distribution, as a string.

        For details, see :func:`distro.version`.
        """
        versions = [
            self.os_release_attr('version_id'),
            self.lsb_release_attr('release'),
            self.distro_release_attr('version_id'),
            self._parse_distro_release_content(
                self.os_release_attr('pretty_name')).get('version_id', ''),
            self._parse_distro_release_content(
                self.lsb_release_attr('description')).get('version_id', ''),
            self.uname_attr('release')
        ]
        version = ''
        if best:
            # This algorithm uses the last version in priority order that has
            # the best precision. If the versions are not in conflict, that
            # does not matter; otherwise, using the last one instead of the
            # first one might be considered a surprise.
            for v in versions:
                if v.count(".") > version.count(".") or version == '':
                    version = v
        else:
            for v in versions:
                if v != '':
                    version = v
                    break
        if pretty and version and self.codename():
            version = u'{0} ({1})'.format(version, self.codename())
        return version

    def version_parts(self, best=False):
        """
        Return the version of the OS distribution, as a tuple of version
        numbers.

        For details, see :func:`distro.version_parts`.
        """
        version_str = self.version(best=best)
        if version_str:
            version_regex = re.compile(r'(\d+)\.?(\d+)?\.?(\d+)?')
            matches = version_regex.match(version_str)
            if matches:
                major, minor, build_number = matches.groups()
                return major, minor or '', build_number or ''
        return '', '', ''

    def major_version(self, best=False):
        """
        Return the major version number of the current distribution.

        For details, see :func:`distro.major_version`.
        """
        return self.version_parts(best)[0]

    def minor_version(self, best=False):
        """
        Return the minor version number of the current distribution.

        For details, see :func:`distro.minor_version`.
        """
        return self.version_parts(best)[1]

    def build_number(self, best=False):
        """
        Return the build number of the current distribution.

        For details, see :func:`distro.build_number`.
        """
        return self.version_parts(best)[2]

    def like(self):
        """
        Return the IDs of distributions that are like the OS distribution.

        For details, see :func:`distro.like`.
        """
        return self.os_release_attr('id_like') or ''

    def codename(self):
        """
        Return the codename of the OS distribution.

        For details, see :func:`distro.codename`.
        """
        try:
            # Handle os_release specially since distros might purposefully set
            # this to empty string to have no codename
            return self._os_release_info['codename']
        except KeyError:
            return self.lsb_release_attr('codename') \
                or self.distro_release_attr('codename') \
                or ''

    def info(self, pretty=False, best=False):
        """
        Return certain machine-readable information about the OS
        distribution.

        For details, see :func:`distro.info`.
        """
        return dict(
            id=self.id(),
            version=self.version(pretty, best),
            version_parts=dict(
                major=self.major_version(best),
                minor=self.minor_version(best),
                build_number=self.build_number(best)
            ),
            like=self.like(),
            codename=self.codename(),
        )

    def os_release_info(self):
        """
        Return a dictionary containing key-value pairs for the information
        items from the os-release file data source of the OS distribution.

        For details, see :func:`distro.os_release_info`.
        """
        return self._os_release_info

    def lsb_release_info(self):
        """
        Return a dictionary containing key-value pairs for the information
        items from the lsb_release command data source of the OS
        distribution.

        For details, see :func:`distro.lsb_release_info`.
        """
        return self._lsb_release_info

    def distro_release_info(self):
        """
        Return a dictionary containing key-value pairs for the information
        items from the distro release file data source of the OS
        distribution.

        For details, see :func:`distro.distro_release_info`.
        """
        return self._distro_release_info

    def uname_info(self):
        """
        Return a dictionary containing key-value pairs for the information
        items from the uname command data source of the OS distribution.

        For details, see :func:`distro.uname_info`.
        """
        return self._uname_info

    def os_release_attr(self, attribute):
        """
        Return a single named information item from the os-release file data
        source of the OS distribution.

        For details, see :func:`distro.os_release_attr`.
        """
        return self._os_release_info.get(attribute, '')

    def lsb_release_attr(self, attribute):
        """
        Return a single named information item from the lsb_release command
        output data source of the OS distribution.

        For details, see :func:`distro.lsb_release_attr`.
        """
        return self._lsb_release_info.get(attribute, '')

    def distro_release_attr(self, attribute):
        """
        Return a single named information item from the distro release file
        data source of the OS distribution.

        For details, see :func:`distro.distro_release_attr`.
        """
        return self._distro_release_info.get(attribute, '')

    def uname_attr(self, attribute):
        """
        Return a single named information item from the uname command
        output data source of the OS distribution.

        For details, see :func:`distro.uname_release_attr`.
        """
        return self._uname_info.get(attribute, '')

    @cached_property
    def _os_release_info(self):
        """
        Get the information items from the specified os-release file.

        Returns:
            A dictionary containing all information items.
        """
        if os.path.isfile(self.os_release_file):
            with open(self.os_release_file) as release_file:
                return self._parse_os_release_content(release_file)
        return {}

    @staticmethod
    def _parse_os_release_content(lines):
        """
        Parse the lines of an os-release file.

        Parameters:

        * lines: Iterable through the lines in the os-release file.
                 Each line must be a unicode string or a UTF-8 encoded byte
                 string.

        Returns:
            A dictionary containing all information items.
        """
        props = {}
        lexer = shlex.shlex(lines, posix=True)
        lexer.whitespace_split = True

        # The shlex module defines its `wordchars` variable using literals,
        # making it dependent on the encoding of the Python source file.
        # In Python 2.6 and 2.7, the shlex source file is encoded in
        # 'iso-8859-1', and the `wordchars` variable is defined as a byte
        # string. This causes a UnicodeDecodeError to be raised when the
        # parsed content is a unicode object. The following fix resolves that
        # (... but it should be fixed in shlex...):
        if sys.version_info[0] == 2 and isinstance(lexer.wordchars, bytes):
            lexer.wordchars = lexer.wordchars.decode('iso-8859-1')

        tokens = list(lexer)
        for token in tokens:
            # At this point, all shell-like parsing has been done (i.e.
            # comments processed, quotes and backslash escape sequences
            # processed, multi-line values assembled, trailing newlines
            # stripped, etc.), so the tokens are now either:
            # * variable assignments: var=value
            # * commands or their arguments (not allowed in os-release)
            if '=' in token:
                k, v = token.split('=', 1)
                if isinstance(v, bytes):
                    v = v.decode('utf-8')
                props[k.lower()] = v
            else:
                # Ignore any tokens that are not variable assignments
                pass

        if 'version_codename' in props:
            # os-release added a version_codename field.  Use that in
            # preference to anything else Note that some distros purposefully
            # do not have code names.  They should be setting
            # version_codename=""
            props['codename'] = props['version_codename']
        elif 'ubuntu_codename' in props:
            # Same as above but a non-standard field name used on older Ubuntus
            props['codename'] = props['ubuntu_codename']
        elif 'version' in props:
            # If there is no version_codename, parse it from the version
            codename = re.search(r'(\(\D+\))|,(\s+)?\D+', props['version'])
            if codename:
                codename = codename.group()
                codename = codename.strip('()')
                codename = codename.strip(',')
                codename = codename.strip()
                # codename appears within paranthese.
                props['codename'] = codename

        return props

    @cached_property
    def _lsb_release_info(self):
        """
        Get the information items from the lsb_release command output.

        Returns:
            A dictionary containing all information items.
        """
        if not self.include_lsb:
            return {}
        with open(os.devnull, 'w') as devnull:
            try:
                cmd = ('lsb_release', '-a')
                stdout = subprocess.check_output(cmd, stderr=devnull)
            except OSError:  # Command not found
                return {}
        content = stdout.decode(sys.getfilesystemencoding()).splitlines()
        return self._parse_lsb_release_content(content)

    @staticmethod
    def _parse_lsb_release_content(lines):
        """
        Parse the output of the lsb_release command.

        Parameters:

        * lines: Iterable through the lines of the lsb_release output.
                 Each line must be a unicode string or a UTF-8 encoded byte
                 string.

        Returns:
            A dictionary containing all information items.
        """
        props = {}
        for line in lines:
            kv = line.strip('\n').split(':', 1)
            if len(kv) != 2:
                # Ignore lines without colon.
                continue
            k, v = kv
            props.update({k.replace(' ', '_').lower(): v.strip()})
        return props

    @cached_property
    def _uname_info(self):
        with open(os.devnull, 'w') as devnull:
            try:
                cmd = ('uname', '-rs')
                stdout = subprocess.check_output(cmd, stderr=devnull)
            except OSError:
                return {}
        content = stdout.decode(sys.getfilesystemencoding()).splitlines()
        return self._parse_uname_content(content)

    @staticmethod
    def _parse_uname_content(lines):
        props = {}
        match = re.search(r'^([^\s]+)\s+([\d\.]+)', lines[0].strip())
        if match:
            name, version = match.groups()

            # This is to prevent the Linux kernel version from
            # appearing as the 'best' version on otherwise
            # identifiable distributions.
            if name == 'Linux':
                return {}
            props['id'] = name.lower()
            props['name'] = name
            props['release'] = version
        return props

    @cached_property
    def _distro_release_info(self):
        """
        Get the information items from the specified distro release file.

        Returns:
            A dictionary containing all information items.
        """
        if self.distro_release_file:
            # If it was specified, we use it and parse what we can, even if
            # its file name or content does not match the expected pattern.
            distro_info = self._parse_distro_release_file(
                self.distro_release_file)
            basename = os.path.basename(self.distro_release_file)
            # The file name pattern for user-specified distro release files
            # is somewhat more tolerant (compared to when searching for the
            # file), because we want to use what was specified as best as
            # possible.
            match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
            if 'name' in distro_info \
               and 'cloudlinux' in distro_info['name'].lower():
                distro_info['id'] = 'cloudlinux'
            elif match:
                distro_info['id'] = match.group(1)
            return distro_info
        else:
            try:
                basenames = os.listdir(_UNIXCONFDIR)
                # We sort for repeatability in cases where there are multiple
                # distro specific files; e.g. CentOS, Oracle, Enterprise all
                # containing `redhat-release` on top of their own.
                basenames.sort()
            except OSError:
                # This may occur when /etc is not readable but we can't be
                # sure about the *-release files. Check common entries of
                # /etc for information. If they turn out to not be there the
                # error is handled in `_parse_distro_release_file()`.
                basenames = ['SuSE-release',
                             'arch-release',
                             'base-release',
                             'centos-release',
                             'fedora-release',
                             'gentoo-release',
                             'mageia-release',
                             'mandrake-release',
                             'mandriva-release',
                             'mandrivalinux-release',
                             'manjaro-release',
                             'oracle-release',
                             'redhat-release',
                             'sl-release',
                             'slackware-version']
            for basename in basenames:
                if basename in _DISTRO_RELEASE_IGNORE_BASENAMES:
                    continue
                match = _DISTRO_RELEASE_BASENAME_PATTERN.match(basename)
                if match:
                    filepath = os.path.join(_UNIXCONFDIR, basename)
                    distro_info = self._parse_distro_release_file(filepath)
                    if 'name' in distro_info:
                        # The name is always present if the pattern matches
                        self.distro_release_file = filepath
                        distro_info['id'] = match.group(1)
                        if 'cloudlinux' in distro_info['name'].lower():
                            distro_info['id'] = 'cloudlinux'
                        return distro_info
            return {}

    def _parse_distro_release_file(self, filepath):
        """
        Parse a distro release file.

        Parameters:

        * filepath: Path name of the distro release file.

        Returns:
            A dictionary containing all information items.
        """
        try:
            with open(filepath) as fp:
                # Only parse the first line. For instance, on SLES there
                # are multiple lines. We don't want them...
                return self._parse_distro_release_content(fp.readline())
        except (OSError, IOError):
            # Ignore not being able to read a specific, seemingly version
            # related file.
            # See https://github.com/nir0s/distro/issues/162
            return {}

    @staticmethod
    def _parse_distro_release_content(line):
        """
        Parse a line from a distro release file.

        Parameters:
        * line: Line from the distro release file. Must be a unicode string
                or a UTF-8 encoded byte string.

        Returns:
            A dictionary containing all information items.
        """
        if isinstance(line, bytes):
            line = line.decode('utf-8')
        matches = _DISTRO_RELEASE_CONTENT_REVERSED_PATTERN.match(
            line.strip()[::-1])
        distro_info = {}
        if matches:
            # regexp ensures non-None
            distro_info['name'] = matches.group(3)[::-1]
            if matches.group(2):
                distro_info['version_id'] = matches.group(2)[::-1]
            if matches.group(1):
                distro_info['codename'] = matches.group(1)[::-1]
        elif line:
            distro_info['name'] = line.strip()
        return distro_info


_distro = LinuxDistribution()


def main():
    logger = logging.getLogger(__name__)
    logger.setLevel(logging.DEBUG)
    logger.addHandler(logging.StreamHandler(sys.stdout))

    parser = argparse.ArgumentParser(description="OS distro info tool")
    parser.add_argument(
        '--json',
        '-j',
        help="Output in machine readable format",
        action="store_true")
    args = parser.parse_args()

    if args.json:
        logger.info(json.dumps(info(), indent=4, sort_keys=True))
    else:
        logger.info('Name: %s', name(pretty=True))
        distribution_version = version(pretty=True)
        logger.info('Version: %s', distribution_version)
        distribution_codename = codename()
        logger.info('Codename: %s', distribution_codename)


if __name__ == '__main__':
    main()
site-packages/pip/_vendor/colorama/ansitowin32.py000064400000024336151446177000016054 0ustar00# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
import re
import sys
import os

from .ansi import AnsiFore, AnsiBack, AnsiStyle, Style
from .winterm import WinTerm, WinColor, WinStyle
from .win32 import windll, winapi_test


winterm = None
if windll is not None:
    winterm = WinTerm()


class StreamWrapper(object):
    '''
    Wraps a stream (such as stdout), acting as a transparent proxy for all
    attribute access apart from method 'write()', which is delegated to our
    Converter instance.
    '''
    def __init__(self, wrapped, converter):
        # double-underscore everything to prevent clashes with names of
        # attributes on the wrapped stream object.
        self.__wrapped = wrapped
        self.__convertor = converter

    def __getattr__(self, name):
        return getattr(self.__wrapped, name)

    def __enter__(self, *args, **kwargs):
        # special method lookup bypasses __getattr__/__getattribute__, see
        # https://stackoverflow.com/questions/12632894/why-doesnt-getattr-work-with-exit
        # thus, contextlib magic methods are not proxied via __getattr__
        return self.__wrapped.__enter__(*args, **kwargs)

    def __exit__(self, *args, **kwargs):
        return self.__wrapped.__exit__(*args, **kwargs)

    def write(self, text):
        self.__convertor.write(text)

    def isatty(self):
        stream = self.__wrapped
        if 'PYCHARM_HOSTED' in os.environ:
            if stream is not None and (stream is sys.__stdout__ or stream is sys.__stderr__):
                return True
        try:
            stream_isatty = stream.isatty
        except AttributeError:
            return False
        else:
            return stream_isatty()

    @property
    def closed(self):
        stream = self.__wrapped
        try:
            return stream.closed
        except AttributeError:
            return True


class AnsiToWin32(object):
    '''
    Implements a 'write()' method which, on Windows, will strip ANSI character
    sequences from the text, and if outputting to a tty, will convert them into
    win32 function calls.
    '''
    ANSI_CSI_RE = re.compile('\001?\033\\[((?:\\d|;)*)([a-zA-Z])\002?')   # Control Sequence Introducer
    ANSI_OSC_RE = re.compile('\001?\033\\]((?:.|;)*?)(\x07)\002?')        # Operating System Command

    def __init__(self, wrapped, convert=None, strip=None, autoreset=False):
        # The wrapped stream (normally sys.stdout or sys.stderr)
        self.wrapped = wrapped

        # should we reset colors to defaults after every .write()
        self.autoreset = autoreset

        # create the proxy wrapping our output stream
        self.stream = StreamWrapper(wrapped, self)

        on_windows = os.name == 'nt'
        # We test if the WinAPI works, because even if we are on Windows
        # we may be using a terminal that doesn't support the WinAPI
        # (e.g. Cygwin Terminal). In this case it's up to the terminal
        # to support the ANSI codes.
        conversion_supported = on_windows and winapi_test()

        # should we strip ANSI sequences from our output?
        if strip is None:
            strip = conversion_supported or (not self.stream.closed and not self.stream.isatty())
        self.strip = strip

        # should we should convert ANSI sequences into win32 calls?
        if convert is None:
            convert = conversion_supported and not self.stream.closed and self.stream.isatty()
        self.convert = convert

        # dict of ansi codes to win32 functions and parameters
        self.win32_calls = self.get_win32_calls()

        # are we wrapping stderr?
        self.on_stderr = self.wrapped is sys.stderr

    def should_wrap(self):
        '''
        True if this class is actually needed. If false, then the output
        stream will not be affected, nor will win32 calls be issued, so
        wrapping stdout is not actually required. This will generally be
        False on non-Windows platforms, unless optional functionality like
        autoreset has been requested using kwargs to init()
        '''
        return self.convert or self.strip or self.autoreset

    def get_win32_calls(self):
        if self.convert and winterm:
            return {
                AnsiStyle.RESET_ALL: (winterm.reset_all, ),
                AnsiStyle.BRIGHT: (winterm.style, WinStyle.BRIGHT),
                AnsiStyle.DIM: (winterm.style, WinStyle.NORMAL),
                AnsiStyle.NORMAL: (winterm.style, WinStyle.NORMAL),
                AnsiFore.BLACK: (winterm.fore, WinColor.BLACK),
                AnsiFore.RED: (winterm.fore, WinColor.RED),
                AnsiFore.GREEN: (winterm.fore, WinColor.GREEN),
                AnsiFore.YELLOW: (winterm.fore, WinColor.YELLOW),
                AnsiFore.BLUE: (winterm.fore, WinColor.BLUE),
                AnsiFore.MAGENTA: (winterm.fore, WinColor.MAGENTA),
                AnsiFore.CYAN: (winterm.fore, WinColor.CYAN),
                AnsiFore.WHITE: (winterm.fore, WinColor.GREY),
                AnsiFore.RESET: (winterm.fore, ),
                AnsiFore.LIGHTBLACK_EX: (winterm.fore, WinColor.BLACK, True),
                AnsiFore.LIGHTRED_EX: (winterm.fore, WinColor.RED, True),
                AnsiFore.LIGHTGREEN_EX: (winterm.fore, WinColor.GREEN, True),
                AnsiFore.LIGHTYELLOW_EX: (winterm.fore, WinColor.YELLOW, True),
                AnsiFore.LIGHTBLUE_EX: (winterm.fore, WinColor.BLUE, True),
                AnsiFore.LIGHTMAGENTA_EX: (winterm.fore, WinColor.MAGENTA, True),
                AnsiFore.LIGHTCYAN_EX: (winterm.fore, WinColor.CYAN, True),
                AnsiFore.LIGHTWHITE_EX: (winterm.fore, WinColor.GREY, True),
                AnsiBack.BLACK: (winterm.back, WinColor.BLACK),
                AnsiBack.RED: (winterm.back, WinColor.RED),
                AnsiBack.GREEN: (winterm.back, WinColor.GREEN),
                AnsiBack.YELLOW: (winterm.back, WinColor.YELLOW),
                AnsiBack.BLUE: (winterm.back, WinColor.BLUE),
                AnsiBack.MAGENTA: (winterm.back, WinColor.MAGENTA),
                AnsiBack.CYAN: (winterm.back, WinColor.CYAN),
                AnsiBack.WHITE: (winterm.back, WinColor.GREY),
                AnsiBack.RESET: (winterm.back, ),
                AnsiBack.LIGHTBLACK_EX: (winterm.back, WinColor.BLACK, True),
                AnsiBack.LIGHTRED_EX: (winterm.back, WinColor.RED, True),
                AnsiBack.LIGHTGREEN_EX: (winterm.back, WinColor.GREEN, True),
                AnsiBack.LIGHTYELLOW_EX: (winterm.back, WinColor.YELLOW, True),
                AnsiBack.LIGHTBLUE_EX: (winterm.back, WinColor.BLUE, True),
                AnsiBack.LIGHTMAGENTA_EX: (winterm.back, WinColor.MAGENTA, True),
                AnsiBack.LIGHTCYAN_EX: (winterm.back, WinColor.CYAN, True),
                AnsiBack.LIGHTWHITE_EX: (winterm.back, WinColor.GREY, True),
            }
        return dict()

    def write(self, text):
        if self.strip or self.convert:
            self.write_and_convert(text)
        else:
            self.wrapped.write(text)
            self.wrapped.flush()
        if self.autoreset:
            self.reset_all()


    def reset_all(self):
        if self.convert:
            self.call_win32('m', (0,))
        elif not self.strip and not self.stream.closed:
            self.wrapped.write(Style.RESET_ALL)


    def write_and_convert(self, text):
        '''
        Write the given text to our wrapped stream, stripping any ANSI
        sequences from the text, and optionally converting them into win32
        calls.
        '''
        cursor = 0
        text = self.convert_osc(text)
        for match in self.ANSI_CSI_RE.finditer(text):
            start, end = match.span()
            self.write_plain_text(text, cursor, start)
            self.convert_ansi(*match.groups())
            cursor = end
        self.write_plain_text(text, cursor, len(text))


    def write_plain_text(self, text, start, end):
        if start < end:
            self.wrapped.write(text[start:end])
            self.wrapped.flush()


    def convert_ansi(self, paramstring, command):
        if self.convert:
            params = self.extract_params(command, paramstring)
            self.call_win32(command, params)


    def extract_params(self, command, paramstring):
        if command in 'Hf':
            params = tuple(int(p) if len(p) != 0 else 1 for p in paramstring.split(';'))
            while len(params) < 2:
                # defaults:
                params = params + (1,)
        else:
            params = tuple(int(p) for p in paramstring.split(';') if len(p) != 0)
            if len(params) == 0:
                # defaults:
                if command in 'JKm':
                    params = (0,)
                elif command in 'ABCD':
                    params = (1,)

        return params


    def call_win32(self, command, params):
        if command == 'm':
            for param in params:
                if param in self.win32_calls:
                    func_args = self.win32_calls[param]
                    func = func_args[0]
                    args = func_args[1:]
                    kwargs = dict(on_stderr=self.on_stderr)
                    func(*args, **kwargs)
        elif command in 'J':
            winterm.erase_screen(params[0], on_stderr=self.on_stderr)
        elif command in 'K':
            winterm.erase_line(params[0], on_stderr=self.on_stderr)
        elif command in 'Hf':     # cursor position - absolute
            winterm.set_cursor_position(params, on_stderr=self.on_stderr)
        elif command in 'ABCD':   # cursor position - relative
            n = params[0]
            # A - up, B - down, C - forward, D - back
            x, y = {'A': (0, -n), 'B': (0, n), 'C': (n, 0), 'D': (-n, 0)}[command]
            winterm.cursor_adjust(x, y, on_stderr=self.on_stderr)


    def convert_osc(self, text):
        for match in self.ANSI_OSC_RE.finditer(text):
            start, end = match.span()
            text = text[:start] + text[end:]
            paramstring, command = match.groups()
            if command in '\x07':       # \x07 = BEL
                params = paramstring.split(";")
                # 0 - change title and icon (we will only change title)
                # 1 - change icon (we don't support this)
                # 2 - change title
                if params[0] in '02':
                    winterm.set_title(params[1])
        return text
site-packages/pip/_vendor/colorama/ansi.py000064400000004734151446177000014626 0ustar00# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
'''
This module generates ANSI character codes to printing colors to terminals.
See: http://en.wikipedia.org/wiki/ANSI_escape_code
'''

CSI = '\033['
OSC = '\033]'
BEL = '\007'


def code_to_chars(code):
    return CSI + str(code) + 'm'

def set_title(title):
    return OSC + '2;' + title + BEL

def clear_screen(mode=2):
    return CSI + str(mode) + 'J'

def clear_line(mode=2):
    return CSI + str(mode) + 'K'


class AnsiCodes(object):
    def __init__(self):
        # the subclasses declare class attributes which are numbers.
        # Upon instantiation we define instance attributes, which are the same
        # as the class attributes but wrapped with the ANSI escape sequence
        for name in dir(self):
            if not name.startswith('_'):
                value = getattr(self, name)
                setattr(self, name, code_to_chars(value))


class AnsiCursor(object):
    def UP(self, n=1):
        return CSI + str(n) + 'A'
    def DOWN(self, n=1):
        return CSI + str(n) + 'B'
    def FORWARD(self, n=1):
        return CSI + str(n) + 'C'
    def BACK(self, n=1):
        return CSI + str(n) + 'D'
    def POS(self, x=1, y=1):
        return CSI + str(y) + ';' + str(x) + 'H'


class AnsiFore(AnsiCodes):
    BLACK           = 30
    RED             = 31
    GREEN           = 32
    YELLOW          = 33
    BLUE            = 34
    MAGENTA         = 35
    CYAN            = 36
    WHITE           = 37
    RESET           = 39

    # These are fairly well supported, but not part of the standard.
    LIGHTBLACK_EX   = 90
    LIGHTRED_EX     = 91
    LIGHTGREEN_EX   = 92
    LIGHTYELLOW_EX  = 93
    LIGHTBLUE_EX    = 94
    LIGHTMAGENTA_EX = 95
    LIGHTCYAN_EX    = 96
    LIGHTWHITE_EX   = 97


class AnsiBack(AnsiCodes):
    BLACK           = 40
    RED             = 41
    GREEN           = 42
    YELLOW          = 43
    BLUE            = 44
    MAGENTA         = 45
    CYAN            = 46
    WHITE           = 47
    RESET           = 49

    # These are fairly well supported, but not part of the standard.
    LIGHTBLACK_EX   = 100
    LIGHTRED_EX     = 101
    LIGHTGREEN_EX   = 102
    LIGHTYELLOW_EX  = 103
    LIGHTBLUE_EX    = 104
    LIGHTMAGENTA_EX = 105
    LIGHTCYAN_EX    = 106
    LIGHTWHITE_EX   = 107


class AnsiStyle(AnsiCodes):
    BRIGHT    = 1
    DIM       = 2
    NORMAL    = 22
    RESET_ALL = 0

Fore   = AnsiFore()
Back   = AnsiBack()
Style  = AnsiStyle()
Cursor = AnsiCursor()
site-packages/pip/_vendor/colorama/win32.py000064400000012434151446177000014632 0ustar00# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.

# from winbase.h
STDOUT = -11
STDERR = -12

try:
    import ctypes
    from ctypes import LibraryLoader
    windll = LibraryLoader(ctypes.WinDLL)
    from ctypes import wintypes
except (AttributeError, ImportError):
    windll = None
    SetConsoleTextAttribute = lambda *_: None
    winapi_test = lambda *_: None
else:
    from ctypes import byref, Structure, c_char, POINTER

    COORD = wintypes._COORD

    class CONSOLE_SCREEN_BUFFER_INFO(Structure):
        """struct in wincon.h."""
        _fields_ = [
            ("dwSize", COORD),
            ("dwCursorPosition", COORD),
            ("wAttributes", wintypes.WORD),
            ("srWindow", wintypes.SMALL_RECT),
            ("dwMaximumWindowSize", COORD),
        ]
        def __str__(self):
            return '(%d,%d,%d,%d,%d,%d,%d,%d,%d,%d,%d)' % (
                self.dwSize.Y, self.dwSize.X
                , self.dwCursorPosition.Y, self.dwCursorPosition.X
                , self.wAttributes
                , self.srWindow.Top, self.srWindow.Left, self.srWindow.Bottom, self.srWindow.Right
                , self.dwMaximumWindowSize.Y, self.dwMaximumWindowSize.X
            )

    _GetStdHandle = windll.kernel32.GetStdHandle
    _GetStdHandle.argtypes = [
        wintypes.DWORD,
    ]
    _GetStdHandle.restype = wintypes.HANDLE

    _GetConsoleScreenBufferInfo = windll.kernel32.GetConsoleScreenBufferInfo
    _GetConsoleScreenBufferInfo.argtypes = [
        wintypes.HANDLE,
        POINTER(CONSOLE_SCREEN_BUFFER_INFO),
    ]
    _GetConsoleScreenBufferInfo.restype = wintypes.BOOL

    _SetConsoleTextAttribute = windll.kernel32.SetConsoleTextAttribute
    _SetConsoleTextAttribute.argtypes = [
        wintypes.HANDLE,
        wintypes.WORD,
    ]
    _SetConsoleTextAttribute.restype = wintypes.BOOL

    _SetConsoleCursorPosition = windll.kernel32.SetConsoleCursorPosition
    _SetConsoleCursorPosition.argtypes = [
        wintypes.HANDLE,
        COORD,
    ]
    _SetConsoleCursorPosition.restype = wintypes.BOOL

    _FillConsoleOutputCharacterA = windll.kernel32.FillConsoleOutputCharacterA
    _FillConsoleOutputCharacterA.argtypes = [
        wintypes.HANDLE,
        c_char,
        wintypes.DWORD,
        COORD,
        POINTER(wintypes.DWORD),
    ]
    _FillConsoleOutputCharacterA.restype = wintypes.BOOL

    _FillConsoleOutputAttribute = windll.kernel32.FillConsoleOutputAttribute
    _FillConsoleOutputAttribute.argtypes = [
        wintypes.HANDLE,
        wintypes.WORD,
        wintypes.DWORD,
        COORD,
        POINTER(wintypes.DWORD),
    ]
    _FillConsoleOutputAttribute.restype = wintypes.BOOL

    _SetConsoleTitleW = windll.kernel32.SetConsoleTitleW
    _SetConsoleTitleW.argtypes = [
        wintypes.LPCWSTR
    ]
    _SetConsoleTitleW.restype = wintypes.BOOL

    def _winapi_test(handle):
        csbi = CONSOLE_SCREEN_BUFFER_INFO()
        success = _GetConsoleScreenBufferInfo(
            handle, byref(csbi))
        return bool(success)

    def winapi_test():
        return any(_winapi_test(h) for h in
                   (_GetStdHandle(STDOUT), _GetStdHandle(STDERR)))

    def GetConsoleScreenBufferInfo(stream_id=STDOUT):
        handle = _GetStdHandle(stream_id)
        csbi = CONSOLE_SCREEN_BUFFER_INFO()
        success = _GetConsoleScreenBufferInfo(
            handle, byref(csbi))
        return csbi

    def SetConsoleTextAttribute(stream_id, attrs):
        handle = _GetStdHandle(stream_id)
        return _SetConsoleTextAttribute(handle, attrs)

    def SetConsoleCursorPosition(stream_id, position, adjust=True):
        position = COORD(*position)
        # If the position is out of range, do nothing.
        if position.Y <= 0 or position.X <= 0:
            return
        # Adjust for Windows' SetConsoleCursorPosition:
        #    1. being 0-based, while ANSI is 1-based.
        #    2. expecting (x,y), while ANSI uses (y,x).
        adjusted_position = COORD(position.Y - 1, position.X - 1)
        if adjust:
            # Adjust for viewport's scroll position
            sr = GetConsoleScreenBufferInfo(STDOUT).srWindow
            adjusted_position.Y += sr.Top
            adjusted_position.X += sr.Left
        # Resume normal processing
        handle = _GetStdHandle(stream_id)
        return _SetConsoleCursorPosition(handle, adjusted_position)

    def FillConsoleOutputCharacter(stream_id, char, length, start):
        handle = _GetStdHandle(stream_id)
        char = c_char(char.encode())
        length = wintypes.DWORD(length)
        num_written = wintypes.DWORD(0)
        # Note that this is hard-coded for ANSI (vs wide) bytes.
        success = _FillConsoleOutputCharacterA(
            handle, char, length, start, byref(num_written))
        return num_written.value

    def FillConsoleOutputAttribute(stream_id, attr, length, start):
        ''' FillConsoleOutputAttribute( hConsole, csbi.wAttributes, dwConSize, coordScreen, &cCharsWritten )'''
        handle = _GetStdHandle(stream_id)
        attribute = wintypes.WORD(attr)
        length = wintypes.DWORD(length)
        num_written = wintypes.DWORD(0)
        # Note that this is hard-coded for ANSI (vs wide) bytes.
        return _FillConsoleOutputAttribute(
            handle, attribute, length, start, byref(num_written))

    def SetConsoleTitle(title):
        return _SetConsoleTitleW(title)
site-packages/pip/_vendor/colorama/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000627151446177000022655 0ustar00U

��.e��@sDddlmZmZmZmZddlmZmZmZm	Z	ddl
mZdZdS)�)�init�deinit�reinit�
colorama_text)�Fore�Back�Style�Cursor)�AnsiToWin32z0.4.1N)
Z
initialiserrrr�ansirrrr	Zansitowin32r
�__version__�r
r
�A/usr/lib/python3.8/site-packages/pip/_vendor/colorama/__init__.py�<module>ssite-packages/pip/_vendor/colorama/__pycache__/ansitowin32.cpython-38.opt-1.pyc000064400000017025151446177000023276 0ustar00U

��.e�(�@s�ddlZddlZddlZddlmZmZmZmZddlm	Z	m
Z
mZddlm
Z
mZdZe
dk	rfe	�ZGdd�de�ZGdd	�d	e�ZdS)
�N�)�AnsiFore�AnsiBack�	AnsiStyle�Style)�WinTerm�WinColor�WinStyle)�windll�winapi_testc@sLeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	e
dd��ZdS)�
StreamWrapperz�
    Wraps a stream (such as stdout), acting as a transparent proxy for all
    attribute access apart from method 'write()', which is delegated to our
    Converter instance.
    cCs||_||_dS�N)�_StreamWrapper__wrapped�_StreamWrapper__convertor)�self�wrappedZ	converter�r�D/usr/lib/python3.8/site-packages/pip/_vendor/colorama/ansitowin32.py�__init__szStreamWrapper.__init__cCst|j|�Sr
)�getattrr)r�namerrr�__getattr__szStreamWrapper.__getattr__cOs|jj||�Sr
)r�	__enter__�r�args�kwargsrrrrszStreamWrapper.__enter__cOs|jj||�Sr
)r�__exit__rrrrr%szStreamWrapper.__exit__cCs|j�|�dSr
)r�write�r�textrrrr(szStreamWrapper.writecCs\|j}dtjkr0|dk	r0|tjks,|tjkr0dSz
|j}Wntk
rPYdSX|�SdS)NZPYCHARM_HOSTEDTF)r�os�environ�sys�
__stdout__�
__stderr__�isatty�AttributeError)r�streamZ
stream_isattyrrrr%+s

zStreamWrapper.isattycCs*|j}z|jWStk
r$YdSXdS�NT)r�closedr&)rr'rrrr)7s
zStreamWrapper.closedN)�__name__�
__module__�__qualname__�__doc__rrrrrr%�propertyr)rrrrrsrc@s~eZdZdZe�d�Ze�d�Zddd�Zdd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZdS)�AnsiToWin32z�
    Implements a 'write()' method which, on Windows, will strip ANSI character
    sequences from the text, and if outputting to a tty, will convert them into
    win32 function calls.
    z?\[((?:\d|;)*)([a-zA-Z])?z?\]((?:.|;)*?)()?NFcCs�||_||_t||�|_tjdk}|o*t�}|dkrN|pL|jjoL|j��}||_	|dkrt|or|jjor|j��}||_
|��|_|jt
jk|_dS)N�nt)r�	autoresetrr'r rrr)r%�strip�convert�get_win32_calls�win32_callsr"�stderr�	on_stderr)rrr3r2r1Z
on_windowsZconversion_supportedrrrrIs


zAnsiToWin32.__init__cCs|jp|jp|jS)aj
        True if this class is actually needed. If false, then the output
        stream will not be affected, nor will win32 calls be issued, so
        wrapping stdout is not actually required. This will generally be
        False on non-Windows platforms, unless optional functionality like
        autoreset has been requested using kwargs to init()
        )r3r2r1�rrrr�should_wrapjszAnsiToWin32.should_wrapcNCs@|j�r:t�r:tjtjftjtjtjftjtjtj	ftj	tjtj	ft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj ftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdfi&St!�Sr()"r3�wintermr�	RESET_ALL�	reset_allZBRIGHTZstyler	ZDIMZNORMALrZBLACKZforerZREDZGREENZYELLOWZBLUEZMAGENTAZCYANZWHITEZGREYZRESETZ
LIGHTBLACK_EXZLIGHTRED_EXZ
LIGHTGREEN_EXZLIGHTYELLOW_EXZLIGHTBLUE_EXZLIGHTMAGENTA_EXZLIGHTCYAN_EXZ
LIGHTWHITE_EXrZback�dictr8rrrr4ts�


















�(zAnsiToWin32.get_win32_callscCs@|js|jr|�|�n|j�|�|j��|jr<|��dSr
)r2r3�write_and_convertrr�flushr1r<rrrrr�s
zAnsiToWin32.writecCs4|jr|�dd�n|js0|jjs0|j�tj�dS)N�m�r)	r3�
call_win32r2r'r)rrrr;r8rrrr<�szAnsiToWin32.reset_allcCsbd}|�|�}|j�|�D]0}|��\}}|�|||�|j|���|}q|�||t|��dS)z�
        Write the given text to our wrapped stream, stripping any ANSI
        sequences from the text, and optionally converting them into win32
        calls.
        rN)�convert_osc�ANSI_CSI_RE�finditer�span�write_plain_text�convert_ansi�groups�len)rrZcursor�match�start�endrrrr>�s
zAnsiToWin32.write_and_convertcCs*||kr&|j�|||��|j��dSr
)rrr?)rrrLrMrrrrG�szAnsiToWin32.write_plain_textcCs"|jr|�||�}|�||�dSr
)r3�extract_paramsrB)r�paramstring�command�paramsrrrrH�szAnsiToWin32.convert_ansicCsz|dkr8tdd�|�d�D��}t|�dkrv|d}q n>tdd�|�d�D��}t|�dkrv|d	krjd
}n|dkrvd}|S)N�Hfcss&|]}t|�dkrt|�ndVqdS)rrN�rJ�int��.0�prrr�	<genexpr>�sz-AnsiToWin32.extract_params.<locals>.<genexpr>�;�)rcss"|]}t|�dkrt|�VqdS)rNrSrUrrrrX�srZJKmrA�ABCD)�tuple�splitrJ)rrPrOrQrrrrN�szAnsiToWin32.extract_paramscCs�|dkrR|D]B}||jkr|j|}|d}|dd�}t|jd�}|||�qn�|dkrptj|d|jd�n�|dkr�tj|d|jd�nf|dkr�tj||jd�nL|dkr�|d}d|fd|f|df|dfd	�|\}	}
tj|	|
|jd�dS)
Nr@rr)r7�J�KrRr[)�A�B�C�D)r5r=r7r:Zerase_screenZ
erase_lineZset_cursor_positionZ
cursor_adjust)rrPrQZparamZ	func_args�funcrr�n�x�yrrrrB�s$

*zAnsiToWin32.call_win32cCsr|j�|�D]`}|��\}}|d|�||d�}|��\}}|dkr|�d�}|ddkrt�|d�q|S)N�rYrZ02r)�ANSI_OSC_RErErFrIr]r:Z	set_title)rrrKrLrMrOrPrQrrrrC�s
zAnsiToWin32.convert_osc)NNF)r*r+r,r-�re�compilerDrirr9r4rr<r>rGrHrNrBrCrrrrr/@s


!
,
r/)rjr"r �ansirrrrr:rrr	Zwin32r
r�objectrr/rrrr�<module>s0site-packages/pip/_vendor/colorama/__pycache__/winterm.cpython-38.opt-1.pyc000064400000011024151446177000022574 0ustar00U

��.e&�@s@ddlmZGdd�de�ZGdd�de�ZGdd�de�ZdS)	�)�win32c@s,eZdZdZdZdZdZdZdZdZ	dZ
d	S)
�WinColor�r������N)�__name__�
__module__�__qualname__ZBLACKZBLUEZGREENZCYANZREDZMAGENTAZYELLOWZGREY�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/colorama/winterm.pyrsrc@seZdZdZdZdZdS)�WinStyler��N)rrr
ZNORMAL�BRIGHT�BRIGHT_BACKGROUNDrrrrrsrc@s�eZdZdd�Zdd�Zdd�Zd dd	�Zd!dd�Zd"d
d�Zd#dd�Z	d$dd�Z
dd�Zd%dd�Zd&dd�Z
d'dd�Zd(dd�Zdd�ZdS))�WinTermcCs>t�tj�j|_|�|j�|j|_|j|_	|j
|_d|_dS)Nr)
r�GetConsoleScreenBufferInfo�STDOUTZwAttributes�_default�	set_attrs�_fore�
_default_fore�_back�
_default_back�_style�_default_style�_light��selfrrr�__init__szWinTerm.__init__cCs|j|jd|j|jBS)N�)rrrr r!rrr�	get_attrs$szWinTerm.get_attrscCs.|d@|_|d?d@|_|tjtjB@|_dS)Nr
r)rrrrrr)r"�valuerrrr's
zWinTerm.set_attrsNcCs$|�|j�|j|jd�d|_dS)N)�attrsr)rr�set_consoler )r"�	on_stderrrrr�	reset_all,szWinTerm.reset_allFcCsL|dkr|j}||_|r*|jtjO_n|jtjM_|j|d�dS�N)r))rrr rrr()r"�fore�lightr)rrrr,1szWinTerm.forecCsL|dkr|j}||_|r*|jtjO_n|jtjM_|j|d�dSr+)rrr rrr()r"�backr-r)rrrr.<szWinTerm.backcCs$|dkr|j}||_|j|d�dSr+)rrr()r"�styler)rrrr/Gsz
WinTerm.stylecCs0|dkr|��}tj}|r tj}t�||�dS�N)r%rr�STDERRZSetConsoleTextAttribute)r"r'r)�handlerrrr(MszWinTerm.set_consolecCs,t�|�j}|jd7_|jd7_|S)Nr)rr�dwCursorPosition�X�Y)r"r2�positionrrr�get_positionUszWinTerm.get_positioncCs,|dkrdStj}|rtj}t�||�dSr0)rrr1�SetConsoleCursorPosition)r"r6r)r2rrr�set_cursor_position]szWinTerm.set_cursor_positioncCsBtj}|rtj}|�|�}|j||j|f}tj||dd�dS)NF)Zadjust)rrr1r7r5r4r8)r"�x�yr)r2r6Zadjusted_positionrrr�
cursor_adjustgs
zWinTerm.cursor_adjustrc	Cs�tj}|rtj}t�|�}|jj|jj}|jj|jj|jj}|dkrZ|j}||}n8|dkrtt�dd�}|}n|dkr�t�dd�}|}ndSt�	|d||�t�
||��||�|dkr�t�|d�dS)Nrrr� )rr)
rrr1r�dwSizer4r5r3�COORD�FillConsoleOutputCharacter�FillConsoleOutputAttributer%r8)	r"�moder)r2�csbiZcells_in_screenZcells_before_cursor�
from_coord�cells_to_eraserrr�erase_screenos(

zWinTerm.erase_screencCs�tj}|rtj}t�|�}|dkr:|j}|jj|jj}nH|dkr\t�d|jj�}|jj}n&|dkr~t�d|jj�}|jj}ndSt�	|d||�t�
||��||�dS)Nrrrr=)rrr1rr3r>r4r?r5r@rAr%)r"rBr)r2rCrDrErrr�
erase_line�s 


zWinTerm.erase_linecCst�|�dSr0)rZSetConsoleTitle)r"�titlerrr�	set_title�szWinTerm.set_title)N)NFF)NFF)NF)NF)NF)F)rF)rF)rrr
r#r%rr*r,r.r/r(r7r9r<rFrGrIrrrrrs








 
rN)�r�objectrrrrrrr�<module>ssite-packages/pip/_vendor/colorama/__pycache__/initialise.cpython-38.opt-1.pyc000064400000003204151446177000023242 0ustar00U

��.e{�@stddlZddlZddlZddlmZdadadadada	dd�Z
ddd	�Zd
d�Zej
dd
��Zdd�Zdd�ZdS)�N�)�AnsiToWin32FcCstdk	rtt���dS�N)r�orig_stdout�	reset_all�rr�C/usr/lib/python3.8/site-packages/pip/_vendor/colorama/initialise.pyrsrTcCs�|st|||g�rtd��tjatjatjdkr6dantt||||�t_atjdkr\da	ntt||||�t_a	t
s�t�t
�da
dS)Nz,wrap=False conflicts with any other arg=TrueT)�any�
ValueError�sys�stdoutr�stderr�orig_stderr�wrapped_stdout�wrap_stream�wrapped_stderr�atexit_done�atexit�registerr)�	autoreset�convert�strip�wraprrr�inits
�
�
rcCs tdk	rtt_tdk	rtt_dSr)rrrrr
rrrr�deinit3srcos"t||�z
dVW5t�XdSr)rr)�args�kwargsrrr�
colorama_text:s

rcCs tdk	rtt_tdk	rtt_dSr)rrrrr
rrrr�reinitCsrcCs&|r"t||||d�}|��r"|j}|S)N)rrr)rZshould_wrap�stream)rrrrr�wrapperrrrrJs�r)FNNT)r�
contextlibrZansitowin32rrrrrrrrr�contextmanagerrrrrrrr�<module>s

site-packages/pip/_vendor/colorama/__pycache__/ansi.cpython-38.opt-1.pyc000064400000006170151446177000022047 0ustar00U

��.e�	�@s�dZdZdZdZdd�Zdd�Zdd	d
�Zddd�ZGd
d�de�Z	Gdd�de�Z
Gdd�de	�ZGdd�de	�ZGdd�de	�Z
e�Ze�Ze
�Ze
�ZdS)z�
This module generates ANSI character codes to printing colors to terminals.
See: http://en.wikipedia.org/wiki/ANSI_escape_code
z]�cCstt|�dS)N�m��CSI�str)�code�r�=/usr/lib/python3.8/site-packages/pip/_vendor/colorama/ansi.py�
code_to_charssr	cCstd|tS)Nz2;)�OSC�BEL)�titlerrr�	set_titlesr
�cCstt|�dS)N�Jr��moderrr�clear_screensrcCstt|�dS)N�Krrrrr�
clear_linesrc@seZdZdd�ZdS)�	AnsiCodescCs6t|�D](}|�d�st||�}t||t|��qdS)N�_)�dir�
startswith�getattr�setattrr	)�self�name�valuerrr�__init__s

zAnsiCodes.__init__N)�__name__�
__module__�__qualname__rrrrrrsrc@s>eZdZd
dd�Zddd�Zddd�Zddd	�Zdd
d�ZdS)�
AnsiCursor�cCstt|�dS)N�Ar�r�nrrr�UP%sz
AnsiCursor.UPcCstt|�dS)N�Brr%rrr�DOWN'szAnsiCursor.DOWNcCstt|�dS)N�Crr%rrr�FORWARD)szAnsiCursor.FORWARDcCstt|�dS)N�Drr%rrr�BACK+szAnsiCursor.BACKcCstt|�dt|�dS)N�;�Hr)r�x�yrrr�POS-szAnsiCursor.POSN)r#)r#)r#)r#)r#r#)rr r!r'r)r+r-r2rrrrr"$s




r"c@sPeZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZd
ZdZdZdZdZdS)�AnsiFore��� �!�"�#�$�%�'�Z�[�\�]�^�_�`�aN�rr r!ZBLACKZREDZGREENZYELLOWZBLUEZMAGENTAZCYANZWHITEZRESETZ
LIGHTBLACK_EXZLIGHTRED_EXZ
LIGHTGREEN_EXZLIGHTYELLOW_EXZLIGHTBLUE_EXZLIGHTMAGENTA_EXZLIGHTCYAN_EXZ
LIGHTWHITE_EXrrrrr31s"r3c@sPeZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZd
ZdZdZdZdZdS)�AnsiBack�(�)�*�+�,�-�.�/�1�d�e�f�g�h�i�j�kNrErrrrrFGs"rFc@seZdZdZdZdZdZdS)�	AnsiStyler#r��N)rr r!ZBRIGHTZDIMZNORMALZ	RESET_ALLrrrrrX]srXN)r)r)�__doc__rr
rr	r
rr�objectrr"r3rFrXZForeZBackZStyleZCursorrrrr�<module>s 


site-packages/pip/_vendor/colorama/__pycache__/ansi.cpython-38.pyc000064400000006170151446177000021110 0ustar00U

��.e�	�@s�dZdZdZdZdd�Zdd�Zdd	d
�Zddd�ZGd
d�de�Z	Gdd�de�Z
Gdd�de	�ZGdd�de	�ZGdd�de	�Z
e�Ze�Ze
�Ze
�ZdS)z�
This module generates ANSI character codes to printing colors to terminals.
See: http://en.wikipedia.org/wiki/ANSI_escape_code
z]�cCstt|�dS)N�m��CSI�str)�code�r�=/usr/lib/python3.8/site-packages/pip/_vendor/colorama/ansi.py�
code_to_charssr	cCstd|tS)Nz2;)�OSC�BEL)�titlerrr�	set_titlesr
�cCstt|�dS)N�Jr��moderrr�clear_screensrcCstt|�dS)N�Krrrrr�
clear_linesrc@seZdZdd�ZdS)�	AnsiCodescCs6t|�D](}|�d�st||�}t||t|��qdS)N�_)�dir�
startswith�getattr�setattrr	)�self�name�valuerrr�__init__s

zAnsiCodes.__init__N)�__name__�
__module__�__qualname__rrrrrrsrc@s>eZdZd
dd�Zddd�Zddd�Zddd	�Zdd
d�ZdS)�
AnsiCursor�cCstt|�dS)N�Ar�r�nrrr�UP%sz
AnsiCursor.UPcCstt|�dS)N�Brr%rrr�DOWN'szAnsiCursor.DOWNcCstt|�dS)N�Crr%rrr�FORWARD)szAnsiCursor.FORWARDcCstt|�dS)N�Drr%rrr�BACK+szAnsiCursor.BACKcCstt|�dt|�dS)N�;�Hr)r�x�yrrr�POS-szAnsiCursor.POSN)r#)r#)r#)r#)r#r#)rr r!r'r)r+r-r2rrrrr"$s




r"c@sPeZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZd
ZdZdZdZdZdS)�AnsiFore��� �!�"�#�$�%�'�Z�[�\�]�^�_�`�aN�rr r!ZBLACKZREDZGREENZYELLOWZBLUEZMAGENTAZCYANZWHITEZRESETZ
LIGHTBLACK_EXZLIGHTRED_EXZ
LIGHTGREEN_EXZLIGHTYELLOW_EXZLIGHTBLUE_EXZLIGHTMAGENTA_EXZLIGHTCYAN_EXZ
LIGHTWHITE_EXrrrrr31s"r3c@sPeZdZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZ
dZd
ZdZdZdZdZdS)�AnsiBack�(�)�*�+�,�-�.�/�1�d�e�f�g�h�i�j�kNrErrrrrFGs"rFc@seZdZdZdZdZdZdS)�	AnsiStyler#r��N)rr r!ZBRIGHTZDIMZNORMALZ	RESET_ALLrrrrrX]srXN)r)r)�__doc__rr
rr	r
rr�objectrr"r3rFrXZForeZBackZStyleZCursorrrrr�<module>s 


site-packages/pip/_vendor/colorama/__pycache__/win32.cpython-38.pyc000064400000007550151446177000021123 0ustar00U

��.e�	@s�dZdZz.ddlZddlmZeej�ZddlmZWn.eefk
rddZdd�Z	dd�Z
Y�nZXdd	lmZmZm
Z
mZejZGd
d�de�ZejjZejge_eje_ejjZejee�ge_eje_ejj	Zejejge_eje_ejjZejege_eje_ejj Z!eje
ejeeej�ge!_eje!_ejj"Z#ejejejeeej�ge#_eje#_ejj$Z%ej&ge%_eje%_dd
�Z'dd�Z
efdd�Zdd�Z	ddd�Zdd�Z(dd�Z"dd�Z)dS)i����i��N)�
LibraryLoader)�wintypescGsdS�N���_rr�>/usr/lib/python3.8/site-packages/pip/_vendor/colorama/win32.py�<lambda>�r	cGsdSrrrrrrr	r
)�byref�	Structure�c_char�POINTERc@s>eZdZdZdefdefdejfdejfdefgZdd�Z	d	S)
�CONSOLE_SCREEN_BUFFER_INFOzstruct in wincon.h.�dwSize�dwCursorPosition�wAttributes�srWindow�dwMaximumWindowSizecCsHd|jj|jj|jj|jj|j|jj|jj|jj|jj	|j
j|j
jfS)Nz"(%d,%d,%d,%d,%d,%d,%d,%d,%d,%d,%d))r�Y�Xrrr�Top�LeftZBottomZRightr)�selfrrr�__str__s�z"CONSOLE_SCREEN_BUFFER_INFO.__str__N)
�__name__�
__module__�__qualname__�__doc__�COORDr�WORDZ
SMALL_RECTZ_fields_rrrrrrs�rcCst�}t|t|��}t|�Sr)r�_GetConsoleScreenBufferInfor�bool)�handle�csbi�successrrr�_winapi_test\s�r&cCstdd�tt�tt�fD��S)Ncss|]}t|�VqdSr)r&)�.0�hrrr�	<genexpr>cszwinapi_test.<locals>.<genexpr>)�any�
_GetStdHandle�STDOUT�STDERRrrrr�winapi_testbs�r.cCs t|�}t�}t|t|��}|Sr)r+rr!r)�	stream_idr#r$r%rrr�GetConsoleScreenBufferInfofs�r0cCst|�}t||�Sr)r+�_SetConsoleTextAttribute)r/Zattrsr#rrr�SetConsoleTextAttributemsr2TcCsvt|�}|jdks|jdkr dSt|jd|jd�}|rdtt�j}|j|j7_|j|j7_t|�}t	||�S)Nr�)
rrrr0r,rrrr+�_SetConsoleCursorPosition)r/ZpositionZadjustZadjusted_position�srr#rrr�SetConsoleCursorPositionqs
r6cCsBt|�}t|���}t�|�}t�d�}t||||t|��}|jS)Nr)r+r
�encoder�DWORD�_FillConsoleOutputCharacterAr�value)r/�char�length�startr#�num_writtenr%rrr�FillConsoleOutputCharacter�s

�r?cCs:t|�}t�|�}t�|�}t�d�}t||||t|��S)za FillConsoleOutputAttribute( hConsole, csbi.wAttributes, dwConSize, coordScreen, &cCharsWritten )r)r+rr r8�_FillConsoleOutputAttributer)r/�attrr<r=r#Z	attributer>rrr�FillConsoleOutputAttribute�s


�rBcCst|�Sr)�_SetConsoleTitleW)�titlerrr�SetConsoleTitle�srE)T)*r,r-ZctypesrZWinDLLZwindllr�AttributeError�ImportErrorr2r.rrr
rZ_COORDrrZkernel32ZGetStdHandler+r8ZargtypesZHANDLEZrestyper0r!ZBOOLr1r r6r4ZFillConsoleOutputCharacterAr9rBr@ZSetConsoleTitleWrCZLPCWSTRr&r?rErrrr�<module>sx
�������


site-packages/pip/_vendor/colorama/__pycache__/initialise.cpython-38.pyc000064400000003204151446177000022303 0ustar00U

��.e{�@stddlZddlZddlZddlmZdadadadada	dd�Z
ddd	�Zd
d�Zej
dd
��Zdd�Zdd�ZdS)�N�)�AnsiToWin32FcCstdk	rtt���dS�N)r�orig_stdout�	reset_all�rr�C/usr/lib/python3.8/site-packages/pip/_vendor/colorama/initialise.pyrsrTcCs�|st|||g�rtd��tjatjatjdkr6dantt||||�t_atjdkr\da	ntt||||�t_a	t
s�t�t
�da
dS)Nz,wrap=False conflicts with any other arg=TrueT)�any�
ValueError�sys�stdoutr�stderr�orig_stderr�wrapped_stdout�wrap_stream�wrapped_stderr�atexit_done�atexit�registerr)�	autoreset�convert�strip�wraprrr�inits
�
�
rcCs tdk	rtt_tdk	rtt_dSr)rrrrr
rrrr�deinit3srcos"t||�z
dVW5t�XdSr)rr)�args�kwargsrrr�
colorama_text:s

rcCs tdk	rtt_tdk	rtt_dSr)rrrrr
rrrr�reinitCsrcCs&|r"t||||d�}|��r"|j}|S)N)rrr)rZshould_wrap�stream)rrrrr�wrapperrrrrJs�r)FNNT)r�
contextlibrZansitowin32rrrrrrrrr�contextmanagerrrrrrrr�<module>s

site-packages/pip/_vendor/colorama/__pycache__/ansitowin32.cpython-38.pyc000064400000017025151446177000022337 0ustar00U

��.e�(�@s�ddlZddlZddlZddlmZmZmZmZddlm	Z	m
Z
mZddlm
Z
mZdZe
dk	rfe	�ZGdd�de�ZGdd	�d	e�ZdS)
�N�)�AnsiFore�AnsiBack�	AnsiStyle�Style)�WinTerm�WinColor�WinStyle)�windll�winapi_testc@sLeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	e
dd��ZdS)�
StreamWrapperz�
    Wraps a stream (such as stdout), acting as a transparent proxy for all
    attribute access apart from method 'write()', which is delegated to our
    Converter instance.
    cCs||_||_dS�N)�_StreamWrapper__wrapped�_StreamWrapper__convertor)�self�wrappedZ	converter�r�D/usr/lib/python3.8/site-packages/pip/_vendor/colorama/ansitowin32.py�__init__szStreamWrapper.__init__cCst|j|�Sr
)�getattrr)r�namerrr�__getattr__szStreamWrapper.__getattr__cOs|jj||�Sr
)r�	__enter__�r�args�kwargsrrrrszStreamWrapper.__enter__cOs|jj||�Sr
)r�__exit__rrrrr%szStreamWrapper.__exit__cCs|j�|�dSr
)r�write�r�textrrrr(szStreamWrapper.writecCs\|j}dtjkr0|dk	r0|tjks,|tjkr0dSz
|j}Wntk
rPYdSX|�SdS)NZPYCHARM_HOSTEDTF)r�os�environ�sys�
__stdout__�
__stderr__�isatty�AttributeError)r�streamZ
stream_isattyrrrr%+s

zStreamWrapper.isattycCs*|j}z|jWStk
r$YdSXdS�NT)r�closedr&)rr'rrrr)7s
zStreamWrapper.closedN)�__name__�
__module__�__qualname__�__doc__rrrrrr%�propertyr)rrrrrsrc@s~eZdZdZe�d�Ze�d�Zddd�Zdd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZdS)�AnsiToWin32z�
    Implements a 'write()' method which, on Windows, will strip ANSI character
    sequences from the text, and if outputting to a tty, will convert them into
    win32 function calls.
    z?\[((?:\d|;)*)([a-zA-Z])?z?\]((?:.|;)*?)()?NFcCs�||_||_t||�|_tjdk}|o*t�}|dkrN|pL|jjoL|j��}||_	|dkrt|or|jjor|j��}||_
|��|_|jt
jk|_dS)N�nt)r�	autoresetrr'r rrr)r%�strip�convert�get_win32_calls�win32_callsr"�stderr�	on_stderr)rrr3r2r1Z
on_windowsZconversion_supportedrrrrIs


zAnsiToWin32.__init__cCs|jp|jp|jS)aj
        True if this class is actually needed. If false, then the output
        stream will not be affected, nor will win32 calls be issued, so
        wrapping stdout is not actually required. This will generally be
        False on non-Windows platforms, unless optional functionality like
        autoreset has been requested using kwargs to init()
        )r3r2r1�rrrr�should_wrapjszAnsiToWin32.should_wrapcNCs@|j�r:t�r:tjtjftjtjtjftjtjtj	ftj	tjtj	ft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjt
jft
jtjft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdft
jtjt
jdftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj t
jftjtj ftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdftjtj t
jdfi&St!�Sr()"r3�wintermr�	RESET_ALL�	reset_allZBRIGHTZstyler	ZDIMZNORMALrZBLACKZforerZREDZGREENZYELLOWZBLUEZMAGENTAZCYANZWHITEZGREYZRESETZ
LIGHTBLACK_EXZLIGHTRED_EXZ
LIGHTGREEN_EXZLIGHTYELLOW_EXZLIGHTBLUE_EXZLIGHTMAGENTA_EXZLIGHTCYAN_EXZ
LIGHTWHITE_EXrZback�dictr8rrrr4ts�


















�(zAnsiToWin32.get_win32_callscCs@|js|jr|�|�n|j�|�|j��|jr<|��dSr
)r2r3�write_and_convertrr�flushr1r<rrrrr�s
zAnsiToWin32.writecCs4|jr|�dd�n|js0|jjs0|j�tj�dS)N�m�r)	r3�
call_win32r2r'r)rrrr;r8rrrr<�szAnsiToWin32.reset_allcCsbd}|�|�}|j�|�D]0}|��\}}|�|||�|j|���|}q|�||t|��dS)z�
        Write the given text to our wrapped stream, stripping any ANSI
        sequences from the text, and optionally converting them into win32
        calls.
        rN)�convert_osc�ANSI_CSI_RE�finditer�span�write_plain_text�convert_ansi�groups�len)rrZcursor�match�start�endrrrr>�s
zAnsiToWin32.write_and_convertcCs*||kr&|j�|||��|j��dSr
)rrr?)rrrLrMrrrrG�szAnsiToWin32.write_plain_textcCs"|jr|�||�}|�||�dSr
)r3�extract_paramsrB)r�paramstring�command�paramsrrrrH�szAnsiToWin32.convert_ansicCsz|dkr8tdd�|�d�D��}t|�dkrv|d}q n>tdd�|�d�D��}t|�dkrv|d	krjd
}n|dkrvd}|S)N�Hfcss&|]}t|�dkrt|�ndVqdS)rrN�rJ�int��.0�prrr�	<genexpr>�sz-AnsiToWin32.extract_params.<locals>.<genexpr>�;�)rcss"|]}t|�dkrt|�VqdS)rNrSrUrrrrX�srZJKmrA�ABCD)�tuple�splitrJ)rrPrOrQrrrrN�szAnsiToWin32.extract_paramscCs�|dkrR|D]B}||jkr|j|}|d}|dd�}t|jd�}|||�qn�|dkrptj|d|jd�n�|dkr�tj|d|jd�nf|dkr�tj||jd�nL|dkr�|d}d|fd|f|df|dfd	�|\}	}
tj|	|
|jd�dS)
Nr@rr)r7�J�KrRr[)�A�B�C�D)r5r=r7r:Zerase_screenZ
erase_lineZset_cursor_positionZ
cursor_adjust)rrPrQZparamZ	func_args�funcrr�n�x�yrrrrB�s$

*zAnsiToWin32.call_win32cCsr|j�|�D]`}|��\}}|d|�||d�}|��\}}|dkr|�d�}|ddkrt�|d�q|S)N�rYrZ02r)�ANSI_OSC_RErErFrIr]r:Z	set_title)rrrKrLrMrOrPrQrrrrC�s
zAnsiToWin32.convert_osc)NNF)r*r+r,r-�re�compilerDrirr9r4rr<r>rGrHrNrBrCrrrrr/@s


!
,
r/)rjr"r �ansirrrrr:rrr	Zwin32r
r�objectrr/rrrr�<module>s0site-packages/pip/_vendor/colorama/__pycache__/win32.cpython-38.opt-1.pyc000064400000007550151446177000022062 0ustar00U

��.e�	@s�dZdZz.ddlZddlmZeej�ZddlmZWn.eefk
rddZdd�Z	dd�Z
Y�nZXdd	lmZmZm
Z
mZejZGd
d�de�ZejjZejge_eje_ejjZejee�ge_eje_ejj	Zejejge_eje_ejjZejege_eje_ejj Z!eje
ejeeej�ge!_eje!_ejj"Z#ejejejeeej�ge#_eje#_ejj$Z%ej&ge%_eje%_dd
�Z'dd�Z
efdd�Zdd�Z	ddd�Zdd�Z(dd�Z"dd�Z)dS)i����i��N)�
LibraryLoader)�wintypescGsdS�N���_rr�>/usr/lib/python3.8/site-packages/pip/_vendor/colorama/win32.py�<lambda>�r	cGsdSrrrrrrr	r
)�byref�	Structure�c_char�POINTERc@s>eZdZdZdefdefdejfdejfdefgZdd�Z	d	S)
�CONSOLE_SCREEN_BUFFER_INFOzstruct in wincon.h.�dwSize�dwCursorPosition�wAttributes�srWindow�dwMaximumWindowSizecCsHd|jj|jj|jj|jj|j|jj|jj|jj|jj	|j
j|j
jfS)Nz"(%d,%d,%d,%d,%d,%d,%d,%d,%d,%d,%d))r�Y�Xrrr�Top�LeftZBottomZRightr)�selfrrr�__str__s�z"CONSOLE_SCREEN_BUFFER_INFO.__str__N)
�__name__�
__module__�__qualname__�__doc__�COORDr�WORDZ
SMALL_RECTZ_fields_rrrrrrs�rcCst�}t|t|��}t|�Sr)r�_GetConsoleScreenBufferInfor�bool)�handle�csbi�successrrr�_winapi_test\s�r&cCstdd�tt�tt�fD��S)Ncss|]}t|�VqdSr)r&)�.0�hrrr�	<genexpr>cszwinapi_test.<locals>.<genexpr>)�any�
_GetStdHandle�STDOUT�STDERRrrrr�winapi_testbs�r.cCs t|�}t�}t|t|��}|Sr)r+rr!r)�	stream_idr#r$r%rrr�GetConsoleScreenBufferInfofs�r0cCst|�}t||�Sr)r+�_SetConsoleTextAttribute)r/Zattrsr#rrr�SetConsoleTextAttributemsr2TcCsvt|�}|jdks|jdkr dSt|jd|jd�}|rdtt�j}|j|j7_|j|j7_t|�}t	||�S)Nr�)
rrrr0r,rrrr+�_SetConsoleCursorPosition)r/ZpositionZadjustZadjusted_position�srr#rrr�SetConsoleCursorPositionqs
r6cCsBt|�}t|���}t�|�}t�d�}t||||t|��}|jS)Nr)r+r
�encoder�DWORD�_FillConsoleOutputCharacterAr�value)r/�char�length�startr#�num_writtenr%rrr�FillConsoleOutputCharacter�s

�r?cCs:t|�}t�|�}t�|�}t�d�}t||||t|��S)za FillConsoleOutputAttribute( hConsole, csbi.wAttributes, dwConSize, coordScreen, &cCharsWritten )r)r+rr r8�_FillConsoleOutputAttributer)r/�attrr<r=r#Z	attributer>rrr�FillConsoleOutputAttribute�s


�rBcCst|�Sr)�_SetConsoleTitleW)�titlerrr�SetConsoleTitle�srE)T)*r,r-ZctypesrZWinDLLZwindllr�AttributeError�ImportErrorr2r.rrr
rZ_COORDrrZkernel32ZGetStdHandler+r8ZargtypesZHANDLEZrestyper0r!ZBOOLr1r r6r4ZFillConsoleOutputCharacterAr9rBr@ZSetConsoleTitleWrCZLPCWSTRr&r?rErrrr�<module>sx
�������


site-packages/pip/_vendor/colorama/__pycache__/winterm.cpython-38.pyc000064400000011024151446177000021635 0ustar00U

��.e&�@s@ddlmZGdd�de�ZGdd�de�ZGdd�de�ZdS)	�)�win32c@s,eZdZdZdZdZdZdZdZdZ	dZ
d	S)
�WinColor�r������N)�__name__�
__module__�__qualname__ZBLACKZBLUEZGREENZCYANZREDZMAGENTAZYELLOWZGREY�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/colorama/winterm.pyrsrc@seZdZdZdZdZdS)�WinStyler��N)rrr
ZNORMAL�BRIGHT�BRIGHT_BACKGROUNDrrrrrsrc@s�eZdZdd�Zdd�Zdd�Zd dd	�Zd!dd�Zd"d
d�Zd#dd�Z	d$dd�Z
dd�Zd%dd�Zd&dd�Z
d'dd�Zd(dd�Zdd�ZdS))�WinTermcCs>t�tj�j|_|�|j�|j|_|j|_	|j
|_d|_dS)Nr)
r�GetConsoleScreenBufferInfo�STDOUTZwAttributes�_default�	set_attrs�_fore�
_default_fore�_back�
_default_back�_style�_default_style�_light��selfrrr�__init__szWinTerm.__init__cCs|j|jd|j|jBS)N�)rrrr r!rrr�	get_attrs$szWinTerm.get_attrscCs.|d@|_|d?d@|_|tjtjB@|_dS)Nr
r)rrrrrr)r"�valuerrrr's
zWinTerm.set_attrsNcCs$|�|j�|j|jd�d|_dS)N)�attrsr)rr�set_consoler )r"�	on_stderrrrr�	reset_all,szWinTerm.reset_allFcCsL|dkr|j}||_|r*|jtjO_n|jtjM_|j|d�dS�N)r))rrr rrr()r"�fore�lightr)rrrr,1szWinTerm.forecCsL|dkr|j}||_|r*|jtjO_n|jtjM_|j|d�dSr+)rrr rrr()r"�backr-r)rrrr.<szWinTerm.backcCs$|dkr|j}||_|j|d�dSr+)rrr()r"�styler)rrrr/Gsz
WinTerm.stylecCs0|dkr|��}tj}|r tj}t�||�dS�N)r%rr�STDERRZSetConsoleTextAttribute)r"r'r)�handlerrrr(MszWinTerm.set_consolecCs,t�|�j}|jd7_|jd7_|S)Nr)rr�dwCursorPosition�X�Y)r"r2�positionrrr�get_positionUszWinTerm.get_positioncCs,|dkrdStj}|rtj}t�||�dSr0)rrr1�SetConsoleCursorPosition)r"r6r)r2rrr�set_cursor_position]szWinTerm.set_cursor_positioncCsBtj}|rtj}|�|�}|j||j|f}tj||dd�dS)NF)Zadjust)rrr1r7r5r4r8)r"�x�yr)r2r6Zadjusted_positionrrr�
cursor_adjustgs
zWinTerm.cursor_adjustrc	Cs�tj}|rtj}t�|�}|jj|jj}|jj|jj|jj}|dkrZ|j}||}n8|dkrtt�dd�}|}n|dkr�t�dd�}|}ndSt�	|d||�t�
||��||�|dkr�t�|d�dS)Nrrr� )rr)
rrr1r�dwSizer4r5r3�COORD�FillConsoleOutputCharacter�FillConsoleOutputAttributer%r8)	r"�moder)r2�csbiZcells_in_screenZcells_before_cursor�
from_coord�cells_to_eraserrr�erase_screenos(

zWinTerm.erase_screencCs�tj}|rtj}t�|�}|dkr:|j}|jj|jj}nH|dkr\t�d|jj�}|jj}n&|dkr~t�d|jj�}|jj}ndSt�	|d||�t�
||��||�dS)Nrrrr=)rrr1rr3r>r4r?r5r@rAr%)r"rBr)r2rCrDrErrr�
erase_line�s 


zWinTerm.erase_linecCst�|�dSr0)rZSetConsoleTitle)r"�titlerrr�	set_title�szWinTerm.set_title)N)NFF)NFF)NF)NF)NF)F)rF)rF)rrr
r#r%rr*r,r.r/r(r7r9r<rFrGrIrrrrrs








 
rN)�r�objectrrrrrrr�<module>ssite-packages/pip/_vendor/colorama/__pycache__/__init__.cpython-38.pyc000064400000000627151446177000021716 0ustar00U

��.e��@sDddlmZmZmZmZddlmZmZmZm	Z	ddl
mZdZdS)�)�init�deinit�reinit�
colorama_text)�Fore�Back�Style�Cursor)�AnsiToWin32z0.4.1N)
Z
initialiserrrr�ansirrrr	Zansitowin32r
�__version__�r
r
�A/usr/lib/python3.8/site-packages/pip/_vendor/colorama/__init__.py�<module>ssite-packages/pip/_vendor/colorama/__init__.py000064400000000357151446177000015430 0ustar00# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
from .initialise import init, deinit, reinit, colorama_text
from .ansi import Fore, Back, Style, Cursor
from .ansitowin32 import AnsiToWin32

__version__ = '0.4.1'
site-packages/pip/_vendor/colorama/initialise.py000064400000003573151446177000016026 0ustar00# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
import atexit
import contextlib
import sys

from .ansitowin32 import AnsiToWin32


orig_stdout = None
orig_stderr = None

wrapped_stdout = None
wrapped_stderr = None

atexit_done = False


def reset_all():
    if AnsiToWin32 is not None:    # Issue #74: objects might become None at exit
        AnsiToWin32(orig_stdout).reset_all()


def init(autoreset=False, convert=None, strip=None, wrap=True):

    if not wrap and any([autoreset, convert, strip]):
        raise ValueError('wrap=False conflicts with any other arg=True')

    global wrapped_stdout, wrapped_stderr
    global orig_stdout, orig_stderr

    orig_stdout = sys.stdout
    orig_stderr = sys.stderr

    if sys.stdout is None:
        wrapped_stdout = None
    else:
        sys.stdout = wrapped_stdout = \
            wrap_stream(orig_stdout, convert, strip, autoreset, wrap)
    if sys.stderr is None:
        wrapped_stderr = None
    else:
        sys.stderr = wrapped_stderr = \
            wrap_stream(orig_stderr, convert, strip, autoreset, wrap)

    global atexit_done
    if not atexit_done:
        atexit.register(reset_all)
        atexit_done = True


def deinit():
    if orig_stdout is not None:
        sys.stdout = orig_stdout
    if orig_stderr is not None:
        sys.stderr = orig_stderr


@contextlib.contextmanager
def colorama_text(*args, **kwargs):
    init(*args, **kwargs)
    try:
        yield
    finally:
        deinit()


def reinit():
    if wrapped_stdout is not None:
        sys.stdout = wrapped_stdout
    if wrapped_stderr is not None:
        sys.stderr = wrapped_stderr


def wrap_stream(stream, convert, strip, autoreset, wrap):
    if wrap:
        wrapper = AnsiToWin32(stream,
            convert=convert, strip=strip, autoreset=autoreset)
        if wrapper.should_wrap():
            stream = wrapper.stream
    return stream
site-packages/pip/_vendor/colorama/winterm.py000064400000014446151446177000015362 0ustar00# Copyright Jonathan Hartley 2013. BSD 3-Clause license, see LICENSE file.
from . import win32


# from wincon.h
class WinColor(object):
    BLACK   = 0
    BLUE    = 1
    GREEN   = 2
    CYAN    = 3
    RED     = 4
    MAGENTA = 5
    YELLOW  = 6
    GREY    = 7

# from wincon.h
class WinStyle(object):
    NORMAL              = 0x00 # dim text, dim background
    BRIGHT              = 0x08 # bright text, dim background
    BRIGHT_BACKGROUND   = 0x80 # dim text, bright background

class WinTerm(object):

    def __init__(self):
        self._default = win32.GetConsoleScreenBufferInfo(win32.STDOUT).wAttributes
        self.set_attrs(self._default)
        self._default_fore = self._fore
        self._default_back = self._back
        self._default_style = self._style
        # In order to emulate LIGHT_EX in windows, we borrow the BRIGHT style.
        # So that LIGHT_EX colors and BRIGHT style do not clobber each other,
        # we track them separately, since LIGHT_EX is overwritten by Fore/Back
        # and BRIGHT is overwritten by Style codes.
        self._light = 0

    def get_attrs(self):
        return self._fore + self._back * 16 + (self._style | self._light)

    def set_attrs(self, value):
        self._fore = value & 7
        self._back = (value >> 4) & 7
        self._style = value & (WinStyle.BRIGHT | WinStyle.BRIGHT_BACKGROUND)

    def reset_all(self, on_stderr=None):
        self.set_attrs(self._default)
        self.set_console(attrs=self._default)
        self._light = 0

    def fore(self, fore=None, light=False, on_stderr=False):
        if fore is None:
            fore = self._default_fore
        self._fore = fore
        # Emulate LIGHT_EX with BRIGHT Style
        if light:
            self._light |= WinStyle.BRIGHT
        else:
            self._light &= ~WinStyle.BRIGHT
        self.set_console(on_stderr=on_stderr)

    def back(self, back=None, light=False, on_stderr=False):
        if back is None:
            back = self._default_back
        self._back = back
        # Emulate LIGHT_EX with BRIGHT_BACKGROUND Style
        if light:
            self._light |= WinStyle.BRIGHT_BACKGROUND
        else:
            self._light &= ~WinStyle.BRIGHT_BACKGROUND
        self.set_console(on_stderr=on_stderr)

    def style(self, style=None, on_stderr=False):
        if style is None:
            style = self._default_style
        self._style = style
        self.set_console(on_stderr=on_stderr)

    def set_console(self, attrs=None, on_stderr=False):
        if attrs is None:
            attrs = self.get_attrs()
        handle = win32.STDOUT
        if on_stderr:
            handle = win32.STDERR
        win32.SetConsoleTextAttribute(handle, attrs)

    def get_position(self, handle):
        position = win32.GetConsoleScreenBufferInfo(handle).dwCursorPosition
        # Because Windows coordinates are 0-based,
        # and win32.SetConsoleCursorPosition expects 1-based.
        position.X += 1
        position.Y += 1
        return position

    def set_cursor_position(self, position=None, on_stderr=False):
        if position is None:
            # I'm not currently tracking the position, so there is no default.
            # position = self.get_position()
            return
        handle = win32.STDOUT
        if on_stderr:
            handle = win32.STDERR
        win32.SetConsoleCursorPosition(handle, position)

    def cursor_adjust(self, x, y, on_stderr=False):
        handle = win32.STDOUT
        if on_stderr:
            handle = win32.STDERR
        position = self.get_position(handle)
        adjusted_position = (position.Y + y, position.X + x)
        win32.SetConsoleCursorPosition(handle, adjusted_position, adjust=False)

    def erase_screen(self, mode=0, on_stderr=False):
        # 0 should clear from the cursor to the end of the screen.
        # 1 should clear from the cursor to the beginning of the screen.
        # 2 should clear the entire screen, and move cursor to (1,1)
        handle = win32.STDOUT
        if on_stderr:
            handle = win32.STDERR
        csbi = win32.GetConsoleScreenBufferInfo(handle)
        # get the number of character cells in the current buffer
        cells_in_screen = csbi.dwSize.X * csbi.dwSize.Y
        # get number of character cells before current cursor position
        cells_before_cursor = csbi.dwSize.X * csbi.dwCursorPosition.Y + csbi.dwCursorPosition.X
        if mode == 0:
            from_coord = csbi.dwCursorPosition
            cells_to_erase = cells_in_screen - cells_before_cursor
        elif mode == 1:
            from_coord = win32.COORD(0, 0)
            cells_to_erase = cells_before_cursor
        elif mode == 2:
            from_coord = win32.COORD(0, 0)
            cells_to_erase = cells_in_screen
        else:
            # invalid mode
            return
        # fill the entire screen with blanks
        win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord)
        # now set the buffer's attributes accordingly
        win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord)
        if mode == 2:
            # put the cursor where needed
            win32.SetConsoleCursorPosition(handle, (1, 1))

    def erase_line(self, mode=0, on_stderr=False):
        # 0 should clear from the cursor to the end of the line.
        # 1 should clear from the cursor to the beginning of the line.
        # 2 should clear the entire line.
        handle = win32.STDOUT
        if on_stderr:
            handle = win32.STDERR
        csbi = win32.GetConsoleScreenBufferInfo(handle)
        if mode == 0:
            from_coord = csbi.dwCursorPosition
            cells_to_erase = csbi.dwSize.X - csbi.dwCursorPosition.X
        elif mode == 1:
            from_coord = win32.COORD(0, csbi.dwCursorPosition.Y)
            cells_to_erase = csbi.dwCursorPosition.X
        elif mode == 2:
            from_coord = win32.COORD(0, csbi.dwCursorPosition.Y)
            cells_to_erase = csbi.dwSize.X
        else:
            # invalid mode
            return
        # fill the entire screen with blanks
        win32.FillConsoleOutputCharacter(handle, ' ', cells_to_erase, from_coord)
        # now set the buffer's attributes accordingly
        win32.FillConsoleOutputAttribute(handle, self.get_attrs(), cells_to_erase, from_coord)

    def set_title(self, title):
        win32.SetConsoleTitle(title)
site-packages/pip/_vendor/distlib/resources.py000064400000025016151446177000015537 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2017 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 shutil
import sys
import types
import zipimport

from . import DistlibException
from .util import cached_property, get_cache_base, path_to_cache_dir, 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 _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)
        return self._adjust_path(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
    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
site-packages/pip/_vendor/distlib/version.py000064400000055537151446177000015225 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2017 The Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""
Implementation of a flexible versioning scheme providing support for PEP-440,
setuptools-compatible and semantic versioning.
"""

import logging
import re

from .compat import string_types
from .util import parse_requirement

__all__ = ['NormalizedVersion', 'NormalizedMatcher',
           'LegacyVersion', 'LegacyMatcher',
           'SemanticVersion', 'SemanticMatcher',
           'UnsupportedVersionError', 'get_scheme']

logger = logging.getLogger(__name__)


class UnsupportedVersionError(ValueError):
    """This is an unsupported version."""
    pass


class Version(object):
    def __init__(self, s):
        self._string = s = s.strip()
        self._parts = parts = self.parse(s)
        assert isinstance(parts, tuple)
        assert len(parts) > 0

    def parse(self, s):
        raise NotImplementedError('please implement in a subclass')

    def _check_compatible(self, other):
        if type(self) != type(other):
            raise TypeError('cannot compare %r and %r' % (self, other))

    def __eq__(self, other):
        self._check_compatible(other)
        return self._parts == other._parts

    def __ne__(self, other):
        return not self.__eq__(other)

    def __lt__(self, other):
        self._check_compatible(other)
        return self._parts < other._parts

    def __gt__(self, other):
        return not (self.__lt__(other) or self.__eq__(other))

    def __le__(self, other):
        return self.__lt__(other) or self.__eq__(other)

    def __ge__(self, other):
        return self.__gt__(other) or self.__eq__(other)

    # See http://docs.python.org/reference/datamodel#object.__hash__
    def __hash__(self):
        return hash(self._parts)

    def __repr__(self):
        return "%s('%s')" % (self.__class__.__name__, self._string)

    def __str__(self):
        return self._string

    @property
    def is_prerelease(self):
        raise NotImplementedError('Please implement in subclasses.')


class Matcher(object):
    version_class = None

    # value is either a callable or the name of a method
    _operators = {
        '<': lambda v, c, p: v < c,
        '>': lambda v, c, p: v > c,
        '<=': lambda v, c, p: v == c or v < c,
        '>=': lambda v, c, p: v == c or v > c,
        '==': lambda v, c, p: v == c,
        '===': lambda v, c, p: v == c,
        # by default, compatible => >=.
        '~=': lambda v, c, p: v == c or v > c,
        '!=': lambda v, c, p: v != c,
    }

    # this is a method only to support alternative implementations
    # via overriding
    def parse_requirement(self, s):
        return parse_requirement(s)

    def __init__(self, s):
        if self.version_class is None:
            raise ValueError('Please specify a version class')
        self._string = s = s.strip()
        r = self.parse_requirement(s)
        if not r:
            raise ValueError('Not valid: %r' % s)
        self.name = r.name
        self.key = self.name.lower()    # for case-insensitive comparisons
        clist = []
        if r.constraints:
            # import pdb; pdb.set_trace()
            for op, s in r.constraints:
                if s.endswith('.*'):
                    if op not in ('==', '!='):
                        raise ValueError('\'.*\' not allowed for '
                                         '%r constraints' % op)
                    # Could be a partial version (e.g. for '2.*') which
                    # won't parse as a version, so keep it as a string
                    vn, prefix = s[:-2], True
                    # Just to check that vn is a valid version
                    self.version_class(vn)
                else:
                    # Should parse as a version, so we can create an
                    # instance for the comparison
                    vn, prefix = self.version_class(s), False
                clist.append((op, vn, prefix))
        self._parts = tuple(clist)

    def match(self, version):
        """
        Check if the provided version matches the constraints.

        :param version: The version to match against this instance.
        :type version: String or :class:`Version` instance.
        """
        if isinstance(version, string_types):
            version = self.version_class(version)
        for operator, constraint, prefix in self._parts:
            f = self._operators.get(operator)
            if isinstance(f, string_types):
                f = getattr(self, f)
            if not f:
                msg = ('%r not implemented '
                       'for %s' % (operator, self.__class__.__name__))
                raise NotImplementedError(msg)
            if not f(version, constraint, prefix):
                return False
        return True

    @property
    def exact_version(self):
        result = None
        if len(self._parts) == 1 and self._parts[0][0] in ('==', '==='):
            result = self._parts[0][1]
        return result

    def _check_compatible(self, other):
        if type(self) != type(other) or self.name != other.name:
            raise TypeError('cannot compare %s and %s' % (self, other))

    def __eq__(self, other):
        self._check_compatible(other)
        return self.key == other.key and self._parts == other._parts

    def __ne__(self, other):
        return not self.__eq__(other)

    # See http://docs.python.org/reference/datamodel#object.__hash__
    def __hash__(self):
        return hash(self.key) + hash(self._parts)

    def __repr__(self):
        return "%s(%r)" % (self.__class__.__name__, self._string)

    def __str__(self):
        return self._string


PEP440_VERSION_RE = re.compile(r'^v?(\d+!)?(\d+(\.\d+)*)((a|b|c|rc)(\d+))?'
                               r'(\.(post)(\d+))?(\.(dev)(\d+))?'
                               r'(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$')


def _pep_440_key(s):
    s = s.strip()
    m = PEP440_VERSION_RE.match(s)
    if not m:
        raise UnsupportedVersionError('Not a valid version: %s' % s)
    groups = m.groups()
    nums = tuple(int(v) for v in groups[1].split('.'))
    while len(nums) > 1 and nums[-1] == 0:
        nums = nums[:-1]

    if not groups[0]:
        epoch = 0
    else:
        epoch = int(groups[0])
    pre = groups[4:6]
    post = groups[7:9]
    dev = groups[10:12]
    local = groups[13]
    if pre == (None, None):
        pre = ()
    else:
        pre = pre[0], int(pre[1])
    if post == (None, None):
        post = ()
    else:
        post = post[0], int(post[1])
    if dev == (None, None):
        dev = ()
    else:
        dev = dev[0], int(dev[1])
    if local is None:
        local = ()
    else:
        parts = []
        for part in local.split('.'):
            # to ensure that numeric compares as > lexicographic, avoid
            # comparing them directly, but encode a tuple which ensures
            # correct sorting
            if part.isdigit():
                part = (1, int(part))
            else:
                part = (0, part)
            parts.append(part)
        local = tuple(parts)
    if not pre:
        # either before pre-release, or final release and after
        if not post and dev:
            # before pre-release
            pre = ('a', -1)     # to sort before a0
        else:
            pre = ('z',)        # to sort after all pre-releases
    # now look at the state of post and dev.
    if not post:
        post = ('_',)   # sort before 'a'
    if not dev:
        dev = ('final',)

    #print('%s -> %s' % (s, m.groups()))
    return epoch, nums, pre, post, dev, local


_normalized_key = _pep_440_key


class NormalizedVersion(Version):
    """A rational version.

    Good:
        1.2         # equivalent to "1.2.0"
        1.2.0
        1.2a1
        1.2.3a2
        1.2.3b1
        1.2.3c1
        1.2.3.4
        TODO: fill this out

    Bad:
        1           # minimum two numbers
        1.2a        # release level must have a release serial
        1.2.3b
    """
    def parse(self, s):
        result = _normalized_key(s)
        # _normalized_key loses trailing zeroes in the release
        # clause, since that's needed to ensure that X.Y == X.Y.0 == X.Y.0.0
        # However, PEP 440 prefix matching needs it: for example,
        # (~= 1.4.5.0) matches differently to (~= 1.4.5.0.0).
        m = PEP440_VERSION_RE.match(s)      # must succeed
        groups = m.groups()
        self._release_clause = tuple(int(v) for v in groups[1].split('.'))
        return result

    PREREL_TAGS = set(['a', 'b', 'c', 'rc', 'dev'])

    @property
    def is_prerelease(self):
        return any(t[0] in self.PREREL_TAGS for t in self._parts if t)


def _match_prefix(x, y):
    x = str(x)
    y = str(y)
    if x == y:
        return True
    if not x.startswith(y):
        return False
    n = len(y)
    return x[n] == '.'


class NormalizedMatcher(Matcher):
    version_class = NormalizedVersion

    # value is either a callable or the name of a method
    _operators = {
        '~=': '_match_compatible',
        '<': '_match_lt',
        '>': '_match_gt',
        '<=': '_match_le',
        '>=': '_match_ge',
        '==': '_match_eq',
        '===': '_match_arbitrary',
        '!=': '_match_ne',
    }

    def _adjust_local(self, version, constraint, prefix):
        if prefix:
            strip_local = '+' not in constraint and version._parts[-1]
        else:
            # both constraint and version are
            # NormalizedVersion instances.
            # If constraint does not have a local component,
            # ensure the version doesn't, either.
            strip_local = not constraint._parts[-1] and version._parts[-1]
        if strip_local:
            s = version._string.split('+', 1)[0]
            version = self.version_class(s)
        return version, constraint

    def _match_lt(self, version, constraint, prefix):
        version, constraint = self._adjust_local(version, constraint, prefix)
        if version >= constraint:
            return False
        release_clause = constraint._release_clause
        pfx = '.'.join([str(i) for i in release_clause])
        return not _match_prefix(version, pfx)

    def _match_gt(self, version, constraint, prefix):
        version, constraint = self._adjust_local(version, constraint, prefix)
        if version <= constraint:
            return False
        release_clause = constraint._release_clause
        pfx = '.'.join([str(i) for i in release_clause])
        return not _match_prefix(version, pfx)

    def _match_le(self, version, constraint, prefix):
        version, constraint = self._adjust_local(version, constraint, prefix)
        return version <= constraint

    def _match_ge(self, version, constraint, prefix):
        version, constraint = self._adjust_local(version, constraint, prefix)
        return version >= constraint

    def _match_eq(self, version, constraint, prefix):
        version, constraint = self._adjust_local(version, constraint, prefix)
        if not prefix:
            result = (version == constraint)
        else:
            result = _match_prefix(version, constraint)
        return result

    def _match_arbitrary(self, version, constraint, prefix):
        return str(version) == str(constraint)

    def _match_ne(self, version, constraint, prefix):
        version, constraint = self._adjust_local(version, constraint, prefix)
        if not prefix:
            result = (version != constraint)
        else:
            result = not _match_prefix(version, constraint)
        return result

    def _match_compatible(self, version, constraint, prefix):
        version, constraint = self._adjust_local(version, constraint, prefix)
        if version == constraint:
            return True
        if version < constraint:
            return False
#        if not prefix:
#            return True
        release_clause = constraint._release_clause
        if len(release_clause) > 1:
            release_clause = release_clause[:-1]
        pfx = '.'.join([str(i) for i in release_clause])
        return _match_prefix(version, pfx)

_REPLACEMENTS = (
    (re.compile('[.+-]$'), ''),                     # remove trailing puncts
    (re.compile(r'^[.](\d)'), r'0.\1'),             # .N -> 0.N at start
    (re.compile('^[.-]'), ''),                      # remove leading puncts
    (re.compile(r'^\((.*)\)$'), r'\1'),             # remove parentheses
    (re.compile(r'^v(ersion)?\s*(\d+)'), r'\2'),    # remove leading v(ersion)
    (re.compile(r'^r(ev)?\s*(\d+)'), r'\2'),        # remove leading v(ersion)
    (re.compile('[.]{2,}'), '.'),                   # multiple runs of '.'
    (re.compile(r'\b(alfa|apha)\b'), 'alpha'),      # misspelt alpha
    (re.compile(r'\b(pre-alpha|prealpha)\b'),
                'pre.alpha'),                       # standardise
    (re.compile(r'\(beta\)$'), 'beta'),             # remove parentheses
)

_SUFFIX_REPLACEMENTS = (
    (re.compile('^[:~._+-]+'), ''),                   # remove leading puncts
    (re.compile('[,*")([\\]]'), ''),                  # remove unwanted chars
    (re.compile('[~:+_ -]'), '.'),                    # replace illegal chars
    (re.compile('[.]{2,}'), '.'),                   # multiple runs of '.'
    (re.compile(r'\.$'), ''),                       # trailing '.'
)

_NUMERIC_PREFIX = re.compile(r'(\d+(\.\d+)*)')


def _suggest_semantic_version(s):
    """
    Try to suggest a semantic form for a version for which
    _suggest_normalized_version couldn't come up with anything.
    """
    result = s.strip().lower()
    for pat, repl in _REPLACEMENTS:
        result = pat.sub(repl, result)
    if not result:
        result = '0.0.0'

    # Now look for numeric prefix, and separate it out from
    # the rest.
    #import pdb; pdb.set_trace()
    m = _NUMERIC_PREFIX.match(result)
    if not m:
        prefix = '0.0.0'
        suffix = result
    else:
        prefix = m.groups()[0].split('.')
        prefix = [int(i) for i in prefix]
        while len(prefix) < 3:
            prefix.append(0)
        if len(prefix) == 3:
            suffix = result[m.end():]
        else:
            suffix = '.'.join([str(i) for i in prefix[3:]]) + result[m.end():]
            prefix = prefix[:3]
        prefix = '.'.join([str(i) for i in prefix])
        suffix = suffix.strip()
    if suffix:
        #import pdb; pdb.set_trace()
        # massage the suffix.
        for pat, repl in _SUFFIX_REPLACEMENTS:
            suffix = pat.sub(repl, suffix)

    if not suffix:
        result = prefix
    else:
        sep = '-' if 'dev' in suffix else '+'
        result = prefix + sep + suffix
    if not is_semver(result):
        result = None
    return result


def _suggest_normalized_version(s):
    """Suggest a normalized version close to the given version string.

    If you have a version string that isn't rational (i.e. NormalizedVersion
    doesn't like it) then you might be able to get an equivalent (or close)
    rational version from this function.

    This does a number of simple normalizations to the given string, based
    on observation of versions currently in use on PyPI. Given a dump of
    those version during PyCon 2009, 4287 of them:
    - 2312 (53.93%) match NormalizedVersion without change
      with the automatic suggestion
    - 3474 (81.04%) match when using this suggestion method

    @param s {str} An irrational version string.
    @returns A rational version string, or None, if couldn't determine one.
    """
    try:
        _normalized_key(s)
        return s   # already rational
    except UnsupportedVersionError:
        pass

    rs = s.lower()

    # part of this could use maketrans
    for orig, repl in (('-alpha', 'a'), ('-beta', 'b'), ('alpha', 'a'),
                       ('beta', 'b'), ('rc', 'c'), ('-final', ''),
                       ('-pre', 'c'),
                       ('-release', ''), ('.release', ''), ('-stable', ''),
                       ('+', '.'), ('_', '.'), (' ', ''), ('.final', ''),
                       ('final', '')):
        rs = rs.replace(orig, repl)

    # if something ends with dev or pre, we add a 0
    rs = re.sub(r"pre$", r"pre0", rs)
    rs = re.sub(r"dev$", r"dev0", rs)

    # if we have something like "b-2" or "a.2" at the end of the
    # version, that is probably beta, alpha, etc
    # let's remove the dash or dot
    rs = re.sub(r"([abc]|rc)[\-\.](\d+)$", r"\1\2", rs)

    # 1.0-dev-r371 -> 1.0.dev371
    # 0.1-dev-r79 -> 0.1.dev79
    rs = re.sub(r"[\-\.](dev)[\-\.]?r?(\d+)$", r".\1\2", rs)

    # Clean: 2.0.a.3, 2.0.b1, 0.9.0~c1
    rs = re.sub(r"[.~]?([abc])\.?", r"\1", rs)

    # Clean: v0.3, v1.0
    if rs.startswith('v'):
        rs = rs[1:]

    # Clean leading '0's on numbers.
    #TODO: unintended side-effect on, e.g., "2003.05.09"
    # PyPI stats: 77 (~2%) better
    rs = re.sub(r"\b0+(\d+)(?!\d)", r"\1", rs)

    # Clean a/b/c with no version. E.g. "1.0a" -> "1.0a0". Setuptools infers
    # zero.
    # PyPI stats: 245 (7.56%) better
    rs = re.sub(r"(\d+[abc])$", r"\g<1>0", rs)

    # the 'dev-rNNN' tag is a dev tag
    rs = re.sub(r"\.?(dev-r|dev\.r)\.?(\d+)$", r".dev\2", rs)

    # clean the - when used as a pre delimiter
    rs = re.sub(r"-(a|b|c)(\d+)$", r"\1\2", rs)

    # a terminal "dev" or "devel" can be changed into ".dev0"
    rs = re.sub(r"[\.\-](dev|devel)$", r".dev0", rs)

    # a terminal "dev" can be changed into ".dev0"
    rs = re.sub(r"(?![\.\-])dev$", r".dev0", rs)

    # a terminal "final" or "stable" can be removed
    rs = re.sub(r"(final|stable)$", "", rs)

    # The 'r' and the '-' tags are post release tags
    #   0.4a1.r10       ->  0.4a1.post10
    #   0.9.33-17222    ->  0.9.33.post17222
    #   0.9.33-r17222   ->  0.9.33.post17222
    rs = re.sub(r"\.?(r|-|-r)\.?(\d+)$", r".post\2", rs)

    # Clean 'r' instead of 'dev' usage:
    #   0.9.33+r17222   ->  0.9.33.dev17222
    #   1.0dev123       ->  1.0.dev123
    #   1.0.git123      ->  1.0.dev123
    #   1.0.bzr123      ->  1.0.dev123
    #   0.1a0dev.123    ->  0.1a0.dev123
    # PyPI stats:  ~150 (~4%) better
    rs = re.sub(r"\.?(dev|git|bzr)\.?(\d+)$", r".dev\2", rs)

    # Clean '.pre' (normalized from '-pre' above) instead of 'c' usage:
    #   0.2.pre1        ->  0.2c1
    #   0.2-c1         ->  0.2c1
    #   1.0preview123   ->  1.0c123
    # PyPI stats: ~21 (0.62%) better
    rs = re.sub(r"\.?(pre|preview|-c)(\d+)$", r"c\g<2>", rs)

    # Tcl/Tk uses "px" for their post release markers
    rs = re.sub(r"p(\d+)$", r".post\1", rs)

    try:
        _normalized_key(rs)
    except UnsupportedVersionError:
        rs = None
    return rs

#
#   Legacy version processing (distribute-compatible)
#

_VERSION_PART = re.compile(r'([a-z]+|\d+|[\.-])', re.I)
_VERSION_REPLACE = {
    'pre': 'c',
    'preview': 'c',
    '-': 'final-',
    'rc': 'c',
    'dev': '@',
    '': None,
    '.': None,
}


def _legacy_key(s):
    def get_parts(s):
        result = []
        for p in _VERSION_PART.split(s.lower()):
            p = _VERSION_REPLACE.get(p, p)
            if p:
                if '0' <= p[:1] <= '9':
                    p = p.zfill(8)
                else:
                    p = '*' + p
                result.append(p)
        result.append('*final')
        return result

    result = []
    for p in get_parts(s):
        if p.startswith('*'):
            if p < '*final':
                while result and result[-1] == '*final-':
                    result.pop()
            while result and result[-1] == '00000000':
                result.pop()
        result.append(p)
    return tuple(result)


class LegacyVersion(Version):
    def parse(self, s):
        return _legacy_key(s)

    @property
    def is_prerelease(self):
        result = False
        for x in self._parts:
            if (isinstance(x, string_types) and x.startswith('*') and
                x < '*final'):
                result = True
                break
        return result


class LegacyMatcher(Matcher):
    version_class = LegacyVersion

    _operators = dict(Matcher._operators)
    _operators['~='] = '_match_compatible'

    numeric_re = re.compile(r'^(\d+(\.\d+)*)')

    def _match_compatible(self, version, constraint, prefix):
        if version < constraint:
            return False
        m = self.numeric_re.match(str(constraint))
        if not m:
            logger.warning('Cannot compute compatible match for version %s '
                           ' and constraint %s', version, constraint)
            return True
        s = m.groups()[0]
        if '.' in s:
            s = s.rsplit('.', 1)[0]
        return _match_prefix(version, s)

#
#   Semantic versioning
#

_SEMVER_RE = re.compile(r'^(\d+)\.(\d+)\.(\d+)'
                        r'(-[a-z0-9]+(\.[a-z0-9-]+)*)?'
                        r'(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$', re.I)


def is_semver(s):
    return _SEMVER_RE.match(s)


def _semantic_key(s):
    def make_tuple(s, absent):
        if s is None:
            result = (absent,)
        else:
            parts = s[1:].split('.')
            # We can't compare ints and strings on Python 3, so fudge it
            # by zero-filling numeric values so simulate a numeric comparison
            result = tuple([p.zfill(8) if p.isdigit() else p for p in parts])
        return result

    m = is_semver(s)
    if not m:
        raise UnsupportedVersionError(s)
    groups = m.groups()
    major, minor, patch = [int(i) for i in groups[:3]]
    # choose the '|' and '*' so that versions sort correctly
    pre, build = make_tuple(groups[3], '|'), make_tuple(groups[5], '*')
    return (major, minor, patch), pre, build


class SemanticVersion(Version):
    def parse(self, s):
        return _semantic_key(s)

    @property
    def is_prerelease(self):
        return self._parts[1][0] != '|'


class SemanticMatcher(Matcher):
    version_class = SemanticVersion


class VersionScheme(object):
    def __init__(self, key, matcher, suggester=None):
        self.key = key
        self.matcher = matcher
        self.suggester = suggester

    def is_valid_version(self, s):
        try:
            self.matcher.version_class(s)
            result = True
        except UnsupportedVersionError:
            result = False
        return result

    def is_valid_matcher(self, s):
        try:
            self.matcher(s)
            result = True
        except UnsupportedVersionError:
            result = False
        return result

    def is_valid_constraint_list(self, s):
        """
        Used for processing some metadata fields
        """
        return self.is_valid_matcher('dummy_name (%s)' % s)

    def suggest(self, s):
        if self.suggester is None:
            result = None
        else:
            result = self.suggester(s)
        return result

_SCHEMES = {
    'normalized': VersionScheme(_normalized_key, NormalizedMatcher,
                                _suggest_normalized_version),
    'legacy': VersionScheme(_legacy_key, LegacyMatcher, lambda self, s: s),
    'semantic': VersionScheme(_semantic_key, SemanticMatcher,
                              _suggest_semantic_version),
}

_SCHEMES['default'] = _SCHEMES['normalized']


def get_scheme(name):
    if name not in _SCHEMES:
        raise ValueError('unknown scheme name: %r' % name)
    return _SCHEMES[name]
site-packages/pip/_vendor/distlib/scripts.py000064400000037642151446177000015224 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2015 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

from .compat import sysconfig, detect_encoding, ZipFile
from .resources import finder
from .util import (FileOperator, get_export_entry, convert_path,
                   get_executable, in_venv)

logger = logging.getLogger(__name__)

_DEFAULT_MANIFEST = '''
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
 <assemblyIdentity version="1.0.0.0"
 processorArchitecture="X86"
 name="%s"
 type="win32"/>

 <!-- Identify the application security requirements. -->
 <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
 <security>
 <requestedPrivileges>
 <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
 </requestedPrivileges>
 </security>
 </trustInfo>
</assembly>'''.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
from %(module)s import %(import_name)s
if __name__ == '__main__':
    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
    sys.exit(%(func)s())
'''


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


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')

    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
        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"' '''"
        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
            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
        executable = os.path.normcase(executable)
        # 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
        linesep = os.linesep.encode('utf-8')
        if not shebang.endswith(linesep):
            shebang += linesep
        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:
                zf.writestr('__main__.py', script_bytes)
            zip_data = stream.getvalue()
            script_bytes = launcher + shebang + zip_data
        for name in names:
            outname = os.path.join(self.target_dir, name)
            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)

    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')
        name = entry.name
        scriptnames = set()
        if '' in self.variants:
            scriptnames.add(name)
        if 'X' in self.variants:
            scriptnames.add('%s%s' % (name, sys.version[0]))
        if 'X.Y' in self.variants:
            scriptnames.add('%s-%s' % (name, sys.version[:3]))
        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: %s is an empty file (skipping)',
                               self.get_command_name(),  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'
            name = '%s%s.exe' % (kind, bits)
            # Issue 31: don't hardcode an absolute package name, but
            # determine it relative to the current package
            distlib_package = __name__.rsplit('.', 1)[0]
            result = finder(distlib_package).find(name).bytes
            return result

    # 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
site-packages/pip/_vendor/distlib/util.py000064400000165770151446177000014516 0ustar00#
# Copyright (C) 2012-2017 The Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
import codecs
from collections import deque
import contextlib
import csv
from glob import iglob as std_iglob
import io
import json
import logging
import os
import py_compile
import re
import socket
try:
    import ssl
except ImportError:  # pragma: no cover
    ssl = None
import subprocess
import sys
import tarfile
import tempfile
import textwrap

try:
    import threading
except ImportError:  # pragma: no cover
    import dummy_threading as threading
import time

from . import DistlibException
from .compat import (string_types, text_type, shutil, raw_input, StringIO,
                     cache_from_source, urlopen, urljoin, httplib, xmlrpclib,
                     splittype, HTTPHandler, BaseConfigurator, valid_ident,
                     Container, configparser, URLError, ZipFile, fsdecode,
                     unquote, urlparse)

logger = logging.getLogger(__name__)

#
# Requirement parsing code as per PEP 508
#

IDENTIFIER = re.compile(r'^([\w\.-]+)\s*')
VERSION_IDENTIFIER = re.compile(r'^([\w\.*+-]+)\s*')
COMPARE_OP = re.compile(r'^(<=?|>=?|={2,3}|[~!]=)\s*')
MARKER_OP = re.compile(r'^((<=?)|(>=?)|={2,3}|[~!]=|in|not\s+in)\s*')
OR = re.compile(r'^or\b\s*')
AND = re.compile(r'^and\b\s*')
NON_SPACE = re.compile(r'(\S+)\s*')
STRING_CHUNK = re.compile(r'([\s\w\.{}()*+#:;,/?!~`@$%^&=|<>\[\]-]+)')


def parse_marker(marker_string):
    """
    Parse a marker string and return a dictionary containing a marker expression.

    The dictionary will contain keys "op", "lhs" and "rhs" for non-terminals in
    the expression grammar, or strings. A string contained in quotes is to be
    interpreted as a literal string, and a string not contained in quotes is a
    variable (such as os_name).
    """
    def marker_var(remaining):
        # either identifier, or literal string
        m = IDENTIFIER.match(remaining)
        if m:
            result = m.groups()[0]
            remaining = remaining[m.end():]
        elif not remaining:
            raise SyntaxError('unexpected end of input')
        else:
            q = remaining[0]
            if q not in '\'"':
                raise SyntaxError('invalid expression: %s' % remaining)
            oq = '\'"'.replace(q, '')
            remaining = remaining[1:]
            parts = [q]
            while remaining:
                # either a string chunk, or oq, or q to terminate
                if remaining[0] == q:
                    break
                elif remaining[0] == oq:
                    parts.append(oq)
                    remaining = remaining[1:]
                else:
                    m = STRING_CHUNK.match(remaining)
                    if not m:
                        raise SyntaxError('error in string literal: %s' % remaining)
                    parts.append(m.groups()[0])
                    remaining = remaining[m.end():]
            else:
                s = ''.join(parts)
                raise SyntaxError('unterminated string: %s' % s)
            parts.append(q)
            result = ''.join(parts)
            remaining = remaining[1:].lstrip() # skip past closing quote
        return result, remaining

    def marker_expr(remaining):
        if remaining and remaining[0] == '(':
            result, remaining = marker(remaining[1:].lstrip())
            if remaining[0] != ')':
                raise SyntaxError('unterminated parenthesis: %s' % remaining)
            remaining = remaining[1:].lstrip()
        else:
            lhs, remaining = marker_var(remaining)
            while remaining:
                m = MARKER_OP.match(remaining)
                if not m:
                    break
                op = m.groups()[0]
                remaining = remaining[m.end():]
                rhs, remaining = marker_var(remaining)
                lhs = {'op': op, 'lhs': lhs, 'rhs': rhs}
            result = lhs
        return result, remaining

    def marker_and(remaining):
        lhs, remaining = marker_expr(remaining)
        while remaining:
            m = AND.match(remaining)
            if not m:
                break
            remaining = remaining[m.end():]
            rhs, remaining = marker_expr(remaining)
            lhs = {'op': 'and', 'lhs': lhs, 'rhs': rhs}
        return lhs, remaining

    def marker(remaining):
        lhs, remaining = marker_and(remaining)
        while remaining:
            m = OR.match(remaining)
            if not m:
                break
            remaining = remaining[m.end():]
            rhs, remaining = marker_and(remaining)
            lhs = {'op': 'or', 'lhs': lhs, 'rhs': rhs}
        return lhs, remaining

    return marker(marker_string)


def parse_requirement(req):
    """
    Parse a requirement passed in as a string. Return a Container
    whose attributes contain the various parts of the requirement.
    """
    remaining = req.strip()
    if not remaining or remaining.startswith('#'):
        return None
    m = IDENTIFIER.match(remaining)
    if not m:
        raise SyntaxError('name expected: %s' % remaining)
    distname = m.groups()[0]
    remaining = remaining[m.end():]
    extras = mark_expr = versions = uri = None
    if remaining and remaining[0] == '[':
        i = remaining.find(']', 1)
        if i < 0:
            raise SyntaxError('unterminated extra: %s' % remaining)
        s = remaining[1:i]
        remaining = remaining[i + 1:].lstrip()
        extras = []
        while s:
            m = IDENTIFIER.match(s)
            if not m:
                raise SyntaxError('malformed extra: %s' % s)
            extras.append(m.groups()[0])
            s = s[m.end():]
            if not s:
                break
            if s[0] != ',':
                raise SyntaxError('comma expected in extras: %s' % s)
            s = s[1:].lstrip()
        if not extras:
            extras = None
    if remaining:
        if remaining[0] == '@':
            # it's a URI
            remaining = remaining[1:].lstrip()
            m = NON_SPACE.match(remaining)
            if not m:
                raise SyntaxError('invalid URI: %s' % remaining)
            uri = m.groups()[0]
            t = urlparse(uri)
            # there are issues with Python and URL parsing, so this test
            # is a bit crude. See bpo-20271, bpo-23505. Python doesn't
            # always parse invalid URLs correctly - it should raise
            # exceptions for malformed URLs
            if not (t.scheme and t.netloc):
                raise SyntaxError('Invalid URL: %s' % uri)
            remaining = remaining[m.end():].lstrip()
        else:

            def get_versions(ver_remaining):
                """
                Return a list of operator, version tuples if any are
                specified, else None.
                """
                m = COMPARE_OP.match(ver_remaining)
                versions = None
                if m:
                    versions = []
                    while True:
                        op = m.groups()[0]
                        ver_remaining = ver_remaining[m.end():]
                        m = VERSION_IDENTIFIER.match(ver_remaining)
                        if not m:
                            raise SyntaxError('invalid version: %s' % ver_remaining)
                        v = m.groups()[0]
                        versions.append((op, v))
                        ver_remaining = ver_remaining[m.end():]
                        if not ver_remaining or ver_remaining[0] != ',':
                            break
                        ver_remaining = ver_remaining[1:].lstrip()
                        m = COMPARE_OP.match(ver_remaining)
                        if not m:
                            raise SyntaxError('invalid constraint: %s' % ver_remaining)
                    if not versions:
                        versions = None
                return versions, ver_remaining

            if remaining[0] != '(':
                versions, remaining = get_versions(remaining)
            else:
                i = remaining.find(')', 1)
                if i < 0:
                    raise SyntaxError('unterminated parenthesis: %s' % remaining)
                s = remaining[1:i]
                remaining = remaining[i + 1:].lstrip()
                # As a special diversion from PEP 508, allow a version number
                # a.b.c in parentheses as a synonym for ~= a.b.c (because this
                # is allowed in earlier PEPs)
                if COMPARE_OP.match(s):
                    versions, _ = get_versions(s)
                else:
                    m = VERSION_IDENTIFIER.match(s)
                    if not m:
                        raise SyntaxError('invalid constraint: %s' % s)
                    v = m.groups()[0]
                    s = s[m.end():].lstrip()
                    if s:
                        raise SyntaxError('invalid constraint: %s' % s)
                    versions = [('~=', v)]

    if remaining:
        if remaining[0] != ';':
            raise SyntaxError('invalid requirement: %s' % remaining)
        remaining = remaining[1:].lstrip()

        mark_expr, remaining = parse_marker(remaining)

    if remaining and remaining[0] != '#':
        raise SyntaxError('unexpected trailing data: %s' % remaining)

    if not versions:
        rs = distname
    else:
        rs = '%s %s' % (distname, ', '.join(['%s %s' % con for con in versions]))
    return Container(name=distname, extras=extras, constraints=versions,
                     marker=mark_expr, url=uri, requirement=rs)


def get_resources_dests(resources_root, rules):
    """Find destinations for resources files"""

    def get_rel_path(root, path):
        # normalizes and returns a lstripped-/-separated path
        root = root.replace(os.path.sep, '/')
        path = path.replace(os.path.sep, '/')
        assert path.startswith(root)
        return path[len(root):].lstrip('/')

    destinations = {}
    for base, suffix, dest in rules:
        prefix = os.path.join(resources_root, base)
        for abs_base in iglob(prefix):
            abs_glob = os.path.join(abs_base, suffix)
            for abs_path in iglob(abs_glob):
                resource_file = get_rel_path(resources_root, abs_path)
                if dest is None:  # remove the entry if it was here
                    destinations.pop(resource_file, None)
                else:
                    rel_path = get_rel_path(abs_base, abs_path)
                    rel_dest = dest.replace(os.path.sep, '/').rstrip('/')
                    destinations[resource_file] = rel_dest + '/' + rel_path
    return destinations


def in_venv():
    if hasattr(sys, 'real_prefix'):
        # virtualenv venvs
        result = True
    else:
        # PEP 405 venvs
        result = sys.prefix != getattr(sys, 'base_prefix', sys.prefix)
    return result


def get_executable():
# The __PYVENV_LAUNCHER__ dance is apparently no longer needed, as
# changes to the stub launcher mean that sys.executable always points
# to the stub on OS X
#    if sys.platform == 'darwin' and ('__PYVENV_LAUNCHER__'
#                                     in os.environ):
#        result =  os.environ['__PYVENV_LAUNCHER__']
#    else:
#        result = sys.executable
#    return result
    result = os.path.normcase(sys.executable)
    if not isinstance(result, text_type):
        result = fsdecode(result)
    return result


def proceed(prompt, allowed_chars, error_prompt=None, default=None):
    p = prompt
    while True:
        s = raw_input(p)
        p = prompt
        if not s and default:
            s = default
        if s:
            c = s[0].lower()
            if c in allowed_chars:
                break
            if error_prompt:
                p = '%c: %s\n%s' % (c, error_prompt, prompt)
    return c


def extract_by_key(d, keys):
    if isinstance(keys, string_types):
        keys = keys.split()
    result = {}
    for key in keys:
        if key in d:
            result[key] = d[key]
    return result

def read_exports(stream):
    if sys.version_info[0] >= 3:
        # needs to be a text stream
        stream = codecs.getreader('utf-8')(stream)
    # Try to load as JSON, falling back on legacy format
    data = stream.read()
    stream = StringIO(data)
    try:
        jdata = json.load(stream)
        result = jdata['extensions']['python.exports']['exports']
        for group, entries in result.items():
            for k, v in entries.items():
                s = '%s = %s' % (k, v)
                entry = get_export_entry(s)
                assert entry is not None
                entries[k] = entry
        return result
    except Exception:
        stream.seek(0, 0)

    def read_stream(cp, stream):
        if hasattr(cp, 'read_file'):
            cp.read_file(stream)
        else:
            cp.readfp(stream)

    cp = configparser.ConfigParser()
    try:
        read_stream(cp, stream)
    except configparser.MissingSectionHeaderError:
        stream.close()
        data = textwrap.dedent(data)
        stream = StringIO(data)
        read_stream(cp, stream)

    result = {}
    for key in cp.sections():
        result[key] = entries = {}
        for name, value in cp.items(key):
            s = '%s = %s' % (name, value)
            entry = get_export_entry(s)
            assert entry is not None
            #entry.dist = self
            entries[name] = entry
    return result


def write_exports(exports, stream):
    if sys.version_info[0] >= 3:
        # needs to be a text stream
        stream = codecs.getwriter('utf-8')(stream)
    cp = configparser.ConfigParser()
    for k, v in exports.items():
        # TODO check k, v for valid values
        cp.add_section(k)
        for entry in v.values():
            if entry.suffix is None:
                s = entry.prefix
            else:
                s = '%s:%s' % (entry.prefix, entry.suffix)
            if entry.flags:
                s = '%s [%s]' % (s, ', '.join(entry.flags))
            cp.set(k, entry.name, s)
    cp.write(stream)


@contextlib.contextmanager
def tempdir():
    td = tempfile.mkdtemp()
    try:
        yield td
    finally:
        shutil.rmtree(td)

@contextlib.contextmanager
def chdir(d):
    cwd = os.getcwd()
    try:
        os.chdir(d)
        yield
    finally:
        os.chdir(cwd)


@contextlib.contextmanager
def socket_timeout(seconds=15):
    cto = socket.getdefaulttimeout()
    try:
        socket.setdefaulttimeout(seconds)
        yield
    finally:
        socket.setdefaulttimeout(cto)


class cached_property(object):
    def __init__(self, func):
        self.func = func
        #for attr in ('__name__', '__module__', '__doc__'):
        #    setattr(self, attr, getattr(func, attr, None))

    def __get__(self, obj, cls=None):
        if obj is None:
            return self
        value = self.func(obj)
        object.__setattr__(obj, self.func.__name__, value)
        #obj.__dict__[self.func.__name__] = value = self.func(obj)
        return value

def convert_path(pathname):
    """Return 'pathname' as a name that will work on the native filesystem.

    The path is split on '/' and put back together again using the current
    directory separator.  Needed because filenames in the setup script are
    always supplied in Unix style, and have to be converted to the local
    convention before we can actually use them in the filesystem.  Raises
    ValueError on non-Unix-ish systems if 'pathname' either starts or
    ends with a slash.
    """
    if os.sep == '/':
        return pathname
    if not pathname:
        return pathname
    if pathname[0] == '/':
        raise ValueError("path '%s' cannot be absolute" % pathname)
    if pathname[-1] == '/':
        raise ValueError("path '%s' cannot end with '/'" % pathname)

    paths = pathname.split('/')
    while os.curdir in paths:
        paths.remove(os.curdir)
    if not paths:
        return os.curdir
    return os.path.join(*paths)


class FileOperator(object):
    def __init__(self, dry_run=False):
        self.dry_run = dry_run
        self.ensured = set()
        self._init_record()

    def _init_record(self):
        self.record = False
        self.files_written = set()
        self.dirs_created = set()

    def record_as_written(self, path):
        if self.record:
            self.files_written.add(path)

    def newer(self, source, target):
        """Tell if the target is newer than the source.

        Returns true if 'source' exists and is more recently modified than
        'target', or if 'source' exists and 'target' doesn't.

        Returns false if both exist and 'target' is the same age or younger
        than 'source'. Raise PackagingFileError if 'source' does not exist.

        Note that this test is not very accurate: files created in the same
        second will have the same "age".
        """
        if not os.path.exists(source):
            raise DistlibException("file '%r' does not exist" %
                                   os.path.abspath(source))
        if not os.path.exists(target):
            return True

        return os.stat(source).st_mtime > os.stat(target).st_mtime

    def copy_file(self, infile, outfile, check=True):
        """Copy a file respecting dry-run and force flags.
        """
        self.ensure_dir(os.path.dirname(outfile))
        logger.info('Copying %s to %s', infile, outfile)
        if not self.dry_run:
            msg = None
            if check:
                if os.path.islink(outfile):
                    msg = '%s is a symlink' % outfile
                elif os.path.exists(outfile) and not os.path.isfile(outfile):
                    msg = '%s is a non-regular file' % outfile
            if msg:
                raise ValueError(msg + ' which would be overwritten')
            shutil.copyfile(infile, outfile)
        self.record_as_written(outfile)

    def copy_stream(self, instream, outfile, encoding=None):
        assert not os.path.isdir(outfile)
        self.ensure_dir(os.path.dirname(outfile))
        logger.info('Copying stream %s to %s', instream, outfile)
        if not self.dry_run:
            if encoding is None:
                outstream = open(outfile, 'wb')
            else:
                outstream = codecs.open(outfile, 'w', encoding=encoding)
            try:
                shutil.copyfileobj(instream, outstream)
            finally:
                outstream.close()
        self.record_as_written(outfile)

    def write_binary_file(self, path, data):
        self.ensure_dir(os.path.dirname(path))
        if not self.dry_run:
            if os.path.exists(path):
                os.remove(path)
            with open(path, 'wb') as f:
                f.write(data)
        self.record_as_written(path)

    def write_text_file(self, path, data, encoding):
        self.write_binary_file(path, data.encode(encoding))

    def set_mode(self, bits, mask, files):
        if os.name == 'posix' or (os.name == 'java' and os._name == 'posix'):
            # Set the executable bits (owner, group, and world) on
            # all the files specified.
            for f in files:
                if self.dry_run:
                    logger.info("changing mode of %s", f)
                else:
                    mode = (os.stat(f).st_mode | bits) & mask
                    logger.info("changing mode of %s to %o", f, mode)
                    os.chmod(f, mode)

    set_executable_mode = lambda s, f: s.set_mode(0o555, 0o7777, f)

    def ensure_dir(self, path):
        path = os.path.abspath(path)
        if path not in self.ensured and not os.path.exists(path):
            self.ensured.add(path)
            d, f = os.path.split(path)
            self.ensure_dir(d)
            logger.info('Creating %s' % path)
            if not self.dry_run:
                os.mkdir(path)
            if self.record:
                self.dirs_created.add(path)

    def byte_compile(self, path, optimize=False, force=False, prefix=None, hashed_invalidation=False):
        dpath = cache_from_source(path, not optimize)
        logger.info('Byte-compiling %s to %s', path, dpath)
        if not self.dry_run:
            if force or self.newer(path, dpath):
                if not prefix:
                    diagpath = None
                else:
                    assert path.startswith(prefix)
                    diagpath = path[len(prefix):]
            compile_kwargs = {}
            if hashed_invalidation and hasattr(py_compile, 'PycInvalidationMode'):
                compile_kwargs['invalidation_mode'] = py_compile.PycInvalidationMode.CHECKED_HASH
            py_compile.compile(path, dpath, diagpath, True, **compile_kwargs)     # raise error
        self.record_as_written(dpath)
        return dpath

    def ensure_removed(self, path):
        if os.path.exists(path):
            if os.path.isdir(path) and not os.path.islink(path):
                logger.debug('Removing directory tree at %s', path)
                if not self.dry_run:
                    shutil.rmtree(path)
                if self.record:
                    if path in self.dirs_created:
                        self.dirs_created.remove(path)
            else:
                if os.path.islink(path):
                    s = 'link'
                else:
                    s = 'file'
                logger.debug('Removing %s %s', s, path)
                if not self.dry_run:
                    os.remove(path)
                if self.record:
                    if path in self.files_written:
                        self.files_written.remove(path)

    def is_writable(self, path):
        result = False
        while not result:
            if os.path.exists(path):
                result = os.access(path, os.W_OK)
                break
            parent = os.path.dirname(path)
            if parent == path:
                break
            path = parent
        return result

    def commit(self):
        """
        Commit recorded changes, turn off recording, return
        changes.
        """
        assert self.record
        result = self.files_written, self.dirs_created
        self._init_record()
        return result

    def rollback(self):
        if not self.dry_run:
            for f in list(self.files_written):
                if os.path.exists(f):
                    os.remove(f)
            # dirs should all be empty now, except perhaps for
            # __pycache__ subdirs
            # reverse so that subdirs appear before their parents
            dirs = sorted(self.dirs_created, reverse=True)
            for d in dirs:
                flist = os.listdir(d)
                if flist:
                    assert flist == ['__pycache__']
                    sd = os.path.join(d, flist[0])
                    os.rmdir(sd)
                os.rmdir(d)     # should fail if non-empty
        self._init_record()

def resolve(module_name, dotted_path):
    if module_name in sys.modules:
        mod = sys.modules[module_name]
    else:
        mod = __import__(module_name)
    if dotted_path is None:
        result = mod
    else:
        parts = dotted_path.split('.')
        result = getattr(mod, parts.pop(0))
        for p in parts:
            result = getattr(result, p)
    return result


class ExportEntry(object):
    def __init__(self, name, prefix, suffix, flags):
        self.name = name
        self.prefix = prefix
        self.suffix = suffix
        self.flags = flags

    @cached_property
    def value(self):
        return resolve(self.prefix, self.suffix)

    def __repr__(self):  # pragma: no cover
        return '<ExportEntry %s = %s:%s %s>' % (self.name, self.prefix,
                                                self.suffix, self.flags)

    def __eq__(self, other):
        if not isinstance(other, ExportEntry):
            result = False
        else:
            result = (self.name == other.name and
                      self.prefix == other.prefix and
                      self.suffix == other.suffix and
                      self.flags == other.flags)
        return result

    __hash__ = object.__hash__


ENTRY_RE = re.compile(r'''(?P<name>(\w|[-.+])+)
                      \s*=\s*(?P<callable>(\w+)([:\.]\w+)*)
                      \s*(\[\s*(?P<flags>\w+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])?
                      ''', re.VERBOSE)

def get_export_entry(specification):
    m = ENTRY_RE.search(specification)
    if not m:
        result = None
        if '[' in specification or ']' in specification:
            raise DistlibException("Invalid specification "
                                   "'%s'" % specification)
    else:
        d = m.groupdict()
        name = d['name']
        path = d['callable']
        colons = path.count(':')
        if colons == 0:
            prefix, suffix = path, None
        else:
            if colons != 1:
                raise DistlibException("Invalid specification "
                                       "'%s'" % specification)
            prefix, suffix = path.split(':')
        flags = d['flags']
        if flags is None:
            if '[' in specification or ']' in specification:
                raise DistlibException("Invalid specification "
                                       "'%s'" % specification)
            flags = []
        else:
            flags = [f.strip() for f in flags.split(',')]
        result = ExportEntry(name, prefix, suffix, flags)
    return result


def get_cache_base(suffix=None):
    """
    Return the default base location for distlib caches. If the directory does
    not exist, it is created. Use the suffix provided for the base directory,
    and default to '.distlib' if it isn't provided.

    On Windows, if LOCALAPPDATA is defined in the environment, then it is
    assumed to be a directory, and will be the parent directory of the result.
    On POSIX, and on Windows if LOCALAPPDATA is not defined, the user's home
    directory - using os.expanduser('~') - will be the parent directory of
    the result.

    The result is just the directory '.distlib' in the parent directory as
    determined above, or with the name specified with ``suffix``.
    """
    if suffix is None:
        suffix = '.distlib'
    if os.name == 'nt' and 'LOCALAPPDATA' in os.environ:
        result = os.path.expandvars('$localappdata')
    else:
        # Assume posix, or old Windows
        result = os.path.expanduser('~')
    # we use 'isdir' instead of 'exists', because we want to
    # fail if there's a file with that name
    if os.path.isdir(result):
        usable = os.access(result, os.W_OK)
        if not usable:
            logger.warning('Directory exists but is not writable: %s', result)
    else:
        try:
            os.makedirs(result)
            usable = True
        except OSError:
            logger.warning('Unable to create %s', result, exc_info=True)
            usable = False
    if not usable:
        result = tempfile.mkdtemp()
        logger.warning('Default location unusable, using %s', result)
    return os.path.join(result, suffix)


def path_to_cache_dir(path):
    """
    Convert an absolute path to a directory name for use in a cache.

    The algorithm used is:

    #. On Windows, any ``':'`` in the drive is replaced with ``'---'``.
    #. Any occurrence of ``os.sep`` is replaced with ``'--'``.
    #. ``'.cache'`` is appended.
    """
    d, p = os.path.splitdrive(os.path.abspath(path))
    if d:
        d = d.replace(':', '---')
    p = p.replace(os.sep, '--')
    return d + p + '.cache'


def ensure_slash(s):
    if not s.endswith('/'):
        return s + '/'
    return s


def parse_credentials(netloc):
    username = password = None
    if '@' in netloc:
        prefix, netloc = netloc.rsplit('@', 1)
        if ':' not in prefix:
            username = prefix
        else:
            username, password = prefix.split(':', 1)
    if username:
        username = unquote(username)
    if password:
        password = unquote(password)
    return username, password, netloc


def get_process_umask():
    result = os.umask(0o22)
    os.umask(result)
    return result

def is_string_sequence(seq):
    result = True
    i = None
    for i, s in enumerate(seq):
        if not isinstance(s, string_types):
            result = False
            break
    assert i is not None
    return result

PROJECT_NAME_AND_VERSION = re.compile('([a-z0-9_]+([.-][a-z_][a-z0-9_]*)*)-'
                                      '([a-z0-9_.+-]+)', re.I)
PYTHON_VERSION = re.compile(r'-py(\d\.?\d?)')


def split_filename(filename, project_name=None):
    """
    Extract name, version, python version from a filename (no extension)

    Return name, version, pyver or None
    """
    result = None
    pyver = None
    filename = unquote(filename).replace(' ', '-')
    m = PYTHON_VERSION.search(filename)
    if m:
        pyver = m.group(1)
        filename = filename[:m.start()]
    if project_name and len(filename) > len(project_name) + 1:
        m = re.match(re.escape(project_name) + r'\b', filename)
        if m:
            n = m.end()
            result = filename[:n], filename[n + 1:], pyver
    if result is None:
        m = PROJECT_NAME_AND_VERSION.match(filename)
        if m:
            result = m.group(1), m.group(3), pyver
    return result

# Allow spaces in name because of legacy dists like "Twisted Core"
NAME_VERSION_RE = re.compile(r'(?P<name>[\w .-]+)\s*'
                             r'\(\s*(?P<ver>[^\s)]+)\)$')

def parse_name_and_version(p):
    """
    A utility method used to get name and version from a string.

    From e.g. a Provides-Dist value.

    :param p: A value in a form 'foo (1.0)'
    :return: The name and version as a tuple.
    """
    m = NAME_VERSION_RE.match(p)
    if not m:
        raise DistlibException('Ill-formed name/version string: \'%s\'' % p)
    d = m.groupdict()
    return d['name'].strip().lower(), d['ver']

def get_extras(requested, available):
    result = set()
    requested = set(requested or [])
    available = set(available or [])
    if '*' in requested:
        requested.remove('*')
        result |= available
    for r in requested:
        if r == '-':
            result.add(r)
        elif r.startswith('-'):
            unwanted = r[1:]
            if unwanted not in available:
                logger.warning('undeclared extra: %s' % unwanted)
            if unwanted in result:
                result.remove(unwanted)
        else:
            if r not in available:
                logger.warning('undeclared extra: %s' % r)
            result.add(r)
    return result
#
# Extended metadata functionality
#

def _get_external_data(url):
    result = {}
    try:
        # urlopen might fail if it runs into redirections,
        # because of Python issue #13696. Fixed in locators
        # using a custom redirect handler.
        resp = urlopen(url)
        headers = resp.info()
        ct = headers.get('Content-Type')
        if not ct.startswith('application/json'):
            logger.debug('Unexpected response for JSON request: %s', ct)
        else:
            reader = codecs.getreader('utf-8')(resp)
            #data = reader.read().decode('utf-8')
            #result = json.loads(data)
            result = json.load(reader)
    except Exception as e:
        logger.exception('Failed to get external data for %s: %s', url, e)
    return result

_external_data_base_url = 'https://www.red-dove.com/pypi/projects/'

def get_project_data(name):
    url = '%s/%s/project.json' % (name[0].upper(), name)
    url = urljoin(_external_data_base_url, url)
    result = _get_external_data(url)
    return result

def get_package_data(name, version):
    url = '%s/%s/package-%s.json' % (name[0].upper(), name, version)
    url = urljoin(_external_data_base_url, url)
    return _get_external_data(url)


class Cache(object):
    """
    A class implementing a cache for resources that need to live in the file system
    e.g. shared libraries. This class was moved from resources to here because it
    could be used by other modules, e.g. the wheel module.
    """

    def __init__(self, base):
        """
        Initialise an instance.

        :param base: The base directory where the cache should be located.
        """
        # we use 'isdir' instead of 'exists', because we want to
        # fail if there's a file with that name
        if not os.path.isdir(base):  # pragma: no cover
            os.makedirs(base)
        if (os.stat(base).st_mode & 0o77) != 0:
            logger.warning('Directory \'%s\' is not private', base)
        self.base = os.path.abspath(os.path.normpath(base))

    def prefix_to_dir(self, prefix):
        """
        Converts a resource prefix to a directory name in the cache.
        """
        return path_to_cache_dir(prefix)

    def clear(self):
        """
        Clear the cache.
        """
        not_removed = []
        for fn in os.listdir(self.base):
            fn = os.path.join(self.base, fn)
            try:
                if os.path.islink(fn) or os.path.isfile(fn):
                    os.remove(fn)
                elif os.path.isdir(fn):
                    shutil.rmtree(fn)
            except Exception:
                not_removed.append(fn)
        return not_removed


class EventMixin(object):
    """
    A very simple publish/subscribe system.
    """
    def __init__(self):
        self._subscribers = {}

    def add(self, event, subscriber, append=True):
        """
        Add a subscriber for an event.

        :param event: The name of an event.
        :param subscriber: The subscriber to be added (and called when the
                           event is published).
        :param append: Whether to append or prepend the subscriber to an
                       existing subscriber list for the event.
        """
        subs = self._subscribers
        if event not in subs:
            subs[event] = deque([subscriber])
        else:
            sq = subs[event]
            if append:
                sq.append(subscriber)
            else:
                sq.appendleft(subscriber)

    def remove(self, event, subscriber):
        """
        Remove a subscriber for an event.

        :param event: The name of an event.
        :param subscriber: The subscriber to be removed.
        """
        subs = self._subscribers
        if event not in subs:
            raise ValueError('No subscribers: %r' % event)
        subs[event].remove(subscriber)

    def get_subscribers(self, event):
        """
        Return an iterator for the subscribers for an event.
        :param event: The event to return subscribers for.
        """
        return iter(self._subscribers.get(event, ()))

    def publish(self, event, *args, **kwargs):
        """
        Publish a event and return a list of values returned by its
        subscribers.

        :param event: The event to publish.
        :param args: The positional arguments to pass to the event's
                     subscribers.
        :param kwargs: The keyword arguments to pass to the event's
                       subscribers.
        """
        result = []
        for subscriber in self.get_subscribers(event):
            try:
                value = subscriber(event, *args, **kwargs)
            except Exception:
                logger.exception('Exception during event publication')
                value = None
            result.append(value)
        logger.debug('publish %s: args = %s, kwargs = %s, result = %s',
                     event, args, kwargs, result)
        return result

#
# Simple sequencing
#
class Sequencer(object):
    def __init__(self):
        self._preds = {}
        self._succs = {}
        self._nodes = set()     # nodes with no preds/succs

    def add_node(self, node):
        self._nodes.add(node)

    def remove_node(self, node, edges=False):
        if node in self._nodes:
            self._nodes.remove(node)
        if edges:
            for p in set(self._preds.get(node, ())):
                self.remove(p, node)
            for s in set(self._succs.get(node, ())):
                self.remove(node, s)
            # Remove empties
            for k, v in list(self._preds.items()):
                if not v:
                    del self._preds[k]
            for k, v in list(self._succs.items()):
                if not v:
                    del self._succs[k]

    def add(self, pred, succ):
        assert pred != succ
        self._preds.setdefault(succ, set()).add(pred)
        self._succs.setdefault(pred, set()).add(succ)

    def remove(self, pred, succ):
        assert pred != succ
        try:
            preds = self._preds[succ]
            succs = self._succs[pred]
        except KeyError:  # pragma: no cover
            raise ValueError('%r not a successor of anything' % succ)
        try:
            preds.remove(pred)
            succs.remove(succ)
        except KeyError:  # pragma: no cover
            raise ValueError('%r not a successor of %r' % (succ, pred))

    def is_step(self, step):
        return (step in self._preds or step in self._succs or
                step in self._nodes)

    def get_steps(self, final):
        if not self.is_step(final):
            raise ValueError('Unknown: %r' % final)
        result = []
        todo = []
        seen = set()
        todo.append(final)
        while todo:
            step = todo.pop(0)
            if step in seen:
                # if a step was already seen,
                # move it to the end (so it will appear earlier
                # when reversed on return) ... but not for the
                # final step, as that would be confusing for
                # users
                if step != final:
                    result.remove(step)
                    result.append(step)
            else:
                seen.add(step)
                result.append(step)
                preds = self._preds.get(step, ())
                todo.extend(preds)
        return reversed(result)

    @property
    def strong_connections(self):
        #http://en.wikipedia.org/wiki/Tarjan%27s_strongly_connected_components_algorithm
        index_counter = [0]
        stack = []
        lowlinks = {}
        index = {}
        result = []

        graph = self._succs

        def strongconnect(node):
            # set the depth index for this node to the smallest unused index
            index[node] = index_counter[0]
            lowlinks[node] = index_counter[0]
            index_counter[0] += 1
            stack.append(node)

            # Consider successors
            try:
                successors = graph[node]
            except Exception:
                successors = []
            for successor in successors:
                if successor not in lowlinks:
                    # Successor has not yet been visited
                    strongconnect(successor)
                    lowlinks[node] = min(lowlinks[node],lowlinks[successor])
                elif successor in stack:
                    # the successor is in the stack and hence in the current
                    # strongly connected component (SCC)
                    lowlinks[node] = min(lowlinks[node],index[successor])

            # If `node` is a root node, pop the stack and generate an SCC
            if lowlinks[node] == index[node]:
                connected_component = []

                while True:
                    successor = stack.pop()
                    connected_component.append(successor)
                    if successor == node: break
                component = tuple(connected_component)
                # storing the result
                result.append(component)

        for node in graph:
            if node not in lowlinks:
                strongconnect(node)

        return result

    @property
    def dot(self):
        result = ['digraph G {']
        for succ in self._preds:
            preds = self._preds[succ]
            for pred in preds:
                result.append('  %s -> %s;' % (pred, succ))
        for node in self._nodes:
            result.append('  %s;' % node)
        result.append('}')
        return '\n'.join(result)

#
# Unarchiving functionality for zip, tar, tgz, tbz, whl
#

ARCHIVE_EXTENSIONS = ('.tar.gz', '.tar.bz2', '.tar', '.zip',
                      '.tgz', '.tbz', '.whl')

def unarchive(archive_filename, dest_dir, format=None, check=True):

    def check_path(path):
        if not isinstance(path, text_type):
            path = path.decode('utf-8')
        p = os.path.abspath(os.path.join(dest_dir, path))
        if not p.startswith(dest_dir) or p[plen] != os.sep:
            raise ValueError('path outside destination: %r' % p)

    dest_dir = os.path.abspath(dest_dir)
    plen = len(dest_dir)
    archive = None
    if format is None:
        if archive_filename.endswith(('.zip', '.whl')):
            format = 'zip'
        elif archive_filename.endswith(('.tar.gz', '.tgz')):
            format = 'tgz'
            mode = 'r:gz'
        elif archive_filename.endswith(('.tar.bz2', '.tbz')):
            format = 'tbz'
            mode = 'r:bz2'
        elif archive_filename.endswith('.tar'):
            format = 'tar'
            mode = 'r'
        else:  # pragma: no cover
            raise ValueError('Unknown format for %r' % archive_filename)
    try:
        if format == 'zip':
            archive = ZipFile(archive_filename, 'r')
            if check:
                names = archive.namelist()
                for name in names:
                    check_path(name)
        else:
            archive = tarfile.open(archive_filename, mode)
            if check:
                names = archive.getnames()
                for name in names:
                    check_path(name)
        if format != 'zip' and sys.version_info[0] < 3:
            # See Python issue 17153. If the dest path contains Unicode,
            # tarfile extraction fails on Python 2.x if a member path name
            # contains non-ASCII characters - it leads to an implicit
            # bytes -> unicode conversion using ASCII to decode.
            for tarinfo in archive.getmembers():
                if not isinstance(tarinfo.name, text_type):
                    tarinfo.name = tarinfo.name.decode('utf-8')

        # Limit extraction of dangerous items, if this Python
        # allows it easily. If not, just trust the input.
        # See: https://docs.python.org/3/library/tarfile.html#extraction-filters
        def extraction_filter(member, path):
            """Run tarfile.tar_fillter, but raise the expected ValueError"""
            # This is only called if the current Python has tarfile filters
            try:
                return tarfile.tar_filter(member, path)
            except tarfile.FilterError as exc:
                raise ValueError(str(exc))
        archive.extraction_filter = extraction_filter

        archive.extractall(dest_dir)

    finally:
        if archive:
            archive.close()


def zip_dir(directory):
    """zip a directory tree into a BytesIO object"""
    result = io.BytesIO()
    dlen = len(directory)
    with ZipFile(result, "w") as zf:
        for root, dirs, files in os.walk(directory):
            for name in files:
                full = os.path.join(root, name)
                rel = root[dlen:]
                dest = os.path.join(rel, name)
                zf.write(full, dest)
    return result

#
# Simple progress bar
#

UNITS = ('', 'K', 'M', 'G','T','P')


class Progress(object):
    unknown = 'UNKNOWN'

    def __init__(self, minval=0, maxval=100):
        assert maxval is None or maxval >= minval
        self.min = self.cur = minval
        self.max = maxval
        self.started = None
        self.elapsed = 0
        self.done = False

    def update(self, curval):
        assert self.min <= curval
        assert self.max is None or curval <= self.max
        self.cur = curval
        now = time.time()
        if self.started is None:
            self.started = now
        else:
            self.elapsed = now - self.started

    def increment(self, incr):
        assert incr >= 0
        self.update(self.cur + incr)

    def start(self):
        self.update(self.min)
        return self

    def stop(self):
        if self.max is not None:
            self.update(self.max)
        self.done = True

    @property
    def maximum(self):
        return self.unknown if self.max is None else self.max

    @property
    def percentage(self):
        if self.done:
            result = '100 %'
        elif self.max is None:
            result = ' ?? %'
        else:
            v = 100.0 * (self.cur - self.min) / (self.max - self.min)
            result = '%3d %%' % v
        return result

    def format_duration(self, duration):
        if (duration <= 0) and self.max is None or self.cur == self.min:
            result = '??:??:??'
        #elif duration < 1:
        #    result = '--:--:--'
        else:
            result = time.strftime('%H:%M:%S', time.gmtime(duration))
        return result

    @property
    def ETA(self):
        if self.done:
            prefix = 'Done'
            t = self.elapsed
            #import pdb; pdb.set_trace()
        else:
            prefix = 'ETA '
            if self.max is None:
                t = -1
            elif self.elapsed == 0 or (self.cur == self.min):
                t = 0
            else:
                #import pdb; pdb.set_trace()
                t = float(self.max - self.min)
                t /= self.cur - self.min
                t = (t - 1) * self.elapsed
        return '%s: %s' % (prefix, self.format_duration(t))

    @property
    def speed(self):
        if self.elapsed == 0:
            result = 0.0
        else:
            result = (self.cur - self.min) / self.elapsed
        for unit in UNITS:
            if result < 1000:
                break
            result /= 1000.0
        return '%d %sB/s' % (result, unit)

#
# Glob functionality
#

RICH_GLOB = re.compile(r'\{([^}]*)\}')
_CHECK_RECURSIVE_GLOB = re.compile(r'[^/\\,{]\*\*|\*\*[^/\\,}]')
_CHECK_MISMATCH_SET = re.compile(r'^[^{]*\}|\{[^}]*$')


def iglob(path_glob):
    """Extended globbing function that supports ** and {opt1,opt2,opt3}."""
    if _CHECK_RECURSIVE_GLOB.search(path_glob):
        msg = """invalid glob %r: recursive glob "**" must be used alone"""
        raise ValueError(msg % path_glob)
    if _CHECK_MISMATCH_SET.search(path_glob):
        msg = """invalid glob %r: mismatching set marker '{' or '}'"""
        raise ValueError(msg % path_glob)
    return _iglob(path_glob)


def _iglob(path_glob):
    rich_path_glob = RICH_GLOB.split(path_glob, 1)
    if len(rich_path_glob) > 1:
        assert len(rich_path_glob) == 3, rich_path_glob
        prefix, set, suffix = rich_path_glob
        for item in set.split(','):
            for path in _iglob(''.join((prefix, item, suffix))):
                yield path
    else:
        if '**' not in path_glob:
            for item in std_iglob(path_glob):
                yield item
        else:
            prefix, radical = path_glob.split('**', 1)
            if prefix == '':
                prefix = '.'
            if radical == '':
                radical = '*'
            else:
                # we support both
                radical = radical.lstrip('/')
                radical = radical.lstrip('\\')
            for path, dir, files in os.walk(prefix):
                path = os.path.normpath(path)
                for fn in _iglob(os.path.join(path, radical)):
                    yield fn

if ssl:
    from .compat import (HTTPSHandler as BaseHTTPSHandler, match_hostname,
                         CertificateError)


#
# HTTPSConnection which verifies certificates/matches domains
#

    class HTTPSConnection(httplib.HTTPSConnection):
        ca_certs = None # set this to the path to the certs file (.pem)
        check_domain = True # only used if ca_certs is not None

        # noinspection PyPropertyAccess
        def connect(self):
            sock = socket.create_connection((self.host, self.port), self.timeout)
            if getattr(self, '_tunnel_host', False):
                self.sock = sock
                self._tunnel()

            if not hasattr(ssl, 'SSLContext'):
                # For 2.x
                if self.ca_certs:
                    cert_reqs = ssl.CERT_REQUIRED
                else:
                    cert_reqs = ssl.CERT_NONE
                self.sock = ssl.wrap_socket(sock, self.key_file, self.cert_file,
                                            cert_reqs=cert_reqs,
                                            ssl_version=ssl.PROTOCOL_SSLv23,
                                            ca_certs=self.ca_certs)
            else:  # pragma: no cover
                context = ssl.SSLContext(ssl.PROTOCOL_SSLv23)
                context.options |= ssl.OP_NO_SSLv2
                if self.cert_file:
                    context.load_cert_chain(self.cert_file, self.key_file)
                kwargs = {}
                if self.ca_certs:
                    context.verify_mode = ssl.CERT_REQUIRED
                    context.load_verify_locations(cafile=self.ca_certs)
                    if getattr(ssl, 'HAS_SNI', False):
                        kwargs['server_hostname'] = self.host
                self.sock = context.wrap_socket(sock, **kwargs)
            if self.ca_certs and self.check_domain:
                try:
                    match_hostname(self.sock.getpeercert(), self.host)
                    logger.debug('Host verified: %s', self.host)
                except CertificateError:  # pragma: no cover
                    self.sock.shutdown(socket.SHUT_RDWR)
                    self.sock.close()
                    raise

    class HTTPSHandler(BaseHTTPSHandler):
        def __init__(self, ca_certs, check_domain=True):
            BaseHTTPSHandler.__init__(self)
            self.ca_certs = ca_certs
            self.check_domain = check_domain

        def _conn_maker(self, *args, **kwargs):
            """
            This is called to create a connection instance. Normally you'd
            pass a connection class to do_open, but it doesn't actually check for
            a class, and just expects a callable. As long as we behave just as a
            constructor would have, we should be OK. If it ever changes so that
            we *must* pass a class, we'll create an UnsafeHTTPSConnection class
            which just sets check_domain to False in the class definition, and
            choose which one to pass to do_open.
            """
            result = HTTPSConnection(*args, **kwargs)
            if self.ca_certs:
                result.ca_certs = self.ca_certs
                result.check_domain = self.check_domain
            return result

        def https_open(self, req):
            try:
                return self.do_open(self._conn_maker, req)
            except URLError as e:
                if 'certificate verify failed' in str(e.reason):
                    raise CertificateError('Unable to verify server certificate '
                                           'for %s' % req.host)
                else:
                    raise

    #
    # To prevent against mixing HTTP traffic with HTTPS (examples: A Man-In-The-
    # Middle proxy using HTTP listens on port 443, or an index mistakenly serves
    # HTML containing a http://xyz link when it should be https://xyz),
    # you can use the following handler class, which does not allow HTTP traffic.
    #
    # It works by inheriting from HTTPHandler - so build_opener won't add a
    # handler for HTTP itself.
    #
    class HTTPSOnlyHandler(HTTPSHandler, HTTPHandler):
        def http_open(self, req):
            raise URLError('Unexpected HTTP request on what should be a secure '
                           'connection: %s' % req)

#
# XML-RPC with timeouts
#

_ver_info = sys.version_info[:2]

if _ver_info == (2, 6):
    class HTTP(httplib.HTTP):
        def __init__(self, host='', port=None, **kwargs):
            if port == 0:   # 0 means use port 0, not the default port
                port = None
            self._setup(self._connection_class(host, port, **kwargs))


    if ssl:
        class HTTPS(httplib.HTTPS):
            def __init__(self, host='', port=None, **kwargs):
                if port == 0:   # 0 means use port 0, not the default port
                    port = None
                self._setup(self._connection_class(host, port, **kwargs))


class Transport(xmlrpclib.Transport):
    def __init__(self, timeout, use_datetime=0):
        self.timeout = timeout
        xmlrpclib.Transport.__init__(self, use_datetime)

    def make_connection(self, host):
        h, eh, x509 = self.get_host_info(host)
        if _ver_info == (2, 6):
            result = HTTP(h, timeout=self.timeout)
        else:
            if not self._connection or host != self._connection[0]:
                self._extra_headers = eh
                self._connection = host, httplib.HTTPConnection(h)
            result = self._connection[1]
        return result

if ssl:
    class SafeTransport(xmlrpclib.SafeTransport):
        def __init__(self, timeout, use_datetime=0):
            self.timeout = timeout
            xmlrpclib.SafeTransport.__init__(self, use_datetime)

        def make_connection(self, host):
            h, eh, kwargs = self.get_host_info(host)
            if not kwargs:
                kwargs = {}
            kwargs['timeout'] = self.timeout
            if _ver_info == (2, 6):
                result = HTTPS(host, None, **kwargs)
            else:
                if not self._connection or host != self._connection[0]:
                    self._extra_headers = eh
                    self._connection = host, httplib.HTTPSConnection(h, None,
                                                                     **kwargs)
                result = self._connection[1]
            return result


class ServerProxy(xmlrpclib.ServerProxy):
    def __init__(self, uri, **kwargs):
        self.timeout = timeout = kwargs.pop('timeout', None)
        # The above classes only come into play if a timeout
        # is specified
        if timeout is not None:
            scheme, _ = splittype(uri)
            use_datetime = kwargs.get('use_datetime', 0)
            if scheme == 'https':
                tcls = SafeTransport
            else:
                tcls = Transport
            kwargs['transport'] = t = tcls(timeout, use_datetime=use_datetime)
            self.transport = t
        xmlrpclib.ServerProxy.__init__(self, uri, **kwargs)

#
# CSV functionality. This is provided because on 2.x, the csv module can't
# handle Unicode. However, we need to deal with Unicode in e.g. RECORD files.
#

def _csv_open(fn, mode, **kwargs):
    if sys.version_info[0] < 3:
        mode += 'b'
    else:
        kwargs['newline'] = ''
        # Python 3 determines encoding from locale. Force 'utf-8'
        # file encoding to match other forced utf-8 encoding
        kwargs['encoding'] = 'utf-8'
    return open(fn, mode, **kwargs)


class CSVBase(object):
    defaults = {
        'delimiter': str(','),      # The strs are used because we need native
        'quotechar': str('"'),      # str in the csv API (2.x won't take
        'lineterminator': str('\n') # Unicode)
    }

    def __enter__(self):
        return self

    def __exit__(self, *exc_info):
        self.stream.close()


class CSVReader(CSVBase):
    def __init__(self, **kwargs):
        if 'stream' in kwargs:
            stream = kwargs['stream']
            if sys.version_info[0] >= 3:
                # needs to be a text stream
                stream = codecs.getreader('utf-8')(stream)
            self.stream = stream
        else:
            self.stream = _csv_open(kwargs['path'], 'r')
        self.reader = csv.reader(self.stream, **self.defaults)

    def __iter__(self):
        return self

    def next(self):
        result = next(self.reader)
        if sys.version_info[0] < 3:
            for i, item in enumerate(result):
                if not isinstance(item, text_type):
                    result[i] = item.decode('utf-8')
        return result

    __next__ = next

class CSVWriter(CSVBase):
    def __init__(self, fn, **kwargs):
        self.stream = _csv_open(fn, 'w')
        self.writer = csv.writer(self.stream, **self.defaults)

    def writerow(self, row):
        if sys.version_info[0] < 3:
            r = []
            for item in row:
                if isinstance(item, text_type):
                    item = item.encode('utf-8')
                r.append(item)
            row = r
        self.writer.writerow(row)

#
#   Configurator functionality
#

class Configurator(BaseConfigurator):

    value_converters = dict(BaseConfigurator.value_converters)
    value_converters['inc'] = 'inc_convert'

    def __init__(self, config, base=None):
        super(Configurator, self).__init__(config)
        self.base = base or os.getcwd()

    def configure_custom(self, config):
        def convert(o):
            if isinstance(o, (list, tuple)):
                result = type(o)([convert(i) for i in o])
            elif isinstance(o, dict):
                if '()' in o:
                    result = self.configure_custom(o)
                else:
                    result = {}
                    for k in o:
                        result[k] = convert(o[k])
            else:
                result = self.convert(o)
            return result

        c = config.pop('()')
        if not callable(c):
            c = self.resolve(c)
        props = config.pop('.', None)
        # Check for valid identifiers
        args = config.pop('[]', ())
        if args:
            args = tuple([convert(o) for o in args])
        items = [(k, convert(config[k])) for k in config if valid_ident(k)]
        kwargs = dict(items)
        result = c(*args, **kwargs)
        if props:
            for n, v in props.items():
                setattr(result, n, convert(v))
        return result

    def __getitem__(self, key):
        result = self.config[key]
        if isinstance(result, dict) and '()' in result:
            self.config[key] = result = self.configure_custom(result)
        return result

    def inc_convert(self, value):
        """Default converter for the inc:// protocol."""
        if not os.path.isabs(value):
            value = os.path.join(self.base, value)
        with codecs.open(value, 'r', encoding='utf-8') as f:
            result = json.load(f)
        return result


class SubprocessMixin(object):
    """
    Mixin for running subprocesses and capturing their output
    """
    def __init__(self, verbose=False, progress=None):
        self.verbose = verbose
        self.progress = progress

    def reader(self, stream, context):
        """
        Read lines from a subprocess' output stream and either pass to a progress
        callable (if specified) or write progress information to sys.stderr.
        """
        progress = self.progress
        verbose = self.verbose
        while True:
            s = stream.readline()
            if not s:
                break
            if progress is not None:
                progress(s, context)
            else:
                if not verbose:
                    sys.stderr.write('.')
                else:
                    sys.stderr.write(s.decode('utf-8'))
                sys.stderr.flush()
        stream.close()

    def run_command(self, cmd, **kwargs):
        p = subprocess.Popen(cmd, stdout=subprocess.PIPE,
                             stderr=subprocess.PIPE, **kwargs)
        t1 = threading.Thread(target=self.reader, args=(p.stdout, 'stdout'))
        t1.start()
        t2 = threading.Thread(target=self.reader, args=(p.stderr, 'stderr'))
        t2.start()
        p.wait()
        t1.join()
        t2.join()
        if self.progress is not None:
            self.progress('done.', 'main')
        elif self.verbose:
            sys.stderr.write('done.\n')
        return p


def normalize_name(name):
    """Normalize a python package name a la PEP 503"""
    # https://www.python.org/dev/peps/pep-0503/#normalized-names
    return re.sub('[-_.]+', '-', name).lower()
site-packages/pip/_vendor/distlib/_backport/sysconfig.cfg000064400000005071151446177000017603 0ustar00[posix_prefix]
# Configuration directories.  Some of these come straight out of the
# configure script.  They are for implementing the other variables, not to
# be used directly in [resource_locations].
confdir = /etc
datadir = /usr/share
libdir = /usr/lib
statedir = /var
# User resource directory
local = ~/.local/{distribution.name}

stdlib = {base}/lib/python{py_version_short}
platstdlib = {platbase}/lib/python{py_version_short}
purelib = {base}/lib/python{py_version_short}/site-packages
platlib = {platbase}/lib/python{py_version_short}/site-packages
include = {base}/include/python{py_version_short}{abiflags}
platinclude = {platbase}/include/python{py_version_short}{abiflags}
data = {base}

[posix_home]
stdlib = {base}/lib/python
platstdlib = {base}/lib/python
purelib = {base}/lib/python
platlib = {base}/lib/python
include = {base}/include/python
platinclude = {base}/include/python
scripts = {base}/bin
data = {base}

[nt]
stdlib = {base}/Lib
platstdlib = {base}/Lib
purelib = {base}/Lib/site-packages
platlib = {base}/Lib/site-packages
include = {base}/Include
platinclude = {base}/Include
scripts = {base}/Scripts
data = {base}

[os2]
stdlib = {base}/Lib
platstdlib = {base}/Lib
purelib = {base}/Lib/site-packages
platlib = {base}/Lib/site-packages
include = {base}/Include
platinclude = {base}/Include
scripts = {base}/Scripts
data = {base}

[os2_home]
stdlib = {userbase}/lib/python{py_version_short}
platstdlib = {userbase}/lib/python{py_version_short}
purelib = {userbase}/lib/python{py_version_short}/site-packages
platlib = {userbase}/lib/python{py_version_short}/site-packages
include = {userbase}/include/python{py_version_short}
scripts = {userbase}/bin
data = {userbase}

[nt_user]
stdlib = {userbase}/Python{py_version_nodot}
platstdlib = {userbase}/Python{py_version_nodot}
purelib = {userbase}/Python{py_version_nodot}/site-packages
platlib = {userbase}/Python{py_version_nodot}/site-packages
include = {userbase}/Python{py_version_nodot}/Include
scripts = {userbase}/Scripts
data = {userbase}

[posix_user]
stdlib = {userbase}/lib/python{py_version_short}
platstdlib = {userbase}/lib/python{py_version_short}
purelib = {userbase}/lib/python{py_version_short}/site-packages
platlib = {userbase}/lib/python{py_version_short}/site-packages
include = {userbase}/include/python{py_version_short}
scripts = {userbase}/bin
data = {userbase}

[osx_framework_user]
stdlib = {userbase}/lib/python
platstdlib = {userbase}/lib/python
purelib = {userbase}/lib/python/site-packages
platlib = {userbase}/lib/python/site-packages
include = {userbase}/include
scripts = {userbase}/bin
data = {userbase}
site-packages/pip/_vendor/distlib/_backport/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000677151446177000024463 0ustar00U

��.e�@sdZdS)aModules copied from Python 3 standard libraries, for internal use only.

Individual classes and functions are found in d2._backport.misc.  Intended
usage is to always import things missing from 3.1 from that module: the
built-in/stdlib objects will be used if found.
N)�__doc__�rr�J/usr/lib/python3.8/site-packages/pip/_vendor/distlib/_backport/__init__.py�<module>�site-packages/pip/_vendor/distlib/_backport/__pycache__/sysconfig.cpython-38.opt-1.pyc000064400000036666151446177000024737 0ustar00U

��.eTi�@s�dZddlZddlZddlZddlZddlmZmZzddlZWne	k
r\ddl
ZYnXdddddd	d
ddd
dgZdd�Zej
r�ej�eej
��Znee���Zejdkr�dedd���kr�eej�ee��Zejdk�rdedd���k�reej�eee��Zejdk�rBdedd���k�rBeej�eee��Zdd�Ze�Zdadd�Ze��Ze�d�Zdd�Zej��dZ ejdd �Z!e de d!Z"ej�#ej$�Z%ej�#ej&�Z'da(dZ)d"d#�Z*d$d%�Z+d&d'�Z,d(d)�Z-d*d+�Z.d,d-�Z/dEd.d/�Z0d0d�Z1d1d2�Z2d3d4�Z3dFd5d�Z4d6d�Z5d7d
�Z6d8d	�Z7e.�dd9fd:d
�Z8e.�dd9fd;d�Z9d<d�Z:d=d�Z;d>d�Z<d?d�Z=d@dA�Z>dBdC�Z?e@dDk�r�e?�dS)Gz-Access to Python's configuration information.�N)�pardir�realpath�get_config_h_filename�get_config_var�get_config_vars�get_makefile_filename�get_path�get_path_names�	get_paths�get_platform�get_python_version�get_scheme_names�parse_config_hcCs(z
t|�WStk
r"|YSXdS�N)r�OSError)�path�r�K/usr/lib/python3.8/site-packages/pip/_vendor/distlib/_backport/sysconfig.py�_safe_realpath"s
r�ntZpcbuildi����z\pc\vi����z\pcbuild\amd64i�cCs,dD]"}tj�tj�td|��rdSqdS)N)z
Setup.distzSetup.localZModulesTF)�osr�isfile�join�
_PROJECT_BASE)�fnrrr�is_python_build:srFc	Cs�ts~ddlm}t�dd�d}||�}|�d�}|���}t�|�W5QRXt	rzdD] }t�
|dd	�t�
|d
d�qXdadS)
N�)�finder�.�rz
sysconfig.cfg)�posix_prefixZ
posix_home�includez{srcdir}/Include�platincludez{projectbase}/.T)�	_cfg_readZ	resourcesr�__name__�rsplit�findZ	as_stream�_SCHEMESZreadfp�
_PYTHON_BUILD�set)rZbackport_packageZ_finderZ_cfgfile�s�schemerrr�_ensure_cfg_readDs

r,z\{([^{]*?)\}c
s�t�|�d�r|�d�}nt�}|��}|D]8}|dkr<q.|D]$\}}|�||�rVq@|�|||�q@q.|�d�|��D]H}t|�|����fdd�}|�|�D]\}}|�||t	�
||��q�qzdS)N�globalscs$|�d�}|�kr�|S|�d�S�Nrr��group�Zmatchobj�name��	variablesrr�	_replaceros
z"_expand_globals.<locals>._replacer)r,Zhas_section�items�tuple�sectionsZ
has_optionr)Zremove_section�dict�	_VAR_REPL�sub)�configr-r8ZsectionZoption�valuer5rr3r�_expand_globalsYs$

r>�rcs�fdd�}t�||�S)z�In the string `path`, replace tokens like {some.thing} with the
    corresponding value from the map `local_vars`.

    If there is no corresponding value, leave the token unchanged.
    cs8|�d�}|�kr�|S|tjkr.tj|S|�d�Sr.)r0r�environr1��
local_varsrrr5�s


z_subst_vars.<locals>._replacer�r:r;)rrBr5rrAr�_subst_vars�srDcCs0|��}|��D]\}}||kr"q|||<qdSr)�keysr6)Ztarget_dictZ
other_dictZtarget_keys�keyr=rrr�_extend_dict�s
rGcCs`i}|dkri}t|t��t�|�D]4\}}tjdkrDtj�|�}tj�t	||��||<q&|S)N)�posixr)
rGrr'r6rr2r�
expanduser�normpathrD)r+�vars�resrFr=rrr�_expand_vars�s
rMcs�fdd�}t�||�S)Ncs$|�d�}|�kr�|S|�d�Sr.r/r1�rKrrr5�s
zformat_value.<locals>._replacerrC)r=rKr5rrNr�format_value�srOcCstjdkrdStjS)NrHr )rr2rrrr�_get_default_scheme�s
rPcCs�tj�dd�}dd�}tjdkrBtj�d�p.d}|r8|S||d�Stjdkr|td	�}|r||r`|S|dd
|dtjdd��S|r�|S|dd
�SdS)N�PYTHONUSERBASEcWstj�tjj|��Sr)rrrIr)�argsrrr�joinuser�sz_getuserbase.<locals>.joinuserr�APPDATA�~�Python�darwinZPYTHONFRAMEWORK�Libraryz%d.%drz.local)rr@�getr2�sys�platformr�version_info)�env_baserS�baseZ	frameworkrrr�_getuserbase�s$



�r_c	Cst�d�}t�d�}t�d�}|dkr*i}i}i}tj|ddd��}|��}W5QRX|D]�}	|	�d�sZ|	��d	krvqZ|�|	�}
|
rZ|
�d
d�\}}|��}|�	dd	�}
d
|
kr�|||<qZzt
|�}Wn$tk
r�|�	dd
�||<YqZX|||<qZt|�
��}d}t|�dk�r�t|�D�]�}||}|�|��p>|�|�}
|
dk	�r�|
�d
�}d}||k�rpt||�}n�||k�r�d}nx|tjk�r�tj|}n`||k�r�|�d��r�|dd�|k�r�d	}n$d||k�r�d}nt|d|�}nd	||<}|�r�||
��d�}|d|
���||}d
|k�r:|||<n~zt
|�}Wn"tk
�rh|��||<Yn
X|||<|�|�|�d��r�|dd�|k�r�|dd�}||k�r�|||<n|||<|�|��q�q|��D]"\}}t|t��r�|��||<�q�|�|�|S)z�Parse a Makefile-style file.

    A dictionary containing name/value pairs is returned.  If an
    optional dictionary is passed in as the second argument, it is
    used instead of a new dictionary.
    z"([a-zA-Z][a-zA-Z0-9_]+)\s*=\s*(.*)z\$\(([A-Za-z][A-Za-z0-9_]*)\)z\${([A-Za-z][A-Za-z0-9_]*)}Nzutf-8�surrogateescape)�encoding�errors�#�rrz$$�$)�CFLAGS�LDFLAGSZCPPFLAGSrTFZPY_r?)�re�compile�codecs�open�	readlines�
startswith�strip�matchr0�replace�int�
ValueError�listrE�lenr7�search�strrr@�end�start�remover6�
isinstance�update)�filenamerKZ_variable_rxZ_findvar1_rxZ_findvar2_rxZdoneZnotdone�f�lines�line�m�n�vZtmpvr4Zrenamed_variablesr2r=�found�itemZafter�krrr�_parse_makefile�s�	










�


�


r�cCsDtrtj�td�Sttd�r,dttjf}nd}tj�t	d�|d�S)z Return the path of the Makefile.ZMakefile�abiflagszconfig-%s%sr<�stdlib)
r(rrrr�hasattrrZ�_PY_VERSION_SHORTr�r)Zconfig_dir_namerrrrMs
c
Cs�t�}zt||�WnJtk
r^}z,d|}t|d�rF|d|j}t|��W5d}~XYnXt�}z"t|��}t||�W5QRXWnJtk
r�}z,d|}t|d�r�|d|j}t|��W5d}~XYnXtr�|d|d<dS)z7Initialize the module as appropriate for POSIX systems.z.invalid Python installation: unable to open %s�strerrorz (%s)N�	BLDSHAREDZLDSHARED)	rr��IOErrorr�r�rrkrr()rKZmakefile�e�msgZconfig_hr}rrr�_init_posixXs&


r�cCsVtd�|d<td�|d<td�|d<d|d<d	|d
<t|d<tj�ttj��|d<d
S)z+Initialize the module as appropriate for NTr�ZLIBDESTZ
platstdlibZ
BINLIBDESTr!Z	INCLUDEPYz.pydZSOz.exeZEXEZVERSIONZBINDIRN)r�_PY_VERSION_SHORT_NO_DOTrr�dirnamerrZ�
executablerNrrr�_init_non_posixtsr�cCs�|dkri}t�d�}t�d�}|��}|s.q�|�|�}|rx|�dd�\}}zt|�}Wntk
rlYnX|||<q |�|�}|r d||�d�<q |S)z�Parse a config.h-style file.

    A dictionary containing name/value pairs is returned.  If an
    optional dictionary is passed in as the second argument, it is
    used instead of a new dictionary.
    Nz"#define ([A-Z][A-Za-z0-9_]+) (.*)
z&/[*] #undef ([A-Z][A-Za-z0-9_]+) [*]/
rrr)rhri�readlineror0rqrr)�fprKZ	define_rxZundef_rxrr�r�r�rrrr�s&




cCs:tr$tjdkrtj�td�}q,t}ntd�}tj�|d�S)zReturn the path of pyconfig.h.rZPCr"z
pyconfig.h)r(rr2rrrr)Zinc_dirrrrr�s
cCsttt����S)z,Return a tuple containing the schemes names.)r7�sortedr'r8rrrrr
�scCs
t�d�S)z*Return a tuple containing the paths names.r )r'Zoptionsrrrrr	�sTcCs&t�|rt||�Stt�|��SdS)z�Return a mapping containing an install scheme.

    ``scheme`` is the install scheme name. If not provided, it will
    return the default scheme for the current platform.
    N)r,rMr9r'r6)r+rK�expandrrrr
�s
cCst|||�|S)z[Return a path corresponding to the scheme.

    ``scheme`` is the install scheme name.
    )r
)r2r+rKr�rrrr�scGs�tdk�rziattd<ttd<ttd<ttd<tdtdtd<ttd	<ttd
<ttd<ztjtd<Wntk
r�d
td<YnXt	j
dkr�tt�t	j
dkr�tt�tj
dkr�t�td<dtkr�ttd<nttd�td<t�r\t	j
dk�r\t}zt	��}Wntk
�rd}YnXt	j�td��s\||k�r\t	j�|td�}t	j�|�td<tjdk�rzt	��d}t|�d�d�}|dk�r�dD]2}t|}t�dd|�}t�dd|�}|t|<�q�n�dt	jk�rt	jd}dD]0}t|}t�dd|�}|d|}|t|<�q�t�dd
�}	t�d|	�}
|
dk	�rz|
� d�}t	j�!|��szdD]$}t|}t�dd|�}|t|<�qT|�r�g}|D]}
|�"t�|
���q�|StSdS)ayWith no arguments, return a dictionary of all configuration
    variables relevant for the current platform.

    On Unix, this means every variable defined in Python's installed Makefile;
    On Windows and Mac OS it's a much smaller set.

    With arguments, return a list of values that result from looking up
    each argument in the configuration variable dictionary.
    N�prefix�exec_prefixZ
py_versionZpy_version_shortrrZpy_version_nodotr^ZplatbaseZprojectbaser�rd)rZos2rHz2.6�userbase�srcdirrWr�)rgZ
BASECFLAGSrfZ	PY_CFLAGSr�z
-arch\s+\w+\s� z-isysroot [^ 	]*Z	ARCHFLAGSrfz-isysroot\s+(\S+)rz-isysroot\s+\S+(\s|$))#�_CONFIG_VARS�_PREFIX�_EXEC_PREFIX�_PY_VERSIONr�rrZr��AttributeErrorrr2r�r��versionr_rr(�getcwdrr�isabsrrJr[�unamerq�splitrhr;r@rYrur0�exists�append)rRr^�cwdr�Zkernel_versionZ
major_versionrF�flagsZarchrfr�ZsdkZvalsr2rrrr�s�






�



cCst��|�S)z�Return the value of a single variable using the dictionary returned by
    'get_config_vars()'.

    Equivalent to get_config_vars().get(name)
    )rrY)r2rrrrRscCs^tjdkrnd}tj�|�}|dkr(tjStj�d|�}tj|t|�|���}|dkr\dS|dkrhdStjStjd	ks�ttd
�s�tjSt�	�\}}}}}|���
dd�}|�
d
d�}|�
dd�}|dd�dkr�d||fS|dd�dk�r&|ddk�rPd}dt|d�d|dd�f}�n*|dd�dk�rDd||fS|dd�dk�rdd|||fS|dd�d k�r�d }t�
d!�}	|	�|�}
|
�rP|
��}�n�|dd�d"k�rPt�}|�d#�}|}
ztd$�}Wntk
�r�YnJXzt�d%|���}
W5|��X|
dk	�r2d&�|
�d'��d&�dd��}
|�s<|
}|�rP|}d(}|
d&d)k�rd*t��d+d���k�rd,}t��d+�}t�d-|�}ttt|���}t|�d'k�r�|d}n^|d.k�r�d,}nN|d/k�r�d0}n>|d1k�r�d2}n.|d3k�r�d4}n|d5k�rd6}ntd7|f��n<|d8k�r0tjd9k�rPd:}n |d;k�rPtjd9k�rLd<}nd=}d>|||fS)?a�Return a string that identifies the current platform.

    This is used mainly to distinguish platform-specific build directories and
    platform-specific built distributions.  Typically includes the OS name
    and version and the architecture (as supplied by 'os.uname()'),
    although the exact information included depends on the OS; eg. for IRIX
    the architecture isn't particularly important (IRIX only runs on SGI
    hardware), but for Linux the kernel version isn't particularly
    important.

    Examples of returned values:
       linux-i586
       linux-alpha (?)
       solaris-2.6-sun4u
       irix-5.3
       irix64-6.2

    Windows will return one of:
       win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc)
       win-ia64 (64bit Windows on Itanium)
       win32 (all others - specifically, sys.platform is returned)

    For other non-POSIX platforms, currently just returns 'sys.platform'.
    rz bit (����)Zamd64z	win-amd64Zitaniumzwin-ia64rHr��/rdr��_�-N�Zlinuxz%s-%sZsunosr�5Zsolarisz%d.%sr?r�ZirixZaixz%s-%s.%s��cygwinz[\d.]+rWZMACOSX_DEPLOYMENT_TARGETz0/System/Library/CoreServices/SystemVersion.plistz=<key>ProductUserVisibleVersion</key>\s*<string>(.*?)</string>rrZmacosxz10.4.z-archrfZfatz
-arch\s+(\S+))�i386�ppc)r��x86_64Zintel)r�r�r�Zfat3)�ppc64r�Zfat64)r�r�r�r�Z	universalz%Don't know machine value for archs=%rr�lr�)ZPowerPCZPower_Macintoshr�r�z%s-%s-%s) rr2rZr�r&r[rt�lowerr�r�rprqrhriror0rrYrkr��closeru�readrr�rn�findallr7r�r)rr�maxsize)r��i�jZlookZosnameZhost�releaser��machineZrel_rer�ZcfgvarsZmacverZ
macreleaser}ZcflagsZarchsrrrr[s�
$


�

�





�

cCstSr)r�rrrrr�scCsFtt|����D]0\}\}}|dkr0td|�td||f�qdS)Nrz%s: z
	%s = "%s")�	enumerater�r6�print)�title�data�indexrFr=rrr�_print_dictsr�cCsRtdt��tdt��tdt��t�tdt��t�tdt��dS)z*Display all information sysconfig detains.zPlatform: "%s"zPython version: "%s"z!Current installation scheme: "%s"ZPathsZ	VariablesN)r�rrrPr�r
rrrrr�_mainsr��__main__)N)N)A�__doc__rjrrhrZZos.pathrrZconfigparser�ImportErrorZConfigParser�__all__rr�rr�rr�r2r�rrr(r#r,ZRawConfigParserr'rir:r>r�r�r�r�r�rJr�r�r�r�r�Z
_USER_BASErDrGrMrOrPr_r�rr�r�rrr
r	r
rrrrrr�r�r$rrrr�<module>s��""
#
	
v

	#
site-packages/pip/_vendor/distlib/_backport/__pycache__/sysconfig.cpython-38.pyc000064400000036752151446177000023774 0ustar00U

��.eTi�@s�dZddlZddlZddlZddlZddlmZmZzddlZWne	k
r\ddl
ZYnXdddddd	d
ddd
dgZdd�Zej
r�ej�eej
��Znee���Zejdkr�dedd���kr�eej�ee��Zejdk�rdedd���k�reej�eee��Zejdk�rBdedd���k�rBeej�eee��Zdd�Ze�Zdadd�Ze��Ze�d�Zdd�Zej��dZ ejdd �Z!e de d!Z"ej�#ej$�Z%ej�#ej&�Z'da(dZ)d"d#�Z*d$d%�Z+d&d'�Z,d(d)�Z-d*d+�Z.d,d-�Z/dEd.d/�Z0d0d�Z1d1d2�Z2d3d4�Z3dFd5d�Z4d6d�Z5d7d
�Z6d8d	�Z7e.�dd9fd:d
�Z8e.�dd9fd;d�Z9d<d�Z:d=d�Z;d>d�Z<d?d�Z=d@dA�Z>dBdC�Z?e@dDk�r�e?�dS)Gz-Access to Python's configuration information.�N)�pardir�realpath�get_config_h_filename�get_config_var�get_config_vars�get_makefile_filename�get_path�get_path_names�	get_paths�get_platform�get_python_version�get_scheme_names�parse_config_hcCs(z
t|�WStk
r"|YSXdS�N)r�OSError)�path�r�K/usr/lib/python3.8/site-packages/pip/_vendor/distlib/_backport/sysconfig.py�_safe_realpath"s
r�ntZpcbuildi����z\pc\vi����z\pcbuild\amd64i�cCs,dD]"}tj�tj�td|��rdSqdS)N)z
Setup.distzSetup.localZModulesTF)�osr�isfile�join�
_PROJECT_BASE)�fnrrr�is_python_build:srFc	Cs�ts�ddlm}t�dd�d}||�}|�d�}|s>td��|���}t�	|�W5QRXt
r�dD] }t�|d	d
�t�|dd�qdd
adS)N�)�finder�.�rz
sysconfig.cfgzsysconfig.cfg exists)�posix_prefixZ
posix_home�includez{srcdir}/Include�platincludez{projectbase}/.T)�	_cfg_readZ	resourcesr�__name__�rsplit�find�AssertionErrorZ	as_stream�_SCHEMESZreadfp�
_PYTHON_BUILD�set)rZbackport_packageZ_finderZ_cfgfile�s�schemerrr�_ensure_cfg_readDs

r-z\{([^{]*?)\}c
s�t�|�d�r|�d�}nt�}|��}|D]8}|dkr<q.|D]$\}}|�||�rVq@|�|||�q@q.|�d�|��D]H}t|�|����fdd�}|�|�D]\}}|�||t	�
||��q�qzdS)N�globalscs$|�d�}|�kr�|S|�d�S�Nrr��group�Zmatchobj�name��	variablesrr�	_replaceros
z"_expand_globals.<locals>._replacer)r-Zhas_section�items�tuple�sectionsZ
has_optionr*Zremove_section�dict�	_VAR_REPL�sub)�configr.r9ZsectionZoption�valuer6rr4r�_expand_globalsYs$

r?�rcs�fdd�}t�||�S)z�In the string `path`, replace tokens like {some.thing} with the
    corresponding value from the map `local_vars`.

    If there is no corresponding value, leave the token unchanged.
    cs8|�d�}|�kr�|S|tjkr.tj|S|�d�Sr/)r1r�environr2��
local_varsrrr6�s


z_subst_vars.<locals>._replacer�r;r<)rrCr6rrBr�_subst_vars�srEcCs0|��}|��D]\}}||kr"q|||<qdSr)�keysr7)Ztarget_dictZ
other_dictZtarget_keys�keyr>rrr�_extend_dict�s
rHcCs`i}|dkri}t|t��t�|�D]4\}}tjdkrDtj�|�}tj�t	||��||<q&|S)N)�posixr)
rHrr(r7rr3r�
expanduser�normpathrE)r,�vars�resrGr>rrr�_expand_vars�s
rNcs�fdd�}t�||�S)Ncs$|�d�}|�kr�|S|�d�Sr/r0r2�rLrrr6�s
zformat_value.<locals>._replacerrD)r>rLr6rrOr�format_value�srPcCstjdkrdStjS)NrIr )rr3rrrr�_get_default_scheme�s
rQcCs�tj�dd�}dd�}tjdkrBtj�d�p.d}|r8|S||d�Stjdkr|td	�}|r||r`|S|dd
|dtjdd��S|r�|S|dd
�SdS)N�PYTHONUSERBASEcWstj�tjj|��Sr)rrrJr)�argsrrr�joinuser�sz_getuserbase.<locals>.joinuserr�APPDATA�~�Python�darwinZPYTHONFRAMEWORK�Libraryz%d.%drz.local)rrA�getr3�sys�platformr�version_info)�env_baserT�baseZ	frameworkrrr�_getuserbase�s$



�r`c	Cst�d�}t�d�}t�d�}|dkr*i}i}i}tj|ddd��}|��}W5QRX|D]�}	|	�d�sZ|	��d	krvqZ|�|	�}
|
rZ|
�d
d�\}}|��}|�	dd	�}
d
|
kr�|||<qZzt
|�}Wn$tk
r�|�	dd
�||<YqZX|||<qZt|�
��}d}t|�dk�r�t|�D�]�}||}|�|��p>|�|�}
|
dk	�r�|
�d
�}d}||k�rpt||�}n�||k�r�d}nx|tjk�r�tj|}n`||k�r�|�d��r�|dd�|k�r�d	}n$d||k�r�d}nt|d|�}nd	||<}|�r�||
��d�}|d|
���||}d
|k�r:|||<n~zt
|�}Wn"tk
�rh|��||<Yn
X|||<|�|�|�d��r�|dd�|k�r�|dd�}||k�r�|||<n|||<|�|��q�q|��D]"\}}t|t��r�|��||<�q�|�|�|S)z�Parse a Makefile-style file.

    A dictionary containing name/value pairs is returned.  If an
    optional dictionary is passed in as the second argument, it is
    used instead of a new dictionary.
    z"([a-zA-Z][a-zA-Z0-9_]+)\s*=\s*(.*)z\$\(([A-Za-z][A-Za-z0-9_]*)\)z\${([A-Za-z][A-Za-z0-9_]*)}Nzutf-8�surrogateescape)�encoding�errors�#�rrz$$�$)�CFLAGS�LDFLAGSZCPPFLAGSrTFZPY_r@)�re�compile�codecs�open�	readlines�
startswith�strip�matchr1�replace�int�
ValueError�listrF�lenr8�search�strrrA�end�start�remover7�
isinstance�update)�filenamerLZ_variable_rxZ_findvar1_rxZ_findvar2_rxZdoneZnotdone�f�lines�line�m�n�vZtmpvr5Zrenamed_variablesr3r>�found�itemZafter�krrr�_parse_makefile�s�	










�


�


r�cCsDtrtj�td�Sttd�r,dttjf}nd}tj�t	d�|d�S)z Return the path of the Makefile.ZMakefile�abiflagszconfig-%s%sr=�stdlib)
r)rrrr�hasattrr[�_PY_VERSION_SHORTr�r)Zconfig_dir_namerrrrMs
c
Cs�t�}zt||�WnJtk
r^}z,d|}t|d�rF|d|j}t|��W5d}~XYnXt�}z"t|��}t||�W5QRXWnJtk
r�}z,d|}t|d�r�|d|j}t|��W5d}~XYnXtr�|d|d<dS)z7Initialize the module as appropriate for POSIX systems.z.invalid Python installation: unable to open %s�strerrorz (%s)N�	BLDSHAREDZLDSHARED)	rr��IOErrorr�r�rrlrr))rLZmakefile�e�msgZconfig_hr~rrr�_init_posixXs&


r�cCsVtd�|d<td�|d<td�|d<d|d<d	|d
<t|d<tj�ttj��|d<d
S)z+Initialize the module as appropriate for NTr�ZLIBDESTZ
platstdlibZ
BINLIBDESTr!Z	INCLUDEPYz.pydZSOz.exeZEXEZVERSIONZBINDIRN)r�_PY_VERSION_SHORT_NO_DOTrr�dirnamerr[�
executablerOrrr�_init_non_posixtsr�cCs�|dkri}t�d�}t�d�}|��}|s.q�|�|�}|rx|�dd�\}}zt|�}Wntk
rlYnX|||<q |�|�}|r d||�d�<q |S)z�Parse a config.h-style file.

    A dictionary containing name/value pairs is returned.  If an
    optional dictionary is passed in as the second argument, it is
    used instead of a new dictionary.
    Nz"#define ([A-Z][A-Za-z0-9_]+) (.*)
z&/[*] #undef ([A-Z][A-Za-z0-9_]+) [*]/
rrr)rirj�readlinerpr1rrrs)�fprLZ	define_rxZundef_rxr�r�r�r�rrrr�s&




cCs:tr$tjdkrtj�td�}q,t}ntd�}tj�|d�S)zReturn the path of pyconfig.h.rZPCr"z
pyconfig.h)r)rr3rrrr)Zinc_dirrrrr�s
cCsttt����S)z,Return a tuple containing the schemes names.)r8�sortedr(r9rrrrr
�scCs
t�d�S)z*Return a tuple containing the paths names.r )r(Zoptionsrrrrr	�sTcCs&t�|rt||�Stt�|��SdS)z�Return a mapping containing an install scheme.

    ``scheme`` is the install scheme name. If not provided, it will
    return the default scheme for the current platform.
    N)r-rNr:r(r7)r,rL�expandrrrr
�s
cCst|||�|S)z[Return a path corresponding to the scheme.

    ``scheme`` is the install scheme name.
    )r
)r3r,rLr�rrrr�scGs�tdk�rziattd<ttd<ttd<ttd<tdtdtd<ttd	<ttd
<ttd<ztjtd<Wntk
r�d
td<YnXt	j
dkr�tt�t	j
dkr�tt�tj
dkr�t�td<dtkr�ttd<nttd�td<t�r\t	j
dk�r\t}zt	��}Wntk
�rd}YnXt	j�td��s\||k�r\t	j�|td�}t	j�|�td<tjdk�rzt	��d}t|�d�d�}|dk�r�dD]2}t|}t�dd|�}t�dd|�}|t|<�q�n�dt	jk�rt	jd}dD]0}t|}t�dd|�}|d|}|t|<�q�t�dd
�}	t�d|	�}
|
dk	�rz|
� d�}t	j�!|��szdD]$}t|}t�dd|�}|t|<�qT|�r�g}|D]}
|�"t�|
���q�|StSdS)ayWith no arguments, return a dictionary of all configuration
    variables relevant for the current platform.

    On Unix, this means every variable defined in Python's installed Makefile;
    On Windows and Mac OS it's a much smaller set.

    With arguments, return a list of values that result from looking up
    each argument in the configuration variable dictionary.
    N�prefix�exec_prefixZ
py_versionZpy_version_shortrrZpy_version_nodotr_ZplatbaseZprojectbaser�re)rZos2rIz2.6�userbase�srcdirrXr�)rhZ
BASECFLAGSrgZ	PY_CFLAGSr�z
-arch\s+\w+\s� z-isysroot [^ 	]*Z	ARCHFLAGSrgz-isysroot\s+(\S+)rz-isysroot\s+\S+(\s|$))#�_CONFIG_VARS�_PREFIX�_EXEC_PREFIX�_PY_VERSIONr�rr[r��AttributeErrorrr3r�r��versionr`rr)�getcwdrr�isabsrrKr\�unamerr�splitrir<rArZrvr1�exists�append)rSr_�cwdr�Zkernel_versionZ
major_versionrG�flagsZarchrgr�ZsdkZvalsr3rrrr�s�






�



cCst��|�S)z�Return the value of a single variable using the dictionary returned by
    'get_config_vars()'.

    Equivalent to get_config_vars().get(name)
    )rrZ)r3rrrrRscCs^tjdkrnd}tj�|�}|dkr(tjStj�d|�}tj|t|�|���}|dkr\dS|dkrhdStjStjd	ks�ttd
�s�tjSt�	�\}}}}}|���
dd�}|�
d
d�}|�
dd�}|dd�dkr�d||fS|dd�dk�r&|ddk�rPd}dt|d�d|dd�f}�n*|dd�dk�rDd||fS|dd�dk�rdd|||fS|dd�d k�r�d }t�
d!�}	|	�|�}
|
�rP|
��}�n�|dd�d"k�rPt�}|�d#�}|}
ztd$�}Wntk
�r�YnJXzt�d%|���}
W5|��X|
dk	�r2d&�|
�d'��d&�dd��}
|�s<|
}|�rP|}d(}|
d&d)k�rd*t��d+d���k�rd,}t��d+�}t�d-|�}ttt|���}t|�d'k�r�|d}n^|d.k�r�d,}nN|d/k�r�d0}n>|d1k�r�d2}n.|d3k�r�d4}n|d5k�rd6}ntd7|f��n<|d8k�r0tjd9k�rPd:}n |d;k�rPtjd9k�rLd<}nd=}d>|||fS)?a�Return a string that identifies the current platform.

    This is used mainly to distinguish platform-specific build directories and
    platform-specific built distributions.  Typically includes the OS name
    and version and the architecture (as supplied by 'os.uname()'),
    although the exact information included depends on the OS; eg. for IRIX
    the architecture isn't particularly important (IRIX only runs on SGI
    hardware), but for Linux the kernel version isn't particularly
    important.

    Examples of returned values:
       linux-i586
       linux-alpha (?)
       solaris-2.6-sun4u
       irix-5.3
       irix64-6.2

    Windows will return one of:
       win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc)
       win-ia64 (64bit Windows on Itanium)
       win32 (all others - specifically, sys.platform is returned)

    For other non-POSIX platforms, currently just returns 'sys.platform'.
    rz bit (����)Zamd64z	win-amd64Zitaniumzwin-ia64rIr��/rer��_�-N�Zlinuxz%s-%sZsunosr�5Zsolarisz%d.%sr@r�ZirixZaixz%s-%s.%s��cygwinz[\d.]+rXZMACOSX_DEPLOYMENT_TARGETz0/System/Library/CoreServices/SystemVersion.plistz=<key>ProductUserVisibleVersion</key>\s*<string>(.*?)</string>rrZmacosxz10.4.z-archrgZfatz
-arch\s+(\S+))�i386�ppc)r��x86_64Zintel)r�r�r�Zfat3)�ppc64r�Zfat64)r�r�r�r�Z	universalz%Don't know machine value for archs=%rr�lr�)ZPowerPCZPower_Macintoshr�r�z%s-%s-%s) rr3r[r�r&r\ru�lowerr�r�rqrrrirjrpr1rrZrlr��closerv�readrr�ro�findallr8r�r*rs�maxsize)r��i�jZlookZosnameZhost�releaser��machineZrel_rer�ZcfgvarsZmacverZ
macreleaser~ZcflagsZarchsrrrr[s�
$


�

�





�

cCstSr)r�rrrrr�scCsFtt|����D]0\}\}}|dkr0td|�td||f�qdS)Nrz%s: z
	%s = "%s")�	enumerater�r7�print)�title�data�indexrGr>rrr�_print_dictsr�cCsRtdt��tdt��tdt��t�tdt��t�tdt��dS)z*Display all information sysconfig detains.zPlatform: "%s"zPython version: "%s"z!Current installation scheme: "%s"ZPathsZ	VariablesN)r�rrrQr�r
rrrrr�_mainsr��__main__)N)N)A�__doc__rkrrir[Zos.pathrrZconfigparser�ImportErrorZConfigParser�__all__rr�rr�rr�r3r�rrr)r#r-ZRawConfigParserr(rjr;r?r�r�r�r�r�rKr�r�r�r�r�Z
_USER_BASErErHrNrPrQr`r�rr�r�rrr
r	r
rrrrrr�r�r$rrrr�<module>s��""
#
	
v

	#
site-packages/pip/_vendor/distlib/_backport/__pycache__/misc.cpython-38.pyc000064400000002042151446177000022704 0ustar00U

��.e��@s�dZddlZddlZdddgZzddlmZWnek
rLddd�ZYnXzeZWn(ek
r~dd	l	m
Z
d
d�ZYnXz
ejZWnek
r�dd�ZYnXdS)
z/Backports for individual classes and functions.�N�cache_from_source�callable�fsencode)rTcCs|rdp
d}||S)N�c�o�)Zpy_file�debugZextrr�F/usr/lib/python3.8/site-packages/pip/_vendor/distlib/_backport/misc.pyrs)�CallablecCs
t|t�S)N)�
isinstancer
)�objrrr	rscCs<t|t�r|St|t�r&|�t���Stdt|�j��dS)Nzexpect bytes or str, not %s)	r�bytes�str�encode�sys�getfilesystemencoding�	TypeError�type�__name__)�filenamerrr	r"s

�)T)
�__doc__�osr�__all__Zimpr�ImportErrorr�	NameError�collectionsr
r�AttributeErrorrrrr	�<module>s 

site-packages/pip/_vendor/distlib/_backport/__pycache__/__init__.cpython-38.pyc000064400000000677151446177000023524 0ustar00U

��.e�@sdZdS)aModules copied from Python 3 standard libraries, for internal use only.

Individual classes and functions are found in d2._backport.misc.  Intended
usage is to always import things missing from 3.1 from that module: the
built-in/stdlib objects will be used if found.
N)�__doc__�rr�J/usr/lib/python3.8/site-packages/pip/_vendor/distlib/_backport/__init__.py�<module>�site-packages/pip/_vendor/distlib/_backport/__pycache__/misc.cpython-38.opt-1.pyc000064400000002042151446177000023643 0ustar00U

��.e��@s�dZddlZddlZdddgZzddlmZWnek
rLddd�ZYnXzeZWn(ek
r~dd	l	m
Z
d
d�ZYnXz
ejZWnek
r�dd�ZYnXdS)
z/Backports for individual classes and functions.�N�cache_from_source�callable�fsencode)rFcCs|rdp
d}||S)N�c�o�)Zpy_file�debugZextrr�F/usr/lib/python3.8/site-packages/pip/_vendor/distlib/_backport/misc.pyrs)�CallablecCs
t|t�S)N)�
isinstancer
)�objrrr	rscCs<t|t�r|St|t�r&|�t���Stdt|�j��dS)Nzexpect bytes or str, not %s)	r�bytes�str�encode�sys�getfilesystemencoding�	TypeError�type�__name__)�filenamerrr	r"s

�)F)
�__doc__�osr�__all__Zimpr�ImportErrorr�	NameError�collectionsr
r�AttributeErrorrrrr	�<module>s 

site-packages/pip/_vendor/distlib/_backport/__init__.py000064400000000422151446177000017222 0ustar00"""Modules copied from Python 3 standard libraries, for internal use only.

Individual classes and functions are found in d2._backport.misc.  Intended
usage is to always import things missing from 3.1 from that module: the
built-in/stdlib objects will be used if found.
"""
site-packages/pip/_vendor/distlib/_backport/misc.py000064400000001713151446177000016422 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012 The Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""Backports for individual classes and functions."""

import os
import sys

__all__ = ['cache_from_source', 'callable', 'fsencode']


try:
    from imp import cache_from_source
except ImportError:
    def cache_from_source(py_file, debug=__debug__):
        ext = debug and 'c' or 'o'
        return py_file + ext


try:
    callable = callable
except NameError:
    from collections import Callable

    def callable(obj):
        return isinstance(obj, Callable)


try:
    fsencode = os.fsencode
except AttributeError:
    def fsencode(filename):
        if isinstance(filename, bytes):
            return filename
        elif isinstance(filename, str):
            return filename.encode(sys.getfilesystemencoding())
        else:
            raise TypeError("expect bytes or str, not %s" %
                            type(filename).__name__)
site-packages/pip/_vendor/distlib/_backport/sysconfig.py000064400000064524151446177000017504 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012 The Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""Access to Python's configuration information."""

import codecs
import os
import re
import sys
from os.path import pardir, realpath
try:
    import configparser
except ImportError:
    import ConfigParser as configparser


__all__ = [
    'get_config_h_filename',
    'get_config_var',
    'get_config_vars',
    'get_makefile_filename',
    'get_path',
    'get_path_names',
    'get_paths',
    'get_platform',
    'get_python_version',
    'get_scheme_names',
    'parse_config_h',
]


def _safe_realpath(path):
    try:
        return realpath(path)
    except OSError:
        return path


if sys.executable:
    _PROJECT_BASE = os.path.dirname(_safe_realpath(sys.executable))
else:
    # sys.executable can be empty if argv[0] has been changed and Python is
    # unable to retrieve the real program name
    _PROJECT_BASE = _safe_realpath(os.getcwd())

if os.name == "nt" and "pcbuild" in _PROJECT_BASE[-8:].lower():
    _PROJECT_BASE = _safe_realpath(os.path.join(_PROJECT_BASE, pardir))
# PC/VS7.1
if os.name == "nt" and "\\pc\\v" in _PROJECT_BASE[-10:].lower():
    _PROJECT_BASE = _safe_realpath(os.path.join(_PROJECT_BASE, pardir, pardir))
# PC/AMD64
if os.name == "nt" and "\\pcbuild\\amd64" in _PROJECT_BASE[-14:].lower():
    _PROJECT_BASE = _safe_realpath(os.path.join(_PROJECT_BASE, pardir, pardir))


def is_python_build():
    for fn in ("Setup.dist", "Setup.local"):
        if os.path.isfile(os.path.join(_PROJECT_BASE, "Modules", fn)):
            return True
    return False

_PYTHON_BUILD = is_python_build()

_cfg_read = False

def _ensure_cfg_read():
    global _cfg_read
    if not _cfg_read:
        from ..resources import finder
        backport_package = __name__.rsplit('.', 1)[0]
        _finder = finder(backport_package)
        _cfgfile = _finder.find('sysconfig.cfg')
        assert _cfgfile, 'sysconfig.cfg exists'
        with _cfgfile.as_stream() as s:
            _SCHEMES.readfp(s)
        if _PYTHON_BUILD:
            for scheme in ('posix_prefix', 'posix_home'):
                _SCHEMES.set(scheme, 'include', '{srcdir}/Include')
                _SCHEMES.set(scheme, 'platinclude', '{projectbase}/.')

        _cfg_read = True


_SCHEMES = configparser.RawConfigParser()
_VAR_REPL = re.compile(r'\{([^{]*?)\}')

def _expand_globals(config):
    _ensure_cfg_read()
    if config.has_section('globals'):
        globals = config.items('globals')
    else:
        globals = tuple()

    sections = config.sections()
    for section in sections:
        if section == 'globals':
            continue
        for option, value in globals:
            if config.has_option(section, option):
                continue
            config.set(section, option, value)
    config.remove_section('globals')

    # now expanding local variables defined in the cfg file
    #
    for section in config.sections():
        variables = dict(config.items(section))

        def _replacer(matchobj):
            name = matchobj.group(1)
            if name in variables:
                return variables[name]
            return matchobj.group(0)

        for option, value in config.items(section):
            config.set(section, option, _VAR_REPL.sub(_replacer, value))

#_expand_globals(_SCHEMES)

 # FIXME don't rely on sys.version here, its format is an implementation detail
 # of CPython, use sys.version_info or sys.hexversion
_PY_VERSION = sys.version.split()[0]
_PY_VERSION_SHORT = sys.version[:3]
_PY_VERSION_SHORT_NO_DOT = _PY_VERSION[0] + _PY_VERSION[2]
_PREFIX = os.path.normpath(sys.prefix)
_EXEC_PREFIX = os.path.normpath(sys.exec_prefix)
_CONFIG_VARS = None
_USER_BASE = None


def _subst_vars(path, local_vars):
    """In the string `path`, replace tokens like {some.thing} with the
    corresponding value from the map `local_vars`.

    If there is no corresponding value, leave the token unchanged.
    """
    def _replacer(matchobj):
        name = matchobj.group(1)
        if name in local_vars:
            return local_vars[name]
        elif name in os.environ:
            return os.environ[name]
        return matchobj.group(0)
    return _VAR_REPL.sub(_replacer, path)


def _extend_dict(target_dict, other_dict):
    target_keys = target_dict.keys()
    for key, value in other_dict.items():
        if key in target_keys:
            continue
        target_dict[key] = value


def _expand_vars(scheme, vars):
    res = {}
    if vars is None:
        vars = {}
    _extend_dict(vars, get_config_vars())

    for key, value in _SCHEMES.items(scheme):
        if os.name in ('posix', 'nt'):
            value = os.path.expanduser(value)
        res[key] = os.path.normpath(_subst_vars(value, vars))
    return res


def format_value(value, vars):
    def _replacer(matchobj):
        name = matchobj.group(1)
        if name in vars:
            return vars[name]
        return matchobj.group(0)
    return _VAR_REPL.sub(_replacer, value)


def _get_default_scheme():
    if os.name == 'posix':
        # the default scheme for posix is posix_prefix
        return 'posix_prefix'
    return os.name


def _getuserbase():
    env_base = os.environ.get("PYTHONUSERBASE", None)

    def joinuser(*args):
        return os.path.expanduser(os.path.join(*args))

    # what about 'os2emx', 'riscos' ?
    if os.name == "nt":
        base = os.environ.get("APPDATA") or "~"
        if env_base:
            return env_base
        else:
            return joinuser(base, "Python")

    if sys.platform == "darwin":
        framework = get_config_var("PYTHONFRAMEWORK")
        if framework:
            if env_base:
                return env_base
            else:
                return joinuser("~", "Library", framework, "%d.%d" %
                                sys.version_info[:2])

    if env_base:
        return env_base
    else:
        return joinuser("~", ".local")


def _parse_makefile(filename, vars=None):
    """Parse a Makefile-style file.

    A dictionary containing name/value pairs is returned.  If an
    optional dictionary is passed in as the second argument, it is
    used instead of a new dictionary.
    """
    # Regexes needed for parsing Makefile (and similar syntaxes,
    # like old-style Setup files).
    _variable_rx = re.compile(r"([a-zA-Z][a-zA-Z0-9_]+)\s*=\s*(.*)")
    _findvar1_rx = re.compile(r"\$\(([A-Za-z][A-Za-z0-9_]*)\)")
    _findvar2_rx = re.compile(r"\${([A-Za-z][A-Za-z0-9_]*)}")

    if vars is None:
        vars = {}
    done = {}
    notdone = {}

    with codecs.open(filename, encoding='utf-8', errors="surrogateescape") as f:
        lines = f.readlines()

    for line in lines:
        if line.startswith('#') or line.strip() == '':
            continue
        m = _variable_rx.match(line)
        if m:
            n, v = m.group(1, 2)
            v = v.strip()
            # `$$' is a literal `$' in make
            tmpv = v.replace('$$', '')

            if "$" in tmpv:
                notdone[n] = v
            else:
                try:
                    v = int(v)
                except ValueError:
                    # insert literal `$'
                    done[n] = v.replace('$$', '$')
                else:
                    done[n] = v

    # do variable interpolation here
    variables = list(notdone.keys())

    # Variables with a 'PY_' prefix in the makefile. These need to
    # be made available without that prefix through sysconfig.
    # Special care is needed to ensure that variable expansion works, even
    # if the expansion uses the name without a prefix.
    renamed_variables = ('CFLAGS', 'LDFLAGS', 'CPPFLAGS')

    while len(variables) > 0:
        for name in tuple(variables):
            value = notdone[name]
            m = _findvar1_rx.search(value) or _findvar2_rx.search(value)
            if m is not None:
                n = m.group(1)
                found = True
                if n in done:
                    item = str(done[n])
                elif n in notdone:
                    # get it on a subsequent round
                    found = False
                elif n in os.environ:
                    # do it like make: fall back to environment
                    item = os.environ[n]

                elif n in renamed_variables:
                    if (name.startswith('PY_') and
                        name[3:] in renamed_variables):
                        item = ""

                    elif 'PY_' + n in notdone:
                        found = False

                    else:
                        item = str(done['PY_' + n])

                else:
                    done[n] = item = ""

                if found:
                    after = value[m.end():]
                    value = value[:m.start()] + item + after
                    if "$" in after:
                        notdone[name] = value
                    else:
                        try:
                            value = int(value)
                        except ValueError:
                            done[name] = value.strip()
                        else:
                            done[name] = value
                        variables.remove(name)

                        if (name.startswith('PY_') and
                            name[3:] in renamed_variables):

                            name = name[3:]
                            if name not in done:
                                done[name] = value

            else:
                # bogus variable reference (e.g. "prefix=$/opt/python");
                # just drop it since we can't deal
                done[name] = value
                variables.remove(name)

    # strip spurious spaces
    for k, v in done.items():
        if isinstance(v, str):
            done[k] = v.strip()

    # save the results in the global dictionary
    vars.update(done)
    return vars


def get_makefile_filename():
    """Return the path of the Makefile."""
    if _PYTHON_BUILD:
        return os.path.join(_PROJECT_BASE, "Makefile")
    if hasattr(sys, 'abiflags'):
        config_dir_name = 'config-%s%s' % (_PY_VERSION_SHORT, sys.abiflags)
    else:
        config_dir_name = 'config'
    return os.path.join(get_path('stdlib'), config_dir_name, 'Makefile')


def _init_posix(vars):
    """Initialize the module as appropriate for POSIX systems."""
    # load the installed Makefile:
    makefile = get_makefile_filename()
    try:
        _parse_makefile(makefile, vars)
    except IOError as e:
        msg = "invalid Python installation: unable to open %s" % makefile
        if hasattr(e, "strerror"):
            msg = msg + " (%s)" % e.strerror
        raise IOError(msg)
    # load the installed pyconfig.h:
    config_h = get_config_h_filename()
    try:
        with open(config_h) as f:
            parse_config_h(f, vars)
    except IOError as e:
        msg = "invalid Python installation: unable to open %s" % config_h
        if hasattr(e, "strerror"):
            msg = msg + " (%s)" % e.strerror
        raise IOError(msg)
    # On AIX, there are wrong paths to the linker scripts in the Makefile
    # -- these paths are relative to the Python source, but when installed
    # the scripts are in another directory.
    if _PYTHON_BUILD:
        vars['LDSHARED'] = vars['BLDSHARED']


def _init_non_posix(vars):
    """Initialize the module as appropriate for NT"""
    # set basic install directories
    vars['LIBDEST'] = get_path('stdlib')
    vars['BINLIBDEST'] = get_path('platstdlib')
    vars['INCLUDEPY'] = get_path('include')
    vars['SO'] = '.pyd'
    vars['EXE'] = '.exe'
    vars['VERSION'] = _PY_VERSION_SHORT_NO_DOT
    vars['BINDIR'] = os.path.dirname(_safe_realpath(sys.executable))

#
# public APIs
#


def parse_config_h(fp, vars=None):
    """Parse a config.h-style file.

    A dictionary containing name/value pairs is returned.  If an
    optional dictionary is passed in as the second argument, it is
    used instead of a new dictionary.
    """
    if vars is None:
        vars = {}
    define_rx = re.compile("#define ([A-Z][A-Za-z0-9_]+) (.*)\n")
    undef_rx = re.compile("/[*] #undef ([A-Z][A-Za-z0-9_]+) [*]/\n")

    while True:
        line = fp.readline()
        if not line:
            break
        m = define_rx.match(line)
        if m:
            n, v = m.group(1, 2)
            try:
                v = int(v)
            except ValueError:
                pass
            vars[n] = v
        else:
            m = undef_rx.match(line)
            if m:
                vars[m.group(1)] = 0
    return vars


def get_config_h_filename():
    """Return the path of pyconfig.h."""
    if _PYTHON_BUILD:
        if os.name == "nt":
            inc_dir = os.path.join(_PROJECT_BASE, "PC")
        else:
            inc_dir = _PROJECT_BASE
    else:
        inc_dir = get_path('platinclude')
    return os.path.join(inc_dir, 'pyconfig.h')


def get_scheme_names():
    """Return a tuple containing the schemes names."""
    return tuple(sorted(_SCHEMES.sections()))


def get_path_names():
    """Return a tuple containing the paths names."""
    # xxx see if we want a static list
    return _SCHEMES.options('posix_prefix')


def get_paths(scheme=_get_default_scheme(), vars=None, expand=True):
    """Return a mapping containing an install scheme.

    ``scheme`` is the install scheme name. If not provided, it will
    return the default scheme for the current platform.
    """
    _ensure_cfg_read()
    if expand:
        return _expand_vars(scheme, vars)
    else:
        return dict(_SCHEMES.items(scheme))


def get_path(name, scheme=_get_default_scheme(), vars=None, expand=True):
    """Return a path corresponding to the scheme.

    ``scheme`` is the install scheme name.
    """
    return get_paths(scheme, vars, expand)[name]


def get_config_vars(*args):
    """With no arguments, return a dictionary of all configuration
    variables relevant for the current platform.

    On Unix, this means every variable defined in Python's installed Makefile;
    On Windows and Mac OS it's a much smaller set.

    With arguments, return a list of values that result from looking up
    each argument in the configuration variable dictionary.
    """
    global _CONFIG_VARS
    if _CONFIG_VARS is None:
        _CONFIG_VARS = {}
        # Normalized versions of prefix and exec_prefix are handy to have;
        # in fact, these are the standard versions used most places in the
        # distutils2 module.
        _CONFIG_VARS['prefix'] = _PREFIX
        _CONFIG_VARS['exec_prefix'] = _EXEC_PREFIX
        _CONFIG_VARS['py_version'] = _PY_VERSION
        _CONFIG_VARS['py_version_short'] = _PY_VERSION_SHORT
        _CONFIG_VARS['py_version_nodot'] = _PY_VERSION[0] + _PY_VERSION[2]
        _CONFIG_VARS['base'] = _PREFIX
        _CONFIG_VARS['platbase'] = _EXEC_PREFIX
        _CONFIG_VARS['projectbase'] = _PROJECT_BASE
        try:
            _CONFIG_VARS['abiflags'] = sys.abiflags
        except AttributeError:
            # sys.abiflags may not be defined on all platforms.
            _CONFIG_VARS['abiflags'] = ''

        if os.name in ('nt', 'os2'):
            _init_non_posix(_CONFIG_VARS)
        if os.name == 'posix':
            _init_posix(_CONFIG_VARS)
        # Setting 'userbase' is done below the call to the
        # init function to enable using 'get_config_var' in
        # the init-function.
        if sys.version >= '2.6':
            _CONFIG_VARS['userbase'] = _getuserbase()

        if 'srcdir' not in _CONFIG_VARS:
            _CONFIG_VARS['srcdir'] = _PROJECT_BASE
        else:
            _CONFIG_VARS['srcdir'] = _safe_realpath(_CONFIG_VARS['srcdir'])

        # Convert srcdir into an absolute path if it appears necessary.
        # Normally it is relative to the build directory.  However, during
        # testing, for example, we might be running a non-installed python
        # from a different directory.
        if _PYTHON_BUILD and os.name == "posix":
            base = _PROJECT_BASE
            try:
                cwd = os.getcwd()
            except OSError:
                cwd = None
            if (not os.path.isabs(_CONFIG_VARS['srcdir']) and
                base != cwd):
                # srcdir is relative and we are not in the same directory
                # as the executable. Assume executable is in the build
                # directory and make srcdir absolute.
                srcdir = os.path.join(base, _CONFIG_VARS['srcdir'])
                _CONFIG_VARS['srcdir'] = os.path.normpath(srcdir)

        if sys.platform == 'darwin':
            kernel_version = os.uname()[2]  # Kernel version (8.4.3)
            major_version = int(kernel_version.split('.')[0])

            if major_version < 8:
                # On Mac OS X before 10.4, check if -arch and -isysroot
                # are in CFLAGS or LDFLAGS and remove them if they are.
                # This is needed when building extensions on a 10.3 system
                # using a universal build of python.
                for key in ('LDFLAGS', 'BASECFLAGS',
                        # a number of derived variables. These need to be
                        # patched up as well.
                        'CFLAGS', 'PY_CFLAGS', 'BLDSHARED'):
                    flags = _CONFIG_VARS[key]
                    flags = re.sub(r'-arch\s+\w+\s', ' ', flags)
                    flags = re.sub('-isysroot [^ \t]*', ' ', flags)
                    _CONFIG_VARS[key] = flags
            else:
                # Allow the user to override the architecture flags using
                # an environment variable.
                # NOTE: This name was introduced by Apple in OSX 10.5 and
                # is used by several scripting languages distributed with
                # that OS release.
                if 'ARCHFLAGS' in os.environ:
                    arch = os.environ['ARCHFLAGS']
                    for key in ('LDFLAGS', 'BASECFLAGS',
                        # a number of derived variables. These need to be
                        # patched up as well.
                        'CFLAGS', 'PY_CFLAGS', 'BLDSHARED'):

                        flags = _CONFIG_VARS[key]
                        flags = re.sub(r'-arch\s+\w+\s', ' ', flags)
                        flags = flags + ' ' + arch
                        _CONFIG_VARS[key] = flags

                # If we're on OSX 10.5 or later and the user tries to
                # compiles an extension using an SDK that is not present
                # on the current machine it is better to not use an SDK
                # than to fail.
                #
                # The major usecase for this is users using a Python.org
                # binary installer  on OSX 10.6: that installer uses
                # the 10.4u SDK, but that SDK is not installed by default
                # when you install Xcode.
                #
                CFLAGS = _CONFIG_VARS.get('CFLAGS', '')
                m = re.search(r'-isysroot\s+(\S+)', CFLAGS)
                if m is not None:
                    sdk = m.group(1)
                    if not os.path.exists(sdk):
                        for key in ('LDFLAGS', 'BASECFLAGS',
                             # a number of derived variables. These need to be
                             # patched up as well.
                            'CFLAGS', 'PY_CFLAGS', 'BLDSHARED'):

                            flags = _CONFIG_VARS[key]
                            flags = re.sub(r'-isysroot\s+\S+(\s|$)', ' ', flags)
                            _CONFIG_VARS[key] = flags

    if args:
        vals = []
        for name in args:
            vals.append(_CONFIG_VARS.get(name))
        return vals
    else:
        return _CONFIG_VARS


def get_config_var(name):
    """Return the value of a single variable using the dictionary returned by
    'get_config_vars()'.

    Equivalent to get_config_vars().get(name)
    """
    return get_config_vars().get(name)


def get_platform():
    """Return a string that identifies the current platform.

    This is used mainly to distinguish platform-specific build directories and
    platform-specific built distributions.  Typically includes the OS name
    and version and the architecture (as supplied by 'os.uname()'),
    although the exact information included depends on the OS; eg. for IRIX
    the architecture isn't particularly important (IRIX only runs on SGI
    hardware), but for Linux the kernel version isn't particularly
    important.

    Examples of returned values:
       linux-i586
       linux-alpha (?)
       solaris-2.6-sun4u
       irix-5.3
       irix64-6.2

    Windows will return one of:
       win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc)
       win-ia64 (64bit Windows on Itanium)
       win32 (all others - specifically, sys.platform is returned)

    For other non-POSIX platforms, currently just returns 'sys.platform'.
    """
    if os.name == 'nt':
        # sniff sys.version for architecture.
        prefix = " bit ("
        i = sys.version.find(prefix)
        if i == -1:
            return sys.platform
        j = sys.version.find(")", i)
        look = sys.version[i+len(prefix):j].lower()
        if look == 'amd64':
            return 'win-amd64'
        if look == 'itanium':
            return 'win-ia64'
        return sys.platform

    if os.name != "posix" or not hasattr(os, 'uname'):
        # XXX what about the architecture? NT is Intel or Alpha,
        # Mac OS is M68k or PPC, etc.
        return sys.platform

    # Try to distinguish various flavours of Unix
    osname, host, release, version, machine = os.uname()

    # Convert the OS name to lowercase, remove '/' characters
    # (to accommodate BSD/OS), and translate spaces (for "Power Macintosh")
    osname = osname.lower().replace('/', '')
    machine = machine.replace(' ', '_')
    machine = machine.replace('/', '-')

    if osname[:5] == "linux":
        # At least on Linux/Intel, 'machine' is the processor --
        # i386, etc.
        # XXX what about Alpha, SPARC, etc?
        return  "%s-%s" % (osname, machine)
    elif osname[:5] == "sunos":
        if release[0] >= "5":           # SunOS 5 == Solaris 2
            osname = "solaris"
            release = "%d.%s" % (int(release[0]) - 3, release[2:])
        # fall through to standard osname-release-machine representation
    elif osname[:4] == "irix":              # could be "irix64"!
        return "%s-%s" % (osname, release)
    elif osname[:3] == "aix":
        return "%s-%s.%s" % (osname, version, release)
    elif osname[:6] == "cygwin":
        osname = "cygwin"
        rel_re = re.compile(r'[\d.]+')
        m = rel_re.match(release)
        if m:
            release = m.group()
    elif osname[:6] == "darwin":
        #
        # For our purposes, we'll assume that the system version from
        # distutils' perspective is what MACOSX_DEPLOYMENT_TARGET is set
        # to. This makes the compatibility story a bit more sane because the
        # machine is going to compile and link as if it were
        # MACOSX_DEPLOYMENT_TARGET.
        cfgvars = get_config_vars()
        macver = cfgvars.get('MACOSX_DEPLOYMENT_TARGET')

        if True:
            # Always calculate the release of the running machine,
            # needed to determine if we can build fat binaries or not.

            macrelease = macver
            # Get the system version. Reading this plist is a documented
            # way to get the system version (see the documentation for
            # the Gestalt Manager)
            try:
                f = open('/System/Library/CoreServices/SystemVersion.plist')
            except IOError:
                # We're on a plain darwin box, fall back to the default
                # behaviour.
                pass
            else:
                try:
                    m = re.search(r'<key>ProductUserVisibleVersion</key>\s*'
                                  r'<string>(.*?)</string>', f.read())
                finally:
                    f.close()
                if m is not None:
                    macrelease = '.'.join(m.group(1).split('.')[:2])
                # else: fall back to the default behaviour

        if not macver:
            macver = macrelease

        if macver:
            release = macver
            osname = "macosx"

            if ((macrelease + '.') >= '10.4.' and
                '-arch' in get_config_vars().get('CFLAGS', '').strip()):
                # The universal build will build fat binaries, but not on
                # systems before 10.4
                #
                # Try to detect 4-way universal builds, those have machine-type
                # 'universal' instead of 'fat'.

                machine = 'fat'
                cflags = get_config_vars().get('CFLAGS')

                archs = re.findall(r'-arch\s+(\S+)', cflags)
                archs = tuple(sorted(set(archs)))

                if len(archs) == 1:
                    machine = archs[0]
                elif archs == ('i386', 'ppc'):
                    machine = 'fat'
                elif archs == ('i386', 'x86_64'):
                    machine = 'intel'
                elif archs == ('i386', 'ppc', 'x86_64'):
                    machine = 'fat3'
                elif archs == ('ppc64', 'x86_64'):
                    machine = 'fat64'
                elif archs == ('i386', 'ppc', 'ppc64', 'x86_64'):
                    machine = 'universal'
                else:
                    raise ValueError(
                       "Don't know machine value for archs=%r" % (archs,))

            elif machine == 'i386':
                # On OSX the machine type returned by uname is always the
                # 32-bit variant, even if the executable architecture is
                # the 64-bit variant
                if sys.maxsize >= 2**32:
                    machine = 'x86_64'

            elif machine in ('PowerPC', 'Power_Macintosh'):
                # Pick a sane name for the PPC architecture.
                # See 'i386' case
                if sys.maxsize >= 2**32:
                    machine = 'ppc64'
                else:
                    machine = 'ppc'

    return "%s-%s-%s" % (osname, release, machine)


def get_python_version():
    return _PY_VERSION_SHORT


def _print_dict(title, data):
    for index, (key, value) in enumerate(sorted(data.items())):
        if index == 0:
            print('%s: ' % (title))
        print('\t%s = "%s"' % (key, value))


def _main():
    """Display all information sysconfig detains."""
    print('Platform: "%s"' % get_platform())
    print('Python version: "%s"' % get_python_version())
    print('Current installation scheme: "%s"' % _get_default_scheme())
    print()
    _print_dict('Paths', get_paths())
    print()
    _print_dict('Variables', get_config_vars())


if __name__ == '__main__':
    _main()
site-packages/pip/_vendor/distlib/database.py000064400000143525151446177000015277 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2017 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
                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)

    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
        logger.debug('Getting requirements from metadata %r', md.todict())
        reqts = getattr(md, req_attr)
        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 '<Distribution %s (%s)%s>' % (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('METADATA')
            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()
            self.modules = data.splitlines()

    def __repr__(self):
        return '<InstalledDistribution %r %s at %r>' % (
            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()
                if line.startswith('['):
                    logger.warning('Unexpected line: quitting requirement scan: %r',
                                   line)
                    break
                r = parse_requirement(line)
                if not r:
                    logger.warning('Not recognised as a requirement: %r', line)
                    continue
                if r.extras:
                    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 '<EggInfoDistribution %r %s at %r>' % (
            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 not label is 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
    """
    if dist not in dists:
        raise DistlibException('given distribution %r is not a member '
                               'of the list' % dist.name)
    graph = make_graph(dists)

    req = []  # required distributions
    todo = graph.adjacency_list[dist]  # list of nodes we should inspect

    while todo:
        d = todo.pop()[0]
        req.append(d)
        for pred in graph.adjacency_list[d]:
            if pred not in req:
                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)
site-packages/pip/_vendor/distlib/compat.py000064400000120674151446177000015016 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2017 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 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 ._backport import shutil
    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

    _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
    import shutil
    from urllib.parse import (urlparse, urlunparse, urljoin, splituser, 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: " + repr(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 not os.curdir 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 not normdir 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'

try:
    import sysconfig
except ImportError: # pragma: no cover
    from ._backport import sysconfig

try:
    callable = callable
except NameError:   # pragma: no cover
    from collections 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
    import re

    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'.format(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 & <-> &amp; 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
    try:
        from imp import cache_from_source
    except ImportError:  # pragma: no cover
        def cache_from_source(path, debug_override=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<prefix>[a-z]+)://(?P<suffix>.*)$')

        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]]
                #print d, rest
                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
site-packages/pip/_vendor/distlib/manifest.py000064400000034733151446177000015341 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2013 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 on 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.stat(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:
                found = self._exclude_pattern(pattern, anchor=True)
                #if not found:
                #    logger.warning('no previously-included files '
                #                   'found matching %r', pattern)

        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:
                found = self._exclude_pattern(pattern, anchor=False)
                #if not found:
                #    logger.warning('no previously-included files '
                #                   'matching %r found anywhere in '
                #                   'distribution', pattern)

        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:
                found = self._exclude_pattern(pattern, prefix=thedir)
                #if not found:
                #    logger.warning('no previously-included files '
                #                   'matching %r found under directory %r',
                #                   pattern, 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 <pattern1> <pattern2> ...' % 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 <dir> <pattern1> <pattern2> ...' % 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 <dir_pattern>' % 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'((?<!\\)(\\\\)*)\.', escaped, pattern_re)
        return pattern_re
site-packages/pip/_vendor/distlib/wheel.py000064400000116765151446177000014645 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2013-2017 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
from __future__ import unicode_literals

import base64
import codecs
import datetime
import distutils.util
from email import message_from_file
import hashlib
import imp
import json
import logging
import os
import posixpath
import re
import shutil
import sys
import tempfile
import zipfile

from . import __version__, DistlibException
from .compat import sysconfig, ZipFile, fsdecode, text_type, filter
from .database import InstalledDistribution
from .metadata import Metadata, METADATA_FILENAME, WHEEL_METADATA_FILENAME
from .util import (FileOperator, convert_path, CSVReader, CSVWriter, Cache,
                   cached_property, get_cache_base, read_exports, tempdir)
from .version import NormalizedVersion, UnsupportedVersionError

logger = logging.getLogger(__name__)

cache = None    # created when needed

if hasattr(sys, 'pypy_version_info'):  # pragma: no cover
    IMP_PREFIX = 'pp'
elif sys.platform.startswith('java'):  # pragma: no cover
    IMP_PREFIX = 'jy'
elif sys.platform == 'cli':  # pragma: no cover
    IMP_PREFIX = 'ip'
else:
    IMP_PREFIX = 'cp'

VER_SUFFIX = sysconfig.get_config_var('py_version_nodot')
if not VER_SUFFIX:   # pragma: no cover
    VER_SUFFIX = '%s%s' % sys.version_info[:2]
PYVER = 'py' + VER_SUFFIX
IMPVER = IMP_PREFIX + VER_SUFFIX

ARCH = distutils.util.get_platform().replace('-', '_').replace('.', '_')

ABI = sysconfig.get_config_var('SOABI')
if ABI and ABI.startswith('cpython-'):
    ABI = ABI.replace('cpython-', 'cp')
else:
    def _derive_abi():
        parts = ['cp', VER_SUFFIX]
        if sysconfig.get_config_var('Py_DEBUG'):
            parts.append('d')
        if sysconfig.get_config_var('WITH_PYMALLOC'):
            parts.append('m')
        if sysconfig.get_config_var('Py_UNICODE_SIZE') == 4:
            parts.append('u')
        return ''.join(parts)
    ABI = _derive_abi()
    del _derive_abi

FILENAME_RE = re.compile(r'''
(?P<nm>[^-]+)
-(?P<vn>\d+[^-]*)
(-(?P<bn>\d+[^-]*))?
-(?P<py>\w+\d+(\.\w+\d+)*)
-(?P<bi>\w+)
-(?P<ar>\w+(\.\w+)*)
\.whl$
''', re.IGNORECASE | re.VERBOSE)

NAME_VERSION_RE = re.compile(r'''
(?P<nm>[^-]+)
-(?P<vn>\d+[^-]*)
(-(?P<bn>\d+[^-]*))?$
''', re.IGNORECASE | re.VERBOSE)

SHEBANG_RE = re.compile(br'\s*#![^\r\n]*')
SHEBANG_DETAIL_RE = re.compile(br'^(\s*#!("[^"]+"|\S+))\s+(.*)$')
SHEBANG_PYTHON = b'#!python'
SHEBANG_PYTHONW = b'#!pythonw'

if os.sep == '/':
    to_posix = lambda o: o
else:
    to_posix = lambda o: o.replace(os.sep, '/')


class Mounter(object):
    def __init__(self):
        self.impure_wheels = {}
        self.libs = {}

    def add(self, pathname, extensions):
        self.impure_wheels[pathname] = extensions
        self.libs.update(extensions)

    def remove(self, pathname):
        extensions = self.impure_wheels.pop(pathname)
        for k, v in extensions:
            if k in self.libs:
                del self.libs[k]

    def find_module(self, fullname, path=None):
        if fullname in self.libs:
            result = self
        else:
            result = None
        return result

    def load_module(self, fullname):
        if fullname in sys.modules:
            result = sys.modules[fullname]
        else:
            if fullname not in self.libs:
                raise ImportError('unable to find extension for %s' % fullname)
            result = imp.load_dynamic(fullname, self.libs[fullname])
            result.__loader__ = self
            parts = fullname.rsplit('.', 1)
            if len(parts) > 1:
                result.__package__ = parts[0]
        return result

_hook = Mounter()


class Wheel(object):
    """
    Class to build and install from Wheel files (PEP 427).
    """

    wheel_version = (1, 1)
    hash_kind = 'sha256'

    def __init__(self, filename=None, sign=False, verify=False):
        """
        Initialise an instance using a (valid) filename.
        """
        self.sign = sign
        self.should_verify = verify
        self.buildver = ''
        self.pyver = [PYVER]
        self.abi = ['none']
        self.arch = ['any']
        self.dirname = os.getcwd()
        if filename is None:
            self.name = 'dummy'
            self.version = '0.1'
            self._filename = self.filename
        else:
            m = NAME_VERSION_RE.match(filename)
            if m:
                info = m.groupdict('')
                self.name = info['nm']
                # Reinstate the local version separator
                self.version = info['vn'].replace('_', '-')
                self.buildver = info['bn']
                self._filename = self.filename
            else:
                dirname, filename = os.path.split(filename)
                m = FILENAME_RE.match(filename)
                if not m:
                    raise DistlibException('Invalid name or '
                                           'filename: %r' % filename)
                if dirname:
                    self.dirname = os.path.abspath(dirname)
                self._filename = filename
                info = m.groupdict('')
                self.name = info['nm']
                self.version = info['vn']
                self.buildver = info['bn']
                self.pyver = info['py'].split('.')
                self.abi = info['bi'].split('.')
                self.arch = info['ar'].split('.')

    @property
    def filename(self):
        """
        Build and return a filename from the various components.
        """
        if self.buildver:
            buildver = '-' + self.buildver
        else:
            buildver = ''
        pyver = '.'.join(self.pyver)
        abi = '.'.join(self.abi)
        arch = '.'.join(self.arch)
        # replace - with _ as a local version separator
        version = self.version.replace('-', '_')
        return '%s-%s%s-%s-%s-%s.whl' % (self.name, version, buildver,
                                         pyver, abi, arch)

    @property
    def exists(self):
        path = os.path.join(self.dirname, self.filename)
        return os.path.isfile(path)

    @property
    def tags(self):
        for pyver in self.pyver:
            for abi in self.abi:
                for arch in self.arch:
                    yield pyver, abi, arch

    @cached_property
    def metadata(self):
        pathname = os.path.join(self.dirname, self.filename)
        name_ver = '%s-%s' % (self.name, self.version)
        info_dir = '%s.dist-info' % name_ver
        wrapper = codecs.getreader('utf-8')
        with ZipFile(pathname, 'r') as zf:
            wheel_metadata = self.get_wheel_metadata(zf)
            wv = wheel_metadata['Wheel-Version'].split('.', 1)
            file_version = tuple([int(i) for i in wv])
            if file_version < (1, 1):
                fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME, 'METADATA']
            else:
                fns = [WHEEL_METADATA_FILENAME, METADATA_FILENAME]
            result = None
            for fn in fns:
                try:
                    metadata_filename = posixpath.join(info_dir, fn)
                    with zf.open(metadata_filename) as bf:
                        wf = wrapper(bf)
                        result = Metadata(fileobj=wf)
                        if result:
                            break
                except KeyError:
                    pass
            if not result:
                raise ValueError('Invalid wheel, because metadata is '
                                 'missing: looked in %s' % ', '.join(fns))
        return result

    def get_wheel_metadata(self, zf):
        name_ver = '%s-%s' % (self.name, self.version)
        info_dir = '%s.dist-info' % name_ver
        metadata_filename = posixpath.join(info_dir, 'WHEEL')
        with zf.open(metadata_filename) as bf:
            wf = codecs.getreader('utf-8')(bf)
            message = message_from_file(wf)
        return dict(message)

    @cached_property
    def info(self):
        pathname = os.path.join(self.dirname, self.filename)
        with ZipFile(pathname, 'r') as zf:
            result = self.get_wheel_metadata(zf)
        return result

    def process_shebang(self, data):
        m = SHEBANG_RE.match(data)
        if m:
            end = m.end()
            shebang, data_after_shebang = data[:end], data[end:]
            # Preserve any arguments after the interpreter
            if b'pythonw' in shebang.lower():
                shebang_python = SHEBANG_PYTHONW
            else:
                shebang_python = SHEBANG_PYTHON
            m = SHEBANG_DETAIL_RE.match(shebang)
            if m:
                args = b' ' + m.groups()[-1]
            else:
                args = b''
            shebang = shebang_python + args
            data = shebang + data_after_shebang
        else:
            cr = data.find(b'\r')
            lf = data.find(b'\n')
            if cr < 0 or cr > lf:
                term = b'\n'
            else:
                if data[cr:cr + 2] == b'\r\n':
                    term = b'\r\n'
                else:
                    term = b'\r'
            data = SHEBANG_PYTHON + term + data
        return data

    def get_hash(self, data, hash_kind=None):
        if hash_kind is None:
            hash_kind = self.hash_kind
        try:
            hasher = getattr(hashlib, hash_kind)
        except AttributeError:
            raise DistlibException('Unsupported hash algorithm: %r' % hash_kind)
        result = hasher(data).digest()
        result = base64.urlsafe_b64encode(result).rstrip(b'=').decode('ascii')
        return hash_kind, result

    def write_record(self, records, record_path, base):
        records = list(records) # make a copy for sorting
        p = to_posix(os.path.relpath(record_path, base))
        records.append((p, '', ''))
        records.sort()
        with CSVWriter(record_path) as writer:
            for row in records:
                writer.writerow(row)

    def write_records(self, info, libdir, archive_paths):
        records = []
        distinfo, info_dir = info
        hasher = getattr(hashlib, self.hash_kind)
        for ap, p in archive_paths:
            with open(p, 'rb') as f:
                data = f.read()
            digest = '%s=%s' % self.get_hash(data)
            size = os.path.getsize(p)
            records.append((ap, digest, size))

        p = os.path.join(distinfo, 'RECORD')
        self.write_record(records, p, libdir)
        ap = to_posix(os.path.join(info_dir, 'RECORD'))
        archive_paths.append((ap, p))

    def build_zip(self, pathname, archive_paths):
        with ZipFile(pathname, 'w', zipfile.ZIP_DEFLATED) as zf:
            for ap, p in archive_paths:
                logger.debug('Wrote %s to %s in wheel', p, ap)
                zf.write(p, ap)

    def build(self, paths, tags=None, wheel_version=None):
        """
        Build a wheel from files in specified paths, and use any specified tags
        when determining the name of the wheel.
        """
        if tags is None:
            tags = {}

        libkey = list(filter(lambda o: o in paths, ('purelib', 'platlib')))[0]
        if libkey == 'platlib':
            is_pure = 'false'
            default_pyver = [IMPVER]
            default_abi = [ABI]
            default_arch = [ARCH]
        else:
            is_pure = 'true'
            default_pyver = [PYVER]
            default_abi = ['none']
            default_arch = ['any']

        self.pyver = tags.get('pyver', default_pyver)
        self.abi = tags.get('abi', default_abi)
        self.arch = tags.get('arch', default_arch)

        libdir = paths[libkey]

        name_ver = '%s-%s' % (self.name, self.version)
        data_dir = '%s.data' % name_ver
        info_dir = '%s.dist-info' % name_ver

        archive_paths = []

        # First, stuff which is not in site-packages
        for key in ('data', 'headers', 'scripts'):
            if key not in paths:
                continue
            path = paths[key]
            if os.path.isdir(path):
                for root, dirs, files in os.walk(path):
                    for fn in files:
                        p = fsdecode(os.path.join(root, fn))
                        rp = os.path.relpath(p, path)
                        ap = to_posix(os.path.join(data_dir, key, rp))
                        archive_paths.append((ap, p))
                        if key == 'scripts' and not p.endswith('.exe'):
                            with open(p, 'rb') as f:
                                data = f.read()
                            data = self.process_shebang(data)
                            with open(p, 'wb') as f:
                                f.write(data)

        # Now, stuff which is in site-packages, other than the
        # distinfo stuff.
        path = libdir
        distinfo = None
        for root, dirs, files in os.walk(path):
            if root == path:
                # At the top level only, save distinfo for later
                # and skip it for now
                for i, dn in enumerate(dirs):
                    dn = fsdecode(dn)
                    if dn.endswith('.dist-info'):
                        distinfo = os.path.join(root, dn)
                        del dirs[i]
                        break
                assert distinfo, '.dist-info directory expected, not found'

            for fn in files:
                # comment out next suite to leave .pyc files in
                if fsdecode(fn).endswith(('.pyc', '.pyo')):
                    continue
                p = os.path.join(root, fn)
                rp = to_posix(os.path.relpath(p, path))
                archive_paths.append((rp, p))

        # Now distinfo. Assumed to be flat, i.e. os.listdir is enough.
        files = os.listdir(distinfo)
        for fn in files:
            if fn not in ('RECORD', 'INSTALLER', 'SHARED', 'WHEEL'):
                p = fsdecode(os.path.join(distinfo, fn))
                ap = to_posix(os.path.join(info_dir, fn))
                archive_paths.append((ap, p))

        wheel_metadata = [
            'Wheel-Version: %d.%d' % (wheel_version or self.wheel_version),
            'Generator: distlib %s' % __version__,
            'Root-Is-Purelib: %s' % is_pure,
        ]
        for pyver, abi, arch in self.tags:
            wheel_metadata.append('Tag: %s-%s-%s' % (pyver, abi, arch))
        p = os.path.join(distinfo, 'WHEEL')
        with open(p, 'w') as f:
            f.write('\n'.join(wheel_metadata))
        ap = to_posix(os.path.join(info_dir, 'WHEEL'))
        archive_paths.append((ap, p))

        # Now, at last, RECORD.
        # Paths in here are archive paths - nothing else makes sense.
        self.write_records((distinfo, info_dir), libdir, archive_paths)
        # Now, ready to build the zip file
        pathname = os.path.join(self.dirname, self.filename)
        self.build_zip(pathname, archive_paths)
        return pathname

    def skip_entry(self, arcname):
        """
        Determine whether an archive entry should be skipped when verifying
        or installing.
        """
        # The signature file won't be in RECORD,
        # and we  don't currently don't do anything with it
        # We also skip directories, as they won't be in RECORD
        # either. See:
        #
        # https://github.com/pypa/wheel/issues/294
        # https://github.com/pypa/wheel/issues/287
        # https://github.com/pypa/wheel/pull/289
        #
        return arcname.endswith(('/', '/RECORD.jws'))

    def install(self, paths, maker, **kwargs):
        """
        Install a wheel to the specified paths. If kwarg ``warner`` is
        specified, it should be a callable, which will be called with two
        tuples indicating the wheel version of this software and the wheel
        version in the file, if there is a discrepancy in the versions.
        This can be used to issue any warnings to raise any exceptions.
        If kwarg ``lib_only`` is True, only the purelib/platlib files are
        installed, and the headers, scripts, data and dist-info metadata are
        not written. If kwarg ``bytecode_hashed_invalidation`` is True, written
        bytecode will try to use file-hash based invalidation (PEP-552) on
        supported interpreter versions (CPython 2.7+).

        The return value is a :class:`InstalledDistribution` instance unless
        ``options.lib_only`` is True, in which case the return value is ``None``.
        """

        dry_run = maker.dry_run
        warner = kwargs.get('warner')
        lib_only = kwargs.get('lib_only', False)
        bc_hashed_invalidation = kwargs.get('bytecode_hashed_invalidation', False)

        pathname = os.path.join(self.dirname, self.filename)
        name_ver = '%s-%s' % (self.name, self.version)
        data_dir = '%s.data' % name_ver
        info_dir = '%s.dist-info' % name_ver

        metadata_name = posixpath.join(info_dir, METADATA_FILENAME)
        wheel_metadata_name = posixpath.join(info_dir, 'WHEEL')
        record_name = posixpath.join(info_dir, 'RECORD')

        wrapper = codecs.getreader('utf-8')

        with ZipFile(pathname, 'r') as zf:
            with zf.open(wheel_metadata_name) as bwf:
                wf = wrapper(bwf)
                message = message_from_file(wf)
            wv = message['Wheel-Version'].split('.', 1)
            file_version = tuple([int(i) for i in wv])
            if (file_version != self.wheel_version) and warner:
                warner(self.wheel_version, file_version)

            if message['Root-Is-Purelib'] == 'true':
                libdir = paths['purelib']
            else:
                libdir = paths['platlib']

            records = {}
            with zf.open(record_name) as bf:
                with CSVReader(stream=bf) as reader:
                    for row in reader:
                        p = row[0]
                        records[p] = row

            data_pfx = posixpath.join(data_dir, '')
            info_pfx = posixpath.join(info_dir, '')
            script_pfx = posixpath.join(data_dir, 'scripts', '')

            # make a new instance rather than a copy of maker's,
            # as we mutate it
            fileop = FileOperator(dry_run=dry_run)
            fileop.record = True    # so we can rollback if needed

            bc = not sys.dont_write_bytecode    # Double negatives. Lovely!

            outfiles = []   # for RECORD writing

            # for script copying/shebang processing
            workdir = tempfile.mkdtemp()
            # set target dir later
            # we default add_launchers to False, as the
            # Python Launcher should be used instead
            maker.source_dir = workdir
            maker.target_dir = None
            try:
                for zinfo in zf.infolist():
                    arcname = zinfo.filename
                    if isinstance(arcname, text_type):
                        u_arcname = arcname
                    else:
                        u_arcname = arcname.decode('utf-8')
                    if self.skip_entry(u_arcname):
                        continue
                    row = records[u_arcname]
                    if row[2] and str(zinfo.file_size) != row[2]:
                        raise DistlibException('size mismatch for '
                                               '%s' % u_arcname)
                    if row[1]:
                        kind, value = row[1].split('=', 1)
                        with zf.open(arcname) as bf:
                            data = bf.read()
                        _, digest = self.get_hash(data, kind)
                        if digest != value:
                            raise DistlibException('digest mismatch for '
                                                   '%s' % arcname)

                    if lib_only and u_arcname.startswith((info_pfx, data_pfx)):
                        logger.debug('lib_only: skipping %s', u_arcname)
                        continue
                    is_script = (u_arcname.startswith(script_pfx)
                                 and not u_arcname.endswith('.exe'))

                    if u_arcname.startswith(data_pfx):
                        _, where, rp = u_arcname.split('/', 2)
                        outfile = os.path.join(paths[where], convert_path(rp))
                    else:
                        # meant for site-packages.
                        if u_arcname in (wheel_metadata_name, record_name):
                            continue
                        outfile = os.path.join(libdir, convert_path(u_arcname))
                    if not is_script:
                        with zf.open(arcname) as bf:
                            fileop.copy_stream(bf, outfile)
                        outfiles.append(outfile)
                        # Double check the digest of the written file
                        if not dry_run and row[1]:
                            with open(outfile, 'rb') as bf:
                                data = bf.read()
                                _, newdigest = self.get_hash(data, kind)
                                if newdigest != digest:
                                    raise DistlibException('digest mismatch '
                                                           'on write for '
                                                           '%s' % outfile)
                        if bc and outfile.endswith('.py'):
                            try:
                                pyc = fileop.byte_compile(outfile,
                                                          hashed_invalidation=bc_hashed_invalidation)
                                outfiles.append(pyc)
                            except Exception:
                                # Don't give up if byte-compilation fails,
                                # but log it and perhaps warn the user
                                logger.warning('Byte-compilation failed',
                                               exc_info=True)
                    else:
                        fn = os.path.basename(convert_path(arcname))
                        workname = os.path.join(workdir, fn)
                        with zf.open(arcname) as bf:
                            fileop.copy_stream(bf, workname)

                        dn, fn = os.path.split(outfile)
                        maker.target_dir = dn
                        filenames = maker.make(fn)
                        fileop.set_executable_mode(filenames)
                        outfiles.extend(filenames)

                if lib_only:
                    logger.debug('lib_only: returning None')
                    dist = None
                else:
                    # Generate scripts

                    # Try to get pydist.json so we can see if there are
                    # any commands to generate. If this fails (e.g. because
                    # of a legacy wheel), log a warning but don't give up.
                    commands = None
                    file_version = self.info['Wheel-Version']
                    if file_version == '1.0':
                        # Use legacy info
                        ep = posixpath.join(info_dir, 'entry_points.txt')
                        try:
                            with zf.open(ep) as bwf:
                                epdata = read_exports(bwf)
                            commands = {}
                            for key in ('console', 'gui'):
                                k = '%s_scripts' % key
                                if k in epdata:
                                    commands['wrap_%s' % key] = d = {}
                                    for v in epdata[k].values():
                                        s = '%s:%s' % (v.prefix, v.suffix)
                                        if v.flags:
                                            s += ' %s' % v.flags
                                        d[v.name] = s
                        except Exception:
                            logger.warning('Unable to read legacy script '
                                           'metadata, so cannot generate '
                                           'scripts')
                    else:
                        try:
                            with zf.open(metadata_name) as bwf:
                                wf = wrapper(bwf)
                                commands = json.load(wf).get('extensions')
                                if commands:
                                    commands = commands.get('python.commands')
                        except Exception:
                            logger.warning('Unable to read JSON metadata, so '
                                           'cannot generate scripts')
                    if commands:
                        console_scripts = commands.get('wrap_console', {})
                        gui_scripts = commands.get('wrap_gui', {})
                        if console_scripts or gui_scripts:
                            script_dir = paths.get('scripts', '')
                            if not os.path.isdir(script_dir):
                                raise ValueError('Valid script path not '
                                                 'specified')
                            maker.target_dir = script_dir
                            for k, v in console_scripts.items():
                                script = '%s = %s' % (k, v)
                                filenames = maker.make(script)
                                fileop.set_executable_mode(filenames)

                            if gui_scripts:
                                options = {'gui': True }
                                for k, v in gui_scripts.items():
                                    script = '%s = %s' % (k, v)
                                    filenames = maker.make(script, options)
                                    fileop.set_executable_mode(filenames)

                    p = os.path.join(libdir, info_dir)
                    dist = InstalledDistribution(p)

                    # Write SHARED
                    paths = dict(paths)     # don't change passed in dict
                    del paths['purelib']
                    del paths['platlib']
                    paths['lib'] = libdir
                    p = dist.write_shared_locations(paths, dry_run)
                    if p:
                        outfiles.append(p)

                    # Write RECORD
                    dist.write_installed_files(outfiles, paths['prefix'],
                                               dry_run)
                return dist
            except Exception:  # pragma: no cover
                logger.exception('installation failed.')
                fileop.rollback()
                raise
            finally:
                shutil.rmtree(workdir)

    def _get_dylib_cache(self):
        global cache
        if cache is None:
            # Use native string to avoid issues on 2.x: see Python #20140.
            base = os.path.join(get_cache_base(), str('dylib-cache'),
                                sys.version[:3])
            cache = Cache(base)
        return cache

    def _get_extensions(self):
        pathname = os.path.join(self.dirname, self.filename)
        name_ver = '%s-%s' % (self.name, self.version)
        info_dir = '%s.dist-info' % name_ver
        arcname = posixpath.join(info_dir, 'EXTENSIONS')
        wrapper = codecs.getreader('utf-8')
        result = []
        with ZipFile(pathname, 'r') as zf:
            try:
                with zf.open(arcname) as bf:
                    wf = wrapper(bf)
                    extensions = json.load(wf)
                    cache = self._get_dylib_cache()
                    prefix = cache.prefix_to_dir(pathname)
                    cache_base = os.path.join(cache.base, prefix)
                    if not os.path.isdir(cache_base):
                        os.makedirs(cache_base)
                    for name, relpath in extensions.items():
                        dest = os.path.join(cache_base, convert_path(relpath))
                        if not os.path.exists(dest):
                            extract = True
                        else:
                            file_time = os.stat(dest).st_mtime
                            file_time = datetime.datetime.fromtimestamp(file_time)
                            info = zf.getinfo(relpath)
                            wheel_time = datetime.datetime(*info.date_time)
                            extract = wheel_time > file_time
                        if extract:
                            zf.extract(relpath, cache_base)
                        result.append((name, dest))
            except KeyError:
                pass
        return result

    def is_compatible(self):
        """
        Determine if a wheel is compatible with the running system.
        """
        return is_compatible(self)

    def is_mountable(self):
        """
        Determine if a wheel is asserted as mountable by its metadata.
        """
        return True # for now - metadata details TBD

    def mount(self, append=False):
        pathname = os.path.abspath(os.path.join(self.dirname, self.filename))
        if not self.is_compatible():
            msg = 'Wheel %s not compatible with this Python.' % pathname
            raise DistlibException(msg)
        if not self.is_mountable():
            msg = 'Wheel %s is marked as not mountable.' % pathname
            raise DistlibException(msg)
        if pathname in sys.path:
            logger.debug('%s already in path', pathname)
        else:
            if append:
                sys.path.append(pathname)
            else:
                sys.path.insert(0, pathname)
            extensions = self._get_extensions()
            if extensions:
                if _hook not in sys.meta_path:
                    sys.meta_path.append(_hook)
                _hook.add(pathname, extensions)

    def unmount(self):
        pathname = os.path.abspath(os.path.join(self.dirname, self.filename))
        if pathname not in sys.path:
            logger.debug('%s not in path', pathname)
        else:
            sys.path.remove(pathname)
            if pathname in _hook.impure_wheels:
                _hook.remove(pathname)
            if not _hook.impure_wheels:
                if _hook in sys.meta_path:
                    sys.meta_path.remove(_hook)

    def verify(self):
        pathname = os.path.join(self.dirname, self.filename)
        name_ver = '%s-%s' % (self.name, self.version)
        data_dir = '%s.data' % name_ver
        info_dir = '%s.dist-info' % name_ver

        metadata_name = posixpath.join(info_dir, METADATA_FILENAME)
        wheel_metadata_name = posixpath.join(info_dir, 'WHEEL')
        record_name = posixpath.join(info_dir, 'RECORD')

        wrapper = codecs.getreader('utf-8')

        with ZipFile(pathname, 'r') as zf:
            with zf.open(wheel_metadata_name) as bwf:
                wf = wrapper(bwf)
                message = message_from_file(wf)
            wv = message['Wheel-Version'].split('.', 1)
            file_version = tuple([int(i) for i in wv])
            # TODO version verification

            records = {}
            with zf.open(record_name) as bf:
                with CSVReader(stream=bf) as reader:
                    for row in reader:
                        p = row[0]
                        records[p] = row

            for zinfo in zf.infolist():
                arcname = zinfo.filename
                if isinstance(arcname, text_type):
                    u_arcname = arcname
                else:
                    u_arcname = arcname.decode('utf-8')
                # See issue #115: some wheels have .. in their entries, but
                # in the filename ... e.g. __main__..py ! So the check is
                # updated to look for .. in the directory portions
                p = u_arcname.split('/')
                if '..' in p:
                    raise DistlibException('invalid entry in '
                                           'wheel: %r' % u_arcname)

                if self.skip_entry(u_arcname):
                    continue
                row = records[u_arcname]
                if row[2] and str(zinfo.file_size) != row[2]:
                    raise DistlibException('size mismatch for '
                                           '%s' % u_arcname)
                if row[1]:
                    kind, value = row[1].split('=', 1)
                    with zf.open(arcname) as bf:
                        data = bf.read()
                    _, digest = self.get_hash(data, kind)
                    if digest != value:
                        raise DistlibException('digest mismatch for '
                                               '%s' % arcname)

    def update(self, modifier, dest_dir=None, **kwargs):
        """
        Update the contents of a wheel in a generic way. The modifier should
        be a callable which expects a dictionary argument: its keys are
        archive-entry paths, and its values are absolute filesystem paths
        where the contents the corresponding archive entries can be found. The
        modifier is free to change the contents of the files pointed to, add
        new entries and remove entries, before returning. This method will
        extract the entire contents of the wheel to a temporary location, call
        the modifier, and then use the passed (and possibly updated)
        dictionary to write a new wheel. If ``dest_dir`` is specified, the new
        wheel is written there -- otherwise, the original wheel is overwritten.

        The modifier should return True if it updated the wheel, else False.
        This method returns the same value the modifier returns.
        """

        def get_version(path_map, info_dir):
            version = path = None
            key = '%s/%s' % (info_dir, METADATA_FILENAME)
            if key not in path_map:
                key = '%s/PKG-INFO' % info_dir
            if key in path_map:
                path = path_map[key]
                version = Metadata(path=path).version
            return version, path

        def update_version(version, path):
            updated = None
            try:
                v = NormalizedVersion(version)
                i = version.find('-')
                if i < 0:
                    updated = '%s+1' % version
                else:
                    parts = [int(s) for s in version[i + 1:].split('.')]
                    parts[-1] += 1
                    updated = '%s+%s' % (version[:i],
                                         '.'.join(str(i) for i in parts))
            except UnsupportedVersionError:
                logger.debug('Cannot update non-compliant (PEP-440) '
                             'version %r', version)
            if updated:
                md = Metadata(path=path)
                md.version = updated
                legacy = not path.endswith(METADATA_FILENAME)
                md.write(path=path, legacy=legacy)
                logger.debug('Version updated from %r to %r', version,
                             updated)

        pathname = os.path.join(self.dirname, self.filename)
        name_ver = '%s-%s' % (self.name, self.version)
        info_dir = '%s.dist-info' % name_ver
        record_name = posixpath.join(info_dir, 'RECORD')
        with tempdir() as workdir:
            with ZipFile(pathname, 'r') as zf:
                path_map = {}
                for zinfo in zf.infolist():
                    arcname = zinfo.filename
                    if isinstance(arcname, text_type):
                        u_arcname = arcname
                    else:
                        u_arcname = arcname.decode('utf-8')
                    if u_arcname == record_name:
                        continue
                    if '..' in u_arcname:
                        raise DistlibException('invalid entry in '
                                               'wheel: %r' % u_arcname)
                    zf.extract(zinfo, workdir)
                    path = os.path.join(workdir, convert_path(u_arcname))
                    path_map[u_arcname] = path

            # Remember the version.
            original_version, _ = get_version(path_map, info_dir)
            # Files extracted. Call the modifier.
            modified = modifier(path_map, **kwargs)
            if modified:
                # Something changed - need to build a new wheel.
                current_version, path = get_version(path_map, info_dir)
                if current_version and (current_version == original_version):
                    # Add or update local version to signify changes.
                    update_version(current_version, path)
                # Decide where the new wheel goes.
                if dest_dir is None:
                    fd, newpath = tempfile.mkstemp(suffix='.whl',
                                                   prefix='wheel-update-',
                                                   dir=workdir)
                    os.close(fd)
                else:
                    if not os.path.isdir(dest_dir):
                        raise DistlibException('Not a directory: %r' % dest_dir)
                    newpath = os.path.join(dest_dir, self.filename)
                archive_paths = list(path_map.items())
                distinfo = os.path.join(workdir, info_dir)
                info = distinfo, info_dir
                self.write_records(info, workdir, archive_paths)
                self.build_zip(newpath, archive_paths)
                if dest_dir is None:
                    shutil.copyfile(newpath, pathname)
        return modified

def compatible_tags():
    """
    Return (pyver, abi, arch) tuples compatible with this Python.
    """
    versions = [VER_SUFFIX]
    major = VER_SUFFIX[0]
    for minor in range(sys.version_info[1] - 1, - 1, -1):
        versions.append(''.join([major, str(minor)]))

    abis = []
    for suffix, _, _ in imp.get_suffixes():
        if suffix.startswith('.abi'):
            abis.append(suffix.split('.', 2)[1])
    abis.sort()
    if ABI != 'none':
        abis.insert(0, ABI)
    abis.append('none')
    result = []

    arches = [ARCH]
    if sys.platform == 'darwin':
        m = re.match(r'(\w+)_(\d+)_(\d+)_(\w+)$', ARCH)
        if m:
            name, major, minor, arch = m.groups()
            minor = int(minor)
            matches = [arch]
            if arch in ('i386', 'ppc'):
                matches.append('fat')
            if arch in ('i386', 'ppc', 'x86_64'):
                matches.append('fat3')
            if arch in ('ppc64', 'x86_64'):
                matches.append('fat64')
            if arch in ('i386', 'x86_64'):
                matches.append('intel')
            if arch in ('i386', 'x86_64', 'intel', 'ppc', 'ppc64'):
                matches.append('universal')
            while minor >= 0:
                for match in matches:
                    s = '%s_%s_%s_%s' % (name, major, minor, match)
                    if s != ARCH:   # already there
                        arches.append(s)
                minor -= 1

    # Most specific - our Python version, ABI and arch
    for abi in abis:
        for arch in arches:
            result.append((''.join((IMP_PREFIX, versions[0])), abi, arch))

    # where no ABI / arch dependency, but IMP_PREFIX dependency
    for i, version in enumerate(versions):
        result.append((''.join((IMP_PREFIX, version)), 'none', 'any'))
        if i == 0:
            result.append((''.join((IMP_PREFIX, version[0])), 'none', 'any'))

    # no IMP_PREFIX, ABI or arch dependency
    for i, version in enumerate(versions):
        result.append((''.join(('py', version)), 'none', 'any'))
        if i == 0:
            result.append((''.join(('py', version[0])), 'none', 'any'))
    return set(result)


COMPATIBLE_TAGS = compatible_tags()

del compatible_tags


def is_compatible(wheel, tags=None):
    if not isinstance(wheel, Wheel):
        wheel = Wheel(wheel)    # assume it's a filename
    result = False
    if tags is None:
        tags = COMPATIBLE_TAGS
    for ver, abi, arch in tags:
        if ver in wheel.pyver and abi in wheel.abi and arch in wheel.arch:
            result = True
            break
    return result
site-packages/pip/_vendor/distlib/__pycache__/wheel.cpython-38.opt-1.pyc000064400000061544151446177000022064 0ustar00U

��.e���@s�ddlmZddlZddlZddlZddlZddlmZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlZddlZddlZddlmZmZddlmZmZmZmZmZddlmZddlm Z m!Z!m"Z"dd	l#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,dd
l-m.Z.m/Z/e�0e1�Z2da3e4ed��r8dZ5n*ej6�7d
��rLdZ5nej6dk�r^dZ5ndZ5e�8d�Z9e9�s�dej:dd�Z9de9Z;e5e9Z<ej#�=��>dd��>dd�Z?e�8d�Z@e@�r�e@�7d��r�e@�>dd�Z@ndd�ZAeA�Z@[Ae�BdejCejDB�ZEe�BdejCejDB�ZFe�Bd�ZGe�Bd �ZHd!ZId"ZJe
jKd#k�rBd$d%�ZLnd&d%�ZLGd'd(�d(eM�ZNeN�ZOGd)d*�d*eM�ZPd+d,�ZQeQ�ZR[Qd/d-d.�ZSdS)0�)�unicode_literalsN)�message_from_file�)�__version__�DistlibException)�	sysconfig�ZipFile�fsdecode�	text_type�filter)�InstalledDistribution)�Metadata�METADATA_FILENAME�WHEEL_METADATA_FILENAME)	�FileOperator�convert_path�	CSVReader�	CSVWriter�Cache�cached_property�get_cache_base�read_exports�tempdir)�NormalizedVersion�UnsupportedVersionErrorZpypy_version_infoZpp�javaZjyZcliZip�cpZpy_version_nodotz%s%s��py�-�_�.ZSOABIzcpython-cCsRdtg}t�d�r|�d�t�d�r0|�d�t�d�dkrH|�d�d	�|�S)
NrZPy_DEBUG�dZ
WITH_PYMALLOC�mZPy_UNICODE_SIZE��u�)�
VER_SUFFIXr�get_config_var�append�join)�parts�r,�=/usr/lib/python3.8/site-packages/pip/_vendor/distlib/wheel.py�_derive_abi;s




r.zz
(?P<nm>[^-]+)
-(?P<vn>\d+[^-]*)
(-(?P<bn>\d+[^-]*))?
-(?P<py>\w+\d+(\.\w+\d+)*)
-(?P<bi>\w+)
-(?P<ar>\w+(\.\w+)*)
\.whl$
z7
(?P<nm>[^-]+)
-(?P<vn>\d+[^-]*)
(-(?P<bn>\d+[^-]*))?$
s
\s*#![^\r\n]*s^(\s*#!("[^"]+"|\S+))\s+(.*)$s#!pythons	#!pythonw�/cCs|S�Nr,��or,r,r-�<lambda>]�r3cCs|�tjd�S)Nr/)�replace�os�sepr1r,r,r-r3_r4c@s6eZdZdd�Zdd�Zdd�Zddd	�Zd
d�ZdS)
�MountercCsi|_i|_dSr0)�
impure_wheels�libs��selfr,r,r-�__init__cszMounter.__init__cCs||j|<|j�|�dSr0)r9r:�update)r<�pathname�
extensionsr,r,r-�addgs
zMounter.addcCs0|j�|�}|D]\}}||jkr|j|=qdSr0)r9�popr:)r<r?r@�k�vr,r,r-�removeks
zMounter.removeNcCs||jkr|}nd}|Sr0)r:)r<�fullname�path�resultr,r,r-�find_moduleqs
zMounter.find_modulecCsj|tjkrtj|}nP||jkr,td|��t�||j|�}||_|�dd�}t|�dkrf|d|_	|S)Nzunable to find extension for %sr!rr)
�sys�modulesr:�ImportError�impZload_dynamic�
__loader__�rsplit�len�__package__)r<rFrHr+r,r,r-�load_modulexs


zMounter.load_module)N)�__name__�
__module__�__qualname__r=rArErIrRr,r,r,r-r8bs

r8c@s�eZdZdZdZdZd4dd�Zedd	��Zed
d��Z	edd
��Z
edd��Zdd�Z
edd��Zdd�Zd5dd�Zdd�Zdd�Zdd�Zd6dd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Zd*d+�Zd7d,d-�Zd.d/�Zd0d1�Zd8d2d3�ZdS)9�Wheelz@
    Class to build and install from Wheel files (PEP 427).
    �rrZsha256NFcCs8||_||_d|_tg|_dg|_dg|_t��|_	|dkrRd|_
d|_|j|_
n�t�|�}|r�|�d�}|d|_
|d�d	d
�|_|d|_|j|_
n�tj�|�\}}t�|�}|s�td|��|r�tj�|�|_	||_
|�d�}|d|_
|d|_|d|_|d
�d�|_|d�d�|_|d�d�|_dS)zB
        Initialise an instance using a (valid) filename.
        r&�none�anyNZdummyz0.1ZnmZvnr rZbnzInvalid name or filename: %rrr!ZbiZar)�signZ
should_verify�buildver�PYVER�pyver�abi�archr6�getcwd�dirname�name�version�filenameZ	_filename�NAME_VERSION_RE�match�	groupdictr5rG�split�FILENAME_REr�abspath)r<rdrZ�verifyr#�inforar,r,r-r=�sD







�



zWheel.__init__cCs^|jrd|j}nd}d�|j�}d�|j�}d�|j�}|j�dd�}d|j|||||fS)zJ
        Build and return a filename from the various components.
        rr&r!r z%s-%s%s-%s-%s-%s.whl)r[r*r]r^r_rcr5rb)r<r[r]r^r_rcr,r,r-rd�s
�zWheel.filenamecCstj�|j|j�}tj�|�Sr0)r6rGr*rard�isfile)r<rGr,r,r-�exists�szWheel.existsccs4|jD](}|jD]}|jD]}|||fVqqqdSr0)r]r^r_)r<r]r^r_r,r,r-�tags�s


z
Wheel.tagscCstj�|j|j�}d|j|jf}d|}t�d�}t	|d���}|�
|�}|d�dd�}tdd	�|D��}|d
kr�t
tdg}	nt
tg}	d}
|	D]f}zLt�||�}|�|��,}
||
�}t|d�}
|
r�W5QR�Wq�W5QRXWq�tk
r�Yq�Xq�|
�std
d�|	���W5QRX|
S)N�%s-%s�%s.dist-info�utf-8�r�
Wheel-Versionr!rcSsg|]}t|��qSr,��int��.0�ir,r,r-�
<listcomp>�sz"Wheel.metadata.<locals>.<listcomp>rWZMETADATA)Zfileobjz8Invalid wheel, because metadata is missing: looked in %sz, )r6rGr*rardrbrc�codecs�	getreaderr�get_wheel_metadatarh�tuplerr�	posixpath�openr
�KeyError�
ValueError)r<r?�name_ver�info_dir�wrapper�zf�wheel_metadata�wv�file_versionZfnsrH�fn�metadata_filename�bf�wfr,r,r-�metadata�s6


�zWheel.metadatac	CsXd|j|jf}d|}t�|d�}|�|��}t�d�|�}t|�}W5QRXt|�S)Nrprq�WHEELrr)	rbrcrr*r�r{r|r�dict)r<r�r�r�r�r�r��messager,r,r-r}�szWheel.get_wheel_metadatac	Cs6tj�|j|j�}t|d��}|�|�}W5QRX|S)Nrs)r6rGr*rardrr})r<r?r�rHr,r,r-rl�sz
Wheel.infocCs�t�|�}|r||��}|d|�||d�}}d|��krBt}nt}t�|�}|rfd|��d}nd}||}||}nT|�d�}|�d�}	|dks�||	kr�d}
n|||d�d	kr�d	}
nd}
t|
|}|S)
Nspythonw� ���r4�
�
rrs
)	�
SHEBANG_RErf�end�lower�SHEBANG_PYTHONW�SHEBANG_PYTHON�SHEBANG_DETAIL_RE�groups�find)r<�datar#r�ZshebangZdata_after_shebangZshebang_python�argsZcrZlfZtermr,r,r-�process_shebangs,




zWheel.process_shebangcCsh|dkr|j}ztt|�}Wn tk
r<td|��YnX||���}t�|��d��	d�}||fS)NzUnsupported hash algorithm: %r�=�ascii)
�	hash_kind�getattr�hashlib�AttributeErrorr�digest�base64Zurlsafe_b64encode�rstrip�decode)r<r�r��hasherrHr,r,r-�get_hash"szWheel.get_hashc	Cs^t|�}ttj�||��}|�|ddf�|��t|��}|D]}|�|�q@W5QRXdS)Nr&)	�list�to_posixr6rG�relpathr)�sortrZwriterow)r<�recordsZrecord_path�base�p�writer�rowr,r,r-�write_record-s
zWheel.write_recordc
Cs�g}|\}}tt|j�}|D]P\}}	t|	d��}
|
��}W5QRXd|�|�}tj�|	�}
|�	|||
f�qtj�
|d�}	|�||	|�ttj�
|d��}|�	||	f�dS)N�rbz%s=%s�RECORD)
r�r�r�r��readr�r6rG�getsizer)r*r�r�)r<rl�libdir�
archive_pathsr��distinfor�r��apr��fr�r��sizer,r,r-�
write_records6szWheel.write_recordsc	CsFt|dtj��.}|D]"\}}t�d||�|�||�qW5QRXdS)N�wzWrote %s to %s in wheel)r�zipfileZZIP_DEFLATED�logger�debug�write)r<r?r�r�r�r�r,r,r-�	build_zipFszWheel.build_zipc!sp|dkri}tt�fdd�d��d}|dkrFd}tg}tg}tg}nd}tg}d	g}d
g}|�d|�|_|�d|�|_|�d
|�|_	�|}	d|j
|jf}
d|
}d|
}g}
dD]�}|�kr�q��|}tj
�|�r�t�|�D]�\}}}|D]�}ttj
�||��}tj
�||�}ttj
�|||��}|
�||f�|dkr�|�d�s�t|d��}|��}W5QRX|�|�}t|d��}|�|�W5QRXq�q�q�|	}d}t�|�D]�\}}}||k�r�t|�D]8\}}t|�}|�d��r�tj
�||�}||=�q��q�|D]H}t|��d��r�qtj
�||�}ttj
�||��}|
�||f��q�q�t�|�}|D]B}|dk�r^ttj
�||��}ttj
�||��}|
�||f��q^d|�p�|jdtd|g}|jD] \}}}|�d|||f��q�tj
�|d�}t|d��}|�d�|��W5QRXttj
�|d��}|
�||f�|�||f|	|
�tj
�|j |j!�} |�"| |
�| S) z�
        Build a wheel from files in specified paths, and use any specified tags
        when determining the name of the wheel.
        Ncs|�kSr0r,r1��pathsr,r-r3Tr4zWheel.build.<locals>.<lambda>)�purelib�platlibrr�Zfalse�truerXrYr]r^r_rp�%s.datarq)r�Zheaders�scriptsr��.exer��wbz
.dist-info)z.pycz.pyo)r�Z	INSTALLERZSHAREDr�zWheel-Version: %d.%dzGenerator: distlib %szRoot-Is-Purelib: %sz
Tag: %s-%s-%sr�r��
)#r�r�IMPVER�ABI�ARCHr\�getr]r^r_rbrcr6rG�isdir�walkr	r*r�r�r)�endswithr�r�r�r��	enumerate�listdir�
wheel_versionrror�rardr�)!r<r�ror�ZlibkeyZis_pureZ
default_pyverZdefault_abiZdefault_archr�r��data_dirr�r��keyrG�root�dirs�filesr�r��rpr�r�r�r�ry�dnr�r]r^r_r?r,r�r-�buildLs�




�zWheel.buildcCs
|�d�S)zl
        Determine whether an archive entry should be skipped when verifying
        or installing.
        )r/z/RECORD.jws)r�)r<�arcnamer,r,r-�
skip_entry�szWheel.skip_entrycCKsf|j}|�d�}|�dd�}|�dd�}tj�|j|j�}d|j|jf}	d|	}
d|	}t	�|t
�}t	�|d�}
t	�|d	�}t�d
�}t
|d����}|�|
��}||�}t|�}W5QRX|d�d
d�}tdd�|D��}||jkr�|r�||j|�|ddk�r|d}n|d}i}|�|��8}t|d��"}|D]}|d}|||<�q8W5QRXW5QRXt	�|
d�}t	�|d�}t	�|
dd�}t|d�}d|_tj} g}!t��}"|"|_d|_�z��z\|��D�]�}#|#j}$t|$t ��r�|$}%n
|$�!d
�}%|�"|%��r�q�||%}|d�r4t#|#j$�|dk�r4t%d|%��|d�r�|d�dd�\}&}'|�|$��}|�&�}(W5QRX|�'|(|&�\})}*|*|'k�r�t%d|$��|�r�|%�(||f��r�t)�*d |%��q�|%�(|��o�|%�+d!�}+|%�(|��r
|%�d"d�\})},}-tj�||,t,|-��}.n$|%|
|fk�r�q�tj�|t,|%��}.|+�s
|�|$��}|�-||.�W5QRX|!�.|.�|�s�|d�r�t|.d#��4}|�&�}(|�'|(|&�\})}/|/|*k�r�t%d$|.��W5QRX| �r~|.�+d%��r~z|j/|.|d&�}0|!�.|0�Wn$t0k
�rt)j1d'dd(�YnXnttj�2t,|$��}1tj�|"|1�}2|�|$��}|�-||2�W5QRXtj�|.�\}3}1|3|_|�3|1�}4|�4|4�|!�5|4��q�|�r�t)�*d)�d}5�nnd}6|j6d}|d*k�rzt	�|d+�}7z�|�|7��}t7|�}8W5QRXi}6d,D]l}9d-|9}:|:|8k�r�i|6d.|9<};|8|:�8�D]6}<d/|<j9|<j:f}=|<j;�rB|=d0|<j;7}=|=|;|<j<�q�q�Wn t0k
�rvt)�1d1�YnXndzB|�|��.}||�}t<�=|��d2�}6|6�r�|6�d3�}6W5QRXWn t0k
�r�t)�1d4�YnX|6�r�|6�d5i�}>|6�d6i�}?|>�s|?�r�|�dd�}@tj�>|@��s*t?d7��|@|_|>�@�D]*\}:}<d8|:|<f}A|�3|A�}4|�4|4��q8|?�r�d9di}B|?�@�D],\}:}<d8|:|<f}A|�3|A|B�}4|�4|4��qztj�||�}tA|�}5tB|�}|d=|d=||d:<|5�C||�}|�r�|!�.|�|5�D|!|d;|�|5WW�<W5QR�St0k
�rFt)�Ed<�|�F��YnXW5t�|"�XW5QRXdS)=a~
        Install a wheel to the specified paths. If kwarg ``warner`` is
        specified, it should be a callable, which will be called with two
        tuples indicating the wheel version of this software and the wheel
        version in the file, if there is a discrepancy in the versions.
        This can be used to issue any warnings to raise any exceptions.
        If kwarg ``lib_only`` is True, only the purelib/platlib files are
        installed, and the headers, scripts, data and dist-info metadata are
        not written. If kwarg ``bytecode_hashed_invalidation`` is True, written
        bytecode will try to use file-hash based invalidation (PEP-552) on
        supported interpreter versions (CPython 2.7+).

        The return value is a :class:`InstalledDistribution` instance unless
        ``options.lib_only`` is True, in which case the return value is ``None``.
        �warner�lib_onlyFZbytecode_hashed_invalidationrpr�rqr�r�rrrsrtr!rcSsg|]}t|��qSr,rurwr,r,r-rz�sz!Wheel.install.<locals>.<listcomp>zRoot-Is-Purelibr�r�r���streamrr&r�)�dry_runTNr�size mismatch for %s�=�digest mismatch for %szlib_only: skipping %sr�r/r�zdigest mismatch on write for %sz.py)Zhashed_invalidationzByte-compilation failed)�exc_infozlib_only: returning Nonez1.0zentry_points.txt)Zconsole�guiz
%s_scriptszwrap_%sz%s:%sz %szAUnable to read legacy script metadata, so cannot generate scriptsr@zpython.commandsz8Unable to read JSON metadata, so cannot generate scriptsZwrap_consoleZwrap_guizValid script path not specifiedz%s = %sr��lib�prefixzinstallation failed.)Gr�r�r6rGr*rardrbrcrrr{r|rr�rrhr~r�rr�recordrJ�dont_write_bytecode�tempfileZmkdtempZ
source_dirZ
target_dir�shutilZrmtree�infolist�
isinstancer
r�r��str�	file_sizerr�r��
startswithr�r�r�rZcopy_streamr)Zbyte_compile�	ExceptionZwarning�basenameZmakeZset_executable_mode�extendrlr�valuesr��suffix�flags�json�loadr�r��itemsrr�Zwrite_shared_locationsZwrite_installed_filesZ	exceptionZrollback)Cr<r�Zmaker�kwargsr�r�r�Zbc_hashed_invalidationr?r�r�r��
metadata_name�wheel_metadata_name�record_namer�r��bwfr�r�r�r�r�r�r��readerr�r�Zdata_pfxZinfo_pfxZ
script_pfxZfileopZbcZoutfiles�workdir�zinfor��	u_arcname�kind�valuer�r r�Z	is_script�wherer�ZoutfileZ	newdigestZpycr�Zworknamer��	filenamesZdistZcommandsZepZepdatar�rCr"rD�sZconsole_scriptsZgui_scriptsZ
script_dirZscriptZoptionsr,r,r-�install�sT


 

�

�
�

���







�
z
Wheel.installcCs4tdkr0tj�t�td�tjdd��}t|�atS)Nzdylib-cache�)	�cacher6rGr*rr�rJrcr)r<r�r,r,r-�_get_dylib_cache�s�zWheel._get_dylib_cachec
Cshtj�|j|j�}d|j|jf}d|}t�|d�}t�	d�}g}t
|d���}z�|�|���}||�}	t�
|	�}
|��}|�|�}tj�|j|�}
tj�|
�s�t�|
�|
��D]�\}}tj�|
t|��}tj�|�s�d}n6t�|�j}tj�|�}|�|�}tj|j�}||k}|�r&|�||
�|�||f�q�W5QRXWntk
�rXYnXW5QRX|S)NrprqZ
EXTENSIONSrrrsT)r6rGr*rardrbrcrr{r|rr�rrrZ
prefix_to_dirr�r��makedirsrrrn�stat�st_mtime�datetimeZ
fromtimestampZgetinfoZ	date_time�extractr)r�)r<r?r�r�r�r�rHr�r�r�r@rr�Z
cache_baserbr��destrZ	file_timerlZ
wheel_timer,r,r-�_get_extensions�s>




zWheel._get_extensionscCst|�S)zM
        Determine if a wheel is compatible with the running system.
        )�
is_compatibler;r,r,r-r�szWheel.is_compatiblecCsdS)zP
        Determine if a wheel is asserted as mountable by its metadata.
        Tr,r;r,r,r-�is_mountable�szWheel.is_mountablecCs�tj�tj�|j|j��}|��s2d|}t|��|��sJd|}t|��|t	jkrbt
�d|�nN|rtt	j�|�nt	j�
d|�|��}|r�tt	jkr�t	j�t�t�||�dS)Nz)Wheel %s not compatible with this Python.z$Wheel %s is marked as not mountable.z%s already in pathr)r6rGrjr*rardrrrrJr�r�r)�insertr�_hook�	meta_pathrA)r<r)r?�msgr@r,r,r-�mount�s"

zWheel.mountcCsrtj�tj�|j|j��}|tjkr2t�d|�n<tj�	|�|t
jkrRt
�	|�t
jsnt
tjkrntj�	t
�dS)Nz%s not in path)
r6rGrjr*rardrJr�r�rEr r9r!)r<r?r,r,r-�unmount�s



z
Wheel.unmountcCstj�|j|j�}d|j|jf}d|}d|}t�|t�}t�|d�}t�|d�}t	�
d�}t|d����}	|	�|��}
||
�}t
|�}W5QRX|d�d	d
�}
tdd�|
D��}i}|	�|��6}t|d
�� }|D]}|d}|||<q�W5QRXW5QRX|	��D]�}|j}t|t��r$|}n
|�d�}|�d�}d|k�rNtd|��|�|��r^�q||}|d�r�t|j�|dk�r�td|��|d
�r|d
�dd
�\}}|	�|��}|��}W5QRX|�||�\}}||k�rtd|���qW5QRXdS)Nrpr�rqr�r�rrrsrtr!rcSsg|]}t|��qSr,rurwr,r,r-rzsz Wheel.verify.<locals>.<listcomp>r�rr/�..�invalid entry in wheel: %rrr�r�r�)r6rGr*rardrbrcrrr{r|rr�rrhr~rr�r�r
r�rr�r�r�r�r�)r<r?r�r�r�rrrr�r�rr�r�r�r�r�r�r	r�r�rr�rr
rr�r r�r,r,r-rks\



��

�zWheel.verifyc
Ks�dd�}dd�}tj�|j|j�}d|j|jf}d|}t�|d�}	t����}
t	|d��|}i}|�
�D]h}
|
j}t|t�r�|}n
|�
d	�}||	kr�qhd
|kr�td|��|�|
|
�tj�|
t|��}|||<qhW5QRX|||�\}}||f|�}|�r�|||�\}}|�r$||k�r$|||�|dk�rNtjd
d|
d�\}}t�|�n*tj�|��shtd|��tj�||j�}t|���}tj�|
|�}||f}|�||
|�|�||�|dk�r�t�||�W5QRX|S)a�
        Update the contents of a wheel in a generic way. The modifier should
        be a callable which expects a dictionary argument: its keys are
        archive-entry paths, and its values are absolute filesystem paths
        where the contents the corresponding archive entries can be found. The
        modifier is free to change the contents of the files pointed to, add
        new entries and remove entries, before returning. This method will
        extract the entire contents of the wheel to a temporary location, call
        the modifier, and then use the passed (and possibly updated)
        dictionary to write a new wheel. If ``dest_dir`` is specified, the new
        wheel is written there -- otherwise, the original wheel is overwritten.

        The modifier should return True if it updated the wheel, else False.
        This method returns the same value the modifier returns.
        cSsHd}}d|tf}||kr$d|}||kr@||}t|d�j}||fS)Nz%s/%sz%s/PKG-INFO�rG)rr
rc)�path_mapr�rcrGr�r,r,r-�get_versionKsz!Wheel.update.<locals>.get_versioncSs�d}z|t|�}|�d�}|dkr*d|}nTdd�||dd��d�D�}|dd7<d	|d|�d�d
d�|D��f}Wn tk
r�t�d|�YnX|r�t|d
�}||_|�	t
�}|j||d�t�d||�dS)Nrrz%s+1cSsg|]}t|��qSr,ru)rxrr,r,r-rz]sz8Wheel.update.<locals>.update_version.<locals>.<listcomp>rr!r�z%s+%scss|]}t|�VqdSr0)r�rwr,r,r-�	<genexpr>`sz7Wheel.update.<locals>.update_version.<locals>.<genexpr>z0Cannot update non-compliant (PEP-440) version %rr')rG�legacyzVersion updated from %r to %r)rr�rhr*rr�r�r
rcr�rr�)rcrG�updatedrDryr+Zmdr+r,r,r-�update_versionUs.

 �
�

�z$Wheel.update.<locals>.update_versionrprqr�rsrrr%r&Nz.whlz
wheel-update-)r�r��dirzNot a directory: %r)r6rGr*rardrbrcrrrr�r�r
r�rrrr�Zmkstemp�closer�r�rr�r�r�Zcopyfile)r<ZmodifierZdest_dirrr)r-r?r�r�rr
r�r(rr�rrGZoriginal_versionr ZmodifiedZcurrent_version�fd�newpathr�r�rlr,r,r-r>:s\



�

�

zWheel.update)NFF)N)NN)F)N)rSrTrU�__doc__r�r�r=�propertyrdrnrorr�r}rlr�r�r�r�r�r�r�rrrrrr#r$rkr>r,r,r,r-rV�s@
)



	

	
hg	"
8rVc	Csxtg}td}ttjdddd�D]}|�d�|t|�g��q$g}t��D]*\}}}|�	d�rN|�|�
dd�d�qN|��tdkr�|�
dt�|�d�g}tg}tjd	k�r�t�d
t�}|�r�|��\}	}}}
t|�}|
g}|
dkr�|�d�|
d
k�r|�d�|
dk�r |�d�|
dk�r4|�d�|
dk�rH|�d�|dk�r�|D]*}d|	|||f}
|
tk�rV|�|
��qV|d8}�qH|D]0}|D]$}
|�d�t|df�||
f��q��q�t|�D]L\}}|�d�t|f�ddf�|dk�r�|�d�t|df�ddf��q�t|�D]L\}}|�d�d|f�ddf�|dk�r"|�d�d|df�ddf��q"t|�S)zG
    Return (pyver, abi, arch) tuples compatible with this Python.
    rrr�r&z.abir!rrX�darwinz(\w+)_(\d+)_(\d+)_(\w+)$)�i386�ppcZfat)r5r6�x86_64Zfat3)�ppc64r7Zfat64)r5r7�intel)r5r7r9r6r8Z	universalz%s_%s_%s_%srYr)r'�rangerJ�version_infor)r*r�rMZget_suffixesr�rhr�r�rr��platform�rerfr�rv�
IMP_PREFIXr��set)Zversions�major�minorZabisr�r rHZarchesr#rbr_Zmatchesrfrr^ryrcr,r,r-�compatible_tags�s`












&
"
"rBcCs\t|t�st|�}d}|dkr"t}|D]0\}}}||jkr&||jkr&||jkr&d}qXq&|S)NFT)r�rV�COMPATIBLE_TAGSr]r^r_)ZwheelrorHZverr^r_r,r,r-r�s
r)N)TZ
__future__rr�r{rZdistutils.utilZ	distutilsZemailrr�rMrZloggingr6rr=r�rJr�r�r&rr�compatrrr	r
rZdatabaserr�r
rr�utilrrrrrrrrrrcrrZ	getLoggerrSr�r�hasattrr>r<r�r(r'r;r\r�Zget_platformr5r�r�r.�compile�
IGNORECASE�VERBOSErirer�r�r�r�r7r��objectr8r rVrBrCrr,r,r,r-�<module>s�,


	
�

�


#>site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-38.opt-1.pyc000064400000002004151446177000022501 0ustar00U

��.eK�@snddlZdZGdd�de�ZzddlmZWn&ek
rRGdd�dej�ZYnXe�e�Z	e	�
e��dS)�Nz0.2.9.post0c@seZdZdS)�DistlibExceptionN)�__name__�
__module__�__qualname__�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/__init__.pyrsr)�NullHandlerc@s$eZdZdd�Zdd�Zdd�ZdS)rcCsdS�Nr��self�recordrrr�handle�zNullHandler.handlecCsdSr	rr
rrr�emitrzNullHandler.emitcCs
d|_dSr	)�lock)rrrr�
createLockrzNullHandler.createLockN)rrrr
rrrrrrrsr)Zlogging�__version__�	Exceptionrr�ImportErrorZHandlerZ	getLoggerrZloggerZ
addHandlerrrrr�<module>s
site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-38.opt-1.pyc000064400000112527151446177000022604 0ustar00U

��.e_��@sDddlZddlmZddlZddlZddlZddlZddlZzddlZWne	k
rdddl
ZYnXddlZddlm
Z
ddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZddlm Z m!Z!m"Z"ddl#m$Z$m%Z%ddl&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/dd	l0m1Z1m2Z2dd
l3m4Z4m5Z5e�6e7�Z8e�9d�Z:e�9dej;�Z<e�9d
�Z=dZ>d-dd�Z?Gdd�de�Z@Gdd�deA�ZBGdd�deB�ZCGdd�deB�ZDGdd�deA�ZEGdd�deB�ZFGdd�deB�ZGGdd �d eB�ZHGd!d"�d"eB�ZIGd#d$�d$eB�ZJeJeH�eFd%d&d'�d(d)�ZKeKjLZLe�9d*�ZMGd+d,�d,eA�ZNdS).�N)�BytesIO�)�DistlibException)�urljoin�urlparse�
urlunparse�url2pathname�pathname2url�queue�quote�unescape�string_types�build_opener�HTTPRedirectHandler�	text_type�Request�	HTTPError�URLError)�Distribution�DistributionPath�	make_dist)�Metadata�MetadataInvalidError)	�cached_property�parse_credentials�ensure_slash�split_filename�get_project_data�parse_requirement�parse_name_and_version�ServerProxy�normalize_name)�
get_scheme�UnsupportedVersionError)�Wheel�
is_compatiblez^(\w+)=([a-f0-9]+)z;\s*charset\s*=\s*(.*)\s*$ztext/html|application/x(ht)?mlzhttps://pypi.org/pypicCs6|dkrt}t|dd�}z|��W�S|d��XdS)z�
    Return all distribution names known by an index.
    :param url: The URL of the index.
    :return: A list of all known distribution names.
    N�@��timeout�close)�
DEFAULT_INDEXr �
list_packages)�url�client�r.�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/locators.py�get_all_distribution_names)sr0c@s$eZdZdZdd�ZeZZZdS)�RedirectHandlerzE
    A class to work around a bug in some Python 3.2.x releases.
    c	Cs�d}dD]}||kr||}q"q|dkr.dSt|�}|jdkrnt|��|�}t|d�rf|�||�n|||<t�||||||�S)N)�locationZuri��replace_header)r�schemerZget_full_url�hasattrr4�BaseRedirectHandler�http_error_302)	�self�req�fp�code�msg�headersZnewurl�keyZurlpartsr.r.r/r8@s 

�zRedirectHandler.http_error_302N)�__name__�
__module__�__qualname__�__doc__r8Zhttp_error_301Zhttp_error_303Zhttp_error_307r.r.r.r/r17sr1c@s�eZdZdZdZdZdZdZedZd)dd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
dd�Zee
e�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd*d'd(�ZdS)+�LocatorzG
    A base class for locators - things that locate distributions.
    )z.tar.gzz.tar.bz2z.tarz.zipz.tgzz.tbz)z.eggz.exe�.whl)z.pdfN)rE�defaultcCs,i|_||_tt��|_d|_t��|_dS)a^
        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.
        N)	�_cacher5rr1�opener�matcherr
�Queue�errors)r9r5r.r.r/�__init__fs
zLocator.__init__cCsVg}|j��sRz|j�d�}|�|�Wn|jjk
rDYqYnX|j��q|S)z8
        Return any errors which have occurred.
        F)rK�empty�get�appendZEmpty�	task_done)r9�result�er.r.r/�
get_errorsys

zLocator.get_errorscCs|��dS)z>
        Clear any errors which may have been logged.
        N)rS�r9r.r.r/�clear_errors�szLocator.clear_errorscCs|j��dS�N)rG�clearrTr.r.r/�clear_cache�szLocator.clear_cachecCs|jSrV��_schemerTr.r.r/�_get_scheme�szLocator._get_schemecCs
||_dSrVrY)r9�valuer.r.r/�_set_scheme�szLocator._set_schemecCstd��dS)a=
        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.
        � Please implement in the subclassN��NotImplementedError)r9�namer.r.r/�_get_project�s
zLocator._get_projectcCstd��dS)�J
        Return all the distribution names known to this locator.
        r^Nr_rTr.r.r/�get_distribution_names�szLocator.get_distribution_namescCsL|jdkr|�|�}n2||jkr,|j|}n|��|�|�}||j|<|S)z�
        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.
        N)rGrbrU)r9rarQr.r.r/�get_project�s



zLocator.get_projectcCs^t|�}t�|j�}d}|�d�}|�|j�}|rBtt|�|j�}|j	dkd|j
k||||fS)zu
        Give an url a score which can be used to choose preferred URLs
        for a given project release.
        TrE�httpszpypi.org)r�	posixpath�basename�path�endswith�downloadable_extensionsr%r$�
wheel_tagsr5�netloc)r9r,�trhZ
compatibleZis_wheelZis_downloadabler.r.r/�	score_url�s
�zLocator.score_urlcCsR|}|rN|�|�}|�|�}||kr(|}||kr@t�d||�nt�d||�|S)a{
        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.
        zNot replacing %r with %rzReplacing %r with %r)ro�logger�debug)r9�url1�url2rQ�s1�s2r.r.r/�
prefer_url�s


zLocator.prefer_urlcCs
t||�S)zZ
        Attempt to split a filename in project name, version and Python version.
        )r)r9�filename�project_namer.r.r/r�szLocator.split_filenamecCsdd�}d}t|�\}}}}}	}
|
���d�r<t�d||
�t�|
�}|rX|��\}}
nd\}}
|}|r�|ddkr�|dd�}|�d	��r>z~t	|�}t
||j�s�t�d
|�nX|dkr�d}n||j|�}|�r|j|j
|jt|||||	df�d
�dd�|jD��d�}Wn0tk
�r:}zt�d|�W5d}~XYnXn�|�|j��sZt�d|�n�t�|�}}|jD]�}|�|��rn|dt|��}|�||�}|�s�t�d|�nH|\}}}|�r�|||��r�|||t|||||	df�d�}|�r�||d<�q�qn|�r|�r|
|d|<|S)a
        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.
        cSst|�t|�kSrV)r!)Zname1Zname2r.r.r/�same_project�sz:Locator.convert_url_to_download_info.<locals>.same_projectNzegg=z %s: version hint in fragment: %r)NN����/rEzWheel not compatible: %sTr3z, cSs"g|]}d�t|dd����qS)�.�N)�join�list)�.0�vr.r.r/�
<listcomp>sz8Locator.convert_url_to_download_info.<locals>.<listcomp>)ra�versionrwr,�python-versionzinvalid path for wheel: %szNot downloadable: %sz No match for project/version: %s)rar�rwr,r��	%s_digest)r�lower�
startswithrprq�HASHER_HASH�match�groupsrjr$r%rlrar�rwrr~�pyver�	Exception�warningrkrgrh�lenr)r9r,rxryrQr5rmri�params�query�frag�m�algo�digestZorigpath�wheelZincluderRrwZextrnrar�r�r.r.r/�convert_url_to_download_info�s��
���
	 

��
z$Locator.convert_url_to_download_infocCs2d}dD]$}d|}||kr|||f}q.q|S)z�
        Get a digest from a dictionary by looking at keys of the form
        'algo_digest'.

        Returns a 2-tuple (algo, digest) if found, else None. Currently
        looks only for SHA256, then MD5.
        N)Zsha256�md5r�r.)r9�inforQr�r?r.r.r/�_get_digest1szLocator._get_digestc	Cs�|�d�}|�d�}||kr,||}|j}nt|||jd�}|j}|�|�|_}|d}||d|<|j|dkr�|�|j|�|_|d�|t	���
|�||_|||<dS)z�
        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.
        rar��r5r,�digests�urlsN)�pop�metadatarr5r�r��
source_urlrv�
setdefault�set�add�locator)	r9rQr�rar��dist�mdr�r,r.r.r/�_update_version_dataAs

zLocator._update_version_dataFc	Cs�d}t|�}|dkr td|��t|j�}|�|j�|_}t�d|t|�j	�|�
|j�}t|�dk�r2g}|j
}	|D]z}
|
dkr�qxzH|�|
�s�t�d||
�n*|s�|	|
�js�|�|
�nt�d|
|j�Wqxtk
r�t�d||
�YqxXqxt|�d	k�rt||jd
�}|�r2t�d|�|d}||}|�r�|j�rH|j|_|�d
i��|t��|_i}|�di�}
|jD]}||
k�rv|
|||<�qv||_d|_|S)a
        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.
        NzNot a valid requirement: %rzmatcher: %s (%s)r}�r�r�z%s did not match %rz%skipping pre-release version %s of %szerror matching %s with %rr)r?zsorted list: %srzr�r�)rrr"r5rI�requirementrprq�typer@rerar�Z
version_classr�Z
is_prereleaserOr�r��sortedr?ZextrasrNr��
download_urlsr�)r9r��prereleasesrQ�rr5rI�versionsZslistZvcls�kr��dZsdr,r.r.r/�locateXsX


�

zLocator.locate)rF)F)r@rArBrC�source_extensions�binary_extensions�excluded_extensionsrlrkrLrSrUrXr[r]�propertyr5rbrdrerorvrr�r�r�r�r.r.r.r/rDVs.

JrDcs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�PyPIRPCLocatorz�
    This locator uses XML-RPC to locate distributions. It therefore
    cannot be used with simple mirrors (that only mirror file content).
    cs*tt|�jf|�||_t|dd�|_dS)z�
        Initialise an instance.

        :param url: The URL to use for XML-RPC.
        :param kwargs: Passed to the superclass constructor.
        r&r'N)�superr�rL�base_urlr r-�r9r,�kwargs��	__class__r.r/rL�szPyPIRPCLocator.__init__cCst|j���S�rc)r�r-r+rTr.r.r/rd�sz%PyPIRPCLocator.get_distribution_namescCsiid�}|j�|d�}|D]�}|j�||�}|j�||�}t|jd�}|d|_|d|_|�d�|_	|�dg�|_
|�d�|_t|�}|r|d	}	|	d
|_
|�|	�|_||_|||<|D]:}	|	d
}
|�|	�}|d�|t���|
�||d|
<q�q|S)
Nr�Tr�rar��license�keywords�summaryrr,r�r�)r-Zpackage_releasesZrelease_urlsZrelease_datarr5rar�rNr�r�r�rr�r�r�r�r�r�r�)r9rarQr�r�r��datar�r�r�r,r�r.r.r/rb�s0




zPyPIRPCLocator._get_project�r@rArBrCrLrdrb�
__classcell__r.r.r�r/r��sr�cs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�PyPIJSONLocatorzw
    This locator uses PyPI's JSON interface. It's very limited in functionality
    and probably not worth using.
    cs tt|�jf|�t|�|_dSrV)r�r�rLrr�r�r�r.r/rL�szPyPIJSONLocator.__init__cCstd��dS�rczNot available from this locatorNr_rTr.r.r/rd�sz&PyPIJSONLocator.get_distribution_namesc
Cs
iid�}t|jdt|��}�z�|j�|�}|����}t�|�}t	|j
d�}|d}|d|_|d|_|�
d�|_|�
dg�|_|�
d	�|_t|�}||_|d
}	|||j<|d
D]T}
|
d}|j�|�|�|
�|j|<|d
�|jt���|�|�|
�|d|<q�|d
��D]�\}}||jk�r4�qt	|j
d�}
|j|
_||
_t|
�}||_|||<|D]T}
|
d}|j�|�|�|
�|j|<|d
�|t���|�|�|
�|d|<�qh�qWn@tk
�r}z |j�t|��t�d|�W5d}~XYnX|S)Nr�z%s/jsonr�r�rar�r�r�r�r�r,r�ZreleaseszJSON fetch failed: %s) rr�rrH�open�read�decode�json�loadsrr5rar�rNr�r�r�rr�r�r�r�r�r�r��itemsr�rK�putrrp�	exception)r9rarQr,�respr�r�r�r�r�r�r�ZinfosZomd�odistrRr.r.r/rb�sT




	zPyPIJSONLocator._get_projectr�r.r.r�r/r��sr�c@s`eZdZdZe�dejejBejB�Z	e�dejejB�Z
dd�Ze�dej�Ze
dd��Zd	S)
�Pagez4
    This class represents a scraped HTML page.
    z�
(rel\s*=\s*(?:"(?P<rel1>[^"]*)"|'(?P<rel2>[^']*)'|(?P<rel3>[^>\s
]*))\s+)?
href\s*=\s*(?:"(?P<url1>[^"]*)"|'(?P<url2>[^']*)'|(?P<url3>[^>\s
]*))
(\s+rel\s*=\s*(?:"(?P<rel4>[^"]*)"|'(?P<rel5>[^']*)'|(?P<rel6>[^>\s
]*)))?
z!<base\s+href\s*=\s*['"]?([^'">]+)cCs4||_||_|_|j�|j�}|r0|�d�|_dS)zk
        Initialise an instance with the Unicode page contents and the URL they
        came from.
        rN)r�r�r,�_base�search�group)r9r�r,r�r.r.r/rLs
z
Page.__init__z[^a-z0-9$&+,/:;=?@.#%_\\|-]cCs�dd�}t�}|j�|j�D]�}|�d�}|dpX|dpX|dpX|dpX|dpX|d	}|d
pp|dpp|d}t|j|�}t|�}|j�	d
d�|�}|�
||f�qt|dd�dd�}|S)z�
        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.
        cSs,t|�\}}}}}}t||t|�|||f�S)zTidy up an URL.)rrr)r,r5rmrir�r�r�r.r.r/�clean-s�zPage.links.<locals>.cleanr3Zrel1Zrel2Zrel3Zrel4Zrel5Zrel6rrrsZurl3cSsdt|�d��S)Nz%%%2xr)�ordr�)r�r.r.r/�<lambda>;�zPage.links.<locals>.<lambda>cSs|dS)Nrr.)rnr.r.r/r�?r�T)r?�reverse)r��_href�finditerr��	groupdictrr�r�	_clean_re�subr�r�)r9r�rQr�r��relr,r.r.r/�links&s$
���z
Page.linksN)r@rArBrC�re�compile�I�S�Xr�r�rLr�rr�r.r.r.r/r�	s�r�cs�eZdZdZejdd�dd�d�Zd�fdd	�	Zd
d�Zdd
�Z	dd�Z
e�dej
�Zdd�Zdd�Zdd�Zdd�Zdd�Ze�d�Zdd�Z�ZS)�SimpleScrapingLocatorz�
    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.
    cCstjtt�d���S)N)Zfileobj)�gzipZGzipFilerr�r���br.r.r/r�Mr�zSimpleScrapingLocator.<lambda>cCs|SrVr.r�r.r.r/r�Nr�)Zdeflater�ZnoneN�
csltt|�jf|�t|�|_||_i|_t�|_t	�
�|_t�|_d|_
||_t��|_t��|_d|_dS)a�
        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.
        FN)r�r�rLrr�r(�_page_cacher��_seenr
rJ�	_to_fetch�
_bad_hosts�skip_externals�num_workers�	threading�RLock�_lock�_gplock�platform_check)r9r,r(r�r�r�r.r/rLQs




zSimpleScrapingLocator.__init__cCsFg|_t|j�D]0}tj|jd�}|�d�|��|j�|�qdS)z�
        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).
        )�targetTN)	�_threads�ranger�r�ZThread�_fetchZ	setDaemon�startrO)r9�irnr.r.r/�_prepare_threadsls
z&SimpleScrapingLocator._prepare_threadscCs6|jD]}|j�d�q|jD]}|��qg|_dS)zu
        Tell all the threads to terminate (by sending a sentinel value) and
        wait for them to do so.
        N)r�r�r�r~)r9rnr.r.r/�
_wait_threadsys



z#SimpleScrapingLocator._wait_threadsc	Cs�iid�}|j�x||_||_t|jdt|��}|j��|j��|�	�z&t�d|�|j
�|�|j
��W5|�
�X|`W5QRX|S)Nr�z%s/zQueueing %s)r�rQrxrr�rr�rWr�r�r�rprqr�r�r~)r9rarQr,r.r.r/rb�s



z"SimpleScrapingLocator._get_projectz<\b(linux_(i\d86|x86_64|arm\w+)|win(32|_amd64)|macosx_?\d+)\bcCs|j�|�S)zD
        Does an URL refer to a platform-specific download?
        )�platform_dependentr�)r9r,r.r.r/�_is_platform_dependent�sz,SimpleScrapingLocator._is_platform_dependentc	CsZ|jr|�|�rd}n|�||j�}t�d||�|rV|j�|�|j|�W5QRX|S)a%
        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.
        Nzprocess_download: %s -> %s)	r�r�r�rxrprqr�r�rQ)r9r,r�r.r.r/�_process_download�s
z'SimpleScrapingLocator._process_downloadc
Cs�t|�\}}}}}}|�|j|j|j�r2d}n||jrJ|�|j�sJd}nd|�|j�s\d}nR|dkrjd}nD|dkrxd}n6|�|�r�d}n&|�	dd�d}	|	�
�dkr�d}nd}t�d	||||�|S)
z�
        Determine whether a link URL from a referring page and with a
        particular "rel" attribute should be queued for scraping.
        F)ZhomepageZdownload)ZhttprfZftp�:rrZ	localhostTz#should_queue: %s (%s) from %s -> %s)
rrjr�r�r�r�r�r�r��splitr�rprq)
r9�linkZreferrerr�r5rmri�_rQ�hostr.r.r/�
_should_queue�s0�

�z#SimpleScrapingLocator._should_queuec
Cs�|j��}z�z�|r�|�|�}|dkr,WW��q|jD]j\}}||jkr2zB|j�|�|�|�s�|�|||�r�t	�
d||�|j�|�Wq2tk
r�Yq2Xq2Wn2t
k
r�}z|j�t|��W5d}~XYnXW5|j��X|sq�qdS)z�
        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.
        NzQueueing %s from %s)r�rNrP�get_pager�r�r�r�rrprqr�rr�rKr)r9r,�pagerr�rRr.r.r/r��s,



�&zSimpleScrapingLocator._fetchcCsXt|�\}}}}}}|dkr:tj�t|��r:tt|�d�}||jkr`|j|}t�	d||��n�|�
dd�d}d}||jkr�t�	d||��n�t|d	d
id�}�z�z�t�	d|�|j
j||jd
�}	t�	d|�|	��}
|
�dd�}t�|��r�|	��}|	��}
|
�d�}|�r"|j|}||
�}
d}t�|�}|�r@|�d�}z|
�|�}
Wn tk
�rn|
�d�}
YnXt|
|�}||j|<Wn�tk
�r�}z|jdk�r�t�d||�W5d}~XYn�t k
�r}z0t�d||�|j!�|j�"|�W5QRXW5d}~XYn2t#k
�rB}zt�d||�W5d}~XYnXW5||j|<X|S)a
        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).
        �filez
index.htmlzReturning %s from cache: %srrrNzSkipping %s due to bad host %szAccept-encodingZidentity)r>zFetching %sr'z
Fetched %szContent-Typer3zContent-Encodingzutf-8zlatin-1i�zFetch failed: %s: %s)$r�osri�isdirrrrr�rprqrr�rrHr�r(r�rN�HTML_CONTENT_TYPEr�Zgeturlr��decoders�CHARSETr�r�r��UnicodeErrorr�rr<r�rr�r�r�)r9r,r5rmrirrQrr:r�r>Zcontent_typeZ	final_urlr��encoding�decoderr�rRr.r.r/r�sZ	







&$zSimpleScrapingLocator.get_pagez<a href=[^>]*>([^<]+)<cCsLt�}|�|j�}|s$td|j��|j�|j�D]}|�|�d��q2|S)rczUnable to get %sr)	r�rr�r�_distname_rer�r�r�r�)r9rQrr�r.r.r/rd0sz,SimpleScrapingLocator.get_distribution_names)Nr�)r@rArBrC�zlib�
decompressrrLr�r�rbr�r�r�r�r�r�rr�rrrdr�r.r.r�r/r�Cs&�

�!;
r�cs8eZdZdZ�fdd�Zdd�Zdd�Zdd	�Z�ZS)
�DirectoryLocatorz?
    This class locates distributions in a directory tree.
    csN|�dd�|_tt|�jf|�tj�|�}tj�|�sDt	d|��||_
dS)a�
        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,
        �	recursiveTzNot a directory: %rN)r�rr�rrLr	ri�abspathr
r�base_dir)r9rir�r�r.r/rLAs
zDirectoryLocator.__init__cCs|�|j�S)z�
        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.
        )rjrk)r9rw�parentr.r.r/�should_includeRszDirectoryLocator.should_includec		Cs�iid�}t�|j�D]t\}}}|D]Z}|�||�r$tj�||�}tddttj�|��dddf�}|�	||�}|r$|�
||�q$|jsq�q|S)Nr�rr3)r	�walkrrrir~rr	rr�r�r)	r9rarQ�root�dirs�files�fnr,r�r.r.r/rbZs"
�zDirectoryLocator._get_projectc	Cs�t�}t�|j�D]v\}}}|D]\}|�||�r tj�||�}tddttj�	|��dddf�}|�
|d�}|r |�|d�q |jsq�q|S)rcrr3Nra)
r�r	rrrrir~rr	rr�r�r)r9rQrrrrr,r�r.r.r/rdjs"�z'DirectoryLocator.get_distribution_names)	r@rArBrCrLrrbrdr�r.r.r�r/r<s
rc@s eZdZdZdd�Zdd�ZdS)�JSONLocatora
    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.
    cCstd��dSr�r_rTr.r.r/rd�sz"JSONLocator.get_distribution_namescCs�iid�}t|�}|r�|�dg�D]�}|ddks"|ddkr@q"t|d|d|�d	d
�|jd�}|j}|d|_d
|kr�|d
r�d|d
f|_|�di�|_|�di�|_|||j	<|d�
|j	t���|d�q"|S)Nr�rZptypeZsdistZ	pyversion�sourcerar�r�zPlaceholder for summary)r�r5r,r�r�Zrequirements�exportsr�)
rrNrr5r�r�r�Zdependenciesr!r�r�r�r�)r9rarQr�r�r�r�r.r.r/rb�s*
��

 zJSONLocator._get_projectN)r@rArBrCrdrbr.r.r.r/r}srcs(eZdZdZ�fdd�Zdd�Z�ZS)�DistPathLocatorz�
    This locator finds installed distributions in a path. It can be useful for
    adding to an :class:`AggregatingLocator`.
    cstt|�jf|�||_dS)zs
        Initialise an instance.

        :param distpath: A :class:`DistributionPath` instance to search.
        N)r�r"rL�distpath)r9r#r�r�r.r/rL�szDistPathLocator.__init__cCsP|j�|�}|dkr iid�}n,|j|d|jt|jg�id|jtdg�ii}|S)Nr�r�r�)r#Zget_distributionr�r�r�)r9rar�rQr.r.r/rb�s�zDistPathLocator._get_project)r@rArBrCrLrbr�r.r.r�r/r"�s
r"csReZdZdZ�fdd�Z�fdd�Zdd�Zeej	j
e�Z	dd	�Zd
d�Z�Z
S)�AggregatingLocatorzI
    This class allows you to chain and/or merge a list of locators.
    cs*|�dd�|_||_tt|�jf|�dS)a�
        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).
        �mergeFN)r�r%�locatorsr�r$rL)r9r&r�r�r.r/rL�szAggregatingLocator.__init__cs&tt|���|jD]}|��qdSrV)r�r$rXr&�r9r�r�r.r/rX�s
zAggregatingLocator.clear_cachecCs||_|jD]
}||_qdSrV)rZr&r5)r9r\r�r.r.r/r]�s
zAggregatingLocator._set_schemecCs�i}|jD]�}|�|�}|r
|jr�|�di�}|�di�}|�|�|�d�}|r�|r�|��D]*\}}	||kr�|||	O<q^|	||<q^|�d�}
|r�|
r�|
�|�q
|jdkr�d}n"d}|D]}|j�|�r�d}q�q�|r
|}q�q
|S)Nr�r�TF)r&rer%rN�updater�rIr�)r9rarQr�r�rr�Zdfr�r�Zdd�foundr.r.r/rb�s8






zAggregatingLocator._get_projectc	Cs<t�}|jD]*}z||��O}Wqtk
r4YqXq|Sr�)r�r&rdr`)r9rQr�r.r.r/rds
z)AggregatingLocator.get_distribution_names)r@rArBrCrLrXr]r�rDr5�fgetrbrdr�r.r.r�r/r$�s,r$zhttps://pypi.org/simple/r&r'�legacyr�z1(?P<name>[\w-]+)\s*\(\s*(==\s*)?(?P<ver>[^)]+)\)$c@sLeZdZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	ddd�Z
dS)�DependencyFinderz0
    Locate dependencies for distributions.
    NcCs|pt|_t|jj�|_dS)zf
        Initialise an instance, using the specified locator
        to locate distributions.
        N)�default_locatorr�r"r5r'r.r.r/rL*s
zDependencyFinder.__init__cCsrt�d|�|j}||j|<||j||jf<|jD]:}t|�\}}t�d|||�|j�	|t
���||f�q2dS)z�
        Add a distribution to the finder. This will update internal information
        about who provides what.
        :param dist: The distribution to add.
        zadding distribution %szAdd to provided: %s, %s, %sN)rprqr?�
dists_by_name�distsr��providesr�providedr�r�r�)r9r�ra�pr�r.r.r/�add_distribution2s

z!DependencyFinder.add_distributioncCsxt�d|�|j}|j|=|j||jf=|jD]D}t|�\}}t�d|||�|j|}|�	||f�|s.|j|=q.dS)z�
        Remove a distribution from the finder. This will update internal
        information about who provides what.
        :param dist: The distribution to remove.
        zremoving distribution %sz Remove from provided: %s, %s, %sN)
rprqr?r.r/r�r0rr1�remove)r9r�rar2r��sr.r.r/�remove_distributionAs

z$DependencyFinder.remove_distributioncCsBz|j�|�}Wn,tk
r<|��d}|j�|�}YnX|S)z�
        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`).
        r)r5rIr#r)r9�reqtrIrar.r.r/�get_matcherSszDependencyFinder.get_matcherc		Cst|�|�}|j}t�}|j}||krp||D]B\}}z|�|�}Wntk
rZd}YnX|r,|�|�qpq,|S)z�
        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.
        F)r8r?r�r1r�r#r�)	r9r7rIrarQr1r��providerr�r.r.r/�find_providerscs


zDependencyFinder.find_providersc	Cs�|j|}t�}|D]$}|�|�}|�|j�s|�|�q|rZ|�d||t|�f�d}n@|�|�|j|=|D]}|j�|t���|�qp|�	|�d}|S)a�
        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.
        ZcantreplaceFT)
�reqtsr�r8r�r�r��	frozensetr6r�r3)	r9r9�other�problemsZrlistZ	unmatchedr5rIrQr.r.r/�try_to_replace{s$


�

zDependencyFinder.try_to_replaceFcCs�i|_i|_i|_i|_t|p g�}d|krH|�d�|tdddg�O}t|t�rh|}}t�	d|�n4|j
j||d�}}|dkr�td|��t�	d	|�d
|_
t�}t|g�}t|g�}|�r�|��}|j}	|	|jkr�|�|�n"|j|	}
|
|k�r|�||
|�|j|jB}|j}t�}
|�r`||k�r`dD]*}d|}||k�r4|
t|d
|�O}
�q4||B|
B}|D�].}|�|�}|�sFt�	d|�|j
j||d�}|dk�r�|�s�|j
j|d
d�}|dk�r�t�	d|�|�d|f�n^|j|j}}||f|jk�r|�|�|�|�||k�rF||k�rF|�|�t�	d|j�|D]R}|j}	|	|jk�rx|j�|t���|�n"|j|	}
|
|k�rJ|�||
|��qJ�qpq�t|j���}|D]&}||k|_|j�r�t�	d|j��q�t�	d|�||fS)a�
        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.
        z:*:z:test:z:build:z:dev:zpassed %s as requirement)r�NzUnable to locate %rz
located %sT)ZtestZbuildZdevz:%s:z%s_requireszNo providers found for %rzCannot satisfy %rZunsatisfiedzAdding %s to install_distsz#%s is a build-time dependency only.zfind done for %s)r1r/r.r;r�r4�
isinstancerrprqr�r�rZ	requestedr�r?r3r?Zrun_requiresZ
meta_requiresZbuild_requires�getattrr:r�r�Zname_and_versionr��valuesZbuild_time_dependency)r9r�Zmeta_extrasr�r�r�r>ZtodoZ
install_distsrar=ZireqtsZsreqtsZereqtsr?rRZ	all_reqtsr�Z	providersr9�nr�r2r/r.r.r/�find�s�

�












�


�zDependencyFinder.find)N)NF)r@rArBrCrLr3r6r8r:r?rDr.r.r.r/r,%s
(r,)N)Or��iorr�Zloggingr	rgr�r��ImportErrorZdummy_threadingrr3r�compatrrrrr	r
rrr
rrr7rrrrZdatabaserrrr�rr�utilrrrrrrrr r!r�r"r#r�r$r%Z	getLoggerr@rpr�r�r�r
rr*r0r1�objectrDr�r�r�r�rrr"r$r-r�ZNAME_VERSION_REr,r.r.r.r/�<module>s^D,



@0E:zA&[��
site-packages/pip/_vendor/distlib/__pycache__/resources.cpython-38.opt-1.pyc000064400000025334151446177000022767 0ustar00U

��.e*�	@s�ddlmZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
mZmZmZmZe�e�ZdaGdd�de�ZGdd	�d	e�ZGd
d�de�ZGdd
�d
e�ZGdd�de�ZGdd�de�Zed�ee
jeiZzFzddl Z!Wne"k
�r$ddl#Z!YnXeee!j$<eee!j%<[!Wne"e&fk
�rXYnXdd�Z'iZ(dd�Z)e	�*e+d��Z,dd�Z-dS)�)�unicode_literalsN�)�DistlibException)�cached_property�get_cache_base�path_to_cache_dir�Cachecs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�
ResourceCacheNcs0|dkrtj�t�td��}tt|��|�dS)Nzresource-cache)�os�path�joinr�str�superr	�__init__)�self�base��	__class__��A/usr/lib/python3.8/site-packages/pip/_vendor/distlib/resources.pyrszResourceCache.__init__cCsdS)z�
        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.
        Tr�r�resourcerrrr�is_stale#s	zResourceCache.is_stalec	Cs�|j�|�\}}|dkr|}n~tj�|j|�|�|�}tj�|�}tj�|�sXt�	|�tj�
|�sjd}n|�||�}|r�t|d��}|�
|j�W5QRX|S)z�
        Get a resource into the cache,

        :param resource: A :class:`Resource` instance.
        :return: The pathname of the resource in the cache.
        NT�wb)�finder�get_cache_infor
rrrZ
prefix_to_dir�dirname�isdir�makedirs�existsr�open�write�bytes)rr�prefixr�resultrZstale�frrr�get.s
zResourceCache.get)N)�__name__�
__module__�__qualname__rrr&�
__classcell__rrrrr	sr	c@seZdZdd�ZdS)�ResourceBasecCs||_||_dS�N)r�name)rrr-rrrrIszResourceBase.__init__N)r'r(r)rrrrrr+Hsr+c@s@eZdZdZdZdd�Zedd��Zedd��Zed	d
��Z	dS)�Resourcez�
    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.
    FcCs|j�|�S)z�
        Get the resource as a stream.

        This is not a property to make it obvious that it returns a new stream
        each time.
        )r�
get_stream�rrrr�	as_streamVszResource.as_streamcCstdkrt�at�|�Sr,)�cacher	r&r0rrr�	file_path_szResource.file_pathcCs|j�|�Sr,)r�	get_bytesr0rrrr"fszResource.bytescCs|j�|�Sr,)r�get_sizer0rrr�sizejsz
Resource.sizeN)
r'r(r)�__doc__�is_containerr1rr3r"r6rrrrr.Ns	

r.c@seZdZdZedd��ZdS)�ResourceContainerTcCs|j�|�Sr,)r�
get_resourcesr0rrr�	resourcesrszResourceContainer.resourcesN)r'r(r)r8rr;rrrrr9osr9c@s�eZdZdZej�d�rdZndZdd�Zdd�Z	d	d
�Z
dd�Zd
d�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zeejj�Zdd�ZdS)�ResourceFinderz4
    Resource finder for file system resources.
    �java)�.pyc�.pyoz.class)r>r?cCs.||_t|dd�|_tj�t|dd��|_dS)N�
__loader__�__file__�)�module�getattr�loaderr
rrr)rrCrrrr�szResourceFinder.__init__cCstj�|�Sr,)r
r�realpath�rrrrr�_adjust_path�szResourceFinder._adjust_pathcCsBt|t�rd}nd}|�|�}|�d|j�tjj|�}|�|�S)N�/�/r)	�
isinstancer"�split�insertrr
rrrH)r�
resource_name�sep�partsr$rrr�
_make_path�s

zResourceFinder._make_pathcCstj�|�Sr,)r
rrrGrrr�_find�szResourceFinder._findcCs
d|jfSr,)r�rrrrrr�szResourceFinder.get_cache_infocCsD|�|�}|�|�sd}n&|�|�r0t||�}n
t||�}||_|Sr,)rQrR�
_is_directoryr9r.r)rrNrr$rrr�find�s



zResourceFinder.findcCst|jd�S�N�rb)r rrSrrrr/�szResourceFinder.get_streamc
Cs,t|jd��}|��W5QR�SQRXdSrV)r r�read)rrr%rrrr4�szResourceFinder.get_bytescCstj�|j�Sr,)r
r�getsizerSrrrr5�szResourceFinder.get_sizecs*�fdd��t�fdd�t�|j�D��S)Ncs|dko|��j�S)N�__pycache__)�endswith�skipped_extensions)r%r0rr�allowed�s
�z-ResourceFinder.get_resources.<locals>.allowedcsg|]}�|�r|�qSrr)�.0r%)r]rr�
<listcomp>�sz0ResourceFinder.get_resources.<locals>.<listcomp>)�setr
�listdirrrSr)r]rrr:�szResourceFinder.get_resourcescCs|�|j�Sr,)rTrrSrrrr8�szResourceFinder.is_containerccs�|�|�}|dk	r�|g}|r�|�d�}|V|jr|j}|jD]>}|sL|}nd�||g�}|�|�}|jrv|�|�q>|Vq>qdS)NrrJ)rU�popr8r-r;r�append)rrNrZtodoZrnamer-�new_nameZchildrrr�iterator�s 



zResourceFinder.iteratorN)r'r(r)r7�sys�platform�
startswithr\rrHrQrRrrUr/r4r5r:r8�staticmethodr
rrrTrerrrrr<ws"r<cs`eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�Z�Z
S)�ZipResourceFinderz6
    Resource finder for resources in .zip files.
    csZtt|��|�|jj}dt|�|_t|jd�r>|jj|_nt	j
||_t|j�|_dS)Nr�_files)
rrjrrE�archive�len�
prefix_len�hasattrrk�	zipimport�_zip_directory_cache�sorted�index)rrCrlrrrr�szZipResourceFinder.__init__cCs|Sr,rrGrrrrH�szZipResourceFinder._adjust_pathcCs�||jd�}||jkrd}nX|r:|dtjkr:|tj}t�|j|�}z|j|�|�}Wntk
rtd}YnX|s�t�	d||j
j�nt�	d||j
j�|S)NT���Fz_find failed: %r %rz_find worked: %r %r)rnrkr
rO�bisectrsrh�
IndexError�logger�debugrEr#)rrr$�irrrrR�s


zZipResourceFinder._findcCs&|jj}|jdt|�d�}||fS)Nr)rErlrrm)rrr#rrrrr�sz ZipResourceFinder.get_cache_infocCs|j�|j�Sr,)rE�get_datarrSrrrr4�szZipResourceFinder.get_bytescCst�|�|��Sr,)�io�BytesIOr4rSrrrr/�szZipResourceFinder.get_streamcCs|j|jd�}|j|dS)N�)rrnrkrrrrr5szZipResourceFinder.get_sizecCs�|j|jd�}|r,|dtjkr,|tj7}t|�}t�}t�|j|�}|t|j�kr�|j|�|�shq�|j||d�}|�	|�
tjd�d�|d7}qH|S)Nrtrr)rrnr
rOrmr`rursrh�addrL)rrrZplenr$ry�srrrr:s

zZipResourceFinder.get_resourcescCsj||jd�}|r*|dtjkr*|tj7}t�|j|�}z|j|�|�}Wntk
rdd}YnX|S)NrtF)rnr
rOrursrhrv)rrryr$rrrrTs

zZipResourceFinder._is_directory)r'r(r)r7rrHrRrr4r/r5r:rTr*rrrrrj�srjcCs|tt|�<dSr,)�_finder_registry�type)rE�finder_makerrrr�register_finder0sr�cCs�|tkrt|}nv|tjkr$t|�tj|}t|dd�}|dkrJtd��t|dd�}t�t|��}|dkrxtd|��||�}|t|<|S)z�
    Return a resource finder for a package.
    :param package: The name of the package.
    :return: A :class:`ResourceFinder` instance for the package.
    �__path__Nz8You cannot get a finder for a module, only for a packager@zUnable to locate finder for %r)	�
_finder_cacherf�modules�
__import__rDrr�r&r�)�packager$rCrrEr�rrrr6s


rZ	__dummy__cCsRd}t�|�tj�|�}t�t|��}|rNt}tj	�
|d�|_||_||�}|S)z�
    Return a resource finder for a path, which should represent a container.

    :param path: The path.
    :return: A :class:`ResourceFinder` instance for the path.
    NrB)
�pkgutilZget_importerrf�path_importer_cacher&r�r��
_dummy_moduler
rrrAr@)rr$rErrCrrr�finder_for_pathRs
r�).Z
__future__rrur{Zloggingr
r�Zshutilrf�typesrprBr�utilrrrrZ	getLoggerr'rwr2r	�objectr+r.r9r<rjr��zipimporterr��_frozen_importlib_externalZ_fi�ImportError�_frozen_importlib�SourceFileLoader�
FileFinder�AttributeErrorr�r�r�
ModuleTyper
r�r�rrrr�<module>sN
,!ZN�

site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-38.pyc000064400000063760151446177000021603 0ustar00U

��.e*��@sdZddlmZddlZddlmZddlZddlZddlZddl	m
Z
mZddlm
Z
mZmZddlmZdd	lmZmZdd
lmZmZe�e�ZGdd�de
�ZGd
d�de
�ZGdd�de
�ZGdd�de
�ZdddgZdZ dZ!e�"d�Z#e�"d�Z$dZ%dZ&dZ'dZ(dZ)dZ*d Z+e*d!Z,d"Z-e.�Z/e/�0e%�e/�0e&�e/�0e(�e/�0e*�e/�0e,�e�"d#�Z1d$d%�Z2d&d'�Z3d(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdF�Z4dGZ5dHZ6dIZ7dJZ8dKZ9dLZ:dMZ;e<�Z=e�"dN�Z>dXdPdQ�Z?GdRdS�dSe<�Z@dTZAdUZBdVZCGdWd�de<�ZDdS)YzImplementation of the Metadata for Python packages PEPs.

Supports all metadata formats (1.0, 1.1, 1.2, and 2.0 experimental).
�)�unicode_literalsN)�message_from_file�)�DistlibException�__version__)�StringIO�string_types�	text_type)�	interpret)�extract_by_key�
get_extras)�
get_scheme�PEP440_VERSION_REc@seZdZdZdS)�MetadataMissingErrorzA required metadata is missingN��__name__�
__module__�__qualname__�__doc__�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/metadata.pyrsrc@seZdZdZdS)�MetadataConflictErrorz>Attempt to read or write metadata fields that are conflictual.Nrrrrrr src@seZdZdZdS)� MetadataUnrecognizedVersionErrorz Unknown metadata version number.Nrrrrrr$src@seZdZdZdS)�MetadataInvalidErrorzA metadata value is invalidNrrrrrr(sr�Metadata�PKG_INFO_ENCODING�PKG_INFO_PREFERRED_VERSION�utf-8�1.1z

       \|�	
        )�Metadata-Version�Name�Version�Platform�Summary�Description�Keywords�	Home-page�Author�Author-email�License)r r!r"r#�Supported-Platformr$r%r&r'r(r)r*�
Classifier�Download-URL�	Obsoletes�Provides�Requires)r.r/r0r,r-)r r!r"r#r+r$r%r&r'r(r)�
Maintainer�Maintainer-emailr*r,r-�Obsoletes-Dist�Project-URL�
Provides-Dist�
Requires-Dist�Requires-Python�Requires-External)r5r6r7r3r8r1r2r4)r r!r"r#r+r$r%r&r'r(r)r1r2r*r,r-r3r4r5r6r7r8�Private-Version�Obsoleted-By�Setup-Requires-Dist�	Extension�Provides-Extra)r9r=r:r;r<)�Description-Content-Typer0r/)r>z"extra\s*==\s*("([^"]+)"|'([^']+)')cCsL|dkrtS|dkrtS|dkr$tS|dkr4ttS|dkr@tSt|��dS)N�1.0r�1.2)�1.3�2.1�2.0)�_241_FIELDS�_314_FIELDS�_345_FIELDS�_566_FIELDS�_426_FIELDSr)�versionrrr�_version2fieldlistpsrJc
CsBdd�}g}|��D]"\}}|gddfkr,q|�|�qddddd	d
g}|D]�}|tkrvd|krv|�d�t�d|�|tkr�d|kr�|�d�t�d|�|tkr�d|kr�|�d�t�d
|�|tkr�d|kr�|�d�t�d|�|tk�rd
|k�r|dk�r|�d
�t�d|�|t	krLd	|krL|�d	�t�d|�qLt
|�dk�rZ|dSt
|�dk�r|t�d|�td��d|k�o�||t�}d|k�o�||t
�}d
|k�o�||t�}d	|k�o�||t�}	t|�t|�t|�t|	�dk�r�td��|�s |�s |�s |	�s t|k�r tS|�r*dS|�r4dS|�r>d
Sd	S)z5Detect the best version depending on the fields used.cSs|D]}||krdSqdS)NTFr)�keys�markers�markerrrr�_has_marker�sz"_best_version.<locals>._has_marker�UNKNOWNNr?rr@rArCrBzRemoved 1.0 due to %szRemoved 1.1 due to %szRemoved 1.2 due to %szRemoved 1.3 due to %sr%zRemoved 2.1 due to %szRemoved 2.0 due to %srrz)Out of options - unknown metadata set: %szUnknown metadata setz,You used incompatible 1.1/1.2/2.0/2.1 fields)�items�appendrD�remove�logger�debugrErFrGrH�lenr�_314_MARKERS�_345_MARKERS�_566_MARKERS�_426_MARKERS�intr)
�fieldsrNrK�key�valueZpossible_versionsZis_1_1Zis_1_2Zis_2_1Zis_2_0rrr�
_best_version~s`






&
r^r r!r"r#r+r$r%r&r'r(r)r1r2r*r,r-r3r5r6r;r7r8r0r/r.r4r9r:r<r=)�metadata_version�namerI�platformZsupported_platform�summary�description�keywords�	home_page�author�author_email�
maintainer�maintainer_email�license�
classifier�download_url�obsoletes_dist�
provides_dist�
requires_dist�setup_requires_dist�requires_python�requires_external�requires�provides�	obsoletes�project_urlZprivate_versionZobsoleted_by�	extensionZprovides_extra)r6r3r5)r7)r")r#r,r.r0r/r3r5r6r8r4r+r;r=r<)r4)r&)r(r1r$r%z[^A-Za-z0-9.]+FcCs0|r$t�d|�}t�d|�dd��}d||fS)zhReturn the distribution name with version.

    If for_filename is true, return a filename-escaped form.�-� �.z%s-%s)�	_FILESAFE�sub�replace)r`rIZfor_filenamerrr�_get_name_and_version�sr~c@s
eZdZdZd?dd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zd@dd�Zdd�Zdd �Zd!d"�Zd#d$�ZdAd%d&�ZdBd'd(�ZdCd)d*�Zd+d,�Zefd-d.�ZdDd/d0�ZdEd1d2�Zd3d4�Zd5d6�Zd7d8�Zd9d:�Zd;d<�Z d=d>�Z!dS)F�LegacyMetadataaaThe legacy metadata of a release.

    Supports versions 1.0, 1.1 and 1.2 (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
    N�defaultcCsz|||g�d�dkrtd��i|_g|_d|_||_|dk	rH|�|�n.|dk	r\|�|�n|dk	rv|�|�|�	�dS)N��'path, fileobj and mapping are exclusive)
�count�	TypeError�_fieldsZrequires_filesZ
_dependencies�scheme�read�	read_file�update�set_metadata_version)�self�path�fileobj�mappingr�rrr�__init__s
zLegacyMetadata.__init__cCst|j�|jd<dS�Nr )r^r��r�rrrr�"sz#LegacyMetadata.set_metadata_versioncCs|�d||f�dS)Nz%s: %s
)�write)r�r�r`r]rrr�_write_field%szLegacyMetadata._write_fieldcCs
|�|�S�N)�get�r�r`rrr�__getitem__(szLegacyMetadata.__getitem__cCs|�||�Sr�)�set)r�r`r]rrr�__setitem__+szLegacyMetadata.__setitem__cCs8|�|�}z|j|=Wntk
r2t|��YnXdSr�)�
_convert_namer��KeyError)r�r`�
field_namerrr�__delitem__.s

zLegacyMetadata.__delitem__cCs||jkp|�|�|jkSr�)r�r�r�rrr�__contains__5s
�zLegacyMetadata.__contains__cCs(|tkr|S|�dd���}t�||�S)Nrx�_)�_ALL_FIELDSr}�lower�_ATTR2FIELDr�r�rrrr�9szLegacyMetadata._convert_namecCs|tks|tkrgSdS)NrO)�_LISTFIELDS�_ELEMENTSFIELDr�rrr�_default_value?szLegacyMetadata._default_valuecCs&|jdkrt�d|�St�d|�SdS)N�r?r�
)r_�_LINE_PREFIX_PRE_1_2r|�_LINE_PREFIX_1_2�r�r]rrr�_remove_line_prefixDs
z"LegacyMetadata._remove_line_prefixcCs|tkr||St|��dSr�)r��AttributeErrorr�rrr�__getattr__JszLegacyMetadata.__getattr__FcCst|d|d|�S)zhReturn the distribution name with version.

        If filesafe is true, return a filename-escaped form.r!r")r~)r�Zfilesaferrr�get_fullnameUszLegacyMetadata.get_fullnamecCs|�|�}|tkS)z+return True if name is a valid metadata key)r�r�r�rrr�is_field[s
zLegacyMetadata.is_fieldcCs|�|�}|tkSr�)r�r�r�rrr�is_multi_field`s
zLegacyMetadata.is_multi_fieldcCs.tj|ddd�}z|�|�W5|��XdS)z*Read the metadata values from a file path.�rr��encodingN)�codecs�open�closer�)r��filepath�fprrrr�dszLegacyMetadata.readcCs�t|�}|d|jd<tD]p}||kr(q|tkrf|�|�}|tkrX|dk	rXdd�|D�}|�||�q||}|dk	r|dkr|�||�qdS)z,Read the metadata values from a file object.zmetadata-versionr NcSsg|]}t|�d���qS��,)�tuple�split��.0r]rrr�
<listcomp>ysz,LegacyMetadata.read_file.<locals>.<listcomp>rO)rr�r�r�Zget_all�_LISTTUPLEFIELDSr�)r�Zfileob�msg�field�valuesr]rrrr�ls
zLegacyMetadata.read_filecCs0tj|ddd�}z|�||�W5|��XdS)z&Write the metadata fields to filepath.�wrr�N)r�r�r��
write_file)r�r��skip_unknownr�rrrr��szLegacyMetadata.writecCs�|��t|d�D]�}|�|�}|r8|dgdgfkr8q|tkrV|�||d�|��q|tkr�|dkr�|jdkr~|�dd�}n|�dd�}|g}|t	kr�d	d
�|D�}|D]}|�|||�q�qdS)z0Write the PKG-INFO format data to a file object.r rOr�r%r�r�rz	
       |cSsg|]}d�|��qSr���joinr�rrrr��sz-LegacyMetadata.write_file.<locals>.<listcomp>N)
r�rJr�r�r�r�r�r_r}r�)r�Z
fileobjectr�r�r�r]rrrr��s$

zLegacyMetadata.write_filecsv�fdd�}|sn@t|d�r:|��D]}||||�q$n|D]\}}|||�q>|rr|��D]\}}|||�q^dS)a�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.
        cs"|tkr|r����|�|�dSr�)r�r�r�)r\r]r�rr�_set�sz#LegacyMetadata.update.<locals>._setrKN)�hasattrrKrP)r��other�kwargsr��k�vrr�rr��s

zLegacyMetadata.updatecCsh|�|�}|tks|dkrNt|ttf�sNt|t�rHdd�|�d�D�}qzg}n,|tkrzt|ttf�szt|t�rv|g}ng}t�	t
j��r<|d}t|j
�}|tkr�|dk	r�|D](}|�|�d�d�s�t�d	|||�q�nb|tk�r|dk	�r|�|��s<t�d
|||�n0|tk�r<|dk	�r<|�|��s<t�d
|||�|tk�rZ|dk�rZ|�|�}||j|<dS)z"Control then set a metadata field.r#cSsg|]}|���qSr)�strip)r�r�rrrr��sz&LegacyMetadata.set.<locals>.<listcomp>r�r!N�;rz$'%s': '%s' is not valid (field '%s')z.'%s': '%s' is not a valid version (field '%s')r%)r�r��
isinstance�listr�rr�r�rSZisEnabledFor�loggingZWARNINGr
r��_PREDICATE_FIELDS�is_valid_matcher�warning�_VERSIONS_FIELDS�is_valid_constraint_list�_VERSION_FIELDS�is_valid_version�_UNICODEFIELDSr�r�)r�r`r]Zproject_namer�r�rrrr��sV
�
�

���


zLegacyMetadata.setcCs�|�|�}||jkr*|tkr&|�|�}|S|tkr@|j|}|S|tkr�|j|}|dkr^gSg}|D].}|tkr~|�|�qf|�|d|df�qf|S|tkr�|j|}t	|t
�r�|�d�S|j|S)zGet a metadata field.Nrrr�)r�r��_MISSINGr�r�r�r�rQr�r�rr�)r�r`r�r]�res�valrrrr��s.







zLegacyMetadata.getcs�|��gg}}dD]}||kr|�|�q|rP|gkrPdd�|�}t|��dD]}||krT|�|�qT|ddkr�||fSt|j���fdd�}t|ft�jft	�j
ffD]@\}}|D]2}	|�|	d	�}
|
d	k	r�||
�s�|�d
|	|
f�q�q�||fS)zkCheck if the metadata is compliant. If strict is True then raise if
        no Name or Version are provided)r!r"zmissing required metadata: %s�, )r'r(r r@cs(|D]}��|�d�d�sdSqdS)Nr�rFT)r�r�)r]r��r�rr�are_valid_constraints#sz3LegacyMetadata.check.<locals>.are_valid_constraintsNzWrong value for '%s': %s)r�rQr�rr
r�r�r�r�r�r�r�)r��strict�missing�warnings�attrr�r�r[Z
controllerr�r]rr�r�check	s8

���zLegacyMetadata.checkcCs�|��d}i}|D]"\}}|r*||jkr||||<q|ddkr�d}|D]B\}}|rb||jkrL|dkrx||||<qLdd�||D�||<qLn8|ddkr�d	}|D]"\}}|r�||jkr�||||<q�|S)
z�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).
        )
)r_r )r`r!)rIr")rbr$)rer')rfr()rgr))rjr*)rcr%)rdr&)rar#)�classifiersr,)rlr-r r@))ror6)rqr7)rrr8)rnr5)rmr3)rvr4)rhr1)rir2rvcSsg|]}d�|��qSr�r�)r��urrrr�bsz)LegacyMetadata.todict.<locals>.<listcomp>r))rtr/)rsr0)rur.)r�r�)r�Zskip_missingZmapping_1_0�datar\r�Zmapping_1_2Zmapping_1_1rrr�todict5s&
zLegacyMetadata.todictcCs8|ddkr$dD]}||kr||=q|d|7<dS)Nr r)r.r0r/r6r)r��requirementsr�rrr�add_requirementsps
zLegacyMetadata.add_requirementscCstt|d��Sr�)r�rJr�rrrrK{szLegacyMetadata.keysccs|��D]
}|VqdSr��rK)r�r\rrr�__iter__~szLegacyMetadata.__iter__cs�fdd����D�S)Ncsg|]}�|�qSrr�r�r\r�rrr��sz)LegacyMetadata.values.<locals>.<listcomp>r�r�rr�rr��szLegacyMetadata.valuescs�fdd����D�S)Ncsg|]}|�|f�qSrrr�r�rrr��sz(LegacyMetadata.items.<locals>.<listcomp>r�r�rr�rrP�szLegacyMetadata.itemscCsd|jj|j|jfS)Nz
<%s %s %s>)�	__class__rr`rIr�rrr�__repr__�s�zLegacyMetadata.__repr__)NNNr�)F)F)F)N)F)F)"rrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rKr�r�rPr�rrrrrs@�




,
,
;rzpydist.jsonz
metadata.jsonZMETADATAc@s�eZdZdZe�d�Ze�dej�Ze	Z
e�d�ZdZde
Zdddd	�Zd
ZdZedfedfe
dfedfd�Zd
ZdDdd�Zed�ZdefZdefZdefdefeeedefeeeedefddd�
Z[[dd�ZdEdd�Zdd�Zed d!��Z ed"d#��Z!e!j"d$d#��Z!dFd%d&�Z#ed'd(��Z$ed)d*��Z%e%j"d+d*��Z%d,d-�Z&d.d/�Z'd0d1�Z(d2d3�Z)d4d5d6d7d8dd9�Z*d:d;�Z+dGd>d?�Z,d@dA�Z-dBdC�Z.dS)Hrz�
    The metadata of a release. This implementation uses 2.0 (JSON)
    metadata where possible. If not possible, it wraps a LegacyMetadata
    instance which handles the key-value metadata format.
    z
^\d+(\.\d+)*$z!^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$z	.{1,2047}rCzdistlib (%s)r)�legacy)r`rIrbzqname version license summary description author author_email keywords platform home_page classifiers download_urlzwextras run_requires test_requires build_requires dev_requires provides meta_requires obsoleted_by supports_environments)r_r`rIrb)�_legacy�_datar�Nr�c	Cs0|||g�d�dkrtd��d|_d|_||_|dk	rzz|�||�||_Wn*tk
rvt||d�|_|��YnXn�d}|r�t	|d��}|�
�}W5QRXn|r�|�
�}|dkr�|j|jd�|_ndt
|t�s�|�d�}zt�|�|_|�|j|�Wn0tk
�r*tt|�|d�|_|��YnXdS)Nr�r�)r�r��rb�r_�	generatorr)r�r�)r�r�r�r�r��_validate_mappingrr�validater�r��METADATA_VERSION�	GENERATORr�r	�decode�json�loads�
ValueErrorr)r�r�r�r�r�r��frrrr��s@
�


�zMetadata.__init__)r`rIrjrdrbr6r;r=r,)r-N)r N)
�run_requires�build_requires�dev_requiresZ
test_requires�
meta_requires�extras�modules�
namespaces�exports�commandsr�Z
source_urlr_c
CsXt�|d�}t�|d�}||k�r||\}}|jr^|dkrP|dkrHdn|�}n|j�|�}n�|dkrjdn|�}|dkr�|j�||�}n�t�}|}|j�d�}	|	�r
|dkr�|	�d|�}nP|dkr�|	�d�}	|	r�|	�||�}n,|	�d	�}	|	s�|j�d	�}	|	�r
|	�||�}||k�rT|}n:||k�r2t�||�}n"|j�rH|j�|�}n|j�|�}|S)
N�common_keys�mapped_keys�r	rrrr��
extensionsr	�python.commandsr��python.details�python.exports)�object�__getattribute__r�r�r�)
r�r\�common�mapped�lkZmaker�resultr]�sentinel�drrrrsD




zMetadata.__getattribute__cCsH||jkrD|j|\}}|p |j|krD|�|�}|sDtd||f��dS)Nz.'%s' is an invalid value for the '%s' property)�SYNTAX_VALIDATORSr��matchr)r�r\r]r��pattern�
exclusions�mrrr�_validate_value+s

��zMetadata._validate_valuecCs*|�||�t�|d�}t�|d�}||kr�||\}}|jrV|dkrJt�||j|<nf|dkrj||j|<nR|j�di�}|dkr�||d<n2|dkr�|�di�}|||<n|�d	i�}|||<nh||kr�t�|||�nP|d
k�rt|t	��r|�
�}|�r|��}ng}|j�r||j|<n
||j|<dS)Nr
rrr
r	rr�rrrd)rrrr��NotImplementedErrorr��
setdefault�__setattr__r�rr�r�)r�r\r]rrrr�rrrrr!5s<




zMetadata.__setattr__cCst|j|jd�S�NT)r~r`rIr�rrr�name_and_version\szMetadata.name_and_versioncCsF|jr|jd}n|j�dg�}d|j|jf}||krB|�|�|S)Nr5rtz%s (%s))r�r�r r`rIrQ)r�r�srrrrt`s
zMetadata.providescCs |jr||jd<n
||jd<dS)Nr5rt)r�r�r�rrrrtksc
Cs�|jr|}n�g}t|pg|j�}|D]d}d|kr>d|kr>d}n8d|krLd}n|�d�|k}|rv|�d�}|rvt||�}|r$|�|d�q$dD]F}d|}	|	|kr�|�|	�|j�d|g�}|�|j|||d��q�|S)	a�
        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.
        �extra�environmentTrs)ZbuildZdevZtestz:%s:z%s_requires)r�env)	r�rrr�r
�extendrRr��get_requirements)
r��reqtsrr'rrZincluderMr\�errrr)rs2	


�
zMetadata.get_requirementscCs|jr|��S|jSr�)r��_from_legacyr�r�rrr�
dictionary�szMetadata.dictionarycCs|jrt�nt|j|j�SdSr�)r�rrr��DEPENDENCY_KEYSr�rrr�dependencies�szMetadata.dependenciescCs|jrt�n|j�|�dSr�)r�rr�r�r�rrrr/�sc	Cs�|�d�|jkrt��g}|j��D]"\}}||kr$||kr$|�|�q$|rbdd�|�}t|��|��D]\}}|�|||�qjdS)Nr_zMissing metadata items: %sr�)	r�r�r�MANDATORY_KEYSrPrQr�rr)	r�r�r�r�r\rr�r�r�rrrr��szMetadata._validate_mappingcCsB|jr.|j�d�\}}|s|r>t�d||�n|�|j|j�dS)NTz#Metadata: missing: %s, warnings: %s)r�r�rSr�r�r�r�)r�r�r�rrrr��s�zMetadata.validatecCs(|jr|j�d�St|j|j�}|SdSr")r�r�rr��
INDEX_KEYS)r�rrrrr��szMetadata.todictc
Cs�|jr|jrt�|j|jd�}|j�d�}dD]*}||kr.|dkrHd}n|}||||<q.|�dg�}|dgkrtg}||d<d	}|D]*\}}||kr�||r�d
||ig||<q�|j|d<i}i}	|S)Nr�T)r`rIrjrbrcrkrkr�r&�rd))ror)rprrsrt)r�r��AssertionErrorr�r�r�r�rt)
r�rZlmdr��nk�kwrK�okrfrhrrrr,�s.�

zMetadata._from_legacyr!r"r*r$r%)r`rIrjrbrcr�cCs�dd�}|jr|jrt�t�}|j}|j��D]\}}||kr.||||<q.||j|j�}||j|j	�}|j
r�t|j
�|d<t|�|d<t|�|d<|S)NcSs�t�}|D]|}|�d�}|�d�}|d}|D]V}|sF|sF|�|�q.d}|rVd|}|rp|rld||f}n|}|�d�||f��q.q
|S)Nr%r&rsr2z
extra == "%s"z(%s) and %sr�)r�r��addr�)�entriesr*r+r%r'Zrlistr�rMrrr�process_entries�s"

z,Metadata._to_legacy.<locals>.process_entriesr=r6r;)r�r�r3r�LEGACY_MAPPINGrPrrrrr�sorted)r�r9rZnmdr4r6Zr1Zr2rrr�
_to_legacy�szMetadata._to_legacyFTc	Cs�||g�d�dkrtd��|��|r`|jr4|j}n|��}|rP|j||d�q�|j||d�n^|jrp|��}n|j}|r�t	j
||dddd�n.t�|dd��}t	j
||dddd�W5QRXdS)	Nrz)Exactly one of path and fileobj is needed)r�Tr�)Zensure_ascii�indentZ	sort_keysr�r)
r�r�r�r�r<r�r�r,r�r��dumpr�r�)r�r�r�r�r�Z	legacy_mdrrrrrr�s*
��zMetadata.writecCs�|jr|j�|�nr|j�dg�}d}|D]}d|kr*d|kr*|}qHq*|dkrfd|i}|�d|�n t|d�t|�B}t|�|d<dS)Nrr&r%rsr)r�r�r�r �insertr�r;)r�r�r�always�entryZrsetrrrr�3szMetadata.add_requirementscCs*|jpd}|jpd}d|jj|j||fS)Nz	(no name)z
no versionz<%s %s %s (%s)>)r`rIr�rr_)r�r`rIrrrr�Ds

�zMetadata.__repr__)NNNr�)N)NN)NNFT)/rrrr�re�compileZMETADATA_VERSION_MATCHER�IZNAME_MATCHERrZVERSION_MATCHERZSUMMARY_MATCHERr�rr�r0r1r.r�	__slots__r�r�r
r�Z	none_list�dictZ	none_dictrrrr!�propertyr#rt�setterr)r-r/r�r�r�r,r:r<r�r�r�rrrrr�s�

���
-�+

'




*


	�	%
)F)ErZ
__future__rr�Zemailrr�r�rBr2rr�compatrrr	rLr
�utilrrrIr
rZ	getLoggerrrSrrrr�__all__rrrCr�r�rDrErVrFrWrHrYrGrXr�r�r�ZEXTRA_RErJr^r�r�r�r�r�r�r�r�rr�r{r~rZMETADATA_FILENAMEZWHEEL_METADATA_FILENAMEZLEGACY_METADATA_FILENAMErrrrr�<module>s�










H�!



site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-38.pyc000064400000076653151446177000021313 0ustar00U

��.e���@sBddlmZddlZddlZddlZzddlZWnek
rHdZYnXejddk�r~ddlmZe	fZ
eZddl
mZddlZddlZddlmZddlmZmZmZmZmZdd	lmZmZmZm Z m!Z!m"Z"m#Z#d
d�Zddl$Z$ddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-e�r&dd
l$m.Z.ddl/Z/ddl0Z0ddl1Z2ddl3m3Z3ddl4Z4e5Z5ddl6m7Z8ddl6m9Z:da;dd�Z<�nddl=mZe>fZ
e>Zddl=m?ZddlZddlZddlZddl@mZmZmZm<Z<mZmZmZmZm#Z#ddlAm&Z&mZm%Z%m Z m!Z!m)Z)m*Z*m+Z+m,Z,m-Z-e�r&dd
lAm.Z.ddlBm(Z(m'Z'm"Z"ddlCmDZ/ddlAmEZ$ddlFmDZ0ddl2Z2ddlGm3Z3ddlHmIZ4eJZ5ddl6m:Z:e8Z8zddlmKZKmLZLWn8ek
�r�Gdd�deM�ZLdddd�ZNdd�ZKYnXzddl
mOZPWn&ek
�rGd d!�d!eQ�ZPYnXzdd"lmRZRWn,ek
�rTejSejTBdfd#d$�ZRYnXdd%lUmVZWeXeWd&��rteWZVn,dd'lUmYZZGd(d)�d)eZ�ZYGd*d+�d+eW�ZVzdd,l[m\Z\Wnek
�r�d-d.�Z\YnXzddl]Z]Wn"ek
�r�dd/lm]Z]YnXze^Z^Wn*e_k
�r2dd0l`maZad1d2�Z^YnXzejbZbejcZcWnHedk
�r�e�e��pbd3Zfefd4k�rtd5Zgnd6Zgd7d8�Zbd9d:�ZcYnXzdd;lhmiZiWnHek
�r�dd<ljmkZkmlZlddlZe�md=�Znd>d?�Zod@dA�ZiYnXzddBlpmqZqWn"ek
�rddBlrmqZqYnXejddC�dDk�r:e3�jsZsnddElpmsZszddFl`mtZtWndek
�r�ddGl`muZuzddHlvmwZxWn ek
�r�dedJdK�ZxYnXGdLdM�dMeu�ZtYnXzddNlymzZzWnHek
�rzddNl{mzZzWn ek
�rdfdOdP�ZzYnXYnXzddQl`m|Z|Wn�ek
�r�zddRl}m~ZWn"ek
�rjddRl�m~ZYnXzddSl�m�Z�m�Z�m�Z�Wnek
�r�YnXGdTdU�dUe��Z|YnXzddVl�m�Z�m�Z�Wnvek
�r<e�mdWej��Z�dXdY�Z�GdZd[�d[e��Z�dgd\d]�Z�Gd^d_�d_e��Z�Gd`da�dae��Z�Gdbdc�dceQ�Z�YnXdS)h�)�absolute_importN�)�StringIO)�FileType�)�shutil)�urlparse�
urlunparse�urljoin�urlsplit�
urlunsplit)�urlretrieve�quote�unquote�url2pathname�pathname2url�ContentTooShortError�	splittypecCst|t�r|�d�}t|�S)N�utf-8)�
isinstance�unicode�encode�_quote)�s�r�>/usr/lib/python3.8/site-packages/pip/_vendor/distlib/compat.pyrs

r)	�Request�urlopen�URLError�	HTTPError�HTTPBasicAuthHandler�HTTPPasswordMgr�HTTPHandler�HTTPRedirectHandler�build_opener)�HTTPSHandler)�
HTMLParser)�ifilter)�ifilterfalsecCs<tdkrddl}|�d�at�|�}|r4|�dd�Sd|fS)zJsplituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.Nrz^(.*)@(.*)$r�)�	_userprog�re�compile�match�group)Zhostr+r-rrr�	splituser4s

r/)�
TextIOWrapper)	rr	r
r/rrrrr)
rr
rrrr r!r"r#r$)rrr)�filterfalse)�match_hostname�CertificateErrorc@seZdZdS)r3N)�__name__�
__module__�__qualname__rrrrr3^sr3c
Cs�g}|sdS|�d�}|d|dd�}}|�d�}||krNtdt|���|sb|��|��kS|dkrv|�d�n>|�d	�s�|�d	�r�|�t�|��n|�t�|��	d
d��|D]}|�t�|��q�t�
dd
�|�dtj�}	|	�
|�S)zpMatching according to RFC 6125, section 6.4.3

        http://tools.ietf.org/html/rfc6125#section-6.4.3
        F�.rrN�*z,too many wildcards in certificate DNS name: z[^.]+zxn--z\*z[^.]*z\Az\.z\Z)�split�countr3�repr�lower�append�
startswithr+�escape�replacer,�join�
IGNORECASEr-)
Zdn�hostnameZ
max_wildcardsZpats�partsZleftmostZ	remainderZ	wildcards�fragZpatrrr�_dnsname_matchbs*


�rFcCs�|std��g}|�dd�}|D]*\}}|dkr t||�r@dS|�|�q |s�|�dd�D]6}|D],\}}|dkrdt||�r�dS|�|�qdq\t|�dkr�td	|d
�tt|��f��n*t|�dkr�td||df��ntd
��dS)a=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.
        ztempty or no certificate, match_hostname needs a SSL socket or SSL context with either CERT_OPTIONAL or CERT_REQUIREDZsubjectAltNamerZDNSNZsubjectZ
commonNamerz&hostname %r doesn't match either of %s�, zhostname %r doesn't match %rrz=no appropriate commonName or subjectAltName fields were found)	�
ValueError�getrFr=�lenr3rA�mapr;)ZcertrCZdnsnamesZsan�key�value�subrrrr2�s2

�
�r2)�SimpleNamespacec@seZdZdZdd�ZdS)�	ContainerzR
        A generic container for when multiple values need to be returned
        cKs|j�|�dS�N��__dict__�update)�self�kwargsrrr�__init__�szContainer.__init__N)r4r5r6�__doc__rWrrrrrP�srP)�whichcs"dd�}tj���r&|�|�r"�SdS|dkr>tj�dtj�}|sFdS|�tj�}tj	dkr�tj
|krt|�dtj
�tj�dd��tj�}t�fd	d
�|D��r��g}q‡fdd�|D�}n�g}t
�}|D]P}tj�|�}||kr�|�|�|D](}	tj�||	�}
||
|�r�|
Sq�q�dS)
aKGiven 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.

        cSs&tj�|�o$t�||�o$tj�|�SrQ)�os�path�exists�access�isdir)�fn�moderrr�
_access_check�s�zwhich.<locals>._access_checkN�PATHZwin32rZPATHEXT�c3s |]}����|���VqdSrQ)r<�endswith��.0�ext��cmdrr�	<genexpr>�szwhich.<locals>.<genexpr>csg|]}�|�qSrrrerhrr�
<listcomp>�szwhich.<locals>.<listcomp>)rZr[�dirname�environrI�defpathr9�pathsep�sys�platform�curdir�insert�any�set�normcase�addrA)rir`r[raZpathext�files�seen�dirZnormdirZthefile�namerrhrrY�s8





rY)�ZipFile�	__enter__)�
ZipExtFilec@s$eZdZdd�Zdd�Zdd�ZdS)r~cCs|j�|j�dSrQrR)rU�baserrrrWszZipExtFile.__init__cCs|SrQr�rUrrrr}szZipExtFile.__enter__cGs|��dSrQ��close�rU�exc_inforrr�__exit__szZipExtFile.__exit__N)r4r5r6rWr}r�rrrrr~sr~c@s$eZdZdd�Zdd�Zdd�ZdS)r|cCs|SrQrr�rrrr}"szZipFile.__enter__cGs|��dSrQr�r�rrrr�%szZipFile.__exit__cOstj|f|�|�}t|�SrQ)�BaseZipFile�openr~)rU�argsrVrrrrr�)szZipFile.openN)r4r5r6r}r�r�rrrrr|!sr|)�python_implementationcCs0dtjkrdStjdkrdStj�d�r,dSdS)z6Return a string identifying the Python implementation.ZPyPy�javaZJythonZ
IronPythonZCPython)rp�versionrZr{r>rrrrr�0s

r�)�	sysconfig)�CallablecCs
t|t�SrQ)rr�)�objrrr�callableDsr�r�mbcs�strict�surrogateescapecCs:t|t�r|St|t�r$|�tt�Stdt|�j��dS�Nzexpect bytes or str, not %s)	r�bytes�	text_typer�_fsencoding�	_fserrors�	TypeError�typer4��filenamerrr�fsencodeXs

�r�cCs:t|t�r|St|t�r$|�tt�Stdt|�j��dSr�)	rr�r��decoder�r�r�r�r4r�rrr�fsdecodeas

�r�)�detect_encoding)�BOM_UTF8�lookupzcoding[:=]\s*([-\w.]+)cCsH|dd����dd�}|dks*|�d�r.dS|dks@|�d�rDd	S|S)
z(Imitates get_normal_name in tokenizer.c.N��_�-rzutf-8-)zlatin-1�
iso-8859-1ziso-latin-1)zlatin-1-ziso-8859-1-ziso-latin-1-r�)r<r@r>)�orig_enc�encrrr�_get_normal_namers�r�cs�z�jj�Wntk
r$d�YnXd�d}d}�fdd�}��fdd�}|�}|�t�rpd�|d	d�}d
}|s||gfS||�}|r�||gfS|�}|s�||gfS||�}|r�|||gfS|||gfS)a?
        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.
        NFrcs$z��WStk
rYdSXdS)N�)�
StopIterationr)�readlinerr�read_or_stop�sz%detect_encoding.<locals>.read_or_stopcs�z|�d�}Wn4tk
rBd}�dk	r6d�|��}t|��YnXt�|�}|sVdSt|d�}zt|�}Wn:tk
r��dkr�d|}nd��|�}t|��YnX�r�|j	dkr؈dkr�d}n
d���}t|��|d	7}|S)
Nrz'invalid or missing encoding declarationz{} for {!r}rzunknown encoding: zunknown encoding for {!r}: {}zencoding problem: utf-8z encoding problem for {!r}: utf-8z-sig)
r��UnicodeDecodeError�format�SyntaxError�	cookie_re�findallr�r��LookupErrorr{)�line�line_string�msgZmatches�encoding�codec)�	bom_foundr�rr�find_cookie�s8

�

z$detect_encoding.<locals>.find_cookieTrz	utf-8-sig)�__self__r{�AttributeErrorr>r�)r�r��defaultr�r��first�secondr)r�r�r�rr�}s4
&


r�)r?r))r�)�unescape)�ChainMap)�MutableMapping)�recursive_repr�...cs�fdd�}|S)zm
            Decorator to make a repr function return fillvalue for a recursive
            call
            csLt�����fdd�}t�d�|_t�d�|_t�d�|_t�di�|_|S)Nc	sBt|�t�f}|�kr�S��|�z�|�}W5��|�X|SrQ)�id�	get_identrw�discard)rUrL�result)�	fillvalue�repr_running�
user_functionrr�wrapper�s
z=_recursive_repr.<locals>.decorating_function.<locals>.wrapperr5rXr4�__annotations__)ru�getattrr5rXr4r�)r�r��r�)r�r�r�decorating_function�sz,_recursive_repr.<locals>.decorating_functionr)r�r�rr�r�_recursive_repr�sr�c@s�eZdZdZdd�Zdd�Zdd�Zd'd	d
�Zdd�Zd
d�Z	dd�Z
dd�Ze�dd��Z
edd��Zdd�ZeZdd�Zedd��Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�ZdS)(r�a� 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.

        cGst|�pig|_dS)z�Initialize a ChainMap by setting *maps* to the given mappings.
            If no mappings are provided, a single empty dictionary is used.

            N)�list�maps)rUr�rrrrWszChainMap.__init__cCst|��dSrQ)�KeyError�rUrLrrr�__missing__szChainMap.__missing__c	Cs:|jD](}z||WStk
r,YqXq|�|�SrQ)r�r�r�)rUrL�mappingrrr�__getitem__s
zChainMap.__getitem__NcCs||kr||S|SrQr�rUrLr�rrrrI%szChainMap.getcCstt�j|j��SrQ)rJru�unionr�r�rrr�__len__(szChainMap.__len__cCstt�j|j��SrQ)�iterrur�r�r�rrr�__iter__+szChainMap.__iter__cst�fdd�|jD��S)Nc3s|]}�|kVqdSrQr)rf�m�rLrrrj/sz(ChainMap.__contains__.<locals>.<genexpr>�rtr�r�rr�r�__contains__.szChainMap.__contains__cCs
t|j�SrQr�r�rrr�__bool__1szChainMap.__bool__cCsd�|d�tt|j���S)Nz{0.__class__.__name__}({1})rG)r�rArKr;r�r�rrr�__repr__4s�zChainMap.__repr__cGs|tj|f|���S)z?Create a ChainMap with a single dict created from the iterable.)�dict�fromkeys)�cls�iterabler�rrrr�9szChainMap.fromkeyscCs$|j|jd��f|jdd���S)zHNew ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]rrN)�	__class__r��copyr�rrrr�>sz
ChainMap.copycCs|jif|j��S)z;New ChainMap with a new dict followed by all previous maps.�r�r�r�rrr�	new_childDszChainMap.new_childcCs|j|jdd��S)zNew ChainMap from maps[1:].rNr�r�rrr�parentsHszChainMap.parentscCs||jd|<dS)Nr)r�)rUrLrMrrr�__setitem__MszChainMap.__setitem__cCs8z|jd|=Wn"tk
r2td�|���YnXdS)Nr�(Key not found in the first mapping: {!r})r�r�r�r�rrr�__delitem__PszChainMap.__delitem__cCs2z|jd��WStk
r,td��YnXdS)zPRemove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.rz#No keys found in the first mapping.N)r��popitemr�r�rrrr�VszChainMap.popitemcGs@z|jdj|f|��WStk
r:td�|���YnXdS)zWRemove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].rr�N)r��popr�r�)rUrLr�rrrr�]szChainMap.popcCs|jd��dS)z'Clear maps[0], leaving maps[1:] intact.rN)r��clearr�rrrr�dszChainMap.clear)N)r4r5r6rXrWr�r�rIr�r�r�r�r�r��classmethodr�r��__copy__r��propertyr�r�r�r�r�r�rrrrr�s.



r�)�cache_from_sourcecCs0|�d�st�|dkrd}|r$d}nd}||S)Nz.pyT�c�o)rd�AssertionError)r[�debug_override�suffixrrrr�nsr�)�OrderedDict)r�)�KeysView�
ValuesView�	ItemsViewc@s�eZdZdZdd�Zejfdd�Zejfdd�Zdd	�Zd
d�Z	dd
�Z
d6dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZeZe�Zefdd �Zd7d"d#�Zd8d$d%�Zd&d'�Zd(d)�Zed9d*d+��Zd,d-�Zd.d/�Zd0d1�Zd2d3�Z d4d5�Z!d!S):r�z)Dictionary that remembers insertion ordercOsnt|�dkrtdt|���z
|jWn6tk
r\g|_}||dg|dd�<i|_YnX|j||�dS)z�Initialize an ordered dictionary.  Signature is the same as for
            regular dictionaries, but keyword arguments are not recommended
            because their insertion order is arbitrary.

            rz$expected at most 1 arguments, got %dN)rJr��_OrderedDict__rootr��_OrderedDict__map�_OrderedDict__update)rUr��kwds�rootrrrrW�s

zOrderedDict.__init__cCsF||kr6|j}|d}|||g|d<|d<|j|<||||�dS)z!od.__setitem__(i, y) <==> od[i]=yrrN)rr)rUrLrMZdict_setitemr�lastrrrr��s
 zOrderedDict.__setitem__cCs0|||�|j�|�\}}}||d<||d<dS)z od.__delitem__(y) <==> del od[y]rrN)rr�)rUrLZdict_delitem�	link_prev�	link_nextrrrr��s
zOrderedDict.__delitem__ccs.|j}|d}||k	r*|dV|d}qdS)zod.__iter__() <==> iter(od)rr)N�r�rUrZcurrrrrr��s

zOrderedDict.__iter__ccs.|j}|d}||k	r*|dV|d}qdS)z#od.__reversed__() <==> reversed(od)rr)Nrr	rrr�__reversed__�s

zOrderedDict.__reversed__cCsdz@|j��D]}|dd�=q|j}||dg|dd�<|j��Wntk
rTYnXt�|�dS)z.od.clear() -> None.  Remove all items from od.N)r�
itervaluesrr�r�r�)rUZnoderrrrr��szOrderedDict.clearTcCs||std��|j}|r8|d}|d}||d<||d<n |d}|d}||d<||d<|d}|j|=t�||�}||fS)z�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.

            zdictionary is emptyrrr))r�rrr�r�)rUrr�linkrrrLrMrrrr��s 
zOrderedDict.popitemcCst|�S)zod.keys() -> list of keys in od)r�r�rrr�keys�szOrderedDict.keyscs�fdd��D�S)z#od.values() -> list of values in odcsg|]}�|�qSrr�rfrLr�rrrk�sz&OrderedDict.values.<locals>.<listcomp>rr�rr�r�values�szOrderedDict.valuescs�fdd��D�S)z.od.items() -> list of (key, value) pairs in odcsg|]}|�|f�qSrrrr�rrrk�sz%OrderedDict.items.<locals>.<listcomp>rr�rr�r�items�szOrderedDict.itemscCst|�S)z0od.iterkeys() -> an iterator over the keys in od)r�r�rrr�iterkeys�szOrderedDict.iterkeysccs|D]}||VqdS)z2od.itervalues -> an iterator over the values in odNr�rU�krrrr�szOrderedDict.itervaluesccs|D]}|||fVqdS)z=od.iteritems -> an iterator over the (key, value) items in odNrrrrr�	iteritemsszOrderedDict.iteritemscOs�t|�dkr tdt|�f��n|s,td��|d}d}t|�dkrL|d}t|t�rn|D]}||||<qZn<t|d�r�|��D]}||||<q�n|D]\}}|||<q�|��D]\}}|||<q�dS)	a�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

            r)z8update() takes at most 2 positional arguments (%d given)z,update() takes at least 1 argument (0 given)rrrr
N)rJr�rr��hasattrr
r)r�rrU�otherrLrMrrrrTs(	�


zOrderedDict.updatecCs0||kr||}||=|S||jkr,t|��|S)z�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.

            )�_OrderedDict__markerr�)rUrLr�r�rrrr�*s
zOrderedDict.popNcCs||kr||S|||<|S)zDod.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in odrr�rrr�
setdefault7szOrderedDict.setdefaultcCsf|si}t|�t�f}||kr"dSd||<z.|sBd|jjfW�Sd|jj|��fW�S||=XdS)zod.__repr__() <==> repr(od)r�rz%s()z%s(%r)N)r��
_get_identr�r4r)rUZ
_repr_runningZcall_keyrrrr�>szOrderedDict.__repr__csX�fdd��D�}t����}tt��D]}|�|d�q(|rL�j|f|fS�j|ffS)z%Return state information for picklingcsg|]}|�|g�qSrr�rfrr�rrrkNsz*OrderedDict.__reduce__.<locals>.<listcomp>N)�varsr�r�r�r�)rUrZ	inst_dictrrr�r�
__reduce__LszOrderedDict.__reduce__cCs
|�|�S)z!od.copy() -> a shallow copy of od)r�r�rrrr�VszOrderedDict.copycCs|�}|D]}|||<q
|S)z�OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S
            and values equal to v (which defaults to None).

            r)r�r�rM�drLrrrr�Zs
zOrderedDict.fromkeyscCs6t|t�r*t|�t|�ko(|��|��kSt�||�S)z�od.__eq__(y) <==> od==y.  Comparison to another OD is order-sensitive
            while comparison to a regular mapping is order-insensitive.

            )rr�rJrr��__eq__�rUrrrrres
 zOrderedDict.__eq__cCs
||kSrQrrrrr�__ne__nszOrderedDict.__ne__cCst|�S)z@od.viewkeys() -> a set-like object providing a view on od's keys)r�r�rrr�viewkeyssszOrderedDict.viewkeyscCst|�S)z<od.viewvalues() -> an object providing a view on od's values)r�r�rrr�
viewvalueswszOrderedDict.viewvaluescCst|�S)zBod.viewitems() -> a set-like object providing a view on od's items)r�r�rrr�	viewitems{szOrderedDict.viewitems)T)N)N)N)"r4r5r6rXrWr�r�r�r�r
r�r�r
rrrrrrTr�objectrr�rr�rr�r�r�rr r!r"r#rrrrr��s:
	




	r�)�BaseConfigurator�valid_identz^[a-z_][a-z0-9_]*$cCst�|�}|std|��dS)Nz!Not a valid Python identifier: %rT)�
IDENTIFIERr-rH)rr�rrrr&�s
r&c@s"eZdZdZdd�Zddd�ZdS)�ConvertingDictz A converting dictionary wrapper.cCsJt�||�}|j�|�}||k	rF|||<t|�tttfkrF||_||_	|SrQ)
r�r��configurator�convertr�r(�ConvertingList�ConvertingTuple�parentrL�rUrLrMr�rrrr��s
�zConvertingDict.__getitem__NcCsLt�|||�}|j�|�}||k	rH|||<t|�tttfkrH||_||_	|SrQ)
r�rIr)r*r�r(r+r,r-rL�rUrLr�rMr�rrrrI�s
�zConvertingDict.get)N)r4r5r6rXr�rIrrrrr(�sr(cCsDt�|||�}|j�|�}||k	r@t|�tttfkr@||_||_	|SrQ)
r�r�r)r*r�r(r+r,r-rLr/rrrr��s
�r�c@s"eZdZdZdd�Zddd�ZdS)	r+zA converting list wrapper.cCsJt�||�}|j�|�}||k	rF|||<t|�tttfkrF||_||_	|SrQ)
r�r�r)r*r�r(r+r,r-rLr.rrrr��s
�zConvertingList.__getitem__���cCs<t�||�}|j�|�}||k	r8t|�tttfkr8||_|SrQ)	r�r�r)r*r�r(r+r,r-)rU�idxrMr�rrrr��s
�zConvertingList.popN)r0)r4r5r6rXr�r�rrrrr+�sr+c@seZdZdZdd�ZdS)r,zA converting tuple wrapper.cCsBt�||�}|j�|�}||k	r>t|�tttfkr>||_||_	|SrQ)
�tupler�r)r*r�r(r+r,r-rLr.rrrr��s
�zConvertingTuple.__getitem__N)r4r5r6rXr�rrrrr,�sr,c@s�eZdZdZe�d�Ze�d�Ze�d�Ze�d�Z	e�d�Z
ddd	�Zee
�Zd
d�Zdd
�Zdd�Zdd�Zdd�Zdd�Zdd�ZdS)r%zQ
        The configurator base class which defines some useful defaults.
        z%^(?P<prefix>[a-z]+)://(?P<suffix>.*)$z^\s*(\w+)\s*z^\.\s*(\w+)\s*z^\[\s*(\w+)\s*\]\s*z^\d+$�ext_convert�cfg_convert)rgZcfgcCst|�|_||j_dSrQ)r(�configr))rUr5rrrrW�s
zBaseConfigurator.__init__c		Cs�|�d�}|�d�}z^|�|�}|D]H}|d|7}zt||�}Wq$tk
rj|�|�t||�}Yq$Xq$|WStk
r�t��dd�\}}td||f�}|||_	|_
|�YnXdS)zl
            Resolve strings to objects using standard import and attribute
            syntax.
            r7rrNzCannot resolve %r: %s)r9r��importerr�r��ImportErrorrpr�rH�	__cause__�
__traceback__)	rUrr{Zused�foundrE�e�tb�vrrr�resolve�s"



zBaseConfigurator.resolvecCs
|�|�S)z*Default converter for the ext:// protocol.)r>�rUrMrrrr3szBaseConfigurator.ext_convertcCs�|}|j�|�}|dkr&td|��n�||��d�}|j|��d}|r�|j�|�}|rn||��d}nd|j�|�}|r�|��d}|j�|�s�||}n2zt	|�}||}Wnt
k
r�||}YnX|r�||��d�}qHtd||f��qH|S)z*Default converter for the cfg:// protocol.NzUnable to convert %rrzUnable to convert %r at %r)�WORD_PATTERNr-rH�endr5�groups�DOT_PATTERN�
INDEX_PATTERN�
DIGIT_PATTERN�intr�)rUrM�restr�rr1�nrrrr4s4
�zBaseConfigurator.cfg_convertcCs�t|t�s$t|t�r$t|�}||_n�t|t�sHt|t�rHt|�}||_nzt|t�slt|t�rlt|�}||_nVt|t�r�|j	�
|�}|r�|��}|d}|j�
|d�}|r�|d}t||�}||�}|S)z�
            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.
            �prefixNr�)rr(r�r)r+r�r,r2�string_types�CONVERT_PATTERNr-�	groupdict�value_convertersrIr�)rUrMr�rrIZ	converterr�rrrr*2s,
�

zBaseConfigurator.convertcsn��d�}t|�s|�|�}��dd�}t�fdd��D��}|f|�}|rj|��D]\}}t|||�qT|S)z1Configure an object with a user-supplied factory.z()r7Ncs g|]}t|�r|�|f�qSr)r&r�r5rrrkUsz5BaseConfigurator.configure_custom.<locals>.<listcomp>)r�r�r>r�r�setattr)rUr5r�ZpropsrVr�r{rMrrNr�configure_customNs


z!BaseConfigurator.configure_customcCst|t�rt|�}|S)z0Utility function which converts lists to tuples.)rr�r2r?rrr�as_tuple\s
zBaseConfigurator.as_tupleN)r4r5r6rXr+r,rKr@rCrDrErM�staticmethod�
__import__r6rWr>r3r4r*rPrQrrrrr%�s"




�"r%)r)r�)N)N)�Z
__future__rrZr+rpZsslr7�version_inforZ
basestringrJrr��typesrZ	file_typeZ__builtin__�builtinsZConfigParserZconfigparserZ	_backportrrr	r
rrZurllibr
rrrrrrrZurllib2rrrrr r!r"r#r$r%ZhttplibZ	xmlrpclibZQueueZqueuer&ZhtmlentitydefsZ	raw_input�	itertoolsr'�filterr(r1r*r/�io�strr0Zurllib.parseZurllib.requestZurllib.errorZhttp.clientZclientZrequestZ
xmlrpc.clientZhtml.parserZ
html.entitiesZentities�inputr2r3rHrFrOrPr$rY�F_OK�X_OKZzipfiler|r�rr~ZBaseZipExtFilerqr�r�r��	NameError�collectionsr�r�r�r��getfilesystemencodingr�r��tokenizer��codecsr�r�r,r�r�Zhtmlr?Zcgir�r�r��reprlibr�r��importlib.utilr�Zimpr��threadr�rZdummy_threadZ_abcollr�r�r�r�Zlogging.configr%r&�Ir'r(r�r�r+r2r,rrrr�<module>s,
$,,0
2+A


		
[
b
w

site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-38.opt-1.pyc000064400000010510151446177000022407 0ustar00U

��.e#�@s�dZddlZddlZddlZddlZddlmZmZmZddl	m
Z
mZdgZdd�Z
Gd	d
�d
e�Zdd�Ze�Z[e�Zdd
d�ZdS)zG
Parser for the environment markers micro-language defined in PEP 508.
�N�)�python_implementation�urlparse�string_types)�in_venv�parse_marker�	interpretcCst|t�r|sdS|ddkS)NFr�'")�
isinstancer)�o�r�?/usr/lib/python3.8/site-packages/pip/_vendor/distlib/markers.py�_is_literalsrc
@sfeZdZdZdd�dd�dd�dd�dd�dd�d	d�d
d�dd�dd�d
d�dd�d�Zdd�ZdS)�	Evaluatorz;
    This class is used to evaluate marker expessions.
    cCs||kS�Nr��x�yrrr
�<lambda>$�zEvaluator.<lambda>cCs||kSrrrrrr
r%rcCs||kp||kSrrrrrr
r&rcCs||kSrrrrrr
r'rcCs||kSrrrrrr
r(rcCs||kp||kSrrrrrr
r)rcCs||kSrrrrrr
r*rcCs||kp||kSrrrrrr
r+rcCs|o|Srrrrrr
r,rcCs|p|Srrrrrr
r-rcCs||kSrrrrrr
r.rcCs||kSrrrrrr
r/r)z==z===z~=z!=�<z<=�>z>=�and�or�inznot inc	Cs�t|t�rB|ddkr$|dd�}q�||kr8td|��||}n�|d}||jkr`td|��|d}|d	}t|d�r�t|d	�r�td
|||f��|�||�}|�||�}|j|||�}|S)z�
        Evaluate a marker expression returned by the :func:`parse_requirement`
        function in the specified context.
        rr	r���zunknown variable: %s�opzop not implemented: %s�lhs�rhszinvalid comparison: %s %s %s)r
r�SyntaxError�
operations�NotImplementedErrorr�evaluate)	�self�expr�context�resultrZelhsZerhsrrrrr
r"2s"


zEvaluator.evaluateN)�__name__�
__module__�__qualname__�__doc__r r"rrrr
rs�rc
Cs�dd�}ttd�r(|tjj�}tjj}nd}d}||tjt��t��t�	�t�
�t��tt��t�
�t�
�dd�tjd�}|S)NcSs<d|j|j|jf}|j}|dkr8||dt|j�7}|S)Nz%s.%s.%s�finalr)�major�minor�micro�releaselevel�str�serial)�info�versionZkindrrr
�format_full_versionNs
z,default_context.<locals>.format_full_version�implementation�0��)�implementation_name�implementation_versionZos_nameZplatform_machineZplatform_python_implementationZplatform_releaseZplatform_systemZplatform_versionZplatform_in_venvZpython_full_version�python_versionZsys_platform)�hasattr�sysr5r3�name�os�platform�machiner�release�systemr0rr;)r4r:r9r&rrr
�default_contextMs(

�rDc
Cs�zt|�\}}Wn2tk
rB}ztd||f��W5d}~XYnX|rd|ddkrdtd||f��tt�}|rz|�|�t�||�S)z�
    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
    z)Unable to interpret marker syntax: %s: %sNr�#z*unexpected trailing data in marker: %s: %s)r�	Exceptionr�dict�DEFAULT_CONTEXT�update�	evaluatorr")ZmarkerZexecution_contextr$�rest�er%rrr
rqs	"
)N)r*r?r=r@�re�compatrrr�utilrr�__all__r�objectrrDrHrJrrrrr
�<module>s/site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-38.opt-1.pyc000064400000023545151446177000022565 0ustar00U

��.e�9�@s�dZddlZddlZddlZddlZddlZddlmZddlm	Z	ddl
mZdgZe�
e�Ze�dej�Ze�d	ejejB�Zejdd
�ZGdd�de�ZdS)zu
Class representing the list of files in a distribution.

Equivalent to distutils.filelist, but fixes some problems.
�N�)�DistlibException)�fsdecode��convert_path�Manifestz\\w*
z#.*?(?=
)|
(?=$)�c@szeZdZdZddd�Zdd�Zdd�Zd	d
�Zddd
�Zdd�Z	dd�Z
dd�Zddd�Zd dd�Z
d!dd�Zdd�ZdS)"rz~A list of files built by on exploring the filesystem and filtered by
    applying various patterns to what we find there.
    NcCs>tj�tj�|pt����|_|jtj|_d|_t	�|_
dS)zd
        Initialise an instance.

        :param base: The base directory to explore under.
        N)�os�path�abspath�normpath�getcwd�base�sep�prefix�allfiles�set�files)�selfr�r�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/manifest.py�__init__*szManifest.__init__cCs�ddlm}m}m}g|_}|j}|g}|j}|j}|r�|�}t�	|�}	|	D]R}
tj
�||
�}t�|�}|j}
||
�r�|�t
|��qN||
�rN||
�sN||�qNq6dS)zmFind all files under the base and set ``allfiles`` to the absolute
        pathnames of files found.
        r)�S_ISREG�S_ISDIR�S_ISLNKN)�statrrrrr�pop�appendr	�listdirr
�join�st_moder)rrrrr�root�stackr�push�names�name�fullnamer�moderrr�findall9s"


zManifest.findallcCs4|�|j�stj�|j|�}|j�tj�|��dS)zz
        Add a file to the manifest.

        :param item: The pathname to add. This can be relative to the base.
        N)	�
startswithrr	r
rrr�addr)r�itemrrrr*TszManifest.addcCs|D]}|�|�qdS)z�
        Add a list of files to the manifest.

        :param items: The pathnames to add. These can be relative to the base.
        N)r*)r�itemsr+rrr�add_many^szManifest.add_manyFcsb��fdd��t�j�}|rFt�}|D]}�|tj�|��q&||O}dd�tdd�|D��D�S)z8
        Return sorted files in directory order
        cs>|�|�t�d|�|�jkr:tj�|�\}}�||�dS)Nzadd_dir added %s)r*�logger�debugrr	r
�split)�dirs�d�parent�_��add_dirrrrr6ls


z Manifest.sorted.<locals>.add_dircSsg|]}tjj|��qSr)r	r
r)�.0Z
path_tuplerrr�
<listcomp>zsz#Manifest.sorted.<locals>.<listcomp>css|]}tj�|�VqdS)N)r	r
r0)r7r
rrr�	<genexpr>{sz"Manifest.sorted.<locals>.<genexpr>)rrr	r
�dirname�sorted)rZwantdirs�resultr1�frr5rr;gs
�zManifest.sortedcCst�|_g|_dS)zClear all collected files.N)rrr)rrrr�clear}szManifest.clearcCsj|�|�\}}}}|dkrB|D]}|j|dd�st�d|�q�n$|dkrf|D]}|j|dd�}qN�n|dkr�|D]}|j|dd�srt�d|�qrn�|d	kr�|D]}|j|dd�}q�n�|d
kr�|D] }|j||d�s�t�d||�q�n�|d
k�r
|D]}|j||d�}q�n\|dk�r2|jd|d��sft�d|�n4|dk�rZ|jd|d��sft�d|�ntd|��dS)av
        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
        �includeT)�anchorzno files found matching %r�exclude�global-includeFz3no files found matching %r anywhere in distribution�global-exclude�recursive-include)rz-no files found matching %r under directory %r�recursive-exclude�graftNz no directories found matching %r�prunez4no previously-included directories found matching %rzinvalid action %r)�_parse_directive�_include_patternr.Zwarning�_exclude_patternr)r�	directive�action�patterns�thedirZ
dirpattern�pattern�foundrrr�process_directive�sP��

�
��zManifest.process_directivecCs|��}t|�dkr,|ddkr,|�dd�|d}d}}}|dkrxt|�dkr`td|��d	d
�|dd�D�}n~|dkr�t|�dkr�td
|��t|d�}dd
�|dd�D�}n:|dkr�t|�dkr�td|��t|d�}ntd|��||||fS)z�
        Validate a directive.
        :param directive: The directive to validate.
        :return: A tuple of action, patterns, thedir, dir_patterns
        rr)r?rArBrCrDrErFrGr?N)r?rArBrCrz$%r expects <pattern1> <pattern2> ...cSsg|]}t|��qSrr�r7Zwordrrrr8�sz-Manifest._parse_directive.<locals>.<listcomp>)rDrE�z*%r expects <dir> <pattern1> <pattern2> ...cSsg|]}t|��qSrrrRrrrr8�s)rFrGz!%r expects a single <dir_pattern>zunknown action %r)r0�len�insertrr)rrKZwordsrLrMrNZdir_patternrrrrH�s4���zManifest._parse_directiveTcCsPd}|�||||�}|jdkr&|��|jD]}|�|�r,|j�|�d}q,|S)a�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.
        FNT)�_translate_patternrr(�searchrr*)rrOr@r�is_regexrP�
pattern_rer%rrrrIs


zManifest._include_patterncCsBd}|�||||�}t|j�D]}|�|�r|j�|�d}q|S)atRemove 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
        FT)rV�listrrW�remove)rrOr@rrXrPrYr=rrrrJ)s
zManifest._exclude_patternc
Csv|rt|t�rt�|�S|Stdkr:|�d��d�\}}}|rR|�|�}tdkrVnd}t�tj	�
|jd��}	|dk	�r4tdkr�|�d�}
|�|�dt|
��}n&|�|�}|t|�t|�t|��}tj
}tj
dkr�d}tdk�rd|	|�
|d|f�}n0|t|�t|�t|��}d	||	||||f}n8|�rltdk�rRd|	|}nd
||	|t|�d�f}t�|�S)aTranslate 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).
        )rSrr4�N�\z\\�^z.*z%s%s%s%s.*%s%sz%s%s%s)�
isinstance�str�re�compile�_PYTHON_VERSION�_glob_to_re�	partition�escaper	r
rrrTr)
rrOr@rrX�startr4�endrYrZ
empty_patternZ	prefix_rerrrrrV=sF	







�

�
zManifest._translate_patterncCs8t�|�}tj}tjdkrd}d|}t�d||�}|S)z�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).
        r]z\\\\z\1[^%s]z((?<!\\)(\\\\)*)\.)�fnmatch�	translater	rra�sub)rrOrYrZescapedrrrrdts

zManifest._glob_to_re)N)F)TNF)TNF)TNF)�__name__�
__module__�__qualname__�__doc__rr(r*r-r;r>rQrHrIrJrVrdrrrrr%s&

	
O/�
)�
�
7)roriZloggingr	ra�sysr\r�compatr�utilr�__all__Z	getLoggerrlr.rb�MZ_COLLAPSE_PATTERN�SZ_COMMENTED_LINE�version_inforc�objectrrrrr�<module>s
site-packages/pip/_vendor/distlib/__pycache__/locators.cpython-38.pyc000064400000112601151446177000021636 0ustar00U

��.e_��@sDddlZddlmZddlZddlZddlZddlZddlZzddlZWne	k
rdddl
ZYnXddlZddlm
Z
ddlmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZddlm Z m!Z!m"Z"ddl#m$Z$m%Z%ddl&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/dd	l0m1Z1m2Z2dd
l3m4Z4m5Z5e�6e7�Z8e�9d�Z:e�9dej;�Z<e�9d
�Z=dZ>d-dd�Z?Gdd�de�Z@Gdd�deA�ZBGdd�deB�ZCGdd�deB�ZDGdd�deA�ZEGdd�deB�ZFGdd�deB�ZGGdd �d eB�ZHGd!d"�d"eB�ZIGd#d$�d$eB�ZJeJeH�eFd%d&d'�d(d)�ZKeKjLZLe�9d*�ZMGd+d,�d,eA�ZNdS).�N)�BytesIO�)�DistlibException)�urljoin�urlparse�
urlunparse�url2pathname�pathname2url�queue�quote�unescape�string_types�build_opener�HTTPRedirectHandler�	text_type�Request�	HTTPError�URLError)�Distribution�DistributionPath�	make_dist)�Metadata�MetadataInvalidError)	�cached_property�parse_credentials�ensure_slash�split_filename�get_project_data�parse_requirement�parse_name_and_version�ServerProxy�normalize_name)�
get_scheme�UnsupportedVersionError)�Wheel�
is_compatiblez^(\w+)=([a-f0-9]+)z;\s*charset\s*=\s*(.*)\s*$ztext/html|application/x(ht)?mlzhttps://pypi.org/pypicCs6|dkrt}t|dd�}z|��W�S|d��XdS)z�
    Return all distribution names known by an index.
    :param url: The URL of the index.
    :return: A list of all known distribution names.
    N�@��timeout�close)�
DEFAULT_INDEXr �
list_packages)�url�client�r.�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/locators.py�get_all_distribution_names)sr0c@s$eZdZdZdd�ZeZZZdS)�RedirectHandlerzE
    A class to work around a bug in some Python 3.2.x releases.
    c	Cs�d}dD]}||kr||}q"q|dkr.dSt|�}|jdkrnt|��|�}t|d�rf|�||�n|||<t�||||||�S)N)�locationZuri��replace_header)r�schemerZget_full_url�hasattrr4�BaseRedirectHandler�http_error_302)	�self�req�fp�code�msg�headersZnewurl�keyZurlpartsr.r.r/r8@s 

�zRedirectHandler.http_error_302N)�__name__�
__module__�__qualname__�__doc__r8Zhttp_error_301Zhttp_error_303Zhttp_error_307r.r.r.r/r17sr1c@s�eZdZdZdZdZdZdZedZd)dd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
dd�Zee
e�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd d!�Zd"d#�Zd$d%�Zd*d'd(�ZdS)+�LocatorzG
    A base class for locators - things that locate distributions.
    )z.tar.gzz.tar.bz2z.tarz.zipz.tgzz.tbz)z.eggz.exe�.whl)z.pdfN)rE�defaultcCs,i|_||_tt��|_d|_t��|_dS)a^
        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.
        N)	�_cacher5rr1�opener�matcherr
�Queue�errors)r9r5r.r.r/�__init__fs
zLocator.__init__cCsVg}|j��sRz|j�d�}|�|�Wn|jjk
rDYqYnX|j��q|S)z8
        Return any errors which have occurred.
        F)rK�empty�get�appendZEmpty�	task_done)r9�result�er.r.r/�
get_errorsys

zLocator.get_errorscCs|��dS)z>
        Clear any errors which may have been logged.
        N)rS�r9r.r.r/�clear_errors�szLocator.clear_errorscCs|j��dS�N)rG�clearrTr.r.r/�clear_cache�szLocator.clear_cachecCs|jSrV��_schemerTr.r.r/�_get_scheme�szLocator._get_schemecCs
||_dSrVrY)r9�valuer.r.r/�_set_scheme�szLocator._set_schemecCstd��dS)a=
        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.
        � Please implement in the subclassN��NotImplementedError)r9�namer.r.r/�_get_project�s
zLocator._get_projectcCstd��dS)�J
        Return all the distribution names known to this locator.
        r^Nr_rTr.r.r/�get_distribution_names�szLocator.get_distribution_namescCsL|jdkr|�|�}n2||jkr,|j|}n|��|�|�}||j|<|S)z�
        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.
        N)rGrbrU)r9rarQr.r.r/�get_project�s



zLocator.get_projectcCs^t|�}t�|j�}d}|�d�}|�|j�}|rBtt|�|j�}|j	dkd|j
k||||fS)zu
        Give an url a score which can be used to choose preferred URLs
        for a given project release.
        TrE�httpszpypi.org)r�	posixpath�basename�path�endswith�downloadable_extensionsr%r$�
wheel_tagsr5�netloc)r9r,�trhZ
compatibleZis_wheelZis_downloadabler.r.r/�	score_url�s
�zLocator.score_urlcCsR|}|rN|�|�}|�|�}||kr(|}||kr@t�d||�nt�d||�|S)a{
        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.
        zNot replacing %r with %rzReplacing %r with %r)ro�logger�debug)r9�url1�url2rQ�s1�s2r.r.r/�
prefer_url�s


zLocator.prefer_urlcCs
t||�S)zZ
        Attempt to split a filename in project name, version and Python version.
        )r)r9�filename�project_namer.r.r/r�szLocator.split_filenamecCsdd�}d}t|�\}}}}}	}
|
���d�r<t�d||
�t�|
�}|rX|��\}}
nd\}}
|}|r�|ddkr�|dd�}|�d	��r>z~t	|�}t
||j�s�t�d
|�nX|dkr�d}n||j|�}|�r|j|j
|jt|||||	df�d
�dd�|jD��d�}Wn0tk
�r:}zt�d|�W5d}~XYnXn�|�|j��sZt�d|�n�t�|�}}|jD]�}|�|��rn|dt|��}|�||�}|�s�t�d|�nH|\}}}|�r�|||��r�|||t|||||	df�d�}|�r�||d<�q�qn|�r|�r|
|d|<|S)a
        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.
        cSst|�t|�kSrV)r!)Zname1Zname2r.r.r/�same_project�sz:Locator.convert_url_to_download_info.<locals>.same_projectNzegg=z %s: version hint in fragment: %r)NN����/rEzWheel not compatible: %sTr3z, cSs"g|]}d�t|dd����qS)�.�N)�join�list)�.0�vr.r.r/�
<listcomp>sz8Locator.convert_url_to_download_info.<locals>.<listcomp>)ra�versionrwr,�python-versionzinvalid path for wheel: %szNot downloadable: %sz No match for project/version: %s)rar�rwr,r��	%s_digest)r�lower�
startswithrprq�HASHER_HASH�match�groupsrjr$r%rlrar�rwrr~�pyver�	Exception�warningrkrgrh�lenr)r9r,rxryrQr5rmri�params�query�frag�m�algo�digestZorigpath�wheelZincluderRrwZextrnrar�r�r.r.r/�convert_url_to_download_info�s��
���
	 

��
z$Locator.convert_url_to_download_infocCs2d}dD]$}d|}||kr|||f}q.q|S)z�
        Get a digest from a dictionary by looking at keys of the form
        'algo_digest'.

        Returns a 2-tuple (algo, digest) if found, else None. Currently
        looks only for SHA256, then MD5.
        N)Zsha256�md5r�r.)r9�inforQr�r?r.r.r/�_get_digest1szLocator._get_digestc	Cs�|�d�}|�d�}||kr,||}|j}nt|||jd�}|j}|�|�|_}|d}||d|<|j|dkr�|�|j|�|_|d�|t	���
|�||_|||<dS)z�
        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.
        rar��r5r,�digests�urlsN)�pop�metadatarr5r�r��
source_urlrv�
setdefault�set�add�locator)	r9rQr�rar��dist�mdr�r,r.r.r/�_update_version_dataAs

zLocator._update_version_dataFc	Cs�d}t|�}|dkr td|��t|j�}|�|j�|_}t�d|t|�j	�|�
|j�}t|�dk�r2g}|j
}	|D]z}
|
dkr�qxzH|�|
�s�t�d||
�n*|s�|	|
�js�|�|
�nt�d|
|j�Wqxtk
r�t�d||
�YqxXqxt|�d	k�rt||jd
�}|�r2t�d|�|d}||}|�r�|j�rH|j|_|�d
i��|t��|_i}|�di�}
|jD]}||
k�rv|
|||<�qv||_d|_|S)a
        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.
        NzNot a valid requirement: %rzmatcher: %s (%s)r}�r�r�z%s did not match %rz%skipping pre-release version %s of %szerror matching %s with %rr)r?zsorted list: %srzr�r�)rrr"r5rI�requirementrprq�typer@rerar�Z
version_classr�Z
is_prereleaserOr�r��sortedr?ZextrasrNr��
download_urlsr�)r9r��prereleasesrQ�rr5rI�versionsZslistZvcls�kr��dZsdr,r.r.r/�locateXsX


�

zLocator.locate)rF)F)r@rArBrC�source_extensions�binary_extensions�excluded_extensionsrlrkrLrSrUrXr[r]�propertyr5rbrdrerorvrr�r�r�r�r.r.r.r/rDVs.

JrDcs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�PyPIRPCLocatorz�
    This locator uses XML-RPC to locate distributions. It therefore
    cannot be used with simple mirrors (that only mirror file content).
    cs*tt|�jf|�||_t|dd�|_dS)z�
        Initialise an instance.

        :param url: The URL to use for XML-RPC.
        :param kwargs: Passed to the superclass constructor.
        r&r'N)�superr�rL�base_urlr r-�r9r,�kwargs��	__class__r.r/rL�szPyPIRPCLocator.__init__cCst|j���S�rc)r�r-r+rTr.r.r/rd�sz%PyPIRPCLocator.get_distribution_namescCsiid�}|j�|d�}|D]�}|j�||�}|j�||�}t|jd�}|d|_|d|_|�d�|_	|�dg�|_
|�d�|_t|�}|r|d	}	|	d
|_
|�|	�|_||_|||<|D]:}	|	d
}
|�|	�}|d�|t���|
�||d|
<q�q|S)
Nr�Tr�rar��license�keywords�summaryrr,r�r�)r-Zpackage_releasesZrelease_urlsZrelease_datarr5rar�rNr�r�r�rr�r�r�r�r�r�r�)r9rarQr�r�r��datar�r�r�r,r�r.r.r/rb�s0




zPyPIRPCLocator._get_project�r@rArBrCrLrdrb�
__classcell__r.r.r�r/r��sr�cs0eZdZdZ�fdd�Zdd�Zdd�Z�ZS)�PyPIJSONLocatorzw
    This locator uses PyPI's JSON interface. It's very limited in functionality
    and probably not worth using.
    cs tt|�jf|�t|�|_dSrV)r�r�rLrr�r�r�r.r/rL�szPyPIJSONLocator.__init__cCstd��dS�rczNot available from this locatorNr_rTr.r.r/rd�sz&PyPIJSONLocator.get_distribution_namesc
Cs
iid�}t|jdt|��}�z�|j�|�}|����}t�|�}t	|j
d�}|d}|d|_|d|_|�
d�|_|�
dg�|_|�
d	�|_t|�}||_|d
}	|||j<|d
D]T}
|
d}|j�|�|�|
�|j|<|d
�|jt���|�|�|
�|d|<q�|d
��D]�\}}||jk�r4�qt	|j
d�}
|j|
_||
_t|
�}||_|||<|D]T}
|
d}|j�|�|�|
�|j|<|d
�|t���|�|�|
�|d|<�qh�qWn@tk
�r}z |j�t|��t�d|�W5d}~XYnX|S)Nr�z%s/jsonr�r�rar�r�r�r�r�r,r�ZreleaseszJSON fetch failed: %s) rr�rrH�open�read�decode�json�loadsrr5rar�rNr�r�r�rr�r�r�r�r�r�r��itemsr�rK�putrrp�	exception)r9rarQr,�respr�r�r�r�r�r�r�ZinfosZomd�odistrRr.r.r/rb�sT




	zPyPIJSONLocator._get_projectr�r.r.r�r/r��sr�c@s`eZdZdZe�dejejBejB�Z	e�dejejB�Z
dd�Ze�dej�Ze
dd��Zd	S)
�Pagez4
    This class represents a scraped HTML page.
    z�
(rel\s*=\s*(?:"(?P<rel1>[^"]*)"|'(?P<rel2>[^']*)'|(?P<rel3>[^>\s
]*))\s+)?
href\s*=\s*(?:"(?P<url1>[^"]*)"|'(?P<url2>[^']*)'|(?P<url3>[^>\s
]*))
(\s+rel\s*=\s*(?:"(?P<rel4>[^"]*)"|'(?P<rel5>[^']*)'|(?P<rel6>[^>\s
]*)))?
z!<base\s+href\s*=\s*['"]?([^'">]+)cCs4||_||_|_|j�|j�}|r0|�d�|_dS)zk
        Initialise an instance with the Unicode page contents and the URL they
        came from.
        rN)r�r�r,�_base�search�group)r9r�r,r�r.r.r/rLs
z
Page.__init__z[^a-z0-9$&+,/:;=?@.#%_\\|-]cCs�dd�}t�}|j�|j�D]�}|�d�}|dpX|dpX|dpX|dpX|dpX|d	}|d
pp|dpp|d}t|j|�}t|�}|j�	d
d�|�}|�
||f�qt|dd�dd�}|S)z�
        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.
        cSs,t|�\}}}}}}t||t|�|||f�S)zTidy up an URL.)rrr)r,r5rmrir�r�r�r.r.r/�clean-s�zPage.links.<locals>.cleanr3Zrel1Zrel2Zrel3Zrel4Zrel5Zrel6rrrsZurl3cSsdt|�d��S)Nz%%%2xr)�ordr�)r�r.r.r/�<lambda>;�zPage.links.<locals>.<lambda>cSs|dS)Nrr.)rnr.r.r/r�?r�T)r?�reverse)r��_href�finditerr��	groupdictrr�r�	_clean_re�subr�r�)r9r�rQr�r��relr,r.r.r/�links&s$
���z
Page.linksN)r@rArBrC�re�compile�I�S�Xr�r�rLr�rr�r.r.r.r/r�	s�r�cs�eZdZdZejdd�dd�d�Zd�fdd	�	Zd
d�Zdd
�Z	dd�Z
e�dej
�Zdd�Zdd�Zdd�Zdd�Zdd�Ze�d�Zdd�Z�ZS)�SimpleScrapingLocatorz�
    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.
    cCstjtt�d���S)N)Zfileobj)�gzipZGzipFilerr�r���br.r.r/r�Mr�zSimpleScrapingLocator.<lambda>cCs|SrVr.r�r.r.r/r�Nr�)Zdeflater�ZnoneN�
csltt|�jf|�t|�|_||_i|_t�|_t	�
�|_t�|_d|_
||_t��|_t��|_d|_dS)a�
        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.
        FN)r�r�rLrr�r(�_page_cacher��_seenr
rJ�	_to_fetch�
_bad_hosts�skip_externals�num_workers�	threading�RLock�_lock�_gplock�platform_check)r9r,r(r�r�r�r.r/rLQs




zSimpleScrapingLocator.__init__cCsFg|_t|j�D]0}tj|jd�}|�d�|��|j�|�qdS)z�
        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).
        )�targetTN)	�_threads�ranger�r�ZThread�_fetchZ	setDaemon�startrO)r9�irnr.r.r/�_prepare_threadsls
z&SimpleScrapingLocator._prepare_threadscCs6|jD]}|j�d�q|jD]}|��qg|_dS)zu
        Tell all the threads to terminate (by sending a sentinel value) and
        wait for them to do so.
        N)r�r�r�r~)r9rnr.r.r/�
_wait_threadsys



z#SimpleScrapingLocator._wait_threadsc	Cs�iid�}|j�x||_||_t|jdt|��}|j��|j��|�	�z&t�d|�|j
�|�|j
��W5|�
�X|`W5QRX|S)Nr�z%s/zQueueing %s)r�rQrxrr�rr�rWr�r�r�rprqr�r�r~)r9rarQr,r.r.r/rb�s



z"SimpleScrapingLocator._get_projectz<\b(linux_(i\d86|x86_64|arm\w+)|win(32|_amd64)|macosx_?\d+)\bcCs|j�|�S)zD
        Does an URL refer to a platform-specific download?
        )�platform_dependentr�)r9r,r.r.r/�_is_platform_dependent�sz,SimpleScrapingLocator._is_platform_dependentc	CsZ|jr|�|�rd}n|�||j�}t�d||�|rV|j�|�|j|�W5QRX|S)a%
        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.
        Nzprocess_download: %s -> %s)	r�r�r�rxrprqr�r�rQ)r9r,r�r.r.r/�_process_download�s
z'SimpleScrapingLocator._process_downloadc
Cs�t|�\}}}}}}|�|j|j|j�r2d}n||jrJ|�|j�sJd}nd|�|j�s\d}nR|dkrjd}nD|dkrxd}n6|�|�r�d}n&|�	dd�d}	|	�
�dkr�d}nd}t�d	||||�|S)
z�
        Determine whether a link URL from a referring page and with a
        particular "rel" attribute should be queued for scraping.
        F)ZhomepageZdownload)ZhttprfZftp�:rrZ	localhostTz#should_queue: %s (%s) from %s -> %s)
rrjr�r�r�r�r�r�r��splitr�rprq)
r9�linkZreferrerr�r5rmri�_rQ�hostr.r.r/�
_should_queue�s0�

�z#SimpleScrapingLocator._should_queuec
Cs�|j��}z�z�|r�|�|�}|dkr,WW��q|jD]j\}}||jkr2zB|j�|�|�|�s�|�|||�r�t	�
d||�|j�|�Wq2tk
r�Yq2Xq2Wn2t
k
r�}z|j�t|��W5d}~XYnXW5|j��X|sq�qdS)z�
        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.
        NzQueueing %s from %s)r�rNrP�get_pager�r�r�r�rrprqr�rr�rKr)r9r,�pagerr�rRr.r.r/r��s,



�&zSimpleScrapingLocator._fetchcCsXt|�\}}}}}}|dkr:tj�t|��r:tt|�d�}||jkr`|j|}t�	d||��n�|�
dd�d}d}||jkr�t�	d||��n�t|d	d
id�}�z�z�t�	d|�|j
j||jd
�}	t�	d|�|	��}
|
�dd�}t�|��r�|	��}|	��}
|
�d�}|�r"|j|}||
�}
d}t�|�}|�r@|�d�}z|
�|�}
Wn tk
�rn|
�d�}
YnXt|
|�}||j|<Wn�tk
�r�}z|jdk�r�t�d||�W5d}~XYn�t k
�r}z0t�d||�|j!�|j�"|�W5QRXW5d}~XYn2t#k
�rB}zt�d||�W5d}~XYnXW5||j|<X|S)a
        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).
        �filez
index.htmlzReturning %s from cache: %srrrNzSkipping %s due to bad host %szAccept-encodingZidentity)r>zFetching %sr'z
Fetched %szContent-Typer3zContent-Encodingzutf-8zlatin-1i�zFetch failed: %s: %s)$r�osri�isdirrrrr�rprqrr�rrHr�r(r�rN�HTML_CONTENT_TYPEr�Zgeturlr��decoders�CHARSETr�r�r��UnicodeErrorr�rr<r�rr�r�r�)r9r,r5rmrirrQrr:r�r>Zcontent_typeZ	final_urlr��encoding�decoderr�rRr.r.r/r�sZ	







&$zSimpleScrapingLocator.get_pagez<a href=[^>]*>([^<]+)<cCsLt�}|�|j�}|s$td|j��|j�|j�D]}|�|�d��q2|S)rczUnable to get %sr)	r�rr�r�_distname_rer�r�r�r�)r9rQrr�r.r.r/rd0sz,SimpleScrapingLocator.get_distribution_names)Nr�)r@rArBrC�zlib�
decompressrrLr�r�rbr�r�r�r�r�r�rr�rrrdr�r.r.r�r/r�Cs&�

�!;
r�cs8eZdZdZ�fdd�Zdd�Zdd�Zdd	�Z�ZS)
�DirectoryLocatorz?
    This class locates distributions in a directory tree.
    csN|�dd�|_tt|�jf|�tj�|�}tj�|�sDt	d|��||_
dS)a�
        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,
        �	recursiveTzNot a directory: %rN)r�rr�rrLr	ri�abspathr
r�base_dir)r9rir�r�r.r/rLAs
zDirectoryLocator.__init__cCs|�|j�S)z�
        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.
        )rjrk)r9rw�parentr.r.r/�should_includeRszDirectoryLocator.should_includec		Cs�iid�}t�|j�D]t\}}}|D]Z}|�||�r$tj�||�}tddttj�|��dddf�}|�	||�}|r$|�
||�q$|jsq�q|S)Nr�rr3)r	�walkrrrir~rr	rr�r�r)	r9rarQ�root�dirs�files�fnr,r�r.r.r/rbZs"
�zDirectoryLocator._get_projectc	Cs�t�}t�|j�D]v\}}}|D]\}|�||�r tj�||�}tddttj�	|��dddf�}|�
|d�}|r |�|d�q |jsq�q|S)rcrr3Nra)
r�r	rrrrir~rr	rr�r�r)r9rQrrrrr,r�r.r.r/rdjs"�z'DirectoryLocator.get_distribution_names)	r@rArBrCrLrrbrdr�r.r.r�r/r<s
rc@s eZdZdZdd�Zdd�ZdS)�JSONLocatora
    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.
    cCstd��dSr�r_rTr.r.r/rd�sz"JSONLocator.get_distribution_namescCs�iid�}t|�}|r�|�dg�D]�}|ddks"|ddkr@q"t|d|d|�d	d
�|jd�}|j}|d|_d
|kr�|d
r�d|d
f|_|�di�|_|�di�|_|||j	<|d�
|j	t���|d�q"|S)Nr�rZptypeZsdistZ	pyversion�sourcerar�r�zPlaceholder for summary)r�r5r,r�r�Zrequirements�exportsr�)
rrNrr5r�r�r�Zdependenciesr!r�r�r�r�)r9rarQr�r�r�r�r.r.r/rb�s*
��

 zJSONLocator._get_projectN)r@rArBrCrdrbr.r.r.r/r}srcs(eZdZdZ�fdd�Zdd�Z�ZS)�DistPathLocatorz�
    This locator finds installed distributions in a path. It can be useful for
    adding to an :class:`AggregatingLocator`.
    cs*tt|�jf|�t|t�s t�||_dS)zs
        Initialise an instance.

        :param distpath: A :class:`DistributionPath` instance to search.
        N)r�r"rL�
isinstancer�AssertionError�distpath)r9r%r�r�r.r/rL�szDistPathLocator.__init__cCsP|j�|�}|dkr iid�}n,|j|d|jt|jg�id|jtdg�ii}|S)Nr�r�r�)r%Zget_distributionr�r�r�)r9rar�rQr.r.r/rb�s�zDistPathLocator._get_project)r@rArBrCrLrbr�r.r.r�r/r"�s
r"csReZdZdZ�fdd�Z�fdd�Zdd�Zeej	j
e�Z	dd	�Zd
d�Z�Z
S)�AggregatingLocatorzI
    This class allows you to chain and/or merge a list of locators.
    cs*|�dd�|_||_tt|�jf|�dS)a�
        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).
        �mergeFN)r�r'�locatorsr�r&rL)r9r(r�r�r.r/rL�szAggregatingLocator.__init__cs&tt|���|jD]}|��qdSrV)r�r&rXr(�r9r�r�r.r/rX�s
zAggregatingLocator.clear_cachecCs||_|jD]
}||_qdSrV)rZr(r5)r9r\r�r.r.r/r]�s
zAggregatingLocator._set_schemecCs�i}|jD]�}|�|�}|r
|jr�|�di�}|�di�}|�|�|�d�}|r�|r�|��D]*\}}	||kr�|||	O<q^|	||<q^|�d�}
|r�|
r�|
�|�q
|jdkr�d}n"d}|D]}|j�|�r�d}q�q�|r
|}q�q
|S)Nr�r�TF)r(rer'rN�updater�rIr�)r9rarQr�r�rr�Zdfr�r�Zdd�foundr.r.r/rb�s8






zAggregatingLocator._get_projectc	Cs<t�}|jD]*}z||��O}Wqtk
r4YqXq|Sr�)r�r(rdr`)r9rQr�r.r.r/rds
z)AggregatingLocator.get_distribution_names)r@rArBrCrLrXr]r�rDr5�fgetrbrdr�r.r.r�r/r&�s,r&zhttps://pypi.org/simple/r&r'�legacyr�z1(?P<name>[\w-]+)\s*\(\s*(==\s*)?(?P<ver>[^)]+)\)$c@sLeZdZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	ddd�Z
dS)�DependencyFinderz0
    Locate dependencies for distributions.
    NcCs|pt|_t|jj�|_dS)zf
        Initialise an instance, using the specified locator
        to locate distributions.
        N)�default_locatorr�r"r5r)r.r.r/rL*s
zDependencyFinder.__init__cCsrt�d|�|j}||j|<||j||jf<|jD]:}t|�\}}t�d|||�|j�	|t
���||f�q2dS)z�
        Add a distribution to the finder. This will update internal information
        about who provides what.
        :param dist: The distribution to add.
        zadding distribution %szAdd to provided: %s, %s, %sN)rprqr?�
dists_by_name�distsr��providesr�providedr�r�r�)r9r�ra�pr�r.r.r/�add_distribution2s

z!DependencyFinder.add_distributioncCsxt�d|�|j}|j|=|j||jf=|jD]D}t|�\}}t�d|||�|j|}|�	||f�|s.|j|=q.dS)z�
        Remove a distribution from the finder. This will update internal
        information about who provides what.
        :param dist: The distribution to remove.
        zremoving distribution %sz Remove from provided: %s, %s, %sN)
rprqr?r0r1r�r2rr3�remove)r9r�rar4r��sr.r.r/�remove_distributionAs

z$DependencyFinder.remove_distributioncCsBz|j�|�}Wn,tk
r<|��d}|j�|�}YnX|S)z�
        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`).
        r)r5rIr#r)r9�reqtrIrar.r.r/�get_matcherSszDependencyFinder.get_matcherc		Cst|�|�}|j}t�}|j}||krp||D]B\}}z|�|�}Wntk
rZd}YnX|r,|�|�qpq,|S)z�
        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.
        F)r:r?r�r3r�r#r�)	r9r9rIrarQr3r��providerr�r.r.r/�find_providerscs


zDependencyFinder.find_providersc	Cs�|j|}t�}|D]$}|�|�}|�|j�s|�|�q|rZ|�d||t|�f�d}n@|�|�|j|=|D]}|j�|t���|�qp|�	|�d}|S)a�
        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.
        ZcantreplaceFT)
�reqtsr�r:r�r�r��	frozensetr8r�r5)	r9r;�other�problemsZrlistZ	unmatchedr7rIrQr.r.r/�try_to_replace{s$


�

zDependencyFinder.try_to_replaceFcCs�i|_i|_i|_i|_t|p g�}d|krH|�d�|tdddg�O}t|t�rh|}}t�	d|�n4|j
j||d�}}|dkr�td|��t�	d	|�d
|_
t�}t|g�}t|g�}|�r�|��}|j}	|	|jkr�|�|�n"|j|	}
|
|k�r|�||
|�|j|jB}|j}t�}
|�r`||k�r`dD]*}d|}||k�r4|
t|d
|�O}
�q4||B|
B}|D�].}|�|�}|�sFt�	d|�|j
j||d�}|dk�r�|�s�|j
j|d
d�}|dk�r�t�	d|�|�d|f�n^|j|j}}||f|jk�r|�|�|�|�||k�rF||k�rF|�|�t�	d|j�|D]R}|j}	|	|jk�rx|j�|t���|�n"|j|	}
|
|k�rJ|�||
|��qJ�qpq�t|j���}|D]&}||k|_|j�r�t�	d|j��q�t�	d|�||fS)a�
        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.
        z:*:z:test:z:build:z:dev:zpassed %s as requirement)r�NzUnable to locate %rz
located %sT)ZtestZbuildZdevz:%s:z%s_requireszNo providers found for %rzCannot satisfy %rZunsatisfiedzAdding %s to install_distsz#%s is a build-time dependency only.zfind done for %s)r3r1r0r=r�r6r#rrprqr�r�rZ	requestedr�r?r5rAZrun_requiresZ
meta_requiresZbuild_requires�getattrr<r�r�Zname_and_versionr��valuesZbuild_time_dependency)r9r�Zmeta_extrasr�r�r�r@ZtodoZ
install_distsrar?ZireqtsZsreqtsZereqtsr?rRZ	all_reqtsr�Z	providersr;�nr�r4r1r.r.r/�find�s�

�












�


�zDependencyFinder.find)N)NF)r@rArBrCrLr5r8r:r<rArEr.r.r.r/r.%s
(r.)N)Or��iorr�Zloggingr	rgr�r��ImportErrorZdummy_threadingrr3r�compatrrrrr	r
rrr
rrr7rrrrZdatabaserrrr�rr�utilrrrrrrrr r!r�r"r#r�r$r%Z	getLoggerr@rpr�r�r�r
rr*r0r1�objectrDr�r�r�r�rrr"r&r/r�ZNAME_VERSION_REr.r.r.r.r/�<module>s^D,



@0E:zA&[��
site-packages/pip/_vendor/distlib/__pycache__/index.cpython-38.opt-1.pyc000064400000041737151446177000022071 0ustar00U

��.eJR�@s�ddlZddlZddlZddlZddlZddlZzddlmZWn ek
r`ddl	mZYnXddl
mZddlm
Z
mZmZmZmZmZddlmZmZmZe�e�ZdZdZGd	d
�d
e�ZdS)�N)�Thread�)�DistlibException)�HTTPBasicAuthHandler�Request�HTTPPasswordMgr�urlparse�build_opener�string_types)�cached_property�zip_dir�ServerProxyzhttps://pypi.org/pypi�pypic@s�eZdZdZdZd*dd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zd+dd�Zd,dd�Z
d-dd�Zd.dd�Zdd�Zd/dd�Zd0d d!�Zd1d"d#�Zd$d%�Zd&d'�Zd2d(d)�ZdS)3�PackageIndexzc
    This class represents a package index compatible with PyPI, the Python
    Package Index.
    s.----------ThIs_Is_tHe_distlib_index_bouNdaRY_$Nc
Cs�|pt|_|��t|j�\}}}}}}|s<|s<|s<|dkrJtd|j��d|_d|_d|_d|_t	t
jd��R}dD]F}	z,tj
|	dg||d�}
|
dkr�|	|_Wq�Wqttk
r�YqtXqtW5QRXdS)	z�
        Initialise an instance.

        :param url: The URL of the index. If not specified, the URL for PyPI is
                    used.
        )ZhttpZhttpszinvalid repository: %sN�w)�gpgZgpg2z	--version��stdout�stderrr)�
DEFAULT_INDEX�url�read_configurationrr�password_handler�ssl_verifierr�gpg_home�open�os�devnull�
subprocessZ
check_call�OSError)�selfrZscheme�netloc�pathZparamsZqueryZfragZsink�s�rc�r%�=/usr/lib/python3.8/site-packages/pip/_vendor/distlib/index.py�__init__$s(
�
zPackageIndex.__init__cCs&ddlm}ddlm}|�}||�S)zs
        Get the distutils command for interacting with PyPI configurations.
        :return: the command.
        r)�Distribution)�
PyPIRCCommand)Zdistutils.corer(Zdistutils.configr))r r(r)�dr%r%r&�_get_pypirc_commandAsz PackageIndex._get_pypirc_commandcCsR|��}|j|_|��}|�d�|_|�d�|_|�dd�|_|�d|j�|_dS)z�
        Read the PyPI access configuration as supported by distutils, getting
        PyPI to do the actual work. This populates ``username``, ``password``,
        ``realm`` and ``url`` attributes from the configuration.
        �username�password�realmr�
repositoryN)r+rr/Z_read_pypirc�getr,r-r.)r �cZcfgr%r%r&rKszPackageIndex.read_configurationcCs$|��|��}|�|j|j�dS)z�
        Save the PyPI access configuration. You must have set ``username`` and
        ``password`` attributes before calling this method.

        Again, distutils is used to do the actual work.
        N)�check_credentialsr+Z
_store_pypircr,r-)r r1r%r%r&�save_configurationZszPackageIndex.save_configurationcCs\|jdks|jdkrtd��t�}t|j�\}}}}}}|�|j||j|j�t|�|_	dS)zp
        Check that ``username`` and ``password`` have been set, and raise an
        exception if not.
        Nz!username and password must be set)
r,r-rrrrZadd_passwordr.rr)r Zpm�_r!r%r%r&r2fszPackageIndex.check_credentialscCs\|��|��|��}d|d<|�|��g�}|�|�}d|d<|�|��g�}|�|�S)aq
        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.
        Zverify�:actionZsubmit)r2�validate�todict�encode_request�items�send_request)r �metadatar*�requestZresponser%r%r&�registerrs

zPackageIndex.registercCsF|��}|sq:|�d���}|�|�t�d||f�q|��dS)ar
        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.
        �utf-8z%s: %sN)�readline�decode�rstrip�append�logger�debug�close)r �name�streamZoutbufr#r%r%r&�_reader�s

zPackageIndex._readerc	Cs�|jdddg}|dkr|j}|r.|�d|g�|dk	rF|�dddg�t��}tj�|tj�|�d	�}|�d
dd|d
||g�t	�
dd�|��||fS)a�
        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`.
        �--status-fd�2�--no-ttyN�	--homedirz--batchz--passphrase-fd�0z.ascz
--detach-signz--armorz--local-userz--output�invoking: %s� )rr�extend�tempfileZmkdtemprr"�join�basenamerCrD)r �filename�signer�
sign_password�keystore�cmdZtdZsfr%r%r&�get_sign_command�s"
�zPackageIndex.get_sign_commandc	Cs�tjtjd�}|dk	r tj|d<g}g}tj|f|�}t|jd|j|fd�}|��t|jd|j|fd�}|��|dk	r�|j�	|�|j�
�|��|��|��|j
||fS)a�
        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``.
        rN�stdinr)�target�argsr)r�PIPE�PopenrrHr�startrrZ�writerE�waitrR�
returncode)	r rXZ
input_data�kwargsrr�p�t1�t2r%r%r&�run_command�s&�

zPackageIndex.run_commandc
CsD|�||||�\}}|�||�d��\}}}	|dkr@td|��|S)aR
        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.
        r>rz&sign command failed with error code %s)rYrg�encoder)
r rTrUrVrWrX�sig_filer$rrr%r%r&�	sign_file�s
��
�zPackageIndex.sign_file�sdist�sourcec	Cs(|��tj�|�s td|��|��|��}d}	|rZ|jsJt�	d�n|�
||||�}	t|d��}
|
��}W5QRXt
�|���}t
�|���}
|�dd||||
d��dtj�|�|fg}|	�rt|	d��}
|
��}W5QRX|�d	tj�|	�|f�t�tj�|	��|�|��|�}|�|�S)
a�
        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.
        z
not found: %sNz)no signing program available - not signed�rbZfile_upload�1)r5Zprotocol_version�filetype�	pyversion�
md5_digest�
sha256_digest�contentZ
gpg_signature)r2rr"�existsrr6r7rrCZwarningrjr�read�hashlib�md5�	hexdigestZsha256�updaterSrB�shutilZrmtree�dirnamer8r9r:)r r;rTrUrVrorprWr*ri�fZ	file_datarqrr�filesZsig_datar<r%r%r&�upload_file�sD
���zPackageIndex.upload_filec
Cs�|��tj�|�s td|��tj�|d�}tj�|�sFtd|��|��|j|j	}}t
|���}dd|fd|fg}d||fg}|�||�}	|�
|	�S)a2
        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.
        znot a directory: %rz
index.htmlz
not found: %r)r5Z
doc_uploadrF�versionrs)r2rr"�isdirrrRrtr6rFrr�getvaluer8r:)
r r;Zdoc_dir�fnrFrZzip_data�fieldsr}r<r%r%r&�upload_documentation(s 
�z!PackageIndex.upload_documentationcCsT|jdddg}|dkr|j}|r.|�d|g�|�d||g�t�dd�|��|S)	a|
        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`.
        rIrJrKNrLz--verifyrNrO)rrrPrCrDrR)r �signature_filename�
data_filenamerWrXr%r%r&�get_verify_commandDszPackageIndex.get_verify_commandcCsH|jstd��|�|||�}|�|�\}}}|dkr@td|��|dkS)a6
        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.
        z0verification unavailable because gpg unavailable)rrz(verify command failed with error code %sr)rrr�rg)r r�r�rWrXr$rrr%r%r&�verify_signature\s��zPackageIndex.verify_signaturec	Csl|dkrd}t�d�n6t|ttf�r0|\}}nd}tt|��}t�d|�t|d���}|�t	|��}z�|��}	d}
d}d}d}
d	|	kr�t|	d
�}|r�||
|
|�|�
|
�}|s�q�|t|�7}|�|�|r�|�|�|
d7}
|r�||
|
|�q�W5|�
�XW5QRX|dk�r0||k�r0td||f��|�rh|��}||k�r\td
||||f��t�d|�dS)a
        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.
        NzNo digest specifiedrwzDigest specified: %s�wbi ���rzcontent-lengthzContent-Lengthrz1retrieval incomplete: got only %d out of %d bytesz.%s digest mismatch for %s: expected %s, got %szDigest verified: %s)rCrD�
isinstance�list�tuple�getattrrvrr:rrE�info�intru�lenr`ryrrx)r rZdestfileZdigestZ
reporthookZdigesterZhasherZdfpZsfp�headersZ	blocksize�sizeruZblocknum�block�actualr%r%r&�
download_fileus^



��
��zPackageIndex.download_filecCs:g}|jr|�|j�|jr(|�|j�t|�}|�|�S)z�
        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).
        )rrBrr	r)r ZreqZhandlersZopenerr%r%r&r:�szPackageIndex.send_requestc
Cs�g}|j}|D]L\}}t|ttf�s*|g}|D]*}|�d|d|�d�d|�d�f�q.q|D].\}}	}
|�d|d||	f�d�d|
f�q`|�d|ddf�d�|�}d|}|tt|��d�}
t	|j
||
�S)	a&
        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.
        s--z)Content-Disposition: form-data; name="%s"r>�z8Content-Disposition: form-data; name="%s"; filename="%s"s
smultipart/form-data; boundary=)zContent-typezContent-length)�boundaryr�r�r�rPrhrR�strr�rr)r r�r}�partsr��k�values�v�keyrT�valueZbodyZctr�r%r%r&r8�sD���
���

�zPackageIndex.encode_requestcCsFt|t�rd|i}t|jdd�}z|�||p.d�W�S|d��XdS)NrFg@)ZtimeoutrE�and)r�r
r
r�search)r Zterms�operatorZ	rpc_proxyr%r%r&r��s
zPackageIndex.search)N)N)N)N)NNrkrlN)N)N)NN)N)�__name__�
__module__�__qualname__�__doc__r�r'r+rr3r2r=rHrYrgrjr~r�r�r�r�r:r8r�r%r%r%r&rs6

�

#
�
9�
�

M+r)rvZloggingrrzrrQZ	threadingr�ImportErrorZdummy_threading�r�compatrrrrr	r
�utilrrr
Z	getLoggerr�rCrZ
DEFAULT_REALM�objectrr%r%r%r&�<module>s  
site-packages/pip/_vendor/distlib/__pycache__/manifest.cpython-38.pyc000064400000023725151446177000021626 0ustar00U

��.e�9�@s�dZddlZddlZddlZddlZddlZddlmZddlm	Z	ddl
mZdgZe�
e�Ze�dej�Ze�d	ejejB�Zejdd
�ZGdd�de�ZdS)zu
Class representing the list of files in a distribution.

Equivalent to distutils.filelist, but fixes some problems.
�N�)�DistlibException)�fsdecode��convert_path�Manifestz\\w*
z#.*?(?=
)|
(?=$)�c@szeZdZdZddd�Zdd�Zdd�Zd	d
�Zddd
�Zdd�Z	dd�Z
dd�Zddd�Zd dd�Z
d!dd�Zdd�ZdS)"rz~A list of files built by on exploring the filesystem and filtered by
    applying various patterns to what we find there.
    NcCs>tj�tj�|pt����|_|jtj|_d|_t	�|_
dS)zd
        Initialise an instance.

        :param base: The base directory to explore under.
        N)�os�path�abspath�normpath�getcwd�base�sep�prefix�allfiles�set�files)�selfr�r�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/manifest.py�__init__*szManifest.__init__cCs�ddlm}m}m}g|_}|j}|g}|j}|j}|r�|�}t�	|�}	|	D]R}
tj
�||
�}t�|�}|j}
||
�r�|�t
|��qN||
�rN||
�sN||�qNq6dS)zmFind all files under the base and set ``allfiles`` to the absolute
        pathnames of files found.
        r)�S_ISREG�S_ISDIR�S_ISLNKN)�statrrrrr�pop�appendr	�listdirr
�join�st_moder)rrrrr�root�stackr�push�names�name�fullnamer�moderrr�findall9s"


zManifest.findallcCs4|�|j�stj�|j|�}|j�tj�|��dS)zz
        Add a file to the manifest.

        :param item: The pathname to add. This can be relative to the base.
        N)	�
startswithrr	r
rrr�addr)r�itemrrrr*TszManifest.addcCs|D]}|�|�qdS)z�
        Add a list of files to the manifest.

        :param items: The pathnames to add. These can be relative to the base.
        N)r*)r�itemsr+rrr�add_many^szManifest.add_manyFcsb��fdd��t�j�}|rFt�}|D]}�|tj�|��q&||O}dd�tdd�|D��D�S)z8
        Return sorted files in directory order
        csJ|�|�t�d|�|�jkrFtj�|�\}}|dks<t��||�dS)Nzadd_dir added %s)��/)r*�logger�debugrr	r
�split�AssertionError)�dirs�d�parent�_��add_dirrrrr9ls

z Manifest.sorted.<locals>.add_dircSsg|]}tjj|��qSr)r	r
r)�.0Z
path_tuplerrr�
<listcomp>zsz#Manifest.sorted.<locals>.<listcomp>css|]}tj�|�VqdS)N)r	r
r2)r:r
rrr�	<genexpr>{sz"Manifest.sorted.<locals>.<genexpr>)rrr	r
�dirname�sorted)rZwantdirs�resultr4�frr8rr>gs
�zManifest.sortedcCst�|_g|_dS)zClear all collected files.N)rrr)rrrr�clear}szManifest.clearcCsj|�|�\}}}}|dkrB|D]}|j|dd�st�d|�q�n$|dkrf|D]}|j|dd�}qN�n|dkr�|D]}|j|dd�srt�d|�qrn�|d	kr�|D]}|j|dd�}q�n�|d
kr�|D] }|j||d�s�t�d||�q�n�|d
k�r
|D]}|j||d�}q�n\|dk�r2|jd|d��sft�d|�n4|dk�rZ|jd|d��sft�d|�ntd|��dS)av
        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
        �includeT)�anchorzno files found matching %r�exclude�global-includeFz3no files found matching %r anywhere in distribution�global-exclude�recursive-include)rz-no files found matching %r under directory %r�recursive-exclude�graftNz no directories found matching %r�prunez4no previously-included directories found matching %rzinvalid action %r)�_parse_directive�_include_patternr0Zwarning�_exclude_patternr)r�	directive�action�patterns�thedirZ
dirpattern�pattern�foundrrr�process_directive�sP��

�
��zManifest.process_directivecCs|��}t|�dkr,|ddkr,|�dd�|d}d}}}|dkrxt|�dkr`td|��d	d
�|dd�D�}n~|dkr�t|�dkr�td
|��t|d�}dd
�|dd�D�}n:|dkr�t|�dkr�td|��t|d�}ntd|��||||fS)z�
        Validate a directive.
        :param directive: The directive to validate.
        :return: A tuple of action, patterns, thedir, dir_patterns
        rr)rBrDrErFrGrHrIrJrBN)rBrDrErFrz$%r expects <pattern1> <pattern2> ...cSsg|]}t|��qSrr�r:Zwordrrrr;�sz-Manifest._parse_directive.<locals>.<listcomp>)rGrH�z*%r expects <dir> <pattern1> <pattern2> ...cSsg|]}t|��qSrrrUrrrr;�s)rIrJz!%r expects a single <dir_pattern>zunknown action %r)r2�len�insertrr)rrNZwordsrOrPrQZdir_patternrrrrK�s4���zManifest._parse_directiveTcCsPd}|�||||�}|jdkr&|��|jD]}|�|�r,|j�|�d}q,|S)a�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.
        FNT)�_translate_patternrr(�searchrr*)rrRrCr�is_regexrS�
pattern_rer%rrrrLs


zManifest._include_patterncCsBd}|�||||�}t|j�D]}|�|�r|j�|�d}q|S)atRemove 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
        FT)rY�listrrZ�remove)rrRrCrr[rSr\r@rrrrM)s
zManifest._exclude_patternc
Cs�|rt|t�rt�|�S|Stdkr:|�d��d�\}}}|rj|�|�}tdkrn|�|�rd|�|�snt	�nd}t�
tj�
|jd��}	|dk	�rftdkr�|�d�}
|�|�dt|
��}n>|�|�}|�|�r�|�|�s�t	�|t|�t|�t|��}tj}tjdk�rd}tdk�r4d|	|�
|d|f�}n0|t|�t|�t|��}d	||	||||f}n8|�r�tdk�r�d|	|}nd
||	|t|�d�f}t�|�S)aTranslate 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).
        )rVrr7r.N�\z\\�^z.*z%s%s%s%s.*%s%sz%s%s%s)�
isinstance�str�re�compile�_PYTHON_VERSION�_glob_to_re�	partitionr)�endswithr3�escaper	r
rrrWr)
rrRrCrr[�startr7�endr\rZ
empty_patternZ	prefix_rerrrrrY=sH	






�

�
zManifest._translate_patterncCs8t�|�}tj}tjdkrd}d|}t�d||�}|S)z�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).
        r_z\\\\z\1[^%s]z((?<!\\)(\\\\)*)\.)�fnmatch�	translater	rrc�sub)rrRr\rZescapedrrrrfts

zManifest._glob_to_re)N)F)TNF)TNF)TNF)�__name__�
__module__�__qualname__�__doc__rr(r*r-r>rArTrKrLrMrYrfrrrrr%s&

	
O/�
)�
�
7)rrrlZloggingr	rc�sysr.r�compatr�utilr�__all__Z	getLoggerror0rd�MZ_COLLAPSE_PATTERN�SZ_COMMENTED_LINE�version_infore�objectrrrrr�<module>s
site-packages/pip/_vendor/distlib/__pycache__/version.cpython-38.pyc000064400000047553151446177000021512 0ustar00U

��.e_[�@sfdZddlZddlZddlmZddlmZdddd	d
ddd
gZe�e	�Z
Gdd�de�ZGdd�de
�ZGdd�de
�Ze�d�Zdd�ZeZGdd�de�Zdd�ZGdd�de�Ze�d�dfe�d�dfe�d�dfe�d�d fe�d!�d"fe�d#�d"fe�d$�d%fe�d&�d'fe�d(�d)fe�d*�d+ff
Ze�d,�dfe�d-�dfe�d.�d%fe�d$�d%fe�d/�dffZe�d0�Zd1d2�Zd3d4�Ze�d5ej�Zd6d6d7d6d8ddd9�Zd:d;�ZGd<d�de�Z Gd=d	�d	e�Z!e�d>ej�Z"d?d@�Z#dAdB�Z$GdCd
�d
e�Z%GdDd�de�Z&GdEdF�dFe
�Z'e'eee�e'ee!dGdH��e'e$e&e�dI�Z(e(dJe(dK<dLd
�Z)dS)Mz~
Implementation of a flexible versioning scheme providing support for PEP-440,
setuptools-compatible and semantic versioning.
�N�)�string_types��parse_requirement�NormalizedVersion�NormalizedMatcher�
LegacyVersion�
LegacyMatcher�SemanticVersion�SemanticMatcher�UnsupportedVersionError�
get_schemec@seZdZdZdS)rzThis is an unsupported version.N)�__name__�
__module__�__qualname__�__doc__�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/distlib/version.pyrsc@sxeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zedd��ZdS)�VersioncCs@|��|_}|�|�|_}t|t�s,t�t|�dks<t�dS)Nr)�strip�_string�parse�_parts�
isinstance�tuple�AssertionError�len)�self�s�partsrrr�__init__szVersion.__init__cCstd��dS)Nzplease implement in a subclass��NotImplementedError�rrrrrr%sz
Version.parsecCs$t|�t|�kr td||f��dS)Nzcannot compare %r and %r)�type�	TypeError�r�otherrrr�_check_compatible(szVersion._check_compatiblecCs|�|�|j|jkS�N�r(rr&rrr�__eq__,s
zVersion.__eq__cCs|�|�Sr)�r+r&rrr�__ne__0szVersion.__ne__cCs|�|�|j|jkSr)r*r&rrr�__lt__3s
zVersion.__lt__cCs|�|�p|�|�Sr)�r.r+r&rrr�__gt__7szVersion.__gt__cCs|�|�p|�|�Sr)r/r&rrr�__le__:szVersion.__le__cCs|�|�p|�|�Sr))r0r+r&rrr�__ge__=szVersion.__ge__cCs
t|j�Sr))�hashr�rrrr�__hash__AszVersion.__hash__cCsd|jj|jfS)Nz%s('%s')��	__class__rrr4rrr�__repr__DszVersion.__repr__cCs|jSr)�rr4rrr�__str__GszVersion.__str__cCstd��dS)NzPlease implement in subclasses.r!r4rrr�
is_prereleaseJszVersion.is_prereleaseN)rrrr rr(r+r-r.r0r1r2r5r8r:�propertyr;rrrrrsrc	@s�eZdZdZdd�dd�dd�dd�dd�dd�d	d�d
d�d�Zdd
�Zdd�Zdd�Zedd��Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS) �MatcherNcCs||kSr)r��v�c�prrr�<lambda>T�zMatcher.<lambda>cCs||kSr)rr>rrrrBUrCcCs||kp||kSr)rr>rrrrBVrCcCs||kp||kSr)rr>rrrrBWrCcCs||kSr)rr>rrrrBXrCcCs||kSr)rr>rrrrBYrCcCs||kp||kSr)rr>rrrrB[rCcCs||kSr)rr>rrrrB\rC)�<�>�<=�>=�==�===�~=�!=cCst|�Sr)rr#rrrraszMatcher.parse_requirementcCs�|jdkrtd��|��|_}|�|�}|s:td|��|j|_|j��|_g}|jr�|jD]d\}}|�	d�r�|dkr�td|��|dd�d}}|�|�n|�|�d}}|�
|||f�q^t|�|_dS)	NzPlease specify a version classz
Not valid: %rz.*)rHrKz#'.*' not allowed for %r constraints���TF)
�
version_class�
ValueErrorrrr�name�lower�keyZconstraints�endswith�appendrr)rr�rZclist�opZvn�prefixrrrr ds*


�zMatcher.__init__cCsxt|t�r|�|�}|jD]X\}}}|j�|�}t|t�rDt||�}|s`d||jjf}t	|��||||�sdSqdS)z�
        Check if the provided version matches the constraints.

        :param version: The version to match against this instance.
        :type version: String or :class:`Version` instance.
        z%r not implemented for %sFT)
rrrMr�
_operators�get�getattrr7rr")r�version�operator�
constraintrV�f�msgrrr�match�s




�z
Matcher.matchcCs6d}t|j�dkr2|jdddkr2|jdd}|S)Nrr)rHrI)rr)r�resultrrr�
exact_version�s zMatcher.exact_versioncCs0t|�t|�ks|j|jkr,td||f��dS)Nzcannot compare %s and %s)r$rOr%r&rrrr(�szMatcher._check_compatiblecCs"|�|�|j|jko |j|jkSr))r(rQrr&rrrr+�s
zMatcher.__eq__cCs|�|�Sr)r,r&rrrr-�szMatcher.__ne__cCst|j�t|j�Sr))r3rQrr4rrrr5�szMatcher.__hash__cCsd|jj|jfS)Nz%s(%r)r6r4rrrr8�szMatcher.__repr__cCs|jSr)r9r4rrrr:�szMatcher.__str__)rrrrMrWrr r_r<rar(r+r-r5r8r:rrrrr=Os*�
r=zk^v?(\d+!)?(\d+(\.\d+)*)((a|b|c|rc)(\d+))?(\.(post)(\d+))?(\.(dev)(\d+))?(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$cCs�|��}t�|�}|s"td|��|��}tdd�|d�d�D��}t|�dkrl|ddkrl|dd�}qF|dszd}nt|d�}|dd	�}|d
d�}|dd
�}|d}|dkr�d}n|dt|d�f}|dkr�d}n|dt|d�f}|dk�rd}n|dt|d�f}|dk�r*d}nHg}	|�d�D]0}
|
�	��rTdt|
�f}
nd|
f}
|	�
|
��q8t|	�}|�s�|�s�|�r�d}nd}|�s�d}|�s�d}||||||fS)NzNot a valid version: %scss|]}t|�VqdSr)��int��.0r?rrr�	<genexpr>�sz_pep_440_key.<locals>.<genexpr>r�.���r����	�
��
)NNr)�arh)�z)�_)�final)r�PEP440_VERSION_REr_r�groupsr�splitrrc�isdigitrS)r�mruZnumsZepoch�preZpost�devZlocalr�partrrr�_pep_440_key�sT



r|c@s6eZdZdZdd�Zedddddg�Zed	d
��ZdS)raIA rational version.

    Good:
        1.2         # equivalent to "1.2.0"
        1.2.0
        1.2a1
        1.2.3a2
        1.2.3b1
        1.2.3c1
        1.2.3.4
        TODO: fill this out

    Bad:
        1           # minimum two numbers
        1.2a        # release level must have a release serial
        1.2.3b
    cCs<t|�}t�|�}|��}tdd�|d�d�D��|_|S)Ncss|]}t|�VqdSr)rbrdrrrrfsz*NormalizedVersion.parse.<locals>.<genexpr>rrg)�_normalized_keyrtr_rurrv�_release_clause)rrr`rxrurrrr
s

zNormalizedVersion.parserp�br@�rcrzcst�fdd��jD��S)Nc3s |]}|r|d�jkVqdS)rN)�PREREL_TAGS)re�tr4rrrfsz2NormalizedVersion.is_prerelease.<locals>.<genexpr>)�anyrr4rr4rr;szNormalizedVersion.is_prereleaseN)	rrrrr�setr�r<r;rrrrr�s
cCs>t|�}t|�}||krdS|�|�s*dSt|�}||dkS)NTFrg)�str�
startswithr)�x�y�nrrr�
_match_prefixs
r�c	@sneZdZeZddddddddd	�Zd
d�Zdd
�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�ZdS)r�_match_compatible�	_match_lt�	_match_gt�	_match_le�	_match_ge�	_match_eq�_match_arbitrary�	_match_ne)rJrDrErFrGrHrIrKcCsV|rd|ko|jd}n|jdo,|jd}|rN|j�dd�d}|�|�}||fS)N�+rhrr)rrrvrM)rrZr\rVZstrip_localrrrr�
_adjust_local6s
zNormalizedMatcher._adjust_localcCsD|�|||�\}}||krdS|j}d�dd�|D��}t||�S)NFrgcSsg|]}t|��qSr�r��re�irrr�
<listcomp>Isz/NormalizedMatcher._match_lt.<locals>.<listcomp>�r�r~�joinr��rrZr\rVZrelease_clauseZpfxrrrr�DszNormalizedMatcher._match_ltcCsD|�|||�\}}||krdS|j}d�dd�|D��}t||�S)NFrgcSsg|]}t|��qSrr�r�rrrr�Qsz/NormalizedMatcher._match_gt.<locals>.<listcomp>r�r�rrrr�LszNormalizedMatcher._match_gtcCs|�|||�\}}||kSr)�r��rrZr\rVrrrr�TszNormalizedMatcher._match_lecCs|�|||�\}}||kSr)r�r�rrrr�XszNormalizedMatcher._match_gecCs.|�|||�\}}|s ||k}n
t||�}|Sr)�r�r��rrZr\rVr`rrrr�\s


zNormalizedMatcher._match_eqcCst|�t|�kSr)r�r�rrrr�dsz"NormalizedMatcher._match_arbitrarycCs0|�|||�\}}|s ||k}nt||�}|Sr)r�r�rrrr�gs

zNormalizedMatcher._match_necCsf|�|||�\}}||krdS||kr*dS|j}t|�dkrH|dd�}d�dd�|D��}t||�S)NTFrrhrgcSsg|]}t|��qSrr�r�rrrr�zsz7NormalizedMatcher._match_compatible.<locals>.<listcomp>)r�r~rr�r�r�rrrr�osz#NormalizedMatcher._match_compatibleN)rrrrrMrWr�r�r�r�r�r�r�r�r�rrrrr's&�z[.+-]$�z^[.](\d)z0.\1z^[.-]z
^\((.*)\)$�\1z^v(ersion)?\s*(\d+)z\2z^r(ev)?\s*(\d+)z[.]{2,}rgz\b(alfa|apha)\b�alphaz\b(pre-alpha|prealpha)\bz	pre.alphaz	\(beta\)$�betaz
^[:~._+-]+z
[,*")([\]]z[~:+_ -]z\.$z
(\d+(\.\d+)*)cCsL|����}tD]\}}|�||�}q|s.d}t�|�}|sFd}|}n�|��d�d�}dd�|D�}t|�dkr~|�	d�qft|�dkr�||�
�d�}n8d�dd�|dd�D��||�
�d�}|dd�}d�d	d�|D��}|��}|�rtD]\}}|�||�}q�|�s|}nd
|k�r*dnd}|||}t
|��sHd}|S)
z�
    Try to suggest a semantic form for a version for which
    _suggest_normalized_version couldn't come up with anything.
    z0.0.0rrgcSsg|]}t|��qSrrbr�rrrr��sz-_suggest_semantic_version.<locals>.<listcomp>�NcSsg|]}t|��qSrr�r�rrrr��scSsg|]}t|��qSrr�r�rrrr��srz�-r�)rrP�
_REPLACEMENTS�sub�_NUMERIC_PREFIXr_rurvrrS�endr��_SUFFIX_REPLACEMENTS�	is_semver)rr`Zpat�replrxrV�suffix�seprrr�_suggest_semantic_version�s:
,
r�cCshzt|�|WStk
r"YnX|��}dD]\}}|�||�}q0t�dd|�}t�dd|�}t�dd|�}t�dd	|�}t�d
d|�}|�d�r�|d
d�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd |�}zt|�Wntk
�rbd}YnX|S)!a�Suggest a normalized version close to the given version string.

    If you have a version string that isn't rational (i.e. NormalizedVersion
    doesn't like it) then you might be able to get an equivalent (or close)
    rational version from this function.

    This does a number of simple normalizations to the given string, based
    on observation of versions currently in use on PyPI. Given a dump of
    those version during PyCon 2009, 4287 of them:
    - 2312 (53.93%) match NormalizedVersion without change
      with the automatic suggestion
    - 3474 (81.04%) match when using this suggestion method

    @param s {str} An irrational version string.
    @returns A rational version string, or None, if couldn't determine one.
    ))z-alpharp)z-betar)r�rp)r�r)r�r@)z-finalr�)z-prer@)z-releaser�)z.releaser�)z-stabler�)r�rg)rrrg)� r�)z.finalr�)rsr�zpre$Zpre0zdev$Zdev0z([abc]|rc)[\-\.](\d+)$z\1\2z[\-\.](dev)[\-\.]?r?(\d+)$z.\1\2z[.~]?([abc])\.?r�r?rNz\b0+(\d+)(?!\d)z(\d+[abc])$z\g<1>0z\.?(dev-r|dev\.r)\.?(\d+)$z.dev\2z-(a|b|c)(\d+)$z[\.\-](dev|devel)$z.dev0z(?![\.\-])dev$z(final|stable)$r�z\.?(r|-|-r)\.?(\d+)$z.post\2z\.?(dev|git|bzr)\.?(\d+)$z\.?(pre|preview|-c)(\d+)$zc\g<2>zp(\d+)$z.post\1)r}rrP�replace�rer�r�)rZrsZorigr�rrr�_suggest_normalized_version�s>
	
r�z([a-z]+|\d+|[\.-])r@zfinal-�@)ryZpreviewr�r�rzr�rgcCsrdd�}g}||�D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�S)NcSstg}t�|���D]R}t�||�}|rd|dd�krBdkrRnn|�d�}nd|}|�|�q|�d�|S)N�0r�9��*�*final)�
_VERSION_PARTrvrP�_VERSION_REPLACErX�zfillrS)rr`rArrr�	get_partsCs 
z_legacy_key.<locals>.get_partsr�r�rhz*final-Z00000000)r��poprSr)rr�r`rArrr�_legacy_keyBs



r�c@s eZdZdd�Zedd��ZdS)rcCst|�Sr))r�r#rrrr]szLegacyVersion.parsecCs8d}|jD](}t|t�r
|�d�r
|dkr
d}q4q
|S)NFr�r�T)rrrr�)rr`r�rrrr;`s
�zLegacyVersion.is_prereleaseN�rrrrr<r;rrrrr\sc@s4eZdZeZeej�Zded<e�	d�Z
dd�ZdS)r	r�rJz^(\d+(\.\d+)*)cCs`||krdS|j�t|��}|s2t�d||�dS|��d}d|krV|�dd�d}t||�S)NFzACannot compute compatible match for version %s  and constraint %sTrrgr)�
numeric_rer_r��loggerZwarningru�rsplitr�)rrZr\rVrxrrrrr�ss�zLegacyMatcher._match_compatibleN)rrrrrM�dictr=rWr��compiler�r�rrrrr	ks


zN^(\d+)\.(\d+)\.(\d+)(-[a-z0-9]+(\.[a-z0-9-]+)*)?(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$cCs
t�|�Sr))�
_SEMVER_REr_)rrrrr��sr�c	Csndd�}t|�}|st|��|��}dd�|dd�D�\}}}||dd�||dd�}}|||f||fS)	NcSs8|dkr|f}n$|dd��d�}tdd�|D��}|S)NrrgcSs"g|]}|��r|�d�n|�qS)r�)rwr�)rerArrrr��sz5_semantic_key.<locals>.make_tuple.<locals>.<listcomp>)rvr)rZabsentr`rrrr�
make_tuple�s
z!_semantic_key.<locals>.make_tuplecSsg|]}t|��qSrrbr�rrrr��sz!_semantic_key.<locals>.<listcomp>r��|�r�)r�rru)	rr�rxru�major�minorZpatchryZbuildrrr�
_semantic_key�s
r�c@s eZdZdd�Zedd��ZdS)r
cCst|�Sr))r�r#rrrr�szSemanticVersion.parsecCs|jdddkS)Nrrr�)rr4rrrr;�szSemanticVersion.is_prereleaseNr�rrrrr
�sc@seZdZeZdS)rN)rrrr
rMrrrrr�sc@s6eZdZddd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
�
VersionSchemeNcCs||_||_||_dSr))rQ�matcher�	suggester)rrQr�r�rrrr �szVersionScheme.__init__cCs2z|j�|�d}Wntk
r,d}YnX|S�NTF)r�rMr�rrr`rrr�is_valid_version�s
zVersionScheme.is_valid_versioncCs0z|�|�d}Wntk
r*d}YnX|Sr�)r�rr�rrr�is_valid_matcher�s

zVersionScheme.is_valid_matchercCs|�d|�S)z:
        Used for processing some metadata fields
        zdummy_name (%s))r�r#rrr�is_valid_constraint_list�sz&VersionScheme.is_valid_constraint_listcCs|jdkrd}n
|�|�}|Sr))r�r�rrr�suggest�s

zVersionScheme.suggest)N)rrrr r�r�r�r�rrrrr��s

r�cCs|Sr)rr#rrrrB�rCrB)�
normalized�legacyZsemanticr��defaultcCs|tkrtd|��t|S)Nzunknown scheme name: %r)�_SCHEMESrN)rOrrrr
�s)*rZloggingr��compatr�utilr�__all__Z	getLoggerrr�rNr�objectrr=r�rtr|r}rr�rr�r�r�r�r��Ir�r�r�rr	r�r�r�r
rr�r�r
rrrr�<module>s��
1d
=$W���
.r��	$���site-packages/pip/_vendor/distlib/__pycache__/scripts.cpython-38.pyc000064400000025002151446177000021475 0ustar00U

��.e�?�@s�ddlmZddlZddlZddlZddlZddlZddlmZm	Z	m
Z
ddlmZddl
mZmZmZmZmZe�e�Zd��Ze�d�Zd	Zd
d�ZGdd
�d
e�ZdS)�)�BytesION�)�	sysconfig�detect_encoding�ZipFile)�finder)�FileOperator�get_export_entry�convert_path�get_executable�in_venva�
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
 <assemblyIdentity version="1.0.0.0"
 processorArchitecture="X86"
 name="%s"
 type="win32"/>

 <!-- Identify the application security requirements. -->
 <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
 <security>
 <requestedPrivileges>
 <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
 </requestedPrivileges>
 </security>
 </trustInfo>
</assembly>s^#!.*pythonw?[0-9.]*([ 	].*)?$z�# -*- coding: utf-8 -*-
import re
import sys
from %(module)s import %(import_name)s
if __name__ == '__main__':
    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
    sys.exit(%(func)s())
cCsXd|krT|�d�rB|�dd�\}}d|krT|�d�sTd||f}n|�d�sTd|}|S)N� z
/usr/bin/env r�"z%s "%s"z"%s")�
startswith�split)�
executable�envZ_executable�r�?/usr/lib/python3.8/site-packages/pip/_vendor/distlib/scripts.py�_enquote_executable3s

rc@s�eZdZdZeZdZd'dd�Zdd�Ze	j
�d	�rBd
d�Zdd
�Z
dd�Zd(dd�Zdd�ZeZdd�Zdd�Zd)dd�Zdd�Zedd��Zejdd��Zejd ks�ejd	kr�ejd kr�d!d"�Zd*d#d$�Zd+d%d&�ZdS),�ScriptMakerz_
    A class to copy or create scripts from source scripts or callable
    specifications.
    NTFcCsz||_||_||_d|_d|_tjdkp:tjdko:tjdk|_t	d�|_
|pRt|�|_tjdkprtjdkortjdk|_
dS)NF�posix�java)��X.Y�nt)�
source_dir�
target_dir�
add_launchers�force�clobber�os�name�_name�set_mode�set�variantsr�_fileop�_is_nt)�selfrrr�dry_runZfileoprrr�__init__Ls�

�zScriptMaker.__init__cCs@|�dd�r<|jr<tj�|�\}}|�dd�}tj�||�}|S)N�guiF�pythonZpythonw)�getr(r!�pathr�replace�join)r)r�optionsZdn�fnrrr�_get_alternate_executable\s
z%ScriptMaker._get_alternate_executablerc
Cs\z0t|��}|�d�dkW5QR�WSQRXWn&ttfk
rVt�d|�YdSXdS)zl
            Determine if the specified executable is a script
            (contains a #! line)
            �z#!zFailed to open %sFN)�open�read�OSError�IOError�logger�warning)r)r�fprrr�	_is_shellds
&zScriptMaker._is_shellcCsD|�|�r*ddl}|jj�d�dkr<|Sn|���d�r<|Sd|S)Nrzos.nameZLinuxz
jython.exez/usr/bin/env %s)r=rZlangZSystemZgetProperty�lower�endswith)r)rrrrr�_fix_jython_executableps
z"ScriptMaker._fix_jython_executablecCs�tjdkrd}n8t|�t|�d}tjdkr4d}nd}d|koF||k}|r^d||d	}n d
}|d||d7}|d
7}|S)a
        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
        rT��darwini�� s#!�
s
#!/bin/sh
s	'''exec' s "$0" "$@"
s' ''')r!r"�len�sys�platform)r)r�post_interpZsimple_shebangZshebang_lengthZmax_shebang_length�resultrrr�_build_shebang|s

�zScriptMaker._build_shebang�cCs`d}|jr|j}d}n^t��s&t�}nNt�rLtj�t�d�dt�	d��}n(tj�t�	d�dt�	d�t�	d�f�}|r�|�
||�}tj�
d	�r�|�|�}tj�|�}|r�t|�}|�d
�}tjdkr�d|kr�d
|kr�|d7}|�||�}z|�d
�Wn"tk
�rtd|��YnX|d
k�r\z|�|�Wn&tk
�rZtd||f��YnX|S)NTFZscriptszpython%sZEXEZBINDIRz
python%s%sZVERSIONr�utf-8Zcliz	-X:Framesz
-X:FullFramess
 -X:Framesz,The shebang (%r) is not decodable from utf-8z?The shebang (%r) is not decodable from the script encoding (%r))rrZis_python_buildrrr!r/r1Zget_pathZget_config_varr4rGrHrr@�normcaser�encoderK�decode�UnicodeDecodeError�
ValueError)r)�encodingrIr2Zenquoter�shebangrrr�_get_shebang�sZ�
��

��

��
zScriptMaker._get_shebangcCs$|jt|j|j�d�d|jd�S)N�.r)�moduleZimport_name�func)�script_template�dict�prefix�suffixr)r)�entryrrr�_get_script_text�s
�zScriptMaker._get_script_textcCstj�|�}|j|S�N)r!r/�basename�manifest)r)Zexename�baserrr�get_manifest�szScriptMaker.get_manifestcCs�|jo
|j}tj�d�}|�|�s*||7}|s8||}nZ|dkrL|�d�}n
|�d�}t�}	t|	d��}
|
�	d|�W5QRX|	�
�}|||}|D�]V}tj�|j
|�}
|�rxtj�|
�\}}|�d�r�|}
d|
}
z|j�|
|�Wn�tk
�rtt�d�d	|
}tj�|��r&t�|�t�|
|�|j�|
|�t�d
�zt�|�Wntk
�rnYnXYnXnl|j�r�|
�d|��s�d|
|f}
tj�|
��r�|j�s�t�d
|
�q�|j�|
|�|j�r�|j�|
g�|�|
�q�dS)NrM�py�t�wz__main__.pyz.pyz%s.exez:Failed to write executable - trying to use .deleteme logicz%s.deletemez0Able to replace executable using .deleteme logicrVz%s.%szSkipping existing file %s)rr(r!�lineseprOr?�
_get_launcherrrZwritestr�getvaluer/r1r�splitextrr'Zwrite_binary_file�	Exceptionr:r;�exists�remove�rename�debugr r$�set_executable_mode�append)r)�namesrTZscript_bytes�	filenames�extZuse_launcherrgZlauncher�streamZzfZzip_datar"�outname�n�eZdfnamerrr�
_write_script�sX







zScriptMaker._write_scriptcCs�d}|r0|�dg�}|r0dd�|�}|�d�}|jd||d�}|�|��d�}|j}t�}	d|jkrp|	�|�d|jkr�|	�d	|t	j
d
f�d|jkr�|	�d|t	j
dd
�f�|r�|�dd�r�d}
nd}
|�|	||||
�dS)NrLZinterpreter_argsz %sr
rM�r2r�Xz%s%srrz%s-%srAr,F�pywrd)r.r1rOrUr^r"r%r&�addrG�versionry)r)r]rsr2rI�argsrT�scriptr"Zscriptnamesrtrrr�_make_scripts(




zScriptMaker._make_scriptcCs�d}tj�|jt|��}tj�|jtj�|��}|jsT|j�	||�sTt
�d|�dSzt|d�}Wn t
k
r�|jsz�d}YnLX|��}|s�t
�d|��|�dSt�|�dd��}|r�d}|�d�p�d	}|�s|r�|��|j�||�|j�r|j�|g�|�|�n�t
�d
||j�|jj�s�t|j�\}	}
|�d�|�|	|�}d|k�r^d
}nd}tj�|�}
|�|
g||� �||�|�r�|��dS)NFznot copying %s (up-to-date)�rbz"%s: %s is an empty file (skipping)s
rETrrLzcopying and adjusting %s -> %srspythonwr|rd)!r!r/r1rr
rr`rr'Znewerr:ror6r9r*�readliner;Zget_command_name�
FIRST_LINE_RE�matchr0�group�closeZ	copy_filer$rprq�infor�seekrUryr7)r)r�rsZadjustrv�fZ
first_liner�rIrS�linesrTrtrwrrr�_copy_script)sX
��


zScriptMaker._copy_scriptcCs|jjSr_�r'r*)r)rrrr*]szScriptMaker.dry_runcCs||j_dSr_r�)r)�valuerrrr*asrcCsHt�d�dkrd}nd}d||f}t�dd�d}t|��|�j}|S)	N�P�Z64Z32z%s%s.exerVrr)�struct�calcsize�__name__�rsplitr�find�bytes)r)Zkind�bitsr"Zdistlib_packagerJrrrrhiszScriptMaker._get_launchercCs6g}t|�}|dkr"|�||�n|j|||d�|S)a�
        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.
        Nrz)r	r�r�)r)�
specificationr2rsr]rrr�makewszScriptMaker.makecCs$g}|D]}|�|�||��q|S)z�
        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,
        )�extendr�)r)Zspecificationsr2rsr�rrr�
make_multiple�szScriptMaker.make_multiple)TFN)rLN)N)N)N) r��
__module__�__qualname__�__doc__�SCRIPT_TEMPLATErYrr+r4rGrHrr=r@rKrUr^�_DEFAULT_MANIFESTrarcryr�r��propertyr*�setterr!r"r#rhr�r�rrrrrCs6�

84
4


r)�iorZloggingr!�rer�rG�compatrrrZ	resourcesr�utilrr	r
rrZ	getLoggerr�r:�stripr��compiler�r�r�objectrrrrr�<module>s


site-packages/pip/_vendor/distlib/__pycache__/index.cpython-38.pyc000064400000041737151446177000021132 0ustar00U

��.eJR�@s�ddlZddlZddlZddlZddlZddlZzddlmZWn ek
r`ddl	mZYnXddl
mZddlm
Z
mZmZmZmZmZddlmZmZmZe�e�ZdZdZGd	d
�d
e�ZdS)�N)�Thread�)�DistlibException)�HTTPBasicAuthHandler�Request�HTTPPasswordMgr�urlparse�build_opener�string_types)�cached_property�zip_dir�ServerProxyzhttps://pypi.org/pypi�pypic@s�eZdZdZdZd*dd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zd+dd�Zd,dd�Z
d-dd�Zd.dd�Zdd�Zd/dd�Zd0d d!�Zd1d"d#�Zd$d%�Zd&d'�Zd2d(d)�ZdS)3�PackageIndexzc
    This class represents a package index compatible with PyPI, the Python
    Package Index.
    s.----------ThIs_Is_tHe_distlib_index_bouNdaRY_$Nc
Cs�|pt|_|��t|j�\}}}}}}|s<|s<|s<|dkrJtd|j��d|_d|_d|_d|_t	t
jd��R}dD]F}	z,tj
|	dg||d�}
|
dkr�|	|_Wq�Wqttk
r�YqtXqtW5QRXdS)	z�
        Initialise an instance.

        :param url: The URL of the index. If not specified, the URL for PyPI is
                    used.
        )ZhttpZhttpszinvalid repository: %sN�w)�gpgZgpg2z	--version��stdout�stderrr)�
DEFAULT_INDEX�url�read_configurationrr�password_handler�ssl_verifierr�gpg_home�open�os�devnull�
subprocessZ
check_call�OSError)�selfrZscheme�netloc�pathZparamsZqueryZfragZsink�s�rc�r%�=/usr/lib/python3.8/site-packages/pip/_vendor/distlib/index.py�__init__$s(
�
zPackageIndex.__init__cCs&ddlm}ddlm}|�}||�S)zs
        Get the distutils command for interacting with PyPI configurations.
        :return: the command.
        r)�Distribution)�
PyPIRCCommand)Zdistutils.corer(Zdistutils.configr))r r(r)�dr%r%r&�_get_pypirc_commandAsz PackageIndex._get_pypirc_commandcCsR|��}|j|_|��}|�d�|_|�d�|_|�dd�|_|�d|j�|_dS)z�
        Read the PyPI access configuration as supported by distutils, getting
        PyPI to do the actual work. This populates ``username``, ``password``,
        ``realm`` and ``url`` attributes from the configuration.
        �username�password�realmr�
repositoryN)r+rr/Z_read_pypirc�getr,r-r.)r �cZcfgr%r%r&rKszPackageIndex.read_configurationcCs$|��|��}|�|j|j�dS)z�
        Save the PyPI access configuration. You must have set ``username`` and
        ``password`` attributes before calling this method.

        Again, distutils is used to do the actual work.
        N)�check_credentialsr+Z
_store_pypircr,r-)r r1r%r%r&�save_configurationZszPackageIndex.save_configurationcCs\|jdks|jdkrtd��t�}t|j�\}}}}}}|�|j||j|j�t|�|_	dS)zp
        Check that ``username`` and ``password`` have been set, and raise an
        exception if not.
        Nz!username and password must be set)
r,r-rrrrZadd_passwordr.rr)r Zpm�_r!r%r%r&r2fszPackageIndex.check_credentialscCs\|��|��|��}d|d<|�|��g�}|�|�}d|d<|�|��g�}|�|�S)aq
        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.
        Zverify�:actionZsubmit)r2�validate�todict�encode_request�items�send_request)r �metadatar*�requestZresponser%r%r&�registerrs

zPackageIndex.registercCsF|��}|sq:|�d���}|�|�t�d||f�q|��dS)ar
        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.
        �utf-8z%s: %sN)�readline�decode�rstrip�append�logger�debug�close)r �name�streamZoutbufr#r%r%r&�_reader�s

zPackageIndex._readerc	Cs�|jdddg}|dkr|j}|r.|�d|g�|dk	rF|�dddg�t��}tj�|tj�|�d	�}|�d
dd|d
||g�t	�
dd�|��||fS)a�
        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`.
        �--status-fd�2�--no-ttyN�	--homedirz--batchz--passphrase-fd�0z.ascz
--detach-signz--armorz--local-userz--output�invoking: %s� )rr�extend�tempfileZmkdtemprr"�join�basenamerCrD)r �filename�signer�
sign_password�keystore�cmdZtdZsfr%r%r&�get_sign_command�s"
�zPackageIndex.get_sign_commandc	Cs�tjtjd�}|dk	r tj|d<g}g}tj|f|�}t|jd|j|fd�}|��t|jd|j|fd�}|��|dk	r�|j�	|�|j�
�|��|��|��|j
||fS)a�
        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``.
        rN�stdinr)�target�argsr)r�PIPE�PopenrrHr�startrrZ�writerE�waitrR�
returncode)	r rXZ
input_data�kwargsrr�p�t1�t2r%r%r&�run_command�s&�

zPackageIndex.run_commandc
CsD|�||||�\}}|�||�d��\}}}	|dkr@td|��|S)aR
        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.
        r>rz&sign command failed with error code %s)rYrg�encoder)
r rTrUrVrWrX�sig_filer$rrr%r%r&�	sign_file�s
��
�zPackageIndex.sign_file�sdist�sourcec	Cs(|��tj�|�s td|��|��|��}d}	|rZ|jsJt�	d�n|�
||||�}	t|d��}
|
��}W5QRXt
�|���}t
�|���}
|�dd||||
d��dtj�|�|fg}|	�rt|	d��}
|
��}W5QRX|�d	tj�|	�|f�t�tj�|	��|�|��|�}|�|�S)
a�
        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.
        z
not found: %sNz)no signing program available - not signed�rbZfile_upload�1)r5Zprotocol_version�filetype�	pyversion�
md5_digest�
sha256_digest�contentZ
gpg_signature)r2rr"�existsrr6r7rrCZwarningrjr�read�hashlib�md5�	hexdigestZsha256�updaterSrB�shutilZrmtree�dirnamer8r9r:)r r;rTrUrVrorprWr*ri�fZ	file_datarqrr�filesZsig_datar<r%r%r&�upload_file�sD
���zPackageIndex.upload_filec
Cs�|��tj�|�s td|��tj�|d�}tj�|�sFtd|��|��|j|j	}}t
|���}dd|fd|fg}d||fg}|�||�}	|�
|	�S)a2
        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.
        znot a directory: %rz
index.htmlz
not found: %r)r5Z
doc_uploadrF�versionrs)r2rr"�isdirrrRrtr6rFrr�getvaluer8r:)
r r;Zdoc_dir�fnrFrZzip_data�fieldsr}r<r%r%r&�upload_documentation(s 
�z!PackageIndex.upload_documentationcCsT|jdddg}|dkr|j}|r.|�d|g�|�d||g�t�dd�|��|S)	a|
        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`.
        rIrJrKNrLz--verifyrNrO)rrrPrCrDrR)r �signature_filename�
data_filenamerWrXr%r%r&�get_verify_commandDszPackageIndex.get_verify_commandcCsH|jstd��|�|||�}|�|�\}}}|dkr@td|��|dkS)a6
        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.
        z0verification unavailable because gpg unavailable)rrz(verify command failed with error code %sr)rrr�rg)r r�r�rWrXr$rrr%r%r&�verify_signature\s��zPackageIndex.verify_signaturec	Csl|dkrd}t�d�n6t|ttf�r0|\}}nd}tt|��}t�d|�t|d���}|�t	|��}z�|��}	d}
d}d}d}
d	|	kr�t|	d
�}|r�||
|
|�|�
|
�}|s�q�|t|�7}|�|�|r�|�|�|
d7}
|r�||
|
|�q�W5|�
�XW5QRX|dk�r0||k�r0td||f��|�rh|��}||k�r\td
||||f��t�d|�dS)a
        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.
        NzNo digest specifiedrwzDigest specified: %s�wbi ���rzcontent-lengthzContent-Lengthrz1retrieval incomplete: got only %d out of %d bytesz.%s digest mismatch for %s: expected %s, got %szDigest verified: %s)rCrD�
isinstance�list�tuple�getattrrvrr:rrE�info�intru�lenr`ryrrx)r rZdestfileZdigestZ
reporthookZdigesterZhasherZdfpZsfp�headersZ	blocksize�sizeruZblocknum�block�actualr%r%r&�
download_fileus^



��
��zPackageIndex.download_filecCs:g}|jr|�|j�|jr(|�|j�t|�}|�|�S)z�
        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).
        )rrBrr	r)r ZreqZhandlersZopenerr%r%r&r:�szPackageIndex.send_requestc
Cs�g}|j}|D]L\}}t|ttf�s*|g}|D]*}|�d|d|�d�d|�d�f�q.q|D].\}}	}
|�d|d||	f�d�d|
f�q`|�d|ddf�d�|�}d|}|tt|��d�}
t	|j
||
�S)	a&
        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.
        s--z)Content-Disposition: form-data; name="%s"r>�z8Content-Disposition: form-data; name="%s"; filename="%s"s
smultipart/form-data; boundary=)zContent-typezContent-length)�boundaryr�r�r�rPrhrR�strr�rr)r r�r}�partsr��k�values�v�keyrT�valueZbodyZctr�r%r%r&r8�sD���
���

�zPackageIndex.encode_requestcCsFt|t�rd|i}t|jdd�}z|�||p.d�W�S|d��XdS)NrFg@)ZtimeoutrE�and)r�r
r
r�search)r Zterms�operatorZ	rpc_proxyr%r%r&r��s
zPackageIndex.search)N)N)N)N)NNrkrlN)N)N)NN)N)�__name__�
__module__�__qualname__�__doc__r�r'r+rr3r2r=rHrYrgrjr~r�r�r�r�r:r8r�r%r%r%r&rs6

�

#
�
9�
�

M+r)rvZloggingrrzrrQZ	threadingr�ImportErrorZdummy_threading�r�compatrrrrr	r
�utilrrr
Z	getLoggerr�rCrZ
DEFAULT_REALM�objectrr%r%r%r&�<module>s  
site-packages/pip/_vendor/distlib/__pycache__/metadata.cpython-38.opt-1.pyc000064400000063655151446177000022545 0ustar00U

��.e*��@sdZddlmZddlZddlmZddlZddlZddlZddl	m
Z
mZddlm
Z
mZmZddlmZdd	lmZmZdd
lmZmZe�e�ZGdd�de
�ZGd
d�de
�ZGdd�de
�ZGdd�de
�ZdddgZdZ dZ!e�"d�Z#e�"d�Z$dZ%dZ&dZ'dZ(dZ)dZ*d Z+e*d!Z,d"Z-e.�Z/e/�0e%�e/�0e&�e/�0e(�e/�0e*�e/�0e,�e�"d#�Z1d$d%�Z2d&d'�Z3d(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdF�Z4dGZ5dHZ6dIZ7dJZ8dKZ9dLZ:dMZ;e<�Z=e�"dN�Z>dXdPdQ�Z?GdRdS�dSe<�Z@dTZAdUZBdVZCGdWd�de<�ZDdS)YzImplementation of the Metadata for Python packages PEPs.

Supports all metadata formats (1.0, 1.1, 1.2, and 2.0 experimental).
�)�unicode_literalsN)�message_from_file�)�DistlibException�__version__)�StringIO�string_types�	text_type)�	interpret)�extract_by_key�
get_extras)�
get_scheme�PEP440_VERSION_REc@seZdZdZdS)�MetadataMissingErrorzA required metadata is missingN��__name__�
__module__�__qualname__�__doc__�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/metadata.pyrsrc@seZdZdZdS)�MetadataConflictErrorz>Attempt to read or write metadata fields that are conflictual.Nrrrrrr src@seZdZdZdS)� MetadataUnrecognizedVersionErrorz Unknown metadata version number.Nrrrrrr$src@seZdZdZdS)�MetadataInvalidErrorzA metadata value is invalidNrrrrrr(sr�Metadata�PKG_INFO_ENCODING�PKG_INFO_PREFERRED_VERSION�utf-8�1.1z

       \|�	
        )�Metadata-Version�Name�Version�Platform�Summary�Description�Keywords�	Home-page�Author�Author-email�License)r r!r"r#�Supported-Platformr$r%r&r'r(r)r*�
Classifier�Download-URL�	Obsoletes�Provides�Requires)r.r/r0r,r-)r r!r"r#r+r$r%r&r'r(r)�
Maintainer�Maintainer-emailr*r,r-�Obsoletes-Dist�Project-URL�
Provides-Dist�
Requires-Dist�Requires-Python�Requires-External)r5r6r7r3r8r1r2r4)r r!r"r#r+r$r%r&r'r(r)r1r2r*r,r-r3r4r5r6r7r8�Private-Version�Obsoleted-By�Setup-Requires-Dist�	Extension�Provides-Extra)r9r=r:r;r<)�Description-Content-Typer0r/)r>z"extra\s*==\s*("([^"]+)"|'([^']+)')cCsL|dkrtS|dkrtS|dkr$tS|dkr4ttS|dkr@tSt|��dS)N�1.0r�1.2)�1.3�2.1�2.0)�_241_FIELDS�_314_FIELDS�_345_FIELDS�_566_FIELDS�_426_FIELDSr)�versionrrr�_version2fieldlistpsrJc
CsBdd�}g}|��D]"\}}|gddfkr,q|�|�qddddd	d
g}|D]�}|tkrvd|krv|�d�t�d|�|tkr�d|kr�|�d�t�d|�|tkr�d|kr�|�d�t�d
|�|tkr�d|kr�|�d�t�d|�|tk�rd
|k�r|dk�r|�d
�t�d|�|t	krLd	|krL|�d	�t�d|�qLt
|�dk�rZ|dSt
|�dk�r|t�d|�td��d|k�o�||t�}d|k�o�||t
�}d
|k�o�||t�}d	|k�o�||t�}	t|�t|�t|�t|	�dk�r�td��|�s |�s |�s |	�s t|k�r tS|�r*dS|�r4dS|�r>d
Sd	S)z5Detect the best version depending on the fields used.cSs|D]}||krdSqdS)NTFr)�keys�markers�markerrrr�_has_marker�sz"_best_version.<locals>._has_marker�UNKNOWNNr?rr@rArCrBzRemoved 1.0 due to %szRemoved 1.1 due to %szRemoved 1.2 due to %szRemoved 1.3 due to %sr%zRemoved 2.1 due to %szRemoved 2.0 due to %srrz)Out of options - unknown metadata set: %szUnknown metadata setz,You used incompatible 1.1/1.2/2.0/2.1 fields)�items�appendrD�remove�logger�debugrErFrGrH�lenr�_314_MARKERS�_345_MARKERS�_566_MARKERS�_426_MARKERS�intr)
�fieldsrNrK�key�valueZpossible_versionsZis_1_1Zis_1_2Zis_2_1Zis_2_0rrr�
_best_version~s`






&
r^r r!r"r#r+r$r%r&r'r(r)r1r2r*r,r-r3r5r6r;r7r8r0r/r.r4r9r:r<r=)�metadata_version�namerI�platformZsupported_platform�summary�description�keywords�	home_page�author�author_email�
maintainer�maintainer_email�license�
classifier�download_url�obsoletes_dist�
provides_dist�
requires_dist�setup_requires_dist�requires_python�requires_external�requires�provides�	obsoletes�project_urlZprivate_versionZobsoleted_by�	extensionZprovides_extra)r6r3r5)r7)r")r#r,r.r0r/r3r5r6r8r4r+r;r=r<)r4)r&)r(r1r$r%z[^A-Za-z0-9.]+FcCs0|r$t�d|�}t�d|�dd��}d||fS)zhReturn the distribution name with version.

    If for_filename is true, return a filename-escaped form.�-� �.z%s-%s)�	_FILESAFE�sub�replace)r`rIZfor_filenamerrr�_get_name_and_version�sr~c@s
eZdZdZd?dd�Zdd�Zdd	�Zd
d�Zdd
�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zd@dd�Zdd�Zdd �Zd!d"�Zd#d$�ZdAd%d&�ZdBd'd(�ZdCd)d*�Zd+d,�Zefd-d.�ZdDd/d0�ZdEd1d2�Zd3d4�Zd5d6�Zd7d8�Zd9d:�Zd;d<�Z d=d>�Z!dS)F�LegacyMetadataaaThe legacy metadata of a release.

    Supports versions 1.0, 1.1 and 1.2 (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
    N�defaultcCsz|||g�d�dkrtd��i|_g|_d|_||_|dk	rH|�|�n.|dk	r\|�|�n|dk	rv|�|�|�	�dS)N��'path, fileobj and mapping are exclusive)
�count�	TypeError�_fieldsZrequires_filesZ
_dependencies�scheme�read�	read_file�update�set_metadata_version)�self�path�fileobj�mappingr�rrr�__init__s
zLegacyMetadata.__init__cCst|j�|jd<dS�Nr )r^r��r�rrrr�"sz#LegacyMetadata.set_metadata_versioncCs|�d||f�dS)Nz%s: %s
)�write)r�r�r`r]rrr�_write_field%szLegacyMetadata._write_fieldcCs
|�|�S�N)�get�r�r`rrr�__getitem__(szLegacyMetadata.__getitem__cCs|�||�Sr�)�set)r�r`r]rrr�__setitem__+szLegacyMetadata.__setitem__cCs8|�|�}z|j|=Wntk
r2t|��YnXdSr�)�
_convert_namer��KeyError)r�r`�
field_namerrr�__delitem__.s

zLegacyMetadata.__delitem__cCs||jkp|�|�|jkSr�)r�r�r�rrr�__contains__5s
�zLegacyMetadata.__contains__cCs(|tkr|S|�dd���}t�||�S)Nrx�_)�_ALL_FIELDSr}�lower�_ATTR2FIELDr�r�rrrr�9szLegacyMetadata._convert_namecCs|tks|tkrgSdS)NrO)�_LISTFIELDS�_ELEMENTSFIELDr�rrr�_default_value?szLegacyMetadata._default_valuecCs&|jdkrt�d|�St�d|�SdS)N�r?r�
)r_�_LINE_PREFIX_PRE_1_2r|�_LINE_PREFIX_1_2�r�r]rrr�_remove_line_prefixDs
z"LegacyMetadata._remove_line_prefixcCs|tkr||St|��dSr�)r��AttributeErrorr�rrr�__getattr__JszLegacyMetadata.__getattr__FcCst|d|d|�S)zhReturn the distribution name with version.

        If filesafe is true, return a filename-escaped form.r!r")r~)r�Zfilesaferrr�get_fullnameUszLegacyMetadata.get_fullnamecCs|�|�}|tkS)z+return True if name is a valid metadata key)r�r�r�rrr�is_field[s
zLegacyMetadata.is_fieldcCs|�|�}|tkSr�)r�r�r�rrr�is_multi_field`s
zLegacyMetadata.is_multi_fieldcCs.tj|ddd�}z|�|�W5|��XdS)z*Read the metadata values from a file path.�rr��encodingN)�codecs�open�closer�)r��filepath�fprrrr�dszLegacyMetadata.readcCs�t|�}|d|jd<tD]p}||kr(q|tkrf|�|�}|tkrX|dk	rXdd�|D�}|�||�q||}|dk	r|dkr|�||�qdS)z,Read the metadata values from a file object.zmetadata-versionr NcSsg|]}t|�d���qS��,)�tuple�split��.0r]rrr�
<listcomp>ysz,LegacyMetadata.read_file.<locals>.<listcomp>rO)rr�r�r�Zget_all�_LISTTUPLEFIELDSr�)r�Zfileob�msg�field�valuesr]rrrr�ls
zLegacyMetadata.read_filecCs0tj|ddd�}z|�||�W5|��XdS)z&Write the metadata fields to filepath.�wrr�N)r�r�r��
write_file)r�r��skip_unknownr�rrrr��szLegacyMetadata.writecCs�|��t|d�D]�}|�|�}|r8|dgdgfkr8q|tkrV|�||d�|��q|tkr�|dkr�|jdkr~|�dd�}n|�dd�}|g}|t	kr�d	d
�|D�}|D]}|�|||�q�qdS)z0Write the PKG-INFO format data to a file object.r rOr�r%r�r�rz	
       |cSsg|]}d�|��qSr���joinr�rrrr��sz-LegacyMetadata.write_file.<locals>.<listcomp>N)
r�rJr�r�r�r�r�r_r}r�)r�Z
fileobjectr�r�r�r]rrrr��s$

zLegacyMetadata.write_filecsv�fdd�}|sn@t|d�r:|��D]}||||�q$n|D]\}}|||�q>|rr|��D]\}}|||�q^dS)a�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.
        cs"|tkr|r����|�|�dSr�)r�r�r�)r\r]r�rr�_set�sz#LegacyMetadata.update.<locals>._setrKN)�hasattrrKrP)r��other�kwargsr��k�vrr�rr��s

zLegacyMetadata.updatecCsh|�|�}|tks|dkrNt|ttf�sNt|t�rHdd�|�d�D�}qzg}n,|tkrzt|ttf�szt|t�rv|g}ng}t�	t
j��r<|d}t|j
�}|tkr�|dk	r�|D](}|�|�d�d�s�t�d	|||�q�nb|tk�r|dk	�r|�|��s<t�d
|||�n0|tk�r<|dk	�r<|�|��s<t�d
|||�|tk�rZ|dk�rZ|�|�}||j|<dS)z"Control then set a metadata field.r#cSsg|]}|���qSr)�strip)r�r�rrrr��sz&LegacyMetadata.set.<locals>.<listcomp>r�r!N�;rz$'%s': '%s' is not valid (field '%s')z.'%s': '%s' is not a valid version (field '%s')r%)r�r��
isinstance�listr�rr�r�rSZisEnabledFor�loggingZWARNINGr
r��_PREDICATE_FIELDS�is_valid_matcher�warning�_VERSIONS_FIELDS�is_valid_constraint_list�_VERSION_FIELDS�is_valid_version�_UNICODEFIELDSr�r�)r�r`r]Zproject_namer�r�rrrr��sV
�
�

���


zLegacyMetadata.setcCs�|�|�}||jkr*|tkr&|�|�}|S|tkr@|j|}|S|tkr�|j|}|dkr^gSg}|D].}|tkr~|�|�qf|�|d|df�qf|S|tkr�|j|}t	|t
�r�|�d�S|j|S)zGet a metadata field.Nrrr�)r�r��_MISSINGr�r�r�r�rQr�r�rr�)r�r`r�r]�res�valrrrr��s.







zLegacyMetadata.getcs�|��gg}}dD]}||kr|�|�q|rP|gkrPdd�|�}t|��dD]}||krT|�|�qT|ddkr�||fSt|j���fdd�}t|ft�jft	�j
ffD]@\}}|D]2}	|�|	d	�}
|
d	k	r�||
�s�|�d
|	|
f�q�q�||fS)zkCheck if the metadata is compliant. If strict is True then raise if
        no Name or Version are provided)r!r"zmissing required metadata: %s�, )r'r(r r@cs(|D]}��|�d�d�sdSqdS)Nr�rFT)r�r�)r]r��r�rr�are_valid_constraints#sz3LegacyMetadata.check.<locals>.are_valid_constraintsNzWrong value for '%s': %s)r�rQr�rr
r�r�r�r�r�r�r�)r��strict�missing�warnings�attrr�r�r[Z
controllerr�r]rr�r�check	s8

���zLegacyMetadata.checkcCs�|��d}i}|D]"\}}|r*||jkr||||<q|ddkr�d}|D]B\}}|rb||jkrL|dkrx||||<qLdd�||D�||<qLn8|ddkr�d	}|D]"\}}|r�||jkr�||||<q�|S)
z�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).
        )
)r_r )r`r!)rIr")rbr$)rer')rfr()rgr))rjr*)rcr%)rdr&)rar#)�classifiersr,)rlr-r r@))ror6)rqr7)rrr8)rnr5)rmr3)rvr4)rhr1)rir2rvcSsg|]}d�|��qSr�r�)r��urrrr�bsz)LegacyMetadata.todict.<locals>.<listcomp>r))rtr/)rsr0)rur.)r�r�)r�Zskip_missingZmapping_1_0�datar\r�Zmapping_1_2Zmapping_1_1rrr�todict5s&
zLegacyMetadata.todictcCs8|ddkr$dD]}||kr||=q|d|7<dS)Nr r)r.r0r/r6r)r��requirementsr�rrr�add_requirementsps
zLegacyMetadata.add_requirementscCstt|d��Sr�)r�rJr�rrrrK{szLegacyMetadata.keysccs|��D]
}|VqdSr��rK)r�r\rrr�__iter__~szLegacyMetadata.__iter__cs�fdd����D�S)Ncsg|]}�|�qSrr�r�r\r�rrr��sz)LegacyMetadata.values.<locals>.<listcomp>r�r�rr�rr��szLegacyMetadata.valuescs�fdd����D�S)Ncsg|]}|�|f�qSrrr�r�rrr��sz(LegacyMetadata.items.<locals>.<listcomp>r�r�rr�rrP�szLegacyMetadata.itemscCsd|jj|j|jfS)Nz
<%s %s %s>)�	__class__rr`rIr�rrr�__repr__�s�zLegacyMetadata.__repr__)NNNr�)F)F)F)N)F)F)"rrrrr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rKr�r�rPr�rrrrrs@�




,
,
;rzpydist.jsonz
metadata.jsonZMETADATAc@s�eZdZdZe�d�Ze�dej�Ze	Z
e�d�ZdZde
Zdddd	�Zd
ZdZedfedfe
dfedfd�Zd
ZdDdd�Zed�ZdefZdefZdefdefeeedefeeeedefddd�
Z[[dd�ZdEdd�Zdd�Zed d!��Z ed"d#��Z!e!j"d$d#��Z!dFd%d&�Z#ed'd(��Z$ed)d*��Z%e%j"d+d*��Z%d,d-�Z&d.d/�Z'd0d1�Z(d2d3�Z)d4d5d6d7d8dd9�Z*d:d;�Z+dGd>d?�Z,d@dA�Z-dBdC�Z.dS)Hrz�
    The metadata of a release. This implementation uses 2.0 (JSON)
    metadata where possible. If not possible, it wraps a LegacyMetadata
    instance which handles the key-value metadata format.
    z
^\d+(\.\d+)*$z!^[0-9A-Z]([0-9A-Z_.-]*[0-9A-Z])?$z	.{1,2047}rCzdistlib (%s)r)�legacy)r`rIrbzqname version license summary description author author_email keywords platform home_page classifiers download_urlzwextras run_requires test_requires build_requires dev_requires provides meta_requires obsoleted_by supports_environments)r_r`rIrb)�_legacy�_datar�Nr�c	Cs0|||g�d�dkrtd��d|_d|_||_|dk	rzz|�||�||_Wn*tk
rvt||d�|_|��YnXn�d}|r�t	|d��}|�
�}W5QRXn|r�|�
�}|dkr�|j|jd�|_ndt
|t�s�|�d�}zt�|�|_|�|j|�Wn0tk
�r*tt|�|d�|_|��YnXdS)Nr�r�)r�r��rb�r_�	generatorr)r�r�)r�r�r�r�r��_validate_mappingrr�validater�r��METADATA_VERSION�	GENERATORr�r	�decode�json�loads�
ValueErrorr)r�r�r�r�r�r��frrrr��s@
�


�zMetadata.__init__)r`rIrjrdrbr6r;r=r,)r-N)r N)
�run_requires�build_requires�dev_requiresZ
test_requires�
meta_requires�extras�modules�
namespaces�exports�commandsr�Z
source_urlr_c
CsXt�|d�}t�|d�}||k�r||\}}|jr^|dkrP|dkrHdn|�}n|j�|�}n�|dkrjdn|�}|dkr�|j�||�}n�t�}|}|j�d�}	|	�r
|dkr�|	�d|�}nP|dkr�|	�d�}	|	r�|	�||�}n,|	�d	�}	|	s�|j�d	�}	|	�r
|	�||�}||k�rT|}n:||k�r2t�||�}n"|j�rH|j�|�}n|j�|�}|S)
N�common_keys�mapped_keys�r	rrrr��
extensionsr	�python.commandsr��python.details�python.exports)�object�__getattribute__r�r�r�)
r�r\�common�mapped�lkZmaker�resultr]�sentinel�drrrrsD




zMetadata.__getattribute__cCsH||jkrD|j|\}}|p |j|krD|�|�}|sDtd||f��dS)Nz.'%s' is an invalid value for the '%s' property)�SYNTAX_VALIDATORSr��matchr)r�r\r]r��pattern�
exclusions�mrrr�_validate_value+s

��zMetadata._validate_valuecCs*|�||�t�|d�}t�|d�}||kr�||\}}|jrV|dkrJt�||j|<nf|dkrj||j|<nR|j�di�}|dkr�||d<n2|dkr�|�di�}|||<n|�d	i�}|||<nh||kr�t�|||�nP|d
k�rt|t	��r|�
�}|�r|��}ng}|j�r||j|<n
||j|<dS)Nr
rrr
r	rr�rrrd)rrrr��NotImplementedErrorr��
setdefault�__setattr__r�rr�r�)r�r\r]rrrr�rrrrr!5s<




zMetadata.__setattr__cCst|j|jd�S�NT)r~r`rIr�rrr�name_and_version\szMetadata.name_and_versioncCsF|jr|jd}n|j�dg�}d|j|jf}||krB|�|�|S)Nr5rtz%s (%s))r�r�r r`rIrQ)r�r�srrrrt`s
zMetadata.providescCs |jr||jd<n
||jd<dS)Nr5rt)r�r�r�rrrrtksc
Cs�|jr|}n�g}t|pg|j�}|D]d}d|kr>d|kr>d}n8d|krLd}n|�d�|k}|rv|�d�}|rvt||�}|r$|�|d�q$dD]F}d|}	|	|kr�|�|	�|j�d|g�}|�|j|||d��q�|S)	a�
        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.
        �extra�environmentTrs)ZbuildZdevZtestz:%s:z%s_requires)r�env)	r�rrr�r
�extendrRr��get_requirements)
r��reqtsrr'rrZincluderMr\�errrr)rs2	


�
zMetadata.get_requirementscCs|jr|��S|jSr�)r��_from_legacyr�r�rrr�
dictionary�szMetadata.dictionarycCs|jrt�nt|j|j�SdSr�)r�rrr��DEPENDENCY_KEYSr�rrr�dependencies�szMetadata.dependenciescCs|jrt�n|j�|�dSr�)r�rr�r�r�rrrr/�sc	Cs�|�d�|jkrt��g}|j��D]"\}}||kr$||kr$|�|�q$|rbdd�|�}t|��|��D]\}}|�|||�qjdS)Nr_zMissing metadata items: %sr�)	r�r�r�MANDATORY_KEYSrPrQr�rr)	r�r�r�r�r\rr�r�r�rrrr��szMetadata._validate_mappingcCsB|jr.|j�d�\}}|s|r>t�d||�n|�|j|j�dS)NTz#Metadata: missing: %s, warnings: %s)r�r�rSr�r�r�r�)r�r�r�rrrr��s�zMetadata.validatecCs(|jr|j�d�St|j|j�}|SdSr")r�r�rr��
INDEX_KEYS)r�rrrrr��szMetadata.todictc
Cs�|j|jd�}|j�d�}dD]*}||kr|dkr8d}n|}||||<q|�dg�}|dgkrdg}||d<d	}|D]*\}}||krt||rtd
||ig||<qt|j|d<i}i}	|S)Nr�T)r`rIrjrbrcrkrkr�r&�rd))ror)rprrsrt)r�r�r�r�r�rt)
r�rZlmdr��nk�kwrK�okrfrhrrrr,�s,�

zMetadata._from_legacyr!r"r*r$r%)r`rIrjrbrcr�cCs�dd�}t�}|j}|j��D]\}}||kr||||<q||j|j�}||j|j�}|jrpt	|j�|d<t	|�|d<t	|�|d<|S)NcSs�t�}|D]|}|�d�}|�d�}|d}|D]V}|sF|sF|�|�q.d}|rVd|}|rp|rld||f}n|}|�d�||f��q.q
|S)Nr%r&rsr2z
extra == "%s"z(%s) and %sr�)r�r��addr�)�entriesr*r+r%r'Zrlistr�rMrrr�process_entries�s"

z,Metadata._to_legacy.<locals>.process_entriesr=r6r;)
rr��LEGACY_MAPPINGrPrrrrr�sorted)r�r8rZnmdr3r5Zr1Zr2rrr�
_to_legacy�szMetadata._to_legacyFTc	Cs�||g�d�dkrtd��|��|r`|jr4|j}n|��}|rP|j||d�q�|j||d�n^|jrp|��}n|j}|r�t	j
||dddd�n.t�|dd��}t	j
||dddd�W5QRXdS)	Nrz)Exactly one of path and fileobj is needed)r�Tr�)Zensure_ascii�indentZ	sort_keysr�r)
r�r�r�r�r;r�r�r,r�r��dumpr�r�)r�r�r�r�r�Z	legacy_mdrrrrrr�s*
��zMetadata.writecCs�|jr|j�|�nr|j�dg�}d}|D]}d|kr*d|kr*|}qHq*|dkrfd|i}|�d|�n t|d�t|�B}t|�|d<dS)Nrr&r%rsr)r�r�r�r �insertr�r:)r�r�r�always�entryZrsetrrrr�3szMetadata.add_requirementscCs*|jpd}|jpd}d|jj|j||fS)Nz	(no name)z
no versionz<%s %s %s (%s)>)r`rIr�rr_)r�r`rIrrrr�Ds

�zMetadata.__repr__)NNNr�)N)NN)NNFT)/rrrr�re�compileZMETADATA_VERSION_MATCHER�IZNAME_MATCHERrZVERSION_MATCHERZSUMMARY_MATCHERr�rr�r0r1r.r�	__slots__r�r�r
r�Z	none_list�dictZ	none_dictrrrr!�propertyr#rt�setterr)r-r/r�r�r�r,r9r;r�r�r�rrrrr�s�

���
-�+

'




*


	�	%
)F)ErZ
__future__rr�Zemailrr�r�rAr2rr�compatrrr	rLr
�utilrrrIr
rZ	getLoggerrrSrrrr�__all__rrrBr�r�rDrErVrFrWrHrYrGrXr�r�r�ZEXTRA_RErJr^r�r�r�r�r�r�r�r�rr�r{r~rZMETADATA_FILENAMEZWHEEL_METADATA_FILENAMEZLEGACY_METADATA_FILENAMErrrrr�<module>s�










H�!



site-packages/pip/_vendor/distlib/__pycache__/database.cpython-38.opt-1.pyc000064400000122124151446177000022514 0ustar00U

��.eU��@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
mZddlmZddlmZmZddlmZmZmZmZdd	lmZmZmZmZmZmZm Z d
ddd
dgZ!e�"e#�Z$dZ%dZ&deddde%dfZ'dZ(Gdd�de)�Z*Gdd�de)�Z+Gdd
�d
e)�Z,Gdd�de,�Z-Gdd�de-�Z.Gdd
�d
e-�Z/e.Z0e/Z1Gdd�de)�Z2d)d!d"�Z3d#d$�Z4d%d&�Z5d'd(�Z6dS)*zPEP 376 implementation.�)�unicode_literalsN�)�DistlibException�	resources)�StringIO)�
get_scheme�UnsupportedVersionError)�Metadata�METADATA_FILENAME�WHEEL_METADATA_FILENAME�LEGACY_METADATA_FILENAME)�parse_requirement�cached_property�parse_name_and_version�read_exports�
write_exports�	CSVReader�	CSVWriter�Distribution�BaseInstalledDistribution�InstalledDistribution�EggInfoDistribution�DistributionPathzpydist-exports.jsonzpydist-commands.jsonZ	INSTALLER�RECORD�	REQUESTED�	RESOURCES�SHAREDz
.dist-infoc@s(eZdZdZdd�Zdd�Zdd�ZdS)	�_CachezL
    A simple cache mapping names and .dist-info paths to distributions
    cCsi|_i|_d|_dS)zZ
        Initialise an instance. There is normally one for each DistributionPath.
        FN)�name�path�	generated��self�r#�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/database.py�__init__1sz_Cache.__init__cCs|j��|j��d|_dS)zC
        Clear the cache, setting it to its initial state.
        FN)r�clearrr r!r#r#r$r&9s

z_Cache.clearcCs2|j|jkr.||j|j<|j�|jg��|�dS)z`
        Add a distribution to the cache.
        :param dist: The distribution to add.
        N)rr�
setdefault�key�append�r"�distr#r#r$�addAsz
_Cache.addN)�__name__�
__module__�__qualname__�__doc__r%r&r,r#r#r#r$r-src@s�eZdZdZddd�Zdd�Zdd	�Zeee�Zd
d�Z	dd
�Z
dd�Zedd��Z
dd�Zdd�Zddd�Zdd�Zddd�ZdS)rzU
    Represents a set of distributions installed on a path (typically sys.path).
    NFcCsD|dkrtj}||_d|_||_t�|_t�|_d|_td�|_	dS)a�
        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.
        NT�default)
�sysr�
_include_dist�_include_eggr�_cache�
_cache_egg�_cache_enabledr�_scheme)r"rZinclude_eggr#r#r$r%Os	zDistributionPath.__init__cCs|jS�N�r7r!r#r#r$�_get_cache_enabledcsz#DistributionPath._get_cache_enabledcCs
||_dSr9r:)r"�valuer#r#r$�_set_cache_enabledfsz#DistributionPath._set_cache_enabledcCs|j��|j��dS)z,
        Clears the internal cache.
        N)r5r&r6r!r#r#r$�clear_cacheks
zDistributionPath.clear_cachec
csDt�}|jD�]0}t�|�}|dkr&q|�d�}|r|js<qt|j�}|D]�}|�|�}|rJ|j|krhqJ|j�r|�t	��rt
ttg}|D]"}t
�||�}	|�|	�}
|
r�q�q�qJt�|
����}t|dd�}W5QRXt�d|j�|�|j�t|j||d�VqJ|jrJ|�d�rJt�d|j�|�|j�t|j|�VqJqdS)zD
        Yield .dist-info and/or .egg(-info) distributions.
        N��legacy��fileobj�schemezFound %s)�metadata�env)�	.egg-info�.egg)�setrr�finder_for_path�findZis_container�sortedr3�endswith�DISTINFO_EXTr
rr�	posixpath�join�
contextlib�closing�	as_streamr	�logger�debugr,�new_dist_classr4�old_dist_class)
r"�seenr�finder�rZrset�entryZpossible_filenamesZmetadata_filenameZ
metadata_pathZpydist�streamrDr#r#r$�_yield_distributionsssF




�
�
z%DistributionPath._yield_distributionscCsp|jj}|jo|jj}|s"|rl|��D](}t|t�rF|j�|�q*|j�|�q*|r`d|j_|rld|j_dS)zk
        Scan the path for distributions and populate the cache with
        those that are found.
        TN)r5r r4r6r\�
isinstancerr,)r"Zgen_distZgen_eggr+r#r#r$�_generate_cache�s

z DistributionPath._generate_cachecCs|�dd�}d�||g�tS)ao
        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�-�_)�replacerOrM)�clsr�versionr#r#r$�distinfo_dirname�sz!DistributionPath.distinfo_dirnameccs^|js|��D]
}|Vqn>|��|jj��D]
}|Vq0|jrZ|jj��D]
}|VqNdS)a5
        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
        N)r7r\r^r5r�valuesr4r6r*r#r#r$�get_distributions�s	
z"DistributionPath.get_distributionscCs�d}|��}|js4|��D]}|j|kr|}q|qnH|��||jjkrZ|jj|d}n"|jr|||jjkr||jj|d}|S)a=
        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``
        Nr)	�lowerr7r\r(r^r5rr4r6)r"r�resultr+r#r#r$�get_distribution�s

z!DistributionPath.get_distributionc	cs�d}|dk	rJz|j�d||f�}Wn$tk
rHtd||f��YnX|��D]p}t|d�snt�d|�qR|j}|D]H}t	|�\}}|dkr�||kr�|VqRqx||krx|�
|�rx|VqRqxqRdS)a
        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
        N�%s (%s)zinvalid name or version: %r, %r�provideszNo "provides": %s)r8�matcher�
ValueErrorrrf�hasattrrSrTrkr�match)	r"rrcrlr+�provided�p�p_name�p_verr#r#r$�provides_distribution�s*�
z&DistributionPath.provides_distributioncCs(|�|�}|dkrtd|��|�|�S)z5
        Return the path to a resource file.
        Nzno distribution named %r found)ri�LookupError�get_resource_path)r"r�
relative_pathr+r#r#r$�
get_file_path!s
zDistributionPath.get_file_pathccsX|��D]J}|j}||kr||}|dk	r>||krR||Vq|��D]
}|VqFqdS)z�
        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.
        N)rf�exportsre)r"�categoryrr+rY�d�vr#r#r$�get_exported_entries*sz%DistributionPath.get_exported_entries)NF)N)N)r-r.r/r0r%r;r=�propertyZ
cache_enabledr>r\r^�classmethodrdrfrirtrxr}r#r#r#r$rKs

,

)	c@s�eZdZdZdZdZdd�Zedd��ZeZ	edd��Z
ed	d
��Zdd�Zed
d��Z
edd��Zedd��Zedd��Zedd��Zdd�Zdd�Zdd�Zdd�ZdS) rz�
    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.
    FcCsL||_|j|_|j��|_|j|_d|_d|_d|_d|_t	�|_
i|_dS)z�
        Initialise an instance.
        :param metadata: The instance of :class:`Metadata` describing this
        distribution.
        N)rDrrgr(rcZlocator�digest�extras�contextrHZ
download_urlsZdigests)r"rDr#r#r$r%OszDistribution.__init__cCs|jjS)zH
        The source archive download URL for this distribution.
        )rD�
source_urlr!r#r#r$r�`szDistribution.source_urlcCsd|j|jfS)zX
        A utility property which displays the name and version in parentheses.
        rj�rrcr!r#r#r$�name_and_versioniszDistribution.name_and_versioncCs.|jj}d|j|jf}||kr*|�|�|S)z�
        A set of distribution names and versions provided by this distribution.
        :return: A set of "name (version)" strings.
        rj)rDrkrrcr))r"Zplist�sr#r#r$rkps

zDistribution.providescCs8|j}t�d|���t||�}t|j||j|jd��S)Nz%Getting requirements from metadata %r)r�rE)	rDrSrTZtodict�getattrrHZget_requirementsr�r�)r"Zreq_attr�mdZreqtsr#r#r$�_get_requirements|s
�zDistribution._get_requirementscCs
|�d�S)N�run_requires�r�r!r#r#r$r��szDistribution.run_requirescCs
|�d�S)N�
meta_requiresr�r!r#r#r$r��szDistribution.meta_requirescCs
|�d�S)N�build_requiresr�r!r#r#r$r��szDistribution.build_requirescCs
|�d�S)N�
test_requiresr�r!r#r#r$r��szDistribution.test_requirescCs
|�d�S)N�dev_requiresr�r!r#r#r$r��szDistribution.dev_requiresc
	Cs�t|�}t|jj�}z|�|j�}Wn6tk
rZt�d|�|�	�d}|�|�}YnX|j
}d}|jD]D}t|�\}}	||kr�qlz|�
|	�}Wq�Wqltk
r�YqlXql|S)z�
        Say if this instance matches (fulfills) a requirement.
        :param req: The requirement to match.
        :rtype req: str
        :return: True if it matches, else False.
        �+could not read version %r - using name onlyrF)r
rrDrCrl�requirementrrS�warning�splitr(rkrro)
r"�reqrYrCrlrrhrqrrrsr#r#r$�matches_requirement�s,	�


z Distribution.matches_requirementcCs(|jrd|j}nd}d|j|j|fS)zC
        Return a textual representation of this instance,
        z [%s]r?z<Distribution %s (%s)%s>)r�rrc)r"�suffixr#r#r$�__repr__�szDistribution.__repr__cCs>t|�t|�k	rd}n$|j|jko8|j|jko8|j|jk}|S)a<
        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.
        F)�typerrcr�)r"�otherrhr#r#r$�__eq__�s
�
�zDistribution.__eq__cCst|j�t|j�t|j�S)zH
        Compute hash in a way which matches the equality test.
        )�hashrrcr�r!r#r#r$�__hash__�szDistribution.__hash__N)r-r.r/r0Zbuild_time_dependency�	requestedr%r~r�Zdownload_urlr�rkr�r�r�r�r�r�r�r�r�r�r#r#r#r$r=s4







"
cs0eZdZdZdZd�fdd�	Zddd�Z�ZS)	rz]
    This is the base class for installed distributions (whether PEP 376 or
    legacy).
    Ncs tt|��|�||_||_dS)a
        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.
        N)�superrr%r�	dist_path)r"rDrrE��	__class__r#r$r%�sz"BaseInstalledDistribution.__init__cCsd|dkr|j}|dkr"tj}d}ntt|�}d|j}||���}t�|��d��d�}d||fS)a�
        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
        Nr?z%s=�=�ascii�%s%s)	�hasher�hashlib�md5r�r��base64Zurlsafe_b64encode�rstrip�decode)r"�datar��prefixr�r#r#r$�get_hash�s

z"BaseInstalledDistribution.get_hash)N)N)r-r.r/r0r�r%r��
__classcell__r#r#r�r$r�scs�eZdZdZdZd'�fdd�	Zdd�Zdd	�Zd
d�Ze	dd
��Z
dd�Zdd�Zdd�Z
dd�Zd(dd�Zdd�Ze	dd��Zd)dd�Zdd �Zd!d"�Zd#d$�Zd%d&�ZejZ�ZS)*ra
    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).
    Zsha256Nc
	sJg|_t�|�|_}|dkr*td|��|rP|jrP||jjkrP|jj|j}nt|dkr�|�	t
�}|dkrt|�	t�}|dkr�|�	d�}|dkr�tdt
|f��t�
|����}t|dd�}W5QRXtt|��|||�|r�|jr�|j�|�|�	d�}|dk	|_tj�|d�}tj�|��rFt|d��}|��}	W5QRX|	��|_dS)	Nzfinder unavailable for %sZMETADATAzno %s found in %sr@rAr�
top_level.txt�rb)�modulesrrIrXrmr7r5rrDrJr
rrPrQrRr	r�rr%r,r��osrO�exists�open�read�
splitlines)
r"rrDrErXrYr[rq�fr�r�r#r$r%s8


�


zInstalledDistribution.__init__cCsd|j|j|jfS)Nz#<InstalledDistribution %r %s at %r>�rrcrr!r#r#r$r�=s
�zInstalledDistribution.__repr__cCsd|j|jfS�Nz%s %sr�r!r#r#r$�__str__AszInstalledDistribution.__str__c

Cs�g}|�d�}t�|����\}t|d��F}|D]:}dd�tt|�d�D�}||\}}}	|�|||	f�q.W5QRXW5QRX|S)a"
        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).
        r�r[cSsg|]}d�qSr9r#)�.0�ir#r#r$�
<listcomp>Ssz6InstalledDistribution._get_records.<locals>.<listcomp>�)�get_distinfo_resourcerPrQrRr�range�lenr))
r"�resultsrYr[Z
record_reader�row�missingr�checksum�sizer#r#r$�_get_recordsDs
&z"InstalledDistribution._get_recordscCsi}|�t�}|r|��}|S)a
        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.
        )r��EXPORTS_FILENAMEr)r"rhrYr#r#r$ry[s

zInstalledDistribution.exportsc	Cs8i}|�t�}|r4t�|����}t|�}W5QRX|S)z�
        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.
        )r�r�rPrQrRr)r"rhrYr[r#r#r$ris
z"InstalledDistribution.read_exportsc	Cs.|�t�}t|d��}t||�W5QRXdS)a
        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.
        �wN)�get_distinfo_filer�r�r)r"ryZrfr�r#r#r$rxs
z#InstalledDistribution.write_exportscCs�|�d�}t�|����R}t|d��<}|D]0\}}||kr*|W5QR�W5QR�Sq*W5QRXW5QRXtd|��dS)aW
        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.
        rr�z3no resource file with relative path %r is installedN)r�rPrQrRr�KeyError)r"rwrYr[Zresources_reader�relativeZdestinationr#r#r$rv�s
6�z'InstalledDistribution.get_resource_pathccs|��D]
}|VqdS)z�
        Iterates over the ``RECORD`` entries and returns a tuple
        ``(path, hash, size)`` for each line.

        :returns: iterator of (path, hash, size)
        N)r�)r"rhr#r#r$�list_installed_files�sz*InstalledDistribution.list_installed_filesFcCs(tj�|d�}tj�|j�}|�|�}tj�|d�}|�d�}t�d|�|rRdSt|���}|D]�}tj�	|�sz|�
d�r�d}	}
n4dtj�|�}
t|d��}|�
|���}	W5QRX|�|�s�|r�|�|�r�tj�||�}|�||	|
f�q`|�|��r
tj�||�}|�|ddf�W5QRX|S)z�
        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.
        r?r�creating %sN�z.pycz.pyoz%dr�)r�rrO�dirname�
startswithr�rS�infor�isdirrL�getsizer�r�r��relpathZwriterow)r"�pathsr��dry_run�baseZbase_under_prefix�record_path�writerr�
hash_valuer��fpr#r#r$�write_installed_files�s0



�z+InstalledDistribution.write_installed_filesc
Csg}tj�|j�}|�d�}|��D]�\}}}tj�|�sHtj�||�}||krRq$tj�|�sr|�|dddf�q$tj�	|�r$t
tj�|��}|r�||kr�|�|d||f�q$|r$d|kr�|�dd�d}nd	}t
|d
��2}	|�|	��|�}
|
|k�r|�|d||
f�W5QRXq$|S)�
        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.
        rr�TFr��=rrNr�r�)r�rr�r�r��isabsrOr�r)�isfile�strr�r�r�r�r�)r"�
mismatchesr�r�rr�r�Zactual_sizer�r�Zactual_hashr#r#r$�check_installed_files�s.	

z+InstalledDistribution.check_installed_filesc	Cs�i}tj�|jd�}tj�|�r�tj|ddd��}|����}W5QRX|D]8}|�dd�\}}|dkr||�	|g��
|�qL|||<qL|S)a�
        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.
        rrY�utf-8��encodingr�r�	namespace)r�rrOr��codecsr�r�r�r�r'r))r"rh�shared_pathr��lines�liner(r<r#r#r$�shared_locations�s
z&InstalledDistribution.shared_locationsc		Cs�tj�|jd�}t�d|�|r$dSg}dD].}||}tj�||�r,|�d||f�q,|�dd�D]}|�d|�qhtj	|d	d
d��}|�
d�|��W5QRX|S)
aa
        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.
        rr�N)r��libZheadersZscriptsr�z%s=%sr�r#znamespace=%sr�r�r��
)r�rrOrSr�r�r)�getr�r��write)	r"r�r�r�r�r(r�nsr�r#r#r$�write_shared_locationss	z,InstalledDistribution.write_shared_locationscCsF|tkrtd||jf��t�|j�}|dkr<td|j��|�|�S)N�+invalid path for a dist-info file: %r at %rzUnable to get a finder for %s)�
DIST_FILESrrrrIrJ)r"rrXr#r#r$r�s�z+InstalledDistribution.get_distinfo_resourcecCs~|�tj�dkrT|�tj�dd�\}}||j�tj�dkrTtd||j|jf��|tkrntd||jf��tj�	|j|�S)a�
        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
        r���N���z;dist-info file %r does not belong to the %r %s distributionr�)
rJr��sepr�rrrrcr�rO)r"rrdr#r#r$r�$s���z'InstalledDistribution.get_distinfo_fileccsRtj�|j�}|��D]6\}}}tj�|�s:tj�||�}|�|j�r|VqdS)z�
        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
        N)r�rr�r�r�rOr�)r"r�rr�r�r#r#r$�list_distinfo_filesAsz)InstalledDistribution.list_distinfo_filescCst|t�o|j|jkSr9)r]rr�r"r�r#r#r$r�Qs

�zInstalledDistribution.__eq__)NN)F)F)r-r.r/r0r�r%r�r�r�rryrrrvr�r�r�r�r�r�r�r�r��objectr�r�r#r#r�r$rs,"



##

	csjeZdZdZdZiZd�fdd�	Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zddd�Zdd�Z
ejZ�ZS)raCreated 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.TNcs�dd�}||_||_|rJ|jrJ||jjkrJ|jj|j}|||j|j�n0|�|�}|||j|j�|rz|jrz|j�|�t	t
|��|||�dS)NcSs||_|��|_||_dSr9)rrgr(rc)r��nr|r#r#r$�set_name_and_versioncs
z:EggInfoDistribution.__init__.<locals>.set_name_and_version)rr�r7r6rDrrc�
_get_metadatar,r�rr%)r"rrEr�rDr�r#r$r%bs

zEggInfoDistribution.__init__c	s�d}dd���fdd�}d}}|�d�r�tj�|�r�tj�|d�}tj�|d�}t|dd	�}tj�|d
�}	tj�|d�}||	�}npt�|�}
t|
�	d��
d
��}t|dd�}z,|
�	d�}|
�	d��
d�}�|�
d��}Wntk
r�d}YnXnf|�d��rPtj�|��rBtj�|d
�}	||	�}tj�|d�}tj�|d�}t|dd	�}ntd|��|�rl|�
|�|dk�r�|dk	�r�tj�|��r�t|d��}
|
���
d�}W5QRX|�s�g}n|��}||_|S)NcSs�g}|��}|D]�}|��}|�d�r6t�d|�q�t|�}|sPt�d|�q|jr`t�d�|jst|�|j	�qd�
dd�|jD��}|�d|j	|f�q|S)	z�Create a list of dependencies from a requires.txt file.

            *data*: the contents of a setuptools-produced requires.txt file.
            �[z.Unexpected line: quitting requirement scan: %rz#Not recognised as a requirement: %rz4extra requirements in requires.txt are not supportedz, css|]}d|VqdS)r�Nr#)r��cr#r#r$�	<genexpr>�szQEggInfoDistribution._get_metadata.<locals>.parse_requires_data.<locals>.<genexpr>rj)r��stripr�rSr�r
r�Zconstraintsr)rrO)r��reqsr�r�rYZconsr#r#r$�parse_requires_datazs(
�
z>EggInfoDistribution._get_metadata.<locals>.parse_requires_datac	sHg}z*t�|dd��}�|���}W5QRXWntk
rBYnX|S)z�Create a list of dependencies from a requires.txt file.

            *req_path*: the path to a setuptools-produced requires.txt file.
            rYr�)r�r�r��IOError)�req_pathrr��rr#r$�parse_requires_path�sz>EggInfoDistribution._get_metadata.<locals>.parse_requires_pathrGzEGG-INFOzPKG-INFOr@)rrCzrequires.txtr�zEGG-INFO/PKG-INFO�utf8rAzEGG-INFO/requires.txtzEGG-INFO/top_level.txtr�rFz,path must end with .egg-info or .egg, got %rr�)rLr�rr�rOr	�	zipimport�zipimporterr�get_datar�rrZadd_requirementsr�r�r�r�r�)r"r�requiresr	Ztl_pathZtl_datarq�	meta_pathrDrZzipfrBr�r�r#rr$r�wsX


�
�

z!EggInfoDistribution._get_metadatacCsd|j|j|jfS)Nz!<EggInfoDistribution %r %s at %r>r�r!r#r#r$r��s
�zEggInfoDistribution.__repr__cCsd|j|jfSr�r�r!r#r#r$r��szEggInfoDistribution.__str__cCs`g}tj�|jd�}tj�|�r\|��D]2\}}}||kr<q(tj�|�s(|�|dddf�q(|S)r��installed-files.txtr�TF)r�rrOr�r�r))r"r�r�rr`r#r#r$r��s	z)EggInfoDistribution.check_installed_filesc	Cs�dd�}dd�}tj�|jd�}g}tj�|�r�tj|ddd��x}|D]l}|��}tj�tj�|j|��}tj�|�s�t�	d	|�|�
d
�r�qFtj�|�sF|�|||�||�f�qFW5QRX|�|ddf�|S)z�
        Iterates over the ``installed-files.txt`` entries and returns a tuple
        ``(path, hash, size)`` for each line.

        :returns: a list of (path, hash, size)
        cSs0t|d�}z|��}W5|��Xt�|���S)Nr�)r��closer�r�r�Z	hexdigest)rr�Zcontentr#r#r$�_md5�s


z6EggInfoDistribution.list_installed_files.<locals>._md5cSst�|�jSr9)r��stat�st_size)rr#r#r$�_size�sz7EggInfoDistribution.list_installed_files.<locals>._sizerrYr�r�zNon-existent file: %sr�N)
r�rrOr�r�r�r�normpathrSr�rLr�r))r"rrr�rhr�r�rqr#r#r$r��s"
$z(EggInfoDistribution.list_installed_filesFc	cs�tj�|jd�}tj�|�r�d}tj|ddd��`}|D]T}|��}|dkrPd}q6|s6tj�tj�|j|��}|�|j�r6|r�|Vq6|Vq6W5QRXdS)	a
        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
        rTrYr�r�z./FN)	r�rrOr�r�r�rrr�)r"Zabsoluter��skipr�r�rqr#r#r$r�sz'EggInfoDistribution.list_distinfo_filescCst|t�o|j|jkSr9)r]rrr�r#r#r$r�.s

�zEggInfoDistribution.__eq__)N)F)r-r.r/r0r�r�r%r�r�r�r�r�r�r�r�r�r�r#r#r�r$rYsZ&
c@s^eZdZdZdd�Zdd�Zddd�Zd	d
�Zdd�Zddd�Z	ddd�Z
dd�Zdd�ZdS)�DependencyGrapha�
    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.
    cCsi|_i|_i|_dSr9)�adjacency_list�reverse_listr�r!r#r#r$r%IszDependencyGraph.__init__cCsg|j|<g|j|<dS)z�Add the *distribution* to the graph.

        :type distribution: :class:`distutils2.database.InstalledDistribution`
                            or :class:`distutils2.database.EggInfoDistribution`
        N)rr)r"�distributionr#r#r$�add_distributionNs
z DependencyGraph.add_distributionNcCs6|j|�||f�||j|kr2|j|�|�dS)a�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``
        N)rr)r)r"�x�y�labelr#r#r$�add_edgeXs
zDependencyGraph.add_edgecCs&t�d||�|j�|g��|�dS)a
        Add a missing *requirement* for the given *distribution*.

        :type distribution: :class:`distutils2.database.InstalledDistribution`
                            or :class:`distutils2.database.EggInfoDistribution`
        :type requirement: ``str``
        z
%s missing %rN)rSrTr�r'r))r"rr�r#r#r$�add_missinggszDependencyGraph.add_missingcCsd|j|jfSr�r�r*r#r#r$�
_repr_distrszDependencyGraph._repr_distrcCs�|�|�g}|j|D]h\}}|�|�}|dk	r<d||f}|�d|t|��|�||d�}|�d�}|�|dd��qd�|�S)zPrints only a subgraphNz%s [%s]z    rr�)r"rr)r��	repr_noder��extendrO)r"r+�level�outputr�rZ	suboutputZsubsr#r#r$r#us

zDependencyGraph.repr_nodeTcCs�g}|�d�|j��D]h\}}t|�dkr:|s:|�|�|D]@\}}|dk	rh|�d|j|j|f�q>|�d|j|jf�q>q|s�t|�dkr�|�d�|�d�|�d�|D]}|�d	|j�|�d
�q�|�d�|�d�dS)a9Writes 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``
        zdigraph dependencies {
rNz"%s" -> "%s" [label="%s"]
z
"%s" -> "%s"
zsubgraph disconnected {
zlabel = "Disconnected"
zbgcolor = red
z"%s"r�z}
)r�r�itemsr�r)r)r"r�Zskip_disconnectedZdisconnectedr+�adjsr�rr#r#r$�to_dot�s(	

�



zDependencyGraph.to_dotcs�g}i}|j��D]\}}|dd�||<qg�t|���dd�D]\}}|sD��|�||=qD�shq�|��D]\}}�fdd�|D�||<qpt�ddd��D��|���q,|t|���fS)aa
        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.
        Ncs g|]\}}|�kr||f�qSr#r#)r�r{rY�Z	to_remover#r$r��sz4DependencyGraph.topological_sort.<locals>.<listcomp>zMoving to result: %scSsg|]}d|j|jf�qS)rjr�)r�r{r#r#r$r��s)rr'�listr)rSrTr$�keys)r"rhZalist�kr|r#r*r$�topological_sort�s$
�z DependencyGraph.topological_sortcCs2g}|j��D]\}}|�|�|��qd�|�S)zRepresentation of the graphr�)rr'r)r#rO)r"r&r+r(r#r#r$r��szDependencyGraph.__repr__)N)r)T)
r-r.r/r0r%rr r!r"r#r)r.r�r#r#r#r$r9s



 rr1cCsVt|�}t�}i}|D]L}|�|�|jD]6}t|�\}}t�d|||�|�|g��||f�q*q|D]�}|j	|j
B|jB|jB}|D]�}	z|�
|	�}
Wn6tk
r�t�d|	�|	��d}|�
|�}
YnX|
j}d}||k�r>||D]N\}}z|
�|�}
Wntk
�rd}
YnX|
r�|�|||	�d}�q>q�|s�|�||	�q�qh|S)a6Makes 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
    zAdd to provided: %s, %s, %sr�rFT)rrrrkrrSrTr'r)r�r�r�r�rlrr�r�r(ror r!)�distsrC�graphrpr+rqrrcrr�rlZmatchedZproviderror#r#r$�
make_graph�sN


���

r1cCsv||krtd|j��t|�}|g}|j|}|rh|��}|�|�|j|D]}||krN|�|�qNq.|�d�|S)z�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
    �1given distribution %r is not a member of the listr)rrr1r�popr))r/r+r0Zdep�todor{Zsuccr#r#r$�get_dependent_dists�s�


r5cCsn||krtd|j��t|�}g}|j|}|rj|��d}|�|�|j|D]}||krP|�|�qPq,|S)z�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
    r2r)rrr1rr3r))r/r+r0r�r4r{Zpredr#r#r$�get_required_distss�

r6cKs4|�dd�}tf|�}||_||_|p(d|_t|�S)zO
    A convenience method for making a dist given just a name and version.
    �summaryzPlaceholder for summary)r3r	rrcr7r)rrc�kwargsr7r�r#r#r$�	make_dist2s

r9)r1)7r0Z
__future__rr�r�rPr�Zloggingr�rNr2rr?rr�compatrrcrrrDr	r
rr�utilr
rrrrrr�__all__Z	getLoggerr-rSr�ZCOMMANDS_FILENAMEr�rMr�rrrrrrrUrVrr1r5r6r9r#r#r#r$�<module>s`$�
�s7J]
6site-packages/pip/_vendor/distlib/__pycache__/markers.cpython-38.pyc000064400000010555151446177000021461 0ustar00U

��.e#�@s�dZddlZddlZddlZddlZddlmZmZmZddl	m
Z
mZdgZdd�Z
Gd	d
�d
e�Zdd�Ze�Z[e�Zdd
d�ZdS)zG
Parser for the environment markers micro-language defined in PEP 508.
�N�)�python_implementation�urlparse�string_types)�in_venv�parse_marker�	interpretcCst|t�r|sdS|ddkS)NFr�'")�
isinstancer)�o�r�?/usr/lib/python3.8/site-packages/pip/_vendor/distlib/markers.py�_is_literalsrc
@sfeZdZdZdd�dd�dd�dd�dd�dd�d	d�d
d�dd�dd�d
d�dd�d�Zdd�ZdS)�	Evaluatorz;
    This class is used to evaluate marker expessions.
    cCs||kS�Nr��x�yrrr
�<lambda>$�zEvaluator.<lambda>cCs||kSrrrrrr
r%rcCs||kp||kSrrrrrr
r&rcCs||kSrrrrrr
r'rcCs||kSrrrrrr
r(rcCs||kp||kSrrrrrr
r)rcCs||kSrrrrrr
r*rcCs||kp||kSrrrrrr
r+rcCs|o|Srrrrrr
r,rcCs|p|Srrrrrr
r-rcCs||kSrrrrrr
r.rcCs||kSrrrrrr
r/r)z==z===z~=z!=�<z<=�>z>=�and�or�inznot inc	Cs�t|t�rB|ddkr$|dd�}q�||kr8td|��||}n�t|t�sPt�|d}||jkrntd|��|d}|d	}t|d�r�t|d	�r�td
|||f��|�||�}|�||�}|j|||�}|S)z�
        Evaluate a marker expression returned by the :func:`parse_requirement`
        function in the specified context.
        rr	r���zunknown variable: %s�opzop not implemented: %s�lhs�rhszinvalid comparison: %s %s %s)	r
r�SyntaxError�dict�AssertionError�
operations�NotImplementedErrorr�evaluate)	�self�expr�context�resultrZelhsZerhsrrrrr
r$2s$


zEvaluator.evaluateN)�__name__�
__module__�__qualname__�__doc__r"r$rrrr
rs�rc
Cs�dd�}ttd�r(|tjj�}tjj}nd}d}||tjt��t��t�	�t�
�t��tt��t�
�t�
�dd�tjd�}|S)NcSs<d|j|j|jf}|j}|dkr8||dt|j�7}|S)Nz%s.%s.%s�finalr)�major�minor�micro�releaselevel�str�serial)�info�versionZkindrrr
�format_full_versionNs
z,default_context.<locals>.format_full_version�implementation�0��)�implementation_name�implementation_versionZos_nameZplatform_machineZplatform_python_implementationZplatform_releaseZplatform_systemZplatform_versionZplatform_in_venvZpython_full_version�python_versionZsys_platform)�hasattr�sysr7r5�name�os�platform�machiner�release�systemr2rr=)r6r<r;r(rrr
�default_contextMs(

�rFc
Cs�zt|�\}}Wn2tk
rB}ztd||f��W5d}~XYnX|rd|ddkrdtd||f��tt�}|rz|�|�t�||�S)z�
    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
    z)Unable to interpret marker syntax: %s: %sNr�#z*unexpected trailing data in marker: %s: %s)r�	Exceptionrr �DEFAULT_CONTEXT�update�	evaluatorr$)ZmarkerZexecution_contextr&�rest�er'rrr
rqs	"
)N)r,rAr?rB�re�compatrrr�utilrr�__all__r�objectrrFrIrKrrrrr
�<module>s/site-packages/pip/_vendor/distlib/__pycache__/database.cpython-38.pyc000064400000122124151446177000021555 0ustar00U

��.eU��@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlm
Z
mZddlmZddlmZmZddlmZmZmZmZdd	lmZmZmZmZmZmZm Z d
ddd
dgZ!e�"e#�Z$dZ%dZ&deddde%dfZ'dZ(Gdd�de)�Z*Gdd�de)�Z+Gdd
�d
e)�Z,Gdd�de,�Z-Gdd�de-�Z.Gdd
�d
e-�Z/e.Z0e/Z1Gdd�de)�Z2d)d!d"�Z3d#d$�Z4d%d&�Z5d'd(�Z6dS)*zPEP 376 implementation.�)�unicode_literalsN�)�DistlibException�	resources)�StringIO)�
get_scheme�UnsupportedVersionError)�Metadata�METADATA_FILENAME�WHEEL_METADATA_FILENAME�LEGACY_METADATA_FILENAME)�parse_requirement�cached_property�parse_name_and_version�read_exports�
write_exports�	CSVReader�	CSVWriter�Distribution�BaseInstalledDistribution�InstalledDistribution�EggInfoDistribution�DistributionPathzpydist-exports.jsonzpydist-commands.jsonZ	INSTALLER�RECORD�	REQUESTED�	RESOURCES�SHAREDz
.dist-infoc@s(eZdZdZdd�Zdd�Zdd�ZdS)	�_CachezL
    A simple cache mapping names and .dist-info paths to distributions
    cCsi|_i|_d|_dS)zZ
        Initialise an instance. There is normally one for each DistributionPath.
        FN)�name�path�	generated��self�r#�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/database.py�__init__1sz_Cache.__init__cCs|j��|j��d|_dS)zC
        Clear the cache, setting it to its initial state.
        FN)r�clearrr r!r#r#r$r&9s

z_Cache.clearcCs2|j|jkr.||j|j<|j�|jg��|�dS)z`
        Add a distribution to the cache.
        :param dist: The distribution to add.
        N)rr�
setdefault�key�append�r"�distr#r#r$�addAsz
_Cache.addN)�__name__�
__module__�__qualname__�__doc__r%r&r,r#r#r#r$r-src@s�eZdZdZddd�Zdd�Zdd	�Zeee�Zd
d�Z	dd
�Z
dd�Zedd��Z
dd�Zdd�Zddd�Zdd�Zddd�ZdS)rzU
    Represents a set of distributions installed on a path (typically sys.path).
    NFcCsD|dkrtj}||_d|_||_t�|_t�|_d|_td�|_	dS)a�
        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.
        NT�default)
�sysr�
_include_dist�_include_eggr�_cache�
_cache_egg�_cache_enabledr�_scheme)r"rZinclude_eggr#r#r$r%Os	zDistributionPath.__init__cCs|jS�N�r7r!r#r#r$�_get_cache_enabledcsz#DistributionPath._get_cache_enabledcCs
||_dSr9r:)r"�valuer#r#r$�_set_cache_enabledfsz#DistributionPath._set_cache_enabledcCs|j��|j��dS)z,
        Clears the internal cache.
        N)r5r&r6r!r#r#r$�clear_cacheks
zDistributionPath.clear_cachec
csDt�}|jD�]0}t�|�}|dkr&q|�d�}|r|js<qt|j�}|D]�}|�|�}|rJ|j|krhqJ|j�r|�t	��rt
ttg}|D]"}t
�||�}	|�|	�}
|
r�q�q�qJt�|
����}t|dd�}W5QRXt�d|j�|�|j�t|j||d�VqJ|jrJ|�d�rJt�d|j�|�|j�t|j|�VqJqdS)zD
        Yield .dist-info and/or .egg(-info) distributions.
        N��legacy��fileobj�schemezFound %s)�metadata�env)�	.egg-info�.egg)�setrr�finder_for_path�findZis_container�sortedr3�endswith�DISTINFO_EXTr
rr�	posixpath�join�
contextlib�closing�	as_streamr	�logger�debugr,�new_dist_classr4�old_dist_class)
r"�seenr�finder�rZrset�entryZpossible_filenamesZmetadata_filenameZ
metadata_pathZpydist�streamrDr#r#r$�_yield_distributionsssF




�
�
z%DistributionPath._yield_distributionscCsp|jj}|jo|jj}|s"|rl|��D](}t|t�rF|j�|�q*|j�|�q*|r`d|j_|rld|j_dS)zk
        Scan the path for distributions and populate the cache with
        those that are found.
        TN)r5r r4r6r\�
isinstancerr,)r"Zgen_distZgen_eggr+r#r#r$�_generate_cache�s

z DistributionPath._generate_cachecCs|�dd�}d�||g�tS)ao
        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�-�_)�replacerOrM)�clsr�versionr#r#r$�distinfo_dirname�sz!DistributionPath.distinfo_dirnameccs^|js|��D]
}|Vqn>|��|jj��D]
}|Vq0|jrZ|jj��D]
}|VqNdS)a5
        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
        N)r7r\r^r5r�valuesr4r6r*r#r#r$�get_distributions�s	
z"DistributionPath.get_distributionscCs�d}|��}|js4|��D]}|j|kr|}q|qnH|��||jjkrZ|jj|d}n"|jr|||jjkr||jj|d}|S)a=
        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``
        Nr)	�lowerr7r\r(r^r5rr4r6)r"r�resultr+r#r#r$�get_distribution�s

z!DistributionPath.get_distributionc	cs�d}|dk	rJz|j�d||f�}Wn$tk
rHtd||f��YnX|��D]p}t|d�snt�d|�qR|j}|D]H}t	|�\}}|dkr�||kr�|VqRqx||krx|�
|�rx|VqRqxqRdS)a
        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
        N�%s (%s)zinvalid name or version: %r, %r�provideszNo "provides": %s)r8�matcher�
ValueErrorrrf�hasattrrSrTrkr�match)	r"rrcrlr+�provided�p�p_name�p_verr#r#r$�provides_distribution�s*�
z&DistributionPath.provides_distributioncCs(|�|�}|dkrtd|��|�|�S)z5
        Return the path to a resource file.
        Nzno distribution named %r found)ri�LookupError�get_resource_path)r"r�
relative_pathr+r#r#r$�
get_file_path!s
zDistributionPath.get_file_pathccsX|��D]J}|j}||kr||}|dk	r>||krR||Vq|��D]
}|VqFqdS)z�
        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.
        N)rf�exportsre)r"�categoryrr+rY�d�vr#r#r$�get_exported_entries*sz%DistributionPath.get_exported_entries)NF)N)N)r-r.r/r0r%r;r=�propertyZ
cache_enabledr>r\r^�classmethodrdrfrirtrxr}r#r#r#r$rKs

,

)	c@s�eZdZdZdZdZdd�Zedd��ZeZ	edd��Z
ed	d
��Zdd�Zed
d��Z
edd��Zedd��Zedd��Zedd��Zdd�Zdd�Zdd�Zdd�ZdS) rz�
    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.
    FcCsL||_|j|_|j��|_|j|_d|_d|_d|_d|_t	�|_
i|_dS)z�
        Initialise an instance.
        :param metadata: The instance of :class:`Metadata` describing this
        distribution.
        N)rDrrgr(rcZlocator�digest�extras�contextrHZ
download_urlsZdigests)r"rDr#r#r$r%OszDistribution.__init__cCs|jjS)zH
        The source archive download URL for this distribution.
        )rD�
source_urlr!r#r#r$r�`szDistribution.source_urlcCsd|j|jfS)zX
        A utility property which displays the name and version in parentheses.
        rj�rrcr!r#r#r$�name_and_versioniszDistribution.name_and_versioncCs.|jj}d|j|jf}||kr*|�|�|S)z�
        A set of distribution names and versions provided by this distribution.
        :return: A set of "name (version)" strings.
        rj)rDrkrrcr))r"Zplist�sr#r#r$rkps

zDistribution.providescCs8|j}t�d|���t||�}t|j||j|jd��S)Nz%Getting requirements from metadata %r)r�rE)	rDrSrTZtodict�getattrrHZget_requirementsr�r�)r"Zreq_attr�mdZreqtsr#r#r$�_get_requirements|s
�zDistribution._get_requirementscCs
|�d�S)N�run_requires�r�r!r#r#r$r��szDistribution.run_requirescCs
|�d�S)N�
meta_requiresr�r!r#r#r$r��szDistribution.meta_requirescCs
|�d�S)N�build_requiresr�r!r#r#r$r��szDistribution.build_requirescCs
|�d�S)N�
test_requiresr�r!r#r#r$r��szDistribution.test_requirescCs
|�d�S)N�dev_requiresr�r!r#r#r$r��szDistribution.dev_requiresc
	Cs�t|�}t|jj�}z|�|j�}Wn6tk
rZt�d|�|�	�d}|�|�}YnX|j
}d}|jD]D}t|�\}}	||kr�qlz|�
|	�}Wq�Wqltk
r�YqlXql|S)z�
        Say if this instance matches (fulfills) a requirement.
        :param req: The requirement to match.
        :rtype req: str
        :return: True if it matches, else False.
        �+could not read version %r - using name onlyrF)r
rrDrCrl�requirementrrS�warning�splitr(rkrro)
r"�reqrYrCrlrrhrqrrrsr#r#r$�matches_requirement�s,	�


z Distribution.matches_requirementcCs(|jrd|j}nd}d|j|j|fS)zC
        Return a textual representation of this instance,
        z [%s]r?z<Distribution %s (%s)%s>)r�rrc)r"�suffixr#r#r$�__repr__�szDistribution.__repr__cCs>t|�t|�k	rd}n$|j|jko8|j|jko8|j|jk}|S)a<
        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.
        F)�typerrcr�)r"�otherrhr#r#r$�__eq__�s
�
�zDistribution.__eq__cCst|j�t|j�t|j�S)zH
        Compute hash in a way which matches the equality test.
        )�hashrrcr�r!r#r#r$�__hash__�szDistribution.__hash__N)r-r.r/r0Zbuild_time_dependency�	requestedr%r~r�Zdownload_urlr�rkr�r�r�r�r�r�r�r�r�r�r#r#r#r$r=s4







"
cs0eZdZdZdZd�fdd�	Zddd�Z�ZS)	rz]
    This is the base class for installed distributions (whether PEP 376 or
    legacy).
    Ncs tt|��|�||_||_dS)a
        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.
        N)�superrr%r�	dist_path)r"rDrrE��	__class__r#r$r%�sz"BaseInstalledDistribution.__init__cCsd|dkr|j}|dkr"tj}d}ntt|�}d|j}||���}t�|��d��d�}d||fS)a�
        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
        Nr?z%s=�=�ascii�%s%s)	�hasher�hashlib�md5r�r��base64Zurlsafe_b64encode�rstrip�decode)r"�datar��prefixr�r#r#r$�get_hash�s

z"BaseInstalledDistribution.get_hash)N)N)r-r.r/r0r�r%r��
__classcell__r#r#r�r$r�scs�eZdZdZdZd'�fdd�	Zdd�Zdd	�Zd
d�Ze	dd
��Z
dd�Zdd�Zdd�Z
dd�Zd(dd�Zdd�Ze	dd��Zd)dd�Zdd �Zd!d"�Zd#d$�Zd%d&�ZejZ�ZS)*ra
    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).
    Zsha256Nc
	sJg|_t�|�|_}|dkr*td|��|rP|jrP||jjkrP|jj|j}nt|dkr�|�	t
�}|dkrt|�	t�}|dkr�|�	d�}|dkr�tdt
|f��t�
|����}t|dd�}W5QRXtt|��|||�|r�|jr�|j�|�|�	d�}|dk	|_tj�|d�}tj�|��rFt|d��}|��}	W5QRX|	��|_dS)	Nzfinder unavailable for %sZMETADATAzno %s found in %sr@rAr�
top_level.txt�rb)�modulesrrIrXrmr7r5rrDrJr
rrPrQrRr	r�rr%r,r��osrO�exists�open�read�
splitlines)
r"rrDrErXrYr[rq�fr�r�r#r$r%s8


�


zInstalledDistribution.__init__cCsd|j|j|jfS)Nz#<InstalledDistribution %r %s at %r>�rrcrr!r#r#r$r�=s
�zInstalledDistribution.__repr__cCsd|j|jfS�Nz%s %sr�r!r#r#r$�__str__AszInstalledDistribution.__str__c

Cs�g}|�d�}t�|����\}t|d��F}|D]:}dd�tt|�d�D�}||\}}}	|�|||	f�q.W5QRXW5QRX|S)a"
        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).
        r�r[cSsg|]}d�qSr9r#)�.0�ir#r#r$�
<listcomp>Ssz6InstalledDistribution._get_records.<locals>.<listcomp>�)�get_distinfo_resourcerPrQrRr�range�lenr))
r"�resultsrYr[Z
record_reader�row�missingr�checksum�sizer#r#r$�_get_recordsDs
&z"InstalledDistribution._get_recordscCsi}|�t�}|r|��}|S)a
        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.
        )r��EXPORTS_FILENAMEr)r"rhrYr#r#r$ry[s

zInstalledDistribution.exportsc	Cs8i}|�t�}|r4t�|����}t|�}W5QRX|S)z�
        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.
        )r�r�rPrQrRr)r"rhrYr[r#r#r$ris
z"InstalledDistribution.read_exportsc	Cs.|�t�}t|d��}t||�W5QRXdS)a
        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.
        �wN)�get_distinfo_filer�r�r)r"ryZrfr�r#r#r$rxs
z#InstalledDistribution.write_exportscCs�|�d�}t�|����R}t|d��<}|D]0\}}||kr*|W5QR�W5QR�Sq*W5QRXW5QRXtd|��dS)aW
        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.
        rr�z3no resource file with relative path %r is installedN)r�rPrQrRr�KeyError)r"rwrYr[Zresources_reader�relativeZdestinationr#r#r$rv�s
6�z'InstalledDistribution.get_resource_pathccs|��D]
}|VqdS)z�
        Iterates over the ``RECORD`` entries and returns a tuple
        ``(path, hash, size)`` for each line.

        :returns: iterator of (path, hash, size)
        N)r�)r"rhr#r#r$�list_installed_files�sz*InstalledDistribution.list_installed_filesFcCs(tj�|d�}tj�|j�}|�|�}tj�|d�}|�d�}t�d|�|rRdSt|���}|D]�}tj�	|�sz|�
d�r�d}	}
n4dtj�|�}
t|d��}|�
|���}	W5QRX|�|�s�|r�|�|�r�tj�||�}|�||	|
f�q`|�|��r
tj�||�}|�|ddf�W5QRX|S)z�
        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.
        r?r�creating %sN�z.pycz.pyoz%dr�)r�rrO�dirname�
startswithr�rS�infor�isdirrL�getsizer�r�r��relpathZwriterow)r"�pathsr��dry_run�baseZbase_under_prefix�record_path�writerr�
hash_valuer��fpr#r#r$�write_installed_files�s0



�z+InstalledDistribution.write_installed_filesc
Csg}tj�|j�}|�d�}|��D]�\}}}tj�|�sHtj�||�}||krRq$tj�|�sr|�|dddf�q$tj�	|�r$t
tj�|��}|r�||kr�|�|d||f�q$|r$d|kr�|�dd�d}nd	}t
|d
��2}	|�|	��|�}
|
|k�r|�|d||
f�W5QRXq$|S)�
        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.
        rr�TFr��=rrNr�r�)r�rr�r�r��isabsrOr�r)�isfile�strr�r�r�r�r�)r"�
mismatchesr�r�rr�r�Zactual_sizer�r�Zactual_hashr#r#r$�check_installed_files�s.	

z+InstalledDistribution.check_installed_filesc	Cs�i}tj�|jd�}tj�|�r�tj|ddd��}|����}W5QRX|D]8}|�dd�\}}|dkr||�	|g��
|�qL|||<qL|S)a�
        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.
        rrY�utf-8��encodingr�r�	namespace)r�rrOr��codecsr�r�r�r�r'r))r"rh�shared_pathr��lines�liner(r<r#r#r$�shared_locations�s
z&InstalledDistribution.shared_locationsc		Cs�tj�|jd�}t�d|�|r$dSg}dD].}||}tj�||�r,|�d||f�q,|�dd�D]}|�d|�qhtj	|d	d
d��}|�
d�|��W5QRX|S)
aa
        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.
        rr�N)r��libZheadersZscriptsr�z%s=%sr�r#znamespace=%sr�r�r��
)r�rrOrSr�r�r)�getr�r��write)	r"r�r�r�r�r(r�nsr�r#r#r$�write_shared_locationss	z,InstalledDistribution.write_shared_locationscCsF|tkrtd||jf��t�|j�}|dkr<td|j��|�|�S)N�+invalid path for a dist-info file: %r at %rzUnable to get a finder for %s)�
DIST_FILESrrrrIrJ)r"rrXr#r#r$r�s�z+InstalledDistribution.get_distinfo_resourcecCs~|�tj�dkrT|�tj�dd�\}}||j�tj�dkrTtd||j|jf��|tkrntd||jf��tj�	|j|�S)a�
        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
        r���N���z;dist-info file %r does not belong to the %r %s distributionr�)
rJr��sepr�rrrrcr�rO)r"rrdr#r#r$r�$s���z'InstalledDistribution.get_distinfo_fileccsRtj�|j�}|��D]6\}}}tj�|�s:tj�||�}|�|j�r|VqdS)z�
        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
        N)r�rr�r�r�rOr�)r"r�rr�r�r#r#r$�list_distinfo_filesAsz)InstalledDistribution.list_distinfo_filescCst|t�o|j|jkSr9)r]rr�r"r�r#r#r$r�Qs

�zInstalledDistribution.__eq__)NN)F)F)r-r.r/r0r�r%r�r�r�rryrrrvr�r�r�r�r�r�r�r�r��objectr�r�r#r#r�r$rs,"



##

	csjeZdZdZdZiZd�fdd�	Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zddd�Zdd�Z
ejZ�ZS)raCreated 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.TNcs�dd�}||_||_|rJ|jrJ||jjkrJ|jj|j}|||j|j�n0|�|�}|||j|j�|rz|jrz|j�|�t	t
|��|||�dS)NcSs||_|��|_||_dSr9)rrgr(rc)r��nr|r#r#r$�set_name_and_versioncs
z:EggInfoDistribution.__init__.<locals>.set_name_and_version)rr�r7r6rDrrc�
_get_metadatar,r�rr%)r"rrEr�rDr�r#r$r%bs

zEggInfoDistribution.__init__c	s�d}dd���fdd�}d}}|�d�r�tj�|�r�tj�|d�}tj�|d�}t|dd	�}tj�|d
�}	tj�|d�}||	�}npt�|�}
t|
�	d��
d
��}t|dd�}z,|
�	d�}|
�	d��
d�}�|�
d��}Wntk
r�d}YnXnf|�d��rPtj�|��rBtj�|d
�}	||	�}tj�|d�}tj�|d�}t|dd	�}ntd|��|�rl|�
|�|dk�r�|dk	�r�tj�|��r�t|d��}
|
���
d�}W5QRX|�s�g}n|��}||_|S)NcSs�g}|��}|D]�}|��}|�d�r6t�d|�q�t|�}|sPt�d|�q|jr`t�d�|jst|�|j	�qd�
dd�|jD��}|�d|j	|f�q|S)	z�Create a list of dependencies from a requires.txt file.

            *data*: the contents of a setuptools-produced requires.txt file.
            �[z.Unexpected line: quitting requirement scan: %rz#Not recognised as a requirement: %rz4extra requirements in requires.txt are not supportedz, css|]}d|VqdS)r�Nr#)r��cr#r#r$�	<genexpr>�szQEggInfoDistribution._get_metadata.<locals>.parse_requires_data.<locals>.<genexpr>rj)r��stripr�rSr�r
r�Zconstraintsr)rrO)r��reqsr�r�rYZconsr#r#r$�parse_requires_datazs(
�
z>EggInfoDistribution._get_metadata.<locals>.parse_requires_datac	sHg}z*t�|dd��}�|���}W5QRXWntk
rBYnX|S)z�Create a list of dependencies from a requires.txt file.

            *req_path*: the path to a setuptools-produced requires.txt file.
            rYr�)r�r�r��IOError)�req_pathrr��rr#r$�parse_requires_path�sz>EggInfoDistribution._get_metadata.<locals>.parse_requires_pathrGzEGG-INFOzPKG-INFOr@)rrCzrequires.txtr�zEGG-INFO/PKG-INFO�utf8rAzEGG-INFO/requires.txtzEGG-INFO/top_level.txtr�rFz,path must end with .egg-info or .egg, got %rr�)rLr�rr�rOr	�	zipimport�zipimporterr�get_datar�rrZadd_requirementsr�r�r�r�r�)r"r�requiresr	Ztl_pathZtl_datarq�	meta_pathrDrZzipfrBr�r�r#rr$r�wsX


�
�

z!EggInfoDistribution._get_metadatacCsd|j|j|jfS)Nz!<EggInfoDistribution %r %s at %r>r�r!r#r#r$r��s
�zEggInfoDistribution.__repr__cCsd|j|jfSr�r�r!r#r#r$r��szEggInfoDistribution.__str__cCs`g}tj�|jd�}tj�|�r\|��D]2\}}}||kr<q(tj�|�s(|�|dddf�q(|S)r��installed-files.txtr�TF)r�rrOr�r�r))r"r�r�rr`r#r#r$r��s	z)EggInfoDistribution.check_installed_filesc	Cs�dd�}dd�}tj�|jd�}g}tj�|�r�tj|ddd��x}|D]l}|��}tj�tj�|j|��}tj�|�s�t�	d	|�|�
d
�r�qFtj�|�sF|�|||�||�f�qFW5QRX|�|ddf�|S)z�
        Iterates over the ``installed-files.txt`` entries and returns a tuple
        ``(path, hash, size)`` for each line.

        :returns: a list of (path, hash, size)
        cSs0t|d�}z|��}W5|��Xt�|���S)Nr�)r��closer�r�r�Z	hexdigest)rr�Zcontentr#r#r$�_md5�s


z6EggInfoDistribution.list_installed_files.<locals>._md5cSst�|�jSr9)r��stat�st_size)rr#r#r$�_size�sz7EggInfoDistribution.list_installed_files.<locals>._sizerrYr�r�zNon-existent file: %sr�N)
r�rrOr�r�r�r�normpathrSr�rLr�r))r"rrr�rhr�r�rqr#r#r$r��s"
$z(EggInfoDistribution.list_installed_filesFc	cs�tj�|jd�}tj�|�r�d}tj|ddd��`}|D]T}|��}|dkrPd}q6|s6tj�tj�|j|��}|�|j�r6|r�|Vq6|Vq6W5QRXdS)	a
        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
        rTrYr�r�z./FN)	r�rrOr�r�r�rrr�)r"Zabsoluter��skipr�r�rqr#r#r$r�sz'EggInfoDistribution.list_distinfo_filescCst|t�o|j|jkSr9)r]rrr�r#r#r$r�.s

�zEggInfoDistribution.__eq__)N)F)r-r.r/r0r�r�r%r�r�r�r�r�r�r�r�r�r�r#r#r�r$rYsZ&
c@s^eZdZdZdd�Zdd�Zddd�Zd	d
�Zdd�Zddd�Z	ddd�Z
dd�Zdd�ZdS)�DependencyGrapha�
    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.
    cCsi|_i|_i|_dSr9)�adjacency_list�reverse_listr�r!r#r#r$r%IszDependencyGraph.__init__cCsg|j|<g|j|<dS)z�Add the *distribution* to the graph.

        :type distribution: :class:`distutils2.database.InstalledDistribution`
                            or :class:`distutils2.database.EggInfoDistribution`
        N)rr)r"�distributionr#r#r$�add_distributionNs
z DependencyGraph.add_distributionNcCs6|j|�||f�||j|kr2|j|�|�dS)a�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``
        N)rr)r)r"�x�y�labelr#r#r$�add_edgeXs
zDependencyGraph.add_edgecCs&t�d||�|j�|g��|�dS)a
        Add a missing *requirement* for the given *distribution*.

        :type distribution: :class:`distutils2.database.InstalledDistribution`
                            or :class:`distutils2.database.EggInfoDistribution`
        :type requirement: ``str``
        z
%s missing %rN)rSrTr�r'r))r"rr�r#r#r$�add_missinggszDependencyGraph.add_missingcCsd|j|jfSr�r�r*r#r#r$�
_repr_distrszDependencyGraph._repr_distrcCs�|�|�g}|j|D]h\}}|�|�}|dk	r<d||f}|�d|t|��|�||d�}|�d�}|�|dd��qd�|�S)zPrints only a subgraphNz%s [%s]z    rr�)r"rr)r��	repr_noder��extendrO)r"r+�level�outputr�rZ	suboutputZsubsr#r#r$r#us

zDependencyGraph.repr_nodeTcCs�g}|�d�|j��D]h\}}t|�dkr:|s:|�|�|D]@\}}|dk	rh|�d|j|j|f�q>|�d|j|jf�q>q|s�t|�dkr�|�d�|�d�|�d�|D]}|�d	|j�|�d
�q�|�d�|�d�dS)a9Writes 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``
        zdigraph dependencies {
rNz"%s" -> "%s" [label="%s"]
z
"%s" -> "%s"
zsubgraph disconnected {
zlabel = "Disconnected"
zbgcolor = red
z"%s"r�z}
)r�r�itemsr�r)r)r"r�Zskip_disconnectedZdisconnectedr+�adjsr�rr#r#r$�to_dot�s(	

�



zDependencyGraph.to_dotcs�g}i}|j��D]\}}|dd�||<qg�t|���dd�D]\}}|sD��|�||=qD�shq�|��D]\}}�fdd�|D�||<qpt�ddd��D��|���q,|t|���fS)aa
        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.
        Ncs g|]\}}|�kr||f�qSr#r#)r�r{rY�Z	to_remover#r$r��sz4DependencyGraph.topological_sort.<locals>.<listcomp>zMoving to result: %scSsg|]}d|j|jf�qS)rjr�)r�r{r#r#r$r��s)rr'�listr)rSrTr$�keys)r"rhZalist�kr|r#r*r$�topological_sort�s$
�z DependencyGraph.topological_sortcCs2g}|j��D]\}}|�|�|��qd�|�S)zRepresentation of the graphr�)rr'r)r#rO)r"r&r+r(r#r#r$r��szDependencyGraph.__repr__)N)r)T)
r-r.r/r0r%rr r!r"r#r)r.r�r#r#r#r$r9s



 rr1cCsVt|�}t�}i}|D]L}|�|�|jD]6}t|�\}}t�d|||�|�|g��||f�q*q|D]�}|j	|j
B|jB|jB}|D]�}	z|�
|	�}
Wn6tk
r�t�d|	�|	��d}|�
|�}
YnX|
j}d}||k�r>||D]N\}}z|
�|�}
Wntk
�rd}
YnX|
r�|�|||	�d}�q>q�|s�|�||	�q�qh|S)a6Makes 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
    zAdd to provided: %s, %s, %sr�rFT)rrrrkrrSrTr'r)r�r�r�r�rlrr�r�r(ror r!)�distsrC�graphrpr+rqrrcrr�rlZmatchedZproviderror#r#r$�
make_graph�sN


���

r1cCsv||krtd|j��t|�}|g}|j|}|rh|��}|�|�|j|D]}||krN|�|�qNq.|�d�|S)z�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
    �1given distribution %r is not a member of the listr)rrr1r�popr))r/r+r0Zdep�todor{Zsuccr#r#r$�get_dependent_dists�s�


r5cCsn||krtd|j��t|�}g}|j|}|rj|��d}|�|�|j|D]}||krP|�|�qPq,|S)z�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
    r2r)rrr1rr3r))r/r+r0r�r4r{Zpredr#r#r$�get_required_distss�

r6cKs4|�dd�}tf|�}||_||_|p(d|_t|�S)zO
    A convenience method for making a dist given just a name and version.
    �summaryzPlaceholder for summary)r3r	rrcr7r)rrc�kwargsr7r�r#r#r$�	make_dist2s

r9)r1)7r0Z
__future__rr�r�rPr�Zloggingr�rNr2rr?rr�compatrrcrrrDr	r
rr�utilr
rrrrrr�__all__Z	getLoggerr-rSr�ZCOMMANDS_FILENAMEr�rMr�rrrrrrrUrVrr1r5r6r9r#r#r#r$�<module>s`$�
�s7J]
6site-packages/pip/_vendor/distlib/__pycache__/compat.cpython-38.opt-1.pyc000064400000076604151446177000022246 0ustar00U

��.e���@sBddlmZddlZddlZddlZzddlZWnek
rHdZYnXejddk�r~ddlmZe	fZ
eZddl
mZddlZddlZddlmZddlmZmZmZmZmZdd	lmZmZmZm Z m!Z!m"Z"m#Z#d
d�Zddl$Z$ddl$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-e�r&dd
l$m.Z.ddl/Z/ddl0Z0ddl1Z2ddl3m3Z3ddl4Z4e5Z5ddl6m7Z8ddl6m9Z:da;dd�Z<�nddl=mZe>fZ
e>Zddl=m?ZddlZddlZddlZddl@mZmZmZm<Z<mZmZmZmZm#Z#ddlAm&Z&mZm%Z%m Z m!Z!m)Z)m*Z*m+Z+m,Z,m-Z-e�r&dd
lAm.Z.ddlBm(Z(m'Z'm"Z"ddlCmDZ/ddlAmEZ$ddlFmDZ0ddl2Z2ddlGm3Z3ddlHmIZ4eJZ5ddl6m:Z:e8Z8zddlmKZKmLZLWn8ek
�r�Gdd�deM�ZLdddd�ZNdd�ZKYnXzddl
mOZPWn&ek
�rGd d!�d!eQ�ZPYnXzdd"lmRZRWn,ek
�rTejSejTBdfd#d$�ZRYnXdd%lUmVZWeXeWd&��rteWZVn,dd'lUmYZZGd(d)�d)eZ�ZYGd*d+�d+eW�ZVzdd,l[m\Z\Wnek
�r�d-d.�Z\YnXzddl]Z]Wn"ek
�r�dd/lm]Z]YnXze^Z^Wn*e_k
�r2dd0l`maZad1d2�Z^YnXzejbZbejcZcWnHedk
�r�e�e��pbd3Zfefd4k�rtd5Zgnd6Zgd7d8�Zbd9d:�ZcYnXzdd;lhmiZiWnHek
�r�dd<ljmkZkmlZlddlZe�md=�Znd>d?�Zod@dA�ZiYnXzddBlpmqZqWn"ek
�rddBlrmqZqYnXejddC�dDk�r:e3�jsZsnddElpmsZszddFl`mtZtWndek
�r�ddGl`muZuzddHlvmwZxWn ek
�r�dedJdK�ZxYnXGdLdM�dMeu�ZtYnXzddNlymzZzWnHek
�rzddNl{mzZzWn ek
�rdfdOdP�ZzYnXYnXzddQl`m|Z|Wn�ek
�r�zddRl}m~ZWn"ek
�rjddRl�m~ZYnXzddSl�m�Z�m�Z�m�Z�Wnek
�r�YnXGdTdU�dUe��Z|YnXzddVl�m�Z�m�Z�Wnvek
�r<e�mdWej��Z�dXdY�Z�GdZd[�d[e��Z�dgd\d]�Z�Gd^d_�d_e��Z�Gd`da�dae��Z�Gdbdc�dceQ�Z�YnXdS)h�)�absolute_importN�)�StringIO)�FileType�)�shutil)�urlparse�
urlunparse�urljoin�urlsplit�
urlunsplit)�urlretrieve�quote�unquote�url2pathname�pathname2url�ContentTooShortError�	splittypecCst|t�r|�d�}t|�S)N�utf-8)�
isinstance�unicode�encode�_quote)�s�r�>/usr/lib/python3.8/site-packages/pip/_vendor/distlib/compat.pyrs

r)	�Request�urlopen�URLError�	HTTPError�HTTPBasicAuthHandler�HTTPPasswordMgr�HTTPHandler�HTTPRedirectHandler�build_opener)�HTTPSHandler)�
HTMLParser)�ifilter)�ifilterfalsecCs<tdkrddl}|�d�at�|�}|r4|�dd�Sd|fS)zJsplituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.Nrz^(.*)@(.*)$r�)�	_userprog�re�compile�match�group)Zhostr+r-rrr�	splituser4s

r/)�
TextIOWrapper)	rr	r
r/rrrrr)
rr
rrrr r!r"r#r$)rrr)�filterfalse)�match_hostname�CertificateErrorc@seZdZdS)r3N)�__name__�
__module__�__qualname__rrrrr3^sr3c
Cs�g}|sdS|�d�}|d|dd�}}|�d�}||krNtdt|���|sb|��|��kS|dkrv|�d�n>|�d	�s�|�d	�r�|�t�|��n|�t�|��	d
d��|D]}|�t�|��q�t�
dd
�|�dtj�}	|	�
|�S)zpMatching according to RFC 6125, section 6.4.3

        http://tools.ietf.org/html/rfc6125#section-6.4.3
        F�.rrN�*z,too many wildcards in certificate DNS name: z[^.]+zxn--z\*z[^.]*z\Az\.z\Z)�split�countr3�repr�lower�append�
startswithr+�escape�replacer,�join�
IGNORECASEr-)
Zdn�hostnameZ
max_wildcardsZpats�partsZleftmostZ	remainderZ	wildcards�fragZpatrrr�_dnsname_matchbs*


�rFcCs�|std��g}|�dd�}|D]*\}}|dkr t||�r@dS|�|�q |s�|�dd�D]6}|D],\}}|dkrdt||�r�dS|�|�qdq\t|�dkr�td	|d
�tt|��f��n*t|�dkr�td||df��ntd
��dS)a=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.
        ztempty or no certificate, match_hostname needs a SSL socket or SSL context with either CERT_OPTIONAL or CERT_REQUIREDZsubjectAltNamerZDNSNZsubjectZ
commonNamerz&hostname %r doesn't match either of %s�, zhostname %r doesn't match %rrz=no appropriate commonName or subjectAltName fields were found)	�
ValueError�getrFr=�lenr3rA�mapr;)ZcertrCZdnsnamesZsan�key�value�subrrrr2�s2

�
�r2)�SimpleNamespacec@seZdZdZdd�ZdS)�	ContainerzR
        A generic container for when multiple values need to be returned
        cKs|j�|�dS�N��__dict__�update)�self�kwargsrrr�__init__�szContainer.__init__N)r4r5r6�__doc__rWrrrrrP�srP)�whichcs"dd�}tj���r&|�|�r"�SdS|dkr>tj�dtj�}|sFdS|�tj�}tj	dkr�tj
|krt|�dtj
�tj�dd��tj�}t�fd	d
�|D��r��g}q‡fdd�|D�}n�g}t
�}|D]P}tj�|�}||kr�|�|�|D](}	tj�||	�}
||
|�r�|
Sq�q�dS)
aKGiven 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.

        cSs&tj�|�o$t�||�o$tj�|�SrQ)�os�path�exists�access�isdir)�fn�moderrr�
_access_check�s�zwhich.<locals>._access_checkN�PATHZwin32rZPATHEXT�c3s |]}����|���VqdSrQ)r<�endswith��.0�ext��cmdrr�	<genexpr>�szwhich.<locals>.<genexpr>csg|]}�|�qSrrrerhrr�
<listcomp>�szwhich.<locals>.<listcomp>)rZr[�dirname�environrI�defpathr9�pathsep�sys�platform�curdir�insert�any�set�normcase�addrA)rir`r[raZpathext�files�seen�dirZnormdirZthefile�namerrhrrY�s8





rY)�ZipFile�	__enter__)�
ZipExtFilec@s$eZdZdd�Zdd�Zdd�ZdS)r~cCs|j�|j�dSrQrR)rU�baserrrrWszZipExtFile.__init__cCs|SrQr�rUrrrr}szZipExtFile.__enter__cGs|��dSrQ��close�rU�exc_inforrr�__exit__szZipExtFile.__exit__N)r4r5r6rWr}r�rrrrr~sr~c@s$eZdZdd�Zdd�Zdd�ZdS)r|cCs|SrQrr�rrrr}"szZipFile.__enter__cGs|��dSrQr�r�rrrr�%szZipFile.__exit__cOstj|f|�|�}t|�SrQ)�BaseZipFile�openr~)rU�argsrVrrrrr�)szZipFile.openN)r4r5r6r}r�r�rrrrr|!sr|)�python_implementationcCs0dtjkrdStjdkrdStj�d�r,dSdS)z6Return a string identifying the Python implementation.ZPyPy�javaZJythonZ
IronPythonZCPython)rp�versionrZr{r>rrrrr�0s

r�)�	sysconfig)�CallablecCs
t|t�SrQ)rr�)�objrrr�callableDsr�r�mbcs�strict�surrogateescapecCs:t|t�r|St|t�r$|�tt�Stdt|�j��dS�Nzexpect bytes or str, not %s)	r�bytes�	text_typer�_fsencoding�	_fserrors�	TypeError�typer4��filenamerrr�fsencodeXs

�r�cCs:t|t�r|St|t�r$|�tt�Stdt|�j��dSr�)	rr�r��decoder�r�r�r�r4r�rrr�fsdecodeas

�r�)�detect_encoding)�BOM_UTF8�lookupzcoding[:=]\s*([-\w.]+)cCsH|dd����dd�}|dks*|�d�r.dS|dks@|�d�rDd	S|S)
z(Imitates get_normal_name in tokenizer.c.N��_�-rzutf-8-)zlatin-1�
iso-8859-1ziso-latin-1)zlatin-1-ziso-8859-1-ziso-latin-1-r�)r<r@r>)�orig_enc�encrrr�_get_normal_namers�r�cs�z�jj�Wntk
r$d�YnXd�d}d}�fdd�}��fdd�}|�}|�t�rpd�|d	d�}d
}|s||gfS||�}|r�||gfS|�}|s�||gfS||�}|r�|||gfS|||gfS)a?
        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.
        NFrcs$z��WStk
rYdSXdS)N�)�
StopIterationr)�readlinerr�read_or_stop�sz%detect_encoding.<locals>.read_or_stopcs�z|�d�}Wn4tk
rBd}�dk	r6d�|��}t|��YnXt�|�}|sVdSt|d�}zt|�}Wn:tk
r��dkr�d|}nd��|�}t|��YnX�r�|j	dkr؈dkr�d}n
d���}t|��|d	7}|S)
Nrz'invalid or missing encoding declarationz{} for {!r}rzunknown encoding: zunknown encoding for {!r}: {}zencoding problem: utf-8z encoding problem for {!r}: utf-8z-sig)
r��UnicodeDecodeError�format�SyntaxError�	cookie_re�findallr�r��LookupErrorr{)�line�line_string�msgZmatches�encoding�codec)�	bom_foundr�rr�find_cookie�s8

�

z$detect_encoding.<locals>.find_cookieTrz	utf-8-sig)�__self__r{�AttributeErrorr>r�)r�r��defaultr�r��first�secondr)r�r�r�rr�}s4
&


r�)r?r))r�)�unescape)�ChainMap)�MutableMapping)�recursive_repr�...cs�fdd�}|S)zm
            Decorator to make a repr function return fillvalue for a recursive
            call
            csLt�����fdd�}t�d�|_t�d�|_t�d�|_t�di�|_|S)Nc	sBt|�t�f}|�kr�S��|�z�|�}W5��|�X|SrQ)�id�	get_identrw�discard)rUrL�result)�	fillvalue�repr_running�
user_functionrr�wrapper�s
z=_recursive_repr.<locals>.decorating_function.<locals>.wrapperr5rXr4�__annotations__)ru�getattrr5rXr4r�)r�r��r�)r�r�r�decorating_function�sz,_recursive_repr.<locals>.decorating_functionr)r�r�rr�r�_recursive_repr�sr�c@s�eZdZdZdd�Zdd�Zdd�Zd'd	d
�Zdd�Zd
d�Z	dd�Z
dd�Ze�dd��Z
edd��Zdd�ZeZdd�Zedd��Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�ZdS)(r�a� 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.

        cGst|�pig|_dS)z�Initialize a ChainMap by setting *maps* to the given mappings.
            If no mappings are provided, a single empty dictionary is used.

            N)�list�maps)rUr�rrrrWszChainMap.__init__cCst|��dSrQ)�KeyError�rUrLrrr�__missing__szChainMap.__missing__c	Cs:|jD](}z||WStk
r,YqXq|�|�SrQ)r�r�r�)rUrL�mappingrrr�__getitem__s
zChainMap.__getitem__NcCs||kr||S|SrQr�rUrLr�rrrrI%szChainMap.getcCstt�j|j��SrQ)rJru�unionr�r�rrr�__len__(szChainMap.__len__cCstt�j|j��SrQ)�iterrur�r�r�rrr�__iter__+szChainMap.__iter__cst�fdd�|jD��S)Nc3s|]}�|kVqdSrQr)rf�m�rLrrrj/sz(ChainMap.__contains__.<locals>.<genexpr>�rtr�r�rr�r�__contains__.szChainMap.__contains__cCs
t|j�SrQr�r�rrr�__bool__1szChainMap.__bool__cCsd�|d�tt|j���S)Nz{0.__class__.__name__}({1})rG)r�rArKr;r�r�rrr�__repr__4s�zChainMap.__repr__cGs|tj|f|���S)z?Create a ChainMap with a single dict created from the iterable.)�dict�fromkeys)�cls�iterabler�rrrr�9szChainMap.fromkeyscCs$|j|jd��f|jdd���S)zHNew ChainMap or subclass with a new copy of maps[0] and refs to maps[1:]rrN)�	__class__r��copyr�rrrr�>sz
ChainMap.copycCs|jif|j��S)z;New ChainMap with a new dict followed by all previous maps.�r�r�r�rrr�	new_childDszChainMap.new_childcCs|j|jdd��S)zNew ChainMap from maps[1:].rNr�r�rrr�parentsHszChainMap.parentscCs||jd|<dS)Nr)r�)rUrLrMrrr�__setitem__MszChainMap.__setitem__cCs8z|jd|=Wn"tk
r2td�|���YnXdS)Nr�(Key not found in the first mapping: {!r})r�r�r�r�rrr�__delitem__PszChainMap.__delitem__cCs2z|jd��WStk
r,td��YnXdS)zPRemove and return an item pair from maps[0]. Raise KeyError is maps[0] is empty.rz#No keys found in the first mapping.N)r��popitemr�r�rrrr�VszChainMap.popitemcGs@z|jdj|f|��WStk
r:td�|���YnXdS)zWRemove *key* from maps[0] and return its value. Raise KeyError if *key* not in maps[0].rr�N)r��popr�r�)rUrLr�rrrr�]szChainMap.popcCs|jd��dS)z'Clear maps[0], leaving maps[1:] intact.rN)r��clearr�rrrr�dszChainMap.clear)N)r4r5r6rXrWr�r�rIr�r�r�r�r�r��classmethodr�r��__copy__r��propertyr�r�r�r�r�r�rrrrr�s.



r�)�cache_from_sourcecCs"|dkrd}|rd}nd}||S)NF�c�or)r[�debug_override�suffixrrrr�nsr�)�OrderedDict)r�)�KeysView�
ValuesView�	ItemsViewc@s�eZdZdZdd�Zejfdd�Zejfdd�Zdd	�Zd
d�Z	dd
�Z
d6dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZeZe�Zefdd �Zd7d"d#�Zd8d$d%�Zd&d'�Zd(d)�Zed9d*d+��Zd,d-�Zd.d/�Zd0d1�Zd2d3�Z d4d5�Z!d!S):r�z)Dictionary that remembers insertion ordercOsnt|�dkrtdt|���z
|jWn6tk
r\g|_}||dg|dd�<i|_YnX|j||�dS)z�Initialize an ordered dictionary.  Signature is the same as for
            regular dictionaries, but keyword arguments are not recommended
            because their insertion order is arbitrary.

            rz$expected at most 1 arguments, got %dN)rJr��_OrderedDict__rootr��_OrderedDict__map�_OrderedDict__update)rUr��kwds�rootrrrrW�s

zOrderedDict.__init__cCsF||kr6|j}|d}|||g|d<|d<|j|<||||�dS)z!od.__setitem__(i, y) <==> od[i]=yrrN)r�r)rUrLrMZdict_setitemr�lastrrrr��s
 zOrderedDict.__setitem__cCs0|||�|j�|�\}}}||d<||d<dS)z od.__delitem__(y) <==> del od[y]rrN)rr�)rUrLZdict_delitem�	link_prev�	link_nextrrrr��s
zOrderedDict.__delitem__ccs.|j}|d}||k	r*|dV|d}qdS)zod.__iter__() <==> iter(od)rr)N�r��rUrZcurrrrrr��s

zOrderedDict.__iter__ccs.|j}|d}||k	r*|dV|d}qdS)z#od.__reversed__() <==> reversed(od)rr)Nrrrrr�__reversed__�s

zOrderedDict.__reversed__cCsdz@|j��D]}|dd�=q|j}||dg|dd�<|j��Wntk
rTYnXt�|�dS)z.od.clear() -> None.  Remove all items from od.N)r�
itervaluesr�r�r�r�)rUZnoderrrrr��szOrderedDict.clearTcCs||std��|j}|r8|d}|d}||d<||d<n |d}|d}||d<||d<|d}|j|=t�||�}||fS)z�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.

            zdictionary is emptyrrr))r�r�rr�r�)rUrr�linkrrrLrMrrrr��s 
zOrderedDict.popitemcCst|�S)zod.keys() -> list of keys in od)r�r�rrr�keys�szOrderedDict.keyscs�fdd��D�S)z#od.values() -> list of values in odcsg|]}�|�qSrr�rfrLr�rrrk�sz&OrderedDict.values.<locals>.<listcomp>rr�rr�r�values�szOrderedDict.valuescs�fdd��D�S)z.od.items() -> list of (key, value) pairs in odcsg|]}|�|f�qSrrr
r�rrrk�sz%OrderedDict.items.<locals>.<listcomp>rr�rr�r�items�szOrderedDict.itemscCst|�S)z0od.iterkeys() -> an iterator over the keys in od)r�r�rrr�iterkeys�szOrderedDict.iterkeysccs|D]}||VqdS)z2od.itervalues -> an iterator over the values in odNr�rU�krrrr
�szOrderedDict.itervaluesccs|D]}|||fVqdS)z=od.iteritems -> an iterator over the (key, value) items in odNrrrrr�	iteritemsszOrderedDict.iteritemscOs�t|�dkr tdt|�f��n|s,td��|d}d}t|�dkrL|d}t|t�rn|D]}||||<qZn<t|d�r�|��D]}||||<q�n|D]\}}|||<q�|��D]\}}|||<q�dS)	a�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

            r)z8update() takes at most 2 positional arguments (%d given)z,update() takes at least 1 argument (0 given)rrrrN)rJr�rr��hasattrrr)r�rrU�otherrLrMrrrrTs(	�


zOrderedDict.updatecCs0||kr||}||=|S||jkr,t|��|S)z�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.

            )�_OrderedDict__markerr�)rUrLr�r�rrrr�*s
zOrderedDict.popNcCs||kr||S|||<|S)zDod.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in odrr�rrr�
setdefault7szOrderedDict.setdefaultcCsf|si}t|�t�f}||kr"dSd||<z.|sBd|jjfW�Sd|jj|��fW�S||=XdS)zod.__repr__() <==> repr(od)r�rz%s()z%s(%r)N)r��
_get_identr�r4r)rUZ
_repr_runningZcall_keyrrrr�>szOrderedDict.__repr__csX�fdd��D�}t����}tt��D]}|�|d�q(|rL�j|f|fS�j|ffS)z%Return state information for picklingcsg|]}|�|g�qSrr�rfrr�rrrkNsz*OrderedDict.__reduce__.<locals>.<listcomp>N)�varsr�r�r�r�)rUrZ	inst_dictrrr�r�
__reduce__LszOrderedDict.__reduce__cCs
|�|�S)z!od.copy() -> a shallow copy of od)r�r�rrrr�VszOrderedDict.copycCs|�}|D]}|||<q
|S)z�OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S
            and values equal to v (which defaults to None).

            r)r�r�rM�drLrrrr�Zs
zOrderedDict.fromkeyscCs6t|t�r*t|�t|�ko(|��|��kSt�||�S)z�od.__eq__(y) <==> od==y.  Comparison to another OD is order-sensitive
            while comparison to a regular mapping is order-insensitive.

            )rr�rJrr��__eq__�rUrrrrres
 zOrderedDict.__eq__cCs
||kSrQrrrrr�__ne__nszOrderedDict.__ne__cCst|�S)z@od.viewkeys() -> a set-like object providing a view on od's keys)r�r�rrr�viewkeyssszOrderedDict.viewkeyscCst|�S)z<od.viewvalues() -> an object providing a view on od's values)r�r�rrr�
viewvalueswszOrderedDict.viewvaluescCst|�S)zBod.viewitems() -> a set-like object providing a view on od's items)r�r�rrr�	viewitems{szOrderedDict.viewitems)T)N)N)N)"r4r5r6rXrWr�r�r�r�r	r�r�rrrrr
rrTr�objectrr�rr�rr�r�r�rrr r!r"rrrrr��s:
	




	r�)�BaseConfigurator�valid_identz^[a-z_][a-z0-9_]*$cCst�|�}|std|��dS)Nz!Not a valid Python identifier: %rT)�
IDENTIFIERr-rH)rr�rrrr%�s
r%c@s"eZdZdZdd�Zddd�ZdS)�ConvertingDictz A converting dictionary wrapper.cCsJt�||�}|j�|�}||k	rF|||<t|�tttfkrF||_||_	|SrQ)
r�r��configurator�convertr�r'�ConvertingList�ConvertingTuple�parentrL�rUrLrMr�rrrr��s
�zConvertingDict.__getitem__NcCsLt�|||�}|j�|�}||k	rH|||<t|�tttfkrH||_||_	|SrQ)
r�rIr(r)r�r'r*r+r,rL�rUrLr�rMr�rrrrI�s
�zConvertingDict.get)N)r4r5r6rXr�rIrrrrr'�sr'cCsDt�|||�}|j�|�}||k	r@t|�tttfkr@||_||_	|SrQ)
r�r�r(r)r�r'r*r+r,rLr.rrrr��s
�r�c@s"eZdZdZdd�Zddd�ZdS)	r*zA converting list wrapper.cCsJt�||�}|j�|�}||k	rF|||<t|�tttfkrF||_||_	|SrQ)
r�r�r(r)r�r'r*r+r,rLr-rrrr��s
�zConvertingList.__getitem__���cCs<t�||�}|j�|�}||k	r8t|�tttfkr8||_|SrQ)	r�r�r(r)r�r'r*r+r,)rU�idxrMr�rrrr��s
�zConvertingList.popN)r/)r4r5r6rXr�r�rrrrr*�sr*c@seZdZdZdd�ZdS)r+zA converting tuple wrapper.cCsBt�||�}|j�|�}||k	r>t|�tttfkr>||_||_	|SrQ)
�tupler�r(r)r�r'r*r+r,rLr-rrrr��s
�zConvertingTuple.__getitem__N)r4r5r6rXr�rrrrr+�sr+c@s�eZdZdZe�d�Ze�d�Ze�d�Ze�d�Z	e�d�Z
ddd	�Zee
�Zd
d�Zdd
�Zdd�Zdd�Zdd�Zdd�Zdd�ZdS)r$zQ
        The configurator base class which defines some useful defaults.
        z%^(?P<prefix>[a-z]+)://(?P<suffix>.*)$z^\s*(\w+)\s*z^\.\s*(\w+)\s*z^\[\s*(\w+)\s*\]\s*z^\d+$�ext_convert�cfg_convert)rgZcfgcCst|�|_||j_dSrQ)r'�configr()rUr4rrrrW�s
zBaseConfigurator.__init__c		Cs�|�d�}|�d�}z^|�|�}|D]H}|d|7}zt||�}Wq$tk
rj|�|�t||�}Yq$Xq$|WStk
r�t��dd�\}}td||f�}|||_	|_
|�YnXdS)zl
            Resolve strings to objects using standard import and attribute
            syntax.
            r7rrNzCannot resolve %r: %s)r9r��importerr�r��ImportErrorrpr�rH�	__cause__�
__traceback__)	rUrr{Zused�foundrE�e�tb�vrrr�resolve�s"



zBaseConfigurator.resolvecCs
|�|�S)z*Default converter for the ext:// protocol.)r=�rUrMrrrr2szBaseConfigurator.ext_convertcCs�|}|j�|�}|dkr&td|��n�||��d�}|j|��d}|r�|j�|�}|rn||��d}nd|j�|�}|r�|��d}|j�|�s�||}n2zt	|�}||}Wnt
k
r�||}YnX|r�||��d�}qHtd||f��qH|S)z*Default converter for the cfg:// protocol.NzUnable to convert %rrzUnable to convert %r at %r)�WORD_PATTERNr-rH�endr4�groups�DOT_PATTERN�
INDEX_PATTERN�
DIGIT_PATTERN�intr�)rUrM�restr�rr0�nrrrr3s4
�zBaseConfigurator.cfg_convertcCs�t|t�s$t|t�r$t|�}||_n�t|t�sHt|t�rHt|�}||_nzt|t�slt|t�rlt|�}||_nVt|t�r�|j	�
|�}|r�|��}|d}|j�
|d�}|r�|d}t||�}||�}|S)z�
            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.
            �prefixNr�)rr'r�r(r*r�r+r1�string_types�CONVERT_PATTERNr-�	groupdict�value_convertersrIr�)rUrMr�rrHZ	converterr�rrrr)2s,
�

zBaseConfigurator.convertcsn��d�}t|�s|�|�}��dd�}t�fdd��D��}|f|�}|rj|��D]\}}t|||�qT|S)z1Configure an object with a user-supplied factory.z()r7Ncs g|]}t|�r|�|f�qSr)r%r�r4rrrkUsz5BaseConfigurator.configure_custom.<locals>.<listcomp>)r�r�r=r�r�setattr)rUr4r�ZpropsrVr�r{rMrrMr�configure_customNs


z!BaseConfigurator.configure_customcCst|t�rt|�}|S)z0Utility function which converts lists to tuples.)rr�r1r>rrr�as_tuple\s
zBaseConfigurator.as_tupleN)r4r5r6rXr+r,rJr?rBrCrDrL�staticmethod�
__import__r5rWr=r2r3r)rOrPrrrrr$�s"




�"r$)r)r�)N)N)�Z
__future__rrZr+rpZsslr6�version_inforZ
basestringrIrr��typesrZ	file_typeZ__builtin__�builtinsZConfigParserZconfigparserZ	_backportrrr	r
rrZurllibr
rrrrrrrZurllib2rrrrr r!r"r#r$r%ZhttplibZ	xmlrpclibZQueueZqueuer&ZhtmlentitydefsZ	raw_input�	itertoolsr'�filterr(r1r*r/�io�strr0Zurllib.parseZurllib.requestZurllib.errorZhttp.clientZclientZrequestZ
xmlrpc.clientZhtml.parserZ
html.entitiesZentities�inputr2r3rHrFrOrPr#rY�F_OK�X_OKZzipfiler|r�rr~ZBaseZipExtFilerqr�r�r��	NameError�collectionsr�r�r�r��getfilesystemencodingr�r��tokenizer��codecsr�r�r,r�r�Zhtmlr?Zcgir�r�r��reprlibr�r��importlib.utilr�Zimpr��threadr�rZdummy_threadZ_abcollr�r�r�r�Zlogging.configr$r%�Ir&r'r�r�r*r1r+rrrr�<module>s,
$,,0
2+A


		
[
b
w

site-packages/pip/_vendor/distlib/__pycache__/version.cpython-38.opt-1.pyc000064400000047451151446177000022446 0ustar00U

��.e_[�@sfdZddlZddlZddlmZddlmZdddd	d
ddd
gZe�e	�Z
Gdd�de�ZGdd�de
�ZGdd�de
�Ze�d�Zdd�ZeZGdd�de�Zdd�ZGdd�de�Ze�d�dfe�d�dfe�d�dfe�d�d fe�d!�d"fe�d#�d"fe�d$�d%fe�d&�d'fe�d(�d)fe�d*�d+ff
Ze�d,�dfe�d-�dfe�d.�d%fe�d$�d%fe�d/�dffZe�d0�Zd1d2�Zd3d4�Ze�d5ej�Zd6d6d7d6d8ddd9�Zd:d;�ZGd<d�de�Z Gd=d	�d	e�Z!e�d>ej�Z"d?d@�Z#dAdB�Z$GdCd
�d
e�Z%GdDd�de�Z&GdEdF�dFe
�Z'e'eee�e'ee!dGdH��e'e$e&e�dI�Z(e(dJe(dK<dLd
�Z)dS)Mz~
Implementation of a flexible versioning scheme providing support for PEP-440,
setuptools-compatible and semantic versioning.
�N�)�string_types��parse_requirement�NormalizedVersion�NormalizedMatcher�
LegacyVersion�
LegacyMatcher�SemanticVersion�SemanticMatcher�UnsupportedVersionError�
get_schemec@seZdZdZdS)rzThis is an unsupported version.N)�__name__�
__module__�__qualname__�__doc__�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/distlib/version.pyrsc@sxeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zedd��ZdS)�VersioncCs"|��|_}|�|�|_}dS�N)�strip�_string�parse�_parts)�self�s�partsrrr�__init__szVersion.__init__cCstd��dS)Nzplease implement in a subclass��NotImplementedError�rrrrrr%sz
Version.parsecCs$t|�t|�kr td||f��dS)Nzcannot compare %r and %r)�type�	TypeError�r�otherrrr�_check_compatible(szVersion._check_compatiblecCs|�|�|j|jkSr�r%rr#rrr�__eq__,s
zVersion.__eq__cCs|�|�Sr�r'r#rrr�__ne__0szVersion.__ne__cCs|�|�|j|jkSrr&r#rrr�__lt__3s
zVersion.__lt__cCs|�|�p|�|�Sr�r*r'r#rrr�__gt__7szVersion.__gt__cCs|�|�p|�|�Srr+r#rrr�__le__:szVersion.__le__cCs|�|�p|�|�Sr)r,r'r#rrr�__ge__=szVersion.__ge__cCs
t|j�Sr)�hashr�rrrr�__hash__AszVersion.__hash__cCsd|jj|jfS)Nz%s('%s')��	__class__rrr0rrr�__repr__DszVersion.__repr__cCs|jSr�rr0rrr�__str__GszVersion.__str__cCstd��dS)NzPlease implement in subclasses.rr0rrr�
is_prereleaseJszVersion.is_prereleaseN)rrrrrr%r'r)r*r,r-r.r1r4r6�propertyr7rrrrrsrc	@s�eZdZdZdd�dd�dd�dd�dd�dd�d	d�d
d�d�Zdd
�Zdd�Zdd�Zedd��Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�ZdS) �MatcherNcCs||kSrr��v�c�prrr�<lambda>T�zMatcher.<lambda>cCs||kSrrr:rrrr>Ur?cCs||kp||kSrrr:rrrr>Vr?cCs||kp||kSrrr:rrrr>Wr?cCs||kSrrr:rrrr>Xr?cCs||kSrrr:rrrr>Yr?cCs||kp||kSrrr:rrrr>[r?cCs||kSrrr:rrrr>\r?)�<�>�<=�>=�==�===�~=�!=cCst|�Srrr rrrraszMatcher.parse_requirementcCs�|jdkrtd��|��|_}|�|�}|s:td|��|j|_|j��|_g}|jr�|jD]d\}}|�	d�r�|dkr�td|��|dd�d}}|�|�n|�|�d}}|�
|||f�q^t|�|_dS)	NzPlease specify a version classz
Not valid: %rz.*)rDrGz#'.*' not allowed for %r constraints���TF)
�
version_class�
ValueErrorrrr�name�lower�keyZconstraints�endswith�append�tupler)rr�rZclist�opZvn�prefixrrrrds*


�zMatcher.__init__cCsxt|t�r|�|�}|jD]X\}}}|j�|�}t|t�rDt||�}|s`d||jjf}t	|��||||�sdSqdS)z�
        Check if the provided version matches the constraints.

        :param version: The version to match against this instance.
        :type version: String or :class:`Version` instance.
        z%r not implemented for %sFT)
�
isinstancerrIr�
_operators�get�getattrr3rr)r�version�operator�
constraintrS�f�msgrrr�match�s




�z
Matcher.matchcCs6d}t|j�dkr2|jdddkr2|jdd}|S)Nrr)rDrE)�lenr)r�resultrrr�
exact_version�s zMatcher.exact_versioncCs0t|�t|�ks|j|jkr,td||f��dS)Nzcannot compare %s and %s)r!rKr"r#rrrr%�szMatcher._check_compatiblecCs"|�|�|j|jko |j|jkSr)r%rMrr#rrrr'�s
zMatcher.__eq__cCs|�|�Srr(r#rrrr)�szMatcher.__ne__cCst|j�t|j�Sr)r/rMrr0rrrr1�szMatcher.__hash__cCsd|jj|jfS)Nz%s(%r)r2r0rrrr4�szMatcher.__repr__cCs|jSrr5r0rrrr6�szMatcher.__str__)rrrrIrUrrr]r8r`r%r'r)r1r4r6rrrrr9Os*�
r9zk^v?(\d+!)?(\d+(\.\d+)*)((a|b|c|rc)(\d+))?(\.(post)(\d+))?(\.(dev)(\d+))?(\+([a-zA-Z\d]+(\.[a-zA-Z\d]+)?))?$cCs�|��}t�|�}|s"td|��|��}tdd�|d�d�D��}t|�dkrl|ddkrl|dd�}qF|dszd}nt|d�}|dd	�}|d
d�}|dd
�}|d}|dkr�d}n|dt|d�f}|dkr�d}n|dt|d�f}|dk�rd}n|dt|d�f}|dk�r*d}nHg}	|�d�D]0}
|
�	��rTdt|
�f}
nd|
f}
|	�
|
��q8t|	�}|�s�|�s�|�r�d}nd}|�s�d}|�s�d}||||||fS)NzNot a valid version: %scss|]}t|�VqdSr��int��.0r;rrr�	<genexpr>�sz_pep_440_key.<locals>.<genexpr>r�.���r����	�
��
)NNr)�arg)�z)�_)�final)r�PEP440_VERSION_REr]r�groupsrP�splitr^rb�isdigitrO)r�mrtZnumsZepoch�preZpost�devZlocalr�partrrr�_pep_440_key�sT



r{c@s6eZdZdZdd�Zedddddg�Zed	d
��ZdS)raIA rational version.

    Good:
        1.2         # equivalent to "1.2.0"
        1.2.0
        1.2a1
        1.2.3a2
        1.2.3b1
        1.2.3c1
        1.2.3.4
        TODO: fill this out

    Bad:
        1           # minimum two numbers
        1.2a        # release level must have a release serial
        1.2.3b
    cCs<t|�}t�|�}|��}tdd�|d�d�D��|_|S)Ncss|]}t|�VqdSrrarcrrrresz*NormalizedVersion.parse.<locals>.<genexpr>rrf)�_normalized_keyrsr]rtrPru�_release_clause)rrr_rwrtrrrr
s

zNormalizedVersion.parsero�br<�rcrycst�fdd��jD��S)Nc3s |]}|r|d�jkVqdS)rN)�PREREL_TAGS)rd�tr0rrresz2NormalizedVersion.is_prerelease.<locals>.<genexpr>)�anyrr0rr0rr7szNormalizedVersion.is_prereleaseN)	rrrrr�setr�r8r7rrrrr�s
cCs>t|�}t|�}||krdS|�|�s*dSt|�}||dkS)NTFrf)�str�
startswithr^)�x�y�nrrr�
_match_prefixs
r�c	@sneZdZeZddddddddd	�Zd
d�Zdd
�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�ZdS)r�_match_compatible�	_match_lt�	_match_gt�	_match_le�	_match_ge�	_match_eq�_match_arbitrary�	_match_ne)rFr@rArBrCrDrErGcCsV|rd|ko|jd}n|jdo,|jd}|rN|j�dd�d}|�|�}||fS)N�+rgrr)rrrurI)rrXrZrSZstrip_localrrrr�
_adjust_local6s
zNormalizedMatcher._adjust_localcCsD|�|||�\}}||krdS|j}d�dd�|D��}t||�S)NFrfcSsg|]}t|��qSr�r��rd�irrr�
<listcomp>Isz/NormalizedMatcher._match_lt.<locals>.<listcomp>�r�r}�joinr��rrXrZrSZrelease_clauseZpfxrrrr�DszNormalizedMatcher._match_ltcCsD|�|||�\}}||krdS|j}d�dd�|D��}t||�S)NFrfcSsg|]}t|��qSrr�r�rrrr�Qsz/NormalizedMatcher._match_gt.<locals>.<listcomp>r�r�rrrr�LszNormalizedMatcher._match_gtcCs|�|||�\}}||kSr�r��rrXrZrSrrrr�TszNormalizedMatcher._match_lecCs|�|||�\}}||kSrr�r�rrrr�XszNormalizedMatcher._match_gecCs.|�|||�\}}|s ||k}n
t||�}|Sr�r�r��rrXrZrSr_rrrr�\s


zNormalizedMatcher._match_eqcCst|�t|�kSrr�r�rrrr�dsz"NormalizedMatcher._match_arbitrarycCs0|�|||�\}}|s ||k}nt||�}|Srr�r�rrrr�gs

zNormalizedMatcher._match_necCsf|�|||�\}}||krdS||kr*dS|j}t|�dkrH|dd�}d�dd�|D��}t||�S)NTFrrgrfcSsg|]}t|��qSrr�r�rrrr�zsz7NormalizedMatcher._match_compatible.<locals>.<listcomp>)r�r}r^r�r�r�rrrr�osz#NormalizedMatcher._match_compatibleN)rrrrrIrUr�r�r�r�r�r�r�r�r�rrrrr's&�z[.+-]$�z^[.](\d)z0.\1z^[.-]z
^\((.*)\)$�\1z^v(ersion)?\s*(\d+)z\2z^r(ev)?\s*(\d+)z[.]{2,}rfz\b(alfa|apha)\b�alphaz\b(pre-alpha|prealpha)\bz	pre.alphaz	\(beta\)$�betaz
^[:~._+-]+z
[,*")([\]]z[~:+_ -]z\.$z
(\d+(\.\d+)*)cCsL|����}tD]\}}|�||�}q|s.d}t�|�}|sFd}|}n�|��d�d�}dd�|D�}t|�dkr~|�	d�qft|�dkr�||�
�d�}n8d�dd�|dd�D��||�
�d�}|dd�}d�d	d�|D��}|��}|�rtD]\}}|�||�}q�|�s|}nd
|k�r*dnd}|||}t
|��sHd}|S)
z�
    Try to suggest a semantic form for a version for which
    _suggest_normalized_version couldn't come up with anything.
    z0.0.0rrfcSsg|]}t|��qSrrar�rrrr��sz-_suggest_semantic_version.<locals>.<listcomp>�NcSsg|]}t|��qSrr�r�rrrr��scSsg|]}t|��qSrr�r�rrrr��sry�-r�)rrL�
_REPLACEMENTS�sub�_NUMERIC_PREFIXr]rtrur^rO�endr��_SUFFIX_REPLACEMENTS�	is_semver)rr_Zpat�replrwrS�suffix�seprrr�_suggest_semantic_version�s:
,
r�cCshzt|�|WStk
r"YnX|��}dD]\}}|�||�}q0t�dd|�}t�dd|�}t�dd|�}t�dd	|�}t�d
d|�}|�d�r�|d
d�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd|�}t�dd |�}zt|�Wntk
�rbd}YnX|S)!a�Suggest a normalized version close to the given version string.

    If you have a version string that isn't rational (i.e. NormalizedVersion
    doesn't like it) then you might be able to get an equivalent (or close)
    rational version from this function.

    This does a number of simple normalizations to the given string, based
    on observation of versions currently in use on PyPI. Given a dump of
    those version during PyCon 2009, 4287 of them:
    - 2312 (53.93%) match NormalizedVersion without change
      with the automatic suggestion
    - 3474 (81.04%) match when using this suggestion method

    @param s {str} An irrational version string.
    @returns A rational version string, or None, if couldn't determine one.
    ))z-alpharo)z-betar~)r�ro)r�r~)rr<)z-finalr�)z-prer<)z-releaser�)z.releaser�)z-stabler�)r�rf)rqrf)� r�)z.finalr�)rrr�zpre$Zpre0zdev$Zdev0z([abc]|rc)[\-\.](\d+)$z\1\2z[\-\.](dev)[\-\.]?r?(\d+)$z.\1\2z[.~]?([abc])\.?r�r;rNz\b0+(\d+)(?!\d)z(\d+[abc])$z\g<1>0z\.?(dev-r|dev\.r)\.?(\d+)$z.dev\2z-(a|b|c)(\d+)$z[\.\-](dev|devel)$z.dev0z(?![\.\-])dev$z(final|stable)$r�z\.?(r|-|-r)\.?(\d+)$z.post\2z\.?(dev|git|bzr)\.?(\d+)$z\.?(pre|preview|-c)(\d+)$zc\g<2>zp(\d+)$z.post\1)r|rrL�replace�rer�r�)rZrsZorigr�rrr�_suggest_normalized_version�s>
	
r�z([a-z]+|\d+|[\.-])r<zfinal-�@)rxZpreviewr�rryr�rfcCsrdd�}g}||�D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�S)NcSstg}t�|���D]R}t�||�}|rd|dd�krBdkrRnn|�d�}nd|}|�|�q|�d�|S)N�0r�9��*�*final)�
_VERSION_PARTrurL�_VERSION_REPLACErV�zfillrO)rr_r=rrr�	get_partsCs 
z_legacy_key.<locals>.get_partsr�r�rgz*final-Z00000000)r��poprOrP)rr�r_r=rrr�_legacy_keyBs



r�c@s eZdZdd�Zedd��ZdS)rcCst|�Sr)r�r rrrr]szLegacyVersion.parsecCs8d}|jD](}t|t�r
|�d�r
|dkr
d}q4q
|S)NFr�r�T)rrTrr�)rr_r�rrrr7`s
�zLegacyVersion.is_prereleaseN�rrrrr8r7rrrrr\sc@s4eZdZeZeej�Zded<e�	d�Z
dd�ZdS)r	r�rFz^(\d+(\.\d+)*)cCs`||krdS|j�t|��}|s2t�d||�dS|��d}d|krV|�dd�d}t||�S)NFzACannot compute compatible match for version %s  and constraint %sTrrfr)�
numeric_rer]r��loggerZwarningrt�rsplitr�)rrXrZrSrwrrrrr�ss�zLegacyMatcher._match_compatibleN)rrrrrI�dictr9rUr��compiler�r�rrrrr	ks


zN^(\d+)\.(\d+)\.(\d+)(-[a-z0-9]+(\.[a-z0-9-]+)*)?(\+[a-z0-9]+(\.[a-z0-9-]+)*)?$cCs
t�|�Sr)�
_SEMVER_REr])rrrrr��sr�c	Csndd�}t|�}|st|��|��}dd�|dd�D�\}}}||dd�||dd�}}|||f||fS)	NcSs8|dkr|f}n$|dd��d�}tdd�|D��}|S)NrrfcSs"g|]}|��r|�d�n|�qS)r�)rvr�)rdr=rrrr��sz5_semantic_key.<locals>.make_tuple.<locals>.<listcomp>)rurP)rZabsentr_rrrr�
make_tuple�s
z!_semantic_key.<locals>.make_tuplecSsg|]}t|��qSrrar�rrrr��sz!_semantic_key.<locals>.<listcomp>r��|�r�)r�rrt)	rr�rwrt�major�minorZpatchrxZbuildrrr�
_semantic_key�s
r�c@s eZdZdd�Zedd��ZdS)r
cCst|�Sr)r�r rrrr�szSemanticVersion.parsecCs|jdddkS)Nrrr�)rr0rrrr7�szSemanticVersion.is_prereleaseNr�rrrrr
�sc@seZdZeZdS)rN)rrrr
rIrrrrr�sc@s6eZdZddd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
�
VersionSchemeNcCs||_||_||_dSr)rM�matcher�	suggester)rrMr�r�rrrr�szVersionScheme.__init__cCs2z|j�|�d}Wntk
r,d}YnX|S�NTF)r�rIr�rrr_rrr�is_valid_version�s
zVersionScheme.is_valid_versioncCs0z|�|�d}Wntk
r*d}YnX|Sr�)r�rr�rrr�is_valid_matcher�s

zVersionScheme.is_valid_matchercCs|�d|�S)z:
        Used for processing some metadata fields
        zdummy_name (%s))r�r rrr�is_valid_constraint_list�sz&VersionScheme.is_valid_constraint_listcCs|jdkrd}n
|�|�}|Sr)r�r�rrr�suggest�s

zVersionScheme.suggest)N)rrrrr�r�r�r�rrrrr��s

r�cCs|Srrr rrrr>�r?r>)�
normalized�legacyZsemanticr��defaultcCs|tkrtd|��t|S)Nzunknown scheme name: %r)�_SCHEMESrJ)rKrrrr
�s)*rZloggingr��compatr�utilr�__all__Z	getLoggerrr�rJr�objectrr9r�rsr{r|rr�rr�r�r�r�r��Ir�r�r�rr	r�r�r�r
rr�r�r
rrrr�<module>s��
1d
=$W���
.r��	$���site-packages/pip/_vendor/distlib/__pycache__/util.cpython-38.opt-1.pyc000064400000135707151446177000021740 0ustar00U

��.e���@s�ddlZddlmZddlZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZzddlZWnek
r�dZYnXddlZddlZddlZddlZddlZzddlZWnek
r�ddlZYnXddlZddlmZddlmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0e
�1e2�Z3e
�4d�Z5e
�4d�Z6e
�4d	�Z7e
�4d
�Z8e
�4d�Z9e
�4d�Z:e
�4d
�Z;e
�4d�Z<dd�Z=dd�Z>dd�Z?dd�Z@dd�ZAd�dd�ZBdd�ZCdd�ZDdd �ZEejFd!d"��ZGejFd#d$��ZHejFd�d&d'��ZIGd(d)�d)eJ�ZKd*d+�ZLGd,d-�d-eJ�ZMd.d/�ZNGd0d1�d1eJ�ZOe
�4d2e
jP�ZQd3d4�ZRd�d5d6�ZSd7d8�ZTd9d:�ZUd;d<�ZVd=d>�ZWd?d@�ZXe
�4dAe
jY�ZZe
�4dB�Z[d�dCdD�Z\e
�4dE�Z]dFdG�Z^dHdI�Z_dJdK�Z`dLZadMdN�ZbdOdP�ZcGdQdR�dReJ�ZdGdSdT�dTeJ�ZeGdUdV�dVeJ�ZfdWZgd�dYdZ�Zhd[d\�Zid]ZjGd^d_�d_eJ�Zke
�4d`�Zle
�4da�Zme
�4db�Zndcdd�Zdedf�Zoe�r�ddglmpZqmrZrmsZsGdhdi�die$jt�ZtGdjdk�dkeq�ZpGdldm�dmepe'�Zuejvddn�Zwewdok�rGdpdq�dqe$jx�Zxe�rGdrds�dse$jy�ZyGdtdu�due%jz�Zze�rBGdvdw�dwe%j{�Z{Gdxdy�dye%j|�Z|dzd{�Z}Gd|d}�d}eJ�Z~Gd~d�de~�ZGd�d��d�e~�Z�Gd�d��d�e(�Z�Gd�d��d�eJ�Z�d�d��Z�dS)��N)�deque)�iglob�)�DistlibException)�string_types�	text_type�shutil�	raw_input�StringIO�cache_from_source�urlopen�urljoin�httplib�	xmlrpclib�	splittype�HTTPHandler�BaseConfigurator�valid_ident�	Container�configparser�URLError�ZipFile�fsdecode�unquote�urlparsez^([\w\.-]+)\s*z^([\w\.*+-]+)\s*z^(<=?|>=?|={2,3}|[~!]=)\s*z*^((<=?)|(>=?)|={2,3}|[~!]=|in|not\s+in)\s*z^or\b\s*z	^and\b\s*z(\S+)\s*z(([\s\w\.{}()*+#:;,/?!~`@$%^&=|<>\[\]-]+)cs6dd����fdd���fdd���fdd���|�S)	ae
    Parse a marker string and return a dictionary containing a marker expression.

    The dictionary will contain keys "op", "lhs" and "rhs" for non-terminals in
    the expression grammar, or strings. A string contained in quotes is to be
    interpreted as a literal string, and a string not contained in quotes is a
    variable (such as os_name).
    cSs.t�|�}|r,|��d}||��d�}n�|s:td��n�|d}|dkrVtd|��d�|d�}|dd�}|g}|r�|d|kr��qqt|d|kr�|�|�|dd�}qtt�|�}|s�td|��|�|��d�||��d�}qtd�|�}td|��|�|�d�|�}|dd��	�}||fS)	Nrzunexpected end of inputz'"zinvalid expression: %s�rzerror in string literal: %szunterminated string: %s)
�
IDENTIFIER�match�groups�end�SyntaxError�replace�append�STRING_CHUNK�join�lstrip)�	remaining�m�result�qZoq�parts�s�r,�</usr/lib/python3.8/site-packages/pip/_vendor/distlib/util.py�
marker_varAs:






z parse_marker.<locals>.marker_varcs�|rR|ddkrR�|dd����\}}|ddkr@td|��|dd���}nZ�|�\}}|r�t�|�}|srq�|��d}||��d�}�|�\}}|||d�}q^|}||fS)Nr�(r�)�unterminated parenthesis: %s��op�lhs�rhs)r%r �	MARKER_OPrrr)r&r(r4r'r3r5)�markerr.r,r-�marker_expres 
z!parse_marker.<locals>.marker_exprcsR�|�\}}|rJt�|�}|s qJ||��d�}�|�\}}d||d�}q||fS)N�andr2)�ANDrr�r&r4r'r5)r8r,r-�
marker_andxs
z parse_marker.<locals>.marker_andcsR�|�\}}|rJt�|�}|s qJ||��d�}�|�\}}d||d�}q||fS)N�orr2)�ORrrr;)r<r,r-r7�s
zparse_marker.<locals>.markerr,)Z
marker_stringr,)r7r<r8r.r-�parse_marker8s
	$r?cCs0|��}|r|�d�rdSt�|�}|s4td|��|��d}||��d�}d}}}}|�r:|ddk�r:|�dd�}|dkr�td|��|d|�}	||dd���}g}|	�r0t�|	�}|s�td	|	��|�	|��d�|	|��d�}	|	�s�q0|	dd
k�rtd|	��|	dd���}	q�|�s:d}|�r�|ddk�r�|dd���}t
�|�}|�sztd
|��|��d}t|�}
|
j�r�|
j
�s�td|��||��d���}n�dd�}|ddk�r�||�\}}n�|�dd�}|dk�rtd|��|d|�}	||dd���}t�|	��r@||	�\}}nXt�|	�}|�s\td|	��|��d}
|	|��d���}	|	�r�td|	��d|
fg}|�r�|ddk�r�td|��|dd���}t|�\}}|�r�|ddk�r�td|��|�s|}nd|d�dd�|D��f}t||||||d�S)z�
    Parse a requirement passed in as a string. Return a Container
    whose attributes contain the various parts of the requirement.
    �#Nzname expected: %sr�[�]rzunterminated extra: %szmalformed extra: %s�,zcomma expected in extras: %s�@zinvalid URI: %szInvalid URL: %scSs�t�|�}d}|r�g}|��d}||��d�}t�|�}|sLtd|��|��d}|�||f�||��d�}|r�|ddkr�q�|dd���}t�|�}|std|��q|s�d}||fS)z|
                Return a list of operator, version tuples if any are
                specified, else None.
                Nrzinvalid version: %srCr�invalid constraint: %s)�
COMPARE_OPrrr�VERSION_IDENTIFIERr r"r%)Z
ver_remainingr'�versionsr3�vr,r,r-�get_versions�s*


z'parse_requirement.<locals>.get_versionsr/r0r1rEz~=�;zinvalid requirement: %szunexpected trailing data: %s�%s %s�, cSsg|]}d|�qS)rLr,)�.0Zconr,r,r-�
<listcomp>sz%parse_requirement.<locals>.<listcomp>)�name�extrasZconstraintsr7�urlZrequirement)�strip�
startswithrrr rr�findr%r"�	NON_SPACEr�scheme�netlocrFrGr?r$r)�reqr&r'ZdistnamerQZ	mark_exprrH�uri�ir+�trJ�_rIZrsr,r,r-�parse_requirement�s�





�r^cCs�dd�}i}|D]�\}}}tj�||�}t|�D]p}tj�||�}	t|	�D]T}
|||
�}|dkrn|�|d�qJ|||
�}|�tjjd��d�}
|
d|||<qJq0q|S)z%Find destinations for resources filescSs6|�tjjd�}|�tjjd�}|t|�d��d�S�N�/)r!�os�path�sep�lenr%)�rootrbr,r,r-�get_rel_path
sz)get_resources_dests.<locals>.get_rel_pathNr`)rarbr$r�popr!rc�rstrip)Zresources_rootZrulesrfZdestinations�base�suffix�dest�prefixZabs_baseZabs_globZabs_pathZ
resource_fileZrel_pathZrel_destr,r,r-�get_resources_dests
s

rmcCs(ttd�rd}ntjttdtj�k}|S)NZreal_prefixT�base_prefix)�hasattr�sysrl�getattr�r(r,r,r-�in_venv$s
rscCs$tj�tj�}t|t�s t|�}|S�N)rarb�normcaserp�
executable�
isinstancerrrrr,r,r-�get_executable.s

rxcCsN|}t|�}|}|s|r|}|r|d��}||kr6qJ|rd|||f}q|S)Nrz	%c: %s
%s)r	�lower)�promptZ
allowed_charsZerror_prompt�default�pr+�cr,r,r-�proceed>sr~cCs8t|t�r|��}i}|D]}||kr||||<q|Srt)rwr�split)�d�keysr(�keyr,r,r-�extract_by_keyNs
r�cCs`tjddkrt�d�|�}|��}t|�}z`t�|�}|ddd}|��D]6\}}|��D]$\}}d||f}t	|�}	|	||<q`qP|WSt
k
r�|�dd�YnXdd	�}
t�
�}z|
||�Wn<tjk
�r|��t�|�}t|�}|
||�YnXi}|��D]D}i||<}|�|�D]&\}
}d|
|f}t	|�}	|	||
<�q0�q|S)
Nr��utf-8�
extensionszpython.exports�exportsz%s = %scSs$t|d�r|�|�n
|�|�dS)N�	read_file)ror�Zreadfp)�cp�streamr,r,r-�read_streamks
z!read_exports.<locals>.read_stream)rp�version_info�codecs�	getreader�readr
�json�load�items�get_export_entry�	Exception�seekr�ConfigParserZMissingSectionHeaderError�close�textwrap�dedentZsections)r��dataZjdatar(�group�entries�krIr+�entryr�r�r�rP�valuer,r,r-�read_exportsWs@

r�cCs�tjddkrt�d�|�}t��}|��D]l\}}|�|�|��D]P}|j	dkr\|j
}nd|j
|j	f}|jr�d|d�|j�f}|�
||j|�qFq,|�|�dS)Nrr�r�z%s:%sz%s [%s]rM)rpr�r��	getwriterrr�r�Zadd_section�valuesrjrl�flagsr$�setrP�write)r�r�r�r�rIr�r+r,r,r-�
write_exports�s

r�c	cs$t��}z
|VW5t�|�XdSrt)�tempfile�mkdtempr�rmtree)Ztdr,r,r-�tempdir�s
r�c	cs.t��}zt�|�dVW5t�|�XdSrt)ra�getcwd�chdir)r��cwdr,r,r-r��s


r��c	cs.t��}zt�|�dVW5t�|�XdSrt)�socketZgetdefaulttimeoutZsetdefaulttimeout)ZsecondsZctor,r,r-�socket_timeout�s


r�c@seZdZdd�Zddd�ZdS)�cached_propertycCs
||_dSrt)�func)�selfr�r,r,r-�__init__�szcached_property.__init__NcCs,|dkr|S|�|�}t�||jj|�|Srt)r��object�__setattr__�__name__)r��obj�clsr�r,r,r-�__get__�s

zcached_property.__get__)N)r��
__module__�__qualname__r�r�r,r,r,r-r��sr�cCs~tjdkr|S|s|S|ddkr.td|��|ddkrFtd|��|�d�}tj|krh|�tj�qP|srtjStjj|�S)a�Return 'pathname' as a name that will work on the native filesystem.

    The path is split on '/' and put back together again using the current
    directory separator.  Needed because filenames in the setup script are
    always supplied in Unix style, and have to be converted to the local
    convention before we can actually use them in the filesystem.  Raises
    ValueError on non-Unix-ish systems if 'pathname' either starts or
    ends with a slash.
    r`rzpath '%s' cannot be absolute���zpath '%s' cannot end with '/')rarc�
ValueErrorr�curdir�removerbr$)�pathname�pathsr,r,r-�convert_path�s



r�c@s�eZdZd$dd�Zdd�Zdd�Zdd	�Zd%dd�Zd&dd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
d'dd�Zdd�Zdd�Zd d!�Zd"d#�Zd
S)(�FileOperatorFcCs||_t�|_|��dSrt)�dry_runr��ensured�_init_record)r�r�r,r,r-r��szFileOperator.__init__cCsd|_t�|_t�|_dS�NF)�recordr��
files_written�dirs_created�r�r,r,r-r��szFileOperator._init_recordcCs|jr|j�|�dSrt)r�r��add)r�rbr,r,r-�record_as_written�szFileOperator.record_as_writtencCsHtj�|�s tdtj�|���tj�|�s0dSt�|�jt�|�jkS)a�Tell if the target is newer than the source.

        Returns true if 'source' exists and is more recently modified than
        'target', or if 'source' exists and 'target' doesn't.

        Returns false if both exist and 'target' is the same age or younger
        than 'source'. Raise PackagingFileError if 'source' does not exist.

        Note that this test is not very accurate: files created in the same
        second will have the same "age".
        zfile '%r' does not existT)rarb�existsr�abspath�stat�st_mtime)r��source�targetr,r,r-�newer�s
�zFileOperator.newerTcCs�|�tj�|��t�d||�|js�d}|rdtj�|�rDd|}n tj�|�rdtj�	|�sdd|}|rtt
|d��t�||�|�
|�dS)z8Copy a file respecting dry-run and force flags.
        zCopying %s to %sNz%s is a symlinkz%s is a non-regular filez which would be overwritten)�
ensure_dirrarb�dirname�logger�infor��islinkr��isfiler�rZcopyfiler�)r�Zinfile�outfile�check�msgr,r,r-�	copy_files
zFileOperator.copy_fileNcCst|�tj�|��t�d||�|jsf|dkr:t|d�}ntj|d|d�}zt
�||�W5|�	�X|�|�dS)NzCopying stream %s to %s�wb�w��encoding)
r�rarbr�r�r�r��openr�r�rZcopyfileobjr�)r�Zinstreamr�r�Z	outstreamr,r,r-�copy_streams
zFileOperator.copy_streamc	Cs\|�tj�|��|jsNtj�|�r.t�|�t|d��}|�|�W5QRX|�	|�dS)Nr�)
r�rarbr�r�r�r�r�r�r�)r�rbr��fr,r,r-�write_binary_file!s
zFileOperator.write_binary_filecCs|�||�|��dSrt)r��encode)r�rbr�r�r,r,r-�write_text_file*szFileOperator.write_text_filecCsntjdkstjdkrjtjdkrj|D]F}|jr:t�d|�q"t�|�j|B|@}t�d||�t�||�q"dS)N�posix�javazchanging mode of %szchanging mode of %s to %o)	rarP�_namer�r�r�r��st_mode�chmod)r��bits�mask�filesr��moder,r,r-�set_mode-szFileOperator.set_modecCs|�dd|�S)Nimi�)r�)r+r�r,r,r-�<lambda>9�zFileOperator.<lambda>cCs|tj�|�}||jkrxtj�|�sx|j�|�tj�|�\}}|�|�t�	d|�|j
sft�|�|jrx|j
�|�dS)NzCreating %s)rarbr�r�r�r�rr�r�r�r��mkdirr�r�)r�rbr�r�r,r,r-r�;s

zFileOperator.ensure_dirc	Cs�t||�}t�d||�|js||s0|�||�rJ|s:d}n|t|�d�}i}|rhttd�rhtjj	|d<tj
|||df|�|�|�|S)NzByte-compiling %s to %s�PycInvalidationMode�invalidation_modeT)rr�r�r�r�rdro�
py_compiler��CHECKED_HASH�compiler�)	r�rb�optimize�forcerlZhashed_invalidationZdpathZdiagpathZcompile_kwargsr,r,r-�byte_compileGs
zFileOperator.byte_compilecCs�tj�|�r�tj�|�r^tj�|�s^t�d|�|js@t�	|�|j
r�||jkr�|j�|�nPtj�|�rpd}nd}t�d||�|js�t�|�|j
r�||j
kr�|j
�|�dS)NzRemoving directory tree at %s�link�filezRemoving %s %s)rarbr��isdirr�r��debugr�rr�r�r�r�r�)r�rbr+r,r,r-�ensure_removedXs"



zFileOperator.ensure_removedcCsDd}|s@tj�|�r$t�|tj�}q@tj�|�}||kr:q@|}q|Sr�)rarbr��access�W_OKr�)r�rbr(�parentr,r,r-�is_writablemszFileOperator.is_writablecCs|j|jf}|��|S)zV
        Commit recorded changes, turn off recording, return
        changes.
        )r�r�r�)r�r(r,r,r-�commityszFileOperator.commitcCs�|jsxt|j�D]}tj�|�rt�|�qt|jdd�}|D]8}t�	|�}|rltj�
||d�}t�|�t�|�q>|��dS)NT)�reverser)
r��listr�rarbr�r��sortedr��listdirr$�rmdirr�)r�r��dirsr��flistZsdr,r,r-�rollback�s

zFileOperator.rollback)F)T)N)FFNF)r�r�r�r�r�r�r�r�r�r�r�r�Zset_executable_moder�r�rrrrr,r,r,r-r��s 


	

r�cCs^|tjkrtj|}nt|�}|dkr,|}n.|�d�}t||�d��}|D]}t||�}qJ|S)N�.r)rp�modules�
__import__rrqrg)Zmodule_nameZdotted_path�modr(r*r|r,r,r-�resolve�s

rc@s6eZdZdd�Zedd��Zdd�Zdd�Zej	Z	d	S)
�ExportEntrycCs||_||_||_||_dSrt�rPrlrjr�)r�rPrlrjr�r,r,r-r��szExportEntry.__init__cCst|j|j�Srt)rrlrjr�r,r,r-r��szExportEntry.valuecCsd|j|j|j|jfS)Nz<ExportEntry %s = %s:%s %s>rr�r,r,r-�__repr__�s
�zExportEntry.__repr__cCsDt|t�sd}n0|j|jko>|j|jko>|j|jko>|j|jk}|Sr�)rwrrPrlrjr�)r��otherr(r,r,r-�__eq__�s

�
�
�zExportEntry.__eq__N)
r�r�r�r�r�r�rrr��__hash__r,r,r,r-r�s

rz�(?P<name>(\w|[-.+])+)
                      \s*=\s*(?P<callable>(\w+)([:\.]\w+)*)
                      \s*(\[\s*(?P<flags>\w+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])?
                      c
Cs�t�|�}|s0d}d|ks"d|kr�td|��n�|��}|d}|d}|�d�}|dkrf|d}}n"|dkrztd|��|�d�\}}|d	}	|	dkr�d|ks�d|kr�td|��g}	nd
d�|	�d�D�}	t||||	�}|S)
NrArBzInvalid specification '%s'rP�callable�:rrr�cSsg|]}|���qSr,)rS)rNr�r,r,r-rO�sz$get_export_entry.<locals>.<listcomp>rC)�ENTRY_RE�searchr�	groupdict�countrr)
Z
specificationr'r(r�rPrbZcolonsrlrjr�r,r,r-r��s8
�
��r�cCs�|dkrd}tjdkr.dtjkr.tj�d�}ntj�d�}tj�|�rft�|tj�}|s�t	�
d|�n<zt�|�d}Wn(tk
r�t	j
d	|dd
�d}YnX|s�t
��}t	�
d|�tj�||�S)
a�
    Return the default base location for distlib caches. If the directory does
    not exist, it is created. Use the suffix provided for the base directory,
    and default to '.distlib' if it isn't provided.

    On Windows, if LOCALAPPDATA is defined in the environment, then it is
    assumed to be a directory, and will be the parent directory of the result.
    On POSIX, and on Windows if LOCALAPPDATA is not defined, the user's home
    directory - using os.expanduser('~') - will be the parent directory of
    the result.

    The result is just the directory '.distlib' in the parent directory as
    determined above, or with the name specified with ``suffix``.
    Nz.distlib�ntZLOCALAPPDATAz
$localappdata�~z(Directory exists but is not writable: %sTzUnable to create %s)�exc_infoFz#Default location unusable, using %s)rarP�environrb�
expandvars�
expanduserrrrr��warning�makedirs�OSErrorr�r�r$)rjr(Zusabler,r,r-�get_cache_base�s&

r+cCsBtj�tj�|��\}}|r(|�dd�}|�tjd�}||dS)a
    Convert an absolute path to a directory name for use in a cache.

    The algorithm used is:

    #. On Windows, any ``':'`` in the drive is replaced with ``'---'``.
    #. Any occurrence of ``os.sep`` is replaced with ``'--'``.
    #. ``'.cache'`` is appended.
    rz---z--z.cache)rarb�
splitdriver�r!rc)rbr�r|r,r,r-�path_to_cache_dir
s

r-cCs|�d�s|dS|Sr_)�endswith)r+r,r,r-�ensure_slashs
r/cCs`d}}d|kr>|�dd�\}}d|kr.|}n|�dd�\}}|rJt|�}|rVt|�}|||fS)NrDrr)�rsplitrr)rXZusernameZpasswordrlr,r,r-�parse_credentials$sr1cCst�d�}t�|�|S)N�)ra�umaskrrr,r,r-�get_process_umask3s

r4cCs0d}d}t|�D]\}}t|t�sd}q,q|S)NTF)�	enumeraterwr)�seqr(r[r+r,r,r-�is_string_sequence8s
r7z3([a-z0-9_]+([.-][a-z_][a-z0-9_]*)*)-([a-z0-9_.+-]+)z
-py(\d\.?\d?)cCs�d}d}t|��dd�}t�|�}|r@|�d�}|d|���}|r�t|�t|�dkr�t�t�	|�d|�}|r�|�
�}|d|�||dd�|f}|dkr�t�|�}|r�|�d�|�d�|f}|S)zw
    Extract name, version, python version from a filename (no extension)

    Return name, version, pyver or None
    N� �-rz\br�)rr!�PYTHON_VERSIONrr��startrd�rer�escaper�PROJECT_NAME_AND_VERSION)�filenameZproject_namer(Zpyverr'�nr,r,r-�split_filenameGs"


rAz-(?P<name>[\w .-]+)\s*\(\s*(?P<ver>[^\s)]+)\)$cCs:t�|�}|std|��|��}|d����|dfS)z�
    A utility method used to get name and version from a string.

    From e.g. a Provides-Dist value.

    :param p: A value in a form 'foo (1.0)'
    :return: The name and version as a tuple.
    z$Ill-formed name/version string: '%s'rPZver)�NAME_VERSION_RErrr rSry)r|r'r�r,r,r-�parse_name_and_versioncs
	
rCcCs�t�}t|pg�}t|pg�}d|kr8|�d�||O}|D]x}|dkrT|�|�q<|�d�r�|dd�}||kr�t�d|�||kr�|�|�q<||kr�t�d|�|�|�q<|S)N�*r9rzundeclared extra: %s)r�r�r�rTr�r()Z	requestedZ	availabler(�rZunwantedr,r,r-�
get_extrasrs&

rFc
Cs�i}zNt|�}|��}|�d�}|�d�s8t�d|�nt�d�|�}t�	|�}Wn0t
k
r�}zt�d||�W5d}~XYnX|S)NzContent-Typezapplication/jsonz(Unexpected response for JSON request: %sr�z&Failed to get external data for %s: %s)rr��getrTr�rr�r�r�r�r��	exception)rRr(ZrespZheadersZct�reader�er,r,r-�_get_external_data�s

 rKz'https://www.red-dove.com/pypi/projects/cCs*d|d��|f}tt|�}t|�}|S)Nz%s/%s/project.jsonr��upperr
�_external_data_base_urlrK)rPrRr(r,r,r-�get_project_data�s
rOcCs(d|d��||f}tt|�}t|�S)Nz%s/%s/package-%s.jsonrrL)rP�versionrRr,r,r-�get_package_data�s
rQc@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Cachez�
    A class implementing a cache for resources that need to live in the file system
    e.g. shared libraries. This class was moved from resources to here because it
    could be used by other modules, e.g. the wheel module.
    cCsPtj�|�st�|�t�|�jd@dkr6t�d|�tj�tj�	|��|_
dS)zu
        Initialise an instance.

        :param base: The base directory where the cache should be located.
        �?rzDirectory '%s' is not privateN)rarbrr)r�r�r�r(r��normpathri)r�rir,r,r-r��s

zCache.__init__cCst|�S)zN
        Converts a resource prefix to a directory name in the cache.
        )r-)r�rlr,r,r-�
prefix_to_dir�szCache.prefix_to_dirc	Cs�g}t�|j�D]r}tj�|j|�}z>tj�|�s>tj�|�rJt�|�ntj�|�r`t	�
|�Wqtk
r�|�|�YqXq|S)z"
        Clear the cache.
        )
rarrirbr$r�r�r�rrr�r�r")r�Znot_removed�fnr,r,r-�clear�szCache.clearN)r�r�r��__doc__r�rUrWr,r,r,r-rR�srRc@s:eZdZdZdd�Zddd�Zdd�Zd	d
�Zdd�Zd
S)�
EventMixinz1
    A very simple publish/subscribe system.
    cCs
i|_dSrt)�_subscribersr�r,r,r-r��szEventMixin.__init__TcCsD|j}||krt|g�||<n"||}|r6|�|�n
|�|�dS)a`
        Add a subscriber for an event.

        :param event: The name of an event.
        :param subscriber: The subscriber to be added (and called when the
                           event is published).
        :param append: Whether to append or prepend the subscriber to an
                       existing subscriber list for the event.
        N)rZrr"�
appendleft)r��event�
subscriberr"�subsZsqr,r,r-r��s
zEventMixin.addcCs,|j}||krtd|��||�|�dS)z�
        Remove a subscriber for an event.

        :param event: The name of an event.
        :param subscriber: The subscriber to be removed.
        zNo subscribers: %rN)rZr�r�)r�r\r]r^r,r,r-r��szEventMixin.removecCst|j�|d��S)z�
        Return an iterator for the subscribers for an event.
        :param event: The event to return subscribers for.
        r,)�iterrZrG)r�r\r,r,r-�get_subscribersszEventMixin.get_subscribersc	Oslg}|�|�D]F}z||f|�|�}Wn"tk
rHt�d�d}YnX|�|�qt�d||||�|S)a^
        Publish a event and return a list of values returned by its
        subscribers.

        :param event: The event to publish.
        :param args: The positional arguments to pass to the event's
                     subscribers.
        :param kwargs: The keyword arguments to pass to the event's
                       subscribers.
        z"Exception during event publicationNz/publish %s: args = %s, kwargs = %s, result = %s)r`r�r�rHr"r)r�r\�args�kwargsr(r]r�r,r,r-�publishs

�zEventMixin.publishN)T)	r�r�r�rXr�r�r�r`rcr,r,r,r-rY�s
rYc@s^eZdZdd�Zdd�Zddd�Zdd	�Zd
d�Zdd
�Zdd�Z	e
dd��Ze
dd��ZdS)�	SequencercCsi|_i|_t�|_dSrt)�_preds�_succsr��_nodesr�r,r,r-r�"szSequencer.__init__cCs|j�|�dSrt)rgr��r��noder,r,r-�add_node'szSequencer.add_nodeFcCs�||jkr|j�|�|r�t|j�|d��D]}|�||�q,t|j�|d��D]}|�||�qPt|j���D]\}}|sp|j|=qpt|j���D]\}}|s�|j|=q�dS)Nr,)rgr�r�rerGrfr
r�)r�riZedgesr|r+r�rIr,r,r-�remove_node*s

zSequencer.remove_nodecCs0|j�|t���|�|j�|t���|�dSrt)re�
setdefaultr�r�rf)r��pred�succr,r,r-r�:sz
Sequencer.addcCs|z|j|}|j|}Wn tk
r8td|��YnXz|�|�|�|�Wn$tk
rvtd||f��YnXdS)Nz%r not a successor of anythingz%r not a successor of %r)rerf�KeyErrorr�r�)r�rmrn�predsZsuccsr,r,r-r�?s

zSequencer.removecCs||jkp||jkp||jkSrt)rerfrg)r��stepr,r,r-�is_stepLs�zSequencer.is_stepcCs�|�|�std|��g}g}t�}|�|�|r�|�d�}||krb||kr�|�|�|�|�q.|�|�|�|�|j�|d�}|�	|�q.t
|�S)NzUnknown: %rrr,)rrr�r�r"rgr�r�rerG�extend�reversed)r��finalr(Ztodo�seenrqrpr,r,r-�	get_stepsPs"





zSequencer.get_stepscsRdg�g�i�i�g�|j��������fdd���D]}|�kr8�|�q8�S)Nrcs��d�|<�d�|<�dd7<��|�z�|}Wntk
rVg}YnX|D]J}|�kr��|�t�|�|��|<q\|�kr\t�|�|��|<q\�|�|kr�g}���}|�|�||kr�q�q�t|�}��|�dS)Nrr)r"r��minrg�tuple)riZ
successorsZ	successorZconnected_componentZ	component�Zgraph�indexZ
index_counterZlowlinksr(�stack�
strongconnectr,r-r}ts,


z3Sequencer.strong_connections.<locals>.strongconnect)rfrhr,rzr-�strong_connectionsis"
zSequencer.strong_connectionscCsfdg}|jD]*}|j|}|D]}|�d||f�qq|jD]}|�d|�q>|�d�d�|�S)Nzdigraph G {z  %s -> %s;z  %s;�}�
)rer"rgr$)r�r(rnrprmrir,r,r-�dot�s



z
Sequencer.dotN)F)
r�r�r�r�rjrkr�r�rrrw�propertyr~r�r,r,r,r-rd!s


2rd)�.tar.gz�.tar.bz2�.tar�.zip�.tgz�.tbz�.whlTcsZ��fdd�}tj����t���d}|dkr�|�d�r>d}nH|�d�rRd}d}n4|�d�rfd	}d
}n |�d�rzd}d
}ntd|��z�|dkr�t|d
�}|r�|��}|D]}||�q�n*t	�
||�}|r�|��}|D]}||�q�|dk�r*tj
ddk�r*|��D]"}	t|	jt��s|	j�d�|	_�qdd�}
|
|_|���W5|�rT|��XdS)NcsRt|t�s|�d�}tj�tj��|��}|���rB|�tjkrNt	d|��dS)Nr�zpath outside destination: %r)
rwr�decoderarbr�r$rTrcr�)rbr|��dest_dirZplenr,r-�
check_path�s


zunarchive.<locals>.check_path)r�r��zip)r�r�Ztgzzr:gz)r�r�Ztbzzr:bz2r�ZtarrEzUnknown format for %rrr�r�c
SsDzt�||�WStjk
r>}ztt|���W5d}~XYnXdS)z:Run tarfile.tar_fillter, but raise the expected ValueErrorN)�tarfileZ
tar_filterZFilterErrorr��str)�memberrb�excr,r,r-�extraction_filter�sz$unarchive.<locals>.extraction_filter)rarbr�rdr.r�r�rZnamelistr�r�Zgetnamesrpr�Z
getmembersrwrPrr�r�Z
extractall)Zarchive_filenamer��formatr�r��archiver��namesrPZtarinfor�r,r�r-�	unarchive�sL





r�c	Cs~t��}t|�}t|d��Z}t�|�D]H\}}}|D]8}tj�||�}||d�}	tj�|	|�}
|�||
�q4q&W5QRX|S)z*zip a directory tree into a BytesIO objectr�N)	�io�BytesIOrdrra�walkrbr$r�)Z	directoryr(ZdlenZzfrerr�rPZfullZrelrkr,r,r-�zip_dir�sr�)r�K�M�G�T�Pc@sreZdZdZddd�Zdd�Zdd	�Zd
d�Zdd
�Ze	dd��Z
e	dd��Zdd�Ze	dd��Z
e	dd��ZdS)�ProgressZUNKNOWNr�dcCs(||_|_||_d|_d|_d|_dS)NrF)rx�cur�max�started�elapsed�done)r�ZminvalZmaxvalr,r,r-r�	s
zProgress.__init__cCs0||_t��}|jdkr ||_n||j|_dSrt)r��timer�r�)r�ZcurvalZnowr,r,r-�updates

zProgress.updatecCs|�|j|�dSrt)r�r�)r�Zincrr,r,r-�	incrementszProgress.incrementcCs|�|j�|Srt)r�rxr�r,r,r-r;szProgress.startcCs |jdk	r|�|j�d|_dS)NT)r�r�r�r�r,r,r-�stop#s
z
Progress.stopcCs|jdkr|jS|jSrt)r��unknownr�r,r,r-�maximum(szProgress.maximumcCsD|jrd}n4|jdkrd}n$d|j|j|j|j}d|}|S)Nz100 %z ?? %gY@z%3d %%)r�r�r�rx)r�r(rIr,r,r-�
percentage,s
zProgress.percentagecCs:|dkr|jdks|j|jkr$d}nt�dt�|��}|S)Nrz??:??:??z%H:%M:%S)r�r�rxr��strftime�gmtime)r�Zdurationr(r,r,r-�format_duration7szProgress.format_durationcCs�|jrd}|j}n^d}|jdkr&d}nJ|jdks<|j|jkrBd}n.t|j|j�}||j|j}|d|j}d||�|�fS)NZDonezETA r�rrz%s: %s)r�r�r�r�rx�floatr�)r�rlr\r,r,r-�ETA@s
zProgress.ETAcCsL|jdkrd}n|j|j|j}tD]}|dkr6q@|d}q&d||fS)Nrgi�g@�@z%d %sB/s)r�r�rx�UNITS)r�r(Zunitr,r,r-�speedSs

zProgress.speedN)rr�)r�r�r�r�r�r�r�r;r�r�r�r�r�r�r�r,r,r,r-r�s




	
r�z\{([^}]*)\}z[^/\\,{]\*\*|\*\*[^/\\,}]z^[^{]*\}|\{[^}]*$cCs<t�|�rd}t||��t�|�r4d}t||��t|�S)zAExtended globbing function that supports ** and {opt1,opt2,opt3}.z7invalid glob %r: recursive glob "**" must be used alonez2invalid glob %r: mismatching set marker '{' or '}')�_CHECK_RECURSIVE_GLOBrr��_CHECK_MISMATCH_SET�_iglob)�	path_globr�r,r,r-rhs

rccs�t�|d�}t|�dkrT|\}}}|�d�D]$}td�|||f��D]
}|VqDq,n�d|krrt|�D]
}|Vqdn~|�dd�\}}|dkr�d}|dkr�d}n|�d�}|�d�}t�|�D]4\}}}	tj	�
|�}ttj	�||��D]
}
|
Vq�q�dS)	NrrCrz**rrDr`�\)�	RICH_GLOBrrdr�r$�	std_iglobr%rar�rbrT)r�Zrich_path_globrlr�rj�itemrbZradical�dirr�rVr,r,r-r�ss(



r�)�HTTPSHandler�match_hostname�CertificateErrorc@seZdZdZdZdd�ZdS)�HTTPSConnectionNTcCsRt�|j|jf|j�}t|dd�r0||_|��tt	d�sp|j
rHt	j}nt	j}t	j
||j|j|t	j|j
d�|_nxt	�t	j�}|jt	jO_|jr�|�|j|j�i}|j
r�t	j|_|j|j
d�tt	dd�r�|j|d<|j
|f|�|_|j
�rN|j�rNz$t|j��|j�t�d|j�Wn0tk
�rL|j�tj�|j���YnXdS)	NZ_tunnel_hostF�
SSLContext)�	cert_reqsZssl_version�ca_certs)ZcafileZHAS_SNIZserver_hostnamezHost verified: %s) r�Zcreate_connection�host�port�timeoutrq�sockZ_tunnelro�sslr�Z
CERT_REQUIREDZ	CERT_NONEZwrap_socketZkey_fileZ	cert_fileZPROTOCOL_SSLv23r�ZoptionsZOP_NO_SSLv2Zload_cert_chainZverify_modeZload_verify_locations�check_domainr�Zgetpeercertr�rr�ZshutdownZ	SHUT_RDWRr�)r�r�r��contextrbr,r,r-�connect�s@
�


zHTTPSConnection.connect)r�r�r�r�r�r�r,r,r,r-r��sr�c@s&eZdZd	dd�Zdd�Zdd�ZdS)
r�TcCst�|�||_||_dSrt)�BaseHTTPSHandlerr�r�r�)r�r�r�r,r,r-r��s
zHTTPSHandler.__init__cOs$t||�}|jr |j|_|j|_|S)a
            This is called to create a connection instance. Normally you'd
            pass a connection class to do_open, but it doesn't actually check for
            a class, and just expects a callable. As long as we behave just as a
            constructor would have, we should be OK. If it ever changes so that
            we *must* pass a class, we'll create an UnsafeHTTPSConnection class
            which just sets check_domain to False in the class definition, and
            choose which one to pass to do_open.
            )r�r�r�)r�rarbr(r,r,r-�_conn_maker�s


zHTTPSHandler._conn_makerc
CsXz|�|j|�WStk
rR}z$dt|j�kr@td|j��n�W5d}~XYnXdS)Nzcertificate verify failedz*Unable to verify server certificate for %s)Zdo_openr�rr��reasonr�r�)r�rYrJr,r,r-�
https_open�s�zHTTPSHandler.https_openN)T)r�r�r�r�r�r�r,r,r,r-r��s
r�c@seZdZdd�ZdS)�HTTPSOnlyHandlercCstd|��dS)NzAUnexpected HTTP request on what should be a secure connection: %s)r)r�rYr,r,r-�	http_open�s�zHTTPSOnlyHandler.http_openN)r�r�r�r�r,r,r,r-r��sr���r��c@seZdZddd�ZdS)�HTTPrNcKs&|dkrd}|�|j||f|��dS�Nr��_setupZ_connection_class�r�r�r�rbr,r,r-r��sz
HTTP.__init__)rN�r�r�r�r�r,r,r,r-r��sr�c@seZdZddd�ZdS)�HTTPSrNcKs&|dkrd}|�|j||f|��dSr�r�r�r,r,r-r��szHTTPS.__init__)rNr�r,r,r,r-r��sr�c@seZdZddd�Zdd�ZdS)�	TransportrcCs||_tj�||�dSrt)r�rr�r��r�r��use_datetimer,r,r-r�szTransport.__init__cCs`|�|�\}}}tdkr(t||jd�}n4|jr<||jdkrR||_|t�|�f|_|jd}|S)Nr�)r�rr)�
get_host_info�	_ver_infor�r��_connection�_extra_headersrZHTTPConnection)r�r��h�ehZx509r(r,r,r-�make_connection
s
zTransport.make_connectionN)r�r�r�r�r�r�r,r,r,r-r�s
r�c@seZdZddd�Zdd�ZdS)�
SafeTransportrcCs||_tj�||�dSrt)r�rr�r�r�r,r,r-r�szSafeTransport.__init__cCsx|�|�\}}}|si}|j|d<tdkr:t|df|�}n:|jrN||jdkrj||_|tj|df|�f|_|jd}|S)Nr�r�rr)r�r�r�r�r�r�rr�)r�r�r�r�rbr(r,r,r-r�s
�
zSafeTransport.make_connectionN)rr�r,r,r,r-r�s
r�c@seZdZdd�ZdS)�ServerProxyc	Kst|�dd�|_}|dk	r^t|�\}}|�dd�}|dkr@t}nt}|||d�|d<}||_tjj	||f|�dS)Nr�r�rZhttps)r��	transport)
rgr�rrGr�r�r�rr�r�)	r�rZrbr�rWr]r�Ztclsr\r,r,r-r�,szServerProxy.__init__Nr�r,r,r,r-r�+sr�cKs6tjddkr|d7}nd|d<d|d<t||f|�S)Nrr��br�newliner�r�)rpr�r�)rVr�rbr,r,r-�	_csv_open@s

r�c@s4eZdZed�ed�ed�d�Zdd�Zdd�Zd	S)
�CSVBaserC�"r�)Z	delimiterZ	quotecharZlineterminatorcCs|Srtr,r�r,r,r-�	__enter__RszCSVBase.__enter__cGs|j��dSrt)r�r�)r�r$r,r,r-�__exit__UszCSVBase.__exit__N)r�r�r�r��defaultsr�r�r,r,r,r-r�Ks�r�c@s(eZdZdd�Zdd�Zdd�ZeZdS)�	CSVReadercKs\d|kr4|d}tjddkr,t�d�|�}||_nt|dd�|_tj|jf|j�|_dS)Nr�rr�r�rbrE)	rpr�r�r�r�r��csvrIr�)r�rbr�r,r,r-r�ZszCSVReader.__init__cCs|Srtr,r�r,r,r-�__iter__eszCSVReader.__iter__cCsFt|j�}tjddkrBt|�D] \}}t|t�s |�d�||<q |S�Nrr�r�)�nextrIrpr�r5rwrr�)r�r(r[r�r,r,r-r�hs

zCSVReader.nextN)r�r�r�r�r�r��__next__r,r,r,r-r�Ysr�c@seZdZdd�Zdd�ZdS)�	CSVWritercKs$t|d�|_tj|jf|j�|_dS)Nr�)r�r�r��writerr�)r�rVrbr,r,r-r�sszCSVWriter.__init__cCsNtjddkr>g}|D]"}t|t�r.|�d�}|�|�q|}|j�|�dSr�)rpr�rwrr�r"r��writerow)r��rowrEr�r,r,r-r�ws

zCSVWriter.writerowN)r�r�r�r�r�r,r,r,r-r�rsr�csHeZdZeej�Zded<d�fdd�	Zdd�Zdd	�Zd
d�Z	�Z
S)
�Configurator�inc_convertZincNcs"tt|��|�|pt��|_dSrt)�superr�r�rar�ri)r��configri��	__class__r,r-r��szConfigurator.__init__c
s���fdd����d�}t|�s*��|�}��dd�}��dd�}|r\t�fdd�|D��}��fd	d��D�}t|�}|||�}|r�|��D]\}}	t||�|	��q�|S)
Ncsvt|ttf�r*t|��fdd�|D��}nHt|t�rhd|krH��|�}qri}|D]}�||�||<qPn
��|�}|S)Ncsg|]}�|��qSr,r,)rNr[��convertr,r-rO�szBConfigurator.configure_custom.<locals>.convert.<locals>.<listcomp>�())rwr
ry�type�dict�configure_customr)�or(r�)rr�r,r-r�s

z.Configurator.configure_custom.<locals>.convertrrz[]r,csg|]}�|��qSr,r,)rNr
rr,r-rO�sz1Configurator.configure_custom.<locals>.<listcomp>cs$g|]}t|�r|��|�f�qSr,)r)rNr�)rrr,r-rO�s)rgrrryrr��setattr)
r�rr}Zpropsrar�rbr(r@rIr,)rrr�r-r	�s


zConfigurator.configure_customcCs4|j|}t|t�r0d|kr0|�|�|j|<}|S)Nr)rrwrr	)r�r�r(r,r,r-�__getitem__�s
zConfigurator.__getitem__c	CsFtj�|�stj�|j|�}tj|ddd��}t�|�}W5QRX|S)z*Default converter for the inc:// protocol.rEr�r�)	rarb�isabsr$rir�r�r�r�)r�r�r�r(r,r,r-r��s
zConfigurator.inc_convert)N)r�r�r�rrZvalue_convertersr�r	rr��
__classcell__r,r,rr-r��s
r�c@s*eZdZdZd
dd�Zdd�Zdd	�ZdS)�SubprocessMixinzC
    Mixin for running subprocesses and capturing their output
    FNcCs||_||_dSrt)�verbose�progress)r�rrr,r,r-r��szSubprocessMixin.__init__cCsj|j}|j}|��}|sq^|dk	r.|||�q|s@tj�d�ntj�|�d��tj��q|��dS)z�
        Read lines from a subprocess' output stream and either pass to a progress
        callable (if specified) or write progress information to sys.stderr.
        Nrr�)	rr�readlinerp�stderrr�r��flushr�)r�r�r�rrr+r,r,r-rI�szSubprocessMixin.readercKs�tj|ftjtjd�|��}tj|j|jdfd�}|��tj|j|jdfd�}|��|�	�|�
�|�
�|jdk	r�|�dd�n|jr�t
j�d�|S)N)�stdoutrr)r�rarzdone.�mainzdone.
)�
subprocess�Popen�PIPE�	threadingZThreadrIrr;r�waitr$rrrpr�)r��cmdrbr|�t1�t2r,r,r-�run_command�s"��
zSubprocessMixin.run_command)FN)r�r�r�rXr�rIrr,r,r,r-r�s
rcCst�dd|���S)z,Normalize a python package name a la PEP 503z[-_.]+r9)r<�subry)rPr,r,r-�normalize_name�sr!)NN)r�)N)N)NT)�r��collectionsr�
contextlibr�Zglobrr�r�r�Zloggingrar�r<r�r��ImportErrorrrpr�r�r�rZdummy_threadingr�rr�compatrrrr	r
rrr
rrrrrrrrrrrrrZ	getLoggerr�r�r�rrGrFr6r>r:rVr#r?r^rmrsrxr~r�r�r��contextmanagerr�r�r�r�r�r�r�rr�VERBOSErr�r+r-r/r1r4r7�Ir>r:rArBrCrFrKrNrOrQrRrYrdZARCHIVE_EXTENSIONSr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr!r,r,r,r-�<module>s�
\








Yy

	/

		8�
)
�


,H
C]


*)	
7.site-packages/pip/_vendor/distlib/__pycache__/resources.cpython-38.pyc000064400000025334151446177000022030 0ustar00U

��.e*�	@s�ddlmZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
mZmZmZmZe�e�ZdaGdd�de�ZGdd	�d	e�ZGd
d�de�ZGdd
�d
e�ZGdd�de�ZGdd�de�Zed�ee
jeiZzFzddl Z!Wne"k
�r$ddl#Z!YnXeee!j$<eee!j%<[!Wne"e&fk
�rXYnXdd�Z'iZ(dd�Z)e	�*e+d��Z,dd�Z-dS)�)�unicode_literalsN�)�DistlibException)�cached_property�get_cache_base�path_to_cache_dir�Cachecs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�
ResourceCacheNcs0|dkrtj�t�td��}tt|��|�dS)Nzresource-cache)�os�path�joinr�str�superr	�__init__)�self�base��	__class__��A/usr/lib/python3.8/site-packages/pip/_vendor/distlib/resources.pyrszResourceCache.__init__cCsdS)z�
        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.
        Tr�r�resourcerrrr�is_stale#s	zResourceCache.is_stalec	Cs�|j�|�\}}|dkr|}n~tj�|j|�|�|�}tj�|�}tj�|�sXt�	|�tj�
|�sjd}n|�||�}|r�t|d��}|�
|j�W5QRX|S)z�
        Get a resource into the cache,

        :param resource: A :class:`Resource` instance.
        :return: The pathname of the resource in the cache.
        NT�wb)�finder�get_cache_infor
rrrZ
prefix_to_dir�dirname�isdir�makedirs�existsr�open�write�bytes)rr�prefixr�resultrZstale�frrr�get.s
zResourceCache.get)N)�__name__�
__module__�__qualname__rrr&�
__classcell__rrrrr	sr	c@seZdZdd�ZdS)�ResourceBasecCs||_||_dS�N)r�name)rrr-rrrrIszResourceBase.__init__N)r'r(r)rrrrrr+Hsr+c@s@eZdZdZdZdd�Zedd��Zedd��Zed	d
��Z	dS)�Resourcez�
    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.
    FcCs|j�|�S)z�
        Get the resource as a stream.

        This is not a property to make it obvious that it returns a new stream
        each time.
        )r�
get_stream�rrrr�	as_streamVszResource.as_streamcCstdkrt�at�|�Sr,)�cacher	r&r0rrr�	file_path_szResource.file_pathcCs|j�|�Sr,)r�	get_bytesr0rrrr"fszResource.bytescCs|j�|�Sr,)r�get_sizer0rrr�sizejsz
Resource.sizeN)
r'r(r)�__doc__�is_containerr1rr3r"r6rrrrr.Ns	

r.c@seZdZdZedd��ZdS)�ResourceContainerTcCs|j�|�Sr,)r�
get_resourcesr0rrr�	resourcesrszResourceContainer.resourcesN)r'r(r)r8rr;rrrrr9osr9c@s�eZdZdZej�d�rdZndZdd�Zdd�Z	d	d
�Z
dd�Zd
d�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zeejj�Zdd�ZdS)�ResourceFinderz4
    Resource finder for file system resources.
    �java)�.pyc�.pyoz.class)r>r?cCs.||_t|dd�|_tj�t|dd��|_dS)N�
__loader__�__file__�)�module�getattr�loaderr
rrr)rrCrrrr�szResourceFinder.__init__cCstj�|�Sr,)r
r�realpath�rrrrr�_adjust_path�szResourceFinder._adjust_pathcCsBt|t�rd}nd}|�|�}|�d|j�tjj|�}|�|�S)N�/�/r)	�
isinstancer"�split�insertrr
rrrH)r�
resource_name�sep�partsr$rrr�
_make_path�s

zResourceFinder._make_pathcCstj�|�Sr,)r
rrrGrrr�_find�szResourceFinder._findcCs
d|jfSr,)r�rrrrrr�szResourceFinder.get_cache_infocCsD|�|�}|�|�sd}n&|�|�r0t||�}n
t||�}||_|Sr,)rQrR�
_is_directoryr9r.r)rrNrr$rrr�find�s



zResourceFinder.findcCst|jd�S�N�rb)r rrSrrrr/�szResourceFinder.get_streamc
Cs,t|jd��}|��W5QR�SQRXdSrV)r r�read)rrr%rrrr4�szResourceFinder.get_bytescCstj�|j�Sr,)r
r�getsizerSrrrr5�szResourceFinder.get_sizecs*�fdd��t�fdd�t�|j�D��S)Ncs|dko|��j�S)N�__pycache__)�endswith�skipped_extensions)r%r0rr�allowed�s
�z-ResourceFinder.get_resources.<locals>.allowedcsg|]}�|�r|�qSrr)�.0r%)r]rr�
<listcomp>�sz0ResourceFinder.get_resources.<locals>.<listcomp>)�setr
�listdirrrSr)r]rrr:�szResourceFinder.get_resourcescCs|�|j�Sr,)rTrrSrrrr8�szResourceFinder.is_containerccs�|�|�}|dk	r�|g}|r�|�d�}|V|jr|j}|jD]>}|sL|}nd�||g�}|�|�}|jrv|�|�q>|Vq>qdS)NrrJ)rU�popr8r-r;r�append)rrNrZtodoZrnamer-�new_nameZchildrrr�iterator�s 



zResourceFinder.iteratorN)r'r(r)r7�sys�platform�
startswithr\rrHrQrRrrUr/r4r5r:r8�staticmethodr
rrrTrerrrrr<ws"r<cs`eZdZdZ�fdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�Z�Z
S)�ZipResourceFinderz6
    Resource finder for resources in .zip files.
    csZtt|��|�|jj}dt|�|_t|jd�r>|jj|_nt	j
||_t|j�|_dS)Nr�_files)
rrjrrE�archive�len�
prefix_len�hasattrrk�	zipimport�_zip_directory_cache�sorted�index)rrCrlrrrr�szZipResourceFinder.__init__cCs|Sr,rrGrrrrH�szZipResourceFinder._adjust_pathcCs�||jd�}||jkrd}nX|r:|dtjkr:|tj}t�|j|�}z|j|�|�}Wntk
rtd}YnX|s�t�	d||j
j�nt�	d||j
j�|S)NT���Fz_find failed: %r %rz_find worked: %r %r)rnrkr
rO�bisectrsrh�
IndexError�logger�debugrEr#)rrr$�irrrrR�s


zZipResourceFinder._findcCs&|jj}|jdt|�d�}||fS)Nr)rErlrrm)rrr#rrrrr�sz ZipResourceFinder.get_cache_infocCs|j�|j�Sr,)rE�get_datarrSrrrr4�szZipResourceFinder.get_bytescCst�|�|��Sr,)�io�BytesIOr4rSrrrr/�szZipResourceFinder.get_streamcCs|j|jd�}|j|dS)N�)rrnrkrrrrr5szZipResourceFinder.get_sizecCs�|j|jd�}|r,|dtjkr,|tj7}t|�}t�}t�|j|�}|t|j�kr�|j|�|�shq�|j||d�}|�	|�
tjd�d�|d7}qH|S)Nrtrr)rrnr
rOrmr`rursrh�addrL)rrrZplenr$ry�srrrr:s

zZipResourceFinder.get_resourcescCsj||jd�}|r*|dtjkr*|tj7}t�|j|�}z|j|�|�}Wntk
rdd}YnX|S)NrtF)rnr
rOrursrhrv)rrryr$rrrrTs

zZipResourceFinder._is_directory)r'r(r)r7rrHrRrr4r/r5r:rTr*rrrrrj�srjcCs|tt|�<dSr,)�_finder_registry�type)rE�finder_makerrrr�register_finder0sr�cCs�|tkrt|}nv|tjkr$t|�tj|}t|dd�}|dkrJtd��t|dd�}t�t|��}|dkrxtd|��||�}|t|<|S)z�
    Return a resource finder for a package.
    :param package: The name of the package.
    :return: A :class:`ResourceFinder` instance for the package.
    �__path__Nz8You cannot get a finder for a module, only for a packager@zUnable to locate finder for %r)	�
_finder_cacherf�modules�
__import__rDrr�r&r�)�packager$rCrrEr�rrrr6s


rZ	__dummy__cCsRd}t�|�tj�|�}t�t|��}|rNt}tj	�
|d�|_||_||�}|S)z�
    Return a resource finder for a path, which should represent a container.

    :param path: The path.
    :return: A :class:`ResourceFinder` instance for the path.
    NrB)
�pkgutilZget_importerrf�path_importer_cacher&r�r��
_dummy_moduler
rrrAr@)rr$rErrCrrr�finder_for_pathRs
r�).Z
__future__rrur{Zloggingr
r�Zshutilrf�typesrprBr�utilrrrrZ	getLoggerr'rwr2r	�objectr+r.r9r<rjr��zipimporterr��_frozen_importlib_externalZ_fi�ImportError�_frozen_importlib�SourceFileLoader�
FileFinder�AttributeErrorr�r�r�
ModuleTyper
r�r�rrrr�<module>sN
,!ZN�

site-packages/pip/_vendor/distlib/__pycache__/wheel.cpython-38.pyc000064400000061656151446177000021131 0ustar00U

��.e���@s�ddlmZddlZddlZddlZddlZddlmZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlZddlZddlZddlmZmZddlmZmZmZmZmZddlmZddlm Z m!Z!m"Z"dd	l#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,dd
l-m.Z.m/Z/e�0e1�Z2da3e4ed��r8dZ5n*ej6�7d
��rLdZ5nej6dk�r^dZ5ndZ5e�8d�Z9e9�s�dej:dd�Z9de9Z;e5e9Z<ej#�=��>dd��>dd�Z?e�8d�Z@e@�r�e@�7d��r�e@�>dd�Z@ndd�ZAeA�Z@[Ae�BdejCejDB�ZEe�BdejCejDB�ZFe�Bd�ZGe�Bd �ZHd!ZId"ZJe
jKd#k�rBd$d%�ZLnd&d%�ZLGd'd(�d(eM�ZNeN�ZOGd)d*�d*eM�ZPd+d,�ZQeQ�ZR[Qd/d-d.�ZSdS)0�)�unicode_literalsN)�message_from_file�)�__version__�DistlibException)�	sysconfig�ZipFile�fsdecode�	text_type�filter)�InstalledDistribution)�Metadata�METADATA_FILENAME�WHEEL_METADATA_FILENAME)	�FileOperator�convert_path�	CSVReader�	CSVWriter�Cache�cached_property�get_cache_base�read_exports�tempdir)�NormalizedVersion�UnsupportedVersionErrorZpypy_version_infoZpp�javaZjyZcliZip�cpZpy_version_nodotz%s%s��py�-�_�.ZSOABIzcpython-cCsRdtg}t�d�r|�d�t�d�r0|�d�t�d�dkrH|�d�d	�|�S)
NrZPy_DEBUG�dZ
WITH_PYMALLOC�mZPy_UNICODE_SIZE��u�)�
VER_SUFFIXr�get_config_var�append�join)�parts�r,�=/usr/lib/python3.8/site-packages/pip/_vendor/distlib/wheel.py�_derive_abi;s




r.zz
(?P<nm>[^-]+)
-(?P<vn>\d+[^-]*)
(-(?P<bn>\d+[^-]*))?
-(?P<py>\w+\d+(\.\w+\d+)*)
-(?P<bi>\w+)
-(?P<ar>\w+(\.\w+)*)
\.whl$
z7
(?P<nm>[^-]+)
-(?P<vn>\d+[^-]*)
(-(?P<bn>\d+[^-]*))?$
s
\s*#![^\r\n]*s^(\s*#!("[^"]+"|\S+))\s+(.*)$s#!pythons	#!pythonw�/cCs|S�Nr,��or,r,r-�<lambda>]�r3cCs|�tjd�S)Nr/)�replace�os�sepr1r,r,r-r3_r4c@s6eZdZdd�Zdd�Zdd�Zddd	�Zd
d�ZdS)
�MountercCsi|_i|_dSr0)�
impure_wheels�libs��selfr,r,r-�__init__cszMounter.__init__cCs||j|<|j�|�dSr0)r9r:�update)r<�pathname�
extensionsr,r,r-�addgs
zMounter.addcCs0|j�|�}|D]\}}||jkr|j|=qdSr0)r9�popr:)r<r?r@�k�vr,r,r-�removeks
zMounter.removeNcCs||jkr|}nd}|Sr0)r:)r<�fullname�path�resultr,r,r-�find_moduleqs
zMounter.find_modulecCsj|tjkrtj|}nP||jkr,td|��t�||j|�}||_|�dd�}t|�dkrf|d|_	|S)Nzunable to find extension for %sr!rr)
�sys�modulesr:�ImportError�impZload_dynamic�
__loader__�rsplit�len�__package__)r<rFrHr+r,r,r-�load_modulexs


zMounter.load_module)N)�__name__�
__module__�__qualname__r=rArErIrRr,r,r,r-r8bs

r8c@s�eZdZdZdZdZd4dd�Zedd	��Zed
d��Z	edd
��Z
edd��Zdd�Z
edd��Zdd�Zd5dd�Zdd�Zdd�Zdd�Zd6dd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Zd*d+�Zd7d,d-�Zd.d/�Zd0d1�Zd8d2d3�ZdS)9�Wheelz@
    Class to build and install from Wheel files (PEP 427).
    �rrZsha256NFcCs8||_||_d|_tg|_dg|_dg|_t��|_	|dkrRd|_
d|_|j|_
n�t�|�}|r�|�d�}|d|_
|d�d	d
�|_|d|_|j|_
n�tj�|�\}}t�|�}|s�td|��|r�tj�|�|_	||_
|�d�}|d|_
|d|_|d|_|d
�d�|_|d�d�|_|d�d�|_dS)zB
        Initialise an instance using a (valid) filename.
        r&�none�anyNZdummyz0.1ZnmZvnr rZbnzInvalid name or filename: %rrr!ZbiZar)�signZ
should_verify�buildver�PYVER�pyver�abi�archr6�getcwd�dirname�name�version�filenameZ	_filename�NAME_VERSION_RE�match�	groupdictr5rG�split�FILENAME_REr�abspath)r<rdrZ�verifyr#�inforar,r,r-r=�sD







�



zWheel.__init__cCs^|jrd|j}nd}d�|j�}d�|j�}d�|j�}|j�dd�}d|j|||||fS)zJ
        Build and return a filename from the various components.
        rr&r!r z%s-%s%s-%s-%s-%s.whl)r[r*r]r^r_rcr5rb)r<r[r]r^r_rcr,r,r-rd�s
�zWheel.filenamecCstj�|j|j�}tj�|�Sr0)r6rGr*rard�isfile)r<rGr,r,r-�exists�szWheel.existsccs4|jD](}|jD]}|jD]}|||fVqqqdSr0)r]r^r_)r<r]r^r_r,r,r-�tags�s


z
Wheel.tagscCstj�|j|j�}d|j|jf}d|}t�d�}t	|d���}|�
|�}|d�dd�}tdd	�|D��}|d
kr�t
tdg}	nt
tg}	d}
|	D]f}zLt�||�}|�|��,}
||
�}t|d�}
|
r�W5QR�Wq�W5QRXWq�tk
r�Yq�Xq�|
�std
d�|	���W5QRX|
S)N�%s-%s�%s.dist-info�utf-8�r�
Wheel-Versionr!rcSsg|]}t|��qSr,��int��.0�ir,r,r-�
<listcomp>�sz"Wheel.metadata.<locals>.<listcomp>rWZMETADATA)Zfileobjz8Invalid wheel, because metadata is missing: looked in %sz, )r6rGr*rardrbrc�codecs�	getreaderr�get_wheel_metadatarh�tuplerr�	posixpath�openr
�KeyError�
ValueError)r<r?�name_ver�info_dir�wrapper�zf�wheel_metadata�wv�file_versionZfnsrH�fn�metadata_filename�bf�wfr,r,r-�metadata�s6


�zWheel.metadatac	CsXd|j|jf}d|}t�|d�}|�|��}t�d�|�}t|�}W5QRXt|�S)Nrprq�WHEELrr)	rbrcrr*r�r{r|r�dict)r<r�r�r�r�r�r��messager,r,r-r}�szWheel.get_wheel_metadatac	Cs6tj�|j|j�}t|d��}|�|�}W5QRX|S)Nrs)r6rGr*rardrr})r<r?r�rHr,r,r-rl�sz
Wheel.infocCs�t�|�}|r||��}|d|�||d�}}d|��krBt}nt}t�|�}|rfd|��d}nd}||}||}nT|�d�}|�d�}	|dks�||	kr�d}
n|||d�d	kr�d	}
nd}
t|
|}|S)
Nspythonw� ���r4�
�
rrs
)	�
SHEBANG_RErf�end�lower�SHEBANG_PYTHONW�SHEBANG_PYTHON�SHEBANG_DETAIL_RE�groups�find)r<�datar#r�ZshebangZdata_after_shebangZshebang_python�argsZcrZlfZtermr,r,r-�process_shebangs,




zWheel.process_shebangcCsh|dkr|j}ztt|�}Wn tk
r<td|��YnX||���}t�|��d��	d�}||fS)NzUnsupported hash algorithm: %r�=�ascii)
�	hash_kind�getattr�hashlib�AttributeErrorr�digest�base64Zurlsafe_b64encode�rstrip�decode)r<r�r��hasherrHr,r,r-�get_hash"szWheel.get_hashc	Cs^t|�}ttj�||��}|�|ddf�|��t|��}|D]}|�|�q@W5QRXdS)Nr&)	�list�to_posixr6rG�relpathr)�sortrZwriterow)r<�recordsZrecord_path�base�p�writer�rowr,r,r-�write_record-s
zWheel.write_recordc
Cs�g}|\}}tt|j�}|D]P\}}	t|	d��}
|
��}W5QRXd|�|�}tj�|	�}
|�	|||
f�qtj�
|d�}	|�||	|�ttj�
|d��}|�	||	f�dS)N�rbz%s=%s�RECORD)
r�r�r�r��readr�r6rG�getsizer)r*r�r�)r<rl�libdir�
archive_pathsr��distinfor�r��apr��fr�r��sizer,r,r-�
write_records6szWheel.write_recordsc	CsFt|dtj��.}|D]"\}}t�d||�|�||�qW5QRXdS)N�wzWrote %s to %s in wheel)r�zipfileZZIP_DEFLATED�logger�debug�write)r<r?r�r�r�r�r,r,r-�	build_zipFszWheel.build_zipc!s~|dkri}tt�fdd�d��d}|dkrFd}tg}tg}tg}nd}tg}d	g}d
g}|�d|�|_|�d|�|_|�d
|�|_	�|}	d|j
|jf}
d|
}d|
}g}
dD]�}|�kr�q��|}tj
�|�r�t�|�D]�\}}}|D]�}ttj
�||��}tj
�||�}ttj
�|||��}|
�||f�|dkr�|�d�s�t|d��}|��}W5QRX|�|�}t|d��}|�|�W5QRXq�q�q�|	}d}t�|�D]�\}}}||k�rt|�D]8\}}t|�}|�d��r�tj
�||�}||=�q��q�|�std��|D]H}t|��d��r(�qtj
�||�}ttj
�||��}|
�||f��q�q�t�|�}|D]B}|dk�rlttj
�||��}ttj
�||��}|
�||f��qld|�p�|jdtd|g}|jD] \}}}|�d|||f��q�tj
�|d�}t|d��}|�d �|��W5QRXttj
�|d��}|
�||f�|� ||f|	|
�tj
�|j!|j"�} |�#| |
�| S)!z�
        Build a wheel from files in specified paths, and use any specified tags
        when determining the name of the wheel.
        Ncs|�kSr0r,r1��pathsr,r-r3Tr4zWheel.build.<locals>.<lambda>)�purelib�platlibrr�Zfalse�truerXrYr]r^r_rp�%s.datarq)r�Zheaders�scriptsr��.exer��wbz
.dist-infoz(.dist-info directory expected, not found)z.pycz.pyo)r�Z	INSTALLERZSHAREDr�zWheel-Version: %d.%dzGenerator: distlib %szRoot-Is-Purelib: %sz
Tag: %s-%s-%sr�r��
)$r�r�IMPVER�ABI�ARCHr\�getr]r^r_rbrcr6rG�isdir�walkr	r*r�r�r)�endswithr�r�r�r��	enumerate�AssertionError�listdir�
wheel_versionrror�rardr�)!r<r�ror�ZlibkeyZis_pureZ
default_pyverZdefault_abiZdefault_archr�r��data_dirr�r��keyrG�root�dirs�filesr�r��rpr�r�r�r�ry�dnr�r]r^r_r?r,r�r-�buildLs�




�zWheel.buildcCs
|�d�S)zl
        Determine whether an archive entry should be skipped when verifying
        or installing.
        )r/z/RECORD.jws)r�)r<�arcnamer,r,r-�
skip_entry�szWheel.skip_entrycCKsf|j}|�d�}|�dd�}|�dd�}tj�|j|j�}d|j|jf}	d|	}
d|	}t	�|t
�}t	�|d�}
t	�|d	�}t�d
�}t
|d����}|�|
��}||�}t|�}W5QRX|d�d
d�}tdd�|D��}||jkr�|r�||j|�|ddk�r|d}n|d}i}|�|��8}t|d��"}|D]}|d}|||<�q8W5QRXW5QRXt	�|
d�}t	�|d�}t	�|
dd�}t|d�}d|_tj} g}!t��}"|"|_d|_�z��z\|��D�]�}#|#j}$t|$t ��r�|$}%n
|$�!d
�}%|�"|%��r�q�||%}|d�r4t#|#j$�|dk�r4t%d|%��|d�r�|d�dd�\}&}'|�|$��}|�&�}(W5QRX|�'|(|&�\})}*|*|'k�r�t%d|$��|�r�|%�(||f��r�t)�*d |%��q�|%�(|��o�|%�+d!�}+|%�(|��r
|%�d"d�\})},}-tj�||,t,|-��}.n$|%|
|fk�r�q�tj�|t,|%��}.|+�s
|�|$��}|�-||.�W5QRX|!�.|.�|�s�|d�r�t|.d#��4}|�&�}(|�'|(|&�\})}/|/|*k�r�t%d$|.��W5QRX| �r~|.�+d%��r~z|j/|.|d&�}0|!�.|0�Wn$t0k
�rt)j1d'dd(�YnXnttj�2t,|$��}1tj�|"|1�}2|�|$��}|�-||2�W5QRXtj�|.�\}3}1|3|_|�3|1�}4|�4|4�|!�5|4��q�|�r�t)�*d)�d}5�nnd}6|j6d}|d*k�rzt	�|d+�}7z�|�|7��}t7|�}8W5QRXi}6d,D]l}9d-|9}:|:|8k�r�i|6d.|9<};|8|:�8�D]6}<d/|<j9|<j:f}=|<j;�rB|=d0|<j;7}=|=|;|<j<�q�q�Wn t0k
�rvt)�1d1�YnXndzB|�|��.}||�}t<�=|��d2�}6|6�r�|6�d3�}6W5QRXWn t0k
�r�t)�1d4�YnX|6�r�|6�d5i�}>|6�d6i�}?|>�s|?�r�|�dd�}@tj�>|@��s*t?d7��|@|_|>�@�D]*\}:}<d8|:|<f}A|�3|A�}4|�4|4��q8|?�r�d9di}B|?�@�D],\}:}<d8|:|<f}A|�3|A|B�}4|�4|4��qztj�||�}tA|�}5tB|�}|d=|d=||d:<|5�C||�}|�r�|!�.|�|5�D|!|d;|�|5WW�<W5QR�St0k
�rFt)�Ed<�|�F��YnXW5t�|"�XW5QRXdS)=a~
        Install a wheel to the specified paths. If kwarg ``warner`` is
        specified, it should be a callable, which will be called with two
        tuples indicating the wheel version of this software and the wheel
        version in the file, if there is a discrepancy in the versions.
        This can be used to issue any warnings to raise any exceptions.
        If kwarg ``lib_only`` is True, only the purelib/platlib files are
        installed, and the headers, scripts, data and dist-info metadata are
        not written. If kwarg ``bytecode_hashed_invalidation`` is True, written
        bytecode will try to use file-hash based invalidation (PEP-552) on
        supported interpreter versions (CPython 2.7+).

        The return value is a :class:`InstalledDistribution` instance unless
        ``options.lib_only`` is True, in which case the return value is ``None``.
        �warner�lib_onlyFZbytecode_hashed_invalidationrpr�rqr�r�rrrsrtr!rcSsg|]}t|��qSr,rurwr,r,r-rz�sz!Wheel.install.<locals>.<listcomp>zRoot-Is-Purelibr�r�r���streamrr&r�)�dry_runTNr�size mismatch for %s�=�digest mismatch for %szlib_only: skipping %sr�r/r�zdigest mismatch on write for %sz.py)Zhashed_invalidationzByte-compilation failed)�exc_infozlib_only: returning Nonez1.0zentry_points.txt)Zconsole�guiz
%s_scriptszwrap_%sz%s:%sz %szAUnable to read legacy script metadata, so cannot generate scriptsr@zpython.commandsz8Unable to read JSON metadata, so cannot generate scriptsZwrap_consoleZwrap_guizValid script path not specifiedz%s = %sr��lib�prefixzinstallation failed.)Gr�r�r6rGr*rardrbrcrrr{r|rr�rrhr~r�rr�recordrJ�dont_write_bytecode�tempfileZmkdtempZ
source_dirZ
target_dir�shutilZrmtree�infolist�
isinstancer
r�r��str�	file_sizerr�r��
startswithr�r�r�rZcopy_streamr)Zbyte_compile�	ExceptionZwarning�basenameZmakeZset_executable_mode�extendrlr�valuesr��suffix�flags�json�loadr�r��itemsrr�Zwrite_shared_locationsZwrite_installed_filesZ	exceptionZrollback)Cr<r�Zmaker�kwargsr�r�r�Zbc_hashed_invalidationr?r�r�r��
metadata_name�wheel_metadata_name�record_namer�r��bwfr�r�r�r�r�r�r��readerr�r�Zdata_pfxZinfo_pfxZ
script_pfxZfileopZbcZoutfiles�workdir�zinfor��	u_arcname�kind�valuer�r r�Z	is_script�wherer�ZoutfileZ	newdigestZpycr�Zworknamer��	filenamesZdistZcommandsZepZepdatar�rCr"rD�sZconsole_scriptsZgui_scriptsZ
script_dirZscriptZoptionsr,r,r-�install�sT


 

�

�
�

���







�
z
Wheel.installcCs4tdkr0tj�t�td�tjdd��}t|�atS)Nzdylib-cache�)	�cacher6rGr*rr�rJrcr)r<r�r,r,r-�_get_dylib_cache�s�zWheel._get_dylib_cachec
Cshtj�|j|j�}d|j|jf}d|}t�|d�}t�	d�}g}t
|d���}z�|�|���}||�}	t�
|	�}
|��}|�|�}tj�|j|�}
tj�|
�s�t�|
�|
��D]�\}}tj�|
t|��}tj�|�s�d}n6t�|�j}tj�|�}|�|�}tj|j�}||k}|�r&|�||
�|�||f�q�W5QRXWntk
�rXYnXW5QRX|S)NrprqZ
EXTENSIONSrrrsT)r6rGr*rardrbrcrr{r|rr�rrrZ
prefix_to_dirr�r��makedirsrrrn�stat�st_mtime�datetimeZ
fromtimestampZgetinfoZ	date_time�extractr)r�)r<r?r�r�r�r�rHr�r�r�r@rr�Z
cache_baserbr��destrZ	file_timerlZ
wheel_timer,r,r-�_get_extensions�s>




zWheel._get_extensionscCst|�S)zM
        Determine if a wheel is compatible with the running system.
        )�
is_compatibler;r,r,r-r�szWheel.is_compatiblecCsdS)zP
        Determine if a wheel is asserted as mountable by its metadata.
        Tr,r;r,r,r-�is_mountable�szWheel.is_mountablecCs�tj�tj�|j|j��}|��s2d|}t|��|��sJd|}t|��|t	jkrbt
�d|�nN|rtt	j�|�nt	j�
d|�|��}|r�tt	jkr�t	j�t�t�||�dS)Nz)Wheel %s not compatible with this Python.z$Wheel %s is marked as not mountable.z%s already in pathr)r6rGrjr*rardrrrrJr�r�r)�insertr�_hook�	meta_pathrA)r<r)r?�msgr@r,r,r-�mount�s"

zWheel.mountcCsrtj�tj�|j|j��}|tjkr2t�d|�n<tj�	|�|t
jkrRt
�	|�t
jsnt
tjkrntj�	t
�dS)Nz%s not in path)
r6rGrjr*rardrJr�r�rEr!r9r")r<r?r,r,r-�unmount�s



z
Wheel.unmountcCstj�|j|j�}d|j|jf}d|}d|}t�|t�}t�|d�}t�|d�}t	�
d�}t|d����}	|	�|��}
||
�}t
|�}W5QRX|d�d	d
�}
tdd�|
D��}i}|	�|��6}t|d
�� }|D]}|d}|||<q�W5QRXW5QRX|	��D]�}|j}t|t��r$|}n
|�d�}|�d�}d|k�rNtd|��|�|��r^�q||}|d�r�t|j�|dk�r�td|��|d
�r|d
�dd
�\}}|	�|��}|��}W5QRX|�||�\}}||k�rtd|���qW5QRXdS)Nrpr�rqr�r�rrrsrtr!rcSsg|]}t|��qSr,rurwr,r,r-rzsz Wheel.verify.<locals>.<listcomp>r�rr/�..�invalid entry in wheel: %rrr�r�r�)r6rGr*rardrbrcrrr{r|rr�rrhr~rr�r�r
r�rr�r�r�r�r�)r<r?r�r�r�rrrr�r�r	r�r�r�r�r�r�r
r�r�rr�r
rrr�r r�r,r,r-rks\



��

�zWheel.verifyc
Ks�dd�}dd�}tj�|j|j�}d|j|jf}d|}t�|d�}	t����}
t	|d��|}i}|�
�D]h}
|
j}t|t�r�|}n
|�
d	�}||	kr�qhd
|kr�td|��|�|
|
�tj�|
t|��}|||<qhW5QRX|||�\}}||f|�}|�r�|||�\}}|�r$||k�r$|||�|dk�rNtjd
d|
d�\}}t�|�n*tj�|��shtd|��tj�||j�}t|���}tj�|
|�}||f}|�||
|�|�||�|dk�r�t�||�W5QRX|S)a�
        Update the contents of a wheel in a generic way. The modifier should
        be a callable which expects a dictionary argument: its keys are
        archive-entry paths, and its values are absolute filesystem paths
        where the contents the corresponding archive entries can be found. The
        modifier is free to change the contents of the files pointed to, add
        new entries and remove entries, before returning. This method will
        extract the entire contents of the wheel to a temporary location, call
        the modifier, and then use the passed (and possibly updated)
        dictionary to write a new wheel. If ``dest_dir`` is specified, the new
        wheel is written there -- otherwise, the original wheel is overwritten.

        The modifier should return True if it updated the wheel, else False.
        This method returns the same value the modifier returns.
        cSsHd}}d|tf}||kr$d|}||kr@||}t|d�j}||fS)Nz%s/%sz%s/PKG-INFO�rG)rr
rc)�path_mapr�rcrGr�r,r,r-�get_versionKsz!Wheel.update.<locals>.get_versioncSs�d}z|t|�}|�d�}|dkr*d|}nTdd�||dd��d�D�}|dd7<d	|d|�d�d
d�|D��f}Wn tk
r�t�d|�YnX|r�t|d
�}||_|�	t
�}|j||d�t�d||�dS)Nrrz%s+1cSsg|]}t|��qSr,ru)rxrr,r,r-rz]sz8Wheel.update.<locals>.update_version.<locals>.<listcomp>rr!r�z%s+%scss|]}t|�VqdSr0)r�rwr,r,r-�	<genexpr>`sz7Wheel.update.<locals>.update_version.<locals>.<genexpr>z0Cannot update non-compliant (PEP-440) version %rr()rG�legacyzVersion updated from %r to %r)rr�rhr*rr�r�r
rcr�rr�)rcrG�updatedrDryr+Zmdr,r,r,r-�update_versionUs.

 �
�

�z$Wheel.update.<locals>.update_versionrprqr�rsrrr&r'Nz.whlz
wheel-update-)rr��dirzNot a directory: %r)r6rGr*rardrbrcrrrr�r�r
r�rrrr�Zmkstemp�closer�r�rr�r�r�Zcopyfile)r<ZmodifierZdest_dirrr*r.r?r�r�rrr�r)rr�r
rGZoriginal_versionr ZmodifiedZcurrent_version�fd�newpathr�r�rlr,r,r-r>:s\



�

�

zWheel.update)NFF)N)NN)F)N)rSrTrU�__doc__r�r�r=�propertyrdrnrorr�r}rlr�r�r�r�r�r�r�rrrrrr$r%rkr>r,r,r,r-rV�s@
)



	

	
hg	"
8rVc	Csxtg}td}ttjdddd�D]}|�d�|t|�g��q$g}t��D]*\}}}|�	d�rN|�|�
dd�d�qN|��tdkr�|�
dt�|�d�g}tg}tjd	k�r�t�d
t�}|�r�|��\}	}}}
t|�}|
g}|
dkr�|�d�|
d
k�r|�d�|
dk�r |�d�|
dk�r4|�d�|
dk�rH|�d�|dk�r�|D]*}d|	|||f}
|
tk�rV|�|
��qV|d8}�qH|D]0}|D]$}
|�d�t|df�||
f��q��q�t|�D]L\}}|�d�t|f�ddf�|dk�r�|�d�t|df�ddf��q�t|�D]L\}}|�d�d|f�ddf�|dk�r"|�d�d|df�ddf��q"t|�S)zG
    Return (pyver, abi, arch) tuples compatible with this Python.
    rrr�r&z.abir!rrX�darwinz(\w+)_(\d+)_(\d+)_(\w+)$)�i386�ppcZfat)r6r7�x86_64Zfat3)�ppc64r8Zfat64)r6r8�intel)r6r8r:r7r9Z	universalz%s_%s_%s_%srYr)r'�rangerJ�version_infor)r*r�rMZget_suffixesr�rhr�r�r r��platform�rerfr�rv�
IMP_PREFIXr��set)Zversions�major�minorZabisrr rHZarchesr#rbr_Zmatchesrfrr^ryrcr,r,r-�compatible_tags�s`












&
"
"rCcCs\t|t�st|�}d}|dkr"t}|D]0\}}}||jkr&||jkr&||jkr&d}qXq&|S)NFT)r�rV�COMPATIBLE_TAGSr]r^r_)ZwheelrorHZverr^r_r,r,r-r�s
r)N)TZ
__future__rr�r{rZdistutils.utilZ	distutilsZemailrr�rMrZloggingr6rr>r�rJr�r�r&rr�compatrrr	r
rZdatabaserr�r
rr�utilrrrrrrrrrrcrrZ	getLoggerrSr�r�hasattrr?r=r�r(r'r<r\r�Zget_platformr5r�r�r.�compile�
IGNORECASE�VERBOSErirer�r�r�r�r7r��objectr8r!rVrCrDrr,r,r,r-�<module>s�,


	
�

�


#>site-packages/pip/_vendor/distlib/__pycache__/scripts.cpython-38.opt-1.pyc000064400000025002151446177000022434 0ustar00U

��.e�?�@s�ddlmZddlZddlZddlZddlZddlZddlmZm	Z	m
Z
ddlmZddl
mZmZmZmZmZe�e�Zd��Ze�d�Zd	Zd
d�ZGdd
�d
e�ZdS)�)�BytesION�)�	sysconfig�detect_encoding�ZipFile)�finder)�FileOperator�get_export_entry�convert_path�get_executable�in_venva�
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
 <assemblyIdentity version="1.0.0.0"
 processorArchitecture="X86"
 name="%s"
 type="win32"/>

 <!-- Identify the application security requirements. -->
 <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
 <security>
 <requestedPrivileges>
 <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
 </requestedPrivileges>
 </security>
 </trustInfo>
</assembly>s^#!.*pythonw?[0-9.]*([ 	].*)?$z�# -*- coding: utf-8 -*-
import re
import sys
from %(module)s import %(import_name)s
if __name__ == '__main__':
    sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
    sys.exit(%(func)s())
cCsXd|krT|�d�rB|�dd�\}}d|krT|�d�sTd||f}n|�d�sTd|}|S)N� z
/usr/bin/env r�"z%s "%s"z"%s")�
startswith�split)�
executable�envZ_executable�r�?/usr/lib/python3.8/site-packages/pip/_vendor/distlib/scripts.py�_enquote_executable3s

rc@s�eZdZdZeZdZd'dd�Zdd�Ze	j
�d	�rBd
d�Zdd
�Z
dd�Zd(dd�Zdd�ZeZdd�Zdd�Zd)dd�Zdd�Zedd��Zejdd��Zejd ks�ejd	kr�ejd kr�d!d"�Zd*d#d$�Zd+d%d&�ZdS),�ScriptMakerz_
    A class to copy or create scripts from source scripts or callable
    specifications.
    NTFcCsz||_||_||_d|_d|_tjdkp:tjdko:tjdk|_t	d�|_
|pRt|�|_tjdkprtjdkortjdk|_
dS)NF�posix�java)��X.Y�nt)�
source_dir�
target_dir�
add_launchers�force�clobber�os�name�_name�set_mode�set�variantsr�_fileop�_is_nt)�selfrrr�dry_runZfileoprrr�__init__Ls�

�zScriptMaker.__init__cCs@|�dd�r<|jr<tj�|�\}}|�dd�}tj�||�}|S)N�guiF�pythonZpythonw)�getr(r!�pathr�replace�join)r)r�optionsZdn�fnrrr�_get_alternate_executable\s
z%ScriptMaker._get_alternate_executablerc
Cs\z0t|��}|�d�dkW5QR�WSQRXWn&ttfk
rVt�d|�YdSXdS)zl
            Determine if the specified executable is a script
            (contains a #! line)
            �z#!zFailed to open %sFN)�open�read�OSError�IOError�logger�warning)r)r�fprrr�	_is_shellds
&zScriptMaker._is_shellcCsD|�|�r*ddl}|jj�d�dkr<|Sn|���d�r<|Sd|S)Nrzos.nameZLinuxz
jython.exez/usr/bin/env %s)r=rZlangZSystemZgetProperty�lower�endswith)r)rrrrr�_fix_jython_executableps
z"ScriptMaker._fix_jython_executablecCs�tjdkrd}n8t|�t|�d}tjdkr4d}nd}d|koF||k}|r^d||d	}n d
}|d||d7}|d
7}|S)a
        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
        rT��darwini�� s#!�
s
#!/bin/sh
s	'''exec' s "$0" "$@"
s' ''')r!r"�len�sys�platform)r)r�post_interpZsimple_shebangZshebang_lengthZmax_shebang_length�resultrrr�_build_shebang|s

�zScriptMaker._build_shebang�cCs`d}|jr|j}d}n^t��s&t�}nNt�rLtj�t�d�dt�	d��}n(tj�t�	d�dt�	d�t�	d�f�}|r�|�
||�}tj�
d	�r�|�|�}tj�|�}|r�t|�}|�d
�}tjdkr�d|kr�d
|kr�|d7}|�||�}z|�d
�Wn"tk
�rtd|��YnX|d
k�r\z|�|�Wn&tk
�rZtd||f��YnX|S)NTFZscriptszpython%sZEXEZBINDIRz
python%s%sZVERSIONr�utf-8Zcliz	-X:Framesz
-X:FullFramess
 -X:Framesz,The shebang (%r) is not decodable from utf-8z?The shebang (%r) is not decodable from the script encoding (%r))rrZis_python_buildrrr!r/r1Zget_pathZget_config_varr4rGrHrr@�normcaser�encoderK�decode�UnicodeDecodeError�
ValueError)r)�encodingrIr2Zenquoter�shebangrrr�_get_shebang�sZ�
��

��

��
zScriptMaker._get_shebangcCs$|jt|j|j�d�d|jd�S)N�.r)�moduleZimport_name�func)�script_template�dict�prefix�suffixr)r)�entryrrr�_get_script_text�s
�zScriptMaker._get_script_textcCstj�|�}|j|S�N)r!r/�basename�manifest)r)Zexename�baserrr�get_manifest�szScriptMaker.get_manifestcCs�|jo
|j}tj�d�}|�|�s*||7}|s8||}nZ|dkrL|�d�}n
|�d�}t�}	t|	d��}
|
�	d|�W5QRX|	�
�}|||}|D�]V}tj�|j
|�}
|�rxtj�|
�\}}|�d�r�|}
d|
}
z|j�|
|�Wn�tk
�rtt�d�d	|
}tj�|��r&t�|�t�|
|�|j�|
|�t�d
�zt�|�Wntk
�rnYnXYnXnl|j�r�|
�d|��s�d|
|f}
tj�|
��r�|j�s�t�d
|
�q�|j�|
|�|j�r�|j�|
g�|�|
�q�dS)NrM�py�t�wz__main__.pyz.pyz%s.exez:Failed to write executable - trying to use .deleteme logicz%s.deletemez0Able to replace executable using .deleteme logicrVz%s.%szSkipping existing file %s)rr(r!�lineseprOr?�
_get_launcherrrZwritestr�getvaluer/r1r�splitextrr'Zwrite_binary_file�	Exceptionr:r;�exists�remove�rename�debugr r$�set_executable_mode�append)r)�namesrTZscript_bytes�	filenames�extZuse_launcherrgZlauncher�streamZzfZzip_datar"�outname�n�eZdfnamerrr�
_write_script�sX







zScriptMaker._write_scriptcCs�d}|r0|�dg�}|r0dd�|�}|�d�}|jd||d�}|�|��d�}|j}t�}	d|jkrp|	�|�d|jkr�|	�d	|t	j
d
f�d|jkr�|	�d|t	j
dd
�f�|r�|�dd�r�d}
nd}
|�|	||||
�dS)NrLZinterpreter_argsz %sr
rM�r2r�Xz%s%srrz%s-%srAr,F�pywrd)r.r1rOrUr^r"r%r&�addrG�versionry)r)r]rsr2rI�argsrT�scriptr"Zscriptnamesrtrrr�_make_scripts(




zScriptMaker._make_scriptcCs�d}tj�|jt|��}tj�|jtj�|��}|jsT|j�	||�sTt
�d|�dSzt|d�}Wn t
k
r�|jsz�d}YnLX|��}|s�t
�d|��|�dSt�|�dd��}|r�d}|�d�p�d	}|�s|r�|��|j�||�|j�r|j�|g�|�|�n�t
�d
||j�|jj�s�t|j�\}	}
|�d�|�|	|�}d|k�r^d
}nd}tj�|�}
|�|
g||� �||�|�r�|��dS)NFznot copying %s (up-to-date)�rbz"%s: %s is an empty file (skipping)s
rETrrLzcopying and adjusting %s -> %srspythonwr|rd)!r!r/r1rr
rr`rr'Znewerr:ror6r9r*�readliner;Zget_command_name�
FIRST_LINE_RE�matchr0�group�closeZ	copy_filer$rprq�infor�seekrUryr7)r)r�rsZadjustrv�fZ
first_liner�rIrS�linesrTrtrwrrr�_copy_script)sX
��


zScriptMaker._copy_scriptcCs|jjSr_�r'r*)r)rrrr*]szScriptMaker.dry_runcCs||j_dSr_r�)r)�valuerrrr*asrcCsHt�d�dkrd}nd}d||f}t�dd�d}t|��|�j}|S)	N�P�Z64Z32z%s%s.exerVrr)�struct�calcsize�__name__�rsplitr�find�bytes)r)Zkind�bitsr"Zdistlib_packagerJrrrrhiszScriptMaker._get_launchercCs6g}t|�}|dkr"|�||�n|j|||d�|S)a�
        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.
        Nrz)r	r�r�)r)�
specificationr2rsr]rrr�makewszScriptMaker.makecCs$g}|D]}|�|�||��q|S)z�
        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,
        )�extendr�)r)Zspecificationsr2rsr�rrr�
make_multiple�szScriptMaker.make_multiple)TFN)rLN)N)N)N) r��
__module__�__qualname__�__doc__�SCRIPT_TEMPLATErYrr+r4rGrHrr=r@rKrUr^�_DEFAULT_MANIFESTrarcryr�r��propertyr*�setterr!r"r#rhr�r�rrrrrCs6�

84
4


r)�iorZloggingr!�rer�rG�compatrrrZ	resourcesr�utilrr	r
rrZ	getLoggerr�r:�stripr��compiler�r�r�objectrrrrr�<module>s


site-packages/pip/_vendor/distlib/__pycache__/__init__.cpython-38.pyc000064400000002004151446177000021542 0ustar00U

��.eK�@snddlZdZGdd�de�ZzddlmZWn&ek
rRGdd�dej�ZYnXe�e�Z	e	�
e��dS)�Nz0.2.9.post0c@seZdZdS)�DistlibExceptionN)�__name__�
__module__�__qualname__�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/distlib/__init__.pyrsr)�NullHandlerc@s$eZdZdd�Zdd�Zdd�ZdS)rcCsdS�Nr��self�recordrrr�handle�zNullHandler.handlecCsdSr	rr
rrr�emitrzNullHandler.emitcCs
d|_dSr	)�lock)rrrr�
createLockrzNullHandler.createLockN)rrrr
rrrrrrrsr)Zlogging�__version__�	Exceptionrr�ImportErrorZHandlerZ	getLoggerrZloggerZ
addHandlerrrrr�<module>s
site-packages/pip/_vendor/distlib/__pycache__/util.cpython-38.pyc000064400000136475151446177000021004 0ustar00U

��.e���@s�ddlZddlmZddlZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZzddlZWnek
r�dZYnXddlZddlZddlZddlZddlZzddlZWnek
r�ddlZYnXddlZddlmZddlmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.m/Z/m0Z0e
�1e2�Z3e
�4d�Z5e
�4d�Z6e
�4d	�Z7e
�4d
�Z8e
�4d�Z9e
�4d�Z:e
�4d
�Z;e
�4d�Z<dd�Z=dd�Z>dd�Z?dd�Z@dd�ZAd�dd�ZBdd�ZCdd�ZDdd �ZEejFd!d"��ZGejFd#d$��ZHejFd�d&d'��ZIGd(d)�d)eJ�ZKd*d+�ZLGd,d-�d-eJ�ZMd.d/�ZNGd0d1�d1eJ�ZOe
�4d2e
jP�ZQd3d4�ZRd�d5d6�ZSd7d8�ZTd9d:�ZUd;d<�ZVd=d>�ZWd?d@�ZXe
�4dAe
jY�ZZe
�4dB�Z[d�dCdD�Z\e
�4dE�Z]dFdG�Z^dHdI�Z_dJdK�Z`dLZadMdN�ZbdOdP�ZcGdQdR�dReJ�ZdGdSdT�dTeJ�ZeGdUdV�dVeJ�ZfdWZgd�dYdZ�Zhd[d\�Zid]ZjGd^d_�d_eJ�Zke
�4d`�Zle
�4da�Zme
�4db�Zndcdd�Zdedf�Zoe�r�ddglmpZqmrZrmsZsGdhdi�die$jt�ZtGdjdk�dkeq�ZpGdldm�dmepe'�Zuejvddn�Zwewdok�rGdpdq�dqe$jx�Zxe�rGdrds�dse$jy�ZyGdtdu�due%jz�Zze�rBGdvdw�dwe%j{�Z{Gdxdy�dye%j|�Z|dzd{�Z}Gd|d}�d}eJ�Z~Gd~d�de~�ZGd�d��d�e~�Z�Gd�d��d�e(�Z�Gd�d��d�eJ�Z�d�d��Z�dS)��N)�deque)�iglob�)�DistlibException)�string_types�	text_type�shutil�	raw_input�StringIO�cache_from_source�urlopen�urljoin�httplib�	xmlrpclib�	splittype�HTTPHandler�BaseConfigurator�valid_ident�	Container�configparser�URLError�ZipFile�fsdecode�unquote�urlparsez^([\w\.-]+)\s*z^([\w\.*+-]+)\s*z^(<=?|>=?|={2,3}|[~!]=)\s*z*^((<=?)|(>=?)|={2,3}|[~!]=|in|not\s+in)\s*z^or\b\s*z	^and\b\s*z(\S+)\s*z(([\s\w\.{}()*+#:;,/?!~`@$%^&=|<>\[\]-]+)cs6dd����fdd���fdd���fdd���|�S)	ae
    Parse a marker string and return a dictionary containing a marker expression.

    The dictionary will contain keys "op", "lhs" and "rhs" for non-terminals in
    the expression grammar, or strings. A string contained in quotes is to be
    interpreted as a literal string, and a string not contained in quotes is a
    variable (such as os_name).
    cSs.t�|�}|r,|��d}||��d�}n�|s:td��n�|d}|dkrVtd|��d�|d�}|dd�}|g}|r�|d|kr��qqt|d|kr�|�|�|dd�}qtt�|�}|s�td|��|�|��d�||��d�}qtd�|�}td|��|�|�d�|�}|dd��	�}||fS)	Nrzunexpected end of inputz'"zinvalid expression: %s�rzerror in string literal: %szunterminated string: %s)
�
IDENTIFIER�match�groups�end�SyntaxError�replace�append�STRING_CHUNK�join�lstrip)�	remaining�m�result�qZoq�parts�s�r,�</usr/lib/python3.8/site-packages/pip/_vendor/distlib/util.py�
marker_varAs:






z parse_marker.<locals>.marker_varcs�|rR|ddkrR�|dd����\}}|ddkr@td|��|dd���}nZ�|�\}}|r�t�|�}|srq�|��d}||��d�}�|�\}}|||d�}q^|}||fS)Nr�(r�)�unterminated parenthesis: %s��op�lhs�rhs)r%r �	MARKER_OPrrr)r&r(r4r'r3r5)�markerr.r,r-�marker_expres 
z!parse_marker.<locals>.marker_exprcsR�|�\}}|rJt�|�}|s qJ||��d�}�|�\}}d||d�}q||fS)N�andr2)�ANDrr�r&r4r'r5)r8r,r-�
marker_andxs
z parse_marker.<locals>.marker_andcsR�|�\}}|rJt�|�}|s qJ||��d�}�|�\}}d||d�}q||fS)N�orr2)�ORrrr;)r<r,r-r7�s
zparse_marker.<locals>.markerr,)Z
marker_stringr,)r7r<r8r.r-�parse_marker8s
	$r?cCs0|��}|r|�d�rdSt�|�}|s4td|��|��d}||��d�}d}}}}|�r:|ddk�r:|�dd�}|dkr�td|��|d|�}	||dd���}g}|	�r0t�|	�}|s�td	|	��|�	|��d�|	|��d�}	|	�s�q0|	dd
k�rtd|	��|	dd���}	q�|�s:d}|�r�|ddk�r�|dd���}t
�|�}|�sztd
|��|��d}t|�}
|
j�r�|
j
�s�td|��||��d���}n�dd�}|ddk�r�||�\}}n�|�dd�}|dk�rtd|��|d|�}	||dd���}t�|	��r@||	�\}}nXt�|	�}|�s\td|	��|��d}
|	|��d���}	|	�r�td|	��d|
fg}|�r�|ddk�r�td|��|dd���}t|�\}}|�r�|ddk�r�td|��|�s|}nd|d�dd�|D��f}t||||||d�S)z�
    Parse a requirement passed in as a string. Return a Container
    whose attributes contain the various parts of the requirement.
    �#Nzname expected: %sr�[�]rzunterminated extra: %szmalformed extra: %s�,zcomma expected in extras: %s�@zinvalid URI: %szInvalid URL: %scSs�t�|�}d}|r�g}|��d}||��d�}t�|�}|sLtd|��|��d}|�||f�||��d�}|r�|ddkr�q�|dd���}t�|�}|std|��q|s�d}||fS)z|
                Return a list of operator, version tuples if any are
                specified, else None.
                Nrzinvalid version: %srCr�invalid constraint: %s)�
COMPARE_OPrrr�VERSION_IDENTIFIERr r"r%)Z
ver_remainingr'�versionsr3�vr,r,r-�get_versions�s*


z'parse_requirement.<locals>.get_versionsr/r0r1rEz~=�;zinvalid requirement: %szunexpected trailing data: %s�%s %s�, cSsg|]}d|�qS)rLr,)�.0Zconr,r,r-�
<listcomp>sz%parse_requirement.<locals>.<listcomp>)�name�extrasZconstraintsr7�urlZrequirement)�strip�
startswithrrr rr�findr%r"�	NON_SPACEr�scheme�netlocrFrGr?r$r)�reqr&r'ZdistnamerQZ	mark_exprrH�uri�ir+�trJ�_rIZrsr,r,r-�parse_requirement�s�





�r^cCs�dd�}i}|D]�\}}}tj�||�}t|�D]p}tj�||�}	t|	�D]T}
|||
�}|dkrn|�|d�qJ|||
�}|�tjjd��d�}
|
d|||<qJq0q|S)z%Find destinations for resources filescSsD|�tjjd�}|�tjjd�}|�|�s.t�|t|�d��d�S�N�/)r!�os�path�seprT�AssertionError�lenr%)�rootrbr,r,r-�get_rel_path
sz)get_resources_dests.<locals>.get_rel_pathNr`)rarbr$r�popr!rc�rstrip)Zresources_rootZrulesrgZdestinations�base�suffix�dest�prefixZabs_baseZabs_globZabs_pathZ
resource_fileZrel_pathZrel_destr,r,r-�get_resources_dests
s

rncCs(ttd�rd}ntjttdtj�k}|S)NZreal_prefixT�base_prefix)�hasattr�sysrm�getattr�r(r,r,r-�in_venv$s
rtcCs$tj�tj�}t|t�s t|�}|S�N)rarb�normcaserq�
executable�
isinstancerrrsr,r,r-�get_executable.s

rycCsN|}t|�}|}|s|r|}|r|d��}||kr6qJ|rd|||f}q|S)Nrz	%c: %s
%s)r	�lower)�promptZ
allowed_charsZerror_prompt�default�pr+�cr,r,r-�proceed>srcCs8t|t�r|��}i}|D]}||kr||||<q|Sru)rxr�split)�d�keysr(�keyr,r,r-�extract_by_keyNs
r�cCsztjddkrt�d�|�}|��}t|�}zlt�|�}|ddd}|��D]B\}}|��D]0\}}d||f}t	|�}	|	dk	s�t
�|	||<q`qP|WStk
r�|�dd�YnXdd	�}
t
��}z|
||�Wn<t
jk
�r|��t�|�}t|�}|
||�YnXi}|��D]R}i||<}|�|�D]4\}
}d|
|f}t	|�}	|	dk	�sft
�|	||
<�q<�q"|S)
Nr��utf-8�
extensionszpython.exports�exportsz%s = %scSs$t|d�r|�|�n
|�|�dS)N�	read_file)rpr�Zreadfp)�cp�streamr,r,r-�read_streamks
z!read_exports.<locals>.read_stream)rq�version_info�codecs�	getreader�readr
�json�load�items�get_export_entryrd�	Exception�seekr�ConfigParserZMissingSectionHeaderError�close�textwrap�dedentZsections)r��dataZjdatar(�group�entries�krIr+�entryr�r�r�rP�valuer,r,r-�read_exportsWsD

r�cCs�tjddkrt�d�|�}t��}|��D]l\}}|�|�|��D]P}|j	dkr\|j
}nd|j
|j	f}|jr�d|d�|j�f}|�
||j|�qFq,|�|�dS)Nrr�r�z%s:%sz%s [%s]rM)rqr�r��	getwriterrr�r�Zadd_section�valuesrkrm�flagsr$�setrP�write)r�r�r�r�rIr�r+r,r,r-�
write_exports�s

r�c	cs$t��}z
|VW5t�|�XdSru)�tempfile�mkdtempr�rmtree)Ztdr,r,r-�tempdir�s
r�c	cs.t��}zt�|�dVW5t�|�XdSru)ra�getcwd�chdir)r��cwdr,r,r-r��s


r��c	cs.t��}zt�|�dVW5t�|�XdSru)�socketZgetdefaulttimeoutZsetdefaulttimeout)ZsecondsZctor,r,r-�socket_timeout�s


r�c@seZdZdd�Zddd�ZdS)�cached_propertycCs
||_dSru)�func)�selfr�r,r,r-�__init__�szcached_property.__init__NcCs,|dkr|S|�|�}t�||jj|�|Sru)r��object�__setattr__�__name__)r��obj�clsr�r,r,r-�__get__�s

zcached_property.__get__)N)r��
__module__�__qualname__r�r�r,r,r,r-r��sr�cCs~tjdkr|S|s|S|ddkr.td|��|ddkrFtd|��|�d�}tj|krh|�tj�qP|srtjStjj|�S)a�Return 'pathname' as a name that will work on the native filesystem.

    The path is split on '/' and put back together again using the current
    directory separator.  Needed because filenames in the setup script are
    always supplied in Unix style, and have to be converted to the local
    convention before we can actually use them in the filesystem.  Raises
    ValueError on non-Unix-ish systems if 'pathname' either starts or
    ends with a slash.
    r`rzpath '%s' cannot be absolute���zpath '%s' cannot end with '/')rarc�
ValueErrorr��curdir�removerbr$)�pathname�pathsr,r,r-�convert_path�s



r�c@s�eZdZd$dd�Zdd�Zdd�Zdd	�Zd%dd�Zd&dd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
d'dd�Zdd�Zdd�Zd d!�Zd"d#�Zd
S)(�FileOperatorFcCs||_t�|_|��dSru)�dry_runr��ensured�_init_record)r�r�r,r,r-r��szFileOperator.__init__cCsd|_t�|_t�|_dS�NF)�recordr��
files_written�dirs_created�r�r,r,r-r��szFileOperator._init_recordcCs|jr|j�|�dSru)r�r��add)r�rbr,r,r-�record_as_written�szFileOperator.record_as_writtencCsHtj�|�s tdtj�|���tj�|�s0dSt�|�jt�|�jkS)a�Tell if the target is newer than the source.

        Returns true if 'source' exists and is more recently modified than
        'target', or if 'source' exists and 'target' doesn't.

        Returns false if both exist and 'target' is the same age or younger
        than 'source'. Raise PackagingFileError if 'source' does not exist.

        Note that this test is not very accurate: files created in the same
        second will have the same "age".
        zfile '%r' does not existT)rarb�existsr�abspath�stat�st_mtime)r��source�targetr,r,r-�newer�s
�zFileOperator.newerTcCs�|�tj�|��t�d||�|js�d}|rdtj�|�rDd|}n tj�|�rdtj�	|�sdd|}|rtt
|d��t�||�|�
|�dS)z8Copy a file respecting dry-run and force flags.
        zCopying %s to %sNz%s is a symlinkz%s is a non-regular filez which would be overwritten)�
ensure_dirrarb�dirname�logger�infor��islinkr��isfiler�rZcopyfiler�)r�Zinfile�outfile�check�msgr,r,r-�	copy_files
zFileOperator.copy_fileNcCs�tj�|�rt�|�tj�|��t�d||�|jsv|dkrJt	|d�}nt
j	|d|d�}zt�
||�W5|��X|�|�dS)NzCopying stream %s to %s�wb�w��encoding)rarb�isdirrdr�r�r�r�r��openr�r�rZcopyfileobjr�)r�Zinstreamr�r�Z	outstreamr,r,r-�copy_streams
zFileOperator.copy_streamc	Cs\|�tj�|��|jsNtj�|�r.t�|�t|d��}|�|�W5QRX|�	|�dS)Nr�)
r�rarbr�r�r�r�r�r�r�)r�rbr��fr,r,r-�write_binary_file!s
zFileOperator.write_binary_filecCs|�||�|��dSru)r��encode)r�rbr�r�r,r,r-�write_text_file*szFileOperator.write_text_filecCsntjdkstjdkrjtjdkrj|D]F}|jr:t�d|�q"t�|�j|B|@}t�d||�t�||�q"dS)N�posix�javazchanging mode of %szchanging mode of %s to %o)	rarP�_namer�r�r�r��st_mode�chmod)r��bits�mask�filesr��moder,r,r-�set_mode-szFileOperator.set_modecCs|�dd|�S)Nimi�)r�)r+r�r,r,r-�<lambda>9�zFileOperator.<lambda>cCs|tj�|�}||jkrxtj�|�sx|j�|�tj�|�\}}|�|�t�	d|�|j
sft�|�|jrx|j
�|�dS)NzCreating %s)rarbr�r�r�r�r�r�r�r�r��mkdirr�r�)r�rbr�r�r,r,r-r�;s

zFileOperator.ensure_dirc	Cs�t||�}t�d||�|js�|s0|�||�rX|s:d}n|�|�sHt�|t|�d�}i}|rvtt	d�rvt	j
j|d<t	j|||df|�|�
|�|S)NzByte-compiling %s to %s�PycInvalidationMode�invalidation_modeT)rr�r�r�r�rTrdrerp�
py_compiler��CHECKED_HASH�compiler�)	r�rb�optimize�forcermZhashed_invalidationZdpathZdiagpathZcompile_kwargsr,r,r-�byte_compileGs
zFileOperator.byte_compilecCs�tj�|�r�tj�|�r^tj�|�s^t�d|�|js@t�	|�|j
r�||jkr�|j�|�nPtj�|�rpd}nd}t�d||�|js�t�|�|j
r�||j
kr�|j
�|�dS)NzRemoving directory tree at %s�link�filezRemoving %s %s)rarbr�r�r�r��debugr�rr�r�r�r�r�)r�rbr+r,r,r-�ensure_removedXs"



zFileOperator.ensure_removedcCsDd}|s@tj�|�r$t�|tj�}q@tj�|�}||kr:q@|}q|Sr�)rarbr��access�W_OKr�)r�rbr(�parentr,r,r-�is_writablemszFileOperator.is_writablecCs"|js
t�|j|jf}|��|S)zV
        Commit recorded changes, turn off recording, return
        changes.
        )r�rdr�r�r�)r�r(r,r,r-�commitys
zFileOperator.commitcCs�|js�t|j�D]}tj�|�rt�|�qt|jdd�}|D]F}t�	|�}|rz|dgks^t
�tj�||d�}t�|�t�|�q>|�
�dS)NT)�reverse�__pycache__r)r��listr�rarbr�r��sortedr��listdirrdr$�rmdirr�)r�r��dirsr��flistZsdr,r,r-�rollback�s

zFileOperator.rollback)F)T)N)FFNF)r�r�r�r�r�r�r�r�r�r�r�r�Zset_executable_moder�rrrr	rr,r,r,r-r��s 


	

r�cCs^|tjkrtj|}nt|�}|dkr,|}n.|�d�}t||�d��}|D]}t||�}qJ|S)N�.r)rq�modules�
__import__r�rrrh)Zmodule_nameZdotted_path�modr(r*r}r,r,r-�resolve�s

rc@s6eZdZdd�Zedd��Zdd�Zdd�Zej	Z	d	S)
�ExportEntrycCs||_||_||_||_dSru�rPrmrkr�)r�rPrmrkr�r,r,r-r��szExportEntry.__init__cCst|j|j�Sru)rrmrkr�r,r,r-r��szExportEntry.valuecCsd|j|j|j|jfS)Nz<ExportEntry %s = %s:%s %s>rr�r,r,r-�__repr__�s
�zExportEntry.__repr__cCsDt|t�sd}n0|j|jko>|j|jko>|j|jko>|j|jk}|Sr�)rxrrPrmrkr�)r��otherr(r,r,r-�__eq__�s

�
�
�zExportEntry.__eq__N)
r�r�r�r�r�r�rrr��__hash__r,r,r,r-r�s

rz�(?P<name>(\w|[-.+])+)
                      \s*=\s*(?P<callable>(\w+)([:\.]\w+)*)
                      \s*(\[\s*(?P<flags>\w+(=\w+)?(,\s*\w+(=\w+)?)*)\s*\])?
                      c
Cs�t�|�}|s0d}d|ks"d|kr�td|��n�|��}|d}|d}|�d�}|dkrf|d}}n"|dkrztd|��|�d�\}}|d	}	|	dkr�d|ks�d|kr�td|��g}	nd
d�|	�d�D�}	t||||	�}|S)
NrArBzInvalid specification '%s'rP�callable�:rrr�cSsg|]}|���qSr,)rS)rNr�r,r,r-rO�sz$get_export_entry.<locals>.<listcomp>rC)�ENTRY_RE�searchr�	groupdict�countr�r)
Z
specificationr'r(r�rPrbZcolonsrmrkr�r,r,r-r��s8
�
��r�cCs�|dkrd}tjdkr.dtjkr.tj�d�}ntj�d�}tj�|�rft�|tj�}|s�t	�
d|�n<zt�|�d}Wn(tk
r�t	j
d	|dd
�d}YnX|s�t
��}t	�
d|�tj�||�S)
a�
    Return the default base location for distlib caches. If the directory does
    not exist, it is created. Use the suffix provided for the base directory,
    and default to '.distlib' if it isn't provided.

    On Windows, if LOCALAPPDATA is defined in the environment, then it is
    assumed to be a directory, and will be the parent directory of the result.
    On POSIX, and on Windows if LOCALAPPDATA is not defined, the user's home
    directory - using os.expanduser('~') - will be the parent directory of
    the result.

    The result is just the directory '.distlib' in the parent directory as
    determined above, or with the name specified with ``suffix``.
    Nz.distlib�ntZLOCALAPPDATAz
$localappdata�~z(Directory exists but is not writable: %sTzUnable to create %s)�exc_infoFz#Default location unusable, using %s)rarP�environrb�
expandvars�
expanduserr�rrr��warning�makedirs�OSErrorr�r�r$)rkr(Zusabler,r,r-�get_cache_base�s&

r-cCsBtj�tj�|��\}}|r(|�dd�}|�tjd�}||dS)a
    Convert an absolute path to a directory name for use in a cache.

    The algorithm used is:

    #. On Windows, any ``':'`` in the drive is replaced with ``'---'``.
    #. Any occurrence of ``os.sep`` is replaced with ``'--'``.
    #. ``'.cache'`` is appended.
    rz---z--z.cache)rarb�
splitdriver�r!rc)rbr�r}r,r,r-�path_to_cache_dir
s

r/cCs|�d�s|dS|Sr_)�endswith)r+r,r,r-�ensure_slashs
r1cCs`d}}d|kr>|�dd�\}}d|kr.|}n|�dd�\}}|rJt|�}|rVt|�}|||fS)NrDrr)�rsplitr�r)rXZusernameZpasswordrmr,r,r-�parse_credentials$sr3cCst�d�}t�|�|S)N�)ra�umaskrsr,r,r-�get_process_umask3s

r6cCs<d}d}t|�D]\}}t|t�sd}q,q|dk	s8t�|S)NTF)�	enumeraterxrrd)�seqr(r[r+r,r,r-�is_string_sequence8s
r9z3([a-z0-9_]+([.-][a-z_][a-z0-9_]*)*)-([a-z0-9_.+-]+)z
-py(\d\.?\d?)cCs�d}d}t|��dd�}t�|�}|r@|�d�}|d|���}|r�t|�t|�dkr�t�t�	|�d|�}|r�|�
�}|d|�||dd�|f}|dkr�t�|�}|r�|�d�|�d�|f}|S)zw
    Extract name, version, python version from a filename (no extension)

    Return name, version, pyver or None
    N� �-rz\br�)rr!�PYTHON_VERSIONr!r��startre�rer�escaper�PROJECT_NAME_AND_VERSION)�filenameZproject_namer(Zpyverr'�nr,r,r-�split_filenameGs"


rCz-(?P<name>[\w .-]+)\s*\(\s*(?P<ver>[^\s)]+)\)$cCs:t�|�}|std|��|��}|d����|dfS)z�
    A utility method used to get name and version from a string.

    From e.g. a Provides-Dist value.

    :param p: A value in a form 'foo (1.0)'
    :return: The name and version as a tuple.
    z$Ill-formed name/version string: '%s'rPZver)�NAME_VERSION_RErrr"rSrz)r}r'r�r,r,r-�parse_name_and_versioncs
	
rEcCs�t�}t|pg�}t|pg�}d|kr8|�d�||O}|D]x}|dkrT|�|�q<|�d�r�|dd�}||kr�t�d|�||kr�|�|�q<||kr�t�d|�|�|�q<|S)N�*r;rzundeclared extra: %s)r�r�r�rTr�r*)Z	requestedZ	availabler(�rZunwantedr,r,r-�
get_extrasrs&

rHc
Cs�i}zNt|�}|��}|�d�}|�d�s8t�d|�nt�d�|�}t�	|�}Wn0t
k
r�}zt�d||�W5d}~XYnX|S)NzContent-Typezapplication/jsonz(Unexpected response for JSON request: %sr�z&Failed to get external data for %s: %s)rr��getrTr�rr�r�r�r�r��	exception)rRr(ZrespZheadersZct�reader�er,r,r-�_get_external_data�s

 rMz'https://www.red-dove.com/pypi/projects/cCs*d|d��|f}tt|�}t|�}|S)Nz%s/%s/project.jsonr��upperr
�_external_data_base_urlrM)rPrRr(r,r,r-�get_project_data�s
rQcCs(d|d��||f}tt|�}t|�S)Nz%s/%s/package-%s.jsonrrN)rP�versionrRr,r,r-�get_package_data�s
rSc@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Cachez�
    A class implementing a cache for resources that need to live in the file system
    e.g. shared libraries. This class was moved from resources to here because it
    could be used by other modules, e.g. the wheel module.
    cCsPtj�|�st�|�t�|�jd@dkr6t�d|�tj�tj�	|��|_
dS)zu
        Initialise an instance.

        :param base: The base directory where the cache should be located.
        �?rzDirectory '%s' is not privateN)rarbr�r+r�r�r�r*r��normpathrj)r�rjr,r,r-r��s

zCache.__init__cCst|�S)zN
        Converts a resource prefix to a directory name in the cache.
        )r/)r�rmr,r,r-�
prefix_to_dir�szCache.prefix_to_dirc	Cs�g}t�|j�D]r}tj�|j|�}z>tj�|�s>tj�|�rJt�|�ntj�|�r`t	�
|�Wqtk
r�|�|�YqXq|S)z"
        Clear the cache.
        )
rarrjrbr$r�r�r�r�rr�r�r")r�Znot_removed�fnr,r,r-�clear�szCache.clearN)r�r�r��__doc__r�rWrYr,r,r,r-rT�srTc@s:eZdZdZdd�Zddd�Zdd�Zd	d
�Zdd�Zd
S)�
EventMixinz1
    A very simple publish/subscribe system.
    cCs
i|_dSru)�_subscribersr�r,r,r-r��szEventMixin.__init__TcCsD|j}||krt|g�||<n"||}|r6|�|�n
|�|�dS)a`
        Add a subscriber for an event.

        :param event: The name of an event.
        :param subscriber: The subscriber to be added (and called when the
                           event is published).
        :param append: Whether to append or prepend the subscriber to an
                       existing subscriber list for the event.
        N)r\rr"�
appendleft)r��event�
subscriberr"�subsZsqr,r,r-r��s
zEventMixin.addcCs,|j}||krtd|��||�|�dS)z�
        Remove a subscriber for an event.

        :param event: The name of an event.
        :param subscriber: The subscriber to be removed.
        zNo subscribers: %rN)r\r�r�)r�r^r_r`r,r,r-r��szEventMixin.removecCst|j�|d��S)z�
        Return an iterator for the subscribers for an event.
        :param event: The event to return subscribers for.
        r,)�iterr\rI)r�r^r,r,r-�get_subscribersszEventMixin.get_subscribersc	Oslg}|�|�D]F}z||f|�|�}Wn"tk
rHt�d�d}YnX|�|�qt�d||||�|S)a^
        Publish a event and return a list of values returned by its
        subscribers.

        :param event: The event to publish.
        :param args: The positional arguments to pass to the event's
                     subscribers.
        :param kwargs: The keyword arguments to pass to the event's
                       subscribers.
        z"Exception during event publicationNz/publish %s: args = %s, kwargs = %s, result = %s)rbr�r�rJr"r)r�r^�args�kwargsr(r_r�r,r,r-�publishs

�zEventMixin.publishN)T)	r�r�r�rZr�r�r�rbrer,r,r,r-r[�s
r[c@s^eZdZdd�Zdd�Zddd�Zdd	�Zd
d�Zdd
�Zdd�Z	e
dd��Ze
dd��ZdS)�	SequencercCsi|_i|_t�|_dSru)�_preds�_succsr��_nodesr�r,r,r-r�"szSequencer.__init__cCs|j�|�dSru)rir��r��noder,r,r-�add_node'szSequencer.add_nodeFcCs�||jkr|j�|�|r�t|j�|d��D]}|�||�q,t|j�|d��D]}|�||�qPt|j���D]\}}|sp|j|=qpt|j���D]\}}|s�|j|=q�dS)Nr,)rir�r�rgrIrhrr�)r�rkZedgesr}r+r�rIr,r,r-�remove_node*s

zSequencer.remove_nodecCs<||kst�|j�|t���|�|j�|t���|�dSru)rdrg�
setdefaultr�r�rh)r��pred�succr,r,r-r�:sz
Sequencer.addcCs�||kst�z|j|}|j|}Wn tk
rDtd|��YnXz|�|�|�|�Wn$tk
r�td||f��YnXdS)Nz%r not a successor of anythingz%r not a successor of %r)rdrgrh�KeyErrorr�r�)r�rorp�predsZsuccsr,r,r-r�?s

zSequencer.removecCs||jkp||jkp||jkSru)rgrhri)r��stepr,r,r-�is_stepLs�zSequencer.is_stepcCs�|�|�std|��g}g}t�}|�|�|r�|�d�}||krb||kr�|�|�|�|�q.|�|�|�|�|j�|d�}|�	|�q.t
|�S)NzUnknown: %rrr,)rtr�r�r"rhr�r�rgrI�extend�reversed)r��finalr(Ztodo�seenrsrrr,r,r-�	get_stepsPs"





zSequencer.get_stepscsRdg�g�i�i�g�|j��������fdd���D]}|�kr8�|�q8�S)Nrcs��d�|<�d�|<�dd7<��|�z�|}Wntk
rVg}YnX|D]J}|�kr��|�t�|�|��|<q\|�kr\t�|�|��|<q\�|�|kr�g}���}|�|�||kr�q�q�t|�}��|�dS)Nrr)r"r��minrh�tuple)rkZ
successorsZ	successorZconnected_componentZ	component�Zgraph�indexZ
index_counterZlowlinksr(�stack�
strongconnectr,r-rts,


z3Sequencer.strong_connections.<locals>.strongconnect)rhrjr,r|r-�strong_connectionsis"
zSequencer.strong_connectionscCsfdg}|jD]*}|j|}|D]}|�d||f�qq|jD]}|�d|�q>|�d�d�|�S)Nzdigraph G {z  %s -> %s;z  %s;�}�
)rgr"rir$)r�r(rprrrorkr,r,r-�dot�s



z
Sequencer.dotN)F)
r�r�r�r�rlrmr�r�rtry�propertyr�r�r,r,r,r-rf!s


2rf)�.tar.gz�.tar.bz2�.tar�.zip�.tgz�.tbz�.whlTcsZ��fdd�}tj����t���d}|dkr�|�d�r>d}nH|�d�rRd}d}n4|�d�rfd	}d
}n |�d�rzd}d
}ntd|��z�|dkr�t|d
�}|r�|��}|D]}||�q�n*t	�
||�}|r�|��}|D]}||�q�|dk�r*tj
ddk�r*|��D]"}	t|	jt��s|	j�d�|	_�qdd�}
|
|_|���W5|�rT|��XdS)NcsRt|t�s|�d�}tj�tj��|��}|���rB|�tjkrNt	d|��dS)Nr�zpath outside destination: %r)
rxr�decoderarbr�r$rTrcr�)rbr}��dest_dirZplenr,r-�
check_path�s


zunarchive.<locals>.check_path)r�r��zip)r�r�Ztgzzr:gz)r�r�Ztbzzr:bz2r�ZtarrGzUnknown format for %rrr�r�c
SsDzt�||�WStjk
r>}ztt|���W5d}~XYnXdS)z:Run tarfile.tar_fillter, but raise the expected ValueErrorN)�tarfileZ
tar_filterZFilterErrorr��str)�memberrb�excr,r,r-�extraction_filter�sz$unarchive.<locals>.extraction_filter)rarbr�rer0r�r�rZnamelistr�r�Zgetnamesrqr�Z
getmembersrxrPrr�r�Z
extractall)Zarchive_filenamer��formatr�r��archiver��namesrPZtarinfor�r,r�r-�	unarchive�sL





r�c	Cs~t��}t|�}t|d��Z}t�|�D]H\}}}|D]8}tj�||�}||d�}	tj�|	|�}
|�||
�q4q&W5QRX|S)z*zip a directory tree into a BytesIO objectr�N)	�io�BytesIOrerra�walkrbr$r�)Z	directoryr(ZdlenZzfrfrr�rPZfullZrelrlr,r,r-�zip_dir�sr�)r�K�M�G�T�Pc@sreZdZdZddd�Zdd�Zdd	�Zd
d�Zdd
�Ze	dd��Z
e	dd��Zdd�Ze	dd��Z
e	dd��ZdS)�ProgressZUNKNOWNr�dcCs<|dks||kst�||_|_||_d|_d|_d|_dS)NrF)rdrz�cur�max�started�elapsed�done)r�ZminvalZmaxvalr,r,r-r�	szProgress.__init__cCsV|j|kst�|jdks&||jks&t�||_t��}|jdkrF||_n||j|_dSru)rzrdr�r��timer�r�)r�ZcurvalZnowr,r,r-�updates
zProgress.updatecCs |dkst�|�|j|�dS�Nr)rdr�r�)r�Zincrr,r,r-�	incrementszProgress.incrementcCs|�|j�|Sru)r�rzr�r,r,r-r=szProgress.startcCs |jdk	r|�|j�d|_dS)NT)r�r�r�r�r,r,r-�stop#s
z
Progress.stopcCs|jdkr|jS|jSru)r��unknownr�r,r,r-�maximum(szProgress.maximumcCsD|jrd}n4|jdkrd}n$d|j|j|j|j}d|}|S)Nz100 %z ?? %gY@z%3d %%)r�r�r�rz)r�r(rIr,r,r-�
percentage,s
zProgress.percentagecCs:|dkr|jdks|j|jkr$d}nt�dt�|��}|S)Nrz??:??:??z%H:%M:%S)r�r�rzr��strftime�gmtime)r�Zdurationr(r,r,r-�format_duration7szProgress.format_durationcCs�|jrd}|j}n^d}|jdkr&d}nJ|jdks<|j|jkrBd}n.t|j|j�}||j|j}|d|j}d||�|�fS)NZDonezETA r�rrz%s: %s)r�r�r�r�rz�floatr�)r�rmr\r,r,r-�ETA@s
zProgress.ETAcCsL|jdkrd}n|j|j|j}tD]}|dkr6q@|d}q&d||fS)Nrgi�g@�@z%d %sB/s)r�r�rz�UNITS)r�r(Zunitr,r,r-�speedSs

zProgress.speedN)rr�)r�r�r�r�r�r�r�r=r�r�r�r�r�r�r�r,r,r,r-r�s




	
r�z\{([^}]*)\}z[^/\\,{]\*\*|\*\*[^/\\,}]z^[^{]*\}|\{[^}]*$cCs<t�|�rd}t||��t�|�r4d}t||��t|�S)zAExtended globbing function that supports ** and {opt1,opt2,opt3}.z7invalid glob %r: recursive glob "**" must be used alonez2invalid glob %r: mismatching set marker '{' or '}')�_CHECK_RECURSIVE_GLOBr!r��_CHECK_MISMATCH_SET�_iglob)�	path_globr�r,r,r-rhs

rccst�|d�}t|�dkrht|�dks,t|��|\}}}|�d�D]$}td�|||f��D]
}|VqXq@n�d|kr�t|�D]
}|Vqxn~|�dd�\}}|dkr�d}|dkr�d}n|�d�}|�d	�}t�	|�D]4\}}}	tj
�|�}ttj
�||��D]
}
|
Vq�q�dS)
Nrr�rCrz**rrFr`�\)�	RICH_GLOBr�rerdr�r$�	std_iglobr%rar�rbrV)r�Zrich_path_globrmr�rk�itemrbZradical�dirr�rXr,r,r-r�ss*



r�)�HTTPSHandler�match_hostname�CertificateErrorc@seZdZdZdZdd�ZdS)�HTTPSConnectionNTcCsRt�|j|jf|j�}t|dd�r0||_|��tt	d�sp|j
rHt	j}nt	j}t	j
||j|j|t	j|j
d�|_nxt	�t	j�}|jt	jO_|jr�|�|j|j�i}|j
r�t	j|_|j|j
d�tt	dd�r�|j|d<|j
|f|�|_|j
�rN|j�rNz$t|j��|j�t�d|j�Wn0tk
�rL|j�tj�|j���YnXdS)	NZ_tunnel_hostF�
SSLContext)�	cert_reqsZssl_version�ca_certs)ZcafileZHAS_SNIZserver_hostnamezHost verified: %s) r�Zcreate_connection�host�port�timeoutrr�sockZ_tunnelrp�sslr�Z
CERT_REQUIREDZ	CERT_NONEZwrap_socketZkey_fileZ	cert_fileZPROTOCOL_SSLv23r�ZoptionsZOP_NO_SSLv2Zload_cert_chainZverify_modeZload_verify_locations�check_domainr�Zgetpeercertr�rr�ZshutdownZ	SHUT_RDWRr�)r�r�r��contextrdr,r,r-�connect�s@
�


zHTTPSConnection.connect)r�r�r�r�r�r�r,r,r,r-r��sr�c@s&eZdZd	dd�Zdd�Zdd�ZdS)
r�TcCst�|�||_||_dSru)�BaseHTTPSHandlerr�r�r�)r�r�r�r,r,r-r��s
zHTTPSHandler.__init__cOs$t||�}|jr |j|_|j|_|S)a
            This is called to create a connection instance. Normally you'd
            pass a connection class to do_open, but it doesn't actually check for
            a class, and just expects a callable. As long as we behave just as a
            constructor would have, we should be OK. If it ever changes so that
            we *must* pass a class, we'll create an UnsafeHTTPSConnection class
            which just sets check_domain to False in the class definition, and
            choose which one to pass to do_open.
            )r�r�r�)r�rcrdr(r,r,r-�_conn_maker�s


zHTTPSHandler._conn_makerc
CsXz|�|j|�WStk
rR}z$dt|j�kr@td|j��n�W5d}~XYnXdS)Nzcertificate verify failedz*Unable to verify server certificate for %s)Zdo_openr�rr��reasonr�r�)r�rYrLr,r,r-�
https_open�s�zHTTPSHandler.https_openN)T)r�r�r�r�r�r�r,r,r,r-r��s
r�c@seZdZdd�ZdS)�HTTPSOnlyHandlercCstd|��dS)NzAUnexpected HTTP request on what should be a secure connection: %s)r)r�rYr,r,r-�	http_open�s�zHTTPSOnlyHandler.http_openN)r�r�r�r�r,r,r,r-r��sr���r��c@seZdZddd�ZdS)�HTTPrNcKs&|dkrd}|�|j||f|��dSr���_setupZ_connection_class�r�r�r�rdr,r,r-r��sz
HTTP.__init__)rN�r�r�r�r�r,r,r,r-r��sr�c@seZdZddd�ZdS)�HTTPSrNcKs&|dkrd}|�|j||f|��dSr�r�r�r,r,r-r��szHTTPS.__init__)rNr�r,r,r,r-r��sr�c@seZdZddd�Zdd�ZdS)�	TransportrcCs||_tj�||�dSru)r�rr�r��r�r��use_datetimer,r,r-r�szTransport.__init__cCs`|�|�\}}}tdkr(t||jd�}n4|jr<||jdkrR||_|t�|�f|_|jd}|S)Nr�)r�rr)�
get_host_info�	_ver_infor�r��_connection�_extra_headersrZHTTPConnection)r�r��h�ehZx509r(r,r,r-�make_connection
s
zTransport.make_connectionN)r�r�r�r�r�r�r,r,r,r-r�s
r�c@seZdZddd�Zdd�ZdS)�
SafeTransportrcCs||_tj�||�dSru)r�rr�r�r�r,r,r-r�szSafeTransport.__init__cCsx|�|�\}}}|si}|j|d<tdkr:t|df|�}n:|jrN||jdkrj||_|tj|df|�f|_|jd}|S)Nr�r�rr)r�r�r�r�r�r�rr�)r�r�r�r�rdr(r,r,r-r�s
�
zSafeTransport.make_connectionN)rr�r,r,r,r-r�s
r�c@seZdZdd�ZdS)�ServerProxyc	Kst|�dd�|_}|dk	r^t|�\}}|�dd�}|dkr@t}nt}|||d�|d<}||_tjj	||f|�dS)Nr�r�rZhttps)r��	transport)
rhr�rrIr�r�r�rr�r�)	r�rZrdr�rWr]r�Ztclsr\r,r,r-r�,szServerProxy.__init__Nr�r,r,r,r-r�+sr�cKs6tjddkr|d7}nd|d<d|d<t||f|�S)Nrr��br�newliner�r�)rqr�r�)rXr�rdr,r,r-�	_csv_open@s

r�c@s4eZdZed�ed�ed�d�Zdd�Zdd�Zd	S)
�CSVBaserC�"r�)Z	delimiterZ	quotecharZlineterminatorcCs|Srur,r�r,r,r-�	__enter__RszCSVBase.__enter__cGs|j��dSru)r�r�)r�r&r,r,r-�__exit__UszCSVBase.__exit__N)r�r�r�r��defaultsr�r�r,r,r,r-r�Ks�r�c@s(eZdZdd�Zdd�Zdd�ZeZdS)�	CSVReadercKs\d|kr4|d}tjddkr,t�d�|�}||_nt|dd�|_tj|jf|j�|_dS)Nr�rr�r�rbrG)	rqr�r�r�r�r��csvrKr�)r�rdr�r,r,r-r�ZszCSVReader.__init__cCs|Srur,r�r,r,r-�__iter__eszCSVReader.__iter__cCsFt|j�}tjddkrBt|�D] \}}t|t�s |�d�||<q |S�Nrr�r�)�nextrKrqr�r7rxrr�)r�r(r[r�r,r,r-r�hs

zCSVReader.nextN)r�r�r�r�r�r��__next__r,r,r,r-r�Ysr�c@seZdZdd�Zdd�ZdS)�	CSVWritercKs$t|d�|_tj|jf|j�|_dS)Nr�)r�r�r��writerr�)r�rXrdr,r,r-r�sszCSVWriter.__init__cCsNtjddkr>g}|D]"}t|t�r.|�d�}|�|�q|}|j�|�dSr�)rqr�rxrr�r"r��writerow)r��rowrGr�r,r,r-r�ws

zCSVWriter.writerowN)r�r�r�r�r�r,r,r,r-r�rsr�csHeZdZeej�Zded<d�fdd�	Zdd�Zdd	�Zd
d�Z	�Z
S)
�Configurator�inc_convertZincNcs"tt|��|�|pt��|_dSru)�superrr�rar�rj)r��configrj��	__class__r,r-r��szConfigurator.__init__c
s���fdd����d�}t|�s*��|�}��dd�}��dd�}|r\t�fdd�|D��}��fd	d��D�}t|�}|||�}|r�|��D]\}}	t||�|	��q�|S)
Ncsvt|ttf�r*t|��fdd�|D��}nHt|t�rhd|krH��|�}qri}|D]}�||�||<qPn
��|�}|S)Ncsg|]}�|��qSr,r,)rNr[��convertr,r-rO�szBConfigurator.configure_custom.<locals>.convert.<locals>.<listcomp>�())rxrr{�type�dict�configure_customr)�or(r�)rr�r,r-r�s

z.Configurator.configure_custom.<locals>.convertrrz[]r,csg|]}�|��qSr,r,)rNrrr,r-rO�sz1Configurator.configure_custom.<locals>.<listcomp>cs$g|]}t|�r|��|�f�qSr,)r)rNr�)rrr,r-rO�s)rhrrr{r
r��setattr)
r�rr~Zpropsrcr�rdr(rBrIr,)rrr�r-r�s


zConfigurator.configure_customcCs4|j|}t|t�r0d|kr0|�|�|j|<}|S)Nr)rrxr
r)r�r�r(r,r,r-�__getitem__�s
zConfigurator.__getitem__c	CsFtj�|�stj�|j|�}tj|ddd��}t�|�}W5QRX|S)z*Default converter for the inc:// protocol.rGr�r�)	rarb�isabsr$rjr�r�r�r�)r�r�r�r(r,r,r-r�s
zConfigurator.inc_convert)N)r�r�r�r
rZvalue_convertersr�rrr�
__classcell__r,r,rr-r�s
rc@s*eZdZdZd
dd�Zdd�Zdd	�ZdS)�SubprocessMixinzC
    Mixin for running subprocesses and capturing their output
    FNcCs||_||_dSru)�verbose�progress)r�rrr,r,r-r��szSubprocessMixin.__init__cCsj|j}|j}|��}|sq^|dk	r.|||�q|s@tj�d�ntj�|�d��tj��q|��dS)z�
        Read lines from a subprocess' output stream and either pass to a progress
        callable (if specified) or write progress information to sys.stderr.
        Nrr�)	rr�readlinerq�stderrr�r��flushr�)r�r�r�rrr+r,r,r-rK�szSubprocessMixin.readercKs�tj|ftjtjd�|��}tj|j|jdfd�}|��tj|j|jdfd�}|��|�	�|�
�|�
�|jdk	r�|�dd�n|jr�t
j�d�|S)N)�stdoutrr)r�rcrzdone.�mainzdone.
)�
subprocess�Popen�PIPE�	threadingZThreadrKrr=r�waitr$rrrqr�)r��cmdrdr}�t1�t2r,r,r-�run_command�s"��
zSubprocessMixin.run_command)FN)r�r�r�rZr�rKr!r,r,r,r-r�s
rcCst�dd|���S)z,Normalize a python package name a la PEP 503z[-_.]+r;)r>�subrz)rPr,r,r-�normalize_name�sr#)NN)r�)N)N)NT)�r��collectionsr�
contextlibr�Zglobrr�r�r�Zloggingrar�r>r�r��ImportErrorrrqr�r�r�rZdummy_threadingr�rr�compatrrrr	r
rrr
rrrrrrrrrrrrrZ	getLoggerr�r�r�rrGrFr6r>r:rVr#r?r^rnrtryrr�r�r��contextmanagerr�r�r�r�r�r�r�rr�VERBOSEr r�r-r/r1r3r6r9�Ir@r<rCrDrErHrMrPrQrSrTr[rfZARCHIVE_EXTENSIONSr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrr#r,r,r,r-�<module>s�
\








Yy

	/

		8�
)
�


,H
C]


*)	
7.site-packages/pip/_vendor/distlib/__init__.py000064400000001113151446177000015254 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2019 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
import logging

__version__ = '0.2.9.post0'

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())
site-packages/pip/_vendor/distlib/markers.py000064400000010443151446177000015167 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2017 Vinay Sajip.
# Licensed to the Python Software Foundation under a contributor agreement.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""
Parser for the environment markers micro-language defined in PEP 508.
"""

# Note: In PEP 345, the micro-language was Python compatible, so the ast
# module could be used to parse it. However, PEP 508 introduced operators such
# as ~= and === which aren't in Python, necessitating a different approach.

import os
import sys
import platform
import re

from .compat import python_implementation, urlparse, string_types
from .util import in_venv, parse_marker

__all__ = ['interpret']

def _is_literal(o):
    if not isinstance(o, string_types) or not o:
        return False
    return o[0] in '\'"'

class Evaluator(object):
    """
    This class is used to evaluate marker expessions.
    """

    operations = {
        '==': 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,
        '<=':  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)
            result = self.operations[op](lhs, rhs)
        return result

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 = ''

    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': platform.python_version(),
        'python_version': platform.python_version()[:3],
        'sys_platform': sys.platform,
    }
    return result

DEFAULT_CONTEXT = default_context()
del default_context

evaluator = Evaluator()

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))
    context = dict(DEFAULT_CONTEXT)
    if execution_context:
        context.update(execution_context)
    return evaluator.evaluate(expr, context)
site-packages/pip/_vendor/distlib/locators.py000064400000145137151446177000015362 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012-2015 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, string_types, 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, parse_credentials, 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 as e:  # 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, '')),
                                #'packagetype': 'sdist',
                            }
                            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 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
        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):
                        logger.debug('%s did not match %r', matcher, k)
                    else:
                        if prereleases or not vcls(k).is_prerelease:
                            slist.append(k)
                        else:
                            logger.debug('skipping pre-release '
                                         'version %s of %s', k, matcher.name)
                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<rel1>[^"]*)"|'(?P<rel2>[^']*)'|(?P<rel3>[^>\\s\n]*))\\s+)?
href\\s*=\\s*(?:"(?P<url1>[^"]*)"|'(?P<url2>[^']*)'|(?P<url3>[^>\\s\n]*))
(\\s+rel\\s*=\\s*(?:"(?P<rel4>[^"]*)"|'(?P<rel5>[^']*)'|(?P<rel6>[^>\\s\n]*)))?
""", re.I | re.S | re.X)
    _base = re.compile(r"""<base\s+href\s*=\s*['"]?([^'">]+)""", 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: '%%%2x' % 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.
    """

    # These are used to deal with various Content-Encoding schemes.
    decoders = {
        'deflate': zlib.decompress,
        'gzip': lambda b: gzip.GzipFile(fileobj=BytesIO(d)).read(),
        'none': lambda b: b,
    }

    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

    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.setDaemon(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('<a href=[^>]*>([^<]+)<')

    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 426 / PEP 440.
default_locator = AggregatingLocator(
                    JSONLocator(),
                    SimpleScrapingLocator('https://pypi.org/simple/',
                                          timeout=3.0),
                    scheme='legacy')

locate = default_locator.locate

NAME_VERSION_RE = re.compile(r'(?P<name>[\w-]+)\s*'
                             r'\(\s*(==\s*)?(?P<ver>[^)]+)\)$')

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
site-packages/pip/_vendor/distlib/metadata.py000064400000116452151446177000015312 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2012 The Python Software Foundation.
# See LICENSE.txt and CONTRIBUTORS.txt.
#
"""Implementation of the Metadata for Python packages PEPs.

Supports all metadata formats (1.0, 1.1, 1.2, and 2.0 experimental).
"""
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).
_566_FIELDS = _426_FIELDS + ('Description-Content-Type',
                             'Requires', 'Provides')

_566_MARKERS = ('Description-Content-Type',)

_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)

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'):
        return _345_FIELDS + _566_FIELDS
    elif version == '2.0':
        return _426_FIELDS
    raise MetadataUnrecognizedVersionError(version)


def _best_version(fields):
    """Detect the best version depending on the fields used."""
    def _has_marker(keys, markers):
        for marker in markers:
            if marker in keys:
                return True
        return False

    keys = []
    for key, value in fields.items():
        if value in ([], 'UNKNOWN', None):
            continue
        keys.append(key)

    possible_versions = ['1.0', '1.1', '1.2', '1.3', '2.0', '2.1']

    # 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 _426_FIELDS and '2.0' in possible_versions:
            possible_versions.remove('2.0')
            logger.debug('Removed 2.0 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)
    if int(is_1_1) + int(is_1_2) + int(is_2_1) + int(is_2_0) > 1:
        raise MetadataConflictError('You used incompatible 1.1/1.2/2.0/2.1 fields')

    # we have the choice, 1.0, or 1.2, or 2.0
    #   - 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.0 adds more features and is very new
    if not is_1_1 and not is_1_2 and not is_2_1 and not is_2_0:
        # 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'

    return '2.0'

_ATTR2FIELD = {
    'metadata_version': 'Metadata-Version',
    'name': 'Name',
    'version': 'Version',
    'platform': 'Platform',
    'supported_platform': 'Supported-Platform',
    'summary': 'Summary',
    'description': 'Description',
    'keywords': 'Keywords',
    'home_page': 'Home-page',
    'author': 'Author',
    'author_email': 'Author-email',
    'maintainer': 'Maintainer',
    'maintainer_email': 'Maintainer-email',
    'license': 'License',
    'classifier': 'Classifier',
    'download_url': 'Download-URL',
    'obsoletes_dist': 'Obsoletes-Dist',
    'provides_dist': 'Provides-Dist',
    'requires_dist': 'Requires-Dist',
    'setup_requires_dist': 'Setup-Requires-Dist',
    'requires_python': 'Requires-Python',
    'requires_external': 'Requires-External',
    'requires': 'Requires',
    'provides': 'Provides',
    'obsoletes': 'Obsoletes',
    'project_url': 'Project-URL',
    'private_version': 'Private-Version',
    'obsoleted_by': 'Obsoleted-By',
    'extension': 'Extension',
    'provides_extra': 'Provides-Extra',
}

_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')
_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 and 1.2 (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
    #

#    dependencies = property(_get_dependencies, _set_dependencies)

    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)
        # 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).
        """
        self.set_metadata_version()

        mapping_1_0 = (
            ('metadata_version', 'Metadata-Version'),
            ('name', 'Name'),
            ('version', 'Version'),
            ('summary', 'Summary'),
            ('home_page', 'Home-page'),
            ('author', 'Author'),
            ('author_email', 'Author-email'),
            ('license', 'License'),
            ('description', 'Description'),
            ('keywords', 'Keywords'),
            ('platform', 'Platform'),
            ('classifiers', 'Classifier'),
            ('download_url', 'Download-URL'),
        )

        data = {}
        for key, field_name in mapping_1_0:
            if not skip_missing or field_name in self._fields:
                data[key] = self[field_name]

        if self['Metadata-Version'] == '1.2':
            mapping_1_2 = (
                ('requires_dist', 'Requires-Dist'),
                ('requires_python', 'Requires-Python'),
                ('requires_external', 'Requires-External'),
                ('provides_dist', 'Provides-Dist'),
                ('obsoletes_dist', 'Obsoletes-Dist'),
                ('project_url', 'Project-URL'),
                ('maintainer', 'Maintainer'),
                ('maintainer_email', 'Maintainer-email'),
            )
            for key, field_name in mapping_1_2:
                if not skip_missing or field_name in self._fields:
                    if key != 'project_url':
                        data[key] = self[field_name]
                    else:
                        data[key] = [','.join(u) for u in self[field_name]]

        elif self['Metadata-Version'] == '1.1':
            mapping_1_1 = (
                ('provides', 'Provides'),
                ('requires', 'Requires'),
                ('obsoletes', 'Obsoletes'),
            )
            for key, field_name in mapping_1_1:
                if not skip_missing or field_name in self._fields:
                    data[key] = 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.0 (JSON)
    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)

    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',)),
    }

    __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',
        'license': 'License',
        'summary': 'Summary',
        'description': 'Description',
        '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
        for nk, ok in self.LEGACY_MAPPING.items():
            if nk in nmd:
                result[ok] = nmd[nk]
        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: other fields such as contacts
        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)
site-packages/pip/_vendor/distlib/index.py000064400000051112151446177000014630 0ustar00# -*- coding: utf-8 -*-
#
# Copyright (C) 2013 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:
    from dummy_threading import Thread

from . import DistlibException
from .compat import (HTTPBasicAuthHandler, Request, HTTPPasswordMgr,
                     urlparse, build_opener, string_types)
from .util import cached_property, 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 distutils.core import Distribution
        from distutils.config import PyPIRCCommand
        d = Distribution()
        return PyPIRCCommand(d)

    def read_configuration(self):
        """
        Read the PyPI access configuration as supported by distutils, getting
        PyPI to do the actual work. This populates ``username``, ``password``,
        ``realm`` and ``url`` attributes from the configuration.
        """
        # get distutils to do the work
        c = self._get_pypirc_command()
        c.repository = self.url
        cfg = c._read_pypirc()
        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.

        Again, distutils is used to do the actual work.
        """
        self.check_credentials()
        # get distutils to do the work
        c = self._get_pypirc_command()
        c._store_pypirc(self.username, self.password)

    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):
        """
        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(), [])
        response = 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):
        """
        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):
        """
        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):
        """
        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):
        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')()
site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-38.opt-1.pyc000064400000003576151446177000022513 0ustar00U

��.e��@s�ddlmZddlTddlmZGdd�dedd��ZddlZej�d	�r`dd
l	m
Z
mZmZnBzdd
l
m
Z
mZmZWn(ek
r�dd
l	m
Z
mZmZYnXdd�Zd
d�Zdd�ZeZeZeZeZdS)�)�version)�*�)�
namedtuplecs eZdZdZ�fdd�Z�ZS)�ExtTypez'ExtType represents ext type in msgpack.csVt|t�std��t|t�s$td��d|kr8dksBntd��tt|��|||�S)Nzcode must be intzdata must be bytesr�zcode must be 0~127)�
isinstance�int�	TypeError�bytes�
ValueError�superr�__new__)�cls�code�data��	__class__��@/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/__init__.pyr
s

zExtType.__new__)�__name__�
__module__�__qualname__�__doc__r�
__classcell__rrrrrsrz	code dataNZMSGPACK_PUREPYTHON)�Packer�unpackb�UnpackercKstf|�}|�|�|��dS)zX
    Pack object `o` and write it to `stream`

    See :class:`Packer` for options.
    N)r�write�pack)�o�stream�kwargsZpackerrrrrs
rcKstf|��|�S)zW
    Pack object `o` and return packed bytes

    See :class:`Packer` for options.
    )rr)r r"rrr�packb(sr#cKs|��}t|f|�S)z�
    Unpack an object from `stream`.

    Raises `ExtraData` when `stream` contains extra bytes.
    See :class:`Unpacker` for options.
    )�readr)r!r"rrrr�unpack1sr%)Z_versionr�
exceptions�collectionsrr�os�environ�getZfallbackrrrZ	_cmsgpack�ImportErrorrr#r%�load�loads�dump�dumpsrrrr�<module>s"
	site-packages/pip/_vendor/msgpack/__pycache__/fallback.cpython-38.opt-1.pyc000064400000063024151446177000022505 0ustar00U

��.eN��@s�dZddlZddlZddlZejddkr@dZeefZdd�Z	ndZeZe
ZeZ
dd�Z	ejd	krpeZd
d�Zndd�Zeed
�r�ddlmZzddlmZWn ek
r�ddlmZYnXdZGdd�de�ZndZddlmZdd�ZddlmZmZm Z m!Z!m"Z"ddl#m$Z$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/e0e1fdd�Z2dd �Z3d!d"�Z4d#d$�Z5ejd%k�r�d,d&d'�Z6nej7Z6Gd(d)�d)e�Z8Gd*d+�d+e�Z9dS)-z.Fallback pure Python implementation of msgpack�N�TcCs|��S�N)Z	iteritems��d�r�@/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/fallback.py�dict_iteritemssrFcCs|��Sr)�itemsrrrrrs)��cCs.t|j�dko,t|jdt�o,|jd�d�S)N�rz maximum recursion depth exceeded)�len�args�
isinstance�str�
startswith��errr�_is_recursionerrors�rcCsdS)NTrrrrrrsZpypy_version_info)�newlist_hint)�BytesBuilder)�
StringBuilderc@s&eZdZd	dd�Zdd�Zdd�ZdS)
�StringIO�cCs,|r tt|��|_|j�|�nt�|_dSr)rr
�builder�append��self�srrr�__init__*szStringIO.__init__cCs6t|t�r|��}nt|t�r&t|�}|j�|�dSr)r�
memoryview�tobytes�	bytearray�bytesrrrrrr�write0s



zStringIO.writecCs
|j��Sr)rZbuild�rrrr�getvalue6szStringIO.getvalueN)r)�__name__�
__module__�__qualname__rr$r&rrrrr)s
r)�BytesIOcCsgSrr)�sizerrr�<lambda>;rr,r)�
BufferFull�	OutOfData�	ExtraData�FormatError�
StackError)�ExtTyper
�ri�cCs(||�|kr||�|kS||�|kSdSrr)�obj�t�type�tuplerrr�_check_type_strictXsr8cCsdzt|�}Wn@tk
rLtrFtt|��}tjdt|�tdd�n�YnX|jdkr`t	d��|S)Nz�using old buffer interface to unpack %s; this leads to unpacking errors if slicing is used and will be removed in a future versionr
��
stacklevelrz$cannot unpack from multi-byte object)
r �	TypeError�PY2�buffer�warnings�warnr6�RuntimeWarning�itemsize�
ValueError)r4�viewrrr�_get_data_from_buffer_s��
rDcKs$tjdtdd�|��}t|f|�S)NzbDirect calling implementation's unpack() is deprecated, Use msgpack.unpack() or unpackb() instead.rr9)r>r?�DeprecationWarning�read�unpackb)�stream�kwargs�datarrr�unpackqs�rKc
Ks�tddt|�i|��}|�|�z|��}WnJtk
rHtd��Yn0tk
rv}zt|�rdt��W5d}~XYnX|�	�r�t
||����|S)aw
    Unpack an object from `packed`.

    Raises ``ExtraData`` when *packed* contains extra bytes.
    Raises ``ValueError`` when *packed* is incomplete.
    Raises ``FormatError`` when *packed* is not valid msgpack.
    Raises ``StackError`` when *packed* contains too nested.
    Other exceptions can be raised during unpacking.

    See :class:`Unpacker` for options.
    N�max_buffer_sizezUnpack failed: incomplete input)N)�Unpackerr
�feed�_unpackr.rB�RecursionErrorrr1�_got_extradatar/�_get_extradata)ZpackedrIZunpacker�retrrrrrGys
rG)r��cCst�|t|�|�S)z.Explicit typcast for legacy struct.unpack_from)�struct�unpack_fromr#)�f�b�orrr�_unpack_from�sr[c@s�eZdZdZdddddddddddedddddfdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zdd�Ze
fdd�Ze
fdd�Zdd�Zdd�ZeZdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�ZdS))rMa�
Streaming unpacker.

    arguments:

    :param file_like:
        File-like object having `.read(n)` method.
        If specified, unpacker reads serialized data from it and :meth:`feed()` is not usable.

    :param int read_size:
        Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`)

    :param bool use_list:
        If true, unpack msgpack array to Python list.
        Otherwise, unpack to Python tuple. (default: True)

    :param bool raw:
        If true, unpack msgpack raw to Python bytes (default).
        Otherwise, unpack to Python str (or unicode on Python 2) by decoding
        with UTF-8 encoding (recommended).
        Currently, the default is true, but it will be changed to false in
        near future.  So you must specify it explicitly for keeping backward
        compatibility.

        *encoding* option which is deprecated overrides this option.

    :param bool strict_map_key:
        If true, only str or bytes are accepted for map (dict) keys.
        It's False by default for backward-compatibility.
        But it will be True from msgpack 1.0.

    :param callable object_hook:
        When specified, it should be callable.
        Unpacker calls it with a dict argument after unpacking msgpack map.
        (See also simplejson)

    :param callable object_pairs_hook:
        When specified, it should be callable.
        Unpacker calls it with a list of key-value pairs after unpacking msgpack map.
        (See also simplejson)

    :param str encoding:
        Encoding used for decoding msgpack raw.
        If it is None (default), msgpack raw is deserialized to Python bytes.

    :param str unicode_errors:
        (deprecated) Used for decoding msgpack raw with *encoding*.
        (default: `'strict'`)

    :param int max_buffer_size:
        Limits size of data waiting unpacked.  0 means system's INT_MAX (default).
        Raises `BufferFull` exception when it is insufficient.
        You should set this parameter when unpacking data from untrusted source.

    :param int max_str_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max length of str. (default: max_buffer_size or 1024*1024)

    :param int max_bin_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max length of bin. (default: max_buffer_size or 1024*1024)

    :param int max_array_len:
        Limits max length of array.
        (default: max_buffer_size or 128*1024)

    :param int max_map_len:
        Limits max length of map.
        (default: max_buffer_size//2 or 32*1024)

    :param int max_ext_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max size of ext type.  (default: max_buffer_size or 1024*1024)

    Example of streaming deserialize from file-like object::

        unpacker = Unpacker(file_like, raw=False, max_buffer_size=10*1024*1024)
        for o in unpacker:
            process(o)

    Example of streaming deserialize from socket::

        unpacker = Unpacker(raw=False, max_buffer_size=10*1024*1024)
        while True:
            buf = sock.recv(1024**2)
            if not buf:
                break
            unpacker.feed(buf)
            for o in unpacker:
                process(o)

    Raises ``ExtraData`` when *packed* contains extra bytes.
    Raises ``OutOfData`` when *packed* is incomplete.
    Raises ``FormatError`` when *packed* is not valid msgpack.
    Raises ``StackError`` when *packed* contains too nested.
    Other exceptions can be raised during unpacking.
    NrTF���cCs�|	dk	rtjdtdd�|
dkr$d}
|dkr4d|_nt|j�sFtd��||_d|_t�|_	d|_
d|_|
d	krv|ptd
}
|d	kr�|p�d
}|d	kr�|p�d}|d	kr�|dp�d}|d	kr�|p�d
}|p�d
|_||jkr�t
d��|p�t|jd�|_t|�|_t|�|_|	|_|
|_||_||_||_||_||_|
|_||_||_||_||_d|_|dk	�rft|��sftd��|dk	�r�t|��s�td��|dk	�r�t|��s�td��|dk	�r�|dk	�r�td��t|��s�td��dS)N�.encoding is deprecated, Use raw=False instead.rr9�strictTz!`file_like.read` must be callableFrr\iii�i���z.read_size must be smaller than max_buffer_sizei@z`list_hook` is not callablez`object_hook` is not callablez#`object_pairs_hook` is not callablez8object_pairs_hook and object_hook are mutually exclusivez`ext_hook` is not callable) r>r?rE�_feeding�callablerFr;�	file_liker"�_buffer�_buff_i�_buf_checkpoint�_max_buffer_sizerB�min�
_read_size�bool�_raw�_strict_map_key�	_encoding�_unicode_errors�	_use_list�
_list_hook�_object_hook�_object_pairs_hook�	_ext_hook�_max_str_len�_max_bin_len�_max_array_len�_max_map_len�_max_ext_len�_stream_offset)rraZ	read_sizeZuse_list�rawZstrict_map_keyZobject_hookZobject_pairs_hookZ	list_hook�encoding�unicode_errorsrLZext_hookZmax_str_lenZmax_bin_lenZ
max_array_lenZmax_map_lenZmax_ext_lenrrrr�sp	�
	




zUnpacker.__init__cCsht|�}t|j�|jt|�|jkr*t�|jdkrX|jd|j�=|j|j8_d|_|j�|�dS�Nr)rDr
rbrcrer-rd�extend)rZ
next_bytesrCrrrrNPs
z
Unpacker.feedcCs"|j|j|j7_|j|_dS)z+ Gets rid of the used parts of the buffer. N)rwrcrdr%rrr�_consume_szUnpacker._consumecCs|jt|j�kSr)rcr
rbr%rrrrQdszUnpacker._got_extradatacCs|j|jd�Sr)rbrcr%rrrrRgszUnpacker._get_extradatacCs
|�|�Sr)�_read�r�nrrr�
read_bytesjszUnpacker.read_bytescCs,|�|�|j}|||_|j|||�Sr)�_reservercrb)rr��irrrr~ms

zUnpacker._readcCs�t|j�|j|}|dkr dS|jr2|j|_t�|jdkr`|jd|j�=|j|j8_d|_|}|dkr�t|j|�}|j�	|�}|s�q�|j|7_|t|�8}qft|j�||jkr�d|_t�dSr{)
r
rbrcr_rdr.�maxrgrarF)rr�Zremain_bytesZ
to_read_bytesZ	read_datarrrr�ts*
zUnpacker._reservecCs&
t}d}d}|�d�|j|j}|jd7_|d@dkrD|}�	n�|d@dkr`d|dA}�	n�|d@dkr�|d@}t}||jkr�td	||j��|�|�}�	n~|d
@dkr�|d@}t}||j	kr�td
||j	���	nJ|d
@dk�r
|d@}t
}||jk�
rtd||j���	n|dk�rd}�	n|dk�r.d}�n�|dk�r@d}�n�|dk�r�t}|�d�|j|j}|jd7_||j
k�r�td||j
f��|�|�}�n~|dk�rt}|�d�td|j|j�d}|jd7_||j
k�r�td||j
f��|�|�}�n|dk�rjt}|�d�td|j|j�d}|jd7_||j
k�r\td||j
f��|�|�}�n�|dk�r�t}|�d�td|j|j�\}}|jd7_||jk�r�td||jf��|�|�}�nL|dk�r6t}|�d �td!|j|j�\}}|jd 7_||jk�r(td||jf��|�|�}�n�|d"k�r�t}|�d#�td$|j|j�\}}|jd#7_||jk�r�td||jf��|�|�}�n�|d%k�r�|�d�td&|j|j�d}|jd7_�nF|d'k�r|�d(�td)|j|j�d}|jd(7_�n|d*k�rB|�d�|j|j}|jd7_�n�|d+k�r||�d�td|j|j�d}|jd7_�n�|d,k�r�|�d�td|j|j�d}|jd7_�nf|d-k�r�|�d(�td.|j|j�d}|jd(7_�n,|d/k�r*|�d�td0|j|j�d}|jd7_�n�|d1k�rd|�d�td2|j|j�d}|jd7_�n�|d3k�r�|�d�td4|j|j�d}|jd7_�n~|d5k�r�|�d(�td6|j|j�d}|jd(7_�nD|d7k�r4t}|jdk�rtdd|jf��|�d�td8|j|j�\}}|jd7_�n�|d9k�r�t}|jdk�r`tdd|jf��|�d �td:|j|j�\}}|jd 7_�n�|d;k�r�t}|jdk�r�tdd|jf��|�d#�td<|j|j�\}}|jd#7_�n0|d=k�rHt}|jd(k�rtdd(|jf��|�d>�td?|j|j�\}}|jd>7_�n�|d@k�r�t}|jdAk�rttddA|jf��|�dB�tdC|j|j�\}}|jdB7_�nx|dDk�r�t}|�d�|j|j}|jd7_||jk�r�td	||j��|�|�}�n|dEk�r^t}|�d�td|j|j�\}|jd7_||jk�rPtd	||j��|�|�}�n�|dFk�r�t}|�d�td|j|j�\}|jd7_||jk�r�td	||j��|�|�}�n^|dGk�	rt}|�d�td|j|j�\}|jd7_||j	k�
rtd
||j	���n|dHk�	rht}|�d�td|j|j�\}|jd7_||j	k�
rtd
||j	��n�|dIk�	r�|�d�td|j|j�\}|jd7_||jk�	r�td||j��t
}n`|dJk�
r|�d�td|j|j�\}|jd7_||jk�
r
td||j��t
}ntdK|��|||fS)LNrr���r\���z%s exceeds max_str_len(%s)����z%s exceeds max_array_len(%s)z%s exceeds max_map_len(%s)���F��T��z%s exceeds max_bin_len(%s)��r�>H��r3�>I��ZBbz%s exceeds max_ext_len(%s)��r
z>Hb��rz>Ib��z>f���z>d��������z>Q��rY��z>h��z>i��z>q��Zb1s��Zb2s��Zb4s���	Zb8s����Zb16s��������������zUnknown header: 0x%x)�TYPE_IMMEDIATEr�rbrc�TYPE_RAWrrrBr~�
TYPE_ARRAYrt�TYPE_MAPru�TYPE_BINrsr[�TYPE_EXTrvr0)r�execute�typr�r4rY�Lrrr�_read_header�s�





























































zUnpacker._read_headerc	s��|�\}}}|tkr,|tkr(td��|S|tkrH|tkrDtd��|S|tkr�|tkrtt|�D]}��t�q`dSt	|�}t|�D]}|�
��t��q��jdk	r���|�}�j
r�|St|�S|tk�r�|tkr�t|�D]}��t���t�q�dS�jdk	�r"���fdd�t|�D��}npi}t|�D]L}��t�}�j�rjt|�ttfk�rjtdtt|������t�||<�q.�jdk	�r���|�}|S|tk�r�dS|tk�r�jdk	�r�|��j�j�}n�j�r�t|�}n
|�d�}|S|tk�r��|t|��S|tk�rt|�S|S)NzExpected arrayzExpected mapc3s"|]}��t���t�fVqdSr)rO�EX_CONSTRUCT)�.0�_r%rr�	<genexpr>�s��z#Unpacker._unpack.<locals>.<genexpr>z%s is not allowed for map key�utf_8)r��EX_READ_ARRAY_HEADERr�rB�EX_READ_MAP_HEADERr��EX_SKIP�xrangerOrrr�rnrmr7rprjr6�unicoder#rror�rk�decoderlrir�rqr�)	rr�r�r�r4r�rSr��keyrr%rrOhsj



�








zUnpacker._unpackcCs|Srrr%rrr�__iter__�szUnpacker.__iter__cCsTz|�t�}|��|WStk
r8|��t�Yntk
rNt�YnXdSr)rOr�r}r.�
StopIterationrPr1�rrSrrr�__next__�s
zUnpacker.__next__cCs|�t�|��dSr)rOr�r}r%rrr�skip�s
z
Unpacker.skipcCs4z|�t�}Wntk
r&t�YnX|��|Sr)rOr�rPr1r}r�rrrrK�s
zUnpacker.unpackcCs|�t�}|��|Sr)rOr�r}r�rrr�read_array_header�s
zUnpacker.read_array_headercCs|�t�}|��|Sr)rOr�r}r�rrr�read_map_header�s
zUnpacker.read_map_headercCs|jSr)rwr%rrr�tell�sz
Unpacker.tell)r'r(r)�__doc__r2rrNr}rQrRr�r~r�r�r�rOr�r��nextr�rKr�r�r�rrrrrM�sBa
�
R U@rMc@s�eZdZdZd#dd�Zeeefdd�Zd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zefdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�ZdS)$�Packerah
    MessagePack Packer

    usage:

        packer = Packer()
        astream.write(packer.pack(a))
        astream.write(packer.pack(b))

    Packer's constructor has some keyword arguments:

    :param callable default:
        Convert user type to builtin type that Packer supports.
        See also simplejson's document.

    :param bool use_single_float:
        Use single precision float type for float. (default: False)

    :param bool autoreset:
        Reset buffer after each pack and return its content as `bytes`. (default: True).
        If set this to false, use `bytes()` to get content and `.reset()` to clear buffer.

    :param bool use_bin_type:
        Use bin type introduced in msgpack spec 2.0 for bytes.
        It also enables str8 type for unicode.

    :param bool strict_types:
        If set to true, types will be checked to be exact. Derived classes
        from serializeable types will not be serialized and will be
        treated as unsupported type and forwarded to default.
        Additionally tuples will not be serialized as lists.
        This is useful when trying to implement accurate serialization
        for python types.

    :param str encoding:
        (deprecated) Convert unicode to bytes with this encoding. (default: 'utf-8')

    :param str unicode_errors:
        Error handler for encoding unicode. (default: 'strict')
    NFTcCsx|dkrd}ntjdtdd�|dkr*d}||_||_||_||_||_||_t	�|_
|dk	rnt|�sntd��||_
dS)Nr�r]rr9r^zdefault must be callable)r>r?rE�
_strict_types�
_use_float�
_autoreset�
_use_bin_typerkrlrrbr`r;�_default)r�defaultryrzZuse_single_floatZ	autoresetZuse_bin_typeZstrict_typesrrrr�s(�zPacker.__init__cCsdd}|jr|}t}nttf}|dkr,td��|dkr@|j�d�S||t�rf|rZ|j�d�S|j�d�S||t��r�d|kr�dkr�nn|j�t�	d|��Sd	|kr�dkr�nn|j�t�	d
|��Sd|kr�dkr�nn|j�t�	dd
|��Sd|k�rdk�r*nn|j�t�	dd|��Sd|k�rBdk�r\nn|j�t�	dd|��Sd|k�rtdk�r�nn|j�t�	dd|��Sd|k�r�dk�r�nn|j�t�	dd|��Sd|k�r�dk�r�nn|j�t�	dd|��Sd|k�r
dk�r$nn|j�t�	dd|��Sd |k�r<dk�rVnn|j�t�	d!d"|��S|�sx|j
dk	�rx|�
|�}d#}qtd$��||tt
f��r�t|�}|d%k�r�td&t|�j��|�|�|j�|�S||t��r*|jdk�r�td'��|�|j|j�}t|�}|d%k�rtd(��|�|�|j�|�S||t��rlt|�|j}|d%k�rVtd)��|�|�|j�|�S||t��r�|j�r�|j�t�	d*d+|��S|j�t�	d,d-|��S||t��r�|j}|j}	t|	�}
|
d.k�r�|j�d/�n�|
d0k�r�|j�d1�n�|
d2k�r|j�d3�n�|
d4k�r,|j�d5�nr|
d6k�rD|j�d7�nZ|
dk�rf|j�t�	d8d9|
��n8|
dk�r�|j�t�	dd:|
��n|j�t�	dd;|
��|j�t�	d
|��|j�|	�dS|||��rt|�}|�|�t |�D]}|�!|||d.��q�dS||t"��r.|�#t|�t$|�|d.�S|�sP|j
dk	�rP|�
|�}d.}qtd<|f��qdS)=NFrzrecursion limit exceeded������r��Bi��rYr�ZBBr�i����z>Bbr���>BHr�i���z>Bhr�����>BIr�i�z>Bir�l����z>BQr�l����z>Bqr�TzInteger value out of range�z%s is too largez5Can't encode unicode string: no encoding is specifiedzString is too largezMemoryview is too largez>Bfr�z>Bdr�r��r��r3��r���r���>BBr�r�r�zCannot serialize %r)%r��listr7rBrbr$rh�	int_typesrV�packr��
OverflowErrorr#r"r
r6r'�_pack_bin_headerr�rkr;�encoderl�_pack_raw_headerr rA�floatr�r2�coderJ�_pack_array_headerr��_pack�dict�_pack_map_pairsr)rr4�
nest_limitZcheckZcheck_type_strictZdefault_usedZ
list_typesr�r�rJr�r�rrrr�s�



�











�
zPacker._packcCsFz|�|�Wnt�|_�YnX|jrB|j��}t�|_|SdSr)r�rrbr�r&)rr4rSrrrr��s
zPacker.packcCs0|�t|�|�|jr,|j��}t�|_|SdSr)r�r
r�rbr&r)r�pairsrSrrr�pack_map_pairs�s

zPacker.pack_map_pairscCs6|dkrt�|�|�|jr2|j��}t�|_|SdS�Nr�)rBr�r�rbr&r�rr�rSrrr�pack_array_header�s

zPacker.pack_array_headercCs6|dkrt�|�|�|jr2|j��}t�|_|SdSr�)rB�_pack_map_headerr�rbr&rr�rrr�pack_map_header�s

zPacker.pack_map_headercCsJt|t�std��d|kr&dks0ntd��t|t�sBtd��t|�}|dkrZtd��|dkrp|j�d	�n�|d
kr�|j�d�n�|dkr�|j�d
�n�|dkr�|j�d�nt|dkr�|j�d�n^|dkr�|j�dt�	d|��n<|dk�r|j�dt�	d|��n|j�dt�	d|��|j�t�	d|��|j�|�dS)Nztypecode must have int type.r�ztypecode should be 0-127zdata must have bytes typer�zToo large datarr�rr�r3r�r�r�r�r�r���r�r���r���r�)
r�intr;rBr#r
rbr$rVr�)r�typecoderJr�rrr�
pack_ext_type�s4


zPacker.pack_ext_typecCsh|dkr |j�t�dd|��S|dkr>|j�t�dd|��S|dkr\|j�t�dd	|��Std
��dS)Nr�r�r�r�r�r�r�r�r�zArray is too large�rbr$rVr�rBrrrrr��szPacker._pack_array_headercCsh|dkr |j�t�dd|��S|dkr>|j�t�dd|��S|dkr\|j�t�dd	|��Std
��dS)Nr�r�r�r�r�r�r�r�r�zDict is too largerrrrrr��szPacker._pack_map_headercCs<|�|�|D](\}}|�||d�|�||d�qdS)Nr)r�r�)rr�r�r��k�vrrrr��s
zPacker._pack_map_pairscCs�|dkr"|j�t�dd|��nn|jrH|dkrH|j�t�dd|��nH|dkrh|j�t�dd	|��n(|d
kr�|j�t�dd|��ntd
��dS)Nr�r�r�r�r�r�r�r�r�r�r�r�zRaw is too large)rbr$rVr�r�rBrrrrr��szPacker._pack_raw_headercCsv|js|�|�S|dkr.|j�t�dd|��S|dkrL|j�t�dd|��S|dkrj|j�t�dd	|��Std
��dS)Nr�r�r�r�r�r�r�r�r�zBin is too large)r�r�rbr$rVr�rBrrrrr��s
zPacker._pack_bin_headercCs
|j��S)z/Return internal buffer contents as bytes object)rbr&r%rrrr#�szPacker.bytescCst�|_dS)zYReset internal buffer.

        This method is usaful only when autoreset=False.
        N)rrbr%rrr�reset�szPacker.resetcCs"tstrt|���S|j��SdS)zReturn view of internal buffer.N)�USING_STRINGBUILDERr<r r#rb�	getbufferr%rrrr	�szPacker.getbuffer)NNNFTFF)r'r(r)r�r�DEFAULT_RECURSE_LIMITrr8r�r�r�r�r�rr�r�r�r�r�r#rr	rrrrr��s0(�
�
n				r�)r):r��sysrVr>�version_infor<rZlongr�rrr��ranger��RuntimeErrorrPr�hasattrZ__pypy__rZ__pypy__.buildersrr�ImportErrorr�objectr�ior*�
exceptionsr-r.r/r0r1�r2r�r�r�r�r�r�r�r�r�r�r
r6r7r8rDrKrGr[rWrMr�rrrr�<module>sj



:site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-38.pyc000064400000003430151446177000022163 0ustar00U

��.e9�@sxGdd�de�ZGdd�de�ZGdd�de�ZGdd�dee�ZGdd	�d	ee�ZeZGd
d�de�ZeZ	eZ
eZdS)
c@seZdZdZdS)�UnpackExceptionz�Base class for some exceptions raised while unpacking.

    NOTE: unpack may raise exception other than subclass of
    UnpackException.  If you want to catch all error, catch
    Exception instead.
    N��__name__�
__module__�__qualname__�__doc__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/exceptions.pyrsrc@seZdZdS)�
BufferFullN�rrrrrrrr	
sr	c@seZdZdS)�	OutOfDataNr
rrrrrsrc@seZdZdZdS)�FormatErrorzInvalid msgpack formatNrrrrrrsrc@seZdZdZdS)�
StackErrorz
Too nestedNrrrrrr
sr
c@s eZdZdZdd�Zdd�ZdS)�	ExtraDataz�ExtraData is raised when there is trailing data.

    This exception is raised while only one-shot (not streaming)
    unpack.
    cCs||_||_dS)N)�unpacked�extra)�selfrrrrr�__init__%szExtraData.__init__cCsdS)Nzunpack(b) received extra data.r)rrrr�__str__)szExtraData.__str__N)rrrrrrrrrrrsrN)
�	Exceptionrr	r�
ValueErrorrr
ZUnpackValueErrorrZ
PackExceptionZPackValueError�
OverflowErrorZPackOverflowErrorrrrr�<module>s	site-packages/pip/_vendor/msgpack/__pycache__/fallback.cpython-38.pyc000064400000063241151446177000021547 0ustar00U

��.eN��@s�dZddlZddlZddlZejddkr@dZeefZdd�Z	ndZeZe
ZeZ
dd�Z	ejd	krpeZd
d�Zndd�Zeed
�r�ddlmZzddlmZWn ek
r�ddlmZYnXdZGdd�de�ZndZddlmZdd�ZddlmZmZm Z m!Z!m"Z"ddl#m$Z$dZ%dZ&dZ'dZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/e0e1fdd�Z2dd �Z3d!d"�Z4d#d$�Z5ejd%k�r�d,d&d'�Z6nej7Z6Gd(d)�d)e�Z8Gd*d+�d+e�Z9dS)-z.Fallback pure Python implementation of msgpack�N�TcCs|��S�N)Z	iteritems��d�r�@/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/fallback.py�dict_iteritemssrFcCs|��Sr)�itemsrrrrrs)��cCs.t|j�dko,t|jdt�o,|jd�d�S)N�rz maximum recursion depth exceeded)�len�args�
isinstance�str�
startswith��errr�_is_recursionerrors�rcCsdS)NTrrrrrrsZpypy_version_info)�newlist_hint)�BytesBuilder)�
StringBuilderc@s&eZdZd	dd�Zdd�Zdd�ZdS)
�StringIO�cCs,|r tt|��|_|j�|�nt�|_dSr)rr
�builder�append��self�srrr�__init__*szStringIO.__init__cCs6t|t�r|��}nt|t�r&t|�}|j�|�dSr)r�
memoryview�tobytes�	bytearray�bytesrrrrrr�write0s



zStringIO.writecCs
|j��Sr)rZbuild�rrrr�getvalue6szStringIO.getvalueN)r)�__name__�
__module__�__qualname__rr$r&rrrrr)s
r)�BytesIOcCsgSrr)�sizerrr�<lambda>;rr,r)�
BufferFull�	OutOfData�	ExtraData�FormatError�
StackError)�ExtTyper
�ri�cCs(||�|kr||�|kS||�|kSdSrr)�obj�t�type�tuplerrr�_check_type_strictXsr8cCsdzt|�}Wn@tk
rLtrFtt|��}tjdt|�tdd�n�YnX|jdkr`t	d��|S)Nz�using old buffer interface to unpack %s; this leads to unpacking errors if slicing is used and will be removed in a future versionr
��
stacklevelrz$cannot unpack from multi-byte object)
r �	TypeError�PY2�buffer�warnings�warnr6�RuntimeWarning�itemsize�
ValueError)r4�viewrrr�_get_data_from_buffer_s��
rDcKs$tjdtdd�|��}t|f|�S)NzbDirect calling implementation's unpack() is deprecated, Use msgpack.unpack() or unpackb() instead.rr9)r>r?�DeprecationWarning�read�unpackb)�stream�kwargs�datarrr�unpackqs�rKc
Ks�tddt|�i|��}|�|�z|��}WnJtk
rHtd��Yn0tk
rv}zt|�rdt��W5d}~XYnX|�	�r�t
||����|S)aw
    Unpack an object from `packed`.

    Raises ``ExtraData`` when *packed* contains extra bytes.
    Raises ``ValueError`` when *packed* is incomplete.
    Raises ``FormatError`` when *packed* is not valid msgpack.
    Raises ``StackError`` when *packed* contains too nested.
    Other exceptions can be raised during unpacking.

    See :class:`Unpacker` for options.
    N�max_buffer_sizezUnpack failed: incomplete input)N)�Unpackerr
�feed�_unpackr.rB�RecursionErrorrr1�_got_extradatar/�_get_extradata)ZpackedrIZunpacker�retrrrrrGys
rG)r��cCst�|t|�|�S)z.Explicit typcast for legacy struct.unpack_from)�struct�unpack_fromr#)�f�b�orrr�_unpack_from�sr[c@s�eZdZdZdddddddddddedddddfdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zdd�Ze
fdd�Ze
fdd�Zdd�Zdd�ZeZdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�ZdS))rMa�
Streaming unpacker.

    arguments:

    :param file_like:
        File-like object having `.read(n)` method.
        If specified, unpacker reads serialized data from it and :meth:`feed()` is not usable.

    :param int read_size:
        Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`)

    :param bool use_list:
        If true, unpack msgpack array to Python list.
        Otherwise, unpack to Python tuple. (default: True)

    :param bool raw:
        If true, unpack msgpack raw to Python bytes (default).
        Otherwise, unpack to Python str (or unicode on Python 2) by decoding
        with UTF-8 encoding (recommended).
        Currently, the default is true, but it will be changed to false in
        near future.  So you must specify it explicitly for keeping backward
        compatibility.

        *encoding* option which is deprecated overrides this option.

    :param bool strict_map_key:
        If true, only str or bytes are accepted for map (dict) keys.
        It's False by default for backward-compatibility.
        But it will be True from msgpack 1.0.

    :param callable object_hook:
        When specified, it should be callable.
        Unpacker calls it with a dict argument after unpacking msgpack map.
        (See also simplejson)

    :param callable object_pairs_hook:
        When specified, it should be callable.
        Unpacker calls it with a list of key-value pairs after unpacking msgpack map.
        (See also simplejson)

    :param str encoding:
        Encoding used for decoding msgpack raw.
        If it is None (default), msgpack raw is deserialized to Python bytes.

    :param str unicode_errors:
        (deprecated) Used for decoding msgpack raw with *encoding*.
        (default: `'strict'`)

    :param int max_buffer_size:
        Limits size of data waiting unpacked.  0 means system's INT_MAX (default).
        Raises `BufferFull` exception when it is insufficient.
        You should set this parameter when unpacking data from untrusted source.

    :param int max_str_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max length of str. (default: max_buffer_size or 1024*1024)

    :param int max_bin_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max length of bin. (default: max_buffer_size or 1024*1024)

    :param int max_array_len:
        Limits max length of array.
        (default: max_buffer_size or 128*1024)

    :param int max_map_len:
        Limits max length of map.
        (default: max_buffer_size//2 or 32*1024)

    :param int max_ext_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max size of ext type.  (default: max_buffer_size or 1024*1024)

    Example of streaming deserialize from file-like object::

        unpacker = Unpacker(file_like, raw=False, max_buffer_size=10*1024*1024)
        for o in unpacker:
            process(o)

    Example of streaming deserialize from socket::

        unpacker = Unpacker(raw=False, max_buffer_size=10*1024*1024)
        while True:
            buf = sock.recv(1024**2)
            if not buf:
                break
            unpacker.feed(buf)
            for o in unpacker:
                process(o)

    Raises ``ExtraData`` when *packed* contains extra bytes.
    Raises ``OutOfData`` when *packed* is incomplete.
    Raises ``FormatError`` when *packed* is not valid msgpack.
    Raises ``StackError`` when *packed* contains too nested.
    Other exceptions can be raised during unpacking.
    NrTF���cCs�|	dk	rtjdtdd�|
dkr$d}
|dkr4d|_nt|j�sFtd��||_d|_t�|_	d|_
d|_|
d	krv|ptd
}
|d	kr�|p�d
}|d	kr�|p�d}|d	kr�|dp�d}|d	kr�|p�d
}|p�d
|_||jkr�t
d��|p�t|jd�|_t|�|_t|�|_|	|_|
|_||_||_||_||_||_|
|_||_||_||_||_d|_|dk	�rft|��sftd��|dk	�r�t|��s�td��|dk	�r�t|��s�td��|dk	�r�|dk	�r�td��t|��s�td��dS)N�.encoding is deprecated, Use raw=False instead.rr9�strictTz!`file_like.read` must be callableFrr\iii�i���z.read_size must be smaller than max_buffer_sizei@z`list_hook` is not callablez`object_hook` is not callablez#`object_pairs_hook` is not callablez8object_pairs_hook and object_hook are mutually exclusivez`ext_hook` is not callable) r>r?rE�_feeding�callablerFr;�	file_liker"�_buffer�_buff_i�_buf_checkpoint�_max_buffer_sizerB�min�
_read_size�bool�_raw�_strict_map_key�	_encoding�_unicode_errors�	_use_list�
_list_hook�_object_hook�_object_pairs_hook�	_ext_hook�_max_str_len�_max_bin_len�_max_array_len�_max_map_len�_max_ext_len�_stream_offset)rraZ	read_sizeZuse_list�rawZstrict_map_keyZobject_hookZobject_pairs_hookZ	list_hook�encoding�unicode_errorsrLZext_hookZmax_str_lenZmax_bin_lenZ
max_array_lenZmax_map_lenZmax_ext_lenrrrr�sp	�
	




zUnpacker.__init__cCsr|js
t�t|�}t|j�|jt|�|jkr4t�|jdkrb|jd|j�=|j|j8_d|_|j�	|�dS�Nr)
r_�AssertionErrorrDr
rbrcrer-rd�extend)rZ
next_bytesrCrrrrNPs

z
Unpacker.feedcCs"|j|j|j7_|j|_dS)z+ Gets rid of the used parts of the buffer. N)rwrcrdr%rrr�_consume_szUnpacker._consumecCs|jt|j�kSr)rcr
rbr%rrrrQdszUnpacker._got_extradatacCs|j|jd�Sr)rbrcr%rrrrRgszUnpacker._get_extradatacCs
|�|�Sr)�_read�r�nrrr�
read_bytesjszUnpacker.read_bytescCs,|�|�|j}|||_|j|||�Sr)�_reservercrb)rr��irrrrms

zUnpacker._readcCs�t|j�|j|}|dkr dS|jr2|j|_t�|jdkr`|jd|j�=|j|j8_d|_|}|dkr�t|j|�}|j�	|�}|s�q�t
|t�s�t�|j|7_|t|�8}qft|j�||jkr�d|_t�dSr{)
r
rbrcr_rdr.�maxrgrarFrr#r|)rr�Zremain_bytesZ
to_read_bytesZ	read_datarrrr�ts,
zUnpacker._reservecCs&
t}d}d}|�d�|j|j}|jd7_|d@dkrD|}�	n�|d@dkr`d|dA}�	n�|d@dkr�|d@}t}||jkr�td	||j��|�|�}�	n~|d
@dkr�|d@}t}||j	kr�td
||j	���	nJ|d
@dk�r
|d@}t
}||jk�
rtd||j���	n|dk�rd}�	n|dk�r.d}�n�|dk�r@d}�n�|dk�r�t}|�d�|j|j}|jd7_||j
k�r�td||j
f��|�|�}�n~|dk�rt}|�d�td|j|j�d}|jd7_||j
k�r�td||j
f��|�|�}�n|dk�rjt}|�d�td|j|j�d}|jd7_||j
k�r\td||j
f��|�|�}�n�|dk�r�t}|�d�td|j|j�\}}|jd7_||jk�r�td||jf��|�|�}�nL|dk�r6t}|�d �td!|j|j�\}}|jd 7_||jk�r(td||jf��|�|�}�n�|d"k�r�t}|�d#�td$|j|j�\}}|jd#7_||jk�r�td||jf��|�|�}�n�|d%k�r�|�d�td&|j|j�d}|jd7_�nF|d'k�r|�d(�td)|j|j�d}|jd(7_�n|d*k�rB|�d�|j|j}|jd7_�n�|d+k�r||�d�td|j|j�d}|jd7_�n�|d,k�r�|�d�td|j|j�d}|jd7_�nf|d-k�r�|�d(�td.|j|j�d}|jd(7_�n,|d/k�r*|�d�td0|j|j�d}|jd7_�n�|d1k�rd|�d�td2|j|j�d}|jd7_�n�|d3k�r�|�d�td4|j|j�d}|jd7_�n~|d5k�r�|�d(�td6|j|j�d}|jd(7_�nD|d7k�r4t}|jdk�rtdd|jf��|�d�td8|j|j�\}}|jd7_�n�|d9k�r�t}|jdk�r`tdd|jf��|�d �td:|j|j�\}}|jd 7_�n�|d;k�r�t}|jdk�r�tdd|jf��|�d#�td<|j|j�\}}|jd#7_�n0|d=k�rHt}|jd(k�rtdd(|jf��|�d>�td?|j|j�\}}|jd>7_�n�|d@k�r�t}|jdAk�rttddA|jf��|�dB�tdC|j|j�\}}|jdB7_�nx|dDk�r�t}|�d�|j|j}|jd7_||jk�r�td	||j��|�|�}�n|dEk�r^t}|�d�td|j|j�\}|jd7_||jk�rPtd	||j��|�|�}�n�|dFk�r�t}|�d�td|j|j�\}|jd7_||jk�r�td	||j��|�|�}�n^|dGk�	rt}|�d�td|j|j�\}|jd7_||j	k�
rtd
||j	���n|dHk�	rht}|�d�td|j|j�\}|jd7_||j	k�
rtd
||j	��n�|dIk�	r�|�d�td|j|j�\}|jd7_||jk�	r�td||j��t
}n`|dJk�
r|�d�td|j|j�\}|jd7_||jk�
r
td||j��t
}ntdK|��|||fS)LNrr���r\���z%s exceeds max_str_len(%s)����z%s exceeds max_array_len(%s)z%s exceeds max_map_len(%s)���F��T��z%s exceeds max_bin_len(%s)��r�>H��r3�>I��ZBbz%s exceeds max_ext_len(%s)��r
z>Hb��rz>Ib��z>f���z>d��������z>Q��rY��z>h��z>i��z>q��Zb1s��Zb2s��Zb4s���	Zb8s����Zb16s��������������zUnknown header: 0x%x)�TYPE_IMMEDIATEr�rbrc�TYPE_RAWrrrBr�
TYPE_ARRAYrt�TYPE_MAPru�TYPE_BINrsr[�TYPE_EXTrvr0)r�execute�typr�r4rY�Lrrr�_read_header�s�





























































zUnpacker._read_headerc	s*��|�\}}}|tkr,|tkr(td��|S|tkrH|tkrDtd��|S|tkr�|tkrtt|�D]}��t�q`dSt	|�}t|�D]}|�
��t��q��jdk	r���|�}�j
r�|St|�S|tk�r�|tkr�t|�D]}��t���t�q�dS�jdk	�r"���fdd�t|�D��}npi}t|�D]L}��t�}�j�rjt|�ttfk�rjtdtt|������t�||<�q.�jdk	�r���|�}|S|tk�r�dS|tk�r�jdk	�r�|��j�j�}n�j�r�t|�}n
|�d�}|S|tk�r��|t|��S|tk�rt|�S|tk�s&t�|S)NzExpected arrayzExpected mapc3s"|]}��t���t�fVqdSr)rO�EX_CONSTRUCT)�.0�_r%rr�	<genexpr>�s��z#Unpacker._unpack.<locals>.<genexpr>z%s is not allowed for map key�utf_8) r��EX_READ_ARRAY_HEADERr�rB�EX_READ_MAP_HEADERr��EX_SKIP�xrangerOrrr�rnrmr7rprjr6�unicoder#rror�rk�decoderlrir�rqr�r�r|)	rr�r�r�r4r�rSr��keyrr%rrOhsl



�








zUnpacker._unpackcCs|Srrr%rrr�__iter__�szUnpacker.__iter__cCsTz|�t�}|��|WStk
r8|��t�Yntk
rNt�YnXdSr)rOr�r~r.�
StopIterationrPr1�rrSrrr�__next__�s
zUnpacker.__next__cCs|�t�|��dSr)rOr�r~r%rrr�skip�s
z
Unpacker.skipcCs4z|�t�}Wntk
r&t�YnX|��|Sr)rOr�rPr1r~r�rrrrK�s
zUnpacker.unpackcCs|�t�}|��|Sr)rOr�r~r�rrr�read_array_header�s
zUnpacker.read_array_headercCs|�t�}|��|Sr)rOr�r~r�rrr�read_map_header�s
zUnpacker.read_map_headercCs|jSr)rwr%rrr�tell�sz
Unpacker.tell)r'r(r)�__doc__r2rrNr~rQrRr�rr�r�r�rOr�r��nextr�rKr�r�r�rrrrrM�sBa
�
R U@rMc@s�eZdZdZd#dd�Zeeefdd�Zd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zefdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�ZdS)$�Packerah
    MessagePack Packer

    usage:

        packer = Packer()
        astream.write(packer.pack(a))
        astream.write(packer.pack(b))

    Packer's constructor has some keyword arguments:

    :param callable default:
        Convert user type to builtin type that Packer supports.
        See also simplejson's document.

    :param bool use_single_float:
        Use single precision float type for float. (default: False)

    :param bool autoreset:
        Reset buffer after each pack and return its content as `bytes`. (default: True).
        If set this to false, use `bytes()` to get content and `.reset()` to clear buffer.

    :param bool use_bin_type:
        Use bin type introduced in msgpack spec 2.0 for bytes.
        It also enables str8 type for unicode.

    :param bool strict_types:
        If set to true, types will be checked to be exact. Derived classes
        from serializeable types will not be serialized and will be
        treated as unsupported type and forwarded to default.
        Additionally tuples will not be serialized as lists.
        This is useful when trying to implement accurate serialization
        for python types.

    :param str encoding:
        (deprecated) Convert unicode to bytes with this encoding. (default: 'utf-8')

    :param str unicode_errors:
        Error handler for encoding unicode. (default: 'strict')
    NFTcCsx|dkrd}ntjdtdd�|dkr*d}||_||_||_||_||_||_t	�|_
|dk	rnt|�sntd��||_
dS)Nr�r]rr9r^zdefault must be callable)r>r?rE�
_strict_types�
_use_float�
_autoreset�
_use_bin_typerkrlrrbr`r;�_default)r�defaultryrzZuse_single_floatZ	autoresetZuse_bin_typeZstrict_typesrrrr�s(�zPacker.__init__cCs�d}|jr|}t}nttf}|dkr,td��|dkr@|j�d�S||t�rf|rZ|j�d�S|j�d�S||t��r�d|kr�dkr�nn|j�t�	d|��Sd	|kr�dkr�nn|j�t�	d
|��Sd|kr�dkr�nn|j�t�	dd
|��Sd|k�rdk�r*nn|j�t�	dd|��Sd|k�rBdk�r\nn|j�t�	dd|��Sd|k�rtdk�r�nn|j�t�	dd|��Sd|k�r�dk�r�nn|j�t�	dd|��Sd|k�r�dk�r�nn|j�t�	dd|��Sd|k�r
dk�r$nn|j�t�	dd|��Sd |k�r<dk�rVnn|j�t�	d!d"|��S|�sx|j
dk	�rx|�
|�}d#}qtd$��||tt
f��r�t|�}|d%k�r�td&t|�j��|�|�|j�|�S||t��r*|jdk�r�td'��|�|j|j�}t|�}|d%k�rtd(��|�|�|j�|�S||t��rlt|�|j}|d%k�rVtd)��|�|�|j�|�S||t��r�|j�r�|j�t�	d*d+|��S|j�t�	d,d-|��S||t��r�|j}|j}	t|t ��s�t!�t|	t��s�t!�t|	�}
|
d.k�r|j�d/�n�|
d0k�r|j�d1�n�|
d2k�r4|j�d3�n�|
d4k�rL|j�d5�nr|
d6k�rd|j�d7�nZ|
dk�r�|j�t�	d8d9|
��n8|
dk�r�|j�t�	dd:|
��n|j�t�	dd;|
��|j�t�	d
|��|j�|	�dS|||��r(t|�}|�"|�t#|�D]}|�$|||d.��qdS||t%��rN|�&t|�t'|�|d.�S|�sp|j
dk	�rp|�
|�}d.}qtd<|f��qdS)=NFrzrecursion limit exceeded������r��Bi��rYr�ZBBr�i����z>Bbr���>BHr�i���z>Bhr�����>BIr�i�z>Bir�l����z>BQr�l����z>Bqr�TzInteger value out of range�z%s is too largez5Can't encode unicode string: no encoding is specifiedzString is too largezMemoryview is too largez>Bfr�z>Bdr�r��r��r3��r���r���>BBr�r�r�zCannot serialize %r)(r��listr7rBrbr$rh�	int_typesrV�packr��
OverflowErrorr#r"r
r6r'�_pack_bin_headerr�rkr;�encoderl�_pack_raw_headerr rA�floatr�r2�coderJr�intr|�_pack_array_headerr��_pack�dict�_pack_map_pairsr)rr4�
nest_limitZcheckZcheck_type_strictZdefault_usedZ
list_typesr�r�rJr�r�rrrr�s�



�











�
zPacker._packcCsFz|�|�Wnt�|_�YnX|jrB|j��}t�|_|SdSr)r�rrbr�r&)rr4rSrrrr��s
zPacker.packcCs0|�t|�|�|jr,|j��}t�|_|SdSr)r�r
r�rbr&r)r�pairsrSrrr�pack_map_pairs�s

zPacker.pack_map_pairscCs6|dkrt�|�|�|jr2|j��}t�|_|SdS�Nr�)rBr�r�rbr&r�rr�rSrrr�pack_array_header�s

zPacker.pack_array_headercCs6|dkrt�|�|�|jr2|j��}t�|_|SdSr�)rB�_pack_map_headerr�rbr&rr�rrr�pack_map_header�s

zPacker.pack_map_headercCsJt|t�std��d|kr&dks0ntd��t|t�sBtd��t|�}|dkrZtd��|dkrp|j�d	�n�|d
kr�|j�d�n�|dkr�|j�d
�n�|dkr�|j�d�nt|dkr�|j�d�n^|dkr�|j�dt�	d|��n<|dk�r|j�dt�	d|��n|j�dt�	d|��|j�t�	d|��|j�|�dS)Nztypecode must have int type.r�ztypecode should be 0-127zdata must have bytes typer�zToo large datarr�rr�r3r�r�r�r�r�r���r�r���r���r�)
rr�r;rBr#r
rbr$rVr�)r�typecoderJr�rrr�
pack_ext_type�s4


zPacker.pack_ext_typecCsh|dkr |j�t�dd|��S|dkr>|j�t�dd|��S|dkr\|j�t�dd	|��Std
��dS)Nr�r�r�r�r�r�r�r�r�zArray is too large�rbr$rVr�rBr�rrrr��szPacker._pack_array_headercCsh|dkr |j�t�dd|��S|dkr>|j�t�dd|��S|dkr\|j�t�dd	|��Std
��dS)Nr�r�r�r�r�r�r�r�r�zDict is too largerr�rrrr��szPacker._pack_map_headercCs<|�|�|D](\}}|�||d�|�||d�qdS)Nr)r�r�)rr�r�r��k�vrrrr��s
zPacker._pack_map_pairscCs�|dkr"|j�t�dd|��nn|jrH|dkrH|j�t�dd|��nH|dkrh|j�t�dd	|��n(|d
kr�|j�t�dd|��ntd
��dS)Nr�r�r�r�r�r�r�r�r�r�r�r�zRaw is too large)rbr$rVr�r�rBr�rrrr��szPacker._pack_raw_headercCsv|js|�|�S|dkr.|j�t�dd|��S|dkrL|j�t�dd|��S|dkrj|j�t�dd	|��Std
��dS)Nr�r�r�r�r�r�r�r�r�zBin is too large)r�r�rbr$rVr�rBr�rrrr��s
zPacker._pack_bin_headercCs
|j��S)z/Return internal buffer contents as bytes object)rbr&r%rrrr#�szPacker.bytescCst�|_dS)zYReset internal buffer.

        This method is usaful only when autoreset=False.
        N)rrbr%rrr�reset�szPacker.resetcCs"tstrt|���S|j��SdS)zReturn view of internal buffer.N)�USING_STRINGBUILDERr<r r#rb�	getbufferr%rrrr
�szPacker.getbuffer)NNNFTFF)r'r(r)r�r�DEFAULT_RECURSE_LIMITrr8r�r�r�r�r�rr�r�r�r�r�r#rr
rrrrr��s0(�
�
n				r�)r):r��sysrVr>�version_infor<r�Zlongr�rrr��ranger��RuntimeErrorrPr�hasattrZ__pypy__rZ__pypy__.buildersrr�ImportErrorr	�objectr�ior*�
exceptionsr-r.r/r0r1�r2r�r�r�r�r�r�r�r�r�r�rr6r7r8rDrKrGr[rWrMr�rrrr�<module>sj



:site-packages/pip/_vendor/msgpack/__pycache__/_version.cpython-38.pyc000064400000000266151446177000021632 0ustar00U

��.e�@sdZdS))���N)�version�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/_version.py�<module>�site-packages/pip/_vendor/msgpack/__pycache__/_version.cpython-38.opt-1.pyc000064400000000266151446177000022571 0ustar00U

��.e�@sdZdS))���N)�version�rr�@/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/_version.py�<module>�site-packages/pip/_vendor/msgpack/__pycache__/exceptions.cpython-38.opt-1.pyc000064400000003430151446177000023122 0ustar00U

��.e9�@sxGdd�de�ZGdd�de�ZGdd�de�ZGdd�dee�ZGdd	�d	ee�ZeZGd
d�de�ZeZ	eZ
eZdS)
c@seZdZdZdS)�UnpackExceptionz�Base class for some exceptions raised while unpacking.

    NOTE: unpack may raise exception other than subclass of
    UnpackException.  If you want to catch all error, catch
    Exception instead.
    N��__name__�
__module__�__qualname__�__doc__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/exceptions.pyrsrc@seZdZdS)�
BufferFullN�rrrrrrrr	
sr	c@seZdZdS)�	OutOfDataNr
rrrrrsrc@seZdZdZdS)�FormatErrorzInvalid msgpack formatNrrrrrrsrc@seZdZdZdS)�
StackErrorz
Too nestedNrrrrrr
sr
c@s eZdZdZdd�Zdd�ZdS)�	ExtraDataz�ExtraData is raised when there is trailing data.

    This exception is raised while only one-shot (not streaming)
    unpack.
    cCs||_||_dS)N)�unpacked�extra)�selfrrrrr�__init__%szExtraData.__init__cCsdS)Nzunpack(b) received extra data.r)rrrr�__str__)szExtraData.__str__N)rrrrrrrrrrrsrN)
�	Exceptionrr	r�
ValueErrorrr
ZUnpackValueErrorrZ
PackExceptionZPackValueError�
OverflowErrorZPackOverflowErrorrrrr�<module>s	site-packages/pip/_vendor/msgpack/__pycache__/__init__.cpython-38.pyc000064400000003576151446177000021554 0ustar00U

��.e��@s�ddlmZddlTddlmZGdd�dedd��ZddlZej�d	�r`dd
l	m
Z
mZmZnBzdd
l
m
Z
mZmZWn(ek
r�dd
l	m
Z
mZmZYnXdd�Zd
d�Zdd�ZeZeZeZeZdS)�)�version)�*�)�
namedtuplecs eZdZdZ�fdd�Z�ZS)�ExtTypez'ExtType represents ext type in msgpack.csVt|t�std��t|t�s$td��d|kr8dksBntd��tt|��|||�S)Nzcode must be intzdata must be bytesr�zcode must be 0~127)�
isinstance�int�	TypeError�bytes�
ValueError�superr�__new__)�cls�code�data��	__class__��@/usr/lib/python3.8/site-packages/pip/_vendor/msgpack/__init__.pyr
s

zExtType.__new__)�__name__�
__module__�__qualname__�__doc__r�
__classcell__rrrrrsrz	code dataNZMSGPACK_PUREPYTHON)�Packer�unpackb�UnpackercKstf|�}|�|�|��dS)zX
    Pack object `o` and write it to `stream`

    See :class:`Packer` for options.
    N)r�write�pack)�o�stream�kwargsZpackerrrrrs
rcKstf|��|�S)zW
    Pack object `o` and return packed bytes

    See :class:`Packer` for options.
    )rr)r r"rrr�packb(sr#cKs|��}t|f|�S)z�
    Unpack an object from `stream`.

    Raises `ExtraData` when `stream` contains extra bytes.
    See :class:`Unpacker` for options.
    )�readr)r!r"rrrr�unpack1sr%)Z_versionr�
exceptions�collectionsrr�os�environ�getZfallbackrrrZ	_cmsgpack�ImportErrorrr#r%�load�loads�dump�dumpsrrrr�<module>s"
	site-packages/pip/_vendor/msgpack/__init__.py000064400000002777151446177000015270 0ustar00# coding: utf-8
from ._version import version
from .exceptions import *

from collections import namedtuple


class ExtType(namedtuple('ExtType', 'code data')):
    """ExtType represents ext type in msgpack."""
    def __new__(cls, code, data):
        if not isinstance(code, int):
            raise TypeError("code must be int")
        if not isinstance(data, bytes):
            raise TypeError("data must be bytes")
        if not 0 <= code <= 127:
            raise ValueError("code must be 0~127")
        return super(ExtType, cls).__new__(cls, code, data)


import os
if os.environ.get('MSGPACK_PUREPYTHON'):
    from .fallback import Packer, unpackb, Unpacker
else:
    try:
        from ._cmsgpack import Packer, unpackb, Unpacker
    except ImportError:
        from .fallback import Packer, unpackb, Unpacker


def pack(o, stream, **kwargs):
    """
    Pack object `o` and write it to `stream`

    See :class:`Packer` for options.
    """
    packer = Packer(**kwargs)
    stream.write(packer.pack(o))


def packb(o, **kwargs):
    """
    Pack object `o` and return packed bytes

    See :class:`Packer` for options.
    """
    return Packer(**kwargs).pack(o)


def unpack(stream, **kwargs):
    """
    Unpack an object from `stream`.

    Raises `ExtraData` when `stream` contains extra bytes.
    See :class:`Unpacker` for options.
    """
    data = stream.read()
    return unpackb(data, **kwargs)


# alias for compatibility to simplejson/marshal/pickle.
load = unpack
loads = unpackb

dump = pack
dumps = packb
site-packages/pip/_vendor/msgpack/fallback.py000064400000111116151446177000015254 0ustar00"""Fallback pure Python implementation of msgpack"""

import sys
import struct
import warnings


if sys.version_info[0] == 2:
    PY2 = True
    int_types = (int, long)
    def dict_iteritems(d):
        return d.iteritems()
else:
    PY2 = False
    int_types = int
    unicode = str
    xrange = range
    def dict_iteritems(d):
        return d.items()

if sys.version_info < (3, 5):
    # Ugly hack...
    RecursionError = RuntimeError

    def _is_recursionerror(e):
        return len(e.args) == 1 and isinstance(e.args[0], str) and \
            e.args[0].startswith('maximum recursion depth exceeded')
else:
    def _is_recursionerror(e):
        return True

if hasattr(sys, 'pypy_version_info'):
    # cStringIO is slow on PyPy, StringIO is faster.  However: PyPy's own
    # StringBuilder is fastest.
    from __pypy__ import newlist_hint
    try:
        from __pypy__.builders import BytesBuilder as StringBuilder
    except ImportError:
        from __pypy__.builders import StringBuilder
    USING_STRINGBUILDER = True
    class StringIO(object):
        def __init__(self, s=b''):
            if s:
                self.builder = StringBuilder(len(s))
                self.builder.append(s)
            else:
                self.builder = StringBuilder()
        def write(self, s):
            if isinstance(s, memoryview):
                s = s.tobytes()
            elif isinstance(s, bytearray):
                s = bytes(s)
            self.builder.append(s)
        def getvalue(self):
            return self.builder.build()
else:
    USING_STRINGBUILDER = False
    from io import BytesIO as StringIO
    newlist_hint = lambda size: []


from .exceptions import (
    BufferFull,
    OutOfData,
    ExtraData,
    FormatError,
    StackError,
)

from . import ExtType


EX_SKIP                 = 0
EX_CONSTRUCT            = 1
EX_READ_ARRAY_HEADER    = 2
EX_READ_MAP_HEADER      = 3

TYPE_IMMEDIATE          = 0
TYPE_ARRAY              = 1
TYPE_MAP                = 2
TYPE_RAW                = 3
TYPE_BIN                = 4
TYPE_EXT                = 5

DEFAULT_RECURSE_LIMIT = 511


def _check_type_strict(obj, t, type=type, tuple=tuple):
    if type(t) is tuple:
        return type(obj) in t
    else:
        return type(obj) is t


def _get_data_from_buffer(obj):
    try:
        view = memoryview(obj)
    except TypeError:
        # try to use legacy buffer protocol if 2.7, otherwise re-raise
        if PY2:
            view = memoryview(buffer(obj))
            warnings.warn("using old buffer interface to unpack %s; "
                          "this leads to unpacking errors if slicing is used and "
                          "will be removed in a future version" % type(obj),
                          RuntimeWarning, stacklevel=3)
        else:
            raise
    if view.itemsize != 1:
        raise ValueError("cannot unpack from multi-byte object")
    return view


def unpack(stream, **kwargs):
    warnings.warn(
        "Direct calling implementation's unpack() is deprecated, Use msgpack.unpack() or unpackb() instead.",
        DeprecationWarning, stacklevel=2)
    data = stream.read()
    return unpackb(data, **kwargs)


def unpackb(packed, **kwargs):
    """
    Unpack an object from `packed`.

    Raises ``ExtraData`` when *packed* contains extra bytes.
    Raises ``ValueError`` when *packed* is incomplete.
    Raises ``FormatError`` when *packed* is not valid msgpack.
    Raises ``StackError`` when *packed* contains too nested.
    Other exceptions can be raised during unpacking.

    See :class:`Unpacker` for options.
    """
    unpacker = Unpacker(None, max_buffer_size=len(packed), **kwargs)
    unpacker.feed(packed)
    try:
        ret = unpacker._unpack()
    except OutOfData:
        raise ValueError("Unpack failed: incomplete input")
    except RecursionError as e:
        if _is_recursionerror(e):
            raise StackError
        raise
    if unpacker._got_extradata():
        raise ExtraData(ret, unpacker._get_extradata())
    return ret


if sys.version_info < (2, 7, 6):
    def _unpack_from(f, b, o=0):
        """Explicit typcast for legacy struct.unpack_from"""
        return struct.unpack_from(f, bytes(b), o)
else:
    _unpack_from = struct.unpack_from


class Unpacker(object):
    """Streaming unpacker.

    arguments:

    :param file_like:
        File-like object having `.read(n)` method.
        If specified, unpacker reads serialized data from it and :meth:`feed()` is not usable.

    :param int read_size:
        Used as `file_like.read(read_size)`. (default: `min(16*1024, max_buffer_size)`)

    :param bool use_list:
        If true, unpack msgpack array to Python list.
        Otherwise, unpack to Python tuple. (default: True)

    :param bool raw:
        If true, unpack msgpack raw to Python bytes (default).
        Otherwise, unpack to Python str (or unicode on Python 2) by decoding
        with UTF-8 encoding (recommended).
        Currently, the default is true, but it will be changed to false in
        near future.  So you must specify it explicitly for keeping backward
        compatibility.

        *encoding* option which is deprecated overrides this option.

    :param bool strict_map_key:
        If true, only str or bytes are accepted for map (dict) keys.
        It's False by default for backward-compatibility.
        But it will be True from msgpack 1.0.

    :param callable object_hook:
        When specified, it should be callable.
        Unpacker calls it with a dict argument after unpacking msgpack map.
        (See also simplejson)

    :param callable object_pairs_hook:
        When specified, it should be callable.
        Unpacker calls it with a list of key-value pairs after unpacking msgpack map.
        (See also simplejson)

    :param str encoding:
        Encoding used for decoding msgpack raw.
        If it is None (default), msgpack raw is deserialized to Python bytes.

    :param str unicode_errors:
        (deprecated) Used for decoding msgpack raw with *encoding*.
        (default: `'strict'`)

    :param int max_buffer_size:
        Limits size of data waiting unpacked.  0 means system's INT_MAX (default).
        Raises `BufferFull` exception when it is insufficient.
        You should set this parameter when unpacking data from untrusted source.

    :param int max_str_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max length of str. (default: max_buffer_size or 1024*1024)

    :param int max_bin_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max length of bin. (default: max_buffer_size or 1024*1024)

    :param int max_array_len:
        Limits max length of array.
        (default: max_buffer_size or 128*1024)

    :param int max_map_len:
        Limits max length of map.
        (default: max_buffer_size//2 or 32*1024)

    :param int max_ext_len:
        Deprecated, use *max_buffer_size* instead.
        Limits max size of ext type.  (default: max_buffer_size or 1024*1024)

    Example of streaming deserialize from file-like object::

        unpacker = Unpacker(file_like, raw=False, max_buffer_size=10*1024*1024)
        for o in unpacker:
            process(o)

    Example of streaming deserialize from socket::

        unpacker = Unpacker(raw=False, max_buffer_size=10*1024*1024)
        while True:
            buf = sock.recv(1024**2)
            if not buf:
                break
            unpacker.feed(buf)
            for o in unpacker:
                process(o)

    Raises ``ExtraData`` when *packed* contains extra bytes.
    Raises ``OutOfData`` when *packed* is incomplete.
    Raises ``FormatError`` when *packed* is not valid msgpack.
    Raises ``StackError`` when *packed* contains too nested.
    Other exceptions can be raised during unpacking.
    """

    def __init__(self, file_like=None, read_size=0, use_list=True, raw=True, strict_map_key=False,
                 object_hook=None, object_pairs_hook=None, list_hook=None,
                 encoding=None, unicode_errors=None, max_buffer_size=0,
                 ext_hook=ExtType,
                 max_str_len=-1,
                 max_bin_len=-1,
                 max_array_len=-1,
                 max_map_len=-1,
                 max_ext_len=-1):
        if encoding is not None:
            warnings.warn(
                "encoding is deprecated, Use raw=False instead.",
                DeprecationWarning, stacklevel=2)

        if unicode_errors is None:
            unicode_errors = 'strict'

        if file_like is None:
            self._feeding = True
        else:
            if not callable(file_like.read):
                raise TypeError("`file_like.read` must be callable")
            self.file_like = file_like
            self._feeding = False

        #: array of bytes fed.
        self._buffer = bytearray()
        #: Which position we currently reads
        self._buff_i = 0

        # When Unpacker is used as an iterable, between the calls to next(),
        # the buffer is not "consumed" completely, for efficiency sake.
        # Instead, it is done sloppily.  To make sure we raise BufferFull at
        # the correct moments, we have to keep track of how sloppy we were.
        # Furthermore, when the buffer is incomplete (that is: in the case
        # we raise an OutOfData) we need to rollback the buffer to the correct
        # state, which _buf_checkpoint records.
        self._buf_checkpoint = 0

        if max_str_len == -1:
            max_str_len = max_buffer_size or 1024*1024
        if max_bin_len == -1:
            max_bin_len = max_buffer_size or 1024*1024
        if max_array_len == -1:
            max_array_len = max_buffer_size or 128*1024
        if max_map_len == -1:
            max_map_len = max_buffer_size//2 or 32*1024
        if max_ext_len == -1:
            max_ext_len = max_buffer_size or 1024*1024

        self._max_buffer_size = max_buffer_size or 2**31-1
        if read_size > self._max_buffer_size:
            raise ValueError("read_size must be smaller than max_buffer_size")
        self._read_size = read_size or min(self._max_buffer_size, 16*1024)
        self._raw = bool(raw)
        self._strict_map_key = bool(strict_map_key)
        self._encoding = encoding
        self._unicode_errors = unicode_errors
        self._use_list = use_list
        self._list_hook = list_hook
        self._object_hook = object_hook
        self._object_pairs_hook = object_pairs_hook
        self._ext_hook = ext_hook
        self._max_str_len = max_str_len
        self._max_bin_len = max_bin_len
        self._max_array_len = max_array_len
        self._max_map_len = max_map_len
        self._max_ext_len = max_ext_len
        self._stream_offset = 0

        if list_hook is not None and not callable(list_hook):
            raise TypeError('`list_hook` is not callable')
        if object_hook is not None and not callable(object_hook):
            raise TypeError('`object_hook` is not callable')
        if object_pairs_hook is not None and not callable(object_pairs_hook):
            raise TypeError('`object_pairs_hook` is not callable')
        if object_hook is not None and object_pairs_hook is not None:
            raise TypeError("object_pairs_hook and object_hook are mutually "
                            "exclusive")
        if not callable(ext_hook):
            raise TypeError("`ext_hook` is not callable")

    def feed(self, next_bytes):
        assert self._feeding
        view = _get_data_from_buffer(next_bytes)
        if (len(self._buffer) - self._buff_i + len(view) > self._max_buffer_size):
            raise BufferFull

        # Strip buffer before checkpoint before reading file.
        if self._buf_checkpoint > 0:
            del self._buffer[:self._buf_checkpoint]
            self._buff_i -= self._buf_checkpoint
            self._buf_checkpoint = 0

        # Use extend here: INPLACE_ADD += doesn't reliably typecast memoryview in jython
        self._buffer.extend(view)

    def _consume(self):
        """ Gets rid of the used parts of the buffer. """
        self._stream_offset += self._buff_i - self._buf_checkpoint
        self._buf_checkpoint = self._buff_i

    def _got_extradata(self):
        return self._buff_i < len(self._buffer)

    def _get_extradata(self):
        return self._buffer[self._buff_i:]

    def read_bytes(self, n):
        return self._read(n)

    def _read(self, n):
        # (int) -> bytearray
        self._reserve(n)
        i = self._buff_i
        self._buff_i = i+n
        return self._buffer[i:i+n]

    def _reserve(self, n):
        remain_bytes = len(self._buffer) - self._buff_i - n

        # Fast path: buffer has n bytes already
        if remain_bytes >= 0:
            return

        if self._feeding:
            self._buff_i = self._buf_checkpoint
            raise OutOfData

        # Strip buffer before checkpoint before reading file.
        if self._buf_checkpoint > 0:
            del self._buffer[:self._buf_checkpoint]
            self._buff_i -= self._buf_checkpoint
            self._buf_checkpoint = 0

        # Read from file
        remain_bytes = -remain_bytes
        while remain_bytes > 0:
            to_read_bytes = max(self._read_size, remain_bytes)
            read_data = self.file_like.read(to_read_bytes)
            if not read_data:
                break
            assert isinstance(read_data, bytes)
            self._buffer += read_data
            remain_bytes -= len(read_data)

        if len(self._buffer) < n + self._buff_i:
            self._buff_i = 0  # rollback
            raise OutOfData

    def _read_header(self, execute=EX_CONSTRUCT):
        typ = TYPE_IMMEDIATE
        n = 0
        obj = None
        self._reserve(1)
        b = self._buffer[self._buff_i]
        self._buff_i += 1
        if b & 0b10000000 == 0:
            obj = b
        elif b & 0b11100000 == 0b11100000:
            obj = -1 - (b ^ 0xff)
        elif b & 0b11100000 == 0b10100000:
            n = b & 0b00011111
            typ = TYPE_RAW
            if n > self._max_str_len:
                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
            obj = self._read(n)
        elif b & 0b11110000 == 0b10010000:
            n = b & 0b00001111
            typ = TYPE_ARRAY
            if n > self._max_array_len:
                raise ValueError("%s exceeds max_array_len(%s)", n, self._max_array_len)
        elif b & 0b11110000 == 0b10000000:
            n = b & 0b00001111
            typ = TYPE_MAP
            if n > self._max_map_len:
                raise ValueError("%s exceeds max_map_len(%s)", n, self._max_map_len)
        elif b == 0xc0:
            obj = None
        elif b == 0xc2:
            obj = False
        elif b == 0xc3:
            obj = True
        elif b == 0xc4:
            typ = TYPE_BIN
            self._reserve(1)
            n = self._buffer[self._buff_i]
            self._buff_i += 1
            if n > self._max_bin_len:
                raise ValueError("%s exceeds max_bin_len(%s)" % (n, self._max_bin_len))
            obj = self._read(n)
        elif b == 0xc5:
            typ = TYPE_BIN
            self._reserve(2)
            n = _unpack_from(">H", self._buffer, self._buff_i)[0]
            self._buff_i += 2
            if n > self._max_bin_len:
                raise ValueError("%s exceeds max_bin_len(%s)" % (n, self._max_bin_len))
            obj = self._read(n)
        elif b == 0xc6:
            typ = TYPE_BIN
            self._reserve(4)
            n = _unpack_from(">I", self._buffer, self._buff_i)[0]
            self._buff_i += 4
            if n > self._max_bin_len:
                raise ValueError("%s exceeds max_bin_len(%s)" % (n, self._max_bin_len))
            obj = self._read(n)
        elif b == 0xc7:  # ext 8
            typ = TYPE_EXT
            self._reserve(2)
            L, n = _unpack_from('Bb', self._buffer, self._buff_i)
            self._buff_i += 2
            if L > self._max_ext_len:
                raise ValueError("%s exceeds max_ext_len(%s)" % (L, self._max_ext_len))
            obj = self._read(L)
        elif b == 0xc8:  # ext 16
            typ = TYPE_EXT
            self._reserve(3)
            L, n = _unpack_from('>Hb', self._buffer, self._buff_i)
            self._buff_i += 3
            if L > self._max_ext_len:
                raise ValueError("%s exceeds max_ext_len(%s)" % (L, self._max_ext_len))
            obj = self._read(L)
        elif b == 0xc9:  # ext 32
            typ = TYPE_EXT
            self._reserve(5)
            L, n = _unpack_from('>Ib', self._buffer, self._buff_i)
            self._buff_i += 5
            if L > self._max_ext_len:
                raise ValueError("%s exceeds max_ext_len(%s)" % (L, self._max_ext_len))
            obj = self._read(L)
        elif b == 0xca:
            self._reserve(4)
            obj = _unpack_from(">f", self._buffer, self._buff_i)[0]
            self._buff_i += 4
        elif b == 0xcb:
            self._reserve(8)
            obj = _unpack_from(">d", self._buffer, self._buff_i)[0]
            self._buff_i += 8
        elif b == 0xcc:
            self._reserve(1)
            obj = self._buffer[self._buff_i]
            self._buff_i += 1
        elif b == 0xcd:
            self._reserve(2)
            obj = _unpack_from(">H", self._buffer, self._buff_i)[0]
            self._buff_i += 2
        elif b == 0xce:
            self._reserve(4)
            obj = _unpack_from(">I", self._buffer, self._buff_i)[0]
            self._buff_i += 4
        elif b == 0xcf:
            self._reserve(8)
            obj = _unpack_from(">Q", self._buffer, self._buff_i)[0]
            self._buff_i += 8
        elif b == 0xd0:
            self._reserve(1)
            obj = _unpack_from("b", self._buffer, self._buff_i)[0]
            self._buff_i += 1
        elif b == 0xd1:
            self._reserve(2)
            obj = _unpack_from(">h", self._buffer, self._buff_i)[0]
            self._buff_i += 2
        elif b == 0xd2:
            self._reserve(4)
            obj = _unpack_from(">i", self._buffer, self._buff_i)[0]
            self._buff_i += 4
        elif b == 0xd3:
            self._reserve(8)
            obj = _unpack_from(">q", self._buffer, self._buff_i)[0]
            self._buff_i += 8
        elif b == 0xd4:  # fixext 1
            typ = TYPE_EXT
            if self._max_ext_len < 1:
                raise ValueError("%s exceeds max_ext_len(%s)" % (1, self._max_ext_len))
            self._reserve(2)
            n, obj = _unpack_from("b1s", self._buffer, self._buff_i)
            self._buff_i += 2
        elif b == 0xd5:  # fixext 2
            typ = TYPE_EXT
            if self._max_ext_len < 2:
                raise ValueError("%s exceeds max_ext_len(%s)" % (2, self._max_ext_len))
            self._reserve(3)
            n, obj = _unpack_from("b2s", self._buffer, self._buff_i)
            self._buff_i += 3
        elif b == 0xd6:  # fixext 4
            typ = TYPE_EXT
            if self._max_ext_len < 4:
                raise ValueError("%s exceeds max_ext_len(%s)" % (4, self._max_ext_len))
            self._reserve(5)
            n, obj = _unpack_from("b4s", self._buffer, self._buff_i)
            self._buff_i += 5
        elif b == 0xd7:  # fixext 8
            typ = TYPE_EXT
            if self._max_ext_len < 8:
                raise ValueError("%s exceeds max_ext_len(%s)" % (8, self._max_ext_len))
            self._reserve(9)
            n, obj = _unpack_from("b8s", self._buffer, self._buff_i)
            self._buff_i += 9
        elif b == 0xd8:  # fixext 16
            typ = TYPE_EXT
            if self._max_ext_len < 16:
                raise ValueError("%s exceeds max_ext_len(%s)" % (16, self._max_ext_len))
            self._reserve(17)
            n, obj = _unpack_from("b16s", self._buffer, self._buff_i)
            self._buff_i += 17
        elif b == 0xd9:
            typ = TYPE_RAW
            self._reserve(1)
            n = self._buffer[self._buff_i]
            self._buff_i += 1
            if n > self._max_str_len:
                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
            obj = self._read(n)
        elif b == 0xda:
            typ = TYPE_RAW
            self._reserve(2)
            n, = _unpack_from(">H", self._buffer, self._buff_i)
            self._buff_i += 2
            if n > self._max_str_len:
                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
            obj = self._read(n)
        elif b == 0xdb:
            typ = TYPE_RAW
            self._reserve(4)
            n, = _unpack_from(">I", self._buffer, self._buff_i)
            self._buff_i += 4
            if n > self._max_str_len:
                raise ValueError("%s exceeds max_str_len(%s)", n, self._max_str_len)
            obj = self._read(n)
        elif b == 0xdc:
            typ = TYPE_ARRAY
            self._reserve(2)
            n, = _unpack_from(">H", self._buffer, self._buff_i)
            self._buff_i += 2
            if n > self._max_array_len:
                raise ValueError("%s exceeds max_array_len(%s)", n, self._max_array_len)
        elif b == 0xdd:
            typ = TYPE_ARRAY
            self._reserve(4)
            n, = _unpack_from(">I", self._buffer, self._buff_i)
            self._buff_i += 4
            if n > self._max_array_len:
                raise ValueError("%s exceeds max_array_len(%s)", n, self._max_array_len)
        elif b == 0xde:
            self._reserve(2)
            n, = _unpack_from(">H", self._buffer, self._buff_i)
            self._buff_i += 2
            if n > self._max_map_len:
                raise ValueError("%s exceeds max_map_len(%s)", n, self._max_map_len)
            typ = TYPE_MAP
        elif b == 0xdf:
            self._reserve(4)
            n, = _unpack_from(">I", self._buffer, self._buff_i)
            self._buff_i += 4
            if n > self._max_map_len:
                raise ValueError("%s exceeds max_map_len(%s)", n, self._max_map_len)
            typ = TYPE_MAP
        else:
            raise FormatError("Unknown header: 0x%x" % b)
        return typ, n, obj

    def _unpack(self, execute=EX_CONSTRUCT):
        typ, n, obj = self._read_header(execute)

        if execute == EX_READ_ARRAY_HEADER:
            if typ != TYPE_ARRAY:
                raise ValueError("Expected array")
            return n
        if execute == EX_READ_MAP_HEADER:
            if typ != TYPE_MAP:
                raise ValueError("Expected map")
            return n
        # TODO should we eliminate the recursion?
        if typ == TYPE_ARRAY:
            if execute == EX_SKIP:
                for i in xrange(n):
                    # TODO check whether we need to call `list_hook`
                    self._unpack(EX_SKIP)
                return
            ret = newlist_hint(n)
            for i in xrange(n):
                ret.append(self._unpack(EX_CONSTRUCT))
            if self._list_hook is not None:
                ret = self._list_hook(ret)
            # TODO is the interaction between `list_hook` and `use_list` ok?
            return ret if self._use_list else tuple(ret)
        if typ == TYPE_MAP:
            if execute == EX_SKIP:
                for i in xrange(n):
                    # TODO check whether we need to call hooks
                    self._unpack(EX_SKIP)
                    self._unpack(EX_SKIP)
                return
            if self._object_pairs_hook is not None:
                ret = self._object_pairs_hook(
                    (self._unpack(EX_CONSTRUCT),
                     self._unpack(EX_CONSTRUCT))
                    for _ in xrange(n))
            else:
                ret = {}
                for _ in xrange(n):
                    key = self._unpack(EX_CONSTRUCT)
                    if self._strict_map_key and type(key) not in (unicode, bytes):
                        raise ValueError("%s is not allowed for map key" % str(type(key)))
                    ret[key] = self._unpack(EX_CONSTRUCT)
                if self._object_hook is not None:
                    ret = self._object_hook(ret)
            return ret
        if execute == EX_SKIP:
            return
        if typ == TYPE_RAW:
            if self._encoding is not None:
                obj = obj.decode(self._encoding, self._unicode_errors)
            elif self._raw:
                obj = bytes(obj)
            else:
                obj = obj.decode('utf_8')
            return obj
        if typ == TYPE_EXT:
            return self._ext_hook(n, bytes(obj))
        if typ == TYPE_BIN:
            return bytes(obj)
        assert typ == TYPE_IMMEDIATE
        return obj

    def __iter__(self):
        return self

    def __next__(self):
        try:
            ret = self._unpack(EX_CONSTRUCT)
            self._consume()
            return ret
        except OutOfData:
            self._consume()
            raise StopIteration
        except RecursionError:
            raise StackError

    next = __next__

    def skip(self):
        self._unpack(EX_SKIP)
        self._consume()

    def unpack(self):
        try:
            ret = self._unpack(EX_CONSTRUCT)
        except RecursionError:
            raise StackError
        self._consume()
        return ret

    def read_array_header(self):
        ret = self._unpack(EX_READ_ARRAY_HEADER)
        self._consume()
        return ret

    def read_map_header(self):
        ret = self._unpack(EX_READ_MAP_HEADER)
        self._consume()
        return ret

    def tell(self):
        return self._stream_offset


class Packer(object):
    """
    MessagePack Packer

    usage:

        packer = Packer()
        astream.write(packer.pack(a))
        astream.write(packer.pack(b))

    Packer's constructor has some keyword arguments:

    :param callable default:
        Convert user type to builtin type that Packer supports.
        See also simplejson's document.

    :param bool use_single_float:
        Use single precision float type for float. (default: False)

    :param bool autoreset:
        Reset buffer after each pack and return its content as `bytes`. (default: True).
        If set this to false, use `bytes()` to get content and `.reset()` to clear buffer.

    :param bool use_bin_type:
        Use bin type introduced in msgpack spec 2.0 for bytes.
        It also enables str8 type for unicode.

    :param bool strict_types:
        If set to true, types will be checked to be exact. Derived classes
        from serializeable types will not be serialized and will be
        treated as unsupported type and forwarded to default.
        Additionally tuples will not be serialized as lists.
        This is useful when trying to implement accurate serialization
        for python types.

    :param str encoding:
        (deprecated) Convert unicode to bytes with this encoding. (default: 'utf-8')

    :param str unicode_errors:
        Error handler for encoding unicode. (default: 'strict')
    """
    def __init__(self, default=None, encoding=None, unicode_errors=None,
                 use_single_float=False, autoreset=True, use_bin_type=False,
                 strict_types=False):
        if encoding is None:
            encoding = 'utf_8'
        else:
            warnings.warn(
                "encoding is deprecated, Use raw=False instead.",
                DeprecationWarning, stacklevel=2)

        if unicode_errors is None:
            unicode_errors = 'strict'

        self._strict_types = strict_types
        self._use_float = use_single_float
        self._autoreset = autoreset
        self._use_bin_type = use_bin_type
        self._encoding = encoding
        self._unicode_errors = unicode_errors
        self._buffer = StringIO()
        if default is not None:
            if not callable(default):
                raise TypeError("default must be callable")
        self._default = default

    def _pack(self, obj, nest_limit=DEFAULT_RECURSE_LIMIT,
              check=isinstance, check_type_strict=_check_type_strict):
        default_used = False
        if self._strict_types:
            check = check_type_strict
            list_types = list
        else:
            list_types = (list, tuple)
        while True:
            if nest_limit < 0:
                raise ValueError("recursion limit exceeded")
            if obj is None:
                return self._buffer.write(b"\xc0")
            if check(obj, bool):
                if obj:
                    return self._buffer.write(b"\xc3")
                return self._buffer.write(b"\xc2")
            if check(obj, int_types):
                if 0 <= obj < 0x80:
                    return self._buffer.write(struct.pack("B", obj))
                if -0x20 <= obj < 0:
                    return self._buffer.write(struct.pack("b", obj))
                if 0x80 <= obj <= 0xff:
                    return self._buffer.write(struct.pack("BB", 0xcc, obj))
                if -0x80 <= obj < 0:
                    return self._buffer.write(struct.pack(">Bb", 0xd0, obj))
                if 0xff < obj <= 0xffff:
                    return self._buffer.write(struct.pack(">BH", 0xcd, obj))
                if -0x8000 <= obj < -0x80:
                    return self._buffer.write(struct.pack(">Bh", 0xd1, obj))
                if 0xffff < obj <= 0xffffffff:
                    return self._buffer.write(struct.pack(">BI", 0xce, obj))
                if -0x80000000 <= obj < -0x8000:
                    return self._buffer.write(struct.pack(">Bi", 0xd2, obj))
                if 0xffffffff < obj <= 0xffffffffffffffff:
                    return self._buffer.write(struct.pack(">BQ", 0xcf, obj))
                if -0x8000000000000000 <= obj < -0x80000000:
                    return self._buffer.write(struct.pack(">Bq", 0xd3, obj))
                if not default_used and self._default is not None:
                    obj = self._default(obj)
                    default_used = True
                    continue
                raise OverflowError("Integer value out of range")
            if check(obj, (bytes, bytearray)):
                n = len(obj)
                if n >= 2**32:
                    raise ValueError("%s is too large" % type(obj).__name__)
                self._pack_bin_header(n)
                return self._buffer.write(obj)
            if check(obj, unicode):
                if self._encoding is None:
                    raise TypeError(
                        "Can't encode unicode string: "
                        "no encoding is specified")
                obj = obj.encode(self._encoding, self._unicode_errors)
                n = len(obj)
                if n >= 2**32:
                    raise ValueError("String is too large")
                self._pack_raw_header(n)
                return self._buffer.write(obj)
            if check(obj, memoryview):
                n = len(obj) * obj.itemsize
                if n >= 2**32:
                    raise ValueError("Memoryview is too large")
                self._pack_bin_header(n)
                return self._buffer.write(obj)
            if check(obj, float):
                if self._use_float:
                    return self._buffer.write(struct.pack(">Bf", 0xca, obj))
                return self._buffer.write(struct.pack(">Bd", 0xcb, obj))
            if check(obj, ExtType):
                code = obj.code
                data = obj.data
                assert isinstance(code, int)
                assert isinstance(data, bytes)
                L = len(data)
                if L == 1:
                    self._buffer.write(b'\xd4')
                elif L == 2:
                    self._buffer.write(b'\xd5')
                elif L == 4:
                    self._buffer.write(b'\xd6')
                elif L == 8:
                    self._buffer.write(b'\xd7')
                elif L == 16:
                    self._buffer.write(b'\xd8')
                elif L <= 0xff:
                    self._buffer.write(struct.pack(">BB", 0xc7, L))
                elif L <= 0xffff:
                    self._buffer.write(struct.pack(">BH", 0xc8, L))
                else:
                    self._buffer.write(struct.pack(">BI", 0xc9, L))
                self._buffer.write(struct.pack("b", code))
                self._buffer.write(data)
                return
            if check(obj, list_types):
                n = len(obj)
                self._pack_array_header(n)
                for i in xrange(n):
                    self._pack(obj[i], nest_limit - 1)
                return
            if check(obj, dict):
                return self._pack_map_pairs(len(obj), dict_iteritems(obj),
                                               nest_limit - 1)
            if not default_used and self._default is not None:
                obj = self._default(obj)
                default_used = 1
                continue
            raise TypeError("Cannot serialize %r" % (obj, ))

    def pack(self, obj):
        try:
            self._pack(obj)
        except:
            self._buffer = StringIO()  # force reset
            raise
        if self._autoreset:
            ret = self._buffer.getvalue()
            self._buffer = StringIO()
            return ret

    def pack_map_pairs(self, pairs):
        self._pack_map_pairs(len(pairs), pairs)
        if self._autoreset:
            ret = self._buffer.getvalue()
            self._buffer = StringIO()
            return ret

    def pack_array_header(self, n):
        if n >= 2**32:
            raise ValueError
        self._pack_array_header(n)
        if self._autoreset:
            ret = self._buffer.getvalue()
            self._buffer = StringIO()
            return ret

    def pack_map_header(self, n):
        if n >= 2**32:
            raise ValueError
        self._pack_map_header(n)
        if self._autoreset:
            ret = self._buffer.getvalue()
            self._buffer = StringIO()
            return ret

    def pack_ext_type(self, typecode, data):
        if not isinstance(typecode, int):
            raise TypeError("typecode must have int type.")
        if not 0 <= typecode <= 127:
            raise ValueError("typecode should be 0-127")
        if not isinstance(data, bytes):
            raise TypeError("data must have bytes type")
        L = len(data)
        if L > 0xffffffff:
            raise ValueError("Too large data")
        if L == 1:
            self._buffer.write(b'\xd4')
        elif L == 2:
            self._buffer.write(b'\xd5')
        elif L == 4:
            self._buffer.write(b'\xd6')
        elif L == 8:
            self._buffer.write(b'\xd7')
        elif L == 16:
            self._buffer.write(b'\xd8')
        elif L <= 0xff:
            self._buffer.write(b'\xc7' + struct.pack('B', L))
        elif L <= 0xffff:
            self._buffer.write(b'\xc8' + struct.pack('>H', L))
        else:
            self._buffer.write(b'\xc9' + struct.pack('>I', L))
        self._buffer.write(struct.pack('B', typecode))
        self._buffer.write(data)

    def _pack_array_header(self, n):
        if n <= 0x0f:
            return self._buffer.write(struct.pack('B', 0x90 + n))
        if n <= 0xffff:
            return self._buffer.write(struct.pack(">BH", 0xdc, n))
        if n <= 0xffffffff:
            return self._buffer.write(struct.pack(">BI", 0xdd, n))
        raise ValueError("Array is too large")

    def _pack_map_header(self, n):
        if n <= 0x0f:
            return self._buffer.write(struct.pack('B', 0x80 + n))
        if n <= 0xffff:
            return self._buffer.write(struct.pack(">BH", 0xde, n))
        if n <= 0xffffffff:
            return self._buffer.write(struct.pack(">BI", 0xdf, n))
        raise ValueError("Dict is too large")

    def _pack_map_pairs(self, n, pairs, nest_limit=DEFAULT_RECURSE_LIMIT):
        self._pack_map_header(n)
        for (k, v) in pairs:
            self._pack(k, nest_limit - 1)
            self._pack(v, nest_limit - 1)

    def _pack_raw_header(self, n):
        if n <= 0x1f:
            self._buffer.write(struct.pack('B', 0xa0 + n))
        elif self._use_bin_type and n <= 0xff:
            self._buffer.write(struct.pack('>BB', 0xd9, n))
        elif n <= 0xffff:
            self._buffer.write(struct.pack(">BH", 0xda, n))
        elif n <= 0xffffffff:
            self._buffer.write(struct.pack(">BI", 0xdb, n))
        else:
            raise ValueError('Raw is too large')

    def _pack_bin_header(self, n):
        if not self._use_bin_type:
            return self._pack_raw_header(n)
        elif n <= 0xff:
            return self._buffer.write(struct.pack('>BB', 0xc4, n))
        elif n <= 0xffff:
            return self._buffer.write(struct.pack(">BH", 0xc5, n))
        elif n <= 0xffffffff:
            return self._buffer.write(struct.pack(">BI", 0xc6, n))
        else:
            raise ValueError('Bin is too large')

    def bytes(self):
        """Return internal buffer contents as bytes object"""
        return self._buffer.getvalue()

    def reset(self):
        """Reset internal buffer.

        This method is usaful only when autoreset=False.
        """
        self._buffer = StringIO()

    def getbuffer(self):
        """Return view of internal buffer."""
        if USING_STRINGBUILDER or PY2:
            return memoryview(self.bytes())
        else:
            return self._buffer.getbuffer()
site-packages/pip/_vendor/msgpack/_version.py000064400000000024151446177000015334 0ustar00version = (0, 6, 2)
site-packages/pip/_vendor/msgpack/exceptions.py000064400000002071151446177000015675 0ustar00class UnpackException(Exception):
    """Base class for some exceptions raised while unpacking.

    NOTE: unpack may raise exception other than subclass of
    UnpackException.  If you want to catch all error, catch
    Exception instead.
    """


class BufferFull(UnpackException):
    pass


class OutOfData(UnpackException):
    pass


class FormatError(ValueError, UnpackException):
    """Invalid msgpack format"""


class StackError(ValueError, UnpackException):
    """Too nested"""


# Deprecated.  Use ValueError instead
UnpackValueError = ValueError


class ExtraData(UnpackValueError):
    """ExtraData is raised when there is trailing data.

    This exception is raised while only one-shot (not streaming)
    unpack.
    """

    def __init__(self, unpacked, extra):
        self.unpacked = unpacked
        self.extra = extra

    def __str__(self):
        return "unpack(b) received extra data."


# Deprecated.  Use Exception instead to catch all exception during packing.
PackException = Exception
PackValueError = ValueError
PackOverflowError = OverflowError
site-packages/pip/_vendor/pyparsing.py000064400001002454151446177000014111 0ustar00# -*- coding: utf-8 -*-
# module pyparsing.py
#
# Copyright (c) 2003-2019  Paul T. McGuire
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the
# "Software"), to deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, subject to
# the following conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
#

__doc__ = \
"""
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and
executing simple grammars, vs. the traditional lex/yacc approach, or the
use of regular expressions.  With pyparsing, you don't need to learn
a new syntax for defining grammars or matching expressions - the parsing
module provides a library of classes that you use to construct the
grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form
``"<salutation>, <addressee>!"``), built up using :class:`Word`,
:class:`Literal`, and :class:`And` elements
(the :class:`'+'<ParserElement.__add__>` operators create :class:`And` expressions,
and the strings are auto-converted to :class:`Literal` expressions)::

    from pip._vendor.pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the
self-explanatory class names, and the use of '+', '|' and '^' operators.

The :class:`ParseResults` object returned from
:class:`ParserElement.parseString` can be
accessed as a nested list, a dictionary, or an object with named
attributes.

The pyparsing module handles some of the problems that are typically
vexing when writing text parsers:

  - extra or missing whitespace (the above program will also handle
    "Hello,World!", "Hello  ,  World  !", etc.)
  - quoted strings
  - embedded comments


Getting Started -
-----------------
Visit the classes :class:`ParserElement` and :class:`ParseResults` to
see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:

 - construct literal match expressions from :class:`Literal` and
   :class:`CaselessLiteral` classes
 - construct character word-group expressions using the :class:`Word`
   class
 - see how to create repetitive expressions using :class:`ZeroOrMore`
   and :class:`OneOrMore` classes
 - use :class:`'+'<And>`, :class:`'|'<MatchFirst>`, :class:`'^'<Or>`,
   and :class:`'&'<Each>` operators to combine simple expressions into
   more complex ones
 - associate names with your parsed results using
   :class:`ParserElement.setResultsName`
 - access the parsed data, which is returned as a :class:`ParseResults`
   object
 - find some helpful expression short-cuts like :class:`delimitedList`
   and :class:`oneOf`
 - find more useful common expressions in the :class:`pyparsing_common`
   namespace class
"""

__version__ = "2.4.2"
__versionTime__ = "29 Jul 2019 02:58 UTC"
__author__ = "Paul McGuire <ptmcg@users.sourceforge.net>"

import string
from weakref import ref as wkref
import copy
import sys
import warnings
import re
import sre_constants
import collections
import pprint
import traceback
import types
from datetime import datetime
from operator import itemgetter
import itertools
from functools import wraps

try:
    # Python 3
    from itertools import filterfalse
except ImportError:
    from itertools import ifilterfalse as filterfalse

try:
    from _thread import RLock
except ImportError:
    from threading import RLock

try:
    # Python 3
    from collections.abc import Iterable
    from collections.abc import MutableMapping, Mapping
except ImportError:
    # Python 2.7
    from collections import Iterable
    from collections import MutableMapping, Mapping

try:
    from collections import OrderedDict as _OrderedDict
except ImportError:
    try:
        from ordereddict import OrderedDict as _OrderedDict
    except ImportError:
        _OrderedDict = None

try:
    from types import SimpleNamespace
except ImportError:
    class SimpleNamespace: pass

# version compatibility configuration
__compat__ = SimpleNamespace()
__compat__.__doc__ = """
    A cross-version compatibility configuration for pyparsing features that will be
    released in a future version. By setting values in this configuration to True,
    those features can be enabled in prior versions for compatibility development
    and testing.

     - collect_all_And_tokens - flag to enable fix for Issue #63 that fixes erroneous grouping
       of results names when an And expression is nested within an Or or MatchFirst; set to
       True to enable bugfix released in pyparsing 2.3.0, or False to preserve
       pre-2.3.0 handling of named results
"""
__compat__.collect_all_And_tokens = True

__diag__ = SimpleNamespace()
__diag__.__doc__ = """
Diagnostic configuration (all default to False)
     - warn_multiple_tokens_in_named_alternation - flag to enable warnings when a results
       name is defined on a MatchFirst or Or expression with one or more And subexpressions
       (only warns if __compat__.collect_all_And_tokens is False)
     - warn_ungrouped_named_tokens_in_collection - flag to enable warnings when a results
       name is defined on a containing expression with ungrouped subexpressions that also
       have results names
     - warn_name_set_on_empty_Forward - flag to enable warnings whan a Forward is defined
       with a results name, but has no contents defined
     - warn_on_multiple_string_args_to_oneof - flag to enable warnings whan oneOf is
       incorrectly called with multiple str arguments
     - enable_debug_on_named_expressions - flag to auto-enable debug on all subsequent
       calls to ParserElement.setName()
"""
__diag__.warn_multiple_tokens_in_named_alternation = False
__diag__.warn_ungrouped_named_tokens_in_collection = False
__diag__.warn_name_set_on_empty_Forward = False
__diag__.warn_on_multiple_string_args_to_oneof = False
__diag__.enable_debug_on_named_expressions = False

# ~ sys.stderr.write("testing pyparsing module, version %s, %s\n" % (__version__, __versionTime__))

__all__ = ['__version__', '__versionTime__', '__author__', '__compat__', '__diag__',
           'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
           'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
           'PrecededBy', 'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
           'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
           'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
           'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter',
           'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore', 'Char',
           'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
           'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
           'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
           'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
           'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
           'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
           'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity',
           'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
           'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
           'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation', 'locatedExpr', 'withClass',
           'CloseMatch', 'tokenMap', 'pyparsing_common', 'pyparsing_unicode', 'unicode_set',
           'conditionAsParseAction',
           ]

system_version = tuple(sys.version_info)[:3]
PY_3 = system_version[0] == 3
if PY_3:
    _MAX_INT = sys.maxsize
    basestring = str
    unichr = chr
    unicode = str
    _ustr = str

    # build list of single arg builtins, that can be used as parse actions
    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]

else:
    _MAX_INT = sys.maxint
    range = xrange

    def _ustr(obj):
        """Drop-in replacement for str(obj) that tries to be Unicode
        friendly. It first tries str(obj). If that fails with
        a UnicodeEncodeError, then it tries unicode(obj). It then
        < returns the unicode object | encodes it with the default
        encoding | ... >.
        """
        if isinstance(obj, unicode):
            return obj

        try:
            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
            # it won't break any existing code.
            return str(obj)

        except UnicodeEncodeError:
            # Else encode it
            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
            xmlcharref = Regex(r'&#\d+;')
            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
            return xmlcharref.transformString(ret)

    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
    singleArgBuiltins = []
    import __builtin__

    for fname in "sum len sorted reversed list tuple set any all min max".split():
        try:
            singleArgBuiltins.append(getattr(__builtin__, fname))
        except AttributeError:
            continue

_generatorType = type((y for y in range(1)))

def _xml_escape(data):
    """Escape &, <, >, ", ', etc. in a string of data."""

    # ampersand must be replaced first
    from_symbols = '&><"\''
    to_symbols = ('&' + s + ';' for s in "amp gt lt quot apos".split())
    for from_, to_ in zip(from_symbols, to_symbols):
        data = data.replace(from_, to_)
    return data

alphas = string.ascii_uppercase + string.ascii_lowercase
nums = "0123456789"
hexnums = nums + "ABCDEFabcdef"
alphanums = alphas + nums
_bslash = chr(92)
printables = "".join(c for c in string.printable if c not in string.whitespace)


def conditionAsParseAction(fn, message=None, fatal=False):
    msg = message if message is not None else "failed user-defined condition"
    exc_type = ParseFatalException if fatal else ParseException
    fn = _trim_arity(fn)

    @wraps(fn)
    def pa(s, l, t):
        if not bool(fn(s, l, t)):
            raise exc_type(s, l, msg)

    return pa

class ParseBaseException(Exception):
    """base exception class for all parsing runtime exceptions"""
    # Performance tuning: we construct a *lot* of these, so keep this
    # constructor as small and fast as possible
    def __init__(self, pstr, loc=0, msg=None, elem=None):
        self.loc = loc
        if msg is None:
            self.msg = pstr
            self.pstr = ""
        else:
            self.msg = msg
            self.pstr = pstr
        self.parserElement = elem
        self.args = (pstr, loc, msg)

    @classmethod
    def _from_exception(cls, pe):
        """
        internal factory method to simplify creating one type of ParseException
        from another - avoids having __init__ signature conflicts among subclasses
        """
        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)

    def __getattr__(self, aname):
        """supported attributes by name are:
           - lineno - returns the line number of the exception text
           - col - returns the column number of the exception text
           - line - returns the line containing the exception text
        """
        if aname == "lineno":
            return lineno(self.loc, self.pstr)
        elif aname in ("col", "column"):
            return col(self.loc, self.pstr)
        elif aname == "line":
            return line(self.loc, self.pstr)
        else:
            raise AttributeError(aname)

    def __str__(self):
        if self.pstr:
            if self.loc >= len(self.pstr):
                foundstr = ', found end of text'
            else:
                foundstr = (', found %r' % self.pstr[self.loc:self.loc + 1]).replace(r'\\', '\\')
        else:
            foundstr = ''
        return ("%s%s  (at char %d), (line:%d, col:%d)" %
                   (self.msg, foundstr, self.loc, self.lineno, self.column))
    def __repr__(self):
        return _ustr(self)
    def markInputline(self, markerString=">!<"):
        """Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        """
        line_str = self.line
        line_column = self.column - 1
        if markerString:
            line_str = "".join((line_str[:line_column],
                                markerString, line_str[line_column:]))
        return line_str.strip()
    def __dir__(self):
        return "lineno col line".split() + dir(type(self))

class ParseException(ParseBaseException):
    """
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
    - lineno - returns the line number of the exception text
    - col - returns the column number of the exception text
    - line - returns the line containing the exception text

    Example::

        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))

    prints::

       Expected integer (at char 0), (line:1, col:1)
        column: 1

    """

    @staticmethod
    def explain(exc, depth=16):
        """
        Method to take an exception and translate the Python internal traceback into a list
        of the pyparsing expressions that caused the exception to be raised.

        Parameters:

         - exc - exception raised during parsing (need not be a ParseException, in support
           of Python exceptions that might be raised in a parse action)
         - depth (default=16) - number of levels back in the stack trace to list expression
           and function names; if None, the full stack trace names will be listed; if 0, only
           the failing input line, marker, and exception string will be shown

        Returns a multi-line string listing the ParserElements and/or function names in the
        exception's stack trace.

        Note: the diagnostic output will include string representations of the expressions
        that failed to parse. These representations will be more helpful if you use `setName` to
        give identifiable names to your expressions. Otherwise they will use the default string
        forms, which may be cryptic to read.

        explain() is only supported under Python 3.
        """
        import inspect

        if depth is None:
            depth = sys.getrecursionlimit()
        ret = []
        if isinstance(exc, ParseBaseException):
            ret.append(exc.line)
            ret.append(' ' * (exc.col - 1) + '^')
        ret.append("{0}: {1}".format(type(exc).__name__, exc))

        if depth > 0:
            callers = inspect.getinnerframes(exc.__traceback__, context=depth)
            seen = set()
            for i, ff in enumerate(callers[-depth:]):
                frm = ff[0]

                f_self = frm.f_locals.get('self', None)
                if isinstance(f_self, ParserElement):
                    if frm.f_code.co_name not in ('parseImpl', '_parseNoCache'):
                        continue
                    if f_self in seen:
                        continue
                    seen.add(f_self)

                    self_type = type(f_self)
                    ret.append("{0}.{1} - {2}".format(self_type.__module__,
                                                      self_type.__name__,
                                                      f_self))
                elif f_self is not None:
                    self_type = type(f_self)
                    ret.append("{0}.{1}".format(self_type.__module__,
                                                self_type.__name__))
                else:
                    code = frm.f_code
                    if code.co_name in ('wrapper', '<module>'):
                        continue

                    ret.append("{0}".format(code.co_name))

                depth -= 1
                if not depth:
                    break

        return '\n'.join(ret)


class ParseFatalException(ParseBaseException):
    """user-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediately"""
    pass

class ParseSyntaxException(ParseFatalException):
    """just like :class:`ParseFatalException`, but thrown internally
    when an :class:`ErrorStop<And._ErrorStop>` ('-' operator) indicates
    that parsing is to stop immediately because an unbacktrackable
    syntax error has been found.
    """
    pass

#~ class ReparseException(ParseBaseException):
    #~ """Experimental class - parse actions can raise this exception to cause
       #~ pyparsing to reparse the input string:
        #~ - with a modified input string, and/or
        #~ - with a modified start location
       #~ Set the values of the ReparseException in the constructor, and raise the
       #~ exception in a parse action to cause pyparsing to use the new string/location.
       #~ Setting the values as None causes no change to be made.
       #~ """
    #~ def __init_( self, newstring, restartLoc ):
        #~ self.newParseText = newstring
        #~ self.reparseLoc = restartLoc

class RecursiveGrammarException(Exception):
    """exception thrown by :class:`ParserElement.validate` if the
    grammar could be improperly recursive
    """
    def __init__(self, parseElementList):
        self.parseElementTrace = parseElementList

    def __str__(self):
        return "RecursiveGrammarException: %s" % self.parseElementTrace

class _ParseResultsWithOffset(object):
    def __init__(self, p1, p2):
        self.tup = (p1, p2)
    def __getitem__(self, i):
        return self.tup[i]
    def __repr__(self):
        return repr(self.tup[0])
    def setOffset(self, i):
        self.tup = (self.tup[0], i)

class ParseResults(object):
    """Structured parse results, to provide multiple means of access to
    the parsed data:

       - as a list (``len(results)``)
       - by list index (``results[0], results[1]``, etc.)
       - by attribute (``results.<resultsName>`` - see :class:`ParserElement.setResultsName`)

    Example::

        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/'
                        + integer.setResultsName("month") + '/'
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)

    prints::

        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    """
    def __new__(cls, toklist=None, name=None, asList=True, modal=True):
        if isinstance(toklist, cls):
            return toklist
        retobj = object.__new__(cls)
        retobj.__doinit = True
        return retobj

    # Performance tuning: we construct a *lot* of these, so keep this
    # constructor as small and fast as possible
    def __init__(self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance):
        if self.__doinit:
            self.__doinit = False
            self.__name = None
            self.__parent = None
            self.__accumNames = {}
            self.__asList = asList
            self.__modal = modal
            if toklist is None:
                toklist = []
            if isinstance(toklist, list):
                self.__toklist = toklist[:]
            elif isinstance(toklist, _generatorType):
                self.__toklist = list(toklist)
            else:
                self.__toklist = [toklist]
            self.__tokdict = dict()

        if name is not None and name:
            if not modal:
                self.__accumNames[name] = 0
            if isinstance(name, int):
                name = _ustr(name)  # will always return a str, but use _ustr for consistency
            self.__name = name
            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None, '', [])):
                if isinstance(toklist, basestring):
                    toklist = [toklist]
                if asList:
                    if isinstance(toklist, ParseResults):
                        self[name] = _ParseResultsWithOffset(ParseResults(toklist.__toklist), 0)
                    else:
                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]), 0)
                    self[name].__name = name
                else:
                    try:
                        self[name] = toklist[0]
                    except (KeyError, TypeError, IndexError):
                        self[name] = toklist

    def __getitem__(self, i):
        if isinstance(i, (int, slice)):
            return self.__toklist[i]
        else:
            if i not in self.__accumNames:
                return self.__tokdict[i][-1][0]
            else:
                return ParseResults([v[0] for v in self.__tokdict[i]])

    def __setitem__(self, k, v, isinstance=isinstance):
        if isinstance(v, _ParseResultsWithOffset):
            self.__tokdict[k] = self.__tokdict.get(k, list()) + [v]
            sub = v[0]
        elif isinstance(k, (int, slice)):
            self.__toklist[k] = v
            sub = v
        else:
            self.__tokdict[k] = self.__tokdict.get(k, list()) + [_ParseResultsWithOffset(v, 0)]
            sub = v
        if isinstance(sub, ParseResults):
            sub.__parent = wkref(self)

    def __delitem__(self, i):
        if isinstance(i, (int, slice)):
            mylen = len(self.__toklist)
            del self.__toklist[i]

            # convert int to slice
            if isinstance(i, int):
                if i < 0:
                    i += mylen
                i = slice(i, i + 1)
            # get removed indices
            removed = list(range(*i.indices(mylen)))
            removed.reverse()
            # fixup indices in token dictionary
            for name, occurrences in self.__tokdict.items():
                for j in removed:
                    for k, (value, position) in enumerate(occurrences):
                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
        else:
            del self.__tokdict[i]

    def __contains__(self, k):
        return k in self.__tokdict

    def __len__(self):
        return len(self.__toklist)

    def __bool__(self):
        return (not not self.__toklist)
    __nonzero__ = __bool__

    def __iter__(self):
        return iter(self.__toklist)

    def __reversed__(self):
        return iter(self.__toklist[::-1])

    def _iterkeys(self):
        if hasattr(self.__tokdict, "iterkeys"):
            return self.__tokdict.iterkeys()
        else:
            return iter(self.__tokdict)

    def _itervalues(self):
        return (self[k] for k in self._iterkeys())

    def _iteritems(self):
        return ((k, self[k]) for k in self._iterkeys())

    if PY_3:
        keys = _iterkeys
        """Returns an iterator of all named result keys."""

        values = _itervalues
        """Returns an iterator of all named result values."""

        items = _iteritems
        """Returns an iterator of all named result key-value tuples."""

    else:
        iterkeys = _iterkeys
        """Returns an iterator of all named result keys (Python 2.x only)."""

        itervalues = _itervalues
        """Returns an iterator of all named result values (Python 2.x only)."""

        iteritems = _iteritems
        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""

        def keys(self):
            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.iterkeys())

        def values(self):
            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.itervalues())

        def items(self):
            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.iteritems())

    def haskeys(self):
        """Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names."""
        return bool(self.__tokdict)

    def pop(self, *args, **kwargs):
        """
        Removes and returns item at specified index (default= ``last``).
        Supports both ``list`` and ``dict`` semantics for ``pop()``. If
        passed no argument or an integer argument, it will use ``list``
        semantics and pop tokens from the list of parsed tokens. If passed
        a non-integer argument (most likely a string), it will use ``dict``
        semantics and pop the corresponding value from any defined results
        names. A second default return value argument is supported, just as in
        ``dict.pop()``.

        Example::

            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())

        prints::

            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        """
        if not args:
            args = [-1]
        for k, v in kwargs.items():
            if k == 'default':
                args = (args[0], v)
            else:
                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
        if (isinstance(args[0], int)
                or len(args) == 1
                or args[0] in self):
            index = args[0]
            ret = self[index]
            del self[index]
            return ret
        else:
            defaultvalue = args[1]
            return defaultvalue

    def get(self, key, defaultValue=None):
        """
        Returns named result matching the given key, or if there is no
        such name, then returns the given ``defaultValue`` or ``None`` if no
        ``defaultValue`` is specified.

        Similar to ``dict.get()``.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        """
        if key in self:
            return self[key]
        else:
            return defaultValue

    def insert(self, index, insStr):
        """
        Inserts new element at location index in the list of parsed tokens.

        Similar to ``list.insert()``.

        Example::

            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        """
        self.__toklist.insert(index, insStr)
        # fixup indices in token dictionary
        for name, occurrences in self.__tokdict.items():
            for k, (value, position) in enumerate(occurrences):
                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))

    def append(self, item):
        """
        Add single element to end of ParseResults list of elements.

        Example::

            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        """
        self.__toklist.append(item)

    def extend(self, itemseq):
        """
        Add sequence of elements to end of ParseResults list of elements.

        Example::

            patt = OneOrMore(Word(alphas))

            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        """
        if isinstance(itemseq, ParseResults):
            self.__iadd__(itemseq)
        else:
            self.__toklist.extend(itemseq)

    def clear(self):
        """
        Clear all elements and results names.
        """
        del self.__toklist[:]
        self.__tokdict.clear()

    def __getattr__(self, name):
        try:
            return self[name]
        except KeyError:
            return ""

    def __add__(self, other):
        ret = self.copy()
        ret += other
        return ret

    def __iadd__(self, other):
        if other.__tokdict:
            offset = len(self.__toklist)
            addoffset = lambda a: offset if a < 0 else a + offset
            otheritems = other.__tokdict.items()
            otherdictitems = [(k, _ParseResultsWithOffset(v[0], addoffset(v[1])))
                              for k, vlist in otheritems for v in vlist]
            for k, v in otherdictitems:
                self[k] = v
                if isinstance(v[0], ParseResults):
                    v[0].__parent = wkref(self)

        self.__toklist += other.__toklist
        self.__accumNames.update(other.__accumNames)
        return self

    def __radd__(self, other):
        if isinstance(other, int) and other == 0:
            # useful for merging many ParseResults using sum() builtin
            return self.copy()
        else:
            # this may raise a TypeError - so be it
            return other + self

    def __repr__(self):
        return "(%s, %s)" % (repr(self.__toklist), repr(self.__tokdict))

    def __str__(self):
        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'

    def _asStringList(self, sep=''):
        out = []
        for item in self.__toklist:
            if out and sep:
                out.append(sep)
            if isinstance(item, ParseResults):
                out += item._asStringList()
            else:
                out.append(_ustr(item))
        return out

    def asList(self):
        """
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::

            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']

            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        """
        return [res.asList() if isinstance(res, ParseResults) else res for res in self.__toklist]

    def asDict(self):
        """
        Returns the named parse results as a nested dictionary.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})

            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        """
        if PY_3:
            item_fn = self.items
        else:
            item_fn = self.iteritems

        def toItem(obj):
            if isinstance(obj, ParseResults):
                if obj.haskeys():
                    return obj.asDict()
                else:
                    return [toItem(v) for v in obj]
            else:
                return obj

        return dict((k, toItem(v)) for k, v in item_fn())

    def copy(self):
        """
        Returns a new copy of a :class:`ParseResults` object.
        """
        ret = ParseResults(self.__toklist)
        ret.__tokdict = dict(self.__tokdict.items())
        ret.__parent = self.__parent
        ret.__accumNames.update(self.__accumNames)
        ret.__name = self.__name
        return ret

    def asXML(self, doctag=None, namedItemsOnly=False, indent="", formatted=True):
        """
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        """
        nl = "\n"
        out = []
        namedItems = dict((v[1], k) for (k, vlist) in self.__tokdict.items()
                          for v in vlist)
        nextLevelIndent = indent + "  "

        # collapse out indents if formatting is not desired
        if not formatted:
            indent = ""
            nextLevelIndent = ""
            nl = ""

        selfTag = None
        if doctag is not None:
            selfTag = doctag
        else:
            if self.__name:
                selfTag = self.__name

        if not selfTag:
            if namedItemsOnly:
                return ""
            else:
                selfTag = "ITEM"

        out += [nl, indent, "<", selfTag, ">"]

        for i, res in enumerate(self.__toklist):
            if isinstance(res, ParseResults):
                if i in namedItems:
                    out += [res.asXML(namedItems[i],
                                      namedItemsOnly and doctag is None,
                                      nextLevelIndent,
                                      formatted)]
                else:
                    out += [res.asXML(None,
                                      namedItemsOnly and doctag is None,
                                      nextLevelIndent,
                                      formatted)]
            else:
                # individual token, see if there is a name for it
                resTag = None
                if i in namedItems:
                    resTag = namedItems[i]
                if not resTag:
                    if namedItemsOnly:
                        continue
                    else:
                        resTag = "ITEM"
                xmlBodyText = _xml_escape(_ustr(res))
                out += [nl, nextLevelIndent, "<", resTag, ">",
                        xmlBodyText,
                                                "</", resTag, ">"]

        out += [nl, indent, "</", selfTag, ">"]
        return "".join(out)

    def __lookup(self, sub):
        for k, vlist in self.__tokdict.items():
            for v, loc in vlist:
                if sub is v:
                    return k
        return None

    def getName(self):
        r"""
        Returns the results name for this token expression. Useful when several
        different expressions might match at a particular location.

        Example::

            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number")
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)

            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])

        prints::

            age : 22
            ssn : 111-22-3333
            house_number : 221B
        """
        if self.__name:
            return self.__name
        elif self.__parent:
            par = self.__parent()
            if par:
                return par.__lookup(self)
            else:
                return None
        elif (len(self) == 1
              and len(self.__tokdict) == 1
              and next(iter(self.__tokdict.values()))[0][1] in (0, -1)):
            return next(iter(self.__tokdict.keys()))
        else:
            return None

    def dump(self, indent='', full=True, include_list=True, _depth=0):
        """
        Diagnostic method for listing out the contents of
        a :class:`ParseResults`. Accepts an optional ``indent`` argument so
        that this string can be embedded in a nested display of other data.

        Example::

            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            result = date_str.parseString('12/31/1999')
            print(result.dump())

        prints::

            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        """
        out = []
        NL = '\n'
        if include_list:
            out.append(indent + _ustr(self.asList()))
        else:
            out.append('')

        if full:
            if self.haskeys():
                items = sorted((str(k), v) for k, v in self.items())
                for k, v in items:
                    if out:
                        out.append(NL)
                    out.append("%s%s- %s: " % (indent, ('  ' * _depth), k))
                    if isinstance(v, ParseResults):
                        if v:
                            out.append(v.dump(indent=indent, full=full, include_list=include_list, _depth=_depth + 1))
                        else:
                            out.append(_ustr(v))
                    else:
                        out.append(repr(v))
            elif any(isinstance(vv, ParseResults) for vv in self):
                v = self
                for i, vv in enumerate(v):
                    if isinstance(vv, ParseResults):
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,
                                                            ('  ' * (_depth)),
                                                            i,
                                                            indent,
                                                            ('  ' * (_depth + 1)),
                                                            vv.dump(indent=indent,
                                                                    full=full,
                                                                    include_list=include_list,
                                                                    _depth=_depth + 1)))
                    else:
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,
                                                            ('  ' * (_depth)),
                                                            i,
                                                            indent,
                                                            ('  ' * (_depth + 1)),
                                                            _ustr(vv)))

        return "".join(out)

    def pprint(self, *args, **kwargs):
        """
        Pretty-printer for parsed results as a list, using the
        `pprint <https://docs.python.org/3/library/pprint.html>`_ module.
        Accepts additional positional or keyword args as defined for
        `pprint.pprint <https://docs.python.org/3/library/pprint.html#pprint.pprint>`_ .

        Example::

            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)

        prints::

            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        """
        pprint.pprint(self.asList(), *args, **kwargs)

    # add support for pickle protocol
    def __getstate__(self):
        return (self.__toklist,
                (self.__tokdict.copy(),
                 self.__parent is not None and self.__parent() or None,
                 self.__accumNames,
                 self.__name))

    def __setstate__(self, state):
        self.__toklist = state[0]
        self.__tokdict, par, inAccumNames, self.__name = state[1]
        self.__accumNames = {}
        self.__accumNames.update(inAccumNames)
        if par is not None:
            self.__parent = wkref(par)
        else:
            self.__parent = None

    def __getnewargs__(self):
        return self.__toklist, self.__name, self.__asList, self.__modal

    def __dir__(self):
        return dir(type(self)) + list(self.keys())

    @classmethod
    def from_dict(cls, other, name=None):
        """
        Helper classmethod to construct a ParseResults from a dict, preserving the
        name-value relations as results names. If an optional 'name' argument is
        given, a nested ParseResults will be returned
        """
        def is_iterable(obj):
            try:
                iter(obj)
            except Exception:
                return False
            else:
                if PY_3:
                    return not isinstance(obj, (str, bytes))
                else:
                    return not isinstance(obj, basestring)

        ret = cls([])
        for k, v in other.items():
            if isinstance(v, Mapping):
                ret += cls.from_dict(v, name=k)
            else:
                ret += cls([v], name=k, asList=is_iterable(v))
        if name is not None:
            ret = cls([ret], name=name)
        return ret

MutableMapping.register(ParseResults)

def col (loc, strg):
    """Returns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See
   :class:`ParserElement.parseString` for more
   information on parsing strings containing ``<TAB>`` s, and suggested
   methods to maintain a consistent view of the parsed string, the parse
   location, and line and column positions within the parsed string.
   """
    s = strg
    return 1 if 0 < loc < len(s) and s[loc-1] == '\n' else loc - s.rfind("\n", 0, loc)

def lineno(loc, strg):
    """Returns current line number within a string, counting newlines as line separators.
    The first line is number 1.

    Note - the default parsing behavior is to expand tabs in the input string
    before starting the parsing process.  See :class:`ParserElement.parseString`
    for more information on parsing strings containing ``<TAB>`` s, and
    suggested methods to maintain a consistent view of the parsed string, the
    parse location, and line and column positions within the parsed string.
    """
    return strg.count("\n", 0, loc) + 1

def line(loc, strg):
    """Returns the line of text containing loc within a string, counting newlines as line separators.
       """
    lastCR = strg.rfind("\n", 0, loc)
    nextCR = strg.find("\n", loc)
    if nextCR >= 0:
        return strg[lastCR + 1:nextCR]
    else:
        return strg[lastCR + 1:]

def _defaultStartDebugAction(instring, loc, expr):
    print(("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % (lineno(loc, instring), col(loc, instring))))

def _defaultSuccessDebugAction(instring, startloc, endloc, expr, toks):
    print("Matched " + _ustr(expr) + " -> " + str(toks.asList()))

def _defaultExceptionDebugAction(instring, loc, expr, exc):
    print("Exception raised:" + _ustr(exc))

def nullDebugAction(*args):
    """'Do-nothing' debug action, to suppress debugging output during parsing."""
    pass

# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
#~ 'decorator to trim function calls to match the arity of the target'
#~ def _trim_arity(func, maxargs=3):
    #~ if func in singleArgBuiltins:
        #~ return lambda s,l,t: func(t)
    #~ limit = 0
    #~ foundArity = False
    #~ def wrapper(*args):
        #~ nonlocal limit,foundArity
        #~ while 1:
            #~ try:
                #~ ret = func(*args[limit:])
                #~ foundArity = True
                #~ return ret
            #~ except TypeError:
                #~ if limit == maxargs or foundArity:
                    #~ raise
                #~ limit += 1
                #~ continue
    #~ return wrapper

# this version is Python 2.x-3.x cross-compatible
'decorator to trim function calls to match the arity of the target'
def _trim_arity(func, maxargs=2):
    if func in singleArgBuiltins:
        return lambda s, l, t: func(t)
    limit = [0]
    foundArity = [False]

    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
    if system_version[:2] >= (3, 5):
        def extract_stack(limit=0):
            # special handling for Python 3.5.0 - extra deep call stack by 1
            offset = -3 if system_version == (3, 5, 0) else -2
            frame_summary = traceback.extract_stack(limit=-offset + limit - 1)[offset]
            return [frame_summary[:2]]
        def extract_tb(tb, limit=0):
            frames = traceback.extract_tb(tb, limit=limit)
            frame_summary = frames[-1]
            return [frame_summary[:2]]
    else:
        extract_stack = traceback.extract_stack
        extract_tb = traceback.extract_tb

    # synthesize what would be returned by traceback.extract_stack at the call to
    # user's parse action 'func', so that we don't incur call penalty at parse time

    LINE_DIFF = 6
    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND
    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
    this_line = extract_stack(limit=2)[-1]
    pa_call_line_synth = (this_line[0], this_line[1] + LINE_DIFF)

    def wrapper(*args):
        while 1:
            try:
                ret = func(*args[limit[0]:])
                foundArity[0] = True
                return ret
            except TypeError:
                # re-raise TypeErrors if they did not come from our arity testing
                if foundArity[0]:
                    raise
                else:
                    try:
                        tb = sys.exc_info()[-1]
                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
                            raise
                    finally:
                        try:
                            del tb
                        except NameError:
                            pass

                if limit[0] <= maxargs:
                    limit[0] += 1
                    continue
                raise

    # copy func name to wrapper for sensible debug output
    func_name = "<parse action>"
    try:
        func_name = getattr(func, '__name__',
                            getattr(func, '__class__').__name__)
    except Exception:
        func_name = str(func)
    wrapper.__name__ = func_name

    return wrapper


class ParserElement(object):
    """Abstract base level parser element class."""
    DEFAULT_WHITE_CHARS = " \n\t\r"
    verbose_stacktrace = False

    @staticmethod
    def setDefaultWhitespaceChars(chars):
        r"""
        Overrides the default whitespace chars

        Example::

            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']

            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        """
        ParserElement.DEFAULT_WHITE_CHARS = chars

    @staticmethod
    def inlineLiteralsUsing(cls):
        """
        Set class to be used for inclusion of string literals into a parser.

        Example::

            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        """
        ParserElement._literalStringClass = cls

    def __init__(self, savelist=False):
        self.parseAction = list()
        self.failAction = None
        # ~ self.name = "<unknown>"  # don't define self.name, let subclasses try/except upcall
        self.strRepr = None
        self.resultsName = None
        self.saveAsList = savelist
        self.skipWhitespace = True
        self.whiteChars = set(ParserElement.DEFAULT_WHITE_CHARS)
        self.copyDefaultWhiteChars = True
        self.mayReturnEmpty = False # used when checking for left-recursion
        self.keepTabs = False
        self.ignoreExprs = list()
        self.debug = False
        self.streamlined = False
        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
        self.errmsg = ""
        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
        self.debugActions = (None, None, None)  # custom debug actions
        self.re = None
        self.callPreparse = True # used to avoid redundant calls to preParse
        self.callDuringTry = False

    def copy(self):
        """
        Make a copy of this :class:`ParserElement`.  Useful for defining
        different parse actions for the same parsing pattern, using copies of
        the original parse element.

        Example::

            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0] * 1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")

            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))

        prints::

            [5120, 100, 655360, 268435456]

        Equivalent form of ``expr.copy()`` is just ``expr()``::

            integerM = integer().addParseAction(lambda toks: toks[0] * 1024 * 1024) + Suppress("M")
        """
        cpy = copy.copy(self)
        cpy.parseAction = self.parseAction[:]
        cpy.ignoreExprs = self.ignoreExprs[:]
        if self.copyDefaultWhiteChars:
            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
        return cpy

    def setName(self, name):
        """
        Define name for this expression, makes debugging and exception messages clearer.

        Example::

            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        """
        self.name = name
        self.errmsg = "Expected " + self.name
        if __diag__.enable_debug_on_named_expressions:
            self.setDebug()
        return self

    def setResultsName(self, name, listAllMatches=False):
        """
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original :class:`ParserElement` object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        ``expr("name")`` in place of ``expr.setResultsName("name")``
        - see :class:`__call__`.

        Example::

            date_str = (integer.setResultsName("year") + '/'
                        + integer.setResultsName("month") + '/'
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        """
        return self._setResultsName(name, listAllMatches)

    def _setResultsName(self, name, listAllMatches=False):
        newself = self.copy()
        if name.endswith("*"):
            name = name[:-1]
            listAllMatches = True
        newself.resultsName = name
        newself.modalResults = not listAllMatches
        return newself

    def setBreak(self, breakFlag=True):
        """Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set ``breakFlag`` to True to enable, False to
           disable.
        """
        if breakFlag:
            _parseMethod = self._parse
            def breaker(instring, loc, doActions=True, callPreParse=True):
                import pdb
                # this call to pdb.set_trace() is intentional, not a checkin error
                pdb.set_trace()
                return _parseMethod(instring, loc, doActions, callPreParse)
            breaker._originalParseMethod = _parseMethod
            self._parse = breaker
        else:
            if hasattr(self._parse, "_originalParseMethod"):
                self._parse = self._parse._originalParseMethod
        return self

    def setParseAction(self, *fns, **kwargs):
        """
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as ``fn(s, loc, toks)`` ,
        ``fn(loc, toks)`` , ``fn(toks)`` , or just ``fn()`` , where:

        - s   = the original string being parsed (see note below)
        - loc = the location of the matching substring
        - toks = a list of the matched tokens, packaged as a :class:`ParseResults` object

        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        If None is passed as the parse action, all previously added parse actions for this
        expression are cleared.

        Optional keyword arguments:
        - callDuringTry = (default= ``False``) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See :class:`parseString for more
        information on parsing strings containing ``<TAB>`` s, and suggested
        methods to maintain a consistent view of the parsed string, the parse
        location, and line and column positions within the parsed string.

        Example::

            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        """
        if list(fns) == [None,]:
            self.parseAction = []
        else:
            if not all(callable(fn) for fn in fns):
                raise TypeError("parse actions must be callable")
            self.parseAction = list(map(_trim_arity, list(fns)))
            self.callDuringTry = kwargs.get("callDuringTry", False)
        return self

    def addParseAction(self, *fns, **kwargs):
        """
        Add one or more parse actions to expression's list of parse actions. See :class:`setParseAction`.

        See examples in :class:`copy`.
        """
        self.parseAction += list(map(_trim_arity, list(fns)))
        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
        return self

    def addCondition(self, *fns, **kwargs):
        """Add a boolean predicate function to expression's list of parse actions. See
        :class:`setParseAction` for function call signatures. Unlike ``setParseAction``,
        functions passed to ``addCondition`` need to return boolean success/fail of the condition.

        Optional keyword arguments:
        - message = define a custom message to be used in the raised exception
        - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException

        Example::

            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        """
        for fn in fns:
            self.parseAction.append(conditionAsParseAction(fn, message=kwargs.get('message'),
                                                           fatal=kwargs.get('fatal', False)))

        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
        return self

    def setFailAction(self, fn):
        """Define action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           ``fn(s, loc, expr, err)`` where:
           - s = string being parsed
           - loc = location where expression match was attempted and failed
           - expr = the parse expression that failed
           - err = the exception thrown
           The function returns no value.  It may throw :class:`ParseFatalException`
           if it is desired to stop parsing immediately."""
        self.failAction = fn
        return self

    def _skipIgnorables(self, instring, loc):
        exprsFound = True
        while exprsFound:
            exprsFound = False
            for e in self.ignoreExprs:
                try:
                    while 1:
                        loc, dummy = e._parse(instring, loc)
                        exprsFound = True
                except ParseException:
                    pass
        return loc

    def preParse(self, instring, loc):
        if self.ignoreExprs:
            loc = self._skipIgnorables(instring, loc)

        if self.skipWhitespace:
            wt = self.whiteChars
            instrlen = len(instring)
            while loc < instrlen and instring[loc] in wt:
                loc += 1

        return loc

    def parseImpl(self, instring, loc, doActions=True):
        return loc, []

    def postParse(self, instring, loc, tokenlist):
        return tokenlist

    # ~ @profile
    def _parseNoCache(self, instring, loc, doActions=True, callPreParse=True):
        TRY, MATCH, FAIL = 0, 1, 2
        debugging = (self.debug)  # and doActions)

        if debugging or self.failAction:
            # ~ print ("Match", self, "at loc", loc, "(%d, %d)" % (lineno(loc, instring), col(loc, instring)))
            if self.debugActions[TRY]:
                self.debugActions[TRY](instring, loc, self)
            try:
                if callPreParse and self.callPreparse:
                    preloc = self.preParse(instring, loc)
                else:
                    preloc = loc
                tokensStart = preloc
                if self.mayIndexError or preloc >= len(instring):
                    try:
                        loc, tokens = self.parseImpl(instring, preloc, doActions)
                    except IndexError:
                        raise ParseException(instring, len(instring), self.errmsg, self)
                else:
                    loc, tokens = self.parseImpl(instring, preloc, doActions)
            except Exception as err:
                # ~ print ("Exception raised:", err)
                if self.debugActions[FAIL]:
                    self.debugActions[FAIL](instring, tokensStart, self, err)
                if self.failAction:
                    self.failAction(instring, tokensStart, self, err)
                raise
        else:
            if callPreParse and self.callPreparse:
                preloc = self.preParse(instring, loc)
            else:
                preloc = loc
            tokensStart = preloc
            if self.mayIndexError or preloc >= len(instring):
                try:
                    loc, tokens = self.parseImpl(instring, preloc, doActions)
                except IndexError:
                    raise ParseException(instring, len(instring), self.errmsg, self)
            else:
                loc, tokens = self.parseImpl(instring, preloc, doActions)

        tokens = self.postParse(instring, loc, tokens)

        retTokens = ParseResults(tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults)
        if self.parseAction and (doActions or self.callDuringTry):
            if debugging:
                try:
                    for fn in self.parseAction:
                        try:
                            tokens = fn(instring, tokensStart, retTokens)
                        except IndexError as parse_action_exc:
                            exc = ParseException("exception raised in parse action")
                            exc.__cause__ = parse_action_exc
                            raise exc

                        if tokens is not None and tokens is not retTokens:
                            retTokens = ParseResults(tokens,
                                                      self.resultsName,
                                                      asList=self.saveAsList and isinstance(tokens, (ParseResults, list)),
                                                      modal=self.modalResults)
                except Exception as err:
                    # ~ print "Exception raised in user parse action:", err
                    if self.debugActions[FAIL]:
                        self.debugActions[FAIL](instring, tokensStart, self, err)
                    raise
            else:
                for fn in self.parseAction:
                    try:
                        tokens = fn(instring, tokensStart, retTokens)
                    except IndexError as parse_action_exc:
                        exc = ParseException("exception raised in parse action")
                        exc.__cause__ = parse_action_exc
                        raise exc

                    if tokens is not None and tokens is not retTokens:
                        retTokens = ParseResults(tokens,
                                                  self.resultsName,
                                                  asList=self.saveAsList and isinstance(tokens, (ParseResults, list)),
                                                  modal=self.modalResults)
        if debugging:
            # ~ print ("Matched", self, "->", retTokens.asList())
            if self.debugActions[MATCH]:
                self.debugActions[MATCH](instring, tokensStart, loc, self, retTokens)

        return loc, retTokens

    def tryParse(self, instring, loc):
        try:
            return self._parse(instring, loc, doActions=False)[0]
        except ParseFatalException:
            raise ParseException(instring, loc, self.errmsg, self)

    def canParseNext(self, instring, loc):
        try:
            self.tryParse(instring, loc)
        except (ParseException, IndexError):
            return False
        else:
            return True

    class _UnboundedCache(object):
        def __init__(self):
            cache = {}
            self.not_in_cache = not_in_cache = object()

            def get(self, key):
                return cache.get(key, not_in_cache)

            def set(self, key, value):
                cache[key] = value

            def clear(self):
                cache.clear()

            def cache_len(self):
                return len(cache)

            self.get = types.MethodType(get, self)
            self.set = types.MethodType(set, self)
            self.clear = types.MethodType(clear, self)
            self.__len__ = types.MethodType(cache_len, self)

    if _OrderedDict is not None:
        class _FifoCache(object):
            def __init__(self, size):
                self.not_in_cache = not_in_cache = object()

                cache = _OrderedDict()

                def get(self, key):
                    return cache.get(key, not_in_cache)

                def set(self, key, value):
                    cache[key] = value
                    while len(cache) > size:
                        try:
                            cache.popitem(False)
                        except KeyError:
                            pass

                def clear(self):
                    cache.clear()

                def cache_len(self):
                    return len(cache)

                self.get = types.MethodType(get, self)
                self.set = types.MethodType(set, self)
                self.clear = types.MethodType(clear, self)
                self.__len__ = types.MethodType(cache_len, self)

    else:
        class _FifoCache(object):
            def __init__(self, size):
                self.not_in_cache = not_in_cache = object()

                cache = {}
                key_fifo = collections.deque([], size)

                def get(self, key):
                    return cache.get(key, not_in_cache)

                def set(self, key, value):
                    cache[key] = value
                    while len(key_fifo) > size:
                        cache.pop(key_fifo.popleft(), None)
                    key_fifo.append(key)

                def clear(self):
                    cache.clear()
                    key_fifo.clear()

                def cache_len(self):
                    return len(cache)

                self.get = types.MethodType(get, self)
                self.set = types.MethodType(set, self)
                self.clear = types.MethodType(clear, self)
                self.__len__ = types.MethodType(cache_len, self)

    # argument cache for optimizing repeated calls when backtracking through recursive expressions
    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
    packrat_cache_lock = RLock()
    packrat_cache_stats = [0, 0]

    # this method gets repeatedly called during backtracking with the same arguments -
    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
    def _parseCache(self, instring, loc, doActions=True, callPreParse=True):
        HIT, MISS = 0, 1
        lookup = (self, instring, loc, callPreParse, doActions)
        with ParserElement.packrat_cache_lock:
            cache = ParserElement.packrat_cache
            value = cache.get(lookup)
            if value is cache.not_in_cache:
                ParserElement.packrat_cache_stats[MISS] += 1
                try:
                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
                except ParseBaseException as pe:
                    # cache a copy of the exception, without the traceback
                    cache.set(lookup, pe.__class__(*pe.args))
                    raise
                else:
                    cache.set(lookup, (value[0], value[1].copy()))
                    return value
            else:
                ParserElement.packrat_cache_stats[HIT] += 1
                if isinstance(value, Exception):
                    raise value
                return value[0], value[1].copy()

    _parse = _parseNoCache

    @staticmethod
    def resetCache():
        ParserElement.packrat_cache.clear()
        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)

    _packratEnabled = False
    @staticmethod
    def enablePackrat(cache_size_limit=128):
        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.

           Parameters:

           - cache_size_limit - (default= ``128``) - if an integer value is provided
             will limit the size of the packrat cache; if None is passed, then
             the cache size will be unbounded; if 0 is passed, the cache will
             be effectively disabled.

           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method :class:`ParserElement.enablePackrat`.
           For best results, call ``enablePackrat()`` immediately after
           importing pyparsing.

           Example::

               from pip._vendor import pyparsing
               pyparsing.ParserElement.enablePackrat()
        """
        if not ParserElement._packratEnabled:
            ParserElement._packratEnabled = True
            if cache_size_limit is None:
                ParserElement.packrat_cache = ParserElement._UnboundedCache()
            else:
                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
            ParserElement._parse = ParserElement._parseCache

    def parseString(self, instring, parseAll=False):
        """
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        Returns the parsed data as a :class:`ParseResults` object, which may be
        accessed as a list, or as a dict or object with attributes if the given parser
        includes results names.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set ``parseAll`` to True (equivalent to ending
        the grammar with ``StringEnd()``).

        Note: ``parseString`` implicitly calls ``expandtabs()`` on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the ``loc`` argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:

        - calling ``parseWithTabs`` on your grammar before calling ``parseString``
          (see :class:`parseWithTabs`)
        - define your parse action using the full ``(s, loc, toks)`` signature, and
          reference the input string using the parse action's ``s`` argument
        - explictly expand the tabs in your input string before calling
          ``parseString``

        Example::

            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        """
        ParserElement.resetCache()
        if not self.streamlined:
            self.streamline()
            # ~ self.saveAsList = True
        for e in self.ignoreExprs:
            e.streamline()
        if not self.keepTabs:
            instring = instring.expandtabs()
        try:
            loc, tokens = self._parse(instring, 0)
            if parseAll:
                loc = self.preParse(instring, loc)
                se = Empty() + StringEnd()
                se._parse(instring, loc)
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc
        else:
            return tokens

    def scanString(self, instring, maxMatches=_MAX_INT, overlap=False):
        """
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        ``maxMatches`` argument, to clip scanning after 'n' matches are found.  If
        ``overlap`` is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See :class:`parseString` for more information on parsing
        strings with embedded tabs.

        Example::

            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens, start, end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])

        prints::

            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        """
        if not self.streamlined:
            self.streamline()
        for e in self.ignoreExprs:
            e.streamline()

        if not self.keepTabs:
            instring = _ustr(instring).expandtabs()
        instrlen = len(instring)
        loc = 0
        preparseFn = self.preParse
        parseFn = self._parse
        ParserElement.resetCache()
        matches = 0
        try:
            while loc <= instrlen and matches < maxMatches:
                try:
                    preloc = preparseFn(instring, loc)
                    nextLoc, tokens = parseFn(instring, preloc, callPreParse=False)
                except ParseException:
                    loc = preloc + 1
                else:
                    if nextLoc > loc:
                        matches += 1
                        yield tokens, preloc, nextLoc
                        if overlap:
                            nextloc = preparseFn(instring, loc)
                            if nextloc > loc:
                                loc = nextLoc
                            else:
                                loc += 1
                        else:
                            loc = nextLoc
                    else:
                        loc = preloc + 1
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def transformString(self, instring):
        """
        Extension to :class:`scanString`, to modify matching text with modified tokens that may
        be returned from a parse action.  To use ``transformString``, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking ``transformString()`` on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  ``transformString()`` returns the resulting transformed string.

        Example::

            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())

            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))

        prints::

            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        """
        out = []
        lastE = 0
        # force preservation of <TAB>s, to minimize unwanted transformation of string, and to
        # keep string locs straight between transformString and scanString
        self.keepTabs = True
        try:
            for t, s, e in self.scanString(instring):
                out.append(instring[lastE:s])
                if t:
                    if isinstance(t, ParseResults):
                        out += t.asList()
                    elif isinstance(t, list):
                        out += t
                    else:
                        out.append(t)
                lastE = e
            out.append(instring[lastE:])
            out = [o for o in out if o]
            return "".join(map(_ustr, _flatten(out)))
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def searchString(self, instring, maxMatches=_MAX_INT):
        """
        Another extension to :class:`scanString`, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        ``maxMatches`` argument, to clip searching after 'n' matches are found.

        Example::

            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())

            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))

        prints::

            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        """
        try:
            return ParseResults([t for t, s, e in self.scanString(instring, maxMatches)])
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
        """
        Generator method to split a string using the given expression as a separator.
        May be called with optional ``maxsplit`` argument, to limit the number of splits;
        and the optional ``includeSeparators`` argument (default= ``False``), if the separating
        matching text should be included in the split results.

        Example::

            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))

        prints::

            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        """
        splits = 0
        last = 0
        for t, s, e in self.scanString(instring, maxMatches=maxsplit):
            yield instring[last:s]
            if includeSeparators:
                yield t[0]
            last = e
        yield instring[last:]

    def __add__(self, other):
        """
        Implementation of + operator - returns :class:`And`. Adding strings to a ParserElement
        converts them to :class:`Literal`s by default.

        Example::

            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))

        prints::

            Hello, World! -> ['Hello', ',', 'World', '!']

        ``...`` may be used as a parse expression as a short form of :class:`SkipTo`.

            Literal('start') + ... + Literal('end')

        is equivalent to:

            Literal('start') + SkipTo('end')("_skipped*") + Literal('end')

        Note that the skipped text is returned with '_skipped' as a results name,
        and to support having multiple skips in the same parser, the value returned is
        a list of all skipped text.
        """
        if other is Ellipsis:
            return _PendingSkip(self)

        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return And([self, other])

    def __radd__(self, other):
        """
        Implementation of + operator when left operand is not a :class:`ParserElement`
        """
        if other is Ellipsis:
            return SkipTo(self)("_skipped*") + self

        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return other + self

    def __sub__(self, other):
        """
        Implementation of - operator, returns :class:`And` with error stop
        """
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return self + And._ErrorStop() + other

    def __rsub__(self, other):
        """
        Implementation of - operator when left operand is not a :class:`ParserElement`
        """
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return other - self

    def __mul__(self, other):
        """
        Implementation of * operator, allows use of ``expr * 3`` in place of
        ``expr + expr + expr``.  Expressions may also me multiplied by a 2-integer
        tuple, similar to ``{min, max}`` multipliers in regular expressions.  Tuples
        may also include ``None`` as in:
         - ``expr*(n, None)`` or ``expr*(n, )`` is equivalent
              to ``expr*n + ZeroOrMore(expr)``
              (read as "at least n instances of ``expr``")
         - ``expr*(None, n)`` is equivalent to ``expr*(0, n)``
              (read as "0 to n instances of ``expr``")
         - ``expr*(None, None)`` is equivalent to ``ZeroOrMore(expr)``
         - ``expr*(1, None)`` is equivalent to ``OneOrMore(expr)``

        Note that ``expr*(None, n)`` does not raise an exception if
        more than n exprs exist in the input stream; that is,
        ``expr*(None, n)`` does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        ``expr*(None, n) + ~expr``
        """
        if other is Ellipsis:
            other = (0, None)
        elif isinstance(other, tuple) and other[:1] == (Ellipsis,):
            other = ((0, ) + other[1:] + (None,))[:2]

        if isinstance(other, int):
            minElements, optElements = other, 0
        elif isinstance(other, tuple):
            other = tuple(o if o is not Ellipsis else None for o in other)
            other = (other + (None, None))[:2]
            if other[0] is None:
                other = (0, other[1])
            if isinstance(other[0], int) and other[1] is None:
                if other[0] == 0:
                    return ZeroOrMore(self)
                if other[0] == 1:
                    return OneOrMore(self)
                else:
                    return self * other[0] + ZeroOrMore(self)
            elif isinstance(other[0], int) and isinstance(other[1], int):
                minElements, optElements = other
                optElements -= minElements
            else:
                raise TypeError("cannot multiply 'ParserElement' and ('%s', '%s') objects", type(other[0]), type(other[1]))
        else:
            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))

        if minElements < 0:
            raise ValueError("cannot multiply ParserElement by negative value")
        if optElements < 0:
            raise ValueError("second tuple value must be greater or equal to first tuple value")
        if minElements == optElements == 0:
            raise ValueError("cannot multiply ParserElement by 0 or (0, 0)")

        if optElements:
            def makeOptionalList(n):
                if n > 1:
                    return Optional(self + makeOptionalList(n - 1))
                else:
                    return Optional(self)
            if minElements:
                if minElements == 1:
                    ret = self + makeOptionalList(optElements)
                else:
                    ret = And([self] * minElements) + makeOptionalList(optElements)
            else:
                ret = makeOptionalList(optElements)
        else:
            if minElements == 1:
                ret = self
            else:
                ret = And([self] * minElements)
        return ret

    def __rmul__(self, other):
        return self.__mul__(other)

    def __or__(self, other):
        """
        Implementation of | operator - returns :class:`MatchFirst`
        """
        if other is Ellipsis:
            return _PendingSkip(self, must_skip=True)

        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return MatchFirst([self, other])

    def __ror__(self, other):
        """
        Implementation of | operator when left operand is not a :class:`ParserElement`
        """
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return other | self

    def __xor__(self, other):
        """
        Implementation of ^ operator - returns :class:`Or`
        """
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return Or([self, other])

    def __rxor__(self, other):
        """
        Implementation of ^ operator when left operand is not a :class:`ParserElement`
        """
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return other ^ self

    def __and__(self, other):
        """
        Implementation of & operator - returns :class:`Each`
        """
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return Each([self, other])

    def __rand__(self, other):
        """
        Implementation of & operator when left operand is not a :class:`ParserElement`
        """
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        if not isinstance(other, ParserElement):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                          SyntaxWarning, stacklevel=2)
            return None
        return other & self

    def __invert__(self):
        """
        Implementation of ~ operator - returns :class:`NotAny`
        """
        return NotAny(self)

    def __iter__(self):
        # must implement __iter__ to override legacy use of sequential access to __getitem__ to
        # iterate over a sequence
        raise TypeError('%r object is not iterable' % self.__class__.__name__)

    def __getitem__(self, key):
        """
        use ``[]`` indexing notation as a short form for expression repetition:
         - ``expr[n]`` is equivalent to ``expr*n``
         - ``expr[m, n]`` is equivalent to ``expr*(m, n)``
         - ``expr[n, ...]`` or ``expr[n,]`` is equivalent
              to ``expr*n + ZeroOrMore(expr)``
              (read as "at least n instances of ``expr``")
         - ``expr[..., n]`` is equivalent to ``expr*(0, n)``
              (read as "0 to n instances of ``expr``")
         - ``expr[...]`` and ``expr[0, ...]`` are equivalent to ``ZeroOrMore(expr)``
         - ``expr[1, ...]`` is equivalent to ``OneOrMore(expr)``
         ``None`` may be used in place of ``...``.

        Note that ``expr[..., n]`` and ``expr[m, n]``do not raise an exception
        if more than ``n`` ``expr``s exist in the input stream.  If this behavior is
        desired, then write ``expr[..., n] + ~expr``.
       """

        # convert single arg keys to tuples
        try:
            if isinstance(key, str):
                key = (key,)
            iter(key)
        except TypeError:
            key = (key, key)

        if len(key) > 2:
            warnings.warn("only 1 or 2 index arguments supported ({0}{1})".format(key[:5],
                                                                                '... [{0}]'.format(len(key))
                                                                                if len(key) > 5 else ''))

        # clip to 2 elements
        ret = self * tuple(key[:2])
        return ret

    def __call__(self, name=None):
        """
        Shortcut for :class:`setResultsName`, with ``listAllMatches=False``.

        If ``name`` is given with a trailing ``'*'`` character, then ``listAllMatches`` will be
        passed as ``True``.

        If ``name` is omitted, same as calling :class:`copy`.

        Example::

            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums + "-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums + "-")("socsecno")
        """
        if name is not None:
            return self._setResultsName(name)
        else:
            return self.copy()

    def suppress(self):
        """
        Suppresses the output of this :class:`ParserElement`; useful to keep punctuation from
        cluttering up returned output.
        """
        return Suppress(self)

    def leaveWhitespace(self):
        """
        Disables the skipping of whitespace before matching the characters in the
        :class:`ParserElement`'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        """
        self.skipWhitespace = False
        return self

    def setWhitespaceChars(self, chars):
        """
        Overrides the default whitespace chars
        """
        self.skipWhitespace = True
        self.whiteChars = chars
        self.copyDefaultWhiteChars = False
        return self

    def parseWithTabs(self):
        """
        Overrides default behavior to expand ``<TAB>``s to spaces before parsing the input string.
        Must be called before ``parseString`` when the input grammar contains elements that
        match ``<TAB>`` characters.
        """
        self.keepTabs = True
        return self

    def ignore(self, other):
        """
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.

        Example::

            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']

            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        """
        if isinstance(other, basestring):
            other = Suppress(other)

        if isinstance(other, Suppress):
            if other not in self.ignoreExprs:
                self.ignoreExprs.append(other)
        else:
            self.ignoreExprs.append(Suppress(other.copy()))
        return self

    def setDebugActions(self, startAction, successAction, exceptionAction):
        """
        Enable display of debugging messages while doing pattern matching.
        """
        self.debugActions = (startAction or _defaultStartDebugAction,
                             successAction or _defaultSuccessDebugAction,
                             exceptionAction or _defaultExceptionDebugAction)
        self.debug = True
        return self

    def setDebug(self, flag=True):
        """
        Enable display of debugging messages while doing pattern matching.
        Set ``flag`` to True to enable, False to disable.

        Example::

            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer

            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")

        prints::

            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using :class:`setDebugActions`. Prior to attempting
        to match the ``wd`` expression, the debugging message ``"Match <exprname> at loc <n>(<line>,<col>)"``
        is shown. Then if the parse succeeds, a ``"Matched"`` message is shown, or an ``"Exception raised"``
        message is shown. Also note the use of :class:`setName` to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the :class:`Word` expression without calling ``setName`` is ``"W:(ABCD...)"``.
        """
        if flag:
            self.setDebugActions(_defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction)
        else:
            self.debug = False
        return self

    def __str__(self):
        return self.name

    def __repr__(self):
        return _ustr(self)

    def streamline(self):
        self.streamlined = True
        self.strRepr = None
        return self

    def checkRecursion(self, parseElementList):
        pass

    def validate(self, validateTrace=None):
        """
        Check defined expressions for valid structure, check for infinite recursive definitions.
        """
        self.checkRecursion([])

    def parseFile(self, file_or_filename, parseAll=False):
        """
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        """
        try:
            file_contents = file_or_filename.read()
        except AttributeError:
            with open(file_or_filename, "r") as f:
                file_contents = f.read()
        try:
            return self.parseString(file_contents, parseAll)
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def __eq__(self, other):
        if isinstance(other, ParserElement):
            if PY_3:
                self is other or super(ParserElement, self).__eq__(other)
            else:
                return self is other or vars(self) == vars(other)
        elif isinstance(other, basestring):
            return self.matches(other)
        else:
            return super(ParserElement, self) == other

    def __ne__(self, other):
        return not (self == other)

    def __hash__(self):
        return id(self)

    def __req__(self, other):
        return self == other

    def __rne__(self, other):
        return not (self == other)

    def matches(self, testString, parseAll=True):
        """
        Method for quick testing of a parser against a test string. Good for simple
        inline microtests of sub expressions while building up larger parser.

        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests

        Example::

            expr = Word(nums)
            assert expr.matches("100")
        """
        try:
            self.parseString(_ustr(testString), parseAll=parseAll)
            return True
        except ParseBaseException:
            return False

    def runTests(self, tests, parseAll=True, comment='#',
                 fullDump=True, printResults=True, failureTests=False, postParse=None,
                 file=None):
        """
        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.

        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default= ``True``) - flag to pass to :class:`parseString` when running tests
         - comment - (default= ``'#'``) - expression for indicating embedded comments in the test
              string; pass None to disable comment filtering
         - fullDump - (default= ``True``) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default= ``True``) prints test output to stdout
         - failureTests - (default= ``False``) indicates if these tests are expected to fail parsing
         - postParse - (default= ``None``) optional callback for successful parse results; called as
              `fn(test_string, parse_results)` and returns a string to be added to the test output
         - file - (default=``None``) optional file-like object to which test output will be written;
              if None, will default to ``sys.stdout``

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if ``failureTests`` is True), and the results contain a list of lines of each
        test's output

        Example::

            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")

        prints::

            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success

            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")

        (Note that this is a raw string literal, you must include the leading 'r'.)
        """
        if isinstance(tests, basestring):
            tests = list(map(str.strip, tests.rstrip().splitlines()))
        if isinstance(comment, basestring):
            comment = Literal(comment)
        if file is None:
            file = sys.stdout
        print_ = file.write

        allResults = []
        comments = []
        success = True
        NL = Literal(r'\n').addParseAction(replaceWith('\n')).ignore(quotedString)
        BOM = u'\ufeff'
        for t in tests:
            if comment is not None and comment.matches(t, False) or comments and not t:
                comments.append(t)
                continue
            if not t:
                continue
            out = ['\n'.join(comments), t]
            comments = []
            try:
                # convert newline marks to actual newlines, and strip leading BOM if present
                t = NL.transformString(t.lstrip(BOM))
                result = self.parseString(t, parseAll=parseAll)
            except ParseBaseException as pe:
                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
                if '\n' in t:
                    out.append(line(pe.loc, t))
                    out.append(' ' * (col(pe.loc, t) - 1) + '^' + fatal)
                else:
                    out.append(' ' * pe.loc + '^' + fatal)
                out.append("FAIL: " + str(pe))
                success = success and failureTests
                result = pe
            except Exception as exc:
                out.append("FAIL-EXCEPTION: " + str(exc))
                success = success and failureTests
                result = exc
            else:
                success = success and not failureTests
                if postParse is not None:
                    try:
                        pp_value = postParse(t, result)
                        if pp_value is not None:
                            if isinstance(pp_value, ParseResults):
                                out.append(pp_value.dump())
                            else:
                                out.append(str(pp_value))
                        else:
                            out.append(result.dump())
                    except Exception as e:
                        out.append(result.dump(full=fullDump))
                        out.append("{0} failed: {1}: {2}".format(postParse.__name__, type(e).__name__, e))
                else:
                    out.append(result.dump(full=fullDump))

            if printResults:
                if fullDump:
                    out.append('')
                print_('\n'.join(out))

            allResults.append((t, result))

        return success, allResults


class _PendingSkip(ParserElement):
    # internal placeholder class to hold a place were '...' is added to a parser element,
    # once another ParserElement is added, this placeholder will be replaced with a SkipTo
    def __init__(self, expr, must_skip=False):
        super(_PendingSkip, self).__init__()
        self.strRepr = str(expr + Empty()).replace('Empty', '...')
        self.name = self.strRepr
        self.anchor = expr
        self.must_skip = must_skip

    def __add__(self, other):
        skipper = SkipTo(other).setName("...")("_skipped*")
        if self.must_skip:
            def must_skip(t):
                if not t._skipped or t._skipped.asList() == ['']:
                    del t[0]
                    t.pop("_skipped", None)
            def show_skip(t):
                if t._skipped.asList()[-1:] == ['']:
                    skipped = t.pop('_skipped')
                    t['_skipped'] = 'missing <' + repr(self.anchor) + '>'
            return (self.anchor + skipper().addParseAction(must_skip)
                    | skipper().addParseAction(show_skip)) + other

        return self.anchor + skipper + other

    def __repr__(self):
        return self.strRepr

    def parseImpl(self, *args):
        raise Exception("use of `...` expression without following SkipTo target expression")


class Token(ParserElement):
    """Abstract :class:`ParserElement` subclass, for defining atomic
    matching patterns.
    """
    def __init__(self):
        super(Token, self).__init__(savelist=False)


class Empty(Token):
    """An empty token, will always match.
    """
    def __init__(self):
        super(Empty, self).__init__()
        self.name = "Empty"
        self.mayReturnEmpty = True
        self.mayIndexError = False


class NoMatch(Token):
    """A token that will never match.
    """
    def __init__(self):
        super(NoMatch, self).__init__()
        self.name = "NoMatch"
        self.mayReturnEmpty = True
        self.mayIndexError = False
        self.errmsg = "Unmatchable token"

    def parseImpl(self, instring, loc, doActions=True):
        raise ParseException(instring, loc, self.errmsg, self)


class Literal(Token):
    """Token to exactly match a specified string.

    Example::

        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"

    For case-insensitive matching, use :class:`CaselessLiteral`.

    For keyword matching (force word break before and after the matched string),
    use :class:`Keyword` or :class:`CaselessKeyword`.
    """
    def __init__(self, matchString):
        super(Literal, self).__init__()
        self.match = matchString
        self.matchLen = len(matchString)
        try:
            self.firstMatchChar = matchString[0]
        except IndexError:
            warnings.warn("null string passed to Literal; use Empty() instead",
                            SyntaxWarning, stacklevel=2)
            self.__class__ = Empty
        self.name = '"%s"' % _ustr(self.match)
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = False
        self.mayIndexError = False

        # Performance tuning: modify __class__ to select
        # a parseImpl optimized for single-character check
        if self.matchLen == 1 and type(self) is Literal:
            self.__class__ = _SingleCharLiteral

    def parseImpl(self, instring, loc, doActions=True):
        if instring[loc] == self.firstMatchChar and instring.startswith(self.match, loc):
            return loc + self.matchLen, self.match
        raise ParseException(instring, loc, self.errmsg, self)

class _SingleCharLiteral(Literal):
    def parseImpl(self, instring, loc, doActions=True):
        if instring[loc] == self.firstMatchChar:
            return loc + 1, self.match
        raise ParseException(instring, loc, self.errmsg, self)

_L = Literal
ParserElement._literalStringClass = Literal

class Keyword(Token):
    """Token to exactly match a specified string as a keyword, that is,
    it must be immediately followed by a non-keyword character.  Compare
    with :class:`Literal`:

     - ``Literal("if")`` will match the leading ``'if'`` in
       ``'ifAndOnlyIf'``.
     - ``Keyword("if")`` will not; it will only match the leading
       ``'if'`` in ``'if x=1'``, or ``'if(y==2)'``

    Accepts two optional constructor arguments in addition to the
    keyword string:

     - ``identChars`` is a string of characters that would be valid
       identifier characters, defaulting to all alphanumerics + "_" and
       "$"
     - ``caseless`` allows case-insensitive matching, default is ``False``.

    Example::

        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use :class:`CaselessKeyword`.
    """
    DEFAULT_KEYWORD_CHARS = alphanums + "_$"

    def __init__(self, matchString, identChars=None, caseless=False):
        super(Keyword, self).__init__()
        if identChars is None:
            identChars = Keyword.DEFAULT_KEYWORD_CHARS
        self.match = matchString
        self.matchLen = len(matchString)
        try:
            self.firstMatchChar = matchString[0]
        except IndexError:
            warnings.warn("null string passed to Keyword; use Empty() instead",
                          SyntaxWarning, stacklevel=2)
        self.name = '"%s"' % self.match
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = False
        self.mayIndexError = False
        self.caseless = caseless
        if caseless:
            self.caselessmatch = matchString.upper()
            identChars = identChars.upper()
        self.identChars = set(identChars)

    def parseImpl(self, instring, loc, doActions=True):
        if self.caseless:
            if ((instring[loc:loc + self.matchLen].upper() == self.caselessmatch)
                    and (loc >= len(instring) - self.matchLen
                         or instring[loc + self.matchLen].upper() not in self.identChars)
                    and (loc == 0
                         or instring[loc - 1].upper() not in self.identChars)):
                return loc + self.matchLen, self.match

        else:
            if instring[loc] == self.firstMatchChar:
                if ((self.matchLen == 1 or instring.startswith(self.match, loc))
                        and (loc >= len(instring) - self.matchLen
                             or instring[loc + self.matchLen] not in self.identChars)
                        and (loc == 0 or instring[loc - 1] not in self.identChars)):
                    return loc + self.matchLen, self.match

        raise ParseException(instring, loc, self.errmsg, self)

    def copy(self):
        c = super(Keyword, self).copy()
        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
        return c

    @staticmethod
    def setDefaultKeywordChars(chars):
        """Overrides the default Keyword chars
        """
        Keyword.DEFAULT_KEYWORD_CHARS = chars

class CaselessLiteral(Literal):
    """Token to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::

        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']

    (Contrast with example for :class:`CaselessKeyword`.)
    """
    def __init__(self, matchString):
        super(CaselessLiteral, self).__init__(matchString.upper())
        # Preserve the defining literal.
        self.returnString = matchString
        self.name = "'%s'" % self.returnString
        self.errmsg = "Expected " + self.name

    def parseImpl(self, instring, loc, doActions=True):
        if instring[loc:loc + self.matchLen].upper() == self.match:
            return loc + self.matchLen, self.returnString
        raise ParseException(instring, loc, self.errmsg, self)

class CaselessKeyword(Keyword):
    """
    Caseless version of :class:`Keyword`.

    Example::

        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']

    (Contrast with example for :class:`CaselessLiteral`.)
    """
    def __init__(self, matchString, identChars=None):
        super(CaselessKeyword, self).__init__(matchString, identChars, caseless=True)

class CloseMatch(Token):
    """A variation on :class:`Literal` which matches "close" matches,
    that is, strings with at most 'n' mismatching characters.
    :class:`CloseMatch` takes parameters:

     - ``match_string`` - string to be matched
     - ``maxMismatches`` - (``default=1``) maximum number of
       mismatches allowed to count as a match

    The results from a successful parse will contain the matched text
    from the input string and the following named results:

     - ``mismatches`` - a list of the positions within the
       match_string where mismatches were found
     - ``original`` - the original match_string used to compare
       against the input string

    If ``mismatches`` is an empty list, then the match was an exact
    match.

    Example::

        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    """
    def __init__(self, match_string, maxMismatches=1):
        super(CloseMatch, self).__init__()
        self.name = match_string
        self.match_string = match_string
        self.maxMismatches = maxMismatches
        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
        self.mayIndexError = False
        self.mayReturnEmpty = False

    def parseImpl(self, instring, loc, doActions=True):
        start = loc
        instrlen = len(instring)
        maxloc = start + len(self.match_string)

        if maxloc <= instrlen:
            match_string = self.match_string
            match_stringloc = 0
            mismatches = []
            maxMismatches = self.maxMismatches

            for match_stringloc, s_m in enumerate(zip(instring[loc:maxloc], match_string)):
                src, mat = s_m
                if src != mat:
                    mismatches.append(match_stringloc)
                    if len(mismatches) > maxMismatches:
                        break
            else:
                loc = match_stringloc + 1
                results = ParseResults([instring[start:loc]])
                results['original'] = match_string
                results['mismatches'] = mismatches
                return loc, results

        raise ParseException(instring, loc, self.errmsg, self)


class Word(Token):
    """Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters, an
    optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for ``min`` is
    1 (a minimum value < 1 is not valid); the default values for
    ``max`` and ``exact`` are 0, meaning no maximum or exact
    length restriction. An optional ``excludeChars`` parameter can
    list characters that might be found in the input ``bodyChars``
    string; useful to define a word of all printables except for one or
    two characters, for instance.

    :class:`srange` is useful for defining custom character set strings
    for defining ``Word`` expressions, using range notation from
    regular expression character sets.

    A common mistake is to use :class:`Word` to match a specific literal
    string, as in ``Word("Address")``. Remember that :class:`Word`
    uses the string argument to define *sets* of matchable characters.
    This expression would match "Add", "AAA", "dAred", or any other word
    made up of the characters 'A', 'd', 'r', 'e', and 's'. To match an
    exact literal string, use :class:`Literal` or :class:`Keyword`.

    pyparsing includes helper strings for building Words:

     - :class:`alphas`
     - :class:`nums`
     - :class:`alphanums`
     - :class:`hexnums`
     - :class:`alphas8bit` (alphabetic characters in ASCII range 128-255
       - accented, tilded, umlauted, etc.)
     - :class:`punc8bit` (non-alphabetic characters in ASCII range
       128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - :class:`printables` (any non-whitespace character)

    Example::

        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))

        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums + '-')

        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")

        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    """
    def __init__(self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None):
        super(Word, self).__init__()
        if excludeChars:
            excludeChars = set(excludeChars)
            initChars = ''.join(c for c in initChars if c not in excludeChars)
            if bodyChars:
                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
        self.initCharsOrig = initChars
        self.initChars = set(initChars)
        if bodyChars:
            self.bodyCharsOrig = bodyChars
            self.bodyChars = set(bodyChars)
        else:
            self.bodyCharsOrig = initChars
            self.bodyChars = set(initChars)

        self.maxSpecified = max > 0

        if min < 1:
            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.asKeyword = asKeyword

        if ' ' not in self.initCharsOrig + self.bodyCharsOrig and (min == 1 and max == 0 and exact == 0):
            if self.bodyCharsOrig == self.initCharsOrig:
                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
            elif len(self.initCharsOrig) == 1:
                self.reString = "%s[%s]*" % (re.escape(self.initCharsOrig),
                                             _escapeRegexRangeChars(self.bodyCharsOrig),)
            else:
                self.reString = "[%s][%s]*" % (_escapeRegexRangeChars(self.initCharsOrig),
                                               _escapeRegexRangeChars(self.bodyCharsOrig),)
            if self.asKeyword:
                self.reString = r"\b" + self.reString + r"\b"

            try:
                self.re = re.compile(self.reString)
            except Exception:
                self.re = None
            else:
                self.re_match = self.re.match
                self.__class__ = _WordRegex

    def parseImpl(self, instring, loc, doActions=True):
        if instring[loc] not in self.initChars:
            raise ParseException(instring, loc, self.errmsg, self)

        start = loc
        loc += 1
        instrlen = len(instring)
        bodychars = self.bodyChars
        maxloc = start + self.maxLen
        maxloc = min(maxloc, instrlen)
        while loc < maxloc and instring[loc] in bodychars:
            loc += 1

        throwException = False
        if loc - start < self.minLen:
            throwException = True
        elif self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
            throwException = True
        elif self.asKeyword:
            if (start > 0 and instring[start - 1] in bodychars
                    or loc < instrlen and instring[loc] in bodychars):
                throwException = True

        if throwException:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]

    def __str__(self):
        try:
            return super(Word, self).__str__()
        except Exception:
            pass

        if self.strRepr is None:

            def charsAsStr(s):
                if len(s) > 4:
                    return s[:4] + "..."
                else:
                    return s

            if self.initCharsOrig != self.bodyCharsOrig:
                self.strRepr = "W:(%s, %s)" % (charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig))
            else:
                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)

        return self.strRepr

class _WordRegex(Word):
    def parseImpl(self, instring, loc, doActions=True):
        result = self.re_match(instring, loc)
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        return loc, result.group()


class Char(_WordRegex):
    """A short-cut class for defining ``Word(characters, exact=1)``,
    when defining a match of any single character in a string of
    characters.
    """
    def __init__(self, charset, asKeyword=False, excludeChars=None):
        super(Char, self).__init__(charset, exact=1, asKeyword=asKeyword, excludeChars=excludeChars)
        self.reString = "[%s]" % _escapeRegexRangeChars(''.join(self.initChars))
        if asKeyword:
            self.reString = r"\b%s\b" % self.reString
        self.re = re.compile(self.reString)
        self.re_match = self.re.match


class Regex(Token):
    r"""Token for matching strings that match a given regular
    expression. Defined with string specifying the regular expression in
    a form recognized by the stdlib Python  `re module <https://docs.python.org/3/library/re.html>`_.
    If the given regex contains named groups (defined using ``(?P<name>...)``),
    these will be preserved as named parse results.

    Example::

        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: https://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    """
    compiledREtype = type(re.compile("[A-Z]"))
    def __init__(self, pattern, flags=0, asGroupList=False, asMatch=False):
        """The parameters ``pattern`` and ``flags`` are passed
        to the ``re.compile()`` function as-is. See the Python
        `re module <https://docs.python.org/3/library/re.html>`_ module for an
        explanation of the acceptable patterns and flags.
        """
        super(Regex, self).__init__()

        if isinstance(pattern, basestring):
            if not pattern:
                warnings.warn("null string passed to Regex; use Empty() instead",
                              SyntaxWarning, stacklevel=2)

            self.pattern = pattern
            self.flags = flags

            try:
                self.re = re.compile(self.pattern, self.flags)
                self.reString = self.pattern
            except sre_constants.error:
                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
                              SyntaxWarning, stacklevel=2)
                raise

        elif isinstance(pattern, Regex.compiledREtype):
            self.re = pattern
            self.pattern = self.reString = str(pattern)
            self.flags = flags

        else:
            raise ValueError("Regex may only be constructed with a string or a compiled RE object")

        self.re_match = self.re.match

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.mayReturnEmpty = True
        self.asGroupList = asGroupList
        self.asMatch = asMatch
        if self.asGroupList:
            self.parseImpl = self.parseImplAsGroupList
        if self.asMatch:
            self.parseImpl = self.parseImplAsMatch

    def parseImpl(self, instring, loc, doActions=True):
        result = self.re_match(instring, loc)
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        ret = ParseResults(result.group())
        d = result.groupdict()
        if d:
            for k, v in d.items():
                ret[k] = v
        return loc, ret

    def parseImplAsGroupList(self, instring, loc, doActions=True):
        result = self.re_match(instring, loc)
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        ret = result.groups()
        return loc, ret

    def parseImplAsMatch(self, instring, loc, doActions=True):
        result = self.re_match(instring, loc)
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        ret = result
        return loc, ret

    def __str__(self):
        try:
            return super(Regex, self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "Re:(%s)" % repr(self.pattern)

        return self.strRepr

    def sub(self, repl):
        r"""
        Return Regex with an attached parse action to transform the parsed
        result as if called using `re.sub(expr, repl, string) <https://docs.python.org/3/library/re.html#re.sub>`_.

        Example::

            make_html = Regex(r"(\w+):(.*?):").sub(r"<\1>\2</\1>")
            print(make_html.transformString("h1:main title:"))
            # prints "<h1>main title</h1>"
        """
        if self.asGroupList:
            warnings.warn("cannot use sub() with Regex(asGroupList=True)",
                          SyntaxWarning, stacklevel=2)
            raise SyntaxError()

        if self.asMatch and callable(repl):
            warnings.warn("cannot use sub() with a callable with Regex(asMatch=True)",
                          SyntaxWarning, stacklevel=2)
            raise SyntaxError()

        if self.asMatch:
            def pa(tokens):
                return tokens[0].expand(repl)
        else:
            def pa(tokens):
                return self.re.sub(repl, tokens[0])
        return self.addParseAction(pa)

class QuotedString(Token):
    r"""
    Token for matching strings that are delimited by quoting characters.

    Defined with the following parameters:

        - quoteChar - string of one or more characters defining the
          quote delimiting string
        - escChar - character to escape quotes, typically backslash
          (default= ``None``)
        - escQuote - special quote sequence to escape an embedded quote
          string (such as SQL's ``""`` to escape an embedded ``"``)
          (default= ``None``)
        - multiline - boolean indicating whether quotes can span
          multiple lines (default= ``False``)
        - unquoteResults - boolean indicating whether the matched text
          should be unquoted (default= ``True``)
        - endQuoteChar - string of one or more characters defining the
          end of the quote delimited string (default= ``None``  => same as
          quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace
          (``'\t'``, ``'\n'``, etc.) to actual whitespace
          (default= ``True``)

    Example::

        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))

    prints::

        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    """
    def __init__(self, quoteChar, escChar=None, escQuote=None, multiline=False,
                 unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
        super(QuotedString, self).__init__()

        # remove white space from quote chars - wont work anyway
        quoteChar = quoteChar.strip()
        if not quoteChar:
            warnings.warn("quoteChar cannot be the empty string", SyntaxWarning, stacklevel=2)
            raise SyntaxError()

        if endQuoteChar is None:
            endQuoteChar = quoteChar
        else:
            endQuoteChar = endQuoteChar.strip()
            if not endQuoteChar:
                warnings.warn("endQuoteChar cannot be the empty string", SyntaxWarning, stacklevel=2)
                raise SyntaxError()

        self.quoteChar = quoteChar
        self.quoteCharLen = len(quoteChar)
        self.firstQuoteChar = quoteChar[0]
        self.endQuoteChar = endQuoteChar
        self.endQuoteCharLen = len(endQuoteChar)
        self.escChar = escChar
        self.escQuote = escQuote
        self.unquoteResults = unquoteResults
        self.convertWhitespaceEscapes = convertWhitespaceEscapes

        if multiline:
            self.flags = re.MULTILINE | re.DOTALL
            self.pattern = r'%s(?:[^%s%s]' % (re.escape(self.quoteChar),
                                              _escapeRegexRangeChars(self.endQuoteChar[0]),
                                              (escChar is not None and _escapeRegexRangeChars(escChar) or ''))
        else:
            self.flags = 0
            self.pattern = r'%s(?:[^%s\n\r%s]' % (re.escape(self.quoteChar),
                                                  _escapeRegexRangeChars(self.endQuoteChar[0]),
                                                  (escChar is not None and _escapeRegexRangeChars(escChar) or ''))
        if len(self.endQuoteChar) > 1:
            self.pattern += (
                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
                                                   _escapeRegexRangeChars(self.endQuoteChar[i]))
                                      for i in range(len(self.endQuoteChar) - 1, 0, -1)) + ')')

        if escQuote:
            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
        if escChar:
            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
            self.escCharReplacePattern = re.escape(self.escChar) + "(.)"
        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))

        try:
            self.re = re.compile(self.pattern, self.flags)
            self.reString = self.pattern
            self.re_match = self.re.match
        except sre_constants.error:
            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
                          SyntaxWarning, stacklevel=2)
            raise

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.mayReturnEmpty = True

    def parseImpl(self, instring, loc, doActions=True):
        result = instring[loc] == self.firstQuoteChar and self.re_match(instring, loc) or None
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        ret = result.group()

        if self.unquoteResults:

            # strip off quotes
            ret = ret[self.quoteCharLen: -self.endQuoteCharLen]

            if isinstance(ret, basestring):
                # replace escaped whitespace
                if '\\' in ret and self.convertWhitespaceEscapes:
                    ws_map = {
                        r'\t': '\t',
                        r'\n': '\n',
                        r'\f': '\f',
                        r'\r': '\r',
                    }
                    for wslit, wschar in ws_map.items():
                        ret = ret.replace(wslit, wschar)

                # replace escaped characters
                if self.escChar:
                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)

                # replace escaped quotes
                if self.escQuote:
                    ret = ret.replace(self.escQuote, self.endQuoteChar)

        return loc, ret

    def __str__(self):
        try:
            return super(QuotedString, self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)

        return self.strRepr


class CharsNotIn(Token):
    """Token for matching words composed of characters *not* in a given
    set (will include whitespace in matched characters if not listed in
    the provided exclusion set - see example). Defined with string
    containing all disallowed characters, and an optional minimum,
    maximum, and/or exact length.  The default value for ``min`` is
    1 (a minimum value < 1 is not valid); the default values for
    ``max`` and ``exact`` are 0, meaning no maximum or exact
    length restriction.

    Example::

        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))

    prints::

        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    """
    def __init__(self, notChars, min=1, max=0, exact=0):
        super(CharsNotIn, self).__init__()
        self.skipWhitespace = False
        self.notChars = notChars

        if min < 1:
            raise ValueError("cannot specify a minimum length < 1; use "
                             "Optional(CharsNotIn()) if zero-length char group is permitted")

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = (self.minLen == 0)
        self.mayIndexError = False

    def parseImpl(self, instring, loc, doActions=True):
        if instring[loc] in self.notChars:
            raise ParseException(instring, loc, self.errmsg, self)

        start = loc
        loc += 1
        notchars = self.notChars
        maxlen = min(start + self.maxLen, len(instring))
        while loc < maxlen and instring[loc] not in notchars:
            loc += 1

        if loc - start < self.minLen:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]

    def __str__(self):
        try:
            return super(CharsNotIn, self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            if len(self.notChars) > 4:
                self.strRepr = "!W:(%s...)" % self.notChars[:4]
            else:
                self.strRepr = "!W:(%s)" % self.notChars

        return self.strRepr

class White(Token):
    """Special matching class for matching whitespace.  Normally,
    whitespace is ignored by pyparsing grammars.  This class is included
    when some whitespace structures are significant.  Define with
    a string containing the whitespace characters to be matched; default
    is ``" \\t\\r\\n"``.  Also takes optional ``min``,
    ``max``, and ``exact`` arguments, as defined for the
    :class:`Word` class.
    """
    whiteStrs = {
        ' ' : '<SP>',
        '\t': '<TAB>',
        '\n': '<LF>',
        '\r': '<CR>',
        '\f': '<FF>',
        'u\00A0': '<NBSP>',
        'u\1680': '<OGHAM_SPACE_MARK>',
        'u\180E': '<MONGOLIAN_VOWEL_SEPARATOR>',
        'u\2000': '<EN_QUAD>',
        'u\2001': '<EM_QUAD>',
        'u\2002': '<EN_SPACE>',
        'u\2003': '<EM_SPACE>',
        'u\2004': '<THREE-PER-EM_SPACE>',
        'u\2005': '<FOUR-PER-EM_SPACE>',
        'u\2006': '<SIX-PER-EM_SPACE>',
        'u\2007': '<FIGURE_SPACE>',
        'u\2008': '<PUNCTUATION_SPACE>',
        'u\2009': '<THIN_SPACE>',
        'u\200A': '<HAIR_SPACE>',
        'u\200B': '<ZERO_WIDTH_SPACE>',
        'u\202F': '<NNBSP>',
        'u\205F': '<MMSP>',
        'u\3000': '<IDEOGRAPHIC_SPACE>',
        }
    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
        super(White, self).__init__()
        self.matchWhite = ws
        self.setWhitespaceChars("".join(c for c in self.whiteChars if c not in self.matchWhite))
        # ~ self.leaveWhitespace()
        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
        self.mayReturnEmpty = True
        self.errmsg = "Expected " + self.name

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

    def parseImpl(self, instring, loc, doActions=True):
        if instring[loc] not in self.matchWhite:
            raise ParseException(instring, loc, self.errmsg, self)
        start = loc
        loc += 1
        maxloc = start + self.maxLen
        maxloc = min(maxloc, len(instring))
        while loc < maxloc and instring[loc] in self.matchWhite:
            loc += 1

        if loc - start < self.minLen:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]


class _PositionToken(Token):
    def __init__(self):
        super(_PositionToken, self).__init__()
        self.name = self.__class__.__name__
        self.mayReturnEmpty = True
        self.mayIndexError = False

class GoToColumn(_PositionToken):
    """Token to advance to a specific column of input text; useful for
    tabular report scraping.
    """
    def __init__(self, colno):
        super(GoToColumn, self).__init__()
        self.col = colno

    def preParse(self, instring, loc):
        if col(loc, instring) != self.col:
            instrlen = len(instring)
            if self.ignoreExprs:
                loc = self._skipIgnorables(instring, loc)
            while loc < instrlen and instring[loc].isspace() and col(loc, instring) != self.col:
                loc += 1
        return loc

    def parseImpl(self, instring, loc, doActions=True):
        thiscol = col(loc, instring)
        if thiscol > self.col:
            raise ParseException(instring, loc, "Text not in expected column", self)
        newloc = loc + self.col - thiscol
        ret = instring[loc: newloc]
        return newloc, ret


class LineStart(_PositionToken):
    r"""Matches if current position is at the beginning of a line within
    the parse string

    Example::

        test = '''\
        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)

    prints::

        ['AAA', ' this line']
        ['AAA', ' and this line']

    """
    def __init__(self):
        super(LineStart, self).__init__()
        self.errmsg = "Expected start of line"

    def parseImpl(self, instring, loc, doActions=True):
        if col(loc, instring) == 1:
            return loc, []
        raise ParseException(instring, loc, self.errmsg, self)

class LineEnd(_PositionToken):
    """Matches if current position is at the end of a line within the
    parse string
    """
    def __init__(self):
        super(LineEnd, self).__init__()
        self.setWhitespaceChars(ParserElement.DEFAULT_WHITE_CHARS.replace("\n", ""))
        self.errmsg = "Expected end of line"

    def parseImpl(self, instring, loc, doActions=True):
        if loc < len(instring):
            if instring[loc] == "\n":
                return loc + 1, "\n"
            else:
                raise ParseException(instring, loc, self.errmsg, self)
        elif loc == len(instring):
            return loc + 1, []
        else:
            raise ParseException(instring, loc, self.errmsg, self)

class StringStart(_PositionToken):
    """Matches if current position is at the beginning of the parse
    string
    """
    def __init__(self):
        super(StringStart, self).__init__()
        self.errmsg = "Expected start of text"

    def parseImpl(self, instring, loc, doActions=True):
        if loc != 0:
            # see if entire string up to here is just whitespace and ignoreables
            if loc != self.preParse(instring, 0):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

class StringEnd(_PositionToken):
    """Matches if current position is at the end of the parse string
    """
    def __init__(self):
        super(StringEnd, self).__init__()
        self.errmsg = "Expected end of text"

    def parseImpl(self, instring, loc, doActions=True):
        if loc < len(instring):
            raise ParseException(instring, loc, self.errmsg, self)
        elif loc == len(instring):
            return loc + 1, []
        elif loc > len(instring):
            return loc, []
        else:
            raise ParseException(instring, loc, self.errmsg, self)

class WordStart(_PositionToken):
    """Matches if the current position is at the beginning of a Word,
    and is not preceded by any character in a given set of
    ``wordChars`` (default= ``printables``). To emulate the
    ``\b`` behavior of regular expressions, use
    ``WordStart(alphanums)``. ``WordStart`` will also match at
    the beginning of the string being parsed, or at the beginning of
    a line.
    """
    def __init__(self, wordChars=printables):
        super(WordStart, self).__init__()
        self.wordChars = set(wordChars)
        self.errmsg = "Not at the start of a word"

    def parseImpl(self, instring, loc, doActions=True):
        if loc != 0:
            if (instring[loc - 1] in self.wordChars
                    or instring[loc] not in self.wordChars):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

class WordEnd(_PositionToken):
    """Matches if the current position is at the end of a Word, and is
    not followed by any character in a given set of ``wordChars``
    (default= ``printables``). To emulate the ``\b`` behavior of
    regular expressions, use ``WordEnd(alphanums)``. ``WordEnd``
    will also match at the end of the string being parsed, or at the end
    of a line.
    """
    def __init__(self, wordChars=printables):
        super(WordEnd, self).__init__()
        self.wordChars = set(wordChars)
        self.skipWhitespace = False
        self.errmsg = "Not at the end of a word"

    def parseImpl(self, instring, loc, doActions=True):
        instrlen = len(instring)
        if instrlen > 0 and loc < instrlen:
            if (instring[loc] in self.wordChars or
                    instring[loc - 1] not in self.wordChars):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []


class ParseExpression(ParserElement):
    """Abstract subclass of ParserElement, for combining and
    post-processing parsed tokens.
    """
    def __init__(self, exprs, savelist=False):
        super(ParseExpression, self).__init__(savelist)
        if isinstance(exprs, _generatorType):
            exprs = list(exprs)

        if isinstance(exprs, basestring):
            self.exprs = [self._literalStringClass(exprs)]
        elif isinstance(exprs, ParserElement):
            self.exprs = [exprs]
        elif isinstance(exprs, Iterable):
            exprs = list(exprs)
            # if sequence of strings provided, wrap with Literal
            if any(isinstance(expr, basestring) for expr in exprs):
                exprs = (self._literalStringClass(e) if isinstance(e, basestring) else e for e in exprs)
            self.exprs = list(exprs)
        else:
            try:
                self.exprs = list(exprs)
            except TypeError:
                self.exprs = [exprs]
        self.callPreparse = False

    def append(self, other):
        self.exprs.append(other)
        self.strRepr = None
        return self

    def leaveWhitespace(self):
        """Extends ``leaveWhitespace`` defined in base class, and also invokes ``leaveWhitespace`` on
           all contained expressions."""
        self.skipWhitespace = False
        self.exprs = [e.copy() for e in self.exprs]
        for e in self.exprs:
            e.leaveWhitespace()
        return self

    def ignore(self, other):
        if isinstance(other, Suppress):
            if other not in self.ignoreExprs:
                super(ParseExpression, self).ignore(other)
                for e in self.exprs:
                    e.ignore(self.ignoreExprs[-1])
        else:
            super(ParseExpression, self).ignore(other)
            for e in self.exprs:
                e.ignore(self.ignoreExprs[-1])
        return self

    def __str__(self):
        try:
            return super(ParseExpression, self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "%s:(%s)" % (self.__class__.__name__, _ustr(self.exprs))
        return self.strRepr

    def streamline(self):
        super(ParseExpression, self).streamline()

        for e in self.exprs:
            e.streamline()

        # collapse nested And's of the form And(And(And(a, b), c), d) to And(a, b, c, d)
        # but only if there are no parse actions or resultsNames on the nested And's
        # (likewise for Or's and MatchFirst's)
        if len(self.exprs) == 2:
            other = self.exprs[0]
            if (isinstance(other, self.__class__)
                    and not other.parseAction
                    and other.resultsName is None
                    and not other.debug):
                self.exprs = other.exprs[:] + [self.exprs[1]]
                self.strRepr = None
                self.mayReturnEmpty |= other.mayReturnEmpty
                self.mayIndexError  |= other.mayIndexError

            other = self.exprs[-1]
            if (isinstance(other, self.__class__)
                    and not other.parseAction
                    and other.resultsName is None
                    and not other.debug):
                self.exprs = self.exprs[:-1] + other.exprs[:]
                self.strRepr = None
                self.mayReturnEmpty |= other.mayReturnEmpty
                self.mayIndexError  |= other.mayIndexError

        self.errmsg = "Expected " + _ustr(self)

        return self

    def validate(self, validateTrace=None):
        tmp = (validateTrace if validateTrace is not None else [])[:] + [self]
        for e in self.exprs:
            e.validate(tmp)
        self.checkRecursion([])

    def copy(self):
        ret = super(ParseExpression, self).copy()
        ret.exprs = [e.copy() for e in self.exprs]
        return ret

    def _setResultsName(self, name, listAllMatches=False):
        if __diag__.warn_ungrouped_named_tokens_in_collection:
            for e in self.exprs:
                if isinstance(e, ParserElement) and e.resultsName:
                    warnings.warn("{0}: setting results name {1!r} on {2} expression "
                                  "collides with {3!r} on contained expression".format("warn_ungrouped_named_tokens_in_collection",
                                                                                       name,
                                                                                       type(self).__name__,
                                                                                       e.resultsName),
                                  stacklevel=3)

        return super(ParseExpression, self)._setResultsName(name, listAllMatches)


class And(ParseExpression):
    """
    Requires all given :class:`ParseExpression` s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the ``'+'`` operator.
    May also be constructed using the ``'-'`` operator, which will
    suppress backtracking.

    Example::

        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"), name_expr("name"), integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    """

    class _ErrorStop(Empty):
        def __init__(self, *args, **kwargs):
            super(And._ErrorStop, self).__init__(*args, **kwargs)
            self.name = '-'
            self.leaveWhitespace()

    def __init__(self, exprs, savelist=True):
        if exprs and Ellipsis in exprs:
            tmp = []
            for i, expr in enumerate(exprs):
                if expr is Ellipsis:
                    if i < len(exprs) - 1:
                        skipto_arg = (Empty() + exprs[i + 1]).exprs[-1]
                        tmp.append(SkipTo(skipto_arg)("_skipped*"))
                    else:
                        raise Exception("cannot construct And with sequence ending in ...")
                else:
                    tmp.append(expr)
            exprs[:] = tmp
        super(And, self).__init__(exprs, savelist)
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        self.setWhitespaceChars(self.exprs[0].whiteChars)
        self.skipWhitespace = self.exprs[0].skipWhitespace
        self.callPreparse = True

    def streamline(self):
        # collapse any _PendingSkip's
        if self.exprs:
            if any(isinstance(e, ParseExpression) and e.exprs and isinstance(e.exprs[-1], _PendingSkip)
                   for e in self.exprs[:-1]):
                for i, e in enumerate(self.exprs[:-1]):
                    if e is None:
                        continue
                    if (isinstance(e, ParseExpression)
                            and e.exprs and isinstance(e.exprs[-1], _PendingSkip)):
                        e.exprs[-1] = e.exprs[-1] + self.exprs[i + 1]
                        self.exprs[i + 1] = None
                self.exprs = [e for e in self.exprs if e is not None]

        super(And, self).streamline()
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        return self

    def parseImpl(self, instring, loc, doActions=True):
        # pass False as last arg to _parse for first element, since we already
        # pre-parsed the string as part of our And pre-parsing
        loc, resultlist = self.exprs[0]._parse(instring, loc, doActions, callPreParse=False)
        errorStop = False
        for e in self.exprs[1:]:
            if isinstance(e, And._ErrorStop):
                errorStop = True
                continue
            if errorStop:
                try:
                    loc, exprtokens = e._parse(instring, loc, doActions)
                except ParseSyntaxException:
                    raise
                except ParseBaseException as pe:
                    pe.__traceback__ = None
                    raise ParseSyntaxException._from_exception(pe)
                except IndexError:
                    raise ParseSyntaxException(instring, len(instring), self.errmsg, self)
            else:
                loc, exprtokens = e._parse(instring, loc, doActions)
            if exprtokens or exprtokens.haskeys():
                resultlist += exprtokens
        return loc, resultlist

    def __iadd__(self, other):
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        return self.append(other)  # And([self, other])

    def checkRecursion(self, parseElementList):
        subRecCheckList = parseElementList[:] + [self]
        for e in self.exprs:
            e.checkRecursion(subRecCheckList)
            if not e.mayReturnEmpty:
                break

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr


class Or(ParseExpression):
    """Requires that at least one :class:`ParseExpression` is found. If
    two expressions match, the expression that matches the longest
    string will be used. May be constructed using the ``'^'``
    operator.

    Example::

        # construct Or using '^' operator

        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))

    prints::

        [['123'], ['3.1416'], ['789']]
    """
    def __init__(self, exprs, savelist=False):
        super(Or, self).__init__(exprs, savelist)
        if self.exprs:
            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
        else:
            self.mayReturnEmpty = True

    def streamline(self):
        super(Or, self).streamline()
        if __compat__.collect_all_And_tokens:
            self.saveAsList = any(e.saveAsList for e in self.exprs)
        return self

    def parseImpl(self, instring, loc, doActions=True):
        maxExcLoc = -1
        maxException = None
        matches = []
        for e in self.exprs:
            try:
                loc2 = e.tryParse(instring, loc)
            except ParseException as err:
                err.__traceback__ = None
                if err.loc > maxExcLoc:
                    maxException = err
                    maxExcLoc = err.loc
            except IndexError:
                if len(instring) > maxExcLoc:
                    maxException = ParseException(instring, len(instring), e.errmsg, self)
                    maxExcLoc = len(instring)
            else:
                # save match among all matches, to retry longest to shortest
                matches.append((loc2, e))

        if matches:
            # re-evaluate all matches in descending order of length of match, in case attached actions
            # might change whether or how much they match of the input.
            matches.sort(key=itemgetter(0), reverse=True)

            if not doActions:
                # no further conditions or parse actions to change the selection of
                # alternative, so the first match will be the best match
                best_expr = matches[0][1]
                return best_expr._parse(instring, loc, doActions)

            longest = -1, None
            for loc1, expr1 in matches:
                if loc1 <= longest[0]:
                    # already have a longer match than this one will deliver, we are done
                    return longest

                try:
                    loc2, toks = expr1._parse(instring, loc, doActions)
                except ParseException as err:
                    err.__traceback__ = None
                    if err.loc > maxExcLoc:
                        maxException = err
                        maxExcLoc = err.loc
                else:
                    if loc2 >= loc1:
                        return loc2, toks
                    # didn't match as much as before
                    elif loc2 > longest[0]:
                        longest = loc2, toks

            if longest != (-1, None):
                return longest

        if maxException is not None:
            maxException.msg = self.errmsg
            raise maxException
        else:
            raise ParseException(instring, loc, "no defined alternatives to match", self)


    def __ixor__(self, other):
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        return self.append(other)  # Or([self, other])

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion(self, parseElementList):
        subRecCheckList = parseElementList[:] + [self]
        for e in self.exprs:
            e.checkRecursion(subRecCheckList)

    def _setResultsName(self, name, listAllMatches=False):
        if (not __compat__.collect_all_And_tokens
                and __diag__.warn_multiple_tokens_in_named_alternation):
            if any(isinstance(e, And) for e in self.exprs):
                warnings.warn("{0}: setting results name {1!r} on {2} expression "
                              "may only return a single token for an And alternative, "
                              "in future will return the full list of tokens".format(
                    "warn_multiple_tokens_in_named_alternation", name, type(self).__name__),
                    stacklevel=3)

        return super(Or, self)._setResultsName(name, listAllMatches)


class MatchFirst(ParseExpression):
    """Requires that at least one :class:`ParseExpression` is found. If
    two expressions match, the first one listed is the one that will
    match. May be constructed using the ``'|'`` operator.

    Example::

        # construct MatchFirst using '|' operator

        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    """
    def __init__(self, exprs, savelist=False):
        super(MatchFirst, self).__init__(exprs, savelist)
        if self.exprs:
            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
        else:
            self.mayReturnEmpty = True

    def streamline(self):
        super(MatchFirst, self).streamline()
        if __compat__.collect_all_And_tokens:
            self.saveAsList = any(e.saveAsList for e in self.exprs)
        return self

    def parseImpl(self, instring, loc, doActions=True):
        maxExcLoc = -1
        maxException = None
        for e in self.exprs:
            try:
                ret = e._parse(instring, loc, doActions)
                return ret
            except ParseException as err:
                if err.loc > maxExcLoc:
                    maxException = err
                    maxExcLoc = err.loc
            except IndexError:
                if len(instring) > maxExcLoc:
                    maxException = ParseException(instring, len(instring), e.errmsg, self)
                    maxExcLoc = len(instring)

        # only got here if no expression matched, raise exception for match that made it the furthest
        else:
            if maxException is not None:
                maxException.msg = self.errmsg
                raise maxException
            else:
                raise ParseException(instring, loc, "no defined alternatives to match", self)

    def __ior__(self, other):
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        return self.append(other)  # MatchFirst([self, other])

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion(self, parseElementList):
        subRecCheckList = parseElementList[:] + [self]
        for e in self.exprs:
            e.checkRecursion(subRecCheckList)

    def _setResultsName(self, name, listAllMatches=False):
        if (not __compat__.collect_all_And_tokens
                and __diag__.warn_multiple_tokens_in_named_alternation):
            if any(isinstance(e, And) for e in self.exprs):
                warnings.warn("{0}: setting results name {1!r} on {2} expression "
                              "may only return a single token for an And alternative, "
                              "in future will return the full list of tokens".format(
                    "warn_multiple_tokens_in_named_alternation", name, type(self).__name__),
                    stacklevel=3)

        return super(MatchFirst, self)._setResultsName(name, listAllMatches)


class Each(ParseExpression):
    """Requires all given :class:`ParseExpression` s to be found, but in
    any order. Expressions may be separated by whitespace.

    May be constructed using the ``'&'`` operator.

    Example::

        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )

    prints::

        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    """
    def __init__(self, exprs, savelist=True):
        super(Each, self).__init__(exprs, savelist)
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        self.skipWhitespace = True
        self.initExprGroups = True
        self.saveAsList = True

    def streamline(self):
        super(Each, self).streamline()
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        return self

    def parseImpl(self, instring, loc, doActions=True):
        if self.initExprGroups:
            self.opt1map = dict((id(e.expr), e) for e in self.exprs if isinstance(e, Optional))
            opt1 = [e.expr for e in self.exprs if isinstance(e, Optional)]
            opt2 = [e for e in self.exprs if e.mayReturnEmpty and not isinstance(e, Optional)]
            self.optionals = opt1 + opt2
            self.multioptionals = [e.expr for e in self.exprs if isinstance(e, ZeroOrMore)]
            self.multirequired = [e.expr for e in self.exprs if isinstance(e, OneOrMore)]
            self.required = [e for e in self.exprs if not isinstance(e, (Optional, ZeroOrMore, OneOrMore))]
            self.required += self.multirequired
            self.initExprGroups = False
        tmpLoc = loc
        tmpReqd = self.required[:]
        tmpOpt  = self.optionals[:]
        matchOrder = []

        keepMatching = True
        while keepMatching:
            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
            failed = []
            for e in tmpExprs:
                try:
                    tmpLoc = e.tryParse(instring, tmpLoc)
                except ParseException:
                    failed.append(e)
                else:
                    matchOrder.append(self.opt1map.get(id(e), e))
                    if e in tmpReqd:
                        tmpReqd.remove(e)
                    elif e in tmpOpt:
                        tmpOpt.remove(e)
            if len(failed) == len(tmpExprs):
                keepMatching = False

        if tmpReqd:
            missing = ", ".join(_ustr(e) for e in tmpReqd)
            raise ParseException(instring, loc, "Missing one or more required elements (%s)" % missing)

        # add any unmatched Optionals, in case they have default values defined
        matchOrder += [e for e in self.exprs if isinstance(e, Optional) and e.expr in tmpOpt]

        resultlist = []
        for e in matchOrder:
            loc, results = e._parse(instring, loc, doActions)
            resultlist.append(results)

        finalResults = sum(resultlist, ParseResults([]))
        return loc, finalResults

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion(self, parseElementList):
        subRecCheckList = parseElementList[:] + [self]
        for e in self.exprs:
            e.checkRecursion(subRecCheckList)


class ParseElementEnhance(ParserElement):
    """Abstract subclass of :class:`ParserElement`, for combining and
    post-processing parsed tokens.
    """
    def __init__(self, expr, savelist=False):
        super(ParseElementEnhance, self).__init__(savelist)
        if isinstance(expr, basestring):
            if issubclass(self._literalStringClass, Token):
                expr = self._literalStringClass(expr)
            else:
                expr = self._literalStringClass(Literal(expr))
        self.expr = expr
        self.strRepr = None
        if expr is not None:
            self.mayIndexError = expr.mayIndexError
            self.mayReturnEmpty = expr.mayReturnEmpty
            self.setWhitespaceChars(expr.whiteChars)
            self.skipWhitespace = expr.skipWhitespace
            self.saveAsList = expr.saveAsList
            self.callPreparse = expr.callPreparse
            self.ignoreExprs.extend(expr.ignoreExprs)

    def parseImpl(self, instring, loc, doActions=True):
        if self.expr is not None:
            return self.expr._parse(instring, loc, doActions, callPreParse=False)
        else:
            raise ParseException("", loc, self.errmsg, self)

    def leaveWhitespace(self):
        self.skipWhitespace = False
        self.expr = self.expr.copy()
        if self.expr is not None:
            self.expr.leaveWhitespace()
        return self

    def ignore(self, other):
        if isinstance(other, Suppress):
            if other not in self.ignoreExprs:
                super(ParseElementEnhance, self).ignore(other)
                if self.expr is not None:
                    self.expr.ignore(self.ignoreExprs[-1])
        else:
            super(ParseElementEnhance, self).ignore(other)
            if self.expr is not None:
                self.expr.ignore(self.ignoreExprs[-1])
        return self

    def streamline(self):
        super(ParseElementEnhance, self).streamline()
        if self.expr is not None:
            self.expr.streamline()
        return self

    def checkRecursion(self, parseElementList):
        if self in parseElementList:
            raise RecursiveGrammarException(parseElementList + [self])
        subRecCheckList = parseElementList[:] + [self]
        if self.expr is not None:
            self.expr.checkRecursion(subRecCheckList)

    def validate(self, validateTrace=None):
        if validateTrace is None:
            validateTrace = []
        tmp = validateTrace[:] + [self]
        if self.expr is not None:
            self.expr.validate(tmp)
        self.checkRecursion([])

    def __str__(self):
        try:
            return super(ParseElementEnhance, self).__str__()
        except Exception:
            pass

        if self.strRepr is None and self.expr is not None:
            self.strRepr = "%s:(%s)" % (self.__class__.__name__, _ustr(self.expr))
        return self.strRepr


class FollowedBy(ParseElementEnhance):
    """Lookahead matching of the given parse expression.
    ``FollowedBy`` does *not* advance the parsing position within
    the input string, it only verifies that the specified parse
    expression matches at the current position.  ``FollowedBy``
    always returns a null token list. If any results names are defined
    in the lookahead expression, those *will* be returned for access by
    name.

    Example::

        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))

        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()

    prints::

        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    """
    def __init__(self, expr):
        super(FollowedBy, self).__init__(expr)
        self.mayReturnEmpty = True

    def parseImpl(self, instring, loc, doActions=True):
        # by using self._expr.parse and deleting the contents of the returned ParseResults list
        # we keep any named results that were defined in the FollowedBy expression
        _, ret = self.expr._parse(instring, loc, doActions=doActions)
        del ret[:]

        return loc, ret


class PrecededBy(ParseElementEnhance):
    """Lookbehind matching of the given parse expression.
    ``PrecededBy`` does not advance the parsing position within the
    input string, it only verifies that the specified parse expression
    matches prior to the current position.  ``PrecededBy`` always
    returns a null token list, but if a results name is defined on the
    given expression, it is returned.

    Parameters:

     - expr - expression that must match prior to the current parse
       location
     - retreat - (default= ``None``) - (int) maximum number of characters
       to lookbehind prior to the current parse location

    If the lookbehind expression is a string, Literal, Keyword, or
    a Word or CharsNotIn with a specified exact or maximum length, then
    the retreat parameter is not required. Otherwise, retreat must be
    specified to give a maximum number of characters to look back from
    the current parse position for a lookbehind match.

    Example::

        # VB-style variable names with type prefixes
        int_var = PrecededBy("#") + pyparsing_common.identifier
        str_var = PrecededBy("$") + pyparsing_common.identifier

    """
    def __init__(self, expr, retreat=None):
        super(PrecededBy, self).__init__(expr)
        self.expr = self.expr().leaveWhitespace()
        self.mayReturnEmpty = True
        self.mayIndexError = False
        self.exact = False
        if isinstance(expr, str):
            retreat = len(expr)
            self.exact = True
        elif isinstance(expr, (Literal, Keyword)):
            retreat = expr.matchLen
            self.exact = True
        elif isinstance(expr, (Word, CharsNotIn)) and expr.maxLen != _MAX_INT:
            retreat = expr.maxLen
            self.exact = True
        elif isinstance(expr, _PositionToken):
            retreat = 0
            self.exact = True
        self.retreat = retreat
        self.errmsg = "not preceded by " + str(expr)
        self.skipWhitespace = False

    def parseImpl(self, instring, loc=0, doActions=True):
        if self.exact:
            if loc < self.retreat:
                raise ParseException(instring, loc, self.errmsg)
            start = loc - self.retreat
            _, ret = self.expr._parse(instring, start)
        else:
            # retreat specified a maximum lookbehind window, iterate
            test_expr = self.expr + StringEnd()
            instring_slice = instring[:loc]
            last_expr = ParseException(instring, loc, self.errmsg)
            for offset in range(1, min(loc, self.retreat + 1)):
                try:
                    _, ret = test_expr._parse(instring_slice, loc - offset)
                except ParseBaseException as pbe:
                    last_expr = pbe
                else:
                    break
            else:
                raise last_expr
        # return empty list of tokens, but preserve any defined results names
        del ret[:]
        return loc, ret


class NotAny(ParseElementEnhance):
    """Lookahead to disallow matching with the given parse expression.
    ``NotAny`` does *not* advance the parsing position within the
    input string, it only verifies that the specified parse expression
    does *not* match at the current position.  Also, ``NotAny`` does
    *not* skip over leading whitespace. ``NotAny`` always returns
    a null token list.  May be constructed using the '~' operator.

    Example::

        AND, OR, NOT = map(CaselessKeyword, "AND OR NOT".split())

        # take care not to mistake keywords for identifiers
        ident = ~(AND | OR | NOT) + Word(alphas)
        boolean_term = Optional(NOT) + ident

        # very crude boolean expression - to support parenthesis groups and
        # operation hierarchy, use infixNotation
        boolean_expr = boolean_term + ZeroOrMore((AND | OR) + boolean_term)

        # integers that are followed by "." are actually floats
        integer = Word(nums) + ~Char(".")
    """
    def __init__(self, expr):
        super(NotAny, self).__init__(expr)
        # ~ self.leaveWhitespace()
        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
        self.mayReturnEmpty = True
        self.errmsg = "Found unwanted token, " + _ustr(self.expr)

    def parseImpl(self, instring, loc, doActions=True):
        if self.expr.canParseNext(instring, loc):
            raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "~{" + _ustr(self.expr) + "}"

        return self.strRepr

class _MultipleMatch(ParseElementEnhance):
    def __init__(self, expr, stopOn=None):
        super(_MultipleMatch, self).__init__(expr)
        self.saveAsList = True
        ender = stopOn
        if isinstance(ender, basestring):
            ender = self._literalStringClass(ender)
        self.stopOn(ender)

    def stopOn(self, ender):
        if isinstance(ender, basestring):
            ender = self._literalStringClass(ender)
        self.not_ender = ~ender if ender is not None else None
        return self

    def parseImpl(self, instring, loc, doActions=True):
        self_expr_parse = self.expr._parse
        self_skip_ignorables = self._skipIgnorables
        check_ender = self.not_ender is not None
        if check_ender:
            try_not_ender = self.not_ender.tryParse

        # must be at least one (but first see if we are the stopOn sentinel;
        # if so, fail)
        if check_ender:
            try_not_ender(instring, loc)
        loc, tokens = self_expr_parse(instring, loc, doActions, callPreParse=False)
        try:
            hasIgnoreExprs = (not not self.ignoreExprs)
            while 1:
                if check_ender:
                    try_not_ender(instring, loc)
                if hasIgnoreExprs:
                    preloc = self_skip_ignorables(instring, loc)
                else:
                    preloc = loc
                loc, tmptokens = self_expr_parse(instring, preloc, doActions)
                if tmptokens or tmptokens.haskeys():
                    tokens += tmptokens
        except (ParseException, IndexError):
            pass

        return loc, tokens

    def _setResultsName(self, name, listAllMatches=False):
        if __diag__.warn_ungrouped_named_tokens_in_collection:
            for e in [self.expr] + getattr(self.expr, 'exprs', []):
                if isinstance(e, ParserElement) and e.resultsName:
                    warnings.warn("{0}: setting results name {1!r} on {2} expression "
                                  "collides with {3!r} on contained expression".format("warn_ungrouped_named_tokens_in_collection",
                                                                                       name,
                                                                                       type(self).__name__,
                                                                                       e.resultsName),
                                  stacklevel=3)

        return super(_MultipleMatch, self)._setResultsName(name, listAllMatches)


class OneOrMore(_MultipleMatch):
    """Repetition of one or more of the given expression.

    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default= ``None``) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition
          expression)

    Example::

        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]

        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    """

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + _ustr(self.expr) + "}..."

        return self.strRepr

class ZeroOrMore(_MultipleMatch):
    """Optional repetition of zero or more of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default= ``None``) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition
          expression)

    Example: similar to :class:`OneOrMore`
    """
    def __init__(self, expr, stopOn=None):
        super(ZeroOrMore, self).__init__(expr, stopOn=stopOn)
        self.mayReturnEmpty = True

    def parseImpl(self, instring, loc, doActions=True):
        try:
            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
        except (ParseException, IndexError):
            return loc, []

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "[" + _ustr(self.expr) + "]..."

        return self.strRepr


class _NullToken(object):
    def __bool__(self):
        return False
    __nonzero__ = __bool__
    def __str__(self):
        return ""

class Optional(ParseElementEnhance):
    """Optional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::

        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345

            # ZIP+4 form
            12101-0001

            # invalid ZIP
            98765-
            ''')

    prints::

        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    """
    __optionalNotMatched = _NullToken()

    def __init__(self, expr, default=__optionalNotMatched):
        super(Optional, self).__init__(expr, savelist=False)
        self.saveAsList = self.expr.saveAsList
        self.defaultValue = default
        self.mayReturnEmpty = True

    def parseImpl(self, instring, loc, doActions=True):
        try:
            loc, tokens = self.expr._parse(instring, loc, doActions, callPreParse=False)
        except (ParseException, IndexError):
            if self.defaultValue is not self.__optionalNotMatched:
                if self.expr.resultsName:
                    tokens = ParseResults([self.defaultValue])
                    tokens[self.expr.resultsName] = self.defaultValue
                else:
                    tokens = [self.defaultValue]
            else:
                tokens = []
        return loc, tokens

    def __str__(self):
        if hasattr(self, "name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "[" + _ustr(self.expr) + "]"

        return self.strRepr

class SkipTo(ParseElementEnhance):
    """Token for skipping over all undefined text until the matched
    expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default= ``False``) if True, the target expression is also parsed
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default= ``None``) used to define grammars (typically quoted strings and
          comments) that might contain false matches to the target expression
     - failOn - (default= ``None``) define expressions that are not allowed to be
          included in the skipped test; if found before the target expression is found,
          the SkipTo is not a match

    Example::

        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP
                      + string_data("sev") + SEP
                      + string_data("desc") + SEP
                      + integer("days_open"))

        for tkt in ticket_expr.searchString(report):
            print tkt.dump()

    prints::

        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    """
    def __init__(self, other, include=False, ignore=None, failOn=None):
        super(SkipTo, self).__init__(other)
        self.ignoreExpr = ignore
        self.mayReturnEmpty = True
        self.mayIndexError = False
        self.includeMatch = include
        self.saveAsList = False
        if isinstance(failOn, basestring):
            self.failOn = self._literalStringClass(failOn)
        else:
            self.failOn = failOn
        self.errmsg = "No match found for " + _ustr(self.expr)

    def parseImpl(self, instring, loc, doActions=True):
        startloc = loc
        instrlen = len(instring)
        expr = self.expr
        expr_parse = self.expr._parse
        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None

        tmploc = loc
        while tmploc <= instrlen:
            if self_failOn_canParseNext is not None:
                # break if failOn expression matches
                if self_failOn_canParseNext(instring, tmploc):
                    break

            if self_ignoreExpr_tryParse is not None:
                # advance past ignore expressions
                while 1:
                    try:
                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
                    except ParseBaseException:
                        break

            try:
                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
            except (ParseException, IndexError):
                # no match, advance loc in string
                tmploc += 1
            else:
                # matched skipto expr, done
                break

        else:
            # ran off the end of the input string without matching skipto expr, fail
            raise ParseException(instring, loc, self.errmsg, self)

        # build up return values
        loc = tmploc
        skiptext = instring[startloc:loc]
        skipresult = ParseResults(skiptext)

        if self.includeMatch:
            loc, mat = expr_parse(instring, loc, doActions, callPreParse=False)
            skipresult += mat

        return loc, skipresult

class Forward(ParseElementEnhance):
    """Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the ``Forward``
    variable using the '<<' operator.

    Note: take care when assigning to ``Forward`` not to overlook
    precedence of operators.

    Specifically, '|' has a lower precedence than '<<', so that::

        fwdExpr << a | b | c

    will actually be evaluated as::

        (fwdExpr << a) | b | c

    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the ``Forward``::

        fwdExpr << (a | b | c)

    Converting to use the '<<=' operator instead will avoid this problem.

    See :class:`ParseResults.pprint` for an example of a recursive
    parser created using ``Forward``.
    """
    def __init__(self, other=None):
        super(Forward, self).__init__(other, savelist=False)

    def __lshift__(self, other):
        if isinstance(other, basestring):
            other = self._literalStringClass(other)
        self.expr = other
        self.strRepr = None
        self.mayIndexError = self.expr.mayIndexError
        self.mayReturnEmpty = self.expr.mayReturnEmpty
        self.setWhitespaceChars(self.expr.whiteChars)
        self.skipWhitespace = self.expr.skipWhitespace
        self.saveAsList = self.expr.saveAsList
        self.ignoreExprs.extend(self.expr.ignoreExprs)
        return self

    def __ilshift__(self, other):
        return self << other

    def leaveWhitespace(self):
        self.skipWhitespace = False
        return self

    def streamline(self):
        if not self.streamlined:
            self.streamlined = True
            if self.expr is not None:
                self.expr.streamline()
        return self

    def validate(self, validateTrace=None):
        if validateTrace is None:
            validateTrace = []

        if self not in validateTrace:
            tmp = validateTrace[:] + [self]
            if self.expr is not None:
                self.expr.validate(tmp)
        self.checkRecursion([])

    def __str__(self):
        if hasattr(self, "name"):
            return self.name
        if self.strRepr is not None:
            return self.strRepr

        # Avoid infinite recursion by setting a temporary strRepr
        self.strRepr = ": ..."

        # Use the string representation of main expression.
        retString = '...'
        try:
            if self.expr is not None:
                retString = _ustr(self.expr)[:1000]
            else:
                retString = "None"
        finally:
            self.strRepr = self.__class__.__name__ + ": " + retString
        return self.strRepr

    def copy(self):
        if self.expr is not None:
            return super(Forward, self).copy()
        else:
            ret = Forward()
            ret <<= self
            return ret

    def _setResultsName(self, name, listAllMatches=False):
        if __diag__.warn_name_set_on_empty_Forward:
            if self.expr is None:
                warnings.warn("{0}: setting results name {0!r} on {1} expression "
                              "that has no contained expression".format("warn_name_set_on_empty_Forward",
                                                                        name,
                                                                        type(self).__name__),
                              stacklevel=3)

        return super(Forward, self)._setResultsName(name, listAllMatches)

class TokenConverter(ParseElementEnhance):
    """
    Abstract subclass of :class:`ParseExpression`, for converting parsed results.
    """
    def __init__(self, expr, savelist=False):
        super(TokenConverter, self).__init__(expr)  # , savelist)
        self.saveAsList = False

class Combine(TokenConverter):
    """Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the
    input string; this can be disabled by specifying
    ``'adjacent=False'`` in the constructor.

    Example::

        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    """
    def __init__(self, expr, joinString="", adjacent=True):
        super(Combine, self).__init__(expr)
        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
        if adjacent:
            self.leaveWhitespace()
        self.adjacent = adjacent
        self.skipWhitespace = True
        self.joinString = joinString
        self.callPreparse = True

    def ignore(self, other):
        if self.adjacent:
            ParserElement.ignore(self, other)
        else:
            super(Combine, self).ignore(other)
        return self

    def postParse(self, instring, loc, tokenlist):
        retToks = tokenlist.copy()
        del retToks[:]
        retToks += ParseResults(["".join(tokenlist._asStringList(self.joinString))], modal=self.modalResults)

        if self.resultsName and retToks.haskeys():
            return [retToks]
        else:
            return retToks

class Group(TokenConverter):
    """Converter to return the matched tokens as a list - useful for
    returning tokens of :class:`ZeroOrMore` and :class:`OneOrMore` expressions.

    Example::

        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a, b, 100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a, b, 100"))  # -> ['fn', ['a', 'b', '100']]
    """
    def __init__(self, expr):
        super(Group, self).__init__(expr)
        self.saveAsList = True

    def postParse(self, instring, loc, tokenlist):
        return [tokenlist]

class Dict(TokenConverter):
    """Converter to return a repetitive expression as a list, but also
    as a dictionary. Each element can also be referenced using the first
    token in the expression as its key. Useful for tabular report
    scraping when the first column can be used as a item key.

    Example::

        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))

        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())

        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())

        # access named fields as dict entries, or output as dict
        print(result['shape'])
        print(result.asDict())

    prints::

        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}

    See more examples at :class:`ParseResults` of accessing fields by results name.
    """
    def __init__(self, expr):
        super(Dict, self).__init__(expr)
        self.saveAsList = True

    def postParse(self, instring, loc, tokenlist):
        for i, tok in enumerate(tokenlist):
            if len(tok) == 0:
                continue
            ikey = tok[0]
            if isinstance(ikey, int):
                ikey = _ustr(tok[0]).strip()
            if len(tok) == 1:
                tokenlist[ikey] = _ParseResultsWithOffset("", i)
            elif len(tok) == 2 and not isinstance(tok[1], ParseResults):
                tokenlist[ikey] = _ParseResultsWithOffset(tok[1], i)
            else:
                dictvalue = tok.copy()  # ParseResults(i)
                del dictvalue[0]
                if len(dictvalue) != 1 or (isinstance(dictvalue, ParseResults) and dictvalue.haskeys()):
                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue, i)
                else:
                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0], i)

        if self.resultsName:
            return [tokenlist]
        else:
            return tokenlist


class Suppress(TokenConverter):
    """Converter for ignoring the results of a parsed expression.

    Example::

        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))

    prints::

        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']

    (See also :class:`delimitedList`.)
    """
    def postParse(self, instring, loc, tokenlist):
        return []

    def suppress(self):
        return self


class OnlyOnce(object):
    """Wrapper for parse actions, to ensure they are only called once.
    """
    def __init__(self, methodCall):
        self.callable = _trim_arity(methodCall)
        self.called = False
    def __call__(self, s, l, t):
        if not self.called:
            results = self.callable(s, l, t)
            self.called = True
            return results
        raise ParseException(s, l, "")
    def reset(self):
        self.called = False

def traceParseAction(f):
    """Decorator for debugging parse actions.

    When the parse action is called, this decorator will print
    ``">> entering method-name(line:<current_source_line>, <parse_location>, <matched_tokens>)"``.
    When the parse action completes, the decorator will print
    ``"<<"`` followed by the returned value, or any exception that the parse action raised.

    Example::

        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))

    prints::

        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    """
    f = _trim_arity(f)
    def z(*paArgs):
        thisFunc = f.__name__
        s, l, t = paArgs[-3:]
        if len(paArgs) > 3:
            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
        sys.stderr.write(">>entering %s(line: '%s', %d, %r)\n" % (thisFunc, line(l, s), l, t))
        try:
            ret = f(*paArgs)
        except Exception as exc:
            sys.stderr.write("<<leaving %s (exception: %s)\n" % (thisFunc, exc))
            raise
        sys.stderr.write("<<leaving %s (ret: %r)\n" % (thisFunc, ret))
        return ret
    try:
        z.__name__ = f.__name__
    except AttributeError:
        pass
    return z

#
# global helpers
#
def delimitedList(expr, delim=",", combine=False):
    """Helper to define a delimited list of expressions - the delimiter
    defaults to ','. By default, the list elements and delimiters can
    have intervening whitespace, and comments, but this can be
    overridden by passing ``combine=True`` in the constructor. If
    ``combine`` is set to ``True``, the matching tokens are
    returned as a single token string, with the delimiters included;
    otherwise, the matching tokens are returned as a list of tokens,
    with the delimiters suppressed.

    Example::

        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    """
    dlName = _ustr(expr) + " [" + _ustr(delim) + " " + _ustr(expr) + "]..."
    if combine:
        return Combine(expr + ZeroOrMore(delim + expr)).setName(dlName)
    else:
        return (expr + ZeroOrMore(Suppress(delim) + expr)).setName(dlName)

def countedArray(expr, intExpr=None):
    """Helper to define a counted list of expressions.

    This helper defines a pattern of the form::

        integer expr expr expr...

    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the
    leading count token is suppressed.

    If ``intExpr`` is specified, it should be a pyparsing expression
    that produces an integer value.

    Example::

        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    """
    arrayExpr = Forward()
    def countFieldParseAction(s, l, t):
        n = t[0]
        arrayExpr << (n and Group(And([expr] * n)) or Group(empty))
        return []
    if intExpr is None:
        intExpr = Word(nums).setParseAction(lambda t: int(t[0]))
    else:
        intExpr = intExpr.copy()
    intExpr.setName("arrayLen")
    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
    return (intExpr + arrayExpr).setName('(len) ' + _ustr(expr) + '...')

def _flatten(L):
    ret = []
    for i in L:
        if isinstance(i, list):
            ret.extend(_flatten(i))
        else:
            ret.append(i)
    return ret

def matchPreviousLiteral(expr):
    """Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks for
    a 'repeat' of a previous expression.  For example::

        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second

    will match ``"1:1"``, but not ``"1:2"``.  Because this
    matches a previous literal, will also match the leading
    ``"1:1"`` in ``"1:10"``. If this is not desired, use
    :class:`matchPreviousExpr`. Do *not* use with packrat parsing
    enabled.
    """
    rep = Forward()
    def copyTokenToRepeater(s, l, t):
        if t:
            if len(t) == 1:
                rep << t[0]
            else:
                # flatten t tokens
                tflat = _flatten(t.asList())
                rep << And(Literal(tt) for tt in tflat)
        else:
            rep << Empty()
    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
    rep.setName('(prev) ' + _ustr(expr))
    return rep

def matchPreviousExpr(expr):
    """Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks for
    a 'repeat' of a previous expression.  For example::

        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second

    will match ``"1:1"``, but not ``"1:2"``.  Because this
    matches by expressions, will *not* match the leading ``"1:1"``
    in ``"1:10"``; the expressions are evaluated first, and then
    compared, so ``"1"`` is compared with ``"10"``. Do *not* use
    with packrat parsing enabled.
    """
    rep = Forward()
    e2 = expr.copy()
    rep <<= e2
    def copyTokenToRepeater(s, l, t):
        matchTokens = _flatten(t.asList())
        def mustMatchTheseTokens(s, l, t):
            theseTokens = _flatten(t.asList())
            if theseTokens != matchTokens:
                raise ParseException('', 0, '')
        rep.setParseAction(mustMatchTheseTokens, callDuringTry=True)
    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
    rep.setName('(prev) ' + _ustr(expr))
    return rep

def _escapeRegexRangeChars(s):
    # ~  escape these chars: ^-]
    for c in r"\^-]":
        s = s.replace(c, _bslash + c)
    s = s.replace("\n", r"\n")
    s = s.replace("\t", r"\t")
    return _ustr(s)

def oneOf(strs, caseless=False, useRegex=True, asKeyword=False):
    """Helper to quickly define a set of alternative Literals, and makes
    sure to do longest-first testing when there is a conflict,
    regardless of the input order, but returns
    a :class:`MatchFirst` for best performance.

    Parameters:

     - strs - a string of space-delimited literals, or a collection of
       string literals
     - caseless - (default= ``False``) - treat all literals as
       caseless
     - useRegex - (default= ``True``) - as an optimization, will
       generate a Regex object; otherwise, will generate
       a :class:`MatchFirst` object (if ``caseless=True`` or ``asKeyword=True``, or if
       creating a :class:`Regex` raises an exception)
     - asKeyword - (default=``False``) - enforce Keyword-style matching on the
       generated expressions

    Example::

        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))

    prints::

        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    """
    if isinstance(caseless, basestring):
        warnings.warn("More than one string argument passed to oneOf, pass "
                      "choices as a list or space-delimited string", stacklevel=2)

    if caseless:
        isequal = (lambda a, b: a.upper() == b.upper())
        masks = (lambda a, b: b.upper().startswith(a.upper()))
        parseElementClass = CaselessKeyword if asKeyword else CaselessLiteral
    else:
        isequal = (lambda a, b: a == b)
        masks = (lambda a, b: b.startswith(a))
        parseElementClass = Keyword if asKeyword else Literal

    symbols = []
    if isinstance(strs, basestring):
        symbols = strs.split()
    elif isinstance(strs, Iterable):
        symbols = list(strs)
    else:
        warnings.warn("Invalid argument to oneOf, expected string or iterable",
                      SyntaxWarning, stacklevel=2)
    if not symbols:
        return NoMatch()

    if not asKeyword:
        # if not producing keywords, need to reorder to take care to avoid masking
        # longer choices with shorter ones
        i = 0
        while i < len(symbols) - 1:
            cur = symbols[i]
            for j, other in enumerate(symbols[i + 1:]):
                if isequal(other, cur):
                    del symbols[i + j + 1]
                    break
                elif masks(cur, other):
                    del symbols[i + j + 1]
                    symbols.insert(i, other)
                    break
            else:
                i += 1

    if not (caseless or asKeyword) and useRegex:
        # ~ print (strs, "->", "|".join([_escapeRegexChars(sym) for sym in symbols]))
        try:
            if len(symbols) == len("".join(symbols)):
                return Regex("[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols)).setName(' | '.join(symbols))
            else:
                return Regex("|".join(re.escape(sym) for sym in symbols)).setName(' | '.join(symbols))
        except Exception:
            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
                    SyntaxWarning, stacklevel=2)

    # last resort, just use MatchFirst
    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))

def dictOf(key, value):
    """Helper to easily and clearly define a dictionary by specifying
    the respective patterns for the key and value.  Takes care of
    defining the :class:`Dict`, :class:`ZeroOrMore`, and
    :class:`Group` tokens in the proper order.  The key pattern
    can include delimiting markers or punctuation, as long as they are
    suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the :class:`Dict` results
    can include named token fields.

    Example::

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())

        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())

    prints::

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    """
    return Dict(OneOrMore(Group(key + value)))

def originalTextFor(expr, asString=True):
    """Helper to return the original, untokenized text for a given
    expression.  Useful to restore the parsed fields of an HTML start
    tag into the raw tag text itself, or to revert separate tokens with
    intervening whitespace back to the original matching input text. By
    default, returns astring containing the original parsed text.

    If the optional ``asString`` argument is passed as
    ``False``, then the return value is
    a :class:`ParseResults` containing any results names that
    were originally matched, and a single token containing the original
    matched text from the input string.  So if the expression passed to
    :class:`originalTextFor` contains expressions with defined
    results names, you must set ``asString`` to ``False`` if you
    want to preserve those results name values.

    Example::

        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b", "i"):
            opener, closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])

    prints::

        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    """
    locMarker = Empty().setParseAction(lambda s, loc, t: loc)
    endlocMarker = locMarker.copy()
    endlocMarker.callPreparse = False
    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
    if asString:
        extractText = lambda s, l, t: s[t._original_start: t._original_end]
    else:
        def extractText(s, l, t):
            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
    matchExpr.setParseAction(extractText)
    matchExpr.ignoreExprs = expr.ignoreExprs
    return matchExpr

def ungroup(expr):
    """Helper to undo pyparsing's default grouping of And expressions,
    even if all but one are non-empty.
    """
    return TokenConverter(expr).addParseAction(lambda t: t[0])

def locatedExpr(expr):
    """Helper to decorate a returned token with its starting and ending
    locations in the input string.

    This helper adds the following results names:

     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains ``<TAB>`` characters, you
    may want to call :class:`ParserElement.parseWithTabs`

    Example::

        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)

    prints::

        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    """
    locator = Empty().setParseAction(lambda s, l, t: l)
    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))


# convenience constants for positional expressions
empty       = Empty().setName("empty")
lineStart   = LineStart().setName("lineStart")
lineEnd     = LineEnd().setName("lineEnd")
stringStart = StringStart().setName("stringStart")
stringEnd   = StringEnd().setName("stringEnd")

_escapedPunc = Word(_bslash, r"\[]-*.$+^?()~ ", exact=2).setParseAction(lambda s, l, t: t[0][1])
_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s, l, t: unichr(int(t[0].lstrip(r'\0x'), 16)))
_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s, l, t: unichr(int(t[0][1:], 8)))
_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
_charRange = Group(_singleChar + Suppress("-") + _singleChar)
_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group(OneOrMore(_charRange | _singleChar)).setResultsName("body") + "]"

def srange(s):
    r"""Helper to easily define string ranges for use in Word
    construction. Borrows syntax from regexp '[]' string range
    definitions::

        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"

    The input string must be enclosed in []'s, and the returned string
    is the expanded character set joined into a single string. The
    values enclosed in the []'s may be:

     - a single character
     - an escaped character with a leading backslash (such as ``\-``
       or ``\]``)
     - an escaped hex character with a leading ``'\x'``
       (``\x21``, which is a ``'!'`` character) (``\0x##``
       is also supported for backwards compatibility)
     - an escaped octal character with a leading ``'\0'``
       (``\041``, which is a ``'!'`` character)
     - a range of any of the above, separated by a dash (``'a-z'``,
       etc.)
     - any combination of the above (``'aeiouy'``,
       ``'a-zA-Z0-9_$'``, etc.)
    """
    _expanded = lambda p: p if not isinstance(p, ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]), ord(p[1]) + 1))
    try:
        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
    except Exception:
        return ""

def matchOnlyAtCol(n):
    """Helper method for defining parse actions that require matching at
    a specific column in the input text.
    """
    def verifyCol(strg, locn, toks):
        if col(locn, strg) != n:
            raise ParseException(strg, locn, "matched token not at column %d" % n)
    return verifyCol

def replaceWith(replStr):
    """Helper method for common parse actions that simply return
    a literal value.  Especially useful when used with
    :class:`transformString<ParserElement.transformString>` ().

    Example::

        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num

        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    """
    return lambda s, l, t: [replStr]

def removeQuotes(s, l, t):
    """Helper parse action for removing quotation marks from parsed
    quoted strings.

    Example::

        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    """
    return t[0][1:-1]

def tokenMap(func, *args):
    """Helper to define a parse action by mapping a function to all
    elements of a ParseResults list. If any additional args are passed,
    they are forwarded to the given function as additional arguments
    after the token, as in
    ``hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))``,
    which will convert the parsed data to an integer using base 16.

    Example (compare the last to example in :class:`ParserElement.transformString`::

        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')

        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')

    prints::

        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    """
    def pa(s, l, t):
        return [func(tokn, *args) for tokn in t]

    try:
        func_name = getattr(func, '__name__',
                            getattr(func, '__class__').__name__)
    except Exception:
        func_name = str(func)
    pa.__name__ = func_name

    return pa

upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
"""(Deprecated) Helper parse action to convert tokens to upper case.
Deprecated in favor of :class:`pyparsing_common.upcaseTokens`"""

downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
"""(Deprecated) Helper parse action to convert tokens to lower case.
Deprecated in favor of :class:`pyparsing_common.downcaseTokens`"""

def _makeTags(tagStr, xml,
              suppress_LT=Suppress("<"),
              suppress_GT=Suppress(">")):
    """Internal helper to construct opening and closing tag expressions, given a tag name"""
    if isinstance(tagStr, basestring):
        resname = tagStr
        tagStr = Keyword(tagStr, caseless=not xml)
    else:
        resname = tagStr.name

    tagAttrName = Word(alphas, alphanums + "_-:")
    if xml:
        tagAttrValue = dblQuotedString.copy().setParseAction(removeQuotes)
        openTag = (suppress_LT
                   + tagStr("tag")
                   + Dict(ZeroOrMore(Group(tagAttrName + Suppress("=") + tagAttrValue)))
                   + Optional("/", default=[False])("empty").setParseAction(lambda s, l, t: t[0] == '/')
                   + suppress_GT)
    else:
        tagAttrValue = quotedString.copy().setParseAction(removeQuotes) | Word(printables, excludeChars=">")
        openTag = (suppress_LT
                   + tagStr("tag")
                   + Dict(ZeroOrMore(Group(tagAttrName.setParseAction(downcaseTokens)
                                           + Optional(Suppress("=") + tagAttrValue))))
                   + Optional("/", default=[False])("empty").setParseAction(lambda s, l, t: t[0] == '/')
                   + suppress_GT)
    closeTag = Combine(_L("</") + tagStr + ">", adjacent=False)

    openTag.setName("<%s>" % resname)
    # add start<tagname> results name in parse action now that ungrouped names are not reported at two levels
    openTag.addParseAction(lambda t: t.__setitem__("start" + "".join(resname.replace(":", " ").title().split()), t.copy()))
    closeTag = closeTag("end" + "".join(resname.replace(":", " ").title().split())).setName("</%s>" % resname)
    openTag.tag = resname
    closeTag.tag = resname
    openTag.tag_body = SkipTo(closeTag())
    return openTag, closeTag

def makeHTMLTags(tagStr):
    """Helper to construct opening and closing tag expressions for HTML,
    given a tag name. Matches tags in either upper or lower case,
    attributes with namespaces and with quoted or unquoted values.

    Example::

        text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and
        # closing tags as a 2-tuple
        a, a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end

        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are
            # also accessible as named results
            print(link.link_text, '->', link.href)

    prints::

        pyparsing -> https://github.com/pyparsing/pyparsing/wiki
    """
    return _makeTags(tagStr, False)

def makeXMLTags(tagStr):
    """Helper to construct opening and closing tag expressions for XML,
    given a tag name. Matches tags only in the given upper/lower case.

    Example: similar to :class:`makeHTMLTags`
    """
    return _makeTags(tagStr, True)

def withAttribute(*args, **attrDict):
    """Helper to create a validating parse action to be used with start
    tags created with :class:`makeXMLTags` or
    :class:`makeHTMLTags`. Use ``withAttribute`` to qualify
    a starting tag with a required attribute value, to avoid false
    matches on common tags such as ``<TD>`` or ``<DIV>``.

    Call ``withAttribute`` with a series of attribute names and
    values. Specify the list of filter attributes names and values as:

     - keyword arguments, as in ``(align="right")``, or
     - as an explicit dict with ``**`` operator, when an attribute
       name is also a Python reserved word, as in ``**{"class":"Customer", "align":"right"}``
     - a list of name-value tuples, as in ``(("ns1:class", "Customer"), ("ns2:align", "right"))``

    For attribute names with a namespace prefix, you must use the second
    form.  Attribute names are matched insensitive to upper/lower case.

    If just testing for ``class`` (with or without a namespace), use
    :class:`withClass`.

    To verify that the attribute exists, but without specifying a value,
    pass ``withAttribute.ANY_VALUE`` as the value.

    Example::

        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>

        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)

        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)

    prints::

        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    """
    if args:
        attrs = args[:]
    else:
        attrs = attrDict.items()
    attrs = [(k, v) for k, v in attrs]
    def pa(s, l, tokens):
        for attrName, attrValue in attrs:
            if attrName not in tokens:
                raise ParseException(s, l, "no matching attribute " + attrName)
            if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue:
                raise ParseException(s, l, "attribute '%s' has value '%s', must be '%s'" %
                                            (attrName, tokens[attrName], attrValue))
    return pa
withAttribute.ANY_VALUE = object()

def withClass(classname, namespace=''):
    """Simplified version of :class:`withAttribute` when
    matching on a div class - made difficult because ``class`` is
    a reserved word in Python.

    Example::

        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>

        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))

        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)

        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)

    prints::

        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    """
    classattr = "%s:class" % namespace if namespace else "class"
    return withAttribute(**{classattr: classname})

opAssoc = SimpleNamespace()
opAssoc.LEFT = object()
opAssoc.RIGHT = object()

def infixNotation(baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')')):
    """Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary
    or binary, left- or right-associative.  Parse actions can also be
    attached to operator expressions. The generated parser will also
    recognize the use of parentheses to override operator precedences
    (see example below).

    Note: if you define a deep operator list, you may see performance
    issues when using infixNotation. See
    :class:`ParserElement.enablePackrat` for a mechanism to potentially
    improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the
       nested
     - opList - list of tuples, one for each operator precedence level
       in the expression grammar; each tuple is of the form ``(opExpr,
       numTerms, rightLeftAssoc, parseAction)``, where:

       - opExpr is the pyparsing expression for the operator; may also
         be a string, which will be converted to a Literal; if numTerms
         is 3, opExpr is a tuple of two expressions, for the two
         operators separating the 3 terms
       - numTerms is the number of terms for this operator (must be 1,
         2, or 3)
       - rightLeftAssoc is the indicator whether the operator is right
         or left associative, using the pyparsing-defined constants
         ``opAssoc.RIGHT`` and ``opAssoc.LEFT``.
       - parseAction is the parse action to be associated with
         expressions matching this operator expression (the parse action
         tuple member may be omitted); if the parse action is passed
         a tuple or list of functions, this is equivalent to calling
         ``setParseAction(*fn)``
         (:class:`ParserElement.setParseAction`)
     - lpar - expression for matching left-parentheses
       (default= ``Suppress('(')``)
     - rpar - expression for matching right-parentheses
       (default= ``Suppress(')')``)

    Example::

        # simple example of four-function arithmetic with ints and
        # variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier

        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])

        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)

    prints::

        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    """
    # captive version of FollowedBy that does not do parse actions or capture results names
    class _FB(FollowedBy):
        def parseImpl(self, instring, loc, doActions=True):
            self.expr.tryParse(instring, loc)
            return loc, []

    ret = Forward()
    lastExpr = baseExpr | (lpar + ret + rpar)
    for i, operDef in enumerate(opList):
        opExpr, arity, rightLeftAssoc, pa = (operDef + (None, ))[:4]
        termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr
        if arity == 3:
            if opExpr is None or len(opExpr) != 2:
                raise ValueError(
                    "if numterms=3, opExpr must be a tuple or list of two expressions")
            opExpr1, opExpr2 = opExpr
        thisExpr = Forward().setName(termName)
        if rightLeftAssoc == opAssoc.LEFT:
            if arity == 1:
                matchExpr = _FB(lastExpr + opExpr) + Group(lastExpr + OneOrMore(opExpr))
            elif arity == 2:
                if opExpr is not None:
                    matchExpr = _FB(lastExpr + opExpr + lastExpr) + Group(lastExpr + OneOrMore(opExpr + lastExpr))
                else:
                    matchExpr = _FB(lastExpr + lastExpr) + Group(lastExpr + OneOrMore(lastExpr))
            elif arity == 3:
                matchExpr = (_FB(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr)
                             + Group(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr))
            else:
                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
        elif rightLeftAssoc == opAssoc.RIGHT:
            if arity == 1:
                # try to avoid LR with this extra test
                if not isinstance(opExpr, Optional):
                    opExpr = Optional(opExpr)
                matchExpr = _FB(opExpr.expr + thisExpr) + Group(opExpr + thisExpr)
            elif arity == 2:
                if opExpr is not None:
                    matchExpr = _FB(lastExpr + opExpr + thisExpr) + Group(lastExpr + OneOrMore(opExpr + thisExpr))
                else:
                    matchExpr = _FB(lastExpr + thisExpr) + Group(lastExpr + OneOrMore(thisExpr))
            elif arity == 3:
                matchExpr = (_FB(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr)
                             + Group(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr))
            else:
                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
        else:
            raise ValueError("operator must indicate right or left associativity")
        if pa:
            if isinstance(pa, (tuple, list)):
                matchExpr.setParseAction(*pa)
            else:
                matchExpr.setParseAction(pa)
        thisExpr <<= (matchExpr.setName(termName) | lastExpr)
        lastExpr = thisExpr
    ret <<= lastExpr
    return ret

operatorPrecedence = infixNotation
"""(Deprecated) Former name of :class:`infixNotation`, will be
dropped in a future release."""

dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*') + '"').setName("string enclosed in double quotes")
sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*") + "'").setName("string enclosed in single quotes")
quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*') + '"'
                       | Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*") + "'").setName("quotedString using single or double quotes")
unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal")

def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()):
    """Helper method for defining nested lists enclosed in opening and
    closing delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list
       (default= ``"("``); can also be a pyparsing expression
     - closer - closing character for a nested list
       (default= ``")"``); can also be a pyparsing expression
     - content - expression for items within the nested lists
       (default= ``None``)
     - ignoreExpr - expression for ignoring opening and closing
       delimiters (default= :class:`quotedString`)

    If an expression is not provided for the content argument, the
    nested expression will capture all whitespace-delimited content
    between delimiters as a list of separate values.

    Use the ``ignoreExpr`` argument to define expressions that may
    contain opening or closing characters that should not be treated as
    opening or closing characters for nesting, such as quotedString or
    a comment expression.  Specify multiple expressions using an
    :class:`Or` or :class:`MatchFirst`. The default is
    :class:`quotedString`, but if no expressions are to be ignored, then
    pass ``None`` for this argument.

    Example::

        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR, RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type")
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR
                      + code_body("body"))
        c_function.ignore(cStyleComment)

        source_code = '''
            int is_odd(int x) {
                return (x%2);
            }

            int dec_to_hex(char hchar) {
                if (hchar >= '0' && hchar <= '9') {
                    return (ord(hchar)-ord('0'));
                } else {
                    return (10+ord(hchar)-ord('A'));
                }
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)


    prints::

        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    """
    if opener == closer:
        raise ValueError("opening and closing strings cannot be the same")
    if content is None:
        if isinstance(opener, basestring) and isinstance(closer, basestring):
            if len(opener) == 1 and len(closer) == 1:
                if ignoreExpr is not None:
                    content = (Combine(OneOrMore(~ignoreExpr
                                                 + CharsNotIn(opener
                                                              + closer
                                                              + ParserElement.DEFAULT_WHITE_CHARS, exact=1)
                                                 )
                                       ).setParseAction(lambda t: t[0].strip()))
                else:
                    content = (empty.copy() + CharsNotIn(opener
                                                         + closer
                                                         + ParserElement.DEFAULT_WHITE_CHARS
                                                         ).setParseAction(lambda t: t[0].strip()))
            else:
                if ignoreExpr is not None:
                    content = (Combine(OneOrMore(~ignoreExpr
                                                 + ~Literal(opener)
                                                 + ~Literal(closer)
                                                 + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS, exact=1))
                                       ).setParseAction(lambda t: t[0].strip()))
                else:
                    content = (Combine(OneOrMore(~Literal(opener)
                                                 + ~Literal(closer)
                                                 + CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS, exact=1))
                                       ).setParseAction(lambda t: t[0].strip()))
        else:
            raise ValueError("opening and closing arguments must be strings if no content expression is given")
    ret = Forward()
    if ignoreExpr is not None:
        ret <<= Group(Suppress(opener) + ZeroOrMore(ignoreExpr | ret | content) + Suppress(closer))
    else:
        ret <<= Group(Suppress(opener) + ZeroOrMore(ret | content)  + Suppress(closer))
    ret.setName('nested %s%s expression' % (opener, closer))
    return ret

def indentedBlock(blockStatementExpr, indentStack, indent=True):
    """Helper method for defining space-delimited indentation blocks,
    such as those used to define block statements in Python source code.

    Parameters:

     - blockStatementExpr - expression defining syntax of statement that
       is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
       (multiple statementWithIndentedBlock expressions within a single
       grammar should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond
       the current level; set to False for block of left-most
       statements (default= ``True``)

    A valid block must contain at least one ``blockStatement``.

    Example::

        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group("(" + Optional(delimitedList(identifier)) + ")") + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group(funcDecl + func_body)

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << (funcDef | assignment | identifier)

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()

    prints::

        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]]
    """
    backup_stack = indentStack[:]

    def reset_stack():
        indentStack[:] = backup_stack

    def checkPeerIndent(s, l, t):
        if l >= len(s): return
        curCol = col(l, s)
        if curCol != indentStack[-1]:
            if curCol > indentStack[-1]:
                raise ParseException(s, l, "illegal nesting")
            raise ParseException(s, l, "not a peer entry")

    def checkSubIndent(s, l, t):
        curCol = col(l, s)
        if curCol > indentStack[-1]:
            indentStack.append(curCol)
        else:
            raise ParseException(s, l, "not a subentry")

    def checkUnindent(s, l, t):
        if l >= len(s): return
        curCol = col(l, s)
        if not(indentStack and curCol in indentStack):
            raise ParseException(s, l, "not an unindent")
        if curCol < indentStack[-1]:
            indentStack.pop()

    NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress())
    INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT')
    PEER   = Empty().setParseAction(checkPeerIndent).setName('')
    UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT')
    if indent:
        smExpr = Group(Optional(NL)
                       + INDENT
                       + OneOrMore(PEER + Group(blockStatementExpr) + Optional(NL))
                       + UNDENT)
    else:
        smExpr = Group(Optional(NL)
                       + OneOrMore(PEER + Group(blockStatementExpr) + Optional(NL))
                       + UNDENT)
    smExpr.setFailAction(lambda a, b, c, d: reset_stack())
    blockStatementExpr.ignore(_bslash + LineEnd())
    return smExpr.setName('indented block')

alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]")
punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")

anyOpenTag, anyCloseTag = makeHTMLTags(Word(alphas, alphanums + "_:").setName('any tag'))
_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(), '><& "\''))
commonHTMLEntity = Regex('&(?P<entity>' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity")
def replaceHTMLEntity(t):
    """Helper parser action to replace common HTML entities with their special characters"""
    return _htmlEntityMap.get(t.entity)

# it's easy to get these comment structures wrong - they're very common, so may as well make them available
cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment")
"Comment of the form ``/* ... */``"

htmlComment = Regex(r"<!--[\s\S]*?-->").setName("HTML comment")
"Comment of the form ``<!-- ... -->``"

restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line")
dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment")
"Comment of the form ``// ... (to end of line)``"

cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/' | dblSlashComment).setName("C++ style comment")
"Comment of either form :class:`cStyleComment` or :class:`dblSlashComment`"

javaStyleComment = cppStyleComment
"Same as :class:`cppStyleComment`"

pythonStyleComment = Regex(r"#.*").setName("Python style comment")
"Comment of the form ``# ... (to end of line)``"

_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',')
                                  + Optional(Word(" \t")
                                             + ~Literal(",") + ~LineEnd()))).streamline().setName("commaItem")
commaSeparatedList = delimitedList(Optional(quotedString.copy() | _commasepitem, default="")).setName("commaSeparatedList")
"""(Deprecated) Predefined expression of 1 or more printable words or
quoted strings, separated by commas.

This expression is deprecated in favor of :class:`pyparsing_common.comma_separated_list`.
"""

# some other useful expressions - using lower-case class name since we are really using this as a namespace
class pyparsing_common:
    """Here are some common low-level expressions that may be useful in
    jump-starting parser development:

     - numeric forms (:class:`integers<integer>`, :class:`reals<real>`,
       :class:`scientific notation<sci_real>`)
     - common :class:`programming identifiers<identifier>`
     - network addresses (:class:`MAC<mac_address>`,
       :class:`IPv4<ipv4_address>`, :class:`IPv6<ipv6_address>`)
     - ISO8601 :class:`dates<iso8601_date>` and
       :class:`datetime<iso8601_datetime>`
     - :class:`UUID<uuid>`
     - :class:`comma-separated list<comma_separated_list>`

    Parse actions:

     - :class:`convertToInteger`
     - :class:`convertToFloat`
     - :class:`convertToDate`
     - :class:`convertToDatetime`
     - :class:`stripHTMLTags`
     - :class:`upcaseTokens`
     - :class:`downcaseTokens`

    Example::

        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')

    prints::

        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    """

    convertToInteger = tokenMap(int)
    """
    Parse action for converting parsed integers to Python int
    """

    convertToFloat = tokenMap(float)
    """
    Parse action for converting parsed numbers to Python float
    """

    integer = Word(nums).setName("integer").setParseAction(convertToInteger)
    """expression that parses an unsigned integer, returns an int"""

    hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int, 16))
    """expression that parses a hexadecimal integer, returns an int"""

    signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger)
    """expression that parses an integer with optional leading sign, returns an int"""

    fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction")
    """fractional expression of an integer divided by an integer, returns a float"""
    fraction.addParseAction(lambda t: t[0]/t[-1])

    mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction")
    """mixed integer of the form 'integer - fraction', with optional leading integer, returns float"""
    mixed_integer.addParseAction(sum)

    real = Regex(r'[+-]?(:?\d+\.\d*|\.\d+)').setName("real number").setParseAction(convertToFloat)
    """expression that parses a floating point number and returns a float"""

    sci_real = Regex(r'[+-]?(:?\d+(:?[eE][+-]?\d+)|(:?\d+\.\d*|\.\d+)(:?[eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat)
    """expression that parses a floating point number with optional
    scientific notation and returns a float"""

    # streamlining this expression makes the docs nicer-looking
    number = (sci_real | real | signed_integer).streamline()
    """any numeric expression, returns the corresponding Python type"""

    fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat)
    """any int or real number, returned as float"""

    identifier = Word(alphas + '_', alphanums + '_').setName("identifier")
    """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')"""

    ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address")
    "IPv4 address (``0.0.0.0 - 255.255.255.255``)"

    _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer")
    _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part) * 7).setName("full IPv6 address")
    _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part) * (0, 6))
                           + "::"
                           + Optional(_ipv6_part + (':' + _ipv6_part) * (0, 6))
                           ).setName("short IPv6 address")
    _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8)
    _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address")
    ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address")
    "IPv6 address (long, short, or mixed form)"

    mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address")
    "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)"

    @staticmethod
    def convertToDate(fmt="%Y-%m-%d"):
        """
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%d"``)

        Example::

            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))

        prints::

            [datetime.date(1999, 12, 31)]
        """
        def cvt_fn(s, l, t):
            try:
                return datetime.strptime(t[0], fmt).date()
            except ValueError as ve:
                raise ParseException(s, l, str(ve))
        return cvt_fn

    @staticmethod
    def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"):
        """Helper to create a parse action for converting parsed
        datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default= ``"%Y-%m-%dT%H:%M:%S.%f"``)

        Example::

            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))

        prints::

            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        """
        def cvt_fn(s, l, t):
            try:
                return datetime.strptime(t[0], fmt)
            except ValueError as ve:
                raise ParseException(s, l, str(ve))
        return cvt_fn

    iso8601_date = Regex(r'(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?').setName("ISO8601 date")
    "ISO8601 date (``yyyy-mm-dd``)"

    iso8601_datetime = Regex(r'(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime")
    "ISO8601 datetime (``yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)``) - trailing seconds, milliseconds, and timezone optional; accepts separating ``'T'`` or ``' '``"

    uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID")
    "UUID (``xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx``)"

    _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress()
    @staticmethod
    def stripHTMLTags(s, l, tokens):
        """Parse action to remove HTML tags from web page HTML source

        Example::

            # strip HTML links from normal text
            text = '<td>More info at the <a href="https://github.com/pyparsing/pyparsing/wiki">pyparsing</a> wiki page</td>'
            td, td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            print(table_text.parseString(text).body)

        Prints::

            More info at the pyparsing wiki page
        """
        return pyparsing_common._html_stripper.transformString(tokens[0])

    _commasepitem = Combine(OneOrMore(~Literal(",")
                                      + ~LineEnd()
                                      + Word(printables, excludeChars=',')
                                      + Optional(White(" \t")))).streamline().setName("commaItem")
    comma_separated_list = delimitedList(Optional(quotedString.copy()
                                                  | _commasepitem, default='')
                                         ).setName("comma separated list")
    """Predefined expression of 1 or more printable words or quoted strings, separated by commas."""

    upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper()))
    """Parse action to convert tokens to upper case."""

    downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower()))
    """Parse action to convert tokens to lower case."""


class _lazyclassproperty(object):
    def __init__(self, fn):
        self.fn = fn
        self.__doc__ = fn.__doc__
        self.__name__ = fn.__name__

    def __get__(self, obj, cls):
        if cls is None:
            cls = type(obj)
        if not hasattr(cls, '_intern') or any(cls._intern is getattr(superclass, '_intern', [])
                                              for superclass in cls.__mro__[1:]):
            cls._intern = {}
        attrname = self.fn.__name__
        if attrname not in cls._intern:
            cls._intern[attrname] = self.fn(cls)
        return cls._intern[attrname]


class unicode_set(object):
    """
    A set of Unicode characters, for language-specific strings for
    ``alphas``, ``nums``, ``alphanums``, and ``printables``.
    A unicode_set is defined by a list of ranges in the Unicode character
    set, in a class attribute ``_ranges``, such as::

        _ranges = [(0x0020, 0x007e), (0x00a0, 0x00ff),]

    A unicode set can also be defined using multiple inheritance of other unicode sets::

        class CJK(Chinese, Japanese, Korean):
            pass
    """
    _ranges = []

    @classmethod
    def _get_chars_for_ranges(cls):
        ret = []
        for cc in cls.__mro__:
            if cc is unicode_set:
                break
            for rr in cc._ranges:
                ret.extend(range(rr[0], rr[-1] + 1))
        return [unichr(c) for c in sorted(set(ret))]

    @_lazyclassproperty
    def printables(cls):
        "all non-whitespace characters in this range"
        return u''.join(filterfalse(unicode.isspace, cls._get_chars_for_ranges()))

    @_lazyclassproperty
    def alphas(cls):
        "all alphabetic characters in this range"
        return u''.join(filter(unicode.isalpha, cls._get_chars_for_ranges()))

    @_lazyclassproperty
    def nums(cls):
        "all numeric digit characters in this range"
        return u''.join(filter(unicode.isdigit, cls._get_chars_for_ranges()))

    @_lazyclassproperty
    def alphanums(cls):
        "all alphanumeric characters in this range"
        return cls.alphas + cls.nums


class pyparsing_unicode(unicode_set):
    """
    A namespace class for defining common language unicode_sets.
    """
    _ranges = [(32, sys.maxunicode)]

    class Latin1(unicode_set):
        "Unicode set for Latin-1 Unicode Character Range"
        _ranges = [(0x0020, 0x007e), (0x00a0, 0x00ff),]

    class LatinA(unicode_set):
        "Unicode set for Latin-A Unicode Character Range"
        _ranges = [(0x0100, 0x017f),]

    class LatinB(unicode_set):
        "Unicode set for Latin-B Unicode Character Range"
        _ranges = [(0x0180, 0x024f),]

    class Greek(unicode_set):
        "Unicode set for Greek Unicode Character Ranges"
        _ranges = [
            (0x0370, 0x03ff), (0x1f00, 0x1f15), (0x1f18, 0x1f1d), (0x1f20, 0x1f45), (0x1f48, 0x1f4d),
            (0x1f50, 0x1f57), (0x1f59,), (0x1f5b,), (0x1f5d,), (0x1f5f, 0x1f7d), (0x1f80, 0x1fb4), (0x1fb6, 0x1fc4),
            (0x1fc6, 0x1fd3), (0x1fd6, 0x1fdb), (0x1fdd, 0x1fef), (0x1ff2, 0x1ff4), (0x1ff6, 0x1ffe),
        ]

    class Cyrillic(unicode_set):
        "Unicode set for Cyrillic Unicode Character Range"
        _ranges = [(0x0400, 0x04ff)]

    class Chinese(unicode_set):
        "Unicode set for Chinese Unicode Character Range"
        _ranges = [(0x4e00, 0x9fff), (0x3000, 0x303f),]

    class Japanese(unicode_set):
        "Unicode set for Japanese Unicode Character Range, combining Kanji, Hiragana, and Katakana ranges"
        _ranges = []

        class Kanji(unicode_set):
            "Unicode set for Kanji Unicode Character Range"
            _ranges = [(0x4E00, 0x9Fbf), (0x3000, 0x303f),]

        class Hiragana(unicode_set):
            "Unicode set for Hiragana Unicode Character Range"
            _ranges = [(0x3040, 0x309f),]

        class Katakana(unicode_set):
            "Unicode set for Katakana  Unicode Character Range"
            _ranges = [(0x30a0, 0x30ff),]

    class Korean(unicode_set):
        "Unicode set for Korean Unicode Character Range"
        _ranges = [(0xac00, 0xd7af), (0x1100, 0x11ff), (0x3130, 0x318f), (0xa960, 0xa97f), (0xd7b0, 0xd7ff), (0x3000, 0x303f),]

    class CJK(Chinese, Japanese, Korean):
        "Unicode set for combined Chinese, Japanese, and Korean (CJK) Unicode Character Range"
        pass

    class Thai(unicode_set):
        "Unicode set for Thai Unicode Character Range"
        _ranges = [(0x0e01, 0x0e3a), (0x0e3f, 0x0e5b),]

    class Arabic(unicode_set):
        "Unicode set for Arabic Unicode Character Range"
        _ranges = [(0x0600, 0x061b), (0x061e, 0x06ff), (0x0700, 0x077f),]

    class Hebrew(unicode_set):
        "Unicode set for Hebrew Unicode Character Range"
        _ranges = [(0x0590, 0x05ff),]

    class Devanagari(unicode_set):
        "Unicode set for Devanagari Unicode Character Range"
        _ranges = [(0x0900, 0x097f), (0xa8e0, 0xa8ff)]

pyparsing_unicode.Japanese._ranges = (pyparsing_unicode.Japanese.Kanji._ranges
                                      + pyparsing_unicode.Japanese.Hiragana._ranges
                                      + pyparsing_unicode.Japanese.Katakana._ranges)

# define ranges in language character sets
if PY_3:
    setattr(pyparsing_unicode, u"العربية", pyparsing_unicode.Arabic)
    setattr(pyparsing_unicode, u"中文", pyparsing_unicode.Chinese)
    setattr(pyparsing_unicode, u"кириллица", pyparsing_unicode.Cyrillic)
    setattr(pyparsing_unicode, u"Ελληνικά", pyparsing_unicode.Greek)
    setattr(pyparsing_unicode, u"עִברִית", pyparsing_unicode.Hebrew)
    setattr(pyparsing_unicode, u"日本語", pyparsing_unicode.Japanese)
    setattr(pyparsing_unicode.Japanese, u"漢字", pyparsing_unicode.Japanese.Kanji)
    setattr(pyparsing_unicode.Japanese, u"カタカナ", pyparsing_unicode.Japanese.Katakana)
    setattr(pyparsing_unicode.Japanese, u"ひらがな", pyparsing_unicode.Japanese.Hiragana)
    setattr(pyparsing_unicode, u"한국어", pyparsing_unicode.Korean)
    setattr(pyparsing_unicode, u"ไทย", pyparsing_unicode.Thai)
    setattr(pyparsing_unicode, u"देवनागरी", pyparsing_unicode.Devanagari)


if __name__ == "__main__":

    selectToken    = CaselessLiteral("select")
    fromToken      = CaselessLiteral("from")

    ident          = Word(alphas, alphanums + "_$")

    columnName     = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
    columnNameList = Group(delimitedList(columnName)).setName("columns")
    columnSpec     = ('*' | columnNameList)

    tableName      = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
    tableNameList  = Group(delimitedList(tableName)).setName("tables")

    simpleSQL      = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables")

    # demo runTests method, including embedded comments in test string
    simpleSQL.runTests("""
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        """)

    pyparsing_common.number.runTests("""
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        """)

    # any int or real number, returned as float
    pyparsing_common.fnumber.runTests("""
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        """)

    pyparsing_common.hex_integer.runTests("""
        100
        FF
        """)

    import uuid
    pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
    pyparsing_common.uuid.runTests("""
        12345678-1234-5678-1234-567812345678
        """)
site-packages/pip/_vendor/pkg_resources/py31compat.py000064400000001062151446177000016741 0ustar00import os
import errno
import sys

from pip._vendor import six


def _makedirs_31(path, exist_ok=False):
    try:
        os.makedirs(path)
    except OSError as exc:
        if not exist_ok or exc.errno != errno.EEXIST:
            raise


# rely on compatibility behavior until mode considerations
#  and exists_ok considerations are disentangled.
# See https://github.com/pypa/setuptools/pull/1083#issuecomment-315168663
needs_makedirs = (
    six.PY2 or
    (3, 4) <= sys.version_info < (3, 4, 1)
)
makedirs = _makedirs_31 if needs_makedirs else os.makedirs
site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-38.opt-1.pyc000064400000303710151446177000023732 0ustar00U

��.eͦ�G@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZzddlZWnek
�rddlZYnXze Wne!k
�r*e"Z YnXddl#m$Z$ddl%m&Z&m'Z'm(Z(ddlm)Z)zddlm*Z*m+Z+m,Z,d	Z-Wnek
�r�d
Z-YnXddlm.Z/ddl0m1Z1m2Z2zddl3m4Z5e5j6Wnek
�r�dZ5YnXd
dl7m8Z8ddl#m9Z9ddl#m:Z:e;d�e;d�e;d�e;d�e<Z=dej>k�r@dk�rLnne?d��e$j@�r\dZAdZBdZCdZDdZEdZFdZGdZHdZIdZJdZKdZLdZMdZNdZOdZPdZQdZRdZSGdd�deT�ZUdd�ZViZWdd�ZXdd�ZYd d!�ZZd"d#�Z[d$d%�Z\d&d'�Z]d(d)�Z^d*d+�Z_Z`d,d-�Zad.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMddNddOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrgGZbGdsdI�dIec�ZdGdtdJ�dJed�ZeGdudv�dvee�ZfGdwdK�dKed�ZgGdxdL�dLed�ZhiZiejjddy�ZkdyZldzZmd
ZndZod{Zpd|dm�Zqd}d0�Zrgfd~d�Zsd�d��Ztd�d��Zue�vd��Zwe�vd��ZxeuZyd�dR�Zzd�d/�Z{e{Z|d�d1�Z}d�d2�Z~d�d�d3�Zd�d4�Z�Gd�d`�d`�Z�Gd�da�dae��Z�Gd�dD�dD�Z�Gd�d��d�e��Z�Gd�dC�dC�Z�e�Z�Gd�dM�dMe?�Z�Gd�dE�dE�Z�d�dB�Z�d�dO�Z�d�dP�Z�d�dU�Z�d�dV�Z�d�dW�Z��dd�dX�Z�Gd�dg�dg�Z�eqe�e��Gd�dh�dhe��Z�Gd�di�die��Z�e����Gd�de�dee��Z�e��Z�Gd�d��d�e��Z�Gd�d��d�e��Z�Gd�dj�dje��Z�eqe
j�e��Gd�db�dbe��Z�Gd�dc�dce��Z�Gd�dd�dde��Z�eXd�id��d�dk�Z��dd�d?�Z��dd�d��Z�e�e
j�e���dd�d��Z�e�e�e��d�d��Z��dd�d��Z�d�d��Z�Gd�d��d��Z�d�d��Z�d�d��Z�d�d��Z�d�d��Z�e�ej�e��e�e5d���r�e�e5j�e��eXd�id��eXd�id��d�dl�Z�d�dĄZ�d�dƄZ�d�d<�Z��dd�dn�Z�d�dʄZ�e�ej�e��e�e
j�e��e�e5d���r,e�e5j�e��d�d̄Z�e�e�e��d�dZ�Z�d�dτZ�ifd�dфZ�d�dӄZ�d�dՄZ�d�dׄZ�d�dS�Z�e�vd١j�Z�e�vd�ej�ej�B�j�Z�Gd�dH�dH�Z�d�d݄Z�d�d߄Z�Gd�dF�dF�Z�Gd�d�d�eăZ�Gd�d�d�eăZ�e�e�e�d�Z�d�d�Z�Gd�d�d�eɃZ�d�dN�Z�Gd�dG�dGe:j�j̓Z�d�d�Z�d�d�Z�d�dY�Z�d�d�Z�d�dT�Z�d�d��Z�ej�d�eUd	d��d�d��Z�e�eփfd�d���Z�e�d�d���Z�Gd�dp�dpeكZ�dS(aZ
Package resource API
--------------------

A resource is a logical file contained within a package, or a logical
subdirectory thereof.  The package resource API expects resource names
to have their path parts separated with ``/``, *not* whatever the local
path separator is.  Do not use os.path operations to manipulate resource
names being passed into the API.

The package resource API is designed to work with normal filesystem packages,
.egg files, and unpacked .egg files.  It can also work in a limited way with
.zip files and with custom PEP 302 loaders that support the ``get_data()``
method.
�)�absolute_importN)�get_importer)�six)�urllib�map�filter)�utime)�mkdir�rename�unlinkTF)�open)�isdir�split�)�
py31compat)�appdirs)�	packagingzpip._vendor.packaging.versionz pip._vendor.packaging.specifiersz"pip._vendor.packaging.requirementszpip._vendor.packaging.markers)�r)r�zPython 3.4 or later is requiredc@seZdZdZdS)�
PEP440Warningza
    Used when there is an issue with a version or specifier not complying with
    PEP 440.
    N��__name__�
__module__�__qualname__�__doc__�rr�F/usr/lib/python3.8/site-packages/pip/_vendor/pkg_resources/__init__.pyrxsrcCs8ztj�|�WStjjk
r2tj�|�YSXdS�N)r�version�Version�InvalidVersion�
LegacyVersion)�vrrr�
parse_versionsr#cKs"t��|�t�t�||��dSr)�globals�update�_state_vars�dict�fromkeys)Zvartype�kwrrr�_declare_state�sr*cCs8i}t�}t��D] \}}|d|||�||<q|S)NZ_sget_)r$r&�items��state�g�kr"rrr�__getstate__�s
r0cCs8t�}|��D]$\}}|dt|||||�q|S)NZ_sset_)r$r+r&r,rrr�__setstate__�sr1cCs|��Sr)�copy��valrrr�
_sget_dict�sr5cCs|��|�|�dSr)�clearr%��key�obr-rrr�
_sset_dict�sr:cCs|��Sr)r0r3rrr�_sget_object�sr;cCs|�|�dSr)r1r7rrr�_sset_object�sr<cGsdSrr��argsrrr�<lambda>��r?cCsbt�}t�|�}|dk	r^tjdkr^z&dd�t�dd��|�d�f}Wntk
r\YnX|S)aZReturn this platform's maximum compatible version.

    distutils.util.get_platform() normally reports the minimum version
    of Mac OS X that would be required to *use* extensions produced by
    distutils.  But what we want when checking compatibility is to know the
    version of Mac OS X that we are *running*.  To allow usage of packages that
    explicitly require a newer version of Mac OS X, we must also know the
    current version of the OS.

    If this condition occurs for any other platform with a version in its
    platform strings, this function should be extended accordingly.
    N�darwinzmacosx-%s-%s�.�r)	�get_build_platform�macosVersionString�match�sys�platform�join�_macosx_vers�group�
ValueError)�plat�mrrr�get_supported_platform�s

&rO�require�
run_script�get_provider�get_distribution�load_entry_point�
get_entry_map�get_entry_info�iter_entry_points�resource_string�resource_stream�resource_filename�resource_listdir�resource_exists�resource_isdir�declare_namespace�working_set�add_activation_listener�find_distributions�set_extraction_path�cleanup_resources�get_default_cache�Environment�
WorkingSet�ResourceManager�Distribution�Requirement�
EntryPoint�ResolutionError�VersionConflict�DistributionNotFound�UnknownExtra�ExtractionError�parse_requirements�	safe_name�safe_version�get_platform�compatible_platforms�yield_lines�split_sections�
safe_extra�to_filename�invalid_marker�evaluate_marker�ensure_directory�normalize_path�EGG_DIST�BINARY_DIST�SOURCE_DIST�
CHECKOUT_DIST�DEVELOP_DIST�IMetadataProvider�IResourceProvider�FileMetadata�PathMetadata�EggMetadata�
EmptyProvider�empty_provider�NullProvider�EggProvider�DefaultProvider�ZipProvider�register_finder�register_namespace_handler�register_loader_type�fixup_namespace_packagesr�PkgResourcesDeprecationWarning�run_main�AvailableDistributionsc@seZdZdZdd�ZdS)rkz.Abstract base for dependency resolution errorscCs|jjt|j�Sr)�	__class__r�reprr>��selfrrr�__repr__�szResolutionError.__repr__N)rrrrr�rrrrrk�sc@s<eZdZdZdZedd��Zedd��Zdd�Zd	d
�Z	dS)rlz�
    An already-installed version conflicts with the requested version.

    Should be initialized with the installed Distribution and the requested
    Requirement.
    z3{self.dist} is installed but {self.req} is requiredcCs
|jdS�Nrr=r�rrr�distszVersionConflict.distcCs
|jdS�Nrr=r�rrr�reqszVersionConflict.reqcCs|jjft��Sr��	_template�format�localsr�rrr�reportszVersionConflict.reportcCs|s|S|j|f}t|�S)zt
        If required_by is non-empty, return a version of self that is a
        ContextualVersionConflict.
        )r>�ContextualVersionConflict)r��required_byr>rrr�with_contextszVersionConflict.with_contextN)
rrrrr��propertyr�r�r�r�rrrrrls

c@s&eZdZdZejdZedd��ZdS)r�z�
    A VersionConflict that accepts a third parameter, the set of the
    requirements that required the installed Distribution.
    z by {self.required_by}cCs
|jdS)NrCr=r�rrrr�*sz%ContextualVersionConflict.required_byN)rrrrrlr�r�r�rrrrr�"s
r�c@sHeZdZdZdZedd��Zedd��Zedd��Zd	d
�Z	dd�Z
d
S)rmz&A requested distribution was not foundzSThe '{self.req}' distribution was not found and is required by {self.requirers_str}cCs
|jdSr�r=r�rrrr�5szDistributionNotFound.reqcCs
|jdSr�r=r�rrr�	requirers9szDistributionNotFound.requirerscCs|js
dSd�|j�S)Nzthe applicationz, )r�rIr�rrr�
requirers_str=sz"DistributionNotFound.requirers_strcCs|jjft��Srr�r�rrrr�CszDistributionNotFound.reportcCs|��Sr)r�r�rrr�__str__FszDistributionNotFound.__str__N)rrrrr�r�r�r�r�r�r�rrrrrm/s


c@seZdZdZdS)rnz>Distribution doesn't have an "extra feature" of the given nameNrrrrrrnJsrrC���cCs|t|<dS)aRegister `provider_factory` to make providers for `loader_type`

    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
    and `provider_factory` is a function that, passed a *module* object,
    returns an ``IResourceProvider`` for that module.
    N)�_provider_factories)Zloader_typeZprovider_factoryrrrr�XscCstt|t�r$t�|�p"tt|��dSztj|}Wn&tk
rXt	|�tj|}YnXt
|dd�}tt|�|�S)z?Return an IResourceProvider for the named module or requirementr�
__loader__N)
�
isinstancerir_�findrP�strrG�modules�KeyError�
__import__�getattr�
_find_adapterr�)ZmoduleOrReq�module�loaderrrrrRbs
cCsd|s\t��d}|dkrLd}tj�|�rLttd�rLt�|�}d|krL|d}|�|�	d��|dS)Nr�z0/System/Library/CoreServices/SystemVersion.plist�	readPlistZProductVersionrB)
rHZmac_ver�os�path�exists�hasattr�plistlibr��appendr)�_cacherZplistZ
plist_contentrrrrJos

rJcCsddd��||�S)NZppc)ZPowerPCZPower_Macintosh)�get)�machinerrr�_macosx_archsr�cCs~ddlm}|�}tjdkrz|�d�szz>t�}t��d�dd�}dt	|d�t	|d	�t
|�fWStk
rxYnX|S)
z�Return this platform's string for platform-specific distributions

    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
    needs some hacks for Linux and Mac OS X.
    r)rsrAzmacosx-r� �_zmacosx-%d.%d-%sr)Z	sysconfigrsrGrH�
startswithrJr��uname�replace�intr�rL)rsrMrr�rrrrD�s

�rDzmacosx-(\d+)\.(\d+)-(.*)zdarwin-(\d+)\.(\d+)\.(\d+)-(.*)cCs�|dks|dks||krdSt�|�}|r�t�|�}|s�t�|�}|r�t|�d��}d|�d�|�d�f}|dkr||dks�|dkr�|d	kr�dSd
S|�d�|�d�ks�|�d�|�d�kr�d
St|�d��t|�d��kr�d
SdSd
S)z�Can code for the `provided` platform run on the `required` platform?

    Returns true if either platform is ``None``, or the platforms are equal.

    XXX Needs compatibility checks for Linux and other unixy OSes.
    NTrz%s.%srC�z10.3�z10.4Fr)rErF�darwinVersionStringr�rK)ZprovidedZrequiredZreqMacZprovMacZ
provDarwinZdversionZmacosversionrrrrt�s2


���cCs<t�d�j}|d}|��||d<t|�d�||�dS)z@Locate distribution `dist_spec` and run its `script_name` scriptrrrN�rG�	_getframe�	f_globalsr6rPrQ)Z	dist_spec�script_name�ns�namerrrrQ�s
cCs@t|tj�rt�|�}t|t�r(t|�}t|t�s<td|��|S)z@Return a current distribution object for a Requirement or stringz-Expected string, Requirement, or Distribution)r�r�string_typesri�parserRrh�	TypeError�r�rrrrS�s



cCst|��||�S)zDReturn `name` entry point of `group` for `dist` or raise ImportError)rSrT�r�rKr�rrrrT�scCst|��|�S)�=Return the entry point map for `group`, or the full entry map)rSrU)r�rKrrrrU�scCst|��||�S�z<Return the EntryPoint object for `group`+`name`, or ``None``)rSrVr�rrrrV�sc@s<eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
S)r�cCsdS)z;Does the package's distribution contain the named metadata?Nr�r�rrr�has_metadata�szIMetadataProvider.has_metadatacCsdS)z'The named metadata resource as a stringNrr�rrr�get_metadata�szIMetadataProvider.get_metadatacCsdS)z�Yield named metadata resource as list of non-blank non-comment lines

       Leading and trailing whitespace is stripped from each line, and lines
       with ``#`` as the first non-blank character are omitted.Nrr�rrr�get_metadata_lines�sz$IMetadataProvider.get_metadata_linescCsdS)z>Is the named metadata a directory?  (like ``os.path.isdir()``)Nrr�rrr�metadata_isdirsz IMetadataProvider.metadata_isdircCsdS)z?List of metadata names in the directory (like ``os.listdir()``)Nrr�rrr�metadata_listdirsz"IMetadataProvider.metadata_listdircCsdS)z=Execute the named script in the supplied namespace dictionaryNr)r��	namespacerrrrQ	szIMetadataProvider.run_scriptN)	rrrr�r�r�r�r�rQrrrrr��sc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�z3An object that provides access to package resourcescCsdS)zdReturn a true filesystem path for `resource_name`

        `manager` must be an ``IResourceManager``Nr��manager�
resource_namerrr�get_resource_filenamesz'IResourceProvider.get_resource_filenamecCsdS)ziReturn a readable file-like object for `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_streamsz%IResourceProvider.get_resource_streamcCsdS)zmReturn a string containing the contents of `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_stringsz%IResourceProvider.get_resource_stringcCsdS)z,Does the package contain the named resource?Nr�r�rrr�has_resourceszIResourceProvider.has_resourcecCsdS)z>Is the named resource a directory?  (like ``os.path.isdir()``)Nrr�rrrr]"sz IResourceProvider.resource_isdircCsdS)z?List of resource names in the directory (like ``os.listdir()``)Nrr�rrrr[%sz"IResourceProvider.resource_listdirN)
rrrrr�r�r�r�r]r[rrrrr�
sc@s�eZdZdZd'dd�Zedd��Zedd��Zd	d
�Zdd�Z	d
d�Z
d(dd�Zdd�Zdd�Z
d)dd�Zd*dd�Zd+dd�Zdd�Zd,dd �Zd!d"�Zd#d$�Zd%d&�ZdS)-rfzDA collection of active distributions on sys.path (or a similar list)NcCs>g|_i|_i|_g|_|dkr&tj}|D]}|�|�q*dS)z?Create working set from list of path entries (default=sys.path)N)�entries�
entry_keys�by_key�	callbacksrGr��	add_entry)r�r��entryrrr�__init__,szWorkingSet.__init__cCsb|�}zddlm}Wntk
r.|YSXz|�|�Wntk
r\|�|�YSX|S)z1
        Prepare the master working set.
        r)�__requires__)�__main__r��ImportErrorrPrl�_build_from_requirements)�cls�wsr�rrr�
_build_master9s
zWorkingSet._build_mastercCsf|g�}t|�}|�|t��}|D]}|�|�q"tjD]}||jkr8|�|�q8|jtjdd�<|S)zQ
        Build a working set from a requirement spec. Rewrites sys.path.
        N)rp�resolvere�addrGr�r�r�)r�Zreq_specr��reqs�distsr�r�rrrr�Ms

z#WorkingSet._build_from_requirementscCs<|j�|g�|j�|�t|d�D]}|�||d�q$dS)a�Add a path item to ``.entries``, finding any distributions on it

        ``find_distributions(entry, True)`` is used to find distributions
        corresponding to the path entry, and they are added.  `entry` is
        always appended to ``.entries``, even if it is already present.
        (This is because ``sys.path`` can contain the same value more than
        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
        equal ``sys.path``.)
        TFN)r��
setdefaultr�r�rar�)r�r�r�rrrr�cs
zWorkingSet.add_entrycCs|j�|j�|kS)z9True if `dist` is the active distribution for its project)r�r�r8�r�r�rrr�__contains__rszWorkingSet.__contains__cCs,|j�|j�}|dk	r(||kr(t||��|S)a�Find a distribution matching requirement `req`

        If there is an active distribution for the requested project, this
        returns it as long as it meets the version requirement specified by
        `req`.  But, if there is an active distribution for the project and it
        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
        If there is no active distribution for the requested project, ``None``
        is returned.
        N)r�r�r8rl)r�r�r�rrrr�vs

zWorkingSet.findcs��fdd�|D�S)aYield entry point objects from `group` matching `name`

        If `name` is None, yields all entry points in `group` from all
        distributions in the working set, otherwise only ones matching
        both `group` and `name` are yielded (in distribution order).
        c3s8|]0}|�����D]}�dks*�|jkr|VqqdSr)rU�valuesr�)�.0r�r��rKr�rr�	<genexpr>�s
�z/WorkingSet.iter_entry_points.<locals>.<genexpr>r�r�rKr�rr�rrW�s�zWorkingSet.iter_entry_pointscCs>t�d�j}|d}|��||d<|�|�d�||�dS)z?Locate distribution for `requires` and run `script_name` scriptrrrNr�)r��requiresr�r�r�rrrrQ�s
zWorkingSet.run_scriptccsLi}|jD]<}||jkrq
|j|D] }||kr$d||<|j|Vq$q
dS)z�Yield distributions for non-duplicate projects in the working set

        The yield order is the order in which the items' path entries were
        added to the working set.
        rN)r�r�r�)r��seen�itemr8rrr�__iter__�s

zWorkingSet.__iter__TFcCs�|r|j|j||d�|dkr$|j}|j�|g�}|j�|jg�}|sV|j|jkrVdS||j|j<|j|krx|�|j�|j|kr�|�|j�|�|�dS)aAdd `dist` to working set, associated with `entry`

        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
        On exit from this routine, `entry` is added to the end of the working
        set's ``.entries`` (if it wasn't already present).

        `dist` is only added to the working set if it's for a project that
        doesn't already have a distribution in the set, unless `replace=True`.
        If it's added, any callbacks registered with the ``subscribe()`` method
        will be called.
        �r�N)	�	insert_onr��locationr�r�r8r�r��
_added_new)r�r�r��insertr��keysZkeys2rrrr��s

zWorkingSet.addcCsxt|�ddd�}i}i}g}t�}	t�t�}
|�rt|�d�}||krHq.|	�||�sVq.|�|j�}|dk�r|j	�|j�}|dks�||kr�|r�|}
|dkr�|dkr�t
|j�}nt
g�}tg�}
|j
||
||d�}||j<|dkr�|
�|d�}t||��|�|�||k�r$|
|}t||��|��|�|j�ddd�}|�|�|D] }|
|�|j�|j|	|<�qHd||<q.|S)a�List all distributions needed to (recursively) meet `requirements`

        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
        if supplied, should be an ``Environment`` instance.  If
        not supplied, it defaults to all distributions available within any
        entry or distribution in the working set.  `installer`, if supplied,
        will be invoked with each requirement that cannot be met by an
        already-installed distribution; it should return a ``Distribution`` or
        ``None``.

        Unless `replace_conflicting=True`, raises a VersionConflict exception
        if
        any requirements are found on the path that have the correct name but
        the wrong version.  Otherwise, if an `installer` is supplied it will be
        invoked to obtain the correct version of the requirement and activate
        it.

        `extras` is a list of the extras to be used with these requirements.
        This is important because extra requirements may look like `my_req;
        extra = "my_extra"`, which would otherwise be interpreted as a purely
        optional requirement.  Instead, we want to be able to assert that these
        requirements are truly required.
        Nr�r)�replace_conflictingT)�list�
_ReqExtras�collections�defaultdict�set�pop�markers_passr�r8r�rer�rf�
best_matchrmr�rlr�r�extras�extendr��project_name)r��requirements�env�	installerrrZ	processedZbestZto_activateZ
req_extrasr�r�r�r�r�Z
dependent_reqZnew_requirementsZnew_requirementrrrr��sT


�




zWorkingSet.resolvecCs
t|�}|��i}i}|dkr4t|j�}||7}n||}|�g�}	tt|	j|��|D]�}
||
D]�}|��g}z|	�|||�}
WnBt	k
r�}z$|||<|r�WY�qfn
WY�qZW5d}~XYqfXtt|	j|
��|�
t�|
��qZqfqZt|�}|��||fS)asFind all activatable distributions in `plugin_env`

        Example usage::

            distributions, errors = working_set.find_plugins(
                Environment(plugin_dirlist)
            )
            # add plugins+libs to sys.path
            map(working_set.add, distributions)
            # display errors
            print('Could not load', errors)

        The `plugin_env` should be an ``Environment`` instance that contains
        only distributions that are in the project's "plugin directory" or
        directories. The `full_env`, if supplied, should be an ``Environment``
        contains all currently-available distributions.  If `full_env` is not
        supplied, one is created automatically from the ``WorkingSet`` this
        method is called on, which will typically mean that every directory on
        ``sys.path`` will be scanned for distributions.

        `installer` is a standard installer callback as used by the
        ``resolve()`` method. The `fallback` flag indicates whether we should
        attempt to resolve older versions of a plugin if the newest version
        cannot be resolved.

        This method returns a 2-tuple: (`distributions`, `error_info`), where
        `distributions` is a list of the distributions found in `plugin_env`
        that were loadable, along with any other distributions that are needed
        to resolve their dependencies.  `error_info` is a dictionary mapping
        unloadable plugin distributions to an exception instance describing the
        error that occurred. Usually this will be a ``DistributionNotFound`` or
        ``VersionConflict`` instance.
        N)
r�sortrer�r�rr��as_requirementr�rkr%r'r()r�Z
plugin_envZfull_envrZfallbackZplugin_projectsZ
error_infoZ
distributionsrZ
shadow_setrr�r�Z	resolveesr"rrr�find_plugins's4$




zWorkingSet.find_pluginscGs&|�t|��}|D]}|�|�q|S)a�Ensure that distributions matching `requirements` are activated

        `requirements` must be a string or a (possibly-nested) sequence
        thereof, specifying the distributions and versions required.  The
        return value is a sequence of the distributions that needed to be
        activated to fulfill the requirements; all relevant distributions are
        included, even if they were already activated in this working set.
        )r�rpr�)r�rZneededr�rrrrP{s	zWorkingSet.requirecCs8||jkrdS|j�|�|s"dS|D]}||�q&dS)z�Invoke `callback` for all distributions

        If `existing=True` (default),
        call on all existing ones, as well.
        N)r�r�)r��callback�existingr�rrr�	subscribe�s
zWorkingSet.subscribecCs|jD]}||�qdSr)r�)r�r�rrrrr�s
zWorkingSet._added_newcCs,|jdd�|j��|j��|jdd�fSr)r�r�r2r�r�r�rrrr0�s
�zWorkingSet.__getstate__cCs@|\}}}}|dd�|_|��|_|��|_|dd�|_dSr)r�r2r�r�r�)r�Ze_k_b_cr�r
r�r�rrrr1�s


zWorkingSet.__setstate__)N)N)NTF)NNFN)NNT)T)rrrrr��classmethodr�r�r�r�r�rWrQrr�r�rrPrrr0r1rrrrrf)s4





�
]�
T
c@seZdZdZddd�ZdS)r
z>
    Map each requirement to the extras that demanded it.
    Ncs2�fdd�|��d�|pdD�}�jp0t|�S)z�
        Evaluate markers for req against each extra that
        demanded it.

        Return False if the req has a marker and fails
        evaluation. Otherwise, return True.
        c3s|]}�j�d|i�VqdS)�extraN��marker�evaluate)r�r!�r�rrr��s�z*_ReqExtras.markers_pass.<locals>.<genexpr>rr)r�r#�any)r�r�rZextra_evalsrr%rr�s
�z_ReqExtras.markers_pass)N)rrrrrrrrrr
�sr
c@sxeZdZdZde�efdd�Zdd�Zdd�Zdd	d
�Z	dd�Z
d
d�Zddd�Zddd�Z
dd�Zdd�Zdd�ZdS)rez5Searchable snapshot of distributions on a search pathNcCs i|_||_||_|�|�dS)a!Snapshot distributions available on a search path

        Any distributions found on `search_path` are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.

        `platform` is an optional string specifying the name of the platform
        that platform-specific distributions must be compatible with.  If
        unspecified, it defaults to the current platform.  `python` is an
        optional string naming the desired version of Python (e.g. ``'3.6'``);
        it defaults to the current version.

        You may explicitly set `platform` (and/or `python`) to ``None`` if you
        wish to map *all* distributions, not just those compatible with the
        running platform or Python version.
        N)�_distmaprH�python�scan)r��search_pathrHr(rrrr��szEnvironment.__init__cCs2|jdkp|jdkp|j|jk}|o0t|j|j�S)z�Is distribution `dist` acceptable for this environment?

        The distribution must match the platform and python version
        requirements specified when this environment was created, or False
        is returned.
        N)r(�
py_versionrtrH)r�r�Z	py_compatrrr�can_add�s
�
�zEnvironment.can_addcCs|j|j�|�dS)z"Remove `dist` from the environmentN)r'r8�remover�rrrr-�szEnvironment.removecCs4|dkrtj}|D]}t|�D]}|�|�qqdS)adScan `search_path` for distributions usable in this environment

        Any distributions found are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.  Only distributions conforming to
        the platform/python version defined at initialization are added.
        N)rGr�rar�)r�r*rr�rrrr)�s
zEnvironment.scancCs|��}|j�|g�S)aReturn a newest-to-oldest list of distributions for `project_name`

        Uses case-insensitive `project_name` comparison, assuming all the
        project's distributions use their project's name converted to all
        lowercase as their key.

        )�lowerr'r�)r�rZdistribution_keyrrr�__getitem__�szEnvironment.__getitem__cCsL|�|�rH|��rH|j�|jg�}||krH|�|�|jt�d�dd�dS)zLAdd `dist` if we ``can_add()`` it and it has not already been added
        �hashcmpT�r8�reverseN)	r,�has_versionr'r�r8r�r�operator�
attrgetter)r�r�r�rrrr�s

zEnvironment.addFcCsfz|�|�}Wntk
r,|s$�d}YnX|dk	r:|S||jD]}||krD|SqD|�||�S)a�Find distribution best matching `req` and usable on `working_set`

        This calls the ``find(req)`` method of the `working_set` to see if a
        suitable distribution is already active.  (This may raise
        ``VersionConflict`` if an unsuitable version of the project is already
        active in the specified `working_set`.)  If a suitable distribution
        isn't active, this method returns the newest distribution in the
        environment that meets the ``Requirement`` in `req`.  If no suitable
        distribution is found, and `installer` is supplied, then the result of
        calling the environment's ``obtain(req, installer)`` method will be
        returned.
        N)r�rlr8�obtain)r�r�r_rrr�rrrrs

zEnvironment.best_matchcCs|dk	r||�SdS)a�Obtain a distribution matching `requirement` (e.g. via download)

        Obtain a distro that matches requirement (e.g. via download).  In the
        base ``Environment`` class, this routine just returns
        ``installer(requirement)``, unless `installer` is None, in which case
        None is returned instead.  This method is a hook that allows subclasses
        to attempt other ways of obtaining a distribution before falling back
        to the `installer` argument.Nr)r�Zrequirementrrrrr6+s	zEnvironment.obtainccs"|j��D]}||r
|Vq
dS)z=Yield the unique project names of the available distributionsN)r'r
�r�r8rrrr7szEnvironment.__iter__cCsVt|t�r|�|�n<t|t�rD|D]}||D]}|�|�q0q$ntd|f��|S)z2In-place addition of a distribution or environmentzCan't add %r to environment)r�rhr�rer�)r��otherZprojectr�rrr�__iadd__=s

zEnvironment.__iadd__cCs*|jgddd�}||fD]}||7}q|S)z4Add an environment or distribution to an environmentN)rHr(�r�)r�r8�newrrrr�__add__Is
zEnvironment.__add__)N)NF)N)rrrrrO�PY_MAJORr�r,r-r)r/r�rr6rr9r<rrrrre�s"�


�

c@seZdZdZdS)roaTAn error occurred extracting a resource

    The following attributes are available from instances of this exception:

    manager
        The resource manager that raised this exception

    cache_path
        The base directory for resource extraction

    original_error
        The exception instance that caused extraction to fail
    NrrrrrroUsc@s�eZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zddd�Z
edd��Zdd�Zdd�Zd dd�ZdS)!rgz'Manage resource extraction and packagesNcCs
i|_dSr)�cached_filesr�rrrr�iszResourceManager.__init__cCst|��|�S)zDoes the named resource exist?)rRr��r�Zpackage_or_requirementr�rrrr\lszResourceManager.resource_existscCst|��|�S)z,Is the named resource an existing directory?)rRr]r?rrrr]ps�zResourceManager.resource_isdircCst|��||�S)z4Return a true filesystem path for specified resource)rRr�r?rrrrZvs�z!ResourceManager.resource_filenamecCst|��||�S)z9Return a readable file-like object for specified resource)rRr�r?rrrrY|s�zResourceManager.resource_streamcCst|��||�S)z%Return specified resource as a string)rRr�r?rrrrX�s�zResourceManager.resource_stringcCst|��|�S)z1List the contents of the named resource directory)rRr[r?rrrr[�s�z ResourceManager.resource_listdircCsRt��d}|jpt�}t�d���}t|jft	���}||_
||_||_|�dS)z5Give an error message for problems extracting file(s)ra
            Can't extract file(s) to egg cache

            The following error occurred while trying to extract file(s)
            to the Python egg cache:

              {old_exc}

            The Python egg cache directory is currently set to:

              {cache_path}

            Perhaps your account does not have write access to this directory?
            You can change the cache directory by setting the PYTHON_EGG_CACHE
            environment variable to point to an accessible directory.
            N)
rG�exc_info�extraction_pathrd�textwrap�dedent�lstripror�r�r��
cache_pathZoriginal_error)r��old_excrE�tmpl�errrrr�extraction_error�sz ResourceManager.extraction_errorrcCsf|jp
t�}tjj||df|��}zt|�Wntk
rL|��YnX|�|�d|j	|<|S)a�Return absolute location in cache for `archive_name` and `names`

        The parent directory of the resulting path will be created if it does
        not already exist.  `archive_name` should be the base filename of the
        enclosing egg (which may not be the name of the enclosing zipfile!),
        including its ".egg" extension.  `names`, if provided, should be a
        sequence of path name parts "under" the egg's extraction location.

        This method should only be called by resource providers that need to
        obtain an extraction location, and only for names they intend to
        extract, as it tracks the generated names for possible cleanup later.
        z-tmpr)
rArdr�r�rI�_bypass_ensure_directory�	ExceptionrI�_warn_unsafe_extraction_pathr>)r�Zarchive_name�namesZextract_pathZtarget_pathrrr�get_cache_path�s


zResourceManager.get_cache_pathcCsVtjdkr|�tjd�sdSt�|�j}|tj@s>|tj@rRd|}t�	|t
�dS)aN
        If the default extraction path is overridden and set to an insecure
        location, such as /tmp, it opens up an opportunity for an attacker to
        replace an extracted file with an unauthorized payload. Warn the user
        if a known insecure location is used.

        See Distribute #375 for more details.
        �ntZwindirNz�%s is writable by group/others and vulnerable to attack when used with get_resource_filename. Consider a more secure location (set with .set_extraction_path or the PYTHON_EGG_CACHE environment variable).)r�r�r��environ�stat�st_mode�S_IWOTH�S_IWGRP�warnings�warn�UserWarning)r��mode�msgrrrrL�s
��z,ResourceManager._warn_unsafe_extraction_pathcCs.tjdkr*t�|�jdBd@}t�||�dS)a4Perform any platform-specific postprocessing of `tempname`

        This is where Mac header rewrites should be done; other platforms don't
        have anything special they should do.

        Resource providers should call this method ONLY after successfully
        extracting a compressed resource.  They must NOT call it on resources
        that are already in the filesystem.

        `tempname` is the current (temporary) name of the file, and `filename`
        is the name it will be renamed to by the caller after this routine
        returns.
        �posiximi�N)r�r�rQrR�chmod)r�Ztempname�filenamerXrrr�postprocess�s
zResourceManager.postprocesscCs|jrtd��||_dS)a�Set the base path where resources will be extracted to, if needed.

        If you do not call this routine before any extractions take place, the
        path defaults to the return value of ``get_default_cache()``.  (Which
        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
        platform-specific fallbacks.  See that routine's documentation for more
        details.)

        Resources are extracted to subdirectories of this path based upon
        information given by the ``IResourceProvider``.  You may set this to a
        temporary directory, but then you must call ``cleanup_resources()`` to
        delete the extracted files when done.  There is no guarantee that
        ``cleanup_resources()`` will be able to remove all extracted files.

        (Note: you may not change the extraction path for a given resource
        manager once resources have been extracted, unless you first call
        ``cleanup_resources()``.)
        z5Can't change extraction path, files already extractedN)r>rLrA�r�r�rrrrb�s
�z#ResourceManager.set_extraction_pathFcCsdS)aB
        Delete all extracted resource files and directories, returning a list
        of the file and directory names that could not be successfully removed.
        This function does not have any concurrency protection, so it should
        generally only be called when the extraction path is a temporary
        directory exclusive to a single process.  This method is not
        automatically called; you must call it explicitly or register it as an
        ``atexit`` function if you wish to ensure cleanup of a temporary
        directory used for extractions.
        Nr)r��forcerrrrcsz!ResourceManager.cleanup_resources)r)F)rrrrrAr�r\r]rZrYrXr[rIrN�staticmethodrLr]rbrcrrrrrges 

cCstj�d�ptjdd�S)z�
    Return the ``PYTHON_EGG_CACHE`` environment variable
    or a platform-relevant user cache dir for an app
    named "Python-Eggs".
    ZPYTHON_EGG_CACHEzPython-Eggs)Zappname)r�rPr�rZuser_cache_dirrrrrrds
�cCst�dd|�S)z�Convert an arbitrary string to a standard distribution name

    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
    �[^A-Za-z0-9.]+�-)�re�subr�rrrrq%scCsJzttj�|��WStjjk
rD|�dd�}t�dd|�YSXdS)zB
    Convert an arbitrary string to a standard version string
    r�rBrarbN)r�rrrr r�rcrd)rrrrrr-s
cCst�dd|���S)z�Convert an arbitrary string to a standard 'extra' name

    Any runs of non-alphanumeric characters are replaced with a single '_',
    and the result is always lowercased.
    z[^A-Za-z0-9.-]+r�)rcrdr.)r!rrrrw9scCs|�dd�S)z|Convert a project or version name to its filename-escaped form

    Any '-' characters are currently replaced with '_'.
    rbr�rr�rrrrxBsc
CsHzt|�Wn6tk
rB}zd|_d|_|WY�Sd}~XYnXdS)zo
    Validate text as a PEP 508 environment marker; return an exception
    if invalid or False otherwise.
    NF)rz�SyntaxErrorr\�lineno)�text�errrryJsc
CsJztj�|�}|��WStjjk
rD}zt|��W5d}~XYnXdS)z�
    Evaluate a PEP 508 environment marker.
    Return a boolean indicating the marker result in this environment.
    Raise SyntaxError if marker is invalid.

    This implementation uses the 'pyparsing' module.
    N)rZmarkersZMarkerr$Z
InvalidMarkerre)rgr!r#rhrrrrzXs

c@s�eZdZdZdZdZdZdd�Zdd�Zdd�Z	d	d
�Z
dd�Zd
d�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zed'd(��Zd)d*�ZdS)+r�zETry to implement resources and metadata for arbitrary PEP 302 loadersNcCs(t|dd�|_tj�t|dd��|_dS)Nr��__file__r�)r�r�r�r��dirname�module_path�r�r�rrrr�nszNullProvider.__init__cCs|�|j|�Sr)�_fnrk�r�r�r�rrrr�rsz"NullProvider.get_resource_filenamecCst�|�||��Sr)�io�BytesIOr�rnrrrr�usz NullProvider.get_resource_streamcCs|�|�|j|��Sr)�_getrmrkrnrrrr�xsz NullProvider.get_resource_stringcCs|�|�|j|��Sr)�_hasrmrk�r�r�rrrr�{szNullProvider.has_resourcecCs|�|j|�Sr)rm�egg_info�r�r�rrr�_get_metadata_path~szNullProvider._get_metadata_pathcCs |js|jS|�|�}|�|�Sr)rtrvrr�r�r�r�rrrr��s
zNullProvider.has_metadatac
Cst|js
dS|�|�}|�|�}tjr(|Sz|�d�WStk
rn}z|jd�||�7_�W5d}~XYnXdS)Nr��utf-8z in {} file at path: {})	rtrvrqr�PY2�decode�UnicodeDecodeError�reasonr�)r�r�r��value�excrrrr��s

zNullProvider.get_metadatacCst|�|��Sr�rur�rurrrr��szNullProvider.get_metadata_linescCs|�|�|j|��Sr)�_isdirrmrkrsrrrr]�szNullProvider.resource_isdircCs|jo|�|�|j|��Sr)rtr�rmrurrrr��szNullProvider.metadata_isdircCs|�|�|j|��Sr)�_listdirrmrkrsrrrr[�szNullProvider.resource_listdircCs|jr|�|�|j|��SgSr)rtr�rmrurrrr��szNullProvider.metadata_listdirc
Cs�d|}|�|�s$tdjft����|�|��dd�}|�dd�}|�|j|�}||d<tj	�
|�r�t|���}t
||d�}t|||�n>dd	lm}t|�d|�d�|f||<t
||d�}	t|	||�dS)
Nzscripts/z<Script {script!r} not found in metadata at {self.egg_info!r}z
�
�
ri�execr)�cache)r�rkr�r�r�r�rmrtr�r�r�r�read�compiler��	linecacher��lenr)
r�r�r�ZscriptZscript_textZscript_filename�source�coder�Zscript_coderrrrQ�s.
���zNullProvider.run_scriptcCstd��dS�Nz9Can't perform this operation for unregistered loader type��NotImplementedErrorr^rrrrr�s�zNullProvider._hascCstd��dSr�r�r^rrrr��s�zNullProvider._isdircCstd��dSr�r�r^rrrr��s�zNullProvider._listdircCs*|�|�|r&tjj|f|�d���S|S)N�/)�_validate_resource_pathr�r�rIr)r��baser�rrrrm�s
zNullProvider._fncCsptjj|�tj�kp&t�|�p&t�|�}|s0dSd}t�|�rPt�|�sPt|��t	j
|dd�dtdd�dS)aO
        Validate the resource paths according to the docs.
        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access

        >>> warned = getfixture('recwarn')
        >>> warnings.simplefilter('always')
        >>> vrp = NullProvider._validate_resource_path
        >>> vrp('foo/bar.txt')
        >>> bool(warned)
        False
        >>> vrp('../foo/bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('/foo/bar.txt')
        >>> bool(warned)
        True
        >>> vrp('foo/../../bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('foo/f../bar.txt')
        >>> bool(warned)
        False

        Windows path separators are straight-up disallowed.
        >>> vrp(r'\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        >>> vrp(r'C:\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        Blank values are allowed

        >>> vrp('')
        >>> bool(warned)
        False

        Non-string values are not.

        >>> vrp(None)
        Traceback (most recent call last):
        ...
        AttributeError: ...
        Nz=Use of .. or absolute path in a resource path is not allowed.r�z/ and will raise exceptions in a future release.r��
stacklevel)r�r��pardirr�	posixpath�sep�isabs�ntpathrLrUrV�DeprecationWarning)r�ZinvalidrYrrrr��s6���z$NullProvider._validate_resource_pathcCs$t|jd�r|j�|�Std��dS)N�get_dataz=Can't perform this operation for loaders without 'get_data()')r�r�r�r�r^rrrrqs
�zNullProvider._get)rrrr�egg_namertr�r�r�r�r�r�rvr�r�r�r]r�r[r�rQrrr�r�rmr`r�rqrrrrr�gs2
Jc@s eZdZdZdd�Zdd�ZdS)r�z&Provider based on a virtual filesystemcCst�||�|��dSr)r�r��
_setup_prefixrlrrrr�-szEggProvider.__init__cCsZ|j}d}||krVt|�r@tj�|�|_tj�|d�|_||_qV|}tj�	|�\}}q
dS)N�EGG-INFO)
rk�_is_egg_pathr�r��basenamer�rIrt�egg_rootr)r�r��oldr�rrrr�1szEggProvider._setup_prefixN)rrrrr�r�rrrrr�*sc@sDeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Ze	dd
��Z
dS)r�z6Provides access to package resources in the filesystemcCstj�|�Sr)r�r�r�r^rrrrrCszDefaultProvider._hascCstj�|�Sr)r�r�r
r^rrrr�FszDefaultProvider._isdircCs
t�|�Sr)r��listdirr^rrrr�IszDefaultProvider._listdircCst|�|j|�d�S�N�rb)rrmrkrnrrrr�Lsz#DefaultProvider.get_resource_streamc
Cs*t|d��}|��W5QR�SQRXdSr�)rr�)r�r��streamrrrrqOszDefaultProvider._getcCs,d}|D]}tt|td��}t||�qdS)N)�SourceFileLoader�SourcelessFileLoader)r��importlib_machinery�typer�)r�Zloader_namesr�Z
loader_clsrrr�	_registerSszDefaultProvider._registerN)rrrrrrr�r�r�rqr r�rrrrr�@sc@s8eZdZdZdZdd�ZZdd�Zdd�Zd	d
�Z	dS)r�z.Provider that returns nothing for all requestsNcCsdS�NFrr^rrrr?cr@zEmptyProvider.<lambda>cCsdS�Nr�rr^rrrrqeszEmptyProvider._getcCsgSrrr^rrrr�hszEmptyProvider._listdircCsdSrrr�rrrr�kszEmptyProvider.__init__)
rrrrrkr�rrrqr�r�rrrrr�^sc@s eZdZdZedd��ZeZdS)�ZipManifestsz
    zip manifest builder
    c
s@t�|��,��fdd����D�}t|�W5QR�SQRXdS)a
        Build a dictionary similar to the zipimport directory
        caches, except instead of tuples, store ZipInfo objects.

        Use a platform-specific path separator (os.sep) for the path keys
        for compatibility with pypy on Windows.
        c3s&|]}|�dtj���|�fVqdS)r�N)r�r�r�Zgetinfo�r�r��Zzfilerrr��s��z%ZipManifests.build.<locals>.<genexpr>N)�zipfileZZipFileZnamelistr')r�r�r+rr�r�buildws
	
�zZipManifests.buildN)rrrrr r��loadrrrrr�rs
r�c@s$eZdZdZe�dd�Zdd�ZdS)�MemoizedZipManifestsz%
    Memoized zipfile manifests.
    �manifest_modzmanifest mtimecCsRtj�|�}t�|�j}||ks.||j|krH|�|�}|�||�||<||jS)zW
        Load a manifest at path or return a suitable manifest already loaded.
        )	r�r��normpathrQ�st_mtime�mtimer�r��manifest)r�r�r�r�rrrr��s
zMemoizedZipManifests.loadN)rrrrr�
namedtupler�r�rrrrr��sr�c@s�eZdZdZdZe�Zdd�Zdd�Zdd�Z	e
d	d
��Zdd�Ze
d
d��Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �ZdS)!r�z"Resource support for zips and eggsNcCs t�||�|jjtj|_dSr)r�r�r��archiver�r��zip_prerlrrrr��szZipProvider.__init__cCsP|�tj�}||jjkrdS|�|j�r:|t|j�d�Std||jf��dS)Nr��%s is not a subpath of %s)	�rstripr�r�r�r�r�r�r��AssertionError�r��fspathrrr�
_zipinfo_name�s�zZipProvider._zipinfo_namecCsP|j|}|�|jtj�r:|t|j�dd��tj�Std||jf��dS)Nrr�)r�r�r�r�r�r�rr�)r��zip_pathr�rrr�_parts�s
�zZipProvider._partscCs|j�|jj�Sr)�_zip_manifestsr�r�r�r�rrr�zipinfo�szZipProvider.zipinfocCs\|jstd��|�|�}|��}d�|�|��|krP|D]}|�||�|��q8|�||�S)Nz5resource_filename() only supported for .egg, not .zipr�)r�r��_resource_to_zip�_get_eager_resourcesrIr��_extract_resource�
_eager_to_zip)r�r�r�r��eagersr�rrrr��s�
z!ZipProvider.get_resource_filenamecCs"|j}|jd}t�|�}||fS)N)rrr�)�	file_size�	date_time�time�mktime)Zzip_stat�sizer��	timestamprrr�_get_date_and_size�s

zZipProvider._get_date_and_sizec
Csx||��kr@|��|D]}|�|tj�||��}qtj�|�S|�|j|�\}}ts`t	d��z�|�
|j|�|��}|�
||�r�|WStdtj�|�d�\}}	t�||j�|��t�|�t|	||f�|�|	|�zt|	|�Wnhtjk
�rNtj�|��rH|�
||��r |YWStjdk�rHt|�t|	|�|YWS�YnXWn tjk
�rr|��YnX|S)Nz>"os.rename" and "os.unlink" are not supported on this platformz	.$extract)�dirrO)�_indexr�r�r�rIrjr�r��
WRITE_SUPPORT�IOErrorrNr�r��_is_current�_mkstemp�writer�r��closerr]r
�error�isfiler�rrI)
r�r�r�r�Zlastr�r�Z	real_pathZoutfZtmpnamrrrr��sN��
�




zZipProvider._extract_resourcec		Csx|�|j|�\}}tj�|�s$dSt�|�}|j|ksB|j|krFdS|j�	|�}t
|d��}|��}W5QRX||kS)zK
        Return True if the file_path is current for this zip_path
        Fr�)r�r�r�r�r�rQ�st_sizer�r�r�rr�)	r�Z	file_pathr�r�r�rQZzip_contents�fZ
file_contentsrrrr�s
zZipProvider._is_currentcCs>|jdkr8g}dD]}|�|�r|�|�|��q||_|jS)N)znative_libs.txtzeager_resources.txt)r�r�rr�)r�r�r�rrrr�"s

z ZipProvider._get_eager_resourcesc	Cs�z|jWStk
r�i}|jD]V}|�tj�}|r"tj�|dd��}||krh||�|d�q"q2|��g||<q2q"||_|YSXdS)Nr�)	Z	_dirindex�AttributeErrorr�rr�r�rIr�r)r�Zindr��parts�parentrrrr�+s
zZipProvider._indexcCs |�|�}||jkp||��kSr)r�r�r�)r�r�r�rrrrr<s
zZipProvider._hascCs|�|�|��kSr)r�r�r�rrrr�@szZipProvider._isdircCst|���|�|�d��S�Nr)rr�r�r�r�rrrr�CszZipProvider._listdircCs|�|�|j|��Sr)r�rmr�rsrrrr�FszZipProvider._eager_to_zipcCs|�|�|j|��Sr)r�rmrkrsrrrr�IszZipProvider._resource_to_zip)rrrrr�r�r�r�r�r�r�r�r�r`r�r�r�r�r�rrr�r�r�r�rrrrr��s(



7	c@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�a*Metadata handler for standalone PKG-INFO files

    Usage::

        metadata = FileMetadata("/path/to/PKG-INFO")

    This provider rejects all data and metadata requests except for PKG-INFO,
    which is treated as existing, and will be the contents of the file at
    the provided location.
    cCs
||_dSr�r�r^rrrr�\szFileMetadata.__init__cCs|jSrr�rurrrrv_szFileMetadata._get_metadata_pathcCs|dkotj�|j�S)N�PKG-INFO)r�r�r�rurrrr�bszFileMetadata.has_metadatac	CsD|dkrtd��tj|jddd��}|��}W5QRX|�|�|S)Nr�z(No metadata except PKG-INFO is availablerxr�)�encoding�errors)r�rorr�r��_warn_on_replacement)r�r�r��metadatarrrr�es
zFileMetadata.get_metadatacCs2d�d�}||kr.d}|jft��}t�|�dS)Ns�rxz2{self.path} could not be properly decoded in UTF-8)rzr�r�rUrV)r�r�Zreplacement_charrGrYrrrr�ns

z!FileMetadata._warn_on_replacementcCst|�|��Srrrurrrr�vszFileMetadata.get_metadata_linesN)
rrrrr�rvr�r�r�r�rrrrr�Ps	c@seZdZdZdd�ZdS)r�asMetadata provider for egg directories

    Usage::

        # Development eggs:

        egg_info = "/path/to/PackageName.egg-info"
        base_dir = os.path.dirname(egg_info)
        metadata = PathMetadata(base_dir, egg_info)
        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)

        # Unpacked egg directories:

        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
        dist = Distribution.from_filename(egg_path, metadata=metadata)
    cCs||_||_dSr)rkrt)r�r�rtrrrr��szPathMetadata.__init__N�rrrrr�rrrrr�zsc@seZdZdZdd�ZdS)r�z Metadata provider for .egg filescCsD|jtj|_||_|jr0tj�|j|j�|_n|j|_|�	�dS)z-Create a metadata provider from a zipimporterN)
r�r�r�r�r��prefixr�rIrkr�)r��importerrrrr��szEggMetadata.__init__Nr�rrrrr��sr'��_distribution_finderscCs|t|<dS)axRegister `distribution_finder` to find distributions in sys.path items

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `distribution_finder` is a callable that, passed a path
    item and the importer instance, yields ``Distribution`` instances found on
    that path item.  See ``pkg_resources.find_on_path`` for an example.Nr�)�
importer_typeZdistribution_finderrrrr��scCst|�}tt|�}||||�S)z.Yield distributions accessible via `path_item`)rr�r�)�	path_item�onlyr��finderrrrra�s
c	cs�|j�d�rdSt|�}|�d�r2tj||d�V|r:dS|�d�D]|}t|�r�tj	�
||�}tt�
|�|�}|D]
}|VqrqD|���d�rDtj	�
||�}tt�
|��}||_t�|||�VqDdS)z@
    Find eggs in zip files; possibly multiple nested eggs.
    z.whlNr��r�r��
.dist-info)r��endswithr�r�rh�
from_filenamer[r�r�r�rI�find_eggs_in_zip�	zipimport�zipimporterr.rt�
from_location)	r�r�r�r�Zsubitem�subpathr�r�Zsubmetarrrr��s$

r�cCsdSr�r)r�r�r�rrr�find_nothing�sr�cCsdd�}t||dd�S)aL
    Given a list of filenames, return them in descending order
    by version number.

    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
    >>> _by_version_descending(names)
    ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg']
    cSs2tj�|�\}}t�|�d�|g�}dd�|D�S)z6
        Parse each component of the filename
        rbcSsg|]}tj�|��qSr)rrr�)r��partrrr�
<listcomp>�sz?_by_version_descending.<locals>._by_version.<locals>.<listcomp>)r�r��splitext�	itertools�chainr)r��extr�rrr�_by_version�sz+_by_version_descending.<locals>._by_versionTr1)�sorted)rMrrrr�_by_version_descending�src
#s�t���t��r4tj�t�tj��d��d�VdSt��}��fdd�|D�}t	|�}|D]2}tj��|�}t
�|��}||�D]
}	|	Vq�q\dS)z6Yield distributions accessible on a sys.path directoryr�r�Nc3s|]}t�|��r|VqdSr)�dist_factory)r�r��r�r�rrr�s�zfind_on_path.<locals>.<genexpr>)�_normalize_cached�_is_unpacked_eggrhr�r�r�r�rI�safe_listdirrr)
r�r�r�r�ZfilteredZpath_item_entriesr��fullpath�factoryr�rrr�find_on_path�s(���rcCsH|��}tt|jd��}|r tS|s0t|�r0tS|sB|�d�rBtSt�S)z9
    Return a dist_factory for a path_item and entry
    )�	.egg-infor�z	.egg-link)	r.r&rr��distributions_from_metadatar�ra�resolve_egg_link�NoDists)r�r�r�r.Zis_metarrrrs������rc@s*eZdZdZdd�ZejreZdd�ZdS)rzS
    >>> bool(NoDists())
    False

    >>> list(NoDists()('anything'))
    []
    cCsdSr�rr�rrr�__bool__.szNoDists.__bool__cCstd�Sr�)�iter)r�r	rrr�__call__3szNoDists.__call__N)	rrrrrrryZ__nonzero__rrrrrr&s
rc
Csvzt�|�WSttfk
r$YnNtk
rp}z0|jtjtjtjfkpXt	|dd�dk}|s`�W5d}~XYnXdS)zI
    Attempt to list contents of path, but suppress some exceptions.
    ZwinerrorNir)
r�r��PermissionError�NotADirectoryError�OSError�errnoZENOTDIRZEACCESZENOENTr�)r�rhZ	ignorablerrrr7s�rccsftj�|�}tj�|�r:tt�|��dkr.dSt||�}nt|�}tj�|�}t	j
|||td�VdS)Nr)�
precedence)r�r�rjr
r�r�r�r�r�rhr�r�)r��rootr�r�rrrr
Ls�r
c	cs4t|��"}|D]}|��}|r|VqW5QRXdS)z1
    Yield non-empty lines from file at path
    N)r�strip)r�r��linerrr�non_empty_lines[s

rcs.t��}�fdd�|D�}tt|�}t|d�S)za
    Given a path to an .egg-link, resolve distributions
    present in the referenced path.
    c3s$|]}tj�tj���|�VqdSr)r�r�rIrj)r��refr�rrr�ls�z#resolve_egg_link.<locals>.<genexpr>r)rrra�next)r�Zreferenced_pathsZresolved_pathsZdist_groupsrr�rrfs
�
r�
FileFinder��_namespace_handlers)�_namespace_packagescCs|t|<dS)a�Register `namespace_handler` to declare namespace packages

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `namespace_handler` is a callable like this::

        def namespace_handler(importer, path_entry, moduleName, module):
            # return a path_entry to use for child packages

    Namespace handlers are only called if the importer object has already
    agreed that it can handle the relevant path item, and they should only
    return a subpath if the module __path__ does not already contain an
    equivalent subpath.  For an example namespace handler, see
    ``pkg_resources.file_ns_handler``.
    Nr)r�Znamespace_handlerrrrr�}sc	Cs�t|�}|dkrdSt���t�d�|�|�}W5QRX|dkrHdStj�|�}|dkr�t�	|�}tj|<g|_
t|�nt|d�s�t
d|��tt|�}|||||�}|dk	r�|j
}|�|�|�|�t|||�|S)zEEnsure that named package includes a subpath of path_item (if needed)N�ignore�__path__�Not a package:)rrU�catch_warnings�simplefilter�find_modulerGr�r��types�
ModuleTyper#�_set_parent_nsr�r�r�r r��load_module�_rebuild_mod_path)�packageNamer�r�r�r�Zhandlerr�r�rrr�
_handle_ns�s.







r.csjdd�tjD���fdd����fdd�}t||d�}dd�|D�}t|jt�r`||jd	d	�<n||_d	S)
zq
    Rebuild module.__path__ ensuring that all entries are ordered
    corresponding to their sys.path order
    cSsg|]}t|��qSr�r�r��prrrr��sz%_rebuild_mod_path.<locals>.<listcomp>cs.z��|�WStk
r(td�YSXdS)z/
        Workaround for #520 and #513.
        �infN)�indexrL�float)r�)�sys_pathrr�safe_sys_path_index�sz._rebuild_mod_path.<locals>.safe_sys_path_indexcs<|�tj�}��d�d}|d|�}�ttj�|���S)zR
        Return the ordinal of the path based on its position in sys.path
        rBrN)rr�r��countrrI)r��
path_partsZmodule_partsr�)�package_namer6rr�position_in_sys_path�sz/_rebuild_mod_path.<locals>.position_in_sys_path)r8cSsg|]}t|��qSrr/r0rrrr��sN)rGr�rr�r#r)�	orig_pathr9r�r:�new_pathr)r9r6r5rr,�s		r,cCs�t��z�|tkrW��dStj}|�d�\}}}|r|t|�|tkrLt|�ztj	|j
}Wntk
rztd|��YnXt�
|p�dg��|�t�
|g�|D]}t||�q�W5t��XdS)z9Declare that package 'packageName' is a namespace packageNrBr$)�_imp�acquire_lock�release_lockr!rGr��
rpartitionr^r�r�r#r�r�r�r�r.)r-r�r�r�r�rrrr^�s&cCsFt��z.t�|d�D]}t||�}|rt||�qW5t��XdS)zDEnsure that previously-declared namespace packages include path_itemrN)r=r>r?r!r�r.r�)r�r��packager�rrrr��s
cCsDtj�||�d�d�}t|�}|jD]}t|�|kr&q@q&|SdS)zBCompute an ns-package subpath for a filesystem or zipfile importerrBr�N)r�r�rIrrr#)r�r�r-r�r�Z
normalizedrrrr�file_ns_handler�s
rBcCsdSrr)r�r�r-r�rrr�null_ns_handler	srCcCs tj�tj�tj�t|����S)z1Normalize a file/dir name for comparison purposes)r�r��normcase�realpathr��
_cygwin_patch�r\rrrr|	scCstjdkrtj�|�S|S)a
    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
    symlink components. Using
    os.path.abspath() works around this limitation. A fix in os.getcwd()
    would probably better, in Cygwin even more so, except
    that this seems to be by design...
    �cygwin)rGrHr�r��abspathrGrrrrF	srFcCs8z
||WStk
r2t|�||<}|YSXdSr)r�r|)r\r��resultrrrr)	s

rcCs|���d�S)z7
    Determine if given path appears to be an egg.
    �.egg)r.r�r�rrrr�1	sr�cCs t|�otj�tj�|dd��S)z@
    Determine if given path appears to be an unpacked egg.
    r�r�)r�r�r�r�rIr�rrrr8	s�rcCs<|�d�}|��}|r8d�|�}ttj||tj|�dS)NrB)rrrI�setattrrGr�)r-r�r�r�rrrr*B	s


r*ccsZt|tj�r8|��D] }|��}|r|�d�s|Vqn|D]}t|�D]
}|VqHq<dS)z9Yield non-empty/non-comment lines of a string or sequence�#N)r�rr��
splitlinesrr�ru)�strs�sZssrrrruJ	s
z\w+(\.\w+)*$z�
    (?P<name>[^-]+) (
        -(?P<ver>[^-]+) (
            -py(?P<pyver>[^-]+) (
                -(?P<plat>.+)
            )?
        )?
    )?
    c@s�eZdZdZddd�Zdd�Zdd	�Zddd�Zd
d�Zddd�Z	e
�d�Ze
ddd��Ze
dd��Ze
ddd��Ze
ddd��ZdS) rjz3Object representing an advertised importable objectrNcCs<t|�std|��||_||_t|�|_t|�|_||_dS)NzInvalid module name)�MODULErLr��module_name�tuple�attrsrr�)r�r�rRrTrr�rrrr�j	s


zEntryPoint.__init__cCsHd|j|jf}|jr*|dd�|j�7}|jrD|dd�|j�7}|S)Nz%s = %s�:rBz [%s]�,)r�rRrTrIr)r�rPrrrr�s	szEntryPoint.__str__cCsdt|�S)NzEntryPoint.parse(%r)�r�r�rrrr�{	szEntryPoint.__repr__TcOs4|r|s|rtjdtdd�|r,|j||�|��S)zH
        Require packages for this EntryPoint, then resolve it.
        zJParameters to load are deprecated.  Call .resolve and .require separately.rCr�)rUrVr�rPr�)r�rPr>�kwargsrrrr�~	s�zEntryPoint.loadc
CsXt|jdgdd�}zt�t|j|�WStk
rR}ztt|���W5d}~XYnXdS)zD
        Resolve the entry point from its module and attrs.
        rr)�fromlist�levelN)	r�rR�	functools�reducer�rTr�r�r�)r�r�r~rrrr��	s
zEntryPoint.resolvecCsL|jr|jstd|��|j�|j�}tj||||jd�}tttj|��dS)Nz&Can't require() without a distribution)r)	rr�rnrr_r�rrr�)r�rrr�r+rrrrP�	s

zEntryPoint.requirez]\s*(?P<name>.+?)\s*=\s*(?P<module>[\w.]+)\s*(:\s*(?P<attr>[\w.]+))?\s*(?P<extras>\[.*\])?\s*$cCsf|j�|�}|sd}t||��|��}|�|d�}|drJ|d�d�nd}||d|d|||�S)aParse a single entry point from string `src`

        Entry point syntax follows the form::

            name = some.module:some.attr [extra1, extra2]

        The entry name and module name are required, but the ``:attrs`` and
        ``[extras]`` parts are optional
        z9EntryPoint must be in 'name=module:attrs [extras]' formatr�attrrBrr�r�)�patternrFrL�	groupdict�
_parse_extrasr)r��srcr�rNrY�resrrTrrrr��	s
zEntryPoint.parsecCs(|sdSt�d|�}|jr"t��|jS)Nr�x)rir��specsrLr)r�Zextras_specr�rrrr`�	szEntryPoint._parse_extrascCsVt|�std|��i}t|�D]2}|�||�}|j|krFtd||j��|||j<q|S)zParse an entry point groupzInvalid group namezDuplicate entry point)rQrLrur�r�)r�rK�linesr��thisr�eprrr�parse_group�	s

zEntryPoint.parse_groupcCstt|t�r|��}nt|�}i}|D]J\}}|dkrB|s:q$td��|��}||kr\td|��|�|||�||<q$|S)z!Parse a map of entry point groupsNz%Entry points must be listed in groupszDuplicate group name)r�r'r+rvrLrrh)r��datar��mapsrKrerrr�	parse_map�	s


zEntryPoint.parse_map)rrN)T)NN)N)N)N)rrrrr�r�r�r�r�rPrcr�r^r r�r`rhrkrrrrrjg	s$
	



�	
cCs>|sdStj�|�}|d�d�r:tj�|dd�d�S|S)Nr�r�zmd5=)r�)rr�Zurlparser�Z
urlunparse)rZparsedrrr�_remove_md5_fragment�	srlcCs@dd�}t||�}tt|�d�}|�d�\}}}t|���p>dS)z�
    Given an iterable of lines from a Metadata file, return
    the value of the Version field, if present, or None otherwise.
    cSs|���d�S)Nzversion:)r.r�)rrrr�is_version_line�	sz+_version_from_file.<locals>.is_version_liner�rUN)rrr�	partitionrrr)rermZ
version_linesrr�r}rrr�_version_from_file�	s

rocs�eZdZdZdZddddedefdd�ZedSdd��Z	dd	�Z
ed
d��Zdd
�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zedd��Zedd��Zdd�Zed d!��Zed"d#��Zed$d%��Zd&d'�ZdTd)d*�Zd+d,�Zd-d.�Zd/d0�ZdUd2d3�Z d4d5�Z!d6d7�Z"d8d9�Z#d:d;�Z$�fd<d=�Z%e&e'd>��s4[%edVd?d@��Z(dAdB�Z)dCdD�Z*dWdEdF�Z+dGdH�Z,dXdIdJ�Z-dKdL�Z.dMdN�Z/dOdP�Z0edQdR��Z1�Z2S)Yrhz5Wrap an actual or potential sys.path entry w/metadatar�NcCsFt|pd�|_|dk	r t|�|_||_||_||_||_|p>t|_	dS)NZUnknown)
rqrrr�_versionr+rHrrr��	_provider)r�rr�rrr+rHrrrrr�
s
zDistribution.__init__cKs~dgd\}}}}tj�|�\}}	|	��tkr^t|	��}t|�}
|
r^|
�dddd�\}}}}|||f||||d�|����S)Nrr�ZverZpyverrM)rrr+rH)r�r�r�r.�_distributionImpl�EGG_NAMErK�_reload_version)r�rr�r�r)rrr+rHrrFrrrr�
s.����zDistribution.from_locationcCs|Srrr�rrrrt#
szDistribution._reload_versioncCs(|j|j|jt|j�|jpd|jp$dfSr�)�parsed_versionrr8rlrr+rHr�rrrr0&
s�zDistribution.hashcmpcCs
t|j�Sr)�hashr0r�rrr�__hash__1
szDistribution.__hash__cCs|j|jkSr�r0�r�r8rrr�__lt__4
szDistribution.__lt__cCs|j|jkSrrxryrrr�__le__7
szDistribution.__le__cCs|j|jkSrrxryrrr�__gt__:
szDistribution.__gt__cCs|j|jkSrrxryrrr�__ge__=
szDistribution.__ge__cCst||j�sdS|j|jkSr�)r�r�r0ryrrr�__eq__@
szDistribution.__eq__cCs
||kSrrryrrr�__ne__F
szDistribution.__ne__cCs6z|jWStk
r0|j��|_}|YSXdSr)Z_keyr�rr.r7rrrr8M
s
zDistribution.keycCst|d�st|j�|_|jS)N�_parsed_version)r�r#rr�r�rrrruU
s
zDistribution.parsed_versioncCsXtjj}t|j|�}|sdS|js&dSt�d����dd�}t	�
|jft|��t
�dS)Na>
            '{project_name} ({version})' is being parsed as a legacy,
            non PEP 440,
            version. You may find odd behavior and sort order.
            In particular it will be sorted as less than 0.0. It
            is recommended to migrate to PEP 440 compatible
            versions.
            r�r�)rrr!r�r�rBrCrr�rUrVr��varsr)r�ZLVZ	is_legacyrGrrr�_warn_legacy_version\
s�	z!Distribution._warn_legacy_versioncCsZz|jWStk
rT|��}|dkrL|�|j�}d�|j|�}t||��|YSXdS)Nz4Missing 'Version:' header and/or {} file at path: {})rpr��_get_version�_get_metadata_path_for_display�PKG_INFOr�rL)r�rr�rYrrrrv
s��
zDistribution.versioncCs4z|jWStk
r,|�|���|_YnX|jS)z~
        A map of extra to its list of (direct) requirements
        for this distribution, including the null extra.
        )Z_Distribution__dep_mapr��_filter_extras�_build_dep_mapr�rrr�_dep_map�
s
zDistribution._dep_mapcCsrttd|��D]^}|}|�|�}|�d�\}}}|oDt|�pDt|�}|rNg}t|�pXd}|�|g��|�q|S)z�
        Given a mapping of extras to dependencies, strip off
        environment markers and filter out any dependencies
        not matching the markers.
        NrU)	rrrrnryrzrwr�r)�dmr!Z	new_extrar�r�r#Zfails_markerrrrr��
s
�zDistribution._filter_extrascCs@i}dD]2}t|�|��D]\}}|�|g��t|��qq|S)N)zrequires.txtzdepends.txt)rv�
_get_metadatar�rrp)r�r�r�r!r�rrrr��
s
zDistribution._build_dep_maprc	Csf|j}g}|�|�dd��|D]@}z|�|t|��Wq tk
r^td||f��Yq Xq |S)z@List of Requirements needed for this distro if `extras` are usedNrz%s has no such extra feature %r)r�rr�rwr�rn)r�rr�Zdepsrrrrr�
s
�zDistribution.requirescCs,z|j�|�}Wntk
r&YdSX|S)zK
        Return the path to the given metadata file, if available.
        z[could not detect])rqrvrKrwrrrr��
s
z+Distribution._get_metadata_path_for_displayccs$|�|�r |�|�D]
}|VqdSr)r�r�)r�r�rrrrr��
s
zDistribution._get_metadatacCs|�|j�}t|�}|Sr)r�r�ro)r�rerrrrr��
szDistribution._get_versionFcCsV|dkrtj}|j||d�|tjkrRt|j�|�d�D]}|tjkr:t|�q:dS)z>Ensure distribution is importable on `path` (default=sys.path)Nr�namespace_packages.txt)rGr�rr�rr�r�r^)r�r�r�Zpkgrrr�activate�
s


zDistribution.activatecCs8dt|j�t|j�|jptf}|jr4|d|j7}|S)z@Return what this distribution's standard .egg filename should bez
%s-%s-py%srb)rxrrr+r=rH)r�r\rrrr��
s�zDistribution.egg_namecCs |jrd||jfSt|�SdS)Nz%s (%s))rr�r�rrrr��
szDistribution.__repr__cCs@zt|dd�}Wntk
r(d}YnX|p0d}d|j|fS)Nrz[unknown version]z%s %s)r�rLr)r�rrrrr��
s
zDistribution.__str__cCs|�d�rt|��t|j|�S)zADelegate all unrecognized public attributes to .metadata providerr�)r�r�r�rq)r�r]rrr�__getattr__�
s
zDistribution.__getattr__cs.tttt|����tdd�|j��D��B�S)Ncss|]}|�d�s|VqdS�r�N)r�)r�r]rrrr�s
�z'Distribution.__dir__.<locals>.<genexpr>)rr�superrh�__dir__rqr�r:rrr�s���zDistribution.__dir__r�cKs|jt|�tj�|�|f|�Sr)r�rr�r�r�)r�r\r�r)rrrr�s
��zDistribution.from_filenamecCs<t|jtjj�r"d|j|jf}nd|j|jf}t�|�S)z?Return a ``Requirement`` that matches this distribution exactlyz%s==%sz%s===%s)r�rurrrrrir�)r��specrrrrszDistribution.as_requirementcCs.|�||�}|dkr&td||ff��|��S)z=Return the `name` entry point of `group` or raise ImportErrorNzEntry point %r not found)rVr�r�)r�rKr�rgrrrrTszDistribution.load_entry_pointcCsPz
|j}Wn,tk
r6t�|�d�|�}|_YnX|dk	rL|�|i�S|S)r�zentry_points.txtN)Z_ep_mapr�rjrkr�r�)r�rKZep_maprrrrU&s
�zDistribution.get_entry_mapcCs|�|��|�Sr�)rUr�rrrrrV2szDistribution.get_entry_infoc
Cs4|p|j}|sdSt|�}tj�|�}dd�|D�}t|�D]|\}}||kr^|rVq�q�dSq<||kr<|jtkr<|s�|||d�kr�dS|tjkr�|�	�|�
||�|�
||�q�q<|tjkr�|�	�|r�|�
d|�n
|�|�dSz|�||d�}	Wnt
k
�rY�q0Yq�X||	=||	=|	}q�dS)a�Ensure self.location is on path

        If replace=False (default):
            - If location is already in path anywhere, do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent.
              - Else: add to the end of path.
        If replace=True:
            - If location is already on path anywhere (not eggs)
              or higher priority than its parent (eggs)
              do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent,
                removing any lower-priority entries.
              - Else: add it to the front of path.
        NcSsg|]}|rt|�p|�qSrr/r0rrrr�Psz*Distribution.insert_on.<locals>.<listcomp>rr)rrr�r�rj�	enumeraterr}rG�check_version_conflictr	r�r3rL)
r�r��locr�ZnlocZbdirZnpathr1rZnprrrr6s@



zDistribution.insert_oncCs�|jdkrdSt�|�d��}t|j�}|�d�D]p}|tjks2||ks2|tkrRq2|dkr\q2t	tj|dd�}|r�t|��
|�s2|�
|j�r�q2td|||jf�q2dS)N�
setuptoolsr�z
top_level.txt)Z
pkg_resourcesr�ZsiterizIModule %s was already imported from %s, but %s is being added to sys.path)r8r'r(r�r|rrGr�r!r�r��
issue_warning)r�Znspr��modname�fnrrrr�zs*

�
�
��z#Distribution.check_version_conflictcCs6z
|jWn&tk
r0tdt|��YdSXdS)NzUnbuilt egg for FT)rrLr�r�r�rrrr3�s
zDistribution.has_versioncKs@d}|��D]}|�|t||d��q|�d|j�|jf|�S)z@Copy this distribution, substituting in any changed keyword argsz<project_name version py_version platform location precedenceNr�)rr�r�rqr�)r�r)rMr]rrr�clone�s
zDistribution.clonecCsdd�|jD�S)NcSsg|]}|r|�qSrr)r�Zdeprrrr��sz'Distribution.extras.<locals>.<listcomp>)r�r�rrrr�szDistribution.extras)N)r)NF)N)N)NF)3rrrrr�r=r}r�r r�rtr�r0rwrzr{r|r}r~rr8rur�rr�r`r�r�rr�r�r�r�r�r�r�r�r�r��objectr�rrTrUrVrr�r3r�r�
__classcell__rrr:rrh
st�










		

Dc@seZdZdd�ZdS)�EggInfoDistributioncCs|��}|r||_|S)a�
        Packages installed by distutils (e.g. numpy or scipy),
        which uses an old safe_version, and so
        their version numbers can get mangled when
        converted to filenames (e.g., 1.11.0.dev0+2329eae to
        1.11.0.dev0_2329eae). These distributions will not be
        parsed properly
        downstream by Distribution and safe_version, so
        take an extra step and try to get the version number from
        the metadata file itself instead of the filename.
        )r�rp)r�Z
md_versionrrrrt�sz#EggInfoDistribution._reload_versionN)rrrrtrrrrr��sr�c@s>eZdZdZdZe�d�Zedd��Z	edd��Z
dd	�Zd
S)�DistInfoDistributionzV
    Wrap an actual or potential sys.path entry
    w/metadata, .dist-info style.
    ZMETADATAz([\(,])\s*(\d.*?)\s*([,\)])cCsFz|jWStk
r@|�|j�}tj���|�|_|jYSXdS)zParse and cache metadataN)Z	_pkg_infor�r�r��email�parserZParserZparsestr)r�r�rrr�_parsed_pkg_info�sz%DistInfoDistribution._parsed_pkg_infocCs2z|jWStk
r,|��|_|jYSXdSr)�_DistInfoDistribution__dep_mapr��_compute_dependenciesr�rrrr��s

zDistInfoDistribution._dep_mapcs�dgi}|_g�|j�d�p gD]}��t|��q"�fdd�}t|d��}|d�|�|j�d�pjgD](}t|���}tt||��|�||<ql|S)z+Recompute this distribution's dependencies.Nz
Requires-Distc3s*�D] }|jr|j�d|i�r|VqdS)Nr!r")r!r��r�rr�reqs_for_extra�szBDistInfoDistribution._compute_dependencies.<locals>.reqs_for_extrazProvides-Extra)	r�r�Zget_allrrp�	frozensetrwrr)r�r�r�r��commonr!Zs_extrarr�rr��sz*DistInfoDistribution._compute_dependenciesN)rrrrr�rcr�ZEQEQr�r�r�r�rrrrr��s

	
r�)rKrr�cOsZd}t�}zt�|�j|kr&|d7}qWntk
r<YnXtj|d|di|��dS)Nrr�)r$rGr�r�rLrUrV)r>r)rZr.rrrr��sr�c@seZdZdd�ZdS)�RequirementParseErrorcCsd�|j�S)Nr�)rIr>r�rrrr��szRequirementParseError.__str__N)rrrr�rrrrr��sr�c	cs�tt|��}|D]l}d|kr.|d|�d��}|�d�rr|dd���}z|t|�7}Wntk
rpYdSXt|�VqdS)z�Yield ``Requirement`` objects for each specification in `strs`

    `strs` must be a string, or a (possibly-nested) iterable thereof.
    z #N�\���)rrur�r�rr�
StopIterationri)rOrerrrrrps

csPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Ze	d
d��Z
�ZS)ric
s�ztt|��|�Wn2tjjk
rF}ztt|���W5d}~XYnX|j|_	t
|j�}||��|_|_
dd�|jD�|_ttt|j��|_|j
|jt|j�|jr�t|j�ndf|_t|j�|_dS)z>DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!NcSsg|]}|j|jf�qSr)r4r)r�r�rrrr�#sz(Requirement.__init__.<locals>.<listcomp>)r�rir�rrZInvalidRequirementr�r�r�Zunsafe_namerqr.rr8�	specifierrdrSrrwrr�r#�hashCmprv�_Requirement__hash)r�Zrequirement_stringrhrr:rrr�s"
��zRequirement.__init__cCst|t�o|j|jkSr)r�rir�ryrrrr~.s

�zRequirement.__eq__cCs
||kSrrryrrrr4szRequirement.__ne__cCs0t|t�r |j|jkrdS|j}|jj|dd�S)NFT)Zprereleases)r�rhr8rr��contains)r�rrrrr�7s

zRequirement.__contains__cCs|jSr)r�r�rrrrwCszRequirement.__hash__cCsdt|�S)NzRequirement.parse(%r)rWr�rrrr�FszRequirement.__repr__cCst|�\}|Sr)rp)rPr�rrrr�Is
zRequirement.parse)rrrr�r~rr�rwr�r`r�r�rrr:rriscCst|kr|tfS|S)zJ
    Ensure object appears in the mro even
    for old-style classes.
    )r�)�classesrrr�_always_objectOs
r�cCs<tt�t|dt|����}|D]}||kr||SqdS)z2Return an adapter factory for `ob` from `registry`r�N)r��inspectZgetmror�r�)�registryr9r(�trrrr�Ysr�cCstj�|�}tj|dd�dS)z1Ensure that the parent directory of `path` existsT)�exist_okN)r�r�rjr�makedirs)r�rjrrrr{ascCsXtstd��t|�\}}|rT|rTt|�sTt|�zt|d�Wntk
rRYnXdS)z/Sandbox-bypassing version of ensure_directory()z*"os.mkdir" not supported on this platform.i�N)r�r�rr
rJr	�FileExistsError)r�rjr\rrrrJgsrJccsvd}g}t|�D]V}|�d�r\|�d�rP|s0|r:||fV|dd���}g}qftd|��q|�|�q||fVdS)asSplit a string or iterable thereof into (section, content) pairs

    Each ``section`` is a stripped version of the section header ("[section]")
    and each ``content`` is a list of stripped lines excluding blank lines and
    comment-only lines.  If there are any such lines before the first section
    header, they're returned in a first ``section`` of ``None``.
    N�[�]rr�zInvalid section heading)rur�r�rrLr�)rPZsectionZcontentrrrrrvts


cOs*tj}ztt_tj||�W�S|t_XdSr)r�r�os_open�tempfileZmkstemp)r>r)Zold_openrrrr��s
r�r")�categoryr�cOs|||�|Srr)r�r>rXrrr�_call_aside�s
r�cs.t���|d<|��fdd�t��D��dS)z=Set up global resource manager (deliberately not state-saved)Z_managerc3s&|]}|�d�s|t�|�fVqdSr�)r�r�r��r�rrr��s
�z_initialize.<locals>.<genexpr>N)rgr%r�)r.rr�r�_initialize�s
�r�cCs|t��}td|d�|j}|j}|j}|j}|}tdd�|D��|dd�dd�g|_t	t
|jtj
��t��t��d	S)
aE
    Prepare the master working set and make the ``require()``
    API available.

    This function has explicit effects on the global state
    of pkg_resources. It is intended to be invoked once at
    the initialization of this module.

    Invocation by other packages is unsupported and done
    at their own risk.
    r�)r_css|]}|jdd�VqdS)FrN�r�)r�r�rrrr��s�z1_initialize_master_working_set.<locals>.<genexpr>cSs|jdd�S)NTrr�r�rrrr?�r@z0_initialize_master_working_set.<locals>.<lambda>F)rN)rfr�r*rPrWrrQrSr�rrr�rGr�r$r%r�)r_rPrWr`rQr�rrr�_initialize_master_working_set�s"
��r�c@seZdZdZdS)r�z�
    Base class for warning about deprecations in ``pkg_resources``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    Nrrrrrr��s)N)N)F)F)F)F)N)�rZ
__future__rrGr�ror�rcr(r�r�rUrQr[Zpkgutilr4rHrr�Zemail.parserr�rr�rBr�r�r�r�rr=r�Zimpr��	NameErrorrZpip._vendorrZpip._vendor.six.movesrrrrr	r
rr�rr�Zos.pathr
rZimportlib.machinery�	machineryr�rr�rrrr�r�Z
__metaclass__�version_info�RuntimeErrorryrrrPr_r`Zresources_streamrcZresource_dirrYrbr]rXrWr[rZr\r�r r!�RuntimeWarningrr#r&r*r0r1r5r:r;r<Z
_sget_noneZ
_sset_nonerO�__all__rKrkrlr�rmrnr�rr=r}r~rr�r�r�rRrJr�rDr�rEr�rsrtrQr�rSrTrUrVr�r�rfr'r
rer�rorgrdrqrrrwrxryrzr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rar�r�rrrrrr
rrZImpImporterr�rr�r.r,r^r�rBrCr|rFrr�rr*rurFrQ�VERBOSE�
IGNORECASErsrjrlrorhr�r�rrr�rLr�rprrir�r�r{rJrvr��filterwarningsr�r$r�r��Warningr�rrrr�<module>sZ



�2 




.

5	A
-*

 ""


	
�	
'3�
6


&site-packages/pip/_vendor/pkg_resources/__pycache__/py31compat.cpython-38.opt-1.pyc000064400000001144151446177000024167 0ustar00U

��.e2�@s`ddlZddlZddlZddlmZddd�ZejpLdejkoHdknZerVenej	Z	dS)	�N)�sixFc
CsHzt�|�Wn4tk
rB}z|r0|jtjkr2�W5d}~XYnXdS)N)�os�makedirs�OSError�errnoZEEXIST)�path�exist_ok�exc�r
�H/usr/lib/python3.8/site-packages/pip/_vendor/pkg_resources/py31compat.py�_makedirs_31s
r)��)r
r�)F)
rr�sysZpip._vendorrrZPY2�version_infoZneeds_makedirsrr
r
r
r�<module>s
�site-packages/pip/_vendor/pkg_resources/__pycache__/py31compat.cpython-38.pyc000064400000001144151446177000023230 0ustar00U

��.e2�@s`ddlZddlZddlZddlmZddd�ZejpLdejkoHdknZerVenej	Z	dS)	�N)�sixFc
CsHzt�|�Wn4tk
rB}z|r0|jtjkr2�W5d}~XYnXdS)N)�os�makedirs�OSError�errnoZEEXIST)�path�exist_ok�exc�r
�H/usr/lib/python3.8/site-packages/pip/_vendor/pkg_resources/py31compat.py�_makedirs_31s
r)��)r
r�)F)
rr�sysZpip._vendorrrZPY2�version_infoZneeds_makedirsrr
r
r
r�<module>s
�site-packages/pip/_vendor/pkg_resources/__pycache__/__init__.cpython-38.pyc000064400000303710151446177000022773 0ustar00U

��.eͦ�G@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZzddlZWnek
�rddlZYnXze Wne!k
�r*e"Z YnXddl#m$Z$ddl%m&Z&m'Z'm(Z(ddlm)Z)zddlm*Z*m+Z+m,Z,d	Z-Wnek
�r�d
Z-YnXddlm.Z/ddl0m1Z1m2Z2zddl3m4Z5e5j6Wnek
�r�dZ5YnXd
dl7m8Z8ddl#m9Z9ddl#m:Z:e;d�e;d�e;d�e;d�e<Z=dej>k�r@dk�rLnne?d��e$j@�r\dZAdZBdZCdZDdZEdZFdZGdZHdZIdZJdZKdZLdZMdZNdZOdZPdZQdZRdZSGdd�deT�ZUdd�ZViZWdd�ZXdd�ZYd d!�ZZd"d#�Z[d$d%�Z\d&d'�Z]d(d)�Z^d*d+�Z_Z`d,d-�Zad.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMddNddOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrgGZbGdsdI�dIec�ZdGdtdJ�dJed�ZeGdudv�dvee�ZfGdwdK�dKed�ZgGdxdL�dLed�ZhiZiejjddy�ZkdyZldzZmd
ZndZod{Zpd|dm�Zqd}d0�Zrgfd~d�Zsd�d��Ztd�d��Zue�vd��Zwe�vd��ZxeuZyd�dR�Zzd�d/�Z{e{Z|d�d1�Z}d�d2�Z~d�d�d3�Zd�d4�Z�Gd�d`�d`�Z�Gd�da�dae��Z�Gd�dD�dD�Z�Gd�d��d�e��Z�Gd�dC�dC�Z�e�Z�Gd�dM�dMe?�Z�Gd�dE�dE�Z�d�dB�Z�d�dO�Z�d�dP�Z�d�dU�Z�d�dV�Z�d�dW�Z��dd�dX�Z�Gd�dg�dg�Z�eqe�e��Gd�dh�dhe��Z�Gd�di�die��Z�e����Gd�de�dee��Z�e��Z�Gd�d��d�e��Z�Gd�d��d�e��Z�Gd�dj�dje��Z�eqe
j�e��Gd�db�dbe��Z�Gd�dc�dce��Z�Gd�dd�dde��Z�eXd�id��d�dk�Z��dd�d?�Z��dd�d��Z�e�e
j�e���dd�d��Z�e�e�e��d�d��Z��dd�d��Z�d�d��Z�Gd�d��d��Z�d�d��Z�d�d��Z�d�d��Z�d�d��Z�e�ej�e��e�e5d���r�e�e5j�e��eXd�id��eXd�id��d�dl�Z�d�dĄZ�d�dƄZ�d�d<�Z��dd�dn�Z�d�dʄZ�e�ej�e��e�e
j�e��e�e5d���r,e�e5j�e��d�d̄Z�e�e�e��d�dZ�Z�d�dτZ�ifd�dфZ�d�dӄZ�d�dՄZ�d�dׄZ�d�dS�Z�e�vd١j�Z�e�vd�ej�ej�B�j�Z�Gd�dH�dH�Z�d�d݄Z�d�d߄Z�Gd�dF�dF�Z�Gd�d�d�eăZ�Gd�d�d�eăZ�e�e�e�d�Z�d�d�Z�Gd�d�d�eɃZ�d�dN�Z�Gd�dG�dGe:j�j̓Z�d�d�Z�d�d�Z�d�dY�Z�d�d�Z�d�dT�Z�d�d��Z�ej�d�eUd	d��d�d��Z�e�eփfd�d���Z�e�d�d���Z�Gd�dp�dpeكZ�dS(aZ
Package resource API
--------------------

A resource is a logical file contained within a package, or a logical
subdirectory thereof.  The package resource API expects resource names
to have their path parts separated with ``/``, *not* whatever the local
path separator is.  Do not use os.path operations to manipulate resource
names being passed into the API.

The package resource API is designed to work with normal filesystem packages,
.egg files, and unpacked .egg files.  It can also work in a limited way with
.zip files and with custom PEP 302 loaders that support the ``get_data()``
method.
�)�absolute_importN)�get_importer)�six)�urllib�map�filter)�utime)�mkdir�rename�unlinkTF)�open)�isdir�split�)�
py31compat)�appdirs)�	packagingzpip._vendor.packaging.versionz pip._vendor.packaging.specifiersz"pip._vendor.packaging.requirementszpip._vendor.packaging.markers)�r)r�zPython 3.4 or later is requiredc@seZdZdZdS)�
PEP440Warningza
    Used when there is an issue with a version or specifier not complying with
    PEP 440.
    N��__name__�
__module__�__qualname__�__doc__�rr�F/usr/lib/python3.8/site-packages/pip/_vendor/pkg_resources/__init__.pyrxsrcCs8ztj�|�WStjjk
r2tj�|�YSXdS�N)r�version�Version�InvalidVersion�
LegacyVersion)�vrrr�
parse_versionsr#cKs"t��|�t�t�||��dSr)�globals�update�_state_vars�dict�fromkeys)Zvartype�kwrrr�_declare_state�sr*cCs8i}t�}t��D] \}}|d|||�||<q|S)NZ_sget_)r$r&�items��state�g�kr"rrr�__getstate__�s
r0cCs8t�}|��D]$\}}|dt|||||�q|S)NZ_sset_)r$r+r&r,rrr�__setstate__�sr1cCs|��Sr)�copy��valrrr�
_sget_dict�sr5cCs|��|�|�dSr)�clearr%��key�obr-rrr�
_sset_dict�sr:cCs|��Sr)r0r3rrr�_sget_object�sr;cCs|�|�dSr)r1r7rrr�_sset_object�sr<cGsdSrr��argsrrr�<lambda>��r?cCsbt�}t�|�}|dk	r^tjdkr^z&dd�t�dd��|�d�f}Wntk
r\YnX|S)aZReturn this platform's maximum compatible version.

    distutils.util.get_platform() normally reports the minimum version
    of Mac OS X that would be required to *use* extensions produced by
    distutils.  But what we want when checking compatibility is to know the
    version of Mac OS X that we are *running*.  To allow usage of packages that
    explicitly require a newer version of Mac OS X, we must also know the
    current version of the OS.

    If this condition occurs for any other platform with a version in its
    platform strings, this function should be extended accordingly.
    N�darwinzmacosx-%s-%s�.�r)	�get_build_platform�macosVersionString�match�sys�platform�join�_macosx_vers�group�
ValueError)�plat�mrrr�get_supported_platform�s

&rO�require�
run_script�get_provider�get_distribution�load_entry_point�
get_entry_map�get_entry_info�iter_entry_points�resource_string�resource_stream�resource_filename�resource_listdir�resource_exists�resource_isdir�declare_namespace�working_set�add_activation_listener�find_distributions�set_extraction_path�cleanup_resources�get_default_cache�Environment�
WorkingSet�ResourceManager�Distribution�Requirement�
EntryPoint�ResolutionError�VersionConflict�DistributionNotFound�UnknownExtra�ExtractionError�parse_requirements�	safe_name�safe_version�get_platform�compatible_platforms�yield_lines�split_sections�
safe_extra�to_filename�invalid_marker�evaluate_marker�ensure_directory�normalize_path�EGG_DIST�BINARY_DIST�SOURCE_DIST�
CHECKOUT_DIST�DEVELOP_DIST�IMetadataProvider�IResourceProvider�FileMetadata�PathMetadata�EggMetadata�
EmptyProvider�empty_provider�NullProvider�EggProvider�DefaultProvider�ZipProvider�register_finder�register_namespace_handler�register_loader_type�fixup_namespace_packagesr�PkgResourcesDeprecationWarning�run_main�AvailableDistributionsc@seZdZdZdd�ZdS)rkz.Abstract base for dependency resolution errorscCs|jjt|j�Sr)�	__class__r�reprr>��selfrrr�__repr__�szResolutionError.__repr__N)rrrrr�rrrrrk�sc@s<eZdZdZdZedd��Zedd��Zdd�Zd	d
�Z	dS)rlz�
    An already-installed version conflicts with the requested version.

    Should be initialized with the installed Distribution and the requested
    Requirement.
    z3{self.dist} is installed but {self.req} is requiredcCs
|jdS�Nrr=r�rrr�distszVersionConflict.distcCs
|jdS�Nrr=r�rrr�reqszVersionConflict.reqcCs|jjft��Sr��	_template�format�localsr�rrr�reportszVersionConflict.reportcCs|s|S|j|f}t|�S)zt
        If required_by is non-empty, return a version of self that is a
        ContextualVersionConflict.
        )r>�ContextualVersionConflict)r��required_byr>rrr�with_contextszVersionConflict.with_contextN)
rrrrr��propertyr�r�r�r�rrrrrls

c@s&eZdZdZejdZedd��ZdS)r�z�
    A VersionConflict that accepts a third parameter, the set of the
    requirements that required the installed Distribution.
    z by {self.required_by}cCs
|jdS)NrCr=r�rrrr�*sz%ContextualVersionConflict.required_byN)rrrrrlr�r�r�rrrrr�"s
r�c@sHeZdZdZdZedd��Zedd��Zedd��Zd	d
�Z	dd�Z
d
S)rmz&A requested distribution was not foundzSThe '{self.req}' distribution was not found and is required by {self.requirers_str}cCs
|jdSr�r=r�rrrr�5szDistributionNotFound.reqcCs
|jdSr�r=r�rrr�	requirers9szDistributionNotFound.requirerscCs|js
dSd�|j�S)Nzthe applicationz, )r�rIr�rrr�
requirers_str=sz"DistributionNotFound.requirers_strcCs|jjft��Srr�r�rrrr�CszDistributionNotFound.reportcCs|��Sr)r�r�rrr�__str__FszDistributionNotFound.__str__N)rrrrr�r�r�r�r�r�r�rrrrrm/s


c@seZdZdZdS)rnz>Distribution doesn't have an "extra feature" of the given nameNrrrrrrnJsrrC���cCs|t|<dS)aRegister `provider_factory` to make providers for `loader_type`

    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
    and `provider_factory` is a function that, passed a *module* object,
    returns an ``IResourceProvider`` for that module.
    N)�_provider_factories)Zloader_typeZprovider_factoryrrrr�XscCstt|t�r$t�|�p"tt|��dSztj|}Wn&tk
rXt	|�tj|}YnXt
|dd�}tt|�|�S)z?Return an IResourceProvider for the named module or requirementr�
__loader__N)
�
isinstancerir_�findrP�strrG�modules�KeyError�
__import__�getattr�
_find_adapterr�)ZmoduleOrReq�module�loaderrrrrRbs
cCsd|s\t��d}|dkrLd}tj�|�rLttd�rLt�|�}d|krL|d}|�|�	d��|dS)Nr�z0/System/Library/CoreServices/SystemVersion.plist�	readPlistZProductVersionrB)
rHZmac_ver�os�path�exists�hasattr�plistlibr��appendr)�_cacherZplistZ
plist_contentrrrrJos

rJcCsddd��||�S)NZppc)ZPowerPCZPower_Macintosh)�get)�machinerrr�_macosx_archsr�cCs~ddlm}|�}tjdkrz|�d�szz>t�}t��d�dd�}dt	|d�t	|d	�t
|�fWStk
rxYnX|S)
z�Return this platform's string for platform-specific distributions

    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
    needs some hacks for Linux and Mac OS X.
    r)rsrAzmacosx-r� �_zmacosx-%d.%d-%sr)Z	sysconfigrsrGrH�
startswithrJr��uname�replace�intr�rL)rsrMrr�rrrrD�s

�rDzmacosx-(\d+)\.(\d+)-(.*)zdarwin-(\d+)\.(\d+)\.(\d+)-(.*)cCs�|dks|dks||krdSt�|�}|r�t�|�}|s�t�|�}|r�t|�d��}d|�d�|�d�f}|dkr||dks�|dkr�|d	kr�dSd
S|�d�|�d�ks�|�d�|�d�kr�d
St|�d��t|�d��kr�d
SdSd
S)z�Can code for the `provided` platform run on the `required` platform?

    Returns true if either platform is ``None``, or the platforms are equal.

    XXX Needs compatibility checks for Linux and other unixy OSes.
    NTrz%s.%srC�z10.3�z10.4Fr)rErF�darwinVersionStringr�rK)ZprovidedZrequiredZreqMacZprovMacZ
provDarwinZdversionZmacosversionrrrrt�s2


���cCs<t�d�j}|d}|��||d<t|�d�||�dS)z@Locate distribution `dist_spec` and run its `script_name` scriptrrrN�rG�	_getframe�	f_globalsr6rPrQ)Z	dist_spec�script_name�ns�namerrrrQ�s
cCs@t|tj�rt�|�}t|t�r(t|�}t|t�s<td|��|S)z@Return a current distribution object for a Requirement or stringz-Expected string, Requirement, or Distribution)r�r�string_typesri�parserRrh�	TypeError�r�rrrrS�s



cCst|��||�S)zDReturn `name` entry point of `group` for `dist` or raise ImportError)rSrT�r�rKr�rrrrT�scCst|��|�S)�=Return the entry point map for `group`, or the full entry map)rSrU)r�rKrrrrU�scCst|��||�S�z<Return the EntryPoint object for `group`+`name`, or ``None``)rSrVr�rrrrV�sc@s<eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
S)r�cCsdS)z;Does the package's distribution contain the named metadata?Nr�r�rrr�has_metadata�szIMetadataProvider.has_metadatacCsdS)z'The named metadata resource as a stringNrr�rrr�get_metadata�szIMetadataProvider.get_metadatacCsdS)z�Yield named metadata resource as list of non-blank non-comment lines

       Leading and trailing whitespace is stripped from each line, and lines
       with ``#`` as the first non-blank character are omitted.Nrr�rrr�get_metadata_lines�sz$IMetadataProvider.get_metadata_linescCsdS)z>Is the named metadata a directory?  (like ``os.path.isdir()``)Nrr�rrr�metadata_isdirsz IMetadataProvider.metadata_isdircCsdS)z?List of metadata names in the directory (like ``os.listdir()``)Nrr�rrr�metadata_listdirsz"IMetadataProvider.metadata_listdircCsdS)z=Execute the named script in the supplied namespace dictionaryNr)r��	namespacerrrrQ	szIMetadataProvider.run_scriptN)	rrrr�r�r�r�r�rQrrrrr��sc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�z3An object that provides access to package resourcescCsdS)zdReturn a true filesystem path for `resource_name`

        `manager` must be an ``IResourceManager``Nr��manager�
resource_namerrr�get_resource_filenamesz'IResourceProvider.get_resource_filenamecCsdS)ziReturn a readable file-like object for `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_streamsz%IResourceProvider.get_resource_streamcCsdS)zmReturn a string containing the contents of `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_stringsz%IResourceProvider.get_resource_stringcCsdS)z,Does the package contain the named resource?Nr�r�rrr�has_resourceszIResourceProvider.has_resourcecCsdS)z>Is the named resource a directory?  (like ``os.path.isdir()``)Nrr�rrrr]"sz IResourceProvider.resource_isdircCsdS)z?List of resource names in the directory (like ``os.listdir()``)Nrr�rrrr[%sz"IResourceProvider.resource_listdirN)
rrrrr�r�r�r�r]r[rrrrr�
sc@s�eZdZdZd'dd�Zedd��Zedd��Zd	d
�Zdd�Z	d
d�Z
d(dd�Zdd�Zdd�Z
d)dd�Zd*dd�Zd+dd�Zdd�Zd,dd �Zd!d"�Zd#d$�Zd%d&�ZdS)-rfzDA collection of active distributions on sys.path (or a similar list)NcCs>g|_i|_i|_g|_|dkr&tj}|D]}|�|�q*dS)z?Create working set from list of path entries (default=sys.path)N)�entries�
entry_keys�by_key�	callbacksrGr��	add_entry)r�r��entryrrr�__init__,szWorkingSet.__init__cCsb|�}zddlm}Wntk
r.|YSXz|�|�Wntk
r\|�|�YSX|S)z1
        Prepare the master working set.
        r)�__requires__)�__main__r��ImportErrorrPrl�_build_from_requirements)�cls�wsr�rrr�
_build_master9s
zWorkingSet._build_mastercCsf|g�}t|�}|�|t��}|D]}|�|�q"tjD]}||jkr8|�|�q8|jtjdd�<|S)zQ
        Build a working set from a requirement spec. Rewrites sys.path.
        N)rp�resolvere�addrGr�r�r�)r�Zreq_specr��reqs�distsr�r�rrrr�Ms

z#WorkingSet._build_from_requirementscCs<|j�|g�|j�|�t|d�D]}|�||d�q$dS)a�Add a path item to ``.entries``, finding any distributions on it

        ``find_distributions(entry, True)`` is used to find distributions
        corresponding to the path entry, and they are added.  `entry` is
        always appended to ``.entries``, even if it is already present.
        (This is because ``sys.path`` can contain the same value more than
        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
        equal ``sys.path``.)
        TFN)r��
setdefaultr�r�rar�)r�r�r�rrrr�cs
zWorkingSet.add_entrycCs|j�|j�|kS)z9True if `dist` is the active distribution for its project)r�r�r8�r�r�rrr�__contains__rszWorkingSet.__contains__cCs,|j�|j�}|dk	r(||kr(t||��|S)a�Find a distribution matching requirement `req`

        If there is an active distribution for the requested project, this
        returns it as long as it meets the version requirement specified by
        `req`.  But, if there is an active distribution for the project and it
        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
        If there is no active distribution for the requested project, ``None``
        is returned.
        N)r�r�r8rl)r�r�r�rrrr�vs

zWorkingSet.findcs��fdd�|D�S)aYield entry point objects from `group` matching `name`

        If `name` is None, yields all entry points in `group` from all
        distributions in the working set, otherwise only ones matching
        both `group` and `name` are yielded (in distribution order).
        c3s8|]0}|�����D]}�dks*�|jkr|VqqdSr)rU�valuesr�)�.0r�r��rKr�rr�	<genexpr>�s
�z/WorkingSet.iter_entry_points.<locals>.<genexpr>r�r�rKr�rr�rrW�s�zWorkingSet.iter_entry_pointscCs>t�d�j}|d}|��||d<|�|�d�||�dS)z?Locate distribution for `requires` and run `script_name` scriptrrrNr�)r��requiresr�r�r�rrrrQ�s
zWorkingSet.run_scriptccsLi}|jD]<}||jkrq
|j|D] }||kr$d||<|j|Vq$q
dS)z�Yield distributions for non-duplicate projects in the working set

        The yield order is the order in which the items' path entries were
        added to the working set.
        rN)r�r�r�)r��seen�itemr8rrr�__iter__�s

zWorkingSet.__iter__TFcCs�|r|j|j||d�|dkr$|j}|j�|g�}|j�|jg�}|sV|j|jkrVdS||j|j<|j|krx|�|j�|j|kr�|�|j�|�|�dS)aAdd `dist` to working set, associated with `entry`

        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
        On exit from this routine, `entry` is added to the end of the working
        set's ``.entries`` (if it wasn't already present).

        `dist` is only added to the working set if it's for a project that
        doesn't already have a distribution in the set, unless `replace=True`.
        If it's added, any callbacks registered with the ``subscribe()`` method
        will be called.
        �r�N)	�	insert_onr��locationr�r�r8r�r��
_added_new)r�r�r��insertr��keysZkeys2rrrr��s

zWorkingSet.addcCsxt|�ddd�}i}i}g}t�}	t�t�}
|�rt|�d�}||krHq.|	�||�sVq.|�|j�}|dk�r|j	�|j�}|dks�||kr�|r�|}
|dkr�|dkr�t
|j�}nt
g�}tg�}
|j
||
||d�}||j<|dkr�|
�|d�}t||��|�|�||k�r$|
|}t||��|��|�|j�ddd�}|�|�|D] }|
|�|j�|j|	|<�qHd||<q.|S)a�List all distributions needed to (recursively) meet `requirements`

        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
        if supplied, should be an ``Environment`` instance.  If
        not supplied, it defaults to all distributions available within any
        entry or distribution in the working set.  `installer`, if supplied,
        will be invoked with each requirement that cannot be met by an
        already-installed distribution; it should return a ``Distribution`` or
        ``None``.

        Unless `replace_conflicting=True`, raises a VersionConflict exception
        if
        any requirements are found on the path that have the correct name but
        the wrong version.  Otherwise, if an `installer` is supplied it will be
        invoked to obtain the correct version of the requirement and activate
        it.

        `extras` is a list of the extras to be used with these requirements.
        This is important because extra requirements may look like `my_req;
        extra = "my_extra"`, which would otherwise be interpreted as a purely
        optional requirement.  Instead, we want to be able to assert that these
        requirements are truly required.
        Nr�r)�replace_conflictingT)�list�
_ReqExtras�collections�defaultdict�set�pop�markers_passr�r8r�rer�rf�
best_matchrmr�rlr�r�extras�extendr��project_name)r��requirements�env�	installerrrZ	processedZbestZto_activateZ
req_extrasr�r�r�r�r�Z
dependent_reqZnew_requirementsZnew_requirementrrrr��sT


�




zWorkingSet.resolvecCs
t|�}|��i}i}|dkr4t|j�}||7}n||}|�g�}	tt|	j|��|D]�}
||
D]�}|��g}z|	�|||�}
WnBt	k
r�}z$|||<|r�WY�qfn
WY�qZW5d}~XYqfXtt|	j|
��|�
t�|
��qZqfqZt|�}|��||fS)asFind all activatable distributions in `plugin_env`

        Example usage::

            distributions, errors = working_set.find_plugins(
                Environment(plugin_dirlist)
            )
            # add plugins+libs to sys.path
            map(working_set.add, distributions)
            # display errors
            print('Could not load', errors)

        The `plugin_env` should be an ``Environment`` instance that contains
        only distributions that are in the project's "plugin directory" or
        directories. The `full_env`, if supplied, should be an ``Environment``
        contains all currently-available distributions.  If `full_env` is not
        supplied, one is created automatically from the ``WorkingSet`` this
        method is called on, which will typically mean that every directory on
        ``sys.path`` will be scanned for distributions.

        `installer` is a standard installer callback as used by the
        ``resolve()`` method. The `fallback` flag indicates whether we should
        attempt to resolve older versions of a plugin if the newest version
        cannot be resolved.

        This method returns a 2-tuple: (`distributions`, `error_info`), where
        `distributions` is a list of the distributions found in `plugin_env`
        that were loadable, along with any other distributions that are needed
        to resolve their dependencies.  `error_info` is a dictionary mapping
        unloadable plugin distributions to an exception instance describing the
        error that occurred. Usually this will be a ``DistributionNotFound`` or
        ``VersionConflict`` instance.
        N)
r�sortrer�r�rr��as_requirementr�rkr%r'r()r�Z
plugin_envZfull_envrZfallbackZplugin_projectsZ
error_infoZ
distributionsrZ
shadow_setrr�r�Z	resolveesr"rrr�find_plugins's4$




zWorkingSet.find_pluginscGs&|�t|��}|D]}|�|�q|S)a�Ensure that distributions matching `requirements` are activated

        `requirements` must be a string or a (possibly-nested) sequence
        thereof, specifying the distributions and versions required.  The
        return value is a sequence of the distributions that needed to be
        activated to fulfill the requirements; all relevant distributions are
        included, even if they were already activated in this working set.
        )r�rpr�)r�rZneededr�rrrrP{s	zWorkingSet.requirecCs8||jkrdS|j�|�|s"dS|D]}||�q&dS)z�Invoke `callback` for all distributions

        If `existing=True` (default),
        call on all existing ones, as well.
        N)r�r�)r��callback�existingr�rrr�	subscribe�s
zWorkingSet.subscribecCs|jD]}||�qdSr)r�)r�r�rrrrr�s
zWorkingSet._added_newcCs,|jdd�|j��|j��|jdd�fSr)r�r�r2r�r�r�rrrr0�s
�zWorkingSet.__getstate__cCs@|\}}}}|dd�|_|��|_|��|_|dd�|_dSr)r�r2r�r�r�)r�Ze_k_b_cr�r
r�r�rrrr1�s


zWorkingSet.__setstate__)N)N)NTF)NNFN)NNT)T)rrrrr��classmethodr�r�r�r�r�rWrQrr�r�rrPrrr0r1rrrrrf)s4





�
]�
T
c@seZdZdZddd�ZdS)r
z>
    Map each requirement to the extras that demanded it.
    Ncs2�fdd�|��d�|pdD�}�jp0t|�S)z�
        Evaluate markers for req against each extra that
        demanded it.

        Return False if the req has a marker and fails
        evaluation. Otherwise, return True.
        c3s|]}�j�d|i�VqdS)�extraN��marker�evaluate)r�r!�r�rrr��s�z*_ReqExtras.markers_pass.<locals>.<genexpr>rr)r�r#�any)r�r�rZextra_evalsrr%rr�s
�z_ReqExtras.markers_pass)N)rrrrrrrrrr
�sr
c@sxeZdZdZde�efdd�Zdd�Zdd�Zdd	d
�Z	dd�Z
d
d�Zddd�Zddd�Z
dd�Zdd�Zdd�ZdS)rez5Searchable snapshot of distributions on a search pathNcCs i|_||_||_|�|�dS)a!Snapshot distributions available on a search path

        Any distributions found on `search_path` are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.

        `platform` is an optional string specifying the name of the platform
        that platform-specific distributions must be compatible with.  If
        unspecified, it defaults to the current platform.  `python` is an
        optional string naming the desired version of Python (e.g. ``'3.6'``);
        it defaults to the current version.

        You may explicitly set `platform` (and/or `python`) to ``None`` if you
        wish to map *all* distributions, not just those compatible with the
        running platform or Python version.
        N)�_distmaprH�python�scan)r��search_pathrHr(rrrr��szEnvironment.__init__cCs2|jdkp|jdkp|j|jk}|o0t|j|j�S)z�Is distribution `dist` acceptable for this environment?

        The distribution must match the platform and python version
        requirements specified when this environment was created, or False
        is returned.
        N)r(�
py_versionrtrH)r�r�Z	py_compatrrr�can_add�s
�
�zEnvironment.can_addcCs|j|j�|�dS)z"Remove `dist` from the environmentN)r'r8�remover�rrrr-�szEnvironment.removecCs4|dkrtj}|D]}t|�D]}|�|�qqdS)adScan `search_path` for distributions usable in this environment

        Any distributions found are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.  Only distributions conforming to
        the platform/python version defined at initialization are added.
        N)rGr�rar�)r�r*rr�rrrr)�s
zEnvironment.scancCs|��}|j�|g�S)aReturn a newest-to-oldest list of distributions for `project_name`

        Uses case-insensitive `project_name` comparison, assuming all the
        project's distributions use their project's name converted to all
        lowercase as their key.

        )�lowerr'r�)r�rZdistribution_keyrrr�__getitem__�szEnvironment.__getitem__cCsL|�|�rH|��rH|j�|jg�}||krH|�|�|jt�d�dd�dS)zLAdd `dist` if we ``can_add()`` it and it has not already been added
        �hashcmpT�r8�reverseN)	r,�has_versionr'r�r8r�r�operator�
attrgetter)r�r�r�rrrr�s

zEnvironment.addFcCsfz|�|�}Wntk
r,|s$�d}YnX|dk	r:|S||jD]}||krD|SqD|�||�S)a�Find distribution best matching `req` and usable on `working_set`

        This calls the ``find(req)`` method of the `working_set` to see if a
        suitable distribution is already active.  (This may raise
        ``VersionConflict`` if an unsuitable version of the project is already
        active in the specified `working_set`.)  If a suitable distribution
        isn't active, this method returns the newest distribution in the
        environment that meets the ``Requirement`` in `req`.  If no suitable
        distribution is found, and `installer` is supplied, then the result of
        calling the environment's ``obtain(req, installer)`` method will be
        returned.
        N)r�rlr8�obtain)r�r�r_rrr�rrrrs

zEnvironment.best_matchcCs|dk	r||�SdS)a�Obtain a distribution matching `requirement` (e.g. via download)

        Obtain a distro that matches requirement (e.g. via download).  In the
        base ``Environment`` class, this routine just returns
        ``installer(requirement)``, unless `installer` is None, in which case
        None is returned instead.  This method is a hook that allows subclasses
        to attempt other ways of obtaining a distribution before falling back
        to the `installer` argument.Nr)r�Zrequirementrrrrr6+s	zEnvironment.obtainccs"|j��D]}||r
|Vq
dS)z=Yield the unique project names of the available distributionsN)r'r
�r�r8rrrr7szEnvironment.__iter__cCsVt|t�r|�|�n<t|t�rD|D]}||D]}|�|�q0q$ntd|f��|S)z2In-place addition of a distribution or environmentzCan't add %r to environment)r�rhr�rer�)r��otherZprojectr�rrr�__iadd__=s

zEnvironment.__iadd__cCs*|jgddd�}||fD]}||7}q|S)z4Add an environment or distribution to an environmentN)rHr(�r�)r�r8�newrrrr�__add__Is
zEnvironment.__add__)N)NF)N)rrrrrO�PY_MAJORr�r,r-r)r/r�rr6rr9r<rrrrre�s"�


�

c@seZdZdZdS)roaTAn error occurred extracting a resource

    The following attributes are available from instances of this exception:

    manager
        The resource manager that raised this exception

    cache_path
        The base directory for resource extraction

    original_error
        The exception instance that caused extraction to fail
    NrrrrrroUsc@s�eZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zddd�Z
edd��Zdd�Zdd�Zd dd�ZdS)!rgz'Manage resource extraction and packagesNcCs
i|_dSr)�cached_filesr�rrrr�iszResourceManager.__init__cCst|��|�S)zDoes the named resource exist?)rRr��r�Zpackage_or_requirementr�rrrr\lszResourceManager.resource_existscCst|��|�S)z,Is the named resource an existing directory?)rRr]r?rrrr]ps�zResourceManager.resource_isdircCst|��||�S)z4Return a true filesystem path for specified resource)rRr�r?rrrrZvs�z!ResourceManager.resource_filenamecCst|��||�S)z9Return a readable file-like object for specified resource)rRr�r?rrrrY|s�zResourceManager.resource_streamcCst|��||�S)z%Return specified resource as a string)rRr�r?rrrrX�s�zResourceManager.resource_stringcCst|��|�S)z1List the contents of the named resource directory)rRr[r?rrrr[�s�z ResourceManager.resource_listdircCsRt��d}|jpt�}t�d���}t|jft	���}||_
||_||_|�dS)z5Give an error message for problems extracting file(s)ra
            Can't extract file(s) to egg cache

            The following error occurred while trying to extract file(s)
            to the Python egg cache:

              {old_exc}

            The Python egg cache directory is currently set to:

              {cache_path}

            Perhaps your account does not have write access to this directory?
            You can change the cache directory by setting the PYTHON_EGG_CACHE
            environment variable to point to an accessible directory.
            N)
rG�exc_info�extraction_pathrd�textwrap�dedent�lstripror�r�r��
cache_pathZoriginal_error)r��old_excrE�tmpl�errrrr�extraction_error�sz ResourceManager.extraction_errorrcCsf|jp
t�}tjj||df|��}zt|�Wntk
rL|��YnX|�|�d|j	|<|S)a�Return absolute location in cache for `archive_name` and `names`

        The parent directory of the resulting path will be created if it does
        not already exist.  `archive_name` should be the base filename of the
        enclosing egg (which may not be the name of the enclosing zipfile!),
        including its ".egg" extension.  `names`, if provided, should be a
        sequence of path name parts "under" the egg's extraction location.

        This method should only be called by resource providers that need to
        obtain an extraction location, and only for names they intend to
        extract, as it tracks the generated names for possible cleanup later.
        z-tmpr)
rArdr�r�rI�_bypass_ensure_directory�	ExceptionrI�_warn_unsafe_extraction_pathr>)r�Zarchive_name�namesZextract_pathZtarget_pathrrr�get_cache_path�s


zResourceManager.get_cache_pathcCsVtjdkr|�tjd�sdSt�|�j}|tj@s>|tj@rRd|}t�	|t
�dS)aN
        If the default extraction path is overridden and set to an insecure
        location, such as /tmp, it opens up an opportunity for an attacker to
        replace an extracted file with an unauthorized payload. Warn the user
        if a known insecure location is used.

        See Distribute #375 for more details.
        �ntZwindirNz�%s is writable by group/others and vulnerable to attack when used with get_resource_filename. Consider a more secure location (set with .set_extraction_path or the PYTHON_EGG_CACHE environment variable).)r�r�r��environ�stat�st_mode�S_IWOTH�S_IWGRP�warnings�warn�UserWarning)r��mode�msgrrrrL�s
��z,ResourceManager._warn_unsafe_extraction_pathcCs.tjdkr*t�|�jdBd@}t�||�dS)a4Perform any platform-specific postprocessing of `tempname`

        This is where Mac header rewrites should be done; other platforms don't
        have anything special they should do.

        Resource providers should call this method ONLY after successfully
        extracting a compressed resource.  They must NOT call it on resources
        that are already in the filesystem.

        `tempname` is the current (temporary) name of the file, and `filename`
        is the name it will be renamed to by the caller after this routine
        returns.
        �posiximi�N)r�r�rQrR�chmod)r�Ztempname�filenamerXrrr�postprocess�s
zResourceManager.postprocesscCs|jrtd��||_dS)a�Set the base path where resources will be extracted to, if needed.

        If you do not call this routine before any extractions take place, the
        path defaults to the return value of ``get_default_cache()``.  (Which
        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
        platform-specific fallbacks.  See that routine's documentation for more
        details.)

        Resources are extracted to subdirectories of this path based upon
        information given by the ``IResourceProvider``.  You may set this to a
        temporary directory, but then you must call ``cleanup_resources()`` to
        delete the extracted files when done.  There is no guarantee that
        ``cleanup_resources()`` will be able to remove all extracted files.

        (Note: you may not change the extraction path for a given resource
        manager once resources have been extracted, unless you first call
        ``cleanup_resources()``.)
        z5Can't change extraction path, files already extractedN)r>rLrA�r�r�rrrrb�s
�z#ResourceManager.set_extraction_pathFcCsdS)aB
        Delete all extracted resource files and directories, returning a list
        of the file and directory names that could not be successfully removed.
        This function does not have any concurrency protection, so it should
        generally only be called when the extraction path is a temporary
        directory exclusive to a single process.  This method is not
        automatically called; you must call it explicitly or register it as an
        ``atexit`` function if you wish to ensure cleanup of a temporary
        directory used for extractions.
        Nr)r��forcerrrrcsz!ResourceManager.cleanup_resources)r)F)rrrrrAr�r\r]rZrYrXr[rIrN�staticmethodrLr]rbrcrrrrrges 

cCstj�d�ptjdd�S)z�
    Return the ``PYTHON_EGG_CACHE`` environment variable
    or a platform-relevant user cache dir for an app
    named "Python-Eggs".
    ZPYTHON_EGG_CACHEzPython-Eggs)Zappname)r�rPr�rZuser_cache_dirrrrrrds
�cCst�dd|�S)z�Convert an arbitrary string to a standard distribution name

    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
    �[^A-Za-z0-9.]+�-)�re�subr�rrrrq%scCsJzttj�|��WStjjk
rD|�dd�}t�dd|�YSXdS)zB
    Convert an arbitrary string to a standard version string
    r�rBrarbN)r�rrrr r�rcrd)rrrrrr-s
cCst�dd|���S)z�Convert an arbitrary string to a standard 'extra' name

    Any runs of non-alphanumeric characters are replaced with a single '_',
    and the result is always lowercased.
    z[^A-Za-z0-9.-]+r�)rcrdr.)r!rrrrw9scCs|�dd�S)z|Convert a project or version name to its filename-escaped form

    Any '-' characters are currently replaced with '_'.
    rbr�rr�rrrrxBsc
CsHzt|�Wn6tk
rB}zd|_d|_|WY�Sd}~XYnXdS)zo
    Validate text as a PEP 508 environment marker; return an exception
    if invalid or False otherwise.
    NF)rz�SyntaxErrorr\�lineno)�text�errrryJsc
CsJztj�|�}|��WStjjk
rD}zt|��W5d}~XYnXdS)z�
    Evaluate a PEP 508 environment marker.
    Return a boolean indicating the marker result in this environment.
    Raise SyntaxError if marker is invalid.

    This implementation uses the 'pyparsing' module.
    N)rZmarkersZMarkerr$Z
InvalidMarkerre)rgr!r#rhrrrrzXs

c@s�eZdZdZdZdZdZdd�Zdd�Zdd�Z	d	d
�Z
dd�Zd
d�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zed'd(��Zd)d*�ZdS)+r�zETry to implement resources and metadata for arbitrary PEP 302 loadersNcCs(t|dd�|_tj�t|dd��|_dS)Nr��__file__r�)r�r�r�r��dirname�module_path�r�r�rrrr�nszNullProvider.__init__cCs|�|j|�Sr)�_fnrk�r�r�r�rrrr�rsz"NullProvider.get_resource_filenamecCst�|�||��Sr)�io�BytesIOr�rnrrrr�usz NullProvider.get_resource_streamcCs|�|�|j|��Sr)�_getrmrkrnrrrr�xsz NullProvider.get_resource_stringcCs|�|�|j|��Sr)�_hasrmrk�r�r�rrrr�{szNullProvider.has_resourcecCs|�|j|�Sr)rm�egg_info�r�r�rrr�_get_metadata_path~szNullProvider._get_metadata_pathcCs |js|jS|�|�}|�|�Sr)rtrvrr�r�r�r�rrrr��s
zNullProvider.has_metadatac
Cst|js
dS|�|�}|�|�}tjr(|Sz|�d�WStk
rn}z|jd�||�7_�W5d}~XYnXdS)Nr��utf-8z in {} file at path: {})	rtrvrqr�PY2�decode�UnicodeDecodeError�reasonr�)r�r�r��value�excrrrr��s

zNullProvider.get_metadatacCst|�|��Sr�rur�rurrrr��szNullProvider.get_metadata_linescCs|�|�|j|��Sr)�_isdirrmrkrsrrrr]�szNullProvider.resource_isdircCs|jo|�|�|j|��Sr)rtr�rmrurrrr��szNullProvider.metadata_isdircCs|�|�|j|��Sr)�_listdirrmrkrsrrrr[�szNullProvider.resource_listdircCs|jr|�|�|j|��SgSr)rtr�rmrurrrr��szNullProvider.metadata_listdirc
Cs�d|}|�|�s$tdjft����|�|��dd�}|�dd�}|�|j|�}||d<tj	�
|�r�t|���}t
||d�}t|||�n>dd	lm}t|�d|�d�|f||<t
||d�}	t|	||�dS)
Nzscripts/z<Script {script!r} not found in metadata at {self.egg_info!r}z
�
�
ri�execr)�cache)r�rkr�r�r�r�rmrtr�r�r�r�read�compiler��	linecacher��lenr)
r�r�r�ZscriptZscript_textZscript_filename�source�coder�Zscript_coderrrrQ�s.
���zNullProvider.run_scriptcCstd��dS�Nz9Can't perform this operation for unregistered loader type��NotImplementedErrorr^rrrrr�s�zNullProvider._hascCstd��dSr�r�r^rrrr��s�zNullProvider._isdircCstd��dSr�r�r^rrrr��s�zNullProvider._listdircCs*|�|�|r&tjj|f|�d���S|S)N�/)�_validate_resource_pathr�r�rIr)r��baser�rrrrm�s
zNullProvider._fncCsptjj|�tj�kp&t�|�p&t�|�}|s0dSd}t�|�rPt�|�sPt|��t	j
|dd�dtdd�dS)aO
        Validate the resource paths according to the docs.
        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access

        >>> warned = getfixture('recwarn')
        >>> warnings.simplefilter('always')
        >>> vrp = NullProvider._validate_resource_path
        >>> vrp('foo/bar.txt')
        >>> bool(warned)
        False
        >>> vrp('../foo/bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('/foo/bar.txt')
        >>> bool(warned)
        True
        >>> vrp('foo/../../bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('foo/f../bar.txt')
        >>> bool(warned)
        False

        Windows path separators are straight-up disallowed.
        >>> vrp(r'\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        >>> vrp(r'C:\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        Blank values are allowed

        >>> vrp('')
        >>> bool(warned)
        False

        Non-string values are not.

        >>> vrp(None)
        Traceback (most recent call last):
        ...
        AttributeError: ...
        Nz=Use of .. or absolute path in a resource path is not allowed.r�z/ and will raise exceptions in a future release.r��
stacklevel)r�r��pardirr�	posixpath�sep�isabs�ntpathrLrUrV�DeprecationWarning)r�ZinvalidrYrrrr��s6���z$NullProvider._validate_resource_pathcCs$t|jd�r|j�|�Std��dS)N�get_dataz=Can't perform this operation for loaders without 'get_data()')r�r�r�r�r^rrrrqs
�zNullProvider._get)rrrr�egg_namertr�r�r�r�r�r�rvr�r�r�r]r�r[r�rQrrr�r�rmr`r�rqrrrrr�gs2
Jc@s eZdZdZdd�Zdd�ZdS)r�z&Provider based on a virtual filesystemcCst�||�|��dSr)r�r��
_setup_prefixrlrrrr�-szEggProvider.__init__cCsZ|j}d}||krVt|�r@tj�|�|_tj�|d�|_||_qV|}tj�	|�\}}q
dS)N�EGG-INFO)
rk�_is_egg_pathr�r��basenamer�rIrt�egg_rootr)r�r��oldr�rrrr�1szEggProvider._setup_prefixN)rrrrr�r�rrrrr�*sc@sDeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Ze	dd
��Z
dS)r�z6Provides access to package resources in the filesystemcCstj�|�Sr)r�r�r�r^rrrrrCszDefaultProvider._hascCstj�|�Sr)r�r�r
r^rrrr�FszDefaultProvider._isdircCs
t�|�Sr)r��listdirr^rrrr�IszDefaultProvider._listdircCst|�|j|�d�S�N�rb)rrmrkrnrrrr�Lsz#DefaultProvider.get_resource_streamc
Cs*t|d��}|��W5QR�SQRXdSr�)rr�)r�r��streamrrrrqOszDefaultProvider._getcCs,d}|D]}tt|td��}t||�qdS)N)�SourceFileLoader�SourcelessFileLoader)r��importlib_machinery�typer�)r�Zloader_namesr�Z
loader_clsrrr�	_registerSszDefaultProvider._registerN)rrrrrrr�r�r�rqr r�rrrrr�@sc@s8eZdZdZdZdd�ZZdd�Zdd�Zd	d
�Z	dS)r�z.Provider that returns nothing for all requestsNcCsdS�NFrr^rrrr?cr@zEmptyProvider.<lambda>cCsdS�Nr�rr^rrrrqeszEmptyProvider._getcCsgSrrr^rrrr�hszEmptyProvider._listdircCsdSrrr�rrrr�kszEmptyProvider.__init__)
rrrrrkr�rrrqr�r�rrrrr�^sc@s eZdZdZedd��ZeZdS)�ZipManifestsz
    zip manifest builder
    c
s@t�|��,��fdd����D�}t|�W5QR�SQRXdS)a
        Build a dictionary similar to the zipimport directory
        caches, except instead of tuples, store ZipInfo objects.

        Use a platform-specific path separator (os.sep) for the path keys
        for compatibility with pypy on Windows.
        c3s&|]}|�dtj���|�fVqdS)r�N)r�r�r�Zgetinfo�r�r��Zzfilerrr��s��z%ZipManifests.build.<locals>.<genexpr>N)�zipfileZZipFileZnamelistr')r�r�r+rr�r�buildws
	
�zZipManifests.buildN)rrrrr r��loadrrrrr�rs
r�c@s$eZdZdZe�dd�Zdd�ZdS)�MemoizedZipManifestsz%
    Memoized zipfile manifests.
    �manifest_modzmanifest mtimecCsRtj�|�}t�|�j}||ks.||j|krH|�|�}|�||�||<||jS)zW
        Load a manifest at path or return a suitable manifest already loaded.
        )	r�r��normpathrQ�st_mtime�mtimer�r��manifest)r�r�r�r�rrrr��s
zMemoizedZipManifests.loadN)rrrrr�
namedtupler�r�rrrrr��sr�c@s�eZdZdZdZe�Zdd�Zdd�Zdd�Z	e
d	d
��Zdd�Ze
d
d��Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �ZdS)!r�z"Resource support for zips and eggsNcCs t�||�|jjtj|_dSr)r�r�r��archiver�r��zip_prerlrrrr��szZipProvider.__init__cCsP|�tj�}||jjkrdS|�|j�r:|t|j�d�Std||jf��dS)Nr��%s is not a subpath of %s)	�rstripr�r�r�r�r�r�r��AssertionError�r��fspathrrr�
_zipinfo_name�s�zZipProvider._zipinfo_namecCsP|j|}|�|jtj�r:|t|j�dd��tj�Std||jf��dS)Nrr�)r�r�r�r�r�r�rr�)r��zip_pathr�rrr�_parts�s
�zZipProvider._partscCs|j�|jj�Sr)�_zip_manifestsr�r�r�r�rrr�zipinfo�szZipProvider.zipinfocCs\|jstd��|�|�}|��}d�|�|��|krP|D]}|�||�|��q8|�||�S)Nz5resource_filename() only supported for .egg, not .zipr�)r�r��_resource_to_zip�_get_eager_resourcesrIr��_extract_resource�
_eager_to_zip)r�r�r�r��eagersr�rrrr��s�
z!ZipProvider.get_resource_filenamecCs"|j}|jd}t�|�}||fS)N)rrr�)�	file_size�	date_time�time�mktime)Zzip_stat�sizer��	timestamprrr�_get_date_and_size�s

zZipProvider._get_date_and_sizec
Csx||��kr@|��|D]}|�|tj�||��}qtj�|�S|�|j|�\}}ts`t	d��z�|�
|j|�|��}|�
||�r�|WStdtj�|�d�\}}	t�||j�|��t�|�t|	||f�|�|	|�zt|	|�Wnhtjk
�rNtj�|��rH|�
||��r |YWStjdk�rHt|�t|	|�|YWS�YnXWn tjk
�rr|��YnX|S)Nz>"os.rename" and "os.unlink" are not supported on this platformz	.$extract)�dirrO)�_indexr�r�r�rIrjr�r��
WRITE_SUPPORT�IOErrorrNr�r��_is_current�_mkstemp�writer�r��closerr]r
�error�isfiler�rrI)
r�r�r�r�Zlastr�r�Z	real_pathZoutfZtmpnamrrrr��sN��
�




zZipProvider._extract_resourcec		Csx|�|j|�\}}tj�|�s$dSt�|�}|j|ksB|j|krFdS|j�	|�}t
|d��}|��}W5QRX||kS)zK
        Return True if the file_path is current for this zip_path
        Fr�)r�r�r�r�r�rQ�st_sizer�r�r�rr�)	r�Z	file_pathr�r�r�rQZzip_contents�fZ
file_contentsrrrr�s
zZipProvider._is_currentcCs>|jdkr8g}dD]}|�|�r|�|�|��q||_|jS)N)znative_libs.txtzeager_resources.txt)r�r�rr�)r�r�r�rrrr�"s

z ZipProvider._get_eager_resourcesc	Cs�z|jWStk
r�i}|jD]V}|�tj�}|r"tj�|dd��}||krh||�|d�q"q2|��g||<q2q"||_|YSXdS)Nr�)	Z	_dirindex�AttributeErrorr�rr�r�rIr�r)r�Zindr��parts�parentrrrr�+s
zZipProvider._indexcCs |�|�}||jkp||��kSr)r�r�r�)r�r�r�rrrrr<s
zZipProvider._hascCs|�|�|��kSr)r�r�r�rrrr�@szZipProvider._isdircCst|���|�|�d��S�Nr)rr�r�r�r�rrrr�CszZipProvider._listdircCs|�|�|j|��Sr)r�rmr�rsrrrr�FszZipProvider._eager_to_zipcCs|�|�|j|��Sr)r�rmrkrsrrrr�IszZipProvider._resource_to_zip)rrrrr�r�r�r�r�r�r�r�r�r`r�r�r�r�r�rrr�r�r�r�rrrrr��s(



7	c@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�a*Metadata handler for standalone PKG-INFO files

    Usage::

        metadata = FileMetadata("/path/to/PKG-INFO")

    This provider rejects all data and metadata requests except for PKG-INFO,
    which is treated as existing, and will be the contents of the file at
    the provided location.
    cCs
||_dSr�r�r^rrrr�\szFileMetadata.__init__cCs|jSrr�rurrrrv_szFileMetadata._get_metadata_pathcCs|dkotj�|j�S)N�PKG-INFO)r�r�r�rurrrr�bszFileMetadata.has_metadatac	CsD|dkrtd��tj|jddd��}|��}W5QRX|�|�|S)Nr�z(No metadata except PKG-INFO is availablerxr�)�encoding�errors)r�rorr�r��_warn_on_replacement)r�r�r��metadatarrrr�es
zFileMetadata.get_metadatacCs2d�d�}||kr.d}|jft��}t�|�dS)Ns�rxz2{self.path} could not be properly decoded in UTF-8)rzr�r�rUrV)r�r�Zreplacement_charrGrYrrrr�ns

z!FileMetadata._warn_on_replacementcCst|�|��Srrrurrrr�vszFileMetadata.get_metadata_linesN)
rrrrr�rvr�r�r�r�rrrrr�Ps	c@seZdZdZdd�ZdS)r�asMetadata provider for egg directories

    Usage::

        # Development eggs:

        egg_info = "/path/to/PackageName.egg-info"
        base_dir = os.path.dirname(egg_info)
        metadata = PathMetadata(base_dir, egg_info)
        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)

        # Unpacked egg directories:

        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
        dist = Distribution.from_filename(egg_path, metadata=metadata)
    cCs||_||_dSr)rkrt)r�r�rtrrrr��szPathMetadata.__init__N�rrrrr�rrrrr�zsc@seZdZdZdd�ZdS)r�z Metadata provider for .egg filescCsD|jtj|_||_|jr0tj�|j|j�|_n|j|_|�	�dS)z-Create a metadata provider from a zipimporterN)
r�r�r�r�r��prefixr�rIrkr�)r��importerrrrr��szEggMetadata.__init__Nr�rrrrr��sr'��_distribution_finderscCs|t|<dS)axRegister `distribution_finder` to find distributions in sys.path items

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `distribution_finder` is a callable that, passed a path
    item and the importer instance, yields ``Distribution`` instances found on
    that path item.  See ``pkg_resources.find_on_path`` for an example.Nr�)�
importer_typeZdistribution_finderrrrr��scCst|�}tt|�}||||�S)z.Yield distributions accessible via `path_item`)rr�r�)�	path_item�onlyr��finderrrrra�s
c	cs�|j�d�rdSt|�}|�d�r2tj||d�V|r:dS|�d�D]|}t|�r�tj	�
||�}tt�
|�|�}|D]
}|VqrqD|���d�rDtj	�
||�}tt�
|��}||_t�|||�VqDdS)z@
    Find eggs in zip files; possibly multiple nested eggs.
    z.whlNr��r�r��
.dist-info)r��endswithr�r�rh�
from_filenamer[r�r�r�rI�find_eggs_in_zip�	zipimport�zipimporterr.rt�
from_location)	r�r�r�r�Zsubitem�subpathr�r�Zsubmetarrrr��s$

r�cCsdSr�r)r�r�r�rrr�find_nothing�sr�cCsdd�}t||dd�S)aL
    Given a list of filenames, return them in descending order
    by version number.

    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
    >>> _by_version_descending(names)
    ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg']
    cSs2tj�|�\}}t�|�d�|g�}dd�|D�S)z6
        Parse each component of the filename
        rbcSsg|]}tj�|��qSr)rrr�)r��partrrr�
<listcomp>�sz?_by_version_descending.<locals>._by_version.<locals>.<listcomp>)r�r��splitext�	itertools�chainr)r��extr�rrr�_by_version�sz+_by_version_descending.<locals>._by_versionTr1)�sorted)rMrrrr�_by_version_descending�src
#s�t���t��r4tj�t�tj��d��d�VdSt��}��fdd�|D�}t	|�}|D]2}tj��|�}t
�|��}||�D]
}	|	Vq�q\dS)z6Yield distributions accessible on a sys.path directoryr�r�Nc3s|]}t�|��r|VqdSr)�dist_factory)r�r��r�r�rrr�s�zfind_on_path.<locals>.<genexpr>)�_normalize_cached�_is_unpacked_eggrhr�r�r�r�rI�safe_listdirrr)
r�r�r�r�ZfilteredZpath_item_entriesr��fullpath�factoryr�rrr�find_on_path�s(���rcCsH|��}tt|jd��}|r tS|s0t|�r0tS|sB|�d�rBtSt�S)z9
    Return a dist_factory for a path_item and entry
    )�	.egg-infor�z	.egg-link)	r.r&rr��distributions_from_metadatar�ra�resolve_egg_link�NoDists)r�r�r�r.Zis_metarrrrs������rc@s*eZdZdZdd�ZejreZdd�ZdS)rzS
    >>> bool(NoDists())
    False

    >>> list(NoDists()('anything'))
    []
    cCsdSr�rr�rrr�__bool__.szNoDists.__bool__cCstd�Sr�)�iter)r�r	rrr�__call__3szNoDists.__call__N)	rrrrrrryZ__nonzero__rrrrrr&s
rc
Csvzt�|�WSttfk
r$YnNtk
rp}z0|jtjtjtjfkpXt	|dd�dk}|s`�W5d}~XYnXdS)zI
    Attempt to list contents of path, but suppress some exceptions.
    ZwinerrorNir)
r�r��PermissionError�NotADirectoryError�OSError�errnoZENOTDIRZEACCESZENOENTr�)r�rhZ	ignorablerrrr7s�rccsftj�|�}tj�|�r:tt�|��dkr.dSt||�}nt|�}tj�|�}t	j
|||td�VdS)Nr)�
precedence)r�r�rjr
r�r�r�r�r�rhr�r�)r��rootr�r�rrrr
Ls�r
c	cs4t|��"}|D]}|��}|r|VqW5QRXdS)z1
    Yield non-empty lines from file at path
    N)r�strip)r�r��linerrr�non_empty_lines[s

rcs.t��}�fdd�|D�}tt|�}t|d�S)za
    Given a path to an .egg-link, resolve distributions
    present in the referenced path.
    c3s$|]}tj�tj���|�VqdSr)r�r�rIrj)r��refr�rrr�ls�z#resolve_egg_link.<locals>.<genexpr>r)rrra�next)r�Zreferenced_pathsZresolved_pathsZdist_groupsrr�rrfs
�
r�
FileFinder��_namespace_handlers)�_namespace_packagescCs|t|<dS)a�Register `namespace_handler` to declare namespace packages

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `namespace_handler` is a callable like this::

        def namespace_handler(importer, path_entry, moduleName, module):
            # return a path_entry to use for child packages

    Namespace handlers are only called if the importer object has already
    agreed that it can handle the relevant path item, and they should only
    return a subpath if the module __path__ does not already contain an
    equivalent subpath.  For an example namespace handler, see
    ``pkg_resources.file_ns_handler``.
    Nr)r�Znamespace_handlerrrrr�}sc	Cs�t|�}|dkrdSt���t�d�|�|�}W5QRX|dkrHdStj�|�}|dkr�t�	|�}tj|<g|_
t|�nt|d�s�t
d|��tt|�}|||||�}|dk	r�|j
}|�|�|�|�t|||�|S)zEEnsure that named package includes a subpath of path_item (if needed)N�ignore�__path__�Not a package:)rrU�catch_warnings�simplefilter�find_modulerGr�r��types�
ModuleTyper#�_set_parent_nsr�r�r�r r��load_module�_rebuild_mod_path)�packageNamer�r�r�r�Zhandlerr�r�rrr�
_handle_ns�s.







r.csjdd�tjD���fdd����fdd�}t||d�}dd�|D�}t|jt�r`||jd	d	�<n||_d	S)
zq
    Rebuild module.__path__ ensuring that all entries are ordered
    corresponding to their sys.path order
    cSsg|]}t|��qSr�r�r��prrrr��sz%_rebuild_mod_path.<locals>.<listcomp>cs.z��|�WStk
r(td�YSXdS)z/
        Workaround for #520 and #513.
        �infN)�indexrL�float)r�)�sys_pathrr�safe_sys_path_index�sz._rebuild_mod_path.<locals>.safe_sys_path_indexcs<|�tj�}��d�d}|d|�}�ttj�|���S)zR
        Return the ordinal of the path based on its position in sys.path
        rBrN)rr�r��countrrI)r��
path_partsZmodule_partsr�)�package_namer6rr�position_in_sys_path�sz/_rebuild_mod_path.<locals>.position_in_sys_path)r8cSsg|]}t|��qSrr/r0rrrr��sN)rGr�rr�r#r)�	orig_pathr9r�r:�new_pathr)r9r6r5rr,�s		r,cCs�t��z�|tkrW��dStj}|�d�\}}}|r|t|�|tkrLt|�ztj	|j
}Wntk
rztd|��YnXt�
|p�dg��|�t�
|g�|D]}t||�q�W5t��XdS)z9Declare that package 'packageName' is a namespace packageNrBr$)�_imp�acquire_lock�release_lockr!rGr��
rpartitionr^r�r�r#r�r�r�r�r.)r-r�r�r�r�rrrr^�s&cCsFt��z.t�|d�D]}t||�}|rt||�qW5t��XdS)zDEnsure that previously-declared namespace packages include path_itemrN)r=r>r?r!r�r.r�)r�r��packager�rrrr��s
cCsDtj�||�d�d�}t|�}|jD]}t|�|kr&q@q&|SdS)zBCompute an ns-package subpath for a filesystem or zipfile importerrBr�N)r�r�rIrrr#)r�r�r-r�r�Z
normalizedrrrr�file_ns_handler�s
rBcCsdSrr)r�r�r-r�rrr�null_ns_handler	srCcCs tj�tj�tj�t|����S)z1Normalize a file/dir name for comparison purposes)r�r��normcase�realpathr��
_cygwin_patch�r\rrrr|	scCstjdkrtj�|�S|S)a
    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
    symlink components. Using
    os.path.abspath() works around this limitation. A fix in os.getcwd()
    would probably better, in Cygwin even more so, except
    that this seems to be by design...
    �cygwin)rGrHr�r��abspathrGrrrrF	srFcCs8z
||WStk
r2t|�||<}|YSXdSr)r�r|)r\r��resultrrrr)	s

rcCs|���d�S)z7
    Determine if given path appears to be an egg.
    �.egg)r.r�r�rrrr�1	sr�cCs t|�otj�tj�|dd��S)z@
    Determine if given path appears to be an unpacked egg.
    r�r�)r�r�r�r�rIr�rrrr8	s�rcCs<|�d�}|��}|r8d�|�}ttj||tj|�dS)NrB)rrrI�setattrrGr�)r-r�r�r�rrrr*B	s


r*ccsZt|tj�r8|��D] }|��}|r|�d�s|Vqn|D]}t|�D]
}|VqHq<dS)z9Yield non-empty/non-comment lines of a string or sequence�#N)r�rr��
splitlinesrr�ru)�strs�sZssrrrruJ	s
z\w+(\.\w+)*$z�
    (?P<name>[^-]+) (
        -(?P<ver>[^-]+) (
            -py(?P<pyver>[^-]+) (
                -(?P<plat>.+)
            )?
        )?
    )?
    c@s�eZdZdZddd�Zdd�Zdd	�Zddd�Zd
d�Zddd�Z	e
�d�Ze
ddd��Ze
dd��Ze
ddd��Ze
ddd��ZdS) rjz3Object representing an advertised importable objectrNcCs<t|�std|��||_||_t|�|_t|�|_||_dS)NzInvalid module name)�MODULErLr��module_name�tuple�attrsrr�)r�r�rRrTrr�rrrr�j	s


zEntryPoint.__init__cCsHd|j|jf}|jr*|dd�|j�7}|jrD|dd�|j�7}|S)Nz%s = %s�:rBz [%s]�,)r�rRrTrIr)r�rPrrrr�s	szEntryPoint.__str__cCsdt|�S)NzEntryPoint.parse(%r)�r�r�rrrr�{	szEntryPoint.__repr__TcOs4|r|s|rtjdtdd�|r,|j||�|��S)zH
        Require packages for this EntryPoint, then resolve it.
        zJParameters to load are deprecated.  Call .resolve and .require separately.rCr�)rUrVr�rPr�)r�rPr>�kwargsrrrr�~	s�zEntryPoint.loadc
CsXt|jdgdd�}zt�t|j|�WStk
rR}ztt|���W5d}~XYnXdS)zD
        Resolve the entry point from its module and attrs.
        rr)�fromlist�levelN)	r�rR�	functools�reducer�rTr�r�r�)r�r�r~rrrr��	s
zEntryPoint.resolvecCsL|jr|jstd|��|j�|j�}tj||||jd�}tttj|��dS)Nz&Can't require() without a distribution)r)	rr�rnrr_r�rrr�)r�rrr�r+rrrrP�	s

zEntryPoint.requirez]\s*(?P<name>.+?)\s*=\s*(?P<module>[\w.]+)\s*(:\s*(?P<attr>[\w.]+))?\s*(?P<extras>\[.*\])?\s*$cCsf|j�|�}|sd}t||��|��}|�|d�}|drJ|d�d�nd}||d|d|||�S)aParse a single entry point from string `src`

        Entry point syntax follows the form::

            name = some.module:some.attr [extra1, extra2]

        The entry name and module name are required, but the ``:attrs`` and
        ``[extras]`` parts are optional
        z9EntryPoint must be in 'name=module:attrs [extras]' formatr�attrrBrr�r�)�patternrFrL�	groupdict�
_parse_extrasr)r��srcr�rNrY�resrrTrrrr��	s
zEntryPoint.parsecCs(|sdSt�d|�}|jr"t��|jS)Nr�x)rir��specsrLr)r�Zextras_specr�rrrr`�	szEntryPoint._parse_extrascCsVt|�std|��i}t|�D]2}|�||�}|j|krFtd||j��|||j<q|S)zParse an entry point groupzInvalid group namezDuplicate entry point)rQrLrur�r�)r�rK�linesr��thisr�eprrr�parse_group�	s

zEntryPoint.parse_groupcCstt|t�r|��}nt|�}i}|D]J\}}|dkrB|s:q$td��|��}||kr\td|��|�|||�||<q$|S)z!Parse a map of entry point groupsNz%Entry points must be listed in groupszDuplicate group name)r�r'r+rvrLrrh)r��datar��mapsrKrerrr�	parse_map�	s


zEntryPoint.parse_map)rrN)T)NN)N)N)N)rrrrr�r�r�r�r�rPrcr�r^r r�r`rhrkrrrrrjg	s$
	



�	
cCs>|sdStj�|�}|d�d�r:tj�|dd�d�S|S)Nr�r�zmd5=)r�)rr�Zurlparser�Z
urlunparse)rZparsedrrr�_remove_md5_fragment�	srlcCs@dd�}t||�}tt|�d�}|�d�\}}}t|���p>dS)z�
    Given an iterable of lines from a Metadata file, return
    the value of the Version field, if present, or None otherwise.
    cSs|���d�S)Nzversion:)r.r�)rrrr�is_version_line�	sz+_version_from_file.<locals>.is_version_liner�rUN)rrr�	partitionrrr)rermZ
version_linesrr�r}rrr�_version_from_file�	s

rocs�eZdZdZdZddddedefdd�ZedSdd��Z	dd	�Z
ed
d��Zdd
�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zedd��Zedd��Zdd�Zed d!��Zed"d#��Zed$d%��Zd&d'�ZdTd)d*�Zd+d,�Zd-d.�Zd/d0�ZdUd2d3�Z d4d5�Z!d6d7�Z"d8d9�Z#d:d;�Z$�fd<d=�Z%e&e'd>��s4[%edVd?d@��Z(dAdB�Z)dCdD�Z*dWdEdF�Z+dGdH�Z,dXdIdJ�Z-dKdL�Z.dMdN�Z/dOdP�Z0edQdR��Z1�Z2S)Yrhz5Wrap an actual or potential sys.path entry w/metadatar�NcCsFt|pd�|_|dk	r t|�|_||_||_||_||_|p>t|_	dS)NZUnknown)
rqrrr�_versionr+rHrrr��	_provider)r�rr�rrr+rHrrrrr�
s
zDistribution.__init__cKs~dgd\}}}}tj�|�\}}	|	��tkr^t|	��}t|�}
|
r^|
�dddd�\}}}}|||f||||d�|����S)Nrr�ZverZpyverrM)rrr+rH)r�r�r�r.�_distributionImpl�EGG_NAMErK�_reload_version)r�rr�r�r)rrr+rHrrFrrrr�
s.����zDistribution.from_locationcCs|Srrr�rrrrt#
szDistribution._reload_versioncCs(|j|j|jt|j�|jpd|jp$dfSr�)�parsed_versionrr8rlrr+rHr�rrrr0&
s�zDistribution.hashcmpcCs
t|j�Sr)�hashr0r�rrr�__hash__1
szDistribution.__hash__cCs|j|jkSr�r0�r�r8rrr�__lt__4
szDistribution.__lt__cCs|j|jkSrrxryrrr�__le__7
szDistribution.__le__cCs|j|jkSrrxryrrr�__gt__:
szDistribution.__gt__cCs|j|jkSrrxryrrr�__ge__=
szDistribution.__ge__cCst||j�sdS|j|jkSr�)r�r�r0ryrrr�__eq__@
szDistribution.__eq__cCs
||kSrrryrrr�__ne__F
szDistribution.__ne__cCs6z|jWStk
r0|j��|_}|YSXdSr)Z_keyr�rr.r7rrrr8M
s
zDistribution.keycCst|d�st|j�|_|jS)N�_parsed_version)r�r#rr�r�rrrruU
s
zDistribution.parsed_versioncCsXtjj}t|j|�}|sdS|js&dSt�d����dd�}t	�
|jft|��t
�dS)Na>
            '{project_name} ({version})' is being parsed as a legacy,
            non PEP 440,
            version. You may find odd behavior and sort order.
            In particular it will be sorted as less than 0.0. It
            is recommended to migrate to PEP 440 compatible
            versions.
            r�r�)rrr!r�r�rBrCrr�rUrVr��varsr)r�ZLVZ	is_legacyrGrrr�_warn_legacy_version\
s�	z!Distribution._warn_legacy_versioncCsZz|jWStk
rT|��}|dkrL|�|j�}d�|j|�}t||��|YSXdS)Nz4Missing 'Version:' header and/or {} file at path: {})rpr��_get_version�_get_metadata_path_for_display�PKG_INFOr�rL)r�rr�rYrrrrv
s��
zDistribution.versioncCs4z|jWStk
r,|�|���|_YnX|jS)z~
        A map of extra to its list of (direct) requirements
        for this distribution, including the null extra.
        )Z_Distribution__dep_mapr��_filter_extras�_build_dep_mapr�rrr�_dep_map�
s
zDistribution._dep_mapcCsrttd|��D]^}|}|�|�}|�d�\}}}|oDt|�pDt|�}|rNg}t|�pXd}|�|g��|�q|S)z�
        Given a mapping of extras to dependencies, strip off
        environment markers and filter out any dependencies
        not matching the markers.
        NrU)	rrrrnryrzrwr�r)�dmr!Z	new_extrar�r�r#Zfails_markerrrrr��
s
�zDistribution._filter_extrascCs@i}dD]2}t|�|��D]\}}|�|g��t|��qq|S)N)zrequires.txtzdepends.txt)rv�
_get_metadatar�rrp)r�r�r�r!r�rrrr��
s
zDistribution._build_dep_maprc	Csf|j}g}|�|�dd��|D]@}z|�|t|��Wq tk
r^td||f��Yq Xq |S)z@List of Requirements needed for this distro if `extras` are usedNrz%s has no such extra feature %r)r�rr�rwr�rn)r�rr�Zdepsrrrrr�
s
�zDistribution.requirescCs,z|j�|�}Wntk
r&YdSX|S)zK
        Return the path to the given metadata file, if available.
        z[could not detect])rqrvrKrwrrrr��
s
z+Distribution._get_metadata_path_for_displayccs$|�|�r |�|�D]
}|VqdSr)r�r�)r�r�rrrrr��
s
zDistribution._get_metadatacCs|�|j�}t|�}|Sr)r�r�ro)r�rerrrrr��
szDistribution._get_versionFcCsV|dkrtj}|j||d�|tjkrRt|j�|�d�D]}|tjkr:t|�q:dS)z>Ensure distribution is importable on `path` (default=sys.path)Nr�namespace_packages.txt)rGr�rr�rr�r�r^)r�r�r�Zpkgrrr�activate�
s


zDistribution.activatecCs8dt|j�t|j�|jptf}|jr4|d|j7}|S)z@Return what this distribution's standard .egg filename should bez
%s-%s-py%srb)rxrrr+r=rH)r�r\rrrr��
s�zDistribution.egg_namecCs |jrd||jfSt|�SdS)Nz%s (%s))rr�r�rrrr��
szDistribution.__repr__cCs@zt|dd�}Wntk
r(d}YnX|p0d}d|j|fS)Nrz[unknown version]z%s %s)r�rLr)r�rrrrr��
s
zDistribution.__str__cCs|�d�rt|��t|j|�S)zADelegate all unrecognized public attributes to .metadata providerr�)r�r�r�rq)r�r]rrr�__getattr__�
s
zDistribution.__getattr__cs.tttt|����tdd�|j��D��B�S)Ncss|]}|�d�s|VqdS�r�N)r�)r�r]rrrr�s
�z'Distribution.__dir__.<locals>.<genexpr>)rr�superrh�__dir__rqr�r:rrr�s���zDistribution.__dir__r�cKs|jt|�tj�|�|f|�Sr)r�rr�r�r�)r�r\r�r)rrrr�s
��zDistribution.from_filenamecCs<t|jtjj�r"d|j|jf}nd|j|jf}t�|�S)z?Return a ``Requirement`` that matches this distribution exactlyz%s==%sz%s===%s)r�rurrrrrir�)r��specrrrrszDistribution.as_requirementcCs.|�||�}|dkr&td||ff��|��S)z=Return the `name` entry point of `group` or raise ImportErrorNzEntry point %r not found)rVr�r�)r�rKr�rgrrrrTszDistribution.load_entry_pointcCsPz
|j}Wn,tk
r6t�|�d�|�}|_YnX|dk	rL|�|i�S|S)r�zentry_points.txtN)Z_ep_mapr�rjrkr�r�)r�rKZep_maprrrrU&s
�zDistribution.get_entry_mapcCs|�|��|�Sr�)rUr�rrrrrV2szDistribution.get_entry_infoc
Cs4|p|j}|sdSt|�}tj�|�}dd�|D�}t|�D]|\}}||kr^|rVq�q�dSq<||kr<|jtkr<|s�|||d�kr�dS|tjkr�|�	�|�
||�|�
||�q�q<|tjkr�|�	�|r�|�
d|�n
|�|�dSz|�||d�}	Wnt
k
�rY�q0Yq�X||	=||	=|	}q�dS)a�Ensure self.location is on path

        If replace=False (default):
            - If location is already in path anywhere, do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent.
              - Else: add to the end of path.
        If replace=True:
            - If location is already on path anywhere (not eggs)
              or higher priority than its parent (eggs)
              do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent,
                removing any lower-priority entries.
              - Else: add it to the front of path.
        NcSsg|]}|rt|�p|�qSrr/r0rrrr�Psz*Distribution.insert_on.<locals>.<listcomp>rr)rrr�r�rj�	enumeraterr}rG�check_version_conflictr	r�r3rL)
r�r��locr�ZnlocZbdirZnpathr1rZnprrrr6s@



zDistribution.insert_oncCs�|jdkrdSt�|�d��}t|j�}|�d�D]p}|tjks2||ks2|tkrRq2|dkr\q2t	tj|dd�}|r�t|��
|�s2|�
|j�r�q2td|||jf�q2dS)N�
setuptoolsr�z
top_level.txt)Z
pkg_resourcesr�ZsiterizIModule %s was already imported from %s, but %s is being added to sys.path)r8r'r(r�r|rrGr�r!r�r��
issue_warning)r�Znspr��modname�fnrrrr�zs*

�
�
��z#Distribution.check_version_conflictcCs6z
|jWn&tk
r0tdt|��YdSXdS)NzUnbuilt egg for FT)rrLr�r�r�rrrr3�s
zDistribution.has_versioncKs@d}|��D]}|�|t||d��q|�d|j�|jf|�S)z@Copy this distribution, substituting in any changed keyword argsz<project_name version py_version platform location precedenceNr�)rr�r�rqr�)r�r)rMr]rrr�clone�s
zDistribution.clonecCsdd�|jD�S)NcSsg|]}|r|�qSrr)r�Zdeprrrr��sz'Distribution.extras.<locals>.<listcomp>)r�r�rrrr�szDistribution.extras)N)r)NF)N)N)NF)3rrrrr�r=r}r�r r�rtr�r0rwrzr{r|r}r~rr8rur�rr�r`r�r�rr�r�r�r�r�r�r�r�r�r��objectr�rrTrUrVrr�r3r�r�
__classcell__rrr:rrh
st�










		

Dc@seZdZdd�ZdS)�EggInfoDistributioncCs|��}|r||_|S)a�
        Packages installed by distutils (e.g. numpy or scipy),
        which uses an old safe_version, and so
        their version numbers can get mangled when
        converted to filenames (e.g., 1.11.0.dev0+2329eae to
        1.11.0.dev0_2329eae). These distributions will not be
        parsed properly
        downstream by Distribution and safe_version, so
        take an extra step and try to get the version number from
        the metadata file itself instead of the filename.
        )r�rp)r�Z
md_versionrrrrt�sz#EggInfoDistribution._reload_versionN)rrrrtrrrrr��sr�c@s>eZdZdZdZe�d�Zedd��Z	edd��Z
dd	�Zd
S)�DistInfoDistributionzV
    Wrap an actual or potential sys.path entry
    w/metadata, .dist-info style.
    ZMETADATAz([\(,])\s*(\d.*?)\s*([,\)])cCsFz|jWStk
r@|�|j�}tj���|�|_|jYSXdS)zParse and cache metadataN)Z	_pkg_infor�r�r��email�parserZParserZparsestr)r�r�rrr�_parsed_pkg_info�sz%DistInfoDistribution._parsed_pkg_infocCs2z|jWStk
r,|��|_|jYSXdSr)�_DistInfoDistribution__dep_mapr��_compute_dependenciesr�rrrr��s

zDistInfoDistribution._dep_mapcs�dgi}|_g�|j�d�p gD]}��t|��q"�fdd�}t|d��}|d�|�|j�d�pjgD](}t|���}tt||��|�||<ql|S)z+Recompute this distribution's dependencies.Nz
Requires-Distc3s*�D] }|jr|j�d|i�r|VqdS)Nr!r")r!r��r�rr�reqs_for_extra�szBDistInfoDistribution._compute_dependencies.<locals>.reqs_for_extrazProvides-Extra)	r�r�Zget_allrrp�	frozensetrwrr)r�r�r�r��commonr!Zs_extrarr�rr��sz*DistInfoDistribution._compute_dependenciesN)rrrrr�rcr�ZEQEQr�r�r�r�rrrrr��s

	
r�)rKrr�cOsZd}t�}zt�|�j|kr&|d7}qWntk
r<YnXtj|d|di|��dS)Nrr�)r$rGr�r�rLrUrV)r>r)rZr.rrrr��sr�c@seZdZdd�ZdS)�RequirementParseErrorcCsd�|j�S)Nr�)rIr>r�rrrr��szRequirementParseError.__str__N)rrrr�rrrrr��sr�c	cs�tt|��}|D]l}d|kr.|d|�d��}|�d�rr|dd���}z|t|�7}Wntk
rpYdSXt|�VqdS)z�Yield ``Requirement`` objects for each specification in `strs`

    `strs` must be a string, or a (possibly-nested) iterable thereof.
    z #N�\���)rrur�r�rr�
StopIterationri)rOrerrrrrps

csPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Ze	d
d��Z
�ZS)ric
s�ztt|��|�Wn2tjjk
rF}ztt|���W5d}~XYnX|j|_	t
|j�}||��|_|_
dd�|jD�|_ttt|j��|_|j
|jt|j�|jr�t|j�ndf|_t|j�|_dS)z>DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!NcSsg|]}|j|jf�qSr)r4r)r�r�rrrr�#sz(Requirement.__init__.<locals>.<listcomp>)r�rir�rrZInvalidRequirementr�r�r�Zunsafe_namerqr.rr8�	specifierrdrSrrwrr�r#�hashCmprv�_Requirement__hash)r�Zrequirement_stringrhrr:rrr�s"
��zRequirement.__init__cCst|t�o|j|jkSr)r�rir�ryrrrr~.s

�zRequirement.__eq__cCs
||kSrrryrrrr4szRequirement.__ne__cCs0t|t�r |j|jkrdS|j}|jj|dd�S)NFT)Zprereleases)r�rhr8rr��contains)r�rrrrr�7s

zRequirement.__contains__cCs|jSr)r�r�rrrrwCszRequirement.__hash__cCsdt|�S)NzRequirement.parse(%r)rWr�rrrr�FszRequirement.__repr__cCst|�\}|Sr)rp)rPr�rrrr�Is
zRequirement.parse)rrrr�r~rr�rwr�r`r�r�rrr:rriscCst|kr|tfS|S)zJ
    Ensure object appears in the mro even
    for old-style classes.
    )r�)�classesrrr�_always_objectOs
r�cCs<tt�t|dt|����}|D]}||kr||SqdS)z2Return an adapter factory for `ob` from `registry`r�N)r��inspectZgetmror�r�)�registryr9r(�trrrr�Ysr�cCstj�|�}tj|dd�dS)z1Ensure that the parent directory of `path` existsT)�exist_okN)r�r�rjr�makedirs)r�rjrrrr{ascCsXtstd��t|�\}}|rT|rTt|�sTt|�zt|d�Wntk
rRYnXdS)z/Sandbox-bypassing version of ensure_directory()z*"os.mkdir" not supported on this platform.i�N)r�r�rr
rJr	�FileExistsError)r�rjr\rrrrJgsrJccsvd}g}t|�D]V}|�d�r\|�d�rP|s0|r:||fV|dd���}g}qftd|��q|�|�q||fVdS)asSplit a string or iterable thereof into (section, content) pairs

    Each ``section`` is a stripped version of the section header ("[section]")
    and each ``content`` is a list of stripped lines excluding blank lines and
    comment-only lines.  If there are any such lines before the first section
    header, they're returned in a first ``section`` of ``None``.
    N�[�]rr�zInvalid section heading)rur�r�rrLr�)rPZsectionZcontentrrrrrvts


cOs*tj}ztt_tj||�W�S|t_XdSr)r�r�os_open�tempfileZmkstemp)r>r)Zold_openrrrr��s
r�r")�categoryr�cOs|||�|Srr)r�r>rXrrr�_call_aside�s
r�cs.t���|d<|��fdd�t��D��dS)z=Set up global resource manager (deliberately not state-saved)Z_managerc3s&|]}|�d�s|t�|�fVqdSr�)r�r�r��r�rrr��s
�z_initialize.<locals>.<genexpr>N)rgr%r�)r.rr�r�_initialize�s
�r�cCs|t��}td|d�|j}|j}|j}|j}|}tdd�|D��|dd�dd�g|_t	t
|jtj
��t��t��d	S)
aE
    Prepare the master working set and make the ``require()``
    API available.

    This function has explicit effects on the global state
    of pkg_resources. It is intended to be invoked once at
    the initialization of this module.

    Invocation by other packages is unsupported and done
    at their own risk.
    r�)r_css|]}|jdd�VqdS)FrN�r�)r�r�rrrr��s�z1_initialize_master_working_set.<locals>.<genexpr>cSs|jdd�S)NTrr�r�rrrr?�r@z0_initialize_master_working_set.<locals>.<lambda>F)rN)rfr�r*rPrWrrQrSr�rrr�rGr�r$r%r�)r_rPrWr`rQr�rrr�_initialize_master_working_set�s"
��r�c@seZdZdZdS)r�z�
    Base class for warning about deprecations in ``pkg_resources``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    Nrrrrrr��s)N)N)F)F)F)F)N)�rZ
__future__rrGr�ror�rcr(r�r�rUrQr[Zpkgutilr4rHrr�Zemail.parserr�rr�rBr�r�r�r�rr=r�Zimpr��	NameErrorrZpip._vendorrZpip._vendor.six.movesrrrrr	r
rr�rr�Zos.pathr
rZimportlib.machinery�	machineryr�rr�rrrr�r�Z
__metaclass__�version_info�RuntimeErrorryrrrPr_r`Zresources_streamrcZresource_dirrYrbr]rXrWr[rZr\r�r r!�RuntimeWarningrr#r&r*r0r1r5r:r;r<Z
_sget_noneZ
_sset_nonerO�__all__rKrkrlr�rmrnr�rr=r}r~rr�r�r�rRrJr�rDr�rEr�rsrtrQr�rSrTrUrVr�r�rfr'r
rer�rorgrdrqrrrwrxryrzr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rar�r�rrrrrr
rrZImpImporterr�rr�r.r,r^r�rBrCr|rFrr�rr*rurFrQ�VERBOSE�
IGNORECASErsrjrlrorhr�r�rrr�rLr�rprrir�r�r{rJrvr��filterwarningsr�r$r�r��Warningr�rrrr�<module>sZ



�2 




.

5	A
-*

 ""


	
�	
'3�
6


&site-packages/pip/_vendor/pkg_resources/__init__.py000064400000323315151446177000016510 0ustar00# coding: utf-8
"""
Package resource API
--------------------

A resource is a logical file contained within a package, or a logical
subdirectory thereof.  The package resource API expects resource names
to have their path parts separated with ``/``, *not* whatever the local
path separator is.  Do not use os.path operations to manipulate resource
names being passed into the API.

The package resource API is designed to work with normal filesystem packages,
.egg files, and unpacked .egg files.  It can also work in a limited way with
.zip files and with custom PEP 302 loaders that support the ``get_data()``
method.
"""

from __future__ import absolute_import

import sys
import os
import io
import time
import re
import types
import zipfile
import zipimport
import warnings
import stat
import functools
import pkgutil
import operator
import platform
import collections
import plistlib
import email.parser
import errno
import tempfile
import textwrap
import itertools
import inspect
import ntpath
import posixpath
from pkgutil import get_importer

try:
    import _imp
except ImportError:
    # Python 3.2 compatibility
    import imp as _imp

try:
    FileExistsError
except NameError:
    FileExistsError = OSError

from pip._vendor import six
from pip._vendor.six.moves import urllib, map, filter

# capture these to bypass sandboxing
from os import utime
try:
    from os import mkdir, rename, unlink
    WRITE_SUPPORT = True
except ImportError:
    # no write support, probably under GAE
    WRITE_SUPPORT = False

from os import open as os_open
from os.path import isdir, split

try:
    import importlib.machinery as importlib_machinery
    # access attribute to force import under delayed import mechanisms.
    importlib_machinery.__name__
except ImportError:
    importlib_machinery = None

from . import py31compat
from pip._vendor import appdirs
from pip._vendor import packaging
__import__('pip._vendor.packaging.version')
__import__('pip._vendor.packaging.specifiers')
__import__('pip._vendor.packaging.requirements')
__import__('pip._vendor.packaging.markers')


__metaclass__ = type


if (3, 0) < sys.version_info < (3, 4):
    raise RuntimeError("Python 3.4 or later is required")

if six.PY2:
    # Those builtin exceptions are only defined in Python 3
    PermissionError = None
    NotADirectoryError = None

# declare some globals that will be defined later to
# satisfy the linters.
require = None
working_set = None
add_activation_listener = None
resources_stream = None
cleanup_resources = None
resource_dir = None
resource_stream = None
set_extraction_path = None
resource_isdir = None
resource_string = None
iter_entry_points = None
resource_listdir = None
resource_filename = None
resource_exists = None
_distribution_finders = None
_namespace_handlers = None
_namespace_packages = None


class PEP440Warning(RuntimeWarning):
    """
    Used when there is an issue with a version or specifier not complying with
    PEP 440.
    """


def parse_version(v):
    try:
        return packaging.version.Version(v)
    except packaging.version.InvalidVersion:
        return packaging.version.LegacyVersion(v)


_state_vars = {}


def _declare_state(vartype, **kw):
    globals().update(kw)
    _state_vars.update(dict.fromkeys(kw, vartype))


def __getstate__():
    state = {}
    g = globals()
    for k, v in _state_vars.items():
        state[k] = g['_sget_' + v](g[k])
    return state


def __setstate__(state):
    g = globals()
    for k, v in state.items():
        g['_sset_' + _state_vars[k]](k, g[k], v)
    return state


def _sget_dict(val):
    return val.copy()


def _sset_dict(key, ob, state):
    ob.clear()
    ob.update(state)


def _sget_object(val):
    return val.__getstate__()


def _sset_object(key, ob, state):
    ob.__setstate__(state)


_sget_none = _sset_none = lambda *args: None


def get_supported_platform():
    """Return this platform's maximum compatible version.

    distutils.util.get_platform() normally reports the minimum version
    of Mac OS X that would be required to *use* extensions produced by
    distutils.  But what we want when checking compatibility is to know the
    version of Mac OS X that we are *running*.  To allow usage of packages that
    explicitly require a newer version of Mac OS X, we must also know the
    current version of the OS.

    If this condition occurs for any other platform with a version in its
    platform strings, this function should be extended accordingly.
    """
    plat = get_build_platform()
    m = macosVersionString.match(plat)
    if m is not None and sys.platform == "darwin":
        try:
            plat = 'macosx-%s-%s' % ('.'.join(_macosx_vers()[:2]), m.group(3))
        except ValueError:
            # not Mac OS X
            pass
    return plat


__all__ = [
    # Basic resource access and distribution/entry point discovery
    'require', 'run_script', 'get_provider', 'get_distribution',
    'load_entry_point', 'get_entry_map', 'get_entry_info',
    'iter_entry_points',
    'resource_string', 'resource_stream', 'resource_filename',
    'resource_listdir', 'resource_exists', 'resource_isdir',

    # Environmental control
    'declare_namespace', 'working_set', 'add_activation_listener',
    'find_distributions', 'set_extraction_path', 'cleanup_resources',
    'get_default_cache',

    # Primary implementation classes
    'Environment', 'WorkingSet', 'ResourceManager',
    'Distribution', 'Requirement', 'EntryPoint',

    # Exceptions
    'ResolutionError', 'VersionConflict', 'DistributionNotFound',
    'UnknownExtra', 'ExtractionError',

    # Warnings
    'PEP440Warning',

    # Parsing functions and string utilities
    'parse_requirements', 'parse_version', 'safe_name', 'safe_version',
    'get_platform', 'compatible_platforms', 'yield_lines', 'split_sections',
    'safe_extra', 'to_filename', 'invalid_marker', 'evaluate_marker',

    # filesystem utilities
    'ensure_directory', 'normalize_path',

    # Distribution "precedence" constants
    'EGG_DIST', 'BINARY_DIST', 'SOURCE_DIST', 'CHECKOUT_DIST', 'DEVELOP_DIST',

    # "Provider" interfaces, implementations, and registration/lookup APIs
    'IMetadataProvider', 'IResourceProvider', 'FileMetadata',
    'PathMetadata', 'EggMetadata', 'EmptyProvider', 'empty_provider',
    'NullProvider', 'EggProvider', 'DefaultProvider', 'ZipProvider',
    'register_finder', 'register_namespace_handler', 'register_loader_type',
    'fixup_namespace_packages', 'get_importer',

    # Warnings
    'PkgResourcesDeprecationWarning',

    # Deprecated/backward compatibility only
    'run_main', 'AvailableDistributions',
]


class ResolutionError(Exception):
    """Abstract base for dependency resolution errors"""

    def __repr__(self):
        return self.__class__.__name__ + repr(self.args)


class VersionConflict(ResolutionError):
    """
    An already-installed version conflicts with the requested version.

    Should be initialized with the installed Distribution and the requested
    Requirement.
    """

    _template = "{self.dist} is installed but {self.req} is required"

    @property
    def dist(self):
        return self.args[0]

    @property
    def req(self):
        return self.args[1]

    def report(self):
        return self._template.format(**locals())

    def with_context(self, required_by):
        """
        If required_by is non-empty, return a version of self that is a
        ContextualVersionConflict.
        """
        if not required_by:
            return self
        args = self.args + (required_by,)
        return ContextualVersionConflict(*args)


class ContextualVersionConflict(VersionConflict):
    """
    A VersionConflict that accepts a third parameter, the set of the
    requirements that required the installed Distribution.
    """

    _template = VersionConflict._template + ' by {self.required_by}'

    @property
    def required_by(self):
        return self.args[2]


class DistributionNotFound(ResolutionError):
    """A requested distribution was not found"""

    _template = ("The '{self.req}' distribution was not found "
                 "and is required by {self.requirers_str}")

    @property
    def req(self):
        return self.args[0]

    @property
    def requirers(self):
        return self.args[1]

    @property
    def requirers_str(self):
        if not self.requirers:
            return 'the application'
        return ', '.join(self.requirers)

    def report(self):
        return self._template.format(**locals())

    def __str__(self):
        return self.report()


class UnknownExtra(ResolutionError):
    """Distribution doesn't have an "extra feature" of the given name"""


_provider_factories = {}

PY_MAJOR = sys.version[:3]
EGG_DIST = 3
BINARY_DIST = 2
SOURCE_DIST = 1
CHECKOUT_DIST = 0
DEVELOP_DIST = -1


def register_loader_type(loader_type, provider_factory):
    """Register `provider_factory` to make providers for `loader_type`

    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
    and `provider_factory` is a function that, passed a *module* object,
    returns an ``IResourceProvider`` for that module.
    """
    _provider_factories[loader_type] = provider_factory


def get_provider(moduleOrReq):
    """Return an IResourceProvider for the named module or requirement"""
    if isinstance(moduleOrReq, Requirement):
        return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]
    try:
        module = sys.modules[moduleOrReq]
    except KeyError:
        __import__(moduleOrReq)
        module = sys.modules[moduleOrReq]
    loader = getattr(module, '__loader__', None)
    return _find_adapter(_provider_factories, loader)(module)


def _macosx_vers(_cache=[]):
    if not _cache:
        version = platform.mac_ver()[0]
        # fallback for MacPorts
        if version == '':
            plist = '/System/Library/CoreServices/SystemVersion.plist'
            if os.path.exists(plist):
                if hasattr(plistlib, 'readPlist'):
                    plist_content = plistlib.readPlist(plist)
                    if 'ProductVersion' in plist_content:
                        version = plist_content['ProductVersion']

        _cache.append(version.split('.'))
    return _cache[0]


def _macosx_arch(machine):
    return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)


def get_build_platform():
    """Return this platform's string for platform-specific distributions

    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
    needs some hacks for Linux and Mac OS X.
    """
    from sysconfig import get_platform

    plat = get_platform()
    if sys.platform == "darwin" and not plat.startswith('macosx-'):
        try:
            version = _macosx_vers()
            machine = os.uname()[4].replace(" ", "_")
            return "macosx-%d.%d-%s" % (
                int(version[0]), int(version[1]),
                _macosx_arch(machine),
            )
        except ValueError:
            # if someone is running a non-Mac darwin system, this will fall
            # through to the default implementation
            pass
    return plat


macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)")
darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)")
# XXX backward compat
get_platform = get_build_platform


def compatible_platforms(provided, required):
    """Can code for the `provided` platform run on the `required` platform?

    Returns true if either platform is ``None``, or the platforms are equal.

    XXX Needs compatibility checks for Linux and other unixy OSes.
    """
    if provided is None or required is None or provided == required:
        # easy case
        return True

    # Mac OS X special cases
    reqMac = macosVersionString.match(required)
    if reqMac:
        provMac = macosVersionString.match(provided)

        # is this a Mac package?
        if not provMac:
            # this is backwards compatibility for packages built before
            # setuptools 0.6. All packages built after this point will
            # use the new macosx designation.
            provDarwin = darwinVersionString.match(provided)
            if provDarwin:
                dversion = int(provDarwin.group(1))
                macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2))
                if dversion == 7 and macosversion >= "10.3" or \
                        dversion == 8 and macosversion >= "10.4":
                    return True
            # egg isn't macosx or legacy darwin
            return False

        # are they the same major version and machine type?
        if provMac.group(1) != reqMac.group(1) or \
                provMac.group(3) != reqMac.group(3):
            return False

        # is the required OS major update >= the provided one?
        if int(provMac.group(2)) > int(reqMac.group(2)):
            return False

        return True

    # XXX Linux and other platforms' special cases should go here
    return False


def run_script(dist_spec, script_name):
    """Locate distribution `dist_spec` and run its `script_name` script"""
    ns = sys._getframe(1).f_globals
    name = ns['__name__']
    ns.clear()
    ns['__name__'] = name
    require(dist_spec)[0].run_script(script_name, ns)


# backward compatibility
run_main = run_script


def get_distribution(dist):
    """Return a current distribution object for a Requirement or string"""
    if isinstance(dist, six.string_types):
        dist = Requirement.parse(dist)
    if isinstance(dist, Requirement):
        dist = get_provider(dist)
    if not isinstance(dist, Distribution):
        raise TypeError("Expected string, Requirement, or Distribution", dist)
    return dist


def load_entry_point(dist, group, name):
    """Return `name` entry point of `group` for `dist` or raise ImportError"""
    return get_distribution(dist).load_entry_point(group, name)


def get_entry_map(dist, group=None):
    """Return the entry point map for `group`, or the full entry map"""
    return get_distribution(dist).get_entry_map(group)


def get_entry_info(dist, group, name):
    """Return the EntryPoint object for `group`+`name`, or ``None``"""
    return get_distribution(dist).get_entry_info(group, name)


class IMetadataProvider:
    def has_metadata(name):
        """Does the package's distribution contain the named metadata?"""

    def get_metadata(name):
        """The named metadata resource as a string"""

    def get_metadata_lines(name):
        """Yield named metadata resource as list of non-blank non-comment lines

       Leading and trailing whitespace is stripped from each line, and lines
       with ``#`` as the first non-blank character are omitted."""

    def metadata_isdir(name):
        """Is the named metadata a directory?  (like ``os.path.isdir()``)"""

    def metadata_listdir(name):
        """List of metadata names in the directory (like ``os.listdir()``)"""

    def run_script(script_name, namespace):
        """Execute the named script in the supplied namespace dictionary"""


class IResourceProvider(IMetadataProvider):
    """An object that provides access to package resources"""

    def get_resource_filename(manager, resource_name):
        """Return a true filesystem path for `resource_name`

        `manager` must be an ``IResourceManager``"""

    def get_resource_stream(manager, resource_name):
        """Return a readable file-like object for `resource_name`

        `manager` must be an ``IResourceManager``"""

    def get_resource_string(manager, resource_name):
        """Return a string containing the contents of `resource_name`

        `manager` must be an ``IResourceManager``"""

    def has_resource(resource_name):
        """Does the package contain the named resource?"""

    def resource_isdir(resource_name):
        """Is the named resource a directory?  (like ``os.path.isdir()``)"""

    def resource_listdir(resource_name):
        """List of resource names in the directory (like ``os.listdir()``)"""


class WorkingSet:
    """A collection of active distributions on sys.path (or a similar list)"""

    def __init__(self, entries=None):
        """Create working set from list of path entries (default=sys.path)"""
        self.entries = []
        self.entry_keys = {}
        self.by_key = {}
        self.callbacks = []

        if entries is None:
            entries = sys.path

        for entry in entries:
            self.add_entry(entry)

    @classmethod
    def _build_master(cls):
        """
        Prepare the master working set.
        """
        ws = cls()
        try:
            from __main__ import __requires__
        except ImportError:
            # The main program does not list any requirements
            return ws

        # ensure the requirements are met
        try:
            ws.require(__requires__)
        except VersionConflict:
            return cls._build_from_requirements(__requires__)

        return ws

    @classmethod
    def _build_from_requirements(cls, req_spec):
        """
        Build a working set from a requirement spec. Rewrites sys.path.
        """
        # try it without defaults already on sys.path
        # by starting with an empty path
        ws = cls([])
        reqs = parse_requirements(req_spec)
        dists = ws.resolve(reqs, Environment())
        for dist in dists:
            ws.add(dist)

        # add any missing entries from sys.path
        for entry in sys.path:
            if entry not in ws.entries:
                ws.add_entry(entry)

        # then copy back to sys.path
        sys.path[:] = ws.entries
        return ws

    def add_entry(self, entry):
        """Add a path item to ``.entries``, finding any distributions on it

        ``find_distributions(entry, True)`` is used to find distributions
        corresponding to the path entry, and they are added.  `entry` is
        always appended to ``.entries``, even if it is already present.
        (This is because ``sys.path`` can contain the same value more than
        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
        equal ``sys.path``.)
        """
        self.entry_keys.setdefault(entry, [])
        self.entries.append(entry)
        for dist in find_distributions(entry, True):
            self.add(dist, entry, False)

    def __contains__(self, dist):
        """True if `dist` is the active distribution for its project"""
        return self.by_key.get(dist.key) == dist

    def find(self, req):
        """Find a distribution matching requirement `req`

        If there is an active distribution for the requested project, this
        returns it as long as it meets the version requirement specified by
        `req`.  But, if there is an active distribution for the project and it
        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
        If there is no active distribution for the requested project, ``None``
        is returned.
        """
        dist = self.by_key.get(req.key)
        if dist is not None and dist not in req:
            # XXX add more info
            raise VersionConflict(dist, req)
        return dist

    def iter_entry_points(self, group, name=None):
        """Yield entry point objects from `group` matching `name`

        If `name` is None, yields all entry points in `group` from all
        distributions in the working set, otherwise only ones matching
        both `group` and `name` are yielded (in distribution order).
        """
        return (
            entry
            for dist in self
            for entry in dist.get_entry_map(group).values()
            if name is None or name == entry.name
        )

    def run_script(self, requires, script_name):
        """Locate distribution for `requires` and run `script_name` script"""
        ns = sys._getframe(1).f_globals
        name = ns['__name__']
        ns.clear()
        ns['__name__'] = name
        self.require(requires)[0].run_script(script_name, ns)

    def __iter__(self):
        """Yield distributions for non-duplicate projects in the working set

        The yield order is the order in which the items' path entries were
        added to the working set.
        """
        seen = {}
        for item in self.entries:
            if item not in self.entry_keys:
                # workaround a cache issue
                continue

            for key in self.entry_keys[item]:
                if key not in seen:
                    seen[key] = 1
                    yield self.by_key[key]

    def add(self, dist, entry=None, insert=True, replace=False):
        """Add `dist` to working set, associated with `entry`

        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
        On exit from this routine, `entry` is added to the end of the working
        set's ``.entries`` (if it wasn't already present).

        `dist` is only added to the working set if it's for a project that
        doesn't already have a distribution in the set, unless `replace=True`.
        If it's added, any callbacks registered with the ``subscribe()`` method
        will be called.
        """
        if insert:
            dist.insert_on(self.entries, entry, replace=replace)

        if entry is None:
            entry = dist.location
        keys = self.entry_keys.setdefault(entry, [])
        keys2 = self.entry_keys.setdefault(dist.location, [])
        if not replace and dist.key in self.by_key:
            # ignore hidden distros
            return

        self.by_key[dist.key] = dist
        if dist.key not in keys:
            keys.append(dist.key)
        if dist.key not in keys2:
            keys2.append(dist.key)
        self._added_new(dist)

    def resolve(self, requirements, env=None, installer=None,
                replace_conflicting=False, extras=None):
        """List all distributions needed to (recursively) meet `requirements`

        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
        if supplied, should be an ``Environment`` instance.  If
        not supplied, it defaults to all distributions available within any
        entry or distribution in the working set.  `installer`, if supplied,
        will be invoked with each requirement that cannot be met by an
        already-installed distribution; it should return a ``Distribution`` or
        ``None``.

        Unless `replace_conflicting=True`, raises a VersionConflict exception
        if
        any requirements are found on the path that have the correct name but
        the wrong version.  Otherwise, if an `installer` is supplied it will be
        invoked to obtain the correct version of the requirement and activate
        it.

        `extras` is a list of the extras to be used with these requirements.
        This is important because extra requirements may look like `my_req;
        extra = "my_extra"`, which would otherwise be interpreted as a purely
        optional requirement.  Instead, we want to be able to assert that these
        requirements are truly required.
        """

        # set up the stack
        requirements = list(requirements)[::-1]
        # set of processed requirements
        processed = {}
        # key -> dist
        best = {}
        to_activate = []

        req_extras = _ReqExtras()

        # Mapping of requirement to set of distributions that required it;
        # useful for reporting info about conflicts.
        required_by = collections.defaultdict(set)

        while requirements:
            # process dependencies breadth-first
            req = requirements.pop(0)
            if req in processed:
                # Ignore cyclic or redundant dependencies
                continue

            if not req_extras.markers_pass(req, extras):
                continue

            dist = best.get(req.key)
            if dist is None:
                # Find the best distribution and add it to the map
                dist = self.by_key.get(req.key)
                if dist is None or (dist not in req and replace_conflicting):
                    ws = self
                    if env is None:
                        if dist is None:
                            env = Environment(self.entries)
                        else:
                            # Use an empty environment and workingset to avoid
                            # any further conflicts with the conflicting
                            # distribution
                            env = Environment([])
                            ws = WorkingSet([])
                    dist = best[req.key] = env.best_match(
                        req, ws, installer,
                        replace_conflicting=replace_conflicting
                    )
                    if dist is None:
                        requirers = required_by.get(req, None)
                        raise DistributionNotFound(req, requirers)
                to_activate.append(dist)
            if dist not in req:
                # Oops, the "best" so far conflicts with a dependency
                dependent_req = required_by[req]
                raise VersionConflict(dist, req).with_context(dependent_req)

            # push the new requirements onto the stack
            new_requirements = dist.requires(req.extras)[::-1]
            requirements.extend(new_requirements)

            # Register the new requirements needed by req
            for new_requirement in new_requirements:
                required_by[new_requirement].add(req.project_name)
                req_extras[new_requirement] = req.extras

            processed[req] = True

        # return list of distros to activate
        return to_activate

    def find_plugins(
            self, plugin_env, full_env=None, installer=None, fallback=True):
        """Find all activatable distributions in `plugin_env`

        Example usage::

            distributions, errors = working_set.find_plugins(
                Environment(plugin_dirlist)
            )
            # add plugins+libs to sys.path
            map(working_set.add, distributions)
            # display errors
            print('Could not load', errors)

        The `plugin_env` should be an ``Environment`` instance that contains
        only distributions that are in the project's "plugin directory" or
        directories. The `full_env`, if supplied, should be an ``Environment``
        contains all currently-available distributions.  If `full_env` is not
        supplied, one is created automatically from the ``WorkingSet`` this
        method is called on, which will typically mean that every directory on
        ``sys.path`` will be scanned for distributions.

        `installer` is a standard installer callback as used by the
        ``resolve()`` method. The `fallback` flag indicates whether we should
        attempt to resolve older versions of a plugin if the newest version
        cannot be resolved.

        This method returns a 2-tuple: (`distributions`, `error_info`), where
        `distributions` is a list of the distributions found in `plugin_env`
        that were loadable, along with any other distributions that are needed
        to resolve their dependencies.  `error_info` is a dictionary mapping
        unloadable plugin distributions to an exception instance describing the
        error that occurred. Usually this will be a ``DistributionNotFound`` or
        ``VersionConflict`` instance.
        """

        plugin_projects = list(plugin_env)
        # scan project names in alphabetic order
        plugin_projects.sort()

        error_info = {}
        distributions = {}

        if full_env is None:
            env = Environment(self.entries)
            env += plugin_env
        else:
            env = full_env + plugin_env

        shadow_set = self.__class__([])
        # put all our entries in shadow_set
        list(map(shadow_set.add, self))

        for project_name in plugin_projects:

            for dist in plugin_env[project_name]:

                req = [dist.as_requirement()]

                try:
                    resolvees = shadow_set.resolve(req, env, installer)

                except ResolutionError as v:
                    # save error info
                    error_info[dist] = v
                    if fallback:
                        # try the next older version of project
                        continue
                    else:
                        # give up on this project, keep going
                        break

                else:
                    list(map(shadow_set.add, resolvees))
                    distributions.update(dict.fromkeys(resolvees))

                    # success, no need to try any more versions of this project
                    break

        distributions = list(distributions)
        distributions.sort()

        return distributions, error_info

    def require(self, *requirements):
        """Ensure that distributions matching `requirements` are activated

        `requirements` must be a string or a (possibly-nested) sequence
        thereof, specifying the distributions and versions required.  The
        return value is a sequence of the distributions that needed to be
        activated to fulfill the requirements; all relevant distributions are
        included, even if they were already activated in this working set.
        """
        needed = self.resolve(parse_requirements(requirements))

        for dist in needed:
            self.add(dist)

        return needed

    def subscribe(self, callback, existing=True):
        """Invoke `callback` for all distributions

        If `existing=True` (default),
        call on all existing ones, as well.
        """
        if callback in self.callbacks:
            return
        self.callbacks.append(callback)
        if not existing:
            return
        for dist in self:
            callback(dist)

    def _added_new(self, dist):
        for callback in self.callbacks:
            callback(dist)

    def __getstate__(self):
        return (
            self.entries[:], self.entry_keys.copy(), self.by_key.copy(),
            self.callbacks[:]
        )

    def __setstate__(self, e_k_b_c):
        entries, keys, by_key, callbacks = e_k_b_c
        self.entries = entries[:]
        self.entry_keys = keys.copy()
        self.by_key = by_key.copy()
        self.callbacks = callbacks[:]


class _ReqExtras(dict):
    """
    Map each requirement to the extras that demanded it.
    """

    def markers_pass(self, req, extras=None):
        """
        Evaluate markers for req against each extra that
        demanded it.

        Return False if the req has a marker and fails
        evaluation. Otherwise, return True.
        """
        extra_evals = (
            req.marker.evaluate({'extra': extra})
            for extra in self.get(req, ()) + (extras or (None,))
        )
        return not req.marker or any(extra_evals)


class Environment:
    """Searchable snapshot of distributions on a search path"""

    def __init__(
            self, search_path=None, platform=get_supported_platform(),
            python=PY_MAJOR):
        """Snapshot distributions available on a search path

        Any distributions found on `search_path` are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.

        `platform` is an optional string specifying the name of the platform
        that platform-specific distributions must be compatible with.  If
        unspecified, it defaults to the current platform.  `python` is an
        optional string naming the desired version of Python (e.g. ``'3.6'``);
        it defaults to the current version.

        You may explicitly set `platform` (and/or `python`) to ``None`` if you
        wish to map *all* distributions, not just those compatible with the
        running platform or Python version.
        """
        self._distmap = {}
        self.platform = platform
        self.python = python
        self.scan(search_path)

    def can_add(self, dist):
        """Is distribution `dist` acceptable for this environment?

        The distribution must match the platform and python version
        requirements specified when this environment was created, or False
        is returned.
        """
        py_compat = (
            self.python is None
            or dist.py_version is None
            or dist.py_version == self.python
        )
        return py_compat and compatible_platforms(dist.platform, self.platform)

    def remove(self, dist):
        """Remove `dist` from the environment"""
        self._distmap[dist.key].remove(dist)

    def scan(self, search_path=None):
        """Scan `search_path` for distributions usable in this environment

        Any distributions found are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.  Only distributions conforming to
        the platform/python version defined at initialization are added.
        """
        if search_path is None:
            search_path = sys.path

        for item in search_path:
            for dist in find_distributions(item):
                self.add(dist)

    def __getitem__(self, project_name):
        """Return a newest-to-oldest list of distributions for `project_name`

        Uses case-insensitive `project_name` comparison, assuming all the
        project's distributions use their project's name converted to all
        lowercase as their key.

        """
        distribution_key = project_name.lower()
        return self._distmap.get(distribution_key, [])

    def add(self, dist):
        """Add `dist` if we ``can_add()`` it and it has not already been added
        """
        if self.can_add(dist) and dist.has_version():
            dists = self._distmap.setdefault(dist.key, [])
            if dist not in dists:
                dists.append(dist)
                dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)

    def best_match(
            self, req, working_set, installer=None, replace_conflicting=False):
        """Find distribution best matching `req` and usable on `working_set`

        This calls the ``find(req)`` method of the `working_set` to see if a
        suitable distribution is already active.  (This may raise
        ``VersionConflict`` if an unsuitable version of the project is already
        active in the specified `working_set`.)  If a suitable distribution
        isn't active, this method returns the newest distribution in the
        environment that meets the ``Requirement`` in `req`.  If no suitable
        distribution is found, and `installer` is supplied, then the result of
        calling the environment's ``obtain(req, installer)`` method will be
        returned.
        """
        try:
            dist = working_set.find(req)
        except VersionConflict:
            if not replace_conflicting:
                raise
            dist = None
        if dist is not None:
            return dist
        for dist in self[req.key]:
            if dist in req:
                return dist
        # try to download/install
        return self.obtain(req, installer)

    def obtain(self, requirement, installer=None):
        """Obtain a distribution matching `requirement` (e.g. via download)

        Obtain a distro that matches requirement (e.g. via download).  In the
        base ``Environment`` class, this routine just returns
        ``installer(requirement)``, unless `installer` is None, in which case
        None is returned instead.  This method is a hook that allows subclasses
        to attempt other ways of obtaining a distribution before falling back
        to the `installer` argument."""
        if installer is not None:
            return installer(requirement)

    def __iter__(self):
        """Yield the unique project names of the available distributions"""
        for key in self._distmap.keys():
            if self[key]:
                yield key

    def __iadd__(self, other):
        """In-place addition of a distribution or environment"""
        if isinstance(other, Distribution):
            self.add(other)
        elif isinstance(other, Environment):
            for project in other:
                for dist in other[project]:
                    self.add(dist)
        else:
            raise TypeError("Can't add %r to environment" % (other,))
        return self

    def __add__(self, other):
        """Add an environment or distribution to an environment"""
        new = self.__class__([], platform=None, python=None)
        for env in self, other:
            new += env
        return new


# XXX backward compatibility
AvailableDistributions = Environment


class ExtractionError(RuntimeError):
    """An error occurred extracting a resource

    The following attributes are available from instances of this exception:

    manager
        The resource manager that raised this exception

    cache_path
        The base directory for resource extraction

    original_error
        The exception instance that caused extraction to fail
    """


class ResourceManager:
    """Manage resource extraction and packages"""
    extraction_path = None

    def __init__(self):
        self.cached_files = {}

    def resource_exists(self, package_or_requirement, resource_name):
        """Does the named resource exist?"""
        return get_provider(package_or_requirement).has_resource(resource_name)

    def resource_isdir(self, package_or_requirement, resource_name):
        """Is the named resource an existing directory?"""
        return get_provider(package_or_requirement).resource_isdir(
            resource_name
        )

    def resource_filename(self, package_or_requirement, resource_name):
        """Return a true filesystem path for specified resource"""
        return get_provider(package_or_requirement).get_resource_filename(
            self, resource_name
        )

    def resource_stream(self, package_or_requirement, resource_name):
        """Return a readable file-like object for specified resource"""
        return get_provider(package_or_requirement).get_resource_stream(
            self, resource_name
        )

    def resource_string(self, package_or_requirement, resource_name):
        """Return specified resource as a string"""
        return get_provider(package_or_requirement).get_resource_string(
            self, resource_name
        )

    def resource_listdir(self, package_or_requirement, resource_name):
        """List the contents of the named resource directory"""
        return get_provider(package_or_requirement).resource_listdir(
            resource_name
        )

    def extraction_error(self):
        """Give an error message for problems extracting file(s)"""

        old_exc = sys.exc_info()[1]
        cache_path = self.extraction_path or get_default_cache()

        tmpl = textwrap.dedent("""
            Can't extract file(s) to egg cache

            The following error occurred while trying to extract file(s)
            to the Python egg cache:

              {old_exc}

            The Python egg cache directory is currently set to:

              {cache_path}

            Perhaps your account does not have write access to this directory?
            You can change the cache directory by setting the PYTHON_EGG_CACHE
            environment variable to point to an accessible directory.
            """).lstrip()
        err = ExtractionError(tmpl.format(**locals()))
        err.manager = self
        err.cache_path = cache_path
        err.original_error = old_exc
        raise err

    def get_cache_path(self, archive_name, names=()):
        """Return absolute location in cache for `archive_name` and `names`

        The parent directory of the resulting path will be created if it does
        not already exist.  `archive_name` should be the base filename of the
        enclosing egg (which may not be the name of the enclosing zipfile!),
        including its ".egg" extension.  `names`, if provided, should be a
        sequence of path name parts "under" the egg's extraction location.

        This method should only be called by resource providers that need to
        obtain an extraction location, and only for names they intend to
        extract, as it tracks the generated names for possible cleanup later.
        """
        extract_path = self.extraction_path or get_default_cache()
        target_path = os.path.join(extract_path, archive_name + '-tmp', *names)
        try:
            _bypass_ensure_directory(target_path)
        except Exception:
            self.extraction_error()

        self._warn_unsafe_extraction_path(extract_path)

        self.cached_files[target_path] = 1
        return target_path

    @staticmethod
    def _warn_unsafe_extraction_path(path):
        """
        If the default extraction path is overridden and set to an insecure
        location, such as /tmp, it opens up an opportunity for an attacker to
        replace an extracted file with an unauthorized payload. Warn the user
        if a known insecure location is used.

        See Distribute #375 for more details.
        """
        if os.name == 'nt' and not path.startswith(os.environ['windir']):
            # On Windows, permissions are generally restrictive by default
            #  and temp directories are not writable by other users, so
            #  bypass the warning.
            return
        mode = os.stat(path).st_mode
        if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
            msg = (
                "%s is writable by group/others and vulnerable to attack "
                "when "
                "used with get_resource_filename. Consider a more secure "
                "location (set with .set_extraction_path or the "
                "PYTHON_EGG_CACHE environment variable)." % path
            )
            warnings.warn(msg, UserWarning)

    def postprocess(self, tempname, filename):
        """Perform any platform-specific postprocessing of `tempname`

        This is where Mac header rewrites should be done; other platforms don't
        have anything special they should do.

        Resource providers should call this method ONLY after successfully
        extracting a compressed resource.  They must NOT call it on resources
        that are already in the filesystem.

        `tempname` is the current (temporary) name of the file, and `filename`
        is the name it will be renamed to by the caller after this routine
        returns.
        """

        if os.name == 'posix':
            # Make the resource executable
            mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777
            os.chmod(tempname, mode)

    def set_extraction_path(self, path):
        """Set the base path where resources will be extracted to, if needed.

        If you do not call this routine before any extractions take place, the
        path defaults to the return value of ``get_default_cache()``.  (Which
        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
        platform-specific fallbacks.  See that routine's documentation for more
        details.)

        Resources are extracted to subdirectories of this path based upon
        information given by the ``IResourceProvider``.  You may set this to a
        temporary directory, but then you must call ``cleanup_resources()`` to
        delete the extracted files when done.  There is no guarantee that
        ``cleanup_resources()`` will be able to remove all extracted files.

        (Note: you may not change the extraction path for a given resource
        manager once resources have been extracted, unless you first call
        ``cleanup_resources()``.)
        """
        if self.cached_files:
            raise ValueError(
                "Can't change extraction path, files already extracted"
            )

        self.extraction_path = path

    def cleanup_resources(self, force=False):
        """
        Delete all extracted resource files and directories, returning a list
        of the file and directory names that could not be successfully removed.
        This function does not have any concurrency protection, so it should
        generally only be called when the extraction path is a temporary
        directory exclusive to a single process.  This method is not
        automatically called; you must call it explicitly or register it as an
        ``atexit`` function if you wish to ensure cleanup of a temporary
        directory used for extractions.
        """
        # XXX


def get_default_cache():
    """
    Return the ``PYTHON_EGG_CACHE`` environment variable
    or a platform-relevant user cache dir for an app
    named "Python-Eggs".
    """
    return (
        os.environ.get('PYTHON_EGG_CACHE')
        or appdirs.user_cache_dir(appname='Python-Eggs')
    )


def safe_name(name):
    """Convert an arbitrary string to a standard distribution name

    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
    """
    return re.sub('[^A-Za-z0-9.]+', '-', name)


def safe_version(version):
    """
    Convert an arbitrary string to a standard version string
    """
    try:
        # normalize the version
        return str(packaging.version.Version(version))
    except packaging.version.InvalidVersion:
        version = version.replace(' ', '.')
        return re.sub('[^A-Za-z0-9.]+', '-', version)


def safe_extra(extra):
    """Convert an arbitrary string to a standard 'extra' name

    Any runs of non-alphanumeric characters are replaced with a single '_',
    and the result is always lowercased.
    """
    return re.sub('[^A-Za-z0-9.-]+', '_', extra).lower()


def to_filename(name):
    """Convert a project or version name to its filename-escaped form

    Any '-' characters are currently replaced with '_'.
    """
    return name.replace('-', '_')


def invalid_marker(text):
    """
    Validate text as a PEP 508 environment marker; return an exception
    if invalid or False otherwise.
    """
    try:
        evaluate_marker(text)
    except SyntaxError as e:
        e.filename = None
        e.lineno = None
        return e
    return False


def evaluate_marker(text, extra=None):
    """
    Evaluate a PEP 508 environment marker.
    Return a boolean indicating the marker result in this environment.
    Raise SyntaxError if marker is invalid.

    This implementation uses the 'pyparsing' module.
    """
    try:
        marker = packaging.markers.Marker(text)
        return marker.evaluate()
    except packaging.markers.InvalidMarker as e:
        raise SyntaxError(e)


class NullProvider:
    """Try to implement resources and metadata for arbitrary PEP 302 loaders"""

    egg_name = None
    egg_info = None
    loader = None

    def __init__(self, module):
        self.loader = getattr(module, '__loader__', None)
        self.module_path = os.path.dirname(getattr(module, '__file__', ''))

    def get_resource_filename(self, manager, resource_name):
        return self._fn(self.module_path, resource_name)

    def get_resource_stream(self, manager, resource_name):
        return io.BytesIO(self.get_resource_string(manager, resource_name))

    def get_resource_string(self, manager, resource_name):
        return self._get(self._fn(self.module_path, resource_name))

    def has_resource(self, resource_name):
        return self._has(self._fn(self.module_path, resource_name))

    def _get_metadata_path(self, name):
        return self._fn(self.egg_info, name)

    def has_metadata(self, name):
        if not self.egg_info:
            return self.egg_info

        path = self._get_metadata_path(name)
        return self._has(path)

    def get_metadata(self, name):
        if not self.egg_info:
            return ""
        path = self._get_metadata_path(name)
        value = self._get(path)
        if six.PY2:
            return value
        try:
            return value.decode('utf-8')
        except UnicodeDecodeError as exc:
            # Include the path in the error message to simplify
            # troubleshooting, and without changing the exception type.
            exc.reason += ' in {} file at path: {}'.format(name, path)
            raise

    def get_metadata_lines(self, name):
        return yield_lines(self.get_metadata(name))

    def resource_isdir(self, resource_name):
        return self._isdir(self._fn(self.module_path, resource_name))

    def metadata_isdir(self, name):
        return self.egg_info and self._isdir(self._fn(self.egg_info, name))

    def resource_listdir(self, resource_name):
        return self._listdir(self._fn(self.module_path, resource_name))

    def metadata_listdir(self, name):
        if self.egg_info:
            return self._listdir(self._fn(self.egg_info, name))
        return []

    def run_script(self, script_name, namespace):
        script = 'scripts/' + script_name
        if not self.has_metadata(script):
            raise ResolutionError(
                "Script {script!r} not found in metadata at {self.egg_info!r}"
                .format(**locals()),
            )
        script_text = self.get_metadata(script).replace('\r\n', '\n')
        script_text = script_text.replace('\r', '\n')
        script_filename = self._fn(self.egg_info, script)
        namespace['__file__'] = script_filename
        if os.path.exists(script_filename):
            source = open(script_filename).read()
            code = compile(source, script_filename, 'exec')
            exec(code, namespace, namespace)
        else:
            from linecache import cache
            cache[script_filename] = (
                len(script_text), 0, script_text.split('\n'), script_filename
            )
            script_code = compile(script_text, script_filename, 'exec')
            exec(script_code, namespace, namespace)

    def _has(self, path):
        raise NotImplementedError(
            "Can't perform this operation for unregistered loader type"
        )

    def _isdir(self, path):
        raise NotImplementedError(
            "Can't perform this operation for unregistered loader type"
        )

    def _listdir(self, path):
        raise NotImplementedError(
            "Can't perform this operation for unregistered loader type"
        )

    def _fn(self, base, resource_name):
        self._validate_resource_path(resource_name)
        if resource_name:
            return os.path.join(base, *resource_name.split('/'))
        return base

    @staticmethod
    def _validate_resource_path(path):
        """
        Validate the resource paths according to the docs.
        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access

        >>> warned = getfixture('recwarn')
        >>> warnings.simplefilter('always')
        >>> vrp = NullProvider._validate_resource_path
        >>> vrp('foo/bar.txt')
        >>> bool(warned)
        False
        >>> vrp('../foo/bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('/foo/bar.txt')
        >>> bool(warned)
        True
        >>> vrp('foo/../../bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('foo/f../bar.txt')
        >>> bool(warned)
        False

        Windows path separators are straight-up disallowed.
        >>> vrp(r'\\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path \
is not allowed.

        >>> vrp(r'C:\\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path \
is not allowed.

        Blank values are allowed

        >>> vrp('')
        >>> bool(warned)
        False

        Non-string values are not.

        >>> vrp(None)
        Traceback (most recent call last):
        ...
        AttributeError: ...
        """
        invalid = (
            os.path.pardir in path.split(posixpath.sep) or
            posixpath.isabs(path) or
            ntpath.isabs(path)
        )
        if not invalid:
            return

        msg = "Use of .. or absolute path in a resource path is not allowed."

        # Aggressively disallow Windows absolute paths
        if ntpath.isabs(path) and not posixpath.isabs(path):
            raise ValueError(msg)

        # for compatibility, warn; in future
        # raise ValueError(msg)
        warnings.warn(
            msg[:-1] + " and will raise exceptions in a future release.",
            DeprecationWarning,
            stacklevel=4,
        )

    def _get(self, path):
        if hasattr(self.loader, 'get_data'):
            return self.loader.get_data(path)
        raise NotImplementedError(
            "Can't perform this operation for loaders without 'get_data()'"
        )


register_loader_type(object, NullProvider)


class EggProvider(NullProvider):
    """Provider based on a virtual filesystem"""

    def __init__(self, module):
        NullProvider.__init__(self, module)
        self._setup_prefix()

    def _setup_prefix(self):
        # we assume here that our metadata may be nested inside a "basket"
        # of multiple eggs; that's why we use module_path instead of .archive
        path = self.module_path
        old = None
        while path != old:
            if _is_egg_path(path):
                self.egg_name = os.path.basename(path)
                self.egg_info = os.path.join(path, 'EGG-INFO')
                self.egg_root = path
                break
            old = path
            path, base = os.path.split(path)


class DefaultProvider(EggProvider):
    """Provides access to package resources in the filesystem"""

    def _has(self, path):
        return os.path.exists(path)

    def _isdir(self, path):
        return os.path.isdir(path)

    def _listdir(self, path):
        return os.listdir(path)

    def get_resource_stream(self, manager, resource_name):
        return open(self._fn(self.module_path, resource_name), 'rb')

    def _get(self, path):
        with open(path, 'rb') as stream:
            return stream.read()

    @classmethod
    def _register(cls):
        loader_names = 'SourceFileLoader', 'SourcelessFileLoader',
        for name in loader_names:
            loader_cls = getattr(importlib_machinery, name, type(None))
            register_loader_type(loader_cls, cls)


DefaultProvider._register()


class EmptyProvider(NullProvider):
    """Provider that returns nothing for all requests"""

    module_path = None

    _isdir = _has = lambda self, path: False

    def _get(self, path):
        return ''

    def _listdir(self, path):
        return []

    def __init__(self):
        pass


empty_provider = EmptyProvider()


class ZipManifests(dict):
    """
    zip manifest builder
    """

    @classmethod
    def build(cls, path):
        """
        Build a dictionary similar to the zipimport directory
        caches, except instead of tuples, store ZipInfo objects.

        Use a platform-specific path separator (os.sep) for the path keys
        for compatibility with pypy on Windows.
        """
        with zipfile.ZipFile(path) as zfile:
            items = (
                (
                    name.replace('/', os.sep),
                    zfile.getinfo(name),
                )
                for name in zfile.namelist()
            )
            return dict(items)

    load = build


class MemoizedZipManifests(ZipManifests):
    """
    Memoized zipfile manifests.
    """
    manifest_mod = collections.namedtuple('manifest_mod', 'manifest mtime')

    def load(self, path):
        """
        Load a manifest at path or return a suitable manifest already loaded.
        """
        path = os.path.normpath(path)
        mtime = os.stat(path).st_mtime

        if path not in self or self[path].mtime != mtime:
            manifest = self.build(path)
            self[path] = self.manifest_mod(manifest, mtime)

        return self[path].manifest


class ZipProvider(EggProvider):
    """Resource support for zips and eggs"""

    eagers = None
    _zip_manifests = MemoizedZipManifests()

    def __init__(self, module):
        EggProvider.__init__(self, module)
        self.zip_pre = self.loader.archive + os.sep

    def _zipinfo_name(self, fspath):
        # Convert a virtual filename (full path to file) into a zipfile subpath
        # usable with the zipimport directory cache for our target archive
        fspath = fspath.rstrip(os.sep)
        if fspath == self.loader.archive:
            return ''
        if fspath.startswith(self.zip_pre):
            return fspath[len(self.zip_pre):]
        raise AssertionError(
            "%s is not a subpath of %s" % (fspath, self.zip_pre)
        )

    def _parts(self, zip_path):
        # Convert a zipfile subpath into an egg-relative path part list.
        # pseudo-fs path
        fspath = self.zip_pre + zip_path
        if fspath.startswith(self.egg_root + os.sep):
            return fspath[len(self.egg_root) + 1:].split(os.sep)
        raise AssertionError(
            "%s is not a subpath of %s" % (fspath, self.egg_root)
        )

    @property
    def zipinfo(self):
        return self._zip_manifests.load(self.loader.archive)

    def get_resource_filename(self, manager, resource_name):
        if not self.egg_name:
            raise NotImplementedError(
                "resource_filename() only supported for .egg, not .zip"
            )
        # no need to lock for extraction, since we use temp names
        zip_path = self._resource_to_zip(resource_name)
        eagers = self._get_eager_resources()
        if '/'.join(self._parts(zip_path)) in eagers:
            for name in eagers:
                self._extract_resource(manager, self._eager_to_zip(name))
        return self._extract_resource(manager, zip_path)

    @staticmethod
    def _get_date_and_size(zip_stat):
        size = zip_stat.file_size
        # ymdhms+wday, yday, dst
        date_time = zip_stat.date_time + (0, 0, -1)
        # 1980 offset already done
        timestamp = time.mktime(date_time)
        return timestamp, size

    def _extract_resource(self, manager, zip_path):

        if zip_path in self._index():
            for name in self._index()[zip_path]:
                last = self._extract_resource(
                    manager, os.path.join(zip_path, name)
                )
            # return the extracted directory name
            return os.path.dirname(last)

        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])

        if not WRITE_SUPPORT:
            raise IOError('"os.rename" and "os.unlink" are not supported '
                          'on this platform')
        try:

            real_path = manager.get_cache_path(
                self.egg_name, self._parts(zip_path)
            )

            if self._is_current(real_path, zip_path):
                return real_path

            outf, tmpnam = _mkstemp(
                ".$extract",
                dir=os.path.dirname(real_path),
            )
            os.write(outf, self.loader.get_data(zip_path))
            os.close(outf)
            utime(tmpnam, (timestamp, timestamp))
            manager.postprocess(tmpnam, real_path)

            try:
                rename(tmpnam, real_path)

            except os.error:
                if os.path.isfile(real_path):
                    if self._is_current(real_path, zip_path):
                        # the file became current since it was checked above,
                        #  so proceed.
                        return real_path
                    # Windows, del old file and retry
                    elif os.name == 'nt':
                        unlink(real_path)
                        rename(tmpnam, real_path)
                        return real_path
                raise

        except os.error:
            # report a user-friendly error
            manager.extraction_error()

        return real_path

    def _is_current(self, file_path, zip_path):
        """
        Return True if the file_path is current for this zip_path
        """
        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
        if not os.path.isfile(file_path):
            return False
        stat = os.stat(file_path)
        if stat.st_size != size or stat.st_mtime != timestamp:
            return False
        # check that the contents match
        zip_contents = self.loader.get_data(zip_path)
        with open(file_path, 'rb') as f:
            file_contents = f.read()
        return zip_contents == file_contents

    def _get_eager_resources(self):
        if self.eagers is None:
            eagers = []
            for name in ('native_libs.txt', 'eager_resources.txt'):
                if self.has_metadata(name):
                    eagers.extend(self.get_metadata_lines(name))
            self.eagers = eagers
        return self.eagers

    def _index(self):
        try:
            return self._dirindex
        except AttributeError:
            ind = {}
            for path in self.zipinfo:
                parts = path.split(os.sep)
                while parts:
                    parent = os.sep.join(parts[:-1])
                    if parent in ind:
                        ind[parent].append(parts[-1])
                        break
                    else:
                        ind[parent] = [parts.pop()]
            self._dirindex = ind
            return ind

    def _has(self, fspath):
        zip_path = self._zipinfo_name(fspath)
        return zip_path in self.zipinfo or zip_path in self._index()

    def _isdir(self, fspath):
        return self._zipinfo_name(fspath) in self._index()

    def _listdir(self, fspath):
        return list(self._index().get(self._zipinfo_name(fspath), ()))

    def _eager_to_zip(self, resource_name):
        return self._zipinfo_name(self._fn(self.egg_root, resource_name))

    def _resource_to_zip(self, resource_name):
        return self._zipinfo_name(self._fn(self.module_path, resource_name))


register_loader_type(zipimport.zipimporter, ZipProvider)


class FileMetadata(EmptyProvider):
    """Metadata handler for standalone PKG-INFO files

    Usage::

        metadata = FileMetadata("/path/to/PKG-INFO")

    This provider rejects all data and metadata requests except for PKG-INFO,
    which is treated as existing, and will be the contents of the file at
    the provided location.
    """

    def __init__(self, path):
        self.path = path

    def _get_metadata_path(self, name):
        return self.path

    def has_metadata(self, name):
        return name == 'PKG-INFO' and os.path.isfile(self.path)

    def get_metadata(self, name):
        if name != 'PKG-INFO':
            raise KeyError("No metadata except PKG-INFO is available")

        with io.open(self.path, encoding='utf-8', errors="replace") as f:
            metadata = f.read()
        self._warn_on_replacement(metadata)
        return metadata

    def _warn_on_replacement(self, metadata):
        # Python 2.7 compat for: replacement_char = '�'
        replacement_char = b'\xef\xbf\xbd'.decode('utf-8')
        if replacement_char in metadata:
            tmpl = "{self.path} could not be properly decoded in UTF-8"
            msg = tmpl.format(**locals())
            warnings.warn(msg)

    def get_metadata_lines(self, name):
        return yield_lines(self.get_metadata(name))


class PathMetadata(DefaultProvider):
    """Metadata provider for egg directories

    Usage::

        # Development eggs:

        egg_info = "/path/to/PackageName.egg-info"
        base_dir = os.path.dirname(egg_info)
        metadata = PathMetadata(base_dir, egg_info)
        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)

        # Unpacked egg directories:

        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
        dist = Distribution.from_filename(egg_path, metadata=metadata)
    """

    def __init__(self, path, egg_info):
        self.module_path = path
        self.egg_info = egg_info


class EggMetadata(ZipProvider):
    """Metadata provider for .egg files"""

    def __init__(self, importer):
        """Create a metadata provider from a zipimporter"""

        self.zip_pre = importer.archive + os.sep
        self.loader = importer
        if importer.prefix:
            self.module_path = os.path.join(importer.archive, importer.prefix)
        else:
            self.module_path = importer.archive
        self._setup_prefix()


_declare_state('dict', _distribution_finders={})


def register_finder(importer_type, distribution_finder):
    """Register `distribution_finder` to find distributions in sys.path items

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `distribution_finder` is a callable that, passed a path
    item and the importer instance, yields ``Distribution`` instances found on
    that path item.  See ``pkg_resources.find_on_path`` for an example."""
    _distribution_finders[importer_type] = distribution_finder


def find_distributions(path_item, only=False):
    """Yield distributions accessible via `path_item`"""
    importer = get_importer(path_item)
    finder = _find_adapter(_distribution_finders, importer)
    return finder(importer, path_item, only)


def find_eggs_in_zip(importer, path_item, only=False):
    """
    Find eggs in zip files; possibly multiple nested eggs.
    """
    if importer.archive.endswith('.whl'):
        # wheels are not supported with this finder
        # they don't have PKG-INFO metadata, and won't ever contain eggs
        return
    metadata = EggMetadata(importer)
    if metadata.has_metadata('PKG-INFO'):
        yield Distribution.from_filename(path_item, metadata=metadata)
    if only:
        # don't yield nested distros
        return
    for subitem in metadata.resource_listdir(''):
        if _is_egg_path(subitem):
            subpath = os.path.join(path_item, subitem)
            dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
            for dist in dists:
                yield dist
        elif subitem.lower().endswith('.dist-info'):
            subpath = os.path.join(path_item, subitem)
            submeta = EggMetadata(zipimport.zipimporter(subpath))
            submeta.egg_info = subpath
            yield Distribution.from_location(path_item, subitem, submeta)


register_finder(zipimport.zipimporter, find_eggs_in_zip)


def find_nothing(importer, path_item, only=False):
    return ()


register_finder(object, find_nothing)


def _by_version_descending(names):
    """
    Given a list of filenames, return them in descending order
    by version number.

    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
    >>> _by_version_descending(names)
    ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg']
    """
    def _by_version(name):
        """
        Parse each component of the filename
        """
        name, ext = os.path.splitext(name)
        parts = itertools.chain(name.split('-'), [ext])
        return [packaging.version.parse(part) for part in parts]

    return sorted(names, key=_by_version, reverse=True)


def find_on_path(importer, path_item, only=False):
    """Yield distributions accessible on a sys.path directory"""
    path_item = _normalize_cached(path_item)

    if _is_unpacked_egg(path_item):
        yield Distribution.from_filename(
            path_item, metadata=PathMetadata(
                path_item, os.path.join(path_item, 'EGG-INFO')
            )
        )
        return

    entries = safe_listdir(path_item)

    # for performance, before sorting by version,
    # screen entries for only those that will yield
    # distributions
    filtered = (
        entry
        for entry in entries
        if dist_factory(path_item, entry, only)
    )

    # scan for .egg and .egg-info in directory
    path_item_entries = _by_version_descending(filtered)
    for entry in path_item_entries:
        fullpath = os.path.join(path_item, entry)
        factory = dist_factory(path_item, entry, only)
        for dist in factory(fullpath):
            yield dist


def dist_factory(path_item, entry, only):
    """
    Return a dist_factory for a path_item and entry
    """
    lower = entry.lower()
    is_meta = any(map(lower.endswith, ('.egg-info', '.dist-info')))
    return (
        distributions_from_metadata
        if is_meta else
        find_distributions
        if not only and _is_egg_path(entry) else
        resolve_egg_link
        if not only and lower.endswith('.egg-link') else
        NoDists()
    )


class NoDists:
    """
    >>> bool(NoDists())
    False

    >>> list(NoDists()('anything'))
    []
    """
    def __bool__(self):
        return False
    if six.PY2:
        __nonzero__ = __bool__

    def __call__(self, fullpath):
        return iter(())


def safe_listdir(path):
    """
    Attempt to list contents of path, but suppress some exceptions.
    """
    try:
        return os.listdir(path)
    except (PermissionError, NotADirectoryError):
        pass
    except OSError as e:
        # Ignore the directory if does not exist, not a directory or
        # permission denied
        ignorable = (
            e.errno in (errno.ENOTDIR, errno.EACCES, errno.ENOENT)
            # Python 2 on Windows needs to be handled this way :(
            or getattr(e, "winerror", None) == 267
        )
        if not ignorable:
            raise
    return ()


def distributions_from_metadata(path):
    root = os.path.dirname(path)
    if os.path.isdir(path):
        if len(os.listdir(path)) == 0:
            # empty metadata dir; skip
            return
        metadata = PathMetadata(root, path)
    else:
        metadata = FileMetadata(path)
    entry = os.path.basename(path)
    yield Distribution.from_location(
        root, entry, metadata, precedence=DEVELOP_DIST,
    )


def non_empty_lines(path):
    """
    Yield non-empty lines from file at path
    """
    with open(path) as f:
        for line in f:
            line = line.strip()
            if line:
                yield line


def resolve_egg_link(path):
    """
    Given a path to an .egg-link, resolve distributions
    present in the referenced path.
    """
    referenced_paths = non_empty_lines(path)
    resolved_paths = (
        os.path.join(os.path.dirname(path), ref)
        for ref in referenced_paths
    )
    dist_groups = map(find_distributions, resolved_paths)
    return next(dist_groups, ())


register_finder(pkgutil.ImpImporter, find_on_path)

if hasattr(importlib_machinery, 'FileFinder'):
    register_finder(importlib_machinery.FileFinder, find_on_path)

_declare_state('dict', _namespace_handlers={})
_declare_state('dict', _namespace_packages={})


def register_namespace_handler(importer_type, namespace_handler):
    """Register `namespace_handler` to declare namespace packages

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `namespace_handler` is a callable like this::

        def namespace_handler(importer, path_entry, moduleName, module):
            # return a path_entry to use for child packages

    Namespace handlers are only called if the importer object has already
    agreed that it can handle the relevant path item, and they should only
    return a subpath if the module __path__ does not already contain an
    equivalent subpath.  For an example namespace handler, see
    ``pkg_resources.file_ns_handler``.
    """
    _namespace_handlers[importer_type] = namespace_handler


def _handle_ns(packageName, path_item):
    """Ensure that named package includes a subpath of path_item (if needed)"""

    importer = get_importer(path_item)
    if importer is None:
        return None

    # capture warnings due to #1111
    with warnings.catch_warnings():
        warnings.simplefilter("ignore")
        loader = importer.find_module(packageName)

    if loader is None:
        return None
    module = sys.modules.get(packageName)
    if module is None:
        module = sys.modules[packageName] = types.ModuleType(packageName)
        module.__path__ = []
        _set_parent_ns(packageName)
    elif not hasattr(module, '__path__'):
        raise TypeError("Not a package:", packageName)
    handler = _find_adapter(_namespace_handlers, importer)
    subpath = handler(importer, path_item, packageName, module)
    if subpath is not None:
        path = module.__path__
        path.append(subpath)
        loader.load_module(packageName)
        _rebuild_mod_path(path, packageName, module)
    return subpath


def _rebuild_mod_path(orig_path, package_name, module):
    """
    Rebuild module.__path__ ensuring that all entries are ordered
    corresponding to their sys.path order
    """
    sys_path = [_normalize_cached(p) for p in sys.path]

    def safe_sys_path_index(entry):
        """
        Workaround for #520 and #513.
        """
        try:
            return sys_path.index(entry)
        except ValueError:
            return float('inf')

    def position_in_sys_path(path):
        """
        Return the ordinal of the path based on its position in sys.path
        """
        path_parts = path.split(os.sep)
        module_parts = package_name.count('.') + 1
        parts = path_parts[:-module_parts]
        return safe_sys_path_index(_normalize_cached(os.sep.join(parts)))

    new_path = sorted(orig_path, key=position_in_sys_path)
    new_path = [_normalize_cached(p) for p in new_path]

    if isinstance(module.__path__, list):
        module.__path__[:] = new_path
    else:
        module.__path__ = new_path


def declare_namespace(packageName):
    """Declare that package 'packageName' is a namespace package"""

    _imp.acquire_lock()
    try:
        if packageName in _namespace_packages:
            return

        path = sys.path
        parent, _, _ = packageName.rpartition('.')

        if parent:
            declare_namespace(parent)
            if parent not in _namespace_packages:
                __import__(parent)
            try:
                path = sys.modules[parent].__path__
            except AttributeError:
                raise TypeError("Not a package:", parent)

        # Track what packages are namespaces, so when new path items are added,
        # they can be updated
        _namespace_packages.setdefault(parent or None, []).append(packageName)
        _namespace_packages.setdefault(packageName, [])

        for path_item in path:
            # Ensure all the parent's path items are reflected in the child,
            # if they apply
            _handle_ns(packageName, path_item)

    finally:
        _imp.release_lock()


def fixup_namespace_packages(path_item, parent=None):
    """Ensure that previously-declared namespace packages include path_item"""
    _imp.acquire_lock()
    try:
        for package in _namespace_packages.get(parent, ()):
            subpath = _handle_ns(package, path_item)
            if subpath:
                fixup_namespace_packages(subpath, package)
    finally:
        _imp.release_lock()


def file_ns_handler(importer, path_item, packageName, module):
    """Compute an ns-package subpath for a filesystem or zipfile importer"""

    subpath = os.path.join(path_item, packageName.split('.')[-1])
    normalized = _normalize_cached(subpath)
    for item in module.__path__:
        if _normalize_cached(item) == normalized:
            break
    else:
        # Only return the path if it's not already there
        return subpath


register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
register_namespace_handler(zipimport.zipimporter, file_ns_handler)

if hasattr(importlib_machinery, 'FileFinder'):
    register_namespace_handler(importlib_machinery.FileFinder, file_ns_handler)


def null_ns_handler(importer, path_item, packageName, module):
    return None


register_namespace_handler(object, null_ns_handler)


def normalize_path(filename):
    """Normalize a file/dir name for comparison purposes"""
    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))


def _cygwin_patch(filename):  # pragma: nocover
    """
    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
    symlink components. Using
    os.path.abspath() works around this limitation. A fix in os.getcwd()
    would probably better, in Cygwin even more so, except
    that this seems to be by design...
    """
    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename


def _normalize_cached(filename, _cache={}):
    try:
        return _cache[filename]
    except KeyError:
        _cache[filename] = result = normalize_path(filename)
        return result


def _is_egg_path(path):
    """
    Determine if given path appears to be an egg.
    """
    return path.lower().endswith('.egg')


def _is_unpacked_egg(path):
    """
    Determine if given path appears to be an unpacked egg.
    """
    return (
        _is_egg_path(path) and
        os.path.isfile(os.path.join(path, 'EGG-INFO', 'PKG-INFO'))
    )


def _set_parent_ns(packageName):
    parts = packageName.split('.')
    name = parts.pop()
    if parts:
        parent = '.'.join(parts)
        setattr(sys.modules[parent], name, sys.modules[packageName])


def yield_lines(strs):
    """Yield non-empty/non-comment lines of a string or sequence"""
    if isinstance(strs, six.string_types):
        for s in strs.splitlines():
            s = s.strip()
            # skip blank lines/comments
            if s and not s.startswith('#'):
                yield s
    else:
        for ss in strs:
            for s in yield_lines(ss):
                yield s


MODULE = re.compile(r"\w+(\.\w+)*$").match
EGG_NAME = re.compile(
    r"""
    (?P<name>[^-]+) (
        -(?P<ver>[^-]+) (
            -py(?P<pyver>[^-]+) (
                -(?P<plat>.+)
            )?
        )?
    )?
    """,
    re.VERBOSE | re.IGNORECASE,
).match


class EntryPoint:
    """Object representing an advertised importable object"""

    def __init__(self, name, module_name, attrs=(), extras=(), dist=None):
        if not MODULE(module_name):
            raise ValueError("Invalid module name", module_name)
        self.name = name
        self.module_name = module_name
        self.attrs = tuple(attrs)
        self.extras = tuple(extras)
        self.dist = dist

    def __str__(self):
        s = "%s = %s" % (self.name, self.module_name)
        if self.attrs:
            s += ':' + '.'.join(self.attrs)
        if self.extras:
            s += ' [%s]' % ','.join(self.extras)
        return s

    def __repr__(self):
        return "EntryPoint.parse(%r)" % str(self)

    def load(self, require=True, *args, **kwargs):
        """
        Require packages for this EntryPoint, then resolve it.
        """
        if not require or args or kwargs:
            warnings.warn(
                "Parameters to load are deprecated.  Call .resolve and "
                ".require separately.",
                PkgResourcesDeprecationWarning,
                stacklevel=2,
            )
        if require:
            self.require(*args, **kwargs)
        return self.resolve()

    def resolve(self):
        """
        Resolve the entry point from its module and attrs.
        """
        module = __import__(self.module_name, fromlist=['__name__'], level=0)
        try:
            return functools.reduce(getattr, self.attrs, module)
        except AttributeError as exc:
            raise ImportError(str(exc))

    def require(self, env=None, installer=None):
        if self.extras and not self.dist:
            raise UnknownExtra("Can't require() without a distribution", self)

        # Get the requirements for this entry point with all its extras and
        # then resolve them. We have to pass `extras` along when resolving so
        # that the working set knows what extras we want. Otherwise, for
        # dist-info distributions, the working set will assume that the
        # requirements for that extra are purely optional and skip over them.
        reqs = self.dist.requires(self.extras)
        items = working_set.resolve(reqs, env, installer, extras=self.extras)
        list(map(working_set.add, items))

    pattern = re.compile(
        r'\s*'
        r'(?P<name>.+?)\s*'
        r'=\s*'
        r'(?P<module>[\w.]+)\s*'
        r'(:\s*(?P<attr>[\w.]+))?\s*'
        r'(?P<extras>\[.*\])?\s*$'
    )

    @classmethod
    def parse(cls, src, dist=None):
        """Parse a single entry point from string `src`

        Entry point syntax follows the form::

            name = some.module:some.attr [extra1, extra2]

        The entry name and module name are required, but the ``:attrs`` and
        ``[extras]`` parts are optional
        """
        m = cls.pattern.match(src)
        if not m:
            msg = "EntryPoint must be in 'name=module:attrs [extras]' format"
            raise ValueError(msg, src)
        res = m.groupdict()
        extras = cls._parse_extras(res['extras'])
        attrs = res['attr'].split('.') if res['attr'] else ()
        return cls(res['name'], res['module'], attrs, extras, dist)

    @classmethod
    def _parse_extras(cls, extras_spec):
        if not extras_spec:
            return ()
        req = Requirement.parse('x' + extras_spec)
        if req.specs:
            raise ValueError()
        return req.extras

    @classmethod
    def parse_group(cls, group, lines, dist=None):
        """Parse an entry point group"""
        if not MODULE(group):
            raise ValueError("Invalid group name", group)
        this = {}
        for line in yield_lines(lines):
            ep = cls.parse(line, dist)
            if ep.name in this:
                raise ValueError("Duplicate entry point", group, ep.name)
            this[ep.name] = ep
        return this

    @classmethod
    def parse_map(cls, data, dist=None):
        """Parse a map of entry point groups"""
        if isinstance(data, dict):
            data = data.items()
        else:
            data = split_sections(data)
        maps = {}
        for group, lines in data:
            if group is None:
                if not lines:
                    continue
                raise ValueError("Entry points must be listed in groups")
            group = group.strip()
            if group in maps:
                raise ValueError("Duplicate group name", group)
            maps[group] = cls.parse_group(group, lines, dist)
        return maps


def _remove_md5_fragment(location):
    if not location:
        return ''
    parsed = urllib.parse.urlparse(location)
    if parsed[-1].startswith('md5='):
        return urllib.parse.urlunparse(parsed[:-1] + ('',))
    return location


def _version_from_file(lines):
    """
    Given an iterable of lines from a Metadata file, return
    the value of the Version field, if present, or None otherwise.
    """
    def is_version_line(line):
        return line.lower().startswith('version:')
    version_lines = filter(is_version_line, lines)
    line = next(iter(version_lines), '')
    _, _, value = line.partition(':')
    return safe_version(value.strip()) or None


class Distribution:
    """Wrap an actual or potential sys.path entry w/metadata"""
    PKG_INFO = 'PKG-INFO'

    def __init__(
            self, location=None, metadata=None, project_name=None,
            version=None, py_version=PY_MAJOR, platform=None,
            precedence=EGG_DIST):
        self.project_name = safe_name(project_name or 'Unknown')
        if version is not None:
            self._version = safe_version(version)
        self.py_version = py_version
        self.platform = platform
        self.location = location
        self.precedence = precedence
        self._provider = metadata or empty_provider

    @classmethod
    def from_location(cls, location, basename, metadata=None, **kw):
        project_name, version, py_version, platform = [None] * 4
        basename, ext = os.path.splitext(basename)
        if ext.lower() in _distributionImpl:
            cls = _distributionImpl[ext.lower()]

            match = EGG_NAME(basename)
            if match:
                project_name, version, py_version, platform = match.group(
                    'name', 'ver', 'pyver', 'plat'
                )
        return cls(
            location, metadata, project_name=project_name, version=version,
            py_version=py_version, platform=platform, **kw
        )._reload_version()

    def _reload_version(self):
        return self

    @property
    def hashcmp(self):
        return (
            self.parsed_version,
            self.precedence,
            self.key,
            _remove_md5_fragment(self.location),
            self.py_version or '',
            self.platform or '',
        )

    def __hash__(self):
        return hash(self.hashcmp)

    def __lt__(self, other):
        return self.hashcmp < other.hashcmp

    def __le__(self, other):
        return self.hashcmp <= other.hashcmp

    def __gt__(self, other):
        return self.hashcmp > other.hashcmp

    def __ge__(self, other):
        return self.hashcmp >= other.hashcmp

    def __eq__(self, other):
        if not isinstance(other, self.__class__):
            # It's not a Distribution, so they are not equal
            return False
        return self.hashcmp == other.hashcmp

    def __ne__(self, other):
        return not self == other

    # These properties have to be lazy so that we don't have to load any
    # metadata until/unless it's actually needed.  (i.e., some distributions
    # may not know their name or version without loading PKG-INFO)

    @property
    def key(self):
        try:
            return self._key
        except AttributeError:
            self._key = key = self.project_name.lower()
            return key

    @property
    def parsed_version(self):
        if not hasattr(self, "_parsed_version"):
            self._parsed_version = parse_version(self.version)

        return self._parsed_version

    def _warn_legacy_version(self):
        LV = packaging.version.LegacyVersion
        is_legacy = isinstance(self._parsed_version, LV)
        if not is_legacy:
            return

        # While an empty version is technically a legacy version and
        # is not a valid PEP 440 version, it's also unlikely to
        # actually come from someone and instead it is more likely that
        # it comes from setuptools attempting to parse a filename and
        # including it in the list. So for that we'll gate this warning
        # on if the version is anything at all or not.
        if not self.version:
            return

        tmpl = textwrap.dedent("""
            '{project_name} ({version})' is being parsed as a legacy,
            non PEP 440,
            version. You may find odd behavior and sort order.
            In particular it will be sorted as less than 0.0. It
            is recommended to migrate to PEP 440 compatible
            versions.
            """).strip().replace('\n', ' ')

        warnings.warn(tmpl.format(**vars(self)), PEP440Warning)

    @property
    def version(self):
        try:
            return self._version
        except AttributeError:
            version = self._get_version()
            if version is None:
                path = self._get_metadata_path_for_display(self.PKG_INFO)
                msg = (
                    "Missing 'Version:' header and/or {} file at path: {}"
                ).format(self.PKG_INFO, path)
                raise ValueError(msg, self)

            return version

    @property
    def _dep_map(self):
        """
        A map of extra to its list of (direct) requirements
        for this distribution, including the null extra.
        """
        try:
            return self.__dep_map
        except AttributeError:
            self.__dep_map = self._filter_extras(self._build_dep_map())
        return self.__dep_map

    @staticmethod
    def _filter_extras(dm):
        """
        Given a mapping of extras to dependencies, strip off
        environment markers and filter out any dependencies
        not matching the markers.
        """
        for extra in list(filter(None, dm)):
            new_extra = extra
            reqs = dm.pop(extra)
            new_extra, _, marker = extra.partition(':')
            fails_marker = marker and (
                invalid_marker(marker)
                or not evaluate_marker(marker)
            )
            if fails_marker:
                reqs = []
            new_extra = safe_extra(new_extra) or None

            dm.setdefault(new_extra, []).extend(reqs)
        return dm

    def _build_dep_map(self):
        dm = {}
        for name in 'requires.txt', 'depends.txt':
            for extra, reqs in split_sections(self._get_metadata(name)):
                dm.setdefault(extra, []).extend(parse_requirements(reqs))
        return dm

    def requires(self, extras=()):
        """List of Requirements needed for this distro if `extras` are used"""
        dm = self._dep_map
        deps = []
        deps.extend(dm.get(None, ()))
        for ext in extras:
            try:
                deps.extend(dm[safe_extra(ext)])
            except KeyError:
                raise UnknownExtra(
                    "%s has no such extra feature %r" % (self, ext)
                )
        return deps

    def _get_metadata_path_for_display(self, name):
        """
        Return the path to the given metadata file, if available.
        """
        try:
            # We need to access _get_metadata_path() on the provider object
            # directly rather than through this class's __getattr__()
            # since _get_metadata_path() is marked private.
            path = self._provider._get_metadata_path(name)

        # Handle exceptions e.g. in case the distribution's metadata
        # provider doesn't support _get_metadata_path().
        except Exception:
            return '[could not detect]'

        return path

    def _get_metadata(self, name):
        if self.has_metadata(name):
            for line in self.get_metadata_lines(name):
                yield line

    def _get_version(self):
        lines = self._get_metadata(self.PKG_INFO)
        version = _version_from_file(lines)

        return version

    def activate(self, path=None, replace=False):
        """Ensure distribution is importable on `path` (default=sys.path)"""
        if path is None:
            path = sys.path
        self.insert_on(path, replace=replace)
        if path is sys.path:
            fixup_namespace_packages(self.location)
            for pkg in self._get_metadata('namespace_packages.txt'):
                if pkg in sys.modules:
                    declare_namespace(pkg)

    def egg_name(self):
        """Return what this distribution's standard .egg filename should be"""
        filename = "%s-%s-py%s" % (
            to_filename(self.project_name), to_filename(self.version),
            self.py_version or PY_MAJOR
        )

        if self.platform:
            filename += '-' + self.platform
        return filename

    def __repr__(self):
        if self.location:
            return "%s (%s)" % (self, self.location)
        else:
            return str(self)

    def __str__(self):
        try:
            version = getattr(self, 'version', None)
        except ValueError:
            version = None
        version = version or "[unknown version]"
        return "%s %s" % (self.project_name, version)

    def __getattr__(self, attr):
        """Delegate all unrecognized public attributes to .metadata provider"""
        if attr.startswith('_'):
            raise AttributeError(attr)
        return getattr(self._provider, attr)

    def __dir__(self):
        return list(
            set(super(Distribution, self).__dir__())
            | set(
                attr for attr in self._provider.__dir__()
                if not attr.startswith('_')
            )
        )

    if not hasattr(object, '__dir__'):
        # python 2.7 not supported
        del __dir__

    @classmethod
    def from_filename(cls, filename, metadata=None, **kw):
        return cls.from_location(
            _normalize_cached(filename), os.path.basename(filename), metadata,
            **kw
        )

    def as_requirement(self):
        """Return a ``Requirement`` that matches this distribution exactly"""
        if isinstance(self.parsed_version, packaging.version.Version):
            spec = "%s==%s" % (self.project_name, self.parsed_version)
        else:
            spec = "%s===%s" % (self.project_name, self.parsed_version)

        return Requirement.parse(spec)

    def load_entry_point(self, group, name):
        """Return the `name` entry point of `group` or raise ImportError"""
        ep = self.get_entry_info(group, name)
        if ep is None:
            raise ImportError("Entry point %r not found" % ((group, name),))
        return ep.load()

    def get_entry_map(self, group=None):
        """Return the entry point map for `group`, or the full entry map"""
        try:
            ep_map = self._ep_map
        except AttributeError:
            ep_map = self._ep_map = EntryPoint.parse_map(
                self._get_metadata('entry_points.txt'), self
            )
        if group is not None:
            return ep_map.get(group, {})
        return ep_map

    def get_entry_info(self, group, name):
        """Return the EntryPoint object for `group`+`name`, or ``None``"""
        return self.get_entry_map(group).get(name)

    def insert_on(self, path, loc=None, replace=False):
        """Ensure self.location is on path

        If replace=False (default):
            - If location is already in path anywhere, do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent.
              - Else: add to the end of path.
        If replace=True:
            - If location is already on path anywhere (not eggs)
              or higher priority than its parent (eggs)
              do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent,
                removing any lower-priority entries.
              - Else: add it to the front of path.
        """

        loc = loc or self.location
        if not loc:
            return

        nloc = _normalize_cached(loc)
        bdir = os.path.dirname(nloc)
        npath = [(p and _normalize_cached(p) or p) for p in path]

        for p, item in enumerate(npath):
            if item == nloc:
                if replace:
                    break
                else:
                    # don't modify path (even removing duplicates) if
                    # found and not replace
                    return
            elif item == bdir and self.precedence == EGG_DIST:
                # if it's an .egg, give it precedence over its directory
                # UNLESS it's already been added to sys.path and replace=False
                if (not replace) and nloc in npath[p:]:
                    return
                if path is sys.path:
                    self.check_version_conflict()
                path.insert(p, loc)
                npath.insert(p, nloc)
                break
        else:
            if path is sys.path:
                self.check_version_conflict()
            if replace:
                path.insert(0, loc)
            else:
                path.append(loc)
            return

        # p is the spot where we found or inserted loc; now remove duplicates
        while True:
            try:
                np = npath.index(nloc, p + 1)
            except ValueError:
                break
            else:
                del npath[np], path[np]
                # ha!
                p = np

        return

    def check_version_conflict(self):
        if self.key == 'setuptools':
            # ignore the inevitable setuptools self-conflicts  :(
            return

        nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
        loc = normalize_path(self.location)
        for modname in self._get_metadata('top_level.txt'):
            if (modname not in sys.modules or modname in nsp
                    or modname in _namespace_packages):
                continue
            if modname in ('pkg_resources', 'setuptools', 'site'):
                continue
            fn = getattr(sys.modules[modname], '__file__', None)
            if fn and (normalize_path(fn).startswith(loc) or
                       fn.startswith(self.location)):
                continue
            issue_warning(
                "Module %s was already imported from %s, but %s is being added"
                " to sys.path" % (modname, fn, self.location),
            )

    def has_version(self):
        try:
            self.version
        except ValueError:
            issue_warning("Unbuilt egg for " + repr(self))
            return False
        return True

    def clone(self, **kw):
        """Copy this distribution, substituting in any changed keyword args"""
        names = 'project_name version py_version platform location precedence'
        for attr in names.split():
            kw.setdefault(attr, getattr(self, attr, None))
        kw.setdefault('metadata', self._provider)
        return self.__class__(**kw)

    @property
    def extras(self):
        return [dep for dep in self._dep_map if dep]


class EggInfoDistribution(Distribution):
    def _reload_version(self):
        """
        Packages installed by distutils (e.g. numpy or scipy),
        which uses an old safe_version, and so
        their version numbers can get mangled when
        converted to filenames (e.g., 1.11.0.dev0+2329eae to
        1.11.0.dev0_2329eae). These distributions will not be
        parsed properly
        downstream by Distribution and safe_version, so
        take an extra step and try to get the version number from
        the metadata file itself instead of the filename.
        """
        md_version = self._get_version()
        if md_version:
            self._version = md_version
        return self


class DistInfoDistribution(Distribution):
    """
    Wrap an actual or potential sys.path entry
    w/metadata, .dist-info style.
    """
    PKG_INFO = 'METADATA'
    EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])")

    @property
    def _parsed_pkg_info(self):
        """Parse and cache metadata"""
        try:
            return self._pkg_info
        except AttributeError:
            metadata = self.get_metadata(self.PKG_INFO)
            self._pkg_info = email.parser.Parser().parsestr(metadata)
            return self._pkg_info

    @property
    def _dep_map(self):
        try:
            return self.__dep_map
        except AttributeError:
            self.__dep_map = self._compute_dependencies()
            return self.__dep_map

    def _compute_dependencies(self):
        """Recompute this distribution's dependencies."""
        dm = self.__dep_map = {None: []}

        reqs = []
        # Including any condition expressions
        for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
            reqs.extend(parse_requirements(req))

        def reqs_for_extra(extra):
            for req in reqs:
                if not req.marker or req.marker.evaluate({'extra': extra}):
                    yield req

        common = frozenset(reqs_for_extra(None))
        dm[None].extend(common)

        for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []:
            s_extra = safe_extra(extra.strip())
            dm[s_extra] = list(frozenset(reqs_for_extra(extra)) - common)

        return dm


_distributionImpl = {
    '.egg': Distribution,
    '.egg-info': EggInfoDistribution,
    '.dist-info': DistInfoDistribution,
}


def issue_warning(*args, **kw):
    level = 1
    g = globals()
    try:
        # find the first stack frame that is *not* code in
        # the pkg_resources module, to use for the warning
        while sys._getframe(level).f_globals is g:
            level += 1
    except ValueError:
        pass
    warnings.warn(stacklevel=level + 1, *args, **kw)


class RequirementParseError(ValueError):
    def __str__(self):
        return ' '.join(self.args)


def parse_requirements(strs):
    """Yield ``Requirement`` objects for each specification in `strs`

    `strs` must be a string, or a (possibly-nested) iterable thereof.
    """
    # create a steppable iterator, so we can handle \-continuations
    lines = iter(yield_lines(strs))

    for line in lines:
        # Drop comments -- a hash without a space may be in a URL.
        if ' #' in line:
            line = line[:line.find(' #')]
        # If there is a line continuation, drop it, and append the next line.
        if line.endswith('\\'):
            line = line[:-2].strip()
            try:
                line += next(lines)
            except StopIteration:
                return
        yield Requirement(line)


class Requirement(packaging.requirements.Requirement):
    def __init__(self, requirement_string):
        """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
        try:
            super(Requirement, self).__init__(requirement_string)
        except packaging.requirements.InvalidRequirement as e:
            raise RequirementParseError(str(e))
        self.unsafe_name = self.name
        project_name = safe_name(self.name)
        self.project_name, self.key = project_name, project_name.lower()
        self.specs = [
            (spec.operator, spec.version) for spec in self.specifier]
        self.extras = tuple(map(safe_extra, self.extras))
        self.hashCmp = (
            self.key,
            self.specifier,
            frozenset(self.extras),
            str(self.marker) if self.marker else None,
        )
        self.__hash = hash(self.hashCmp)

    def __eq__(self, other):
        return (
            isinstance(other, Requirement) and
            self.hashCmp == other.hashCmp
        )

    def __ne__(self, other):
        return not self == other

    def __contains__(self, item):
        if isinstance(item, Distribution):
            if item.key != self.key:
                return False

            item = item.version

        # Allow prereleases always in order to match the previous behavior of
        # this method. In the future this should be smarter and follow PEP 440
        # more accurately.
        return self.specifier.contains(item, prereleases=True)

    def __hash__(self):
        return self.__hash

    def __repr__(self):
        return "Requirement.parse(%r)" % str(self)

    @staticmethod
    def parse(s):
        req, = parse_requirements(s)
        return req


def _always_object(classes):
    """
    Ensure object appears in the mro even
    for old-style classes.
    """
    if object not in classes:
        return classes + (object,)
    return classes


def _find_adapter(registry, ob):
    """Return an adapter factory for `ob` from `registry`"""
    types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob))))
    for t in types:
        if t in registry:
            return registry[t]


def ensure_directory(path):
    """Ensure that the parent directory of `path` exists"""
    dirname = os.path.dirname(path)
    py31compat.makedirs(dirname, exist_ok=True)


def _bypass_ensure_directory(path):
    """Sandbox-bypassing version of ensure_directory()"""
    if not WRITE_SUPPORT:
        raise IOError('"os.mkdir" not supported on this platform.')
    dirname, filename = split(path)
    if dirname and filename and not isdir(dirname):
        _bypass_ensure_directory(dirname)
        try:
            mkdir(dirname, 0o755)
        except FileExistsError:
            pass


def split_sections(s):
    """Split a string or iterable thereof into (section, content) pairs

    Each ``section`` is a stripped version of the section header ("[section]")
    and each ``content`` is a list of stripped lines excluding blank lines and
    comment-only lines.  If there are any such lines before the first section
    header, they're returned in a first ``section`` of ``None``.
    """
    section = None
    content = []
    for line in yield_lines(s):
        if line.startswith("["):
            if line.endswith("]"):
                if section or content:
                    yield section, content
                section = line[1:-1].strip()
                content = []
            else:
                raise ValueError("Invalid section heading", line)
        else:
            content.append(line)

    # wrap up last segment
    yield section, content


def _mkstemp(*args, **kw):
    old_open = os.open
    try:
        # temporarily bypass sandboxing
        os.open = os_open
        return tempfile.mkstemp(*args, **kw)
    finally:
        # and then put it back
        os.open = old_open


# Silence the PEP440Warning by default, so that end users don't get hit by it
# randomly just because they use pkg_resources. We want to append the rule
# because we want earlier uses of filterwarnings to take precedence over this
# one.
warnings.filterwarnings("ignore", category=PEP440Warning, append=True)


# from jaraco.functools 1.3
def _call_aside(f, *args, **kwargs):
    f(*args, **kwargs)
    return f


@_call_aside
def _initialize(g=globals()):
    "Set up global resource manager (deliberately not state-saved)"
    manager = ResourceManager()
    g['_manager'] = manager
    g.update(
        (name, getattr(manager, name))
        for name in dir(manager)
        if not name.startswith('_')
    )


@_call_aside
def _initialize_master_working_set():
    """
    Prepare the master working set and make the ``require()``
    API available.

    This function has explicit effects on the global state
    of pkg_resources. It is intended to be invoked once at
    the initialization of this module.

    Invocation by other packages is unsupported and done
    at their own risk.
    """
    working_set = WorkingSet._build_master()
    _declare_state('object', working_set=working_set)

    require = working_set.require
    iter_entry_points = working_set.iter_entry_points
    add_activation_listener = working_set.subscribe
    run_script = working_set.run_script
    # backward compatibility
    run_main = run_script
    # Activate all distributions already on sys.path with replace=False and
    # ensure that all distributions added to the working set in the future
    # (e.g. by calling ``require()``) will get activated as well,
    # with higher priority (replace=True).
    tuple(
        dist.activate(replace=False)
        for dist in working_set
    )
    add_activation_listener(
        lambda dist: dist.activate(replace=True),
        existing=False,
    )
    working_set.entries = []
    # match order
    list(map(working_set.add_entry, sys.path))
    globals().update(locals())

class PkgResourcesDeprecationWarning(Warning):
    """
    Base class for warning about deprecations in ``pkg_resources``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    """
site-packages/pip/_vendor/ipaddress.py000064400000233754151446177000014063 0ustar00# Copyright 2007 Google Inc.
#  Licensed to PSF under a Contributor Agreement.

"""A fast, lightweight IPv4/IPv6 manipulation library in Python.

This library is used to create/poke/manipulate IPv4 and IPv6 addresses
and networks.

"""

from __future__ import unicode_literals


import itertools
import struct

__version__ = '1.0.22'

# Compatibility functions
_compat_int_types = (int,)
try:
    _compat_int_types = (int, long)
except NameError:
    pass
try:
    _compat_str = unicode
except NameError:
    _compat_str = str
    assert bytes != str
if b'\0'[0] == 0:  # Python 3 semantics
    def _compat_bytes_to_byte_vals(byt):
        return byt
else:
    def _compat_bytes_to_byte_vals(byt):
        return [struct.unpack(b'!B', b)[0] for b in byt]
try:
    _compat_int_from_byte_vals = int.from_bytes
except AttributeError:
    def _compat_int_from_byte_vals(bytvals, endianess):
        assert endianess == 'big'
        res = 0
        for bv in bytvals:
            assert isinstance(bv, _compat_int_types)
            res = (res << 8) + bv
        return res


def _compat_to_bytes(intval, length, endianess):
    assert isinstance(intval, _compat_int_types)
    assert endianess == 'big'
    if length == 4:
        if intval < 0 or intval >= 2 ** 32:
            raise struct.error("integer out of range for 'I' format code")
        return struct.pack(b'!I', intval)
    elif length == 16:
        if intval < 0 or intval >= 2 ** 128:
            raise struct.error("integer out of range for 'QQ' format code")
        return struct.pack(b'!QQ', intval >> 64, intval & 0xffffffffffffffff)
    else:
        raise NotImplementedError()


if hasattr(int, 'bit_length'):
    # Not int.bit_length , since that won't work in 2.7 where long exists
    def _compat_bit_length(i):
        return i.bit_length()
else:
    def _compat_bit_length(i):
        for res in itertools.count():
            if i >> res == 0:
                return res


def _compat_range(start, end, step=1):
    assert step > 0
    i = start
    while i < end:
        yield i
        i += step


class _TotalOrderingMixin(object):
    __slots__ = ()

    # Helper that derives the other comparison operations from
    # __lt__ and __eq__
    # We avoid functools.total_ordering because it doesn't handle
    # NotImplemented correctly yet (http://bugs.python.org/issue10042)
    def __eq__(self, other):
        raise NotImplementedError

    def __ne__(self, other):
        equal = self.__eq__(other)
        if equal is NotImplemented:
            return NotImplemented
        return not equal

    def __lt__(self, other):
        raise NotImplementedError

    def __le__(self, other):
        less = self.__lt__(other)
        if less is NotImplemented or not less:
            return self.__eq__(other)
        return less

    def __gt__(self, other):
        less = self.__lt__(other)
        if less is NotImplemented:
            return NotImplemented
        equal = self.__eq__(other)
        if equal is NotImplemented:
            return NotImplemented
        return not (less or equal)

    def __ge__(self, other):
        less = self.__lt__(other)
        if less is NotImplemented:
            return NotImplemented
        return not less


IPV4LENGTH = 32
IPV6LENGTH = 128


class AddressValueError(ValueError):
    """A Value Error related to the address."""


class NetmaskValueError(ValueError):
    """A Value Error related to the netmask."""


def ip_address(address):
    """Take an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP address.  Either IPv4 or
          IPv6 addresses may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Address or IPv6Address object.

    Raises:
        ValueError: if the *address* passed isn't either a v4 or a v6
          address

    """
    try:
        return IPv4Address(address)
    except (AddressValueError, NetmaskValueError):
        pass

    try:
        return IPv6Address(address)
    except (AddressValueError, NetmaskValueError):
        pass

    if isinstance(address, bytes):
        raise AddressValueError(
            '%r does not appear to be an IPv4 or IPv6 address. '
            'Did you pass in a bytes (str in Python 2) instead of'
            ' a unicode object?' % address)

    raise ValueError('%r does not appear to be an IPv4 or IPv6 address' %
                     address)


def ip_network(address, strict=True):
    """Take an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP network.  Either IPv4 or
          IPv6 networks may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Network or IPv6Network object.

    Raises:
        ValueError: if the string passed isn't either a v4 or a v6
          address. Or if the network has host bits set.

    """
    try:
        return IPv4Network(address, strict)
    except (AddressValueError, NetmaskValueError):
        pass

    try:
        return IPv6Network(address, strict)
    except (AddressValueError, NetmaskValueError):
        pass

    if isinstance(address, bytes):
        raise AddressValueError(
            '%r does not appear to be an IPv4 or IPv6 network. '
            'Did you pass in a bytes (str in Python 2) instead of'
            ' a unicode object?' % address)

    raise ValueError('%r does not appear to be an IPv4 or IPv6 network' %
                     address)


def ip_interface(address):
    """Take an IP string/int and return an object of the correct type.

    Args:
        address: A string or integer, the IP address.  Either IPv4 or
          IPv6 addresses may be supplied; integers less than 2**32 will
          be considered to be IPv4 by default.

    Returns:
        An IPv4Interface or IPv6Interface object.

    Raises:
        ValueError: if the string passed isn't either a v4 or a v6
          address.

    Notes:
        The IPv?Interface classes describe an Address on a particular
        Network, so they're basically a combination of both the Address
        and Network classes.

    """
    try:
        return IPv4Interface(address)
    except (AddressValueError, NetmaskValueError):
        pass

    try:
        return IPv6Interface(address)
    except (AddressValueError, NetmaskValueError):
        pass

    raise ValueError('%r does not appear to be an IPv4 or IPv6 interface' %
                     address)


def v4_int_to_packed(address):
    """Represent an address as 4 packed bytes in network (big-endian) order.

    Args:
        address: An integer representation of an IPv4 IP address.

    Returns:
        The integer address packed as 4 bytes in network (big-endian) order.

    Raises:
        ValueError: If the integer is negative or too large to be an
          IPv4 IP address.

    """
    try:
        return _compat_to_bytes(address, 4, 'big')
    except (struct.error, OverflowError):
        raise ValueError("Address negative or too large for IPv4")


def v6_int_to_packed(address):
    """Represent an address as 16 packed bytes in network (big-endian) order.

    Args:
        address: An integer representation of an IPv6 IP address.

    Returns:
        The integer address packed as 16 bytes in network (big-endian) order.

    """
    try:
        return _compat_to_bytes(address, 16, 'big')
    except (struct.error, OverflowError):
        raise ValueError("Address negative or too large for IPv6")


def _split_optional_netmask(address):
    """Helper to split the netmask and raise AddressValueError if needed"""
    addr = _compat_str(address).split('/')
    if len(addr) > 2:
        raise AddressValueError("Only one '/' permitted in %r" % address)
    return addr


def _find_address_range(addresses):
    """Find a sequence of sorted deduplicated IPv#Address.

    Args:
        addresses: a list of IPv#Address objects.

    Yields:
        A tuple containing the first and last IP addresses in the sequence.

    """
    it = iter(addresses)
    first = last = next(it)
    for ip in it:
        if ip._ip != last._ip + 1:
            yield first, last
            first = ip
        last = ip
    yield first, last


def _count_righthand_zero_bits(number, bits):
    """Count the number of zero bits on the right hand side.

    Args:
        number: an integer.
        bits: maximum number of bits to count.

    Returns:
        The number of zero bits on the right hand side of the number.

    """
    if number == 0:
        return bits
    return min(bits, _compat_bit_length(~number & (number - 1)))


def summarize_address_range(first, last):
    """Summarize a network range given the first and last IP addresses.

    Example:
        >>> list(summarize_address_range(IPv4Address('192.0.2.0'),
        ...                              IPv4Address('192.0.2.130')))
        ...                                #doctest: +NORMALIZE_WHITESPACE
        [IPv4Network('192.0.2.0/25'), IPv4Network('192.0.2.128/31'),
         IPv4Network('192.0.2.130/32')]

    Args:
        first: the first IPv4Address or IPv6Address in the range.
        last: the last IPv4Address or IPv6Address in the range.

    Returns:
        An iterator of the summarized IPv(4|6) network objects.

    Raise:
        TypeError:
            If the first and last objects are not IP addresses.
            If the first and last objects are not the same version.
        ValueError:
            If the last object is not greater than the first.
            If the version of the first address is not 4 or 6.

    """
    if (not (isinstance(first, _BaseAddress) and
             isinstance(last, _BaseAddress))):
        raise TypeError('first and last must be IP addresses, not networks')
    if first.version != last.version:
        raise TypeError("%s and %s are not of the same version" % (
                        first, last))
    if first > last:
        raise ValueError('last IP address must be greater than first')

    if first.version == 4:
        ip = IPv4Network
    elif first.version == 6:
        ip = IPv6Network
    else:
        raise ValueError('unknown IP version')

    ip_bits = first._max_prefixlen
    first_int = first._ip
    last_int = last._ip
    while first_int <= last_int:
        nbits = min(_count_righthand_zero_bits(first_int, ip_bits),
                    _compat_bit_length(last_int - first_int + 1) - 1)
        net = ip((first_int, ip_bits - nbits))
        yield net
        first_int += 1 << nbits
        if first_int - 1 == ip._ALL_ONES:
            break


def _collapse_addresses_internal(addresses):
    """Loops through the addresses, collapsing concurrent netblocks.

    Example:

        ip1 = IPv4Network('192.0.2.0/26')
        ip2 = IPv4Network('192.0.2.64/26')
        ip3 = IPv4Network('192.0.2.128/26')
        ip4 = IPv4Network('192.0.2.192/26')

        _collapse_addresses_internal([ip1, ip2, ip3, ip4]) ->
          [IPv4Network('192.0.2.0/24')]

        This shouldn't be called directly; it is called via
          collapse_addresses([]).

    Args:
        addresses: A list of IPv4Network's or IPv6Network's

    Returns:
        A list of IPv4Network's or IPv6Network's depending on what we were
        passed.

    """
    # First merge
    to_merge = list(addresses)
    subnets = {}
    while to_merge:
        net = to_merge.pop()
        supernet = net.supernet()
        existing = subnets.get(supernet)
        if existing is None:
            subnets[supernet] = net
        elif existing != net:
            # Merge consecutive subnets
            del subnets[supernet]
            to_merge.append(supernet)
    # Then iterate over resulting networks, skipping subsumed subnets
    last = None
    for net in sorted(subnets.values()):
        if last is not None:
            # Since they are sorted,
            # last.network_address <= net.network_address is a given.
            if last.broadcast_address >= net.broadcast_address:
                continue
        yield net
        last = net


def collapse_addresses(addresses):
    """Collapse a list of IP objects.

    Example:
        collapse_addresses([IPv4Network('192.0.2.0/25'),
                            IPv4Network('192.0.2.128/25')]) ->
                           [IPv4Network('192.0.2.0/24')]

    Args:
        addresses: An iterator of IPv4Network or IPv6Network objects.

    Returns:
        An iterator of the collapsed IPv(4|6)Network objects.

    Raises:
        TypeError: If passed a list of mixed version objects.

    """
    addrs = []
    ips = []
    nets = []

    # split IP addresses and networks
    for ip in addresses:
        if isinstance(ip, _BaseAddress):
            if ips and ips[-1]._version != ip._version:
                raise TypeError("%s and %s are not of the same version" % (
                                ip, ips[-1]))
            ips.append(ip)
        elif ip._prefixlen == ip._max_prefixlen:
            if ips and ips[-1]._version != ip._version:
                raise TypeError("%s and %s are not of the same version" % (
                                ip, ips[-1]))
            try:
                ips.append(ip.ip)
            except AttributeError:
                ips.append(ip.network_address)
        else:
            if nets and nets[-1]._version != ip._version:
                raise TypeError("%s and %s are not of the same version" % (
                                ip, nets[-1]))
            nets.append(ip)

    # sort and dedup
    ips = sorted(set(ips))

    # find consecutive address ranges in the sorted sequence and summarize them
    if ips:
        for first, last in _find_address_range(ips):
            addrs.extend(summarize_address_range(first, last))

    return _collapse_addresses_internal(addrs + nets)


def get_mixed_type_key(obj):
    """Return a key suitable for sorting between networks and addresses.

    Address and Network objects are not sortable by default; they're
    fundamentally different so the expression

        IPv4Address('192.0.2.0') <= IPv4Network('192.0.2.0/24')

    doesn't make any sense.  There are some times however, where you may wish
    to have ipaddress sort these for you anyway. If you need to do this, you
    can use this function as the key= argument to sorted().

    Args:
      obj: either a Network or Address object.
    Returns:
      appropriate key.

    """
    if isinstance(obj, _BaseNetwork):
        return obj._get_networks_key()
    elif isinstance(obj, _BaseAddress):
        return obj._get_address_key()
    return NotImplemented


class _IPAddressBase(_TotalOrderingMixin):

    """The mother class."""

    __slots__ = ()

    @property
    def exploded(self):
        """Return the longhand version of the IP address as a string."""
        return self._explode_shorthand_ip_string()

    @property
    def compressed(self):
        """Return the shorthand version of the IP address as a string."""
        return _compat_str(self)

    @property
    def reverse_pointer(self):
        """The name of the reverse DNS pointer for the IP address, e.g.:
            >>> ipaddress.ip_address("127.0.0.1").reverse_pointer
            '1.0.0.127.in-addr.arpa'
            >>> ipaddress.ip_address("2001:db8::1").reverse_pointer
            '1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa'

        """
        return self._reverse_pointer()

    @property
    def version(self):
        msg = '%200s has no version specified' % (type(self),)
        raise NotImplementedError(msg)

    def _check_int_address(self, address):
        if address < 0:
            msg = "%d (< 0) is not permitted as an IPv%d address"
            raise AddressValueError(msg % (address, self._version))
        if address > self._ALL_ONES:
            msg = "%d (>= 2**%d) is not permitted as an IPv%d address"
            raise AddressValueError(msg % (address, self._max_prefixlen,
                                           self._version))

    def _check_packed_address(self, address, expected_len):
        address_len = len(address)
        if address_len != expected_len:
            msg = (
                '%r (len %d != %d) is not permitted as an IPv%d address. '
                'Did you pass in a bytes (str in Python 2) instead of'
                ' a unicode object?')
            raise AddressValueError(msg % (address, address_len,
                                           expected_len, self._version))

    @classmethod
    def _ip_int_from_prefix(cls, prefixlen):
        """Turn the prefix length into a bitwise netmask

        Args:
            prefixlen: An integer, the prefix length.

        Returns:
            An integer.

        """
        return cls._ALL_ONES ^ (cls._ALL_ONES >> prefixlen)

    @classmethod
    def _prefix_from_ip_int(cls, ip_int):
        """Return prefix length from the bitwise netmask.

        Args:
            ip_int: An integer, the netmask in expanded bitwise format

        Returns:
            An integer, the prefix length.

        Raises:
            ValueError: If the input intermingles zeroes & ones
        """
        trailing_zeroes = _count_righthand_zero_bits(ip_int,
                                                     cls._max_prefixlen)
        prefixlen = cls._max_prefixlen - trailing_zeroes
        leading_ones = ip_int >> trailing_zeroes
        all_ones = (1 << prefixlen) - 1
        if leading_ones != all_ones:
            byteslen = cls._max_prefixlen // 8
            details = _compat_to_bytes(ip_int, byteslen, 'big')
            msg = 'Netmask pattern %r mixes zeroes & ones'
            raise ValueError(msg % details)
        return prefixlen

    @classmethod
    def _report_invalid_netmask(cls, netmask_str):
        msg = '%r is not a valid netmask' % netmask_str
        raise NetmaskValueError(msg)

    @classmethod
    def _prefix_from_prefix_string(cls, prefixlen_str):
        """Return prefix length from a numeric string

        Args:
            prefixlen_str: The string to be converted

        Returns:
            An integer, the prefix length.

        Raises:
            NetmaskValueError: If the input is not a valid netmask
        """
        # int allows a leading +/- as well as surrounding whitespace,
        # so we ensure that isn't the case
        if not _BaseV4._DECIMAL_DIGITS.issuperset(prefixlen_str):
            cls._report_invalid_netmask(prefixlen_str)
        try:
            prefixlen = int(prefixlen_str)
        except ValueError:
            cls._report_invalid_netmask(prefixlen_str)
        if not (0 <= prefixlen <= cls._max_prefixlen):
            cls._report_invalid_netmask(prefixlen_str)
        return prefixlen

    @classmethod
    def _prefix_from_ip_string(cls, ip_str):
        """Turn a netmask/hostmask string into a prefix length

        Args:
            ip_str: The netmask/hostmask to be converted

        Returns:
            An integer, the prefix length.

        Raises:
            NetmaskValueError: If the input is not a valid netmask/hostmask
        """
        # Parse the netmask/hostmask like an IP address.
        try:
            ip_int = cls._ip_int_from_string(ip_str)
        except AddressValueError:
            cls._report_invalid_netmask(ip_str)

        # Try matching a netmask (this would be /1*0*/ as a bitwise regexp).
        # Note that the two ambiguous cases (all-ones and all-zeroes) are
        # treated as netmasks.
        try:
            return cls._prefix_from_ip_int(ip_int)
        except ValueError:
            pass

        # Invert the bits, and try matching a /0+1+/ hostmask instead.
        ip_int ^= cls._ALL_ONES
        try:
            return cls._prefix_from_ip_int(ip_int)
        except ValueError:
            cls._report_invalid_netmask(ip_str)

    def __reduce__(self):
        return self.__class__, (_compat_str(self),)


class _BaseAddress(_IPAddressBase):

    """A generic IP object.

    This IP class contains the version independent methods which are
    used by single IP addresses.
    """

    __slots__ = ()

    def __int__(self):
        return self._ip

    def __eq__(self, other):
        try:
            return (self._ip == other._ip and
                    self._version == other._version)
        except AttributeError:
            return NotImplemented

    def __lt__(self, other):
        if not isinstance(other, _IPAddressBase):
            return NotImplemented
        if not isinstance(other, _BaseAddress):
            raise TypeError('%s and %s are not of the same type' % (
                self, other))
        if self._version != other._version:
            raise TypeError('%s and %s are not of the same version' % (
                self, other))
        if self._ip != other._ip:
            return self._ip < other._ip
        return False

    # Shorthand for Integer addition and subtraction. This is not
    # meant to ever support addition/subtraction of addresses.
    def __add__(self, other):
        if not isinstance(other, _compat_int_types):
            return NotImplemented
        return self.__class__(int(self) + other)

    def __sub__(self, other):
        if not isinstance(other, _compat_int_types):
            return NotImplemented
        return self.__class__(int(self) - other)

    def __repr__(self):
        return '%s(%r)' % (self.__class__.__name__, _compat_str(self))

    def __str__(self):
        return _compat_str(self._string_from_ip_int(self._ip))

    def __hash__(self):
        return hash(hex(int(self._ip)))

    def _get_address_key(self):
        return (self._version, self)

    def __reduce__(self):
        return self.__class__, (self._ip,)


class _BaseNetwork(_IPAddressBase):

    """A generic IP network object.

    This IP class contains the version independent methods which are
    used by networks.

    """
    def __init__(self, address):
        self._cache = {}

    def __repr__(self):
        return '%s(%r)' % (self.__class__.__name__, _compat_str(self))

    def __str__(self):
        return '%s/%d' % (self.network_address, self.prefixlen)

    def hosts(self):
        """Generate Iterator over usable hosts in a network.

        This is like __iter__ except it doesn't return the network
        or broadcast addresses.

        """
        network = int(self.network_address)
        broadcast = int(self.broadcast_address)
        for x in _compat_range(network + 1, broadcast):
            yield self._address_class(x)

    def __iter__(self):
        network = int(self.network_address)
        broadcast = int(self.broadcast_address)
        for x in _compat_range(network, broadcast + 1):
            yield self._address_class(x)

    def __getitem__(self, n):
        network = int(self.network_address)
        broadcast = int(self.broadcast_address)
        if n >= 0:
            if network + n > broadcast:
                raise IndexError('address out of range')
            return self._address_class(network + n)
        else:
            n += 1
            if broadcast + n < network:
                raise IndexError('address out of range')
            return self._address_class(broadcast + n)

    def __lt__(self, other):
        if not isinstance(other, _IPAddressBase):
            return NotImplemented
        if not isinstance(other, _BaseNetwork):
            raise TypeError('%s and %s are not of the same type' % (
                            self, other))
        if self._version != other._version:
            raise TypeError('%s and %s are not of the same version' % (
                            self, other))
        if self.network_address != other.network_address:
            return self.network_address < other.network_address
        if self.netmask != other.netmask:
            return self.netmask < other.netmask
        return False

    def __eq__(self, other):
        try:
            return (self._version == other._version and
                    self.network_address == other.network_address and
                    int(self.netmask) == int(other.netmask))
        except AttributeError:
            return NotImplemented

    def __hash__(self):
        return hash(int(self.network_address) ^ int(self.netmask))

    def __contains__(self, other):
        # always false if one is v4 and the other is v6.
        if self._version != other._version:
            return False
        # dealing with another network.
        if isinstance(other, _BaseNetwork):
            return False
        # dealing with another address
        else:
            # address
            return (int(self.network_address) <= int(other._ip) <=
                    int(self.broadcast_address))

    def overlaps(self, other):
        """Tell if self is partly contained in other."""
        return self.network_address in other or (
            self.broadcast_address in other or (
                other.network_address in self or (
                    other.broadcast_address in self)))

    @property
    def broadcast_address(self):
        x = self._cache.get('broadcast_address')
        if x is None:
            x = self._address_class(int(self.network_address) |
                                    int(self.hostmask))
            self._cache['broadcast_address'] = x
        return x

    @property
    def hostmask(self):
        x = self._cache.get('hostmask')
        if x is None:
            x = self._address_class(int(self.netmask) ^ self._ALL_ONES)
            self._cache['hostmask'] = x
        return x

    @property
    def with_prefixlen(self):
        return '%s/%d' % (self.network_address, self._prefixlen)

    @property
    def with_netmask(self):
        return '%s/%s' % (self.network_address, self.netmask)

    @property
    def with_hostmask(self):
        return '%s/%s' % (self.network_address, self.hostmask)

    @property
    def num_addresses(self):
        """Number of hosts in the current subnet."""
        return int(self.broadcast_address) - int(self.network_address) + 1

    @property
    def _address_class(self):
        # Returning bare address objects (rather than interfaces) allows for
        # more consistent behaviour across the network address, broadcast
        # address and individual host addresses.
        msg = '%200s has no associated address class' % (type(self),)
        raise NotImplementedError(msg)

    @property
    def prefixlen(self):
        return self._prefixlen

    def address_exclude(self, other):
        """Remove an address from a larger block.

        For example:

            addr1 = ip_network('192.0.2.0/28')
            addr2 = ip_network('192.0.2.1/32')
            list(addr1.address_exclude(addr2)) =
                [IPv4Network('192.0.2.0/32'), IPv4Network('192.0.2.2/31'),
                 IPv4Network('192.0.2.4/30'), IPv4Network('192.0.2.8/29')]

        or IPv6:

            addr1 = ip_network('2001:db8::1/32')
            addr2 = ip_network('2001:db8::1/128')
            list(addr1.address_exclude(addr2)) =
                [ip_network('2001:db8::1/128'),
                 ip_network('2001:db8::2/127'),
                 ip_network('2001:db8::4/126'),
                 ip_network('2001:db8::8/125'),
                 ...
                 ip_network('2001:db8:8000::/33')]

        Args:
            other: An IPv4Network or IPv6Network object of the same type.

        Returns:
            An iterator of the IPv(4|6)Network objects which is self
            minus other.

        Raises:
            TypeError: If self and other are of differing address
              versions, or if other is not a network object.
            ValueError: If other is not completely contained by self.

        """
        if not self._version == other._version:
            raise TypeError("%s and %s are not of the same version" % (
                            self, other))

        if not isinstance(other, _BaseNetwork):
            raise TypeError("%s is not a network object" % other)

        if not other.subnet_of(self):
            raise ValueError('%s not contained in %s' % (other, self))
        if other == self:
            return

        # Make sure we're comparing the network of other.
        other = other.__class__('%s/%s' % (other.network_address,
                                           other.prefixlen))

        s1, s2 = self.subnets()
        while s1 != other and s2 != other:
            if other.subnet_of(s1):
                yield s2
                s1, s2 = s1.subnets()
            elif other.subnet_of(s2):
                yield s1
                s1, s2 = s2.subnets()
            else:
                # If we got here, there's a bug somewhere.
                raise AssertionError('Error performing exclusion: '
                                     's1: %s s2: %s other: %s' %
                                     (s1, s2, other))
        if s1 == other:
            yield s2
        elif s2 == other:
            yield s1
        else:
            # If we got here, there's a bug somewhere.
            raise AssertionError('Error performing exclusion: '
                                 's1: %s s2: %s other: %s' %
                                 (s1, s2, other))

    def compare_networks(self, other):
        """Compare two IP objects.

        This is only concerned about the comparison of the integer
        representation of the network addresses.  This means that the
        host bits aren't considered at all in this method.  If you want
        to compare host bits, you can easily enough do a
        'HostA._ip < HostB._ip'

        Args:
            other: An IP object.

        Returns:
            If the IP versions of self and other are the same, returns:

            -1 if self < other:
              eg: IPv4Network('192.0.2.0/25') < IPv4Network('192.0.2.128/25')
              IPv6Network('2001:db8::1000/124') <
                  IPv6Network('2001:db8::2000/124')
            0 if self == other
              eg: IPv4Network('192.0.2.0/24') == IPv4Network('192.0.2.0/24')
              IPv6Network('2001:db8::1000/124') ==
                  IPv6Network('2001:db8::1000/124')
            1 if self > other
              eg: IPv4Network('192.0.2.128/25') > IPv4Network('192.0.2.0/25')
                  IPv6Network('2001:db8::2000/124') >
                      IPv6Network('2001:db8::1000/124')

          Raises:
              TypeError if the IP versions are different.

        """
        # does this need to raise a ValueError?
        if self._version != other._version:
            raise TypeError('%s and %s are not of the same type' % (
                            self, other))
        # self._version == other._version below here:
        if self.network_address < other.network_address:
            return -1
        if self.network_address > other.network_address:
            return 1
        # self.network_address == other.network_address below here:
        if self.netmask < other.netmask:
            return -1
        if self.netmask > other.netmask:
            return 1
        return 0

    def _get_networks_key(self):
        """Network-only key function.

        Returns an object that identifies this address' network and
        netmask. This function is a suitable "key" argument for sorted()
        and list.sort().

        """
        return (self._version, self.network_address, self.netmask)

    def subnets(self, prefixlen_diff=1, new_prefix=None):
        """The subnets which join to make the current subnet.

        In the case that self contains only one IP
        (self._prefixlen == 32 for IPv4 or self._prefixlen == 128
        for IPv6), yield an iterator with just ourself.

        Args:
            prefixlen_diff: An integer, the amount the prefix length
              should be increased by. This should not be set if
              new_prefix is also set.
            new_prefix: The desired new prefix length. This must be a
              larger number (smaller prefix) than the existing prefix.
              This should not be set if prefixlen_diff is also set.

        Returns:
            An iterator of IPv(4|6) objects.

        Raises:
            ValueError: The prefixlen_diff is too small or too large.
                OR
            prefixlen_diff and new_prefix are both set or new_prefix
              is a smaller number than the current prefix (smaller
              number means a larger network)

        """
        if self._prefixlen == self._max_prefixlen:
            yield self
            return

        if new_prefix is not None:
            if new_prefix < self._prefixlen:
                raise ValueError('new prefix must be longer')
            if prefixlen_diff != 1:
                raise ValueError('cannot set prefixlen_diff and new_prefix')
            prefixlen_diff = new_prefix - self._prefixlen

        if prefixlen_diff < 0:
            raise ValueError('prefix length diff must be > 0')
        new_prefixlen = self._prefixlen + prefixlen_diff

        if new_prefixlen > self._max_prefixlen:
            raise ValueError(
                'prefix length diff %d is invalid for netblock %s' % (
                    new_prefixlen, self))

        start = int(self.network_address)
        end = int(self.broadcast_address) + 1
        step = (int(self.hostmask) + 1) >> prefixlen_diff
        for new_addr in _compat_range(start, end, step):
            current = self.__class__((new_addr, new_prefixlen))
            yield current

    def supernet(self, prefixlen_diff=1, new_prefix=None):
        """The supernet containing the current network.

        Args:
            prefixlen_diff: An integer, the amount the prefix length of
              the network should be decreased by.  For example, given a
              /24 network and a prefixlen_diff of 3, a supernet with a
              /21 netmask is returned.

        Returns:
            An IPv4 network object.

        Raises:
            ValueError: If self.prefixlen - prefixlen_diff < 0. I.e., you have
              a negative prefix length.
                OR
            If prefixlen_diff and new_prefix are both set or new_prefix is a
              larger number than the current prefix (larger number means a
              smaller network)

        """
        if self._prefixlen == 0:
            return self

        if new_prefix is not None:
            if new_prefix > self._prefixlen:
                raise ValueError('new prefix must be shorter')
            if prefixlen_diff != 1:
                raise ValueError('cannot set prefixlen_diff and new_prefix')
            prefixlen_diff = self._prefixlen - new_prefix

        new_prefixlen = self.prefixlen - prefixlen_diff
        if new_prefixlen < 0:
            raise ValueError(
                'current prefixlen is %d, cannot have a prefixlen_diff of %d' %
                (self.prefixlen, prefixlen_diff))
        return self.__class__((
            int(self.network_address) & (int(self.netmask) << prefixlen_diff),
            new_prefixlen))

    @property
    def is_multicast(self):
        """Test if the address is reserved for multicast use.

        Returns:
            A boolean, True if the address is a multicast address.
            See RFC 2373 2.7 for details.

        """
        return (self.network_address.is_multicast and
                self.broadcast_address.is_multicast)

    @staticmethod
    def _is_subnet_of(a, b):
        try:
            # Always false if one is v4 and the other is v6.
            if a._version != b._version:
                raise TypeError("%s and %s are not of the same version" (a, b))
            return (b.network_address <= a.network_address and
                    b.broadcast_address >= a.broadcast_address)
        except AttributeError:
            raise TypeError("Unable to test subnet containment "
                            "between %s and %s" % (a, b))

    def subnet_of(self, other):
        """Return True if this network is a subnet of other."""
        return self._is_subnet_of(self, other)

    def supernet_of(self, other):
        """Return True if this network is a supernet of other."""
        return self._is_subnet_of(other, self)

    @property
    def is_reserved(self):
        """Test if the address is otherwise IETF reserved.

        Returns:
            A boolean, True if the address is within one of the
            reserved IPv6 Network ranges.

        """
        return (self.network_address.is_reserved and
                self.broadcast_address.is_reserved)

    @property
    def is_link_local(self):
        """Test if the address is reserved for link-local.

        Returns:
            A boolean, True if the address is reserved per RFC 4291.

        """
        return (self.network_address.is_link_local and
                self.broadcast_address.is_link_local)

    @property
    def is_private(self):
        """Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv4-special-registry or iana-ipv6-special-registry.

        """
        return (self.network_address.is_private and
                self.broadcast_address.is_private)

    @property
    def is_global(self):
        """Test if this address is allocated for public networks.

        Returns:
            A boolean, True if the address is not reserved per
            iana-ipv4-special-registry or iana-ipv6-special-registry.

        """
        return not self.is_private

    @property
    def is_unspecified(self):
        """Test if the address is unspecified.

        Returns:
            A boolean, True if this is the unspecified address as defined in
            RFC 2373 2.5.2.

        """
        return (self.network_address.is_unspecified and
                self.broadcast_address.is_unspecified)

    @property
    def is_loopback(self):
        """Test if the address is a loopback address.

        Returns:
            A boolean, True if the address is a loopback address as defined in
            RFC 2373 2.5.3.

        """
        return (self.network_address.is_loopback and
                self.broadcast_address.is_loopback)


class _BaseV4(object):

    """Base IPv4 object.

    The following methods are used by IPv4 objects in both single IP
    addresses and networks.

    """

    __slots__ = ()
    _version = 4
    # Equivalent to 255.255.255.255 or 32 bits of 1's.
    _ALL_ONES = (2 ** IPV4LENGTH) - 1
    _DECIMAL_DIGITS = frozenset('0123456789')

    # the valid octets for host and netmasks. only useful for IPv4.
    _valid_mask_octets = frozenset([255, 254, 252, 248, 240, 224, 192, 128, 0])

    _max_prefixlen = IPV4LENGTH
    # There are only a handful of valid v4 netmasks, so we cache them all
    # when constructed (see _make_netmask()).
    _netmask_cache = {}

    def _explode_shorthand_ip_string(self):
        return _compat_str(self)

    @classmethod
    def _make_netmask(cls, arg):
        """Make a (netmask, prefix_len) tuple from the given argument.

        Argument can be:
        - an integer (the prefix length)
        - a string representing the prefix length (e.g. "24")
        - a string representing the prefix netmask (e.g. "255.255.255.0")
        """
        if arg not in cls._netmask_cache:
            if isinstance(arg, _compat_int_types):
                prefixlen = arg
            else:
                try:
                    # Check for a netmask in prefix length form
                    prefixlen = cls._prefix_from_prefix_string(arg)
                except NetmaskValueError:
                    # Check for a netmask or hostmask in dotted-quad form.
                    # This may raise NetmaskValueError.
                    prefixlen = cls._prefix_from_ip_string(arg)
            netmask = IPv4Address(cls._ip_int_from_prefix(prefixlen))
            cls._netmask_cache[arg] = netmask, prefixlen
        return cls._netmask_cache[arg]

    @classmethod
    def _ip_int_from_string(cls, ip_str):
        """Turn the given IP string into an integer for comparison.

        Args:
            ip_str: A string, the IP ip_str.

        Returns:
            The IP ip_str as an integer.

        Raises:
            AddressValueError: if ip_str isn't a valid IPv4 Address.

        """
        if not ip_str:
            raise AddressValueError('Address cannot be empty')

        octets = ip_str.split('.')
        if len(octets) != 4:
            raise AddressValueError("Expected 4 octets in %r" % ip_str)

        try:
            return _compat_int_from_byte_vals(
                map(cls._parse_octet, octets), 'big')
        except ValueError as exc:
            raise AddressValueError("%s in %r" % (exc, ip_str))

    @classmethod
    def _parse_octet(cls, octet_str):
        """Convert a decimal octet into an integer.

        Args:
            octet_str: A string, the number to parse.

        Returns:
            The octet as an integer.

        Raises:
            ValueError: if the octet isn't strictly a decimal from [0..255].

        """
        if not octet_str:
            raise ValueError("Empty octet not permitted")
        # Whitelist the characters, since int() allows a lot of bizarre stuff.
        if not cls._DECIMAL_DIGITS.issuperset(octet_str):
            msg = "Only decimal digits permitted in %r"
            raise ValueError(msg % octet_str)
        # We do the length check second, since the invalid character error
        # is likely to be more informative for the user
        if len(octet_str) > 3:
            msg = "At most 3 characters permitted in %r"
            raise ValueError(msg % octet_str)
        # Convert to integer (we know digits are legal)
        octet_int = int(octet_str, 10)
        # Any octets that look like they *might* be written in octal,
        # and which don't look exactly the same in both octal and
        # decimal are rejected as ambiguous
        if octet_int > 7 and octet_str[0] == '0':
            msg = "Ambiguous (octal/decimal) value in %r not permitted"
            raise ValueError(msg % octet_str)
        if octet_int > 255:
            raise ValueError("Octet %d (> 255) not permitted" % octet_int)
        return octet_int

    @classmethod
    def _string_from_ip_int(cls, ip_int):
        """Turns a 32-bit integer into dotted decimal notation.

        Args:
            ip_int: An integer, the IP address.

        Returns:
            The IP address as a string in dotted decimal notation.

        """
        return '.'.join(_compat_str(struct.unpack(b'!B', b)[0]
                                    if isinstance(b, bytes)
                                    else b)
                        for b in _compat_to_bytes(ip_int, 4, 'big'))

    def _is_hostmask(self, ip_str):
        """Test if the IP string is a hostmask (rather than a netmask).

        Args:
            ip_str: A string, the potential hostmask.

        Returns:
            A boolean, True if the IP string is a hostmask.

        """
        bits = ip_str.split('.')
        try:
            parts = [x for x in map(int, bits) if x in self._valid_mask_octets]
        except ValueError:
            return False
        if len(parts) != len(bits):
            return False
        if parts[0] < parts[-1]:
            return True
        return False

    def _reverse_pointer(self):
        """Return the reverse DNS pointer name for the IPv4 address.

        This implements the method described in RFC1035 3.5.

        """
        reverse_octets = _compat_str(self).split('.')[::-1]
        return '.'.join(reverse_octets) + '.in-addr.arpa'

    @property
    def max_prefixlen(self):
        return self._max_prefixlen

    @property
    def version(self):
        return self._version


class IPv4Address(_BaseV4, _BaseAddress):

    """Represent and manipulate single IPv4 Addresses."""

    __slots__ = ('_ip', '__weakref__')

    def __init__(self, address):

        """
        Args:
            address: A string or integer representing the IP

              Additionally, an integer can be passed, so
              IPv4Address('192.0.2.1') == IPv4Address(3221225985).
              or, more generally
              IPv4Address(int(IPv4Address('192.0.2.1'))) ==
                IPv4Address('192.0.2.1')

        Raises:
            AddressValueError: If ipaddress isn't a valid IPv4 address.

        """
        # Efficient constructor from integer.
        if isinstance(address, _compat_int_types):
            self._check_int_address(address)
            self._ip = address
            return

        # Constructing from a packed address
        if isinstance(address, bytes):
            self._check_packed_address(address, 4)
            bvs = _compat_bytes_to_byte_vals(address)
            self._ip = _compat_int_from_byte_vals(bvs, 'big')
            return

        # Assume input argument to be string or any object representation
        # which converts into a formatted IP string.
        addr_str = _compat_str(address)
        if '/' in addr_str:
            raise AddressValueError("Unexpected '/' in %r" % address)
        self._ip = self._ip_int_from_string(addr_str)

    @property
    def packed(self):
        """The binary representation of this address."""
        return v4_int_to_packed(self._ip)

    @property
    def is_reserved(self):
        """Test if the address is otherwise IETF reserved.

         Returns:
             A boolean, True if the address is within the
             reserved IPv4 Network range.

        """
        return self in self._constants._reserved_network

    @property
    def is_private(self):
        """Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv4-special-registry.

        """
        return any(self in net for net in self._constants._private_networks)

    @property
    def is_global(self):
        return (
            self not in self._constants._public_network and
            not self.is_private)

    @property
    def is_multicast(self):
        """Test if the address is reserved for multicast use.

        Returns:
            A boolean, True if the address is multicast.
            See RFC 3171 for details.

        """
        return self in self._constants._multicast_network

    @property
    def is_unspecified(self):
        """Test if the address is unspecified.

        Returns:
            A boolean, True if this is the unspecified address as defined in
            RFC 5735 3.

        """
        return self == self._constants._unspecified_address

    @property
    def is_loopback(self):
        """Test if the address is a loopback address.

        Returns:
            A boolean, True if the address is a loopback per RFC 3330.

        """
        return self in self._constants._loopback_network

    @property
    def is_link_local(self):
        """Test if the address is reserved for link-local.

        Returns:
            A boolean, True if the address is link-local per RFC 3927.

        """
        return self in self._constants._linklocal_network


class IPv4Interface(IPv4Address):

    def __init__(self, address):
        if isinstance(address, (bytes, _compat_int_types)):
            IPv4Address.__init__(self, address)
            self.network = IPv4Network(self._ip)
            self._prefixlen = self._max_prefixlen
            return

        if isinstance(address, tuple):
            IPv4Address.__init__(self, address[0])
            if len(address) > 1:
                self._prefixlen = int(address[1])
            else:
                self._prefixlen = self._max_prefixlen

            self.network = IPv4Network(address, strict=False)
            self.netmask = self.network.netmask
            self.hostmask = self.network.hostmask
            return

        addr = _split_optional_netmask(address)
        IPv4Address.__init__(self, addr[0])

        self.network = IPv4Network(address, strict=False)
        self._prefixlen = self.network._prefixlen

        self.netmask = self.network.netmask
        self.hostmask = self.network.hostmask

    def __str__(self):
        return '%s/%d' % (self._string_from_ip_int(self._ip),
                          self.network.prefixlen)

    def __eq__(self, other):
        address_equal = IPv4Address.__eq__(self, other)
        if not address_equal or address_equal is NotImplemented:
            return address_equal
        try:
            return self.network == other.network
        except AttributeError:
            # An interface with an associated network is NOT the
            # same as an unassociated address. That's why the hash
            # takes the extra info into account.
            return False

    def __lt__(self, other):
        address_less = IPv4Address.__lt__(self, other)
        if address_less is NotImplemented:
            return NotImplemented
        try:
            return (self.network < other.network or
                    self.network == other.network and address_less)
        except AttributeError:
            # We *do* allow addresses and interfaces to be sorted. The
            # unassociated address is considered less than all interfaces.
            return False

    def __hash__(self):
        return self._ip ^ self._prefixlen ^ int(self.network.network_address)

    __reduce__ = _IPAddressBase.__reduce__

    @property
    def ip(self):
        return IPv4Address(self._ip)

    @property
    def with_prefixlen(self):
        return '%s/%s' % (self._string_from_ip_int(self._ip),
                          self._prefixlen)

    @property
    def with_netmask(self):
        return '%s/%s' % (self._string_from_ip_int(self._ip),
                          self.netmask)

    @property
    def with_hostmask(self):
        return '%s/%s' % (self._string_from_ip_int(self._ip),
                          self.hostmask)


class IPv4Network(_BaseV4, _BaseNetwork):

    """This class represents and manipulates 32-bit IPv4 network + addresses..

    Attributes: [examples for IPv4Network('192.0.2.0/27')]
        .network_address: IPv4Address('192.0.2.0')
        .hostmask: IPv4Address('0.0.0.31')
        .broadcast_address: IPv4Address('192.0.2.32')
        .netmask: IPv4Address('255.255.255.224')
        .prefixlen: 27

    """
    # Class to use when creating address objects
    _address_class = IPv4Address

    def __init__(self, address, strict=True):

        """Instantiate a new IPv4 network object.

        Args:
            address: A string or integer representing the IP [& network].
              '192.0.2.0/24'
              '192.0.2.0/255.255.255.0'
              '192.0.0.2/0.0.0.255'
              are all functionally the same in IPv4. Similarly,
              '192.0.2.1'
              '192.0.2.1/255.255.255.255'
              '192.0.2.1/32'
              are also functionally equivalent. That is to say, failing to
              provide a subnetmask will create an object with a mask of /32.

              If the mask (portion after the / in the argument) is given in
              dotted quad form, it is treated as a netmask if it starts with a
              non-zero field (e.g. /255.0.0.0 == /8) and as a hostmask if it
              starts with a zero field (e.g. 0.255.255.255 == /8), with the
              single exception of an all-zero mask which is treated as a
              netmask == /0. If no mask is given, a default of /32 is used.

              Additionally, an integer can be passed, so
              IPv4Network('192.0.2.1') == IPv4Network(3221225985)
              or, more generally
              IPv4Interface(int(IPv4Interface('192.0.2.1'))) ==
                IPv4Interface('192.0.2.1')

        Raises:
            AddressValueError: If ipaddress isn't a valid IPv4 address.
            NetmaskValueError: If the netmask isn't valid for
              an IPv4 address.
            ValueError: If strict is True and a network address is not
              supplied.

        """
        _BaseNetwork.__init__(self, address)

        # Constructing from a packed address or integer
        if isinstance(address, (_compat_int_types, bytes)):
            self.network_address = IPv4Address(address)
            self.netmask, self._prefixlen = self._make_netmask(
                self._max_prefixlen)
            # fixme: address/network test here.
            return

        if isinstance(address, tuple):
            if len(address) > 1:
                arg = address[1]
            else:
                # We weren't given an address[1]
                arg = self._max_prefixlen
            self.network_address = IPv4Address(address[0])
            self.netmask, self._prefixlen = self._make_netmask(arg)
            packed = int(self.network_address)
            if packed & int(self.netmask) != packed:
                if strict:
                    raise ValueError('%s has host bits set' % self)
                else:
                    self.network_address = IPv4Address(packed &
                                                       int(self.netmask))
            return

        # Assume input argument to be string or any object representation
        # which converts into a formatted IP prefix string.
        addr = _split_optional_netmask(address)
        self.network_address = IPv4Address(self._ip_int_from_string(addr[0]))

        if len(addr) == 2:
            arg = addr[1]
        else:
            arg = self._max_prefixlen
        self.netmask, self._prefixlen = self._make_netmask(arg)

        if strict:
            if (IPv4Address(int(self.network_address) & int(self.netmask)) !=
                    self.network_address):
                raise ValueError('%s has host bits set' % self)
        self.network_address = IPv4Address(int(self.network_address) &
                                           int(self.netmask))

        if self._prefixlen == (self._max_prefixlen - 1):
            self.hosts = self.__iter__

    @property
    def is_global(self):
        """Test if this address is allocated for public networks.

        Returns:
            A boolean, True if the address is not reserved per
            iana-ipv4-special-registry.

        """
        return (not (self.network_address in IPv4Network('100.64.0.0/10') and
                self.broadcast_address in IPv4Network('100.64.0.0/10')) and
                not self.is_private)


class _IPv4Constants(object):

    _linklocal_network = IPv4Network('169.254.0.0/16')

    _loopback_network = IPv4Network('127.0.0.0/8')

    _multicast_network = IPv4Network('224.0.0.0/4')

    _public_network = IPv4Network('100.64.0.0/10')

    _private_networks = [
        IPv4Network('0.0.0.0/8'),
        IPv4Network('10.0.0.0/8'),
        IPv4Network('127.0.0.0/8'),
        IPv4Network('169.254.0.0/16'),
        IPv4Network('172.16.0.0/12'),
        IPv4Network('192.0.0.0/29'),
        IPv4Network('192.0.0.170/31'),
        IPv4Network('192.0.2.0/24'),
        IPv4Network('192.168.0.0/16'),
        IPv4Network('198.18.0.0/15'),
        IPv4Network('198.51.100.0/24'),
        IPv4Network('203.0.113.0/24'),
        IPv4Network('240.0.0.0/4'),
        IPv4Network('255.255.255.255/32'),
    ]

    _reserved_network = IPv4Network('240.0.0.0/4')

    _unspecified_address = IPv4Address('0.0.0.0')


IPv4Address._constants = _IPv4Constants


class _BaseV6(object):

    """Base IPv6 object.

    The following methods are used by IPv6 objects in both single IP
    addresses and networks.

    """

    __slots__ = ()
    _version = 6
    _ALL_ONES = (2 ** IPV6LENGTH) - 1
    _HEXTET_COUNT = 8
    _HEX_DIGITS = frozenset('0123456789ABCDEFabcdef')
    _max_prefixlen = IPV6LENGTH

    # There are only a bunch of valid v6 netmasks, so we cache them all
    # when constructed (see _make_netmask()).
    _netmask_cache = {}

    @classmethod
    def _make_netmask(cls, arg):
        """Make a (netmask, prefix_len) tuple from the given argument.

        Argument can be:
        - an integer (the prefix length)
        - a string representing the prefix length (e.g. "24")
        - a string representing the prefix netmask (e.g. "255.255.255.0")
        """
        if arg not in cls._netmask_cache:
            if isinstance(arg, _compat_int_types):
                prefixlen = arg
            else:
                prefixlen = cls._prefix_from_prefix_string(arg)
            netmask = IPv6Address(cls._ip_int_from_prefix(prefixlen))
            cls._netmask_cache[arg] = netmask, prefixlen
        return cls._netmask_cache[arg]

    @classmethod
    def _ip_int_from_string(cls, ip_str):
        """Turn an IPv6 ip_str into an integer.

        Args:
            ip_str: A string, the IPv6 ip_str.

        Returns:
            An int, the IPv6 address

        Raises:
            AddressValueError: if ip_str isn't a valid IPv6 Address.

        """
        if not ip_str:
            raise AddressValueError('Address cannot be empty')

        parts = ip_str.split(':')

        # An IPv6 address needs at least 2 colons (3 parts).
        _min_parts = 3
        if len(parts) < _min_parts:
            msg = "At least %d parts expected in %r" % (_min_parts, ip_str)
            raise AddressValueError(msg)

        # If the address has an IPv4-style suffix, convert it to hexadecimal.
        if '.' in parts[-1]:
            try:
                ipv4_int = IPv4Address(parts.pop())._ip
            except AddressValueError as exc:
                raise AddressValueError("%s in %r" % (exc, ip_str))
            parts.append('%x' % ((ipv4_int >> 16) & 0xFFFF))
            parts.append('%x' % (ipv4_int & 0xFFFF))

        # An IPv6 address can't have more than 8 colons (9 parts).
        # The extra colon comes from using the "::" notation for a single
        # leading or trailing zero part.
        _max_parts = cls._HEXTET_COUNT + 1
        if len(parts) > _max_parts:
            msg = "At most %d colons permitted in %r" % (
                _max_parts - 1, ip_str)
            raise AddressValueError(msg)

        # Disregarding the endpoints, find '::' with nothing in between.
        # This indicates that a run of zeroes has been skipped.
        skip_index = None
        for i in _compat_range(1, len(parts) - 1):
            if not parts[i]:
                if skip_index is not None:
                    # Can't have more than one '::'
                    msg = "At most one '::' permitted in %r" % ip_str
                    raise AddressValueError(msg)
                skip_index = i

        # parts_hi is the number of parts to copy from above/before the '::'
        # parts_lo is the number of parts to copy from below/after the '::'
        if skip_index is not None:
            # If we found a '::', then check if it also covers the endpoints.
            parts_hi = skip_index
            parts_lo = len(parts) - skip_index - 1
            if not parts[0]:
                parts_hi -= 1
                if parts_hi:
                    msg = "Leading ':' only permitted as part of '::' in %r"
                    raise AddressValueError(msg % ip_str)  # ^: requires ^::
            if not parts[-1]:
                parts_lo -= 1
                if parts_lo:
                    msg = "Trailing ':' only permitted as part of '::' in %r"
                    raise AddressValueError(msg % ip_str)  # :$ requires ::$
            parts_skipped = cls._HEXTET_COUNT - (parts_hi + parts_lo)
            if parts_skipped < 1:
                msg = "Expected at most %d other parts with '::' in %r"
                raise AddressValueError(msg % (cls._HEXTET_COUNT - 1, ip_str))
        else:
            # Otherwise, allocate the entire address to parts_hi.  The
            # endpoints could still be empty, but _parse_hextet() will check
            # for that.
            if len(parts) != cls._HEXTET_COUNT:
                msg = "Exactly %d parts expected without '::' in %r"
                raise AddressValueError(msg % (cls._HEXTET_COUNT, ip_str))
            if not parts[0]:
                msg = "Leading ':' only permitted as part of '::' in %r"
                raise AddressValueError(msg % ip_str)  # ^: requires ^::
            if not parts[-1]:
                msg = "Trailing ':' only permitted as part of '::' in %r"
                raise AddressValueError(msg % ip_str)  # :$ requires ::$
            parts_hi = len(parts)
            parts_lo = 0
            parts_skipped = 0

        try:
            # Now, parse the hextets into a 128-bit integer.
            ip_int = 0
            for i in range(parts_hi):
                ip_int <<= 16
                ip_int |= cls._parse_hextet(parts[i])
            ip_int <<= 16 * parts_skipped
            for i in range(-parts_lo, 0):
                ip_int <<= 16
                ip_int |= cls._parse_hextet(parts[i])
            return ip_int
        except ValueError as exc:
            raise AddressValueError("%s in %r" % (exc, ip_str))

    @classmethod
    def _parse_hextet(cls, hextet_str):
        """Convert an IPv6 hextet string into an integer.

        Args:
            hextet_str: A string, the number to parse.

        Returns:
            The hextet as an integer.

        Raises:
            ValueError: if the input isn't strictly a hex number from
              [0..FFFF].

        """
        # Whitelist the characters, since int() allows a lot of bizarre stuff.
        if not cls._HEX_DIGITS.issuperset(hextet_str):
            raise ValueError("Only hex digits permitted in %r" % hextet_str)
        # We do the length check second, since the invalid character error
        # is likely to be more informative for the user
        if len(hextet_str) > 4:
            msg = "At most 4 characters permitted in %r"
            raise ValueError(msg % hextet_str)
        # Length check means we can skip checking the integer value
        return int(hextet_str, 16)

    @classmethod
    def _compress_hextets(cls, hextets):
        """Compresses a list of hextets.

        Compresses a list of strings, replacing the longest continuous
        sequence of "0" in the list with "" and adding empty strings at
        the beginning or at the end of the string such that subsequently
        calling ":".join(hextets) will produce the compressed version of
        the IPv6 address.

        Args:
            hextets: A list of strings, the hextets to compress.

        Returns:
            A list of strings.

        """
        best_doublecolon_start = -1
        best_doublecolon_len = 0
        doublecolon_start = -1
        doublecolon_len = 0
        for index, hextet in enumerate(hextets):
            if hextet == '0':
                doublecolon_len += 1
                if doublecolon_start == -1:
                    # Start of a sequence of zeros.
                    doublecolon_start = index
                if doublecolon_len > best_doublecolon_len:
                    # This is the longest sequence of zeros so far.
                    best_doublecolon_len = doublecolon_len
                    best_doublecolon_start = doublecolon_start
            else:
                doublecolon_len = 0
                doublecolon_start = -1

        if best_doublecolon_len > 1:
            best_doublecolon_end = (best_doublecolon_start +
                                    best_doublecolon_len)
            # For zeros at the end of the address.
            if best_doublecolon_end == len(hextets):
                hextets += ['']
            hextets[best_doublecolon_start:best_doublecolon_end] = ['']
            # For zeros at the beginning of the address.
            if best_doublecolon_start == 0:
                hextets = [''] + hextets

        return hextets

    @classmethod
    def _string_from_ip_int(cls, ip_int=None):
        """Turns a 128-bit integer into hexadecimal notation.

        Args:
            ip_int: An integer, the IP address.

        Returns:
            A string, the hexadecimal representation of the address.

        Raises:
            ValueError: The address is bigger than 128 bits of all ones.

        """
        if ip_int is None:
            ip_int = int(cls._ip)

        if ip_int > cls._ALL_ONES:
            raise ValueError('IPv6 address is too large')

        hex_str = '%032x' % ip_int
        hextets = ['%x' % int(hex_str[x:x + 4], 16) for x in range(0, 32, 4)]

        hextets = cls._compress_hextets(hextets)
        return ':'.join(hextets)

    def _explode_shorthand_ip_string(self):
        """Expand a shortened IPv6 address.

        Args:
            ip_str: A string, the IPv6 address.

        Returns:
            A string, the expanded IPv6 address.

        """
        if isinstance(self, IPv6Network):
            ip_str = _compat_str(self.network_address)
        elif isinstance(self, IPv6Interface):
            ip_str = _compat_str(self.ip)
        else:
            ip_str = _compat_str(self)

        ip_int = self._ip_int_from_string(ip_str)
        hex_str = '%032x' % ip_int
        parts = [hex_str[x:x + 4] for x in range(0, 32, 4)]
        if isinstance(self, (_BaseNetwork, IPv6Interface)):
            return '%s/%d' % (':'.join(parts), self._prefixlen)
        return ':'.join(parts)

    def _reverse_pointer(self):
        """Return the reverse DNS pointer name for the IPv6 address.

        This implements the method described in RFC3596 2.5.

        """
        reverse_chars = self.exploded[::-1].replace(':', '')
        return '.'.join(reverse_chars) + '.ip6.arpa'

    @property
    def max_prefixlen(self):
        return self._max_prefixlen

    @property
    def version(self):
        return self._version


class IPv6Address(_BaseV6, _BaseAddress):

    """Represent and manipulate single IPv6 Addresses."""

    __slots__ = ('_ip', '__weakref__')

    def __init__(self, address):
        """Instantiate a new IPv6 address object.

        Args:
            address: A string or integer representing the IP

              Additionally, an integer can be passed, so
              IPv6Address('2001:db8::') ==
                IPv6Address(42540766411282592856903984951653826560)
              or, more generally
              IPv6Address(int(IPv6Address('2001:db8::'))) ==
                IPv6Address('2001:db8::')

        Raises:
            AddressValueError: If address isn't a valid IPv6 address.

        """
        # Efficient constructor from integer.
        if isinstance(address, _compat_int_types):
            self._check_int_address(address)
            self._ip = address
            return

        # Constructing from a packed address
        if isinstance(address, bytes):
            self._check_packed_address(address, 16)
            bvs = _compat_bytes_to_byte_vals(address)
            self._ip = _compat_int_from_byte_vals(bvs, 'big')
            return

        # Assume input argument to be string or any object representation
        # which converts into a formatted IP string.
        addr_str = _compat_str(address)
        if '/' in addr_str:
            raise AddressValueError("Unexpected '/' in %r" % address)
        self._ip = self._ip_int_from_string(addr_str)

    @property
    def packed(self):
        """The binary representation of this address."""
        return v6_int_to_packed(self._ip)

    @property
    def is_multicast(self):
        """Test if the address is reserved for multicast use.

        Returns:
            A boolean, True if the address is a multicast address.
            See RFC 2373 2.7 for details.

        """
        return self in self._constants._multicast_network

    @property
    def is_reserved(self):
        """Test if the address is otherwise IETF reserved.

        Returns:
            A boolean, True if the address is within one of the
            reserved IPv6 Network ranges.

        """
        return any(self in x for x in self._constants._reserved_networks)

    @property
    def is_link_local(self):
        """Test if the address is reserved for link-local.

        Returns:
            A boolean, True if the address is reserved per RFC 4291.

        """
        return self in self._constants._linklocal_network

    @property
    def is_site_local(self):
        """Test if the address is reserved for site-local.

        Note that the site-local address space has been deprecated by RFC 3879.
        Use is_private to test if this address is in the space of unique local
        addresses as defined by RFC 4193.

        Returns:
            A boolean, True if the address is reserved per RFC 3513 2.5.6.

        """
        return self in self._constants._sitelocal_network

    @property
    def is_private(self):
        """Test if this address is allocated for private networks.

        Returns:
            A boolean, True if the address is reserved per
            iana-ipv6-special-registry.

        """
        return any(self in net for net in self._constants._private_networks)

    @property
    def is_global(self):
        """Test if this address is allocated for public networks.

        Returns:
            A boolean, true if the address is not reserved per
            iana-ipv6-special-registry.

        """
        return not self.is_private

    @property
    def is_unspecified(self):
        """Test if the address is unspecified.

        Returns:
            A boolean, True if this is the unspecified address as defined in
            RFC 2373 2.5.2.

        """
        return self._ip == 0

    @property
    def is_loopback(self):
        """Test if the address is a loopback address.

        Returns:
            A boolean, True if the address is a loopback address as defined in
            RFC 2373 2.5.3.

        """
        return self._ip == 1

    @property
    def ipv4_mapped(self):
        """Return the IPv4 mapped address.

        Returns:
            If the IPv6 address is a v4 mapped address, return the
            IPv4 mapped address. Return None otherwise.

        """
        if (self._ip >> 32) != 0xFFFF:
            return None
        return IPv4Address(self._ip & 0xFFFFFFFF)

    @property
    def teredo(self):
        """Tuple of embedded teredo IPs.

        Returns:
            Tuple of the (server, client) IPs or None if the address
            doesn't appear to be a teredo address (doesn't start with
            2001::/32)

        """
        if (self._ip >> 96) != 0x20010000:
            return None
        return (IPv4Address((self._ip >> 64) & 0xFFFFFFFF),
                IPv4Address(~self._ip & 0xFFFFFFFF))

    @property
    def sixtofour(self):
        """Return the IPv4 6to4 embedded address.

        Returns:
            The IPv4 6to4-embedded address if present or None if the
            address doesn't appear to contain a 6to4 embedded address.

        """
        if (self._ip >> 112) != 0x2002:
            return None
        return IPv4Address((self._ip >> 80) & 0xFFFFFFFF)


class IPv6Interface(IPv6Address):

    def __init__(self, address):
        if isinstance(address, (bytes, _compat_int_types)):
            IPv6Address.__init__(self, address)
            self.network = IPv6Network(self._ip)
            self._prefixlen = self._max_prefixlen
            return
        if isinstance(address, tuple):
            IPv6Address.__init__(self, address[0])
            if len(address) > 1:
                self._prefixlen = int(address[1])
            else:
                self._prefixlen = self._max_prefixlen
            self.network = IPv6Network(address, strict=False)
            self.netmask = self.network.netmask
            self.hostmask = self.network.hostmask
            return

        addr = _split_optional_netmask(address)
        IPv6Address.__init__(self, addr[0])
        self.network = IPv6Network(address, strict=False)
        self.netmask = self.network.netmask
        self._prefixlen = self.network._prefixlen
        self.hostmask = self.network.hostmask

    def __str__(self):
        return '%s/%d' % (self._string_from_ip_int(self._ip),
                          self.network.prefixlen)

    def __eq__(self, other):
        address_equal = IPv6Address.__eq__(self, other)
        if not address_equal or address_equal is NotImplemented:
            return address_equal
        try:
            return self.network == other.network
        except AttributeError:
            # An interface with an associated network is NOT the
            # same as an unassociated address. That's why the hash
            # takes the extra info into account.
            return False

    def __lt__(self, other):
        address_less = IPv6Address.__lt__(self, other)
        if address_less is NotImplemented:
            return NotImplemented
        try:
            return (self.network < other.network or
                    self.network == other.network and address_less)
        except AttributeError:
            # We *do* allow addresses and interfaces to be sorted. The
            # unassociated address is considered less than all interfaces.
            return False

    def __hash__(self):
        return self._ip ^ self._prefixlen ^ int(self.network.network_address)

    __reduce__ = _IPAddressBase.__reduce__

    @property
    def ip(self):
        return IPv6Address(self._ip)

    @property
    def with_prefixlen(self):
        return '%s/%s' % (self._string_from_ip_int(self._ip),
                          self._prefixlen)

    @property
    def with_netmask(self):
        return '%s/%s' % (self._string_from_ip_int(self._ip),
                          self.netmask)

    @property
    def with_hostmask(self):
        return '%s/%s' % (self._string_from_ip_int(self._ip),
                          self.hostmask)

    @property
    def is_unspecified(self):
        return self._ip == 0 and self.network.is_unspecified

    @property
    def is_loopback(self):
        return self._ip == 1 and self.network.is_loopback


class IPv6Network(_BaseV6, _BaseNetwork):

    """This class represents and manipulates 128-bit IPv6 networks.

    Attributes: [examples for IPv6('2001:db8::1000/124')]
        .network_address: IPv6Address('2001:db8::1000')
        .hostmask: IPv6Address('::f')
        .broadcast_address: IPv6Address('2001:db8::100f')
        .netmask: IPv6Address('ffff:ffff:ffff:ffff:ffff:ffff:ffff:fff0')
        .prefixlen: 124

    """

    # Class to use when creating address objects
    _address_class = IPv6Address

    def __init__(self, address, strict=True):
        """Instantiate a new IPv6 Network object.

        Args:
            address: A string or integer representing the IPv6 network or the
              IP and prefix/netmask.
              '2001:db8::/128'
              '2001:db8:0000:0000:0000:0000:0000:0000/128'
              '2001:db8::'
              are all functionally the same in IPv6.  That is to say,
              failing to provide a subnetmask will create an object with
              a mask of /128.

              Additionally, an integer can be passed, so
              IPv6Network('2001:db8::') ==
                IPv6Network(42540766411282592856903984951653826560)
              or, more generally
              IPv6Network(int(IPv6Network('2001:db8::'))) ==
                IPv6Network('2001:db8::')

            strict: A boolean. If true, ensure that we have been passed
              A true network address, eg, 2001:db8::1000/124 and not an
              IP address on a network, eg, 2001:db8::1/124.

        Raises:
            AddressValueError: If address isn't a valid IPv6 address.
            NetmaskValueError: If the netmask isn't valid for
              an IPv6 address.
            ValueError: If strict was True and a network address was not
              supplied.

        """
        _BaseNetwork.__init__(self, address)

        # Efficient constructor from integer or packed address
        if isinstance(address, (bytes, _compat_int_types)):
            self.network_address = IPv6Address(address)
            self.netmask, self._prefixlen = self._make_netmask(
                self._max_prefixlen)
            return

        if isinstance(address, tuple):
            if len(address) > 1:
                arg = address[1]
            else:
                arg = self._max_prefixlen
            self.netmask, self._prefixlen = self._make_netmask(arg)
            self.network_address = IPv6Address(address[0])
            packed = int(self.network_address)
            if packed & int(self.netmask) != packed:
                if strict:
                    raise ValueError('%s has host bits set' % self)
                else:
                    self.network_address = IPv6Address(packed &
                                                       int(self.netmask))
            return

        # Assume input argument to be string or any object representation
        # which converts into a formatted IP prefix string.
        addr = _split_optional_netmask(address)

        self.network_address = IPv6Address(self._ip_int_from_string(addr[0]))

        if len(addr) == 2:
            arg = addr[1]
        else:
            arg = self._max_prefixlen
        self.netmask, self._prefixlen = self._make_netmask(arg)

        if strict:
            if (IPv6Address(int(self.network_address) & int(self.netmask)) !=
                    self.network_address):
                raise ValueError('%s has host bits set' % self)
        self.network_address = IPv6Address(int(self.network_address) &
                                           int(self.netmask))

        if self._prefixlen == (self._max_prefixlen - 1):
            self.hosts = self.__iter__

    def hosts(self):
        """Generate Iterator over usable hosts in a network.

          This is like __iter__ except it doesn't return the
          Subnet-Router anycast address.

        """
        network = int(self.network_address)
        broadcast = int(self.broadcast_address)
        for x in _compat_range(network + 1, broadcast + 1):
            yield self._address_class(x)

    @property
    def is_site_local(self):
        """Test if the address is reserved for site-local.

        Note that the site-local address space has been deprecated by RFC 3879.
        Use is_private to test if this address is in the space of unique local
        addresses as defined by RFC 4193.

        Returns:
            A boolean, True if the address is reserved per RFC 3513 2.5.6.

        """
        return (self.network_address.is_site_local and
                self.broadcast_address.is_site_local)


class _IPv6Constants(object):

    _linklocal_network = IPv6Network('fe80::/10')

    _multicast_network = IPv6Network('ff00::/8')

    _private_networks = [
        IPv6Network('::1/128'),
        IPv6Network('::/128'),
        IPv6Network('::ffff:0:0/96'),
        IPv6Network('100::/64'),
        IPv6Network('2001::/23'),
        IPv6Network('2001:2::/48'),
        IPv6Network('2001:db8::/32'),
        IPv6Network('2001:10::/28'),
        IPv6Network('fc00::/7'),
        IPv6Network('fe80::/10'),
    ]

    _reserved_networks = [
        IPv6Network('::/8'), IPv6Network('100::/8'),
        IPv6Network('200::/7'), IPv6Network('400::/6'),
        IPv6Network('800::/5'), IPv6Network('1000::/4'),
        IPv6Network('4000::/3'), IPv6Network('6000::/3'),
        IPv6Network('8000::/3'), IPv6Network('A000::/3'),
        IPv6Network('C000::/3'), IPv6Network('E000::/4'),
        IPv6Network('F000::/5'), IPv6Network('F800::/6'),
        IPv6Network('FE00::/9'),
    ]

    _sitelocal_network = IPv6Network('fec0::/10')


IPv6Address._constants = _IPv6Constants
site-packages/pip/_vendor/pep517/build.py000064400000006366151446177000014222 0ustar00"""Build a project using PEP 517 hooks.
"""
import argparse
import logging
import os
import toml
import shutil

from .envbuild import BuildEnvironment
from .wrappers import Pep517HookCaller
from .dirtools import tempdir, mkdir_p
from .compat import FileNotFoundError

log = logging.getLogger(__name__)


def validate_system(system):
    """
    Ensure build system has the requisite fields.
    """
    required = {'requires', 'build-backend'}
    if not (required <= set(system)):
        message = "Missing required fields: {missing}".format(
            missing=required-set(system),
        )
        raise ValueError(message)


def load_system(source_dir):
    """
    Load the build system from a source dir (pyproject.toml).
    """
    pyproject = os.path.join(source_dir, 'pyproject.toml')
    with open(pyproject) as f:
        pyproject_data = toml.load(f)
    return pyproject_data['build-system']


def compat_system(source_dir):
    """
    Given a source dir, attempt to get a build system backend
    and requirements from pyproject.toml. Fallback to
    setuptools but only if the file was not found or a build
    system was not indicated.
    """
    try:
        system = load_system(source_dir)
    except (FileNotFoundError, KeyError):
        system = {}
    system.setdefault(
        'build-backend',
        'setuptools.build_meta:__legacy__',
    )
    system.setdefault('requires', ['setuptools', 'wheel'])
    return system


def _do_build(hooks, env, dist, dest):
    get_requires_name = 'get_requires_for_build_{dist}'.format(**locals())
    get_requires = getattr(hooks, get_requires_name)
    reqs = get_requires({})
    log.info('Got build requires: %s', reqs)

    env.pip_install(reqs)
    log.info('Installed dynamic build dependencies')

    with tempdir() as td:
        log.info('Trying to build %s in %s', dist, td)
        build_name = 'build_{dist}'.format(**locals())
        build = getattr(hooks, build_name)
        filename = build(td, {})
        source = os.path.join(td, filename)
        shutil.move(source, os.path.join(dest, os.path.basename(filename)))


def build(source_dir, dist, dest=None, system=None):
    system = system or load_system(source_dir)
    dest = os.path.join(source_dir, dest or 'dist')
    mkdir_p(dest)

    validate_system(system)
    hooks = Pep517HookCaller(
        source_dir, system['build-backend'], system.get('backend-path')
    )

    with BuildEnvironment() as env:
        env.pip_install(system['requires'])
        _do_build(hooks, env, dist, dest)


parser = argparse.ArgumentParser()
parser.add_argument(
    'source_dir',
    help="A directory containing pyproject.toml",
)
parser.add_argument(
    '--binary', '-b',
    action='store_true',
    default=False,
)
parser.add_argument(
    '--source', '-s',
    action='store_true',
    default=False,
)
parser.add_argument(
    '--out-dir', '-o',
    help="Destination in which to save the builds relative to source dir",
)


def main(args):
    # determine which dists to build
    dists = list(filter(None, (
        'sdist' if args.source or not args.binary else None,
        'wheel' if args.binary or not args.source else None,
    )))

    for dist in dists:
        build(args.source_dir, dist, args.out_dir)


if __name__ == '__main__':
    main(parser.parse_args())
site-packages/pip/_vendor/pep517/wrappers.py000064400000024547151446177000014767 0ustar00import threading
from contextlib import contextmanager
import os
from os.path import dirname, abspath, join as pjoin
import shutil
from subprocess import check_call, check_output, STDOUT
import sys
from tempfile import mkdtemp

from . import compat

_in_proc_script = pjoin(dirname(abspath(__file__)), '_in_process.py')


@contextmanager
def tempdir():
    td = mkdtemp()
    try:
        yield td
    finally:
        shutil.rmtree(td)


class BackendUnavailable(Exception):
    """Will be raised if the backend cannot be imported in the hook process."""
    def __init__(self, traceback):
        self.traceback = traceback


class BackendInvalid(Exception):
    """Will be raised if the backend is invalid."""
    def __init__(self, backend_name, backend_path, message):
        self.backend_name = backend_name
        self.backend_path = backend_path
        self.message = message


class HookMissing(Exception):
    """Will be raised on missing hooks."""
    def __init__(self, hook_name):
        super(HookMissing, self).__init__(hook_name)
        self.hook_name = hook_name


class UnsupportedOperation(Exception):
    """May be raised by build_sdist if the backend indicates that it can't."""
    def __init__(self, traceback):
        self.traceback = traceback


def default_subprocess_runner(cmd, cwd=None, extra_environ=None):
    """The default method of calling the wrapper subprocess."""
    env = os.environ.copy()
    if extra_environ:
        env.update(extra_environ)

    check_call(cmd, cwd=cwd, env=env)


def quiet_subprocess_runner(cmd, cwd=None, extra_environ=None):
    """A method of calling the wrapper subprocess while suppressing output."""
    env = os.environ.copy()
    if extra_environ:
        env.update(extra_environ)

    check_output(cmd, cwd=cwd, env=env, stderr=STDOUT)


def norm_and_check(source_tree, requested):
    """Normalise and check a backend path.

    Ensure that the requested backend path is specified as a relative path,
    and resolves to a location under the given source tree.

    Return an absolute version of the requested path.
    """
    if os.path.isabs(requested):
        raise ValueError("paths must be relative")

    abs_source = os.path.abspath(source_tree)
    abs_requested = os.path.normpath(os.path.join(abs_source, requested))
    # We have to use commonprefix for Python 2.7 compatibility. So we
    # normalise case to avoid problems because commonprefix is a character
    # based comparison :-(
    norm_source = os.path.normcase(abs_source)
    norm_requested = os.path.normcase(abs_requested)
    if os.path.commonprefix([norm_source, norm_requested]) != norm_source:
        raise ValueError("paths must be inside source tree")

    return abs_requested


class Pep517HookCaller(object):
    """A wrapper around a source directory to be built with a PEP 517 backend.

    source_dir : The path to the source directory, containing pyproject.toml.
    build_backend : The build backend spec, as per PEP 517, from
        pyproject.toml.
    backend_path : The backend path, as per PEP 517, from pyproject.toml.
    runner : A callable that invokes the wrapper subprocess.

    The 'runner', if provided, must expect the following:
        cmd : a list of strings representing the command and arguments to
            execute, as would be passed to e.g. 'subprocess.check_call'.
        cwd : a string representing the working directory that must be
            used for the subprocess. Corresponds to the provided source_dir.
        extra_environ : a dict mapping environment variable names to values
            which must be set for the subprocess execution.
    """
    def __init__(
            self,
            source_dir,
            build_backend,
            backend_path=None,
            runner=None,
    ):
        if runner is None:
            runner = default_subprocess_runner

        self.source_dir = abspath(source_dir)
        self.build_backend = build_backend
        if backend_path:
            backend_path = [
                norm_and_check(self.source_dir, p) for p in backend_path
            ]
        self.backend_path = backend_path
        self._subprocess_runner = runner

    # TODO: Is this over-engineered? Maybe frontends only need to
    #       set this when creating the wrapper, not on every call.
    @contextmanager
    def subprocess_runner(self, runner):
        """A context manager for temporarily overriding the default subprocess
        runner.
        """
        prev = self._subprocess_runner
        self._subprocess_runner = runner
        yield
        self._subprocess_runner = prev

    def get_requires_for_build_wheel(self, config_settings=None):
        """Identify packages required for building a wheel

        Returns a list of dependency specifications, e.g.:
            ["wheel >= 0.25", "setuptools"]

        This does not include requirements specified in pyproject.toml.
        It returns the result of calling the equivalently named hook in a
        subprocess.
        """
        return self._call_hook('get_requires_for_build_wheel', {
            'config_settings': config_settings
        })

    def prepare_metadata_for_build_wheel(
            self, metadata_directory, config_settings=None,
            _allow_fallback=True):
        """Prepare a *.dist-info folder with metadata for this project.

        Returns the name of the newly created folder.

        If the build backend defines a hook with this name, it will be called
        in a subprocess. If not, the backend will be asked to build a wheel,
        and the dist-info extracted from that (unless _allow_fallback is
        False).
        """
        return self._call_hook('prepare_metadata_for_build_wheel', {
            'metadata_directory': abspath(metadata_directory),
            'config_settings': config_settings,
            '_allow_fallback': _allow_fallback,
        })

    def build_wheel(
            self, wheel_directory, config_settings=None,
            metadata_directory=None):
        """Build a wheel from this project.

        Returns the name of the newly created file.

        In general, this will call the 'build_wheel' hook in the backend.
        However, if that was previously called by
        'prepare_metadata_for_build_wheel', and the same metadata_directory is
        used, the previously built wheel will be copied to wheel_directory.
        """
        if metadata_directory is not None:
            metadata_directory = abspath(metadata_directory)
        return self._call_hook('build_wheel', {
            'wheel_directory': abspath(wheel_directory),
            'config_settings': config_settings,
            'metadata_directory': metadata_directory,
        })

    def get_requires_for_build_sdist(self, config_settings=None):
        """Identify packages required for building a wheel

        Returns a list of dependency specifications, e.g.:
            ["setuptools >= 26"]

        This does not include requirements specified in pyproject.toml.
        It returns the result of calling the equivalently named hook in a
        subprocess.
        """
        return self._call_hook('get_requires_for_build_sdist', {
            'config_settings': config_settings
        })

    def build_sdist(self, sdist_directory, config_settings=None):
        """Build an sdist from this project.

        Returns the name of the newly created file.

        This calls the 'build_sdist' backend hook in a subprocess.
        """
        return self._call_hook('build_sdist', {
            'sdist_directory': abspath(sdist_directory),
            'config_settings': config_settings,
        })

    def _call_hook(self, hook_name, kwargs):
        # On Python 2, pytoml returns Unicode values (which is correct) but the
        # environment passed to check_call needs to contain string values. We
        # convert here by encoding using ASCII (the backend can only contain
        # letters, digits and _, . and : characters, and will be used as a
        # Python identifier, so non-ASCII content is wrong on Python 2 in
        # any case).
        # For backend_path, we use sys.getfilesystemencoding.
        if sys.version_info[0] == 2:
            build_backend = self.build_backend.encode('ASCII')
        else:
            build_backend = self.build_backend
        extra_environ = {'PEP517_BUILD_BACKEND': build_backend}

        if self.backend_path:
            backend_path = os.pathsep.join(self.backend_path)
            if sys.version_info[0] == 2:
                backend_path = backend_path.encode(sys.getfilesystemencoding())
            extra_environ['PEP517_BACKEND_PATH'] = backend_path

        with tempdir() as td:
            hook_input = {'kwargs': kwargs}
            compat.write_json(hook_input, pjoin(td, 'input.json'),
                              indent=2)

            # Run the hook in a subprocess
            self._subprocess_runner(
                [sys.executable, _in_proc_script, hook_name, td],
                cwd=self.source_dir,
                extra_environ=extra_environ
            )

            data = compat.read_json(pjoin(td, 'output.json'))
            if data.get('unsupported'):
                raise UnsupportedOperation(data.get('traceback', ''))
            if data.get('no_backend'):
                raise BackendUnavailable(data.get('traceback', ''))
            if data.get('backend_invalid'):
                raise BackendInvalid(
                    backend_name=self.build_backend,
                    backend_path=self.backend_path,
                    message=data.get('backend_error', '')
                )
            if data.get('hook_missing'):
                raise HookMissing(hook_name)
            return data['return_val']


class LoggerWrapper(threading.Thread):
    """
    Read messages from a pipe and redirect them
    to a logger (see python's logging module).
    """

    def __init__(self, logger, level):
        threading.Thread.__init__(self)
        self.daemon = True

        self.logger = logger
        self.level = level

        # create the pipe and reader
        self.fd_read, self.fd_write = os.pipe()
        self.reader = os.fdopen(self.fd_read)

        self.start()

    def fileno(self):
        return self.fd_write

    @staticmethod
    def remove_newline(msg):
        return msg[:-1] if msg.endswith(os.linesep) else msg

    def run(self):
        for line in self.reader:
            self._write(self.remove_newline(line))

    def _write(self, message):
        self.logger.log(self.level, message)
site-packages/pip/_vendor/pep517/compat.py000064400000001414151446177000014373 0ustar00"""Python 2/3 compatibility"""
import json
import sys


# Handle reading and writing JSON in UTF-8, on Python 3 and 2.

if sys.version_info[0] >= 3:
    # Python 3
    def write_json(obj, path, **kwargs):
        with open(path, 'w', encoding='utf-8') as f:
            json.dump(obj, f, **kwargs)

    def read_json(path):
        with open(path, 'r', encoding='utf-8') as f:
            return json.load(f)

else:
    # Python 2
    def write_json(obj, path, **kwargs):
        with open(path, 'wb') as f:
            json.dump(obj, f, encoding='utf-8', **kwargs)

    def read_json(path):
        with open(path, 'rb') as f:
            return json.load(f)


# FileNotFoundError

try:
    FileNotFoundError = FileNotFoundError
except NameError:
    FileNotFoundError = IOError
site-packages/pip/_vendor/pep517/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000366151446177000022101 0ustar00U

��.eT�@sdZdZdS)z6Wrappers to build Python packages using PEP 517 hooks
z0.7.0N)�__doc__�__version__�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/__init__.py�<module>ssite-packages/pip/_vendor/pep517/__pycache__/wrappers.cpython-38.pyc000064400000023636151446177000021253 0ustar00U

��.eg)�@sddlZddlmZddlZddlmZmZmZddl	Z	ddl
mZmZm
Z
ddlZddlmZddlmZeeee��d�Zed	d
��ZGdd�de�ZGd
d�de�ZGdd�de�ZGdd�de�Zddd�Zddd�Zdd�ZGdd�de�ZGdd�dej �Z!dS)�N)�contextmanager)�dirname�abspath�join)�
check_call�check_output�STDOUT)�mkdtemp�)�compatz_in_process.pyc	cs"t�}z
|VW5t�|�XdS�N)r	�shutilZrmtree)�td�r�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/wrappers.py�tempdirs
rc@seZdZdZdd�ZdS)�BackendUnavailablezEWill be raised if the backend cannot be imported in the hook process.cCs
||_dSr��	traceback��selfrrrr�__init__szBackendUnavailable.__init__N��__name__�
__module__�__qualname__�__doc__rrrrrrsrc@seZdZdZdd�ZdS)�BackendInvalidz)Will be raised if the backend is invalid.cCs||_||_||_dSr��backend_name�backend_path�message)rrr r!rrrr szBackendInvalid.__init__Nrrrrrrsrcs eZdZdZ�fdd�Z�ZS)�HookMissingz Will be raised on missing hooks.cstt|��|�||_dSr)�superr"r�	hook_name)rr$��	__class__rrr(szHookMissing.__init__)rrrrr�
__classcell__rrr%rr"&sr"c@seZdZdZdd�ZdS)�UnsupportedOperationzDMay be raised by build_sdist if the backend indicates that it can't.cCs
||_dSrrrrrrr/szUnsupportedOperation.__init__Nrrrrrr(-sr(cCs*tj��}|r|�|�t|||d�dS)z5The default method of calling the wrapper subprocess.)�cwd�envN)�os�environ�copy�updater��cmdr)�
extra_environr*rrr�default_subprocess_runner3s

r2cCs,tj��}|r|�|�t|||td�dS)zDA method of calling the wrapper subprocess while suppressing output.)r)r*�stderrN)r+r,r-r.rrr/rrr�quiet_subprocess_runner<s

r4cCsntj�|�rtd��tj�|�}tj�tj�||��}tj�|�}tj�|�}tj�||g�|krjtd��|S)z�Normalise and check a backend path.

    Ensure that the requested backend path is specified as a relative path,
    and resolves to a location under the given source tree.

    Return an absolute version of the requested path.
    zpaths must be relativez paths must be inside source tree)	r+�path�isabs�
ValueErrorr�normpathr�normcase�commonprefix)Zsource_treeZ	requestedZ
abs_sourceZ
abs_requestedZnorm_sourceZnorm_requestedrrr�norm_and_checkEsr;c@s`eZdZdZddd�Zedd��Zddd�Zdd
d�Zddd
�Z	ddd�Z
ddd�Zdd�ZdS)�Pep517HookCalleraeA wrapper around a source directory to be built with a PEP 517 backend.

    source_dir : The path to the source directory, containing pyproject.toml.
    build_backend : The build backend spec, as per PEP 517, from
        pyproject.toml.
    backend_path : The backend path, as per PEP 517, from pyproject.toml.
    runner : A callable that invokes the wrapper subprocess.

    The 'runner', if provided, must expect the following:
        cmd : a list of strings representing the command and arguments to
            execute, as would be passed to e.g. 'subprocess.check_call'.
        cwd : a string representing the working directory that must be
            used for the subprocess. Corresponds to the provided source_dir.
        extra_environ : a dict mapping environment variable names to values
            which must be set for the subprocess execution.
    NcsB|dkrt}t|��_|�_|r2�fdd�|D�}|�_|�_dS)Ncsg|]}t�j|��qSr)r;�
source_dir)�.0�p�rrr�
<listcomp>{sz-Pep517HookCaller.__init__.<locals>.<listcomp>)r2rr=�
build_backendr �_subprocess_runner)rr=rBr �runnerrr@rrns

�zPep517HookCaller.__init__ccs|j}||_dV||_dS)z\A context manager for temporarily overriding the default subprocess
        runner.
        N)rC)rrD�prevrrr�subprocess_runner�sz"Pep517HookCaller.subprocess_runnercCs|�dd|i�S)aGIdentify packages required for building a wheel

        Returns a list of dependency specifications, e.g.:
            ["wheel >= 0.25", "setuptools"]

        This does not include requirements specified in pyproject.toml.
        It returns the result of calling the equivalently named hook in a
        subprocess.
        �get_requires_for_build_wheel�config_settings��
_call_hook�rrHrrrrG�s
�z-Pep517HookCaller.get_requires_for_build_wheelTcCs|�dt|�||d��S)aqPrepare a *.dist-info folder with metadata for this project.

        Returns the name of the newly created folder.

        If the build backend defines a hook with this name, it will be called
        in a subprocess. If not, the backend will be asked to build a wheel,
        and the dist-info extracted from that (unless _allow_fallback is
        False).
        � prepare_metadata_for_build_wheel)�metadata_directoryrH�_allow_fallback�rJr)rrMrHrNrrrrL�s
�z1Pep517HookCaller.prepare_metadata_for_build_wheelcCs(|dk	rt|�}|�dt|�||d��S)avBuild a wheel from this project.

        Returns the name of the newly created file.

        In general, this will call the 'build_wheel' hook in the backend.
        However, if that was previously called by
        'prepare_metadata_for_build_wheel', and the same metadata_directory is
        used, the previously built wheel will be copied to wheel_directory.
        N�build_wheel)�wheel_directoryrHrM)rrJ)rrQrHrMrrrrP�s�zPep517HookCaller.build_wheelcCs|�dd|i�S)a<Identify packages required for building a wheel

        Returns a list of dependency specifications, e.g.:
            ["setuptools >= 26"]

        This does not include requirements specified in pyproject.toml.
        It returns the result of calling the equivalently named hook in a
        subprocess.
        �get_requires_for_build_sdistrHrIrKrrrrR�s
�z-Pep517HookCaller.get_requires_for_build_sdistcCs|�dt|�|d��S)z�Build an sdist from this project.

        Returns the name of the newly created file.

        This calls the 'build_sdist' backend hook in a subprocess.
        �build_sdist)�sdist_directoryrHrO)rrTrHrrrrS�s�zPep517HookCaller.build_sdistc	
Cs@tjddkr|j�d�}n|j}d|i}|jrbtj�|j�}tjddkrZ|�t���}||d<t	���}d|i}t
j|t|d�dd�|j
tjt||g|j|d	�t
�t|d
��}|�d�r�t|�dd
���|�d�r�t|�dd
���|�d��rt|j|j|�dd
�d��|�d��r"t|��|dW5QR�SQRXdS)Nr��ASCIIZPEP517_BUILD_BACKENDZPEP517_BACKEND_PATH�kwargsz
input.json)�indent)r)r1zoutput.jsonZunsupportedr�Z
no_backendZbackend_invalidZ
backend_errorrZhook_missingZ
return_val)�sys�version_inforB�encoder r+�pathsepr�getfilesystemencodingrrZ
write_json�pjoinrC�
executable�_in_proc_scriptr=Z	read_json�getr(rrr")	rr$rWrBr1r rZ
hook_input�datarrrrJ�sB��


�zPep517HookCaller._call_hook)NN)N)NT)NN)N)N)
rrrrrrrFrGrLrPrRrSrJrrrrr<]s �

	
�
�


r<c@s<eZdZdZdd�Zdd�Zedd��Zdd	�Zd
d�Z	dS)
�
LoggerWrapperzd
    Read messages from a pipe and redirect them
    to a logger (see python's logging module).
    cCsHtj�|�d|_||_||_t��\|_|_	t�
|j�|_|��dS)NT)
�	threading�ThreadrZdaemon�logger�levelr+�pipeZfd_read�fd_write�fdopen�reader�start)rrgrhrrrrszLoggerWrapper.__init__cCs|jSr)rjr@rrr�filenoszLoggerWrapper.filenocCs|�tj�r|dd�S|S)N���)�endswithr+�linesep)�msgrrr�remove_newline!szLoggerWrapper.remove_newlinecCs |jD]}|�|�|��qdSr)rl�_writers)r�linerrr�run%s
zLoggerWrapper.runcCs|j�|j|�dSr)rg�logrh)rr!rrrrt)szLoggerWrapper._writeN)
rrrrrrn�staticmethodrsrvrtrrrrrds

rd)NN)NN)"re�
contextlibrr+Zos.pathrrrr_r
�
subprocessrrrrZZtempfiler	rYr�__file__rar�	Exceptionrrr"r(r2r4r;�objectr<rfrdrrrr�<module>s*

	
	/site-packages/pip/_vendor/pep517/__pycache__/wrappers.cpython-38.opt-1.pyc000064400000023636151446177000022212 0ustar00U

��.eg)�@sddlZddlmZddlZddlmZmZmZddl	Z	ddl
mZmZm
Z
ddlZddlmZddlmZeeee��d�Zed	d
��ZGdd�de�ZGd
d�de�ZGdd�de�ZGdd�de�Zddd�Zddd�Zdd�ZGdd�de�ZGdd�dej �Z!dS)�N)�contextmanager)�dirname�abspath�join)�
check_call�check_output�STDOUT)�mkdtemp�)�compatz_in_process.pyc	cs"t�}z
|VW5t�|�XdS�N)r	�shutilZrmtree)�td�r�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/wrappers.py�tempdirs
rc@seZdZdZdd�ZdS)�BackendUnavailablezEWill be raised if the backend cannot be imported in the hook process.cCs
||_dSr��	traceback��selfrrrr�__init__szBackendUnavailable.__init__N��__name__�
__module__�__qualname__�__doc__rrrrrrsrc@seZdZdZdd�ZdS)�BackendInvalidz)Will be raised if the backend is invalid.cCs||_||_||_dSr��backend_name�backend_path�message)rrr r!rrrr szBackendInvalid.__init__Nrrrrrrsrcs eZdZdZ�fdd�Z�ZS)�HookMissingz Will be raised on missing hooks.cstt|��|�||_dSr)�superr"r�	hook_name)rr$��	__class__rrr(szHookMissing.__init__)rrrrr�
__classcell__rrr%rr"&sr"c@seZdZdZdd�ZdS)�UnsupportedOperationzDMay be raised by build_sdist if the backend indicates that it can't.cCs
||_dSrrrrrrr/szUnsupportedOperation.__init__Nrrrrrr(-sr(cCs*tj��}|r|�|�t|||d�dS)z5The default method of calling the wrapper subprocess.)�cwd�envN)�os�environ�copy�updater��cmdr)�
extra_environr*rrr�default_subprocess_runner3s

r2cCs,tj��}|r|�|�t|||td�dS)zDA method of calling the wrapper subprocess while suppressing output.)r)r*�stderrN)r+r,r-r.rrr/rrr�quiet_subprocess_runner<s

r4cCsntj�|�rtd��tj�|�}tj�tj�||��}tj�|�}tj�|�}tj�||g�|krjtd��|S)z�Normalise and check a backend path.

    Ensure that the requested backend path is specified as a relative path,
    and resolves to a location under the given source tree.

    Return an absolute version of the requested path.
    zpaths must be relativez paths must be inside source tree)	r+�path�isabs�
ValueErrorr�normpathr�normcase�commonprefix)Zsource_treeZ	requestedZ
abs_sourceZ
abs_requestedZnorm_sourceZnorm_requestedrrr�norm_and_checkEsr;c@s`eZdZdZddd�Zedd��Zddd�Zdd
d�Zddd
�Z	ddd�Z
ddd�Zdd�ZdS)�Pep517HookCalleraeA wrapper around a source directory to be built with a PEP 517 backend.

    source_dir : The path to the source directory, containing pyproject.toml.
    build_backend : The build backend spec, as per PEP 517, from
        pyproject.toml.
    backend_path : The backend path, as per PEP 517, from pyproject.toml.
    runner : A callable that invokes the wrapper subprocess.

    The 'runner', if provided, must expect the following:
        cmd : a list of strings representing the command and arguments to
            execute, as would be passed to e.g. 'subprocess.check_call'.
        cwd : a string representing the working directory that must be
            used for the subprocess. Corresponds to the provided source_dir.
        extra_environ : a dict mapping environment variable names to values
            which must be set for the subprocess execution.
    NcsB|dkrt}t|��_|�_|r2�fdd�|D�}|�_|�_dS)Ncsg|]}t�j|��qSr)r;�
source_dir)�.0�p�rrr�
<listcomp>{sz-Pep517HookCaller.__init__.<locals>.<listcomp>)r2rr=�
build_backendr �_subprocess_runner)rr=rBr �runnerrr@rrns

�zPep517HookCaller.__init__ccs|j}||_dV||_dS)z\A context manager for temporarily overriding the default subprocess
        runner.
        N)rC)rrD�prevrrr�subprocess_runner�sz"Pep517HookCaller.subprocess_runnercCs|�dd|i�S)aGIdentify packages required for building a wheel

        Returns a list of dependency specifications, e.g.:
            ["wheel >= 0.25", "setuptools"]

        This does not include requirements specified in pyproject.toml.
        It returns the result of calling the equivalently named hook in a
        subprocess.
        �get_requires_for_build_wheel�config_settings��
_call_hook�rrHrrrrG�s
�z-Pep517HookCaller.get_requires_for_build_wheelTcCs|�dt|�||d��S)aqPrepare a *.dist-info folder with metadata for this project.

        Returns the name of the newly created folder.

        If the build backend defines a hook with this name, it will be called
        in a subprocess. If not, the backend will be asked to build a wheel,
        and the dist-info extracted from that (unless _allow_fallback is
        False).
        � prepare_metadata_for_build_wheel)�metadata_directoryrH�_allow_fallback�rJr)rrMrHrNrrrrL�s
�z1Pep517HookCaller.prepare_metadata_for_build_wheelcCs(|dk	rt|�}|�dt|�||d��S)avBuild a wheel from this project.

        Returns the name of the newly created file.

        In general, this will call the 'build_wheel' hook in the backend.
        However, if that was previously called by
        'prepare_metadata_for_build_wheel', and the same metadata_directory is
        used, the previously built wheel will be copied to wheel_directory.
        N�build_wheel)�wheel_directoryrHrM)rrJ)rrQrHrMrrrrP�s�zPep517HookCaller.build_wheelcCs|�dd|i�S)a<Identify packages required for building a wheel

        Returns a list of dependency specifications, e.g.:
            ["setuptools >= 26"]

        This does not include requirements specified in pyproject.toml.
        It returns the result of calling the equivalently named hook in a
        subprocess.
        �get_requires_for_build_sdistrHrIrKrrrrR�s
�z-Pep517HookCaller.get_requires_for_build_sdistcCs|�dt|�|d��S)z�Build an sdist from this project.

        Returns the name of the newly created file.

        This calls the 'build_sdist' backend hook in a subprocess.
        �build_sdist)�sdist_directoryrHrO)rrTrHrrrrS�s�zPep517HookCaller.build_sdistc	
Cs@tjddkr|j�d�}n|j}d|i}|jrbtj�|j�}tjddkrZ|�t���}||d<t	���}d|i}t
j|t|d�dd�|j
tjt||g|j|d	�t
�t|d
��}|�d�r�t|�dd
���|�d�r�t|�dd
���|�d��rt|j|j|�dd
�d��|�d��r"t|��|dW5QR�SQRXdS)Nr��ASCIIZPEP517_BUILD_BACKENDZPEP517_BACKEND_PATH�kwargsz
input.json)�indent)r)r1zoutput.jsonZunsupportedr�Z
no_backendZbackend_invalidZ
backend_errorrZhook_missingZ
return_val)�sys�version_inforB�encoder r+�pathsepr�getfilesystemencodingrrZ
write_json�pjoinrC�
executable�_in_proc_scriptr=Z	read_json�getr(rrr")	rr$rWrBr1r rZ
hook_input�datarrrrJ�sB��


�zPep517HookCaller._call_hook)NN)N)NT)NN)N)N)
rrrrrrrFrGrLrPrRrSrJrrrrr<]s �

	
�
�


r<c@s<eZdZdZdd�Zdd�Zedd��Zdd	�Zd
d�Z	dS)
�
LoggerWrapperzd
    Read messages from a pipe and redirect them
    to a logger (see python's logging module).
    cCsHtj�|�d|_||_||_t��\|_|_	t�
|j�|_|��dS)NT)
�	threading�ThreadrZdaemon�logger�levelr+�pipeZfd_read�fd_write�fdopen�reader�start)rrgrhrrrrszLoggerWrapper.__init__cCs|jSr)rjr@rrr�filenoszLoggerWrapper.filenocCs|�tj�r|dd�S|S)N���)�endswithr+�linesep)�msgrrr�remove_newline!szLoggerWrapper.remove_newlinecCs |jD]}|�|�|��qdSr)rl�_writers)r�linerrr�run%s
zLoggerWrapper.runcCs|j�|j|�dSr)rg�logrh)rr!rrrrt)szLoggerWrapper._writeN)
rrrrrrn�staticmethodrsrvrtrrrrrds

rd)NN)NN)"re�
contextlibrr+Zos.pathrrrr_r
�
subprocessrrrrZZtempfiler	rYr�__file__rar�	Exceptionrrr"r(r2r4r;�objectr<rfrdrrrr�<module>s*

	
	/site-packages/pip/_vendor/pep517/__pycache__/compat.cpython-38.pyc000064400000001765151446177000020672 0ustar00U

��.e�@sjdZddlZddlZejddkr4dd�Zdd�Zndd�Zd	d�ZzeZWnek
rdeZYnXdS)
zPython 2/3 compatibility�N�c	Ks.t|ddd��}tj||f|�W5QRXdS)N�w�utf-8��encoding��open�json�dump��obj�path�kwargs�f�r�=/usr/lib/python3.8/site-packages/pip/_vendor/pep517/compat.py�
write_json
src
Cs0t|ddd��}t�|�W5QR�SQRXdS)N�rrr�rr	�load�r
rrrr�	read_jsonsrc	Ks2t|d��}tj||fddi|��W5QRXdS)N�wbrrrrrrrrsc
Cs,t|d��}t�|�W5QR�SQRXdS)N�rbrrrrrrs)	�__doc__r	�sys�version_inforr�FileNotFoundError�	NameError�IOErrorrrrr�<module>s
site-packages/pip/_vendor/pep517/__pycache__/build.cpython-38.opt-1.pyc000064400000006406151446177000021442 0ustar00U

��.e��@s�dZddlZddlZddlZddlZddlZddlmZddlm	Z	ddl
mZmZddl
mZe�e�Zdd	�Zd
d�Zdd
�Zdd�Zd"dd�Ze��Zejddd�ejddddd�ejddddd�ejdddd�dd �Zed!kr�ee���dS)#z%Build a project using PEP 517 hooks.
�N�)�BuildEnvironment)�Pep517HookCaller)�tempdir�mkdir_p)�FileNotFoundErrorcCs4ddh}|t|�ks0dj|t|�d�}t|��dS)z7
    Ensure build system has the requisite fields.
    �requires�
build-backendz"Missing required fields: {missing})ZmissingN)�set�format�
ValueError)�systemZrequired�message�r�</usr/lib/python3.8/site-packages/pip/_vendor/pep517/build.py�validate_systems
�rc	Cs4tj�|d�}t|��}t�|�}W5QRX|dS)zC
    Load the build system from a source dir (pyproject.toml).
    zpyproject.tomlzbuild-system)�os�path�join�open�toml�load)�
source_dirZ	pyproject�fZpyproject_datarrr�load_systems
rc	CsJzt|�}Wnttfk
r(i}YnX|�dd�|�dddg�|S)z�
    Given a source dir, attempt to get a build system backend
    and requirements from pyproject.toml. Fallback to
    setuptools but only if the file was not found or a build
    system was not indicated.
    r	z setuptools.build_meta:__legacy__rZ
setuptools�wheel)rr�KeyError�
setdefault)rr
rrr�
compat_system's
�rc
Cs�djft��}t||�}|i�}t�d|�|�|�t�d�t��b}t�d||�djft��}t||�}	|	|i�}
tj�	||
�}t
�|tj�	|tj�|
���W5QRXdS)Nzget_requires_for_build_{dist}zGot build requires: %sz$Installed dynamic build dependencieszTrying to build %s in %szbuild_{dist})
r�locals�getattr�log�info�pip_installrrrr�shutilZmove�basename)�hooks�env�dist�destZget_requires_nameZget_requiresZreqsZtdZ
build_name�build�filename�sourcerrr�	_do_build:s




r-c	Csv|p
t|�}tj�||pd�}t|�t|�t||d|�d��}t��"}|�	|d�t
||||�W5QRXdS)Nr(r	zbackend-pathr)rrrrrrr�getrr#r-)rr(r)r
r&r'rrrr*Ls�r*rz%A directory containing pyproject.toml)�helpz--binaryz-b�
store_trueF)�action�defaultz--sourcez-sz	--out-dirz-oz>Destination in which to save the builds relative to source dircCsPttd|js|jsdnd|js$|js(dndf��}|D]}t|j||j�q6dS)NZsdistr)�list�filterr,Zbinaryr*rZout_dir)�argsZdistsr(rrr�mainps�r6�__main__)NN)�__doc__�argparseZloggingrrr$ZenvbuildrZwrappersrZdirtoolsrr�compatrZ	getLogger�__name__r!rrrr-r*�ArgumentParser�parser�add_argumentr6�
parse_argsrrrr�<module>sP


����site-packages/pip/_vendor/pep517/__pycache__/_in_process.cpython-38.pyc000064400000016405151446177000021707 0ustar00U

��.ep�@s0dZddlmZddlmZddlZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZGdd�de
�ZGdd	�d	e
�ZGd
d�de
�Zdd
�Zdd�Zdd�Zdd�ZdZdd�Zdd�Zdd�Zd(dd�Zdd�ZGdd �d e
�ZGd!d"�d"e
�Zd#d$�Zddddd$hZd%d&�Ze d'k�r,e�dS))agThis is invoked in a subprocess to call the build backend hooks.

It expects:
- Command line args: hook_name, control_dir
- Environment variables:
      PEP517_BUILD_BACKEND=entry.point:spec
      PEP517_BACKEND_PATH=paths (separated with os.pathsep)
- control_dir/input.json:
  - {"kwargs": {...}}

Results:
- control_dir/output.json
  - {"return_val": ...}
�)�glob)�
import_moduleN)�joinc@seZdZdZdd�ZdS)�BackendUnavailablez&Raised if we cannot import the backendcCs
||_dS�N��	traceback��selfr�r�B/usr/lib/python3.8/site-packages/pip/_vendor/pep517/_in_process.py�__init__szBackendUnavailable.__init__N��__name__�
__module__�__qualname__�__doc__r
rrrrrsrc@seZdZdZdd�ZdS)�BackendInvalidz Raised if the backend is invalidcCs
||_dSr)�message)r
rrrrr
%szBackendInvalid.__init__Nrrrrrr#src@seZdZdZdS)�HookMissingzARaised if a hook is missing and we are not executing the fallbackN�rrrrrrrrr)srcCs<tj�tj�|��}tj�tj�|��}tj�||g�|kS)z5Test if a file is located within the given directory.)�os�path�normcase�abspath�commonprefix)�filenameZ	directoryrrr�contained_in-srcs�tj�d�}|r*|�tj�}|tjdd�<tjd}|�d�\}}}zt|��Wn t	k
rpt
t����YnX|r�t
�fdd�|D��s�td��|r�|�d	�D]}t�|��q��S)
zFind and load the build backendZPEP517_BACKEND_PATHNrZPEP517_BUILD_BACKEND�:c3s|]}t�j|�VqdSr)r�__file__)�.0r��objrr�	<genexpr>Ds�z!_build_backend.<locals>.<genexpr>z(Backend was not loaded from backend-path�.)r�environ�get�split�pathsep�sysr�	partitionr�ImportErrorrr�
format_exc�anyr�getattr)Zbackend_pathZextra_pathitemsZepZmod_path�_Zobj_pathZ	path_partrr!r�_build_backend4s&
�r0cCs6t�}z
|j}Wntk
r(gYSX||�SdS�zfInvoke the optional get_requires_for_build_wheel hook

    Returns [] if the hook is not defined.
    N)r0�get_requires_for_build_wheel�AttributeError��config_settings�backend�hookrrrr2Ps

r2cCsJt�}z
|j}Wn*tk
r:|s*t��t|||�YSX|||�SdS)z�Invoke optional prepare_metadata_for_build_wheel

    Implements a fallback by building a wheel if the hook isn't defined,
    unless _allow_fallback is False in which case HookMissing is raised.
    N)r0� prepare_metadata_for_build_wheelr3r�_get_wheel_metadata_from_wheel)�metadata_directoryr5Z_allow_fallbackr6r7rrrr8^s
�
r8ZPEP517_ALREADY_BUILT_WHEELcCs@g}|��D]}t�d|�}|r|�|�q|r4|Std��dS)z6Identify the .dist-info folder inside a wheel ZipFile.z[^/\\]+-[^/\\]+\.dist-info/z#No .dist-info folder found in wheelN)Znamelist�re�match�append�	Exception)Zwhl_zip�resr�mrrr�_dist_info_filestsrAc	Cs�ddlm}|�||�}ttj�|t�d��W5QRXtj�||�}||��}t|�}|j	||d�W5QRX|d�
d�dS)z�Build a wheel and extract the metadata from it.

    Fallback for when the build backend does not
    define the 'get_wheel_metadata' hook.
    r)�ZipFile�wb)r�members�/)ZzipfilerB�build_wheel�openrrr�WHEEL_BUILT_MARKERrAZ
extractallr')r6r:r5rBZwhl_basenameZwhl_fileZzipfZ	dist_inforrrr9�s

r9cCsl|sdStj�|�}tj�t|t��s*dSttj�|d��}|sLtd�dSt	|�dkrdtd�dS|dS)zHCheck for a wheel already built during the get_wheel_metadata hook.
    Nz*.whlz+Found wheel built marker, but no .whl files�zHFound multiple .whl files; unspecified behaviour. Will call build_wheel.r)
rr�dirname�isfile�pjoinrHrr�print�len)r:Zmetadata_parentZ	whl_filesrrr�_find_already_built_wheel�srOcCs4t|�}|r$t�||�tj�|�St��|||�S)z�Invoke the mandatory build_wheel hook.

    If a wheel was already built in the
    prepare_metadata_for_build_wheel fallback, this
    will copy it rather than rebuilding the wheel.
    )rO�shutilZcopy2rr�basenamer0rF)Zwheel_directoryr5r:Zprebuilt_whlrrrrF�s
�rFcCs6t�}z
|j}Wntk
r(gYSX||�SdSr1)r0�get_requires_for_build_sdistr3r4rrrrR�s

rRc@seZdZdZdS)�_DummyExceptionz(Nothing should ever raise this exceptionNrrrrrrS�srSc@seZdZdZdd�ZdS)�GotUnsupportedOperationz9For internal use when backend raises UnsupportedOperationcCs
||_dSrrr	rrrr
�sz GotUnsupportedOperation.__init__NrrrrrrT�srTcCsBt�}z|�||�WSt|dt�k
r<tt����YnXdS)z&Invoke the mandatory build_sdist hook.�UnsupportedOperationN)r0�build_sdistr.rSrTrr,)Zsdist_directoryr5r6rrrrV�s
rVc
CsNttj�dkrt�d�tjd}tjd}|tkrBt�d|�t�|}t�t|d��}ddd�}z|f|d	�|d
<Wn�t	k
r�}zd|d<|j
|d
<W5d}~XYn�tk
r�}zd|d<|j|d<W5d}~XYnRt
k
�r}zd|d<|j
|d
<W5d}~XYntk
�r2d|d<YnXtj|t|d�dd�dS)N�z"Needs args: hook_name, control_dirrI�zUnknown hook: %sz
input.jsonF)�unsupported�
return_val�kwargsrZTZ
no_backendrZbackend_invalidZ
backend_errorrYZhook_missingzoutput.json)�indent)rNr)�argv�exit�
HOOK_NAMES�globals�compatZ	read_jsonrLrrrrrTrZ
write_json)Z	hook_nameZcontrol_dirr7Z
hook_inputZjson_out�errr�main�s.




rc�__main__)N)!rr�	importlibrrZos.pathrrLr;rPr)rrar>rrrrr0r2r8rHrAr9rOrFrRrSrTrVr_rcrrrrr�<module>sF

�	
site-packages/pip/_vendor/pep517/__pycache__/meta.cpython-38.opt-1.pyc000064400000005406151446177000021270 0ustar00U

��.e�	�@sBdZddlZddlZddlZddlZddlZzddlmZWne	k
rXddl
ZYnXzddlmZWn e	k
r�ddl
mZYnXddlmZddlmZmZddlmZmZmZddlmZmZmZe�e�Zd	d
�Zddd
�Zefdd�Zdd�Z e�!�Z"e"j#ddd�e"j#dddd�dd�Z$edk�r>e$�dS)z2Build metadata for a project using PEP 517 hooks.
�N)�Path�)�BuildEnvironment)�Pep517HookCaller�quiet_subprocess_runner)�tempdir�mkdir_p�dir_to_zipfile)�validate_system�load_system�
compat_systemc
Cs�|�i�}t�d|�|�|�t�d�t��J}t�d|�|�|i�}tj�||�}t	�
|tj�|tj�|���W5QRXdS)NzGot build requires: %sz$Installed dynamic build dependencieszTrying to build metadata in %s)Zget_requires_for_build_wheel�log�info�pip_installrZ prepare_metadata_for_build_wheel�os�path�join�shutilZmove�basename)�hooks�env�destZreqsZtd�filename�source�r�;/usr/lib/python3.8/site-packages/pip/_vendor/pep517/meta.py�
_prep_metas


r�.c
Cs�|p
t|�}tj�||pd�}t|�t|�t||d|�d��}|�t	��2t
�� }|�|d�t|||�W5QRXW5QRXdS)NZdistz
build-backendzbackend-pathZrequires)
rrrrrr
r�getZsubprocess_runnerrrrr)�
source_dirr�systemrrrrr�build)s�r!c
Cs0t�� }||d�t|�W5QR�SQRXdS)N)r)rr	)�builder�out_dirrrr�build_as_zip8s
r$cCs:tj�|�}t|�}tjt||d�}tt|��}t	�
|�S)z�
    Given a source directory (root) of a package,
    return an importlib.metadata.Distribution object
    with metadata build from that package.
    )rr )rr�
expanduserr�	functools�partialr!rr$�imp_metaZPathDistribution)�rootr r"rrrr�load>s
r*rz%A directory containing pyproject.toml)�helpz	--out-dirz-oz>Destination in which to save the builds relative to source dircCst��}t|j|j�dS)N)�parser�
parse_argsr!rr#)�argsrrr�mainVsr/�__main__)rNN)%�__doc__�argparseZloggingrrr&�importlib.metadataZmetadatar(�ImportErrorZimportlib_metadataZzipfilerZzippZenvbuildrZwrappersrrZdirtoolsrrr	r!r
rrZ	getLogger�__name__r
rr$r*�ArgumentParserr,�add_argumentr/rrrr�<module>sF


��
site-packages/pip/_vendor/pep517/__pycache__/colorlog.cpython-38.opt-1.pyc000064400000005544151446177000022165 0ustar00U

��.e�@sfdZddlZddlZzddlZWnek
r8dZYnXdd�ZGdd�dej�Zejfdd�Z	dS)	zONicer log formatting with colours.

Code copied from Tornado, Apache licensed.
�NcCsVd}trRttjd�rRtj��rRzt��t�d�dkr:d}Wntk
rPYnX|S)NF�isattyZcolorsrT)�curses�hasattr�sys�stderrrZ	setuptermZtigetnum�	Exception)�color�r	�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/colorlog.py�_stderr_supports_colorsrc@s>eZdZdZejdejdejdejdiZ	ddd�Z
d	d
�ZdS)�LogFormatterz&Log formatter with colour support
    ���TNcCs�tjj||d�i|_|r�t�r�t�d�p6t�d�p6d}dtjkrNdkr\nn
t	|d�}|j
��D] \}}t	t�||�d�|j|<qft	t�d�d�|_
t��}|��d	|_t��nd|_
d
|_dS)aO
        :arg bool color: Enables color support.
        :arg string fmt: Log message format.
        It will be applied to the attributes dict of log records. The
        text between ``%(color)s`` and ``%(end_color)s`` will be colored
        depending on the level if color support is on.
        :arg dict colors: color mappings from logging level to terminal color
        code
        :arg string datefmt: Datetime format.
        Used for formatting ``(asctime)`` placeholder in ``prefix_fmt``.
        .. versionchanged:: 3.2
        Added ``fmt`` and ``datefmt`` arguments.
        )�datefmtZsetafZsetf�)rr)rr
r�asciiZsgr0r�FN)�logging�	Formatter�__init__�_colorsrrZtigetstrr�version_info�str�DEFAULT_COLORS�itemsZtparm�_normalZinitscrZgetmaxyx�	termwidthZendwin)�selfrrZfg_color�levelno�codeZscrr	r	r
r2s*

��

�
zLogFormatter.__init__cCs�t|j�}dj|jd|jd�}|t|�|jkrJd|j|t|�}nd}|j|jkrn|j|j}|j}nd}}|j||||S)Nz{initial}-{name}r)�initial�name� z  r)	�len�message�formatZ	levelnamer"rrrr)r�recordZmlenZ
right_textZspaceZstart_colorZ	end_colorr	r	r
�
formatMessage]s
�zLogFormatter.formatMessage)TN)�__name__�
__module__�__qualname__�__doc__r�INFOZWARNINGZERRORZCRITICALrrr(r	r	r	r
r(s�
+rcCs0t��}|�t��tj�|�tj�|�dS)N)rZ
StreamHandlerZsetFormatterr�rootZ
addHandlerZsetLevel)�levelZhandlerr	r	r
�enable_colourful_outputosr0)
r,rrr�ImportErrorrrrr-r0r	r	r	r
�<module>s
Gsite-packages/pip/_vendor/pep517/__pycache__/envbuild.cpython-38.opt-1.pyc000064400000010442151446177000022146 0ustar00U

��.e��@s�dZddlZddlZddlZddlZddlmZddlZddlm	Z	ddl
mZddlm
Z
mZe�e�Zdd	�ZGd
d�de�Zddd
�Zddd�ZdS)zIBuild wheels/sdists by installing build deps to a temporary environment.
�N)�
check_call)�	get_paths)�mkdtemp�)�Pep517HookCaller�
LoggerWrapperc	CsHttj�|d���}t�|�}W5QRX|d}|d|d|�d�fS)Nzpyproject.tomlzbuild-system�requiresz
build-backendzbackend-path)�open�os�path�join�toml�load�get)�
source_dir�fZpyproject_dataZbuildsys�r�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/envbuild.py�_load_pyprojects�rc@s6eZdZdZdZddd�Zdd�Zdd	�Zd
d�ZdS)
�BuildEnvironmentz�Context manager to install build deps in a simple temporary environment

    Based on code I wrote for pip, which is MIT licensed.
    NTcCs
||_dS)N)�_cleanup)�selfZcleanuprrr�__init__9szBuildEnvironment.__init__cCs�tdd�|_t�d|j�tj�dd�|_tj�dd�|_tj	dkrHdnd}t
||j|jd�d	�}|d
}|jr�|tj|jtjd<n|tjtjtjd<|d|dkr�|d}n|dtj|d}|jr�|tj|jtjd<n
|tjd<|S)
Nzpep517-build-env-)�prefixzTemporary build environment: %s�PATH�
PYTHONPATH�ntZposix_prefix)�baseZplatbase)�vars�scriptsZpurelibZplatlib)
rr�log�infor
�environr�	save_path�save_pythonpath�namer�pathsep�defpath)rZinstall_schemeZinstall_dirsrZlib_dirsrrr�	__enter__<s0�

��
zBuildEnvironment.__enter__cCsT|sdSt�d|�tjddddd|jgt|�}t|tttj	�tttj
�d�dS)	zAInstall dependencies into this env by calling pip in a subprocessNzCalling pip to install %sz-mZpipZinstallz--ignore-installedz--prefix)�stdout�stderr)r r!�sys�
executabler�listrr�logging�INFOZERROR)r�reqs�cmdrrr�pip_install\s$��

�zBuildEnvironment.pip_installcCs~|jo|jdk	otj�|j�}|r.t�|j�|jdkrHtj�dd�n|jtjd<|j	dkrntj�dd�n|j	tjd<dS)Nrr)
rrr
�isdir�shutilZrmtreer#r"�popr$)r�exc_typeZexc_valZexc_tbZ
needs_cleanuprrr�__exit__js��

zBuildEnvironment.__exit__)T)	�__name__�
__module__�__qualname__�__doc__rrr(r2r7rrrrrs
 rc	
Csn|dkri}t|�\}}}t|||�}t��8}|�|�|�|�}|�|�|�||�W5QR�SQRXdS)amBuild a wheel from a source directory using PEP 517 hooks.

    :param str source_dir: Source directory containing pyproject.toml
    :param str wheel_dir: Target directory to create wheel in
    :param dict config_settings: Options to pass to build backend

    This is a blocking function which will run pip in a subprocess to install
    build requirements.
    N)rrrr2Zget_requires_for_build_wheel�build_wheel)	rZ	wheel_dir�config_settingsr�backend�backend_path�hooks�envr0rrrr<~s



r<c	
Csn|dkri}t|�\}}}t|||�}t��8}|�|�|�|�}|�|�|�||�W5QR�SQRXdS)amBuild an sdist from a source directory using PEP 517 hooks.

    :param str source_dir: Source directory containing pyproject.toml
    :param str sdist_dir: Target directory to place sdist in
    :param dict config_settings: Options to pass to build backend

    This is a blocking function which will run pip in a subprocess to install
    build requirements.
    N)rrrr2Zget_requires_for_build_sdist�build_sdist)	rZ	sdist_dirr=rr>r?r@rAr0rrrrB�s



rB)N)N)r;r
r.r
r4�
subprocessrr+Z	sysconfigrZtempfilerZwrappersrrZ	getLoggerr8r r�objectrr<rBrrrr�<module>s
a
site-packages/pip/_vendor/pep517/__pycache__/envbuild.cpython-38.pyc000064400000010442151446177000021207 0ustar00U

��.e��@s�dZddlZddlZddlZddlZddlmZddlZddlm	Z	ddl
mZddlm
Z
mZe�e�Zdd	�ZGd
d�de�Zddd
�Zddd�ZdS)zIBuild wheels/sdists by installing build deps to a temporary environment.
�N)�
check_call)�	get_paths)�mkdtemp�)�Pep517HookCaller�
LoggerWrapperc	CsHttj�|d���}t�|�}W5QRX|d}|d|d|�d�fS)Nzpyproject.tomlzbuild-system�requiresz
build-backendzbackend-path)�open�os�path�join�toml�load�get)�
source_dir�fZpyproject_dataZbuildsys�r�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/envbuild.py�_load_pyprojects�rc@s6eZdZdZdZddd�Zdd�Zdd	�Zd
d�ZdS)
�BuildEnvironmentz�Context manager to install build deps in a simple temporary environment

    Based on code I wrote for pip, which is MIT licensed.
    NTcCs
||_dS)N)�_cleanup)�selfZcleanuprrr�__init__9szBuildEnvironment.__init__cCs�tdd�|_t�d|j�tj�dd�|_tj�dd�|_tj	dkrHdnd}t
||j|jd�d	�}|d
}|jr�|tj|jtjd<n|tjtjtjd<|d|dkr�|d}n|dtj|d}|jr�|tj|jtjd<n
|tjd<|S)
Nzpep517-build-env-)�prefixzTemporary build environment: %s�PATH�
PYTHONPATH�ntZposix_prefix)�baseZplatbase)�vars�scriptsZpurelibZplatlib)
rr�log�infor
�environr�	save_path�save_pythonpath�namer�pathsep�defpath)rZinstall_schemeZinstall_dirsrZlib_dirsrrr�	__enter__<s0�

��
zBuildEnvironment.__enter__cCsT|sdSt�d|�tjddddd|jgt|�}t|tttj	�tttj
�d�dS)	zAInstall dependencies into this env by calling pip in a subprocessNzCalling pip to install %sz-mZpipZinstallz--ignore-installedz--prefix)�stdout�stderr)r r!�sys�
executabler�listrr�logging�INFOZERROR)r�reqs�cmdrrr�pip_install\s$��

�zBuildEnvironment.pip_installcCs~|jo|jdk	otj�|j�}|r.t�|j�|jdkrHtj�dd�n|jtjd<|j	dkrntj�dd�n|j	tjd<dS)Nrr)
rrr
�isdir�shutilZrmtreer#r"�popr$)r�exc_typeZexc_valZexc_tbZ
needs_cleanuprrr�__exit__js��

zBuildEnvironment.__exit__)T)	�__name__�
__module__�__qualname__�__doc__rrr(r2r7rrrrrs
 rc	
Csn|dkri}t|�\}}}t|||�}t��8}|�|�|�|�}|�|�|�||�W5QR�SQRXdS)amBuild a wheel from a source directory using PEP 517 hooks.

    :param str source_dir: Source directory containing pyproject.toml
    :param str wheel_dir: Target directory to create wheel in
    :param dict config_settings: Options to pass to build backend

    This is a blocking function which will run pip in a subprocess to install
    build requirements.
    N)rrrr2Zget_requires_for_build_wheel�build_wheel)	rZ	wheel_dir�config_settingsr�backend�backend_path�hooks�envr0rrrr<~s



r<c	
Csn|dkri}t|�\}}}t|||�}t��8}|�|�|�|�}|�|�|�||�W5QR�SQRXdS)amBuild an sdist from a source directory using PEP 517 hooks.

    :param str source_dir: Source directory containing pyproject.toml
    :param str sdist_dir: Target directory to place sdist in
    :param dict config_settings: Options to pass to build backend

    This is a blocking function which will run pip in a subprocess to install
    build requirements.
    N)rrrr2Zget_requires_for_build_sdist�build_sdist)	rZ	sdist_dirr=rr>r?r@rAr0rrrrB�s



rB)N)N)r;r
r.r
r4�
subprocessrr+Z	sysconfigrZtempfilerZwrappersrrZ	getLoggerr8r r�objectrr<rBrrrr�<module>s
a
site-packages/pip/_vendor/pep517/__pycache__/dirtools.cpython-38.opt-1.pyc000064400000002417151446177000022200 0ustar00U

��.ei�@sZddlZddlZddlZddlZddlZddlZddlZejdd��Zdd�Z	dd�Z
dS)�Nc	cs$t��}z
|VW5t�|�XdS)z2Create a temporary directory in a context manager.N)�tempfileZmkdtemp�shutilZrmtree)Ztd�r�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/dirtools.py�tempdir
s
rc
OsDztj||�WStk
r>}z|jtjkr.�W5d}~XYnXdS)zWLike `mkdir`, but does not raise an exception if the
    directory already exists.
    N)�os�mkdir�OSError�errnoZEEXIST)�args�kwargs�excrrr�mkdir_ps
rcCs�t��}t�|d�}t�|�D]r\}}}|D]0}tj�||�}tj�||�}|�	|dd�q,|D],}tj�||�}tj�||�}|�
||�qbq|S)z0Construct an in-memory zip file for a directory.�w�/�)�io�BytesIO�zipfileZZipFiler�walk�path�join�relpathZwritestr�write)�root�bufferZzip_file�dirs�filesrZfs_pathZrel_pathrrr�dir_to_zipfilesr)rr�
contextlibrrr
r�contextmanagerrrrrrrr�<module>s
	site-packages/pip/_vendor/pep517/__pycache__/build.cpython-38.pyc000064400000006406151446177000020503 0ustar00U

��.e��@s�dZddlZddlZddlZddlZddlZddlmZddlm	Z	ddl
mZmZddl
mZe�e�Zdd	�Zd
d�Zdd
�Zdd�Zd"dd�Ze��Zejddd�ejddddd�ejddddd�ejdddd�dd �Zed!kr�ee���dS)#z%Build a project using PEP 517 hooks.
�N�)�BuildEnvironment)�Pep517HookCaller)�tempdir�mkdir_p)�FileNotFoundErrorcCs4ddh}|t|�ks0dj|t|�d�}t|��dS)z7
    Ensure build system has the requisite fields.
    �requires�
build-backendz"Missing required fields: {missing})ZmissingN)�set�format�
ValueError)�systemZrequired�message�r�</usr/lib/python3.8/site-packages/pip/_vendor/pep517/build.py�validate_systems
�rc	Cs4tj�|d�}t|��}t�|�}W5QRX|dS)zC
    Load the build system from a source dir (pyproject.toml).
    zpyproject.tomlzbuild-system)�os�path�join�open�toml�load)�
source_dirZ	pyproject�fZpyproject_datarrr�load_systems
rc	CsJzt|�}Wnttfk
r(i}YnX|�dd�|�dddg�|S)z�
    Given a source dir, attempt to get a build system backend
    and requirements from pyproject.toml. Fallback to
    setuptools but only if the file was not found or a build
    system was not indicated.
    r	z setuptools.build_meta:__legacy__rZ
setuptools�wheel)rr�KeyError�
setdefault)rr
rrr�
compat_system's
�rc
Cs�djft��}t||�}|i�}t�d|�|�|�t�d�t��b}t�d||�djft��}t||�}	|	|i�}
tj�	||
�}t
�|tj�	|tj�|
���W5QRXdS)Nzget_requires_for_build_{dist}zGot build requires: %sz$Installed dynamic build dependencieszTrying to build %s in %szbuild_{dist})
r�locals�getattr�log�info�pip_installrrrr�shutilZmove�basename)�hooks�env�dist�destZget_requires_nameZget_requiresZreqsZtdZ
build_name�build�filename�sourcerrr�	_do_build:s




r-c	Csv|p
t|�}tj�||pd�}t|�t|�t||d|�d��}t��"}|�	|d�t
||||�W5QRXdS)Nr(r	zbackend-pathr)rrrrrrr�getrr#r-)rr(r)r
r&r'rrrr*Ls�r*rz%A directory containing pyproject.toml)�helpz--binaryz-b�
store_trueF)�action�defaultz--sourcez-sz	--out-dirz-oz>Destination in which to save the builds relative to source dircCsPttd|js|jsdnd|js$|js(dndf��}|D]}t|j||j�q6dS)NZsdistr)�list�filterr,Zbinaryr*rZout_dir)�argsZdistsr(rrr�mainps�r6�__main__)NN)�__doc__�argparseZloggingrrr$ZenvbuildrZwrappersrZdirtoolsrr�compatrZ	getLogger�__name__r!rrrr-r*�ArgumentParser�parser�add_argumentr6�
parse_argsrrrr�<module>sP


����site-packages/pip/_vendor/pep517/__pycache__/dirtools.cpython-38.pyc000064400000002417151446177000021241 0ustar00U

��.ei�@sZddlZddlZddlZddlZddlZddlZddlZejdd��Zdd�Z	dd�Z
dS)�Nc	cs$t��}z
|VW5t�|�XdS)z2Create a temporary directory in a context manager.N)�tempfileZmkdtemp�shutilZrmtree)Ztd�r�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/dirtools.py�tempdir
s
rc
OsDztj||�WStk
r>}z|jtjkr.�W5d}~XYnXdS)zWLike `mkdir`, but does not raise an exception if the
    directory already exists.
    N)�os�mkdir�OSError�errnoZEEXIST)�args�kwargs�excrrr�mkdir_ps
rcCs�t��}t�|d�}t�|�D]r\}}}|D]0}tj�||�}tj�||�}|�	|dd�q,|D],}tj�||�}tj�||�}|�
||�qbq|S)z0Construct an in-memory zip file for a directory.�w�/�)�io�BytesIO�zipfileZZipFiler�walk�path�join�relpathZwritestr�write)�root�bufferZzip_file�dirs�filesrZfs_pathZrel_pathrrr�dir_to_zipfilesr)rr�
contextlibrrr
r�contextmanagerrrrrrrr�<module>s
	site-packages/pip/_vendor/pep517/__pycache__/compat.cpython-38.opt-1.pyc000064400000001765151446177000021631 0ustar00U

��.e�@sjdZddlZddlZejddkr4dd�Zdd�Zndd�Zd	d�ZzeZWnek
rdeZYnXdS)
zPython 2/3 compatibility�N�c	Ks.t|ddd��}tj||f|�W5QRXdS)N�w�utf-8��encoding��open�json�dump��obj�path�kwargs�f�r�=/usr/lib/python3.8/site-packages/pip/_vendor/pep517/compat.py�
write_json
src
Cs0t|ddd��}t�|�W5QR�SQRXdS)N�rrr�rr	�load�r
rrrr�	read_jsonsrc	Ks2t|d��}tj||fddi|��W5QRXdS)N�wbrrrrrrrrsc
Cs,t|d��}t�|�W5QR�SQRXdS)N�rbrrrrrrs)	�__doc__r	�sys�version_inforr�FileNotFoundError�	NameError�IOErrorrrrr�<module>s
site-packages/pip/_vendor/pep517/__pycache__/check.cpython-38.opt-1.pyc000064400000011240151446177000021410 0ustar00U

��.e=�@s�dZddlZddlZddlZddlmZmZddlm	Z	m
ZddlZddl
mZddlZddlZddlmZddlZddlmZdd	lmZdd
lmZe�e�Zdd�Zd
d�Zdd�Zddd�Z ddddd�Z!dd�Z"edkr�e �dS)zHCheck a project and backend by attempting to build using PEP 517 hooks.
�N)�isfile�join)�TomlDecodeError�load)�CalledProcessError)�mkdtemp�)�enable_colourful_output)�BuildEnvironment)�Pep517HookCallerc
Cst����}z|�|�t�d�Wn*tk
rLt�d�YW5QR�dSXz|�i�}t�d|�Wn.tk
r�tjddd�YW5QR�dSXz|�|�t�d�Wn*tk
r�t�d	�YW5QR�dSXt�}t�d
|�z�z|�|i�}t�d|�Wn4tk
�r@tjddd�YW��W5QR�dSX|�d
��slt�d|�W��W5QR�dSt
||�}t|��r�t�d|�nt�d|�W�FW5QR�dSt�|��r�t�d�nt�d�W�W5QR�dSW5t	�
|�XW5QR�dSQRXdS)N�#Installed static build dependencies�+Failed to install static build dependenciesF�Got build requires: %s�'Failure in get_requires_for_build_sdistT��exc_info�$Installed dynamic build dependencies�,Failed to install dynamic build dependencieszTrying to build sdist in %szbuild_sdist returned %rzFailure in build_sdistz.tar.gzz*Filename %s doesn't have .tar.gz extension�Output file %s exists�Output file %s does not existzOutput file is a tar filezOutput file is not a tar file)r
�pip_install�log�infor�errorZget_requires_for_build_sdist�	Exceptionr�shutil�rmtreeZbuild_sdist�endswith�pjoinr�tarfileZ
is_tarfile��hooksZbuild_sys_requires�envZreqsZtd�filename�path�r%�</usr/lib/python3.8/site-packages/pip/_vendor/pep517/check.py�check_build_sdistsZ





�


r'c
Cst����}z|�|�t�d�Wn*tk
rLt�d�YW5QR�dSXz|�i�}t�d|�Wn.tk
r�tjddd�YW5QR�dSXz|�|�t�d�Wn*tk
r�t�d	�YW5QR�dSXt�}t�d
|�z�z|�|i�}t�d|�Wn4tk
�r@tjddd�YW��W5QR�dSX|�d
��slt�d|�W��W5QR�dSt
||�}t|��r�t�d|�nt�d|�W�FW5QR�dSt�|��r�t�d�nt�d�W�W5QR�dSW5t	�
|�XW5QR�dSQRXdS)Nrr
FrrTrrrzTrying to build wheel in %szbuild_wheel returned %rzFailure in build_wheelz.whlz'Filename %s doesn't have .whl extensionrrzOutput file is a zip filezOutput file is not a zip file)r
rrrrrZget_requires_for_build_wheelrrrrZbuild_wheelrrr�zipfileZ
is_zipfiler r%r%r&�check_build_wheelOsT








r)c	Cs�t|d�}t|�rt�d�nt�d�dSzLt|��}t|�}W5QRX|d}|d}|d}|�d�}t�d	�Wn(tt	fk
r�tjd
dd�YdSXt
|||�}t||�}	t||�}
|	s�t�
d
�|
s�t�
d�|	S)Nzpyproject.tomlzFound pyproject.tomlzMissing pyproject.tomlFzbuild-system�requiresz
build-backendzbackend-pathzLoaded pyproject.tomlzInvalid pyproject.tomlTrz%Sdist checks failed; scroll up to seezWheel checks failed)rrrrr�open�	toml_load�getr�KeyErrorrr'r)Zwarning)�
source_dirZ	pyproject�fZpyproject_dataZbuildsysr*ZbackendZbackend_pathr!Zsdist_okZwheel_okr%r%r&�check�s0







r1cCs`t��}|jddd�|�|�}t�t|j�}|rDttdd��nttdd��t	�
d�dS)	Nr/z%A directory containing pyproject.toml)�helpz
Checks passed�greenz
Checks failed�redr)�argparse�ArgumentParser�add_argument�
parse_argsr	r1r/�print�ansi�sys�exit)�argvZap�args�okr%r%r&�main�s�

r@zzzz)�resetZboldr4r3cCs8tjdkr,tj��r,t|t|�tdSt|�SdS)N�ntrA)�os�namer;�stdout�isatty�
ansi_codes�str)�s�attrr%r%r&r:�sr:�__main__)N)#�__doc__r5ZloggingrCZos.pathrrrZtomlrrr,r�
subprocessrr;rZtempfilerr(Zcolorlogr	Zenvbuildr
ZwrappersrZ	getLogger�__name__rr'r)r1r@rGr:r%r%r%r&�<module>s6
98"
�site-packages/pip/_vendor/pep517/__pycache__/_in_process.cpython-38.opt-1.pyc000064400000016405151446177000022646 0ustar00U

��.ep�@s0dZddlmZddlmZddlZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZGdd�de
�ZGdd	�d	e
�ZGd
d�de
�Zdd
�Zdd�Zdd�Zdd�ZdZdd�Zdd�Zdd�Zd(dd�Zdd�ZGdd �d e
�ZGd!d"�d"e
�Zd#d$�Zddddd$hZd%d&�Ze d'k�r,e�dS))agThis is invoked in a subprocess to call the build backend hooks.

It expects:
- Command line args: hook_name, control_dir
- Environment variables:
      PEP517_BUILD_BACKEND=entry.point:spec
      PEP517_BACKEND_PATH=paths (separated with os.pathsep)
- control_dir/input.json:
  - {"kwargs": {...}}

Results:
- control_dir/output.json
  - {"return_val": ...}
�)�glob)�
import_moduleN)�joinc@seZdZdZdd�ZdS)�BackendUnavailablez&Raised if we cannot import the backendcCs
||_dS�N��	traceback��selfr�r�B/usr/lib/python3.8/site-packages/pip/_vendor/pep517/_in_process.py�__init__szBackendUnavailable.__init__N��__name__�
__module__�__qualname__�__doc__r
rrrrrsrc@seZdZdZdd�ZdS)�BackendInvalidz Raised if the backend is invalidcCs
||_dSr)�message)r
rrrrr
%szBackendInvalid.__init__Nrrrrrr#src@seZdZdZdS)�HookMissingzARaised if a hook is missing and we are not executing the fallbackN�rrrrrrrrr)srcCs<tj�tj�|��}tj�tj�|��}tj�||g�|kS)z5Test if a file is located within the given directory.)�os�path�normcase�abspath�commonprefix)�filenameZ	directoryrrr�contained_in-srcs�tj�d�}|r*|�tj�}|tjdd�<tjd}|�d�\}}}zt|��Wn t	k
rpt
t����YnX|r�t
�fdd�|D��s�td��|r�|�d	�D]}t�|��q��S)
zFind and load the build backendZPEP517_BACKEND_PATHNrZPEP517_BUILD_BACKEND�:c3s|]}t�j|�VqdSr)r�__file__)�.0r��objrr�	<genexpr>Ds�z!_build_backend.<locals>.<genexpr>z(Backend was not loaded from backend-path�.)r�environ�get�split�pathsep�sysr�	partitionr�ImportErrorrr�
format_exc�anyr�getattr)Zbackend_pathZextra_pathitemsZepZmod_path�_Zobj_pathZ	path_partrr!r�_build_backend4s&
�r0cCs6t�}z
|j}Wntk
r(gYSX||�SdS�zfInvoke the optional get_requires_for_build_wheel hook

    Returns [] if the hook is not defined.
    N)r0�get_requires_for_build_wheel�AttributeError��config_settings�backend�hookrrrr2Ps

r2cCsJt�}z
|j}Wn*tk
r:|s*t��t|||�YSX|||�SdS)z�Invoke optional prepare_metadata_for_build_wheel

    Implements a fallback by building a wheel if the hook isn't defined,
    unless _allow_fallback is False in which case HookMissing is raised.
    N)r0� prepare_metadata_for_build_wheelr3r�_get_wheel_metadata_from_wheel)�metadata_directoryr5Z_allow_fallbackr6r7rrrr8^s
�
r8ZPEP517_ALREADY_BUILT_WHEELcCs@g}|��D]}t�d|�}|r|�|�q|r4|Std��dS)z6Identify the .dist-info folder inside a wheel ZipFile.z[^/\\]+-[^/\\]+\.dist-info/z#No .dist-info folder found in wheelN)Znamelist�re�match�append�	Exception)Zwhl_zip�resr�mrrr�_dist_info_filestsrAc	Cs�ddlm}|�||�}ttj�|t�d��W5QRXtj�||�}||��}t|�}|j	||d�W5QRX|d�
d�dS)z�Build a wheel and extract the metadata from it.

    Fallback for when the build backend does not
    define the 'get_wheel_metadata' hook.
    r)�ZipFile�wb)r�members�/)ZzipfilerB�build_wheel�openrrr�WHEEL_BUILT_MARKERrAZ
extractallr')r6r:r5rBZwhl_basenameZwhl_fileZzipfZ	dist_inforrrr9�s

r9cCsl|sdStj�|�}tj�t|t��s*dSttj�|d��}|sLtd�dSt	|�dkrdtd�dS|dS)zHCheck for a wheel already built during the get_wheel_metadata hook.
    Nz*.whlz+Found wheel built marker, but no .whl files�zHFound multiple .whl files; unspecified behaviour. Will call build_wheel.r)
rr�dirname�isfile�pjoinrHrr�print�len)r:Zmetadata_parentZ	whl_filesrrr�_find_already_built_wheel�srOcCs4t|�}|r$t�||�tj�|�St��|||�S)z�Invoke the mandatory build_wheel hook.

    If a wheel was already built in the
    prepare_metadata_for_build_wheel fallback, this
    will copy it rather than rebuilding the wheel.
    )rO�shutilZcopy2rr�basenamer0rF)Zwheel_directoryr5r:Zprebuilt_whlrrrrF�s
�rFcCs6t�}z
|j}Wntk
r(gYSX||�SdSr1)r0�get_requires_for_build_sdistr3r4rrrrR�s

rRc@seZdZdZdS)�_DummyExceptionz(Nothing should ever raise this exceptionNrrrrrrS�srSc@seZdZdZdd�ZdS)�GotUnsupportedOperationz9For internal use when backend raises UnsupportedOperationcCs
||_dSrrr	rrrr
�sz GotUnsupportedOperation.__init__NrrrrrrT�srTcCsBt�}z|�||�WSt|dt�k
r<tt����YnXdS)z&Invoke the mandatory build_sdist hook.�UnsupportedOperationN)r0�build_sdistr.rSrTrr,)Zsdist_directoryr5r6rrrrV�s
rVc
CsNttj�dkrt�d�tjd}tjd}|tkrBt�d|�t�|}t�t|d��}ddd�}z|f|d	�|d
<Wn�t	k
r�}zd|d<|j
|d
<W5d}~XYn�tk
r�}zd|d<|j|d<W5d}~XYnRt
k
�r}zd|d<|j
|d
<W5d}~XYntk
�r2d|d<YnXtj|t|d�dd�dS)N�z"Needs args: hook_name, control_dirrI�zUnknown hook: %sz
input.jsonF)�unsupported�
return_val�kwargsrZTZ
no_backendrZbackend_invalidZ
backend_errorrYZhook_missingzoutput.json)�indent)rNr)�argv�exit�
HOOK_NAMES�globals�compatZ	read_jsonrLrrrrrTrZ
write_json)Z	hook_nameZcontrol_dirr7Z
hook_inputZjson_out�errr�main�s.




rc�__main__)N)!rr�	importlibrrZos.pathrrLr;rPr)rrar>rrrrr0r2r8rHrAr9rOrFrRrSrTrVr_rcrrrrr�<module>sF

�	
site-packages/pip/_vendor/pep517/__pycache__/check.cpython-38.pyc000064400000011240151446177000020451 0ustar00U

��.e=�@s�dZddlZddlZddlZddlmZmZddlm	Z	m
ZddlZddl
mZddlZddlZddlmZddlZddlmZdd	lmZdd
lmZe�e�Zdd�Zd
d�Zdd�Zddd�Z ddddd�Z!dd�Z"edkr�e �dS)zHCheck a project and backend by attempting to build using PEP 517 hooks.
�N)�isfile�join)�TomlDecodeError�load)�CalledProcessError)�mkdtemp�)�enable_colourful_output)�BuildEnvironment)�Pep517HookCallerc
Cst����}z|�|�t�d�Wn*tk
rLt�d�YW5QR�dSXz|�i�}t�d|�Wn.tk
r�tjddd�YW5QR�dSXz|�|�t�d�Wn*tk
r�t�d	�YW5QR�dSXt�}t�d
|�z�z|�|i�}t�d|�Wn4tk
�r@tjddd�YW��W5QR�dSX|�d
��slt�d|�W��W5QR�dSt
||�}t|��r�t�d|�nt�d|�W�FW5QR�dSt�|��r�t�d�nt�d�W�W5QR�dSW5t	�
|�XW5QR�dSQRXdS)N�#Installed static build dependencies�+Failed to install static build dependenciesF�Got build requires: %s�'Failure in get_requires_for_build_sdistT��exc_info�$Installed dynamic build dependencies�,Failed to install dynamic build dependencieszTrying to build sdist in %szbuild_sdist returned %rzFailure in build_sdistz.tar.gzz*Filename %s doesn't have .tar.gz extension�Output file %s exists�Output file %s does not existzOutput file is a tar filezOutput file is not a tar file)r
�pip_install�log�infor�errorZget_requires_for_build_sdist�	Exceptionr�shutil�rmtreeZbuild_sdist�endswith�pjoinr�tarfileZ
is_tarfile��hooksZbuild_sys_requires�envZreqsZtd�filename�path�r%�</usr/lib/python3.8/site-packages/pip/_vendor/pep517/check.py�check_build_sdistsZ





�


r'c
Cst����}z|�|�t�d�Wn*tk
rLt�d�YW5QR�dSXz|�i�}t�d|�Wn.tk
r�tjddd�YW5QR�dSXz|�|�t�d�Wn*tk
r�t�d	�YW5QR�dSXt�}t�d
|�z�z|�|i�}t�d|�Wn4tk
�r@tjddd�YW��W5QR�dSX|�d
��slt�d|�W��W5QR�dSt
||�}t|��r�t�d|�nt�d|�W�FW5QR�dSt�|��r�t�d�nt�d�W�W5QR�dSW5t	�
|�XW5QR�dSQRXdS)Nrr
FrrTrrrzTrying to build wheel in %szbuild_wheel returned %rzFailure in build_wheelz.whlz'Filename %s doesn't have .whl extensionrrzOutput file is a zip filezOutput file is not a zip file)r
rrrrrZget_requires_for_build_wheelrrrrZbuild_wheelrrr�zipfileZ
is_zipfiler r%r%r&�check_build_wheelOsT








r)c	Cs�t|d�}t|�rt�d�nt�d�dSzLt|��}t|�}W5QRX|d}|d}|d}|�d�}t�d	�Wn(tt	fk
r�tjd
dd�YdSXt
|||�}t||�}	t||�}
|	s�t�
d
�|
s�t�
d�|	S)Nzpyproject.tomlzFound pyproject.tomlzMissing pyproject.tomlFzbuild-system�requiresz
build-backendzbackend-pathzLoaded pyproject.tomlzInvalid pyproject.tomlTrz%Sdist checks failed; scroll up to seezWheel checks failed)rrrrr�open�	toml_load�getr�KeyErrorrr'r)Zwarning)�
source_dirZ	pyproject�fZpyproject_dataZbuildsysr*ZbackendZbackend_pathr!Zsdist_okZwheel_okr%r%r&�check�s0







r1cCs`t��}|jddd�|�|�}t�t|j�}|rDttdd��nttdd��t	�
d�dS)	Nr/z%A directory containing pyproject.toml)�helpz
Checks passed�greenz
Checks failed�redr)�argparse�ArgumentParser�add_argument�
parse_argsr	r1r/�print�ansi�sys�exit)�argvZap�args�okr%r%r&�main�s�

r@zzzz)�resetZboldr4r3cCs8tjdkr,tj��r,t|t|�tdSt|�SdS)N�ntrA)�os�namer;�stdout�isatty�
ansi_codes�str)�s�attrr%r%r&r:�sr:�__main__)N)#�__doc__r5ZloggingrCZos.pathrrrZtomlrrr,r�
subprocessrr;rZtempfilerr(Zcolorlogr	Zenvbuildr
ZwrappersrZ	getLogger�__name__rr'r)r1r@rGr:r%r%r%r&�<module>s6
98"
�site-packages/pip/_vendor/pep517/__pycache__/colorlog.cpython-38.pyc000064400000005544151446177000021226 0ustar00U

��.e�@sfdZddlZddlZzddlZWnek
r8dZYnXdd�ZGdd�dej�Zejfdd�Z	dS)	zONicer log formatting with colours.

Code copied from Tornado, Apache licensed.
�NcCsVd}trRttjd�rRtj��rRzt��t�d�dkr:d}Wntk
rPYnX|S)NF�isattyZcolorsrT)�curses�hasattr�sys�stderrrZ	setuptermZtigetnum�	Exception)�color�r	�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/colorlog.py�_stderr_supports_colorsrc@s>eZdZdZejdejdejdejdiZ	ddd�Z
d	d
�ZdS)�LogFormatterz&Log formatter with colour support
    ���TNcCs�tjj||d�i|_|r�t�r�t�d�p6t�d�p6d}dtjkrNdkr\nn
t	|d�}|j
��D] \}}t	t�||�d�|j|<qft	t�d�d�|_
t��}|��d	|_t��nd|_
d
|_dS)aO
        :arg bool color: Enables color support.
        :arg string fmt: Log message format.
        It will be applied to the attributes dict of log records. The
        text between ``%(color)s`` and ``%(end_color)s`` will be colored
        depending on the level if color support is on.
        :arg dict colors: color mappings from logging level to terminal color
        code
        :arg string datefmt: Datetime format.
        Used for formatting ``(asctime)`` placeholder in ``prefix_fmt``.
        .. versionchanged:: 3.2
        Added ``fmt`` and ``datefmt`` arguments.
        )�datefmtZsetafZsetf�)rr)rr
r�asciiZsgr0r�FN)�logging�	Formatter�__init__�_colorsrrZtigetstrr�version_info�str�DEFAULT_COLORS�itemsZtparm�_normalZinitscrZgetmaxyx�	termwidthZendwin)�selfrrZfg_color�levelno�codeZscrr	r	r
r2s*

��

�
zLogFormatter.__init__cCs�t|j�}dj|jd|jd�}|t|�|jkrJd|j|t|�}nd}|j|jkrn|j|j}|j}nd}}|j||||S)Nz{initial}-{name}r)�initial�name� z  r)	�len�message�formatZ	levelnamer"rrrr)r�recordZmlenZ
right_textZspaceZstart_colorZ	end_colorr	r	r
�
formatMessage]s
�zLogFormatter.formatMessage)TN)�__name__�
__module__�__qualname__�__doc__r�INFOZWARNINGZERRORZCRITICALrrr(r	r	r	r
r(s�
+rcCs0t��}|�t��tj�|�tj�|�dS)N)rZ
StreamHandlerZsetFormatterr�rootZ
addHandlerZsetLevel)�levelZhandlerr	r	r
�enable_colourful_outputosr0)
r,rrr�ImportErrorrrrr-r0r	r	r	r
�<module>s
Gsite-packages/pip/_vendor/pep517/__pycache__/__init__.cpython-38.pyc000064400000000366151446177000021142 0ustar00U

��.eT�@sdZdZdS)z6Wrappers to build Python packages using PEP 517 hooks
z0.7.0N)�__doc__�__version__�rr�?/usr/lib/python3.8/site-packages/pip/_vendor/pep517/__init__.py�<module>ssite-packages/pip/_vendor/pep517/__pycache__/meta.cpython-38.pyc000064400000005406151446177000020331 0ustar00U

��.e�	�@sBdZddlZddlZddlZddlZddlZzddlmZWne	k
rXddl
ZYnXzddlmZWn e	k
r�ddl
mZYnXddlmZddlmZmZddlmZmZmZddlmZmZmZe�e�Zd	d
�Zddd
�Zefdd�Zdd�Z e�!�Z"e"j#ddd�e"j#dddd�dd�Z$edk�r>e$�dS)z2Build metadata for a project using PEP 517 hooks.
�N)�Path�)�BuildEnvironment)�Pep517HookCaller�quiet_subprocess_runner)�tempdir�mkdir_p�dir_to_zipfile)�validate_system�load_system�
compat_systemc
Cs�|�i�}t�d|�|�|�t�d�t��J}t�d|�|�|i�}tj�||�}t	�
|tj�|tj�|���W5QRXdS)NzGot build requires: %sz$Installed dynamic build dependencieszTrying to build metadata in %s)Zget_requires_for_build_wheel�log�info�pip_installrZ prepare_metadata_for_build_wheel�os�path�join�shutilZmove�basename)�hooks�env�destZreqsZtd�filename�source�r�;/usr/lib/python3.8/site-packages/pip/_vendor/pep517/meta.py�
_prep_metas


r�.c
Cs�|p
t|�}tj�||pd�}t|�t|�t||d|�d��}|�t	��2t
�� }|�|d�t|||�W5QRXW5QRXdS)NZdistz
build-backendzbackend-pathZrequires)
rrrrrr
r�getZsubprocess_runnerrrrr)�
source_dirr�systemrrrrr�build)s�r!c
Cs0t�� }||d�t|�W5QR�SQRXdS)N)r)rr	)�builder�out_dirrrr�build_as_zip8s
r$cCs:tj�|�}t|�}tjt||d�}tt|��}t	�
|�S)z�
    Given a source directory (root) of a package,
    return an importlib.metadata.Distribution object
    with metadata build from that package.
    )rr )rr�
expanduserr�	functools�partialr!rr$�imp_metaZPathDistribution)�rootr r"rrrr�load>s
r*rz%A directory containing pyproject.toml)�helpz	--out-dirz-oz>Destination in which to save the builds relative to source dircCst��}t|j|j�dS)N)�parser�
parse_argsr!rr#)�argsrrr�mainVsr/�__main__)rNN)%�__doc__�argparseZloggingrrr&�importlib.metadataZmetadatar(�ImportErrorZimportlib_metadataZzipfilerZzippZenvbuildrZwrappersrrZdirtoolsrrr	r!r
rrZ	getLogger�__name__r
rr$r*�ArgumentParserr,�add_argumentr/rrrr�<module>sF


��
site-packages/pip/_vendor/pep517/meta.py000064400000004637151446177000014050 0ustar00"""Build metadata for a project using PEP 517 hooks.
"""
import argparse
import logging
import os
import shutil
import functools

try:
    import importlib.metadata as imp_meta
except ImportError:
    import importlib_metadata as imp_meta

try:
    from zipfile import Path
except ImportError:
    from zipp import Path

from .envbuild import BuildEnvironment
from .wrappers import Pep517HookCaller, quiet_subprocess_runner
from .dirtools import tempdir, mkdir_p, dir_to_zipfile
from .build import validate_system, load_system, compat_system

log = logging.getLogger(__name__)


def _prep_meta(hooks, env, dest):
    reqs = hooks.get_requires_for_build_wheel({})
    log.info('Got build requires: %s', reqs)

    env.pip_install(reqs)
    log.info('Installed dynamic build dependencies')

    with tempdir() as td:
        log.info('Trying to build metadata in %s', td)
        filename = hooks.prepare_metadata_for_build_wheel(td, {})
        source = os.path.join(td, filename)
        shutil.move(source, os.path.join(dest, os.path.basename(filename)))


def build(source_dir='.', dest=None, system=None):
    system = system or load_system(source_dir)
    dest = os.path.join(source_dir, dest or 'dist')
    mkdir_p(dest)
    validate_system(system)
    hooks = Pep517HookCaller(
        source_dir, system['build-backend'], system.get('backend-path')
    )

    with hooks.subprocess_runner(quiet_subprocess_runner):
        with BuildEnvironment() as env:
            env.pip_install(system['requires'])
            _prep_meta(hooks, env, dest)


def build_as_zip(builder=build):
    with tempdir() as out_dir:
        builder(dest=out_dir)
        return dir_to_zipfile(out_dir)


def load(root):
    """
    Given a source directory (root) of a package,
    return an importlib.metadata.Distribution object
    with metadata build from that package.
    """
    root = os.path.expanduser(root)
    system = compat_system(root)
    builder = functools.partial(build, source_dir=root, system=system)
    path = Path(build_as_zip(builder))
    return imp_meta.PathDistribution(path)


parser = argparse.ArgumentParser()
parser.add_argument(
    'source_dir',
    help="A directory containing pyproject.toml",
)
parser.add_argument(
    '--out-dir', '-o',
    help="Destination in which to save the builds relative to source dir",
)


def main():
    args = parser.parse_args()
    build(args.source_dir, args.out_dir)


if __name__ == '__main__':
    main()
site-packages/pip/_vendor/pep517/__init__.py000064400000000124151446177000014644 0ustar00"""Wrappers to build Python packages using PEP 517 hooks
"""

__version__ = '0.7.0'
site-packages/pip/_vendor/pep517/_in_process.py000064400000017160151446177000015420 0ustar00"""This is invoked in a subprocess to call the build backend hooks.

It expects:
- Command line args: hook_name, control_dir
- Environment variables:
      PEP517_BUILD_BACKEND=entry.point:spec
      PEP517_BACKEND_PATH=paths (separated with os.pathsep)
- control_dir/input.json:
  - {"kwargs": {...}}

Results:
- control_dir/output.json
  - {"return_val": ...}
"""
from glob import glob
from importlib import import_module
import os
import os.path
from os.path import join as pjoin
import re
import shutil
import sys
import traceback

# This is run as a script, not a module, so it can't do a relative import
import compat


class BackendUnavailable(Exception):
    """Raised if we cannot import the backend"""
    def __init__(self, traceback):
        self.traceback = traceback


class BackendInvalid(Exception):
    """Raised if the backend is invalid"""
    def __init__(self, message):
        self.message = message


class HookMissing(Exception):
    """Raised if a hook is missing and we are not executing the fallback"""


def contained_in(filename, directory):
    """Test if a file is located within the given directory."""
    filename = os.path.normcase(os.path.abspath(filename))
    directory = os.path.normcase(os.path.abspath(directory))
    return os.path.commonprefix([filename, directory]) == directory


def _build_backend():
    """Find and load the build backend"""
    # Add in-tree backend directories to the front of sys.path.
    backend_path = os.environ.get('PEP517_BACKEND_PATH')
    if backend_path:
        extra_pathitems = backend_path.split(os.pathsep)
        sys.path[:0] = extra_pathitems

    ep = os.environ['PEP517_BUILD_BACKEND']
    mod_path, _, obj_path = ep.partition(':')
    try:
        obj = import_module(mod_path)
    except ImportError:
        raise BackendUnavailable(traceback.format_exc())

    if backend_path:
        if not any(
            contained_in(obj.__file__, path)
            for path in extra_pathitems
        ):
            raise BackendInvalid("Backend was not loaded from backend-path")

    if obj_path:
        for path_part in obj_path.split('.'):
            obj = getattr(obj, path_part)
    return obj


def get_requires_for_build_wheel(config_settings):
    """Invoke the optional get_requires_for_build_wheel hook

    Returns [] if the hook is not defined.
    """
    backend = _build_backend()
    try:
        hook = backend.get_requires_for_build_wheel
    except AttributeError:
        return []
    else:
        return hook(config_settings)


def prepare_metadata_for_build_wheel(
        metadata_directory, config_settings, _allow_fallback):
    """Invoke optional prepare_metadata_for_build_wheel

    Implements a fallback by building a wheel if the hook isn't defined,
    unless _allow_fallback is False in which case HookMissing is raised.
    """
    backend = _build_backend()
    try:
        hook = backend.prepare_metadata_for_build_wheel
    except AttributeError:
        if not _allow_fallback:
            raise HookMissing()
        return _get_wheel_metadata_from_wheel(backend, metadata_directory,
                                              config_settings)
    else:
        return hook(metadata_directory, config_settings)


WHEEL_BUILT_MARKER = 'PEP517_ALREADY_BUILT_WHEEL'


def _dist_info_files(whl_zip):
    """Identify the .dist-info folder inside a wheel ZipFile."""
    res = []
    for path in whl_zip.namelist():
        m = re.match(r'[^/\\]+-[^/\\]+\.dist-info/', path)
        if m:
            res.append(path)
    if res:
        return res
    raise Exception("No .dist-info folder found in wheel")


def _get_wheel_metadata_from_wheel(
        backend, metadata_directory, config_settings):
    """Build a wheel and extract the metadata from it.

    Fallback for when the build backend does not
    define the 'get_wheel_metadata' hook.
    """
    from zipfile import ZipFile
    whl_basename = backend.build_wheel(metadata_directory, config_settings)
    with open(os.path.join(metadata_directory, WHEEL_BUILT_MARKER), 'wb'):
        pass  # Touch marker file

    whl_file = os.path.join(metadata_directory, whl_basename)
    with ZipFile(whl_file) as zipf:
        dist_info = _dist_info_files(zipf)
        zipf.extractall(path=metadata_directory, members=dist_info)
    return dist_info[0].split('/')[0]


def _find_already_built_wheel(metadata_directory):
    """Check for a wheel already built during the get_wheel_metadata hook.
    """
    if not metadata_directory:
        return None
    metadata_parent = os.path.dirname(metadata_directory)
    if not os.path.isfile(pjoin(metadata_parent, WHEEL_BUILT_MARKER)):
        return None

    whl_files = glob(os.path.join(metadata_parent, '*.whl'))
    if not whl_files:
        print('Found wheel built marker, but no .whl files')
        return None
    if len(whl_files) > 1:
        print('Found multiple .whl files; unspecified behaviour. '
              'Will call build_wheel.')
        return None

    # Exactly one .whl file
    return whl_files[0]


def build_wheel(wheel_directory, config_settings, metadata_directory=None):
    """Invoke the mandatory build_wheel hook.

    If a wheel was already built in the
    prepare_metadata_for_build_wheel fallback, this
    will copy it rather than rebuilding the wheel.
    """
    prebuilt_whl = _find_already_built_wheel(metadata_directory)
    if prebuilt_whl:
        shutil.copy2(prebuilt_whl, wheel_directory)
        return os.path.basename(prebuilt_whl)

    return _build_backend().build_wheel(wheel_directory, config_settings,
                                        metadata_directory)


def get_requires_for_build_sdist(config_settings):
    """Invoke the optional get_requires_for_build_wheel hook

    Returns [] if the hook is not defined.
    """
    backend = _build_backend()
    try:
        hook = backend.get_requires_for_build_sdist
    except AttributeError:
        return []
    else:
        return hook(config_settings)


class _DummyException(Exception):
    """Nothing should ever raise this exception"""


class GotUnsupportedOperation(Exception):
    """For internal use when backend raises UnsupportedOperation"""
    def __init__(self, traceback):
        self.traceback = traceback


def build_sdist(sdist_directory, config_settings):
    """Invoke the mandatory build_sdist hook."""
    backend = _build_backend()
    try:
        return backend.build_sdist(sdist_directory, config_settings)
    except getattr(backend, 'UnsupportedOperation', _DummyException):
        raise GotUnsupportedOperation(traceback.format_exc())


HOOK_NAMES = {
    'get_requires_for_build_wheel',
    'prepare_metadata_for_build_wheel',
    'build_wheel',
    'get_requires_for_build_sdist',
    'build_sdist',
}


def main():
    if len(sys.argv) < 3:
        sys.exit("Needs args: hook_name, control_dir")
    hook_name = sys.argv[1]
    control_dir = sys.argv[2]
    if hook_name not in HOOK_NAMES:
        sys.exit("Unknown hook: %s" % hook_name)
    hook = globals()[hook_name]

    hook_input = compat.read_json(pjoin(control_dir, 'input.json'))

    json_out = {'unsupported': False, 'return_val': None}
    try:
        json_out['return_val'] = hook(**hook_input['kwargs'])
    except BackendUnavailable as e:
        json_out['no_backend'] = True
        json_out['traceback'] = e.traceback
    except BackendInvalid as e:
        json_out['backend_invalid'] = True
        json_out['backend_error'] = e.message
    except GotUnsupportedOperation as e:
        json_out['unsupported'] = True
        json_out['traceback'] = e.traceback
    except HookMissing:
        json_out['hook_missing'] = True

    compat.write_json(json_out, pjoin(control_dir, 'output.json'), indent=2)


if __name__ == '__main__':
    main()
site-packages/pip/_vendor/pep517/colorlog.py000064400000010002151446177000014721 0ustar00"""Nicer log formatting with colours.

Code copied from Tornado, Apache licensed.
"""
# Copyright 2012 Facebook
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.

import logging
import sys

try:
    import curses
except ImportError:
    curses = None


def _stderr_supports_color():
    color = False
    if curses and hasattr(sys.stderr, 'isatty') and sys.stderr.isatty():
        try:
            curses.setupterm()
            if curses.tigetnum("colors") > 0:
                color = True
        except Exception:
            pass
    return color


class LogFormatter(logging.Formatter):
    """Log formatter with colour support
    """
    DEFAULT_COLORS = {
        logging.INFO: 2,  # Green
        logging.WARNING: 3,  # Yellow
        logging.ERROR: 1,  # Red
        logging.CRITICAL: 1,
    }

    def __init__(self, color=True, datefmt=None):
        r"""
        :arg bool color: Enables color support.
        :arg string fmt: Log message format.
        It will be applied to the attributes dict of log records. The
        text between ``%(color)s`` and ``%(end_color)s`` will be colored
        depending on the level if color support is on.
        :arg dict colors: color mappings from logging level to terminal color
        code
        :arg string datefmt: Datetime format.
        Used for formatting ``(asctime)`` placeholder in ``prefix_fmt``.
        .. versionchanged:: 3.2
        Added ``fmt`` and ``datefmt`` arguments.
        """
        logging.Formatter.__init__(self, datefmt=datefmt)
        self._colors = {}
        if color and _stderr_supports_color():
            # The curses module has some str/bytes confusion in
            # python3. Until version 3.2.3, most methods return
            # bytes, but only accept strings. In addition, we want to
            # output these strings with the logging module, which
            # works with unicode strings. The explicit calls to
            # unicode() below are harmless in python2 but will do the
            # right conversion in python 3.
            fg_color = (curses.tigetstr("setaf") or
                        curses.tigetstr("setf") or "")
            if (3, 0) < sys.version_info < (3, 2, 3):
                fg_color = str(fg_color, "ascii")

            for levelno, code in self.DEFAULT_COLORS.items():
                self._colors[levelno] = str(
                    curses.tparm(fg_color, code), "ascii")
            self._normal = str(curses.tigetstr("sgr0"), "ascii")

            scr = curses.initscr()
            self.termwidth = scr.getmaxyx()[1]
            curses.endwin()
        else:
            self._normal = ''
            # Default width is usually 80, but too wide is
            # worse than too narrow
            self.termwidth = 70

    def formatMessage(self, record):
        mlen = len(record.message)
        right_text = '{initial}-{name}'.format(initial=record.levelname[0],
                                               name=record.name)
        if mlen + len(right_text) < self.termwidth:
            space = ' ' * (self.termwidth - (mlen + len(right_text)))
        else:
            space = '  '

        if record.levelno in self._colors:
            start_color = self._colors[record.levelno]
            end_color = self._normal
        else:
            start_color = end_color = ''

        return record.message + space + start_color + right_text + end_color


def enable_colourful_output(level=logging.INFO):
    handler = logging.StreamHandler()
    handler.setFormatter(LogFormatter())
    logging.root.addHandler(handler)
    logging.root.setLevel(level)
site-packages/pip/_vendor/pep517/dirtools.py000064400000002151151446177000014746 0ustar00import os
import io
import contextlib
import tempfile
import shutil
import errno
import zipfile


@contextlib.contextmanager
def tempdir():
    """Create a temporary directory in a context manager."""
    td = tempfile.mkdtemp()
    try:
        yield td
    finally:
        shutil.rmtree(td)


def mkdir_p(*args, **kwargs):
    """Like `mkdir`, but does not raise an exception if the
    directory already exists.
    """
    try:
        return os.mkdir(*args, **kwargs)
    except OSError as exc:
        if exc.errno != errno.EEXIST:
            raise


def dir_to_zipfile(root):
    """Construct an in-memory zip file for a directory."""
    buffer = io.BytesIO()
    zip_file = zipfile.ZipFile(buffer, 'w')
    for root, dirs, files in os.walk(root):
        for path in dirs:
            fs_path = os.path.join(root, path)
            rel_path = os.path.relpath(fs_path, root)
            zip_file.writestr(rel_path + '/', '')
        for path in files:
            fs_path = os.path.join(root, path)
            rel_path = os.path.relpath(fs_path, root)
            zip_file.write(fs_path, rel_path)
    return zip_file
site-packages/pip/_vendor/pep517/check.py000064400000013475151446177000014177 0ustar00"""Check a project and backend by attempting to build using PEP 517 hooks.
"""
import argparse
import logging
import os
from os.path import isfile, join as pjoin
from toml import TomlDecodeError, load as toml_load
import shutil
from subprocess import CalledProcessError
import sys
import tarfile
from tempfile import mkdtemp
import zipfile

from .colorlog import enable_colourful_output
from .envbuild import BuildEnvironment
from .wrappers import Pep517HookCaller

log = logging.getLogger(__name__)


def check_build_sdist(hooks, build_sys_requires):
    with BuildEnvironment() as env:
        try:
            env.pip_install(build_sys_requires)
            log.info('Installed static build dependencies')
        except CalledProcessError:
            log.error('Failed to install static build dependencies')
            return False

        try:
            reqs = hooks.get_requires_for_build_sdist({})
            log.info('Got build requires: %s', reqs)
        except Exception:
            log.error('Failure in get_requires_for_build_sdist', exc_info=True)
            return False

        try:
            env.pip_install(reqs)
            log.info('Installed dynamic build dependencies')
        except CalledProcessError:
            log.error('Failed to install dynamic build dependencies')
            return False

        td = mkdtemp()
        log.info('Trying to build sdist in %s', td)
        try:
            try:
                filename = hooks.build_sdist(td, {})
                log.info('build_sdist returned %r', filename)
            except Exception:
                log.info('Failure in build_sdist', exc_info=True)
                return False

            if not filename.endswith('.tar.gz'):
                log.error(
                    "Filename %s doesn't have .tar.gz extension", filename)
                return False

            path = pjoin(td, filename)
            if isfile(path):
                log.info("Output file %s exists", path)
            else:
                log.error("Output file %s does not exist", path)
                return False

            if tarfile.is_tarfile(path):
                log.info("Output file is a tar file")
            else:
                log.error("Output file is not a tar file")
                return False

        finally:
            shutil.rmtree(td)

        return True


def check_build_wheel(hooks, build_sys_requires):
    with BuildEnvironment() as env:
        try:
            env.pip_install(build_sys_requires)
            log.info('Installed static build dependencies')
        except CalledProcessError:
            log.error('Failed to install static build dependencies')
            return False

        try:
            reqs = hooks.get_requires_for_build_wheel({})
            log.info('Got build requires: %s', reqs)
        except Exception:
            log.error('Failure in get_requires_for_build_sdist', exc_info=True)
            return False

        try:
            env.pip_install(reqs)
            log.info('Installed dynamic build dependencies')
        except CalledProcessError:
            log.error('Failed to install dynamic build dependencies')
            return False

        td = mkdtemp()
        log.info('Trying to build wheel in %s', td)
        try:
            try:
                filename = hooks.build_wheel(td, {})
                log.info('build_wheel returned %r', filename)
            except Exception:
                log.info('Failure in build_wheel', exc_info=True)
                return False

            if not filename.endswith('.whl'):
                log.error("Filename %s doesn't have .whl extension", filename)
                return False

            path = pjoin(td, filename)
            if isfile(path):
                log.info("Output file %s exists", path)
            else:
                log.error("Output file %s does not exist", path)
                return False

            if zipfile.is_zipfile(path):
                log.info("Output file is a zip file")
            else:
                log.error("Output file is not a zip file")
                return False

        finally:
            shutil.rmtree(td)

        return True


def check(source_dir):
    pyproject = pjoin(source_dir, 'pyproject.toml')
    if isfile(pyproject):
        log.info('Found pyproject.toml')
    else:
        log.error('Missing pyproject.toml')
        return False

    try:
        with open(pyproject) as f:
            pyproject_data = toml_load(f)
        # Ensure the mandatory data can be loaded
        buildsys = pyproject_data['build-system']
        requires = buildsys['requires']
        backend = buildsys['build-backend']
        backend_path = buildsys.get('backend-path')
        log.info('Loaded pyproject.toml')
    except (TomlDecodeError, KeyError):
        log.error("Invalid pyproject.toml", exc_info=True)
        return False

    hooks = Pep517HookCaller(source_dir, backend, backend_path)

    sdist_ok = check_build_sdist(hooks, requires)
    wheel_ok = check_build_wheel(hooks, requires)

    if not sdist_ok:
        log.warning('Sdist checks failed; scroll up to see')
    if not wheel_ok:
        log.warning('Wheel checks failed')

    return sdist_ok


def main(argv=None):
    ap = argparse.ArgumentParser()
    ap.add_argument(
        'source_dir',
        help="A directory containing pyproject.toml")
    args = ap.parse_args(argv)

    enable_colourful_output()

    ok = check(args.source_dir)

    if ok:
        print(ansi('Checks passed', 'green'))
    else:
        print(ansi('Checks failed', 'red'))
        sys.exit(1)


ansi_codes = {
    'reset': '\x1b[0m',
    'bold': '\x1b[1m',
    'red': '\x1b[31m',
    'green': '\x1b[32m',
}


def ansi(s, attr):
    if os.name != 'nt' and sys.stdout.isatty():
        return ansi_codes[attr] + str(s) + ansi_codes['reset']
    else:
        return str(s)


if __name__ == '__main__':
    main()
site-packages/pip/_vendor/pep517/envbuild.py000064400000013610151446177000014721 0ustar00"""Build wheels/sdists by installing build deps to a temporary environment.
"""

import os
import logging
import toml
import shutil
from subprocess import check_call
import sys
from sysconfig import get_paths
from tempfile import mkdtemp

from .wrappers import Pep517HookCaller, LoggerWrapper

log = logging.getLogger(__name__)


def _load_pyproject(source_dir):
    with open(os.path.join(source_dir, 'pyproject.toml')) as f:
        pyproject_data = toml.load(f)
    buildsys = pyproject_data['build-system']
    return (
        buildsys['requires'],
        buildsys['build-backend'],
        buildsys.get('backend-path'),
    )


class BuildEnvironment(object):
    """Context manager to install build deps in a simple temporary environment

    Based on code I wrote for pip, which is MIT licensed.
    """
    # Copyright (c) 2008-2016 The pip developers (see AUTHORS.txt file)
    #
    # Permission is hereby granted, free of charge, to any person obtaining
    # a copy of this software and associated documentation files (the
    # "Software"), to deal in the Software without restriction, including
    # without limitation the rights to use, copy, modify, merge, publish,
    # distribute, sublicense, and/or sell copies of the Software, and to
    # permit persons to whom the Software is furnished to do so, subject to
    # the following conditions:
    #
    # The above copyright notice and this permission notice shall be
    # included in all copies or substantial portions of the Software.
    #
    # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
    # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
    # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
    # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
    # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
    # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
    # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    path = None

    def __init__(self, cleanup=True):
        self._cleanup = cleanup

    def __enter__(self):
        self.path = mkdtemp(prefix='pep517-build-env-')
        log.info('Temporary build environment: %s', self.path)

        self.save_path = os.environ.get('PATH', None)
        self.save_pythonpath = os.environ.get('PYTHONPATH', None)

        install_scheme = 'nt' if (os.name == 'nt') else 'posix_prefix'
        install_dirs = get_paths(install_scheme, vars={
            'base': self.path,
            'platbase': self.path,
        })

        scripts = install_dirs['scripts']
        if self.save_path:
            os.environ['PATH'] = scripts + os.pathsep + self.save_path
        else:
            os.environ['PATH'] = scripts + os.pathsep + os.defpath

        if install_dirs['purelib'] == install_dirs['platlib']:
            lib_dirs = install_dirs['purelib']
        else:
            lib_dirs = install_dirs['purelib'] + os.pathsep + \
                install_dirs['platlib']
        if self.save_pythonpath:
            os.environ['PYTHONPATH'] = lib_dirs + os.pathsep + \
                self.save_pythonpath
        else:
            os.environ['PYTHONPATH'] = lib_dirs

        return self

    def pip_install(self, reqs):
        """Install dependencies into this env by calling pip in a subprocess"""
        if not reqs:
            return
        log.info('Calling pip to install %s', reqs)
        cmd = [
            sys.executable, '-m', 'pip', 'install', '--ignore-installed',
            '--prefix', self.path] + list(reqs)
        check_call(
            cmd,
            stdout=LoggerWrapper(log, logging.INFO),
            stderr=LoggerWrapper(log, logging.ERROR),
        )

    def __exit__(self, exc_type, exc_val, exc_tb):
        needs_cleanup = (
            self._cleanup and
            self.path is not None and
            os.path.isdir(self.path)
        )
        if needs_cleanup:
            shutil.rmtree(self.path)

        if self.save_path is None:
            os.environ.pop('PATH', None)
        else:
            os.environ['PATH'] = self.save_path

        if self.save_pythonpath is None:
            os.environ.pop('PYTHONPATH', None)
        else:
            os.environ['PYTHONPATH'] = self.save_pythonpath


def build_wheel(source_dir, wheel_dir, config_settings=None):
    """Build a wheel from a source directory using PEP 517 hooks.

    :param str source_dir: Source directory containing pyproject.toml
    :param str wheel_dir: Target directory to create wheel in
    :param dict config_settings: Options to pass to build backend

    This is a blocking function which will run pip in a subprocess to install
    build requirements.
    """
    if config_settings is None:
        config_settings = {}
    requires, backend, backend_path = _load_pyproject(source_dir)
    hooks = Pep517HookCaller(source_dir, backend, backend_path)

    with BuildEnvironment() as env:
        env.pip_install(requires)
        reqs = hooks.get_requires_for_build_wheel(config_settings)
        env.pip_install(reqs)
        return hooks.build_wheel(wheel_dir, config_settings)


def build_sdist(source_dir, sdist_dir, config_settings=None):
    """Build an sdist from a source directory using PEP 517 hooks.

    :param str source_dir: Source directory containing pyproject.toml
    :param str sdist_dir: Target directory to place sdist in
    :param dict config_settings: Options to pass to build backend

    This is a blocking function which will run pip in a subprocess to install
    build requirements.
    """
    if config_settings is None:
        config_settings = {}
    requires, backend, backend_path = _load_pyproject(source_dir)
    hooks = Pep517HookCaller(source_dir, backend, backend_path)

    with BuildEnvironment() as env:
        env.pip_install(requires)
        reqs = hooks.get_requires_for_build_sdist(config_settings)
        env.pip_install(reqs)
        return hooks.build_sdist(sdist_dir, config_settings)
site-packages/pip/_vendor/urllib3/packages/six.py000064400000077430151446177000016037 0ustar00# Copyright (c) 2010-2019 Benjamin Peterson
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.

"""Utilities for writing code that runs on Python 2 and 3"""

from __future__ import absolute_import

import functools
import itertools
import operator
import sys
import types

__author__ = "Benjamin Peterson <benjamin@python.org>"
__version__ = "1.12.0"


# Useful for very coarse version differentiation.
PY2 = sys.version_info[0] == 2
PY3 = sys.version_info[0] == 3
PY34 = sys.version_info[0:2] >= (3, 4)

if PY3:
    string_types = (str,)
    integer_types = (int,)
    class_types = (type,)
    text_type = str
    binary_type = bytes

    MAXSIZE = sys.maxsize
else:
    string_types = (basestring,)
    integer_types = (int, long)
    class_types = (type, types.ClassType)
    text_type = unicode
    binary_type = str

    if sys.platform.startswith("java"):
        # Jython always uses 32 bits.
        MAXSIZE = int((1 << 31) - 1)
    else:
        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
        class X(object):
            def __len__(self):
                return 1 << 31

        try:
            len(X())
        except OverflowError:
            # 32-bit
            MAXSIZE = int((1 << 31) - 1)
        else:
            # 64-bit
            MAXSIZE = int((1 << 63) - 1)
        del X


def _add_doc(func, doc):
    """Add documentation to a function."""
    func.__doc__ = doc


def _import_module(name):
    """Import module, returning the module after the last dot."""
    __import__(name)
    return sys.modules[name]


class _LazyDescr(object):
    def __init__(self, name):
        self.name = name

    def __get__(self, obj, tp):
        result = self._resolve()
        setattr(obj, self.name, result)  # Invokes __set__.
        try:
            # This is a bit ugly, but it avoids running this again by
            # removing this descriptor.
            delattr(obj.__class__, self.name)
        except AttributeError:
            pass
        return result


class MovedModule(_LazyDescr):
    def __init__(self, name, old, new=None):
        super(MovedModule, self).__init__(name)
        if PY3:
            if new is None:
                new = name
            self.mod = new
        else:
            self.mod = old

    def _resolve(self):
        return _import_module(self.mod)

    def __getattr__(self, attr):
        _module = self._resolve()
        value = getattr(_module, attr)
        setattr(self, attr, value)
        return value


class _LazyModule(types.ModuleType):
    def __init__(self, name):
        super(_LazyModule, self).__init__(name)
        self.__doc__ = self.__class__.__doc__

    def __dir__(self):
        attrs = ["__doc__", "__name__"]
        attrs += [attr.name for attr in self._moved_attributes]
        return attrs

    # Subclasses should override this
    _moved_attributes = []


class MovedAttribute(_LazyDescr):
    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
        super(MovedAttribute, self).__init__(name)
        if PY3:
            if new_mod is None:
                new_mod = name
            self.mod = new_mod
            if new_attr is None:
                if old_attr is None:
                    new_attr = name
                else:
                    new_attr = old_attr
            self.attr = new_attr
        else:
            self.mod = old_mod
            if old_attr is None:
                old_attr = name
            self.attr = old_attr

    def _resolve(self):
        module = _import_module(self.mod)
        return getattr(module, self.attr)


class _SixMetaPathImporter(object):

    """
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    """

    def __init__(self, six_module_name):
        self.name = six_module_name
        self.known_modules = {}

    def _add_module(self, mod, *fullnames):
        for fullname in fullnames:
            self.known_modules[self.name + "." + fullname] = mod

    def _get_module(self, fullname):
        return self.known_modules[self.name + "." + fullname]

    def find_module(self, fullname, path=None):
        if fullname in self.known_modules:
            return self
        return None

    def __get_module(self, fullname):
        try:
            return self.known_modules[fullname]
        except KeyError:
            raise ImportError("This loader does not know module " + fullname)

    def load_module(self, fullname):
        try:
            # in case of a reload
            return sys.modules[fullname]
        except KeyError:
            pass
        mod = self.__get_module(fullname)
        if isinstance(mod, MovedModule):
            mod = mod._resolve()
        else:
            mod.__loader__ = self
        sys.modules[fullname] = mod
        return mod

    def is_package(self, fullname):
        """
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        """
        return hasattr(self.__get_module(fullname), "__path__")

    def get_code(self, fullname):
        """Return None

        Required, if is_package is implemented"""
        self.__get_module(fullname)  # eventually raises ImportError
        return None

    get_source = get_code  # same as get_code


_importer = _SixMetaPathImporter(__name__)


class _MovedItems(_LazyModule):

    """Lazy loading of moved objects"""

    __path__ = []  # mark as package


_moved_attributes = [
    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
    MovedAttribute(
        "filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"
    ),
    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
    MovedAttribute("intern", "__builtin__", "sys"),
    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
    MovedAttribute("getoutput", "commands", "subprocess"),
    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute(
        "reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"
    ),
    MovedAttribute("reduce", "__builtin__", "functools"),
    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
    MovedAttribute("StringIO", "StringIO", "io"),
    MovedAttribute("UserDict", "UserDict", "collections"),
    MovedAttribute("UserList", "UserList", "collections"),
    MovedAttribute("UserString", "UserString", "collections"),
    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
    MovedAttribute(
        "zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"
    ),
    MovedModule("builtins", "__builtin__"),
    MovedModule("configparser", "ConfigParser"),
    MovedModule("copyreg", "copy_reg"),
    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
    MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"),
    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
    MovedModule("http_cookies", "Cookie", "http.cookies"),
    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
    MovedModule("html_parser", "HTMLParser", "html.parser"),
    MovedModule("http_client", "httplib", "http.client"),
    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
    MovedModule("email_mime_image", "email.MIMEImage", "email.mime.image"),
    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
    MovedModule(
        "email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"
    ),
    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
    MovedModule("cPickle", "cPickle", "pickle"),
    MovedModule("queue", "Queue"),
    MovedModule("reprlib", "repr"),
    MovedModule("socketserver", "SocketServer"),
    MovedModule("_thread", "thread", "_thread"),
    MovedModule("tkinter", "Tkinter"),
    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
    MovedModule("tkinter_colorchooser", "tkColorChooser", "tkinter.colorchooser"),
    MovedModule("tkinter_commondialog", "tkCommonDialog", "tkinter.commondialog"),
    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog", "tkinter.simpledialog"),
    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
]
# Add windows specific modules.
if sys.platform == "win32":
    _moved_attributes += [MovedModule("winreg", "_winreg")]

for attr in _moved_attributes:
    setattr(_MovedItems, attr.name, attr)
    if isinstance(attr, MovedModule):
        _importer._add_module(attr, "moves." + attr.name)
del attr

_MovedItems._moved_attributes = _moved_attributes

moves = _MovedItems(__name__ + ".moves")
_importer._add_module(moves, "moves")


class Module_six_moves_urllib_parse(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_parse"""


_urllib_parse_moved_attributes = [
    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
    MovedAttribute("quote", "urllib", "urllib.parse"),
    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
    MovedAttribute("unquote", "urllib", "urllib.parse"),
    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
    MovedAttribute(
        "unquote_to_bytes", "urllib", "urllib.parse", "unquote", "unquote_to_bytes"
    ),
    MovedAttribute("urlencode", "urllib", "urllib.parse"),
    MovedAttribute("splitquery", "urllib", "urllib.parse"),
    MovedAttribute("splittag", "urllib", "urllib.parse"),
    MovedAttribute("splituser", "urllib", "urllib.parse"),
    MovedAttribute("splitvalue", "urllib", "urllib.parse"),
    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
]
for attr in _urllib_parse_moved_attributes:
    setattr(Module_six_moves_urllib_parse, attr.name, attr)
del attr

Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes

_importer._add_module(
    Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
    "moves.urllib_parse",
    "moves.urllib.parse",
)


class Module_six_moves_urllib_error(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_error"""


_urllib_error_moved_attributes = [
    MovedAttribute("URLError", "urllib2", "urllib.error"),
    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
]
for attr in _urllib_error_moved_attributes:
    setattr(Module_six_moves_urllib_error, attr.name, attr)
del attr

Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes

_importer._add_module(
    Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
    "moves.urllib_error",
    "moves.urllib.error",
)


class Module_six_moves_urllib_request(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_request"""


_urllib_request_moved_attributes = [
    MovedAttribute("urlopen", "urllib2", "urllib.request"),
    MovedAttribute("install_opener", "urllib2", "urllib.request"),
    MovedAttribute("build_opener", "urllib2", "urllib.request"),
    MovedAttribute("pathname2url", "urllib", "urllib.request"),
    MovedAttribute("url2pathname", "urllib", "urllib.request"),
    MovedAttribute("getproxies", "urllib", "urllib.request"),
    MovedAttribute("Request", "urllib2", "urllib.request"),
    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
    MovedAttribute("URLopener", "urllib", "urllib.request"),
    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
    MovedAttribute("parse_http_list", "urllib2", "urllib.request"),
    MovedAttribute("parse_keqv_list", "urllib2", "urllib.request"),
]
for attr in _urllib_request_moved_attributes:
    setattr(Module_six_moves_urllib_request, attr.name, attr)
del attr

Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes

_importer._add_module(
    Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
    "moves.urllib_request",
    "moves.urllib.request",
)


class Module_six_moves_urllib_response(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_response"""


_urllib_response_moved_attributes = [
    MovedAttribute("addbase", "urllib", "urllib.response"),
    MovedAttribute("addclosehook", "urllib", "urllib.response"),
    MovedAttribute("addinfo", "urllib", "urllib.response"),
    MovedAttribute("addinfourl", "urllib", "urllib.response"),
]
for attr in _urllib_response_moved_attributes:
    setattr(Module_six_moves_urllib_response, attr.name, attr)
del attr

Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes

_importer._add_module(
    Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
    "moves.urllib_response",
    "moves.urllib.response",
)


class Module_six_moves_urllib_robotparser(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_robotparser"""


_urllib_robotparser_moved_attributes = [
    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser")
]
for attr in _urllib_robotparser_moved_attributes:
    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
del attr

Module_six_moves_urllib_robotparser._moved_attributes = (
    _urllib_robotparser_moved_attributes
)

_importer._add_module(
    Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
    "moves.urllib_robotparser",
    "moves.urllib.robotparser",
)


class Module_six_moves_urllib(types.ModuleType):

    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""

    __path__ = []  # mark as package
    parse = _importer._get_module("moves.urllib_parse")
    error = _importer._get_module("moves.urllib_error")
    request = _importer._get_module("moves.urllib_request")
    response = _importer._get_module("moves.urllib_response")
    robotparser = _importer._get_module("moves.urllib_robotparser")

    def __dir__(self):
        return ["parse", "error", "request", "response", "robotparser"]


_importer._add_module(
    Module_six_moves_urllib(__name__ + ".moves.urllib"), "moves.urllib"
)


def add_move(move):
    """Add an item to six.moves."""
    setattr(_MovedItems, move.name, move)


def remove_move(name):
    """Remove item from six.moves."""
    try:
        delattr(_MovedItems, name)
    except AttributeError:
        try:
            del moves.__dict__[name]
        except KeyError:
            raise AttributeError("no such move, %r" % (name,))


if PY3:
    _meth_func = "__func__"
    _meth_self = "__self__"

    _func_closure = "__closure__"
    _func_code = "__code__"
    _func_defaults = "__defaults__"
    _func_globals = "__globals__"
else:
    _meth_func = "im_func"
    _meth_self = "im_self"

    _func_closure = "func_closure"
    _func_code = "func_code"
    _func_defaults = "func_defaults"
    _func_globals = "func_globals"


try:
    advance_iterator = next
except NameError:

    def advance_iterator(it):
        return it.next()


next = advance_iterator


try:
    callable = callable
except NameError:

    def callable(obj):
        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)


if PY3:

    def get_unbound_function(unbound):
        return unbound

    create_bound_method = types.MethodType

    def create_unbound_method(func, cls):
        return func

    Iterator = object
else:

    def get_unbound_function(unbound):
        return unbound.im_func

    def create_bound_method(func, obj):
        return types.MethodType(func, obj, obj.__class__)

    def create_unbound_method(func, cls):
        return types.MethodType(func, None, cls)

    class Iterator(object):
        def next(self):
            return type(self).__next__(self)

    callable = callable
_add_doc(
    get_unbound_function, """Get the function out of a possibly unbound function"""
)


get_method_function = operator.attrgetter(_meth_func)
get_method_self = operator.attrgetter(_meth_self)
get_function_closure = operator.attrgetter(_func_closure)
get_function_code = operator.attrgetter(_func_code)
get_function_defaults = operator.attrgetter(_func_defaults)
get_function_globals = operator.attrgetter(_func_globals)


if PY3:

    def iterkeys(d, **kw):
        return iter(d.keys(**kw))

    def itervalues(d, **kw):
        return iter(d.values(**kw))

    def iteritems(d, **kw):
        return iter(d.items(**kw))

    def iterlists(d, **kw):
        return iter(d.lists(**kw))

    viewkeys = operator.methodcaller("keys")

    viewvalues = operator.methodcaller("values")

    viewitems = operator.methodcaller("items")
else:

    def iterkeys(d, **kw):
        return d.iterkeys(**kw)

    def itervalues(d, **kw):
        return d.itervalues(**kw)

    def iteritems(d, **kw):
        return d.iteritems(**kw)

    def iterlists(d, **kw):
        return d.iterlists(**kw)

    viewkeys = operator.methodcaller("viewkeys")

    viewvalues = operator.methodcaller("viewvalues")

    viewitems = operator.methodcaller("viewitems")

_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
_add_doc(iteritems, "Return an iterator over the (key, value) pairs of a dictionary.")
_add_doc(
    iterlists, "Return an iterator over the (key, [values]) pairs of a dictionary."
)


if PY3:

    def b(s):
        return s.encode("latin-1")

    def u(s):
        return s

    unichr = chr
    import struct

    int2byte = struct.Struct(">B").pack
    del struct
    byte2int = operator.itemgetter(0)
    indexbytes = operator.getitem
    iterbytes = iter
    import io

    StringIO = io.StringIO
    BytesIO = io.BytesIO
    del io
    _assertCountEqual = "assertCountEqual"
    if sys.version_info[1] <= 1:
        _assertRaisesRegex = "assertRaisesRegexp"
        _assertRegex = "assertRegexpMatches"
    else:
        _assertRaisesRegex = "assertRaisesRegex"
        _assertRegex = "assertRegex"
else:

    def b(s):
        return s

    # Workaround for standalone backslash

    def u(s):
        return unicode(s.replace(r"\\", r"\\\\"), "unicode_escape")

    unichr = unichr
    int2byte = chr

    def byte2int(bs):
        return ord(bs[0])

    def indexbytes(buf, i):
        return ord(buf[i])

    iterbytes = functools.partial(itertools.imap, ord)
    import StringIO

    StringIO = BytesIO = StringIO.StringIO
    _assertCountEqual = "assertItemsEqual"
    _assertRaisesRegex = "assertRaisesRegexp"
    _assertRegex = "assertRegexpMatches"
_add_doc(b, """Byte literal""")
_add_doc(u, """Text literal""")


def assertCountEqual(self, *args, **kwargs):
    return getattr(self, _assertCountEqual)(*args, **kwargs)


def assertRaisesRegex(self, *args, **kwargs):
    return getattr(self, _assertRaisesRegex)(*args, **kwargs)


def assertRegex(self, *args, **kwargs):
    return getattr(self, _assertRegex)(*args, **kwargs)


if PY3:
    exec_ = getattr(moves.builtins, "exec")

    def reraise(tp, value, tb=None):
        try:
            if value is None:
                value = tp()
            if value.__traceback__ is not tb:
                raise value.with_traceback(tb)
            raise value
        finally:
            value = None
            tb = None


else:

    def exec_(_code_, _globs_=None, _locs_=None):
        """Execute code in a namespace."""
        if _globs_ is None:
            frame = sys._getframe(1)
            _globs_ = frame.f_globals
            if _locs_ is None:
                _locs_ = frame.f_locals
            del frame
        elif _locs_ is None:
            _locs_ = _globs_
        exec("""exec _code_ in _globs_, _locs_""")

    exec_(
        """def reraise(tp, value, tb=None):
    try:
        raise tp, value, tb
    finally:
        tb = None
"""
    )


if sys.version_info[:2] == (3, 2):
    exec_(
        """def raise_from(value, from_value):
    try:
        if from_value is None:
            raise value
        raise value from from_value
    finally:
        value = None
"""
    )
elif sys.version_info[:2] > (3, 2):
    exec_(
        """def raise_from(value, from_value):
    try:
        raise value from from_value
    finally:
        value = None
"""
    )
else:

    def raise_from(value, from_value):
        raise value


print_ = getattr(moves.builtins, "print", None)
if print_ is None:

    def print_(*args, **kwargs):
        """The new-style print function for Python 2.4 and 2.5."""
        fp = kwargs.pop("file", sys.stdout)
        if fp is None:
            return

        def write(data):
            if not isinstance(data, basestring):
                data = str(data)
            # If the file has an encoding, encode unicode with it.
            if (
                isinstance(fp, file)
                and isinstance(data, unicode)
                and fp.encoding is not None
            ):
                errors = getattr(fp, "errors", None)
                if errors is None:
                    errors = "strict"
                data = data.encode(fp.encoding, errors)
            fp.write(data)

        want_unicode = False
        sep = kwargs.pop("sep", None)
        if sep is not None:
            if isinstance(sep, unicode):
                want_unicode = True
            elif not isinstance(sep, str):
                raise TypeError("sep must be None or a string")
        end = kwargs.pop("end", None)
        if end is not None:
            if isinstance(end, unicode):
                want_unicode = True
            elif not isinstance(end, str):
                raise TypeError("end must be None or a string")
        if kwargs:
            raise TypeError("invalid keyword arguments to print()")
        if not want_unicode:
            for arg in args:
                if isinstance(arg, unicode):
                    want_unicode = True
                    break
        if want_unicode:
            newline = unicode("\n")
            space = unicode(" ")
        else:
            newline = "\n"
            space = " "
        if sep is None:
            sep = space
        if end is None:
            end = newline
        for i, arg in enumerate(args):
            if i:
                write(sep)
            write(arg)
        write(end)


if sys.version_info[:2] < (3, 3):
    _print = print_

    def print_(*args, **kwargs):
        fp = kwargs.get("file", sys.stdout)
        flush = kwargs.pop("flush", False)
        _print(*args, **kwargs)
        if flush and fp is not None:
            fp.flush()


_add_doc(reraise, """Reraise an exception.""")

if sys.version_info[0:2] < (3, 4):

    def wraps(
        wrapped,
        assigned=functools.WRAPPER_ASSIGNMENTS,
        updated=functools.WRAPPER_UPDATES,
    ):
        def wrapper(f):
            f = functools.wraps(wrapped, assigned, updated)(f)
            f.__wrapped__ = wrapped
            return f

        return wrapper


else:
    wraps = functools.wraps


def with_metaclass(meta, *bases):
    """Create a base class with a metaclass."""
    # This requires a bit of explanation: the basic idea is to make a dummy
    # metaclass for one level of class instantiation that replaces itself with
    # the actual metaclass.
    class metaclass(type):
        def __new__(cls, name, this_bases, d):
            return meta(name, bases, d)

        @classmethod
        def __prepare__(cls, name, this_bases):
            return meta.__prepare__(name, bases)

    return type.__new__(metaclass, "temporary_class", (), {})


def add_metaclass(metaclass):
    """Class decorator for creating a class with a metaclass."""

    def wrapper(cls):
        orig_vars = cls.__dict__.copy()
        slots = orig_vars.get("__slots__")
        if slots is not None:
            if isinstance(slots, str):
                slots = [slots]
            for slots_var in slots:
                orig_vars.pop(slots_var)
        orig_vars.pop("__dict__", None)
        orig_vars.pop("__weakref__", None)
        if hasattr(cls, "__qualname__"):
            orig_vars["__qualname__"] = cls.__qualname__
        return metaclass(cls.__name__, cls.__bases__, orig_vars)

    return wrapper


def ensure_binary(s, encoding="utf-8", errors="strict"):
    """Coerce **s** to six.binary_type.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> encoded to `bytes`
      - `bytes` -> `bytes`
    """
    if isinstance(s, text_type):
        return s.encode(encoding, errors)
    elif isinstance(s, binary_type):
        return s
    else:
        raise TypeError("not expecting type '%s'" % type(s))


def ensure_str(s, encoding="utf-8", errors="strict"):
    """Coerce *s* to `str`.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    """
    if not isinstance(s, (text_type, binary_type)):
        raise TypeError("not expecting type '%s'" % type(s))
    if PY2 and isinstance(s, text_type):
        s = s.encode(encoding, errors)
    elif PY3 and isinstance(s, binary_type):
        s = s.decode(encoding, errors)
    return s


def ensure_text(s, encoding="utf-8", errors="strict"):
    """Coerce *s* to six.text_type.

    For Python 2:
      - `unicode` -> `unicode`
      - `str` -> `unicode`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    """
    if isinstance(s, binary_type):
        return s.decode(encoding, errors)
    elif isinstance(s, text_type):
        return s
    else:
        raise TypeError("not expecting type '%s'" % type(s))


def python_2_unicode_compatible(klass):
    """
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    """
    if PY2:
        if "__str__" not in klass.__dict__:
            raise ValueError(
                "@python_2_unicode_compatible cannot be applied "
                "to %s because it doesn't define __str__()." % klass.__name__
            )
        klass.__unicode__ = klass.__str__
        klass.__str__ = lambda self: self.__unicode__().encode("utf-8")
    return klass


# Complete the moves implementation.
# This code is at the end of this module to speed up module loading.
# Turn this module into a package.
__path__ = []  # required for PEP 302 and PEP 451
__package__ = __name__  # see PEP 366 @ReservedAssignment
if globals().get("__spec__") is not None:
    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
# Remove other six meta path importers, since they cause problems. This can
# happen if six is removed from sys.modules and then reloaded. (Setuptools does
# this for some reason.)
if sys.meta_path:
    for i, importer in enumerate(sys.meta_path):
        # Here's some real nastiness: Another "instance" of the six module might
        # be floating around. Therefore, we can't use isinstance() to check for
        # the six meta path importer, since the other six instance will have
        # inserted an importer with different class.
        if (
            type(importer).__name__ == "_SixMetaPathImporter"
            and importer.name == __name__
        ):
            del sys.meta_path[i]
            break
    del i, importer
# Finally, add the importer to the meta path import hook.
sys.meta_path.append(_importer)
site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000425151446177000024206 0ustar00U

��.el�@s ddlmZddlmZdZdS)�)�absolute_import�)�ssl_match_hostnameN)Z
__future__r�r�__all__�rr�I/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/__init__.py�<module>ssite-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-38.pyc000064400000063571151446177000022326 0ustar00U

��.e�C@s�dZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d3d4�e)d5d(d#d6d5�e)d7d(e
�rd8nd9d:�e)d;d(d<�e)d=d>d?d@�e)d d d�e)dAdAdB�e)dCdCdB�e)dDdDdB�e)d6d(d#d6d5�e)dEd"d#dFdE�e)dGd"d"dHdG�e&d#d(�e&dIdJ�e&dKdL�e&dMdNdO�e&dPdQdP�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdkdl�e&dmdndo�e&dpdpdq�e&drdrdq�e&dsdsdq�e&dtdtdu�e&dvdw�e&dxdy�e&dzd{�e&d|d}d|�e&d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g@Z.ejd�k�rfe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rje,�3e/d�e/j1��qj[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d@d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d�d�d΃e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dڡGd�d܄d�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q>[/e8e7_.e,�3e7e+d��d�d�Gd�d�d�e(�Z9e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�d	d�d�g#Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d
��d�d�G�d
�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�dd��d�gZ<e<D]Z/e0e;e/j1e/��q�[/e<e;_.e,�3e;e+�d��d�d�G�d�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d �d!�Z@�d"�d#�ZAe�	r��d$ZB�d%ZC�d&ZD�d'ZE�d(ZF�d)ZGn$�d*ZB�d+ZC�d,ZD�d-ZE�d.ZF�d/ZGzeHZIWn"eJk
�	r��d0�d1�ZIYnXeIZHzeKZKWn"eJk
�
r�d2�d3�ZKYnXe�
rF�d4�d5�ZLejMZN�d6�d7�ZOeZPn>�d8�d5�ZL�d9�d:�ZN�d;�d7�ZOG�d<�d=��d=e�ZPeKZKe#eL�d>�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�r(�d?�d@�ZX�dA�dB�ZY�dC�dD�ZZ�dE�dF�Z[e�\�dG�Z]e�\�dH�Z^e�\�dI�Z_nT�dJ�d@�ZX�dK�dB�ZY�dL�dD�ZZ�dM�dF�Z[e�\�dN�Z]e�\�dO�Z^e�\�dP�Z_e#eX�dQ�e#eY�dR�e#eZ�dS�e#e[�dT�e�rF�dU�dV�Z`�dW�dX�ZaebZcddldZded�e�dY�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp[n�dZZqej
�d[�d[k�r8�d\Zr�d]Zsn�d^Zr�d_Zsnj�d`�dV�Z`�da�dX�ZaecZcebZg�db�dc�Zi�dd�de�Zke�tejuev�ZmddloZoeojoZoZp�dfZq�d\Zr�d]Zse#e`�dg�e#ea�dh��di�dZ�Zw�dj�d^�Zx�dk�d_�Zye�
reze4j{�dl�Z|�d��dm�dn�Z}n�d��do�dp�Z|e|�dq�ej
dd��drk�
rNe|�ds�n.ej
dd��drk�
rpe|�dt�n�du�dv�Z~eze4j{�dwd�Zedk�
r��dx�dy�Zej
dd��dzk�
r�eZ��d{�dy�Ze#e}�d|�ej
dd�dk�rej�ej�f�d}�d~�Z�nej�Z��d�d��Z��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��Z�gZ�e+Z�e�����d��dk	�r|ge�_�ej��r�e�ej��D]4\Z�Z�ee��j+dk�r�e�j1e+k�r�ej�e�=�qĐq�[�[�ej���e,�dS(�z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.12.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/six.py�__len__=sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Wsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__Zsz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrrgszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrpszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__ss
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'fs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr{sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4zsr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdbZ	getoutputZcommands�
subprocess�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_basezemail.MIMEBasezemail.mime.baseZemail_mime_imagezemail.MIMEImagezemail.mime.imageZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrruDsruZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZunquote_to_bytesZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
splitvalueZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrvrrrrrxssrxZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrvrrrrrz�srzZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassZparse_http_listZparse_keqv_listz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrvrrrrr|�sr|Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrvrrrrr~�sr~ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacerwryr{r}rcCsdddddgS)N�parse�error�request�responserqrr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rqr8rrrrr��s




r�zmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_movesr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rt�__dict__rFrrrr�remove_move	sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iterator*sr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>6szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callable5sr�cCs|Srr�Zunboundrrr�get_unbound_function;sr�cCs|Srr�r�clsrrr�create_unbound_method@sr�cCs|jSr)r�r�rrrr�FscCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_methodIsr�cCst�|d|�Sr)r�r�r�rrrr�Lsc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�Psz
Iterator.nextN)r
rrr�rrrrr�Osr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeyscsr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesfsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsisr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistslsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�vscKs|jf|�Sr)r�r�rrrr�yscKs|jf|�Sr)r�r�rrrr�|scKs|jf|�Sr)r�r�rrrr�s�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�b�sr�cCs|Srrr�rrr�u�sr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs:z*|dkr|�}|j|k	r$|�|��|�W5d}d}XdSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s

r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�zedef reraise(tp, value, tb=None):
    try:
        raise tp, value, tb
    finally:
        tb = None
)rrz�def raise_from(value, from_value):
    try:
        if from_value is None:
            raise value
        raise value from from_value
    finally:
        value = None
zrdef raise_from(value, from_value):
    try:
        raise value from from_value
    finally:
        value = None
cCs|�dSrr)r1Z
from_valuerrr�
raise_fromsr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr� s
���zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�Ws

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rd�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapperhszwraps.<locals>.wrapperr)r�r�r�r�rr�rr�csr�cs&G��fdd�dt�}t�|ddi�S)z%Create a base class with a metaclass.cs,eZdZ��fdd�Ze��fdd��ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�r�
this_basesr���bases�metarr�__new__zsz)with_metaclass.<locals>.metaclass.__new__cs��|��Sr)�__prepare__)r�rr�r�rrr�}sz-with_metaclass.<locals>.metaclass.__prepare__N)r
rrr��classmethodr�rr�rr�	metaclassysr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclasstsr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.cs||j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd�t|d�rl|j|d<�|j|j	|�S)N�	__slots__r��__weakref__r)
r��copyr�rIr�r�rMrr
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr��s




zadd_metaclass.<locals>.wrapperr)r�r�rrr�
add_metaclass�sr�utf-8r�cCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce **s** to six.binary_type.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> encoded to `bytes`
      - `bytes` -> `bytes`
    �not expecting type '%s'N)rI�	text_typer��binary_typer�r��r�r�r�rrr�
ensure_binary�s


r	cCsXt|ttf�stdt|���tr:t|t�r:|�||�}ntrTt|t�rT|�||�}|S)z�Coerce *s* to `str`.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    r)	rIrrr�r��PY2r�r)�decoderrrr�
ensure_str�srcCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce *s* to six.text_type.

    For Python 2:
      - `unicode` -> `unicode`
      - `str` -> `unicode`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    rN)rIrrrr�r�rrrr�ensure_text�s


r
cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nr)�__unicode__r�r	rrr�<lambda>��z-python_2_unicode_compatible.<locals>.<lambda>)r
r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible�s
��
r�__spec__)N)NN)rr�)rr�)rr�)�rZ
__future__rrdrU�operatorrr��
__author__�__version__�version_infor
r)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesr�bytesr�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArtruZ_urllib_parse_moved_attributesrxZ_urllib_error_moved_attributesrzZ _urllib_request_moved_attributesr|Z!_urllib_response_moved_attributesr~Z$_urllib_robotparser_moved_attributesr�r�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�rr	rr
rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>sN

@�

�




�









�






















�K













�









�
�


�
�
























�%������
��





�

�
�
�

:���
site-packages/pip/_vendor/urllib3/packages/__pycache__/six.cpython-38.opt-1.pyc000064400000063571151446177000023265 0ustar00U

��.e�C@s�dZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d3d4�e)d5d(d#d6d5�e)d7d(e
�rd8nd9d:�e)d;d(d<�e)d=d>d?d@�e)d d d�e)dAdAdB�e)dCdCdB�e)dDdDdB�e)d6d(d#d6d5�e)dEd"d#dFdE�e)dGd"d"dHdG�e&d#d(�e&dIdJ�e&dKdL�e&dMdNdO�e&dPdQdP�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdkdl�e&dmdndo�e&dpdpdq�e&drdrdq�e&dsdsdq�e&dtdtdu�e&dvdw�e&dxdy�e&dzd{�e&d|d}d|�e&d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g@Z.ejd�k�rfe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rje,�3e/d�e/j1��qj[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d@d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d�d�d΃e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dڡGd�d܄d�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q>[/e8e7_.e,�3e7e+d��d�d�Gd�d�d�e(�Z9e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)d�d�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�dd�d�e)�d	d�d�g#Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d
��d�d�G�d
�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�dd��d�gZ<e<D]Z/e0e;e/j1e/��q�[/e<e;_.e,�3e;e+�d��d�d�G�d�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d �d!�Z@�d"�d#�ZAe�	r��d$ZB�d%ZC�d&ZD�d'ZE�d(ZF�d)ZGn$�d*ZB�d+ZC�d,ZD�d-ZE�d.ZF�d/ZGzeHZIWn"eJk
�	r��d0�d1�ZIYnXeIZHzeKZKWn"eJk
�
r�d2�d3�ZKYnXe�
rF�d4�d5�ZLejMZN�d6�d7�ZOeZPn>�d8�d5�ZL�d9�d:�ZN�d;�d7�ZOG�d<�d=��d=e�ZPeKZKe#eL�d>�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�r(�d?�d@�ZX�dA�dB�ZY�dC�dD�ZZ�dE�dF�Z[e�\�dG�Z]e�\�dH�Z^e�\�dI�Z_nT�dJ�d@�ZX�dK�dB�ZY�dL�dD�ZZ�dM�dF�Z[e�\�dN�Z]e�\�dO�Z^e�\�dP�Z_e#eX�dQ�e#eY�dR�e#eZ�dS�e#e[�dT�e�rF�dU�dV�Z`�dW�dX�ZaebZcddldZded�e�dY�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp[n�dZZqej
�d[�d[k�r8�d\Zr�d]Zsn�d^Zr�d_Zsnj�d`�dV�Z`�da�dX�ZaecZcebZg�db�dc�Zi�dd�de�Zke�tejuev�ZmddloZoeojoZoZp�dfZq�d\Zr�d]Zse#e`�dg�e#ea�dh��di�dZ�Zw�dj�d^�Zx�dk�d_�Zye�
reze4j{�dl�Z|�d��dm�dn�Z}n�d��do�dp�Z|e|�dq�ej
dd��drk�
rNe|�ds�n.ej
dd��drk�
rpe|�dt�n�du�dv�Z~eze4j{�dwd�Zedk�
r��dx�dy�Zej
dd��dzk�
r�eZ��d{�dy�Ze#e}�d|�ej
dd�dk�rej�ej�f�d}�d~�Z�nej�Z��d�d��Z��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��d��Z��d��d��Z�gZ�e+Z�e�����d��dk	�r|ge�_�ej��r�e�ej��D]4\Z�Z�ee��j+dk�r�e�j1e+k�r�ej�e�=�qĐq�[�[�ej���e,�dS(�z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.12.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/six.py�__len__=sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Wsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__Zsz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrrgszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrpszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__ss
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'fs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr{sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4zsr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdbZ	getoutputZcommands�
subprocess�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_basezemail.MIMEBasezemail.mime.baseZemail_mime_imagezemail.MIMEImagezemail.mime.imageZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrruDsruZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZunquote_to_bytesZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
splitvalueZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrvrrrrrxssrxZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrvrrrrrz�srzZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassZparse_http_listZparse_keqv_listz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrvrrrrr|�sr|Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrvrrrrr~�sr~ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacerwryr{r}rcCsdddddgS)N�parse�error�request�responserqrr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rqr8rrrrr��s




r�zmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_movesr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rt�__dict__rFrrrr�remove_move	sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iterator*sr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>6szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callable5sr�cCs|Srr�Zunboundrrr�get_unbound_function;sr�cCs|Srr�r�clsrrr�create_unbound_method@sr�cCs|jSr)r�r�rrrr�FscCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_methodIsr�cCst�|d|�Sr)r�r�r�rrrr�Lsc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�Psz
Iterator.nextN)r
rrr�rrrrr�Osr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeyscsr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesfsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsisr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistslsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�vscKs|jf|�Sr)r�r�rrrr�yscKs|jf|�Sr)r�r�rrrr�|scKs|jf|�Sr)r�r�rrrr�s�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�b�sr�cCs|Srrr�rrr�u�sr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs:z*|dkr|�}|j|k	r$|�|��|�W5d}d}XdSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s

r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�zedef reraise(tp, value, tb=None):
    try:
        raise tp, value, tb
    finally:
        tb = None
)rrz�def raise_from(value, from_value):
    try:
        if from_value is None:
            raise value
        raise value from from_value
    finally:
        value = None
zrdef raise_from(value, from_value):
    try:
        raise value from from_value
    finally:
        value = None
cCs|�dSrr)r1Z
from_valuerrr�
raise_fromsr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr� s
���zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�Ws

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rd�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapperhszwraps.<locals>.wrapperr)r�r�r�r�rr�rr�csr�cs&G��fdd�dt�}t�|ddi�S)z%Create a base class with a metaclass.cs,eZdZ��fdd�Ze��fdd��ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�r�
this_basesr���bases�metarr�__new__zsz)with_metaclass.<locals>.metaclass.__new__cs��|��Sr)�__prepare__)r�rr�r�rrr�}sz-with_metaclass.<locals>.metaclass.__prepare__N)r
rrr��classmethodr�rr�rr�	metaclassysr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclasstsr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.cs||j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd�t|d�rl|j|d<�|j|j	|�S)N�	__slots__r��__weakref__r)
r��copyr�rIr�r�rMrr
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr��s




zadd_metaclass.<locals>.wrapperr)r�r�rrr�
add_metaclass�sr�utf-8r�cCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce **s** to six.binary_type.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> encoded to `bytes`
      - `bytes` -> `bytes`
    �not expecting type '%s'N)rI�	text_typer��binary_typer�r��r�r�r�rrr�
ensure_binary�s


r	cCsXt|ttf�stdt|���tr:t|t�r:|�||�}ntrTt|t�rT|�||�}|S)z�Coerce *s* to `str`.

    For Python 2:
      - `unicode` -> encoded to `str`
      - `str` -> `str`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    r)	rIrrr�r��PY2r�r)�decoderrrr�
ensure_str�srcCs8t|t�r|�||�St|t�r$|Stdt|���dS)z�Coerce *s* to six.text_type.

    For Python 2:
      - `unicode` -> `unicode`
      - `str` -> `unicode`

    For Python 3:
      - `str` -> `str`
      - `bytes` -> decoded to `str`
    rN)rIrrrr�r�rrrr�ensure_text�s


r
cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nr)�__unicode__r�r	rrr�<lambda>��z-python_2_unicode_compatible.<locals>.<lambda>)r
r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible�s
��
r�__spec__)N)NN)rr�)rr�)rr�)�rZ
__future__rrdrU�operatorrr��
__author__�__version__�version_infor
r)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesr�bytesr�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArtruZ_urllib_parse_moved_attributesrxZ_urllib_error_moved_attributesrzZ _urllib_request_moved_attributesr|Z!_urllib_response_moved_attributesr~Z$_urllib_robotparser_moved_attributesr�r�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�rr	rr
rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>sN

@�

�




�









�






















�K













�









�
�


�
�
























�%������
��





�

�
�
�

:���
site-packages/pip/_vendor/urllib3/packages/__pycache__/__init__.cpython-38.pyc000064400000000425151446177000023247 0ustar00U

��.el�@s ddlmZddlmZdZdS)�)�absolute_import�)�ssl_match_hostnameN)Z
__future__r�r�__all__�rr�I/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/__init__.py�<module>ssite-packages/pip/_vendor/urllib3/packages/__init__.py000064400000000154151446177000016760 0ustar00from __future__ import absolute_import

from . import ssl_match_hostname

__all__ = ("ssl_match_hostname",)
site-packages/pip/_vendor/urllib3/packages/ssl_match_hostname/_implementation.py000064400000013134151446177000024262 0ustar00"""The match_hostname() function from Python 3.3.3, essential when using SSL."""

# Note: This file is under the PSF license as the code comes from the python
# stdlib.   http://docs.python.org/3/license.html

import re
import sys

# ipaddress has been backported to 2.6+ in pypi.  If it is installed on the
# system, use it to handle IPAddress ServerAltnames (this was added in
# python-3.5) otherwise only do DNS matching.  This allows
# backports.ssl_match_hostname to continue to be used in Python 2.7.
try:
    from pip._vendor import ipaddress
except ImportError:
    ipaddress = None

__version__ = "3.5.0.1"


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

    # Ported from python3-syntax:
    # leftmost, *remainder = dn.split(r'.')
    parts = dn.split(r".")
    leftmost = parts[0]
    remainder = 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: " + repr(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 _to_unicode(obj):
    if isinstance(obj, str) and sys.version_info < (3,):
        obj = unicode(obj, encoding="ascii", errors="strict")
    return obj


def _ipaddress_match(ipname, host_ip):
    """Exact matching of IP addresses.

    RFC 6125 explicitly doesn't define an algorithm for this
    (section 1.7.2 - "Out of Scope").
    """
    # OpenSSL may add a trailing newline to a subjectAltName's IP address
    # Divergence from upstream: ipaddress can't handle byte str
    ip = ipaddress.ip_address(_to_unicode(ipname).rstrip())
    return ip == host_ip


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"
        )
    try:
        # Divergence from upstream: ipaddress can't handle byte str
        host_ip = ipaddress.ip_address(_to_unicode(hostname))
    except ValueError:
        # Not an IP address (common case)
        host_ip = None
    except UnicodeError:
        # Divergence from upstream: Have to deal with ipaddress not taking
        # byte strings.  addresses should be all ascii, so we consider it not
        # an ipaddress in this case
        host_ip = None
    except AttributeError:
        # Divergence from upstream: Make ipaddress library optional
        if ipaddress is None:
            host_ip = None
        else:
            raise
    dnsnames = []
    san = cert.get("subjectAltName", ())
    for key, value in san:
        if key == "DNS":
            if host_ip is None and _dnsname_match(value, hostname):
                return
            dnsnames.append(value)
        elif key == "IP Address":
            if host_ip is not None and _ipaddress_match(value, host_ip):
                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"
        )
pip/_vendor/urllib3/packages/ssl_match_hostname/__pycache__/_implementation.cpython-38.opt-1.pyc000064400000006347151446177000031440 0ustar00site-packagesU

��.e\�@sxdZddlZddlZzddlmZWnek
r<dZYnXdZGdd�de�Zddd	�Z	d
d�Z
dd
�Zdd�ZdS)zJThe match_hostname() function from Python 3.3.3, essential when using SSL.�N)�	ipaddressz3.5.0.1c@seZdZdS)�CertificateErrorN)�__name__�
__module__�__qualname__�rr�c/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/ssl_match_hostname/_implementation.pyrsr�c
Cs�g}|sdS|�d�}|d}|dd�}|�d�}||krLtdt|���|s`|��|��kS|dkrt|�d�n>|�d	�s�|�d	�r�|�t�|��n|�t�|��	d
d��|D]}|�t�|��q�t�
dd
�|�dtj�}	|	�
|�S)zhMatching according to RFC 6125, section 6.4.3

    http://tools.ietf.org/html/rfc6125#section-6.4.3
    F�.rr	N�*z,too many wildcards in certificate DNS name: z[^.]+zxn--z\*z[^.]*z\Az\.z\Z)�split�countr�repr�lower�append�
startswith�re�escape�replace�compile�join�
IGNORECASE�match)
Zdn�hostnameZ
max_wildcardsZpats�partsZleftmostZ	remainderZ	wildcardsZfragZpatrrr�_dnsname_matchs,


�rcCs&t|t�r"tjdkr"t|ddd�}|S)N)��ascii�strict)�encoding�errors)�
isinstance�str�sys�version_infoZunicode)�objrrr�_to_unicodeOsr&cCst�t|����}||kS)z�Exact matching of IP addresses.

    RFC 6125 explicitly doesn't define an algorithm for this
    (section 1.7.2 - "Out of Scope").
    )r�
ip_addressr&�rstrip)Zipname�host_ipZiprrr�_ipaddress_matchUsr*cCs�|std��zt�t|��}WnPtk
r6d}Yn:tk
rLd}Yn$tk
rntdkrhd}n�YnXg}|�dd�}|D]^\}}|dkr�|dkr�t||�r�dS|�|�q�|dkr�|dk	r�t	||�r�dS|�|�q�|�s0|�dd�D]8}|D].\}}|dkr�t||��r"dS|�|�q�q�t
|�d	k�r\td
|d�t
t|��f��n,t
|�d	k�r�td||d
f��ntd��dS)a)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.
    ztempty or no certificate, match_hostname needs a SSL socket or SSL context with either CERT_OPTIONAL or CERT_REQUIREDNZsubjectAltNamerZDNSz
IP AddressZsubjectZ
commonNamer	z&hostname %r doesn't match either of %sz, zhostname %r doesn't match %rrz=no appropriate commonName or subjectAltName fields were found)�
ValueErrorrr'r&�UnicodeError�AttributeError�getrrr*�lenrr�mapr)Zcertrr)ZdnsnamesZsan�key�value�subrrr�match_hostnameasZ�����r4)r	)
�__doc__rr#Zpip._vendorr�ImportError�__version__r+rrr&r*r4rrrr�<module>s

6pip/_vendor/urllib3/packages/ssl_match_hostname/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001006151446177000027776 0ustar00site-packagesU

��.e��@s�ddlZz&ejdkred��ddlmZmZWnNek
r|zddlmZmZWn$ek
rvddlmZmZYnXYnXdZdS)�N)��zFallback to vendored code)�CertificateError�match_hostname�)	�sys�version_info�ImportErrorZsslrrZbackports.ssl_match_hostnameZ_implementation�__all__�rr�\/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/ssl_match_hostname/__init__.py�<module>s
pip/_vendor/urllib3/packages/ssl_match_hostname/__pycache__/_implementation.cpython-38.pyc000064400000006347151446177000030501 0ustar00site-packagesU

��.e\�@sxdZddlZddlZzddlmZWnek
r<dZYnXdZGdd�de�Zddd	�Z	d
d�Z
dd
�Zdd�ZdS)zJThe match_hostname() function from Python 3.3.3, essential when using SSL.�N)�	ipaddressz3.5.0.1c@seZdZdS)�CertificateErrorN)�__name__�
__module__�__qualname__�rr�c/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/ssl_match_hostname/_implementation.pyrsr�c
Cs�g}|sdS|�d�}|d}|dd�}|�d�}||krLtdt|���|s`|��|��kS|dkrt|�d�n>|�d	�s�|�d	�r�|�t�|��n|�t�|��	d
d��|D]}|�t�|��q�t�
dd
�|�dtj�}	|	�
|�S)zhMatching according to RFC 6125, section 6.4.3

    http://tools.ietf.org/html/rfc6125#section-6.4.3
    F�.rr	N�*z,too many wildcards in certificate DNS name: z[^.]+zxn--z\*z[^.]*z\Az\.z\Z)�split�countr�repr�lower�append�
startswith�re�escape�replace�compile�join�
IGNORECASE�match)
Zdn�hostnameZ
max_wildcardsZpats�partsZleftmostZ	remainderZ	wildcardsZfragZpatrrr�_dnsname_matchs,


�rcCs&t|t�r"tjdkr"t|ddd�}|S)N)��ascii�strict)�encoding�errors)�
isinstance�str�sys�version_infoZunicode)�objrrr�_to_unicodeOsr&cCst�t|����}||kS)z�Exact matching of IP addresses.

    RFC 6125 explicitly doesn't define an algorithm for this
    (section 1.7.2 - "Out of Scope").
    )r�
ip_addressr&�rstrip)Zipname�host_ipZiprrr�_ipaddress_matchUsr*cCs�|std��zt�t|��}WnPtk
r6d}Yn:tk
rLd}Yn$tk
rntdkrhd}n�YnXg}|�dd�}|D]^\}}|dkr�|dkr�t||�r�dS|�|�q�|dkr�|dk	r�t	||�r�dS|�|�q�|�s0|�dd�D]8}|D].\}}|dkr�t||��r"dS|�|�q�q�t
|�d	k�r\td
|d�t
t|��f��n,t
|�d	k�r�td||d
f��ntd��dS)a)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.
    ztempty or no certificate, match_hostname needs a SSL socket or SSL context with either CERT_OPTIONAL or CERT_REQUIREDNZsubjectAltNamerZDNSz
IP AddressZsubjectZ
commonNamer	z&hostname %r doesn't match either of %sz, zhostname %r doesn't match %rrz=no appropriate commonName or subjectAltName fields were found)�
ValueErrorrr'r&�UnicodeError�AttributeError�getrrr*�lenrr�mapr)Zcertrr)ZdnsnamesZsan�key�value�subrrr�match_hostnameasZ�����r4)r	)
�__doc__rr#Zpip._vendorr�ImportError�__version__r+rrr&r*r4rrrr�<module>s

6site-packages/pip/_vendor/urllib3/packages/ssl_match_hostname/__pycache__/__init__.cpython-38.pyc000064400000001006151446177000027116 0ustar00U

��.e��@s�ddlZz&ejdkred��ddlmZmZWnNek
r|zddlmZmZWn$ek
rvddlmZmZYnXYnXdZdS)�N)��zFallback to vendored code)�CertificateError�match_hostname�)	�sys�version_info�ImportErrorZsslrrZbackports.ssl_match_hostnameZ_implementation�__all__�rr�\/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/ssl_match_hostname/__init__.py�<module>s
site-packages/pip/_vendor/urllib3/packages/ssl_match_hostname/__init__.py000064400000001260151446177000022632 0ustar00import sys

try:
    # Our match_hostname function is the same as 3.5's, so we only want to
    # import the match_hostname function if it's at least that good.
    if sys.version_info < (3, 5):
        raise ImportError("Fallback to vendored code")

    from ssl import CertificateError, match_hostname
except ImportError:
    try:
        # Backport of the function from a pypi module
        from backports.ssl_match_hostname import CertificateError, match_hostname
    except ImportError:
        # Our vendored copy
        from ._implementation import CertificateError, match_hostname

# Not needed, but documenting what we provide.
__all__ = ("CertificateError", "match_hostname")
site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000256151446177000026200 0ustar00U

��.e�@sdS)N�rrr�S/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py�<module>�site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-38.opt-1.pyc000064400000002326151446177000026216 0ustar00U

��.e��@s&dZddlZddlmZddd�ZdS)z�
backports.makefile
~~~~~~~~~~~~~~~~~~

Backports the Python 3 ``socket.makefile`` method for use with anything that
wants to create a "fake" socket object.
�N)�SocketIO�rc
Cs�t|�dddhks td|f��d|k}d|kp4|}d|k}d}	|rN|	d7}	|rZ|	d7}	t||	�}
|jd7_|dkr~d}|d	kr�tj}|d	kr�|s�td
��|
S|r�|r�t�|
|
|�}n|r�t�|
|�}nt�|
|�}|r�|St�	||||�}||_
|S)z:
    Backport of ``socket.makefile`` from Python 3.5.
    r�w�bz&invalid mode %r (only r, w, b allowed)��N���rz!unbuffered streams must be binary)�set�
ValueErrorrZ_makefile_refs�io�DEFAULT_BUFFER_SIZE�BufferedRWPair�BufferedReader�BufferedWriter�
TextIOWrapper�mode)
�selfr�	buffering�encoding�errors�newlineZwritingZreadingZbinaryZrawmode�raw�buffer�text�r�S/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py�backport_makefiles<
r)rNNNN)�__doc__rZsocketrrrrrr�<module>s�site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/makefile.cpython-38.pyc000064400000002376151446177000025264 0ustar00U

��.e��@s&dZddlZddlmZddd�ZdS)z�
backports.makefile
~~~~~~~~~~~~~~~~~~

Backports the Python 3 ``socket.makefile`` method for use with anything that
wants to create a "fake" socket object.
�N)�SocketIO�rc
Cst|�dddhks td|f��d|k}d|kp4|}|sB|sBt�d|k}d}	|rZ|	d7}	|rf|	d7}	t||	�}
|jd7_|dkr�d}|d	kr�tj}|d	kr�|s�td
��|
S|r�|r�t�|
|
|�}n&|r�t�|
|�}n|s�t�t�	|
|�}|r�|St�
||||�}||_|S)z:
    Backport of ``socket.makefile`` from Python 3.5.
    r�w�bz&invalid mode %r (only r, w, b allowed)��N���rz!unbuffered streams must be binary)�set�
ValueError�AssertionErrorrZ_makefile_refs�io�DEFAULT_BUFFER_SIZE�BufferedRWPair�BufferedReader�BufferedWriter�
TextIOWrapper�mode)
�selfr�	buffering�encoding�errors�newlineZwritingZreadingZbinaryZrawmode�raw�buffer�text�r�S/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/backports/makefile.py�backport_makefiles@
r)rNNNN)�__doc__rZsocketrrrrrr�<module>s�site-packages/pip/_vendor/urllib3/packages/backports/__pycache__/__init__.cpython-38.pyc000064400000000256151446177000025241 0ustar00U

��.e�@sdS)N�rrr�S/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/packages/backports/__init__.py�<module>�site-packages/pip/_vendor/urllib3/packages/backports/__init__.py000064400000000000151446177000020736 0ustar00site-packages/pip/_vendor/urllib3/packages/backports/makefile.py000064400000002612151446177000020767 0ustar00# -*- coding: utf-8 -*-
"""
backports.makefile
~~~~~~~~~~~~~~~~~~

Backports the Python 3 ``socket.makefile`` method for use with anything that
wants to create a "fake" socket object.
"""
import io

from socket import SocketIO


def backport_makefile(
    self, mode="r", buffering=None, encoding=None, errors=None, newline=None
):
    """
    Backport of ``socket.makefile`` from Python 3.5.
    """
    if not set(mode) <= {"r", "w", "b"}:
        raise ValueError("invalid mode %r (only r, w, b allowed)" % (mode,))
    writing = "w" in mode
    reading = "r" in mode or not writing
    assert reading or writing
    binary = "b" in mode
    rawmode = ""
    if reading:
        rawmode += "r"
    if writing:
        rawmode += "w"
    raw = SocketIO(self, rawmode)
    self._makefile_refs += 1
    if buffering is None:
        buffering = -1
    if buffering < 0:
        buffering = io.DEFAULT_BUFFER_SIZE
    if buffering == 0:
        if not binary:
            raise ValueError("unbuffered streams must be binary")
        return raw
    if reading and writing:
        buffer = io.BufferedRWPair(raw, raw, buffering)
    elif reading:
        buffer = io.BufferedReader(raw, buffering)
    else:
        assert writing
        buffer = io.BufferedWriter(raw, buffering)
    if binary:
        return buffer
    text = io.TextIOWrapper(buffer, encoding, errors, newline)
    text.mode = mode
    return text
site-packages/pip/_vendor/urllib3/connectionpool.py000064400000107136151446177000016504 0ustar00from __future__ import absolute_import
import errno
import logging
import sys
import warnings

from socket import error as SocketError, timeout as SocketTimeout
import socket


from .exceptions import (
    ClosedPoolError,
    ProtocolError,
    EmptyPoolError,
    HeaderParsingError,
    HostChangedError,
    LocationValueError,
    MaxRetryError,
    ProxyError,
    ReadTimeoutError,
    SSLError,
    TimeoutError,
    InsecureRequestWarning,
    NewConnectionError,
)
from .packages.ssl_match_hostname import CertificateError
from .packages import six
from .packages.six.moves import queue
from .connection import (
    port_by_scheme,
    DummyConnection,
    HTTPConnection,
    HTTPSConnection,
    VerifiedHTTPSConnection,
    HTTPException,
    BaseSSLError,
)
from .request import RequestMethods
from .response import HTTPResponse

from .util.connection import is_connection_dropped
from .util.request import set_file_position
from .util.response import assert_header_parsing
from .util.retry import Retry
from .util.timeout import Timeout
from .util.url import (
    get_host,
    parse_url,
    Url,
    _normalize_host as normalize_host,
    _encode_target,
)
from .util.queue import LifoQueue


xrange = six.moves.xrange

log = logging.getLogger(__name__)

_Default = object()


# Pool objects
class ConnectionPool(object):
    """
    Base class for all connection pools, such as
    :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
    """

    scheme = None
    QueueCls = LifoQueue

    def __init__(self, host, port=None):
        if not host:
            raise LocationValueError("No host specified.")

        self.host = _normalize_host(host, scheme=self.scheme)
        self._proxy_host = host.lower()
        self.port = port

    def __str__(self):
        return "%s(host=%r, port=%r)" % (type(self).__name__, self.host, self.port)

    def __enter__(self):
        return self

    def __exit__(self, exc_type, exc_val, exc_tb):
        self.close()
        # Return False to re-raise any potential exceptions
        return False

    def close(self):
        """
        Close all pooled connections and disable the pool.
        """
        pass


# This is taken from http://hg.python.org/cpython/file/7aaba721ebc0/Lib/socket.py#l252
_blocking_errnos = {errno.EAGAIN, errno.EWOULDBLOCK}


class HTTPConnectionPool(ConnectionPool, RequestMethods):
    """
    Thread-safe connection pool for one host.

    :param host:
        Host used for this HTTP Connection (e.g. "localhost"), passed into
        :class:`httplib.HTTPConnection`.

    :param port:
        Port used for this HTTP Connection (None is equivalent to 80), passed
        into :class:`httplib.HTTPConnection`.

    :param strict:
        Causes BadStatusLine to be raised if the status line can't be parsed
        as a valid HTTP/1.0 or 1.1 status line, passed into
        :class:`httplib.HTTPConnection`.

        .. note::
           Only works in Python 2. This parameter is ignored in Python 3.

    :param timeout:
        Socket timeout in seconds for each individual connection. This can
        be a float or integer, which sets the timeout for the HTTP request,
        or an instance of :class:`urllib3.util.Timeout` which gives you more
        fine-grained control over request timeouts. After the constructor has
        been parsed, this is always a `urllib3.util.Timeout` object.

    :param maxsize:
        Number of connections to save that can be reused. More than 1 is useful
        in multithreaded situations. If ``block`` is set to False, more
        connections will be created but they will not be saved once they've
        been used.

    :param block:
        If set to True, no more than ``maxsize`` connections will be used at
        a time. When no free connections are available, the call will block
        until a connection has been released. This is a useful side effect for
        particular multithreaded situations where one does not want to use more
        than maxsize connections per host to prevent flooding.

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.

    :param retries:
        Retry configuration to use by default with requests in this pool.

    :param _proxy:
        Parsed proxy URL, should not be used directly, instead, see
        :class:`urllib3.connectionpool.ProxyManager`"

    :param _proxy_headers:
        A dictionary with proxy headers, should not be used directly,
        instead, see :class:`urllib3.connectionpool.ProxyManager`"

    :param \\**conn_kw:
        Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
        :class:`urllib3.connection.HTTPSConnection` instances.
    """

    scheme = "http"
    ConnectionCls = HTTPConnection
    ResponseCls = HTTPResponse

    def __init__(
        self,
        host,
        port=None,
        strict=False,
        timeout=Timeout.DEFAULT_TIMEOUT,
        maxsize=1,
        block=False,
        headers=None,
        retries=None,
        _proxy=None,
        _proxy_headers=None,
        **conn_kw
    ):
        ConnectionPool.__init__(self, host, port)
        RequestMethods.__init__(self, headers)

        self.strict = strict

        if not isinstance(timeout, Timeout):
            timeout = Timeout.from_float(timeout)

        if retries is None:
            retries = Retry.DEFAULT

        self.timeout = timeout
        self.retries = retries

        self.pool = self.QueueCls(maxsize)
        self.block = block

        self.proxy = _proxy
        self.proxy_headers = _proxy_headers or {}

        # Fill the queue up so that doing get() on it will block properly
        for _ in xrange(maxsize):
            self.pool.put(None)

        # These are mostly for testing and debugging purposes.
        self.num_connections = 0
        self.num_requests = 0
        self.conn_kw = conn_kw

        if self.proxy:
            # Enable Nagle's algorithm for proxies, to avoid packet fragmentation.
            # We cannot know if the user has added default socket options, so we cannot replace the
            # list.
            self.conn_kw.setdefault("socket_options", [])

    def _new_conn(self):
        """
        Return a fresh :class:`HTTPConnection`.
        """
        self.num_connections += 1
        log.debug(
            "Starting new HTTP connection (%d): %s:%s",
            self.num_connections,
            self.host,
            self.port or "80",
        )

        conn = self.ConnectionCls(
            host=self.host,
            port=self.port,
            timeout=self.timeout.connect_timeout,
            strict=self.strict,
            **self.conn_kw
        )
        return conn

    def _get_conn(self, timeout=None):
        """
        Get a connection. Will return a pooled connection if one is available.

        If no connections are available and :prop:`.block` is ``False``, then a
        fresh connection is returned.

        :param timeout:
            Seconds to wait before giving up and raising
            :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
            :prop:`.block` is ``True``.
        """
        conn = None
        try:
            conn = self.pool.get(block=self.block, timeout=timeout)

        except AttributeError:  # self.pool is None
            raise ClosedPoolError(self, "Pool is closed.")

        except queue.Empty:
            if self.block:
                raise EmptyPoolError(
                    self,
                    "Pool reached maximum size and no more " "connections are allowed.",
                )
            pass  # Oh well, we'll create a new connection then

        # If this is a persistent connection, check if it got disconnected
        if conn and is_connection_dropped(conn):
            log.debug("Resetting dropped connection: %s", self.host)
            conn.close()
            if getattr(conn, "auto_open", 1) == 0:
                # This is a proxied connection that has been mutated by
                # httplib._tunnel() and cannot be reused (since it would
                # attempt to bypass the proxy)
                conn = None

        return conn or self._new_conn()

    def _put_conn(self, conn):
        """
        Put a connection back into the pool.

        :param conn:
            Connection object for the current host and port as returned by
            :meth:`._new_conn` or :meth:`._get_conn`.

        If the pool is already full, the connection is closed and discarded
        because we exceeded maxsize. If connections are discarded frequently,
        then maxsize should be increased.

        If the pool is closed, then the connection will be closed and discarded.
        """
        try:
            self.pool.put(conn, block=False)
            return  # Everything is dandy, done.
        except AttributeError:
            # self.pool is None.
            pass
        except queue.Full:
            # This should never happen if self.block == True
            log.warning("Connection pool is full, discarding connection: %s", self.host)

        # Connection never got put back into the pool, close it.
        if conn:
            conn.close()

    def _validate_conn(self, conn):
        """
        Called right before a request is made, after the socket is created.
        """
        pass

    def _prepare_proxy(self, conn):
        # Nothing to do for HTTP connections.
        pass

    def _get_timeout(self, timeout):
        """ Helper that always returns a :class:`urllib3.util.Timeout` """
        if timeout is _Default:
            return self.timeout.clone()

        if isinstance(timeout, Timeout):
            return timeout.clone()
        else:
            # User passed us an int/float. This is for backwards compatibility,
            # can be removed later
            return Timeout.from_float(timeout)

    def _raise_timeout(self, err, url, timeout_value):
        """Is the error actually a timeout? Will raise a ReadTimeout or pass"""

        if isinstance(err, SocketTimeout):
            raise ReadTimeoutError(
                self, url, "Read timed out. (read timeout=%s)" % timeout_value
            )

        # See the above comment about EAGAIN in Python 3. In Python 2 we have
        # to specifically catch it and throw the timeout error
        if hasattr(err, "errno") and err.errno in _blocking_errnos:
            raise ReadTimeoutError(
                self, url, "Read timed out. (read timeout=%s)" % timeout_value
            )

        # Catch possible read timeouts thrown as SSL errors. If not the
        # case, rethrow the original. We need to do this because of:
        # http://bugs.python.org/issue10272
        if "timed out" in str(err) or "did not complete (read)" in str(
            err
        ):  # Python < 2.7.4
            raise ReadTimeoutError(
                self, url, "Read timed out. (read timeout=%s)" % timeout_value
            )

    def _make_request(
        self, conn, method, url, timeout=_Default, chunked=False, **httplib_request_kw
    ):
        """
        Perform a request on a given urllib connection object taken from our
        pool.

        :param conn:
            a connection from one of our connection pools

        :param timeout:
            Socket timeout in seconds for the request. This can be a
            float or integer, which will set the same timeout value for
            the socket connect and the socket read, or an instance of
            :class:`urllib3.util.Timeout`, which gives you more fine-grained
            control over your timeouts.
        """
        self.num_requests += 1

        timeout_obj = self._get_timeout(timeout)
        timeout_obj.start_connect()
        conn.timeout = timeout_obj.connect_timeout

        # Trigger any extra validation we need to do.
        try:
            self._validate_conn(conn)
        except (SocketTimeout, BaseSSLError) as e:
            # Py2 raises this as a BaseSSLError, Py3 raises it as socket timeout.
            self._raise_timeout(err=e, url=url, timeout_value=conn.timeout)
            raise

        # conn.request() calls httplib.*.request, not the method in
        # urllib3.request. It also calls makefile (recv) on the socket.
        if chunked:
            conn.request_chunked(method, url, **httplib_request_kw)
        else:
            conn.request(method, url, **httplib_request_kw)

        # Reset the timeout for the recv() on the socket
        read_timeout = timeout_obj.read_timeout

        # App Engine doesn't have a sock attr
        if getattr(conn, "sock", None):
            # In Python 3 socket.py will catch EAGAIN and return None when you
            # try and read into the file pointer created by http.client, which
            # instead raises a BadStatusLine exception. Instead of catching
            # the exception and assuming all BadStatusLine exceptions are read
            # timeouts, check for a zero timeout before making the request.
            if read_timeout == 0:
                raise ReadTimeoutError(
                    self, url, "Read timed out. (read timeout=%s)" % read_timeout
                )
            if read_timeout is Timeout.DEFAULT_TIMEOUT:
                conn.sock.settimeout(socket.getdefaulttimeout())
            else:  # None or a value
                conn.sock.settimeout(read_timeout)

        # Receive the response from the server
        try:
            try:
                # Python 2.7, use buffering of HTTP responses
                httplib_response = conn.getresponse(buffering=True)
            except TypeError:
                # Python 3
                try:
                    httplib_response = conn.getresponse()
                except BaseException as e:
                    # Remove the TypeError from the exception chain in
                    # Python 3 (including for exceptions like SystemExit).
                    # Otherwise it looks like a bug in the code.
                    six.raise_from(e, None)
        except (SocketTimeout, BaseSSLError, SocketError) as e:
            self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
            raise

        # AppEngine doesn't have a version attr.
        http_version = getattr(conn, "_http_vsn_str", "HTTP/?")
        log.debug(
            '%s://%s:%s "%s %s %s" %s %s',
            self.scheme,
            self.host,
            self.port,
            method,
            url,
            http_version,
            httplib_response.status,
            httplib_response.length,
        )

        try:
            assert_header_parsing(httplib_response.msg)
        except (HeaderParsingError, TypeError) as hpe:  # Platform-specific: Python 3
            log.warning(
                "Failed to parse headers (url=%s): %s",
                self._absolute_url(url),
                hpe,
                exc_info=True,
            )

        return httplib_response

    def _absolute_url(self, path):
        return Url(scheme=self.scheme, host=self.host, port=self.port, path=path).url

    def close(self):
        """
        Close all pooled connections and disable the pool.
        """
        if self.pool is None:
            return
        # Disable access to the pool
        old_pool, self.pool = self.pool, None

        try:
            while True:
                conn = old_pool.get(block=False)
                if conn:
                    conn.close()

        except queue.Empty:
            pass  # Done.

    def is_same_host(self, url):
        """
        Check if the given ``url`` is a member of the same host as this
        connection pool.
        """
        if url.startswith("/"):
            return True

        # TODO: Add optional support for socket.gethostbyname checking.
        scheme, host, port = get_host(url)
        if host is not None:
            host = _normalize_host(host, scheme=scheme)

        # Use explicit default port for comparison when none is given
        if self.port and not port:
            port = port_by_scheme.get(scheme)
        elif not self.port and port == port_by_scheme.get(scheme):
            port = None

        return (scheme, host, port) == (self.scheme, self.host, self.port)

    def urlopen(
        self,
        method,
        url,
        body=None,
        headers=None,
        retries=None,
        redirect=True,
        assert_same_host=True,
        timeout=_Default,
        pool_timeout=None,
        release_conn=None,
        chunked=False,
        body_pos=None,
        **response_kw
    ):
        """
        Get a connection from the pool and perform an HTTP request. This is the
        lowest level call for making a request, so you'll need to specify all
        the raw details.

        .. note::

           More commonly, it's appropriate to use a convenience method provided
           by :class:`.RequestMethods`, such as :meth:`request`.

        .. note::

           `release_conn` will only behave as expected if
           `preload_content=False` because we want to make
           `preload_content=False` the default behaviour someday soon without
           breaking backwards compatibility.

        :param method:
            HTTP request method (such as GET, POST, PUT, etc.)

        :param body:
            Data to send in the request body (useful for creating
            POST requests, see HTTPConnectionPool.post_url for
            more convenience).

        :param headers:
            Dictionary of custom headers to send, such as User-Agent,
            If-None-Match, etc. If None, pool headers are used. If provided,
            these headers completely replace any pool-specific headers.

        :param retries:
            Configure the number of retries to allow before raising a
            :class:`~urllib3.exceptions.MaxRetryError` exception.

            Pass ``None`` to retry until you receive a response. Pass a
            :class:`~urllib3.util.retry.Retry` object for fine-grained control
            over different types of retries.
            Pass an integer number to retry connection errors that many times,
            but no other types of errors. Pass zero to never retry.

            If ``False``, then retries are disabled and any exception is raised
            immediately. Also, instead of raising a MaxRetryError on redirects,
            the redirect response will be returned.

        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.

        :param redirect:
            If True, automatically handle redirects (status codes 301, 302,
            303, 307, 308). Each redirect counts as a retry. Disabling retries
            will disable redirect, too.

        :param assert_same_host:
            If ``True``, will make sure that the host of the pool requests is
            consistent else will raise HostChangedError. When False, you can
            use the pool on an HTTP proxy and request foreign hosts.

        :param timeout:
            If specified, overrides the default timeout for this one
            request. It may be a float (in seconds) or an instance of
            :class:`urllib3.util.Timeout`.

        :param pool_timeout:
            If set and the pool is set to block=True, then this method will
            block for ``pool_timeout`` seconds and raise EmptyPoolError if no
            connection is available within the time period.

        :param release_conn:
            If False, then the urlopen call will not release the connection
            back into the pool once a response is received (but will release if
            you read the entire contents of the response such as when
            `preload_content=True`). This is useful if you're not preloading
            the response's content immediately. You will need to call
            ``r.release_conn()`` on the response ``r`` to return the connection
            back into the pool. If None, it takes the value of
            ``response_kw.get('preload_content', True)``.

        :param chunked:
            If True, urllib3 will send the body using chunked transfer
            encoding. Otherwise, urllib3 will send the body using the standard
            content-length form. Defaults to False.

        :param int body_pos:
            Position to seek to in file-like body in the event of a retry or
            redirect. Typically this won't need to be set because urllib3 will
            auto-populate the value when needed.

        :param \\**response_kw:
            Additional parameters are passed to
            :meth:`urllib3.response.HTTPResponse.from_httplib`
        """
        if headers is None:
            headers = self.headers

        if not isinstance(retries, Retry):
            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)

        if release_conn is None:
            release_conn = response_kw.get("preload_content", True)

        # Check host
        if assert_same_host and not self.is_same_host(url):
            raise HostChangedError(self, url, retries)

        # Ensure that the URL we're connecting to is properly encoded
        if url.startswith("/"):
            url = six.ensure_str(_encode_target(url))
        else:
            url = six.ensure_str(parse_url(url).url)

        conn = None

        # Track whether `conn` needs to be released before
        # returning/raising/recursing. Update this variable if necessary, and
        # leave `release_conn` constant throughout the function. That way, if
        # the function recurses, the original value of `release_conn` will be
        # passed down into the recursive call, and its value will be respected.
        #
        # See issue #651 [1] for details.
        #
        # [1] <https://github.com/shazow/urllib3/issues/651>
        release_this_conn = release_conn

        # Merge the proxy headers. Only do this in HTTP. We have to copy the
        # headers dict so we can safely change it without those changes being
        # reflected in anyone else's copy.
        if self.scheme == "http":
            headers = headers.copy()
            headers.update(self.proxy_headers)

        # Must keep the exception bound to a separate variable or else Python 3
        # complains about UnboundLocalError.
        err = None

        # Keep track of whether we cleanly exited the except block. This
        # ensures we do proper cleanup in finally.
        clean_exit = False

        # Rewind body position, if needed. Record current position
        # for future rewinds in the event of a redirect/retry.
        body_pos = set_file_position(body, body_pos)

        try:
            # Request a connection from the queue.
            timeout_obj = self._get_timeout(timeout)
            conn = self._get_conn(timeout=pool_timeout)

            conn.timeout = timeout_obj.connect_timeout

            is_new_proxy_conn = self.proxy is not None and not getattr(
                conn, "sock", None
            )
            if is_new_proxy_conn:
                self._prepare_proxy(conn)

            # Make the request on the httplib connection object.
            httplib_response = self._make_request(
                conn,
                method,
                url,
                timeout=timeout_obj,
                body=body,
                headers=headers,
                chunked=chunked,
            )

            # If we're going to release the connection in ``finally:``, then
            # the response doesn't need to know about the connection. Otherwise
            # it will also try to release it and we'll have a double-release
            # mess.
            response_conn = conn if not release_conn else None

            # Pass method to Response for length checking
            response_kw["request_method"] = method

            # Import httplib's response into our own wrapper object
            response = self.ResponseCls.from_httplib(
                httplib_response,
                pool=self,
                connection=response_conn,
                retries=retries,
                **response_kw
            )

            # Everything went great!
            clean_exit = True

        except queue.Empty:
            # Timed out by queue.
            raise EmptyPoolError(self, "No pool connections are available.")

        except (
            TimeoutError,
            HTTPException,
            SocketError,
            ProtocolError,
            BaseSSLError,
            SSLError,
            CertificateError,
        ) as e:
            # Discard the connection for these exceptions. It will be
            # replaced during the next _get_conn() call.
            clean_exit = False
            if isinstance(e, (BaseSSLError, CertificateError)):
                e = SSLError(e)
            elif isinstance(e, (SocketError, NewConnectionError)) and self.proxy:
                e = ProxyError("Cannot connect to proxy.", e)
            elif isinstance(e, (SocketError, HTTPException)):
                e = ProtocolError("Connection aborted.", e)

            retries = retries.increment(
                method, url, error=e, _pool=self, _stacktrace=sys.exc_info()[2]
            )
            retries.sleep()

            # Keep track of the error for the retry warning.
            err = e

        finally:
            if not clean_exit:
                # We hit some kind of exception, handled or otherwise. We need
                # to throw the connection away unless explicitly told not to.
                # Close the connection, set the variable to None, and make sure
                # we put the None back in the pool to avoid leaking it.
                conn = conn and conn.close()
                release_this_conn = True

            if release_this_conn:
                # Put the connection back to be reused. If the connection is
                # expired then it will be None, which will get replaced with a
                # fresh connection during _get_conn.
                self._put_conn(conn)

        if not conn:
            # Try again
            log.warning(
                "Retrying (%r) after connection " "broken by '%r': %s",
                retries,
                err,
                url,
            )
            return self.urlopen(
                method,
                url,
                body,
                headers,
                retries,
                redirect,
                assert_same_host,
                timeout=timeout,
                pool_timeout=pool_timeout,
                release_conn=release_conn,
                body_pos=body_pos,
                **response_kw
            )

        def drain_and_release_conn(response):
            try:
                # discard any remaining response body, the connection will be
                # released back to the pool once the entire response is read
                response.read()
            except (
                TimeoutError,
                HTTPException,
                SocketError,
                ProtocolError,
                BaseSSLError,
                SSLError,
            ):
                pass

        # Handle redirect?
        redirect_location = redirect and response.get_redirect_location()
        if redirect_location:
            if response.status == 303:
                method = "GET"

            try:
                retries = retries.increment(method, url, response=response, _pool=self)
            except MaxRetryError:
                if retries.raise_on_redirect:
                    # Drain and release the connection for this response, since
                    # we're not returning it to be released manually.
                    drain_and_release_conn(response)
                    raise
                return response

            # drain and return the connection to the pool before recursing
            drain_and_release_conn(response)

            retries.sleep_for_retry(response)
            log.debug("Redirecting %s -> %s", url, redirect_location)
            return self.urlopen(
                method,
                redirect_location,
                body,
                headers,
                retries=retries,
                redirect=redirect,
                assert_same_host=assert_same_host,
                timeout=timeout,
                pool_timeout=pool_timeout,
                release_conn=release_conn,
                body_pos=body_pos,
                **response_kw
            )

        # Check if we should retry the HTTP response.
        has_retry_after = bool(response.getheader("Retry-After"))
        if retries.is_retry(method, response.status, has_retry_after):
            try:
                retries = retries.increment(method, url, response=response, _pool=self)
            except MaxRetryError:
                if retries.raise_on_status:
                    # Drain and release the connection for this response, since
                    # we're not returning it to be released manually.
                    drain_and_release_conn(response)
                    raise
                return response

            # drain and return the connection to the pool before recursing
            drain_and_release_conn(response)

            retries.sleep(response)
            log.debug("Retry: %s", url)
            return self.urlopen(
                method,
                url,
                body,
                headers,
                retries=retries,
                redirect=redirect,
                assert_same_host=assert_same_host,
                timeout=timeout,
                pool_timeout=pool_timeout,
                release_conn=release_conn,
                body_pos=body_pos,
                **response_kw
            )

        return response


class HTTPSConnectionPool(HTTPConnectionPool):
    """
    Same as :class:`.HTTPConnectionPool`, but HTTPS.

    When Python is compiled with the :mod:`ssl` module, then
    :class:`.VerifiedHTTPSConnection` is used, which *can* verify certificates,
    instead of :class:`.HTTPSConnection`.

    :class:`.VerifiedHTTPSConnection` uses one of ``assert_fingerprint``,
    ``assert_hostname`` and ``host`` in this order to verify connections.
    If ``assert_hostname`` is False, no verification is done.

    The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
    ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl`
    is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
    the connection socket into an SSL socket.
    """

    scheme = "https"
    ConnectionCls = HTTPSConnection

    def __init__(
        self,
        host,
        port=None,
        strict=False,
        timeout=Timeout.DEFAULT_TIMEOUT,
        maxsize=1,
        block=False,
        headers=None,
        retries=None,
        _proxy=None,
        _proxy_headers=None,
        key_file=None,
        cert_file=None,
        cert_reqs=None,
        key_password=None,
        ca_certs=None,
        ssl_version=None,
        assert_hostname=None,
        assert_fingerprint=None,
        ca_cert_dir=None,
        **conn_kw
    ):

        HTTPConnectionPool.__init__(
            self,
            host,
            port,
            strict,
            timeout,
            maxsize,
            block,
            headers,
            retries,
            _proxy,
            _proxy_headers,
            **conn_kw
        )

        self.key_file = key_file
        self.cert_file = cert_file
        self.cert_reqs = cert_reqs
        self.key_password = key_password
        self.ca_certs = ca_certs
        self.ca_cert_dir = ca_cert_dir
        self.ssl_version = ssl_version
        self.assert_hostname = assert_hostname
        self.assert_fingerprint = assert_fingerprint

    def _prepare_conn(self, conn):
        """
        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
        and establish the tunnel if proxy is used.
        """

        if isinstance(conn, VerifiedHTTPSConnection):
            conn.set_cert(
                key_file=self.key_file,
                key_password=self.key_password,
                cert_file=self.cert_file,
                cert_reqs=self.cert_reqs,
                ca_certs=self.ca_certs,
                ca_cert_dir=self.ca_cert_dir,
                assert_hostname=self.assert_hostname,
                assert_fingerprint=self.assert_fingerprint,
            )
            conn.ssl_version = self.ssl_version
        return conn

    def _prepare_proxy(self, conn):
        """
        Establish tunnel connection early, because otherwise httplib
        would improperly set Host: header to proxy's IP:port.
        """
        conn.set_tunnel(self._proxy_host, self.port, self.proxy_headers)
        conn.connect()

    def _new_conn(self):
        """
        Return a fresh :class:`httplib.HTTPSConnection`.
        """
        self.num_connections += 1
        log.debug(
            "Starting new HTTPS connection (%d): %s:%s",
            self.num_connections,
            self.host,
            self.port or "443",
        )

        if not self.ConnectionCls or self.ConnectionCls is DummyConnection:
            raise SSLError(
                "Can't connect to HTTPS URL because the SSL " "module is not available."
            )

        actual_host = self.host
        actual_port = self.port
        if self.proxy is not None:
            actual_host = self.proxy.host
            actual_port = self.proxy.port

        conn = self.ConnectionCls(
            host=actual_host,
            port=actual_port,
            timeout=self.timeout.connect_timeout,
            strict=self.strict,
            cert_file=self.cert_file,
            key_file=self.key_file,
            key_password=self.key_password,
            **self.conn_kw
        )

        return self._prepare_conn(conn)

    def _validate_conn(self, conn):
        """
        Called right before a request is made, after the socket is created.
        """
        super(HTTPSConnectionPool, self)._validate_conn(conn)

        # Force connect early to allow us to validate the connection.
        if not getattr(conn, "sock", None):  # AppEngine might not have  `.sock`
            conn.connect()

        if not conn.is_verified:
            warnings.warn(
                (
                    "Unverified HTTPS request is being made. "
                    "Adding certificate verification is strongly advised. See: "
                    "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
                    "#ssl-warnings"
                ),
                InsecureRequestWarning,
            )


def connection_from_url(url, **kw):
    """
    Given a url, return an :class:`.ConnectionPool` instance of its host.

    This is a shortcut for not having to parse out the scheme, host, and port
    of the url before creating an :class:`.ConnectionPool` instance.

    :param url:
        Absolute URL string that must include the scheme. Port is optional.

    :param \\**kw:
        Passes additional parameters to the constructor of the appropriate
        :class:`.ConnectionPool`. Useful for specifying things like
        timeout, maxsize, headers, etc.

    Example::

        >>> conn = connection_from_url('http://google.com/')
        >>> r = conn.request('GET', '/')
    """
    scheme, host, port = get_host(url)
    port = port or port_by_scheme.get(scheme, 80)
    if scheme == "https":
        return HTTPSConnectionPool(host, port=port, **kw)
    else:
        return HTTPConnectionPool(host, port=port, **kw)


def _normalize_host(host, scheme):
    """
    Normalize hosts for comparisons and use with sockets.
    """

    host = normalize_host(host, scheme)

    # httplib doesn't like it when we include brackets in IPv6 addresses
    # Specifically, if we include brackets but also pass the port then
    # httplib crazily doubles up the square brackets on the Host header.
    # Instead, we need to make sure we never pass ``None`` as the port.
    # However, for backward compatibility reasons we can't actually
    # *assert* that.  See http://bugs.python.org/issue28539
    if host.startswith("[") and host.endswith("]"):
        host = host[1:-1]
    return host
site-packages/pip/_vendor/urllib3/fields.py000064400000020551151446177000014714 0ustar00from __future__ import absolute_import
import email.utils
import mimetypes
import re

from .packages import six


def guess_content_type(filename, default="application/octet-stream"):
    """
    Guess the "Content-Type" of a file.

    :param filename:
        The filename to guess the "Content-Type" of using :mod:`mimetypes`.
    :param default:
        If no "Content-Type" can be guessed, default to `default`.
    """
    if filename:
        return mimetypes.guess_type(filename)[0] or default
    return default


def format_header_param_rfc2231(name, value):
    """
    Helper function to format and quote a single header parameter using the
    strategy defined in RFC 2231.

    Particularly useful for header parameters which might contain
    non-ASCII values, like file names. This follows RFC 2388 Section 4.4.

    :param name:
        The name of the parameter, a string expected to be ASCII only.
    :param value:
        The value of the parameter, provided as ``bytes`` or `str``.
    :ret:
        An RFC-2231-formatted unicode string.
    """
    if isinstance(value, six.binary_type):
        value = value.decode("utf-8")

    if not any(ch in value for ch in '"\\\r\n'):
        result = u'%s="%s"' % (name, value)
        try:
            result.encode("ascii")
        except (UnicodeEncodeError, UnicodeDecodeError):
            pass
        else:
            return result

    if six.PY2:  # Python 2:
        value = value.encode("utf-8")

    # encode_rfc2231 accepts an encoded string and returns an ascii-encoded
    # string in Python 2 but accepts and returns unicode strings in Python 3
    value = email.utils.encode_rfc2231(value, "utf-8")
    value = "%s*=%s" % (name, value)

    if six.PY2:  # Python 2:
        value = value.decode("utf-8")

    return value


_HTML5_REPLACEMENTS = {
    u"\u0022": u"%22",
    # Replace "\" with "\\".
    u"\u005C": u"\u005C\u005C",
    u"\u005C": u"\u005C\u005C",
}

# All control characters from 0x00 to 0x1F *except* 0x1B.
_HTML5_REPLACEMENTS.update(
    {
        six.unichr(cc): u"%{:02X}".format(cc)
        for cc in range(0x00, 0x1F + 1)
        if cc not in (0x1B,)
    }
)


def _replace_multiple(value, needles_and_replacements):
    def replacer(match):
        return needles_and_replacements[match.group(0)]

    pattern = re.compile(
        r"|".join([re.escape(needle) for needle in needles_and_replacements.keys()])
    )

    result = pattern.sub(replacer, value)

    return result


def format_header_param_html5(name, value):
    """
    Helper function to format and quote a single header parameter using the
    HTML5 strategy.

    Particularly useful for header parameters which might contain
    non-ASCII values, like file names. This follows the `HTML5 Working Draft
    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.

    .. _HTML5 Working Draft Section 4.10.22.7:
        https://w3c.github.io/html/sec-forms.html#multipart-form-data

    :param name:
        The name of the parameter, a string expected to be ASCII only.
    :param value:
        The value of the parameter, provided as ``bytes`` or `str``.
    :ret:
        A unicode string, stripped of troublesome characters.
    """
    if isinstance(value, six.binary_type):
        value = value.decode("utf-8")

    value = _replace_multiple(value, _HTML5_REPLACEMENTS)

    return u'%s="%s"' % (name, value)


# For backwards-compatibility.
format_header_param = format_header_param_html5


class RequestField(object):
    """
    A data container for request body parameters.

    :param name:
        The name of this request field. Must be unicode.
    :param data:
        The data/value body.
    :param filename:
        An optional filename of the request field. Must be unicode.
    :param headers:
        An optional dict-like object of headers to initially use for the field.
    :param header_formatter:
        An optional callable that is used to encode and format the headers. By
        default, this is :func:`format_header_param_html5`.
    """

    def __init__(
        self,
        name,
        data,
        filename=None,
        headers=None,
        header_formatter=format_header_param_html5,
    ):
        self._name = name
        self._filename = filename
        self.data = data
        self.headers = {}
        if headers:
            self.headers = dict(headers)
        self.header_formatter = header_formatter

    @classmethod
    def from_tuples(cls, fieldname, value, header_formatter=format_header_param_html5):
        """
        A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.

        Supports constructing :class:`~urllib3.fields.RequestField` from
        parameter of key/value strings AND key/filetuple. A filetuple is a
        (filename, data, MIME type) tuple where the MIME type is optional.
        For example::

            'foo': 'bar',
            'fakefile': ('foofile.txt', 'contents of foofile'),
            'realfile': ('barfile.txt', open('realfile').read()),
            'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),
            'nonamefile': 'contents of nonamefile field',

        Field names and filenames must be unicode.
        """
        if isinstance(value, tuple):
            if len(value) == 3:
                filename, data, content_type = value
            else:
                filename, data = value
                content_type = guess_content_type(filename)
        else:
            filename = None
            content_type = None
            data = value

        request_param = cls(
            fieldname, data, filename=filename, header_formatter=header_formatter
        )
        request_param.make_multipart(content_type=content_type)

        return request_param

    def _render_part(self, name, value):
        """
        Overridable helper function to format a single header parameter. By
        default, this calls ``self.header_formatter``.

        :param name:
            The name of the parameter, a string expected to be ASCII only.
        :param value:
            The value of the parameter, provided as a unicode string.
        """

        return self.header_formatter(name, value)

    def _render_parts(self, header_parts):
        """
        Helper function to format and quote a single header.

        Useful for single headers that are composed of multiple items. E.g.,
        'Content-Disposition' fields.

        :param header_parts:
            A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
            as `k1="v1"; k2="v2"; ...`.
        """
        parts = []
        iterable = header_parts
        if isinstance(header_parts, dict):
            iterable = header_parts.items()

        for name, value in iterable:
            if value is not None:
                parts.append(self._render_part(name, value))

        return u"; ".join(parts)

    def render_headers(self):
        """
        Renders the headers for this request field.
        """
        lines = []

        sort_keys = ["Content-Disposition", "Content-Type", "Content-Location"]
        for sort_key in sort_keys:
            if self.headers.get(sort_key, False):
                lines.append(u"%s: %s" % (sort_key, self.headers[sort_key]))

        for header_name, header_value in self.headers.items():
            if header_name not in sort_keys:
                if header_value:
                    lines.append(u"%s: %s" % (header_name, header_value))

        lines.append(u"\r\n")
        return u"\r\n".join(lines)

    def make_multipart(
        self, content_disposition=None, content_type=None, content_location=None
    ):
        """
        Makes this request field into a multipart request field.

        This method overrides "Content-Disposition", "Content-Type" and
        "Content-Location" headers to the request parameter.

        :param content_type:
            The 'Content-Type' of the request body.
        :param content_location:
            The 'Content-Location' of the request body.

        """
        self.headers["Content-Disposition"] = content_disposition or u"form-data"
        self.headers["Content-Disposition"] += u"; ".join(
            [
                u"",
                self._render_parts(
                    ((u"name", self._name), (u"filename", self._filename))
                ),
            ]
        )
        self.headers["Content-Type"] = content_type
        self.headers["Content-Location"] = content_location
site-packages/pip/_vendor/urllib3/poolmanager.py000064400000041235151446177000015754 0ustar00from __future__ import absolute_import
import collections
import functools
import logging

from ._collections import RecentlyUsedContainer
from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool
from .connectionpool import port_by_scheme
from .exceptions import LocationValueError, MaxRetryError, ProxySchemeUnknown
from .packages import six
from .packages.six.moves.urllib.parse import urljoin
from .request import RequestMethods
from .util.url import parse_url
from .util.retry import Retry


__all__ = ["PoolManager", "ProxyManager", "proxy_from_url"]


log = logging.getLogger(__name__)

SSL_KEYWORDS = (
    "key_file",
    "cert_file",
    "cert_reqs",
    "ca_certs",
    "ssl_version",
    "ca_cert_dir",
    "ssl_context",
    "key_password",
)

# All known keyword arguments that could be provided to the pool manager, its
# pools, or the underlying connections. This is used to construct a pool key.
_key_fields = (
    "key_scheme",  # str
    "key_host",  # str
    "key_port",  # int
    "key_timeout",  # int or float or Timeout
    "key_retries",  # int or Retry
    "key_strict",  # bool
    "key_block",  # bool
    "key_source_address",  # str
    "key_key_file",  # str
    "key_key_password",  # str
    "key_cert_file",  # str
    "key_cert_reqs",  # str
    "key_ca_certs",  # str
    "key_ssl_version",  # str
    "key_ca_cert_dir",  # str
    "key_ssl_context",  # instance of ssl.SSLContext or urllib3.util.ssl_.SSLContext
    "key_maxsize",  # int
    "key_headers",  # dict
    "key__proxy",  # parsed proxy url
    "key__proxy_headers",  # dict
    "key_socket_options",  # list of (level (int), optname (int), value (int or str)) tuples
    "key__socks_options",  # dict
    "key_assert_hostname",  # bool or string
    "key_assert_fingerprint",  # str
    "key_server_hostname",  # str
)

#: The namedtuple class used to construct keys for the connection pool.
#: All custom key schemes should include the fields in this key at a minimum.
PoolKey = collections.namedtuple("PoolKey", _key_fields)


def _default_key_normalizer(key_class, request_context):
    """
    Create a pool key out of a request context dictionary.

    According to RFC 3986, both the scheme and host are case-insensitive.
    Therefore, this function normalizes both before constructing the pool
    key for an HTTPS request. If you wish to change this behaviour, provide
    alternate callables to ``key_fn_by_scheme``.

    :param key_class:
        The class to use when constructing the key. This should be a namedtuple
        with the ``scheme`` and ``host`` keys at a minimum.
    :type  key_class: namedtuple
    :param request_context:
        A dictionary-like object that contain the context for a request.
    :type  request_context: dict

    :return: A namedtuple that can be used as a connection pool key.
    :rtype:  PoolKey
    """
    # Since we mutate the dictionary, make a copy first
    context = request_context.copy()
    context["scheme"] = context["scheme"].lower()
    context["host"] = context["host"].lower()

    # These are both dictionaries and need to be transformed into frozensets
    for key in ("headers", "_proxy_headers", "_socks_options"):
        if key in context and context[key] is not None:
            context[key] = frozenset(context[key].items())

    # The socket_options key may be a list and needs to be transformed into a
    # tuple.
    socket_opts = context.get("socket_options")
    if socket_opts is not None:
        context["socket_options"] = tuple(socket_opts)

    # Map the kwargs to the names in the namedtuple - this is necessary since
    # namedtuples can't have fields starting with '_'.
    for key in list(context.keys()):
        context["key_" + key] = context.pop(key)

    # Default to ``None`` for keys missing from the context
    for field in key_class._fields:
        if field not in context:
            context[field] = None

    return key_class(**context)


#: A dictionary that maps a scheme to a callable that creates a pool key.
#: This can be used to alter the way pool keys are constructed, if desired.
#: Each PoolManager makes a copy of this dictionary so they can be configured
#: globally here, or individually on the instance.
key_fn_by_scheme = {
    "http": functools.partial(_default_key_normalizer, PoolKey),
    "https": functools.partial(_default_key_normalizer, PoolKey),
}

pool_classes_by_scheme = {"http": HTTPConnectionPool, "https": HTTPSConnectionPool}


class PoolManager(RequestMethods):
    """
    Allows for arbitrary requests while transparently keeping track of
    necessary connection pools for you.

    :param num_pools:
        Number of connection pools to cache before discarding the least
        recently used pool.

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.

    :param \\**connection_pool_kw:
        Additional parameters are used to create fresh
        :class:`urllib3.connectionpool.ConnectionPool` instances.

    Example::

        >>> manager = PoolManager(num_pools=2)
        >>> r = manager.request('GET', 'http://google.com/')
        >>> r = manager.request('GET', 'http://google.com/mail')
        >>> r = manager.request('GET', 'http://yahoo.com/')
        >>> len(manager.pools)
        2

    """

    proxy = None

    def __init__(self, num_pools=10, headers=None, **connection_pool_kw):
        RequestMethods.__init__(self, headers)
        self.connection_pool_kw = connection_pool_kw
        self.pools = RecentlyUsedContainer(num_pools, dispose_func=lambda p: p.close())

        # Locally set the pool classes and keys so other PoolManagers can
        # override them.
        self.pool_classes_by_scheme = pool_classes_by_scheme
        self.key_fn_by_scheme = key_fn_by_scheme.copy()

    def __enter__(self):
        return self

    def __exit__(self, exc_type, exc_val, exc_tb):
        self.clear()
        # Return False to re-raise any potential exceptions
        return False

    def _new_pool(self, scheme, host, port, request_context=None):
        """
        Create a new :class:`ConnectionPool` based on host, port, scheme, and
        any additional pool keyword arguments.

        If ``request_context`` is provided, it is provided as keyword arguments
        to the pool class used. This method is used to actually create the
        connection pools handed out by :meth:`connection_from_url` and
        companion methods. It is intended to be overridden for customization.
        """
        pool_cls = self.pool_classes_by_scheme[scheme]
        if request_context is None:
            request_context = self.connection_pool_kw.copy()

        # Although the context has everything necessary to create the pool,
        # this function has historically only used the scheme, host, and port
        # in the positional args. When an API change is acceptable these can
        # be removed.
        for key in ("scheme", "host", "port"):
            request_context.pop(key, None)

        if scheme == "http":
            for kw in SSL_KEYWORDS:
                request_context.pop(kw, None)

        return pool_cls(host, port, **request_context)

    def clear(self):
        """
        Empty our store of pools and direct them all to close.

        This will not affect in-flight connections, but they will not be
        re-used after completion.
        """
        self.pools.clear()

    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
        """
        Get a :class:`ConnectionPool` based on the host, port, and scheme.

        If ``port`` isn't given, it will be derived from the ``scheme`` using
        ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is
        provided, it is merged with the instance's ``connection_pool_kw``
        variable and used to create the new connection pool, if one is
        needed.
        """

        if not host:
            raise LocationValueError("No host specified.")

        request_context = self._merge_pool_kwargs(pool_kwargs)
        request_context["scheme"] = scheme or "http"
        if not port:
            port = port_by_scheme.get(request_context["scheme"].lower(), 80)
        request_context["port"] = port
        request_context["host"] = host

        return self.connection_from_context(request_context)

    def connection_from_context(self, request_context):
        """
        Get a :class:`ConnectionPool` based on the request context.

        ``request_context`` must at least contain the ``scheme`` key and its
        value must be a key in ``key_fn_by_scheme`` instance variable.
        """
        scheme = request_context["scheme"].lower()
        pool_key_constructor = self.key_fn_by_scheme[scheme]
        pool_key = pool_key_constructor(request_context)

        return self.connection_from_pool_key(pool_key, request_context=request_context)

    def connection_from_pool_key(self, pool_key, request_context=None):
        """
        Get a :class:`ConnectionPool` based on the provided pool key.

        ``pool_key`` should be a namedtuple that only contains immutable
        objects. At a minimum it must have the ``scheme``, ``host``, and
        ``port`` fields.
        """
        with self.pools.lock:
            # If the scheme, host, or port doesn't match existing open
            # connections, open a new ConnectionPool.
            pool = self.pools.get(pool_key)
            if pool:
                return pool

            # Make a fresh ConnectionPool of the desired type
            scheme = request_context["scheme"]
            host = request_context["host"]
            port = request_context["port"]
            pool = self._new_pool(scheme, host, port, request_context=request_context)
            self.pools[pool_key] = pool

        return pool

    def connection_from_url(self, url, pool_kwargs=None):
        """
        Similar to :func:`urllib3.connectionpool.connection_from_url`.

        If ``pool_kwargs`` is not provided and a new pool needs to be
        constructed, ``self.connection_pool_kw`` is used to initialize
        the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs``
        is provided, it is used instead. Note that if a new pool does not
        need to be created for the request, the provided ``pool_kwargs`` are
        not used.
        """
        u = parse_url(url)
        return self.connection_from_host(
            u.host, port=u.port, scheme=u.scheme, pool_kwargs=pool_kwargs
        )

    def _merge_pool_kwargs(self, override):
        """
        Merge a dictionary of override values for self.connection_pool_kw.

        This does not modify self.connection_pool_kw and returns a new dict.
        Any keys in the override dictionary with a value of ``None`` are
        removed from the merged dictionary.
        """
        base_pool_kwargs = self.connection_pool_kw.copy()
        if override:
            for key, value in override.items():
                if value is None:
                    try:
                        del base_pool_kwargs[key]
                    except KeyError:
                        pass
                else:
                    base_pool_kwargs[key] = value
        return base_pool_kwargs

    def urlopen(self, method, url, redirect=True, **kw):
        """
        Same as :meth:`urllib3.connectionpool.HTTPConnectionPool.urlopen`
        with custom cross-host redirect logic and only sends the request-uri
        portion of the ``url``.

        The given ``url`` parameter must be absolute, such that an appropriate
        :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
        """
        u = parse_url(url)
        conn = self.connection_from_host(u.host, port=u.port, scheme=u.scheme)

        kw["assert_same_host"] = False
        kw["redirect"] = False

        if "headers" not in kw:
            kw["headers"] = self.headers.copy()

        if self.proxy is not None and u.scheme == "http":
            response = conn.urlopen(method, url, **kw)
        else:
            response = conn.urlopen(method, u.request_uri, **kw)

        redirect_location = redirect and response.get_redirect_location()
        if not redirect_location:
            return response

        # Support relative URLs for redirecting.
        redirect_location = urljoin(url, redirect_location)

        # RFC 7231, Section 6.4.4
        if response.status == 303:
            method = "GET"

        retries = kw.get("retries")
        if not isinstance(retries, Retry):
            retries = Retry.from_int(retries, redirect=redirect)

        # Strip headers marked as unsafe to forward to the redirected location.
        # Check remove_headers_on_redirect to avoid a potential network call within
        # conn.is_same_host() which may use socket.gethostbyname() in the future.
        if retries.remove_headers_on_redirect and not conn.is_same_host(
            redirect_location
        ):
            headers = list(six.iterkeys(kw["headers"]))
            for header in headers:
                if header.lower() in retries.remove_headers_on_redirect:
                    kw["headers"].pop(header, None)

        try:
            retries = retries.increment(method, url, response=response, _pool=conn)
        except MaxRetryError:
            if retries.raise_on_redirect:
                raise
            return response

        kw["retries"] = retries
        kw["redirect"] = redirect

        log.info("Redirecting %s -> %s", url, redirect_location)
        return self.urlopen(method, redirect_location, **kw)


class ProxyManager(PoolManager):
    """
    Behaves just like :class:`PoolManager`, but sends all requests through
    the defined proxy, using the CONNECT method for HTTPS URLs.

    :param proxy_url:
        The URL of the proxy to be used.

    :param proxy_headers:
        A dictionary containing headers that will be sent to the proxy. In case
        of HTTP they are being sent with each request, while in the
        HTTPS/CONNECT case they are sent only once. Could be used for proxy
        authentication.

    Example:
        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
        >>> r1 = proxy.request('GET', 'http://google.com/')
        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
        >>> len(proxy.pools)
        1
        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
        >>> r4 = proxy.request('GET', 'https://twitter.com/')
        >>> len(proxy.pools)
        3

    """

    def __init__(
        self,
        proxy_url,
        num_pools=10,
        headers=None,
        proxy_headers=None,
        **connection_pool_kw
    ):

        if isinstance(proxy_url, HTTPConnectionPool):
            proxy_url = "%s://%s:%i" % (
                proxy_url.scheme,
                proxy_url.host,
                proxy_url.port,
            )
        proxy = parse_url(proxy_url)
        if not proxy.port:
            port = port_by_scheme.get(proxy.scheme, 80)
            proxy = proxy._replace(port=port)

        if proxy.scheme not in ("http", "https"):
            raise ProxySchemeUnknown(proxy.scheme)

        self.proxy = proxy
        self.proxy_headers = proxy_headers or {}

        connection_pool_kw["_proxy"] = self.proxy
        connection_pool_kw["_proxy_headers"] = self.proxy_headers

        super(ProxyManager, self).__init__(num_pools, headers, **connection_pool_kw)

    def connection_from_host(self, host, port=None, scheme="http", pool_kwargs=None):
        if scheme == "https":
            return super(ProxyManager, self).connection_from_host(
                host, port, scheme, pool_kwargs=pool_kwargs
            )

        return super(ProxyManager, self).connection_from_host(
            self.proxy.host, self.proxy.port, self.proxy.scheme, pool_kwargs=pool_kwargs
        )

    def _set_proxy_headers(self, url, headers=None):
        """
        Sets headers needed by proxies: specifically, the Accept and Host
        headers. Only sets headers not provided by the user.
        """
        headers_ = {"Accept": "*/*"}

        netloc = parse_url(url).netloc
        if netloc:
            headers_["Host"] = netloc

        if headers:
            headers_.update(headers)
        return headers_

    def urlopen(self, method, url, redirect=True, **kw):
        "Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute."
        u = parse_url(url)

        if u.scheme == "http":
            # For proxied HTTPS requests, httplib sets the necessary headers
            # on the CONNECT to the proxy. For HTTP, we'll definitely
            # need to set 'Host' at the very least.
            headers = kw.get("headers", self.headers)
            kw["headers"] = self._set_proxy_headers(url, headers)

        return super(ProxyManager, self).urlopen(method, url, redirect=redirect, **kw)


def proxy_from_url(url, **kw):
    return ProxyManager(proxy_url=url, **kw)
site-packages/pip/_vendor/urllib3/_collections.py000064400000025050151446177000016122 0ustar00from __future__ import absolute_import

try:
    from collections.abc import Mapping, MutableMapping
except ImportError:
    from collections import Mapping, MutableMapping
try:
    from threading import RLock
except ImportError:  # Platform-specific: No threads available

    class RLock:
        def __enter__(self):
            pass

        def __exit__(self, exc_type, exc_value, traceback):
            pass


from collections import OrderedDict
from .exceptions import InvalidHeader
from .packages.six import iterkeys, itervalues, PY3


__all__ = ["RecentlyUsedContainer", "HTTPHeaderDict"]


_Null = object()


class RecentlyUsedContainer(MutableMapping):
    """
    Provides a thread-safe dict-like container which maintains up to
    ``maxsize`` keys while throwing away the least-recently-used keys beyond
    ``maxsize``.

    :param maxsize:
        Maximum number of recent elements to retain.

    :param dispose_func:
        Every time an item is evicted from the container,
        ``dispose_func(value)`` is called.  Callback which will get called
    """

    ContainerCls = OrderedDict

    def __init__(self, maxsize=10, dispose_func=None):
        self._maxsize = maxsize
        self.dispose_func = dispose_func

        self._container = self.ContainerCls()
        self.lock = RLock()

    def __getitem__(self, key):
        # Re-insert the item, moving it to the end of the eviction line.
        with self.lock:
            item = self._container.pop(key)
            self._container[key] = item
            return item

    def __setitem__(self, key, value):
        evicted_value = _Null
        with self.lock:
            # Possibly evict the existing value of 'key'
            evicted_value = self._container.get(key, _Null)
            self._container[key] = value

            # If we didn't evict an existing value, we might have to evict the
            # least recently used item from the beginning of the container.
            if len(self._container) > self._maxsize:
                _key, evicted_value = self._container.popitem(last=False)

        if self.dispose_func and evicted_value is not _Null:
            self.dispose_func(evicted_value)

    def __delitem__(self, key):
        with self.lock:
            value = self._container.pop(key)

        if self.dispose_func:
            self.dispose_func(value)

    def __len__(self):
        with self.lock:
            return len(self._container)

    def __iter__(self):
        raise NotImplementedError(
            "Iteration over this class is unlikely to be threadsafe."
        )

    def clear(self):
        with self.lock:
            # Copy pointers to all values, then wipe the mapping
            values = list(itervalues(self._container))
            self._container.clear()

        if self.dispose_func:
            for value in values:
                self.dispose_func(value)

    def keys(self):
        with self.lock:
            return list(iterkeys(self._container))


class HTTPHeaderDict(MutableMapping):
    """
    :param headers:
        An iterable of field-value pairs. Must not contain multiple field names
        when compared case-insensitively.

    :param kwargs:
        Additional field-value pairs to pass in to ``dict.update``.

    A ``dict`` like container for storing HTTP Headers.

    Field names are stored and compared case-insensitively in compliance with
    RFC 7230. Iteration provides the first case-sensitive key seen for each
    case-insensitive pair.

    Using ``__setitem__`` syntax overwrites fields that compare equal
    case-insensitively in order to maintain ``dict``'s api. For fields that
    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
    in a loop.

    If multiple fields that are equal case-insensitively are passed to the
    constructor or ``.update``, the behavior is undefined and some will be
    lost.

    >>> headers = HTTPHeaderDict()
    >>> headers.add('Set-Cookie', 'foo=bar')
    >>> headers.add('set-cookie', 'baz=quxx')
    >>> headers['content-length'] = '7'
    >>> headers['SET-cookie']
    'foo=bar, baz=quxx'
    >>> headers['Content-Length']
    '7'
    """

    def __init__(self, headers=None, **kwargs):
        super(HTTPHeaderDict, self).__init__()
        self._container = OrderedDict()
        if headers is not None:
            if isinstance(headers, HTTPHeaderDict):
                self._copy_from(headers)
            else:
                self.extend(headers)
        if kwargs:
            self.extend(kwargs)

    def __setitem__(self, key, val):
        self._container[key.lower()] = [key, val]
        return self._container[key.lower()]

    def __getitem__(self, key):
        val = self._container[key.lower()]
        return ", ".join(val[1:])

    def __delitem__(self, key):
        del self._container[key.lower()]

    def __contains__(self, key):
        return key.lower() in self._container

    def __eq__(self, other):
        if not isinstance(other, Mapping) and not hasattr(other, "keys"):
            return False
        if not isinstance(other, type(self)):
            other = type(self)(other)
        return dict((k.lower(), v) for k, v in self.itermerged()) == dict(
            (k.lower(), v) for k, v in other.itermerged()
        )

    def __ne__(self, other):
        return not self.__eq__(other)

    if not PY3:  # Python 2
        iterkeys = MutableMapping.iterkeys
        itervalues = MutableMapping.itervalues

    __marker = object()

    def __len__(self):
        return len(self._container)

    def __iter__(self):
        # Only provide the originally cased names
        for vals in self._container.values():
            yield vals[0]

    def pop(self, key, default=__marker):
        """D.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.
        """
        # Using the MutableMapping function directly fails due to the private marker.
        # Using ordinary dict.pop would expose the internal structures.
        # So let's reinvent the wheel.
        try:
            value = self[key]
        except KeyError:
            if default is self.__marker:
                raise
            return default
        else:
            del self[key]
            return value

    def discard(self, key):
        try:
            del self[key]
        except KeyError:
            pass

    def add(self, key, val):
        """Adds a (name, value) pair, doesn't overwrite the value if it already
        exists.

        >>> headers = HTTPHeaderDict(foo='bar')
        >>> headers.add('Foo', 'baz')
        >>> headers['foo']
        'bar, baz'
        """
        key_lower = key.lower()
        new_vals = [key, val]
        # Keep the common case aka no item present as fast as possible
        vals = self._container.setdefault(key_lower, new_vals)
        if new_vals is not vals:
            vals.append(val)

    def extend(self, *args, **kwargs):
        """Generic import function for any type of header-like object.
        Adapted version of MutableMapping.update in order to insert items
        with self.add instead of self.__setitem__
        """
        if len(args) > 1:
            raise TypeError(
                "extend() takes at most 1 positional "
                "arguments ({0} given)".format(len(args))
            )
        other = args[0] if len(args) >= 1 else ()

        if isinstance(other, HTTPHeaderDict):
            for key, val in other.iteritems():
                self.add(key, val)
        elif isinstance(other, Mapping):
            for key in other:
                self.add(key, other[key])
        elif hasattr(other, "keys"):
            for key in other.keys():
                self.add(key, other[key])
        else:
            for key, value in other:
                self.add(key, value)

        for key, value in kwargs.items():
            self.add(key, value)

    def getlist(self, key, default=__marker):
        """Returns a list of all the values for the named field. Returns an
        empty list if the key doesn't exist."""
        try:
            vals = self._container[key.lower()]
        except KeyError:
            if default is self.__marker:
                return []
            return default
        else:
            return vals[1:]

    # Backwards compatibility for httplib
    getheaders = getlist
    getallmatchingheaders = getlist
    iget = getlist

    # Backwards compatibility for http.cookiejar
    get_all = getlist

    def __repr__(self):
        return "%s(%s)" % (type(self).__name__, dict(self.itermerged()))

    def _copy_from(self, other):
        for key in other:
            val = other.getlist(key)
            if isinstance(val, list):
                # Don't need to convert tuples
                val = list(val)
            self._container[key.lower()] = [key] + val

    def copy(self):
        clone = type(self)()
        clone._copy_from(self)
        return clone

    def iteritems(self):
        """Iterate over all header lines, including duplicate ones."""
        for key in self:
            vals = self._container[key.lower()]
            for val in vals[1:]:
                yield vals[0], val

    def itermerged(self):
        """Iterate over all headers, merging duplicate ones together."""
        for key in self:
            val = self._container[key.lower()]
            yield val[0], ", ".join(val[1:])

    def items(self):
        return list(self.iteritems())

    @classmethod
    def from_httplib(cls, message):  # Python 2
        """Read headers from a Python 2 httplib message object."""
        # python2.7 does not expose a proper API for exporting multiheaders
        # efficiently. This function re-reads raw lines from the message
        # object and extracts the multiheaders properly.
        obs_fold_continued_leaders = (" ", "\t")
        headers = []

        for line in message.headers:
            if line.startswith(obs_fold_continued_leaders):
                if not headers:
                    # We received a header line that starts with OWS as described
                    # in RFC-7230 S3.2.4. This indicates a multiline header, but
                    # there exists no previous header to which we can attach it.
                    raise InvalidHeader(
                        "Header continuation with no previous header: %s" % line
                    )
                else:
                    key, value = headers[-1]
                    headers[-1] = (key, value + " " + line.strip())
                    continue

            key, value = line.split(":", 1)
            headers.append((key, value.strip()))

        return cls(headers)
site-packages/pip/_vendor/urllib3/response.py000064400000066274151446177000015320 0ustar00from __future__ import absolute_import
from contextlib import contextmanager
import zlib
import io
import logging
from socket import timeout as SocketTimeout
from socket import error as SocketError

try:
    import brotli
except ImportError:
    brotli = None

from ._collections import HTTPHeaderDict
from .exceptions import (
    BodyNotHttplibCompatible,
    ProtocolError,
    DecodeError,
    ReadTimeoutError,
    ResponseNotChunked,
    IncompleteRead,
    InvalidHeader,
)
from .packages.six import string_types as basestring, PY3
from .packages.six.moves import http_client as httplib
from .connection import HTTPException, BaseSSLError
from .util.response import is_fp_closed, is_response_to_head

log = logging.getLogger(__name__)


class DeflateDecoder(object):
    def __init__(self):
        self._first_try = True
        self._data = b""
        self._obj = zlib.decompressobj()

    def __getattr__(self, name):
        return getattr(self._obj, name)

    def decompress(self, data):
        if not data:
            return data

        if not self._first_try:
            return self._obj.decompress(data)

        self._data += data
        try:
            decompressed = self._obj.decompress(data)
            if decompressed:
                self._first_try = False
                self._data = None
            return decompressed
        except zlib.error:
            self._first_try = False
            self._obj = zlib.decompressobj(-zlib.MAX_WBITS)
            try:
                return self.decompress(self._data)
            finally:
                self._data = None


class GzipDecoderState(object):

    FIRST_MEMBER = 0
    OTHER_MEMBERS = 1
    SWALLOW_DATA = 2


class GzipDecoder(object):
    def __init__(self):
        self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)
        self._state = GzipDecoderState.FIRST_MEMBER

    def __getattr__(self, name):
        return getattr(self._obj, name)

    def decompress(self, data):
        ret = bytearray()
        if self._state == GzipDecoderState.SWALLOW_DATA or not data:
            return bytes(ret)
        while True:
            try:
                ret += self._obj.decompress(data)
            except zlib.error:
                previous_state = self._state
                # Ignore data after the first error
                self._state = GzipDecoderState.SWALLOW_DATA
                if previous_state == GzipDecoderState.OTHER_MEMBERS:
                    # Allow trailing garbage acceptable in other gzip clients
                    return bytes(ret)
                raise
            data = self._obj.unused_data
            if not data:
                return bytes(ret)
            self._state = GzipDecoderState.OTHER_MEMBERS
            self._obj = zlib.decompressobj(16 + zlib.MAX_WBITS)


if brotli is not None:

    class BrotliDecoder(object):
        # Supports both 'brotlipy' and 'Brotli' packages
        # since they share an import name. The top branches
        # are for 'brotlipy' and bottom branches for 'Brotli'
        def __init__(self):
            self._obj = brotli.Decompressor()

        def decompress(self, data):
            if hasattr(self._obj, "decompress"):
                return self._obj.decompress(data)
            return self._obj.process(data)

        def flush(self):
            if hasattr(self._obj, "flush"):
                return self._obj.flush()
            return b""


class MultiDecoder(object):
    """
    From RFC7231:
        If one or more encodings have been applied to a representation, the
        sender that applied the encodings MUST generate a Content-Encoding
        header field that lists the content codings in the order in which
        they were applied.
    """

    def __init__(self, modes):
        self._decoders = [_get_decoder(m.strip()) for m in modes.split(",")]

    def flush(self):
        return self._decoders[0].flush()

    def decompress(self, data):
        for d in reversed(self._decoders):
            data = d.decompress(data)
        return data


def _get_decoder(mode):
    if "," in mode:
        return MultiDecoder(mode)

    if mode == "gzip":
        return GzipDecoder()

    if brotli is not None and mode == "br":
        return BrotliDecoder()

    return DeflateDecoder()


class HTTPResponse(io.IOBase):
    """
    HTTP Response container.

    Backwards-compatible to httplib's HTTPResponse but the response ``body`` is
    loaded and decoded on-demand when the ``data`` property is accessed.  This
    class is also compatible with the Python standard library's :mod:`io`
    module, and can hence be treated as a readable object in the context of that
    framework.

    Extra parameters for behaviour not present in httplib.HTTPResponse:

    :param preload_content:
        If True, the response's body will be preloaded during construction.

    :param decode_content:
        If True, will attempt to decode the body based on the
        'content-encoding' header.

    :param original_response:
        When this HTTPResponse wrapper is generated from an httplib.HTTPResponse
        object, it's convenient to include the original for debug purposes. It's
        otherwise unused.

    :param retries:
        The retries contains the last :class:`~urllib3.util.retry.Retry` that
        was used during the request.

    :param enforce_content_length:
        Enforce content length checking. Body returned by server must match
        value of Content-Length header, if present. Otherwise, raise error.
    """

    CONTENT_DECODERS = ["gzip", "deflate"]
    if brotli is not None:
        CONTENT_DECODERS += ["br"]
    REDIRECT_STATUSES = [301, 302, 303, 307, 308]

    def __init__(
        self,
        body="",
        headers=None,
        status=0,
        version=0,
        reason=None,
        strict=0,
        preload_content=True,
        decode_content=True,
        original_response=None,
        pool=None,
        connection=None,
        msg=None,
        retries=None,
        enforce_content_length=False,
        request_method=None,
        request_url=None,
        auto_close=True,
    ):

        if isinstance(headers, HTTPHeaderDict):
            self.headers = headers
        else:
            self.headers = HTTPHeaderDict(headers)
        self.status = status
        self.version = version
        self.reason = reason
        self.strict = strict
        self.decode_content = decode_content
        self.retries = retries
        self.enforce_content_length = enforce_content_length
        self.auto_close = auto_close

        self._decoder = None
        self._body = None
        self._fp = None
        self._original_response = original_response
        self._fp_bytes_read = 0
        self.msg = msg
        self._request_url = request_url

        if body and isinstance(body, (basestring, bytes)):
            self._body = body

        self._pool = pool
        self._connection = connection

        if hasattr(body, "read"):
            self._fp = body

        # Are we using the chunked-style of transfer encoding?
        self.chunked = False
        self.chunk_left = None
        tr_enc = self.headers.get("transfer-encoding", "").lower()
        # Don't incur the penalty of creating a list and then discarding it
        encodings = (enc.strip() for enc in tr_enc.split(","))
        if "chunked" in encodings:
            self.chunked = True

        # Determine length of response
        self.length_remaining = self._init_length(request_method)

        # If requested, preload the body.
        if preload_content and not self._body:
            self._body = self.read(decode_content=decode_content)

    def get_redirect_location(self):
        """
        Should we redirect and where to?

        :returns: Truthy redirect location string if we got a redirect status
            code and valid location. ``None`` if redirect status and no
            location. ``False`` if not a redirect status code.
        """
        if self.status in self.REDIRECT_STATUSES:
            return self.headers.get("location")

        return False

    def release_conn(self):
        if not self._pool or not self._connection:
            return

        self._pool._put_conn(self._connection)
        self._connection = None

    @property
    def data(self):
        # For backwords-compat with earlier urllib3 0.4 and earlier.
        if self._body:
            return self._body

        if self._fp:
            return self.read(cache_content=True)

    @property
    def connection(self):
        return self._connection

    def isclosed(self):
        return is_fp_closed(self._fp)

    def tell(self):
        """
        Obtain the number of bytes pulled over the wire so far. May differ from
        the amount of content returned by :meth:``HTTPResponse.read`` if bytes
        are encoded on the wire (e.g, compressed).
        """
        return self._fp_bytes_read

    def _init_length(self, request_method):
        """
        Set initial length value for Response content if available.
        """
        length = self.headers.get("content-length")

        if length is not None:
            if self.chunked:
                # This Response will fail with an IncompleteRead if it can't be
                # received as chunked. This method falls back to attempt reading
                # the response before raising an exception.
                log.warning(
                    "Received response with both Content-Length and "
                    "Transfer-Encoding set. This is expressly forbidden "
                    "by RFC 7230 sec 3.3.2. Ignoring Content-Length and "
                    "attempting to process response as Transfer-Encoding: "
                    "chunked."
                )
                return None

            try:
                # RFC 7230 section 3.3.2 specifies multiple content lengths can
                # be sent in a single Content-Length header
                # (e.g. Content-Length: 42, 42). This line ensures the values
                # are all valid ints and that as long as the `set` length is 1,
                # all values are the same. Otherwise, the header is invalid.
                lengths = set([int(val) for val in length.split(",")])
                if len(lengths) > 1:
                    raise InvalidHeader(
                        "Content-Length contained multiple "
                        "unmatching values (%s)" % length
                    )
                length = lengths.pop()
            except ValueError:
                length = None
            else:
                if length < 0:
                    length = None

        # Convert status to int for comparison
        # In some cases, httplib returns a status of "_UNKNOWN"
        try:
            status = int(self.status)
        except ValueError:
            status = 0

        # Check for responses that shouldn't include a body
        if status in (204, 304) or 100 <= status < 200 or request_method == "HEAD":
            length = 0

        return length

    def _init_decoder(self):
        """
        Set-up the _decoder attribute if necessary.
        """
        # Note: content-encoding value should be case-insensitive, per RFC 7230
        # Section 3.2
        content_encoding = self.headers.get("content-encoding", "").lower()
        if self._decoder is None:
            if content_encoding in self.CONTENT_DECODERS:
                self._decoder = _get_decoder(content_encoding)
            elif "," in content_encoding:
                encodings = [
                    e.strip()
                    for e in content_encoding.split(",")
                    if e.strip() in self.CONTENT_DECODERS
                ]
                if len(encodings):
                    self._decoder = _get_decoder(content_encoding)

    DECODER_ERROR_CLASSES = (IOError, zlib.error)
    if brotli is not None:
        DECODER_ERROR_CLASSES += (brotli.error,)

    def _decode(self, data, decode_content, flush_decoder):
        """
        Decode the data passed in and potentially flush the decoder.
        """
        if not decode_content:
            return data

        try:
            if self._decoder:
                data = self._decoder.decompress(data)
        except self.DECODER_ERROR_CLASSES as e:
            content_encoding = self.headers.get("content-encoding", "").lower()
            raise DecodeError(
                "Received response with content-encoding: %s, but "
                "failed to decode it." % content_encoding,
                e,
            )
        if flush_decoder:
            data += self._flush_decoder()

        return data

    def _flush_decoder(self):
        """
        Flushes the decoder. Should only be called if the decoder is actually
        being used.
        """
        if self._decoder:
            buf = self._decoder.decompress(b"")
            return buf + self._decoder.flush()

        return b""

    @contextmanager
    def _error_catcher(self):
        """
        Catch low-level python exceptions, instead re-raising urllib3
        variants, so that low-level exceptions are not leaked in the
        high-level api.

        On exit, release the connection back to the pool.
        """
        clean_exit = False

        try:
            try:
                yield

            except SocketTimeout:
                # FIXME: Ideally we'd like to include the url in the ReadTimeoutError but
                # there is yet no clean way to get at it from this context.
                raise ReadTimeoutError(self._pool, None, "Read timed out.")

            except BaseSSLError as e:
                # FIXME: Is there a better way to differentiate between SSLErrors?
                if "read operation timed out" not in str(e):  # Defensive:
                    # This shouldn't happen but just in case we're missing an edge
                    # case, let's avoid swallowing SSL errors.
                    raise

                raise ReadTimeoutError(self._pool, None, "Read timed out.")

            except (HTTPException, SocketError) as e:
                # This includes IncompleteRead.
                raise ProtocolError("Connection broken: %r" % e, e)

            # If no exception is thrown, we should avoid cleaning up
            # unnecessarily.
            clean_exit = True
        finally:
            # If we didn't terminate cleanly, we need to throw away our
            # connection.
            if not clean_exit:
                # The response may not be closed but we're not going to use it
                # anymore so close it now to ensure that the connection is
                # released back to the pool.
                if self._original_response:
                    self._original_response.close()

                # Closing the response may not actually be sufficient to close
                # everything, so if we have a hold of the connection close that
                # too.
                if self._connection:
                    self._connection.close()

            # If we hold the original response but it's closed now, we should
            # return the connection back to the pool.
            if self._original_response and self._original_response.isclosed():
                self.release_conn()

    def read(self, amt=None, decode_content=None, cache_content=False):
        """
        Similar to :meth:`httplib.HTTPResponse.read`, but with two additional
        parameters: ``decode_content`` and ``cache_content``.

        :param amt:
            How much of the content to read. If specified, caching is skipped
            because it doesn't make sense to cache partial content as the full
            response.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.

        :param cache_content:
            If True, will save the returned data such that the same result is
            returned despite of the state of the underlying file object. This
            is useful if you want the ``.data`` property to continue working
            after having ``.read()`` the file object. (Overridden if ``amt`` is
            set.)
        """
        self._init_decoder()
        if decode_content is None:
            decode_content = self.decode_content

        if self._fp is None:
            return

        flush_decoder = False
        fp_closed = getattr(self._fp, "closed", False)

        with self._error_catcher():
            if amt is None:
                # cStringIO doesn't like amt=None
                data = self._fp.read() if not fp_closed else b""
                flush_decoder = True
            else:
                cache_content = False
                data = self._fp.read(amt) if not fp_closed else b""
                if (
                    amt != 0 and not data
                ):  # Platform-specific: Buggy versions of Python.
                    # Close the connection when no data is returned
                    #
                    # This is redundant to what httplib/http.client _should_
                    # already do.  However, versions of python released before
                    # December 15, 2012 (http://bugs.python.org/issue16298) do
                    # not properly close the connection in all cases. There is
                    # no harm in redundantly calling close.
                    self._fp.close()
                    flush_decoder = True
                    if self.enforce_content_length and self.length_remaining not in (
                        0,
                        None,
                    ):
                        # This is an edge case that httplib failed to cover due
                        # to concerns of backward compatibility. We're
                        # addressing it here to make sure IncompleteRead is
                        # raised during streaming, so all calls with incorrect
                        # Content-Length are caught.
                        raise IncompleteRead(self._fp_bytes_read, self.length_remaining)

        if data:
            self._fp_bytes_read += len(data)
            if self.length_remaining is not None:
                self.length_remaining -= len(data)

            data = self._decode(data, decode_content, flush_decoder)

            if cache_content:
                self._body = data

        return data

    def stream(self, amt=2 ** 16, decode_content=None):
        """
        A generator wrapper for the read() method. A call will block until
        ``amt`` bytes have been read from the connection or until the
        connection is closed.

        :param amt:
            How much of the content to read. The generator will return up to
            much data per iteration, but may return less. This is particularly
            likely when using compressed data. However, the empty string will
            never be returned.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.
        """
        if self.chunked and self.supports_chunked_reads():
            for line in self.read_chunked(amt, decode_content=decode_content):
                yield line
        else:
            while not is_fp_closed(self._fp):
                data = self.read(amt=amt, decode_content=decode_content)

                if data:
                    yield data

    @classmethod
    def from_httplib(ResponseCls, r, **response_kw):
        """
        Given an :class:`httplib.HTTPResponse` instance ``r``, return a
        corresponding :class:`urllib3.response.HTTPResponse` object.

        Remaining parameters are passed to the HTTPResponse constructor, along
        with ``original_response=r``.
        """
        headers = r.msg

        if not isinstance(headers, HTTPHeaderDict):
            if PY3:
                headers = HTTPHeaderDict(headers.items())
            else:
                # Python 2.7
                headers = HTTPHeaderDict.from_httplib(headers)

        # HTTPResponse objects in Python 3 don't have a .strict attribute
        strict = getattr(r, "strict", 0)
        resp = ResponseCls(
            body=r,
            headers=headers,
            status=r.status,
            version=r.version,
            reason=r.reason,
            strict=strict,
            original_response=r,
            **response_kw
        )
        return resp

    # Backwards-compatibility methods for httplib.HTTPResponse
    def getheaders(self):
        return self.headers

    def getheader(self, name, default=None):
        return self.headers.get(name, default)

    # Backwards compatibility for http.cookiejar
    def info(self):
        return self.headers

    # Overrides from io.IOBase
    def close(self):
        if not self.closed:
            self._fp.close()

        if self._connection:
            self._connection.close()

        if not self.auto_close:
            io.IOBase.close(self)

    @property
    def closed(self):
        if not self.auto_close:
            return io.IOBase.closed.__get__(self)
        elif self._fp is None:
            return True
        elif hasattr(self._fp, "isclosed"):
            return self._fp.isclosed()
        elif hasattr(self._fp, "closed"):
            return self._fp.closed
        else:
            return True

    def fileno(self):
        if self._fp is None:
            raise IOError("HTTPResponse has no file to get a fileno from")
        elif hasattr(self._fp, "fileno"):
            return self._fp.fileno()
        else:
            raise IOError(
                "The file-like object this HTTPResponse is wrapped "
                "around has no file descriptor"
            )

    def flush(self):
        if (
            self._fp is not None
            and hasattr(self._fp, "flush")
            and not getattr(self._fp, "closed", False)
        ):
            return self._fp.flush()

    def readable(self):
        # This method is required for `io` module compatibility.
        return True

    def readinto(self, b):
        # This method is required for `io` module compatibility.
        temp = self.read(len(b))
        if len(temp) == 0:
            return 0
        else:
            b[: len(temp)] = temp
            return len(temp)

    def supports_chunked_reads(self):
        """
        Checks if the underlying file-like object looks like a
        httplib.HTTPResponse object. We do this by testing for the fp
        attribute. If it is present we assume it returns raw chunks as
        processed by read_chunked().
        """
        return hasattr(self._fp, "fp")

    def _update_chunk_length(self):
        # First, we'll figure out length of a chunk and then
        # we'll try to read it from socket.
        if self.chunk_left is not None:
            return
        line = self._fp.fp.readline()
        line = line.split(b";", 1)[0]
        try:
            self.chunk_left = int(line, 16)
        except ValueError:
            # Invalid chunked protocol response, abort.
            self.close()
            raise httplib.IncompleteRead(line)

    def _handle_chunk(self, amt):
        returned_chunk = None
        if amt is None:
            chunk = self._fp._safe_read(self.chunk_left)
            returned_chunk = chunk
            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
            self.chunk_left = None
        elif amt < self.chunk_left:
            value = self._fp._safe_read(amt)
            self.chunk_left = self.chunk_left - amt
            returned_chunk = value
        elif amt == self.chunk_left:
            value = self._fp._safe_read(amt)
            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
            self.chunk_left = None
            returned_chunk = value
        else:  # amt > self.chunk_left
            returned_chunk = self._fp._safe_read(self.chunk_left)
            self._fp._safe_read(2)  # Toss the CRLF at the end of the chunk.
            self.chunk_left = None
        return returned_chunk

    def read_chunked(self, amt=None, decode_content=None):
        """
        Similar to :meth:`HTTPResponse.read`, but with an additional
        parameter: ``decode_content``.

        :param amt:
            How much of the content to read. If specified, caching is skipped
            because it doesn't make sense to cache partial content as the full
            response.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.
        """
        self._init_decoder()
        # FIXME: Rewrite this method and make it a class with a better structured logic.
        if not self.chunked:
            raise ResponseNotChunked(
                "Response is not chunked. "
                "Header 'transfer-encoding: chunked' is missing."
            )
        if not self.supports_chunked_reads():
            raise BodyNotHttplibCompatible(
                "Body should be httplib.HTTPResponse like. "
                "It should have have an fp attribute which returns raw chunks."
            )

        with self._error_catcher():
            # Don't bother reading the body of a HEAD request.
            if self._original_response and is_response_to_head(self._original_response):
                self._original_response.close()
                return

            # If a response is already read and closed
            # then return immediately.
            if self._fp.fp is None:
                return

            while True:
                self._update_chunk_length()
                if self.chunk_left == 0:
                    break
                chunk = self._handle_chunk(amt)
                decoded = self._decode(
                    chunk, decode_content=decode_content, flush_decoder=False
                )
                if decoded:
                    yield decoded

            if decode_content:
                # On CPython and PyPy, we should never need to flush the
                # decoder. However, on Jython we *might* need to, so
                # lets defensively do it anyway.
                decoded = self._flush_decoder()
                if decoded:  # Platform-specific: Jython.
                    yield decoded

            # Chunk content ends with \r\n: discard it.
            while True:
                line = self._fp.fp.readline()
                if not line:
                    # Some sites may not end with '\r\n'.
                    break
                if line == b"\r\n":
                    break

            # We read everything; close the "file".
            if self._original_response:
                self._original_response.close()

    def geturl(self):
        """
        Returns the URL that was the source of this response.
        If the request that generated this response redirected, this method
        will return the final redirect location.
        """
        if self.retries is not None and len(self.retries.history):
            return self.retries.history[-1].redirect_location
        else:
            return self._request_url

    def __iter__(self):
        buffer = [b""]
        for chunk in self.stream(decode_content=True):
            if b"\n" in chunk:
                chunk = chunk.split(b"\n")
                yield b"".join(buffer) + chunk[0] + b"\n"
                for x in chunk[1:-1]:
                    yield x + b"\n"
                if chunk[-1]:
                    buffer = [chunk[-1]]
                else:
                    buffer = []
            else:
                buffer.append(chunk)
        if buffer:
            yield b"".join(buffer)
site-packages/pip/_vendor/urllib3/__pycache__/fields.cpython-38.pyc000064400000017643151446177000021212 0ustar00U

��.ei!�@s�ddlmZddlZddlZddlZddlmZddd�Zdd	�Z	d
ddd�Z
e
�d
d�edd�D��dd�Z
dd�ZeZGdd�de�ZdS)�)�absolute_importN�)�six�application/octet-streamcCs|rt�|�dp|S|S)z�
    Guess the "Content-Type" of a file.

    :param filename:
        The filename to guess the "Content-Type" of using :mod:`mimetypes`.
    :param default:
        If no "Content-Type" can be guessed, default to `default`.
    r)�	mimetypesZ
guess_type)�filename�default�r	�>/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/fields.py�guess_content_type	s	rc	s�t�tj�r��d��t�fdd�dD��sdd|�f}z|�d�Wnttfk
r^YnX|Stjrt��d��t	j
��d��d|�f�tjr���d���S)a�
    Helper function to format and quote a single header parameter using the
    strategy defined in RFC 2231.

    Particularly useful for header parameters which might contain
    non-ASCII values, like file names. This follows RFC 2388 Section 4.4.

    :param name:
        The name of the parameter, a string expected to be ASCII only.
    :param value:
        The value of the parameter, provided as ``bytes`` or `str``.
    :ret:
        An RFC-2231-formatted unicode string.
    �utf-8c3s|]}|�kVqdS�Nr	)�.0Zch��valuer	r
�	<genexpr>)sz.format_header_param_rfc2231.<locals>.<genexpr>z"\
�%s="%s"�asciiz%s*=%s)�
isinstancer�binary_type�decode�any�encode�UnicodeEncodeError�UnicodeDecodeErrorZPY2�emailZutilsZencode_rfc2231)�namer�resultr	rr
�format_header_param_rfc2231s 


rz%22z\\)�"�\r cCs&i|]}|dkrt�|�d�|��qS))�z%{:02X})rZunichr�format)rZccr	r	r
�
<dictcomp>Is�r#� cs:�fdd�}t�d�dd����D���}|�||�}|S)Ncs�|�d�S)Nr)�group)�match��needles_and_replacementsr	r
�replacerRsz#_replace_multiple.<locals>.replacer�|cSsg|]}t�|��qSr	)�re�escape)rZneedler	r	r
�
<listcomp>Vsz%_replace_multiple.<locals>.<listcomp>)r+�compile�join�keys�sub)rr(r)�patternrr	r'r
�_replace_multipleQs�r3cCs,t|tj�r|�d�}t|t�}d||fS)a�
    Helper function to format and quote a single header parameter using the
    HTML5 strategy.

    Particularly useful for header parameters which might contain
    non-ASCII values, like file names. This follows the `HTML5 Working Draft
    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.

    .. _HTML5 Working Draft Section 4.10.22.7:
        https://w3c.github.io/html/sec-forms.html#multipart-form-data

    :param name:
        The name of the parameter, a string expected to be ASCII only.
    :param value:
        The value of the parameter, provided as ``bytes`` or `str``.
    :ret:
        A unicode string, stripped of troublesome characters.
    rr)rrrrr3�_HTML5_REPLACEMENTS)rrr	r	r
�format_header_param_html5^s

r5c@sReZdZdZddefdd�Zeefdd��Zdd�Zd	d
�Z	dd�Z
dd
d�ZdS)�RequestFielda
    A data container for request body parameters.

    :param name:
        The name of this request field. Must be unicode.
    :param data:
        The data/value body.
    :param filename:
        An optional filename of the request field. Must be unicode.
    :param headers:
        An optional dict-like object of headers to initially use for the field.
    :param header_formatter:
        An optional callable that is used to encode and format the headers. By
        default, this is :func:`format_header_param_html5`.
    NcCs0||_||_||_i|_|r&t|�|_||_dSr
)�_name�	_filename�data�headers�dict�header_formatter)�selfrr9rr:r<r	r	r
�__init__�s
zRequestField.__init__cCs`t|t�r4t|�dkr"|\}}}q@|\}}t|�}nd}d}|}|||||d�}|j|d�|S)a�
        A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.

        Supports constructing :class:`~urllib3.fields.RequestField` from
        parameter of key/value strings AND key/filetuple. A filetuple is a
        (filename, data, MIME type) tuple where the MIME type is optional.
        For example::

            'foo': 'bar',
            'fakefile': ('foofile.txt', 'contents of foofile'),
            'realfile': ('barfile.txt', open('realfile').read()),
            'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),
            'nonamefile': 'contents of nonamefile field',

        Field names and filenames must be unicode.
        �N)rr<)�content_type)r�tuple�lenr�make_multipart)�clsZ	fieldnamerr<rr9r@Z
request_paramr	r	r
�from_tuples�s 

�zRequestField.from_tuplescCs|�||�S)aI
        Overridable helper function to format a single header parameter. By
        default, this calls ``self.header_formatter``.

        :param name:
            The name of the parameter, a string expected to be ASCII only.
        :param value:
            The value of the parameter, provided as a unicode string.
        )r<)r=rrr	r	r
�_render_part�szRequestField._render_partcCsLg}|}t|t�r|��}|D]"\}}|dk	r|�|�||��qd�|�S)aO
        Helper function to format and quote a single header.

        Useful for single headers that are composed of multiple items. E.g.,
        'Content-Disposition' fields.

        :param header_parts:
            A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
            as `k1="v1"; k2="v2"; ...`.
        N�; )rr;�items�appendrFr/)r=Zheader_parts�parts�iterablerrr	r	r
�
_render_parts�s
zRequestField._render_partscCs�g}dddg}|D]*}|j�|d�r|�d||j|f�q|j��D]&\}}||krH|rH|�d||f�qH|�d�d�|�S)z=
        Renders the headers for this request field.
        �Content-Disposition�Content-Type�Content-LocationFz%s: %sz
)r:�getrIrHr/)r=�linesZ	sort_keysZsort_keyZheader_nameZheader_valuer	r	r
�render_headers�s

zRequestField.render_headerscCsX|pd|jd<|jdd�d|�d|jfd|jff�g�7<||jd<||jd<d	S)
a|
        Makes this request field into a multipart request field.

        This method overrides "Content-Disposition", "Content-Type" and
        "Content-Location" headers to the request parameter.

        :param content_type:
            The 'Content-Type' of the request body.
        :param content_location:
            The 'Content-Location' of the request body.

        z	form-datarMrG�rrrNrON)r:r/rLr7r8)r=Zcontent_dispositionr@Zcontent_locationr	r	r
rC�s���
zRequestField.make_multipart)NNN)�__name__�
__module__�__qualname__�__doc__r5r>�classmethodrErFrLrRrCr	r	r	r
r6}s�
#
�r6)r)Z
__future__rZemail.utilsrrr+Zpackagesrrrr4�update�ranger3r5Zformat_header_param�objectr6r	r	r	r
�<module>s&
*���	
site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-38.opt-1.pyc000064400000004045151446177000022432 0ustar00U

��.e{
�@s4dZddlmZddlZddlmZmZmZddlm	Z	ddl
mZddlm
Z
mZmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlZddlmZdZdZdZdZe� e!��"e��ej#fdd�Z$[ej%de	j&dd�ej%de	j'dd�ej%de	j(dd�ej%de	j)dd�e	j*fdd�Z+dS)z8
urllib3 - Thread-safe connection pooling and re-using.
�)�absolute_importN�)�HTTPConnectionPool�HTTPSConnectionPool�connection_from_url)�
exceptions)�encode_multipart_formdata)�PoolManager�ProxyManager�proxy_from_url)�HTTPResponse)�make_headers)�get_host)�Timeout)�Retry)�NullHandlerz(Andrey Petrov (andrey.petrov@shazow.net)ZMITz1.25.6)rrr	r
rrr�add_stderr_loggerr�disable_warningsrrr
rcCsFt�t�}t��}|�t�d��|�|�|�|�|�dt�|S)z�
    Helper for quickly adding a StreamHandler to the logger. Useful for
    debugging.

    Returns the handler after adding it.
    z%%(asctime)s %(levelname)s %(message)sz,Added a stderr logging handler to logger: %s)	�logging�	getLogger�__name__Z
StreamHandlerZsetFormatterZ	Formatter�
addHandlerZsetLevel�debug)�levelZloggerZhandler�r�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/__init__.pyr/s	


r�alwaysT)�append�defaultcCst�d|�dS)z<
    Helper for quickly disabling all urllib3 warnings.
    �ignoreN)�warnings�simplefilter)�categoryrrrrRsr),�__doc__Z
__future__rr Zconnectionpoolrrr�rZfilepostrZpoolmanagerr	r
rZresponserZutil.requestr
Zutil.urlrZutil.timeoutrZ
util.retryrrr�
__author__Z__license__�__version__�__all__rrr�DEBUGrr!ZSecurityWarningZSubjectAltNameWarningZInsecurePlatformWarningZSNIMissingWarningZHTTPWarningrrrrr�<module>s2site-packages/pip/_vendor/urllib3/__pycache__/poolmanager.cpython-38.pyc000064400000031150151446177000022235 0ustar00U

��.e�B�@sddlmZddlZddlZddlZddlmZddlmZm	Z	ddlm
Z
ddlmZm
Z
mZddlmZdd	lmZdd
lmZddlmZddlmZd
ddgZe�e�ZdZdZe�de�Z dd�Z!e�"e!e �e�"e!e �d�Z#ee	d�Z$Gdd
�d
e�Z%Gdd�de%�Z&dd�Z'dS)�)�absolute_importN�)�RecentlyUsedContainer)�HTTPConnectionPool�HTTPSConnectionPool)�port_by_scheme)�LocationValueError�
MaxRetryError�ProxySchemeUnknown)�six)�urljoin)�RequestMethods)�	parse_url)�Retry�PoolManager�ProxyManager�proxy_from_url)Zkey_fileZ	cert_fileZ	cert_reqsZca_certsZssl_versionZca_cert_dirZssl_contextZkey_password)Z
key_schemeZkey_hostZkey_portZkey_timeoutZkey_retriesZ
key_strictZ	key_blockZkey_source_addressZkey_key_fileZkey_key_passwordZ
key_cert_fileZ
key_cert_reqsZkey_ca_certsZkey_ssl_versionZkey_ca_cert_dirZkey_ssl_contextZkey_maxsizeZkey_headersZ
key__proxyZkey__proxy_headersZkey_socket_optionsZkey__socks_optionsZkey_assert_hostnameZkey_assert_fingerprintZkey_server_hostname�PoolKeycCs�|��}|d��|d<|d��|d<dD],}||kr,||dk	r,t||���||<q,|�d�}|dk	rxt|�|d<t|���D]}|�|�|d|<q�|j	D]}||kr�d||<q�|f|�S)a�
    Create a pool key out of a request context dictionary.

    According to RFC 3986, both the scheme and host are case-insensitive.
    Therefore, this function normalizes both before constructing the pool
    key for an HTTPS request. If you wish to change this behaviour, provide
    alternate callables to ``key_fn_by_scheme``.

    :param key_class:
        The class to use when constructing the key. This should be a namedtuple
        with the ``scheme`` and ``host`` keys at a minimum.
    :type  key_class: namedtuple
    :param request_context:
        A dictionary-like object that contain the context for a request.
    :type  request_context: dict

    :return: A namedtuple that can be used as a connection pool key.
    :rtype:  PoolKey
    �scheme�host)�headers�_proxy_headersZ_socks_optionsNZsocket_optionsZkey_)
�copy�lower�	frozenset�items�get�tuple�list�keys�pop�_fields)Z	key_class�request_context�context�keyZsocket_optsZfield�r%�C/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/poolmanager.py�_default_key_normalizerDs


r'��http�httpsc@sxeZdZdZdZddd�Zdd�Zdd	�Zdd
d�Zdd
�Z	ddd�Z
dd�Zddd�Zd dd�Z
dd�Zd!dd�ZdS)"ra$
    Allows for arbitrary requests while transparently keeping track of
    necessary connection pools for you.

    :param num_pools:
        Number of connection pools to cache before discarding the least
        recently used pool.

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.

    :param \**connection_pool_kw:
        Additional parameters are used to create fresh
        :class:`urllib3.connectionpool.ConnectionPool` instances.

    Example::

        >>> manager = PoolManager(num_pools=2)
        >>> r = manager.request('GET', 'http://google.com/')
        >>> r = manager.request('GET', 'http://google.com/mail')
        >>> r = manager.request('GET', 'http://yahoo.com/')
        >>> len(manager.pools)
        2

    N�
cKs8t�||�||_t|dd�d�|_t|_t��|_dS)NcSs|��S�N)�close)�pr%r%r&�<lambda>��z&PoolManager.__init__.<locals>.<lambda>)Zdispose_func)r
�__init__�connection_pool_kwr�pools�pool_classes_by_scheme�key_fn_by_schemer)�self�	num_poolsrr2r%r%r&r1�s
zPoolManager.__init__cCs|Sr,r%�r6r%r%r&�	__enter__�szPoolManager.__enter__cCs|��dS)NF)�clear)r6�exc_typeZexc_valZexc_tbr%r%r&�__exit__�szPoolManager.__exit__cCs^|j|}|dkr|j��}dD]}|�|d�q |dkrPtD]}|�|d�q>|||f|�S)a�
        Create a new :class:`ConnectionPool` based on host, port, scheme, and
        any additional pool keyword arguments.

        If ``request_context`` is provided, it is provided as keyword arguments
        to the pool class used. This method is used to actually create the
        connection pools handed out by :meth:`connection_from_url` and
        companion methods. It is intended to be overridden for customization.
        N)rr�portr))r4r2rr �SSL_KEYWORDS)r6rrr=r"Zpool_clsr$�kwr%r%r&�	_new_pool�s


zPoolManager._new_poolcCs|j��dS)z�
        Empty our store of pools and direct them all to close.

        This will not affect in-flight connections, but they will not be
        re-used after completion.
        N)r3r:r8r%r%r&r:�szPoolManager.clearr)cCsT|std��|�|�}|pd|d<|s:t�|d��d�}||d<||d<|�|�S)a�
        Get a :class:`ConnectionPool` based on the host, port, and scheme.

        If ``port`` isn't given, it will be derived from the ``scheme`` using
        ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is
        provided, it is merged with the instance's ``connection_pool_kw``
        variable and used to create the new connection pool, if one is
        needed.
        zNo host specified.r)r�Pr=r)r�_merge_pool_kwargsrrr�connection_from_context)r6rr=r�pool_kwargsr"r%r%r&�connection_from_host�s
z PoolManager.connection_from_hostcCs,|d��}|j|}||�}|j||d�S)z�
        Get a :class:`ConnectionPool` based on the request context.

        ``request_context`` must at least contain the ``scheme`` key and its
        value must be a key in ``key_fn_by_scheme`` instance variable.
        r�r")rr5�connection_from_pool_key)r6r"rZpool_key_constructor�pool_keyr%r%r&rC�s
z#PoolManager.connection_from_contextc
Csl|jj�Z|j�|�}|r*|W5QR�S|d}|d}|d}|j||||d�}||j|<W5QRX|S)z�
        Get a :class:`ConnectionPool` based on the provided pool key.

        ``pool_key`` should be a namedtuple that only contains immutable
        objects. At a minimum it must have the ``scheme``, ``host``, and
        ``port`` fields.
        rrr=rF)r3�lockrr@)r6rHr"Zpoolrrr=r%r%r&rG�s
z$PoolManager.connection_from_pool_keycCs t|�}|j|j|j|j|d�S)a�
        Similar to :func:`urllib3.connectionpool.connection_from_url`.

        If ``pool_kwargs`` is not provided and a new pool needs to be
        constructed, ``self.connection_pool_kw`` is used to initialize
        the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs``
        is provided, it is used instead. Note that if a new pool does not
        need to be created for the request, the provided ``pool_kwargs`` are
        not used.
        )r=rrD)rrErr=r)r6�urlrD�ur%r%r&�connection_from_urls�zPoolManager.connection_from_urlc	CsV|j��}|rR|��D]:\}}|dkrHz
||=WqPtk
rDYqPXq|||<q|S)a
        Merge a dictionary of override values for self.connection_pool_kw.

        This does not modify self.connection_pool_kw and returns a new dict.
        Any keys in the override dictionary with a value of ``None`` are
        removed from the merged dictionary.
        N)r2rr�KeyError)r6�overrideZbase_pool_kwargsr$�valuer%r%r&rB!s


zPoolManager._merge_pool_kwargsTcKs�t|�}|j|j|j|jd�}d|d<d|d<d|krD|j��|d<|jdk	rj|jdkrj|j||f|�}n|j||j	f|�}|o�|�
�}|s�|St||�}|jdkr�d	}|�
d
�}	t|	t�s�tj|	|d�}	|	j�r|�|��stt�|d��}
|
D]"}|��|	jkr�|d�|d�q�z|	j||||d�}	Wn$tk
�rR|	j�rJ�|YSX|	|d
<||d<t�d
||�|j||f|�S)a]
        Same as :meth:`urllib3.connectionpool.HTTPConnectionPool.urlopen`
        with custom cross-host redirect logic and only sends the request-uri
        portion of the ``url``.

        The given ``url`` parameter must be absolute, such that an appropriate
        :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
        )r=rFZassert_same_host�redirectrNr)i/ZGET�retries)rP)�responseZ_poolzRedirecting %s -> %s)rrErr=rrr�proxy�urlopenZrequest_uriZget_redirect_locationrZstatusr�
isinstancerZfrom_intZremove_headers_on_redirectZis_same_hostrrZiterkeysrr Z	incrementr	Zraise_on_redirect�log�info)r6�methodrJrPr?rKZconnrRZredirect_locationrQr�headerr%r%r&rT5sF	



�
zPoolManager.urlopen)r+N)N)Nr)N)N)N)T)�__name__�
__module__�__qualname__�__doc__rSr1r9r<r@r:rErCrGrLrBrTr%r%r%r&r�s


	


csHeZdZdZd�fdd�	Zd�fdd�	Zdd	d
�Zd�fdd
�	Z�ZS)rax
    Behaves just like :class:`PoolManager`, but sends all requests through
    the defined proxy, using the CONNECT method for HTTPS URLs.

    :param proxy_url:
        The URL of the proxy to be used.

    :param proxy_headers:
        A dictionary containing headers that will be sent to the proxy. In case
        of HTTP they are being sent with each request, while in the
        HTTPS/CONNECT case they are sent only once. Could be used for proxy
        authentication.

    Example:
        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
        >>> r1 = proxy.request('GET', 'http://google.com/')
        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
        >>> len(proxy.pools)
        1
        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
        >>> r4 = proxy.request('GET', 'https://twitter.com/')
        >>> len(proxy.pools)
        3

    r+Ncs�t|t�rd|j|j|jf}t|�}|jsFt�|jd�}|j|d�}|jdkrZt	|j��||_
|pfi|_|j
|d<|j|d<tt
|�j||f|�dS)Nz
%s://%s:%irA)r=r(�_proxyr)rUrrrr=rrr�_replacer
rS�
proxy_headers�superrr1)r6�	proxy_urlr7rr`r2rSr=��	__class__r%r&r1�s"	
�




zProxyManager.__init__r)csD|dkr tt|�j||||d�Stt|�j|jj|jj|jj|d�S)Nr*)rD)rarrErSrr=r)r6rr=rrDrcr%r&rE�s
�
�z!ProxyManager.connection_from_hostcCs0ddi}t|�j}|r||d<|r,|�|�|S)z�
        Sets headers needed by proxies: specifically, the Accept and Host
        headers. Only sets headers not provided by the user.
        ZAcceptz*/*ZHost)r�netloc�update)r6rJrZheaders_rer%r%r&�_set_proxy_headers�s

zProxyManager._set_proxy_headersTcsNt|�}|jdkr0|�d|j�}|�||�|d<tt|�j||fd|i|��S)z@Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute.r)rrP)rrrrrgrarrT)r6rXrJrPr?rKrrcr%r&rT�s

zProxyManager.urlopen)r+NN)Nr)N)N)T)	rZr[r\r]r1rErgrT�
__classcell__r%r%rcr&rts�

cKstfd|i|��S)Nrb)r)rJr?r%r%r&r�s)(Z
__future__r�collections�	functoolsZlogging�_collectionsrZconnectionpoolrrr�
exceptionsrr	r
ZpackagesrZpackages.six.moves.urllib.parserZrequestr
Zutil.urlrZ
util.retryr�__all__Z	getLoggerrZrVr>Z_key_fields�
namedtuplerr'�partialr5r4rrrr%r%r%r&�<module>s4


6

�
tasite-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-38.pyc000064400000005256151446177000021566 0ustar00U

��.e�	�@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZe�
d�d	Zd
d�Zdd
�Zdd�Zddd�ZdS)�)�absolute_importN)�BytesIO�)�six)�b)�RequestFieldzutf-8�cCs$t�t�d��}tjs |�d�}|S)zN
    Our embarrassingly-simple replacement for mimetools.choose_boundary.
    ��ascii)�binasciiZhexlify�os�urandomrZPY2�decode)�boundary�r�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/filepost.py�choose_boundarys
rccsJt|t�rt�|�}nt|�}|D]"}t|t�r8|Vq"tj|�Vq"dS)z�
    Iterate over fields.

    Supports list of (k, v) tuples and dicts, and lists of
    :class:`~urllib3.fields.RequestField`.

    N)�
isinstance�dictr�	iteritems�iterrZfrom_tuples)�fields�i�fieldrrr�iter_field_objectss

rcCs,t|t�rdd�t�|�D�Sdd�|D�S)a-
    .. deprecated:: 1.6

    Iterate over fields.

    The addition of :class:`~urllib3.fields.RequestField` makes this function
    obsolete. Instead, use :func:`iter_field_objects`, which returns
    :class:`~urllib3.fields.RequestField` objects.

    Supports list of (k, v) tuples and dicts.
    css|]\}}||fVqdS�Nr��.0�k�vrrr�	<genexpr>:sziter_fields.<locals>.<genexpr>css|]\}}||fVqdSrrrrrrr <s)rrrr)rrrr�iter_fields-s
r!cCs�t�}|dkrt�}t|�D]p}|�td|��t|��|���|j}t|t	�r\t
|�}t|tj�rxt|��|�n
|�|�|�d�q|�td|��t
d|�}|�
�|fS)aQ
    Encode a dictionary of ``fields`` using the multipart/form-data MIME format.

    :param fields:
        Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).

    :param boundary:
        If not specified, then a random boundary will be generated using
        :func:`urllib3.filepost.choose_boundary`.
    Nz--%s
s
z--%s--
z multipart/form-data; boundary=%s)rrr�writer�writerZrender_headers�datar�int�strrZ	text_type�getvalue)rrZbodyrr$Zcontent_typerrr�encode_multipart_formdata?s 

r()N)Z
__future__rr�codecsr�iorZpackagesrZpackages.sixrrr�lookupr#rrr!r(rrrr�<module>s
site-packages/pip/_vendor/urllib3/__pycache__/request.cpython-38.opt-1.pyc000064400000012766151446177000022374 0ustar00U

��.e��@s>ddlmZddlmZddlmZdgZGdd�de�ZdS)�)�absolute_import�)�encode_multipart_formdata)�	urlencode�RequestMethodsc@sNeZdZdZddddhZddd�Zdd
d�Zddd
�Zddd�Zddd�Z	dS)ra�
    Convenience mixin for classes who implement a :meth:`urlopen` method, such
    as :class:`~urllib3.connectionpool.HTTPConnectionPool` and
    :class:`~urllib3.poolmanager.PoolManager`.

    Provides behavior for making common types of HTTP request methods and
    decides which type of request field encoding to use.

    Specifically,

    :meth:`.request_encode_url` is for sending requests whose fields are
    encoded in the URL (such as GET, HEAD, DELETE).

    :meth:`.request_encode_body` is for sending requests whose fields are
    encoded in the *body* of the request using multipart or www-form-urlencoded
    (such as for POST, PUT, PATCH).

    :meth:`.request` is for making any kind of request, it will look up the
    appropriate encoding format and use one of the above two methods to make
    the request.

    Initializer parameters:

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.
    ZDELETEZGETZHEADZOPTIONSNcCs|pi|_dS)N)�headers)�selfr�r	�?/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/request.py�__init__)szRequestMethods.__init__TcKstd��dS)NzMClasses extending RequestMethods must implement their own ``urlopen`` method.)�NotImplementedError)r�method�url�bodyr�encode_multipart�multipart_boundary�kwr	r	r
�urlopen,s
�zRequestMethods.urlopencKsR|��}||d<||jkr4|j||f||d�|��S|j||f||d�|��SdS)a�
        Make a request using :meth:`urlopen` with the appropriate encoding of
        ``fields`` based on the ``method`` used.

        This is a convenience method that requires the least amount of manual
        effort. It can be used in most situations, while still having the
        option to drop down to more specific methods when necessary, such as
        :meth:`request_encode_url`, :meth:`request_encode_body`,
        or even the lowest level :meth:`urlopen`.
        Zrequest_url)�fieldsrN)�upper�_encode_url_methods�request_encode_url�request_encode_body)rr
rrr�
urlopen_kwr	r	r
�request;s*
������zRequestMethods.requestcKsD|dkr|j}d|i}|�|�|r4|dt|�7}|j||f|�S)z�
        Make a request using :meth:`urlopen` with the ``fields`` encoded in
        the url. This is useful for request methods like GET, HEAD, DELETE, etc.
        Nr�?)r�updaterr)rr
rrrr�extra_kwr	r	r
rSs
z!RequestMethods.request_encode_urlcKs�|dkr|j}dii}|rbd|kr*td��|r@t||d�\}	}
nt|�d}	}
|	|d<d|
i|d<|d�|�|�|�|j||f|�S)a�
        Make a request using :meth:`urlopen` with the ``fields`` encoded in
        the body. This is useful for request methods like POST, PUT, PATCH, etc.

        When ``encode_multipart=True`` (default), then
        :meth:`urllib3.filepost.encode_multipart_formdata` is used to encode
        the payload with the appropriate content type. Otherwise
        :meth:`urllib.urlencode` is used with the
        'application/x-www-form-urlencoded' content type.

        Multipart encoding must be used when posting files, and it's reasonably
        safe to use it in other times too. However, it may break request
        signing, such as with OAuth.

        Supports an optional ``fields`` parameter of key/value strings AND
        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
        the MIME type is optional. For example::

            fields = {
                'foo': 'bar',
                'fakefile': ('foofile.txt', 'contents of foofile'),
                'realfile': ('barfile.txt', open('realfile').read()),
                'typedfile': ('bazfile.bin', open('bazfile').read(),
                              'image/jpeg'),
                'nonamefile': 'contents of nonamefile field',
            }

        When uploading a file, providing a filename (the first parameter of the
        tuple) is optional but recommended to best mimic behavior of browsers.

        Note that if ``headers`` are supplied, the 'Content-Type' header will
        be overwritten because it depends on the dynamic random boundary string
        which is used to compose the body of the request. The random boundary
        string can be explicitly set with the ``multipart_boundary`` parameter.
        NrrzFrequest got values for both 'fields' and 'body', can only specify one.)�boundaryz!application/x-www-form-urlencodedzContent-Type)r�	TypeErrorrrrr)rr
rrrrrrrrZcontent_typer	r	r
rcs*-���
z"RequestMethods.request_encode_body)N)NNTN)NN)NN)NNTN)
�__name__�
__module__�__qualname__�__doc__rrrrrrr	r	r	r
r
s
�


�N)	Z
__future__rZfilepostrZpackages.six.moves.urllib.parser�__all__�objectrr	r	r	r
�<module>ssite-packages/pip/_vendor/urllib3/__pycache__/connectionpool.cpython-38.pyc000064400000056730151446177000022775 0ustar00U

��.e^��@s�ddlmZddlZddlZddlZddlZddlmZm	Z
ddlZddlmZm
Z
mZmZmZmZmZmZmZmZmZmZmZddlmZddlmZddlmZdd	lm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&dd
l'm(Z(ddl)m*Z*ddl+m,Z,dd
l-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6m7Z7m8Z8m9Z:m;Z;ddl<m=Z=ej>j?Z?e�@eA�ZBeC�ZDGdd�deC�ZEejFejGhZHGdd�deEe(�ZIGdd�deI�ZJdd�ZKdd�Z9dS)�)�absolute_importN)�error�timeout�)
�ClosedPoolError�
ProtocolError�EmptyPoolError�HeaderParsingError�HostChangedError�LocationValueError�
MaxRetryError�
ProxyError�ReadTimeoutError�SSLError�TimeoutError�InsecureRequestWarning�NewConnectionError)�CertificateError)�six)�queue)�port_by_scheme�DummyConnection�HTTPConnection�HTTPSConnection�VerifiedHTTPSConnection�
HTTPException�BaseSSLError)�RequestMethods)�HTTPResponse)�is_connection_dropped)�set_file_position)�assert_header_parsing)�Retry)�Timeout)�get_host�	parse_url�Url�_normalize_host�_encode_target)�	LifoQueuec@sBeZdZdZdZeZd
dd�Zdd�Zdd�Z	d	d
�Z
dd�ZdS)�ConnectionPoolzz
    Base class for all connection pools, such as
    :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
    NcCs0|std��t||jd�|_|��|_||_dS)NzNo host specified.��scheme)rr'r,�host�lower�_proxy_host�port)�selfr-r0�r2�F/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/connectionpool.py�__init__Is

zConnectionPool.__init__cCsdt|�j|j|jfS)Nz%s(host=%r, port=%r))�type�__name__r-r0�r1r2r2r3�__str__QszConnectionPool.__str__cCs|S�Nr2r7r2r2r3�	__enter__TszConnectionPool.__enter__cCs|��dS)NF)�close)r1�exc_typeZexc_valZexc_tbr2r2r3�__exit__WszConnectionPool.__exit__cCsdS)�D
        Close all pooled connections and disable the pool.
        Nr2r7r2r2r3r;\szConnectionPool.close)N)r6�
__module__�__qualname__�__doc__r,r)�QueueClsr4r8r:r=r;r2r2r2r3r*@s
r*c
@s�eZdZdZdZeZeZdde	j
ddddddf	dd�Zdd	�Zd!d
d�Z
dd
�Zdd�Zdd�Zdd�Zdd�Zedfdd�Zdd�Zdd�Zdd�Zdddddeddddf
dd �ZdS)"�HTTPConnectionPoolaN	
    Thread-safe connection pool for one host.

    :param host:
        Host used for this HTTP Connection (e.g. "localhost"), passed into
        :class:`httplib.HTTPConnection`.

    :param port:
        Port used for this HTTP Connection (None is equivalent to 80), passed
        into :class:`httplib.HTTPConnection`.

    :param strict:
        Causes BadStatusLine to be raised if the status line can't be parsed
        as a valid HTTP/1.0 or 1.1 status line, passed into
        :class:`httplib.HTTPConnection`.

        .. note::
           Only works in Python 2. This parameter is ignored in Python 3.

    :param timeout:
        Socket timeout in seconds for each individual connection. This can
        be a float or integer, which sets the timeout for the HTTP request,
        or an instance of :class:`urllib3.util.Timeout` which gives you more
        fine-grained control over request timeouts. After the constructor has
        been parsed, this is always a `urllib3.util.Timeout` object.

    :param maxsize:
        Number of connections to save that can be reused. More than 1 is useful
        in multithreaded situations. If ``block`` is set to False, more
        connections will be created but they will not be saved once they've
        been used.

    :param block:
        If set to True, no more than ``maxsize`` connections will be used at
        a time. When no free connections are available, the call will block
        until a connection has been released. This is a useful side effect for
        particular multithreaded situations where one does not want to use more
        than maxsize connections per host to prevent flooding.

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.

    :param retries:
        Retry configuration to use by default with requests in this pool.

    :param _proxy:
        Parsed proxy URL, should not be used directly, instead, see
        :class:`urllib3.connectionpool.ProxyManager`"

    :param _proxy_headers:
        A dictionary with proxy headers, should not be used directly,
        instead, see :class:`urllib3.connectionpool.ProxyManager`"

    :param \**conn_kw:
        Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
        :class:`urllib3.connection.HTTPSConnection` instances.
    �httpNFrc
Ks�t�|||�t�||�||_t|t�s4t�|�}|dkrBtj}||_	||_
|�|�|_||_
|	|_|
pli|_t|�D]}|j�d�qxd|_d|_||_|jr�|j�dg�dS)NrZsocket_options)r*r4r�strict�
isinstancer#�
from_floatr"ZDEFAULTr�retriesrB�pool�block�proxy�
proxy_headers�xrange�put�num_connections�num_requests�conn_kw�
setdefault)
r1r-r0rEr�maxsizerJ�headersrH�_proxy�_proxy_headersrQ�_r2r2r3r4�s(


zHTTPConnectionPool.__init__cCsR|jd7_t�d|j|j|jp$d�|jf|j|j|jj|jd�|j	��}|S)z9
        Return a fresh :class:`HTTPConnection`.
        rz(Starting new HTTP connection (%d): %s:%sZ80)r-r0rrE)
rO�log�debugr-r0�
ConnectionClsr�connect_timeoutrErQ�r1�connr2r2r3�	_new_conn�s ���zHTTPConnectionPool._new_conncCs�d}z|jj|j|d�}WnBtk
r8t|d��Yn&tjk
r\|jrXt|d��YnX|r�t|�r�t	�
d|j�|��t
|dd�dkr�d}|p�|��S)	a�
        Get a connection. Will return a pooled connection if one is available.

        If no connections are available and :prop:`.block` is ``False``, then a
        fresh connection is returned.

        :param timeout:
            Seconds to wait before giving up and raising
            :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
            :prop:`.block` is ``True``.
        N)rJrzPool is closed.z>Pool reached maximum size and no more connections are allowed.z Resetting dropped connection: %sZ	auto_openrr)rI�getrJ�AttributeErrorrr�EmptyrrrXrYr-r;�getattrr^)r1rr]r2r2r3�	_get_conn�s$�zHTTPConnectionPool._get_conncCs^z|jj|dd�WdStk
r*Yn$tjk
rLt�d|j�YnX|rZ|��dS)a�
        Put a connection back into the pool.

        :param conn:
            Connection object for the current host and port as returned by
            :meth:`._new_conn` or :meth:`._get_conn`.

        If the pool is already full, the connection is closed and discarded
        because we exceeded maxsize. If connections are discarded frequently,
        then maxsize should be increased.

        If the pool is closed, then the connection will be closed and discarded.
        F�rJNz2Connection pool is full, discarding connection: %s)	rIrNr`rZFullrX�warningr-r;r\r2r2r3�	_put_connszHTTPConnectionPool._put_conncCsdS)�U
        Called right before a request is made, after the socket is created.
        Nr2r\r2r2r3�_validate_conn0sz!HTTPConnectionPool._validate_conncCsdSr9r2r\r2r2r3�_prepare_proxy6sz!HTTPConnectionPool._prepare_proxycCs2|tkr|j��St|t�r$|��St�|�SdS)z< Helper that always returns a :class:`urllib3.util.Timeout` N)�_DefaultrZclonerFr#rG)r1rr2r2r3�_get_timeout:s


zHTTPConnectionPool._get_timeoutcCsjt|t�rt||d|��t|d�r>|jtkr>t||d|��dt|�ksVdt|�krft||d|��dS)zAIs the error actually a timeout? Will raise a ReadTimeout or pass�!Read timed out. (read timeout=%s)�errnoz	timed outzdid not complete (read)N)rF�
SocketTimeoutr�hasattrrm�_blocking_errnos�str)r1�err�url�
timeout_valuer2r2r3�_raise_timeoutFs(
����z!HTTPConnectionPool._raise_timeoutc

Ks|jd7_|�|�}|��|j|_z|�|�Wn:ttfk
rp}z|j|||jd��W5d}~XYnX|r�|j	||f|�n|j
||f|�|j}	t|dd�r�|	dkr�t
||d|	��|	tjkr�|j�t���n|j�|	�zjz|jdd�}
WnTtk
�rPz|��}
Wn0tk
�rJ}zt�|d�W5d}~XYnXYnXWn<tttfk
�r�}z|j|||	d��W5d}~XYnXt|d	d
�}t�d|j|j|j||||
j|
j �	zt!|
j"�Wn@t#tfk
�r}ztj$d|�%|�|dd
�W5d}~XYnX|
S)a
        Perform a request on a given urllib connection object taken from our
        pool.

        :param conn:
            a connection from one of our connection pools

        :param timeout:
            Socket timeout in seconds for the request. This can be a
            float or integer, which will set the same timeout value for
            the socket connect and the socket read, or an instance of
            :class:`urllib3.util.Timeout`, which gives you more fine-grained
            control over your timeouts.
        r)rrrsrtN�sockrrlT)�	bufferingZ
_http_vsn_strzHTTP/?z%s://%s:%s "%s %s %s" %s %sz$Failed to parse headers (url=%s): %s)�exc_info)&rPrkZ
start_connectr[rrhrnrruZrequest_chunked�request�read_timeoutrbrr#�DEFAULT_TIMEOUTrvZ
settimeout�socketZgetdefaulttimeoutZgetresponse�	TypeError�
BaseExceptionrZ
raise_from�SocketErrorrXrYr,r-r0�statusZlengthr!�msgr	re�
_absolute_url)
r1r]�methodrsr�chunkedZhttplib_request_kw�timeout_obj�erz�httplib_responseZhttp_versionZhper2r2r3�
_make_request_sp
�
(��z HTTPConnectionPool._make_requestcCst|j|j|j|d�jS)N)r,r-r0�path)r&r,r-r0rs)r1r�r2r2r3r��sz HTTPConnectionPool._absolute_urlcCsV|jdkrdS|jd}|_z|jdd�}|r|��qWntjk
rPYnXdS)r>NFrd)rIr_r;rra)r1Zold_poolr]r2r2r3r;�s
zHTTPConnectionPool.closecCsx|�d�rdSt|�\}}}|dk	r0t||d�}|jrF|sFt�|�}n|js^|t�|�kr^d}|||f|j|j|jfkS)zj
        Check if the given ``url`` is a member of the same host as this
        connection pool.
        �/TNr+)�
startswithr$r'r0rr_r,r-)r1rsr,r-r0r2r2r3�is_same_host�s

zHTTPConnectionPool.is_same_hostTc
Ks|dkr|j}t|t�s*tj|||jd�}|
dkr>|
�dd�}
|rX|�|�sXt|||��|�d�rrt	�
t|��}nt	�
t|�j
�}d}|
}|jdkr�|��}|�|j�d}d}t||�}�ztz�|�|�}|j|	d�}|j|_|jdk	o�t|d	d�}|�r|�|�|j|||||||d
�}|
�s(|nd}||
d<|jj|f|||d�|
��}d}Wn�tj k
�rxt!|d
��Yn�t"t#t$t%t&t't(fk
�r,}z�d}t|t&t(f��r�t'|�}n>t|t$t)f��r�|j�r�t*d|�}nt|t$t#f��r�t%d|�}|j+||||t,�-�dd�}|�.�|}W5d}~XYnXW5|�sJ|�oD|��}d}|�rZ|�|�X|�s�t/�0d|||�|j1|||||||f||	|
|d�|
��Sdd�}|�o�|�2�}|�rR|j3dk�r�d}z|j+||||d�}Wn,t4k
�r|j5�r||��|YSX||�|�6|�t/�7d||�|j1||||f|||||	|
|d�|
��St8|�9d��}|�:||j3|��r�z|j+||||d�}Wn,t4k
�r�|j;�r�||��|YSX||�|�.|�t/�7d|�|j1||||f|||||	|
|d�|
��S|S)a�
        Get a connection from the pool and perform an HTTP request. This is the
        lowest level call for making a request, so you'll need to specify all
        the raw details.

        .. note::

           More commonly, it's appropriate to use a convenience method provided
           by :class:`.RequestMethods`, such as :meth:`request`.

        .. note::

           `release_conn` will only behave as expected if
           `preload_content=False` because we want to make
           `preload_content=False` the default behaviour someday soon without
           breaking backwards compatibility.

        :param method:
            HTTP request method (such as GET, POST, PUT, etc.)

        :param body:
            Data to send in the request body (useful for creating
            POST requests, see HTTPConnectionPool.post_url for
            more convenience).

        :param headers:
            Dictionary of custom headers to send, such as User-Agent,
            If-None-Match, etc. If None, pool headers are used. If provided,
            these headers completely replace any pool-specific headers.

        :param retries:
            Configure the number of retries to allow before raising a
            :class:`~urllib3.exceptions.MaxRetryError` exception.

            Pass ``None`` to retry until you receive a response. Pass a
            :class:`~urllib3.util.retry.Retry` object for fine-grained control
            over different types of retries.
            Pass an integer number to retry connection errors that many times,
            but no other types of errors. Pass zero to never retry.

            If ``False``, then retries are disabled and any exception is raised
            immediately. Also, instead of raising a MaxRetryError on redirects,
            the redirect response will be returned.

        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.

        :param redirect:
            If True, automatically handle redirects (status codes 301, 302,
            303, 307, 308). Each redirect counts as a retry. Disabling retries
            will disable redirect, too.

        :param assert_same_host:
            If ``True``, will make sure that the host of the pool requests is
            consistent else will raise HostChangedError. When False, you can
            use the pool on an HTTP proxy and request foreign hosts.

        :param timeout:
            If specified, overrides the default timeout for this one
            request. It may be a float (in seconds) or an instance of
            :class:`urllib3.util.Timeout`.

        :param pool_timeout:
            If set and the pool is set to block=True, then this method will
            block for ``pool_timeout`` seconds and raise EmptyPoolError if no
            connection is available within the time period.

        :param release_conn:
            If False, then the urlopen call will not release the connection
            back into the pool once a response is received (but will release if
            you read the entire contents of the response such as when
            `preload_content=True`). This is useful if you're not preloading
            the response's content immediately. You will need to call
            ``r.release_conn()`` on the response ``r`` to return the connection
            back into the pool. If None, it takes the value of
            ``response_kw.get('preload_content', True)``.

        :param chunked:
            If True, urllib3 will send the body using chunked transfer
            encoding. Otherwise, urllib3 will send the body using the standard
            content-length form. Defaults to False.

        :param int body_pos:
            Position to seek to in file-like body in the event of a retry or
            redirect. Typically this won't need to be set because urllib3 will
            auto-populate the value when needed.

        :param \**response_kw:
            Additional parameters are passed to
            :meth:`urllib3.response.HTTPResponse.from_httplib`
        N)�redirect�defaultZpreload_contentTr�rDF)rrv)r�bodyrTr�Zrequest_method)rI�
connectionrHz"No pool connections are available.zCannot connect to proxy.zConnection aborted.�)r�_poolZ_stacktracez1Retrying (%r) after connection broken by '%r': %s)r�pool_timeout�release_conn�body_posc
Ss2z|��Wn ttttttfk
r,YnXdSr9)�readrrrrrr)�responser2r2r3�drain_and_release_conn�s�z:HTTPConnectionPool.urlopen.<locals>.drain_and_release_conni/ZGET)r�r�zRedirecting %s -> %s)rHr��assert_same_hostrr�r�r�zRetry-Afterz	Retry: %s)<rTrFr"Zfrom_intrHr_r�r
r�rZ
ensure_strr(r%rsr,�copy�updaterLr r;rfrkrcr[rrKrbrir��ResponseClsZfrom_httplibrrarrrrrrrrrr
Z	increment�sysrx�sleeprXre�urlopenZget_redirect_locationr�rZraise_on_redirectZsleep_for_retryrY�boolZ	getheaderZis_retryZraise_on_status)r1r�rsr�rTrHr�r�rr�r�r�r�Zresponse_kwr]Zrelease_this_connrrZ
clean_exitr�Zis_new_proxy_connr�Z
response_connr�r�r�Zredirect_locationZhas_retry_afterr2r2r3r��sLj




�
����	�


�����

���

���zHTTPConnectionPool.urlopen)N)r6r?r@rAr,rrZrr�r#r{r4r^rcrfrhrirkrurjr�r�r;r�r�r2r2r2r3rCgsL;�
1
'�
e�rCcspeZdZdZdZeZddejdddddddddddddddfdd�Z	dd	�Z
d
d�Zdd
�Z�fdd�Z
�ZS)�HTTPSConnectionPoola�
    Same as :class:`.HTTPConnectionPool`, but HTTPS.

    When Python is compiled with the :mod:`ssl` module, then
    :class:`.VerifiedHTTPSConnection` is used, which *can* verify certificates,
    instead of :class:`.HTTPSConnection`.

    :class:`.VerifiedHTTPSConnection` uses one of ``assert_fingerprint``,
    ``assert_hostname`` and ``host`` in this order to verify connections.
    If ``assert_hostname`` is False, no verification is done.

    The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
    ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl`
    is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
    the connection socket into an SSL socket.
    �httpsNFrcKs\tj||||||||||	|
f|�||_||_|
|_||_||_||_||_||_	||_
dSr9)rCr4�key_file�	cert_file�	cert_reqs�key_password�ca_certs�ca_cert_dir�ssl_version�assert_hostname�assert_fingerprint)r1r-r0rErrSrJrTrHrUrVr�r�r�r�r�r�r�r�r�rQr2r2r3r4is0��zHTTPSConnectionPool.__init__c
Cs@t|t�r<|j|j|j|j|j|j|j|j	|j
d�|j|_|S)z�
        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
        and establish the tunnel if proxy is used.
        )r�r�r�r�r�r�r�r�)rFrZset_certr�r�r�r�r�r�r�r�r�r\r2r2r3�
_prepare_conn�s
�
z!HTTPSConnectionPool._prepare_conncCs |�|j|j|j�|��dS)z�
        Establish tunnel connection early, because otherwise httplib
        would improperly set Host: header to proxy's IP:port.
        N)Z
set_tunnelr/r0rL�connectr\r2r2r3ri�sz"HTTPSConnectionPool._prepare_proxyc
Cs�|jd7_t�d|j|j|jp$d�|jr8|jtkr@td��|j}|j}|jdk	rf|jj}|jj}|jf|||j	j
|j|j|j
|jd�|j��}|�|�S)zB
        Return a fresh :class:`httplib.HTTPSConnection`.
        rz)Starting new HTTPS connection (%d): %s:%sZ443zCCan't connect to HTTPS URL because the SSL module is not available.N)r-r0rrEr�r�r�)rOrXrYr-r0rZrrrKrr[rEr�r�r�rQr�)r1Zactual_hostZactual_portr]r2r2r3r^�s8��
��zHTTPSConnectionPool._new_conncs:tt|��|�t|dd�s$|��|js6t�dt�dS)rgrvNz�Unverified HTTPS request is being made. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings)	�superr�rhrbr�Zis_verified�warnings�warnrr\��	__class__r2r3rh�s�z"HTTPSConnectionPool._validate_conn)r6r?r@rAr,rrZr#r{r4r�rir^rh�
__classcell__r2r2r�r3r�Ts4�
1$r�cKsRt|�\}}}|pt�|d�}|dkr:t|fd|i|��St|fd|i|��SdS)a�
    Given a url, return an :class:`.ConnectionPool` instance of its host.

    This is a shortcut for not having to parse out the scheme, host, and port
    of the url before creating an :class:`.ConnectionPool` instance.

    :param url:
        Absolute URL string that must include the scheme. Port is optional.

    :param \**kw:
        Passes additional parameters to the constructor of the appropriate
        :class:`.ConnectionPool`. Useful for specifying things like
        timeout, maxsize, headers, etc.

    Example::

        >>> conn = connection_from_url('http://google.com/')
        >>> r = conn.request('GET', '/')
    �Pr�r0N)r$rr_r�rC)rs�kwr,r-r0r2r2r3�connection_from_url�s
r�cCs.t||�}|�d�r*|�d�r*|dd�}|S)z?
    Normalize hosts for comparisons and use with sockets.
    �[�]r���)�normalize_hostr��endswith)r-r,r2r2r3r's
r')LZ
__future__rrmZloggingr�r�r|rrrrn�
exceptionsrrrr	r
rrr
rrrrrZpackages.ssl_match_hostnamerZpackagesrZpackages.six.movesrr�rrrrrrrryrr�rZutil.connectionrZutil.requestr Z
util.responser!Z
util.retryr"Zutil.timeoutr#Zutil.urlr$r%r&r'r�r(Z
util.queuer)ZmovesrMZ	getLoggerr6rX�objectrjr*ZEAGAINZEWOULDBLOCKrprCr�r�r2r2r2r3�<module>sF<$	
$rsite-packages/pip/_vendor/urllib3/__pycache__/request.cpython-38.pyc000064400000012766151446177000021435 0ustar00U

��.e��@s>ddlmZddlmZddlmZdgZGdd�de�ZdS)�)�absolute_import�)�encode_multipart_formdata)�	urlencode�RequestMethodsc@sNeZdZdZddddhZddd�Zdd
d�Zddd
�Zddd�Zddd�Z	dS)ra�
    Convenience mixin for classes who implement a :meth:`urlopen` method, such
    as :class:`~urllib3.connectionpool.HTTPConnectionPool` and
    :class:`~urllib3.poolmanager.PoolManager`.

    Provides behavior for making common types of HTTP request methods and
    decides which type of request field encoding to use.

    Specifically,

    :meth:`.request_encode_url` is for sending requests whose fields are
    encoded in the URL (such as GET, HEAD, DELETE).

    :meth:`.request_encode_body` is for sending requests whose fields are
    encoded in the *body* of the request using multipart or www-form-urlencoded
    (such as for POST, PUT, PATCH).

    :meth:`.request` is for making any kind of request, it will look up the
    appropriate encoding format and use one of the above two methods to make
    the request.

    Initializer parameters:

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.
    ZDELETEZGETZHEADZOPTIONSNcCs|pi|_dS)N)�headers)�selfr�r	�?/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/request.py�__init__)szRequestMethods.__init__TcKstd��dS)NzMClasses extending RequestMethods must implement their own ``urlopen`` method.)�NotImplementedError)r�method�url�bodyr�encode_multipart�multipart_boundary�kwr	r	r
�urlopen,s
�zRequestMethods.urlopencKsR|��}||d<||jkr4|j||f||d�|��S|j||f||d�|��SdS)a�
        Make a request using :meth:`urlopen` with the appropriate encoding of
        ``fields`` based on the ``method`` used.

        This is a convenience method that requires the least amount of manual
        effort. It can be used in most situations, while still having the
        option to drop down to more specific methods when necessary, such as
        :meth:`request_encode_url`, :meth:`request_encode_body`,
        or even the lowest level :meth:`urlopen`.
        Zrequest_url)�fieldsrN)�upper�_encode_url_methods�request_encode_url�request_encode_body)rr
rrr�
urlopen_kwr	r	r
�request;s*
������zRequestMethods.requestcKsD|dkr|j}d|i}|�|�|r4|dt|�7}|j||f|�S)z�
        Make a request using :meth:`urlopen` with the ``fields`` encoded in
        the url. This is useful for request methods like GET, HEAD, DELETE, etc.
        Nr�?)r�updaterr)rr
rrrr�extra_kwr	r	r
rSs
z!RequestMethods.request_encode_urlcKs�|dkr|j}dii}|rbd|kr*td��|r@t||d�\}	}
nt|�d}	}
|	|d<d|
i|d<|d�|�|�|�|j||f|�S)a�
        Make a request using :meth:`urlopen` with the ``fields`` encoded in
        the body. This is useful for request methods like POST, PUT, PATCH, etc.

        When ``encode_multipart=True`` (default), then
        :meth:`urllib3.filepost.encode_multipart_formdata` is used to encode
        the payload with the appropriate content type. Otherwise
        :meth:`urllib.urlencode` is used with the
        'application/x-www-form-urlencoded' content type.

        Multipart encoding must be used when posting files, and it's reasonably
        safe to use it in other times too. However, it may break request
        signing, such as with OAuth.

        Supports an optional ``fields`` parameter of key/value strings AND
        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
        the MIME type is optional. For example::

            fields = {
                'foo': 'bar',
                'fakefile': ('foofile.txt', 'contents of foofile'),
                'realfile': ('barfile.txt', open('realfile').read()),
                'typedfile': ('bazfile.bin', open('bazfile').read(),
                              'image/jpeg'),
                'nonamefile': 'contents of nonamefile field',
            }

        When uploading a file, providing a filename (the first parameter of the
        tuple) is optional but recommended to best mimic behavior of browsers.

        Note that if ``headers`` are supplied, the 'Content-Type' header will
        be overwritten because it depends on the dynamic random boundary string
        which is used to compose the body of the request. The random boundary
        string can be explicitly set with the ``multipart_boundary`` parameter.
        NrrzFrequest got values for both 'fields' and 'body', can only specify one.)�boundaryz!application/x-www-form-urlencodedzContent-Type)r�	TypeErrorrrrr)rr
rrrrrrrrZcontent_typer	r	r
rcs*-���
z"RequestMethods.request_encode_body)N)NNTN)NN)NN)NNTN)
�__name__�
__module__�__qualname__�__doc__rrrrrrr	r	r	r
r
s
�


�N)	Z
__future__rZfilepostrZpackages.six.moves.urllib.parser�__all__�objectrr	r	r	r
�<module>ssite-packages/pip/_vendor/urllib3/__pycache__/response.cpython-38.pyc000064400000047557151446177000021611 0ustar00U

��.e�l�@s\ddlmZddlmZddlZddlZddlZddlmZ	ddlm
ZzddlZWne
k
rldZYnXddlmZddlmZmZmZmZmZmZmZdd	lmZmZdd
lmZddlm Z m!Z!ddl"m#Z#m$Z$e�%e&�Z'Gd
d�de(�Z)Gdd�de(�Z*Gdd�de(�Z+edk	�r.Gdd�de(�Z,Gdd�de(�Z-dd�Z.Gdd�dej/�Z0dS)�)�absolute_import)�contextmanagerN)�timeout)�error�)�HTTPHeaderDict)�BodyNotHttplibCompatible�
ProtocolError�DecodeError�ReadTimeoutError�ResponseNotChunked�IncompleteRead�
InvalidHeader)�string_types�PY3)�http_client)�
HTTPException�BaseSSLError)�is_fp_closed�is_response_to_headc@s$eZdZdd�Zdd�Zdd�ZdS)�DeflateDecodercCsd|_d|_t��|_dS)NT�)�
_first_try�_data�zlib�
decompressobj�_obj��self�r�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/response.py�__init__!szDeflateDecoder.__init__cCst|j|�S�N��getattrr�r�namerrr �__getattr__&szDeflateDecoder.__getattr__cCs�|s|S|js|j�|�S|j|7_z"|j�|�}|rFd|_d|_|WStjk
r�d|_t�tj�|_z|�|j�W�YSd|_XYnXdS)NF)rr�
decompressrrrr�	MAX_WBITS)r�dataZdecompressedrrr r()s"zDeflateDecoder.decompressN��__name__�
__module__�__qualname__r!r'r(rrrr r src@seZdZdZdZdZdS)�GzipDecoderStaterr�N)r,r-r.�FIRST_MEMBER�
OTHER_MEMBERS�SWALLOW_DATArrrr r/@sr/c@s$eZdZdd�Zdd�Zdd�ZdS)�GzipDecodercCst�dtj�|_tj|_dS�N�)rrr)rr/r1�_staterrrr r!HszGzipDecoder.__init__cCst|j|�Sr"r#r%rrr r'LszGzipDecoder.__getattr__cCs�t�}|jtjks|st|�Sz||j�|�7}Wn<tjk
rn|j}tj|_|tj	krht|�YS�YnX|jj
}|s�t|�Stj	|_t�dtj�|_qdSr5)
�	bytearrayr7r/r3�bytesrr(rrr2Zunused_datarr))rr*�retZprevious_staterrr r(Os 
zGzipDecoder.decompressNr+rrrr r4Gsr4c@s$eZdZdd�Zdd�Zdd�ZdS)�
BrotliDecodercCst��|_dSr")�brotliZDecompressorrrrrr r!kszBrotliDecoder.__init__cCs$t|jd�r|j�|�S|j�|�S)Nr()�hasattrrr(Zprocess)rr*rrr r(nszBrotliDecoder.decompresscCst|jd�r|j��SdS)N�flushr)r=rr>rrrr r>ss
zBrotliDecoder.flushN)r,r-r.r!r(r>rrrr r;gsr;c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�MultiDecodera
    From RFC7231:
        If one or more encodings have been applied to a representation, the
        sender that applied the encodings MUST generate a Content-Encoding
        header field that lists the content codings in the order in which
        they were applied.
    cCsdd�|�d�D�|_dS)NcSsg|]}t|����qSr)�_get_decoder�strip)�.0�mrrr �
<listcomp>�sz)MultiDecoder.__init__.<locals>.<listcomp>�,)�split�	_decoders)rZmodesrrr r!�szMultiDecoder.__init__cCs|jd��S�Nr)rGr>rrrr r>�szMultiDecoder.flushcCst|j�D]}|�|�}q
|Sr")�reversedrGr()rr*�drrr r(�szMultiDecoder.decompressN)r,r-r.�__doc__r!r>r(rrrr r?ysr?cCs:d|krt|�S|dkrt�Stdk	r4|dkr4t�St�S)NrE�gzip�br)r?r4r<r;r)�moderrr r@�sr@c@sdeZdZdZddgZedk	r&edg7Zdddd	d
gZdLdd�Zdd�Zdd�Z	e
dd��Ze
dd��Zdd�Z
dd�Zdd�Zdd �ZeejfZedk	r�eejf7Zd!d"�Zd#d$�Zed%d&��ZdMd'd(�ZdNd*d+�Zed,d-��Zd.d/�ZdOd0d1�Zd2d3�Zd4d5�Z e
d6d7��Z!d8d9�Z"d:d;�Z#d<d=�Z$d>d?�Z%d@dA�Z&dBdC�Z'dDdE�Z(dPdFdG�Z)dHdI�Z*dJdK�Z+dS)Q�HTTPResponsea�
    HTTP Response container.

    Backwards-compatible to httplib's HTTPResponse but the response ``body`` is
    loaded and decoded on-demand when the ``data`` property is accessed.  This
    class is also compatible with the Python standard library's :mod:`io`
    module, and can hence be treated as a readable object in the context of that
    framework.

    Extra parameters for behaviour not present in httplib.HTTPResponse:

    :param preload_content:
        If True, the response's body will be preloaded during construction.

    :param decode_content:
        If True, will attempt to decode the body based on the
        'content-encoding' header.

    :param original_response:
        When this HTTPResponse wrapper is generated from an httplib.HTTPResponse
        object, it's convenient to include the original for debug purposes. It's
        otherwise unused.

    :param retries:
        The retries contains the last :class:`~urllib3.util.retry.Retry` that
        was used during the request.

    :param enforce_content_length:
        Enforce content length checking. Body returned by server must match
        value of Content-Length header, if present. Otherwise, raise error.
    rLZdeflateNrMi-i.i/i3i4�rTFcCst|t�r||_n
t|�|_||_||_||_||_||_|
|_||_	||_
d|_d|_d|_
|	|_d|_||_||_|r�t|ttf�r�||_|
|_||_t|d�r�||_
d|_d|_|j�dd���}dd�|�d�D�}d	|kr�d
|_|�|�|_|�r|j�s|j|d�|_dS)Nr�readFztransfer-encodingrPcss|]}|��VqdSr")rA)rB�encrrr �	<genexpr>�sz(HTTPResponse.__init__.<locals>.<genexpr>rE�chunkedT��decode_content)�
isinstancer�headers�status�version�reason�strictrV�retries�enforce_content_length�
auto_close�_decoder�_body�_fp�_original_response�_fp_bytes_read�msg�_request_url�
basestringr9�_pool�_connectionr=rT�
chunk_left�get�lowerrF�_init_length�length_remainingrQ)r�bodyrXrYrZr[r\Zpreload_contentrV�original_responseZpool�
connectionrer]r^�request_methodZrequest_urlr_Ztr_enc�	encodingsrrr r!�sB


zHTTPResponse.__init__cCs|j|jkr|j�d�SdS)a
        Should we redirect and where to?

        :returns: Truthy redirect location string if we got a redirect status
            code and valid location. ``None`` if redirect status and no
            location. ``False`` if not a redirect status code.
        �locationF)rY�REDIRECT_STATUSESrXrkrrrr �get_redirect_locationsz"HTTPResponse.get_redirect_locationcCs(|jr|jsdS|j�|j�d|_dSr")rhriZ	_put_connrrrr �release_connszHTTPResponse.release_conncCs"|jr|jS|jr|jdd�SdS)NT)�
cache_content)rarbrQrrrr r*szHTTPResponse.datacCs|jSr")rirrrr rq!szHTTPResponse.connectioncCs
t|j�Sr")rrbrrrr �isclosed%szHTTPResponse.isclosedcCs|jS)z�
        Obtain the number of bytes pulled over the wire so far. May differ from
        the amount of content returned by :meth:``HTTPResponse.read`` if bytes
        are encoded on the wire (e.g, compressed).
        )rdrrrr �tell(szHTTPResponse.tellcCs�|j�d�}|dk	r�|jr(t�d�dSz<tdd�|�d�D��}t|�dkrZtd|��|�	�}Wnt
k
r|d}YnX|d	kr�d}zt|j�}Wnt
k
r�d	}YnX|d
ks�d|kr�dks�n|d
kr�d	}|S)zM
        Set initial length value for Response content if available.
        zcontent-lengthNz�Received response with both Content-Length and Transfer-Encoding set. This is expressly forbidden by RFC 7230 sec 3.3.2. Ignoring Content-Length and attempting to process response as Transfer-Encoding: chunked.cSsg|]}t|��qSr)�int)rB�valrrr rDJsz-HTTPResponse._init_length.<locals>.<listcomp>rErz8Content-Length contained multiple unmatching values (%s)r)��i0�d��ZHEAD)
rXrkrT�logZwarning�setrF�lenr�pop�
ValueErrorr{rY)rrrZlengthZlengthsrYrrr rm0s6���

&zHTTPResponse._init_lengthcsh�j�dd���}�jdkrd|�jkr2t|��_n2d|krd�fdd�|�d�D�}t|�rdt|��_dS)z=
        Set-up the _decoder attribute if necessary.
        �content-encodingrPNrEcs"g|]}|���jkr|���qSr)rA�CONTENT_DECODERS)rB�errr rDos�z.HTTPResponse._init_decoder.<locals>.<listcomp>)rXrkrlr`r�r@rFr�)r�content_encodingrsrrr �
_init_decoderds


�zHTTPResponse._init_decoderc
Csx|s|Sz|jr|j�|�}WnD|jk
rb}z$|j�dd���}td||��W5d}~XYnX|rt||��7}|S)zN
        Decode the data passed in and potentially flush the decoder.
        r�rPzEReceived response with content-encoding: %s, but failed to decode it.N)r`r(�DECODER_ERROR_CLASSESrXrkrlr
�_flush_decoder)rr*rV�
flush_decoderr�r�rrr �_decode{s ��zHTTPResponse._decodecCs$|jr |j�d�}||j��SdS)zk
        Flushes the decoder. Should only be called if the decoder is actually
        being used.
        r)r`r(r>)rZbufrrr r��szHTTPResponse._flush_decoderc
cs�d}z�z
dVWn�tk
r2t|jdd��Ynptk
rn}z dt	|�krP�t|jdd��W5d}~XYn4t
tfk
r�}ztd||��W5d}~XYnXd}W5|s�|jr�|j��|jr�|j��|jr�|j��r�|��XdS)z�
        Catch low-level python exceptions, instead re-raising urllib3
        variants, so that low-level exceptions are not leaked in the
        high-level api.

        On exit, release the connection back to the pool.
        FNzRead timed out.zread operation timed outzConnection broken: %rT)
rc�closeriryrw�
SocketTimeoutrrhr�strr�SocketErrorr	)rZ
clean_exitr�rrr �_error_catcher�s(	
 

zHTTPResponse._error_catcherc	Cs|��|dkr|j}|jdkr$dSd}t|jdd�}|���v|dkr`|sV|j��nd}d}nPd}|st|j�|�nd}|dkr�|s�|j��d}|jr�|jdkr�t	|j
|j��W5QRX|�r|j
t|�7_
|jdk	r�|jt|�8_|�|||�}|�r||_
|S)aP
        Similar to :meth:`httplib.HTTPResponse.read`, but with two additional
        parameters: ``decode_content`` and ``cache_content``.

        :param amt:
            How much of the content to read. If specified, caching is skipped
            because it doesn't make sense to cache partial content as the full
            response.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.

        :param cache_content:
            If True, will save the returned data such that the same result is
            returned despite of the state of the underlying file object. This
            is useful if you want the ``.data`` property to continue working
            after having ``.read()`` the file object. (Overridden if ``amt`` is
            set.)
        NF�closedrTr)rN)r�rVrbr$r�rQr�r^rnr
rdr�r�ra)r�amtrVrxr�Z	fp_closedr*rrr rQ�s:

��

	
zHTTPResponse.read�ccsR|jr*|��r*|j||d�D]
}|Vqn$t|j�sN|j||d�}|r*|Vq*dS)a_
        A generator wrapper for the read() method. A call will block until
        ``amt`` bytes have been read from the connection or until the
        connection is closed.

        :param amt:
            How much of the content to read. The generator will return up to
            much data per iteration, but may return less. This is particularly
            likely when using compressed data. However, the empty string will
            never be returned.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.
        rU)r�rVN)rT�supports_chunked_reads�read_chunkedrrbrQ)rr�rV�liner*rrr �streams

zHTTPResponse.streamc
Ks`|j}t|t�s,tr"t|���}n
t�|�}t|dd�}|f|||j|j|j	||d�|��}|S)a
        Given an :class:`httplib.HTTPResponse` instance ``r``, return a
        corresponding :class:`urllib3.response.HTTPResponse` object.

        Remaining parameters are passed to the HTTPResponse constructor, along
        with ``original_response=r``.
        r\r)rorXrYrZr[r\rp)
rerWrr�items�from_httplibr$rYrZr[)ZResponseCls�rZresponse_kwrXr\Zresprrr r�9s$	

��
zHTTPResponse.from_httplibcCs|jSr"�rXrrrr �
getheadersZszHTTPResponse.getheaderscCs|j�||�Sr")rXrk)rr&�defaultrrr �	getheader]szHTTPResponse.getheadercCs|jSr"r�rrrr �infoaszHTTPResponse.infocCs6|js|j��|jr |j��|js2tj�|�dSr")r�rbr�rir_�io�IOBaserrrr r�es

zHTTPResponse.closecCsT|jstjj�|�S|jdkr"dSt|jd�r8|j��St|jd�rL|jjSdSdS)NTryr�)r_r�r�r��__get__rbr=ryrrrr r�os

zHTTPResponse.closedcCs6|jdkrtd��nt|jd�r*|j��Std��dS)Nz-HTTPResponse has no file to get a fileno from�filenozOThe file-like object this HTTPResponse is wrapped around has no file descriptor)rb�IOErrorr=r�rrrr r�|s


�zHTTPResponse.filenocCs2|jdk	r.t|jd�r.t|jdd�s.|j��SdS)Nr>r�F)rbr=r$r>rrrr r>�s�
��zHTTPResponse.flushcCsdS)NTrrrrr �readable�szHTTPResponse.readablecCs:|�t|��}t|�dkrdS||dt|��<t|�SdSrH)rQr�)r�bZtemprrr �readinto�s
zHTTPResponse.readintocCst|jd�S)z�
        Checks if the underlying file-like object looks like a
        httplib.HTTPResponse object. We do this by testing for the fp
        attribute. If it is present we assume it returns raw chunks as
        processed by read_chunked().
        �fp)r=rbrrrr r��sz#HTTPResponse.supports_chunked_readscCsf|jdk	rdS|jj��}|�dd�d}zt|d�|_Wn&tk
r`|��t�	|��YnXdS)N�;rrr6)
rjrbr��readlinerFr{r�r��httplibr
)rr�rrr �_update_chunk_length�s
z!HTTPResponse._update_chunk_lengthcCs�d}|dkr2|j�|j�}|}|j�d�d|_nv||jkrZ|j�|�}|j||_|}nN||jkr�|j�|�}|j�d�d|_|}n |j�|j�}|j�d�d|_|S)Nr0)rbZ
_safe_readrj)rr�Zreturned_chunk�chunk�valuerrr �
_handle_chunk�s&

zHTTPResponse._handle_chunkc	cs�|��|jstd��|��s&td��|����|jrXt|j�rX|j��W5QR�dS|j	j
dkrrW5QR�dS|��|jdkr�q�|�
|�}|j||dd�}|rr|Vqr|r�|��}|r�|V|j	j
��}|s�q�|dkr�q�q�|jr�|j��W5QRXdS)a�
        Similar to :meth:`HTTPResponse.read`, but with an additional
        parameter: ``decode_content``.

        :param amt:
            How much of the content to read. If specified, caching is skipped
            because it doesn't make sense to cache partial content as the full
            response.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.
        zHResponse is not chunked. Header 'transfer-encoding: chunked' is missing.zgBody should be httplib.HTTPResponse like. It should have have an fp attribute which returns raw chunks.NrF)rVr�s
)r�rTrr�rr�rcrr�rbr�r�rjr�r�r�r�)rr�rVr�Zdecodedr�rrr r��sJ��



�zHTTPResponse.read_chunkedcCs.|jdk	r$t|jj�r$|jjdjS|jSdS)z�
        Returns the URL that was the source of this response.
        If the request that generated this response redirected, this method
        will return the final redirect location.
        N���)r]r��historyZredirect_locationrfrrrr �geturlszHTTPResponse.geturlccs�dg}|jdd�D]n}d|krv|�d�}d�|�|ddV|dd�D]}|dVqL|drp|dg}q�g}q|�|�q|r�d�|�VdS)NrTrU�
rrr�)r�rF�join�append)r�bufferr��xrrr �__iter__s
zHTTPResponse.__iter__)rPNrrNrTTNNNNNFNNT)NNF)r�N)N)NN),r,r-r.rKr�r<rur!rvrw�propertyr*rqryrzrmr�r�rrr�r�r�rr�rQr��classmethodr�r�r�r�r�r�r�r>r�r�r�r�r�r�r�r�rrrr rO�sx 
�
C


4

8
J

 


		
FrO)1Z
__future__r�
contextlibrrr�ZloggingZsocketrr�rr�r<�ImportError�_collectionsr�
exceptionsrr	r
rrr
rZpackages.sixrrgrZpackages.six.movesrr�rqrrZ
util.responserrZ	getLoggerr,r��objectrr/r4r;r?r@r�rOrrrr �<module>s2
$	
 

site-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-38.opt-1.pyc000064400000024617151446177000023357 0ustar00U

��.e(*�@s�ddlmZzddlmZmZWn$ek
rDddlmZmZYnXzddlmZWn"ek
rxGdd�d�ZYnXddlm	Z	ddl
mZdd	lm
Z
mZmZd
dgZe�ZGdd
�d
e�ZGd
d�de�ZdS)�)�absolute_import)�Mapping�MutableMapping)�RLockc@seZdZdd�Zdd�ZdS)rcCsdS�N���selfrr�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/_collections.py�	__enter__szRLock.__enter__cCsdSrr)r	�exc_type�	exc_value�	tracebackrrr
�__exit__szRLock.__exit__N)�__name__�
__module__�__qualname__rrrrrr
rsr)�OrderedDict�)�
InvalidHeader)�iterkeys�
itervalues�PY3�RecentlyUsedContainer�HTTPHeaderDictc@sVeZdZdZeZddd�Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dS)ra�
    Provides a thread-safe dict-like container which maintains up to
    ``maxsize`` keys while throwing away the least-recently-used keys beyond
    ``maxsize``.

    :param maxsize:
        Maximum number of recent elements to retain.

    :param dispose_func:
        Every time an item is evicted from the container,
        ``dispose_func(value)`` is called.  Callback which will get called
    �
NcCs"||_||_|��|_t�|_dSr)�_maxsize�dispose_func�ContainerCls�
_containerr�lock)r	�maxsizerrrr
�__init__.s
zRecentlyUsedContainer.__init__c
Cs8|j�(|j�|�}||j|<|W5QR�SQRXdSr)r r�pop)r	�key�itemrrr
�__getitem__5s
z!RecentlyUsedContainer.__getitem__c	Cslt}|j�@|j�|t�}||j|<t|j�|jkrF|jjdd�\}}W5QRX|jrh|tk	rh|�|�dS)NF)Zlast)�_Nullr r�get�lenr�popitemr)r	r$�valueZ
evicted_valueZ_keyrrr
�__setitem__<s
z!RecentlyUsedContainer.__setitem__c	Cs2|j�|j�|�}W5QRX|jr.|�|�dSr)r rr#r)r	r$r+rrr
�__delitem__Ksz!RecentlyUsedContainer.__delitem__c
Cs(|j�t|j�W5QR�SQRXdSr)r r)rrrrr
�__len__RszRecentlyUsedContainer.__len__cCstd��dS)Nz7Iteration over this class is unlikely to be threadsafe.)�NotImplementedErrorrrrr
�__iter__Vs�zRecentlyUsedContainer.__iter__c	CsH|j�tt|j��}|j��W5QRX|jrD|D]}|�|�q4dSr)r �listrr�clearr)r	�valuesr+rrr
r2[szRecentlyUsedContainer.clearc
Cs,|j�tt|j��W5QR�SQRXdSr)r r1rrrrrr
�keyseszRecentlyUsedContainer.keys)rN)rrr�__doc__rrr"r&r,r-r.r0r2r4rrrr
rs


cs�eZdZdZd-�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
esZej
Z
ejZe�Zdd�Zdd�Zefdd�Zdd�Zdd�Zdd�Zefdd�ZeZeZeZeZdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Z d)d*�Z!e"d+d,��Z#�Z$S).rap
    :param headers:
        An iterable of field-value pairs. Must not contain multiple field names
        when compared case-insensitively.

    :param kwargs:
        Additional field-value pairs to pass in to ``dict.update``.

    A ``dict`` like container for storing HTTP Headers.

    Field names are stored and compared case-insensitively in compliance with
    RFC 7230. Iteration provides the first case-sensitive key seen for each
    case-insensitive pair.

    Using ``__setitem__`` syntax overwrites fields that compare equal
    case-insensitively in order to maintain ``dict``'s api. For fields that
    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
    in a loop.

    If multiple fields that are equal case-insensitively are passed to the
    constructor or ``.update``, the behavior is undefined and some will be
    lost.

    >>> headers = HTTPHeaderDict()
    >>> headers.add('Set-Cookie', 'foo=bar')
    >>> headers.add('set-cookie', 'baz=quxx')
    >>> headers['content-length'] = '7'
    >>> headers['SET-cookie']
    'foo=bar, baz=quxx'
    >>> headers['Content-Length']
    '7'
    NcsPtt|���t�|_|dk	r>t|t�r4|�|�n
|�|�|rL|�|�dSr)�superrr"rr�
isinstance�
_copy_from�extend)r	�headers�kwargs��	__class__rr
r"�s

zHTTPHeaderDict.__init__cCs ||g|j|��<|j|��Sr�r�lower�r	r$�valrrr
r,�szHTTPHeaderDict.__setitem__cCs |j|��}d�|dd��S)N�, r�rr?�joinr@rrr
r&�szHTTPHeaderDict.__getitem__cCs|j|��=dSrr>�r	r$rrr
r-�szHTTPHeaderDict.__delitem__cCs|��|jkSr)r?rrErrr
�__contains__�szHTTPHeaderDict.__contains__cCs^t|t�st|d�sdSt|t|��s2t|�|�}tdd�|��D��tdd�|��D��kS)Nr4Fcss|]\}}|��|fVqdSr)r?)�.0�k�vrrr
�	<genexpr>�sz(HTTPHeaderDict.__eq__.<locals>.<genexpr>)r7r�hasattr�type�dict�
itermerged�r	�otherrrr
�__eq__�s�zHTTPHeaderDict.__eq__cCs|�|�Sr)rQrOrrr
�__ne__�szHTTPHeaderDict.__ne__cCs
t|j�Sr)r)rrrrr
r.�szHTTPHeaderDict.__len__ccs|j��D]}|dVq
dS)Nr)rr3)r	�valsrrr
r0�szHTTPHeaderDict.__iter__cCs@z||}Wn$tk
r0||jkr(�|YSX||=|SdS)z�D.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.
        N)�KeyError�_HTTPHeaderDict__marker)r	r$�defaultr+rrr
r#�s

zHTTPHeaderDict.popcCs$z
||=Wntk
rYnXdSr)rTrErrr
�discard�s
zHTTPHeaderDict.discardcCs4|��}||g}|j�||�}||k	r0|�|�dS)z�Adds a (name, value) pair, doesn't overwrite the value if it already
        exists.

        >>> headers = HTTPHeaderDict(foo='bar')
        >>> headers.add('Foo', 'baz')
        >>> headers['foo']
        'bar, baz'
        N)r?r�
setdefault�append)r	r$rAZ	key_lowerZnew_valsrSrrr
�add�s
	zHTTPHeaderDict.addcOs�t|�dkrtd�t|����t|�dkr2|dnd}t|t�r`|��D]\}}|�||�qHnjt|t�r�|D]}|�|||�qnnDt|d�r�|�	�D]}|�|||�q�n|D]\}}|�||�q�|�
�D]\}}|�||�q�dS)z�Generic import function for any type of header-like object.
        Adapted version of MutableMapping.update in order to insert items
        with self.add instead of self.__setitem__
        rz9extend() takes at most 1 positional arguments ({0} given)rrr4N)r)�	TypeError�formatr7r�	iteritemsrZrrKr4�items)r	�argsr;rPr$rAr+rrr
r9�s(��


zHTTPHeaderDict.extendcCsNz|j|��}Wn*tk
r<||jkr4gYS|YSX|dd�SdS)zmReturns a list of all the values for the named field. Returns an
        empty list if the key doesn't exist.rN)rr?rTrU)r	r$rVrSrrr
�getlists

zHTTPHeaderDict.getlistcCsdt|�jt|���fS)Nz%s(%s))rLrrMrNrrrr
�__repr__szHTTPHeaderDict.__repr__cCs>|D]4}|�|�}t|t�r$t|�}|g||j|��<qdSr)r`r7r1rr?)r	rPr$rArrr
r8s


zHTTPHeaderDict._copy_fromcCst|��}|�|�|Sr)rLr8)r	Zclonerrr
�copy!s

zHTTPHeaderDict.copyccs<|D]2}|j|��}|dd�D]}|d|fVq"qdS)z8Iterate over all header lines, including duplicate ones.rNrr>)r	r$rSrArrr
r]&szHTTPHeaderDict.iteritemsccs8|D].}|j|��}|dd�|dd��fVqdS)z:Iterate over all headers, merging duplicate ones together.rrBrNrCr@rrr
rN-szHTTPHeaderDict.itermergedcCst|���Sr)r1r]rrrr
r^3szHTTPHeaderDict.itemscCs�d}g}|jD]h}|�|�rT|s.td|��n&|d\}}||d|��f|d<q|�dd�\}}|�||��f�q||�S)z4Read headers from a Python 2 httplib message object.)� �	z/Header continuation with no previous header: %s���rc�:r)r:�
startswithr�strip�splitrY)�cls�messageZobs_fold_continued_leadersr:�liner$r+rrr
�from_httplib6s

�zHTTPHeaderDict.from_httplib)N)%rrrr5r"r,r&r-rFrQrRrrrr�objectrUr.r0r#rWrZr9r`Z
getheadersZgetallmatchingheadersZigetZget_allrar8rbr]rNr^�classmethodrm�
__classcell__rrr<r
rjs>!	
N)Z
__future__rZcollections.abcrr�ImportError�collectionsZ	threadingrr�
exceptionsrZpackages.sixrrr�__all__rnr'rrrrrr
�<module>sLsite-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-38.pyc000064400000023454151446177000022122 0ustar00U

��.e��@sLddlmZddlmZGdd�de�ZGdd�de�ZGdd	�d	e�Z	Gd
d�de	�Z
Gdd
�d
e�ZGdd�de�ZGdd�de�Z
Gdd�de�ZeZGdd�de
�ZGdd�de
�ZGdd�de�ZGdd�de�ZGdd�dee
�ZGdd�de�ZGd d!�d!ee	�ZGd"d#�d#e	�ZGd$d%�d%e	�ZGd&d'�d'ee�ZGd(d)�d)e�ZGd*d+�d+e�ZGd,d-�d-e�ZGd.d/�d/e�ZGd0d1�d1e�ZGd2d3�d3e�Z Gd4d5�d5e�Z!Gd6d7�d7e�Z"Gd8d9�d9e�Z#Gd:d;�d;ee�Z$Gd<d=�d=e�Z%Gd>d?�d?ee�ZGd@dA�dAe�Z&GdBdC�dCe'e�Z(GdDdE�dEe�Z)GdFdG�dGe�Z*dHS)I�)�absolute_import�)�IncompleteReadc@seZdZdZdS)�	HTTPErrorz#Base exception used by this module.N��__name__�
__module__�__qualname__�__doc__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/exceptions.pyrsrc@seZdZdZdS)�HTTPWarningz!Base warning used by this module.Nrrrrrr
sr
c@s eZdZdZdd�Zdd�ZdS)�	PoolErrorz/Base exception for errors caused within a pool.cCs||_t�|d||f�dS)Nz%s: %s)�poolr�__init__)�selfr�messagerrrrszPoolError.__init__cCs
|jdfS)N)NN��	__class__�rrrr�
__reduce__szPoolError.__reduce__N�rrr	r
rrrrrrrsrc@s eZdZdZdd�Zdd�ZdS)�RequestErrorz8Base exception for PoolErrors that have associated URLs.cCs||_t�|||�dS�N)�urlrr)rrrrrrrr szRequestError.__init__cCs|jd|jdffSr)rrrrrrr$szRequestError.__reduce__Nrrrrrrsrc@seZdZdZdS)�SSLErrorz9Raised when SSL certificate fails in an HTTPS connection.Nrrrrrr)src@seZdZdZdS)�
ProxyErrorz,Raised when the connection to a proxy fails.Nrrrrrr.src@seZdZdZdS)�DecodeErrorz;Raised when automatic decoding based on Content-Type fails.Nrrrrrr3src@seZdZdZdS)�
ProtocolErrorz>Raised when something unexpected happens mid-request/response.Nrrrrrr8src@seZdZdZddd�ZdS)�
MaxRetryErroraRaised when the maximum number of retries is exceeded.

    :param pool: The connection pool
    :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
    :param string url: The requested Url
    :param exceptions.Exception reason: The underlying error

    NcCs&||_d||f}t�||||�dS)Nz0Max retries exceeded with url: %s (Caused by %r))�reasonrr)rrrr rrrrrNszMaxRetryError.__init__)N�rrr	r
rrrrrrDs	rc@seZdZdZddd�ZdS)�HostChangedErrorz?Raised when an existing pool gets a request for a foreign host.�cCs"d|}t�||||�||_dS)Nz)Tried to open a foreign host with url: %s)rr�retries)rrrr$rrrrrYszHostChangedError.__init__N)r#r!rrrrr"Vsr"c@seZdZdZdS)�TimeoutStateErrorz3 Raised when passing an invalid state to a timeout Nrrrrrr%_sr%c@seZdZdZdS)�TimeoutErrorz� Raised when a socket timeout error occurs.

    Catching this error will catch both :exc:`ReadTimeoutErrors
    <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`.
    Nrrrrrr&esr&c@seZdZdZdS)�ReadTimeoutErrorzFRaised when a socket timeout occurs while receiving data from a serverNrrrrrr'osr'c@seZdZdZdS)�ConnectTimeoutErrorz@Raised when a socket timeout occurs while connecting to a serverNrrrrrr(vsr(c@seZdZdZdS)�NewConnectionErrorzHRaised when we fail to establish a new connection. Usually ECONNREFUSED.Nrrrrrr){sr)c@seZdZdZdS)�EmptyPoolErrorzCRaised when a pool runs out of connections and no more are allowed.Nrrrrrr*�sr*c@seZdZdZdS)�ClosedPoolErrorzCRaised when a request enters a pool after the pool has been closed.Nrrrrrr+�sr+c@seZdZdZdS)�LocationValueErrorz<Raised when there is something wrong with a given URL input.Nrrrrrr,�sr,c@seZdZdZdd�ZdS)�LocationParseErrorz=Raised when get_host or similar fails to parse the URL input.cCsd|}t�||�||_dS)NzFailed to parse: %s)rr�location)rr.rrrrr�szLocationParseError.__init__Nr!rrrrr-�sr-c@seZdZdZdZdZdS)�
ResponseErrorzDUsed as a container for an error reason supplied in a MaxRetryError.ztoo many error responsesz&too many {status_code} error responsesN)rrr	r
Z
GENERIC_ERRORZSPECIFIC_ERRORrrrrr/�sr/c@seZdZdZdS)�SecurityWarningz0Warned when performing security reducing actionsNrrrrrr0�sr0c@seZdZdZdS)�SubjectAltNameWarningzBWarned when connecting to a host with a certificate missing a SAN.Nrrrrrr1�sr1c@seZdZdZdS)�InsecureRequestWarningz/Warned when making an unverified HTTPS request.Nrrrrrr2�sr2c@seZdZdZdS)�SystemTimeWarningz0Warned when system time is suspected to be wrongNrrrrrr3�sr3c@seZdZdZdS)�InsecurePlatformWarningzEWarned when certain SSL configuration is not available on a platform.Nrrrrrr4�sr4c@seZdZdZdS)�SNIMissingWarningz9Warned when making a HTTPS request without SNI available.Nrrrrrr5�sr5c@seZdZdZdS)�DependencyWarningzc
    Warned when an attempt is made to import a module with missing optional
    dependencies.
    Nrrrrrr6�sr6c@seZdZdZdS)�ResponseNotChunkedz;Response needs to be chunked in order to read it as chunks.Nrrrrrr7�sr7c@seZdZdZdS)�BodyNotHttplibCompatiblezz
    Body should be httplib.HTTPResponse like (have an fp attribute which
    returns raw chunks) for read_chunked().
    Nrrrrrr8�sr8cs(eZdZdZ�fdd�Zdd�Z�ZS)rz�
    Response length doesn't match expected Content-Length

    Subclass of http_client.IncompleteRead to allow int value
    for `partial` to avoid creating large objects on streamed
    reads.
    cstt|��||�dSr)�superrr)r�partial�expectedrrrr�szIncompleteRead.__init__cCsd|j|jfS)Nz/IncompleteRead(%i bytes read, %i more expected))r:r;rrrr�__repr__�s�zIncompleteRead.__repr__)rrr	r
rr<�
__classcell__rrrrr�src@seZdZdZdS)�
InvalidHeaderz(The header provided was somehow invalid.Nrrrrrr>�sr>cs eZdZdZ�fdd�Z�ZS)�ProxySchemeUnknownz1ProxyManager does not support the supplied schemecsd|}tt|��|�dS)NzNot supported proxy scheme %s)r9r?r)rZschemerrrrr�szProxySchemeUnknown.__init__�rrr	r
rr=rrrrr?�sr?cs eZdZdZ�fdd�Z�ZS)�HeaderParsingErrorzNRaised by assert_header_parsing, but we convert it to a log.warning statement.cs$d|pd|f}tt|��|�dS)Nz%s, unparsed data: %rZUnknown)r9rAr)rZdefectsZ
unparsed_datarrrrr�szHeaderParsingError.__init__r@rrrrrA�srAc@seZdZdZdS)�UnrewindableBodyErrorz9urllib3 encountered an error when trying to rewind a bodyNrrrrrrB�srBN)+Z
__future__rZpackages.six.moves.http_clientrZhttplib_IncompleteRead�	Exceptionr�Warningr
rrrrrr�ConnectionErrorrr"r%r&r'r(r)r*r+�
ValueErrorr,r-r/r0r1r2r3r4r5r6r7r8r>�AssertionErrorr?rArBrrrr�<module>sH	

			site-packages/pip/_vendor/urllib3/__pycache__/filepost.cpython-38.opt-1.pyc000064400000005256151446177000022525 0ustar00U

��.e�	�@s�ddlmZddlZddlZddlZddlmZddlmZddl	m
Z
ddlmZe�
d�d	Zd
d�Zdd
�Zdd�Zddd�ZdS)�)�absolute_importN)�BytesIO�)�six)�b)�RequestFieldzutf-8�cCs$t�t�d��}tjs |�d�}|S)zN
    Our embarrassingly-simple replacement for mimetools.choose_boundary.
    ��ascii)�binasciiZhexlify�os�urandomrZPY2�decode)�boundary�r�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/filepost.py�choose_boundarys
rccsJt|t�rt�|�}nt|�}|D]"}t|t�r8|Vq"tj|�Vq"dS)z�
    Iterate over fields.

    Supports list of (k, v) tuples and dicts, and lists of
    :class:`~urllib3.fields.RequestField`.

    N)�
isinstance�dictr�	iteritems�iterrZfrom_tuples)�fields�i�fieldrrr�iter_field_objectss

rcCs,t|t�rdd�t�|�D�Sdd�|D�S)a-
    .. deprecated:: 1.6

    Iterate over fields.

    The addition of :class:`~urllib3.fields.RequestField` makes this function
    obsolete. Instead, use :func:`iter_field_objects`, which returns
    :class:`~urllib3.fields.RequestField` objects.

    Supports list of (k, v) tuples and dicts.
    css|]\}}||fVqdS�Nr��.0�k�vrrr�	<genexpr>:sziter_fields.<locals>.<genexpr>css|]\}}||fVqdSrrrrrrr <s)rrrr)rrrr�iter_fields-s
r!cCs�t�}|dkrt�}t|�D]p}|�td|��t|��|���|j}t|t	�r\t
|�}t|tj�rxt|��|�n
|�|�|�d�q|�td|��t
d|�}|�
�|fS)aQ
    Encode a dictionary of ``fields`` using the multipart/form-data MIME format.

    :param fields:
        Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).

    :param boundary:
        If not specified, then a random boundary will be generated using
        :func:`urllib3.filepost.choose_boundary`.
    Nz--%s
s
z--%s--
z multipart/form-data; boundary=%s)rrr�writer�writerZrender_headers�datar�int�strrZ	text_type�getvalue)rrZbodyrr$Zcontent_typerrr�encode_multipart_formdata?s 

r()N)Z
__future__rr�codecsr�iorZpackagesrZpackages.sixrrr�lookupr#rrr!r(rrrr�<module>s
site-packages/pip/_vendor/urllib3/__pycache__/connection.cpython-38.opt-1.pyc000064400000024462151446177000023037 0ustar00U

��.eB;�	@s�ddlmZddlZddlZddlZddlZddlmZmZ	ddl
Z
ddlmZddl
mZddl
mZzddlZejZWn,eefk
r�dZGdd	�d	e�ZYnXzeZWn$ek
r�Gd
d�de�ZYnXddlmZmZmZmZdd
lm Z m!Z!ddl"m#Z#m$Z$m%Z%m&Z&m'Z'ddl(m)Z)ddl*m+Z+e�,e-�Z.ddd�Z/e�0ddd�Z1Gdd�de2�Z3Gdd�dee2�ZGdd�de�Z4Gdd�de4�Z5dd�Z6e�r�e4Z7e5Z4ne3Z4dS)�)�absolute_importN)�error�timeout�)�six)�HTTPConnection)�
HTTPExceptionc@seZdZdS)�BaseSSLErrorN��__name__�
__module__�__qualname__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/connection.pyr	sr	c@seZdZdS)�ConnectionErrorNr
rrrrrsr)�NewConnectionError�ConnectTimeoutError�SubjectAltNameWarning�SystemTimeWarning)�match_hostname�CertificateError)�resolve_cert_reqs�resolve_ssl_version�assert_fingerprint�create_urllib3_context�ssl_wrap_socket)�
connection)�HTTPHeaderDict�Pi�)�http�httpsi�c@seZdZdZdS)�DummyConnectionz-Used to detect a failed ConnectionCls import.N)rrr
�__doc__rrrrr!>sr!c@speZdZdZedZejejdfgZ	dZ
dd�Zedd��Z
e
jd	d��Z
d
d�Zdd
�Zdd�Zddd�ZdS)ra$
    Based on httplib.HTTPConnection but provides an extra constructor
    backwards-compatibility layer between older and newer Pythons.

    Additional keyword parameters are used to configure attributes of the connection.
    Accepted parameters include:

      - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
      - ``source_address``: Set the source address for the current connection.
      - ``socket_options``: Set specific options on the underlying socket. If not specified, then
        defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
        Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy.

        For example, if you wish to enable TCP Keep Alive in addition to the defaults,
        you might pass::

            HTTPConnection.default_socket_options + [
                (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
            ]

        Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
    rrFcOsDtjs|�dd�|�d�|_|�d|j�|_tj|f|�|�dS)N�strict�source_address�socket_options)	rZPY2�pop�getr$�default_socket_optionsr%�_HTTPConnection�__init__)�self�args�kwrrrr*es
zHTTPConnection.__init__cCs|j�d�S)a�
        Getter method to remove any trailing dots that indicate the hostname is an FQDN.

        In general, SSL certificates don't include the trailing dot indicating a
        fully-qualified domain name, and thus, they don't validate properly when
        checked against a domain name that includes the dot. In addition, some
        servers may not expect to receive the trailing dot when provided.

        However, the hostname with trailing dot is critical to DNS resolution; doing a
        lookup with the trailing dot will properly only resolve the appropriate FQDN,
        whereas a lookup without a trailing dot will search the system's search domain
        list. Thus, it's important to keep the original host around for use only in
        those cases where it's appropriate (i.e., when doing DNS lookup to establish the
        actual TCP connection across which we're going to send HTTP requests).
        �.)�	_dns_host�rstrip)r+rrr�hostrszHTTPConnection.hostcCs
||_dS)z�
        Setter for the `host` property.

        We assume that only urllib3 uses the _dns_host attribute; httplib itself
        only uses `host`, and it seems reasonable that other libraries follow suit.
        N)r/)r+�valuerrrr1�sc
Cs�i}|jr|j|d<|jr$|j|d<ztj|j|jf|jf|�}WnXtk
rlt|d|j	|jf��Yn0t
k
r�}zt|d|��W5d}~XYnX|S)zp Establish a socket connection and set nodelay settings on it.

        :return: New socket connection.
        r$r%z0Connection to %s timed out. (connect timeout=%s)z(Failed to establish a new connection: %sN)r$r%rZcreate_connectionr/�portr�
SocketTimeoutrr1�SocketErrorr)r+Zextra_kw�conn�errr�	_new_conn�s2


��
���zHTTPConnection._new_conncCs$||_t|dd�r |��d|_dS)N�_tunnel_hostr)�sock�getattr�_tunnel�	auto_open�r+r6rrr�
_prepare_conn�szHTTPConnection._prepare_conncCs|��}|�|�dS)N)r8r?r>rrr�connect�szHTTPConnection.connectNcCst|dk	r|ni�}d|k}d|k}|j||||d�|��D]\}}|�||�q>d|krh|�dd�|��|dk	r�tjtf}	t||	�r�|f}|D]`}
|
s�q�t|
t�s�|
�	d�}
t
t|
��d	d�}|�|�	d
��|�d�|�|
�|�d�q�|�d�dS)
z�
        Alternative to the common request method, which sends the
        body with chunked encoding and not as one block
        Nzaccept-encodingr1)�skip_accept_encoding�	skip_hostztransfer-encodingzTransfer-EncodingZchunked�utf8�zutf-8s
s0

)
rZ
putrequest�itemsZ	putheaderZ
endheadersrZstring_types�bytes�
isinstance�encode�hex�len�send)r+�methodZurlZbodyZheadersrArB�headerr2Zstringish_types�chunkZlen_strrrr�request_chunked�s:�




zHTTPConnection.request_chunked)NN)rrr
r"�port_by_scheme�default_port�socketZIPPROTO_TCPZTCP_NODELAYr(�is_verifiedr*�propertyr1�setterr8r?r@rOrrrrrDs


		rc@s<eZdZedZdZdddddejddfdd�Zdd�Z	dS)�HTTPSConnectionr Nc
KsDtj|||f||d�|
��||_||_||_||_|	|_d|_dS)N)r#rr )rr*�key_file�	cert_file�key_password�ssl_context�server_hostnameZ	_protocol)r+r1r3rWrXrYr#rrZr[r-rrrr*�szHTTPSConnection.__init__cCs�|��}|�|�d}|jdkr>d}tt|j�t|j�d�|_|j}|jsf|j	sf|rft
|d�rf|��t||j
|j|j|j|jd�|_dS)NFT��ssl_version�	cert_reqs�load_default_certs)r:�keyfile�certfilerYrZr[)r8r?rZrrr]rr^�ca_certs�ca_cert_dir�hasattrr_rrWrXrYr[r:)r+r6�default_ssl_context�contextrrrr@�s6

������zHTTPSConnection.connect)
rrr
rPrQr]rRZ_GLOBAL_DEFAULT_TIMEOUTr*r@rrrrrV�s�
rVc@s6eZdZdZdZdZdZdZdZddd�Z	dd�Z
dS)�VerifiedHTTPSConnectionz[
    Based on httplib.HTTPSConnection but wraps the socket with
    SSL certification.
    Nc		Csp|dkr$|jdk	r|jj}ntd�}||_||_||_||_||_||_|oVt	j
�|�|_|oht	j
�|�|_
dS)zX
        This method should only be called once, before the connection is used.
        N)rZ�verify_moderrWrXr^rY�assert_hostnamer�os�path�
expanduserrbrc)	r+rWrXr^rYrbrirrcrrr�set_cert-s

z VerifiedHTTPSConnection.set_certc
Cs�|��}|j}t|dd�r4||_|��d|_|j}|}|jdk	rH|j}tj	�
�tk}|rlt�
d�t�t�d}|jdkr�d}tt|j�t|j�d�|_|j}t|j�|_|js�|js�|r�t|d�r�|��t||j|j|j|j|j||d�|_|j�rt|jj dd	�|j�nd|jt!j"k�rtt|d
d��st|j#dk	�rt|j� �}|�$dd��sbt�
d
�|�t%�t&||j#�pp|�|jt!j'k�p�|jdk	|_(dS)Nr9rzWSystem time is way off (before {0}). This will probably lead to SSL verification errorsFTr\r_)r:r`rarYrbrcr[rZ)Zbinary_formZcheck_hostnameZsubjectAltNamerz�Certificate for {0} has no `subjectAltName`, falling back to check for a `commonName` for now. This feature is being removed by major browsers and deprecated by RFC 2818. (See https://github.com/shazow/urllib3/issues/497 for details.)))r8r1r;r:r<r=r9r[�datetime�dateZtoday�RECENT_DATE�warnings�warn�formatrrZrrr]rr^rhrbrcrdr_rrWrXrYrZgetpeercert�sslZ	CERT_NONErir'r�_match_hostnameZ
CERT_REQUIREDrS)r+r6Zhostnamer[Zis_time_offrerf�certrrrr@Ls�
���

�������
�
��
��	�zVerifiedHTTPSConnection.connect)NNNNNNNN)rrr
r"r^rbrcr]rrmr@rrrrrg!s �
rgc
CsLzt||�Wn8tk
rF}zt�d||�||_�W5d}~XYnXdS)Nz@Certificate did not match expected hostname: %s. Certificate: %s)rr�logZwarningZ
_peer_cert)rvZasserted_hostnamer7rrrru�s�ru)8Z
__future__rrnZloggingrjrRrr5rr4rqZpackagesrZpackages.six.moves.http_clientrr)rrtZSSLErrorr	�ImportError�AttributeError�
BaseExceptionr�	NameError�	Exception�
exceptionsrrrrZpackages.ssl_match_hostnamerrZ	util.ssl_rrrrr�utilr�_collectionsrZ	getLoggerrrwrProrp�objectr!rVrgruZUnverifiedHTTPSConnectionrrrr�<module>sL
	

Bsite-packages/pip/_vendor/urllib3/__pycache__/response.cpython-38.opt-1.pyc000064400000047557151446177000022550 0ustar00U

��.e�l�@s\ddlmZddlmZddlZddlZddlZddlmZ	ddlm
ZzddlZWne
k
rldZYnXddlmZddlmZmZmZmZmZmZmZdd	lmZmZdd
lmZddlm Z m!Z!ddl"m#Z#m$Z$e�%e&�Z'Gd
d�de(�Z)Gdd�de(�Z*Gdd�de(�Z+edk	�r.Gdd�de(�Z,Gdd�de(�Z-dd�Z.Gdd�dej/�Z0dS)�)�absolute_import)�contextmanagerN)�timeout)�error�)�HTTPHeaderDict)�BodyNotHttplibCompatible�
ProtocolError�DecodeError�ReadTimeoutError�ResponseNotChunked�IncompleteRead�
InvalidHeader)�string_types�PY3)�http_client)�
HTTPException�BaseSSLError)�is_fp_closed�is_response_to_headc@s$eZdZdd�Zdd�Zdd�ZdS)�DeflateDecodercCsd|_d|_t��|_dS)NT�)�
_first_try�_data�zlib�
decompressobj�_obj��self�r�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/response.py�__init__!szDeflateDecoder.__init__cCst|j|�S�N��getattrr�r�namerrr �__getattr__&szDeflateDecoder.__getattr__cCs�|s|S|js|j�|�S|j|7_z"|j�|�}|rFd|_d|_|WStjk
r�d|_t�tj�|_z|�|j�W�YSd|_XYnXdS)NF)rr�
decompressrrrr�	MAX_WBITS)r�dataZdecompressedrrr r()s"zDeflateDecoder.decompressN��__name__�
__module__�__qualname__r!r'r(rrrr r src@seZdZdZdZdZdS)�GzipDecoderStaterr�N)r,r-r.�FIRST_MEMBER�
OTHER_MEMBERS�SWALLOW_DATArrrr r/@sr/c@s$eZdZdd�Zdd�Zdd�ZdS)�GzipDecodercCst�dtj�|_tj|_dS�N�)rrr)rr/r1�_staterrrr r!HszGzipDecoder.__init__cCst|j|�Sr"r#r%rrr r'LszGzipDecoder.__getattr__cCs�t�}|jtjks|st|�Sz||j�|�7}Wn<tjk
rn|j}tj|_|tj	krht|�YS�YnX|jj
}|s�t|�Stj	|_t�dtj�|_qdSr5)
�	bytearrayr7r/r3�bytesrr(rrr2Zunused_datarr))rr*�retZprevious_staterrr r(Os 
zGzipDecoder.decompressNr+rrrr r4Gsr4c@s$eZdZdd�Zdd�Zdd�ZdS)�
BrotliDecodercCst��|_dSr")�brotliZDecompressorrrrrr r!kszBrotliDecoder.__init__cCs$t|jd�r|j�|�S|j�|�S)Nr()�hasattrrr(Zprocess)rr*rrr r(nszBrotliDecoder.decompresscCst|jd�r|j��SdS)N�flushr)r=rr>rrrr r>ss
zBrotliDecoder.flushN)r,r-r.r!r(r>rrrr r;gsr;c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�MultiDecodera
    From RFC7231:
        If one or more encodings have been applied to a representation, the
        sender that applied the encodings MUST generate a Content-Encoding
        header field that lists the content codings in the order in which
        they were applied.
    cCsdd�|�d�D�|_dS)NcSsg|]}t|����qSr)�_get_decoder�strip)�.0�mrrr �
<listcomp>�sz)MultiDecoder.__init__.<locals>.<listcomp>�,)�split�	_decoders)rZmodesrrr r!�szMultiDecoder.__init__cCs|jd��S�Nr)rGr>rrrr r>�szMultiDecoder.flushcCst|j�D]}|�|�}q
|Sr")�reversedrGr()rr*�drrr r(�szMultiDecoder.decompressN)r,r-r.�__doc__r!r>r(rrrr r?ysr?cCs:d|krt|�S|dkrt�Stdk	r4|dkr4t�St�S)NrE�gzip�br)r?r4r<r;r)�moderrr r@�sr@c@sdeZdZdZddgZedk	r&edg7Zdddd	d
gZdLdd�Zdd�Zdd�Z	e
dd��Ze
dd��Zdd�Z
dd�Zdd�Zdd �ZeejfZedk	r�eejf7Zd!d"�Zd#d$�Zed%d&��ZdMd'd(�ZdNd*d+�Zed,d-��Zd.d/�ZdOd0d1�Zd2d3�Zd4d5�Z e
d6d7��Z!d8d9�Z"d:d;�Z#d<d=�Z$d>d?�Z%d@dA�Z&dBdC�Z'dDdE�Z(dPdFdG�Z)dHdI�Z*dJdK�Z+dS)Q�HTTPResponsea�
    HTTP Response container.

    Backwards-compatible to httplib's HTTPResponse but the response ``body`` is
    loaded and decoded on-demand when the ``data`` property is accessed.  This
    class is also compatible with the Python standard library's :mod:`io`
    module, and can hence be treated as a readable object in the context of that
    framework.

    Extra parameters for behaviour not present in httplib.HTTPResponse:

    :param preload_content:
        If True, the response's body will be preloaded during construction.

    :param decode_content:
        If True, will attempt to decode the body based on the
        'content-encoding' header.

    :param original_response:
        When this HTTPResponse wrapper is generated from an httplib.HTTPResponse
        object, it's convenient to include the original for debug purposes. It's
        otherwise unused.

    :param retries:
        The retries contains the last :class:`~urllib3.util.retry.Retry` that
        was used during the request.

    :param enforce_content_length:
        Enforce content length checking. Body returned by server must match
        value of Content-Length header, if present. Otherwise, raise error.
    rLZdeflateNrMi-i.i/i3i4�rTFcCst|t�r||_n
t|�|_||_||_||_||_||_|
|_||_	||_
d|_d|_d|_
|	|_d|_||_||_|r�t|ttf�r�||_|
|_||_t|d�r�||_
d|_d|_|j�dd���}dd�|�d�D�}d	|kr�d
|_|�|�|_|�r|j�s|j|d�|_dS)Nr�readFztransfer-encodingrPcss|]}|��VqdSr")rA)rB�encrrr �	<genexpr>�sz(HTTPResponse.__init__.<locals>.<genexpr>rE�chunkedT��decode_content)�
isinstancer�headers�status�version�reason�strictrV�retries�enforce_content_length�
auto_close�_decoder�_body�_fp�_original_response�_fp_bytes_read�msg�_request_url�
basestringr9�_pool�_connectionr=rT�
chunk_left�get�lowerrF�_init_length�length_remainingrQ)r�bodyrXrYrZr[r\Zpreload_contentrV�original_responseZpool�
connectionrer]r^�request_methodZrequest_urlr_Ztr_enc�	encodingsrrr r!�sB


zHTTPResponse.__init__cCs|j|jkr|j�d�SdS)a
        Should we redirect and where to?

        :returns: Truthy redirect location string if we got a redirect status
            code and valid location. ``None`` if redirect status and no
            location. ``False`` if not a redirect status code.
        �locationF)rY�REDIRECT_STATUSESrXrkrrrr �get_redirect_locationsz"HTTPResponse.get_redirect_locationcCs(|jr|jsdS|j�|j�d|_dSr")rhriZ	_put_connrrrr �release_connszHTTPResponse.release_conncCs"|jr|jS|jr|jdd�SdS)NT)�
cache_content)rarbrQrrrr r*szHTTPResponse.datacCs|jSr")rirrrr rq!szHTTPResponse.connectioncCs
t|j�Sr")rrbrrrr �isclosed%szHTTPResponse.isclosedcCs|jS)z�
        Obtain the number of bytes pulled over the wire so far. May differ from
        the amount of content returned by :meth:``HTTPResponse.read`` if bytes
        are encoded on the wire (e.g, compressed).
        )rdrrrr �tell(szHTTPResponse.tellcCs�|j�d�}|dk	r�|jr(t�d�dSz<tdd�|�d�D��}t|�dkrZtd|��|�	�}Wnt
k
r|d}YnX|d	kr�d}zt|j�}Wnt
k
r�d	}YnX|d
ks�d|kr�dks�n|d
kr�d	}|S)zM
        Set initial length value for Response content if available.
        zcontent-lengthNz�Received response with both Content-Length and Transfer-Encoding set. This is expressly forbidden by RFC 7230 sec 3.3.2. Ignoring Content-Length and attempting to process response as Transfer-Encoding: chunked.cSsg|]}t|��qSr)�int)rB�valrrr rDJsz-HTTPResponse._init_length.<locals>.<listcomp>rErz8Content-Length contained multiple unmatching values (%s)r)��i0�d��ZHEAD)
rXrkrT�logZwarning�setrF�lenr�pop�
ValueErrorr{rY)rrrZlengthZlengthsrYrrr rm0s6���

&zHTTPResponse._init_lengthcsh�j�dd���}�jdkrd|�jkr2t|��_n2d|krd�fdd�|�d�D�}t|�rdt|��_dS)z=
        Set-up the _decoder attribute if necessary.
        �content-encodingrPNrEcs"g|]}|���jkr|���qSr)rA�CONTENT_DECODERS)rB�errr rDos�z.HTTPResponse._init_decoder.<locals>.<listcomp>)rXrkrlr`r�r@rFr�)r�content_encodingrsrrr �
_init_decoderds


�zHTTPResponse._init_decoderc
Csx|s|Sz|jr|j�|�}WnD|jk
rb}z$|j�dd���}td||��W5d}~XYnX|rt||��7}|S)zN
        Decode the data passed in and potentially flush the decoder.
        r�rPzEReceived response with content-encoding: %s, but failed to decode it.N)r`r(�DECODER_ERROR_CLASSESrXrkrlr
�_flush_decoder)rr*rV�
flush_decoderr�r�rrr �_decode{s ��zHTTPResponse._decodecCs$|jr |j�d�}||j��SdS)zk
        Flushes the decoder. Should only be called if the decoder is actually
        being used.
        r)r`r(r>)rZbufrrr r��szHTTPResponse._flush_decoderc
cs�d}z�z
dVWn�tk
r2t|jdd��Ynptk
rn}z dt	|�krP�t|jdd��W5d}~XYn4t
tfk
r�}ztd||��W5d}~XYnXd}W5|s�|jr�|j��|jr�|j��|jr�|j��r�|��XdS)z�
        Catch low-level python exceptions, instead re-raising urllib3
        variants, so that low-level exceptions are not leaked in the
        high-level api.

        On exit, release the connection back to the pool.
        FNzRead timed out.zread operation timed outzConnection broken: %rT)
rc�closeriryrw�
SocketTimeoutrrhr�strr�SocketErrorr	)rZ
clean_exitr�rrr �_error_catcher�s(	
 

zHTTPResponse._error_catcherc	Cs|��|dkr|j}|jdkr$dSd}t|jdd�}|���v|dkr`|sV|j��nd}d}nPd}|st|j�|�nd}|dkr�|s�|j��d}|jr�|jdkr�t	|j
|j��W5QRX|�r|j
t|�7_
|jdk	r�|jt|�8_|�|||�}|�r||_
|S)aP
        Similar to :meth:`httplib.HTTPResponse.read`, but with two additional
        parameters: ``decode_content`` and ``cache_content``.

        :param amt:
            How much of the content to read. If specified, caching is skipped
            because it doesn't make sense to cache partial content as the full
            response.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.

        :param cache_content:
            If True, will save the returned data such that the same result is
            returned despite of the state of the underlying file object. This
            is useful if you want the ``.data`` property to continue working
            after having ``.read()`` the file object. (Overridden if ``amt`` is
            set.)
        NF�closedrTr)rN)r�rVrbr$r�rQr�r^rnr
rdr�r�ra)r�amtrVrxr�Z	fp_closedr*rrr rQ�s:

��

	
zHTTPResponse.read�ccsR|jr*|��r*|j||d�D]
}|Vqn$t|j�sN|j||d�}|r*|Vq*dS)a_
        A generator wrapper for the read() method. A call will block until
        ``amt`` bytes have been read from the connection or until the
        connection is closed.

        :param amt:
            How much of the content to read. The generator will return up to
            much data per iteration, but may return less. This is particularly
            likely when using compressed data. However, the empty string will
            never be returned.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.
        rU)r�rVN)rT�supports_chunked_reads�read_chunkedrrbrQ)rr�rV�liner*rrr �streams

zHTTPResponse.streamc
Ks`|j}t|t�s,tr"t|���}n
t�|�}t|dd�}|f|||j|j|j	||d�|��}|S)a
        Given an :class:`httplib.HTTPResponse` instance ``r``, return a
        corresponding :class:`urllib3.response.HTTPResponse` object.

        Remaining parameters are passed to the HTTPResponse constructor, along
        with ``original_response=r``.
        r\r)rorXrYrZr[r\rp)
rerWrr�items�from_httplibr$rYrZr[)ZResponseCls�rZresponse_kwrXr\Zresprrr r�9s$	

��
zHTTPResponse.from_httplibcCs|jSr"�rXrrrr �
getheadersZszHTTPResponse.getheaderscCs|j�||�Sr")rXrk)rr&�defaultrrr �	getheader]szHTTPResponse.getheadercCs|jSr"r�rrrr �infoaszHTTPResponse.infocCs6|js|j��|jr |j��|js2tj�|�dSr")r�rbr�rir_�io�IOBaserrrr r�es

zHTTPResponse.closecCsT|jstjj�|�S|jdkr"dSt|jd�r8|j��St|jd�rL|jjSdSdS)NTryr�)r_r�r�r��__get__rbr=ryrrrr r�os

zHTTPResponse.closedcCs6|jdkrtd��nt|jd�r*|j��Std��dS)Nz-HTTPResponse has no file to get a fileno from�filenozOThe file-like object this HTTPResponse is wrapped around has no file descriptor)rb�IOErrorr=r�rrrr r�|s


�zHTTPResponse.filenocCs2|jdk	r.t|jd�r.t|jdd�s.|j��SdS)Nr>r�F)rbr=r$r>rrrr r>�s�
��zHTTPResponse.flushcCsdS)NTrrrrr �readable�szHTTPResponse.readablecCs:|�t|��}t|�dkrdS||dt|��<t|�SdSrH)rQr�)r�bZtemprrr �readinto�s
zHTTPResponse.readintocCst|jd�S)z�
        Checks if the underlying file-like object looks like a
        httplib.HTTPResponse object. We do this by testing for the fp
        attribute. If it is present we assume it returns raw chunks as
        processed by read_chunked().
        �fp)r=rbrrrr r��sz#HTTPResponse.supports_chunked_readscCsf|jdk	rdS|jj��}|�dd�d}zt|d�|_Wn&tk
r`|��t�	|��YnXdS)N�;rrr6)
rjrbr��readlinerFr{r�r��httplibr
)rr�rrr �_update_chunk_length�s
z!HTTPResponse._update_chunk_lengthcCs�d}|dkr2|j�|j�}|}|j�d�d|_nv||jkrZ|j�|�}|j||_|}nN||jkr�|j�|�}|j�d�d|_|}n |j�|j�}|j�d�d|_|S)Nr0)rbZ
_safe_readrj)rr�Zreturned_chunk�chunk�valuerrr �
_handle_chunk�s&

zHTTPResponse._handle_chunkc	cs�|��|jstd��|��s&td��|����|jrXt|j�rX|j��W5QR�dS|j	j
dkrrW5QR�dS|��|jdkr�q�|�
|�}|j||dd�}|rr|Vqr|r�|��}|r�|V|j	j
��}|s�q�|dkr�q�q�|jr�|j��W5QRXdS)a�
        Similar to :meth:`HTTPResponse.read`, but with an additional
        parameter: ``decode_content``.

        :param amt:
            How much of the content to read. If specified, caching is skipped
            because it doesn't make sense to cache partial content as the full
            response.

        :param decode_content:
            If True, will attempt to decode the body based on the
            'content-encoding' header.
        zHResponse is not chunked. Header 'transfer-encoding: chunked' is missing.zgBody should be httplib.HTTPResponse like. It should have have an fp attribute which returns raw chunks.NrF)rVr�s
)r�rTrr�rr�rcrr�rbr�r�rjr�r�r�r�)rr�rVr�Zdecodedr�rrr r��sJ��



�zHTTPResponse.read_chunkedcCs.|jdk	r$t|jj�r$|jjdjS|jSdS)z�
        Returns the URL that was the source of this response.
        If the request that generated this response redirected, this method
        will return the final redirect location.
        N���)r]r��historyZredirect_locationrfrrrr �geturlszHTTPResponse.geturlccs�dg}|jdd�D]n}d|krv|�d�}d�|�|ddV|dd�D]}|dVqL|drp|dg}q�g}q|�|�q|r�d�|�VdS)NrTrU�
rrr�)r�rF�join�append)r�bufferr��xrrr �__iter__s
zHTTPResponse.__iter__)rPNrrNrTTNNNNNFNNT)NNF)r�N)N)NN),r,r-r.rKr�r<rur!rvrw�propertyr*rqryrzrmr�r�rrr�r�r�rr�rQr��classmethodr�r�r�r�r�r�r�r>r�r�r�r�r�r�r�r�rrrr rO�sx 
�
C


4

8
J

 


		
FrO)1Z
__future__r�
contextlibrrr�ZloggingZsocketrr�rr�r<�ImportError�_collectionsr�
exceptionsrr	r
rrr
rZpackages.sixrrgrZpackages.six.movesrr�rqrrZ
util.responserrZ	getLoggerr,r��objectrr/r4r;r?r@r�rOrrrr �<module>s2
$	
 

site-packages/pip/_vendor/urllib3/__pycache__/connection.cpython-38.pyc000064400000024462151446177000022100 0ustar00U

��.eB;�	@s�ddlmZddlZddlZddlZddlZddlmZmZ	ddl
Z
ddlmZddl
mZddl
mZzddlZejZWn,eefk
r�dZGdd	�d	e�ZYnXzeZWn$ek
r�Gd
d�de�ZYnXddlmZmZmZmZdd
lm Z m!Z!ddl"m#Z#m$Z$m%Z%m&Z&m'Z'ddl(m)Z)ddl*m+Z+e�,e-�Z.ddd�Z/e�0ddd�Z1Gdd�de2�Z3Gdd�dee2�ZGdd�de�Z4Gdd�de4�Z5dd�Z6e�r�e4Z7e5Z4ne3Z4dS)�)�absolute_importN)�error�timeout�)�six)�HTTPConnection)�
HTTPExceptionc@seZdZdS)�BaseSSLErrorN��__name__�
__module__�__qualname__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/connection.pyr	sr	c@seZdZdS)�ConnectionErrorNr
rrrrrsr)�NewConnectionError�ConnectTimeoutError�SubjectAltNameWarning�SystemTimeWarning)�match_hostname�CertificateError)�resolve_cert_reqs�resolve_ssl_version�assert_fingerprint�create_urllib3_context�ssl_wrap_socket)�
connection)�HTTPHeaderDict�Pi�)�http�httpsi�c@seZdZdZdS)�DummyConnectionz-Used to detect a failed ConnectionCls import.N)rrr
�__doc__rrrrr!>sr!c@speZdZdZedZejejdfgZ	dZ
dd�Zedd��Z
e
jd	d��Z
d
d�Zdd
�Zdd�Zddd�ZdS)ra$
    Based on httplib.HTTPConnection but provides an extra constructor
    backwards-compatibility layer between older and newer Pythons.

    Additional keyword parameters are used to configure attributes of the connection.
    Accepted parameters include:

      - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
      - ``source_address``: Set the source address for the current connection.
      - ``socket_options``: Set specific options on the underlying socket. If not specified, then
        defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
        Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy.

        For example, if you wish to enable TCP Keep Alive in addition to the defaults,
        you might pass::

            HTTPConnection.default_socket_options + [
                (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
            ]

        Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
    rrFcOsDtjs|�dd�|�d�|_|�d|j�|_tj|f|�|�dS)N�strict�source_address�socket_options)	rZPY2�pop�getr$�default_socket_optionsr%�_HTTPConnection�__init__)�self�args�kwrrrr*es
zHTTPConnection.__init__cCs|j�d�S)a�
        Getter method to remove any trailing dots that indicate the hostname is an FQDN.

        In general, SSL certificates don't include the trailing dot indicating a
        fully-qualified domain name, and thus, they don't validate properly when
        checked against a domain name that includes the dot. In addition, some
        servers may not expect to receive the trailing dot when provided.

        However, the hostname with trailing dot is critical to DNS resolution; doing a
        lookup with the trailing dot will properly only resolve the appropriate FQDN,
        whereas a lookup without a trailing dot will search the system's search domain
        list. Thus, it's important to keep the original host around for use only in
        those cases where it's appropriate (i.e., when doing DNS lookup to establish the
        actual TCP connection across which we're going to send HTTP requests).
        �.)�	_dns_host�rstrip)r+rrr�hostrszHTTPConnection.hostcCs
||_dS)z�
        Setter for the `host` property.

        We assume that only urllib3 uses the _dns_host attribute; httplib itself
        only uses `host`, and it seems reasonable that other libraries follow suit.
        N)r/)r+�valuerrrr1�sc
Cs�i}|jr|j|d<|jr$|j|d<ztj|j|jf|jf|�}WnXtk
rlt|d|j	|jf��Yn0t
k
r�}zt|d|��W5d}~XYnX|S)zp Establish a socket connection and set nodelay settings on it.

        :return: New socket connection.
        r$r%z0Connection to %s timed out. (connect timeout=%s)z(Failed to establish a new connection: %sN)r$r%rZcreate_connectionr/�portr�
SocketTimeoutrr1�SocketErrorr)r+Zextra_kw�conn�errr�	_new_conn�s2


��
���zHTTPConnection._new_conncCs$||_t|dd�r |��d|_dS)N�_tunnel_hostr)�sock�getattr�_tunnel�	auto_open�r+r6rrr�
_prepare_conn�szHTTPConnection._prepare_conncCs|��}|�|�dS)N)r8r?r>rrr�connect�szHTTPConnection.connectNcCst|dk	r|ni�}d|k}d|k}|j||||d�|��D]\}}|�||�q>d|krh|�dd�|��|dk	r�tjtf}	t||	�r�|f}|D]`}
|
s�q�t|
t�s�|
�	d�}
t
t|
��d	d�}|�|�	d
��|�d�|�|
�|�d�q�|�d�dS)
z�
        Alternative to the common request method, which sends the
        body with chunked encoding and not as one block
        Nzaccept-encodingr1)�skip_accept_encoding�	skip_hostztransfer-encodingzTransfer-EncodingZchunked�utf8�zutf-8s
s0

)
rZ
putrequest�itemsZ	putheaderZ
endheadersrZstring_types�bytes�
isinstance�encode�hex�len�send)r+�methodZurlZbodyZheadersrArB�headerr2Zstringish_types�chunkZlen_strrrr�request_chunked�s:�




zHTTPConnection.request_chunked)NN)rrr
r"�port_by_scheme�default_port�socketZIPPROTO_TCPZTCP_NODELAYr(�is_verifiedr*�propertyr1�setterr8r?r@rOrrrrrDs


		rc@s<eZdZedZdZdddddejddfdd�Zdd�Z	dS)�HTTPSConnectionr Nc
KsDtj|||f||d�|
��||_||_||_||_|	|_d|_dS)N)r#rr )rr*�key_file�	cert_file�key_password�ssl_context�server_hostnameZ	_protocol)r+r1r3rWrXrYr#rrZr[r-rrrr*�szHTTPSConnection.__init__cCs�|��}|�|�d}|jdkr>d}tt|j�t|j�d�|_|j}|jsf|j	sf|rft
|d�rf|��t||j
|j|j|j|jd�|_dS)NFT��ssl_version�	cert_reqs�load_default_certs)r:�keyfile�certfilerYrZr[)r8r?rZrrr]rr^�ca_certs�ca_cert_dir�hasattrr_rrWrXrYr[r:)r+r6�default_ssl_context�contextrrrr@�s6

������zHTTPSConnection.connect)
rrr
rPrQr]rRZ_GLOBAL_DEFAULT_TIMEOUTr*r@rrrrrV�s�
rVc@s6eZdZdZdZdZdZdZdZddd�Z	dd�Z
dS)�VerifiedHTTPSConnectionz[
    Based on httplib.HTTPSConnection but wraps the socket with
    SSL certification.
    Nc		Csp|dkr$|jdk	r|jj}ntd�}||_||_||_||_||_||_|oVt	j
�|�|_|oht	j
�|�|_
dS)zX
        This method should only be called once, before the connection is used.
        N)rZ�verify_moderrWrXr^rY�assert_hostnamer�os�path�
expanduserrbrc)	r+rWrXr^rYrbrirrcrrr�set_cert-s

z VerifiedHTTPSConnection.set_certc
Cs�|��}|j}t|dd�r4||_|��d|_|j}|}|jdk	rH|j}tj	�
�tk}|rlt�
d�t�t�d}|jdkr�d}tt|j�t|j�d�|_|j}t|j�|_|js�|js�|r�t|d�r�|��t||j|j|j|j|j||d�|_|j�rt|jj dd	�|j�nd|jt!j"k�rtt|d
d��st|j#dk	�rt|j� �}|�$dd��sbt�
d
�|�t%�t&||j#�pp|�|jt!j'k�p�|jdk	|_(dS)Nr9rzWSystem time is way off (before {0}). This will probably lead to SSL verification errorsFTr\r_)r:r`rarYrbrcr[rZ)Zbinary_formZcheck_hostnameZsubjectAltNamerz�Certificate for {0} has no `subjectAltName`, falling back to check for a `commonName` for now. This feature is being removed by major browsers and deprecated by RFC 2818. (See https://github.com/shazow/urllib3/issues/497 for details.)))r8r1r;r:r<r=r9r[�datetime�dateZtoday�RECENT_DATE�warnings�warn�formatrrZrrr]rr^rhrbrcrdr_rrWrXrYrZgetpeercert�sslZ	CERT_NONErir'r�_match_hostnameZ
CERT_REQUIREDrS)r+r6Zhostnamer[Zis_time_offrerf�certrrrr@Ls�
���

�������
�
��
��	�zVerifiedHTTPSConnection.connect)NNNNNNNN)rrr
r"r^rbrcr]rrmr@rrrrrg!s �
rgc
CsLzt||�Wn8tk
rF}zt�d||�||_�W5d}~XYnXdS)Nz@Certificate did not match expected hostname: %s. Certificate: %s)rr�logZwarningZ
_peer_cert)rvZasserted_hostnamer7rrrru�s�ru)8Z
__future__rrnZloggingrjrRrr5rr4rqZpackagesrZpackages.six.moves.http_clientrr)rrtZSSLErrorr	�ImportError�AttributeError�
BaseExceptionr�	NameError�	Exception�
exceptionsrrrrZpackages.ssl_match_hostnamerrZ	util.ssl_rrrrr�utilr�_collectionsrZ	getLoggerrrwrProrp�objectr!rVrgruZUnverifiedHTTPSConnectionrrrr�<module>sL
	

Bsite-packages/pip/_vendor/urllib3/__pycache__/_collections.cpython-38.pyc000064400000024617151446177000022420 0ustar00U

��.e(*�@s�ddlmZzddlmZmZWn$ek
rDddlmZmZYnXzddlmZWn"ek
rxGdd�d�ZYnXddlm	Z	ddl
mZdd	lm
Z
mZmZd
dgZe�ZGdd
�d
e�ZGd
d�de�ZdS)�)�absolute_import)�Mapping�MutableMapping)�RLockc@seZdZdd�Zdd�ZdS)rcCsdS�N���selfrr�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/_collections.py�	__enter__szRLock.__enter__cCsdSrr)r	�exc_type�	exc_value�	tracebackrrr
�__exit__szRLock.__exit__N)�__name__�
__module__�__qualname__rrrrrr
rsr)�OrderedDict�)�
InvalidHeader)�iterkeys�
itervalues�PY3�RecentlyUsedContainer�HTTPHeaderDictc@sVeZdZdZeZddd�Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dS)ra�
    Provides a thread-safe dict-like container which maintains up to
    ``maxsize`` keys while throwing away the least-recently-used keys beyond
    ``maxsize``.

    :param maxsize:
        Maximum number of recent elements to retain.

    :param dispose_func:
        Every time an item is evicted from the container,
        ``dispose_func(value)`` is called.  Callback which will get called
    �
NcCs"||_||_|��|_t�|_dSr)�_maxsize�dispose_func�ContainerCls�
_containerr�lock)r	�maxsizerrrr
�__init__.s
zRecentlyUsedContainer.__init__c
Cs8|j�(|j�|�}||j|<|W5QR�SQRXdSr)r r�pop)r	�key�itemrrr
�__getitem__5s
z!RecentlyUsedContainer.__getitem__c	Cslt}|j�@|j�|t�}||j|<t|j�|jkrF|jjdd�\}}W5QRX|jrh|tk	rh|�|�dS)NF)Zlast)�_Nullr r�get�lenr�popitemr)r	r$�valueZ
evicted_valueZ_keyrrr
�__setitem__<s
z!RecentlyUsedContainer.__setitem__c	Cs2|j�|j�|�}W5QRX|jr.|�|�dSr)r rr#r)r	r$r+rrr
�__delitem__Ksz!RecentlyUsedContainer.__delitem__c
Cs(|j�t|j�W5QR�SQRXdSr)r r)rrrrr
�__len__RszRecentlyUsedContainer.__len__cCstd��dS)Nz7Iteration over this class is unlikely to be threadsafe.)�NotImplementedErrorrrrr
�__iter__Vs�zRecentlyUsedContainer.__iter__c	CsH|j�tt|j��}|j��W5QRX|jrD|D]}|�|�q4dSr)r �listrr�clearr)r	�valuesr+rrr
r2[szRecentlyUsedContainer.clearc
Cs,|j�tt|j��W5QR�SQRXdSr)r r1rrrrrr
�keyseszRecentlyUsedContainer.keys)rN)rrr�__doc__rrr"r&r,r-r.r0r2r4rrrr
rs


cs�eZdZdZd-�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
esZej
Z
ejZe�Zdd�Zdd�Zefdd�Zdd�Zdd�Zdd�Zefdd�ZeZeZeZeZdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Z d)d*�Z!e"d+d,��Z#�Z$S).rap
    :param headers:
        An iterable of field-value pairs. Must not contain multiple field names
        when compared case-insensitively.

    :param kwargs:
        Additional field-value pairs to pass in to ``dict.update``.

    A ``dict`` like container for storing HTTP Headers.

    Field names are stored and compared case-insensitively in compliance with
    RFC 7230. Iteration provides the first case-sensitive key seen for each
    case-insensitive pair.

    Using ``__setitem__`` syntax overwrites fields that compare equal
    case-insensitively in order to maintain ``dict``'s api. For fields that
    compare equal, instead create a new ``HTTPHeaderDict`` and use ``.add``
    in a loop.

    If multiple fields that are equal case-insensitively are passed to the
    constructor or ``.update``, the behavior is undefined and some will be
    lost.

    >>> headers = HTTPHeaderDict()
    >>> headers.add('Set-Cookie', 'foo=bar')
    >>> headers.add('set-cookie', 'baz=quxx')
    >>> headers['content-length'] = '7'
    >>> headers['SET-cookie']
    'foo=bar, baz=quxx'
    >>> headers['Content-Length']
    '7'
    NcsPtt|���t�|_|dk	r>t|t�r4|�|�n
|�|�|rL|�|�dSr)�superrr"rr�
isinstance�
_copy_from�extend)r	�headers�kwargs��	__class__rr
r"�s

zHTTPHeaderDict.__init__cCs ||g|j|��<|j|��Sr�r�lower�r	r$�valrrr
r,�szHTTPHeaderDict.__setitem__cCs |j|��}d�|dd��S)N�, r�rr?�joinr@rrr
r&�szHTTPHeaderDict.__getitem__cCs|j|��=dSrr>�r	r$rrr
r-�szHTTPHeaderDict.__delitem__cCs|��|jkSr)r?rrErrr
�__contains__�szHTTPHeaderDict.__contains__cCs^t|t�st|d�sdSt|t|��s2t|�|�}tdd�|��D��tdd�|��D��kS)Nr4Fcss|]\}}|��|fVqdSr)r?)�.0�k�vrrr
�	<genexpr>�sz(HTTPHeaderDict.__eq__.<locals>.<genexpr>)r7r�hasattr�type�dict�
itermerged�r	�otherrrr
�__eq__�s�zHTTPHeaderDict.__eq__cCs|�|�Sr)rQrOrrr
�__ne__�szHTTPHeaderDict.__ne__cCs
t|j�Sr)r)rrrrr
r.�szHTTPHeaderDict.__len__ccs|j��D]}|dVq
dS)Nr)rr3)r	�valsrrr
r0�szHTTPHeaderDict.__iter__cCs@z||}Wn$tk
r0||jkr(�|YSX||=|SdS)z�D.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.
        N)�KeyError�_HTTPHeaderDict__marker)r	r$�defaultr+rrr
r#�s

zHTTPHeaderDict.popcCs$z
||=Wntk
rYnXdSr)rTrErrr
�discard�s
zHTTPHeaderDict.discardcCs4|��}||g}|j�||�}||k	r0|�|�dS)z�Adds a (name, value) pair, doesn't overwrite the value if it already
        exists.

        >>> headers = HTTPHeaderDict(foo='bar')
        >>> headers.add('Foo', 'baz')
        >>> headers['foo']
        'bar, baz'
        N)r?r�
setdefault�append)r	r$rAZ	key_lowerZnew_valsrSrrr
�add�s
	zHTTPHeaderDict.addcOs�t|�dkrtd�t|����t|�dkr2|dnd}t|t�r`|��D]\}}|�||�qHnjt|t�r�|D]}|�|||�qnnDt|d�r�|�	�D]}|�|||�q�n|D]\}}|�||�q�|�
�D]\}}|�||�q�dS)z�Generic import function for any type of header-like object.
        Adapted version of MutableMapping.update in order to insert items
        with self.add instead of self.__setitem__
        rz9extend() takes at most 1 positional arguments ({0} given)rrr4N)r)�	TypeError�formatr7r�	iteritemsrZrrKr4�items)r	�argsr;rPr$rAr+rrr
r9�s(��


zHTTPHeaderDict.extendcCsNz|j|��}Wn*tk
r<||jkr4gYS|YSX|dd�SdS)zmReturns a list of all the values for the named field. Returns an
        empty list if the key doesn't exist.rN)rr?rTrU)r	r$rVrSrrr
�getlists

zHTTPHeaderDict.getlistcCsdt|�jt|���fS)Nz%s(%s))rLrrMrNrrrr
�__repr__szHTTPHeaderDict.__repr__cCs>|D]4}|�|�}t|t�r$t|�}|g||j|��<qdSr)r`r7r1rr?)r	rPr$rArrr
r8s


zHTTPHeaderDict._copy_fromcCst|��}|�|�|Sr)rLr8)r	Zclonerrr
�copy!s

zHTTPHeaderDict.copyccs<|D]2}|j|��}|dd�D]}|d|fVq"qdS)z8Iterate over all header lines, including duplicate ones.rNrr>)r	r$rSrArrr
r]&szHTTPHeaderDict.iteritemsccs8|D].}|j|��}|dd�|dd��fVqdS)z:Iterate over all headers, merging duplicate ones together.rrBrNrCr@rrr
rN-szHTTPHeaderDict.itermergedcCst|���Sr)r1r]rrrr
r^3szHTTPHeaderDict.itemscCs�d}g}|jD]h}|�|�rT|s.td|��n&|d\}}||d|��f|d<q|�dd�\}}|�||��f�q||�S)z4Read headers from a Python 2 httplib message object.)� �	z/Header continuation with no previous header: %s���rc�:r)r:�
startswithr�strip�splitrY)�cls�messageZobs_fold_continued_leadersr:�liner$r+rrr
�from_httplib6s

�zHTTPHeaderDict.from_httplib)N)%rrrr5r"r,r&r-rFrQrRrrrr�objectrUr.r0r#rWrZr9r`Z
getheadersZgetallmatchingheadersZigetZget_allrar8rbr]rNr^�classmethodrm�
__classcell__rrr<r
rjs>!	
N)Z
__future__rZcollections.abcrr�ImportError�collectionsZ	threadingrr�
exceptionsrZpackages.sixrrr�__all__rnr'rrrrrr
�<module>sLsite-packages/pip/_vendor/urllib3/__pycache__/poolmanager.cpython-38.opt-1.pyc000064400000031150151446177000023174 0ustar00U

��.e�B�@sddlmZddlZddlZddlZddlmZddlmZm	Z	ddlm
Z
ddlmZm
Z
mZddlmZdd	lmZdd
lmZddlmZddlmZd
ddgZe�e�ZdZdZe�de�Z dd�Z!e�"e!e �e�"e!e �d�Z#ee	d�Z$Gdd
�d
e�Z%Gdd�de%�Z&dd�Z'dS)�)�absolute_importN�)�RecentlyUsedContainer)�HTTPConnectionPool�HTTPSConnectionPool)�port_by_scheme)�LocationValueError�
MaxRetryError�ProxySchemeUnknown)�six)�urljoin)�RequestMethods)�	parse_url)�Retry�PoolManager�ProxyManager�proxy_from_url)Zkey_fileZ	cert_fileZ	cert_reqsZca_certsZssl_versionZca_cert_dirZssl_contextZkey_password)Z
key_schemeZkey_hostZkey_portZkey_timeoutZkey_retriesZ
key_strictZ	key_blockZkey_source_addressZkey_key_fileZkey_key_passwordZ
key_cert_fileZ
key_cert_reqsZkey_ca_certsZkey_ssl_versionZkey_ca_cert_dirZkey_ssl_contextZkey_maxsizeZkey_headersZ
key__proxyZkey__proxy_headersZkey_socket_optionsZkey__socks_optionsZkey_assert_hostnameZkey_assert_fingerprintZkey_server_hostname�PoolKeycCs�|��}|d��|d<|d��|d<dD],}||kr,||dk	r,t||���||<q,|�d�}|dk	rxt|�|d<t|���D]}|�|�|d|<q�|j	D]}||kr�d||<q�|f|�S)a�
    Create a pool key out of a request context dictionary.

    According to RFC 3986, both the scheme and host are case-insensitive.
    Therefore, this function normalizes both before constructing the pool
    key for an HTTPS request. If you wish to change this behaviour, provide
    alternate callables to ``key_fn_by_scheme``.

    :param key_class:
        The class to use when constructing the key. This should be a namedtuple
        with the ``scheme`` and ``host`` keys at a minimum.
    :type  key_class: namedtuple
    :param request_context:
        A dictionary-like object that contain the context for a request.
    :type  request_context: dict

    :return: A namedtuple that can be used as a connection pool key.
    :rtype:  PoolKey
    �scheme�host)�headers�_proxy_headersZ_socks_optionsNZsocket_optionsZkey_)
�copy�lower�	frozenset�items�get�tuple�list�keys�pop�_fields)Z	key_class�request_context�context�keyZsocket_optsZfield�r%�C/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/poolmanager.py�_default_key_normalizerDs


r'��http�httpsc@sxeZdZdZdZddd�Zdd�Zdd	�Zdd
d�Zdd
�Z	ddd�Z
dd�Zddd�Zd dd�Z
dd�Zd!dd�ZdS)"ra$
    Allows for arbitrary requests while transparently keeping track of
    necessary connection pools for you.

    :param num_pools:
        Number of connection pools to cache before discarding the least
        recently used pool.

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.

    :param \**connection_pool_kw:
        Additional parameters are used to create fresh
        :class:`urllib3.connectionpool.ConnectionPool` instances.

    Example::

        >>> manager = PoolManager(num_pools=2)
        >>> r = manager.request('GET', 'http://google.com/')
        >>> r = manager.request('GET', 'http://google.com/mail')
        >>> r = manager.request('GET', 'http://yahoo.com/')
        >>> len(manager.pools)
        2

    N�
cKs8t�||�||_t|dd�d�|_t|_t��|_dS)NcSs|��S�N)�close)�pr%r%r&�<lambda>��z&PoolManager.__init__.<locals>.<lambda>)Zdispose_func)r
�__init__�connection_pool_kwr�pools�pool_classes_by_scheme�key_fn_by_schemer)�self�	num_poolsrr2r%r%r&r1�s
zPoolManager.__init__cCs|Sr,r%�r6r%r%r&�	__enter__�szPoolManager.__enter__cCs|��dS)NF)�clear)r6�exc_typeZexc_valZexc_tbr%r%r&�__exit__�szPoolManager.__exit__cCs^|j|}|dkr|j��}dD]}|�|d�q |dkrPtD]}|�|d�q>|||f|�S)a�
        Create a new :class:`ConnectionPool` based on host, port, scheme, and
        any additional pool keyword arguments.

        If ``request_context`` is provided, it is provided as keyword arguments
        to the pool class used. This method is used to actually create the
        connection pools handed out by :meth:`connection_from_url` and
        companion methods. It is intended to be overridden for customization.
        N)rr�portr))r4r2rr �SSL_KEYWORDS)r6rrr=r"Zpool_clsr$�kwr%r%r&�	_new_pool�s


zPoolManager._new_poolcCs|j��dS)z�
        Empty our store of pools and direct them all to close.

        This will not affect in-flight connections, but they will not be
        re-used after completion.
        N)r3r:r8r%r%r&r:�szPoolManager.clearr)cCsT|std��|�|�}|pd|d<|s:t�|d��d�}||d<||d<|�|�S)a�
        Get a :class:`ConnectionPool` based on the host, port, and scheme.

        If ``port`` isn't given, it will be derived from the ``scheme`` using
        ``urllib3.connectionpool.port_by_scheme``. If ``pool_kwargs`` is
        provided, it is merged with the instance's ``connection_pool_kw``
        variable and used to create the new connection pool, if one is
        needed.
        zNo host specified.r)r�Pr=r)r�_merge_pool_kwargsrrr�connection_from_context)r6rr=r�pool_kwargsr"r%r%r&�connection_from_host�s
z PoolManager.connection_from_hostcCs,|d��}|j|}||�}|j||d�S)z�
        Get a :class:`ConnectionPool` based on the request context.

        ``request_context`` must at least contain the ``scheme`` key and its
        value must be a key in ``key_fn_by_scheme`` instance variable.
        r�r")rr5�connection_from_pool_key)r6r"rZpool_key_constructor�pool_keyr%r%r&rC�s
z#PoolManager.connection_from_contextc
Csl|jj�Z|j�|�}|r*|W5QR�S|d}|d}|d}|j||||d�}||j|<W5QRX|S)z�
        Get a :class:`ConnectionPool` based on the provided pool key.

        ``pool_key`` should be a namedtuple that only contains immutable
        objects. At a minimum it must have the ``scheme``, ``host``, and
        ``port`` fields.
        rrr=rF)r3�lockrr@)r6rHr"Zpoolrrr=r%r%r&rG�s
z$PoolManager.connection_from_pool_keycCs t|�}|j|j|j|j|d�S)a�
        Similar to :func:`urllib3.connectionpool.connection_from_url`.

        If ``pool_kwargs`` is not provided and a new pool needs to be
        constructed, ``self.connection_pool_kw`` is used to initialize
        the :class:`urllib3.connectionpool.ConnectionPool`. If ``pool_kwargs``
        is provided, it is used instead. Note that if a new pool does not
        need to be created for the request, the provided ``pool_kwargs`` are
        not used.
        )r=rrD)rrErr=r)r6�urlrD�ur%r%r&�connection_from_urls�zPoolManager.connection_from_urlc	CsV|j��}|rR|��D]:\}}|dkrHz
||=WqPtk
rDYqPXq|||<q|S)a
        Merge a dictionary of override values for self.connection_pool_kw.

        This does not modify self.connection_pool_kw and returns a new dict.
        Any keys in the override dictionary with a value of ``None`` are
        removed from the merged dictionary.
        N)r2rr�KeyError)r6�overrideZbase_pool_kwargsr$�valuer%r%r&rB!s


zPoolManager._merge_pool_kwargsTcKs�t|�}|j|j|j|jd�}d|d<d|d<d|krD|j��|d<|jdk	rj|jdkrj|j||f|�}n|j||j	f|�}|o�|�
�}|s�|St||�}|jdkr�d	}|�
d
�}	t|	t�s�tj|	|d�}	|	j�r|�|��stt�|d��}
|
D]"}|��|	jkr�|d�|d�q�z|	j||||d�}	Wn$tk
�rR|	j�rJ�|YSX|	|d
<||d<t�d
||�|j||f|�S)a]
        Same as :meth:`urllib3.connectionpool.HTTPConnectionPool.urlopen`
        with custom cross-host redirect logic and only sends the request-uri
        portion of the ``url``.

        The given ``url`` parameter must be absolute, such that an appropriate
        :class:`urllib3.connectionpool.ConnectionPool` can be chosen for it.
        )r=rFZassert_same_host�redirectrNr)i/ZGET�retries)rP)�responseZ_poolzRedirecting %s -> %s)rrErr=rrr�proxy�urlopenZrequest_uriZget_redirect_locationrZstatusr�
isinstancerZfrom_intZremove_headers_on_redirectZis_same_hostrrZiterkeysrr Z	incrementr	Zraise_on_redirect�log�info)r6�methodrJrPr?rKZconnrRZredirect_locationrQr�headerr%r%r&rT5sF	



�
zPoolManager.urlopen)r+N)N)Nr)N)N)N)T)�__name__�
__module__�__qualname__�__doc__rSr1r9r<r@r:rErCrGrLrBrTr%r%r%r&r�s


	


csHeZdZdZd�fdd�	Zd�fdd�	Zdd	d
�Zd�fdd
�	Z�ZS)rax
    Behaves just like :class:`PoolManager`, but sends all requests through
    the defined proxy, using the CONNECT method for HTTPS URLs.

    :param proxy_url:
        The URL of the proxy to be used.

    :param proxy_headers:
        A dictionary containing headers that will be sent to the proxy. In case
        of HTTP they are being sent with each request, while in the
        HTTPS/CONNECT case they are sent only once. Could be used for proxy
        authentication.

    Example:
        >>> proxy = urllib3.ProxyManager('http://localhost:3128/')
        >>> r1 = proxy.request('GET', 'http://google.com/')
        >>> r2 = proxy.request('GET', 'http://httpbin.org/')
        >>> len(proxy.pools)
        1
        >>> r3 = proxy.request('GET', 'https://httpbin.org/')
        >>> r4 = proxy.request('GET', 'https://twitter.com/')
        >>> len(proxy.pools)
        3

    r+Ncs�t|t�rd|j|j|jf}t|�}|jsFt�|jd�}|j|d�}|jdkrZt	|j��||_
|pfi|_|j
|d<|j|d<tt
|�j||f|�dS)Nz
%s://%s:%irA)r=r(�_proxyr)rUrrrr=rrr�_replacer
rS�
proxy_headers�superrr1)r6�	proxy_urlr7rr`r2rSr=��	__class__r%r&r1�s"	
�




zProxyManager.__init__r)csD|dkr tt|�j||||d�Stt|�j|jj|jj|jj|d�S)Nr*)rD)rarrErSrr=r)r6rr=rrDrcr%r&rE�s
�
�z!ProxyManager.connection_from_hostcCs0ddi}t|�j}|r||d<|r,|�|�|S)z�
        Sets headers needed by proxies: specifically, the Accept and Host
        headers. Only sets headers not provided by the user.
        ZAcceptz*/*ZHost)r�netloc�update)r6rJrZheaders_rer%r%r&�_set_proxy_headers�s

zProxyManager._set_proxy_headersTcsNt|�}|jdkr0|�d|j�}|�||�|d<tt|�j||fd|i|��S)z@Same as HTTP(S)ConnectionPool.urlopen, ``url`` must be absolute.r)rrP)rrrrrgrarrT)r6rXrJrPr?rKrrcr%r&rT�s

zProxyManager.urlopen)r+NN)Nr)N)N)T)	rZr[r\r]r1rErgrT�
__classcell__r%r%rcr&rts�

cKstfd|i|��S)Nrb)r)rJr?r%r%r&r�s)(Z
__future__r�collections�	functoolsZlogging�_collectionsrZconnectionpoolrrr�
exceptionsrr	r
ZpackagesrZpackages.six.moves.urllib.parserZrequestr
Zutil.urlrZ
util.retryr�__all__Z	getLoggerrZrVr>Z_key_fields�
namedtuplerr'�partialr5r4rrrr%r%r%r&�<module>s4


6

�
tasite-packages/pip/_vendor/urllib3/__pycache__/connectionpool.cpython-38.opt-1.pyc000064400000056730151446177000023734 0ustar00U

��.e^��@s�ddlmZddlZddlZddlZddlZddlmZm	Z
ddlZddlmZm
Z
mZmZmZmZmZmZmZmZmZmZmZddlmZddlmZddlmZdd	lm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&dd
l'm(Z(ddl)m*Z*ddl+m,Z,dd
l-m.Z.ddl/m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6m7Z7m8Z8m9Z:m;Z;ddl<m=Z=ej>j?Z?e�@eA�ZBeC�ZDGdd�deC�ZEejFejGhZHGdd�deEe(�ZIGdd�deI�ZJdd�ZKdd�Z9dS)�)�absolute_importN)�error�timeout�)
�ClosedPoolError�
ProtocolError�EmptyPoolError�HeaderParsingError�HostChangedError�LocationValueError�
MaxRetryError�
ProxyError�ReadTimeoutError�SSLError�TimeoutError�InsecureRequestWarning�NewConnectionError)�CertificateError)�six)�queue)�port_by_scheme�DummyConnection�HTTPConnection�HTTPSConnection�VerifiedHTTPSConnection�
HTTPException�BaseSSLError)�RequestMethods)�HTTPResponse)�is_connection_dropped)�set_file_position)�assert_header_parsing)�Retry)�Timeout)�get_host�	parse_url�Url�_normalize_host�_encode_target)�	LifoQueuec@sBeZdZdZdZeZd
dd�Zdd�Zdd�Z	d	d
�Z
dd�ZdS)�ConnectionPoolzz
    Base class for all connection pools, such as
    :class:`.HTTPConnectionPool` and :class:`.HTTPSConnectionPool`.
    NcCs0|std��t||jd�|_|��|_||_dS)NzNo host specified.��scheme)rr'r,�host�lower�_proxy_host�port)�selfr-r0�r2�F/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/connectionpool.py�__init__Is

zConnectionPool.__init__cCsdt|�j|j|jfS)Nz%s(host=%r, port=%r))�type�__name__r-r0�r1r2r2r3�__str__QszConnectionPool.__str__cCs|S�Nr2r7r2r2r3�	__enter__TszConnectionPool.__enter__cCs|��dS)NF)�close)r1�exc_typeZexc_valZexc_tbr2r2r3�__exit__WszConnectionPool.__exit__cCsdS)�D
        Close all pooled connections and disable the pool.
        Nr2r7r2r2r3r;\szConnectionPool.close)N)r6�
__module__�__qualname__�__doc__r,r)�QueueClsr4r8r:r=r;r2r2r2r3r*@s
r*c
@s�eZdZdZdZeZeZdde	j
ddddddf	dd�Zdd	�Zd!d
d�Z
dd
�Zdd�Zdd�Zdd�Zdd�Zedfdd�Zdd�Zdd�Zdd�Zdddddeddddf
dd �ZdS)"�HTTPConnectionPoolaN	
    Thread-safe connection pool for one host.

    :param host:
        Host used for this HTTP Connection (e.g. "localhost"), passed into
        :class:`httplib.HTTPConnection`.

    :param port:
        Port used for this HTTP Connection (None is equivalent to 80), passed
        into :class:`httplib.HTTPConnection`.

    :param strict:
        Causes BadStatusLine to be raised if the status line can't be parsed
        as a valid HTTP/1.0 or 1.1 status line, passed into
        :class:`httplib.HTTPConnection`.

        .. note::
           Only works in Python 2. This parameter is ignored in Python 3.

    :param timeout:
        Socket timeout in seconds for each individual connection. This can
        be a float or integer, which sets the timeout for the HTTP request,
        or an instance of :class:`urllib3.util.Timeout` which gives you more
        fine-grained control over request timeouts. After the constructor has
        been parsed, this is always a `urllib3.util.Timeout` object.

    :param maxsize:
        Number of connections to save that can be reused. More than 1 is useful
        in multithreaded situations. If ``block`` is set to False, more
        connections will be created but they will not be saved once they've
        been used.

    :param block:
        If set to True, no more than ``maxsize`` connections will be used at
        a time. When no free connections are available, the call will block
        until a connection has been released. This is a useful side effect for
        particular multithreaded situations where one does not want to use more
        than maxsize connections per host to prevent flooding.

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.

    :param retries:
        Retry configuration to use by default with requests in this pool.

    :param _proxy:
        Parsed proxy URL, should not be used directly, instead, see
        :class:`urllib3.connectionpool.ProxyManager`"

    :param _proxy_headers:
        A dictionary with proxy headers, should not be used directly,
        instead, see :class:`urllib3.connectionpool.ProxyManager`"

    :param \**conn_kw:
        Additional parameters are used to create fresh :class:`urllib3.connection.HTTPConnection`,
        :class:`urllib3.connection.HTTPSConnection` instances.
    �httpNFrc
Ks�t�|||�t�||�||_t|t�s4t�|�}|dkrBtj}||_	||_
|�|�|_||_
|	|_|
pli|_t|�D]}|j�d�qxd|_d|_||_|jr�|j�dg�dS)NrZsocket_options)r*r4r�strict�
isinstancer#�
from_floatr"ZDEFAULTr�retriesrB�pool�block�proxy�
proxy_headers�xrange�put�num_connections�num_requests�conn_kw�
setdefault)
r1r-r0rEr�maxsizerJ�headersrH�_proxy�_proxy_headersrQ�_r2r2r3r4�s(


zHTTPConnectionPool.__init__cCsR|jd7_t�d|j|j|jp$d�|jf|j|j|jj|jd�|j	��}|S)z9
        Return a fresh :class:`HTTPConnection`.
        rz(Starting new HTTP connection (%d): %s:%sZ80)r-r0rrE)
rO�log�debugr-r0�
ConnectionClsr�connect_timeoutrErQ�r1�connr2r2r3�	_new_conn�s ���zHTTPConnectionPool._new_conncCs�d}z|jj|j|d�}WnBtk
r8t|d��Yn&tjk
r\|jrXt|d��YnX|r�t|�r�t	�
d|j�|��t
|dd�dkr�d}|p�|��S)	a�
        Get a connection. Will return a pooled connection if one is available.

        If no connections are available and :prop:`.block` is ``False``, then a
        fresh connection is returned.

        :param timeout:
            Seconds to wait before giving up and raising
            :class:`urllib3.exceptions.EmptyPoolError` if the pool is empty and
            :prop:`.block` is ``True``.
        N)rJrzPool is closed.z>Pool reached maximum size and no more connections are allowed.z Resetting dropped connection: %sZ	auto_openrr)rI�getrJ�AttributeErrorrr�EmptyrrrXrYr-r;�getattrr^)r1rr]r2r2r3�	_get_conn�s$�zHTTPConnectionPool._get_conncCs^z|jj|dd�WdStk
r*Yn$tjk
rLt�d|j�YnX|rZ|��dS)a�
        Put a connection back into the pool.

        :param conn:
            Connection object for the current host and port as returned by
            :meth:`._new_conn` or :meth:`._get_conn`.

        If the pool is already full, the connection is closed and discarded
        because we exceeded maxsize. If connections are discarded frequently,
        then maxsize should be increased.

        If the pool is closed, then the connection will be closed and discarded.
        F�rJNz2Connection pool is full, discarding connection: %s)	rIrNr`rZFullrX�warningr-r;r\r2r2r3�	_put_connszHTTPConnectionPool._put_conncCsdS)�U
        Called right before a request is made, after the socket is created.
        Nr2r\r2r2r3�_validate_conn0sz!HTTPConnectionPool._validate_conncCsdSr9r2r\r2r2r3�_prepare_proxy6sz!HTTPConnectionPool._prepare_proxycCs2|tkr|j��St|t�r$|��St�|�SdS)z< Helper that always returns a :class:`urllib3.util.Timeout` N)�_DefaultrZclonerFr#rG)r1rr2r2r3�_get_timeout:s


zHTTPConnectionPool._get_timeoutcCsjt|t�rt||d|��t|d�r>|jtkr>t||d|��dt|�ksVdt|�krft||d|��dS)zAIs the error actually a timeout? Will raise a ReadTimeout or pass�!Read timed out. (read timeout=%s)�errnoz	timed outzdid not complete (read)N)rF�
SocketTimeoutr�hasattrrm�_blocking_errnos�str)r1�err�url�
timeout_valuer2r2r3�_raise_timeoutFs(
����z!HTTPConnectionPool._raise_timeoutc

Ks|jd7_|�|�}|��|j|_z|�|�Wn:ttfk
rp}z|j|||jd��W5d}~XYnX|r�|j	||f|�n|j
||f|�|j}	t|dd�r�|	dkr�t
||d|	��|	tjkr�|j�t���n|j�|	�zjz|jdd�}
WnTtk
�rPz|��}
Wn0tk
�rJ}zt�|d�W5d}~XYnXYnXWn<tttfk
�r�}z|j|||	d��W5d}~XYnXt|d	d
�}t�d|j|j|j||||
j|
j �	zt!|
j"�Wn@t#tfk
�r}ztj$d|�%|�|dd
�W5d}~XYnX|
S)a
        Perform a request on a given urllib connection object taken from our
        pool.

        :param conn:
            a connection from one of our connection pools

        :param timeout:
            Socket timeout in seconds for the request. This can be a
            float or integer, which will set the same timeout value for
            the socket connect and the socket read, or an instance of
            :class:`urllib3.util.Timeout`, which gives you more fine-grained
            control over your timeouts.
        r)rrrsrtN�sockrrlT)�	bufferingZ
_http_vsn_strzHTTP/?z%s://%s:%s "%s %s %s" %s %sz$Failed to parse headers (url=%s): %s)�exc_info)&rPrkZ
start_connectr[rrhrnrruZrequest_chunked�request�read_timeoutrbrr#�DEFAULT_TIMEOUTrvZ
settimeout�socketZgetdefaulttimeoutZgetresponse�	TypeError�
BaseExceptionrZ
raise_from�SocketErrorrXrYr,r-r0�statusZlengthr!�msgr	re�
_absolute_url)
r1r]�methodrsr�chunkedZhttplib_request_kw�timeout_obj�erz�httplib_responseZhttp_versionZhper2r2r3�
_make_request_sp
�
(��z HTTPConnectionPool._make_requestcCst|j|j|j|d�jS)N)r,r-r0�path)r&r,r-r0rs)r1r�r2r2r3r��sz HTTPConnectionPool._absolute_urlcCsV|jdkrdS|jd}|_z|jdd�}|r|��qWntjk
rPYnXdS)r>NFrd)rIr_r;rra)r1Zold_poolr]r2r2r3r;�s
zHTTPConnectionPool.closecCsx|�d�rdSt|�\}}}|dk	r0t||d�}|jrF|sFt�|�}n|js^|t�|�kr^d}|||f|j|j|jfkS)zj
        Check if the given ``url`` is a member of the same host as this
        connection pool.
        �/TNr+)�
startswithr$r'r0rr_r,r-)r1rsr,r-r0r2r2r3�is_same_host�s

zHTTPConnectionPool.is_same_hostTc
Ks|dkr|j}t|t�s*tj|||jd�}|
dkr>|
�dd�}
|rX|�|�sXt|||��|�d�rrt	�
t|��}nt	�
t|�j
�}d}|
}|jdkr�|��}|�|j�d}d}t||�}�ztz�|�|�}|j|	d�}|j|_|jdk	o�t|d	d�}|�r|�|�|j|||||||d
�}|
�s(|nd}||
d<|jj|f|||d�|
��}d}Wn�tj k
�rxt!|d
��Yn�t"t#t$t%t&t't(fk
�r,}z�d}t|t&t(f��r�t'|�}n>t|t$t)f��r�|j�r�t*d|�}nt|t$t#f��r�t%d|�}|j+||||t,�-�dd�}|�.�|}W5d}~XYnXW5|�sJ|�oD|��}d}|�rZ|�|�X|�s�t/�0d|||�|j1|||||||f||	|
|d�|
��Sdd�}|�o�|�2�}|�rR|j3dk�r�d}z|j+||||d�}Wn,t4k
�r|j5�r||��|YSX||�|�6|�t/�7d||�|j1||||f|||||	|
|d�|
��St8|�9d��}|�:||j3|��r�z|j+||||d�}Wn,t4k
�r�|j;�r�||��|YSX||�|�.|�t/�7d|�|j1||||f|||||	|
|d�|
��S|S)a�
        Get a connection from the pool and perform an HTTP request. This is the
        lowest level call for making a request, so you'll need to specify all
        the raw details.

        .. note::

           More commonly, it's appropriate to use a convenience method provided
           by :class:`.RequestMethods`, such as :meth:`request`.

        .. note::

           `release_conn` will only behave as expected if
           `preload_content=False` because we want to make
           `preload_content=False` the default behaviour someday soon without
           breaking backwards compatibility.

        :param method:
            HTTP request method (such as GET, POST, PUT, etc.)

        :param body:
            Data to send in the request body (useful for creating
            POST requests, see HTTPConnectionPool.post_url for
            more convenience).

        :param headers:
            Dictionary of custom headers to send, such as User-Agent,
            If-None-Match, etc. If None, pool headers are used. If provided,
            these headers completely replace any pool-specific headers.

        :param retries:
            Configure the number of retries to allow before raising a
            :class:`~urllib3.exceptions.MaxRetryError` exception.

            Pass ``None`` to retry until you receive a response. Pass a
            :class:`~urllib3.util.retry.Retry` object for fine-grained control
            over different types of retries.
            Pass an integer number to retry connection errors that many times,
            but no other types of errors. Pass zero to never retry.

            If ``False``, then retries are disabled and any exception is raised
            immediately. Also, instead of raising a MaxRetryError on redirects,
            the redirect response will be returned.

        :type retries: :class:`~urllib3.util.retry.Retry`, False, or an int.

        :param redirect:
            If True, automatically handle redirects (status codes 301, 302,
            303, 307, 308). Each redirect counts as a retry. Disabling retries
            will disable redirect, too.

        :param assert_same_host:
            If ``True``, will make sure that the host of the pool requests is
            consistent else will raise HostChangedError. When False, you can
            use the pool on an HTTP proxy and request foreign hosts.

        :param timeout:
            If specified, overrides the default timeout for this one
            request. It may be a float (in seconds) or an instance of
            :class:`urllib3.util.Timeout`.

        :param pool_timeout:
            If set and the pool is set to block=True, then this method will
            block for ``pool_timeout`` seconds and raise EmptyPoolError if no
            connection is available within the time period.

        :param release_conn:
            If False, then the urlopen call will not release the connection
            back into the pool once a response is received (but will release if
            you read the entire contents of the response such as when
            `preload_content=True`). This is useful if you're not preloading
            the response's content immediately. You will need to call
            ``r.release_conn()`` on the response ``r`` to return the connection
            back into the pool. If None, it takes the value of
            ``response_kw.get('preload_content', True)``.

        :param chunked:
            If True, urllib3 will send the body using chunked transfer
            encoding. Otherwise, urllib3 will send the body using the standard
            content-length form. Defaults to False.

        :param int body_pos:
            Position to seek to in file-like body in the event of a retry or
            redirect. Typically this won't need to be set because urllib3 will
            auto-populate the value when needed.

        :param \**response_kw:
            Additional parameters are passed to
            :meth:`urllib3.response.HTTPResponse.from_httplib`
        N)�redirect�defaultZpreload_contentTr�rDF)rrv)r�bodyrTr�Zrequest_method)rI�
connectionrHz"No pool connections are available.zCannot connect to proxy.zConnection aborted.�)r�_poolZ_stacktracez1Retrying (%r) after connection broken by '%r': %s)r�pool_timeout�release_conn�body_posc
Ss2z|��Wn ttttttfk
r,YnXdSr9)�readrrrrrr)�responser2r2r3�drain_and_release_conn�s�z:HTTPConnectionPool.urlopen.<locals>.drain_and_release_conni/ZGET)r�r�zRedirecting %s -> %s)rHr��assert_same_hostrr�r�r�zRetry-Afterz	Retry: %s)<rTrFr"Zfrom_intrHr_r�r
r�rZ
ensure_strr(r%rsr,�copy�updaterLr r;rfrkrcr[rrKrbrir��ResponseClsZfrom_httplibrrarrrrrrrrrr
Z	increment�sysrx�sleeprXre�urlopenZget_redirect_locationr�rZraise_on_redirectZsleep_for_retryrY�boolZ	getheaderZis_retryZraise_on_status)r1r�rsr�rTrHr�r�rr�r�r�r�Zresponse_kwr]Zrelease_this_connrrZ
clean_exitr�Zis_new_proxy_connr�Z
response_connr�r�r�Zredirect_locationZhas_retry_afterr2r2r3r��sLj




�
����	�


�����

���

���zHTTPConnectionPool.urlopen)N)r6r?r@rAr,rrZrr�r#r{r4r^rcrfrhrirkrurjr�r�r;r�r�r2r2r2r3rCgsL;�
1
'�
e�rCcspeZdZdZdZeZddejdddddddddddddddfdd�Z	dd	�Z
d
d�Zdd
�Z�fdd�Z
�ZS)�HTTPSConnectionPoola�
    Same as :class:`.HTTPConnectionPool`, but HTTPS.

    When Python is compiled with the :mod:`ssl` module, then
    :class:`.VerifiedHTTPSConnection` is used, which *can* verify certificates,
    instead of :class:`.HTTPSConnection`.

    :class:`.VerifiedHTTPSConnection` uses one of ``assert_fingerprint``,
    ``assert_hostname`` and ``host`` in this order to verify connections.
    If ``assert_hostname`` is False, no verification is done.

    The ``key_file``, ``cert_file``, ``cert_reqs``, ``ca_certs``,
    ``ca_cert_dir``, ``ssl_version``, ``key_password`` are only used if :mod:`ssl`
    is available and are fed into :meth:`urllib3.util.ssl_wrap_socket` to upgrade
    the connection socket into an SSL socket.
    �httpsNFrcKs\tj||||||||||	|
f|�||_||_|
|_||_||_||_||_||_	||_
dSr9)rCr4�key_file�	cert_file�	cert_reqs�key_password�ca_certs�ca_cert_dir�ssl_version�assert_hostname�assert_fingerprint)r1r-r0rErrSrJrTrHrUrVr�r�r�r�r�r�r�r�r�rQr2r2r3r4is0��zHTTPSConnectionPool.__init__c
Cs@t|t�r<|j|j|j|j|j|j|j|j	|j
d�|j|_|S)z�
        Prepare the ``connection`` for :meth:`urllib3.util.ssl_wrap_socket`
        and establish the tunnel if proxy is used.
        )r�r�r�r�r�r�r�r�)rFrZset_certr�r�r�r�r�r�r�r�r�r\r2r2r3�
_prepare_conn�s
�
z!HTTPSConnectionPool._prepare_conncCs |�|j|j|j�|��dS)z�
        Establish tunnel connection early, because otherwise httplib
        would improperly set Host: header to proxy's IP:port.
        N)Z
set_tunnelr/r0rL�connectr\r2r2r3ri�sz"HTTPSConnectionPool._prepare_proxyc
Cs�|jd7_t�d|j|j|jp$d�|jr8|jtkr@td��|j}|j}|jdk	rf|jj}|jj}|jf|||j	j
|j|j|j
|jd�|j��}|�|�S)zB
        Return a fresh :class:`httplib.HTTPSConnection`.
        rz)Starting new HTTPS connection (%d): %s:%sZ443zCCan't connect to HTTPS URL because the SSL module is not available.N)r-r0rrEr�r�r�)rOrXrYr-r0rZrrrKrr[rEr�r�r�rQr�)r1Zactual_hostZactual_portr]r2r2r3r^�s8��
��zHTTPSConnectionPool._new_conncs:tt|��|�t|dd�s$|��|js6t�dt�dS)rgrvNz�Unverified HTTPS request is being made. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings)	�superr�rhrbr�Zis_verified�warnings�warnrr\��	__class__r2r3rh�s�z"HTTPSConnectionPool._validate_conn)r6r?r@rAr,rrZr#r{r4r�rir^rh�
__classcell__r2r2r�r3r�Ts4�
1$r�cKsRt|�\}}}|pt�|d�}|dkr:t|fd|i|��St|fd|i|��SdS)a�
    Given a url, return an :class:`.ConnectionPool` instance of its host.

    This is a shortcut for not having to parse out the scheme, host, and port
    of the url before creating an :class:`.ConnectionPool` instance.

    :param url:
        Absolute URL string that must include the scheme. Port is optional.

    :param \**kw:
        Passes additional parameters to the constructor of the appropriate
        :class:`.ConnectionPool`. Useful for specifying things like
        timeout, maxsize, headers, etc.

    Example::

        >>> conn = connection_from_url('http://google.com/')
        >>> r = conn.request('GET', '/')
    �Pr�r0N)r$rr_r�rC)rs�kwr,r-r0r2r2r3�connection_from_url�s
r�cCs.t||�}|�d�r*|�d�r*|dd�}|S)z?
    Normalize hosts for comparisons and use with sockets.
    �[�]r���)�normalize_hostr��endswith)r-r,r2r2r3r's
r')LZ
__future__rrmZloggingr�r�r|rrrrn�
exceptionsrrrr	r
rrr
rrrrrZpackages.ssl_match_hostnamerZpackagesrZpackages.six.movesrr�rrrrrrrryrr�rZutil.connectionrZutil.requestr Z
util.responser!Z
util.retryr"Zutil.timeoutr#Zutil.urlr$r%r&r'r�r(Z
util.queuer)ZmovesrMZ	getLoggerr6rX�objectrjr*ZEAGAINZEWOULDBLOCKrprCr�r�r2r2r2r3�<module>sF<$	
$rsite-packages/pip/_vendor/urllib3/__pycache__/exceptions.cpython-38.opt-1.pyc000064400000023454151446177000023061 0ustar00U

��.e��@sLddlmZddlmZGdd�de�ZGdd�de�ZGdd	�d	e�Z	Gd
d�de	�Z
Gdd
�d
e�ZGdd�de�ZGdd�de�Z
Gdd�de�ZeZGdd�de
�ZGdd�de
�ZGdd�de�ZGdd�de�ZGdd�dee
�ZGdd�de�ZGd d!�d!ee	�ZGd"d#�d#e	�ZGd$d%�d%e	�ZGd&d'�d'ee�ZGd(d)�d)e�ZGd*d+�d+e�ZGd,d-�d-e�ZGd.d/�d/e�ZGd0d1�d1e�ZGd2d3�d3e�Z Gd4d5�d5e�Z!Gd6d7�d7e�Z"Gd8d9�d9e�Z#Gd:d;�d;ee�Z$Gd<d=�d=e�Z%Gd>d?�d?ee�ZGd@dA�dAe�Z&GdBdC�dCe'e�Z(GdDdE�dEe�Z)GdFdG�dGe�Z*dHS)I�)�absolute_import�)�IncompleteReadc@seZdZdZdS)�	HTTPErrorz#Base exception used by this module.N��__name__�
__module__�__qualname__�__doc__�rr�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/exceptions.pyrsrc@seZdZdZdS)�HTTPWarningz!Base warning used by this module.Nrrrrrr
sr
c@s eZdZdZdd�Zdd�ZdS)�	PoolErrorz/Base exception for errors caused within a pool.cCs||_t�|d||f�dS)Nz%s: %s)�poolr�__init__)�selfr�messagerrrrszPoolError.__init__cCs
|jdfS)N)NN��	__class__�rrrr�
__reduce__szPoolError.__reduce__N�rrr	r
rrrrrrrsrc@s eZdZdZdd�Zdd�ZdS)�RequestErrorz8Base exception for PoolErrors that have associated URLs.cCs||_t�|||�dS�N)�urlrr)rrrrrrrr szRequestError.__init__cCs|jd|jdffSr)rrrrrrr$szRequestError.__reduce__Nrrrrrrsrc@seZdZdZdS)�SSLErrorz9Raised when SSL certificate fails in an HTTPS connection.Nrrrrrr)src@seZdZdZdS)�
ProxyErrorz,Raised when the connection to a proxy fails.Nrrrrrr.src@seZdZdZdS)�DecodeErrorz;Raised when automatic decoding based on Content-Type fails.Nrrrrrr3src@seZdZdZdS)�
ProtocolErrorz>Raised when something unexpected happens mid-request/response.Nrrrrrr8src@seZdZdZddd�ZdS)�
MaxRetryErroraRaised when the maximum number of retries is exceeded.

    :param pool: The connection pool
    :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
    :param string url: The requested Url
    :param exceptions.Exception reason: The underlying error

    NcCs&||_d||f}t�||||�dS)Nz0Max retries exceeded with url: %s (Caused by %r))�reasonrr)rrrr rrrrrNszMaxRetryError.__init__)N�rrr	r
rrrrrrDs	rc@seZdZdZddd�ZdS)�HostChangedErrorz?Raised when an existing pool gets a request for a foreign host.�cCs"d|}t�||||�||_dS)Nz)Tried to open a foreign host with url: %s)rr�retries)rrrr$rrrrrYszHostChangedError.__init__N)r#r!rrrrr"Vsr"c@seZdZdZdS)�TimeoutStateErrorz3 Raised when passing an invalid state to a timeout Nrrrrrr%_sr%c@seZdZdZdS)�TimeoutErrorz� Raised when a socket timeout error occurs.

    Catching this error will catch both :exc:`ReadTimeoutErrors
    <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`.
    Nrrrrrr&esr&c@seZdZdZdS)�ReadTimeoutErrorzFRaised when a socket timeout occurs while receiving data from a serverNrrrrrr'osr'c@seZdZdZdS)�ConnectTimeoutErrorz@Raised when a socket timeout occurs while connecting to a serverNrrrrrr(vsr(c@seZdZdZdS)�NewConnectionErrorzHRaised when we fail to establish a new connection. Usually ECONNREFUSED.Nrrrrrr){sr)c@seZdZdZdS)�EmptyPoolErrorzCRaised when a pool runs out of connections and no more are allowed.Nrrrrrr*�sr*c@seZdZdZdS)�ClosedPoolErrorzCRaised when a request enters a pool after the pool has been closed.Nrrrrrr+�sr+c@seZdZdZdS)�LocationValueErrorz<Raised when there is something wrong with a given URL input.Nrrrrrr,�sr,c@seZdZdZdd�ZdS)�LocationParseErrorz=Raised when get_host or similar fails to parse the URL input.cCsd|}t�||�||_dS)NzFailed to parse: %s)rr�location)rr.rrrrr�szLocationParseError.__init__Nr!rrrrr-�sr-c@seZdZdZdZdZdS)�
ResponseErrorzDUsed as a container for an error reason supplied in a MaxRetryError.ztoo many error responsesz&too many {status_code} error responsesN)rrr	r
Z
GENERIC_ERRORZSPECIFIC_ERRORrrrrr/�sr/c@seZdZdZdS)�SecurityWarningz0Warned when performing security reducing actionsNrrrrrr0�sr0c@seZdZdZdS)�SubjectAltNameWarningzBWarned when connecting to a host with a certificate missing a SAN.Nrrrrrr1�sr1c@seZdZdZdS)�InsecureRequestWarningz/Warned when making an unverified HTTPS request.Nrrrrrr2�sr2c@seZdZdZdS)�SystemTimeWarningz0Warned when system time is suspected to be wrongNrrrrrr3�sr3c@seZdZdZdS)�InsecurePlatformWarningzEWarned when certain SSL configuration is not available on a platform.Nrrrrrr4�sr4c@seZdZdZdS)�SNIMissingWarningz9Warned when making a HTTPS request without SNI available.Nrrrrrr5�sr5c@seZdZdZdS)�DependencyWarningzc
    Warned when an attempt is made to import a module with missing optional
    dependencies.
    Nrrrrrr6�sr6c@seZdZdZdS)�ResponseNotChunkedz;Response needs to be chunked in order to read it as chunks.Nrrrrrr7�sr7c@seZdZdZdS)�BodyNotHttplibCompatiblezz
    Body should be httplib.HTTPResponse like (have an fp attribute which
    returns raw chunks) for read_chunked().
    Nrrrrrr8�sr8cs(eZdZdZ�fdd�Zdd�Z�ZS)rz�
    Response length doesn't match expected Content-Length

    Subclass of http_client.IncompleteRead to allow int value
    for `partial` to avoid creating large objects on streamed
    reads.
    cstt|��||�dSr)�superrr)r�partial�expectedrrrr�szIncompleteRead.__init__cCsd|j|jfS)Nz/IncompleteRead(%i bytes read, %i more expected))r:r;rrrr�__repr__�s�zIncompleteRead.__repr__)rrr	r
rr<�
__classcell__rrrrr�src@seZdZdZdS)�
InvalidHeaderz(The header provided was somehow invalid.Nrrrrrr>�sr>cs eZdZdZ�fdd�Z�ZS)�ProxySchemeUnknownz1ProxyManager does not support the supplied schemecsd|}tt|��|�dS)NzNot supported proxy scheme %s)r9r?r)rZschemerrrrr�szProxySchemeUnknown.__init__�rrr	r
rr=rrrrr?�sr?cs eZdZdZ�fdd�Z�ZS)�HeaderParsingErrorzNRaised by assert_header_parsing, but we convert it to a log.warning statement.cs$d|pd|f}tt|��|�dS)Nz%s, unparsed data: %rZUnknown)r9rAr)rZdefectsZ
unparsed_datarrrrr�szHeaderParsingError.__init__r@rrrrrA�srAc@seZdZdZdS)�UnrewindableBodyErrorz9urllib3 encountered an error when trying to rewind a bodyNrrrrrrB�srBN)+Z
__future__rZpackages.six.moves.http_clientrZhttplib_IncompleteRead�	Exceptionr�Warningr
rrrrrr�ConnectionErrorrr"r%r&r'r(r)r*r+�
ValueErrorr,r-r/r0r1r2r3r4r5r6r7r8r>�AssertionErrorr?rArBrrrr�<module>sH	

			site-packages/pip/_vendor/urllib3/__pycache__/fields.cpython-38.opt-1.pyc000064400000017643151446177000022151 0ustar00U

��.ei!�@s�ddlmZddlZddlZddlZddlmZddd�Zdd	�Z	d
ddd�Z
e
�d
d�edd�D��dd�Z
dd�ZeZGdd�de�ZdS)�)�absolute_importN�)�six�application/octet-streamcCs|rt�|�dp|S|S)z�
    Guess the "Content-Type" of a file.

    :param filename:
        The filename to guess the "Content-Type" of using :mod:`mimetypes`.
    :param default:
        If no "Content-Type" can be guessed, default to `default`.
    r)�	mimetypesZ
guess_type)�filename�default�r	�>/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/fields.py�guess_content_type	s	rc	s�t�tj�r��d��t�fdd�dD��sdd|�f}z|�d�Wnttfk
r^YnX|Stjrt��d��t	j
��d��d|�f�tjr���d���S)a�
    Helper function to format and quote a single header parameter using the
    strategy defined in RFC 2231.

    Particularly useful for header parameters which might contain
    non-ASCII values, like file names. This follows RFC 2388 Section 4.4.

    :param name:
        The name of the parameter, a string expected to be ASCII only.
    :param value:
        The value of the parameter, provided as ``bytes`` or `str``.
    :ret:
        An RFC-2231-formatted unicode string.
    �utf-8c3s|]}|�kVqdS�Nr	)�.0Zch��valuer	r
�	<genexpr>)sz.format_header_param_rfc2231.<locals>.<genexpr>z"\
�%s="%s"�asciiz%s*=%s)�
isinstancer�binary_type�decode�any�encode�UnicodeEncodeError�UnicodeDecodeErrorZPY2�emailZutilsZencode_rfc2231)�namer�resultr	rr
�format_header_param_rfc2231s 


rz%22z\\)�"�\r cCs&i|]}|dkrt�|�d�|��qS))�z%{:02X})rZunichr�format)rZccr	r	r
�
<dictcomp>Is�r#� cs:�fdd�}t�d�dd����D���}|�||�}|S)Ncs�|�d�S)Nr)�group)�match��needles_and_replacementsr	r
�replacerRsz#_replace_multiple.<locals>.replacer�|cSsg|]}t�|��qSr	)�re�escape)rZneedler	r	r
�
<listcomp>Vsz%_replace_multiple.<locals>.<listcomp>)r+�compile�join�keys�sub)rr(r)�patternrr	r'r
�_replace_multipleQs�r3cCs,t|tj�r|�d�}t|t�}d||fS)a�
    Helper function to format and quote a single header parameter using the
    HTML5 strategy.

    Particularly useful for header parameters which might contain
    non-ASCII values, like file names. This follows the `HTML5 Working Draft
    Section 4.10.22.7`_ and matches the behavior of curl and modern browsers.

    .. _HTML5 Working Draft Section 4.10.22.7:
        https://w3c.github.io/html/sec-forms.html#multipart-form-data

    :param name:
        The name of the parameter, a string expected to be ASCII only.
    :param value:
        The value of the parameter, provided as ``bytes`` or `str``.
    :ret:
        A unicode string, stripped of troublesome characters.
    rr)rrrrr3�_HTML5_REPLACEMENTS)rrr	r	r
�format_header_param_html5^s

r5c@sReZdZdZddefdd�Zeefdd��Zdd�Zd	d
�Z	dd�Z
dd
d�ZdS)�RequestFielda
    A data container for request body parameters.

    :param name:
        The name of this request field. Must be unicode.
    :param data:
        The data/value body.
    :param filename:
        An optional filename of the request field. Must be unicode.
    :param headers:
        An optional dict-like object of headers to initially use for the field.
    :param header_formatter:
        An optional callable that is used to encode and format the headers. By
        default, this is :func:`format_header_param_html5`.
    NcCs0||_||_||_i|_|r&t|�|_||_dSr
)�_name�	_filename�data�headers�dict�header_formatter)�selfrr9rr:r<r	r	r
�__init__�s
zRequestField.__init__cCs`t|t�r4t|�dkr"|\}}}q@|\}}t|�}nd}d}|}|||||d�}|j|d�|S)a�
        A :class:`~urllib3.fields.RequestField` factory from old-style tuple parameters.

        Supports constructing :class:`~urllib3.fields.RequestField` from
        parameter of key/value strings AND key/filetuple. A filetuple is a
        (filename, data, MIME type) tuple where the MIME type is optional.
        For example::

            'foo': 'bar',
            'fakefile': ('foofile.txt', 'contents of foofile'),
            'realfile': ('barfile.txt', open('realfile').read()),
            'typedfile': ('bazfile.bin', open('bazfile').read(), 'image/jpeg'),
            'nonamefile': 'contents of nonamefile field',

        Field names and filenames must be unicode.
        �N)rr<)�content_type)r�tuple�lenr�make_multipart)�clsZ	fieldnamerr<rr9r@Z
request_paramr	r	r
�from_tuples�s 

�zRequestField.from_tuplescCs|�||�S)aI
        Overridable helper function to format a single header parameter. By
        default, this calls ``self.header_formatter``.

        :param name:
            The name of the parameter, a string expected to be ASCII only.
        :param value:
            The value of the parameter, provided as a unicode string.
        )r<)r=rrr	r	r
�_render_part�szRequestField._render_partcCsLg}|}t|t�r|��}|D]"\}}|dk	r|�|�||��qd�|�S)aO
        Helper function to format and quote a single header.

        Useful for single headers that are composed of multiple items. E.g.,
        'Content-Disposition' fields.

        :param header_parts:
            A sequence of (k, v) tuples or a :class:`dict` of (k, v) to format
            as `k1="v1"; k2="v2"; ...`.
        N�; )rr;�items�appendrFr/)r=Zheader_parts�parts�iterablerrr	r	r
�
_render_parts�s
zRequestField._render_partscCs�g}dddg}|D]*}|j�|d�r|�d||j|f�q|j��D]&\}}||krH|rH|�d||f�qH|�d�d�|�S)z=
        Renders the headers for this request field.
        �Content-Disposition�Content-Type�Content-LocationFz%s: %sz
)r:�getrIrHr/)r=�linesZ	sort_keysZsort_keyZheader_nameZheader_valuer	r	r
�render_headers�s

zRequestField.render_headerscCsX|pd|jd<|jdd�d|�d|jfd|jff�g�7<||jd<||jd<d	S)
a|
        Makes this request field into a multipart request field.

        This method overrides "Content-Disposition", "Content-Type" and
        "Content-Location" headers to the request parameter.

        :param content_type:
            The 'Content-Type' of the request body.
        :param content_location:
            The 'Content-Location' of the request body.

        z	form-datarMrG�rrrNrON)r:r/rLr7r8)r=Zcontent_dispositionr@Zcontent_locationr	r	r
rC�s���
zRequestField.make_multipart)NNN)�__name__�
__module__�__qualname__�__doc__r5r>�classmethodrErFrLrRrCr	r	r	r
r6}s�
#
�r6)r)Z
__future__rZemail.utilsrrr+Zpackagesrrrr4�update�ranger3r5Zformat_header_param�objectr6r	r	r	r
�<module>s&
*���	
site-packages/pip/_vendor/urllib3/__pycache__/__init__.cpython-38.pyc000064400000004045151446177000021473 0ustar00U

��.e{
�@s4dZddlmZddlZddlmZmZmZddlm	Z	ddl
mZddlm
Z
mZmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlZddlmZdZdZdZdZe� e!��"e��ej#fdd�Z$[ej%de	j&dd�ej%de	j'dd�ej%de	j(dd�ej%de	j)dd�e	j*fdd�Z+dS)z8
urllib3 - Thread-safe connection pooling and re-using.
�)�absolute_importN�)�HTTPConnectionPool�HTTPSConnectionPool�connection_from_url)�
exceptions)�encode_multipart_formdata)�PoolManager�ProxyManager�proxy_from_url)�HTTPResponse)�make_headers)�get_host)�Timeout)�Retry)�NullHandlerz(Andrey Petrov (andrey.petrov@shazow.net)ZMITz1.25.6)rrr	r
rrr�add_stderr_loggerr�disable_warningsrrr
rcCsFt�t�}t��}|�t�d��|�|�|�|�|�dt�|S)z�
    Helper for quickly adding a StreamHandler to the logger. Useful for
    debugging.

    Returns the handler after adding it.
    z%%(asctime)s %(levelname)s %(message)sz,Added a stderr logging handler to logger: %s)	�logging�	getLogger�__name__Z
StreamHandlerZsetFormatterZ	Formatter�
addHandlerZsetLevel�debug)�levelZloggerZhandler�r�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/__init__.pyr/s	


r�alwaysT)�append�defaultcCst�d|�dS)z<
    Helper for quickly disabling all urllib3 warnings.
    �ignoreN)�warnings�simplefilter)�categoryrrrrRsr),�__doc__Z
__future__rr Zconnectionpoolrrr�rZfilepostrZpoolmanagerr	r
rZresponserZutil.requestr
Zutil.urlrZutil.timeoutrZ
util.retryrrr�
__author__Z__license__�__version__�__all__rrr�DEBUGrr!ZSecurityWarningZSubjectAltNameWarningZInsecurePlatformWarningZSNIMissingWarningZHTTPWarningrrrrr�<module>s2site-packages/pip/_vendor/urllib3/__init__.py000064400000005173151446177000015210 0ustar00"""
urllib3 - Thread-safe connection pooling and re-using.
"""
from __future__ import absolute_import
import warnings

from .connectionpool import HTTPConnectionPool, HTTPSConnectionPool, connection_from_url

from . import exceptions
from .filepost import encode_multipart_formdata
from .poolmanager import PoolManager, ProxyManager, proxy_from_url
from .response import HTTPResponse
from .util.request import make_headers
from .util.url import get_host
from .util.timeout import Timeout
from .util.retry import Retry


# Set default logging handler to avoid "No handler found" warnings.
import logging
from logging import NullHandler

__author__ = "Andrey Petrov (andrey.petrov@shazow.net)"
__license__ = "MIT"
__version__ = "1.25.6"

__all__ = (
    "HTTPConnectionPool",
    "HTTPSConnectionPool",
    "PoolManager",
    "ProxyManager",
    "HTTPResponse",
    "Retry",
    "Timeout",
    "add_stderr_logger",
    "connection_from_url",
    "disable_warnings",
    "encode_multipart_formdata",
    "get_host",
    "make_headers",
    "proxy_from_url",
)

logging.getLogger(__name__).addHandler(NullHandler())


def add_stderr_logger(level=logging.DEBUG):
    """
    Helper for quickly adding a StreamHandler to the logger. Useful for
    debugging.

    Returns the handler after adding it.
    """
    # This method needs to be in this __init__.py to get the __name__ correct
    # even if urllib3 is vendored within another package.
    logger = logging.getLogger(__name__)
    handler = logging.StreamHandler()
    handler.setFormatter(logging.Formatter("%(asctime)s %(levelname)s %(message)s"))
    logger.addHandler(handler)
    logger.setLevel(level)
    logger.debug("Added a stderr logging handler to logger: %s", __name__)
    return handler


# ... Clean up.
del NullHandler


# All warning filters *must* be appended unless you're really certain that they
# shouldn't be: otherwise, it's very hard for users to use most Python
# mechanisms to silence them.
# SecurityWarning's always go off by default.
warnings.simplefilter("always", exceptions.SecurityWarning, append=True)
# SubjectAltNameWarning's should go off once per host
warnings.simplefilter("default", exceptions.SubjectAltNameWarning, append=True)
# InsecurePlatformWarning's don't vary between requests, so we keep it default.
warnings.simplefilter("default", exceptions.InsecurePlatformWarning, append=True)
# SNIMissingWarnings should go off only once.
warnings.simplefilter("default", exceptions.SNIMissingWarning, append=True)


def disable_warnings(category=exceptions.HTTPWarning):
    """
    Helper for quickly disabling all urllib3 warnings.
    """
    warnings.simplefilter("ignore", category)
site-packages/pip/_vendor/urllib3/filepost.py000064400000004610151446177000015271 0ustar00from __future__ import absolute_import
import binascii
import codecs
import os

from io import BytesIO

from .packages import six
from .packages.six import b
from .fields import RequestField

writer = codecs.lookup("utf-8")[3]


def choose_boundary():
    """
    Our embarrassingly-simple replacement for mimetools.choose_boundary.
    """
    boundary = binascii.hexlify(os.urandom(16))
    if not six.PY2:
        boundary = boundary.decode("ascii")
    return boundary


def iter_field_objects(fields):
    """
    Iterate over fields.

    Supports list of (k, v) tuples and dicts, and lists of
    :class:`~urllib3.fields.RequestField`.

    """
    if isinstance(fields, dict):
        i = six.iteritems(fields)
    else:
        i = iter(fields)

    for field in i:
        if isinstance(field, RequestField):
            yield field
        else:
            yield RequestField.from_tuples(*field)


def iter_fields(fields):
    """
    .. deprecated:: 1.6

    Iterate over fields.

    The addition of :class:`~urllib3.fields.RequestField` makes this function
    obsolete. Instead, use :func:`iter_field_objects`, which returns
    :class:`~urllib3.fields.RequestField` objects.

    Supports list of (k, v) tuples and dicts.
    """
    if isinstance(fields, dict):
        return ((k, v) for k, v in six.iteritems(fields))

    return ((k, v) for k, v in fields)


def encode_multipart_formdata(fields, boundary=None):
    """
    Encode a dictionary of ``fields`` using the multipart/form-data MIME format.

    :param fields:
        Dictionary of fields or list of (key, :class:`~urllib3.fields.RequestField`).

    :param boundary:
        If not specified, then a random boundary will be generated using
        :func:`urllib3.filepost.choose_boundary`.
    """
    body = BytesIO()
    if boundary is None:
        boundary = choose_boundary()

    for field in iter_field_objects(fields):
        body.write(b("--%s\r\n" % (boundary)))

        writer(body).write(field.render_headers())
        data = field.data

        if isinstance(data, int):
            data = str(data)  # Backwards compatibility

        if isinstance(data, six.text_type):
            writer(body).write(data)
        else:
            body.write(data)

        body.write(b"\r\n")

    body.write(b("--%s--\r\n" % (boundary)))

    content_type = str("multipart/form-data; boundary=%s" % boundary)

    return body.getvalue(), content_type
site-packages/pip/_vendor/urllib3/connection.py000064400000035502151446177000015607 0ustar00from __future__ import absolute_import
import datetime
import logging
import os
import socket
from socket import error as SocketError, timeout as SocketTimeout
import warnings
from .packages import six
from .packages.six.moves.http_client import HTTPConnection as _HTTPConnection
from .packages.six.moves.http_client import HTTPException  # noqa: F401

try:  # Compiled with SSL?
    import ssl

    BaseSSLError = ssl.SSLError
except (ImportError, AttributeError):  # Platform-specific: No SSL.
    ssl = None

    class BaseSSLError(BaseException):
        pass


try:
    # Python 3: not a no-op, we're adding this to the namespace so it can be imported.
    ConnectionError = ConnectionError
except NameError:
    # Python 2
    class ConnectionError(Exception):
        pass


from .exceptions import (
    NewConnectionError,
    ConnectTimeoutError,
    SubjectAltNameWarning,
    SystemTimeWarning,
)
from .packages.ssl_match_hostname import match_hostname, CertificateError

from .util.ssl_ import (
    resolve_cert_reqs,
    resolve_ssl_version,
    assert_fingerprint,
    create_urllib3_context,
    ssl_wrap_socket,
)


from .util import connection

from ._collections import HTTPHeaderDict

log = logging.getLogger(__name__)

port_by_scheme = {"http": 80, "https": 443}

# When it comes time to update this value as a part of regular maintenance
# (ie test_recent_date is failing) update it to ~6 months before the current date.
RECENT_DATE = datetime.date(2019, 1, 1)


class DummyConnection(object):
    """Used to detect a failed ConnectionCls import."""

    pass


class HTTPConnection(_HTTPConnection, object):
    """
    Based on httplib.HTTPConnection but provides an extra constructor
    backwards-compatibility layer between older and newer Pythons.

    Additional keyword parameters are used to configure attributes of the connection.
    Accepted parameters include:

      - ``strict``: See the documentation on :class:`urllib3.connectionpool.HTTPConnectionPool`
      - ``source_address``: Set the source address for the current connection.
      - ``socket_options``: Set specific options on the underlying socket. If not specified, then
        defaults are loaded from ``HTTPConnection.default_socket_options`` which includes disabling
        Nagle's algorithm (sets TCP_NODELAY to 1) unless the connection is behind a proxy.

        For example, if you wish to enable TCP Keep Alive in addition to the defaults,
        you might pass::

            HTTPConnection.default_socket_options + [
                (socket.SOL_SOCKET, socket.SO_KEEPALIVE, 1),
            ]

        Or you may want to disable the defaults by passing an empty list (e.g., ``[]``).
    """

    default_port = port_by_scheme["http"]

    #: Disable Nagle's algorithm by default.
    #: ``[(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]``
    default_socket_options = [(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)]

    #: Whether this connection verifies the host's certificate.
    is_verified = False

    def __init__(self, *args, **kw):
        if not six.PY2:
            kw.pop("strict", None)

        # Pre-set source_address.
        self.source_address = kw.get("source_address")

        #: The socket options provided by the user. If no options are
        #: provided, we use the default options.
        self.socket_options = kw.pop("socket_options", self.default_socket_options)

        _HTTPConnection.__init__(self, *args, **kw)

    @property
    def host(self):
        """
        Getter method to remove any trailing dots that indicate the hostname is an FQDN.

        In general, SSL certificates don't include the trailing dot indicating a
        fully-qualified domain name, and thus, they don't validate properly when
        checked against a domain name that includes the dot. In addition, some
        servers may not expect to receive the trailing dot when provided.

        However, the hostname with trailing dot is critical to DNS resolution; doing a
        lookup with the trailing dot will properly only resolve the appropriate FQDN,
        whereas a lookup without a trailing dot will search the system's search domain
        list. Thus, it's important to keep the original host around for use only in
        those cases where it's appropriate (i.e., when doing DNS lookup to establish the
        actual TCP connection across which we're going to send HTTP requests).
        """
        return self._dns_host.rstrip(".")

    @host.setter
    def host(self, value):
        """
        Setter for the `host` property.

        We assume that only urllib3 uses the _dns_host attribute; httplib itself
        only uses `host`, and it seems reasonable that other libraries follow suit.
        """
        self._dns_host = value

    def _new_conn(self):
        """ Establish a socket connection and set nodelay settings on it.

        :return: New socket connection.
        """
        extra_kw = {}
        if self.source_address:
            extra_kw["source_address"] = self.source_address

        if self.socket_options:
            extra_kw["socket_options"] = self.socket_options

        try:
            conn = connection.create_connection(
                (self._dns_host, self.port), self.timeout, **extra_kw
            )

        except SocketTimeout:
            raise ConnectTimeoutError(
                self,
                "Connection to %s timed out. (connect timeout=%s)"
                % (self.host, self.timeout),
            )

        except SocketError as e:
            raise NewConnectionError(
                self, "Failed to establish a new connection: %s" % e
            )

        return conn

    def _prepare_conn(self, conn):
        self.sock = conn
        # Google App Engine's httplib does not define _tunnel_host
        if getattr(self, "_tunnel_host", None):
            # TODO: Fix tunnel so it doesn't depend on self.sock state.
            self._tunnel()
            # Mark this connection as not reusable
            self.auto_open = 0

    def connect(self):
        conn = self._new_conn()
        self._prepare_conn(conn)

    def request_chunked(self, method, url, body=None, headers=None):
        """
        Alternative to the common request method, which sends the
        body with chunked encoding and not as one block
        """
        headers = HTTPHeaderDict(headers if headers is not None else {})
        skip_accept_encoding = "accept-encoding" in headers
        skip_host = "host" in headers
        self.putrequest(
            method, url, skip_accept_encoding=skip_accept_encoding, skip_host=skip_host
        )
        for header, value in headers.items():
            self.putheader(header, value)
        if "transfer-encoding" not in headers:
            self.putheader("Transfer-Encoding", "chunked")
        self.endheaders()

        if body is not None:
            stringish_types = six.string_types + (bytes,)
            if isinstance(body, stringish_types):
                body = (body,)
            for chunk in body:
                if not chunk:
                    continue
                if not isinstance(chunk, bytes):
                    chunk = chunk.encode("utf8")
                len_str = hex(len(chunk))[2:]
                self.send(len_str.encode("utf-8"))
                self.send(b"\r\n")
                self.send(chunk)
                self.send(b"\r\n")

        # After the if clause, to always have a closed body
        self.send(b"0\r\n\r\n")


class HTTPSConnection(HTTPConnection):
    default_port = port_by_scheme["https"]

    ssl_version = None

    def __init__(
        self,
        host,
        port=None,
        key_file=None,
        cert_file=None,
        key_password=None,
        strict=None,
        timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
        ssl_context=None,
        server_hostname=None,
        **kw
    ):

        HTTPConnection.__init__(self, host, port, strict=strict, timeout=timeout, **kw)

        self.key_file = key_file
        self.cert_file = cert_file
        self.key_password = key_password
        self.ssl_context = ssl_context
        self.server_hostname = server_hostname

        # Required property for Google AppEngine 1.9.0 which otherwise causes
        # HTTPS requests to go out as HTTP. (See Issue #356)
        self._protocol = "https"

    def connect(self):
        conn = self._new_conn()
        self._prepare_conn(conn)

        # Wrap socket using verification with the root certs in
        # trusted_root_certs
        default_ssl_context = False
        if self.ssl_context is None:
            default_ssl_context = True
            self.ssl_context = create_urllib3_context(
                ssl_version=resolve_ssl_version(self.ssl_version),
                cert_reqs=resolve_cert_reqs(self.cert_reqs),
            )

        # Try to load OS default certs if none are given.
        # Works well on Windows (requires Python3.4+)
        context = self.ssl_context
        if (
            not self.ca_certs
            and not self.ca_cert_dir
            and default_ssl_context
            and hasattr(context, "load_default_certs")
        ):
            context.load_default_certs()

        self.sock = ssl_wrap_socket(
            sock=conn,
            keyfile=self.key_file,
            certfile=self.cert_file,
            key_password=self.key_password,
            ssl_context=self.ssl_context,
            server_hostname=self.server_hostname,
        )


class VerifiedHTTPSConnection(HTTPSConnection):
    """
    Based on httplib.HTTPSConnection but wraps the socket with
    SSL certification.
    """

    cert_reqs = None
    ca_certs = None
    ca_cert_dir = None
    ssl_version = None
    assert_fingerprint = None

    def set_cert(
        self,
        key_file=None,
        cert_file=None,
        cert_reqs=None,
        key_password=None,
        ca_certs=None,
        assert_hostname=None,
        assert_fingerprint=None,
        ca_cert_dir=None,
    ):
        """
        This method should only be called once, before the connection is used.
        """
        # If cert_reqs is not provided we'll assume CERT_REQUIRED unless we also
        # have an SSLContext object in which case we'll use its verify_mode.
        if cert_reqs is None:
            if self.ssl_context is not None:
                cert_reqs = self.ssl_context.verify_mode
            else:
                cert_reqs = resolve_cert_reqs(None)

        self.key_file = key_file
        self.cert_file = cert_file
        self.cert_reqs = cert_reqs
        self.key_password = key_password
        self.assert_hostname = assert_hostname
        self.assert_fingerprint = assert_fingerprint
        self.ca_certs = ca_certs and os.path.expanduser(ca_certs)
        self.ca_cert_dir = ca_cert_dir and os.path.expanduser(ca_cert_dir)

    def connect(self):
        # Add certificate verification
        conn = self._new_conn()
        hostname = self.host

        # Google App Engine's httplib does not define _tunnel_host
        if getattr(self, "_tunnel_host", None):
            self.sock = conn
            # Calls self._set_hostport(), so self.host is
            # self._tunnel_host below.
            self._tunnel()
            # Mark this connection as not reusable
            self.auto_open = 0

            # Override the host with the one we're requesting data from.
            hostname = self._tunnel_host

        server_hostname = hostname
        if self.server_hostname is not None:
            server_hostname = self.server_hostname

        is_time_off = datetime.date.today() < RECENT_DATE
        if is_time_off:
            warnings.warn(
                (
                    "System time is way off (before {0}). This will probably "
                    "lead to SSL verification errors"
                ).format(RECENT_DATE),
                SystemTimeWarning,
            )

        # Wrap socket using verification with the root certs in
        # trusted_root_certs
        default_ssl_context = False
        if self.ssl_context is None:
            default_ssl_context = True
            self.ssl_context = create_urllib3_context(
                ssl_version=resolve_ssl_version(self.ssl_version),
                cert_reqs=resolve_cert_reqs(self.cert_reqs),
            )

        context = self.ssl_context
        context.verify_mode = resolve_cert_reqs(self.cert_reqs)

        # Try to load OS default certs if none are given.
        # Works well on Windows (requires Python3.4+)
        if (
            not self.ca_certs
            and not self.ca_cert_dir
            and default_ssl_context
            and hasattr(context, "load_default_certs")
        ):
            context.load_default_certs()

        self.sock = ssl_wrap_socket(
            sock=conn,
            keyfile=self.key_file,
            certfile=self.cert_file,
            key_password=self.key_password,
            ca_certs=self.ca_certs,
            ca_cert_dir=self.ca_cert_dir,
            server_hostname=server_hostname,
            ssl_context=context,
        )

        if self.assert_fingerprint:
            assert_fingerprint(
                self.sock.getpeercert(binary_form=True), self.assert_fingerprint
            )
        elif (
            context.verify_mode != ssl.CERT_NONE
            and not getattr(context, "check_hostname", False)
            and self.assert_hostname is not False
        ):
            # While urllib3 attempts to always turn off hostname matching from
            # the TLS library, this cannot always be done. So we check whether
            # the TLS Library still thinks it's matching hostnames.
            cert = self.sock.getpeercert()
            if not cert.get("subjectAltName", ()):
                warnings.warn(
                    (
                        "Certificate for {0} has no `subjectAltName`, falling back to check for a "
                        "`commonName` for now. This feature is being removed by major browsers and "
                        "deprecated by RFC 2818. (See https://github.com/shazow/urllib3/issues/497 "
                        "for details.)".format(hostname)
                    ),
                    SubjectAltNameWarning,
                )
            _match_hostname(cert, self.assert_hostname or server_hostname)

        self.is_verified = (
            context.verify_mode == ssl.CERT_REQUIRED
            or self.assert_fingerprint is not None
        )


def _match_hostname(cert, asserted_hostname):
    try:
        match_hostname(cert, asserted_hostname)
    except CertificateError as e:
        log.warning(
            "Certificate did not match expected hostname: %s. " "Certificate: %s",
            asserted_hostname,
            cert,
        )
        # Add cert to exception and reraise so client code can inspect
        # the cert when catching the exception, if they want to
        e._peer_cert = cert
        raise


if ssl:
    # Make a copy for testing.
    UnverifiedHTTPSConnection = HTTPSConnection
    HTTPSConnection = VerifiedHTTPSConnection
else:
    HTTPSConnection = DummyConnection
site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py000064400000001303151446177000020745 0ustar00"""
This module provides means to detect the App Engine environment.
"""

import os


def is_appengine():
    return is_local_appengine() or is_prod_appengine() or is_prod_appengine_mvms()


def is_appengine_sandbox():
    return is_appengine() and not is_prod_appengine_mvms()


def is_local_appengine():
    return (
        "APPENGINE_RUNTIME" in os.environ
        and "Development/" in os.environ["SERVER_SOFTWARE"]
    )


def is_prod_appengine():
    return (
        "APPENGINE_RUNTIME" in os.environ
        and "Google App Engine/" in os.environ["SERVER_SOFTWARE"]
        and not is_prod_appengine_mvms()
    )


def is_prod_appengine_mvms():
    return os.environ.get("GAE_VM", False) == "true"
site-packages/pip/_vendor/urllib3/contrib/securetransport.py000064400000077746151446177000020373 0ustar00"""
SecureTranport support for urllib3 via ctypes.

This makes platform-native TLS available to urllib3 users on macOS without the
use of a compiler. This is an important feature because the Python Package
Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
this is to give macOS users an alternative solution to the problem, and that
solution is to use SecureTransport.

We use ctypes here because this solution must not require a compiler. That's
because pip is not allowed to require a compiler either.

This is not intended to be a seriously long-term solution to this problem.
The hope is that PEP 543 will eventually solve this issue for us, at which
point we can retire this contrib module. But in the short term, we need to
solve the impending tire fire that is Python on Mac without this kind of
contrib module. So...here we are.

To use this module, simply import and inject it::

    import urllib3.contrib.securetransport
    urllib3.contrib.securetransport.inject_into_urllib3()

Happy TLSing!

This code is a bastardised version of the code found in Will Bond's oscrypto
library. An enormous debt is owed to him for blazing this trail for us. For
that reason, this code should be considered to be covered both by urllib3's
license and by oscrypto's:

    Copyright (c) 2015-2016 Will Bond <will@wbond.net>

    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files (the "Software"),
    to deal in the Software without restriction, including without limitation
    the rights to use, copy, modify, merge, publish, distribute, sublicense,
    and/or sell copies of the Software, and to permit persons to whom the
    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.
"""
from __future__ import absolute_import

import contextlib
import ctypes
import errno
import os.path
import shutil
import socket
import ssl
import threading
import weakref

from .. import util
from ._securetransport.bindings import Security, SecurityConst, CoreFoundation
from ._securetransport.low_level import (
    _assert_no_error,
    _cert_array_from_pem,
    _temporary_keychain,
    _load_client_cert_chain,
)

try:  # Platform-specific: Python 2
    from socket import _fileobject
except ImportError:  # Platform-specific: Python 3
    _fileobject = None
    from ..packages.backports.makefile import backport_makefile

__all__ = ["inject_into_urllib3", "extract_from_urllib3"]

# SNI always works
HAS_SNI = True

orig_util_HAS_SNI = util.HAS_SNI
orig_util_SSLContext = util.ssl_.SSLContext

# This dictionary is used by the read callback to obtain a handle to the
# calling wrapped socket. This is a pretty silly approach, but for now it'll
# do. I feel like I should be able to smuggle a handle to the wrapped socket
# directly in the SSLConnectionRef, but for now this approach will work I
# guess.
#
# We need to lock around this structure for inserts, but we don't do it for
# reads/writes in the callbacks. The reasoning here goes as follows:
#
#    1. It is not possible to call into the callbacks before the dictionary is
#       populated, so once in the callback the id must be in the dictionary.
#    2. The callbacks don't mutate the dictionary, they only read from it, and
#       so cannot conflict with any of the insertions.
#
# This is good: if we had to lock in the callbacks we'd drastically slow down
# the performance of this code.
_connection_refs = weakref.WeakValueDictionary()
_connection_ref_lock = threading.Lock()

# Limit writes to 16kB. This is OpenSSL's limit, but we'll cargo-cult it over
# for no better reason than we need *a* limit, and this one is right there.
SSL_WRITE_BLOCKSIZE = 16384

# This is our equivalent of util.ssl_.DEFAULT_CIPHERS, but expanded out to
# individual cipher suites. We need to do this because this is how
# SecureTransport wants them.
CIPHER_SUITES = [
    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,
    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,
    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
    SecurityConst.TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,
    SecurityConst.TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,
    SecurityConst.TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,
    SecurityConst.TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384,
    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA,
    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256,
    SecurityConst.TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA,
    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
    SecurityConst.TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256,
    SecurityConst.TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA,
    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA256,
    SecurityConst.TLS_DHE_RSA_WITH_AES_256_CBC_SHA,
    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA256,
    SecurityConst.TLS_DHE_RSA_WITH_AES_128_CBC_SHA,
    SecurityConst.TLS_AES_256_GCM_SHA384,
    SecurityConst.TLS_AES_128_GCM_SHA256,
    SecurityConst.TLS_RSA_WITH_AES_256_GCM_SHA384,
    SecurityConst.TLS_RSA_WITH_AES_128_GCM_SHA256,
    SecurityConst.TLS_AES_128_CCM_8_SHA256,
    SecurityConst.TLS_AES_128_CCM_SHA256,
    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA256,
    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA256,
    SecurityConst.TLS_RSA_WITH_AES_256_CBC_SHA,
    SecurityConst.TLS_RSA_WITH_AES_128_CBC_SHA,
]

# Basically this is simple: for PROTOCOL_SSLv23 we turn it into a low of
# TLSv1 and a high of TLSv1.3. For everything else, we pin to that version.
# TLSv1 to 1.2 are supported on macOS 10.8+ and TLSv1.3 is macOS 10.13+
_protocol_to_min_max = {
    util.PROTOCOL_TLS: (
        SecurityConst.kTLSProtocol1,
        SecurityConst.kTLSProtocolMaxSupported,
    )
}

if hasattr(ssl, "PROTOCOL_SSLv2"):
    _protocol_to_min_max[ssl.PROTOCOL_SSLv2] = (
        SecurityConst.kSSLProtocol2,
        SecurityConst.kSSLProtocol2,
    )
if hasattr(ssl, "PROTOCOL_SSLv3"):
    _protocol_to_min_max[ssl.PROTOCOL_SSLv3] = (
        SecurityConst.kSSLProtocol3,
        SecurityConst.kSSLProtocol3,
    )
if hasattr(ssl, "PROTOCOL_TLSv1"):
    _protocol_to_min_max[ssl.PROTOCOL_TLSv1] = (
        SecurityConst.kTLSProtocol1,
        SecurityConst.kTLSProtocol1,
    )
if hasattr(ssl, "PROTOCOL_TLSv1_1"):
    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_1] = (
        SecurityConst.kTLSProtocol11,
        SecurityConst.kTLSProtocol11,
    )
if hasattr(ssl, "PROTOCOL_TLSv1_2"):
    _protocol_to_min_max[ssl.PROTOCOL_TLSv1_2] = (
        SecurityConst.kTLSProtocol12,
        SecurityConst.kTLSProtocol12,
    )


def inject_into_urllib3():
    """
    Monkey-patch urllib3 with SecureTransport-backed SSL-support.
    """
    util.SSLContext = SecureTransportContext
    util.ssl_.SSLContext = SecureTransportContext
    util.HAS_SNI = HAS_SNI
    util.ssl_.HAS_SNI = HAS_SNI
    util.IS_SECURETRANSPORT = True
    util.ssl_.IS_SECURETRANSPORT = True


def extract_from_urllib3():
    """
    Undo monkey-patching by :func:`inject_into_urllib3`.
    """
    util.SSLContext = orig_util_SSLContext
    util.ssl_.SSLContext = orig_util_SSLContext
    util.HAS_SNI = orig_util_HAS_SNI
    util.ssl_.HAS_SNI = orig_util_HAS_SNI
    util.IS_SECURETRANSPORT = False
    util.ssl_.IS_SECURETRANSPORT = False


def _read_callback(connection_id, data_buffer, data_length_pointer):
    """
    SecureTransport read callback. This is called by ST to request that data
    be returned from the socket.
    """
    wrapped_socket = None
    try:
        wrapped_socket = _connection_refs.get(connection_id)
        if wrapped_socket is None:
            return SecurityConst.errSSLInternal
        base_socket = wrapped_socket.socket

        requested_length = data_length_pointer[0]

        timeout = wrapped_socket.gettimeout()
        error = None
        read_count = 0

        try:
            while read_count < requested_length:
                if timeout is None or timeout >= 0:
                    if not util.wait_for_read(base_socket, timeout):
                        raise socket.error(errno.EAGAIN, "timed out")

                remaining = requested_length - read_count
                buffer = (ctypes.c_char * remaining).from_address(
                    data_buffer + read_count
                )
                chunk_size = base_socket.recv_into(buffer, remaining)
                read_count += chunk_size
                if not chunk_size:
                    if not read_count:
                        return SecurityConst.errSSLClosedGraceful
                    break
        except (socket.error) as e:
            error = e.errno

            if error is not None and error != errno.EAGAIN:
                data_length_pointer[0] = read_count
                if error == errno.ECONNRESET or error == errno.EPIPE:
                    return SecurityConst.errSSLClosedAbort
                raise

        data_length_pointer[0] = read_count

        if read_count != requested_length:
            return SecurityConst.errSSLWouldBlock

        return 0
    except Exception as e:
        if wrapped_socket is not None:
            wrapped_socket._exception = e
        return SecurityConst.errSSLInternal


def _write_callback(connection_id, data_buffer, data_length_pointer):
    """
    SecureTransport write callback. This is called by ST to request that data
    actually be sent on the network.
    """
    wrapped_socket = None
    try:
        wrapped_socket = _connection_refs.get(connection_id)
        if wrapped_socket is None:
            return SecurityConst.errSSLInternal
        base_socket = wrapped_socket.socket

        bytes_to_write = data_length_pointer[0]
        data = ctypes.string_at(data_buffer, bytes_to_write)

        timeout = wrapped_socket.gettimeout()
        error = None
        sent = 0

        try:
            while sent < bytes_to_write:
                if timeout is None or timeout >= 0:
                    if not util.wait_for_write(base_socket, timeout):
                        raise socket.error(errno.EAGAIN, "timed out")
                chunk_sent = base_socket.send(data)
                sent += chunk_sent

                # This has some needless copying here, but I'm not sure there's
                # much value in optimising this data path.
                data = data[chunk_sent:]
        except (socket.error) as e:
            error = e.errno

            if error is not None and error != errno.EAGAIN:
                data_length_pointer[0] = sent
                if error == errno.ECONNRESET or error == errno.EPIPE:
                    return SecurityConst.errSSLClosedAbort
                raise

        data_length_pointer[0] = sent

        if sent != bytes_to_write:
            return SecurityConst.errSSLWouldBlock

        return 0
    except Exception as e:
        if wrapped_socket is not None:
            wrapped_socket._exception = e
        return SecurityConst.errSSLInternal


# We need to keep these two objects references alive: if they get GC'd while
# in use then SecureTransport could attempt to call a function that is in freed
# memory. That would be...uh...bad. Yeah, that's the word. Bad.
_read_callback_pointer = Security.SSLReadFunc(_read_callback)
_write_callback_pointer = Security.SSLWriteFunc(_write_callback)


class WrappedSocket(object):
    """
    API-compatibility wrapper for Python's OpenSSL wrapped socket object.

    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
    collector of PyPy.
    """

    def __init__(self, socket):
        self.socket = socket
        self.context = None
        self._makefile_refs = 0
        self._closed = False
        self._exception = None
        self._keychain = None
        self._keychain_dir = None
        self._client_cert_chain = None

        # We save off the previously-configured timeout and then set it to
        # zero. This is done because we use select and friends to handle the
        # timeouts, but if we leave the timeout set on the lower socket then
        # Python will "kindly" call select on that socket again for us. Avoid
        # that by forcing the timeout to zero.
        self._timeout = self.socket.gettimeout()
        self.socket.settimeout(0)

    @contextlib.contextmanager
    def _raise_on_error(self):
        """
        A context manager that can be used to wrap calls that do I/O from
        SecureTransport. If any of the I/O callbacks hit an exception, this
        context manager will correctly propagate the exception after the fact.
        This avoids silently swallowing those exceptions.

        It also correctly forces the socket closed.
        """
        self._exception = None

        # We explicitly don't catch around this yield because in the unlikely
        # event that an exception was hit in the block we don't want to swallow
        # it.
        yield
        if self._exception is not None:
            exception, self._exception = self._exception, None
            self.close()
            raise exception

    def _set_ciphers(self):
        """
        Sets up the allowed ciphers. By default this matches the set in
        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
        custom and doesn't allow changing at this time, mostly because parsing
        OpenSSL cipher strings is going to be a freaking nightmare.
        """
        ciphers = (Security.SSLCipherSuite * len(CIPHER_SUITES))(*CIPHER_SUITES)
        result = Security.SSLSetEnabledCiphers(
            self.context, ciphers, len(CIPHER_SUITES)
        )
        _assert_no_error(result)

    def _custom_validate(self, verify, trust_bundle):
        """
        Called when we have set custom validation. We do this in two cases:
        first, when cert validation is entirely disabled; and second, when
        using a custom trust DB.
        """
        # If we disabled cert validation, just say: cool.
        if not verify:
            return

        # We want data in memory, so load it up.
        if os.path.isfile(trust_bundle):
            with open(trust_bundle, "rb") as f:
                trust_bundle = f.read()

        cert_array = None
        trust = Security.SecTrustRef()

        try:
            # Get a CFArray that contains the certs we want.
            cert_array = _cert_array_from_pem(trust_bundle)

            # Ok, now the hard part. We want to get the SecTrustRef that ST has
            # created for this connection, shove our CAs into it, tell ST to
            # ignore everything else it knows, and then ask if it can build a
            # chain. This is a buuuunch of code.
            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
            _assert_no_error(result)
            if not trust:
                raise ssl.SSLError("Failed to copy trust reference")

            result = Security.SecTrustSetAnchorCertificates(trust, cert_array)
            _assert_no_error(result)

            result = Security.SecTrustSetAnchorCertificatesOnly(trust, True)
            _assert_no_error(result)

            trust_result = Security.SecTrustResultType()
            result = Security.SecTrustEvaluate(trust, ctypes.byref(trust_result))
            _assert_no_error(result)
        finally:
            if trust:
                CoreFoundation.CFRelease(trust)

            if cert_array is not None:
                CoreFoundation.CFRelease(cert_array)

        # Ok, now we can look at what the result was.
        successes = (
            SecurityConst.kSecTrustResultUnspecified,
            SecurityConst.kSecTrustResultProceed,
        )
        if trust_result.value not in successes:
            raise ssl.SSLError(
                "certificate verify failed, error code: %d" % trust_result.value
            )

    def handshake(
        self,
        server_hostname,
        verify,
        trust_bundle,
        min_version,
        max_version,
        client_cert,
        client_key,
        client_key_passphrase,
    ):
        """
        Actually performs the TLS handshake. This is run automatically by
        wrapped socket, and shouldn't be needed in user code.
        """
        # First, we do the initial bits of connection setup. We need to create
        # a context, set its I/O funcs, and set the connection reference.
        self.context = Security.SSLCreateContext(
            None, SecurityConst.kSSLClientSide, SecurityConst.kSSLStreamType
        )
        result = Security.SSLSetIOFuncs(
            self.context, _read_callback_pointer, _write_callback_pointer
        )
        _assert_no_error(result)

        # Here we need to compute the handle to use. We do this by taking the
        # id of self modulo 2**31 - 1. If this is already in the dictionary, we
        # just keep incrementing by one until we find a free space.
        with _connection_ref_lock:
            handle = id(self) % 2147483647
            while handle in _connection_refs:
                handle = (handle + 1) % 2147483647
            _connection_refs[handle] = self

        result = Security.SSLSetConnection(self.context, handle)
        _assert_no_error(result)

        # If we have a server hostname, we should set that too.
        if server_hostname:
            if not isinstance(server_hostname, bytes):
                server_hostname = server_hostname.encode("utf-8")

            result = Security.SSLSetPeerDomainName(
                self.context, server_hostname, len(server_hostname)
            )
            _assert_no_error(result)

        # Setup the ciphers.
        self._set_ciphers()

        # Set the minimum and maximum TLS versions.
        result = Security.SSLSetProtocolVersionMin(self.context, min_version)
        _assert_no_error(result)

        # TLS 1.3 isn't necessarily enabled by the OS
        # so we have to detect when we error out and try
        # setting TLS 1.3 if it's allowed. kTLSProtocolMaxSupported
        # was added in macOS 10.13 along with kTLSProtocol13.
        result = Security.SSLSetProtocolVersionMax(self.context, max_version)
        if result != 0 and max_version == SecurityConst.kTLSProtocolMaxSupported:
            result = Security.SSLSetProtocolVersionMax(
                self.context, SecurityConst.kTLSProtocol12
            )
        _assert_no_error(result)

        # If there's a trust DB, we need to use it. We do that by telling
        # SecureTransport to break on server auth. We also do that if we don't
        # want to validate the certs at all: we just won't actually do any
        # authing in that case.
        if not verify or trust_bundle is not None:
            result = Security.SSLSetSessionOption(
                self.context, SecurityConst.kSSLSessionOptionBreakOnServerAuth, True
            )
            _assert_no_error(result)

        # If there's a client cert, we need to use it.
        if client_cert:
            self._keychain, self._keychain_dir = _temporary_keychain()
            self._client_cert_chain = _load_client_cert_chain(
                self._keychain, client_cert, client_key
            )
            result = Security.SSLSetCertificate(self.context, self._client_cert_chain)
            _assert_no_error(result)

        while True:
            with self._raise_on_error():
                result = Security.SSLHandshake(self.context)

                if result == SecurityConst.errSSLWouldBlock:
                    raise socket.timeout("handshake timed out")
                elif result == SecurityConst.errSSLServerAuthCompleted:
                    self._custom_validate(verify, trust_bundle)
                    continue
                else:
                    _assert_no_error(result)
                    break

    def fileno(self):
        return self.socket.fileno()

    # Copy-pasted from Python 3.5 source code
    def _decref_socketios(self):
        if self._makefile_refs > 0:
            self._makefile_refs -= 1
        if self._closed:
            self.close()

    def recv(self, bufsiz):
        buffer = ctypes.create_string_buffer(bufsiz)
        bytes_read = self.recv_into(buffer, bufsiz)
        data = buffer[:bytes_read]
        return data

    def recv_into(self, buffer, nbytes=None):
        # Read short on EOF.
        if self._closed:
            return 0

        if nbytes is None:
            nbytes = len(buffer)

        buffer = (ctypes.c_char * nbytes).from_buffer(buffer)
        processed_bytes = ctypes.c_size_t(0)

        with self._raise_on_error():
            result = Security.SSLRead(
                self.context, buffer, nbytes, ctypes.byref(processed_bytes)
            )

        # There are some result codes that we want to treat as "not always
        # errors". Specifically, those are errSSLWouldBlock,
        # errSSLClosedGraceful, and errSSLClosedNoNotify.
        if result == SecurityConst.errSSLWouldBlock:
            # If we didn't process any bytes, then this was just a time out.
            # However, we can get errSSLWouldBlock in situations when we *did*
            # read some data, and in those cases we should just read "short"
            # and return.
            if processed_bytes.value == 0:
                # Timed out, no data read.
                raise socket.timeout("recv timed out")
        elif result in (
            SecurityConst.errSSLClosedGraceful,
            SecurityConst.errSSLClosedNoNotify,
        ):
            # The remote peer has closed this connection. We should do so as
            # well. Note that we don't actually return here because in
            # principle this could actually be fired along with return data.
            # It's unlikely though.
            self.close()
        else:
            _assert_no_error(result)

        # Ok, we read and probably succeeded. We should return whatever data
        # was actually read.
        return processed_bytes.value

    def settimeout(self, timeout):
        self._timeout = timeout

    def gettimeout(self):
        return self._timeout

    def send(self, data):
        processed_bytes = ctypes.c_size_t(0)

        with self._raise_on_error():
            result = Security.SSLWrite(
                self.context, data, len(data), ctypes.byref(processed_bytes)
            )

        if result == SecurityConst.errSSLWouldBlock and processed_bytes.value == 0:
            # Timed out
            raise socket.timeout("send timed out")
        else:
            _assert_no_error(result)

        # We sent, and probably succeeded. Tell them how much we sent.
        return processed_bytes.value

    def sendall(self, data):
        total_sent = 0
        while total_sent < len(data):
            sent = self.send(data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE])
            total_sent += sent

    def shutdown(self):
        with self._raise_on_error():
            Security.SSLClose(self.context)

    def close(self):
        # TODO: should I do clean shutdown here? Do I have to?
        if self._makefile_refs < 1:
            self._closed = True
            if self.context:
                CoreFoundation.CFRelease(self.context)
                self.context = None
            if self._client_cert_chain:
                CoreFoundation.CFRelease(self._client_cert_chain)
                self._client_cert_chain = None
            if self._keychain:
                Security.SecKeychainDelete(self._keychain)
                CoreFoundation.CFRelease(self._keychain)
                shutil.rmtree(self._keychain_dir)
                self._keychain = self._keychain_dir = None
            return self.socket.close()
        else:
            self._makefile_refs -= 1

    def getpeercert(self, binary_form=False):
        # Urgh, annoying.
        #
        # Here's how we do this:
        #
        # 1. Call SSLCopyPeerTrust to get hold of the trust object for this
        #    connection.
        # 2. Call SecTrustGetCertificateAtIndex for index 0 to get the leaf.
        # 3. To get the CN, call SecCertificateCopyCommonName and process that
        #    string so that it's of the appropriate type.
        # 4. To get the SAN, we need to do something a bit more complex:
        #    a. Call SecCertificateCopyValues to get the data, requesting
        #       kSecOIDSubjectAltName.
        #    b. Mess about with this dictionary to try to get the SANs out.
        #
        # This is gross. Really gross. It's going to be a few hundred LoC extra
        # just to repeat something that SecureTransport can *already do*. So my
        # operating assumption at this time is that what we want to do is
        # instead to just flag to urllib3 that it shouldn't do its own hostname
        # validation when using SecureTransport.
        if not binary_form:
            raise ValueError("SecureTransport only supports dumping binary certs")
        trust = Security.SecTrustRef()
        certdata = None
        der_bytes = None

        try:
            # Grab the trust store.
            result = Security.SSLCopyPeerTrust(self.context, ctypes.byref(trust))
            _assert_no_error(result)
            if not trust:
                # Probably we haven't done the handshake yet. No biggie.
                return None

            cert_count = Security.SecTrustGetCertificateCount(trust)
            if not cert_count:
                # Also a case that might happen if we haven't handshaked.
                # Handshook? Handshaken?
                return None

            leaf = Security.SecTrustGetCertificateAtIndex(trust, 0)
            assert leaf

            # Ok, now we want the DER bytes.
            certdata = Security.SecCertificateCopyData(leaf)
            assert certdata

            data_length = CoreFoundation.CFDataGetLength(certdata)
            data_buffer = CoreFoundation.CFDataGetBytePtr(certdata)
            der_bytes = ctypes.string_at(data_buffer, data_length)
        finally:
            if certdata:
                CoreFoundation.CFRelease(certdata)
            if trust:
                CoreFoundation.CFRelease(trust)

        return der_bytes

    def version(self):
        protocol = Security.SSLProtocol()
        result = Security.SSLGetNegotiatedProtocolVersion(
            self.context, ctypes.byref(protocol)
        )
        _assert_no_error(result)
        if protocol.value == SecurityConst.kTLSProtocol13:
            return "TLSv1.3"
        elif protocol.value == SecurityConst.kTLSProtocol12:
            return "TLSv1.2"
        elif protocol.value == SecurityConst.kTLSProtocol11:
            return "TLSv1.1"
        elif protocol.value == SecurityConst.kTLSProtocol1:
            return "TLSv1"
        elif protocol.value == SecurityConst.kSSLProtocol3:
            return "SSLv3"
        elif protocol.value == SecurityConst.kSSLProtocol2:
            return "SSLv2"
        else:
            raise ssl.SSLError("Unknown TLS version: %r" % protocol)

    def _reuse(self):
        self._makefile_refs += 1

    def _drop(self):
        if self._makefile_refs < 1:
            self.close()
        else:
            self._makefile_refs -= 1


if _fileobject:  # Platform-specific: Python 2

    def makefile(self, mode, bufsize=-1):
        self._makefile_refs += 1
        return _fileobject(self, mode, bufsize, close=True)


else:  # Platform-specific: Python 3

    def makefile(self, mode="r", buffering=None, *args, **kwargs):
        # We disable buffering with SecureTransport because it conflicts with
        # the buffering that ST does internally (see issue #1153 for more).
        buffering = 0
        return backport_makefile(self, mode, buffering, *args, **kwargs)


WrappedSocket.makefile = makefile


class SecureTransportContext(object):
    """
    I am a wrapper class for the SecureTransport library, to translate the
    interface of the standard library ``SSLContext`` object to calls into
    SecureTransport.
    """

    def __init__(self, protocol):
        self._min_version, self._max_version = _protocol_to_min_max[protocol]
        self._options = 0
        self._verify = False
        self._trust_bundle = None
        self._client_cert = None
        self._client_key = None
        self._client_key_passphrase = None

    @property
    def check_hostname(self):
        """
        SecureTransport cannot have its hostname checking disabled. For more,
        see the comment on getpeercert() in this file.
        """
        return True

    @check_hostname.setter
    def check_hostname(self, value):
        """
        SecureTransport cannot have its hostname checking disabled. For more,
        see the comment on getpeercert() in this file.
        """
        pass

    @property
    def options(self):
        # TODO: Well, crap.
        #
        # So this is the bit of the code that is the most likely to cause us
        # trouble. Essentially we need to enumerate all of the SSL options that
        # users might want to use and try to see if we can sensibly translate
        # them, or whether we should just ignore them.
        return self._options

    @options.setter
    def options(self, value):
        # TODO: Update in line with above.
        self._options = value

    @property
    def verify_mode(self):
        return ssl.CERT_REQUIRED if self._verify else ssl.CERT_NONE

    @verify_mode.setter
    def verify_mode(self, value):
        self._verify = True if value == ssl.CERT_REQUIRED else False

    def set_default_verify_paths(self):
        # So, this has to do something a bit weird. Specifically, what it does
        # is nothing.
        #
        # This means that, if we had previously had load_verify_locations
        # called, this does not undo that. We need to do that because it turns
        # out that the rest of the urllib3 code will attempt to load the
        # default verify paths if it hasn't been told about any paths, even if
        # the context itself was sometime earlier. We resolve that by just
        # ignoring it.
        pass

    def load_default_certs(self):
        return self.set_default_verify_paths()

    def set_ciphers(self, ciphers):
        # For now, we just require the default cipher string.
        if ciphers != util.ssl_.DEFAULT_CIPHERS:
            raise ValueError("SecureTransport doesn't support custom cipher strings")

    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
        # OK, we only really support cadata and cafile.
        if capath is not None:
            raise ValueError("SecureTransport does not support cert directories")

        self._trust_bundle = cafile or cadata

    def load_cert_chain(self, certfile, keyfile=None, password=None):
        self._client_cert = certfile
        self._client_key = keyfile
        self._client_cert_passphrase = password

    def wrap_socket(
        self,
        sock,
        server_side=False,
        do_handshake_on_connect=True,
        suppress_ragged_eofs=True,
        server_hostname=None,
    ):
        # So, what do we do here? Firstly, we assert some properties. This is a
        # stripped down shim, so there is some functionality we don't support.
        # See PEP 543 for the real deal.
        assert not server_side
        assert do_handshake_on_connect
        assert suppress_ragged_eofs

        # Ok, we're good to go. Now we want to create the wrapped socket object
        # and store it in the appropriate place.
        wrapped_socket = WrappedSocket(sock)

        # Now we can handshake
        wrapped_socket.handshake(
            server_hostname,
            self._verify,
            self._trust_bundle,
            self._min_version,
            self._max_version,
            self._client_cert,
            self._client_key,
            self._client_key_passphrase,
        )
        return wrapped_socket
site-packages/pip/_vendor/urllib3/contrib/pyopenssl.py000064400000040070151446177000017140 0ustar00"""
SSL with SNI_-support for Python 2. Follow these instructions if you would
like to verify SSL certificates in Python 2. Note, the default libraries do
*not* do certificate checking; you need to do additional work to validate
certificates yourself.

This needs the following packages installed:

* pyOpenSSL (tested with 16.0.0)
* cryptography (minimum 1.3.4, from pyopenssl)
* idna (minimum 2.0, from cryptography)

However, pyopenssl depends on cryptography, which depends on idna, so while we
use all three directly here we end up having relatively few packages required.

You can install them with the following command:

    pip install pyopenssl cryptography idna

To activate certificate checking, call
:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
before you begin making HTTP requests. This can be done in a ``sitecustomize``
module, or at any other time before your application begins using ``urllib3``,
like this::

    try:
        import urllib3.contrib.pyopenssl
        urllib3.contrib.pyopenssl.inject_into_urllib3()
    except ImportError:
        pass

Now you can use :mod:`urllib3` as you normally would, and it will support SNI
when the required modules are installed.

Activating this module also has the positive side effect of disabling SSL/TLS
compression in Python 2 (see `CRIME attack`_).

If you want to configure the default list of supported cipher suites, you can
set the ``urllib3.contrib.pyopenssl.DEFAULT_SSL_CIPHER_LIST`` variable.

.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
"""
from __future__ import absolute_import

import OpenSSL.SSL
from cryptography import x509
from cryptography.hazmat.backends.openssl import backend as openssl_backend
from cryptography.hazmat.backends.openssl.x509 import _Certificate

try:
    from cryptography.x509 import UnsupportedExtension
except ImportError:
    # UnsupportedExtension is gone in cryptography >= 2.1.0
    class UnsupportedExtension(Exception):
        pass


from socket import timeout, error as SocketError
from io import BytesIO

try:  # Platform-specific: Python 2
    from socket import _fileobject
except ImportError:  # Platform-specific: Python 3
    _fileobject = None
    from ..packages.backports.makefile import backport_makefile

import logging
import ssl
from ..packages import six
import sys

from .. import util


__all__ = ["inject_into_urllib3", "extract_from_urllib3"]

# SNI always works.
HAS_SNI = True

# Map from urllib3 to PyOpenSSL compatible parameter-values.
_openssl_versions = {
    util.PROTOCOL_TLS: OpenSSL.SSL.SSLv23_METHOD,
    ssl.PROTOCOL_TLSv1: OpenSSL.SSL.TLSv1_METHOD,
}

if hasattr(ssl, "PROTOCOL_SSLv3") and hasattr(OpenSSL.SSL, "SSLv3_METHOD"):
    _openssl_versions[ssl.PROTOCOL_SSLv3] = OpenSSL.SSL.SSLv3_METHOD

if hasattr(ssl, "PROTOCOL_TLSv1_1") and hasattr(OpenSSL.SSL, "TLSv1_1_METHOD"):
    _openssl_versions[ssl.PROTOCOL_TLSv1_1] = OpenSSL.SSL.TLSv1_1_METHOD

if hasattr(ssl, "PROTOCOL_TLSv1_2") and hasattr(OpenSSL.SSL, "TLSv1_2_METHOD"):
    _openssl_versions[ssl.PROTOCOL_TLSv1_2] = OpenSSL.SSL.TLSv1_2_METHOD


_stdlib_to_openssl_verify = {
    ssl.CERT_NONE: OpenSSL.SSL.VERIFY_NONE,
    ssl.CERT_OPTIONAL: OpenSSL.SSL.VERIFY_PEER,
    ssl.CERT_REQUIRED: OpenSSL.SSL.VERIFY_PEER
    + OpenSSL.SSL.VERIFY_FAIL_IF_NO_PEER_CERT,
}
_openssl_to_stdlib_verify = dict((v, k) for k, v in _stdlib_to_openssl_verify.items())

# OpenSSL will only write 16K at a time
SSL_WRITE_BLOCKSIZE = 16384

orig_util_HAS_SNI = util.HAS_SNI
orig_util_SSLContext = util.ssl_.SSLContext


log = logging.getLogger(__name__)


def inject_into_urllib3():
    "Monkey-patch urllib3 with PyOpenSSL-backed SSL-support."

    _validate_dependencies_met()

    util.SSLContext = PyOpenSSLContext
    util.ssl_.SSLContext = PyOpenSSLContext
    util.HAS_SNI = HAS_SNI
    util.ssl_.HAS_SNI = HAS_SNI
    util.IS_PYOPENSSL = True
    util.ssl_.IS_PYOPENSSL = True


def extract_from_urllib3():
    "Undo monkey-patching by :func:`inject_into_urllib3`."

    util.SSLContext = orig_util_SSLContext
    util.ssl_.SSLContext = orig_util_SSLContext
    util.HAS_SNI = orig_util_HAS_SNI
    util.ssl_.HAS_SNI = orig_util_HAS_SNI
    util.IS_PYOPENSSL = False
    util.ssl_.IS_PYOPENSSL = False


def _validate_dependencies_met():
    """
    Verifies that PyOpenSSL's package-level dependencies have been met.
    Throws `ImportError` if they are not met.
    """
    # Method added in `cryptography==1.1`; not available in older versions
    from cryptography.x509.extensions import Extensions

    if getattr(Extensions, "get_extension_for_class", None) is None:
        raise ImportError(
            "'cryptography' module missing required functionality.  "
            "Try upgrading to v1.3.4 or newer."
        )

    # pyOpenSSL 0.14 and above use cryptography for OpenSSL bindings. The _x509
    # attribute is only present on those versions.
    from OpenSSL.crypto import X509

    x509 = X509()
    if getattr(x509, "_x509", None) is None:
        raise ImportError(
            "'pyOpenSSL' module missing required functionality. "
            "Try upgrading to v0.14 or newer."
        )


def _dnsname_to_stdlib(name):
    """
    Converts a dNSName SubjectAlternativeName field to the form used by the
    standard library on the given Python version.

    Cryptography produces a dNSName as a unicode string that was idna-decoded
    from ASCII bytes. We need to idna-encode that string to get it back, and
    then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
    uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).

    If the name cannot be idna-encoded then we return None signalling that
    the name given should be skipped.
    """

    def idna_encode(name):
        """
        Borrowed wholesale from the Python Cryptography Project. It turns out
        that we can't just safely call `idna.encode`: it can explode for
        wildcard names. This avoids that problem.
        """
        from pip._vendor import idna

        try:
            for prefix in [u"*.", u"."]:
                if name.startswith(prefix):
                    name = name[len(prefix) :]
                    return prefix.encode("ascii") + idna.encode(name)
            return idna.encode(name)
        except idna.core.IDNAError:
            return None

    # Don't send IPv6 addresses through the IDNA encoder.
    if ":" in name:
        return name

    name = idna_encode(name)
    if name is None:
        return None
    elif sys.version_info >= (3, 0):
        name = name.decode("utf-8")
    return name


def get_subj_alt_name(peer_cert):
    """
    Given an PyOpenSSL certificate, provides all the subject alternative names.
    """
    # Pass the cert to cryptography, which has much better APIs for this.
    if hasattr(peer_cert, "to_cryptography"):
        cert = peer_cert.to_cryptography()
    else:
        # This is technically using private APIs, but should work across all
        # relevant versions before PyOpenSSL got a proper API for this.
        cert = _Certificate(openssl_backend, peer_cert._x509)

    # We want to find the SAN extension. Ask Cryptography to locate it (it's
    # faster than looping in Python)
    try:
        ext = cert.extensions.get_extension_for_class(x509.SubjectAlternativeName).value
    except x509.ExtensionNotFound:
        # No such extension, return the empty list.
        return []
    except (
        x509.DuplicateExtension,
        UnsupportedExtension,
        x509.UnsupportedGeneralNameType,
        UnicodeError,
    ) as e:
        # A problem has been found with the quality of the certificate. Assume
        # no SAN field is present.
        log.warning(
            "A problem was encountered with the certificate that prevented "
            "urllib3 from finding the SubjectAlternativeName field. This can "
            "affect certificate validation. The error was %s",
            e,
        )
        return []

    # We want to return dNSName and iPAddress fields. We need to cast the IPs
    # back to strings because the match_hostname function wants them as
    # strings.
    # Sadly the DNS names need to be idna encoded and then, on Python 3, UTF-8
    # decoded. This is pretty frustrating, but that's what the standard library
    # does with certificates, and so we need to attempt to do the same.
    # We also want to skip over names which cannot be idna encoded.
    names = [
        ("DNS", name)
        for name in map(_dnsname_to_stdlib, ext.get_values_for_type(x509.DNSName))
        if name is not None
    ]
    names.extend(
        ("IP Address", str(name)) for name in ext.get_values_for_type(x509.IPAddress)
    )

    return names


class WrappedSocket(object):
    """API-compatibility wrapper for Python OpenSSL's Connection-class.

    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
    collector of pypy.
    """

    def __init__(self, connection, socket, suppress_ragged_eofs=True):
        self.connection = connection
        self.socket = socket
        self.suppress_ragged_eofs = suppress_ragged_eofs
        self._makefile_refs = 0
        self._closed = False

    def fileno(self):
        return self.socket.fileno()

    # Copy-pasted from Python 3.5 source code
    def _decref_socketios(self):
        if self._makefile_refs > 0:
            self._makefile_refs -= 1
        if self._closed:
            self.close()

    def recv(self, *args, **kwargs):
        try:
            data = self.connection.recv(*args, **kwargs)
        except OpenSSL.SSL.SysCallError as e:
            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                return b""
            else:
                raise SocketError(str(e))
        except OpenSSL.SSL.ZeroReturnError:
            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                return b""
            else:
                raise
        except OpenSSL.SSL.WantReadError:
            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
                raise timeout("The read operation timed out")
            else:
                return self.recv(*args, **kwargs)

        # TLS 1.3 post-handshake authentication
        except OpenSSL.SSL.Error as e:
            raise ssl.SSLError("read error: %r" % e)
        else:
            return data

    def recv_into(self, *args, **kwargs):
        try:
            return self.connection.recv_into(*args, **kwargs)
        except OpenSSL.SSL.SysCallError as e:
            if self.suppress_ragged_eofs and e.args == (-1, "Unexpected EOF"):
                return 0
            else:
                raise SocketError(str(e))
        except OpenSSL.SSL.ZeroReturnError:
            if self.connection.get_shutdown() == OpenSSL.SSL.RECEIVED_SHUTDOWN:
                return 0
            else:
                raise
        except OpenSSL.SSL.WantReadError:
            if not util.wait_for_read(self.socket, self.socket.gettimeout()):
                raise timeout("The read operation timed out")
            else:
                return self.recv_into(*args, **kwargs)

        # TLS 1.3 post-handshake authentication
        except OpenSSL.SSL.Error as e:
            raise ssl.SSLError("read error: %r" % e)

    def settimeout(self, timeout):
        return self.socket.settimeout(timeout)

    def _send_until_done(self, data):
        while True:
            try:
                return self.connection.send(data)
            except OpenSSL.SSL.WantWriteError:
                if not util.wait_for_write(self.socket, self.socket.gettimeout()):
                    raise timeout()
                continue
            except OpenSSL.SSL.SysCallError as e:
                raise SocketError(str(e))

    def sendall(self, data):
        total_sent = 0
        while total_sent < len(data):
            sent = self._send_until_done(
                data[total_sent : total_sent + SSL_WRITE_BLOCKSIZE]
            )
            total_sent += sent

    def shutdown(self):
        # FIXME rethrow compatible exceptions should we ever use this
        self.connection.shutdown()

    def close(self):
        if self._makefile_refs < 1:
            try:
                self._closed = True
                return self.connection.close()
            except OpenSSL.SSL.Error:
                return
        else:
            self._makefile_refs -= 1

    def getpeercert(self, binary_form=False):
        x509 = self.connection.get_peer_certificate()

        if not x509:
            return x509

        if binary_form:
            return OpenSSL.crypto.dump_certificate(OpenSSL.crypto.FILETYPE_ASN1, x509)

        return {
            "subject": ((("commonName", x509.get_subject().CN),),),
            "subjectAltName": get_subj_alt_name(x509),
        }

    def version(self):
        return self.connection.get_protocol_version_name()

    def _reuse(self):
        self._makefile_refs += 1

    def _drop(self):
        if self._makefile_refs < 1:
            self.close()
        else:
            self._makefile_refs -= 1


if _fileobject:  # Platform-specific: Python 2

    def makefile(self, mode, bufsize=-1):
        self._makefile_refs += 1
        return _fileobject(self, mode, bufsize, close=True)


else:  # Platform-specific: Python 3
    makefile = backport_makefile

WrappedSocket.makefile = makefile


class PyOpenSSLContext(object):
    """
    I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
    for translating the interface of the standard library ``SSLContext`` object
    to calls into PyOpenSSL.
    """

    def __init__(self, protocol):
        self.protocol = _openssl_versions[protocol]
        self._ctx = OpenSSL.SSL.Context(self.protocol)
        self._options = 0
        self.check_hostname = False

    @property
    def options(self):
        return self._options

    @options.setter
    def options(self, value):
        self._options = value
        self._ctx.set_options(value)

    @property
    def verify_mode(self):
        return _openssl_to_stdlib_verify[self._ctx.get_verify_mode()]

    @verify_mode.setter
    def verify_mode(self, value):
        self._ctx.set_verify(_stdlib_to_openssl_verify[value], _verify_callback)

    def set_default_verify_paths(self):
        self._ctx.set_default_verify_paths()

    def set_ciphers(self, ciphers):
        if isinstance(ciphers, six.text_type):
            ciphers = ciphers.encode("utf-8")
        self._ctx.set_cipher_list(ciphers)

    def load_verify_locations(self, cafile=None, capath=None, cadata=None):
        if cafile is not None:
            cafile = cafile.encode("utf-8")
        if capath is not None:
            capath = capath.encode("utf-8")
        self._ctx.load_verify_locations(cafile, capath)
        if cadata is not None:
            self._ctx.load_verify_locations(BytesIO(cadata))

    def load_cert_chain(self, certfile, keyfile=None, password=None):
        self._ctx.use_certificate_chain_file(certfile)
        if password is not None:
            if not isinstance(password, six.binary_type):
                password = password.encode("utf-8")
            self._ctx.set_passwd_cb(lambda *_: password)
        self._ctx.use_privatekey_file(keyfile or certfile)

    def wrap_socket(
        self,
        sock,
        server_side=False,
        do_handshake_on_connect=True,
        suppress_ragged_eofs=True,
        server_hostname=None,
    ):
        cnx = OpenSSL.SSL.Connection(self._ctx, sock)

        if isinstance(server_hostname, six.text_type):  # Platform-specific: Python 3
            server_hostname = server_hostname.encode("utf-8")

        if server_hostname is not None:
            cnx.set_tlsext_host_name(server_hostname)

        cnx.set_connect_state()

        while True:
            try:
                cnx.do_handshake()
            except OpenSSL.SSL.WantReadError:
                if not util.wait_for_read(sock, sock.gettimeout()):
                    raise timeout("select timed out")
                continue
            except OpenSSL.SSL.Error as e:
                raise ssl.SSLError("bad handshake: %r" % e)
            break

        return WrappedSocket(cnx, sock)


def _verify_callback(cnx, x509, err_no, err_depth, return_code):
    return err_no == 0
site-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000243151446177000024066 0ustar00U

��.e�@sdS)N�rrr�H/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/__init__.py�<module>�site-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-38.opt-1.pyc000064400000046476151446177000025614 0ustar00U

��.e��@s�dZddlmZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
mZddlmZmZmZddlmZmZmZmZzdd	l	mZWn$ek
r�dZdd
lmZYnXddgZd
ZejZejj Z!e�"�Z#e�$�Z%dZ&ej'ej(ej)ej*ej+ej,ej-ej.ej/ej0ej1ej2ej3ej4ej5ej6ej7ej8ej9ej:ej;ej<ej=ej>ej?ej@ejAejBejCejDgZEejFejGejHfiZIeJe
d��r�ejKejKfeIe
jL<eJe
d��r�ejMejMfeIe
jN<eJe
d��r�ejGejGfeIe
jO<eJe
d��r�ejPejPfeIe
jQ<eJe
d��rejRejRfeIe
jS<dd�ZTdd�ZUdd�ZVdd�ZWe�XeV�ZYe�ZeW�Z[Gdd�de\�Z]e�rnd#dd�Z^n
d$d d�Z^e^e]_^Gd!d"�d"e\�Z_dS)%a�	
SecureTranport support for urllib3 via ctypes.

This makes platform-native TLS available to urllib3 users on macOS without the
use of a compiler. This is an important feature because the Python Package
Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
this is to give macOS users an alternative solution to the problem, and that
solution is to use SecureTransport.

We use ctypes here because this solution must not require a compiler. That's
because pip is not allowed to require a compiler either.

This is not intended to be a seriously long-term solution to this problem.
The hope is that PEP 543 will eventually solve this issue for us, at which
point we can retire this contrib module. But in the short term, we need to
solve the impending tire fire that is Python on Mac without this kind of
contrib module. So...here we are.

To use this module, simply import and inject it::

    import urllib3.contrib.securetransport
    urllib3.contrib.securetransport.inject_into_urllib3()

Happy TLSing!

This code is a bastardised version of the code found in Will Bond's oscrypto
library. An enormous debt is owed to him for blazing this trail for us. For
that reason, this code should be considered to be covered both by urllib3's
license and by oscrypto's:

    Copyright (c) 2015-2016 Will Bond <will@wbond.net>

    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files (the "Software"),
    to deal in the Software without restriction, including without limitation
    the rights to use, copy, modify, merge, publish, distribute, sublicense,
    and/or sell copies of the Software, and to permit persons to whom the
    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.
�)�absolute_importN�)�util�)�Security�
SecurityConst�CoreFoundation)�_assert_no_error�_cert_array_from_pem�_temporary_keychain�_load_client_cert_chain)�_fileobject��backport_makefile�inject_into_urllib3�extract_from_urllib3Ti@�PROTOCOL_SSLv2�PROTOCOL_SSLv3�PROTOCOL_TLSv1�PROTOCOL_TLSv1_1�PROTOCOL_TLSv1_2cCs.tt_ttj_tt_ttj_dt_dtj_dS)zG
    Monkey-patch urllib3 with SecureTransport-backed SSL-support.
    TN)�SecureTransportContextr�
SSLContext�ssl_�HAS_SNI�IS_SECURETRANSPORT�rr�O/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/securetransport.pyr�scCs.tt_ttj_tt_ttj_dt_dtj_dS)z>
    Undo monkey-patching by :func:`inject_into_urllib3`.
    FN)�orig_util_SSLContextrrr�orig_util_HAS_SNIrrrrrrr�sc

Cs�d}�zJt�|�}|dkr"tjWS|j}|d}|��}d}d}z|||kr�|dksZ|dkrtt�||�stt�t	j
d��||}	tj|	�
||�}
|�|
|	�}||7}|sB|s�tjWWSq�qBWnttjk
�r0}zR|j	}|dk	�r |t	j
k�r ||d<|t	jk�s|t	jk�rtjWY�
WS�W5d}~XYnX||d<||k�rLtjWSWdStk
�r�}z|dk	�rt||_tjWY�Sd}~XYnXdS)zs
    SecureTransport read callback. This is called by ST to request that data
    be returned from the socket.
    Nr�	timed out)�_connection_refs�getr�errSSLInternal�socket�
gettimeoutrZ
wait_for_read�error�errno�EAGAIN�ctypes�c_charZfrom_address�	recv_into�errSSLClosedGraceful�
ECONNRESET�EPIPE�errSSLClosedAbort�errSSLWouldBlock�	Exception�
_exception)
�
connection_id�data_buffer�data_length_pointer�wrapped_socket�base_socketZrequested_length�timeoutr&Z
read_countZ	remaining�bufferZ
chunk_size�errr�_read_callback�sP

�


r;c
Csrd}�z(t�|�}|dkr"tjWS|j}|d}t�||�}|��}d}d}	zV|	|kr�|dksf|dkr�t�	||�s�t�
tjd��|�
|�}
|	|
7}	||
d�}qNWnltj
k
�r}zJ|j}|dk	r�|tjkr�|	|d<|tjks�|tjkr�tjWY�
WS�W5d}~XYnX|	|d<|	|k�r*tjWSWdStk
�rl}z|dk	�rR||_tjWY�Sd}~XYnXdS)zx
    SecureTransport write callback. This is called by ST to request that data
    actually be sent on the network.
    Nrr )r!r"rr#r$r)�	string_atr%rZwait_for_writer&r'r(�sendr-r.r/r0r1r2)r3r4r5r6r7Zbytes_to_write�datar8r&�sentZ
chunk_sentr:rrr�_write_callbacksD



r@c@s�eZdZdZdd�Zejdd��Zdd�Zdd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
d*dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd+d"d#�Zd$d%�Zd&d'�Zd(d)�ZdS),�
WrappedSocketz�
    API-compatibility wrapper for Python's OpenSSL wrapped socket object.

    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
    collector of PyPy.
    cCsL||_d|_d|_d|_d|_d|_d|_d|_|j��|_	|j�
d�dS�NrF)r$�context�_makefile_refs�_closedr2�	_keychain�
_keychain_dir�_client_cert_chainr%�_timeout�
settimeout)�selfr$rrr�__init__HszWrappedSocket.__init__ccs4d|_dV|jdk	r0|jd}|_|��|�dS)a]
        A context manager that can be used to wrap calls that do I/O from
        SecureTransport. If any of the I/O callbacks hit an exception, this
        context manager will correctly propagate the exception after the fact.
        This avoids silently swallowing those exceptions.

        It also correctly forces the socket closed.
        N)r2�close)rKZ	exceptionrrr�_raise_on_errorZs

zWrappedSocket._raise_on_errorcCs2tjtt�t�}t�|j|tt��}t|�dS)a4
        Sets up the allowed ciphers. By default this matches the set in
        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
        custom and doesn't allow changing at this time, mostly because parsing
        OpenSSL cipher strings is going to be a freaking nightmare.
        N)rZSSLCipherSuite�len�
CIPHER_SUITESZSSLSetEnabledCiphersrCr	)rK�ciphers�resultrrr�_set_ciphersos�zWrappedSocket._set_ciphersc		Cs|sdStj�|�r2t|d��}|��}W5QRXd}t��}z�t	|�}t�
|jt�
|��}t|�|srt�d��t�||�}t|�t�|d�}t|�t��}t�|t�
|��}t|�W5|r�t�|�|dk	r�t�|�Xtjtjf}|j|k�r
t�d|j��dS)z�
        Called when we have set custom validation. We do this in two cases:
        first, when cert validation is entirely disabled; and second, when
        using a custom trust DB.
        N�rbzFailed to copy trust referenceTz)certificate verify failed, error code: %d)�os�path�isfile�open�readr�SecTrustRefr�	CFReleaser
�SSLCopyPeerTrustrCr)�byrefr	�ssl�SSLErrorZSecTrustSetAnchorCertificatesZ!SecTrustSetAnchorCertificatesOnlyZSecTrustResultTypeZSecTrustEvaluaterZkSecTrustResultUnspecifiedZkSecTrustResultProceed�value)	rK�verify�trust_bundle�fZ
cert_array�trustrRZtrust_resultZ	successesrrr�_custom_validate|s>

��zWrappedSocket._custom_validatec		Cs�t�dtjtj�|_t�|jtt�}	t	|	�t
�0t|�d}
|
tkrT|
dd}
q>|t|
<W5QRXt�
|j|
�}	t	|	�|r�t|t�s�|�d�}t�|j|t|��}	t	|	�|��t�|j|�}	t	|	�t�|j|�}	|	dkr�|tjkr�t�|jtj�}	t	|	�|�r|dk	�r0t�|jtjd�}	t	|	�|�rlt�\|_|_t|j||�|_t�|j|j�}	t	|	�|� ��ht�!|j�}	|	tj"k�r�t#�$d��n>|	tj%k�r�|�&||�W5QR��qlnt	|	�W5QR��q�W5QRX�qldS)z�
        Actually performs the TLS handshake. This is run automatically by
        wrapped socket, and shouldn't be needed in user code.
        Ni���rzutf-8rTzhandshake timed out)'rZSSLCreateContextrZkSSLClientSideZkSSLStreamTyperCZ
SSLSetIOFuncs�_read_callback_pointer�_write_callback_pointerr	�_connection_ref_lock�idr!ZSSLSetConnection�
isinstance�bytes�encodeZSSLSetPeerDomainNamerOrSZSSLSetProtocolVersionMinZSSLSetProtocolVersionMax�kTLSProtocolMaxSupported�kTLSProtocol12ZSSLSetSessionOptionZ"kSSLSessionOptionBreakOnServerAuthrrFrGrrHZSSLSetCertificaterNZSSLHandshaker0r$r8ZerrSSLServerAuthCompletedre)rK�server_hostnamerarbZmin_versionZmax_versionZclient_certZ
client_keyZclient_key_passphraserRZhandlerrr�	handshake�s|��

����
zWrappedSocket.handshakecCs
|j��S�N)r$�fileno�rKrrrrrszWrappedSocket.filenocCs*|jdkr|jd8_|jr&|��dS)Nrr)rDrErMrsrrr�_decref_socketioss
zWrappedSocket._decref_socketioscCs&t�|�}|�||�}|d|�}|Srq)r)Zcreate_string_bufferr+)rKZbufsizr9Z
bytes_readr>rrr�recv s
zWrappedSocket.recvNc	Cs�|jr
dS|dkrt|�}tj|�|�}t�d�}|���t�|j	||t�
|��}W5QRX|tjkr�|j
dkr�t�d��n"|tjtjfkr�|��nt|�|j
S)Nrzrecv timed out)rErOr)r*Zfrom_buffer�c_size_trNrZSSLReadrCr]rr0r`r$r8r,ZerrSSLClosedNoNotifyrMr	)rKr9�nbytes�processed_bytesrRrrrr+&s.

�

�
zWrappedSocket.recv_intocCs
||_dSrq�rI)rKr8rrrrJQszWrappedSocket.settimeoutcCs|jSrqryrsrrrr%TszWrappedSocket.gettimeoutc	Csht�d�}|���"t�|j|t|�t�|��}W5QRX|tj	krZ|j
dkrZt�d��nt
|�|j
S)Nrzsend timed out)r)rvrNrZSSLWriterCrOr]rr0r`r$r8r	)rKr>rxrRrrrr=Ws

�zWrappedSocket.sendcCs4d}|t|�kr0|�|||t��}||7}qdS�Nr)rOr=�SSL_WRITE_BLOCKSIZE)rKr>Z
total_sentr?rrr�sendallhszWrappedSocket.sendallc	Cs$|���t�|j�W5QRXdSrq)rNrZSSLCloserCrsrrr�shutdownns
zWrappedSocket.shutdowncCs�|jdkr�d|_|jr(t�|j�d|_|jr@t�|j�d|_|jrvt�|j�t�|j�t	�
|j�d|_|_|j�
�S|jd8_dS)NrT)rDrErCrr[rHrFrZSecKeychainDelete�shutilZrmtreerGr$rMrsrrrrMrs

zWrappedSocket.closeFc
	Cs�|std��t��}d}d}zxt�|jt�|��}t	|�|sFW�TdSt�
|�}|s\W�>dSt�|d�}t�|�}t�
|�}t�|�}	t�|	|�}W5|r�t�|�|r�t�|�X|S)Nz2SecureTransport only supports dumping binary certsr)�
ValueErrorrrZrr[r\rCr)r]r	ZSecTrustGetCertificateCountZSecTrustGetCertificateAtIndexZSecCertificateCopyDataZCFDataGetLengthZCFDataGetBytePtrr<)
rKZbinary_formrdZcertdataZ	der_bytesrRZ
cert_countZleafZdata_lengthr4rrr�getpeercert�s.




zWrappedSocket.getpeercertcCs�t��}t�|jt�|��}t|�|jtj	kr4dS|jtj
krDdS|jtjkrTdS|jtjkrddS|jtj
krtdS|jtjkr�dSt�d|��dS)NzTLSv1.3zTLSv1.2zTLSv1.1ZTLSv1ZSSLv3ZSSLv2zUnknown TLS version: %r)rZSSLProtocolZSSLGetNegotiatedProtocolVersionrCr)r]r	r`rZkTLSProtocol13rn�kTLSProtocol11�
kTLSProtocol1�
kSSLProtocol3�
kSSLProtocol2r^r_)rK�protocolrRrrr�version�s&�zWrappedSocket.versioncCs|jd7_dS�Nr)rDrsrrr�_reuse�szWrappedSocket._reusecCs&|jdkr|��n|jd8_dSr�)rDrMrsrrr�_drop�s

zWrappedSocket._drop)N)F)�__name__�
__module__�__qualname__�__doc__rL�
contextlib�contextmanagerrNrSrerprrrtrur+rJr%r=r|r}rMr�r�r�r�rrrrrA@s*

9a
+
:rA���cCs|jd7_t|||dd�S)NrT)rM)rDr
)rK�mode�bufsizerrr�makefile�sr��rcOsd}t|||f|�|�Srzr)rKr��	buffering�args�kwargsrrrr��sc@s�eZdZdZdd�Zedd��Zejdd��Zedd��Zejd	d��Zed
d��Z	e	jdd��Z	d
d�Z
dd�Zdd�Zddd�Z
ddd�Zddd�ZdS)rz�
    I am a wrapper class for the SecureTransport library, to translate the
    interface of the standard library ``SSLContext`` object to calls into
    SecureTransport.
    cCs8t|\|_|_d|_d|_d|_d|_d|_d|_dSrB)	�_protocol_to_min_max�_min_version�_max_version�_options�_verify�
_trust_bundle�_client_cert�_client_key�_client_key_passphrase)rKr�rrrrL�szSecureTransportContext.__init__cCsdS)��
        SecureTransport cannot have its hostname checking disabled. For more,
        see the comment on getpeercert() in this file.
        Trrsrrr�check_hostnamesz%SecureTransportContext.check_hostnamecCsdS)r�Nr�rKr`rrrr�	scCs|jSrq�r�rsrrr�optionsszSecureTransportContext.optionscCs
||_dSrqr�r�rrrr�scCs|jrtjStjSrq)r�r^�
CERT_REQUIREDZ	CERT_NONErsrrr�verify_mode sz"SecureTransportContext.verify_modecCs|tjkrdnd|_dS)NTF)r^r�r�r�rrrr�$scCsdSrqrrsrrr�set_default_verify_paths(s
z/SecureTransportContext.set_default_verify_pathscCs|��Srq)r�rsrrr�load_default_certs4sz)SecureTransportContext.load_default_certscCs|tjjkrtd��dS)Nz5SecureTransport doesn't support custom cipher strings)rrZDEFAULT_CIPHERSr)rKrQrrr�set_ciphers7sz"SecureTransportContext.set_ciphersNcCs|dk	rtd��|p||_dS)Nz1SecureTransport does not support cert directories)rr�)rKZcafileZcapathZcadatarrr�load_verify_locations<sz,SecureTransportContext.load_verify_locationscCs||_||_||_dSrq)r�r�Z_client_cert_passphrase)rKZcertfileZkeyfileZpasswordrrr�load_cert_chainCsz&SecureTransportContext.load_cert_chainFTc
Cs2t|�}|�||j|j|j|j|j|j|j�|Srq)	rArpr�r�r�r�r�r�r�)rKZsockZserver_sideZdo_handshake_on_connectZsuppress_ragged_eofsror6rrr�wrap_socketHs�
z"SecureTransportContext.wrap_socket)NNN)NN)FTTN)r�r�r�r�rL�propertyr��setterr�r�r�r�r�r�r�r�rrrrr�s0	


	




�r)r�)r�N)`r�Z
__future__rr�r)r'Zos.pathrUr~r$r^Z	threading�weakref�rZ_securetransport.bindingsrrrZ_securetransport.low_levelr	r
rrr
�ImportErrorZpackages.backports.makefiler�__all__rrrrrZWeakValueDictionaryr!ZLockrhr{Z'TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384Z'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256Z%TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384Z%TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256Z-TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256Z+TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256Z#TLS_DHE_RSA_WITH_AES_256_GCM_SHA384Z#TLS_DHE_RSA_WITH_AES_128_GCM_SHA256Z'TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384Z$TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHAZ'TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256Z$TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHAZ%TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384Z"TLS_ECDHE_RSA_WITH_AES_256_CBC_SHAZ%TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256Z"TLS_ECDHE_RSA_WITH_AES_128_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_256_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_256_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_128_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_128_CBC_SHAZTLS_AES_256_GCM_SHA384ZTLS_AES_128_GCM_SHA256ZTLS_RSA_WITH_AES_256_GCM_SHA384ZTLS_RSA_WITH_AES_128_GCM_SHA256ZTLS_AES_128_CCM_8_SHA256ZTLS_AES_128_CCM_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHA256ZTLS_RSA_WITH_AES_128_CBC_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHAZTLS_RSA_WITH_AES_128_CBC_SHArPZPROTOCOL_TLSr�rmr��hasattrr�rr�rrr�rrnrrrr;r@ZSSLReadFuncrfZSSLWriteFuncrg�objectrAr�rrrrr�<module>s�3�%���
�
�
�
�
76

!
site-packages/pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-38.pyc000064400000012653151446177000022522 0ustar00U

��.e|�@s(dZddlmZzddlZWn6ek
rRddlZddlmZe�de��YnXddl	m
ZmZ
ddlmZmZdd	lmZmZdd
lmZmZddlmZddlmZzddlZWnek
r�dZYnXGd
d�de�ZGdd�dee�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)a_
This module contains provisional support for SOCKS proxies from within
urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
SOCKS5. To enable its functionality, either install PySocks or install this
module with the ``socks`` extra.

The SOCKS implementation supports the full range of urllib3 features. It also
supports the following SOCKS features:

- SOCKS4A (``proxy_url='socks4a://...``)
- SOCKS4 (``proxy_url='socks4://...``)
- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
- SOCKS5 with local DNS (``proxy_url='socks5://...``)
- Usernames and passwords for the SOCKS proxy

 .. note::
    It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
    your ``proxy_url`` to ensure that DNS resolution is done from the remote
    server instead of client-side when connecting to a domain name.

SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
supports IPv4, IPv6, and domain names.

When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
will be sent as the ``userid`` section of the SOCKS request::

    proxy_url="socks4a://<userid>@proxy-host"

When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
of the ``proxy_url`` will be sent as the username/password to authenticate
with the proxy::

    proxy_url="socks5h://<username>:<password>@proxy-host"

�)�absolute_importN�)�DependencyWarningz�SOCKS support in urllib3 requires the installation of optional dependencies: specifically, PySocks.  For more information, see https://urllib3.readthedocs.io/en/latest/contrib.html#socks-proxies)�error�timeout)�HTTPConnection�HTTPSConnection)�HTTPConnectionPool�HTTPSConnectionPool)�ConnectTimeoutError�NewConnectionError)�PoolManager)�	parse_urlcs(eZdZdZ�fdd�Zdd�Z�ZS)�SOCKSConnectionzG
    A plain-text HTTP connection that connects via a SOCKS proxy.
    cs"|�d�|_tt|�j||�dS)N�_socks_options)�popr�superr�__init__)�self�args�kwargs��	__class__��E/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/socks.pyrJszSOCKSConnection.__init__c
CsHi}|jr|j|d<|jr$|j|d<zTtj|j|jff|jd|jd|jd|jd|jd|jd|jd	�|��}Wn�tk
r�t	|d
|j|jf��Yn�tj
k
�r}zP|jr�|j}t|t�r�t	|d
|j|jf��nt
|d|��nt
|d|��W5d}~XYn2tk
�rB}zt
|d|��W5d}~XYnX|S)
zA
        Establish a new connection via the SOCKS proxy.
        �source_address�socket_options�
socks_version�
proxy_host�
proxy_port�username�password�rdns)Z
proxy_typeZ
proxy_addrrZproxy_usernameZproxy_passwordZ
proxy_rdnsrz0Connection to %s timed out. (connect timeout=%s)z(Failed to establish a new connection: %sN)rr�socksZcreate_connection�host�portrr�
SocketTimeoutrZ
ProxyErrorZ
socket_err�
isinstancer�SocketError)rZextra_kwZconn�errrr�	_new_connNsd


��	�

��

�����zSOCKSConnection._new_conn)�__name__�
__module__�__qualname__�__doc__rr*�
__classcell__rrrrrEsrc@seZdZdS)�SOCKSHTTPSConnectionN)r+r,r-rrrrr0�sr0c@seZdZeZdS)�SOCKSHTTPConnectionPoolN)r+r,r-r�
ConnectionClsrrrrr1�sr1c@seZdZeZdS)�SOCKSHTTPSConnectionPoolN)r+r,r-r0r2rrrrr3�sr3cs,eZdZdZeed�Zd�fdd�	Z�ZS)�SOCKSProxyManagerzh
    A version of the urllib3 ProxyManager that routes connections via the
    defined SOCKS proxy.
    )ZhttpZhttpsN�
cs�t|�}|dkrB|dkrB|jdk	rB|j�d�}t|�dkrB|\}}|jdkrXtj}	d}
nN|jdkrntj}	d}
n8|jdkr�tj}	d}
n"|jdkr�tj}	d}
ntd	|��||_	|	|j
|j|||
d
�}||d<tt
|�j||f|�t
j|_dS)N�:rZsocks5FZsocks5hTZsocks4Zsocks4az)Unable to determine SOCKS version from %s)rrrr r!r"r)rZauth�split�lenZschemer#ZPROXY_TYPE_SOCKS5ZPROXY_TYPE_SOCKS4�
ValueError�	proxy_urlr$r%rr4r�pool_classes_by_scheme)rr:r r!Z	num_poolsZheadersZconnection_pool_kwZparsedr7rr"Z
socks_optionsrrrr�sD	



�
��zSOCKSProxyManager.__init__)NNr5N)	r+r,r-r.r1r3r;rr/rrrrr4�s��r4) r.Z
__future__rr#�ImportError�warnings�
exceptionsr�warnZsocketrr(rr&Z
connectionrrZconnectionpoolr	r
rrZpoolmanagerr
Zutil.urlrZsslrr0r1r3r4rrrr�<module>s4#�
Hsite-packages/pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-38.opt-1.pyc000064400000020312151446177000024274 0ustar00U

��.e2,�@sdZddlmZddlZddlZddlZddlmZddlm	Z	m
Z
mZmZm
Z
mZddlmZddlmZdd	lmZdd
lmZddlmZzdd
lmZWnek
r�dZYnXe�e�ZGdd�de
�ZGdd�de	�Z Gdd�de�Z!ej"Z"ej#Z#ej$Z$ej%Z%ej&Z&dS)a[
This module provides a pool manager that uses Google App Engine's
`URLFetch Service <https://cloud.google.com/appengine/docs/python/urlfetch>`_.

Example usage::

    from pip._vendor.urllib3 import PoolManager
    from pip._vendor.urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox

    if is_appengine_sandbox():
        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
        http = AppEngineManager()
    else:
        # PoolManager uses a socket-level API behind the scenes
        http = PoolManager()

    r = http.request('GET', 'https://google.com/')

There are `limitations <https://cloud.google.com/appengine/docs/python/urlfetch/#Python_Quotas_and_limits>`_ to the URLFetch service and it may not be
the best choice for your application. There are three options for using
urllib3 on Google App Engine:

1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
   cost-effective in many circumstances as long as your usage is within the
   limitations.
2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
   Sockets also have `limitations and restrictions
   <https://cloud.google.com/appengine/docs/python/sockets/   #limitations-and-restrictions>`_ and have a lower free quota than URLFetch.
   To use sockets, be sure to specify the following in your ``app.yaml``::

        env_variables:
            GAE_USE_SOCKETS_HTTPLIB : 'true'

3. If you are using `App Engine Flexible
<https://cloud.google.com/appengine/docs/flexible/>`_, you can use the standard
:class:`PoolManager` without any configuration or special environment variables.
�)�absolute_importN�)�urljoin)�	HTTPError�HTTPWarning�
MaxRetryError�
ProtocolError�TimeoutError�SSLError)�RequestMethods)�HTTPResponse)�Timeout)�Retry�)�_appengine_environ)�urlfetchc@seZdZdS)�AppEnginePlatformWarningN��__name__�
__module__�__qualname__�rr�I/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/appengine.pyrGsrc@seZdZdS)�AppEnginePlatformErrorNrrrrrrKsrc@sXeZdZdZddd�Zdd�Zdd	�Zddddejfd
d�Z	dd
�Z
dd�Zdd�ZdS)�AppEngineManagera
    Connection manager for Google App Engine sandbox applications.

    This manager uses the URLFetch service directly instead of using the
    emulated httplib, and is subject to URLFetch limitations as described in
    the App Engine documentation `here
    <https://cloud.google.com/appengine/docs/python/urlfetch>`_.

    Notably it will raise an :class:`AppEnginePlatformError` if:
        * URLFetch is not available.
        * If you attempt to use this on App Engine Flexible, as full socket
          support is available.
        * If a request size is more than 10 megabytes.
        * If a response size is more than 32 megabtyes.
        * If you use an unsupported request method such as OPTIONS.

    Beyond those cases, it will raise normal urllib3 errors.
    NTcCsNtstd��t�rtd��t�dt�t�||�||_||_	|pFt
j|_dS)Nz.URLFetch is not available in this environment.z�Use normal urllib3.PoolManager instead of AppEngineManageron Managed VMs, as using URLFetch is not necessary in this environment.z�urllib3 is using URLFetch on Google App Engine sandbox instead of sockets. To use sockets directly instead of URLFetch see https://urllib3.readthedocs.io/en/latest/reference/urllib3.contrib.html.)
rr�is_prod_appengine_mvms�warnings�warnrr�__init__�validate_certificate�urlfetch_retriesrZDEFAULT�retries)�self�headersr!rr rrrrcs ���zAppEngineManager.__init__cCs|S)Nr)r"rrr�	__enter__�szAppEngineManager.__enter__cCsdS)NFr)r"�exc_typeZexc_valZexc_tbrrr�__exit__�szAppEngineManager.__exit__c
Ks�|�||�}zF|o |jdko |j}	tj||||p2id|jo<|	|�|�|jd�}
W�nBtjk
r�}zt	||��W5d}~XY�ntj
k
r�}z"dt|�kr�td|��t
|��W5d}~XYn�tjk
�r}z&dt|�kr�t|||d��t
|��W5d}~XYn�tjk
�r6}ztd|��W5d}~XYn`tjk
�rb}zt|��W5d}~XYn4tjk
�r�}ztd	||��W5d}~XYnX|j|
fd
|i|��}|�o�|��}
|
�rv|j�r�|j�r�t||d��n�|jdk�r�d
}z|j||||d�}Wn.tk
�r2|j�r*t||d��|YSX|�|�t�d||
�t||
�}|j||||f|||d�|��St|�d��}|� ||j|��r�|j||||d�}t�d|�|�!|�|j||f|||||d�|��S|S)NrF)Zpayload�methodr#Zallow_truncated�follow_redirectsZdeadlinerz	too largezOURLFetch request too large, URLFetch only supports requests up to 10mb in size.zToo many redirects)�reasonzPURLFetch response too large, URLFetch only supportsresponses up to 32mb in size.z$URLFetch does not support method: %sr!ztoo many redirectsi/ZGET)�responseZ_poolzRedirecting %s -> %s)r!�redirect�timeoutzRetry-Afterz	Retry: %s)�bodyr#r!r+r,)"�_get_retriesr+�totalrZfetchr �_get_absolute_timeoutrZDeadlineExceededErrorr	ZInvalidURLError�strrrZ
DownloadErrorrZResponseTooLargeErrorZSSLCertificateErrorr
ZInvalidMethodError�#_urlfetch_response_to_http_responseZget_redirect_locationZraise_on_redirect�statusZ	incrementZsleep_for_retry�log�debugr�urlopen�boolZ	getheaderZis_retry�sleep)r"r'Zurlr-r#r!r+r,�response_kwr(r*�eZ
http_responseZredirect_locationZredirect_urlZhas_retry_afterrrrr6�s��
�������



���
���zAppEngineManager.urlopencKs�t�r"|j�d�}|dkr"|jd=|j�d�}|dkrZ|�d�}|�d�d�|�|jd<tft�|j	�|j
|j|jd�|��}tft�|j	�|j|j|d�|��S)Nzcontent-encodingZdeflateztransfer-encodingZchunked�,)r-�msgr#r3)r-r#r3�original_response)�is_prod_appenginer#�get�split�remove�joinr�io�BytesIOZcontentZ
header_msgZstatus_code)r"Z
urlfetch_respr9Zcontent_encodingZtransfer_encodingZ	encodingsr=rrrr2�s2


��

��z4AppEngineManager._urlfetch_response_to_http_responsecCsB|tjkrdSt|t�r>|jdk	s,|jdk	r8t�dt�|jS|S)NzdURLFetch does not support granular timeout settings, reverting to total or default URLFetch timeout.)	r
�DEFAULT_TIMEOUT�
isinstanceZ_readZ_connectrrrr/)r"r,rrrr0 s

�z&AppEngineManager._get_absolute_timeoutcCs>t|t�stj|||jd�}|js.|js.|jr:t�dt	�|S)N)r+�defaultzhURLFetch only supports total retries and does not recognize connect, read, or redirect retry parameters.)
rFrZfrom_intr!Zconnect�readr+rrr)r"r!r+rrrr.-s
�zAppEngineManager._get_retries)NNTT)
rrr�__doc__rr$r&r
rEr6r2r0r.rrrrrOs"�
 �
r$
r)'rIZ
__future__rrCZloggingrZpackages.six.moves.urllib.parser�
exceptionsrrrrr	r
Zrequestrr*rZutil.timeoutr
Z
util.retryr�rZgoogle.appengine.apir�ImportErrorZ	getLoggerrr4rrrZis_appengineZis_appengine_sandboxZis_local_appenginer>rrrrr�<module>s2( 	

osite-packages/pip/_vendor/urllib3/contrib/__pycache__/appengine.cpython-38.pyc000064400000020312151446177000023335 0ustar00U

��.e2,�@sdZddlmZddlZddlZddlZddlmZddlm	Z	m
Z
mZmZm
Z
mZddlmZddlmZdd	lmZdd
lmZddlmZzdd
lmZWnek
r�dZYnXe�e�ZGdd�de
�ZGdd�de	�Z Gdd�de�Z!ej"Z"ej#Z#ej$Z$ej%Z%ej&Z&dS)a[
This module provides a pool manager that uses Google App Engine's
`URLFetch Service <https://cloud.google.com/appengine/docs/python/urlfetch>`_.

Example usage::

    from pip._vendor.urllib3 import PoolManager
    from pip._vendor.urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox

    if is_appengine_sandbox():
        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
        http = AppEngineManager()
    else:
        # PoolManager uses a socket-level API behind the scenes
        http = PoolManager()

    r = http.request('GET', 'https://google.com/')

There are `limitations <https://cloud.google.com/appengine/docs/python/urlfetch/#Python_Quotas_and_limits>`_ to the URLFetch service and it may not be
the best choice for your application. There are three options for using
urllib3 on Google App Engine:

1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
   cost-effective in many circumstances as long as your usage is within the
   limitations.
2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
   Sockets also have `limitations and restrictions
   <https://cloud.google.com/appengine/docs/python/sockets/   #limitations-and-restrictions>`_ and have a lower free quota than URLFetch.
   To use sockets, be sure to specify the following in your ``app.yaml``::

        env_variables:
            GAE_USE_SOCKETS_HTTPLIB : 'true'

3. If you are using `App Engine Flexible
<https://cloud.google.com/appengine/docs/flexible/>`_, you can use the standard
:class:`PoolManager` without any configuration or special environment variables.
�)�absolute_importN�)�urljoin)�	HTTPError�HTTPWarning�
MaxRetryError�
ProtocolError�TimeoutError�SSLError)�RequestMethods)�HTTPResponse)�Timeout)�Retry�)�_appengine_environ)�urlfetchc@seZdZdS)�AppEnginePlatformWarningN��__name__�
__module__�__qualname__�rr�I/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/appengine.pyrGsrc@seZdZdS)�AppEnginePlatformErrorNrrrrrrKsrc@sXeZdZdZddd�Zdd�Zdd	�Zddddejfd
d�Z	dd
�Z
dd�Zdd�ZdS)�AppEngineManagera
    Connection manager for Google App Engine sandbox applications.

    This manager uses the URLFetch service directly instead of using the
    emulated httplib, and is subject to URLFetch limitations as described in
    the App Engine documentation `here
    <https://cloud.google.com/appengine/docs/python/urlfetch>`_.

    Notably it will raise an :class:`AppEnginePlatformError` if:
        * URLFetch is not available.
        * If you attempt to use this on App Engine Flexible, as full socket
          support is available.
        * If a request size is more than 10 megabytes.
        * If a response size is more than 32 megabtyes.
        * If you use an unsupported request method such as OPTIONS.

    Beyond those cases, it will raise normal urllib3 errors.
    NTcCsNtstd��t�rtd��t�dt�t�||�||_||_	|pFt
j|_dS)Nz.URLFetch is not available in this environment.z�Use normal urllib3.PoolManager instead of AppEngineManageron Managed VMs, as using URLFetch is not necessary in this environment.z�urllib3 is using URLFetch on Google App Engine sandbox instead of sockets. To use sockets directly instead of URLFetch see https://urllib3.readthedocs.io/en/latest/reference/urllib3.contrib.html.)
rr�is_prod_appengine_mvms�warnings�warnrr�__init__�validate_certificate�urlfetch_retriesrZDEFAULT�retries)�self�headersr!rr rrrrcs ���zAppEngineManager.__init__cCs|S)Nr)r"rrr�	__enter__�szAppEngineManager.__enter__cCsdS)NFr)r"�exc_typeZexc_valZexc_tbrrr�__exit__�szAppEngineManager.__exit__c
Ks�|�||�}zF|o |jdko |j}	tj||||p2id|jo<|	|�|�|jd�}
W�nBtjk
r�}zt	||��W5d}~XY�ntj
k
r�}z"dt|�kr�td|��t
|��W5d}~XYn�tjk
�r}z&dt|�kr�t|||d��t
|��W5d}~XYn�tjk
�r6}ztd|��W5d}~XYn`tjk
�rb}zt|��W5d}~XYn4tjk
�r�}ztd	||��W5d}~XYnX|j|
fd
|i|��}|�o�|��}
|
�rv|j�r�|j�r�t||d��n�|jdk�r�d
}z|j||||d�}Wn.tk
�r2|j�r*t||d��|YSX|�|�t�d||
�t||
�}|j||||f|||d�|��St|�d��}|� ||j|��r�|j||||d�}t�d|�|�!|�|j||f|||||d�|��S|S)NrF)Zpayload�methodr#Zallow_truncated�follow_redirectsZdeadlinerz	too largezOURLFetch request too large, URLFetch only supports requests up to 10mb in size.zToo many redirects)�reasonzPURLFetch response too large, URLFetch only supportsresponses up to 32mb in size.z$URLFetch does not support method: %sr!ztoo many redirectsi/ZGET)�responseZ_poolzRedirecting %s -> %s)r!�redirect�timeoutzRetry-Afterz	Retry: %s)�bodyr#r!r+r,)"�_get_retriesr+�totalrZfetchr �_get_absolute_timeoutrZDeadlineExceededErrorr	ZInvalidURLError�strrrZ
DownloadErrorrZResponseTooLargeErrorZSSLCertificateErrorr
ZInvalidMethodError�#_urlfetch_response_to_http_responseZget_redirect_locationZraise_on_redirect�statusZ	incrementZsleep_for_retry�log�debugr�urlopen�boolZ	getheaderZis_retry�sleep)r"r'Zurlr-r#r!r+r,�response_kwr(r*�eZ
http_responseZredirect_locationZredirect_urlZhas_retry_afterrrrr6�s��
�������



���
���zAppEngineManager.urlopencKs�t�r"|j�d�}|dkr"|jd=|j�d�}|dkrZ|�d�}|�d�d�|�|jd<tft�|j	�|j
|j|jd�|��}tft�|j	�|j|j|d�|��S)Nzcontent-encodingZdeflateztransfer-encodingZchunked�,)r-�msgr#r3)r-r#r3�original_response)�is_prod_appenginer#�get�split�remove�joinr�io�BytesIOZcontentZ
header_msgZstatus_code)r"Z
urlfetch_respr9Zcontent_encodingZtransfer_encodingZ	encodingsr=rrrr2�s2


��

��z4AppEngineManager._urlfetch_response_to_http_responsecCsB|tjkrdSt|t�r>|jdk	s,|jdk	r8t�dt�|jS|S)NzdURLFetch does not support granular timeout settings, reverting to total or default URLFetch timeout.)	r
�DEFAULT_TIMEOUT�
isinstanceZ_readZ_connectrrrr/)r"r,rrrr0 s

�z&AppEngineManager._get_absolute_timeoutcCs>t|t�stj|||jd�}|js.|js.|jr:t�dt	�|S)N)r+�defaultzhURLFetch only supports total retries and does not recognize connect, read, or redirect retry parameters.)
rFrZfrom_intr!Zconnect�readr+rrr)r"r!r+rrrr.-s
�zAppEngineManager._get_retries)NNTT)
rrr�__doc__rr$r&r
rEr6r2r0r.rrrrrOs"�
 �
r$
r)'rIZ
__future__rrCZloggingrZpackages.six.moves.urllib.parser�
exceptionsrrrrr	r
Zrequestrr*rZutil.timeoutr
Z
util.retryr�rZgoogle.appengine.apir�ImportErrorZ	getLoggerrr4rrrZis_appengineZis_appengine_sandboxZis_local_appenginer>rrrrr�<module>s2( 	

osite-packages/pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-38.opt-1.pyc000064400000002073151446177000026177 0ustar00U

��.e��@s8dZddlZdd�Zdd�Zdd�Zd	d
�Zdd�ZdS)
zB
This module provides means to detect the App Engine environment.
�NcCst�pt�pt�S�N)�is_local_appengine�is_prod_appengine�is_prod_appengine_mvms�rr�R/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py�is_appenginesrcCst�ot�Sr)rrrrrr�is_appengine_sandboxsr	cCsdtjkodtjdkS)N�APPENGINE_RUNTIMEzDevelopment/�SERVER_SOFTWARE)�os�environrrrrrs
�rcCs dtjkodtjdkot�S)Nr
zGoogle App Engine/r)rr
rrrrrrs

��rcCstj�dd�dkS)NZGAE_VMF�true)rr
�getrrrrrsr)�__doc__rrr	rrrrrrr�<module>ssite-packages/pip/_vendor/urllib3/contrib/__pycache__/socks.cpython-38.opt-1.pyc000064400000012653151446177000023461 0ustar00U

��.e|�@s(dZddlmZzddlZWn6ek
rRddlZddlmZe�de��YnXddl	m
ZmZ
ddlmZmZdd	lmZmZdd
lmZmZddlmZddlmZzddlZWnek
r�dZYnXGd
d�de�ZGdd�dee�ZGdd�de�ZGdd�de�ZGdd�de�ZdS)a_
This module contains provisional support for SOCKS proxies from within
urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
SOCKS5. To enable its functionality, either install PySocks or install this
module with the ``socks`` extra.

The SOCKS implementation supports the full range of urllib3 features. It also
supports the following SOCKS features:

- SOCKS4A (``proxy_url='socks4a://...``)
- SOCKS4 (``proxy_url='socks4://...``)
- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
- SOCKS5 with local DNS (``proxy_url='socks5://...``)
- Usernames and passwords for the SOCKS proxy

 .. note::
    It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
    your ``proxy_url`` to ensure that DNS resolution is done from the remote
    server instead of client-side when connecting to a domain name.

SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
supports IPv4, IPv6, and domain names.

When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
will be sent as the ``userid`` section of the SOCKS request::

    proxy_url="socks4a://<userid>@proxy-host"

When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
of the ``proxy_url`` will be sent as the username/password to authenticate
with the proxy::

    proxy_url="socks5h://<username>:<password>@proxy-host"

�)�absolute_importN�)�DependencyWarningz�SOCKS support in urllib3 requires the installation of optional dependencies: specifically, PySocks.  For more information, see https://urllib3.readthedocs.io/en/latest/contrib.html#socks-proxies)�error�timeout)�HTTPConnection�HTTPSConnection)�HTTPConnectionPool�HTTPSConnectionPool)�ConnectTimeoutError�NewConnectionError)�PoolManager)�	parse_urlcs(eZdZdZ�fdd�Zdd�Z�ZS)�SOCKSConnectionzG
    A plain-text HTTP connection that connects via a SOCKS proxy.
    cs"|�d�|_tt|�j||�dS)N�_socks_options)�popr�superr�__init__)�self�args�kwargs��	__class__��E/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/socks.pyrJszSOCKSConnection.__init__c
CsHi}|jr|j|d<|jr$|j|d<zTtj|j|jff|jd|jd|jd|jd|jd|jd|jd	�|��}Wn�tk
r�t	|d
|j|jf��Yn�tj
k
�r}zP|jr�|j}t|t�r�t	|d
|j|jf��nt
|d|��nt
|d|��W5d}~XYn2tk
�rB}zt
|d|��W5d}~XYnX|S)
zA
        Establish a new connection via the SOCKS proxy.
        �source_address�socket_options�
socks_version�
proxy_host�
proxy_port�username�password�rdns)Z
proxy_typeZ
proxy_addrrZproxy_usernameZproxy_passwordZ
proxy_rdnsrz0Connection to %s timed out. (connect timeout=%s)z(Failed to establish a new connection: %sN)rr�socksZcreate_connection�host�portrr�
SocketTimeoutrZ
ProxyErrorZ
socket_err�
isinstancer�SocketError)rZextra_kwZconn�errrr�	_new_connNsd


��	�

��

�����zSOCKSConnection._new_conn)�__name__�
__module__�__qualname__�__doc__rr*�
__classcell__rrrrrEsrc@seZdZdS)�SOCKSHTTPSConnectionN)r+r,r-rrrrr0�sr0c@seZdZeZdS)�SOCKSHTTPConnectionPoolN)r+r,r-r�
ConnectionClsrrrrr1�sr1c@seZdZeZdS)�SOCKSHTTPSConnectionPoolN)r+r,r-r0r2rrrrr3�sr3cs,eZdZdZeed�Zd�fdd�	Z�ZS)�SOCKSProxyManagerzh
    A version of the urllib3 ProxyManager that routes connections via the
    defined SOCKS proxy.
    )ZhttpZhttpsN�
cs�t|�}|dkrB|dkrB|jdk	rB|j�d�}t|�dkrB|\}}|jdkrXtj}	d}
nN|jdkrntj}	d}
n8|jdkr�tj}	d}
n"|jdkr�tj}	d}
ntd	|��||_	|	|j
|j|||
d
�}||d<tt
|�j||f|�t
j|_dS)N�:rZsocks5FZsocks5hTZsocks4Zsocks4az)Unable to determine SOCKS version from %s)rrrr r!r"r)rZauth�split�lenZschemer#ZPROXY_TYPE_SOCKS5ZPROXY_TYPE_SOCKS4�
ValueError�	proxy_urlr$r%rr4r�pool_classes_by_scheme)rr:r r!Z	num_poolsZheadersZconnection_pool_kwZparsedr7rr"Z
socks_optionsrrrr�sD	



�
��zSOCKSProxyManager.__init__)NNr5N)	r+r,r-r.r1r3r;rr/rrrrr4�s��r4) r.Z
__future__rr#�ImportError�warnings�
exceptionsr�warnZsocketrr(rr&Z
connectionrrZconnectionpoolr	r
rrZpoolmanagerr
Zutil.urlrZsslrr0r1r3r4rrrr�<module>s4#�
Hsite-packages/pip/_vendor/urllib3/contrib/__pycache__/_appengine_environ.cpython-38.pyc000064400000002073151446177000025240 0ustar00U

��.e��@s8dZddlZdd�Zdd�Zdd�Zd	d
�Zdd�ZdS)
zB
This module provides means to detect the App Engine environment.
�NcCst�pt�pt�S�N)�is_local_appengine�is_prod_appengine�is_prod_appengine_mvms�rr�R/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_appengine_environ.py�is_appenginesrcCst�ot�Sr)rrrrrr�is_appengine_sandboxsr	cCsdtjkodtjdkS)N�APPENGINE_RUNTIMEzDevelopment/�SERVER_SOFTWARE)�os�environrrrrrs
�rcCs dtjkodtjdkot�S)Nr
zGoogle App Engine/r)rr
rrrrrrs

��rcCstj�dd�dkS)NZGAE_VMF�true)rr
�getrrrrrsr)�__doc__rrr	rrrrrrr�<module>ssite-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-38.pyc000064400000035125151446177000023433 0ustar00U

��.e8@�@s\dZddlmZddlZddlmZddlmZ	ddl
mZzddlm
Z
Wn$ek
rpGdd	�d	e�Z
YnXdd
lmZmZddlmZzddlmZWn$ek
r�dZd
dlmZYnXddlZddlZd
dlmZddlZd
dlmZddgZ dZ!ej"ej#j$ej%ej#j&iZ'e(ed��r@e(ej#d��r@ej#j)e'ej*<e(ed��rhe(ej#d��rhej#j+e'ej,<e(ed��r�e(ej#d��r�ej#j-e'ej.<ej/ej#j0ej1ej#j2ej3ej#j2ej#j4iZ5e6dd�e5�7�D��Z8dZ9ej!Z:ej;j<Z=e�>e?�Z@dd�ZAdd�ZBdd �ZCd!d"�ZDd#d$�ZEGd%d&�d&eF�ZGe�r6d.d(d)�ZHneZHeHeG_HGd*d+�d+eF�ZId,d-�ZJdS)/ab
SSL with SNI_-support for Python 2. Follow these instructions if you would
like to verify SSL certificates in Python 2. Note, the default libraries do
*not* do certificate checking; you need to do additional work to validate
certificates yourself.

This needs the following packages installed:

* pyOpenSSL (tested with 16.0.0)
* cryptography (minimum 1.3.4, from pyopenssl)
* idna (minimum 2.0, from cryptography)

However, pyopenssl depends on cryptography, which depends on idna, so while we
use all three directly here we end up having relatively few packages required.

You can install them with the following command:

    pip install pyopenssl cryptography idna

To activate certificate checking, call
:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
before you begin making HTTP requests. This can be done in a ``sitecustomize``
module, or at any other time before your application begins using ``urllib3``,
like this::

    try:
        import urllib3.contrib.pyopenssl
        urllib3.contrib.pyopenssl.inject_into_urllib3()
    except ImportError:
        pass

Now you can use :mod:`urllib3` as you normally would, and it will support SNI
when the required modules are installed.

Activating this module also has the positive side effect of disabling SSL/TLS
compression in Python 2 (see `CRIME attack`_).

If you want to configure the default list of supported cipher suites, you can
set the ``urllib3.contrib.pyopenssl.DEFAULT_SSL_CIPHER_LIST`` variable.

.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
�)�absolute_importN)�x509)�backend)�_Certificate)�UnsupportedExtensionc@seZdZdS)rN)�__name__�
__module__�__qualname__�r
r
�I/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.pyr7sr)�timeout�error)�BytesIO)�_fileobject�)�backport_makefile)�six)�util�inject_into_urllib3�extract_from_urllib3T�PROTOCOL_SSLv3�SSLv3_METHOD�PROTOCOL_TLSv1_1�TLSv1_1_METHOD�PROTOCOL_TLSv1_2�TLSv1_2_METHODccs|]\}}||fVqdS�Nr
)�.0�k�vr
r
r�	<genexpr>gsr i@cCs4t�tt_ttj_tt_ttj_dt_dtj_dS)z7Monkey-patch urllib3 with PyOpenSSL-backed SSL-support.TN)�_validate_dependencies_met�PyOpenSSLContextr�
SSLContext�ssl_�HAS_SNI�IS_PYOPENSSLr
r
r
rrsscCs.tt_ttj_tt_ttj_dt_dtj_dS)z4Undo monkey-patching by :func:`inject_into_urllib3`.FN)�orig_util_SSLContextrr#r$�orig_util_HAS_SNIr%r&r
r
r
rr�scCsRddlm}t|dd�dkr$td��ddlm}|�}t|dd�dkrNtd��dS)	z{
    Verifies that PyOpenSSL's package-level dependencies have been met.
    Throws `ImportError` if they are not met.
    r)�
Extensions�get_extension_for_classNzX'cryptography' module missing required functionality.  Try upgrading to v1.3.4 or newer.)�X509�_x509zS'pyOpenSSL' module missing required functionality. Try upgrading to v0.14 or newer.)Zcryptography.x509.extensionsr)�getattr�ImportErrorZOpenSSL.cryptor+)r)r+rr
r
rr!�s��r!cCs@dd�}d|kr|S||�}|dkr(dStjdkr<|�d�}|S)a%
    Converts a dNSName SubjectAlternativeName field to the form used by the
    standard library on the given Python version.

    Cryptography produces a dNSName as a unicode string that was idna-decoded
    from ASCII bytes. We need to idna-encode that string to get it back, and
    then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
    uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).

    If the name cannot be idna-encoded then we return None signalling that
    the name given should be skipped.
    cSsvddlm}zJdD]8}|�|�r|t|�d�}|�d�|�|�WSq|�|�WS|jjk
rpYdSXdS)z�
        Borrowed wholesale from the Python Cryptography Project. It turns out
        that we can't just safely call `idna.encode`: it can explode for
        wildcard names. This avoids that problem.
        r)�idna)z*.�.N�ascii)Zpip._vendorr/�
startswith�len�encodeZcoreZ	IDNAError)�namer/�prefixr
r
r�idna_encode�s
z'_dnsname_to_stdlib.<locals>.idna_encode�:N)�r�utf-8)�sys�version_info�decode)r5r7r
r
r�_dnsname_to_stdlib�s

r>cCs�t|d�r|��}ntt|j�}z|j�tj�j	}WnZtj
k
rNgYStjttj
tfk
r�}zt�d|�gWY�Sd}~XYnXdd�tt|�tj��D�}|�dd�|�tj�D��|S)zU
    Given an PyOpenSSL certificate, provides all the subject alternative names.
    �to_cryptographyz�A problem was encountered with the certificate that prevented urllib3 from finding the SubjectAlternativeName field. This can affect certificate validation. The error was %sNcSsg|]}|dk	rd|f�qS)NZDNSr
�rr5r
r
r�
<listcomp>�s�z%get_subj_alt_name.<locals>.<listcomp>css|]}dt|�fVqdS)z
IP AddressN)�strr@r
r
rr �sz$get_subj_alt_name.<locals>.<genexpr>)�hasattrr?r�openssl_backendr,�
extensionsr*rZSubjectAlternativeName�valueZExtensionNotFoundZDuplicateExtensionrZUnsupportedGeneralNameType�UnicodeError�logZwarning�mapr>Zget_values_for_typeZDNSName�extendZ	IPAddress)Z	peer_certZcertZext�e�namesr
r
r�get_subj_alt_name�s2

��	�

�rMc@s�eZdZdZd!dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
d"dd�Zdd�Zdd�Zdd�Zd S)#�
WrappedSocketz�API-compatibility wrapper for Python OpenSSL's Connection-class.

    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
    collector of pypy.
    TcCs"||_||_||_d|_d|_dS�NrF)�
connection�socket�suppress_ragged_eofs�_makefile_refs�_closed)�selfrPrQrRr
r
r�__init__
s
zWrappedSocket.__init__cCs
|j��Sr)rQ�fileno�rUr
r
rrWszWrappedSocket.filenocCs*|jdkr|jd8_|jr&|��dS)Nr�)rSrT�closerXr
r
r�_decref_socketioss
zWrappedSocket._decref_socketiosc
Osz|jj||�}Wn�tjjk
r^}z*|jrB|jdkrBWY�dStt|���W5d}~XYn�tjj	k
r�|j�
�tjjkr�YdS�Yn~tjjk
r�t
�|j|j���s�td��n|j||�YSYn:tjjk
�r}zt�d|��W5d}~XYnX|SdS)N����zUnexpected EOF��The read operation timed out�read error: %r)rP�recv�OpenSSL�SSL�SysCallErrorrR�args�SocketErrorrB�ZeroReturnError�get_shutdown�RECEIVED_SHUTDOWN�
WantReadErrorr�
wait_for_readrQ�
gettimeoutr�Error�ssl�SSLError)rUre�kwargs�datarKr
r
rras"

 zWrappedSocket.recvc
Os
z|jj||�WStjjk
r\}z*|jr@|jdkr@WY�dStt|���W5d}~XYn�tjj	k
r�|j�
�tjjkr�YdS�Ynztjjk
r�t
�|j|j���s�td��n|j||�YSYn6tjjk
�r}zt�d|��W5d}~XYnXdS)Nr\rr_r`)rP�	recv_intorbrcrdrRrerfrBrgrhrirjrrkrQrlrrmrnro)rUrerprKr
r
rrr7s 

zWrappedSocket.recv_intocCs|j�|�Sr)rQ�
settimeout)rUrr
r
rrsNszWrappedSocket.settimeoutc
Cs|z|j�|�WStjjk
rDt�|j|j���s<t	��YqYqtjj
k
rt}ztt|���W5d}~XYqXqdSr)
rP�sendrbrcZWantWriteErrorrZwait_for_writerQrlrrdrfrB)rUrqrKr
r
r�_send_until_doneQszWrappedSocket._send_until_donecCs4d}|t|�kr0|�|||t��}||7}qdS�Nr)r3ru�SSL_WRITE_BLOCKSIZE)rUrqZ
total_sentZsentr
r
r�sendall\s�zWrappedSocket.sendallcCs|j��dSr)rP�shutdownrXr
r
rrydszWrappedSocket.shutdowncCsL|jdkr:zd|_|j��WStjjk
r6YdSXn|jd8_dS)NrYT)rSrTrPrZrbrcrmrXr
r
rrZhs

zWrappedSocket.closeFcCsD|j��}|s|S|r(tj�tjj|�Sd|��jffft|�d�S)NZ
commonName)ZsubjectZsubjectAltName)	rPZget_peer_certificaterbZcryptoZdump_certificateZ
FILETYPE_ASN1Zget_subjectZCNrM)rUZbinary_formrr
r
r�getpeercertrs
�zWrappedSocket.getpeercertcCs
|j��Sr)rPZget_protocol_version_namerXr
r
r�version�szWrappedSocket.versioncCs|jd7_dS�NrY)rSrXr
r
r�_reuse�szWrappedSocket._reusecCs&|jdkr|��n|jd8_dSr|)rSrZrXr
r
r�_drop�s

zWrappedSocket._dropN)T)F)rrr	�__doc__rVrWr[rarrrsrurxryrZrzr{r}r~r
r
r
rrNs


rNr]cCs|jd7_t|||dd�S)NrYT)rZ)rSr)rU�mode�bufsizer
r
r�makefile�sr�c@szeZdZdZdd�Zedd��Zejdd��Zedd��Zejd	d��Zd
d�Z	dd
�Z
ddd�Zddd�Zddd�Z
dS)r"z�
    I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
    for translating the interface of the standard library ``SSLContext`` object
    to calls into PyOpenSSL.
    cCs*t||_tj�|j�|_d|_d|_dSrO)�_openssl_versions�protocolrbrcZContext�_ctx�_optionsZcheck_hostname)rUr�r
r
rrV�s
zPyOpenSSLContext.__init__cCs|jSr)r�rXr
r
r�options�szPyOpenSSLContext.optionscCs||_|j�|�dSr)r�r�Zset_options�rUrFr
r
rr��scCst|j��Sr)�_openssl_to_stdlib_verifyr�Zget_verify_moderXr
r
r�verify_mode�szPyOpenSSLContext.verify_modecCs|j�t|t�dSr)r�Z
set_verify�_stdlib_to_openssl_verify�_verify_callbackr�r
r
rr��scCs|j��dSr)r��set_default_verify_pathsrXr
r
rr��sz)PyOpenSSLContext.set_default_verify_pathscCs&t|tj�r|�d�}|j�|�dS�Nr:)�
isinstancer�	text_typer4r�Zset_cipher_list)rUZciphersr
r
r�set_ciphers�s
zPyOpenSSLContext.set_ciphersNcCsN|dk	r|�d�}|dk	r$|�d�}|j�||�|dk	rJ|j�t|��dSr�)r4r��load_verify_locationsr)rUZcafileZcapathZcadatar
r
rr��s

z&PyOpenSSLContext.load_verify_locationscsR|j�|��dk	r>t�tj�s*��d��|j��fdd��|j�|pJ|�dS)Nr:cs�Srr
)�_��passwordr
r�<lambda>�r^z2PyOpenSSLContext.load_cert_chain.<locals>.<lambda>)r�Zuse_certificate_chain_filer�rZbinary_typer4Z
set_passwd_cbZuse_privatekey_file)rUZcertfileZkeyfiler�r
r�r�load_cert_chain�s
z PyOpenSSLContext.load_cert_chainFTc
Cs�tj�|j|�}t|tj�r&|�d�}|dk	r8|�|�|�	�z|�
�Wq�tjjk
r�t�
||���sxtd��Yq@Yq�tjjk
r�}zt�d|��W5d}~XYq�Xq�q@t||�S)Nr:zselect timed outzbad handshake: %r)rbrcZ
Connectionr�r�rr�r4Zset_tlsext_host_nameZset_connect_stateZdo_handshakerjrrkrlrrmrnrorN)rUZsockZserver_sideZdo_handshake_on_connectrRZserver_hostname�cnxrKr
r
r�wrap_socket�s 

 zPyOpenSSLContext.wrap_socket)NNN)NN)FTTN)rrr	rrV�propertyr��setterr�r�r�r�r�r�r
r
r
rr"�s&




	
�r"cCs|dkSrvr
)r�rZerr_noZ	err_depthZreturn_coder
r
rr��sr�)r])KrZ
__future__rZOpenSSL.SSLrbZcryptographyrZ$cryptography.hazmat.backends.opensslrrDZ)cryptography.hazmat.backends.openssl.x509rZcryptography.x509rr.�	ExceptionrQrr
rf�iorrZpackages.backports.makefilerZloggingrnZpackagesrr;�r�__all__r%ZPROTOCOL_TLSrcZ
SSLv23_METHODZPROTOCOL_TLSv1ZTLSv1_METHODr�rCrrrrrrZ	CERT_NONEZVERIFY_NONEZ
CERT_OPTIONALZVERIFY_PEERZ
CERT_REQUIREDZVERIFY_FAIL_IF_NO_PEER_CERTr��dict�itemsr�rwr(r$r#r'Z	getLoggerrrHrrr!r>rM�objectrNr�r"r�r
r
r
r�<module>sz+���

+6Wsite-packages/pip/_vendor/urllib3/contrib/__pycache__/pyopenssl.cpython-38.opt-1.pyc000064400000035125151446177000024372 0ustar00U

��.e8@�@s\dZddlmZddlZddlmZddlmZ	ddl
mZzddlm
Z
Wn$ek
rpGdd	�d	e�Z
YnXdd
lmZmZddlmZzddlmZWn$ek
r�dZd
dlmZYnXddlZddlZd
dlmZddlZd
dlmZddgZ dZ!ej"ej#j$ej%ej#j&iZ'e(ed��r@e(ej#d��r@ej#j)e'ej*<e(ed��rhe(ej#d��rhej#j+e'ej,<e(ed��r�e(ej#d��r�ej#j-e'ej.<ej/ej#j0ej1ej#j2ej3ej#j2ej#j4iZ5e6dd�e5�7�D��Z8dZ9ej!Z:ej;j<Z=e�>e?�Z@dd�ZAdd�ZBdd �ZCd!d"�ZDd#d$�ZEGd%d&�d&eF�ZGe�r6d.d(d)�ZHneZHeHeG_HGd*d+�d+eF�ZId,d-�ZJdS)/ab
SSL with SNI_-support for Python 2. Follow these instructions if you would
like to verify SSL certificates in Python 2. Note, the default libraries do
*not* do certificate checking; you need to do additional work to validate
certificates yourself.

This needs the following packages installed:

* pyOpenSSL (tested with 16.0.0)
* cryptography (minimum 1.3.4, from pyopenssl)
* idna (minimum 2.0, from cryptography)

However, pyopenssl depends on cryptography, which depends on idna, so while we
use all three directly here we end up having relatively few packages required.

You can install them with the following command:

    pip install pyopenssl cryptography idna

To activate certificate checking, call
:func:`~urllib3.contrib.pyopenssl.inject_into_urllib3` from your Python code
before you begin making HTTP requests. This can be done in a ``sitecustomize``
module, or at any other time before your application begins using ``urllib3``,
like this::

    try:
        import urllib3.contrib.pyopenssl
        urllib3.contrib.pyopenssl.inject_into_urllib3()
    except ImportError:
        pass

Now you can use :mod:`urllib3` as you normally would, and it will support SNI
when the required modules are installed.

Activating this module also has the positive side effect of disabling SSL/TLS
compression in Python 2 (see `CRIME attack`_).

If you want to configure the default list of supported cipher suites, you can
set the ``urllib3.contrib.pyopenssl.DEFAULT_SSL_CIPHER_LIST`` variable.

.. _sni: https://en.wikipedia.org/wiki/Server_Name_Indication
.. _crime attack: https://en.wikipedia.org/wiki/CRIME_(security_exploit)
�)�absolute_importN)�x509)�backend)�_Certificate)�UnsupportedExtensionc@seZdZdS)rN)�__name__�
__module__�__qualname__�r
r
�I/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/pyopenssl.pyr7sr)�timeout�error)�BytesIO)�_fileobject�)�backport_makefile)�six)�util�inject_into_urllib3�extract_from_urllib3T�PROTOCOL_SSLv3�SSLv3_METHOD�PROTOCOL_TLSv1_1�TLSv1_1_METHOD�PROTOCOL_TLSv1_2�TLSv1_2_METHODccs|]\}}||fVqdS�Nr
)�.0�k�vr
r
r�	<genexpr>gsr i@cCs4t�tt_ttj_tt_ttj_dt_dtj_dS)z7Monkey-patch urllib3 with PyOpenSSL-backed SSL-support.TN)�_validate_dependencies_met�PyOpenSSLContextr�
SSLContext�ssl_�HAS_SNI�IS_PYOPENSSLr
r
r
rrsscCs.tt_ttj_tt_ttj_dt_dtj_dS)z4Undo monkey-patching by :func:`inject_into_urllib3`.FN)�orig_util_SSLContextrr#r$�orig_util_HAS_SNIr%r&r
r
r
rr�scCsRddlm}t|dd�dkr$td��ddlm}|�}t|dd�dkrNtd��dS)	z{
    Verifies that PyOpenSSL's package-level dependencies have been met.
    Throws `ImportError` if they are not met.
    r)�
Extensions�get_extension_for_classNzX'cryptography' module missing required functionality.  Try upgrading to v1.3.4 or newer.)�X509�_x509zS'pyOpenSSL' module missing required functionality. Try upgrading to v0.14 or newer.)Zcryptography.x509.extensionsr)�getattr�ImportErrorZOpenSSL.cryptor+)r)r+rr
r
rr!�s��r!cCs@dd�}d|kr|S||�}|dkr(dStjdkr<|�d�}|S)a%
    Converts a dNSName SubjectAlternativeName field to the form used by the
    standard library on the given Python version.

    Cryptography produces a dNSName as a unicode string that was idna-decoded
    from ASCII bytes. We need to idna-encode that string to get it back, and
    then on Python 3 we also need to convert to unicode via UTF-8 (the stdlib
    uses PyUnicode_FromStringAndSize on it, which decodes via UTF-8).

    If the name cannot be idna-encoded then we return None signalling that
    the name given should be skipped.
    cSsvddlm}zJdD]8}|�|�r|t|�d�}|�d�|�|�WSq|�|�WS|jjk
rpYdSXdS)z�
        Borrowed wholesale from the Python Cryptography Project. It turns out
        that we can't just safely call `idna.encode`: it can explode for
        wildcard names. This avoids that problem.
        r)�idna)z*.�.N�ascii)Zpip._vendorr/�
startswith�len�encodeZcoreZ	IDNAError)�namer/�prefixr
r
r�idna_encode�s
z'_dnsname_to_stdlib.<locals>.idna_encode�:N)�r�utf-8)�sys�version_info�decode)r5r7r
r
r�_dnsname_to_stdlib�s

r>cCs�t|d�r|��}ntt|j�}z|j�tj�j	}WnZtj
k
rNgYStjttj
tfk
r�}zt�d|�gWY�Sd}~XYnXdd�tt|�tj��D�}|�dd�|�tj�D��|S)zU
    Given an PyOpenSSL certificate, provides all the subject alternative names.
    �to_cryptographyz�A problem was encountered with the certificate that prevented urllib3 from finding the SubjectAlternativeName field. This can affect certificate validation. The error was %sNcSsg|]}|dk	rd|f�qS)NZDNSr
�rr5r
r
r�
<listcomp>�s�z%get_subj_alt_name.<locals>.<listcomp>css|]}dt|�fVqdS)z
IP AddressN)�strr@r
r
rr �sz$get_subj_alt_name.<locals>.<genexpr>)�hasattrr?r�openssl_backendr,�
extensionsr*rZSubjectAlternativeName�valueZExtensionNotFoundZDuplicateExtensionrZUnsupportedGeneralNameType�UnicodeError�logZwarning�mapr>Zget_values_for_typeZDNSName�extendZ	IPAddress)Z	peer_certZcertZext�e�namesr
r
r�get_subj_alt_name�s2

��	�

�rMc@s�eZdZdZd!dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
d"dd�Zdd�Zdd�Zdd�Zd S)#�
WrappedSocketz�API-compatibility wrapper for Python OpenSSL's Connection-class.

    Note: _makefile_refs, _drop() and _reuse() are needed for the garbage
    collector of pypy.
    TcCs"||_||_||_d|_d|_dS�NrF)�
connection�socket�suppress_ragged_eofs�_makefile_refs�_closed)�selfrPrQrRr
r
r�__init__
s
zWrappedSocket.__init__cCs
|j��Sr)rQ�fileno�rUr
r
rrWszWrappedSocket.filenocCs*|jdkr|jd8_|jr&|��dS)Nr�)rSrT�closerXr
r
r�_decref_socketioss
zWrappedSocket._decref_socketiosc
Osz|jj||�}Wn�tjjk
r^}z*|jrB|jdkrBWY�dStt|���W5d}~XYn�tjj	k
r�|j�
�tjjkr�YdS�Yn~tjjk
r�t
�|j|j���s�td��n|j||�YSYn:tjjk
�r}zt�d|��W5d}~XYnX|SdS)N����zUnexpected EOF��The read operation timed out�read error: %r)rP�recv�OpenSSL�SSL�SysCallErrorrR�args�SocketErrorrB�ZeroReturnError�get_shutdown�RECEIVED_SHUTDOWN�
WantReadErrorr�
wait_for_readrQ�
gettimeoutr�Error�ssl�SSLError)rUre�kwargs�datarKr
r
rras"

 zWrappedSocket.recvc
Os
z|jj||�WStjjk
r\}z*|jr@|jdkr@WY�dStt|���W5d}~XYn�tjj	k
r�|j�
�tjjkr�YdS�Ynztjjk
r�t
�|j|j���s�td��n|j||�YSYn6tjjk
�r}zt�d|��W5d}~XYnXdS)Nr\rr_r`)rP�	recv_intorbrcrdrRrerfrBrgrhrirjrrkrQrlrrmrnro)rUrerprKr
r
rrr7s 

zWrappedSocket.recv_intocCs|j�|�Sr)rQ�
settimeout)rUrr
r
rrsNszWrappedSocket.settimeoutc
Cs|z|j�|�WStjjk
rDt�|j|j���s<t	��YqYqtjj
k
rt}ztt|���W5d}~XYqXqdSr)
rP�sendrbrcZWantWriteErrorrZwait_for_writerQrlrrdrfrB)rUrqrKr
r
r�_send_until_doneQszWrappedSocket._send_until_donecCs4d}|t|�kr0|�|||t��}||7}qdS�Nr)r3ru�SSL_WRITE_BLOCKSIZE)rUrqZ
total_sentZsentr
r
r�sendall\s�zWrappedSocket.sendallcCs|j��dSr)rP�shutdownrXr
r
rrydszWrappedSocket.shutdowncCsL|jdkr:zd|_|j��WStjjk
r6YdSXn|jd8_dS)NrYT)rSrTrPrZrbrcrmrXr
r
rrZhs

zWrappedSocket.closeFcCsD|j��}|s|S|r(tj�tjj|�Sd|��jffft|�d�S)NZ
commonName)ZsubjectZsubjectAltName)	rPZget_peer_certificaterbZcryptoZdump_certificateZ
FILETYPE_ASN1Zget_subjectZCNrM)rUZbinary_formrr
r
r�getpeercertrs
�zWrappedSocket.getpeercertcCs
|j��Sr)rPZget_protocol_version_namerXr
r
r�version�szWrappedSocket.versioncCs|jd7_dS�NrY)rSrXr
r
r�_reuse�szWrappedSocket._reusecCs&|jdkr|��n|jd8_dSr|)rSrZrXr
r
r�_drop�s

zWrappedSocket._dropN)T)F)rrr	�__doc__rVrWr[rarrrsrurxryrZrzr{r}r~r
r
r
rrNs


rNr]cCs|jd7_t|||dd�S)NrYT)rZ)rSr)rU�mode�bufsizer
r
r�makefile�sr�c@szeZdZdZdd�Zedd��Zejdd��Zedd��Zejd	d��Zd
d�Z	dd
�Z
ddd�Zddd�Zddd�Z
dS)r"z�
    I am a wrapper class for the PyOpenSSL ``Context`` object. I am responsible
    for translating the interface of the standard library ``SSLContext`` object
    to calls into PyOpenSSL.
    cCs*t||_tj�|j�|_d|_d|_dSrO)�_openssl_versions�protocolrbrcZContext�_ctx�_optionsZcheck_hostname)rUr�r
r
rrV�s
zPyOpenSSLContext.__init__cCs|jSr)r�rXr
r
r�options�szPyOpenSSLContext.optionscCs||_|j�|�dSr)r�r�Zset_options�rUrFr
r
rr��scCst|j��Sr)�_openssl_to_stdlib_verifyr�Zget_verify_moderXr
r
r�verify_mode�szPyOpenSSLContext.verify_modecCs|j�t|t�dSr)r�Z
set_verify�_stdlib_to_openssl_verify�_verify_callbackr�r
r
rr��scCs|j��dSr)r��set_default_verify_pathsrXr
r
rr��sz)PyOpenSSLContext.set_default_verify_pathscCs&t|tj�r|�d�}|j�|�dS�Nr:)�
isinstancer�	text_typer4r�Zset_cipher_list)rUZciphersr
r
r�set_ciphers�s
zPyOpenSSLContext.set_ciphersNcCsN|dk	r|�d�}|dk	r$|�d�}|j�||�|dk	rJ|j�t|��dSr�)r4r��load_verify_locationsr)rUZcafileZcapathZcadatar
r
rr��s

z&PyOpenSSLContext.load_verify_locationscsR|j�|��dk	r>t�tj�s*��d��|j��fdd��|j�|pJ|�dS)Nr:cs�Srr
)�_��passwordr
r�<lambda>�r^z2PyOpenSSLContext.load_cert_chain.<locals>.<lambda>)r�Zuse_certificate_chain_filer�rZbinary_typer4Z
set_passwd_cbZuse_privatekey_file)rUZcertfileZkeyfiler�r
r�r�load_cert_chain�s
z PyOpenSSLContext.load_cert_chainFTc
Cs�tj�|j|�}t|tj�r&|�d�}|dk	r8|�|�|�	�z|�
�Wq�tjjk
r�t�
||���sxtd��Yq@Yq�tjjk
r�}zt�d|��W5d}~XYq�Xq�q@t||�S)Nr:zselect timed outzbad handshake: %r)rbrcZ
Connectionr�r�rr�r4Zset_tlsext_host_nameZset_connect_stateZdo_handshakerjrrkrlrrmrnrorN)rUZsockZserver_sideZdo_handshake_on_connectrRZserver_hostname�cnxrKr
r
r�wrap_socket�s 

 zPyOpenSSLContext.wrap_socket)NNN)NN)FTTN)rrr	rrV�propertyr��setterr�r�r�r�r�r�r
r
r
rr"�s&




	
�r"cCs|dkSrvr
)r�rZerr_noZ	err_depthZreturn_coder
r
rr��sr�)r])KrZ
__future__rZOpenSSL.SSLrbZcryptographyrZ$cryptography.hazmat.backends.opensslrrDZ)cryptography.hazmat.backends.openssl.x509rZcryptography.x509rr.�	ExceptionrQrr
rf�iorrZpackages.backports.makefilerZloggingrnZpackagesrr;�r�__all__r%ZPROTOCOL_TLSrcZ
SSLv23_METHODZPROTOCOL_TLSv1ZTLSv1_METHODr�rCrrrrrrZ	CERT_NONEZVERIFY_NONEZ
CERT_OPTIONALZVERIFY_PEERZ
CERT_REQUIREDZVERIFY_FAIL_IF_NO_PEER_CERTr��dict�itemsr�rwr(r$r#r'Z	getLoggerrrHrrr!r>rM�objectrNr�r"r�r
r
r
r�<module>sz+���

+6Wsite-packages/pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-38.pyc000064400000006260151446177000023241 0ustar00U

��.ei�@s\dZddlmZddlmZddlmZddlmZddlm	Z	ee
�ZGdd	�d	e�Zd
S)z
NTLM authenticating pool, contributed by erikcederstran

Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
�)�absolute_import)�	getLogger)�ntlm�)�HTTPSConnectionPool)�HTTPSConnectioncs:eZdZdZdZ�fdd�Zdd�Zd�fd
d�	Z�ZS)
�NTLMConnectionPoolzQ
    Implements an NTLM authentication version of an urllib3 connection pool
    ZhttpscsLtt|�j||�||_||_|�dd�}|d��|_|d|_||_	dS)z�
        authurl is a random URL on the server that is protected by NTLM.
        user is the Windows user, probably in the DOMAIN\username format.
        pw is the password for the user.
        �\�rN)
�superr�__init__�authurl�rawuser�split�upper�domain�user�pw)�selfrrr
�args�kwargsZ
user_parts��	__class__��H/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.pyrs
zNTLMConnectionPool.__init__c
Cs�|jd7_t�d|j|j|j�ddi}d}d}t|j|jd�}dt�|j	�||<t�d	|�|�
d
|jd|�|��}t|�
��}t�d|j|j�t�d|�t�d
|�d��d|_||�d�}d}|D] }	|	dd�dkr�|	dd�}q�|dk�rtd|||f��t�|�\}
}t�|
|j|j|j|�}d|||<t�d	|�|�
d
|jd|�|��}t�d|j|j�t�dt|�
���t�d
|��dd��|jdk�r�|jdk�r�td��td|j|jf��d|_t�d�|S)Nr
z3Starting NTLM HTTPS connection no. %d: https://%s%s�
Connection�
Keep-AliveZ
Authorizationzwww-authenticate)�host�portzNTLM %szRequest headers: %sZGETzResponse status: %s %szResponse headers: %szResponse data: %s [...]�dz, �zNTLM z!Unexpected %s response header: %s��i�z3Server rejected request: wrong username or passwordzWrong server response: %s %szConnection established)Znum_connections�log�debugrr
rrrZcreate_NTLM_NEGOTIATE_MESSAGErZrequestZgetresponse�dictZ
getheadersZstatus�reason�read�fpr�	ExceptionZparse_NTLM_CHALLENGE_MESSAGEZ create_NTLM_AUTHENTICATE_MESSAGErrr)
r�headersZ
req_headerZresp_headerZconn�resZreshdrZauth_header_valuesZauth_header_value�sZServerChallengeZNegotiateFlagsZauth_msgrrr�	_new_conn'sr��

����
zNTLMConnectionPool._new_connN�Tc	s0|dkri}d|d<tt|��|||||||�S)Nrr)rr�urlopen)r�methodZurlZbodyr)ZretriesZredirectZassert_same_hostrrrr.ls

�zNTLMConnectionPool.urlopen)NNr-TT)	�__name__�
__module__�__qualname__�__doc__Zschemerr,r.�
__classcell__rrrrrsI�rN)
r3Z
__future__rZloggingrr�rZpackages.six.moves.http_clientrr0r"rrrrr�<module>ssite-packages/pip/_vendor/urllib3/contrib/__pycache__/securetransport.cpython-38.pyc000064400000046605151446177000024647 0ustar00U

��.e��@s�dZddlmZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
mZddlmZmZmZddlmZmZmZmZzdd	l	mZWn$ek
r�dZdd
lmZYnXddgZd
ZejZejj Z!e�"�Z#e�$�Z%dZ&ej'ej(ej)ej*ej+ej,ej-ej.ej/ej0ej1ej2ej3ej4ej5ej6ej7ej8ej9ej:ej;ej<ej=ej>ej?ej@ejAejBejCejDgZEejFejGejHfiZIeJe
d��r�ejKejKfeIe
jL<eJe
d��r�ejMejMfeIe
jN<eJe
d��r�ejGejGfeIe
jO<eJe
d��r�ejPejPfeIe
jQ<eJe
d��rejRejRfeIe
jS<dd�ZTdd�ZUdd�ZVdd�ZWe�XeV�ZYe�ZeW�Z[Gdd�de\�Z]e�rnd#dd�Z^n
d$d d�Z^e^e]_^Gd!d"�d"e\�Z_dS)%a�	
SecureTranport support for urllib3 via ctypes.

This makes platform-native TLS available to urllib3 users on macOS without the
use of a compiler. This is an important feature because the Python Package
Index is moving to become a TLSv1.2-or-higher server, and the default OpenSSL
that ships with macOS is not capable of doing TLSv1.2. The only way to resolve
this is to give macOS users an alternative solution to the problem, and that
solution is to use SecureTransport.

We use ctypes here because this solution must not require a compiler. That's
because pip is not allowed to require a compiler either.

This is not intended to be a seriously long-term solution to this problem.
The hope is that PEP 543 will eventually solve this issue for us, at which
point we can retire this contrib module. But in the short term, we need to
solve the impending tire fire that is Python on Mac without this kind of
contrib module. So...here we are.

To use this module, simply import and inject it::

    import urllib3.contrib.securetransport
    urllib3.contrib.securetransport.inject_into_urllib3()

Happy TLSing!

This code is a bastardised version of the code found in Will Bond's oscrypto
library. An enormous debt is owed to him for blazing this trail for us. For
that reason, this code should be considered to be covered both by urllib3's
license and by oscrypto's:

    Copyright (c) 2015-2016 Will Bond <will@wbond.net>

    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files (the "Software"),
    to deal in the Software without restriction, including without limitation
    the rights to use, copy, modify, merge, publish, distribute, sublicense,
    and/or sell copies of the Software, and to permit persons to whom the
    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.
�)�absolute_importN�)�util�)�Security�
SecurityConst�CoreFoundation)�_assert_no_error�_cert_array_from_pem�_temporary_keychain�_load_client_cert_chain)�_fileobject��backport_makefile�inject_into_urllib3�extract_from_urllib3Ti@�PROTOCOL_SSLv2�PROTOCOL_SSLv3�PROTOCOL_TLSv1�PROTOCOL_TLSv1_1�PROTOCOL_TLSv1_2cCs.tt_ttj_tt_ttj_dt_dtj_dS)zG
    Monkey-patch urllib3 with SecureTransport-backed SSL-support.
    TN)�SecureTransportContextr�
SSLContext�ssl_�HAS_SNI�IS_SECURETRANSPORT�rr�O/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/securetransport.pyr�scCs.tt_ttj_tt_ttj_dt_dtj_dS)z>
    Undo monkey-patching by :func:`inject_into_urllib3`.
    FN)�orig_util_SSLContextrrr�orig_util_HAS_SNIrrrrrrr�sc

Cs�d}�zJt�|�}|dkr"tjWS|j}|d}|��}d}d}z|||kr�|dksZ|dkrtt�||�stt�t	j
d��||}	tj|	�
||�}
|�|
|	�}||7}|sB|s�tjWWSq�qBWnttjk
�r0}zR|j	}|dk	�r |t	j
k�r ||d<|t	jk�s|t	jk�rtjWY�
WS�W5d}~XYnX||d<||k�rLtjWSWdStk
�r�}z|dk	�rt||_tjWY�Sd}~XYnXdS)zs
    SecureTransport read callback. This is called by ST to request that data
    be returned from the socket.
    Nr�	timed out)�_connection_refs�getr�errSSLInternal�socket�
gettimeoutrZ
wait_for_read�error�errno�EAGAIN�ctypes�c_charZfrom_address�	recv_into�errSSLClosedGraceful�
ECONNRESET�EPIPE�errSSLClosedAbort�errSSLWouldBlock�	Exception�
_exception)
�
connection_id�data_buffer�data_length_pointer�wrapped_socket�base_socketZrequested_length�timeoutr&Z
read_countZ	remaining�bufferZ
chunk_size�errr�_read_callback�sP

�


r;c
Csrd}�z(t�|�}|dkr"tjWS|j}|d}t�||�}|��}d}d}	zV|	|kr�|dksf|dkr�t�	||�s�t�
tjd��|�
|�}
|	|
7}	||
d�}qNWnltj
k
�r}zJ|j}|dk	r�|tjkr�|	|d<|tjks�|tjkr�tjWY�
WS�W5d}~XYnX|	|d<|	|k�r*tjWSWdStk
�rl}z|dk	�rR||_tjWY�Sd}~XYnXdS)zx
    SecureTransport write callback. This is called by ST to request that data
    actually be sent on the network.
    Nrr )r!r"rr#r$r)�	string_atr%rZwait_for_writer&r'r(�sendr-r.r/r0r1r2)r3r4r5r6r7Zbytes_to_write�datar8r&�sentZ
chunk_sentr:rrr�_write_callbacksD



r@c@s�eZdZdZdd�Zejdd��Zdd�Zdd	�Z	d
d�Z
dd
�Zdd�Zdd�Z
d*dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd+d"d#�Zd$d%�Zd&d'�Zd(d)�ZdS),�
WrappedSocketz�
    API-compatibility wrapper for Python's OpenSSL wrapped socket object.

    Note: _makefile_refs, _drop(), and _reuse() are needed for the garbage
    collector of PyPy.
    cCsL||_d|_d|_d|_d|_d|_d|_d|_|j��|_	|j�
d�dS�NrF)r$�context�_makefile_refs�_closedr2�	_keychain�
_keychain_dir�_client_cert_chainr%�_timeout�
settimeout)�selfr$rrr�__init__HszWrappedSocket.__init__ccs4d|_dV|jdk	r0|jd}|_|��|�dS)a]
        A context manager that can be used to wrap calls that do I/O from
        SecureTransport. If any of the I/O callbacks hit an exception, this
        context manager will correctly propagate the exception after the fact.
        This avoids silently swallowing those exceptions.

        It also correctly forces the socket closed.
        N)r2�close)rKZ	exceptionrrr�_raise_on_errorZs

zWrappedSocket._raise_on_errorcCs2tjtt�t�}t�|j|tt��}t|�dS)a4
        Sets up the allowed ciphers. By default this matches the set in
        util.ssl_.DEFAULT_CIPHERS, at least as supported by macOS. This is done
        custom and doesn't allow changing at this time, mostly because parsing
        OpenSSL cipher strings is going to be a freaking nightmare.
        N)rZSSLCipherSuite�len�
CIPHER_SUITESZSSLSetEnabledCiphersrCr	)rK�ciphers�resultrrr�_set_ciphersos�zWrappedSocket._set_ciphersc		Cs|sdStj�|�r2t|d��}|��}W5QRXd}t��}z�t	|�}t�
|jt�
|��}t|�|srt�d��t�||�}t|�t�|d�}t|�t��}t�|t�
|��}t|�W5|r�t�|�|dk	r�t�|�Xtjtjf}|j|k�r
t�d|j��dS)z�
        Called when we have set custom validation. We do this in two cases:
        first, when cert validation is entirely disabled; and second, when
        using a custom trust DB.
        N�rbzFailed to copy trust referenceTz)certificate verify failed, error code: %d)�os�path�isfile�open�readr�SecTrustRefr�	CFReleaser
�SSLCopyPeerTrustrCr)�byrefr	�ssl�SSLErrorZSecTrustSetAnchorCertificatesZ!SecTrustSetAnchorCertificatesOnlyZSecTrustResultTypeZSecTrustEvaluaterZkSecTrustResultUnspecifiedZkSecTrustResultProceed�value)	rK�verify�trust_bundle�fZ
cert_array�trustrRZtrust_resultZ	successesrrr�_custom_validate|s>

��zWrappedSocket._custom_validatec		Cs�t�dtjtj�|_t�|jtt�}	t	|	�t
�0t|�d}
|
tkrT|
dd}
q>|t|
<W5QRXt�
|j|
�}	t	|	�|r�t|t�s�|�d�}t�|j|t|��}	t	|	�|��t�|j|�}	t	|	�t�|j|�}	|	dkr�|tjkr�t�|jtj�}	t	|	�|�r|dk	�r0t�|jtjd�}	t	|	�|�rlt�\|_|_t|j||�|_t�|j|j�}	t	|	�|� ��ht�!|j�}	|	tj"k�r�t#�$d��n>|	tj%k�r�|�&||�W5QR��qlnt	|	�W5QR��q�W5QRX�qldS)z�
        Actually performs the TLS handshake. This is run automatically by
        wrapped socket, and shouldn't be needed in user code.
        Ni���rzutf-8rTzhandshake timed out)'rZSSLCreateContextrZkSSLClientSideZkSSLStreamTyperCZ
SSLSetIOFuncs�_read_callback_pointer�_write_callback_pointerr	�_connection_ref_lock�idr!ZSSLSetConnection�
isinstance�bytes�encodeZSSLSetPeerDomainNamerOrSZSSLSetProtocolVersionMinZSSLSetProtocolVersionMax�kTLSProtocolMaxSupported�kTLSProtocol12ZSSLSetSessionOptionZ"kSSLSessionOptionBreakOnServerAuthrrFrGrrHZSSLSetCertificaterNZSSLHandshaker0r$r8ZerrSSLServerAuthCompletedre)rK�server_hostnamerarbZmin_versionZmax_versionZclient_certZ
client_keyZclient_key_passphraserRZhandlerrr�	handshake�s|��

����
zWrappedSocket.handshakecCs
|j��S�N)r$�fileno�rKrrrrrszWrappedSocket.filenocCs*|jdkr|jd8_|jr&|��dS)Nrr)rDrErMrsrrr�_decref_socketioss
zWrappedSocket._decref_socketioscCs&t�|�}|�||�}|d|�}|Srq)r)Zcreate_string_bufferr+)rKZbufsizr9Z
bytes_readr>rrr�recv s
zWrappedSocket.recvNc	Cs�|jr
dS|dkrt|�}tj|�|�}t�d�}|���t�|j	||t�
|��}W5QRX|tjkr�|j
dkr�t�d��n"|tjtjfkr�|��nt|�|j
S)Nrzrecv timed out)rErOr)r*Zfrom_buffer�c_size_trNrZSSLReadrCr]rr0r`r$r8r,ZerrSSLClosedNoNotifyrMr	)rKr9�nbytes�processed_bytesrRrrrr+&s.

�

�
zWrappedSocket.recv_intocCs
||_dSrq�rI)rKr8rrrrJQszWrappedSocket.settimeoutcCs|jSrqryrsrrrr%TszWrappedSocket.gettimeoutc	Csht�d�}|���"t�|j|t|�t�|��}W5QRX|tj	krZ|j
dkrZt�d��nt
|�|j
S)Nrzsend timed out)r)rvrNrZSSLWriterCrOr]rr0r`r$r8r	)rKr>rxrRrrrr=Ws

�zWrappedSocket.sendcCs4d}|t|�kr0|�|||t��}||7}qdS�Nr)rOr=�SSL_WRITE_BLOCKSIZE)rKr>Z
total_sentr?rrr�sendallhszWrappedSocket.sendallc	Cs$|���t�|j�W5QRXdSrq)rNrZSSLCloserCrsrrr�shutdownns
zWrappedSocket.shutdowncCs�|jdkr�d|_|jr(t�|j�d|_|jr@t�|j�d|_|jrvt�|j�t�|j�t	�
|j�d|_|_|j�
�S|jd8_dS)NrT)rDrErCrr[rHrFrZSecKeychainDelete�shutilZrmtreerGr$rMrsrrrrMrs

zWrappedSocket.closeFc
	Cs�|std��t��}d}d}z�t�|jt�|��}t	|�|sFW�ddSt�
|�}|s\W�NdSt�|d�}|spt�t�
|�}|s�t�t�|�}t�|�}	t�|	|�}W5|r�t�|�|r�t�|�X|S)Nz2SecureTransport only supports dumping binary certsr)�
ValueErrorrrZrr[r\rCr)r]r	ZSecTrustGetCertificateCountZSecTrustGetCertificateAtIndex�AssertionErrorZSecCertificateCopyDataZCFDataGetLengthZCFDataGetBytePtrr<)
rKZbinary_formrdZcertdataZ	der_bytesrRZ
cert_countZleafZdata_lengthr4rrr�getpeercert�s2




zWrappedSocket.getpeercertcCs�t��}t�|jt�|��}t|�|jtj	kr4dS|jtj
krDdS|jtjkrTdS|jtjkrddS|jtj
krtdS|jtjkr�dSt�d|��dS)NzTLSv1.3zTLSv1.2zTLSv1.1ZTLSv1ZSSLv3ZSSLv2zUnknown TLS version: %r)rZSSLProtocolZSSLGetNegotiatedProtocolVersionrCr)r]r	r`rZkTLSProtocol13rn�kTLSProtocol11�
kTLSProtocol1�
kSSLProtocol3�
kSSLProtocol2r^r_)rK�protocolrRrrr�version�s&�zWrappedSocket.versioncCs|jd7_dS�Nr)rDrsrrr�_reuse�szWrappedSocket._reusecCs&|jdkr|��n|jd8_dSr�)rDrMrsrrr�_drop�s

zWrappedSocket._drop)N)F)�__name__�
__module__�__qualname__�__doc__rL�
contextlib�contextmanagerrNrSrerprrrtrur+rJr%r=r|r}rMr�r�r�r�rrrrrA@s*

9a
+
:rA���cCs|jd7_t|||dd�S)NrT)rM)rDr
)rK�mode�bufsizerrr�makefile�sr��rcOsd}t|||f|�|�Srzr)rKr��	buffering�args�kwargsrrrr��sc@s�eZdZdZdd�Zedd��Zejdd��Zedd��Zejd	d��Zed
d��Z	e	jdd��Z	d
d�Z
dd�Zdd�Zddd�Z
ddd�Zddd�ZdS)rz�
    I am a wrapper class for the SecureTransport library, to translate the
    interface of the standard library ``SSLContext`` object to calls into
    SecureTransport.
    cCs8t|\|_|_d|_d|_d|_d|_d|_d|_dSrB)	�_protocol_to_min_max�_min_version�_max_version�_options�_verify�
_trust_bundle�_client_cert�_client_key�_client_key_passphrase)rKr�rrrrL�szSecureTransportContext.__init__cCsdS)��
        SecureTransport cannot have its hostname checking disabled. For more,
        see the comment on getpeercert() in this file.
        Trrsrrr�check_hostnamesz%SecureTransportContext.check_hostnamecCsdS)r�Nr�rKr`rrrr�	scCs|jSrq�r�rsrrr�optionsszSecureTransportContext.optionscCs
||_dSrqr�r�rrrr�scCs|jrtjStjSrq)r�r^�
CERT_REQUIREDZ	CERT_NONErsrrr�verify_mode sz"SecureTransportContext.verify_modecCs|tjkrdnd|_dS)NTF)r^r�r�r�rrrr�$scCsdSrqrrsrrr�set_default_verify_paths(s
z/SecureTransportContext.set_default_verify_pathscCs|��Srq)r�rsrrr�load_default_certs4sz)SecureTransportContext.load_default_certscCs|tjjkrtd��dS)Nz5SecureTransport doesn't support custom cipher strings)rrZDEFAULT_CIPHERSr)rKrQrrr�set_ciphers7sz"SecureTransportContext.set_ciphersNcCs|dk	rtd��|p||_dS)Nz1SecureTransport does not support cert directories)rr�)rKZcafileZcapathZcadatarrr�load_verify_locations<sz,SecureTransportContext.load_verify_locationscCs||_||_||_dSrq)r�r�Z_client_cert_passphrase)rKZcertfileZkeyfileZpasswordrrr�load_cert_chainCsz&SecureTransportContext.load_cert_chainFTc
CsJ|rt�|st�|st�t|�}|�||j|j|j|j|j|j|j	�|Srq)
r�rArpr�r�r�r�r�r�r�)rKZsockZserver_sideZdo_handshake_on_connectZsuppress_ragged_eofsror6rrr�wrap_socketHs�
z"SecureTransportContext.wrap_socket)NNN)NN)FTTN)r�r�r�r�rL�propertyr��setterr�r�r�r�r�r�r�r�rrrrr�s0	


	




�r)r�)r�N)`r�Z
__future__rr�r)r'Zos.pathrUr~r$r^Z	threading�weakref�rZ_securetransport.bindingsrrrZ_securetransport.low_levelr	r
rrr
�ImportErrorZpackages.backports.makefiler�__all__rrrrrZWeakValueDictionaryr!ZLockrhr{Z'TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384Z'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256Z%TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384Z%TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256Z-TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256Z+TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256Z#TLS_DHE_RSA_WITH_AES_256_GCM_SHA384Z#TLS_DHE_RSA_WITH_AES_128_GCM_SHA256Z'TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384Z$TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHAZ'TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256Z$TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHAZ%TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384Z"TLS_ECDHE_RSA_WITH_AES_256_CBC_SHAZ%TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256Z"TLS_ECDHE_RSA_WITH_AES_128_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_256_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_256_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_128_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_128_CBC_SHAZTLS_AES_256_GCM_SHA384ZTLS_AES_128_GCM_SHA256ZTLS_RSA_WITH_AES_256_GCM_SHA384ZTLS_RSA_WITH_AES_128_GCM_SHA256ZTLS_AES_128_CCM_8_SHA256ZTLS_AES_128_CCM_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHA256ZTLS_RSA_WITH_AES_128_CBC_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHAZTLS_RSA_WITH_AES_128_CBC_SHArPZPROTOCOL_TLSr�rmr��hasattrr�rr�rrr�rrnrrrr;r@ZSSLReadFuncrfZSSLWriteFuncrg�objectrAr�rrrrr�<module>s�3�%���
�
�
�
�
76

!
site-packages/pip/_vendor/urllib3/contrib/__pycache__/ntlmpool.cpython-38.opt-1.pyc000064400000006260151446177000024200 0ustar00U

��.ei�@s\dZddlmZddlmZddlmZddlmZddlm	Z	ee
�ZGdd	�d	e�Zd
S)z
NTLM authenticating pool, contributed by erikcederstran

Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
�)�absolute_import)�	getLogger)�ntlm�)�HTTPSConnectionPool)�HTTPSConnectioncs:eZdZdZdZ�fdd�Zdd�Zd�fd
d�	Z�ZS)
�NTLMConnectionPoolzQ
    Implements an NTLM authentication version of an urllib3 connection pool
    ZhttpscsLtt|�j||�||_||_|�dd�}|d��|_|d|_||_	dS)z�
        authurl is a random URL on the server that is protected by NTLM.
        user is the Windows user, probably in the DOMAIN\username format.
        pw is the password for the user.
        �\�rN)
�superr�__init__�authurl�rawuser�split�upper�domain�user�pw)�selfrrr
�args�kwargsZ
user_parts��	__class__��H/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/ntlmpool.pyrs
zNTLMConnectionPool.__init__c
Cs�|jd7_t�d|j|j|j�ddi}d}d}t|j|jd�}dt�|j	�||<t�d	|�|�
d
|jd|�|��}t|�
��}t�d|j|j�t�d|�t�d
|�d��d|_||�d�}d}|D] }	|	dd�dkr�|	dd�}q�|dk�rtd|||f��t�|�\}
}t�|
|j|j|j|�}d|||<t�d	|�|�
d
|jd|�|��}t�d|j|j�t�dt|�
���t�d
|��dd��|jdk�r�|jdk�r�td��td|j|jf��d|_t�d�|S)Nr
z3Starting NTLM HTTPS connection no. %d: https://%s%s�
Connection�
Keep-AliveZ
Authorizationzwww-authenticate)�host�portzNTLM %szRequest headers: %sZGETzResponse status: %s %szResponse headers: %szResponse data: %s [...]�dz, �zNTLM z!Unexpected %s response header: %s��i�z3Server rejected request: wrong username or passwordzWrong server response: %s %szConnection established)Znum_connections�log�debugrr
rrrZcreate_NTLM_NEGOTIATE_MESSAGErZrequestZgetresponse�dictZ
getheadersZstatus�reason�read�fpr�	ExceptionZparse_NTLM_CHALLENGE_MESSAGEZ create_NTLM_AUTHENTICATE_MESSAGErrr)
r�headersZ
req_headerZresp_headerZconn�resZreshdrZauth_header_valuesZauth_header_value�sZServerChallengeZNegotiateFlagsZauth_msgrrr�	_new_conn'sr��

����
zNTLMConnectionPool._new_connN�Tc	s0|dkri}d|d<tt|��|||||||�S)Nrr)rr�urlopen)r�methodZurlZbodyr)ZretriesZredirectZassert_same_hostrrrr.ls

�zNTLMConnectionPool.urlopen)NNr-TT)	�__name__�
__module__�__qualname__�__doc__Zschemerr,r.�
__classcell__rrrrrsI�rN)
r3Z
__future__rZloggingrr�rZpackages.six.moves.http_clientrr0r"rrrrr�<module>ssite-packages/pip/_vendor/urllib3/contrib/__pycache__/__init__.cpython-38.pyc000064400000000243151446177000023127 0ustar00U

��.e�@sdS)N�rrr�H/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/__init__.py�<module>�site-packages/pip/_vendor/urllib3/contrib/appengine.py000064400000026062151446177000017057 0ustar00"""
This module provides a pool manager that uses Google App Engine's
`URLFetch Service <https://cloud.google.com/appengine/docs/python/urlfetch>`_.

Example usage::

    from pip._vendor.urllib3 import PoolManager
    from pip._vendor.urllib3.contrib.appengine import AppEngineManager, is_appengine_sandbox

    if is_appengine_sandbox():
        # AppEngineManager uses AppEngine's URLFetch API behind the scenes
        http = AppEngineManager()
    else:
        # PoolManager uses a socket-level API behind the scenes
        http = PoolManager()

    r = http.request('GET', 'https://google.com/')

There are `limitations <https://cloud.google.com/appengine/docs/python/\
urlfetch/#Python_Quotas_and_limits>`_ to the URLFetch service and it may not be
the best choice for your application. There are three options for using
urllib3 on Google App Engine:

1. You can use :class:`AppEngineManager` with URLFetch. URLFetch is
   cost-effective in many circumstances as long as your usage is within the
   limitations.
2. You can use a normal :class:`~urllib3.PoolManager` by enabling sockets.
   Sockets also have `limitations and restrictions
   <https://cloud.google.com/appengine/docs/python/sockets/\
   #limitations-and-restrictions>`_ and have a lower free quota than URLFetch.
   To use sockets, be sure to specify the following in your ``app.yaml``::

        env_variables:
            GAE_USE_SOCKETS_HTTPLIB : 'true'

3. If you are using `App Engine Flexible
<https://cloud.google.com/appengine/docs/flexible/>`_, you can use the standard
:class:`PoolManager` without any configuration or special environment variables.
"""

from __future__ import absolute_import
import io
import logging
import warnings
from ..packages.six.moves.urllib.parse import urljoin

from ..exceptions import (
    HTTPError,
    HTTPWarning,
    MaxRetryError,
    ProtocolError,
    TimeoutError,
    SSLError,
)

from ..request import RequestMethods
from ..response import HTTPResponse
from ..util.timeout import Timeout
from ..util.retry import Retry
from . import _appengine_environ

try:
    from google.appengine.api import urlfetch
except ImportError:
    urlfetch = None


log = logging.getLogger(__name__)


class AppEnginePlatformWarning(HTTPWarning):
    pass


class AppEnginePlatformError(HTTPError):
    pass


class AppEngineManager(RequestMethods):
    """
    Connection manager for Google App Engine sandbox applications.

    This manager uses the URLFetch service directly instead of using the
    emulated httplib, and is subject to URLFetch limitations as described in
    the App Engine documentation `here
    <https://cloud.google.com/appengine/docs/python/urlfetch>`_.

    Notably it will raise an :class:`AppEnginePlatformError` if:
        * URLFetch is not available.
        * If you attempt to use this on App Engine Flexible, as full socket
          support is available.
        * If a request size is more than 10 megabytes.
        * If a response size is more than 32 megabtyes.
        * If you use an unsupported request method such as OPTIONS.

    Beyond those cases, it will raise normal urllib3 errors.
    """

    def __init__(
        self,
        headers=None,
        retries=None,
        validate_certificate=True,
        urlfetch_retries=True,
    ):
        if not urlfetch:
            raise AppEnginePlatformError(
                "URLFetch is not available in this environment."
            )

        if is_prod_appengine_mvms():
            raise AppEnginePlatformError(
                "Use normal urllib3.PoolManager instead of AppEngineManager"
                "on Managed VMs, as using URLFetch is not necessary in "
                "this environment."
            )

        warnings.warn(
            "urllib3 is using URLFetch on Google App Engine sandbox instead "
            "of sockets. To use sockets directly instead of URLFetch see "
            "https://urllib3.readthedocs.io/en/latest/reference/urllib3.contrib.html.",
            AppEnginePlatformWarning,
        )

        RequestMethods.__init__(self, headers)
        self.validate_certificate = validate_certificate
        self.urlfetch_retries = urlfetch_retries

        self.retries = retries or Retry.DEFAULT

    def __enter__(self):
        return self

    def __exit__(self, exc_type, exc_val, exc_tb):
        # Return False to re-raise any potential exceptions
        return False

    def urlopen(
        self,
        method,
        url,
        body=None,
        headers=None,
        retries=None,
        redirect=True,
        timeout=Timeout.DEFAULT_TIMEOUT,
        **response_kw
    ):

        retries = self._get_retries(retries, redirect)

        try:
            follow_redirects = redirect and retries.redirect != 0 and retries.total
            response = urlfetch.fetch(
                url,
                payload=body,
                method=method,
                headers=headers or {},
                allow_truncated=False,
                follow_redirects=self.urlfetch_retries and follow_redirects,
                deadline=self._get_absolute_timeout(timeout),
                validate_certificate=self.validate_certificate,
            )
        except urlfetch.DeadlineExceededError as e:
            raise TimeoutError(self, e)

        except urlfetch.InvalidURLError as e:
            if "too large" in str(e):
                raise AppEnginePlatformError(
                    "URLFetch request too large, URLFetch only "
                    "supports requests up to 10mb in size.",
                    e,
                )
            raise ProtocolError(e)

        except urlfetch.DownloadError as e:
            if "Too many redirects" in str(e):
                raise MaxRetryError(self, url, reason=e)
            raise ProtocolError(e)

        except urlfetch.ResponseTooLargeError as e:
            raise AppEnginePlatformError(
                "URLFetch response too large, URLFetch only supports"
                "responses up to 32mb in size.",
                e,
            )

        except urlfetch.SSLCertificateError as e:
            raise SSLError(e)

        except urlfetch.InvalidMethodError as e:
            raise AppEnginePlatformError(
                "URLFetch does not support method: %s" % method, e
            )

        http_response = self._urlfetch_response_to_http_response(
            response, retries=retries, **response_kw
        )

        # Handle redirect?
        redirect_location = redirect and http_response.get_redirect_location()
        if redirect_location:
            # Check for redirect response
            if self.urlfetch_retries and retries.raise_on_redirect:
                raise MaxRetryError(self, url, "too many redirects")
            else:
                if http_response.status == 303:
                    method = "GET"

                try:
                    retries = retries.increment(
                        method, url, response=http_response, _pool=self
                    )
                except MaxRetryError:
                    if retries.raise_on_redirect:
                        raise MaxRetryError(self, url, "too many redirects")
                    return http_response

                retries.sleep_for_retry(http_response)
                log.debug("Redirecting %s -> %s", url, redirect_location)
                redirect_url = urljoin(url, redirect_location)
                return self.urlopen(
                    method,
                    redirect_url,
                    body,
                    headers,
                    retries=retries,
                    redirect=redirect,
                    timeout=timeout,
                    **response_kw
                )

        # Check if we should retry the HTTP response.
        has_retry_after = bool(http_response.getheader("Retry-After"))
        if retries.is_retry(method, http_response.status, has_retry_after):
            retries = retries.increment(method, url, response=http_response, _pool=self)
            log.debug("Retry: %s", url)
            retries.sleep(http_response)
            return self.urlopen(
                method,
                url,
                body=body,
                headers=headers,
                retries=retries,
                redirect=redirect,
                timeout=timeout,
                **response_kw
            )

        return http_response

    def _urlfetch_response_to_http_response(self, urlfetch_resp, **response_kw):

        if is_prod_appengine():
            # Production GAE handles deflate encoding automatically, but does
            # not remove the encoding header.
            content_encoding = urlfetch_resp.headers.get("content-encoding")

            if content_encoding == "deflate":
                del urlfetch_resp.headers["content-encoding"]

        transfer_encoding = urlfetch_resp.headers.get("transfer-encoding")
        # We have a full response's content,
        # so let's make sure we don't report ourselves as chunked data.
        if transfer_encoding == "chunked":
            encodings = transfer_encoding.split(",")
            encodings.remove("chunked")
            urlfetch_resp.headers["transfer-encoding"] = ",".join(encodings)

        original_response = HTTPResponse(
            # In order for decoding to work, we must present the content as
            # a file-like object.
            body=io.BytesIO(urlfetch_resp.content),
            msg=urlfetch_resp.header_msg,
            headers=urlfetch_resp.headers,
            status=urlfetch_resp.status_code,
            **response_kw
        )

        return HTTPResponse(
            body=io.BytesIO(urlfetch_resp.content),
            headers=urlfetch_resp.headers,
            status=urlfetch_resp.status_code,
            original_response=original_response,
            **response_kw
        )

    def _get_absolute_timeout(self, timeout):
        if timeout is Timeout.DEFAULT_TIMEOUT:
            return None  # Defer to URLFetch's default.
        if isinstance(timeout, Timeout):
            if timeout._read is not None or timeout._connect is not None:
                warnings.warn(
                    "URLFetch does not support granular timeout settings, "
                    "reverting to total or default URLFetch timeout.",
                    AppEnginePlatformWarning,
                )
            return timeout.total
        return timeout

    def _get_retries(self, retries, redirect):
        if not isinstance(retries, Retry):
            retries = Retry.from_int(retries, redirect=redirect, default=self.retries)

        if retries.connect or retries.read or retries.redirect:
            warnings.warn(
                "URLFetch only supports total retries and does not "
                "recognize connect, read, or redirect retry parameters.",
                AppEnginePlatformWarning,
            )

        return retries


# Alias methods from _appengine_environ to maintain public API interface.

is_appengine = _appengine_environ.is_appengine
is_appengine_sandbox = _appengine_environ.is_appengine_sandbox
is_local_appengine = _appengine_environ.is_local_appengine
is_prod_appengine = _appengine_environ.is_prod_appengine
is_prod_appengine_mvms = _appengine_environ.is_prod_appengine_mvms
site-packages/pip/_vendor/urllib3/contrib/__init__.py000064400000000000151446177000016630 0ustar00site-packages/pip/_vendor/urllib3/contrib/socks.py000064400000015574151446177000016241 0ustar00# -*- coding: utf-8 -*-
"""
This module contains provisional support for SOCKS proxies from within
urllib3. This module supports SOCKS4, SOCKS4A (an extension of SOCKS4), and
SOCKS5. To enable its functionality, either install PySocks or install this
module with the ``socks`` extra.

The SOCKS implementation supports the full range of urllib3 features. It also
supports the following SOCKS features:

- SOCKS4A (``proxy_url='socks4a://...``)
- SOCKS4 (``proxy_url='socks4://...``)
- SOCKS5 with remote DNS (``proxy_url='socks5h://...``)
- SOCKS5 with local DNS (``proxy_url='socks5://...``)
- Usernames and passwords for the SOCKS proxy

 .. note::
    It is recommended to use ``socks5h://`` or ``socks4a://`` schemes in
    your ``proxy_url`` to ensure that DNS resolution is done from the remote
    server instead of client-side when connecting to a domain name.

SOCKS4 supports IPv4 and domain names with the SOCKS4A extension. SOCKS5
supports IPv4, IPv6, and domain names.

When connecting to a SOCKS4 proxy the ``username`` portion of the ``proxy_url``
will be sent as the ``userid`` section of the SOCKS request::

    proxy_url="socks4a://<userid>@proxy-host"

When connecting to a SOCKS5 proxy the ``username`` and ``password`` portion
of the ``proxy_url`` will be sent as the username/password to authenticate
with the proxy::

    proxy_url="socks5h://<username>:<password>@proxy-host"

"""
from __future__ import absolute_import

try:
    import socks
except ImportError:
    import warnings
    from ..exceptions import DependencyWarning

    warnings.warn(
        (
            "SOCKS support in urllib3 requires the installation of optional "
            "dependencies: specifically, PySocks.  For more information, see "
            "https://urllib3.readthedocs.io/en/latest/contrib.html#socks-proxies"
        ),
        DependencyWarning,
    )
    raise

from socket import error as SocketError, timeout as SocketTimeout

from ..connection import HTTPConnection, HTTPSConnection
from ..connectionpool import HTTPConnectionPool, HTTPSConnectionPool
from ..exceptions import ConnectTimeoutError, NewConnectionError
from ..poolmanager import PoolManager
from ..util.url import parse_url

try:
    import ssl
except ImportError:
    ssl = None


class SOCKSConnection(HTTPConnection):
    """
    A plain-text HTTP connection that connects via a SOCKS proxy.
    """

    def __init__(self, *args, **kwargs):
        self._socks_options = kwargs.pop("_socks_options")
        super(SOCKSConnection, self).__init__(*args, **kwargs)

    def _new_conn(self):
        """
        Establish a new connection via the SOCKS proxy.
        """
        extra_kw = {}
        if self.source_address:
            extra_kw["source_address"] = self.source_address

        if self.socket_options:
            extra_kw["socket_options"] = self.socket_options

        try:
            conn = socks.create_connection(
                (self.host, self.port),
                proxy_type=self._socks_options["socks_version"],
                proxy_addr=self._socks_options["proxy_host"],
                proxy_port=self._socks_options["proxy_port"],
                proxy_username=self._socks_options["username"],
                proxy_password=self._socks_options["password"],
                proxy_rdns=self._socks_options["rdns"],
                timeout=self.timeout,
                **extra_kw
            )

        except SocketTimeout:
            raise ConnectTimeoutError(
                self,
                "Connection to %s timed out. (connect timeout=%s)"
                % (self.host, self.timeout),
            )

        except socks.ProxyError as e:
            # This is fragile as hell, but it seems to be the only way to raise
            # useful errors here.
            if e.socket_err:
                error = e.socket_err
                if isinstance(error, SocketTimeout):
                    raise ConnectTimeoutError(
                        self,
                        "Connection to %s timed out. (connect timeout=%s)"
                        % (self.host, self.timeout),
                    )
                else:
                    raise NewConnectionError(
                        self, "Failed to establish a new connection: %s" % error
                    )
            else:
                raise NewConnectionError(
                    self, "Failed to establish a new connection: %s" % e
                )

        except SocketError as e:  # Defensive: PySocks should catch all these.
            raise NewConnectionError(
                self, "Failed to establish a new connection: %s" % e
            )

        return conn


# We don't need to duplicate the Verified/Unverified distinction from
# urllib3/connection.py here because the HTTPSConnection will already have been
# correctly set to either the Verified or Unverified form by that module. This
# means the SOCKSHTTPSConnection will automatically be the correct type.
class SOCKSHTTPSConnection(SOCKSConnection, HTTPSConnection):
    pass


class SOCKSHTTPConnectionPool(HTTPConnectionPool):
    ConnectionCls = SOCKSConnection


class SOCKSHTTPSConnectionPool(HTTPSConnectionPool):
    ConnectionCls = SOCKSHTTPSConnection


class SOCKSProxyManager(PoolManager):
    """
    A version of the urllib3 ProxyManager that routes connections via the
    defined SOCKS proxy.
    """

    pool_classes_by_scheme = {
        "http": SOCKSHTTPConnectionPool,
        "https": SOCKSHTTPSConnectionPool,
    }

    def __init__(
        self,
        proxy_url,
        username=None,
        password=None,
        num_pools=10,
        headers=None,
        **connection_pool_kw
    ):
        parsed = parse_url(proxy_url)

        if username is None and password is None and parsed.auth is not None:
            split = parsed.auth.split(":")
            if len(split) == 2:
                username, password = split
        if parsed.scheme == "socks5":
            socks_version = socks.PROXY_TYPE_SOCKS5
            rdns = False
        elif parsed.scheme == "socks5h":
            socks_version = socks.PROXY_TYPE_SOCKS5
            rdns = True
        elif parsed.scheme == "socks4":
            socks_version = socks.PROXY_TYPE_SOCKS4
            rdns = False
        elif parsed.scheme == "socks4a":
            socks_version = socks.PROXY_TYPE_SOCKS4
            rdns = True
        else:
            raise ValueError("Unable to determine SOCKS version from %s" % proxy_url)

        self.proxy_url = proxy_url

        socks_options = {
            "socks_version": socks_version,
            "proxy_host": parsed.host,
            "proxy_port": parsed.port,
            "username": username,
            "password": password,
            "rdns": rdns,
        }
        connection_pool_kw["_socks_options"] = socks_options

        super(SOCKSProxyManager, self).__init__(
            num_pools, headers, **connection_pool_kw
        )

        self.pool_classes_by_scheme = SOCKSProxyManager.pool_classes_by_scheme
site-packages/pip/_vendor/urllib3/contrib/ntlmpool.py000064400000010151151446177000016745 0ustar00"""
NTLM authenticating pool, contributed by erikcederstran

Issue #10, see: http://code.google.com/p/urllib3/issues/detail?id=10
"""
from __future__ import absolute_import

from logging import getLogger
from ntlm import ntlm

from .. import HTTPSConnectionPool
from ..packages.six.moves.http_client import HTTPSConnection


log = getLogger(__name__)


class NTLMConnectionPool(HTTPSConnectionPool):
    """
    Implements an NTLM authentication version of an urllib3 connection pool
    """

    scheme = "https"

    def __init__(self, user, pw, authurl, *args, **kwargs):
        """
        authurl is a random URL on the server that is protected by NTLM.
        user is the Windows user, probably in the DOMAIN\\username format.
        pw is the password for the user.
        """
        super(NTLMConnectionPool, self).__init__(*args, **kwargs)
        self.authurl = authurl
        self.rawuser = user
        user_parts = user.split("\\", 1)
        self.domain = user_parts[0].upper()
        self.user = user_parts[1]
        self.pw = pw

    def _new_conn(self):
        # Performs the NTLM handshake that secures the connection. The socket
        # must be kept open while requests are performed.
        self.num_connections += 1
        log.debug(
            "Starting NTLM HTTPS connection no. %d: https://%s%s",
            self.num_connections,
            self.host,
            self.authurl,
        )

        headers = {"Connection": "Keep-Alive"}
        req_header = "Authorization"
        resp_header = "www-authenticate"

        conn = HTTPSConnection(host=self.host, port=self.port)

        # Send negotiation message
        headers[req_header] = "NTLM %s" % ntlm.create_NTLM_NEGOTIATE_MESSAGE(
            self.rawuser
        )
        log.debug("Request headers: %s", headers)
        conn.request("GET", self.authurl, None, headers)
        res = conn.getresponse()
        reshdr = dict(res.getheaders())
        log.debug("Response status: %s %s", res.status, res.reason)
        log.debug("Response headers: %s", reshdr)
        log.debug("Response data: %s [...]", res.read(100))

        # Remove the reference to the socket, so that it can not be closed by
        # the response object (we want to keep the socket open)
        res.fp = None

        # Server should respond with a challenge message
        auth_header_values = reshdr[resp_header].split(", ")
        auth_header_value = None
        for s in auth_header_values:
            if s[:5] == "NTLM ":
                auth_header_value = s[5:]
        if auth_header_value is None:
            raise Exception(
                "Unexpected %s response header: %s" % (resp_header, reshdr[resp_header])
            )

        # Send authentication message
        ServerChallenge, NegotiateFlags = ntlm.parse_NTLM_CHALLENGE_MESSAGE(
            auth_header_value
        )
        auth_msg = ntlm.create_NTLM_AUTHENTICATE_MESSAGE(
            ServerChallenge, self.user, self.domain, self.pw, NegotiateFlags
        )
        headers[req_header] = "NTLM %s" % auth_msg
        log.debug("Request headers: %s", headers)
        conn.request("GET", self.authurl, None, headers)
        res = conn.getresponse()
        log.debug("Response status: %s %s", res.status, res.reason)
        log.debug("Response headers: %s", dict(res.getheaders()))
        log.debug("Response data: %s [...]", res.read()[:100])
        if res.status != 200:
            if res.status == 401:
                raise Exception(
                    "Server rejected request: wrong " "username or password"
                )
            raise Exception("Wrong server response: %s %s" % (res.status, res.reason))

        res.fp = None
        log.debug("Connection established")
        return conn

    def urlopen(
        self,
        method,
        url,
        body=None,
        headers=None,
        retries=3,
        redirect=True,
        assert_same_host=True,
    ):
        if headers is None:
            headers = {}
        headers["Connection"] = "Keep-Alive"
        return super(NTLMConnectionPool, self).urlopen(
            method, url, body, headers, retries, redirect, assert_same_host
        )
site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py000064400000027264151446177000022510 0ustar00"""
Low-level helpers for the SecureTransport bindings.

These are Python functions that are not directly related to the high-level APIs
but are necessary to get them to work. They include a whole bunch of low-level
CoreFoundation messing about and memory management. The concerns in this module
are almost entirely about trying to avoid memory leaks and providing
appropriate and useful assistance to the higher-level code.
"""
import base64
import ctypes
import itertools
import re
import os
import ssl
import tempfile

from .bindings import Security, CoreFoundation, CFConst


# This regular expression is used to grab PEM data out of a PEM bundle.
_PEM_CERTS_RE = re.compile(
    b"-----BEGIN CERTIFICATE-----\n(.*?)\n-----END CERTIFICATE-----", re.DOTALL
)


def _cf_data_from_bytes(bytestring):
    """
    Given a bytestring, create a CFData object from it. This CFData object must
    be CFReleased by the caller.
    """
    return CoreFoundation.CFDataCreate(
        CoreFoundation.kCFAllocatorDefault, bytestring, len(bytestring)
    )


def _cf_dictionary_from_tuples(tuples):
    """
    Given a list of Python tuples, create an associated CFDictionary.
    """
    dictionary_size = len(tuples)

    # We need to get the dictionary keys and values out in the same order.
    keys = (t[0] for t in tuples)
    values = (t[1] for t in tuples)
    cf_keys = (CoreFoundation.CFTypeRef * dictionary_size)(*keys)
    cf_values = (CoreFoundation.CFTypeRef * dictionary_size)(*values)

    return CoreFoundation.CFDictionaryCreate(
        CoreFoundation.kCFAllocatorDefault,
        cf_keys,
        cf_values,
        dictionary_size,
        CoreFoundation.kCFTypeDictionaryKeyCallBacks,
        CoreFoundation.kCFTypeDictionaryValueCallBacks,
    )


def _cf_string_to_unicode(value):
    """
    Creates a Unicode string from a CFString object. Used entirely for error
    reporting.

    Yes, it annoys me quite a lot that this function is this complex.
    """
    value_as_void_p = ctypes.cast(value, ctypes.POINTER(ctypes.c_void_p))

    string = CoreFoundation.CFStringGetCStringPtr(
        value_as_void_p, CFConst.kCFStringEncodingUTF8
    )
    if string is None:
        buffer = ctypes.create_string_buffer(1024)
        result = CoreFoundation.CFStringGetCString(
            value_as_void_p, buffer, 1024, CFConst.kCFStringEncodingUTF8
        )
        if not result:
            raise OSError("Error copying C string from CFStringRef")
        string = buffer.value
    if string is not None:
        string = string.decode("utf-8")
    return string


def _assert_no_error(error, exception_class=None):
    """
    Checks the return code and throws an exception if there is an error to
    report
    """
    if error == 0:
        return

    cf_error_string = Security.SecCopyErrorMessageString(error, None)
    output = _cf_string_to_unicode(cf_error_string)
    CoreFoundation.CFRelease(cf_error_string)

    if output is None or output == u"":
        output = u"OSStatus %s" % error

    if exception_class is None:
        exception_class = ssl.SSLError

    raise exception_class(output)


def _cert_array_from_pem(pem_bundle):
    """
    Given a bundle of certs in PEM format, turns them into a CFArray of certs
    that can be used to validate a cert chain.
    """
    # Normalize the PEM bundle's line endings.
    pem_bundle = pem_bundle.replace(b"\r\n", b"\n")

    der_certs = [
        base64.b64decode(match.group(1)) for match in _PEM_CERTS_RE.finditer(pem_bundle)
    ]
    if not der_certs:
        raise ssl.SSLError("No root certificates specified")

    cert_array = CoreFoundation.CFArrayCreateMutable(
        CoreFoundation.kCFAllocatorDefault,
        0,
        ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
    )
    if not cert_array:
        raise ssl.SSLError("Unable to allocate memory!")

    try:
        for der_bytes in der_certs:
            certdata = _cf_data_from_bytes(der_bytes)
            if not certdata:
                raise ssl.SSLError("Unable to allocate memory!")
            cert = Security.SecCertificateCreateWithData(
                CoreFoundation.kCFAllocatorDefault, certdata
            )
            CoreFoundation.CFRelease(certdata)
            if not cert:
                raise ssl.SSLError("Unable to build cert object!")

            CoreFoundation.CFArrayAppendValue(cert_array, cert)
            CoreFoundation.CFRelease(cert)
    except Exception:
        # We need to free the array before the exception bubbles further.
        # We only want to do that if an error occurs: otherwise, the caller
        # should free.
        CoreFoundation.CFRelease(cert_array)

    return cert_array


def _is_cert(item):
    """
    Returns True if a given CFTypeRef is a certificate.
    """
    expected = Security.SecCertificateGetTypeID()
    return CoreFoundation.CFGetTypeID(item) == expected


def _is_identity(item):
    """
    Returns True if a given CFTypeRef is an identity.
    """
    expected = Security.SecIdentityGetTypeID()
    return CoreFoundation.CFGetTypeID(item) == expected


def _temporary_keychain():
    """
    This function creates a temporary Mac keychain that we can use to work with
    credentials. This keychain uses a one-time password and a temporary file to
    store the data. We expect to have one keychain per socket. The returned
    SecKeychainRef must be freed by the caller, including calling
    SecKeychainDelete.

    Returns a tuple of the SecKeychainRef and the path to the temporary
    directory that contains it.
    """
    # Unfortunately, SecKeychainCreate requires a path to a keychain. This
    # means we cannot use mkstemp to use a generic temporary file. Instead,
    # we're going to create a temporary directory and a filename to use there.
    # This filename will be 8 random bytes expanded into base64. We also need
    # some random bytes to password-protect the keychain we're creating, so we
    # ask for 40 random bytes.
    random_bytes = os.urandom(40)
    filename = base64.b16encode(random_bytes[:8]).decode("utf-8")
    password = base64.b16encode(random_bytes[8:])  # Must be valid UTF-8
    tempdirectory = tempfile.mkdtemp()

    keychain_path = os.path.join(tempdirectory, filename).encode("utf-8")

    # We now want to create the keychain itself.
    keychain = Security.SecKeychainRef()
    status = Security.SecKeychainCreate(
        keychain_path, len(password), password, False, None, ctypes.byref(keychain)
    )
    _assert_no_error(status)

    # Having created the keychain, we want to pass it off to the caller.
    return keychain, tempdirectory


def _load_items_from_file(keychain, path):
    """
    Given a single file, loads all the trust objects from it into arrays and
    the keychain.
    Returns a tuple of lists: the first list is a list of identities, the
    second a list of certs.
    """
    certificates = []
    identities = []
    result_array = None

    with open(path, "rb") as f:
        raw_filedata = f.read()

    try:
        filedata = CoreFoundation.CFDataCreate(
            CoreFoundation.kCFAllocatorDefault, raw_filedata, len(raw_filedata)
        )
        result_array = CoreFoundation.CFArrayRef()
        result = Security.SecItemImport(
            filedata,  # cert data
            None,  # Filename, leaving it out for now
            None,  # What the type of the file is, we don't care
            None,  # what's in the file, we don't care
            0,  # import flags
            None,  # key params, can include passphrase in the future
            keychain,  # The keychain to insert into
            ctypes.byref(result_array),  # Results
        )
        _assert_no_error(result)

        # A CFArray is not very useful to us as an intermediary
        # representation, so we are going to extract the objects we want
        # and then free the array. We don't need to keep hold of keys: the
        # keychain already has them!
        result_count = CoreFoundation.CFArrayGetCount(result_array)
        for index in range(result_count):
            item = CoreFoundation.CFArrayGetValueAtIndex(result_array, index)
            item = ctypes.cast(item, CoreFoundation.CFTypeRef)

            if _is_cert(item):
                CoreFoundation.CFRetain(item)
                certificates.append(item)
            elif _is_identity(item):
                CoreFoundation.CFRetain(item)
                identities.append(item)
    finally:
        if result_array:
            CoreFoundation.CFRelease(result_array)

        CoreFoundation.CFRelease(filedata)

    return (identities, certificates)


def _load_client_cert_chain(keychain, *paths):
    """
    Load certificates and maybe keys from a number of files. Has the end goal
    of returning a CFArray containing one SecIdentityRef, and then zero or more
    SecCertificateRef objects, suitable for use as a client certificate trust
    chain.
    """
    # Ok, the strategy.
    #
    # This relies on knowing that macOS will not give you a SecIdentityRef
    # unless you have imported a key into a keychain. This is a somewhat
    # artificial limitation of macOS (for example, it doesn't necessarily
    # affect iOS), but there is nothing inside Security.framework that lets you
    # get a SecIdentityRef without having a key in a keychain.
    #
    # So the policy here is we take all the files and iterate them in order.
    # Each one will use SecItemImport to have one or more objects loaded from
    # it. We will also point at a keychain that macOS can use to work with the
    # private key.
    #
    # Once we have all the objects, we'll check what we actually have. If we
    # already have a SecIdentityRef in hand, fab: we'll use that. Otherwise,
    # we'll take the first certificate (which we assume to be our leaf) and
    # ask the keychain to give us a SecIdentityRef with that cert's associated
    # key.
    #
    # We'll then return a CFArray containing the trust chain: one
    # SecIdentityRef and then zero-or-more SecCertificateRef objects. The
    # responsibility for freeing this CFArray will be with the caller. This
    # CFArray must remain alive for the entire connection, so in practice it
    # will be stored with a single SSLSocket, along with the reference to the
    # keychain.
    certificates = []
    identities = []

    # Filter out bad paths.
    paths = (path for path in paths if path)

    try:
        for file_path in paths:
            new_identities, new_certs = _load_items_from_file(keychain, file_path)
            identities.extend(new_identities)
            certificates.extend(new_certs)

        # Ok, we have everything. The question is: do we have an identity? If
        # not, we want to grab one from the first cert we have.
        if not identities:
            new_identity = Security.SecIdentityRef()
            status = Security.SecIdentityCreateWithCertificate(
                keychain, certificates[0], ctypes.byref(new_identity)
            )
            _assert_no_error(status)
            identities.append(new_identity)

            # We now want to release the original certificate, as we no longer
            # need it.
            CoreFoundation.CFRelease(certificates.pop(0))

        # We now need to build a new CFArray that holds the trust chain.
        trust_chain = CoreFoundation.CFArrayCreateMutable(
            CoreFoundation.kCFAllocatorDefault,
            0,
            ctypes.byref(CoreFoundation.kCFTypeArrayCallBacks),
        )
        for item in itertools.chain(identities, certificates):
            # ArrayAppendValue does a CFRetain on the item. That's fine,
            # because the finally block will release our other refs to them.
            CoreFoundation.CFArrayAppendValue(trust_chain, item)

        return trust_chain
    finally:
        for obj in itertools.chain(identities, certificates):
            CoreFoundation.CFRelease(obj)
site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000264151446177000027473 0ustar00U

��.e�@sdS)N�rrr�Y/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py�<module>�site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-38.opt-1.pyc000064400000023727151446177000027542 0ustar00U

��.e�A�	@s�dZddlmZddlZddlmZddlmZmZm	Z	m
Z
mZmZm
Z
mZmZddlmZmZmZed�Zesxed��ed	�Zes�ed
��e��dZeeee�d���Zedkr�ed
ededf��eedd�Zeedd�ZeZ eZ!eZ"eZ#eZ$eZ%eZ&eZ'eZ(eZ)e
Z*ee)�Z+eZ,eZ-ee#�Z.ee$�Z/ee%�Z0ee&�Z1ee'�Z2eZ3eZ4eZ5ee�Z6eZ7eZ8ee�Z9eZ:eZ;ee�Z<eZ=eZ>ee�Z?ee�Z@eZAeZBeZCeZDeZEeZF�z�e.e/ee7�ee8�e:ee;�e<ee0�gejG_He-ejG_IgejJ_He*ejJ_IgejK_He*ejK_IgejL_He*ejL_Ie,e.gejM_He6ejM_Ie6gejN_He.ejN_Ie-egejO_He/ejO_Ie+e6ee9�gejP_He-ejP_Ie	eee eee<�gejQ_He-ejQ_Ie<gejR_He-ejR_Ie.e2ee0�gejS_He-ejS_Iee-eAeee
��ZTee-eAee�ee
��ZUe?eTeUgejV_He-ejV_Ie?e	e
gejW_He-ejW_Ie?e0gejX_He-ejX_Ie?e+e gejY_He-ejY_Ie?eAgejZ_He-ejZ_Ie?e	e
gej[_He-ej[_Ie?gej\_He-ej\_Ie?e	e
ee
�gej]_He-ej]_Ie?e	e
ee
�gej^_He-ej^_Ie?gej__He-ej__Ie?ee
�gej`_He-ej`_Ie?ee>�ee
�geja_He-eja_Ie?ee>�e
gejb_He-ejb_Ie?ee
�gejc_de-ejc_Ie?ee>�ee
�geje_He-eje_Ie?ee>�gejf_He-ejf_Ie?ee=�gejg_He-ejg_Ie?ee@�gejh_He-ejh_Ie@e0geji_He-eji_Ie@e gejj_ke-ejj_Ie@eeB�gejl_He-ejl_Ie@gejm_He!ejm_Ie@e!gejn_He6ejn_Ie,eDeEgejo_He?ejo_Ie?eFe gejp_He-ejp_Ie?e=gejq_He-ejq_Ie?e=gejr_He-ejr_Ie-egejO_He/ejO_IeTe_TeUe_Ue?e_?e=e_=e>e_>e9e_9e<e_<e@e_@eBe_Be7e_7e-e_-e/�sed�e_te/�sed�e_ue+gejv_He+ejv_Ie+gejw_Hdejw_Ie+gejx_He*ejx_Ie,e	e"gejy_He/ejy_Ie/e"gejz_He	ejz_Ie/e	e!e"gej{_Heej{_Ie,e	e!gej|_He.ej|_Ie.gej}_He!ej}_Ie.gej~_Heej~_Ie,ee+�ee+�e!e4e5gej_He2ej_Ie2e+gej�_He+ej�_Ie,ee+�e!e3gej�_He0ej�_Ie,e!e3gej�_He1ej�_Ie1egej�_Hdej�_Ie0gej�_He!ej�_Ie0e!gej�_Heej�_Ie,�sed�e_�e�sed�e_�e�sed�e_�e�sed�e_�e+e_+e0e_0e/e_/e2e_2Wne�k
�rted��YnXGdd�de��Z�Gdd�de��Z�dS)ay
This module uses ctypes to bind a whole bunch of functions and constants from
SecureTransport. The goal here is to provide the low-level API to
SecureTransport. These are essentially the C-level functions and constants, and
they're pretty gross to work with.

This code is a bastardised version of the code found in Will Bond's oscrypto
library. An enormous debt is owed to him for blazing this trail for us. For
that reason, this code should be considered to be covered both by urllib3's
license and by oscrypto's:

    Copyright (c) 2015-2016 Will Bond <will@wbond.net>

    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files (the "Software"),
    to deal in the Software without restriction, including without limitation
    the rights to use, copy, modify, merge, publish, distribute, sublicense,
    and/or sell copies of the Software, and to permit persons to whom the
    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.
�)�absolute_importN)�find_library)	�c_void_p�c_int32�c_char_p�c_size_t�c_byte�c_uint32�c_ulong�c_long�c_bool)�CDLL�POINTER�	CFUNCTYPE�Securityz'The library Security could not be found�CoreFoundationz-The library CoreFoundation could not be found�.)�
�z1Only OS X 10.8 and newer are supported, not %s.%s�T)Z	use_errno�kSecImportExportPassphrase�kSecImportItemIdentity�kCFAllocatorDefault�kCFTypeArrayCallBacks�kCFTypeDictionaryKeyCallBacks�kCFTypeDictionaryValueCallBackszError initializing ctypesc@seZdZdZed�ZdS)�CFConstz_
    A class object that acts as essentially a namespace for CoreFoundation
    constants.
    iN)�__name__�
__module__�__qualname__�__doc__�CFStringEncodingZkCFStringEncodingUTF8�r"r"�Y/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.pyr�src@s(eZdZdZdZdZdZdZdZdZ	dZ
d	ZdZdZ
dZdZdZd
ZdZdZdZdZd
ZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(d Z)d!Z*d"Z+d#Z,d$Z-d%Z.d&Z/d'Z0d(Z1d)Z2d*Z3d+Z4d,Z5d-Z6d.Z7d/Z8d0Z9d1Z:d2Z;d3Z<d4Z=d5Z>d6Z?d7Z@d8ZAd9ZBd:ZCd;ZDd<ZEd=ZFd>ZGd?ZHd@ZIdAS)B�
SecurityConstzU
    A class object that acts as essentially a namespace for Security constants.
    rr���rri����i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i ���iQ���i,���iR���i,�i0�i+�i/�i��i����i$�i(�i
�i��k�9i#�i'�i	�i��g�3���=�<�5�/iiiiN)Jrrrr Z"kSSLSessionOptionBreakOnServerAuthZ
kSSLProtocol2Z
kSSLProtocol3Z
kTLSProtocol1ZkTLSProtocol11ZkTLSProtocol12ZkTLSProtocol13ZkTLSProtocolMaxSupportedZkSSLClientSideZkSSLStreamTypeZkSecFormatPEMSequenceZkSecTrustResultInvalidZkSecTrustResultProceedZkSecTrustResultDenyZkSecTrustResultUnspecifiedZ&kSecTrustResultRecoverableTrustFailureZ kSecTrustResultFatalTrustFailureZkSecTrustResultOtherErrorZerrSSLProtocolZerrSSLWouldBlockZerrSSLClosedGracefulZerrSSLClosedNoNotifyZerrSSLClosedAbortZerrSSLXCertChainInvalidZerrSSLCryptoZerrSSLInternalZerrSSLCertExpiredZerrSSLCertNotYetValidZerrSSLUnknownRootCertZerrSSLNoRootCertZerrSSLHostNameMismatchZerrSSLPeerHandshakeFailZerrSSLPeerUserCancelledZerrSSLWeakPeerEphemeralDHKeyZerrSSLServerAuthCompletedZerrSSLRecordOverflowZerrSecVerifyFailedZerrSecNoTrustSettingsZerrSecItemNotFoundZerrSecInvalidTrustSettingsZ'TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384Z%TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384Z'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256Z%TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256Z-TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256Z+TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256Z#TLS_DHE_RSA_WITH_AES_256_GCM_SHA384Z#TLS_DHE_RSA_WITH_AES_128_GCM_SHA256Z'TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384Z%TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384Z$TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHAZ"TLS_ECDHE_RSA_WITH_AES_256_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_256_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_256_CBC_SHAZ'TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256Z%TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256Z$TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHAZ"TLS_ECDHE_RSA_WITH_AES_128_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_128_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_128_CBC_SHAZTLS_RSA_WITH_AES_256_GCM_SHA384ZTLS_RSA_WITH_AES_128_GCM_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHA256ZTLS_RSA_WITH_AES_128_CBC_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHAZTLS_RSA_WITH_AES_128_CBC_SHAZTLS_AES_128_GCM_SHA256ZTLS_AES_256_GCM_SHA384ZTLS_AES_128_CCM_8_SHA256ZTLS_AES_128_CCM_SHA256r"r"r"r#r$�s�r$)�r Z
__future__r�platformZctypes.utilrZctypesrrrrrr	r
rrr
rrZ
security_path�ImportErrorZcore_foundation_pathZmac_ver�version�tuple�map�int�split�version_info�OSErrorrrZBooleanZCFIndexr!ZCFDataZCFStringZCFArrayZCFMutableArrayZCFDictionaryZCFErrorZCFTypeZCFTypeIDZ	CFTypeRefZCFAllocatorRefZOSStatusZ	CFDataRefZCFStringRefZ
CFArrayRefZCFMutableArrayRefZCFDictionaryRefZCFArrayCallBacksZCFDictionaryKeyCallBacksZCFDictionaryValueCallBacksZSecCertificateRefZSecExternalFormatZSecExternalItemTypeZSecIdentityRefZSecItemImportExportFlagsZ SecItemImportExportKeyParametersZSecKeychainRefZSSLProtocolZSSLCipherSuiteZ
SSLContextRefZSecTrustRefZSSLConnectionRefZSecTrustResultTypeZSecTrustOptionFlagsZSSLProtocolSideZSSLConnectionTypeZSSLSessionOptionZ
SecItemImportZargtypesZrestypeZSecCertificateGetTypeIDZSecIdentityGetTypeIDZSecKeyGetTypeIDZSecCertificateCreateWithDataZSecCertificateCopyDataZSecCopyErrorMessageStringZ SecIdentityCreateWithCertificateZSecKeychainCreateZSecKeychainDeleteZSecPKCS12ImportZSSLReadFuncZSSLWriteFuncZ
SSLSetIOFuncsZSSLSetPeerIDZSSLSetCertificateZSSLSetCertificateAuthoritiesZSSLSetConnectionZSSLSetPeerDomainNameZSSLHandshakeZSSLReadZSSLWriteZSSLCloseZSSLGetNumberSupportedCiphersZSSLGetSupportedCiphersZSSLSetEnabledCiphersZSSLGetNumberEnabledCiphersZargtypeZSSLGetEnabledCiphersZSSLGetNegotiatedCipherZSSLGetNegotiatedProtocolVersionZSSLCopyPeerTrustZSecTrustSetAnchorCertificatesZ!SecTrustSetAnchorCertificatesOnlyZ	argstypesZSecTrustEvaluateZSecTrustGetCertificateCountZSecTrustGetCertificateAtIndexZSSLCreateContextZSSLSetSessionOptionZSSLSetProtocolVersionMinZSSLSetProtocolVersionMaxZin_dllrrZCFRetainZ	CFReleaseZCFGetTypeIDZCFStringCreateWithCStringZCFStringGetCStringPtrZCFStringGetCStringZCFDataCreateZCFDataGetLengthZCFDataGetBytePtrZCFDictionaryCreateZCFDictionaryGetValueZ
CFArrayCreateZCFArrayCreateMutableZCFArrayAppendValueZCFArrayGetCountZCFArrayGetValueAtIndexrrrr�AttributeError�objectrr$r"r"r"r#�<module>s&,���

��
��

����
���


��

���
����
	pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-38.opt-1.pyc000064400000016540151446177000027651 0ustar00site-packagesU

��.e�.�@s�dZddlZddlZddlZddlZddlZddlZddlZddlm	Z	m
Z
mZe�dej
�Zdd�Zdd	�Zd
d�Zddd
�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�ZdS)a�
Low-level helpers for the SecureTransport bindings.

These are Python functions that are not directly related to the high-level APIs
but are necessary to get them to work. They include a whole bunch of low-level
CoreFoundation messing about and memory management. The concerns in this module
are almost entirely about trying to avoid memory leaks and providing
appropriate and useful assistance to the higher-level code.
�N�)�Security�CoreFoundation�CFConsts;-----BEGIN CERTIFICATE-----
(.*?)
-----END CERTIFICATE-----cCst�tj|t|��S)zv
    Given a bytestring, create a CFData object from it. This CFData object must
    be CFReleased by the caller.
    )r�CFDataCreate�kCFAllocatorDefault�len)Z
bytestring�r	�Z/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py�_cf_data_from_bytess
�rcCsZt|�}dd�|D�}dd�|D�}tj||�}tj||�}t�tj|||tjtj�S)zK
    Given a list of Python tuples, create an associated CFDictionary.
    css|]}|dVqdS)rNr	��.0�tr	r	r
�	<genexpr>,sz-_cf_dictionary_from_tuples.<locals>.<genexpr>css|]}|dVqdS)rNr	rr	r	r
r-s)rr�	CFTypeRefZCFDictionaryCreaterZkCFTypeDictionaryKeyCallBacksZkCFTypeDictionaryValueCallBacks)ZtuplesZdictionary_size�keys�valuesZcf_keysZ	cf_valuesr	r	r
�_cf_dictionary_from_tuples%s�rcCsnt�|t�tj��}t�|tj�}|dkrXt�d�}t�	||dtj�}|sRt
d��|j}|dk	rj|�d�}|S)z�
    Creates a Unicode string from a CFString object. Used entirely for error
    reporting.

    Yes, it annoys me quite a lot that this function is this complex.
    Niz'Error copying C string from CFStringRef�utf-8)
�ctypes�castZPOINTERZc_void_prZCFStringGetCStringPtrrZkCFStringEncodingUTF8Zcreate_string_bufferZCFStringGetCString�OSError�value�decode)rZvalue_as_void_p�string�buffer�resultr	r	r
�_cf_string_to_unicode;s&�
�
rcCs\|dkrdSt�|d�}t|�}t�|�|dks:|dkrBd|}|dkrPtj}||��dS)z[
    Checks the return code and throws an exception if there is an error to
    report
    rN�zOSStatus %s)rZSecCopyErrorMessageStringrr�	CFRelease�ssl�SSLError)�errorZexception_classZcf_error_string�outputr	r	r
�_assert_no_errorTs
r$cCs�|�dd�}dd�t�|�D�}|s.t�d��t�tjdt�	tj
��}|sTt�d��z`|D]V}t|�}|stt�d��t�
tj|�}t�|�|s�t�d��t�||�t�|�qZWntk
r�t�|�YnX|S)	z�
    Given a bundle of certs in PEM format, turns them into a CFArray of certs
    that can be used to validate a cert chain.
    s
�
cSsg|]}t�|�d���qS)r)�base64Z	b64decode�group)r
�matchr	r	r
�
<listcomp>qsz(_cert_array_from_pem.<locals>.<listcomp>zNo root certificates specifiedrzUnable to allocate memory!zUnable to build cert object!)�replace�
_PEM_CERTS_RE�finditerr r!r�CFArrayCreateMutablerr�byref�kCFTypeArrayCallBacksrrZSecCertificateCreateWithDatar�CFArrayAppendValue�	Exception)Z
pem_bundleZ	der_certsZ
cert_arrayZ	der_bytesZcertdataZcertr	r	r
�_cert_array_from_pemis<�

�

�

r2cCst��}t�|�|kS)z=
    Returns True if a given CFTypeRef is a certificate.
    )rZSecCertificateGetTypeIDr�CFGetTypeID��itemZexpectedr	r	r
�_is_cert�sr6cCst��}t�|�|kS)z;
    Returns True if a given CFTypeRef is an identity.
    )rZSecIdentityGetTypeIDrr3r4r	r	r
�_is_identity�sr7c
Cs�t�d�}t�|dd���d�}t�|dd��}t��}tj�||��	d�}t
��}t
�|t
|�|ddt�|��}t|�||fS)a�
    This function creates a temporary Mac keychain that we can use to work with
    credentials. This keychain uses a one-time password and a temporary file to
    store the data. We expect to have one keychain per socket. The returned
    SecKeychainRef must be freed by the caller, including calling
    SecKeychainDelete.

    Returns a tuple of the SecKeychainRef and the path to the temporary
    directory that contains it.
    �(N�rF)�os�urandomr&Z	b16encoder�tempfileZmkdtemp�path�join�encoderZSecKeychainRefZSecKeychainCreaterrr.r$)Zrandom_bytes�filenameZpasswordZ
tempdirectoryZ
keychain_path�keychain�statusr	r	r
�_temporary_keychain�s 
�rCcCsg}g}d}t|d��}|��}W5QRXz�t�tj|t|��}t��}t�	|ddddd|t
�|��}t|�t�
|�}	t|	�D]X}
t�||
�}t
�|tj�}t|�r�t�|�|�|�q�t|�r�t�|�|�|�q�W5|r�t�|�t�|�X||fS)z�
    Given a single file, loads all the trust objects from it into arrays and
    the keychain.
    Returns a tuple of lists: the first list is a list of identities, the
    second a list of certs.
    N�rbr)�open�readrrrrrZ
CFArrayRefrZ
SecItemImportrr.r$ZCFArrayGetCount�rangeZCFArrayGetValueAtIndexrrr6ZCFRetain�appendr7)rAr=�certificates�
identitiesZresult_array�fZraw_filedataZfiledatarZresult_count�indexr5r	r	r
�_load_items_from_file�sJ��




rMc
Gs�g}g}dd�|D�}z�|D]&}t||�\}}|�|�|�|�q|s�t��}t�||dt	�
|��}	t|	�|�|�t�|�
d��t�tjdt	�
tj��}
t�||�D]}t�|
|�q�|
W�St�||�D]}t�|�q�XdS)z�
    Load certificates and maybe keys from a number of files. Has the end goal
    of returning a CFArray containing one SecIdentityRef, and then zero or more
    SecCertificateRef objects, suitable for use as a client certificate trust
    chain.
    css|]}|r|VqdS)Nr	)r
r=r	r	r
r$sz*_load_client_cert_chain.<locals>.<genexpr>rN)�	itertools�chainrrrM�extendrZSecIdentityRefZ SecIdentityCreateWithCertificaterr.r$rH�popr-rr/r0)rA�pathsrIrJ�objZ	file_pathZnew_identitiesZ	new_certsZnew_identityrBZtrust_chainr5r	r	r
�_load_client_cert_chains8 
�

�rT)N)�__doc__r&rrN�rer:r r<Zbindingsrrr�compile�DOTALLr+rrrr$r2r6r7rCrMrTr	r	r	r
�<module>s,	�

-#7site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/low_level.cpython-38.pyc000064400000016540151446177000026771 0ustar00U

��.e�.�@s�dZddlZddlZddlZddlZddlZddlZddlZddlm	Z	m
Z
mZe�dej
�Zdd�Zdd	�Zd
d�Zddd
�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�ZdS)a�
Low-level helpers for the SecureTransport bindings.

These are Python functions that are not directly related to the high-level APIs
but are necessary to get them to work. They include a whole bunch of low-level
CoreFoundation messing about and memory management. The concerns in this module
are almost entirely about trying to avoid memory leaks and providing
appropriate and useful assistance to the higher-level code.
�N�)�Security�CoreFoundation�CFConsts;-----BEGIN CERTIFICATE-----
(.*?)
-----END CERTIFICATE-----cCst�tj|t|��S)zv
    Given a bytestring, create a CFData object from it. This CFData object must
    be CFReleased by the caller.
    )r�CFDataCreate�kCFAllocatorDefault�len)Z
bytestring�r	�Z/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_securetransport/low_level.py�_cf_data_from_bytess
�rcCsZt|�}dd�|D�}dd�|D�}tj||�}tj||�}t�tj|||tjtj�S)zK
    Given a list of Python tuples, create an associated CFDictionary.
    css|]}|dVqdS)rNr	��.0�tr	r	r
�	<genexpr>,sz-_cf_dictionary_from_tuples.<locals>.<genexpr>css|]}|dVqdS)rNr	rr	r	r
r-s)rr�	CFTypeRefZCFDictionaryCreaterZkCFTypeDictionaryKeyCallBacksZkCFTypeDictionaryValueCallBacks)ZtuplesZdictionary_size�keys�valuesZcf_keysZ	cf_valuesr	r	r
�_cf_dictionary_from_tuples%s�rcCsnt�|t�tj��}t�|tj�}|dkrXt�d�}t�	||dtj�}|sRt
d��|j}|dk	rj|�d�}|S)z�
    Creates a Unicode string from a CFString object. Used entirely for error
    reporting.

    Yes, it annoys me quite a lot that this function is this complex.
    Niz'Error copying C string from CFStringRef�utf-8)
�ctypes�castZPOINTERZc_void_prZCFStringGetCStringPtrrZkCFStringEncodingUTF8Zcreate_string_bufferZCFStringGetCString�OSError�value�decode)rZvalue_as_void_p�string�buffer�resultr	r	r
�_cf_string_to_unicode;s&�
�
rcCs\|dkrdSt�|d�}t|�}t�|�|dks:|dkrBd|}|dkrPtj}||��dS)z[
    Checks the return code and throws an exception if there is an error to
    report
    rN�zOSStatus %s)rZSecCopyErrorMessageStringrr�	CFRelease�ssl�SSLError)�errorZexception_classZcf_error_string�outputr	r	r
�_assert_no_errorTs
r$cCs�|�dd�}dd�t�|�D�}|s.t�d��t�tjdt�	tj
��}|sTt�d��z`|D]V}t|�}|stt�d��t�
tj|�}t�|�|s�t�d��t�||�t�|�qZWntk
r�t�|�YnX|S)	z�
    Given a bundle of certs in PEM format, turns them into a CFArray of certs
    that can be used to validate a cert chain.
    s
�
cSsg|]}t�|�d���qS)r)�base64Z	b64decode�group)r
�matchr	r	r
�
<listcomp>qsz(_cert_array_from_pem.<locals>.<listcomp>zNo root certificates specifiedrzUnable to allocate memory!zUnable to build cert object!)�replace�
_PEM_CERTS_RE�finditerr r!r�CFArrayCreateMutablerr�byref�kCFTypeArrayCallBacksrrZSecCertificateCreateWithDatar�CFArrayAppendValue�	Exception)Z
pem_bundleZ	der_certsZ
cert_arrayZ	der_bytesZcertdataZcertr	r	r
�_cert_array_from_pemis<�

�

�

r2cCst��}t�|�|kS)z=
    Returns True if a given CFTypeRef is a certificate.
    )rZSecCertificateGetTypeIDr�CFGetTypeID��itemZexpectedr	r	r
�_is_cert�sr6cCst��}t�|�|kS)z;
    Returns True if a given CFTypeRef is an identity.
    )rZSecIdentityGetTypeIDrr3r4r	r	r
�_is_identity�sr7c
Cs�t�d�}t�|dd���d�}t�|dd��}t��}tj�||��	d�}t
��}t
�|t
|�|ddt�|��}t|�||fS)a�
    This function creates a temporary Mac keychain that we can use to work with
    credentials. This keychain uses a one-time password and a temporary file to
    store the data. We expect to have one keychain per socket. The returned
    SecKeychainRef must be freed by the caller, including calling
    SecKeychainDelete.

    Returns a tuple of the SecKeychainRef and the path to the temporary
    directory that contains it.
    �(N�rF)�os�urandomr&Z	b16encoder�tempfileZmkdtemp�path�join�encoderZSecKeychainRefZSecKeychainCreaterrr.r$)Zrandom_bytes�filenameZpasswordZ
tempdirectoryZ
keychain_path�keychain�statusr	r	r
�_temporary_keychain�s 
�rCcCsg}g}d}t|d��}|��}W5QRXz�t�tj|t|��}t��}t�	|ddddd|t
�|��}t|�t�
|�}	t|	�D]X}
t�||
�}t
�|tj�}t|�r�t�|�|�|�q�t|�r�t�|�|�|�q�W5|r�t�|�t�|�X||fS)z�
    Given a single file, loads all the trust objects from it into arrays and
    the keychain.
    Returns a tuple of lists: the first list is a list of identities, the
    second a list of certs.
    N�rbr)�open�readrrrrrZ
CFArrayRefrZ
SecItemImportrr.r$ZCFArrayGetCount�rangeZCFArrayGetValueAtIndexrrr6ZCFRetain�appendr7)rAr=�certificates�
identitiesZresult_array�fZraw_filedataZfiledatarZresult_count�indexr5r	r	r
�_load_items_from_file�sJ��




rMc
Gs�g}g}dd�|D�}z�|D]&}t||�\}}|�|�|�|�q|s�t��}t�||dt	�
|��}	t|	�|�|�t�|�
d��t�tjdt	�
tj��}
t�||�D]}t�|
|�q�|
W�St�||�D]}t�|�q�XdS)z�
    Load certificates and maybe keys from a number of files. Has the end goal
    of returning a CFArray containing one SecIdentityRef, and then zero or more
    SecCertificateRef objects, suitable for use as a client certificate trust
    chain.
    css|]}|r|VqdS)Nr	)r
r=r	r	r
r$sz*_load_client_cert_chain.<locals>.<genexpr>rN)�	itertools�chainrrrM�extendrZSecIdentityRefZ SecIdentityCreateWithCertificaterr.r$rH�popr-rr/r0)rA�pathsrIrJ�objZ	file_pathZnew_identitiesZ	new_certsZnew_identityrBZtrust_chainr5r	r	r
�_load_client_cert_chains8 
�

�rT)N)�__doc__r&rrN�rer:r r<Zbindingsrrr�compile�DOTALLr+rrrr$r2r6r7rCrMrTr	r	r	r
�<module>s,	�

-#7site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/bindings.cpython-38.pyc000064400000023727151446177000026603 0ustar00U

��.e�A�	@s�dZddlmZddlZddlmZddlmZmZm	Z	m
Z
mZmZm
Z
mZmZddlmZmZmZed�Zesxed��ed	�Zes�ed
��e��dZeeee�d���Zedkr�ed
ededf��eedd�Zeedd�ZeZ eZ!eZ"eZ#eZ$eZ%eZ&eZ'eZ(eZ)e
Z*ee)�Z+eZ,eZ-ee#�Z.ee$�Z/ee%�Z0ee&�Z1ee'�Z2eZ3eZ4eZ5ee�Z6eZ7eZ8ee�Z9eZ:eZ;ee�Z<eZ=eZ>ee�Z?ee�Z@eZAeZBeZCeZDeZEeZF�z�e.e/ee7�ee8�e:ee;�e<ee0�gejG_He-ejG_IgejJ_He*ejJ_IgejK_He*ejK_IgejL_He*ejL_Ie,e.gejM_He6ejM_Ie6gejN_He.ejN_Ie-egejO_He/ejO_Ie+e6ee9�gejP_He-ejP_Ie	eee eee<�gejQ_He-ejQ_Ie<gejR_He-ejR_Ie.e2ee0�gejS_He-ejS_Iee-eAeee
��ZTee-eAee�ee
��ZUe?eTeUgejV_He-ejV_Ie?e	e
gejW_He-ejW_Ie?e0gejX_He-ejX_Ie?e+e gejY_He-ejY_Ie?eAgejZ_He-ejZ_Ie?e	e
gej[_He-ej[_Ie?gej\_He-ej\_Ie?e	e
ee
�gej]_He-ej]_Ie?e	e
ee
�gej^_He-ej^_Ie?gej__He-ej__Ie?ee
�gej`_He-ej`_Ie?ee>�ee
�geja_He-eja_Ie?ee>�e
gejb_He-ejb_Ie?ee
�gejc_de-ejc_Ie?ee>�ee
�geje_He-eje_Ie?ee>�gejf_He-ejf_Ie?ee=�gejg_He-ejg_Ie?ee@�gejh_He-ejh_Ie@e0geji_He-eji_Ie@e gejj_ke-ejj_Ie@eeB�gejl_He-ejl_Ie@gejm_He!ejm_Ie@e!gejn_He6ejn_Ie,eDeEgejo_He?ejo_Ie?eFe gejp_He-ejp_Ie?e=gejq_He-ejq_Ie?e=gejr_He-ejr_Ie-egejO_He/ejO_IeTe_TeUe_Ue?e_?e=e_=e>e_>e9e_9e<e_<e@e_@eBe_Be7e_7e-e_-e/�sed�e_te/�sed�e_ue+gejv_He+ejv_Ie+gejw_Hdejw_Ie+gejx_He*ejx_Ie,e	e"gejy_He/ejy_Ie/e"gejz_He	ejz_Ie/e	e!e"gej{_Heej{_Ie,e	e!gej|_He.ej|_Ie.gej}_He!ej}_Ie.gej~_Heej~_Ie,ee+�ee+�e!e4e5gej_He2ej_Ie2e+gej�_He+ej�_Ie,ee+�e!e3gej�_He0ej�_Ie,e!e3gej�_He1ej�_Ie1egej�_Hdej�_Ie0gej�_He!ej�_Ie0e!gej�_Heej�_Ie,�sed�e_�e�sed�e_�e�sed�e_�e�sed�e_�e+e_+e0e_0e/e_/e2e_2Wne�k
�rted��YnXGdd�de��Z�Gdd�de��Z�dS)ay
This module uses ctypes to bind a whole bunch of functions and constants from
SecureTransport. The goal here is to provide the low-level API to
SecureTransport. These are essentially the C-level functions and constants, and
they're pretty gross to work with.

This code is a bastardised version of the code found in Will Bond's oscrypto
library. An enormous debt is owed to him for blazing this trail for us. For
that reason, this code should be considered to be covered both by urllib3's
license and by oscrypto's:

    Copyright (c) 2015-2016 Will Bond <will@wbond.net>

    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files (the "Software"),
    to deal in the Software without restriction, including without limitation
    the rights to use, copy, modify, merge, publish, distribute, sublicense,
    and/or sell copies of the Software, and to permit persons to whom the
    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.
�)�absolute_importN)�find_library)	�c_void_p�c_int32�c_char_p�c_size_t�c_byte�c_uint32�c_ulong�c_long�c_bool)�CDLL�POINTER�	CFUNCTYPE�Securityz'The library Security could not be found�CoreFoundationz-The library CoreFoundation could not be found�.)�
�z1Only OS X 10.8 and newer are supported, not %s.%s�T)Z	use_errno�kSecImportExportPassphrase�kSecImportItemIdentity�kCFAllocatorDefault�kCFTypeArrayCallBacks�kCFTypeDictionaryKeyCallBacks�kCFTypeDictionaryValueCallBackszError initializing ctypesc@seZdZdZed�ZdS)�CFConstz_
    A class object that acts as essentially a namespace for CoreFoundation
    constants.
    iN)�__name__�
__module__�__qualname__�__doc__�CFStringEncodingZkCFStringEncodingUTF8�r"r"�Y/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.pyr�src@s(eZdZdZdZdZdZdZdZdZ	dZ
d	ZdZdZ
dZdZdZd
ZdZdZdZdZd
ZdZdZdZdZdZdZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%dZ&dZ'dZ(d Z)d!Z*d"Z+d#Z,d$Z-d%Z.d&Z/d'Z0d(Z1d)Z2d*Z3d+Z4d,Z5d-Z6d.Z7d/Z8d0Z9d1Z:d2Z;d3Z<d4Z=d5Z>d6Z?d7Z@d8ZAd9ZBd:ZCd;ZDd<ZEd=ZFd>ZGd?ZHd@ZIdAS)B�
SecurityConstzU
    A class object that acts as essentially a namespace for Security constants.
    rr���rri����i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i���i ���iQ���i,���iR���i,�i0�i+�i/�i��i����i$�i(�i
�i��k�9i#�i'�i	�i��g�3���=�<�5�/iiiiN)Jrrrr Z"kSSLSessionOptionBreakOnServerAuthZ
kSSLProtocol2Z
kSSLProtocol3Z
kTLSProtocol1ZkTLSProtocol11ZkTLSProtocol12ZkTLSProtocol13ZkTLSProtocolMaxSupportedZkSSLClientSideZkSSLStreamTypeZkSecFormatPEMSequenceZkSecTrustResultInvalidZkSecTrustResultProceedZkSecTrustResultDenyZkSecTrustResultUnspecifiedZ&kSecTrustResultRecoverableTrustFailureZ kSecTrustResultFatalTrustFailureZkSecTrustResultOtherErrorZerrSSLProtocolZerrSSLWouldBlockZerrSSLClosedGracefulZerrSSLClosedNoNotifyZerrSSLClosedAbortZerrSSLXCertChainInvalidZerrSSLCryptoZerrSSLInternalZerrSSLCertExpiredZerrSSLCertNotYetValidZerrSSLUnknownRootCertZerrSSLNoRootCertZerrSSLHostNameMismatchZerrSSLPeerHandshakeFailZerrSSLPeerUserCancelledZerrSSLWeakPeerEphemeralDHKeyZerrSSLServerAuthCompletedZerrSSLRecordOverflowZerrSecVerifyFailedZerrSecNoTrustSettingsZerrSecItemNotFoundZerrSecInvalidTrustSettingsZ'TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384Z%TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384Z'TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256Z%TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256Z-TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256Z+TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256Z#TLS_DHE_RSA_WITH_AES_256_GCM_SHA384Z#TLS_DHE_RSA_WITH_AES_128_GCM_SHA256Z'TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384Z%TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384Z$TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHAZ"TLS_ECDHE_RSA_WITH_AES_256_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_256_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_256_CBC_SHAZ'TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256Z%TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256Z$TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHAZ"TLS_ECDHE_RSA_WITH_AES_128_CBC_SHAZ#TLS_DHE_RSA_WITH_AES_128_CBC_SHA256Z TLS_DHE_RSA_WITH_AES_128_CBC_SHAZTLS_RSA_WITH_AES_256_GCM_SHA384ZTLS_RSA_WITH_AES_128_GCM_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHA256ZTLS_RSA_WITH_AES_128_CBC_SHA256ZTLS_RSA_WITH_AES_256_CBC_SHAZTLS_RSA_WITH_AES_128_CBC_SHAZTLS_AES_128_GCM_SHA256ZTLS_AES_256_GCM_SHA384ZTLS_AES_128_CCM_8_SHA256ZTLS_AES_128_CCM_SHA256r"r"r"r#r$�s�r$)�r Z
__future__r�platformZctypes.utilrZctypesrrrrrr	r
rrr
rrZ
security_path�ImportErrorZcore_foundation_pathZmac_ver�version�tuple�map�int�split�version_info�OSErrorrrZBooleanZCFIndexr!ZCFDataZCFStringZCFArrayZCFMutableArrayZCFDictionaryZCFErrorZCFTypeZCFTypeIDZ	CFTypeRefZCFAllocatorRefZOSStatusZ	CFDataRefZCFStringRefZ
CFArrayRefZCFMutableArrayRefZCFDictionaryRefZCFArrayCallBacksZCFDictionaryKeyCallBacksZCFDictionaryValueCallBacksZSecCertificateRefZSecExternalFormatZSecExternalItemTypeZSecIdentityRefZSecItemImportExportFlagsZ SecItemImportExportKeyParametersZSecKeychainRefZSSLProtocolZSSLCipherSuiteZ
SSLContextRefZSecTrustRefZSSLConnectionRefZSecTrustResultTypeZSecTrustOptionFlagsZSSLProtocolSideZSSLConnectionTypeZSSLSessionOptionZ
SecItemImportZargtypesZrestypeZSecCertificateGetTypeIDZSecIdentityGetTypeIDZSecKeyGetTypeIDZSecCertificateCreateWithDataZSecCertificateCopyDataZSecCopyErrorMessageStringZ SecIdentityCreateWithCertificateZSecKeychainCreateZSecKeychainDeleteZSecPKCS12ImportZSSLReadFuncZSSLWriteFuncZ
SSLSetIOFuncsZSSLSetPeerIDZSSLSetCertificateZSSLSetCertificateAuthoritiesZSSLSetConnectionZSSLSetPeerDomainNameZSSLHandshakeZSSLReadZSSLWriteZSSLCloseZSSLGetNumberSupportedCiphersZSSLGetSupportedCiphersZSSLSetEnabledCiphersZSSLGetNumberEnabledCiphersZargtypeZSSLGetEnabledCiphersZSSLGetNegotiatedCipherZSSLGetNegotiatedProtocolVersionZSSLCopyPeerTrustZSecTrustSetAnchorCertificatesZ!SecTrustSetAnchorCertificatesOnlyZ	argstypesZSecTrustEvaluateZSecTrustGetCertificateCountZSecTrustGetCertificateAtIndexZSSLCreateContextZSSLSetSessionOptionZSSLSetProtocolVersionMinZSSLSetProtocolVersionMaxZin_dllrrZCFRetainZ	CFReleaseZCFGetTypeIDZCFStringCreateWithCStringZCFStringGetCStringPtrZCFStringGetCStringZCFDataCreateZCFDataGetLengthZCFDataGetBytePtrZCFDictionaryCreateZCFDictionaryGetValueZ
CFArrayCreateZCFArrayCreateMutableZCFArrayAppendValueZCFArrayGetCountZCFArrayGetValueAtIndexrrrr�AttributeError�objectrr$r"r"r"r#�<module>s&,���

��
��

����
���


��

���
����
	site-packages/pip/_vendor/urllib3/contrib/_securetransport/__pycache__/__init__.cpython-38.pyc000064400000000264151446177000026534 0ustar00U

��.e�@sdS)N�rrr�Y/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py�<module>�site-packages/pip/_vendor/urllib3/contrib/_securetransport/__init__.py000064400000000000151446177000022232 0ustar00site-packages/pip/_vendor/urllib3/contrib/_securetransport/bindings.py000064400000040645151446177000022313 0ustar00"""
This module uses ctypes to bind a whole bunch of functions and constants from
SecureTransport. The goal here is to provide the low-level API to
SecureTransport. These are essentially the C-level functions and constants, and
they're pretty gross to work with.

This code is a bastardised version of the code found in Will Bond's oscrypto
library. An enormous debt is owed to him for blazing this trail for us. For
that reason, this code should be considered to be covered both by urllib3's
license and by oscrypto's:

    Copyright (c) 2015-2016 Will Bond <will@wbond.net>

    Permission is hereby granted, free of charge, to any person obtaining a
    copy of this software and associated documentation files (the "Software"),
    to deal in the Software without restriction, including without limitation
    the rights to use, copy, modify, merge, publish, distribute, sublicense,
    and/or sell copies of the Software, and to permit persons to whom the
    Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in
    all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
    FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    DEALINGS IN THE SOFTWARE.
"""
from __future__ import absolute_import

import platform
from ctypes.util import find_library
from ctypes import (
    c_void_p,
    c_int32,
    c_char_p,
    c_size_t,
    c_byte,
    c_uint32,
    c_ulong,
    c_long,
    c_bool,
)
from ctypes import CDLL, POINTER, CFUNCTYPE


security_path = find_library("Security")
if not security_path:
    raise ImportError("The library Security could not be found")


core_foundation_path = find_library("CoreFoundation")
if not core_foundation_path:
    raise ImportError("The library CoreFoundation could not be found")


version = platform.mac_ver()[0]
version_info = tuple(map(int, version.split(".")))
if version_info < (10, 8):
    raise OSError(
        "Only OS X 10.8 and newer are supported, not %s.%s"
        % (version_info[0], version_info[1])
    )

Security = CDLL(security_path, use_errno=True)
CoreFoundation = CDLL(core_foundation_path, use_errno=True)

Boolean = c_bool
CFIndex = c_long
CFStringEncoding = c_uint32
CFData = c_void_p
CFString = c_void_p
CFArray = c_void_p
CFMutableArray = c_void_p
CFDictionary = c_void_p
CFError = c_void_p
CFType = c_void_p
CFTypeID = c_ulong

CFTypeRef = POINTER(CFType)
CFAllocatorRef = c_void_p

OSStatus = c_int32

CFDataRef = POINTER(CFData)
CFStringRef = POINTER(CFString)
CFArrayRef = POINTER(CFArray)
CFMutableArrayRef = POINTER(CFMutableArray)
CFDictionaryRef = POINTER(CFDictionary)
CFArrayCallBacks = c_void_p
CFDictionaryKeyCallBacks = c_void_p
CFDictionaryValueCallBacks = c_void_p

SecCertificateRef = POINTER(c_void_p)
SecExternalFormat = c_uint32
SecExternalItemType = c_uint32
SecIdentityRef = POINTER(c_void_p)
SecItemImportExportFlags = c_uint32
SecItemImportExportKeyParameters = c_void_p
SecKeychainRef = POINTER(c_void_p)
SSLProtocol = c_uint32
SSLCipherSuite = c_uint32
SSLContextRef = POINTER(c_void_p)
SecTrustRef = POINTER(c_void_p)
SSLConnectionRef = c_uint32
SecTrustResultType = c_uint32
SecTrustOptionFlags = c_uint32
SSLProtocolSide = c_uint32
SSLConnectionType = c_uint32
SSLSessionOption = c_uint32


try:
    Security.SecItemImport.argtypes = [
        CFDataRef,
        CFStringRef,
        POINTER(SecExternalFormat),
        POINTER(SecExternalItemType),
        SecItemImportExportFlags,
        POINTER(SecItemImportExportKeyParameters),
        SecKeychainRef,
        POINTER(CFArrayRef),
    ]
    Security.SecItemImport.restype = OSStatus

    Security.SecCertificateGetTypeID.argtypes = []
    Security.SecCertificateGetTypeID.restype = CFTypeID

    Security.SecIdentityGetTypeID.argtypes = []
    Security.SecIdentityGetTypeID.restype = CFTypeID

    Security.SecKeyGetTypeID.argtypes = []
    Security.SecKeyGetTypeID.restype = CFTypeID

    Security.SecCertificateCreateWithData.argtypes = [CFAllocatorRef, CFDataRef]
    Security.SecCertificateCreateWithData.restype = SecCertificateRef

    Security.SecCertificateCopyData.argtypes = [SecCertificateRef]
    Security.SecCertificateCopyData.restype = CFDataRef

    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
    Security.SecCopyErrorMessageString.restype = CFStringRef

    Security.SecIdentityCreateWithCertificate.argtypes = [
        CFTypeRef,
        SecCertificateRef,
        POINTER(SecIdentityRef),
    ]
    Security.SecIdentityCreateWithCertificate.restype = OSStatus

    Security.SecKeychainCreate.argtypes = [
        c_char_p,
        c_uint32,
        c_void_p,
        Boolean,
        c_void_p,
        POINTER(SecKeychainRef),
    ]
    Security.SecKeychainCreate.restype = OSStatus

    Security.SecKeychainDelete.argtypes = [SecKeychainRef]
    Security.SecKeychainDelete.restype = OSStatus

    Security.SecPKCS12Import.argtypes = [
        CFDataRef,
        CFDictionaryRef,
        POINTER(CFArrayRef),
    ]
    Security.SecPKCS12Import.restype = OSStatus

    SSLReadFunc = CFUNCTYPE(OSStatus, SSLConnectionRef, c_void_p, POINTER(c_size_t))
    SSLWriteFunc = CFUNCTYPE(
        OSStatus, SSLConnectionRef, POINTER(c_byte), POINTER(c_size_t)
    )

    Security.SSLSetIOFuncs.argtypes = [SSLContextRef, SSLReadFunc, SSLWriteFunc]
    Security.SSLSetIOFuncs.restype = OSStatus

    Security.SSLSetPeerID.argtypes = [SSLContextRef, c_char_p, c_size_t]
    Security.SSLSetPeerID.restype = OSStatus

    Security.SSLSetCertificate.argtypes = [SSLContextRef, CFArrayRef]
    Security.SSLSetCertificate.restype = OSStatus

    Security.SSLSetCertificateAuthorities.argtypes = [SSLContextRef, CFTypeRef, Boolean]
    Security.SSLSetCertificateAuthorities.restype = OSStatus

    Security.SSLSetConnection.argtypes = [SSLContextRef, SSLConnectionRef]
    Security.SSLSetConnection.restype = OSStatus

    Security.SSLSetPeerDomainName.argtypes = [SSLContextRef, c_char_p, c_size_t]
    Security.SSLSetPeerDomainName.restype = OSStatus

    Security.SSLHandshake.argtypes = [SSLContextRef]
    Security.SSLHandshake.restype = OSStatus

    Security.SSLRead.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
    Security.SSLRead.restype = OSStatus

    Security.SSLWrite.argtypes = [SSLContextRef, c_char_p, c_size_t, POINTER(c_size_t)]
    Security.SSLWrite.restype = OSStatus

    Security.SSLClose.argtypes = [SSLContextRef]
    Security.SSLClose.restype = OSStatus

    Security.SSLGetNumberSupportedCiphers.argtypes = [SSLContextRef, POINTER(c_size_t)]
    Security.SSLGetNumberSupportedCiphers.restype = OSStatus

    Security.SSLGetSupportedCiphers.argtypes = [
        SSLContextRef,
        POINTER(SSLCipherSuite),
        POINTER(c_size_t),
    ]
    Security.SSLGetSupportedCiphers.restype = OSStatus

    Security.SSLSetEnabledCiphers.argtypes = [
        SSLContextRef,
        POINTER(SSLCipherSuite),
        c_size_t,
    ]
    Security.SSLSetEnabledCiphers.restype = OSStatus

    Security.SSLGetNumberEnabledCiphers.argtype = [SSLContextRef, POINTER(c_size_t)]
    Security.SSLGetNumberEnabledCiphers.restype = OSStatus

    Security.SSLGetEnabledCiphers.argtypes = [
        SSLContextRef,
        POINTER(SSLCipherSuite),
        POINTER(c_size_t),
    ]
    Security.SSLGetEnabledCiphers.restype = OSStatus

    Security.SSLGetNegotiatedCipher.argtypes = [SSLContextRef, POINTER(SSLCipherSuite)]
    Security.SSLGetNegotiatedCipher.restype = OSStatus

    Security.SSLGetNegotiatedProtocolVersion.argtypes = [
        SSLContextRef,
        POINTER(SSLProtocol),
    ]
    Security.SSLGetNegotiatedProtocolVersion.restype = OSStatus

    Security.SSLCopyPeerTrust.argtypes = [SSLContextRef, POINTER(SecTrustRef)]
    Security.SSLCopyPeerTrust.restype = OSStatus

    Security.SecTrustSetAnchorCertificates.argtypes = [SecTrustRef, CFArrayRef]
    Security.SecTrustSetAnchorCertificates.restype = OSStatus

    Security.SecTrustSetAnchorCertificatesOnly.argstypes = [SecTrustRef, Boolean]
    Security.SecTrustSetAnchorCertificatesOnly.restype = OSStatus

    Security.SecTrustEvaluate.argtypes = [SecTrustRef, POINTER(SecTrustResultType)]
    Security.SecTrustEvaluate.restype = OSStatus

    Security.SecTrustGetCertificateCount.argtypes = [SecTrustRef]
    Security.SecTrustGetCertificateCount.restype = CFIndex

    Security.SecTrustGetCertificateAtIndex.argtypes = [SecTrustRef, CFIndex]
    Security.SecTrustGetCertificateAtIndex.restype = SecCertificateRef

    Security.SSLCreateContext.argtypes = [
        CFAllocatorRef,
        SSLProtocolSide,
        SSLConnectionType,
    ]
    Security.SSLCreateContext.restype = SSLContextRef

    Security.SSLSetSessionOption.argtypes = [SSLContextRef, SSLSessionOption, Boolean]
    Security.SSLSetSessionOption.restype = OSStatus

    Security.SSLSetProtocolVersionMin.argtypes = [SSLContextRef, SSLProtocol]
    Security.SSLSetProtocolVersionMin.restype = OSStatus

    Security.SSLSetProtocolVersionMax.argtypes = [SSLContextRef, SSLProtocol]
    Security.SSLSetProtocolVersionMax.restype = OSStatus

    Security.SecCopyErrorMessageString.argtypes = [OSStatus, c_void_p]
    Security.SecCopyErrorMessageString.restype = CFStringRef

    Security.SSLReadFunc = SSLReadFunc
    Security.SSLWriteFunc = SSLWriteFunc
    Security.SSLContextRef = SSLContextRef
    Security.SSLProtocol = SSLProtocol
    Security.SSLCipherSuite = SSLCipherSuite
    Security.SecIdentityRef = SecIdentityRef
    Security.SecKeychainRef = SecKeychainRef
    Security.SecTrustRef = SecTrustRef
    Security.SecTrustResultType = SecTrustResultType
    Security.SecExternalFormat = SecExternalFormat
    Security.OSStatus = OSStatus

    Security.kSecImportExportPassphrase = CFStringRef.in_dll(
        Security, "kSecImportExportPassphrase"
    )
    Security.kSecImportItemIdentity = CFStringRef.in_dll(
        Security, "kSecImportItemIdentity"
    )

    # CoreFoundation time!
    CoreFoundation.CFRetain.argtypes = [CFTypeRef]
    CoreFoundation.CFRetain.restype = CFTypeRef

    CoreFoundation.CFRelease.argtypes = [CFTypeRef]
    CoreFoundation.CFRelease.restype = None

    CoreFoundation.CFGetTypeID.argtypes = [CFTypeRef]
    CoreFoundation.CFGetTypeID.restype = CFTypeID

    CoreFoundation.CFStringCreateWithCString.argtypes = [
        CFAllocatorRef,
        c_char_p,
        CFStringEncoding,
    ]
    CoreFoundation.CFStringCreateWithCString.restype = CFStringRef

    CoreFoundation.CFStringGetCStringPtr.argtypes = [CFStringRef, CFStringEncoding]
    CoreFoundation.CFStringGetCStringPtr.restype = c_char_p

    CoreFoundation.CFStringGetCString.argtypes = [
        CFStringRef,
        c_char_p,
        CFIndex,
        CFStringEncoding,
    ]
    CoreFoundation.CFStringGetCString.restype = c_bool

    CoreFoundation.CFDataCreate.argtypes = [CFAllocatorRef, c_char_p, CFIndex]
    CoreFoundation.CFDataCreate.restype = CFDataRef

    CoreFoundation.CFDataGetLength.argtypes = [CFDataRef]
    CoreFoundation.CFDataGetLength.restype = CFIndex

    CoreFoundation.CFDataGetBytePtr.argtypes = [CFDataRef]
    CoreFoundation.CFDataGetBytePtr.restype = c_void_p

    CoreFoundation.CFDictionaryCreate.argtypes = [
        CFAllocatorRef,
        POINTER(CFTypeRef),
        POINTER(CFTypeRef),
        CFIndex,
        CFDictionaryKeyCallBacks,
        CFDictionaryValueCallBacks,
    ]
    CoreFoundation.CFDictionaryCreate.restype = CFDictionaryRef

    CoreFoundation.CFDictionaryGetValue.argtypes = [CFDictionaryRef, CFTypeRef]
    CoreFoundation.CFDictionaryGetValue.restype = CFTypeRef

    CoreFoundation.CFArrayCreate.argtypes = [
        CFAllocatorRef,
        POINTER(CFTypeRef),
        CFIndex,
        CFArrayCallBacks,
    ]
    CoreFoundation.CFArrayCreate.restype = CFArrayRef

    CoreFoundation.CFArrayCreateMutable.argtypes = [
        CFAllocatorRef,
        CFIndex,
        CFArrayCallBacks,
    ]
    CoreFoundation.CFArrayCreateMutable.restype = CFMutableArrayRef

    CoreFoundation.CFArrayAppendValue.argtypes = [CFMutableArrayRef, c_void_p]
    CoreFoundation.CFArrayAppendValue.restype = None

    CoreFoundation.CFArrayGetCount.argtypes = [CFArrayRef]
    CoreFoundation.CFArrayGetCount.restype = CFIndex

    CoreFoundation.CFArrayGetValueAtIndex.argtypes = [CFArrayRef, CFIndex]
    CoreFoundation.CFArrayGetValueAtIndex.restype = c_void_p

    CoreFoundation.kCFAllocatorDefault = CFAllocatorRef.in_dll(
        CoreFoundation, "kCFAllocatorDefault"
    )
    CoreFoundation.kCFTypeArrayCallBacks = c_void_p.in_dll(
        CoreFoundation, "kCFTypeArrayCallBacks"
    )
    CoreFoundation.kCFTypeDictionaryKeyCallBacks = c_void_p.in_dll(
        CoreFoundation, "kCFTypeDictionaryKeyCallBacks"
    )
    CoreFoundation.kCFTypeDictionaryValueCallBacks = c_void_p.in_dll(
        CoreFoundation, "kCFTypeDictionaryValueCallBacks"
    )

    CoreFoundation.CFTypeRef = CFTypeRef
    CoreFoundation.CFArrayRef = CFArrayRef
    CoreFoundation.CFStringRef = CFStringRef
    CoreFoundation.CFDictionaryRef = CFDictionaryRef

except (AttributeError):
    raise ImportError("Error initializing ctypes")


class CFConst(object):
    """
    A class object that acts as essentially a namespace for CoreFoundation
    constants.
    """

    kCFStringEncodingUTF8 = CFStringEncoding(0x08000100)


class SecurityConst(object):
    """
    A class object that acts as essentially a namespace for Security constants.
    """

    kSSLSessionOptionBreakOnServerAuth = 0

    kSSLProtocol2 = 1
    kSSLProtocol3 = 2
    kTLSProtocol1 = 4
    kTLSProtocol11 = 7
    kTLSProtocol12 = 8
    kTLSProtocol13 = 10
    kTLSProtocolMaxSupported = 999

    kSSLClientSide = 1
    kSSLStreamType = 0

    kSecFormatPEMSequence = 10

    kSecTrustResultInvalid = 0
    kSecTrustResultProceed = 1
    # This gap is present on purpose: this was kSecTrustResultConfirm, which
    # is deprecated.
    kSecTrustResultDeny = 3
    kSecTrustResultUnspecified = 4
    kSecTrustResultRecoverableTrustFailure = 5
    kSecTrustResultFatalTrustFailure = 6
    kSecTrustResultOtherError = 7

    errSSLProtocol = -9800
    errSSLWouldBlock = -9803
    errSSLClosedGraceful = -9805
    errSSLClosedNoNotify = -9816
    errSSLClosedAbort = -9806

    errSSLXCertChainInvalid = -9807
    errSSLCrypto = -9809
    errSSLInternal = -9810
    errSSLCertExpired = -9814
    errSSLCertNotYetValid = -9815
    errSSLUnknownRootCert = -9812
    errSSLNoRootCert = -9813
    errSSLHostNameMismatch = -9843
    errSSLPeerHandshakeFail = -9824
    errSSLPeerUserCancelled = -9839
    errSSLWeakPeerEphemeralDHKey = -9850
    errSSLServerAuthCompleted = -9841
    errSSLRecordOverflow = -9847

    errSecVerifyFailed = -67808
    errSecNoTrustSettings = -25263
    errSecItemNotFound = -25300
    errSecInvalidTrustSettings = -25262

    # Cipher suites. We only pick the ones our default cipher string allows.
    # Source: https://developer.apple.com/documentation/security/1550981-ssl_cipher_suite_values
    TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 = 0xC02C
    TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 = 0xC030
    TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 = 0xC02B
    TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 = 0xC02F
    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA9
    TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 = 0xCCA8
    TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 = 0x009F
    TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 = 0x009E
    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 = 0xC024
    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 = 0xC028
    TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA = 0xC00A
    TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA = 0xC014
    TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 = 0x006B
    TLS_DHE_RSA_WITH_AES_256_CBC_SHA = 0x0039
    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 = 0xC023
    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 = 0xC027
    TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA = 0xC009
    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA = 0xC013
    TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 = 0x0067
    TLS_DHE_RSA_WITH_AES_128_CBC_SHA = 0x0033
    TLS_RSA_WITH_AES_256_GCM_SHA384 = 0x009D
    TLS_RSA_WITH_AES_128_GCM_SHA256 = 0x009C
    TLS_RSA_WITH_AES_256_CBC_SHA256 = 0x003D
    TLS_RSA_WITH_AES_128_CBC_SHA256 = 0x003C
    TLS_RSA_WITH_AES_256_CBC_SHA = 0x0035
    TLS_RSA_WITH_AES_128_CBC_SHA = 0x002F
    TLS_AES_128_GCM_SHA256 = 0x1301
    TLS_AES_256_GCM_SHA384 = 0x1302
    TLS_AES_128_CCM_8_SHA256 = 0x1305
    TLS_AES_128_CCM_SHA256 = 0x1304
site-packages/pip/_vendor/urllib3/request.py000064400000013602151446177000015135 0ustar00from __future__ import absolute_import

from .filepost import encode_multipart_formdata
from .packages.six.moves.urllib.parse import urlencode


__all__ = ["RequestMethods"]


class RequestMethods(object):
    """
    Convenience mixin for classes who implement a :meth:`urlopen` method, such
    as :class:`~urllib3.connectionpool.HTTPConnectionPool` and
    :class:`~urllib3.poolmanager.PoolManager`.

    Provides behavior for making common types of HTTP request methods and
    decides which type of request field encoding to use.

    Specifically,

    :meth:`.request_encode_url` is for sending requests whose fields are
    encoded in the URL (such as GET, HEAD, DELETE).

    :meth:`.request_encode_body` is for sending requests whose fields are
    encoded in the *body* of the request using multipart or www-form-urlencoded
    (such as for POST, PUT, PATCH).

    :meth:`.request` is for making any kind of request, it will look up the
    appropriate encoding format and use one of the above two methods to make
    the request.

    Initializer parameters:

    :param headers:
        Headers to include with all requests, unless other headers are given
        explicitly.
    """

    _encode_url_methods = {"DELETE", "GET", "HEAD", "OPTIONS"}

    def __init__(self, headers=None):
        self.headers = headers or {}

    def urlopen(
        self,
        method,
        url,
        body=None,
        headers=None,
        encode_multipart=True,
        multipart_boundary=None,
        **kw
    ):  # Abstract
        raise NotImplementedError(
            "Classes extending RequestMethods must implement "
            "their own ``urlopen`` method."
        )

    def request(self, method, url, fields=None, headers=None, **urlopen_kw):
        """
        Make a request using :meth:`urlopen` with the appropriate encoding of
        ``fields`` based on the ``method`` used.

        This is a convenience method that requires the least amount of manual
        effort. It can be used in most situations, while still having the
        option to drop down to more specific methods when necessary, such as
        :meth:`request_encode_url`, :meth:`request_encode_body`,
        or even the lowest level :meth:`urlopen`.
        """
        method = method.upper()

        urlopen_kw["request_url"] = url

        if method in self._encode_url_methods:
            return self.request_encode_url(
                method, url, fields=fields, headers=headers, **urlopen_kw
            )
        else:
            return self.request_encode_body(
                method, url, fields=fields, headers=headers, **urlopen_kw
            )

    def request_encode_url(self, method, url, fields=None, headers=None, **urlopen_kw):
        """
        Make a request using :meth:`urlopen` with the ``fields`` encoded in
        the url. This is useful for request methods like GET, HEAD, DELETE, etc.
        """
        if headers is None:
            headers = self.headers

        extra_kw = {"headers": headers}
        extra_kw.update(urlopen_kw)

        if fields:
            url += "?" + urlencode(fields)

        return self.urlopen(method, url, **extra_kw)

    def request_encode_body(
        self,
        method,
        url,
        fields=None,
        headers=None,
        encode_multipart=True,
        multipart_boundary=None,
        **urlopen_kw
    ):
        """
        Make a request using :meth:`urlopen` with the ``fields`` encoded in
        the body. This is useful for request methods like POST, PUT, PATCH, etc.

        When ``encode_multipart=True`` (default), then
        :meth:`urllib3.filepost.encode_multipart_formdata` is used to encode
        the payload with the appropriate content type. Otherwise
        :meth:`urllib.urlencode` is used with the
        'application/x-www-form-urlencoded' content type.

        Multipart encoding must be used when posting files, and it's reasonably
        safe to use it in other times too. However, it may break request
        signing, such as with OAuth.

        Supports an optional ``fields`` parameter of key/value strings AND
        key/filetuple. A filetuple is a (filename, data, MIME type) tuple where
        the MIME type is optional. For example::

            fields = {
                'foo': 'bar',
                'fakefile': ('foofile.txt', 'contents of foofile'),
                'realfile': ('barfile.txt', open('realfile').read()),
                'typedfile': ('bazfile.bin', open('bazfile').read(),
                              'image/jpeg'),
                'nonamefile': 'contents of nonamefile field',
            }

        When uploading a file, providing a filename (the first parameter of the
        tuple) is optional but recommended to best mimic behavior of browsers.

        Note that if ``headers`` are supplied, the 'Content-Type' header will
        be overwritten because it depends on the dynamic random boundary string
        which is used to compose the body of the request. The random boundary
        string can be explicitly set with the ``multipart_boundary`` parameter.
        """
        if headers is None:
            headers = self.headers

        extra_kw = {"headers": {}}

        if fields:
            if "body" in urlopen_kw:
                raise TypeError(
                    "request got values for both 'fields' and 'body', can only specify one."
                )

            if encode_multipart:
                body, content_type = encode_multipart_formdata(
                    fields, boundary=multipart_boundary
                )
            else:
                body, content_type = (
                    urlencode(fields),
                    "application/x-www-form-urlencoded",
                )

            extra_kw["body"] = body
            extra_kw["headers"] = {"Content-Type": content_type}

        extra_kw["headers"].update(headers)
        extra_kw.update(urlopen_kw)

        return self.urlopen(method, url, **extra_kw)
site-packages/pip/_vendor/urllib3/exceptions.py000064400000014722151446177000015632 0ustar00from __future__ import absolute_import
from .packages.six.moves.http_client import IncompleteRead as httplib_IncompleteRead

# Base Exceptions


class HTTPError(Exception):
    "Base exception used by this module."
    pass


class HTTPWarning(Warning):
    "Base warning used by this module."
    pass


class PoolError(HTTPError):
    "Base exception for errors caused within a pool."

    def __init__(self, pool, message):
        self.pool = pool
        HTTPError.__init__(self, "%s: %s" % (pool, message))

    def __reduce__(self):
        # For pickling purposes.
        return self.__class__, (None, None)


class RequestError(PoolError):
    "Base exception for PoolErrors that have associated URLs."

    def __init__(self, pool, url, message):
        self.url = url
        PoolError.__init__(self, pool, message)

    def __reduce__(self):
        # For pickling purposes.
        return self.__class__, (None, self.url, None)


class SSLError(HTTPError):
    "Raised when SSL certificate fails in an HTTPS connection."
    pass


class ProxyError(HTTPError):
    "Raised when the connection to a proxy fails."
    pass


class DecodeError(HTTPError):
    "Raised when automatic decoding based on Content-Type fails."
    pass


class ProtocolError(HTTPError):
    "Raised when something unexpected happens mid-request/response."
    pass


#: Renamed to ProtocolError but aliased for backwards compatibility.
ConnectionError = ProtocolError


# Leaf Exceptions


class MaxRetryError(RequestError):
    """Raised when the maximum number of retries is exceeded.

    :param pool: The connection pool
    :type pool: :class:`~urllib3.connectionpool.HTTPConnectionPool`
    :param string url: The requested Url
    :param exceptions.Exception reason: The underlying error

    """

    def __init__(self, pool, url, reason=None):
        self.reason = reason

        message = "Max retries exceeded with url: %s (Caused by %r)" % (url, reason)

        RequestError.__init__(self, pool, url, message)


class HostChangedError(RequestError):
    "Raised when an existing pool gets a request for a foreign host."

    def __init__(self, pool, url, retries=3):
        message = "Tried to open a foreign host with url: %s" % url
        RequestError.__init__(self, pool, url, message)
        self.retries = retries


class TimeoutStateError(HTTPError):
    """ Raised when passing an invalid state to a timeout """

    pass


class TimeoutError(HTTPError):
    """ Raised when a socket timeout error occurs.

    Catching this error will catch both :exc:`ReadTimeoutErrors
    <ReadTimeoutError>` and :exc:`ConnectTimeoutErrors <ConnectTimeoutError>`.
    """

    pass


class ReadTimeoutError(TimeoutError, RequestError):
    "Raised when a socket timeout occurs while receiving data from a server"
    pass


# This timeout error does not have a URL attached and needs to inherit from the
# base HTTPError
class ConnectTimeoutError(TimeoutError):
    "Raised when a socket timeout occurs while connecting to a server"
    pass


class NewConnectionError(ConnectTimeoutError, PoolError):
    "Raised when we fail to establish a new connection. Usually ECONNREFUSED."
    pass


class EmptyPoolError(PoolError):
    "Raised when a pool runs out of connections and no more are allowed."
    pass


class ClosedPoolError(PoolError):
    "Raised when a request enters a pool after the pool has been closed."
    pass


class LocationValueError(ValueError, HTTPError):
    "Raised when there is something wrong with a given URL input."
    pass


class LocationParseError(LocationValueError):
    "Raised when get_host or similar fails to parse the URL input."

    def __init__(self, location):
        message = "Failed to parse: %s" % location
        HTTPError.__init__(self, message)

        self.location = location


class ResponseError(HTTPError):
    "Used as a container for an error reason supplied in a MaxRetryError."
    GENERIC_ERROR = "too many error responses"
    SPECIFIC_ERROR = "too many {status_code} error responses"


class SecurityWarning(HTTPWarning):
    "Warned when performing security reducing actions"
    pass


class SubjectAltNameWarning(SecurityWarning):
    "Warned when connecting to a host with a certificate missing a SAN."
    pass


class InsecureRequestWarning(SecurityWarning):
    "Warned when making an unverified HTTPS request."
    pass


class SystemTimeWarning(SecurityWarning):
    "Warned when system time is suspected to be wrong"
    pass


class InsecurePlatformWarning(SecurityWarning):
    "Warned when certain SSL configuration is not available on a platform."
    pass


class SNIMissingWarning(HTTPWarning):
    "Warned when making a HTTPS request without SNI available."
    pass


class DependencyWarning(HTTPWarning):
    """
    Warned when an attempt is made to import a module with missing optional
    dependencies.
    """

    pass


class ResponseNotChunked(ProtocolError, ValueError):
    "Response needs to be chunked in order to read it as chunks."
    pass


class BodyNotHttplibCompatible(HTTPError):
    """
    Body should be httplib.HTTPResponse like (have an fp attribute which
    returns raw chunks) for read_chunked().
    """

    pass


class IncompleteRead(HTTPError, httplib_IncompleteRead):
    """
    Response length doesn't match expected Content-Length

    Subclass of http_client.IncompleteRead to allow int value
    for `partial` to avoid creating large objects on streamed
    reads.
    """

    def __init__(self, partial, expected):
        super(IncompleteRead, self).__init__(partial, expected)

    def __repr__(self):
        return "IncompleteRead(%i bytes read, " "%i more expected)" % (
            self.partial,
            self.expected,
        )


class InvalidHeader(HTTPError):
    "The header provided was somehow invalid."
    pass


class ProxySchemeUnknown(AssertionError, ValueError):
    "ProxyManager does not support the supplied scheme"
    # TODO(t-8ch): Stop inheriting from AssertionError in v2.0.

    def __init__(self, scheme):
        message = "Not supported proxy scheme %s" % scheme
        super(ProxySchemeUnknown, self).__init__(message)


class HeaderParsingError(HTTPError):
    "Raised by assert_header_parsing, but we convert it to a log.warning statement."

    def __init__(self, defects, unparsed_data):
        message = "%s, unparsed data: %r" % (defects or "Unknown", unparsed_data)
        super(HeaderParsingError, self).__init__(message)


class UnrewindableBodyError(HTTPError):
    "urllib3 encountered an error when trying to rewind a body"
    pass
site-packages/pip/_vendor/urllib3/util/timeout.py000064400000023222151446177000016107 0ustar00from __future__ import absolute_import

# The default socket timeout, used by httplib to indicate that no timeout was
# specified by the user
from socket import _GLOBAL_DEFAULT_TIMEOUT
import time

from ..exceptions import TimeoutStateError

# A sentinel value to indicate that no timeout was specified by the user in
# urllib3
_Default = object()


# Use time.monotonic if available.
current_time = getattr(time, "monotonic", time.time)


class Timeout(object):
    """ Timeout configuration.

    Timeouts can be defined as a default for a pool::

        timeout = Timeout(connect=2.0, read=7.0)
        http = PoolManager(timeout=timeout)
        response = http.request('GET', 'http://example.com/')

    Or per-request (which overrides the default for the pool)::

        response = http.request('GET', 'http://example.com/', timeout=Timeout(10))

    Timeouts can be disabled by setting all the parameters to ``None``::

        no_timeout = Timeout(connect=None, read=None)
        response = http.request('GET', 'http://example.com/, timeout=no_timeout)


    :param total:
        This combines the connect and read timeouts into one; the read timeout
        will be set to the time leftover from the connect attempt. In the
        event that both a connect timeout and a total are specified, or a read
        timeout and a total are specified, the shorter timeout will be applied.

        Defaults to None.

    :type total: integer, float, or None

    :param connect:
        The maximum amount of time (in seconds) to wait for a connection
        attempt to a server to succeed. Omitting the parameter will default the
        connect timeout to the system default, probably `the global default
        timeout in socket.py
        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
        None will set an infinite timeout for connection attempts.

    :type connect: integer, float, or None

    :param read:
        The maximum amount of time (in seconds) to wait between consecutive
        read operations for a response from the server. Omitting the parameter
        will default the read timeout to the system default, probably `the
        global default timeout in socket.py
        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
        None will set an infinite timeout.

    :type read: integer, float, or None

    .. note::

        Many factors can affect the total amount of time for urllib3 to return
        an HTTP response.

        For example, Python's DNS resolver does not obey the timeout specified
        on the socket. Other factors that can affect total request time include
        high CPU load, high swap, the program running at a low priority level,
        or other behaviors.

        In addition, the read and total timeouts only measure the time between
        read operations on the socket connecting the client and the server,
        not the total amount of time for the request to return a complete
        response. For most requests, the timeout is raised because the server
        has not sent the first byte in the specified time. This is not always
        the case; if a server streams one byte every fifteen seconds, a timeout
        of 20 seconds will not trigger, even though the request will take
        several minutes to complete.

        If your goal is to cut off any request after a set amount of wall clock
        time, consider having a second "watcher" thread to cut off a slow
        request.
    """

    #: A sentinel object representing the default timeout value
    DEFAULT_TIMEOUT = _GLOBAL_DEFAULT_TIMEOUT

    def __init__(self, total=None, connect=_Default, read=_Default):
        self._connect = self._validate_timeout(connect, "connect")
        self._read = self._validate_timeout(read, "read")
        self.total = self._validate_timeout(total, "total")
        self._start_connect = None

    def __str__(self):
        return "%s(connect=%r, read=%r, total=%r)" % (
            type(self).__name__,
            self._connect,
            self._read,
            self.total,
        )

    @classmethod
    def _validate_timeout(cls, value, name):
        """ Check that a timeout attribute is valid.

        :param value: The timeout value to validate
        :param name: The name of the timeout attribute to validate. This is
            used to specify in error messages.
        :return: The validated and casted version of the given value.
        :raises ValueError: If it is a numeric value less than or equal to
            zero, or the type is not an integer, float, or None.
        """
        if value is _Default:
            return cls.DEFAULT_TIMEOUT

        if value is None or value is cls.DEFAULT_TIMEOUT:
            return value

        if isinstance(value, bool):
            raise ValueError(
                "Timeout cannot be a boolean value. It must "
                "be an int, float or None."
            )
        try:
            float(value)
        except (TypeError, ValueError):
            raise ValueError(
                "Timeout value %s was %s, but it must be an "
                "int, float or None." % (name, value)
            )

        try:
            if value <= 0:
                raise ValueError(
                    "Attempted to set %s timeout to %s, but the "
                    "timeout cannot be set to a value less "
                    "than or equal to 0." % (name, value)
                )
        except TypeError:
            # Python 3
            raise ValueError(
                "Timeout value %s was %s, but it must be an "
                "int, float or None." % (name, value)
            )

        return value

    @classmethod
    def from_float(cls, timeout):
        """ Create a new Timeout from a legacy timeout value.

        The timeout value used by httplib.py sets the same timeout on the
        connect(), and recv() socket requests. This creates a :class:`Timeout`
        object that sets the individual timeouts to the ``timeout`` value
        passed to this function.

        :param timeout: The legacy timeout value.
        :type timeout: integer, float, sentinel default object, or None
        :return: Timeout object
        :rtype: :class:`Timeout`
        """
        return Timeout(read=timeout, connect=timeout)

    def clone(self):
        """ Create a copy of the timeout object

        Timeout properties are stored per-pool but each request needs a fresh
        Timeout object to ensure each one has its own start/stop configured.

        :return: a copy of the timeout object
        :rtype: :class:`Timeout`
        """
        # We can't use copy.deepcopy because that will also create a new object
        # for _GLOBAL_DEFAULT_TIMEOUT, which socket.py uses as a sentinel to
        # detect the user default.
        return Timeout(connect=self._connect, read=self._read, total=self.total)

    def start_connect(self):
        """ Start the timeout clock, used during a connect() attempt

        :raises urllib3.exceptions.TimeoutStateError: if you attempt
            to start a timer that has been started already.
        """
        if self._start_connect is not None:
            raise TimeoutStateError("Timeout timer has already been started.")
        self._start_connect = current_time()
        return self._start_connect

    def get_connect_duration(self):
        """ Gets the time elapsed since the call to :meth:`start_connect`.

        :return: Elapsed time in seconds.
        :rtype: float
        :raises urllib3.exceptions.TimeoutStateError: if you attempt
            to get duration for a timer that hasn't been started.
        """
        if self._start_connect is None:
            raise TimeoutStateError(
                "Can't get connect duration for timer " "that has not started."
            )
        return current_time() - self._start_connect

    @property
    def connect_timeout(self):
        """ Get the value to use when setting a connection timeout.

        This will be a positive float or integer, the value None
        (never timeout), or the default system timeout.

        :return: Connect timeout.
        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
        """
        if self.total is None:
            return self._connect

        if self._connect is None or self._connect is self.DEFAULT_TIMEOUT:
            return self.total

        return min(self._connect, self.total)

    @property
    def read_timeout(self):
        """ Get the value for the read timeout.

        This assumes some time has elapsed in the connection timeout and
        computes the read timeout appropriately.

        If self.total is set, the read timeout is dependent on the amount of
        time taken by the connect timeout. If the connection time has not been
        established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
        raised.

        :return: Value to use for the read timeout.
        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
        :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
            has not yet been called on this object.
        """
        if (
            self.total is not None
            and self.total is not self.DEFAULT_TIMEOUT
            and self._read is not None
            and self._read is not self.DEFAULT_TIMEOUT
        ):
            # In case the connect timeout has not yet been established.
            if self._start_connect is None:
                return self._read
            return max(0, min(self.total - self.get_connect_duration(), self._read))
        elif self.total is not None and self.total is not self.DEFAULT_TIMEOUT:
            return max(0, self.total - self.get_connect_duration())
        else:
            return self._read
site-packages/pip/_vendor/urllib3/util/retry.py000064400000036132151446177000015572 0ustar00from __future__ import absolute_import
import time
import logging
from collections import namedtuple
from itertools import takewhile
import email
import re

from ..exceptions import (
    ConnectTimeoutError,
    MaxRetryError,
    ProtocolError,
    ReadTimeoutError,
    ResponseError,
    InvalidHeader,
)
from ..packages import six


log = logging.getLogger(__name__)


# Data structure for representing the metadata of requests that result in a retry.
RequestHistory = namedtuple(
    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
)


class Retry(object):
    """ Retry configuration.

    Each retry attempt will create a new Retry object with updated values, so
    they can be safely reused.

    Retries can be defined as a default for a pool::

        retries = Retry(connect=5, read=2, redirect=5)
        http = PoolManager(retries=retries)
        response = http.request('GET', 'http://example.com/')

    Or per-request (which overrides the default for the pool)::

        response = http.request('GET', 'http://example.com/', retries=Retry(10))

    Retries can be disabled by passing ``False``::

        response = http.request('GET', 'http://example.com/', retries=False)

    Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
    retries are disabled, in which case the causing exception will be raised.

    :param int total:
        Total number of retries to allow. Takes precedence over other counts.

        Set to ``None`` to remove this constraint and fall back on other
        counts. It's a good idea to set this to some sensibly-high value to
        account for unexpected edge cases and avoid infinite retry loops.

        Set to ``0`` to fail on the first retry.

        Set to ``False`` to disable and imply ``raise_on_redirect=False``.

    :param int connect:
        How many connection-related errors to retry on.

        These are errors raised before the request is sent to the remote server,
        which we assume has not triggered the server to process the request.

        Set to ``0`` to fail on the first retry of this type.

    :param int read:
        How many times to retry on read errors.

        These errors are raised after the request was sent to the server, so the
        request may have side-effects.

        Set to ``0`` to fail on the first retry of this type.

    :param int redirect:
        How many redirects to perform. Limit this to avoid infinite redirect
        loops.

        A redirect is a HTTP response with a status code 301, 302, 303, 307 or
        308.

        Set to ``0`` to fail on the first retry of this type.

        Set to ``False`` to disable and imply ``raise_on_redirect=False``.

    :param int status:
        How many times to retry on bad status codes.

        These are retries made on responses, where status code matches
        ``status_forcelist``.

        Set to ``0`` to fail on the first retry of this type.

    :param iterable method_whitelist:
        Set of uppercased HTTP method verbs that we should retry on.

        By default, we only retry on methods which are considered to be
        idempotent (multiple requests with the same parameters end with the
        same state). See :attr:`Retry.DEFAULT_METHOD_WHITELIST`.

        Set to a ``False`` value to retry on any verb.

    :param iterable status_forcelist:
        A set of integer HTTP status codes that we should force a retry on.
        A retry is initiated if the request method is in ``method_whitelist``
        and the response status code is in ``status_forcelist``.

        By default, this is disabled with ``None``.

    :param float backoff_factor:
        A backoff factor to apply between attempts after the second try
        (most errors are resolved immediately by a second try without a
        delay). urllib3 will sleep for::

            {backoff factor} * (2 ** ({number of total retries} - 1))

        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
        than :attr:`Retry.BACKOFF_MAX`.

        By default, backoff is disabled (set to 0).

    :param bool raise_on_redirect: Whether, if the number of redirects is
        exhausted, to raise a MaxRetryError, or to return a response with a
        response code in the 3xx range.

    :param bool raise_on_status: Similar meaning to ``raise_on_redirect``:
        whether we should raise an exception, or return a response,
        if status falls in ``status_forcelist`` range and retries have
        been exhausted.

    :param tuple history: The history of the request encountered during
        each call to :meth:`~Retry.increment`. The list is in the order
        the requests occurred. Each list item is of class :class:`RequestHistory`.

    :param bool respect_retry_after_header:
        Whether to respect Retry-After header on status codes defined as
        :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.

    :param iterable remove_headers_on_redirect:
        Sequence of headers to remove from the request when a response
        indicating a redirect is returned before firing off the redirected
        request.
    """

    DEFAULT_METHOD_WHITELIST = frozenset(
        ["HEAD", "GET", "PUT", "DELETE", "OPTIONS", "TRACE"]
    )

    RETRY_AFTER_STATUS_CODES = frozenset([413, 429, 503])

    DEFAULT_REDIRECT_HEADERS_BLACKLIST = frozenset(["Authorization"])

    #: Maximum backoff time.
    BACKOFF_MAX = 120

    def __init__(
        self,
        total=10,
        connect=None,
        read=None,
        redirect=None,
        status=None,
        method_whitelist=DEFAULT_METHOD_WHITELIST,
        status_forcelist=None,
        backoff_factor=0,
        raise_on_redirect=True,
        raise_on_status=True,
        history=None,
        respect_retry_after_header=True,
        remove_headers_on_redirect=DEFAULT_REDIRECT_HEADERS_BLACKLIST,
    ):

        self.total = total
        self.connect = connect
        self.read = read
        self.status = status

        if redirect is False or total is False:
            redirect = 0
            raise_on_redirect = False

        self.redirect = redirect
        self.status_forcelist = status_forcelist or set()
        self.method_whitelist = method_whitelist
        self.backoff_factor = backoff_factor
        self.raise_on_redirect = raise_on_redirect
        self.raise_on_status = raise_on_status
        self.history = history or tuple()
        self.respect_retry_after_header = respect_retry_after_header
        self.remove_headers_on_redirect = frozenset(
            [h.lower() for h in remove_headers_on_redirect]
        )

    def new(self, **kw):
        params = dict(
            total=self.total,
            connect=self.connect,
            read=self.read,
            redirect=self.redirect,
            status=self.status,
            method_whitelist=self.method_whitelist,
            status_forcelist=self.status_forcelist,
            backoff_factor=self.backoff_factor,
            raise_on_redirect=self.raise_on_redirect,
            raise_on_status=self.raise_on_status,
            history=self.history,
            remove_headers_on_redirect=self.remove_headers_on_redirect,
            respect_retry_after_header=self.respect_retry_after_header,
        )
        params.update(kw)
        return type(self)(**params)

    @classmethod
    def from_int(cls, retries, redirect=True, default=None):
        """ Backwards-compatibility for the old retries format."""
        if retries is None:
            retries = default if default is not None else cls.DEFAULT

        if isinstance(retries, Retry):
            return retries

        redirect = bool(redirect) and None
        new_retries = cls(retries, redirect=redirect)
        log.debug("Converted retries value: %r -> %r", retries, new_retries)
        return new_retries

    def get_backoff_time(self):
        """ Formula for computing the current backoff

        :rtype: float
        """
        # We want to consider only the last consecutive errors sequence (Ignore redirects).
        consecutive_errors_len = len(
            list(
                takewhile(lambda x: x.redirect_location is None, reversed(self.history))
            )
        )
        if consecutive_errors_len <= 1:
            return 0

        backoff_value = self.backoff_factor * (2 ** (consecutive_errors_len - 1))
        return min(self.BACKOFF_MAX, backoff_value)

    def parse_retry_after(self, retry_after):
        # Whitespace: https://tools.ietf.org/html/rfc7230#section-3.2.4
        if re.match(r"^\s*[0-9]+\s*$", retry_after):
            seconds = int(retry_after)
        else:
            retry_date_tuple = email.utils.parsedate(retry_after)
            if retry_date_tuple is None:
                raise InvalidHeader("Invalid Retry-After header: %s" % retry_after)
            retry_date = time.mktime(retry_date_tuple)
            seconds = retry_date - time.time()

        if seconds < 0:
            seconds = 0

        return seconds

    def get_retry_after(self, response):
        """ Get the value of Retry-After in seconds. """

        retry_after = response.getheader("Retry-After")

        if retry_after is None:
            return None

        return self.parse_retry_after(retry_after)

    def sleep_for_retry(self, response=None):
        retry_after = self.get_retry_after(response)
        if retry_after:
            time.sleep(retry_after)
            return True

        return False

    def _sleep_backoff(self):
        backoff = self.get_backoff_time()
        if backoff <= 0:
            return
        time.sleep(backoff)

    def sleep(self, response=None):
        """ Sleep between retry attempts.

        This method will respect a server's ``Retry-After`` response header
        and sleep the duration of the time requested. If that is not present, it
        will use an exponential backoff. By default, the backoff factor is 0 and
        this method will return immediately.
        """

        if self.respect_retry_after_header and response:
            slept = self.sleep_for_retry(response)
            if slept:
                return

        self._sleep_backoff()

    def _is_connection_error(self, err):
        """ Errors when we're fairly sure that the server did not receive the
        request, so it should be safe to retry.
        """
        return isinstance(err, ConnectTimeoutError)

    def _is_read_error(self, err):
        """ Errors that occur after the request has been started, so we should
        assume that the server began processing it.
        """
        return isinstance(err, (ReadTimeoutError, ProtocolError))

    def _is_method_retryable(self, method):
        """ Checks if a given HTTP method should be retried upon, depending if
        it is included on the method whitelist.
        """
        if self.method_whitelist and method.upper() not in self.method_whitelist:
            return False

        return True

    def is_retry(self, method, status_code, has_retry_after=False):
        """ Is this method/status code retryable? (Based on whitelists and control
        variables such as the number of total retries to allow, whether to
        respect the Retry-After header, whether this header is present, and
        whether the returned status code is on the list of status codes to
        be retried upon on the presence of the aforementioned header)
        """
        if not self._is_method_retryable(method):
            return False

        if self.status_forcelist and status_code in self.status_forcelist:
            return True

        return (
            self.total
            and self.respect_retry_after_header
            and has_retry_after
            and (status_code in self.RETRY_AFTER_STATUS_CODES)
        )

    def is_exhausted(self):
        """ Are we out of retries? """
        retry_counts = (self.total, self.connect, self.read, self.redirect, self.status)
        retry_counts = list(filter(None, retry_counts))
        if not retry_counts:
            return False

        return min(retry_counts) < 0

    def increment(
        self,
        method=None,
        url=None,
        response=None,
        error=None,
        _pool=None,
        _stacktrace=None,
    ):
        """ Return a new Retry object with incremented retry counters.

        :param response: A response object, or None, if the server did not
            return a response.
        :type response: :class:`~urllib3.response.HTTPResponse`
        :param Exception error: An error encountered during the request, or
            None if the response was received successfully.

        :return: A new ``Retry`` object.
        """
        if self.total is False and error:
            # Disabled, indicate to re-raise the error.
            raise six.reraise(type(error), error, _stacktrace)

        total = self.total
        if total is not None:
            total -= 1

        connect = self.connect
        read = self.read
        redirect = self.redirect
        status_count = self.status
        cause = "unknown"
        status = None
        redirect_location = None

        if error and self._is_connection_error(error):
            # Connect retry?
            if connect is False:
                raise six.reraise(type(error), error, _stacktrace)
            elif connect is not None:
                connect -= 1

        elif error and self._is_read_error(error):
            # Read retry?
            if read is False or not self._is_method_retryable(method):
                raise six.reraise(type(error), error, _stacktrace)
            elif read is not None:
                read -= 1

        elif response and response.get_redirect_location():
            # Redirect retry?
            if redirect is not None:
                redirect -= 1
            cause = "too many redirects"
            redirect_location = response.get_redirect_location()
            status = response.status

        else:
            # Incrementing because of a server error like a 500 in
            # status_forcelist and a the given method is in the whitelist
            cause = ResponseError.GENERIC_ERROR
            if response and response.status:
                if status_count is not None:
                    status_count -= 1
                cause = ResponseError.SPECIFIC_ERROR.format(status_code=response.status)
                status = response.status

        history = self.history + (
            RequestHistory(method, url, error, status, redirect_location),
        )

        new_retry = self.new(
            total=total,
            connect=connect,
            read=read,
            redirect=redirect,
            status=status_count,
            history=history,
        )

        if new_retry.is_exhausted():
            raise MaxRetryError(_pool, url, error or ResponseError(cause))

        log.debug("Incremented Retry for (url='%s'): %r", url, new_retry)

        return new_retry

    def __repr__(self):
        return (
            "{cls.__name__}(total={self.total}, connect={self.connect}, "
            "read={self.read}, redirect={self.redirect}, status={self.status})"
        ).format(cls=type(self), self=self)


# For backwards compatibility (equivalent to pre-v1.9):
Retry.DEFAULT = Retry(3)
site-packages/pip/_vendor/urllib3/util/response.py000064400000005015151446177000016257 0ustar00from __future__ import absolute_import
from ..packages.six.moves import http_client as httplib

from ..exceptions import HeaderParsingError


def is_fp_closed(obj):
    """
    Checks whether a given file-like object is closed.

    :param obj:
        The file-like object to check.
    """

    try:
        # Check `isclosed()` first, in case Python3 doesn't set `closed`.
        # GH Issue #928
        return obj.isclosed()
    except AttributeError:
        pass

    try:
        # Check via the official file-like-object way.
        return obj.closed
    except AttributeError:
        pass

    try:
        # Check if the object is a container for another file-like object that
        # gets released on exhaustion (e.g. HTTPResponse).
        return obj.fp is None
    except AttributeError:
        pass

    raise ValueError("Unable to determine whether fp is closed.")


def assert_header_parsing(headers):
    """
    Asserts whether all headers have been successfully parsed.
    Extracts encountered errors from the result of parsing headers.

    Only works on Python 3.

    :param headers: Headers to verify.
    :type headers: `httplib.HTTPMessage`.

    :raises urllib3.exceptions.HeaderParsingError:
        If parsing errors are found.
    """

    # This will fail silently if we pass in the wrong kind of parameter.
    # To make debugging easier add an explicit check.
    if not isinstance(headers, httplib.HTTPMessage):
        raise TypeError("expected httplib.Message, got {0}.".format(type(headers)))

    defects = getattr(headers, "defects", None)
    get_payload = getattr(headers, "get_payload", None)

    unparsed_data = None
    if get_payload:
        # get_payload is actually email.message.Message.get_payload;
        # we're only interested in the result if it's not a multipart message
        if not headers.is_multipart():
            payload = get_payload()

            if isinstance(payload, (bytes, str)):
                unparsed_data = payload

    if defects or unparsed_data:
        raise HeaderParsingError(defects=defects, unparsed_data=unparsed_data)


def is_response_to_head(response):
    """
    Checks whether the request of a response has been a HEAD-request.
    Handles the quirks of AppEngine.

    :param conn:
    :type conn: :class:`httplib.HTTPResponse`
    """
    # FIXME: Can we do this somehow without accessing private httplib _method?
    method = response._method
    if isinstance(method, int):  # Platform-specific: Appengine
        return method == 3
    return method.upper() == "HEAD"
site-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-38.opt-1.pyc000064400000006005151446177000022612 0ustar00U

��.e�@s�ddlZddlmZddlZddlZzddlmZWn ek
rTddlmZYnXdddgZGdd�de	�Z
ejd	kr�d
d�Zndd�Zddd�Z
ddd�Zdd�Zdd�Zdd�addd�Zddd�ZdS)�N)�partial)�	monotonic)�time�NoWayToWaitForSocketError�
wait_for_read�wait_for_writec@seZdZdS)rN)�__name__�
__module__�__qualname__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/wait.pyrs)��cCs||�S)Nr)�fn�timeoutrrr�_retry_on_intr*src
Cs�|dkrtd�}n
t�|}z
||�WSttjfk
r�}zF|jdtjkrR�n.|t�}|dkrhd}|td�krxd}WY�qW5d}~XYqXqdS)N�infr)�floatr�OSError�select�error�args�errnoZEINTR)rrZdeadline�errrr0s



Fc
Csd|s|std��g}g}|r&|�|�|r4|�|�ttj|||�}t||�\}}}	t|p`|p`|	�S)N�2must specify at least one of read=True, write=True)�RuntimeError�appendrrr�bool)
�sock�read�writerZrcheckZwcheckrZrreadyZwreadyZxreadyrrr�select_wait_for_socketGs

r!cs^|s|std��d}|r"|tjO}|r0|tjO}t�����||��fdd�}tt||��S)Nrrcs|dk	r|d9}��|�S)Ni�)�poll)�t�Zpoll_objrr�do_pollfsz%poll_wait_for_socket.<locals>.do_poll)rrZPOLLINZPOLLOUTr"�registerrr)rrr r�maskr%rr$r�poll_wait_for_socketZs

r(cOstd��dS)Nzno select-equivalent available)r�r�kwargsrrr�null_wait_for_socketnsr+c	Cs<zt��}t|jd�Wnttfk
r2YdSXdSdS)NrFT)rr"r�AttributeErrorrr$rrr�_have_working_pollrsr-cOs*t�rtanttd�rtantat||�S)Nr)r-r(�wait_for_socket�hasattrrr!r+r)rrrr.s
r.cCst|d|d�S)z� Waits for reading to be available on a given socket.
    Returns True if the socket is readable, or False if the timeout expired.
    T)rr�r.�rrrrrr�scCst|d|d�S)z� Waits for writing to be available on a given socket.
    Returns True if the socket is readable, or False if the timeout expired.
    T)r rr0r1rrrr�s)FFN)FFN)N)N)r�	functoolsrr�sysrr�ImportError�__all__�	Exceptionr�version_inforr!r(r+r-r.rrrrrr�<module>s&






site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001727151446177000023413 0ustar00U

��.e�@s�ddlmZddlmZddlmZddlmZddlm	Z	m
Z
mZmZm
Z
mZmZmZmZddlmZmZddlmZdd	lmZmZmZmZdd
lmZmZdZdS)
�)�absolute_import�)�is_connection_dropped)�make_headers)�is_fp_closed)	�
SSLContext�HAS_SNI�IS_PYOPENSSL�IS_SECURETRANSPORT�assert_fingerprint�resolve_cert_reqs�resolve_ssl_version�ssl_wrap_socket�PROTOCOL_TLS)�current_time�Timeout)�Retry)�get_host�	parse_url�split_first�Url)�
wait_for_read�wait_for_write)rr	r
rrrrrrrrrrrrrr
rrrrN) Z
__future__rZ
connectionrZrequestrZresponserZssl_rrr	r
rrr
rrZtimeoutrrZretryrZurlrrrr�waitrr�__all__�rr�E/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/__init__.py�<module>s,site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-38.opt-1.pyc000064400000002004151446177000022765 0ustar00U

��.e��@sDddlZddlmZddlmZejr.ddlZGdd�dej�ZdS)�N�)�six��queuec@s0eZdZdd�Zefdd�Zdd�Zdd�Zd	S)
�	LifoQueuecCst��|_dS�N)�collections�dequer)�self�_�r�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/queue.py�_initszLifoQueue._initcCs
||j�Srr)r
�lenrrr
�_qsizeszLifoQueue._qsizecCs|j�|�dSr)r�append)r
�itemrrr
�_putszLifoQueue._putcCs
|j��Sr)r�pop)r
rrr
�_getszLifoQueue._getN)�__name__�
__module__�__qualname__rrrrrrrrr
r
sr)	rZpackagesrZpackages.six.movesrZPY2ZQueueZ_unused_module_Queuerrrrr
�<module>s
site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-38.pyc000064400000024752151446177000021522 0ustar00U

��.e�7�	@sddlmZddlZddlmZddlmZddlmZddd	d
ddd
gZ	dZ
e�d�Ze�d�Z
e�dejejB�ZdZdZdjeed�Zeed�Zdddddddddg	Zd Zd!d"�d#d$�eD��d%Zd&ed'Zd(ed!ed)Zd*Ze�d+�Ze�d,ed-�Ze�d,ed-�Ze�d,ed-�Z e�d,edd.�d-�Z!e�d/ed0�Z"d1eeefZ#e�e#ejejB�Z$e%d2�Z&e%d3�Z'e&e'Bd4hBZ(e(d5d6hBZ)e)d7hBZ*Z+Gd8d9�d9ed9e	��Z,d:d;�Z-dKd=d>�Z.d?d@�Z/dAdB�Z0dCdD�Z1dEdF�Z2dGdH�Z3dIdJ�Z4dS)L�)�absolute_importN)�
namedtuple�)�LocationParseError)�six�scheme�auth�host�port�path�query�fragment)�httpZhttpsNz%[a-fA-F0-9]{2}z^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)zQ^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?(?://([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?$z(?:[0-9]{1,3}\.){3}[0-9]{1,3}z[0-9A-Fa-f]{1,4}z(?:{hex}:{hex}|{ipv4}))�hexZipv4)rZls32z(?:%(hex)s:){6}%(ls32)sz::(?:%(hex)s:){5}%(ls32)sz%(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)sz2(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)sz6(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)sz/(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)sz'(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)sz&(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)sz(?:(?:%(hex)s:){0,6}%(hex)s)?::zDABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._!\-~z(?:�|cCsg|]}|t�qS�)�_subs��.0�xrr�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/url.py�
<listcomp>6sr�)z
(?:%25|%)(?:[z]|%[a-fA-F0-9]{2})+z\[z)?\]z!(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*z"^(/[^?]*)(?:\?([^#]+))?(?:#(.*))?$�^�$����(z)\]$z^(%s|%s|%s)(?::([0-9]{0,5}))?$zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~z!$&'()*+,;=�:�@�/�?cs^eZdZdZdZd�fdd�	Zedd��Zedd	��Zed
d��Z	edd
��Z
dd�Z�ZS)�Urlz�
    Data structure for representing an HTTP URL. Used as a return value for
    :func:`parse_url`. Both the scheme and host are normalized as they are
    both case-insensitive according to RFC 3986.
    rNc
sD|r|�d�sd|}|dk	r&|��}tt|��||||||||�S)Nr)�
startswith�lower�superr!�__new__)�clsrrr	r
rrr
��	__class__rrr%[s

�zUrl.__new__cCs|jS)z@For backwards-compatibility with urlparse. We're nice like that.)r	��selfrrr�hostnamemszUrl.hostnamecCs&|jpd}|jdk	r"|d|j7}|S)z)Absolute path including the query string.rNr )rr)r*Zurirrr�request_urirs

zUrl.request_uricCs|jrd|j|jfS|jS)z(Network location including host and portz%s:%d)r
r	r)rrr�netloc|sz
Url.netlocc	Cs�|\}}}}}}}d}|dk	r*||d7}|dk	r>||d7}|dk	rN||7}|dk	rf|dt|�7}|dk	rv||7}|dk	r�|d|7}|dk	r�|d|7}|S)a�
        Convert self into a url

        This function should more or less round-trip with :func:`.parse_url`. The
        returned url may not be exactly the same as the url inputted to
        :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
        with a blank port will have : removed).

        Example: ::

            >>> U = parse_url('http://google.com/mail/')
            >>> U.url
            'http://google.com/mail/'
            >>> Url('http', 'username:password', 'host.com', 80,
            ... '/path', 'query', 'fragment').url
            'http://username:password@host.com:80/path?query#fragment'
        �Nz://rrr �#)�str)	r*rrr	r
rrr
�urlrrrr1�s"zUrl.urlcCs|jS�N)r1r)rrr�__str__�szUrl.__str__)NNNNNNN)
�__name__�
__module__�__qualname__�__doc__�	__slots__r%�propertyr+r,r-r1r3�
__classcell__rrr'rr!Rs&�

	

'r!cCsvd}d}|D]0}|�|�}|dkr$q|dks4||kr|}|}q|dksN|dkrX|ddfS|d|�||dd�|fS)a�
    .. deprecated:: 1.25

    Given a string and an iterable of delimiters, split on the first found
    delimiter. Return two split parts and the matched delimiter.

    If not found, then the first part is the full input string.

    Example::

        >>> split_first('foo/bar?baz', '?/=')
        ('foo', 'bar?baz', '/')
        >>> split_first('foo/bar?baz', '123')
        ('foo/bar?baz', '', None)

    Scales linearly with number of delims. Not ideal for large number of delims.
    Nrr.�)�find)�sZdelimsZmin_idxZ	min_delim�d�idxrrr�split_first�s

r@�utf-8cCs�|dkr|St�|�}t�|�}|D]}|��s$|�||���}q$|�dd�}t|�|�	d�k}t
�}tdt|��D]p}|||d�}	t|	�}
|r�|	dks�|
dkr�|	�
�|kr�|�|	�qt|�dt|
�dd����d����qt|�
|�S)	zfPercent-encodes a URI component without reapplying
    onto an already percent-encoded component.
    NrA�
surrogatepass�%rr;�r)r�ensure_text�
PERCENT_RE�findall�isupper�replace�upper�encode�len�count�	bytearray�range�ord�decode�extendr�zfill)Z	componentZ
allowed_chars�encodingZpercent_encodings�encZ	uri_bytesZis_percent_encodedZencoded_component�iZbyteZbyte_ordrrr�_encode_invalid_chars�s,

�
�
*rWcCs�|�d�}g}|D]0}|dkr"qq|dkr6|�|�q|r|��q|�d�rf|rZ|drf|�dd�|�d�rz|�d�d�|�S)Nr�.z..rr.)z/.z/..)�split�append�popr"�insert�endswith�join)rZsegments�outputZsegmentrrr�_remove_path_dot_segments�s



r`cCs�|r�t|tj�rt�|�}|tkr�t�|�}|r�t�|�}|r�|�	d�\}}|||�}|�
d�rx|dkrx|dd�}n|dd�}dt|t�}|d|��
�|||d�S|�
�Sn*t�|�s�t�d�dd�|�d�D���S|S)	Nr;z%25��%�.cSsg|]}t|��qSr)�_idna_encode)rZlabelrrrr,sz#_normalize_host.<locals>.<listcomp>rX)�
isinstancerZbinary_type�
ensure_str�NORMALIZABLE_SCHEMES�
IPV6_ADDRZ_RE�match�
ZONE_ID_RE�search�spanr"rW�UNRESERVED_CHARSr#�IPV4_REr^rY)r	rZis_ipv6ri�start�endZzone_idrrr�_normalize_hosts*


 

�rqcCs�|r�tdd�|D��r�zddlm}Wn$tk
rJt�td�d�YnXz|j|��ddd�WS|j	k
r�t�td|�d�YnX|���d	�S)
NcSsg|]}t|�dk�qS)rD)rPrrrrr2sz _idna_encode.<locals>.<listcomp>r)�idnaz-Unable to parse URL without the 'idna' moduleT)�strictZ
std3_rulesz#Name '%s' is not a valid IDNA label�ascii)
�anyZpip._vendorrr�ImportErrorr�
raise_fromrrKr#Z	IDNAError)�namerrrrrrd1s �

�
rdcCsl|�d�s|St�|���\}}}t|t�}t|t�}t|t�}|dk	rT|d|7}|dk	rh|d|7}|S)zHPercent-encodes a request target so that there are no invalid charactersrNr r/)r"�	TARGET_REri�groupsrW�
PATH_CHARS�QUERY_CHARS�FRAGMENT_CHARS)�targetrrr
rrr�_encode_targetCs



rc	s�|s
t�S|}t�|�s d|}�zt�|���\}}}}}|dkpN|��tk}|r\|��}|r�|�d�\}}	}
|pvd}t	�|
���\}}|r�|r�t
|t�}|dkr�d}n
d\}}}|dk	r�t|�}d|kr�dks�nt
|��t||�}|�r
|�r
t|�}t
|t�}|�r |�r t
|t�}|�r6|�r6t
|t�}Wn*ttfk
�rbt�t
|�d�YSX|�s�|dk	�s~|dk	�r�d}nd}t|tj��r�tj�ntj��fdd	�}
t|
|�|
|�|
|�||
|�|
|�|
|�d
�S)a

    Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
    performed to parse incomplete urls. Fields not provided will be None.
    This parser is RFC 3986 compliant.

    The parser logic and helper functions are based heavily on
    work done in the ``rfc3986`` module.

    :param str url: URL to parse into a :class:`.Url` namedtuple.

    Partly backwards-compatible with :mod:`urlparse`.

    Example::

        >>> parse_url('http://google.com/mail/')
        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
        >>> parse_url('google.com:80')
        Url(scheme=None, host='google.com', port=80, path=None, ...)
        >>> parse_url('/foo?bar')
        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
    z//Nrr.)NNNri��cs|dkr|S�|�Sr2r)r�Zensure_funcrr�ensure_type�szparse_url.<locals>.ensure_type)rrr	r
rrr
)r!�	SCHEME_RErk�URI_RErirzr#rg�
rpartition�
_HOST_PORT_RErW�USERINFO_CHARS�intrrqr`r{r|r}�
ValueError�AttributeErrorrrwreZ	text_typerErf)r1Z
source_urlrZ	authorityrrr
Z
normalize_urir�_Z	host_portr	r
r�rr�r�	parse_urlSsd





�r�cCst|�}|jpd|j|jfS)z4
    Deprecated. Use :func:`parse_url` instead.
    r)r�rr+r
)r1�prrr�get_host�sr�)rA)5Z
__future__r�re�collectionsr�
exceptionsrZpackagesrZ	url_attrsrg�compilerFr��UNICODE�DOTALLr�ZIPV4_PATZHEX_PAT�formatZLS32_PATrZ_variationsZUNRESERVED_PATr^ZIPV6_PATZZONE_ID_PATZIPV6_ADDRZ_PATZREG_NAME_PATryrnZIPV6_RErhZBRACELESS_IPV6_ADDRZ_RErjZ_HOST_PORT_PATr��setrmZSUB_DELIM_CHARSr�r{r|r}r!r@rWr`rqrdrr�r�rrrr�<module>sv


�	
�
��]#
%asite-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-38.opt-1.pyc000064400000006372151446177000023345 0ustar00U

��.e��@s�ddlmZddlmZddlmZmZddlmZdZ	zddl
ZWnek
rXYn
Xe	d7Z	e
�Zdd	d
�Zdd�Zd
d�ZdS)�)�absolute_import)�	b64encode�)�b�
integer_types)�UnrewindableBodyErrorzgzip,deflateNz,brcCs�i}|r6t|t�rnt|t�r*d�|�}nt}||d<|rB||d<|rNd|d<|rldtt|���d�|d<|r�dtt|���d�|d	<|r�d
|d<|S)a
    Shortcuts for generating request headers.

    :param keep_alive:
        If ``True``, adds 'connection: keep-alive' header.

    :param accept_encoding:
        Can be a boolean, list, or string.
        ``True`` translates to 'gzip,deflate'.
        List will get joined by comma.
        String will be used as provided.

    :param user_agent:
        String representing the user-agent you want, such as
        "python-urllib3/0.6"

    :param basic_auth:
        Colon-separated username:password string for 'authorization: basic ...'
        auth header.

    :param proxy_basic_auth:
        Colon-separated username:password string for 'proxy-authorization: basic ...'
        auth header.

    :param disable_cache:
        If ``True``, adds 'cache-control: no-cache' header.

    Example::

        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
        >>> make_headers(accept_encoding=True)
        {'accept-encoding': 'gzip,deflate'}
    �,zaccept-encodingz
user-agentz
keep-aliveZ
connectionzBasic zutf-8Z
authorizationzproxy-authorizationzno-cachez
cache-control)�
isinstance�str�list�join�ACCEPT_ENCODINGrr�decode)Z
keep_aliveZaccept_encodingZ
user_agentZ
basic_authZproxy_basic_authZ
disable_cacheZheaders�r�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/request.py�make_headerss.*

��
rc	CsR|dk	rt||�n:t|dd�dk	rNz|��}Wnttfk
rLt}YnX|S)z
    If a position is provided, move file to that point.
    Otherwise, we'll attempt to record a position for future use.
    N�tell)�rewind_body�getattrr�IOError�OSError�_FAILEDTELL)�body�posrrr�set_file_positionZs
rc	Cstt|dd�}|dk	rNt|t�rNz||�Wqpttfk
rJtd��YqpXn"|tkr`td��ntdt|���dS)z�
    Attempt to rewind body to a certain position.
    Primarily used for request redirects and retries.

    :param body:
        File-like object that supports seek.

    :param int pos:
        Position to seek to in file.
    �seekNzAAn error occurred when rewinding request body for redirect/retry.zRUnable to record file position for rewinding request body during a redirect/retry.z4body_pos must be of type integer, instead it was %s.)	rr	rrrrr�
ValueError�type)rZbody_posZ	body_seekrrrrls��
�r)NNNNNN)Z
__future__r�base64rZpackages.sixrr�
exceptionsrr
ZbrotliZ_unused_module_brotli�ImportError�objectrrrrrrrr�<module>s&�
Hsite-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-38.opt-1.pyc000064400000023135151446177000022611 0ustar00U

��.eS7�@s(ddlmZddlZddlZddlZddlZddlmZmZddl	m
Z
mZmZddl
mZmZddlmZmZmZdd	lmZdZd
Zd
Zd
Ze
eed�Zdd
�Zeede�Zz(ddlZddlmZm Z ddlmZWne!k
r�YnXzddlm"Z"e"Z#WnJe!k
�rLzddlm#Z"e"Z#Wne!k
�rFdZ#Z"YnXYnXzddlm$Z$m%Z%m&Z&Wn"e!k
�r�d\Z$Z%dZ&YnXd�'dddddddddd d!d"d#d$g�Z(zdd%lmZWn&e!k
�r�Gd&d'�d'e)�ZYnXd(d)�Z*d*d+�Z+d,d-�Z,d6d.d/�Z-d7d0d1�Z.d2d3�Z/d4d5�Z0dS)8�)�absolute_importN)�hexlify�	unhexlify)�md5�sha1�sha256�)�IPV4_RE�BRACELESS_IPV6_ADDRZ_RE�)�SSLError�InsecurePlatformWarning�SNIMissingWarning)�sixF)� �(�@cCsDtt|�t|��}tt|�t|��D]\}}|||AO}q&|dkS)z�
    Compare two digests of equal length in constant time.

    The digests must be of type str/bytes.
    Returns True if the digests match, and False otherwise.
    r)�abs�len�zip�	bytearray)�a�b�result�l�r�r�A/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/ssl_.py�_const_compare_digest_backportsrZcompare_digest)�wrap_socket�
CERT_REQUIRED)�HAS_SNI)�PROTOCOL_TLS)�PROTOCOL_SSLv23)�OP_NO_SSLv2�OP_NO_SSLv3�OP_NO_COMPRESSION)iii�:zECDHE+AESGCMzECDHE+CHACHA20z
DHE+AESGCMzDHE+CHACHA20zECDH+AESGCMz	DH+AESGCMzECDH+AESzDH+AESz
RSA+AESGCMzRSA+AESz!aNULLz!eNULLz!MD5z!DSS)�
SSLContextc@s8eZdZdd�Zdd�Zd
dd�Zdd	�Zddd�ZdS)r(cCs6||_d|_tj|_d|_d|_d|_d|_d|_	dS)NFr)
�protocol�check_hostname�sslZ	CERT_NONE�verify_mode�ca_certs�options�certfile�keyfile�ciphers)�selfZprotocol_versionrrr�__init__kszSSLContext.__init__cCs||_||_dS�N)r/r0)r2r/r0rrr�load_cert_chainvszSSLContext.load_cert_chainNcCs||_|dk	rtd��dS)Nz-CA directories not supported in older Pythons)r-r)r2ZcafileZcapathrrr�load_verify_locationszsz SSLContext.load_verify_locationscCs
||_dSr4�r1)r2Zcipher_suiterrr�set_ciphers�szSSLContext.set_ciphersFcCs>t�dt�|j|j|j|j|j|d�}t|fd|j	i|��S)Na2A true SSLContext object is not available. This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail. You can upgrade to a newer version of Python to solve this. For more information, see https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings)r0r/r-�	cert_reqs�ssl_version�server_sider1)
�warnings�warnr
r0r/r-r,r)rr1)r2Zsocket�server_hostnamer;�kwargsrrrr�s�
�zSSLContext.wrap_socket)NN)NF)�__name__�
__module__�__qualname__r3r5r6r8rrrrrr(js

r(cCsn|�dd���}t|�}t�|�}|s4td�|���t|���}||��	�}t
||�sjtd�|t|����dS)z�
    Checks if given fingerprint matches the supplied certificate.

    :param cert:
        Certificate as bytes object.
    :param fingerprint:
        Fingerprint as string of hexdigits, can be interspersed by colons.
    r'�z"Fingerprint of invalid length: {0}z6Fingerprints did not match. Expected "{0}", got "{1}".N)�replace�lowerr�HASHFUNC_MAP�getr�formatr�encodeZdigest�_const_compare_digestr)ZcertZfingerprintZ
digest_lengthZhashfuncZfingerprint_bytesZcert_digestrrr�assert_fingerprint�s


��rKcCs@|dkrtSt|t�r<tt|d�}|dkr8ttd|�}|S|S)a�
    Resolves the argument to a numeric constant, which can be passed to
    the wrap_socket function/method from the ssl module.
    Defaults to :data:`ssl.CERT_NONE`.
    If given a string it is assumed to be the name of the constant in the
    :mod:`ssl` module or its abbreviation.
    (So you can specify `REQUIRED` instead of `CERT_REQUIRED`.
    If it's neither `None` nor a string we assume it is already the numeric
    constant which can directly be passed to wrap_socket.
    NZCERT_)r �
isinstance�str�getattrr+��	candidate�resrrr�resolve_cert_reqs�s
rRcCs@|dkrtSt|t�r<tt|d�}|dkr8ttd|�}|S|S)z 
    like resolve_cert_reqs
    NZ	PROTOCOL_)r"rLrMrNr+rOrrr�resolve_ssl_version�s
rScCs�t|pt�}|�|pt�|dkr(tjn|}|dkrPd}|tO}|tO}|tO}|j	|O_	|tjksrt
jdkr�t|dd�dk	r�d|_
||_t|dd�dk	r�d|_|S)a�All arguments have the same meaning as ``ssl_wrap_socket``.

    By default, this function does a lot of the same work that
    ``ssl.create_default_context`` does on Python 3.4+. It:

    - Disables SSLv2, SSLv3, and compression
    - Sets a restricted set of server ciphers

    If you wish to enable SSLv3, you can do::

        from pip._vendor.urllib3.util import ssl_
        context = ssl_.create_urllib3_context()
        context.options &= ~ssl_.OP_NO_SSLv3

    You can do the same to enable compression (substituting ``COMPRESSION``
    for ``SSLv3`` in the last line above).

    :param ssl_version:
        The desired protocol version to use. This will default to
        PROTOCOL_SSLv23 which will negotiate the highest protocol that both
        the server and your installation of OpenSSL support.
    :param cert_reqs:
        Whether to require the certificate verification. This defaults to
        ``ssl.CERT_REQUIRED``.
    :param options:
        Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
        ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``.
    :param ciphers:
        Which cipher suites to allow the server to select.
    :returns:
        Constructed SSLContext object with specified options
    :rtype: SSLContext
    Nr)����post_handshake_authTr*F)r(r"r8�DEFAULT_CIPHERSr+r r$r%r&r.�sys�version_inforNrWr,r*)r:r9r.r1�contextrrr�create_urllib3_context�s,$���r\c

CsB|}|dkrt|||d�}|s"|	r�z|�||	�Wq�tk
r\}zt|��W5d}~XYq�tk
r�}z|jtjkr�t|���W5d}~XYq�Xn|dkr�t|d�r�|��|r�|
dkr�t	|�r�td��|r�|
dkr�|�
||�n|�
|||
�|dk	�rt|��rt�r8t
�r,|dk	�r,|j||d�St�dt�|�|�S)a
    All arguments except for server_hostname, ssl_context, and ca_cert_dir have
    the same meaning as they do when using :func:`ssl.wrap_socket`.

    :param server_hostname:
        When SNI is supported, the expected hostname of the certificate
    :param ssl_context:
        A pre-made :class:`SSLContext` object. If none is provided, one will
        be created using :func:`create_urllib3_context`.
    :param ciphers:
        A string of ciphers we wish the client to support.
    :param ca_cert_dir:
        A directory containing CA certificates in multiple separate files, as
        supported by OpenSSL's -CApath flag or the capath argument to
        SSLContext.load_verify_locations().
    :param key_password:
        Optional password if the keyfile is encrypted.
    Nr7�load_default_certsz5Client private key is encrypted, password is required)r>a�An HTTPS request has been made, but the SNI (Server Name Indication) extension to TLS is not available on this platform. This may cause the server to present an incorrect TLS certificate, which can cause validation failures. You can upgrade to a newer version of Python to solve this. For more information, see https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings)r\r6�IOErrorr�OSError�errnoZENOENT�hasattrr]�_is_key_file_encryptedr5�is_ipaddress�IS_SECURETRANSPORTr!rr<r=r)
Zsockr0r/r9r-r>r:r1Zssl_contextZca_cert_dirZkey_passwordr[�errr�ssl_wrap_socket(sB����rfcCs2tjst|t�r|�d�}tt�|�p.t�|��S)z�Detects whether the hostname given is an IPv4 or IPv6 address.
    Also detects IPv6 addresses with Zone IDs.

    :param str hostname: Hostname to examine.
    :return: True if the hostname is an IP address, False otherwise.
    �ascii)	rZPY2rL�bytes�decode�boolr	�matchr
)Zhostnamerrrrc�s
rcc	Cs<t|d��(}|D]}d|krW5QR�dSqW5QRXdS)z*Detects if a key file is encrypted or not.rZ	ENCRYPTEDTF)�open)Zkey_file�f�linerrrrb�s
rb)NNNN)
NNNNNNNNNN)1Z
__future__rr`r<ZhmacrYZbinasciirrZhashlibrrrZurlr	r
�
exceptionsrr
rZpackagesrr(r!ZIS_PYOPENSSLrdrFrrNrJr+rr �ImportErrorr"r#r$r%r&�joinrX�objectrKrRrSr\rfrcrbrrrr�<module>s�

��.�
N�
Z
site-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-38.opt-1.pyc000064400000031221151446177000023011 0ustar00U

��.eZ<�@s�ddlmZddlZddlZddlmZddlmZddlZddl	Z	ddl
mZmZm
Z
mZmZmZddlmZe�e�Zedd	d
ddd
g�ZGdd�de�Zed�e_dS)�)�absolute_importN)�
namedtuple)�	takewhile�)�ConnectTimeoutError�
MaxRetryError�
ProtocolError�ReadTimeoutError�
ResponseError�
InvalidHeader)�six�RequestHistory�method�url�error�status�redirect_locationc
@s�eZdZdZeddddddg�Zedd	d
g�Zedg�ZdZd
ddddeddddddef
dd�Z	dd�Z
ed2dd��Zdd�Z
dd�Zdd�Zd3dd�Zdd �Zd4d!d"�Zd#d$�Zd%d&�Zd'd(�Zd5d*d+�Zd,d-�Zd6d.d/�Zd0d1�ZdS)7�Retrya3 Retry configuration.

    Each retry attempt will create a new Retry object with updated values, so
    they can be safely reused.

    Retries can be defined as a default for a pool::

        retries = Retry(connect=5, read=2, redirect=5)
        http = PoolManager(retries=retries)
        response = http.request('GET', 'http://example.com/')

    Or per-request (which overrides the default for the pool)::

        response = http.request('GET', 'http://example.com/', retries=Retry(10))

    Retries can be disabled by passing ``False``::

        response = http.request('GET', 'http://example.com/', retries=False)

    Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
    retries are disabled, in which case the causing exception will be raised.

    :param int total:
        Total number of retries to allow. Takes precedence over other counts.

        Set to ``None`` to remove this constraint and fall back on other
        counts. It's a good idea to set this to some sensibly-high value to
        account for unexpected edge cases and avoid infinite retry loops.

        Set to ``0`` to fail on the first retry.

        Set to ``False`` to disable and imply ``raise_on_redirect=False``.

    :param int connect:
        How many connection-related errors to retry on.

        These are errors raised before the request is sent to the remote server,
        which we assume has not triggered the server to process the request.

        Set to ``0`` to fail on the first retry of this type.

    :param int read:
        How many times to retry on read errors.

        These errors are raised after the request was sent to the server, so the
        request may have side-effects.

        Set to ``0`` to fail on the first retry of this type.

    :param int redirect:
        How many redirects to perform. Limit this to avoid infinite redirect
        loops.

        A redirect is a HTTP response with a status code 301, 302, 303, 307 or
        308.

        Set to ``0`` to fail on the first retry of this type.

        Set to ``False`` to disable and imply ``raise_on_redirect=False``.

    :param int status:
        How many times to retry on bad status codes.

        These are retries made on responses, where status code matches
        ``status_forcelist``.

        Set to ``0`` to fail on the first retry of this type.

    :param iterable method_whitelist:
        Set of uppercased HTTP method verbs that we should retry on.

        By default, we only retry on methods which are considered to be
        idempotent (multiple requests with the same parameters end with the
        same state). See :attr:`Retry.DEFAULT_METHOD_WHITELIST`.

        Set to a ``False`` value to retry on any verb.

    :param iterable status_forcelist:
        A set of integer HTTP status codes that we should force a retry on.
        A retry is initiated if the request method is in ``method_whitelist``
        and the response status code is in ``status_forcelist``.

        By default, this is disabled with ``None``.

    :param float backoff_factor:
        A backoff factor to apply between attempts after the second try
        (most errors are resolved immediately by a second try without a
        delay). urllib3 will sleep for::

            {backoff factor} * (2 ** ({number of total retries} - 1))

        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
        than :attr:`Retry.BACKOFF_MAX`.

        By default, backoff is disabled (set to 0).

    :param bool raise_on_redirect: Whether, if the number of redirects is
        exhausted, to raise a MaxRetryError, or to return a response with a
        response code in the 3xx range.

    :param bool raise_on_status: Similar meaning to ``raise_on_redirect``:
        whether we should raise an exception, or return a response,
        if status falls in ``status_forcelist`` range and retries have
        been exhausted.

    :param tuple history: The history of the request encountered during
        each call to :meth:`~Retry.increment`. The list is in the order
        the requests occurred. Each list item is of class :class:`RequestHistory`.

    :param bool respect_retry_after_header:
        Whether to respect Retry-After header on status codes defined as
        :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.

    :param iterable remove_headers_on_redirect:
        Sequence of headers to remove from the request when a response
        indicating a redirect is returned before firing off the redirected
        request.
    ZHEADZGETZPUTZDELETEZOPTIONSZTRACEi�i�i�Z
Authorization�x�
NrTcCs�||_||_||_||_|dks(|dkr0d}d}	||_|p>t�|_||_||_|	|_	|
|_
|pbt�|_||_
tdd�|
D��|_dS)NFrcSsg|]}|���qS�)�lower)�.0�hrr�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/retry.py�
<listcomp>�sz"Retry.__init__.<locals>.<listcomp>)�total�connect�readr�redirect�set�status_forcelist�method_whitelist�backoff_factor�raise_on_redirect�raise_on_status�tuple�history�respect_retry_after_header�	frozenset�remove_headers_on_redirect)�selfrrrrrr"r!r#r$r%r'r(r*rrr�__init__�s$�zRetry.__init__cKsTt|j|j|j|j|j|j|j|j|j	|j
|j|j|j
d�
}|�|�t|�f|�S)N)
rrrrrr"r!r#r$r%r'r*r()�dictrrrrrr"r!r#r$r%r'r*r(�update�type)r+�kwZparamsrrr�new�s"�
z	Retry.newcCsR|dkr|dk	r|n|j}t|t�r(|St|�o2d}|||d�}t�d||�|S)z4 Backwards-compatibility for the old retries format.N)rz!Converted retries value: %r -> %r)�DEFAULT�
isinstancer�bool�log�debug)�clsZretriesr�defaultZnew_retriesrrr�from_int�s
zRetry.from_intcCsFtttdd�t|j����}|dkr(dS|jd|d}t|j|�S)zJ Formula for computing the current backoff

        :rtype: float
        cSs
|jdkS)N)r)�xrrr�<lambda>��z(Retry.get_backoff_time.<locals>.<lambda>�rr)�len�listr�reversedr'r#�min�BACKOFF_MAX)r+Zconsecutive_errors_lenZ
backoff_valuerrr�get_backoff_time�s��zRetry.get_backoff_timecCs\t�d|�rt|�}n6tj�|�}|dkr6td|��t�|�}|t��}|dkrXd}|S)Nz^\s*[0-9]+\s*$zInvalid Retry-After header: %sr)	�re�match�int�emailZutilsZ	parsedater�time�mktime)r+�retry_afterZsecondsZretry_date_tupleZ
retry_daterrr�parse_retry_after�s

zRetry.parse_retry_aftercCs |�d�}|dkrdS|�|�S)z* Get the value of Retry-After in seconds. zRetry-AfterN)Z	getheaderrK�r+�responserJrrr�get_retry_after	s
zRetry.get_retry_aftercCs |�|�}|rt�|�dSdS)NTF)rNrH�sleeprLrrr�sleep_for_retrys


zRetry.sleep_for_retrycCs"|��}|dkrdSt�|�dS)Nr)rCrHrO)r+Zbackoffrrr�_sleep_backoffszRetry._sleep_backoffcCs(|jr|r|�|�}|rdS|��dS)aC Sleep between retry attempts.

        This method will respect a server's ``Retry-After`` response header
        and sleep the duration of the time requested. If that is not present, it
        will use an exponential backoff. By default, the backoff factor is 0 and
        this method will return immediately.
        N)r(rPrQ)r+rMZsleptrrrrO!s
	

zRetry.sleepcCs
t|t�S)z{ Errors when we're fairly sure that the server did not receive the
        request, so it should be safe to retry.
        )r3r�r+�errrrr�_is_connection_error1szRetry._is_connection_errorcCst|ttf�S)z� Errors that occur after the request has been started, so we should
        assume that the server began processing it.
        )r3r	rrRrrr�_is_read_error7szRetry._is_read_errorcCs|jr|��|jkrdSdS)z| Checks if a given HTTP method should be retried upon, depending if
        it is included on the method whitelist.
        FT)r"�upper)r+rrrr�_is_method_retryable=szRetry._is_method_retryableFcCs<|�|�sdS|jr"||jkr"dS|jo:|jo:|o:||jkS)ax Is this method/status code retryable? (Based on whitelists and control
        variables such as the number of total retries to allow, whether to
        respect the Retry-After header, whether this header is present, and
        whether the returned status code is on the list of status codes to
        be retried upon on the presence of the aforementioned header)
        FT)rWr!rr(�RETRY_AFTER_STATUS_CODES)r+r�status_codeZhas_retry_afterrrr�is_retryFs
���zRetry.is_retrycCs:|j|j|j|j|jf}ttd|��}|s.dSt|�dkS)z Are we out of retries? NFr)rrrrrr?�filterrA)r+Zretry_countsrrr�is_exhaustedZs
zRetry.is_exhaustedcCs�|jdkr |r t�t|�||��|j}|dk	r6|d8}|j}|j}	|j}
|j}d}d}
d}|r�|�|�r�|dkr�t�t|�||��n|dk	r�|d8}n�|r�|�	|�r�|	dks�|�
|�s�t�t|�||��n|	dk	r�|	d8}	np|�r|���r|
dk	r�|
d8}
d}|��}|j}
n<tj
}|�rL|j�rL|dk	�r6|d8}tjj|jd�}|j}
|jt||||
|�f}|j|||	|
||d�}|���r�t|||�p�t|���t�d||�|S)	a� Return a new Retry object with incremented retry counters.

        :param response: A response object, or None, if the server did not
            return a response.
        :type response: :class:`~urllib3.response.HTTPResponse`
        :param Exception error: An error encountered during the request, or
            None if the response was received successfully.

        :return: A new ``Retry`` object.
        FNr=�unknownztoo many redirects)rY)rrrrrr'z$Incremented Retry for (url='%s'): %r)rrZreraiser/rrrrrTrUrWZget_redirect_locationr
Z
GENERIC_ERRORZSPECIFIC_ERROR�formatr'r
r1r\rr5r6)r+rrrMrZ_poolZ_stacktracerrrrZstatus_count�causerrr'Z	new_retryrrr�	incrementcsb


��	
zRetry.incrementcCsdjt|�|d�S)Nz|{cls.__name__}(total={self.total}, connect={self.connect}, read={self.read}, redirect={self.redirect}, status={self.status}))r7r+)r^r/)r+rrr�__repr__�s
��zRetry.__repr__)TN)N)N)F)NNNNNN)�__name__�
__module__�__qualname__�__doc__r)ZDEFAULT_METHOD_WHITELISTrXZ"DEFAULT_REDIRECT_HEADERS_BLACKLISTrBr,r1�classmethodr9rCrKrNrPrQrOrTrUrWrZr\r`rarrrrrsVx�
�
&



	
�
Wr�)Z
__future__rrHZlogging�collectionsr�	itertoolsrrGrD�
exceptionsrrrr	r
rZpackagesrZ	getLoggerrbr5r
�objectrr2rrrr�<module>s$ 
�(site-packages/pip/_vendor/urllib3/util/__pycache__/url.cpython-38.opt-1.pyc000064400000024752151446177000022461 0ustar00U

��.e�7�	@sddlmZddlZddlmZddlmZddlmZddd	d
ddd
gZ	dZ
e�d�Ze�d�Z
e�dejejB�ZdZdZdjeed�Zeed�Zdddddddddg	Zd Zd!d"�d#d$�eD��d%Zd&ed'Zd(ed!ed)Zd*Ze�d+�Ze�d,ed-�Ze�d,ed-�Ze�d,ed-�Z e�d,edd.�d-�Z!e�d/ed0�Z"d1eeefZ#e�e#ejejB�Z$e%d2�Z&e%d3�Z'e&e'Bd4hBZ(e(d5d6hBZ)e)d7hBZ*Z+Gd8d9�d9ed9e	��Z,d:d;�Z-dKd=d>�Z.d?d@�Z/dAdB�Z0dCdD�Z1dEdF�Z2dGdH�Z3dIdJ�Z4dS)L�)�absolute_importN)�
namedtuple�)�LocationParseError)�six�scheme�auth�host�port�path�query�fragment)�httpZhttpsNz%[a-fA-F0-9]{2}z^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)zQ^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?(?://([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?$z(?:[0-9]{1,3}\.){3}[0-9]{1,3}z[0-9A-Fa-f]{1,4}z(?:{hex}:{hex}|{ipv4}))�hexZipv4)rZls32z(?:%(hex)s:){6}%(ls32)sz::(?:%(hex)s:){5}%(ls32)sz%(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)sz2(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)sz6(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)sz/(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)sz'(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)sz&(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)sz(?:(?:%(hex)s:){0,6}%(hex)s)?::zDABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._!\-~z(?:�|cCsg|]}|t�qS�)�_subs��.0�xrr�@/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/url.py�
<listcomp>6sr�)z
(?:%25|%)(?:[z]|%[a-fA-F0-9]{2})+z\[z)?\]z!(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*z"^(/[^?]*)(?:\?([^#]+))?(?:#(.*))?$�^�$����(z)\]$z^(%s|%s|%s)(?::([0-9]{0,5}))?$zBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~z!$&'()*+,;=�:�@�/�?cs^eZdZdZdZd�fdd�	Zedd��Zedd	��Zed
d��Z	edd
��Z
dd�Z�ZS)�Urlz�
    Data structure for representing an HTTP URL. Used as a return value for
    :func:`parse_url`. Both the scheme and host are normalized as they are
    both case-insensitive according to RFC 3986.
    rNc
sD|r|�d�sd|}|dk	r&|��}tt|��||||||||�S)Nr)�
startswith�lower�superr!�__new__)�clsrrr	r
rrr
��	__class__rrr%[s

�zUrl.__new__cCs|jS)z@For backwards-compatibility with urlparse. We're nice like that.)r	��selfrrr�hostnamemszUrl.hostnamecCs&|jpd}|jdk	r"|d|j7}|S)z)Absolute path including the query string.rNr )rr)r*Zurirrr�request_urirs

zUrl.request_uricCs|jrd|j|jfS|jS)z(Network location including host and portz%s:%d)r
r	r)rrr�netloc|sz
Url.netlocc	Cs�|\}}}}}}}d}|dk	r*||d7}|dk	r>||d7}|dk	rN||7}|dk	rf|dt|�7}|dk	rv||7}|dk	r�|d|7}|dk	r�|d|7}|S)a�
        Convert self into a url

        This function should more or less round-trip with :func:`.parse_url`. The
        returned url may not be exactly the same as the url inputted to
        :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
        with a blank port will have : removed).

        Example: ::

            >>> U = parse_url('http://google.com/mail/')
            >>> U.url
            'http://google.com/mail/'
            >>> Url('http', 'username:password', 'host.com', 80,
            ... '/path', 'query', 'fragment').url
            'http://username:password@host.com:80/path?query#fragment'
        �Nz://rrr �#)�str)	r*rrr	r
rrr
�urlrrrr1�s"zUrl.urlcCs|jS�N)r1r)rrr�__str__�szUrl.__str__)NNNNNNN)
�__name__�
__module__�__qualname__�__doc__�	__slots__r%�propertyr+r,r-r1r3�
__classcell__rrr'rr!Rs&�

	

'r!cCsvd}d}|D]0}|�|�}|dkr$q|dks4||kr|}|}q|dksN|dkrX|ddfS|d|�||dd�|fS)a�
    .. deprecated:: 1.25

    Given a string and an iterable of delimiters, split on the first found
    delimiter. Return two split parts and the matched delimiter.

    If not found, then the first part is the full input string.

    Example::

        >>> split_first('foo/bar?baz', '?/=')
        ('foo', 'bar?baz', '/')
        >>> split_first('foo/bar?baz', '123')
        ('foo/bar?baz', '', None)

    Scales linearly with number of delims. Not ideal for large number of delims.
    Nrr.�)�find)�sZdelimsZmin_idxZ	min_delim�d�idxrrr�split_first�s

r@�utf-8cCs�|dkr|St�|�}t�|�}|D]}|��s$|�||���}q$|�dd�}t|�|�	d�k}t
�}tdt|��D]p}|||d�}	t|	�}
|r�|	dks�|
dkr�|	�
�|kr�|�|	�qt|�dt|
�dd����d����qt|�
|�S)	zfPercent-encodes a URI component without reapplying
    onto an already percent-encoded component.
    NrA�
surrogatepass�%rr;�r)r�ensure_text�
PERCENT_RE�findall�isupper�replace�upper�encode�len�count�	bytearray�range�ord�decode�extendr�zfill)Z	componentZ
allowed_chars�encodingZpercent_encodings�encZ	uri_bytesZis_percent_encodedZencoded_component�iZbyteZbyte_ordrrr�_encode_invalid_chars�s,

�
�
*rWcCs�|�d�}g}|D]0}|dkr"qq|dkr6|�|�q|r|��q|�d�rf|rZ|drf|�dd�|�d�rz|�d�d�|�S)Nr�.z..rr.)z/.z/..)�split�append�popr"�insert�endswith�join)rZsegments�outputZsegmentrrr�_remove_path_dot_segments�s



r`cCs�|r�t|tj�rt�|�}|tkr�t�|�}|r�t�|�}|r�|�	d�\}}|||�}|�
d�rx|dkrx|dd�}n|dd�}dt|t�}|d|��
�|||d�S|�
�Sn*t�|�s�t�d�dd�|�d�D���S|S)	Nr;z%25��%�.cSsg|]}t|��qSr)�_idna_encode)rZlabelrrrr,sz#_normalize_host.<locals>.<listcomp>rX)�
isinstancerZbinary_type�
ensure_str�NORMALIZABLE_SCHEMES�
IPV6_ADDRZ_RE�match�
ZONE_ID_RE�search�spanr"rW�UNRESERVED_CHARSr#�IPV4_REr^rY)r	rZis_ipv6ri�start�endZzone_idrrr�_normalize_hosts*


 

�rqcCs�|r�tdd�|D��r�zddlm}Wn$tk
rJt�td�d�YnXz|j|��ddd�WS|j	k
r�t�td|�d�YnX|���d	�S)
NcSsg|]}t|�dk�qS)rD)rPrrrrr2sz _idna_encode.<locals>.<listcomp>r)�idnaz-Unable to parse URL without the 'idna' moduleT)�strictZ
std3_rulesz#Name '%s' is not a valid IDNA label�ascii)
�anyZpip._vendorrr�ImportErrorr�
raise_fromrrKr#Z	IDNAError)�namerrrrrrd1s �

�
rdcCsl|�d�s|St�|���\}}}t|t�}t|t�}t|t�}|dk	rT|d|7}|dk	rh|d|7}|S)zHPercent-encodes a request target so that there are no invalid charactersrNr r/)r"�	TARGET_REri�groupsrW�
PATH_CHARS�QUERY_CHARS�FRAGMENT_CHARS)�targetrrr
rrr�_encode_targetCs



rc	s�|s
t�S|}t�|�s d|}�zt�|���\}}}}}|dkpN|��tk}|r\|��}|r�|�d�\}}	}
|pvd}t	�|
���\}}|r�|r�t
|t�}|dkr�d}n
d\}}}|dk	r�t|�}d|kr�dks�nt
|��t||�}|�r
|�r
t|�}t
|t�}|�r |�r t
|t�}|�r6|�r6t
|t�}Wn*ttfk
�rbt�t
|�d�YSX|�s�|dk	�s~|dk	�r�d}nd}t|tj��r�tj�ntj��fdd	�}
t|
|�|
|�|
|�||
|�|
|�|
|�d
�S)a

    Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
    performed to parse incomplete urls. Fields not provided will be None.
    This parser is RFC 3986 compliant.

    The parser logic and helper functions are based heavily on
    work done in the ``rfc3986`` module.

    :param str url: URL to parse into a :class:`.Url` namedtuple.

    Partly backwards-compatible with :mod:`urlparse`.

    Example::

        >>> parse_url('http://google.com/mail/')
        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
        >>> parse_url('google.com:80')
        Url(scheme=None, host='google.com', port=80, path=None, ...)
        >>> parse_url('/foo?bar')
        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
    z//Nrr.)NNNri��cs|dkr|S�|�Sr2r)r�Zensure_funcrr�ensure_type�szparse_url.<locals>.ensure_type)rrr	r
rrr
)r!�	SCHEME_RErk�URI_RErirzr#rg�
rpartition�
_HOST_PORT_RErW�USERINFO_CHARS�intrrqr`r{r|r}�
ValueError�AttributeErrorrrwreZ	text_typerErf)r1Z
source_urlrZ	authorityrrr
Z
normalize_urir�_Z	host_portr	r
r�rr�r�	parse_urlSsd





�r�cCst|�}|jpd|j|jfS)z4
    Deprecated. Use :func:`parse_url` instead.
    r)r�rr+r
)r1�prrr�get_host�sr�)rA)5Z
__future__r�re�collectionsr�
exceptionsrZpackagesrZ	url_attrsrg�compilerFr��UNICODE�DOTALLr�ZIPV4_PATZHEX_PAT�formatZLS32_PATrZ_variationsZUNRESERVED_PATr^ZIPV6_PATZZONE_ID_PATZIPV6_ADDRZ_PATZREG_NAME_PATryrnZIPV6_RErhZBRACELESS_IPV6_ADDRZ_RErjZ_HOST_PORT_PATr��setrmZSUB_DELIM_CHARSr�r{r|r}r!r@rWr`rqrdrr�r�rrrr�<module>sv


�	
�
��]#
%asite-packages/pip/_vendor/urllib3/util/__pycache__/request.cpython-38.pyc000064400000006372151446177000022406 0ustar00U

��.e��@s�ddlmZddlmZddlmZmZddlmZdZ	zddl
ZWnek
rXYn
Xe	d7Z	e
�Zdd	d
�Zdd�Zd
d�ZdS)�)�absolute_import)�	b64encode�)�b�
integer_types)�UnrewindableBodyErrorzgzip,deflateNz,brcCs�i}|r6t|t�rnt|t�r*d�|�}nt}||d<|rB||d<|rNd|d<|rldtt|���d�|d<|r�dtt|���d�|d	<|r�d
|d<|S)a
    Shortcuts for generating request headers.

    :param keep_alive:
        If ``True``, adds 'connection: keep-alive' header.

    :param accept_encoding:
        Can be a boolean, list, or string.
        ``True`` translates to 'gzip,deflate'.
        List will get joined by comma.
        String will be used as provided.

    :param user_agent:
        String representing the user-agent you want, such as
        "python-urllib3/0.6"

    :param basic_auth:
        Colon-separated username:password string for 'authorization: basic ...'
        auth header.

    :param proxy_basic_auth:
        Colon-separated username:password string for 'proxy-authorization: basic ...'
        auth header.

    :param disable_cache:
        If ``True``, adds 'cache-control: no-cache' header.

    Example::

        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
        >>> make_headers(accept_encoding=True)
        {'accept-encoding': 'gzip,deflate'}
    �,zaccept-encodingz
user-agentz
keep-aliveZ
connectionzBasic zutf-8Z
authorizationzproxy-authorizationzno-cachez
cache-control)�
isinstance�str�list�join�ACCEPT_ENCODINGrr�decode)Z
keep_aliveZaccept_encodingZ
user_agentZ
basic_authZproxy_basic_authZ
disable_cacheZheaders�r�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/request.py�make_headerss.*

��
rc	CsR|dk	rt||�n:t|dd�dk	rNz|��}Wnttfk
rLt}YnX|S)z
    If a position is provided, move file to that point.
    Otherwise, we'll attempt to record a position for future use.
    N�tell)�rewind_body�getattrr�IOError�OSError�_FAILEDTELL)�body�posrrr�set_file_positionZs
rc	Cstt|dd�}|dk	rNt|t�rNz||�Wqpttfk
rJtd��YqpXn"|tkr`td��ntdt|���dS)z�
    Attempt to rewind body to a certain position.
    Primarily used for request redirects and retries.

    :param body:
        File-like object that supports seek.

    :param int pos:
        Position to seek to in file.
    �seekNzAAn error occurred when rewinding request body for redirect/retry.zRUnable to record file position for rewinding request body during a redirect/retry.z4body_pos must be of type integer, instead it was %s.)	rr	rrrrr�
ValueError�type)rZbody_posZ	body_seekrrrrls��
�r)NNNNNN)Z
__future__r�base64rZpackages.sixrr�
exceptionsrr
ZbrotliZ_unused_module_brotli�ImportError�objectrrrrrrrr�<module>s&�
Hsite-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-38.pyc000064400000003635151446177000022553 0ustar00U

��.e
�@s@ddlmZddlmZddlmZdd�Zdd�Zd	d
�Z	dS)�)�absolute_import�)�http_client)�HeaderParsingErrorcCslz
|��WStk
rYnXz|jWStk
r<YnXz|jdkWStk
r^YnXtd��dS)zt
    Checks whether a given file-like object is closed.

    :param obj:
        The file-like object to check.
    Nz)Unable to determine whether fp is closed.)Zisclosed�AttributeError�closed�fp�
ValueError)�obj�r�E/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/response.py�is_fp_closeds
r
cCsvt|tj�std�t|����t|dd�}t|dd�}d}|r^|��s^|�}t|tt	f�r^|}|sf|rrt
||d��dS)aP
    Asserts whether all headers have been successfully parsed.
    Extracts encountered errors from the result of parsing headers.

    Only works on Python 3.

    :param headers: Headers to verify.
    :type headers: `httplib.HTTPMessage`.

    :raises urllib3.exceptions.HeaderParsingError:
        If parsing errors are found.
    z"expected httplib.Message, got {0}.�defectsN�get_payload)r�
unparsed_data)�
isinstance�httplibZHTTPMessage�	TypeError�format�type�getattrZis_multipart�bytes�strr)ZheadersrrrZpayloadrrr�assert_header_parsing&srcCs$|j}t|t�r|dkS|��dkS)z�
    Checks whether the request of a response has been a HEAD-request.
    Handles the quirks of AppEngine.

    :param conn:
    :type conn: :class:`httplib.HTTPResponse`
    �ZHEAD)�_methodr�int�upper)Zresponse�methodrrr�is_response_to_headJs	
rN)
Z
__future__rZpackages.six.movesrr�
exceptionsrr
rrrrrr�<module>s
$site-packages/pip/_vendor/urllib3/util/__pycache__/connection.cpython-38.opt-1.pyc000064400000006124151446177000024007 0ustar00U

��.e�@snddlmZddlZddlmZmZddlmZdd�Zej	ddfd	d
�Z
dd�Zd
d�Zdd�Z
e
d�ZdS)�)�absolute_importN�)�NoWayToWaitForSocketError�
wait_for_read�)�_appengine_environcCsNt|dd�}|dkrdS|dkr$dSzt|dd�WStk
rHYdSXdS)a 
    Returns True if the connection is dropped and should be closed.

    :param conn:
        :class:`httplib.HTTPConnection` object.

    Note: For platforms like AppEngine, this will always return ``False`` to
    let the platform handle connection recycling transparently for us.
    �sockFNTg)�timeout)�getattrrr)Zconnr�r�G/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/connection.py�is_connection_droppeds
r
cCs�|\}}|�d�r|�d�}d}t�}t�|||tj�D]�}|\}	}
}}}
d}zNt�|	|
|�}t||�|tjk	r||�|�|r�|�	|�|�
|
�|WStjk
r�}z|}|dk	r�|��d}W5d}~XYq8Xq8|dk	r�|�t�d��dS)adConnect to *address* and return the socket object.

    Convenience function.  Connect to *address* (a 2-tuple ``(host,
    port)``) and return the socket object.  Passing the optional
    *timeout* parameter will set the timeout on the socket instance
    before attempting to connect.  If no *timeout* is supplied, the
    global default timeout setting returned by :func:`getdefaulttimeout`
    is used.  If *source_address* is set it must be a tuple of (host, port)
    for the socket to bind as a source address before making the connection.
    An host of '' or port 0 tells the OS to use the default.
    �[z[]Nz!getaddrinfo returns an empty list)
�
startswith�strip�allowed_gai_family�socketZgetaddrinfoZSOCK_STREAM�_set_socket_options�_GLOBAL_DEFAULT_TIMEOUTZ
settimeout�bindZconnect�error�close)Zaddressr	Zsource_addressZsocket_options�hostZport�err�family�resZafZsocktype�protoZ	canonnameZsar�errr�create_connection!s2







rcCs$|dkrdS|D]}|j|�qdS)N)Z
setsockopt)rZoptions�optrrrrYsrcCstj}trtj}|S)z�This function is designed to work in the context of
    getaddrinfo, where family=socket.AF_UNSPEC is the default and
    will perform a DNS search for both IPv6 and IPv4 records.)rZAF_INET�HAS_IPV6Z	AF_UNSPEC)rrrrrasrcCsbd}d}t��rdStjrRz"t�tj�}|�|df�d}Wntk
rPYnX|r^|��|S)z6 Returns True if the system can bind an IPv6 address. NFrT)rZis_appengine_sandboxr�has_ipv6ZAF_INET6r�	Exceptionr)rrr!rrr�	_has_ipv6lsr#z::1)Z
__future__rr�waitrrZcontribrr
rrrrr#r rrrr�<module>s�
8site-packages/pip/_vendor/urllib3/util/__pycache__/queue.cpython-38.pyc000064400000002004151446177000022026 0ustar00U

��.e��@sDddlZddlmZddlmZejr.ddlZGdd�dej�ZdS)�N�)�six��queuec@s0eZdZdd�Zefdd�Zdd�Zdd�Zd	S)
�	LifoQueuecCst��|_dS�N)�collections�dequer)�self�_�r�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/queue.py�_initszLifoQueue._initcCs
||j�Srr)r
�lenrrr
�_qsizeszLifoQueue._qsizecCs|j�|�dSr)r�append)r
�itemrrr
�_putszLifoQueue._putcCs
|j��Sr)r�pop)r
rrr
�_getszLifoQueue._getN)�__name__�
__module__�__qualname__rrrrrrrrr
r
sr)	rZpackagesrZpackages.six.movesrZPY2ZQueueZ_unused_module_Queuerrrrr
�<module>s
site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-38.opt-1.pyc000064400000021213151446177000023332 0ustar00U

��.e�&�@sTddlmZddlmZddlZddlmZe�Ze	edej�Z
Gdd�de�ZdS)	�)�absolute_import)�_GLOBAL_DEFAULT_TIMEOUTN�)�TimeoutStateError�	monotonicc@steZdZdZeZdeefdd�Zdd�Ze	dd��Z
e	d	d
��Zdd�Zd
d�Z
dd�Zedd��Zedd��ZdS)�Timeouta� Timeout configuration.

    Timeouts can be defined as a default for a pool::

        timeout = Timeout(connect=2.0, read=7.0)
        http = PoolManager(timeout=timeout)
        response = http.request('GET', 'http://example.com/')

    Or per-request (which overrides the default for the pool)::

        response = http.request('GET', 'http://example.com/', timeout=Timeout(10))

    Timeouts can be disabled by setting all the parameters to ``None``::

        no_timeout = Timeout(connect=None, read=None)
        response = http.request('GET', 'http://example.com/, timeout=no_timeout)


    :param total:
        This combines the connect and read timeouts into one; the read timeout
        will be set to the time leftover from the connect attempt. In the
        event that both a connect timeout and a total are specified, or a read
        timeout and a total are specified, the shorter timeout will be applied.

        Defaults to None.

    :type total: integer, float, or None

    :param connect:
        The maximum amount of time (in seconds) to wait for a connection
        attempt to a server to succeed. Omitting the parameter will default the
        connect timeout to the system default, probably `the global default
        timeout in socket.py
        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
        None will set an infinite timeout for connection attempts.

    :type connect: integer, float, or None

    :param read:
        The maximum amount of time (in seconds) to wait between consecutive
        read operations for a response from the server. Omitting the parameter
        will default the read timeout to the system default, probably `the
        global default timeout in socket.py
        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
        None will set an infinite timeout.

    :type read: integer, float, or None

    .. note::

        Many factors can affect the total amount of time for urllib3 to return
        an HTTP response.

        For example, Python's DNS resolver does not obey the timeout specified
        on the socket. Other factors that can affect total request time include
        high CPU load, high swap, the program running at a low priority level,
        or other behaviors.

        In addition, the read and total timeouts only measure the time between
        read operations on the socket connecting the client and the server,
        not the total amount of time for the request to return a complete
        response. For most requests, the timeout is raised because the server
        has not sent the first byte in the specified time. This is not always
        the case; if a server streams one byte every fifteen seconds, a timeout
        of 20 seconds will not trigger, even though the request will take
        several minutes to complete.

        If your goal is to cut off any request after a set amount of wall clock
        time, consider having a second "watcher" thread to cut off a slow
        request.
    NcCs4|�|d�|_|�|d�|_|�|d�|_d|_dS)N�connect�read�total)�_validate_timeout�_connect�_readr
�_start_connect)�selfr
rr	�r�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/timeout.py�__init___szTimeout.__init__cCsdt|�j|j|j|jfS)Nz!%s(connect=%r, read=%r, total=%r))�type�__name__rr
r
�rrrr�__str__es�zTimeout.__str__c	Cs�|tkr|jS|dks ||jkr$|St|t�r6td��zt|�Wn(ttfk
rjtd||f��YnXz|dkr�td||f��Wn$tk
r�td||f��YnX|S)a� Check that a timeout attribute is valid.

        :param value: The timeout value to validate
        :param name: The name of the timeout attribute to validate. This is
            used to specify in error messages.
        :return: The validated and casted version of the given value.
        :raises ValueError: If it is a numeric value less than or equal to
            zero, or the type is not an integer, float, or None.
        NzDTimeout cannot be a boolean value. It must be an int, float or None.z>Timeout value %s was %s, but it must be an int, float or None.rzdAttempted to set %s timeout to %s, but the timeout cannot be set to a value less than or equal to 0.)�_Default�DEFAULT_TIMEOUT�
isinstance�bool�
ValueError�float�	TypeError)�cls�value�namerrrrms<
���
����
zTimeout._validate_timeoutcCst||d�S)a� Create a new Timeout from a legacy timeout value.

        The timeout value used by httplib.py sets the same timeout on the
        connect(), and recv() socket requests. This creates a :class:`Timeout`
        object that sets the individual timeouts to the ``timeout`` value
        passed to this function.

        :param timeout: The legacy timeout value.
        :type timeout: integer, float, sentinel default object, or None
        :return: Timeout object
        :rtype: :class:`Timeout`
        )r	r)r)rZtimeoutrrr�
from_float�szTimeout.from_floatcCst|j|j|jd�S)a Create a copy of the timeout object

        Timeout properties are stored per-pool but each request needs a fresh
        Timeout object to ensure each one has its own start/stop configured.

        :return: a copy of the timeout object
        :rtype: :class:`Timeout`
        )rr	r
)rrr
r
rrrr�clone�sz
Timeout.clonecCs |jdk	rtd��t�|_|jS)z� Start the timeout clock, used during a connect() attempt

        :raises urllib3.exceptions.TimeoutStateError: if you attempt
            to start a timer that has been started already.
        Nz'Timeout timer has already been started.�rr�current_timerrrr�
start_connect�s
zTimeout.start_connectcCs|jdkrtd��t�|jS)a Gets the time elapsed since the call to :meth:`start_connect`.

        :return: Elapsed time in seconds.
        :rtype: float
        :raises urllib3.exceptions.TimeoutStateError: if you attempt
            to get duration for a timer that hasn't been started.
        Nz:Can't get connect duration for timer that has not started.r#rrrr�get_connect_duration�s

�zTimeout.get_connect_durationcCs:|jdkr|jS|jdks&|j|jkr,|jSt|j|j�S)a" Get the value to use when setting a connection timeout.

        This will be a positive float or integer, the value None
        (never timeout), or the default system timeout.

        :return: Connect timeout.
        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
        N)r
rr�minrrrr�connect_timeout�s


zTimeout.connect_timeoutcCs�|jdk	rX|j|jk	rX|jdk	rX|j|jk	rX|jdkr<|jStdt|j|��|j��S|jdk	r�|j|jk	r�td|j|���S|jSdS)a� Get the value for the read timeout.

        This assumes some time has elapsed in the connection timeout and
        computes the read timeout appropriately.

        If self.total is set, the read timeout is dependent on the amount of
        time taken by the connect timeout. If the connection time has not been
        established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
        raised.

        :return: Value to use for the read timeout.
        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
        :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
            has not yet been called on this object.
        Nr)r
rr
r�maxr'r&rrrr�read_timeout�s�
��
�
zTimeout.read_timeout)r�
__module__�__qualname__�__doc__rrrrr�classmethodrr!r"r%r&�propertyr(r*rrrrrsI
-

r)Z
__future__rZsocketr�time�
exceptionsr�objectr�getattrr$rrrrr�<module>ssite-packages/pip/_vendor/urllib3/util/__pycache__/wait.cpython-38.pyc000064400000006005151446177000021653 0ustar00U

��.e�@s�ddlZddlmZddlZddlZzddlmZWn ek
rTddlmZYnXdddgZGdd�de	�Z
ejd	kr�d
d�Zndd�Zddd�Z
ddd�Zdd�Zdd�Zdd�addd�Zddd�ZdS)�N)�partial)�	monotonic)�time�NoWayToWaitForSocketError�
wait_for_read�wait_for_writec@seZdZdS)rN)�__name__�
__module__�__qualname__�rr�A/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/wait.pyrs)��cCs||�S)Nr)�fn�timeoutrrr�_retry_on_intr*src
Cs�|dkrtd�}n
t�|}z
||�WSttjfk
r�}zF|jdtjkrR�n.|t�}|dkrhd}|td�krxd}WY�qW5d}~XYqXqdS)N�infr)�floatr�OSError�select�error�args�errnoZEINTR)rrZdeadline�errrr0s



Fc
Csd|s|std��g}g}|r&|�|�|r4|�|�ttj|||�}t||�\}}}	t|p`|p`|	�S)N�2must specify at least one of read=True, write=True)�RuntimeError�appendrrr�bool)
�sock�read�writerZrcheckZwcheckrZrreadyZwreadyZxreadyrrr�select_wait_for_socketGs

r!cs^|s|std��d}|r"|tjO}|r0|tjO}t�����||��fdd�}tt||��S)Nrrcs|dk	r|d9}��|�S)Ni�)�poll)�t�Zpoll_objrr�do_pollfsz%poll_wait_for_socket.<locals>.do_poll)rrZPOLLINZPOLLOUTr"�registerrr)rrr r�maskr%rr$r�poll_wait_for_socketZs

r(cOstd��dS)Nzno select-equivalent available)r�r�kwargsrrr�null_wait_for_socketnsr+c	Cs<zt��}t|jd�Wnttfk
r2YdSXdSdS)NrFT)rr"r�AttributeErrorrr$rrr�_have_working_pollrsr-cOs*t�rtanttd�rtantat||�S)Nr)r-r(�wait_for_socket�hasattrrr!r+r)rrrr.s
r.cCst|d|d�S)z� Waits for reading to be available on a given socket.
    Returns True if the socket is readable, or False if the timeout expired.
    T)rr�r.�rrrrrr�scCst|d|d�S)z� Waits for writing to be available on a given socket.
    Returns True if the socket is readable, or False if the timeout expired.
    T)r rr0r1rrrr�s)FFN)FFN)N)N)r�	functoolsrr�sysrr�ImportError�__all__�	Exceptionr�version_inforr!r(r+r-r.rrrrrr�<module>s&






site-packages/pip/_vendor/urllib3/util/__pycache__/response.cpython-38.opt-1.pyc000064400000003635151446177000023512 0ustar00U

��.e
�@s@ddlmZddlmZddlmZdd�Zdd�Zd	d
�Z	dS)�)�absolute_import�)�http_client)�HeaderParsingErrorcCslz
|��WStk
rYnXz|jWStk
r<YnXz|jdkWStk
r^YnXtd��dS)zt
    Checks whether a given file-like object is closed.

    :param obj:
        The file-like object to check.
    Nz)Unable to determine whether fp is closed.)Zisclosed�AttributeError�closed�fp�
ValueError)�obj�r�E/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/response.py�is_fp_closeds
r
cCsvt|tj�std�t|����t|dd�}t|dd�}d}|r^|��s^|�}t|tt	f�r^|}|sf|rrt
||d��dS)aP
    Asserts whether all headers have been successfully parsed.
    Extracts encountered errors from the result of parsing headers.

    Only works on Python 3.

    :param headers: Headers to verify.
    :type headers: `httplib.HTTPMessage`.

    :raises urllib3.exceptions.HeaderParsingError:
        If parsing errors are found.
    z"expected httplib.Message, got {0}.�defectsN�get_payload)r�
unparsed_data)�
isinstance�httplibZHTTPMessage�	TypeError�format�type�getattrZis_multipart�bytes�strr)ZheadersrrrZpayloadrrr�assert_header_parsing&srcCs$|j}t|t�r|dkS|��dkS)z�
    Checks whether the request of a response has been a HEAD-request.
    Handles the quirks of AppEngine.

    :param conn:
    :type conn: :class:`httplib.HTTPResponse`
    �ZHEAD)�_methodr�int�upper)Zresponse�methodrrr�is_response_to_headJs	
rN)
Z
__future__rZpackages.six.movesrr�
exceptionsrr
rrrrrr�<module>s
$site-packages/pip/_vendor/urllib3/util/__pycache__/connection.cpython-38.pyc000064400000006124151446177000023050 0ustar00U

��.e�@snddlmZddlZddlmZmZddlmZdd�Zej	ddfd	d
�Z
dd�Zd
d�Zdd�Z
e
d�ZdS)�)�absolute_importN�)�NoWayToWaitForSocketError�
wait_for_read�)�_appengine_environcCsNt|dd�}|dkrdS|dkr$dSzt|dd�WStk
rHYdSXdS)a 
    Returns True if the connection is dropped and should be closed.

    :param conn:
        :class:`httplib.HTTPConnection` object.

    Note: For platforms like AppEngine, this will always return ``False`` to
    let the platform handle connection recycling transparently for us.
    �sockFNTg)�timeout)�getattrrr)Zconnr�r�G/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/connection.py�is_connection_droppeds
r
cCs�|\}}|�d�r|�d�}d}t�}t�|||tj�D]�}|\}	}
}}}
d}zNt�|	|
|�}t||�|tjk	r||�|�|r�|�	|�|�
|
�|WStjk
r�}z|}|dk	r�|��d}W5d}~XYq8Xq8|dk	r�|�t�d��dS)adConnect to *address* and return the socket object.

    Convenience function.  Connect to *address* (a 2-tuple ``(host,
    port)``) and return the socket object.  Passing the optional
    *timeout* parameter will set the timeout on the socket instance
    before attempting to connect.  If no *timeout* is supplied, the
    global default timeout setting returned by :func:`getdefaulttimeout`
    is used.  If *source_address* is set it must be a tuple of (host, port)
    for the socket to bind as a source address before making the connection.
    An host of '' or port 0 tells the OS to use the default.
    �[z[]Nz!getaddrinfo returns an empty list)
�
startswith�strip�allowed_gai_family�socketZgetaddrinfoZSOCK_STREAM�_set_socket_options�_GLOBAL_DEFAULT_TIMEOUTZ
settimeout�bindZconnect�error�close)Zaddressr	Zsource_addressZsocket_options�hostZport�err�family�resZafZsocktype�protoZ	canonnameZsar�errr�create_connection!s2







rcCs$|dkrdS|D]}|j|�qdS)N)Z
setsockopt)rZoptions�optrrrrYsrcCstj}trtj}|S)z�This function is designed to work in the context of
    getaddrinfo, where family=socket.AF_UNSPEC is the default and
    will perform a DNS search for both IPv6 and IPv4 records.)rZAF_INET�HAS_IPV6Z	AF_UNSPEC)rrrrrasrcCsbd}d}t��rdStjrRz"t�tj�}|�|df�d}Wntk
rPYnX|r^|��|S)z6 Returns True if the system can bind an IPv6 address. NFrT)rZis_appengine_sandboxr�has_ipv6ZAF_INET6r�	Exceptionr)rrr!rrr�	_has_ipv6lsr#z::1)Z
__future__rr�waitrrZcontribrr
rrrrr#r rrrr�<module>s�
8site-packages/pip/_vendor/urllib3/util/__pycache__/timeout.cpython-38.pyc000064400000021213151446177000022373 0ustar00U

��.e�&�@sTddlmZddlmZddlZddlmZe�Ze	edej�Z
Gdd�de�ZdS)	�)�absolute_import)�_GLOBAL_DEFAULT_TIMEOUTN�)�TimeoutStateError�	monotonicc@steZdZdZeZdeefdd�Zdd�Ze	dd��Z
e	d	d
��Zdd�Zd
d�Z
dd�Zedd��Zedd��ZdS)�Timeouta� Timeout configuration.

    Timeouts can be defined as a default for a pool::

        timeout = Timeout(connect=2.0, read=7.0)
        http = PoolManager(timeout=timeout)
        response = http.request('GET', 'http://example.com/')

    Or per-request (which overrides the default for the pool)::

        response = http.request('GET', 'http://example.com/', timeout=Timeout(10))

    Timeouts can be disabled by setting all the parameters to ``None``::

        no_timeout = Timeout(connect=None, read=None)
        response = http.request('GET', 'http://example.com/, timeout=no_timeout)


    :param total:
        This combines the connect and read timeouts into one; the read timeout
        will be set to the time leftover from the connect attempt. In the
        event that both a connect timeout and a total are specified, or a read
        timeout and a total are specified, the shorter timeout will be applied.

        Defaults to None.

    :type total: integer, float, or None

    :param connect:
        The maximum amount of time (in seconds) to wait for a connection
        attempt to a server to succeed. Omitting the parameter will default the
        connect timeout to the system default, probably `the global default
        timeout in socket.py
        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
        None will set an infinite timeout for connection attempts.

    :type connect: integer, float, or None

    :param read:
        The maximum amount of time (in seconds) to wait between consecutive
        read operations for a response from the server. Omitting the parameter
        will default the read timeout to the system default, probably `the
        global default timeout in socket.py
        <http://hg.python.org/cpython/file/603b4d593758/Lib/socket.py#l535>`_.
        None will set an infinite timeout.

    :type read: integer, float, or None

    .. note::

        Many factors can affect the total amount of time for urllib3 to return
        an HTTP response.

        For example, Python's DNS resolver does not obey the timeout specified
        on the socket. Other factors that can affect total request time include
        high CPU load, high swap, the program running at a low priority level,
        or other behaviors.

        In addition, the read and total timeouts only measure the time between
        read operations on the socket connecting the client and the server,
        not the total amount of time for the request to return a complete
        response. For most requests, the timeout is raised because the server
        has not sent the first byte in the specified time. This is not always
        the case; if a server streams one byte every fifteen seconds, a timeout
        of 20 seconds will not trigger, even though the request will take
        several minutes to complete.

        If your goal is to cut off any request after a set amount of wall clock
        time, consider having a second "watcher" thread to cut off a slow
        request.
    NcCs4|�|d�|_|�|d�|_|�|d�|_d|_dS)N�connect�read�total)�_validate_timeout�_connect�_readr
�_start_connect)�selfr
rr	�r�D/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/timeout.py�__init___szTimeout.__init__cCsdt|�j|j|j|jfS)Nz!%s(connect=%r, read=%r, total=%r))�type�__name__rr
r
�rrrr�__str__es�zTimeout.__str__c	Cs�|tkr|jS|dks ||jkr$|St|t�r6td��zt|�Wn(ttfk
rjtd||f��YnXz|dkr�td||f��Wn$tk
r�td||f��YnX|S)a� Check that a timeout attribute is valid.

        :param value: The timeout value to validate
        :param name: The name of the timeout attribute to validate. This is
            used to specify in error messages.
        :return: The validated and casted version of the given value.
        :raises ValueError: If it is a numeric value less than or equal to
            zero, or the type is not an integer, float, or None.
        NzDTimeout cannot be a boolean value. It must be an int, float or None.z>Timeout value %s was %s, but it must be an int, float or None.rzdAttempted to set %s timeout to %s, but the timeout cannot be set to a value less than or equal to 0.)�_Default�DEFAULT_TIMEOUT�
isinstance�bool�
ValueError�float�	TypeError)�cls�value�namerrrrms<
���
����
zTimeout._validate_timeoutcCst||d�S)a� Create a new Timeout from a legacy timeout value.

        The timeout value used by httplib.py sets the same timeout on the
        connect(), and recv() socket requests. This creates a :class:`Timeout`
        object that sets the individual timeouts to the ``timeout`` value
        passed to this function.

        :param timeout: The legacy timeout value.
        :type timeout: integer, float, sentinel default object, or None
        :return: Timeout object
        :rtype: :class:`Timeout`
        )r	r)r)rZtimeoutrrr�
from_float�szTimeout.from_floatcCst|j|j|jd�S)a Create a copy of the timeout object

        Timeout properties are stored per-pool but each request needs a fresh
        Timeout object to ensure each one has its own start/stop configured.

        :return: a copy of the timeout object
        :rtype: :class:`Timeout`
        )rr	r
)rrr
r
rrrr�clone�sz
Timeout.clonecCs |jdk	rtd��t�|_|jS)z� Start the timeout clock, used during a connect() attempt

        :raises urllib3.exceptions.TimeoutStateError: if you attempt
            to start a timer that has been started already.
        Nz'Timeout timer has already been started.�rr�current_timerrrr�
start_connect�s
zTimeout.start_connectcCs|jdkrtd��t�|jS)a Gets the time elapsed since the call to :meth:`start_connect`.

        :return: Elapsed time in seconds.
        :rtype: float
        :raises urllib3.exceptions.TimeoutStateError: if you attempt
            to get duration for a timer that hasn't been started.
        Nz:Can't get connect duration for timer that has not started.r#rrrr�get_connect_duration�s

�zTimeout.get_connect_durationcCs:|jdkr|jS|jdks&|j|jkr,|jSt|j|j�S)a" Get the value to use when setting a connection timeout.

        This will be a positive float or integer, the value None
        (never timeout), or the default system timeout.

        :return: Connect timeout.
        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
        N)r
rr�minrrrr�connect_timeout�s


zTimeout.connect_timeoutcCs�|jdk	rX|j|jk	rX|jdk	rX|j|jk	rX|jdkr<|jStdt|j|��|j��S|jdk	r�|j|jk	r�td|j|���S|jSdS)a� Get the value for the read timeout.

        This assumes some time has elapsed in the connection timeout and
        computes the read timeout appropriately.

        If self.total is set, the read timeout is dependent on the amount of
        time taken by the connect timeout. If the connection time has not been
        established, a :exc:`~urllib3.exceptions.TimeoutStateError` will be
        raised.

        :return: Value to use for the read timeout.
        :rtype: int, float, :attr:`Timeout.DEFAULT_TIMEOUT` or None
        :raises urllib3.exceptions.TimeoutStateError: If :meth:`start_connect`
            has not yet been called on this object.
        Nr)r
rr
r�maxr'r&rrrr�read_timeout�s�
��
�
zTimeout.read_timeout)r�
__module__�__qualname__�__doc__rrrrr�classmethodrr!r"r%r&�propertyr(r*rrrrrsI
-

r)Z
__future__rZsocketr�time�
exceptionsr�objectr�getattrr$rrrrr�<module>ssite-packages/pip/_vendor/urllib3/util/__pycache__/retry.cpython-38.pyc000064400000031221151446177000022052 0ustar00U

��.eZ<�@s�ddlmZddlZddlZddlmZddlmZddlZddl	Z	ddl
mZmZm
Z
mZmZmZddlmZe�e�Zedd	d
ddd
g�ZGdd�de�Zed�e_dS)�)�absolute_importN)�
namedtuple)�	takewhile�)�ConnectTimeoutError�
MaxRetryError�
ProtocolError�ReadTimeoutError�
ResponseError�
InvalidHeader)�six�RequestHistory�method�url�error�status�redirect_locationc
@s�eZdZdZeddddddg�Zedd	d
g�Zedg�ZdZd
ddddeddddddef
dd�Z	dd�Z
ed2dd��Zdd�Z
dd�Zdd�Zd3dd�Zdd �Zd4d!d"�Zd#d$�Zd%d&�Zd'd(�Zd5d*d+�Zd,d-�Zd6d.d/�Zd0d1�ZdS)7�Retrya3 Retry configuration.

    Each retry attempt will create a new Retry object with updated values, so
    they can be safely reused.

    Retries can be defined as a default for a pool::

        retries = Retry(connect=5, read=2, redirect=5)
        http = PoolManager(retries=retries)
        response = http.request('GET', 'http://example.com/')

    Or per-request (which overrides the default for the pool)::

        response = http.request('GET', 'http://example.com/', retries=Retry(10))

    Retries can be disabled by passing ``False``::

        response = http.request('GET', 'http://example.com/', retries=False)

    Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
    retries are disabled, in which case the causing exception will be raised.

    :param int total:
        Total number of retries to allow. Takes precedence over other counts.

        Set to ``None`` to remove this constraint and fall back on other
        counts. It's a good idea to set this to some sensibly-high value to
        account for unexpected edge cases and avoid infinite retry loops.

        Set to ``0`` to fail on the first retry.

        Set to ``False`` to disable and imply ``raise_on_redirect=False``.

    :param int connect:
        How many connection-related errors to retry on.

        These are errors raised before the request is sent to the remote server,
        which we assume has not triggered the server to process the request.

        Set to ``0`` to fail on the first retry of this type.

    :param int read:
        How many times to retry on read errors.

        These errors are raised after the request was sent to the server, so the
        request may have side-effects.

        Set to ``0`` to fail on the first retry of this type.

    :param int redirect:
        How many redirects to perform. Limit this to avoid infinite redirect
        loops.

        A redirect is a HTTP response with a status code 301, 302, 303, 307 or
        308.

        Set to ``0`` to fail on the first retry of this type.

        Set to ``False`` to disable and imply ``raise_on_redirect=False``.

    :param int status:
        How many times to retry on bad status codes.

        These are retries made on responses, where status code matches
        ``status_forcelist``.

        Set to ``0`` to fail on the first retry of this type.

    :param iterable method_whitelist:
        Set of uppercased HTTP method verbs that we should retry on.

        By default, we only retry on methods which are considered to be
        idempotent (multiple requests with the same parameters end with the
        same state). See :attr:`Retry.DEFAULT_METHOD_WHITELIST`.

        Set to a ``False`` value to retry on any verb.

    :param iterable status_forcelist:
        A set of integer HTTP status codes that we should force a retry on.
        A retry is initiated if the request method is in ``method_whitelist``
        and the response status code is in ``status_forcelist``.

        By default, this is disabled with ``None``.

    :param float backoff_factor:
        A backoff factor to apply between attempts after the second try
        (most errors are resolved immediately by a second try without a
        delay). urllib3 will sleep for::

            {backoff factor} * (2 ** ({number of total retries} - 1))

        seconds. If the backoff_factor is 0.1, then :func:`.sleep` will sleep
        for [0.0s, 0.2s, 0.4s, ...] between retries. It will never be longer
        than :attr:`Retry.BACKOFF_MAX`.

        By default, backoff is disabled (set to 0).

    :param bool raise_on_redirect: Whether, if the number of redirects is
        exhausted, to raise a MaxRetryError, or to return a response with a
        response code in the 3xx range.

    :param bool raise_on_status: Similar meaning to ``raise_on_redirect``:
        whether we should raise an exception, or return a response,
        if status falls in ``status_forcelist`` range and retries have
        been exhausted.

    :param tuple history: The history of the request encountered during
        each call to :meth:`~Retry.increment`. The list is in the order
        the requests occurred. Each list item is of class :class:`RequestHistory`.

    :param bool respect_retry_after_header:
        Whether to respect Retry-After header on status codes defined as
        :attr:`Retry.RETRY_AFTER_STATUS_CODES` or not.

    :param iterable remove_headers_on_redirect:
        Sequence of headers to remove from the request when a response
        indicating a redirect is returned before firing off the redirected
        request.
    ZHEADZGETZPUTZDELETEZOPTIONSZTRACEi�i�i�Z
Authorization�x�
NrTcCs�||_||_||_||_|dks(|dkr0d}d}	||_|p>t�|_||_||_|	|_	|
|_
|pbt�|_||_
tdd�|
D��|_dS)NFrcSsg|]}|���qS�)�lower)�.0�hrr�B/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/retry.py�
<listcomp>�sz"Retry.__init__.<locals>.<listcomp>)�total�connect�readr�redirect�set�status_forcelist�method_whitelist�backoff_factor�raise_on_redirect�raise_on_status�tuple�history�respect_retry_after_header�	frozenset�remove_headers_on_redirect)�selfrrrrrr"r!r#r$r%r'r(r*rrr�__init__�s$�zRetry.__init__cKsTt|j|j|j|j|j|j|j|j|j	|j
|j|j|j
d�
}|�|�t|�f|�S)N)
rrrrrr"r!r#r$r%r'r*r()�dictrrrrrr"r!r#r$r%r'r*r(�update�type)r+�kwZparamsrrr�new�s"�
z	Retry.newcCsR|dkr|dk	r|n|j}t|t�r(|St|�o2d}|||d�}t�d||�|S)z4 Backwards-compatibility for the old retries format.N)rz!Converted retries value: %r -> %r)�DEFAULT�
isinstancer�bool�log�debug)�clsZretriesr�defaultZnew_retriesrrr�from_int�s
zRetry.from_intcCsFtttdd�t|j����}|dkr(dS|jd|d}t|j|�S)zJ Formula for computing the current backoff

        :rtype: float
        cSs
|jdkS)N)r)�xrrr�<lambda>��z(Retry.get_backoff_time.<locals>.<lambda>�rr)�len�listr�reversedr'r#�min�BACKOFF_MAX)r+Zconsecutive_errors_lenZ
backoff_valuerrr�get_backoff_time�s��zRetry.get_backoff_timecCs\t�d|�rt|�}n6tj�|�}|dkr6td|��t�|�}|t��}|dkrXd}|S)Nz^\s*[0-9]+\s*$zInvalid Retry-After header: %sr)	�re�match�int�emailZutilsZ	parsedater�time�mktime)r+�retry_afterZsecondsZretry_date_tupleZ
retry_daterrr�parse_retry_after�s

zRetry.parse_retry_aftercCs |�d�}|dkrdS|�|�S)z* Get the value of Retry-After in seconds. zRetry-AfterN)Z	getheaderrK�r+�responserJrrr�get_retry_after	s
zRetry.get_retry_aftercCs |�|�}|rt�|�dSdS)NTF)rNrH�sleeprLrrr�sleep_for_retrys


zRetry.sleep_for_retrycCs"|��}|dkrdSt�|�dS)Nr)rCrHrO)r+Zbackoffrrr�_sleep_backoffszRetry._sleep_backoffcCs(|jr|r|�|�}|rdS|��dS)aC Sleep between retry attempts.

        This method will respect a server's ``Retry-After`` response header
        and sleep the duration of the time requested. If that is not present, it
        will use an exponential backoff. By default, the backoff factor is 0 and
        this method will return immediately.
        N)r(rPrQ)r+rMZsleptrrrrO!s
	

zRetry.sleepcCs
t|t�S)z{ Errors when we're fairly sure that the server did not receive the
        request, so it should be safe to retry.
        )r3r�r+�errrrr�_is_connection_error1szRetry._is_connection_errorcCst|ttf�S)z� Errors that occur after the request has been started, so we should
        assume that the server began processing it.
        )r3r	rrRrrr�_is_read_error7szRetry._is_read_errorcCs|jr|��|jkrdSdS)z| Checks if a given HTTP method should be retried upon, depending if
        it is included on the method whitelist.
        FT)r"�upper)r+rrrr�_is_method_retryable=szRetry._is_method_retryableFcCs<|�|�sdS|jr"||jkr"dS|jo:|jo:|o:||jkS)ax Is this method/status code retryable? (Based on whitelists and control
        variables such as the number of total retries to allow, whether to
        respect the Retry-After header, whether this header is present, and
        whether the returned status code is on the list of status codes to
        be retried upon on the presence of the aforementioned header)
        FT)rWr!rr(�RETRY_AFTER_STATUS_CODES)r+r�status_codeZhas_retry_afterrrr�is_retryFs
���zRetry.is_retrycCs:|j|j|j|j|jf}ttd|��}|s.dSt|�dkS)z Are we out of retries? NFr)rrrrrr?�filterrA)r+Zretry_countsrrr�is_exhaustedZs
zRetry.is_exhaustedcCs�|jdkr |r t�t|�||��|j}|dk	r6|d8}|j}|j}	|j}
|j}d}d}
d}|r�|�|�r�|dkr�t�t|�||��n|dk	r�|d8}n�|r�|�	|�r�|	dks�|�
|�s�t�t|�||��n|	dk	r�|	d8}	np|�r|���r|
dk	r�|
d8}
d}|��}|j}
n<tj
}|�rL|j�rL|dk	�r6|d8}tjj|jd�}|j}
|jt||||
|�f}|j|||	|
||d�}|���r�t|||�p�t|���t�d||�|S)	a� Return a new Retry object with incremented retry counters.

        :param response: A response object, or None, if the server did not
            return a response.
        :type response: :class:`~urllib3.response.HTTPResponse`
        :param Exception error: An error encountered during the request, or
            None if the response was received successfully.

        :return: A new ``Retry`` object.
        FNr=�unknownztoo many redirects)rY)rrrrrr'z$Incremented Retry for (url='%s'): %r)rrZreraiser/rrrrrTrUrWZget_redirect_locationr
Z
GENERIC_ERRORZSPECIFIC_ERROR�formatr'r
r1r\rr5r6)r+rrrMrZ_poolZ_stacktracerrrrZstatus_count�causerrr'Z	new_retryrrr�	incrementcsb


��	
zRetry.incrementcCsdjt|�|d�S)Nz|{cls.__name__}(total={self.total}, connect={self.connect}, read={self.read}, redirect={self.redirect}, status={self.status}))r7r+)r^r/)r+rrr�__repr__�s
��zRetry.__repr__)TN)N)N)F)NNNNNN)�__name__�
__module__�__qualname__�__doc__r)ZDEFAULT_METHOD_WHITELISTrXZ"DEFAULT_REDIRECT_HEADERS_BLACKLISTrBr,r1�classmethodr9rCrKrNrPrQrOrTrUrWrZr\r`rarrrrrsVx�
�
&



	
�
Wr�)Z
__future__rrHZlogging�collectionsr�	itertoolsrrGrD�
exceptionsrrrr	r
rZpackagesrZ	getLoggerrbr5r
�objectrr2rrrr�<module>s$ 
�(site-packages/pip/_vendor/urllib3/util/__pycache__/ssl_.cpython-38.pyc000064400000023135151446177000021652 0ustar00U

��.eS7�@s(ddlmZddlZddlZddlZddlZddlmZmZddl	m
Z
mZmZddl
mZmZddlmZmZmZdd	lmZdZd
Zd
Zd
Ze
eed�Zdd
�Zeede�Zz(ddlZddlmZm Z ddlmZWne!k
r�YnXzddlm"Z"e"Z#WnJe!k
�rLzddlm#Z"e"Z#Wne!k
�rFdZ#Z"YnXYnXzddlm$Z$m%Z%m&Z&Wn"e!k
�r�d\Z$Z%dZ&YnXd�'dddddddddd d!d"d#d$g�Z(zdd%lmZWn&e!k
�r�Gd&d'�d'e)�ZYnXd(d)�Z*d*d+�Z+d,d-�Z,d6d.d/�Z-d7d0d1�Z.d2d3�Z/d4d5�Z0dS)8�)�absolute_importN)�hexlify�	unhexlify)�md5�sha1�sha256�)�IPV4_RE�BRACELESS_IPV6_ADDRZ_RE�)�SSLError�InsecurePlatformWarning�SNIMissingWarning)�sixF)� �(�@cCsDtt|�t|��}tt|�t|��D]\}}|||AO}q&|dkS)z�
    Compare two digests of equal length in constant time.

    The digests must be of type str/bytes.
    Returns True if the digests match, and False otherwise.
    r)�abs�len�zip�	bytearray)�a�b�result�l�r�r�A/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/ssl_.py�_const_compare_digest_backportsrZcompare_digest)�wrap_socket�
CERT_REQUIRED)�HAS_SNI)�PROTOCOL_TLS)�PROTOCOL_SSLv23)�OP_NO_SSLv2�OP_NO_SSLv3�OP_NO_COMPRESSION)iii�:zECDHE+AESGCMzECDHE+CHACHA20z
DHE+AESGCMzDHE+CHACHA20zECDH+AESGCMz	DH+AESGCMzECDH+AESzDH+AESz
RSA+AESGCMzRSA+AESz!aNULLz!eNULLz!MD5z!DSS)�
SSLContextc@s8eZdZdd�Zdd�Zd
dd�Zdd	�Zddd�ZdS)r(cCs6||_d|_tj|_d|_d|_d|_d|_d|_	dS)NFr)
�protocol�check_hostname�sslZ	CERT_NONE�verify_mode�ca_certs�options�certfile�keyfile�ciphers)�selfZprotocol_versionrrr�__init__kszSSLContext.__init__cCs||_||_dS�N)r/r0)r2r/r0rrr�load_cert_chainvszSSLContext.load_cert_chainNcCs||_|dk	rtd��dS)Nz-CA directories not supported in older Pythons)r-r)r2ZcafileZcapathrrr�load_verify_locationszsz SSLContext.load_verify_locationscCs
||_dSr4�r1)r2Zcipher_suiterrr�set_ciphers�szSSLContext.set_ciphersFcCs>t�dt�|j|j|j|j|j|d�}t|fd|j	i|��S)Na2A true SSLContext object is not available. This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail. You can upgrade to a newer version of Python to solve this. For more information, see https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings)r0r/r-�	cert_reqs�ssl_version�server_sider1)
�warnings�warnr
r0r/r-r,r)rr1)r2Zsocket�server_hostnamer;�kwargsrrrr�s�
�zSSLContext.wrap_socket)NN)NF)�__name__�
__module__�__qualname__r3r5r6r8rrrrrr(js

r(cCsn|�dd���}t|�}t�|�}|s4td�|���t|���}||��	�}t
||�sjtd�|t|����dS)z�
    Checks if given fingerprint matches the supplied certificate.

    :param cert:
        Certificate as bytes object.
    :param fingerprint:
        Fingerprint as string of hexdigits, can be interspersed by colons.
    r'�z"Fingerprint of invalid length: {0}z6Fingerprints did not match. Expected "{0}", got "{1}".N)�replace�lowerr�HASHFUNC_MAP�getr�formatr�encodeZdigest�_const_compare_digestr)ZcertZfingerprintZ
digest_lengthZhashfuncZfingerprint_bytesZcert_digestrrr�assert_fingerprint�s


��rKcCs@|dkrtSt|t�r<tt|d�}|dkr8ttd|�}|S|S)a�
    Resolves the argument to a numeric constant, which can be passed to
    the wrap_socket function/method from the ssl module.
    Defaults to :data:`ssl.CERT_NONE`.
    If given a string it is assumed to be the name of the constant in the
    :mod:`ssl` module or its abbreviation.
    (So you can specify `REQUIRED` instead of `CERT_REQUIRED`.
    If it's neither `None` nor a string we assume it is already the numeric
    constant which can directly be passed to wrap_socket.
    NZCERT_)r �
isinstance�str�getattrr+��	candidate�resrrr�resolve_cert_reqs�s
rRcCs@|dkrtSt|t�r<tt|d�}|dkr8ttd|�}|S|S)z 
    like resolve_cert_reqs
    NZ	PROTOCOL_)r"rLrMrNr+rOrrr�resolve_ssl_version�s
rScCs�t|pt�}|�|pt�|dkr(tjn|}|dkrPd}|tO}|tO}|tO}|j	|O_	|tjksrt
jdkr�t|dd�dk	r�d|_
||_t|dd�dk	r�d|_|S)a�All arguments have the same meaning as ``ssl_wrap_socket``.

    By default, this function does a lot of the same work that
    ``ssl.create_default_context`` does on Python 3.4+. It:

    - Disables SSLv2, SSLv3, and compression
    - Sets a restricted set of server ciphers

    If you wish to enable SSLv3, you can do::

        from pip._vendor.urllib3.util import ssl_
        context = ssl_.create_urllib3_context()
        context.options &= ~ssl_.OP_NO_SSLv3

    You can do the same to enable compression (substituting ``COMPRESSION``
    for ``SSLv3`` in the last line above).

    :param ssl_version:
        The desired protocol version to use. This will default to
        PROTOCOL_SSLv23 which will negotiate the highest protocol that both
        the server and your installation of OpenSSL support.
    :param cert_reqs:
        Whether to require the certificate verification. This defaults to
        ``ssl.CERT_REQUIRED``.
    :param options:
        Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
        ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``.
    :param ciphers:
        Which cipher suites to allow the server to select.
    :returns:
        Constructed SSLContext object with specified options
    :rtype: SSLContext
    Nr)����post_handshake_authTr*F)r(r"r8�DEFAULT_CIPHERSr+r r$r%r&r.�sys�version_inforNrWr,r*)r:r9r.r1�contextrrr�create_urllib3_context�s,$���r\c

CsB|}|dkrt|||d�}|s"|	r�z|�||	�Wq�tk
r\}zt|��W5d}~XYq�tk
r�}z|jtjkr�t|���W5d}~XYq�Xn|dkr�t|d�r�|��|r�|
dkr�t	|�r�td��|r�|
dkr�|�
||�n|�
|||
�|dk	�rt|��rt�r8t
�r,|dk	�r,|j||d�St�dt�|�|�S)a
    All arguments except for server_hostname, ssl_context, and ca_cert_dir have
    the same meaning as they do when using :func:`ssl.wrap_socket`.

    :param server_hostname:
        When SNI is supported, the expected hostname of the certificate
    :param ssl_context:
        A pre-made :class:`SSLContext` object. If none is provided, one will
        be created using :func:`create_urllib3_context`.
    :param ciphers:
        A string of ciphers we wish the client to support.
    :param ca_cert_dir:
        A directory containing CA certificates in multiple separate files, as
        supported by OpenSSL's -CApath flag or the capath argument to
        SSLContext.load_verify_locations().
    :param key_password:
        Optional password if the keyfile is encrypted.
    Nr7�load_default_certsz5Client private key is encrypted, password is required)r>a�An HTTPS request has been made, but the SNI (Server Name Indication) extension to TLS is not available on this platform. This may cause the server to present an incorrect TLS certificate, which can cause validation failures. You can upgrade to a newer version of Python to solve this. For more information, see https://urllib3.readthedocs.io/en/latest/advanced-usage.html#ssl-warnings)r\r6�IOErrorr�OSError�errnoZENOENT�hasattrr]�_is_key_file_encryptedr5�is_ipaddress�IS_SECURETRANSPORTr!rr<r=r)
Zsockr0r/r9r-r>r:r1Zssl_contextZca_cert_dirZkey_passwordr[�errr�ssl_wrap_socket(sB����rfcCs2tjst|t�r|�d�}tt�|�p.t�|��S)z�Detects whether the hostname given is an IPv4 or IPv6 address.
    Also detects IPv6 addresses with Zone IDs.

    :param str hostname: Hostname to examine.
    :return: True if the hostname is an IP address, False otherwise.
    �ascii)	rZPY2rL�bytes�decode�boolr	�matchr
)Zhostnamerrrrc�s
rcc	Cs<t|d��(}|D]}d|krW5QR�dSqW5QRXdS)z*Detects if a key file is encrypted or not.rZ	ENCRYPTEDTF)�open)Zkey_file�f�linerrrrb�s
rb)NNNN)
NNNNNNNNNN)1Z
__future__rr`r<ZhmacrYZbinasciirrZhashlibrrrZurlr	r
�
exceptionsrr
rZpackagesrr(r!ZIS_PYOPENSSLrdrFrrNrJr+rr �ImportErrorr"r#r$r%r&�joinrX�objectrKrRrSr\rfrcrbrrrr�<module>s�

��.�
N�
Z
site-packages/pip/_vendor/urllib3/util/__pycache__/__init__.cpython-38.pyc000064400000001727151446177000022454 0ustar00U

��.e�@s�ddlmZddlmZddlmZddlmZddlm	Z	m
Z
mZmZm
Z
mZmZmZmZddlmZmZddlmZdd	lmZmZmZmZdd
lmZmZdZdS)
�)�absolute_import�)�is_connection_dropped)�make_headers)�is_fp_closed)	�
SSLContext�HAS_SNI�IS_PYOPENSSL�IS_SECURETRANSPORT�assert_fingerprint�resolve_cert_reqs�resolve_ssl_version�ssl_wrap_socket�PROTOCOL_TLS)�current_time�Timeout)�Retry)�get_host�	parse_url�split_first�Url)�
wait_for_read�wait_for_write)rr	r
rrrrrrrrrrrrrr
rrrrN) Z
__future__rZ
connectionrZrequestrZresponserZssl_rrr	r
rrr
rrZtimeoutrrZretryrZurlrrrr�waitrr�__all__�rr�E/usr/lib/python3.8/site-packages/pip/_vendor/urllib3/util/__init__.py�<module>s,site-packages/pip/_vendor/urllib3/util/__init__.py000064400000002016151446177000016156 0ustar00from __future__ import absolute_import

# For backwards compatibility, provide imports that used to be here.
from .connection import is_connection_dropped
from .request import make_headers
from .response import is_fp_closed
from .ssl_ import (
    SSLContext,
    HAS_SNI,
    IS_PYOPENSSL,
    IS_SECURETRANSPORT,
    assert_fingerprint,
    resolve_cert_reqs,
    resolve_ssl_version,
    ssl_wrap_socket,
    PROTOCOL_TLS,
)
from .timeout import current_time, Timeout

from .retry import Retry
from .url import get_host, parse_url, split_first, Url
from .wait import wait_for_read, wait_for_write

__all__ = (
    "HAS_SNI",
    "IS_PYOPENSSL",
    "IS_SECURETRANSPORT",
    "SSLContext",
    "PROTOCOL_TLS",
    "Retry",
    "Timeout",
    "Url",
    "assert_fingerprint",
    "current_time",
    "is_connection_dropped",
    "is_fp_closed",
    "get_host",
    "parse_url",
    "make_headers",
    "resolve_cert_reqs",
    "resolve_ssl_version",
    "split_first",
    "ssl_wrap_socket",
    "wait_for_read",
    "wait_for_write",
)
site-packages/pip/_vendor/urllib3/util/connection.py000064400000011034151446177000016556 0ustar00from __future__ import absolute_import
import socket
from .wait import NoWayToWaitForSocketError, wait_for_read
from ..contrib import _appengine_environ


def is_connection_dropped(conn):  # Platform-specific
    """
    Returns True if the connection is dropped and should be closed.

    :param conn:
        :class:`httplib.HTTPConnection` object.

    Note: For platforms like AppEngine, this will always return ``False`` to
    let the platform handle connection recycling transparently for us.
    """
    sock = getattr(conn, "sock", False)
    if sock is False:  # Platform-specific: AppEngine
        return False
    if sock is None:  # Connection already closed (such as by httplib).
        return True
    try:
        # Returns True if readable, which here means it's been dropped
        return wait_for_read(sock, timeout=0.0)
    except NoWayToWaitForSocketError:  # Platform-specific: AppEngine
        return False


# This function is copied from socket.py in the Python 2.7 standard
# library test suite. Added to its signature is only `socket_options`.
# One additional modification is that we avoid binding to IPv6 servers
# discovered in DNS if the system doesn't have IPv6 functionality.
def create_connection(
    address,
    timeout=socket._GLOBAL_DEFAULT_TIMEOUT,
    source_address=None,
    socket_options=None,
):
    """Connect to *address* and return the socket object.

    Convenience function.  Connect to *address* (a 2-tuple ``(host,
    port)``) and return the socket object.  Passing the optional
    *timeout* parameter will set the timeout on the socket instance
    before attempting to connect.  If no *timeout* is supplied, the
    global default timeout setting returned by :func:`getdefaulttimeout`
    is used.  If *source_address* is set it must be a tuple of (host, port)
    for the socket to bind as a source address before making the connection.
    An host of '' or port 0 tells the OS to use the default.
    """

    host, port = address
    if host.startswith("["):
        host = host.strip("[]")
    err = None

    # Using the value from allowed_gai_family() in the context of getaddrinfo lets
    # us select whether to work with IPv4 DNS records, IPv6 records, or both.
    # The original create_connection function always returns all records.
    family = allowed_gai_family()

    for res in socket.getaddrinfo(host, port, family, socket.SOCK_STREAM):
        af, socktype, proto, canonname, sa = res
        sock = None
        try:
            sock = socket.socket(af, socktype, proto)

            # If provided, set socket level options before connecting.
            _set_socket_options(sock, socket_options)

            if timeout is not socket._GLOBAL_DEFAULT_TIMEOUT:
                sock.settimeout(timeout)
            if source_address:
                sock.bind(source_address)
            sock.connect(sa)
            return sock

        except socket.error as e:
            err = e
            if sock is not None:
                sock.close()
                sock = None

    if err is not None:
        raise err

    raise socket.error("getaddrinfo returns an empty list")


def _set_socket_options(sock, options):
    if options is None:
        return

    for opt in options:
        sock.setsockopt(*opt)


def allowed_gai_family():
    """This function is designed to work in the context of
    getaddrinfo, where family=socket.AF_UNSPEC is the default and
    will perform a DNS search for both IPv6 and IPv4 records."""

    family = socket.AF_INET
    if HAS_IPV6:
        family = socket.AF_UNSPEC
    return family


def _has_ipv6(host):
    """ Returns True if the system can bind an IPv6 address. """
    sock = None
    has_ipv6 = False

    # App Engine doesn't support IPV6 sockets and actually has a quota on the
    # number of sockets that can be used, so just early out here instead of
    # creating a socket needlessly.
    # See https://github.com/urllib3/urllib3/issues/1446
    if _appengine_environ.is_appengine_sandbox():
        return False

    if socket.has_ipv6:
        # has_ipv6 returns true if cPython was compiled with IPv6 support.
        # It does not tell us if the system has IPv6 support enabled. To
        # determine that we must bind to an IPv6 address.
        # https://github.com/shazow/urllib3/pull/611
        # https://bugs.python.org/issue658327
        try:
            sock = socket.socket(socket.AF_INET6)
            sock.bind((host, 0))
            has_ipv6 = True
        except Exception:
            pass

    if sock:
        sock.close()
    return has_ipv6


HAS_IPV6 = _has_ipv6("::1")
site-packages/pip/_vendor/urllib3/util/request.py000064400000007355151446177000016122 0ustar00from __future__ import absolute_import
from base64 import b64encode

from ..packages.six import b, integer_types
from ..exceptions import UnrewindableBodyError

ACCEPT_ENCODING = "gzip,deflate"
try:
    import brotli as _unused_module_brotli  # noqa: F401
except ImportError:
    pass
else:
    ACCEPT_ENCODING += ",br"

_FAILEDTELL = object()


def make_headers(
    keep_alive=None,
    accept_encoding=None,
    user_agent=None,
    basic_auth=None,
    proxy_basic_auth=None,
    disable_cache=None,
):
    """
    Shortcuts for generating request headers.

    :param keep_alive:
        If ``True``, adds 'connection: keep-alive' header.

    :param accept_encoding:
        Can be a boolean, list, or string.
        ``True`` translates to 'gzip,deflate'.
        List will get joined by comma.
        String will be used as provided.

    :param user_agent:
        String representing the user-agent you want, such as
        "python-urllib3/0.6"

    :param basic_auth:
        Colon-separated username:password string for 'authorization: basic ...'
        auth header.

    :param proxy_basic_auth:
        Colon-separated username:password string for 'proxy-authorization: basic ...'
        auth header.

    :param disable_cache:
        If ``True``, adds 'cache-control: no-cache' header.

    Example::

        >>> make_headers(keep_alive=True, user_agent="Batman/1.0")
        {'connection': 'keep-alive', 'user-agent': 'Batman/1.0'}
        >>> make_headers(accept_encoding=True)
        {'accept-encoding': 'gzip,deflate'}
    """
    headers = {}
    if accept_encoding:
        if isinstance(accept_encoding, str):
            pass
        elif isinstance(accept_encoding, list):
            accept_encoding = ",".join(accept_encoding)
        else:
            accept_encoding = ACCEPT_ENCODING
        headers["accept-encoding"] = accept_encoding

    if user_agent:
        headers["user-agent"] = user_agent

    if keep_alive:
        headers["connection"] = "keep-alive"

    if basic_auth:
        headers["authorization"] = "Basic " + b64encode(b(basic_auth)).decode("utf-8")

    if proxy_basic_auth:
        headers["proxy-authorization"] = "Basic " + b64encode(
            b(proxy_basic_auth)
        ).decode("utf-8")

    if disable_cache:
        headers["cache-control"] = "no-cache"

    return headers


def set_file_position(body, pos):
    """
    If a position is provided, move file to that point.
    Otherwise, we'll attempt to record a position for future use.
    """
    if pos is not None:
        rewind_body(body, pos)
    elif getattr(body, "tell", None) is not None:
        try:
            pos = body.tell()
        except (IOError, OSError):
            # This differentiates from None, allowing us to catch
            # a failed `tell()` later when trying to rewind the body.
            pos = _FAILEDTELL

    return pos


def rewind_body(body, body_pos):
    """
    Attempt to rewind body to a certain position.
    Primarily used for request redirects and retries.

    :param body:
        File-like object that supports seek.

    :param int pos:
        Position to seek to in file.
    """
    body_seek = getattr(body, "seek", None)
    if body_seek is not None and isinstance(body_pos, integer_types):
        try:
            body_seek(body_pos)
        except (IOError, OSError):
            raise UnrewindableBodyError(
                "An error occurred when rewinding request " "body for redirect/retry."
            )
    elif body_pos is _FAILEDTELL:
        raise UnrewindableBodyError(
            "Unable to record file position for rewinding "
            "request body during a redirect/retry."
        )
    else:
        raise ValueError(
            "body_pos must be of type integer, " "instead it was %s." % type(body_pos)
        )
site-packages/pip/_vendor/urllib3/util/url.py000064400000033751151446177000015233 0ustar00from __future__ import absolute_import
import re
from collections import namedtuple

from ..exceptions import LocationParseError
from ..packages import six


url_attrs = ["scheme", "auth", "host", "port", "path", "query", "fragment"]

# We only want to normalize urls with an HTTP(S) scheme.
# urllib3 infers URLs without a scheme (None) to be http.
NORMALIZABLE_SCHEMES = ("http", "https", None)

# Almost all of these patterns were derived from the
# 'rfc3986' module: https://github.com/python-hyper/rfc3986
PERCENT_RE = re.compile(r"%[a-fA-F0-9]{2}")
SCHEME_RE = re.compile(r"^(?:[a-zA-Z][a-zA-Z0-9+-]*:|/)")
URI_RE = re.compile(
    r"^(?:([a-zA-Z][a-zA-Z0-9+.-]*):)?"
    r"(?://([^/?#]*))?"
    r"([^?#]*)"
    r"(?:\?([^#]*))?"
    r"(?:#(.*))?$",
    re.UNICODE | re.DOTALL,
)

IPV4_PAT = r"(?:[0-9]{1,3}\.){3}[0-9]{1,3}"
HEX_PAT = "[0-9A-Fa-f]{1,4}"
LS32_PAT = "(?:{hex}:{hex}|{ipv4})".format(hex=HEX_PAT, ipv4=IPV4_PAT)
_subs = {"hex": HEX_PAT, "ls32": LS32_PAT}
_variations = [
    #                            6( h16 ":" ) ls32
    "(?:%(hex)s:){6}%(ls32)s",
    #                       "::" 5( h16 ":" ) ls32
    "::(?:%(hex)s:){5}%(ls32)s",
    # [               h16 ] "::" 4( h16 ":" ) ls32
    "(?:%(hex)s)?::(?:%(hex)s:){4}%(ls32)s",
    # [ *1( h16 ":" ) h16 ] "::" 3( h16 ":" ) ls32
    "(?:(?:%(hex)s:)?%(hex)s)?::(?:%(hex)s:){3}%(ls32)s",
    # [ *2( h16 ":" ) h16 ] "::" 2( h16 ":" ) ls32
    "(?:(?:%(hex)s:){0,2}%(hex)s)?::(?:%(hex)s:){2}%(ls32)s",
    # [ *3( h16 ":" ) h16 ] "::"    h16 ":"   ls32
    "(?:(?:%(hex)s:){0,3}%(hex)s)?::%(hex)s:%(ls32)s",
    # [ *4( h16 ":" ) h16 ] "::"              ls32
    "(?:(?:%(hex)s:){0,4}%(hex)s)?::%(ls32)s",
    # [ *5( h16 ":" ) h16 ] "::"              h16
    "(?:(?:%(hex)s:){0,5}%(hex)s)?::%(hex)s",
    # [ *6( h16 ":" ) h16 ] "::"
    "(?:(?:%(hex)s:){0,6}%(hex)s)?::",
]

UNRESERVED_PAT = r"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._!\-~"
IPV6_PAT = "(?:" + "|".join([x % _subs for x in _variations]) + ")"
ZONE_ID_PAT = "(?:%25|%)(?:[" + UNRESERVED_PAT + "]|%[a-fA-F0-9]{2})+"
IPV6_ADDRZ_PAT = r"\[" + IPV6_PAT + r"(?:" + ZONE_ID_PAT + r")?\]"
REG_NAME_PAT = r"(?:[^\[\]%:/?#]|%[a-fA-F0-9]{2})*"
TARGET_RE = re.compile(r"^(/[^?]*)(?:\?([^#]+))?(?:#(.*))?$")

IPV4_RE = re.compile("^" + IPV4_PAT + "$")
IPV6_RE = re.compile("^" + IPV6_PAT + "$")
IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT + "$")
BRACELESS_IPV6_ADDRZ_RE = re.compile("^" + IPV6_ADDRZ_PAT[2:-2] + "$")
ZONE_ID_RE = re.compile("(" + ZONE_ID_PAT + r")\]$")

_HOST_PORT_PAT = ("^(%s|%s|%s)(?::([0-9]{0,5}))?$") % (
    REG_NAME_PAT,
    IPV4_PAT,
    IPV6_ADDRZ_PAT,
)
_HOST_PORT_RE = re.compile(_HOST_PORT_PAT, re.UNICODE | re.DOTALL)

UNRESERVED_CHARS = set(
    "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-~"
)
SUB_DELIM_CHARS = set("!$&'()*+,;=")
USERINFO_CHARS = UNRESERVED_CHARS | SUB_DELIM_CHARS | {":"}
PATH_CHARS = USERINFO_CHARS | {"@", "/"}
QUERY_CHARS = FRAGMENT_CHARS = PATH_CHARS | {"?"}


class Url(namedtuple("Url", url_attrs)):
    """
    Data structure for representing an HTTP URL. Used as a return value for
    :func:`parse_url`. Both the scheme and host are normalized as they are
    both case-insensitive according to RFC 3986.
    """

    __slots__ = ()

    def __new__(
        cls,
        scheme=None,
        auth=None,
        host=None,
        port=None,
        path=None,
        query=None,
        fragment=None,
    ):
        if path and not path.startswith("/"):
            path = "/" + path
        if scheme is not None:
            scheme = scheme.lower()
        return super(Url, cls).__new__(
            cls, scheme, auth, host, port, path, query, fragment
        )

    @property
    def hostname(self):
        """For backwards-compatibility with urlparse. We're nice like that."""
        return self.host

    @property
    def request_uri(self):
        """Absolute path including the query string."""
        uri = self.path or "/"

        if self.query is not None:
            uri += "?" + self.query

        return uri

    @property
    def netloc(self):
        """Network location including host and port"""
        if self.port:
            return "%s:%d" % (self.host, self.port)
        return self.host

    @property
    def url(self):
        """
        Convert self into a url

        This function should more or less round-trip with :func:`.parse_url`. The
        returned url may not be exactly the same as the url inputted to
        :func:`.parse_url`, but it should be equivalent by the RFC (e.g., urls
        with a blank port will have : removed).

        Example: ::

            >>> U = parse_url('http://google.com/mail/')
            >>> U.url
            'http://google.com/mail/'
            >>> Url('http', 'username:password', 'host.com', 80,
            ... '/path', 'query', 'fragment').url
            'http://username:password@host.com:80/path?query#fragment'
        """
        scheme, auth, host, port, path, query, fragment = self
        url = u""

        # We use "is not None" we want things to happen with empty strings (or 0 port)
        if scheme is not None:
            url += scheme + u"://"
        if auth is not None:
            url += auth + u"@"
        if host is not None:
            url += host
        if port is not None:
            url += u":" + str(port)
        if path is not None:
            url += path
        if query is not None:
            url += u"?" + query
        if fragment is not None:
            url += u"#" + fragment

        return url

    def __str__(self):
        return self.url


def split_first(s, delims):
    """
    .. deprecated:: 1.25

    Given a string and an iterable of delimiters, split on the first found
    delimiter. Return two split parts and the matched delimiter.

    If not found, then the first part is the full input string.

    Example::

        >>> split_first('foo/bar?baz', '?/=')
        ('foo', 'bar?baz', '/')
        >>> split_first('foo/bar?baz', '123')
        ('foo/bar?baz', '', None)

    Scales linearly with number of delims. Not ideal for large number of delims.
    """
    min_idx = None
    min_delim = None
    for d in delims:
        idx = s.find(d)
        if idx < 0:
            continue

        if min_idx is None or idx < min_idx:
            min_idx = idx
            min_delim = d

    if min_idx is None or min_idx < 0:
        return s, "", None

    return s[:min_idx], s[min_idx + 1 :], min_delim


def _encode_invalid_chars(component, allowed_chars, encoding="utf-8"):
    """Percent-encodes a URI component without reapplying
    onto an already percent-encoded component.
    """
    if component is None:
        return component

    component = six.ensure_text(component)

    # Try to see if the component we're encoding is already percent-encoded
    # so we can skip all '%' characters but still encode all others.
    percent_encodings = PERCENT_RE.findall(component)

    # Normalize existing percent-encoded bytes.
    for enc in percent_encodings:
        if not enc.isupper():
            component = component.replace(enc, enc.upper())

    uri_bytes = component.encode("utf-8", "surrogatepass")
    is_percent_encoded = len(percent_encodings) == uri_bytes.count(b"%")

    encoded_component = bytearray()

    for i in range(0, len(uri_bytes)):
        # Will return a single character bytestring on both Python 2 & 3
        byte = uri_bytes[i : i + 1]
        byte_ord = ord(byte)
        if (is_percent_encoded and byte == b"%") or (
            byte_ord < 128 and byte.decode() in allowed_chars
        ):
            encoded_component.extend(byte)
            continue
        encoded_component.extend(b"%" + (hex(byte_ord)[2:].encode().zfill(2).upper()))

    return encoded_component.decode(encoding)


def _remove_path_dot_segments(path):
    # See http://tools.ietf.org/html/rfc3986#section-5.2.4 for pseudo-code
    segments = path.split("/")  # Turn the path into a list of segments
    output = []  # Initialize the variable to use to store output

    for segment in segments:
        # '.' is the current directory, so ignore it, it is superfluous
        if segment == ".":
            continue
        # Anything other than '..', should be appended to the output
        elif segment != "..":
            output.append(segment)
        # In this case segment == '..', if we can, we should pop the last
        # element
        elif output:
            output.pop()

    # If the path starts with '/' and the output is empty or the first string
    # is non-empty
    if path.startswith("/") and (not output or output[0]):
        output.insert(0, "")

    # If the path starts with '/.' or '/..' ensure we add one more empty
    # string to add a trailing '/'
    if path.endswith(("/.", "/..")):
        output.append("")

    return "/".join(output)


def _normalize_host(host, scheme):
    if host:
        if isinstance(host, six.binary_type):
            host = six.ensure_str(host)

        if scheme in NORMALIZABLE_SCHEMES:
            is_ipv6 = IPV6_ADDRZ_RE.match(host)
            if is_ipv6:
                match = ZONE_ID_RE.search(host)
                if match:
                    start, end = match.span(1)
                    zone_id = host[start:end]

                    if zone_id.startswith("%25") and zone_id != "%25":
                        zone_id = zone_id[3:]
                    else:
                        zone_id = zone_id[1:]
                    zone_id = "%" + _encode_invalid_chars(zone_id, UNRESERVED_CHARS)
                    return host[:start].lower() + zone_id + host[end:]
                else:
                    return host.lower()
            elif not IPV4_RE.match(host):
                return six.ensure_str(
                    b".".join([_idna_encode(label) for label in host.split(".")])
                )
    return host


def _idna_encode(name):
    if name and any([ord(x) > 128 for x in name]):
        try:
            from pip._vendor import idna
        except ImportError:
            six.raise_from(
                LocationParseError("Unable to parse URL without the 'idna' module"),
                None,
            )
        try:
            return idna.encode(name.lower(), strict=True, std3_rules=True)
        except idna.IDNAError:
            six.raise_from(
                LocationParseError(u"Name '%s' is not a valid IDNA label" % name), None
            )
    return name.lower().encode("ascii")


def _encode_target(target):
    """Percent-encodes a request target so that there are no invalid characters"""
    if not target.startswith("/"):
        return target

    path, query, fragment = TARGET_RE.match(target).groups()
    target = _encode_invalid_chars(path, PATH_CHARS)
    query = _encode_invalid_chars(query, QUERY_CHARS)
    fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)
    if query is not None:
        target += "?" + query
    if fragment is not None:
        target += "#" + target
    return target


def parse_url(url):
    """
    Given a url, return a parsed :class:`.Url` namedtuple. Best-effort is
    performed to parse incomplete urls. Fields not provided will be None.
    This parser is RFC 3986 compliant.

    The parser logic and helper functions are based heavily on
    work done in the ``rfc3986`` module.

    :param str url: URL to parse into a :class:`.Url` namedtuple.

    Partly backwards-compatible with :mod:`urlparse`.

    Example::

        >>> parse_url('http://google.com/mail/')
        Url(scheme='http', host='google.com', port=None, path='/mail/', ...)
        >>> parse_url('google.com:80')
        Url(scheme=None, host='google.com', port=80, path=None, ...)
        >>> parse_url('/foo?bar')
        Url(scheme=None, host=None, port=None, path='/foo', query='bar', ...)
    """
    if not url:
        # Empty
        return Url()

    source_url = url
    if not SCHEME_RE.search(url):
        url = "//" + url

    try:
        scheme, authority, path, query, fragment = URI_RE.match(url).groups()
        normalize_uri = scheme is None or scheme.lower() in NORMALIZABLE_SCHEMES

        if scheme:
            scheme = scheme.lower()

        if authority:
            auth, _, host_port = authority.rpartition("@")
            auth = auth or None
            host, port = _HOST_PORT_RE.match(host_port).groups()
            if auth and normalize_uri:
                auth = _encode_invalid_chars(auth, USERINFO_CHARS)
            if port == "":
                port = None
        else:
            auth, host, port = None, None, None

        if port is not None:
            port = int(port)
            if not (0 <= port <= 65535):
                raise LocationParseError(url)

        host = _normalize_host(host, scheme)

        if normalize_uri and path:
            path = _remove_path_dot_segments(path)
            path = _encode_invalid_chars(path, PATH_CHARS)
        if normalize_uri and query:
            query = _encode_invalid_chars(query, QUERY_CHARS)
        if normalize_uri and fragment:
            fragment = _encode_invalid_chars(fragment, FRAGMENT_CHARS)

    except (ValueError, AttributeError):
        return six.raise_from(LocationParseError(source_url), None)

    # For the sake of backwards compatibility we put empty
    # string values for path if there are any defined values
    # beyond the path in the URL.
    # TODO: Remove this when we break backwards compatibility.
    if not path:
        if query is not None or fragment is not None:
            path = ""
        else:
            path = None

    # Ensure that each part of the URL is a `str` for
    # backwards compatibility.
    if isinstance(url, six.text_type):
        ensure_func = six.ensure_text
    else:
        ensure_func = six.ensure_str

    def ensure_type(x):
        return x if x is None else ensure_func(x)

    return Url(
        scheme=ensure_type(scheme),
        auth=ensure_type(auth),
        host=ensure_type(host),
        port=port,
        path=ensure_type(path),
        query=ensure_type(query),
        fragment=ensure_type(fragment),
    )


def get_host(url):
    """
    Deprecated. Use :func:`parse_url` instead.
    """
    p = parse_url(url)
    return p.scheme or "http", p.hostname, p.port
site-packages/pip/_vendor/urllib3/util/queue.py000064400000000761151446177000015550 0ustar00import collections
from ..packages import six
from ..packages.six.moves import queue

if six.PY2:
    # Queue is imported for side effects on MS Windows. See issue #229.
    import Queue as _unused_module_Queue  # noqa: F401


class LifoQueue(queue.Queue):
    def _init(self, _):
        self.queue = collections.deque()

    def _qsize(self, len=len):
        return len(self.queue)

    def _put(self, item):
        self.queue.append(item)

    def _get(self):
        return self.queue.pop()
site-packages/pip/_vendor/urllib3/util/wait.py000064400000012436151446177000015372 0ustar00import errno
from functools import partial
import select
import sys

try:
    from time import monotonic
except ImportError:
    from time import time as monotonic

__all__ = ["NoWayToWaitForSocketError", "wait_for_read", "wait_for_write"]


class NoWayToWaitForSocketError(Exception):
    pass


# How should we wait on sockets?
#
# There are two types of APIs you can use for waiting on sockets: the fancy
# modern stateful APIs like epoll/kqueue, and the older stateless APIs like
# select/poll. The stateful APIs are more efficient when you have a lots of
# sockets to keep track of, because you can set them up once and then use them
# lots of times. But we only ever want to wait on a single socket at a time
# and don't want to keep track of state, so the stateless APIs are actually
# more efficient. So we want to use select() or poll().
#
# Now, how do we choose between select() and poll()? On traditional Unixes,
# select() has a strange calling convention that makes it slow, or fail
# altogether, for high-numbered file descriptors. The point of poll() is to fix
# that, so on Unixes, we prefer poll().
#
# On Windows, there is no poll() (or at least Python doesn't provide a wrapper
# for it), but that's OK, because on Windows, select() doesn't have this
# strange calling convention; plain select() works fine.
#
# So: on Windows we use select(), and everywhere else we use poll(). We also
# fall back to select() in case poll() is somehow broken or missing.

if sys.version_info >= (3, 5):
    # Modern Python, that retries syscalls by default
    def _retry_on_intr(fn, timeout):
        return fn(timeout)


else:
    # Old and broken Pythons.
    def _retry_on_intr(fn, timeout):
        if timeout is None:
            deadline = float("inf")
        else:
            deadline = monotonic() + timeout

        while True:
            try:
                return fn(timeout)
            # OSError for 3 <= pyver < 3.5, select.error for pyver <= 2.7
            except (OSError, select.error) as e:
                # 'e.args[0]' incantation works for both OSError and select.error
                if e.args[0] != errno.EINTR:
                    raise
                else:
                    timeout = deadline - monotonic()
                    if timeout < 0:
                        timeout = 0
                    if timeout == float("inf"):
                        timeout = None
                    continue


def select_wait_for_socket(sock, read=False, write=False, timeout=None):
    if not read and not write:
        raise RuntimeError("must specify at least one of read=True, write=True")
    rcheck = []
    wcheck = []
    if read:
        rcheck.append(sock)
    if write:
        wcheck.append(sock)
    # When doing a non-blocking connect, most systems signal success by
    # marking the socket writable. Windows, though, signals success by marked
    # it as "exceptional". We paper over the difference by checking the write
    # sockets for both conditions. (The stdlib selectors module does the same
    # thing.)
    fn = partial(select.select, rcheck, wcheck, wcheck)
    rready, wready, xready = _retry_on_intr(fn, timeout)
    return bool(rready or wready or xready)


def poll_wait_for_socket(sock, read=False, write=False, timeout=None):
    if not read and not write:
        raise RuntimeError("must specify at least one of read=True, write=True")
    mask = 0
    if read:
        mask |= select.POLLIN
    if write:
        mask |= select.POLLOUT
    poll_obj = select.poll()
    poll_obj.register(sock, mask)

    # For some reason, poll() takes timeout in milliseconds
    def do_poll(t):
        if t is not None:
            t *= 1000
        return poll_obj.poll(t)

    return bool(_retry_on_intr(do_poll, timeout))


def null_wait_for_socket(*args, **kwargs):
    raise NoWayToWaitForSocketError("no select-equivalent available")


def _have_working_poll():
    # Apparently some systems have a select.poll that fails as soon as you try
    # to use it, either due to strange configuration or broken monkeypatching
    # from libraries like eventlet/greenlet.
    try:
        poll_obj = select.poll()
        _retry_on_intr(poll_obj.poll, 0)
    except (AttributeError, OSError):
        return False
    else:
        return True


def wait_for_socket(*args, **kwargs):
    # We delay choosing which implementation to use until the first time we're
    # called. We could do it at import time, but then we might make the wrong
    # decision if someone goes wild with monkeypatching select.poll after
    # we're imported.
    global wait_for_socket
    if _have_working_poll():
        wait_for_socket = poll_wait_for_socket
    elif hasattr(select, "select"):
        wait_for_socket = select_wait_for_socket
    else:  # Platform-specific: Appengine.
        wait_for_socket = null_wait_for_socket
    return wait_for_socket(*args, **kwargs)


def wait_for_read(sock, timeout=None):
    """ Waits for reading to be available on a given socket.
    Returns True if the socket is readable, or False if the timeout expired.
    """
    return wait_for_socket(sock, read=True, timeout=timeout)


def wait_for_write(sock, timeout=None):
    """ Waits for writing to be available on a given socket.
    Returns True if the socket is readable, or False if the timeout expired.
    """
    return wait_for_socket(sock, write=True, timeout=timeout)
site-packages/pip/_vendor/urllib3/util/ssl_.py000064400000033523151446177000015366 0ustar00from __future__ import absolute_import
import errno
import warnings
import hmac
import sys

from binascii import hexlify, unhexlify
from hashlib import md5, sha1, sha256

from .url import IPV4_RE, BRACELESS_IPV6_ADDRZ_RE
from ..exceptions import SSLError, InsecurePlatformWarning, SNIMissingWarning
from ..packages import six


SSLContext = None
HAS_SNI = False
IS_PYOPENSSL = False
IS_SECURETRANSPORT = False

# Maps the length of a digest to a possible hash function producing this digest
HASHFUNC_MAP = {32: md5, 40: sha1, 64: sha256}


def _const_compare_digest_backport(a, b):
    """
    Compare two digests of equal length in constant time.

    The digests must be of type str/bytes.
    Returns True if the digests match, and False otherwise.
    """
    result = abs(len(a) - len(b))
    for l, r in zip(bytearray(a), bytearray(b)):
        result |= l ^ r
    return result == 0


_const_compare_digest = getattr(hmac, "compare_digest", _const_compare_digest_backport)

try:  # Test for SSL features
    import ssl
    from ssl import wrap_socket, CERT_REQUIRED
    from ssl import HAS_SNI  # Has SNI?
except ImportError:
    pass

try:  # Platform-specific: Python 3.6
    from ssl import PROTOCOL_TLS

    PROTOCOL_SSLv23 = PROTOCOL_TLS
except ImportError:
    try:
        from ssl import PROTOCOL_SSLv23 as PROTOCOL_TLS

        PROTOCOL_SSLv23 = PROTOCOL_TLS
    except ImportError:
        PROTOCOL_SSLv23 = PROTOCOL_TLS = 2


try:
    from ssl import OP_NO_SSLv2, OP_NO_SSLv3, OP_NO_COMPRESSION
except ImportError:
    OP_NO_SSLv2, OP_NO_SSLv3 = 0x1000000, 0x2000000
    OP_NO_COMPRESSION = 0x20000


# A secure default.
# Sources for more information on TLS ciphers:
#
# - https://wiki.mozilla.org/Security/Server_Side_TLS
# - https://www.ssllabs.com/projects/best-practices/index.html
# - https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
#
# The general intent is:
# - prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE),
# - prefer ECDHE over DHE for better performance,
# - prefer any AES-GCM and ChaCha20 over any AES-CBC for better performance and
#   security,
# - prefer AES-GCM over ChaCha20 because hardware-accelerated AES is common,
# - disable NULL authentication, MD5 MACs, DSS, and other
#   insecure ciphers for security reasons.
# - NOTE: TLS 1.3 cipher suites are managed through a different interface
#   not exposed by CPython (yet!) and are enabled by default if they're available.
DEFAULT_CIPHERS = ":".join(
    [
        "ECDHE+AESGCM",
        "ECDHE+CHACHA20",
        "DHE+AESGCM",
        "DHE+CHACHA20",
        "ECDH+AESGCM",
        "DH+AESGCM",
        "ECDH+AES",
        "DH+AES",
        "RSA+AESGCM",
        "RSA+AES",
        "!aNULL",
        "!eNULL",
        "!MD5",
        "!DSS",
    ]
)

try:
    from ssl import SSLContext  # Modern SSL?
except ImportError:

    class SSLContext(object):  # Platform-specific: Python 2
        def __init__(self, protocol_version):
            self.protocol = protocol_version
            # Use default values from a real SSLContext
            self.check_hostname = False
            self.verify_mode = ssl.CERT_NONE
            self.ca_certs = None
            self.options = 0
            self.certfile = None
            self.keyfile = None
            self.ciphers = None

        def load_cert_chain(self, certfile, keyfile):
            self.certfile = certfile
            self.keyfile = keyfile

        def load_verify_locations(self, cafile=None, capath=None):
            self.ca_certs = cafile

            if capath is not None:
                raise SSLError("CA directories not supported in older Pythons")

        def set_ciphers(self, cipher_suite):
            self.ciphers = cipher_suite

        def wrap_socket(self, socket, server_hostname=None, server_side=False):
            warnings.warn(
                "A true SSLContext object is not available. This prevents "
                "urllib3 from configuring SSL appropriately and may cause "
                "certain SSL connections to fail. You can upgrade to a newer "
                "version of Python to solve this. For more information, see "
                "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
                "#ssl-warnings",
                InsecurePlatformWarning,
            )
            kwargs = {
                "keyfile": self.keyfile,
                "certfile": self.certfile,
                "ca_certs": self.ca_certs,
                "cert_reqs": self.verify_mode,
                "ssl_version": self.protocol,
                "server_side": server_side,
            }
            return wrap_socket(socket, ciphers=self.ciphers, **kwargs)


def assert_fingerprint(cert, fingerprint):
    """
    Checks if given fingerprint matches the supplied certificate.

    :param cert:
        Certificate as bytes object.
    :param fingerprint:
        Fingerprint as string of hexdigits, can be interspersed by colons.
    """

    fingerprint = fingerprint.replace(":", "").lower()
    digest_length = len(fingerprint)
    hashfunc = HASHFUNC_MAP.get(digest_length)
    if not hashfunc:
        raise SSLError("Fingerprint of invalid length: {0}".format(fingerprint))

    # We need encode() here for py32; works on py2 and p33.
    fingerprint_bytes = unhexlify(fingerprint.encode())

    cert_digest = hashfunc(cert).digest()

    if not _const_compare_digest(cert_digest, fingerprint_bytes):
        raise SSLError(
            'Fingerprints did not match. Expected "{0}", got "{1}".'.format(
                fingerprint, hexlify(cert_digest)
            )
        )


def resolve_cert_reqs(candidate):
    """
    Resolves the argument to a numeric constant, which can be passed to
    the wrap_socket function/method from the ssl module.
    Defaults to :data:`ssl.CERT_NONE`.
    If given a string it is assumed to be the name of the constant in the
    :mod:`ssl` module or its abbreviation.
    (So you can specify `REQUIRED` instead of `CERT_REQUIRED`.
    If it's neither `None` nor a string we assume it is already the numeric
    constant which can directly be passed to wrap_socket.
    """
    if candidate is None:
        return CERT_REQUIRED

    if isinstance(candidate, str):
        res = getattr(ssl, candidate, None)
        if res is None:
            res = getattr(ssl, "CERT_" + candidate)
        return res

    return candidate


def resolve_ssl_version(candidate):
    """
    like resolve_cert_reqs
    """
    if candidate is None:
        return PROTOCOL_TLS

    if isinstance(candidate, str):
        res = getattr(ssl, candidate, None)
        if res is None:
            res = getattr(ssl, "PROTOCOL_" + candidate)
        return res

    return candidate


def create_urllib3_context(
    ssl_version=None, cert_reqs=None, options=None, ciphers=None
):
    """All arguments have the same meaning as ``ssl_wrap_socket``.

    By default, this function does a lot of the same work that
    ``ssl.create_default_context`` does on Python 3.4+. It:

    - Disables SSLv2, SSLv3, and compression
    - Sets a restricted set of server ciphers

    If you wish to enable SSLv3, you can do::

        from pip._vendor.urllib3.util import ssl_
        context = ssl_.create_urllib3_context()
        context.options &= ~ssl_.OP_NO_SSLv3

    You can do the same to enable compression (substituting ``COMPRESSION``
    for ``SSLv3`` in the last line above).

    :param ssl_version:
        The desired protocol version to use. This will default to
        PROTOCOL_SSLv23 which will negotiate the highest protocol that both
        the server and your installation of OpenSSL support.
    :param cert_reqs:
        Whether to require the certificate verification. This defaults to
        ``ssl.CERT_REQUIRED``.
    :param options:
        Specific OpenSSL options. These default to ``ssl.OP_NO_SSLv2``,
        ``ssl.OP_NO_SSLv3``, ``ssl.OP_NO_COMPRESSION``.
    :param ciphers:
        Which cipher suites to allow the server to select.
    :returns:
        Constructed SSLContext object with specified options
    :rtype: SSLContext
    """
    context = SSLContext(ssl_version or PROTOCOL_TLS)

    context.set_ciphers(ciphers or DEFAULT_CIPHERS)

    # Setting the default here, as we may have no ssl module on import
    cert_reqs = ssl.CERT_REQUIRED if cert_reqs is None else cert_reqs

    if options is None:
        options = 0
        # SSLv2 is easily broken and is considered harmful and dangerous
        options |= OP_NO_SSLv2
        # SSLv3 has several problems and is now dangerous
        options |= OP_NO_SSLv3
        # Disable compression to prevent CRIME attacks for OpenSSL 1.0+
        # (issue #309)
        options |= OP_NO_COMPRESSION

    context.options |= options

    # Enable post-handshake authentication for TLS 1.3, see GH #1634. PHA is
    # necessary for conditional client cert authentication with TLS 1.3.
    # The attribute is None for OpenSSL <= 1.1.0 or does not exist in older
    # versions of Python.  We only enable on Python 3.7.4+ or if certificate
    # verification is enabled to work around Python issue #37428
    # See: https://bugs.python.org/issue37428
    if (cert_reqs == ssl.CERT_REQUIRED or sys.version_info >= (3, 7, 4)) and getattr(
        context, "post_handshake_auth", None
    ) is not None:
        context.post_handshake_auth = True

    context.verify_mode = cert_reqs
    if (
        getattr(context, "check_hostname", None) is not None
    ):  # Platform-specific: Python 3.2
        # We do our own verification, including fingerprints and alternative
        # hostnames. So disable it here
        context.check_hostname = False
    return context


def ssl_wrap_socket(
    sock,
    keyfile=None,
    certfile=None,
    cert_reqs=None,
    ca_certs=None,
    server_hostname=None,
    ssl_version=None,
    ciphers=None,
    ssl_context=None,
    ca_cert_dir=None,
    key_password=None,
):
    """
    All arguments except for server_hostname, ssl_context, and ca_cert_dir have
    the same meaning as they do when using :func:`ssl.wrap_socket`.

    :param server_hostname:
        When SNI is supported, the expected hostname of the certificate
    :param ssl_context:
        A pre-made :class:`SSLContext` object. If none is provided, one will
        be created using :func:`create_urllib3_context`.
    :param ciphers:
        A string of ciphers we wish the client to support.
    :param ca_cert_dir:
        A directory containing CA certificates in multiple separate files, as
        supported by OpenSSL's -CApath flag or the capath argument to
        SSLContext.load_verify_locations().
    :param key_password:
        Optional password if the keyfile is encrypted.
    """
    context = ssl_context
    if context is None:
        # Note: This branch of code and all the variables in it are no longer
        # used by urllib3 itself. We should consider deprecating and removing
        # this code.
        context = create_urllib3_context(ssl_version, cert_reqs, ciphers=ciphers)

    if ca_certs or ca_cert_dir:
        try:
            context.load_verify_locations(ca_certs, ca_cert_dir)
        except IOError as e:  # Platform-specific: Python 2.7
            raise SSLError(e)
        # Py33 raises FileNotFoundError which subclasses OSError
        # These are not equivalent unless we check the errno attribute
        except OSError as e:  # Platform-specific: Python 3.3 and beyond
            if e.errno == errno.ENOENT:
                raise SSLError(e)
            raise

    elif ssl_context is None and hasattr(context, "load_default_certs"):
        # try to load OS default certs; works well on Windows (require Python3.4+)
        context.load_default_certs()

    # Attempt to detect if we get the goofy behavior of the
    # keyfile being encrypted and OpenSSL asking for the
    # passphrase via the terminal and instead error out.
    if keyfile and key_password is None and _is_key_file_encrypted(keyfile):
        raise SSLError("Client private key is encrypted, password is required")

    if certfile:
        if key_password is None:
            context.load_cert_chain(certfile, keyfile)
        else:
            context.load_cert_chain(certfile, keyfile, key_password)

    # If we detect server_hostname is an IP address then the SNI
    # extension should not be used according to RFC3546 Section 3.1
    # We shouldn't warn the user if SNI isn't available but we would
    # not be using SNI anyways due to IP address for server_hostname.
    if (
        server_hostname is not None and not is_ipaddress(server_hostname)
    ) or IS_SECURETRANSPORT:
        if HAS_SNI and server_hostname is not None:
            return context.wrap_socket(sock, server_hostname=server_hostname)

        warnings.warn(
            "An HTTPS request has been made, but the SNI (Server Name "
            "Indication) extension to TLS is not available on this platform. "
            "This may cause the server to present an incorrect TLS "
            "certificate, which can cause validation failures. You can upgrade to "
            "a newer version of Python to solve this. For more information, see "
            "https://urllib3.readthedocs.io/en/latest/advanced-usage.html"
            "#ssl-warnings",
            SNIMissingWarning,
        )

    return context.wrap_socket(sock)


def is_ipaddress(hostname):
    """Detects whether the hostname given is an IPv4 or IPv6 address.
    Also detects IPv6 addresses with Zone IDs.

    :param str hostname: Hostname to examine.
    :return: True if the hostname is an IP address, False otherwise.
    """
    if not six.PY2 and isinstance(hostname, bytes):
        # IDN A-label bytes are ASCII compatible.
        hostname = hostname.decode("ascii")
    return bool(IPV4_RE.match(hostname) or BRACELESS_IPV6_ADDRZ_RE.match(hostname))


def _is_key_file_encrypted(key_file):
    """Detects if a key file is encrypted or not."""
    with open(key_file, "r") as f:
        for line in f:
            # Look for Proc-Type: 4,ENCRYPTED
            if "ENCRYPTED" in line:
                return True

    return False
site-packages/pip/__main__.py000064400000001164151446177000012155 0ustar00from __future__ import absolute_import

import os
import sys

# If we are running from a wheel, add the wheel to sys.path
# This allows the usage python pip-*.whl/pip install pip-*.whl
if __package__ == '':
    # __file__ is pip-*.whl/pip/__main__.py
    # first dirname call strips of '/__main__.py', second strips off '/pip'
    # Resulting path is the name of the wheel itself
    # Add that to sys.path so we can import pip
    path = os.path.dirname(os.path.dirname(__file__))
    sys.path.insert(0, path)

from pip._internal.main import main as _main  # isort:skip # noqa

if __name__ == '__main__':
    sys.exit(_main())
site-packages/pkg_resources/extern/__pycache__/__init__.cpython-38.opt-1.pyc000064400000004546151446177000023020 0ustar00U

�Qab�	�@s,ddlZGdd�d�ZdZeee���dS)�Nc@s@eZdZdZddd�Zedd��Zddd	�Zd
d�Zdd
�Z	dS)�VendorImporterz�
    A PEP 302 meta path importer for finding optionally-vendored
    or otherwise naturally-installed packages from root_name.
    �NcCs&||_t|�|_|p|�dd�|_dS)NZexternZ_vendor)�	root_name�set�vendored_names�replace�
vendor_pkg)�selfrrrrr�A/usr/lib/python3.8/site-packages/pkg_resources/extern/__init__.py�__init__
s
zVendorImporter.__init__ccs|jdVdVdS)zL
        Search first the vendor package then as a natural package.
        �.�N)r�r	rrr
�search_pathszVendorImporter.search_pathcCs8|�|jd�\}}}|rdStt|j|j��s4dS|S)z�
        Return self when fullname starts with root_name and the
        target module is one vendored through this importer.
        rN)�	partitionr�any�map�
startswithr)r	�fullname�path�root�base�targetrrr
�find_moduleszVendorImporter.find_modulec	Cs�|�|jd�\}}}|jD]^}zD||}t|�tj|}|tj|<|r\tjdkr\tj|=|WStk
rxYqXqtdjft	����dS)zK
        Iterate over the search path to locate and load fullname.
        r)�rz�The '{target}' package is required; normally this is bundled with this package so if you get this warning, consult the packager of your distribution.N)
rrr�
__import__�sys�modules�version_info�ImportError�format�locals)r	rrrr�prefixZextant�modrrr
�load_module#s"



��zVendorImporter.load_modulecCs|tjkrtj�|�dS)zR
        Install this importer into sys.meta_path if not already present.
        N)r�	meta_path�appendrrrr
�install@s
zVendorImporter.install)rN)N)
�__name__�
__module__�__qualname__�__doc__r�propertyrrr$r'rrrr
rs


r)Z	packagingZ	pyparsingZsixZappdirs)rr�namesr(r'rrrr
�<module>sDsite-packages/pkg_resources/extern/__pycache__/__init__.cpython-38.pyc000064400000004546151446177000022061 0ustar00U

�Qab�	�@s,ddlZGdd�d�ZdZeee���dS)�Nc@s@eZdZdZddd�Zedd��Zddd	�Zd
d�Zdd
�Z	dS)�VendorImporterz�
    A PEP 302 meta path importer for finding optionally-vendored
    or otherwise naturally-installed packages from root_name.
    �NcCs&||_t|�|_|p|�dd�|_dS)NZexternZ_vendor)�	root_name�set�vendored_names�replace�
vendor_pkg)�selfrrrrr�A/usr/lib/python3.8/site-packages/pkg_resources/extern/__init__.py�__init__
s
zVendorImporter.__init__ccs|jdVdVdS)zL
        Search first the vendor package then as a natural package.
        �.�N)r�r	rrr
�search_pathszVendorImporter.search_pathcCs8|�|jd�\}}}|rdStt|j|j��s4dS|S)z�
        Return self when fullname starts with root_name and the
        target module is one vendored through this importer.
        rN)�	partitionr�any�map�
startswithr)r	�fullname�path�root�base�targetrrr
�find_moduleszVendorImporter.find_modulec	Cs�|�|jd�\}}}|jD]^}zD||}t|�tj|}|tj|<|r\tjdkr\tj|=|WStk
rxYqXqtdjft	����dS)zK
        Iterate over the search path to locate and load fullname.
        r)�rz�The '{target}' package is required; normally this is bundled with this package so if you get this warning, consult the packager of your distribution.N)
rrr�
__import__�sys�modules�version_info�ImportError�format�locals)r	rrrr�prefixZextant�modrrr
�load_module#s"



��zVendorImporter.load_modulecCs|tjkrtj�|�dS)zR
        Install this importer into sys.meta_path if not already present.
        N)r�	meta_path�appendrrrr
�install@s
zVendorImporter.install)rN)N)
�__name__�
__module__�__qualname__�__doc__r�propertyrrr$r'rrrr
rs


r)Z	packagingZ	pyparsingZsixZappdirs)rr�namesr(r'rrrr
�<module>sDsite-packages/pkg_resources/extern/__init__.py000064400000004702151446177000015565 0ustar00import sys


class VendorImporter:
    """
    A PEP 302 meta path importer for finding optionally-vendored
    or otherwise naturally-installed packages from root_name.
    """

    def __init__(self, root_name, vendored_names=(), vendor_pkg=None):
        self.root_name = root_name
        self.vendored_names = set(vendored_names)
        self.vendor_pkg = vendor_pkg or root_name.replace('extern', '_vendor')

    @property
    def search_path(self):
        """
        Search first the vendor package then as a natural package.
        """
        yield self.vendor_pkg + '.'
        yield ''

    def find_module(self, fullname, path=None):
        """
        Return self when fullname starts with root_name and the
        target module is one vendored through this importer.
        """
        root, base, target = fullname.partition(self.root_name + '.')
        if root:
            return
        if not any(map(target.startswith, self.vendored_names)):
            return
        return self

    def load_module(self, fullname):
        """
        Iterate over the search path to locate and load fullname.
        """
        root, base, target = fullname.partition(self.root_name + '.')
        for prefix in self.search_path:
            try:
                extant = prefix + target
                __import__(extant)
                mod = sys.modules[extant]
                sys.modules[fullname] = mod
                # mysterious hack:
                # Remove the reference to the extant package/module
                # on later Python versions to cause relative imports
                # in the vendor package to resolve the same modules
                # as those going through this importer.
                if prefix and sys.version_info > (3, 3):
                    del sys.modules[extant]
                return mod
            except ImportError:
                pass
        else:
            raise ImportError(
                "The '{target}' package is required; "
                "normally this is bundled with this package so if you get "
                "this warning, consult the packager of your "
                "distribution.".format(**locals())
            )

    def install(self):
        """
        Install this importer into sys.meta_path if not already present.
        """
        if self not in sys.meta_path:
            sys.meta_path.append(self)


names = 'packaging', 'pyparsing', 'six', 'appdirs'
VendorImporter(__name__, names).install()
site-packages/pkg_resources/py31compat.py000064400000001056151446177000014520 0ustar00import os
import errno
import sys

from .extern import six


def _makedirs_31(path, exist_ok=False):
    try:
        os.makedirs(path)
    except OSError as exc:
        if not exist_ok or exc.errno != errno.EEXIST:
            raise


# rely on compatibility behavior until mode considerations
#  and exists_ok considerations are disentangled.
# See https://github.com/pypa/setuptools/pull/1083#issuecomment-315168663
needs_makedirs = (
    six.PY2 or
    (3, 4) <= sys.version_info < (3, 4, 1)
)
makedirs = _makedirs_31 if needs_makedirs else os.makedirs
site-packages/pkg_resources/__pycache__/__init__.cpython-38.opt-1.pyc000064400000304004151446177000021503 0ustar00U

�Qab=��G@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZzddlZWnek
�rddlZYnXze Wne!k
�r*e"Z YnXddl#m$Z$ddl%m&Z&m'Z'm(Z(ddlm)Z)zddlm*Z*m+Z+m,Z,d	Z-Wnek
�r�d
Z-YnXddlm.Z/ddl0m1Z1m2Z2zddl3m4Z5e5j6Wnek
�r�dZ5YnXd
dl7m8Z8ddl#m9Z9ddl#m:Z:e;d�e;d�e;d�e;d�e<Z=dej>k�r@dk�rLnne?d��e$j@�r\dZAdZBdZCdZDdZEdZFdZGdZHdZIdZJdZKdZLdZMdZNdZOdZPdZQdZRdZSGdd�deT�ZUdd�ZViZWdd�ZXdd�ZYd d!�ZZd"d#�Z[d$d%�Z\d&d'�Z]d(d)�Z^d*d+�Z_Z`d,d-�Zad.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMddNddOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrgGZbGdsdI�dIec�ZdGdtdJ�dJed�ZeGdudv�dvee�ZfGdwdK�dKed�ZgGdxdL�dLed�ZhiZidyjjej>�ZkdzZld{Zmd
ZndZod|Zpd}dm�Zqd~d0�Zrgfdd��Zsd�d��Ztd�d��Zue�vd��Zwe�vd��ZxeuZyd�dR�Zzd�d/�Z{e{Z|d�d1�Z}d�d2�Z~�dd�d3�Zd�d4�Z�Gd�d`�d`�Z�Gd�da�dae��Z�Gd�dD�dD�Z�Gd�d��d�e��Z�Gd�dC�dC�Z�e�Z�Gd�dM�dMe?�Z�Gd�dE�dE�Z�d�dB�Z�d�dO�Z�d�dP�Z�d�dU�Z�d�dV�Z�d�dW�Z��dd�dX�Z�Gd�dg�dg�Z�eqe�e��Gd�dh�dhe��Z�Gd�di�die��Z�e����Gd�de�dee��Z�e��Z�Gd�d��d�e��Z�Gd�d��d�e��Z�Gd�dj�dje��Z�eqe
j�e��Gd�db�dbe��Z�Gd�dc�dce��Z�Gd�dd�dde��Z�eXd�id��d�dk�Z��dd�d?�Z��dd�d��Z�e�e
j�e���dd�d��Z�e�e�e��d�d��Z��dd�d��Z�d�d��Z�Gd�d��d��Z�d�d��Z�d�d��Z�d�d��Z�d�d��Z�e�ej�e��e�e5d���r�e�e5j�e��eXd�id��eXd�idd�dl�Z�d�dńZ�d�dDŽZ�d�d<�Z��dd�dn�Z�d�d˄Z�e�ej�e��e�e
j�e��e�e5d���r,e�e5j�e��d�d̈́Z�e�e�e��d�dZ�Z�d�dЄZ�ifd�d҄Z�d�dԄZ�d�dքZ�d�d؄Z�d�dS�Z�e�vdڡj�Z�e�vd�ej�ej�B�j�Z�Gd�dH�dH�Z�d�dބZ�d�d�Z�Gd�dF�dF�Z�Gd�d�d�eăZ�Gd�d�d�eăZ�e�e�e�d�Z�d�d�Z�Gd�d�d�eɃZ�d�dN�Z�Gd�dG�dGe:j�j̓Z�d�d�Z�d�d�Z�d�dY�Z�d�d�Z�d�dT�Z�d�d��Z�ej�d�eUd	d��d�d��Z�e�eփfd�d���Z�e�d�d���Z�Gd�dp�dpeكZ�dS(aZ
Package resource API
--------------------

A resource is a logical file contained within a package, or a logical
subdirectory thereof.  The package resource API expects resource names
to have their path parts separated with ``/``, *not* whatever the local
path separator is.  Do not use os.path operations to manipulate resource
names being passed into the API.

The package resource API is designed to work with normal filesystem packages,
.egg files, and unpacked .egg files.  It can also work in a limited way with
.zip files and with custom PEP 302 loaders that support the ``get_data()``
method.
�)�absolute_importN)�get_importer)�six)�urllib�map�filter)�utime)�mkdir�rename�unlinkTF)�open)�isdir�split�)�
py31compat)�appdirs)�	packagingz&pkg_resources.extern.packaging.versionz)pkg_resources.extern.packaging.specifiersz+pkg_resources.extern.packaging.requirementsz&pkg_resources.extern.packaging.markers)�r)r�zPython 3.4 or later is requiredc@seZdZdZdS)�
PEP440Warningza
    Used when there is an issue with a version or specifier not complying with
    PEP 440.
    N��__name__�
__module__�__qualname__�__doc__�rr�:/usr/lib/python3.8/site-packages/pkg_resources/__init__.pyrxsrcCs8ztj�|�WStjjk
r2tj�|�YSXdS�N)r�version�Version�InvalidVersion�
LegacyVersion)�vrrr�
parse_versionsr#cKs"t��|�t�t�||��dSr)�globals�update�_state_vars�dict�fromkeys)Zvartype�kwrrr�_declare_state�sr*cCs8i}t�}t��D] \}}|d|||�||<q|S)NZ_sget_)r$r&�items��state�g�kr"rrr�__getstate__�s
r0cCs8t�}|��D]$\}}|dt|||||�q|S)NZ_sset_)r$r+r&r,rrr�__setstate__�sr1cCs|��Sr)�copy��valrrr�
_sget_dict�sr5cCs|��|�|�dSr)�clearr%��key�obr-rrr�
_sset_dict�sr:cCs|��Sr)r0r3rrr�_sget_object�sr;cCs|�|�dSr)r1r7rrr�_sset_object�sr<cGsdSrr��argsrrr�<lambda>��r?cCsbt�}t�|�}|dk	r^tjdkr^z&dd�t�dd��|�d�f}Wntk
r\YnX|S)aZReturn this platform's maximum compatible version.

    distutils.util.get_platform() normally reports the minimum version
    of Mac OS X that would be required to *use* extensions produced by
    distutils.  But what we want when checking compatibility is to know the
    version of Mac OS X that we are *running*.  To allow usage of packages that
    explicitly require a newer version of Mac OS X, we must also know the
    current version of the OS.

    If this condition occurs for any other platform with a version in its
    platform strings, this function should be extended accordingly.
    N�darwinzmacosx-%s-%s�.�r)	�get_build_platform�macosVersionString�match�sys�platform�join�_macosx_vers�group�
ValueError)�plat�mrrr�get_supported_platform�s

&rO�require�
run_script�get_provider�get_distribution�load_entry_point�
get_entry_map�get_entry_info�iter_entry_points�resource_string�resource_stream�resource_filename�resource_listdir�resource_exists�resource_isdir�declare_namespace�working_set�add_activation_listener�find_distributions�set_extraction_path�cleanup_resources�get_default_cache�Environment�
WorkingSet�ResourceManager�Distribution�Requirement�
EntryPoint�ResolutionError�VersionConflict�DistributionNotFound�UnknownExtra�ExtractionError�parse_requirements�	safe_name�safe_version�get_platform�compatible_platforms�yield_lines�split_sections�
safe_extra�to_filename�invalid_marker�evaluate_marker�ensure_directory�normalize_path�EGG_DIST�BINARY_DIST�SOURCE_DIST�
CHECKOUT_DIST�DEVELOP_DIST�IMetadataProvider�IResourceProvider�FileMetadata�PathMetadata�EggMetadata�
EmptyProvider�empty_provider�NullProvider�EggProvider�DefaultProvider�ZipProvider�register_finder�register_namespace_handler�register_loader_type�fixup_namespace_packagesr�PkgResourcesDeprecationWarning�run_main�AvailableDistributionsc@seZdZdZdd�ZdS)rkz.Abstract base for dependency resolution errorscCs|jjt|j�Sr)�	__class__r�reprr>��selfrrr�__repr__�szResolutionError.__repr__N)rrrrr�rrrrrk�sc@s<eZdZdZdZedd��Zedd��Zdd�Zd	d
�Z	dS)rlz�
    An already-installed version conflicts with the requested version.

    Should be initialized with the installed Distribution and the requested
    Requirement.
    z3{self.dist} is installed but {self.req} is requiredcCs
|jdS�Nrr=r�rrr�distszVersionConflict.distcCs
|jdS�Nrr=r�rrr�reqszVersionConflict.reqcCs|jjft��Sr��	_template�format�localsr�rrr�reportszVersionConflict.reportcCs|s|S|j|f}t|�S)zt
        If required_by is non-empty, return a version of self that is a
        ContextualVersionConflict.
        )r>�ContextualVersionConflict)r��required_byr>rrr�with_contextszVersionConflict.with_contextN)
rrrrr��propertyr�r�r�r�rrrrrls

c@s&eZdZdZejdZedd��ZdS)r�z�
    A VersionConflict that accepts a third parameter, the set of the
    requirements that required the installed Distribution.
    z by {self.required_by}cCs
|jdS)NrCr=r�rrrr�*sz%ContextualVersionConflict.required_byN)rrrrrlr�r�r�rrrrr�"s
r�c@sHeZdZdZdZedd��Zedd��Zedd��Zd	d
�Z	dd�Z
d
S)rmz&A requested distribution was not foundzSThe '{self.req}' distribution was not found and is required by {self.requirers_str}cCs
|jdSr�r=r�rrrr�5szDistributionNotFound.reqcCs
|jdSr�r=r�rrr�	requirers9szDistributionNotFound.requirerscCs|js
dSd�|j�S)Nzthe applicationz, )r�rIr�rrr�
requirers_str=sz"DistributionNotFound.requirers_strcCs|jjft��Srr�r�rrrr�CszDistributionNotFound.reportcCs|��Sr)r�r�rrr�__str__FszDistributionNotFound.__str__N)rrrrr�r�r�r�r�r�r�rrrrrm/s


c@seZdZdZdS)rnz>Distribution doesn't have an "extra feature" of the given nameNrrrrrrnJsz{}.{}rrC���cCs|t|<dS)aRegister `provider_factory` to make providers for `loader_type`

    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
    and `provider_factory` is a function that, passed a *module* object,
    returns an ``IResourceProvider`` for that module.
    N)�_provider_factories)Zloader_typeZprovider_factoryrrrr�XscCstt|t�r$t�|�p"tt|��dSztj|}Wn&tk
rXt	|�tj|}YnXt
|dd�}tt|�|�S)z?Return an IResourceProvider for the named module or requirementr�
__loader__N)
�
isinstancerir_�findrP�strrG�modules�KeyError�
__import__�getattr�
_find_adapterr�)ZmoduleOrReq�module�loaderrrrrRbs
cCsd|s\t��d}|dkrLd}tj�|�rLttd�rLt�|�}d|krL|d}|�|�	d��|dS)Nr�z0/System/Library/CoreServices/SystemVersion.plist�	readPlistZProductVersionrB)
rHZmac_ver�os�path�exists�hasattr�plistlibr��appendr)�_cacherZplistZ
plist_contentrrrrJos

rJcCsddd��||�S)NZppc)ZPowerPCZPower_Macintosh)�get)�machinerrr�_macosx_archsr�cCs~ddlm}|�}tjdkrz|�d�szz>t�}t��d�dd�}dt	|d�t	|d	�t
|�fWStk
rxYnX|S)
z�Return this platform's string for platform-specific distributions

    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
    needs some hacks for Linux and Mac OS X.
    r)rsrAzmacosx-r� �_zmacosx-%d.%d-%sr)Z	sysconfigrsrGrH�
startswithrJr��uname�replace�intr�rL)rsrMrr�rrrrD�s

�rDzmacosx-(\d+)\.(\d+)-(.*)zdarwin-(\d+)\.(\d+)\.(\d+)-(.*)cCs�|dks|dks||krdSt�|�}|r�t�|�}|s�t�|�}|r�t|�d��}d|�d�|�d�f}|dkr||dks�|dkr�|d	kr�dSd
S|�d�|�d�ks�|�d�|�d�kr�d
St|�d��t|�d��kr�d
SdSd
S)z�Can code for the `provided` platform run on the `required` platform?

    Returns true if either platform is ``None``, or the platforms are equal.

    XXX Needs compatibility checks for Linux and other unixy OSes.
    NTrz%s.%srC�z10.3�z10.4Fr)rErF�darwinVersionStringr�rK)ZprovidedZrequiredZreqMacZprovMacZ
provDarwinZdversionZmacosversionrrrrt�s2


���cCs<t�d�j}|d}|��||d<t|�d�||�dS)z@Locate distribution `dist_spec` and run its `script_name` scriptrrrN�rG�	_getframe�	f_globalsr6rPrQ)Z	dist_spec�script_name�ns�namerrrrQ�s
cCs@t|tj�rt�|�}t|t�r(t|�}t|t�s<td|��|S)z@Return a current distribution object for a Requirement or stringz-Expected string, Requirement, or Distribution)r�r�string_typesri�parserRrh�	TypeError�r�rrrrS�s



cCst|��||�S)zDReturn `name` entry point of `group` for `dist` or raise ImportError)rSrT�r�rKr�rrrrT�scCst|��|�S)�=Return the entry point map for `group`, or the full entry map)rSrU)r�rKrrrrU�scCst|��||�S�z<Return the EntryPoint object for `group`+`name`, or ``None``)rSrVr�rrrrV�sc@s<eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
S)r�cCsdS)z;Does the package's distribution contain the named metadata?Nr�r�rrr�has_metadata�szIMetadataProvider.has_metadatacCsdS)z'The named metadata resource as a stringNrr�rrr�get_metadata�szIMetadataProvider.get_metadatacCsdS)z�Yield named metadata resource as list of non-blank non-comment lines

       Leading and trailing whitespace is stripped from each line, and lines
       with ``#`` as the first non-blank character are omitted.Nrr�rrr�get_metadata_lines�sz$IMetadataProvider.get_metadata_linescCsdS)z>Is the named metadata a directory?  (like ``os.path.isdir()``)Nrr�rrr�metadata_isdirsz IMetadataProvider.metadata_isdircCsdS)z?List of metadata names in the directory (like ``os.listdir()``)Nrr�rrr�metadata_listdirsz"IMetadataProvider.metadata_listdircCsdS)z=Execute the named script in the supplied namespace dictionaryNr)r��	namespacerrrrQ	szIMetadataProvider.run_scriptN)	rrrr�r�r�r�r�rQrrrrr��sc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�z3An object that provides access to package resourcescCsdS)zdReturn a true filesystem path for `resource_name`

        `manager` must be an ``IResourceManager``Nr��manager�
resource_namerrr�get_resource_filenamesz'IResourceProvider.get_resource_filenamecCsdS)ziReturn a readable file-like object for `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_streamsz%IResourceProvider.get_resource_streamcCsdS)zmReturn a string containing the contents of `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_stringsz%IResourceProvider.get_resource_stringcCsdS)z,Does the package contain the named resource?Nr�r�rrr�has_resourceszIResourceProvider.has_resourcecCsdS)z>Is the named resource a directory?  (like ``os.path.isdir()``)Nrr�rrrr]"sz IResourceProvider.resource_isdircCsdS)z?List of resource names in the directory (like ``os.listdir()``)Nrr�rrrr[%sz"IResourceProvider.resource_listdirN)
rrrrr�r�r�r�r]r[rrrrr�
sc@s�eZdZdZd'dd�Zedd��Zedd��Zd	d
�Zdd�Z	d
d�Z
d(dd�Zdd�Zdd�Z
d)dd�Zd*dd�Zd+dd�Zdd�Zd,dd �Zd!d"�Zd#d$�Zd%d&�ZdS)-rfzDA collection of active distributions on sys.path (or a similar list)NcCs>g|_i|_i|_g|_|dkr&tj}|D]}|�|�q*dS)z?Create working set from list of path entries (default=sys.path)N)�entries�
entry_keys�by_key�	callbacksrGr��	add_entry)r�r��entryrrr�__init__,szWorkingSet.__init__cCsb|�}zddlm}Wntk
r.|YSXz|�|�Wntk
r\|�|�YSX|S)z1
        Prepare the master working set.
        r)�__requires__)�__main__r��ImportErrorrPrl�_build_from_requirements)�cls�wsr�rrr�
_build_master9s
zWorkingSet._build_mastercCsf|g�}t|�}|�|t��}|D]}|�|�q"tjD]}||jkr8|�|�q8|jtjdd�<|S)zQ
        Build a working set from a requirement spec. Rewrites sys.path.
        N)rp�resolvere�addrGr�r�r�)r�Zreq_specr��reqs�distsr�r�rrrr�Ms

z#WorkingSet._build_from_requirementscCs<|j�|g�|j�|�t|d�D]}|�||d�q$dS)a�Add a path item to ``.entries``, finding any distributions on it

        ``find_distributions(entry, True)`` is used to find distributions
        corresponding to the path entry, and they are added.  `entry` is
        always appended to ``.entries``, even if it is already present.
        (This is because ``sys.path`` can contain the same value more than
        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
        equal ``sys.path``.)
        TFN)r��
setdefaultr�r�rar�)r�r�r�rrrr�cs
zWorkingSet.add_entrycCs|j�|j�|kS)z9True if `dist` is the active distribution for its project)r�r�r8�r�r�rrr�__contains__rszWorkingSet.__contains__cCs,|j�|j�}|dk	r(||kr(t||��|S)a�Find a distribution matching requirement `req`

        If there is an active distribution for the requested project, this
        returns it as long as it meets the version requirement specified by
        `req`.  But, if there is an active distribution for the project and it
        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
        If there is no active distribution for the requested project, ``None``
        is returned.
        N)r�r�r8rl)r�r�r�rrrr�vs

zWorkingSet.findcs��fdd�|D�S)aYield entry point objects from `group` matching `name`

        If `name` is None, yields all entry points in `group` from all
        distributions in the working set, otherwise only ones matching
        both `group` and `name` are yielded (in distribution order).
        c3s8|]0}|�����D]}�dks*�|jkr|VqqdSr)rU�valuesr�)�.0r�r��rKr�rr�	<genexpr>�s
�z/WorkingSet.iter_entry_points.<locals>.<genexpr>r�r�rKr�rr�rrW�s�zWorkingSet.iter_entry_pointscCs>t�d�j}|d}|��||d<|�|�d�||�dS)z?Locate distribution for `requires` and run `script_name` scriptrrrNr�)r��requiresr�r�r�rrrrQ�s
zWorkingSet.run_scriptccsLi}|jD]<}||jkrq
|j|D] }||kr$d||<|j|Vq$q
dS)z�Yield distributions for non-duplicate projects in the working set

        The yield order is the order in which the items' path entries were
        added to the working set.
        rN)r�r�r�)r��seen�itemr8rrr�__iter__�s

zWorkingSet.__iter__TFcCs�|r|j|j||d�|dkr$|j}|j�|g�}|j�|jg�}|sV|j|jkrVdS||j|j<|j|krx|�|j�|j|kr�|�|j�|�|�dS)aAdd `dist` to working set, associated with `entry`

        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
        On exit from this routine, `entry` is added to the end of the working
        set's ``.entries`` (if it wasn't already present).

        `dist` is only added to the working set if it's for a project that
        doesn't already have a distribution in the set, unless `replace=True`.
        If it's added, any callbacks registered with the ``subscribe()`` method
        will be called.
        �r�N)	�	insert_onr��locationr�r�r8r�r��
_added_new)r�r�r��insertr��keysZkeys2rrrr��s

zWorkingSet.addcCsxt|�ddd�}i}i}g}t�}	t�t�}
|�rt|�d�}||krHq.|	�||�sVq.|�|j�}|dk�r|j	�|j�}|dks�||kr�|r�|}
|dkr�|dkr�t
|j�}nt
g�}tg�}
|j
||
||d�}||j<|dkr�|
�|d�}t||��|�|�||k�r$|
|}t||��|��|�|j�ddd�}|�|�|D] }|
|�|j�|j|	|<�qHd||<q.|S)a�List all distributions needed to (recursively) meet `requirements`

        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
        if supplied, should be an ``Environment`` instance.  If
        not supplied, it defaults to all distributions available within any
        entry or distribution in the working set.  `installer`, if supplied,
        will be invoked with each requirement that cannot be met by an
        already-installed distribution; it should return a ``Distribution`` or
        ``None``.

        Unless `replace_conflicting=True`, raises a VersionConflict exception
        if
        any requirements are found on the path that have the correct name but
        the wrong version.  Otherwise, if an `installer` is supplied it will be
        invoked to obtain the correct version of the requirement and activate
        it.

        `extras` is a list of the extras to be used with these requirements.
        This is important because extra requirements may look like `my_req;
        extra = "my_extra"`, which would otherwise be interpreted as a purely
        optional requirement.  Instead, we want to be able to assert that these
        requirements are truly required.
        Nr�r)�replace_conflictingT)�list�
_ReqExtras�collections�defaultdict�set�pop�markers_passr�r8r�rer�rf�
best_matchrmr�rlr�r�extras�extendr��project_name)r��requirements�env�	installerrrZ	processedZbestZto_activateZ
req_extrasr�r�r�r�r�Z
dependent_reqZnew_requirementsZnew_requirementrrrr��sT


�




zWorkingSet.resolvecCs
t|�}|��i}i}|dkr4t|j�}||7}n||}|�g�}	tt|	j|��|D]�}
||
D]�}|��g}z|	�|||�}
WnBt	k
r�}z$|||<|r�WY�qfn
WY�qZW5d}~XYqfXtt|	j|
��|�
t�|
��qZqfqZt|�}|��||fS)asFind all activatable distributions in `plugin_env`

        Example usage::

            distributions, errors = working_set.find_plugins(
                Environment(plugin_dirlist)
            )
            # add plugins+libs to sys.path
            map(working_set.add, distributions)
            # display errors
            print('Could not load', errors)

        The `plugin_env` should be an ``Environment`` instance that contains
        only distributions that are in the project's "plugin directory" or
        directories. The `full_env`, if supplied, should be an ``Environment``
        contains all currently-available distributions.  If `full_env` is not
        supplied, one is created automatically from the ``WorkingSet`` this
        method is called on, which will typically mean that every directory on
        ``sys.path`` will be scanned for distributions.

        `installer` is a standard installer callback as used by the
        ``resolve()`` method. The `fallback` flag indicates whether we should
        attempt to resolve older versions of a plugin if the newest version
        cannot be resolved.

        This method returns a 2-tuple: (`distributions`, `error_info`), where
        `distributions` is a list of the distributions found in `plugin_env`
        that were loadable, along with any other distributions that are needed
        to resolve their dependencies.  `error_info` is a dictionary mapping
        unloadable plugin distributions to an exception instance describing the
        error that occurred. Usually this will be a ``DistributionNotFound`` or
        ``VersionConflict`` instance.
        N)
r�sortrer�r�rr��as_requirementr�rkr%r'r()r�Z
plugin_envZfull_envrZfallbackZplugin_projectsZ
error_infoZ
distributionsrZ
shadow_setrr�r�Z	resolveesr"rrr�find_plugins's4$




zWorkingSet.find_pluginscGs&|�t|��}|D]}|�|�q|S)a�Ensure that distributions matching `requirements` are activated

        `requirements` must be a string or a (possibly-nested) sequence
        thereof, specifying the distributions and versions required.  The
        return value is a sequence of the distributions that needed to be
        activated to fulfill the requirements; all relevant distributions are
        included, even if they were already activated in this working set.
        )r�rpr�)r�rZneededr�rrrrP{s	zWorkingSet.requirecCs8||jkrdS|j�|�|s"dS|D]}||�q&dS)z�Invoke `callback` for all distributions

        If `existing=True` (default),
        call on all existing ones, as well.
        N)r�r�)r��callback�existingr�rrr�	subscribe�s
zWorkingSet.subscribecCs|jD]}||�qdSr)r�)r�r�rrrrr�s
zWorkingSet._added_newcCs,|jdd�|j��|j��|jdd�fSr)r�r�r2r�r�r�rrrr0�s
�zWorkingSet.__getstate__cCs@|\}}}}|dd�|_|��|_|��|_|dd�|_dSr)r�r2r�r�r�)r�Ze_k_b_cr�r
r�r�rrrr1�s


zWorkingSet.__setstate__)N)N)NTF)NNFN)NNT)T)rrrrr��classmethodr�r�r�r�r�rWrQrr�r�rrPrrr0r1rrrrrf)s4





�
]�
T
c@seZdZdZddd�ZdS)r
z>
    Map each requirement to the extras that demanded it.
    Ncs2�fdd�|��d�|pdD�}�jp0t|�S)z�
        Evaluate markers for req against each extra that
        demanded it.

        Return False if the req has a marker and fails
        evaluation. Otherwise, return True.
        c3s|]}�j�d|i�VqdS)�extraN��marker�evaluate)r�r!�r�rrr��s�z*_ReqExtras.markers_pass.<locals>.<genexpr>rr)r�r#�any)r�r�rZextra_evalsrr%rr�s
�z_ReqExtras.markers_pass)N)rrrrrrrrrr
�sr
c@sxeZdZdZde�efdd�Zdd�Zdd�Zdd	d
�Z	dd�Z
d
d�Zddd�Zddd�Z
dd�Zdd�Zdd�ZdS)rez5Searchable snapshot of distributions on a search pathNcCs i|_||_||_|�|�dS)a!Snapshot distributions available on a search path

        Any distributions found on `search_path` are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.

        `platform` is an optional string specifying the name of the platform
        that platform-specific distributions must be compatible with.  If
        unspecified, it defaults to the current platform.  `python` is an
        optional string naming the desired version of Python (e.g. ``'3.6'``);
        it defaults to the current version.

        You may explicitly set `platform` (and/or `python`) to ``None`` if you
        wish to map *all* distributions, not just those compatible with the
        running platform or Python version.
        N)�_distmaprH�python�scan)r��search_pathrHr(rrrr��szEnvironment.__init__cCs2|jdkp|jdkp|j|jk}|o0t|j|j�S)z�Is distribution `dist` acceptable for this environment?

        The distribution must match the platform and python version
        requirements specified when this environment was created, or False
        is returned.
        N)r(�
py_versionrtrH)r�r�Z	py_compatrrr�can_add�s
�
�zEnvironment.can_addcCs|j|j�|�dS)z"Remove `dist` from the environmentN)r'r8�remover�rrrr-�szEnvironment.removecCs4|dkrtj}|D]}t|�D]}|�|�qqdS)adScan `search_path` for distributions usable in this environment

        Any distributions found are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.  Only distributions conforming to
        the platform/python version defined at initialization are added.
        N)rGr�rar�)r�r*rr�rrrr)�s
zEnvironment.scancCs|��}|j�|g�S)aReturn a newest-to-oldest list of distributions for `project_name`

        Uses case-insensitive `project_name` comparison, assuming all the
        project's distributions use their project's name converted to all
        lowercase as their key.

        )�lowerr'r�)r�rZdistribution_keyrrr�__getitem__�szEnvironment.__getitem__cCsL|�|�rH|��rH|j�|jg�}||krH|�|�|jt�d�dd�dS)zLAdd `dist` if we ``can_add()`` it and it has not already been added
        �hashcmpT�r8�reverseN)	r,�has_versionr'r�r8r�r�operator�
attrgetter)r�r�r�rrrr�s

zEnvironment.addFcCsfz|�|�}Wntk
r,|s$�d}YnX|dk	r:|S||jD]}||krD|SqD|�||�S)a�Find distribution best matching `req` and usable on `working_set`

        This calls the ``find(req)`` method of the `working_set` to see if a
        suitable distribution is already active.  (This may raise
        ``VersionConflict`` if an unsuitable version of the project is already
        active in the specified `working_set`.)  If a suitable distribution
        isn't active, this method returns the newest distribution in the
        environment that meets the ``Requirement`` in `req`.  If no suitable
        distribution is found, and `installer` is supplied, then the result of
        calling the environment's ``obtain(req, installer)`` method will be
        returned.
        N)r�rlr8�obtain)r�r�r_rrr�rrrrs

zEnvironment.best_matchcCs|dk	r||�SdS)a�Obtain a distribution matching `requirement` (e.g. via download)

        Obtain a distro that matches requirement (e.g. via download).  In the
        base ``Environment`` class, this routine just returns
        ``installer(requirement)``, unless `installer` is None, in which case
        None is returned instead.  This method is a hook that allows subclasses
        to attempt other ways of obtaining a distribution before falling back
        to the `installer` argument.Nr)r�Zrequirementrrrrr6+s	zEnvironment.obtainccs"|j��D]}||r
|Vq
dS)z=Yield the unique project names of the available distributionsN)r'r
�r�r8rrrr7szEnvironment.__iter__cCsVt|t�r|�|�n<t|t�rD|D]}||D]}|�|�q0q$ntd|f��|S)z2In-place addition of a distribution or environmentzCan't add %r to environment)r�rhr�rer�)r��otherZprojectr�rrr�__iadd__=s

zEnvironment.__iadd__cCs*|jgddd�}||fD]}||7}q|S)z4Add an environment or distribution to an environmentN)rHr(�r�)r�r8�newrrrr�__add__Is
zEnvironment.__add__)N)NF)N)rrrrrO�PY_MAJORr�r,r-r)r/r�rr6rr9r<rrrrre�s"�


�

c@seZdZdZdS)roaTAn error occurred extracting a resource

    The following attributes are available from instances of this exception:

    manager
        The resource manager that raised this exception

    cache_path
        The base directory for resource extraction

    original_error
        The exception instance that caused extraction to fail
    NrrrrrroUsc@s�eZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zddd�Z
edd��Zdd�Zdd�Zd dd�ZdS)!rgz'Manage resource extraction and packagesNcCs
i|_dSr)�cached_filesr�rrrr�iszResourceManager.__init__cCst|��|�S)zDoes the named resource exist?)rRr��r�Zpackage_or_requirementr�rrrr\lszResourceManager.resource_existscCst|��|�S)z,Is the named resource an existing directory?)rRr]r?rrrr]ps�zResourceManager.resource_isdircCst|��||�S)z4Return a true filesystem path for specified resource)rRr�r?rrrrZvs�z!ResourceManager.resource_filenamecCst|��||�S)z9Return a readable file-like object for specified resource)rRr�r?rrrrY|s�zResourceManager.resource_streamcCst|��||�S)z%Return specified resource as a string)rRr�r?rrrrX�s�zResourceManager.resource_stringcCst|��|�S)z1List the contents of the named resource directory)rRr[r?rrrr[�s�z ResourceManager.resource_listdircCsRt��d}|jpt�}t�d���}t|jft	���}||_
||_||_|�dS)z5Give an error message for problems extracting file(s)ra
            Can't extract file(s) to egg cache

            The following error occurred while trying to extract file(s)
            to the Python egg cache:

              {old_exc}

            The Python egg cache directory is currently set to:

              {cache_path}

            Perhaps your account does not have write access to this directory?
            You can change the cache directory by setting the PYTHON_EGG_CACHE
            environment variable to point to an accessible directory.
            N)
rG�exc_info�extraction_pathrd�textwrap�dedent�lstripror�r�r��
cache_pathZoriginal_error)r��old_excrE�tmpl�errrrr�extraction_error�sz ResourceManager.extraction_errorrcCsf|jp
t�}tjj||df|��}zt|�Wntk
rL|��YnX|�|�d|j	|<|S)a�Return absolute location in cache for `archive_name` and `names`

        The parent directory of the resulting path will be created if it does
        not already exist.  `archive_name` should be the base filename of the
        enclosing egg (which may not be the name of the enclosing zipfile!),
        including its ".egg" extension.  `names`, if provided, should be a
        sequence of path name parts "under" the egg's extraction location.

        This method should only be called by resource providers that need to
        obtain an extraction location, and only for names they intend to
        extract, as it tracks the generated names for possible cleanup later.
        z-tmpr)
rArdr�r�rI�_bypass_ensure_directory�	ExceptionrI�_warn_unsafe_extraction_pathr>)r�Zarchive_name�namesZextract_pathZtarget_pathrrr�get_cache_path�s


zResourceManager.get_cache_pathcCsVtjdkr|�tjd�sdSt�|�j}|tj@s>|tj@rRd|}t�	|t
�dS)aN
        If the default extraction path is overridden and set to an insecure
        location, such as /tmp, it opens up an opportunity for an attacker to
        replace an extracted file with an unauthorized payload. Warn the user
        if a known insecure location is used.

        See Distribute #375 for more details.
        �ntZwindirNz�%s is writable by group/others and vulnerable to attack when used with get_resource_filename. Consider a more secure location (set with .set_extraction_path or the PYTHON_EGG_CACHE environment variable).)r�r�r��environ�stat�st_mode�S_IWOTH�S_IWGRP�warnings�warn�UserWarning)r��mode�msgrrrrL�s
��z,ResourceManager._warn_unsafe_extraction_pathcCs.tjdkr*t�|�jdBd@}t�||�dS)a4Perform any platform-specific postprocessing of `tempname`

        This is where Mac header rewrites should be done; other platforms don't
        have anything special they should do.

        Resource providers should call this method ONLY after successfully
        extracting a compressed resource.  They must NOT call it on resources
        that are already in the filesystem.

        `tempname` is the current (temporary) name of the file, and `filename`
        is the name it will be renamed to by the caller after this routine
        returns.
        �posiximi�N)r�r�rQrR�chmod)r�Ztempname�filenamerXrrr�postprocess�s
zResourceManager.postprocesscCs|jrtd��||_dS)a�Set the base path where resources will be extracted to, if needed.

        If you do not call this routine before any extractions take place, the
        path defaults to the return value of ``get_default_cache()``.  (Which
        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
        platform-specific fallbacks.  See that routine's documentation for more
        details.)

        Resources are extracted to subdirectories of this path based upon
        information given by the ``IResourceProvider``.  You may set this to a
        temporary directory, but then you must call ``cleanup_resources()`` to
        delete the extracted files when done.  There is no guarantee that
        ``cleanup_resources()`` will be able to remove all extracted files.

        (Note: you may not change the extraction path for a given resource
        manager once resources have been extracted, unless you first call
        ``cleanup_resources()``.)
        z5Can't change extraction path, files already extractedN)r>rLrA�r�r�rrrrb�s
�z#ResourceManager.set_extraction_pathFcCsdS)aB
        Delete all extracted resource files and directories, returning a list
        of the file and directory names that could not be successfully removed.
        This function does not have any concurrency protection, so it should
        generally only be called when the extraction path is a temporary
        directory exclusive to a single process.  This method is not
        automatically called; you must call it explicitly or register it as an
        ``atexit`` function if you wish to ensure cleanup of a temporary
        directory used for extractions.
        Nr)r��forcerrrrcsz!ResourceManager.cleanup_resources)r)F)rrrrrAr�r\r]rZrYrXr[rIrN�staticmethodrLr]rbrcrrrrrges 

cCstj�d�ptjdd�S)z�
    Return the ``PYTHON_EGG_CACHE`` environment variable
    or a platform-relevant user cache dir for an app
    named "Python-Eggs".
    ZPYTHON_EGG_CACHEzPython-Eggs)Zappname)r�rPr�rZuser_cache_dirrrrrrds
�cCst�dd|�S)z�Convert an arbitrary string to a standard distribution name

    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
    �[^A-Za-z0-9.]+�-)�re�subr�rrrrq%scCsJzttj�|��WStjjk
rD|�dd�}t�dd|�YSXdS)zB
    Convert an arbitrary string to a standard version string
    r�rBrarbN)r�rrrr r�rcrd)rrrrrr-s
cCst�dd|���S)z�Convert an arbitrary string to a standard 'extra' name

    Any runs of non-alphanumeric characters are replaced with a single '_',
    and the result is always lowercased.
    z[^A-Za-z0-9.-]+r�)rcrdr.)r!rrrrw9scCs|�dd�S)z|Convert a project or version name to its filename-escaped form

    Any '-' characters are currently replaced with '_'.
    rbr�rr�rrrrxBsc
CsHzt|�Wn6tk
rB}zd|_d|_|WY�Sd}~XYnXdS)zo
    Validate text as a PEP 508 environment marker; return an exception
    if invalid or False otherwise.
    NF)rz�SyntaxErrorr\�lineno)�text�errrryJsc
CsJztj�|�}|��WStjjk
rD}zt|��W5d}~XYnXdS)z�
    Evaluate a PEP 508 environment marker.
    Return a boolean indicating the marker result in this environment.
    Raise SyntaxError if marker is invalid.

    This implementation uses the 'pyparsing' module.
    N)rZmarkersZMarkerr$Z
InvalidMarkerre)rgr!r#rhrrrrzXs

c@s�eZdZdZdZdZdZdd�Zdd�Zdd�Z	d	d
�Z
dd�Zd
d�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zed'd(��Zd)d*�ZdS)+r�zETry to implement resources and metadata for arbitrary PEP 302 loadersNcCs(t|dd�|_tj�t|dd��|_dS)Nr��__file__r�)r�r�r�r��dirname�module_path�r�r�rrrr�nszNullProvider.__init__cCs|�|j|�Sr)�_fnrk�r�r�r�rrrr�rsz"NullProvider.get_resource_filenamecCst�|�||��Sr)�io�BytesIOr�rnrrrr�usz NullProvider.get_resource_streamcCs|�|�|j|��Sr)�_getrmrkrnrrrr�xsz NullProvider.get_resource_stringcCs|�|�|j|��Sr)�_hasrmrk�r�r�rrrr�{szNullProvider.has_resourcecCs|�|j|�Sr)rm�egg_info�r�r�rrr�_get_metadata_path~szNullProvider._get_metadata_pathcCs |js|jS|�|�}|�|�Sr)rtrvrr�r�r�r�rrrr��s
zNullProvider.has_metadatac
Cst|js
dS|�|�}|�|�}tjr(|Sz|�d�WStk
rn}z|jd�||�7_�W5d}~XYnXdS)Nr��utf-8z in {} file at path: {})	rtrvrqr�PY2�decode�UnicodeDecodeError�reasonr�)r�r�r��value�excrrrr��s

zNullProvider.get_metadatacCst|�|��Sr�rur�rurrrr��szNullProvider.get_metadata_linescCs|�|�|j|��Sr)�_isdirrmrkrsrrrr]�szNullProvider.resource_isdircCs|jo|�|�|j|��Sr)rtr�rmrurrrr��szNullProvider.metadata_isdircCs|�|�|j|��Sr)�_listdirrmrkrsrrrr[�szNullProvider.resource_listdircCs|jr|�|�|j|��SgSr)rtr�rmrurrrr��szNullProvider.metadata_listdirc
Cs�d|}|�|�s$tdjft����|�|��dd�}|�dd�}|�|j|�}||d<tj	�
|�r�t|���}t
||d�}t|||�n>dd	lm}t|�d|�d�|f||<t
||d�}	t|	||�dS)
Nzscripts/z<Script {script!r} not found in metadata at {self.egg_info!r}z
�
�
ri�execr)�cache)r�rkr�r�r�r�rmrtr�r�r�r�read�compiler��	linecacher��lenr)
r�r�r�ZscriptZscript_textZscript_filename�source�coder�Zscript_coderrrrQ�s.
���zNullProvider.run_scriptcCstd��dS�Nz9Can't perform this operation for unregistered loader type��NotImplementedErrorr^rrrrr�s�zNullProvider._hascCstd��dSr�r�r^rrrr��s�zNullProvider._isdircCstd��dSr�r�r^rrrr��s�zNullProvider._listdircCs*|�|�|r&tjj|f|�d���S|S)N�/)�_validate_resource_pathr�r�rIr)r��baser�rrrrm�s
zNullProvider._fncCsptjj|�tj�kp&t�|�p&t�|�}|s0dSd}t�|�rPt�|�sPt|��t	j
|dd�dtdd�dS)aO
        Validate the resource paths according to the docs.
        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access

        >>> warned = getfixture('recwarn')
        >>> warnings.simplefilter('always')
        >>> vrp = NullProvider._validate_resource_path
        >>> vrp('foo/bar.txt')
        >>> bool(warned)
        False
        >>> vrp('../foo/bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('/foo/bar.txt')
        >>> bool(warned)
        True
        >>> vrp('foo/../../bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('foo/f../bar.txt')
        >>> bool(warned)
        False

        Windows path separators are straight-up disallowed.
        >>> vrp(r'\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        >>> vrp(r'C:\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        Blank values are allowed

        >>> vrp('')
        >>> bool(warned)
        False

        Non-string values are not.

        >>> vrp(None)
        Traceback (most recent call last):
        ...
        AttributeError: ...
        Nz=Use of .. or absolute path in a resource path is not allowed.r�z/ and will raise exceptions in a future release.r��
stacklevel)r�r��pardirr�	posixpath�sep�isabs�ntpathrLrUrV�DeprecationWarning)r�ZinvalidrYrrrr��s6���z$NullProvider._validate_resource_pathcCs$t|jd�r|j�|�Std��dS)N�get_dataz=Can't perform this operation for loaders without 'get_data()')r�r�r�r�r^rrrrqs
�zNullProvider._get)rrrr�egg_namertr�r�r�r�r�r�rvr�r�r�r]r�r[r�rQrrr�r�rmr`r�rqrrrrr�gs2
Jc@s eZdZdZdd�Zdd�ZdS)r�z&Provider based on a virtual filesystemcCst�||�|��dSr)r�r��
_setup_prefixrlrrrr�-szEggProvider.__init__cCsZ|j}d}||krVt|�r@tj�|�|_tj�|d�|_||_qV|}tj�	|�\}}q
dS)N�EGG-INFO)
rk�_is_egg_pathr�r��basenamer�rIrt�egg_rootr)r�r��oldr�rrrr�1szEggProvider._setup_prefixN)rrrrr�r�rrrrr�*sc@sDeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Ze	dd
��Z
dS)r�z6Provides access to package resources in the filesystemcCstj�|�Sr)r�r�r�r^rrrrrCszDefaultProvider._hascCstj�|�Sr)r�r�r
r^rrrr�FszDefaultProvider._isdircCs
t�|�Sr)r��listdirr^rrrr�IszDefaultProvider._listdircCst|�|j|�d�S�N�rb)rrmrkrnrrrr�Lsz#DefaultProvider.get_resource_streamc
Cs*t|d��}|��W5QR�SQRXdSr�)rr�)r�r��streamrrrrqOszDefaultProvider._getcCs,d}|D]}tt|td��}t||�qdS)N)�SourceFileLoader�SourcelessFileLoader)r��importlib_machinery�typer�)r�Zloader_namesr�Z
loader_clsrrr�	_registerSszDefaultProvider._registerN)rrrrrrr�r�r�rqr r�rrrrr�@sc@s8eZdZdZdZdd�ZZdd�Zdd�Zd	d
�Z	dS)r�z.Provider that returns nothing for all requestsNcCsdS�NFrr^rrrr?cr@zEmptyProvider.<lambda>cCsdS�Nr�rr^rrrrqeszEmptyProvider._getcCsgSrrr^rrrr�hszEmptyProvider._listdircCsdSrrr�rrrr�kszEmptyProvider.__init__)
rrrrrkr�rrrqr�r�rrrrr�^sc@s eZdZdZedd��ZeZdS)�ZipManifestsz
    zip manifest builder
    c
s@t�|��,��fdd����D�}t|�W5QR�SQRXdS)a
        Build a dictionary similar to the zipimport directory
        caches, except instead of tuples, store ZipInfo objects.

        Use a platform-specific path separator (os.sep) for the path keys
        for compatibility with pypy on Windows.
        c3s&|]}|�dtj���|�fVqdS)r�N)r�r�r�Zgetinfo�r�r��Zzfilerrr��s��z%ZipManifests.build.<locals>.<genexpr>N)�zipfileZZipFileZnamelistr')r�r�r+rr�r�buildws
	
�zZipManifests.buildN)rrrrr r��loadrrrrr�rs
r�c@s$eZdZdZe�dd�Zdd�ZdS)�MemoizedZipManifestsz%
    Memoized zipfile manifests.
    �manifest_modzmanifest mtimecCsRtj�|�}t�|�j}||ks.||j|krH|�|�}|�||�||<||jS)zW
        Load a manifest at path or return a suitable manifest already loaded.
        )	r�r��normpathrQ�st_mtime�mtimer�r��manifest)r�r�r�r�rrrr��s
zMemoizedZipManifests.loadN)rrrrr�
namedtupler�r�rrrrr��sr�c@s�eZdZdZdZe�Zdd�Zdd�Zdd�Z	e
d	d
��Zdd�Ze
d
d��Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �ZdS)!r�z"Resource support for zips and eggsNcCs t�||�|jjtj|_dSr)r�r�r��archiver�r��zip_prerlrrrr��szZipProvider.__init__cCsP|�tj�}||jjkrdS|�|j�r:|t|j�d�Std||jf��dS)Nr��%s is not a subpath of %s)	�rstripr�r�r�r�r�r�r��AssertionError�r��fspathrrr�
_zipinfo_name�s�zZipProvider._zipinfo_namecCsP|j|}|�|jtj�r:|t|j�dd��tj�Std||jf��dS)Nrr�)r�r�r�r�r�r�rr�)r��zip_pathr�rrr�_parts�s
�zZipProvider._partscCs|j�|jj�Sr)�_zip_manifestsr�r�r�r�rrr�zipinfo�szZipProvider.zipinfocCs\|jstd��|�|�}|��}d�|�|��|krP|D]}|�||�|��q8|�||�S)Nz5resource_filename() only supported for .egg, not .zipr�)r�r��_resource_to_zip�_get_eager_resourcesrIr��_extract_resource�
_eager_to_zip)r�r�r�r��eagersr�rrrr��s�
z!ZipProvider.get_resource_filenamecCs"|j}|jd}t�|�}||fS)N)rrr�)�	file_size�	date_time�time�mktime)Zzip_stat�sizer��	timestamprrr�_get_date_and_size�s

zZipProvider._get_date_and_sizec
Csx||��kr@|��|D]}|�|tj�||��}qtj�|�S|�|j|�\}}ts`t	d��z�|�
|j|�|��}|�
||�r�|WStdtj�|�d�\}}	t�||j�|��t�|�t|	||f�|�|	|�zt|	|�Wnhtjk
�rNtj�|��rH|�
||��r |YWStjdk�rHt|�t|	|�|YWS�YnXWn tjk
�rr|��YnX|S)Nz>"os.rename" and "os.unlink" are not supported on this platformz	.$extract)�dirrO)�_indexr�r�r�rIrjr�r��
WRITE_SUPPORT�IOErrorrNr�r��_is_current�_mkstemp�writer�r��closerr]r
�error�isfiler�rrI)
r�r�r�r�Zlastr�r�Z	real_pathZoutfZtmpnamrrrr��sN��
�




zZipProvider._extract_resourcec		Csx|�|j|�\}}tj�|�s$dSt�|�}|j|ksB|j|krFdS|j�	|�}t
|d��}|��}W5QRX||kS)zK
        Return True if the file_path is current for this zip_path
        Fr�)r�r�r�r�r�rQ�st_sizer�r�r�rr�)	r�Z	file_pathr�r�r�rQZzip_contents�fZ
file_contentsrrrr�s
zZipProvider._is_currentcCs>|jdkr8g}dD]}|�|�r|�|�|��q||_|jS)N)znative_libs.txtzeager_resources.txt)r�r�rr�)r�r�r�rrrr�"s

z ZipProvider._get_eager_resourcesc	Cs�z|jWStk
r�i}|jD]V}|�tj�}|r"tj�|dd��}||krh||�|d�q"q2|��g||<q2q"||_|YSXdS)Nr�)	Z	_dirindex�AttributeErrorr�rr�r�rIr�r)r�Zindr��parts�parentrrrr�+s
zZipProvider._indexcCs |�|�}||jkp||��kSr)r�r�r�)r�r�r�rrrrr<s
zZipProvider._hascCs|�|�|��kSr)r�r�r�rrrr�@szZipProvider._isdircCst|���|�|�d��S�Nr)rr�r�r�r�rrrr�CszZipProvider._listdircCs|�|�|j|��Sr)r�rmr�rsrrrr�FszZipProvider._eager_to_zipcCs|�|�|j|��Sr)r�rmrkrsrrrr�IszZipProvider._resource_to_zip)rrrrr�r�r�r�r�r�r�r�r�r`r�r�r�r�r�rrr�r�r�r�rrrrr��s(



7	c@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�a*Metadata handler for standalone PKG-INFO files

    Usage::

        metadata = FileMetadata("/path/to/PKG-INFO")

    This provider rejects all data and metadata requests except for PKG-INFO,
    which is treated as existing, and will be the contents of the file at
    the provided location.
    cCs
||_dSr�r�r^rrrr�\szFileMetadata.__init__cCs|jSrr�rurrrrv_szFileMetadata._get_metadata_pathcCs|dkotj�|j�S)N�PKG-INFO)r�r�r�rurrrr�bszFileMetadata.has_metadatac	CsD|dkrtd��tj|jddd��}|��}W5QRX|�|�|S)Nr�z(No metadata except PKG-INFO is availablerxr�)�encoding�errors)r�rorr�r��_warn_on_replacement)r�r�r��metadatarrrr�es
zFileMetadata.get_metadatacCs2d�d�}||kr.d}|jft��}t�|�dS)Ns�rxz2{self.path} could not be properly decoded in UTF-8)rzr�r�rUrV)r�r�Zreplacement_charrGrYrrrr�ns

z!FileMetadata._warn_on_replacementcCst|�|��Srrrurrrr�vszFileMetadata.get_metadata_linesN)
rrrrr�rvr�r�r�r�rrrrr�Ps	c@seZdZdZdd�ZdS)r�asMetadata provider for egg directories

    Usage::

        # Development eggs:

        egg_info = "/path/to/PackageName.egg-info"
        base_dir = os.path.dirname(egg_info)
        metadata = PathMetadata(base_dir, egg_info)
        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)

        # Unpacked egg directories:

        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
        dist = Distribution.from_filename(egg_path, metadata=metadata)
    cCs||_||_dSr)rkrt)r�r�rtrrrr��szPathMetadata.__init__N�rrrrr�rrrrr�zsc@seZdZdZdd�ZdS)r�z Metadata provider for .egg filescCsD|jtj|_||_|jr0tj�|j|j�|_n|j|_|�	�dS)z-Create a metadata provider from a zipimporterN)
r�r�r�r�r��prefixr�rIrkr�)r��importerrrrr��szEggMetadata.__init__Nr�rrrrr��sr'��_distribution_finderscCs|t|<dS)axRegister `distribution_finder` to find distributions in sys.path items

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `distribution_finder` is a callable that, passed a path
    item and the importer instance, yields ``Distribution`` instances found on
    that path item.  See ``pkg_resources.find_on_path`` for an example.Nr�)�
importer_typeZdistribution_finderrrrr��scCst|�}tt|�}||||�S)z.Yield distributions accessible via `path_item`)rr�r�)�	path_item�onlyr��finderrrrra�s
c	cs�|j�d�rdSt|�}|�d�r2tj||d�V|r:dS|�d�D]|}t|�r�tj	�
||�}tt�
|�|�}|D]
}|VqrqD|���d�rDtj	�
||�}tt�
|��}||_t�|||�VqDdS)z@
    Find eggs in zip files; possibly multiple nested eggs.
    z.whlNr��r�r��
.dist-info)r��endswithr�r�rh�
from_filenamer[r�r�r�rI�find_eggs_in_zip�	zipimport�zipimporterr.rt�
from_location)	r�r�r�r�Zsubitem�subpathr�r�Zsubmetarrrr��s$

r�cCsdSr�r)r�r�r�rrr�find_nothing�sr�cCsdd�}t||dd�S)aL
    Given a list of filenames, return them in descending order
    by version number.

    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
    >>> _by_version_descending(names)
    ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg']
    cSs2tj�|�\}}t�|�d�|g�}dd�|D�S)z6
        Parse each component of the filename
        rbcSsg|]}tj�|��qSr)rrr�)r��partrrr�
<listcomp>�sz?_by_version_descending.<locals>._by_version.<locals>.<listcomp>)r�r��splitext�	itertools�chainr)r��extr�rrr�_by_version�sz+_by_version_descending.<locals>._by_versionTr1)�sorted)rMrrrr�_by_version_descending�src
#s�t���t��r4tj�t�tj��d��d�VdSt��}��fdd�|D�}t	|�}|D]2}tj��|�}t
�|��}||�D]
}	|	Vq�q\dS)z6Yield distributions accessible on a sys.path directoryr�r�Nc3s|]}t�|��r|VqdSr)�dist_factory)r�r��r�r�rrr�s�zfind_on_path.<locals>.<genexpr>)�_normalize_cached�_is_unpacked_eggrhr�r�r�r�rI�safe_listdirrr)
r�r�r�r�ZfilteredZpath_item_entriesr��fullpath�factoryr�rrr�find_on_path�s(���rcCsH|��}tt|jd��}|r tS|s0t|�r0tS|sB|�d�rBtSt�S)z9
    Return a dist_factory for a path_item and entry
    )�	.egg-infor�z	.egg-link)	r.r&rr��distributions_from_metadatar�ra�resolve_egg_link�NoDists)r�r�r�r.Zis_metarrrrs������rc@s*eZdZdZdd�ZejreZdd�ZdS)rzS
    >>> bool(NoDists())
    False

    >>> list(NoDists()('anything'))
    []
    cCsdSr�rr�rrr�__bool__.szNoDists.__bool__cCstd�Sr�)�iter)r�r	rrr�__call__3szNoDists.__call__N)	rrrrrrryZ__nonzero__rrrrrr&s
rc
Csvzt�|�WSttfk
r$YnNtk
rp}z0|jtjtjtjfkpXt	|dd�dk}|s`�W5d}~XYnXdS)zI
    Attempt to list contents of path, but suppress some exceptions.
    ZwinerrorNir)
r�r��PermissionError�NotADirectoryError�OSError�errnoZENOTDIRZEACCESZENOENTr�)r�rhZ	ignorablerrrr7s�rccsftj�|�}tj�|�r:tt�|��dkr.dSt||�}nt|�}tj�|�}t	j
|||td�VdS)Nr)�
precedence)r�r�rjr
r�r�r�r�r�rhr�r�)r��rootr�r�rrrr
Ls�r
c	cs4t|��"}|D]}|��}|r|VqW5QRXdS)z1
    Yield non-empty lines from file at path
    N)r�strip)r�r��linerrr�non_empty_lines[s

rcs.t��}�fdd�|D�}tt|�}t|d�S)za
    Given a path to an .egg-link, resolve distributions
    present in the referenced path.
    c3s$|]}tj�tj���|�VqdSr)r�r�rIrj)r��refr�rrr�ls�z#resolve_egg_link.<locals>.<genexpr>r)rrra�next)r�Zreferenced_pathsZresolved_pathsZdist_groupsrr�rrfs
�
r�
FileFinder��_namespace_handlers)�_namespace_packagescCs|t|<dS)a�Register `namespace_handler` to declare namespace packages

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `namespace_handler` is a callable like this::

        def namespace_handler(importer, path_entry, moduleName, module):
            # return a path_entry to use for child packages

    Namespace handlers are only called if the importer object has already
    agreed that it can handle the relevant path item, and they should only
    return a subpath if the module __path__ does not already contain an
    equivalent subpath.  For an example namespace handler, see
    ``pkg_resources.file_ns_handler``.
    Nr)r�Znamespace_handlerrrrr�}sc	Cs�t|�}|dkrdSt���t�d�|�|�}W5QRX|dkrHdStj�|�}|dkr�t�	|�}tj|<g|_
t|�nt|d�s�t
d|��tt|�}|||||�}|dk	r�|j
}|�|�|�|�t|||�|S)zEEnsure that named package includes a subpath of path_item (if needed)N�ignore�__path__�Not a package:)rrU�catch_warnings�simplefilter�find_modulerGr�r��types�
ModuleTyper#�_set_parent_nsr�r�r�r r��load_module�_rebuild_mod_path)�packageNamer�r�r�r�Zhandlerr�r�rrr�
_handle_ns�s.







r.csjdd�tjD���fdd����fdd�}t||d�}dd�|D�}t|jt�r`||jd	d	�<n||_d	S)
zq
    Rebuild module.__path__ ensuring that all entries are ordered
    corresponding to their sys.path order
    cSsg|]}t|��qSr�r�r��prrrr��sz%_rebuild_mod_path.<locals>.<listcomp>cs.z��|�WStk
r(td�YSXdS)z/
        Workaround for #520 and #513.
        �infN)�indexrL�float)r�)�sys_pathrr�safe_sys_path_index�sz._rebuild_mod_path.<locals>.safe_sys_path_indexcs<|�tj�}��d�d}|d|�}�ttj�|���S)zR
        Return the ordinal of the path based on its position in sys.path
        rBrN)rr�r��countrrI)r��
path_partsZmodule_partsr�)�package_namer6rr�position_in_sys_path�sz/_rebuild_mod_path.<locals>.position_in_sys_path)r8cSsg|]}t|��qSrr/r0rrrr��sN)rGr�rr�r#r)�	orig_pathr9r�r:�new_pathr)r9r6r5rr,�s		r,cCs�t��z�|tkrW��dStj}|�d�\}}}|r|t|�|tkrLt|�ztj	|j
}Wntk
rztd|��YnXt�
|p�dg��|�t�
|g�|D]}t||�q�W5t��XdS)z9Declare that package 'packageName' is a namespace packageNrBr$)�_imp�acquire_lock�release_lockr!rGr��
rpartitionr^r�r�r#r�r�r�r�r.)r-r�r�r�r�rrrr^�s&cCsFt��z.t�|d�D]}t||�}|rt||�qW5t��XdS)zDEnsure that previously-declared namespace packages include path_itemrN)r=r>r?r!r�r.r�)r�r��packager�rrrr��s
cCsDtj�||�d�d�}t|�}|jD]}t|�|kr&q@q&|SdS)zBCompute an ns-package subpath for a filesystem or zipfile importerrBr�N)r�r�rIrrr#)r�r�r-r�r�Z
normalizedrrrr�file_ns_handler�s
rBcCsdSrr)r�r�r-r�rrr�null_ns_handler	srCcCs tj�tj�tj�t|����S)z1Normalize a file/dir name for comparison purposes)r�r��normcase�realpathr��
_cygwin_patch�r\rrrr|	scCstjdkrtj�|�S|S)a
    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
    symlink components. Using
    os.path.abspath() works around this limitation. A fix in os.getcwd()
    would probably better, in Cygwin even more so, except
    that this seems to be by design...
    �cygwin)rGrHr�r��abspathrGrrrrF	srFcCs8z
||WStk
r2t|�||<}|YSXdSr)r�r|)r\r��resultrrrr)	s

rcCs|���d�S)z7
    Determine if given path appears to be an egg.
    �.egg)r.r�r�rrrr�1	sr�cCs t|�otj�tj�|dd��S)z@
    Determine if given path appears to be an unpacked egg.
    r�r�)r�r�r�r�rIr�rrrr8	s�rcCs<|�d�}|��}|r8d�|�}ttj||tj|�dS)NrB)rrrI�setattrrGr�)r-r�r�r�rrrr*B	s


r*ccsZt|tj�r8|��D] }|��}|r|�d�s|Vqn|D]}t|�D]
}|VqHq<dS)z9Yield non-empty/non-comment lines of a string or sequence�#N)r�rr��
splitlinesrr�ru)�strs�sZssrrrruJ	s
z\w+(\.\w+)*$z�
    (?P<name>[^-]+) (
        -(?P<ver>[^-]+) (
            -py(?P<pyver>[^-]+) (
                -(?P<plat>.+)
            )?
        )?
    )?
    c@s�eZdZdZddd�Zdd�Zdd	�Zddd�Zd
d�Zddd�Z	e
�d�Ze
ddd��Ze
dd��Ze
ddd��Ze
ddd��ZdS) rjz3Object representing an advertised importable objectrNcCs<t|�std|��||_||_t|�|_t|�|_||_dS)NzInvalid module name)�MODULErLr��module_name�tuple�attrsrr�)r�r�rRrTrr�rrrr�j	s


zEntryPoint.__init__cCsHd|j|jf}|jr*|dd�|j�7}|jrD|dd�|j�7}|S)Nz%s = %s�:rBz [%s]�,)r�rRrTrIr)r�rPrrrr�s	szEntryPoint.__str__cCsdt|�S)NzEntryPoint.parse(%r)�r�r�rrrr�{	szEntryPoint.__repr__TcOs4|r|s|rtjdtdd�|r,|j||�|��S)zH
        Require packages for this EntryPoint, then resolve it.
        zJParameters to load are deprecated.  Call .resolve and .require separately.rCr�)rUrVr�rPr�)r�rPr>�kwargsrrrr�~	s�zEntryPoint.loadc
CsXt|jdgdd�}zt�t|j|�WStk
rR}ztt|���W5d}~XYnXdS)zD
        Resolve the entry point from its module and attrs.
        rr)�fromlist�levelN)	r�rR�	functools�reducer�rTr�r�r�)r�r�r~rrrr��	s
zEntryPoint.resolvecCsL|jr|jstd|��|j�|j�}tj||||jd�}tttj|��dS)Nz&Can't require() without a distribution)r)	rr�rnrr_r�rrr�)r�rrr�r+rrrrP�	s

zEntryPoint.requirez]\s*(?P<name>.+?)\s*=\s*(?P<module>[\w.]+)\s*(:\s*(?P<attr>[\w.]+))?\s*(?P<extras>\[.*\])?\s*$cCsf|j�|�}|sd}t||��|��}|�|d�}|drJ|d�d�nd}||d|d|||�S)aParse a single entry point from string `src`

        Entry point syntax follows the form::

            name = some.module:some.attr [extra1, extra2]

        The entry name and module name are required, but the ``:attrs`` and
        ``[extras]`` parts are optional
        z9EntryPoint must be in 'name=module:attrs [extras]' formatr�attrrBrr�r�)�patternrFrL�	groupdict�
_parse_extrasr)r��srcr�rNrY�resrrTrrrr��	s
zEntryPoint.parsecCs(|sdSt�d|�}|jr"t��|jS)Nr�x)rir��specsrLr)r�Zextras_specr�rrrr`�	szEntryPoint._parse_extrascCsVt|�std|��i}t|�D]2}|�||�}|j|krFtd||j��|||j<q|S)zParse an entry point groupzInvalid group namezDuplicate entry point)rQrLrur�r�)r�rK�linesr��thisr�eprrr�parse_group�	s

zEntryPoint.parse_groupcCstt|t�r|��}nt|�}i}|D]J\}}|dkrB|s:q$td��|��}||kr\td|��|�|||�||<q$|S)z!Parse a map of entry point groupsNz%Entry points must be listed in groupszDuplicate group name)r�r'r+rvrLrrh)r��datar��mapsrKrerrr�	parse_map�	s


zEntryPoint.parse_map)rrN)T)NN)N)N)N)rrrrr�r�r�r�r�rPrcr�r^r r�r`rhrkrrrrrjg	s$
	



�	
cCs>|sdStj�|�}|d�d�r:tj�|dd�d�S|S)Nr�r�zmd5=)r�)rr�Zurlparser�Z
urlunparse)rZparsedrrr�_remove_md5_fragment�	srlcCs@dd�}t||�}tt|�d�}|�d�\}}}t|���p>dS)z�
    Given an iterable of lines from a Metadata file, return
    the value of the Version field, if present, or None otherwise.
    cSs|���d�S)Nzversion:)r.r�)rrrr�is_version_line�	sz+_version_from_file.<locals>.is_version_liner�rUN)rrr�	partitionrrr)rermZ
version_linesrr�r}rrr�_version_from_file�	s

rocs�eZdZdZdZddddedefdd�ZedSdd��Z	dd	�Z
ed
d��Zdd
�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zedd��Zedd��Zdd�Zed d!��Zed"d#��Zed$d%��Zd&d'�ZdTd)d*�Zd+d,�Zd-d.�Zd/d0�ZdUd2d3�Z d4d5�Z!d6d7�Z"d8d9�Z#d:d;�Z$�fd<d=�Z%e&e'd>��s4[%edVd?d@��Z(dAdB�Z)dCdD�Z*dWdEdF�Z+dGdH�Z,dXdIdJ�Z-dKdL�Z.dMdN�Z/dOdP�Z0edQdR��Z1�Z2S)Yrhz5Wrap an actual or potential sys.path entry w/metadatar�NcCsFt|pd�|_|dk	r t|�|_||_||_||_||_|p>t|_	dS)NZUnknown)
rqrrr�_versionr+rHrrr��	_provider)r�rr�rrr+rHrrrrr�
s
zDistribution.__init__cKs~dgd\}}}}tj�|�\}}	|	��tkr^t|	��}t|�}
|
r^|
�dddd�\}}}}|||f||||d�|����S)Nrr�ZverZpyverrM)rrr+rH)r�r�r�r.�_distributionImpl�EGG_NAMErK�_reload_version)r�rr�r�r)rrr+rHrrFrrrr�
s.����zDistribution.from_locationcCs|Srrr�rrrrt#
szDistribution._reload_versioncCs(|j|j|jt|j�|jpd|jp$dfSr�)�parsed_versionrr8rlrr+rHr�rrrr0&
s�zDistribution.hashcmpcCs
t|j�Sr)�hashr0r�rrr�__hash__1
szDistribution.__hash__cCs|j|jkSr�r0�r�r8rrr�__lt__4
szDistribution.__lt__cCs|j|jkSrrxryrrr�__le__7
szDistribution.__le__cCs|j|jkSrrxryrrr�__gt__:
szDistribution.__gt__cCs|j|jkSrrxryrrr�__ge__=
szDistribution.__ge__cCst||j�sdS|j|jkSr�)r�r�r0ryrrr�__eq__@
szDistribution.__eq__cCs
||kSrrryrrr�__ne__F
szDistribution.__ne__cCs6z|jWStk
r0|j��|_}|YSXdSr)Z_keyr�rr.r7rrrr8M
s
zDistribution.keycCst|d�st|j�|_|jS)N�_parsed_version)r�r#rr�r�rrrruU
s
zDistribution.parsed_versioncCsXtjj}t|j|�}|sdS|js&dSt�d����dd�}t	�
|jft|��t
�dS)Na>
            '{project_name} ({version})' is being parsed as a legacy,
            non PEP 440,
            version. You may find odd behavior and sort order.
            In particular it will be sorted as less than 0.0. It
            is recommended to migrate to PEP 440 compatible
            versions.
            r�r�)rrr!r�r�rBrCrr�rUrVr��varsr)r�ZLVZ	is_legacyrGrrr�_warn_legacy_version\
s�	z!Distribution._warn_legacy_versioncCsZz|jWStk
rT|��}|dkrL|�|j�}d�|j|�}t||��|YSXdS)Nz4Missing 'Version:' header and/or {} file at path: {})rpr��_get_version�_get_metadata_path_for_display�PKG_INFOr�rL)r�rr�rYrrrrv
s��
zDistribution.versioncCs4z|jWStk
r,|�|���|_YnX|jS)z~
        A map of extra to its list of (direct) requirements
        for this distribution, including the null extra.
        )Z_Distribution__dep_mapr��_filter_extras�_build_dep_mapr�rrr�_dep_map�
s
zDistribution._dep_mapcCsrttd|��D]^}|}|�|�}|�d�\}}}|oDt|�pDt|�}|rNg}t|�pXd}|�|g��|�q|S)z�
        Given a mapping of extras to dependencies, strip off
        environment markers and filter out any dependencies
        not matching the markers.
        NrU)	rrrrnryrzrwr�r)�dmr!Z	new_extrar�r�r#Zfails_markerrrrr��
s
�zDistribution._filter_extrascCs@i}dD]2}t|�|��D]\}}|�|g��t|��qq|S)N)zrequires.txtzdepends.txt)rv�
_get_metadatar�rrp)r�r�r�r!r�rrrr��
s
zDistribution._build_dep_maprc	Csf|j}g}|�|�dd��|D]@}z|�|t|��Wq tk
r^td||f��Yq Xq |S)z@List of Requirements needed for this distro if `extras` are usedNrz%s has no such extra feature %r)r�rr�rwr�rn)r�rr�Zdepsrrrrr�
s
�zDistribution.requirescCs,z|j�|�}Wntk
r&YdSX|S)zK
        Return the path to the given metadata file, if available.
        z[could not detect])rqrvrKrwrrrr��
s
z+Distribution._get_metadata_path_for_displayccs$|�|�r |�|�D]
}|VqdSr)r�r�)r�r�rrrrr��
s
zDistribution._get_metadatacCs|�|j�}t|�}|Sr)r�r�ro)r�rerrrrr��
szDistribution._get_versionFcCsV|dkrtj}|j||d�|tjkrRt|j�|�d�D]}|tjkr:t|�q:dS)z>Ensure distribution is importable on `path` (default=sys.path)Nr�namespace_packages.txt)rGr�rr�rr�r�r^)r�r�r�Zpkgrrr�activate�
s


zDistribution.activatecCs8dt|j�t|j�|jptf}|jr4|d|j7}|S)z@Return what this distribution's standard .egg filename should bez
%s-%s-py%srb)rxrrr+r=rH)r�r\rrrr��
s�zDistribution.egg_namecCs |jrd||jfSt|�SdS)Nz%s (%s))rr�r�rrrr��
szDistribution.__repr__cCs@zt|dd�}Wntk
r(d}YnX|p0d}d|j|fS)Nrz[unknown version]z%s %s)r�rLr)r�rrrrr��
s
zDistribution.__str__cCs|�d�rt|��t|j|�S)zADelegate all unrecognized public attributes to .metadata providerr�)r�r�r�rq)r�r]rrr�__getattr__�
s
zDistribution.__getattr__cs.tttt|����tdd�|j��D��B�S)Ncss|]}|�d�s|VqdS�r�N)r�)r�r]rrrr�s
�z'Distribution.__dir__.<locals>.<genexpr>)rr�superrh�__dir__rqr�r:rrr�s���zDistribution.__dir__r�cKs|jt|�tj�|�|f|�Sr)r�rr�r�r�)r�r\r�r)rrrr�s
��zDistribution.from_filenamecCs<t|jtjj�r"d|j|jf}nd|j|jf}t�|�S)z?Return a ``Requirement`` that matches this distribution exactlyz%s==%sz%s===%s)r�rurrrrrir�)r��specrrrrszDistribution.as_requirementcCs.|�||�}|dkr&td||ff��|��S)z=Return the `name` entry point of `group` or raise ImportErrorNzEntry point %r not found)rVr�r�)r�rKr�rgrrrrTszDistribution.load_entry_pointcCsPz
|j}Wn,tk
r6t�|�d�|�}|_YnX|dk	rL|�|i�S|S)r�zentry_points.txtN)Z_ep_mapr�rjrkr�r�)r�rKZep_maprrrrU&s
�zDistribution.get_entry_mapcCs|�|��|�Sr�)rUr�rrrrrV2szDistribution.get_entry_infoc
Cs4|p|j}|sdSt|�}tj�|�}dd�|D�}t|�D]|\}}||kr^|rVq�q�dSq<||kr<|jtkr<|s�|||d�kr�dS|tjkr�|�	�|�
||�|�
||�q�q<|tjkr�|�	�|r�|�
d|�n
|�|�dSz|�||d�}	Wnt
k
�rY�q0Yq�X||	=||	=|	}q�dS)a�Ensure self.location is on path

        If replace=False (default):
            - If location is already in path anywhere, do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent.
              - Else: add to the end of path.
        If replace=True:
            - If location is already on path anywhere (not eggs)
              or higher priority than its parent (eggs)
              do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent,
                removing any lower-priority entries.
              - Else: add it to the front of path.
        NcSsg|]}|rt|�p|�qSrr/r0rrrr�Psz*Distribution.insert_on.<locals>.<listcomp>rr)rrr�r�rj�	enumeraterr}rG�check_version_conflictr	r�r3rL)
r�r��locr�ZnlocZbdirZnpathr1rZnprrrr6s@



zDistribution.insert_oncCs�|jdkrdSt�|�d��}t|j�}|�d�D]p}|tjks2||ks2|tkrRq2|dkr\q2t	tj|dd�}|r�t|��
|�s2|�
|j�r�q2td|||jf�q2dS)N�
setuptoolsr�z
top_level.txt)Z
pkg_resourcesr�ZsiterizIModule %s was already imported from %s, but %s is being added to sys.path)r8r'r(r�r|rrGr�r!r�r��
issue_warning)r�Znspr��modname�fnrrrr�zs*

�
�
��z#Distribution.check_version_conflictcCs6z
|jWn&tk
r0tdt|��YdSXdS)NzUnbuilt egg for FT)rrLr�r�r�rrrr3�s
zDistribution.has_versioncKs@d}|��D]}|�|t||d��q|�d|j�|jf|�S)z@Copy this distribution, substituting in any changed keyword argsz<project_name version py_version platform location precedenceNr�)rr�r�rqr�)r�r)rMr]rrr�clone�s
zDistribution.clonecCsdd�|jD�S)NcSsg|]}|r|�qSrr)r�Zdeprrrr��sz'Distribution.extras.<locals>.<listcomp>)r�r�rrrr�szDistribution.extras)N)r)NF)N)N)NF)3rrrrr�r=r}r�r r�rtr�r0rwrzr{r|r}r~rr8rur�rr�r`r�r�rr�r�r�r�r�r�r�r�r�r��objectr�rrTrUrVrr�r3r�r�
__classcell__rrr:rrh
st�










		

Dc@seZdZdd�ZdS)�EggInfoDistributioncCs|��}|r||_|S)a�
        Packages installed by distutils (e.g. numpy or scipy),
        which uses an old safe_version, and so
        their version numbers can get mangled when
        converted to filenames (e.g., 1.11.0.dev0+2329eae to
        1.11.0.dev0_2329eae). These distributions will not be
        parsed properly
        downstream by Distribution and safe_version, so
        take an extra step and try to get the version number from
        the metadata file itself instead of the filename.
        )r�rp)r�Z
md_versionrrrrt�sz#EggInfoDistribution._reload_versionN)rrrrtrrrrr��sr�c@s>eZdZdZdZe�d�Zedd��Z	edd��Z
dd	�Zd
S)�DistInfoDistributionzV
    Wrap an actual or potential sys.path entry
    w/metadata, .dist-info style.
    ZMETADATAz([\(,])\s*(\d.*?)\s*([,\)])cCsFz|jWStk
r@|�|j�}tj���|�|_|jYSXdS)zParse and cache metadataN)Z	_pkg_infor�r�r��email�parserZParserZparsestr)r�r�rrr�_parsed_pkg_info�sz%DistInfoDistribution._parsed_pkg_infocCs2z|jWStk
r,|��|_|jYSXdSr)�_DistInfoDistribution__dep_mapr��_compute_dependenciesr�rrrr��s

zDistInfoDistribution._dep_mapcs�dgi}|_g�|j�d�p gD]}��t|��q"�fdd�}t|d��}|d�|�|j�d�pjgD](}t|���}tt||��|�||<ql|S)z+Recompute this distribution's dependencies.Nz
Requires-Distc3s*�D] }|jr|j�d|i�r|VqdS)Nr!r")r!r��r�rr�reqs_for_extra�szBDistInfoDistribution._compute_dependencies.<locals>.reqs_for_extrazProvides-Extra)	r�r�Zget_allrrp�	frozensetrwrr)r�r�r�r��commonr!Zs_extrarr�rr��sz*DistInfoDistribution._compute_dependenciesN)rrrrr�rcr�ZEQEQr�r�r�r�rrrrr��s

	
r�)rKrr�cOsZd}t�}zt�|�j|kr&|d7}qWntk
r<YnXtj|d|di|��dS)Nrr�)r$rGr�r�rLrUrV)r>r)rZr.rrrr��sr�c@seZdZdd�ZdS)�RequirementParseErrorcCsd�|j�S)Nr�)rIr>r�rrrr��szRequirementParseError.__str__N)rrrr�rrrrr��sr�c	cs�tt|��}|D]l}d|kr.|d|�d��}|�d�rr|dd���}z|t|�7}Wntk
rpYdSXt|�VqdS)z�Yield ``Requirement`` objects for each specification in `strs`

    `strs` must be a string, or a (possibly-nested) iterable thereof.
    z #N�\���)rrur�r�rr�
StopIterationri)rOrerrrrrps

csPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Ze	d
d��Z
�ZS)ric
s�ztt|��|�Wn2tjjk
rF}ztt|���W5d}~XYnX|j|_	t
|j�}||��|_|_
dd�|jD�|_ttt|j��|_|j
|j|jt|j�|jr�t|j�ndf|_t|j�|_dS)z>DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!NcSsg|]}|j|jf�qSr)r4r)r�r�rrrr�#sz(Requirement.__init__.<locals>.<listcomp>)r�rir�rrZInvalidRequirementr�r�r�Zunsafe_namerqr.rr8�	specifierrdrSrrwrZurlr�r#�hashCmprv�_Requirement__hash)r�Zrequirement_stringrhrr:rrr�s$
��zRequirement.__init__cCst|t�o|j|jkSr)r�rir�ryrrrr~/s

�zRequirement.__eq__cCs
||kSrrryrrrr5szRequirement.__ne__cCs0t|t�r |j|jkrdS|j}|jj|dd�S)NFT)Zprereleases)r�rhr8rr��contains)r�rrrrr�8s

zRequirement.__contains__cCs|jSr)r�r�rrrrwDszRequirement.__hash__cCsdt|�S)NzRequirement.parse(%r)rWr�rrrr�GszRequirement.__repr__cCst|�\}|Sr)rp)rPr�rrrr�Js
zRequirement.parse)rrrr�r~rr�rwr�r`r�r�rrr:rriscCst|kr|tfS|S)zJ
    Ensure object appears in the mro even
    for old-style classes.
    )r�)�classesrrr�_always_objectPs
r�cCs<tt�t|dt|����}|D]}||kr||SqdS)z2Return an adapter factory for `ob` from `registry`r�N)r��inspectZgetmror�r�)�registryr9r(�trrrr�Zsr�cCstj�|�}tj|dd�dS)z1Ensure that the parent directory of `path` existsT)�exist_okN)r�r�rjr�makedirs)r�rjrrrr{bscCsXtstd��t|�\}}|rT|rTt|�sTt|�zt|d�Wntk
rRYnXdS)z/Sandbox-bypassing version of ensure_directory()z*"os.mkdir" not supported on this platform.i�N)r�r�rr
rJr	�FileExistsError)r�rjr\rrrrJhsrJccsvd}g}t|�D]V}|�d�r\|�d�rP|s0|r:||fV|dd���}g}qftd|��q|�|�q||fVdS)asSplit a string or iterable thereof into (section, content) pairs

    Each ``section`` is a stripped version of the section header ("[section]")
    and each ``content`` is a list of stripped lines excluding blank lines and
    comment-only lines.  If there are any such lines before the first section
    header, they're returned in a first ``section`` of ``None``.
    N�[�]rr�zInvalid section heading)rur�r�rrLr�)rPZsectionZcontentrrrrrvus


cOs*tj}ztt_tj||�W�S|t_XdSr)r�r�os_open�tempfileZmkstemp)r>r)Zold_openrrrr��s
r�r")�categoryr�cOs|||�|Srr)r�r>rXrrr�_call_aside�s
r�cs.t���|d<|��fdd�t��D��dS)z=Set up global resource manager (deliberately not state-saved)Z_managerc3s&|]}|�d�s|t�|�fVqdSr�)r�r�r��r�rrr��s
�z_initialize.<locals>.<genexpr>N)rgr%r�)r.rr�r�_initialize�s
�r�cCs|t��}td|d�|j}|j}|j}|j}|}tdd�|D��|dd�dd�g|_t	t
|jtj
��t��t��d	S)
aE
    Prepare the master working set and make the ``require()``
    API available.

    This function has explicit effects on the global state
    of pkg_resources. It is intended to be invoked once at
    the initialization of this module.

    Invocation by other packages is unsupported and done
    at their own risk.
    r�)r_css|]}|jdd�VqdS)FrN�r�)r�r�rrrr��s�z1_initialize_master_working_set.<locals>.<genexpr>cSs|jdd�S)NTrr�r�rrrr?�r@z0_initialize_master_working_set.<locals>.<lambda>F)rN)rfr�r*rPrWrrQrSr�rrr�rGr�r$r%r�)r_rPrWr`rQr�rrr�_initialize_master_working_set�s"
��r�c@seZdZdZdS)r�z�
    Base class for warning about deprecations in ``pkg_resources``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    Nrrrrrr��s)N)N)F)F)F)F)N)�rZ
__future__rrGr�ror�rcr(r�r�rUrQr[Zpkgutilr4rHrr�Zemail.parserr�rr�rBr�r�r�r�rr=r�Zimpr��	NameErrorrZpkg_resources.externrZpkg_resources.extern.six.movesrrrrr	r
rr�rr�Zos.pathr
rZimportlib.machinery�	machineryr�rr�rrrr�r�Z
__metaclass__�version_info�RuntimeErrorryrrrPr_r`Zresources_streamrcZresource_dirrYrbr]rXrWr[rZr\r�r r!�RuntimeWarningrr#r&r*r0r1r5r:r;r<Z
_sget_noneZ
_sset_nonerO�__all__rKrkrlr�rmrnr�r�r=r}r~rr�r�r�rRrJr�rDr�rEr�rsrtrQr�rSrTrUrVr�r�rfr'r
rer�rorgrdrqrrrwrxryrzr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rar�r�rrrrrr
rrZImpImporterr�rr�r.r,r^r�rBrCr|rFrr�rr*rurFrQ�VERBOSE�
IGNORECASErsrjrlrorhr�r�rrr�rLr�rprrir�r�r{rJrvr��filterwarningsr�r$r�r��Warningr�rrrr�<module>sZ



�2 




.
5	A
-*

 ""


	
�	
'3�
7


&site-packages/pkg_resources/__pycache__/py31compat.cpython-38.opt-1.pyc000064400000001130151446177000021736 0ustar00U

�Qab.�@s`ddlZddlZddlZddlmZd	dd�ZejpLdejkoHdknZerVenej	Z	dS)
�N�)�sixFc
CsHzt�|�Wn4tk
rB}z|r0|jtjkr2�W5d}~XYnXdS)N)�os�makedirs�OSError�errnoZEEXIST)�path�exist_ok�exc�r�</usr/lib/python3.8/site-packages/pkg_resources/py31compat.py�_makedirs_31s
r
)��)rrr)F)
rr�sysZexternrr
ZPY2�version_infoZneeds_makedirsrrrrr�<module>s
�site-packages/pkg_resources/__pycache__/py31compat.cpython-38.pyc000064400000001130151446177000020777 0ustar00U

�Qab.�@s`ddlZddlZddlZddlmZd	dd�ZejpLdejkoHdknZerVenej	Z	dS)
�N�)�sixFc
CsHzt�|�Wn4tk
rB}z|r0|jtjkr2�W5d}~XYnXdS)N)�os�makedirs�OSError�errnoZEEXIST)�path�exist_ok�exc�r�</usr/lib/python3.8/site-packages/pkg_resources/py31compat.py�_makedirs_31s
r
)��)rrr)F)
rr�sysZexternrr
ZPY2�version_infoZneeds_makedirsrrrrr�<module>s
�site-packages/pkg_resources/__pycache__/__init__.cpython-38.pyc000064400000304004151446177000020544 0ustar00U

�Qab=��G@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZzddlZWnek
�rddlZYnXze Wne!k
�r*e"Z YnXddl#m$Z$ddl%m&Z&m'Z'm(Z(ddlm)Z)zddlm*Z*m+Z+m,Z,d	Z-Wnek
�r�d
Z-YnXddlm.Z/ddl0m1Z1m2Z2zddl3m4Z5e5j6Wnek
�r�dZ5YnXd
dl7m8Z8ddl#m9Z9ddl#m:Z:e;d�e;d�e;d�e;d�e<Z=dej>k�r@dk�rLnne?d��e$j@�r\dZAdZBdZCdZDdZEdZFdZGdZHdZIdZJdZKdZLdZMdZNdZOdZPdZQdZRdZSGdd�deT�ZUdd�ZViZWdd�ZXdd�ZYd d!�ZZd"d#�Z[d$d%�Z\d&d'�Z]d(d)�Z^d*d+�Z_Z`d,d-�Zad.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMddNddOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrgGZbGdsdI�dIec�ZdGdtdJ�dJed�ZeGdudv�dvee�ZfGdwdK�dKed�ZgGdxdL�dLed�ZhiZidyjjej>�ZkdzZld{Zmd
ZndZod|Zpd}dm�Zqd~d0�Zrgfdd��Zsd�d��Ztd�d��Zue�vd��Zwe�vd��ZxeuZyd�dR�Zzd�d/�Z{e{Z|d�d1�Z}d�d2�Z~�dd�d3�Zd�d4�Z�Gd�d`�d`�Z�Gd�da�dae��Z�Gd�dD�dD�Z�Gd�d��d�e��Z�Gd�dC�dC�Z�e�Z�Gd�dM�dMe?�Z�Gd�dE�dE�Z�d�dB�Z�d�dO�Z�d�dP�Z�d�dU�Z�d�dV�Z�d�dW�Z��dd�dX�Z�Gd�dg�dg�Z�eqe�e��Gd�dh�dhe��Z�Gd�di�die��Z�e����Gd�de�dee��Z�e��Z�Gd�d��d�e��Z�Gd�d��d�e��Z�Gd�dj�dje��Z�eqe
j�e��Gd�db�dbe��Z�Gd�dc�dce��Z�Gd�dd�dde��Z�eXd�id��d�dk�Z��dd�d?�Z��dd�d��Z�e�e
j�e���dd�d��Z�e�e�e��d�d��Z��dd�d��Z�d�d��Z�Gd�d��d��Z�d�d��Z�d�d��Z�d�d��Z�d�d��Z�e�ej�e��e�e5d���r�e�e5j�e��eXd�id��eXd�idd�dl�Z�d�dńZ�d�dDŽZ�d�d<�Z��dd�dn�Z�d�d˄Z�e�ej�e��e�e
j�e��e�e5d���r,e�e5j�e��d�d̈́Z�e�e�e��d�dZ�Z�d�dЄZ�ifd�d҄Z�d�dԄZ�d�dքZ�d�d؄Z�d�dS�Z�e�vdڡj�Z�e�vd�ej�ej�B�j�Z�Gd�dH�dH�Z�d�dބZ�d�d�Z�Gd�dF�dF�Z�Gd�d�d�eăZ�Gd�d�d�eăZ�e�e�e�d�Z�d�d�Z�Gd�d�d�eɃZ�d�dN�Z�Gd�dG�dGe:j�j̓Z�d�d�Z�d�d�Z�d�dY�Z�d�d�Z�d�dT�Z�d�d��Z�ej�d�eUd	d��d�d��Z�e�eփfd�d���Z�e�d�d���Z�Gd�dp�dpeكZ�dS(aZ
Package resource API
--------------------

A resource is a logical file contained within a package, or a logical
subdirectory thereof.  The package resource API expects resource names
to have their path parts separated with ``/``, *not* whatever the local
path separator is.  Do not use os.path operations to manipulate resource
names being passed into the API.

The package resource API is designed to work with normal filesystem packages,
.egg files, and unpacked .egg files.  It can also work in a limited way with
.zip files and with custom PEP 302 loaders that support the ``get_data()``
method.
�)�absolute_importN)�get_importer)�six)�urllib�map�filter)�utime)�mkdir�rename�unlinkTF)�open)�isdir�split�)�
py31compat)�appdirs)�	packagingz&pkg_resources.extern.packaging.versionz)pkg_resources.extern.packaging.specifiersz+pkg_resources.extern.packaging.requirementsz&pkg_resources.extern.packaging.markers)�r)r�zPython 3.4 or later is requiredc@seZdZdZdS)�
PEP440Warningza
    Used when there is an issue with a version or specifier not complying with
    PEP 440.
    N��__name__�
__module__�__qualname__�__doc__�rr�:/usr/lib/python3.8/site-packages/pkg_resources/__init__.pyrxsrcCs8ztj�|�WStjjk
r2tj�|�YSXdS�N)r�version�Version�InvalidVersion�
LegacyVersion)�vrrr�
parse_versionsr#cKs"t��|�t�t�||��dSr)�globals�update�_state_vars�dict�fromkeys)Zvartype�kwrrr�_declare_state�sr*cCs8i}t�}t��D] \}}|d|||�||<q|S)NZ_sget_)r$r&�items��state�g�kr"rrr�__getstate__�s
r0cCs8t�}|��D]$\}}|dt|||||�q|S)NZ_sset_)r$r+r&r,rrr�__setstate__�sr1cCs|��Sr)�copy��valrrr�
_sget_dict�sr5cCs|��|�|�dSr)�clearr%��key�obr-rrr�
_sset_dict�sr:cCs|��Sr)r0r3rrr�_sget_object�sr;cCs|�|�dSr)r1r7rrr�_sset_object�sr<cGsdSrr��argsrrr�<lambda>��r?cCsbt�}t�|�}|dk	r^tjdkr^z&dd�t�dd��|�d�f}Wntk
r\YnX|S)aZReturn this platform's maximum compatible version.

    distutils.util.get_platform() normally reports the minimum version
    of Mac OS X that would be required to *use* extensions produced by
    distutils.  But what we want when checking compatibility is to know the
    version of Mac OS X that we are *running*.  To allow usage of packages that
    explicitly require a newer version of Mac OS X, we must also know the
    current version of the OS.

    If this condition occurs for any other platform with a version in its
    platform strings, this function should be extended accordingly.
    N�darwinzmacosx-%s-%s�.�r)	�get_build_platform�macosVersionString�match�sys�platform�join�_macosx_vers�group�
ValueError)�plat�mrrr�get_supported_platform�s

&rO�require�
run_script�get_provider�get_distribution�load_entry_point�
get_entry_map�get_entry_info�iter_entry_points�resource_string�resource_stream�resource_filename�resource_listdir�resource_exists�resource_isdir�declare_namespace�working_set�add_activation_listener�find_distributions�set_extraction_path�cleanup_resources�get_default_cache�Environment�
WorkingSet�ResourceManager�Distribution�Requirement�
EntryPoint�ResolutionError�VersionConflict�DistributionNotFound�UnknownExtra�ExtractionError�parse_requirements�	safe_name�safe_version�get_platform�compatible_platforms�yield_lines�split_sections�
safe_extra�to_filename�invalid_marker�evaluate_marker�ensure_directory�normalize_path�EGG_DIST�BINARY_DIST�SOURCE_DIST�
CHECKOUT_DIST�DEVELOP_DIST�IMetadataProvider�IResourceProvider�FileMetadata�PathMetadata�EggMetadata�
EmptyProvider�empty_provider�NullProvider�EggProvider�DefaultProvider�ZipProvider�register_finder�register_namespace_handler�register_loader_type�fixup_namespace_packagesr�PkgResourcesDeprecationWarning�run_main�AvailableDistributionsc@seZdZdZdd�ZdS)rkz.Abstract base for dependency resolution errorscCs|jjt|j�Sr)�	__class__r�reprr>��selfrrr�__repr__�szResolutionError.__repr__N)rrrrr�rrrrrk�sc@s<eZdZdZdZedd��Zedd��Zdd�Zd	d
�Z	dS)rlz�
    An already-installed version conflicts with the requested version.

    Should be initialized with the installed Distribution and the requested
    Requirement.
    z3{self.dist} is installed but {self.req} is requiredcCs
|jdS�Nrr=r�rrr�distszVersionConflict.distcCs
|jdS�Nrr=r�rrr�reqszVersionConflict.reqcCs|jjft��Sr��	_template�format�localsr�rrr�reportszVersionConflict.reportcCs|s|S|j|f}t|�S)zt
        If required_by is non-empty, return a version of self that is a
        ContextualVersionConflict.
        )r>�ContextualVersionConflict)r��required_byr>rrr�with_contextszVersionConflict.with_contextN)
rrrrr��propertyr�r�r�r�rrrrrls

c@s&eZdZdZejdZedd��ZdS)r�z�
    A VersionConflict that accepts a third parameter, the set of the
    requirements that required the installed Distribution.
    z by {self.required_by}cCs
|jdS)NrCr=r�rrrr�*sz%ContextualVersionConflict.required_byN)rrrrrlr�r�r�rrrrr�"s
r�c@sHeZdZdZdZedd��Zedd��Zedd��Zd	d
�Z	dd�Z
d
S)rmz&A requested distribution was not foundzSThe '{self.req}' distribution was not found and is required by {self.requirers_str}cCs
|jdSr�r=r�rrrr�5szDistributionNotFound.reqcCs
|jdSr�r=r�rrr�	requirers9szDistributionNotFound.requirerscCs|js
dSd�|j�S)Nzthe applicationz, )r�rIr�rrr�
requirers_str=sz"DistributionNotFound.requirers_strcCs|jjft��Srr�r�rrrr�CszDistributionNotFound.reportcCs|��Sr)r�r�rrr�__str__FszDistributionNotFound.__str__N)rrrrr�r�r�r�r�r�r�rrrrrm/s


c@seZdZdZdS)rnz>Distribution doesn't have an "extra feature" of the given nameNrrrrrrnJsz{}.{}rrC���cCs|t|<dS)aRegister `provider_factory` to make providers for `loader_type`

    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
    and `provider_factory` is a function that, passed a *module* object,
    returns an ``IResourceProvider`` for that module.
    N)�_provider_factories)Zloader_typeZprovider_factoryrrrr�XscCstt|t�r$t�|�p"tt|��dSztj|}Wn&tk
rXt	|�tj|}YnXt
|dd�}tt|�|�S)z?Return an IResourceProvider for the named module or requirementr�
__loader__N)
�
isinstancerir_�findrP�strrG�modules�KeyError�
__import__�getattr�
_find_adapterr�)ZmoduleOrReq�module�loaderrrrrRbs
cCsd|s\t��d}|dkrLd}tj�|�rLttd�rLt�|�}d|krL|d}|�|�	d��|dS)Nr�z0/System/Library/CoreServices/SystemVersion.plist�	readPlistZProductVersionrB)
rHZmac_ver�os�path�exists�hasattr�plistlibr��appendr)�_cacherZplistZ
plist_contentrrrrJos

rJcCsddd��||�S)NZppc)ZPowerPCZPower_Macintosh)�get)�machinerrr�_macosx_archsr�cCs~ddlm}|�}tjdkrz|�d�szz>t�}t��d�dd�}dt	|d�t	|d	�t
|�fWStk
rxYnX|S)
z�Return this platform's string for platform-specific distributions

    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
    needs some hacks for Linux and Mac OS X.
    r)rsrAzmacosx-r� �_zmacosx-%d.%d-%sr)Z	sysconfigrsrGrH�
startswithrJr��uname�replace�intr�rL)rsrMrr�rrrrD�s

�rDzmacosx-(\d+)\.(\d+)-(.*)zdarwin-(\d+)\.(\d+)\.(\d+)-(.*)cCs�|dks|dks||krdSt�|�}|r�t�|�}|s�t�|�}|r�t|�d��}d|�d�|�d�f}|dkr||dks�|dkr�|d	kr�dSd
S|�d�|�d�ks�|�d�|�d�kr�d
St|�d��t|�d��kr�d
SdSd
S)z�Can code for the `provided` platform run on the `required` platform?

    Returns true if either platform is ``None``, or the platforms are equal.

    XXX Needs compatibility checks for Linux and other unixy OSes.
    NTrz%s.%srC�z10.3�z10.4Fr)rErF�darwinVersionStringr�rK)ZprovidedZrequiredZreqMacZprovMacZ
provDarwinZdversionZmacosversionrrrrt�s2


���cCs<t�d�j}|d}|��||d<t|�d�||�dS)z@Locate distribution `dist_spec` and run its `script_name` scriptrrrN�rG�	_getframe�	f_globalsr6rPrQ)Z	dist_spec�script_name�ns�namerrrrQ�s
cCs@t|tj�rt�|�}t|t�r(t|�}t|t�s<td|��|S)z@Return a current distribution object for a Requirement or stringz-Expected string, Requirement, or Distribution)r�r�string_typesri�parserRrh�	TypeError�r�rrrrS�s



cCst|��||�S)zDReturn `name` entry point of `group` for `dist` or raise ImportError)rSrT�r�rKr�rrrrT�scCst|��|�S)�=Return the entry point map for `group`, or the full entry map)rSrU)r�rKrrrrU�scCst|��||�S�z<Return the EntryPoint object for `group`+`name`, or ``None``)rSrVr�rrrrV�sc@s<eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
S)r�cCsdS)z;Does the package's distribution contain the named metadata?Nr�r�rrr�has_metadata�szIMetadataProvider.has_metadatacCsdS)z'The named metadata resource as a stringNrr�rrr�get_metadata�szIMetadataProvider.get_metadatacCsdS)z�Yield named metadata resource as list of non-blank non-comment lines

       Leading and trailing whitespace is stripped from each line, and lines
       with ``#`` as the first non-blank character are omitted.Nrr�rrr�get_metadata_lines�sz$IMetadataProvider.get_metadata_linescCsdS)z>Is the named metadata a directory?  (like ``os.path.isdir()``)Nrr�rrr�metadata_isdirsz IMetadataProvider.metadata_isdircCsdS)z?List of metadata names in the directory (like ``os.listdir()``)Nrr�rrr�metadata_listdirsz"IMetadataProvider.metadata_listdircCsdS)z=Execute the named script in the supplied namespace dictionaryNr)r��	namespacerrrrQ	szIMetadataProvider.run_scriptN)	rrrr�r�r�r�r�rQrrrrr��sc@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�z3An object that provides access to package resourcescCsdS)zdReturn a true filesystem path for `resource_name`

        `manager` must be an ``IResourceManager``Nr��manager�
resource_namerrr�get_resource_filenamesz'IResourceProvider.get_resource_filenamecCsdS)ziReturn a readable file-like object for `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_streamsz%IResourceProvider.get_resource_streamcCsdS)zmReturn a string containing the contents of `resource_name`

        `manager` must be an ``IResourceManager``Nrr�rrr�get_resource_stringsz%IResourceProvider.get_resource_stringcCsdS)z,Does the package contain the named resource?Nr�r�rrr�has_resourceszIResourceProvider.has_resourcecCsdS)z>Is the named resource a directory?  (like ``os.path.isdir()``)Nrr�rrrr]"sz IResourceProvider.resource_isdircCsdS)z?List of resource names in the directory (like ``os.listdir()``)Nrr�rrrr[%sz"IResourceProvider.resource_listdirN)
rrrrr�r�r�r�r]r[rrrrr�
sc@s�eZdZdZd'dd�Zedd��Zedd��Zd	d
�Zdd�Z	d
d�Z
d(dd�Zdd�Zdd�Z
d)dd�Zd*dd�Zd+dd�Zdd�Zd,dd �Zd!d"�Zd#d$�Zd%d&�ZdS)-rfzDA collection of active distributions on sys.path (or a similar list)NcCs>g|_i|_i|_g|_|dkr&tj}|D]}|�|�q*dS)z?Create working set from list of path entries (default=sys.path)N)�entries�
entry_keys�by_key�	callbacksrGr��	add_entry)r�r��entryrrr�__init__,szWorkingSet.__init__cCsb|�}zddlm}Wntk
r.|YSXz|�|�Wntk
r\|�|�YSX|S)z1
        Prepare the master working set.
        r)�__requires__)�__main__r��ImportErrorrPrl�_build_from_requirements)�cls�wsr�rrr�
_build_master9s
zWorkingSet._build_mastercCsf|g�}t|�}|�|t��}|D]}|�|�q"tjD]}||jkr8|�|�q8|jtjdd�<|S)zQ
        Build a working set from a requirement spec. Rewrites sys.path.
        N)rp�resolvere�addrGr�r�r�)r�Zreq_specr��reqs�distsr�r�rrrr�Ms

z#WorkingSet._build_from_requirementscCs<|j�|g�|j�|�t|d�D]}|�||d�q$dS)a�Add a path item to ``.entries``, finding any distributions on it

        ``find_distributions(entry, True)`` is used to find distributions
        corresponding to the path entry, and they are added.  `entry` is
        always appended to ``.entries``, even if it is already present.
        (This is because ``sys.path`` can contain the same value more than
        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
        equal ``sys.path``.)
        TFN)r��
setdefaultr�r�rar�)r�r�r�rrrr�cs
zWorkingSet.add_entrycCs|j�|j�|kS)z9True if `dist` is the active distribution for its project)r�r�r8�r�r�rrr�__contains__rszWorkingSet.__contains__cCs,|j�|j�}|dk	r(||kr(t||��|S)a�Find a distribution matching requirement `req`

        If there is an active distribution for the requested project, this
        returns it as long as it meets the version requirement specified by
        `req`.  But, if there is an active distribution for the project and it
        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
        If there is no active distribution for the requested project, ``None``
        is returned.
        N)r�r�r8rl)r�r�r�rrrr�vs

zWorkingSet.findcs��fdd�|D�S)aYield entry point objects from `group` matching `name`

        If `name` is None, yields all entry points in `group` from all
        distributions in the working set, otherwise only ones matching
        both `group` and `name` are yielded (in distribution order).
        c3s8|]0}|�����D]}�dks*�|jkr|VqqdSr)rU�valuesr�)�.0r�r��rKr�rr�	<genexpr>�s
�z/WorkingSet.iter_entry_points.<locals>.<genexpr>r�r�rKr�rr�rrW�s�zWorkingSet.iter_entry_pointscCs>t�d�j}|d}|��||d<|�|�d�||�dS)z?Locate distribution for `requires` and run `script_name` scriptrrrNr�)r��requiresr�r�r�rrrrQ�s
zWorkingSet.run_scriptccsLi}|jD]<}||jkrq
|j|D] }||kr$d||<|j|Vq$q
dS)z�Yield distributions for non-duplicate projects in the working set

        The yield order is the order in which the items' path entries were
        added to the working set.
        rN)r�r�r�)r��seen�itemr8rrr�__iter__�s

zWorkingSet.__iter__TFcCs�|r|j|j||d�|dkr$|j}|j�|g�}|j�|jg�}|sV|j|jkrVdS||j|j<|j|krx|�|j�|j|kr�|�|j�|�|�dS)aAdd `dist` to working set, associated with `entry`

        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
        On exit from this routine, `entry` is added to the end of the working
        set's ``.entries`` (if it wasn't already present).

        `dist` is only added to the working set if it's for a project that
        doesn't already have a distribution in the set, unless `replace=True`.
        If it's added, any callbacks registered with the ``subscribe()`` method
        will be called.
        �r�N)	�	insert_onr��locationr�r�r8r�r��
_added_new)r�r�r��insertr��keysZkeys2rrrr��s

zWorkingSet.addcCsxt|�ddd�}i}i}g}t�}	t�t�}
|�rt|�d�}||krHq.|	�||�sVq.|�|j�}|dk�r|j	�|j�}|dks�||kr�|r�|}
|dkr�|dkr�t
|j�}nt
g�}tg�}
|j
||
||d�}||j<|dkr�|
�|d�}t||��|�|�||k�r$|
|}t||��|��|�|j�ddd�}|�|�|D] }|
|�|j�|j|	|<�qHd||<q.|S)a�List all distributions needed to (recursively) meet `requirements`

        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
        if supplied, should be an ``Environment`` instance.  If
        not supplied, it defaults to all distributions available within any
        entry or distribution in the working set.  `installer`, if supplied,
        will be invoked with each requirement that cannot be met by an
        already-installed distribution; it should return a ``Distribution`` or
        ``None``.

        Unless `replace_conflicting=True`, raises a VersionConflict exception
        if
        any requirements are found on the path that have the correct name but
        the wrong version.  Otherwise, if an `installer` is supplied it will be
        invoked to obtain the correct version of the requirement and activate
        it.

        `extras` is a list of the extras to be used with these requirements.
        This is important because extra requirements may look like `my_req;
        extra = "my_extra"`, which would otherwise be interpreted as a purely
        optional requirement.  Instead, we want to be able to assert that these
        requirements are truly required.
        Nr�r)�replace_conflictingT)�list�
_ReqExtras�collections�defaultdict�set�pop�markers_passr�r8r�rer�rf�
best_matchrmr�rlr�r�extras�extendr��project_name)r��requirements�env�	installerrrZ	processedZbestZto_activateZ
req_extrasr�r�r�r�r�Z
dependent_reqZnew_requirementsZnew_requirementrrrr��sT


�




zWorkingSet.resolvecCs
t|�}|��i}i}|dkr4t|j�}||7}n||}|�g�}	tt|	j|��|D]�}
||
D]�}|��g}z|	�|||�}
WnBt	k
r�}z$|||<|r�WY�qfn
WY�qZW5d}~XYqfXtt|	j|
��|�
t�|
��qZqfqZt|�}|��||fS)asFind all activatable distributions in `plugin_env`

        Example usage::

            distributions, errors = working_set.find_plugins(
                Environment(plugin_dirlist)
            )
            # add plugins+libs to sys.path
            map(working_set.add, distributions)
            # display errors
            print('Could not load', errors)

        The `plugin_env` should be an ``Environment`` instance that contains
        only distributions that are in the project's "plugin directory" or
        directories. The `full_env`, if supplied, should be an ``Environment``
        contains all currently-available distributions.  If `full_env` is not
        supplied, one is created automatically from the ``WorkingSet`` this
        method is called on, which will typically mean that every directory on
        ``sys.path`` will be scanned for distributions.

        `installer` is a standard installer callback as used by the
        ``resolve()`` method. The `fallback` flag indicates whether we should
        attempt to resolve older versions of a plugin if the newest version
        cannot be resolved.

        This method returns a 2-tuple: (`distributions`, `error_info`), where
        `distributions` is a list of the distributions found in `plugin_env`
        that were loadable, along with any other distributions that are needed
        to resolve their dependencies.  `error_info` is a dictionary mapping
        unloadable plugin distributions to an exception instance describing the
        error that occurred. Usually this will be a ``DistributionNotFound`` or
        ``VersionConflict`` instance.
        N)
r�sortrer�r�rr��as_requirementr�rkr%r'r()r�Z
plugin_envZfull_envrZfallbackZplugin_projectsZ
error_infoZ
distributionsrZ
shadow_setrr�r�Z	resolveesr"rrr�find_plugins's4$




zWorkingSet.find_pluginscGs&|�t|��}|D]}|�|�q|S)a�Ensure that distributions matching `requirements` are activated

        `requirements` must be a string or a (possibly-nested) sequence
        thereof, specifying the distributions and versions required.  The
        return value is a sequence of the distributions that needed to be
        activated to fulfill the requirements; all relevant distributions are
        included, even if they were already activated in this working set.
        )r�rpr�)r�rZneededr�rrrrP{s	zWorkingSet.requirecCs8||jkrdS|j�|�|s"dS|D]}||�q&dS)z�Invoke `callback` for all distributions

        If `existing=True` (default),
        call on all existing ones, as well.
        N)r�r�)r��callback�existingr�rrr�	subscribe�s
zWorkingSet.subscribecCs|jD]}||�qdSr)r�)r�r�rrrrr�s
zWorkingSet._added_newcCs,|jdd�|j��|j��|jdd�fSr)r�r�r2r�r�r�rrrr0�s
�zWorkingSet.__getstate__cCs@|\}}}}|dd�|_|��|_|��|_|dd�|_dSr)r�r2r�r�r�)r�Ze_k_b_cr�r
r�r�rrrr1�s


zWorkingSet.__setstate__)N)N)NTF)NNFN)NNT)T)rrrrr��classmethodr�r�r�r�r�rWrQrr�r�rrPrrr0r1rrrrrf)s4





�
]�
T
c@seZdZdZddd�ZdS)r
z>
    Map each requirement to the extras that demanded it.
    Ncs2�fdd�|��d�|pdD�}�jp0t|�S)z�
        Evaluate markers for req against each extra that
        demanded it.

        Return False if the req has a marker and fails
        evaluation. Otherwise, return True.
        c3s|]}�j�d|i�VqdS)�extraN��marker�evaluate)r�r!�r�rrr��s�z*_ReqExtras.markers_pass.<locals>.<genexpr>rr)r�r#�any)r�r�rZextra_evalsrr%rr�s
�z_ReqExtras.markers_pass)N)rrrrrrrrrr
�sr
c@sxeZdZdZde�efdd�Zdd�Zdd�Zdd	d
�Z	dd�Z
d
d�Zddd�Zddd�Z
dd�Zdd�Zdd�ZdS)rez5Searchable snapshot of distributions on a search pathNcCs i|_||_||_|�|�dS)a!Snapshot distributions available on a search path

        Any distributions found on `search_path` are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.

        `platform` is an optional string specifying the name of the platform
        that platform-specific distributions must be compatible with.  If
        unspecified, it defaults to the current platform.  `python` is an
        optional string naming the desired version of Python (e.g. ``'3.6'``);
        it defaults to the current version.

        You may explicitly set `platform` (and/or `python`) to ``None`` if you
        wish to map *all* distributions, not just those compatible with the
        running platform or Python version.
        N)�_distmaprH�python�scan)r��search_pathrHr(rrrr��szEnvironment.__init__cCs2|jdkp|jdkp|j|jk}|o0t|j|j�S)z�Is distribution `dist` acceptable for this environment?

        The distribution must match the platform and python version
        requirements specified when this environment was created, or False
        is returned.
        N)r(�
py_versionrtrH)r�r�Z	py_compatrrr�can_add�s
�
�zEnvironment.can_addcCs|j|j�|�dS)z"Remove `dist` from the environmentN)r'r8�remover�rrrr-�szEnvironment.removecCs4|dkrtj}|D]}t|�D]}|�|�qqdS)adScan `search_path` for distributions usable in this environment

        Any distributions found are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.  Only distributions conforming to
        the platform/python version defined at initialization are added.
        N)rGr�rar�)r�r*rr�rrrr)�s
zEnvironment.scancCs|��}|j�|g�S)aReturn a newest-to-oldest list of distributions for `project_name`

        Uses case-insensitive `project_name` comparison, assuming all the
        project's distributions use their project's name converted to all
        lowercase as their key.

        )�lowerr'r�)r�rZdistribution_keyrrr�__getitem__�szEnvironment.__getitem__cCsL|�|�rH|��rH|j�|jg�}||krH|�|�|jt�d�dd�dS)zLAdd `dist` if we ``can_add()`` it and it has not already been added
        �hashcmpT�r8�reverseN)	r,�has_versionr'r�r8r�r�operator�
attrgetter)r�r�r�rrrr�s

zEnvironment.addFcCsfz|�|�}Wntk
r,|s$�d}YnX|dk	r:|S||jD]}||krD|SqD|�||�S)a�Find distribution best matching `req` and usable on `working_set`

        This calls the ``find(req)`` method of the `working_set` to see if a
        suitable distribution is already active.  (This may raise
        ``VersionConflict`` if an unsuitable version of the project is already
        active in the specified `working_set`.)  If a suitable distribution
        isn't active, this method returns the newest distribution in the
        environment that meets the ``Requirement`` in `req`.  If no suitable
        distribution is found, and `installer` is supplied, then the result of
        calling the environment's ``obtain(req, installer)`` method will be
        returned.
        N)r�rlr8�obtain)r�r�r_rrr�rrrrs

zEnvironment.best_matchcCs|dk	r||�SdS)a�Obtain a distribution matching `requirement` (e.g. via download)

        Obtain a distro that matches requirement (e.g. via download).  In the
        base ``Environment`` class, this routine just returns
        ``installer(requirement)``, unless `installer` is None, in which case
        None is returned instead.  This method is a hook that allows subclasses
        to attempt other ways of obtaining a distribution before falling back
        to the `installer` argument.Nr)r�Zrequirementrrrrr6+s	zEnvironment.obtainccs"|j��D]}||r
|Vq
dS)z=Yield the unique project names of the available distributionsN)r'r
�r�r8rrrr7szEnvironment.__iter__cCsVt|t�r|�|�n<t|t�rD|D]}||D]}|�|�q0q$ntd|f��|S)z2In-place addition of a distribution or environmentzCan't add %r to environment)r�rhr�rer�)r��otherZprojectr�rrr�__iadd__=s

zEnvironment.__iadd__cCs*|jgddd�}||fD]}||7}q|S)z4Add an environment or distribution to an environmentN)rHr(�r�)r�r8�newrrrr�__add__Is
zEnvironment.__add__)N)NF)N)rrrrrO�PY_MAJORr�r,r-r)r/r�rr6rr9r<rrrrre�s"�


�

c@seZdZdZdS)roaTAn error occurred extracting a resource

    The following attributes are available from instances of this exception:

    manager
        The resource manager that raised this exception

    cache_path
        The base directory for resource extraction

    original_error
        The exception instance that caused extraction to fail
    NrrrrrroUsc@s�eZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dd�Zdd�Zddd�Z
edd��Zdd�Zdd�Zd dd�ZdS)!rgz'Manage resource extraction and packagesNcCs
i|_dSr)�cached_filesr�rrrr�iszResourceManager.__init__cCst|��|�S)zDoes the named resource exist?)rRr��r�Zpackage_or_requirementr�rrrr\lszResourceManager.resource_existscCst|��|�S)z,Is the named resource an existing directory?)rRr]r?rrrr]ps�zResourceManager.resource_isdircCst|��||�S)z4Return a true filesystem path for specified resource)rRr�r?rrrrZvs�z!ResourceManager.resource_filenamecCst|��||�S)z9Return a readable file-like object for specified resource)rRr�r?rrrrY|s�zResourceManager.resource_streamcCst|��||�S)z%Return specified resource as a string)rRr�r?rrrrX�s�zResourceManager.resource_stringcCst|��|�S)z1List the contents of the named resource directory)rRr[r?rrrr[�s�z ResourceManager.resource_listdircCsRt��d}|jpt�}t�d���}t|jft	���}||_
||_||_|�dS)z5Give an error message for problems extracting file(s)ra
            Can't extract file(s) to egg cache

            The following error occurred while trying to extract file(s)
            to the Python egg cache:

              {old_exc}

            The Python egg cache directory is currently set to:

              {cache_path}

            Perhaps your account does not have write access to this directory?
            You can change the cache directory by setting the PYTHON_EGG_CACHE
            environment variable to point to an accessible directory.
            N)
rG�exc_info�extraction_pathrd�textwrap�dedent�lstripror�r�r��
cache_pathZoriginal_error)r��old_excrE�tmpl�errrrr�extraction_error�sz ResourceManager.extraction_errorrcCsf|jp
t�}tjj||df|��}zt|�Wntk
rL|��YnX|�|�d|j	|<|S)a�Return absolute location in cache for `archive_name` and `names`

        The parent directory of the resulting path will be created if it does
        not already exist.  `archive_name` should be the base filename of the
        enclosing egg (which may not be the name of the enclosing zipfile!),
        including its ".egg" extension.  `names`, if provided, should be a
        sequence of path name parts "under" the egg's extraction location.

        This method should only be called by resource providers that need to
        obtain an extraction location, and only for names they intend to
        extract, as it tracks the generated names for possible cleanup later.
        z-tmpr)
rArdr�r�rI�_bypass_ensure_directory�	ExceptionrI�_warn_unsafe_extraction_pathr>)r�Zarchive_name�namesZextract_pathZtarget_pathrrr�get_cache_path�s


zResourceManager.get_cache_pathcCsVtjdkr|�tjd�sdSt�|�j}|tj@s>|tj@rRd|}t�	|t
�dS)aN
        If the default extraction path is overridden and set to an insecure
        location, such as /tmp, it opens up an opportunity for an attacker to
        replace an extracted file with an unauthorized payload. Warn the user
        if a known insecure location is used.

        See Distribute #375 for more details.
        �ntZwindirNz�%s is writable by group/others and vulnerable to attack when used with get_resource_filename. Consider a more secure location (set with .set_extraction_path or the PYTHON_EGG_CACHE environment variable).)r�r�r��environ�stat�st_mode�S_IWOTH�S_IWGRP�warnings�warn�UserWarning)r��mode�msgrrrrL�s
��z,ResourceManager._warn_unsafe_extraction_pathcCs.tjdkr*t�|�jdBd@}t�||�dS)a4Perform any platform-specific postprocessing of `tempname`

        This is where Mac header rewrites should be done; other platforms don't
        have anything special they should do.

        Resource providers should call this method ONLY after successfully
        extracting a compressed resource.  They must NOT call it on resources
        that are already in the filesystem.

        `tempname` is the current (temporary) name of the file, and `filename`
        is the name it will be renamed to by the caller after this routine
        returns.
        �posiximi�N)r�r�rQrR�chmod)r�Ztempname�filenamerXrrr�postprocess�s
zResourceManager.postprocesscCs|jrtd��||_dS)a�Set the base path where resources will be extracted to, if needed.

        If you do not call this routine before any extractions take place, the
        path defaults to the return value of ``get_default_cache()``.  (Which
        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
        platform-specific fallbacks.  See that routine's documentation for more
        details.)

        Resources are extracted to subdirectories of this path based upon
        information given by the ``IResourceProvider``.  You may set this to a
        temporary directory, but then you must call ``cleanup_resources()`` to
        delete the extracted files when done.  There is no guarantee that
        ``cleanup_resources()`` will be able to remove all extracted files.

        (Note: you may not change the extraction path for a given resource
        manager once resources have been extracted, unless you first call
        ``cleanup_resources()``.)
        z5Can't change extraction path, files already extractedN)r>rLrA�r�r�rrrrb�s
�z#ResourceManager.set_extraction_pathFcCsdS)aB
        Delete all extracted resource files and directories, returning a list
        of the file and directory names that could not be successfully removed.
        This function does not have any concurrency protection, so it should
        generally only be called when the extraction path is a temporary
        directory exclusive to a single process.  This method is not
        automatically called; you must call it explicitly or register it as an
        ``atexit`` function if you wish to ensure cleanup of a temporary
        directory used for extractions.
        Nr)r��forcerrrrcsz!ResourceManager.cleanup_resources)r)F)rrrrrAr�r\r]rZrYrXr[rIrN�staticmethodrLr]rbrcrrrrrges 

cCstj�d�ptjdd�S)z�
    Return the ``PYTHON_EGG_CACHE`` environment variable
    or a platform-relevant user cache dir for an app
    named "Python-Eggs".
    ZPYTHON_EGG_CACHEzPython-Eggs)Zappname)r�rPr�rZuser_cache_dirrrrrrds
�cCst�dd|�S)z�Convert an arbitrary string to a standard distribution name

    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
    �[^A-Za-z0-9.]+�-)�re�subr�rrrrq%scCsJzttj�|��WStjjk
rD|�dd�}t�dd|�YSXdS)zB
    Convert an arbitrary string to a standard version string
    r�rBrarbN)r�rrrr r�rcrd)rrrrrr-s
cCst�dd|���S)z�Convert an arbitrary string to a standard 'extra' name

    Any runs of non-alphanumeric characters are replaced with a single '_',
    and the result is always lowercased.
    z[^A-Za-z0-9.-]+r�)rcrdr.)r!rrrrw9scCs|�dd�S)z|Convert a project or version name to its filename-escaped form

    Any '-' characters are currently replaced with '_'.
    rbr�rr�rrrrxBsc
CsHzt|�Wn6tk
rB}zd|_d|_|WY�Sd}~XYnXdS)zo
    Validate text as a PEP 508 environment marker; return an exception
    if invalid or False otherwise.
    NF)rz�SyntaxErrorr\�lineno)�text�errrryJsc
CsJztj�|�}|��WStjjk
rD}zt|��W5d}~XYnXdS)z�
    Evaluate a PEP 508 environment marker.
    Return a boolean indicating the marker result in this environment.
    Raise SyntaxError if marker is invalid.

    This implementation uses the 'pyparsing' module.
    N)rZmarkersZMarkerr$Z
InvalidMarkerre)rgr!r#rhrrrrzXs

c@s�eZdZdZdZdZdZdd�Zdd�Zdd�Z	d	d
�Z
dd�Zd
d�Zdd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zed'd(��Zd)d*�ZdS)+r�zETry to implement resources and metadata for arbitrary PEP 302 loadersNcCs(t|dd�|_tj�t|dd��|_dS)Nr��__file__r�)r�r�r�r��dirname�module_path�r�r�rrrr�nszNullProvider.__init__cCs|�|j|�Sr)�_fnrk�r�r�r�rrrr�rsz"NullProvider.get_resource_filenamecCst�|�||��Sr)�io�BytesIOr�rnrrrr�usz NullProvider.get_resource_streamcCs|�|�|j|��Sr)�_getrmrkrnrrrr�xsz NullProvider.get_resource_stringcCs|�|�|j|��Sr)�_hasrmrk�r�r�rrrr�{szNullProvider.has_resourcecCs|�|j|�Sr)rm�egg_info�r�r�rrr�_get_metadata_path~szNullProvider._get_metadata_pathcCs |js|jS|�|�}|�|�Sr)rtrvrr�r�r�r�rrrr��s
zNullProvider.has_metadatac
Cst|js
dS|�|�}|�|�}tjr(|Sz|�d�WStk
rn}z|jd�||�7_�W5d}~XYnXdS)Nr��utf-8z in {} file at path: {})	rtrvrqr�PY2�decode�UnicodeDecodeError�reasonr�)r�r�r��value�excrrrr��s

zNullProvider.get_metadatacCst|�|��Sr�rur�rurrrr��szNullProvider.get_metadata_linescCs|�|�|j|��Sr)�_isdirrmrkrsrrrr]�szNullProvider.resource_isdircCs|jo|�|�|j|��Sr)rtr�rmrurrrr��szNullProvider.metadata_isdircCs|�|�|j|��Sr)�_listdirrmrkrsrrrr[�szNullProvider.resource_listdircCs|jr|�|�|j|��SgSr)rtr�rmrurrrr��szNullProvider.metadata_listdirc
Cs�d|}|�|�s$tdjft����|�|��dd�}|�dd�}|�|j|�}||d<tj	�
|�r�t|���}t
||d�}t|||�n>dd	lm}t|�d|�d�|f||<t
||d�}	t|	||�dS)
Nzscripts/z<Script {script!r} not found in metadata at {self.egg_info!r}z
�
�
ri�execr)�cache)r�rkr�r�r�r�rmrtr�r�r�r�read�compiler��	linecacher��lenr)
r�r�r�ZscriptZscript_textZscript_filename�source�coder�Zscript_coderrrrQ�s.
���zNullProvider.run_scriptcCstd��dS�Nz9Can't perform this operation for unregistered loader type��NotImplementedErrorr^rrrrr�s�zNullProvider._hascCstd��dSr�r�r^rrrr��s�zNullProvider._isdircCstd��dSr�r�r^rrrr��s�zNullProvider._listdircCs*|�|�|r&tjj|f|�d���S|S)N�/)�_validate_resource_pathr�r�rIr)r��baser�rrrrm�s
zNullProvider._fncCsptjj|�tj�kp&t�|�p&t�|�}|s0dSd}t�|�rPt�|�sPt|��t	j
|dd�dtdd�dS)aO
        Validate the resource paths according to the docs.
        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access

        >>> warned = getfixture('recwarn')
        >>> warnings.simplefilter('always')
        >>> vrp = NullProvider._validate_resource_path
        >>> vrp('foo/bar.txt')
        >>> bool(warned)
        False
        >>> vrp('../foo/bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('/foo/bar.txt')
        >>> bool(warned)
        True
        >>> vrp('foo/../../bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('foo/f../bar.txt')
        >>> bool(warned)
        False

        Windows path separators are straight-up disallowed.
        >>> vrp(r'\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        >>> vrp(r'C:\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path is not allowed.

        Blank values are allowed

        >>> vrp('')
        >>> bool(warned)
        False

        Non-string values are not.

        >>> vrp(None)
        Traceback (most recent call last):
        ...
        AttributeError: ...
        Nz=Use of .. or absolute path in a resource path is not allowed.r�z/ and will raise exceptions in a future release.r��
stacklevel)r�r��pardirr�	posixpath�sep�isabs�ntpathrLrUrV�DeprecationWarning)r�ZinvalidrYrrrr��s6���z$NullProvider._validate_resource_pathcCs$t|jd�r|j�|�Std��dS)N�get_dataz=Can't perform this operation for loaders without 'get_data()')r�r�r�r�r^rrrrqs
�zNullProvider._get)rrrr�egg_namertr�r�r�r�r�r�rvr�r�r�r]r�r[r�rQrrr�r�rmr`r�rqrrrrr�gs2
Jc@s eZdZdZdd�Zdd�ZdS)r�z&Provider based on a virtual filesystemcCst�||�|��dSr)r�r��
_setup_prefixrlrrrr�-szEggProvider.__init__cCsZ|j}d}||krVt|�r@tj�|�|_tj�|d�|_||_qV|}tj�	|�\}}q
dS)N�EGG-INFO)
rk�_is_egg_pathr�r��basenamer�rIrt�egg_rootr)r�r��oldr�rrrr�1szEggProvider._setup_prefixN)rrrrr�r�rrrrr�*sc@sDeZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Ze	dd
��Z
dS)r�z6Provides access to package resources in the filesystemcCstj�|�Sr)r�r�r�r^rrrrrCszDefaultProvider._hascCstj�|�Sr)r�r�r
r^rrrr�FszDefaultProvider._isdircCs
t�|�Sr)r��listdirr^rrrr�IszDefaultProvider._listdircCst|�|j|�d�S�N�rb)rrmrkrnrrrr�Lsz#DefaultProvider.get_resource_streamc
Cs*t|d��}|��W5QR�SQRXdSr�)rr�)r�r��streamrrrrqOszDefaultProvider._getcCs,d}|D]}tt|td��}t||�qdS)N)�SourceFileLoader�SourcelessFileLoader)r��importlib_machinery�typer�)r�Zloader_namesr�Z
loader_clsrrr�	_registerSszDefaultProvider._registerN)rrrrrrr�r�r�rqr r�rrrrr�@sc@s8eZdZdZdZdd�ZZdd�Zdd�Zd	d
�Z	dS)r�z.Provider that returns nothing for all requestsNcCsdS�NFrr^rrrr?cr@zEmptyProvider.<lambda>cCsdS�Nr�rr^rrrrqeszEmptyProvider._getcCsgSrrr^rrrr�hszEmptyProvider._listdircCsdSrrr�rrrr�kszEmptyProvider.__init__)
rrrrrkr�rrrqr�r�rrrrr�^sc@s eZdZdZedd��ZeZdS)�ZipManifestsz
    zip manifest builder
    c
s@t�|��,��fdd����D�}t|�W5QR�SQRXdS)a
        Build a dictionary similar to the zipimport directory
        caches, except instead of tuples, store ZipInfo objects.

        Use a platform-specific path separator (os.sep) for the path keys
        for compatibility with pypy on Windows.
        c3s&|]}|�dtj���|�fVqdS)r�N)r�r�r�Zgetinfo�r�r��Zzfilerrr��s��z%ZipManifests.build.<locals>.<genexpr>N)�zipfileZZipFileZnamelistr')r�r�r+rr�r�buildws
	
�zZipManifests.buildN)rrrrr r��loadrrrrr�rs
r�c@s$eZdZdZe�dd�Zdd�ZdS)�MemoizedZipManifestsz%
    Memoized zipfile manifests.
    �manifest_modzmanifest mtimecCsRtj�|�}t�|�j}||ks.||j|krH|�|�}|�||�||<||jS)zW
        Load a manifest at path or return a suitable manifest already loaded.
        )	r�r��normpathrQ�st_mtime�mtimer�r��manifest)r�r�r�r�rrrr��s
zMemoizedZipManifests.loadN)rrrrr�
namedtupler�r�rrrrr��sr�c@s�eZdZdZdZe�Zdd�Zdd�Zdd�Z	e
d	d
��Zdd�Ze
d
d��Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd�Zdd �ZdS)!r�z"Resource support for zips and eggsNcCs t�||�|jjtj|_dSr)r�r�r��archiver�r��zip_prerlrrrr��szZipProvider.__init__cCsP|�tj�}||jjkrdS|�|j�r:|t|j�d�Std||jf��dS)Nr��%s is not a subpath of %s)	�rstripr�r�r�r�r�r�r��AssertionError�r��fspathrrr�
_zipinfo_name�s�zZipProvider._zipinfo_namecCsP|j|}|�|jtj�r:|t|j�dd��tj�Std||jf��dS)Nrr�)r�r�r�r�r�r�rr�)r��zip_pathr�rrr�_parts�s
�zZipProvider._partscCs|j�|jj�Sr)�_zip_manifestsr�r�r�r�rrr�zipinfo�szZipProvider.zipinfocCs\|jstd��|�|�}|��}d�|�|��|krP|D]}|�||�|��q8|�||�S)Nz5resource_filename() only supported for .egg, not .zipr�)r�r��_resource_to_zip�_get_eager_resourcesrIr��_extract_resource�
_eager_to_zip)r�r�r�r��eagersr�rrrr��s�
z!ZipProvider.get_resource_filenamecCs"|j}|jd}t�|�}||fS)N)rrr�)�	file_size�	date_time�time�mktime)Zzip_stat�sizer��	timestamprrr�_get_date_and_size�s

zZipProvider._get_date_and_sizec
Csx||��kr@|��|D]}|�|tj�||��}qtj�|�S|�|j|�\}}ts`t	d��z�|�
|j|�|��}|�
||�r�|WStdtj�|�d�\}}	t�||j�|��t�|�t|	||f�|�|	|�zt|	|�Wnhtjk
�rNtj�|��rH|�
||��r |YWStjdk�rHt|�t|	|�|YWS�YnXWn tjk
�rr|��YnX|S)Nz>"os.rename" and "os.unlink" are not supported on this platformz	.$extract)�dirrO)�_indexr�r�r�rIrjr�r��
WRITE_SUPPORT�IOErrorrNr�r��_is_current�_mkstemp�writer�r��closerr]r
�error�isfiler�rrI)
r�r�r�r�Zlastr�r�Z	real_pathZoutfZtmpnamrrrr��sN��
�




zZipProvider._extract_resourcec		Csx|�|j|�\}}tj�|�s$dSt�|�}|j|ksB|j|krFdS|j�	|�}t
|d��}|��}W5QRX||kS)zK
        Return True if the file_path is current for this zip_path
        Fr�)r�r�r�r�r�rQ�st_sizer�r�r�rr�)	r�Z	file_pathr�r�r�rQZzip_contents�fZ
file_contentsrrrr�s
zZipProvider._is_currentcCs>|jdkr8g}dD]}|�|�r|�|�|��q||_|jS)N)znative_libs.txtzeager_resources.txt)r�r�rr�)r�r�r�rrrr�"s

z ZipProvider._get_eager_resourcesc	Cs�z|jWStk
r�i}|jD]V}|�tj�}|r"tj�|dd��}||krh||�|d�q"q2|��g||<q2q"||_|YSXdS)Nr�)	Z	_dirindex�AttributeErrorr�rr�r�rIr�r)r�Zindr��parts�parentrrrr�+s
zZipProvider._indexcCs |�|�}||jkp||��kSr)r�r�r�)r�r�r�rrrrr<s
zZipProvider._hascCs|�|�|��kSr)r�r�r�rrrr�@szZipProvider._isdircCst|���|�|�d��S�Nr)rr�r�r�r�rrrr�CszZipProvider._listdircCs|�|�|j|��Sr)r�rmr�rsrrrr�FszZipProvider._eager_to_zipcCs|�|�|j|��Sr)r�rmrkrsrrrr�IszZipProvider._resource_to_zip)rrrrr�r�r�r�r�r�r�r�r�r`r�r�r�r�r�rrr�r�r�r�rrrrr��s(



7	c@s@eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dS)r�a*Metadata handler for standalone PKG-INFO files

    Usage::

        metadata = FileMetadata("/path/to/PKG-INFO")

    This provider rejects all data and metadata requests except for PKG-INFO,
    which is treated as existing, and will be the contents of the file at
    the provided location.
    cCs
||_dSr�r�r^rrrr�\szFileMetadata.__init__cCs|jSrr�rurrrrv_szFileMetadata._get_metadata_pathcCs|dkotj�|j�S)N�PKG-INFO)r�r�r�rurrrr�bszFileMetadata.has_metadatac	CsD|dkrtd��tj|jddd��}|��}W5QRX|�|�|S)Nr�z(No metadata except PKG-INFO is availablerxr�)�encoding�errors)r�rorr�r��_warn_on_replacement)r�r�r��metadatarrrr�es
zFileMetadata.get_metadatacCs2d�d�}||kr.d}|jft��}t�|�dS)Ns�rxz2{self.path} could not be properly decoded in UTF-8)rzr�r�rUrV)r�r�Zreplacement_charrGrYrrrr�ns

z!FileMetadata._warn_on_replacementcCst|�|��Srrrurrrr�vszFileMetadata.get_metadata_linesN)
rrrrr�rvr�r�r�r�rrrrr�Ps	c@seZdZdZdd�ZdS)r�asMetadata provider for egg directories

    Usage::

        # Development eggs:

        egg_info = "/path/to/PackageName.egg-info"
        base_dir = os.path.dirname(egg_info)
        metadata = PathMetadata(base_dir, egg_info)
        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)

        # Unpacked egg directories:

        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
        dist = Distribution.from_filename(egg_path, metadata=metadata)
    cCs||_||_dSr)rkrt)r�r�rtrrrr��szPathMetadata.__init__N�rrrrr�rrrrr�zsc@seZdZdZdd�ZdS)r�z Metadata provider for .egg filescCsD|jtj|_||_|jr0tj�|j|j�|_n|j|_|�	�dS)z-Create a metadata provider from a zipimporterN)
r�r�r�r�r��prefixr�rIrkr�)r��importerrrrr��szEggMetadata.__init__Nr�rrrrr��sr'��_distribution_finderscCs|t|<dS)axRegister `distribution_finder` to find distributions in sys.path items

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `distribution_finder` is a callable that, passed a path
    item and the importer instance, yields ``Distribution`` instances found on
    that path item.  See ``pkg_resources.find_on_path`` for an example.Nr�)�
importer_typeZdistribution_finderrrrr��scCst|�}tt|�}||||�S)z.Yield distributions accessible via `path_item`)rr�r�)�	path_item�onlyr��finderrrrra�s
c	cs�|j�d�rdSt|�}|�d�r2tj||d�V|r:dS|�d�D]|}t|�r�tj	�
||�}tt�
|�|�}|D]
}|VqrqD|���d�rDtj	�
||�}tt�
|��}||_t�|||�VqDdS)z@
    Find eggs in zip files; possibly multiple nested eggs.
    z.whlNr��r�r��
.dist-info)r��endswithr�r�rh�
from_filenamer[r�r�r�rI�find_eggs_in_zip�	zipimport�zipimporterr.rt�
from_location)	r�r�r�r�Zsubitem�subpathr�r�Zsubmetarrrr��s$

r�cCsdSr�r)r�r�r�rrr�find_nothing�sr�cCsdd�}t||dd�S)aL
    Given a list of filenames, return them in descending order
    by version number.

    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
    >>> _by_version_descending(names)
    ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg']
    cSs2tj�|�\}}t�|�d�|g�}dd�|D�S)z6
        Parse each component of the filename
        rbcSsg|]}tj�|��qSr)rrr�)r��partrrr�
<listcomp>�sz?_by_version_descending.<locals>._by_version.<locals>.<listcomp>)r�r��splitext�	itertools�chainr)r��extr�rrr�_by_version�sz+_by_version_descending.<locals>._by_versionTr1)�sorted)rMrrrr�_by_version_descending�src
#s�t���t��r4tj�t�tj��d��d�VdSt��}��fdd�|D�}t	|�}|D]2}tj��|�}t
�|��}||�D]
}	|	Vq�q\dS)z6Yield distributions accessible on a sys.path directoryr�r�Nc3s|]}t�|��r|VqdSr)�dist_factory)r�r��r�r�rrr�s�zfind_on_path.<locals>.<genexpr>)�_normalize_cached�_is_unpacked_eggrhr�r�r�r�rI�safe_listdirrr)
r�r�r�r�ZfilteredZpath_item_entriesr��fullpath�factoryr�rrr�find_on_path�s(���rcCsH|��}tt|jd��}|r tS|s0t|�r0tS|sB|�d�rBtSt�S)z9
    Return a dist_factory for a path_item and entry
    )�	.egg-infor�z	.egg-link)	r.r&rr��distributions_from_metadatar�ra�resolve_egg_link�NoDists)r�r�r�r.Zis_metarrrrs������rc@s*eZdZdZdd�ZejreZdd�ZdS)rzS
    >>> bool(NoDists())
    False

    >>> list(NoDists()('anything'))
    []
    cCsdSr�rr�rrr�__bool__.szNoDists.__bool__cCstd�Sr�)�iter)r�r	rrr�__call__3szNoDists.__call__N)	rrrrrrryZ__nonzero__rrrrrr&s
rc
Csvzt�|�WSttfk
r$YnNtk
rp}z0|jtjtjtjfkpXt	|dd�dk}|s`�W5d}~XYnXdS)zI
    Attempt to list contents of path, but suppress some exceptions.
    ZwinerrorNir)
r�r��PermissionError�NotADirectoryError�OSError�errnoZENOTDIRZEACCESZENOENTr�)r�rhZ	ignorablerrrr7s�rccsftj�|�}tj�|�r:tt�|��dkr.dSt||�}nt|�}tj�|�}t	j
|||td�VdS)Nr)�
precedence)r�r�rjr
r�r�r�r�r�rhr�r�)r��rootr�r�rrrr
Ls�r
c	cs4t|��"}|D]}|��}|r|VqW5QRXdS)z1
    Yield non-empty lines from file at path
    N)r�strip)r�r��linerrr�non_empty_lines[s

rcs.t��}�fdd�|D�}tt|�}t|d�S)za
    Given a path to an .egg-link, resolve distributions
    present in the referenced path.
    c3s$|]}tj�tj���|�VqdSr)r�r�rIrj)r��refr�rrr�ls�z#resolve_egg_link.<locals>.<genexpr>r)rrra�next)r�Zreferenced_pathsZresolved_pathsZdist_groupsrr�rrfs
�
r�
FileFinder��_namespace_handlers)�_namespace_packagescCs|t|<dS)a�Register `namespace_handler` to declare namespace packages

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `namespace_handler` is a callable like this::

        def namespace_handler(importer, path_entry, moduleName, module):
            # return a path_entry to use for child packages

    Namespace handlers are only called if the importer object has already
    agreed that it can handle the relevant path item, and they should only
    return a subpath if the module __path__ does not already contain an
    equivalent subpath.  For an example namespace handler, see
    ``pkg_resources.file_ns_handler``.
    Nr)r�Znamespace_handlerrrrr�}sc	Cs�t|�}|dkrdSt���t�d�|�|�}W5QRX|dkrHdStj�|�}|dkr�t�	|�}tj|<g|_
t|�nt|d�s�t
d|��tt|�}|||||�}|dk	r�|j
}|�|�|�|�t|||�|S)zEEnsure that named package includes a subpath of path_item (if needed)N�ignore�__path__�Not a package:)rrU�catch_warnings�simplefilter�find_modulerGr�r��types�
ModuleTyper#�_set_parent_nsr�r�r�r r��load_module�_rebuild_mod_path)�packageNamer�r�r�r�Zhandlerr�r�rrr�
_handle_ns�s.







r.csjdd�tjD���fdd����fdd�}t||d�}dd�|D�}t|jt�r`||jd	d	�<n||_d	S)
zq
    Rebuild module.__path__ ensuring that all entries are ordered
    corresponding to their sys.path order
    cSsg|]}t|��qSr�r�r��prrrr��sz%_rebuild_mod_path.<locals>.<listcomp>cs.z��|�WStk
r(td�YSXdS)z/
        Workaround for #520 and #513.
        �infN)�indexrL�float)r�)�sys_pathrr�safe_sys_path_index�sz._rebuild_mod_path.<locals>.safe_sys_path_indexcs<|�tj�}��d�d}|d|�}�ttj�|���S)zR
        Return the ordinal of the path based on its position in sys.path
        rBrN)rr�r��countrrI)r��
path_partsZmodule_partsr�)�package_namer6rr�position_in_sys_path�sz/_rebuild_mod_path.<locals>.position_in_sys_path)r8cSsg|]}t|��qSrr/r0rrrr��sN)rGr�rr�r#r)�	orig_pathr9r�r:�new_pathr)r9r6r5rr,�s		r,cCs�t��z�|tkrW��dStj}|�d�\}}}|r|t|�|tkrLt|�ztj	|j
}Wntk
rztd|��YnXt�
|p�dg��|�t�
|g�|D]}t||�q�W5t��XdS)z9Declare that package 'packageName' is a namespace packageNrBr$)�_imp�acquire_lock�release_lockr!rGr��
rpartitionr^r�r�r#r�r�r�r�r.)r-r�r�r�r�rrrr^�s&cCsFt��z.t�|d�D]}t||�}|rt||�qW5t��XdS)zDEnsure that previously-declared namespace packages include path_itemrN)r=r>r?r!r�r.r�)r�r��packager�rrrr��s
cCsDtj�||�d�d�}t|�}|jD]}t|�|kr&q@q&|SdS)zBCompute an ns-package subpath for a filesystem or zipfile importerrBr�N)r�r�rIrrr#)r�r�r-r�r�Z
normalizedrrrr�file_ns_handler�s
rBcCsdSrr)r�r�r-r�rrr�null_ns_handler	srCcCs tj�tj�tj�t|����S)z1Normalize a file/dir name for comparison purposes)r�r��normcase�realpathr��
_cygwin_patch�r\rrrr|	scCstjdkrtj�|�S|S)a
    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
    symlink components. Using
    os.path.abspath() works around this limitation. A fix in os.getcwd()
    would probably better, in Cygwin even more so, except
    that this seems to be by design...
    �cygwin)rGrHr�r��abspathrGrrrrF	srFcCs8z
||WStk
r2t|�||<}|YSXdSr)r�r|)r\r��resultrrrr)	s

rcCs|���d�S)z7
    Determine if given path appears to be an egg.
    �.egg)r.r�r�rrrr�1	sr�cCs t|�otj�tj�|dd��S)z@
    Determine if given path appears to be an unpacked egg.
    r�r�)r�r�r�r�rIr�rrrr8	s�rcCs<|�d�}|��}|r8d�|�}ttj||tj|�dS)NrB)rrrI�setattrrGr�)r-r�r�r�rrrr*B	s


r*ccsZt|tj�r8|��D] }|��}|r|�d�s|Vqn|D]}t|�D]
}|VqHq<dS)z9Yield non-empty/non-comment lines of a string or sequence�#N)r�rr��
splitlinesrr�ru)�strs�sZssrrrruJ	s
z\w+(\.\w+)*$z�
    (?P<name>[^-]+) (
        -(?P<ver>[^-]+) (
            -py(?P<pyver>[^-]+) (
                -(?P<plat>.+)
            )?
        )?
    )?
    c@s�eZdZdZddd�Zdd�Zdd	�Zddd�Zd
d�Zddd�Z	e
�d�Ze
ddd��Ze
dd��Ze
ddd��Ze
ddd��ZdS) rjz3Object representing an advertised importable objectrNcCs<t|�std|��||_||_t|�|_t|�|_||_dS)NzInvalid module name)�MODULErLr��module_name�tuple�attrsrr�)r�r�rRrTrr�rrrr�j	s


zEntryPoint.__init__cCsHd|j|jf}|jr*|dd�|j�7}|jrD|dd�|j�7}|S)Nz%s = %s�:rBz [%s]�,)r�rRrTrIr)r�rPrrrr�s	szEntryPoint.__str__cCsdt|�S)NzEntryPoint.parse(%r)�r�r�rrrr�{	szEntryPoint.__repr__TcOs4|r|s|rtjdtdd�|r,|j||�|��S)zH
        Require packages for this EntryPoint, then resolve it.
        zJParameters to load are deprecated.  Call .resolve and .require separately.rCr�)rUrVr�rPr�)r�rPr>�kwargsrrrr�~	s�zEntryPoint.loadc
CsXt|jdgdd�}zt�t|j|�WStk
rR}ztt|���W5d}~XYnXdS)zD
        Resolve the entry point from its module and attrs.
        rr)�fromlist�levelN)	r�rR�	functools�reducer�rTr�r�r�)r�r�r~rrrr��	s
zEntryPoint.resolvecCsL|jr|jstd|��|j�|j�}tj||||jd�}tttj|��dS)Nz&Can't require() without a distribution)r)	rr�rnrr_r�rrr�)r�rrr�r+rrrrP�	s

zEntryPoint.requirez]\s*(?P<name>.+?)\s*=\s*(?P<module>[\w.]+)\s*(:\s*(?P<attr>[\w.]+))?\s*(?P<extras>\[.*\])?\s*$cCsf|j�|�}|sd}t||��|��}|�|d�}|drJ|d�d�nd}||d|d|||�S)aParse a single entry point from string `src`

        Entry point syntax follows the form::

            name = some.module:some.attr [extra1, extra2]

        The entry name and module name are required, but the ``:attrs`` and
        ``[extras]`` parts are optional
        z9EntryPoint must be in 'name=module:attrs [extras]' formatr�attrrBrr�r�)�patternrFrL�	groupdict�
_parse_extrasr)r��srcr�rNrY�resrrTrrrr��	s
zEntryPoint.parsecCs(|sdSt�d|�}|jr"t��|jS)Nr�x)rir��specsrLr)r�Zextras_specr�rrrr`�	szEntryPoint._parse_extrascCsVt|�std|��i}t|�D]2}|�||�}|j|krFtd||j��|||j<q|S)zParse an entry point groupzInvalid group namezDuplicate entry point)rQrLrur�r�)r�rK�linesr��thisr�eprrr�parse_group�	s

zEntryPoint.parse_groupcCstt|t�r|��}nt|�}i}|D]J\}}|dkrB|s:q$td��|��}||kr\td|��|�|||�||<q$|S)z!Parse a map of entry point groupsNz%Entry points must be listed in groupszDuplicate group name)r�r'r+rvrLrrh)r��datar��mapsrKrerrr�	parse_map�	s


zEntryPoint.parse_map)rrN)T)NN)N)N)N)rrrrr�r�r�r�r�rPrcr�r^r r�r`rhrkrrrrrjg	s$
	



�	
cCs>|sdStj�|�}|d�d�r:tj�|dd�d�S|S)Nr�r�zmd5=)r�)rr�Zurlparser�Z
urlunparse)rZparsedrrr�_remove_md5_fragment�	srlcCs@dd�}t||�}tt|�d�}|�d�\}}}t|���p>dS)z�
    Given an iterable of lines from a Metadata file, return
    the value of the Version field, if present, or None otherwise.
    cSs|���d�S)Nzversion:)r.r�)rrrr�is_version_line�	sz+_version_from_file.<locals>.is_version_liner�rUN)rrr�	partitionrrr)rermZ
version_linesrr�r}rrr�_version_from_file�	s

rocs�eZdZdZdZddddedefdd�ZedSdd��Z	dd	�Z
ed
d��Zdd
�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zedd��Zedd��Zdd�Zed d!��Zed"d#��Zed$d%��Zd&d'�ZdTd)d*�Zd+d,�Zd-d.�Zd/d0�ZdUd2d3�Z d4d5�Z!d6d7�Z"d8d9�Z#d:d;�Z$�fd<d=�Z%e&e'd>��s4[%edVd?d@��Z(dAdB�Z)dCdD�Z*dWdEdF�Z+dGdH�Z,dXdIdJ�Z-dKdL�Z.dMdN�Z/dOdP�Z0edQdR��Z1�Z2S)Yrhz5Wrap an actual or potential sys.path entry w/metadatar�NcCsFt|pd�|_|dk	r t|�|_||_||_||_||_|p>t|_	dS)NZUnknown)
rqrrr�_versionr+rHrrr��	_provider)r�rr�rrr+rHrrrrr�
s
zDistribution.__init__cKs~dgd\}}}}tj�|�\}}	|	��tkr^t|	��}t|�}
|
r^|
�dddd�\}}}}|||f||||d�|����S)Nrr�ZverZpyverrM)rrr+rH)r�r�r�r.�_distributionImpl�EGG_NAMErK�_reload_version)r�rr�r�r)rrr+rHrrFrrrr�
s.����zDistribution.from_locationcCs|Srrr�rrrrt#
szDistribution._reload_versioncCs(|j|j|jt|j�|jpd|jp$dfSr�)�parsed_versionrr8rlrr+rHr�rrrr0&
s�zDistribution.hashcmpcCs
t|j�Sr)�hashr0r�rrr�__hash__1
szDistribution.__hash__cCs|j|jkSr�r0�r�r8rrr�__lt__4
szDistribution.__lt__cCs|j|jkSrrxryrrr�__le__7
szDistribution.__le__cCs|j|jkSrrxryrrr�__gt__:
szDistribution.__gt__cCs|j|jkSrrxryrrr�__ge__=
szDistribution.__ge__cCst||j�sdS|j|jkSr�)r�r�r0ryrrr�__eq__@
szDistribution.__eq__cCs
||kSrrryrrr�__ne__F
szDistribution.__ne__cCs6z|jWStk
r0|j��|_}|YSXdSr)Z_keyr�rr.r7rrrr8M
s
zDistribution.keycCst|d�st|j�|_|jS)N�_parsed_version)r�r#rr�r�rrrruU
s
zDistribution.parsed_versioncCsXtjj}t|j|�}|sdS|js&dSt�d����dd�}t	�
|jft|��t
�dS)Na>
            '{project_name} ({version})' is being parsed as a legacy,
            non PEP 440,
            version. You may find odd behavior and sort order.
            In particular it will be sorted as less than 0.0. It
            is recommended to migrate to PEP 440 compatible
            versions.
            r�r�)rrr!r�r�rBrCrr�rUrVr��varsr)r�ZLVZ	is_legacyrGrrr�_warn_legacy_version\
s�	z!Distribution._warn_legacy_versioncCsZz|jWStk
rT|��}|dkrL|�|j�}d�|j|�}t||��|YSXdS)Nz4Missing 'Version:' header and/or {} file at path: {})rpr��_get_version�_get_metadata_path_for_display�PKG_INFOr�rL)r�rr�rYrrrrv
s��
zDistribution.versioncCs4z|jWStk
r,|�|���|_YnX|jS)z~
        A map of extra to its list of (direct) requirements
        for this distribution, including the null extra.
        )Z_Distribution__dep_mapr��_filter_extras�_build_dep_mapr�rrr�_dep_map�
s
zDistribution._dep_mapcCsrttd|��D]^}|}|�|�}|�d�\}}}|oDt|�pDt|�}|rNg}t|�pXd}|�|g��|�q|S)z�
        Given a mapping of extras to dependencies, strip off
        environment markers and filter out any dependencies
        not matching the markers.
        NrU)	rrrrnryrzrwr�r)�dmr!Z	new_extrar�r�r#Zfails_markerrrrr��
s
�zDistribution._filter_extrascCs@i}dD]2}t|�|��D]\}}|�|g��t|��qq|S)N)zrequires.txtzdepends.txt)rv�
_get_metadatar�rrp)r�r�r�r!r�rrrr��
s
zDistribution._build_dep_maprc	Csf|j}g}|�|�dd��|D]@}z|�|t|��Wq tk
r^td||f��Yq Xq |S)z@List of Requirements needed for this distro if `extras` are usedNrz%s has no such extra feature %r)r�rr�rwr�rn)r�rr�Zdepsrrrrr�
s
�zDistribution.requirescCs,z|j�|�}Wntk
r&YdSX|S)zK
        Return the path to the given metadata file, if available.
        z[could not detect])rqrvrKrwrrrr��
s
z+Distribution._get_metadata_path_for_displayccs$|�|�r |�|�D]
}|VqdSr)r�r�)r�r�rrrrr��
s
zDistribution._get_metadatacCs|�|j�}t|�}|Sr)r�r�ro)r�rerrrrr��
szDistribution._get_versionFcCsV|dkrtj}|j||d�|tjkrRt|j�|�d�D]}|tjkr:t|�q:dS)z>Ensure distribution is importable on `path` (default=sys.path)Nr�namespace_packages.txt)rGr�rr�rr�r�r^)r�r�r�Zpkgrrr�activate�
s


zDistribution.activatecCs8dt|j�t|j�|jptf}|jr4|d|j7}|S)z@Return what this distribution's standard .egg filename should bez
%s-%s-py%srb)rxrrr+r=rH)r�r\rrrr��
s�zDistribution.egg_namecCs |jrd||jfSt|�SdS)Nz%s (%s))rr�r�rrrr��
szDistribution.__repr__cCs@zt|dd�}Wntk
r(d}YnX|p0d}d|j|fS)Nrz[unknown version]z%s %s)r�rLr)r�rrrrr��
s
zDistribution.__str__cCs|�d�rt|��t|j|�S)zADelegate all unrecognized public attributes to .metadata providerr�)r�r�r�rq)r�r]rrr�__getattr__�
s
zDistribution.__getattr__cs.tttt|����tdd�|j��D��B�S)Ncss|]}|�d�s|VqdS�r�N)r�)r�r]rrrr�s
�z'Distribution.__dir__.<locals>.<genexpr>)rr�superrh�__dir__rqr�r:rrr�s���zDistribution.__dir__r�cKs|jt|�tj�|�|f|�Sr)r�rr�r�r�)r�r\r�r)rrrr�s
��zDistribution.from_filenamecCs<t|jtjj�r"d|j|jf}nd|j|jf}t�|�S)z?Return a ``Requirement`` that matches this distribution exactlyz%s==%sz%s===%s)r�rurrrrrir�)r��specrrrrszDistribution.as_requirementcCs.|�||�}|dkr&td||ff��|��S)z=Return the `name` entry point of `group` or raise ImportErrorNzEntry point %r not found)rVr�r�)r�rKr�rgrrrrTszDistribution.load_entry_pointcCsPz
|j}Wn,tk
r6t�|�d�|�}|_YnX|dk	rL|�|i�S|S)r�zentry_points.txtN)Z_ep_mapr�rjrkr�r�)r�rKZep_maprrrrU&s
�zDistribution.get_entry_mapcCs|�|��|�Sr�)rUr�rrrrrV2szDistribution.get_entry_infoc
Cs4|p|j}|sdSt|�}tj�|�}dd�|D�}t|�D]|\}}||kr^|rVq�q�dSq<||kr<|jtkr<|s�|||d�kr�dS|tjkr�|�	�|�
||�|�
||�q�q<|tjkr�|�	�|r�|�
d|�n
|�|�dSz|�||d�}	Wnt
k
�rY�q0Yq�X||	=||	=|	}q�dS)a�Ensure self.location is on path

        If replace=False (default):
            - If location is already in path anywhere, do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent.
              - Else: add to the end of path.
        If replace=True:
            - If location is already on path anywhere (not eggs)
              or higher priority than its parent (eggs)
              do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent,
                removing any lower-priority entries.
              - Else: add it to the front of path.
        NcSsg|]}|rt|�p|�qSrr/r0rrrr�Psz*Distribution.insert_on.<locals>.<listcomp>rr)rrr�r�rj�	enumeraterr}rG�check_version_conflictr	r�r3rL)
r�r��locr�ZnlocZbdirZnpathr1rZnprrrr6s@



zDistribution.insert_oncCs�|jdkrdSt�|�d��}t|j�}|�d�D]p}|tjks2||ks2|tkrRq2|dkr\q2t	tj|dd�}|r�t|��
|�s2|�
|j�r�q2td|||jf�q2dS)N�
setuptoolsr�z
top_level.txt)Z
pkg_resourcesr�ZsiterizIModule %s was already imported from %s, but %s is being added to sys.path)r8r'r(r�r|rrGr�r!r�r��
issue_warning)r�Znspr��modname�fnrrrr�zs*

�
�
��z#Distribution.check_version_conflictcCs6z
|jWn&tk
r0tdt|��YdSXdS)NzUnbuilt egg for FT)rrLr�r�r�rrrr3�s
zDistribution.has_versioncKs@d}|��D]}|�|t||d��q|�d|j�|jf|�S)z@Copy this distribution, substituting in any changed keyword argsz<project_name version py_version platform location precedenceNr�)rr�r�rqr�)r�r)rMr]rrr�clone�s
zDistribution.clonecCsdd�|jD�S)NcSsg|]}|r|�qSrr)r�Zdeprrrr��sz'Distribution.extras.<locals>.<listcomp>)r�r�rrrr�szDistribution.extras)N)r)NF)N)N)NF)3rrrrr�r=r}r�r r�rtr�r0rwrzr{r|r}r~rr8rur�rr�r`r�r�rr�r�r�r�r�r�r�r�r�r��objectr�rrTrUrVrr�r3r�r�
__classcell__rrr:rrh
st�










		

Dc@seZdZdd�ZdS)�EggInfoDistributioncCs|��}|r||_|S)a�
        Packages installed by distutils (e.g. numpy or scipy),
        which uses an old safe_version, and so
        their version numbers can get mangled when
        converted to filenames (e.g., 1.11.0.dev0+2329eae to
        1.11.0.dev0_2329eae). These distributions will not be
        parsed properly
        downstream by Distribution and safe_version, so
        take an extra step and try to get the version number from
        the metadata file itself instead of the filename.
        )r�rp)r�Z
md_versionrrrrt�sz#EggInfoDistribution._reload_versionN)rrrrtrrrrr��sr�c@s>eZdZdZdZe�d�Zedd��Z	edd��Z
dd	�Zd
S)�DistInfoDistributionzV
    Wrap an actual or potential sys.path entry
    w/metadata, .dist-info style.
    ZMETADATAz([\(,])\s*(\d.*?)\s*([,\)])cCsFz|jWStk
r@|�|j�}tj���|�|_|jYSXdS)zParse and cache metadataN)Z	_pkg_infor�r�r��email�parserZParserZparsestr)r�r�rrr�_parsed_pkg_info�sz%DistInfoDistribution._parsed_pkg_infocCs2z|jWStk
r,|��|_|jYSXdSr)�_DistInfoDistribution__dep_mapr��_compute_dependenciesr�rrrr��s

zDistInfoDistribution._dep_mapcs�dgi}|_g�|j�d�p gD]}��t|��q"�fdd�}t|d��}|d�|�|j�d�pjgD](}t|���}tt||��|�||<ql|S)z+Recompute this distribution's dependencies.Nz
Requires-Distc3s*�D] }|jr|j�d|i�r|VqdS)Nr!r")r!r��r�rr�reqs_for_extra�szBDistInfoDistribution._compute_dependencies.<locals>.reqs_for_extrazProvides-Extra)	r�r�Zget_allrrp�	frozensetrwrr)r�r�r�r��commonr!Zs_extrarr�rr��sz*DistInfoDistribution._compute_dependenciesN)rrrrr�rcr�ZEQEQr�r�r�r�rrrrr��s

	
r�)rKrr�cOsZd}t�}zt�|�j|kr&|d7}qWntk
r<YnXtj|d|di|��dS)Nrr�)r$rGr�r�rLrUrV)r>r)rZr.rrrr��sr�c@seZdZdd�ZdS)�RequirementParseErrorcCsd�|j�S)Nr�)rIr>r�rrrr��szRequirementParseError.__str__N)rrrr�rrrrr��sr�c	cs�tt|��}|D]l}d|kr.|d|�d��}|�d�rr|dd���}z|t|�7}Wntk
rpYdSXt|�VqdS)z�Yield ``Requirement`` objects for each specification in `strs`

    `strs` must be a string, or a (possibly-nested) iterable thereof.
    z #N�\���)rrur�r�rr�
StopIterationri)rOrerrrrrps

csPeZdZ�fdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Ze	d
d��Z
�ZS)ric
s�ztt|��|�Wn2tjjk
rF}ztt|���W5d}~XYnX|j|_	t
|j�}||��|_|_
dd�|jD�|_ttt|j��|_|j
|j|jt|j�|jr�t|j�ndf|_t|j�|_dS)z>DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!NcSsg|]}|j|jf�qSr)r4r)r�r�rrrr�#sz(Requirement.__init__.<locals>.<listcomp>)r�rir�rrZInvalidRequirementr�r�r�Zunsafe_namerqr.rr8�	specifierrdrSrrwrZurlr�r#�hashCmprv�_Requirement__hash)r�Zrequirement_stringrhrr:rrr�s$
��zRequirement.__init__cCst|t�o|j|jkSr)r�rir�ryrrrr~/s

�zRequirement.__eq__cCs
||kSrrryrrrr5szRequirement.__ne__cCs0t|t�r |j|jkrdS|j}|jj|dd�S)NFT)Zprereleases)r�rhr8rr��contains)r�rrrrr�8s

zRequirement.__contains__cCs|jSr)r�r�rrrrwDszRequirement.__hash__cCsdt|�S)NzRequirement.parse(%r)rWr�rrrr�GszRequirement.__repr__cCst|�\}|Sr)rp)rPr�rrrr�Js
zRequirement.parse)rrrr�r~rr�rwr�r`r�r�rrr:rriscCst|kr|tfS|S)zJ
    Ensure object appears in the mro even
    for old-style classes.
    )r�)�classesrrr�_always_objectPs
r�cCs<tt�t|dt|����}|D]}||kr||SqdS)z2Return an adapter factory for `ob` from `registry`r�N)r��inspectZgetmror�r�)�registryr9r(�trrrr�Zsr�cCstj�|�}tj|dd�dS)z1Ensure that the parent directory of `path` existsT)�exist_okN)r�r�rjr�makedirs)r�rjrrrr{bscCsXtstd��t|�\}}|rT|rTt|�sTt|�zt|d�Wntk
rRYnXdS)z/Sandbox-bypassing version of ensure_directory()z*"os.mkdir" not supported on this platform.i�N)r�r�rr
rJr	�FileExistsError)r�rjr\rrrrJhsrJccsvd}g}t|�D]V}|�d�r\|�d�rP|s0|r:||fV|dd���}g}qftd|��q|�|�q||fVdS)asSplit a string or iterable thereof into (section, content) pairs

    Each ``section`` is a stripped version of the section header ("[section]")
    and each ``content`` is a list of stripped lines excluding blank lines and
    comment-only lines.  If there are any such lines before the first section
    header, they're returned in a first ``section`` of ``None``.
    N�[�]rr�zInvalid section heading)rur�r�rrLr�)rPZsectionZcontentrrrrrvus


cOs*tj}ztt_tj||�W�S|t_XdSr)r�r�os_open�tempfileZmkstemp)r>r)Zold_openrrrr��s
r�r")�categoryr�cOs|||�|Srr)r�r>rXrrr�_call_aside�s
r�cs.t���|d<|��fdd�t��D��dS)z=Set up global resource manager (deliberately not state-saved)Z_managerc3s&|]}|�d�s|t�|�fVqdSr�)r�r�r��r�rrr��s
�z_initialize.<locals>.<genexpr>N)rgr%r�)r.rr�r�_initialize�s
�r�cCs|t��}td|d�|j}|j}|j}|j}|}tdd�|D��|dd�dd�g|_t	t
|jtj
��t��t��d	S)
aE
    Prepare the master working set and make the ``require()``
    API available.

    This function has explicit effects on the global state
    of pkg_resources. It is intended to be invoked once at
    the initialization of this module.

    Invocation by other packages is unsupported and done
    at their own risk.
    r�)r_css|]}|jdd�VqdS)FrN�r�)r�r�rrrr��s�z1_initialize_master_working_set.<locals>.<genexpr>cSs|jdd�S)NTrr�r�rrrr?�r@z0_initialize_master_working_set.<locals>.<lambda>F)rN)rfr�r*rPrWrrQrSr�rrr�rGr�r$r%r�)r_rPrWr`rQr�rrr�_initialize_master_working_set�s"
��r�c@seZdZdZdS)r�z�
    Base class for warning about deprecations in ``pkg_resources``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    Nrrrrrr��s)N)N)F)F)F)F)N)�rZ
__future__rrGr�ror�rcr(r�r�rUrQr[Zpkgutilr4rHrr�Zemail.parserr�rr�rBr�r�r�r�rr=r�Zimpr��	NameErrorrZpkg_resources.externrZpkg_resources.extern.six.movesrrrrr	r
rr�rr�Zos.pathr
rZimportlib.machinery�	machineryr�rr�rrrr�r�Z
__metaclass__�version_info�RuntimeErrorryrrrPr_r`Zresources_streamrcZresource_dirrYrbr]rXrWr[rZr\r�r r!�RuntimeWarningrr#r&r*r0r1r5r:r;r<Z
_sget_noneZ
_sset_nonerO�__all__rKrkrlr�rmrnr�r�r=r}r~rr�r�r�rRrJr�rDr�rEr�rsrtrQr�rSrTrUrVr�r�rfr'r
rer�rorgrdrqrrrwrxryrzr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rar�r�rrrrrr
rrZImpImporterr�rr�r.r,r^r�rBrCr|rFrr�rr*rurFrQ�VERBOSE�
IGNORECASErsrjrlrorhr�r�rrr�rLr�rprrir�r�r{rJrvr��filterwarningsr�r$r�r��Warningr�rrrr�<module>sZ



�2 




.
5	A
-*

 ""


	
�	
'3�
7


&site-packages/pkg_resources/__init__.py000064400000323475151446177000014273 0ustar00# coding: utf-8
"""
Package resource API
--------------------

A resource is a logical file contained within a package, or a logical
subdirectory thereof.  The package resource API expects resource names
to have their path parts separated with ``/``, *not* whatever the local
path separator is.  Do not use os.path operations to manipulate resource
names being passed into the API.

The package resource API is designed to work with normal filesystem packages,
.egg files, and unpacked .egg files.  It can also work in a limited way with
.zip files and with custom PEP 302 loaders that support the ``get_data()``
method.
"""

from __future__ import absolute_import

import sys
import os
import io
import time
import re
import types
import zipfile
import zipimport
import warnings
import stat
import functools
import pkgutil
import operator
import platform
import collections
import plistlib
import email.parser
import errno
import tempfile
import textwrap
import itertools
import inspect
import ntpath
import posixpath
from pkgutil import get_importer

try:
    import _imp
except ImportError:
    # Python 3.2 compatibility
    import imp as _imp

try:
    FileExistsError
except NameError:
    FileExistsError = OSError

from pkg_resources.extern import six
from pkg_resources.extern.six.moves import urllib, map, filter

# capture these to bypass sandboxing
from os import utime
try:
    from os import mkdir, rename, unlink
    WRITE_SUPPORT = True
except ImportError:
    # no write support, probably under GAE
    WRITE_SUPPORT = False

from os import open as os_open
from os.path import isdir, split

try:
    import importlib.machinery as importlib_machinery
    # access attribute to force import under delayed import mechanisms.
    importlib_machinery.__name__
except ImportError:
    importlib_machinery = None

from . import py31compat
from pkg_resources.extern import appdirs
from pkg_resources.extern import packaging
__import__('pkg_resources.extern.packaging.version')
__import__('pkg_resources.extern.packaging.specifiers')
__import__('pkg_resources.extern.packaging.requirements')
__import__('pkg_resources.extern.packaging.markers')


__metaclass__ = type


if (3, 0) < sys.version_info < (3, 4):
    raise RuntimeError("Python 3.4 or later is required")

if six.PY2:
    # Those builtin exceptions are only defined in Python 3
    PermissionError = None
    NotADirectoryError = None

# declare some globals that will be defined later to
# satisfy the linters.
require = None
working_set = None
add_activation_listener = None
resources_stream = None
cleanup_resources = None
resource_dir = None
resource_stream = None
set_extraction_path = None
resource_isdir = None
resource_string = None
iter_entry_points = None
resource_listdir = None
resource_filename = None
resource_exists = None
_distribution_finders = None
_namespace_handlers = None
_namespace_packages = None


class PEP440Warning(RuntimeWarning):
    """
    Used when there is an issue with a version or specifier not complying with
    PEP 440.
    """


def parse_version(v):
    try:
        return packaging.version.Version(v)
    except packaging.version.InvalidVersion:
        return packaging.version.LegacyVersion(v)


_state_vars = {}


def _declare_state(vartype, **kw):
    globals().update(kw)
    _state_vars.update(dict.fromkeys(kw, vartype))


def __getstate__():
    state = {}
    g = globals()
    for k, v in _state_vars.items():
        state[k] = g['_sget_' + v](g[k])
    return state


def __setstate__(state):
    g = globals()
    for k, v in state.items():
        g['_sset_' + _state_vars[k]](k, g[k], v)
    return state


def _sget_dict(val):
    return val.copy()


def _sset_dict(key, ob, state):
    ob.clear()
    ob.update(state)


def _sget_object(val):
    return val.__getstate__()


def _sset_object(key, ob, state):
    ob.__setstate__(state)


_sget_none = _sset_none = lambda *args: None


def get_supported_platform():
    """Return this platform's maximum compatible version.

    distutils.util.get_platform() normally reports the minimum version
    of Mac OS X that would be required to *use* extensions produced by
    distutils.  But what we want when checking compatibility is to know the
    version of Mac OS X that we are *running*.  To allow usage of packages that
    explicitly require a newer version of Mac OS X, we must also know the
    current version of the OS.

    If this condition occurs for any other platform with a version in its
    platform strings, this function should be extended accordingly.
    """
    plat = get_build_platform()
    m = macosVersionString.match(plat)
    if m is not None and sys.platform == "darwin":
        try:
            plat = 'macosx-%s-%s' % ('.'.join(_macosx_vers()[:2]), m.group(3))
        except ValueError:
            # not Mac OS X
            pass
    return plat


__all__ = [
    # Basic resource access and distribution/entry point discovery
    'require', 'run_script', 'get_provider', 'get_distribution',
    'load_entry_point', 'get_entry_map', 'get_entry_info',
    'iter_entry_points',
    'resource_string', 'resource_stream', 'resource_filename',
    'resource_listdir', 'resource_exists', 'resource_isdir',

    # Environmental control
    'declare_namespace', 'working_set', 'add_activation_listener',
    'find_distributions', 'set_extraction_path', 'cleanup_resources',
    'get_default_cache',

    # Primary implementation classes
    'Environment', 'WorkingSet', 'ResourceManager',
    'Distribution', 'Requirement', 'EntryPoint',

    # Exceptions
    'ResolutionError', 'VersionConflict', 'DistributionNotFound',
    'UnknownExtra', 'ExtractionError',

    # Warnings
    'PEP440Warning',

    # Parsing functions and string utilities
    'parse_requirements', 'parse_version', 'safe_name', 'safe_version',
    'get_platform', 'compatible_platforms', 'yield_lines', 'split_sections',
    'safe_extra', 'to_filename', 'invalid_marker', 'evaluate_marker',

    # filesystem utilities
    'ensure_directory', 'normalize_path',

    # Distribution "precedence" constants
    'EGG_DIST', 'BINARY_DIST', 'SOURCE_DIST', 'CHECKOUT_DIST', 'DEVELOP_DIST',

    # "Provider" interfaces, implementations, and registration/lookup APIs
    'IMetadataProvider', 'IResourceProvider', 'FileMetadata',
    'PathMetadata', 'EggMetadata', 'EmptyProvider', 'empty_provider',
    'NullProvider', 'EggProvider', 'DefaultProvider', 'ZipProvider',
    'register_finder', 'register_namespace_handler', 'register_loader_type',
    'fixup_namespace_packages', 'get_importer',

    # Warnings
    'PkgResourcesDeprecationWarning',

    # Deprecated/backward compatibility only
    'run_main', 'AvailableDistributions',
]


class ResolutionError(Exception):
    """Abstract base for dependency resolution errors"""

    def __repr__(self):
        return self.__class__.__name__ + repr(self.args)


class VersionConflict(ResolutionError):
    """
    An already-installed version conflicts with the requested version.

    Should be initialized with the installed Distribution and the requested
    Requirement.
    """

    _template = "{self.dist} is installed but {self.req} is required"

    @property
    def dist(self):
        return self.args[0]

    @property
    def req(self):
        return self.args[1]

    def report(self):
        return self._template.format(**locals())

    def with_context(self, required_by):
        """
        If required_by is non-empty, return a version of self that is a
        ContextualVersionConflict.
        """
        if not required_by:
            return self
        args = self.args + (required_by,)
        return ContextualVersionConflict(*args)


class ContextualVersionConflict(VersionConflict):
    """
    A VersionConflict that accepts a third parameter, the set of the
    requirements that required the installed Distribution.
    """

    _template = VersionConflict._template + ' by {self.required_by}'

    @property
    def required_by(self):
        return self.args[2]


class DistributionNotFound(ResolutionError):
    """A requested distribution was not found"""

    _template = ("The '{self.req}' distribution was not found "
                 "and is required by {self.requirers_str}")

    @property
    def req(self):
        return self.args[0]

    @property
    def requirers(self):
        return self.args[1]

    @property
    def requirers_str(self):
        if not self.requirers:
            return 'the application'
        return ', '.join(self.requirers)

    def report(self):
        return self._template.format(**locals())

    def __str__(self):
        return self.report()


class UnknownExtra(ResolutionError):
    """Distribution doesn't have an "extra feature" of the given name"""


_provider_factories = {}

PY_MAJOR = '{}.{}'.format(*sys.version_info)
EGG_DIST = 3
BINARY_DIST = 2
SOURCE_DIST = 1
CHECKOUT_DIST = 0
DEVELOP_DIST = -1


def register_loader_type(loader_type, provider_factory):
    """Register `provider_factory` to make providers for `loader_type`

    `loader_type` is the type or class of a PEP 302 ``module.__loader__``,
    and `provider_factory` is a function that, passed a *module* object,
    returns an ``IResourceProvider`` for that module.
    """
    _provider_factories[loader_type] = provider_factory


def get_provider(moduleOrReq):
    """Return an IResourceProvider for the named module or requirement"""
    if isinstance(moduleOrReq, Requirement):
        return working_set.find(moduleOrReq) or require(str(moduleOrReq))[0]
    try:
        module = sys.modules[moduleOrReq]
    except KeyError:
        __import__(moduleOrReq)
        module = sys.modules[moduleOrReq]
    loader = getattr(module, '__loader__', None)
    return _find_adapter(_provider_factories, loader)(module)


def _macosx_vers(_cache=[]):
    if not _cache:
        version = platform.mac_ver()[0]
        # fallback for MacPorts
        if version == '':
            plist = '/System/Library/CoreServices/SystemVersion.plist'
            if os.path.exists(plist):
                if hasattr(plistlib, 'readPlist'):
                    plist_content = plistlib.readPlist(plist)
                    if 'ProductVersion' in plist_content:
                        version = plist_content['ProductVersion']

        _cache.append(version.split('.'))
    return _cache[0]


def _macosx_arch(machine):
    return {'PowerPC': 'ppc', 'Power_Macintosh': 'ppc'}.get(machine, machine)


def get_build_platform():
    """Return this platform's string for platform-specific distributions

    XXX Currently this is the same as ``distutils.util.get_platform()``, but it
    needs some hacks for Linux and Mac OS X.
    """
    from sysconfig import get_platform

    plat = get_platform()
    if sys.platform == "darwin" and not plat.startswith('macosx-'):
        try:
            version = _macosx_vers()
            machine = os.uname()[4].replace(" ", "_")
            return "macosx-%d.%d-%s" % (
                int(version[0]), int(version[1]),
                _macosx_arch(machine),
            )
        except ValueError:
            # if someone is running a non-Mac darwin system, this will fall
            # through to the default implementation
            pass
    return plat


macosVersionString = re.compile(r"macosx-(\d+)\.(\d+)-(.*)")
darwinVersionString = re.compile(r"darwin-(\d+)\.(\d+)\.(\d+)-(.*)")
# XXX backward compat
get_platform = get_build_platform


def compatible_platforms(provided, required):
    """Can code for the `provided` platform run on the `required` platform?

    Returns true if either platform is ``None``, or the platforms are equal.

    XXX Needs compatibility checks for Linux and other unixy OSes.
    """
    if provided is None or required is None or provided == required:
        # easy case
        return True

    # Mac OS X special cases
    reqMac = macosVersionString.match(required)
    if reqMac:
        provMac = macosVersionString.match(provided)

        # is this a Mac package?
        if not provMac:
            # this is backwards compatibility for packages built before
            # setuptools 0.6. All packages built after this point will
            # use the new macosx designation.
            provDarwin = darwinVersionString.match(provided)
            if provDarwin:
                dversion = int(provDarwin.group(1))
                macosversion = "%s.%s" % (reqMac.group(1), reqMac.group(2))
                if dversion == 7 and macosversion >= "10.3" or \
                        dversion == 8 and macosversion >= "10.4":
                    return True
            # egg isn't macosx or legacy darwin
            return False

        # are they the same major version and machine type?
        if provMac.group(1) != reqMac.group(1) or \
                provMac.group(3) != reqMac.group(3):
            return False

        # is the required OS major update >= the provided one?
        if int(provMac.group(2)) > int(reqMac.group(2)):
            return False

        return True

    # XXX Linux and other platforms' special cases should go here
    return False


def run_script(dist_spec, script_name):
    """Locate distribution `dist_spec` and run its `script_name` script"""
    ns = sys._getframe(1).f_globals
    name = ns['__name__']
    ns.clear()
    ns['__name__'] = name
    require(dist_spec)[0].run_script(script_name, ns)


# backward compatibility
run_main = run_script


def get_distribution(dist):
    """Return a current distribution object for a Requirement or string"""
    if isinstance(dist, six.string_types):
        dist = Requirement.parse(dist)
    if isinstance(dist, Requirement):
        dist = get_provider(dist)
    if not isinstance(dist, Distribution):
        raise TypeError("Expected string, Requirement, or Distribution", dist)
    return dist


def load_entry_point(dist, group, name):
    """Return `name` entry point of `group` for `dist` or raise ImportError"""
    return get_distribution(dist).load_entry_point(group, name)


def get_entry_map(dist, group=None):
    """Return the entry point map for `group`, or the full entry map"""
    return get_distribution(dist).get_entry_map(group)


def get_entry_info(dist, group, name):
    """Return the EntryPoint object for `group`+`name`, or ``None``"""
    return get_distribution(dist).get_entry_info(group, name)


class IMetadataProvider:
    def has_metadata(name):
        """Does the package's distribution contain the named metadata?"""

    def get_metadata(name):
        """The named metadata resource as a string"""

    def get_metadata_lines(name):
        """Yield named metadata resource as list of non-blank non-comment lines

       Leading and trailing whitespace is stripped from each line, and lines
       with ``#`` as the first non-blank character are omitted."""

    def metadata_isdir(name):
        """Is the named metadata a directory?  (like ``os.path.isdir()``)"""

    def metadata_listdir(name):
        """List of metadata names in the directory (like ``os.listdir()``)"""

    def run_script(script_name, namespace):
        """Execute the named script in the supplied namespace dictionary"""


class IResourceProvider(IMetadataProvider):
    """An object that provides access to package resources"""

    def get_resource_filename(manager, resource_name):
        """Return a true filesystem path for `resource_name`

        `manager` must be an ``IResourceManager``"""

    def get_resource_stream(manager, resource_name):
        """Return a readable file-like object for `resource_name`

        `manager` must be an ``IResourceManager``"""

    def get_resource_string(manager, resource_name):
        """Return a string containing the contents of `resource_name`

        `manager` must be an ``IResourceManager``"""

    def has_resource(resource_name):
        """Does the package contain the named resource?"""

    def resource_isdir(resource_name):
        """Is the named resource a directory?  (like ``os.path.isdir()``)"""

    def resource_listdir(resource_name):
        """List of resource names in the directory (like ``os.listdir()``)"""


class WorkingSet:
    """A collection of active distributions on sys.path (or a similar list)"""

    def __init__(self, entries=None):
        """Create working set from list of path entries (default=sys.path)"""
        self.entries = []
        self.entry_keys = {}
        self.by_key = {}
        self.callbacks = []

        if entries is None:
            entries = sys.path

        for entry in entries:
            self.add_entry(entry)

    @classmethod
    def _build_master(cls):
        """
        Prepare the master working set.
        """
        ws = cls()
        try:
            from __main__ import __requires__
        except ImportError:
            # The main program does not list any requirements
            return ws

        # ensure the requirements are met
        try:
            ws.require(__requires__)
        except VersionConflict:
            return cls._build_from_requirements(__requires__)

        return ws

    @classmethod
    def _build_from_requirements(cls, req_spec):
        """
        Build a working set from a requirement spec. Rewrites sys.path.
        """
        # try it without defaults already on sys.path
        # by starting with an empty path
        ws = cls([])
        reqs = parse_requirements(req_spec)
        dists = ws.resolve(reqs, Environment())
        for dist in dists:
            ws.add(dist)

        # add any missing entries from sys.path
        for entry in sys.path:
            if entry not in ws.entries:
                ws.add_entry(entry)

        # then copy back to sys.path
        sys.path[:] = ws.entries
        return ws

    def add_entry(self, entry):
        """Add a path item to ``.entries``, finding any distributions on it

        ``find_distributions(entry, True)`` is used to find distributions
        corresponding to the path entry, and they are added.  `entry` is
        always appended to ``.entries``, even if it is already present.
        (This is because ``sys.path`` can contain the same value more than
        once, and the ``.entries`` of the ``sys.path`` WorkingSet should always
        equal ``sys.path``.)
        """
        self.entry_keys.setdefault(entry, [])
        self.entries.append(entry)
        for dist in find_distributions(entry, True):
            self.add(dist, entry, False)

    def __contains__(self, dist):
        """True if `dist` is the active distribution for its project"""
        return self.by_key.get(dist.key) == dist

    def find(self, req):
        """Find a distribution matching requirement `req`

        If there is an active distribution for the requested project, this
        returns it as long as it meets the version requirement specified by
        `req`.  But, if there is an active distribution for the project and it
        does *not* meet the `req` requirement, ``VersionConflict`` is raised.
        If there is no active distribution for the requested project, ``None``
        is returned.
        """
        dist = self.by_key.get(req.key)
        if dist is not None and dist not in req:
            # XXX add more info
            raise VersionConflict(dist, req)
        return dist

    def iter_entry_points(self, group, name=None):
        """Yield entry point objects from `group` matching `name`

        If `name` is None, yields all entry points in `group` from all
        distributions in the working set, otherwise only ones matching
        both `group` and `name` are yielded (in distribution order).
        """
        return (
            entry
            for dist in self
            for entry in dist.get_entry_map(group).values()
            if name is None or name == entry.name
        )

    def run_script(self, requires, script_name):
        """Locate distribution for `requires` and run `script_name` script"""
        ns = sys._getframe(1).f_globals
        name = ns['__name__']
        ns.clear()
        ns['__name__'] = name
        self.require(requires)[0].run_script(script_name, ns)

    def __iter__(self):
        """Yield distributions for non-duplicate projects in the working set

        The yield order is the order in which the items' path entries were
        added to the working set.
        """
        seen = {}
        for item in self.entries:
            if item not in self.entry_keys:
                # workaround a cache issue
                continue

            for key in self.entry_keys[item]:
                if key not in seen:
                    seen[key] = 1
                    yield self.by_key[key]

    def add(self, dist, entry=None, insert=True, replace=False):
        """Add `dist` to working set, associated with `entry`

        If `entry` is unspecified, it defaults to the ``.location`` of `dist`.
        On exit from this routine, `entry` is added to the end of the working
        set's ``.entries`` (if it wasn't already present).

        `dist` is only added to the working set if it's for a project that
        doesn't already have a distribution in the set, unless `replace=True`.
        If it's added, any callbacks registered with the ``subscribe()`` method
        will be called.
        """
        if insert:
            dist.insert_on(self.entries, entry, replace=replace)

        if entry is None:
            entry = dist.location
        keys = self.entry_keys.setdefault(entry, [])
        keys2 = self.entry_keys.setdefault(dist.location, [])
        if not replace and dist.key in self.by_key:
            # ignore hidden distros
            return

        self.by_key[dist.key] = dist
        if dist.key not in keys:
            keys.append(dist.key)
        if dist.key not in keys2:
            keys2.append(dist.key)
        self._added_new(dist)

    def resolve(self, requirements, env=None, installer=None,
                replace_conflicting=False, extras=None):
        """List all distributions needed to (recursively) meet `requirements`

        `requirements` must be a sequence of ``Requirement`` objects.  `env`,
        if supplied, should be an ``Environment`` instance.  If
        not supplied, it defaults to all distributions available within any
        entry or distribution in the working set.  `installer`, if supplied,
        will be invoked with each requirement that cannot be met by an
        already-installed distribution; it should return a ``Distribution`` or
        ``None``.

        Unless `replace_conflicting=True`, raises a VersionConflict exception
        if
        any requirements are found on the path that have the correct name but
        the wrong version.  Otherwise, if an `installer` is supplied it will be
        invoked to obtain the correct version of the requirement and activate
        it.

        `extras` is a list of the extras to be used with these requirements.
        This is important because extra requirements may look like `my_req;
        extra = "my_extra"`, which would otherwise be interpreted as a purely
        optional requirement.  Instead, we want to be able to assert that these
        requirements are truly required.
        """

        # set up the stack
        requirements = list(requirements)[::-1]
        # set of processed requirements
        processed = {}
        # key -> dist
        best = {}
        to_activate = []

        req_extras = _ReqExtras()

        # Mapping of requirement to set of distributions that required it;
        # useful for reporting info about conflicts.
        required_by = collections.defaultdict(set)

        while requirements:
            # process dependencies breadth-first
            req = requirements.pop(0)
            if req in processed:
                # Ignore cyclic or redundant dependencies
                continue

            if not req_extras.markers_pass(req, extras):
                continue

            dist = best.get(req.key)
            if dist is None:
                # Find the best distribution and add it to the map
                dist = self.by_key.get(req.key)
                if dist is None or (dist not in req and replace_conflicting):
                    ws = self
                    if env is None:
                        if dist is None:
                            env = Environment(self.entries)
                        else:
                            # Use an empty environment and workingset to avoid
                            # any further conflicts with the conflicting
                            # distribution
                            env = Environment([])
                            ws = WorkingSet([])
                    dist = best[req.key] = env.best_match(
                        req, ws, installer,
                        replace_conflicting=replace_conflicting
                    )
                    if dist is None:
                        requirers = required_by.get(req, None)
                        raise DistributionNotFound(req, requirers)
                to_activate.append(dist)
            if dist not in req:
                # Oops, the "best" so far conflicts with a dependency
                dependent_req = required_by[req]
                raise VersionConflict(dist, req).with_context(dependent_req)

            # push the new requirements onto the stack
            new_requirements = dist.requires(req.extras)[::-1]
            requirements.extend(new_requirements)

            # Register the new requirements needed by req
            for new_requirement in new_requirements:
                required_by[new_requirement].add(req.project_name)
                req_extras[new_requirement] = req.extras

            processed[req] = True

        # return list of distros to activate
        return to_activate

    def find_plugins(
            self, plugin_env, full_env=None, installer=None, fallback=True):
        """Find all activatable distributions in `plugin_env`

        Example usage::

            distributions, errors = working_set.find_plugins(
                Environment(plugin_dirlist)
            )
            # add plugins+libs to sys.path
            map(working_set.add, distributions)
            # display errors
            print('Could not load', errors)

        The `plugin_env` should be an ``Environment`` instance that contains
        only distributions that are in the project's "plugin directory" or
        directories. The `full_env`, if supplied, should be an ``Environment``
        contains all currently-available distributions.  If `full_env` is not
        supplied, one is created automatically from the ``WorkingSet`` this
        method is called on, which will typically mean that every directory on
        ``sys.path`` will be scanned for distributions.

        `installer` is a standard installer callback as used by the
        ``resolve()`` method. The `fallback` flag indicates whether we should
        attempt to resolve older versions of a plugin if the newest version
        cannot be resolved.

        This method returns a 2-tuple: (`distributions`, `error_info`), where
        `distributions` is a list of the distributions found in `plugin_env`
        that were loadable, along with any other distributions that are needed
        to resolve their dependencies.  `error_info` is a dictionary mapping
        unloadable plugin distributions to an exception instance describing the
        error that occurred. Usually this will be a ``DistributionNotFound`` or
        ``VersionConflict`` instance.
        """

        plugin_projects = list(plugin_env)
        # scan project names in alphabetic order
        plugin_projects.sort()

        error_info = {}
        distributions = {}

        if full_env is None:
            env = Environment(self.entries)
            env += plugin_env
        else:
            env = full_env + plugin_env

        shadow_set = self.__class__([])
        # put all our entries in shadow_set
        list(map(shadow_set.add, self))

        for project_name in plugin_projects:

            for dist in plugin_env[project_name]:

                req = [dist.as_requirement()]

                try:
                    resolvees = shadow_set.resolve(req, env, installer)

                except ResolutionError as v:
                    # save error info
                    error_info[dist] = v
                    if fallback:
                        # try the next older version of project
                        continue
                    else:
                        # give up on this project, keep going
                        break

                else:
                    list(map(shadow_set.add, resolvees))
                    distributions.update(dict.fromkeys(resolvees))

                    # success, no need to try any more versions of this project
                    break

        distributions = list(distributions)
        distributions.sort()

        return distributions, error_info

    def require(self, *requirements):
        """Ensure that distributions matching `requirements` are activated

        `requirements` must be a string or a (possibly-nested) sequence
        thereof, specifying the distributions and versions required.  The
        return value is a sequence of the distributions that needed to be
        activated to fulfill the requirements; all relevant distributions are
        included, even if they were already activated in this working set.
        """
        needed = self.resolve(parse_requirements(requirements))

        for dist in needed:
            self.add(dist)

        return needed

    def subscribe(self, callback, existing=True):
        """Invoke `callback` for all distributions

        If `existing=True` (default),
        call on all existing ones, as well.
        """
        if callback in self.callbacks:
            return
        self.callbacks.append(callback)
        if not existing:
            return
        for dist in self:
            callback(dist)

    def _added_new(self, dist):
        for callback in self.callbacks:
            callback(dist)

    def __getstate__(self):
        return (
            self.entries[:], self.entry_keys.copy(), self.by_key.copy(),
            self.callbacks[:]
        )

    def __setstate__(self, e_k_b_c):
        entries, keys, by_key, callbacks = e_k_b_c
        self.entries = entries[:]
        self.entry_keys = keys.copy()
        self.by_key = by_key.copy()
        self.callbacks = callbacks[:]


class _ReqExtras(dict):
    """
    Map each requirement to the extras that demanded it.
    """

    def markers_pass(self, req, extras=None):
        """
        Evaluate markers for req against each extra that
        demanded it.

        Return False if the req has a marker and fails
        evaluation. Otherwise, return True.
        """
        extra_evals = (
            req.marker.evaluate({'extra': extra})
            for extra in self.get(req, ()) + (extras or (None,))
        )
        return not req.marker or any(extra_evals)


class Environment:
    """Searchable snapshot of distributions on a search path"""

    def __init__(
            self, search_path=None, platform=get_supported_platform(),
            python=PY_MAJOR):
        """Snapshot distributions available on a search path

        Any distributions found on `search_path` are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.

        `platform` is an optional string specifying the name of the platform
        that platform-specific distributions must be compatible with.  If
        unspecified, it defaults to the current platform.  `python` is an
        optional string naming the desired version of Python (e.g. ``'3.6'``);
        it defaults to the current version.

        You may explicitly set `platform` (and/or `python`) to ``None`` if you
        wish to map *all* distributions, not just those compatible with the
        running platform or Python version.
        """
        self._distmap = {}
        self.platform = platform
        self.python = python
        self.scan(search_path)

    def can_add(self, dist):
        """Is distribution `dist` acceptable for this environment?

        The distribution must match the platform and python version
        requirements specified when this environment was created, or False
        is returned.
        """
        py_compat = (
            self.python is None
            or dist.py_version is None
            or dist.py_version == self.python
        )
        return py_compat and compatible_platforms(dist.platform, self.platform)

    def remove(self, dist):
        """Remove `dist` from the environment"""
        self._distmap[dist.key].remove(dist)

    def scan(self, search_path=None):
        """Scan `search_path` for distributions usable in this environment

        Any distributions found are added to the environment.
        `search_path` should be a sequence of ``sys.path`` items.  If not
        supplied, ``sys.path`` is used.  Only distributions conforming to
        the platform/python version defined at initialization are added.
        """
        if search_path is None:
            search_path = sys.path

        for item in search_path:
            for dist in find_distributions(item):
                self.add(dist)

    def __getitem__(self, project_name):
        """Return a newest-to-oldest list of distributions for `project_name`

        Uses case-insensitive `project_name` comparison, assuming all the
        project's distributions use their project's name converted to all
        lowercase as their key.

        """
        distribution_key = project_name.lower()
        return self._distmap.get(distribution_key, [])

    def add(self, dist):
        """Add `dist` if we ``can_add()`` it and it has not already been added
        """
        if self.can_add(dist) and dist.has_version():
            dists = self._distmap.setdefault(dist.key, [])
            if dist not in dists:
                dists.append(dist)
                dists.sort(key=operator.attrgetter('hashcmp'), reverse=True)

    def best_match(
            self, req, working_set, installer=None, replace_conflicting=False):
        """Find distribution best matching `req` and usable on `working_set`

        This calls the ``find(req)`` method of the `working_set` to see if a
        suitable distribution is already active.  (This may raise
        ``VersionConflict`` if an unsuitable version of the project is already
        active in the specified `working_set`.)  If a suitable distribution
        isn't active, this method returns the newest distribution in the
        environment that meets the ``Requirement`` in `req`.  If no suitable
        distribution is found, and `installer` is supplied, then the result of
        calling the environment's ``obtain(req, installer)`` method will be
        returned.
        """
        try:
            dist = working_set.find(req)
        except VersionConflict:
            if not replace_conflicting:
                raise
            dist = None
        if dist is not None:
            return dist
        for dist in self[req.key]:
            if dist in req:
                return dist
        # try to download/install
        return self.obtain(req, installer)

    def obtain(self, requirement, installer=None):
        """Obtain a distribution matching `requirement` (e.g. via download)

        Obtain a distro that matches requirement (e.g. via download).  In the
        base ``Environment`` class, this routine just returns
        ``installer(requirement)``, unless `installer` is None, in which case
        None is returned instead.  This method is a hook that allows subclasses
        to attempt other ways of obtaining a distribution before falling back
        to the `installer` argument."""
        if installer is not None:
            return installer(requirement)

    def __iter__(self):
        """Yield the unique project names of the available distributions"""
        for key in self._distmap.keys():
            if self[key]:
                yield key

    def __iadd__(self, other):
        """In-place addition of a distribution or environment"""
        if isinstance(other, Distribution):
            self.add(other)
        elif isinstance(other, Environment):
            for project in other:
                for dist in other[project]:
                    self.add(dist)
        else:
            raise TypeError("Can't add %r to environment" % (other,))
        return self

    def __add__(self, other):
        """Add an environment or distribution to an environment"""
        new = self.__class__([], platform=None, python=None)
        for env in self, other:
            new += env
        return new


# XXX backward compatibility
AvailableDistributions = Environment


class ExtractionError(RuntimeError):
    """An error occurred extracting a resource

    The following attributes are available from instances of this exception:

    manager
        The resource manager that raised this exception

    cache_path
        The base directory for resource extraction

    original_error
        The exception instance that caused extraction to fail
    """


class ResourceManager:
    """Manage resource extraction and packages"""
    extraction_path = None

    def __init__(self):
        self.cached_files = {}

    def resource_exists(self, package_or_requirement, resource_name):
        """Does the named resource exist?"""
        return get_provider(package_or_requirement).has_resource(resource_name)

    def resource_isdir(self, package_or_requirement, resource_name):
        """Is the named resource an existing directory?"""
        return get_provider(package_or_requirement).resource_isdir(
            resource_name
        )

    def resource_filename(self, package_or_requirement, resource_name):
        """Return a true filesystem path for specified resource"""
        return get_provider(package_or_requirement).get_resource_filename(
            self, resource_name
        )

    def resource_stream(self, package_or_requirement, resource_name):
        """Return a readable file-like object for specified resource"""
        return get_provider(package_or_requirement).get_resource_stream(
            self, resource_name
        )

    def resource_string(self, package_or_requirement, resource_name):
        """Return specified resource as a string"""
        return get_provider(package_or_requirement).get_resource_string(
            self, resource_name
        )

    def resource_listdir(self, package_or_requirement, resource_name):
        """List the contents of the named resource directory"""
        return get_provider(package_or_requirement).resource_listdir(
            resource_name
        )

    def extraction_error(self):
        """Give an error message for problems extracting file(s)"""

        old_exc = sys.exc_info()[1]
        cache_path = self.extraction_path or get_default_cache()

        tmpl = textwrap.dedent("""
            Can't extract file(s) to egg cache

            The following error occurred while trying to extract file(s)
            to the Python egg cache:

              {old_exc}

            The Python egg cache directory is currently set to:

              {cache_path}

            Perhaps your account does not have write access to this directory?
            You can change the cache directory by setting the PYTHON_EGG_CACHE
            environment variable to point to an accessible directory.
            """).lstrip()
        err = ExtractionError(tmpl.format(**locals()))
        err.manager = self
        err.cache_path = cache_path
        err.original_error = old_exc
        raise err

    def get_cache_path(self, archive_name, names=()):
        """Return absolute location in cache for `archive_name` and `names`

        The parent directory of the resulting path will be created if it does
        not already exist.  `archive_name` should be the base filename of the
        enclosing egg (which may not be the name of the enclosing zipfile!),
        including its ".egg" extension.  `names`, if provided, should be a
        sequence of path name parts "under" the egg's extraction location.

        This method should only be called by resource providers that need to
        obtain an extraction location, and only for names they intend to
        extract, as it tracks the generated names for possible cleanup later.
        """
        extract_path = self.extraction_path or get_default_cache()
        target_path = os.path.join(extract_path, archive_name + '-tmp', *names)
        try:
            _bypass_ensure_directory(target_path)
        except Exception:
            self.extraction_error()

        self._warn_unsafe_extraction_path(extract_path)

        self.cached_files[target_path] = 1
        return target_path

    @staticmethod
    def _warn_unsafe_extraction_path(path):
        """
        If the default extraction path is overridden and set to an insecure
        location, such as /tmp, it opens up an opportunity for an attacker to
        replace an extracted file with an unauthorized payload. Warn the user
        if a known insecure location is used.

        See Distribute #375 for more details.
        """
        if os.name == 'nt' and not path.startswith(os.environ['windir']):
            # On Windows, permissions are generally restrictive by default
            #  and temp directories are not writable by other users, so
            #  bypass the warning.
            return
        mode = os.stat(path).st_mode
        if mode & stat.S_IWOTH or mode & stat.S_IWGRP:
            msg = (
                "%s is writable by group/others and vulnerable to attack "
                "when "
                "used with get_resource_filename. Consider a more secure "
                "location (set with .set_extraction_path or the "
                "PYTHON_EGG_CACHE environment variable)." % path
            )
            warnings.warn(msg, UserWarning)

    def postprocess(self, tempname, filename):
        """Perform any platform-specific postprocessing of `tempname`

        This is where Mac header rewrites should be done; other platforms don't
        have anything special they should do.

        Resource providers should call this method ONLY after successfully
        extracting a compressed resource.  They must NOT call it on resources
        that are already in the filesystem.

        `tempname` is the current (temporary) name of the file, and `filename`
        is the name it will be renamed to by the caller after this routine
        returns.
        """

        if os.name == 'posix':
            # Make the resource executable
            mode = ((os.stat(tempname).st_mode) | 0o555) & 0o7777
            os.chmod(tempname, mode)

    def set_extraction_path(self, path):
        """Set the base path where resources will be extracted to, if needed.

        If you do not call this routine before any extractions take place, the
        path defaults to the return value of ``get_default_cache()``.  (Which
        is based on the ``PYTHON_EGG_CACHE`` environment variable, with various
        platform-specific fallbacks.  See that routine's documentation for more
        details.)

        Resources are extracted to subdirectories of this path based upon
        information given by the ``IResourceProvider``.  You may set this to a
        temporary directory, but then you must call ``cleanup_resources()`` to
        delete the extracted files when done.  There is no guarantee that
        ``cleanup_resources()`` will be able to remove all extracted files.

        (Note: you may not change the extraction path for a given resource
        manager once resources have been extracted, unless you first call
        ``cleanup_resources()``.)
        """
        if self.cached_files:
            raise ValueError(
                "Can't change extraction path, files already extracted"
            )

        self.extraction_path = path

    def cleanup_resources(self, force=False):
        """
        Delete all extracted resource files and directories, returning a list
        of the file and directory names that could not be successfully removed.
        This function does not have any concurrency protection, so it should
        generally only be called when the extraction path is a temporary
        directory exclusive to a single process.  This method is not
        automatically called; you must call it explicitly or register it as an
        ``atexit`` function if you wish to ensure cleanup of a temporary
        directory used for extractions.
        """
        # XXX


def get_default_cache():
    """
    Return the ``PYTHON_EGG_CACHE`` environment variable
    or a platform-relevant user cache dir for an app
    named "Python-Eggs".
    """
    return (
        os.environ.get('PYTHON_EGG_CACHE')
        or appdirs.user_cache_dir(appname='Python-Eggs')
    )


def safe_name(name):
    """Convert an arbitrary string to a standard distribution name

    Any runs of non-alphanumeric/. characters are replaced with a single '-'.
    """
    return re.sub('[^A-Za-z0-9.]+', '-', name)


def safe_version(version):
    """
    Convert an arbitrary string to a standard version string
    """
    try:
        # normalize the version
        return str(packaging.version.Version(version))
    except packaging.version.InvalidVersion:
        version = version.replace(' ', '.')
        return re.sub('[^A-Za-z0-9.]+', '-', version)


def safe_extra(extra):
    """Convert an arbitrary string to a standard 'extra' name

    Any runs of non-alphanumeric characters are replaced with a single '_',
    and the result is always lowercased.
    """
    return re.sub('[^A-Za-z0-9.-]+', '_', extra).lower()


def to_filename(name):
    """Convert a project or version name to its filename-escaped form

    Any '-' characters are currently replaced with '_'.
    """
    return name.replace('-', '_')


def invalid_marker(text):
    """
    Validate text as a PEP 508 environment marker; return an exception
    if invalid or False otherwise.
    """
    try:
        evaluate_marker(text)
    except SyntaxError as e:
        e.filename = None
        e.lineno = None
        return e
    return False


def evaluate_marker(text, extra=None):
    """
    Evaluate a PEP 508 environment marker.
    Return a boolean indicating the marker result in this environment.
    Raise SyntaxError if marker is invalid.

    This implementation uses the 'pyparsing' module.
    """
    try:
        marker = packaging.markers.Marker(text)
        return marker.evaluate()
    except packaging.markers.InvalidMarker as e:
        raise SyntaxError(e)


class NullProvider:
    """Try to implement resources and metadata for arbitrary PEP 302 loaders"""

    egg_name = None
    egg_info = None
    loader = None

    def __init__(self, module):
        self.loader = getattr(module, '__loader__', None)
        self.module_path = os.path.dirname(getattr(module, '__file__', ''))

    def get_resource_filename(self, manager, resource_name):
        return self._fn(self.module_path, resource_name)

    def get_resource_stream(self, manager, resource_name):
        return io.BytesIO(self.get_resource_string(manager, resource_name))

    def get_resource_string(self, manager, resource_name):
        return self._get(self._fn(self.module_path, resource_name))

    def has_resource(self, resource_name):
        return self._has(self._fn(self.module_path, resource_name))

    def _get_metadata_path(self, name):
        return self._fn(self.egg_info, name)

    def has_metadata(self, name):
        if not self.egg_info:
            return self.egg_info

        path = self._get_metadata_path(name)
        return self._has(path)

    def get_metadata(self, name):
        if not self.egg_info:
            return ""
        path = self._get_metadata_path(name)
        value = self._get(path)
        if six.PY2:
            return value
        try:
            return value.decode('utf-8')
        except UnicodeDecodeError as exc:
            # Include the path in the error message to simplify
            # troubleshooting, and without changing the exception type.
            exc.reason += ' in {} file at path: {}'.format(name, path)
            raise

    def get_metadata_lines(self, name):
        return yield_lines(self.get_metadata(name))

    def resource_isdir(self, resource_name):
        return self._isdir(self._fn(self.module_path, resource_name))

    def metadata_isdir(self, name):
        return self.egg_info and self._isdir(self._fn(self.egg_info, name))

    def resource_listdir(self, resource_name):
        return self._listdir(self._fn(self.module_path, resource_name))

    def metadata_listdir(self, name):
        if self.egg_info:
            return self._listdir(self._fn(self.egg_info, name))
        return []

    def run_script(self, script_name, namespace):
        script = 'scripts/' + script_name
        if not self.has_metadata(script):
            raise ResolutionError(
                "Script {script!r} not found in metadata at {self.egg_info!r}"
                .format(**locals()),
            )
        script_text = self.get_metadata(script).replace('\r\n', '\n')
        script_text = script_text.replace('\r', '\n')
        script_filename = self._fn(self.egg_info, script)
        namespace['__file__'] = script_filename
        if os.path.exists(script_filename):
            source = open(script_filename).read()
            code = compile(source, script_filename, 'exec')
            exec(code, namespace, namespace)
        else:
            from linecache import cache
            cache[script_filename] = (
                len(script_text), 0, script_text.split('\n'), script_filename
            )
            script_code = compile(script_text, script_filename, 'exec')
            exec(script_code, namespace, namespace)

    def _has(self, path):
        raise NotImplementedError(
            "Can't perform this operation for unregistered loader type"
        )

    def _isdir(self, path):
        raise NotImplementedError(
            "Can't perform this operation for unregistered loader type"
        )

    def _listdir(self, path):
        raise NotImplementedError(
            "Can't perform this operation for unregistered loader type"
        )

    def _fn(self, base, resource_name):
        self._validate_resource_path(resource_name)
        if resource_name:
            return os.path.join(base, *resource_name.split('/'))
        return base

    @staticmethod
    def _validate_resource_path(path):
        """
        Validate the resource paths according to the docs.
        https://setuptools.readthedocs.io/en/latest/pkg_resources.html#basic-resource-access

        >>> warned = getfixture('recwarn')
        >>> warnings.simplefilter('always')
        >>> vrp = NullProvider._validate_resource_path
        >>> vrp('foo/bar.txt')
        >>> bool(warned)
        False
        >>> vrp('../foo/bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('/foo/bar.txt')
        >>> bool(warned)
        True
        >>> vrp('foo/../../bar.txt')
        >>> bool(warned)
        True
        >>> warned.clear()
        >>> vrp('foo/f../bar.txt')
        >>> bool(warned)
        False

        Windows path separators are straight-up disallowed.
        >>> vrp(r'\\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path \
is not allowed.

        >>> vrp(r'C:\\foo/bar.txt')
        Traceback (most recent call last):
        ...
        ValueError: Use of .. or absolute path in a resource path \
is not allowed.

        Blank values are allowed

        >>> vrp('')
        >>> bool(warned)
        False

        Non-string values are not.

        >>> vrp(None)
        Traceback (most recent call last):
        ...
        AttributeError: ...
        """
        invalid = (
            os.path.pardir in path.split(posixpath.sep) or
            posixpath.isabs(path) or
            ntpath.isabs(path)
        )
        if not invalid:
            return

        msg = "Use of .. or absolute path in a resource path is not allowed."

        # Aggressively disallow Windows absolute paths
        if ntpath.isabs(path) and not posixpath.isabs(path):
            raise ValueError(msg)

        # for compatibility, warn; in future
        # raise ValueError(msg)
        warnings.warn(
            msg[:-1] + " and will raise exceptions in a future release.",
            DeprecationWarning,
            stacklevel=4,
        )

    def _get(self, path):
        if hasattr(self.loader, 'get_data'):
            return self.loader.get_data(path)
        raise NotImplementedError(
            "Can't perform this operation for loaders without 'get_data()'"
        )


register_loader_type(object, NullProvider)


class EggProvider(NullProvider):
    """Provider based on a virtual filesystem"""

    def __init__(self, module):
        NullProvider.__init__(self, module)
        self._setup_prefix()

    def _setup_prefix(self):
        # we assume here that our metadata may be nested inside a "basket"
        # of multiple eggs; that's why we use module_path instead of .archive
        path = self.module_path
        old = None
        while path != old:
            if _is_egg_path(path):
                self.egg_name = os.path.basename(path)
                self.egg_info = os.path.join(path, 'EGG-INFO')
                self.egg_root = path
                break
            old = path
            path, base = os.path.split(path)


class DefaultProvider(EggProvider):
    """Provides access to package resources in the filesystem"""

    def _has(self, path):
        return os.path.exists(path)

    def _isdir(self, path):
        return os.path.isdir(path)

    def _listdir(self, path):
        return os.listdir(path)

    def get_resource_stream(self, manager, resource_name):
        return open(self._fn(self.module_path, resource_name), 'rb')

    def _get(self, path):
        with open(path, 'rb') as stream:
            return stream.read()

    @classmethod
    def _register(cls):
        loader_names = 'SourceFileLoader', 'SourcelessFileLoader',
        for name in loader_names:
            loader_cls = getattr(importlib_machinery, name, type(None))
            register_loader_type(loader_cls, cls)


DefaultProvider._register()


class EmptyProvider(NullProvider):
    """Provider that returns nothing for all requests"""

    module_path = None

    _isdir = _has = lambda self, path: False

    def _get(self, path):
        return ''

    def _listdir(self, path):
        return []

    def __init__(self):
        pass


empty_provider = EmptyProvider()


class ZipManifests(dict):
    """
    zip manifest builder
    """

    @classmethod
    def build(cls, path):
        """
        Build a dictionary similar to the zipimport directory
        caches, except instead of tuples, store ZipInfo objects.

        Use a platform-specific path separator (os.sep) for the path keys
        for compatibility with pypy on Windows.
        """
        with zipfile.ZipFile(path) as zfile:
            items = (
                (
                    name.replace('/', os.sep),
                    zfile.getinfo(name),
                )
                for name in zfile.namelist()
            )
            return dict(items)

    load = build


class MemoizedZipManifests(ZipManifests):
    """
    Memoized zipfile manifests.
    """
    manifest_mod = collections.namedtuple('manifest_mod', 'manifest mtime')

    def load(self, path):
        """
        Load a manifest at path or return a suitable manifest already loaded.
        """
        path = os.path.normpath(path)
        mtime = os.stat(path).st_mtime

        if path not in self or self[path].mtime != mtime:
            manifest = self.build(path)
            self[path] = self.manifest_mod(manifest, mtime)

        return self[path].manifest


class ZipProvider(EggProvider):
    """Resource support for zips and eggs"""

    eagers = None
    _zip_manifests = MemoizedZipManifests()

    def __init__(self, module):
        EggProvider.__init__(self, module)
        self.zip_pre = self.loader.archive + os.sep

    def _zipinfo_name(self, fspath):
        # Convert a virtual filename (full path to file) into a zipfile subpath
        # usable with the zipimport directory cache for our target archive
        fspath = fspath.rstrip(os.sep)
        if fspath == self.loader.archive:
            return ''
        if fspath.startswith(self.zip_pre):
            return fspath[len(self.zip_pre):]
        raise AssertionError(
            "%s is not a subpath of %s" % (fspath, self.zip_pre)
        )

    def _parts(self, zip_path):
        # Convert a zipfile subpath into an egg-relative path part list.
        # pseudo-fs path
        fspath = self.zip_pre + zip_path
        if fspath.startswith(self.egg_root + os.sep):
            return fspath[len(self.egg_root) + 1:].split(os.sep)
        raise AssertionError(
            "%s is not a subpath of %s" % (fspath, self.egg_root)
        )

    @property
    def zipinfo(self):
        return self._zip_manifests.load(self.loader.archive)

    def get_resource_filename(self, manager, resource_name):
        if not self.egg_name:
            raise NotImplementedError(
                "resource_filename() only supported for .egg, not .zip"
            )
        # no need to lock for extraction, since we use temp names
        zip_path = self._resource_to_zip(resource_name)
        eagers = self._get_eager_resources()
        if '/'.join(self._parts(zip_path)) in eagers:
            for name in eagers:
                self._extract_resource(manager, self._eager_to_zip(name))
        return self._extract_resource(manager, zip_path)

    @staticmethod
    def _get_date_and_size(zip_stat):
        size = zip_stat.file_size
        # ymdhms+wday, yday, dst
        date_time = zip_stat.date_time + (0, 0, -1)
        # 1980 offset already done
        timestamp = time.mktime(date_time)
        return timestamp, size

    def _extract_resource(self, manager, zip_path):

        if zip_path in self._index():
            for name in self._index()[zip_path]:
                last = self._extract_resource(
                    manager, os.path.join(zip_path, name)
                )
            # return the extracted directory name
            return os.path.dirname(last)

        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])

        if not WRITE_SUPPORT:
            raise IOError('"os.rename" and "os.unlink" are not supported '
                          'on this platform')
        try:

            real_path = manager.get_cache_path(
                self.egg_name, self._parts(zip_path)
            )

            if self._is_current(real_path, zip_path):
                return real_path

            outf, tmpnam = _mkstemp(
                ".$extract",
                dir=os.path.dirname(real_path),
            )
            os.write(outf, self.loader.get_data(zip_path))
            os.close(outf)
            utime(tmpnam, (timestamp, timestamp))
            manager.postprocess(tmpnam, real_path)

            try:
                rename(tmpnam, real_path)

            except os.error:
                if os.path.isfile(real_path):
                    if self._is_current(real_path, zip_path):
                        # the file became current since it was checked above,
                        #  so proceed.
                        return real_path
                    # Windows, del old file and retry
                    elif os.name == 'nt':
                        unlink(real_path)
                        rename(tmpnam, real_path)
                        return real_path
                raise

        except os.error:
            # report a user-friendly error
            manager.extraction_error()

        return real_path

    def _is_current(self, file_path, zip_path):
        """
        Return True if the file_path is current for this zip_path
        """
        timestamp, size = self._get_date_and_size(self.zipinfo[zip_path])
        if not os.path.isfile(file_path):
            return False
        stat = os.stat(file_path)
        if stat.st_size != size or stat.st_mtime != timestamp:
            return False
        # check that the contents match
        zip_contents = self.loader.get_data(zip_path)
        with open(file_path, 'rb') as f:
            file_contents = f.read()
        return zip_contents == file_contents

    def _get_eager_resources(self):
        if self.eagers is None:
            eagers = []
            for name in ('native_libs.txt', 'eager_resources.txt'):
                if self.has_metadata(name):
                    eagers.extend(self.get_metadata_lines(name))
            self.eagers = eagers
        return self.eagers

    def _index(self):
        try:
            return self._dirindex
        except AttributeError:
            ind = {}
            for path in self.zipinfo:
                parts = path.split(os.sep)
                while parts:
                    parent = os.sep.join(parts[:-1])
                    if parent in ind:
                        ind[parent].append(parts[-1])
                        break
                    else:
                        ind[parent] = [parts.pop()]
            self._dirindex = ind
            return ind

    def _has(self, fspath):
        zip_path = self._zipinfo_name(fspath)
        return zip_path in self.zipinfo or zip_path in self._index()

    def _isdir(self, fspath):
        return self._zipinfo_name(fspath) in self._index()

    def _listdir(self, fspath):
        return list(self._index().get(self._zipinfo_name(fspath), ()))

    def _eager_to_zip(self, resource_name):
        return self._zipinfo_name(self._fn(self.egg_root, resource_name))

    def _resource_to_zip(self, resource_name):
        return self._zipinfo_name(self._fn(self.module_path, resource_name))


register_loader_type(zipimport.zipimporter, ZipProvider)


class FileMetadata(EmptyProvider):
    """Metadata handler for standalone PKG-INFO files

    Usage::

        metadata = FileMetadata("/path/to/PKG-INFO")

    This provider rejects all data and metadata requests except for PKG-INFO,
    which is treated as existing, and will be the contents of the file at
    the provided location.
    """

    def __init__(self, path):
        self.path = path

    def _get_metadata_path(self, name):
        return self.path

    def has_metadata(self, name):
        return name == 'PKG-INFO' and os.path.isfile(self.path)

    def get_metadata(self, name):
        if name != 'PKG-INFO':
            raise KeyError("No metadata except PKG-INFO is available")

        with io.open(self.path, encoding='utf-8', errors="replace") as f:
            metadata = f.read()
        self._warn_on_replacement(metadata)
        return metadata

    def _warn_on_replacement(self, metadata):
        # Python 2.7 compat for: replacement_char = '�'
        replacement_char = b'\xef\xbf\xbd'.decode('utf-8')
        if replacement_char in metadata:
            tmpl = "{self.path} could not be properly decoded in UTF-8"
            msg = tmpl.format(**locals())
            warnings.warn(msg)

    def get_metadata_lines(self, name):
        return yield_lines(self.get_metadata(name))


class PathMetadata(DefaultProvider):
    """Metadata provider for egg directories

    Usage::

        # Development eggs:

        egg_info = "/path/to/PackageName.egg-info"
        base_dir = os.path.dirname(egg_info)
        metadata = PathMetadata(base_dir, egg_info)
        dist_name = os.path.splitext(os.path.basename(egg_info))[0]
        dist = Distribution(basedir, project_name=dist_name, metadata=metadata)

        # Unpacked egg directories:

        egg_path = "/path/to/PackageName-ver-pyver-etc.egg"
        metadata = PathMetadata(egg_path, os.path.join(egg_path,'EGG-INFO'))
        dist = Distribution.from_filename(egg_path, metadata=metadata)
    """

    def __init__(self, path, egg_info):
        self.module_path = path
        self.egg_info = egg_info


class EggMetadata(ZipProvider):
    """Metadata provider for .egg files"""

    def __init__(self, importer):
        """Create a metadata provider from a zipimporter"""

        self.zip_pre = importer.archive + os.sep
        self.loader = importer
        if importer.prefix:
            self.module_path = os.path.join(importer.archive, importer.prefix)
        else:
            self.module_path = importer.archive
        self._setup_prefix()


_declare_state('dict', _distribution_finders={})


def register_finder(importer_type, distribution_finder):
    """Register `distribution_finder` to find distributions in sys.path items

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `distribution_finder` is a callable that, passed a path
    item and the importer instance, yields ``Distribution`` instances found on
    that path item.  See ``pkg_resources.find_on_path`` for an example."""
    _distribution_finders[importer_type] = distribution_finder


def find_distributions(path_item, only=False):
    """Yield distributions accessible via `path_item`"""
    importer = get_importer(path_item)
    finder = _find_adapter(_distribution_finders, importer)
    return finder(importer, path_item, only)


def find_eggs_in_zip(importer, path_item, only=False):
    """
    Find eggs in zip files; possibly multiple nested eggs.
    """
    if importer.archive.endswith('.whl'):
        # wheels are not supported with this finder
        # they don't have PKG-INFO metadata, and won't ever contain eggs
        return
    metadata = EggMetadata(importer)
    if metadata.has_metadata('PKG-INFO'):
        yield Distribution.from_filename(path_item, metadata=metadata)
    if only:
        # don't yield nested distros
        return
    for subitem in metadata.resource_listdir(''):
        if _is_egg_path(subitem):
            subpath = os.path.join(path_item, subitem)
            dists = find_eggs_in_zip(zipimport.zipimporter(subpath), subpath)
            for dist in dists:
                yield dist
        elif subitem.lower().endswith('.dist-info'):
            subpath = os.path.join(path_item, subitem)
            submeta = EggMetadata(zipimport.zipimporter(subpath))
            submeta.egg_info = subpath
            yield Distribution.from_location(path_item, subitem, submeta)


register_finder(zipimport.zipimporter, find_eggs_in_zip)


def find_nothing(importer, path_item, only=False):
    return ()


register_finder(object, find_nothing)


def _by_version_descending(names):
    """
    Given a list of filenames, return them in descending order
    by version number.

    >>> names = 'bar', 'foo', 'Python-2.7.10.egg', 'Python-2.7.2.egg'
    >>> _by_version_descending(names)
    ['Python-2.7.10.egg', 'Python-2.7.2.egg', 'foo', 'bar']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.egg', 'Setuptools-1.2.3b1.egg']
    >>> names = 'Setuptools-1.2.3b1.egg', 'Setuptools-1.2.3.post1.egg'
    >>> _by_version_descending(names)
    ['Setuptools-1.2.3.post1.egg', 'Setuptools-1.2.3b1.egg']
    """
    def _by_version(name):
        """
        Parse each component of the filename
        """
        name, ext = os.path.splitext(name)
        parts = itertools.chain(name.split('-'), [ext])
        return [packaging.version.parse(part) for part in parts]

    return sorted(names, key=_by_version, reverse=True)


def find_on_path(importer, path_item, only=False):
    """Yield distributions accessible on a sys.path directory"""
    path_item = _normalize_cached(path_item)

    if _is_unpacked_egg(path_item):
        yield Distribution.from_filename(
            path_item, metadata=PathMetadata(
                path_item, os.path.join(path_item, 'EGG-INFO')
            )
        )
        return

    entries = safe_listdir(path_item)

    # for performance, before sorting by version,
    # screen entries for only those that will yield
    # distributions
    filtered = (
        entry
        for entry in entries
        if dist_factory(path_item, entry, only)
    )

    # scan for .egg and .egg-info in directory
    path_item_entries = _by_version_descending(filtered)
    for entry in path_item_entries:
        fullpath = os.path.join(path_item, entry)
        factory = dist_factory(path_item, entry, only)
        for dist in factory(fullpath):
            yield dist


def dist_factory(path_item, entry, only):
    """
    Return a dist_factory for a path_item and entry
    """
    lower = entry.lower()
    is_meta = any(map(lower.endswith, ('.egg-info', '.dist-info')))
    return (
        distributions_from_metadata
        if is_meta else
        find_distributions
        if not only and _is_egg_path(entry) else
        resolve_egg_link
        if not only and lower.endswith('.egg-link') else
        NoDists()
    )


class NoDists:
    """
    >>> bool(NoDists())
    False

    >>> list(NoDists()('anything'))
    []
    """
    def __bool__(self):
        return False
    if six.PY2:
        __nonzero__ = __bool__

    def __call__(self, fullpath):
        return iter(())


def safe_listdir(path):
    """
    Attempt to list contents of path, but suppress some exceptions.
    """
    try:
        return os.listdir(path)
    except (PermissionError, NotADirectoryError):
        pass
    except OSError as e:
        # Ignore the directory if does not exist, not a directory or
        # permission denied
        ignorable = (
            e.errno in (errno.ENOTDIR, errno.EACCES, errno.ENOENT)
            # Python 2 on Windows needs to be handled this way :(
            or getattr(e, "winerror", None) == 267
        )
        if not ignorable:
            raise
    return ()


def distributions_from_metadata(path):
    root = os.path.dirname(path)
    if os.path.isdir(path):
        if len(os.listdir(path)) == 0:
            # empty metadata dir; skip
            return
        metadata = PathMetadata(root, path)
    else:
        metadata = FileMetadata(path)
    entry = os.path.basename(path)
    yield Distribution.from_location(
        root, entry, metadata, precedence=DEVELOP_DIST,
    )


def non_empty_lines(path):
    """
    Yield non-empty lines from file at path
    """
    with open(path) as f:
        for line in f:
            line = line.strip()
            if line:
                yield line


def resolve_egg_link(path):
    """
    Given a path to an .egg-link, resolve distributions
    present in the referenced path.
    """
    referenced_paths = non_empty_lines(path)
    resolved_paths = (
        os.path.join(os.path.dirname(path), ref)
        for ref in referenced_paths
    )
    dist_groups = map(find_distributions, resolved_paths)
    return next(dist_groups, ())


register_finder(pkgutil.ImpImporter, find_on_path)

if hasattr(importlib_machinery, 'FileFinder'):
    register_finder(importlib_machinery.FileFinder, find_on_path)

_declare_state('dict', _namespace_handlers={})
_declare_state('dict', _namespace_packages={})


def register_namespace_handler(importer_type, namespace_handler):
    """Register `namespace_handler` to declare namespace packages

    `importer_type` is the type or class of a PEP 302 "Importer" (sys.path item
    handler), and `namespace_handler` is a callable like this::

        def namespace_handler(importer, path_entry, moduleName, module):
            # return a path_entry to use for child packages

    Namespace handlers are only called if the importer object has already
    agreed that it can handle the relevant path item, and they should only
    return a subpath if the module __path__ does not already contain an
    equivalent subpath.  For an example namespace handler, see
    ``pkg_resources.file_ns_handler``.
    """
    _namespace_handlers[importer_type] = namespace_handler


def _handle_ns(packageName, path_item):
    """Ensure that named package includes a subpath of path_item (if needed)"""

    importer = get_importer(path_item)
    if importer is None:
        return None

    # capture warnings due to #1111
    with warnings.catch_warnings():
        warnings.simplefilter("ignore")
        loader = importer.find_module(packageName)

    if loader is None:
        return None
    module = sys.modules.get(packageName)
    if module is None:
        module = sys.modules[packageName] = types.ModuleType(packageName)
        module.__path__ = []
        _set_parent_ns(packageName)
    elif not hasattr(module, '__path__'):
        raise TypeError("Not a package:", packageName)
    handler = _find_adapter(_namespace_handlers, importer)
    subpath = handler(importer, path_item, packageName, module)
    if subpath is not None:
        path = module.__path__
        path.append(subpath)
        loader.load_module(packageName)
        _rebuild_mod_path(path, packageName, module)
    return subpath


def _rebuild_mod_path(orig_path, package_name, module):
    """
    Rebuild module.__path__ ensuring that all entries are ordered
    corresponding to their sys.path order
    """
    sys_path = [_normalize_cached(p) for p in sys.path]

    def safe_sys_path_index(entry):
        """
        Workaround for #520 and #513.
        """
        try:
            return sys_path.index(entry)
        except ValueError:
            return float('inf')

    def position_in_sys_path(path):
        """
        Return the ordinal of the path based on its position in sys.path
        """
        path_parts = path.split(os.sep)
        module_parts = package_name.count('.') + 1
        parts = path_parts[:-module_parts]
        return safe_sys_path_index(_normalize_cached(os.sep.join(parts)))

    new_path = sorted(orig_path, key=position_in_sys_path)
    new_path = [_normalize_cached(p) for p in new_path]

    if isinstance(module.__path__, list):
        module.__path__[:] = new_path
    else:
        module.__path__ = new_path


def declare_namespace(packageName):
    """Declare that package 'packageName' is a namespace package"""

    _imp.acquire_lock()
    try:
        if packageName in _namespace_packages:
            return

        path = sys.path
        parent, _, _ = packageName.rpartition('.')

        if parent:
            declare_namespace(parent)
            if parent not in _namespace_packages:
                __import__(parent)
            try:
                path = sys.modules[parent].__path__
            except AttributeError:
                raise TypeError("Not a package:", parent)

        # Track what packages are namespaces, so when new path items are added,
        # they can be updated
        _namespace_packages.setdefault(parent or None, []).append(packageName)
        _namespace_packages.setdefault(packageName, [])

        for path_item in path:
            # Ensure all the parent's path items are reflected in the child,
            # if they apply
            _handle_ns(packageName, path_item)

    finally:
        _imp.release_lock()


def fixup_namespace_packages(path_item, parent=None):
    """Ensure that previously-declared namespace packages include path_item"""
    _imp.acquire_lock()
    try:
        for package in _namespace_packages.get(parent, ()):
            subpath = _handle_ns(package, path_item)
            if subpath:
                fixup_namespace_packages(subpath, package)
    finally:
        _imp.release_lock()


def file_ns_handler(importer, path_item, packageName, module):
    """Compute an ns-package subpath for a filesystem or zipfile importer"""

    subpath = os.path.join(path_item, packageName.split('.')[-1])
    normalized = _normalize_cached(subpath)
    for item in module.__path__:
        if _normalize_cached(item) == normalized:
            break
    else:
        # Only return the path if it's not already there
        return subpath


register_namespace_handler(pkgutil.ImpImporter, file_ns_handler)
register_namespace_handler(zipimport.zipimporter, file_ns_handler)

if hasattr(importlib_machinery, 'FileFinder'):
    register_namespace_handler(importlib_machinery.FileFinder, file_ns_handler)


def null_ns_handler(importer, path_item, packageName, module):
    return None


register_namespace_handler(object, null_ns_handler)


def normalize_path(filename):
    """Normalize a file/dir name for comparison purposes"""
    return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename))))


def _cygwin_patch(filename):  # pragma: nocover
    """
    Contrary to POSIX 2008, on Cygwin, getcwd (3) contains
    symlink components. Using
    os.path.abspath() works around this limitation. A fix in os.getcwd()
    would probably better, in Cygwin even more so, except
    that this seems to be by design...
    """
    return os.path.abspath(filename) if sys.platform == 'cygwin' else filename


def _normalize_cached(filename, _cache={}):
    try:
        return _cache[filename]
    except KeyError:
        _cache[filename] = result = normalize_path(filename)
        return result


def _is_egg_path(path):
    """
    Determine if given path appears to be an egg.
    """
    return path.lower().endswith('.egg')


def _is_unpacked_egg(path):
    """
    Determine if given path appears to be an unpacked egg.
    """
    return (
        _is_egg_path(path) and
        os.path.isfile(os.path.join(path, 'EGG-INFO', 'PKG-INFO'))
    )


def _set_parent_ns(packageName):
    parts = packageName.split('.')
    name = parts.pop()
    if parts:
        parent = '.'.join(parts)
        setattr(sys.modules[parent], name, sys.modules[packageName])


def yield_lines(strs):
    """Yield non-empty/non-comment lines of a string or sequence"""
    if isinstance(strs, six.string_types):
        for s in strs.splitlines():
            s = s.strip()
            # skip blank lines/comments
            if s and not s.startswith('#'):
                yield s
    else:
        for ss in strs:
            for s in yield_lines(ss):
                yield s


MODULE = re.compile(r"\w+(\.\w+)*$").match
EGG_NAME = re.compile(
    r"""
    (?P<name>[^-]+) (
        -(?P<ver>[^-]+) (
            -py(?P<pyver>[^-]+) (
                -(?P<plat>.+)
            )?
        )?
    )?
    """,
    re.VERBOSE | re.IGNORECASE,
).match


class EntryPoint:
    """Object representing an advertised importable object"""

    def __init__(self, name, module_name, attrs=(), extras=(), dist=None):
        if not MODULE(module_name):
            raise ValueError("Invalid module name", module_name)
        self.name = name
        self.module_name = module_name
        self.attrs = tuple(attrs)
        self.extras = tuple(extras)
        self.dist = dist

    def __str__(self):
        s = "%s = %s" % (self.name, self.module_name)
        if self.attrs:
            s += ':' + '.'.join(self.attrs)
        if self.extras:
            s += ' [%s]' % ','.join(self.extras)
        return s

    def __repr__(self):
        return "EntryPoint.parse(%r)" % str(self)

    def load(self, require=True, *args, **kwargs):
        """
        Require packages for this EntryPoint, then resolve it.
        """
        if not require or args or kwargs:
            warnings.warn(
                "Parameters to load are deprecated.  Call .resolve and "
                ".require separately.",
                PkgResourcesDeprecationWarning,
                stacklevel=2,
            )
        if require:
            self.require(*args, **kwargs)
        return self.resolve()

    def resolve(self):
        """
        Resolve the entry point from its module and attrs.
        """
        module = __import__(self.module_name, fromlist=['__name__'], level=0)
        try:
            return functools.reduce(getattr, self.attrs, module)
        except AttributeError as exc:
            raise ImportError(str(exc))

    def require(self, env=None, installer=None):
        if self.extras and not self.dist:
            raise UnknownExtra("Can't require() without a distribution", self)

        # Get the requirements for this entry point with all its extras and
        # then resolve them. We have to pass `extras` along when resolving so
        # that the working set knows what extras we want. Otherwise, for
        # dist-info distributions, the working set will assume that the
        # requirements for that extra are purely optional and skip over them.
        reqs = self.dist.requires(self.extras)
        items = working_set.resolve(reqs, env, installer, extras=self.extras)
        list(map(working_set.add, items))

    pattern = re.compile(
        r'\s*'
        r'(?P<name>.+?)\s*'
        r'=\s*'
        r'(?P<module>[\w.]+)\s*'
        r'(:\s*(?P<attr>[\w.]+))?\s*'
        r'(?P<extras>\[.*\])?\s*$'
    )

    @classmethod
    def parse(cls, src, dist=None):
        """Parse a single entry point from string `src`

        Entry point syntax follows the form::

            name = some.module:some.attr [extra1, extra2]

        The entry name and module name are required, but the ``:attrs`` and
        ``[extras]`` parts are optional
        """
        m = cls.pattern.match(src)
        if not m:
            msg = "EntryPoint must be in 'name=module:attrs [extras]' format"
            raise ValueError(msg, src)
        res = m.groupdict()
        extras = cls._parse_extras(res['extras'])
        attrs = res['attr'].split('.') if res['attr'] else ()
        return cls(res['name'], res['module'], attrs, extras, dist)

    @classmethod
    def _parse_extras(cls, extras_spec):
        if not extras_spec:
            return ()
        req = Requirement.parse('x' + extras_spec)
        if req.specs:
            raise ValueError()
        return req.extras

    @classmethod
    def parse_group(cls, group, lines, dist=None):
        """Parse an entry point group"""
        if not MODULE(group):
            raise ValueError("Invalid group name", group)
        this = {}
        for line in yield_lines(lines):
            ep = cls.parse(line, dist)
            if ep.name in this:
                raise ValueError("Duplicate entry point", group, ep.name)
            this[ep.name] = ep
        return this

    @classmethod
    def parse_map(cls, data, dist=None):
        """Parse a map of entry point groups"""
        if isinstance(data, dict):
            data = data.items()
        else:
            data = split_sections(data)
        maps = {}
        for group, lines in data:
            if group is None:
                if not lines:
                    continue
                raise ValueError("Entry points must be listed in groups")
            group = group.strip()
            if group in maps:
                raise ValueError("Duplicate group name", group)
            maps[group] = cls.parse_group(group, lines, dist)
        return maps


def _remove_md5_fragment(location):
    if not location:
        return ''
    parsed = urllib.parse.urlparse(location)
    if parsed[-1].startswith('md5='):
        return urllib.parse.urlunparse(parsed[:-1] + ('',))
    return location


def _version_from_file(lines):
    """
    Given an iterable of lines from a Metadata file, return
    the value of the Version field, if present, or None otherwise.
    """
    def is_version_line(line):
        return line.lower().startswith('version:')
    version_lines = filter(is_version_line, lines)
    line = next(iter(version_lines), '')
    _, _, value = line.partition(':')
    return safe_version(value.strip()) or None


class Distribution:
    """Wrap an actual or potential sys.path entry w/metadata"""
    PKG_INFO = 'PKG-INFO'

    def __init__(
            self, location=None, metadata=None, project_name=None,
            version=None, py_version=PY_MAJOR, platform=None,
            precedence=EGG_DIST):
        self.project_name = safe_name(project_name or 'Unknown')
        if version is not None:
            self._version = safe_version(version)
        self.py_version = py_version
        self.platform = platform
        self.location = location
        self.precedence = precedence
        self._provider = metadata or empty_provider

    @classmethod
    def from_location(cls, location, basename, metadata=None, **kw):
        project_name, version, py_version, platform = [None] * 4
        basename, ext = os.path.splitext(basename)
        if ext.lower() in _distributionImpl:
            cls = _distributionImpl[ext.lower()]

            match = EGG_NAME(basename)
            if match:
                project_name, version, py_version, platform = match.group(
                    'name', 'ver', 'pyver', 'plat'
                )
        return cls(
            location, metadata, project_name=project_name, version=version,
            py_version=py_version, platform=platform, **kw
        )._reload_version()

    def _reload_version(self):
        return self

    @property
    def hashcmp(self):
        return (
            self.parsed_version,
            self.precedence,
            self.key,
            _remove_md5_fragment(self.location),
            self.py_version or '',
            self.platform or '',
        )

    def __hash__(self):
        return hash(self.hashcmp)

    def __lt__(self, other):
        return self.hashcmp < other.hashcmp

    def __le__(self, other):
        return self.hashcmp <= other.hashcmp

    def __gt__(self, other):
        return self.hashcmp > other.hashcmp

    def __ge__(self, other):
        return self.hashcmp >= other.hashcmp

    def __eq__(self, other):
        if not isinstance(other, self.__class__):
            # It's not a Distribution, so they are not equal
            return False
        return self.hashcmp == other.hashcmp

    def __ne__(self, other):
        return not self == other

    # These properties have to be lazy so that we don't have to load any
    # metadata until/unless it's actually needed.  (i.e., some distributions
    # may not know their name or version without loading PKG-INFO)

    @property
    def key(self):
        try:
            return self._key
        except AttributeError:
            self._key = key = self.project_name.lower()
            return key

    @property
    def parsed_version(self):
        if not hasattr(self, "_parsed_version"):
            self._parsed_version = parse_version(self.version)

        return self._parsed_version

    def _warn_legacy_version(self):
        LV = packaging.version.LegacyVersion
        is_legacy = isinstance(self._parsed_version, LV)
        if not is_legacy:
            return

        # While an empty version is technically a legacy version and
        # is not a valid PEP 440 version, it's also unlikely to
        # actually come from someone and instead it is more likely that
        # it comes from setuptools attempting to parse a filename and
        # including it in the list. So for that we'll gate this warning
        # on if the version is anything at all or not.
        if not self.version:
            return

        tmpl = textwrap.dedent("""
            '{project_name} ({version})' is being parsed as a legacy,
            non PEP 440,
            version. You may find odd behavior and sort order.
            In particular it will be sorted as less than 0.0. It
            is recommended to migrate to PEP 440 compatible
            versions.
            """).strip().replace('\n', ' ')

        warnings.warn(tmpl.format(**vars(self)), PEP440Warning)

    @property
    def version(self):
        try:
            return self._version
        except AttributeError:
            version = self._get_version()
            if version is None:
                path = self._get_metadata_path_for_display(self.PKG_INFO)
                msg = (
                    "Missing 'Version:' header and/or {} file at path: {}"
                ).format(self.PKG_INFO, path)
                raise ValueError(msg, self)

            return version

    @property
    def _dep_map(self):
        """
        A map of extra to its list of (direct) requirements
        for this distribution, including the null extra.
        """
        try:
            return self.__dep_map
        except AttributeError:
            self.__dep_map = self._filter_extras(self._build_dep_map())
        return self.__dep_map

    @staticmethod
    def _filter_extras(dm):
        """
        Given a mapping of extras to dependencies, strip off
        environment markers and filter out any dependencies
        not matching the markers.
        """
        for extra in list(filter(None, dm)):
            new_extra = extra
            reqs = dm.pop(extra)
            new_extra, _, marker = extra.partition(':')
            fails_marker = marker and (
                invalid_marker(marker)
                or not evaluate_marker(marker)
            )
            if fails_marker:
                reqs = []
            new_extra = safe_extra(new_extra) or None

            dm.setdefault(new_extra, []).extend(reqs)
        return dm

    def _build_dep_map(self):
        dm = {}
        for name in 'requires.txt', 'depends.txt':
            for extra, reqs in split_sections(self._get_metadata(name)):
                dm.setdefault(extra, []).extend(parse_requirements(reqs))
        return dm

    def requires(self, extras=()):
        """List of Requirements needed for this distro if `extras` are used"""
        dm = self._dep_map
        deps = []
        deps.extend(dm.get(None, ()))
        for ext in extras:
            try:
                deps.extend(dm[safe_extra(ext)])
            except KeyError:
                raise UnknownExtra(
                    "%s has no such extra feature %r" % (self, ext)
                )
        return deps

    def _get_metadata_path_for_display(self, name):
        """
        Return the path to the given metadata file, if available.
        """
        try:
            # We need to access _get_metadata_path() on the provider object
            # directly rather than through this class's __getattr__()
            # since _get_metadata_path() is marked private.
            path = self._provider._get_metadata_path(name)

        # Handle exceptions e.g. in case the distribution's metadata
        # provider doesn't support _get_metadata_path().
        except Exception:
            return '[could not detect]'

        return path

    def _get_metadata(self, name):
        if self.has_metadata(name):
            for line in self.get_metadata_lines(name):
                yield line

    def _get_version(self):
        lines = self._get_metadata(self.PKG_INFO)
        version = _version_from_file(lines)

        return version

    def activate(self, path=None, replace=False):
        """Ensure distribution is importable on `path` (default=sys.path)"""
        if path is None:
            path = sys.path
        self.insert_on(path, replace=replace)
        if path is sys.path:
            fixup_namespace_packages(self.location)
            for pkg in self._get_metadata('namespace_packages.txt'):
                if pkg in sys.modules:
                    declare_namespace(pkg)

    def egg_name(self):
        """Return what this distribution's standard .egg filename should be"""
        filename = "%s-%s-py%s" % (
            to_filename(self.project_name), to_filename(self.version),
            self.py_version or PY_MAJOR
        )

        if self.platform:
            filename += '-' + self.platform
        return filename

    def __repr__(self):
        if self.location:
            return "%s (%s)" % (self, self.location)
        else:
            return str(self)

    def __str__(self):
        try:
            version = getattr(self, 'version', None)
        except ValueError:
            version = None
        version = version or "[unknown version]"
        return "%s %s" % (self.project_name, version)

    def __getattr__(self, attr):
        """Delegate all unrecognized public attributes to .metadata provider"""
        if attr.startswith('_'):
            raise AttributeError(attr)
        return getattr(self._provider, attr)

    def __dir__(self):
        return list(
            set(super(Distribution, self).__dir__())
            | set(
                attr for attr in self._provider.__dir__()
                if not attr.startswith('_')
            )
        )

    if not hasattr(object, '__dir__'):
        # python 2.7 not supported
        del __dir__

    @classmethod
    def from_filename(cls, filename, metadata=None, **kw):
        return cls.from_location(
            _normalize_cached(filename), os.path.basename(filename), metadata,
            **kw
        )

    def as_requirement(self):
        """Return a ``Requirement`` that matches this distribution exactly"""
        if isinstance(self.parsed_version, packaging.version.Version):
            spec = "%s==%s" % (self.project_name, self.parsed_version)
        else:
            spec = "%s===%s" % (self.project_name, self.parsed_version)

        return Requirement.parse(spec)

    def load_entry_point(self, group, name):
        """Return the `name` entry point of `group` or raise ImportError"""
        ep = self.get_entry_info(group, name)
        if ep is None:
            raise ImportError("Entry point %r not found" % ((group, name),))
        return ep.load()

    def get_entry_map(self, group=None):
        """Return the entry point map for `group`, or the full entry map"""
        try:
            ep_map = self._ep_map
        except AttributeError:
            ep_map = self._ep_map = EntryPoint.parse_map(
                self._get_metadata('entry_points.txt'), self
            )
        if group is not None:
            return ep_map.get(group, {})
        return ep_map

    def get_entry_info(self, group, name):
        """Return the EntryPoint object for `group`+`name`, or ``None``"""
        return self.get_entry_map(group).get(name)

    def insert_on(self, path, loc=None, replace=False):
        """Ensure self.location is on path

        If replace=False (default):
            - If location is already in path anywhere, do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent.
              - Else: add to the end of path.
        If replace=True:
            - If location is already on path anywhere (not eggs)
              or higher priority than its parent (eggs)
              do nothing.
            - Else:
              - If it's an egg and its parent directory is on path,
                insert just ahead of the parent,
                removing any lower-priority entries.
              - Else: add it to the front of path.
        """

        loc = loc or self.location
        if not loc:
            return

        nloc = _normalize_cached(loc)
        bdir = os.path.dirname(nloc)
        npath = [(p and _normalize_cached(p) or p) for p in path]

        for p, item in enumerate(npath):
            if item == nloc:
                if replace:
                    break
                else:
                    # don't modify path (even removing duplicates) if
                    # found and not replace
                    return
            elif item == bdir and self.precedence == EGG_DIST:
                # if it's an .egg, give it precedence over its directory
                # UNLESS it's already been added to sys.path and replace=False
                if (not replace) and nloc in npath[p:]:
                    return
                if path is sys.path:
                    self.check_version_conflict()
                path.insert(p, loc)
                npath.insert(p, nloc)
                break
        else:
            if path is sys.path:
                self.check_version_conflict()
            if replace:
                path.insert(0, loc)
            else:
                path.append(loc)
            return

        # p is the spot where we found or inserted loc; now remove duplicates
        while True:
            try:
                np = npath.index(nloc, p + 1)
            except ValueError:
                break
            else:
                del npath[np], path[np]
                # ha!
                p = np

        return

    def check_version_conflict(self):
        if self.key == 'setuptools':
            # ignore the inevitable setuptools self-conflicts  :(
            return

        nsp = dict.fromkeys(self._get_metadata('namespace_packages.txt'))
        loc = normalize_path(self.location)
        for modname in self._get_metadata('top_level.txt'):
            if (modname not in sys.modules or modname in nsp
                    or modname in _namespace_packages):
                continue
            if modname in ('pkg_resources', 'setuptools', 'site'):
                continue
            fn = getattr(sys.modules[modname], '__file__', None)
            if fn and (normalize_path(fn).startswith(loc) or
                       fn.startswith(self.location)):
                continue
            issue_warning(
                "Module %s was already imported from %s, but %s is being added"
                " to sys.path" % (modname, fn, self.location),
            )

    def has_version(self):
        try:
            self.version
        except ValueError:
            issue_warning("Unbuilt egg for " + repr(self))
            return False
        return True

    def clone(self, **kw):
        """Copy this distribution, substituting in any changed keyword args"""
        names = 'project_name version py_version platform location precedence'
        for attr in names.split():
            kw.setdefault(attr, getattr(self, attr, None))
        kw.setdefault('metadata', self._provider)
        return self.__class__(**kw)

    @property
    def extras(self):
        return [dep for dep in self._dep_map if dep]


class EggInfoDistribution(Distribution):
    def _reload_version(self):
        """
        Packages installed by distutils (e.g. numpy or scipy),
        which uses an old safe_version, and so
        their version numbers can get mangled when
        converted to filenames (e.g., 1.11.0.dev0+2329eae to
        1.11.0.dev0_2329eae). These distributions will not be
        parsed properly
        downstream by Distribution and safe_version, so
        take an extra step and try to get the version number from
        the metadata file itself instead of the filename.
        """
        md_version = self._get_version()
        if md_version:
            self._version = md_version
        return self


class DistInfoDistribution(Distribution):
    """
    Wrap an actual or potential sys.path entry
    w/metadata, .dist-info style.
    """
    PKG_INFO = 'METADATA'
    EQEQ = re.compile(r"([\(,])\s*(\d.*?)\s*([,\)])")

    @property
    def _parsed_pkg_info(self):
        """Parse and cache metadata"""
        try:
            return self._pkg_info
        except AttributeError:
            metadata = self.get_metadata(self.PKG_INFO)
            self._pkg_info = email.parser.Parser().parsestr(metadata)
            return self._pkg_info

    @property
    def _dep_map(self):
        try:
            return self.__dep_map
        except AttributeError:
            self.__dep_map = self._compute_dependencies()
            return self.__dep_map

    def _compute_dependencies(self):
        """Recompute this distribution's dependencies."""
        dm = self.__dep_map = {None: []}

        reqs = []
        # Including any condition expressions
        for req in self._parsed_pkg_info.get_all('Requires-Dist') or []:
            reqs.extend(parse_requirements(req))

        def reqs_for_extra(extra):
            for req in reqs:
                if not req.marker or req.marker.evaluate({'extra': extra}):
                    yield req

        common = frozenset(reqs_for_extra(None))
        dm[None].extend(common)

        for extra in self._parsed_pkg_info.get_all('Provides-Extra') or []:
            s_extra = safe_extra(extra.strip())
            dm[s_extra] = list(frozenset(reqs_for_extra(extra)) - common)

        return dm


_distributionImpl = {
    '.egg': Distribution,
    '.egg-info': EggInfoDistribution,
    '.dist-info': DistInfoDistribution,
}


def issue_warning(*args, **kw):
    level = 1
    g = globals()
    try:
        # find the first stack frame that is *not* code in
        # the pkg_resources module, to use for the warning
        while sys._getframe(level).f_globals is g:
            level += 1
    except ValueError:
        pass
    warnings.warn(stacklevel=level + 1, *args, **kw)


class RequirementParseError(ValueError):
    def __str__(self):
        return ' '.join(self.args)


def parse_requirements(strs):
    """Yield ``Requirement`` objects for each specification in `strs`

    `strs` must be a string, or a (possibly-nested) iterable thereof.
    """
    # create a steppable iterator, so we can handle \-continuations
    lines = iter(yield_lines(strs))

    for line in lines:
        # Drop comments -- a hash without a space may be in a URL.
        if ' #' in line:
            line = line[:line.find(' #')]
        # If there is a line continuation, drop it, and append the next line.
        if line.endswith('\\'):
            line = line[:-2].strip()
            try:
                line += next(lines)
            except StopIteration:
                return
        yield Requirement(line)


class Requirement(packaging.requirements.Requirement):
    def __init__(self, requirement_string):
        """DO NOT CALL THIS UNDOCUMENTED METHOD; use Requirement.parse()!"""
        try:
            super(Requirement, self).__init__(requirement_string)
        except packaging.requirements.InvalidRequirement as e:
            raise RequirementParseError(str(e))
        self.unsafe_name = self.name
        project_name = safe_name(self.name)
        self.project_name, self.key = project_name, project_name.lower()
        self.specs = [
            (spec.operator, spec.version) for spec in self.specifier]
        self.extras = tuple(map(safe_extra, self.extras))
        self.hashCmp = (
            self.key,
            self.url,
            self.specifier,
            frozenset(self.extras),
            str(self.marker) if self.marker else None,
        )
        self.__hash = hash(self.hashCmp)

    def __eq__(self, other):
        return (
            isinstance(other, Requirement) and
            self.hashCmp == other.hashCmp
        )

    def __ne__(self, other):
        return not self == other

    def __contains__(self, item):
        if isinstance(item, Distribution):
            if item.key != self.key:
                return False

            item = item.version

        # Allow prereleases always in order to match the previous behavior of
        # this method. In the future this should be smarter and follow PEP 440
        # more accurately.
        return self.specifier.contains(item, prereleases=True)

    def __hash__(self):
        return self.__hash

    def __repr__(self):
        return "Requirement.parse(%r)" % str(self)

    @staticmethod
    def parse(s):
        req, = parse_requirements(s)
        return req


def _always_object(classes):
    """
    Ensure object appears in the mro even
    for old-style classes.
    """
    if object not in classes:
        return classes + (object,)
    return classes


def _find_adapter(registry, ob):
    """Return an adapter factory for `ob` from `registry`"""
    types = _always_object(inspect.getmro(getattr(ob, '__class__', type(ob))))
    for t in types:
        if t in registry:
            return registry[t]


def ensure_directory(path):
    """Ensure that the parent directory of `path` exists"""
    dirname = os.path.dirname(path)
    py31compat.makedirs(dirname, exist_ok=True)


def _bypass_ensure_directory(path):
    """Sandbox-bypassing version of ensure_directory()"""
    if not WRITE_SUPPORT:
        raise IOError('"os.mkdir" not supported on this platform.')
    dirname, filename = split(path)
    if dirname and filename and not isdir(dirname):
        _bypass_ensure_directory(dirname)
        try:
            mkdir(dirname, 0o755)
        except FileExistsError:
            pass


def split_sections(s):
    """Split a string or iterable thereof into (section, content) pairs

    Each ``section`` is a stripped version of the section header ("[section]")
    and each ``content`` is a list of stripped lines excluding blank lines and
    comment-only lines.  If there are any such lines before the first section
    header, they're returned in a first ``section`` of ``None``.
    """
    section = None
    content = []
    for line in yield_lines(s):
        if line.startswith("["):
            if line.endswith("]"):
                if section or content:
                    yield section, content
                section = line[1:-1].strip()
                content = []
            else:
                raise ValueError("Invalid section heading", line)
        else:
            content.append(line)

    # wrap up last segment
    yield section, content


def _mkstemp(*args, **kw):
    old_open = os.open
    try:
        # temporarily bypass sandboxing
        os.open = os_open
        return tempfile.mkstemp(*args, **kw)
    finally:
        # and then put it back
        os.open = old_open


# Silence the PEP440Warning by default, so that end users don't get hit by it
# randomly just because they use pkg_resources. We want to append the rule
# because we want earlier uses of filterwarnings to take precedence over this
# one.
warnings.filterwarnings("ignore", category=PEP440Warning, append=True)


# from jaraco.functools 1.3
def _call_aside(f, *args, **kwargs):
    f(*args, **kwargs)
    return f


@_call_aside
def _initialize(g=globals()):
    "Set up global resource manager (deliberately not state-saved)"
    manager = ResourceManager()
    g['_manager'] = manager
    g.update(
        (name, getattr(manager, name))
        for name in dir(manager)
        if not name.startswith('_')
    )


@_call_aside
def _initialize_master_working_set():
    """
    Prepare the master working set and make the ``require()``
    API available.

    This function has explicit effects on the global state
    of pkg_resources. It is intended to be invoked once at
    the initialization of this module.

    Invocation by other packages is unsupported and done
    at their own risk.
    """
    working_set = WorkingSet._build_master()
    _declare_state('object', working_set=working_set)

    require = working_set.require
    iter_entry_points = working_set.iter_entry_points
    add_activation_listener = working_set.subscribe
    run_script = working_set.run_script
    # backward compatibility
    run_main = run_script
    # Activate all distributions already on sys.path with replace=False and
    # ensure that all distributions added to the working set in the future
    # (e.g. by calling ``require()``) will get activated as well,
    # with higher priority (replace=True).
    tuple(
        dist.activate(replace=False)
        for dist in working_set
    )
    add_activation_listener(
        lambda dist: dist.activate(replace=True),
        existing=False,
    )
    working_set.entries = []
    # match order
    list(map(working_set.add_entry, sys.path))
    globals().update(locals())

class PkgResourcesDeprecationWarning(Warning):
    """
    Base class for warning about deprecations in ``pkg_resources``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    """
site-packages/pkg_resources/_vendor/packaging/_compat.py000064400000001534151446177000017523 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import sys


PY2 = sys.version_info[0] == 2
PY3 = sys.version_info[0] == 3

# flake8: noqa

if PY3:
    string_types = str,
else:
    string_types = basestring,


def with_metaclass(meta, *bases):
    """
    Create a base class with a metaclass.
    """
    # This requires a bit of explanation: the basic idea is to make a dummy
    # metaclass for one level of class instantiation that replaces itself with
    # the actual metaclass.
    class metaclass(meta):
        def __new__(cls, name, this_bases, d):
            return meta(name, bases, d)
    return type.__new__(metaclass, 'temporary_class', (), {})
site-packages/pkg_resources/_vendor/packaging/version.py000064400000026444151446177000017575 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import collections
import itertools
import re

from ._structures import Infinity


__all__ = [
    "parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"
]


_Version = collections.namedtuple(
    "_Version",
    ["epoch", "release", "dev", "pre", "post", "local"],
)


def parse(version):
    """
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    """
    try:
        return Version(version)
    except InvalidVersion:
        return LegacyVersion(version)


class InvalidVersion(ValueError):
    """
    An invalid version was found, users should refer to PEP 440.
    """


class _BaseVersion(object):

    def __hash__(self):
        return hash(self._key)

    def __lt__(self, other):
        return self._compare(other, lambda s, o: s < o)

    def __le__(self, other):
        return self._compare(other, lambda s, o: s <= o)

    def __eq__(self, other):
        return self._compare(other, lambda s, o: s == o)

    def __ge__(self, other):
        return self._compare(other, lambda s, o: s >= o)

    def __gt__(self, other):
        return self._compare(other, lambda s, o: s > o)

    def __ne__(self, other):
        return self._compare(other, lambda s, o: s != o)

    def _compare(self, other, method):
        if not isinstance(other, _BaseVersion):
            return NotImplemented

        return method(self._key, other._key)


class LegacyVersion(_BaseVersion):

    def __init__(self, version):
        self._version = str(version)
        self._key = _legacy_cmpkey(self._version)

    def __str__(self):
        return self._version

    def __repr__(self):
        return "<LegacyVersion({0})>".format(repr(str(self)))

    @property
    def public(self):
        return self._version

    @property
    def base_version(self):
        return self._version

    @property
    def local(self):
        return None

    @property
    def is_prerelease(self):
        return False

    @property
    def is_postrelease(self):
        return False


_legacy_version_component_re = re.compile(
    r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE,
)

_legacy_version_replacement_map = {
    "pre": "c", "preview": "c", "-": "final-", "rc": "c", "dev": "@",
}


def _parse_version_parts(s):
    for part in _legacy_version_component_re.split(s):
        part = _legacy_version_replacement_map.get(part, part)

        if not part or part == ".":
            continue

        if part[:1] in "0123456789":
            # pad for numeric comparison
            yield part.zfill(8)
        else:
            yield "*" + part

    # ensure that alpha/beta/candidate are before final
    yield "*final"


def _legacy_cmpkey(version):
    # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch
    # greater than or equal to 0. This will effectively put the LegacyVersion,
    # which uses the defacto standard originally implemented by setuptools,
    # as before all PEP 440 versions.
    epoch = -1

    # This scheme is taken from pkg_resources.parse_version setuptools prior to
    # it's adoption of the packaging library.
    parts = []
    for part in _parse_version_parts(version.lower()):
        if part.startswith("*"):
            # remove "-" before a prerelease tag
            if part < "*final":
                while parts and parts[-1] == "*final-":
                    parts.pop()

            # remove trailing zeros from each series of numeric parts
            while parts and parts[-1] == "00000000":
                parts.pop()

        parts.append(part)
    parts = tuple(parts)

    return epoch, parts

# Deliberately not anchored to the start and end of the string, to make it
# easier for 3rd party code to reuse
VERSION_PATTERN = r"""
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
"""


class Version(_BaseVersion):

    _regex = re.compile(
        r"^\s*" + VERSION_PATTERN + r"\s*$",
        re.VERBOSE | re.IGNORECASE,
    )

    def __init__(self, version):
        # Validate the version and parse it into pieces
        match = self._regex.search(version)
        if not match:
            raise InvalidVersion("Invalid version: '{0}'".format(version))

        # Store the parsed out pieces of the version
        self._version = _Version(
            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
            release=tuple(int(i) for i in match.group("release").split(".")),
            pre=_parse_letter_version(
                match.group("pre_l"),
                match.group("pre_n"),
            ),
            post=_parse_letter_version(
                match.group("post_l"),
                match.group("post_n1") or match.group("post_n2"),
            ),
            dev=_parse_letter_version(
                match.group("dev_l"),
                match.group("dev_n"),
            ),
            local=_parse_local_version(match.group("local")),
        )

        # Generate a key which will be used for sorting
        self._key = _cmpkey(
            self._version.epoch,
            self._version.release,
            self._version.pre,
            self._version.post,
            self._version.dev,
            self._version.local,
        )

    def __repr__(self):
        return "<Version({0})>".format(repr(str(self)))

    def __str__(self):
        parts = []

        # Epoch
        if self._version.epoch != 0:
            parts.append("{0}!".format(self._version.epoch))

        # Release segment
        parts.append(".".join(str(x) for x in self._version.release))

        # Pre-release
        if self._version.pre is not None:
            parts.append("".join(str(x) for x in self._version.pre))

        # Post-release
        if self._version.post is not None:
            parts.append(".post{0}".format(self._version.post[1]))

        # Development release
        if self._version.dev is not None:
            parts.append(".dev{0}".format(self._version.dev[1]))

        # Local version segment
        if self._version.local is not None:
            parts.append(
                "+{0}".format(".".join(str(x) for x in self._version.local))
            )

        return "".join(parts)

    @property
    def public(self):
        return str(self).split("+", 1)[0]

    @property
    def base_version(self):
        parts = []

        # Epoch
        if self._version.epoch != 0:
            parts.append("{0}!".format(self._version.epoch))

        # Release segment
        parts.append(".".join(str(x) for x in self._version.release))

        return "".join(parts)

    @property
    def local(self):
        version_string = str(self)
        if "+" in version_string:
            return version_string.split("+", 1)[1]

    @property
    def is_prerelease(self):
        return bool(self._version.dev or self._version.pre)

    @property
    def is_postrelease(self):
        return bool(self._version.post)


def _parse_letter_version(letter, number):
    if letter:
        # We consider there to be an implicit 0 in a pre-release if there is
        # not a numeral associated with it.
        if number is None:
            number = 0

        # We normalize any letters to their lower case form
        letter = letter.lower()

        # We consider some words to be alternate spellings of other words and
        # in those cases we want to normalize the spellings to our preferred
        # spelling.
        if letter == "alpha":
            letter = "a"
        elif letter == "beta":
            letter = "b"
        elif letter in ["c", "pre", "preview"]:
            letter = "rc"
        elif letter in ["rev", "r"]:
            letter = "post"

        return letter, int(number)
    if not letter and number:
        # We assume if we are given a number, but we are not given a letter
        # then this is using the implicit post release syntax (e.g. 1.0-1)
        letter = "post"

        return letter, int(number)


_local_version_seperators = re.compile(r"[\._-]")


def _parse_local_version(local):
    """
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    """
    if local is not None:
        return tuple(
            part.lower() if not part.isdigit() else int(part)
            for part in _local_version_seperators.split(local)
        )


def _cmpkey(epoch, release, pre, post, dev, local):
    # When we compare a release version, we want to compare it with all of the
    # trailing zeros removed. So we'll use a reverse the list, drop all the now
    # leading zeros until we come to something non zero, then take the rest
    # re-reverse it back into the correct order and make it a tuple and use
    # that for our sorting key.
    release = tuple(
        reversed(list(
            itertools.dropwhile(
                lambda x: x == 0,
                reversed(release),
            )
        ))
    )

    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
    # We'll do this by abusing the pre segment, but we _only_ want to do this
    # if there is not a pre or a post segment. If we have one of those then
    # the normal sorting rules will handle this case correctly.
    if pre is None and post is None and dev is not None:
        pre = -Infinity
    # Versions without a pre-release (except as noted above) should sort after
    # those with one.
    elif pre is None:
        pre = Infinity

    # Versions without a post segment should sort before those with one.
    if post is None:
        post = -Infinity

    # Versions without a development segment should sort after those with one.
    if dev is None:
        dev = Infinity

    if local is None:
        # Versions without a local segment should sort before those with one.
        local = -Infinity
    else:
        # Versions with a local segment need that segment parsed to implement
        # the sorting rules in PEP440.
        # - Alpha numeric segments sort before numeric segments
        # - Alpha numeric segments sort lexicographically
        # - Numeric segments sort numerically
        # - Shorter versions sort before longer versions when the prefixes
        #   match exactly
        local = tuple(
            (i, "") if isinstance(i, int) else (-Infinity, i)
            for i in local
        )

    return epoch, release, pre, post, dev, local
site-packages/pkg_resources/_vendor/packaging/utils.py000064400000000645151446177000017243 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import re


_canonicalize_regex = re.compile(r"[-_.]+")


def canonicalize_name(name):
    # This is taken from PEP 503.
    return _canonicalize_regex.sub("-", name).lower()
site-packages/pkg_resources/_vendor/packaging/__about__.py000064400000001320151446177000020000 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

__all__ = [
    "__title__", "__summary__", "__uri__", "__version__", "__author__",
    "__email__", "__license__", "__copyright__",
]

__title__ = "packaging"
__summary__ = "Core utilities for Python packages"
__uri__ = "https://github.com/pypa/packaging"

__version__ = "16.8"

__author__ = "Donald Stufft and individual contributors"
__email__ = "donald@stufft.io"

__license__ = "BSD or Apache License, Version 2.0"
__copyright__ = "Copyright 2014-2016 %s" % __author__
site-packages/pkg_resources/_vendor/packaging/specifiers.py000064400000066571151446177000020251 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import abc
import functools
import itertools
import re

from ._compat import string_types, with_metaclass
from .version import Version, LegacyVersion, parse


class InvalidSpecifier(ValueError):
    """
    An invalid specifier was found, users should refer to PEP 440.
    """


class BaseSpecifier(with_metaclass(abc.ABCMeta, object)):

    @abc.abstractmethod
    def __str__(self):
        """
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        """

    @abc.abstractmethod
    def __hash__(self):
        """
        Returns a hash value for this Specifier like object.
        """

    @abc.abstractmethod
    def __eq__(self, other):
        """
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        """

    @abc.abstractmethod
    def __ne__(self, other):
        """
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        """

    @abc.abstractproperty
    def prereleases(self):
        """
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        """

    @prereleases.setter
    def prereleases(self, value):
        """
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        """

    @abc.abstractmethod
    def contains(self, item, prereleases=None):
        """
        Determines if the given item is contained within this specifier.
        """

    @abc.abstractmethod
    def filter(self, iterable, prereleases=None):
        """
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        """


class _IndividualSpecifier(BaseSpecifier):

    _operators = {}

    def __init__(self, spec="", prereleases=None):
        match = self._regex.search(spec)
        if not match:
            raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec))

        self._spec = (
            match.group("operator").strip(),
            match.group("version").strip(),
        )

        # Store whether or not this Specifier should accept prereleases
        self._prereleases = prereleases

    def __repr__(self):
        pre = (
            ", prereleases={0!r}".format(self.prereleases)
            if self._prereleases is not None
            else ""
        )

        return "<{0}({1!r}{2})>".format(
            self.__class__.__name__,
            str(self),
            pre,
        )

    def __str__(self):
        return "{0}{1}".format(*self._spec)

    def __hash__(self):
        return hash(self._spec)

    def __eq__(self, other):
        if isinstance(other, string_types):
            try:
                other = self.__class__(other)
            except InvalidSpecifier:
                return NotImplemented
        elif not isinstance(other, self.__class__):
            return NotImplemented

        return self._spec == other._spec

    def __ne__(self, other):
        if isinstance(other, string_types):
            try:
                other = self.__class__(other)
            except InvalidSpecifier:
                return NotImplemented
        elif not isinstance(other, self.__class__):
            return NotImplemented

        return self._spec != other._spec

    def _get_operator(self, op):
        return getattr(self, "_compare_{0}".format(self._operators[op]))

    def _coerce_version(self, version):
        if not isinstance(version, (LegacyVersion, Version)):
            version = parse(version)
        return version

    @property
    def operator(self):
        return self._spec[0]

    @property
    def version(self):
        return self._spec[1]

    @property
    def prereleases(self):
        return self._prereleases

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value

    def __contains__(self, item):
        return self.contains(item)

    def contains(self, item, prereleases=None):
        # Determine if prereleases are to be allowed or not.
        if prereleases is None:
            prereleases = self.prereleases

        # Normalize item to a Version or LegacyVersion, this allows us to have
        # a shortcut for ``"2.0" in Specifier(">=2")
        item = self._coerce_version(item)

        # Determine if we should be supporting prereleases in this specifier
        # or not, if we do not support prereleases than we can short circuit
        # logic if this version is a prereleases.
        if item.is_prerelease and not prereleases:
            return False

        # Actually do the comparison to determine if this item is contained
        # within this Specifier or not.
        return self._get_operator(self.operator)(item, self.version)

    def filter(self, iterable, prereleases=None):
        yielded = False
        found_prereleases = []

        kw = {"prereleases": prereleases if prereleases is not None else True}

        # Attempt to iterate over all the values in the iterable and if any of
        # them match, yield them.
        for version in iterable:
            parsed_version = self._coerce_version(version)

            if self.contains(parsed_version, **kw):
                # If our version is a prerelease, and we were not set to allow
                # prereleases, then we'll store it for later incase nothing
                # else matches this specifier.
                if (parsed_version.is_prerelease and not
                        (prereleases or self.prereleases)):
                    found_prereleases.append(version)
                # Either this is not a prerelease, or we should have been
                # accepting prereleases from the begining.
                else:
                    yielded = True
                    yield version

        # Now that we've iterated over everything, determine if we've yielded
        # any values, and if we have not and we have any prereleases stored up
        # then we will go ahead and yield the prereleases.
        if not yielded and found_prereleases:
            for version in found_prereleases:
                yield version


class LegacySpecifier(_IndividualSpecifier):

    _regex_str = (
        r"""
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        """
    )

    _regex = re.compile(
        r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)

    _operators = {
        "==": "equal",
        "!=": "not_equal",
        "<=": "less_than_equal",
        ">=": "greater_than_equal",
        "<": "less_than",
        ">": "greater_than",
    }

    def _coerce_version(self, version):
        if not isinstance(version, LegacyVersion):
            version = LegacyVersion(str(version))
        return version

    def _compare_equal(self, prospective, spec):
        return prospective == self._coerce_version(spec)

    def _compare_not_equal(self, prospective, spec):
        return prospective != self._coerce_version(spec)

    def _compare_less_than_equal(self, prospective, spec):
        return prospective <= self._coerce_version(spec)

    def _compare_greater_than_equal(self, prospective, spec):
        return prospective >= self._coerce_version(spec)

    def _compare_less_than(self, prospective, spec):
        return prospective < self._coerce_version(spec)

    def _compare_greater_than(self, prospective, spec):
        return prospective > self._coerce_version(spec)


def _require_version_compare(fn):
    @functools.wraps(fn)
    def wrapped(self, prospective, spec):
        if not isinstance(prospective, Version):
            return False
        return fn(self, prospective, spec)
    return wrapped


class Specifier(_IndividualSpecifier):

    _regex_str = (
        r"""
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        """
    )

    _regex = re.compile(
        r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)

    _operators = {
        "~=": "compatible",
        "==": "equal",
        "!=": "not_equal",
        "<=": "less_than_equal",
        ">=": "greater_than_equal",
        "<": "less_than",
        ">": "greater_than",
        "===": "arbitrary",
    }

    @_require_version_compare
    def _compare_compatible(self, prospective, spec):
        # Compatible releases have an equivalent combination of >= and ==. That
        # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
        # implement this in terms of the other specifiers instead of
        # implementing it ourselves. The only thing we need to do is construct
        # the other specifiers.

        # We want everything but the last item in the version, but we want to
        # ignore post and dev releases and we want to treat the pre-release as
        # it's own separate segment.
        prefix = ".".join(
            list(
                itertools.takewhile(
                    lambda x: (not x.startswith("post") and not
                               x.startswith("dev")),
                    _version_split(spec),
                )
            )[:-1]
        )

        # Add the prefix notation to the end of our string
        prefix += ".*"

        return (self._get_operator(">=")(prospective, spec) and
                self._get_operator("==")(prospective, prefix))

    @_require_version_compare
    def _compare_equal(self, prospective, spec):
        # We need special logic to handle prefix matching
        if spec.endswith(".*"):
            # In the case of prefix matching we want to ignore local segment.
            prospective = Version(prospective.public)
            # Split the spec out by dots, and pretend that there is an implicit
            # dot in between a release segment and a pre-release segment.
            spec = _version_split(spec[:-2])  # Remove the trailing .*

            # Split the prospective version out by dots, and pretend that there
            # is an implicit dot in between a release segment and a pre-release
            # segment.
            prospective = _version_split(str(prospective))

            # Shorten the prospective version to be the same length as the spec
            # so that we can determine if the specifier is a prefix of the
            # prospective version or not.
            prospective = prospective[:len(spec)]

            # Pad out our two sides with zeros so that they both equal the same
            # length.
            spec, prospective = _pad_version(spec, prospective)
        else:
            # Convert our spec string into a Version
            spec = Version(spec)

            # If the specifier does not have a local segment, then we want to
            # act as if the prospective version also does not have a local
            # segment.
            if not spec.local:
                prospective = Version(prospective.public)

        return prospective == spec

    @_require_version_compare
    def _compare_not_equal(self, prospective, spec):
        return not self._compare_equal(prospective, spec)

    @_require_version_compare
    def _compare_less_than_equal(self, prospective, spec):
        return prospective <= Version(spec)

    @_require_version_compare
    def _compare_greater_than_equal(self, prospective, spec):
        return prospective >= Version(spec)

    @_require_version_compare
    def _compare_less_than(self, prospective, spec):
        # Convert our spec to a Version instance, since we'll want to work with
        # it as a version.
        spec = Version(spec)

        # Check to see if the prospective version is less than the spec
        # version. If it's not we can short circuit and just return False now
        # instead of doing extra unneeded work.
        if not prospective < spec:
            return False

        # This special case is here so that, unless the specifier itself
        # includes is a pre-release version, that we do not accept pre-release
        # versions for the version mentioned in the specifier (e.g. <3.1 should
        # not match 3.1.dev0, but should match 3.0.dev0).
        if not spec.is_prerelease and prospective.is_prerelease:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # If we've gotten to here, it means that prospective version is both
        # less than the spec version *and* it's not a pre-release of the same
        # version in the spec.
        return True

    @_require_version_compare
    def _compare_greater_than(self, prospective, spec):
        # Convert our spec to a Version instance, since we'll want to work with
        # it as a version.
        spec = Version(spec)

        # Check to see if the prospective version is greater than the spec
        # version. If it's not we can short circuit and just return False now
        # instead of doing extra unneeded work.
        if not prospective > spec:
            return False

        # This special case is here so that, unless the specifier itself
        # includes is a post-release version, that we do not accept
        # post-release versions for the version mentioned in the specifier
        # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0).
        if not spec.is_postrelease and prospective.is_postrelease:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # Ensure that we do not allow a local version of the version mentioned
        # in the specifier, which is techincally greater than, to match.
        if prospective.local is not None:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # If we've gotten to here, it means that prospective version is both
        # greater than the spec version *and* it's not a pre-release of the
        # same version in the spec.
        return True

    def _compare_arbitrary(self, prospective, spec):
        return str(prospective).lower() == str(spec).lower()

    @property
    def prereleases(self):
        # If there is an explicit prereleases set for this, then we'll just
        # blindly use that.
        if self._prereleases is not None:
            return self._prereleases

        # Look at all of our specifiers and determine if they are inclusive
        # operators, and if they are if they are including an explicit
        # prerelease.
        operator, version = self._spec
        if operator in ["==", ">=", "<=", "~=", "==="]:
            # The == specifier can include a trailing .*, if it does we
            # want to remove before parsing.
            if operator == "==" and version.endswith(".*"):
                version = version[:-2]

            # Parse the version, and if it is a pre-release than this
            # specifier allows pre-releases.
            if parse(version).is_prerelease:
                return True

        return False

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value


_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")


def _version_split(version):
    result = []
    for item in version.split("."):
        match = _prefix_regex.search(item)
        if match:
            result.extend(match.groups())
        else:
            result.append(item)
    return result


def _pad_version(left, right):
    left_split, right_split = [], []

    # Get the release segment of our versions
    left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left)))
    right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right)))

    # Get the rest of our versions
    left_split.append(left[len(left_split[0]):])
    right_split.append(right[len(right_split[0]):])

    # Insert our padding
    left_split.insert(
        1,
        ["0"] * max(0, len(right_split[0]) - len(left_split[0])),
    )
    right_split.insert(
        1,
        ["0"] * max(0, len(left_split[0]) - len(right_split[0])),
    )

    return (
        list(itertools.chain(*left_split)),
        list(itertools.chain(*right_split)),
    )


class SpecifierSet(BaseSpecifier):

    def __init__(self, specifiers="", prereleases=None):
        # Split on , to break each indidivual specifier into it's own item, and
        # strip each item to remove leading/trailing whitespace.
        specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]

        # Parsed each individual specifier, attempting first to make it a
        # Specifier and falling back to a LegacySpecifier.
        parsed = set()
        for specifier in specifiers:
            try:
                parsed.add(Specifier(specifier))
            except InvalidSpecifier:
                parsed.add(LegacySpecifier(specifier))

        # Turn our parsed specifiers into a frozen set and save them for later.
        self._specs = frozenset(parsed)

        # Store our prereleases value so we can use it later to determine if
        # we accept prereleases or not.
        self._prereleases = prereleases

    def __repr__(self):
        pre = (
            ", prereleases={0!r}".format(self.prereleases)
            if self._prereleases is not None
            else ""
        )

        return "<SpecifierSet({0!r}{1})>".format(str(self), pre)

    def __str__(self):
        return ",".join(sorted(str(s) for s in self._specs))

    def __hash__(self):
        return hash(self._specs)

    def __and__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        specifier = SpecifierSet()
        specifier._specs = frozenset(self._specs | other._specs)

        if self._prereleases is None and other._prereleases is not None:
            specifier._prereleases = other._prereleases
        elif self._prereleases is not None and other._prereleases is None:
            specifier._prereleases = self._prereleases
        elif self._prereleases == other._prereleases:
            specifier._prereleases = self._prereleases
        else:
            raise ValueError(
                "Cannot combine SpecifierSets with True and False prerelease "
                "overrides."
            )

        return specifier

    def __eq__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif isinstance(other, _IndividualSpecifier):
            other = SpecifierSet(str(other))
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        return self._specs == other._specs

    def __ne__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif isinstance(other, _IndividualSpecifier):
            other = SpecifierSet(str(other))
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        return self._specs != other._specs

    def __len__(self):
        return len(self._specs)

    def __iter__(self):
        return iter(self._specs)

    @property
    def prereleases(self):
        # If we have been given an explicit prerelease modifier, then we'll
        # pass that through here.
        if self._prereleases is not None:
            return self._prereleases

        # If we don't have any specifiers, and we don't have a forced value,
        # then we'll just return None since we don't know if this should have
        # pre-releases or not.
        if not self._specs:
            return None

        # Otherwise we'll see if any of the given specifiers accept
        # prereleases, if any of them do we'll return True, otherwise False.
        return any(s.prereleases for s in self._specs)

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value

    def __contains__(self, item):
        return self.contains(item)

    def contains(self, item, prereleases=None):
        # Ensure that our item is a Version or LegacyVersion instance.
        if not isinstance(item, (LegacyVersion, Version)):
            item = parse(item)

        # Determine if we're forcing a prerelease or not, if we're not forcing
        # one for this particular filter call, then we'll use whatever the
        # SpecifierSet thinks for whether or not we should support prereleases.
        if prereleases is None:
            prereleases = self.prereleases

        # We can determine if we're going to allow pre-releases by looking to
        # see if any of the underlying items supports them. If none of them do
        # and this item is a pre-release then we do not allow it and we can
        # short circuit that here.
        # Note: This means that 1.0.dev1 would not be contained in something
        #       like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0
        if not prereleases and item.is_prerelease:
            return False

        # We simply dispatch to the underlying specs here to make sure that the
        # given version is contained within all of them.
        # Note: This use of all() here means that an empty set of specifiers
        #       will always return True, this is an explicit design decision.
        return all(
            s.contains(item, prereleases=prereleases)
            for s in self._specs
        )

    def filter(self, iterable, prereleases=None):
        # Determine if we're forcing a prerelease or not, if we're not forcing
        # one for this particular filter call, then we'll use whatever the
        # SpecifierSet thinks for whether or not we should support prereleases.
        if prereleases is None:
            prereleases = self.prereleases

        # If we have any specifiers, then we want to wrap our iterable in the
        # filter method for each one, this will act as a logical AND amongst
        # each specifier.
        if self._specs:
            for spec in self._specs:
                iterable = spec.filter(iterable, prereleases=bool(prereleases))
            return iterable
        # If we do not have any specifiers, then we need to have a rough filter
        # which will filter out any pre-releases, unless there are no final
        # releases, and which will filter out LegacyVersion in general.
        else:
            filtered = []
            found_prereleases = []

            for item in iterable:
                # Ensure that we some kind of Version class for this item.
                if not isinstance(item, (LegacyVersion, Version)):
                    parsed_version = parse(item)
                else:
                    parsed_version = item

                # Filter out any item which is parsed as a LegacyVersion
                if isinstance(parsed_version, LegacyVersion):
                    continue

                # Store any item which is a pre-release for later unless we've
                # already found a final version or we are accepting prereleases
                if parsed_version.is_prerelease and not prereleases:
                    if not filtered:
                        found_prereleases.append(item)
                else:
                    filtered.append(item)

            # If we've found no items except for pre-releases, then we'll go
            # ahead and use the pre-releases
            if not filtered and found_prereleases and prereleases is None:
                return found_prereleases

            return filtered
site-packages/pkg_resources/_vendor/packaging/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001041151446177000025056 0ustar00U

�Qab�@sTddlmZmZmZddlmZmZmZmZm	Z	m
Z
mZmZdddddd	d
dgZ
dS)
�)�absolute_import�division�print_function�)�
__author__�
__copyright__�	__email__�__license__�__summary__�	__title__�__uri__�__version__rr
rr
rrr	rN)Z
__future__rrr�	__about__rrrr	r
rrr
�__all__�rr�L/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py�<module>s(�site-packages/pkg_resources/_vendor/packaging/__pycache__/specifiers.cpython-38.pyc000064400000046513151446177000024531 0ustar00U

�Qabym�@s�ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
ddlmZm
Z
mZGdd�de�ZGdd	�d	e
eje��ZGd
d�de�ZGdd
�d
e�Zdd�ZGdd�de�Ze�d�Zdd�Zdd�ZGdd�de�ZdS)�)�absolute_import�division�print_functionN�)�string_types�with_metaclass)�Version�
LegacyVersion�parsec@seZdZdZdS)�InvalidSpecifierzH
    An invalid specifier was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__�rr�N/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.pyrsrc@s�eZdZejdd��Zejdd��Zejdd��Zejdd��Zej	d	d
��Z
e
jdd
��Z
ejdd
d��Zejddd��Z
dS)�
BaseSpecifiercCsdS)z�
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        Nr��selfrrr�__str__szBaseSpecifier.__str__cCsdS)zF
        Returns a hash value for this Specifier like object.
        Nrrrrr�__hash__szBaseSpecifier.__hash__cCsdS)zq
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        Nr�r�otherrrr�__eq__$szBaseSpecifier.__eq__cCsdS)zu
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        Nrrrrr�__ne__+szBaseSpecifier.__ne__cCsdS)zg
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        Nrrrrr�prereleases2szBaseSpecifier.prereleasescCsdS)zd
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr�r�valuerrrr9sNcCsdS)zR
        Determines if the given item is contained within this specifier.
        Nr�r�itemrrrr�contains@szBaseSpecifier.containscCsdS)z�
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        Nr)r�iterablerrrr�filterFszBaseSpecifier.filter)N)N)rr
r�abc�abstractmethodrrrr�abstractpropertyr�setterr r"rrrrrs 





rc@s�eZdZiZd dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zedd��Z
edd��Zedd��Zejdd��Zdd�Zd!dd�Zd"dd�ZdS)#�_IndividualSpecifier�NcCsF|j�|�}|std�|���|�d���|�d���f|_||_dS)NzInvalid specifier: '{0}'�operator�version)�_regex�searchr�format�group�strip�_spec�_prereleases)r�specr�matchrrr�__init__Rs�z_IndividualSpecifier.__init__cCs0|jdk	rd�|j�nd}d�|jjt|�|�S)N�, prereleases={0!r}r(z<{0}({1!r}{2})>)r1r-r�	__class__r�str�rZprerrr�__repr___s���z_IndividualSpecifier.__repr__cCsdj|j�S)Nz{0}{1})r-r0rrrrrlsz_IndividualSpecifier.__str__cCs
t|j�S�N)�hashr0rrrrrosz_IndividualSpecifier.__hash__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:��
isinstancerr6r�NotImplementedr0rrrrrrs
z_IndividualSpecifier.__eq__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:r<rrrrr}s
z_IndividualSpecifier.__ne__cCst|d�|j|��S)Nz_compare_{0})�getattrr-�
_operators)r�oprrr�
_get_operator�sz"_IndividualSpecifier._get_operatorcCst|ttf�st|�}|Sr:)r=r	rr
�rr*rrr�_coerce_version�sz$_IndividualSpecifier._coerce_versioncCs
|jdS)Nr�r0rrrrr)�sz_IndividualSpecifier.operatorcCs
|jdS)NrrErrrrr*�sz_IndividualSpecifier.versioncCs|jSr:�r1rrrrr�sz _IndividualSpecifier.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:�r �rrrrr�__contains__�sz!_IndividualSpecifier.__contains__cCs:|dkr|j}|�|�}|jr&|s&dS|�|j�||j�S�NF)rrD�
is_prereleaserBr)r*rrrrr �s

z_IndividualSpecifier.containsccs�d}g}d|dk	r|ndi}|D]B}|�|�}|j|f|�r |jrX|sX|jsX|�|�q d}|Vq |s||r||D]
}|VqpdS)NFrT)rDr rKr�append)rr!rZyielded�found_prereleases�kwr*�parsed_versionrrrr"�s"
��z_IndividualSpecifier.filter)r(N)N)N)rr
rr@r4r9rrrrrBrD�propertyr)r*rr&rIr r"rrrrr'Ns(







r'c@sveZdZdZe�dedejejB�Zdddddd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�LegacySpecifiera�
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        �^\s*�\s*$�equal�	not_equal�less_than_equal�greater_than_equal�	less_than�greater_than)�==�!=�<=�>=�<�>cCst|t�stt|��}|Sr:)r=r	r7rCrrrrD�s
zLegacySpecifier._coerce_versioncCs||�|�kSr:�rD�r�prospectiver2rrr�_compare_equal�szLegacySpecifier._compare_equalcCs||�|�kSr:r`rarrr�_compare_not_equal�sz"LegacySpecifier._compare_not_equalcCs||�|�kSr:r`rarrr�_compare_less_than_equal�sz(LegacySpecifier._compare_less_than_equalcCs||�|�kSr:r`rarrr�_compare_greater_than_equalsz+LegacySpecifier._compare_greater_than_equalcCs||�|�kSr:r`rarrr�_compare_less_thansz"LegacySpecifier._compare_less_thancCs||�|�kSr:r`rarrr�_compare_greater_thansz%LegacySpecifier._compare_greater_thanN)rr
r�
_regex_str�re�compile�VERBOSE�
IGNORECASEr+r@rDrcrdrerfrgrhrrrrrQ�s(�

��	rQcst����fdd��}|S)Ncst|t�sdS�|||�SrJ)r=rra��fnrr�wrappeds
z)_require_version_compare.<locals>.wrapped)�	functools�wraps)rorprrnr�_require_version_compare
srsc	@s�eZdZdZe�dedejejB�Zdddddd	d
dd�Z	e
d
d��Ze
dd��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��Ze
dd��Zdd�Zedd��Zejdd��Zd S)!�	Specifiera
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        rRrSZ
compatiblerTrUrVrWrXrYZ	arbitrary)�~=rZr[r\r]r^r_�===cCsNd�tt�dd�t|���dd��}|d7}|�d�||�oL|�d�||�S)N�.cSs|�d�o|�d�S)NZpostZdev)�
startswith��xrrr�<lambda>�s�z/Specifier._compare_compatible.<locals>.<lambda>����.*r]rZ)�join�list�	itertools�	takewhile�_version_splitrB)rrbr2�prefixrrr�_compare_compatible�s�����zSpecifier._compare_compatiblecCsp|�d�rPt|j�}t|dd��}tt|��}|dt|��}t||�\}}nt|�}|jsht|j�}||kS)Nr}���)�endswithrZpublicr�r7�len�_pad_version�localrarrrrc�s


zSpecifier._compare_equalcCs|�||�Sr:)rcrarrrrd�szSpecifier._compare_not_equalcCs|t|�kSr:�rrarrrre�sz"Specifier._compare_less_than_equalcCs|t|�kSr:r�rarrrrf�sz%Specifier._compare_greater_than_equalcCs<t|�}||ksdS|js8|jr8t|j�t|j�kr8dSdS�NFT)rrK�base_versionrarrrrg�szSpecifier._compare_less_thancCs^t|�}||ksdS|js8|jr8t|j�t|j�kr8dS|jdk	rZt|j�t|j�krZdSdSr�)rZis_postreleaser�r�rarrrrh�s
zSpecifier._compare_greater_thancCst|���t|���kSr:)r7�lowerrarrr�_compare_arbitraryszSpecifier._compare_arbitrarycCsR|jdk	r|jS|j\}}|dkrN|dkr@|�d�r@|dd�}t|�jrNdSdS)N)rZr]r\rurvrZr}r�TF)r1r0r�r
rK)rr)r*rrrrs


zSpecifier.prereleasescCs
||_dSr:rFrrrrrsN)rr
rrirjrkrlrmr+r@rsr�rcrdrerfrgrhr�rPrr&rrrrrtsD�_

��

"





rtz^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCs@g}|�d�D],}t�|�}|r0|�|���q|�|�q|S)Nrw)�split�
_prefix_regexr,�extend�groupsrL)r*�resultrr3rrrr�'s
r�c
Cs�gg}}|�tt�dd�|���|�tt�dd�|���|�|t|d�d��|�|t|d�d��|�ddgtdt|d�t|d���|�ddgtdt|d�t|d���ttj|��ttj|��fS)NcSs|��Sr:��isdigitryrrrr{6�z_pad_version.<locals>.<lambda>cSs|��Sr:r�ryrrrr{7r�rr�0)rLrr�r�r��insert�max�chain)�left�rightZ
left_splitZright_splitrrrr�2s 
"�"��r�c@s�eZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zedd��Z
e
jdd��Z
dd�Zddd�Zd dd�ZdS)!�SpecifierSetr(Nc	Csndd�|�d�D�}t�}|D]:}z|�t|��Wqtk
rV|�t|��YqXqt|�|_||_dS)NcSsg|]}|��r|���qSr)r/��.0�srrr�
<listcomp>Rsz)SpecifierSet.__init__.<locals>.<listcomp>�,)	r��set�addrtrrQ�	frozenset�_specsr1)rZ
specifiersrZparsed�	specifierrrrr4Os
zSpecifierSet.__init__cCs*|jdk	rd�|j�nd}d�t|�|�S)Nr5r(z<SpecifierSet({0!r}{1})>)r1r-rr7r8rrrr9ds
��zSpecifierSet.__repr__cCsd�tdd�|jD���S)Nr�css|]}t|�VqdSr:)r7r�rrr�	<genexpr>nsz'SpecifierSet.__str__.<locals>.<genexpr>)r~�sortedr�rrrrrmszSpecifierSet.__str__cCs
t|j�Sr:)r;r�rrrrrpszSpecifierSet.__hash__cCs�t|t�rt|�}nt|t�s"tSt�}t|j|jB�|_|jdkrX|jdk	rX|j|_n<|jdk	rv|jdkrv|j|_n|j|jkr�|j|_ntd��|S)NzFCannot combine SpecifierSets with True and False prerelease overrides.)r=rr�r>r�r�r1�
ValueError)rrr�rrr�__and__ss 





�zSpecifierSet.__and__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:�r=rr�r'r7r>r�rrrrr�s



zSpecifierSet.__eq__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:r�rrrrr�s



zSpecifierSet.__ne__cCs
t|j�Sr:)r�r�rrrr�__len__�szSpecifierSet.__len__cCs
t|j�Sr:)�iterr�rrrr�__iter__�szSpecifierSet.__iter__cCs.|jdk	r|jS|jsdStdd�|jD��S)Ncss|]}|jVqdSr:�rr�rrrr��sz+SpecifierSet.prereleases.<locals>.<genexpr>)r1r��anyrrrrr�s

zSpecifierSet.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:rGrHrrrrI�szSpecifierSet.__contains__csLt�ttf�st����dkr$|j��s2�jr2dSt��fdd�|jD��S)NFc3s|]}|j��d�VqdS)r�NrGr��rrrrr��s�z(SpecifierSet.contains.<locals>.<genexpr>)r=r	rr
rrK�allr�rrr�rr �s
�zSpecifierSet.containscCs�|dkr|j}|jr6|jD]}|j|t|�d�}q|Sg}g}|D]P}t|ttf�s^t|�}n|}t|t�rnqB|jr�|s�|s�|�	|�qB|�	|�qB|s�|r�|dkr�|S|SdS)Nr�)
rr�r"�boolr=r	rr
rKrL)rr!rr2ZfilteredrMrrOrrrr"�s*



zSpecifierSet.filter)r(N)N)N)rr
rr4r9rrr�rrr�r�rPrr&rIr r"rrrrr�Ms 
	




r�)Z
__future__rrrr#rqr�rjZ_compatrrr*rr	r
r�r�ABCMeta�objectrr'rQrsrtrkr�r�r�r�rrrr�<module>s&9	4	
site-packages/pkg_resources/_vendor/packaging/__pycache__/_compat.cpython-38.pyc000064400000001725151446177000024013 0ustar00U

�Qab\�@sVddlmZmZmZddlZejddkZejddkZerDefZ	ne
fZ	dd�ZdS)�)�absolute_import�division�print_functionN��cs&G��fdd�d��}t�|ddi�S)z/
    Create a base class with a metaclass.
    cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�S)N�)�cls�nameZ
this_bases�d��bases�metar�K/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py�__new__sz)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__�__qualname__rrrrr�	metaclasssrZtemporary_classr)�typer)r
rrrrr�with_metaclasssr)Z
__future__rrr�sys�version_infoZPY2ZPY3�strZstring_typesZ
basestringrrrrr�<module>ssite-packages/pkg_resources/_vendor/packaging/__pycache__/_compat.cpython-38.opt-1.pyc000064400000001725151446177000024752 0ustar00U

�Qab\�@sVddlmZmZmZddlZejddkZejddkZerDefZ	ne
fZ	dd�ZdS)�)�absolute_import�division�print_functionN��cs&G��fdd�d��}t�|ddi�S)z/
    Create a base class with a metaclass.
    cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�S)N�)�cls�nameZ
this_bases�d��bases�metar�K/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_compat.py�__new__sz)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__�__qualname__rrrrr�	metaclasssrZtemporary_classr)�typer)r
rrrrr�with_metaclasssr)Z
__future__rrr�sys�version_infoZPY2ZPY3�strZstring_typesZ
basestringrrrrr�<module>ssite-packages/pkg_resources/_vendor/packaging/__pycache__/utils.cpython-38.opt-1.pyc000064400000000722151446177000024464 0ustar00U

�Qab��@s2ddlmZmZmZddlZe�d�Zdd�ZdS)�)�absolute_import�division�print_functionNz[-_.]+cCst�d|���S)N�-)�_canonicalize_regex�sub�lower)�name�r
�I/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py�canonicalize_namesr)Z
__future__rrr�re�compilerrr
r
r
r�<module>s
site-packages/pkg_resources/_vendor/packaging/__pycache__/markers.cpython-38.opt-1.pyc000064400000021162151446177000024771 0ustar00U

�Qab8 �	@s@ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
mZmZddlm
Z
mZmZmZddlmZddlmZddlmZmZd	d
ddd
gZGdd	�d	e�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�Z Gdd�de�Z!ed�ed�Bed�Bed�Bed�Bed�Bed�Bed �Bed!�Bed"�Bed#�Bed$�Bed%�Bed&�Bed'�Bed(�Bed)�Bed*�BZ"d#d"ddddd+�Z#e"�$d,d-��ed.�ed/�Bed0�Bed1�Bed2�Bed3�Bed4�Bed5�BZ%e%ed6�Bed7�BZ&e&�$d8d-��ed9�ed:�BZ'e'�$d;d-��ed<�ed=�BZ(e"e'BZ)ee)e&e)�Z*e*�$d>d-��ed?��+�Z,ed@��+�Z-e�Z.e*ee,e.e-�BZ/e.e/e
e(e.�>ee.eZ0dAdB�Z1dSdDdE�Z2dFd-�dGd-�ej3ej4ej5ej6ej7ej8dH�Z9dIdJ�Z:e�Z;dKdL�Z<dMdN�Z=dOdP�Z>dQd
�Z?GdRd�de�Z@dS)T�)�absolute_import�division�print_functionN)�ParseException�ParseResults�stringStart�	stringEnd)�
ZeroOrMore�Group�Forward�QuotedString)�Literal�)�string_types)�	Specifier�InvalidSpecifier�
InvalidMarker�UndefinedComparison�UndefinedEnvironmentName�Marker�default_environmentc@seZdZdZdS)rzE
    An invalid marker was found, users should refer to PEP 508.
    N��__name__�
__module__�__qualname__�__doc__�rr�K/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.pyrsc@seZdZdZdS)rzP
    An invalid operation was attempted on a value that doesn't support it.
    Nrrrrrrsc@seZdZdZdS)rz\
    A name was attempted to be used that does not exist inside of the
    environment.
    Nrrrrrr%sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�NodecCs
||_dS�N)�value)�selfr rrr�__init__.sz
Node.__init__cCs
t|j�Sr)�strr �r!rrr�__str__1szNode.__str__cCsd�|jjt|��S)Nz<{0}({1!r})>)�format�	__class__rr#r$rrr�__repr__4sz
Node.__repr__cCst�dSr)�NotImplementedErrorr$rrr�	serialize7szNode.serializeN)rrrr"r%r(r*rrrrr,src@seZdZdd�ZdS)�VariablecCst|�Sr�r#r$rrrr*=szVariable.serializeN�rrrr*rrrrr+;sr+c@seZdZdd�ZdS)�ValuecCs
d�|�S)Nz"{0}")r&r$rrrr*CszValue.serializeNr-rrrrr.Asr.c@seZdZdd�ZdS)�OpcCst|�Srr,r$rrrr*IszOp.serializeNr-rrrrr/Gsr/�implementation_version�platform_python_implementation�implementation_name�python_full_version�platform_release�platform_version�platform_machine�platform_system�python_version�sys_platform�os_name�os.name�sys.platform�platform.version�platform.machine�platform.python_implementation�python_implementationZextra)r;r<r=r>r?r@cCstt�|d|d��S�Nr)r+�ALIASES�get��s�l�trrr�<lambda>i�rHz===�==�>=�<=�!=z~=�>�<�not in�incCst|d�SrA)r/rDrrrrHwrI�'�"cCst|d�SrA)r.rDrrrrHzrI�and�orcCst|d�SrA)�tuplerDrrrrH�rI�(�)cCs t|t�rdd�|D�S|SdS)NcSsg|]}t|��qSr)�_coerce_parse_result)�.0�irrr�
<listcomp>�sz(_coerce_parse_result.<locals>.<listcomp>)�
isinstancer)�resultsrrrrY�s
rYTcCs�t|t�r4t|�dkr4t|dttf�r4t|d�St|t�rndd�|D�}|rZd�|�Sdd�|�dSn"t|t�r�d�dd	�|D��S|SdS)
Nrrcss|]}t|dd�VqdS)F)�firstN)�_format_marker�rZ�mrrr�	<genexpr>�sz!_format_marker.<locals>.<genexpr>� rWrXcSsg|]}|���qSr)r*rarrrr\�sz"_format_marker.<locals>.<listcomp>)r]�list�lenrVr`�join)�markerr_�innerrrrr`�s�


r`cCs||kSrr��lhs�rhsrrrrH�rIcCs||kSrrrjrrrrH�rI)rQrPrOrLrJrMrKrNcCslztd�|��|g��}Wntk
r.YnX|�|�St�|���}|dkrbtd�|||���|||�S)N�z#Undefined {0!r} on {1!r} and {2!r}.)	rrgr*r�contains�
_operatorsrCrr&)rk�oprl�specZoperrrr�_eval_op�s
�rrcCs&|�|t�}|tkr"td�|���|S)Nz/{0!r} does not exist in evaluation environment.)rC�
_undefinedrr&)�environment�namer rrr�_get_env�s�rvc	Cs�gg}|D]�}t|t�r.|d�t||��q
t|t�r�|\}}}t|t�r`t||j�}|j}n|j}t||j�}|d�t|||��q
|dkr
|�g�q
t	dd�|D��S)N���rUcss|]}t|�VqdSr)�all)rZ�itemrrrrc�sz$_evaluate_markers.<locals>.<genexpr>)
r]re�append�_evaluate_markersrVr+rvr rr�any)	Zmarkersrt�groupsrhrkrprlZ	lhs_valueZ	rhs_valuerrrr{�s



r{cCs2d�|�}|j}|dkr.||dt|j�7}|S)Nz{0.major}.{0.minor}.{0.micro}�finalr)r&�releaselevelr#�serial)�info�versionZkindrrr�format_full_version�s

r�cCslttd�r ttjj�}tjj}nd}d}||tjt��t�	�t�
�t��t��t��t��dd�tjd�S)N�implementation�0rm�)r2r0r:r6r4r7r5r3r1r8r9)
�hasattr�sysr�r�r�ru�os�platform�machine�release�systemr8r@)Ziverr2rrrr�s"

�c@s.eZdZdd�Zdd�Zdd�Zd
dd	�ZdS)rc
Cs`ztt�|��|_WnFtk
rZ}z(d�|||j|jd��}t|��W5d}~XYnXdS)Nz+Invalid marker: {0!r}, parse error at {1!r}�)rY�MARKERZparseString�_markersrr&Zlocr)r!rh�eZerr_strrrrr"s�zMarker.__init__cCs
t|j�Sr)r`r�r$rrrr%szMarker.__str__cCsd�t|��S)Nz<Marker({0!r})>)r&r#r$rrrr(szMarker.__repr__NcCs$t�}|dk	r|�|�t|j|�S)a$Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        N)r�updater{r�)r!rtZcurrent_environmentrrr�evaluate s	
zMarker.evaluate)N)rrrr"r%r(r�rrrrrs)T)AZ
__future__rrr�operatorr�r�r�Zpkg_resources.extern.pyparsingrrrrr	r
rrr
�LZ_compatrZ
specifiersrr�__all__�
ValueErrorrrr�objectrr+r.r/ZVARIABLErBZsetParseActionZVERSION_CMPZ	MARKER_OPZMARKER_VALUEZBOOLOPZ
MARKER_VARZMARKER_ITEM�suppressZLPARENZRPARENZMARKER_EXPRZMARKER_ATOMr�rYr`�lt�le�eq�ne�ge�gtrorrrsrvr{r�rrrrrr�<module>s����������	�
���
���������������
�site-packages/pkg_resources/_vendor/packaging/__pycache__/requirements.cpython-38.pyc000064400000007446151446177000025122 0ustar00U

�Qab�@srddlmZmZmZddlZddlZddlmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZddlmZddlmZddlmZmZdd	lmZmZmZGd
d�de�Zeejej�Z ed��!�Z"ed
��!�Z#ed��!�Z$ed��!�Z%ed��!�Z&ed��!�Z'ed��!�Z(ed�Z)e ee)�e BZ*ee ee*��Z+e+d�Z,e+Z-ed�d�Z.e(e.Z/e-ee&e-�Z0e"e
e0�e#d�Z1eej2ej3ej4B�Z5eej2ej3ej4B�Z6e5e6AZ7ee7ee&e7�ddd�d�Z8e
e$e8e%e8B�Z9e9�:dd��e	e9�d�Z;e;�:dd��e	e��d�Ze�:d d��e'Z<e<eZ=e;e
e=�Z>e/e
e=�Z?e,e
e1�e?e>BZ@ee@eZAGd!d"�d"eB�ZCdS)#�)�absolute_import�division�print_functionN)�stringStart�	stringEnd�originalTextFor�ParseException)�
ZeroOrMore�Word�Optional�Regex�Combine)�Literal)�parse�)�MARKER_EXPR�Marker)�LegacySpecifier�	Specifier�SpecifierSetc@seZdZdZdS)�InvalidRequirementzJ
    An invalid requirement was found, users should refer to PEP 508.
    N)�__name__�
__module__�__qualname__�__doc__�rr�P/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.pyrsr�[�]�(�)�,�;�@z-_.�namez[^ ]+�url�extrasF)Z
joinStringZadjacent�	_raw_speccCs
|jpdS)N�)r'��s�l�trrr�<lambda>6�r-�	specifiercCs|dS)Nrrr)rrrr-9r.�markercCst||j|j��S)N)rZ_original_startZ
_original_endr)rrrr-=r.c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Requirementz�Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    c
Cs�zt�|�}Wn@tk
rN}z"td�||j|jd����W5d}~XYnX|j|_|jr�t�|j�}|j	r�|j
r�|j	s�|j
s�td��|j|_nd|_t|jr�|j�
�ng�|_t|j�|_|jr�|jnd|_dS)Nz+Invalid requirement, parse error at "{0!r}"�zInvalid URL given)�REQUIREMENTZparseStringrr�formatZlocr$r%�urlparseZschemeZnetloc�setr&ZasListrr/r0)�selfZrequirement_stringZreq�eZ
parsed_urlrrr�__init__Xs,����
zRequirement.__init__cCsz|jg}|jr*|�d�d�t|j����|jr@|�t|j��|jrX|�d�|j��|j	rp|�d�|j	��d�|�S)Nz[{0}]r!z@ {0}z; {0}r()
r$r&�appendr4�join�sortedr/�strr%r0)r7�partsrrr�__str__mszRequirement.__str__cCsd�t|��S)Nz<Requirement({0!r})>)r4r=)r7rrr�__repr__~szRequirement.__repr__N)rrrrr9r?r@rrrrr1Ksr1)DZ
__future__rrr�string�reZpkg_resources.extern.pyparsingrrrrr	r
rrr
r�LZ%pkg_resources.extern.six.moves.urllibrr5ZmarkersrrZ
specifiersrrr�
ValueErrorrZ
ascii_lettersZdigitsZALPHANUM�suppressZLBRACKETZRBRACKETZLPARENZRPAREN�COMMAZ	SEMICOLON�ATZPUNCTUATIONZIDENTIFIER_ENDZ
IDENTIFIER�NAMEZEXTRAZURIZURLZEXTRAS_LISTZEXTRASZ
_regex_str�VERBOSE�
IGNORECASEZVERSION_PEP440ZVERSION_LEGACYZVERSION_ONEZVERSION_MANYZ
_VERSION_SPECZsetParseActionZVERSION_SPECZMARKER_SEPERATORZMARKERZVERSION_AND_MARKERZURL_AND_MARKERZNAMED_REQUIREMENTr3�objectr1rrrr�<module>sf����site-packages/pkg_resources/_vendor/packaging/__pycache__/_structures.cpython-38.opt-1.pyc000064400000005313151446177000025707 0ustar00U

�Qab��@sDddlmZmZmZGdd�de�Ze�ZGdd�de�Ze�ZdS)�)�absolute_import�division�print_functionc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)�InfinitycCsdS)Nr���selfrr�O/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py�__repr__	szInfinity.__repr__cCstt|��S�N��hash�reprrrrr	�__hash__szInfinity.__hash__cCsdS�NFr�r�otherrrr	�__lt__szInfinity.__lt__cCsdSrrrrrr	�__le__szInfinity.__le__cCst||j�Sr��
isinstance�	__class__rrrr	�__eq__szInfinity.__eq__cCst||j�Srrrrrr	�__ne__szInfinity.__ne__cCsdS�NTrrrrr	�__gt__szInfinity.__gt__cCsdSrrrrrr	�__ge__szInfinity.__ge__cCstSr)�NegativeInfinityrrrr	�__neg__!szInfinity.__neg__N��__name__�
__module__�__qualname__r
rrrrrrrrrrrr	rsrc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)rcCsdS)Nz	-Infinityrrrrr	r
)szNegativeInfinity.__repr__cCstt|��Srrrrrr	r,szNegativeInfinity.__hash__cCsdSrrrrrr	r/szNegativeInfinity.__lt__cCsdSrrrrrr	r2szNegativeInfinity.__le__cCst||j�Srrrrrr	r5szNegativeInfinity.__eq__cCst||j�Srrrrrr	r8szNegativeInfinity.__ne__cCsdSrrrrrr	r;szNegativeInfinity.__gt__cCsdSrrrrrr	r>szNegativeInfinity.__ge__cCstSr)rrrrr	rAszNegativeInfinity.__neg__Nrrrrr	r'srN)Z
__future__rrr�objectrrrrrr	�<module>ssite-packages/pkg_resources/_vendor/packaging/__pycache__/version.cpython-38.pyc000064400000024612151446177000024056 0ustar00U

�Qab$-�	@s�ddlmZmZmZddlZddlZddlZddlmZddddd	gZ	e�
d
ddd
dddg�Zdd�ZGdd�de
�ZGdd�de�ZGdd�de�Ze�dej�Zdddddd�Zdd�Zdd�ZdZGd d�de�Zd!d"�Ze�d#�Zd$d%�Zd&d'�ZdS)(�)�absolute_import�division�print_functionN�)�Infinity�parse�Version�
LegacyVersion�InvalidVersion�VERSION_PATTERN�_Version�epoch�release�dev�pre�post�localcCs,z
t|�WStk
r&t|�YSXdS)z�
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    N)rr
r	)�version�r�K/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.pyrs
c@seZdZdZdS)r
zF
    An invalid version was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__rrrrr
$sc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)�_BaseVersioncCs
t|j�S�N)�hash�_key��selfrrr�__hash__,sz_BaseVersion.__hash__cCs|�|dd��S)NcSs||kSrr��s�orrr�<lambda>0�z%_BaseVersion.__lt__.<locals>.<lambda>��_compare�r�otherrrr�__lt__/sz_BaseVersion.__lt__cCs|�|dd��S)NcSs||kSrrr!rrrr$3r%z%_BaseVersion.__le__.<locals>.<lambda>r&r(rrr�__le__2sz_BaseVersion.__le__cCs|�|dd��S)NcSs||kSrrr!rrrr$6r%z%_BaseVersion.__eq__.<locals>.<lambda>r&r(rrr�__eq__5sz_BaseVersion.__eq__cCs|�|dd��S)NcSs||kSrrr!rrrr$9r%z%_BaseVersion.__ge__.<locals>.<lambda>r&r(rrr�__ge__8sz_BaseVersion.__ge__cCs|�|dd��S)NcSs||kSrrr!rrrr$<r%z%_BaseVersion.__gt__.<locals>.<lambda>r&r(rrr�__gt__;sz_BaseVersion.__gt__cCs|�|dd��S)NcSs||kSrrr!rrrr$?r%z%_BaseVersion.__ne__.<locals>.<lambda>r&r(rrr�__ne__>sz_BaseVersion.__ne__cCst|t�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr)�methodrrrr'As
z_BaseVersion._compareN)rrrr r*r+r,r-r.r/r'rrrrr*src@s`eZdZdd�Zdd�Zdd�Zedd��Zed	d
��Zedd��Z	ed
d��Z
edd��ZdS)r	cCst|�|_t|j�|_dSr)�str�_version�_legacy_cmpkeyr)rrrrr�__init__Js
zLegacyVersion.__init__cCs|jSr�r4rrrr�__str__NszLegacyVersion.__str__cCsd�tt|���S)Nz<LegacyVersion({0})>��format�reprr3rrrr�__repr__QszLegacyVersion.__repr__cCs|jSrr7rrrr�publicTszLegacyVersion.publiccCs|jSrr7rrrr�base_versionXszLegacyVersion.base_versioncCsdSrrrrrrr\szLegacyVersion.localcCsdS�NFrrrrr�
is_prerelease`szLegacyVersion.is_prereleasecCsdSr?rrrrr�is_postreleasedszLegacyVersion.is_postreleaseN)rrrr6r8r<�propertyr=r>rr@rArrrrr	Hs



z(\d+ | [a-z]+ | \.| -)�czfinal-�@)r�preview�-�rcrccs\t�|�D]F}t�||�}|r
|dkr(q
|dd�dkrF|�d�Vq
d|Vq
dVdS)N�.r�
0123456789��*�*final)�_legacy_version_component_re�split�_legacy_version_replacement_map�get�zfill)r"�partrrr�_parse_version_partsrsrScCszd}g}t|���D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�}||fS)N���rKrLz*final-Z00000000)rS�lower�
startswith�pop�append�tuple)rr
�partsrRrrrr5�s


r5a�
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
c@s|eZdZe�dedejejB�Zdd�Z	dd�Z
dd�Zed	d
��Z
edd��Zed
d��Zedd��Zedd��ZdS)rz^\s*z\s*$c
Cs�|j�|�}|std�|���t|�d�r8t|�d��ndtdd�|�d��d�D��t	|�d�|�d	��t	|�d
�|�d�p�|�d��t	|�d
�|�d��t
|�d��d�|_t|jj
|jj|jj|jj|jj|jj�|_dS)NzInvalid version: '{0}'r
rcss|]}t|�VqdSr)�int��.0�irrr�	<genexpr>�sz#Version.__init__.<locals>.<genexpr>rrHZpre_lZpre_nZpost_lZpost_n1Zpost_n2Zdev_lZdev_nr�r
rrrrr)�_regex�searchr
r:r�groupr[rYrN�_parse_letter_version�_parse_local_versionr4�_cmpkeyr
rrrrrr)rr�matchrrrr6�s8�����zVersion.__init__cCsd�tt|���S)Nz<Version({0})>r9rrrrr<�szVersion.__repr__cCs�g}|jjdkr$|�d�|jj��|�d�dd�|jjD���|jjdk	rl|�d�dd�|jjD���|jjdk	r�|�d�|jjd	��|jjdk	r�|�d
�|jjd	��|jj	dk	r�|�d�d�dd�|jj	D����d�|�S)
Nr�{0}!rHcss|]}t|�VqdSr�r3�r]�xrrrr_�sz"Version.__str__.<locals>.<genexpr>�css|]}t|�VqdSrrirjrrrr_�sz.post{0}rz.dev{0}z+{0}css|]}t|�VqdSrrirjrrrr_s)
r4r
rXr:�joinrrrrr�rrZrrrr8�s�zVersion.__str__cCst|��dd�dS)N�+rr�r3rNrrrrr=
szVersion.publiccCsLg}|jjdkr$|�d�|jj��|�d�dd�|jjD���d�|�S)NrrhrHcss|]}t|�VqdSrrirjrrrr_sz'Version.base_version.<locals>.<genexpr>rl)r4r
rXr:rmrrnrrrr>s
zVersion.base_versioncCs$t|�}d|kr |�dd�dSdS)Nrorrp)rZversion_stringrrrrsz
Version.localcCst|jjp|jj�Sr)�boolr4rrrrrrr@!szVersion.is_prereleasecCst|jj�Sr)rqr4rrrrrrA%szVersion.is_postreleaseN)rrr�re�compiler�VERBOSE�
IGNORECASErar6r<r8rBr=r>rr@rArrrrr�s"

�#



cCsv|rZ|dkrd}|��}|dkr&d}n(|dkr4d}n|dkrBd}n|dkrNd	}|t|�fS|sr|rrd	}|t|�fSdS)
NrZalpha�aZbeta�b)rCrrErG)Zrev�rr)rUr[)ZletterZnumberrrrrd*s rdz[\._-]cCs$|dk	r tdd�t�|�D��SdS)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Ncss&|]}|��s|��nt|�VqdSr)�isdigitrUr[)r]rRrrrr_Qs�z'_parse_local_version.<locals>.<genexpr>)rY�_local_version_seperatorsrN)rrrrreLs�recCs�tttt�dd�t|�����}|dkr@|dkr@|dk	r@t}n|dkrLt}|dkrZt}|dkrft}|dkrvt}ntdd�|D��}||||||fS)NcSs|dkS)Nrr)rkrrrr$`r%z_cmpkey.<locals>.<lambda>css*|]"}t|t�r|dfnt|fVqdS)rlN)r0r[rr\rrrr_�s�z_cmpkey.<locals>.<genexpr>)rY�reversed�list�	itertools�	dropwhilerr`rrrrfWs,���
	�rf)Z
__future__rrr�collectionsr}rrZ_structuresr�__all__�
namedtuplerr�
ValueErrorr
�objectrr	rsrtrMrOrSr5rrrdrzrerfrrrr�<module>sH��!�� k
site-packages/pkg_resources/_vendor/packaging/__pycache__/__about__.cpython-38.opt-1.pyc000064400000001303151446177000025226 0ustar00U

�Qab��@sPddlmZmZmZdddddddd	gZd
ZdZdZd
ZdZ	dZ
dZde	ZdS)�)�absolute_import�division�print_function�	__title__�__summary__�__uri__�__version__�
__author__�	__email__�__license__�
__copyright__Z	packagingz"Core utilities for Python packagesz!https://github.com/pypa/packagingz16.8z)Donald Stufft and individual contributorszdonald@stufft.ioz"BSD or Apache License, Version 2.0zCopyright 2014-2016 %sN)
Z
__future__rrr�__all__rrrrr	r
rr�rr�M/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py�<module>s"�site-packages/pkg_resources/_vendor/packaging/__pycache__/__about__.cpython-38.pyc000064400000001303151446177000024267 0ustar00U

�Qab��@sPddlmZmZmZdddddddd	gZd
ZdZdZd
ZdZ	dZ
dZde	ZdS)�)�absolute_import�division�print_function�	__title__�__summary__�__uri__�__version__�
__author__�	__email__�__license__�
__copyright__Z	packagingz"Core utilities for Python packagesz!https://github.com/pypa/packagingz16.8z)Donald Stufft and individual contributorszdonald@stufft.ioz"BSD or Apache License, Version 2.0zCopyright 2014-2016 %sN)
Z
__future__rrr�__all__rrrrr	r
rr�rr�M/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__about__.py�<module>s"�site-packages/pkg_resources/_vendor/packaging/__pycache__/utils.cpython-38.pyc000064400000000722151446177000023525 0ustar00U

�Qab��@s2ddlmZmZmZddlZe�d�Zdd�ZdS)�)�absolute_import�division�print_functionNz[-_.]+cCst�d|���S)N�-)�_canonicalize_regex�sub�lower)�name�r
�I/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/utils.py�canonicalize_namesr)Z
__future__rrr�re�compilerrr
r
r
r�<module>s
site-packages/pkg_resources/_vendor/packaging/__pycache__/markers.cpython-38.pyc000064400000021327151446177000024035 0ustar00U

�Qab8 �	@s@ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
mZmZddlm
Z
mZmZmZddlmZddlmZddlmZmZd	d
ddd
gZGdd	�d	e�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�Z Gdd�de�Z!ed�ed�Bed�Bed�Bed�Bed�Bed�Bed �Bed!�Bed"�Bed#�Bed$�Bed%�Bed&�Bed'�Bed(�Bed)�Bed*�BZ"d#d"ddddd+�Z#e"�$d,d-��ed.�ed/�Bed0�Bed1�Bed2�Bed3�Bed4�Bed5�BZ%e%ed6�Bed7�BZ&e&�$d8d-��ed9�ed:�BZ'e'�$d;d-��ed<�ed=�BZ(e"e'BZ)ee)e&e)�Z*e*�$d>d-��ed?��+�Z,ed@��+�Z-e�Z.e*ee,e.e-�BZ/e.e/e
e(e.�>ee.eZ0dAdB�Z1dSdDdE�Z2dFd-�dGd-�ej3ej4ej5ej6ej7ej8dH�Z9dIdJ�Z:e�Z;dKdL�Z<dMdN�Z=dOdP�Z>dQd
�Z?GdRd�de�Z@dS)T�)�absolute_import�division�print_functionN)�ParseException�ParseResults�stringStart�	stringEnd)�
ZeroOrMore�Group�Forward�QuotedString)�Literal�)�string_types)�	Specifier�InvalidSpecifier�
InvalidMarker�UndefinedComparison�UndefinedEnvironmentName�Marker�default_environmentc@seZdZdZdS)rzE
    An invalid marker was found, users should refer to PEP 508.
    N��__name__�
__module__�__qualname__�__doc__�rr�K/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/markers.pyrsc@seZdZdZdS)rzP
    An invalid operation was attempted on a value that doesn't support it.
    Nrrrrrrsc@seZdZdZdS)rz\
    A name was attempted to be used that does not exist inside of the
    environment.
    Nrrrrrr%sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�NodecCs
||_dS�N)�value)�selfr rrr�__init__.sz
Node.__init__cCs
t|j�Sr)�strr �r!rrr�__str__1szNode.__str__cCsd�|jjt|��S)Nz<{0}({1!r})>)�format�	__class__rr#r$rrr�__repr__4sz
Node.__repr__cCst�dSr)�NotImplementedErrorr$rrr�	serialize7szNode.serializeN)rrrr"r%r(r*rrrrr,src@seZdZdd�ZdS)�VariablecCst|�Sr�r#r$rrrr*=szVariable.serializeN�rrrr*rrrrr+;sr+c@seZdZdd�ZdS)�ValuecCs
d�|�S)Nz"{0}")r&r$rrrr*CszValue.serializeNr-rrrrr.Asr.c@seZdZdd�ZdS)�OpcCst|�Srr,r$rrrr*IszOp.serializeNr-rrrrr/Gsr/�implementation_version�platform_python_implementation�implementation_name�python_full_version�platform_release�platform_version�platform_machine�platform_system�python_version�sys_platform�os_name�os.name�sys.platform�platform.version�platform.machine�platform.python_implementation�python_implementationZextra)r;r<r=r>r?r@cCstt�|d|d��S�Nr)r+�ALIASES�get��s�l�trrr�<lambda>i�rHz===�==�>=�<=�!=z~=�>�<�not in�incCst|d�SrA)r/rDrrrrHwrI�'�"cCst|d�SrA)r.rDrrrrHzrI�and�orcCst|d�SrA)�tuplerDrrrrH�rI�(�)cCs t|t�rdd�|D�S|SdS)NcSsg|]}t|��qSr)�_coerce_parse_result)�.0�irrr�
<listcomp>�sz(_coerce_parse_result.<locals>.<listcomp>)�
isinstancer)�resultsrrrrY�s
rYTcCs�t|tttf�st�t|t�rHt|�dkrHt|dttf�rHt|d�St|t�r�dd�|D�}|rnd�|�Sdd�|�dSn"t|t�r�d�dd	�|D��S|SdS)
Nrrcss|]}t|dd�VqdS)F)�firstN)�_format_marker�rZ�mrrr�	<genexpr>�sz!_format_marker.<locals>.<genexpr>� rWrXcSsg|]}|���qSr)r*rarrrr\�sz"_format_marker.<locals>.<listcomp>)r]�listrVr�AssertionError�lenr`�join)�markerr_�innerrrrr`�s�


r`cCs||kSrr��lhs�rhsrrrrH�rIcCs||kSrrrkrrrrH�rI)rQrPrOrLrJrMrKrNcCslztd�|��|g��}Wntk
r.YnX|�|�St�|���}|dkrbtd�|||���|||�S)N�z#Undefined {0!r} on {1!r} and {2!r}.)	rrhr*r�contains�
_operatorsrCrr&)rl�oprm�specZoperrrr�_eval_op�s
�rscCs&|�|t�}|tkr"td�|���|S)Nz/{0!r} does not exist in evaluation environment.)rC�
_undefinedrr&)�environment�namer rrr�_get_env�s�rwc	Cs�gg}|D]�}t|tttf�s"t�t|t�rB|d�t||��q
t|t�r�|\}}}t|t�rtt||j	�}|j	}n|j	}t||j	�}|d�t
|||��q
|dks�t�|dkr
|�g�q
tdd�|D��S)N���)rTrUrUcss|]}t|�VqdSr)�all)rZ�itemrrrrc�sz$_evaluate_markers.<locals>.<genexpr>)r]rerVrrf�append�_evaluate_markersr+rwr rs�any)	Zmarkersru�groupsrirlrqrmZ	lhs_valueZ	rhs_valuerrrr|�s"



r|cCs2d�|�}|j}|dkr.||dt|j�7}|S)Nz{0.major}.{0.minor}.{0.micro}�finalr)r&�releaselevelr#�serial)�info�versionZkindrrr�format_full_version�s

r�cCslttd�r ttjj�}tjj}nd}d}||tjt��t�	�t�
�t��t��t��t��dd�tjd�S)N�implementation�0rn�)r2r0r:r6r4r7r5r3r1r8r9)
�hasattr�sysr�r�r�rv�os�platform�machine�release�systemr8r@)Ziverr2rrrr�s"

�c@s.eZdZdd�Zdd�Zdd�Zd
dd	�ZdS)rc
Cs`ztt�|��|_WnFtk
rZ}z(d�|||j|jd��}t|��W5d}~XYnXdS)Nz+Invalid marker: {0!r}, parse error at {1!r}�)rY�MARKERZparseString�_markersrr&Zlocr)r!ri�eZerr_strrrrr"s�zMarker.__init__cCs
t|j�Sr)r`r�r$rrrr%szMarker.__str__cCsd�t|��S)Nz<Marker({0!r})>)r&r#r$rrrr(szMarker.__repr__NcCs$t�}|dk	r|�|�t|j|�S)a$Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        N)r�updater|r�)r!ruZcurrent_environmentrrr�evaluate s	
zMarker.evaluate)N)rrrr"r%r(r�rrrrrs)T)AZ
__future__rrr�operatorr�r�r�Zpkg_resources.extern.pyparsingrrrrr	r
rrr
�LZ_compatrZ
specifiersrr�__all__�
ValueErrorrrr�objectrr+r.r/ZVARIABLErBZsetParseActionZVERSION_CMPZ	MARKER_OPZMARKER_VALUEZBOOLOPZ
MARKER_VARZMARKER_ITEM�suppressZLPARENZRPARENZMARKER_EXPRZMARKER_ATOMr�rYr`�lt�le�eq�ne�ge�gtrprsrtrwr|r�rrrrrr�<module>s����������	�
���
���������������
�site-packages/pkg_resources/_vendor/packaging/__pycache__/requirements.cpython-38.opt-1.pyc000064400000007446151446177000026061 0ustar00U

�Qab�@srddlmZmZmZddlZddlZddlmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZddlmZddlmZddlmZmZdd	lmZmZmZGd
d�de�Zeejej�Z ed��!�Z"ed
��!�Z#ed��!�Z$ed��!�Z%ed��!�Z&ed��!�Z'ed��!�Z(ed�Z)e ee)�e BZ*ee ee*��Z+e+d�Z,e+Z-ed�d�Z.e(e.Z/e-ee&e-�Z0e"e
e0�e#d�Z1eej2ej3ej4B�Z5eej2ej3ej4B�Z6e5e6AZ7ee7ee&e7�ddd�d�Z8e
e$e8e%e8B�Z9e9�:dd��e	e9�d�Z;e;�:dd��e	e��d�Ze�:d d��e'Z<e<eZ=e;e
e=�Z>e/e
e=�Z?e,e
e1�e?e>BZ@ee@eZAGd!d"�d"eB�ZCdS)#�)�absolute_import�division�print_functionN)�stringStart�	stringEnd�originalTextFor�ParseException)�
ZeroOrMore�Word�Optional�Regex�Combine)�Literal)�parse�)�MARKER_EXPR�Marker)�LegacySpecifier�	Specifier�SpecifierSetc@seZdZdZdS)�InvalidRequirementzJ
    An invalid requirement was found, users should refer to PEP 508.
    N)�__name__�
__module__�__qualname__�__doc__�rr�P/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/requirements.pyrsr�[�]�(�)�,�;�@z-_.�namez[^ ]+�url�extrasF)Z
joinStringZadjacent�	_raw_speccCs
|jpdS)N�)r'��s�l�trrr�<lambda>6�r-�	specifiercCs|dS)Nrrr)rrrr-9r.�markercCst||j|j��S)N)rZ_original_startZ
_original_endr)rrrr-=r.c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Requirementz�Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    c
Cs�zt�|�}Wn@tk
rN}z"td�||j|jd����W5d}~XYnX|j|_|jr�t�|j�}|j	r�|j
r�|j	s�|j
s�td��|j|_nd|_t|jr�|j�
�ng�|_t|j�|_|jr�|jnd|_dS)Nz+Invalid requirement, parse error at "{0!r}"�zInvalid URL given)�REQUIREMENTZparseStringrr�formatZlocr$r%�urlparseZschemeZnetloc�setr&ZasListrr/r0)�selfZrequirement_stringZreq�eZ
parsed_urlrrr�__init__Xs,����
zRequirement.__init__cCsz|jg}|jr*|�d�d�t|j����|jr@|�t|j��|jrX|�d�|j��|j	rp|�d�|j	��d�|�S)Nz[{0}]r!z@ {0}z; {0}r()
r$r&�appendr4�join�sortedr/�strr%r0)r7�partsrrr�__str__mszRequirement.__str__cCsd�t|��S)Nz<Requirement({0!r})>)r4r=)r7rrr�__repr__~szRequirement.__repr__N)rrrrr9r?r@rrrrr1Ksr1)DZ
__future__rrr�string�reZpkg_resources.extern.pyparsingrrrrr	r
rrr
r�LZ%pkg_resources.extern.six.moves.urllibrr5ZmarkersrrZ
specifiersrrr�
ValueErrorrZ
ascii_lettersZdigitsZALPHANUM�suppressZLBRACKETZRBRACKETZLPARENZRPAREN�COMMAZ	SEMICOLON�ATZPUNCTUATIONZIDENTIFIER_ENDZ
IDENTIFIER�NAMEZEXTRAZURIZURLZEXTRAS_LISTZEXTRASZ
_regex_str�VERBOSE�
IGNORECASEZVERSION_PEP440ZVERSION_LEGACYZVERSION_ONEZVERSION_MANYZ
_VERSION_SPECZsetParseActionZVERSION_SPECZMARKER_SEPERATORZMARKERZVERSION_AND_MARKERZURL_AND_MARKERZNAMED_REQUIREMENTr3�objectr1rrrr�<module>sf����site-packages/pkg_resources/_vendor/packaging/__pycache__/specifiers.cpython-38.opt-1.pyc000064400000046513151446177000025470 0ustar00U

�Qabym�@s�ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
ddlmZm
Z
mZGdd�de�ZGdd	�d	e
eje��ZGd
d�de�ZGdd
�d
e�Zdd�ZGdd�de�Ze�d�Zdd�Zdd�ZGdd�de�ZdS)�)�absolute_import�division�print_functionN�)�string_types�with_metaclass)�Version�
LegacyVersion�parsec@seZdZdZdS)�InvalidSpecifierzH
    An invalid specifier was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__�rr�N/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/specifiers.pyrsrc@s�eZdZejdd��Zejdd��Zejdd��Zejdd��Zej	d	d
��Z
e
jdd
��Z
ejdd
d��Zejddd��Z
dS)�
BaseSpecifiercCsdS)z�
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        Nr��selfrrr�__str__szBaseSpecifier.__str__cCsdS)zF
        Returns a hash value for this Specifier like object.
        Nrrrrr�__hash__szBaseSpecifier.__hash__cCsdS)zq
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        Nr�r�otherrrr�__eq__$szBaseSpecifier.__eq__cCsdS)zu
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        Nrrrrr�__ne__+szBaseSpecifier.__ne__cCsdS)zg
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        Nrrrrr�prereleases2szBaseSpecifier.prereleasescCsdS)zd
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr�r�valuerrrr9sNcCsdS)zR
        Determines if the given item is contained within this specifier.
        Nr�r�itemrrrr�contains@szBaseSpecifier.containscCsdS)z�
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        Nr)r�iterablerrrr�filterFszBaseSpecifier.filter)N)N)rr
r�abc�abstractmethodrrrr�abstractpropertyr�setterr r"rrrrrs 





rc@s�eZdZiZd dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zedd��Z
edd��Zedd��Zejdd��Zdd�Zd!dd�Zd"dd�ZdS)#�_IndividualSpecifier�NcCsF|j�|�}|std�|���|�d���|�d���f|_||_dS)NzInvalid specifier: '{0}'�operator�version)�_regex�searchr�format�group�strip�_spec�_prereleases)r�specr�matchrrr�__init__Rs�z_IndividualSpecifier.__init__cCs0|jdk	rd�|j�nd}d�|jjt|�|�S)N�, prereleases={0!r}r(z<{0}({1!r}{2})>)r1r-r�	__class__r�str�rZprerrr�__repr___s���z_IndividualSpecifier.__repr__cCsdj|j�S)Nz{0}{1})r-r0rrrrrlsz_IndividualSpecifier.__str__cCs
t|j�S�N)�hashr0rrrrrosz_IndividualSpecifier.__hash__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:��
isinstancerr6r�NotImplementedr0rrrrrrs
z_IndividualSpecifier.__eq__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:r<rrrrr}s
z_IndividualSpecifier.__ne__cCst|d�|j|��S)Nz_compare_{0})�getattrr-�
_operators)r�oprrr�
_get_operator�sz"_IndividualSpecifier._get_operatorcCst|ttf�st|�}|Sr:)r=r	rr
�rr*rrr�_coerce_version�sz$_IndividualSpecifier._coerce_versioncCs
|jdS)Nr�r0rrrrr)�sz_IndividualSpecifier.operatorcCs
|jdS)NrrErrrrr*�sz_IndividualSpecifier.versioncCs|jSr:�r1rrrrr�sz _IndividualSpecifier.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:�r �rrrrr�__contains__�sz!_IndividualSpecifier.__contains__cCs:|dkr|j}|�|�}|jr&|s&dS|�|j�||j�S�NF)rrD�
is_prereleaserBr)r*rrrrr �s

z_IndividualSpecifier.containsccs�d}g}d|dk	r|ndi}|D]B}|�|�}|j|f|�r |jrX|sX|jsX|�|�q d}|Vq |s||r||D]
}|VqpdS)NFrT)rDr rKr�append)rr!rZyielded�found_prereleases�kwr*�parsed_versionrrrr"�s"
��z_IndividualSpecifier.filter)r(N)N)N)rr
rr@r4r9rrrrrBrD�propertyr)r*rr&rIr r"rrrrr'Ns(







r'c@sveZdZdZe�dedejejB�Zdddddd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�LegacySpecifiera�
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        �^\s*�\s*$�equal�	not_equal�less_than_equal�greater_than_equal�	less_than�greater_than)�==�!=�<=�>=�<�>cCst|t�stt|��}|Sr:)r=r	r7rCrrrrD�s
zLegacySpecifier._coerce_versioncCs||�|�kSr:�rD�r�prospectiver2rrr�_compare_equal�szLegacySpecifier._compare_equalcCs||�|�kSr:r`rarrr�_compare_not_equal�sz"LegacySpecifier._compare_not_equalcCs||�|�kSr:r`rarrr�_compare_less_than_equal�sz(LegacySpecifier._compare_less_than_equalcCs||�|�kSr:r`rarrr�_compare_greater_than_equalsz+LegacySpecifier._compare_greater_than_equalcCs||�|�kSr:r`rarrr�_compare_less_thansz"LegacySpecifier._compare_less_thancCs||�|�kSr:r`rarrr�_compare_greater_thansz%LegacySpecifier._compare_greater_thanN)rr
r�
_regex_str�re�compile�VERBOSE�
IGNORECASEr+r@rDrcrdrerfrgrhrrrrrQ�s(�

��	rQcst����fdd��}|S)Ncst|t�sdS�|||�SrJ)r=rra��fnrr�wrappeds
z)_require_version_compare.<locals>.wrapped)�	functools�wraps)rorprrnr�_require_version_compare
srsc	@s�eZdZdZe�dedejejB�Zdddddd	d
dd�Z	e
d
d��Ze
dd��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��Ze
dd��Zdd�Zedd��Zejdd��Zd S)!�	Specifiera
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        rRrSZ
compatiblerTrUrVrWrXrYZ	arbitrary)�~=rZr[r\r]r^r_�===cCsNd�tt�dd�t|���dd��}|d7}|�d�||�oL|�d�||�S)N�.cSs|�d�o|�d�S)NZpostZdev)�
startswith��xrrr�<lambda>�s�z/Specifier._compare_compatible.<locals>.<lambda>����.*r]rZ)�join�list�	itertools�	takewhile�_version_splitrB)rrbr2�prefixrrr�_compare_compatible�s�����zSpecifier._compare_compatiblecCsp|�d�rPt|j�}t|dd��}tt|��}|dt|��}t||�\}}nt|�}|jsht|j�}||kS)Nr}���)�endswithrZpublicr�r7�len�_pad_version�localrarrrrc�s


zSpecifier._compare_equalcCs|�||�Sr:)rcrarrrrd�szSpecifier._compare_not_equalcCs|t|�kSr:�rrarrrre�sz"Specifier._compare_less_than_equalcCs|t|�kSr:r�rarrrrf�sz%Specifier._compare_greater_than_equalcCs<t|�}||ksdS|js8|jr8t|j�t|j�kr8dSdS�NFT)rrK�base_versionrarrrrg�szSpecifier._compare_less_thancCs^t|�}||ksdS|js8|jr8t|j�t|j�kr8dS|jdk	rZt|j�t|j�krZdSdSr�)rZis_postreleaser�r�rarrrrh�s
zSpecifier._compare_greater_thancCst|���t|���kSr:)r7�lowerrarrr�_compare_arbitraryszSpecifier._compare_arbitrarycCsR|jdk	r|jS|j\}}|dkrN|dkr@|�d�r@|dd�}t|�jrNdSdS)N)rZr]r\rurvrZr}r�TF)r1r0r�r
rK)rr)r*rrrrs


zSpecifier.prereleasescCs
||_dSr:rFrrrrrsN)rr
rrirjrkrlrmr+r@rsr�rcrdrerfrgrhr�rPrr&rrrrrtsD�_

��

"





rtz^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCs@g}|�d�D],}t�|�}|r0|�|���q|�|�q|S)Nrw)�split�
_prefix_regexr,�extend�groupsrL)r*�resultrr3rrrr�'s
r�c
Cs�gg}}|�tt�dd�|���|�tt�dd�|���|�|t|d�d��|�|t|d�d��|�ddgtdt|d�t|d���|�ddgtdt|d�t|d���ttj|��ttj|��fS)NcSs|��Sr:��isdigitryrrrr{6�z_pad_version.<locals>.<lambda>cSs|��Sr:r�ryrrrr{7r�rr�0)rLrr�r�r��insert�max�chain)�left�rightZ
left_splitZright_splitrrrr�2s 
"�"��r�c@s�eZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zedd��Z
e
jdd��Z
dd�Zddd�Zd dd�ZdS)!�SpecifierSetr(Nc	Csndd�|�d�D�}t�}|D]:}z|�t|��Wqtk
rV|�t|��YqXqt|�|_||_dS)NcSsg|]}|��r|���qSr)r/��.0�srrr�
<listcomp>Rsz)SpecifierSet.__init__.<locals>.<listcomp>�,)	r��set�addrtrrQ�	frozenset�_specsr1)rZ
specifiersrZparsed�	specifierrrrr4Os
zSpecifierSet.__init__cCs*|jdk	rd�|j�nd}d�t|�|�S)Nr5r(z<SpecifierSet({0!r}{1})>)r1r-rr7r8rrrr9ds
��zSpecifierSet.__repr__cCsd�tdd�|jD���S)Nr�css|]}t|�VqdSr:)r7r�rrr�	<genexpr>nsz'SpecifierSet.__str__.<locals>.<genexpr>)r~�sortedr�rrrrrmszSpecifierSet.__str__cCs
t|j�Sr:)r;r�rrrrrpszSpecifierSet.__hash__cCs�t|t�rt|�}nt|t�s"tSt�}t|j|jB�|_|jdkrX|jdk	rX|j|_n<|jdk	rv|jdkrv|j|_n|j|jkr�|j|_ntd��|S)NzFCannot combine SpecifierSets with True and False prerelease overrides.)r=rr�r>r�r�r1�
ValueError)rrr�rrr�__and__ss 





�zSpecifierSet.__and__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:�r=rr�r'r7r>r�rrrrr�s



zSpecifierSet.__eq__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:r�rrrrr�s



zSpecifierSet.__ne__cCs
t|j�Sr:)r�r�rrrr�__len__�szSpecifierSet.__len__cCs
t|j�Sr:)�iterr�rrrr�__iter__�szSpecifierSet.__iter__cCs.|jdk	r|jS|jsdStdd�|jD��S)Ncss|]}|jVqdSr:�rr�rrrr��sz+SpecifierSet.prereleases.<locals>.<genexpr>)r1r��anyrrrrr�s

zSpecifierSet.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:rGrHrrrrI�szSpecifierSet.__contains__csLt�ttf�st����dkr$|j��s2�jr2dSt��fdd�|jD��S)NFc3s|]}|j��d�VqdS)r�NrGr��rrrrr��s�z(SpecifierSet.contains.<locals>.<genexpr>)r=r	rr
rrK�allr�rrr�rr �s
�zSpecifierSet.containscCs�|dkr|j}|jr6|jD]}|j|t|�d�}q|Sg}g}|D]P}t|ttf�s^t|�}n|}t|t�rnqB|jr�|s�|s�|�	|�qB|�	|�qB|s�|r�|dkr�|S|SdS)Nr�)
rr�r"�boolr=r	rr
rKrL)rr!rr2ZfilteredrMrrOrrrr"�s*



zSpecifierSet.filter)r(N)N)N)rr
rr4r9rrr�rrr�r�rPrr&rIr r"rrrrr�Ms 
	




r�)Z
__future__rrrr#rqr�rjZ_compatrrr*rr	r
r�r�ABCMeta�objectrr'rQrsrtrkr�r�r�r�rrrr�<module>s&9	4	
site-packages/pkg_resources/_vendor/packaging/__pycache__/version.cpython-38.opt-1.pyc000064400000024612151446177000025015 0ustar00U

�Qab$-�	@s�ddlmZmZmZddlZddlZddlZddlmZddddd	gZ	e�
d
ddd
dddg�Zdd�ZGdd�de
�ZGdd�de�ZGdd�de�Ze�dej�Zdddddd�Zdd�Zdd�ZdZGd d�de�Zd!d"�Ze�d#�Zd$d%�Zd&d'�ZdS)(�)�absolute_import�division�print_functionN�)�Infinity�parse�Version�
LegacyVersion�InvalidVersion�VERSION_PATTERN�_Version�epoch�release�dev�pre�post�localcCs,z
t|�WStk
r&t|�YSXdS)z�
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    N)rr
r	)�version�r�K/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/version.pyrs
c@seZdZdZdS)r
zF
    An invalid version was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__rrrrr
$sc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)�_BaseVersioncCs
t|j�S�N)�hash�_key��selfrrr�__hash__,sz_BaseVersion.__hash__cCs|�|dd��S)NcSs||kSrr��s�orrr�<lambda>0�z%_BaseVersion.__lt__.<locals>.<lambda>��_compare�r�otherrrr�__lt__/sz_BaseVersion.__lt__cCs|�|dd��S)NcSs||kSrrr!rrrr$3r%z%_BaseVersion.__le__.<locals>.<lambda>r&r(rrr�__le__2sz_BaseVersion.__le__cCs|�|dd��S)NcSs||kSrrr!rrrr$6r%z%_BaseVersion.__eq__.<locals>.<lambda>r&r(rrr�__eq__5sz_BaseVersion.__eq__cCs|�|dd��S)NcSs||kSrrr!rrrr$9r%z%_BaseVersion.__ge__.<locals>.<lambda>r&r(rrr�__ge__8sz_BaseVersion.__ge__cCs|�|dd��S)NcSs||kSrrr!rrrr$<r%z%_BaseVersion.__gt__.<locals>.<lambda>r&r(rrr�__gt__;sz_BaseVersion.__gt__cCs|�|dd��S)NcSs||kSrrr!rrrr$?r%z%_BaseVersion.__ne__.<locals>.<lambda>r&r(rrr�__ne__>sz_BaseVersion.__ne__cCst|t�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr)�methodrrrr'As
z_BaseVersion._compareN)rrrr r*r+r,r-r.r/r'rrrrr*src@s`eZdZdd�Zdd�Zdd�Zedd��Zed	d
��Zedd��Z	ed
d��Z
edd��ZdS)r	cCst|�|_t|j�|_dSr)�str�_version�_legacy_cmpkeyr)rrrrr�__init__Js
zLegacyVersion.__init__cCs|jSr�r4rrrr�__str__NszLegacyVersion.__str__cCsd�tt|���S)Nz<LegacyVersion({0})>��format�reprr3rrrr�__repr__QszLegacyVersion.__repr__cCs|jSrr7rrrr�publicTszLegacyVersion.publiccCs|jSrr7rrrr�base_versionXszLegacyVersion.base_versioncCsdSrrrrrrr\szLegacyVersion.localcCsdS�NFrrrrr�
is_prerelease`szLegacyVersion.is_prereleasecCsdSr?rrrrr�is_postreleasedszLegacyVersion.is_postreleaseN)rrrr6r8r<�propertyr=r>rr@rArrrrr	Hs



z(\d+ | [a-z]+ | \.| -)�czfinal-�@)r�preview�-�rcrccs\t�|�D]F}t�||�}|r
|dkr(q
|dd�dkrF|�d�Vq
d|Vq
dVdS)N�.r�
0123456789��*�*final)�_legacy_version_component_re�split�_legacy_version_replacement_map�get�zfill)r"�partrrr�_parse_version_partsrsrScCszd}g}t|���D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�}||fS)N���rKrLz*final-Z00000000)rS�lower�
startswith�pop�append�tuple)rr
�partsrRrrrr5�s


r5a�
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
c@s|eZdZe�dedejejB�Zdd�Z	dd�Z
dd�Zed	d
��Z
edd��Zed
d��Zedd��Zedd��ZdS)rz^\s*z\s*$c
Cs�|j�|�}|std�|���t|�d�r8t|�d��ndtdd�|�d��d�D��t	|�d�|�d	��t	|�d
�|�d�p�|�d��t	|�d
�|�d��t
|�d��d�|_t|jj
|jj|jj|jj|jj|jj�|_dS)NzInvalid version: '{0}'r
rcss|]}t|�VqdSr)�int��.0�irrr�	<genexpr>�sz#Version.__init__.<locals>.<genexpr>rrHZpre_lZpre_nZpost_lZpost_n1Zpost_n2Zdev_lZdev_nr�r
rrrrr)�_regex�searchr
r:r�groupr[rYrN�_parse_letter_version�_parse_local_versionr4�_cmpkeyr
rrrrrr)rr�matchrrrr6�s8�����zVersion.__init__cCsd�tt|���S)Nz<Version({0})>r9rrrrr<�szVersion.__repr__cCs�g}|jjdkr$|�d�|jj��|�d�dd�|jjD���|jjdk	rl|�d�dd�|jjD���|jjdk	r�|�d�|jjd	��|jjdk	r�|�d
�|jjd	��|jj	dk	r�|�d�d�dd�|jj	D����d�|�S)
Nr�{0}!rHcss|]}t|�VqdSr�r3�r]�xrrrr_�sz"Version.__str__.<locals>.<genexpr>�css|]}t|�VqdSrrirjrrrr_�sz.post{0}rz.dev{0}z+{0}css|]}t|�VqdSrrirjrrrr_s)
r4r
rXr:�joinrrrrr�rrZrrrr8�s�zVersion.__str__cCst|��dd�dS)N�+rr�r3rNrrrrr=
szVersion.publiccCsLg}|jjdkr$|�d�|jj��|�d�dd�|jjD���d�|�S)NrrhrHcss|]}t|�VqdSrrirjrrrr_sz'Version.base_version.<locals>.<genexpr>rl)r4r
rXr:rmrrnrrrr>s
zVersion.base_versioncCs$t|�}d|kr |�dd�dSdS)Nrorrp)rZversion_stringrrrrsz
Version.localcCst|jjp|jj�Sr)�boolr4rrrrrrr@!szVersion.is_prereleasecCst|jj�Sr)rqr4rrrrrrA%szVersion.is_postreleaseN)rrr�re�compiler�VERBOSE�
IGNORECASErar6r<r8rBr=r>rr@rArrrrr�s"

�#



cCsv|rZ|dkrd}|��}|dkr&d}n(|dkr4d}n|dkrBd}n|dkrNd	}|t|�fS|sr|rrd	}|t|�fSdS)
NrZalpha�aZbeta�b)rCrrErG)Zrev�rr)rUr[)ZletterZnumberrrrrd*s rdz[\._-]cCs$|dk	r tdd�t�|�D��SdS)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Ncss&|]}|��s|��nt|�VqdSr)�isdigitrUr[)r]rRrrrr_Qs�z'_parse_local_version.<locals>.<genexpr>)rY�_local_version_seperatorsrN)rrrrreLs�recCs�tttt�dd�t|�����}|dkr@|dkr@|dk	r@t}n|dkrLt}|dkrZt}|dkrft}|dkrvt}ntdd�|D��}||||||fS)NcSs|dkS)Nrr)rkrrrr$`r%z_cmpkey.<locals>.<lambda>css*|]"}t|t�r|dfnt|fVqdS)rlN)r0r[rr\rrrr_�s�z_cmpkey.<locals>.<genexpr>)rY�reversed�list�	itertools�	dropwhilerr`rrrrfWs,���
	�rf)Z
__future__rrr�collectionsr}rrZ_structuresr�__all__�
namedtuplerr�
ValueErrorr
�objectrr	rsrtrMrOrSr5rrrdrzrerfrrrr�<module>sH��!�� k
site-packages/pkg_resources/_vendor/packaging/__pycache__/_structures.cpython-38.pyc000064400000005313151446177000024750 0ustar00U

�Qab��@sDddlmZmZmZGdd�de�Ze�ZGdd�de�Ze�ZdS)�)�absolute_import�division�print_functionc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)�InfinitycCsdS)Nr���selfrr�O/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/_structures.py�__repr__	szInfinity.__repr__cCstt|��S�N��hash�reprrrrr	�__hash__szInfinity.__hash__cCsdS�NFr�r�otherrrr	�__lt__szInfinity.__lt__cCsdSrrrrrr	�__le__szInfinity.__le__cCst||j�Sr��
isinstance�	__class__rrrr	�__eq__szInfinity.__eq__cCst||j�Srrrrrr	�__ne__szInfinity.__ne__cCsdS�NTrrrrr	�__gt__szInfinity.__gt__cCsdSrrrrrr	�__ge__szInfinity.__ge__cCstSr)�NegativeInfinityrrrr	�__neg__!szInfinity.__neg__N��__name__�
__module__�__qualname__r
rrrrrrrrrrrr	rsrc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)rcCsdS)Nz	-Infinityrrrrr	r
)szNegativeInfinity.__repr__cCstt|��Srrrrrr	r,szNegativeInfinity.__hash__cCsdSrrrrrr	r/szNegativeInfinity.__lt__cCsdSrrrrrr	r2szNegativeInfinity.__le__cCst||j�Srrrrrr	r5szNegativeInfinity.__eq__cCst||j�Srrrrrr	r8szNegativeInfinity.__ne__cCsdSrrrrrr	r;szNegativeInfinity.__gt__cCsdSrrrrrr	r>szNegativeInfinity.__ge__cCstSr)rrrrr	rAszNegativeInfinity.__neg__Nrrrrr	r'srN)Z
__future__rrr�objectrrrrrr	�<module>ssite-packages/pkg_resources/_vendor/packaging/__pycache__/__init__.cpython-38.pyc000064400000001041151446177000024117 0ustar00U

�Qab�@sTddlmZmZmZddlmZmZmZmZm	Z	m
Z
mZmZdddddd	d
dgZ
dS)
�)�absolute_import�division�print_function�)�
__author__�
__copyright__�	__email__�__license__�__summary__�	__title__�__uri__�__version__rr
rr
rrr	rN)Z
__future__rrr�	__about__rrrr	r
rrr
�__all__�rr�L/usr/lib/python3.8/site-packages/pkg_resources/_vendor/packaging/__init__.py�<module>s(�site-packages/pkg_resources/_vendor/packaging/__init__.py000064400000001001151446177000017625 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

from .__about__ import (
    __author__, __copyright__, __email__, __license__, __summary__, __title__,
    __uri__, __version__
)

__all__ = [
    "__title__", "__summary__", "__uri__", "__version__", "__author__",
    "__email__", "__license__", "__copyright__",
]
site-packages/pkg_resources/_vendor/packaging/markers.py000064400000020070151446177000017541 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import operator
import os
import platform
import sys

from pkg_resources.extern.pyparsing import ParseException, ParseResults, stringStart, stringEnd
from pkg_resources.extern.pyparsing import ZeroOrMore, Group, Forward, QuotedString
from pkg_resources.extern.pyparsing import Literal as L  # noqa

from ._compat import string_types
from .specifiers import Specifier, InvalidSpecifier


__all__ = [
    "InvalidMarker", "UndefinedComparison", "UndefinedEnvironmentName",
    "Marker", "default_environment",
]


class InvalidMarker(ValueError):
    """
    An invalid marker was found, users should refer to PEP 508.
    """


class UndefinedComparison(ValueError):
    """
    An invalid operation was attempted on a value that doesn't support it.
    """


class UndefinedEnvironmentName(ValueError):
    """
    A name was attempted to be used that does not exist inside of the
    environment.
    """


class Node(object):

    def __init__(self, value):
        self.value = value

    def __str__(self):
        return str(self.value)

    def __repr__(self):
        return "<{0}({1!r})>".format(self.__class__.__name__, str(self))

    def serialize(self):
        raise NotImplementedError


class Variable(Node):

    def serialize(self):
        return str(self)


class Value(Node):

    def serialize(self):
        return '"{0}"'.format(self)


class Op(Node):

    def serialize(self):
        return str(self)


VARIABLE = (
    L("implementation_version") |
    L("platform_python_implementation") |
    L("implementation_name") |
    L("python_full_version") |
    L("platform_release") |
    L("platform_version") |
    L("platform_machine") |
    L("platform_system") |
    L("python_version") |
    L("sys_platform") |
    L("os_name") |
    L("os.name") |  # PEP-345
    L("sys.platform") |  # PEP-345
    L("platform.version") |  # PEP-345
    L("platform.machine") |  # PEP-345
    L("platform.python_implementation") |  # PEP-345
    L("python_implementation") |  # undocumented setuptools legacy
    L("extra")
)
ALIASES = {
    'os.name': 'os_name',
    'sys.platform': 'sys_platform',
    'platform.version': 'platform_version',
    'platform.machine': 'platform_machine',
    'platform.python_implementation': 'platform_python_implementation',
    'python_implementation': 'platform_python_implementation'
}
VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0])))

VERSION_CMP = (
    L("===") |
    L("==") |
    L(">=") |
    L("<=") |
    L("!=") |
    L("~=") |
    L(">") |
    L("<")
)

MARKER_OP = VERSION_CMP | L("not in") | L("in")
MARKER_OP.setParseAction(lambda s, l, t: Op(t[0]))

MARKER_VALUE = QuotedString("'") | QuotedString('"')
MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0]))

BOOLOP = L("and") | L("or")

MARKER_VAR = VARIABLE | MARKER_VALUE

MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR)
MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0]))

LPAREN = L("(").suppress()
RPAREN = L(")").suppress()

MARKER_EXPR = Forward()
MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN)
MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR)

MARKER = stringStart + MARKER_EXPR + stringEnd


def _coerce_parse_result(results):
    if isinstance(results, ParseResults):
        return [_coerce_parse_result(i) for i in results]
    else:
        return results


def _format_marker(marker, first=True):
    assert isinstance(marker, (list, tuple, string_types))

    # Sometimes we have a structure like [[...]] which is a single item list
    # where the single item is itself it's own list. In that case we want skip
    # the rest of this function so that we don't get extraneous () on the
    # outside.
    if (isinstance(marker, list) and len(marker) == 1 and
            isinstance(marker[0], (list, tuple))):
        return _format_marker(marker[0])

    if isinstance(marker, list):
        inner = (_format_marker(m, first=False) for m in marker)
        if first:
            return " ".join(inner)
        else:
            return "(" + " ".join(inner) + ")"
    elif isinstance(marker, tuple):
        return " ".join([m.serialize() for m in marker])
    else:
        return marker


_operators = {
    "in": lambda lhs, rhs: lhs in rhs,
    "not in": lambda lhs, rhs: lhs not in rhs,
    "<": operator.lt,
    "<=": operator.le,
    "==": operator.eq,
    "!=": operator.ne,
    ">=": operator.ge,
    ">": operator.gt,
}


def _eval_op(lhs, op, rhs):
    try:
        spec = Specifier("".join([op.serialize(), rhs]))
    except InvalidSpecifier:
        pass
    else:
        return spec.contains(lhs)

    oper = _operators.get(op.serialize())
    if oper is None:
        raise UndefinedComparison(
            "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs)
        )

    return oper(lhs, rhs)


_undefined = object()


def _get_env(environment, name):
    value = environment.get(name, _undefined)

    if value is _undefined:
        raise UndefinedEnvironmentName(
            "{0!r} does not exist in evaluation environment.".format(name)
        )

    return value


def _evaluate_markers(markers, environment):
    groups = [[]]

    for marker in markers:
        assert isinstance(marker, (list, tuple, string_types))

        if isinstance(marker, list):
            groups[-1].append(_evaluate_markers(marker, environment))
        elif isinstance(marker, tuple):
            lhs, op, rhs = marker

            if isinstance(lhs, Variable):
                lhs_value = _get_env(environment, lhs.value)
                rhs_value = rhs.value
            else:
                lhs_value = lhs.value
                rhs_value = _get_env(environment, rhs.value)

            groups[-1].append(_eval_op(lhs_value, op, rhs_value))
        else:
            assert marker in ["and", "or"]
            if marker == "or":
                groups.append([])

    return any(all(item) for item in groups)


def format_full_version(info):
    version = '{0.major}.{0.minor}.{0.micro}'.format(info)
    kind = info.releaselevel
    if kind != 'final':
        version += kind[0] + str(info.serial)
    return version


def default_environment():
    if hasattr(sys, 'implementation'):
        iver = format_full_version(sys.implementation.version)
        implementation_name = sys.implementation.name
    else:
        iver = '0'
        implementation_name = ''

    return {
        "implementation_name": implementation_name,
        "implementation_version": iver,
        "os_name": os.name,
        "platform_machine": platform.machine(),
        "platform_release": platform.release(),
        "platform_system": platform.system(),
        "platform_version": platform.version(),
        "python_full_version": platform.python_version(),
        "platform_python_implementation": platform.python_implementation(),
        "python_version": platform.python_version()[:3],
        "sys_platform": sys.platform,
    }


class Marker(object):

    def __init__(self, marker):
        try:
            self._markers = _coerce_parse_result(MARKER.parseString(marker))
        except ParseException as e:
            err_str = "Invalid marker: {0!r}, parse error at {1!r}".format(
                marker, marker[e.loc:e.loc + 8])
            raise InvalidMarker(err_str)

    def __str__(self):
        return _format_marker(self._markers)

    def __repr__(self):
        return "<Marker({0!r})>".format(str(self))

    def evaluate(self, environment=None):
        """Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        """
        current_environment = default_environment()
        if environment is not None:
            current_environment.update(environment)

        return _evaluate_markers(self._markers, current_environment)
site-packages/pkg_resources/_vendor/packaging/_structures.py000064400000002610151446177000020457 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function


class Infinity(object):

    def __repr__(self):
        return "Infinity"

    def __hash__(self):
        return hash(repr(self))

    def __lt__(self, other):
        return False

    def __le__(self, other):
        return False

    def __eq__(self, other):
        return isinstance(other, self.__class__)

    def __ne__(self, other):
        return not isinstance(other, self.__class__)

    def __gt__(self, other):
        return True

    def __ge__(self, other):
        return True

    def __neg__(self):
        return NegativeInfinity

Infinity = Infinity()


class NegativeInfinity(object):

    def __repr__(self):
        return "-Infinity"

    def __hash__(self):
        return hash(repr(self))

    def __lt__(self, other):
        return True

    def __le__(self, other):
        return True

    def __eq__(self, other):
        return isinstance(other, self.__class__)

    def __ne__(self, other):
        return not isinstance(other, self.__class__)

    def __gt__(self, other):
        return False

    def __ge__(self, other):
        return False

    def __neg__(self):
        return Infinity

NegativeInfinity = NegativeInfinity()
site-packages/pkg_resources/_vendor/packaging/requirements.py000064400000010403151446177000020617 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import string
import re

from pkg_resources.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException
from pkg_resources.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine
from pkg_resources.extern.pyparsing import Literal as L  # noqa
from pkg_resources.extern.six.moves.urllib import parse as urlparse

from .markers import MARKER_EXPR, Marker
from .specifiers import LegacySpecifier, Specifier, SpecifierSet


class InvalidRequirement(ValueError):
    """
    An invalid requirement was found, users should refer to PEP 508.
    """


ALPHANUM = Word(string.ascii_letters + string.digits)

LBRACKET = L("[").suppress()
RBRACKET = L("]").suppress()
LPAREN = L("(").suppress()
RPAREN = L(")").suppress()
COMMA = L(",").suppress()
SEMICOLON = L(";").suppress()
AT = L("@").suppress()

PUNCTUATION = Word("-_.")
IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))

NAME = IDENTIFIER("name")
EXTRA = IDENTIFIER

URI = Regex(r'[^ ]+')("url")
URL = (AT + URI)

EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")

VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)

VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
VERSION_MANY = Combine(VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE),
                       joinString=",", adjacent=False)("_raw_spec")
_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY))
_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or '')

VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
VERSION_SPEC.setParseAction(lambda s, l, t: t[1])

MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
MARKER_EXPR.setParseAction(
    lambda s, l, t: Marker(s[t._original_start:t._original_end])
)
MARKER_SEPERATOR = SEMICOLON
MARKER = MARKER_SEPERATOR + MARKER_EXPR

VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
URL_AND_MARKER = URL + Optional(MARKER)

NAMED_REQUIREMENT = \
    NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)

REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd


class Requirement(object):
    """Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    """

    # TODO: Can we test whether something is contained within a requirement?
    #       If so how do we do that? Do we need to test against the _name_ of
    #       the thing as well as the version? What about the markers?
    # TODO: Can we normalize the name and extra name?

    def __init__(self, requirement_string):
        try:
            req = REQUIREMENT.parseString(requirement_string)
        except ParseException as e:
            raise InvalidRequirement(
                "Invalid requirement, parse error at \"{0!r}\"".format(
                    requirement_string[e.loc:e.loc + 8]))

        self.name = req.name
        if req.url:
            parsed_url = urlparse.urlparse(req.url)
            if not (parsed_url.scheme and parsed_url.netloc) or (
                    not parsed_url.scheme and not parsed_url.netloc):
                raise InvalidRequirement("Invalid URL given")
            self.url = req.url
        else:
            self.url = None
        self.extras = set(req.extras.asList() if req.extras else [])
        self.specifier = SpecifierSet(req.specifier)
        self.marker = req.marker if req.marker else None

    def __str__(self):
        parts = [self.name]

        if self.extras:
            parts.append("[{0}]".format(",".join(sorted(self.extras))))

        if self.specifier:
            parts.append(str(self.specifier))

        if self.url:
            parts.append("@ {0}".format(self.url))

        if self.marker:
            parts.append("; {0}".format(self.marker))

        return "".join(parts)

    def __repr__(self):
        return "<Requirement({0!r})>".format(str(self))
site-packages/pkg_resources/_vendor/six.py000064400000072622151446177000014766 0ustar00"""Utilities for writing code that runs on Python 2 and 3"""

# Copyright (c) 2010-2015 Benjamin Peterson
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.

from __future__ import absolute_import

import functools
import itertools
import operator
import sys
import types

__author__ = "Benjamin Peterson <benjamin@python.org>"
__version__ = "1.10.0"


# Useful for very coarse version differentiation.
PY2 = sys.version_info[0] == 2
PY3 = sys.version_info[0] == 3
PY34 = sys.version_info[0:2] >= (3, 4)

if PY3:
    string_types = str,
    integer_types = int,
    class_types = type,
    text_type = str
    binary_type = bytes

    MAXSIZE = sys.maxsize
else:
    string_types = basestring,
    integer_types = (int, long)
    class_types = (type, types.ClassType)
    text_type = unicode
    binary_type = str

    if sys.platform.startswith("java"):
        # Jython always uses 32 bits.
        MAXSIZE = int((1 << 31) - 1)
    else:
        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
        class X(object):

            def __len__(self):
                return 1 << 31
        try:
            len(X())
        except OverflowError:
            # 32-bit
            MAXSIZE = int((1 << 31) - 1)
        else:
            # 64-bit
            MAXSIZE = int((1 << 63) - 1)
        del X


def _add_doc(func, doc):
    """Add documentation to a function."""
    func.__doc__ = doc


def _import_module(name):
    """Import module, returning the module after the last dot."""
    __import__(name)
    return sys.modules[name]


class _LazyDescr(object):

    def __init__(self, name):
        self.name = name

    def __get__(self, obj, tp):
        result = self._resolve()
        setattr(obj, self.name, result)  # Invokes __set__.
        try:
            # This is a bit ugly, but it avoids running this again by
            # removing this descriptor.
            delattr(obj.__class__, self.name)
        except AttributeError:
            pass
        return result


class MovedModule(_LazyDescr):

    def __init__(self, name, old, new=None):
        super(MovedModule, self).__init__(name)
        if PY3:
            if new is None:
                new = name
            self.mod = new
        else:
            self.mod = old

    def _resolve(self):
        return _import_module(self.mod)

    def __getattr__(self, attr):
        _module = self._resolve()
        value = getattr(_module, attr)
        setattr(self, attr, value)
        return value


class _LazyModule(types.ModuleType):

    def __init__(self, name):
        super(_LazyModule, self).__init__(name)
        self.__doc__ = self.__class__.__doc__

    def __dir__(self):
        attrs = ["__doc__", "__name__"]
        attrs += [attr.name for attr in self._moved_attributes]
        return attrs

    # Subclasses should override this
    _moved_attributes = []


class MovedAttribute(_LazyDescr):

    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
        super(MovedAttribute, self).__init__(name)
        if PY3:
            if new_mod is None:
                new_mod = name
            self.mod = new_mod
            if new_attr is None:
                if old_attr is None:
                    new_attr = name
                else:
                    new_attr = old_attr
            self.attr = new_attr
        else:
            self.mod = old_mod
            if old_attr is None:
                old_attr = name
            self.attr = old_attr

    def _resolve(self):
        module = _import_module(self.mod)
        return getattr(module, self.attr)


class _SixMetaPathImporter(object):

    """
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    """

    def __init__(self, six_module_name):
        self.name = six_module_name
        self.known_modules = {}

    def _add_module(self, mod, *fullnames):
        for fullname in fullnames:
            self.known_modules[self.name + "." + fullname] = mod

    def _get_module(self, fullname):
        return self.known_modules[self.name + "." + fullname]

    def find_module(self, fullname, path=None):
        if fullname in self.known_modules:
            return self
        return None

    def __get_module(self, fullname):
        try:
            return self.known_modules[fullname]
        except KeyError:
            raise ImportError("This loader does not know module " + fullname)

    def load_module(self, fullname):
        try:
            # in case of a reload
            return sys.modules[fullname]
        except KeyError:
            pass
        mod = self.__get_module(fullname)
        if isinstance(mod, MovedModule):
            mod = mod._resolve()
        else:
            mod.__loader__ = self
        sys.modules[fullname] = mod
        return mod

    def is_package(self, fullname):
        """
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        """
        return hasattr(self.__get_module(fullname), "__path__")

    def get_code(self, fullname):
        """Return None

        Required, if is_package is implemented"""
        self.__get_module(fullname)  # eventually raises ImportError
        return None
    get_source = get_code  # same as get_code

_importer = _SixMetaPathImporter(__name__)


class _MovedItems(_LazyModule):

    """Lazy loading of moved objects"""
    __path__ = []  # mark as package


_moved_attributes = [
    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
    MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"),
    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
    MovedAttribute("intern", "__builtin__", "sys"),
    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"),
    MovedAttribute("reduce", "__builtin__", "functools"),
    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
    MovedAttribute("StringIO", "StringIO", "io"),
    MovedAttribute("UserDict", "UserDict", "collections"),
    MovedAttribute("UserList", "UserList", "collections"),
    MovedAttribute("UserString", "UserString", "collections"),
    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
    MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"),
    MovedModule("builtins", "__builtin__"),
    MovedModule("configparser", "ConfigParser"),
    MovedModule("copyreg", "copy_reg"),
    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
    MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"),
    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
    MovedModule("http_cookies", "Cookie", "http.cookies"),
    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
    MovedModule("html_parser", "HTMLParser", "html.parser"),
    MovedModule("http_client", "httplib", "http.client"),
    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
    MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"),
    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
    MovedModule("cPickle", "cPickle", "pickle"),
    MovedModule("queue", "Queue"),
    MovedModule("reprlib", "repr"),
    MovedModule("socketserver", "SocketServer"),
    MovedModule("_thread", "thread", "_thread"),
    MovedModule("tkinter", "Tkinter"),
    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
    MovedModule("tkinter_colorchooser", "tkColorChooser",
                "tkinter.colorchooser"),
    MovedModule("tkinter_commondialog", "tkCommonDialog",
                "tkinter.commondialog"),
    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog",
                "tkinter.simpledialog"),
    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
]
# Add windows specific modules.
if sys.platform == "win32":
    _moved_attributes += [
        MovedModule("winreg", "_winreg"),
    ]

for attr in _moved_attributes:
    setattr(_MovedItems, attr.name, attr)
    if isinstance(attr, MovedModule):
        _importer._add_module(attr, "moves." + attr.name)
del attr

_MovedItems._moved_attributes = _moved_attributes

moves = _MovedItems(__name__ + ".moves")
_importer._add_module(moves, "moves")


class Module_six_moves_urllib_parse(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_parse"""


_urllib_parse_moved_attributes = [
    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
    MovedAttribute("quote", "urllib", "urllib.parse"),
    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
    MovedAttribute("unquote", "urllib", "urllib.parse"),
    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
    MovedAttribute("urlencode", "urllib", "urllib.parse"),
    MovedAttribute("splitquery", "urllib", "urllib.parse"),
    MovedAttribute("splittag", "urllib", "urllib.parse"),
    MovedAttribute("splituser", "urllib", "urllib.parse"),
    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
]
for attr in _urllib_parse_moved_attributes:
    setattr(Module_six_moves_urllib_parse, attr.name, attr)
del attr

Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes

_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
                      "moves.urllib_parse", "moves.urllib.parse")


class Module_six_moves_urllib_error(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_error"""


_urllib_error_moved_attributes = [
    MovedAttribute("URLError", "urllib2", "urllib.error"),
    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
]
for attr in _urllib_error_moved_attributes:
    setattr(Module_six_moves_urllib_error, attr.name, attr)
del attr

Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes

_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
                      "moves.urllib_error", "moves.urllib.error")


class Module_six_moves_urllib_request(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_request"""


_urllib_request_moved_attributes = [
    MovedAttribute("urlopen", "urllib2", "urllib.request"),
    MovedAttribute("install_opener", "urllib2", "urllib.request"),
    MovedAttribute("build_opener", "urllib2", "urllib.request"),
    MovedAttribute("pathname2url", "urllib", "urllib.request"),
    MovedAttribute("url2pathname", "urllib", "urllib.request"),
    MovedAttribute("getproxies", "urllib", "urllib.request"),
    MovedAttribute("Request", "urllib2", "urllib.request"),
    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
    MovedAttribute("URLopener", "urllib", "urllib.request"),
    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
]
for attr in _urllib_request_moved_attributes:
    setattr(Module_six_moves_urllib_request, attr.name, attr)
del attr

Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes

_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
                      "moves.urllib_request", "moves.urllib.request")


class Module_six_moves_urllib_response(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_response"""


_urllib_response_moved_attributes = [
    MovedAttribute("addbase", "urllib", "urllib.response"),
    MovedAttribute("addclosehook", "urllib", "urllib.response"),
    MovedAttribute("addinfo", "urllib", "urllib.response"),
    MovedAttribute("addinfourl", "urllib", "urllib.response"),
]
for attr in _urllib_response_moved_attributes:
    setattr(Module_six_moves_urllib_response, attr.name, attr)
del attr

Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes

_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
                      "moves.urllib_response", "moves.urllib.response")


class Module_six_moves_urllib_robotparser(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_robotparser"""


_urllib_robotparser_moved_attributes = [
    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
]
for attr in _urllib_robotparser_moved_attributes:
    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
del attr

Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes

_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
                      "moves.urllib_robotparser", "moves.urllib.robotparser")


class Module_six_moves_urllib(types.ModuleType):

    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
    __path__ = []  # mark as package
    parse = _importer._get_module("moves.urllib_parse")
    error = _importer._get_module("moves.urllib_error")
    request = _importer._get_module("moves.urllib_request")
    response = _importer._get_module("moves.urllib_response")
    robotparser = _importer._get_module("moves.urllib_robotparser")

    def __dir__(self):
        return ['parse', 'error', 'request', 'response', 'robotparser']

_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"),
                      "moves.urllib")


def add_move(move):
    """Add an item to six.moves."""
    setattr(_MovedItems, move.name, move)


def remove_move(name):
    """Remove item from six.moves."""
    try:
        delattr(_MovedItems, name)
    except AttributeError:
        try:
            del moves.__dict__[name]
        except KeyError:
            raise AttributeError("no such move, %r" % (name,))


if PY3:
    _meth_func = "__func__"
    _meth_self = "__self__"

    _func_closure = "__closure__"
    _func_code = "__code__"
    _func_defaults = "__defaults__"
    _func_globals = "__globals__"
else:
    _meth_func = "im_func"
    _meth_self = "im_self"

    _func_closure = "func_closure"
    _func_code = "func_code"
    _func_defaults = "func_defaults"
    _func_globals = "func_globals"


try:
    advance_iterator = next
except NameError:
    def advance_iterator(it):
        return it.next()
next = advance_iterator


try:
    callable = callable
except NameError:
    def callable(obj):
        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)


if PY3:
    def get_unbound_function(unbound):
        return unbound

    create_bound_method = types.MethodType

    def create_unbound_method(func, cls):
        return func

    Iterator = object
else:
    def get_unbound_function(unbound):
        return unbound.im_func

    def create_bound_method(func, obj):
        return types.MethodType(func, obj, obj.__class__)

    def create_unbound_method(func, cls):
        return types.MethodType(func, None, cls)

    class Iterator(object):

        def next(self):
            return type(self).__next__(self)

    callable = callable
_add_doc(get_unbound_function,
         """Get the function out of a possibly unbound function""")


get_method_function = operator.attrgetter(_meth_func)
get_method_self = operator.attrgetter(_meth_self)
get_function_closure = operator.attrgetter(_func_closure)
get_function_code = operator.attrgetter(_func_code)
get_function_defaults = operator.attrgetter(_func_defaults)
get_function_globals = operator.attrgetter(_func_globals)


if PY3:
    def iterkeys(d, **kw):
        return iter(d.keys(**kw))

    def itervalues(d, **kw):
        return iter(d.values(**kw))

    def iteritems(d, **kw):
        return iter(d.items(**kw))

    def iterlists(d, **kw):
        return iter(d.lists(**kw))

    viewkeys = operator.methodcaller("keys")

    viewvalues = operator.methodcaller("values")

    viewitems = operator.methodcaller("items")
else:
    def iterkeys(d, **kw):
        return d.iterkeys(**kw)

    def itervalues(d, **kw):
        return d.itervalues(**kw)

    def iteritems(d, **kw):
        return d.iteritems(**kw)

    def iterlists(d, **kw):
        return d.iterlists(**kw)

    viewkeys = operator.methodcaller("viewkeys")

    viewvalues = operator.methodcaller("viewvalues")

    viewitems = operator.methodcaller("viewitems")

_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
_add_doc(iteritems,
         "Return an iterator over the (key, value) pairs of a dictionary.")
_add_doc(iterlists,
         "Return an iterator over the (key, [values]) pairs of a dictionary.")


if PY3:
    def b(s):
        return s.encode("latin-1")

    def u(s):
        return s
    unichr = chr
    import struct
    int2byte = struct.Struct(">B").pack
    del struct
    byte2int = operator.itemgetter(0)
    indexbytes = operator.getitem
    iterbytes = iter
    import io
    StringIO = io.StringIO
    BytesIO = io.BytesIO
    _assertCountEqual = "assertCountEqual"
    if sys.version_info[1] <= 1:
        _assertRaisesRegex = "assertRaisesRegexp"
        _assertRegex = "assertRegexpMatches"
    else:
        _assertRaisesRegex = "assertRaisesRegex"
        _assertRegex = "assertRegex"
else:
    def b(s):
        return s
    # Workaround for standalone backslash

    def u(s):
        return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape")
    unichr = unichr
    int2byte = chr

    def byte2int(bs):
        return ord(bs[0])

    def indexbytes(buf, i):
        return ord(buf[i])
    iterbytes = functools.partial(itertools.imap, ord)
    import StringIO
    StringIO = BytesIO = StringIO.StringIO
    _assertCountEqual = "assertItemsEqual"
    _assertRaisesRegex = "assertRaisesRegexp"
    _assertRegex = "assertRegexpMatches"
_add_doc(b, """Byte literal""")
_add_doc(u, """Text literal""")


def assertCountEqual(self, *args, **kwargs):
    return getattr(self, _assertCountEqual)(*args, **kwargs)


def assertRaisesRegex(self, *args, **kwargs):
    return getattr(self, _assertRaisesRegex)(*args, **kwargs)


def assertRegex(self, *args, **kwargs):
    return getattr(self, _assertRegex)(*args, **kwargs)


if PY3:
    exec_ = getattr(moves.builtins, "exec")

    def reraise(tp, value, tb=None):
        if value is None:
            value = tp()
        if value.__traceback__ is not tb:
            raise value.with_traceback(tb)
        raise value

else:
    def exec_(_code_, _globs_=None, _locs_=None):
        """Execute code in a namespace."""
        if _globs_ is None:
            frame = sys._getframe(1)
            _globs_ = frame.f_globals
            if _locs_ is None:
                _locs_ = frame.f_locals
            del frame
        elif _locs_ is None:
            _locs_ = _globs_
        exec("""exec _code_ in _globs_, _locs_""")

    exec_("""def reraise(tp, value, tb=None):
    raise tp, value, tb
""")


if sys.version_info[:2] == (3, 2):
    exec_("""def raise_from(value, from_value):
    if from_value is None:
        raise value
    raise value from from_value
""")
elif sys.version_info[:2] > (3, 2):
    exec_("""def raise_from(value, from_value):
    raise value from from_value
""")
else:
    def raise_from(value, from_value):
        raise value


print_ = getattr(moves.builtins, "print", None)
if print_ is None:
    def print_(*args, **kwargs):
        """The new-style print function for Python 2.4 and 2.5."""
        fp = kwargs.pop("file", sys.stdout)
        if fp is None:
            return

        def write(data):
            if not isinstance(data, basestring):
                data = str(data)
            # If the file has an encoding, encode unicode with it.
            if (isinstance(fp, file) and
                    isinstance(data, unicode) and
                    fp.encoding is not None):
                errors = getattr(fp, "errors", None)
                if errors is None:
                    errors = "strict"
                data = data.encode(fp.encoding, errors)
            fp.write(data)
        want_unicode = False
        sep = kwargs.pop("sep", None)
        if sep is not None:
            if isinstance(sep, unicode):
                want_unicode = True
            elif not isinstance(sep, str):
                raise TypeError("sep must be None or a string")
        end = kwargs.pop("end", None)
        if end is not None:
            if isinstance(end, unicode):
                want_unicode = True
            elif not isinstance(end, str):
                raise TypeError("end must be None or a string")
        if kwargs:
            raise TypeError("invalid keyword arguments to print()")
        if not want_unicode:
            for arg in args:
                if isinstance(arg, unicode):
                    want_unicode = True
                    break
        if want_unicode:
            newline = unicode("\n")
            space = unicode(" ")
        else:
            newline = "\n"
            space = " "
        if sep is None:
            sep = space
        if end is None:
            end = newline
        for i, arg in enumerate(args):
            if i:
                write(sep)
            write(arg)
        write(end)
if sys.version_info[:2] < (3, 3):
    _print = print_

    def print_(*args, **kwargs):
        fp = kwargs.get("file", sys.stdout)
        flush = kwargs.pop("flush", False)
        _print(*args, **kwargs)
        if flush and fp is not None:
            fp.flush()

_add_doc(reraise, """Reraise an exception.""")

if sys.version_info[0:2] < (3, 4):
    def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS,
              updated=functools.WRAPPER_UPDATES):
        def wrapper(f):
            f = functools.wraps(wrapped, assigned, updated)(f)
            f.__wrapped__ = wrapped
            return f
        return wrapper
else:
    wraps = functools.wraps


def with_metaclass(meta, *bases):
    """Create a base class with a metaclass."""
    # This requires a bit of explanation: the basic idea is to make a dummy
    # metaclass for one level of class instantiation that replaces itself with
    # the actual metaclass.
    class metaclass(meta):

        def __new__(cls, name, this_bases, d):
            return meta(name, bases, d)
    return type.__new__(metaclass, 'temporary_class', (), {})


def add_metaclass(metaclass):
    """Class decorator for creating a class with a metaclass."""
    def wrapper(cls):
        orig_vars = cls.__dict__.copy()
        slots = orig_vars.get('__slots__')
        if slots is not None:
            if isinstance(slots, str):
                slots = [slots]
            for slots_var in slots:
                orig_vars.pop(slots_var)
        orig_vars.pop('__dict__', None)
        orig_vars.pop('__weakref__', None)
        return metaclass(cls.__name__, cls.__bases__, orig_vars)
    return wrapper


def python_2_unicode_compatible(klass):
    """
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    """
    if PY2:
        if '__str__' not in klass.__dict__:
            raise ValueError("@python_2_unicode_compatible cannot be applied "
                             "to %s because it doesn't define __str__()." %
                             klass.__name__)
        klass.__unicode__ = klass.__str__
        klass.__str__ = lambda self: self.__unicode__().encode('utf-8')
    return klass


# Complete the moves implementation.
# This code is at the end of this module to speed up module loading.
# Turn this module into a package.
__path__ = []  # required for PEP 302 and PEP 451
__package__ = __name__  # see PEP 366 @ReservedAssignment
if globals().get("__spec__") is not None:
    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
# Remove other six meta path importers, since they cause problems. This can
# happen if six is removed from sys.modules and then reloaded. (Setuptools does
# this for some reason.)
if sys.meta_path:
    for i, importer in enumerate(sys.meta_path):
        # Here's some real nastiness: Another "instance" of the six module might
        # be floating around. Therefore, we can't use isinstance() to check for
        # the six meta path importer, since the other six instance will have
        # inserted an importer with different class.
        if (type(importer).__name__ == "_SixMetaPathImporter" and
                importer.name == __name__):
            del sys.meta_path[i]
            break
    del i, importer
# Finally, add the importer to the meta path import hook.
sys.meta_path.append(_importer)
site-packages/pkg_resources/_vendor/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000235151446177000023136 0ustar00U

�Qab�@sdS)N�rrr�B/usr/lib/python3.8/site-packages/pkg_resources/_vendor/__init__.py�<module>�site-packages/pkg_resources/_vendor/__pycache__/appdirs.cpython-38.opt-1.pyc000064400000050036151446177000023045 0ustar00U

�Qabg`�@s�dZdZd�eee��ZddlZddlZejddkZ	e	r>eZ
ej�d�r�ddlZe�
�ddZe�d�rrdZq�e�d	�r�d
Zq�dZnejZd4d
d�Zd5dd�Zd6dd�Zd7dd�Zd8dd�Zd9dd�Zd:dd�ZGdd�de�Zdd�Zd d!�Zd"d#�Zd$d%�Zedk�r�zddlZeZWnne k
�r�zdd&l!m"Z"eZWnBe k
�r�zddl#Z$eZWne k
�r�eZYnXYnXYnXe%d'k�r�d(Z&d)Z'd*Z(e)d+e�e)d,�ee&e'd-d.�Z*e(D]Z+e)d/e+e,e*e+�f��q�e)d0�ee&e'�Z*e(D]Z+e)d/e+e,e*e+�f��q�e)d1�ee&�Z*e(D]Z+e)d/e+e,e*e+�f��q0e)d2�ee&dd3�Z*e(D]Z+e)d/e+e,e*e+�f��qfdS);zyUtilities for determining application-specific dirs.

See <http://github.com/ActiveState/appdirs> for details and usage.
)����.�Nr�javaZWindows�win32ZMac�darwinZlinux2FcCs�tdkr^|dkr|}|rdpd}tj�t|��}|r�|dk	rNtj�|||�}q�tj�||�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aJReturn full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        Mac OS X:               ~/Library/Application Support/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    rN�
CSIDL_APPDATA�CSIDL_LOCAL_APPDATAFrz~/Library/Application Support/Z
XDG_DATA_HOMEz~/.local/share��system�os�path�normpath�_get_win_folder�join�
expanduser�getenv)�appname�	appauthor�version�roaming�constr�r�A/usr/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py�
user_data_dir,s& rcstdkrR|dkr�}tj�td��}�r�|dk	rBtj�||��}q�tj�|��}n�tdkrztj�d�}�r�tj�|��}ntt�dtj�dd	g��}d
d�|�	tj�D�}�r�|r�tj��|���fdd�|D�}|r�tj�|�}n|d
}|S��r|�rtj�||�}|S)aiReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of data dirs should be
            returned. By default, the first item from XDG_DATA_DIRS is
            returned, or '/usr/local/share/<AppName>',
            if XDG_DATA_DIRS is not set

    Typical site data directories are:
        Mac OS X:   /Library/Application Support/<AppName>
        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.

    For Unix, this is using the $XDG_DATA_DIRS[0] default.

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    rN�CSIDL_COMMON_APPDATAFrz/Library/Application SupportZ
XDG_DATA_DIRSz/usr/local/sharez
/usr/sharecSs g|]}tj�|�tj���qSr�r
rr�rstrip�sep��.0�xrrr�
<listcomp>�sz!site_data_dir.<locals>.<listcomp>csg|]}tj�|�g��qSr�r
rrr �rrrr#�sr)
rr
rrrrrr�pathsep�split�rrr�	multipathrZpathlistrr%r�
site_data_dircs6�r*cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)a�Return full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user config directories are:
        Mac OS X:               same as user_data_dir
        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    �rrNZXDG_CONFIG_HOMEz	~/.config�rrr
rrrr�rrrrrrrr�user_config_dir�sr.cs�tdkr*t�|�}�r�|r�tj�||�}ndt�dd�}dd�|�tj�D�}�rt|rbtj��|���fdd�|D�}|r�tj�|�}n|d}|S)aReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of config dirs should be
            returned. By default, the first item from XDG_CONFIG_DIRS is
            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set

    Typical site config directories are:
        Mac OS X:   same as site_data_dir
        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
                    $XDG_CONFIG_DIRS
        Win *:      same as site_data_dir
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)

    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    r+ZXDG_CONFIG_DIRSz/etc/xdgcSs g|]}tj�|�tj���qSrrr rrrr#�sz#site_config_dir.<locals>.<listcomp>csg|]}tj�|�g��qSrr$r r%rrr#�sr)rr*r
rrrr'r&r(rr%r�site_config_dir�s
r/TcCs�tdkrd|dkr|}tj�td��}|r�|dk	rBtj�|||�}ntj�||�}|r�tj�|d�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aReturn full path to the user-specific cache dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Cache" to the base app data dir for Windows. See
            discussion below.

    Typical user cache directories are:
        Mac OS X:   ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go in
    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
    app data dir (the default returned by `user_data_dir` above). Apps typically
    put cache data somewhere *under* the given dir here. Some examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0
    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    This can be disabled with the `opinion=False` option.
    rNr
FZCacherz~/Library/CachesZXDG_CACHE_HOMEz~/.cacher�rrrZopinionrrrr�user_cache_dirs(!r1cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)aReturn full path to the user-specific state dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user state directories are:
        Mac OS X:  same as user_data_dir
        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
        Win *:     same as user_data_dir

    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
    to extend the XDG spec and support $XDG_STATE_HOME.

    That means, by default "~/.local/state/<AppName>".
    r+NZXDG_STATE_HOMEz~/.local/stater,r-rrr�user_state_dir9sr2cCs�tdkr tj�tj�d�|�}nNtdkrLt|||�}d}|rntj�|d�}n"t|||�}d}|rntj�|d�}|r�|r�tj�||�}|S)a�Return full path to the user-specific log dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Logs" to the base app data dir for Windows, and "log" to the
            base cache dir for Unix. See discussion below.

    Typical user log directories are:
        Mac OS X:   ~/Library/Logs/<AppName>
        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs

    On Windows the only suggestion in the MSDN docs is that local settings
    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
    examples of what some windows apps use for a logs dir.)

    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
    value for Windows and appends "log" to the user cache dir for Unix.
    This can be disabled with the `opinion=False` option.
    rz~/Library/LogsrFZLogs�log)rr
rrrrr1r0rrr�user_log_dircs" 
�r4c@sneZdZdZddd�Zedd��Zedd	��Zed
d��Zedd
��Z	edd��Z
edd��Zedd��ZdS)�AppDirsz1Convenience wrapper for getting application dirs.NFcCs"||_||_||_||_||_dS)N)rrrrr))�selfrrrrr)rrr�__init__�s
zAppDirs.__init__cCst|j|j|j|jd�S�N)rr)rrrrr�r6rrrr�s
�zAppDirs.user_data_dircCst|j|j|j|jd�S�N)rr))r*rrrr)r9rrrr*�s
�zAppDirs.site_data_dircCst|j|j|j|jd�Sr8)r.rrrrr9rrrr.�s
�zAppDirs.user_config_dircCst|j|j|j|jd�Sr:)r/rrrr)r9rrrr/�s
�zAppDirs.site_config_dircCst|j|j|jd�S�N�r)r1rrrr9rrrr1�s
�zAppDirs.user_cache_dircCst|j|j|jd�Sr;)r2rrrr9rrrr2�s
�zAppDirs.user_state_dircCst|j|j|jd�Sr;)r4rrrr9rrrr4�s
�zAppDirs.user_log_dir)NNNFF)
�__name__�
__module__�__qualname__�__doc__r7�propertyrr*r.r/r1r2r4rrrrr5�s&�






r5cCsHtrddl}nddl}dddd�|}|�|jd�}|�||�\}}|S)z�This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    rNZAppDatazCommon AppDataz
Local AppData�r	rr
z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)�PY3�winreg�_winreg�OpenKey�HKEY_CURRENT_USERZQueryValueEx)�
csidl_namerEZshell_folder_name�key�dir�typerrr�_get_win_folder_from_registry�s
���rLcCs�ddlm}m}|�dt||�dd�}z^t|�}d}|D]}t|�dkr8d}qRq8|r�zddl}|�|�}Wnt	k
r�YnXWnt
k
r�YnX|S)Nr)�shellcon�shellF�T)�win32com.shellrMrN�SHGetFolderPath�getattr�unicode�ord�win32api�GetShortPathName�ImportError�UnicodeError)rHrMrNrJ�
has_high_char�crUrrr�_get_win_folder_with_pywin32�s$
r[cCs�ddl}dddd�|}|�d�}|jj�d|dd|�d}|D]}t|�dkr@d	}qZq@|r�|�d�}|jj�|j|d�r�|}|jS)
Nr��#�rBiFrOT)	�ctypesZcreate_unicode_buffer�windllZshell32ZSHGetFolderPathWrTZkernel32ZGetShortPathNameW�value)rHr_Zcsidl_const�bufrYrZZbuf2rrr�_get_win_folder_with_ctypes�s&��

rccCs�ddl}ddlm}ddlm}|jjd}|�d|�}|jj	}|�
dt|j|�d|jj
|�|j�|����d�}d}|D]}	t|	�dkr|d	}q�q||r�|�d|�}|jj	}
|
�|||�r�|j�|����d�}|S)
Nr)�jna)r�rZ�FrOT)�arrayZcom.sunrdZcom.sun.jna.platformrZWinDefZMAX_PATHZzerosZShell32ZINSTANCErQrRZShlObjZSHGFP_TYPE_CURRENTZNativeZtoStringZtostringrrTZKernel32rV)rHrgrdrZbuf_sizerbrNrJrYrZZkernelrrr�_get_win_folder_with_jnas&rh)r`�__main__ZMyAppZ	MyCompany)rr.r1r2r4r*r/z-- app dirs %s --z%-- app dirs (with optional 'version')z1.0r<z%s: %sz)
-- app dirs (without optional 'version')z+
-- app dirs (without optional 'appauthor')z(
-- app dirs (with disabled 'appauthor'))r)NNNF)NNNF)NNNF)NNNF)NNNT)NNNF)NNNT)-r@Z__version_info__r�map�str�__version__�sysr
�version_inforCrS�platform�
startswithZjava_verZos_namerrr*r.r/r1r2r4�objectr5rLr[rcrhrPZwin32comrrWr_r`Zcom.sun.jnaZcomr=rrZprops�print�dirsZproprRrrrr�<module>s~



7
B
(
3
9
*
30


site-packages/pkg_resources/_vendor/__pycache__/six.cpython-38.pyc000064400000057556151446177000021265 0ustar00U

�Qab�u�A@sRdZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d(d#d3d2�e)d4d(e
�rd5nd6d7�e)d8d(d9�e)d:d;d<d=�e)d d d�e)d>d>d?�e)d@d@d?�e)dAdAd?�e)d3d(d#d3d2�e)dBd"d#dCdB�e)dDd"d"dEdD�e&d#d(�e&dFdG�e&dHdI�e&dJdKdL�e&dMdNdM�e&dOdPdQ�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdjdk�e&dldldk�e&dmdmdk�e&dndndo�e&dpdq�e&drds�e&dtdu�e&dvdwdv�e&dxdy�e&dzd{d|�e&d}d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g>Z.ejd�k�rRe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rVe,�3e/d�e/j1��qV[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d=d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dҡGd�dԄd�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q[/e8e7_.e,�3e7e+d��d�dۡGd�d݄d�e(�Z9e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃g!Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d��d�d�G�d�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�d	d��d�gZ<e<D]Z/e0e;e/j1e/��q8[/e<e;_.e,�3e;e+�d
��d�d�G�d
�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d�d�Z@�d�d�ZAe�	rH�dZB�dZC�dZD�dZE�dZF�dZGn$�d ZB�d!ZC�d"ZD�d#ZE�d$ZF�d%ZGzeHZIWn"eJk
�	r��d&�d'�ZIYnXeIZHzeKZKWn"eJk
�	r��d(�d)�ZKYnXe�	r�d*�d+�ZLejMZN�d,�d-�ZOeZPn>�d.�d+�ZL�d/�d0�ZN�d1�d-�ZOG�d2�d3��d3e�ZPeKZKe#eL�d4�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�
rԐd5�d6�ZX�d7�d8�ZY�d9�d:�ZZ�d;�d<�Z[e�\�d=�Z]e�\�d>�Z^e�\�d?�Z_nT�d@�d6�ZX�dA�d8�ZY�dB�d:�ZZ�dC�d<�Z[e�\�dD�Z]e�\�dE�Z^e�\�dF�Z_e#eX�dG�e#eY�dH�e#eZ�dI�e#e[�dJ�e�r�dK�dL�Z`�dM�dN�ZaebZcddldZded�e�dO�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp�dPZqej
�dQ�dQk�r�dRZr�dSZsn�dTZr�dUZsnj�dV�dL�Z`�dW�dN�ZaecZcebZg�dX�dY�Zi�dZ�d[�Zke�tejuev�ZmddloZoeojoZoZp�d\Zq�dRZr�dSZse#e`�d]�e#ea�d^��d_�dP�Zw�d`�dT�Zx�da�dU�Zye�r�eze4j{�db�Z|�d|�dc�dd�Z}n�d}�de�df�Z|e|�dg�ej
dd��dhk�r�e|�di�n.ej
dd��dhk�
re|�dj�n�dk�dl�Z~eze4j{�dmd�Zedk�
rL�dn�do�Zej
dd��dpk�
rreZ��dq�do�Ze#e}�dr�ej
dd�dk�
r�ej�ej�f�ds�dt�Z�nej�Z��du�dv�Z��dw�dx�Z��dy�dz�Z�gZ�e+Z�e�����d{�dk	�
r�ge�_�ej��rBe�ej��D]4\Z�Z�ee��j+dk�re�j1e+k�rej�e�=�q>�q[�[�ej���e,�dS(~z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.10.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�=/usr/lib/python3.8/site-packages/pkg_resources/_vendor/six.py�__len__>sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Xsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__[sz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrriszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrrszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__us
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'gs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr~sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__�sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4|sr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdb�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZemail_mime_basezemail.MIMEBasezemail.mime.baseZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrrt@srtZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrurrrrrwhsrwZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrurrrrry|sryZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrurrrrr{�sr{Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrurrrrr}�sr}ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacervrxrzr|r~cCsdddddgS)N�parse�error�request�responserprr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rpr8rrrrr�s




rzmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_move�sr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rs�__dict__rFrrrr�remove_move�sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iteratorsr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callablesr�cCs|Srr�Zunboundrrr�get_unbound_functionsr�cCs|Srr�r�clsrrr�create_unbound_methodsr�cCs|jSr)r�r�rrrr�"scCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_method%sr�cCst�|d|�Sr)r�r�r�rrrr�(sc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�-sz
Iterator.nextN)r
rrr�rrrrr�+sr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeys>sr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesAsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsDsr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistsGsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�PscKs|jf|�Sr)r�r�rrrr�SscKs|jf|�Sr)r�r�rrrr�VscKs|jf|�Sr)r�r�rrrr�Ys�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�bksr�cCs|Srrr�rrr�unsr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs*|dkr|�}|j|k	r"|�|��|�dSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s


r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�z9def reraise(tp, value, tb=None):
    raise tp, value, tb
)rrzrdef raise_from(value, from_value):
    if from_value is None:
        raise value
    raise value from from_value
zCdef raise_from(value, from_value):
    raise value from from_value
cCs|�dSrr)r1Z
from_valuerrr�
raise_from�sr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr��s

��zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_�sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�s

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rc�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapperszwraps.<locals>.wrapperr)r�r�r�r�rr�rr�sr�cs&G��fdd�d��}t�|ddi�S)z%Create a base class with a metaclass.cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�rZ
this_basesr���bases�metarr�__new__'sz)with_metaclass.<locals>.metaclass.__new__N)r
rrr�rr�rr�	metaclass%sr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclass sr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.csh|j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd��|j|j|�S)N�	__slots__r��__weakref__)r��copyr�rIr�r�r
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr�.s


zadd_metaclass.<locals>.wrapperr)r�r�rr�r�
add_metaclass,sr�cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nzutf-8)�__unicode__r�r	rrr�<lambda>J�z-python_2_unicode_compatible.<locals>.<lambda>)�PY2r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible<s
�
r�__spec__)N)NN)�rZ
__future__rrcrU�operatorrr��
__author__�__version__�version_inforr)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesZ	text_type�bytesZbinary_type�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArsrtZ_urllib_parse_moved_attributesrwZ_urllib_error_moved_attributesryZ _urllib_request_moved_attributesr{Z!_urllib_response_moved_attributesr}Z$_urllib_robotparser_moved_attributesrr�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�r�rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>s�

>





























��


�


�D�






















��


��
































�#�����
��





��



5��
site-packages/pkg_resources/_vendor/__pycache__/pyparsing.cpython-38.opt-1.pyc000064400000611642151446177000023425 0ustar00U

�Qabw��i@s�dZdZdZdZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZzddlmZWn ek
r�ddlmZYnXzdd	lmZdd
lmZWn,ek
r�dd	l
mZdd
l
mZYnXzddl
mZWnBek
�rFzddlmZWnek
�r@dZYnXYnXdd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtgiZee	j�ddu�ZeddukZ e �rpe	j!Z"e#Z$e%Z&e#Z'e(e)e*e+e,ee-e.e/e0e1gZ2n`e	j3Z"e4Z5dvdw�Z'gZ2ddl6Z6dx�7�D]8Z8ze2�9e:e6e8��Wne;k
�r�Y�q�YnX�q�e<dydz�e5d{�D��Z=d|d}�Z>Gd~d�de?�Z@ejAejBZCd�ZDeDd�ZEeCeDZFe%d��ZGd��Hd�dz�ejID��ZJGd�d#�d#eK�ZLGd�d%�d%eL�ZMGd�d'�d'eL�ZNGd�d)�d)eN�ZOGd�d,�d,eK�ZPGd�d��d�e?�ZQGd�d(�d(e?�ZRe�SeR�d�d?�ZTd�dP�ZUd�dM�ZVd�d��ZWd�d��ZXd�d��ZYd�dW�ZZ�d/d�d��Z[Gd�d*�d*e?�Z\Gd�d2�d2e\�Z]Gd�d�de]�Z^Gd�d�de]�Z_Gd�d�de]�Z`e`Zae`e\_bGd�d�de]�ZcGd�d�de`�ZdGd�d
�d
ec�ZeGd�dr�dre]�ZfGd�d5�d5e]�ZgGd�d-�d-e]�ZhGd�d+�d+e]�ZiGd�d�de]�ZjGd�d4�d4e]�ZkGd�d��d�e]�ZlGd�d�del�ZmGd�d�del�ZnGd�d�del�ZoGd�d0�d0el�ZpGd�d/�d/el�ZqGd�d7�d7el�ZrGd�d6�d6el�ZsGd�d&�d&e\�ZtGd�d�det�ZuGd�d"�d"et�ZvGd�d�det�ZwGd�d�det�ZxGd�d$�d$e\�ZyGd�d�dey�ZzGd�d�dey�Z{Gd�d��d�ey�Z|Gd�d�de|�Z}Gd�d8�d8e|�Z~Gd�d��d�e?�Ze�Z�Gd�d!�d!ey�Z�Gd�d.�d.ey�Z�Gd�d�dey�Z�Gd�dÄd�e��Z�Gd�d3�d3ey�Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d1�d1e��Z�Gd�d �d e?�Z�d�dh�Z��d0d�dF�Z��d1d�dB�Z�d�dЄZ�d�dU�Z�d�dT�Z�d�dԄZ��d2d�dY�Z�d�dG�Z��d3d�dm�Z�d�dn�Z�d�dp�Z�e^���dI�Z�en���dO�Z�eo���dN�Z�ep���dg�Z�eq���df�Z�egeGd�d�d܍��d�dބ�Z�ehd߃��d�dބ�Z�ehd���d�dބ�Z�e�e�Be�Bejd�d{d܍BZ�e�e�e�d�e��Z�e`d�e�d���d�e�e}e�e�B����d�d�Z�d�de�Z�d�dS�Z�d�db�Z�d�d`�Z�d�ds�Z�e�d�dބ�Z�e�d�dބ�Z�d�d�Z�d�dQ�Z�d�dR�Z�d�dk�Z�e?�e�_��d4d�dq�Z�e@�Z�e?�e�_�e?�e�_�e�d��e�d��fd�do�Z�e�Z�e�ehd��d����d��Z�e�ehd��d����d��Z�e�ehd��d�ehd��d�B����d�Z�e�ea�d�e�������d�Z�d�d�de���f�ddV�Z��d5�ddl�Z�e��d�Z�e��d�Z�e�egeCeF�d����d��\Z�Z�e�ed	�7��d
��Z�eh�d�d�Heàġ��d
����d�ZŐdda�Z�e�eh�d��d����d�Z�eh�d����d�Z�eh�d��ɡ���d�Z�eh�d����d�Z�e�eh�d��de�B����d�Z�e�Z�eh�d����d�Z�e�e}egeJdːd�e�eg�d�e`d˃eo�����ϡ���d�Z�e�e�e���e�Bd��d����d@�Z�G�d dt�dt�Z�eӐd!k�r�ed�d"�Z�ed�d#�Z�egeCeF�d$�Z�e�e֐d%dՐd&���e��Z�e�e�e׃����d'�Zؐd(e�BZ�e�e֐d%dՐd&���e��Z�e�e�eڃ����d)�Z�eԐd*�eِd'�e�eېd)�Z�eܠݐd+�e�jޠݐd,�e�jߠݐd,�e�j�ݐd-�ddl�Z�e�j᠝e�e�j��e�j�ݐd.�dS(6a�	
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and executing simple grammars,
vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
provides a library of classes that you use to construct the grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form 
C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
L{Literal} expressions)::

    from pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the self-explanatory
class names, and the use of '+', '|' and '^' operators.

The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
object with named attributes.

The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
 - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
 - quoted strings
 - embedded comments


Getting Started -
-----------------
Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:
 - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
 - construct character word-group expressions using the L{Word} class
 - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
 - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
 - associate names with your parsed results using L{ParserElement.setResultsName}
 - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
 - find more useful common expressions in the L{pyparsing_common} namespace class
z2.2.1z18 Sep 2018 00:49 UTCz*Paul McGuire <ptmcg@users.sourceforge.net>�N)�ref)�datetime)�RLock)�Iterable)�MutableMapping)�OrderedDict�And�CaselessKeyword�CaselessLiteral�
CharsNotIn�Combine�Dict�Each�Empty�
FollowedBy�Forward�
GoToColumn�Group�Keyword�LineEnd�	LineStart�Literal�
MatchFirst�NoMatch�NotAny�	OneOrMore�OnlyOnce�Optional�Or�ParseBaseException�ParseElementEnhance�ParseException�ParseExpression�ParseFatalException�ParseResults�ParseSyntaxException�
ParserElement�QuotedString�RecursiveGrammarException�Regex�SkipTo�	StringEnd�StringStart�Suppress�Token�TokenConverter�White�Word�WordEnd�	WordStart�
ZeroOrMore�	alphanums�alphas�
alphas8bit�anyCloseTag�
anyOpenTag�
cStyleComment�col�commaSeparatedList�commonHTMLEntity�countedArray�cppStyleComment�dblQuotedString�dblSlashComment�
delimitedList�dictOf�downcaseTokens�empty�hexnums�htmlComment�javaStyleComment�line�lineEnd�	lineStart�lineno�makeHTMLTags�makeXMLTags�matchOnlyAtCol�matchPreviousExpr�matchPreviousLiteral�
nestedExpr�nullDebugAction�nums�oneOf�opAssoc�operatorPrecedence�
printables�punc8bit�pythonStyleComment�quotedString�removeQuotes�replaceHTMLEntity�replaceWith�
restOfLine�sglQuotedString�srange�	stringEnd�stringStart�traceParseAction�
unicodeString�upcaseTokens�
withAttribute�
indentedBlock�originalTextFor�ungroup�
infixNotation�locatedExpr�	withClass�
CloseMatch�tokenMap�pyparsing_common�cCsft|t�r|Sz
t|�WStk
r`t|��t��d�}td�}|�dd��|�	|�YSXdS)aDrop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
           then < returns the unicode object | encodes it with the default encoding | ... >.
        �xmlcharrefreplacez&#\d+;cSs$dtt|ddd���dd�S)Nz\ur����)�hex�int��t�ry�C/usr/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py�<lambda>��z_ustr.<locals>.<lambda>N)
�
isinstanceZunicode�str�UnicodeEncodeError�encode�sys�getdefaultencodingr)�setParseAction�transformString)�obj�retZ
xmlcharrefryryrz�_ustr�s

r�z6sum len sorted reversed list tuple set any all min maxccs|]
}|VqdS�Nry)�.0�yryryrz�	<genexpr>�sr��cCs:d}dd�d��D�}t||�D]\}}|�||�}q |S)z/Escape &, <, >, ", ', etc. in a string of data.z&><"'css|]}d|dVqdS)�&�;Nry)r��sryryrzr��sz_xml_escape.<locals>.<genexpr>zamp gt lt quot apos)�split�zip�replace)�dataZfrom_symbolsZ
to_symbolsZfrom_Zto_ryryrz�_xml_escape�s
r�c@seZdZdS)�
_ConstantsN)�__name__�
__module__�__qualname__ryryryrzr��sr��
0123456789ZABCDEFabcdef�\�ccs|]}|tjkr|VqdSr�)�stringZ
whitespace�r��cryryrzr��s
c@sPeZdZdZddd�Zedd��Zdd	�Zd
d�Zdd
�Z	ddd�Z
dd�ZdS)rz7base exception class for all parsing runtime exceptionsrNcCs>||_|dkr||_d|_n||_||_||_|||f|_dS�Nr�)�loc�msg�pstr�
parserElement�args)�selfr�r�r��elemryryrz�__init__�szParseBaseException.__init__cCs||j|j|j|j�S)z�
        internal factory method to simplify creating one type of ParseException 
        from another - avoids having __init__ signature conflicts among subclasses
        )r�r�r�r�)�cls�peryryrz�_from_exception�sz"ParseBaseException._from_exceptioncCsN|dkrt|j|j�S|dkr,t|j|j�S|dkrBt|j|j�St|��dS)z�supported attributes by name are:
            - lineno - returns the line number of the exception text
            - col - returns the column number of the exception text
            - line - returns the line containing the exception text
        rL)r;�columnrIN)rLr�r�r;rI�AttributeError)r�Zanameryryrz�__getattr__�szParseBaseException.__getattr__cCsd|j|j|j|jfS)Nz"%s (at char %d), (line:%d, col:%d))r�r�rLr��r�ryryrz�__str__�s�zParseBaseException.__str__cCst|�Sr��r�r�ryryrz�__repr__�szParseBaseException.__repr__�>!<cCs<|j}|jd}|r4d�|d|�|||d�f�}|��S)z�Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        r�r�N)rIr��join�strip)r�ZmarkerStringZline_strZline_columnryryrz�
markInputline�s

�z ParseBaseException.markInputlinecCsd��tt|��S)Nzlineno col line)r��dir�typer�ryryrz�__dir__szParseBaseException.__dir__)rNN)r�)r�r�r��__doc__r��classmethodr�r�r�r�r�r�ryryryrzr�s



c@seZdZdZdS)r!aN
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
     - lineno - returns the line number of the exception text
     - col - returns the column number of the exception text
     - line - returns the line containing the exception text
        
    Example::
        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))
            
    prints::
       Expected integer (at char 0), (line:1, col:1)
        column: 1
    N�r�r�r�r�ryryryrzr!sc@seZdZdZdS)r#znuser-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediatelyNr�ryryryrzr#sc@seZdZdZdS)r%z�just like L{ParseFatalException}, but thrown internally when an
       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
       immediately because an unbacktrackable syntax error has been foundNr�ryryryrzr%sc@s eZdZdZdd�Zdd�ZdS)r(zZexception thrown by L{ParserElement.validate} if the grammar could be improperly recursivecCs
||_dSr��ZparseElementTrace�r��parseElementListryryrzr�4sz"RecursiveGrammarException.__init__cCs
d|jS)NzRecursiveGrammarException: %sr�r�ryryrzr�7sz!RecursiveGrammarException.__str__N)r�r�r�r�r�r�ryryryrzr(2sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�_ParseResultsWithOffsetcCs||f|_dSr���tup)r�Zp1Zp2ryryrzr�;sz _ParseResultsWithOffset.__init__cCs
|j|Sr�r��r��iryryrz�__getitem__=sz#_ParseResultsWithOffset.__getitem__cCst|jd�S�Nr)�reprr�r�ryryrzr�?sz _ParseResultsWithOffset.__repr__cCs|jd|f|_dSr�r�r�ryryrz�	setOffsetAsz!_ParseResultsWithOffset.setOffsetN)r�r�r�r�r�r�r�ryryryrzr�:sr�c@s�eZdZdZd[dd�Zddddefdd�Zdd	�Zefd
d�Zdd
�Z	dd�Z
dd�Zdd�ZeZ
dd�Zdd�Zdd�Zdd�Zdd�Zer�eZeZeZn$eZeZeZdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd\d(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Z d2d3�Z!d4d5�Z"d6d7�Z#d8d9�Z$d:d;�Z%d<d=�Z&d]d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*d^dHdI�Z+dJdK�Z,dLdM�Z-d_dOdP�Z.dQdR�Z/dSdT�Z0dUdV�Z1dWdX�Z2dYdZ�Z3dS)`r$aI
    Structured parse results, to provide multiple means of access to the parsed data:
       - as a list (C{len(results)})
       - by list index (C{results[0], results[1]}, etc.)
       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})

    Example::
        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)
    prints::
        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    NTcCs"t||�r|St�|�}d|_|S�NT)r}�object�__new__�_ParseResults__doinit)r��toklist�name�asList�modalZretobjryryrzr�ks


zParseResults.__new__c
Csb|jrvd|_d|_d|_i|_||_||_|dkr6g}||t�rP|dd�|_n||t�rft|�|_n|g|_t	�|_
|dk	�r^|�r^|s�d|j|<||t�r�t|�}||_||t
d�ttf�r�|ddgfk�s^||t�r�|g}|�r(||t��rt|��d�||<ntt|d�d�||<|||_n6z|d||<Wn$tttfk
�r\|||<YnXdS)NFrr�)r��_ParseResults__name�_ParseResults__parent�_ParseResults__accumNames�_ParseResults__asList�_ParseResults__modal�list�_ParseResults__toklist�_generatorType�dict�_ParseResults__tokdictrvr�r��
basestringr$r��copy�KeyError�	TypeError�
IndexError)r�r�r�r�r�r}ryryrzr�tsB



$
zParseResults.__init__cCsPt|ttf�r|j|S||jkr4|j|ddStdd�|j|D��SdS)NrtrcSsg|]}|d�qS�rry�r��vryryrz�
<listcomp>�sz,ParseResults.__getitem__.<locals>.<listcomp>)r}rv�slicer�r�r�r$r�ryryrzr��s


zParseResults.__getitem__cCs�||t�r0|j�|t��|g|j|<|d}nD||ttf�rN||j|<|}n&|j�|t��t|d�g|j|<|}||t�r�t|�|_	dSr�)
r�r��getr�rvr�r�r$�wkrefr�)r��kr�r}�subryryrz�__setitem__�s


"
zParseResults.__setitem__c
Cs�t|ttf�r�t|j�}|j|=t|t�rH|dkr:||7}t||d�}tt|�|���}|��|j	�
�D]>\}}|D]0}t|�D]"\}\}}	t||	|	|k�||<q�qxqln|j	|=dS�Nrr�)
r}rvr��lenr�r��range�indices�reverser��items�	enumerater�)
r�r�ZmylenZremovedr��occurrences�jr��value�positionryryrz�__delitem__�s

zParseResults.__delitem__cCs
||jkSr�)r�)r�r�ryryrz�__contains__�szParseResults.__contains__cCs
t|j�Sr�)r�r�r�ryryrz�__len__�r|zParseResults.__len__cCs
|jSr��r�r�ryryrz�__bool__�r|zParseResults.__bool__cCs
t|j�Sr���iterr�r�ryryrz�__iter__�r|zParseResults.__iter__cCst|jddd��S�Nrtr�r�ryryrz�__reversed__�r|zParseResults.__reversed__cCs$t|jd�r|j��St|j�SdS)N�iterkeys)�hasattrr�r�r�r�ryryrz�	_iterkeys�s
zParseResults._iterkeyscs�fdd����D�S)Nc3s|]}�|VqdSr�ry�r�r�r�ryrzr��sz+ParseResults._itervalues.<locals>.<genexpr>�rr�ryr�rz�_itervalues�szParseResults._itervaluescs�fdd����D�S)Nc3s|]}|�|fVqdSr�ryrr�ryrzr��sz*ParseResults._iteritems.<locals>.<genexpr>rr�ryr�rz�
_iteritems�szParseResults._iteritemscCst|���S)zVReturns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x).)r�r�r�ryryrz�keys�szParseResults.keyscCst|���S)zXReturns all named result values (as a list in Python 2.x, as an iterator in Python 3.x).)r��
itervaluesr�ryryrz�values�szParseResults.valuescCst|���S)zfReturns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x).)r��	iteritemsr�ryryrzr��szParseResults.itemscCs
t|j�S)z�Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names.)�boolr�r�ryryrz�haskeys�szParseResults.haskeyscOs�|s
dg}|��D]*\}}|dkr0|d|f}qtd|��qt|dt�sdt|�dksd|d|kr~|d}||}||=|S|d}|SdS)a�
        Removes and returns item at specified index (default=C{last}).
        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
        argument or an integer argument, it will use C{list} semantics
        and pop tokens from the list of parsed tokens. If passed a 
        non-integer argument (most likely a string), it will use C{dict}
        semantics and pop the corresponding value from any defined 
        results names. A second default return value argument is 
        supported, just as in C{dict.pop()}.

        Example::
            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())
        prints::
            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        rt�defaultrz-pop() got an unexpected keyword argument '%s'r�N)r�r�r}rvr�)r�r��kwargsr�r��indexr�Zdefaultvalueryryrz�pop�s""
�
�zParseResults.popcCs||kr||S|SdS)ai
        Returns named result matching the given key, or if there is no
        such name, then returns the given C{defaultValue} or C{None} if no
        C{defaultValue} is specified.

        Similar to C{dict.get()}.
        
        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        Nry)r��key�defaultValueryryrzr�3szParseResults.getcCsR|j�||�|j��D]4\}}t|�D]"\}\}}t||||k�||<q(qdS)a
        Inserts new element at location index in the list of parsed tokens.
        
        Similar to C{list.insert()}.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        N)r��insertr�r�r�r�)r�r
ZinsStrr�r�r�r�r�ryryrzrIszParseResults.insertcCs|j�|�dS)a�
        Add single element to end of ParseResults list of elements.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            
            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        N)r��append)r��itemryryrzr]szParseResults.appendcCs$t|t�r||7}n|j�|�dS)a
        Add sequence of elements to end of ParseResults list of elements.

        Example::
            patt = OneOrMore(Word(alphas))
            
            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        N)r}r$r��extend)r�Zitemseqryryrzrks

zParseResults.extendcCs|jdd�=|j��dS)z7
        Clear all elements and results names.
        N)r�r��clearr�ryryrzr}szParseResults.clearcCsjz
||WStk
r YdSX||jkrb||jkrH|j|ddStdd�|j|D��SndSdS)Nr�rtrcSsg|]}|d�qSr�ryr�ryryrzr��sz,ParseResults.__getattr__.<locals>.<listcomp>)r�r�r�r$�r�r�ryryrzr��s


zParseResults.__getattr__cCs|��}||7}|Sr��r�)r��otherr�ryryrz�__add__�szParseResults.__add__cs�|jrjt|j���fdd��|j��}�fdd�|D�}|D],\}}|||<t|dt�r<t|�|d_q<|j|j7_|j�	|j�|S)Ncs|dkr�S|�Sr�ry)�a)�offsetryrzr{�r|z'ParseResults.__iadd__.<locals>.<lambda>c	s4g|],\}}|D]}|t|d�|d��f�qqS�rr�)r��r�r��vlistr�)�	addoffsetryrzr��s�z)ParseResults.__iadd__.<locals>.<listcomp>r)
r�r�r�r�r}r$r�r�r��update)r�rZ
otheritemsZotherdictitemsr�r�ry)rrrz�__iadd__�s


�zParseResults.__iadd__cCs&t|t�r|dkr|��S||SdSr�)r}rvr��r�rryryrz�__radd__�szParseResults.__radd__cCsdt|j�t|j�fS)Nz(%s, %s))r�r�r�r�ryryrzr��szParseResults.__repr__cCsdd�dd�|jD��dS)N�[�, css(|] }t|t�rt|�nt|�VqdSr�)r}r$r�r��r�r�ryryrzr��sz'ParseResults.__str__.<locals>.<genexpr>�])r�r�r�ryryrzr��szParseResults.__str__r�cCsLg}|jD]<}|r |r |�|�t|t�r8||��7}q
|�t|��q
|Sr�)r�rr}r$�
_asStringListr�)r��sep�outrryryrzr(�s


zParseResults._asStringListcCsdd�|jD�S)a�
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::
            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
            
            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        cSs"g|]}t|t�r|��n|�qSry)r}r$r�)r��resryryrzr��sz'ParseResults.asList.<locals>.<listcomp>r�r�ryryrzr��szParseResults.asListcs6tr|j}n|j}�fdd��t�fdd�|�D��S)a�
        Returns the named parse results as a nested dictionary.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
            
            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        cs6t|t�r.|��r|��S�fdd�|D�Sn|SdS)Ncsg|]}�|��qSryryr���toItemryrzr��sz7ParseResults.asDict.<locals>.toItem.<locals>.<listcomp>)r}r$r
�asDict)r�r,ryrzr-�s

z#ParseResults.asDict.<locals>.toItemc3s|]\}}|�|�fVqdSr�ry�r�r�r�r,ryrzr��sz&ParseResults.asDict.<locals>.<genexpr>)�PY_3r�rr�)r�Zitem_fnryr,rzr.�s
	zParseResults.asDictcCs8t|j�}|j��|_|j|_|j�|j�|j|_|S)zA
        Returns a new copy of a C{ParseResults} object.
        )r$r�r�r�r�r�r r��r�r�ryryrzr��s
zParseResults.copyFcCsLd}g}tdd�|j��D��}|d}|s8d}d}d}d}	|dk	rJ|}	n|jrV|j}	|	sf|rbdSd}	|||d|	d	g7}t|j�D]�\}
}t|t�r�|
|kr�||�||
|o�|dk||�g7}n||�d|o�|dk||�g7}q�d}|
|kr�||
}|�s|�rq�nd}t	t
|��}
|||d|d	|
d
|d	g	7}q�|||d
|	d	g7}d�|�S)z�
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        �
css(|] \}}|D]}|d|fVqqdS�r�Nryrryryrzr�s�z%ParseResults.asXML.<locals>.<genexpr>�  r�NZITEM�<�>�</)r�r�r�r�r�r�r}r$�asXMLr�r�r�)r�ZdoctagZnamedItemsOnly�indentZ	formatted�nlr*Z
namedItemsZnextLevelIndentZselfTagr�r+ZresTagZxmlBodyTextryryrzr8�s^

�

�
�zParseResults.asXMLcCs:|j��D]*\}}|D]\}}||kr|Sqq
dSr�)r�r�)r�r�r�rr�r�ryryrzZ__lookup;s
zParseResults.__lookupcCs�|jr|jS|jr.|��}|r(|�|�SdSnNt|�dkrxt|j�dkrxtt|j����dddkrxtt|j����SdSdS)a(
        Returns the results name for this token expression. Useful when several 
        different expressions might match at a particular location.

        Example::
            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number") 
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)
            
            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])
        prints::
            age : 22
            ssn : 111-22-3333
            house_number : 221B
        Nr�r)rrt)	r�r��_ParseResults__lookupr�r��nextr�rr)r��parryryrz�getNameBs
��zParseResults.getNamercCsZg}d}|�|t|����|�rP|��r�tdd�|��D��}|D]r\}}|r\|�|�|�d|d||f�t|t�r�|r�|�|�||d��q�|�t|��qF|�t	|��qFn�t
dd�|D���rP|}t|�D]r\}	}
t|
t��r$|�d|d||	|d|d|
�||d�f�q�|�d|d||	|d|dt|
�f�q�d	�|�S)
aH
        Diagnostic method for listing out the contents of a C{ParseResults}.
        Accepts an optional C{indent} argument so that this string can be embedded
        in a nested display of other data.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(result.dump())
        prints::
            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        r2css|]\}}t|�|fVqdSr�)r~r/ryryrzr�~sz$ParseResults.dump.<locals>.<genexpr>z
%s%s- %s: r4r�css|]}t|t�VqdSr�)r}r$)r��vvryryrzr��sz
%s%s[%d]:
%s%s%sr�)
rr�r�r
�sortedr�r}r$�dumpr��anyr�r�)r�r9�depth�fullr*�NLr�r�r�r�r?ryryrzrAgs,

4,zParseResults.dumpcOstj|��f|�|�dS)a�
        Pretty-printer for parsed results as a list, using the C{pprint} module.
        Accepts additional positional or keyword args as defined for the 
        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})

        Example::
            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)
        prints::
            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        N)�pprintr��r�r�rryryrzrF�szParseResults.pprintcCs.|j|j��|jdk	r|��p d|j|jffSr�)r�r�r�r�r�r�r�ryryrz�__getstate__�s��zParseResults.__getstate__cCsN|d|_|d\|_}}|_i|_|j�|�|dk	rDt|�|_nd|_dSr�)r�r�r�r�r r�r�)r��stater=ZinAccumNamesryryrz�__setstate__�s
�zParseResults.__setstate__cCs|j|j|j|jfSr�)r�r�r�r�r�ryryrz�__getnewargs__�szParseResults.__getnewargs__cCstt|��t|���Sr�)r�r�r�rr�ryryrzr��szParseResults.__dir__)NNTT)N)r�)NFr�T)r�rT)4r�r�r�r�r�r}r�r�r�r�r�r�r��__nonzero__r�r�rrrr0rrr�r�rrr
rr�rrrrr�rr!r#r�r�r(r�r.r�r8r;r>rArFrHrJrKr�ryryryrzr$Dsh&
	'	
4

#
=%
-
cCsF|}d|krt|�kr4nn||ddkr4dS||�dd|�S)aReturns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   rr�r2)r��rfind)r��strgr�ryryrzr;�s
cCs|�dd|�dS)aReturns current line number within a string, counting newlines as line separators.
   The first line is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   r2rr�)�count)r�rNryryrzrL�s
cCsF|�dd|�}|�d|�}|dkr2||d|�S||dd�SdS)zfReturns the line of text containing loc within a string, counting newlines as line separators.
       r2rr�N)rM�find)r�rNZlastCRZnextCRryryrzrI�s
cCs8tdt|�dt|�dt||�t||�f�dS)NzMatch z at loc z(%d,%d))�printr�rLr;)�instringr��exprryryrz�_defaultStartDebugAction�srTcCs$tdt|�dt|����dS)NzMatched z -> )rQr�r~r�)rR�startlocZendlocrS�toksryryrz�_defaultSuccessDebugAction�srWcCstdt|��dS)NzException raised:)rQr�)rRr�rS�excryryrz�_defaultExceptionDebugAction�srYcGsdS)zG'Do-nothing' debug action, to suppress debugging output during parsing.Nry)r�ryryrzrS�srscs��tkr�fdd�Sdg�dg�tdd�dkrFddd�}dd	d
��ntj}tj�d}|dd�d
}|d|d|f�������fdd�}d}zt�dt�d�j�}Wntk
r�t��}YnX||_|S)Ncs�|�Sr�ry�r��lrx)�funcryrzr{r|z_trim_arity.<locals>.<lambda>rFrs)rq�cSs8tdkrdnd}tj||dd�|}|dd�gS)N)rqr]r������r���limitrs)�system_version�	traceback�
extract_stack)rar�
frame_summaryryryrzrdsz"_trim_arity.<locals>.extract_stackcSs$tj||d�}|d}|dd�gS)Nr`rtrs)rc�
extract_tb)�tbraZframesreryryrzrfsz_trim_arity.<locals>.extract_tb�r`rtr�c	s�z"�|�dd��}d�d<|WStk
r��dr>�n4z.t��d}�|dd�ddd��ksj�W5~X�d�kr��dd7<Yq�YqXqdS)NrTrtrsr`r�)r�r��exc_info)r�r�rg�rfZ
foundArityr\ra�maxargsZpa_call_line_synthryrz�wrapper-s z_trim_arity.<locals>.wrapperz<parse action>r��	__class__)r)r)	�singleArgBuiltinsrbrcrdrf�getattrr��	Exceptionr~)r\rkrdZ	LINE_DIFFZ	this_linerl�	func_nameryrjrz�_trim_aritys,

�rrcs�eZdZdZdZdZedd��Zedd��Zd�dd	�Z	d
d�Z
dd
�Zd�dd�Zd�dd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd�dd �Zd!d"�Zd�d#d$�Zd%d&�Zd'd(�ZGd)d*�d*e�Zed+k	r�Gd,d-�d-e�ZnGd.d-�d-e�ZiZe�Zd/d/gZ d�d0d1�Z!eZ"ed2d3��Z#dZ$ed�d5d6��Z%d�d7d8�Z&e'dfd9d:�Z(d;d<�Z)e'fd=d>�Z*e'dfd?d@�Z+dAdB�Z,dCdD�Z-dEdF�Z.dGdH�Z/dIdJ�Z0dKdL�Z1dMdN�Z2dOdP�Z3dQdR�Z4dSdT�Z5dUdV�Z6dWdX�Z7dYdZ�Z8d�d[d\�Z9d]d^�Z:d_d`�Z;dadb�Z<dcdd�Z=dedf�Z>dgdh�Z?d�didj�Z@dkdl�ZAdmdn�ZBdodp�ZCdqdr�ZDgfdsdt�ZEd�dudv�ZF�fdwdx�ZGdydz�ZHd{d|�ZId}d~�ZJdd��ZKd�d�d��ZLd�d�d��ZM�ZNS)�r&z)Abstract base level parser element class.z 
	
FcCs
|t_dS)a�
        Overrides the default whitespace chars

        Example::
            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
            
            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        N)r&�DEFAULT_WHITE_CHARS��charsryryrz�setDefaultWhitespaceCharsTs
z'ParserElement.setDefaultWhitespaceCharscCs
|t_dS)a�
        Set class to be used for inclusion of string literals into a parser.
        
        Example::
            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        N)r&�_literalStringClass)r�ryryrz�inlineLiteralsUsingcsz!ParserElement.inlineLiteralsUsingcCs�t�|_d|_d|_d|_||_d|_tj|_	d|_
d|_d|_t�|_
d|_d|_d|_d|_d|_d|_d|_d|_d|_dS)NTFr�)NNN)r��parseAction�
failAction�strRepr�resultsName�
saveAsList�skipWhitespacer&rs�
whiteChars�copyDefaultWhiteChars�mayReturnEmpty�keepTabs�ignoreExprs�debug�streamlined�
mayIndexError�errmsg�modalResults�debugActions�re�callPreparse�
callDuringTry)r��savelistryryrzr�xs(zParserElement.__init__cCs<t�|�}|jdd�|_|jdd�|_|jr8tj|_|S)a$
        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
        for the same parsing pattern, using copies of the original parse element.
        
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
            
            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
        prints::
            [5120, 100, 655360, 268435456]
        Equivalent form of C{expr.copy()} is just C{expr()}::
            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
        N)r�ryr�r�r&rsr)r�Zcpyryryrzr��s
zParserElement.copycCs*||_d|j|_t|d�r&|j|j_|S)af
        Define name for this expression, makes debugging and exception messages clearer.
        
        Example::
            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        �	Expected �	exception)r�r�r�r�r�rryryrz�setName�s


zParserElement.setNamecCs4|��}|�d�r"|dd�}d}||_||_|S)aP
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original C{ParserElement} object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        C{expr("name")} in place of C{expr.setResultsName("name")} - 
        see L{I{__call__}<__call__>}.

        Example::
            date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        �*NrtT)r��endswithr|r�)r�r��listAllMatchesZnewselfryryrz�setResultsName�s
zParserElement.setResultsNameTcs@|r&|j�d�fdd�	}�|_||_nt|jd�r<|jj|_|S)z�Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set C{breakFlag} to True to enable, False to
           disable.
        Tcsddl}|���||||�Sr�)�pdbZ	set_trace)rRr��	doActions�callPreParser��Z_parseMethodryrz�breaker�sz'ParserElement.setBreak.<locals>.breaker�_originalParseMethod)TT)�_parser�r�)r�Z	breakFlagr�ryr�rz�setBreak�s
zParserElement.setBreakcOs&tttt|���|_|�dd�|_|S)a
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
         - s   = the original string being parsed (see note below)
         - loc = the location of the matching substring
         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        Optional keyword arguments:
         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
        consistent view of the parsed string, the parse location, and line and column
        positions within the parsed string.
        
        Example::
            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        r�F)r��maprrryr�r��r��fnsrryryrzr��s"zParserElement.setParseActioncOs4|jtttt|���7_|jp,|�dd�|_|S)z�
        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
        
        See examples in L{I{copy}<copy>}.
        r�F)ryr�r�rrr�r�r�ryryrz�addParseActionszParserElement.addParseActioncs^|�dd��|�dd�rtnt�|D] ����fdd�}|j�|�q$|jpV|�dd�|_|S)a�Add a boolean predicate function to expression's list of parse actions. See 
        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
        functions passed to C{addCondition} need to return boolean success/fail of the condition.

        Optional keyword arguments:
         - message = define a custom message to be used in the raised exception
         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
         
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        �messagezfailed user-defined condition�fatalFcs$tt��|||��s �||���dSr�)r	rrrZ��exc_type�fnr�ryrz�pa&sz&ParserElement.addCondition.<locals>.par�)r�r#r!ryrr�)r�r�rr�ryr�rz�addConditionszParserElement.addConditioncCs
||_|S)aDefine action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           C{fn(s,loc,expr,err)} where:
            - s = string being parsed
            - loc = location where expression match was attempted and failed
            - expr = the parse expression that failed
            - err = the exception thrown
           The function returns no value.  It may throw C{L{ParseFatalException}}
           if it is desired to stop parsing immediately.)rz)r�r�ryryrz�
setFailAction-s
zParserElement.setFailActionc	CsNd}|rJd}|jD]4}z|�||�\}}d}qWqtk
rDYqXqq|S�NTF)r�r�r!)r�rRr�Z
exprsFound�eZdummyryryrz�_skipIgnorables:s


zParserElement._skipIgnorablescCsH|jr|�||�}|jrD|j}t|�}||krD|||krD|d7}q&|S�Nr�)r�r�r~rr�)r�rRr�Zwt�instrlenryryrz�preParseGs
zParserElement.preParsecCs|gfSr�ry�r�rRr�r�ryryrz�	parseImplSszParserElement.parseImplcCs|Sr�ry�r�rRr��	tokenlistryryrz�	postParseVszParserElement.postParsec
Cs�|j}|s|jr�|jdr,|jd|||�|rD|jrD|�||�}n|}|}zDz|�|||�\}}Wn(tk
r�t|t|�|j	|��YnXWnXt
k
r�}	z:|jdr�|jd||||	�|jr�|�||||	��W5d}	~	XYnXn�|�r|j�r|�||�}n|}|}|j�s&|t|�k�rjz|�|||�\}}Wn*tk
�rft|t|�|j	|��YnXn|�|||�\}}|�|||�}t
||j|j|jd�}
|j�r�|�s�|j�r�|�rTzN|jD]B}||||
�}|dk	�r�t
||j|j�o�t|t
tf�|jd�}
�q�WnFt
k
�rP}	z&|jd�r>|jd||||	��W5d}	~	XYnXnJ|jD]B}||||
�}|dk	�rZt
||j|j�o�t|t
tf�|jd�}
�qZ|�r�|jd�r�|jd|||||
�||
fS)Nrrs)r�r�r�)r�rzr�r�r�r�r�r!r�r�rr�r�r$r|r}r�ryr�r}r�)r�rRr�r�r�Z	debugging�prelocZtokensStart�tokens�errZ	retTokensr�ryryrz�
_parseNoCacheZst





�

�
zParserElement._parseNoCachecCs@z|j||dd�dWStk
r:t|||j|��YnXdS)NF)r�r)r�r#r!r��r�rRr�ryryrz�tryParse�szParserElement.tryParsec	Cs4z|�||�Wnttfk
r*YdSXdSdS)NFT)r�r!r�r�ryryrz�canParseNext�s
zParserElement.canParseNextc@seZdZdd�ZdS)zParserElement._UnboundedCachecs~i�t�|_���fdd�}�fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr��r��r�r��cache�not_in_cacheryrzr��sz3ParserElement._UnboundedCache.__init__.<locals>.getcs|�|<dSr�ry�r�rr��r�ryrz�set�sz3ParserElement._UnboundedCache.__init__.<locals>.setcs���dSr��rr�r�ryrzr�sz5ParserElement._UnboundedCache.__init__.<locals>.clearcst��Sr��r�r�r�ryrz�	cache_len�sz9ParserElement._UnboundedCache.__init__.<locals>.cache_len)r�r��types�
MethodTyper�r�rr�)r�r�r�rr�ryr�rzr��sz&ParserElement._UnboundedCache.__init__N�r�r�r�r�ryryryrz�_UnboundedCache�sr�Nc@seZdZdd�ZdS)�ParserElement._FifoCachecs�t�|_�t����fdd�}��fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr�r�r�r�ryrzr��s�.ParserElement._FifoCache.__init__.<locals>.getcs>|�|<t���kr:z��d�Wqtk
r6YqXqdS�NF)r��popitemr�r�)r��sizeryrzr��s�.ParserElement._FifoCache.__init__.<locals>.setcs���dSr�r�r�r�ryrzr�s�0ParserElement._FifoCache.__init__.<locals>.clearcst��Sr�r�r�r�ryrzr��s�4ParserElement._FifoCache.__init__.<locals>.cache_len)	r�r��_OrderedDictr�r�r�r�rr��r�r�r�r�rr�ry)r�r�r�rzr��s�!ParserElement._FifoCache.__init__Nr�ryryryrz�
_FifoCache�sr�c@seZdZdd�ZdS)r�cs�t�|_�i�t�g�����fdd�}���fdd�}��fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_	dS)	Ncs��|��Sr�r�r�r�ryrzr��sr�cs4|�|<t���kr&�����d�q��|�dSr�)r�r�popleftrr�)r��key_fifor�ryrzr��sr�cs������dSr�r�r�)r�r�ryrzr�sr�cst��Sr�r�r�r�ryrzr��sr�)
r�r��collections�dequer�r�r�r�rr�r�ry)r�r�r�r�rzr��sr�Nr�ryryryrzr��srcCsd\}}|||||f}tj��tj}|�|�}	|	|jkr�tj|d7<z|�||||�}	Wn8tk
r�}
z|�||
j	|
j
���W5d}
~
XYn.X|�||	d|	d��f�|	W5QR�Sn@tj|d7<t|	t
�r�|	�|	d|	d��fW5QR�SW5QRXdS)Nrr�r)r&�packrat_cache_lock�
packrat_cacher�r��packrat_cache_statsr�rr�rmr�r�r}rp)r�rRr�r�r�ZHITZMISS�lookupr�r�r�ryryrz�_parseCaches$


zParserElement._parseCachecCs(tj��dgttj�tjdd�<dSr�)r&r�rr�r�ryryryrz�
resetCaches
zParserElement.resetCache�cCs8tjs4dt_|dkr t��t_nt�|�t_tjt_dS)a�Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.
           
           Parameters:
            - cache_size_limit - (default=C{128}) - if an integer value is provided
              will limit the size of the packrat cache; if None is passed, then
              the cache size will be unbounded; if 0 is passed, the cache will
              be effectively disabled.
            
           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method C{ParserElement.enablePackrat()}.  If
           your program uses C{psyco} to "compile as you go", you must call
           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
           Python will crash.  For best results, call C{enablePackrat()} immediately
           after importing pyparsing.
           
           Example::
               import pyparsing
               pyparsing.ParserElement.enablePackrat()
        TN)r&�_packratEnabledr�r�r�r�r�)Zcache_size_limitryryrz�
enablePackrat%szParserElement.enablePackratc
Cs�t��|js|��|jD]}|��q|js8|��}z<|�|d�\}}|rr|�||�}t	�t
�}|�||�Wn0tk
r�}ztjr��n|�W5d}~XYnX|SdS)aB
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set C{parseAll} to True (equivalent to ending
        the grammar with C{L{StringEnd()}}).

        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the C{loc} argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:
         - calling C{parseWithTabs} on your grammar before calling C{parseString}
           (see L{I{parseWithTabs}<parseWithTabs>})
         - define your parse action using the full C{(s,loc,toks)} signature, and
           reference the input string using the parse action's C{s} argument
         - explictly expand the tabs in your input string before calling
           C{parseString}
        
        Example::
            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        rN)
r&r�r��
streamliner�r��
expandtabsr�r�rr+r�verbose_stacktrace)r�rR�parseAllr�r�r�ZserXryryrz�parseStringHs$

zParserElement.parseStringc
cs6|js|��|jD]}|��q|js4t|���}t|�}d}|j}|j}t	�
�d}	z�||kr�|	|kr�z |||�}
|||
dd�\}}Wntk
r�|
d}YqZX||kr�|	d7}	||
|fV|r�|||�}
|
|kr�|}q�|d7}q�|}qZ|
d}qZWn4tk
�r0}zt	j
�r�n|�W5d}~XYnXdS)a�
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
        C{overlap} is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
        strings with embedded tabs.

        Example::
            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens,start,end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])
        
        prints::
        
            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        rF�r�r�N)r�r�r�r�r�r�r�r�r�r&r�r!rr�)r�rR�
maxMatchesZoverlapr�r�r�Z
preparseFnZparseFn�matchesr�ZnextLocr�ZnextlocrXryryrz�
scanStringzsB




zParserElement.scanStringc
Cs�g}d}d|_z�|�|�D]Z\}}}|�|||��|rpt|t�rR||��7}nt|t�rf||7}n
|�|�|}q|�||d��dd�|D�}d�tt	t
|���WStk
r�}ztj
rƂn|�W5d}~XYnXdS)af
        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
        be returned from a parse action.  To use C{transformString}, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking C{transformString()} on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  C{transformString()} returns the resulting transformed string.
        
        Example::
            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())
            
            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
        Prints::
            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        rTNcSsg|]}|r|�qSryry)r��oryryrzr��sz1ParserElement.transformString.<locals>.<listcomp>r�)r�r�rr}r$r�r�r�r�r��_flattenrr&r�)r�rRr*ZlastErxr�r�rXryryrzr��s(



zParserElement.transformStringc
CsRztdd�|�||�D��WStk
rL}ztjr8�n|�W5d}~XYnXdS)a�
        Another extension to C{L{scanString}}, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        C{maxMatches} argument, to clip searching after 'n' matches are found.
        
        Example::
            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())
            
            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
        prints::
            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        cSsg|]\}}}|�qSryry)r�rxr�r�ryryrzr��sz.ParserElement.searchString.<locals>.<listcomp>N)r$r�rr&r�)r�rRr�rXryryrz�searchString�szParserElement.searchStringc	csTd}d}|j||d�D]*\}}}|||�V|r<|dV|}q||d�VdS)a[
        Generator method to split a string using the given expression as a separator.
        May be called with optional C{maxsplit} argument, to limit the number of splits;
        and the optional C{includeSeparators} argument (default=C{False}), if the separating
        matching text should be included in the split results.
        
        Example::        
            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
        prints::
            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        r)r�N)r�)	r�rR�maxsplitZincludeSeparatorsZsplitsZlastrxr�r�ryryrzr�s

zParserElement.splitcCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)a�
        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
        converts them to L{Literal}s by default.
        
        Example::
            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))
        Prints::
            Hello, World! -> ['Hello', ',', 'World', '!']
        �4Cannot combine element of type %s with ParserElementrs��
stacklevelN)	r}r�r&rw�warnings�warnr��
SyntaxWarningrr"ryryrzrs


�zParserElement.__add__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of + operator when left operand is not a C{L{ParserElement}}
        r�rsr�N�r}r�r&rwr�r�r�r�r"ryryrzr#1s


�zParserElement.__radd__cCsJt|t�rt�|�}t|t�s:tjdt|�tdd�dS|t�	�|S)zQ
        Implementation of - operator, returns C{L{And}} with error stop
        r�rsr�N)
r}r�r&rwr�r�r�r�r�
_ErrorStopr"ryryrz�__sub__=s


�zParserElement.__sub__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of - operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rsub__Is


�zParserElement.__rsub__cs�t|t�r|d}}n�t|t�r�|ddd�}|ddkrHd|df}t|dt�r�|ddkr�|ddkrvt��S|ddkr�t��S�|dt��Sq�t|dt�r�t|dt�r�|\}}||8}q�tdt|d�t|d���ntdt|���|dk�rtd��|dk�rtd	��||k�r6dk�rBnntd
��|�r���fdd��|�r�|dk�rt��|�}nt�g|��|�}n�|�}n|dk�r��}nt�g|�}|S)
a�
        Implementation of * operator, allows use of C{expr * 3} in place of
        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
        may also include C{None} as in:
         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
              to C{expr*n + L{ZeroOrMore}(expr)}
              (read as "at least n instances of C{expr}")
         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
              (read as "0 to n instances of C{expr}")
         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}

        Note that C{expr*(None,n)} does not raise an exception if
        more than n exprs exist in the input stream; that is,
        C{expr*(None,n)} does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        C{expr*(None,n) + ~expr}
        r)NNNrsr�z7cannot multiply 'ParserElement' and ('%s','%s') objectsz0cannot multiply 'ParserElement' and '%s' objectsz/cannot multiply ParserElement by negative valuez@second tuple value must be greater or equal to first tuple valuez+cannot multiply ParserElement by 0 or (0,0)cs(|dkrt��|d��St��SdSr�)r��n��makeOptionalListr�ryrzr��sz/ParserElement.__mul__.<locals>.makeOptionalList)	r}rv�tupler4rr�r��
ValueErrorr)r�rZminElementsZoptElementsr�ryr�rz�__mul__UsD







zParserElement.__mul__cCs
|�|�Sr�)rr"ryryrz�__rmul__�szParserElement.__rmul__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zI
        Implementation of | operator - returns C{L{MatchFirst}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__or__�s


�zParserElement.__or__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||BS)z]
        Implementation of | operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__ror__�s


�zParserElement.__ror__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zA
        Implementation of ^ operator - returns C{L{Or}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__xor__�s


�zParserElement.__xor__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||AS)z]
        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rxor__�s


�zParserElement.__rxor__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zC
        Implementation of & operator - returns C{L{Each}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__and__�s


�zParserElement.__and__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||@S)z]
        Implementation of & operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rand__�s


�zParserElement.__rand__cCst|�S)zE
        Implementation of ~ operator - returns C{L{NotAny}}
        )rr�ryryrz�
__invert__�szParserElement.__invert__cCs|dk	r|�|�S|��SdS)a

        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
        
        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
        passed as C{True}.
           
        If C{name} is omitted, same as calling C{L{copy}}.

        Example::
            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
        N)r�r�rryryrz�__call__�s
zParserElement.__call__cCst|�S)z�
        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
        cluttering up returned output.
        )r-r�ryryrz�suppress�szParserElement.suppresscCs
d|_|S)a
        Disables the skipping of whitespace before matching the characters in the
        C{ParserElement}'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        F�r~r�ryryrz�leaveWhitespaceszParserElement.leaveWhitespacecCsd|_||_d|_|S)z8
        Overrides the default whitespace chars
        TF)r~rr�)r�ruryryrz�setWhitespaceChars
sz ParserElement.setWhitespaceCharscCs
d|_|S)z�
        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
        Must be called before C{parseString} when the input grammar contains elements that
        match C{<TAB>} characters.
        T)r�r�ryryrz�
parseWithTabsszParserElement.parseWithTabscCsLt|t�rt|�}t|t�r4||jkrH|j�|�n|j�t|����|S)a�
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.
        
        Example::
            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
            
            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        )r}r�r-r�rr�r"ryryrz�ignores


zParserElement.ignorecCs"|pt|pt|ptf|_d|_|S)zT
        Enable display of debugging messages while doing pattern matching.
        T)rTrWrYr�r�)r�ZstartActionZ
successActionZexceptionActionryryrz�setDebugActions6s�zParserElement.setDebugActionscCs|r|�ttt�nd|_|S)a�
        Enable display of debugging messages while doing pattern matching.
        Set C{flag} to True to enable, False to disable.

        Example::
            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer
            
            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")
        
        prints::
            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using L{setDebugActions}. Prior to attempting
        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
        F)rrTrWrYr�)r��flagryryrz�setDebug@s#zParserElement.setDebugcCs|jSr�)r�r�ryryrzr�iszParserElement.__str__cCst|�Sr�r�r�ryryrzr�lszParserElement.__repr__cCsd|_d|_|Sr�)r�r{r�ryryrzr�oszParserElement.streamlinecCsdSr�ryr�ryryrz�checkRecursiontszParserElement.checkRecursioncCs|�g�dS)zj
        Check defined expressions for valid structure, check for infinite recursive definitions.
        N)r)r��
validateTraceryryrz�validatewszParserElement.validatecCs�z|��}Wn2tk
r>t|d��}|��}W5QRXYnXz|�||�WStk
r~}ztjrj�n|�W5d}~XYnXdS)z�
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        �rN)�readr��openr�rr&r�)r�Zfile_or_filenamer�Z
file_contents�frXryryrz�	parseFile}szParserElement.parseFilecsHt|t�r"||kp t|�t|�kSt|t�r6|�|�Stt|�|kSdSr�)r}r&�varsr�r��superr"�rmryrz�__eq__�s



zParserElement.__eq__cCs
||kSr�ryr"ryryrz�__ne__�szParserElement.__ne__cCstt|��Sr�)�hash�idr�ryryrz�__hash__�szParserElement.__hash__cCs||kSr�ryr"ryryrz�__req__�szParserElement.__req__cCs
||kSr�ryr"ryryrz�__rne__�szParserElement.__rne__cCs4z|jt|�|d�WdStk
r.YdSXdS)a�
        Method for quick testing of a parser against a test string. Good for simple 
        inline microtests of sub expressions while building up larger parser.
           
        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
            
        Example::
            expr = Word(nums)
            assert expr.matches("100")
        �r�TFN)r�r�r)r�Z
testStringr�ryryrzr��s

zParserElement.matches�#cCs�t|t�r"tttj|������}t|t�r4t|�}g}g}d}	|D�]�}
|dk	r^|�	|
d�sf|rr|
sr|�
|
�qD|
sxqDd�|�|
g}g}z:|
�dd�}
|j
|
|d�}|�
|j|d��|	o�|}	Wn�tk
�rr}
z�t|
t�r�dnd	}d|
k�r*|�
t|
j|
��|�
d
t|
j|
�dd|�n|�
d
|
jd|�|�
d
t|
��|	�o\|}	|
}W5d}
~
XYnDtk
�r�}z$|�
dt|��|	�o�|}	|}W5d}~XYnX|�r�|�r�|�
d	�td�|��|�
|
|f�qD|	|fS)a3
        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.
           
        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
              string; pass None to disable comment filtering
         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default=C{True}) prints test output to stdout
         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
        test's output
        
        Example::
            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")
        prints::
            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success
            
            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\n of strings that spans \n 3 lines")
        
        (Note that this is a raw string literal, you must include the leading 'r'.)
        TNFr2�\nr%)rDz(FATAL)r�� r��^zFAIL: zFAIL-EXCEPTION: )r}r�r�r�r~r��rstrip�
splitlinesrr�rr�r�r�rArr#rIr�r;rprQ)r�Ztestsr�ZcommentZfullDumpZprintResultsZfailureTestsZ
allResultsZcomments�successrxr*�resultr�r�rXryryrz�runTests�sNW




$


zParserElement.runTests)F)F)T)T)TT)TT)r�)F)N)T)F)T)Tr&TTF)Or�r�r�r�rsr��staticmethodrvrxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r��_MAX_INTr�r�r�r�rr#r�r�rrrrrrrrrr	r
rr
rrrrr�r�r�rrrrrr"r#r$r�r.�
__classcell__ryryrrzr&Os�




&




G

"
2G+D
			

)

cs eZdZdZ�fdd�Z�ZS)r.zT
    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
    cstt|�jdd�dS�NF�r�)rr.r�r�rryrzr�@	szToken.__init__�r�r�r�r�r�r1ryryrrzr.<	scs eZdZdZ�fdd�Z�ZS)rz,
    An empty token, will always match.
    cs$tt|���d|_d|_d|_dS)NrTF)rrr�r�r�r�r�rryrzr�H	szEmpty.__init__r4ryryrrzrD	scs*eZdZdZ�fdd�Zddd�Z�ZS)rz(
    A token that will never match.
    cs*tt|���d|_d|_d|_d|_dS)NrTFzUnmatchable token)rrr�r�r�r�r�r�rryrzr�S	s
zNoMatch.__init__TcCst|||j|��dSr�)r!r�r�ryryrzr�Z	szNoMatch.parseImpl)T�r�r�r�r�r�r�r1ryryrrzrO	scs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Token to exactly match a specified string.
    
    Example::
        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
    
    For case-insensitive matching, use L{CaselessLiteral}.
    
    For keyword matching (force word break before and after the matched string),
    use L{Keyword} or L{CaselessKeyword}.
    cs�tt|���||_t|�|_z|d|_Wn*tk
rVtj	dt
dd�t|_YnXdt
|j�|_d|j|_d|_d|_dS)Nrz2null string passed to Literal; use Empty() insteadrsr��"%s"r�F)rrr��matchr��matchLen�firstMatchCharr�r�r�r�rrmr�r�r�r�r��r��matchStringrryrzr�l	s
�zLiteral.__init__TcCsJ|||jkr6|jdks&|�|j|�r6||j|jfSt|||j|��dSr�)r9r8�
startswithr7r!r�r�ryryrzr�	s��zLiteral.parseImpl)Tr5ryryrrzr^	s
csLeZdZdZedZd�fdd�	Zddd	�Z�fd
d�Ze	dd
��Z
�ZS)ra\
    Token to exactly match a specified string as a keyword, that is, it must be
    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
    Accepts two optional constructor arguments in addition to the keyword string:
     - C{identChars} is a string of characters that would be valid identifier characters,
          defaulting to all alphanumerics + "_" and "$"
     - C{caseless} allows case-insensitive matching, default is C{False}.
       
    Example::
        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use L{CaselessKeyword}.
    �_$NFcs�tt|���|dkrtj}||_t|�|_z|d|_Wn$tk
r^t	j
dtdd�YnXd|j|_d|j|_
d|_d|_||_|r�|��|_|��}t|�|_dS)Nrz2null string passed to Keyword; use Empty() insteadrsr�r6r�F)rrr��DEFAULT_KEYWORD_CHARSr7r�r8r9r�r�r�r�r�r�r�r��caseless�upper�
caselessmatchr��
identChars)r�r;rBr?rryrzr��	s*
�
zKeyword.__init__TcCs|jr|||||j���|jkr�|t|�|jksL|||j��|jkr�|dksj||d��|jkr�||j|jfSnv|||jkr�|jdks�|�|j|�r�|t|�|jks�|||j|jkr�|dks�||d|jkr�||j|jfSt	|||j
|��dSr�)r?r8r@rAr�rBr7r9r<r!r�r�ryryrzr��	s4����������zKeyword.parseImplcstt|���}tj|_|Sr�)rrr�r>rB)r�r�rryrzr��	szKeyword.copycCs
|t_dS)z,Overrides the default Keyword chars
        N)rr>rtryryrz�setDefaultKeywordChars�	szKeyword.setDefaultKeywordChars)NF)T)r�r�r�r�r5r>r�r�r�r/rCr1ryryrrzr�	s
cs*eZdZdZ�fdd�Zddd�Z�ZS)r
al
    Token to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::
        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
        
    (Contrast with example for L{CaselessKeyword}.)
    cs6tt|��|���||_d|j|_d|j|_dS)Nz'%s'r�)rr
r�r@�returnStringr�r�r:rryrzr��	szCaselessLiteral.__init__TcCs@||||j���|jkr,||j|jfSt|||j|��dSr�)r8r@r7rDr!r�r�ryryrzr��	szCaselessLiteral.parseImpl)Tr5ryryrrzr
�	s
cs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
r	z�
    Caseless version of L{Keyword}.

    Example::
        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
        
    (Contrast with example for L{CaselessLiteral}.)
    Ncstt|�j||dd�dS)NT�r?)rr	r�)r�r;rBrryrzr��	szCaselessKeyword.__init__TcCsj||||j���|jkrV|t|�|jksF|||j��|jkrV||j|jfSt|||j|��dSr�)r8r@rAr�rBr7r!r�r�ryryrzr��	s��zCaselessKeyword.parseImpl)N)Tr5ryryrrzr	�	scs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
rnax
    A variation on L{Literal} which matches "close" matches, that is, 
    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
     - C{match_string} - string to be matched
     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
    
    The results from a successful parse will contain the matched text from the input string and the following named results:
     - C{mismatches} - a list of the positions within the match_string where mismatches were found
     - C{original} - the original match_string used to compare against the input string
    
    If C{mismatches} is an empty list, then the match was an exact match.
    
    Example::
        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    r�csBtt|���||_||_||_d|j|jf|_d|_d|_dS)Nz&Expected %r (with up to %d mismatches)F)	rrnr�r��match_string�
maxMismatchesr�r�r�)r�rFrGrryrzr�

szCloseMatch.__init__TcCs�|}t|�}|t|j�}||kr�|j}d}g}	|j}
tt|||�|j��D]2\}}|\}}
||
krN|	�|�t|	�|
krNq�qN|d}t|||�g�}|j|d<|	|d<||fSt|||j|��dS)Nrr��original�
mismatches)	r�rFrGr�r�rr$r!r�)r�rRr�r��startr��maxlocrFZmatch_stringlocrIrGZs_m�src�mat�resultsryryrzr�
s( 

zCloseMatch.parseImpl)r�)Tr5ryryrrzrn�	s	cs8eZdZdZd
�fdd�	Zdd	d
�Z�fdd�Z�ZS)r1a	
    Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters,
    an optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction. An optional
    C{excludeChars} parameter can list characters that might be found in 
    the input C{bodyChars} string; useful to define a word of all printables
    except for one or two characters, for instance.
    
    L{srange} is useful for defining custom character set strings for defining 
    C{Word} expressions, using range notation from regular expression character sets.
    
    A common mistake is to use C{Word} to match a specific literal string, as in 
    C{Word("Address")}. Remember that C{Word} uses the string argument to define
    I{sets} of matchable characters. This expression would match "Add", "AAA",
    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
    To match an exact literal string, use L{Literal} or L{Keyword}.

    pyparsing includes helper strings for building Words:
     - L{alphas}
     - L{nums}
     - L{alphanums}
     - L{hexnums}
     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - L{printables} (any non-whitespace character)

    Example::
        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
        
        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums+'-')
        
        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")
        
        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    Nr�rFcs�tt|����rFd��fdd�|D��}|rFd��fdd�|D��}||_t|�|_|rl||_t|�|_n||_t|�|_|dk|_	|dkr�t
d��||_|dkr�||_nt
|_|dkr�||_||_t|�|_d|j|_d	|_||_d
|j|jk�r�|dk�r�|dk�r�|dk�r�|j|jk�r8dt|j�|_nHt|j�dk�rfdt�|j�t|j�f|_nd
t|j�t|j�f|_|j�r�d|jd|_zt�|j�|_Wntk
�r�d|_YnXdS)Nr�c3s|]}|�kr|VqdSr�ryr���excludeCharsryrzr�`
sz Word.__init__.<locals>.<genexpr>c3s|]}|�kr|VqdSr�ryr�rOryrzr�b
srr�zZcannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permittedr�Fr(z[%s]+z%s[%s]*z	[%s][%s]*z\b)rr1r�r��
initCharsOrigr��	initChars�
bodyCharsOrig�	bodyChars�maxSpecifiedr��minLen�maxLenr0r�r�r�r��	asKeyword�_escapeRegexRangeChars�reStringr�r��escape�compilerp)r�rRrT�min�max�exactrXrPrrOrzr�]
s\



0
����z
Word.__init__Tc
Cs>|jr<|j�||�}|s(t|||j|��|��}||��fS|||jkrZt|||j|��|}|d7}t|�}|j}||j	}t
||�}||kr�|||kr�|d7}q�d}	|||jkr�d}	|jr�||kr�|||kr�d}	|j
�r|dkr�||d|k�s||k�r|||k�rd}	|	�r.t|||j|��||||�fS)Nr�FTr)r�r7r!r��end�grouprRr�rTrWr]rVrUrX)
r�rRr�r�r-rJr�Z	bodycharsrKZthrowExceptionryryrzr��
s6


2zWord.parseImplcsvztt|���WStk
r$YnX|jdkrpdd�}|j|jkr`d||j�||j�f|_nd||j�|_|jS)NcSs$t|�dkr|dd�dS|SdS)N��...r��r�ryryrz�
charsAsStr�
sz Word.__str__.<locals>.charsAsStrz	W:(%s,%s)zW:(%s))rr1r�rpr{rQrS)r�rerryrzr��
s
zWord.__str__)Nr�rrFN)T�r�r�r�r�r�r�r�r1ryryrrzr1.
s.6
#csFeZdZdZee�d��Zd�fdd�	Zddd�Z	�fd	d
�Z
�ZS)
r)a�
    Token for matching strings that match a given regular expression.
    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
    named parse results.

    Example::
        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    z[A-Z]rcs�tt|���t|t�r�|s,tjdtdd�||_||_	zt
�|j|j	�|_
|j|_Wq�t
jk
r�tjd|tdd��Yq�Xn2t|tj�r�||_
t|�|_|_||_	ntd��t|�|_d|j|_d|_d|_d	S)
z�The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags.z0null string passed to Regex; use Empty() insteadrsr��$invalid pattern (%s) passed to RegexzCRegex may only be constructed with a string or a compiled RE objectr�FTN)rr)r�r}r�r�r�r��pattern�flagsr�r\rZ�
sre_constants�error�compiledREtyper~r�r�r�r�r�r�)r�rhrirryrzr��
s:
�
�
�
zRegex.__init__TcCs`|j�||�}|s"t|||j|��|��}|��}t|���}|rX|D]}||||<qF||fSr�)r�r7r!r�r`�	groupdictr$ra)r�rRr�r�r-�dr�r�ryryrzr��
szRegex.parseImplcsFztt|���WStk
r$YnX|jdkr@dt|j�|_|jS)NzRe:(%s))rr)r�rpr{r�rhr�rryrzr�
s
z
Regex.__str__)r)T)r�r�r�r�r�r�r\rlr�r�r�r1ryryrrzr)�
s
"

cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
r'a�
    Token for matching strings that are delimited by quoting characters.
    
    Defined with the following parameters:
        - quoteChar - string of one or more characters defining the quote delimiting string
        - escChar - character to escape quotes, typically backslash (default=C{None})
        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})

    Example::
        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
    prints::
        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    NFTc
sNtt����|��}|s0tjdtdd�t��|dkr>|}n"|��}|s`tjdtdd�t��|�_t	|��_
|d�_|�_t	|��_
|�_|�_|�_|�_|r�tjtjB�_dt��j�t�jd�|dk	r�t|�p�df�_n<d�_dt��j�t�jd�|dk	�rt|��pdf�_t	�j�d	k�rp�jd
d��fdd
�tt	�j�d	dd�D��d7_|�r��jdt�|�7_|�r��jdt�|�7_t��j�d�_�jdt��j�7_zt��j�j��_�j�_Wn0tjk
�r&tjd�jtdd��YnXt ���_!d�j!�_"d�_#d�_$dS)Nz$quoteChar cannot be the empty stringrsr�z'endQuoteChar cannot be the empty stringrz%s(?:[^%s%s]r�z%s(?:[^%s\n\r%s]r�z|(?:z)|(?:c3s4|],}dt��jd|��t�j|�fVqdS)z%s[^%s]N)r�r[�endQuoteCharrYr&r�ryrzr�Xs��z(QuotedString.__init__.<locals>.<genexpr>rt�)z|(?:%s)z|(?:%s.)z(.)z)*%srgr�FT)%rr'r�r�r�r�r��SyntaxError�	quoteCharr��quoteCharLen�firstQuoteCharro�endQuoteCharLen�escChar�escQuote�unquoteResults�convertWhitespaceEscapesr��	MULTILINE�DOTALLrir[rYrhr�r��escCharReplacePatternr\rZrjrkr�r�r�r�r�)r�rrrvrwZ	multilinerxroryrr�rzr�/s|



��
������
zQuotedString.__init__c	Cs�|||jkr|j�||�pd}|s4t|||j|��|��}|��}|jr�||j|j	�}t
|t�r�d|kr�|jr�ddddd�}|�
�D]\}}|�||�}q�|jr�t�|jd|�}|jr�|�|j|j�}||fS)N�\�	r2��
)�\tr'z\fz\rz\g<1>)rtr�r7r!r�r`rarxrsrur}r�ryr�r�rvr�r|rwro)	r�rRr�r�r-r�Zws_mapZwslitZwscharryryrzr�ps* 
�zQuotedString.parseImplcsHztt|���WStk
r$YnX|jdkrBd|j|jf|_|jS)Nz.quoted string, starting with %s ending with %s)rr'r�rpr{rrror�rryrzr��s
zQuotedString.__str__)NNFTNT)Trfryryrrzr'sA
#cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
ra�
    Token for matching words composed of characters I{not} in a given set (will
    include whitespace in matched characters if not listed in the provided exclusion set - see example).
    Defined with string containing all disallowed characters, and an optional
    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction.

    Example::
        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
    prints::
        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    r�rcs�tt|���d|_||_|dkr*td��||_|dkr@||_nt|_|dkrZ||_||_t	|�|_
d|j
|_|jdk|_d|_
dS)NFr�zfcannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permittedrr�)rrr�r~�notCharsr�rVrWr0r�r�r�r�r�)r�r�r]r^r_rryrzr��s 
zCharsNotIn.__init__TcCs�|||jkrt|||j|��|}|d7}|j}t||jt|��}||krb|||krb|d7}qD|||jkr�t|||j|��||||�fSr�)r�r!r�r]rWr�rV)r�rRr�r�rJZnotchars�maxlenryryrzr��s
�
zCharsNotIn.parseImplcsfztt|���WStk
r$YnX|jdkr`t|j�dkrTd|jdd�|_nd|j|_|jS)Nrbz
!W:(%s...)z!W:(%s))rrr�rpr{r�r�r�rryrzr��s
zCharsNotIn.__str__)r�rr)Trfryryrrzr�s
cs<eZdZdZdddddd�Zd�fdd�	Zddd�Z�ZS)r0a�
    Special matching class for matching whitespace.  Normally, whitespace is ignored
    by pyparsing grammars.  This class is included when some whitespace structures
    are significant.  Define with a string containing the whitespace characters to be
    matched; default is C{" \t\r\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
    as defined for the C{L{Word}} class.
    z<SPC>z<TAB>z<LF>z<CR>z<FF>)r(r~r2r�r� 	
r�rcs�tt����|�_��d��fdd��jD���d�dd��jD���_d�_d�j�_	|�_
|dkrt|�_nt�_|dkr�|�_|�_
dS)Nr�c3s|]}|�jkr|VqdSr�)�
matchWhiter�r�ryrzr��s
z!White.__init__.<locals>.<genexpr>css|]}tj|VqdSr�)r0�	whiteStrsr�ryryrzr��sTr�r)
rr0r�r�r
r�rr�r�r�rVrWr0)r�Zwsr]r^r_rr�rzr��s zWhite.__init__TcCs�|||jkrt|||j|��|}|d7}||j}t|t|��}||krb|||jkrb|d7}qB|||jkr�t|||j|��||||�fSr�)r�r!r�rWr]r�rV)r�rRr�r�rJrKryryrzr�	s

zWhite.parseImpl)r�r�rr)T)r�r�r�r�r�r�r�r1ryryrrzr0�s�cseZdZ�fdd�Z�ZS)�_PositionTokencs(tt|���|jj|_d|_d|_dSr�)rr�r�rmr�r�r�r�r�rryrzr�s
z_PositionToken.__init__�r�r�r�r�r1ryryrrzr�sr�cs2eZdZdZ�fdd�Zdd�Zd	dd�Z�ZS)
rzb
    Token to advance to a specific column of input text; useful for tabular report scraping.
    cstt|���||_dSr�)rrr�r;)r��colnorryrzr�$szGoToColumn.__init__cCs\t||�|jkrXt|�}|jr*|�||�}||krX||��rXt||�|jkrX|d7}q*|Sr�)r;r�r�r��isspace)r�rRr�r�ryryrzr�(s$
zGoToColumn.preParseTcCsDt||�}||jkr"t||d|��||j|}|||�}||fS)NzText not in expected column�r;r!)r�rRr�r�ZthiscolZnewlocr�ryryrzr�1s

zGoToColumn.parseImpl)T)r�r�r�r�r�r�r�r1ryryrrzr s	cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Matches if current position is at the beginning of a line within the parse string
    
    Example::
    
        test = '''        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)
    
    Prints::
        ['AAA', ' this line']
        ['AAA', ' and this line']    

    cstt|���d|_dS)NzExpected start of line)rrr�r�r�rryrzr�OszLineStart.__init__TcCs*t||�dkr|gfSt|||j|��dSr�)r;r!r�r�ryryrzr�SszLineStart.parseImpl)Tr5ryryrrzr:scs*eZdZdZ�fdd�Zddd�Z�ZS)rzU
    Matches if current position is at the end of a line within the parse string
    cs,tt|���|�tj�dd��d|_dS)Nr2r�zExpected end of line)rrr�r
r&rsr�r�r�rryrzr�\szLineEnd.__init__TcCsb|t|�kr6||dkr$|ddfSt|||j|��n(|t|�krN|dgfSt|||j|��dS)Nr2r��r�r!r�r�ryryrzr�aszLineEnd.parseImpl)Tr5ryryrrzrXscs*eZdZdZ�fdd�Zddd�Z�ZS)r,zM
    Matches if current position is at the beginning of the parse string
    cstt|���d|_dS)NzExpected start of text)rr,r�r�r�rryrzr�pszStringStart.__init__TcCs0|dkr(||�|d�kr(t|||j|��|gfSr�)r�r!r�r�ryryrzr�tszStringStart.parseImpl)Tr5ryryrrzr,lscs*eZdZdZ�fdd�Zddd�Z�ZS)r+zG
    Matches if current position is at the end of the parse string
    cstt|���d|_dS)NzExpected end of text)rr+r�r�r�rryrzr�szStringEnd.__init__TcCs^|t|�krt|||j|��n<|t|�kr6|dgfS|t|�krJ|gfSt|||j|��dSr�r�r�ryryrzr��szStringEnd.parseImpl)Tr5ryryrrzr+{scs.eZdZdZef�fdd�	Zddd�Z�ZS)r3ap
    Matches if the current position is at the beginning of a Word, and
    is not preceded by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
    the string being parsed, or at the beginning of a line.
    cs"tt|���t|�|_d|_dS)NzNot at the start of a word)rr3r�r��	wordCharsr��r�r�rryrzr��s
zWordStart.__init__TcCs@|dkr8||d|jks(|||jkr8t|||j|��|gfSr�)r�r!r�r�ryryrzr��s�zWordStart.parseImpl)T�r�r�r�r�rXr�r�r1ryryrrzr3�scs.eZdZdZef�fdd�	Zddd�Z�ZS)r2aZ
    Matches if the current position is at the end of a Word, and
    is not followed by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
    the string being parsed, or at the end of a line.
    cs(tt|���t|�|_d|_d|_dS)NFzNot at the end of a word)rr2r�r�r�r~r�r�rryrzr��s
zWordEnd.__init__TcCsPt|�}|dkrH||krH|||jks8||d|jkrHt|||j|��|gfSr�)r�r�r!r�)r�rRr�r�r�ryryrzr��s�zWordEnd.parseImpl)Tr�ryryrrzr2�scs�eZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Z�fdd�Z�fd
d�Z	�fdd�Z
d�fdd�	Zgfdd�Z�fdd�Z
�ZS)r"z^
    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r"t|�}t|t�r<t�|�g|_	nht|t
�rxt|�}tdd�|D��rlttj|�}t|�|_	n,zt|�|_	Wnt
k
r�|g|_	YnXd|_dS)Ncss|]}t|t�VqdSr�)r}r�)r�rSryryrzr��sz+ParseExpression.__init__.<locals>.<genexpr>F)rr"r�r}r�r�r�r&rw�exprsr�allr�r�r��r�r�r�rryrzr��s


zParseExpression.__init__cCs
|j|Sr�)r�r�ryryrzr��szParseExpression.__getitem__cCs|j�|�d|_|Sr�)r�rr{r"ryryrzr�szParseExpression.appendcCs0d|_dd�|jD�|_|jD]}|��q|S)z~Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
           all contained expressions.FcSsg|]}|���qSryr�r�r�ryryrzr��sz3ParseExpression.leaveWhitespace.<locals>.<listcomp>)r~r�r)r�r�ryryrzr�s


zParseExpression.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jD]}|�|jd�q*n,tt|��|�|jD]}|�|jd�qX|Sr�)r}r-r�rr"rr�)r�rr�rryrzr�s



zParseExpression.ignorecsNztt|���WStk
r$YnX|jdkrHd|jjt|j�f|_|jS�Nz%s:(%s))	rr"r�rpr{rmr�r�r�r�rryrzr��s
zParseExpression.__str__cs*tt|���|jD]}|��qt|j�dk�r|jd}t||j�r�|js�|jdkr�|j	s�|jdd�|jdg|_d|_
|j|jO_|j|jO_|jd}t||j��r|j�s|jdk�r|j	�s|jdd�|jdd�|_d|_
|j|jO_|j|jO_dt
|�|_|S)Nrsrr�rtr�)rr"r�r�r�r}rmryr|r�r{r�r�r�r�)r�r�rrryrzr��s<


���
���zParseExpression.streamlinecstt|��||�}|Sr�)rr"r�)r�r�r�r�rryrzr�
szParseExpression.setResultsNamecCs6|dd�|g}|jD]}|�|�q|�g�dSr�)r�rr)r�r�tmpr�ryryrzr
s
zParseExpression.validatecs$tt|���}dd�|jD�|_|S)NcSsg|]}|���qSryrr�ryryrzr�%
sz(ParseExpression.copy.<locals>.<listcomp>)rr"r�r�r1rryrzr�#
szParseExpression.copy)F)F)r�r�r�r�r�r�rrrr�r�r�rr�r1ryryrrzr"�s	
"csTeZdZdZGdd�de�Zd�fdd�	Zddd�Zd	d
�Zdd�Z	d
d�Z
�ZS)ra

    Requires all given C{ParseExpression}s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'+'} operator.
    May also be constructed using the C{'-'} operator, which will suppress backtracking.

    Example::
        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"),name_expr("name"),integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    cseZdZ�fdd�Z�ZS)zAnd._ErrorStopcs&ttj|�j||�d|_|��dS)N�-)rrr�r�r�rrGrryrzr�9
szAnd._ErrorStop.__init__r�ryryrrzr�8
sr�TcsRtt|��||�tdd�|jD��|_|�|jdj�|jdj|_d|_	dS)Ncss|]}|jVqdSr��r�r�ryryrzr�@
szAnd.__init__.<locals>.<genexpr>rT)
rrr�r�r�r�r
rr~r�r�rryrzr�>
s
zAnd.__init__c	Cs�|jdj|||dd�\}}d}|jdd�D]�}t|tj�rDd}q.|r�z|�|||�\}}Wq�tk
rt�Yq�tk
r�}zd|_t�|��W5d}~XYq�t	k
r�t|t
|�|j|��Yq�Xn|�|||�\}}|s�|��r.||7}q.||fS)NrFr�r�T)
r�r�r}rr�r%r�
__traceback__r�r�r�r�r
)	r�rRr�r��
resultlistZ	errorStopr�Z
exprtokensr�ryryrzr�E
s(
z
And.parseImplcCst|t�rt�|�}|�|�Sr��r}r�r&rwrr"ryryrzr!^
s

zAnd.__iadd__cCs6|dd�|g}|jD]}|�|�|jsq2qdSr�)r�rr��r�r��subRecCheckListr�ryryrzrc
s


zAnd.checkRecursioncCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr��{r(css|]}t|�VqdSr�r�r�ryryrzr�o
szAnd.__str__.<locals>.<genexpr>�}�r�r�r{r�r�r�ryryrzr�j
s


 zAnd.__str__)T)T)r�r�r�r�rr�r�r�r!rr�r1ryryrrzr(
s
csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the expression that matches the longest string will be used.
    May be constructed using the C{'^'} operator.

    Example::
        # construct Or using '^' operator
        
        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))
    prints::
        [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
szOr.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szOr.__init__TcCsRd}d}g}|jD]�}z|�||�}Wnvtk
rb}	zd|	_|	j|krR|	}|	j}W5d}	~	XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqX|�||f�q|�r(|j	dd�d�|D]^\}
}z|�
|||�WStk
�r$}	z d|	_|	j|k�r|	}|	j}W5d}	~	XYq�Xq�|dk	�r@|j|_|�nt||d|��dS)NrtcSs
|dSr�ry)�xryryrzr{�
r|zOr.parseImpl.<locals>.<lambda>)r� no defined alternatives to match)r�r�r!r�r�r�r�r�r�sortr�r�)r�rRr�r��	maxExcLoc�maxExceptionr�r�Zloc2r��_ryryrzr��
s<


zOr.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ixor__�
s

zOr.__ixor__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z ^ css|]}t|�VqdSr�r�r�ryryrzr��
szOr.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 z
Or.__str__cCs,|dd�|g}|jD]}|�|�qdSr��r�rr�ryryrzr�
s
zOr.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzrt
s

&	csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the first one listed is the one that will match.
    May be constructed using the C{'|'} operator.

    Example::
        # construct MatchFirst using '|' operator
        
        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
sz&MatchFirst.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szMatchFirst.__init__Tc	Cs�d}d}|jD]�}z|�|||�}|WStk
r`}z|j|krP|}|j}W5d}~XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqXq|dk	r�|j|_|�nt||d|��dS)Nrtr�)r�r�r!r�r�r�r�r�)	r�rRr�r�r�r�r�r�r�ryryrzr��
s$


zMatchFirst.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ior__�
s

zMatchFirst.__ior__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�� | css|]}t|�VqdSr�r�r�ryryrzr��
sz%MatchFirst.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 zMatchFirst.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzrs
zMatchFirst.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzr�
s
	cs<eZdZdZd�fdd�	Zddd�Zdd�Zd	d
�Z�ZS)
ram
    Requires all given C{ParseExpression}s to be found, but in any order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'&'} operator.

    Example::
        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order 
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )
    prints::
        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    Tcs8tt|��||�tdd�|jD��|_d|_d|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr�?sz Each.__init__.<locals>.<genexpr>T)rrr�r�r�r�r~�initExprGroupsr�rryrzr�=sz
Each.__init__c	s�|jr�tdd�|jD��|_dd�|jD�}dd�|jD�}|||_dd�|jD�|_dd�|jD�|_dd�|jD�|_|j|j7_d	|_|}|jdd�}|jdd��g}d
}	|	�rj|�|j|j}
g}|
D]v}z|�||�}Wn t	k
�r|�
|�Yq�X|�
|j�t|�|��||k�r@|�
|�q�|�kr܈�
|�q�t|�t|
�kr�d	}	q�|�r�d�dd�|D��}
t	||d
|
��|�fdd�|jD�7}g}|D]"}|�|||�\}}|�
|��q�t|tg��}||fS)Ncss&|]}t|t�rt|j�|fVqdSr�)r}rr!rSr�ryryrzr�Es
z!Each.parseImpl.<locals>.<genexpr>cSsg|]}t|t�r|j�qSry�r}rrSr�ryryrzr�Fs
z"Each.parseImpl.<locals>.<listcomp>cSs g|]}|jrt|t�s|�qSry)r�r}rr�ryryrzr�Gs
cSsg|]}t|t�r|j�qSry)r}r4rSr�ryryrzr�Is
cSsg|]}t|t�r|j�qSry)r}rrSr�ryryrzr�Js
cSs g|]}t|tttf�s|�qSry)r}rr4rr�ryryrzr�KsFTr%css|]}t|�VqdSr�r�r�ryryrzr�fsz*Missing one or more required elements (%s)cs$g|]}t|t�r|j�kr|�qSryr�r��ZtmpOptryrzr�js

)r�r�r�Zopt1mapZ	optionalsZmultioptionalsZ
multirequiredZrequiredr�r!rr�r!�remover�r�r��sumr$)r�rRr�r�Zopt1Zopt2ZtmpLocZtmpReqdZ
matchOrderZkeepMatchingZtmpExprsZfailedr�Zmissingr�rNZfinalResultsryr�rzr�CsP

zEach.parseImplcCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z & css|]}t|�VqdSr�r�r�ryryrzr�yszEach.__str__.<locals>.<genexpr>r�r�r�ryryrzr�ts


 zEach.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzr}s
zEach.checkRecursion)T)T)	r�r�r�r�r�r�r�rr1ryryrrzrs
5
1	csleZdZdZd�fdd�	Zddd�Zdd	�Z�fd
d�Z�fdd
�Zdd�Z	gfdd�Z
�fdd�Z�ZS)r za
    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r@ttjt�r2t�|�}nt�t	|��}||_
d|_|dk	r�|j|_|j
|_
|�|j�|j|_|j|_|j|_|j�|j�dSr�)rr r�r}r��
issubclassr&rwr.rrSr{r�r�r
rr~r}r�r�r�r�rSr�rryrzr��s
zParseElementEnhance.__init__TcCs2|jdk	r|jj|||dd�Std||j|��dS)NFr�r�)rSr�r!r�r�ryryrzr��s
zParseElementEnhance.parseImplcCs*d|_|j��|_|jdk	r&|j��|Sr�)r~rSr�rr�ryryrzr�s


z#ParseElementEnhance.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jdk	rn|j�|jd�n,tt|��|�|jdk	rn|j�|jd�|Sr�)r}r-r�rr rrSr"rryrzr�s



zParseElementEnhance.ignorecs&tt|���|jdk	r"|j��|Sr�)rr r�rSr�rryrzr��s

zParseElementEnhance.streamlinecCsB||krt||g��|dd�|g}|jdk	r>|j�|�dSr�)r(rSr)r�r�r�ryryrzr�s

z"ParseElementEnhance.checkRecursioncCs6|dd�|g}|jdk	r(|j�|�|�g�dSr��rSrr�r�rr�ryryrzr�s
zParseElementEnhance.validatecsXztt|���WStk
r$YnX|jdkrR|jdk	rRd|jjt|j�f|_|jSr�)	rr r�rpr{rSrmr�r�r�rryrzr��szParseElementEnhance.__str__)F)T)
r�r�r�r�r�r�rrr�rrr�r1ryryrrzr �s
cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Lookahead matching of the given parse expression.  C{FollowedBy}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression matches at the current
    position.  C{FollowedBy} always returns a null token list.

    Example::
        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
    prints::
        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    cstt|��|�d|_dSr�)rrr�r��r�rSrryrzr��szFollowedBy.__init__TcCs|j�||�|gfSr�)rSr�r�ryryrzr��szFollowedBy.parseImpl)Tr5ryryrrzr�scs2eZdZdZ�fdd�Zd	dd�Zdd�Z�ZS)
ra�
    Lookahead to disallow matching with the given parse expression.  C{NotAny}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression does I{not} match at the current
    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
    always returns a null token list.  May be constructed using the '~' operator.

    Example::
        
    cs0tt|��|�d|_d|_dt|j�|_dS)NFTzFound unwanted token, )rrr�r~r�r�rSr�r�rryrzr��szNotAny.__init__TcCs&|j�||�rt|||j|��|gfSr�)rSr�r!r�r�ryryrzr��szNotAny.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�z~{r��r�r�r{r�rSr�ryryrzr�s


zNotAny.__str__)Trfryryrrzr�s

cs(eZdZd�fdd�	Zddd�Z�ZS)	�_MultipleMatchNcsFtt|��|�d|_|}t|t�r.t�|�}|dk	r<|nd|_dSr�)	rr�r�r}r}r�r&rw�	not_ender)r�rS�stopOnZenderrryrzr�s

z_MultipleMatch.__init__Tc	Cs�|jj}|j}|jdk	}|r$|jj}|r2|||�||||dd�\}}zV|j}	|r`|||�|	rp|||�}
n|}
|||
|�\}}|s�|��rR||7}qRWnttfk
r�YnX||fS�NFr�)	rSr�r�r�r�r�r
r!r�)r�rRr�r�Zself_expr_parseZself_skip_ignorablesZcheck_enderZ
try_not_enderr�ZhasIgnoreExprsr�Z	tmptokensryryrzr�s*



z_MultipleMatch.parseImpl)N)T)r�r�r�r�r�r1ryryrrzr�
sr�c@seZdZdZdd�ZdS)ra�
    Repetition of one or more of the given expression.
    
    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
        
        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    cCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r�z}...r�r�ryryrzr�Js


zOneOrMore.__str__N)r�r�r�r�r�ryryryrzr0scs8eZdZdZd
�fdd�	Zd�fdd�	Zdd	�Z�ZS)r4aw
    Optional repetition of zero or more of the given expression.
    
    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example: similar to L{OneOrMore}
    Ncstt|�j||d�d|_dS)N)r�T)rr4r�r�)r�rSr�rryrzr�_szZeroOrMore.__init__Tc	s<ztt|��|||�WSttfk
r6|gfYSXdSr�)rr4r�r!r�r�rryrzr�cszZeroOrMore.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$�]...r�r�ryryrzr�is


zZeroOrMore.__str__)N)Trfryryrrzr4Ssc@s eZdZdd�ZeZdd�ZdS)�
_NullTokencCsdSr�ryr�ryryrzr�ssz_NullToken.__bool__cCsdSr�ryr�ryryrzr�vsz_NullToken.__str__N)r�r�r�r�rLr�ryryryrzr�rsr�cs6eZdZdZef�fdd�	Zd	dd�Zdd�Z�ZS)
raa
    Optional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::
        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345
            
            # ZIP+4 form
            12101-0001
            
            # invalid ZIP
            98765-
            ''')
    prints::
        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    cs.tt|�j|dd�|jj|_||_d|_dS)NFr3T)rrr�rSr}rr�)r�rSrrryrzr��s
zOptional.__init__Tc	Cszz|jj|||dd�\}}WnTttfk
rp|jtk	rh|jjr^t|jg�}|j||jj<ql|jg}ng}YnX||fSr�)rSr�r!r�r�_optionalNotMatchedr|r$)r�rRr�r�r�ryryrzr��s


zOptional.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$r'r�r�ryryrzr��s


zOptional.__str__)T)	r�r�r�r�r�r�r�r�r1ryryrrzrzs"
cs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r*a�	
    Token for skipping over all undefined text until the matched expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default=C{False}) if True, the target expression is also parsed 
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
          comments) that might contain false matches to the target expression
     - failOn - (default=C{None}) define expressions that are not allowed to be 
          included in the skipped test; if found before the target expression is found, 
          the SkipTo is not a match

    Example::
        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP 
                      + string_data("sev") + SEP 
                      + string_data("desc") + SEP 
                      + integer("days_open"))
        
        for tkt in ticket_expr.searchString(report):
            print tkt.dump()
    prints::
        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    FNcs`tt|��|�||_d|_d|_||_d|_t|t	�rFt
�|�|_n||_dt
|j�|_dS)NTFzNo match found for )rr*r��
ignoreExprr�r��includeMatchr�r}r�r&rw�failOnr�rSr�)r�rZincluderr�rryrzr��s
zSkipTo.__init__Tc	Cs&|}t|�}|j}|jj}|jdk	r,|jjnd}|jdk	rB|jjnd}	|}
|
|kr�|dk	rf|||
�rfq�|	dk	r�z|	||
�}
Wqntk
r�Yq�YqnXqnz|||
ddd�Wq�tt	fk
r�|
d7}
YqJXq�qJt|||j
|��|
}|||�}t|�}|j�r||||dd�\}}
||
7}||fS)NF)r�r�r�r�)
r�rSr�r�r�r�r�rr!r�r�r$r�)r�rRr�r�rUr�rSZ
expr_parseZself_failOn_canParseNextZself_ignoreExpr_tryParseZtmplocZskiptextZ
skipresultrMryryrzr��s:
zSkipTo.parseImpl)FNN)Tr5ryryrrzr*�s6
csbeZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zgfd
d�Z	dd�Z
�fdd�Z�ZS)raK
    Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.

    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
    Specifically, '|' has a lower precedence than '<<', so that::
        fwdExpr << a | b | c
    will actually be evaluated as::
        (fwdExpr << a) | b | c
    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the C{Forward}::
        fwdExpr << (a | b | c)
    Converting to use the '<<=' operator instead will avoid this problem.

    See L{ParseResults.pprint} for an example of a recursive parser created using
    C{Forward}.
    Ncstt|�j|dd�dSr2)rrr�r"rryrzr�@szForward.__init__cCsjt|t�rt�|�}||_d|_|jj|_|jj|_|�|jj	�|jj
|_
|jj|_|j�
|jj�|Sr�)r}r�r&rwrSr{r�r�r
rr~r}r�rr"ryryrz�
__lshift__Cs





zForward.__lshift__cCs||>Sr�ryr"ryryrz�__ilshift__PszForward.__ilshift__cCs
d|_|Sr�rr�ryryrzrSszForward.leaveWhitespacecCs$|js d|_|jdk	r |j��|Sr�)r�rSr�r�ryryrzr�Ws


zForward.streamlinecCs>||kr0|dd�|g}|jdk	r0|j�|�|�g�dSr�r�r�ryryrzr^s

zForward.validatecCsVt|d�r|jS|jjdSz|jdk	r4t|j�}nd}W5|j|_X|jjd|S)Nr�z: ...�Nonez: )r�r�rmr�Z_revertClass�_ForwardNoRecurserSr�)r�Z	retStringryryrzr�es


zForward.__str__cs.|jdk	rtt|���St�}||K}|SdSr�)rSrrr�r1rryrzr�vs

zForward.copy)N)
r�r�r�r�r�r�r�rr�rr�r�r1ryryrrzr-s
c@seZdZdd�ZdS)r�cCsdS)Nrcryr�ryryrzr�sz_ForwardNoRecurse.__str__N)r�r�r�r�ryryryrzr�~sr�cs"eZdZdZd�fdd�	Z�ZS)r/zQ
    Abstract subclass of C{ParseExpression}, for converting parsed results.
    Fcstt|��|�d|_dSr�)rr/r�r}r�rryrzr��szTokenConverter.__init__)Fr4ryryrrzr/�scs6eZdZdZd
�fdd�	Z�fdd�Zdd	�Z�ZS)ra�
    Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the input string;
    this can be disabled by specifying C{'adjacent=False'} in the constructor.

    Example::
        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    r�Tcs8tt|��|�|r|��||_d|_||_d|_dSr�)rrr�r�adjacentr~�
joinStringr�)r�rSr�r�rryrzr��szCombine.__init__cs(|jrt�||�ntt|��|�|Sr�)r�r&rrrr"rryrzr�szCombine.ignorecCsP|��}|dd�=|td�|�|j��g|jd�7}|jrH|��rH|gS|SdS)Nr�)r�)r�r$r�r(r�r�r|r
)r�rRr�r�ZretToksryryrzr��s
"zCombine.postParse)r�T)r�r�r�r�r�rr�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)ra�
    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.

    Example::
        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
    cstt|��|�d|_dSr�)rrr�r}r�rryrzr��szGroup.__init__cCs|gSr�ryr�ryryrzr��szGroup.postParse�r�r�r�r�r�r�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)r
aW
    Converter to return a repetitive expression as a list, but also as a dictionary.
    Each element can also be referenced using the first token in the expression as its key.
    Useful for tabular report scraping when the first column can be used as a item key.

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())
        
        # access named fields as dict entries, or output as dict
        print(result['shape'])        
        print(result.asDict())
    prints::
        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
    See more examples at L{ParseResults} of accessing fields by results name.
    cstt|��|�d|_dSr�)rr
r�r}r�rryrzr��sz
Dict.__init__cCs�t|�D]�\}}t|�dkrq|d}t|t�r@t|d���}t|�dkr\td|�||<qt|�dkr�t|dt�s�t|d|�||<q|��}|d=t|�dks�t|t�r�|�	�r�t||�||<qt|d|�||<q|j
r�|gS|SdS)Nrr�r�rs)r�r�r}rvr�r�r�r$r�r
r|)r�rRr�r�r��tokZikeyZ	dictvalueryryrzr��s$
zDict.postParser�ryryrrzr
�s#c@s eZdZdZdd�Zdd�ZdS)r-aV
    Converter for ignoring the results of a parsed expression.

    Example::
        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))
    prints::
        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']
    (See also L{delimitedList}.)
    cCsgSr�ryr�ryryrzr�szSuppress.postParsecCs|Sr�ryr�ryryrzr
"szSuppress.suppressN)r�r�r�r�r�r
ryryryrzr-sc@s(eZdZdZdd�Zdd�Zdd�ZdS)	rzI
    Wrapper for parse actions, to ensure they are only called once.
    cCst|�|_d|_dSr�)rr�callable�called)r�Z
methodCallryryrzr�*s
zOnlyOnce.__init__cCs.|js|�|||�}d|_|St||d��dS)NTr�)r�r�r!)r�r�r[rxrNryryrzr	-s
zOnlyOnce.__call__cCs
d|_dSr�)r�r�ryryrz�reset3szOnlyOnce.resetN)r�r�r�r�r�r	r�ryryryrzr&scs:t����fdd�}z�j|_Wntk
r4YnX|S)at
    Decorator for debugging parse actions. 
    
    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.

    Example::
        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
    prints::
        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    c
s��j}|dd�\}}}t|�dkr8|djjd|}tj�d|t||�||f�z�|�}Wn8tk
r�}ztj�d||f��W5d}~XYnXtj�d||f�|S)Nr^rqr�.z">>entering %s(line: '%s', %d, %r)
z<<leaving %s (exception: %s)
z<<leaving %s (ret: %r)
)r�r�rmr��stderr�writerIrp)ZpaArgsZthisFuncr�r[rxr�rX�rryrz�zLsztraceParseAction.<locals>.z)rrr�r�)rr�ryr�rzrd6s
�,FcCs`t|�dt|�dt|�d}|rBt|t||���|�S|tt|�|��|�SdS)a�
    Helper to define a delimited list of expressions - the delimiter defaults to ','.
    By default, the list elements and delimiters can have intervening whitespace, and
    comments, but this can be overridden by passing C{combine=True} in the constructor.
    If C{combine} is set to C{True}, the matching tokens are returned as a single token
    string, with the delimiters included; otherwise, the matching tokens are returned
    as a list of tokens, with the delimiters suppressed.

    Example::
        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    z [r(r�N)r�rr4r�r-)rSZdelim�combineZdlNameryryrzrBbs
$csjt����fdd�}|dkr0tt��dd��}n|��}|�d�|j|dd�|��d	t��d
�S)a:
    Helper to define a counted list of expressions.
    This helper defines a pattern of the form::
        integer expr expr expr...
    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
    
    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.

    Example::
        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    cs.|d}�|r tt�g|��p&tt�>gSr�)rrrE)r�r[rxr��Z	arrayExprrSryrz�countFieldParseAction�s"z+countedArray.<locals>.countFieldParseActionNcSst|d�Sr�)rvrwryryrzr{�r|zcountedArray.<locals>.<lambda>ZarrayLenT�r�z(len) rc)rr1rTr�r�r�r�r�)rSZintExprr�ryr�rzr>us
cCs6g}|D](}t|t�r&|�t|��q|�|�q|Sr�)r}r�rr�r)�Lr�r�ryryrzr��s
r�cs6t���fdd�}|j|dd���dt|���S)a*
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
    If this is not desired, use C{matchPreviousExpr}.
    Do I{not} use with packrat parsing enabled.
    csP|rBt|�dkr�|d>qLt|���}�tdd�|D��>n
�t�>dS)Nr�rcss|]}t|�VqdSr�)r�r�Zttryryrzr��szDmatchPreviousLiteral.<locals>.copyTokenToRepeater.<locals>.<genexpr>)r�r�r�rr)r�r[rxZtflat�Zrepryrz�copyTokenToRepeater�sz1matchPreviousLiteral.<locals>.copyTokenToRepeaterTr��(prev) )rr�r�r�)rSr�ryr�rzrQ�s


csFt��|��}�|K��fdd�}|j|dd���dt|���S)aS
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
    the expressions are evaluated first, and then compared, so
    C{"1"} is compared with C{"10"}.
    Do I{not} use with packrat parsing enabled.
    cs*t|�����fdd�}�j|dd�dS)Ncs$t|���}|�kr tddd��dS)Nr�r)r�r�r!)r�r[rxZtheseTokens�ZmatchTokensryrz�mustMatchTheseTokens�szLmatchPreviousExpr.<locals>.copyTokenToRepeater.<locals>.mustMatchTheseTokensTr�)r�r�r�)r�r[rxr�r�r�rzr��sz.matchPreviousExpr.<locals>.copyTokenToRepeaterTr�r�)rr�r�r�r�)rSZe2r�ryr�rzrP�scCs:dD]}|�|t|�}q|�dd�}|�dd�}t|�S)Nz\^-]r2r'r~r�)r��_bslashr�)r�r�ryryrzrY�s
rYTc
s�|rdd�}dd�}t�ndd�}dd�}t�g}t|t�rF|��}n$t|t�rZt|�}ntjdt	dd�|stt
�Sd	}|t|�d
k�r||}t||d
d��D]R\}}	||	|�r�|||d
=qxq�|||	�r�|||d
=|�
||	�|	}qxq�|d
7}qx|�s�|�r�zlt|�td�|��k�rTtd
d�dd�|D����d�|��WStd�dd�|D����d�|��WSWn&tk
�r�tjdt	dd�YnXt�fdd�|D���d�|��S)a�
    Helper to quickly define a set of alternative Literals, and makes sure to do
    longest-first testing when there is a conflict, regardless of the input order,
    but returns a C{L{MatchFirst}} for best performance.

    Parameters:
     - strs - a string of space-delimited literals, or a collection of string literals
     - caseless - (default=C{False}) - treat all literals as caseless
     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
          if creating a C{Regex} raises an exception)

    Example::
        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
    prints::
        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    cSs|��|��kSr�)r@�r�bryryrzr{�r|zoneOf.<locals>.<lambda>cSs|���|���Sr�)r@r<r�ryryrzr{�r|cSs||kSr�ryr�ryryrzr{�r|cSs
|�|�Sr�)r<r�ryryrzr{�r|z6Invalid argument to oneOf, expected string or iterablersr�rr�Nr�z[%s]css|]}t|�VqdSr�)rY�r�Zsymryryrzr�szoneOf.<locals>.<genexpr>r��|css|]}t�|�VqdSr�)r�r[r�ryryrzr�sz7Exception creating Regex for oneOf, building MatchFirstc3s|]}�|�VqdSr�ryr��ZparseElementClassryrzr�$s)r
rr}r�r�rr�r�r�r�rr�r�rr�r)r�rpr)
Zstrsr?ZuseRegexZisequalZmasksZsymbolsr�Zcurr�rryr�rzrU�sT



�


**�cCsttt||���S)a�
    Helper to easily and clearly define a dictionary by specifying the respective patterns
    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
    in the proper order.  The key pattern can include delimiting markers or punctuation,
    as long as they are suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the C{Dict} results can include named token
    fields.

    Example::
        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())
    prints::
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    )r
r4r)rr�ryryrzrC&s!cCs^t��dd��}|��}d|_|d�||d�}|r@dd�}ndd�}|�|�|j|_|S)	a�
    Helper to return the original, untokenized text for a given expression.  Useful to
    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
    revert separate tokens with intervening whitespace back to the original matching
    input text. By default, returns astring containing the original parsed text.  
       
    If the optional C{asString} argument is passed as C{False}, then the return value is a 
    C{L{ParseResults}} containing any results names that were originally matched, and a 
    single token containing the original matched text from the input string.  So if 
    the expression passed to C{L{originalTextFor}} contains expressions with defined
    results names, you must set C{asString} to C{False} if you want to preserve those
    results name values.

    Example::
        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b","i"):
            opener,closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])
    prints::
        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    cSs|Sr�ry)r�r�rxryryrzr{ar|z!originalTextFor.<locals>.<lambda>F�_original_start�
_original_endcSs||j|j�Sr�)r�r�rZryryrzr{fr|cSs&||�d�|�d��g|dd�<dS)Nr�r�)rrZryryrz�extractTexthsz$originalTextFor.<locals>.extractText)rr�r�r�r�)rSZasStringZ	locMarkerZendlocMarker�	matchExprr�ryryrzriIs

cCst|��dd��S)zp
    Helper to undo pyparsing's default grouping of And expressions, even
    if all but one are non-empty.
    cSs|dSr�ryrwryryrzr{sr|zungroup.<locals>.<lambda>)r/r�)rSryryrzrjnscCs4t��dd��}t|d�|d�|����d��S)a�
    Helper to decorate a returned token with its starting and ending locations in the input string.
    This helper adds the following results names:
     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains C{<TAB>} characters, you may want to call
    C{L{ParserElement.parseWithTabs}}

    Example::
        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)
    prints::
        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    cSs|Sr�ryrZryryrzr{�r|zlocatedExpr.<locals>.<lambda>Z
locn_startr�Zlocn_end)rr�rr�r)rSZlocatorryryrzrlusz\[]-*.$+^?()~ �r_cCs|ddSr�ryrZryryrzr{�r|r{z\\0?[xX][0-9a-fA-F]+cCstt|d�d�d��S)Nrz\0x�)�unichrrv�lstriprZryryrzr{�r|z	\\0[0-7]+cCstt|ddd�d��S)Nrr��)r�rvrZryryrzr{�r|z\]r�r$r)�negate�bodyr'csFdd��z"d��fdd�t�|�jD��WStk
r@YdSXdS)a�
    Helper to easily define string ranges for use in Word construction.  Borrows
    syntax from regexp '[]' string range definitions::
        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
    The input string must be enclosed in []'s, and the returned string is the expanded
    character set joined into a single string.
    The values enclosed in the []'s may be:
     - a single character
     - an escaped character with a leading backslash (such as C{\-} or C{\]})
     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
         (C{\0x##} is also supported for backwards compatibility) 
     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
    cSs<t|t�s|Sd�dd�tt|d�t|d�d�D��S)Nr�css|]}t|�VqdSr�)r�r�ryryrzr��sz+srange.<locals>.<lambda>.<locals>.<genexpr>rr�)r}r$r�r��ord)�pryryrzr{�r|zsrange.<locals>.<lambda>r�c3s|]}�|�VqdSr�ry)r��part�Z	_expandedryrzr��szsrange.<locals>.<genexpr>N)r��_reBracketExprr�r�rprdryr�rzra�s
"cs�fdd�}|S)zt
    Helper method for defining parse actions that require matching at a specific
    column in the input text.
    cs"t||��krt||d���dS)Nzmatched token not at column %dr�)rNZlocnrVr�ryrz�	verifyCol�sz!matchOnlyAtCol.<locals>.verifyColry)r�r�ryr�rzrO�scs�fdd�S)a�
    Helper method for common parse actions that simply return a literal value.  Especially
    useful when used with C{L{transformString<ParserElement.transformString>}()}.

    Example::
        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num
        
        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    cs�gSr�ryrZ�ZreplStrryrzr{�r|zreplaceWith.<locals>.<lambda>ryr�ryr�rzr^�scCs|ddd�S)a
    Helper parse action for removing quotation marks from parsed quoted strings.

    Example::
        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    rr�rtryrZryryrzr\�scsN��fdd�}zt�dt�d�j�}Wntk
rBt��}YnX||_|S)aG
    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
    args are passed, they are forwarded to the given function as additional arguments after
    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
    parsed data to an integer using base 16.

    Example (compare the last to example in L{ParserElement.transformString}::
        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')
        
        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')
    prints::
        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    cs��fdd�|D�S)Ncsg|]}�|f����qSryry)r�Ztokn�r�r\ryrzr��sz(tokenMap.<locals>.pa.<locals>.<listcomp>ryrZr�ryrzr��sztokenMap.<locals>.par�rm)ror�rpr~)r\r�r�rqryr�rzro�s 
�cCst|���Sr��r�r@rwryryrzr{r|cCst|���Sr��r��lowerrwryryrzr{r|c	Cs�t|t�r|}t||d�}n|j}tttd�}|r�t���	t
�}td�|d�tt
t|td�|���tddgd��d	��	d
d��td�}n�d
�dd�tD��}t���	t
�t|�B}td�|d�tt
t|�	t�ttd�|����tddgd��d	��	dd��td�}ttd�|d�}|�dd
�|�dd��������d|�}|�dd
�|�dd��������d|�}||_||_||fS)zRInternal helper to construct opening and closing tag expressions, given a tag namerEz_-:r5�tag�=�/F�rrEcSs|ddkS�Nrr�ryrZryryrzr{r|z_makeTags.<locals>.<lambda>r6r�css|]}|dkr|VqdS)r6Nryr�ryryrzr�sz_makeTags.<locals>.<genexpr>cSs|ddkSr�ryrZryryrzr{r|r7rJ�:r(z<%s>r`z</%s>)r}r�rr�r1r6r5r@r�r�r\r-r
r4rrr�r�rXr[rDr�_Lr��titler�r�r�)�tagStrZxmlZresnameZtagAttrNameZtagAttrValueZopenTagZprintablesLessRAbrackZcloseTagryryrz�	_makeTagss>
�������..rcCs
t|d�S)a 
    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.

    Example::
        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
        a,a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end
        
        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
            print(link.link_text, '->', link.href)
    prints::
        pyparsing -> http://pyparsing.wikispaces.com
    F�r�r�ryryrzrM(scCs
t|d�S)z�
    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
    tags only in the given upper/lower case.

    Example: similar to L{makeHTMLTags}
    TrrryryrzrN;scs8|r|dd��n|���dd��D���fdd�}|S)a<
    Helper to create a validating parse action to be used with start tags created
    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
    with a required attribute value, to avoid false matches on common tags such as
    C{<TD>} or C{<DIV>}.

    Call C{withAttribute} with a series of attribute names and values. Specify the list
    of filter attributes names and values as:
     - keyword arguments, as in C{(align="right")}, or
     - as an explicit dict with C{**} operator, when an attribute name is also a Python
          reserved word, as in C{**{"class":"Customer", "align":"right"}}
     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
    For attribute names with a namespace prefix, you must use the second form.  Attribute
    names are matched insensitive to upper/lower case.
       
    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.

    To verify that the attribute exists, but without specifying a value, pass
    C{withAttribute.ANY_VALUE} as the value.

    Example::
        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    NcSsg|]\}}||f�qSryryr/ryryrzr�zsz!withAttribute.<locals>.<listcomp>csZ�D]P\}}||kr$t||d|��|tjkr|||krt||d||||f��qdS)Nzno matching attribute z+attribute '%s' has value '%s', must be '%s')r!rg�	ANY_VALUE)r�r[r�ZattrNameZ	attrValue�Zattrsryrzr�{s�zwithAttribute.<locals>.pa)r�)r�ZattrDictr�ryrrzrgDs2cCs|rd|nd}tf||i�S)a�
    Simplified version of C{L{withAttribute}} when matching on a div class - made
    difficult because C{class} is a reserved word in Python.

    Example::
        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))
        
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    z%s:class�class)rg)Z	classname�	namespaceZ	classattrryryrzrm�s �(rpcCs�t�}||||B}t|�D�]l\}}|ddd�\}}	}
}|	dkrPd|nd|}|	dkr�|dkstt|�dkr|td��|\}
}t��|�}|
tjk�r^|	d	kr�t||�t|t	|��}n�|	dk�r|dk	r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�rTt||
|||�t||
|||�}ntd
��n�|
tj
k�rB|	d	k�r�t|t��s�t|�}t|j
|�t||�}n�|	dk�r�|dk	�r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�r8t||
|||�t||
|||�}ntd
��ntd��|�rvt|ttf��rl|j|�n
|�|�||�|�|BK}|}q||K}|S)aD

    Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary or
    binary, left- or right-associative.  Parse actions can also be attached
    to operator expressions. The generated parser will also recognize the use 
    of parentheses to override operator precedences (see example below).
    
    Note: if you define a deep operator list, you may see performance issues
    when using infixNotation. See L{ParserElement.enablePackrat} for a
    mechanism to potentially improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the nested
     - opList - list of tuples, one for each operator precedence level in the
      expression grammar; each tuple is of the form
      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
       - opExpr is the pyparsing expression for the operator;
          may also be a string, which will be converted to a Literal;
          if numTerms is 3, opExpr is a tuple of two expressions, for the
          two operators separating the 3 terms
       - numTerms is the number of terms for this operator (must
          be 1, 2, or 3)
       - rightLeftAssoc is the indicator whether the operator is
          right or left associative, using the pyparsing-defined
          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
       - parseAction is the parse action to be associated with
          expressions matching this operator expression (the
          parse action tuple member may be omitted); if the parse action
          is passed a tuple or list of functions, this is equivalent to
          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})

    Example::
        # simple example of four-function arithmetic with ints and variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier 
        
        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])
        
        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)
    prints::
        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    r�Nrbrqz%s termz	%s%s termrsz@if numterms=3, opExpr must be a tuple or list of two expressionsr�z6operator must be unary (1), binary (2), or ternary (3)z2operator must indicate right or left associativity)rr�r�r�r�rV�LEFTrrr�RIGHTr}rrSr�r�r�)ZbaseExprZopListZlparZrparr�ZlastExprr�ZoperDefZopExprZarityZrightLeftAssocr�ZtermNameZopExpr1ZopExpr2ZthisExprr�ryryrzrk�sZ=
&
�



&
�

z4"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�"z string enclosed in double quotesz4'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�'z string enclosed in single quotesz*quotedString using single or double quotes�uzunicode string literalcCs�||krtd��|dk�r*t|t��r"t|t��r"t|�dkr�t|�dkr�|dk	r�tt|t||tjdd����	dd��}n$t
��t||tj��	dd��}nx|dk	r�tt|t|�t|�ttjdd����	dd��}n4ttt|�t|�ttjdd����	d	d��}ntd
��t
�}|dk	�rd|tt|�t||B|B�t|��K}n$|tt|�t||B�t|��K}|�d||f�|S)a~	
    Helper method for defining nested lists enclosed in opening and closing
    delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
     - content - expression for items within the nested lists (default=C{None})
     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})

    If an expression is not provided for the content argument, the nested
    expression will capture all whitespace-delimited content between delimiters
    as a list of separate values.

    Use the C{ignoreExpr} argument to define expressions that may contain
    opening or closing characters that should not be treated as opening
    or closing characters for nesting, such as quotedString or a comment
    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
    The default is L{quotedString}, but if no expressions are to be ignored,
    then pass C{None} for this argument.

    Example::
        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR,RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type") 
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
                      + code_body("body"))
        c_function.ignore(cStyleComment)
        
        source_code = '''
            int is_odd(int x) { 
                return (x%2); 
            }
                
            int dec_to_hex(char hchar) { 
                if (hchar >= '0' && hchar <= '9') { 
                    return (ord(hchar)-ord('0')); 
                } else { 
                    return (10+ord(hchar)-ord('A'));
                } 
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)

    prints::
        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    z.opening and closing strings cannot be the sameNr�r�cSs|d��Sr��r�rwryryrzr{gr|znestedExpr.<locals>.<lambda>cSs|d��Sr�r
rwryryrzr{jr|cSs|d��Sr�r
rwryryrzr{pr|cSs|d��Sr�r
rwryryrzr{tr|zOopening and closing arguments must be strings if no content expression is givenznested %s%s expression)r�r}r�r�rrrr&rsr�rEr�rrrr-r4r�)ZopenerZcloserZcontentr�r�ryryrzrR%sH:
���������
*$cs��fdd�}�fdd�}�fdd�}tt��d����}t�t��|��d�}t��|��d	�}t��|��d
�}	|r�tt|�|t|t|�t|��|	�}
n$tt|�t|t|�t|���}
|�	t
t��|
�d�S)a
	
    Helper method for defining space-delimited indentation blocks, such as
    those used to define block statements in Python source code.

    Parameters:
     - blockStatementExpr - expression defining syntax of statement that
            is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
            (multiple statementWithIndentedBlock expressions within a single grammar
            should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond the
            the current level; set to False for block of left-most statements
            (default=C{True})

    A valid block must contain at least one C{blockStatement}.

    Example::
        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group( funcDecl + func_body )

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << ( funcDef | assignment | identifier )

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()
    prints::
        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
    csN|t|�krdSt||�}|�dkrJ|�dkr>t||d��t||d��dS)Nrtzillegal nestingznot a peer entry)r�r;r#r!�r�r[rxZcurCol��indentStackryrz�checkPeerIndent�s
z&indentedBlock.<locals>.checkPeerIndentcs2t||�}|�dkr"��|�nt||d��dS)Nrtznot a subentry)r;rr!rrryrz�checkSubIndent�s
z%indentedBlock.<locals>.checkSubIndentcsN|t|�krdSt||�}�r6|�dkr6|�dksBt||d�����dS)Nrtr_znot an unindent)r�r;r!rrrryrz�
checkUnindent�s
z$indentedBlock.<locals>.checkUnindentz	 �INDENTr�ZUNINDENTzindented block)rrr
r
rr�r�rrrr�)ZblockStatementExprrr9rrrrErZPEERZUNDENTZsmExprryrrzrhs(N����z#[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]z[\0xa1-\0xbf\0xd7\0xf7]z_:zany tagzgt lt amp nbsp quot aposz><& "'z&(?P<entity>r�z);zcommon HTML entitycCst�|j�S)zRHelper parser action to replace common HTML entities with their special characters)�_htmlEntityMapr�Zentityrwryryrzr]�sz/\*(?:[^*]|\*(?!/))*z*/zC style commentz<!--[\s\S]*?-->zHTML commentz.*zrest of linez//(?:\\\n|[^\n])*z
// commentzC++ style commentz#.*zPython style commentrO� 	�	commaItemr�c@s�eZdZdZee�Zee�Ze	e
��d��e�Z
e	e��d��eed��Zed��d��e�Ze��e�de��e��d�Ze�d	d
��eeeed���e�B�d�Ze�e�ed
��d��e�Zed��d��e�ZeeBeB��Zed��d��e�Ze	eded��d�Zed��d�Z ed��d�Z!e!de!d�d�Z"ee!de!d�dee!de!d��d�Z#e#�$dd
��d e �d!�Z%e&e"e%Be#B�d"���d"�Z'ed#��d$�Z(e)d=d&d'��Z*e)d>d)d*��Z+ed+��d,�Z,ed-��d.�Z-ed/��d0�Z.e/��e0��BZ1e)d1d2��Z2e&e3e4d3�e5�e	e6d3d4�ee7d5�������d6�Z8e9ee:�;�e8Bd7d8���d9�Z<e)ed:d
���Z=e)ed;d
���Z>d<S)?rpa�

    Here are some common low-level expressions that may be useful in jump-starting parser development:
     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
     - common L{programming identifiers<identifier>}
     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
     - L{UUID<uuid>}
     - L{comma-separated list<comma_separated_list>}
    Parse actions:
     - C{L{convertToInteger}}
     - C{L{convertToFloat}}
     - C{L{convertToDate}}
     - C{L{convertToDatetime}}
     - C{L{stripHTMLTags}}
     - C{L{upcaseTokens}}
     - C{L{downcaseTokens}}

    Example::
        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')
    prints::
        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    �integerzhex integerr�z[+-]?\d+zsigned integerr��fractioncCs|d|dS)Nrrtryrwryryrzr{�r|zpyparsing_common.<lambda>r�z"fraction or mixed integer-fractionz
[+-]?\d+\.\d*zreal numberz+[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)z$real number with scientific notationz[+-]?\d+\.?\d*([eE][+-]?\d+)?�fnumberr��
identifierzK(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}zIPv4 addressz[0-9a-fA-F]{1,4}�hex_integerr��zfull IPv6 address)rrhz::zshort IPv6 addresscCstdd�|D��dkS)Ncss|]}tj�|�rdVqdSr3)rp�
_ipv6_partr�r�ryryrzr��sz,pyparsing_common.<lambda>.<locals>.<genexpr>r�)r�rwryryrzr{�r|z::ffff:zmixed IPv6 addresszIPv6 addressz:[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}zMAC address�%Y-%m-%dcs�fdd�}|S)a�
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})

        Example::
            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))
        prints::
            [datetime.date(1999, 12, 31)]
        c
sNzt�|d����WStk
rH}zt||t|���W5d}~XYnXdSr�)r�strptime�dater�r!r~�r�r[rxZve��fmtryrz�cvt_fn�sz.pyparsing_common.convertToDate.<locals>.cvt_fnry�r$r%ryr#rz�
convertToDate�szpyparsing_common.convertToDate�%Y-%m-%dT%H:%M:%S.%fcs�fdd�}|S)a
        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})

        Example::
            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
        prints::
            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        c
sJzt�|d��WStk
rD}zt||t|���W5d}~XYnXdSr�)rr r�r!r~r"r#ryrzr%�sz2pyparsing_common.convertToDatetime.<locals>.cvt_fnryr&ryr#rz�convertToDatetime�sz"pyparsing_common.convertToDatetimez7(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?zISO8601 datez�(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?zISO8601 datetimez2[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}�UUIDcCstj�|d�S)a
        Parse action to remove HTML tags from web page HTML source

        Example::
            # strip HTML links from normal text 
            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
            td,td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            
            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
        r)rp�_html_stripperr�)r�r[r�ryryrz�
stripHTMLTagss
zpyparsing_common.stripHTMLTagsr�rOrrr�r�zcomma separated listcCst|���Sr�r�rwryryrzr{"r|cCst|���Sr�r�rwryryrzr{%r|N)r)r()?r�r�r�r�rorvZconvertToInteger�floatZconvertToFloatr1rTr�r�rrFrr)Zsigned_integerrr�rr
Z
mixed_integerr��realZsci_realr��numberrr6r5rZipv4_addressrZ_full_ipv6_addressZ_short_ipv6_addressr�Z_mixed_ipv6_addressrZipv6_addressZmac_addressr/r'r)Ziso8601_dateZiso8601_datetime�uuidr9r8r+r,rrrrXr0�
_commasepitemrBr[r�Zcomma_separated_listrfrDryryryrzrpsV""
2
 
���__main__Zselect�fromr=r�)r��columnsr�ZtablesZcommandaK
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        z]
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        z 
        100
        FF
        z6
        12345678-1234-5678-1234-567812345678
        )rs)r�F)N)FT)T)r�)T)�r��__version__Z__versionTime__�
__author__r��weakrefrr�r�r�r�r�rjr�rFrcr�r�_threadr�ImportErrorZ	threadingZcollections.abcrrrr�Zordereddict�__all__r��version_inforbr0�maxsizer0r~r��chrr�r�r�r�r@�reversedr�r�rBr�r]r^rnZmaxintZxranger�Z__builtin__r�Zfnamerror�r�r�r�r�r�Zascii_uppercaseZascii_lowercaser6rTrFr5r�r�Z	printablerXrprr!r#r%r(r�r$�registerr;rLrIrTrWrYrSrrr&r.rrrr�rwrr
r	rnr1r)r'rr0r�rrrr,r+r3r2r"rrrrr rrr�rr4r�r�rr*rr�r/rrr
r-rrdrBr>r�rQrPrYrUrCrirjrlr�rErKrJrcrbr�Z_escapedPuncZ_escapedHexCharZ_escapedOctCharZ_singleCharZ
_charRanger�r�rarOr^r\rorfrDrrMrNrgrrmrVrr	rkrWr@r`r[rerRrhr7rYr9r8r�r�rrr=r]r:rGrr_rAr?rHrZr�r1r<rpr�ZselectTokenZ	fromTokenZidentZ
columnNameZcolumnNameListZ
columnSpecZ	tableNameZ
tableNameListZ	simpleSQLr.r/rrr0r*ryryryrz�<module>s��4�
8



@v&A= I
G3pLOD|M &#@sQ,A,	I#%0
,	?#p
��Zr

 (
 
���� 


"
	site-packages/pkg_resources/_vendor/__pycache__/appdirs.cpython-38.pyc000064400000050036151446177000022106 0ustar00U

�Qabg`�@s�dZdZd�eee��ZddlZddlZejddkZ	e	r>eZ
ej�d�r�ddlZe�
�ddZe�d�rrdZq�e�d	�r�d
Zq�dZnejZd4d
d�Zd5dd�Zd6dd�Zd7dd�Zd8dd�Zd9dd�Zd:dd�ZGdd�de�Zdd�Zd d!�Zd"d#�Zd$d%�Zedk�r�zddlZeZWnne k
�r�zdd&l!m"Z"eZWnBe k
�r�zddl#Z$eZWne k
�r�eZYnXYnXYnXe%d'k�r�d(Z&d)Z'd*Z(e)d+e�e)d,�ee&e'd-d.�Z*e(D]Z+e)d/e+e,e*e+�f��q�e)d0�ee&e'�Z*e(D]Z+e)d/e+e,e*e+�f��q�e)d1�ee&�Z*e(D]Z+e)d/e+e,e*e+�f��q0e)d2�ee&dd3�Z*e(D]Z+e)d/e+e,e*e+�f��qfdS);zyUtilities for determining application-specific dirs.

See <http://github.com/ActiveState/appdirs> for details and usage.
)����.�Nr�javaZWindows�win32ZMac�darwinZlinux2FcCs�tdkr^|dkr|}|rdpd}tj�t|��}|r�|dk	rNtj�|||�}q�tj�||�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aJReturn full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        Mac OS X:               ~/Library/Application Support/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    rN�
CSIDL_APPDATA�CSIDL_LOCAL_APPDATAFrz~/Library/Application Support/Z
XDG_DATA_HOMEz~/.local/share��system�os�path�normpath�_get_win_folder�join�
expanduser�getenv)�appname�	appauthor�version�roaming�constr�r�A/usr/lib/python3.8/site-packages/pkg_resources/_vendor/appdirs.py�
user_data_dir,s& rcstdkrR|dkr�}tj�td��}�r�|dk	rBtj�||��}q�tj�|��}n�tdkrztj�d�}�r�tj�|��}ntt�dtj�dd	g��}d
d�|�	tj�D�}�r�|r�tj��|���fdd�|D�}|r�tj�|�}n|d
}|S��r|�rtj�||�}|S)aiReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of data dirs should be
            returned. By default, the first item from XDG_DATA_DIRS is
            returned, or '/usr/local/share/<AppName>',
            if XDG_DATA_DIRS is not set

    Typical site data directories are:
        Mac OS X:   /Library/Application Support/<AppName>
        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.

    For Unix, this is using the $XDG_DATA_DIRS[0] default.

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    rN�CSIDL_COMMON_APPDATAFrz/Library/Application SupportZ
XDG_DATA_DIRSz/usr/local/sharez
/usr/sharecSs g|]}tj�|�tj���qSr�r
rr�rstrip�sep��.0�xrrr�
<listcomp>�sz!site_data_dir.<locals>.<listcomp>csg|]}tj�|�g��qSr�r
rrr �rrrr#�sr)
rr
rrrrrr�pathsep�split�rrr�	multipathrZpathlistrr%r�
site_data_dircs6�r*cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)a�Return full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user config directories are:
        Mac OS X:               same as user_data_dir
        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    �rrNZXDG_CONFIG_HOMEz	~/.config�rrr
rrrr�rrrrrrrr�user_config_dir�sr.cs�tdkr*t�|�}�r�|r�tj�||�}ndt�dd�}dd�|�tj�D�}�rt|rbtj��|���fdd�|D�}|r�tj�|�}n|d}|S)aReturn full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of config dirs should be
            returned. By default, the first item from XDG_CONFIG_DIRS is
            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set

    Typical site config directories are:
        Mac OS X:   same as site_data_dir
        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
                    $XDG_CONFIG_DIRS
        Win *:      same as site_data_dir
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)

    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    r+ZXDG_CONFIG_DIRSz/etc/xdgcSs g|]}tj�|�tj���qSrrr rrrr#�sz#site_config_dir.<locals>.<listcomp>csg|]}tj�|�g��qSrr$r r%rrr#�sr)rr*r
rrrr'r&r(rr%r�site_config_dir�s
r/TcCs�tdkrd|dkr|}tj�td��}|r�|dk	rBtj�|||�}ntj�||�}|r�tj�|d�}nNtdkr�tj�d�}|r�tj�||�}n&t�dtj�d	��}|r�tj�||�}|r�|r�tj�||�}|S)
aReturn full path to the user-specific cache dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Cache" to the base app data dir for Windows. See
            discussion below.

    Typical user cache directories are:
        Mac OS X:   ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go in
    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
    app data dir (the default returned by `user_data_dir` above). Apps typically
    put cache data somewhere *under* the given dir here. Some examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0
    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    This can be disabled with the `opinion=False` option.
    rNr
FZCacherz~/Library/CachesZXDG_CACHE_HOMEz~/.cacher�rrrZopinionrrrr�user_cache_dirs(!r1cCsXtdkrt||d|�}n&t�dtj�d��}|r>tj�||�}|rT|rTtj�||�}|S)aReturn full path to the user-specific state dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user state directories are:
        Mac OS X:  same as user_data_dir
        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
        Win *:     same as user_data_dir

    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
    to extend the XDG spec and support $XDG_STATE_HOME.

    That means, by default "~/.local/state/<AppName>".
    r+NZXDG_STATE_HOMEz~/.local/stater,r-rrr�user_state_dir9sr2cCs�tdkr tj�tj�d�|�}nNtdkrLt|||�}d}|rntj�|d�}n"t|||�}d}|rntj�|d�}|r�|r�tj�||�}|S)a�Return full path to the user-specific log dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Logs" to the base app data dir for Windows, and "log" to the
            base cache dir for Unix. See discussion below.

    Typical user log directories are:
        Mac OS X:   ~/Library/Logs/<AppName>
        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs

    On Windows the only suggestion in the MSDN docs is that local settings
    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
    examples of what some windows apps use for a logs dir.)

    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
    value for Windows and appends "log" to the user cache dir for Unix.
    This can be disabled with the `opinion=False` option.
    rz~/Library/LogsrFZLogs�log)rr
rrrrr1r0rrr�user_log_dircs" 
�r4c@sneZdZdZddd�Zedd��Zedd	��Zed
d��Zedd
��Z	edd��Z
edd��Zedd��ZdS)�AppDirsz1Convenience wrapper for getting application dirs.NFcCs"||_||_||_||_||_dS)N)rrrrr))�selfrrrrr)rrr�__init__�s
zAppDirs.__init__cCst|j|j|j|jd�S�N)rr)rrrrr�r6rrrr�s
�zAppDirs.user_data_dircCst|j|j|j|jd�S�N)rr))r*rrrr)r9rrrr*�s
�zAppDirs.site_data_dircCst|j|j|j|jd�Sr8)r.rrrrr9rrrr.�s
�zAppDirs.user_config_dircCst|j|j|j|jd�Sr:)r/rrrr)r9rrrr/�s
�zAppDirs.site_config_dircCst|j|j|jd�S�N�r)r1rrrr9rrrr1�s
�zAppDirs.user_cache_dircCst|j|j|jd�Sr;)r2rrrr9rrrr2�s
�zAppDirs.user_state_dircCst|j|j|jd�Sr;)r4rrrr9rrrr4�s
�zAppDirs.user_log_dir)NNNFF)
�__name__�
__module__�__qualname__�__doc__r7�propertyrr*r.r/r1r2r4rrrrr5�s&�






r5cCsHtrddl}nddl}dddd�|}|�|jd�}|�||�\}}|S)z�This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    rNZAppDatazCommon AppDataz
Local AppData�r	rr
z@Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders)�PY3�winreg�_winreg�OpenKey�HKEY_CURRENT_USERZQueryValueEx)�
csidl_namerEZshell_folder_name�key�dir�typerrr�_get_win_folder_from_registry�s
���rLcCs�ddlm}m}|�dt||�dd�}z^t|�}d}|D]}t|�dkr8d}qRq8|r�zddl}|�|�}Wnt	k
r�YnXWnt
k
r�YnX|S)Nr)�shellcon�shellF�T)�win32com.shellrMrN�SHGetFolderPath�getattr�unicode�ord�win32api�GetShortPathName�ImportError�UnicodeError)rHrMrNrJ�
has_high_char�crUrrr�_get_win_folder_with_pywin32�s$
r[cCs�ddl}dddd�|}|�d�}|jj�d|dd|�d}|D]}t|�dkr@d	}qZq@|r�|�d�}|jj�|j|d�r�|}|jS)
Nr��#�rBiFrOT)	�ctypesZcreate_unicode_buffer�windllZshell32ZSHGetFolderPathWrTZkernel32ZGetShortPathNameW�value)rHr_Zcsidl_const�bufrYrZZbuf2rrr�_get_win_folder_with_ctypes�s&��

rccCs�ddl}ddlm}ddlm}|jjd}|�d|�}|jj	}|�
dt|j|�d|jj
|�|j�|����d�}d}|D]}	t|	�dkr|d	}q�q||r�|�d|�}|jj	}
|
�|||�r�|j�|����d�}|S)
Nr)�jna)r�rZ�FrOT)�arrayZcom.sunrdZcom.sun.jna.platformrZWinDefZMAX_PATHZzerosZShell32ZINSTANCErQrRZShlObjZSHGFP_TYPE_CURRENTZNativeZtoStringZtostringrrTZKernel32rV)rHrgrdrZbuf_sizerbrNrJrYrZZkernelrrr�_get_win_folder_with_jnas&rh)r`�__main__ZMyAppZ	MyCompany)rr.r1r2r4r*r/z-- app dirs %s --z%-- app dirs (with optional 'version')z1.0r<z%s: %sz)
-- app dirs (without optional 'version')z+
-- app dirs (without optional 'appauthor')z(
-- app dirs (with disabled 'appauthor'))r)NNNF)NNNF)NNNF)NNNF)NNNT)NNNF)NNNT)-r@Z__version_info__r�map�str�__version__�sysr
�version_inforCrS�platform�
startswithZjava_verZos_namerrr*r.r/r1r2r4�objectr5rLr[rcrhrPZwin32comrrWr_r`Zcom.sun.jnaZcomr=rrZprops�print�dirsZproprRrrrr�<module>s~



7
B
(
3
9
*
30


site-packages/pkg_resources/_vendor/__pycache__/six.cpython-38.opt-1.pyc000064400000057556151446177000022224 0ustar00U

�Qab�u�A@sRdZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d(d#d3d2�e)d4d(e
�rd5nd6d7�e)d8d(d9�e)d:d;d<d=�e)d d d�e)d>d>d?�e)d@d@d?�e)dAdAd?�e)d3d(d#d3d2�e)dBd"d#dCdB�e)dDd"d"dEdD�e&d#d(�e&dFdG�e&dHdI�e&dJdKdL�e&dMdNdM�e&dOdPdQ�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdjdk�e&dldldk�e&dmdmdk�e&dndndo�e&dpdq�e&drds�e&dtdu�e&dvdwdv�e&dxdy�e&dzd{d|�e&d}d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g>Z.ejd�k�rRe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rVe,�3e/d�e/j1��qV[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d=d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dҡGd�dԄd�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q[/e8e7_.e,�3e7e+d��d�dۡGd�d݄d�e(�Z9e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃g!Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d��d�d�G�d�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�d	d��d�gZ<e<D]Z/e0e;e/j1e/��q8[/e<e;_.e,�3e;e+�d
��d�d�G�d
�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d�d�Z@�d�d�ZAe�	rH�dZB�dZC�dZD�dZE�dZF�dZGn$�d ZB�d!ZC�d"ZD�d#ZE�d$ZF�d%ZGzeHZIWn"eJk
�	r��d&�d'�ZIYnXeIZHzeKZKWn"eJk
�	r��d(�d)�ZKYnXe�	r�d*�d+�ZLejMZN�d,�d-�ZOeZPn>�d.�d+�ZL�d/�d0�ZN�d1�d-�ZOG�d2�d3��d3e�ZPeKZKe#eL�d4�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�
rԐd5�d6�ZX�d7�d8�ZY�d9�d:�ZZ�d;�d<�Z[e�\�d=�Z]e�\�d>�Z^e�\�d?�Z_nT�d@�d6�ZX�dA�d8�ZY�dB�d:�ZZ�dC�d<�Z[e�\�dD�Z]e�\�dE�Z^e�\�dF�Z_e#eX�dG�e#eY�dH�e#eZ�dI�e#e[�dJ�e�r�dK�dL�Z`�dM�dN�ZaebZcddldZded�e�dO�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp�dPZqej
�dQ�dQk�r�dRZr�dSZsn�dTZr�dUZsnj�dV�dL�Z`�dW�dN�ZaecZcebZg�dX�dY�Zi�dZ�d[�Zke�tejuev�ZmddloZoeojoZoZp�d\Zq�dRZr�dSZse#e`�d]�e#ea�d^��d_�dP�Zw�d`�dT�Zx�da�dU�Zye�r�eze4j{�db�Z|�d|�dc�dd�Z}n�d}�de�df�Z|e|�dg�ej
dd��dhk�r�e|�di�n.ej
dd��dhk�
re|�dj�n�dk�dl�Z~eze4j{�dmd�Zedk�
rL�dn�do�Zej
dd��dpk�
rreZ��dq�do�Ze#e}�dr�ej
dd�dk�
r�ej�ej�f�ds�dt�Z�nej�Z��du�dv�Z��dw�dx�Z��dy�dz�Z�gZ�e+Z�e�����d{�dk	�
r�ge�_�ej��rBe�ej��D]4\Z�Z�ee��j+dk�re�j1e+k�rej�e�=�q>�q[�[�ej���e,�dS(~z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.10.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�=/usr/lib/python3.8/site-packages/pkg_resources/_vendor/six.py�__len__>sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Xsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__[sz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrriszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrrszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__us
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'gs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr~sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__�sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4|sr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdb�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZemail_mime_basezemail.MIMEBasezemail.mime.baseZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrrt@srtZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrurrrrrwhsrwZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrurrrrry|sryZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrurrrrr{�sr{Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrurrrrr}�sr}ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacervrxrzr|r~cCsdddddgS)N�parse�error�request�responserprr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rpr8rrrrr�s




rzmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_move�sr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rs�__dict__rFrrrr�remove_move�sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iteratorsr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callablesr�cCs|Srr�Zunboundrrr�get_unbound_functionsr�cCs|Srr�r�clsrrr�create_unbound_methodsr�cCs|jSr)r�r�rrrr�"scCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_method%sr�cCst�|d|�Sr)r�r�r�rrrr�(sc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�-sz
Iterator.nextN)r
rrr�rrrrr�+sr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeys>sr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesAsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsDsr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistsGsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�PscKs|jf|�Sr)r�r�rrrr�SscKs|jf|�Sr)r�r�rrrr�VscKs|jf|�Sr)r�r�rrrr�Ys�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�bksr�cCs|Srrr�rrr�unsr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs*|dkr|�}|j|k	r"|�|��|�dSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s


r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�z9def reraise(tp, value, tb=None):
    raise tp, value, tb
)rrzrdef raise_from(value, from_value):
    if from_value is None:
        raise value
    raise value from from_value
zCdef raise_from(value, from_value):
    raise value from from_value
cCs|�dSrr)r1Z
from_valuerrr�
raise_from�sr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr��s

��zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_�sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�s

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rc�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapperszwraps.<locals>.wrapperr)r�r�r�r�rr�rr�sr�cs&G��fdd�d��}t�|ddi�S)z%Create a base class with a metaclass.cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�rZ
this_basesr���bases�metarr�__new__'sz)with_metaclass.<locals>.metaclass.__new__N)r
rrr�rr�rr�	metaclass%sr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclass sr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.csh|j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd��|j|j|�S)N�	__slots__r��__weakref__)r��copyr�rIr�r�r
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr�.s


zadd_metaclass.<locals>.wrapperr)r�r�rr�r�
add_metaclass,sr�cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nzutf-8)�__unicode__r�r	rrr�<lambda>J�z-python_2_unicode_compatible.<locals>.<lambda>)�PY2r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible<s
�
r�__spec__)N)NN)�rZ
__future__rrcrU�operatorrr��
__author__�__version__�version_inforr)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesZ	text_type�bytesZbinary_type�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArsrtZ_urllib_parse_moved_attributesrwZ_urllib_error_moved_attributesryZ _urllib_request_moved_attributesr{Z!_urllib_response_moved_attributesr}Z$_urllib_robotparser_moved_attributesrr�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�r�rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>s�

>





























��


�


�D�






















��


��
































�#�����
��





��



5��
site-packages/pkg_resources/_vendor/__pycache__/pyparsing.cpython-38.pyc000064400000611642151446177000022466 0ustar00U

�Qabw��i@s�dZdZdZdZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZzddlmZWn ek
r�ddlmZYnXzdd	lmZdd
lmZWn,ek
r�dd	l
mZdd
l
mZYnXzddl
mZWnBek
�rFzddlmZWnek
�r@dZYnXYnXdd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtgiZee	j�ddu�ZeddukZ e �rpe	j!Z"e#Z$e%Z&e#Z'e(e)e*e+e,ee-e.e/e0e1gZ2n`e	j3Z"e4Z5dvdw�Z'gZ2ddl6Z6dx�7�D]8Z8ze2�9e:e6e8��Wne;k
�r�Y�q�YnX�q�e<dydz�e5d{�D��Z=d|d}�Z>Gd~d�de?�Z@ejAejBZCd�ZDeDd�ZEeCeDZFe%d��ZGd��Hd�dz�ejID��ZJGd�d#�d#eK�ZLGd�d%�d%eL�ZMGd�d'�d'eL�ZNGd�d)�d)eN�ZOGd�d,�d,eK�ZPGd�d��d�e?�ZQGd�d(�d(e?�ZRe�SeR�d�d?�ZTd�dP�ZUd�dM�ZVd�d��ZWd�d��ZXd�d��ZYd�dW�ZZ�d/d�d��Z[Gd�d*�d*e?�Z\Gd�d2�d2e\�Z]Gd�d�de]�Z^Gd�d�de]�Z_Gd�d�de]�Z`e`Zae`e\_bGd�d�de]�ZcGd�d�de`�ZdGd�d
�d
ec�ZeGd�dr�dre]�ZfGd�d5�d5e]�ZgGd�d-�d-e]�ZhGd�d+�d+e]�ZiGd�d�de]�ZjGd�d4�d4e]�ZkGd�d��d�e]�ZlGd�d�del�ZmGd�d�del�ZnGd�d�del�ZoGd�d0�d0el�ZpGd�d/�d/el�ZqGd�d7�d7el�ZrGd�d6�d6el�ZsGd�d&�d&e\�ZtGd�d�det�ZuGd�d"�d"et�ZvGd�d�det�ZwGd�d�det�ZxGd�d$�d$e\�ZyGd�d�dey�ZzGd�d�dey�Z{Gd�d��d�ey�Z|Gd�d�de|�Z}Gd�d8�d8e|�Z~Gd�d��d�e?�Ze�Z�Gd�d!�d!ey�Z�Gd�d.�d.ey�Z�Gd�d�dey�Z�Gd�dÄd�e��Z�Gd�d3�d3ey�Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d1�d1e��Z�Gd�d �d e?�Z�d�dh�Z��d0d�dF�Z��d1d�dB�Z�d�dЄZ�d�dU�Z�d�dT�Z�d�dԄZ��d2d�dY�Z�d�dG�Z��d3d�dm�Z�d�dn�Z�d�dp�Z�e^���dI�Z�en���dO�Z�eo���dN�Z�ep���dg�Z�eq���df�Z�egeGd�d�d܍��d�dބ�Z�ehd߃��d�dބ�Z�ehd���d�dބ�Z�e�e�Be�Bejd�d{d܍BZ�e�e�e�d�e��Z�e`d�e�d���d�e�e}e�e�B����d�d�Z�d�de�Z�d�dS�Z�d�db�Z�d�d`�Z�d�ds�Z�e�d�dބ�Z�e�d�dބ�Z�d�d�Z�d�dQ�Z�d�dR�Z�d�dk�Z�e?�e�_��d4d�dq�Z�e@�Z�e?�e�_�e?�e�_�e�d��e�d��fd�do�Z�e�Z�e�ehd��d����d��Z�e�ehd��d����d��Z�e�ehd��d�ehd��d�B����d�Z�e�ea�d�e�������d�Z�d�d�de���f�ddV�Z��d5�ddl�Z�e��d�Z�e��d�Z�e�egeCeF�d����d��\Z�Z�e�ed	�7��d
��Z�eh�d�d�Heàġ��d
����d�ZŐdda�Z�e�eh�d��d����d�Z�eh�d����d�Z�eh�d��ɡ���d�Z�eh�d����d�Z�e�eh�d��de�B����d�Z�e�Z�eh�d����d�Z�e�e}egeJdːd�e�eg�d�e`d˃eo�����ϡ���d�Z�e�e�e���e�Bd��d����d@�Z�G�d dt�dt�Z�eӐd!k�r�ed�d"�Z�ed�d#�Z�egeCeF�d$�Z�e�e֐d%dՐd&���e��Z�e�e�e׃����d'�Zؐd(e�BZ�e�e֐d%dՐd&���e��Z�e�e�eڃ����d)�Z�eԐd*�eِd'�e�eېd)�Z�eܠݐd+�e�jޠݐd,�e�jߠݐd,�e�j�ݐd-�ddl�Z�e�j᠝e�e�j��e�j�ݐd.�dS(6a�	
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and executing simple grammars,
vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
provides a library of classes that you use to construct the grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form 
C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
L{Literal} expressions)::

    from pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the self-explanatory
class names, and the use of '+', '|' and '^' operators.

The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
object with named attributes.

The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
 - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
 - quoted strings
 - embedded comments


Getting Started -
-----------------
Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:
 - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
 - construct character word-group expressions using the L{Word} class
 - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
 - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
 - associate names with your parsed results using L{ParserElement.setResultsName}
 - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
 - find more useful common expressions in the L{pyparsing_common} namespace class
z2.2.1z18 Sep 2018 00:49 UTCz*Paul McGuire <ptmcg@users.sourceforge.net>�N)�ref)�datetime)�RLock)�Iterable)�MutableMapping)�OrderedDict�And�CaselessKeyword�CaselessLiteral�
CharsNotIn�Combine�Dict�Each�Empty�
FollowedBy�Forward�
GoToColumn�Group�Keyword�LineEnd�	LineStart�Literal�
MatchFirst�NoMatch�NotAny�	OneOrMore�OnlyOnce�Optional�Or�ParseBaseException�ParseElementEnhance�ParseException�ParseExpression�ParseFatalException�ParseResults�ParseSyntaxException�
ParserElement�QuotedString�RecursiveGrammarException�Regex�SkipTo�	StringEnd�StringStart�Suppress�Token�TokenConverter�White�Word�WordEnd�	WordStart�
ZeroOrMore�	alphanums�alphas�
alphas8bit�anyCloseTag�
anyOpenTag�
cStyleComment�col�commaSeparatedList�commonHTMLEntity�countedArray�cppStyleComment�dblQuotedString�dblSlashComment�
delimitedList�dictOf�downcaseTokens�empty�hexnums�htmlComment�javaStyleComment�line�lineEnd�	lineStart�lineno�makeHTMLTags�makeXMLTags�matchOnlyAtCol�matchPreviousExpr�matchPreviousLiteral�
nestedExpr�nullDebugAction�nums�oneOf�opAssoc�operatorPrecedence�
printables�punc8bit�pythonStyleComment�quotedString�removeQuotes�replaceHTMLEntity�replaceWith�
restOfLine�sglQuotedString�srange�	stringEnd�stringStart�traceParseAction�
unicodeString�upcaseTokens�
withAttribute�
indentedBlock�originalTextFor�ungroup�
infixNotation�locatedExpr�	withClass�
CloseMatch�tokenMap�pyparsing_common�cCsft|t�r|Sz
t|�WStk
r`t|��t��d�}td�}|�dd��|�	|�YSXdS)aDrop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
           then < returns the unicode object | encodes it with the default encoding | ... >.
        �xmlcharrefreplacez&#\d+;cSs$dtt|ddd���dd�S)Nz\ur����)�hex�int��t�ry�C/usr/lib/python3.8/site-packages/pkg_resources/_vendor/pyparsing.py�<lambda>��z_ustr.<locals>.<lambda>N)
�
isinstanceZunicode�str�UnicodeEncodeError�encode�sys�getdefaultencodingr)�setParseAction�transformString)�obj�retZ
xmlcharrefryryrz�_ustr�s

r�z6sum len sorted reversed list tuple set any all min maxccs|]
}|VqdS�Nry)�.0�yryryrz�	<genexpr>�sr��cCs:d}dd�d��D�}t||�D]\}}|�||�}q |S)z/Escape &, <, >, ", ', etc. in a string of data.z&><"'css|]}d|dVqdS)�&�;Nry)r��sryryrzr��sz_xml_escape.<locals>.<genexpr>zamp gt lt quot apos)�split�zip�replace)�dataZfrom_symbolsZ
to_symbolsZfrom_Zto_ryryrz�_xml_escape�s
r�c@seZdZdS)�
_ConstantsN)�__name__�
__module__�__qualname__ryryryrzr��sr��
0123456789ZABCDEFabcdef�\�ccs|]}|tjkr|VqdSr�)�stringZ
whitespace�r��cryryrzr��s
c@sPeZdZdZddd�Zedd��Zdd	�Zd
d�Zdd
�Z	ddd�Z
dd�ZdS)rz7base exception class for all parsing runtime exceptionsrNcCs>||_|dkr||_d|_n||_||_||_|||f|_dS�Nr�)�loc�msg�pstr�
parserElement�args)�selfr�r�r��elemryryrz�__init__�szParseBaseException.__init__cCs||j|j|j|j�S)z�
        internal factory method to simplify creating one type of ParseException 
        from another - avoids having __init__ signature conflicts among subclasses
        )r�r�r�r�)�cls�peryryrz�_from_exception�sz"ParseBaseException._from_exceptioncCsN|dkrt|j|j�S|dkr,t|j|j�S|dkrBt|j|j�St|��dS)z�supported attributes by name are:
            - lineno - returns the line number of the exception text
            - col - returns the column number of the exception text
            - line - returns the line containing the exception text
        rL)r;�columnrIN)rLr�r�r;rI�AttributeError)r�Zanameryryrz�__getattr__�szParseBaseException.__getattr__cCsd|j|j|j|jfS)Nz"%s (at char %d), (line:%d, col:%d))r�r�rLr��r�ryryrz�__str__�s�zParseBaseException.__str__cCst|�Sr��r�r�ryryrz�__repr__�szParseBaseException.__repr__�>!<cCs<|j}|jd}|r4d�|d|�|||d�f�}|��S)z�Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        r�r�N)rIr��join�strip)r�ZmarkerStringZline_strZline_columnryryrz�
markInputline�s

�z ParseBaseException.markInputlinecCsd��tt|��S)Nzlineno col line)r��dir�typer�ryryrz�__dir__szParseBaseException.__dir__)rNN)r�)r�r�r��__doc__r��classmethodr�r�r�r�r�r�ryryryrzr�s



c@seZdZdZdS)r!aN
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
     - lineno - returns the line number of the exception text
     - col - returns the column number of the exception text
     - line - returns the line containing the exception text
        
    Example::
        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))
            
    prints::
       Expected integer (at char 0), (line:1, col:1)
        column: 1
    N�r�r�r�r�ryryryrzr!sc@seZdZdZdS)r#znuser-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediatelyNr�ryryryrzr#sc@seZdZdZdS)r%z�just like L{ParseFatalException}, but thrown internally when an
       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
       immediately because an unbacktrackable syntax error has been foundNr�ryryryrzr%sc@s eZdZdZdd�Zdd�ZdS)r(zZexception thrown by L{ParserElement.validate} if the grammar could be improperly recursivecCs
||_dSr��ZparseElementTrace�r��parseElementListryryrzr�4sz"RecursiveGrammarException.__init__cCs
d|jS)NzRecursiveGrammarException: %sr�r�ryryrzr�7sz!RecursiveGrammarException.__str__N)r�r�r�r�r�r�ryryryrzr(2sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�_ParseResultsWithOffsetcCs||f|_dSr���tup)r�Zp1Zp2ryryrzr�;sz _ParseResultsWithOffset.__init__cCs
|j|Sr�r��r��iryryrz�__getitem__=sz#_ParseResultsWithOffset.__getitem__cCst|jd�S�Nr)�reprr�r�ryryrzr�?sz _ParseResultsWithOffset.__repr__cCs|jd|f|_dSr�r�r�ryryrz�	setOffsetAsz!_ParseResultsWithOffset.setOffsetN)r�r�r�r�r�r�r�ryryryrzr�:sr�c@s�eZdZdZd[dd�Zddddefdd�Zdd	�Zefd
d�Zdd
�Z	dd�Z
dd�Zdd�ZeZ
dd�Zdd�Zdd�Zdd�Zdd�Zer�eZeZeZn$eZeZeZdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd\d(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Z d2d3�Z!d4d5�Z"d6d7�Z#d8d9�Z$d:d;�Z%d<d=�Z&d]d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*d^dHdI�Z+dJdK�Z,dLdM�Z-d_dOdP�Z.dQdR�Z/dSdT�Z0dUdV�Z1dWdX�Z2dYdZ�Z3dS)`r$aI
    Structured parse results, to provide multiple means of access to the parsed data:
       - as a list (C{len(results)})
       - by list index (C{results[0], results[1]}, etc.)
       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})

    Example::
        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)
    prints::
        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    NTcCs"t||�r|St�|�}d|_|S�NT)r}�object�__new__�_ParseResults__doinit)r��toklist�name�asList�modalZretobjryryrzr�ks


zParseResults.__new__c
Csb|jrvd|_d|_d|_i|_||_||_|dkr6g}||t�rP|dd�|_n||t�rft|�|_n|g|_t	�|_
|dk	�r^|�r^|s�d|j|<||t�r�t|�}||_||t
d�ttf�r�|ddgfk�s^||t�r�|g}|�r(||t��rt|��d�||<ntt|d�d�||<|||_n6z|d||<Wn$tttfk
�r\|||<YnXdS)NFrr�)r��_ParseResults__name�_ParseResults__parent�_ParseResults__accumNames�_ParseResults__asList�_ParseResults__modal�list�_ParseResults__toklist�_generatorType�dict�_ParseResults__tokdictrvr�r��
basestringr$r��copy�KeyError�	TypeError�
IndexError)r�r�r�r�r�r}ryryrzr�tsB



$
zParseResults.__init__cCsPt|ttf�r|j|S||jkr4|j|ddStdd�|j|D��SdS)NrtrcSsg|]}|d�qS�rry�r��vryryrz�
<listcomp>�sz,ParseResults.__getitem__.<locals>.<listcomp>)r}rv�slicer�r�r�r$r�ryryrzr��s


zParseResults.__getitem__cCs�||t�r0|j�|t��|g|j|<|d}nD||ttf�rN||j|<|}n&|j�|t��t|d�g|j|<|}||t�r�t|�|_	dSr�)
r�r��getr�rvr�r�r$�wkrefr�)r��kr�r}�subryryrz�__setitem__�s


"
zParseResults.__setitem__c
Cs�t|ttf�r�t|j�}|j|=t|t�rH|dkr:||7}t||d�}tt|�|���}|��|j	�
�D]>\}}|D]0}t|�D]"\}\}}	t||	|	|k�||<q�qxqln|j	|=dS�Nrr�)
r}rvr��lenr�r��range�indices�reverser��items�	enumerater�)
r�r�ZmylenZremovedr��occurrences�jr��value�positionryryrz�__delitem__�s

zParseResults.__delitem__cCs
||jkSr�)r�)r�r�ryryrz�__contains__�szParseResults.__contains__cCs
t|j�Sr�)r�r�r�ryryrz�__len__�r|zParseResults.__len__cCs
|jSr��r�r�ryryrz�__bool__�r|zParseResults.__bool__cCs
t|j�Sr���iterr�r�ryryrz�__iter__�r|zParseResults.__iter__cCst|jddd��S�Nrtr�r�ryryrz�__reversed__�r|zParseResults.__reversed__cCs$t|jd�r|j��St|j�SdS)N�iterkeys)�hasattrr�r�r�r�ryryrz�	_iterkeys�s
zParseResults._iterkeyscs�fdd����D�S)Nc3s|]}�|VqdSr�ry�r�r�r�ryrzr��sz+ParseResults._itervalues.<locals>.<genexpr>�rr�ryr�rz�_itervalues�szParseResults._itervaluescs�fdd����D�S)Nc3s|]}|�|fVqdSr�ryrr�ryrzr��sz*ParseResults._iteritems.<locals>.<genexpr>rr�ryr�rz�
_iteritems�szParseResults._iteritemscCst|���S)zVReturns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x).)r�r�r�ryryrz�keys�szParseResults.keyscCst|���S)zXReturns all named result values (as a list in Python 2.x, as an iterator in Python 3.x).)r��
itervaluesr�ryryrz�values�szParseResults.valuescCst|���S)zfReturns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x).)r��	iteritemsr�ryryrzr��szParseResults.itemscCs
t|j�S)z�Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names.)�boolr�r�ryryrz�haskeys�szParseResults.haskeyscOs�|s
dg}|��D]*\}}|dkr0|d|f}qtd|��qt|dt�sdt|�dksd|d|kr~|d}||}||=|S|d}|SdS)a�
        Removes and returns item at specified index (default=C{last}).
        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
        argument or an integer argument, it will use C{list} semantics
        and pop tokens from the list of parsed tokens. If passed a 
        non-integer argument (most likely a string), it will use C{dict}
        semantics and pop the corresponding value from any defined 
        results names. A second default return value argument is 
        supported, just as in C{dict.pop()}.

        Example::
            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())
        prints::
            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        rt�defaultrz-pop() got an unexpected keyword argument '%s'r�N)r�r�r}rvr�)r�r��kwargsr�r��indexr�Zdefaultvalueryryrz�pop�s""
�
�zParseResults.popcCs||kr||S|SdS)ai
        Returns named result matching the given key, or if there is no
        such name, then returns the given C{defaultValue} or C{None} if no
        C{defaultValue} is specified.

        Similar to C{dict.get()}.
        
        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        Nry)r��key�defaultValueryryrzr�3szParseResults.getcCsR|j�||�|j��D]4\}}t|�D]"\}\}}t||||k�||<q(qdS)a
        Inserts new element at location index in the list of parsed tokens.
        
        Similar to C{list.insert()}.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        N)r��insertr�r�r�r�)r�r
ZinsStrr�r�r�r�r�ryryrzrIszParseResults.insertcCs|j�|�dS)a�
        Add single element to end of ParseResults list of elements.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            
            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        N)r��append)r��itemryryrzr]szParseResults.appendcCs$t|t�r||7}n|j�|�dS)a
        Add sequence of elements to end of ParseResults list of elements.

        Example::
            patt = OneOrMore(Word(alphas))
            
            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        N)r}r$r��extend)r�Zitemseqryryrzrks

zParseResults.extendcCs|jdd�=|j��dS)z7
        Clear all elements and results names.
        N)r�r��clearr�ryryrzr}szParseResults.clearcCsjz
||WStk
r YdSX||jkrb||jkrH|j|ddStdd�|j|D��SndSdS)Nr�rtrcSsg|]}|d�qSr�ryr�ryryrzr��sz,ParseResults.__getattr__.<locals>.<listcomp>)r�r�r�r$�r�r�ryryrzr��s


zParseResults.__getattr__cCs|��}||7}|Sr��r�)r��otherr�ryryrz�__add__�szParseResults.__add__cs�|jrjt|j���fdd��|j��}�fdd�|D�}|D],\}}|||<t|dt�r<t|�|d_q<|j|j7_|j�	|j�|S)Ncs|dkr�S|�Sr�ry)�a)�offsetryrzr{�r|z'ParseResults.__iadd__.<locals>.<lambda>c	s4g|],\}}|D]}|t|d�|d��f�qqS�rr�)r��r�r��vlistr�)�	addoffsetryrzr��s�z)ParseResults.__iadd__.<locals>.<listcomp>r)
r�r�r�r�r}r$r�r�r��update)r�rZ
otheritemsZotherdictitemsr�r�ry)rrrz�__iadd__�s


�zParseResults.__iadd__cCs&t|t�r|dkr|��S||SdSr�)r}rvr��r�rryryrz�__radd__�szParseResults.__radd__cCsdt|j�t|j�fS)Nz(%s, %s))r�r�r�r�ryryrzr��szParseResults.__repr__cCsdd�dd�|jD��dS)N�[�, css(|] }t|t�rt|�nt|�VqdSr�)r}r$r�r��r�r�ryryrzr��sz'ParseResults.__str__.<locals>.<genexpr>�])r�r�r�ryryrzr��szParseResults.__str__r�cCsLg}|jD]<}|r |r |�|�t|t�r8||��7}q
|�t|��q
|Sr�)r�rr}r$�
_asStringListr�)r��sep�outrryryrzr(�s


zParseResults._asStringListcCsdd�|jD�S)a�
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::
            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
            
            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        cSs"g|]}t|t�r|��n|�qSry)r}r$r�)r��resryryrzr��sz'ParseResults.asList.<locals>.<listcomp>r�r�ryryrzr��szParseResults.asListcs6tr|j}n|j}�fdd��t�fdd�|�D��S)a�
        Returns the named parse results as a nested dictionary.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
            
            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        cs6t|t�r.|��r|��S�fdd�|D�Sn|SdS)Ncsg|]}�|��qSryryr���toItemryrzr��sz7ParseResults.asDict.<locals>.toItem.<locals>.<listcomp>)r}r$r
�asDict)r�r,ryrzr-�s

z#ParseResults.asDict.<locals>.toItemc3s|]\}}|�|�fVqdSr�ry�r�r�r�r,ryrzr��sz&ParseResults.asDict.<locals>.<genexpr>)�PY_3r�rr�)r�Zitem_fnryr,rzr.�s
	zParseResults.asDictcCs8t|j�}|j��|_|j|_|j�|j�|j|_|S)zA
        Returns a new copy of a C{ParseResults} object.
        )r$r�r�r�r�r�r r��r�r�ryryrzr��s
zParseResults.copyFcCsLd}g}tdd�|j��D��}|d}|s8d}d}d}d}	|dk	rJ|}	n|jrV|j}	|	sf|rbdSd}	|||d|	d	g7}t|j�D]�\}
}t|t�r�|
|kr�||�||
|o�|dk||�g7}n||�d|o�|dk||�g7}q�d}|
|kr�||
}|�s|�rq�nd}t	t
|��}
|||d|d	|
d
|d	g	7}q�|||d
|	d	g7}d�|�S)z�
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        �
css(|] \}}|D]}|d|fVqqdS�r�Nryrryryrzr�s�z%ParseResults.asXML.<locals>.<genexpr>�  r�NZITEM�<�>�</)r�r�r�r�r�r�r}r$�asXMLr�r�r�)r�ZdoctagZnamedItemsOnly�indentZ	formatted�nlr*Z
namedItemsZnextLevelIndentZselfTagr�r+ZresTagZxmlBodyTextryryrzr8�s^

�

�
�zParseResults.asXMLcCs:|j��D]*\}}|D]\}}||kr|Sqq
dSr�)r�r�)r�r�r�rr�r�ryryrzZ__lookup;s
zParseResults.__lookupcCs�|jr|jS|jr.|��}|r(|�|�SdSnNt|�dkrxt|j�dkrxtt|j����dddkrxtt|j����SdSdS)a(
        Returns the results name for this token expression. Useful when several 
        different expressions might match at a particular location.

        Example::
            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number") 
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)
            
            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])
        prints::
            age : 22
            ssn : 111-22-3333
            house_number : 221B
        Nr�r)rrt)	r�r��_ParseResults__lookupr�r��nextr�rr)r��parryryrz�getNameBs
��zParseResults.getNamercCsZg}d}|�|t|����|�rP|��r�tdd�|��D��}|D]r\}}|r\|�|�|�d|d||f�t|t�r�|r�|�|�||d��q�|�t|��qF|�t	|��qFn�t
dd�|D���rP|}t|�D]r\}	}
t|
t��r$|�d|d||	|d|d|
�||d�f�q�|�d|d||	|d|dt|
�f�q�d	�|�S)
aH
        Diagnostic method for listing out the contents of a C{ParseResults}.
        Accepts an optional C{indent} argument so that this string can be embedded
        in a nested display of other data.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(result.dump())
        prints::
            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        r2css|]\}}t|�|fVqdSr�)r~r/ryryrzr�~sz$ParseResults.dump.<locals>.<genexpr>z
%s%s- %s: r4r�css|]}t|t�VqdSr�)r}r$)r��vvryryrzr��sz
%s%s[%d]:
%s%s%sr�)
rr�r�r
�sortedr�r}r$�dumpr��anyr�r�)r�r9�depth�fullr*�NLr�r�r�r�r?ryryrzrAgs,

4,zParseResults.dumpcOstj|��f|�|�dS)a�
        Pretty-printer for parsed results as a list, using the C{pprint} module.
        Accepts additional positional or keyword args as defined for the 
        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})

        Example::
            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)
        prints::
            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        N)�pprintr��r�r�rryryrzrF�szParseResults.pprintcCs.|j|j��|jdk	r|��p d|j|jffSr�)r�r�r�r�r�r�r�ryryrz�__getstate__�s��zParseResults.__getstate__cCsN|d|_|d\|_}}|_i|_|j�|�|dk	rDt|�|_nd|_dSr�)r�r�r�r�r r�r�)r��stater=ZinAccumNamesryryrz�__setstate__�s
�zParseResults.__setstate__cCs|j|j|j|jfSr�)r�r�r�r�r�ryryrz�__getnewargs__�szParseResults.__getnewargs__cCstt|��t|���Sr�)r�r�r�rr�ryryrzr��szParseResults.__dir__)NNTT)N)r�)NFr�T)r�rT)4r�r�r�r�r�r}r�r�r�r�r�r�r��__nonzero__r�r�rrrr0rrr�r�rrr
rr�rrrrr�rr!r#r�r�r(r�r.r�r8r;r>rArFrHrJrKr�ryryryrzr$Dsh&
	'	
4

#
=%
-
cCsF|}d|krt|�kr4nn||ddkr4dS||�dd|�S)aReturns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   rr�r2)r��rfind)r��strgr�ryryrzr;�s
cCs|�dd|�dS)aReturns current line number within a string, counting newlines as line separators.
   The first line is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   r2rr�)�count)r�rNryryrzrL�s
cCsF|�dd|�}|�d|�}|dkr2||d|�S||dd�SdS)zfReturns the line of text containing loc within a string, counting newlines as line separators.
       r2rr�N)rM�find)r�rNZlastCRZnextCRryryrzrI�s
cCs8tdt|�dt|�dt||�t||�f�dS)NzMatch z at loc z(%d,%d))�printr�rLr;)�instringr��exprryryrz�_defaultStartDebugAction�srTcCs$tdt|�dt|����dS)NzMatched z -> )rQr�r~r�)rR�startlocZendlocrS�toksryryrz�_defaultSuccessDebugAction�srWcCstdt|��dS)NzException raised:)rQr�)rRr�rS�excryryrz�_defaultExceptionDebugAction�srYcGsdS)zG'Do-nothing' debug action, to suppress debugging output during parsing.Nry)r�ryryrzrS�srscs��tkr�fdd�Sdg�dg�tdd�dkrFddd�}dd	d
��ntj}tj�d}|dd�d
}|d|d|f�������fdd�}d}zt�dt�d�j�}Wntk
r�t��}YnX||_|S)Ncs�|�Sr�ry�r��lrx)�funcryrzr{r|z_trim_arity.<locals>.<lambda>rFrs)rq�cSs8tdkrdnd}tj||dd�|}|dd�gS)N)rqr]r������r���limitrs)�system_version�	traceback�
extract_stack)rar�
frame_summaryryryrzrdsz"_trim_arity.<locals>.extract_stackcSs$tj||d�}|d}|dd�gS)Nr`rtrs)rc�
extract_tb)�tbraZframesreryryrzrfsz_trim_arity.<locals>.extract_tb�r`rtr�c	s�z"�|�dd��}d�d<|WStk
r��dr>�n4z.t��d}�|dd�ddd��ksj�W5~X�d�kr��dd7<Yq�YqXqdS)NrTrtrsr`r�)r�r��exc_info)r�r�rg�rfZ
foundArityr\ra�maxargsZpa_call_line_synthryrz�wrapper-s z_trim_arity.<locals>.wrapperz<parse action>r��	__class__)r)r)	�singleArgBuiltinsrbrcrdrf�getattrr��	Exceptionr~)r\rkrdZ	LINE_DIFFZ	this_linerl�	func_nameryrjrz�_trim_aritys,

�rrcs�eZdZdZdZdZedd��Zedd��Zd�dd	�Z	d
d�Z
dd
�Zd�dd�Zd�dd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd�dd �Zd!d"�Zd�d#d$�Zd%d&�Zd'd(�ZGd)d*�d*e�Zed+k	r�Gd,d-�d-e�ZnGd.d-�d-e�ZiZe�Zd/d/gZ d�d0d1�Z!eZ"ed2d3��Z#dZ$ed�d5d6��Z%d�d7d8�Z&e'dfd9d:�Z(d;d<�Z)e'fd=d>�Z*e'dfd?d@�Z+dAdB�Z,dCdD�Z-dEdF�Z.dGdH�Z/dIdJ�Z0dKdL�Z1dMdN�Z2dOdP�Z3dQdR�Z4dSdT�Z5dUdV�Z6dWdX�Z7dYdZ�Z8d�d[d\�Z9d]d^�Z:d_d`�Z;dadb�Z<dcdd�Z=dedf�Z>dgdh�Z?d�didj�Z@dkdl�ZAdmdn�ZBdodp�ZCdqdr�ZDgfdsdt�ZEd�dudv�ZF�fdwdx�ZGdydz�ZHd{d|�ZId}d~�ZJdd��ZKd�d�d��ZLd�d�d��ZM�ZNS)�r&z)Abstract base level parser element class.z 
	
FcCs
|t_dS)a�
        Overrides the default whitespace chars

        Example::
            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
            
            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        N)r&�DEFAULT_WHITE_CHARS��charsryryrz�setDefaultWhitespaceCharsTs
z'ParserElement.setDefaultWhitespaceCharscCs
|t_dS)a�
        Set class to be used for inclusion of string literals into a parser.
        
        Example::
            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        N)r&�_literalStringClass)r�ryryrz�inlineLiteralsUsingcsz!ParserElement.inlineLiteralsUsingcCs�t�|_d|_d|_d|_||_d|_tj|_	d|_
d|_d|_t�|_
d|_d|_d|_d|_d|_d|_d|_d|_d|_dS)NTFr�)NNN)r��parseAction�
failAction�strRepr�resultsName�
saveAsList�skipWhitespacer&rs�
whiteChars�copyDefaultWhiteChars�mayReturnEmpty�keepTabs�ignoreExprs�debug�streamlined�
mayIndexError�errmsg�modalResults�debugActions�re�callPreparse�
callDuringTry)r��savelistryryrzr�xs(zParserElement.__init__cCs<t�|�}|jdd�|_|jdd�|_|jr8tj|_|S)a$
        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
        for the same parsing pattern, using copies of the original parse element.
        
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
            
            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
        prints::
            [5120, 100, 655360, 268435456]
        Equivalent form of C{expr.copy()} is just C{expr()}::
            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
        N)r�ryr�r�r&rsr)r�Zcpyryryrzr��s
zParserElement.copycCs*||_d|j|_t|d�r&|j|j_|S)af
        Define name for this expression, makes debugging and exception messages clearer.
        
        Example::
            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        �	Expected �	exception)r�r�r�r�r�rryryrz�setName�s


zParserElement.setNamecCs4|��}|�d�r"|dd�}d}||_||_|S)aP
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original C{ParserElement} object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        C{expr("name")} in place of C{expr.setResultsName("name")} - 
        see L{I{__call__}<__call__>}.

        Example::
            date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        �*NrtT)r��endswithr|r�)r�r��listAllMatchesZnewselfryryrz�setResultsName�s
zParserElement.setResultsNameTcs@|r&|j�d�fdd�	}�|_||_nt|jd�r<|jj|_|S)z�Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set C{breakFlag} to True to enable, False to
           disable.
        Tcsddl}|���||||�Sr�)�pdbZ	set_trace)rRr��	doActions�callPreParser��Z_parseMethodryrz�breaker�sz'ParserElement.setBreak.<locals>.breaker�_originalParseMethod)TT)�_parser�r�)r�Z	breakFlagr�ryr�rz�setBreak�s
zParserElement.setBreakcOs&tttt|���|_|�dd�|_|S)a
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
         - s   = the original string being parsed (see note below)
         - loc = the location of the matching substring
         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        Optional keyword arguments:
         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
        consistent view of the parsed string, the parse location, and line and column
        positions within the parsed string.
        
        Example::
            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        r�F)r��maprrryr�r��r��fnsrryryrzr��s"zParserElement.setParseActioncOs4|jtttt|���7_|jp,|�dd�|_|S)z�
        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
        
        See examples in L{I{copy}<copy>}.
        r�F)ryr�r�rrr�r�r�ryryrz�addParseActionszParserElement.addParseActioncs^|�dd��|�dd�rtnt�|D] ����fdd�}|j�|�q$|jpV|�dd�|_|S)a�Add a boolean predicate function to expression's list of parse actions. See 
        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
        functions passed to C{addCondition} need to return boolean success/fail of the condition.

        Optional keyword arguments:
         - message = define a custom message to be used in the raised exception
         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
         
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        �messagezfailed user-defined condition�fatalFcs$tt��|||��s �||���dSr�)r	rrrZ��exc_type�fnr�ryrz�pa&sz&ParserElement.addCondition.<locals>.par�)r�r#r!ryrr�)r�r�rr�ryr�rz�addConditionszParserElement.addConditioncCs
||_|S)aDefine action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           C{fn(s,loc,expr,err)} where:
            - s = string being parsed
            - loc = location where expression match was attempted and failed
            - expr = the parse expression that failed
            - err = the exception thrown
           The function returns no value.  It may throw C{L{ParseFatalException}}
           if it is desired to stop parsing immediately.)rz)r�r�ryryrz�
setFailAction-s
zParserElement.setFailActionc	CsNd}|rJd}|jD]4}z|�||�\}}d}qWqtk
rDYqXqq|S�NTF)r�r�r!)r�rRr�Z
exprsFound�eZdummyryryrz�_skipIgnorables:s


zParserElement._skipIgnorablescCsH|jr|�||�}|jrD|j}t|�}||krD|||krD|d7}q&|S�Nr�)r�r�r~rr�)r�rRr�Zwt�instrlenryryrz�preParseGs
zParserElement.preParsecCs|gfSr�ry�r�rRr�r�ryryrz�	parseImplSszParserElement.parseImplcCs|Sr�ry�r�rRr��	tokenlistryryrz�	postParseVszParserElement.postParsec
Cs�|j}|s|jr�|jdr,|jd|||�|rD|jrD|�||�}n|}|}zDz|�|||�\}}Wn(tk
r�t|t|�|j	|��YnXWnXt
k
r�}	z:|jdr�|jd||||	�|jr�|�||||	��W5d}	~	XYnXn�|�r|j�r|�||�}n|}|}|j�s&|t|�k�rjz|�|||�\}}Wn*tk
�rft|t|�|j	|��YnXn|�|||�\}}|�|||�}t
||j|j|jd�}
|j�r�|�s�|j�r�|�rTzN|jD]B}||||
�}|dk	�r�t
||j|j�o�t|t
tf�|jd�}
�q�WnFt
k
�rP}	z&|jd�r>|jd||||	��W5d}	~	XYnXnJ|jD]B}||||
�}|dk	�rZt
||j|j�o�t|t
tf�|jd�}
�qZ|�r�|jd�r�|jd|||||
�||
fS)Nrrs)r�r�r�)r�rzr�r�r�r�r�r!r�r�rr�r�r$r|r}r�ryr�r}r�)r�rRr�r�r�Z	debugging�prelocZtokensStart�tokens�errZ	retTokensr�ryryrz�
_parseNoCacheZst





�

�
zParserElement._parseNoCachecCs@z|j||dd�dWStk
r:t|||j|��YnXdS)NF)r�r)r�r#r!r��r�rRr�ryryrz�tryParse�szParserElement.tryParsec	Cs4z|�||�Wnttfk
r*YdSXdSdS)NFT)r�r!r�r�ryryrz�canParseNext�s
zParserElement.canParseNextc@seZdZdd�ZdS)zParserElement._UnboundedCachecs~i�t�|_���fdd�}�fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr��r��r�r��cache�not_in_cacheryrzr��sz3ParserElement._UnboundedCache.__init__.<locals>.getcs|�|<dSr�ry�r�rr��r�ryrz�set�sz3ParserElement._UnboundedCache.__init__.<locals>.setcs���dSr��rr�r�ryrzr�sz5ParserElement._UnboundedCache.__init__.<locals>.clearcst��Sr��r�r�r�ryrz�	cache_len�sz9ParserElement._UnboundedCache.__init__.<locals>.cache_len)r�r��types�
MethodTyper�r�rr�)r�r�r�rr�ryr�rzr��sz&ParserElement._UnboundedCache.__init__N�r�r�r�r�ryryryrz�_UnboundedCache�sr�Nc@seZdZdd�ZdS)�ParserElement._FifoCachecs�t�|_�t����fdd�}��fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr�r�r�r�ryrzr��s�.ParserElement._FifoCache.__init__.<locals>.getcs>|�|<t���kr:z��d�Wqtk
r6YqXqdS�NF)r��popitemr�r�)r��sizeryrzr��s�.ParserElement._FifoCache.__init__.<locals>.setcs���dSr�r�r�r�ryrzr�s�0ParserElement._FifoCache.__init__.<locals>.clearcst��Sr�r�r�r�ryrzr��s�4ParserElement._FifoCache.__init__.<locals>.cache_len)	r�r��_OrderedDictr�r�r�r�rr��r�r�r�r�rr�ry)r�r�r�rzr��s�!ParserElement._FifoCache.__init__Nr�ryryryrz�
_FifoCache�sr�c@seZdZdd�ZdS)r�cs�t�|_�i�t�g�����fdd�}���fdd�}��fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_	dS)	Ncs��|��Sr�r�r�r�ryrzr��sr�cs4|�|<t���kr&�����d�q��|�dSr�)r�r�popleftrr�)r��key_fifor�ryrzr��sr�cs������dSr�r�r�)r�r�ryrzr�sr�cst��Sr�r�r�r�ryrzr��sr�)
r�r��collections�dequer�r�r�r�rr�r�ry)r�r�r�r�rzr��sr�Nr�ryryryrzr��srcCsd\}}|||||f}tj��tj}|�|�}	|	|jkr�tj|d7<z|�||||�}	Wn8tk
r�}
z|�||
j	|
j
���W5d}
~
XYn.X|�||	d|	d��f�|	W5QR�Sn@tj|d7<t|	t
�r�|	�|	d|	d��fW5QR�SW5QRXdS)Nrr�r)r&�packrat_cache_lock�
packrat_cacher�r��packrat_cache_statsr�rr�rmr�r�r}rp)r�rRr�r�r�ZHITZMISS�lookupr�r�r�ryryrz�_parseCaches$


zParserElement._parseCachecCs(tj��dgttj�tjdd�<dSr�)r&r�rr�r�ryryryrz�
resetCaches
zParserElement.resetCache�cCs8tjs4dt_|dkr t��t_nt�|�t_tjt_dS)a�Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.
           
           Parameters:
            - cache_size_limit - (default=C{128}) - if an integer value is provided
              will limit the size of the packrat cache; if None is passed, then
              the cache size will be unbounded; if 0 is passed, the cache will
              be effectively disabled.
            
           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method C{ParserElement.enablePackrat()}.  If
           your program uses C{psyco} to "compile as you go", you must call
           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
           Python will crash.  For best results, call C{enablePackrat()} immediately
           after importing pyparsing.
           
           Example::
               import pyparsing
               pyparsing.ParserElement.enablePackrat()
        TN)r&�_packratEnabledr�r�r�r�r�)Zcache_size_limitryryrz�
enablePackrat%szParserElement.enablePackratc
Cs�t��|js|��|jD]}|��q|js8|��}z<|�|d�\}}|rr|�||�}t	�t
�}|�||�Wn0tk
r�}ztjr��n|�W5d}~XYnX|SdS)aB
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set C{parseAll} to True (equivalent to ending
        the grammar with C{L{StringEnd()}}).

        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the C{loc} argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:
         - calling C{parseWithTabs} on your grammar before calling C{parseString}
           (see L{I{parseWithTabs}<parseWithTabs>})
         - define your parse action using the full C{(s,loc,toks)} signature, and
           reference the input string using the parse action's C{s} argument
         - explictly expand the tabs in your input string before calling
           C{parseString}
        
        Example::
            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        rN)
r&r�r��
streamliner�r��
expandtabsr�r�rr+r�verbose_stacktrace)r�rR�parseAllr�r�r�ZserXryryrz�parseStringHs$

zParserElement.parseStringc
cs6|js|��|jD]}|��q|js4t|���}t|�}d}|j}|j}t	�
�d}	z�||kr�|	|kr�z |||�}
|||
dd�\}}Wntk
r�|
d}YqZX||kr�|	d7}	||
|fV|r�|||�}
|
|kr�|}q�|d7}q�|}qZ|
d}qZWn4tk
�r0}zt	j
�r�n|�W5d}~XYnXdS)a�
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
        C{overlap} is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
        strings with embedded tabs.

        Example::
            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens,start,end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])
        
        prints::
        
            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        rF�r�r�N)r�r�r�r�r�r�r�r�r�r&r�r!rr�)r�rR�
maxMatchesZoverlapr�r�r�Z
preparseFnZparseFn�matchesr�ZnextLocr�ZnextlocrXryryrz�
scanStringzsB




zParserElement.scanStringc
Cs�g}d}d|_z�|�|�D]Z\}}}|�|||��|rpt|t�rR||��7}nt|t�rf||7}n
|�|�|}q|�||d��dd�|D�}d�tt	t
|���WStk
r�}ztj
rƂn|�W5d}~XYnXdS)af
        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
        be returned from a parse action.  To use C{transformString}, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking C{transformString()} on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  C{transformString()} returns the resulting transformed string.
        
        Example::
            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())
            
            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
        Prints::
            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        rTNcSsg|]}|r|�qSryry)r��oryryrzr��sz1ParserElement.transformString.<locals>.<listcomp>r�)r�r�rr}r$r�r�r�r�r��_flattenrr&r�)r�rRr*ZlastErxr�r�rXryryrzr��s(



zParserElement.transformStringc
CsRztdd�|�||�D��WStk
rL}ztjr8�n|�W5d}~XYnXdS)a�
        Another extension to C{L{scanString}}, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        C{maxMatches} argument, to clip searching after 'n' matches are found.
        
        Example::
            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())
            
            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
        prints::
            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        cSsg|]\}}}|�qSryry)r�rxr�r�ryryrzr��sz.ParserElement.searchString.<locals>.<listcomp>N)r$r�rr&r�)r�rRr�rXryryrz�searchString�szParserElement.searchStringc	csTd}d}|j||d�D]*\}}}|||�V|r<|dV|}q||d�VdS)a[
        Generator method to split a string using the given expression as a separator.
        May be called with optional C{maxsplit} argument, to limit the number of splits;
        and the optional C{includeSeparators} argument (default=C{False}), if the separating
        matching text should be included in the split results.
        
        Example::        
            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
        prints::
            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        r)r�N)r�)	r�rR�maxsplitZincludeSeparatorsZsplitsZlastrxr�r�ryryrzr�s

zParserElement.splitcCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)a�
        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
        converts them to L{Literal}s by default.
        
        Example::
            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))
        Prints::
            Hello, World! -> ['Hello', ',', 'World', '!']
        �4Cannot combine element of type %s with ParserElementrs��
stacklevelN)	r}r�r&rw�warnings�warnr��
SyntaxWarningrr"ryryrzrs


�zParserElement.__add__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of + operator when left operand is not a C{L{ParserElement}}
        r�rsr�N�r}r�r&rwr�r�r�r�r"ryryrzr#1s


�zParserElement.__radd__cCsJt|t�rt�|�}t|t�s:tjdt|�tdd�dS|t�	�|S)zQ
        Implementation of - operator, returns C{L{And}} with error stop
        r�rsr�N)
r}r�r&rwr�r�r�r�r�
_ErrorStopr"ryryrz�__sub__=s


�zParserElement.__sub__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of - operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rsub__Is


�zParserElement.__rsub__cs�t|t�r|d}}n�t|t�r�|ddd�}|ddkrHd|df}t|dt�r�|ddkr�|ddkrvt��S|ddkr�t��S�|dt��Sq�t|dt�r�t|dt�r�|\}}||8}q�tdt|d�t|d���ntdt|���|dk�rtd��|dk�rtd	��||k�r6dk�rBnntd
��|�r���fdd��|�r�|dk�rt��|�}nt�g|��|�}n�|�}n|dk�r��}nt�g|�}|S)
a�
        Implementation of * operator, allows use of C{expr * 3} in place of
        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
        may also include C{None} as in:
         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
              to C{expr*n + L{ZeroOrMore}(expr)}
              (read as "at least n instances of C{expr}")
         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
              (read as "0 to n instances of C{expr}")
         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}

        Note that C{expr*(None,n)} does not raise an exception if
        more than n exprs exist in the input stream; that is,
        C{expr*(None,n)} does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        C{expr*(None,n) + ~expr}
        r)NNNrsr�z7cannot multiply 'ParserElement' and ('%s','%s') objectsz0cannot multiply 'ParserElement' and '%s' objectsz/cannot multiply ParserElement by negative valuez@second tuple value must be greater or equal to first tuple valuez+cannot multiply ParserElement by 0 or (0,0)cs(|dkrt��|d��St��SdSr�)r��n��makeOptionalListr�ryrzr��sz/ParserElement.__mul__.<locals>.makeOptionalList)	r}rv�tupler4rr�r��
ValueErrorr)r�rZminElementsZoptElementsr�ryr�rz�__mul__UsD







zParserElement.__mul__cCs
|�|�Sr�)rr"ryryrz�__rmul__�szParserElement.__rmul__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zI
        Implementation of | operator - returns C{L{MatchFirst}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__or__�s


�zParserElement.__or__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||BS)z]
        Implementation of | operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__ror__�s


�zParserElement.__ror__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zA
        Implementation of ^ operator - returns C{L{Or}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__xor__�s


�zParserElement.__xor__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||AS)z]
        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rxor__�s


�zParserElement.__rxor__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zC
        Implementation of & operator - returns C{L{Each}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__and__�s


�zParserElement.__and__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||@S)z]
        Implementation of & operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rand__�s


�zParserElement.__rand__cCst|�S)zE
        Implementation of ~ operator - returns C{L{NotAny}}
        )rr�ryryrz�
__invert__�szParserElement.__invert__cCs|dk	r|�|�S|��SdS)a

        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
        
        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
        passed as C{True}.
           
        If C{name} is omitted, same as calling C{L{copy}}.

        Example::
            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
        N)r�r�rryryrz�__call__�s
zParserElement.__call__cCst|�S)z�
        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
        cluttering up returned output.
        )r-r�ryryrz�suppress�szParserElement.suppresscCs
d|_|S)a
        Disables the skipping of whitespace before matching the characters in the
        C{ParserElement}'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        F�r~r�ryryrz�leaveWhitespaceszParserElement.leaveWhitespacecCsd|_||_d|_|S)z8
        Overrides the default whitespace chars
        TF)r~rr�)r�ruryryrz�setWhitespaceChars
sz ParserElement.setWhitespaceCharscCs
d|_|S)z�
        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
        Must be called before C{parseString} when the input grammar contains elements that
        match C{<TAB>} characters.
        T)r�r�ryryrz�
parseWithTabsszParserElement.parseWithTabscCsLt|t�rt|�}t|t�r4||jkrH|j�|�n|j�t|����|S)a�
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.
        
        Example::
            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
            
            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        )r}r�r-r�rr�r"ryryrz�ignores


zParserElement.ignorecCs"|pt|pt|ptf|_d|_|S)zT
        Enable display of debugging messages while doing pattern matching.
        T)rTrWrYr�r�)r�ZstartActionZ
successActionZexceptionActionryryrz�setDebugActions6s�zParserElement.setDebugActionscCs|r|�ttt�nd|_|S)a�
        Enable display of debugging messages while doing pattern matching.
        Set C{flag} to True to enable, False to disable.

        Example::
            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer
            
            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")
        
        prints::
            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using L{setDebugActions}. Prior to attempting
        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
        F)rrTrWrYr�)r��flagryryrz�setDebug@s#zParserElement.setDebugcCs|jSr�)r�r�ryryrzr�iszParserElement.__str__cCst|�Sr�r�r�ryryrzr�lszParserElement.__repr__cCsd|_d|_|Sr�)r�r{r�ryryrzr�oszParserElement.streamlinecCsdSr�ryr�ryryrz�checkRecursiontszParserElement.checkRecursioncCs|�g�dS)zj
        Check defined expressions for valid structure, check for infinite recursive definitions.
        N)r)r��
validateTraceryryrz�validatewszParserElement.validatecCs�z|��}Wn2tk
r>t|d��}|��}W5QRXYnXz|�||�WStk
r~}ztjrj�n|�W5d}~XYnXdS)z�
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        �rN)�readr��openr�rr&r�)r�Zfile_or_filenamer�Z
file_contents�frXryryrz�	parseFile}szParserElement.parseFilecsHt|t�r"||kp t|�t|�kSt|t�r6|�|�Stt|�|kSdSr�)r}r&�varsr�r��superr"�rmryrz�__eq__�s



zParserElement.__eq__cCs
||kSr�ryr"ryryrz�__ne__�szParserElement.__ne__cCstt|��Sr�)�hash�idr�ryryrz�__hash__�szParserElement.__hash__cCs||kSr�ryr"ryryrz�__req__�szParserElement.__req__cCs
||kSr�ryr"ryryrz�__rne__�szParserElement.__rne__cCs4z|jt|�|d�WdStk
r.YdSXdS)a�
        Method for quick testing of a parser against a test string. Good for simple 
        inline microtests of sub expressions while building up larger parser.
           
        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
            
        Example::
            expr = Word(nums)
            assert expr.matches("100")
        �r�TFN)r�r�r)r�Z
testStringr�ryryrzr��s

zParserElement.matches�#cCs�t|t�r"tttj|������}t|t�r4t|�}g}g}d}	|D�]�}
|dk	r^|�	|
d�sf|rr|
sr|�
|
�qD|
sxqDd�|�|
g}g}z:|
�dd�}
|j
|
|d�}|�
|j|d��|	o�|}	Wn�tk
�rr}
z�t|
t�r�dnd	}d|
k�r*|�
t|
j|
��|�
d
t|
j|
�dd|�n|�
d
|
jd|�|�
d
t|
��|	�o\|}	|
}W5d}
~
XYnDtk
�r�}z$|�
dt|��|	�o�|}	|}W5d}~XYnX|�r�|�r�|�
d	�td�|��|�
|
|f�qD|	|fS)a3
        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.
           
        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
              string; pass None to disable comment filtering
         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default=C{True}) prints test output to stdout
         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
        test's output
        
        Example::
            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")
        prints::
            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success
            
            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\n of strings that spans \n 3 lines")
        
        (Note that this is a raw string literal, you must include the leading 'r'.)
        TNFr2�\nr%)rDz(FATAL)r�� r��^zFAIL: zFAIL-EXCEPTION: )r}r�r�r�r~r��rstrip�
splitlinesrr�rr�r�r�rArr#rIr�r;rprQ)r�Ztestsr�ZcommentZfullDumpZprintResultsZfailureTestsZ
allResultsZcomments�successrxr*�resultr�r�rXryryrz�runTests�sNW




$


zParserElement.runTests)F)F)T)T)TT)TT)r�)F)N)T)F)T)Tr&TTF)Or�r�r�r�rsr��staticmethodrvrxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r��_MAX_INTr�r�r�r�rr#r�r�rrrrrrrrrr	r
rr
rrrrr�r�r�rrrrrr"r#r$r�r.�
__classcell__ryryrrzr&Os�




&




G

"
2G+D
			

)

cs eZdZdZ�fdd�Z�ZS)r.zT
    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
    cstt|�jdd�dS�NF�r�)rr.r�r�rryrzr�@	szToken.__init__�r�r�r�r�r�r1ryryrrzr.<	scs eZdZdZ�fdd�Z�ZS)rz,
    An empty token, will always match.
    cs$tt|���d|_d|_d|_dS)NrTF)rrr�r�r�r�r�rryrzr�H	szEmpty.__init__r4ryryrrzrD	scs*eZdZdZ�fdd�Zddd�Z�ZS)rz(
    A token that will never match.
    cs*tt|���d|_d|_d|_d|_dS)NrTFzUnmatchable token)rrr�r�r�r�r�r�rryrzr�S	s
zNoMatch.__init__TcCst|||j|��dSr�)r!r�r�ryryrzr�Z	szNoMatch.parseImpl)T�r�r�r�r�r�r�r1ryryrrzrO	scs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Token to exactly match a specified string.
    
    Example::
        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
    
    For case-insensitive matching, use L{CaselessLiteral}.
    
    For keyword matching (force word break before and after the matched string),
    use L{Keyword} or L{CaselessKeyword}.
    cs�tt|���||_t|�|_z|d|_Wn*tk
rVtj	dt
dd�t|_YnXdt
|j�|_d|j|_d|_d|_dS)Nrz2null string passed to Literal; use Empty() insteadrsr��"%s"r�F)rrr��matchr��matchLen�firstMatchCharr�r�r�r�rrmr�r�r�r�r��r��matchStringrryrzr�l	s
�zLiteral.__init__TcCsJ|||jkr6|jdks&|�|j|�r6||j|jfSt|||j|��dSr�)r9r8�
startswithr7r!r�r�ryryrzr�	s��zLiteral.parseImpl)Tr5ryryrrzr^	s
csLeZdZdZedZd�fdd�	Zddd	�Z�fd
d�Ze	dd
��Z
�ZS)ra\
    Token to exactly match a specified string as a keyword, that is, it must be
    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
    Accepts two optional constructor arguments in addition to the keyword string:
     - C{identChars} is a string of characters that would be valid identifier characters,
          defaulting to all alphanumerics + "_" and "$"
     - C{caseless} allows case-insensitive matching, default is C{False}.
       
    Example::
        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use L{CaselessKeyword}.
    �_$NFcs�tt|���|dkrtj}||_t|�|_z|d|_Wn$tk
r^t	j
dtdd�YnXd|j|_d|j|_
d|_d|_||_|r�|��|_|��}t|�|_dS)Nrz2null string passed to Keyword; use Empty() insteadrsr�r6r�F)rrr��DEFAULT_KEYWORD_CHARSr7r�r8r9r�r�r�r�r�r�r�r��caseless�upper�
caselessmatchr��
identChars)r�r;rBr?rryrzr��	s*
�
zKeyword.__init__TcCs|jr|||||j���|jkr�|t|�|jksL|||j��|jkr�|dksj||d��|jkr�||j|jfSnv|||jkr�|jdks�|�|j|�r�|t|�|jks�|||j|jkr�|dks�||d|jkr�||j|jfSt	|||j
|��dSr�)r?r8r@rAr�rBr7r9r<r!r�r�ryryrzr��	s4����������zKeyword.parseImplcstt|���}tj|_|Sr�)rrr�r>rB)r�r�rryrzr��	szKeyword.copycCs
|t_dS)z,Overrides the default Keyword chars
        N)rr>rtryryrz�setDefaultKeywordChars�	szKeyword.setDefaultKeywordChars)NF)T)r�r�r�r�r5r>r�r�r�r/rCr1ryryrrzr�	s
cs*eZdZdZ�fdd�Zddd�Z�ZS)r
al
    Token to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::
        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
        
    (Contrast with example for L{CaselessKeyword}.)
    cs6tt|��|���||_d|j|_d|j|_dS)Nz'%s'r�)rr
r�r@�returnStringr�r�r:rryrzr��	szCaselessLiteral.__init__TcCs@||||j���|jkr,||j|jfSt|||j|��dSr�)r8r@r7rDr!r�r�ryryrzr��	szCaselessLiteral.parseImpl)Tr5ryryrrzr
�	s
cs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
r	z�
    Caseless version of L{Keyword}.

    Example::
        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
        
    (Contrast with example for L{CaselessLiteral}.)
    Ncstt|�j||dd�dS)NT�r?)rr	r�)r�r;rBrryrzr��	szCaselessKeyword.__init__TcCsj||||j���|jkrV|t|�|jksF|||j��|jkrV||j|jfSt|||j|��dSr�)r8r@rAr�rBr7r!r�r�ryryrzr��	s��zCaselessKeyword.parseImpl)N)Tr5ryryrrzr	�	scs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
rnax
    A variation on L{Literal} which matches "close" matches, that is, 
    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
     - C{match_string} - string to be matched
     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
    
    The results from a successful parse will contain the matched text from the input string and the following named results:
     - C{mismatches} - a list of the positions within the match_string where mismatches were found
     - C{original} - the original match_string used to compare against the input string
    
    If C{mismatches} is an empty list, then the match was an exact match.
    
    Example::
        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    r�csBtt|���||_||_||_d|j|jf|_d|_d|_dS)Nz&Expected %r (with up to %d mismatches)F)	rrnr�r��match_string�
maxMismatchesr�r�r�)r�rFrGrryrzr�

szCloseMatch.__init__TcCs�|}t|�}|t|j�}||kr�|j}d}g}	|j}
tt|||�|j��D]2\}}|\}}
||
krN|	�|�t|	�|
krNq�qN|d}t|||�g�}|j|d<|	|d<||fSt|||j|��dS)Nrr��original�
mismatches)	r�rFrGr�r�rr$r!r�)r�rRr�r��startr��maxlocrFZmatch_stringlocrIrGZs_m�src�mat�resultsryryrzr�
s( 

zCloseMatch.parseImpl)r�)Tr5ryryrrzrn�	s	cs8eZdZdZd
�fdd�	Zdd	d
�Z�fdd�Z�ZS)r1a	
    Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters,
    an optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction. An optional
    C{excludeChars} parameter can list characters that might be found in 
    the input C{bodyChars} string; useful to define a word of all printables
    except for one or two characters, for instance.
    
    L{srange} is useful for defining custom character set strings for defining 
    C{Word} expressions, using range notation from regular expression character sets.
    
    A common mistake is to use C{Word} to match a specific literal string, as in 
    C{Word("Address")}. Remember that C{Word} uses the string argument to define
    I{sets} of matchable characters. This expression would match "Add", "AAA",
    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
    To match an exact literal string, use L{Literal} or L{Keyword}.

    pyparsing includes helper strings for building Words:
     - L{alphas}
     - L{nums}
     - L{alphanums}
     - L{hexnums}
     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - L{printables} (any non-whitespace character)

    Example::
        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
        
        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums+'-')
        
        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")
        
        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    Nr�rFcs�tt|����rFd��fdd�|D��}|rFd��fdd�|D��}||_t|�|_|rl||_t|�|_n||_t|�|_|dk|_	|dkr�t
d��||_|dkr�||_nt
|_|dkr�||_||_t|�|_d|j|_d	|_||_d
|j|jk�r�|dk�r�|dk�r�|dk�r�|j|jk�r8dt|j�|_nHt|j�dk�rfdt�|j�t|j�f|_nd
t|j�t|j�f|_|j�r�d|jd|_zt�|j�|_Wntk
�r�d|_YnXdS)Nr�c3s|]}|�kr|VqdSr�ryr���excludeCharsryrzr�`
sz Word.__init__.<locals>.<genexpr>c3s|]}|�kr|VqdSr�ryr�rOryrzr�b
srr�zZcannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permittedr�Fr(z[%s]+z%s[%s]*z	[%s][%s]*z\b)rr1r�r��
initCharsOrigr��	initChars�
bodyCharsOrig�	bodyChars�maxSpecifiedr��minLen�maxLenr0r�r�r�r��	asKeyword�_escapeRegexRangeChars�reStringr�r��escape�compilerp)r�rRrT�min�max�exactrXrPrrOrzr�]
s\



0
����z
Word.__init__Tc
Cs>|jr<|j�||�}|s(t|||j|��|��}||��fS|||jkrZt|||j|��|}|d7}t|�}|j}||j	}t
||�}||kr�|||kr�|d7}q�d}	|||jkr�d}	|jr�||kr�|||kr�d}	|j
�r|dkr�||d|k�s||k�r|||k�rd}	|	�r.t|||j|��||||�fS)Nr�FTr)r�r7r!r��end�grouprRr�rTrWr]rVrUrX)
r�rRr�r�r-rJr�Z	bodycharsrKZthrowExceptionryryrzr��
s6


2zWord.parseImplcsvztt|���WStk
r$YnX|jdkrpdd�}|j|jkr`d||j�||j�f|_nd||j�|_|jS)NcSs$t|�dkr|dd�dS|SdS)N��...r��r�ryryrz�
charsAsStr�
sz Word.__str__.<locals>.charsAsStrz	W:(%s,%s)zW:(%s))rr1r�rpr{rQrS)r�rerryrzr��
s
zWord.__str__)Nr�rrFN)T�r�r�r�r�r�r�r�r1ryryrrzr1.
s.6
#csFeZdZdZee�d��Zd�fdd�	Zddd�Z	�fd	d
�Z
�ZS)
r)a�
    Token for matching strings that match a given regular expression.
    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
    named parse results.

    Example::
        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    z[A-Z]rcs�tt|���t|t�r�|s,tjdtdd�||_||_	zt
�|j|j	�|_
|j|_Wq�t
jk
r�tjd|tdd��Yq�Xn2t|tj�r�||_
t|�|_|_||_	ntd��t|�|_d|j|_d|_d|_d	S)
z�The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags.z0null string passed to Regex; use Empty() insteadrsr��$invalid pattern (%s) passed to RegexzCRegex may only be constructed with a string or a compiled RE objectr�FTN)rr)r�r}r�r�r�r��pattern�flagsr�r\rZ�
sre_constants�error�compiledREtyper~r�r�r�r�r�r�)r�rhrirryrzr��
s:
�
�
�
zRegex.__init__TcCs`|j�||�}|s"t|||j|��|��}|��}t|���}|rX|D]}||||<qF||fSr�)r�r7r!r�r`�	groupdictr$ra)r�rRr�r�r-�dr�r�ryryrzr��
szRegex.parseImplcsFztt|���WStk
r$YnX|jdkr@dt|j�|_|jS)NzRe:(%s))rr)r�rpr{r�rhr�rryrzr�
s
z
Regex.__str__)r)T)r�r�r�r�r�r�r\rlr�r�r�r1ryryrrzr)�
s
"

cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
r'a�
    Token for matching strings that are delimited by quoting characters.
    
    Defined with the following parameters:
        - quoteChar - string of one or more characters defining the quote delimiting string
        - escChar - character to escape quotes, typically backslash (default=C{None})
        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})

    Example::
        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
    prints::
        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    NFTc
sNtt����|��}|s0tjdtdd�t��|dkr>|}n"|��}|s`tjdtdd�t��|�_t	|��_
|d�_|�_t	|��_
|�_|�_|�_|�_|r�tjtjB�_dt��j�t�jd�|dk	r�t|�p�df�_n<d�_dt��j�t�jd�|dk	�rt|��pdf�_t	�j�d	k�rp�jd
d��fdd
�tt	�j�d	dd�D��d7_|�r��jdt�|�7_|�r��jdt�|�7_t��j�d�_�jdt��j�7_zt��j�j��_�j�_Wn0tjk
�r&tjd�jtdd��YnXt ���_!d�j!�_"d�_#d�_$dS)Nz$quoteChar cannot be the empty stringrsr�z'endQuoteChar cannot be the empty stringrz%s(?:[^%s%s]r�z%s(?:[^%s\n\r%s]r�z|(?:z)|(?:c3s4|],}dt��jd|��t�j|�fVqdS)z%s[^%s]N)r�r[�endQuoteCharrYr&r�ryrzr�Xs��z(QuotedString.__init__.<locals>.<genexpr>rt�)z|(?:%s)z|(?:%s.)z(.)z)*%srgr�FT)%rr'r�r�r�r�r��SyntaxError�	quoteCharr��quoteCharLen�firstQuoteCharro�endQuoteCharLen�escChar�escQuote�unquoteResults�convertWhitespaceEscapesr��	MULTILINE�DOTALLrir[rYrhr�r��escCharReplacePatternr\rZrjrkr�r�r�r�r�)r�rrrvrwZ	multilinerxroryrr�rzr�/s|



��
������
zQuotedString.__init__c	Cs�|||jkr|j�||�pd}|s4t|||j|��|��}|��}|jr�||j|j	�}t
|t�r�d|kr�|jr�ddddd�}|�
�D]\}}|�||�}q�|jr�t�|jd|�}|jr�|�|j|j�}||fS)N�\�	r2��
)�\tr'z\fz\rz\g<1>)rtr�r7r!r�r`rarxrsrur}r�ryr�r�rvr�r|rwro)	r�rRr�r�r-r�Zws_mapZwslitZwscharryryrzr�ps* 
�zQuotedString.parseImplcsHztt|���WStk
r$YnX|jdkrBd|j|jf|_|jS)Nz.quoted string, starting with %s ending with %s)rr'r�rpr{rrror�rryrzr��s
zQuotedString.__str__)NNFTNT)Trfryryrrzr'sA
#cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
ra�
    Token for matching words composed of characters I{not} in a given set (will
    include whitespace in matched characters if not listed in the provided exclusion set - see example).
    Defined with string containing all disallowed characters, and an optional
    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction.

    Example::
        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
    prints::
        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    r�rcs�tt|���d|_||_|dkr*td��||_|dkr@||_nt|_|dkrZ||_||_t	|�|_
d|j
|_|jdk|_d|_
dS)NFr�zfcannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permittedrr�)rrr�r~�notCharsr�rVrWr0r�r�r�r�r�)r�r�r]r^r_rryrzr��s 
zCharsNotIn.__init__TcCs�|||jkrt|||j|��|}|d7}|j}t||jt|��}||krb|||krb|d7}qD|||jkr�t|||j|��||||�fSr�)r�r!r�r]rWr�rV)r�rRr�r�rJZnotchars�maxlenryryrzr��s
�
zCharsNotIn.parseImplcsfztt|���WStk
r$YnX|jdkr`t|j�dkrTd|jdd�|_nd|j|_|jS)Nrbz
!W:(%s...)z!W:(%s))rrr�rpr{r�r�r�rryrzr��s
zCharsNotIn.__str__)r�rr)Trfryryrrzr�s
cs<eZdZdZdddddd�Zd�fdd�	Zddd�Z�ZS)r0a�
    Special matching class for matching whitespace.  Normally, whitespace is ignored
    by pyparsing grammars.  This class is included when some whitespace structures
    are significant.  Define with a string containing the whitespace characters to be
    matched; default is C{" \t\r\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
    as defined for the C{L{Word}} class.
    z<SPC>z<TAB>z<LF>z<CR>z<FF>)r(r~r2r�r� 	
r�rcs�tt����|�_��d��fdd��jD���d�dd��jD���_d�_d�j�_	|�_
|dkrt|�_nt�_|dkr�|�_|�_
dS)Nr�c3s|]}|�jkr|VqdSr�)�
matchWhiter�r�ryrzr��s
z!White.__init__.<locals>.<genexpr>css|]}tj|VqdSr�)r0�	whiteStrsr�ryryrzr��sTr�r)
rr0r�r�r
r�rr�r�r�rVrWr0)r�Zwsr]r^r_rr�rzr��s zWhite.__init__TcCs�|||jkrt|||j|��|}|d7}||j}t|t|��}||krb|||jkrb|d7}qB|||jkr�t|||j|��||||�fSr�)r�r!r�rWr]r�rV)r�rRr�r�rJrKryryrzr�	s

zWhite.parseImpl)r�r�rr)T)r�r�r�r�r�r�r�r1ryryrrzr0�s�cseZdZ�fdd�Z�ZS)�_PositionTokencs(tt|���|jj|_d|_d|_dSr�)rr�r�rmr�r�r�r�r�rryrzr�s
z_PositionToken.__init__�r�r�r�r�r1ryryrrzr�sr�cs2eZdZdZ�fdd�Zdd�Zd	dd�Z�ZS)
rzb
    Token to advance to a specific column of input text; useful for tabular report scraping.
    cstt|���||_dSr�)rrr�r;)r��colnorryrzr�$szGoToColumn.__init__cCs\t||�|jkrXt|�}|jr*|�||�}||krX||��rXt||�|jkrX|d7}q*|Sr�)r;r�r�r��isspace)r�rRr�r�ryryrzr�(s$
zGoToColumn.preParseTcCsDt||�}||jkr"t||d|��||j|}|||�}||fS)NzText not in expected column�r;r!)r�rRr�r�ZthiscolZnewlocr�ryryrzr�1s

zGoToColumn.parseImpl)T)r�r�r�r�r�r�r�r1ryryrrzr s	cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Matches if current position is at the beginning of a line within the parse string
    
    Example::
    
        test = '''        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)
    
    Prints::
        ['AAA', ' this line']
        ['AAA', ' and this line']    

    cstt|���d|_dS)NzExpected start of line)rrr�r�r�rryrzr�OszLineStart.__init__TcCs*t||�dkr|gfSt|||j|��dSr�)r;r!r�r�ryryrzr�SszLineStart.parseImpl)Tr5ryryrrzr:scs*eZdZdZ�fdd�Zddd�Z�ZS)rzU
    Matches if current position is at the end of a line within the parse string
    cs,tt|���|�tj�dd��d|_dS)Nr2r�zExpected end of line)rrr�r
r&rsr�r�r�rryrzr�\szLineEnd.__init__TcCsb|t|�kr6||dkr$|ddfSt|||j|��n(|t|�krN|dgfSt|||j|��dS)Nr2r��r�r!r�r�ryryrzr�aszLineEnd.parseImpl)Tr5ryryrrzrXscs*eZdZdZ�fdd�Zddd�Z�ZS)r,zM
    Matches if current position is at the beginning of the parse string
    cstt|���d|_dS)NzExpected start of text)rr,r�r�r�rryrzr�pszStringStart.__init__TcCs0|dkr(||�|d�kr(t|||j|��|gfSr�)r�r!r�r�ryryrzr�tszStringStart.parseImpl)Tr5ryryrrzr,lscs*eZdZdZ�fdd�Zddd�Z�ZS)r+zG
    Matches if current position is at the end of the parse string
    cstt|���d|_dS)NzExpected end of text)rr+r�r�r�rryrzr�szStringEnd.__init__TcCs^|t|�krt|||j|��n<|t|�kr6|dgfS|t|�krJ|gfSt|||j|��dSr�r�r�ryryrzr��szStringEnd.parseImpl)Tr5ryryrrzr+{scs.eZdZdZef�fdd�	Zddd�Z�ZS)r3ap
    Matches if the current position is at the beginning of a Word, and
    is not preceded by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
    the string being parsed, or at the beginning of a line.
    cs"tt|���t|�|_d|_dS)NzNot at the start of a word)rr3r�r��	wordCharsr��r�r�rryrzr��s
zWordStart.__init__TcCs@|dkr8||d|jks(|||jkr8t|||j|��|gfSr�)r�r!r�r�ryryrzr��s�zWordStart.parseImpl)T�r�r�r�r�rXr�r�r1ryryrrzr3�scs.eZdZdZef�fdd�	Zddd�Z�ZS)r2aZ
    Matches if the current position is at the end of a Word, and
    is not followed by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
    the string being parsed, or at the end of a line.
    cs(tt|���t|�|_d|_d|_dS)NFzNot at the end of a word)rr2r�r�r�r~r�r�rryrzr��s
zWordEnd.__init__TcCsPt|�}|dkrH||krH|||jks8||d|jkrHt|||j|��|gfSr�)r�r�r!r�)r�rRr�r�r�ryryrzr��s�zWordEnd.parseImpl)Tr�ryryrrzr2�scs�eZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Z�fdd�Z�fd
d�Z	�fdd�Z
d�fdd�	Zgfdd�Z�fdd�Z
�ZS)r"z^
    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r"t|�}t|t�r<t�|�g|_	nht|t
�rxt|�}tdd�|D��rlttj|�}t|�|_	n,zt|�|_	Wnt
k
r�|g|_	YnXd|_dS)Ncss|]}t|t�VqdSr�)r}r�)r�rSryryrzr��sz+ParseExpression.__init__.<locals>.<genexpr>F)rr"r�r}r�r�r�r&rw�exprsr�allr�r�r��r�r�r�rryrzr��s


zParseExpression.__init__cCs
|j|Sr�)r�r�ryryrzr��szParseExpression.__getitem__cCs|j�|�d|_|Sr�)r�rr{r"ryryrzr�szParseExpression.appendcCs0d|_dd�|jD�|_|jD]}|��q|S)z~Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
           all contained expressions.FcSsg|]}|���qSryr�r�r�ryryrzr��sz3ParseExpression.leaveWhitespace.<locals>.<listcomp>)r~r�r)r�r�ryryrzr�s


zParseExpression.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jD]}|�|jd�q*n,tt|��|�|jD]}|�|jd�qX|Sr�)r}r-r�rr"rr�)r�rr�rryrzr�s



zParseExpression.ignorecsNztt|���WStk
r$YnX|jdkrHd|jjt|j�f|_|jS�Nz%s:(%s))	rr"r�rpr{rmr�r�r�r�rryrzr��s
zParseExpression.__str__cs*tt|���|jD]}|��qt|j�dk�r|jd}t||j�r�|js�|jdkr�|j	s�|jdd�|jdg|_d|_
|j|jO_|j|jO_|jd}t||j��r|j�s|jdk�r|j	�s|jdd�|jdd�|_d|_
|j|jO_|j|jO_dt
|�|_|S)Nrsrr�rtr�)rr"r�r�r�r}rmryr|r�r{r�r�r�r�)r�r�rrryrzr��s<


���
���zParseExpression.streamlinecstt|��||�}|Sr�)rr"r�)r�r�r�r�rryrzr�
szParseExpression.setResultsNamecCs6|dd�|g}|jD]}|�|�q|�g�dSr�)r�rr)r�r�tmpr�ryryrzr
s
zParseExpression.validatecs$tt|���}dd�|jD�|_|S)NcSsg|]}|���qSryrr�ryryrzr�%
sz(ParseExpression.copy.<locals>.<listcomp>)rr"r�r�r1rryrzr�#
szParseExpression.copy)F)F)r�r�r�r�r�r�rrrr�r�r�rr�r1ryryrrzr"�s	
"csTeZdZdZGdd�de�Zd�fdd�	Zddd�Zd	d
�Zdd�Z	d
d�Z
�ZS)ra

    Requires all given C{ParseExpression}s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'+'} operator.
    May also be constructed using the C{'-'} operator, which will suppress backtracking.

    Example::
        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"),name_expr("name"),integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    cseZdZ�fdd�Z�ZS)zAnd._ErrorStopcs&ttj|�j||�d|_|��dS)N�-)rrr�r�r�rrGrryrzr�9
szAnd._ErrorStop.__init__r�ryryrrzr�8
sr�TcsRtt|��||�tdd�|jD��|_|�|jdj�|jdj|_d|_	dS)Ncss|]}|jVqdSr��r�r�ryryrzr�@
szAnd.__init__.<locals>.<genexpr>rT)
rrr�r�r�r�r
rr~r�r�rryrzr�>
s
zAnd.__init__c	Cs�|jdj|||dd�\}}d}|jdd�D]�}t|tj�rDd}q.|r�z|�|||�\}}Wq�tk
rt�Yq�tk
r�}zd|_t�|��W5d}~XYq�t	k
r�t|t
|�|j|��Yq�Xn|�|||�\}}|s�|��r.||7}q.||fS)NrFr�r�T)
r�r�r}rr�r%r�
__traceback__r�r�r�r�r
)	r�rRr�r��
resultlistZ	errorStopr�Z
exprtokensr�ryryrzr�E
s(
z
And.parseImplcCst|t�rt�|�}|�|�Sr��r}r�r&rwrr"ryryrzr!^
s

zAnd.__iadd__cCs6|dd�|g}|jD]}|�|�|jsq2qdSr�)r�rr��r�r��subRecCheckListr�ryryrzrc
s


zAnd.checkRecursioncCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr��{r(css|]}t|�VqdSr�r�r�ryryrzr�o
szAnd.__str__.<locals>.<genexpr>�}�r�r�r{r�r�r�ryryrzr�j
s


 zAnd.__str__)T)T)r�r�r�r�rr�r�r�r!rr�r1ryryrrzr(
s
csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the expression that matches the longest string will be used.
    May be constructed using the C{'^'} operator.

    Example::
        # construct Or using '^' operator
        
        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))
    prints::
        [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
szOr.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szOr.__init__TcCsRd}d}g}|jD]�}z|�||�}Wnvtk
rb}	zd|	_|	j|krR|	}|	j}W5d}	~	XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqX|�||f�q|�r(|j	dd�d�|D]^\}
}z|�
|||�WStk
�r$}	z d|	_|	j|k�r|	}|	j}W5d}	~	XYq�Xq�|dk	�r@|j|_|�nt||d|��dS)NrtcSs
|dSr�ry)�xryryrzr{�
r|zOr.parseImpl.<locals>.<lambda>)r� no defined alternatives to match)r�r�r!r�r�r�r�r�r�sortr�r�)r�rRr�r��	maxExcLoc�maxExceptionr�r�Zloc2r��_ryryrzr��
s<


zOr.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ixor__�
s

zOr.__ixor__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z ^ css|]}t|�VqdSr�r�r�ryryrzr��
szOr.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 z
Or.__str__cCs,|dd�|g}|jD]}|�|�qdSr��r�rr�ryryrzr�
s
zOr.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzrt
s

&	csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the first one listed is the one that will match.
    May be constructed using the C{'|'} operator.

    Example::
        # construct MatchFirst using '|' operator
        
        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
sz&MatchFirst.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szMatchFirst.__init__Tc	Cs�d}d}|jD]�}z|�|||�}|WStk
r`}z|j|krP|}|j}W5d}~XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqXq|dk	r�|j|_|�nt||d|��dS)Nrtr�)r�r�r!r�r�r�r�r�)	r�rRr�r�r�r�r�r�r�ryryrzr��
s$


zMatchFirst.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ior__�
s

zMatchFirst.__ior__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�� | css|]}t|�VqdSr�r�r�ryryrzr��
sz%MatchFirst.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 zMatchFirst.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzrs
zMatchFirst.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzr�
s
	cs<eZdZdZd�fdd�	Zddd�Zdd�Zd	d
�Z�ZS)
ram
    Requires all given C{ParseExpression}s to be found, but in any order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'&'} operator.

    Example::
        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order 
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )
    prints::
        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    Tcs8tt|��||�tdd�|jD��|_d|_d|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr�?sz Each.__init__.<locals>.<genexpr>T)rrr�r�r�r�r~�initExprGroupsr�rryrzr�=sz
Each.__init__c	s�|jr�tdd�|jD��|_dd�|jD�}dd�|jD�}|||_dd�|jD�|_dd�|jD�|_dd�|jD�|_|j|j7_d	|_|}|jdd�}|jdd��g}d
}	|	�rj|�|j|j}
g}|
D]v}z|�||�}Wn t	k
�r|�
|�Yq�X|�
|j�t|�|��||k�r@|�
|�q�|�kr܈�
|�q�t|�t|
�kr�d	}	q�|�r�d�dd�|D��}
t	||d
|
��|�fdd�|jD�7}g}|D]"}|�|||�\}}|�
|��q�t|tg��}||fS)Ncss&|]}t|t�rt|j�|fVqdSr�)r}rr!rSr�ryryrzr�Es
z!Each.parseImpl.<locals>.<genexpr>cSsg|]}t|t�r|j�qSry�r}rrSr�ryryrzr�Fs
z"Each.parseImpl.<locals>.<listcomp>cSs g|]}|jrt|t�s|�qSry)r�r}rr�ryryrzr�Gs
cSsg|]}t|t�r|j�qSry)r}r4rSr�ryryrzr�Is
cSsg|]}t|t�r|j�qSry)r}rrSr�ryryrzr�Js
cSs g|]}t|tttf�s|�qSry)r}rr4rr�ryryrzr�KsFTr%css|]}t|�VqdSr�r�r�ryryrzr�fsz*Missing one or more required elements (%s)cs$g|]}t|t�r|j�kr|�qSryr�r��ZtmpOptryrzr�js

)r�r�r�Zopt1mapZ	optionalsZmultioptionalsZ
multirequiredZrequiredr�r!rr�r!�remover�r�r��sumr$)r�rRr�r�Zopt1Zopt2ZtmpLocZtmpReqdZ
matchOrderZkeepMatchingZtmpExprsZfailedr�Zmissingr�rNZfinalResultsryr�rzr�CsP

zEach.parseImplcCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z & css|]}t|�VqdSr�r�r�ryryrzr�yszEach.__str__.<locals>.<genexpr>r�r�r�ryryrzr�ts


 zEach.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzr}s
zEach.checkRecursion)T)T)	r�r�r�r�r�r�r�rr1ryryrrzrs
5
1	csleZdZdZd�fdd�	Zddd�Zdd	�Z�fd
d�Z�fdd
�Zdd�Z	gfdd�Z
�fdd�Z�ZS)r za
    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r@ttjt�r2t�|�}nt�t	|��}||_
d|_|dk	r�|j|_|j
|_
|�|j�|j|_|j|_|j|_|j�|j�dSr�)rr r�r}r��
issubclassr&rwr.rrSr{r�r�r
rr~r}r�r�r�r�rSr�rryrzr��s
zParseElementEnhance.__init__TcCs2|jdk	r|jj|||dd�Std||j|��dS)NFr�r�)rSr�r!r�r�ryryrzr��s
zParseElementEnhance.parseImplcCs*d|_|j��|_|jdk	r&|j��|Sr�)r~rSr�rr�ryryrzr�s


z#ParseElementEnhance.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jdk	rn|j�|jd�n,tt|��|�|jdk	rn|j�|jd�|Sr�)r}r-r�rr rrSr"rryrzr�s



zParseElementEnhance.ignorecs&tt|���|jdk	r"|j��|Sr�)rr r�rSr�rryrzr��s

zParseElementEnhance.streamlinecCsB||krt||g��|dd�|g}|jdk	r>|j�|�dSr�)r(rSr)r�r�r�ryryrzr�s

z"ParseElementEnhance.checkRecursioncCs6|dd�|g}|jdk	r(|j�|�|�g�dSr��rSrr�r�rr�ryryrzr�s
zParseElementEnhance.validatecsXztt|���WStk
r$YnX|jdkrR|jdk	rRd|jjt|j�f|_|jSr�)	rr r�rpr{rSrmr�r�r�rryrzr��szParseElementEnhance.__str__)F)T)
r�r�r�r�r�r�rrr�rrr�r1ryryrrzr �s
cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Lookahead matching of the given parse expression.  C{FollowedBy}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression matches at the current
    position.  C{FollowedBy} always returns a null token list.

    Example::
        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
    prints::
        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    cstt|��|�d|_dSr�)rrr�r��r�rSrryrzr��szFollowedBy.__init__TcCs|j�||�|gfSr�)rSr�r�ryryrzr��szFollowedBy.parseImpl)Tr5ryryrrzr�scs2eZdZdZ�fdd�Zd	dd�Zdd�Z�ZS)
ra�
    Lookahead to disallow matching with the given parse expression.  C{NotAny}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression does I{not} match at the current
    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
    always returns a null token list.  May be constructed using the '~' operator.

    Example::
        
    cs0tt|��|�d|_d|_dt|j�|_dS)NFTzFound unwanted token, )rrr�r~r�r�rSr�r�rryrzr��szNotAny.__init__TcCs&|j�||�rt|||j|��|gfSr�)rSr�r!r�r�ryryrzr��szNotAny.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�z~{r��r�r�r{r�rSr�ryryrzr�s


zNotAny.__str__)Trfryryrrzr�s

cs(eZdZd�fdd�	Zddd�Z�ZS)	�_MultipleMatchNcsFtt|��|�d|_|}t|t�r.t�|�}|dk	r<|nd|_dSr�)	rr�r�r}r}r�r&rw�	not_ender)r�rS�stopOnZenderrryrzr�s

z_MultipleMatch.__init__Tc	Cs�|jj}|j}|jdk	}|r$|jj}|r2|||�||||dd�\}}zV|j}	|r`|||�|	rp|||�}
n|}
|||
|�\}}|s�|��rR||7}qRWnttfk
r�YnX||fS�NFr�)	rSr�r�r�r�r�r
r!r�)r�rRr�r�Zself_expr_parseZself_skip_ignorablesZcheck_enderZ
try_not_enderr�ZhasIgnoreExprsr�Z	tmptokensryryrzr�s*



z_MultipleMatch.parseImpl)N)T)r�r�r�r�r�r1ryryrrzr�
sr�c@seZdZdZdd�ZdS)ra�
    Repetition of one or more of the given expression.
    
    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
        
        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    cCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r�z}...r�r�ryryrzr�Js


zOneOrMore.__str__N)r�r�r�r�r�ryryryrzr0scs8eZdZdZd
�fdd�	Zd�fdd�	Zdd	�Z�ZS)r4aw
    Optional repetition of zero or more of the given expression.
    
    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example: similar to L{OneOrMore}
    Ncstt|�j||d�d|_dS)N)r�T)rr4r�r�)r�rSr�rryrzr�_szZeroOrMore.__init__Tc	s<ztt|��|||�WSttfk
r6|gfYSXdSr�)rr4r�r!r�r�rryrzr�cszZeroOrMore.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$�]...r�r�ryryrzr�is


zZeroOrMore.__str__)N)Trfryryrrzr4Ssc@s eZdZdd�ZeZdd�ZdS)�
_NullTokencCsdSr�ryr�ryryrzr�ssz_NullToken.__bool__cCsdSr�ryr�ryryrzr�vsz_NullToken.__str__N)r�r�r�r�rLr�ryryryrzr�rsr�cs6eZdZdZef�fdd�	Zd	dd�Zdd�Z�ZS)
raa
    Optional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::
        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345
            
            # ZIP+4 form
            12101-0001
            
            # invalid ZIP
            98765-
            ''')
    prints::
        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    cs.tt|�j|dd�|jj|_||_d|_dS)NFr3T)rrr�rSr}rr�)r�rSrrryrzr��s
zOptional.__init__Tc	Cszz|jj|||dd�\}}WnTttfk
rp|jtk	rh|jjr^t|jg�}|j||jj<ql|jg}ng}YnX||fSr�)rSr�r!r�r�_optionalNotMatchedr|r$)r�rRr�r�r�ryryrzr��s


zOptional.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$r'r�r�ryryrzr��s


zOptional.__str__)T)	r�r�r�r�r�r�r�r�r1ryryrrzrzs"
cs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r*a�	
    Token for skipping over all undefined text until the matched expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default=C{False}) if True, the target expression is also parsed 
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
          comments) that might contain false matches to the target expression
     - failOn - (default=C{None}) define expressions that are not allowed to be 
          included in the skipped test; if found before the target expression is found, 
          the SkipTo is not a match

    Example::
        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP 
                      + string_data("sev") + SEP 
                      + string_data("desc") + SEP 
                      + integer("days_open"))
        
        for tkt in ticket_expr.searchString(report):
            print tkt.dump()
    prints::
        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    FNcs`tt|��|�||_d|_d|_||_d|_t|t	�rFt
�|�|_n||_dt
|j�|_dS)NTFzNo match found for )rr*r��
ignoreExprr�r��includeMatchr�r}r�r&rw�failOnr�rSr�)r�rZincluderr�rryrzr��s
zSkipTo.__init__Tc	Cs&|}t|�}|j}|jj}|jdk	r,|jjnd}|jdk	rB|jjnd}	|}
|
|kr�|dk	rf|||
�rfq�|	dk	r�z|	||
�}
Wqntk
r�Yq�YqnXqnz|||
ddd�Wq�tt	fk
r�|
d7}
YqJXq�qJt|||j
|��|
}|||�}t|�}|j�r||||dd�\}}
||
7}||fS)NF)r�r�r�r�)
r�rSr�r�r�r�r�rr!r�r�r$r�)r�rRr�r�rUr�rSZ
expr_parseZself_failOn_canParseNextZself_ignoreExpr_tryParseZtmplocZskiptextZ
skipresultrMryryrzr��s:
zSkipTo.parseImpl)FNN)Tr5ryryrrzr*�s6
csbeZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zgfd
d�Z	dd�Z
�fdd�Z�ZS)raK
    Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.

    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
    Specifically, '|' has a lower precedence than '<<', so that::
        fwdExpr << a | b | c
    will actually be evaluated as::
        (fwdExpr << a) | b | c
    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the C{Forward}::
        fwdExpr << (a | b | c)
    Converting to use the '<<=' operator instead will avoid this problem.

    See L{ParseResults.pprint} for an example of a recursive parser created using
    C{Forward}.
    Ncstt|�j|dd�dSr2)rrr�r"rryrzr�@szForward.__init__cCsjt|t�rt�|�}||_d|_|jj|_|jj|_|�|jj	�|jj
|_
|jj|_|j�
|jj�|Sr�)r}r�r&rwrSr{r�r�r
rr~r}r�rr"ryryrz�
__lshift__Cs





zForward.__lshift__cCs||>Sr�ryr"ryryrz�__ilshift__PszForward.__ilshift__cCs
d|_|Sr�rr�ryryrzrSszForward.leaveWhitespacecCs$|js d|_|jdk	r |j��|Sr�)r�rSr�r�ryryrzr�Ws


zForward.streamlinecCs>||kr0|dd�|g}|jdk	r0|j�|�|�g�dSr�r�r�ryryrzr^s

zForward.validatecCsVt|d�r|jS|jjdSz|jdk	r4t|j�}nd}W5|j|_X|jjd|S)Nr�z: ...�Nonez: )r�r�rmr�Z_revertClass�_ForwardNoRecurserSr�)r�Z	retStringryryrzr�es


zForward.__str__cs.|jdk	rtt|���St�}||K}|SdSr�)rSrrr�r1rryrzr�vs

zForward.copy)N)
r�r�r�r�r�r�r�rr�rr�r�r1ryryrrzr-s
c@seZdZdd�ZdS)r�cCsdS)Nrcryr�ryryrzr�sz_ForwardNoRecurse.__str__N)r�r�r�r�ryryryrzr�~sr�cs"eZdZdZd�fdd�	Z�ZS)r/zQ
    Abstract subclass of C{ParseExpression}, for converting parsed results.
    Fcstt|��|�d|_dSr�)rr/r�r}r�rryrzr��szTokenConverter.__init__)Fr4ryryrrzr/�scs6eZdZdZd
�fdd�	Z�fdd�Zdd	�Z�ZS)ra�
    Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the input string;
    this can be disabled by specifying C{'adjacent=False'} in the constructor.

    Example::
        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    r�Tcs8tt|��|�|r|��||_d|_||_d|_dSr�)rrr�r�adjacentr~�
joinStringr�)r�rSr�r�rryrzr��szCombine.__init__cs(|jrt�||�ntt|��|�|Sr�)r�r&rrrr"rryrzr�szCombine.ignorecCsP|��}|dd�=|td�|�|j��g|jd�7}|jrH|��rH|gS|SdS)Nr�)r�)r�r$r�r(r�r�r|r
)r�rRr�r�ZretToksryryrzr��s
"zCombine.postParse)r�T)r�r�r�r�r�rr�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)ra�
    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.

    Example::
        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
    cstt|��|�d|_dSr�)rrr�r}r�rryrzr��szGroup.__init__cCs|gSr�ryr�ryryrzr��szGroup.postParse�r�r�r�r�r�r�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)r
aW
    Converter to return a repetitive expression as a list, but also as a dictionary.
    Each element can also be referenced using the first token in the expression as its key.
    Useful for tabular report scraping when the first column can be used as a item key.

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())
        
        # access named fields as dict entries, or output as dict
        print(result['shape'])        
        print(result.asDict())
    prints::
        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
    See more examples at L{ParseResults} of accessing fields by results name.
    cstt|��|�d|_dSr�)rr
r�r}r�rryrzr��sz
Dict.__init__cCs�t|�D]�\}}t|�dkrq|d}t|t�r@t|d���}t|�dkr\td|�||<qt|�dkr�t|dt�s�t|d|�||<q|��}|d=t|�dks�t|t�r�|�	�r�t||�||<qt|d|�||<q|j
r�|gS|SdS)Nrr�r�rs)r�r�r}rvr�r�r�r$r�r
r|)r�rRr�r�r��tokZikeyZ	dictvalueryryrzr��s$
zDict.postParser�ryryrrzr
�s#c@s eZdZdZdd�Zdd�ZdS)r-aV
    Converter for ignoring the results of a parsed expression.

    Example::
        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))
    prints::
        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']
    (See also L{delimitedList}.)
    cCsgSr�ryr�ryryrzr�szSuppress.postParsecCs|Sr�ryr�ryryrzr
"szSuppress.suppressN)r�r�r�r�r�r
ryryryrzr-sc@s(eZdZdZdd�Zdd�Zdd�ZdS)	rzI
    Wrapper for parse actions, to ensure they are only called once.
    cCst|�|_d|_dSr�)rr�callable�called)r�Z
methodCallryryrzr�*s
zOnlyOnce.__init__cCs.|js|�|||�}d|_|St||d��dS)NTr�)r�r�r!)r�r�r[rxrNryryrzr	-s
zOnlyOnce.__call__cCs
d|_dSr�)r�r�ryryrz�reset3szOnlyOnce.resetN)r�r�r�r�r�r	r�ryryryrzr&scs:t����fdd�}z�j|_Wntk
r4YnX|S)at
    Decorator for debugging parse actions. 
    
    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.

    Example::
        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
    prints::
        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    c
s��j}|dd�\}}}t|�dkr8|djjd|}tj�d|t||�||f�z�|�}Wn8tk
r�}ztj�d||f��W5d}~XYnXtj�d||f�|S)Nr^rqr�.z">>entering %s(line: '%s', %d, %r)
z<<leaving %s (exception: %s)
z<<leaving %s (ret: %r)
)r�r�rmr��stderr�writerIrp)ZpaArgsZthisFuncr�r[rxr�rX�rryrz�zLsztraceParseAction.<locals>.z)rrr�r�)rr�ryr�rzrd6s
�,FcCs`t|�dt|�dt|�d}|rBt|t||���|�S|tt|�|��|�SdS)a�
    Helper to define a delimited list of expressions - the delimiter defaults to ','.
    By default, the list elements and delimiters can have intervening whitespace, and
    comments, but this can be overridden by passing C{combine=True} in the constructor.
    If C{combine} is set to C{True}, the matching tokens are returned as a single token
    string, with the delimiters included; otherwise, the matching tokens are returned
    as a list of tokens, with the delimiters suppressed.

    Example::
        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    z [r(r�N)r�rr4r�r-)rSZdelim�combineZdlNameryryrzrBbs
$csjt����fdd�}|dkr0tt��dd��}n|��}|�d�|j|dd�|��d	t��d
�S)a:
    Helper to define a counted list of expressions.
    This helper defines a pattern of the form::
        integer expr expr expr...
    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
    
    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.

    Example::
        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    cs.|d}�|r tt�g|��p&tt�>gSr�)rrrE)r�r[rxr��Z	arrayExprrSryrz�countFieldParseAction�s"z+countedArray.<locals>.countFieldParseActionNcSst|d�Sr�)rvrwryryrzr{�r|zcountedArray.<locals>.<lambda>ZarrayLenT�r�z(len) rc)rr1rTr�r�r�r�r�)rSZintExprr�ryr�rzr>us
cCs6g}|D](}t|t�r&|�t|��q|�|�q|Sr�)r}r�rr�r)�Lr�r�ryryrzr��s
r�cs6t���fdd�}|j|dd���dt|���S)a*
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
    If this is not desired, use C{matchPreviousExpr}.
    Do I{not} use with packrat parsing enabled.
    csP|rBt|�dkr�|d>qLt|���}�tdd�|D��>n
�t�>dS)Nr�rcss|]}t|�VqdSr�)r�r�Zttryryrzr��szDmatchPreviousLiteral.<locals>.copyTokenToRepeater.<locals>.<genexpr>)r�r�r�rr)r�r[rxZtflat�Zrepryrz�copyTokenToRepeater�sz1matchPreviousLiteral.<locals>.copyTokenToRepeaterTr��(prev) )rr�r�r�)rSr�ryr�rzrQ�s


csFt��|��}�|K��fdd�}|j|dd���dt|���S)aS
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
    the expressions are evaluated first, and then compared, so
    C{"1"} is compared with C{"10"}.
    Do I{not} use with packrat parsing enabled.
    cs*t|�����fdd�}�j|dd�dS)Ncs$t|���}|�kr tddd��dS)Nr�r)r�r�r!)r�r[rxZtheseTokens�ZmatchTokensryrz�mustMatchTheseTokens�szLmatchPreviousExpr.<locals>.copyTokenToRepeater.<locals>.mustMatchTheseTokensTr�)r�r�r�)r�r[rxr�r�r�rzr��sz.matchPreviousExpr.<locals>.copyTokenToRepeaterTr�r�)rr�r�r�r�)rSZe2r�ryr�rzrP�scCs:dD]}|�|t|�}q|�dd�}|�dd�}t|�S)Nz\^-]r2r'r~r�)r��_bslashr�)r�r�ryryrzrY�s
rYTc
s�|rdd�}dd�}t�ndd�}dd�}t�g}t|t�rF|��}n$t|t�rZt|�}ntjdt	dd�|stt
�Sd	}|t|�d
k�r||}t||d
d��D]R\}}	||	|�r�|||d
=qxq�|||	�r�|||d
=|�
||	�|	}qxq�|d
7}qx|�s�|�r�zlt|�td�|��k�rTtd
d�dd�|D����d�|��WStd�dd�|D����d�|��WSWn&tk
�r�tjdt	dd�YnXt�fdd�|D���d�|��S)a�
    Helper to quickly define a set of alternative Literals, and makes sure to do
    longest-first testing when there is a conflict, regardless of the input order,
    but returns a C{L{MatchFirst}} for best performance.

    Parameters:
     - strs - a string of space-delimited literals, or a collection of string literals
     - caseless - (default=C{False}) - treat all literals as caseless
     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
          if creating a C{Regex} raises an exception)

    Example::
        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
    prints::
        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    cSs|��|��kSr�)r@�r�bryryrzr{�r|zoneOf.<locals>.<lambda>cSs|���|���Sr�)r@r<r�ryryrzr{�r|cSs||kSr�ryr�ryryrzr{�r|cSs
|�|�Sr�)r<r�ryryrzr{�r|z6Invalid argument to oneOf, expected string or iterablersr�rr�Nr�z[%s]css|]}t|�VqdSr�)rY�r�Zsymryryrzr�szoneOf.<locals>.<genexpr>r��|css|]}t�|�VqdSr�)r�r[r�ryryrzr�sz7Exception creating Regex for oneOf, building MatchFirstc3s|]}�|�VqdSr�ryr��ZparseElementClassryrzr�$s)r
rr}r�r�rr�r�r�r�rr�r�rr�r)r�rpr)
Zstrsr?ZuseRegexZisequalZmasksZsymbolsr�Zcurr�rryr�rzrU�sT



�


**�cCsttt||���S)a�
    Helper to easily and clearly define a dictionary by specifying the respective patterns
    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
    in the proper order.  The key pattern can include delimiting markers or punctuation,
    as long as they are suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the C{Dict} results can include named token
    fields.

    Example::
        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())
    prints::
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    )r
r4r)rr�ryryrzrC&s!cCs^t��dd��}|��}d|_|d�||d�}|r@dd�}ndd�}|�|�|j|_|S)	a�
    Helper to return the original, untokenized text for a given expression.  Useful to
    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
    revert separate tokens with intervening whitespace back to the original matching
    input text. By default, returns astring containing the original parsed text.  
       
    If the optional C{asString} argument is passed as C{False}, then the return value is a 
    C{L{ParseResults}} containing any results names that were originally matched, and a 
    single token containing the original matched text from the input string.  So if 
    the expression passed to C{L{originalTextFor}} contains expressions with defined
    results names, you must set C{asString} to C{False} if you want to preserve those
    results name values.

    Example::
        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b","i"):
            opener,closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])
    prints::
        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    cSs|Sr�ry)r�r�rxryryrzr{ar|z!originalTextFor.<locals>.<lambda>F�_original_start�
_original_endcSs||j|j�Sr�)r�r�rZryryrzr{fr|cSs&||�d�|�d��g|dd�<dS)Nr�r�)rrZryryrz�extractTexthsz$originalTextFor.<locals>.extractText)rr�r�r�r�)rSZasStringZ	locMarkerZendlocMarker�	matchExprr�ryryrzriIs

cCst|��dd��S)zp
    Helper to undo pyparsing's default grouping of And expressions, even
    if all but one are non-empty.
    cSs|dSr�ryrwryryrzr{sr|zungroup.<locals>.<lambda>)r/r�)rSryryrzrjnscCs4t��dd��}t|d�|d�|����d��S)a�
    Helper to decorate a returned token with its starting and ending locations in the input string.
    This helper adds the following results names:
     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains C{<TAB>} characters, you may want to call
    C{L{ParserElement.parseWithTabs}}

    Example::
        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)
    prints::
        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    cSs|Sr�ryrZryryrzr{�r|zlocatedExpr.<locals>.<lambda>Z
locn_startr�Zlocn_end)rr�rr�r)rSZlocatorryryrzrlusz\[]-*.$+^?()~ �r_cCs|ddSr�ryrZryryrzr{�r|r{z\\0?[xX][0-9a-fA-F]+cCstt|d�d�d��S)Nrz\0x�)�unichrrv�lstriprZryryrzr{�r|z	\\0[0-7]+cCstt|ddd�d��S)Nrr��)r�rvrZryryrzr{�r|z\]r�r$r)�negate�bodyr'csFdd��z"d��fdd�t�|�jD��WStk
r@YdSXdS)a�
    Helper to easily define string ranges for use in Word construction.  Borrows
    syntax from regexp '[]' string range definitions::
        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
    The input string must be enclosed in []'s, and the returned string is the expanded
    character set joined into a single string.
    The values enclosed in the []'s may be:
     - a single character
     - an escaped character with a leading backslash (such as C{\-} or C{\]})
     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
         (C{\0x##} is also supported for backwards compatibility) 
     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
    cSs<t|t�s|Sd�dd�tt|d�t|d�d�D��S)Nr�css|]}t|�VqdSr�)r�r�ryryrzr��sz+srange.<locals>.<lambda>.<locals>.<genexpr>rr�)r}r$r�r��ord)�pryryrzr{�r|zsrange.<locals>.<lambda>r�c3s|]}�|�VqdSr�ry)r��part�Z	_expandedryrzr��szsrange.<locals>.<genexpr>N)r��_reBracketExprr�r�rprdryr�rzra�s
"cs�fdd�}|S)zt
    Helper method for defining parse actions that require matching at a specific
    column in the input text.
    cs"t||��krt||d���dS)Nzmatched token not at column %dr�)rNZlocnrVr�ryrz�	verifyCol�sz!matchOnlyAtCol.<locals>.verifyColry)r�r�ryr�rzrO�scs�fdd�S)a�
    Helper method for common parse actions that simply return a literal value.  Especially
    useful when used with C{L{transformString<ParserElement.transformString>}()}.

    Example::
        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num
        
        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    cs�gSr�ryrZ�ZreplStrryrzr{�r|zreplaceWith.<locals>.<lambda>ryr�ryr�rzr^�scCs|ddd�S)a
    Helper parse action for removing quotation marks from parsed quoted strings.

    Example::
        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    rr�rtryrZryryrzr\�scsN��fdd�}zt�dt�d�j�}Wntk
rBt��}YnX||_|S)aG
    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
    args are passed, they are forwarded to the given function as additional arguments after
    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
    parsed data to an integer using base 16.

    Example (compare the last to example in L{ParserElement.transformString}::
        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')
        
        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')
    prints::
        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    cs��fdd�|D�S)Ncsg|]}�|f����qSryry)r�Ztokn�r�r\ryrzr��sz(tokenMap.<locals>.pa.<locals>.<listcomp>ryrZr�ryrzr��sztokenMap.<locals>.par�rm)ror�rpr~)r\r�r�rqryr�rzro�s 
�cCst|���Sr��r�r@rwryryrzr{r|cCst|���Sr��r��lowerrwryryrzr{r|c	Cs�t|t�r|}t||d�}n|j}tttd�}|r�t���	t
�}td�|d�tt
t|td�|���tddgd��d	��	d
d��td�}n�d
�dd�tD��}t���	t
�t|�B}td�|d�tt
t|�	t�ttd�|����tddgd��d	��	dd��td�}ttd�|d�}|�dd
�|�dd��������d|�}|�dd
�|�dd��������d|�}||_||_||fS)zRInternal helper to construct opening and closing tag expressions, given a tag namerEz_-:r5�tag�=�/F�rrEcSs|ddkS�Nrr�ryrZryryrzr{r|z_makeTags.<locals>.<lambda>r6r�css|]}|dkr|VqdS)r6Nryr�ryryrzr�sz_makeTags.<locals>.<genexpr>cSs|ddkSr�ryrZryryrzr{r|r7rJ�:r(z<%s>r`z</%s>)r}r�rr�r1r6r5r@r�r�r\r-r
r4rrr�r�rXr[rDr�_Lr��titler�r�r�)�tagStrZxmlZresnameZtagAttrNameZtagAttrValueZopenTagZprintablesLessRAbrackZcloseTagryryrz�	_makeTagss>
�������..rcCs
t|d�S)a 
    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.

    Example::
        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
        a,a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end
        
        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
            print(link.link_text, '->', link.href)
    prints::
        pyparsing -> http://pyparsing.wikispaces.com
    F�r�r�ryryrzrM(scCs
t|d�S)z�
    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
    tags only in the given upper/lower case.

    Example: similar to L{makeHTMLTags}
    TrrryryrzrN;scs8|r|dd��n|���dd��D���fdd�}|S)a<
    Helper to create a validating parse action to be used with start tags created
    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
    with a required attribute value, to avoid false matches on common tags such as
    C{<TD>} or C{<DIV>}.

    Call C{withAttribute} with a series of attribute names and values. Specify the list
    of filter attributes names and values as:
     - keyword arguments, as in C{(align="right")}, or
     - as an explicit dict with C{**} operator, when an attribute name is also a Python
          reserved word, as in C{**{"class":"Customer", "align":"right"}}
     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
    For attribute names with a namespace prefix, you must use the second form.  Attribute
    names are matched insensitive to upper/lower case.
       
    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.

    To verify that the attribute exists, but without specifying a value, pass
    C{withAttribute.ANY_VALUE} as the value.

    Example::
        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    NcSsg|]\}}||f�qSryryr/ryryrzr�zsz!withAttribute.<locals>.<listcomp>csZ�D]P\}}||kr$t||d|��|tjkr|||krt||d||||f��qdS)Nzno matching attribute z+attribute '%s' has value '%s', must be '%s')r!rg�	ANY_VALUE)r�r[r�ZattrNameZ	attrValue�Zattrsryrzr�{s�zwithAttribute.<locals>.pa)r�)r�ZattrDictr�ryrrzrgDs2cCs|rd|nd}tf||i�S)a�
    Simplified version of C{L{withAttribute}} when matching on a div class - made
    difficult because C{class} is a reserved word in Python.

    Example::
        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))
        
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    z%s:class�class)rg)Z	classname�	namespaceZ	classattrryryrzrm�s �(rpcCs�t�}||||B}t|�D�]l\}}|ddd�\}}	}
}|	dkrPd|nd|}|	dkr�|dkstt|�dkr|td��|\}
}t��|�}|
tjk�r^|	d	kr�t||�t|t	|��}n�|	dk�r|dk	r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�rTt||
|||�t||
|||�}ntd
��n�|
tj
k�rB|	d	k�r�t|t��s�t|�}t|j
|�t||�}n�|	dk�r�|dk	�r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�r8t||
|||�t||
|||�}ntd
��ntd��|�rvt|ttf��rl|j|�n
|�|�||�|�|BK}|}q||K}|S)aD

    Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary or
    binary, left- or right-associative.  Parse actions can also be attached
    to operator expressions. The generated parser will also recognize the use 
    of parentheses to override operator precedences (see example below).
    
    Note: if you define a deep operator list, you may see performance issues
    when using infixNotation. See L{ParserElement.enablePackrat} for a
    mechanism to potentially improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the nested
     - opList - list of tuples, one for each operator precedence level in the
      expression grammar; each tuple is of the form
      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
       - opExpr is the pyparsing expression for the operator;
          may also be a string, which will be converted to a Literal;
          if numTerms is 3, opExpr is a tuple of two expressions, for the
          two operators separating the 3 terms
       - numTerms is the number of terms for this operator (must
          be 1, 2, or 3)
       - rightLeftAssoc is the indicator whether the operator is
          right or left associative, using the pyparsing-defined
          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
       - parseAction is the parse action to be associated with
          expressions matching this operator expression (the
          parse action tuple member may be omitted); if the parse action
          is passed a tuple or list of functions, this is equivalent to
          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})

    Example::
        # simple example of four-function arithmetic with ints and variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier 
        
        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])
        
        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)
    prints::
        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    r�Nrbrqz%s termz	%s%s termrsz@if numterms=3, opExpr must be a tuple or list of two expressionsr�z6operator must be unary (1), binary (2), or ternary (3)z2operator must indicate right or left associativity)rr�r�r�r�rV�LEFTrrr�RIGHTr}rrSr�r�r�)ZbaseExprZopListZlparZrparr�ZlastExprr�ZoperDefZopExprZarityZrightLeftAssocr�ZtermNameZopExpr1ZopExpr2ZthisExprr�ryryrzrk�sZ=
&
�



&
�

z4"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�"z string enclosed in double quotesz4'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�'z string enclosed in single quotesz*quotedString using single or double quotes�uzunicode string literalcCs�||krtd��|dk�r*t|t��r"t|t��r"t|�dkr�t|�dkr�|dk	r�tt|t||tjdd����	dd��}n$t
��t||tj��	dd��}nx|dk	r�tt|t|�t|�ttjdd����	dd��}n4ttt|�t|�ttjdd����	d	d��}ntd
��t
�}|dk	�rd|tt|�t||B|B�t|��K}n$|tt|�t||B�t|��K}|�d||f�|S)a~	
    Helper method for defining nested lists enclosed in opening and closing
    delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
     - content - expression for items within the nested lists (default=C{None})
     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})

    If an expression is not provided for the content argument, the nested
    expression will capture all whitespace-delimited content between delimiters
    as a list of separate values.

    Use the C{ignoreExpr} argument to define expressions that may contain
    opening or closing characters that should not be treated as opening
    or closing characters for nesting, such as quotedString or a comment
    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
    The default is L{quotedString}, but if no expressions are to be ignored,
    then pass C{None} for this argument.

    Example::
        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR,RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type") 
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
                      + code_body("body"))
        c_function.ignore(cStyleComment)
        
        source_code = '''
            int is_odd(int x) { 
                return (x%2); 
            }
                
            int dec_to_hex(char hchar) { 
                if (hchar >= '0' && hchar <= '9') { 
                    return (ord(hchar)-ord('0')); 
                } else { 
                    return (10+ord(hchar)-ord('A'));
                } 
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)

    prints::
        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    z.opening and closing strings cannot be the sameNr�r�cSs|d��Sr��r�rwryryrzr{gr|znestedExpr.<locals>.<lambda>cSs|d��Sr�r
rwryryrzr{jr|cSs|d��Sr�r
rwryryrzr{pr|cSs|d��Sr�r
rwryryrzr{tr|zOopening and closing arguments must be strings if no content expression is givenznested %s%s expression)r�r}r�r�rrrr&rsr�rEr�rrrr-r4r�)ZopenerZcloserZcontentr�r�ryryrzrR%sH:
���������
*$cs��fdd�}�fdd�}�fdd�}tt��d����}t�t��|��d�}t��|��d	�}t��|��d
�}	|r�tt|�|t|t|�t|��|	�}
n$tt|�t|t|�t|���}
|�	t
t��|
�d�S)a
	
    Helper method for defining space-delimited indentation blocks, such as
    those used to define block statements in Python source code.

    Parameters:
     - blockStatementExpr - expression defining syntax of statement that
            is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
            (multiple statementWithIndentedBlock expressions within a single grammar
            should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond the
            the current level; set to False for block of left-most statements
            (default=C{True})

    A valid block must contain at least one C{blockStatement}.

    Example::
        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group( funcDecl + func_body )

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << ( funcDef | assignment | identifier )

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()
    prints::
        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
    csN|t|�krdSt||�}|�dkrJ|�dkr>t||d��t||d��dS)Nrtzillegal nestingznot a peer entry)r�r;r#r!�r�r[rxZcurCol��indentStackryrz�checkPeerIndent�s
z&indentedBlock.<locals>.checkPeerIndentcs2t||�}|�dkr"��|�nt||d��dS)Nrtznot a subentry)r;rr!rrryrz�checkSubIndent�s
z%indentedBlock.<locals>.checkSubIndentcsN|t|�krdSt||�}�r6|�dkr6|�dksBt||d�����dS)Nrtr_znot an unindent)r�r;r!rrrryrz�
checkUnindent�s
z$indentedBlock.<locals>.checkUnindentz	 �INDENTr�ZUNINDENTzindented block)rrr
r
rr�r�rrrr�)ZblockStatementExprrr9rrrrErZPEERZUNDENTZsmExprryrrzrhs(N����z#[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]z[\0xa1-\0xbf\0xd7\0xf7]z_:zany tagzgt lt amp nbsp quot aposz><& "'z&(?P<entity>r�z);zcommon HTML entitycCst�|j�S)zRHelper parser action to replace common HTML entities with their special characters)�_htmlEntityMapr�Zentityrwryryrzr]�sz/\*(?:[^*]|\*(?!/))*z*/zC style commentz<!--[\s\S]*?-->zHTML commentz.*zrest of linez//(?:\\\n|[^\n])*z
// commentzC++ style commentz#.*zPython style commentrO� 	�	commaItemr�c@s�eZdZdZee�Zee�Ze	e
��d��e�Z
e	e��d��eed��Zed��d��e�Ze��e�de��e��d�Ze�d	d
��eeeed���e�B�d�Ze�e�ed
��d��e�Zed��d��e�ZeeBeB��Zed��d��e�Ze	eded��d�Zed��d�Z ed��d�Z!e!de!d�d�Z"ee!de!d�dee!de!d��d�Z#e#�$dd
��d e �d!�Z%e&e"e%Be#B�d"���d"�Z'ed#��d$�Z(e)d=d&d'��Z*e)d>d)d*��Z+ed+��d,�Z,ed-��d.�Z-ed/��d0�Z.e/��e0��BZ1e)d1d2��Z2e&e3e4d3�e5�e	e6d3d4�ee7d5�������d6�Z8e9ee:�;�e8Bd7d8���d9�Z<e)ed:d
���Z=e)ed;d
���Z>d<S)?rpa�

    Here are some common low-level expressions that may be useful in jump-starting parser development:
     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
     - common L{programming identifiers<identifier>}
     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
     - L{UUID<uuid>}
     - L{comma-separated list<comma_separated_list>}
    Parse actions:
     - C{L{convertToInteger}}
     - C{L{convertToFloat}}
     - C{L{convertToDate}}
     - C{L{convertToDatetime}}
     - C{L{stripHTMLTags}}
     - C{L{upcaseTokens}}
     - C{L{downcaseTokens}}

    Example::
        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')
    prints::
        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    �integerzhex integerr�z[+-]?\d+zsigned integerr��fractioncCs|d|dS)Nrrtryrwryryrzr{�r|zpyparsing_common.<lambda>r�z"fraction or mixed integer-fractionz
[+-]?\d+\.\d*zreal numberz+[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)z$real number with scientific notationz[+-]?\d+\.?\d*([eE][+-]?\d+)?�fnumberr��
identifierzK(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}zIPv4 addressz[0-9a-fA-F]{1,4}�hex_integerr��zfull IPv6 address)rrhz::zshort IPv6 addresscCstdd�|D��dkS)Ncss|]}tj�|�rdVqdSr3)rp�
_ipv6_partr�r�ryryrzr��sz,pyparsing_common.<lambda>.<locals>.<genexpr>r�)r�rwryryrzr{�r|z::ffff:zmixed IPv6 addresszIPv6 addressz:[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}zMAC address�%Y-%m-%dcs�fdd�}|S)a�
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})

        Example::
            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))
        prints::
            [datetime.date(1999, 12, 31)]
        c
sNzt�|d����WStk
rH}zt||t|���W5d}~XYnXdSr�)r�strptime�dater�r!r~�r�r[rxZve��fmtryrz�cvt_fn�sz.pyparsing_common.convertToDate.<locals>.cvt_fnry�r$r%ryr#rz�
convertToDate�szpyparsing_common.convertToDate�%Y-%m-%dT%H:%M:%S.%fcs�fdd�}|S)a
        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})

        Example::
            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
        prints::
            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        c
sJzt�|d��WStk
rD}zt||t|���W5d}~XYnXdSr�)rr r�r!r~r"r#ryrzr%�sz2pyparsing_common.convertToDatetime.<locals>.cvt_fnryr&ryr#rz�convertToDatetime�sz"pyparsing_common.convertToDatetimez7(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?zISO8601 datez�(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?zISO8601 datetimez2[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}�UUIDcCstj�|d�S)a
        Parse action to remove HTML tags from web page HTML source

        Example::
            # strip HTML links from normal text 
            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
            td,td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            
            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
        r)rp�_html_stripperr�)r�r[r�ryryrz�
stripHTMLTagss
zpyparsing_common.stripHTMLTagsr�rOrrr�r�zcomma separated listcCst|���Sr�r�rwryryrzr{"r|cCst|���Sr�r�rwryryrzr{%r|N)r)r()?r�r�r�r�rorvZconvertToInteger�floatZconvertToFloatr1rTr�r�rrFrr)Zsigned_integerrr�rr
Z
mixed_integerr��realZsci_realr��numberrr6r5rZipv4_addressrZ_full_ipv6_addressZ_short_ipv6_addressr�Z_mixed_ipv6_addressrZipv6_addressZmac_addressr/r'r)Ziso8601_dateZiso8601_datetime�uuidr9r8r+r,rrrrXr0�
_commasepitemrBr[r�Zcomma_separated_listrfrDryryryrzrpsV""
2
 
���__main__Zselect�fromr=r�)r��columnsr�ZtablesZcommandaK
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        z]
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        z 
        100
        FF
        z6
        12345678-1234-5678-1234-567812345678
        )rs)r�F)N)FT)T)r�)T)�r��__version__Z__versionTime__�
__author__r��weakrefrr�r�r�r�r�rjr�rFrcr�r�_threadr�ImportErrorZ	threadingZcollections.abcrrrr�Zordereddict�__all__r��version_inforbr0�maxsizer0r~r��chrr�r�r�r�r@�reversedr�r�rBr�r]r^rnZmaxintZxranger�Z__builtin__r�Zfnamerror�r�r�r�r�r�Zascii_uppercaseZascii_lowercaser6rTrFr5r�r�Z	printablerXrprr!r#r%r(r�r$�registerr;rLrIrTrWrYrSrrr&r.rrrr�rwrr
r	rnr1r)r'rr0r�rrrr,r+r3r2r"rrrrr rrr�rr4r�r�rr*rr�r/rrr
r-rrdrBr>r�rQrPrYrUrCrirjrlr�rErKrJrcrbr�Z_escapedPuncZ_escapedHexCharZ_escapedOctCharZ_singleCharZ
_charRanger�r�rarOr^r\rorfrDrrMrNrgrrmrVrr	rkrWr@r`r[rerRrhr7rYr9r8r�r�rrr=r]r:rGrr_rAr?rHrZr�r1r<rpr�ZselectTokenZ	fromTokenZidentZ
columnNameZcolumnNameListZ
columnSpecZ	tableNameZ
tableNameListZ	simpleSQLr.r/rrr0r*ryryryrz�<module>s��4�
8



@v&A= I
G3pLOD|M &#@sQ,A,	I#%0
,	?#p
��Zr

 (
 
���� 


"
	site-packages/pkg_resources/_vendor/__pycache__/__init__.cpython-38.pyc000064400000000235151446177000022177 0ustar00U

�Qab�@sdS)N�rrr�B/usr/lib/python3.8/site-packages/pkg_resources/_vendor/__init__.py�<module>�site-packages/pkg_resources/_vendor/__init__.py000064400000000000151446177000015677 0ustar00site-packages/pkg_resources/_vendor/appdirs.py000064400000060147151446177000015624 0ustar00# -*- coding: utf-8 -*-
# Copyright (c) 2005-2010 ActiveState Software Inc.
# Copyright (c) 2013 Eddy Petrișor

"""Utilities for determining application-specific dirs.

See <http://github.com/ActiveState/appdirs> for details and usage.
"""
# Dev Notes:
# - MSDN on where to store app data files:
#   http://support.microsoft.com/default.aspx?scid=kb;en-us;310294#XSLTH3194121123120121120120
# - Mac OS X: http://developer.apple.com/documentation/MacOSX/Conceptual/BPFileSystem/index.html
# - XDG spec for Un*x: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html

__version_info__ = (1, 4, 3)
__version__ = '.'.join(map(str, __version_info__))


import sys
import os

PY3 = sys.version_info[0] == 3

if PY3:
    unicode = str

if sys.platform.startswith('java'):
    import platform
    os_name = platform.java_ver()[3][0]
    if os_name.startswith('Windows'): # "Windows XP", "Windows 7", etc.
        system = 'win32'
    elif os_name.startswith('Mac'): # "Mac OS X", etc.
        system = 'darwin'
    else: # "Linux", "SunOS", "FreeBSD", etc.
        # Setting this to "linux2" is not ideal, but only Windows or Mac
        # are actually checked for and the rest of the module expects
        # *sys.platform* style strings.
        system = 'linux2'
else:
    system = sys.platform



def user_data_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user data directories are:
        Mac OS X:               ~/Library/Application Support/<AppName>
        Unix:                   ~/.local/share/<AppName>    # or in $XDG_DATA_HOME, if defined
        Win XP (not roaming):   C:\Documents and Settings\<username>\Application Data\<AppAuthor>\<AppName>
        Win XP (roaming):       C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>
        Win 7  (not roaming):   C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>
        Win 7  (roaming):       C:\Users\<username>\AppData\Roaming\<AppAuthor>\<AppName>

    For Unix, we follow the XDG spec and support $XDG_DATA_HOME.
    That means, by default "~/.local/share/<AppName>".
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        const = roaming and "CSIDL_APPDATA" or "CSIDL_LOCAL_APPDATA"
        path = os.path.normpath(_get_win_folder(const))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
    elif system == 'darwin':
        path = os.path.expanduser('~/Library/Application Support/')
        if appname:
            path = os.path.join(path, appname)
    else:
        path = os.getenv('XDG_DATA_HOME', os.path.expanduser("~/.local/share"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def site_data_dir(appname=None, appauthor=None, version=None, multipath=False):
    r"""Return full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of data dirs should be
            returned. By default, the first item from XDG_DATA_DIRS is
            returned, or '/usr/local/share/<AppName>',
            if XDG_DATA_DIRS is not set

    Typical site data directories are:
        Mac OS X:   /Library/Application Support/<AppName>
        Unix:       /usr/local/share/<AppName> or /usr/share/<AppName>
        Win XP:     C:\Documents and Settings\All Users\Application Data\<AppAuthor>\<AppName>
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)
        Win 7:      C:\ProgramData\<AppAuthor>\<AppName>   # Hidden, but writeable on Win 7.

    For Unix, this is using the $XDG_DATA_DIRS[0] default.

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        path = os.path.normpath(_get_win_folder("CSIDL_COMMON_APPDATA"))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
    elif system == 'darwin':
        path = os.path.expanduser('/Library/Application Support')
        if appname:
            path = os.path.join(path, appname)
    else:
        # XDG default for $XDG_DATA_DIRS
        # only first, if multipath is False
        path = os.getenv('XDG_DATA_DIRS',
                         os.pathsep.join(['/usr/local/share', '/usr/share']))
        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
        if appname:
            if version:
                appname = os.path.join(appname, version)
            pathlist = [os.sep.join([x, appname]) for x in pathlist]

        if multipath:
            path = os.pathsep.join(pathlist)
        else:
            path = pathlist[0]
        return path

    if appname and version:
        path = os.path.join(path, version)
    return path


def user_config_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific config dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user config directories are:
        Mac OS X:               same as user_data_dir
        Unix:                   ~/.config/<AppName>     # or in $XDG_CONFIG_HOME, if defined
        Win *:                  same as user_data_dir

    For Unix, we follow the XDG spec and support $XDG_CONFIG_HOME.
    That means, by default "~/.config/<AppName>".
    """
    if system in ["win32", "darwin"]:
        path = user_data_dir(appname, appauthor, None, roaming)
    else:
        path = os.getenv('XDG_CONFIG_HOME', os.path.expanduser("~/.config"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def site_config_dir(appname=None, appauthor=None, version=None, multipath=False):
    r"""Return full path to the user-shared data dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "multipath" is an optional parameter only applicable to *nix
            which indicates that the entire list of config dirs should be
            returned. By default, the first item from XDG_CONFIG_DIRS is
            returned, or '/etc/xdg/<AppName>', if XDG_CONFIG_DIRS is not set

    Typical site config directories are:
        Mac OS X:   same as site_data_dir
        Unix:       /etc/xdg/<AppName> or $XDG_CONFIG_DIRS[i]/<AppName> for each value in
                    $XDG_CONFIG_DIRS
        Win *:      same as site_data_dir
        Vista:      (Fail! "C:\ProgramData" is a hidden *system* directory on Vista.)

    For Unix, this is using the $XDG_CONFIG_DIRS[0] default, if multipath=False

    WARNING: Do not use this on Windows. See the Vista-Fail note above for why.
    """
    if system in ["win32", "darwin"]:
        path = site_data_dir(appname, appauthor)
        if appname and version:
            path = os.path.join(path, version)
    else:
        # XDG default for $XDG_CONFIG_DIRS
        # only first, if multipath is False
        path = os.getenv('XDG_CONFIG_DIRS', '/etc/xdg')
        pathlist = [os.path.expanduser(x.rstrip(os.sep)) for x in path.split(os.pathsep)]
        if appname:
            if version:
                appname = os.path.join(appname, version)
            pathlist = [os.sep.join([x, appname]) for x in pathlist]

        if multipath:
            path = os.pathsep.join(pathlist)
        else:
            path = pathlist[0]
    return path


def user_cache_dir(appname=None, appauthor=None, version=None, opinion=True):
    r"""Return full path to the user-specific cache dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Cache" to the base app data dir for Windows. See
            discussion below.

    Typical user cache directories are:
        Mac OS X:   ~/Library/Caches/<AppName>
        Unix:       ~/.cache/<AppName> (XDG default)
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Cache
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Cache

    On Windows the only suggestion in the MSDN docs is that local settings go in
    the `CSIDL_LOCAL_APPDATA` directory. This is identical to the non-roaming
    app data dir (the default returned by `user_data_dir` above). Apps typically
    put cache data somewhere *under* the given dir here. Some examples:
        ...\Mozilla\Firefox\Profiles\<ProfileName>\Cache
        ...\Acme\SuperApp\Cache\1.0
    OPINION: This function appends "Cache" to the `CSIDL_LOCAL_APPDATA` value.
    This can be disabled with the `opinion=False` option.
    """
    if system == "win32":
        if appauthor is None:
            appauthor = appname
        path = os.path.normpath(_get_win_folder("CSIDL_LOCAL_APPDATA"))
        if appname:
            if appauthor is not False:
                path = os.path.join(path, appauthor, appname)
            else:
                path = os.path.join(path, appname)
            if opinion:
                path = os.path.join(path, "Cache")
    elif system == 'darwin':
        path = os.path.expanduser('~/Library/Caches')
        if appname:
            path = os.path.join(path, appname)
    else:
        path = os.getenv('XDG_CACHE_HOME', os.path.expanduser('~/.cache'))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def user_state_dir(appname=None, appauthor=None, version=None, roaming=False):
    r"""Return full path to the user-specific state dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "roaming" (boolean, default False) can be set True to use the Windows
            roaming appdata directory. That means that for users on a Windows
            network setup for roaming profiles, this user data will be
            sync'd on login. See
            <http://technet.microsoft.com/en-us/library/cc766489(WS.10).aspx>
            for a discussion of issues.

    Typical user state directories are:
        Mac OS X:  same as user_data_dir
        Unix:      ~/.local/state/<AppName>   # or in $XDG_STATE_HOME, if defined
        Win *:     same as user_data_dir

    For Unix, we follow this Debian proposal <https://wiki.debian.org/XDGBaseDirectorySpecification#state>
    to extend the XDG spec and support $XDG_STATE_HOME.

    That means, by default "~/.local/state/<AppName>".
    """
    if system in ["win32", "darwin"]:
        path = user_data_dir(appname, appauthor, None, roaming)
    else:
        path = os.getenv('XDG_STATE_HOME', os.path.expanduser("~/.local/state"))
        if appname:
            path = os.path.join(path, appname)
    if appname and version:
        path = os.path.join(path, version)
    return path


def user_log_dir(appname=None, appauthor=None, version=None, opinion=True):
    r"""Return full path to the user-specific log dir for this application.

        "appname" is the name of application.
            If None, just the system directory is returned.
        "appauthor" (only used on Windows) is the name of the
            appauthor or distributing body for this application. Typically
            it is the owning company name. This falls back to appname. You may
            pass False to disable it.
        "version" is an optional version path element to append to the
            path. You might want to use this if you want multiple versions
            of your app to be able to run independently. If used, this
            would typically be "<major>.<minor>".
            Only applied when appname is present.
        "opinion" (boolean) can be False to disable the appending of
            "Logs" to the base app data dir for Windows, and "log" to the
            base cache dir for Unix. See discussion below.

    Typical user log directories are:
        Mac OS X:   ~/Library/Logs/<AppName>
        Unix:       ~/.cache/<AppName>/log  # or under $XDG_CACHE_HOME if defined
        Win XP:     C:\Documents and Settings\<username>\Local Settings\Application Data\<AppAuthor>\<AppName>\Logs
        Vista:      C:\Users\<username>\AppData\Local\<AppAuthor>\<AppName>\Logs

    On Windows the only suggestion in the MSDN docs is that local settings
    go in the `CSIDL_LOCAL_APPDATA` directory. (Note: I'm interested in
    examples of what some windows apps use for a logs dir.)

    OPINION: This function appends "Logs" to the `CSIDL_LOCAL_APPDATA`
    value for Windows and appends "log" to the user cache dir for Unix.
    This can be disabled with the `opinion=False` option.
    """
    if system == "darwin":
        path = os.path.join(
            os.path.expanduser('~/Library/Logs'),
            appname)
    elif system == "win32":
        path = user_data_dir(appname, appauthor, version)
        version = False
        if opinion:
            path = os.path.join(path, "Logs")
    else:
        path = user_cache_dir(appname, appauthor, version)
        version = False
        if opinion:
            path = os.path.join(path, "log")
    if appname and version:
        path = os.path.join(path, version)
    return path


class AppDirs(object):
    """Convenience wrapper for getting application dirs."""
    def __init__(self, appname=None, appauthor=None, version=None,
            roaming=False, multipath=False):
        self.appname = appname
        self.appauthor = appauthor
        self.version = version
        self.roaming = roaming
        self.multipath = multipath

    @property
    def user_data_dir(self):
        return user_data_dir(self.appname, self.appauthor,
                             version=self.version, roaming=self.roaming)

    @property
    def site_data_dir(self):
        return site_data_dir(self.appname, self.appauthor,
                             version=self.version, multipath=self.multipath)

    @property
    def user_config_dir(self):
        return user_config_dir(self.appname, self.appauthor,
                               version=self.version, roaming=self.roaming)

    @property
    def site_config_dir(self):
        return site_config_dir(self.appname, self.appauthor,
                             version=self.version, multipath=self.multipath)

    @property
    def user_cache_dir(self):
        return user_cache_dir(self.appname, self.appauthor,
                              version=self.version)

    @property
    def user_state_dir(self):
        return user_state_dir(self.appname, self.appauthor,
                              version=self.version)

    @property
    def user_log_dir(self):
        return user_log_dir(self.appname, self.appauthor,
                            version=self.version)


#---- internal support stuff

def _get_win_folder_from_registry(csidl_name):
    """This is a fallback technique at best. I'm not sure if using the
    registry for this guarantees us the correct answer for all CSIDL_*
    names.
    """
    if PY3:
      import winreg as _winreg
    else:
      import _winreg

    shell_folder_name = {
        "CSIDL_APPDATA": "AppData",
        "CSIDL_COMMON_APPDATA": "Common AppData",
        "CSIDL_LOCAL_APPDATA": "Local AppData",
    }[csidl_name]

    key = _winreg.OpenKey(
        _winreg.HKEY_CURRENT_USER,
        r"Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders"
    )
    dir, type = _winreg.QueryValueEx(key, shell_folder_name)
    return dir


def _get_win_folder_with_pywin32(csidl_name):
    from win32com.shell import shellcon, shell
    dir = shell.SHGetFolderPath(0, getattr(shellcon, csidl_name), 0, 0)
    # Try to make this a unicode path because SHGetFolderPath does
    # not return unicode strings when there is unicode data in the
    # path.
    try:
        dir = unicode(dir)

        # Downgrade to short path name if have highbit chars. See
        # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
        has_high_char = False
        for c in dir:
            if ord(c) > 255:
                has_high_char = True
                break
        if has_high_char:
            try:
                import win32api
                dir = win32api.GetShortPathName(dir)
            except ImportError:
                pass
    except UnicodeError:
        pass
    return dir


def _get_win_folder_with_ctypes(csidl_name):
    import ctypes

    csidl_const = {
        "CSIDL_APPDATA": 26,
        "CSIDL_COMMON_APPDATA": 35,
        "CSIDL_LOCAL_APPDATA": 28,
    }[csidl_name]

    buf = ctypes.create_unicode_buffer(1024)
    ctypes.windll.shell32.SHGetFolderPathW(None, csidl_const, None, 0, buf)

    # Downgrade to short path name if have highbit chars. See
    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
    has_high_char = False
    for c in buf:
        if ord(c) > 255:
            has_high_char = True
            break
    if has_high_char:
        buf2 = ctypes.create_unicode_buffer(1024)
        if ctypes.windll.kernel32.GetShortPathNameW(buf.value, buf2, 1024):
            buf = buf2

    return buf.value

def _get_win_folder_with_jna(csidl_name):
    import array
    from com.sun import jna
    from com.sun.jna.platform import win32

    buf_size = win32.WinDef.MAX_PATH * 2
    buf = array.zeros('c', buf_size)
    shell = win32.Shell32.INSTANCE
    shell.SHGetFolderPath(None, getattr(win32.ShlObj, csidl_name), None, win32.ShlObj.SHGFP_TYPE_CURRENT, buf)
    dir = jna.Native.toString(buf.tostring()).rstrip("\0")

    # Downgrade to short path name if have highbit chars. See
    # <http://bugs.activestate.com/show_bug.cgi?id=85099>.
    has_high_char = False
    for c in dir:
        if ord(c) > 255:
            has_high_char = True
            break
    if has_high_char:
        buf = array.zeros('c', buf_size)
        kernel = win32.Kernel32.INSTANCE
        if kernel.GetShortPathName(dir, buf, buf_size):
            dir = jna.Native.toString(buf.tostring()).rstrip("\0")

    return dir

if system == "win32":
    try:
        import win32com.shell
        _get_win_folder = _get_win_folder_with_pywin32
    except ImportError:
        try:
            from ctypes import windll
            _get_win_folder = _get_win_folder_with_ctypes
        except ImportError:
            try:
                import com.sun.jna
                _get_win_folder = _get_win_folder_with_jna
            except ImportError:
                _get_win_folder = _get_win_folder_from_registry


#---- self test code

if __name__ == "__main__":
    appname = "MyApp"
    appauthor = "MyCompany"

    props = ("user_data_dir",
             "user_config_dir",
             "user_cache_dir",
             "user_state_dir",
             "user_log_dir",
             "site_data_dir",
             "site_config_dir")

    print("-- app dirs %s --" % __version__)

    print("-- app dirs (with optional 'version')")
    dirs = AppDirs(appname, appauthor, version="1.0")
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

    print("\n-- app dirs (without optional 'version')")
    dirs = AppDirs(appname, appauthor)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

    print("\n-- app dirs (without optional 'appauthor')")
    dirs = AppDirs(appname)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))

    print("\n-- app dirs (with disabled 'appauthor')")
    dirs = AppDirs(appname, appauthor=False)
    for prop in props:
        print("%s: %s" % (prop, getattr(dirs, prop)))
site-packages/pkg_resources/_vendor/pyparsing.py000064400000705167151446177000016206 0ustar00# module pyparsing.py
#
# Copyright (c) 2003-2018  Paul T. McGuire
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the
# "Software"), to deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, subject to
# the following conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
#

__doc__ = \
"""
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and executing simple grammars,
vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
provides a library of classes that you use to construct the grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form 
C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
L{Literal} expressions)::

    from pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the self-explanatory
class names, and the use of '+', '|' and '^' operators.

The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
object with named attributes.

The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
 - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
 - quoted strings
 - embedded comments


Getting Started -
-----------------
Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:
 - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
 - construct character word-group expressions using the L{Word} class
 - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
 - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
 - associate names with your parsed results using L{ParserElement.setResultsName}
 - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
 - find more useful common expressions in the L{pyparsing_common} namespace class
"""

__version__ = "2.2.1"
__versionTime__ = "18 Sep 2018 00:49 UTC"
__author__ = "Paul McGuire <ptmcg@users.sourceforge.net>"

import string
from weakref import ref as wkref
import copy
import sys
import warnings
import re
import sre_constants
import collections
import pprint
import traceback
import types
from datetime import datetime

try:
    from _thread import RLock
except ImportError:
    from threading import RLock

try:
    # Python 3
    from collections.abc import Iterable
    from collections.abc import MutableMapping
except ImportError:
    # Python 2.7
    from collections import Iterable
    from collections import MutableMapping

try:
    from collections import OrderedDict as _OrderedDict
except ImportError:
    try:
        from ordereddict import OrderedDict as _OrderedDict
    except ImportError:
        _OrderedDict = None

#~ sys.stderr.write( "testing pyparsing module, version %s, %s\n" % (__version__,__versionTime__ ) )

__all__ = [
'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter', 
'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore',
'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity', 
'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation','locatedExpr', 'withClass',
'CloseMatch', 'tokenMap', 'pyparsing_common',
]

system_version = tuple(sys.version_info)[:3]
PY_3 = system_version[0] == 3
if PY_3:
    _MAX_INT = sys.maxsize
    basestring = str
    unichr = chr
    _ustr = str

    # build list of single arg builtins, that can be used as parse actions
    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]

else:
    _MAX_INT = sys.maxint
    range = xrange

    def _ustr(obj):
        """Drop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
           then < returns the unicode object | encodes it with the default encoding | ... >.
        """
        if isinstance(obj,unicode):
            return obj

        try:
            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
            # it won't break any existing code.
            return str(obj)

        except UnicodeEncodeError:
            # Else encode it
            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
            xmlcharref = Regex(r'&#\d+;')
            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
            return xmlcharref.transformString(ret)

    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
    singleArgBuiltins = []
    import __builtin__
    for fname in "sum len sorted reversed list tuple set any all min max".split():
        try:
            singleArgBuiltins.append(getattr(__builtin__,fname))
        except AttributeError:
            continue
            
_generatorType = type((y for y in range(1)))
 
def _xml_escape(data):
    """Escape &, <, >, ", ', etc. in a string of data."""

    # ampersand must be replaced first
    from_symbols = '&><"\''
    to_symbols = ('&'+s+';' for s in "amp gt lt quot apos".split())
    for from_,to_ in zip(from_symbols, to_symbols):
        data = data.replace(from_, to_)
    return data

class _Constants(object):
    pass

alphas     = string.ascii_uppercase + string.ascii_lowercase
nums       = "0123456789"
hexnums    = nums + "ABCDEFabcdef"
alphanums  = alphas + nums
_bslash    = chr(92)
printables = "".join(c for c in string.printable if c not in string.whitespace)

class ParseBaseException(Exception):
    """base exception class for all parsing runtime exceptions"""
    # Performance tuning: we construct a *lot* of these, so keep this
    # constructor as small and fast as possible
    def __init__( self, pstr, loc=0, msg=None, elem=None ):
        self.loc = loc
        if msg is None:
            self.msg = pstr
            self.pstr = ""
        else:
            self.msg = msg
            self.pstr = pstr
        self.parserElement = elem
        self.args = (pstr, loc, msg)

    @classmethod
    def _from_exception(cls, pe):
        """
        internal factory method to simplify creating one type of ParseException 
        from another - avoids having __init__ signature conflicts among subclasses
        """
        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)

    def __getattr__( self, aname ):
        """supported attributes by name are:
            - lineno - returns the line number of the exception text
            - col - returns the column number of the exception text
            - line - returns the line containing the exception text
        """
        if( aname == "lineno" ):
            return lineno( self.loc, self.pstr )
        elif( aname in ("col", "column") ):
            return col( self.loc, self.pstr )
        elif( aname == "line" ):
            return line( self.loc, self.pstr )
        else:
            raise AttributeError(aname)

    def __str__( self ):
        return "%s (at char %d), (line:%d, col:%d)" % \
                ( self.msg, self.loc, self.lineno, self.column )
    def __repr__( self ):
        return _ustr(self)
    def markInputline( self, markerString = ">!<" ):
        """Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        """
        line_str = self.line
        line_column = self.column - 1
        if markerString:
            line_str = "".join((line_str[:line_column],
                                markerString, line_str[line_column:]))
        return line_str.strip()
    def __dir__(self):
        return "lineno col line".split() + dir(type(self))

class ParseException(ParseBaseException):
    """
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
     - lineno - returns the line number of the exception text
     - col - returns the column number of the exception text
     - line - returns the line containing the exception text
        
    Example::
        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))
            
    prints::
       Expected integer (at char 0), (line:1, col:1)
        column: 1
    """
    pass

class ParseFatalException(ParseBaseException):
    """user-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediately"""
    pass

class ParseSyntaxException(ParseFatalException):
    """just like L{ParseFatalException}, but thrown internally when an
       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
       immediately because an unbacktrackable syntax error has been found"""
    pass

#~ class ReparseException(ParseBaseException):
    #~ """Experimental class - parse actions can raise this exception to cause
       #~ pyparsing to reparse the input string:
        #~ - with a modified input string, and/or
        #~ - with a modified start location
       #~ Set the values of the ReparseException in the constructor, and raise the
       #~ exception in a parse action to cause pyparsing to use the new string/location.
       #~ Setting the values as None causes no change to be made.
       #~ """
    #~ def __init_( self, newstring, restartLoc ):
        #~ self.newParseText = newstring
        #~ self.reparseLoc = restartLoc

class RecursiveGrammarException(Exception):
    """exception thrown by L{ParserElement.validate} if the grammar could be improperly recursive"""
    def __init__( self, parseElementList ):
        self.parseElementTrace = parseElementList

    def __str__( self ):
        return "RecursiveGrammarException: %s" % self.parseElementTrace

class _ParseResultsWithOffset(object):
    def __init__(self,p1,p2):
        self.tup = (p1,p2)
    def __getitem__(self,i):
        return self.tup[i]
    def __repr__(self):
        return repr(self.tup[0])
    def setOffset(self,i):
        self.tup = (self.tup[0],i)

class ParseResults(object):
    """
    Structured parse results, to provide multiple means of access to the parsed data:
       - as a list (C{len(results)})
       - by list index (C{results[0], results[1]}, etc.)
       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})

    Example::
        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)
    prints::
        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    """
    def __new__(cls, toklist=None, name=None, asList=True, modal=True ):
        if isinstance(toklist, cls):
            return toklist
        retobj = object.__new__(cls)
        retobj.__doinit = True
        return retobj

    # Performance tuning: we construct a *lot* of these, so keep this
    # constructor as small and fast as possible
    def __init__( self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance ):
        if self.__doinit:
            self.__doinit = False
            self.__name = None
            self.__parent = None
            self.__accumNames = {}
            self.__asList = asList
            self.__modal = modal
            if toklist is None:
                toklist = []
            if isinstance(toklist, list):
                self.__toklist = toklist[:]
            elif isinstance(toklist, _generatorType):
                self.__toklist = list(toklist)
            else:
                self.__toklist = [toklist]
            self.__tokdict = dict()

        if name is not None and name:
            if not modal:
                self.__accumNames[name] = 0
            if isinstance(name,int):
                name = _ustr(name) # will always return a str, but use _ustr for consistency
            self.__name = name
            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None,'',[])):
                if isinstance(toklist,basestring):
                    toklist = [ toklist ]
                if asList:
                    if isinstance(toklist,ParseResults):
                        self[name] = _ParseResultsWithOffset(toklist.copy(),0)
                    else:
                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]),0)
                    self[name].__name = name
                else:
                    try:
                        self[name] = toklist[0]
                    except (KeyError,TypeError,IndexError):
                        self[name] = toklist

    def __getitem__( self, i ):
        if isinstance( i, (int,slice) ):
            return self.__toklist[i]
        else:
            if i not in self.__accumNames:
                return self.__tokdict[i][-1][0]
            else:
                return ParseResults([ v[0] for v in self.__tokdict[i] ])

    def __setitem__( self, k, v, isinstance=isinstance ):
        if isinstance(v,_ParseResultsWithOffset):
            self.__tokdict[k] = self.__tokdict.get(k,list()) + [v]
            sub = v[0]
        elif isinstance(k,(int,slice)):
            self.__toklist[k] = v
            sub = v
        else:
            self.__tokdict[k] = self.__tokdict.get(k,list()) + [_ParseResultsWithOffset(v,0)]
            sub = v
        if isinstance(sub,ParseResults):
            sub.__parent = wkref(self)

    def __delitem__( self, i ):
        if isinstance(i,(int,slice)):
            mylen = len( self.__toklist )
            del self.__toklist[i]

            # convert int to slice
            if isinstance(i, int):
                if i < 0:
                    i += mylen
                i = slice(i, i+1)
            # get removed indices
            removed = list(range(*i.indices(mylen)))
            removed.reverse()
            # fixup indices in token dictionary
            for name,occurrences in self.__tokdict.items():
                for j in removed:
                    for k, (value, position) in enumerate(occurrences):
                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
        else:
            del self.__tokdict[i]

    def __contains__( self, k ):
        return k in self.__tokdict

    def __len__( self ): return len( self.__toklist )
    def __bool__(self): return ( not not self.__toklist )
    __nonzero__ = __bool__
    def __iter__( self ): return iter( self.__toklist )
    def __reversed__( self ): return iter( self.__toklist[::-1] )
    def _iterkeys( self ):
        if hasattr(self.__tokdict, "iterkeys"):
            return self.__tokdict.iterkeys()
        else:
            return iter(self.__tokdict)

    def _itervalues( self ):
        return (self[k] for k in self._iterkeys())
            
    def _iteritems( self ):
        return ((k, self[k]) for k in self._iterkeys())

    if PY_3:
        keys = _iterkeys       
        """Returns an iterator of all named result keys (Python 3.x only)."""

        values = _itervalues
        """Returns an iterator of all named result values (Python 3.x only)."""

        items = _iteritems
        """Returns an iterator of all named result key-value tuples (Python 3.x only)."""

    else:
        iterkeys = _iterkeys
        """Returns an iterator of all named result keys (Python 2.x only)."""

        itervalues = _itervalues
        """Returns an iterator of all named result values (Python 2.x only)."""

        iteritems = _iteritems
        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""

        def keys( self ):
            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.iterkeys())

        def values( self ):
            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.itervalues())
                
        def items( self ):
            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.iteritems())

    def haskeys( self ):
        """Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names."""
        return bool(self.__tokdict)
        
    def pop( self, *args, **kwargs):
        """
        Removes and returns item at specified index (default=C{last}).
        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
        argument or an integer argument, it will use C{list} semantics
        and pop tokens from the list of parsed tokens. If passed a 
        non-integer argument (most likely a string), it will use C{dict}
        semantics and pop the corresponding value from any defined 
        results names. A second default return value argument is 
        supported, just as in C{dict.pop()}.

        Example::
            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())
        prints::
            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        """
        if not args:
            args = [-1]
        for k,v in kwargs.items():
            if k == 'default':
                args = (args[0], v)
            else:
                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
        if (isinstance(args[0], int) or 
                        len(args) == 1 or 
                        args[0] in self):
            index = args[0]
            ret = self[index]
            del self[index]
            return ret
        else:
            defaultvalue = args[1]
            return defaultvalue

    def get(self, key, defaultValue=None):
        """
        Returns named result matching the given key, or if there is no
        such name, then returns the given C{defaultValue} or C{None} if no
        C{defaultValue} is specified.

        Similar to C{dict.get()}.
        
        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        """
        if key in self:
            return self[key]
        else:
            return defaultValue

    def insert( self, index, insStr ):
        """
        Inserts new element at location index in the list of parsed tokens.
        
        Similar to C{list.insert()}.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        """
        self.__toklist.insert(index, insStr)
        # fixup indices in token dictionary
        for name,occurrences in self.__tokdict.items():
            for k, (value, position) in enumerate(occurrences):
                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))

    def append( self, item ):
        """
        Add single element to end of ParseResults list of elements.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            
            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        """
        self.__toklist.append(item)

    def extend( self, itemseq ):
        """
        Add sequence of elements to end of ParseResults list of elements.

        Example::
            patt = OneOrMore(Word(alphas))
            
            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        """
        if isinstance(itemseq, ParseResults):
            self += itemseq
        else:
            self.__toklist.extend(itemseq)

    def clear( self ):
        """
        Clear all elements and results names.
        """
        del self.__toklist[:]
        self.__tokdict.clear()

    def __getattr__( self, name ):
        try:
            return self[name]
        except KeyError:
            return ""
            
        if name in self.__tokdict:
            if name not in self.__accumNames:
                return self.__tokdict[name][-1][0]
            else:
                return ParseResults([ v[0] for v in self.__tokdict[name] ])
        else:
            return ""

    def __add__( self, other ):
        ret = self.copy()
        ret += other
        return ret

    def __iadd__( self, other ):
        if other.__tokdict:
            offset = len(self.__toklist)
            addoffset = lambda a: offset if a<0 else a+offset
            otheritems = other.__tokdict.items()
            otherdictitems = [(k, _ParseResultsWithOffset(v[0],addoffset(v[1])) )
                                for (k,vlist) in otheritems for v in vlist]
            for k,v in otherdictitems:
                self[k] = v
                if isinstance(v[0],ParseResults):
                    v[0].__parent = wkref(self)
            
        self.__toklist += other.__toklist
        self.__accumNames.update( other.__accumNames )
        return self

    def __radd__(self, other):
        if isinstance(other,int) and other == 0:
            # useful for merging many ParseResults using sum() builtin
            return self.copy()
        else:
            # this may raise a TypeError - so be it
            return other + self
        
    def __repr__( self ):
        return "(%s, %s)" % ( repr( self.__toklist ), repr( self.__tokdict ) )

    def __str__( self ):
        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'

    def _asStringList( self, sep='' ):
        out = []
        for item in self.__toklist:
            if out and sep:
                out.append(sep)
            if isinstance( item, ParseResults ):
                out += item._asStringList()
            else:
                out.append( _ustr(item) )
        return out

    def asList( self ):
        """
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::
            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
            
            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        """
        return [res.asList() if isinstance(res,ParseResults) else res for res in self.__toklist]

    def asDict( self ):
        """
        Returns the named parse results as a nested dictionary.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
            
            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        """
        if PY_3:
            item_fn = self.items
        else:
            item_fn = self.iteritems
            
        def toItem(obj):
            if isinstance(obj, ParseResults):
                if obj.haskeys():
                    return obj.asDict()
                else:
                    return [toItem(v) for v in obj]
            else:
                return obj
                
        return dict((k,toItem(v)) for k,v in item_fn())

    def copy( self ):
        """
        Returns a new copy of a C{ParseResults} object.
        """
        ret = ParseResults( self.__toklist )
        ret.__tokdict = self.__tokdict.copy()
        ret.__parent = self.__parent
        ret.__accumNames.update( self.__accumNames )
        ret.__name = self.__name
        return ret

    def asXML( self, doctag=None, namedItemsOnly=False, indent="", formatted=True ):
        """
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        """
        nl = "\n"
        out = []
        namedItems = dict((v[1],k) for (k,vlist) in self.__tokdict.items()
                                                            for v in vlist)
        nextLevelIndent = indent + "  "

        # collapse out indents if formatting is not desired
        if not formatted:
            indent = ""
            nextLevelIndent = ""
            nl = ""

        selfTag = None
        if doctag is not None:
            selfTag = doctag
        else:
            if self.__name:
                selfTag = self.__name

        if not selfTag:
            if namedItemsOnly:
                return ""
            else:
                selfTag = "ITEM"

        out += [ nl, indent, "<", selfTag, ">" ]

        for i,res in enumerate(self.__toklist):
            if isinstance(res,ParseResults):
                if i in namedItems:
                    out += [ res.asXML(namedItems[i],
                                        namedItemsOnly and doctag is None,
                                        nextLevelIndent,
                                        formatted)]
                else:
                    out += [ res.asXML(None,
                                        namedItemsOnly and doctag is None,
                                        nextLevelIndent,
                                        formatted)]
            else:
                # individual token, see if there is a name for it
                resTag = None
                if i in namedItems:
                    resTag = namedItems[i]
                if not resTag:
                    if namedItemsOnly:
                        continue
                    else:
                        resTag = "ITEM"
                xmlBodyText = _xml_escape(_ustr(res))
                out += [ nl, nextLevelIndent, "<", resTag, ">",
                                                xmlBodyText,
                                                "</", resTag, ">" ]

        out += [ nl, indent, "</", selfTag, ">" ]
        return "".join(out)

    def __lookup(self,sub):
        for k,vlist in self.__tokdict.items():
            for v,loc in vlist:
                if sub is v:
                    return k
        return None

    def getName(self):
        r"""
        Returns the results name for this token expression. Useful when several 
        different expressions might match at a particular location.

        Example::
            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number") 
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)
            
            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])
        prints::
            age : 22
            ssn : 111-22-3333
            house_number : 221B
        """
        if self.__name:
            return self.__name
        elif self.__parent:
            par = self.__parent()
            if par:
                return par.__lookup(self)
            else:
                return None
        elif (len(self) == 1 and
               len(self.__tokdict) == 1 and
               next(iter(self.__tokdict.values()))[0][1] in (0,-1)):
            return next(iter(self.__tokdict.keys()))
        else:
            return None

    def dump(self, indent='', depth=0, full=True):
        """
        Diagnostic method for listing out the contents of a C{ParseResults}.
        Accepts an optional C{indent} argument so that this string can be embedded
        in a nested display of other data.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(result.dump())
        prints::
            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        """
        out = []
        NL = '\n'
        out.append( indent+_ustr(self.asList()) )
        if full:
            if self.haskeys():
                items = sorted((str(k), v) for k,v in self.items())
                for k,v in items:
                    if out:
                        out.append(NL)
                    out.append( "%s%s- %s: " % (indent,('  '*depth), k) )
                    if isinstance(v,ParseResults):
                        if v:
                            out.append( v.dump(indent,depth+1) )
                        else:
                            out.append(_ustr(v))
                    else:
                        out.append(repr(v))
            elif any(isinstance(vv,ParseResults) for vv in self):
                v = self
                for i,vv in enumerate(v):
                    if isinstance(vv,ParseResults):
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),vv.dump(indent,depth+1) ))
                    else:
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),_ustr(vv)))
            
        return "".join(out)

    def pprint(self, *args, **kwargs):
        """
        Pretty-printer for parsed results as a list, using the C{pprint} module.
        Accepts additional positional or keyword args as defined for the 
        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})

        Example::
            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)
        prints::
            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        """
        pprint.pprint(self.asList(), *args, **kwargs)

    # add support for pickle protocol
    def __getstate__(self):
        return ( self.__toklist,
                 ( self.__tokdict.copy(),
                   self.__parent is not None and self.__parent() or None,
                   self.__accumNames,
                   self.__name ) )

    def __setstate__(self,state):
        self.__toklist = state[0]
        (self.__tokdict,
         par,
         inAccumNames,
         self.__name) = state[1]
        self.__accumNames = {}
        self.__accumNames.update(inAccumNames)
        if par is not None:
            self.__parent = wkref(par)
        else:
            self.__parent = None

    def __getnewargs__(self):
        return self.__toklist, self.__name, self.__asList, self.__modal

    def __dir__(self):
        return (dir(type(self)) + list(self.keys()))

MutableMapping.register(ParseResults)

def col (loc,strg):
    """Returns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   """
    s = strg
    return 1 if 0<loc<len(s) and s[loc-1] == '\n' else loc - s.rfind("\n", 0, loc)

def lineno(loc,strg):
    """Returns current line number within a string, counting newlines as line separators.
   The first line is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   """
    return strg.count("\n",0,loc) + 1

def line( loc, strg ):
    """Returns the line of text containing loc within a string, counting newlines as line separators.
       """
    lastCR = strg.rfind("\n", 0, loc)
    nextCR = strg.find("\n", loc)
    if nextCR >= 0:
        return strg[lastCR+1:nextCR]
    else:
        return strg[lastCR+1:]

def _defaultStartDebugAction( instring, loc, expr ):
    print (("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % ( lineno(loc,instring), col(loc,instring) )))

def _defaultSuccessDebugAction( instring, startloc, endloc, expr, toks ):
    print ("Matched " + _ustr(expr) + " -> " + str(toks.asList()))

def _defaultExceptionDebugAction( instring, loc, expr, exc ):
    print ("Exception raised:" + _ustr(exc))

def nullDebugAction(*args):
    """'Do-nothing' debug action, to suppress debugging output during parsing."""
    pass

# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
#~ 'decorator to trim function calls to match the arity of the target'
#~ def _trim_arity(func, maxargs=3):
    #~ if func in singleArgBuiltins:
        #~ return lambda s,l,t: func(t)
    #~ limit = 0
    #~ foundArity = False
    #~ def wrapper(*args):
        #~ nonlocal limit,foundArity
        #~ while 1:
            #~ try:
                #~ ret = func(*args[limit:])
                #~ foundArity = True
                #~ return ret
            #~ except TypeError:
                #~ if limit == maxargs or foundArity:
                    #~ raise
                #~ limit += 1
                #~ continue
    #~ return wrapper

# this version is Python 2.x-3.x cross-compatible
'decorator to trim function calls to match the arity of the target'
def _trim_arity(func, maxargs=2):
    if func in singleArgBuiltins:
        return lambda s,l,t: func(t)
    limit = [0]
    foundArity = [False]
    
    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
    if system_version[:2] >= (3,5):
        def extract_stack(limit=0):
            # special handling for Python 3.5.0 - extra deep call stack by 1
            offset = -3 if system_version == (3,5,0) else -2
            frame_summary = traceback.extract_stack(limit=-offset+limit-1)[offset]
            return [frame_summary[:2]]
        def extract_tb(tb, limit=0):
            frames = traceback.extract_tb(tb, limit=limit)
            frame_summary = frames[-1]
            return [frame_summary[:2]]
    else:
        extract_stack = traceback.extract_stack
        extract_tb = traceback.extract_tb
    
    # synthesize what would be returned by traceback.extract_stack at the call to 
    # user's parse action 'func', so that we don't incur call penalty at parse time
    
    LINE_DIFF = 6
    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND 
    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
    this_line = extract_stack(limit=2)[-1]
    pa_call_line_synth = (this_line[0], this_line[1]+LINE_DIFF)

    def wrapper(*args):
        while 1:
            try:
                ret = func(*args[limit[0]:])
                foundArity[0] = True
                return ret
            except TypeError:
                # re-raise TypeErrors if they did not come from our arity testing
                if foundArity[0]:
                    raise
                else:
                    try:
                        tb = sys.exc_info()[-1]
                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
                            raise
                    finally:
                        del tb

                if limit[0] <= maxargs:
                    limit[0] += 1
                    continue
                raise

    # copy func name to wrapper for sensible debug output
    func_name = "<parse action>"
    try:
        func_name = getattr(func, '__name__', 
                            getattr(func, '__class__').__name__)
    except Exception:
        func_name = str(func)
    wrapper.__name__ = func_name

    return wrapper

class ParserElement(object):
    """Abstract base level parser element class."""
    DEFAULT_WHITE_CHARS = " \n\t\r"
    verbose_stacktrace = False

    @staticmethod
    def setDefaultWhitespaceChars( chars ):
        r"""
        Overrides the default whitespace chars

        Example::
            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
            
            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        """
        ParserElement.DEFAULT_WHITE_CHARS = chars

    @staticmethod
    def inlineLiteralsUsing(cls):
        """
        Set class to be used for inclusion of string literals into a parser.
        
        Example::
            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        """
        ParserElement._literalStringClass = cls

    def __init__( self, savelist=False ):
        self.parseAction = list()
        self.failAction = None
        #~ self.name = "<unknown>"  # don't define self.name, let subclasses try/except upcall
        self.strRepr = None
        self.resultsName = None
        self.saveAsList = savelist
        self.skipWhitespace = True
        self.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
        self.copyDefaultWhiteChars = True
        self.mayReturnEmpty = False # used when checking for left-recursion
        self.keepTabs = False
        self.ignoreExprs = list()
        self.debug = False
        self.streamlined = False
        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
        self.errmsg = ""
        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
        self.debugActions = ( None, None, None ) #custom debug actions
        self.re = None
        self.callPreparse = True # used to avoid redundant calls to preParse
        self.callDuringTry = False

    def copy( self ):
        """
        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
        for the same parsing pattern, using copies of the original parse element.
        
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
            
            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
        prints::
            [5120, 100, 655360, 268435456]
        Equivalent form of C{expr.copy()} is just C{expr()}::
            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
        """
        cpy = copy.copy( self )
        cpy.parseAction = self.parseAction[:]
        cpy.ignoreExprs = self.ignoreExprs[:]
        if self.copyDefaultWhiteChars:
            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
        return cpy

    def setName( self, name ):
        """
        Define name for this expression, makes debugging and exception messages clearer.
        
        Example::
            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        """
        self.name = name
        self.errmsg = "Expected " + self.name
        if hasattr(self,"exception"):
            self.exception.msg = self.errmsg
        return self

    def setResultsName( self, name, listAllMatches=False ):
        """
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original C{ParserElement} object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        C{expr("name")} in place of C{expr.setResultsName("name")} - 
        see L{I{__call__}<__call__>}.

        Example::
            date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        """
        newself = self.copy()
        if name.endswith("*"):
            name = name[:-1]
            listAllMatches=True
        newself.resultsName = name
        newself.modalResults = not listAllMatches
        return newself

    def setBreak(self,breakFlag = True):
        """Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set C{breakFlag} to True to enable, False to
           disable.
        """
        if breakFlag:
            _parseMethod = self._parse
            def breaker(instring, loc, doActions=True, callPreParse=True):
                import pdb
                pdb.set_trace()
                return _parseMethod( instring, loc, doActions, callPreParse )
            breaker._originalParseMethod = _parseMethod
            self._parse = breaker
        else:
            if hasattr(self._parse,"_originalParseMethod"):
                self._parse = self._parse._originalParseMethod
        return self

    def setParseAction( self, *fns, **kwargs ):
        """
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
         - s   = the original string being parsed (see note below)
         - loc = the location of the matching substring
         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        Optional keyword arguments:
         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
        consistent view of the parsed string, the parse location, and line and column
        positions within the parsed string.
        
        Example::
            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        """
        self.parseAction = list(map(_trim_arity, list(fns)))
        self.callDuringTry = kwargs.get("callDuringTry", False)
        return self

    def addParseAction( self, *fns, **kwargs ):
        """
        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
        
        See examples in L{I{copy}<copy>}.
        """
        self.parseAction += list(map(_trim_arity, list(fns)))
        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
        return self

    def addCondition(self, *fns, **kwargs):
        """Add a boolean predicate function to expression's list of parse actions. See 
        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
        functions passed to C{addCondition} need to return boolean success/fail of the condition.

        Optional keyword arguments:
         - message = define a custom message to be used in the raised exception
         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
         
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        """
        msg = kwargs.get("message", "failed user-defined condition")
        exc_type = ParseFatalException if kwargs.get("fatal", False) else ParseException
        for fn in fns:
            def pa(s,l,t):
                if not bool(_trim_arity(fn)(s,l,t)):
                    raise exc_type(s,l,msg)
            self.parseAction.append(pa)
        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
        return self

    def setFailAction( self, fn ):
        """Define action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           C{fn(s,loc,expr,err)} where:
            - s = string being parsed
            - loc = location where expression match was attempted and failed
            - expr = the parse expression that failed
            - err = the exception thrown
           The function returns no value.  It may throw C{L{ParseFatalException}}
           if it is desired to stop parsing immediately."""
        self.failAction = fn
        return self

    def _skipIgnorables( self, instring, loc ):
        exprsFound = True
        while exprsFound:
            exprsFound = False
            for e in self.ignoreExprs:
                try:
                    while 1:
                        loc,dummy = e._parse( instring, loc )
                        exprsFound = True
                except ParseException:
                    pass
        return loc

    def preParse( self, instring, loc ):
        if self.ignoreExprs:
            loc = self._skipIgnorables( instring, loc )

        if self.skipWhitespace:
            wt = self.whiteChars
            instrlen = len(instring)
            while loc < instrlen and instring[loc] in wt:
                loc += 1

        return loc

    def parseImpl( self, instring, loc, doActions=True ):
        return loc, []

    def postParse( self, instring, loc, tokenlist ):
        return tokenlist

    #~ @profile
    def _parseNoCache( self, instring, loc, doActions=True, callPreParse=True ):
        debugging = ( self.debug ) #and doActions )

        if debugging or self.failAction:
            #~ print ("Match",self,"at loc",loc,"(%d,%d)" % ( lineno(loc,instring), col(loc,instring) ))
            if (self.debugActions[0] ):
                self.debugActions[0]( instring, loc, self )
            if callPreParse and self.callPreparse:
                preloc = self.preParse( instring, loc )
            else:
                preloc = loc
            tokensStart = preloc
            try:
                try:
                    loc,tokens = self.parseImpl( instring, preloc, doActions )
                except IndexError:
                    raise ParseException( instring, len(instring), self.errmsg, self )
            except ParseBaseException as err:
                #~ print ("Exception raised:", err)
                if self.debugActions[2]:
                    self.debugActions[2]( instring, tokensStart, self, err )
                if self.failAction:
                    self.failAction( instring, tokensStart, self, err )
                raise
        else:
            if callPreParse and self.callPreparse:
                preloc = self.preParse( instring, loc )
            else:
                preloc = loc
            tokensStart = preloc
            if self.mayIndexError or preloc >= len(instring):
                try:
                    loc,tokens = self.parseImpl( instring, preloc, doActions )
                except IndexError:
                    raise ParseException( instring, len(instring), self.errmsg, self )
            else:
                loc,tokens = self.parseImpl( instring, preloc, doActions )

        tokens = self.postParse( instring, loc, tokens )

        retTokens = ParseResults( tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults )
        if self.parseAction and (doActions or self.callDuringTry):
            if debugging:
                try:
                    for fn in self.parseAction:
                        tokens = fn( instring, tokensStart, retTokens )
                        if tokens is not None:
                            retTokens = ParseResults( tokens,
                                                      self.resultsName,
                                                      asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
                                                      modal=self.modalResults )
                except ParseBaseException as err:
                    #~ print "Exception raised in user parse action:", err
                    if (self.debugActions[2] ):
                        self.debugActions[2]( instring, tokensStart, self, err )
                    raise
            else:
                for fn in self.parseAction:
                    tokens = fn( instring, tokensStart, retTokens )
                    if tokens is not None:
                        retTokens = ParseResults( tokens,
                                                  self.resultsName,
                                                  asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
                                                  modal=self.modalResults )
        if debugging:
            #~ print ("Matched",self,"->",retTokens.asList())
            if (self.debugActions[1] ):
                self.debugActions[1]( instring, tokensStart, loc, self, retTokens )

        return loc, retTokens

    def tryParse( self, instring, loc ):
        try:
            return self._parse( instring, loc, doActions=False )[0]
        except ParseFatalException:
            raise ParseException( instring, loc, self.errmsg, self)
    
    def canParseNext(self, instring, loc):
        try:
            self.tryParse(instring, loc)
        except (ParseException, IndexError):
            return False
        else:
            return True

    class _UnboundedCache(object):
        def __init__(self):
            cache = {}
            self.not_in_cache = not_in_cache = object()

            def get(self, key):
                return cache.get(key, not_in_cache)

            def set(self, key, value):
                cache[key] = value

            def clear(self):
                cache.clear()
                
            def cache_len(self):
                return len(cache)

            self.get = types.MethodType(get, self)
            self.set = types.MethodType(set, self)
            self.clear = types.MethodType(clear, self)
            self.__len__ = types.MethodType(cache_len, self)

    if _OrderedDict is not None:
        class _FifoCache(object):
            def __init__(self, size):
                self.not_in_cache = not_in_cache = object()

                cache = _OrderedDict()

                def get(self, key):
                    return cache.get(key, not_in_cache)

                def set(self, key, value):
                    cache[key] = value
                    while len(cache) > size:
                        try:
                            cache.popitem(False)
                        except KeyError:
                            pass

                def clear(self):
                    cache.clear()

                def cache_len(self):
                    return len(cache)

                self.get = types.MethodType(get, self)
                self.set = types.MethodType(set, self)
                self.clear = types.MethodType(clear, self)
                self.__len__ = types.MethodType(cache_len, self)

    else:
        class _FifoCache(object):
            def __init__(self, size):
                self.not_in_cache = not_in_cache = object()

                cache = {}
                key_fifo = collections.deque([], size)

                def get(self, key):
                    return cache.get(key, not_in_cache)

                def set(self, key, value):
                    cache[key] = value
                    while len(key_fifo) > size:
                        cache.pop(key_fifo.popleft(), None)
                    key_fifo.append(key)

                def clear(self):
                    cache.clear()
                    key_fifo.clear()

                def cache_len(self):
                    return len(cache)

                self.get = types.MethodType(get, self)
                self.set = types.MethodType(set, self)
                self.clear = types.MethodType(clear, self)
                self.__len__ = types.MethodType(cache_len, self)

    # argument cache for optimizing repeated calls when backtracking through recursive expressions
    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
    packrat_cache_lock = RLock()
    packrat_cache_stats = [0, 0]

    # this method gets repeatedly called during backtracking with the same arguments -
    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
    def _parseCache( self, instring, loc, doActions=True, callPreParse=True ):
        HIT, MISS = 0, 1
        lookup = (self, instring, loc, callPreParse, doActions)
        with ParserElement.packrat_cache_lock:
            cache = ParserElement.packrat_cache
            value = cache.get(lookup)
            if value is cache.not_in_cache:
                ParserElement.packrat_cache_stats[MISS] += 1
                try:
                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
                except ParseBaseException as pe:
                    # cache a copy of the exception, without the traceback
                    cache.set(lookup, pe.__class__(*pe.args))
                    raise
                else:
                    cache.set(lookup, (value[0], value[1].copy()))
                    return value
            else:
                ParserElement.packrat_cache_stats[HIT] += 1
                if isinstance(value, Exception):
                    raise value
                return (value[0], value[1].copy())

    _parse = _parseNoCache

    @staticmethod
    def resetCache():
        ParserElement.packrat_cache.clear()
        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)

    _packratEnabled = False
    @staticmethod
    def enablePackrat(cache_size_limit=128):
        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.
           
           Parameters:
            - cache_size_limit - (default=C{128}) - if an integer value is provided
              will limit the size of the packrat cache; if None is passed, then
              the cache size will be unbounded; if 0 is passed, the cache will
              be effectively disabled.
            
           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method C{ParserElement.enablePackrat()}.  If
           your program uses C{psyco} to "compile as you go", you must call
           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
           Python will crash.  For best results, call C{enablePackrat()} immediately
           after importing pyparsing.
           
           Example::
               import pyparsing
               pyparsing.ParserElement.enablePackrat()
        """
        if not ParserElement._packratEnabled:
            ParserElement._packratEnabled = True
            if cache_size_limit is None:
                ParserElement.packrat_cache = ParserElement._UnboundedCache()
            else:
                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
            ParserElement._parse = ParserElement._parseCache

    def parseString( self, instring, parseAll=False ):
        """
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set C{parseAll} to True (equivalent to ending
        the grammar with C{L{StringEnd()}}).

        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the C{loc} argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:
         - calling C{parseWithTabs} on your grammar before calling C{parseString}
           (see L{I{parseWithTabs}<parseWithTabs>})
         - define your parse action using the full C{(s,loc,toks)} signature, and
           reference the input string using the parse action's C{s} argument
         - explictly expand the tabs in your input string before calling
           C{parseString}
        
        Example::
            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        """
        ParserElement.resetCache()
        if not self.streamlined:
            self.streamline()
            #~ self.saveAsList = True
        for e in self.ignoreExprs:
            e.streamline()
        if not self.keepTabs:
            instring = instring.expandtabs()
        try:
            loc, tokens = self._parse( instring, 0 )
            if parseAll:
                loc = self.preParse( instring, loc )
                se = Empty() + StringEnd()
                se._parse( instring, loc )
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc
        else:
            return tokens

    def scanString( self, instring, maxMatches=_MAX_INT, overlap=False ):
        """
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
        C{overlap} is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
        strings with embedded tabs.

        Example::
            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens,start,end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])
        
        prints::
        
            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        """
        if not self.streamlined:
            self.streamline()
        for e in self.ignoreExprs:
            e.streamline()

        if not self.keepTabs:
            instring = _ustr(instring).expandtabs()
        instrlen = len(instring)
        loc = 0
        preparseFn = self.preParse
        parseFn = self._parse
        ParserElement.resetCache()
        matches = 0
        try:
            while loc <= instrlen and matches < maxMatches:
                try:
                    preloc = preparseFn( instring, loc )
                    nextLoc,tokens = parseFn( instring, preloc, callPreParse=False )
                except ParseException:
                    loc = preloc+1
                else:
                    if nextLoc > loc:
                        matches += 1
                        yield tokens, preloc, nextLoc
                        if overlap:
                            nextloc = preparseFn( instring, loc )
                            if nextloc > loc:
                                loc = nextLoc
                            else:
                                loc += 1
                        else:
                            loc = nextLoc
                    else:
                        loc = preloc+1
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def transformString( self, instring ):
        """
        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
        be returned from a parse action.  To use C{transformString}, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking C{transformString()} on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  C{transformString()} returns the resulting transformed string.
        
        Example::
            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())
            
            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
        Prints::
            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        """
        out = []
        lastE = 0
        # force preservation of <TAB>s, to minimize unwanted transformation of string, and to
        # keep string locs straight between transformString and scanString
        self.keepTabs = True
        try:
            for t,s,e in self.scanString( instring ):
                out.append( instring[lastE:s] )
                if t:
                    if isinstance(t,ParseResults):
                        out += t.asList()
                    elif isinstance(t,list):
                        out += t
                    else:
                        out.append(t)
                lastE = e
            out.append(instring[lastE:])
            out = [o for o in out if o]
            return "".join(map(_ustr,_flatten(out)))
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def searchString( self, instring, maxMatches=_MAX_INT ):
        """
        Another extension to C{L{scanString}}, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        C{maxMatches} argument, to clip searching after 'n' matches are found.
        
        Example::
            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())
            
            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
        prints::
            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        """
        try:
            return ParseResults([ t for t,s,e in self.scanString( instring, maxMatches ) ])
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
        """
        Generator method to split a string using the given expression as a separator.
        May be called with optional C{maxsplit} argument, to limit the number of splits;
        and the optional C{includeSeparators} argument (default=C{False}), if the separating
        matching text should be included in the split results.
        
        Example::        
            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
        prints::
            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        """
        splits = 0
        last = 0
        for t,s,e in self.scanString(instring, maxMatches=maxsplit):
            yield instring[last:s]
            if includeSeparators:
                yield t[0]
            last = e
        yield instring[last:]

    def __add__(self, other ):
        """
        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
        converts them to L{Literal}s by default.
        
        Example::
            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))
        Prints::
            Hello, World! -> ['Hello', ',', 'World', '!']
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return And( [ self, other ] )

    def __radd__(self, other ):
        """
        Implementation of + operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other + self

    def __sub__(self, other):
        """
        Implementation of - operator, returns C{L{And}} with error stop
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return self + And._ErrorStop() + other

    def __rsub__(self, other ):
        """
        Implementation of - operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other - self

    def __mul__(self,other):
        """
        Implementation of * operator, allows use of C{expr * 3} in place of
        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
        may also include C{None} as in:
         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
              to C{expr*n + L{ZeroOrMore}(expr)}
              (read as "at least n instances of C{expr}")
         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
              (read as "0 to n instances of C{expr}")
         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}

        Note that C{expr*(None,n)} does not raise an exception if
        more than n exprs exist in the input stream; that is,
        C{expr*(None,n)} does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        C{expr*(None,n) + ~expr}
        """
        if isinstance(other,int):
            minElements, optElements = other,0
        elif isinstance(other,tuple):
            other = (other + (None, None))[:2]
            if other[0] is None:
                other = (0, other[1])
            if isinstance(other[0],int) and other[1] is None:
                if other[0] == 0:
                    return ZeroOrMore(self)
                if other[0] == 1:
                    return OneOrMore(self)
                else:
                    return self*other[0] + ZeroOrMore(self)
            elif isinstance(other[0],int) and isinstance(other[1],int):
                minElements, optElements = other
                optElements -= minElements
            else:
                raise TypeError("cannot multiply 'ParserElement' and ('%s','%s') objects", type(other[0]),type(other[1]))
        else:
            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))

        if minElements < 0:
            raise ValueError("cannot multiply ParserElement by negative value")
        if optElements < 0:
            raise ValueError("second tuple value must be greater or equal to first tuple value")
        if minElements == optElements == 0:
            raise ValueError("cannot multiply ParserElement by 0 or (0,0)")

        if (optElements):
            def makeOptionalList(n):
                if n>1:
                    return Optional(self + makeOptionalList(n-1))
                else:
                    return Optional(self)
            if minElements:
                if minElements == 1:
                    ret = self + makeOptionalList(optElements)
                else:
                    ret = And([self]*minElements) + makeOptionalList(optElements)
            else:
                ret = makeOptionalList(optElements)
        else:
            if minElements == 1:
                ret = self
            else:
                ret = And([self]*minElements)
        return ret

    def __rmul__(self, other):
        return self.__mul__(other)

    def __or__(self, other ):
        """
        Implementation of | operator - returns C{L{MatchFirst}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return MatchFirst( [ self, other ] )

    def __ror__(self, other ):
        """
        Implementation of | operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other | self

    def __xor__(self, other ):
        """
        Implementation of ^ operator - returns C{L{Or}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return Or( [ self, other ] )

    def __rxor__(self, other ):
        """
        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other ^ self

    def __and__(self, other ):
        """
        Implementation of & operator - returns C{L{Each}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return Each( [ self, other ] )

    def __rand__(self, other ):
        """
        Implementation of & operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other & self

    def __invert__( self ):
        """
        Implementation of ~ operator - returns C{L{NotAny}}
        """
        return NotAny( self )

    def __call__(self, name=None):
        """
        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
        
        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
        passed as C{True}.
           
        If C{name} is omitted, same as calling C{L{copy}}.

        Example::
            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
        """
        if name is not None:
            return self.setResultsName(name)
        else:
            return self.copy()

    def suppress( self ):
        """
        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
        cluttering up returned output.
        """
        return Suppress( self )

    def leaveWhitespace( self ):
        """
        Disables the skipping of whitespace before matching the characters in the
        C{ParserElement}'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        """
        self.skipWhitespace = False
        return self

    def setWhitespaceChars( self, chars ):
        """
        Overrides the default whitespace chars
        """
        self.skipWhitespace = True
        self.whiteChars = chars
        self.copyDefaultWhiteChars = False
        return self

    def parseWithTabs( self ):
        """
        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
        Must be called before C{parseString} when the input grammar contains elements that
        match C{<TAB>} characters.
        """
        self.keepTabs = True
        return self

    def ignore( self, other ):
        """
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.
        
        Example::
            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
            
            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        """
        if isinstance(other, basestring):
            other = Suppress(other)

        if isinstance( other, Suppress ):
            if other not in self.ignoreExprs:
                self.ignoreExprs.append(other)
        else:
            self.ignoreExprs.append( Suppress( other.copy() ) )
        return self

    def setDebugActions( self, startAction, successAction, exceptionAction ):
        """
        Enable display of debugging messages while doing pattern matching.
        """
        self.debugActions = (startAction or _defaultStartDebugAction,
                             successAction or _defaultSuccessDebugAction,
                             exceptionAction or _defaultExceptionDebugAction)
        self.debug = True
        return self

    def setDebug( self, flag=True ):
        """
        Enable display of debugging messages while doing pattern matching.
        Set C{flag} to True to enable, False to disable.

        Example::
            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer
            
            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")
        
        prints::
            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using L{setDebugActions}. Prior to attempting
        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
        """
        if flag:
            self.setDebugActions( _defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction )
        else:
            self.debug = False
        return self

    def __str__( self ):
        return self.name

    def __repr__( self ):
        return _ustr(self)

    def streamline( self ):
        self.streamlined = True
        self.strRepr = None
        return self

    def checkRecursion( self, parseElementList ):
        pass

    def validate( self, validateTrace=[] ):
        """
        Check defined expressions for valid structure, check for infinite recursive definitions.
        """
        self.checkRecursion( [] )

    def parseFile( self, file_or_filename, parseAll=False ):
        """
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        """
        try:
            file_contents = file_or_filename.read()
        except AttributeError:
            with open(file_or_filename, "r") as f:
                file_contents = f.read()
        try:
            return self.parseString(file_contents, parseAll)
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def __eq__(self,other):
        if isinstance(other, ParserElement):
            return self is other or vars(self) == vars(other)
        elif isinstance(other, basestring):
            return self.matches(other)
        else:
            return super(ParserElement,self)==other

    def __ne__(self,other):
        return not (self == other)

    def __hash__(self):
        return hash(id(self))

    def __req__(self,other):
        return self == other

    def __rne__(self,other):
        return not (self == other)

    def matches(self, testString, parseAll=True):
        """
        Method for quick testing of a parser against a test string. Good for simple 
        inline microtests of sub expressions while building up larger parser.
           
        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
            
        Example::
            expr = Word(nums)
            assert expr.matches("100")
        """
        try:
            self.parseString(_ustr(testString), parseAll=parseAll)
            return True
        except ParseBaseException:
            return False
                
    def runTests(self, tests, parseAll=True, comment='#', fullDump=True, printResults=True, failureTests=False):
        """
        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.
           
        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
              string; pass None to disable comment filtering
         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default=C{True}) prints test output to stdout
         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
        test's output
        
        Example::
            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")
        prints::
            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success
            
            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")
        
        (Note that this is a raw string literal, you must include the leading 'r'.)
        """
        if isinstance(tests, basestring):
            tests = list(map(str.strip, tests.rstrip().splitlines()))
        if isinstance(comment, basestring):
            comment = Literal(comment)
        allResults = []
        comments = []
        success = True
        for t in tests:
            if comment is not None and comment.matches(t, False) or comments and not t:
                comments.append(t)
                continue
            if not t:
                continue
            out = ['\n'.join(comments), t]
            comments = []
            try:
                t = t.replace(r'\n','\n')
                result = self.parseString(t, parseAll=parseAll)
                out.append(result.dump(full=fullDump))
                success = success and not failureTests
            except ParseBaseException as pe:
                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
                if '\n' in t:
                    out.append(line(pe.loc, t))
                    out.append(' '*(col(pe.loc,t)-1) + '^' + fatal)
                else:
                    out.append(' '*pe.loc + '^' + fatal)
                out.append("FAIL: " + str(pe))
                success = success and failureTests
                result = pe
            except Exception as exc:
                out.append("FAIL-EXCEPTION: " + str(exc))
                success = success and failureTests
                result = exc

            if printResults:
                if fullDump:
                    out.append('')
                print('\n'.join(out))

            allResults.append((t, result))
        
        return success, allResults

        
class Token(ParserElement):
    """
    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
    """
    def __init__( self ):
        super(Token,self).__init__( savelist=False )


class Empty(Token):
    """
    An empty token, will always match.
    """
    def __init__( self ):
        super(Empty,self).__init__()
        self.name = "Empty"
        self.mayReturnEmpty = True
        self.mayIndexError = False


class NoMatch(Token):
    """
    A token that will never match.
    """
    def __init__( self ):
        super(NoMatch,self).__init__()
        self.name = "NoMatch"
        self.mayReturnEmpty = True
        self.mayIndexError = False
        self.errmsg = "Unmatchable token"

    def parseImpl( self, instring, loc, doActions=True ):
        raise ParseException(instring, loc, self.errmsg, self)


class Literal(Token):
    """
    Token to exactly match a specified string.
    
    Example::
        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
    
    For case-insensitive matching, use L{CaselessLiteral}.
    
    For keyword matching (force word break before and after the matched string),
    use L{Keyword} or L{CaselessKeyword}.
    """
    def __init__( self, matchString ):
        super(Literal,self).__init__()
        self.match = matchString
        self.matchLen = len(matchString)
        try:
            self.firstMatchChar = matchString[0]
        except IndexError:
            warnings.warn("null string passed to Literal; use Empty() instead",
                            SyntaxWarning, stacklevel=2)
            self.__class__ = Empty
        self.name = '"%s"' % _ustr(self.match)
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = False
        self.mayIndexError = False

    # Performance tuning: this routine gets called a *lot*
    # if this is a single character match string  and the first character matches,
    # short-circuit as quickly as possible, and avoid calling startswith
    #~ @profile
    def parseImpl( self, instring, loc, doActions=True ):
        if (instring[loc] == self.firstMatchChar and
            (self.matchLen==1 or instring.startswith(self.match,loc)) ):
            return loc+self.matchLen, self.match
        raise ParseException(instring, loc, self.errmsg, self)
_L = Literal
ParserElement._literalStringClass = Literal

class Keyword(Token):
    """
    Token to exactly match a specified string as a keyword, that is, it must be
    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
    Accepts two optional constructor arguments in addition to the keyword string:
     - C{identChars} is a string of characters that would be valid identifier characters,
          defaulting to all alphanumerics + "_" and "$"
     - C{caseless} allows case-insensitive matching, default is C{False}.
       
    Example::
        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use L{CaselessKeyword}.
    """
    DEFAULT_KEYWORD_CHARS = alphanums+"_$"

    def __init__( self, matchString, identChars=None, caseless=False ):
        super(Keyword,self).__init__()
        if identChars is None:
            identChars = Keyword.DEFAULT_KEYWORD_CHARS
        self.match = matchString
        self.matchLen = len(matchString)
        try:
            self.firstMatchChar = matchString[0]
        except IndexError:
            warnings.warn("null string passed to Keyword; use Empty() instead",
                            SyntaxWarning, stacklevel=2)
        self.name = '"%s"' % self.match
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = False
        self.mayIndexError = False
        self.caseless = caseless
        if caseless:
            self.caselessmatch = matchString.upper()
            identChars = identChars.upper()
        self.identChars = set(identChars)

    def parseImpl( self, instring, loc, doActions=True ):
        if self.caseless:
            if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
                 (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) and
                 (loc == 0 or instring[loc-1].upper() not in self.identChars) ):
                return loc+self.matchLen, self.match
        else:
            if (instring[loc] == self.firstMatchChar and
                (self.matchLen==1 or instring.startswith(self.match,loc)) and
                (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen] not in self.identChars) and
                (loc == 0 or instring[loc-1] not in self.identChars) ):
                return loc+self.matchLen, self.match
        raise ParseException(instring, loc, self.errmsg, self)

    def copy(self):
        c = super(Keyword,self).copy()
        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
        return c

    @staticmethod
    def setDefaultKeywordChars( chars ):
        """Overrides the default Keyword chars
        """
        Keyword.DEFAULT_KEYWORD_CHARS = chars

class CaselessLiteral(Literal):
    """
    Token to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::
        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
        
    (Contrast with example for L{CaselessKeyword}.)
    """
    def __init__( self, matchString ):
        super(CaselessLiteral,self).__init__( matchString.upper() )
        # Preserve the defining literal.
        self.returnString = matchString
        self.name = "'%s'" % self.returnString
        self.errmsg = "Expected " + self.name

    def parseImpl( self, instring, loc, doActions=True ):
        if instring[ loc:loc+self.matchLen ].upper() == self.match:
            return loc+self.matchLen, self.returnString
        raise ParseException(instring, loc, self.errmsg, self)

class CaselessKeyword(Keyword):
    """
    Caseless version of L{Keyword}.

    Example::
        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
        
    (Contrast with example for L{CaselessLiteral}.)
    """
    def __init__( self, matchString, identChars=None ):
        super(CaselessKeyword,self).__init__( matchString, identChars, caseless=True )

    def parseImpl( self, instring, loc, doActions=True ):
        if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
             (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) ):
            return loc+self.matchLen, self.match
        raise ParseException(instring, loc, self.errmsg, self)

class CloseMatch(Token):
    """
    A variation on L{Literal} which matches "close" matches, that is, 
    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
     - C{match_string} - string to be matched
     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
    
    The results from a successful parse will contain the matched text from the input string and the following named results:
     - C{mismatches} - a list of the positions within the match_string where mismatches were found
     - C{original} - the original match_string used to compare against the input string
    
    If C{mismatches} is an empty list, then the match was an exact match.
    
    Example::
        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    """
    def __init__(self, match_string, maxMismatches=1):
        super(CloseMatch,self).__init__()
        self.name = match_string
        self.match_string = match_string
        self.maxMismatches = maxMismatches
        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
        self.mayIndexError = False
        self.mayReturnEmpty = False

    def parseImpl( self, instring, loc, doActions=True ):
        start = loc
        instrlen = len(instring)
        maxloc = start + len(self.match_string)

        if maxloc <= instrlen:
            match_string = self.match_string
            match_stringloc = 0
            mismatches = []
            maxMismatches = self.maxMismatches

            for match_stringloc,s_m in enumerate(zip(instring[loc:maxloc], self.match_string)):
                src,mat = s_m
                if src != mat:
                    mismatches.append(match_stringloc)
                    if len(mismatches) > maxMismatches:
                        break
            else:
                loc = match_stringloc + 1
                results = ParseResults([instring[start:loc]])
                results['original'] = self.match_string
                results['mismatches'] = mismatches
                return loc, results

        raise ParseException(instring, loc, self.errmsg, self)


class Word(Token):
    """
    Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters,
    an optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction. An optional
    C{excludeChars} parameter can list characters that might be found in 
    the input C{bodyChars} string; useful to define a word of all printables
    except for one or two characters, for instance.
    
    L{srange} is useful for defining custom character set strings for defining 
    C{Word} expressions, using range notation from regular expression character sets.
    
    A common mistake is to use C{Word} to match a specific literal string, as in 
    C{Word("Address")}. Remember that C{Word} uses the string argument to define
    I{sets} of matchable characters. This expression would match "Add", "AAA",
    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
    To match an exact literal string, use L{Literal} or L{Keyword}.

    pyparsing includes helper strings for building Words:
     - L{alphas}
     - L{nums}
     - L{alphanums}
     - L{hexnums}
     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - L{printables} (any non-whitespace character)

    Example::
        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
        
        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums+'-')
        
        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")
        
        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    """
    def __init__( self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None ):
        super(Word,self).__init__()
        if excludeChars:
            initChars = ''.join(c for c in initChars if c not in excludeChars)
            if bodyChars:
                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
        self.initCharsOrig = initChars
        self.initChars = set(initChars)
        if bodyChars :
            self.bodyCharsOrig = bodyChars
            self.bodyChars = set(bodyChars)
        else:
            self.bodyCharsOrig = initChars
            self.bodyChars = set(initChars)

        self.maxSpecified = max > 0

        if min < 1:
            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.asKeyword = asKeyword

        if ' ' not in self.initCharsOrig+self.bodyCharsOrig and (min==1 and max==0 and exact==0):
            if self.bodyCharsOrig == self.initCharsOrig:
                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
            elif len(self.initCharsOrig) == 1:
                self.reString = "%s[%s]*" % \
                                      (re.escape(self.initCharsOrig),
                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
            else:
                self.reString = "[%s][%s]*" % \
                                      (_escapeRegexRangeChars(self.initCharsOrig),
                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
            if self.asKeyword:
                self.reString = r"\b"+self.reString+r"\b"
            try:
                self.re = re.compile( self.reString )
            except Exception:
                self.re = None

    def parseImpl( self, instring, loc, doActions=True ):
        if self.re:
            result = self.re.match(instring,loc)
            if not result:
                raise ParseException(instring, loc, self.errmsg, self)

            loc = result.end()
            return loc, result.group()

        if not(instring[ loc ] in self.initChars):
            raise ParseException(instring, loc, self.errmsg, self)

        start = loc
        loc += 1
        instrlen = len(instring)
        bodychars = self.bodyChars
        maxloc = start + self.maxLen
        maxloc = min( maxloc, instrlen )
        while loc < maxloc and instring[loc] in bodychars:
            loc += 1

        throwException = False
        if loc - start < self.minLen:
            throwException = True
        if self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
            throwException = True
        if self.asKeyword:
            if (start>0 and instring[start-1] in bodychars) or (loc<instrlen and instring[loc] in bodychars):
                throwException = True

        if throwException:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]

    def __str__( self ):
        try:
            return super(Word,self).__str__()
        except Exception:
            pass


        if self.strRepr is None:

            def charsAsStr(s):
                if len(s)>4:
                    return s[:4]+"..."
                else:
                    return s

            if ( self.initCharsOrig != self.bodyCharsOrig ):
                self.strRepr = "W:(%s,%s)" % ( charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig) )
            else:
                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)

        return self.strRepr


class Regex(Token):
    r"""
    Token for matching strings that match a given regular expression.
    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
    named parse results.

    Example::
        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    """
    compiledREtype = type(re.compile("[A-Z]"))
    def __init__( self, pattern, flags=0):
        """The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags."""
        super(Regex,self).__init__()

        if isinstance(pattern, basestring):
            if not pattern:
                warnings.warn("null string passed to Regex; use Empty() instead",
                        SyntaxWarning, stacklevel=2)

            self.pattern = pattern
            self.flags = flags

            try:
                self.re = re.compile(self.pattern, self.flags)
                self.reString = self.pattern
            except sre_constants.error:
                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
                    SyntaxWarning, stacklevel=2)
                raise

        elif isinstance(pattern, Regex.compiledREtype):
            self.re = pattern
            self.pattern = \
            self.reString = str(pattern)
            self.flags = flags
            
        else:
            raise ValueError("Regex may only be constructed with a string or a compiled RE object")

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        result = self.re.match(instring,loc)
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        d = result.groupdict()
        ret = ParseResults(result.group())
        if d:
            for k in d:
                ret[k] = d[k]
        return loc,ret

    def __str__( self ):
        try:
            return super(Regex,self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "Re:(%s)" % repr(self.pattern)

        return self.strRepr


class QuotedString(Token):
    r"""
    Token for matching strings that are delimited by quoting characters.
    
    Defined with the following parameters:
        - quoteChar - string of one or more characters defining the quote delimiting string
        - escChar - character to escape quotes, typically backslash (default=C{None})
        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})

    Example::
        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
    prints::
        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    """
    def __init__( self, quoteChar, escChar=None, escQuote=None, multiline=False, unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
        super(QuotedString,self).__init__()

        # remove white space from quote chars - wont work anyway
        quoteChar = quoteChar.strip()
        if not quoteChar:
            warnings.warn("quoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
            raise SyntaxError()

        if endQuoteChar is None:
            endQuoteChar = quoteChar
        else:
            endQuoteChar = endQuoteChar.strip()
            if not endQuoteChar:
                warnings.warn("endQuoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
                raise SyntaxError()

        self.quoteChar = quoteChar
        self.quoteCharLen = len(quoteChar)
        self.firstQuoteChar = quoteChar[0]
        self.endQuoteChar = endQuoteChar
        self.endQuoteCharLen = len(endQuoteChar)
        self.escChar = escChar
        self.escQuote = escQuote
        self.unquoteResults = unquoteResults
        self.convertWhitespaceEscapes = convertWhitespaceEscapes

        if multiline:
            self.flags = re.MULTILINE | re.DOTALL
            self.pattern = r'%s(?:[^%s%s]' % \
                ( re.escape(self.quoteChar),
                  _escapeRegexRangeChars(self.endQuoteChar[0]),
                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
        else:
            self.flags = 0
            self.pattern = r'%s(?:[^%s\n\r%s]' % \
                ( re.escape(self.quoteChar),
                  _escapeRegexRangeChars(self.endQuoteChar[0]),
                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
        if len(self.endQuoteChar) > 1:
            self.pattern += (
                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
                                               _escapeRegexRangeChars(self.endQuoteChar[i]))
                                    for i in range(len(self.endQuoteChar)-1,0,-1)) + ')'
                )
        if escQuote:
            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
        if escChar:
            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
            self.escCharReplacePattern = re.escape(self.escChar)+"(.)"
        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))

        try:
            self.re = re.compile(self.pattern, self.flags)
            self.reString = self.pattern
        except sre_constants.error:
            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
                SyntaxWarning, stacklevel=2)
            raise

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        result = instring[loc] == self.firstQuoteChar and self.re.match(instring,loc) or None
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        ret = result.group()

        if self.unquoteResults:

            # strip off quotes
            ret = ret[self.quoteCharLen:-self.endQuoteCharLen]

            if isinstance(ret,basestring):
                # replace escaped whitespace
                if '\\' in ret and self.convertWhitespaceEscapes:
                    ws_map = {
                        r'\t' : '\t',
                        r'\n' : '\n',
                        r'\f' : '\f',
                        r'\r' : '\r',
                    }
                    for wslit,wschar in ws_map.items():
                        ret = ret.replace(wslit, wschar)

                # replace escaped characters
                if self.escChar:
                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)

                # replace escaped quotes
                if self.escQuote:
                    ret = ret.replace(self.escQuote, self.endQuoteChar)

        return loc, ret

    def __str__( self ):
        try:
            return super(QuotedString,self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)

        return self.strRepr


class CharsNotIn(Token):
    """
    Token for matching words composed of characters I{not} in a given set (will
    include whitespace in matched characters if not listed in the provided exclusion set - see example).
    Defined with string containing all disallowed characters, and an optional
    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction.

    Example::
        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
    prints::
        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    """
    def __init__( self, notChars, min=1, max=0, exact=0 ):
        super(CharsNotIn,self).__init__()
        self.skipWhitespace = False
        self.notChars = notChars

        if min < 1:
            raise ValueError("cannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permitted")

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = ( self.minLen == 0 )
        self.mayIndexError = False

    def parseImpl( self, instring, loc, doActions=True ):
        if instring[loc] in self.notChars:
            raise ParseException(instring, loc, self.errmsg, self)

        start = loc
        loc += 1
        notchars = self.notChars
        maxlen = min( start+self.maxLen, len(instring) )
        while loc < maxlen and \
              (instring[loc] not in notchars):
            loc += 1

        if loc - start < self.minLen:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]

    def __str__( self ):
        try:
            return super(CharsNotIn, self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            if len(self.notChars) > 4:
                self.strRepr = "!W:(%s...)" % self.notChars[:4]
            else:
                self.strRepr = "!W:(%s)" % self.notChars

        return self.strRepr

class White(Token):
    """
    Special matching class for matching whitespace.  Normally, whitespace is ignored
    by pyparsing grammars.  This class is included when some whitespace structures
    are significant.  Define with a string containing the whitespace characters to be
    matched; default is C{" \\t\\r\\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
    as defined for the C{L{Word}} class.
    """
    whiteStrs = {
        " " : "<SPC>",
        "\t": "<TAB>",
        "\n": "<LF>",
        "\r": "<CR>",
        "\f": "<FF>",
        }
    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
        super(White,self).__init__()
        self.matchWhite = ws
        self.setWhitespaceChars( "".join(c for c in self.whiteChars if c not in self.matchWhite) )
        #~ self.leaveWhitespace()
        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
        self.mayReturnEmpty = True
        self.errmsg = "Expected " + self.name

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

    def parseImpl( self, instring, loc, doActions=True ):
        if not(instring[ loc ] in self.matchWhite):
            raise ParseException(instring, loc, self.errmsg, self)
        start = loc
        loc += 1
        maxloc = start + self.maxLen
        maxloc = min( maxloc, len(instring) )
        while loc < maxloc and instring[loc] in self.matchWhite:
            loc += 1

        if loc - start < self.minLen:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]


class _PositionToken(Token):
    def __init__( self ):
        super(_PositionToken,self).__init__()
        self.name=self.__class__.__name__
        self.mayReturnEmpty = True
        self.mayIndexError = False

class GoToColumn(_PositionToken):
    """
    Token to advance to a specific column of input text; useful for tabular report scraping.
    """
    def __init__( self, colno ):
        super(GoToColumn,self).__init__()
        self.col = colno

    def preParse( self, instring, loc ):
        if col(loc,instring) != self.col:
            instrlen = len(instring)
            if self.ignoreExprs:
                loc = self._skipIgnorables( instring, loc )
            while loc < instrlen and instring[loc].isspace() and col( loc, instring ) != self.col :
                loc += 1
        return loc

    def parseImpl( self, instring, loc, doActions=True ):
        thiscol = col( loc, instring )
        if thiscol > self.col:
            raise ParseException( instring, loc, "Text not in expected column", self )
        newloc = loc + self.col - thiscol
        ret = instring[ loc: newloc ]
        return newloc, ret


class LineStart(_PositionToken):
    """
    Matches if current position is at the beginning of a line within the parse string
    
    Example::
    
        test = '''\
        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)
    
    Prints::
        ['AAA', ' this line']
        ['AAA', ' and this line']    

    """
    def __init__( self ):
        super(LineStart,self).__init__()
        self.errmsg = "Expected start of line"

    def parseImpl( self, instring, loc, doActions=True ):
        if col(loc, instring) == 1:
            return loc, []
        raise ParseException(instring, loc, self.errmsg, self)

class LineEnd(_PositionToken):
    """
    Matches if current position is at the end of a line within the parse string
    """
    def __init__( self ):
        super(LineEnd,self).__init__()
        self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
        self.errmsg = "Expected end of line"

    def parseImpl( self, instring, loc, doActions=True ):
        if loc<len(instring):
            if instring[loc] == "\n":
                return loc+1, "\n"
            else:
                raise ParseException(instring, loc, self.errmsg, self)
        elif loc == len(instring):
            return loc+1, []
        else:
            raise ParseException(instring, loc, self.errmsg, self)

class StringStart(_PositionToken):
    """
    Matches if current position is at the beginning of the parse string
    """
    def __init__( self ):
        super(StringStart,self).__init__()
        self.errmsg = "Expected start of text"

    def parseImpl( self, instring, loc, doActions=True ):
        if loc != 0:
            # see if entire string up to here is just whitespace and ignoreables
            if loc != self.preParse( instring, 0 ):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

class StringEnd(_PositionToken):
    """
    Matches if current position is at the end of the parse string
    """
    def __init__( self ):
        super(StringEnd,self).__init__()
        self.errmsg = "Expected end of text"

    def parseImpl( self, instring, loc, doActions=True ):
        if loc < len(instring):
            raise ParseException(instring, loc, self.errmsg, self)
        elif loc == len(instring):
            return loc+1, []
        elif loc > len(instring):
            return loc, []
        else:
            raise ParseException(instring, loc, self.errmsg, self)

class WordStart(_PositionToken):
    """
    Matches if the current position is at the beginning of a Word, and
    is not preceded by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
    the string being parsed, or at the beginning of a line.
    """
    def __init__(self, wordChars = printables):
        super(WordStart,self).__init__()
        self.wordChars = set(wordChars)
        self.errmsg = "Not at the start of a word"

    def parseImpl(self, instring, loc, doActions=True ):
        if loc != 0:
            if (instring[loc-1] in self.wordChars or
                instring[loc] not in self.wordChars):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

class WordEnd(_PositionToken):
    """
    Matches if the current position is at the end of a Word, and
    is not followed by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
    the string being parsed, or at the end of a line.
    """
    def __init__(self, wordChars = printables):
        super(WordEnd,self).__init__()
        self.wordChars = set(wordChars)
        self.skipWhitespace = False
        self.errmsg = "Not at the end of a word"

    def parseImpl(self, instring, loc, doActions=True ):
        instrlen = len(instring)
        if instrlen>0 and loc<instrlen:
            if (instring[loc] in self.wordChars or
                instring[loc-1] not in self.wordChars):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []


class ParseExpression(ParserElement):
    """
    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
    """
    def __init__( self, exprs, savelist = False ):
        super(ParseExpression,self).__init__(savelist)
        if isinstance( exprs, _generatorType ):
            exprs = list(exprs)

        if isinstance( exprs, basestring ):
            self.exprs = [ ParserElement._literalStringClass( exprs ) ]
        elif isinstance( exprs, Iterable ):
            exprs = list(exprs)
            # if sequence of strings provided, wrap with Literal
            if all(isinstance(expr, basestring) for expr in exprs):
                exprs = map(ParserElement._literalStringClass, exprs)
            self.exprs = list(exprs)
        else:
            try:
                self.exprs = list( exprs )
            except TypeError:
                self.exprs = [ exprs ]
        self.callPreparse = False

    def __getitem__( self, i ):
        return self.exprs[i]

    def append( self, other ):
        self.exprs.append( other )
        self.strRepr = None
        return self

    def leaveWhitespace( self ):
        """Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
           all contained expressions."""
        self.skipWhitespace = False
        self.exprs = [ e.copy() for e in self.exprs ]
        for e in self.exprs:
            e.leaveWhitespace()
        return self

    def ignore( self, other ):
        if isinstance( other, Suppress ):
            if other not in self.ignoreExprs:
                super( ParseExpression, self).ignore( other )
                for e in self.exprs:
                    e.ignore( self.ignoreExprs[-1] )
        else:
            super( ParseExpression, self).ignore( other )
            for e in self.exprs:
                e.ignore( self.ignoreExprs[-1] )
        return self

    def __str__( self ):
        try:
            return super(ParseExpression,self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.exprs) )
        return self.strRepr

    def streamline( self ):
        super(ParseExpression,self).streamline()

        for e in self.exprs:
            e.streamline()

        # collapse nested And's of the form And( And( And( a,b), c), d) to And( a,b,c,d )
        # but only if there are no parse actions or resultsNames on the nested And's
        # (likewise for Or's and MatchFirst's)
        if ( len(self.exprs) == 2 ):
            other = self.exprs[0]
            if ( isinstance( other, self.__class__ ) and
                  not(other.parseAction) and
                  other.resultsName is None and
                  not other.debug ):
                self.exprs = other.exprs[:] + [ self.exprs[1] ]
                self.strRepr = None
                self.mayReturnEmpty |= other.mayReturnEmpty
                self.mayIndexError  |= other.mayIndexError

            other = self.exprs[-1]
            if ( isinstance( other, self.__class__ ) and
                  not(other.parseAction) and
                  other.resultsName is None and
                  not other.debug ):
                self.exprs = self.exprs[:-1] + other.exprs[:]
                self.strRepr = None
                self.mayReturnEmpty |= other.mayReturnEmpty
                self.mayIndexError  |= other.mayIndexError

        self.errmsg = "Expected " + _ustr(self)
        
        return self

    def setResultsName( self, name, listAllMatches=False ):
        ret = super(ParseExpression,self).setResultsName(name,listAllMatches)
        return ret

    def validate( self, validateTrace=[] ):
        tmp = validateTrace[:]+[self]
        for e in self.exprs:
            e.validate(tmp)
        self.checkRecursion( [] )
        
    def copy(self):
        ret = super(ParseExpression,self).copy()
        ret.exprs = [e.copy() for e in self.exprs]
        return ret

class And(ParseExpression):
    """
    Requires all given C{ParseExpression}s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'+'} operator.
    May also be constructed using the C{'-'} operator, which will suppress backtracking.

    Example::
        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"),name_expr("name"),integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    """

    class _ErrorStop(Empty):
        def __init__(self, *args, **kwargs):
            super(And._ErrorStop,self).__init__(*args, **kwargs)
            self.name = '-'
            self.leaveWhitespace()

    def __init__( self, exprs, savelist = True ):
        super(And,self).__init__(exprs, savelist)
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        self.setWhitespaceChars( self.exprs[0].whiteChars )
        self.skipWhitespace = self.exprs[0].skipWhitespace
        self.callPreparse = True

    def parseImpl( self, instring, loc, doActions=True ):
        # pass False as last arg to _parse for first element, since we already
        # pre-parsed the string as part of our And pre-parsing
        loc, resultlist = self.exprs[0]._parse( instring, loc, doActions, callPreParse=False )
        errorStop = False
        for e in self.exprs[1:]:
            if isinstance(e, And._ErrorStop):
                errorStop = True
                continue
            if errorStop:
                try:
                    loc, exprtokens = e._parse( instring, loc, doActions )
                except ParseSyntaxException:
                    raise
                except ParseBaseException as pe:
                    pe.__traceback__ = None
                    raise ParseSyntaxException._from_exception(pe)
                except IndexError:
                    raise ParseSyntaxException(instring, len(instring), self.errmsg, self)
            else:
                loc, exprtokens = e._parse( instring, loc, doActions )
            if exprtokens or exprtokens.haskeys():
                resultlist += exprtokens
        return loc, resultlist

    def __iadd__(self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        return self.append( other ) #And( [ self, other ] )

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )
            if not e.mayReturnEmpty:
                break

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr


class Or(ParseExpression):
    """
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the expression that matches the longest string will be used.
    May be constructed using the C{'^'} operator.

    Example::
        # construct Or using '^' operator
        
        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))
    prints::
        [['123'], ['3.1416'], ['789']]
    """
    def __init__( self, exprs, savelist = False ):
        super(Or,self).__init__(exprs, savelist)
        if self.exprs:
            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
        else:
            self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        maxExcLoc = -1
        maxException = None
        matches = []
        for e in self.exprs:
            try:
                loc2 = e.tryParse( instring, loc )
            except ParseException as err:
                err.__traceback__ = None
                if err.loc > maxExcLoc:
                    maxException = err
                    maxExcLoc = err.loc
            except IndexError:
                if len(instring) > maxExcLoc:
                    maxException = ParseException(instring,len(instring),e.errmsg,self)
                    maxExcLoc = len(instring)
            else:
                # save match among all matches, to retry longest to shortest
                matches.append((loc2, e))

        if matches:
            matches.sort(key=lambda x: -x[0])
            for _,e in matches:
                try:
                    return e._parse( instring, loc, doActions )
                except ParseException as err:
                    err.__traceback__ = None
                    if err.loc > maxExcLoc:
                        maxException = err
                        maxExcLoc = err.loc

        if maxException is not None:
            maxException.msg = self.errmsg
            raise maxException
        else:
            raise ParseException(instring, loc, "no defined alternatives to match", self)


    def __ixor__(self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        return self.append( other ) #Or( [ self, other ] )

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )


class MatchFirst(ParseExpression):
    """
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the first one listed is the one that will match.
    May be constructed using the C{'|'} operator.

    Example::
        # construct MatchFirst using '|' operator
        
        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    """
    def __init__( self, exprs, savelist = False ):
        super(MatchFirst,self).__init__(exprs, savelist)
        if self.exprs:
            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
        else:
            self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        maxExcLoc = -1
        maxException = None
        for e in self.exprs:
            try:
                ret = e._parse( instring, loc, doActions )
                return ret
            except ParseException as err:
                if err.loc > maxExcLoc:
                    maxException = err
                    maxExcLoc = err.loc
            except IndexError:
                if len(instring) > maxExcLoc:
                    maxException = ParseException(instring,len(instring),e.errmsg,self)
                    maxExcLoc = len(instring)

        # only got here if no expression matched, raise exception for match that made it the furthest
        else:
            if maxException is not None:
                maxException.msg = self.errmsg
                raise maxException
            else:
                raise ParseException(instring, loc, "no defined alternatives to match", self)

    def __ior__(self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        return self.append( other ) #MatchFirst( [ self, other ] )

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )


class Each(ParseExpression):
    """
    Requires all given C{ParseExpression}s to be found, but in any order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'&'} operator.

    Example::
        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order 
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )
    prints::
        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    """
    def __init__( self, exprs, savelist = True ):
        super(Each,self).__init__(exprs, savelist)
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        self.skipWhitespace = True
        self.initExprGroups = True

    def parseImpl( self, instring, loc, doActions=True ):
        if self.initExprGroups:
            self.opt1map = dict((id(e.expr),e) for e in self.exprs if isinstance(e,Optional))
            opt1 = [ e.expr for e in self.exprs if isinstance(e,Optional) ]
            opt2 = [ e for e in self.exprs if e.mayReturnEmpty and not isinstance(e,Optional)]
            self.optionals = opt1 + opt2
            self.multioptionals = [ e.expr for e in self.exprs if isinstance(e,ZeroOrMore) ]
            self.multirequired = [ e.expr for e in self.exprs if isinstance(e,OneOrMore) ]
            self.required = [ e for e in self.exprs if not isinstance(e,(Optional,ZeroOrMore,OneOrMore)) ]
            self.required += self.multirequired
            self.initExprGroups = False
        tmpLoc = loc
        tmpReqd = self.required[:]
        tmpOpt  = self.optionals[:]
        matchOrder = []

        keepMatching = True
        while keepMatching:
            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
            failed = []
            for e in tmpExprs:
                try:
                    tmpLoc = e.tryParse( instring, tmpLoc )
                except ParseException:
                    failed.append(e)
                else:
                    matchOrder.append(self.opt1map.get(id(e),e))
                    if e in tmpReqd:
                        tmpReqd.remove(e)
                    elif e in tmpOpt:
                        tmpOpt.remove(e)
            if len(failed) == len(tmpExprs):
                keepMatching = False

        if tmpReqd:
            missing = ", ".join(_ustr(e) for e in tmpReqd)
            raise ParseException(instring,loc,"Missing one or more required elements (%s)" % missing )

        # add any unmatched Optionals, in case they have default values defined
        matchOrder += [e for e in self.exprs if isinstance(e,Optional) and e.expr in tmpOpt]

        resultlist = []
        for e in matchOrder:
            loc,results = e._parse(instring,loc,doActions)
            resultlist.append(results)

        finalResults = sum(resultlist, ParseResults([]))
        return loc, finalResults

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )


class ParseElementEnhance(ParserElement):
    """
    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
    """
    def __init__( self, expr, savelist=False ):
        super(ParseElementEnhance,self).__init__(savelist)
        if isinstance( expr, basestring ):
            if issubclass(ParserElement._literalStringClass, Token):
                expr = ParserElement._literalStringClass(expr)
            else:
                expr = ParserElement._literalStringClass(Literal(expr))
        self.expr = expr
        self.strRepr = None
        if expr is not None:
            self.mayIndexError = expr.mayIndexError
            self.mayReturnEmpty = expr.mayReturnEmpty
            self.setWhitespaceChars( expr.whiteChars )
            self.skipWhitespace = expr.skipWhitespace
            self.saveAsList = expr.saveAsList
            self.callPreparse = expr.callPreparse
            self.ignoreExprs.extend(expr.ignoreExprs)

    def parseImpl( self, instring, loc, doActions=True ):
        if self.expr is not None:
            return self.expr._parse( instring, loc, doActions, callPreParse=False )
        else:
            raise ParseException("",loc,self.errmsg,self)

    def leaveWhitespace( self ):
        self.skipWhitespace = False
        self.expr = self.expr.copy()
        if self.expr is not None:
            self.expr.leaveWhitespace()
        return self

    def ignore( self, other ):
        if isinstance( other, Suppress ):
            if other not in self.ignoreExprs:
                super( ParseElementEnhance, self).ignore( other )
                if self.expr is not None:
                    self.expr.ignore( self.ignoreExprs[-1] )
        else:
            super( ParseElementEnhance, self).ignore( other )
            if self.expr is not None:
                self.expr.ignore( self.ignoreExprs[-1] )
        return self

    def streamline( self ):
        super(ParseElementEnhance,self).streamline()
        if self.expr is not None:
            self.expr.streamline()
        return self

    def checkRecursion( self, parseElementList ):
        if self in parseElementList:
            raise RecursiveGrammarException( parseElementList+[self] )
        subRecCheckList = parseElementList[:] + [ self ]
        if self.expr is not None:
            self.expr.checkRecursion( subRecCheckList )

    def validate( self, validateTrace=[] ):
        tmp = validateTrace[:]+[self]
        if self.expr is not None:
            self.expr.validate(tmp)
        self.checkRecursion( [] )

    def __str__( self ):
        try:
            return super(ParseElementEnhance,self).__str__()
        except Exception:
            pass

        if self.strRepr is None and self.expr is not None:
            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.expr) )
        return self.strRepr


class FollowedBy(ParseElementEnhance):
    """
    Lookahead matching of the given parse expression.  C{FollowedBy}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression matches at the current
    position.  C{FollowedBy} always returns a null token list.

    Example::
        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
    prints::
        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    """
    def __init__( self, expr ):
        super(FollowedBy,self).__init__(expr)
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        self.expr.tryParse( instring, loc )
        return loc, []


class NotAny(ParseElementEnhance):
    """
    Lookahead to disallow matching with the given parse expression.  C{NotAny}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression does I{not} match at the current
    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
    always returns a null token list.  May be constructed using the '~' operator.

    Example::
        
    """
    def __init__( self, expr ):
        super(NotAny,self).__init__(expr)
        #~ self.leaveWhitespace()
        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
        self.mayReturnEmpty = True
        self.errmsg = "Found unwanted token, "+_ustr(self.expr)

    def parseImpl( self, instring, loc, doActions=True ):
        if self.expr.canParseNext(instring, loc):
            raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "~{" + _ustr(self.expr) + "}"

        return self.strRepr

class _MultipleMatch(ParseElementEnhance):
    def __init__( self, expr, stopOn=None):
        super(_MultipleMatch, self).__init__(expr)
        self.saveAsList = True
        ender = stopOn
        if isinstance(ender, basestring):
            ender = ParserElement._literalStringClass(ender)
        self.not_ender = ~ender if ender is not None else None

    def parseImpl( self, instring, loc, doActions=True ):
        self_expr_parse = self.expr._parse
        self_skip_ignorables = self._skipIgnorables
        check_ender = self.not_ender is not None
        if check_ender:
            try_not_ender = self.not_ender.tryParse
        
        # must be at least one (but first see if we are the stopOn sentinel;
        # if so, fail)
        if check_ender:
            try_not_ender(instring, loc)
        loc, tokens = self_expr_parse( instring, loc, doActions, callPreParse=False )
        try:
            hasIgnoreExprs = (not not self.ignoreExprs)
            while 1:
                if check_ender:
                    try_not_ender(instring, loc)
                if hasIgnoreExprs:
                    preloc = self_skip_ignorables( instring, loc )
                else:
                    preloc = loc
                loc, tmptokens = self_expr_parse( instring, preloc, doActions )
                if tmptokens or tmptokens.haskeys():
                    tokens += tmptokens
        except (ParseException,IndexError):
            pass

        return loc, tokens
        
class OneOrMore(_MultipleMatch):
    """
    Repetition of one or more of the given expression.
    
    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
        
        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    """

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + _ustr(self.expr) + "}..."

        return self.strRepr

class ZeroOrMore(_MultipleMatch):
    """
    Optional repetition of zero or more of the given expression.
    
    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example: similar to L{OneOrMore}
    """
    def __init__( self, expr, stopOn=None):
        super(ZeroOrMore,self).__init__(expr, stopOn=stopOn)
        self.mayReturnEmpty = True
        
    def parseImpl( self, instring, loc, doActions=True ):
        try:
            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
        except (ParseException,IndexError):
            return loc, []

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "[" + _ustr(self.expr) + "]..."

        return self.strRepr

class _NullToken(object):
    def __bool__(self):
        return False
    __nonzero__ = __bool__
    def __str__(self):
        return ""

_optionalNotMatched = _NullToken()
class Optional(ParseElementEnhance):
    """
    Optional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::
        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345
            
            # ZIP+4 form
            12101-0001
            
            # invalid ZIP
            98765-
            ''')
    prints::
        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    """
    def __init__( self, expr, default=_optionalNotMatched ):
        super(Optional,self).__init__( expr, savelist=False )
        self.saveAsList = self.expr.saveAsList
        self.defaultValue = default
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        try:
            loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
        except (ParseException,IndexError):
            if self.defaultValue is not _optionalNotMatched:
                if self.expr.resultsName:
                    tokens = ParseResults([ self.defaultValue ])
                    tokens[self.expr.resultsName] = self.defaultValue
                else:
                    tokens = [ self.defaultValue ]
            else:
                tokens = []
        return loc, tokens

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "[" + _ustr(self.expr) + "]"

        return self.strRepr

class SkipTo(ParseElementEnhance):
    """
    Token for skipping over all undefined text until the matched expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default=C{False}) if True, the target expression is also parsed 
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
          comments) that might contain false matches to the target expression
     - failOn - (default=C{None}) define expressions that are not allowed to be 
          included in the skipped test; if found before the target expression is found, 
          the SkipTo is not a match

    Example::
        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP 
                      + string_data("sev") + SEP 
                      + string_data("desc") + SEP 
                      + integer("days_open"))
        
        for tkt in ticket_expr.searchString(report):
            print tkt.dump()
    prints::
        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    """
    def __init__( self, other, include=False, ignore=None, failOn=None ):
        super( SkipTo, self ).__init__( other )
        self.ignoreExpr = ignore
        self.mayReturnEmpty = True
        self.mayIndexError = False
        self.includeMatch = include
        self.asList = False
        if isinstance(failOn, basestring):
            self.failOn = ParserElement._literalStringClass(failOn)
        else:
            self.failOn = failOn
        self.errmsg = "No match found for "+_ustr(self.expr)

    def parseImpl( self, instring, loc, doActions=True ):
        startloc = loc
        instrlen = len(instring)
        expr = self.expr
        expr_parse = self.expr._parse
        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
        
        tmploc = loc
        while tmploc <= instrlen:
            if self_failOn_canParseNext is not None:
                # break if failOn expression matches
                if self_failOn_canParseNext(instring, tmploc):
                    break
                    
            if self_ignoreExpr_tryParse is not None:
                # advance past ignore expressions
                while 1:
                    try:
                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
                    except ParseBaseException:
                        break
            
            try:
                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
            except (ParseException, IndexError):
                # no match, advance loc in string
                tmploc += 1
            else:
                # matched skipto expr, done
                break

        else:
            # ran off the end of the input string without matching skipto expr, fail
            raise ParseException(instring, loc, self.errmsg, self)

        # build up return values
        loc = tmploc
        skiptext = instring[startloc:loc]
        skipresult = ParseResults(skiptext)
        
        if self.includeMatch:
            loc, mat = expr_parse(instring,loc,doActions,callPreParse=False)
            skipresult += mat

        return loc, skipresult

class Forward(ParseElementEnhance):
    """
    Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.

    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
    Specifically, '|' has a lower precedence than '<<', so that::
        fwdExpr << a | b | c
    will actually be evaluated as::
        (fwdExpr << a) | b | c
    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the C{Forward}::
        fwdExpr << (a | b | c)
    Converting to use the '<<=' operator instead will avoid this problem.

    See L{ParseResults.pprint} for an example of a recursive parser created using
    C{Forward}.
    """
    def __init__( self, other=None ):
        super(Forward,self).__init__( other, savelist=False )

    def __lshift__( self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass(other)
        self.expr = other
        self.strRepr = None
        self.mayIndexError = self.expr.mayIndexError
        self.mayReturnEmpty = self.expr.mayReturnEmpty
        self.setWhitespaceChars( self.expr.whiteChars )
        self.skipWhitespace = self.expr.skipWhitespace
        self.saveAsList = self.expr.saveAsList
        self.ignoreExprs.extend(self.expr.ignoreExprs)
        return self
        
    def __ilshift__(self, other):
        return self << other
    
    def leaveWhitespace( self ):
        self.skipWhitespace = False
        return self

    def streamline( self ):
        if not self.streamlined:
            self.streamlined = True
            if self.expr is not None:
                self.expr.streamline()
        return self

    def validate( self, validateTrace=[] ):
        if self not in validateTrace:
            tmp = validateTrace[:]+[self]
            if self.expr is not None:
                self.expr.validate(tmp)
        self.checkRecursion([])

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name
        return self.__class__.__name__ + ": ..."

        # stubbed out for now - creates awful memory and perf issues
        self._revertClass = self.__class__
        self.__class__ = _ForwardNoRecurse
        try:
            if self.expr is not None:
                retString = _ustr(self.expr)
            else:
                retString = "None"
        finally:
            self.__class__ = self._revertClass
        return self.__class__.__name__ + ": " + retString

    def copy(self):
        if self.expr is not None:
            return super(Forward,self).copy()
        else:
            ret = Forward()
            ret <<= self
            return ret

class _ForwardNoRecurse(Forward):
    def __str__( self ):
        return "..."

class TokenConverter(ParseElementEnhance):
    """
    Abstract subclass of C{ParseExpression}, for converting parsed results.
    """
    def __init__( self, expr, savelist=False ):
        super(TokenConverter,self).__init__( expr )#, savelist )
        self.saveAsList = False

class Combine(TokenConverter):
    """
    Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the input string;
    this can be disabled by specifying C{'adjacent=False'} in the constructor.

    Example::
        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    """
    def __init__( self, expr, joinString="", adjacent=True ):
        super(Combine,self).__init__( expr )
        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
        if adjacent:
            self.leaveWhitespace()
        self.adjacent = adjacent
        self.skipWhitespace = True
        self.joinString = joinString
        self.callPreparse = True

    def ignore( self, other ):
        if self.adjacent:
            ParserElement.ignore(self, other)
        else:
            super( Combine, self).ignore( other )
        return self

    def postParse( self, instring, loc, tokenlist ):
        retToks = tokenlist.copy()
        del retToks[:]
        retToks += ParseResults([ "".join(tokenlist._asStringList(self.joinString)) ], modal=self.modalResults)

        if self.resultsName and retToks.haskeys():
            return [ retToks ]
        else:
            return retToks

class Group(TokenConverter):
    """
    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.

    Example::
        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
    """
    def __init__( self, expr ):
        super(Group,self).__init__( expr )
        self.saveAsList = True

    def postParse( self, instring, loc, tokenlist ):
        return [ tokenlist ]

class Dict(TokenConverter):
    """
    Converter to return a repetitive expression as a list, but also as a dictionary.
    Each element can also be referenced using the first token in the expression as its key.
    Useful for tabular report scraping when the first column can be used as a item key.

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())
        
        # access named fields as dict entries, or output as dict
        print(result['shape'])        
        print(result.asDict())
    prints::
        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
    See more examples at L{ParseResults} of accessing fields by results name.
    """
    def __init__( self, expr ):
        super(Dict,self).__init__( expr )
        self.saveAsList = True

    def postParse( self, instring, loc, tokenlist ):
        for i,tok in enumerate(tokenlist):
            if len(tok) == 0:
                continue
            ikey = tok[0]
            if isinstance(ikey,int):
                ikey = _ustr(tok[0]).strip()
            if len(tok)==1:
                tokenlist[ikey] = _ParseResultsWithOffset("",i)
            elif len(tok)==2 and not isinstance(tok[1],ParseResults):
                tokenlist[ikey] = _ParseResultsWithOffset(tok[1],i)
            else:
                dictvalue = tok.copy() #ParseResults(i)
                del dictvalue[0]
                if len(dictvalue)!= 1 or (isinstance(dictvalue,ParseResults) and dictvalue.haskeys()):
                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue,i)
                else:
                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0],i)

        if self.resultsName:
            return [ tokenlist ]
        else:
            return tokenlist


class Suppress(TokenConverter):
    """
    Converter for ignoring the results of a parsed expression.

    Example::
        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))
    prints::
        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']
    (See also L{delimitedList}.)
    """
    def postParse( self, instring, loc, tokenlist ):
        return []

    def suppress( self ):
        return self


class OnlyOnce(object):
    """
    Wrapper for parse actions, to ensure they are only called once.
    """
    def __init__(self, methodCall):
        self.callable = _trim_arity(methodCall)
        self.called = False
    def __call__(self,s,l,t):
        if not self.called:
            results = self.callable(s,l,t)
            self.called = True
            return results
        raise ParseException(s,l,"")
    def reset(self):
        self.called = False

def traceParseAction(f):
    """
    Decorator for debugging parse actions. 
    
    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.

    Example::
        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
    prints::
        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    """
    f = _trim_arity(f)
    def z(*paArgs):
        thisFunc = f.__name__
        s,l,t = paArgs[-3:]
        if len(paArgs)>3:
            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
        sys.stderr.write( ">>entering %s(line: '%s', %d, %r)\n" % (thisFunc,line(l,s),l,t) )
        try:
            ret = f(*paArgs)
        except Exception as exc:
            sys.stderr.write( "<<leaving %s (exception: %s)\n" % (thisFunc,exc) )
            raise
        sys.stderr.write( "<<leaving %s (ret: %r)\n" % (thisFunc,ret) )
        return ret
    try:
        z.__name__ = f.__name__
    except AttributeError:
        pass
    return z

#
# global helpers
#
def delimitedList( expr, delim=",", combine=False ):
    """
    Helper to define a delimited list of expressions - the delimiter defaults to ','.
    By default, the list elements and delimiters can have intervening whitespace, and
    comments, but this can be overridden by passing C{combine=True} in the constructor.
    If C{combine} is set to C{True}, the matching tokens are returned as a single token
    string, with the delimiters included; otherwise, the matching tokens are returned
    as a list of tokens, with the delimiters suppressed.

    Example::
        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    """
    dlName = _ustr(expr)+" ["+_ustr(delim)+" "+_ustr(expr)+"]..."
    if combine:
        return Combine( expr + ZeroOrMore( delim + expr ) ).setName(dlName)
    else:
        return ( expr + ZeroOrMore( Suppress( delim ) + expr ) ).setName(dlName)

def countedArray( expr, intExpr=None ):
    """
    Helper to define a counted list of expressions.
    This helper defines a pattern of the form::
        integer expr expr expr...
    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
    
    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.

    Example::
        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    """
    arrayExpr = Forward()
    def countFieldParseAction(s,l,t):
        n = t[0]
        arrayExpr << (n and Group(And([expr]*n)) or Group(empty))
        return []
    if intExpr is None:
        intExpr = Word(nums).setParseAction(lambda t:int(t[0]))
    else:
        intExpr = intExpr.copy()
    intExpr.setName("arrayLen")
    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
    return ( intExpr + arrayExpr ).setName('(len) ' + _ustr(expr) + '...')

def _flatten(L):
    ret = []
    for i in L:
        if isinstance(i,list):
            ret.extend(_flatten(i))
        else:
            ret.append(i)
    return ret

def matchPreviousLiteral(expr):
    """
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
    If this is not desired, use C{matchPreviousExpr}.
    Do I{not} use with packrat parsing enabled.
    """
    rep = Forward()
    def copyTokenToRepeater(s,l,t):
        if t:
            if len(t) == 1:
                rep << t[0]
            else:
                # flatten t tokens
                tflat = _flatten(t.asList())
                rep << And(Literal(tt) for tt in tflat)
        else:
            rep << Empty()
    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
    rep.setName('(prev) ' + _ustr(expr))
    return rep

def matchPreviousExpr(expr):
    """
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
    the expressions are evaluated first, and then compared, so
    C{"1"} is compared with C{"10"}.
    Do I{not} use with packrat parsing enabled.
    """
    rep = Forward()
    e2 = expr.copy()
    rep <<= e2
    def copyTokenToRepeater(s,l,t):
        matchTokens = _flatten(t.asList())
        def mustMatchTheseTokens(s,l,t):
            theseTokens = _flatten(t.asList())
            if  theseTokens != matchTokens:
                raise ParseException("",0,"")
        rep.setParseAction( mustMatchTheseTokens, callDuringTry=True )
    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
    rep.setName('(prev) ' + _ustr(expr))
    return rep

def _escapeRegexRangeChars(s):
    #~  escape these chars: ^-]
    for c in r"\^-]":
        s = s.replace(c,_bslash+c)
    s = s.replace("\n",r"\n")
    s = s.replace("\t",r"\t")
    return _ustr(s)

def oneOf( strs, caseless=False, useRegex=True ):
    """
    Helper to quickly define a set of alternative Literals, and makes sure to do
    longest-first testing when there is a conflict, regardless of the input order,
    but returns a C{L{MatchFirst}} for best performance.

    Parameters:
     - strs - a string of space-delimited literals, or a collection of string literals
     - caseless - (default=C{False}) - treat all literals as caseless
     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
          if creating a C{Regex} raises an exception)

    Example::
        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
    prints::
        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    """
    if caseless:
        isequal = ( lambda a,b: a.upper() == b.upper() )
        masks = ( lambda a,b: b.upper().startswith(a.upper()) )
        parseElementClass = CaselessLiteral
    else:
        isequal = ( lambda a,b: a == b )
        masks = ( lambda a,b: b.startswith(a) )
        parseElementClass = Literal

    symbols = []
    if isinstance(strs,basestring):
        symbols = strs.split()
    elif isinstance(strs, Iterable):
        symbols = list(strs)
    else:
        warnings.warn("Invalid argument to oneOf, expected string or iterable",
                SyntaxWarning, stacklevel=2)
    if not symbols:
        return NoMatch()

    i = 0
    while i < len(symbols)-1:
        cur = symbols[i]
        for j,other in enumerate(symbols[i+1:]):
            if ( isequal(other, cur) ):
                del symbols[i+j+1]
                break
            elif ( masks(cur, other) ):
                del symbols[i+j+1]
                symbols.insert(i,other)
                cur = other
                break
        else:
            i += 1

    if not caseless and useRegex:
        #~ print (strs,"->", "|".join( [ _escapeRegexChars(sym) for sym in symbols] ))
        try:
            if len(symbols)==len("".join(symbols)):
                return Regex( "[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols) ).setName(' | '.join(symbols))
            else:
                return Regex( "|".join(re.escape(sym) for sym in symbols) ).setName(' | '.join(symbols))
        except Exception:
            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
                    SyntaxWarning, stacklevel=2)


    # last resort, just use MatchFirst
    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))

def dictOf( key, value ):
    """
    Helper to easily and clearly define a dictionary by specifying the respective patterns
    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
    in the proper order.  The key pattern can include delimiting markers or punctuation,
    as long as they are suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the C{Dict} results can include named token
    fields.

    Example::
        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())
    prints::
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    """
    return Dict( ZeroOrMore( Group ( key + value ) ) )

def originalTextFor(expr, asString=True):
    """
    Helper to return the original, untokenized text for a given expression.  Useful to
    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
    revert separate tokens with intervening whitespace back to the original matching
    input text. By default, returns astring containing the original parsed text.  
       
    If the optional C{asString} argument is passed as C{False}, then the return value is a 
    C{L{ParseResults}} containing any results names that were originally matched, and a 
    single token containing the original matched text from the input string.  So if 
    the expression passed to C{L{originalTextFor}} contains expressions with defined
    results names, you must set C{asString} to C{False} if you want to preserve those
    results name values.

    Example::
        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b","i"):
            opener,closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])
    prints::
        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    """
    locMarker = Empty().setParseAction(lambda s,loc,t: loc)
    endlocMarker = locMarker.copy()
    endlocMarker.callPreparse = False
    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
    if asString:
        extractText = lambda s,l,t: s[t._original_start:t._original_end]
    else:
        def extractText(s,l,t):
            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
    matchExpr.setParseAction(extractText)
    matchExpr.ignoreExprs = expr.ignoreExprs
    return matchExpr

def ungroup(expr): 
    """
    Helper to undo pyparsing's default grouping of And expressions, even
    if all but one are non-empty.
    """
    return TokenConverter(expr).setParseAction(lambda t:t[0])

def locatedExpr(expr):
    """
    Helper to decorate a returned token with its starting and ending locations in the input string.
    This helper adds the following results names:
     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains C{<TAB>} characters, you may want to call
    C{L{ParserElement.parseWithTabs}}

    Example::
        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)
    prints::
        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    """
    locator = Empty().setParseAction(lambda s,l,t: l)
    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))


# convenience constants for positional expressions
empty       = Empty().setName("empty")
lineStart   = LineStart().setName("lineStart")
lineEnd     = LineEnd().setName("lineEnd")
stringStart = StringStart().setName("stringStart")
stringEnd   = StringEnd().setName("stringEnd")

_escapedPunc = Word( _bslash, r"\[]-*.$+^?()~ ", exact=2 ).setParseAction(lambda s,l,t:t[0][1])
_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s,l,t:unichr(int(t[0].lstrip(r'\0x'),16)))
_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s,l,t:unichr(int(t[0][1:],8)))
_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
_charRange = Group(_singleChar + Suppress("-") + _singleChar)
_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group( OneOrMore( _charRange | _singleChar ) ).setResultsName("body") + "]"

def srange(s):
    r"""
    Helper to easily define string ranges for use in Word construction.  Borrows
    syntax from regexp '[]' string range definitions::
        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
    The input string must be enclosed in []'s, and the returned string is the expanded
    character set joined into a single string.
    The values enclosed in the []'s may be:
     - a single character
     - an escaped character with a leading backslash (such as C{\-} or C{\]})
     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
         (C{\0x##} is also supported for backwards compatibility) 
     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
    """
    _expanded = lambda p: p if not isinstance(p,ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]),ord(p[1])+1))
    try:
        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
    except Exception:
        return ""

def matchOnlyAtCol(n):
    """
    Helper method for defining parse actions that require matching at a specific
    column in the input text.
    """
    def verifyCol(strg,locn,toks):
        if col(locn,strg) != n:
            raise ParseException(strg,locn,"matched token not at column %d" % n)
    return verifyCol

def replaceWith(replStr):
    """
    Helper method for common parse actions that simply return a literal value.  Especially
    useful when used with C{L{transformString<ParserElement.transformString>}()}.

    Example::
        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num
        
        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    """
    return lambda s,l,t: [replStr]

def removeQuotes(s,l,t):
    """
    Helper parse action for removing quotation marks from parsed quoted strings.

    Example::
        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    """
    return t[0][1:-1]

def tokenMap(func, *args):
    """
    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
    args are passed, they are forwarded to the given function as additional arguments after
    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
    parsed data to an integer using base 16.

    Example (compare the last to example in L{ParserElement.transformString}::
        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')
        
        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')
    prints::
        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    """
    def pa(s,l,t):
        return [func(tokn, *args) for tokn in t]

    try:
        func_name = getattr(func, '__name__', 
                            getattr(func, '__class__').__name__)
    except Exception:
        func_name = str(func)
    pa.__name__ = func_name

    return pa

upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
"""(Deprecated) Helper parse action to convert tokens to upper case. Deprecated in favor of L{pyparsing_common.upcaseTokens}"""

downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
"""(Deprecated) Helper parse action to convert tokens to lower case. Deprecated in favor of L{pyparsing_common.downcaseTokens}"""
    
def _makeTags(tagStr, xml):
    """Internal helper to construct opening and closing tag expressions, given a tag name"""
    if isinstance(tagStr,basestring):
        resname = tagStr
        tagStr = Keyword(tagStr, caseless=not xml)
    else:
        resname = tagStr.name

    tagAttrName = Word(alphas,alphanums+"_-:")
    if (xml):
        tagAttrValue = dblQuotedString.copy().setParseAction( removeQuotes )
        openTag = Suppress("<") + tagStr("tag") + \
                Dict(ZeroOrMore(Group( tagAttrName + Suppress("=") + tagAttrValue ))) + \
                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
    else:
        printablesLessRAbrack = "".join(c for c in printables if c not in ">")
        tagAttrValue = quotedString.copy().setParseAction( removeQuotes ) | Word(printablesLessRAbrack)
        openTag = Suppress("<") + tagStr("tag") + \
                Dict(ZeroOrMore(Group( tagAttrName.setParseAction(downcaseTokens) + \
                Optional( Suppress("=") + tagAttrValue ) ))) + \
                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
    closeTag = Combine(_L("</") + tagStr + ">")

    openTag = openTag.setResultsName("start"+"".join(resname.replace(":"," ").title().split())).setName("<%s>" % resname)
    closeTag = closeTag.setResultsName("end"+"".join(resname.replace(":"," ").title().split())).setName("</%s>" % resname)
    openTag.tag = resname
    closeTag.tag = resname
    return openTag, closeTag

def makeHTMLTags(tagStr):
    """
    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.

    Example::
        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
        a,a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end
        
        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
            print(link.link_text, '->', link.href)
    prints::
        pyparsing -> http://pyparsing.wikispaces.com
    """
    return _makeTags( tagStr, False )

def makeXMLTags(tagStr):
    """
    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
    tags only in the given upper/lower case.

    Example: similar to L{makeHTMLTags}
    """
    return _makeTags( tagStr, True )

def withAttribute(*args,**attrDict):
    """
    Helper to create a validating parse action to be used with start tags created
    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
    with a required attribute value, to avoid false matches on common tags such as
    C{<TD>} or C{<DIV>}.

    Call C{withAttribute} with a series of attribute names and values. Specify the list
    of filter attributes names and values as:
     - keyword arguments, as in C{(align="right")}, or
     - as an explicit dict with C{**} operator, when an attribute name is also a Python
          reserved word, as in C{**{"class":"Customer", "align":"right"}}
     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
    For attribute names with a namespace prefix, you must use the second form.  Attribute
    names are matched insensitive to upper/lower case.
       
    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.

    To verify that the attribute exists, but without specifying a value, pass
    C{withAttribute.ANY_VALUE} as the value.

    Example::
        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    """
    if args:
        attrs = args[:]
    else:
        attrs = attrDict.items()
    attrs = [(k,v) for k,v in attrs]
    def pa(s,l,tokens):
        for attrName,attrValue in attrs:
            if attrName not in tokens:
                raise ParseException(s,l,"no matching attribute " + attrName)
            if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue:
                raise ParseException(s,l,"attribute '%s' has value '%s', must be '%s'" %
                                            (attrName, tokens[attrName], attrValue))
    return pa
withAttribute.ANY_VALUE = object()

def withClass(classname, namespace=''):
    """
    Simplified version of C{L{withAttribute}} when matching on a div class - made
    difficult because C{class} is a reserved word in Python.

    Example::
        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))
        
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    """
    classattr = "%s:class" % namespace if namespace else "class"
    return withAttribute(**{classattr : classname})        

opAssoc = _Constants()
opAssoc.LEFT = object()
opAssoc.RIGHT = object()

def infixNotation( baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')') ):
    """
    Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary or
    binary, left- or right-associative.  Parse actions can also be attached
    to operator expressions. The generated parser will also recognize the use 
    of parentheses to override operator precedences (see example below).
    
    Note: if you define a deep operator list, you may see performance issues
    when using infixNotation. See L{ParserElement.enablePackrat} for a
    mechanism to potentially improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the nested
     - opList - list of tuples, one for each operator precedence level in the
      expression grammar; each tuple is of the form
      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
       - opExpr is the pyparsing expression for the operator;
          may also be a string, which will be converted to a Literal;
          if numTerms is 3, opExpr is a tuple of two expressions, for the
          two operators separating the 3 terms
       - numTerms is the number of terms for this operator (must
          be 1, 2, or 3)
       - rightLeftAssoc is the indicator whether the operator is
          right or left associative, using the pyparsing-defined
          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
       - parseAction is the parse action to be associated with
          expressions matching this operator expression (the
          parse action tuple member may be omitted); if the parse action
          is passed a tuple or list of functions, this is equivalent to
          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})

    Example::
        # simple example of four-function arithmetic with ints and variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier 
        
        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])
        
        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)
    prints::
        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    """
    ret = Forward()
    lastExpr = baseExpr | ( lpar + ret + rpar )
    for i,operDef in enumerate(opList):
        opExpr,arity,rightLeftAssoc,pa = (operDef + (None,))[:4]
        termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr
        if arity == 3:
            if opExpr is None or len(opExpr) != 2:
                raise ValueError("if numterms=3, opExpr must be a tuple or list of two expressions")
            opExpr1, opExpr2 = opExpr
        thisExpr = Forward().setName(termName)
        if rightLeftAssoc == opAssoc.LEFT:
            if arity == 1:
                matchExpr = FollowedBy(lastExpr + opExpr) + Group( lastExpr + OneOrMore( opExpr ) )
            elif arity == 2:
                if opExpr is not None:
                    matchExpr = FollowedBy(lastExpr + opExpr + lastExpr) + Group( lastExpr + OneOrMore( opExpr + lastExpr ) )
                else:
                    matchExpr = FollowedBy(lastExpr+lastExpr) + Group( lastExpr + OneOrMore(lastExpr) )
            elif arity == 3:
                matchExpr = FollowedBy(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr) + \
                            Group( lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr )
            else:
                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
        elif rightLeftAssoc == opAssoc.RIGHT:
            if arity == 1:
                # try to avoid LR with this extra test
                if not isinstance(opExpr, Optional):
                    opExpr = Optional(opExpr)
                matchExpr = FollowedBy(opExpr.expr + thisExpr) + Group( opExpr + thisExpr )
            elif arity == 2:
                if opExpr is not None:
                    matchExpr = FollowedBy(lastExpr + opExpr + thisExpr) + Group( lastExpr + OneOrMore( opExpr + thisExpr ) )
                else:
                    matchExpr = FollowedBy(lastExpr + thisExpr) + Group( lastExpr + OneOrMore( thisExpr ) )
            elif arity == 3:
                matchExpr = FollowedBy(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr) + \
                            Group( lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr )
            else:
                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
        else:
            raise ValueError("operator must indicate right or left associativity")
        if pa:
            if isinstance(pa, (tuple, list)):
                matchExpr.setParseAction(*pa)
            else:
                matchExpr.setParseAction(pa)
        thisExpr <<= ( matchExpr.setName(termName) | lastExpr )
        lastExpr = thisExpr
    ret <<= lastExpr
    return ret

operatorPrecedence = infixNotation
"""(Deprecated) Former name of C{L{infixNotation}}, will be dropped in a future release."""

dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"').setName("string enclosed in double quotes")
sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("string enclosed in single quotes")
quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"'|
                       Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("quotedString using single or double quotes")
unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal")

def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()):
    """
    Helper method for defining nested lists enclosed in opening and closing
    delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
     - content - expression for items within the nested lists (default=C{None})
     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})

    If an expression is not provided for the content argument, the nested
    expression will capture all whitespace-delimited content between delimiters
    as a list of separate values.

    Use the C{ignoreExpr} argument to define expressions that may contain
    opening or closing characters that should not be treated as opening
    or closing characters for nesting, such as quotedString or a comment
    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
    The default is L{quotedString}, but if no expressions are to be ignored,
    then pass C{None} for this argument.

    Example::
        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR,RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type") 
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
                      + code_body("body"))
        c_function.ignore(cStyleComment)
        
        source_code = '''
            int is_odd(int x) { 
                return (x%2); 
            }
                
            int dec_to_hex(char hchar) { 
                if (hchar >= '0' && hchar <= '9') { 
                    return (ord(hchar)-ord('0')); 
                } else { 
                    return (10+ord(hchar)-ord('A'));
                } 
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)

    prints::
        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    """
    if opener == closer:
        raise ValueError("opening and closing strings cannot be the same")
    if content is None:
        if isinstance(opener,basestring) and isinstance(closer,basestring):
            if len(opener) == 1 and len(closer)==1:
                if ignoreExpr is not None:
                    content = (Combine(OneOrMore(~ignoreExpr +
                                    CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS,exact=1))
                                ).setParseAction(lambda t:t[0].strip()))
                else:
                    content = (empty.copy()+CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS
                                ).setParseAction(lambda t:t[0].strip()))
            else:
                if ignoreExpr is not None:
                    content = (Combine(OneOrMore(~ignoreExpr + 
                                    ~Literal(opener) + ~Literal(closer) +
                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
                                ).setParseAction(lambda t:t[0].strip()))
                else:
                    content = (Combine(OneOrMore(~Literal(opener) + ~Literal(closer) +
                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
                                ).setParseAction(lambda t:t[0].strip()))
        else:
            raise ValueError("opening and closing arguments must be strings if no content expression is given")
    ret = Forward()
    if ignoreExpr is not None:
        ret <<= Group( Suppress(opener) + ZeroOrMore( ignoreExpr | ret | content ) + Suppress(closer) )
    else:
        ret <<= Group( Suppress(opener) + ZeroOrMore( ret | content )  + Suppress(closer) )
    ret.setName('nested %s%s expression' % (opener,closer))
    return ret

def indentedBlock(blockStatementExpr, indentStack, indent=True):
    """
    Helper method for defining space-delimited indentation blocks, such as
    those used to define block statements in Python source code.

    Parameters:
     - blockStatementExpr - expression defining syntax of statement that
            is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
            (multiple statementWithIndentedBlock expressions within a single grammar
            should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond the
            the current level; set to False for block of left-most statements
            (default=C{True})

    A valid block must contain at least one C{blockStatement}.

    Example::
        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group( funcDecl + func_body )

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << ( funcDef | assignment | identifier )

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()
    prints::
        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
    """
    def checkPeerIndent(s,l,t):
        if l >= len(s): return
        curCol = col(l,s)
        if curCol != indentStack[-1]:
            if curCol > indentStack[-1]:
                raise ParseFatalException(s,l,"illegal nesting")
            raise ParseException(s,l,"not a peer entry")

    def checkSubIndent(s,l,t):
        curCol = col(l,s)
        if curCol > indentStack[-1]:
            indentStack.append( curCol )
        else:
            raise ParseException(s,l,"not a subentry")

    def checkUnindent(s,l,t):
        if l >= len(s): return
        curCol = col(l,s)
        if not(indentStack and curCol < indentStack[-1] and curCol <= indentStack[-2]):
            raise ParseException(s,l,"not an unindent")
        indentStack.pop()

    NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress())
    INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT')
    PEER   = Empty().setParseAction(checkPeerIndent).setName('')
    UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT')
    if indent:
        smExpr = Group( Optional(NL) +
            #~ FollowedBy(blockStatementExpr) +
            INDENT + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) + UNDENT)
    else:
        smExpr = Group( Optional(NL) +
            (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) )
    blockStatementExpr.ignore(_bslash + LineEnd())
    return smExpr.setName('indented block')

alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]")
punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")

anyOpenTag,anyCloseTag = makeHTMLTags(Word(alphas,alphanums+"_:").setName('any tag'))
_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(),'><& "\''))
commonHTMLEntity = Regex('&(?P<entity>' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity")
def replaceHTMLEntity(t):
    """Helper parser action to replace common HTML entities with their special characters"""
    return _htmlEntityMap.get(t.entity)

# it's easy to get these comment structures wrong - they're very common, so may as well make them available
cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment")
"Comment of the form C{/* ... */}"

htmlComment = Regex(r"<!--[\s\S]*?-->").setName("HTML comment")
"Comment of the form C{<!-- ... -->}"

restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line")
dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment")
"Comment of the form C{// ... (to end of line)}"

cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/'| dblSlashComment).setName("C++ style comment")
"Comment of either form C{L{cStyleComment}} or C{L{dblSlashComment}}"

javaStyleComment = cppStyleComment
"Same as C{L{cppStyleComment}}"

pythonStyleComment = Regex(r"#.*").setName("Python style comment")
"Comment of the form C{# ... (to end of line)}"

_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',') +
                                  Optional( Word(" \t") +
                                            ~Literal(",") + ~LineEnd() ) ) ).streamline().setName("commaItem")
commaSeparatedList = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("commaSeparatedList")
"""(Deprecated) Predefined expression of 1 or more printable words or quoted strings, separated by commas.
   This expression is deprecated in favor of L{pyparsing_common.comma_separated_list}."""

# some other useful expressions - using lower-case class name since we are really using this as a namespace
class pyparsing_common:
    """
    Here are some common low-level expressions that may be useful in jump-starting parser development:
     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
     - common L{programming identifiers<identifier>}
     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
     - L{UUID<uuid>}
     - L{comma-separated list<comma_separated_list>}
    Parse actions:
     - C{L{convertToInteger}}
     - C{L{convertToFloat}}
     - C{L{convertToDate}}
     - C{L{convertToDatetime}}
     - C{L{stripHTMLTags}}
     - C{L{upcaseTokens}}
     - C{L{downcaseTokens}}

    Example::
        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')
    prints::
        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    """

    convertToInteger = tokenMap(int)
    """
    Parse action for converting parsed integers to Python int
    """

    convertToFloat = tokenMap(float)
    """
    Parse action for converting parsed numbers to Python float
    """

    integer = Word(nums).setName("integer").setParseAction(convertToInteger)
    """expression that parses an unsigned integer, returns an int"""

    hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int,16))
    """expression that parses a hexadecimal integer, returns an int"""

    signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger)
    """expression that parses an integer with optional leading sign, returns an int"""

    fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction")
    """fractional expression of an integer divided by an integer, returns a float"""
    fraction.addParseAction(lambda t: t[0]/t[-1])

    mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction")
    """mixed integer of the form 'integer - fraction', with optional leading integer, returns float"""
    mixed_integer.addParseAction(sum)

    real = Regex(r'[+-]?\d+\.\d*').setName("real number").setParseAction(convertToFloat)
    """expression that parses a floating point number and returns a float"""

    sci_real = Regex(r'[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat)
    """expression that parses a floating point number with optional scientific notation and returns a float"""

    # streamlining this expression makes the docs nicer-looking
    number = (sci_real | real | signed_integer).streamline()
    """any numeric expression, returns the corresponding Python type"""

    fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat)
    """any int or real number, returned as float"""
    
    identifier = Word(alphas+'_', alphanums+'_').setName("identifier")
    """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')"""
    
    ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address")
    "IPv4 address (C{0.0.0.0 - 255.255.255.255})"

    _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer")
    _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part)*7).setName("full IPv6 address")
    _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part)*(0,6)) + "::" + Optional(_ipv6_part + (':' + _ipv6_part)*(0,6))).setName("short IPv6 address")
    _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8)
    _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address")
    ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address")
    "IPv6 address (long, short, or mixed form)"
    
    mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address")
    "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)"

    @staticmethod
    def convertToDate(fmt="%Y-%m-%d"):
        """
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})

        Example::
            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))
        prints::
            [datetime.date(1999, 12, 31)]
        """
        def cvt_fn(s,l,t):
            try:
                return datetime.strptime(t[0], fmt).date()
            except ValueError as ve:
                raise ParseException(s, l, str(ve))
        return cvt_fn

    @staticmethod
    def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"):
        """
        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})

        Example::
            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
        prints::
            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        """
        def cvt_fn(s,l,t):
            try:
                return datetime.strptime(t[0], fmt)
            except ValueError as ve:
                raise ParseException(s, l, str(ve))
        return cvt_fn

    iso8601_date = Regex(r'(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?').setName("ISO8601 date")
    "ISO8601 date (C{yyyy-mm-dd})"

    iso8601_datetime = Regex(r'(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime")
    "ISO8601 datetime (C{yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)}) - trailing seconds, milliseconds, and timezone optional; accepts separating C{'T'} or C{' '}"

    uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID")
    "UUID (C{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx})"

    _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress()
    @staticmethod
    def stripHTMLTags(s, l, tokens):
        """
        Parse action to remove HTML tags from web page HTML source

        Example::
            # strip HTML links from normal text 
            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
            td,td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            
            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
        """
        return pyparsing_common._html_stripper.transformString(tokens[0])

    _commasepitem = Combine(OneOrMore(~Literal(",") + ~LineEnd() + Word(printables, excludeChars=',') 
                                        + Optional( White(" \t") ) ) ).streamline().setName("commaItem")
    comma_separated_list = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("comma separated list")
    """Predefined expression of 1 or more printable words or quoted strings, separated by commas."""

    upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper()))
    """Parse action to convert tokens to upper case."""

    downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower()))
    """Parse action to convert tokens to lower case."""


if __name__ == "__main__":

    selectToken    = CaselessLiteral("select")
    fromToken      = CaselessLiteral("from")

    ident          = Word(alphas, alphanums + "_$")

    columnName     = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
    columnNameList = Group(delimitedList(columnName)).setName("columns")
    columnSpec     = ('*' | columnNameList)

    tableName      = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
    tableNameList  = Group(delimitedList(tableName)).setName("tables")
    
    simpleSQL      = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables")

    # demo runTests method, including embedded comments in test string
    simpleSQL.runTests("""
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        """)

    pyparsing_common.number.runTests("""
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        """)

    # any int or real number, returned as float
    pyparsing_common.fnumber.runTests("""
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        """)

    pyparsing_common.hex_integer.runTests("""
        100
        FF
        """)

    import uuid
    pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
    pyparsing_common.uuid.runTests("""
        12345678-1234-5678-1234-567812345678
        """)
site-packages/easy_install.py000064400000000176151446177000012336 0ustar00"""Run the EasyInstall command"""

if __name__ == '__main__':
    from setuptools.command.easy_install import main
    main()
site-packages/setuptools/extern/__pycache__/__init__.cpython-38.opt-1.pyc000064400000004564151446177000022366 0ustar00U

�Qab�	�@s.ddlZGdd�d�ZdZeeed���dS)�Nc@s@eZdZdZddd�Zedd��Zddd	�Zd
d�Zdd
�Z	dS)�VendorImporterz�
    A PEP 302 meta path importer for finding optionally-vendored
    or otherwise naturally-installed packages from root_name.
    �NcCs&||_t|�|_|p|�dd�|_dS)NZexternZ_vendor)�	root_name�set�vendored_names�replace�
vendor_pkg)�selfrrrrr�>/usr/lib/python3.8/site-packages/setuptools/extern/__init__.py�__init__
s
zVendorImporter.__init__ccs|jdVdVdS)zL
        Search first the vendor package then as a natural package.
        �.�N)r�r	rrr
�search_pathszVendorImporter.search_pathcCs8|�|jd�\}}}|rdStt|j|j��s4dS|S)z�
        Return self when fullname starts with root_name and the
        target module is one vendored through this importer.
        rN)�	partitionr�any�map�
startswithr)r	�fullname�path�root�base�targetrrr
�find_moduleszVendorImporter.find_modulec	Cs�|�|jd�\}}}|jD]Z}z@||}t|�tj|}|tj|<tjdkrXtj|=|WStk
rtYqXqtdjft	����dS)zK
        Iterate over the search path to locate and load fullname.
        r)�z�The '{target}' package is required; normally this is bundled with this package so if you get this warning, consult the packager of your distribution.N)
rrr�
__import__�sys�modules�version_info�ImportError�format�locals)r	rrrr�prefixZextant�modrrr
�load_module#s"




��zVendorImporter.load_modulecCs|tjkrtj�|�dS)zR
        Install this importer into sys.meta_path if not already present.
        N)r�	meta_path�appendrrrr
�install@s
zVendorImporter.install)rN)N)
�__name__�
__module__�__qualname__�__doc__r�propertyrrr$r'rrrr
rs


r)ZsixZ	packagingZ	pyparsingZordered_setzsetuptools._vendor)rr�namesr(r'rrrr
�<module>sDsite-packages/setuptools/extern/__pycache__/__init__.cpython-38.pyc000064400000004564151446177000021427 0ustar00U

�Qab�	�@s.ddlZGdd�d�ZdZeeed���dS)�Nc@s@eZdZdZddd�Zedd��Zddd	�Zd
d�Zdd
�Z	dS)�VendorImporterz�
    A PEP 302 meta path importer for finding optionally-vendored
    or otherwise naturally-installed packages from root_name.
    �NcCs&||_t|�|_|p|�dd�|_dS)NZexternZ_vendor)�	root_name�set�vendored_names�replace�
vendor_pkg)�selfrrrrr�>/usr/lib/python3.8/site-packages/setuptools/extern/__init__.py�__init__
s
zVendorImporter.__init__ccs|jdVdVdS)zL
        Search first the vendor package then as a natural package.
        �.�N)r�r	rrr
�search_pathszVendorImporter.search_pathcCs8|�|jd�\}}}|rdStt|j|j��s4dS|S)z�
        Return self when fullname starts with root_name and the
        target module is one vendored through this importer.
        rN)�	partitionr�any�map�
startswithr)r	�fullname�path�root�base�targetrrr
�find_moduleszVendorImporter.find_modulec	Cs�|�|jd�\}}}|jD]Z}z@||}t|�tj|}|tj|<tjdkrXtj|=|WStk
rtYqXqtdjft	����dS)zK
        Iterate over the search path to locate and load fullname.
        r)�z�The '{target}' package is required; normally this is bundled with this package so if you get this warning, consult the packager of your distribution.N)
rrr�
__import__�sys�modules�version_info�ImportError�format�locals)r	rrrr�prefixZextant�modrrr
�load_module#s"




��zVendorImporter.load_modulecCs|tjkrtj�|�dS)zR
        Install this importer into sys.meta_path if not already present.
        N)r�	meta_path�appendrrrr
�install@s
zVendorImporter.install)rN)N)
�__name__�
__module__�__qualname__�__doc__r�propertyrrr$r'rrrr
rs


r)ZsixZ	packagingZ	pyparsingZordered_setzsetuptools._vendor)rr�namesr(r'rrrr
�<module>sDsite-packages/setuptools/extern/__init__.py000064400000004722151446177000015135 0ustar00import sys


class VendorImporter:
    """
    A PEP 302 meta path importer for finding optionally-vendored
    or otherwise naturally-installed packages from root_name.
    """

    def __init__(self, root_name, vendored_names=(), vendor_pkg=None):
        self.root_name = root_name
        self.vendored_names = set(vendored_names)
        self.vendor_pkg = vendor_pkg or root_name.replace('extern', '_vendor')

    @property
    def search_path(self):
        """
        Search first the vendor package then as a natural package.
        """
        yield self.vendor_pkg + '.'
        yield ''

    def find_module(self, fullname, path=None):
        """
        Return self when fullname starts with root_name and the
        target module is one vendored through this importer.
        """
        root, base, target = fullname.partition(self.root_name + '.')
        if root:
            return
        if not any(map(target.startswith, self.vendored_names)):
            return
        return self

    def load_module(self, fullname):
        """
        Iterate over the search path to locate and load fullname.
        """
        root, base, target = fullname.partition(self.root_name + '.')
        for prefix in self.search_path:
            try:
                extant = prefix + target
                __import__(extant)
                mod = sys.modules[extant]
                sys.modules[fullname] = mod
                # mysterious hack:
                # Remove the reference to the extant package/module
                # on later Python versions to cause relative imports
                # in the vendor package to resolve the same modules
                # as those going through this importer.
                if sys.version_info >= (3, ):
                    del sys.modules[extant]
                return mod
            except ImportError:
                pass
        else:
            raise ImportError(
                "The '{target}' package is required; "
                "normally this is bundled with this package so if you get "
                "this warning, consult the packager of your "
                "distribution.".format(**locals())
            )

    def install(self):
        """
        Install this importer into sys.meta_path if not already present.
        """
        if self not in sys.meta_path:
            sys.meta_path.append(self)


names = 'six', 'packaging', 'pyparsing', 'ordered_set',
VendorImporter(__name__, names, 'setuptools._vendor').install()
site-packages/setuptools/script.tmpl000064400000000212151446177000013707 0ustar00# EASY-INSTALL-SCRIPT: %(spec)r,%(script_name)r
__requires__ = %(spec)r
__import__('pkg_resources').run_script(%(spec)r, %(script_name)r)
site-packages/setuptools/namespaces.py000064400000006177151446177000014216 0ustar00import os
from distutils import log
import itertools

from setuptools.extern.six.moves import map


flatten = itertools.chain.from_iterable


class Installer:

    nspkg_ext = '-nspkg.pth'

    def install_namespaces(self):
        nsp = self._get_all_ns_packages()
        if not nsp:
            return
        filename, ext = os.path.splitext(self._get_target())
        filename += self.nspkg_ext
        self.outputs.append(filename)
        log.info("Installing %s", filename)
        lines = map(self._gen_nspkg_line, nsp)

        if self.dry_run:
            # always generate the lines, even in dry run
            list(lines)
            return

        with open(filename, 'wt') as f:
            f.writelines(lines)

    def uninstall_namespaces(self):
        filename, ext = os.path.splitext(self._get_target())
        filename += self.nspkg_ext
        if not os.path.exists(filename):
            return
        log.info("Removing %s", filename)
        os.remove(filename)

    def _get_target(self):
        return self.target

    _nspkg_tmpl = (
        "import sys, types, os",
        "has_mfs = sys.version_info > (3, 5)",
        "p = os.path.join(%(root)s, *%(pth)r)",
        "importlib = has_mfs and __import__('importlib.util')",
        "has_mfs and __import__('importlib.machinery')",
        "m = has_mfs and "
            "sys.modules.setdefault(%(pkg)r, "
                "importlib.util.module_from_spec("
                    "importlib.machinery.PathFinder.find_spec(%(pkg)r, "
                        "[os.path.dirname(p)])))",
        "m = m or "
            "sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))",
        "mp = (m or []) and m.__dict__.setdefault('__path__',[])",
        "(p not in mp) and mp.append(p)",
    )
    "lines for the namespace installer"

    _nspkg_tmpl_multi = (
        'm and setattr(sys.modules[%(parent)r], %(child)r, m)',
    )
    "additional line(s) when a parent package is indicated"

    def _get_root(self):
        return "sys._getframe(1).f_locals['sitedir']"

    def _gen_nspkg_line(self, pkg):
        # ensure pkg is not a unicode string under Python 2.7
        pkg = str(pkg)
        pth = tuple(pkg.split('.'))
        root = self._get_root()
        tmpl_lines = self._nspkg_tmpl
        parent, sep, child = pkg.rpartition('.')
        if parent:
            tmpl_lines += self._nspkg_tmpl_multi
        return ';'.join(tmpl_lines) % locals() + '\n'

    def _get_all_ns_packages(self):
        """Return sorted list of all package namespaces"""
        pkgs = self.distribution.namespace_packages or []
        return sorted(flatten(map(self._pkg_names, pkgs)))

    @staticmethod
    def _pkg_names(pkg):
        """
        Given a namespace package, yield the components of that
        package.

        >>> names = Installer._pkg_names('a.b.c')
        >>> set(names) == set(['a', 'a.b', 'a.b.c'])
        True
        """
        parts = pkg.split('.')
        while parts:
            yield '.'.join(parts)
            parts.pop()


class DevelopInstaller(Installer):
    def _get_root(self):
        return repr(str(self.egg_path))

    def _get_target(self):
        return self.egg_link
site-packages/setuptools/sandbox.py000064400000033704151446177000013531 0ustar00import os
import sys
import tempfile
import operator
import functools
import itertools
import re
import contextlib
import pickle
import textwrap

from setuptools.extern import six
from setuptools.extern.six.moves import builtins, map

import pkg_resources.py31compat

if sys.platform.startswith('java'):
    import org.python.modules.posix.PosixModule as _os
else:
    _os = sys.modules[os.name]
try:
    _file = file
except NameError:
    _file = None
_open = open
from distutils.errors import DistutilsError
from pkg_resources import working_set


__all__ = [
    "AbstractSandbox", "DirectorySandbox", "SandboxViolation", "run_setup",
]


def _execfile(filename, globals, locals=None):
    """
    Python 3 implementation of execfile.
    """
    mode = 'rb'
    with open(filename, mode) as stream:
        script = stream.read()
    if locals is None:
        locals = globals
    code = compile(script, filename, 'exec')
    exec(code, globals, locals)


@contextlib.contextmanager
def save_argv(repl=None):
    saved = sys.argv[:]
    if repl is not None:
        sys.argv[:] = repl
    try:
        yield saved
    finally:
        sys.argv[:] = saved


@contextlib.contextmanager
def save_path():
    saved = sys.path[:]
    try:
        yield saved
    finally:
        sys.path[:] = saved


@contextlib.contextmanager
def override_temp(replacement):
    """
    Monkey-patch tempfile.tempdir with replacement, ensuring it exists
    """
    pkg_resources.py31compat.makedirs(replacement, exist_ok=True)

    saved = tempfile.tempdir

    tempfile.tempdir = replacement

    try:
        yield
    finally:
        tempfile.tempdir = saved


@contextlib.contextmanager
def pushd(target):
    saved = os.getcwd()
    os.chdir(target)
    try:
        yield saved
    finally:
        os.chdir(saved)


class UnpickleableException(Exception):
    """
    An exception representing another Exception that could not be pickled.
    """

    @staticmethod
    def dump(type, exc):
        """
        Always return a dumped (pickled) type and exc. If exc can't be pickled,
        wrap it in UnpickleableException first.
        """
        try:
            return pickle.dumps(type), pickle.dumps(exc)
        except Exception:
            # get UnpickleableException inside the sandbox
            from setuptools.sandbox import UnpickleableException as cls
            return cls.dump(cls, cls(repr(exc)))


class ExceptionSaver:
    """
    A Context Manager that will save an exception, serialized, and restore it
    later.
    """

    def __enter__(self):
        return self

    def __exit__(self, type, exc, tb):
        if not exc:
            return

        # dump the exception
        self._saved = UnpickleableException.dump(type, exc)
        self._tb = tb

        # suppress the exception
        return True

    def resume(self):
        "restore and re-raise any exception"

        if '_saved' not in vars(self):
            return

        type, exc = map(pickle.loads, self._saved)
        six.reraise(type, exc, self._tb)


@contextlib.contextmanager
def save_modules():
    """
    Context in which imported modules are saved.

    Translates exceptions internal to the context into the equivalent exception
    outside the context.
    """
    saved = sys.modules.copy()
    with ExceptionSaver() as saved_exc:
        yield saved

    sys.modules.update(saved)
    # remove any modules imported since
    del_modules = (
        mod_name for mod_name in sys.modules
        if mod_name not in saved
        # exclude any encodings modules. See #285
        and not mod_name.startswith('encodings.')
    )
    _clear_modules(del_modules)

    saved_exc.resume()


def _clear_modules(module_names):
    for mod_name in list(module_names):
        del sys.modules[mod_name]


@contextlib.contextmanager
def save_pkg_resources_state():
    saved = pkg_resources.__getstate__()
    try:
        yield saved
    finally:
        pkg_resources.__setstate__(saved)


@contextlib.contextmanager
def setup_context(setup_dir):
    temp_dir = os.path.join(setup_dir, 'temp')
    with save_pkg_resources_state():
        with save_modules():
            hide_setuptools()
            with save_path():
                with save_argv():
                    with override_temp(temp_dir):
                        with pushd(setup_dir):
                            # ensure setuptools commands are available
                            __import__('setuptools')
                            yield


def _needs_hiding(mod_name):
    """
    >>> _needs_hiding('setuptools')
    True
    >>> _needs_hiding('pkg_resources')
    True
    >>> _needs_hiding('setuptools_plugin')
    False
    >>> _needs_hiding('setuptools.__init__')
    True
    >>> _needs_hiding('distutils')
    True
    >>> _needs_hiding('os')
    False
    >>> _needs_hiding('Cython')
    True
    """
    pattern = re.compile(r'(setuptools|pkg_resources|distutils|Cython)(\.|$)')
    return bool(pattern.match(mod_name))


def hide_setuptools():
    """
    Remove references to setuptools' modules from sys.modules to allow the
    invocation to import the most appropriate setuptools. This technique is
    necessary to avoid issues such as #315 where setuptools upgrading itself
    would fail to find a function declared in the metadata.
    """
    modules = filter(_needs_hiding, sys.modules)
    _clear_modules(modules)


def run_setup(setup_script, args):
    """Run a distutils setup script, sandboxed in its directory"""
    setup_dir = os.path.abspath(os.path.dirname(setup_script))
    with setup_context(setup_dir):
        try:
            sys.argv[:] = [setup_script] + list(args)
            sys.path.insert(0, setup_dir)
            # reset to include setup dir, w/clean callback list
            working_set.__init__()
            working_set.callbacks.append(lambda dist: dist.activate())

            # __file__ should be a byte string on Python 2 (#712)
            dunder_file = (
                setup_script
                if isinstance(setup_script, str) else
                setup_script.encode(sys.getfilesystemencoding())
            )

            with DirectorySandbox(setup_dir):
                ns = dict(__file__=dunder_file, __name__='__main__')
                _execfile(setup_script, ns)
        except SystemExit as v:
            if v.args and v.args[0]:
                raise
            # Normal exit, just return


class AbstractSandbox:
    """Wrap 'os' module and 'open()' builtin for virtualizing setup scripts"""

    _active = False

    def __init__(self):
        self._attrs = [
            name for name in dir(_os)
            if not name.startswith('_') and hasattr(self, name)
        ]

    def _copy(self, source):
        for name in self._attrs:
            setattr(os, name, getattr(source, name))

    def __enter__(self):
        self._copy(self)
        if _file:
            builtins.file = self._file
        builtins.open = self._open
        self._active = True

    def __exit__(self, exc_type, exc_value, traceback):
        self._active = False
        if _file:
            builtins.file = _file
        builtins.open = _open
        self._copy(_os)

    def run(self, func):
        """Run 'func' under os sandboxing"""
        with self:
            return func()

    def _mk_dual_path_wrapper(name):
        original = getattr(_os, name)

        def wrap(self, src, dst, *args, **kw):
            if self._active:
                src, dst = self._remap_pair(name, src, dst, *args, **kw)
            return original(src, dst, *args, **kw)

        return wrap

    for name in ["rename", "link", "symlink"]:
        if hasattr(_os, name):
            locals()[name] = _mk_dual_path_wrapper(name)

    def _mk_single_path_wrapper(name, original=None):
        original = original or getattr(_os, name)

        def wrap(self, path, *args, **kw):
            if self._active:
                path = self._remap_input(name, path, *args, **kw)
            return original(path, *args, **kw)

        return wrap

    if _file:
        _file = _mk_single_path_wrapper('file', _file)
    _open = _mk_single_path_wrapper('open', _open)
    for name in [
        "stat", "listdir", "chdir", "open", "chmod", "chown", "mkdir",
        "remove", "unlink", "rmdir", "utime", "lchown", "chroot", "lstat",
        "startfile", "mkfifo", "mknod", "pathconf", "access"
    ]:
        if hasattr(_os, name):
            locals()[name] = _mk_single_path_wrapper(name)

    def _mk_single_with_return(name):
        original = getattr(_os, name)

        def wrap(self, path, *args, **kw):
            if self._active:
                path = self._remap_input(name, path, *args, **kw)
                return self._remap_output(name, original(path, *args, **kw))
            return original(path, *args, **kw)

        return wrap

    for name in ['readlink', 'tempnam']:
        if hasattr(_os, name):
            locals()[name] = _mk_single_with_return(name)

    def _mk_query(name):
        original = getattr(_os, name)

        def wrap(self, *args, **kw):
            retval = original(*args, **kw)
            if self._active:
                return self._remap_output(name, retval)
            return retval

        return wrap

    for name in ['getcwd', 'tmpnam']:
        if hasattr(_os, name):
            locals()[name] = _mk_query(name)

    def _validate_path(self, path):
        """Called to remap or validate any path, whether input or output"""
        return path

    def _remap_input(self, operation, path, *args, **kw):
        """Called for path inputs"""
        return self._validate_path(path)

    def _remap_output(self, operation, path):
        """Called for path outputs"""
        return self._validate_path(path)

    def _remap_pair(self, operation, src, dst, *args, **kw):
        """Called for path pairs like rename, link, and symlink operations"""
        return (
            self._remap_input(operation + '-from', src, *args, **kw),
            self._remap_input(operation + '-to', dst, *args, **kw)
        )


if hasattr(os, 'devnull'):
    _EXCEPTIONS = [os.devnull,]
else:
    _EXCEPTIONS = []


class DirectorySandbox(AbstractSandbox):
    """Restrict operations to a single subdirectory - pseudo-chroot"""

    write_ops = dict.fromkeys([
        "open", "chmod", "chown", "mkdir", "remove", "unlink", "rmdir",
        "utime", "lchown", "chroot", "mkfifo", "mknod", "tempnam",
    ])

    _exception_patterns = [
        # Allow lib2to3 to attempt to save a pickled grammar object (#121)
        r'.*lib2to3.*\.pickle$',
    ]
    "exempt writing to paths that match the pattern"

    def __init__(self, sandbox, exceptions=_EXCEPTIONS):
        self._sandbox = os.path.normcase(os.path.realpath(sandbox))
        self._prefix = os.path.join(self._sandbox, '')
        self._exceptions = [
            os.path.normcase(os.path.realpath(path))
            for path in exceptions
        ]
        AbstractSandbox.__init__(self)

    def _violation(self, operation, *args, **kw):
        from setuptools.sandbox import SandboxViolation
        raise SandboxViolation(operation, args, kw)

    if _file:

        def _file(self, path, mode='r', *args, **kw):
            if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path):
                self._violation("file", path, mode, *args, **kw)
            return _file(path, mode, *args, **kw)

    def _open(self, path, mode='r', *args, **kw):
        if mode not in ('r', 'rt', 'rb', 'rU', 'U') and not self._ok(path):
            self._violation("open", path, mode, *args, **kw)
        return _open(path, mode, *args, **kw)

    def tmpnam(self):
        self._violation("tmpnam")

    def _ok(self, path):
        active = self._active
        try:
            self._active = False
            realpath = os.path.normcase(os.path.realpath(path))
            return (
                self._exempted(realpath)
                or realpath == self._sandbox
                or realpath.startswith(self._prefix)
            )
        finally:
            self._active = active

    def _exempted(self, filepath):
        start_matches = (
            filepath.startswith(exception)
            for exception in self._exceptions
        )
        pattern_matches = (
            re.match(pattern, filepath)
            for pattern in self._exception_patterns
        )
        candidates = itertools.chain(start_matches, pattern_matches)
        return any(candidates)

    def _remap_input(self, operation, path, *args, **kw):
        """Called for path inputs"""
        if operation in self.write_ops and not self._ok(path):
            self._violation(operation, os.path.realpath(path), *args, **kw)
        return path

    def _remap_pair(self, operation, src, dst, *args, **kw):
        """Called for path pairs like rename, link, and symlink operations"""
        if not self._ok(src) or not self._ok(dst):
            self._violation(operation, src, dst, *args, **kw)
        return (src, dst)

    def open(self, file, flags, mode=0o777, *args, **kw):
        """Called for low-level os.open()"""
        if flags & WRITE_FLAGS and not self._ok(file):
            self._violation("os.open", file, flags, mode, *args, **kw)
        return _os.open(file, flags, mode, *args, **kw)


WRITE_FLAGS = functools.reduce(
    operator.or_, [getattr(_os, a, 0) for a in
        "O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARY".split()]
)


class SandboxViolation(DistutilsError):
    """A setup script attempted to modify the filesystem outside the sandbox"""

    tmpl = textwrap.dedent("""
        SandboxViolation: {cmd}{args!r} {kwargs}

        The package setup script has attempted to modify files on your system
        that are not within the EasyInstall build area, and has been aborted.

        This package cannot be safely installed by EasyInstall, and may not
        support alternate installation locations even if you run its setup
        script by hand.  Please inform the package's author and the EasyInstall
        maintainers to find out if a fix or workaround is available.
        """).lstrip()

    def __str__(self):
        cmd, args, kwargs = self.args
        return self.tmpl.format(**locals())
site-packages/setuptools/dep_util.py000064400000001647151446177000013701 0ustar00from distutils.dep_util import newer_group

# yes, this is was almost entirely copy-pasted from
# 'newer_pairwise()', this is just another convenience
# function.
def newer_pairwise_group(sources_groups, targets):
    """Walk both arguments in parallel, testing if each source group is newer
    than its corresponding target. Returns a pair of lists (sources_groups,
    targets) where sources is newer than target, according to the semantics
    of 'newer_group()'.
    """
    if len(sources_groups) != len(targets):
        raise ValueError("'sources_group' and 'targets' must be the same length")

    # build a pair of lists (sources_groups, targets) where source is newer
    n_sources = []
    n_targets = []
    for i in range(len(sources_groups)):
        if newer_group(sources_groups[i], targets[i]):
            n_sources.append(sources_groups[i])
            n_targets.append(targets[i])

    return n_sources, n_targets
site-packages/setuptools/version.py000064400000000220151446177000013543 0ustar00import pkg_resources

try:
    __version__ = pkg_resources.get_distribution('setuptools').version
except Exception:
    __version__ = 'unknown'
site-packages/setuptools/pep425tags.py000064400000025155151446177000013772 0ustar00# This file originally from pip:
# https://github.com/pypa/pip/blob/8f4f15a5a95d7d5b511ceaee9ed261176c181970/src/pip/_internal/pep425tags.py
"""Generate and work with PEP 425 Compatibility Tags."""
from __future__ import absolute_import

import distutils.util
from distutils import log
import platform
import re
import sys
import sysconfig
import warnings
from collections import OrderedDict

from .extern import six

from . import glibc

_osx_arch_pat = re.compile(r'(.+)_(\d+)_(\d+)_(.+)')


def get_config_var(var):
    try:
        return sysconfig.get_config_var(var)
    except IOError as e:  # Issue #1074
        warnings.warn("{}".format(e), RuntimeWarning)
        return None


def get_abbr_impl():
    """Return abbreviated implementation name."""
    if hasattr(sys, 'pypy_version_info'):
        pyimpl = 'pp'
    elif sys.platform.startswith('java'):
        pyimpl = 'jy'
    elif sys.platform == 'cli':
        pyimpl = 'ip'
    else:
        pyimpl = 'cp'
    return pyimpl


def get_impl_ver():
    """Return implementation version."""
    impl_ver = get_config_var("py_version_nodot")
    if not impl_ver or get_abbr_impl() == 'pp':
        impl_ver = ''.join(map(str, get_impl_version_info()))
    return impl_ver


def get_impl_version_info():
    """Return sys.version_info-like tuple for use in decrementing the minor
    version."""
    if get_abbr_impl() == 'pp':
        # as per https://github.com/pypa/pip/issues/2882
        return (sys.version_info[0], sys.pypy_version_info.major,
                sys.pypy_version_info.minor)
    else:
        return sys.version_info[0], sys.version_info[1]


def get_impl_tag():
    """
    Returns the Tag for this specific implementation.
    """
    return "{}{}".format(get_abbr_impl(), get_impl_ver())


def get_flag(var, fallback, expected=True, warn=True):
    """Use a fallback method for determining SOABI flags if the needed config
    var is unset or unavailable."""
    val = get_config_var(var)
    if val is None:
        if warn:
            log.debug("Config variable '%s' is unset, Python ABI tag may "
                      "be incorrect", var)
        return fallback()
    return val == expected


def get_abi_tag():
    """Return the ABI tag based on SOABI (if available) or emulate SOABI
    (CPython 2, PyPy)."""
    soabi = get_config_var('SOABI')
    impl = get_abbr_impl()
    if not soabi and impl in {'cp', 'pp'} and hasattr(sys, 'maxunicode'):
        d = ''
        m = ''
        u = ''
        if get_flag('Py_DEBUG',
                    lambda: hasattr(sys, 'gettotalrefcount'),
                    warn=(impl == 'cp')):
            d = 'd'
        if get_flag('WITH_PYMALLOC',
                    lambda: impl == 'cp',
                    warn=(impl == 'cp')):
            m = 'm'
        if get_flag('Py_UNICODE_SIZE',
                    lambda: sys.maxunicode == 0x10ffff,
                    expected=4,
                    warn=(impl == 'cp' and
                          six.PY2)) \
                and six.PY2:
            u = 'u'
        abi = '%s%s%s%s%s' % (impl, get_impl_ver(), d, m, u)
    elif soabi and soabi.startswith('cpython-'):
        abi = 'cp' + soabi.split('-')[1]
    elif soabi:
        abi = soabi.replace('.', '_').replace('-', '_')
    else:
        abi = None
    return abi


def _is_running_32bit():
    return sys.maxsize == 2147483647


def get_platform():
    """Return our platform name 'win32', 'linux_x86_64'"""
    if sys.platform == 'darwin':
        # distutils.util.get_platform() returns the release based on the value
        # of MACOSX_DEPLOYMENT_TARGET on which Python was built, which may
        # be significantly older than the user's current machine.
        release, _, machine = platform.mac_ver()
        split_ver = release.split('.')

        if machine == "x86_64" and _is_running_32bit():
            machine = "i386"
        elif machine == "ppc64" and _is_running_32bit():
            machine = "ppc"

        return 'macosx_{}_{}_{}'.format(split_ver[0], split_ver[1], machine)

    # XXX remove distutils dependency
    result = distutils.util.get_platform().replace('.', '_').replace('-', '_')
    if result == "linux_x86_64" and _is_running_32bit():
        # 32 bit Python program (running on a 64 bit Linux): pip should only
        # install and run 32 bit compiled extensions in that case.
        result = "linux_i686"

    return result


def is_manylinux1_compatible():
    # Only Linux, and only x86-64 / i686
    if get_platform() not in {"linux_x86_64", "linux_i686"}:
        return False

    # Check for presence of _manylinux module
    try:
        import _manylinux
        return bool(_manylinux.manylinux1_compatible)
    except (ImportError, AttributeError):
        # Fall through to heuristic check below
        pass

    # Check glibc version. CentOS 5 uses glibc 2.5.
    return glibc.have_compatible_glibc(2, 5)


def get_darwin_arches(major, minor, machine):
    """Return a list of supported arches (including group arches) for
    the given major, minor and machine architecture of a macOS machine.
    """
    arches = []

    def _supports_arch(major, minor, arch):
        # Looking at the application support for macOS versions in the chart
        # provided by https://en.wikipedia.org/wiki/OS_X#Versions it appears
        # our timeline looks roughly like:
        #
        # 10.0 - Introduces ppc support.
        # 10.4 - Introduces ppc64, i386, and x86_64 support, however the ppc64
        #        and x86_64 support is CLI only, and cannot be used for GUI
        #        applications.
        # 10.5 - Extends ppc64 and x86_64 support to cover GUI applications.
        # 10.6 - Drops support for ppc64
        # 10.7 - Drops support for ppc
        #
        # Given that we do not know if we're installing a CLI or a GUI
        # application, we must be conservative and assume it might be a GUI
        # application and behave as if ppc64 and x86_64 support did not occur
        # until 10.5.
        #
        # Note: The above information is taken from the "Application support"
        #       column in the chart not the "Processor support" since I believe
        #       that we care about what instruction sets an application can use
        #       not which processors the OS supports.
        if arch == 'ppc':
            return (major, minor) <= (10, 5)
        if arch == 'ppc64':
            return (major, minor) == (10, 5)
        if arch == 'i386':
            return (major, minor) >= (10, 4)
        if arch == 'x86_64':
            return (major, minor) >= (10, 5)
        if arch in groups:
            for garch in groups[arch]:
                if _supports_arch(major, minor, garch):
                    return True
        return False

    groups = OrderedDict([
        ("fat", ("i386", "ppc")),
        ("intel", ("x86_64", "i386")),
        ("fat64", ("x86_64", "ppc64")),
        ("fat32", ("x86_64", "i386", "ppc")),
    ])

    if _supports_arch(major, minor, machine):
        arches.append(machine)

    for garch in groups:
        if machine in groups[garch] and _supports_arch(major, minor, garch):
            arches.append(garch)

    arches.append('universal')

    return arches


def get_supported(versions=None, noarch=False, platform=None,
                  impl=None, abi=None):
    """Return a list of supported tags for each version specified in
    `versions`.

    :param versions: a list of string versions, of the form ["33", "32"],
        or None. The first version will be assumed to support our ABI.
    :param platform: specify the exact platform you want valid
        tags for, or None. If None, use the local system platform.
    :param impl: specify the exact implementation you want valid
        tags for, or None. If None, use the local interpreter impl.
    :param abi: specify the exact abi you want valid
        tags for, or None. If None, use the local interpreter abi.
    """
    supported = []

    # Versions must be given with respect to the preference
    if versions is None:
        versions = []
        version_info = get_impl_version_info()
        major = version_info[:-1]
        # Support all previous minor Python versions.
        for minor in range(version_info[-1], -1, -1):
            versions.append(''.join(map(str, major + (minor,))))

    impl = impl or get_abbr_impl()

    abis = []

    abi = abi or get_abi_tag()
    if abi:
        abis[0:0] = [abi]

    abi3s = set()
    import imp
    for suffix in imp.get_suffixes():
        if suffix[0].startswith('.abi'):
            abi3s.add(suffix[0].split('.', 2)[1])

    abis.extend(sorted(list(abi3s)))

    abis.append('none')

    if not noarch:
        arch = platform or get_platform()
        if arch.startswith('macosx'):
            # support macosx-10.6-intel on macosx-10.9-x86_64
            match = _osx_arch_pat.match(arch)
            if match:
                name, major, minor, actual_arch = match.groups()
                tpl = '{}_{}_%i_%s'.format(name, major)
                arches = []
                for m in reversed(range(int(minor) + 1)):
                    for a in get_darwin_arches(int(major), m, actual_arch):
                        arches.append(tpl % (m, a))
            else:
                # arch pattern didn't match (?!)
                arches = [arch]
        elif platform is None and is_manylinux1_compatible():
            arches = [arch.replace('linux', 'manylinux1'), arch]
        else:
            arches = [arch]

        # Current version, current API (built specifically for our Python):
        for abi in abis:
            for arch in arches:
                supported.append(('%s%s' % (impl, versions[0]), abi, arch))

        # abi3 modules compatible with older version of Python
        for version in versions[1:]:
            # abi3 was introduced in Python 3.2
            if version in {'31', '30'}:
                break
            for abi in abi3s:   # empty set if not Python 3
                for arch in arches:
                    supported.append(("%s%s" % (impl, version), abi, arch))

        # Has binaries, does not use the Python API:
        for arch in arches:
            supported.append(('py%s' % (versions[0][0]), 'none', arch))

    # No abi / arch, but requires our implementation:
    supported.append(('%s%s' % (impl, versions[0]), 'none', 'any'))
    # Tagged specifically as being cross-version compatible
    # (with just the major version specified)
    supported.append(('%s%s' % (impl, versions[0][0]), 'none', 'any'))

    # No abi / arch, generic Python
    for i, version in enumerate(versions):
        supported.append(('py%s' % (version,), 'none', 'any'))
        if i == 0:
            supported.append(('py%s' % (version[0]), 'none', 'any'))

    return supported


implementation_tag = get_impl_tag()
site-packages/setuptools/glibc.py000064400000006112151446177000013144 0ustar00# This file originally from pip:
# https://github.com/pypa/pip/blob/8f4f15a5a95d7d5b511ceaee9ed261176c181970/src/pip/_internal/utils/glibc.py
from __future__ import absolute_import

import ctypes
import re
import warnings


def glibc_version_string():
    "Returns glibc version string, or None if not using glibc."

    # ctypes.CDLL(None) internally calls dlopen(NULL), and as the dlopen
    # manpage says, "If filename is NULL, then the returned handle is for the
    # main program". This way we can let the linker do the work to figure out
    # which libc our process is actually using.
    process_namespace = ctypes.CDLL(None)
    try:
        gnu_get_libc_version = process_namespace.gnu_get_libc_version
    except AttributeError:
        # Symbol doesn't exist -> therefore, we are not linked to
        # glibc.
        return None

    # Call gnu_get_libc_version, which returns a string like "2.5"
    gnu_get_libc_version.restype = ctypes.c_char_p
    version_str = gnu_get_libc_version()
    # py2 / py3 compatibility:
    if not isinstance(version_str, str):
        version_str = version_str.decode("ascii")

    return version_str


# Separated out from have_compatible_glibc for easier unit testing
def check_glibc_version(version_str, required_major, minimum_minor):
    # Parse string and check against requested version.
    #
    # We use a regexp instead of str.split because we want to discard any
    # random junk that might come after the minor version -- this might happen
    # in patched/forked versions of glibc (e.g. Linaro's version of glibc
    # uses version strings like "2.20-2014.11"). See gh-3588.
    m = re.match(r"(?P<major>[0-9]+)\.(?P<minor>[0-9]+)", version_str)
    if not m:
        warnings.warn("Expected glibc version with 2 components major.minor,"
                      " got: %s" % version_str, RuntimeWarning)
        return False
    return (int(m.group("major")) == required_major and
            int(m.group("minor")) >= minimum_minor)


def have_compatible_glibc(required_major, minimum_minor):
    version_str = glibc_version_string()
    if version_str is None:
        return False
    return check_glibc_version(version_str, required_major, minimum_minor)


# platform.libc_ver regularly returns completely nonsensical glibc
# versions. E.g. on my computer, platform says:
#
#   ~$ python2.7 -c 'import platform; print(platform.libc_ver())'
#   ('glibc', '2.7')
#   ~$ python3.5 -c 'import platform; print(platform.libc_ver())'
#   ('glibc', '2.9')
#
# But the truth is:
#
#   ~$ ldd --version
#   ldd (Debian GLIBC 2.22-11) 2.22
#
# This is unfortunate, because it means that the linehaul data on libc
# versions that was generated by pip 8.1.2 and earlier is useless and
# misleading. Solution: instead of using platform, use our code that actually
# works.
def libc_ver():
    """Try to determine the glibc version

    Returns a tuple of strings (lib, version) which default to empty strings
    in case the lookup fails.
    """
    glibc_version = glibc_version_string()
    if glibc_version is None:
        return ("", "")
    else:
        return ("glibc", glibc_version)
site-packages/setuptools/unicode_utils.py000064400000001744151446177000014740 0ustar00import unicodedata
import sys

from setuptools.extern import six


# HFS Plus uses decomposed UTF-8
def decompose(path):
    if isinstance(path, six.text_type):
        return unicodedata.normalize('NFD', path)
    try:
        path = path.decode('utf-8')
        path = unicodedata.normalize('NFD', path)
        path = path.encode('utf-8')
    except UnicodeError:
        pass  # Not UTF-8
    return path


def filesys_decode(path):
    """
    Ensure that the given path is decoded,
    NONE when no expected encoding works
    """

    if isinstance(path, six.text_type):
        return path

    fs_enc = sys.getfilesystemencoding() or 'utf-8'
    candidates = fs_enc, 'utf-8'

    for enc in candidates:
        try:
            return path.decode(enc)
        except UnicodeDecodeError:
            continue


def try_encode(string, enc):
    "turn unicode encoding into a functional routine"
    try:
        return string.encode(enc)
    except UnicodeEncodeError:
        return None
site-packages/setuptools/_deprecation_warning.py000064400000000332151446177000016243 0ustar00class SetuptoolsDeprecationWarning(Warning):
    """
    Base class for warning deprecations in ``setuptools``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    """
site-packages/setuptools/py31compat.py000064400000001506151446177000014066 0ustar00__all__ = []

__metaclass__ = type


try:
    # Python >=3.2
    from tempfile import TemporaryDirectory
except ImportError:
    import shutil
    import tempfile

    class TemporaryDirectory:
        """
        Very simple temporary directory context manager.
        Will try to delete afterward, but will also ignore OS and similar
        errors on deletion.
        """

        def __init__(self, **kwargs):
            self.name = None  # Handle mkdtemp raising an exception
            self.name = tempfile.mkdtemp(**kwargs)

        def __enter__(self):
            return self.name

        def __exit__(self, exctype, excvalue, exctrace):
            try:
                shutil.rmtree(self.name, True)
            except OSError:  # removal errors are not the only possible
                pass
            self.name = None
site-packages/setuptools/py34compat.py000064400000000365151446177000014073 0ustar00import importlib

try:
    import importlib.util
except ImportError:
    pass


try:
    module_from_spec = importlib.util.module_from_spec
except AttributeError:
    def module_from_spec(spec):
        return spec.loader.load_module(spec.name)
site-packages/setuptools/wheel.py000064400000017636151446177000013205 0ustar00"""Wheels support."""

from distutils.util import get_platform
import email
import itertools
import os
import posixpath
import re
import zipfile

import pkg_resources
import setuptools
from pkg_resources import parse_version
from setuptools.extern.packaging.utils import canonicalize_name
from setuptools.extern.six import PY3
from setuptools import pep425tags
from setuptools.command.egg_info import write_requirements


__metaclass__ = type


WHEEL_NAME = re.compile(
    r"""^(?P<project_name>.+?)-(?P<version>\d.*?)
    ((-(?P<build>\d.*?))?-(?P<py_version>.+?)-(?P<abi>.+?)-(?P<platform>.+?)
    )\.whl$""",
    re.VERBOSE).match

NAMESPACE_PACKAGE_INIT = '''\
try:
    __import__('pkg_resources').declare_namespace(__name__)
except ImportError:
    __path__ = __import__('pkgutil').extend_path(__path__, __name__)
'''


def unpack(src_dir, dst_dir):
    '''Move everything under `src_dir` to `dst_dir`, and delete the former.'''
    for dirpath, dirnames, filenames in os.walk(src_dir):
        subdir = os.path.relpath(dirpath, src_dir)
        for f in filenames:
            src = os.path.join(dirpath, f)
            dst = os.path.join(dst_dir, subdir, f)
            os.renames(src, dst)
        for n, d in reversed(list(enumerate(dirnames))):
            src = os.path.join(dirpath, d)
            dst = os.path.join(dst_dir, subdir, d)
            if not os.path.exists(dst):
                # Directory does not exist in destination,
                # rename it and prune it from os.walk list.
                os.renames(src, dst)
                del dirnames[n]
    # Cleanup.
    for dirpath, dirnames, filenames in os.walk(src_dir, topdown=True):
        assert not filenames
        os.rmdir(dirpath)


class Wheel:

    def __init__(self, filename):
        match = WHEEL_NAME(os.path.basename(filename))
        if match is None:
            raise ValueError('invalid wheel name: %r' % filename)
        self.filename = filename
        for k, v in match.groupdict().items():
            setattr(self, k, v)

    def tags(self):
        '''List tags (py_version, abi, platform) supported by this wheel.'''
        return itertools.product(
            self.py_version.split('.'),
            self.abi.split('.'),
            self.platform.split('.'),
        )

    def is_compatible(self):
        '''Is the wheel is compatible with the current platform?'''
        supported_tags = pep425tags.get_supported()
        return next((True for t in self.tags() if t in supported_tags), False)

    def egg_name(self):
        return pkg_resources.Distribution(
            project_name=self.project_name, version=self.version,
            platform=(None if self.platform == 'any' else get_platform()),
        ).egg_name() + '.egg'

    def get_dist_info(self, zf):
        # find the correct name of the .dist-info dir in the wheel file
        for member in zf.namelist():
            dirname = posixpath.dirname(member)
            if (dirname.endswith('.dist-info') and
                    canonicalize_name(dirname).startswith(
                        canonicalize_name(self.project_name))):
                return dirname
        raise ValueError("unsupported wheel format. .dist-info not found")

    def install_as_egg(self, destination_eggdir):
        '''Install wheel as an egg directory.'''
        with zipfile.ZipFile(self.filename) as zf:
            self._install_as_egg(destination_eggdir, zf)

    def _install_as_egg(self, destination_eggdir, zf):
        dist_basename = '%s-%s' % (self.project_name, self.version)
        dist_info = self.get_dist_info(zf)
        dist_data = '%s.data' % dist_basename
        egg_info = os.path.join(destination_eggdir, 'EGG-INFO')

        self._convert_metadata(zf, destination_eggdir, dist_info, egg_info)
        self._move_data_entries(destination_eggdir, dist_data)
        self._fix_namespace_packages(egg_info, destination_eggdir)

    @staticmethod
    def _convert_metadata(zf, destination_eggdir, dist_info, egg_info):
        def get_metadata(name):
            with zf.open(posixpath.join(dist_info, name)) as fp:
                value = fp.read().decode('utf-8') if PY3 else fp.read()
                return email.parser.Parser().parsestr(value)

        wheel_metadata = get_metadata('WHEEL')
        # Check wheel format version is supported.
        wheel_version = parse_version(wheel_metadata.get('Wheel-Version'))
        wheel_v1 = (
            parse_version('1.0') <= wheel_version < parse_version('2.0dev0')
        )
        if not wheel_v1:
            raise ValueError(
                'unsupported wheel format version: %s' % wheel_version)
        # Extract to target directory.
        os.mkdir(destination_eggdir)
        zf.extractall(destination_eggdir)
        # Convert metadata.
        dist_info = os.path.join(destination_eggdir, dist_info)
        dist = pkg_resources.Distribution.from_location(
            destination_eggdir, dist_info,
            metadata=pkg_resources.PathMetadata(destination_eggdir, dist_info),
        )

        # Note: Evaluate and strip markers now,
        # as it's difficult to convert back from the syntax:
        # foobar; "linux" in sys_platform and extra == 'test'
        def raw_req(req):
            req.marker = None
            return str(req)
        install_requires = list(sorted(map(raw_req, dist.requires())))
        extras_require = {
            extra: sorted(
                req
                for req in map(raw_req, dist.requires((extra,)))
                if req not in install_requires
            )
            for extra in dist.extras
        }
        os.rename(dist_info, egg_info)
        os.rename(
            os.path.join(egg_info, 'METADATA'),
            os.path.join(egg_info, 'PKG-INFO'),
        )
        setup_dist = setuptools.Distribution(
            attrs=dict(
                install_requires=install_requires,
                extras_require=extras_require,
            ),
        )
        write_requirements(
            setup_dist.get_command_obj('egg_info'),
            None,
            os.path.join(egg_info, 'requires.txt'),
        )

    @staticmethod
    def _move_data_entries(destination_eggdir, dist_data):
        """Move data entries to their correct location."""
        dist_data = os.path.join(destination_eggdir, dist_data)
        dist_data_scripts = os.path.join(dist_data, 'scripts')
        if os.path.exists(dist_data_scripts):
            egg_info_scripts = os.path.join(
                destination_eggdir, 'EGG-INFO', 'scripts')
            os.mkdir(egg_info_scripts)
            for entry in os.listdir(dist_data_scripts):
                # Remove bytecode, as it's not properly handled
                # during easy_install scripts install phase.
                if entry.endswith('.pyc'):
                    os.unlink(os.path.join(dist_data_scripts, entry))
                else:
                    os.rename(
                        os.path.join(dist_data_scripts, entry),
                        os.path.join(egg_info_scripts, entry),
                    )
            os.rmdir(dist_data_scripts)
        for subdir in filter(os.path.exists, (
            os.path.join(dist_data, d)
            for d in ('data', 'headers', 'purelib', 'platlib')
        )):
            unpack(subdir, destination_eggdir)
        if os.path.exists(dist_data):
            os.rmdir(dist_data)

    @staticmethod
    def _fix_namespace_packages(egg_info, destination_eggdir):
        namespace_packages = os.path.join(
            egg_info, 'namespace_packages.txt')
        if os.path.exists(namespace_packages):
            with open(namespace_packages) as fp:
                namespace_packages = fp.read().split()
            for mod in namespace_packages:
                mod_dir = os.path.join(destination_eggdir, *mod.split('.'))
                mod_init = os.path.join(mod_dir, '__init__.py')
                if os.path.exists(mod_dir) and not os.path.exists(mod_init):
                    with open(mod_init, 'w') as fp:
                        fp.write(NAMESPACE_PACKAGE_INIT)
site-packages/setuptools/config.py000064400000050066151446177000013340 0ustar00from __future__ import absolute_import, unicode_literals
import io
import os
import sys

import warnings
import functools
from collections import defaultdict
from functools import partial
from functools import wraps
from importlib import import_module

from distutils.errors import DistutilsOptionError, DistutilsFileError
from setuptools.extern.packaging.version import LegacyVersion, parse
from setuptools.extern.packaging.specifiers import SpecifierSet
from setuptools.extern.six import string_types, PY3


__metaclass__ = type


def read_configuration(
        filepath, find_others=False, ignore_option_errors=False):
    """Read given configuration file and returns options from it as a dict.

    :param str|unicode filepath: Path to configuration file
        to get options from.

    :param bool find_others: Whether to search for other configuration files
        which could be on in various places.

    :param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.

    :rtype: dict
    """
    from setuptools.dist import Distribution, _Distribution

    filepath = os.path.abspath(filepath)

    if not os.path.isfile(filepath):
        raise DistutilsFileError(
            'Configuration file %s does not exist.' % filepath)

    current_directory = os.getcwd()
    os.chdir(os.path.dirname(filepath))

    try:
        dist = Distribution()

        filenames = dist.find_config_files() if find_others else []
        if filepath not in filenames:
            filenames.append(filepath)

        _Distribution.parse_config_files(dist, filenames=filenames)

        handlers = parse_configuration(
            dist, dist.command_options,
            ignore_option_errors=ignore_option_errors)

    finally:
        os.chdir(current_directory)

    return configuration_to_dict(handlers)


def _get_option(target_obj, key):
    """
    Given a target object and option key, get that option from
    the target object, either through a get_{key} method or
    from an attribute directly.
    """
    getter_name = 'get_{key}'.format(**locals())
    by_attribute = functools.partial(getattr, target_obj, key)
    getter = getattr(target_obj, getter_name, by_attribute)
    return getter()


def configuration_to_dict(handlers):
    """Returns configuration data gathered by given handlers as a dict.

    :param list[ConfigHandler] handlers: Handlers list,
        usually from parse_configuration()

    :rtype: dict
    """
    config_dict = defaultdict(dict)

    for handler in handlers:
        for option in handler.set_options:
            value = _get_option(handler.target_obj, option)
            config_dict[handler.section_prefix][option] = value

    return config_dict


def parse_configuration(
        distribution, command_options, ignore_option_errors=False):
    """Performs additional parsing of configuration options
    for a distribution.

    Returns a list of used option handlers.

    :param Distribution distribution:
    :param dict command_options:
    :param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.
    :rtype: list
    """
    options = ConfigOptionsHandler(
        distribution, command_options, ignore_option_errors)
    options.parse()

    meta = ConfigMetadataHandler(
        distribution.metadata, command_options, ignore_option_errors,
        distribution.package_dir)
    meta.parse()

    return meta, options


class ConfigHandler:
    """Handles metadata supplied in configuration files."""

    section_prefix = None
    """Prefix for config sections handled by this handler.
    Must be provided by class heirs.

    """

    aliases = {}
    """Options aliases.
    For compatibility with various packages. E.g.: d2to1 and pbr.
    Note: `-` in keys is replaced with `_` by config parser.

    """

    def __init__(self, target_obj, options, ignore_option_errors=False):
        sections = {}

        section_prefix = self.section_prefix
        for section_name, section_options in options.items():
            if not section_name.startswith(section_prefix):
                continue

            section_name = section_name.replace(section_prefix, '').strip('.')
            sections[section_name] = section_options

        self.ignore_option_errors = ignore_option_errors
        self.target_obj = target_obj
        self.sections = sections
        self.set_options = []

    @property
    def parsers(self):
        """Metadata item name to parser function mapping."""
        raise NotImplementedError(
            '%s must provide .parsers property' % self.__class__.__name__)

    def __setitem__(self, option_name, value):
        unknown = tuple()
        target_obj = self.target_obj

        # Translate alias into real name.
        option_name = self.aliases.get(option_name, option_name)

        current_value = getattr(target_obj, option_name, unknown)

        if current_value is unknown:
            raise KeyError(option_name)

        if current_value:
            # Already inhabited. Skipping.
            return

        skip_option = False
        parser = self.parsers.get(option_name)
        if parser:
            try:
                value = parser(value)

            except Exception:
                skip_option = True
                if not self.ignore_option_errors:
                    raise

        if skip_option:
            return

        setter = getattr(target_obj, 'set_%s' % option_name, None)
        if setter is None:
            setattr(target_obj, option_name, value)
        else:
            setter(value)

        self.set_options.append(option_name)

    @classmethod
    def _parse_list(cls, value, separator=','):
        """Represents value as a list.

        Value is split either by separator (defaults to comma) or by lines.

        :param value:
        :param separator: List items separator character.
        :rtype: list
        """
        if isinstance(value, list):  # _get_parser_compound case
            return value

        if '\n' in value:
            value = value.splitlines()
        else:
            value = value.split(separator)

        return [chunk.strip() for chunk in value if chunk.strip()]

    @classmethod
    def _parse_dict(cls, value):
        """Represents value as a dict.

        :param value:
        :rtype: dict
        """
        separator = '='
        result = {}
        for line in cls._parse_list(value):
            key, sep, val = line.partition(separator)
            if sep != separator:
                raise DistutilsOptionError(
                    'Unable to parse option value to dict: %s' % value)
            result[key.strip()] = val.strip()

        return result

    @classmethod
    def _parse_bool(cls, value):
        """Represents value as boolean.

        :param value:
        :rtype: bool
        """
        value = value.lower()
        return value in ('1', 'true', 'yes')

    @classmethod
    def _exclude_files_parser(cls, key):
        """Returns a parser function to make sure field inputs
        are not files.

        Parses a value after getting the key so error messages are
        more informative.

        :param key:
        :rtype: callable
        """
        def parser(value):
            exclude_directive = 'file:'
            if value.startswith(exclude_directive):
                raise ValueError(
                    'Only strings are accepted for the {0} field, '
                    'files are not accepted'.format(key))
            return value
        return parser

    @classmethod
    def _parse_file(cls, value):
        """Represents value as a string, allowing including text
        from nearest files using `file:` directive.

        Directive is sandboxed and won't reach anything outside
        directory with setup.py.

        Examples:
            file: README.rst, CHANGELOG.md, src/file.txt

        :param str value:
        :rtype: str
        """
        include_directive = 'file:'

        if not isinstance(value, string_types):
            return value

        if not value.startswith(include_directive):
            return value

        spec = value[len(include_directive):]
        filepaths = (os.path.abspath(path.strip()) for path in spec.split(','))
        return '\n'.join(
            cls._read_file(path)
            for path in filepaths
            if (cls._assert_local(path) or True)
            and os.path.isfile(path)
        )

    @staticmethod
    def _assert_local(filepath):
        if not filepath.startswith(os.getcwd()):
            raise DistutilsOptionError(
                '`file:` directive can not access %s' % filepath)

    @staticmethod
    def _read_file(filepath):
        with io.open(filepath, encoding='utf-8') as f:
            return f.read()

    @classmethod
    def _parse_attr(cls, value, package_dir=None):
        """Represents value as a module attribute.

        Examples:
            attr: package.attr
            attr: package.module.attr

        :param str value:
        :rtype: str
        """
        attr_directive = 'attr:'
        if not value.startswith(attr_directive):
            return value

        attrs_path = value.replace(attr_directive, '').strip().split('.')
        attr_name = attrs_path.pop()

        module_name = '.'.join(attrs_path)
        module_name = module_name or '__init__'

        parent_path = os.getcwd()
        if package_dir:
            if attrs_path[0] in package_dir:
                # A custom path was specified for the module we want to import
                custom_path = package_dir[attrs_path[0]]
                parts = custom_path.rsplit('/', 1)
                if len(parts) > 1:
                    parent_path = os.path.join(os.getcwd(), parts[0])
                    module_name = parts[1]
                else:
                    module_name = custom_path
            elif '' in package_dir:
                # A custom parent directory was specified for all root modules
                parent_path = os.path.join(os.getcwd(), package_dir[''])
        sys.path.insert(0, parent_path)
        try:
            module = import_module(module_name)
            value = getattr(module, attr_name)

        finally:
            sys.path = sys.path[1:]

        return value

    @classmethod
    def _get_parser_compound(cls, *parse_methods):
        """Returns parser function to represents value as a list.

        Parses a value applying given methods one after another.

        :param parse_methods:
        :rtype: callable
        """
        def parse(value):
            parsed = value

            for method in parse_methods:
                parsed = method(parsed)

            return parsed

        return parse

    @classmethod
    def _parse_section_to_dict(cls, section_options, values_parser=None):
        """Parses section options into a dictionary.

        Optionally applies a given parser to values.

        :param dict section_options:
        :param callable values_parser:
        :rtype: dict
        """
        value = {}
        values_parser = values_parser or (lambda val: val)
        for key, (_, val) in section_options.items():
            value[key] = values_parser(val)
        return value

    def parse_section(self, section_options):
        """Parses configuration file section.

        :param dict section_options:
        """
        for (name, (_, value)) in section_options.items():
            try:
                self[name] = value

            except KeyError:
                pass  # Keep silent for a new option may appear anytime.

    def parse(self):
        """Parses configuration file items from one
        or more related sections.

        """
        for section_name, section_options in self.sections.items():

            method_postfix = ''
            if section_name:  # [section.option] variant
                method_postfix = '_%s' % section_name

            section_parser_method = getattr(
                self,
                # Dots in section names are translated into dunderscores.
                ('parse_section%s' % method_postfix).replace('.', '__'),
                None)

            if section_parser_method is None:
                raise DistutilsOptionError(
                    'Unsupported distribution option section: [%s.%s]' % (
                        self.section_prefix, section_name))

            section_parser_method(section_options)

    def _deprecated_config_handler(self, func, msg, warning_class):
        """ this function will wrap around parameters that are deprecated

        :param msg: deprecation message
        :param warning_class: class of warning exception to be raised
        :param func: function to be wrapped around
        """
        @wraps(func)
        def config_handler(*args, **kwargs):
            warnings.warn(msg, warning_class)
            return func(*args, **kwargs)

        return config_handler


class ConfigMetadataHandler(ConfigHandler):

    section_prefix = 'metadata'

    aliases = {
        'home_page': 'url',
        'summary': 'description',
        'classifier': 'classifiers',
        'platform': 'platforms',
    }

    strict_mode = False
    """We need to keep it loose, to be partially compatible with
    `pbr` and `d2to1` packages which also uses `metadata` section.

    """

    def __init__(self, target_obj, options, ignore_option_errors=False,
                 package_dir=None):
        super(ConfigMetadataHandler, self).__init__(target_obj, options,
                                                    ignore_option_errors)
        self.package_dir = package_dir

    @property
    def parsers(self):
        """Metadata item name to parser function mapping."""
        parse_list = self._parse_list
        parse_file = self._parse_file
        parse_dict = self._parse_dict
        exclude_files_parser = self._exclude_files_parser

        return {
            'platforms': parse_list,
            'keywords': parse_list,
            'provides': parse_list,
            'requires': self._deprecated_config_handler(
                parse_list,
                "The requires parameter is deprecated, please use "
                "install_requires for runtime dependencies.",
                DeprecationWarning),
            'obsoletes': parse_list,
            'classifiers': self._get_parser_compound(parse_file, parse_list),
            'license': exclude_files_parser('license'),
            'description': parse_file,
            'long_description': parse_file,
            'version': self._parse_version,
            'project_urls': parse_dict,
        }

    def _parse_version(self, value):
        """Parses `version` option value.

        :param value:
        :rtype: str

        """
        version = self._parse_file(value)

        if version != value:
            version = version.strip()
            # Be strict about versions loaded from file because it's easy to
            # accidentally include newlines and other unintended content
            if isinstance(parse(version), LegacyVersion):
                tmpl = (
                    'Version loaded from {value} does not '
                    'comply with PEP 440: {version}'
                )
                raise DistutilsOptionError(tmpl.format(**locals()))

            return version

        version = self._parse_attr(value, self.package_dir)

        if callable(version):
            version = version()

        if not isinstance(version, string_types):
            if hasattr(version, '__iter__'):
                version = '.'.join(map(str, version))
            else:
                version = '%s' % version

        return version


class ConfigOptionsHandler(ConfigHandler):

    section_prefix = 'options'

    @property
    def parsers(self):
        """Metadata item name to parser function mapping."""
        parse_list = self._parse_list
        parse_list_semicolon = partial(self._parse_list, separator=';')
        parse_bool = self._parse_bool
        parse_dict = self._parse_dict

        return {
            'zip_safe': parse_bool,
            'use_2to3': parse_bool,
            'include_package_data': parse_bool,
            'package_dir': parse_dict,
            'use_2to3_fixers': parse_list,
            'use_2to3_exclude_fixers': parse_list,
            'convert_2to3_doctests': parse_list,
            'scripts': parse_list,
            'eager_resources': parse_list,
            'dependency_links': parse_list,
            'namespace_packages': parse_list,
            'install_requires': parse_list_semicolon,
            'setup_requires': parse_list_semicolon,
            'tests_require': parse_list_semicolon,
            'packages': self._parse_packages,
            'entry_points': self._parse_file,
            'py_modules': parse_list,
            'python_requires': SpecifierSet,
        }

    def _parse_packages(self, value):
        """Parses `packages` option value.

        :param value:
        :rtype: list
        """
        find_directives = ['find:', 'find_namespace:']
        trimmed_value = value.strip()

        if trimmed_value not in find_directives:
            return self._parse_list(value)

        findns = trimmed_value == find_directives[1]
        if findns and not PY3:
            raise DistutilsOptionError(
                'find_namespace: directive is unsupported on Python < 3.3')

        # Read function arguments from a dedicated section.
        find_kwargs = self.parse_section_packages__find(
            self.sections.get('packages.find', {}))

        if findns:
            from setuptools import find_namespace_packages as find_packages
        else:
            from setuptools import find_packages

        return find_packages(**find_kwargs)

    def parse_section_packages__find(self, section_options):
        """Parses `packages.find` configuration file section.

        To be used in conjunction with _parse_packages().

        :param dict section_options:
        """
        section_data = self._parse_section_to_dict(
            section_options, self._parse_list)

        valid_keys = ['where', 'include', 'exclude']

        find_kwargs = dict(
            [(k, v) for k, v in section_data.items() if k in valid_keys and v])

        where = find_kwargs.get('where')
        if where is not None:
            find_kwargs['where'] = where[0]  # cast list to single val

        return find_kwargs

    def parse_section_entry_points(self, section_options):
        """Parses `entry_points` configuration file section.

        :param dict section_options:
        """
        parsed = self._parse_section_to_dict(section_options, self._parse_list)
        self['entry_points'] = parsed

    def _parse_package_data(self, section_options):
        parsed = self._parse_section_to_dict(section_options, self._parse_list)

        root = parsed.get('*')
        if root:
            parsed[''] = root
            del parsed['*']

        return parsed

    def parse_section_package_data(self, section_options):
        """Parses `package_data` configuration file section.

        :param dict section_options:
        """
        self['package_data'] = self._parse_package_data(section_options)

    def parse_section_exclude_package_data(self, section_options):
        """Parses `exclude_package_data` configuration file section.

        :param dict section_options:
        """
        self['exclude_package_data'] = self._parse_package_data(
            section_options)

    def parse_section_extras_require(self, section_options):
        """Parses `extras_require` configuration file section.

        :param dict section_options:
        """
        parse_list = partial(self._parse_list, separator=';')
        self['extras_require'] = self._parse_section_to_dict(
            section_options, parse_list)

    def parse_section_data_files(self, section_options):
        """Parses `data_files` configuration file section.

        :param dict section_options:
        """
        parsed = self._parse_section_to_dict(section_options, self._parse_list)
        self['data_files'] = [(k, v) for k, v in parsed.items()]
site-packages/setuptools/__pycache__/wheel.cpython-38.opt-1.pyc000064400000015564151446177000020430 0ustar00U

�Qab��@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddl	mZddlm
Z
ddlmZddl
mZddlmZeZe�d	ej�jZd
Zdd�ZGd
d�d�ZdS)zWheels support.�)�get_platformN)�
parse_version)�canonicalize_name)�PY3)�
pep425tags)�write_requirementsz�^(?P<project_name>.+?)-(?P<version>\d.*?)
    ((-(?P<build>\d.*?))?-(?P<py_version>.+?)-(?P<abi>.+?)-(?P<platform>.+?)
    )\.whl$z�try:
    __import__('pkg_resources').declare_namespace(__name__)
except ImportError:
    __path__ = __import__('pkgutil').extend_path(__path__, __name__)
cCs�t�|�D]�\}}}tj�||�}|D].}tj�||�}tj�|||�}t�||�q&ttt|���D]D\}	}
tj�||
�}tj�|||
�}tj�	|�sft�||�||	=qfq
tj|dd�D]\}}}t�
|�q�dS)zDMove everything under `src_dir` to `dst_dir`, and delete the former.T)�topdownN)�os�walk�path�relpath�join�renames�reversed�list�	enumerate�exists�rmdir)Zsrc_dirZdst_dir�dirpathZdirnames�	filenames�subdir�f�srcZdst�n�d�r�4/usr/lib/python3.8/site-packages/setuptools/wheel.py�unpack%s
rc@sheZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	e
dd��Ze
dd��Ze
dd��Z
dS)�WheelcCsPttj�|��}|dkr$td|��||_|����D]\}}t|||�q6dS)Nzinvalid wheel name: %r)	�
WHEEL_NAMEr	r�basename�
ValueError�filename�	groupdict�items�setattr)�selfr"�match�k�vrrr�__init__=szWheel.__init__cCs&t�|j�d�|j�d�|j�d��S)z>List tags (py_version, abi, platform) supported by this wheel.�.)�	itertools�productZ
py_version�splitZabi�platform�r&rrr�tagsEs



�z
Wheel.tagscs$t���t�fdd�|��D�d�S)z5Is the wheel is compatible with the current platform?c3s|]}|�krdVqdS)TNr)�.0�t�Zsupported_tagsrr�	<genexpr>Psz&Wheel.is_compatible.<locals>.<genexpr>F)rZ
get_supported�nextr1r0rr4r�
is_compatibleMszWheel.is_compatiblecCs,tj|j|j|jdkrdnt�d���dS)N�any)�project_name�versionr/z.egg)�
pkg_resources�Distributionr9r:r/r�egg_namer0rrrr=Rs��zWheel.egg_namecCsJ|��D]4}t�|�}|�d�rt|��t|j��r|Sqtd��dS)Nz
.dist-infoz.unsupported wheel format. .dist-info not found)Znamelist�	posixpath�dirname�endswithr�
startswithr9r!)r&�zf�memberr?rrr�
get_dist_infoXs

��
zWheel.get_dist_infoc	Cs(t�|j��}|�||�W5QRXdS)z"Install wheel as an egg directory.N)�zipfileZZipFiler"�_install_as_egg)r&�destination_eggdirrBrrr�install_as_eggbszWheel.install_as_eggcCs\d|j|jf}|�|�}d|}tj�|d�}|�||||�|�||�|�||�dS)Nz%s-%sz%s.data�EGG-INFO)	r9r:rDr	rr
�_convert_metadata�_move_data_entries�_fix_namespace_packages)r&rGrBZ
dist_basename�	dist_info�	dist_data�egg_inforrrrFgs
zWheel._install_as_eggc
s&��fdd�}|d�}t|�d��}td�|ko>td�kn}|sTtd|��t�|���|�tj�|���tj	j
|�t�|��d��d	d
��tt
t�����������fdd��jD�}t��|�t�tj�|d
�tj�|d��tj	t�|d�d�}	t|	�d�dtj�|d��dS)Nc
sT��t��|���8}tr&|���d�n|��}tj���	|�W5QR�SQRXdS)Nzutf-8)
�openr>r
r�read�decode�email�parserZParserZparsestr)�name�fp�value)rMrBrr�get_metadatassz-Wheel._convert_metadata.<locals>.get_metadataZWHEELz
Wheel-Versionz1.0z2.0dev0z$unsupported wheel format version: %s)ZmetadatacSsd|_t|�S�N)Zmarker�str)�reqrrr�raw_req�sz(Wheel._convert_metadata.<locals>.raw_reqc
s2i|]*}|t�fdd�t���|f��D���qS)c3s|]}|�kr|VqdSrYr)r2r[)�install_requiresrrr5�s�z5Wheel._convert_metadata.<locals>.<dictcomp>.<genexpr>)�sorted�map�requires)r2Zextra)�distr]r\rr�
<dictcomp>�s
��z+Wheel._convert_metadata.<locals>.<dictcomp>ZMETADATAzPKG-INFO)r]�extras_require)ZattrsrOzrequires.txt)r�getr!r	�mkdirZ
extractallrr
r;r<Z
from_locationZPathMetadatarr^r_r`Zextras�rename�
setuptools�dictrZget_command_obj)
rBrGrMrOrXZwheel_metadataZ
wheel_versionZwheel_v1rcZ
setup_distr)rarMr]r\rBrrJqsL��


������zWheel._convert_metadatacs�tj�|���tj��d�}tj�|�r�tj�|dd�}t�|�t�|�D]D}|�d�rpt�tj�||��qLt�tj�||�tj�||��qLt�	|�t
tjj�fdd�dD��D]}t||�q�tj���r�t�	��dS)z,Move data entries to their correct location.ZscriptsrIz.pycc3s|]}tj��|�VqdSrY)r	rr
)r2r�rNrrr5�s�z+Wheel._move_data_entries.<locals>.<genexpr>)�dataZheadersZpurelibZplatlibN)r	rr
rre�listdirr@�unlinkrfr�filterr)rGrNZdist_data_scriptsZegg_info_scripts�entryrrrirrK�s.�

�
�zWheel._move_data_entriesc
Cs�tj�|d�}tj�|�r�t|��}|����}W5QRX|D]b}tjj|f|�d���}tj�|d�}tj�|�r>tj�|�s>t|d��}|�t�W5QRXq>dS)Nznamespace_packages.txtr+z__init__.py�w)	r	rr
rrPrQr.�write�NAMESPACE_PACKAGE_INIT)rOrGZnamespace_packagesrV�modZmod_dirZmod_initrrrrL�s�
zWheel._fix_namespace_packagesN)�__name__�
__module__�__qualname__r*r1r7r=rDrHrF�staticmethodrJrKrLrrrrr;s


9
r)�__doc__Zdistutils.utilrrSr,r	r>�rerEr;rgrZ!setuptools.extern.packaging.utilsrZsetuptools.extern.sixrrZsetuptools.command.egg_infor�typeZ
__metaclass__�compile�VERBOSEr'rrqrrrrrr�<module>s,�site-packages/setuptools/__pycache__/depends.cpython-38.pyc000064400000012140151446177000017772 0ustar00U

�Qab��@s�ddlZddlZddlZddlmZddlmZddlmZm	Z	m
Z
mZddlmZddd	d
gZ
Gdd�d�Zdd
�Zddd	�Zddd
�Zdd�Ze�dS)�N)�
StrictVersion�)�Bytecode)�find_module�PY_COMPILED�	PY_FROZEN�	PY_SOURCE)�
py27compat�Requirer�get_module_constant�extract_constantc@sHeZdZdZddd�Zdd�Zdd	�Zddd�Zdd
d�Zddd�Z	dS)r
z7A prerequisite to building or installing a distribution�NcCsF|dkr|dk	rt}|dk	r0||�}|dkr0d}|j�t��|`dS)N�__version__)r�__dict__�update�locals�self)r�name�requested_version�moduleZhomepage�	attribute�format�r�6/usr/lib/python3.8/site-packages/setuptools/depends.py�__init__szRequire.__init__cCs |jdk	rd|j|jfS|jS)z0Return full package/distribution name, w/versionNz%s-%s)rr)rrrr�	full_name#s
zRequire.full_namecCs*|jdkp(|jdkp(t|�dko(||jkS)z%Is 'version' sufficiently up-to-date?N�unknown)rr�strr)r�versionrrr�
version_ok)s�zRequire.version_okrcCs�|jdkrFz$t|j|�\}}}|r*|��|WStk
rDYdSXt|j|j||�}|dk	r|||k	r||jdk	r||�|�S|S)a�Get version number of installed module, 'None', or 'default'

        Search 'paths' for module.  If not found, return 'None'.  If found,
        return the extracted version attribute, or 'default' if no version
        attribute was specified, or the value cannot be determined without
        importing the module.  The version is formatted according to the
        requirement's version format (if any), unless it is 'None' or the
        supplied 'default'.
        N)rrr�close�ImportErrorrr)r�paths�default�f�p�i�vrrr�get_version.s

zRequire.get_versioncCs|�|�dk	S)z/Return true if dependency is present on 'paths'N)r()rr"rrr�
is_presentIszRequire.is_presentcCs |�|�}|dkrdS|�|�S)z>Return true if dependency is present and up-to-date on 'paths'NF)r(r)rr"rrrr�
is_currentMs
zRequire.is_current)r
NN)Nr)N)N)
�__name__�
__module__�__qualname__�__doc__rrrr(r)r*rrrrr
s�


cCs"tjdd��}|s|�St�|�S)Ncss
dVdS)Nrrrrr�emptyVszmaybe_close.<locals>.empty)�
contextlib�contextmanager�closing)r$r/rrr�maybe_closeUs

r3���c
Cs�zt||�\}}\}}}}	Wntk
r4YdSXt|��z|tkr^|�d�t�|�}
nV|tkrtt�	||�}
n@|t
kr�t|��|d�}
n&t�|||	�}t
||d�W5QR�SW5QRXt|
||�S)z�Find 'module' by searching 'paths', and extract 'symbol'

    Return 'None' if 'module' does not exist on 'paths', or it does not define
    'symbol'.  If the module defines 'symbol' as a constant, return the
    constant.  Otherwise, return 'default'.N��exec)rr!r3r�read�marshal�loadrr	�get_frozen_objectr�compileZ
get_module�getattrr)r�symbolr#r"r$�path�suffix�modeZkind�info�codeZimportedrrrr`s

"cCs�||jkrdSt|j��|�}d}d}d}|}t|�D]H}|j}	|j}
|	|krZ|j|
}q6|
|krz|	|ksr|	|krz|S|}q6dS)aExtract the constant value of 'symbol' from 'code'

    If the name 'symbol' is bound to a constant value by the Python code
    object 'code', return that value.  If 'symbol' is bound to an expression,
    return 'default'.  Otherwise, return 'None'.

    Return value is based on the first assignment to 'symbol'.  'symbol' must
    be a global, or at least a non-"fast" local in the code block.  That is,
    only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol'
    must be present in 'code.co_names'.
    N�Z�a�d)�co_names�list�indexrZopcode�arg�	co_consts)rBr=r#Zname_idxZ
STORE_NAMEZSTORE_GLOBALZ
LOAD_CONST�constZ	byte_code�oprIrrrr}s
cCs>tj�d�stjdkrdSd}|D]}t�|=t�|�q"dS)z�
    Patch the globals to remove the objects not available on some platforms.

    XXX it'd be better to test assertions about bytecode instead.
    �javaZcliN)rr)�sys�platform�
startswith�globals�__all__�remove)Zincompatiblerrrr�_update_globals�srT)r4N)r4)rNr8r0Zdistutils.versionrZ
py33compatrr	rrrrr
rRr
r3rrrTrrrr�<module>s"�D

$site-packages/setuptools/__pycache__/__init__.cpython-38.opt-1.pyc000064400000017130151446177000021052 0ustar00U

�Qabs�@s�dZddlZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddlm
Z
ddlmZddlmZmZdd	lmZmZddlZdd
lmZddlmZmZddlmZdd
lm Z e!Z"ddddddddgZ#er�e#�$d�ej%j&Z&dZ'dZ(dgZ)Gdd�d�Z*Gdd�de*�Z+e*j,Z-e�r,e+j,Z.dd�Z/dd�Z0ej1j0je0_e �2ej1j3�Z4Gd d�de4�Z3d!d"�Z5ej6fd#d$�Z7e �8�dS)%z@Extensions to the 'distutils' for large or complex distributions�N)�DistutilsOptionError)�convert_path��fnmatchcase�)�SetuptoolsDeprecationWarning)�PY3�string_types)�filter�map)�	Extension)�Distribution�Feature)�Require)�monkey�setupr
r�Commandrrr�
find_packages�find_namespace_packagesTz
lib2to3.fixesc@sBeZdZdZeddd��Zedd��Zed	d
��Zedd��Z	d
S)�
PackageFinderzI
    Generate a list of all Python packages found within a directory
    �.���*cCs&t|�t|�|jd|��|j|���S)a	Return a list all Python packages found within directory 'where'

        'where' is the root directory which will be searched for packages.  It
        should be supplied as a "cross-platform" (i.e. URL-style) path; it will
        be converted to the appropriate local path syntax.

        'exclude' is a sequence of package names to exclude; '*' can be used
        as a wildcard in the names, such that 'foo.*' will exclude all
        subpackages of 'foo' (but not 'foo' itself).

        'include' is a sequence of package names to include.  If it's
        specified, only the named packages will be included.  If it's not
        specified, all found packages will be included.  'include' can contain
        shell style wildcard patterns just like 'exclude'.
        �ez_setup�*__pycache__)rr)�list�_find_packages_iterr�
_build_filter)�cls�where�exclude�includerr�7/usr/lib/python3.8/site-packages/setuptools/__init__.py�find4s
�zPackageFinder.findccs�tj|dd�D]�\}}}|dd�}g|dd�<|D]d}tj�||�}	tj�|	|�}
|
�tjjd�}d|ks4|�|	�sxq4||�r�||�s�|V|�|�q4qdS)zy
        All the packages found in 'where' that pass the 'include' filter, but
        not the 'exclude' filter.
        T��followlinksNr)	�os�walk�path�join�relpath�replace�sep�_looks_like_package�append)rr r!r"�root�dirs�filesZall_dirs�dir�	full_pathZrel_path�packagerrr#rKsz!PackageFinder._find_packages_itercCstj�tj�|d��S)z%Does a directory look like a package?z__init__.py)r'r)�isfiler*�r)rrr#r.gsz!PackageFinder._looks_like_packagecs�fdd�S)z�
        Given a list of patterns, return a callable that will be true only if
        the input matches at least one of the patterns.
        cst�fdd��D��S)Nc3s|]}t�|d�VqdS))�patNr)�.0r8��namerr#�	<genexpr>rsz@PackageFinder._build_filter.<locals>.<lambda>.<locals>.<genexpr>)�anyr:�Zpatternsr:r#�<lambda>r�z-PackageFinder._build_filter.<locals>.<lambda>rr>rr>r#rlszPackageFinder._build_filterN)rrr)
�__name__�
__module__�__qualname__�__doc__�classmethodr$r�staticmethodr.rrrrr#r/s

rc@seZdZedd��ZdS)�PEP420PackageFindercCsdS)NTrr7rrr#r.vsz'PEP420PackageFinder._looks_like_packageN)rArBrCrFr.rrrr#rGusrGcCs@tj�tdd�|��D���}|jdd�|jr<|�|j�dS)Ncss"|]\}}|dkr||fVqdS))Zdependency_links�setup_requiresNr)r9�k�vrrr#r<�s�z*_install_setup_requires.<locals>.<genexpr>T)Zignore_option_errors)�	distutils�corer
�dict�itemsZparse_config_filesrHZfetch_build_eggs)�attrs�distrrr#�_install_setup_requires�s�
rQcKst|�tjjf|�S�N)rQrKrLr)rOrrr#r�sc@s:eZdZejZdZdd�Zddd�Zdd�Zd
d
d�Z	dS)rFcKst�||�t|��|�dS)zj
        Construct the command for dist, updating
        vars(self) with any keyword parameters.
        N)�_Command�__init__�vars�update)�selfrP�kwrrr#rT�szCommand.__init__NcCsBt||�}|dkr"t|||�|St|t�s>td|||f��|S)Nz'%s' must be a %s (got `%s`))�getattr�setattr�
isinstancer	r)rW�optionZwhat�default�valrrr#�_ensure_stringlike�s

�zCommand._ensure_stringlikecCspt||�}|dkrdSt|t�r6t||t�d|��n6t|t�rTtdd�|D��}nd}|sltd||f��dS)z�Ensure that 'option' is a list of strings.  If 'option' is
        currently a string, we split it either on /,\s*/ or /\s+/, so
        "foo bar baz", "foo,bar,baz", and "foo,   bar baz" all become
        ["foo", "bar", "baz"].
        Nz,\s*|\s+css|]}t|t�VqdSrR)r[r	)r9rJrrr#r<�sz-Command.ensure_string_list.<locals>.<genexpr>Fz''%s' must be a list of strings (got %r))	rYr[r	rZ�re�splitr�allr)rWr\r^�okrrr#�ensure_string_list�s


��zCommand.ensure_string_listrcKs t�|||�}t|��|�|SrR)rS�reinitialize_commandrUrV)rWZcommandZreinit_subcommandsrX�cmdrrr#re�szCommand.reinitialize_command)N)r)
rArBrCrSrDZcommand_consumes_argumentsrTr_rdrerrrr#r�s

cCs&dd�tj|dd�D�}ttjj|�S)z%
    Find all files under 'path'
    css,|]$\}}}|D]}tj�||�VqqdSrR)r'r)r*)r9�baser1r2�filerrr#r<�s�z#_find_all_simple.<locals>.<genexpr>Tr%)r'r(r
r)r6)r)�resultsrrr#�_find_all_simple�s�rjcCs6t|�}|tjkr.tjtjj|d�}t||�}t|�S)z�
    Find all files under 'dir' and return the list of full filenames.
    Unless dir is '.', return full filenames with dir prepended.
    )�start)	rjr'�curdir�	functools�partialr)r+rr)r3r2Zmake_relrrr#�findall�s


ro)9rDr'�sysrmZdistutils.corerKZdistutils.filelistr`Zdistutils.errorsrZdistutils.utilrZfnmatchrZ_deprecation_warningrZsetuptools.extern.sixrr	Zsetuptools.extern.six.movesr
rZsetuptools.versionZ
setuptoolsZsetuptools.extensionrZsetuptools.distr
rZsetuptools.dependsr�r�typeZ
__metaclass__�__all__r/�version�__version__Zbootstrap_install_fromZrun_2to3_on_doctestsZlib2to3_fixer_packagesrrGr$rrrQrrLZ
get_unpatchedrrSrjrlroZ	patch_allrrrr#�<module>s\�
F
2
site-packages/setuptools/__pycache__/windows_support.cpython-38.opt-1.pyc000064400000001735151446177000022605 0ustar00U

�Qab��@s(ddlZddlZdd�Zedd��ZdS)�NcCst��dkrdd�S|S)NZWindowsc_sdS)N�)�args�kwargsrr�>/usr/lib/python3.8/site-packages/setuptools/windows_support.py�<lambda>�zwindows_only.<locals>.<lambda>)�platform�system)�funcrrr�windows_onlysrcCsLtd�tjjj}tjjtjjf|_tjj	|_
d}|||�}|sHt���dS)z�
    Set the hidden attribute on a file or directory.

    From http://stackoverflow.com/questions/19622133/

    `path` must be text.
    zctypes.wintypes�N)�
__import__�ctypesZwindllZkernel32ZSetFileAttributesWZwintypesZLPWSTRZDWORDZargtypesZBOOLZrestypeZWinError)�pathZSetFileAttributes�FILE_ATTRIBUTE_HIDDEN�retrrr�	hide_files	


r)rrrrrrrr�<module>ssite-packages/setuptools/__pycache__/pep425tags.cpython-38.opt-1.pyc000064400000016043151446177000021213 0ustar00U

�Qabm*�@s�dZddlmZddlZddlmZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
mZddlmZe�d	�Zd
d�Zdd
�Zdd�Zdd�Zdd�Zd$dd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd%d"d#�Ze�ZdS)&z2Generate and work with PEP 425 Compatibility Tags.�)�absolute_importN)�log)�OrderedDict�)�six)�glibcz(.+)_(\d+)_(\d+)_(.+)c
CsLzt�|�WStk
rF}zt�d�|�t�WY�dSd}~XYnXdS)Nz{})�	sysconfig�get_config_var�IOError�warnings�warn�format�RuntimeWarning)�var�e�r�9/usr/lib/python3.8/site-packages/setuptools/pep425tags.pyr	s
r	cCs:ttd�rd}n&tj�d�r"d}ntjdkr2d}nd}|S)z'Return abbreviated implementation name.�pypy_version_info�pp�javaZjyZcliZip�cp)�hasattr�sys�platform�
startswith)Zpyimplrrr�
get_abbr_impls

rcCs,td�}|rt�dkr(d�ttt���}|S)zReturn implementation version.Zpy_version_nodotr�)r	r�join�map�str�get_impl_version_info)Zimpl_verrrr�get_impl_ver+sr!cCs:t�dkr"tjdtjjtjjfStjdtjdfSdS)zQReturn sys.version_info-like tuple for use in decrementing the minor
    version.rrrN)rr�version_infor�major�minorrrrrr 3s

�r cCsd�t�t��S)z;
    Returns the Tag for this specific implementation.
    z{}{})r
rr!rrrr�get_impl_tag>sr%TcCs.t|�}|dkr&|r t�d|�|�S||kS)zgUse a fallback method for determining SOABI flags if the needed config
    var is unset or unavailable.Nz>Config variable '%s' is unset, Python ABI tag may be incorrect)r	r�debug)rZfallback�expectedr�valrrr�get_flagEs�r)cs�td�}t��|s��dkr�ttd�r�d}d}d}tddd��dkd	�rJd
}td�fdd��dkd	�rhd
}tddd�d�dko�tjd�r�tjr�d}d�t�|||f}n@|r�|�d�r�d|�	d�d}n|r�|�
dd��
dd�}nd}|S)zXReturn the ABI tag based on SOABI (if available) or emulate SOABI
    (CPython 2, PyPy).ZSOABI>rr�
maxunicoderZPy_DEBUGcSs
ttd�S)NZgettotalrefcount)rrrrrr�<lambda>[�zget_abi_tag.<locals>.<lambda>r)r�dZ
WITH_PYMALLOCcs�dkS)Nrrr��implrrr+_r,�mZPy_UNICODE_SIZEcSs
tjdkS)Ni��)rr*rrrrr+cr,�)r'r�uz
%s%s%s%s%szcpython-�-r�.�_N)r	rrrr)rZPY2r!r�split�replace)Zsoabir-r0r2�abirr.r�get_abi_tagQs@�
���r9cCs
tjdkS)Ni���)r�maxsizerrrr�_is_running_32bitssr;cCs�tjdkr^t��\}}}|�d�}|dkr6t�r6d}n|dkrHt�rHd}d�|d|d	|�Stj���	dd
��	dd
�}|dkr�t�r�d
}|S)z0Return our platform name 'win32', 'linux_x86_64'�darwinr4�x86_64�i386�ppc64�ppczmacosx_{}_{}_{}rrr5r3�linux_x86_64�
linux_i686)
rrZmac_verr6r;r
�	distutils�util�get_platformr7)�releaser5�machineZ	split_ver�resultrrrrEws

rEc	CsHt�dkrdSzddl}t|j�WSttfk
r:YnXt�dd�S)N>rArBFr��)rE�
_manylinux�boolZmanylinux1_compatible�ImportError�AttributeErrorrZhave_compatible_glibc)rKrrr�is_manylinux1_compatible�s
rOcsrg}��fdd��tddddg���|||�r8|�|��D]&}|�|kr<�|||�r<|�|�q<|�d�|S)z�Return a list of supported arches (including group arches) for
    the given major, minor and machine architecture of a macOS machine.
    cs||dkr||fdkS|dkr(||fdkS|dkr<||fdkS|dkrP||fdkS|�krx�|D]}�|||�r`dSq`dS)	Nr@)�
rJr?r>)rPr1r=TFr)r#r$�arch�garch��_supports_arch�groupsrrrT�sz)get_darwin_arches.<locals>._supports_arch)Zfat)r>r@)Zintel)r=r>)Zfat64)r=r?)Zfat32)r=r>r@Z	universal)r�append)r#r$rG�archesrRrrSr�get_darwin_arches�s$�

rXFc	Cs�g}|dkrTg}t�}|dd�}t|ddd�D] }|�d�tt||f���q2|p\t�}g}	|pjt�}|r~|g|	dd�<t�}
ddl	}|�
�D],}|d�d�r�|
�|d�
dd�d�q�|	�tt|
���|	�d	�|�sT|p�t�}
|
�d
��rzt�|
�}|�rr|��\}}}}d�||�}g}ttt|�d��D]0}tt|�||�D]}|�|||f��qR�q>n|
g}n*|dk�r�t��r�|
�dd
�|
g}n|
g}|	D].}|D]"}
|�d||df||
f��q��q�|dd�D]F}|dk�r��q,|
D]*}|D]}
|�d||f||
f��q�q��q�|D]"}
|�d|ddd	|
f��q0|�d||dfd	df�|�d||ddfd	df�t|�D]B\}}|�d|fd	df�|dk�r�|�d|dd	df��q�|S)acReturn a list of supported tags for each version specified in
    `versions`.

    :param versions: a list of string versions, of the form ["33", "32"],
        or None. The first version will be assumed to support our ABI.
    :param platform: specify the exact platform you want valid
        tags for, or None. If None, use the local system platform.
    :param impl: specify the exact implementation you want valid
        tags for, or None. If None, use the local interpreter impl.
    :param abi: specify the exact abi you want valid
        tags for, or None. If None, use the local interpreter abi.
    N���rrz.abir4rIrZnoneZmacosxz{}_{}_%i_%sZlinuxZ
manylinux1z%s%s>�30�31zpy%s�any)r �rangerVrrrrr9�set�impZget_suffixesr�addr6�extend�sorted�listrE�
_osx_arch_pat�matchrUr
�reversed�intrXrOr7�	enumerate)ZversionsZnoarchrr/r8Z	supportedr"r#r$ZabisZabi3sr_�suffixrQre�nameZactual_archZtplrWr0�a�version�irrr�
get_supported�sh




$
$  
rn)TT)NFNNN) �__doc__Z
__future__rZdistutils.utilrCrr�rerrr�collectionsrZexternrrr�compilerdr	rr!r r%r)r9r;rErOrXrnZimplementation_tagrrrr�<module>s8


"=�
`site-packages/setuptools/__pycache__/ssl_support.cpython-38.opt-1.pyc000064400000015307151446177000021714 0ustar00U

�Qab-!�@s�ddlZddlZddlZddlZddlZddlmZmZmZm	Z	ddl
mZmZzddl
Z
Wnek
rtdZ
YnXdddddgZd	����ZzejjZejZWnek
r�eZZYnXe
dk	o�eeefkZzdd
l
mZmZWnRek
�r:zddlmZddlmZWnek
�r4dZdZYnXYnXe�sRGd
d�de�Ze�sjddd�Zdd�ZGdd�de�ZGdd�de�Zd dd�Z dd�Z!e!dd��Z"dd�Z#dd�Z$dS)!�N)�urllib�http_client�map�filter)�ResolutionError�ExtractionError�VerifyingHTTPSHandler�find_ca_bundle�is_available�
cert_paths�
opener_fora
/etc/pki/tls/certs/ca-bundle.crt
/etc/ssl/certs/ca-certificates.crt
/usr/share/ssl/certs/ca-bundle.crt
/usr/local/share/certs/ca-root.crt
/etc/ssl/cert.pem
/System/Library/OpenSSL/certs/cert.pem
/usr/local/share/certs/ca-root-nss.crt
/etc/ssl/ca-bundle.pem
)�CertificateError�match_hostname)r
)rc@seZdZdS)r
N)�__name__�
__module__�__qualname__�rr�:/usr/lib/python3.8/site-packages/setuptools/ssl_support.pyr
5sr
�c
Cs�g}|sdS|�d�}|d}|dd�}|�d�}||krLtdt|���|s`|��|��kS|dkrt|�d�n>|�d	�s�|�d	�r�|�t�|��n|�t�|��	d
d��|D]}|�t�|��q�t�
dd
�|�dtj�}	|	�
|�S)zqMatching according to RFC 6125, section 6.4.3

        https://tools.ietf.org/html/rfc6125#section-6.4.3
        F�.rrN�*z,too many wildcards in certificate DNS name: z[^.]+zxn--z\*z[^.]*z\Az\.z\Z)�split�countr
�repr�lower�append�
startswith�re�escape�replace�compile�join�
IGNORECASE�match)
Zdn�hostnameZ
max_wildcardsZpats�partsZleftmostZ	remainderZ	wildcardsZfragZpatrrr�_dnsname_match;s,


�r&cCs�|std��g}|�dd�}|D]*\}}|dkr t||�r@dS|�|�q |s�|�dd�D]6}|D],\}}|dkrdt||�r�dS|�|�qdq\t|�dkr�td	|d
�tt|��f��n*t|�dkr�td||df��ntd
��dS)a=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.
        zempty or no certificateZsubjectAltNamerZDNSNZsubjectZ
commonNamerz&hostname %r doesn't match either of %sz, zhostname %r doesn't match %rrz=no appropriate commonName or subjectAltName fields were found)	�
ValueError�getr&r�lenr
r!rr)Zcertr$ZdnsnamesZsan�key�value�subrrrros2

�
�rc@s eZdZdZdd�Zdd�ZdS)rz=Simple verifying handler: no auth, subclasses, timeouts, etc.cCs||_t�|�dS�N)�	ca_bundle�HTTPSHandler�__init__)�selfr.rrrr0�szVerifyingHTTPSHandler.__init__cs���fdd�|�S)Ncst|�jf|�Sr-)�VerifyingHTTPSConnr.)�host�kw�r1rr�<lambda>��z2VerifyingHTTPSHandler.https_open.<locals>.<lambda>)Zdo_open)r1Zreqrr5r�
https_open�s
�z VerifyingHTTPSHandler.https_openN)rrr�__doc__r0r8rrrrr�sc@s eZdZdZdd�Zdd�ZdS)r2z@Simple verifying connection: no auth, subclasses, timeouts, etc.cKstj||f|�||_dSr-)�HTTPSConnectionr0r.)r1r3r.r4rrrr0�szVerifyingHTTPSConn.__init__cCs�t�|j|jft|dd��}t|d�rHt|dd�rH||_|��|j}n|j}tt	d�rxt	j
|jd�}|j||d�|_nt	j|t	j
|jd�|_zt|j��|�Wn.tk
r�|j�tj�|j���YnXdS)NZsource_address�_tunnel�_tunnel_host�create_default_context)Zcafile)Zserver_hostname)Z	cert_reqsZca_certs)�socketZcreate_connectionr3Zport�getattr�hasattr�sockr;r<�sslr=r.Zwrap_socketZ
CERT_REQUIREDrZgetpeercertr
ZshutdownZ	SHUT_RDWR�close)r1rAZactual_hostZctxrrr�connect�s.

�
�
zVerifyingHTTPSConn.connectN)rrrr9r0rDrrrrr2�sr2cCstj�t|pt���jS)z@Get a urlopen() replacement that uses ca_bundle for verification)r�requestZbuild_openerrr	�open)r.rrrr�s�cst����fdd��}|S)Ncst�d�s�||��_�jS)N�always_returns)r@rG)�args�kwargs��funcrr�wrapper�s
zonce.<locals>.wrapper)�	functools�wraps)rKrLrrJr�once�srOcsZzddl}Wntk
r"YdSXG�fdd�d|j����}|�d�|�d�|jS)Nrcs,eZdZ��fdd�Z��fdd�Z�ZS)z"get_win_certfile.<locals>.CertFilecst�|���t�|j�dSr-)�superr0�atexit�registerrCr5��CertFile�	__class__rrr0�sz+get_win_certfile.<locals>.CertFile.__init__cs,zt�|���Wntk
r&YnXdSr-)rPrC�OSErrorr5rSrrrC�sz(get_win_certfile.<locals>.CertFile.close)rrrr0rC�
__classcell__r�rT)rUrrT�srTZCAZROOT)�wincertstore�ImportErrorrTZaddstore�name)rYZ	_wincertsrrXr�get_win_certfile�s

r\cCs$ttjjt�}t�p"t|d�p"t�S)z*Return an existing CA bundle path, or NoneN)r�os�path�isfilerr\�next�_certifi_where)Zextant_cert_pathsrrrr	�s��c
Cs.ztd���WStttfk
r(YnXdS)NZcertifi)�
__import__�whererZrrrrrrrasra)r)N)%r]r>rQrrMZsetuptools.extern.six.movesrrrrZ
pkg_resourcesrrrBrZ�__all__�striprrrEr/r:�AttributeError�objectr
r
rZbackports.ssl_match_hostnamer'r&rr2rrOr\r	rarrrr�<module>sZ
�

4)
(
	

site-packages/setuptools/__pycache__/unicode_utils.cpython-38.pyc000064400000002177151446177000021227 0ustar00U

�Qab��@s8ddlZddlZddlmZdd�Zdd�Zdd�ZdS)	�N)�sixcCsVt|tj�rt�d|�Sz$|�d�}t�d|�}|�d�}Wntk
rPYnX|S)NZNFD�utf-8)�
isinstancer�	text_type�unicodedataZ	normalize�decode�encode�UnicodeError)�path�r�</usr/lib/python3.8/site-packages/setuptools/unicode_utils.py�	decomposes
r
c	Cs\t|tj�r|St��pd}|df}|D].}z|�|�WStk
rTYq(Yq(Xq(dS)zY
    Ensure that the given path is decoded,
    NONE when no expected encoding works
    rN)rrr�sys�getfilesystemencodingr�UnicodeDecodeError)r
Zfs_encZ
candidates�encrrr�filesys_decodesrcCs(z|�|�WStk
r"YdSXdS)z/turn unicode encoding into a functional routineN)r�UnicodeEncodeError)�stringrrrr�
try_encode'sr)rrZsetuptools.externrr
rrrrrr�<module>s
site-packages/setuptools/__pycache__/py34compat.cpython-38.opt-1.pyc000064400000000702151446177000021313 0ustar00U

�Qab��@sXddlZzddlZWnek
r(YnXzejjZWnek
rRdd�ZYnXdS)�NcCs|j�|j�S)N)�loader�load_module�name)�spec�r�9/usr/lib/python3.8/site-packages/setuptools/py34compat.py�module_from_specsr)�	importlib�importlib.util�ImportError�utilr�AttributeErrorrrrr�<module>ssite-packages/setuptools/__pycache__/py27compat.cpython-38.pyc000064400000003325151446177000020362 0ustar00U

�Qab��@s�dZddlZddlZddlmZdd�Zejr6dd�Ze��dkoFejZerPe	ndd	�Z
z,d
dlmZm
Z
mZmZd
dlmZmZWnJek
r�ddlZdd
lm
Z
mZmZddd�Zdd�Zdd�ZYnXdS)z2
Compatibility Support for Python 2.7 and earlier
�N)�sixcCs
|�|�S)zH
    Given an HTTPMessage, return all headers matching a given key.
    )Zget_all��message�key�r�9/usr/lib/python3.8/site-packages/setuptools/py27compat.py�get_all_headerssrcCs
|�|�S�N)Z
getheadersrrrrrsZLinuxcCs|Sr	r)�xrrr�<lambda>�r�)�find_module�PY_COMPILED�	PY_FROZEN�	PY_SOURCE)�get_frozen_object�
get_module)rrrc
Csj|�d�}|rf|�d�}t�||�\}}\}}}}	|tjkrP|pFdg}|g}q
|r
td||f��q
|	S)z7Just like 'imp.find_module()', but with package support�.r�__init__zCan't find %r in %s)�split�pop�imprZ
PKG_DIRECTORY�ImportError)
�module�paths�parts�part�f�path�suffix�modeZkind�inforrrr's



rcCs
t�|�Sr	)rr)rrrrrr7srcCstj|f|��tj|Sr	)r�load_module�sys�modules)rrr"rrrr:sr)N)�__doc__r$�platformZsetuptools.externrrZPY2�systemZlinux_py2_ascii�strZrmtree_safe�_imprrrrrrrrrrrr�<module>s&�
site-packages/setuptools/__pycache__/sandbox.cpython-38.pyc000064400000036260151446177000020017 0ustar00U

�Qab�7�@s
ddlZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
mZddlm
Z
mZddlZej�d�r�ddlmmmmZnejejZzeZWnek
r�dZYnXeZddlm Z ddlm!Z!ddd	d
gZ"d-dd�Z#ej$d.d
d��Z%ej$dd��Z&ej$dd��Z'ej$dd��Z(Gdd�de)�Z*Gdd�d�Z+ej$dd��Z,dd�Z-ej$dd��Z.ej$dd ��Z/d!d"�Z0d#d$�Z1d%d
�Z2Gd&d�d�Z3e4ed'��r�ej5gZ6ngZ6Gd(d�de3�Z7e�8ej9d)d*�d+�:�D��Z;Gd,d	�d	e �Z<dS)/�N)�six)�builtins�map�java)�DistutilsError)�working_set�AbstractSandbox�DirectorySandbox�SandboxViolation�	run_setupc	CsJd}t||��}|��}W5QRX|dkr.|}t||d�}t|||�dS)z.
    Python 3 implementation of execfile.
    �rbN�exec)�open�read�compiler
)�filename�globals�locals�mode�streamZscript�code�r�6/usr/lib/python3.8/site-packages/setuptools/sandbox.py�	_execfile#src
csDtjdd�}|dk	r$|tjdd�<z
|VW5|tjdd�<XdS�N)�sys�argv)�repl�savedrrr�	save_argv0s
rc
cs.tjdd�}z
|VW5|tjdd�<XdSr)r�path�rrrr�	save_path;s
r"ccs4tjj|dd�tj}|t_z
dVW5|t_XdS)zL
    Monkey-patch tempfile.tempdir with replacement, ensuring it exists
    T)�exist_okN)�
pkg_resourcesZ
py31compat�makedirs�tempfileZtempdir)Zreplacementrrrr�
override_tempDs
r'c	cs.t��}t�|�z
|VW5t�|�XdSr)�os�getcwd�chdir)�targetrrrr�pushdUs


r,c@seZdZdZedd��ZdS)�UnpickleableExceptionzP
    An exception representing another Exception that could not be pickled.
    c	CsPzt�|�t�|�fWStk
rJddlm}|�||t|���YSXdS)z�
        Always return a dumped (pickled) type and exc. If exc can't be pickled,
        wrap it in UnpickleableException first.
        r)r-N)�pickle�dumps�	Exception�setuptools.sandboxr-�dump�repr)�type�exc�clsrrrr2ds
zUnpickleableException.dumpN)�__name__�
__module__�__qualname__�__doc__�staticmethodr2rrrrr-_sr-c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�ExceptionSaverz^
    A Context Manager that will save an exception, serialized, and restore it
    later.
    cCs|Srr��selfrrr�	__enter__xszExceptionSaver.__enter__cCs |sdSt�||�|_||_dS�NT)r-r2�_saved�_tb)r>r4r5�tbrrr�__exit__{s
zExceptionSaver.__exit__cCs6dt|�krdSttj|j�\}}t�|||j�dS)z"restore and re-raise any exceptionrAN)�varsrr.�loadsrArZreraiserB)r>r4r5rrr�resume�szExceptionSaver.resumeN)r7r8r9r:r?rDrGrrrrr<rsr<c	#sVtj���t��}�VW5QRXtj����fdd�tjD�}t|�|��dS)z�
    Context in which imported modules are saved.

    Translates exceptions internal to the context into the equivalent exception
    outside the context.
    c3s$|]}|�kr|�d�s|VqdS)z
encodings.N��
startswith)�.0�mod_namer!rr�	<genexpr>�s
�zsave_modules.<locals>.<genexpr>N)r�modules�copyr<�update�_clear_modulesrG)�	saved_excZdel_modulesrr!r�save_modules�s

�rRcCst|�D]}tj|=qdSr)�listrrM)Zmodule_namesrKrrrrP�srPc	cs$t��}z
|VW5t�|�XdSr)r$�__getstate__�__setstate__r!rrr�save_pkg_resources_state�s
rVccs�tj�|d�}t��xt��ft�t��Nt��<t|��(t	|��t
d�dVW5QRXW5QRXW5QRXW5QRXW5QRXW5QRXdS)NZtempZ
setuptools)r(r �joinrVrR�hide_setuptoolsr"rr'r,�
__import__)�	setup_dirZtemp_dirrrr�
setup_context�s

r[cCst�d�}t|�|��S)aH
    >>> _needs_hiding('setuptools')
    True
    >>> _needs_hiding('pkg_resources')
    True
    >>> _needs_hiding('setuptools_plugin')
    False
    >>> _needs_hiding('setuptools.__init__')
    True
    >>> _needs_hiding('distutils')
    True
    >>> _needs_hiding('os')
    False
    >>> _needs_hiding('Cython')
    True
    z1(setuptools|pkg_resources|distutils|Cython)(\.|$))�rer�bool�match)rK�patternrrr�
_needs_hiding�s
r`cCstttj�}t|�dS)a%
    Remove references to setuptools' modules from sys.modules to allow the
    invocation to import the most appropriate setuptools. This technique is
    necessary to avoid issues such as #315 where setuptools upgrading itself
    would fail to find a function declared in the metadata.
    N)�filterr`rrMrP)rMrrrrX�srXcCs�tj�tj�|��}t|���z�|gt|�tjdd�<tj�d|�t	�
�t	j�dd��t
|t�rl|n|�t���}t|��t|dd�}t||�W5QRXWn4tk
r�}z|jr�|jdrʂW5d}~XYnXW5QRXdS)z8Run a distutils setup script, sandboxed in its directoryNrcSs|��Sr)Zactivate)Zdistrrr�<lambda>��zrun_setup.<locals>.<lambda>�__main__)�__file__r7)r(r �abspath�dirnamer[rSrr�insertr�__init__Z	callbacks�append�
isinstance�str�encode�getfilesystemencodingr	�dictr�
SystemExit�args)Zsetup_scriptrqrZZdunder_file�ns�vrrrr�s"
��
c@seZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dD]Zee
e�rDe
e�e�e<qDd$dd�Zerzede�Zede�ZdD]Zee
e�r�ee�e�e<q�dd�ZdD]Zee
e�r�ee�e�e<q�dd�ZdD]Zee
e�r�ee�e�e<q�dd�Zdd�Zd d!�Zd"d#�ZdS)%rzDWrap 'os' module and 'open()' builtin for virtualizing setup scriptsFcs�fdd�tt�D��_dS)Ncs$g|]}|�d�st�|�r|�qS)�_)rI�hasattr)rJ�namer=rr�
<listcomp>s

�z,AbstractSandbox.__init__.<locals>.<listcomp>)�dir�_os�_attrsr=rr=rris
�zAbstractSandbox.__init__cCs"|jD]}tt|t||��qdSr)rz�setattrr(�getattr)r>�sourcervrrr�_copys
zAbstractSandbox._copycCs(|�|�tr|jt_|jt_d|_dSr@)r~�_filer�file�_openr�_activer=rrrr?s

zAbstractSandbox.__enter__cCs$d|_trtt_tt_|�t�dS�NF)r�rrr�r�rr~ry)r>�exc_type�	exc_value�	tracebackrrrrDs
zAbstractSandbox.__exit__c
Cs"|�|�W5QR�SQRXdS)zRun 'func' under os sandboxingNr)r>�funcrrr�runszAbstractSandbox.runcstt�����fdd�}|S)Ncs2|jr |j�||f|�|�\}}�||f|�|�Sr)r��_remap_pair)r>�src�dstrq�kw�rv�originalrr�wrap&sz3AbstractSandbox._mk_dual_path_wrapper.<locals>.wrap�r|ry�rvr�rr�r�_mk_dual_path_wrapper#s
z%AbstractSandbox._mk_dual_path_wrapper)�rename�link�symlinkNcs �ptt�����fdd�}|S)Ncs*|jr|j�|f|�|�}�|f|�|�Sr)r��_remap_input�r>r rqr�r�rrr�4sz5AbstractSandbox._mk_single_path_wrapper.<locals>.wrapr�)rvr�r�rr�r�_mk_single_path_wrapper1sz'AbstractSandbox._mk_single_path_wrapperr�r)�stat�listdirr*r�chmod�chown�mkdir�remove�unlink�rmdir�utime�lchown�chroot�lstatZ	startfile�mkfifo�mknod�pathconf�accesscstt�����fdd�}|S)NcsB|jr2|j�|f|�|�}|���|f|�|��S�|f|�|�Sr)r�r��
_remap_outputr�r�rrr�Isz4AbstractSandbox._mk_single_with_return.<locals>.wrapr�r�rr�r�_mk_single_with_returnFs
z&AbstractSandbox._mk_single_with_return)�readlink�tempnamcstt�����fdd�}|S)Ncs �||�}|jr|��|�S|Sr)r�r�)r>rqr�Zretvalr�rrr�Xs
z'AbstractSandbox._mk_query.<locals>.wrapr�r�rr�r�	_mk_queryUs
zAbstractSandbox._mk_query)r)�tmpnamcCs|S)z=Called to remap or validate any path, whether input or outputr)r>r rrr�_validate_pathdszAbstractSandbox._validate_pathcOs
|�|�S�zCalled for path inputs�r��r>�	operationr rqr�rrrr�hszAbstractSandbox._remap_inputcCs
|�|�S)zCalled for path outputsr�)r>r�r rrrr�lszAbstractSandbox._remap_outputcOs0|j|d|f|�|�|j|d|f|�|�fS)�?Called for path pairs like rename, link, and symlink operationsz-fromz-to)r��r>r�r�r�rqr�rrrr�ps�zAbstractSandbox._remap_pair)N)r7r8r9r:r�rir~r?rDr�r�rvruryrr�rr�r�r�r�r�r�r�rrrrrs<








�devnullc@s�eZdZdZe�dddddddd	d
ddd
dg
�ZdgZefdd�Z	dd�Z
erXd'dd�Zd(dd�Zdd�Z
dd�Zdd�Zdd �Zd!d"�Zd)d$d%�Zd&S)*r	z<Restrict operations to a single subdirectory - pseudo-chrootrr�r�r�r�r�r�r�r�r�r�r�r�z.*lib2to3.*\.pickle$cCsFtj�tj�|��|_tj�|jd�|_dd�|D�|_t�	|�dS)N�cSs g|]}tj�tj�|���qSr)r(r �normcase�realpath)rJr rrrrw�s�z-DirectorySandbox.__init__.<locals>.<listcomp>)
r(r r�r��_sandboxrW�_prefix�_exceptionsrri)r>Zsandbox�
exceptionsrrrri�s�zDirectorySandbox.__init__cOsddlm}||||��dS)Nr)r
)r1r
)r>r�rqr�r
rrr�
_violation�szDirectorySandbox._violation�rcOs:|dkr(|�|�s(|jd||f|�|�t||f|�|�S)N�r�ZrtrZrU�Ur�)�_okr�r�r>r rrqr�rrrr�szDirectorySandbox._filecOs:|dkr(|�|�s(|jd||f|�|�t||f|�|�S)Nr�r)r�r�r�r�rrrr��szDirectorySandbox._opencCs|�d�dS)Nr�)r�r=rrrr��szDirectorySandbox.tmpnamcCsR|j}z>d|_tj�tj�|��}|�|�p@||jkp@|�|j�W�S||_XdSr�)	r�r(r r�r��	_exemptedr�rIr�)r>r Zactiver�rrrr��s
�
�zDirectorySandbox._okcs<�fdd�|jD�}�fdd�|jD�}t�||�}t|�S)Nc3s|]}��|�VqdSrrH)rJZ	exception��filepathrrrL�s�z-DirectorySandbox._exempted.<locals>.<genexpr>c3s|]}t�|��VqdSr)r\r^)rJr_r�rrrL�s�)r��_exception_patterns�	itertools�chain�any)r>r�Z
start_matchesZpattern_matchesZ
candidatesrr�rr��s
�
�zDirectorySandbox._exemptedcOs4||jkr0|�|�s0|j|tj�|�f|�|�|Sr�)�	write_opsr�r�r(r r�r�rrrr��szDirectorySandbox._remap_inputcOs2|�|�r|�|�s*|j|||f|�|�||fS)r�)r�r�r�rrrr��szDirectorySandbox._remap_pair�cOs@|t@r*|�|�s*|jd|||f|�|�tj|||f|�|�S)zCalled for low-level os.open()zos.open)�WRITE_FLAGSr�r�ryr)r>r��flagsrrqr�rrrr�szDirectorySandbox.openN)r�)r�)r�)r7r8r9r:ro�fromkeysr�r��_EXCEPTIONSrir�rr�r�r�r�r�r�rrrrrr	~s:��	


cCsg|]}tt|d��qS)rr�)rJ�arrrrw�srwz4O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARYc@s&eZdZdZe�d���Zdd�ZdS)r
zEA setup script attempted to modify the filesystem outside the sandboxa
        SandboxViolation: {cmd}{args!r} {kwargs}

        The package setup script has attempted to modify files on your system
        that are not within the EasyInstall build area, and has been aborted.

        This package cannot be safely installed by EasyInstall, and may not
        support alternate installation locations even if you run its setup
        script by hand.  Please inform the package's author and the EasyInstall
        maintainers to find out if a fix or workaround is available.
        cCs|j\}}}|jjft��Sr)rq�tmpl�formatr)r>�cmdrq�kwargsrrr�__str__�szSandboxViolation.__str__N)	r7r8r9r:�textwrap�dedent�lstripr�r�rrrrr
�s)N)N)=r(rr&�operator�	functoolsr�r\�
contextlibr.r�Zsetuptools.externrZsetuptools.extern.six.movesrrZpkg_resources.py31compatr$�platformrIZ$org.python.modules.posix.PosixModule�pythonrM�posixZPosixModuleryrvr�r�	NameErrorrr�Zdistutils.errorsrr�__all__r�contextmanagerrr"r'r,r0r-r<rRrPrVr[r`rXrrrur�r�r	�reduce�or_�splitr�r
rrrr�<module>sx 
�





	


w
V��site-packages/setuptools/__pycache__/namespaces.cpython-38.pyc000064400000007040151446177000020472 0ustar00U

�Qab�@sRddlZddlmZddlZddlmZejjZGdd�d�Z	Gdd�de	�Z
dS)�N)�log)�mapc@sTeZdZdZdd�Zdd�Zdd�ZdZd	Zd
d�Z	dd
�Z
dd�Zedd��Z
dS)�	Installerz
-nspkg.pthc	Cs�|��}|sdStj�|���\}}||j7}|j�|�t�	d|�t
|j|�}|jrdt
|�dSt|d��}|�|�W5QRXdS)Nz
Installing %sZwt)�_get_all_ns_packages�os�path�splitext�_get_target�	nspkg_extZoutputs�appendr�infor�_gen_nspkg_lineZdry_run�list�open�
writelines)�selfZnsp�filename�ext�lines�f�r�9/usr/lib/python3.8/site-packages/setuptools/namespaces.py�install_namespacess
zInstaller.install_namespacescCsHtj�|���\}}||j7}tj�|�s.dSt�d|�t�|�dS)NzRemoving %s)	rrrr	r
�existsrr�remove)rrrrrr�uninstall_namespaces!s
zInstaller.uninstall_namespacescCs|jS�N)�target�rrrrr	)szInstaller._get_target)	zimport sys, types, osz#has_mfs = sys.version_info > (3, 5)z$p = os.path.join(%(root)s, *%(pth)r)z4importlib = has_mfs and __import__('importlib.util')z-has_mfs and __import__('importlib.machinery')z�m = has_mfs and sys.modules.setdefault(%(pkg)r, importlib.util.module_from_spec(importlib.machinery.PathFinder.find_spec(%(pkg)r, [os.path.dirname(p)])))zCm = m or sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))z7mp = (m or []) and m.__dict__.setdefault('__path__',[])z(p not in mp) and mp.append(p))z4m and setattr(sys.modules[%(parent)r], %(child)r, m)cCsdS)Nz$sys._getframe(1).f_locals['sitedir']rrrrr�	_get_rootCszInstaller._get_rootcCsVt|�}t|�d��}|��}|j}|�d�\}}}|rB||j7}d�|�t�dS)N�.�;�
)	�str�tuple�splitr�_nspkg_tmpl�
rpartition�_nspkg_tmpl_multi�join�locals)r�pkgZpth�rootZ
tmpl_lines�parent�sepZchildrrrr
Fs
zInstaller._gen_nspkg_linecCs |jjp
g}ttt|j|���S)z,Return sorted list of all package namespaces)ZdistributionZnamespace_packages�sorted�flattenr�
_pkg_names)rZpkgsrrrrQszInstaller._get_all_ns_packagesccs(|�d�}|r$d�|�V|��q
dS)z�
        Given a namespace package, yield the components of that
        package.

        >>> names = Installer._pkg_names('a.b.c')
        >>> set(names) == set(['a', 'a.b', 'a.b.c'])
        True
        r N)r%r)�pop)r+�partsrrrr1Vs

zInstaller._pkg_namesN)�__name__�
__module__�__qualname__r
rrr	r&r(rr
r�staticmethodr1rrrrrsrc@seZdZdd�Zdd�ZdS)�DevelopInstallercCstt|j��Sr)�reprr#Zegg_pathrrrrrgszDevelopInstaller._get_rootcCs|jSr)Zegg_linkrrrrr	jszDevelopInstaller._get_targetN)r4r5r6rr	rrrrr8fsr8)rZ	distutilsr�	itertoolsZsetuptools.extern.six.movesr�chain�
from_iterabler0rr8rrrr�<module>s[site-packages/setuptools/__pycache__/namespaces.cpython-38.opt-1.pyc000064400000007040151446177000021431 0ustar00U

�Qab�@sRddlZddlmZddlZddlmZejjZGdd�d�Z	Gdd�de	�Z
dS)�N)�log)�mapc@sTeZdZdZdd�Zdd�Zdd�ZdZd	Zd
d�Z	dd
�Z
dd�Zedd��Z
dS)�	Installerz
-nspkg.pthc	Cs�|��}|sdStj�|���\}}||j7}|j�|�t�	d|�t
|j|�}|jrdt
|�dSt|d��}|�|�W5QRXdS)Nz
Installing %sZwt)�_get_all_ns_packages�os�path�splitext�_get_target�	nspkg_extZoutputs�appendr�infor�_gen_nspkg_lineZdry_run�list�open�
writelines)�selfZnsp�filename�ext�lines�f�r�9/usr/lib/python3.8/site-packages/setuptools/namespaces.py�install_namespacess
zInstaller.install_namespacescCsHtj�|���\}}||j7}tj�|�s.dSt�d|�t�|�dS)NzRemoving %s)	rrrr	r
�existsrr�remove)rrrrrr�uninstall_namespaces!s
zInstaller.uninstall_namespacescCs|jS�N)�target�rrrrr	)szInstaller._get_target)	zimport sys, types, osz#has_mfs = sys.version_info > (3, 5)z$p = os.path.join(%(root)s, *%(pth)r)z4importlib = has_mfs and __import__('importlib.util')z-has_mfs and __import__('importlib.machinery')z�m = has_mfs and sys.modules.setdefault(%(pkg)r, importlib.util.module_from_spec(importlib.machinery.PathFinder.find_spec(%(pkg)r, [os.path.dirname(p)])))zCm = m or sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))z7mp = (m or []) and m.__dict__.setdefault('__path__',[])z(p not in mp) and mp.append(p))z4m and setattr(sys.modules[%(parent)r], %(child)r, m)cCsdS)Nz$sys._getframe(1).f_locals['sitedir']rrrrr�	_get_rootCszInstaller._get_rootcCsVt|�}t|�d��}|��}|j}|�d�\}}}|rB||j7}d�|�t�dS)N�.�;�
)	�str�tuple�splitr�_nspkg_tmpl�
rpartition�_nspkg_tmpl_multi�join�locals)r�pkgZpth�rootZ
tmpl_lines�parent�sepZchildrrrr
Fs
zInstaller._gen_nspkg_linecCs |jjp
g}ttt|j|���S)z,Return sorted list of all package namespaces)ZdistributionZnamespace_packages�sorted�flattenr�
_pkg_names)rZpkgsrrrrQszInstaller._get_all_ns_packagesccs(|�d�}|r$d�|�V|��q
dS)z�
        Given a namespace package, yield the components of that
        package.

        >>> names = Installer._pkg_names('a.b.c')
        >>> set(names) == set(['a', 'a.b', 'a.b.c'])
        True
        r N)r%r)�pop)r+�partsrrrr1Vs

zInstaller._pkg_namesN)�__name__�
__module__�__qualname__r
rrr	r&r(rr
r�staticmethodr1rrrrrsrc@seZdZdd�Zdd�ZdS)�DevelopInstallercCstt|j��Sr)�reprr#Zegg_pathrrrrrgszDevelopInstaller._get_rootcCs|jSr)Zegg_linkrrrrr	jszDevelopInstaller._get_targetN)r4r5r6rr	rrrrr8fsr8)rZ	distutilsr�	itertoolsZsetuptools.extern.six.movesr�chain�
from_iterabler0rr8rrrr�<module>s[site-packages/setuptools/__pycache__/monkey.cpython-38.opt-1.pyc000064400000011044151446177000020613 0ustar00U

�Qab��@s�dZddlZddlZddlZddlZddlZddlmZddl	Z	ddl
mZddlZgZ
dd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Zdd�Zdd�ZdS)z
Monkey patching of distutils.
�N)�
import_module)�sixcCs"t��dkr|f|jSt�|�S)am
    Returns the bases classes for cls sorted by the MRO.

    Works around an issue on Jython where inspect.getmro will not return all
    base classes if multiple classes share the same name. Instead, this
    function will return a tuple containing the class itself, and the contents
    of cls.__bases__. See https://github.com/pypa/setuptools/issues/1024.
    ZJython)�platformZpython_implementation�	__bases__�inspectZgetmro)�cls�r�5/usr/lib/python3.8/site-packages/setuptools/monkey.py�_get_mros	r
cCs0t|tj�rtnt|tj�r tndd�}||�S)NcSsdS)Nr)�itemrrr	�<lambda>*�zget_unpatched.<locals>.<lambda>)�
isinstancerZclass_types�get_unpatched_class�types�FunctionType�get_unpatched_function)r�lookuprrr	�
get_unpatched&s
�rcCs:dd�t|�D�}t|�}|j�d�s6d|}t|��|S)z�Protect against re-patching the distutils if reloaded

    Also ensures that no other distutils extension monkeypatched the distutils
    first.
    css|]}|j�d�s|VqdS)�
setuptoolsN)�
__module__�
startswith)�.0rrrr	�	<genexpr>5s�z&get_unpatched_class.<locals>.<genexpr>�	distutilsz(distutils has already been patched by %r)r
�nextrr�AssertionError)rZexternal_bases�base�msgrrr	r/s�rcCs�tjtj_tjdk}|r"tjtj_tjdkp^dtjko@dknp^dtjkoZdkn}|rrd}|tjj	_
t�tjtjtj
fD]}tjj|_q�tjjtj_tjjtj_dtjkr�tjjtjd_t�dS)N)��r)���
)r�)rr$�)rr zhttps://upload.pypi.org/legacy/zdistutils.command.build_ext)rZCommandrZcore�sys�version_info�findallZfilelistZconfigZ
PyPIRCCommandZDEFAULT_REPOSITORY�_patch_distribution_metadata�dist�cmdZDistribution�	extensionZ	Extension�modules�#patch_for_msvc_specialized_compiler)Zhas_issue_12885Zneeds_warehouseZ	warehouse�modulerrr	�	patch_allAs*



��

�
r0cCs*dD] }ttj|�}ttjj||�qdS)zDPatch write_pkg_file and read_pkg_file for higher metadata standards)Zwrite_pkg_fileZ
read_pkg_fileZget_metadata_versionN)�getattrrr*�setattrrZDistributionMetadata)�attrZnew_valrrr	r)hsr)cCs*t||�}t|��d|�t|||�dS)z�
    Patch func_name in target_mod with replacement

    Important - original must be resolved by name to avoid
    patching an already patched function.
    �	unpatchedN)r1�vars�
setdefaultr2)ZreplacementZ
target_mod�	func_name�originalrrr	�
patch_funcos
r9cCs
t|d�S)Nr4)r1)�	candidaterrr	r�srcs�td��t��dkrdS�fdd�}t�|d�}t�|d�}zt|d��t|d	��Wntk
rlYnXzt|d
��Wntk
r�YnXzt|d��Wntk
r�YnXdS)z\
    Patch functions in distutils to use standalone Microsoft Visual C++
    compilers.
    zsetuptools.msvcZWindowsNcsLd|krdnd}||�d�}t�|�}t|�}t||�sBt|��|||fS)zT
        Prepare the parameters for patch_func to patch indicated function.
        �msvc9Zmsvc9_Zmsvc14_�_)�lstripr1r�hasattr�ImportError)Zmod_namer7Zrepl_prefixZ	repl_name�repl�mod�Zmsvcrr	�patch_params�s

z9patch_for_msvc_specialized_compiler.<locals>.patch_paramszdistutils.msvc9compilerzdistutils._msvccompilerZfind_vcvarsallZquery_vcvarsallZ_get_vc_envZgen_lib_options)rr�system�	functools�partialr9r?)rCr;Zmsvc14rrBr	r.�s&
r.)�__doc__r&Zdistutils.filelistrrrrE�	importlibrrZsetuptools.externrr�__all__r
rrr0r)r9rr.rrrr	�<module>s$	'site-packages/setuptools/__pycache__/build_meta.cpython-38.pyc000064400000020457151446177000020467 0ustar00U

�Qab}%�@sdZddlZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZddl
mZdddd	d
ddgZGd
d�de�ZGdd�dejj�Zdd�Zdd�Zdd�Zdd�ZGdd�de�ZGdd�de�Ze�ZejZejZejZejZej Z e�Z!dS)a-A PEP 517 interface to setuptools

Previously, when a user or a command line tool (let's call it a "frontend")
needed to make a request of setuptools to take a certain action, for
example, generating a list of installation requirements, the frontend would
would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line.

PEP 517 defines a different method of interfacing with setuptools. Rather
than calling "setup.py" directly, the frontend should:

  1. Set the current directory to the directory with a setup.py file
  2. Import this module into a safe python interpreter (one in which
     setuptools can potentially set global variables or crash hard).
  3. Call one of the functions defined in PEP 517.

What each function does is defined in PEP 517. However, here is a "casual"
definition of the functions (this definition should not be relied on for
bug reports or API stability):

  - `build_wheel`: build a wheel in the folder and return the basename
  - `get_requires_for_build_wheel`: get the `setup_requires` to build
  - `prepare_metadata_for_build_wheel`: get the `install_requires`
  - `build_sdist`: build an sdist in the folder and return the basename
  - `get_requires_for_build_sdist`: get the `setup_requires` to build

Again, this is not a formal definition! Just a "taste" of the module.
�N)�TemporaryDirectory)�parse_requirements)�makedirs�get_requires_for_build_sdist�get_requires_for_build_wheel� prepare_metadata_for_build_wheel�build_wheel�build_sdist�
__legacy__�SetupRequirementsErrorc@seZdZdd�ZdS)rcCs
||_dS�N)�
specifiers)�selfr
�r�9/usr/lib/python3.8/site-packages/setuptools/build_meta.py�__init__4szSetupRequirementsError.__init__N)�__name__�
__module__�__qualname__rrrrrr3sc@s&eZdZdd�Zeejdd���ZdS)�DistributioncCstttt|���}t|��dSr)�list�map�strrr)rr
Zspecifier_listrrr�fetch_build_eggs9szDistribution.fetch_build_eggsccs*tjj}|tj_z
dVW5|tj_XdS)zw
        Replace
        distutils.dist.Distribution with this class
        for the duration of this context.
        N)�	distutilsZcorer)�clsZorigrrr�patch>s

zDistribution.patchN)rrrr�classmethod�
contextlib�contextmanagerrrrrrr8srcCs*tjddkr&t|t�s&|�t���S|S)z�
    Convert a filename to a string (on Python 2, explicitly
    a byte string, not Unicode) as distutils checks for the
    exact type str.
    r�)�sys�version_info�
isinstancer�encode�getfilesystemencoding)�srrr�_to_strNsr'cs�fdd�t���D�S)Ncs&g|]}tj�tj��|��r|�qSr)�os�path�isdir�join)�.0�name�Za_dirrr�
<listcomp>\s�z1_get_immediate_subdirectories.<locals>.<listcomp>�r(�listdirr.rr.r�_get_immediate_subdirectories[sr2cs"�fdd�t�|�D�}|\}|S)Nc3s|]}|���r|VqdSr��endswith�r,�f��	extensionrr�	<genexpr>as
�z'_file_with_extension.<locals>.<genexpr>r0)Z	directoryr8Zmatching�filerr7r�_file_with_extension`s

�r;cCs&tj�|�st�d�Sttdt�|�S)Nz%from setuptools import setup; setup()�open)r(r)�exists�io�StringIO�getattr�tokenizer<��setup_scriptrrr�_open_setup_scriptis
rDc@s`eZdZdd�Zdd�Zddd�Zdd	d
�Zddd�Zdd
d�Zdd�Z	ddd�Z
ddd�ZdS)�_BuildMetaBackendcCs|pi}|�dg�|S)N�--global-option)�
setdefault�r�config_settingsrrr�_fix_configssz_BuildMetaBackend._fix_configc
Csz|�|�}tjdd�dg|dt_z t���|��W5QRXWn,tk
rt}z||j7}W5d}~XYnX|S)N�Zegg_inforF)rJr!�argvrr�	run_setuprr
)rrI�requirements�errr�_get_build_requiresxs
�
z%_BuildMetaBackend._get_build_requires�setup.pyc	CsD|}d}t|��}|���dd�}W5QRXtt||d�t��dS)N�__main__z\r\nz\n�exec)rD�read�replacerS�compile�locals)rrC�__file__rr6�coderrrrM�s

z_BuildMetaBackend.run_setupNcCs|�|�}|j|dgd�S)NZwheel�rN�rJrPrHrrrr�s
z._BuildMetaBackend.get_requires_for_build_wheelcCs|�|�}|j|gd�S)NrZr[rHrrrr�s
z._BuildMetaBackend.get_requires_for_build_sdistcCs�tjdd�ddt|�gt_|��|}dd�t�|�D�}t|�dkrttt|��dkrttj�	|t�|�d�}q*t|�dks�t
�q�q*||kr�t�tj�	||d�|�tj
|dd�|dS)	NrKZ	dist_infoz
--egg-basecSsg|]}|�d�r|�qS)z
.dist-infor3r5rrrr/�s
�zF_BuildMetaBackend.prepare_metadata_for_build_wheel.<locals>.<listcomp>rT)�
ignore_errors)r!rLr'rMr(r1�lenr2r)r+�AssertionError�shutilZmoveZrmtree)r�metadata_directoryrIZdist_info_directoryZ
dist_infosrrrr�s.����z2_BuildMetaBackend.prepare_metadata_for_build_wheelc	Cs�|�|�}tj�|�}t|dd�t|d��v}tjdd�|d|g|dt_|��t	||�}tj�
||�}tj�|�r�t�|�t�
tj�
||�|�W5QRX|S)NT)�exist_ok)�dirrKz
--dist-dirrF)rJr(r)�abspathrrr!rLrMr;r+r=�remove�rename)rZ
setup_commandZresult_extensionZresult_directoryrIZtmp_dist_dirZresult_basenameZresult_pathrrr�_build_with_temp_dir�s 
��

 z&_BuildMetaBackend._build_with_temp_dircCs|�dgd||�S)NZbdist_wheelz.whl�rf)rZwheel_directoryrIr`rrrr�s
�z_BuildMetaBackend.build_wheelcCs|�dddgd||�S)NZsdistz	--formatsZgztarz.tar.gzrg)rZsdist_directoryrIrrrr	�s
�z_BuildMetaBackend.build_sdist)rQ)N)N)N)NN)N)rrrrJrPrMrrrrfrr	rrrrrEqs


�
�
rEcs"eZdZdZd�fdd�	Z�ZS)�_BuildMetaLegacyBackendaCCompatibility backend for setuptools

    This is a version of setuptools.build_meta that endeavors to maintain backwards
    compatibility with pre-PEP 517 modes of invocation. It exists as a temporary
    bridge between the old packaging mechanism and the new packaging mechanism,
    and will eventually be removed.
    rQc
sbttj�}tj�tj�|��}|tjkr6tj�d|�ztt|�j	|d�W5|tjdd�<XdS)NrrB)
rr!r)r(�dirnamerc�insert�superrhrM)rrCZsys_pathZ
script_dir��	__class__rrrM�s

��
z!_BuildMetaLegacyBackend.run_setup)rQ)rrr�__doc__rM�
__classcell__rrrlrrh�srh)"rnr>r(r!rAr_rZ
setuptoolsrZsetuptools.py31compatrZ
pkg_resourcesrZpkg_resources.py31compatr�__all__�
BaseExceptionrZdistrr'r2r;rD�objectrErhZ_BACKENDrrrrr	r
rrrr�<module>sD�
	hsite-packages/setuptools/__pycache__/archive_util.cpython-38.opt-1.pyc000064400000012010151446177000021761 0ustar00U

�Qab��@s�dZddlZddlZddlZddlZddlZddlZddlmZddl	m
Z
ddddd	d
dgZGdd	�d	e�Zd
d�Z
e
dfdd�Ze
fdd�Ze
fdd�Ze
fdd�ZeeefZdS)z/Utilities for extracting common archive formats�N)�DistutilsError)�ensure_directory�unpack_archive�unpack_zipfile�unpack_tarfile�default_filter�UnrecognizedFormat�extraction_drivers�unpack_directoryc@seZdZdZdS)rz#Couldn't recognize the archive typeN)�__name__�
__module__�__qualname__�__doc__�rr�;/usr/lib/python3.8/site-packages/setuptools/archive_util.pyrscCs|S)z@The default progress/filter callback; returns True for all filesr)�src�dstrrrrsc	CsN|ptD]4}z||||�Wntk
r4YqYqXdSqtd|��dS)a�Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``

    `progress_filter` is a function taking two arguments: a source path
    internal to the archive ('/'-separated), and a filesystem path where it
    will be extracted.  The callback must return the desired extract path
    (which may be the same as the one passed in), or else ``None`` to skip
    that file or directory.  The callback can thus be used to report on the
    progress of the extraction, as well as to filter the items extracted or
    alter their extraction paths.

    `drivers`, if supplied, must be a non-empty sequence of functions with the
    same signature as this function (minus the `drivers` argument), that raise
    ``UnrecognizedFormat`` if they do not support extracting the designated
    archive type.  The `drivers` are tried in sequence until one is found that
    does not raise an error, or until all are exhausted (in which case
    ``UnrecognizedFormat`` is raised).  If you do not supply a sequence of
    drivers, the module's ``extraction_drivers`` constant will be used, which
    means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that
    order.
    Nz!Not a recognized archive type: %s)r	r)�filename�extract_dir�progress_filterZdriversZdriverrrrrs
�cCs�tj�|�std|��|d|fi}t�|�D]�\}}}||\}}|D],}	||	dtj�||	�f|tj�||	�<qH|D]T}
tj�||
�}|||
|�}|s�qzt|�tj�||
�}
t�|
|�t�	|
|�qzq.dS)z�"Unpack" a directory, using the same interface as for archives

    Raises ``UnrecognizedFormat`` if `filename` is not a directory
    z%s is not a directory��/N)
�os�path�isdirr�walk�joinr�shutilZcopyfileZcopystat)rrr�paths�base�dirs�filesrr�d�f�targetrrrr
?s$�*c
Cs�t�|�std|f��t�|���}|��D]�}|j}|�d�s,d|�d�krPq,tj	j
|f|�d���}|||�}|sxq,|�d�r�t|�n4t|�|�
|j�}t|d��}|�|�W5QRX|jd?}	|	r,t�||	�q,W5QRXdS)z�Unpack zip `filename` to `extract_dir`

    Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined
    by ``zipfile.is_zipfile()``).  See ``unpack_archive()`` for an explanation
    of the `progress_filter` argument.
    z%s is not a zip filer�..�wb�N)�zipfileZ
is_zipfilerZZipFileZinfolistr�
startswith�splitrrr�endswithr�read�open�writeZ
external_attr�chmod)
rrr�z�info�namer$�datar#Zunix_attributesrrrrZs(




c

Csfzt�|�}Wn$tjk
r2td|f��YnXt�|���dd�|_|D�]�}|j}|�d�sPd|�	d�krPt
jj|f|�	d���}|dk	r�|�
�s�|��r�|j}|��r�t�|j�}t�||�}t�|�}|�|�}q�|dk	rP|���s�|��rP|||�}	|	rP|	�t
j��r"|	dd�}	z|�||	�WqPtjk
�rJYqPXqPW5QR�dSQRXdS)	z�Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir`

    Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined
    by ``tarfile.open()``).  See ``unpack_archive()`` for an explanation
    of the `progress_filter` argument.
    z/%s is not a compressed or uncompressed tar filecWsdS)Nr)�argsrrr�<lambda>��z unpack_tarfile.<locals>.<lambda>rr%N���T)�tarfiler-ZTarErrorr�
contextlib�closing�chownr2r)r*rrrZislnkZissymZlinkname�	posixpath�dirname�normpathZ
_getmember�isfilerr+�sepZ_extract_memberZExtractError)
rrrZtarobj�memberr2Z
prelim_dstZlinkpathrZ	final_dstrrrrs:�




)rr(r8rrr<r9Zdistutils.errorsrZ
pkg_resourcesr�__all__rrrr
rrr	rrrr�<module>s2��
#%.site-packages/setuptools/__pycache__/site-patch.cpython-38.pyc000064400000002702151446177000020414 0ustar00U

�Qab��@sdd�Zedkre�[dS)c	Cs
ddl}ddl}|j�d�}|dks2|jdkr8|s8g}n|�|j�}t|di�}|jt	|�d�}|j�
t�}|D]�}||ksr|s�qr|�|�}|dk	r�|�d�}|dk	r�|�
d��q.qrz ddl}	|	�d|g�\}
}}Wntk
r�YqrYnX|
dkr�qrz|	�
d|
||�W5|
��X�q.qrtd��tdd�|jD��}
t|d	d�}d|_|D]}t|��qX|j|7_t|d�\}}d}g}|jD]b}t|�\}}||k�r�|dk�r�t	|�}||
k�s�|dk�r�|�|�n|�||�|d
7}�q�||jdd�<dS)N��
PYTHONPATHZwin32�path_importer_cache�sitez$Couldn't find the real 'site' modulecSsg|]}t|�ddf�qS)�)�makepath)�.0�item�r	�9/usr/lib/python3.8/site-packages/setuptools/site-patch.py�
<listcomp>)sz__boot.<locals>.<listcomp>�__egginsertr)�sys�os�environ�get�platform�split�pathsep�getattr�path�len�dirname�__file__�find_module�load_module�imp�ImportError�close�dictr�
addsitedirr�append�insert)r
rrZpicZstdpathZmydirrZimporter�loaderr�streamrZdescr�known_pathsZoldpos�dZndZ	insert_at�new_path�pZnpr	r	r
�__boots`





r(rN)r(�__name__r	r	r	r
�<module>sGsite-packages/setuptools/__pycache__/dep_util.cpython-38.opt-1.pyc000064400000001463151446177000021122 0ustar00U

�Qab��@sddlmZdd�ZdS)�)�newer_groupcCsht|�t|�krtd��g}g}tt|��D]2}t||||�r,|�||�|�||�q,||fS)z�Walk both arguments in parallel, testing if each source group is newer
    than its corresponding target. Returns a pair of lists (sources_groups,
    targets) where sources is newer than target, according to the semantics
    of 'newer_group()'.
    z5'sources_group' and 'targets' must be the same length)�len�
ValueError�ranger�append)Zsources_groupsZtargetsZ	n_sourcesZ	n_targets�i�r�7/usr/lib/python3.8/site-packages/setuptools/dep_util.py�newer_pairwise_groupsr
N)Zdistutils.dep_utilrr
rrrr	�<module>ssite-packages/setuptools/__pycache__/archive_util.cpython-38.pyc000064400000012010151446177000021022 0ustar00U

�Qab��@s�dZddlZddlZddlZddlZddlZddlZddlmZddl	m
Z
ddddd	d
dgZGdd	�d	e�Zd
d�Z
e
dfdd�Ze
fdd�Ze
fdd�Ze
fdd�ZeeefZdS)z/Utilities for extracting common archive formats�N)�DistutilsError)�ensure_directory�unpack_archive�unpack_zipfile�unpack_tarfile�default_filter�UnrecognizedFormat�extraction_drivers�unpack_directoryc@seZdZdZdS)rz#Couldn't recognize the archive typeN)�__name__�
__module__�__qualname__�__doc__�rr�;/usr/lib/python3.8/site-packages/setuptools/archive_util.pyrscCs|S)z@The default progress/filter callback; returns True for all filesr)�src�dstrrrrsc	CsN|ptD]4}z||||�Wntk
r4YqYqXdSqtd|��dS)a�Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``

    `progress_filter` is a function taking two arguments: a source path
    internal to the archive ('/'-separated), and a filesystem path where it
    will be extracted.  The callback must return the desired extract path
    (which may be the same as the one passed in), or else ``None`` to skip
    that file or directory.  The callback can thus be used to report on the
    progress of the extraction, as well as to filter the items extracted or
    alter their extraction paths.

    `drivers`, if supplied, must be a non-empty sequence of functions with the
    same signature as this function (minus the `drivers` argument), that raise
    ``UnrecognizedFormat`` if they do not support extracting the designated
    archive type.  The `drivers` are tried in sequence until one is found that
    does not raise an error, or until all are exhausted (in which case
    ``UnrecognizedFormat`` is raised).  If you do not supply a sequence of
    drivers, the module's ``extraction_drivers`` constant will be used, which
    means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that
    order.
    Nz!Not a recognized archive type: %s)r	r)�filename�extract_dir�progress_filterZdriversZdriverrrrrs
�cCs�tj�|�std|��|d|fi}t�|�D]�\}}}||\}}|D],}	||	dtj�||	�f|tj�||	�<qH|D]T}
tj�||
�}|||
|�}|s�qzt|�tj�||
�}
t�|
|�t�	|
|�qzq.dS)z�"Unpack" a directory, using the same interface as for archives

    Raises ``UnrecognizedFormat`` if `filename` is not a directory
    z%s is not a directory��/N)
�os�path�isdirr�walk�joinr�shutilZcopyfileZcopystat)rrr�paths�base�dirs�filesrr�d�f�targetrrrr
?s$�*c
Cs�t�|�std|f��t�|���}|��D]�}|j}|�d�s,d|�d�krPq,tj	j
|f|�d���}|||�}|sxq,|�d�r�t|�n4t|�|�
|j�}t|d��}|�|�W5QRX|jd?}	|	r,t�||	�q,W5QRXdS)z�Unpack zip `filename` to `extract_dir`

    Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined
    by ``zipfile.is_zipfile()``).  See ``unpack_archive()`` for an explanation
    of the `progress_filter` argument.
    z%s is not a zip filer�..�wb�N)�zipfileZ
is_zipfilerZZipFileZinfolistr�
startswith�splitrrr�endswithr�read�open�writeZ
external_attr�chmod)
rrr�z�info�namer$�datar#Zunix_attributesrrrrZs(




c

Csfzt�|�}Wn$tjk
r2td|f��YnXt�|���dd�|_|D�]�}|j}|�d�sPd|�	d�krPt
jj|f|�	d���}|dk	r�|�
�s�|��r�|j}|��r�t�|j�}t�||�}t�|�}|�|�}q�|dk	rP|���s�|��rP|||�}	|	rP|	�t
j��r"|	dd�}	z|�||	�WqPtjk
�rJYqPXqPW5QR�dSQRXdS)	z�Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir`

    Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined
    by ``tarfile.open()``).  See ``unpack_archive()`` for an explanation
    of the `progress_filter` argument.
    z/%s is not a compressed or uncompressed tar filecWsdS)Nr)�argsrrr�<lambda>��z unpack_tarfile.<locals>.<lambda>rr%N���T)�tarfiler-ZTarErrorr�
contextlib�closing�chownr2r)r*rrrZislnkZissymZlinkname�	posixpath�dirname�normpathZ
_getmember�isfilerr+�sepZ_extract_memberZExtractError)
rrrZtarobj�memberr2Z
prelim_dstZlinkpathrZ	final_dstrrrrs:�




)rr(r8rrr<r9Zdistutils.errorsrZ
pkg_resourcesr�__all__rrrr
rrr	rrrr�<module>s2��
#%.site-packages/setuptools/__pycache__/py34compat.cpython-38.pyc000064400000000702151446177000020354 0ustar00U

�Qab��@sXddlZzddlZWnek
r(YnXzejjZWnek
rRdd�ZYnXdS)�NcCs|j�|j�S)N)�loader�load_module�name)�spec�r�9/usr/lib/python3.8/site-packages/setuptools/py34compat.py�module_from_specsr)�	importlib�importlib.util�ImportError�utilr�AttributeErrorrrrr�<module>ssite-packages/setuptools/__pycache__/config.cpython-38.pyc000064400000042725151446177000017631 0ustar00U

�Qab6P�@s�ddlmZmZddlZddlZddlZddlZddlZddlm	Z	ddlm
Z
ddlmZddlm
Z
ddlmZmZddlmZmZdd	lmZdd
lmZmZeZddd
�Zdd�Zdd�Zddd�ZGdd�d�ZGdd�de�Z Gdd�de�Z!dS)�)�absolute_import�unicode_literalsN)�defaultdict)�partial��wraps)�
import_module)�DistutilsOptionError�DistutilsFileError)�
LegacyVersion�parse)�SpecifierSet)�string_types�PY3Fc		Cs�ddlm}m}tj�|�}tj�|�s4td|��t��}t�	tj�
|��zJ|�}|rb|��ng}||krx|�|�|j
||d�t||j|d�}W5t�	|�Xt|�S)a,Read given configuration file and returns options from it as a dict.

    :param str|unicode filepath: Path to configuration file
        to get options from.

    :param bool find_others: Whether to search for other configuration files
        which could be on in various places.

    :param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.

    :rtype: dict
    r)�Distribution�
_Distributionz%Configuration file %s does not exist.)�	filenames)�ignore_option_errors)Zsetuptools.distrr�os�path�abspath�isfiler
�getcwd�chdir�dirnameZfind_config_files�appendZparse_config_files�parse_configuration�command_options�configuration_to_dict)	�filepathZfind_othersrrrZcurrent_directoryZdistr�handlers�r!�5/usr/lib/python3.8/site-packages/setuptools/config.py�read_configurations*�
�
r#cCs.djft��}t�t||�}t|||�}|�S)z�
    Given a target object and option key, get that option from
    the target object, either through a get_{key} method or
    from an attribute directly.
    z	get_{key})�format�locals�	functoolsr�getattr)�
target_obj�keyZgetter_nameZby_attribute�getterr!r!r"�_get_optionEsr+cCs<tt�}|D]*}|jD]}t|j|�}|||j|<qq|S)z�Returns configuration data gathered by given handlers as a dict.

    :param list[ConfigHandler] handlers: Handlers list,
        usually from parse_configuration()

    :rtype: dict
    )r�dict�set_optionsr+r(�section_prefix)r Zconfig_dictZhandlerZoption�valuer!r!r"rQs
rcCs6t|||�}|��t|j|||j�}|��||fS)a�Performs additional parsing of configuration options
    for a distribution.

    Returns a list of used option handlers.

    :param Distribution distribution:
    :param dict command_options:
    :param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.
    :rtype: list
    )�ConfigOptionsHandlerr�ConfigMetadataHandler�metadata�package_dir)Zdistributionrr�options�metar!r!r"rcs��rc@s�eZdZdZdZiZd%dd�Zedd��Zdd	�Z	e
d&dd��Ze
d
d��Ze
dd��Z
e
dd��Ze
dd��Zedd��Zedd��Ze
d'dd��Ze
dd��Ze
d(dd��Zdd �Zd!d"�Zd#d$�ZdS))�
ConfigHandlerz1Handles metadata supplied in configuration files.NFcCs^i}|j}|��D].\}}|�|�s&q|�|d��d�}|||<q||_||_||_g|_dS)N��.)	r.�items�
startswith�replace�striprr(�sectionsr-)�selfr(r4rr=r.�section_name�section_optionsr!r!r"�__init__�s

zConfigHandler.__init__cCstd|jj��dS)�.Metadata item name to parser function mapping.z!%s must provide .parsers propertyN)�NotImplementedError�	__class__�__name__)r>r!r!r"�parsers�s
�zConfigHandler.parsersc	Cs�t�}|j}|j�||�}t|||�}||kr6t|��|r>dSd}|j�|�}|r�z||�}Wn tk
r~d}|jsz�YnX|r�dSt|d|d�}|dkr�t	|||�n||�|j
�|�dS)NFTzset_%s)�tupler(�aliases�getr'�KeyErrorrF�	Exceptionr�setattrr-r)	r>Zoption_namer/�unknownr(Z
current_valueZskip_option�parser�setterr!r!r"�__setitem__�s0zConfigHandler.__setitem__�,cCs8t|t�r|Sd|kr |��}n
|�|�}dd�|D�S)z�Represents value as a list.

        Value is split either by separator (defaults to comma) or by lines.

        :param value:
        :param separator: List items separator character.
        :rtype: list
        �
cSsg|]}|��r|���qSr!)r<)�.0�chunkr!r!r"�
<listcomp>�sz-ConfigHandler._parse_list.<locals>.<listcomp>)�
isinstance�list�
splitlines�split)�clsr/�	separatorr!r!r"�_parse_list�s



zConfigHandler._parse_listcCsPd}i}|�|�D]8}|�|�\}}}||kr:td|��|��||��<q|S)zPRepresents value as a dict.

        :param value:
        :rtype: dict
        �=z(Unable to parse option value to dict: %s)r\�	partitionr	r<)rZr/r[�result�liner)�sep�valr!r!r"�_parse_dict�s�zConfigHandler._parse_dictcCs|��}|dkS)zQRepresents value as boolean.

        :param value:
        :rtype: bool
        )�1�trueZyes)�lower)rZr/r!r!r"�_parse_bool�szConfigHandler._parse_boolcs�fdd�}|S)z�Returns a parser function to make sure field inputs
        are not files.

        Parses a value after getting the key so error messages are
        more informative.

        :param key:
        :rtype: callable
        cs d}|�|�rtd�����|S)N�file:zCOnly strings are accepted for the {0} field, files are not accepted)r:�
ValueErrorr$)r/Zexclude_directive�r)r!r"rNs
��z3ConfigHandler._exclude_files_parser.<locals>.parserr!)rZr)rNr!rjr"�_exclude_files_parser�sz#ConfigHandler._exclude_files_parsercs\d}t|t�s|S|�|�s |S|t|�d�}dd�|�d�D�}d��fdd�|D��S)aORepresents value as a string, allowing including text
        from nearest files using `file:` directive.

        Directive is sandboxed and won't reach anything outside
        directory with setup.py.

        Examples:
            file: README.rst, CHANGELOG.md, src/file.txt

        :param str value:
        :rtype: str
        rhNcss|]}tj�|���VqdS�N)rrrr<�rSrr!r!r"�	<genexpr>%sz,ConfigHandler._parse_file.<locals>.<genexpr>rQrRc3s.|]&}��|�stj�|�r��|�VqdS)TN)�
_assert_localrrr�
_read_filerm�rZr!r"rn&s

�)rVrr:�lenrY�join)rZr/Zinclude_directive�specZ	filepathsr!rqr"�_parse_files

�zConfigHandler._parse_filecCs|�t���std|��dS)Nz#`file:` directive can not access %s)r:rrr	)rr!r!r"ro-s�zConfigHandler._assert_localc
Cs.tj|dd��}|��W5QR�SQRXdS)Nzutf-8)�encoding)�io�open�read)r�fr!r!r"rp3szConfigHandler._read_filec	Cs�d}|�|�s|S|�|d����d�}|��}d�|�}|p@d}t��}|r�|d|kr�||d}|�dd�}	t	|	�dkr�tj
�t��|	d�}|	d}q�|}nd|kr�tj
�t��|d�}tj
�d|�zt
|�}
t|
|�}W5tj
dd�t_
X|S)	z�Represents value as a module attribute.

        Examples:
            attr: package.attr
            attr: package.module.attr

        :param str value:
        :rtype: str
        zattr:r7r8rAr�/�N)r:r;r<rY�poprsrr�rsplitrrr�sys�insertrr')rZr/r3Zattr_directiveZ
attrs_pathZ	attr_nameZmodule_name�parent_pathZcustom_path�parts�moduler!r!r"�_parse_attr8s0


zConfigHandler._parse_attrcs�fdd�}|S)z�Returns parser function to represents value as a list.

        Parses a value applying given methods one after another.

        :param parse_methods:
        :rtype: callable
        cs|}�D]}||�}q|Srlr!)r/�parsed�method��
parse_methodsr!r"rns
z1ConfigHandler._get_parser_compound.<locals>.parser!)rZr�rr!r�r"�_get_parser_compoundes	z"ConfigHandler._get_parser_compoundcCs6i}|pdd�}|��D]\}\}}||�||<q|S)z�Parses section options into a dictionary.

        Optionally applies a given parser to values.

        :param dict section_options:
        :param callable values_parser:
        :rtype: dict
        cSs|Srlr!)rbr!r!r"�<lambda>��z6ConfigHandler._parse_section_to_dict.<locals>.<lambda>)r9)rZr@Z
values_parserr/r)�_rbr!r!r"�_parse_section_to_dictxs

z$ConfigHandler._parse_section_to_dictc	Cs<|��D].\}\}}z|||<Wqtk
r4YqXqdS)zQParses configuration file section.

        :param dict section_options:
        N)r9rJ)r>r@�namer�r/r!r!r"�
parse_section�s
zConfigHandler.parse_sectioncCsb|j��D]R\}}d}|r"d|}t|d|�dd�d�}|dkrTtd|j|f��||�q
dS)zTParses configuration file items from one
        or more related sections.

        r7z_%szparse_section%sr8�__Nz0Unsupported distribution option section: [%s.%s])r=r9r'r;r	r.)r>r?r@Zmethod_postfixZsection_parser_methodr!r!r"r�s"���zConfigHandler.parsecst�����fdd��}|S)z� this function will wrap around parameters that are deprecated

        :param msg: deprecation message
        :param warning_class: class of warning exception to be raised
        :param func: function to be wrapped around
        cst�����||�Srl)�warnings�warn)�args�kwargs��func�msg�
warning_classr!r"�config_handler�sz@ConfigHandler._deprecated_config_handler.<locals>.config_handlerr)r>r�r�r�r�r!r�r"�_deprecated_config_handler�sz(ConfigHandler._deprecated_config_handler)F)rQ)N)N)rE�
__module__�__qualname__�__doc__r.rHrA�propertyrFrP�classmethodr\rcrgrkru�staticmethodrorpr�r�r�r�rr�r!r!r!r"r6~s<

&

	



,
r6csHeZdZdZddddd�ZdZd�fd	d
�	Zedd��Zd
d�Z	�Z
S)r1r2Zurl�description�classifiers�	platforms)Z	home_pageZsummaryZ
classifier�platformFNcstt|��|||�||_dSrl)�superr1rAr3)r>r(r4rr3�rDr!r"rA�s�zConfigMetadataHandler.__init__cCsL|j}|j}|j}|j}||||�|dt�||�||�|d�|||j|d�S)rBz[The requires parameter is deprecated, please use install_requires for runtime dependencies.�license)r��keywordsZprovidesZrequiresZ	obsoletesr�r�r�Zlong_description�versionZproject_urls)r\rurcrkr��DeprecationWarningr��_parse_version)r>�
parse_listZ
parse_file�
parse_dictZexclude_files_parserr!r!r"rF�s(�
�zConfigMetadataHandler.parserscCs�|�|�}||krB|��}tt|�t�r>d}t|jft����|S|�||j	�}t
|�r^|�}t|t�s�t|d�r�d�
tt|��}nd|}|S)zSParses `version` option value.

        :param value:
        :rtype: str

        zCVersion loaded from {value} does not comply with PEP 440: {version}�__iter__r8z%s)rur<rVrrr	r$r%r�r3�callabler�hasattrrs�map�str)r>r/r�Ztmplr!r!r"r��s 
�

z$ConfigMetadataHandler._parse_version)FN)rEr�r�r.rHZstrict_moderAr�rFr��
__classcell__r!r!r�r"r1�s��
r1c@s\eZdZdZedd��Zdd�Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dS)r0r4cCsN|j}t|jdd�}|j}|j}|||||||||||||||j|j|td�S)rB�;�r[)Zzip_safeZuse_2to3Zinclude_package_datar3Zuse_2to3_fixersZuse_2to3_exclude_fixersZconvert_2to3_doctestsZscriptsZeager_resourcesZdependency_linksZnamespace_packagesZinstall_requiresZsetup_requiresZ
tests_requireZpackages�entry_pointsZ
py_modulesZpython_requires)r\rrgrc�_parse_packagesrur
)r>r�Zparse_list_semicolonZ
parse_boolr�r!r!r"rFs.�zConfigOptionsHandler.parserscCszddg}|��}||kr"|�|�S||dk}|r>ts>td��|�|j�di��}|rdddlm}nddlm	}|f|�S)	zTParses `packages` option value.

        :param value:
        :rtype: list
        zfind:zfind_namespace:r|z8find_namespace: directive is unsupported on Python < 3.3z
packages.findr)�find_namespace_packages)�
find_packages)
r<r\rr	�parse_section_packages__findr=rIZ
setuptoolsr�r�)r>r/Zfind_directivesZ
trimmed_valueZfindns�find_kwargsr�r!r!r"r�1s 
��z$ConfigOptionsHandler._parse_packagescsT|�||j�}dddg�t�fdd�|��D��}|�d�}|dk	rP|d|d<|S)z�Parses `packages.find` configuration file section.

        To be used in conjunction with _parse_packages().

        :param dict section_options:
        �whereZinclude�excludecs$g|]\}}|�kr|r||f�qSr!r!�rS�k�v�Z
valid_keysr!r"rUZszEConfigOptionsHandler.parse_section_packages__find.<locals>.<listcomp>Nr)r�r\r,r9rI)r>r@Zsection_datar�r�r!r�r"r�Ms�
�
z1ConfigOptionsHandler.parse_section_packages__findcCs|�||j�}||d<dS)z`Parses `entry_points` configuration file section.

        :param dict section_options:
        r�N)r�r\�r>r@r�r!r!r"�parse_section_entry_pointsbsz/ConfigOptionsHandler.parse_section_entry_pointscCs.|�||j�}|�d�}|r*||d<|d=|S)N�*r7)r�r\rI)r>r@r��rootr!r!r"�_parse_package_datajs
z(ConfigOptionsHandler._parse_package_datacCs|�|�|d<dS)z`Parses `package_data` configuration file section.

        :param dict section_options:
        Zpackage_dataN�r��r>r@r!r!r"�parse_section_package_datatsz/ConfigOptionsHandler.parse_section_package_datacCs|�|�|d<dS)zhParses `exclude_package_data` configuration file section.

        :param dict section_options:
        Zexclude_package_dataNr�r�r!r!r"�"parse_section_exclude_package_data{s�z7ConfigOptionsHandler.parse_section_exclude_package_datacCs"t|jdd�}|�||�|d<dS)zbParses `extras_require` configuration file section.

        :param dict section_options:
        r�r�Zextras_requireN)rr\r�)r>r@r�r!r!r"�parse_section_extras_require�s
�z1ConfigOptionsHandler.parse_section_extras_requirecCs(|�||j�}dd�|��D�|d<dS)z^Parses `data_files` configuration file section.

        :param dict section_options:
        cSsg|]\}}||f�qSr!r!r�r!r!r"rU�szAConfigOptionsHandler.parse_section_data_files.<locals>.<listcomp>Z
data_filesN)r�r\r9r�r!r!r"�parse_section_data_files�sz-ConfigOptionsHandler.parse_section_data_filesN)rEr�r�r.r�rFr�r�r�r�r�r�r�r�r!r!r!r"r0s

	r0)FF)F)"Z
__future__rrrwrrr�r&�collectionsrrr�	importlibrZdistutils.errorsr	r
Z#setuptools.extern.packaging.versionrrZ&setuptools.extern.packaging.specifiersr
Zsetuptools.extern.sixrr�typeZ
__metaclass__r#r+rrr6r1r0r!r!r!r"�<module>s4�
/�
?Usite-packages/setuptools/__pycache__/extension.cpython-38.opt-1.pyc000064400000003651151446177000021332 0ustar00U

�Qab��@s|ddlZddlZddlZddlZddlZddlmZddlm	Z	dd�Z
e
Ze	ejj
�ZGdd�de�Z
Gd	d
�d
e
�ZdS)�N)�map�)�
get_unpatchedcCs4d}zt|dgd�jWdStk
r.YnXdS)z0
    Return True if Cython can be imported.
    zCython.Distutils.build_ext�	build_ext)�fromlistTF)�
__import__r�	Exception)Zcython_impl�r	�8/usr/lib/python3.8/site-packages/setuptools/extension.py�_have_cythonsrc@s eZdZdZdd�Zdd�ZdS)�	Extensionz7Extension that uses '.c' files in place of '.pyx' filescOs(|�dd�|_tj|||f|�|�dS)N�py_limited_apiF)�popr
�
_Extension�__init__)�self�name�sources�args�kwr	r	r
r#szExtension.__init__cCsNt�r
dS|jpd}|��dkr$dnd}t�tjd|�}tt||j	��|_	dS)z�
        Replace sources with .pyx extensions to sources with the target
        language extension. This mechanism allows language authors to supply
        pre-converted sources but to prefer the .pyx sources.
        N�zc++z.cppz.cz.pyx$)
rZlanguage�lower�	functools�partial�re�sub�listrr)rZlangZ
target_extrr	r	r
�_convert_pyx_sources_to_lang)s
z&Extension._convert_pyx_sources_to_langN)�__name__�
__module__�__qualname__�__doc__rrr	r	r	r
r src@seZdZdZdS)�Libraryz=Just like a regular Extension, but built as a library insteadN)rrr r!r	r	r	r
r"8sr")rrZdistutils.coreZ	distutilsZdistutils.errorsZdistutils.extensionZsetuptools.extern.six.movesrZmonkeyrrZ
have_pyrexZcorerrr"r	r	r	r
�<module>ssite-packages/setuptools/__pycache__/version.cpython-38.pyc000064400000000444151446177000020041 0ustar00U

�Qab��@s6ddlZze�d�jZWnek
r0dZYnXdS)�NZ
setuptools�unknown)Z
pkg_resourcesZget_distribution�version�__version__�	Exception�rr�6/usr/lib/python3.8/site-packages/setuptools/version.py�<module>ssite-packages/setuptools/__pycache__/_deprecation_warning.cpython-38.pyc000064400000001004151446177000022526 0ustar00U

�Qab��@sGdd�de�ZdS)c@seZdZdZdS)�SetuptoolsDeprecationWarningz�
    Base class for warning deprecations in ``setuptools``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    N)�__name__�
__module__�__qualname__�__doc__�rr�C/usr/lib/python3.8/site-packages/setuptools/_deprecation_warning.pyrsrN)�Warningrrrrr�<module>�site-packages/setuptools/__pycache__/glob.cpython-38.opt-1.pyc000064400000007143151446177000020241 0ustar00U

�Qab��@s�dZddlZddlZddlZdddgZddd�Zddd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Ze�d�Z
e�d�Zdd�Zdd�Zdd�ZdS)z�
Filename globbing utility. Mostly a copy of `glob` from Python 3.5.

Changes include:
 * `yield from` and PEP3102 `*` removed.
 * Hidden files are not ignored.
�N�glob�iglob�escapeFcCstt||d��S)ayReturn a list of paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la
    fnmatch. However, unlike fnmatch, filenames starting with a
    dot are special cases that are not matched by '*' and '?'
    patterns.

    If recursive is true, the pattern '**' will match any files and
    zero or more directories and subdirectories.
    )�	recursive)�listr)�pathnamer�r�3/usr/lib/python3.8/site-packages/setuptools/glob.pyrscCs"t||�}|rt|�rt|�}|S)a�Return an iterator which yields the paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la
    fnmatch. However, unlike fnmatch, filenames starting with a
    dot are special cases that are not matched by '*' and '?'
    patterns.

    If recursive is true, the pattern '**' will match any files and
    zero or more directories and subdirectories.
    )�_iglob�_isrecursive�next)rr�it�srrr	rs
ccs�tj�|�\}}t|�sF|r0tj�|�rB|Vntj�|�rB|VdS|s�|rnt|�rnt||�D]
}|Vq`nt||�D]
}|VqxdS||kr�t|�r�t	||�}n|g}t|�r�|r�t|�r�t}q�t}nt
}|D]$}|||�D]}tj�||�Vq�q�dS�N)�os�path�split�	has_magic�lexists�isdirr�glob2�glob1r
�glob0�join)rr�dirname�basename�x�dirsZglob_in_dir�namerrr	r
0s4
r
cCsV|s"t|t�rtj�d�}ntj}zt�|�}Wntk
rHgYSXt�||�S�N�ASCII)	�
isinstance�bytesr�curdir�encode�listdir�OSError�fnmatch�filter)r�pattern�namesrrr	r[s

rcCs8|stj�|�r4|gSntj�tj�||��r4|gSgSr)rrrrr)rrrrr	rhsrccs&|dd�Vt|�D]
}|VqdS)Nr)�	_rlistdir)rr)rrrr	rxsrccs�|s"t|t�rtj�d�}ntj}zt�|�}Wntjk
rHYdSX|D]>}|V|rjtj�||�n|}t	|�D]}tj�||�VqvqNdSr)
r!r"rr#r$r%�errorrrr+)rr*rr�yrrr	r+�s
r+z([*?[])s([*?[])cCs(t|t�rt�|�}n
t�|�}|dk	Sr)r!r"�magic_check_bytes�search�magic_check)r�matchrrr	r�s

rcCst|t�r|dkS|dkSdS)Ns**z**)r!r")r)rrr	r�s
rcCs<tj�|�\}}t|t�r(t�d|�}nt�d|�}||S)z#Escape all special characters.
    s[\1]z[\1])rr�
splitdriver!r"r.�subr0)rZdriverrr	r�s

)F)F)�__doc__r�rer'�__all__rrr
rrrr+�compiler0r.rrrrrrr	�<module>s 


+


site-packages/setuptools/__pycache__/glibc.cpython-38.pyc000064400000002772151446177000017442 0ustar00U

�QabJ�@sHddlmZddlZddlZddlZdd�Zdd�Zdd�Zd	d
�ZdS)�)�absolute_importNcCsRt�d�}z
|j}Wntk
r*YdSXtj|_|�}t|t�sN|�d�}|S)z9Returns glibc version string, or None if not using glibc.N�ascii)	�ctypesZCDLL�gnu_get_libc_version�AttributeErrorZc_char_pZrestype�
isinstance�str�decode)Zprocess_namespacer�version_str�r�4/usr/lib/python3.8/site-packages/setuptools/glibc.py�glibc_version_string
s



r
cCsHt�d|�}|s$t�d|t�dSt|�d��|koFt|�d��|kS)Nz$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z=Expected glibc version with 2 components major.minor, got: %sF�major�minor)�re�match�warnings�warn�RuntimeWarning�int�group)r
�required_major�
minimum_minor�mrrr�check_glibc_version$s���rcCst�}|dkrdSt|||�S)NF)r
r)rrr
rrr�have_compatible_glibc4srcCst�}|dkrdSd|fSdS)z�Try to determine the glibc version

    Returns a tuple of strings (lib, version) which default to empty strings
    in case the lookup fails.
    N)�rZglibc)r
)Z
glibc_versionrrr�libc_verLsr)	Z
__future__rrrrr
rrrrrrr�<module>ssite-packages/setuptools/__pycache__/extension.cpython-38.pyc000064400000003651151446177000020373 0ustar00U

�Qab��@s|ddlZddlZddlZddlZddlZddlmZddlm	Z	dd�Z
e
Ze	ejj
�ZGdd�de�Z
Gd	d
�d
e
�ZdS)�N)�map�)�
get_unpatchedcCs4d}zt|dgd�jWdStk
r.YnXdS)z0
    Return True if Cython can be imported.
    zCython.Distutils.build_ext�	build_ext)�fromlistTF)�
__import__r�	Exception)Zcython_impl�r	�8/usr/lib/python3.8/site-packages/setuptools/extension.py�_have_cythonsrc@s eZdZdZdd�Zdd�ZdS)�	Extensionz7Extension that uses '.c' files in place of '.pyx' filescOs(|�dd�|_tj|||f|�|�dS)N�py_limited_apiF)�popr
�
_Extension�__init__)�self�name�sources�args�kwr	r	r
r#szExtension.__init__cCsNt�r
dS|jpd}|��dkr$dnd}t�tjd|�}tt||j	��|_	dS)z�
        Replace sources with .pyx extensions to sources with the target
        language extension. This mechanism allows language authors to supply
        pre-converted sources but to prefer the .pyx sources.
        N�zc++z.cppz.cz.pyx$)
rZlanguage�lower�	functools�partial�re�sub�listrr)rZlangZ
target_extrr	r	r
�_convert_pyx_sources_to_lang)s
z&Extension._convert_pyx_sources_to_langN)�__name__�
__module__�__qualname__�__doc__rrr	r	r	r
r src@seZdZdZdS)�Libraryz=Just like a regular Extension, but built as a library insteadN)rrr r!r	r	r	r
r"8sr")rrZdistutils.coreZ	distutilsZdistutils.errorsZdistutils.extensionZsetuptools.extern.six.movesrZmonkeyrrZ
have_pyrexZcorerrr"r	r	r	r
�<module>ssite-packages/setuptools/__pycache__/windows_support.cpython-38.pyc000064400000001735151446177000021646 0ustar00U

�Qab��@s(ddlZddlZdd�Zedd��ZdS)�NcCst��dkrdd�S|S)NZWindowsc_sdS)N�)�args�kwargsrr�>/usr/lib/python3.8/site-packages/setuptools/windows_support.py�<lambda>�zwindows_only.<locals>.<lambda>)�platform�system)�funcrrr�windows_onlysrcCsLtd�tjjj}tjjtjjf|_tjj	|_
d}|||�}|sHt���dS)z�
    Set the hidden attribute on a file or directory.

    From http://stackoverflow.com/questions/19622133/

    `path` must be text.
    zctypes.wintypes�N)�
__import__�ctypesZwindllZkernel32ZSetFileAttributesWZwintypesZLPWSTRZDWORDZargtypesZBOOLZrestypeZWinError)�pathZSetFileAttributes�FILE_ATTRIBUTE_HIDDEN�retrrr�	hide_files	


r)rrrrrrrr�<module>ssite-packages/setuptools/__pycache__/msvc.cpython-38.pyc000064400000115317151446177000017332 0ustar00U

�Qab���@sXdZddlZddlmZddlmZmZddlmZm	Z	m
Z
mZddlZddl
Z
ddlZddlZddlmZddlmZdd	lmZe
��d
kr�ddlmZddlmZnGd
d�d�Ze�ZeejjfZzddlm Z Wnek
r�YnXdd�Z!d$dd�Z"dd�Z#dd�Z$d%dd�Z%Gdd�d�Z&Gdd�d�Z'Gd d!�d!�Z(Gd"d#�d#�Z)dS)&a�
Improved support for Microsoft Visual C++ compilers.

Known supported compilers:
--------------------------
Microsoft Visual C++ 9.0:
    Microsoft Visual C++ Compiler for Python 2.7 (x86, amd64)
    Microsoft Windows SDK 6.1 (x86, x64, ia64)
    Microsoft Windows SDK 7.0 (x86, x64, ia64)

Microsoft Visual C++ 10.0:
    Microsoft Windows SDK 7.1 (x86, x64, ia64)

Microsoft Visual C++ 14.X:
    Microsoft Visual C++ Build Tools 2015 (x86, x64, arm)
    Microsoft Visual Studio Build Tools 2017 (x86, x64, arm, arm64)
    Microsoft Visual Studio Build Tools 2019 (x86, x64, arm, arm64)

This may also support compilers shipped with compatible Visual Studio versions.
�N)�open)�listdir�pathsep)�join�isfile�isdir�dirname)�
LegacyVersion)�filterfalse�)�
get_unpatched�Windows)�winreg)�environc@seZdZdZdZdZdZdS)rN)�__name__�
__module__�__qualname__�
HKEY_USERS�HKEY_CURRENT_USER�HKEY_LOCAL_MACHINE�HKEY_CLASSES_ROOT�rr�3/usr/lib/python3.8/site-packages/setuptools/msvc.pyr*sr)�RegcCs�d}|d|f}zt�|d�}WnJtk
rjz|d|f}t�|d�}Wntk
rdd}YnXYnX|r�t|d�}t|�r�|Stt�|�S)a�
    Patched "distutils.msvc9compiler.find_vcvarsall" to use the standalone
    compiler build for Python
    (VCForPython / Microsoft Visual C++ Compiler for Python 2.7).

    Fall back to original behavior when the standalone compiler is not
    available.

    Redirect the path of "vcvarsall.bat".

    Parameters
    ----------
    version: float
        Required Microsoft Visual C++ version.

    Return
    ------
    str
        vcvarsall.bat path
    z-Software\%sMicrosoft\DevDiv\VCForPython\%0.1f��
installdirzWow6432Node\Nz
vcvarsall.bat)rZ	get_value�KeyErrorrrr�msvc9_find_vcvarsall)�versionZvc_base�key�
productdir�	vcvarsallrrrrAs
r�x86c
Os�ztt�}|||f|�|�WStjjk
r4Yntk
rFYnXzt||���WStjjk
r�}zt|||��W5d}~XYnXdS)ao
    Patched "distutils.msvc9compiler.query_vcvarsall" for support extra
    Microsoft Visual C++ 9.0 and 10.0 compilers.

    Set environment without use of "vcvarsall.bat".

    Parameters
    ----------
    ver: float
        Required Microsoft Visual C++ version.
    arch: str
        Target architecture.

    Return
    ------
    dict
        environment
    N)	r�msvc9_query_vcvarsall�	distutils�errors�DistutilsPlatformError�
ValueError�EnvironmentInfo�
return_env�_augment_exception)�ver�arch�args�kwargsZorig�excrrrr#ksr#c
Csrztt�|�WStjjk
r&YnXzt|dd���WStjjk
rl}zt|d��W5d}~XYnXdS)a*
    Patched "distutils._msvccompiler._get_vc_env" for support extra
    Microsoft Visual C++ 14.X compilers.

    Set environment without use of "vcvarsall.bat".

    Parameters
    ----------
    plat_spec: str
        Target architecture.

    Return
    ------
    dict
        environment
    �,@)�
vc_min_verN)r�msvc14_get_vc_envr$r%r&r(r)r*)Z	plat_specr/rrrr2�s
r2cOsBdtjkr4ddl}t|j�td�kr4|jjj||�Stt	�||�S)z�
    Patched "distutils._msvccompiler.gen_lib_options" for fix
    compatibility between "numpy.distutils" and "distutils._msvccompiler"
    (for Numpy < 1.11.2)
    znumpy.distutilsrNz1.11.2)
�sys�modulesZnumpyr	�__version__r$Z	ccompilerZgen_lib_optionsr�msvc14_gen_lib_options)r-r.Znprrrr6�s

r6rcCs�|jd}d|��ks"d|��kr�d}|jft��}d}|dkrf|���d�dkr\|d	7}q�|d
7}n.|dkr�|d7}||d
7}n|dkr�|d7}|f|_dS)zl
    Add details to the exception message to help guide the user
    as to what action will resolve it.
    rr!zvisual cz0Microsoft Visual C++ {version:0.1f} is required.z-www.microsoft.com/download/details.aspx?id=%d�"@Zia64���z( Get it with "Microsoft Windows SDK 7.0"z% Get it from http://aka.ms/vcpython27�$@z* Get it with "Microsoft Windows SDK 7.1": iW r0z[ Get it with "Build Tools for Visual Studio": https://visualstudio.microsoft.com/downloads/N)r-�lower�format�locals�find)r/rr,�messageZtmplZ
msdownloadrrrr*�s


r*c@sbeZdZdZe�dd���Zdd�Ze	dd��Z
dd	�Zd
d�Zdd
d�Z
ddd�Zddd�ZdS)�PlatformInfoz�
    Current and Target Architectures information.

    Parameters
    ----------
    arch: str
        Target architecture.
    Zprocessor_architecturercCs|���dd�|_dS)N�x64�amd64)r:�replacer,)�selfr,rrr�__init__�szPlatformInfo.__init__cCs|j|j�d�dd�S)zs
        Return Target CPU architecture.

        Return
        ------
        str
            Target CPU
        �_rN)r,r=�rCrrr�
target_cpu�s
zPlatformInfo.target_cpucCs
|jdkS)z�
        Return True if target CPU is x86 32 bits..

        Return
        ------
        bool
            CPU is x86 32 bits
        r"�rGrFrrr�
target_is_x86�s	zPlatformInfo.target_is_x86cCs
|jdkS)z�
        Return True if current CPU is x86 32 bits..

        Return
        ------
        bool
            CPU is x86 32 bits
        r"��current_cpurFrrr�current_is_x86s	zPlatformInfo.current_is_x86FcCs.|jdkr|rdS|jdkr$|r$dSd|jS)uk
        Current platform specific subfolder.

        Parameters
        ----------
        hidex86: bool
            return '' and not '†' if architecture is x86.
        x64: bool
            return 'd' and not 'md64' if architecture is amd64.

        Return
        ------
        str
            subfolder: '	arget', or '' (see hidex86 parameter)
        r"rrA�\x64�\%srJ�rC�hidex86r@rrr�current_dirs�zPlatformInfo.current_dircCs.|jdkr|rdS|jdkr$|r$dSd|jS)ar
        Target platform specific subfolder.

        Parameters
        ----------
        hidex86: bool
            return '' and not '\x86' if architecture is x86.
        x64: bool
            return '\x64' and not '\amd64' if architecture is amd64.

        Return
        ------
        str
            subfolder: '\current', or '' (see hidex86 parameter)
        r"rrArMrNrHrOrrr�
target_dir(s�zPlatformInfo.target_dircCs0|rdn|j}|j|krdS|���dd|�S)ap
        Cross platform specific subfolder.

        Parameters
        ----------
        forcex86: bool
            Use 'x86' as current architecture even if current architecture is
            not x86.

        Return
        ------
        str
            subfolder: '' if target architecture is current architecture,
            '\current_target' if not.
        r"r�\z\%s_)rKrGrRrB)rC�forcex86Zcurrentrrr�	cross_dir>s�zPlatformInfo.cross_dirN)FF)FF)F)rrr�__doc__r�getr:rKrD�propertyrGrIrLrQrRrUrrrrr?�s


r?c@s�eZdZdZejejejejfZ	dd�Z
edd��Zedd��Z
edd	��Zed
d��Zedd
��Zedd��Zedd��Zedd��Zedd��Zddd�Zdd�ZdS)�RegistryInfoz�
    Microsoft Visual Studio related registry information.

    Parameters
    ----------
    platform_info: PlatformInfo
        "PlatformInfo" instance.
    cCs
||_dS�N)�pi)rCZ
platform_inforrrrDcszRegistryInfo.__init__cCsdS)z�
        Microsoft Visual Studio root registry key.

        Return
        ------
        str
            Registry key
        ZVisualStudiorrFrrr�visualstudiofs
zRegistryInfo.visualstudiocCst|jd�S)z
        Microsoft Visual Studio SxS registry key.

        Return
        ------
        str
            Registry key
        ZSxS)rr\rFrrr�sxsrs
zRegistryInfo.sxscCst|jd�S)z|
        Microsoft Visual C++ VC7 registry key.

        Return
        ------
        str
            Registry key
        ZVC7�rr]rFrrr�vc~s
zRegistryInfo.vccCst|jd�S)z
        Microsoft Visual Studio VS7 registry key.

        Return
        ------
        str
            Registry key
        ZVS7r^rFrrr�vs�s
zRegistryInfo.vscCsdS)z�
        Microsoft Visual C++ for Python registry key.

        Return
        ------
        str
            Registry key
        zDevDiv\VCForPythonrrFrrr�
vc_for_python�s
zRegistryInfo.vc_for_pythoncCsdS)zq
        Microsoft SDK registry key.

        Return
        ------
        str
            Registry key
        zMicrosoft SDKsrrFrrr�
microsoft_sdk�s
zRegistryInfo.microsoft_sdkcCst|jd�S)z�
        Microsoft Windows/Platform SDK registry key.

        Return
        ------
        str
            Registry key
        r
�rrbrFrrr�windows_sdk�s
zRegistryInfo.windows_sdkcCst|jd�S)z�
        Microsoft .NET Framework SDK registry key.

        Return
        ------
        str
            Registry key
        ZNETFXSDKrcrFrrr�	netfx_sdk�s
zRegistryInfo.netfx_sdkcCsdS)z�
        Microsoft Windows Kits Roots registry key.

        Return
        ------
        str
            Registry key
        zWindows Kits\Installed RootsrrFrrr�windows_kits_roots�s
zRegistryInfo.windows_kits_rootsFcCs$|j��s|rdnd}td|d|�S)a
        Return key in Microsoft software registry.

        Parameters
        ----------
        key: str
            Registry key path where look.
        x86: str
            Force x86 software registry.

        Return
        ------
        str
            Registry key
        rZWow6432NodeZSoftwareZ	Microsoft)r[rLr)rCrr"Znode64rrr�	microsoft�szRegistryInfo.microsoftc
Cs�tj}tj}|j}|jD]�}z||||�d|�}Wn`ttfk
r�|j��s�z||||d�d|�}Wq�ttfk
r�YYqYq�XnYqYnXzt�	||�dWSttfk
r�YqXqdS)a
        Look for values in registry in Microsoft software registry.

        Parameters
        ----------
        key: str
            Registry key path where look.
        name: str
            Value name to find.

        Return
        ------
        str
            value
        rTN)
r�KEY_READ�OpenKeyrg�HKEYS�OSError�IOErrorr[rLZQueryValueEx)rCr�nameZkey_readZopenkey�ms�hkey�bkeyrrr�lookup�s"


zRegistryInfo.lookupN)F)rrrrVrrrrrrjrDrXr\r]r_r`rarbrdrerfrgrqrrrrrYUs6�









rYc@s<eZdZdZe�dd�Ze�dd�Ze�de�Zd7dd�Z	d	d
�Z
dd�Zd
d�Ze
dd��Zedd��Zedd��Zdd�Zdd�Zedd��Zedd��Zedd��Zedd ��Zed!d"��Zed#d$��Zed%d&��Zed'd(��Zed)d*��Zed+d,��Zed-d.��Zed/d0��Zed1d2��Z d3d4�Z!e
d8d5d6��Z"dS)9�
SystemInfoz�
    Microsoft Windows and Visual Studio related system information.

    Parameters
    ----------
    registry_info: RegistryInfo
        "RegistryInfo" instance.
    vc_ver: float
        Required Microsoft Visual C++ version.
    �WinDirr�ProgramFileszProgramFiles(x86)NcCs2||_|jj|_|��|_|p$|��|_|_dSrZ)�rir[�find_programdata_vs_vers�known_vs_paths�_find_latest_available_vs_ver�vs_ver�vc_ver)rCZ
registry_inforzrrrrDs



�zSystemInfo.__init__cCs>|��}|s|jstj�d��t|�}|�|j�t|�dS)zm
        Find the latest VC version

        Return
        ------
        float
            version
        z%No Microsoft Visual C++ version foundr8)�find_reg_vs_versrwr$r%r&�set�update�sorted)rCZreg_vc_versZvc_versrrrrx%s	
�z(SystemInfo._find_latest_available_vs_vercCs$|jj}|jj|jj|jjf}g}|jjD]�}|D]�}zt�|||�dtj�}Wnt	t
fk
rlYq2YnXt�|�\}}}	t|�D]D}
z*t
t�||
�d�}||kr�|�|�Wq�tk
r�Yq�Xq�t|�D]B}
z&t
t�||
��}||kr�|�|�Wq�tk
�rYq�Xq�q2q*t|�S)z�
        Find Microsoft Visual Studio versions available in registry.

        Return
        ------
        list of float
            Versions
        r)rurgr_rar`rjrrirhrkrlZQueryInfoKey�range�floatZ	EnumValue�appendr'ZEnumKeyr~)rCrnZvckeysZvs_versrorrpZsubkeys�valuesrE�ir+rrrr{8s2	
zSystemInfo.find_reg_vs_versc	Cs�i}d}zt|�}Wnttfk
r0|YSX|D]�}z\t||d�}t|ddd��}t�|�}W5QRX|d}tt|d��|||�|d�<Wq6tttfk
r�Yq6Yq6Xq6|S)	z�
        Find Visual studio 2017+ versions from information in
        "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances".

        Return
        ------
        dict
            float version as key, path as value.
        z9C:\ProgramData\Microsoft\VisualStudio\Packages\_Instancesz
state.jsonZrtzutf-8)�encodingZinstallationPath�
VC\Tools\MSVCZinstallationVersion)	rrkrlrr�json�load�_as_float_versionr)	rCZvs_versionsZ
instances_dirZhashed_namesrmZ
state_pathZ
state_file�stateZvs_pathrrrrv[s*
�
��z#SystemInfo.find_programdata_vs_verscCstd�|�d�dd���S)z�
        Return a string version as a simplified float version (major.minor)

        Parameters
        ----------
        version: str
            Version.

        Return
        ------
        float
            version
        �.N�)r�r�split)rrrrr��szSystemInfo._as_float_versioncCs.t|jd|j�}|j�|jjd|j�p,|S)zp
        Microsoft Visual Studio directory.

        Return
        ------
        str
            path
        zMicrosoft Visual Studio %0.1f�%0.1f)r�ProgramFilesx86ryrurqr`)rC�defaultrrr�VSInstallDir�s�zSystemInfo.VSInstallDircCs,|��p|��}t|�s(d}tj�|��|S)zm
        Microsoft Visual C++ directory.

        Return
        ------
        str
            path
        z(Microsoft Visual C++ directory not found)�	_guess_vc�_guess_vc_legacyrr$r%r&)rC�path�msgrrr�VCInstallDir�s

zSystemInfo.VCInstallDirc
Cs�|jdkrdSz|j|j}Wntk
r8|j}YnXt|d�}z$t|�d}|�|�|_t||�WStt	t
fk
r�YdSXdS)zl
        Locate Visual C++ for VS2017+.

        Return
        ------
        str
            path
        r0rr�r8N)ryrwrr�rrr�rzrkrl�
IndexError)rCZvs_dirZguess_vcrzrrrr��s	

zSystemInfo._guess_vccCsbt|jd|j�}t|jjd|j�}|j�|d�}|rBt|d�n|}|j�|jjd|j�p`|S)z{
        Locate Visual C++ for versions prior to 2017.

        Return
        ------
        str
            path
        z Microsoft Visual Studio %0.1f\VCr�rZVC)rr�ryrurarqr_)rCr�Zreg_pathZ	python_vcZ
default_vcrrrr��s	�zSystemInfo._guess_vc_legacycCsJ|jdkrdS|jdkrdS|jdkr*dS|jdkr8dS|jd	krFd
SdS)z�
        Microsoft Windows SDK versions for specified MSVC++ version.

        Return
        ------
        tuple of str
            versions
        r7)z7.0z6.1z6.0ar9)z7.1z7.0a�&@)z8.0z8.0a�(@)�8.1z8.1ar0)z10.0r�N�ryrFrrr�WindowsSdkVersion�s





zSystemInfo.WindowsSdkVersioncCs|�t|jd��S)zt
        Microsoft Windows SDK last version.

        Return
        ------
        str
            version
        �lib)�_use_last_dir_namer�
WindowsSdkDirrFrrr�WindowsSdkLastVersions
z SystemInfo.WindowsSdkLastVersioncCsd}|jD],}t|jjd|�}|j�|d�}|r
q8q
|rDt|�stt|jjd|j�}|j�|d�}|rtt|d�}|r�t|�s�|jD]6}|d|�d��}d	|}t|j	|�}t|�r�|}q�|r�t|�s�|jD]$}d
|}t|j	|�}t|�r�|}q�|�st|j
d�}|S)zn
        Microsoft Windows SDK directory.

        Return
        ------
        str
            path
        rzv%s�installationfolderr�rZWinSDKNr�zMicrosoft SDKs\Windows Kits\%szMicrosoft SDKs\Windows\v%sZPlatformSDK)r�rrurdrqrrarz�rfindrtr�)rC�sdkdirr+�locr�Zinstall_baseZintver�drrrr�s6




zSystemInfo.WindowsSdkDirc	Cs�|jdkrd}d}n&d}|jdkr&dnd}|jjd|d�}d	||�d
d�f}g}|jdkr~|jD]}|t|jj||�g7}qb|jD]}|t|jj	d
||�g7}q�|D]}|j�
|d�}|r�|Sq�dS)zy
        Microsoft Windows SDK executable directory.

        Return
        ------
        str
            path
        r��#r�(r�TF)r@rPzWinSDK-NetFx%dTools%srS�-r0zv%sAr�N)ryr[rQrB�NetFxSdkVersionrrurer�rdrq)	rCZnetfxverr,rPZfxZregpathsr+r�Zexecpathrrr�WindowsSDKExecutablePath7s"



z#SystemInfo.WindowsSDKExecutablePathcCs&t|jjd|j�}|j�|d�p$dS)zl
        Microsoft Visual F# directory.

        Return
        ------
        str
            path
        z%0.1f\Setup\F#r r)rrur\ryrq)rCr�rrr�FSharpInstallDirZs
zSystemInfo.FSharpInstallDircCsF|jdkrdnd}|D]*}|j�|jjd|�}|r|p:dSqdS)zt
        Microsoft Universal CRT SDK directory.

        Return
        ------
        str
            path
        r0)Z10Z81rz
kitsroot%srN)ryrurqrf)rCZversr+r�rrr�UniversalCRTSdkDirgs�zSystemInfo.UniversalCRTSdkDircCs|�t|jd��S)z�
        Microsoft Universal C Runtime SDK last version.

        Return
        ------
        str
            version
        r�)r�rr�rFrrr�UniversalCRTSdkLastVersion{s
z%SystemInfo.UniversalCRTSdkLastVersioncCs|jdkrdSdS)z�
        Microsoft .NET Framework SDK versions.

        Return
        ------
        tuple of str
            versions
        r0)	z4.7.2z4.7.1z4.7z4.6.2z4.6.1z4.6z4.5.2z4.5.1z4.5rr�rFrrrr��s��zSystemInfo.NetFxSdkVersioncCs8d}|jD](}t|jj|�}|j�|d�}|r
q4q
|S)zu
        Microsoft .NET Framework SDK directory.

        Return
        ------
        str
            path
        rZkitsinstallationfolder)r�rrurerq)rCr�r+r�rrr�NetFxSdkDir�s

zSystemInfo.NetFxSdkDircCs"t|jd�}|j�|jjd�p |S)zw
        Microsoft .NET Framework 32bit directory.

        Return
        ------
        str
            path
        zMicrosoft.NET\FrameworkZframeworkdir32�rrsrurqr_�rCZguess_fwrrr�FrameworkDir32�szSystemInfo.FrameworkDir32cCs"t|jd�}|j�|jjd�p |S)zw
        Microsoft .NET Framework 64bit directory.

        Return
        ------
        str
            path
        zMicrosoft.NET\Framework64Zframeworkdir64r�r�rrr�FrameworkDir64�szSystemInfo.FrameworkDir64cCs
|�d�S)z�
        Microsoft .NET Framework 32bit versions.

        Return
        ------
        tuple of str
            versions
        � ��_find_dot_net_versionsrFrrr�FrameworkVersion32�s
zSystemInfo.FrameworkVersion32cCs
|�d�S)z�
        Microsoft .NET Framework 64bit versions.

        Return
        ------
        tuple of str
            versions
        �@r�rFrrr�FrameworkVersion64�s
zSystemInfo.FrameworkVersion64cCs�|j�|jjd|�}t|d|�}|p6|�|d�p6d}|jdkrJ|dfS|jdkrt|��dd	�d
krldn|dfS|jd
kr�dS|jdkr�dSdS)z�
        Find Microsoft .NET Framework versions.

        Parameters
        ----------
        bits: int
            Platform number of bits: 32 or 64.

        Return
        ------
        tuple of str
            versions
        zframeworkver%dzFrameworkDir%d�vrr�zv4.0r9Nr�Zv4z
v4.0.30319�v3.5r7)r��
v2.0.50727g @)zv3.0r�)rurqr_�getattrr�ryr:)rC�bitsZreg_verZdot_net_dirr+rrrr��s

 

z!SystemInfo._find_dot_net_versionscs*��fdd�tt���D�}t|d�p(dS)a)
        Return name of the last dir in path or '' if no dir found.

        Parameters
        ----------
        path: str
            Use dirs in this path
        prefix: str
            Use only dirs starting by this prefix

        Return
        ------
        str
            name
        c3s*|]"}tt�|��r|���r|VqdSrZ)rr�
startswith)�.0Zdir_name�r��prefixrr�	<genexpr>s
�z0SystemInfo._use_last_dir_name.<locals>.<genexpr>Nr)�reversedr�next)r�r�Z
matching_dirsrr�rr��s
�zSystemInfo._use_last_dir_name)N)r)#rrrrVrrWrsrtr�rDrxr{rv�staticmethodr�rXr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrr	sZ


#*





*
"








rrc@sbeZdZdZd?dd�Zedd��Zedd	��Zed
d��Zedd
��Z	edd��Z
edd��Zedd��Zedd��Z
edd��Zedd��Zedd��Zdd�Zedd��Zed d!��Zed"d#��Zed$d%��Zed&d'��Zed(d)��Zed*d+��Zed,d-��Zed.d/��Zed0d1��Zed2d3��Zed4d5��Zed6d7��Zd@d9d:�Zd;d<�Z e!dAd=d>��Z"dS)Br(aY
    Return environment variables for specified Microsoft Visual C++ version
    and platform : Lib, Include, Path and libpath.

    This function is compatible with Microsoft Visual C++ 9.0 to 14.X.

    Script created by analysing Microsoft environment configuration files like
    "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ...

    Parameters
    ----------
    arch: str
        Target architecture.
    vc_ver: float
        Required Microsoft Visual C++ version. If not set, autodetect the last
        version.
    vc_min_ver: float
        Minimum Microsoft Visual C++ version.
    NrcCsBt|�|_t|j�|_t|j|�|_|j|kr>d}tj�	|��dS)Nz.No suitable Microsoft Visual C++ version found)
r?r[rYrurr�sirzr$r%r&)rCr,rzr1�errrrrrD0s

zEnvironmentInfo.__init__cCs|jjS)zk
        Microsoft Visual Studio.

        Return
        ------
        float
            version
        )r�ryrFrrrry9s
zEnvironmentInfo.vs_vercCs|jjS)zp
        Microsoft Visual C++ version.

        Return
        ------
        float
            version
        )r�rzrFrrrrzEs
zEnvironmentInfo.vc_vercsVddg}�jdkrD�jjddd�}|dg7}|dg7}|d|g7}�fd	d
�|D�S)zu
        Microsoft Visual Studio Tools.

        Return
        ------
        list of str
            paths
        zCommon7\IDEz
Common7\Toolsr0T�rPr@z1Common7\IDE\CommonExtensions\Microsoft\TestWindowzTeam Tools\Performance ToolszTeam Tools\Performance Tools%scsg|]}t�jj|��qSr�rr�r��r�r�rFrr�
<listcomp>csz+EnvironmentInfo.VSTools.<locals>.<listcomp>)ryr[rQ)rC�paths�arch_subdirrrFr�VSToolsQs



zEnvironmentInfo.VSToolscCst|jjd�t|jjd�gS)z�
        Microsoft Visual C++ & Microsoft Foundation Class Includes.

        Return
        ------
        list of str
            paths
        ZIncludezATLMFC\Include�rr�r�rFrrr�
VCIncludeses
�zEnvironmentInfo.VCIncludescsb�jdkr�jjdd�}n�jjdd�}d|d|g}�jdkrP|d|g7}�fd	d
�|D�S)z�
        Microsoft Visual C++ & Microsoft Foundation Class Libraries.

        Return
        ------
        list of str
            paths
        �.@T�r@�rP�Lib%szATLMFC\Lib%sr0zLib\store%scsg|]}t�jj|��qSrr�r�rFrrr��sz/EnvironmentInfo.VCLibraries.<locals>.<listcomp>)ryr[rR)rCr�r�rrFr�VCLibrariesrs


zEnvironmentInfo.VCLibrariescCs|jdkrgSt|jjd�gS)z�
        Microsoft Visual C++ store references Libraries.

        Return
        ------
        list of str
            paths
        r0zLib\store\references)ryrr�r�rFrrr�VCStoreRefs�s

zEnvironmentInfo.VCStoreRefscCs|j}t|jd�g}|jdkr"dnd}|j�|�}|rL|t|jd|�g7}|jdkr|d|jjdd�}|t|j|�g7}n�|jdkr�|j��r�d	nd
}|t|j||jjdd��g7}|jj	|jj
kr�|t|j||jjdd��g7}n|t|jd�g7}|S)
zr
        Microsoft Visual C++ Tools.

        Return
        ------
        list of str
            paths
        Z
VCPackagesr9TF�Bin%sr0r�r�z
bin\HostX86%sz
bin\HostX64%sr��Bin)r�rr�ryr[rUrQrLrRrKrG)rCr��toolsrTr�r�Zhost_dirrrr�VCTools�s0


���
zEnvironmentInfo.VCToolscCsh|jdkr.|jjddd�}t|jjd|�gS|jjdd�}t|jjd�}|j}t|d||f�gSdS)	zw
        Microsoft Windows SDK Libraries.

        Return
        ------
        list of str
            paths
        r9Tr�r�r�r�z%sum%sN)ryr[rRrr�r��_sdk_subdir)rCr�r�Zlibverrrr�OSLibraries�s

zEnvironmentInfo.OSLibrariescCsht|jjd�}|jdkr&|t|d�gS|jdkr8|j}nd}t|d|�t|d|�t|d|�gSd	S)
zu
        Microsoft Windows SDK Include.

        Return
        ------
        list of str
            paths
        �includer9Zglr0rz%ssharedz%sumz%swinrtN)rr�r�ryr�)rCr��sdkverrrr�
OSIncludes�s


�zEnvironmentInfo.OSIncludescCs�t|jjd�}g}|jdkr&||j7}|jdkr@|t|d�g7}|jdkr�||t|jjd�t|dd�t|d	d�t|d
d�t|jjddd
|jddd�g7}|S)z}
        Microsoft Windows SDK Libraries Paths.

        Return
        ------
        list of str
            paths
        Z
Referencesr7r�zCommonConfiguration\Neutralr0Z
UnionMetadataz'Windows.Foundation.UniversalApiContractz1.0.0.0z%Windows.Foundation.FoundationContractz,Windows.Networking.Connectivity.WwanContractZ
ExtensionSDKszMicrosoft.VCLibsr�ZCommonConfigurationZneutral)rr�r�ryr�)rC�ref�libpathrrr�	OSLibpath�s.






���zEnvironmentInfo.OSLibpathcCst|���S)zs
        Microsoft Windows SDK Tools.

        Return
        ------
        list of str
            paths
        )�list�
_sdk_toolsrFrrr�SdkToolss
zEnvironmentInfo.SdkToolsccs�|jdkr,|jdkrdnd}t|jj|�V|j��s\|jjdd�}d|}t|jj|�V|jdkr�|j��rvd	}n|jjddd
�}d|}t|jj|�VnB|jdkr�t|jjd�}|jjdd�}|jj}t|d||f�V|jj	r�|jj	Vd
S)z�
        Microsoft Windows SDK Tools paths generator.

        Return
        ------
        generator of str
            paths
        r�r�r�zBin\x86Tr�r�)r9r�rr�zBin\NETFX 4.0 Tools%sz%s%sN)
ryrr�r�r[rLrQrIr�r�)rCZbin_dirr�r�r�rrrr�s(	




zEnvironmentInfo._sdk_toolscCs|jj}|rd|SdS)zu
        Microsoft Windows SDK version subdir.

        Return
        ------
        str
            subdir
        �%s\r)r�r��rC�ucrtverrrrr�6s
zEnvironmentInfo._sdk_subdircCs|jdkrgSt|jjd�gS)zs
        Microsoft Windows SDK Setup.

        Return
        ------
        list of str
            paths
        r7ZSetup)ryrr�r�rFrrr�SdkSetupCs

zEnvironmentInfo.SdkSetupcs�|j}|j�|jdkr0d}|��o,|��}n$|��p>|��}|jdkpR|jdk}g}|rt|�fdd��jD�7}|r�|�fdd��jD�7}|S)zv
        Microsoft .NET Framework Tools.

        Return
        ------
        list of str
            paths
        r9TrAcsg|]}t�j|��qSr)rr��r�r+�r�rrr�hs�z+EnvironmentInfo.FxTools.<locals>.<listcomp>csg|]}t�j|��qSr)rr�r�r�rrr�ks�)	r[r�ryrIrLrKrGr�r�)rCr[Z	include32Z	include64r�rr�r�FxToolsRs"

��zEnvironmentInfo.FxToolscCs8|jdks|jjsgS|jjdd�}t|jjd|�gS)z~
        Microsoft .Net Framework SDK Libraries.

        Return
        ------
        list of str
            paths
        r0Tr�zlib\um%s)ryr�r�r[rRr)rCr�rrr�NetFxSDKLibrariesos
z!EnvironmentInfo.NetFxSDKLibrariescCs&|jdks|jjsgSt|jjd�gS)z}
        Microsoft .Net Framework SDK Includes.

        Return
        ------
        list of str
            paths
        r0z
include\um)ryr�r�rrFrrr�NetFxSDKIncludess
z EnvironmentInfo.NetFxSDKIncludescCst|jjd�gS)z�
        Microsoft Visual Studio Team System Database.

        Return
        ------
        list of str
            paths
        z
VSTSDB\Deployr�rFrrr�VsTDb�s
zEnvironmentInfo.VsTDbcCsv|jdkrgS|jdkr0|jj}|jjdd�}n|jj}d}d|j|f}t||�g}|jdkrr|t||d�g7}|S)zn
        Microsoft Build Engine.

        Return
        ------
        list of str
            paths
        r�r�Tr�rzMSBuild\%0.1f\bin%sZRoslyn)ryr�r�r[rQr�r)rC�	base_pathr�r�Zbuildrrr�MSBuild�s



zEnvironmentInfo.MSBuildcCs|jdkrgSt|jjd�gS)zt
        Microsoft HTML Help Workshop.

        Return
        ------
        list of str
            paths
        r�zHTML Help Workshop)ryrr�r�rFrrr�HTMLHelpWorkshop�s

z EnvironmentInfo.HTMLHelpWorkshopcCsD|jdkrgS|jjdd�}t|jjd�}|j}t|d||f�gS)z�
        Microsoft Universal C Runtime SDK Libraries.

        Return
        ------
        list of str
            paths
        r0Tr�r�z%sucrt%s)ryr[rRrr�r��_ucrt_subdir)rCr�r�r�rrr�
UCRTLibraries�s

zEnvironmentInfo.UCRTLibrariescCs.|jdkrgSt|jjd�}t|d|j�gS)z�
        Microsoft Universal C Runtime SDK Include.

        Return
        ------
        list of str
            paths
        r0r�z%sucrt)ryrr�r�r�)rCr�rrr�UCRTIncludes�s

zEnvironmentInfo.UCRTIncludescCs|jj}|rd|SdS)z�
        Microsoft Universal C Runtime SDK version subdir.

        Return
        ------
        str
            subdir
        r�r)r�r�r�rrrr��s
zEnvironmentInfo._ucrt_subdircCs(d|jkrdkrnngS|jjgS)zk
        Microsoft Visual F#.

        Return
        ------
        list of str
            paths
        r�r�)ryr�r�rFrrr�FSharp�s
zEnvironmentInfo.FSharpc
Cs�d|j}|jjdd��d�}g}|jj}t|�dd��}t|�rft	|t
|�d�}||t	|d�g7}|t	|d	�g7}d
|jdd
t|j�df}t
�||�D]&\}}t	||||�}	t|	�r�|	Sq�dS)
z
        Microsoft Visual C++ runtime redistributable dll.

        Return
        ------
        str
            path
        zvcruntime%d0.dllTr�rSz\Toolsz\Redistr8ZonecoreZredistzMicrosoft.VC%d.CRT�
N)rzr[rR�stripr�r�rrBrrr�intry�	itertools�productr)
rCZ	vcruntimer��prefixesZ
tools_pathZredist_pathZcrt_dirsr�Zcrt_dirr�rrr�VCRuntimeRedists 

�zEnvironmentInfo.VCRuntimeRedistTcCs�t|�d|j|j|j|jg|�|�d|j|j|j|j	|j
g|�|�d|j|j|j|jg|�|�d|j
|j|j|j|j|j|j|j|jg	|�d�}|jdkr�t|j�r�|j|d<|S)z�
        Return environment dict.

        Parameters
        ----------
        exists: bool
            It True, only return existing paths.

        Return
        ------
        dict
            environment
        r�r�r�r�)r�r�r�r��Zpy_vcruntime_redist)�dict�_build_pathsr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrr�)rC�exists�envrrrr)&sV�������	�� 
zEnvironmentInfo.return_envc
Csptj�|�}t�|d��t�}t�||�}|r<ttt	|��n|}|s\d|�
�}tj�
|��|�|�}	t�|	�S)aC
        Given an environment variable name and specified paths,
        return a pathsep-separated string of paths containing
        unique, extant, directories from those paths and from
        the environment variable. Raise an error if no paths
        are resolved.

        Parameters
        ----------
        name: str
            Environment variable name
        spec_path_lists: list of str
            Paths
        exists: bool
            It True, only return existing paths.

        Return
        ------
        str
            Pathsep-separated paths
        rz %s environment variable is empty)r��chain�
from_iterablerrWr�rr��filterr�upperr$r%r&�_unique_everseenr)
rCrmZspec_path_listsrZ
spec_pathsZ	env_pathsr�Zextant_pathsr�Zunique_pathsrrrr�Xs
zEnvironmentInfo._build_pathsccsbt�}|j}|dkr6t|j|�D]}||�|Vq n(|D]"}||�}||kr:||�|Vq:dS)z�
        List unique elements, preserving order.
        Remember all elements ever seen.

        _unique_everseen('AAAABBBCCDAABBB') --> A B C D

        _unique_everseen('ABBCcAD', str.lower) --> A B C D
        N)r|�addr
�__contains__)�iterabler�seenZseen_addZelement�krrrrzs

z EnvironmentInfo._unique_everseen)Nr)T)N)#rrrrVrDrXryrzr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r)r�r�rrrrrr(sn
	







$


 
#












"
2"r()r")r)*rVr��ior�osrrZos.pathrrrrr3�platformr�Zdistutils.errorsr$Z#setuptools.extern.packaging.versionr	Zsetuptools.extern.six.movesr
Zmonkeyr�systemrrr��ImportErrorr%r&Z_msvc9_suppress_errorsZdistutils.msvc9compilerrrr#r2r6r*r?rYrrr(rrrr�<module>sJ�	*
& 
$s5site-packages/setuptools/__pycache__/package_index.cpython-38.pyc000064400000100312151446177000021131 0ustar00U

�Qab���@s�dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
mZddlm
Z
ddlmZmZmZmZddlZddlmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!ddlm"Z"ddl#m$Z$dd	l%m&Z&dd
l'm(Z(ddl)m*Z*ddl+m,Z,dd
l-m.Z.e/Z0e�1d�Z2e�1dej3�Z4e�1d�Z5e�1dej3�j6Z7d�8�Z9ddddgZ:dZ;dZ<e<j=dj=ej>�ed�Z?dd�Z@dd�ZAdd�ZBdGd d�ZCdHd!d"�ZDdId#d$�ZEdedfd%d�ZFdJd&d'�ZGd(d)�ZHe�1d*ej3�ZIeHd+d,��ZJGd-d.�d.�ZKGd/d0�d0eK�ZLGd1d�de�ZMe�1d2�jNZOd3d4�ZPd5d6�ZQdKd7d8�ZRd9d:�ZSGd;d<�d<�ZTGd=d>�d>ejU�ZVejWjXfd?d@�ZYdAdB�ZZeRe;�eY�ZYdCdD�Z[dEdF�Z\dS)Lz#PyPI and direct package downloading�N��wraps)�six)�urllib�http_client�configparser�map)
�
CHECKOUT_DIST�Distribution�BINARY_DIST�normalize_path�SOURCE_DIST�Environment�find_distributions�	safe_name�safe_version�to_filename�Requirement�DEVELOP_DIST�EGG_DIST)�ssl_support)�log)�DistutilsError)�	translate)�get_all_headers)�unescape)�Wheelz^egg=([-A-Za-z0-9_.+!]+)$zhref\s*=\s*['"]?([^'"> ]+)z�<a href="([^"#]+)">([^<]+)</a>\n\s+\(<a (?:title="MD5 hash"\n\s+)href="[^?]+\?:action=show_md5&amp;digest=([0-9a-f]{32})">md5</a>\)z([-+.a-z0-9]{2,}):z.tar.gz .tar.bz2 .tar .zip .tgz�PackageIndex�distros_for_url�parse_bdist_wininst�interpret_distro_name�z<setuptools/{setuptools.__version__} Python-urllib/{py_major}z{}.{})Zpy_major�
setuptoolscCs4zt�|�WStk
r.td|f��YnXdS)Nz1Not a URL, existing file, or requirement spec: %r)r�parse�
ValueErrorr)�spec�r&�</usr/lib/python3.8/site-packages/setuptools/package_index.py�parse_requirement_arg4s�r(cCs�|��}d\}}}|�d�r�|�d�r8|dd�}d}nn|�dd�rb|d	d
�}|dd�}d}nD|�d�r~|dd�}d
}n(|�dd�r�|d	d
�}|dd�}d
}|||fS)z=Return (base,pyversion) or (None,None) for possible .exe name)NNN�.exez
.win32.exeNi����Zwin32z	.win32-pyi�i�������z.win-amd64.exei�z	win-amd64z
.win-amd64-pyi��)�lower�endswith�
startswith)�namer+�base�py_verZplatr&r&r'r=s$



c	Csxtj�|�}|\}}}}}}tj�|�d�d�}|dkrX|dkrXtj�|�d�d�}d|krp|�dd�\}}||fS)N�/���zsourceforge.net�download����#�)rr#�urlparse�unquote�split)	�url�parts�scheme�server�pathZ
parameters�query�fragmentr/r&r&r'�egg_info_for_urlUsrAccs\t|�\}}t|||�D]
}|Vq|rXt�|�}|rXt||�d�|td�D]
}|VqLdS)zEYield egg or source distribution objects that might be found at a URLr6)�
precedenceN)rA�distros_for_location�EGG_FRAGMENT�matchr �groupr	)r:�metadatar/r@�distrEr&r&r'r`s
�
cCs�|�d�r|dd�}|�d�r8d|kr8t�|||�gS|�d�rxd|krxt|�}|��s^gSt||j|jtdd�gS|�d	�r�t|�\}}}|dk	r�t	||||t
|�StD]0}|�|�r�|dt|��}t	|||�Sq�gS)
z:Yield egg or source distribution objects based on basename�.egg.zipNr*z.egg�-z.whlr6)�location�project_name�versionrBr))
r,r
Z
from_locationrZ
is_compatiblerLrMrrr r�
EXTENSIONS�len)rK�basenamerGZwheelZwin_baser0�platformZextr&r&r'rCns<
�
�
rCcCstt|�tj�|�|�S)zEYield possible egg or source distribution objects based on a filename)rCr�osr>rP)�filenamerGr&r&r'�distros_for_filename�s

�rTc
cs||�d�}|s,tdd�|dd�D��r,dStdt|�d�D]8}t||d�|d|��d�||d��|||d�Vq>dS)z�Generate alternative interpretations of a source distro name

    Note: if `location` is a filesystem filename, you should call
    ``pkg_resources.normalize_path()`` on it before passing it to this
    routine!
    rJcss|]}t�d|�VqdS)z	py\d\.\d$N)�rerE)�.0�pr&r&r'�	<genexpr>�sz(interpret_distro_name.<locals>.<genexpr>�Nr6)�
py_versionrBrQ)r9�any�rangerOr
�join)rKrPrGrZrBrQr;rWr&r&r'r �s
�ccsft�}|j}|dkr:tj�|j|�D]}||�|Vq$n(|D]"}||�}||kr>||�|Vq>dS)zHList unique elements, preserving order. Remember all elements ever seen.N)�set�addrZmoves�filterfalse�__contains__)�iterable�key�seenZseen_addZelement�kr&r&r'�unique_everseen�s
rfcst���fdd��}|S)zs
    Wrap a function returning an iterable such that the resulting iterable
    only ever yields unique items.
    cst�||��S�N)rf)�args�kwargs��funcr&r'�wrapper�szunique_values.<locals>.wrapperr)rkrlr&rjr'�
unique_values�srmz(<([^>]*\srel\s*=\s*['"]?([^'">]+)[^>]*)>c	cs�t�|�D]d}|��\}}tttj|���d���}d|ksDd|kr
t	�|�D]}t
j�|t
|�d���VqNq
dD]@}|�|�}|dkrtt	�||�}|rtt
j�|t
|�d���VqtdS)zEFind rel="homepage" and rel="download" links in `page`, yielding URLs�,Zhomepager3r6)z
<th>Home Pagez<th>Download URLr2N)�REL�finditer�groupsr^r�str�stripr+r9�HREFrr#�urljoin�
htmldecoderF�find�search)r:�pagerE�tagZrelZrels�posr&r&r'�find_external_links�s
r|c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�ContentCheckerzP
    A null content checker that defines the interface for checking content
    cCsdS)z3
        Feed a block of data to the hash.
        Nr&��self�blockr&r&r'�feed�szContentChecker.feedcCsdS)zC
        Check the hash. Return False if validation fails.
        Tr&�rr&r&r'�is_valid�szContentChecker.is_validcCsdS)zu
        Call reporter with information about the checker (hash name)
        substituted into the template.
        Nr&)r�reporter�templater&r&r'�reportszContentChecker.reportN)�__name__�
__module__�__qualname__�__doc__r�r�r�r&r&r&r'r}�sr}c@sBeZdZe�d�Zdd�Zedd��Zdd�Z	dd	�Z
d
d�ZdS)
�HashCheckerzK(?P<hash_name>sha1|sha224|sha384|sha256|sha512|md5)=(?P<expected>[a-f0-9]+)cCs||_t�|�|_||_dSrg)�	hash_name�hashlib�new�hash�expected)rr�r�r&r&r'�__init__szHashChecker.__init__cCs>tj�|�d}|st�S|j�|�}|s0t�S|f|���S)z5Construct a (possibly null) ContentChecker from a URLr2)rr#r7r}�patternrx�	groupdict)�clsr:r@rEr&r&r'�from_urlszHashChecker.from_urlcCs|j�|�dSrg)r��updater~r&r&r'r�szHashChecker.feedcCs|j��|jkSrg)r�Z	hexdigestr�r�r&r&r'r�"szHashChecker.is_validcCs||j}||�Srg)r�)rr�r��msgr&r&r'r�%s
zHashChecker.reportN)r�r�r�rU�compiler�r��classmethodr�r�r�r�r&r&r&r'r�	s�

r�cs<eZdZdZdJdd�ZdKd	d
�ZdLdd�ZdMd
d�Zdd�Zdd�Z	dd�Z
dd�ZdNdd�Zdd�Z
dO�fdd�	Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�ZdPd'd(�ZdQd)d*�Zd+d,�Zd-Zd.d/�Zd0d1�ZdRd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Ze dSd>d?��Z!d@dA�Z"dBdC�Z#dDdE�Z$dFdG�Z%dHdI�Z&�Z'S)Trz;A distribution index that scans web pages for download URLs�https://pypi.org/simple/��*NTcOs�tj|f|�|�|dd|�d��|_i|_i|_i|_t�d�	t
t|���j|_
g|_|ortjor|prt��}|r�t�|�|_n
tjj|_dS)Nr1�|)rr�r,�	index_url�scanned_urls�fetched_urls�
package_pagesrUr�r]rrrE�allows�to_scanrZis_availableZfind_ca_bundleZ
opener_for�openerr�request�urlopen)rr�ZhostsZ	ca_bundleZ
verify_sslrh�kwZuse_sslr&r&r'r�-s�
�zPackageIndex.__init__FcCs�||jkr|sdSd|j|<t|�s2|�|�dStt|��}|r\|�|�sPdS|�d|�|sn|rn||jkr�tt|j	|��dS|�|�s�d|j|<dS|�
d|�d|j|<d}|�|||�}|dkr�dSd|j|j<d|j
�dd���k�r|��dS|j}|��}t|t��sNt|tjj��r0d	}n|j
�d
��p@d	}|�|d�}|��t�|�D](}	tj�|t|	�d���}
|�|
��q`|� |j!��r�t"|d
d�dk�r�|�#||�}dS)z<Evaluate a URL as a possible download, and maybe retrieve itNTzFound link: %sz
Reading %sz<Download error on %s: %%s -- Some packages may not be found!�html�content-type�zlatin-1�charset�ignorer6�code�)$r��
URL_SCHEME�process_filename�listr�url_ok�debugr�rr_�info�open_urlr:�headers�getr+�close�read�
isinstancerrr�error�	HTTPErrorZ	get_param�decodertrpr#rurvrF�process_urlr-r��getattr�
process_index)rr:Zretrieve�dists�tmpl�fr/ryr�rE�linkr&r&r'r�BsP





 zPackageIndex.process_urlcCs�tj�|�s|�d|�dStj�|�r^|s^tj�|�}t�|�D]}|�tj�||�d�qBt	|�}|r�|�
d|�tt|j
|��dS)Nz
Not found: %sTz	Found: %s)rRr>�exists�warn�isdir�realpath�listdirr�r]rTr�r�rr_)r�fn�nestedr>�itemr�r&r&r'r�uszPackageIndex.process_filenamecCsbt|�}|o|�d���dk}|s8|�tj�|�d�r<dSd}|rRt||��n|�||�dS)Nr6�fileTzN
Note: Bypassing %s (disallowed host; see http://bit.ly/2hrImnY for details).
)	r�rFr+r�rr#r7rr�)rr:Zfatal�s�is_filer�r&r&r'r��s�zPackageIndex.url_okcCs2ttjj|�}dd�|D�}tt�|j|��dS)Ncss0|](}t�|�D]}|�d�r||fVqqdS)z	.egg-linkN)rRr�r,)rVr>�entryr&r&r'rX�s

�z.PackageIndex.scan_egg_links.<locals>.<genexpr>)�filterrRr>r�r��	itertools�starmap�
scan_egg_link)rZsearch_path�dirsZ	egg_linksr&r&r'�scan_egg_links�s
�zPackageIndex.scan_egg_linksc	Cs�ttj�||���}ttdttj|���}W5QRXt	|�dkrDdS|\}}t
tj�||��D](}tjj|f|��|_t|_
|�|�q^dS)NrY)�openrRr>r]r�r�rrrrsrOrrKr
rBr_)rr>r�Z	raw_lines�linesZegg_pathZ
setup_pathrHr&r&r'r��s zPackageIndex.scan_egg_linkc
	s��fdd�}t�|�D]:}z |tj�|t|�d����Wqtk
rNYqXq||�\}}|r�t||�D]H}t	|�\}}	|�
d�r�|	s�|r�|d||f7}n
��|���|�qlt
�dd�|�SdSd	S)
z#Process the contents of a PyPI pagecs�|��j�r�tttjj|t�j�d��d���}t|�dkr�d|dkr�t	|d�}t
|d�}d�j�|�
�i�|<t|�t|�fSdS)Nr1rYr5r6rT)NN)r-r�r�rrr#r8rOr9rrr��
setdefaultr+r)r�r;�pkg�verr�r&r'�scan�s�z(PackageIndex.process_index.<locals>.scanr6�.pyz
#egg=%s-%scSsd|�ddd�S)Nz<a href="%s#md5=%s">%s</a>r6�rY)rF)�mr&r&r'�<lambda>��z,PackageIndex.process_index.<locals>.<lambda>r�N)rtrprr#rurvrFr$r|rAr,�need_version_info�scan_url�PYPI_MD5�sub)
rr:ryr�rEr�r��new_urlr/�fragr&r�r'r��s( 
�zPackageIndex.process_indexcCs|�d|�dS)NzPPage at %s links to .py file(s) without version info; an index scan is required.)�scan_all�rr:r&r&r'r��s�zPackageIndex.need_version_infocGs:|j|jkr*|r |j|f|��|�d�|�|j�dS)Nz6Scanning index of all packages (this may take a while))r�r�r�r�r��rr�rhr&r&r'r��s�zPackageIndex.scan_allcCsz|�|j|jd�|j�|j�s:|�|j|jd�|j�|j�sR|�|�t|j�|jd��D]}|�|�qfdS)Nr1r&)	r�r��unsafe_namer�r�rcrL�not_found_in_indexr�)r�requirementr:r&r&r'�
find_packages�s
zPackageIndex.find_packagescsR|��|�|�||jD]"}||kr0|S|�d||�qtt|��||�S)Nz%s does not match %s)�prescanr�rcr��superr�obtain)rr�Z	installerrH��	__class__r&r'r��s
zPackageIndex.obtaincCsL|�|jd|�|��sH|��t�|�td|jjtj	�
|�f��dS)z-
        checker is a ContentChecker
        zValidating %%s checksum for %sz7%s validation failed for %s; possible download problem?N)r�r�r�r�rR�unlinkrr�r.r>rP)r�checkerrS�tfpr&r&r'�
check_hash�s�
��zPackageIndex.check_hashcCsN|D]D}|jdks0t|�r0|�d�s0tt|��r<|�|�q|j�|�qdS)z;Add `urls` to the list that will be prescanned for searchesN�file:)r�r�r-r�rr��append)rZurlsr:r&r&r'�add_find_linkss���
�zPackageIndex.add_find_linkscCs"|jrtt|j|j��d|_dS)z7Scan urls scheduled for prescanning (e.g. --find-links)N)r�r�rr�r�r&r&r'r�szPackageIndex.prescancCs<||jr|jd}}n|jd}}|||j�|��dS)Nz#Couldn't retrieve index page for %rz3Couldn't find index page for %r (maybe misspelled?))rcr�r�r�r�)rr�Zmethr�r&r&r'r�#s
�zPackageIndex.not_found_in_indexcCs~t|t�sjt|�}|rR|�|�d�||�}t|�\}}|�d�rN|�|||�}|Stj	�
|�rb|St|�}t|�
||�dd�S)aLocate and/or download `spec` to `tmpdir`, returning a local path

        `spec` may be a ``Requirement`` object, or a string containing a URL,
        an existing local filename, or a project/version requirement spec
        (i.e. the string form of a ``Requirement`` object).  If it is the URL
        of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one
        that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is
        automatically created alongside the downloaded file.

        If `spec` is a ``Requirement`` object or a string containing a
        project/version requirement spec, this method returns the location of
        a matching distribution (possibly after downloading it to `tmpdir`).
        If `spec` is a locally existing file or directory name, it is simply
        returned unchanged.  If `spec` is a URL, it is downloaded to a subpath
        of `tmpdir`, and the local filename is returned.  Various errors may be
        raised if a problem occurs during downloading.
        r6r�rKN)r�rr��
_download_urlrFrAr,�	gen_setuprRr>r�r(r��fetch_distribution)rr%�tmpdirr<�foundr/r@r&r&r'r3-s

zPackageIndex.downloadc	s���d|�i�d}d
�����fdd�	}|rH�����|�||�}|s^|dk	r^|||�}|dkr��jdk	rx���||�}|dkr�|s���|�||�}|dkr���d�r�dp�d|�n��d|�|j|jd	�SdS)a|Obtain a distribution suitable for fulfilling `requirement`

        `requirement` must be a ``pkg_resources.Requirement`` instance.
        If necessary, or if the `force_scan` flag is set, the requirement is
        searched for in the (online) package index as well as the locally
        installed packages.  If a distribution matching `requirement` is found,
        the returned distribution's ``location`` is the value you would have
        gotten from calling the ``download()`` method with the matching
        distribution's URL or filename.  If no matching distribution is found,
        ``None`` is returned.

        If the `source` flag is set, only source distributions and source
        checkout links will be considered.  Unless the `develop_ok` flag is
        set, development and system eggs (i.e., those using the ``.egg-info``
        format) will be ignored.
        zSearching for %sNcs�|dkr�}||jD]v}|jtkrF�sF|�kr��d|�d�|<q||ko\|jtkp\�}|r��|j��}||_tj	�
|j�r|SqdS)Nz&Skipping development or system egg: %sr6)rcrBrr�r
r3rK�download_locationrRr>r�)Zreq�envrHZtestZloc��
develop_okrZskipped�sourcer�r&r'rwgs&��z-PackageIndex.fetch_distribution.<locals>.findz:No local packages or working download links found for %s%sza source distribution of r�zBest match: %s)rK)N)r�r�r�r�r�Zcloner)	rr�r��
force_scanrrZlocal_indexrHrwr&rr'r�Os2




�zPackageIndex.fetch_distributioncCs"|�||||�}|dk	r|jSdS)a3Obtain a file suitable for fulfilling `requirement`

        DEPRECATED; use the ``fetch_distribution()`` method now instead.  For
        backward compatibility, this routine is identical but returns the
        ``location`` of the downloaded distribution instead of a distribution
        object.
        N)r�rK)rr�r�rrrHr&r&r'�fetch�szPackageIndex.fetchc
	Cs�t�|�}|r*dd�t||�d�d�D�p,g}t|�dkr�tj�|�}tj�|�|kr�tj�	||�}ddl
m}|||�s�t�
||�|}ttj�	|d�d��2}	|	�d|dj|djtj�|�df�W5QRX|S|r�td	||f��ntd
��dS)NcSsg|]}|jr|�qSr&)rM)rV�dr&r&r'�
<listcomp>�s�z*PackageIndex.gen_setup.<locals>.<listcomp>r6r)�samefilezsetup.py�wzIfrom setuptools import setup
setup(name=%r, version=%r, py_modules=[%r])
z�Can't unambiguously interpret project/version identifier %r; any dashes in the name or version should be escaped using underscores. %rzpCan't process plain .py files without an '#egg=name-version' suffix to enable automatic setup script generation.)rDrEr rFrOrRr>rP�dirnamer]Zsetuptools.command.easy_installr	�shutilZcopy2r��writerLrM�splitextr)
rrSr@r�rEr�rPZdstr	r�r&r&r'r��sB

��
������zPackageIndex.gen_setupi c	Cs|�d|�d}z�t�|�}|�|�}t|tjj�rJt	d||j
|jf��|��}d}|j}d}d|kr�t
|d�}	ttt|	��}|�|||||�t|d��V}
|�|�}|r�|�|�|
�|�|d7}|�|||||�q�q�q�|�|||
�W5QRX|W�S|�r|��XdS)	NzDownloading %szCan't download %s: %s %srr2zcontent-lengthzContent-Length�wbr6)r�r�r�r�r�r�rr�r�rr�r��dl_blocksizer�maxr�int�
reporthookr�r�r�r
r�)rr:rS�fpr�r��blocknumZbs�sizeZsizesr�r�r&r&r'�_download_to�s:

�



zPackageIndex._download_tocCsdSrgr&)rr:rSrZblksizerr&r&r'r�szPackageIndex.reporthookc
Cs�|�d�rt|�Szt||j�WSttjfk
r�}z<d�dd�|jD��}|r`|�	||�nt
d||f��W5d}~XY�ntjj
k
r�}z|WY�Sd}~XYn�tjjk
�r�}z*|r�|�	||j�nt
d||jf��W5d}~XYn�tjk
�rF}z,|�r$|�	||j�nt
d||jf��W5d}~XYnPtjtjfk
�r�}z(|�rt|�	||�nt
d||f��W5d}~XYnXdS)Nr�� cSsg|]}t|��qSr&)rr)rV�argr&r&r'rsz)PackageIndex.open_url.<locals>.<listcomp>z%s %szDownload error for %s: %sz;%s returned a bad status line. The server might be down, %s)r-�
local_open�open_with_authr�r$r�
InvalidURLr]rhr�rrr�r�ZURLError�reasonZ
BadStatusLine�lineZ
HTTPException�socket)rr:Zwarning�vr�r&r&r'r��s>
"����zPackageIndex.open_urlcCs�t|�\}}|r0d|kr4|�dd��dd�}qnd}|�d�rJ|dd�}tj�||�}|dksj|�d	�rv|�||�S|d
ks�|�d�r�|�||�S|�d�r�|�	||�S|d
kr�t
j�t
j
�|�d�S|�|d�|�||�SdS)Nz..�.�\�_Z__downloaded__rIr*Zsvnzsvn+Zgitzgit+zhg+r�rYT)rA�replacer,rRr>r]r-�
_download_svn�
_download_git�_download_hgrr��url2pathnamer#r7r��_attempt_download)rr<r:r�r.r@rSr&r&r'r�s$

zPackageIndex._download_urlcCs|�|d�dS)NT)r�r�r&r&r'r�:szPackageIndex.scan_urlcCs6|�||�}d|�dd���kr.|�|||�S|SdS)Nr�r�r�)rr�r+�_download_html)rr:rSr�r&r&r'r)=szPackageIndex._attempt_downloadcCsnt|�}|D]>}|��rt�d|�rF|��t�|�|�||�SqLq|��t�|�td|��dS)Nz <title>([^- ]+ - )?Revision \d+:zUnexpected HTML page found at )	r�rsrUrxr�rRr�r%r)rr:r�rSr�rr&r&r'r*Ds

zPackageIndex._download_htmlcCst�dt�|�dd�d}d}|���d�r�d|kr�tj�|�\}}}}}}	|s�|�d�r�d	|d
d�kr�|d
d��d	d�\}}t	|�\}
}|
r�d|
kr�|
�dd�\}}
d||
f}nd
|
}|}||||||	f}tj�
|�}|�d||�t�
d|||f�|S)Nz"SVN download support is deprecatedr5r6rr�zsvn:�@z//r1rY�:z --username=%s --password=%sz --username=z'Doing subversion checkout from %s to %szsvn checkout%s -q %s %s)�warningsr��UserWarningr9r+r-rr#r7�
_splituser�
urlunparser�rR�system)rr:rSZcredsr<�netlocr>rW�qr��auth�host�userZpwr;r&r&r'r%Ss&zPackageIndex._download_svncCsptj�|�\}}}}}|�dd�d}|�dd�d}d}d|krR|�dd�\}}tj�||||df�}||fS)N�+r6r2r5rr+r�)rr#Zurlsplitr9�rsplitZ
urlunsplit)r:�
pop_prefixr<r2r>r?r��revr&r&r'�_vcs_split_rev_from_urlisz$PackageIndex._vcs_split_rev_from_urlcCsl|�dd�d}|j|dd�\}}|�d||�t�d||f�|dk	rh|�d|�t�d	||f�|S)
Nr5r6rT�r9zDoing git clone from %s to %szgit clone --quiet %s %szChecking out %szgit -C %s checkout --quiet %s�r9r;r�rRr1�rr:rSr:r&r&r'r&{s�zPackageIndex._download_gitcCsl|�dd�d}|j|dd�\}}|�d||�t�d||f�|dk	rh|�d|�t�d	||f�|S)
Nr5r6rTr<zDoing hg clone from %s to %szhg clone --quiet %s %szUpdating to %szhg --cwd %s up -C -r %s -qr=r>r&r&r'r'�s�zPackageIndex._download_hgcGstj|f|��dSrg)rr�r�r&r&r'r��szPackageIndex.debugcGstj|f|��dSrg)rr�r�r&r&r'r��szPackageIndex.infocGstj|f|��dSrg)rr�r�r&r&r'r��szPackageIndex.warn)r�r�NT)F)F)F)N)N)FFFN)FF)N)F)(r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r3r�rr�rrrr�r�r�r)r*r%�staticmethodr;r&r'r�r�r��
__classcell__r&r&r�r'r*sX�

3



+
		
#�
L

)$
#z!&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?cCs|�d�}t|�S)Nr)rFr)rEZwhatr&r&r'�
decode_entity�s
rAcCs
tt|�S)a
    Decode HTML entities in the given text.

    >>> htmldecode(
    ...     'https://../package_name-0.1.2.tar.gz'
    ...     '?tokena=A&amp;tokenb=B">package_name-0.1.2.tar.gz')
    'https://../package_name-0.1.2.tar.gz?tokena=A&tokenb=B">package_name-0.1.2.tar.gz'
    )�
entity_subrA)�textr&r&r'rv�s	rvcs�fdd�}|S)Ncs��fdd�}|S)Nc	s2t��}t���z�||�W�St�|�XdSrg)rZgetdefaulttimeoutZsetdefaulttimeout)rhriZold_timeout)rk�timeoutr&r'�_socket_timeout�s

z@socket_timeout.<locals>._socket_timeout.<locals>._socket_timeoutr&)rkrE�rDrjr'rE�sz'socket_timeout.<locals>._socket_timeoutr&)rDrEr&rFr'�socket_timeout�srGcCs2tj�|�}|��}t�|�}|��}|�dd�S)aq
    A function compatible with Python 2.3-3.3 that will encode
    auth from a URL suitable for an HTTP header.
    >>> str(_encode_auth('username%3Apassword'))
    'dXNlcm5hbWU6cGFzc3dvcmQ='

    Long auth strings should not cause a newline to be inserted.
    >>> long_auth = 'username:' + 'password'*10
    >>> chr(10) in str(_encode_auth(long_auth))
    False
    �
r�)rr#r8�encode�base64Z	b64encoder�r$)r4Zauth_sZ
auth_bytesZ
encoded_bytesZencodedr&r&r'�_encode_auth�s

rKc@s(eZdZdZdd�Zdd�Zdd�ZdS)	�
Credentialz:
    A username/password pair. Use like a namedtuple.
    cCs||_||_dSrg��username�password)rrNrOr&r&r'r��szCredential.__init__ccs|jV|jVdSrgrMr�r&r&r'�__iter__�szCredential.__iter__cCsdt|�S)Nz%(username)s:%(password)s)�varsr�r&r&r'�__str__�szCredential.__str__N)r�r�r�r�r�rPrRr&r&r&r'rL�srLc@s0eZdZdd�Zedd��Zdd�Zdd�Zd	S)
�
PyPIConfigcCsPt�dddgd�}tj�||�tj�tj�d�d�}tj�	|�rL|�
|�dS)z%
        Load from ~/.pypirc
        rNrO�
repositoryr��~z.pypircN)�dict�fromkeysr�RawConfigParserr�rRr>r]�
expanduserr�r�)r�defaultsZrcr&r&r'r��s
zPyPIConfig.__init__cs&�fdd����D�}tt�j|��S)Ncs g|]}��|d���r|�qS)rT)r�rs)rV�sectionr�r&r'r�s�z2PyPIConfig.creds_by_repository.<locals>.<listcomp>)ZsectionsrVr�_get_repo_cred)rZsections_with_repositoriesr&r�r'�creds_by_repository�s
�zPyPIConfig.creds_by_repositorycCs6|�|d���}|t|�|d���|�|d����fS)NrTrNrO)r�rsrL)rr[Zrepor&r&r'r\s
�zPyPIConfig._get_repo_credcCs*|j��D]\}}|�|�r
|Sq
dS)z�
        If the URL indicated appears to be a repository defined in this
        config, return the credential for that repository.
        N)r]�itemsr-)rr:rT�credr&r&r'�find_credential
s
zPyPIConfig.find_credentialN)r�r�r�r��propertyr]r\r`r&r&r&r'rS�s

rScCs:tj�|�}|\}}}}}}|�d�r0t�d��|dkrFt|�\}	}
nd}	|	s~t��|�}|r~t	|�}	|j
|f}tjd	|��|	r�dt
|	�}	||
||||f}
tj�|
�}tj�|�}|�d|	�ntj�|�}|�dt�||�}|	�r6tj�|j�\}}}}}}||k�r6||
k�r6||||||f}
tj�|
�|_|S)
z4Open a urllib2 request, handling HTTP authenticationr,znonnumeric port: '')ZhttpZhttpsN�*Authenticating as %s for %s (from .pypirc)zBasic Z
Authorizationz
User-Agent)rb)rr#r7r,rrr/rSr`rrrNrr�rKr0r�ZRequestZ
add_header�
user_agentr:)r:r�Zparsedr<r2r>Zparamsr?r�r4Zaddressr_r�r;r�r�r�s2Zh2Zpath2Zparam2Zquery2Zfrag2r&r&r'rs8


rcCs |�d�\}}}|r|nd|fS)zJsplituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.r+N)�
rpartition)r5r6Zdelimr&r&r'r/Fsr/cCs|Srgr&)r:r&r&r'�
fix_sf_urlPsrfc
Cstj�|�\}}}}}}tj�|�}tj�|�r<tj�|�S|�	d�r�tj�
|�r�g}t�|�D]d}	tj�||	�}
|	dkr�t
|
d��}|��}W5QRXq�ntj�
|
�r�|	d7}	|�dj|	d��q`d}
|
j|d�|�d�}d	\}}n
d
\}}}ddi}t�|�}tj�|||||�S)
z7Read a local path, with special support for directoriesr1z
index.html�rz<a href="{name}">{name}</a>)r.zB<html><head><title>{url}</title></head><body>{files}</body></html>rH)r:�files)��ZOK)r�zPath not foundz	Not foundr�z	text/html)rr#r7r�r(rRr>�isfiler�r,r�r�r]r�r�r��formatr�StringIOr�r�)r:r<r=r>Zparamr?r�rSrhr��filepathrZbodyr�Zstatus�messager�Zbody_streamr&r&r'rTs.�


r)N)N)N)N)r!)]r��sysrRrUrrrJr�r�r-�	functoolsrZsetuptools.externrZsetuptools.extern.six.movesrrrrr"Z
pkg_resourcesr	r
rrr
rrrrrrrrrZ	distutilsrZdistutils.errorsrZfnmatchrZsetuptools.py27compatrZsetuptools.py33compatrZsetuptools.wheelr�typeZ
__metaclass__r�rD�Irtr�rEr�r9rN�__all__Z_SOCKET_TIMEOUTZ_tmplrk�version_inforcr(rrArrCrTr rfrmror|r}r�rr�rBrArvrGrKrLrXrSr�r�rr/rfrr&r&r&r'�<module>s�<
��	

!
�
$


!
&/site-packages/setuptools/__pycache__/unicode_utils.cpython-38.opt-1.pyc000064400000002177151446177000022166 0ustar00U

�Qab��@s8ddlZddlZddlmZdd�Zdd�Zdd�ZdS)	�N)�sixcCsVt|tj�rt�d|�Sz$|�d�}t�d|�}|�d�}Wntk
rPYnX|S)NZNFD�utf-8)�
isinstancer�	text_type�unicodedataZ	normalize�decode�encode�UnicodeError)�path�r�</usr/lib/python3.8/site-packages/setuptools/unicode_utils.py�	decomposes
r
c	Cs\t|tj�r|St��pd}|df}|D].}z|�|�WStk
rTYq(Yq(Xq(dS)zY
    Ensure that the given path is decoded,
    NONE when no expected encoding works
    rN)rrr�sys�getfilesystemencodingr�UnicodeDecodeError)r
Zfs_encZ
candidates�encrrr�filesys_decodesrcCs(z|�|�WStk
r"YdSXdS)z/turn unicode encoding into a functional routineN)r�UnicodeEncodeError)�stringrrrr�
try_encode'sr)rrZsetuptools.externrr
rrrrrr�<module>s
site-packages/setuptools/__pycache__/_deprecation_warning.cpython-38.opt-1.pyc000064400000001004151446177000023465 0ustar00U

�Qab��@sGdd�de�ZdS)c@seZdZdZdS)�SetuptoolsDeprecationWarningz�
    Base class for warning deprecations in ``setuptools``

    This class is not derived from ``DeprecationWarning``, and as such is
    visible by default.
    N)�__name__�
__module__�__qualname__�__doc__�rr�C/usr/lib/python3.8/site-packages/setuptools/_deprecation_warning.pyrsrN)�Warningrrrrr�<module>�site-packages/setuptools/__pycache__/_imp.cpython-38.opt-1.pyc000064400000003542151446177000020241 0ustar00U

�Qab��@s\dZddlZddlZddlZddlmZdZdZdZ	dZ
dZdd	d
�Zddd�Z
d
d�ZdS)zX
Re-implementation of find_module and get_frozen_object
from the deprecated imp module.
�N�)�module_from_spec����c	CsVtj�||�}|dkr"td|��|jsBt|d�rBtj�d|j�}d}d}t|jt	�}|j
dkst|r�t|jtjj
�r�t}d}d}}n�|j
dks�|r�t|jtjj�r�t}d}d}}n�|j�r:|j
}tj�|�d	}|tjjkr�d
nd}|tjjkr�t}n&|tjjk�rt}n|tjjk�r t}|tthk�rFt||�}nd}d}}|||||ffS)z7Just like 'imp.find_module()', but with package supportN�
Can't find %s�submodule_search_locationsz__init__.py����frozen�zbuilt-inr�r�rb)�	importlib�util�	find_spec�ImportError�has_location�hasattr�spec_from_loader�loader�
isinstance�type�origin�
issubclass�	machinery�FrozenImporter�	PY_FROZEN�BuiltinImporter�	C_BUILTIN�os�path�splitext�SOURCE_SUFFIXES�	PY_SOURCE�BYTECODE_SUFFIXES�PY_COMPILED�EXTENSION_SUFFIXES�C_EXTENSION�open)	�module�paths�specZkind�fileZstaticr!�suffix�mode�r0�3/usr/lib/python3.8/site-packages/setuptools/_imp.py�find_modulesJ�
�
r2cCs*tj�||�}|std|��|j�|�S�Nr)rrrrr�get_code)r*r+r,r0r0r1�get_frozen_object>sr5cCs&tj�||�}|std|��t|�Sr3)rrrrr)r*r+�infor,r0r0r1�
get_moduleEsr7)N)N)�__doc__r �importlib.utilrZimportlib.machineryZ
py34compatrr$r&r(rrr2r5r7r0r0r0r1�<module>s
*
site-packages/setuptools/__pycache__/package_index.cpython-38.opt-1.pyc000064400000100312151446177000022070 0ustar00U

�Qab���@s�dZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
mZddlm
Z
ddlmZmZmZmZddlZddlmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!ddlm"Z"ddl#m$Z$dd	l%m&Z&dd
l'm(Z(ddl)m*Z*ddl+m,Z,dd
l-m.Z.e/Z0e�1d�Z2e�1dej3�Z4e�1d�Z5e�1dej3�j6Z7d�8�Z9ddddgZ:dZ;dZ<e<j=dj=ej>�ed�Z?dd�Z@dd�ZAdd�ZBdGd d�ZCdHd!d"�ZDdId#d$�ZEdedfd%d�ZFdJd&d'�ZGd(d)�ZHe�1d*ej3�ZIeHd+d,��ZJGd-d.�d.�ZKGd/d0�d0eK�ZLGd1d�de�ZMe�1d2�jNZOd3d4�ZPd5d6�ZQdKd7d8�ZRd9d:�ZSGd;d<�d<�ZTGd=d>�d>ejU�ZVejWjXfd?d@�ZYdAdB�ZZeRe;�eY�ZYdCdD�Z[dEdF�Z\dS)Lz#PyPI and direct package downloading�N��wraps)�six)�urllib�http_client�configparser�map)
�
CHECKOUT_DIST�Distribution�BINARY_DIST�normalize_path�SOURCE_DIST�Environment�find_distributions�	safe_name�safe_version�to_filename�Requirement�DEVELOP_DIST�EGG_DIST)�ssl_support)�log)�DistutilsError)�	translate)�get_all_headers)�unescape)�Wheelz^egg=([-A-Za-z0-9_.+!]+)$zhref\s*=\s*['"]?([^'"> ]+)z�<a href="([^"#]+)">([^<]+)</a>\n\s+\(<a (?:title="MD5 hash"\n\s+)href="[^?]+\?:action=show_md5&amp;digest=([0-9a-f]{32})">md5</a>\)z([-+.a-z0-9]{2,}):z.tar.gz .tar.bz2 .tar .zip .tgz�PackageIndex�distros_for_url�parse_bdist_wininst�interpret_distro_name�z<setuptools/{setuptools.__version__} Python-urllib/{py_major}z{}.{})Zpy_major�
setuptoolscCs4zt�|�WStk
r.td|f��YnXdS)Nz1Not a URL, existing file, or requirement spec: %r)r�parse�
ValueErrorr)�spec�r&�</usr/lib/python3.8/site-packages/setuptools/package_index.py�parse_requirement_arg4s�r(cCs�|��}d\}}}|�d�r�|�d�r8|dd�}d}nn|�dd�rb|d	d
�}|dd�}d}nD|�d�r~|dd�}d
}n(|�dd�r�|d	d
�}|dd�}d
}|||fS)z=Return (base,pyversion) or (None,None) for possible .exe name)NNN�.exez
.win32.exeNi����Zwin32z	.win32-pyi�i�������z.win-amd64.exei�z	win-amd64z
.win-amd64-pyi��)�lower�endswith�
startswith)�namer+�base�py_verZplatr&r&r'r=s$



c	Csxtj�|�}|\}}}}}}tj�|�d�d�}|dkrX|dkrXtj�|�d�d�}d|krp|�dd�\}}||fS)N�/���zsourceforge.net�download����#�)rr#�urlparse�unquote�split)	�url�parts�scheme�server�pathZ
parameters�query�fragmentr/r&r&r'�egg_info_for_urlUsrAccs\t|�\}}t|||�D]
}|Vq|rXt�|�}|rXt||�d�|td�D]
}|VqLdS)zEYield egg or source distribution objects that might be found at a URLr6)�
precedenceN)rA�distros_for_location�EGG_FRAGMENT�matchr �groupr	)r:�metadatar/r@�distrEr&r&r'r`s
�
cCs�|�d�r|dd�}|�d�r8d|kr8t�|||�gS|�d�rxd|krxt|�}|��s^gSt||j|jtdd�gS|�d	�r�t|�\}}}|dk	r�t	||||t
|�StD]0}|�|�r�|dt|��}t	|||�Sq�gS)
z:Yield egg or source distribution objects based on basename�.egg.zipNr*z.egg�-z.whlr6)�location�project_name�versionrBr))
r,r
Z
from_locationrZ
is_compatiblerLrMrrr r�
EXTENSIONS�len)rK�basenamerGZwheelZwin_baser0�platformZextr&r&r'rCns<
�
�
rCcCstt|�tj�|�|�S)zEYield possible egg or source distribution objects based on a filename)rCr�osr>rP)�filenamerGr&r&r'�distros_for_filename�s

�rTc
cs||�d�}|s,tdd�|dd�D��r,dStdt|�d�D]8}t||d�|d|��d�||d��|||d�Vq>dS)z�Generate alternative interpretations of a source distro name

    Note: if `location` is a filesystem filename, you should call
    ``pkg_resources.normalize_path()`` on it before passing it to this
    routine!
    rJcss|]}t�d|�VqdS)z	py\d\.\d$N)�rerE)�.0�pr&r&r'�	<genexpr>�sz(interpret_distro_name.<locals>.<genexpr>�Nr6)�
py_versionrBrQ)r9�any�rangerOr
�join)rKrPrGrZrBrQr;rWr&r&r'r �s
�ccsft�}|j}|dkr:tj�|j|�D]}||�|Vq$n(|D]"}||�}||kr>||�|Vq>dS)zHList unique elements, preserving order. Remember all elements ever seen.N)�set�addrZmoves�filterfalse�__contains__)�iterable�key�seenZseen_addZelement�kr&r&r'�unique_everseen�s
rfcst���fdd��}|S)zs
    Wrap a function returning an iterable such that the resulting iterable
    only ever yields unique items.
    cst�||��S�N)rf)�args�kwargs��funcr&r'�wrapper�szunique_values.<locals>.wrapperr)rkrlr&rjr'�
unique_values�srmz(<([^>]*\srel\s*=\s*['"]?([^'">]+)[^>]*)>c	cs�t�|�D]d}|��\}}tttj|���d���}d|ksDd|kr
t	�|�D]}t
j�|t
|�d���VqNq
dD]@}|�|�}|dkrtt	�||�}|rtt
j�|t
|�d���VqtdS)zEFind rel="homepage" and rel="download" links in `page`, yielding URLs�,Zhomepager3r6)z
<th>Home Pagez<th>Download URLr2N)�REL�finditer�groupsr^r�str�stripr+r9�HREFrr#�urljoin�
htmldecoderF�find�search)r:�pagerE�tagZrelZrels�posr&r&r'�find_external_links�s
r|c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�ContentCheckerzP
    A null content checker that defines the interface for checking content
    cCsdS)z3
        Feed a block of data to the hash.
        Nr&��self�blockr&r&r'�feed�szContentChecker.feedcCsdS)zC
        Check the hash. Return False if validation fails.
        Tr&�rr&r&r'�is_valid�szContentChecker.is_validcCsdS)zu
        Call reporter with information about the checker (hash name)
        substituted into the template.
        Nr&)r�reporter�templater&r&r'�reportszContentChecker.reportN)�__name__�
__module__�__qualname__�__doc__r�r�r�r&r&r&r'r}�sr}c@sBeZdZe�d�Zdd�Zedd��Zdd�Z	dd	�Z
d
d�ZdS)
�HashCheckerzK(?P<hash_name>sha1|sha224|sha384|sha256|sha512|md5)=(?P<expected>[a-f0-9]+)cCs||_t�|�|_||_dSrg)�	hash_name�hashlib�new�hash�expected)rr�r�r&r&r'�__init__szHashChecker.__init__cCs>tj�|�d}|st�S|j�|�}|s0t�S|f|���S)z5Construct a (possibly null) ContentChecker from a URLr2)rr#r7r}�patternrx�	groupdict)�clsr:r@rEr&r&r'�from_urlszHashChecker.from_urlcCs|j�|�dSrg)r��updater~r&r&r'r�szHashChecker.feedcCs|j��|jkSrg)r�Z	hexdigestr�r�r&r&r'r�"szHashChecker.is_validcCs||j}||�Srg)r�)rr�r��msgr&r&r'r�%s
zHashChecker.reportN)r�r�r�rU�compiler�r��classmethodr�r�r�r�r&r&r&r'r�	s�

r�cs<eZdZdZdJdd�ZdKd	d
�ZdLdd�ZdMd
d�Zdd�Zdd�Z	dd�Z
dd�ZdNdd�Zdd�Z
dO�fdd�	Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�ZdPd'd(�ZdQd)d*�Zd+d,�Zd-Zd.d/�Zd0d1�ZdRd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Ze dSd>d?��Z!d@dA�Z"dBdC�Z#dDdE�Z$dFdG�Z%dHdI�Z&�Z'S)Trz;A distribution index that scans web pages for download URLs�https://pypi.org/simple/��*NTcOs�tj|f|�|�|dd|�d��|_i|_i|_i|_t�d�	t
t|���j|_
g|_|ortjor|prt��}|r�t�|�|_n
tjj|_dS)Nr1�|)rr�r,�	index_url�scanned_urls�fetched_urls�
package_pagesrUr�r]rrrE�allows�to_scanrZis_availableZfind_ca_bundleZ
opener_for�openerr�request�urlopen)rr�ZhostsZ	ca_bundleZ
verify_sslrh�kwZuse_sslr&r&r'r�-s�
�zPackageIndex.__init__FcCs�||jkr|sdSd|j|<t|�s2|�|�dStt|��}|r\|�|�sPdS|�d|�|sn|rn||jkr�tt|j	|��dS|�|�s�d|j|<dS|�
d|�d|j|<d}|�|||�}|dkr�dSd|j|j<d|j
�dd���k�r|��dS|j}|��}t|t��sNt|tjj��r0d	}n|j
�d
��p@d	}|�|d�}|��t�|�D](}	tj�|t|	�d���}
|�|
��q`|� |j!��r�t"|d
d�dk�r�|�#||�}dS)z<Evaluate a URL as a possible download, and maybe retrieve itNTzFound link: %sz
Reading %sz<Download error on %s: %%s -- Some packages may not be found!�html�content-type�zlatin-1�charset�ignorer6�code�)$r��
URL_SCHEME�process_filename�listr�url_ok�debugr�rr_�info�open_urlr:�headers�getr+�close�read�
isinstancerrr�error�	HTTPErrorZ	get_param�decodertrpr#rurvrF�process_urlr-r��getattr�
process_index)rr:Zretrieve�dists�tmpl�fr/ryr�rE�linkr&r&r'r�BsP





 zPackageIndex.process_urlcCs�tj�|�s|�d|�dStj�|�r^|s^tj�|�}t�|�D]}|�tj�||�d�qBt	|�}|r�|�
d|�tt|j
|��dS)Nz
Not found: %sTz	Found: %s)rRr>�exists�warn�isdir�realpath�listdirr�r]rTr�r�rr_)r�fn�nestedr>�itemr�r&r&r'r�uszPackageIndex.process_filenamecCsbt|�}|o|�d���dk}|s8|�tj�|�d�r<dSd}|rRt||��n|�||�dS)Nr6�fileTzN
Note: Bypassing %s (disallowed host; see http://bit.ly/2hrImnY for details).
)	r�rFr+r�rr#r7rr�)rr:Zfatal�s�is_filer�r&r&r'r��s�zPackageIndex.url_okcCs2ttjj|�}dd�|D�}tt�|j|��dS)Ncss0|](}t�|�D]}|�d�r||fVqqdS)z	.egg-linkN)rRr�r,)rVr>�entryr&r&r'rX�s

�z.PackageIndex.scan_egg_links.<locals>.<genexpr>)�filterrRr>r�r��	itertools�starmap�
scan_egg_link)rZsearch_path�dirsZ	egg_linksr&r&r'�scan_egg_links�s
�zPackageIndex.scan_egg_linksc	Cs�ttj�||���}ttdttj|���}W5QRXt	|�dkrDdS|\}}t
tj�||��D](}tjj|f|��|_t|_
|�|�q^dS)NrY)�openrRr>r]r�r�rrrrsrOrrKr
rBr_)rr>r�Z	raw_lines�linesZegg_pathZ
setup_pathrHr&r&r'r��s zPackageIndex.scan_egg_linkc
	s��fdd�}t�|�D]:}z |tj�|t|�d����Wqtk
rNYqXq||�\}}|r�t||�D]H}t	|�\}}	|�
d�r�|	s�|r�|d||f7}n
��|���|�qlt
�dd�|�SdSd	S)
z#Process the contents of a PyPI pagecs�|��j�r�tttjj|t�j�d��d���}t|�dkr�d|dkr�t	|d�}t
|d�}d�j�|�
�i�|<t|�t|�fSdS)Nr1rYr5r6rT)NN)r-r�r�rrr#r8rOr9rrr��
setdefaultr+r)r�r;�pkg�verr�r&r'�scan�s�z(PackageIndex.process_index.<locals>.scanr6�.pyz
#egg=%s-%scSsd|�ddd�S)Nz<a href="%s#md5=%s">%s</a>r6�rY)rF)�mr&r&r'�<lambda>��z,PackageIndex.process_index.<locals>.<lambda>r�N)rtrprr#rurvrFr$r|rAr,�need_version_info�scan_url�PYPI_MD5�sub)
rr:ryr�rEr�r��new_urlr/�fragr&r�r'r��s( 
�zPackageIndex.process_indexcCs|�d|�dS)NzPPage at %s links to .py file(s) without version info; an index scan is required.)�scan_all�rr:r&r&r'r��s�zPackageIndex.need_version_infocGs:|j|jkr*|r |j|f|��|�d�|�|j�dS)Nz6Scanning index of all packages (this may take a while))r�r�r�r�r��rr�rhr&r&r'r��s�zPackageIndex.scan_allcCsz|�|j|jd�|j�|j�s:|�|j|jd�|j�|j�sR|�|�t|j�|jd��D]}|�|�qfdS)Nr1r&)	r�r��unsafe_namer�r�rcrL�not_found_in_indexr�)r�requirementr:r&r&r'�
find_packages�s
zPackageIndex.find_packagescsR|��|�|�||jD]"}||kr0|S|�d||�qtt|��||�S)Nz%s does not match %s)�prescanr�rcr��superr�obtain)rr�Z	installerrH��	__class__r&r'r��s
zPackageIndex.obtaincCsL|�|jd|�|��sH|��t�|�td|jjtj	�
|�f��dS)z-
        checker is a ContentChecker
        zValidating %%s checksum for %sz7%s validation failed for %s; possible download problem?N)r�r�r�r�rR�unlinkrr�r.r>rP)r�checkerrS�tfpr&r&r'�
check_hash�s�
��zPackageIndex.check_hashcCsN|D]D}|jdks0t|�r0|�d�s0tt|��r<|�|�q|j�|�qdS)z;Add `urls` to the list that will be prescanned for searchesN�file:)r�r�r-r�rr��append)rZurlsr:r&r&r'�add_find_linkss���
�zPackageIndex.add_find_linkscCs"|jrtt|j|j��d|_dS)z7Scan urls scheduled for prescanning (e.g. --find-links)N)r�r�rr�r�r&r&r'r�szPackageIndex.prescancCs<||jr|jd}}n|jd}}|||j�|��dS)Nz#Couldn't retrieve index page for %rz3Couldn't find index page for %r (maybe misspelled?))rcr�r�r�r�)rr�Zmethr�r&r&r'r�#s
�zPackageIndex.not_found_in_indexcCs~t|t�sjt|�}|rR|�|�d�||�}t|�\}}|�d�rN|�|||�}|Stj	�
|�rb|St|�}t|�
||�dd�S)aLocate and/or download `spec` to `tmpdir`, returning a local path

        `spec` may be a ``Requirement`` object, or a string containing a URL,
        an existing local filename, or a project/version requirement spec
        (i.e. the string form of a ``Requirement`` object).  If it is the URL
        of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one
        that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is
        automatically created alongside the downloaded file.

        If `spec` is a ``Requirement`` object or a string containing a
        project/version requirement spec, this method returns the location of
        a matching distribution (possibly after downloading it to `tmpdir`).
        If `spec` is a locally existing file or directory name, it is simply
        returned unchanged.  If `spec` is a URL, it is downloaded to a subpath
        of `tmpdir`, and the local filename is returned.  Various errors may be
        raised if a problem occurs during downloading.
        r6r�rKN)r�rr��
_download_urlrFrAr,�	gen_setuprRr>r�r(r��fetch_distribution)rr%�tmpdirr<�foundr/r@r&r&r'r3-s

zPackageIndex.downloadc	s���d|�i�d}d
�����fdd�	}|rH�����|�||�}|s^|dk	r^|||�}|dkr��jdk	rx���||�}|dkr�|s���|�||�}|dkr���d�r�dp�d|�n��d|�|j|jd	�SdS)a|Obtain a distribution suitable for fulfilling `requirement`

        `requirement` must be a ``pkg_resources.Requirement`` instance.
        If necessary, or if the `force_scan` flag is set, the requirement is
        searched for in the (online) package index as well as the locally
        installed packages.  If a distribution matching `requirement` is found,
        the returned distribution's ``location`` is the value you would have
        gotten from calling the ``download()`` method with the matching
        distribution's URL or filename.  If no matching distribution is found,
        ``None`` is returned.

        If the `source` flag is set, only source distributions and source
        checkout links will be considered.  Unless the `develop_ok` flag is
        set, development and system eggs (i.e., those using the ``.egg-info``
        format) will be ignored.
        zSearching for %sNcs�|dkr�}||jD]v}|jtkrF�sF|�kr��d|�d�|<q||ko\|jtkp\�}|r��|j��}||_tj	�
|j�r|SqdS)Nz&Skipping development or system egg: %sr6)rcrBrr�r
r3rK�download_locationrRr>r�)Zreq�envrHZtestZloc��
develop_okrZskipped�sourcer�r&r'rwgs&��z-PackageIndex.fetch_distribution.<locals>.findz:No local packages or working download links found for %s%sza source distribution of r�zBest match: %s)rK)N)r�r�r�r�r�Zcloner)	rr�r��
force_scanrrZlocal_indexrHrwr&rr'r�Os2




�zPackageIndex.fetch_distributioncCs"|�||||�}|dk	r|jSdS)a3Obtain a file suitable for fulfilling `requirement`

        DEPRECATED; use the ``fetch_distribution()`` method now instead.  For
        backward compatibility, this routine is identical but returns the
        ``location`` of the downloaded distribution instead of a distribution
        object.
        N)r�rK)rr�r�rrrHr&r&r'�fetch�szPackageIndex.fetchc
	Cs�t�|�}|r*dd�t||�d�d�D�p,g}t|�dkr�tj�|�}tj�|�|kr�tj�	||�}ddl
m}|||�s�t�
||�|}ttj�	|d�d��2}	|	�d|dj|djtj�|�df�W5QRX|S|r�td	||f��ntd
��dS)NcSsg|]}|jr|�qSr&)rM)rV�dr&r&r'�
<listcomp>�s�z*PackageIndex.gen_setup.<locals>.<listcomp>r6r)�samefilezsetup.py�wzIfrom setuptools import setup
setup(name=%r, version=%r, py_modules=[%r])
z�Can't unambiguously interpret project/version identifier %r; any dashes in the name or version should be escaped using underscores. %rzpCan't process plain .py files without an '#egg=name-version' suffix to enable automatic setup script generation.)rDrEr rFrOrRr>rP�dirnamer]Zsetuptools.command.easy_installr	�shutilZcopy2r��writerLrM�splitextr)
rrSr@r�rEr�rPZdstr	r�r&r&r'r��sB

��
������zPackageIndex.gen_setupi c	Cs|�d|�d}z�t�|�}|�|�}t|tjj�rJt	d||j
|jf��|��}d}|j}d}d|kr�t
|d�}	ttt|	��}|�|||||�t|d��V}
|�|�}|r�|�|�|
�|�|d7}|�|||||�q�q�q�|�|||
�W5QRX|W�S|�r|��XdS)	NzDownloading %szCan't download %s: %s %srr2zcontent-lengthzContent-Length�wbr6)r�r�r�r�r�r�rr�r�rr�r��dl_blocksizer�maxr�int�
reporthookr�r�r�r
r�)rr:rS�fpr�r��blocknumZbs�sizeZsizesr�r�r&r&r'�_download_to�s:

�



zPackageIndex._download_tocCsdSrgr&)rr:rSrZblksizerr&r&r'r�szPackageIndex.reporthookc
Cs�|�d�rt|�Szt||j�WSttjfk
r�}z<d�dd�|jD��}|r`|�	||�nt
d||f��W5d}~XY�ntjj
k
r�}z|WY�Sd}~XYn�tjjk
�r�}z*|r�|�	||j�nt
d||jf��W5d}~XYn�tjk
�rF}z,|�r$|�	||j�nt
d||jf��W5d}~XYnPtjtjfk
�r�}z(|�rt|�	||�nt
d||f��W5d}~XYnXdS)Nr�� cSsg|]}t|��qSr&)rr)rV�argr&r&r'rsz)PackageIndex.open_url.<locals>.<listcomp>z%s %szDownload error for %s: %sz;%s returned a bad status line. The server might be down, %s)r-�
local_open�open_with_authr�r$r�
InvalidURLr]rhr�rrr�r�ZURLError�reasonZ
BadStatusLine�lineZ
HTTPException�socket)rr:Zwarning�vr�r&r&r'r��s>
"����zPackageIndex.open_urlcCs�t|�\}}|r0d|kr4|�dd��dd�}qnd}|�d�rJ|dd�}tj�||�}|dksj|�d	�rv|�||�S|d
ks�|�d�r�|�||�S|�d�r�|�	||�S|d
kr�t
j�t
j
�|�d�S|�|d�|�||�SdS)Nz..�.�\�_Z__downloaded__rIr*Zsvnzsvn+Zgitzgit+zhg+r�rYT)rA�replacer,rRr>r]r-�
_download_svn�
_download_git�_download_hgrr��url2pathnamer#r7r��_attempt_download)rr<r:r�r.r@rSr&r&r'r�s$

zPackageIndex._download_urlcCs|�|d�dS)NT)r�r�r&r&r'r�:szPackageIndex.scan_urlcCs6|�||�}d|�dd���kr.|�|||�S|SdS)Nr�r�r�)rr�r+�_download_html)rr:rSr�r&r&r'r)=szPackageIndex._attempt_downloadcCsnt|�}|D]>}|��rt�d|�rF|��t�|�|�||�SqLq|��t�|�td|��dS)Nz <title>([^- ]+ - )?Revision \d+:zUnexpected HTML page found at )	r�rsrUrxr�rRr�r%r)rr:r�rSr�rr&r&r'r*Ds

zPackageIndex._download_htmlcCst�dt�|�dd�d}d}|���d�r�d|kr�tj�|�\}}}}}}	|s�|�d�r�d	|d
d�kr�|d
d��d	d�\}}t	|�\}
}|
r�d|
kr�|
�dd�\}}
d||
f}nd
|
}|}||||||	f}tj�
|�}|�d||�t�
d|||f�|S)Nz"SVN download support is deprecatedr5r6rr�zsvn:�@z//r1rY�:z --username=%s --password=%sz --username=z'Doing subversion checkout from %s to %szsvn checkout%s -q %s %s)�warningsr��UserWarningr9r+r-rr#r7�
_splituser�
urlunparser�rR�system)rr:rSZcredsr<�netlocr>rW�qr��auth�host�userZpwr;r&r&r'r%Ss&zPackageIndex._download_svncCsptj�|�\}}}}}|�dd�d}|�dd�d}d}d|krR|�dd�\}}tj�||||df�}||fS)N�+r6r2r5rr+r�)rr#Zurlsplitr9�rsplitZ
urlunsplit)r:�
pop_prefixr<r2r>r?r��revr&r&r'�_vcs_split_rev_from_urlisz$PackageIndex._vcs_split_rev_from_urlcCsl|�dd�d}|j|dd�\}}|�d||�t�d||f�|dk	rh|�d|�t�d	||f�|S)
Nr5r6rT�r9zDoing git clone from %s to %szgit clone --quiet %s %szChecking out %szgit -C %s checkout --quiet %s�r9r;r�rRr1�rr:rSr:r&r&r'r&{s�zPackageIndex._download_gitcCsl|�dd�d}|j|dd�\}}|�d||�t�d||f�|dk	rh|�d|�t�d	||f�|S)
Nr5r6rTr<zDoing hg clone from %s to %szhg clone --quiet %s %szUpdating to %szhg --cwd %s up -C -r %s -qr=r>r&r&r'r'�s�zPackageIndex._download_hgcGstj|f|��dSrg)rr�r�r&r&r'r��szPackageIndex.debugcGstj|f|��dSrg)rr�r�r&r&r'r��szPackageIndex.infocGstj|f|��dSrg)rr�r�r&r&r'r��szPackageIndex.warn)r�r�NT)F)F)F)N)N)FFFN)FF)N)F)(r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r3r�rr�rrrr�r�r�r)r*r%�staticmethodr;r&r'r�r�r��
__classcell__r&r&r�r'r*sX�

3



+
		
#�
L

)$
#z!&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?cCs|�d�}t|�S)Nr)rFr)rEZwhatr&r&r'�
decode_entity�s
rAcCs
tt|�S)a
    Decode HTML entities in the given text.

    >>> htmldecode(
    ...     'https://../package_name-0.1.2.tar.gz'
    ...     '?tokena=A&amp;tokenb=B">package_name-0.1.2.tar.gz')
    'https://../package_name-0.1.2.tar.gz?tokena=A&tokenb=B">package_name-0.1.2.tar.gz'
    )�
entity_subrA)�textr&r&r'rv�s	rvcs�fdd�}|S)Ncs��fdd�}|S)Nc	s2t��}t���z�||�W�St�|�XdSrg)rZgetdefaulttimeoutZsetdefaulttimeout)rhriZold_timeout)rk�timeoutr&r'�_socket_timeout�s

z@socket_timeout.<locals>._socket_timeout.<locals>._socket_timeoutr&)rkrE�rDrjr'rE�sz'socket_timeout.<locals>._socket_timeoutr&)rDrEr&rFr'�socket_timeout�srGcCs2tj�|�}|��}t�|�}|��}|�dd�S)aq
    A function compatible with Python 2.3-3.3 that will encode
    auth from a URL suitable for an HTTP header.
    >>> str(_encode_auth('username%3Apassword'))
    'dXNlcm5hbWU6cGFzc3dvcmQ='

    Long auth strings should not cause a newline to be inserted.
    >>> long_auth = 'username:' + 'password'*10
    >>> chr(10) in str(_encode_auth(long_auth))
    False
    �
r�)rr#r8�encode�base64Z	b64encoder�r$)r4Zauth_sZ
auth_bytesZ
encoded_bytesZencodedr&r&r'�_encode_auth�s

rKc@s(eZdZdZdd�Zdd�Zdd�ZdS)	�
Credentialz:
    A username/password pair. Use like a namedtuple.
    cCs||_||_dSrg��username�password)rrNrOr&r&r'r��szCredential.__init__ccs|jV|jVdSrgrMr�r&r&r'�__iter__�szCredential.__iter__cCsdt|�S)Nz%(username)s:%(password)s)�varsr�r&r&r'�__str__�szCredential.__str__N)r�r�r�r�r�rPrRr&r&r&r'rL�srLc@s0eZdZdd�Zedd��Zdd�Zdd�Zd	S)
�
PyPIConfigcCsPt�dddgd�}tj�||�tj�tj�d�d�}tj�	|�rL|�
|�dS)z%
        Load from ~/.pypirc
        rNrO�
repositoryr��~z.pypircN)�dict�fromkeysr�RawConfigParserr�rRr>r]�
expanduserr�r�)r�defaultsZrcr&r&r'r��s
zPyPIConfig.__init__cs&�fdd����D�}tt�j|��S)Ncs g|]}��|d���r|�qS)rT)r�rs)rV�sectionr�r&r'r�s�z2PyPIConfig.creds_by_repository.<locals>.<listcomp>)ZsectionsrVr�_get_repo_cred)rZsections_with_repositoriesr&r�r'�creds_by_repository�s
�zPyPIConfig.creds_by_repositorycCs6|�|d���}|t|�|d���|�|d����fS)NrTrNrO)r�rsrL)rr[Zrepor&r&r'r\s
�zPyPIConfig._get_repo_credcCs*|j��D]\}}|�|�r
|Sq
dS)z�
        If the URL indicated appears to be a repository defined in this
        config, return the credential for that repository.
        N)r]�itemsr-)rr:rT�credr&r&r'�find_credential
s
zPyPIConfig.find_credentialN)r�r�r�r��propertyr]r\r`r&r&r&r'rS�s

rScCs:tj�|�}|\}}}}}}|�d�r0t�d��|dkrFt|�\}	}
nd}	|	s~t��|�}|r~t	|�}	|j
|f}tjd	|��|	r�dt
|	�}	||
||||f}
tj�|
�}tj�|�}|�d|	�ntj�|�}|�dt�||�}|	�r6tj�|j�\}}}}}}||k�r6||
k�r6||||||f}
tj�|
�|_|S)
z4Open a urllib2 request, handling HTTP authenticationr,znonnumeric port: '')ZhttpZhttpsN�*Authenticating as %s for %s (from .pypirc)zBasic Z
Authorizationz
User-Agent)rb)rr#r7r,rrr/rSr`rrrNrr�rKr0r�ZRequestZ
add_header�
user_agentr:)r:r�Zparsedr<r2r>Zparamsr?r�r4Zaddressr_r�r;r�r�r�s2Zh2Zpath2Zparam2Zquery2Zfrag2r&r&r'rs8


rcCs |�d�\}}}|r|nd|fS)zJsplituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'.r+N)�
rpartition)r5r6Zdelimr&r&r'r/Fsr/cCs|Srgr&)r:r&r&r'�
fix_sf_urlPsrfc
Cstj�|�\}}}}}}tj�|�}tj�|�r<tj�|�S|�	d�r�tj�
|�r�g}t�|�D]d}	tj�||	�}
|	dkr�t
|
d��}|��}W5QRXq�ntj�
|
�r�|	d7}	|�dj|	d��q`d}
|
j|d�|�d�}d	\}}n
d
\}}}ddi}t�|�}tj�|||||�S)
z7Read a local path, with special support for directoriesr1z
index.html�rz<a href="{name}">{name}</a>)r.zB<html><head><title>{url}</title></head><body>{files}</body></html>rH)r:�files)��ZOK)r�zPath not foundz	Not foundr�z	text/html)rr#r7r�r(rRr>�isfiler�r,r�r�r]r�r�r��formatr�StringIOr�r�)r:r<r=r>Zparamr?r�rSrhr��filepathrZbodyr�Zstatus�messager�Zbody_streamr&r&r'rTs.�


r)N)N)N)N)r!)]r��sysrRrUrrrJr�r�r-�	functoolsrZsetuptools.externrZsetuptools.extern.six.movesrrrrr"Z
pkg_resourcesr	r
rrr
rrrrrrrrrZ	distutilsrZdistutils.errorsrZfnmatchrZsetuptools.py27compatrZsetuptools.py33compatrZsetuptools.wheelr�typeZ
__metaclass__r�rD�Irtr�rEr�r9rN�__all__Z_SOCKET_TIMEOUTZ_tmplrk�version_inforcr(rrArrCrTr rfrmror|r}r�rr�rBrArvrGrKrLrXrSr�r�rr/rfrr&r&r&r'�<module>s�<
��	

!
�
$


!
&/site-packages/setuptools/__pycache__/glob.cpython-38.pyc000064400000007225151446177000017303 0ustar00U

�Qab��@s�dZddlZddlZddlZdddgZddd�Zddd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Ze�d�Z
e�d�Zdd�Zdd�Zdd�ZdS)z�
Filename globbing utility. Mostly a copy of `glob` from Python 3.5.

Changes include:
 * `yield from` and PEP3102 `*` removed.
 * Hidden files are not ignored.
�N�glob�iglob�escapeFcCstt||d��S)ayReturn a list of paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la
    fnmatch. However, unlike fnmatch, filenames starting with a
    dot are special cases that are not matched by '*' and '?'
    patterns.

    If recursive is true, the pattern '**' will match any files and
    zero or more directories and subdirectories.
    )�	recursive)�listr)�pathnamer�r�3/usr/lib/python3.8/site-packages/setuptools/glob.pyrscCs*t||�}|r&t|�r&t|�}|r&t�|S)a�Return an iterator which yields the paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la
    fnmatch. However, unlike fnmatch, filenames starting with a
    dot are special cases that are not matched by '*' and '?'
    patterns.

    If recursive is true, the pattern '**' will match any files and
    zero or more directories and subdirectories.
    )�_iglob�_isrecursive�next�AssertionError)rr�it�srrr	rs

ccs�tj�|�\}}t|�sF|r0tj�|�rB|Vntj�|�rB|VdS|s�|rnt|�rnt||�D]
}|Vq`nt||�D]
}|VqxdS||kr�t|�r�t	||�}n|g}t|�r�|r�t|�r�t}q�t}nt
}|D]$}|||�D]}tj�||�Vq�q�dS�N)�os�path�split�	has_magic�lexists�isdirr�glob2�glob1r
�glob0�join)rr�dirname�basename�x�dirsZglob_in_dir�namerrr	r
0s4
r
cCsV|s"t|t�rtj�d�}ntj}zt�|�}Wntk
rHgYSXt�||�S�N�ASCII)	�
isinstance�bytesr�curdir�encode�listdir�OSError�fnmatch�filter)r�pattern�namesrrr	r[s

rcCs8|stj�|�r4|gSntj�tj�||��r4|gSgSr)rrrrr)rrrrr	rhsrccs2t|�st�|dd�Vt|�D]
}|Vq"dS)Nr)rr
�	_rlistdir)rr*rrrr	rxsrccs�|s"t|t�rtj�d�}ntj}zt�|�}Wntjk
rHYdSX|D]>}|V|rjtj�||�n|}t	|�D]}tj�||�VqvqNdSr )
r"r#rr$r%r&�errorrrr,)rr+rr�yrrr	r,�s
r,z([*?[])s([*?[])cCs(t|t�rt�|�}n
t�|�}|dk	Sr)r"r#�magic_check_bytes�search�magic_check)r�matchrrr	r�s

rcCst|t�r|dkS|dkSdS)Ns**z**)r"r#)r*rrr	r�s
rcCs<tj�|�\}}t|t�r(t�d|�}nt�d|�}||S)z#Escape all special characters.
    s[\1]z[\1])rr�
splitdriver"r#r/�subr1)rZdriverrr	r�s

)F)F)�__doc__r�rer(�__all__rrr
rrrr,�compiler1r/rrrrrrr	�<module>s 


+


site-packages/setuptools/__pycache__/config.cpython-38.opt-1.pyc000064400000042725151446177000020570 0ustar00U

�Qab6P�@s�ddlmZmZddlZddlZddlZddlZddlZddlm	Z	ddlm
Z
ddlmZddlm
Z
ddlmZmZddlmZmZdd	lmZdd
lmZmZeZddd
�Zdd�Zdd�Zddd�ZGdd�d�ZGdd�de�Z Gdd�de�Z!dS)�)�absolute_import�unicode_literalsN)�defaultdict)�partial��wraps)�
import_module)�DistutilsOptionError�DistutilsFileError)�
LegacyVersion�parse)�SpecifierSet)�string_types�PY3Fc		Cs�ddlm}m}tj�|�}tj�|�s4td|��t��}t�	tj�
|��zJ|�}|rb|��ng}||krx|�|�|j
||d�t||j|d�}W5t�	|�Xt|�S)a,Read given configuration file and returns options from it as a dict.

    :param str|unicode filepath: Path to configuration file
        to get options from.

    :param bool find_others: Whether to search for other configuration files
        which could be on in various places.

    :param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.

    :rtype: dict
    r)�Distribution�
_Distributionz%Configuration file %s does not exist.)�	filenames)�ignore_option_errors)Zsetuptools.distrr�os�path�abspath�isfiler
�getcwd�chdir�dirnameZfind_config_files�appendZparse_config_files�parse_configuration�command_options�configuration_to_dict)	�filepathZfind_othersrrrZcurrent_directoryZdistr�handlers�r!�5/usr/lib/python3.8/site-packages/setuptools/config.py�read_configurations*�
�
r#cCs.djft��}t�t||�}t|||�}|�S)z�
    Given a target object and option key, get that option from
    the target object, either through a get_{key} method or
    from an attribute directly.
    z	get_{key})�format�locals�	functoolsr�getattr)�
target_obj�keyZgetter_nameZby_attribute�getterr!r!r"�_get_optionEsr+cCs<tt�}|D]*}|jD]}t|j|�}|||j|<qq|S)z�Returns configuration data gathered by given handlers as a dict.

    :param list[ConfigHandler] handlers: Handlers list,
        usually from parse_configuration()

    :rtype: dict
    )r�dict�set_optionsr+r(�section_prefix)r Zconfig_dictZhandlerZoption�valuer!r!r"rQs
rcCs6t|||�}|��t|j|||j�}|��||fS)a�Performs additional parsing of configuration options
    for a distribution.

    Returns a list of used option handlers.

    :param Distribution distribution:
    :param dict command_options:
    :param bool ignore_option_errors: Whether to silently ignore
        options, values of which could not be resolved (e.g. due to exceptions
        in directives such as file:, attr:, etc.).
        If False exceptions are propagated as expected.
    :rtype: list
    )�ConfigOptionsHandlerr�ConfigMetadataHandler�metadata�package_dir)Zdistributionrr�options�metar!r!r"rcs��rc@s�eZdZdZdZiZd%dd�Zedd��Zdd	�Z	e
d&dd��Ze
d
d��Ze
dd��Z
e
dd��Ze
dd��Zedd��Zedd��Ze
d'dd��Ze
dd��Ze
d(dd��Zdd �Zd!d"�Zd#d$�ZdS))�
ConfigHandlerz1Handles metadata supplied in configuration files.NFcCs^i}|j}|��D].\}}|�|�s&q|�|d��d�}|||<q||_||_||_g|_dS)N��.)	r.�items�
startswith�replace�striprr(�sectionsr-)�selfr(r4rr=r.�section_name�section_optionsr!r!r"�__init__�s

zConfigHandler.__init__cCstd|jj��dS)�.Metadata item name to parser function mapping.z!%s must provide .parsers propertyN)�NotImplementedError�	__class__�__name__)r>r!r!r"�parsers�s
�zConfigHandler.parsersc	Cs�t�}|j}|j�||�}t|||�}||kr6t|��|r>dSd}|j�|�}|r�z||�}Wn tk
r~d}|jsz�YnX|r�dSt|d|d�}|dkr�t	|||�n||�|j
�|�dS)NFTzset_%s)�tupler(�aliases�getr'�KeyErrorrF�	Exceptionr�setattrr-r)	r>Zoption_namer/�unknownr(Z
current_valueZskip_option�parser�setterr!r!r"�__setitem__�s0zConfigHandler.__setitem__�,cCs8t|t�r|Sd|kr |��}n
|�|�}dd�|D�S)z�Represents value as a list.

        Value is split either by separator (defaults to comma) or by lines.

        :param value:
        :param separator: List items separator character.
        :rtype: list
        �
cSsg|]}|��r|���qSr!)r<)�.0�chunkr!r!r"�
<listcomp>�sz-ConfigHandler._parse_list.<locals>.<listcomp>)�
isinstance�list�
splitlines�split)�clsr/�	separatorr!r!r"�_parse_list�s



zConfigHandler._parse_listcCsPd}i}|�|�D]8}|�|�\}}}||kr:td|��|��||��<q|S)zPRepresents value as a dict.

        :param value:
        :rtype: dict
        �=z(Unable to parse option value to dict: %s)r\�	partitionr	r<)rZr/r[�result�liner)�sep�valr!r!r"�_parse_dict�s�zConfigHandler._parse_dictcCs|��}|dkS)zQRepresents value as boolean.

        :param value:
        :rtype: bool
        )�1�trueZyes)�lower)rZr/r!r!r"�_parse_bool�szConfigHandler._parse_boolcs�fdd�}|S)z�Returns a parser function to make sure field inputs
        are not files.

        Parses a value after getting the key so error messages are
        more informative.

        :param key:
        :rtype: callable
        cs d}|�|�rtd�����|S)N�file:zCOnly strings are accepted for the {0} field, files are not accepted)r:�
ValueErrorr$)r/Zexclude_directive�r)r!r"rNs
��z3ConfigHandler._exclude_files_parser.<locals>.parserr!)rZr)rNr!rjr"�_exclude_files_parser�sz#ConfigHandler._exclude_files_parsercs\d}t|t�s|S|�|�s |S|t|�d�}dd�|�d�D�}d��fdd�|D��S)aORepresents value as a string, allowing including text
        from nearest files using `file:` directive.

        Directive is sandboxed and won't reach anything outside
        directory with setup.py.

        Examples:
            file: README.rst, CHANGELOG.md, src/file.txt

        :param str value:
        :rtype: str
        rhNcss|]}tj�|���VqdS�N)rrrr<�rSrr!r!r"�	<genexpr>%sz,ConfigHandler._parse_file.<locals>.<genexpr>rQrRc3s.|]&}��|�stj�|�r��|�VqdS)TN)�
_assert_localrrr�
_read_filerm�rZr!r"rn&s

�)rVrr:�lenrY�join)rZr/Zinclude_directive�specZ	filepathsr!rqr"�_parse_files

�zConfigHandler._parse_filecCs|�t���std|��dS)Nz#`file:` directive can not access %s)r:rrr	)rr!r!r"ro-s�zConfigHandler._assert_localc
Cs.tj|dd��}|��W5QR�SQRXdS)Nzutf-8)�encoding)�io�open�read)r�fr!r!r"rp3szConfigHandler._read_filec	Cs�d}|�|�s|S|�|d����d�}|��}d�|�}|p@d}t��}|r�|d|kr�||d}|�dd�}	t	|	�dkr�tj
�t��|	d�}|	d}q�|}nd|kr�tj
�t��|d�}tj
�d|�zt
|�}
t|
|�}W5tj
dd�t_
X|S)	z�Represents value as a module attribute.

        Examples:
            attr: package.attr
            attr: package.module.attr

        :param str value:
        :rtype: str
        zattr:r7r8rAr�/�N)r:r;r<rY�poprsrr�rsplitrrr�sys�insertrr')rZr/r3Zattr_directiveZ
attrs_pathZ	attr_nameZmodule_name�parent_pathZcustom_path�parts�moduler!r!r"�_parse_attr8s0


zConfigHandler._parse_attrcs�fdd�}|S)z�Returns parser function to represents value as a list.

        Parses a value applying given methods one after another.

        :param parse_methods:
        :rtype: callable
        cs|}�D]}||�}q|Srlr!)r/�parsed�method��
parse_methodsr!r"rns
z1ConfigHandler._get_parser_compound.<locals>.parser!)rZr�rr!r�r"�_get_parser_compoundes	z"ConfigHandler._get_parser_compoundcCs6i}|pdd�}|��D]\}\}}||�||<q|S)z�Parses section options into a dictionary.

        Optionally applies a given parser to values.

        :param dict section_options:
        :param callable values_parser:
        :rtype: dict
        cSs|Srlr!)rbr!r!r"�<lambda>��z6ConfigHandler._parse_section_to_dict.<locals>.<lambda>)r9)rZr@Z
values_parserr/r)�_rbr!r!r"�_parse_section_to_dictxs

z$ConfigHandler._parse_section_to_dictc	Cs<|��D].\}\}}z|||<Wqtk
r4YqXqdS)zQParses configuration file section.

        :param dict section_options:
        N)r9rJ)r>r@�namer�r/r!r!r"�
parse_section�s
zConfigHandler.parse_sectioncCsb|j��D]R\}}d}|r"d|}t|d|�dd�d�}|dkrTtd|j|f��||�q
dS)zTParses configuration file items from one
        or more related sections.

        r7z_%szparse_section%sr8�__Nz0Unsupported distribution option section: [%s.%s])r=r9r'r;r	r.)r>r?r@Zmethod_postfixZsection_parser_methodr!r!r"r�s"���zConfigHandler.parsecst�����fdd��}|S)z� this function will wrap around parameters that are deprecated

        :param msg: deprecation message
        :param warning_class: class of warning exception to be raised
        :param func: function to be wrapped around
        cst�����||�Srl)�warnings�warn)�args�kwargs��func�msg�
warning_classr!r"�config_handler�sz@ConfigHandler._deprecated_config_handler.<locals>.config_handlerr)r>r�r�r�r�r!r�r"�_deprecated_config_handler�sz(ConfigHandler._deprecated_config_handler)F)rQ)N)N)rE�
__module__�__qualname__�__doc__r.rHrA�propertyrFrP�classmethodr\rcrgrkru�staticmethodrorpr�r�r�r�rr�r!r!r!r"r6~s<

&

	



,
r6csHeZdZdZddddd�ZdZd�fd	d
�	Zedd��Zd
d�Z	�Z
S)r1r2Zurl�description�classifiers�	platforms)Z	home_pageZsummaryZ
classifier�platformFNcstt|��|||�||_dSrl)�superr1rAr3)r>r(r4rr3�rDr!r"rA�s�zConfigMetadataHandler.__init__cCsL|j}|j}|j}|j}||||�|dt�||�||�|d�|||j|d�S)rBz[The requires parameter is deprecated, please use install_requires for runtime dependencies.�license)r��keywordsZprovidesZrequiresZ	obsoletesr�r�r�Zlong_description�versionZproject_urls)r\rurcrkr��DeprecationWarningr��_parse_version)r>�
parse_listZ
parse_file�
parse_dictZexclude_files_parserr!r!r"rF�s(�
�zConfigMetadataHandler.parserscCs�|�|�}||krB|��}tt|�t�r>d}t|jft����|S|�||j	�}t
|�r^|�}t|t�s�t|d�r�d�
tt|��}nd|}|S)zSParses `version` option value.

        :param value:
        :rtype: str

        zCVersion loaded from {value} does not comply with PEP 440: {version}�__iter__r8z%s)rur<rVrrr	r$r%r�r3�callabler�hasattrrs�map�str)r>r/r�Ztmplr!r!r"r��s 
�

z$ConfigMetadataHandler._parse_version)FN)rEr�r�r.rHZstrict_moderAr�rFr��
__classcell__r!r!r�r"r1�s��
r1c@s\eZdZdZedd��Zdd�Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dS)r0r4cCsN|j}t|jdd�}|j}|j}|||||||||||||||j|j|td�S)rB�;�r[)Zzip_safeZuse_2to3Zinclude_package_datar3Zuse_2to3_fixersZuse_2to3_exclude_fixersZconvert_2to3_doctestsZscriptsZeager_resourcesZdependency_linksZnamespace_packagesZinstall_requiresZsetup_requiresZ
tests_requireZpackages�entry_pointsZ
py_modulesZpython_requires)r\rrgrc�_parse_packagesrur
)r>r�Zparse_list_semicolonZ
parse_boolr�r!r!r"rFs.�zConfigOptionsHandler.parserscCszddg}|��}||kr"|�|�S||dk}|r>ts>td��|�|j�di��}|rdddlm}nddlm	}|f|�S)	zTParses `packages` option value.

        :param value:
        :rtype: list
        zfind:zfind_namespace:r|z8find_namespace: directive is unsupported on Python < 3.3z
packages.findr)�find_namespace_packages)�
find_packages)
r<r\rr	�parse_section_packages__findr=rIZ
setuptoolsr�r�)r>r/Zfind_directivesZ
trimmed_valueZfindns�find_kwargsr�r!r!r"r�1s 
��z$ConfigOptionsHandler._parse_packagescsT|�||j�}dddg�t�fdd�|��D��}|�d�}|dk	rP|d|d<|S)z�Parses `packages.find` configuration file section.

        To be used in conjunction with _parse_packages().

        :param dict section_options:
        �whereZinclude�excludecs$g|]\}}|�kr|r||f�qSr!r!�rS�k�v�Z
valid_keysr!r"rUZszEConfigOptionsHandler.parse_section_packages__find.<locals>.<listcomp>Nr)r�r\r,r9rI)r>r@Zsection_datar�r�r!r�r"r�Ms�
�
z1ConfigOptionsHandler.parse_section_packages__findcCs|�||j�}||d<dS)z`Parses `entry_points` configuration file section.

        :param dict section_options:
        r�N)r�r\�r>r@r�r!r!r"�parse_section_entry_pointsbsz/ConfigOptionsHandler.parse_section_entry_pointscCs.|�||j�}|�d�}|r*||d<|d=|S)N�*r7)r�r\rI)r>r@r��rootr!r!r"�_parse_package_datajs
z(ConfigOptionsHandler._parse_package_datacCs|�|�|d<dS)z`Parses `package_data` configuration file section.

        :param dict section_options:
        Zpackage_dataN�r��r>r@r!r!r"�parse_section_package_datatsz/ConfigOptionsHandler.parse_section_package_datacCs|�|�|d<dS)zhParses `exclude_package_data` configuration file section.

        :param dict section_options:
        Zexclude_package_dataNr�r�r!r!r"�"parse_section_exclude_package_data{s�z7ConfigOptionsHandler.parse_section_exclude_package_datacCs"t|jdd�}|�||�|d<dS)zbParses `extras_require` configuration file section.

        :param dict section_options:
        r�r�Zextras_requireN)rr\r�)r>r@r�r!r!r"�parse_section_extras_require�s
�z1ConfigOptionsHandler.parse_section_extras_requirecCs(|�||j�}dd�|��D�|d<dS)z^Parses `data_files` configuration file section.

        :param dict section_options:
        cSsg|]\}}||f�qSr!r!r�r!r!r"rU�szAConfigOptionsHandler.parse_section_data_files.<locals>.<listcomp>Z
data_filesN)r�r\r9r�r!r!r"�parse_section_data_files�sz-ConfigOptionsHandler.parse_section_data_filesN)rEr�r�r.r�rFr�r�r�r�r�r�r�r�r!r!r!r"r0s

	r0)FF)F)"Z
__future__rrrwrrr�r&�collectionsrrr�	importlibrZdistutils.errorsr	r
Z#setuptools.extern.packaging.versionrrZ&setuptools.extern.packaging.specifiersr
Zsetuptools.extern.sixrr�typeZ
__metaclass__r#r+rrr6r1r0r!r!r!r"�<module>s4�
/�
?Usite-packages/setuptools/__pycache__/py33compat.cpython-38.pyc000064400000002600151446177000020352 0ustar00U

�Qab2�@s�ddlZddlZddlZzddlZWnek
r<dZYnXddlmZddlmZe	Z
e�dd�ZGdd�d�Z
eede
�Zeed	d�Zedkr�e��jZdS)
�N)�six)�html_parser�OpArgz
opcode argc@seZdZdd�Zdd�ZdS)�Bytecode_compatcCs
||_dS)N)�code)�selfr�r�9/usr/lib/python3.8/site-packages/setuptools/py33compat.py�__init__szBytecode_compat.__init__ccs�t�d|jj�}t|jj�}d}d}||kr�||}|tjkr�||d||dd|}|d7}|tjkr�tjd}||d�}q$nd	}|d7}t	||�Vq$d	S)
z>Yield '(op,arg)' pair for each operation in code object 'code'�br�������iN)
�arrayr�co_code�len�disZ
HAVE_ARGUMENTZEXTENDED_ARGrZ
integer_typesr)r�bytes�eofZptrZextended_arg�op�argZ	long_typerrr	�__iter__s 
 

zBytecode_compat.__iter__N)�__name__�
__module__�__qualname__r
rrrrr	rsr�Bytecode�unescape)rr�collectionsZhtml�ImportErrorZsetuptools.externrZsetuptools.extern.six.movesr�typeZ
__metaclass__�
namedtuplerr�getattrrrZ
HTMLParserrrrr	�<module>s
"site-packages/setuptools/__pycache__/launch.cpython-38.opt-1.pyc000064400000001470151446177000020565 0ustar00U

�Qab�@s.dZddlZddlZdd�Zedkr*e�dS)z[
Launch the Python script on the command line after
setuptools is bootstrapped via import.
�NcCsrttjd}t|ddd�}tjdd�tjdd�<ttdt�}||���}|�dd�}t	||d�}t
||�dS)	zP
    Run the script in sys.argv[1] as if it had
    been invoked naturally.
    ��__main__N)�__file__�__name__�__doc__�openz\r\nz\n�exec)�__builtins__�sys�argv�dict�getattr�tokenizer�read�replace�compiler)Zscript_name�	namespaceZopen_ZscriptZnorm_script�code�r�5/usr/lib/python3.8/site-packages/setuptools/launch.py�run
s
�rr)rrr
rrrrrr�<module>s
site-packages/setuptools/__pycache__/_imp.cpython-38.pyc000064400000003542151446177000017302 0ustar00U

�Qab��@s\dZddlZddlZddlZddlmZdZdZdZ	dZ
dZdd	d
�Zddd�Z
d
d�ZdS)zX
Re-implementation of find_module and get_frozen_object
from the deprecated imp module.
�N�)�module_from_spec����c	CsVtj�||�}|dkr"td|��|jsBt|d�rBtj�d|j�}d}d}t|jt	�}|j
dkst|r�t|jtjj
�r�t}d}d}}n�|j
dks�|r�t|jtjj�r�t}d}d}}n�|j�r:|j
}tj�|�d	}|tjjkr�d
nd}|tjjkr�t}n&|tjjk�rt}n|tjjk�r t}|tthk�rFt||�}nd}d}}|||||ffS)z7Just like 'imp.find_module()', but with package supportN�
Can't find %s�submodule_search_locationsz__init__.py����frozen�zbuilt-inr�r�rb)�	importlib�util�	find_spec�ImportError�has_location�hasattr�spec_from_loader�loader�
isinstance�type�origin�
issubclass�	machinery�FrozenImporter�	PY_FROZEN�BuiltinImporter�	C_BUILTIN�os�path�splitext�SOURCE_SUFFIXES�	PY_SOURCE�BYTECODE_SUFFIXES�PY_COMPILED�EXTENSION_SUFFIXES�C_EXTENSION�open)	�module�paths�specZkind�fileZstaticr!�suffix�mode�r0�3/usr/lib/python3.8/site-packages/setuptools/_imp.py�find_modulesJ�
�
r2cCs*tj�||�}|std|��|j�|�S�Nr)rrrrr�get_code)r*r+r,r0r0r1�get_frozen_object>sr5cCs&tj�||�}|std|��t|�Sr3)rrrrr)r*r+�infor,r0r0r1�
get_moduleEsr7)N)N)�__doc__r �importlib.utilrZimportlib.machineryZ
py34compatrr$r&r(rrr2r5r7r0r0r0r1�<module>s
*
site-packages/setuptools/__pycache__/py33compat.cpython-38.opt-1.pyc000064400000002600151446177000021311 0ustar00U

�Qab2�@s�ddlZddlZddlZzddlZWnek
r<dZYnXddlmZddlmZe	Z
e�dd�ZGdd�d�Z
eede
�Zeed	d�Zedkr�e��jZdS)
�N)�six)�html_parser�OpArgz
opcode argc@seZdZdd�Zdd�ZdS)�Bytecode_compatcCs
||_dS)N)�code)�selfr�r�9/usr/lib/python3.8/site-packages/setuptools/py33compat.py�__init__szBytecode_compat.__init__ccs�t�d|jj�}t|jj�}d}d}||kr�||}|tjkr�||d||dd|}|d7}|tjkr�tjd}||d�}q$nd	}|d7}t	||�Vq$d	S)
z>Yield '(op,arg)' pair for each operation in code object 'code'�br�������iN)
�arrayr�co_code�len�disZ
HAVE_ARGUMENTZEXTENDED_ARGrZ
integer_typesr)r�bytes�eofZptrZextended_arg�op�argZ	long_typerrr	�__iter__s 
 

zBytecode_compat.__iter__N)�__name__�
__module__�__qualname__r
rrrrr	rsr�Bytecode�unescape)rr�collectionsZhtml�ImportErrorZsetuptools.externrZsetuptools.extern.six.movesr�typeZ
__metaclass__�
namedtuplerr�getattrrrZ
HTMLParserrrrr	�<module>s
"site-packages/setuptools/__pycache__/py31compat.cpython-38.opt-1.pyc000064400000002247151446177000021316 0ustar00U

�QabF�@sPgZeZzddlmZWn2ek
rJddlZddlZGdd�d�ZYnXdS)�)�TemporaryDirectoryNc@s(eZdZdZdd�Zdd�Zdd�ZdS)	rz�
        Very simple temporary directory context manager.
        Will try to delete afterward, but will also ignore OS and similar
        errors on deletion.
        cKsd|_tjf|�|_dS�N)�name�tempfileZmkdtemp)�self�kwargs�r�9/usr/lib/python3.8/site-packages/setuptools/py31compat.py�__init__szTemporaryDirectory.__init__cCs|jSr)r)rrrr	�	__enter__szTemporaryDirectory.__enter__cCs2zt�|jd�Wntk
r&YnXd|_dS)NT)�shutilZrmtreer�OSError)r�exctypeZexcvalueZexctracerrr	�__exit__s
zTemporaryDirectory.__exit__N)�__name__�
__module__�__qualname__�__doc__r
rrrrrr	r
sr)�__all__�typeZ
__metaclass__rr�ImportErrorrrrrr	�<module>ssite-packages/setuptools/__pycache__/py31compat.cpython-38.pyc000064400000002247151446177000020357 0ustar00U

�QabF�@sPgZeZzddlmZWn2ek
rJddlZddlZGdd�d�ZYnXdS)�)�TemporaryDirectoryNc@s(eZdZdZdd�Zdd�Zdd�ZdS)	rz�
        Very simple temporary directory context manager.
        Will try to delete afterward, but will also ignore OS and similar
        errors on deletion.
        cKsd|_tjf|�|_dS�N)�name�tempfileZmkdtemp)�self�kwargs�r�9/usr/lib/python3.8/site-packages/setuptools/py31compat.py�__init__szTemporaryDirectory.__init__cCs|jSr)r)rrrr	�	__enter__szTemporaryDirectory.__enter__cCs2zt�|jd�Wntk
r&YnXd|_dS)NT)�shutilZrmtreer�OSError)r�exctypeZexcvalueZexctracerrr	�__exit__s
zTemporaryDirectory.__exit__N)�__name__�
__module__�__qualname__�__doc__r
rrrrrr	r
sr)�__all__�typeZ
__metaclass__rr�ImportErrorrrrrr	�<module>ssite-packages/setuptools/__pycache__/version.cpython-38.opt-1.pyc000064400000000444151446177000021000 0ustar00U

�Qab��@s6ddlZze�d�jZWnek
r0dZYnXdS)�NZ
setuptools�unknown)Z
pkg_resourcesZget_distribution�version�__version__�	Exception�rr�6/usr/lib/python3.8/site-packages/setuptools/version.py�<module>ssite-packages/setuptools/__pycache__/monkey.cpython-38.pyc000064400000011044151446177000017654 0ustar00U

�Qab��@s�dZddlZddlZddlZddlZddlZddlmZddl	Z	ddl
mZddlZgZ
dd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Zdd�Zdd�ZdS)z
Monkey patching of distutils.
�N)�
import_module)�sixcCs"t��dkr|f|jSt�|�S)am
    Returns the bases classes for cls sorted by the MRO.

    Works around an issue on Jython where inspect.getmro will not return all
    base classes if multiple classes share the same name. Instead, this
    function will return a tuple containing the class itself, and the contents
    of cls.__bases__. See https://github.com/pypa/setuptools/issues/1024.
    ZJython)�platformZpython_implementation�	__bases__�inspectZgetmro)�cls�r�5/usr/lib/python3.8/site-packages/setuptools/monkey.py�_get_mros	r
cCs0t|tj�rtnt|tj�r tndd�}||�S)NcSsdS)Nr)�itemrrr	�<lambda>*�zget_unpatched.<locals>.<lambda>)�
isinstancerZclass_types�get_unpatched_class�types�FunctionType�get_unpatched_function)r�lookuprrr	�
get_unpatched&s
�rcCs:dd�t|�D�}t|�}|j�d�s6d|}t|��|S)z�Protect against re-patching the distutils if reloaded

    Also ensures that no other distutils extension monkeypatched the distutils
    first.
    css|]}|j�d�s|VqdS)�
setuptoolsN)�
__module__�
startswith)�.0rrrr	�	<genexpr>5s�z&get_unpatched_class.<locals>.<genexpr>�	distutilsz(distutils has already been patched by %r)r
�nextrr�AssertionError)rZexternal_bases�base�msgrrr	r/s�rcCs�tjtj_tjdk}|r"tjtj_tjdkp^dtjko@dknp^dtjkoZdkn}|rrd}|tjj	_
t�tjtjtj
fD]}tjj|_q�tjjtj_tjjtj_dtjkr�tjjtjd_t�dS)N)��r)���
)r�)rr$�)rr zhttps://upload.pypi.org/legacy/zdistutils.command.build_ext)rZCommandrZcore�sys�version_info�findallZfilelistZconfigZ
PyPIRCCommandZDEFAULT_REPOSITORY�_patch_distribution_metadata�dist�cmdZDistribution�	extensionZ	Extension�modules�#patch_for_msvc_specialized_compiler)Zhas_issue_12885Zneeds_warehouseZ	warehouse�modulerrr	�	patch_allAs*



��

�
r0cCs*dD] }ttj|�}ttjj||�qdS)zDPatch write_pkg_file and read_pkg_file for higher metadata standards)Zwrite_pkg_fileZ
read_pkg_fileZget_metadata_versionN)�getattrrr*�setattrrZDistributionMetadata)�attrZnew_valrrr	r)hsr)cCs*t||�}t|��d|�t|||�dS)z�
    Patch func_name in target_mod with replacement

    Important - original must be resolved by name to avoid
    patching an already patched function.
    �	unpatchedN)r1�vars�
setdefaultr2)ZreplacementZ
target_mod�	func_name�originalrrr	�
patch_funcos
r9cCs
t|d�S)Nr4)r1)�	candidaterrr	r�srcs�td��t��dkrdS�fdd�}t�|d�}t�|d�}zt|d��t|d	��Wntk
rlYnXzt|d
��Wntk
r�YnXzt|d��Wntk
r�YnXdS)z\
    Patch functions in distutils to use standalone Microsoft Visual C++
    compilers.
    zsetuptools.msvcZWindowsNcsLd|krdnd}||�d�}t�|�}t|�}t||�sBt|��|||fS)zT
        Prepare the parameters for patch_func to patch indicated function.
        �msvc9Zmsvc9_Zmsvc14_�_)�lstripr1r�hasattr�ImportError)Zmod_namer7Zrepl_prefixZ	repl_name�repl�mod�Zmsvcrr	�patch_params�s

z9patch_for_msvc_specialized_compiler.<locals>.patch_paramszdistutils.msvc9compilerzdistutils._msvccompilerZfind_vcvarsallZquery_vcvarsallZ_get_vc_envZgen_lib_options)rr�system�	functools�partialr9r?)rCr;Zmsvc14rrBr	r.�s&
r.)�__doc__r&Zdistutils.filelistrrrrE�	importlibrrZsetuptools.externrr�__all__r
rrr0r)r9rr.rrrr	�<module>s$	'site-packages/setuptools/__pycache__/build_meta.cpython-38.opt-1.pyc000064400000020415151446177000021420 0ustar00U

�Qab}%�@sdZddlZddlZddlZddlZddlZddlZddlZddlZddl	m
Z
ddlmZddl
mZdddd	d
ddgZGd
d�de�ZGdd�dejj�Zdd�Zdd�Zdd�Zdd�ZGdd�de�ZGdd�de�Ze�ZejZejZejZejZej Z e�Z!dS)a-A PEP 517 interface to setuptools

Previously, when a user or a command line tool (let's call it a "frontend")
needed to make a request of setuptools to take a certain action, for
example, generating a list of installation requirements, the frontend would
would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line.

PEP 517 defines a different method of interfacing with setuptools. Rather
than calling "setup.py" directly, the frontend should:

  1. Set the current directory to the directory with a setup.py file
  2. Import this module into a safe python interpreter (one in which
     setuptools can potentially set global variables or crash hard).
  3. Call one of the functions defined in PEP 517.

What each function does is defined in PEP 517. However, here is a "casual"
definition of the functions (this definition should not be relied on for
bug reports or API stability):

  - `build_wheel`: build a wheel in the folder and return the basename
  - `get_requires_for_build_wheel`: get the `setup_requires` to build
  - `prepare_metadata_for_build_wheel`: get the `install_requires`
  - `build_sdist`: build an sdist in the folder and return the basename
  - `get_requires_for_build_sdist`: get the `setup_requires` to build

Again, this is not a formal definition! Just a "taste" of the module.
�N)�TemporaryDirectory)�parse_requirements)�makedirs�get_requires_for_build_sdist�get_requires_for_build_wheel� prepare_metadata_for_build_wheel�build_wheel�build_sdist�
__legacy__�SetupRequirementsErrorc@seZdZdd�ZdS)rcCs
||_dS�N)�
specifiers)�selfr
�r�9/usr/lib/python3.8/site-packages/setuptools/build_meta.py�__init__4szSetupRequirementsError.__init__N)�__name__�
__module__�__qualname__rrrrrr3sc@s&eZdZdd�Zeejdd���ZdS)�DistributioncCstttt|���}t|��dSr)�list�map�strrr)rr
Zspecifier_listrrr�fetch_build_eggs9szDistribution.fetch_build_eggsccs*tjj}|tj_z
dVW5|tj_XdS)zw
        Replace
        distutils.dist.Distribution with this class
        for the duration of this context.
        N)�	distutilsZcorer)�clsZorigrrr�patch>s

zDistribution.patchN)rrrr�classmethod�
contextlib�contextmanagerrrrrrr8srcCs*tjddkr&t|t�s&|�t���S|S)z�
    Convert a filename to a string (on Python 2, explicitly
    a byte string, not Unicode) as distutils checks for the
    exact type str.
    r�)�sys�version_info�
isinstancer�encode�getfilesystemencoding)�srrr�_to_strNsr'cs�fdd�t���D�S)Ncs&g|]}tj�tj��|��r|�qSr)�os�path�isdir�join)�.0�name�Za_dirrr�
<listcomp>\s�z1_get_immediate_subdirectories.<locals>.<listcomp>�r(�listdirr.rr.r�_get_immediate_subdirectories[sr2cs"�fdd�t�|�D�}|\}|S)Nc3s|]}|���r|VqdSr��endswith�r,�f��	extensionrr�	<genexpr>as
�z'_file_with_extension.<locals>.<genexpr>r0)Z	directoryr8Zmatching�filerr7r�_file_with_extension`s

�r;cCs&tj�|�st�d�Sttdt�|�S)Nz%from setuptools import setup; setup()�open)r(r)�exists�io�StringIO�getattr�tokenizer<��setup_scriptrrr�_open_setup_scriptis
rDc@s`eZdZdd�Zdd�Zddd�Zdd	d
�Zddd�Zdd
d�Zdd�Z	ddd�Z
ddd�ZdS)�_BuildMetaBackendcCs|pi}|�dg�|S)N�--global-option)�
setdefault�r�config_settingsrrr�_fix_configssz_BuildMetaBackend._fix_configc
Csz|�|�}tjdd�dg|dt_z t���|��W5QRXWn,tk
rt}z||j7}W5d}~XYnX|S)N�Zegg_inforF)rJr!�argvrr�	run_setuprr
)rrI�requirements�errr�_get_build_requiresxs
�
z%_BuildMetaBackend._get_build_requires�setup.pyc	CsD|}d}t|��}|���dd�}W5QRXtt||d�t��dS)N�__main__z\r\nz\n�exec)rD�read�replacerS�compile�locals)rrC�__file__rr6�coderrrrM�s

z_BuildMetaBackend.run_setupNcCs|�|�}|j|dgd�S)NZwheel�rN�rJrPrHrrrr�s
z._BuildMetaBackend.get_requires_for_build_wheelcCs|�|�}|j|gd�S)NrZr[rHrrrr�s
z._BuildMetaBackend.get_requires_for_build_sdistcCs�tjdd�ddt|�gt_|��|}dd�t�|�D�}t|�dkrxtt|��dkrxtj�	|t�|�d�}q*qxq*||kr�t
�tj�	||d�|�t
j|dd�|dS)	NrKZ	dist_infoz
--egg-basecSsg|]}|�d�r|�qS)z
.dist-infor3r5rrrr/�s
�zF_BuildMetaBackend.prepare_metadata_for_build_wheel.<locals>.<listcomp>rT)�
ignore_errors)
r!rLr'rMr(r1�lenr2r)r+�shutilZmoveZrmtree)r�metadata_directoryrIZdist_info_directoryZ
dist_infosrrrr�s,����z2_BuildMetaBackend.prepare_metadata_for_build_wheelc	Cs�|�|�}tj�|�}t|dd�t|d��v}tjdd�|d|g|dt_|��t	||�}tj�
||�}tj�|�r�t�|�t�
tj�
||�|�W5QRX|S)NT)�exist_ok)�dirrKz
--dist-dirrF)rJr(r)�abspathrrr!rLrMr;r+r=�remove�rename)rZ
setup_commandZresult_extensionZresult_directoryrIZtmp_dist_dirZresult_basenameZresult_pathrrr�_build_with_temp_dir�s 
��

 z&_BuildMetaBackend._build_with_temp_dircCs|�dgd||�S)NZbdist_wheelz.whl�re)rZwheel_directoryrIr_rrrr�s
�z_BuildMetaBackend.build_wheelcCs|�dddgd||�S)NZsdistz	--formatsZgztarz.tar.gzrf)rZsdist_directoryrIrrrr	�s
�z_BuildMetaBackend.build_sdist)rQ)N)N)N)NN)N)rrrrJrPrMrrrrerr	rrrrrEqs


�
�
rEcs"eZdZdZd�fdd�	Z�ZS)�_BuildMetaLegacyBackendaCCompatibility backend for setuptools

    This is a version of setuptools.build_meta that endeavors to maintain backwards
    compatibility with pre-PEP 517 modes of invocation. It exists as a temporary
    bridge between the old packaging mechanism and the new packaging mechanism,
    and will eventually be removed.
    rQc
sbttj�}tj�tj�|��}|tjkr6tj�d|�ztt|�j	|d�W5|tjdd�<XdS)NrrB)
rr!r)r(�dirnamerb�insert�superrgrM)rrCZsys_pathZ
script_dir��	__class__rrrM�s

��
z!_BuildMetaLegacyBackend.run_setup)rQ)rrr�__doc__rM�
__classcell__rrrkrrg�srg)"rmr>r(r!rAr^rZ
setuptoolsrZsetuptools.py31compatrZ
pkg_resourcesrZpkg_resources.py31compatr�__all__�
BaseExceptionrZdistrr'r2r;rD�objectrErgZ_BACKENDrrrrr	r
rrrr�<module>sD�
	hsite-packages/setuptools/__pycache__/depends.cpython-38.opt-1.pyc000064400000012140151446177000020731 0ustar00U

�Qab��@s�ddlZddlZddlZddlmZddlmZddlmZm	Z	m
Z
mZddlmZddd	d
gZ
Gdd�d�Zdd
�Zddd	�Zddd
�Zdd�Ze�dS)�N)�
StrictVersion�)�Bytecode)�find_module�PY_COMPILED�	PY_FROZEN�	PY_SOURCE)�
py27compat�Requirer�get_module_constant�extract_constantc@sHeZdZdZddd�Zdd�Zdd	�Zddd�Zdd
d�Zddd�Z	dS)r
z7A prerequisite to building or installing a distribution�NcCsF|dkr|dk	rt}|dk	r0||�}|dkr0d}|j�t��|`dS)N�__version__)r�__dict__�update�locals�self)r�name�requested_version�moduleZhomepage�	attribute�format�r�6/usr/lib/python3.8/site-packages/setuptools/depends.py�__init__szRequire.__init__cCs |jdk	rd|j|jfS|jS)z0Return full package/distribution name, w/versionNz%s-%s)rr)rrrr�	full_name#s
zRequire.full_namecCs*|jdkp(|jdkp(t|�dko(||jkS)z%Is 'version' sufficiently up-to-date?N�unknown)rr�strr)r�versionrrr�
version_ok)s�zRequire.version_okrcCs�|jdkrFz$t|j|�\}}}|r*|��|WStk
rDYdSXt|j|j||�}|dk	r|||k	r||jdk	r||�|�S|S)a�Get version number of installed module, 'None', or 'default'

        Search 'paths' for module.  If not found, return 'None'.  If found,
        return the extracted version attribute, or 'default' if no version
        attribute was specified, or the value cannot be determined without
        importing the module.  The version is formatted according to the
        requirement's version format (if any), unless it is 'None' or the
        supplied 'default'.
        N)rrr�close�ImportErrorrr)r�paths�default�f�p�i�vrrr�get_version.s

zRequire.get_versioncCs|�|�dk	S)z/Return true if dependency is present on 'paths'N)r()rr"rrr�
is_presentIszRequire.is_presentcCs |�|�}|dkrdS|�|�S)z>Return true if dependency is present and up-to-date on 'paths'NF)r(r)rr"rrrr�
is_currentMs
zRequire.is_current)r
NN)Nr)N)N)
�__name__�
__module__�__qualname__�__doc__rrrr(r)r*rrrrr
s�


cCs"tjdd��}|s|�St�|�S)Ncss
dVdS)Nrrrrr�emptyVszmaybe_close.<locals>.empty)�
contextlib�contextmanager�closing)r$r/rrr�maybe_closeUs

r3���c
Cs�zt||�\}}\}}}}	Wntk
r4YdSXt|��z|tkr^|�d�t�|�}
nV|tkrtt�	||�}
n@|t
kr�t|��|d�}
n&t�|||	�}t
||d�W5QR�SW5QRXt|
||�S)z�Find 'module' by searching 'paths', and extract 'symbol'

    Return 'None' if 'module' does not exist on 'paths', or it does not define
    'symbol'.  If the module defines 'symbol' as a constant, return the
    constant.  Otherwise, return 'default'.N��exec)rr!r3r�read�marshal�loadrr	�get_frozen_objectr�compileZ
get_module�getattrr)r�symbolr#r"r$�path�suffix�modeZkind�info�codeZimportedrrrr`s

"cCs�||jkrdSt|j��|�}d}d}d}|}t|�D]H}|j}	|j}
|	|krZ|j|
}q6|
|krz|	|ksr|	|krz|S|}q6dS)aExtract the constant value of 'symbol' from 'code'

    If the name 'symbol' is bound to a constant value by the Python code
    object 'code', return that value.  If 'symbol' is bound to an expression,
    return 'default'.  Otherwise, return 'None'.

    Return value is based on the first assignment to 'symbol'.  'symbol' must
    be a global, or at least a non-"fast" local in the code block.  That is,
    only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol'
    must be present in 'code.co_names'.
    N�Z�a�d)�co_names�list�indexrZopcode�arg�	co_consts)rBr=r#Zname_idxZ
STORE_NAMEZSTORE_GLOBALZ
LOAD_CONST�constZ	byte_code�oprIrrrr}s
cCs>tj�d�stjdkrdSd}|D]}t�|=t�|�q"dS)z�
    Patch the globals to remove the objects not available on some platforms.

    XXX it'd be better to test assertions about bytecode instead.
    �javaZcliN)rr)�sys�platform�
startswith�globals�__all__�remove)Zincompatiblerrrr�_update_globals�srT)r4N)r4)rNr8r0Zdistutils.versionrZ
py33compatrr	rrrrr
rRr
r3rrrTrrrr�<module>s"�D

$site-packages/setuptools/__pycache__/py27compat.cpython-38.opt-1.pyc000064400000003325151446177000021321 0ustar00U

�Qab��@s�dZddlZddlZddlmZdd�Zejr6dd�Ze��dkoFejZerPe	ndd	�Z
z,d
dlmZm
Z
mZmZd
dlmZmZWnJek
r�ddlZdd
lm
Z
mZmZddd�Zdd�Zdd�ZYnXdS)z2
Compatibility Support for Python 2.7 and earlier
�N)�sixcCs
|�|�S)zH
    Given an HTTPMessage, return all headers matching a given key.
    )Zget_all��message�key�r�9/usr/lib/python3.8/site-packages/setuptools/py27compat.py�get_all_headerssrcCs
|�|�S�N)Z
getheadersrrrrrsZLinuxcCs|Sr	r)�xrrr�<lambda>�r�)�find_module�PY_COMPILED�	PY_FROZEN�	PY_SOURCE)�get_frozen_object�
get_module)rrrc
Csj|�d�}|rf|�d�}t�||�\}}\}}}}	|tjkrP|pFdg}|g}q
|r
td||f��q
|	S)z7Just like 'imp.find_module()', but with package support�.r�__init__zCan't find %r in %s)�split�pop�imprZ
PKG_DIRECTORY�ImportError)
�module�paths�parts�part�f�path�suffix�modeZkind�inforrrr's



rcCs
t�|�Sr	)rr)rrrrrr7srcCstj|f|��tj|Sr	)r�load_module�sys�modules)rrr"rrrr:sr)N)�__doc__r$�platformZsetuptools.externrrZPY2�systemZlinux_py2_ascii�strZrmtree_safe�_imprrrrrrrrrrrr�<module>s&�
site-packages/setuptools/__pycache__/pep425tags.cpython-38.pyc000064400000016043151446177000020254 0ustar00U

�Qabm*�@s�dZddlmZddlZddlmZddlZddlZddlZddl	Z	ddl
Z
ddlmZddl
mZddlmZe�d	�Zd
d�Zdd
�Zdd�Zdd�Zdd�Zd$dd�Zdd�Zdd�Zdd�Zdd�Zdd �Zd%d"d#�Ze�ZdS)&z2Generate and work with PEP 425 Compatibility Tags.�)�absolute_importN)�log)�OrderedDict�)�six)�glibcz(.+)_(\d+)_(\d+)_(.+)c
CsLzt�|�WStk
rF}zt�d�|�t�WY�dSd}~XYnXdS)Nz{})�	sysconfig�get_config_var�IOError�warnings�warn�format�RuntimeWarning)�var�e�r�9/usr/lib/python3.8/site-packages/setuptools/pep425tags.pyr	s
r	cCs:ttd�rd}n&tj�d�r"d}ntjdkr2d}nd}|S)z'Return abbreviated implementation name.�pypy_version_info�pp�javaZjyZcliZip�cp)�hasattr�sys�platform�
startswith)Zpyimplrrr�
get_abbr_impls

rcCs,td�}|rt�dkr(d�ttt���}|S)zReturn implementation version.Zpy_version_nodotr�)r	r�join�map�str�get_impl_version_info)Zimpl_verrrr�get_impl_ver+sr!cCs:t�dkr"tjdtjjtjjfStjdtjdfSdS)zQReturn sys.version_info-like tuple for use in decrementing the minor
    version.rrrN)rr�version_infor�major�minorrrrrr 3s

�r cCsd�t�t��S)z;
    Returns the Tag for this specific implementation.
    z{}{})r
rr!rrrr�get_impl_tag>sr%TcCs.t|�}|dkr&|r t�d|�|�S||kS)zgUse a fallback method for determining SOABI flags if the needed config
    var is unset or unavailable.Nz>Config variable '%s' is unset, Python ABI tag may be incorrect)r	r�debug)rZfallback�expectedr�valrrr�get_flagEs�r)cs�td�}t��|s��dkr�ttd�r�d}d}d}tddd��dkd	�rJd
}td�fdd��dkd	�rhd
}tddd�d�dko�tjd�r�tjr�d}d�t�|||f}n@|r�|�d�r�d|�	d�d}n|r�|�
dd��
dd�}nd}|S)zXReturn the ABI tag based on SOABI (if available) or emulate SOABI
    (CPython 2, PyPy).ZSOABI>rr�
maxunicoderZPy_DEBUGcSs
ttd�S)NZgettotalrefcount)rrrrrr�<lambda>[�zget_abi_tag.<locals>.<lambda>r)r�dZ
WITH_PYMALLOCcs�dkS)Nrrr��implrrr+_r,�mZPy_UNICODE_SIZEcSs
tjdkS)Ni��)rr*rrrrr+cr,�)r'r�uz
%s%s%s%s%szcpython-�-r�.�_N)r	rrrr)rZPY2r!r�split�replace)Zsoabir-r0r2�abirr.r�get_abi_tagQs@�
���r9cCs
tjdkS)Ni���)r�maxsizerrrr�_is_running_32bitssr;cCs�tjdkr^t��\}}}|�d�}|dkr6t�r6d}n|dkrHt�rHd}d�|d|d	|�Stj���	dd
��	dd
�}|dkr�t�r�d
}|S)z0Return our platform name 'win32', 'linux_x86_64'�darwinr4�x86_64�i386�ppc64�ppczmacosx_{}_{}_{}rrr5r3�linux_x86_64�
linux_i686)
rrZmac_verr6r;r
�	distutils�util�get_platformr7)�releaser5�machineZ	split_ver�resultrrrrEws

rEc	CsHt�dkrdSzddl}t|j�WSttfk
r:YnXt�dd�S)N>rArBFr��)rE�
_manylinux�boolZmanylinux1_compatible�ImportError�AttributeErrorrZhave_compatible_glibc)rKrrr�is_manylinux1_compatible�s
rOcsrg}��fdd��tddddg���|||�r8|�|��D]&}|�|kr<�|||�r<|�|�q<|�d�|S)z�Return a list of supported arches (including group arches) for
    the given major, minor and machine architecture of a macOS machine.
    cs||dkr||fdkS|dkr(||fdkS|dkr<||fdkS|dkrP||fdkS|�krx�|D]}�|||�r`dSq`dS)	Nr@)�
rJr?r>)rPr1r=TFr)r#r$�arch�garch��_supports_arch�groupsrrrT�sz)get_darwin_arches.<locals>._supports_arch)Zfat)r>r@)Zintel)r=r>)Zfat64)r=r?)Zfat32)r=r>r@Z	universal)r�append)r#r$rG�archesrRrrSr�get_darwin_arches�s$�

rXFc	Cs�g}|dkrTg}t�}|dd�}t|ddd�D] }|�d�tt||f���q2|p\t�}g}	|pjt�}|r~|g|	dd�<t�}
ddl	}|�
�D],}|d�d�r�|
�|d�
dd�d�q�|	�tt|
���|	�d	�|�sT|p�t�}
|
�d
��rzt�|
�}|�rr|��\}}}}d�||�}g}ttt|�d��D]0}tt|�||�D]}|�|||f��qR�q>n|
g}n*|dk�r�t��r�|
�dd
�|
g}n|
g}|	D].}|D]"}
|�d||df||
f��q��q�|dd�D]F}|dk�r��q,|
D]*}|D]}
|�d||f||
f��q�q��q�|D]"}
|�d|ddd	|
f��q0|�d||dfd	df�|�d||ddfd	df�t|�D]B\}}|�d|fd	df�|dk�r�|�d|dd	df��q�|S)acReturn a list of supported tags for each version specified in
    `versions`.

    :param versions: a list of string versions, of the form ["33", "32"],
        or None. The first version will be assumed to support our ABI.
    :param platform: specify the exact platform you want valid
        tags for, or None. If None, use the local system platform.
    :param impl: specify the exact implementation you want valid
        tags for, or None. If None, use the local interpreter impl.
    :param abi: specify the exact abi you want valid
        tags for, or None. If None, use the local interpreter abi.
    N���rrz.abir4rIrZnoneZmacosxz{}_{}_%i_%sZlinuxZ
manylinux1z%s%s>�30�31zpy%s�any)r �rangerVrrrrr9�set�impZget_suffixesr�addr6�extend�sorted�listrE�
_osx_arch_pat�matchrUr
�reversed�intrXrOr7�	enumerate)ZversionsZnoarchrr/r8Z	supportedr"r#r$ZabisZabi3sr_�suffixrQre�nameZactual_archZtplrWr0�a�version�irrr�
get_supported�sh




$
$  
rn)TT)NFNNN) �__doc__Z
__future__rZdistutils.utilrCrr�rerrr�collectionsrZexternrrr�compilerdr	rr!r r%r)r9r;rErOrXrnZimplementation_tagrrrr�<module>s8


"=�
`site-packages/setuptools/__pycache__/lib2to3_ex.cpython-38.pyc000064400000004553151446177000020333 0ustar00U

�Qab��@sXdZddlmZddlmZddlmZmZddl	Z	Gdd�de�Z
Gdd	�d	e�ZdS)
zy
Customized Mixin2to3 support:

 - adds support for converting doctests


This module raises an ImportError on Python 2.
�)�	Mixin2to3)�log)�RefactoringTool�get_fixers_from_packageNc@s$eZdZdd�Zdd�Zdd�ZdS)�DistutilsRefactoringToolcOstj|f|��dS�N)r�error)�self�msg�args�kw�r
�9/usr/lib/python3.8/site-packages/setuptools/lib2to3_ex.py�	log_errorsz"DistutilsRefactoringTool.log_errorcGstj|f|��dSr)r�info�r	r
rr
r
r�log_messagesz$DistutilsRefactoringTool.log_messagecGstj|f|��dSr)r�debugrr
r
r�	log_debugsz"DistutilsRefactoringTool.log_debugN)�__name__�
__module__�__qualname__rrrr
r
r
rrsrc@s&eZdZd	dd�Zdd�Zdd�ZdS)
rFcCsr|jjdk	rdS|sdSt�dd�|��|��|��|rbtjrnt	|j
�}|j|ddd�nt�
||�dS)NTzFixing � )�writeZ
doctests_only)�distributionZuse_2to3rr�join�_Mixin2to3__build_fixer_names�_Mixin2to3__exclude_fixers�
setuptoolsZrun_2to3_on_doctestsr�fixer_namesZrefactor�
_Mixin2to3�run_2to3)r	�filesZdoctests�rr
r
rr!s
zMixin2to3.run_2to3cCsZ|jr
dSg|_tjD]}|j�t|��q|jjdk	rV|jjD]}|j�t|��q@dSr)rrZlib2to3_fixer_packages�extendrrZuse_2to3_fixers)r	�pr
r
rZ__build_fixer_names.s
zMixin2to3.__build_fixer_namescCsJt|dg�}|jjdk	r&|�|jj�|D]}||jkr*|j�|�q*dS)NZexclude_fixers)�getattrrZuse_2to3_exclude_fixersr$r�remove)r	Zexcluded_fixersZ
fixer_namer
r
rZ__exclude_fixers8s
zMixin2to3.__exclude_fixersN)F)rrrr!rrr
r
r
rrs

r)�__doc__Zdistutils.utilrr Z	distutilsrZlib2to3.refactorrrrrr
r
r
r�<module>s	site-packages/setuptools/__pycache__/ssl_support.cpython-38.pyc000064400000015307151446177000020755 0ustar00U

�Qab-!�@s�ddlZddlZddlZddlZddlZddlmZmZmZm	Z	ddl
mZmZzddl
Z
Wnek
rtdZ
YnXdddddgZd	����ZzejjZejZWnek
r�eZZYnXe
dk	o�eeefkZzdd
l
mZmZWnRek
�r:zddlmZddlmZWnek
�r4dZdZYnXYnXe�sRGd
d�de�Ze�sjddd�Zdd�ZGdd�de�ZGdd�de�Zd dd�Z dd�Z!e!dd��Z"dd�Z#dd�Z$dS)!�N)�urllib�http_client�map�filter)�ResolutionError�ExtractionError�VerifyingHTTPSHandler�find_ca_bundle�is_available�
cert_paths�
opener_fora
/etc/pki/tls/certs/ca-bundle.crt
/etc/ssl/certs/ca-certificates.crt
/usr/share/ssl/certs/ca-bundle.crt
/usr/local/share/certs/ca-root.crt
/etc/ssl/cert.pem
/System/Library/OpenSSL/certs/cert.pem
/usr/local/share/certs/ca-root-nss.crt
/etc/ssl/ca-bundle.pem
)�CertificateError�match_hostname)r
)rc@seZdZdS)r
N)�__name__�
__module__�__qualname__�rr�:/usr/lib/python3.8/site-packages/setuptools/ssl_support.pyr
5sr
�c
Cs�g}|sdS|�d�}|d}|dd�}|�d�}||krLtdt|���|s`|��|��kS|dkrt|�d�n>|�d	�s�|�d	�r�|�t�|��n|�t�|��	d
d��|D]}|�t�|��q�t�
dd
�|�dtj�}	|	�
|�S)zqMatching according to RFC 6125, section 6.4.3

        https://tools.ietf.org/html/rfc6125#section-6.4.3
        F�.rrN�*z,too many wildcards in certificate DNS name: z[^.]+zxn--z\*z[^.]*z\Az\.z\Z)�split�countr
�repr�lower�append�
startswith�re�escape�replace�compile�join�
IGNORECASE�match)
Zdn�hostnameZ
max_wildcardsZpats�partsZleftmostZ	remainderZ	wildcardsZfragZpatrrr�_dnsname_match;s,


�r&cCs�|std��g}|�dd�}|D]*\}}|dkr t||�r@dS|�|�q |s�|�dd�D]6}|D],\}}|dkrdt||�r�dS|�|�qdq\t|�dkr�td	|d
�tt|��f��n*t|�dkr�td||df��ntd
��dS)a=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.
        zempty or no certificateZsubjectAltNamerZDNSNZsubjectZ
commonNamerz&hostname %r doesn't match either of %sz, zhostname %r doesn't match %rrz=no appropriate commonName or subjectAltName fields were found)	�
ValueError�getr&r�lenr
r!rr)Zcertr$ZdnsnamesZsan�key�value�subrrrros2

�
�rc@s eZdZdZdd�Zdd�ZdS)rz=Simple verifying handler: no auth, subclasses, timeouts, etc.cCs||_t�|�dS�N)�	ca_bundle�HTTPSHandler�__init__)�selfr.rrrr0�szVerifyingHTTPSHandler.__init__cs���fdd�|�S)Ncst|�jf|�Sr-)�VerifyingHTTPSConnr.)�host�kw�r1rr�<lambda>��z2VerifyingHTTPSHandler.https_open.<locals>.<lambda>)Zdo_open)r1Zreqrr5r�
https_open�s
�z VerifyingHTTPSHandler.https_openN)rrr�__doc__r0r8rrrrr�sc@s eZdZdZdd�Zdd�ZdS)r2z@Simple verifying connection: no auth, subclasses, timeouts, etc.cKstj||f|�||_dSr-)�HTTPSConnectionr0r.)r1r3r.r4rrrr0�szVerifyingHTTPSConn.__init__cCs�t�|j|jft|dd��}t|d�rHt|dd�rH||_|��|j}n|j}tt	d�rxt	j
|jd�}|j||d�|_nt	j|t	j
|jd�|_zt|j��|�Wn.tk
r�|j�tj�|j���YnXdS)NZsource_address�_tunnel�_tunnel_host�create_default_context)Zcafile)Zserver_hostname)Z	cert_reqsZca_certs)�socketZcreate_connectionr3Zport�getattr�hasattr�sockr;r<�sslr=r.Zwrap_socketZ
CERT_REQUIREDrZgetpeercertr
ZshutdownZ	SHUT_RDWR�close)r1rAZactual_hostZctxrrr�connect�s.

�
�
zVerifyingHTTPSConn.connectN)rrrr9r0rDrrrrr2�sr2cCstj�t|pt���jS)z@Get a urlopen() replacement that uses ca_bundle for verification)r�requestZbuild_openerrr	�open)r.rrrr�s�cst����fdd��}|S)Ncst�d�s�||��_�jS)N�always_returns)r@rG)�args�kwargs��funcrr�wrapper�s
zonce.<locals>.wrapper)�	functools�wraps)rKrLrrJr�once�srOcsZzddl}Wntk
r"YdSXG�fdd�d|j����}|�d�|�d�|jS)Nrcs,eZdZ��fdd�Z��fdd�Z�ZS)z"get_win_certfile.<locals>.CertFilecst�|���t�|j�dSr-)�superr0�atexit�registerrCr5��CertFile�	__class__rrr0�sz+get_win_certfile.<locals>.CertFile.__init__cs,zt�|���Wntk
r&YnXdSr-)rPrC�OSErrorr5rSrrrC�sz(get_win_certfile.<locals>.CertFile.close)rrrr0rC�
__classcell__r�rT)rUrrT�srTZCAZROOT)�wincertstore�ImportErrorrTZaddstore�name)rYZ	_wincertsrrXr�get_win_certfile�s

r\cCs$ttjjt�}t�p"t|d�p"t�S)z*Return an existing CA bundle path, or NoneN)r�os�path�isfilerr\�next�_certifi_where)Zextant_cert_pathsrrrr	�s��c
Cs.ztd���WStttfk
r(YnXdS)NZcertifi)�
__import__�whererZrrrrrrrasra)r)N)%r]r>rQrrMZsetuptools.extern.six.movesrrrrZ
pkg_resourcesrrrBrZ�__all__�striprrrEr/r:�AttributeError�objectr
r
rZbackports.ssl_match_hostnamer'r&rr2rrOr\r	rarrrr�<module>sZ
�

4)
(
	

site-packages/setuptools/__pycache__/dist.cpython-38.pyc000064400000122323151446177000017320 0ustar00U

�Qab���@sdgZddlZddlZddlZddlZddlZddlZddlZddl	Zddl
ZddlZddlm
Z
ddlmZddlmZddlZddlmZddlmZddlmZmZmZdd	lmZdd
lmZddlmZddlm Z dd
lm!Z!ddl"m#Z#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0Z0e1d�e1d�dd�Z2dd�Z3dd�Z4dd�Z5e6e7fZ8dd �Z9d!d"�Z:d#d$�Z;d%d&�Z<d'd(�Z=d)d*�Z>d+d,�Z?d-d.�Z@d/d0�ZAd1d2�ZBd3d4�ZCd5d6�ZDe-ejEjF�ZGGd7d�deG�ZFGd8d9�d9�ZHGd:d;�d;e'�ZIdS)<�Distribution�N)�	strtobool)�DEBUG��translate_longopt)�defaultdict)�message_from_file)�DistutilsOptionError�DistutilsPlatformError�DistutilsSetupError)�
rfc822_escape)�
StrictVersion)�six)�	packaging)�ordered_set)�map�filter�filterfalse�)�SetuptoolsDeprecationWarning)�Require)�windows_support)�
get_unpatched)�parse_configurationz&setuptools.extern.packaging.specifiersz#setuptools.extern.packaging.versioncCst�dt�t|�S)NzDo not call this function)�warnings�warn�DistDeprecationWarningr)�cls�r�3/usr/lib/python3.8/site-packages/setuptools/dist.py�_get_unpatched-sr cCs�t|dd�}|dkr�|js |jr*td�}nd|jdk	sT|jdk	sTt|dd�dk	sT|jr^td�}n0|js||js||j	s||j
s||jr�td�}ntd�}||_|S)N�metadata_versionz2.1�python_requires�1.2�1.1z1.0)
�getattr�long_description_content_type�provides_extrasr
�
maintainer�maintainer_email�project_urls�provides�requires�	obsoletes�classifiers�download_urlr!)�selfZmvrrr�get_metadata_version2s*

���
��
r1cs t|���fdd�}�fdd�}t�d�|_|d�|_|d�|_|d�|_|d	�|_d
|_|d�|_d
|_	|d�|_
|d
�|_d�kr�|d�|_nd
|_|d�|_
|d�|_d�kr�|d��d�|_|d�|_|d�|_|jtd�k�r
|d�|_|d�|_|d�|_nd
|_d
|_d
|_d
S)z-Reads the metadata values from a file object.cs�|}|dkrdS|S)NZUNKNOWNr)�name�value��msgrr�_read_fieldLsz"read_pkg_file.<locals>._read_fieldcs��|d�}|gkrdS|S�N)Zget_all)r2�valuesr4rr�
_read_listRsz!read_pkg_file.<locals>._read_listzmetadata-versionr2�versionZsummary�authorNzauthor-emailz	home-page�licensezdownload-url�description�keywords�,�platformZ
classifierr$r,r+r-)rr
r!r2r:r=r;r(�author_emailr)Zurlr<r/Zlong_description�splitr>Z	platformsr.r,r+r-)r0�filer6r9rr4r�
read_pkg_fileHs:












rDc
s���}tjr��fdd�}n�fdd�}|dt|��|d����|d����|d����|d����|td	�kr�|d
��	��|d��
��n.d}|D]$\}}t�|�}|d
k	r�|||�q�|d�����j
r�|d�j
��j��D]}|dd|�q�t����}	|d|	�d�����}
|
�r:|d|
�|td	�k�rd���D]}|d|��qPn���d�������d�������d�������d�������d����t�d��r�|d�j��j�r�|d�j��j�r
�jD]}|d|��q�d
S)z5Write the PKG-INFO format data to a file object.
    cs��d|��|�f�dS�Nz%s: %s
)�writeZ
_encode_field��keyr3�rCr0rr�write_field�sz#write_pkg_file.<locals>.write_fieldcs��d||f�dSrE)rFrG)rCrrrJ�szMetadata-Version�Name�VersionZSummaryz	Home-pager#�Author�Author-email))rMr;)rNrA)Z
Maintainerr()zMaintainer-emailr)NZLicensezDownload-URLzProject-URLz%s, %sZDescriptionr?ZKeywordsZPlatformZ
ClassifierZRequiresZProvidesZ	Obsoletesr"zRequires-PythonzDescription-Content-TypezProvides-Extra)r1r�PY2�strZget_nameZget_versionZget_descriptionZget_urlr
Zget_contactZget_contact_emailr%Zget_licenser/r*�itemsrZget_long_description�joinZget_keywordsZ
get_platformsZ_write_listZget_classifiersZget_requiresZget_providesZ
get_obsoletes�hasattrr"r&r')
r0rCr:rJZoptional_fieldsZfield�attrZattr_valZproject_urlZ	long_descr>r@�extrarrIr�write_pkg_file~sZ


�
rVcCsPztj�d|�}|jrt�Wn,ttttfk
rJtd||f��YnXdS)Nzx=z4%r must be importable 'module:attrs' string (got %r))	�
pkg_resources�
EntryPoint�parse�extras�AssertionError�	TypeError�
ValueError�AttributeErrorr)�distrTr3�eprrr�check_importable�s��racCsZz(t|ttf�st�d�|�|ks&t�Wn,ttttfk
rTtd||f��YnXdS)z"Verify that value is a string list�z%%r must be a list of strings (got %r)N)	�
isinstance�list�tupler[rRr\r]r^r�r_rTr3rrr�assert_string_list�s
�rgcCsd|}t|||�|D]J}|�|�s2tdd|��|�d�\}}}|r||krtj�d||�qdS)z(Verify that namespace packages are validz1Distribution contains no modules or packages for znamespace package %r�.z^WARNING: %r is declared as a package namespace, but %r is not: please correct this in setup.pyN)rg�has_contents_forr�
rpartition�	distutils�logr)r_rTr3Zns_packagesZnsp�parent�sepZchildrrr�	check_nsp�s 
���roc
Cs@ztt�t|����Wn"tttfk
r:td��YnXdS)z+Verify that extras_require mapping is validz�'extras_require' must be a dictionary whose values are strings or lists of strings containing valid project/version requirement specifiers.N)	rd�	itertools�starmap�_check_extrarQr\r]r^rrfrrr�check_extras�s�rscCs<|�d�\}}}|r*t�|�r*td|��tt�|��dS)N�:zInvalid environment marker: )�	partitionrWZinvalid_markerrrd�parse_requirements)rUZreqsr2rn�markerrrrrrsrrcCs&t|�|kr"d}t|j||d���dS)z)Verify that value is True, False, 0, or 1z0{attr!r} must be a boolean value (got {value!r}))rTr3N)�boolr�format)r_rTr3�tmplrrr�assert_boolsr{c
Csjz(tt�|��t|ttf�r&td��Wn<ttfk
rd}zd}t|j	||d���W5d}~XYnXdS)z9Verify that install_requires is a valid requirements listzUnordered types are not allowedzm{attr!r} must be a string or list of strings containing valid project/version requirement specifiers; {error}�rT�errorN)
rdrWrvrc�dict�setr\r]rry�r_rTr3r}rzrrr�check_requirementss�r�c
CsRztj�|�Wn<tjjk
rL}zd}t|j||d���W5d}~XYnXdS)z.Verify that value is a valid version specifierzF{attr!r} must be a string containing valid version specifiers; {error}r|N)rZ
specifiersZSpecifierSetZInvalidSpecifierrryr�rrr�check_specifier s�r�c
Cs@ztj�|�Wn*tk
r:}zt|��W5d}~XYnXdS)z)Verify that entry_points map is parseableN)rWrXZ	parse_mapr]r)r_rTr3�errr�check_entry_points,sr�cCst|tj�std��dS)Nztest_suite must be a string)rcr�string_typesrrfrrr�check_test_suite4sr�cCs\t|t�std�|���|��D]6\}}t|tj�sDtd�||���t|d�|�|�q dS)z@Verify that value is a dictionary of package names to glob listszT{!r} must be a dictionary mapping package names to lists of string wildcard patternsz,keys of {!r} dict must be strings (got {!r})zvalues of {!r} dictN)rcr~rryrQrr�rg)r_rTr3�k�vrrr�check_package_data9s
����r�cCs(|D]}t�d|�stj�d|�qdS)Nz\w+(\.\w+)*z[WARNING: %r not a valid package name; please use only .-separated package names in setup.py)�re�matchrkrlr)r_rTr3Zpkgnamerrr�check_packagesHs�r�c@sReZdZdZdeejd�ZdZdd�Z	dMdd�Z
dd	�Zd
d�Ze
dd
��Zdd�Zdd�ZdNdd�Ze
dd��ZdOdd�ZdPdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Z d3d4�Z!d5d6�Z"d7d8�Z#d9d:�Z$d;d<�Z%d=d>�Z&d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*dGdH�Z+dIdJ�Z,dKdL�Z-dS)Qra�Distribution with support for features, tests, and package data

    This is an enhanced version of 'distutils.dist.Distribution' that
    effectively adds the following new optional keyword arguments to 'setup()':

     'install_requires' -- a string or sequence of strings specifying project
        versions that the distribution requires when installed, in the format
        used by 'pkg_resources.require()'.  They will be installed
        automatically when the package is installed.  If you wish to use
        packages that are not available in PyPI, or want to give your users an
        alternate download location, you can add a 'find_links' option to the
        '[easy_install]' section of your project's 'setup.cfg' file, and then
        setuptools will scan the listed web pages for links that satisfy the
        requirements.

     'extras_require' -- a dictionary mapping names of optional "extras" to the
        additional requirement(s) that using those extras incurs. For example,
        this::

            extras_require = dict(reST = ["docutils>=0.3", "reSTedit"])

        indicates that the distribution can optionally provide an extra
        capability called "reST", but it can only be used if docutils and
        reSTedit are installed.  If the user installs your package using
        EasyInstall and requests one of your extras, the corresponding
        additional requirements will be installed if needed.

     'features' **deprecated** -- a dictionary mapping option names to
        'setuptools.Feature'
        objects.  Features are a portion of the distribution that can be
        included or excluded based on user options, inter-feature dependencies,
        and availability on the current system.  Excluded features are omitted
        from all setup commands, including source and binary distributions, so
        you can create multiple distributions from the same source tree.
        Feature names should be valid Python identifiers, except that they may
        contain the '-' (minus) sign.  Features can be included or excluded
        via the command line options '--with-X' and '--without-X', where 'X' is
        the name of the feature.  Whether a feature is included by default, and
        whether you are allowed to control this from the command line, is
        determined by the Feature object.  See the 'Feature' class for more
        information.

     'test_suite' -- the name of a test suite to run for the 'test' command.
        If the user runs 'python setup.py test', the package will be installed,
        and the named test suite will be run.  The format is the same as
        would be used on a 'unittest.py' command line.  That is, it is the
        dotted name of an object to import and call to generate a test suite.

     'package_data' -- a dictionary mapping package names to lists of filenames
        or globs to use to find data files contained in the named packages.
        If the dictionary has filenames or globs listed under '""' (the empty
        string), those names will be searched for in every package, in addition
        to any names for the specific package.  Data files found using these
        names/globs will be installed along with the package, in the same
        location as the package.  Note that globs are allowed to reference
        the contents of non-package subdirectories, as long as you use '/' as
        a path separator.  (Globs are automatically converted to
        platform-specific paths at runtime.)

    In addition to these new keywords, this class also has several new methods
    for manipulating the distribution's contents.  For example, the 'include()'
    and 'exclude()' methods can be thought of as in-place add and subtract
    commands that add or remove packages, modules, extensions, and so on from
    the distribution.  They are used by the feature subsystem to configure the
    distribution for the included and excluded features.
    N)r&r*r'cCsl|rd|ksd|krdSt�t|d����}tjj�|�}|dk	rh|�d�sht�t|d��|_	||_
dS)Nr2r:zPKG-INFO)rWZ	safe_namerP�lower�working_setZby_key�getZhas_metadataZsafe_versionZ_version�
_patched_dist)r0�attrsrHr_rrr�patch_missing_pkg_info�sz#Distribution.patch_missing_pkg_infoc
	s�t�d�}|si�_|pi}d|ks,d|kr4t��g�_i�_g�_|�dd��_��	|�|�dg��_
|�dg��_t�
d�D]}t���|jd�q�t���fdd	�|��D���j��D]L\}}�jj|fD]}||kr�||}�qq�|r�|�nd}t�j||�q�t�jjtj��r4t�jj��j_�jjdk	�r�zHtj��jj�}t|�}	�jj|	k�r�t� d
�jj|	f�|	�j_Wn0tjj!t"fk
�r�t� d�jj�YnX��#�dS)N�package_data�features�require_features�src_root�dependency_links�setup_requires�distutils.setup_keywordscs i|]\}}|�jkr||�qSr)�_DISTUTILS_UNSUPPORTED_METADATA��.0r�r��r0rr�
<dictcomp>�s
�z)Distribution.__init__.<locals>.<dictcomp>zNormalizing '%s' to '%s'z�The version specified (%r) is an invalid version, this may not work as expected with newer versions of setuptools, pip, and PyPI. Please see PEP 440 for more details.)$rSr��Feature�warn_deprecatedr�r�Z
dist_files�popr�r�r�r�rW�iter_entry_points�vars�
setdefaultr2�
_Distribution�__init__rQr��metadata�__dict__�setattrrcr:�numbers�NumberrPrrLrrZInvalidVersionr\�_finalize_requires)
r0r�Zhave_package_datar`�option�default�sourcer3ZverZnormalized_versionrr�rr��s\

�����
zDistribution.__init__cCsft|dd�r|j|j_t|dd�rR|j��D]$}|�d�d}|r,|jj�|�q,|��|�	�dS)z�
        Set `metadata.python_requires` and fix environment markers
        in `install_requires` and `extras_require`.
        r"N�extras_requirertr)
r%r"r�r��keysrBr'�add�_convert_extras_requirements�"_move_install_requirements_markers)r0rUrrrr��s
zDistribution._finalize_requirescCsht|dd�pi}tt�|_|��D]@\}}|j|t�|�D]"}|�|�}|j||�|�q>q"dS)z�
        Convert requirements in `extras_require` of the form
        `"extra": ["barbazquux; {marker}"]` to
        `"extra:{marker}": ["barbazquux"]`.
        r�N)	r%rrd�_tmp_extras_requirerQrWrv�_suffix_for�append)r0Z
spec_ext_reqs�sectionr��r�suffixrrrr��s


z)Distribution._convert_extras_requirementscCs|jrdt|j�SdS)ze
        For a requirement, return the 'extras_require' suffix for
        that requirement.
        rtrb)rwrP��reqrrrr�szDistribution._suffix_forcs�dd�}t�dd�pd}tt�|��}t||�}t||�}ttt|���_|D]}�j	dt|j
��|�qNt�fdd��j	�
�D���_dS)	zv
        Move requirements in `install_requires` that are using environment
        markers `extras_require`.
        cSs|jSr7�rwr�rrr�
is_simple_reqszFDistribution._move_install_requirements_markers.<locals>.is_simple_req�install_requiresNrrtc3s,|]$\}}|dd�t�j|�D�fVqdS)cSsg|]}t|��qSr)rP�r�r�rrr�
<listcomp>)szMDistribution._move_install_requirements_markers.<locals>.<genexpr>.<listcomp>N)r�
_clean_reqr�r�rr�	<genexpr>(s�zBDistribution._move_install_requirements_markers.<locals>.<genexpr>)r%rdrWrvrrrrPr�r�rwr�r~rQr�)r0r�Zspec_inst_reqsZ	inst_reqsZsimple_reqsZcomplex_reqsr�rr�rr�s


�z/Distribution._move_install_requirements_markerscCs
d|_|S)zP
        Given a Requirement, remove environment markers and return it.
        Nr�)r0r�rrrr�-szDistribution._clean_reqc
Cs�ddlm}tjr>tjtjkr>ddddddd	d
ddd
ddg
}ng}t|�}|dkrZ|��}t	rh|�
d�|�}|D]�}tj|dd��4}t	r�|�
dj
ft���tjr�|jn|j|�W5QRX|��D]\}|�|�}|�|�}	|D]>}
|
dkr�|
|kr�|�|�||
��}|
�dd�}
||f|	|
<q�q�|��qrd|jk�r�|jd��D]�\}
\}}|j�|
�}
zF|
�r|t||
t|��n(|
dk�r�t||
t|��nt||
|�Wn,tk
�r�}zt|��W5d}~XYnX�qHdS)z�
        Adapted from distutils.dist.Distribution.parse_config_files,
        this method provides the same functionality in subtly-improved
        ways.
        r)�ConfigParserzinstall-basezinstall-platbasezinstall-libzinstall-platlibzinstall-purelibzinstall-headerszinstall-scriptszinstall-data�prefixzexec-prefix�home�user�rootNz"Distribution.parse_config_files():�utf-8)�encodingz  reading {filename}�__name__�-�_�global)�verboseZdry_run)Z(setuptools.extern.six.moves.configparserr�r�PY3�sysr��base_prefix�	frozensetZfind_config_filesr�announce�io�openry�localsZ	read_fileZreadfpZsections�options�get_option_dict�_try_strr��replacer��command_optionsrQ�negative_optr�rr]r	)r0�	filenamesr�Zignore_options�parser�filename�readerr�r�Zopt_dict�opt�val�src�aliasr5rrr�_parse_config_files4s`�
 



z Distribution._parse_config_filescCs.tjr
|Sz
|��WStk
r(YnX|S)ab
        On Python 2, much of distutils relies on string values being of
        type 'str' (bytes) and not unicode text. If the value can be safely
        encoded to bytes using the default encoding, prefer that.

        Why the default encoding? Because that value can be implicitly
        decoded back to text if needed.

        Ref #1653
        )rr��encode�UnicodeEncodeError)r�rrrr�rs
zDistribution._try_strcCs^|��}|dkr|�|�}tr,|�d|�|��D�]"\}\}}trZ|�d|||f�zdd�|jD�}Wntk
r�g}YnXz
|j}Wntk
r�i}YnXz~t|t	j
�}	||kr�|	r�t|||t|��nJ||kr�|	r�t||t|��n,t
||��rt|||�ntd|||f��Wq4tk
�rV}
zt|
��W5d}
~
XYq4Xq4dS)a�
        Set the options for 'command_obj' from 'option_dict'.  Basically
        this means copying elements of a dictionary ('option_dict') to
        attributes of an instance ('command').

        'command_obj' must be a Command instance.  If 'option_dict' is not
        supplied, uses the standard option dictionary for this command
        (from 'self.command_options').

        (Adopted from distutils.dist.Distribution._set_command_options)
        Nz#  setting options for '%s' command:z    %s = %s (from %s)cSsg|]}t|��qSrr)r��orrrr��s�z5Distribution._set_command_options.<locals>.<listcomp>z1error in %s: command '%s' has no such option '%s')Zget_command_namer�rr�rQZboolean_optionsr^r�rcrr�r�rrSr	r])r0Zcommand_objZoption_dictZcommand_namer�r�r3Z	bool_opts�neg_optZ	is_stringr5rrr�_set_command_options�sF

��



��z!Distribution._set_command_optionsFcCs(|j|d�t||j|d�|��dS)zYParses configuration files from various levels
        and loads configuration.

        )r�)�ignore_option_errorsN)r�rr�r�)r0r�r�rrr�parse_config_files�s
�zDistribution.parse_config_filescCst�|�}|jr|��|S)z3Process features after parsing command line options)r��parse_command_liner��_finalize_features)r0�resultrrrr��s
zDistribution.parse_command_linecCsd|�dd�S)z;Convert feature name to corresponding option attribute nameZwith_r�r��r��r0r2rrr�_feature_attrname�szDistribution._feature_attrnamecCs8tjjt�|�|jdd�}|D]}tjj|dd�q|S)zResolve pre-setup requirementsT)�	installerZreplace_conflictingr�)rWr��resolverv�fetch_build_eggr�)r0r,Zresolved_distsr_rrr�fetch_build_eggs�s�zDistribution.fetch_build_eggscCs�t�|�|jr|��t�d�D]:}t||jd�}|dk	r"|j|j	d�|�
�||j|�q"t|dd�r~dd�|jD�|_ng|_dS)Nr��r��convert_2to3_doctestscSsg|]}tj�|��qSr)�os�path�abspath�r��prrrr��s�z1Distribution.finalize_options.<locals>.<listcomp>)r��finalize_optionsr��_set_global_opts_from_featuresrWr�r%r2�requirer��loadr�)r0r`r3rrrr��s
�
zDistribution.finalize_optionsc	Csvtj�tjd�}tj�|�srt�|�t�|�tj�|d�}t|d��$}|�	d�|�	d�|�	d�W5QRX|S)Nz.eggsz
README.txt�wzcThis directory contains eggs that were downloaded by setuptools to build, test, and run plug-ins.

zAThis directory caches those eggs to prevent repeated downloads.

z/However, it is safe to delete this directory.

)
r�r�rR�curdir�exists�mkdirrZ	hide_filer�rF)r0Z
egg_cache_dirZreadme_txt_filename�frrr�get_egg_cache_dir�s



zDistribution.get_egg_cache_dirc
Cs�ddlm}|�ddgi�}|�d�}|��|�dd�|�d���D��|jr�|jdd�}d|krx|dd	|}d
|f|d<|��}||dg|dd
dd
d
ddd
d�}|�	�|�|�S)z Fetch an egg needed for buildingr)�easy_installZscript_argsr	css"|]\}}|dkr||fVqdS))�
find_links�	site_dirsZ	index_url�optimizerZallow_hostsNrr�rrrr��s�z/Distribution.fetch_build_egg.<locals>.<genexpr>Nr
rZsetup�xTF)
�args�install_dirZexclude_scriptsZalways_copyZbuild_directoryZeditableZupgradeZ
multi_versionZ	no_reportr�)
Zsetuptools.command.easy_installr	�	__class__r��clear�updaterQr�rZensure_finalized)r0r�r	r_�optsZlinksr�cmdrrrr��s8

��zDistribution.fetch_build_eggc	Cs�g}|j��}|j��D]�\}}|�|d�|�|�|jr|j}d}d}|��s\||}}d|dd||fd|dd||ff}|�	|�d||d|<q||j
|_
|_||_|_dS)z;Add --with-X/--without-X options based on optional featuresNz
 (default)rbzwith-zinclude zwithout-zexclude )
r��copyr�rQ�_set_feature�validate�optionalr=�include_by_default�extend�global_optionsZfeature_optionsZfeature_negopt)	r0ZgoZnor2�feature�descrZincdefZexcdef�newrrrrs$


�
z+Distribution._set_global_opts_from_featurescCs�|j��D]<\}}|�|�}|s0|dkr
|��r
|�|�|�|d�q
|j��D](\}}|�|�sR|�|�|�|d�qRdS)z9Add/remove features and resolve dependencies between themNrr)r�rQ�feature_is_includedr�
include_inr�exclude_from)r0r2rZenabledrrrr�0s



zDistribution._finalize_featurescCs\||jkr|j|St�d|�}|D]*}|j|jd�|��|j|<}|St�||�S)z(Pluggable version of get_command_class()�distutils.commandsr�N)�cmdclassrWr�rr�rr��get_command_class)r0�commandZepsr`r#rrrr$As

zDistribution.get_command_classcCs:t�d�D]$}|j|jkr
|��}||j|j<q
t�|�S�Nr")rWr�r2r#r�r��print_commands�r0r`r#rrrr'Ns
zDistribution.print_commandscCs:t�d�D]$}|j|jkr
|��}||j|j<q
t�|�Sr&)rWr�r2r#r�r��get_command_listr(rrrr)Vs
zDistribution.get_command_listcCst||�|�|�dS)zSet feature's inclusion statusN)r�r�)r0r2Zstatusrrrr^szDistribution._set_featurecCst||�|��S)zAReturn 1 if feature is included, 0 if excluded, 'None' if unknown)r%r�r�rrrrbsz Distribution.feature_is_includedcCsF|�|�dkr&|j|j}t|d��|j|�|�|�|d�dS)z)Request inclusion of feature named 'name'rz2 is required, but was excluded or is not availablerN)rr�r=r	r r)r0r2rrrr�include_featurefs�zDistribution.include_featurecKs@|��D]2\}}t|d|d�}|r.||�q|�||�qdS)a�Add items to distribution that are named in keyword arguments

        For example, 'dist.include(py_modules=["x"])' would add 'x' to
        the distribution's 'py_modules' attribute, if it was not already
        there.

        Currently, this method only supports inclusion for attributes that are
        lists or tuples.  If you need to add support for adding to other
        attributes in this or a subclass, you can add an '_include_X' method,
        where 'X' is the name of the attribute.  The method will be called with
        the value passed to 'include()'.  So, 'dist.include(foo={"bar":"baz"})'
        will try to call 'dist._include_foo({"bar":"baz"})', which can then
        handle whatever special inclusion logic is needed.
        Z	_include_N)rQr%�
_include_misc)r0r�r�r��includerrrr,qs

zDistribution.includecsf�d�|jr&��fdd�|jD�|_|jrD��fdd�|jD�|_|jrb��fdd�|jD�|_dS)z9Remove packages, modules, and extensions in named packagerhcs"g|]}|�kr|���s|�qSr��
startswithr���package�pfxrrr��s
�z0Distribution.exclude_package.<locals>.<listcomp>cs"g|]}|�kr|���s|�qSrr-r�r/rrr��s
�cs&g|]}|j�kr|j���s|�qSr)r2r.r�r/rrr��s
�N)�packages�
py_modules�ext_modules)r0r0rr/r�exclude_package�s���zDistribution.exclude_packagecCs2|d}|��D]}||ks&|�|�rdSqdS)z<Return true if 'exclude_package(package)' would do somethingrhTN)�iter_distribution_namesr.)r0r0r1r�rrrri�szDistribution.has_contents_forcs�t�t�std|�f��zt||�}Wn tk
rHtd|��YnX|dk	rjt|t�sjt|d��n|r�t||�fdd�|D��dS)zAHandle 'exclude()' for list/tuple attrs without a special handlerz(%s: setting must be a list or tuple (%r)� %s: No such distribution settingN�4: this setting cannot be changed via include/excludecsg|]}|�kr|�qSrr�r��item�r3rrr��sz.Distribution._exclude_misc.<locals>.<listcomp>�rc�sequencerr%r^r�)r0r2r3�oldrr;r�
_exclude_misc�s 

��
�zDistribution._exclude_misccs�t|t�std||f��zt||��Wn tk
rHtd|��YnX�dkr`t|||�n:t�t�sxt|d��n"�fdd�|D�}t||�|�dS)zAHandle 'include()' for list/tuple attrs without a special handlerz%s: setting must be a list (%r)r7Nr8csg|]}|�kr|�qSrrr9�r>rrr��sz.Distribution._include_misc.<locals>.<listcomp>r<)r0r2r3rrr@rr+�s$

��

�zDistribution._include_misccKs@|��D]2\}}t|d|d�}|r.||�q|�||�qdS)aRemove items from distribution that are named in keyword arguments

        For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from
        the distribution's 'py_modules' attribute.  Excluding packages uses
        the 'exclude_package()' method, so all of the package's contained
        packages, modules, and extensions are also excluded.

        Currently, this method only supports exclusion from attributes that are
        lists or tuples.  If you need to add support for excluding from other
        attributes in this or a subclass, you can add an '_exclude_X' method,
        where 'X' is the name of the attribute.  The method will be called with
        the value passed to 'exclude()'.  So, 'dist.exclude(foo={"bar":"baz"})'
        will try to call 'dist._exclude_foo({"bar":"baz"})', which can then
        handle whatever special exclusion logic is needed.
        Z	_exclude_N)rQr%r?)r0r�r�r��excluderrrrA�s

zDistribution.excludecCs,t|t�std|f��tt|j|��dS)Nz.packages: setting must be a list or tuple (%r))rcr=rrdrr5)r0r2rrr�_exclude_packages�s

�zDistribution._exclude_packagesc
Cs�|jj|_|jj|_|d}|�d�}||krf||\}}||=ddl}|�|d�|dd�<|d}q&t�|||�}|�|�}	t	|	dd�r�d|f|�|�d<|dk	r�gS|S)Nr�aliasesTrZcommand_consumes_arguments�command liner)
rrr�r��shlexrBr��_parse_command_optsr$r%)
r0r�rr%rCr�r�rE�nargsZ	cmd_classrrrrF�s"




z Distribution._parse_command_optscCs�i}|j��D]�\}}|��D]�\}\}}|dkr4q|�dd�}|dkr�|�|�}|j��}|�t|di��|��D]\}	}
|
|krv|	}d}q�qvtd��n|dkr�d}||�	|i�|<qq|S)	ahReturn a '{cmd: {opt:val}}' map of all command-line options

        Option names are all long, but do not include the leading '--', and
        contain dashes rather than underscores.  If the option doesn't take
        an argument (e.g. '--quiet'), the 'val' is 'None'.

        Note that options provided by config files are intentionally excluded.
        rDr�r�rr�NzShouldn't be able to get herer)
r�rQr�Zget_command_objr�rrr%r[r�)r0�drrr�r�r�Zcmdobjr��neg�posrrr�get_cmdline_optionss(



z Distribution.get_cmdline_optionsccsv|jpdD]
}|Vq
|jpdD]
}|Vq |jp4dD]:}t|t�rN|\}}n|j}|�d�rj|dd�}|Vq6dS)z@Yield all packages, modules, and extension names in distributionr�moduleNi����)r2r3r4rcrer2�endswith)r0ZpkgrLZextr2Z	buildinforrrr60s


z$Distribution.iter_distribution_namesc
Cs�ddl}tjs|jr t�||�St|jtj	�s:t�||�S|jj
��dkrVt�||�S|jj
}|jj}|j
dkrtdpvd}|jj}t�	|j��d|||�|_zt�||�W�St�	|j��||||�|_XdS)z�If there were any non-global "display-only" options
        (--help-commands or the metadata display options) on the command
        line, display the requested info and return true; else return
        false.
        rN)r��utf8Zwin32�
r�)r�rrOZ
help_commandsr��handle_display_optionsrc�stdoutr��
TextIOWrapperr�r��errorsr@�line_buffering�detach)r0Zoption_orderr�r�rS�newlinerTrrrrPBs6��z#Distribution.handle_display_options)N)N)N)NF).r��
__module__�__qualname__�__doc__r~rZ
OrderedSetr�r�r�r�r�r��staticmethodr�r�r�r�r�r�r�r�r�r�r�rr�rr�r$r'r)rrr*r,r5rir?r+rArBrFrKr6rPrrrrrTsXD�
;

>

/

	(c@sFeZdZdZedd��Zddd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)r�a�
    **deprecated** -- The `Feature` facility was never completely implemented
    or supported, `has reported issues
    <https://github.com/pypa/setuptools/issues/58>`_ and will be removed in
    a future version.

    A subset of the distribution that can be excluded if unneeded/wanted

    Features are created using these keyword arguments:

      'description' -- a short, human readable description of the feature, to
         be used in error messages, and option help messages.

      'standard' -- if true, the feature is included by default if it is
         available on the current system.  Otherwise, the feature is only
         included if requested via a command line '--with-X' option, or if
         another included feature requires it.  The default setting is 'False'.

      'available' -- if true, the feature is available for installation on the
         current system.  The default setting is 'True'.

      'optional' -- if true, the feature's inclusion can be controlled from the
         command line, using the '--with-X' or '--without-X' options.  If
         false, the feature's inclusion status is determined automatically,
         based on 'availabile', 'standard', and whether any other feature
         requires it.  The default setting is 'True'.

      'require_features' -- a string or sequence of strings naming features
         that should also be included if this feature is included.  Defaults to
         empty list.  May also contain 'Require' objects that should be
         added/removed from the distribution.

      'remove' -- a string or list of strings naming packages to be removed
         from the distribution if this feature is *not* included.  If the
         feature *is* included, this argument is ignored.  This argument exists
         to support removing features that "crosscut" a distribution, such as
         defining a 'tests' feature that removes all the 'tests' subpackages
         provided by other features.  The default for this argument is an empty
         list.  (Note: the named package(s) or modules must exist in the base
         distribution when the 'setup()' function is initially called.)

      other keywords -- any other keyword arguments are saved, and passed to
         the distribution's 'include()' and 'exclude()' methods when the
         feature is included or excluded, respectively.  So, for example, you
         could pass 'packages=["a","b"]' to cause packages 'a' and 'b' to be
         added or removed from the distribution as appropriate.

    A feature must include at least one 'requires', 'remove', or other
    keyword argument.  Otherwise, it can't affect the distribution in any way.
    Note also that you can subclass 'Feature' to create your own specialized
    feature types that modify the distribution in other ways when included or
    excluded.  See the docstrings for the various methods here for more detail.
    Aside from the methods, the only feature attributes that distributions look
    at are 'description' and 'optional'.
    cCsd}tj|tdd�dS)NzrFeatures are deprecated and will be removed in a future version. See https://github.com/pypa/setuptools/issues/65.�)�
stacklevel)rrrr4rrrr��s�zFeature.warn_deprecatedFTrc	Ks�|��||_||_||_||_t|ttf�r4|f}dd�|D�|_dd�|D�}|r^||d<t|t�rn|f}||_	||_
|s�|s�|s�td��dS)NcSsg|]}t|t�r|�qSr�rcrPr�rrrr��s
z$Feature.__init__.<locals>.<listcomp>cSsg|]}t|t�s|�qSrr]r�rrrr��s
r�zgFeature %s: must define 'require_features', 'remove', or at least one of 'packages', 'py_modules', etc.)r�r=�standard�	availablerrcrPrr��removerZr)	r0r=r^r_rr�r`rZZerrrrr��s*�
�zFeature.__init__cCs|jo
|jS)z+Should this feature be included by default?)r_r^r�rrrr�szFeature.include_by_defaultcCs<|jst|jd��|jf|j�|jD]}|�|�q(dS)aEnsure feature and its requirements are included in distribution

        You may override this in a subclass to perform additional operations on
        the distribution.  Note that this method may be called more than once
        per feature, and so should be idempotent.

        z3 is required, but is not available on this platformN)r_r
r=r,rZr�r*)r0r_rrrrr �s	�
zFeature.include_incCs.|jf|j�|jr*|jD]}|�|�qdS)a2Ensure feature is excluded from distribution

        You may override this in a subclass to perform additional operations on
        the distribution.  This method will be called at most once per
        feature, and only after all included features have been asked to
        include themselves.
        N)rArZr`r5�r0r_r:rrrr!�s	
zFeature.exclude_fromcCs.|jD]"}|�|�std|j||f��qdS)a�Verify that feature makes sense in context of distribution

        This method is called by the distribution just before it parses its
        command line.  It checks to ensure that the 'remove' attribute, if any,
        contains only valid package/module names that are present in the base
        distribution when 'setup()' is called.  You may override it in a
        subclass to perform any other required validation of the feature
        against a target distribution.
        zg%s wants to be able to remove %s, but the distribution doesn't contain any packages or modules under %sN)r`rirr=rarrrr�s


��zFeature.validateN)FTTrr)r�rWrXrYrZr�r�rr r!rrrrrr�es8
�
r�c@seZdZdZdS)rzrClass for warning about deprecations in dist in
    setuptools. Not ignored by default, unlike DeprecationWarning.N)r�rWrXrYrrrrr�sr)J�__all__r�r�r�r�rr�Z
distutils.logrkZdistutils.coreZ
distutils.cmdZdistutils.distZdistutils.utilrZdistutils.debugrZdistutils.fancy_getoptrrp�collectionsrZemailrZdistutils.errorsr	r
rrZdistutils.versionr
Zsetuptools.externrrrZsetuptools.extern.six.movesrrrrbrZsetuptools.dependsrZ
setuptoolsrZsetuptools.monkeyrZsetuptools.configrrW�
__import__r r1rDrVrerdr=rargrorsrrr{r�r�r�r�r�r�Zcorerr�r�rrrrr�<module>sv6L	site-packages/setuptools/__pycache__/dep_util.cpython-38.pyc000064400000001463151446177000020163 0ustar00U

�Qab��@sddlmZdd�ZdS)�)�newer_groupcCsht|�t|�krtd��g}g}tt|��D]2}t||||�r,|�||�|�||�q,||fS)z�Walk both arguments in parallel, testing if each source group is newer
    than its corresponding target. Returns a pair of lists (sources_groups,
    targets) where sources is newer than target, according to the semantics
    of 'newer_group()'.
    z5'sources_group' and 'targets' must be the same length)�len�
ValueError�ranger�append)Zsources_groupsZtargetsZ	n_sourcesZ	n_targets�i�r�7/usr/lib/python3.8/site-packages/setuptools/dep_util.py�newer_pairwise_groupsr
N)Zdistutils.dep_utilrr
rrrr	�<module>ssite-packages/setuptools/__pycache__/glibc.cpython-38.opt-1.pyc000064400000002772151446177000020401 0ustar00U

�QabJ�@sHddlmZddlZddlZddlZdd�Zdd�Zdd�Zd	d
�ZdS)�)�absolute_importNcCsRt�d�}z
|j}Wntk
r*YdSXtj|_|�}t|t�sN|�d�}|S)z9Returns glibc version string, or None if not using glibc.N�ascii)	�ctypesZCDLL�gnu_get_libc_version�AttributeErrorZc_char_pZrestype�
isinstance�str�decode)Zprocess_namespacer�version_str�r�4/usr/lib/python3.8/site-packages/setuptools/glibc.py�glibc_version_string
s



r
cCsHt�d|�}|s$t�d|t�dSt|�d��|koFt|�d��|kS)Nz$(?P<major>[0-9]+)\.(?P<minor>[0-9]+)z=Expected glibc version with 2 components major.minor, got: %sF�major�minor)�re�match�warnings�warn�RuntimeWarning�int�group)r
�required_major�
minimum_minor�mrrr�check_glibc_version$s���rcCst�}|dkrdSt|||�S)NF)r
r)rrr
rrr�have_compatible_glibc4srcCst�}|dkrdSd|fSdS)z�Try to determine the glibc version

    Returns a tuple of strings (lib, version) which default to empty strings
    in case the lookup fails.
    N)�rZglibc)r
)Z
glibc_versionrrr�libc_verLsr)	Z
__future__rrrrr
rrrrrrr�<module>ssite-packages/setuptools/__pycache__/wheel.cpython-38.pyc000064400000015616151446177000017467 0ustar00U

�Qab��@s�dZddlmZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddl	mZddlm
Z
ddlmZddl
mZddlmZeZe�d	ej�jZd
Zdd�ZGd
d�d�ZdS)zWheels support.�)�get_platformN)�
parse_version)�canonicalize_name)�PY3)�
pep425tags)�write_requirementsz�^(?P<project_name>.+?)-(?P<version>\d.*?)
    ((-(?P<build>\d.*?))?-(?P<py_version>.+?)-(?P<abi>.+?)-(?P<platform>.+?)
    )\.whl$z�try:
    __import__('pkg_resources').declare_namespace(__name__)
except ImportError:
    __path__ = __import__('pkgutil').extend_path(__path__, __name__)
cCs�t�|�D]�\}}}tj�||�}|D].}tj�||�}tj�|||�}t�||�q&ttt|���D]D\}	}
tj�||
�}tj�|||
�}tj�	|�sft�||�||	=qfq
tj|dd�D]\}}}|r�t
�t�|�q�dS)zDMove everything under `src_dir` to `dst_dir`, and delete the former.T)�topdownN)�os�walk�path�relpath�join�renames�reversed�list�	enumerate�exists�AssertionError�rmdir)Zsrc_dirZdst_dir�dirpathZdirnames�	filenames�subdir�f�srcZdst�n�d�r�4/usr/lib/python3.8/site-packages/setuptools/wheel.py�unpack%s
rc@sheZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	e
dd��Ze
dd��Ze
dd��Z
dS)�WheelcCsPttj�|��}|dkr$td|��||_|����D]\}}t|||�q6dS)Nzinvalid wheel name: %r)	�
WHEEL_NAMEr	r�basename�
ValueError�filename�	groupdict�items�setattr)�selfr#�match�k�vrrr�__init__=szWheel.__init__cCs&t�|j�d�|j�d�|j�d��S)z>List tags (py_version, abi, platform) supported by this wheel.�.)�	itertools�productZ
py_version�splitZabi�platform�r'rrr�tagsEs



�z
Wheel.tagscs$t���t�fdd�|��D�d�S)z5Is the wheel is compatible with the current platform?c3s|]}|�krdVqdS)TNr)�.0�t�Zsupported_tagsrr�	<genexpr>Psz&Wheel.is_compatible.<locals>.<genexpr>F)rZ
get_supported�nextr2r1rr5r�
is_compatibleMszWheel.is_compatiblecCs,tj|j|j|jdkrdnt�d���dS)N�any)�project_name�versionr0z.egg)�
pkg_resources�Distributionr:r;r0r�egg_namer1rrrr>Rs��zWheel.egg_namecCsJ|��D]4}t�|�}|�d�rt|��t|j��r|Sqtd��dS)Nz
.dist-infoz.unsupported wheel format. .dist-info not found)Znamelist�	posixpath�dirname�endswithr�
startswithr:r")r'�zf�memberr@rrr�
get_dist_infoXs

��
zWheel.get_dist_infoc	Cs(t�|j��}|�||�W5QRXdS)z"Install wheel as an egg directory.N)�zipfileZZipFiler#�_install_as_egg)r'�destination_eggdirrCrrr�install_as_eggbszWheel.install_as_eggcCs\d|j|jf}|�|�}d|}tj�|d�}|�||||�|�||�|�||�dS)Nz%s-%sz%s.data�EGG-INFO)	r:r;rEr	rr
�_convert_metadata�_move_data_entries�_fix_namespace_packages)r'rHrCZ
dist_basename�	dist_info�	dist_data�egg_inforrrrGgs
zWheel._install_as_eggc
s&��fdd�}|d�}t|�d��}td�|ko>td�kn}|sTtd|��t�|���|�tj�|���tj	j
|�t�|��d��d	d
��tt
t�����������fdd��jD�}t��|�t�tj�|d
�tj�|d��tj	t�|d�d�}	t|	�d�dtj�|d��dS)Nc
sT��t��|���8}tr&|���d�n|��}tj���	|�W5QR�SQRXdS)Nzutf-8)
�openr?r
r�read�decode�email�parserZParserZparsestr)�name�fp�value)rNrCrr�get_metadatassz-Wheel._convert_metadata.<locals>.get_metadataZWHEELz
Wheel-Versionz1.0z2.0dev0z$unsupported wheel format version: %s)ZmetadatacSsd|_t|�S�N)Zmarker�str)�reqrrr�raw_req�sz(Wheel._convert_metadata.<locals>.raw_reqc
s2i|]*}|t�fdd�t���|f��D���qS)c3s|]}|�kr|VqdSrZr)r3r\)�install_requiresrrr6�s�z5Wheel._convert_metadata.<locals>.<dictcomp>.<genexpr>)�sorted�map�requires)r3Zextra)�distr^r]rr�
<dictcomp>�s
��z+Wheel._convert_metadata.<locals>.<dictcomp>ZMETADATAzPKG-INFO)r^�extras_require)ZattrsrPzrequires.txt)r�getr"r	�mkdirZ
extractallrr
r<r=Z
from_locationZPathMetadatarr_r`raZextras�rename�
setuptools�dictrZget_command_obj)
rCrHrNrPrYZwheel_metadataZ
wheel_versionZwheel_v1rdZ
setup_distr)rbrNr^r]rCrrKqsL��


������zWheel._convert_metadatacs�tj�|���tj��d�}tj�|�r�tj�|dd�}t�|�t�|�D]D}|�d�rpt�tj�||��qLt�tj�||�tj�||��qLt�	|�t
tjj�fdd�dD��D]}t||�q�tj���r�t�	��dS)z,Move data entries to their correct location.ZscriptsrJz.pycc3s|]}tj��|�VqdSrZ)r	rr
)r3r�rOrrr6�s�z+Wheel._move_data_entries.<locals>.<genexpr>)�dataZheadersZpurelibZplatlibN)r	rr
rrf�listdirrA�unlinkrgr�filterr)rHrOZdist_data_scriptsZegg_info_scripts�entryrrrjrrL�s.�

�
�zWheel._move_data_entriesc
Cs�tj�|d�}tj�|�r�t|��}|����}W5QRX|D]b}tjj|f|�d���}tj�|d�}tj�|�r>tj�|�s>t|d��}|�t�W5QRXq>dS)Nznamespace_packages.txtr,z__init__.py�w)	r	rr
rrQrRr/�write�NAMESPACE_PACKAGE_INIT)rPrHZnamespace_packagesrW�modZmod_dirZmod_initrrrrM�s�
zWheel._fix_namespace_packagesN)�__name__�
__module__�__qualname__r+r2r8r>rErIrG�staticmethodrKrLrMrrrrr;s


9
r)�__doc__Zdistutils.utilrrTr-r	r?�rerFr<rhrZ!setuptools.extern.packaging.utilsrZsetuptools.extern.sixrrZsetuptools.command.egg_infor�typeZ
__metaclass__�compile�VERBOSEr(r rrrrrrrr�<module>s,�site-packages/setuptools/__pycache__/msvc.cpython-38.opt-1.pyc000064400000115317151446177000020271 0ustar00U

�Qab���@sXdZddlZddlmZddlmZmZddlmZm	Z	m
Z
mZddlZddl
Z
ddlZddlZddlmZddlmZdd	lmZe
��d
kr�ddlmZddlmZnGd
d�d�Ze�ZeejjfZzddlm Z Wnek
r�YnXdd�Z!d$dd�Z"dd�Z#dd�Z$d%dd�Z%Gdd�d�Z&Gdd�d�Z'Gd d!�d!�Z(Gd"d#�d#�Z)dS)&a�
Improved support for Microsoft Visual C++ compilers.

Known supported compilers:
--------------------------
Microsoft Visual C++ 9.0:
    Microsoft Visual C++ Compiler for Python 2.7 (x86, amd64)
    Microsoft Windows SDK 6.1 (x86, x64, ia64)
    Microsoft Windows SDK 7.0 (x86, x64, ia64)

Microsoft Visual C++ 10.0:
    Microsoft Windows SDK 7.1 (x86, x64, ia64)

Microsoft Visual C++ 14.X:
    Microsoft Visual C++ Build Tools 2015 (x86, x64, arm)
    Microsoft Visual Studio Build Tools 2017 (x86, x64, arm, arm64)
    Microsoft Visual Studio Build Tools 2019 (x86, x64, arm, arm64)

This may also support compilers shipped with compatible Visual Studio versions.
�N)�open)�listdir�pathsep)�join�isfile�isdir�dirname)�
LegacyVersion)�filterfalse�)�
get_unpatched�Windows)�winreg)�environc@seZdZdZdZdZdZdS)rN)�__name__�
__module__�__qualname__�
HKEY_USERS�HKEY_CURRENT_USER�HKEY_LOCAL_MACHINE�HKEY_CLASSES_ROOT�rr�3/usr/lib/python3.8/site-packages/setuptools/msvc.pyr*sr)�RegcCs�d}|d|f}zt�|d�}WnJtk
rjz|d|f}t�|d�}Wntk
rdd}YnXYnX|r�t|d�}t|�r�|Stt�|�S)a�
    Patched "distutils.msvc9compiler.find_vcvarsall" to use the standalone
    compiler build for Python
    (VCForPython / Microsoft Visual C++ Compiler for Python 2.7).

    Fall back to original behavior when the standalone compiler is not
    available.

    Redirect the path of "vcvarsall.bat".

    Parameters
    ----------
    version: float
        Required Microsoft Visual C++ version.

    Return
    ------
    str
        vcvarsall.bat path
    z-Software\%sMicrosoft\DevDiv\VCForPython\%0.1f��
installdirzWow6432Node\Nz
vcvarsall.bat)rZ	get_value�KeyErrorrrr�msvc9_find_vcvarsall)�versionZvc_base�key�
productdir�	vcvarsallrrrrAs
r�x86c
Os�ztt�}|||f|�|�WStjjk
r4Yntk
rFYnXzt||���WStjjk
r�}zt|||��W5d}~XYnXdS)ao
    Patched "distutils.msvc9compiler.query_vcvarsall" for support extra
    Microsoft Visual C++ 9.0 and 10.0 compilers.

    Set environment without use of "vcvarsall.bat".

    Parameters
    ----------
    ver: float
        Required Microsoft Visual C++ version.
    arch: str
        Target architecture.

    Return
    ------
    dict
        environment
    N)	r�msvc9_query_vcvarsall�	distutils�errors�DistutilsPlatformError�
ValueError�EnvironmentInfo�
return_env�_augment_exception)�ver�arch�args�kwargsZorig�excrrrr#ksr#c
Csrztt�|�WStjjk
r&YnXzt|dd���WStjjk
rl}zt|d��W5d}~XYnXdS)a*
    Patched "distutils._msvccompiler._get_vc_env" for support extra
    Microsoft Visual C++ 14.X compilers.

    Set environment without use of "vcvarsall.bat".

    Parameters
    ----------
    plat_spec: str
        Target architecture.

    Return
    ------
    dict
        environment
    �,@)�
vc_min_verN)r�msvc14_get_vc_envr$r%r&r(r)r*)Z	plat_specr/rrrr2�s
r2cOsBdtjkr4ddl}t|j�td�kr4|jjj||�Stt	�||�S)z�
    Patched "distutils._msvccompiler.gen_lib_options" for fix
    compatibility between "numpy.distutils" and "distutils._msvccompiler"
    (for Numpy < 1.11.2)
    znumpy.distutilsrNz1.11.2)
�sys�modulesZnumpyr	�__version__r$Z	ccompilerZgen_lib_optionsr�msvc14_gen_lib_options)r-r.Znprrrr6�s

r6rcCs�|jd}d|��ks"d|��kr�d}|jft��}d}|dkrf|���d�dkr\|d	7}q�|d
7}n.|dkr�|d7}||d
7}n|dkr�|d7}|f|_dS)zl
    Add details to the exception message to help guide the user
    as to what action will resolve it.
    rr!zvisual cz0Microsoft Visual C++ {version:0.1f} is required.z-www.microsoft.com/download/details.aspx?id=%d�"@Zia64���z( Get it with "Microsoft Windows SDK 7.0"z% Get it from http://aka.ms/vcpython27�$@z* Get it with "Microsoft Windows SDK 7.1": iW r0z[ Get it with "Build Tools for Visual Studio": https://visualstudio.microsoft.com/downloads/N)r-�lower�format�locals�find)r/rr,�messageZtmplZ
msdownloadrrrr*�s


r*c@sbeZdZdZe�dd���Zdd�Ze	dd��Z
dd	�Zd
d�Zdd
d�Z
ddd�Zddd�ZdS)�PlatformInfoz�
    Current and Target Architectures information.

    Parameters
    ----------
    arch: str
        Target architecture.
    Zprocessor_architecturercCs|���dd�|_dS)N�x64�amd64)r:�replacer,)�selfr,rrr�__init__�szPlatformInfo.__init__cCs|j|j�d�dd�S)zs
        Return Target CPU architecture.

        Return
        ------
        str
            Target CPU
        �_rN)r,r=�rCrrr�
target_cpu�s
zPlatformInfo.target_cpucCs
|jdkS)z�
        Return True if target CPU is x86 32 bits..

        Return
        ------
        bool
            CPU is x86 32 bits
        r"�rGrFrrr�
target_is_x86�s	zPlatformInfo.target_is_x86cCs
|jdkS)z�
        Return True if current CPU is x86 32 bits..

        Return
        ------
        bool
            CPU is x86 32 bits
        r"��current_cpurFrrr�current_is_x86s	zPlatformInfo.current_is_x86FcCs.|jdkr|rdS|jdkr$|r$dSd|jS)uk
        Current platform specific subfolder.

        Parameters
        ----------
        hidex86: bool
            return '' and not '†' if architecture is x86.
        x64: bool
            return 'd' and not 'md64' if architecture is amd64.

        Return
        ------
        str
            subfolder: '	arget', or '' (see hidex86 parameter)
        r"rrA�\x64�\%srJ�rC�hidex86r@rrr�current_dirs�zPlatformInfo.current_dircCs.|jdkr|rdS|jdkr$|r$dSd|jS)ar
        Target platform specific subfolder.

        Parameters
        ----------
        hidex86: bool
            return '' and not '\x86' if architecture is x86.
        x64: bool
            return '\x64' and not '\amd64' if architecture is amd64.

        Return
        ------
        str
            subfolder: '\current', or '' (see hidex86 parameter)
        r"rrArMrNrHrOrrr�
target_dir(s�zPlatformInfo.target_dircCs0|rdn|j}|j|krdS|���dd|�S)ap
        Cross platform specific subfolder.

        Parameters
        ----------
        forcex86: bool
            Use 'x86' as current architecture even if current architecture is
            not x86.

        Return
        ------
        str
            subfolder: '' if target architecture is current architecture,
            '\current_target' if not.
        r"r�\z\%s_)rKrGrRrB)rC�forcex86Zcurrentrrr�	cross_dir>s�zPlatformInfo.cross_dirN)FF)FF)F)rrr�__doc__r�getr:rKrD�propertyrGrIrLrQrRrUrrrrr?�s


r?c@s�eZdZdZejejejejfZ	dd�Z
edd��Zedd��Z
edd	��Zed
d��Zedd
��Zedd��Zedd��Zedd��Zedd��Zddd�Zdd�ZdS)�RegistryInfoz�
    Microsoft Visual Studio related registry information.

    Parameters
    ----------
    platform_info: PlatformInfo
        "PlatformInfo" instance.
    cCs
||_dS�N)�pi)rCZ
platform_inforrrrDcszRegistryInfo.__init__cCsdS)z�
        Microsoft Visual Studio root registry key.

        Return
        ------
        str
            Registry key
        ZVisualStudiorrFrrr�visualstudiofs
zRegistryInfo.visualstudiocCst|jd�S)z
        Microsoft Visual Studio SxS registry key.

        Return
        ------
        str
            Registry key
        ZSxS)rr\rFrrr�sxsrs
zRegistryInfo.sxscCst|jd�S)z|
        Microsoft Visual C++ VC7 registry key.

        Return
        ------
        str
            Registry key
        ZVC7�rr]rFrrr�vc~s
zRegistryInfo.vccCst|jd�S)z
        Microsoft Visual Studio VS7 registry key.

        Return
        ------
        str
            Registry key
        ZVS7r^rFrrr�vs�s
zRegistryInfo.vscCsdS)z�
        Microsoft Visual C++ for Python registry key.

        Return
        ------
        str
            Registry key
        zDevDiv\VCForPythonrrFrrr�
vc_for_python�s
zRegistryInfo.vc_for_pythoncCsdS)zq
        Microsoft SDK registry key.

        Return
        ------
        str
            Registry key
        zMicrosoft SDKsrrFrrr�
microsoft_sdk�s
zRegistryInfo.microsoft_sdkcCst|jd�S)z�
        Microsoft Windows/Platform SDK registry key.

        Return
        ------
        str
            Registry key
        r
�rrbrFrrr�windows_sdk�s
zRegistryInfo.windows_sdkcCst|jd�S)z�
        Microsoft .NET Framework SDK registry key.

        Return
        ------
        str
            Registry key
        ZNETFXSDKrcrFrrr�	netfx_sdk�s
zRegistryInfo.netfx_sdkcCsdS)z�
        Microsoft Windows Kits Roots registry key.

        Return
        ------
        str
            Registry key
        zWindows Kits\Installed RootsrrFrrr�windows_kits_roots�s
zRegistryInfo.windows_kits_rootsFcCs$|j��s|rdnd}td|d|�S)a
        Return key in Microsoft software registry.

        Parameters
        ----------
        key: str
            Registry key path where look.
        x86: str
            Force x86 software registry.

        Return
        ------
        str
            Registry key
        rZWow6432NodeZSoftwareZ	Microsoft)r[rLr)rCrr"Znode64rrr�	microsoft�szRegistryInfo.microsoftc
Cs�tj}tj}|j}|jD]�}z||||�d|�}Wn`ttfk
r�|j��s�z||||d�d|�}Wq�ttfk
r�YYqYq�XnYqYnXzt�	||�dWSttfk
r�YqXqdS)a
        Look for values in registry in Microsoft software registry.

        Parameters
        ----------
        key: str
            Registry key path where look.
        name: str
            Value name to find.

        Return
        ------
        str
            value
        rTN)
r�KEY_READ�OpenKeyrg�HKEYS�OSError�IOErrorr[rLZQueryValueEx)rCr�nameZkey_readZopenkey�ms�hkey�bkeyrrr�lookup�s"


zRegistryInfo.lookupN)F)rrrrVrrrrrrjrDrXr\r]r_r`rarbrdrerfrgrqrrrrrYUs6�









rYc@s<eZdZdZe�dd�Ze�dd�Ze�de�Zd7dd�Z	d	d
�Z
dd�Zd
d�Ze
dd��Zedd��Zedd��Zdd�Zdd�Zedd��Zedd��Zedd��Zedd ��Zed!d"��Zed#d$��Zed%d&��Zed'd(��Zed)d*��Zed+d,��Zed-d.��Zed/d0��Zed1d2��Z d3d4�Z!e
d8d5d6��Z"dS)9�
SystemInfoz�
    Microsoft Windows and Visual Studio related system information.

    Parameters
    ----------
    registry_info: RegistryInfo
        "RegistryInfo" instance.
    vc_ver: float
        Required Microsoft Visual C++ version.
    �WinDirr�ProgramFileszProgramFiles(x86)NcCs2||_|jj|_|��|_|p$|��|_|_dSrZ)�rir[�find_programdata_vs_vers�known_vs_paths�_find_latest_available_vs_ver�vs_ver�vc_ver)rCZ
registry_inforzrrrrDs



�zSystemInfo.__init__cCs>|��}|s|jstj�d��t|�}|�|j�t|�dS)zm
        Find the latest VC version

        Return
        ------
        float
            version
        z%No Microsoft Visual C++ version foundr8)�find_reg_vs_versrwr$r%r&�set�update�sorted)rCZreg_vc_versZvc_versrrrrx%s	
�z(SystemInfo._find_latest_available_vs_vercCs$|jj}|jj|jj|jjf}g}|jjD]�}|D]�}zt�|||�dtj�}Wnt	t
fk
rlYq2YnXt�|�\}}}	t|�D]D}
z*t
t�||
�d�}||kr�|�|�Wq�tk
r�Yq�Xq�t|�D]B}
z&t
t�||
��}||kr�|�|�Wq�tk
�rYq�Xq�q2q*t|�S)z�
        Find Microsoft Visual Studio versions available in registry.

        Return
        ------
        list of float
            Versions
        r)rurgr_rar`rjrrirhrkrlZQueryInfoKey�range�floatZ	EnumValue�appendr'ZEnumKeyr~)rCrnZvckeysZvs_versrorrpZsubkeys�valuesrE�ir+rrrr{8s2	
zSystemInfo.find_reg_vs_versc	Cs�i}d}zt|�}Wnttfk
r0|YSX|D]�}z\t||d�}t|ddd��}t�|�}W5QRX|d}tt|d��|||�|d�<Wq6tttfk
r�Yq6Yq6Xq6|S)	z�
        Find Visual studio 2017+ versions from information in
        "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances".

        Return
        ------
        dict
            float version as key, path as value.
        z9C:\ProgramData\Microsoft\VisualStudio\Packages\_Instancesz
state.jsonZrtzutf-8)�encodingZinstallationPath�
VC\Tools\MSVCZinstallationVersion)	rrkrlrr�json�load�_as_float_versionr)	rCZvs_versionsZ
instances_dirZhashed_namesrmZ
state_pathZ
state_file�stateZvs_pathrrrrv[s*
�
��z#SystemInfo.find_programdata_vs_verscCstd�|�d�dd���S)z�
        Return a string version as a simplified float version (major.minor)

        Parameters
        ----------
        version: str
            Version.

        Return
        ------
        float
            version
        �.N�)r�r�split)rrrrr��szSystemInfo._as_float_versioncCs.t|jd|j�}|j�|jjd|j�p,|S)zp
        Microsoft Visual Studio directory.

        Return
        ------
        str
            path
        zMicrosoft Visual Studio %0.1f�%0.1f)r�ProgramFilesx86ryrurqr`)rC�defaultrrr�VSInstallDir�s�zSystemInfo.VSInstallDircCs,|��p|��}t|�s(d}tj�|��|S)zm
        Microsoft Visual C++ directory.

        Return
        ------
        str
            path
        z(Microsoft Visual C++ directory not found)�	_guess_vc�_guess_vc_legacyrr$r%r&)rC�path�msgrrr�VCInstallDir�s

zSystemInfo.VCInstallDirc
Cs�|jdkrdSz|j|j}Wntk
r8|j}YnXt|d�}z$t|�d}|�|�|_t||�WStt	t
fk
r�YdSXdS)zl
        Locate Visual C++ for VS2017+.

        Return
        ------
        str
            path
        r0rr�r8N)ryrwrr�rrr�rzrkrl�
IndexError)rCZvs_dirZguess_vcrzrrrr��s	

zSystemInfo._guess_vccCsbt|jd|j�}t|jjd|j�}|j�|d�}|rBt|d�n|}|j�|jjd|j�p`|S)z{
        Locate Visual C++ for versions prior to 2017.

        Return
        ------
        str
            path
        z Microsoft Visual Studio %0.1f\VCr�rZVC)rr�ryrurarqr_)rCr�Zreg_pathZ	python_vcZ
default_vcrrrr��s	�zSystemInfo._guess_vc_legacycCsJ|jdkrdS|jdkrdS|jdkr*dS|jdkr8dS|jd	krFd
SdS)z�
        Microsoft Windows SDK versions for specified MSVC++ version.

        Return
        ------
        tuple of str
            versions
        r7)z7.0z6.1z6.0ar9)z7.1z7.0a�&@)z8.0z8.0a�(@)�8.1z8.1ar0)z10.0r�N�ryrFrrr�WindowsSdkVersion�s





zSystemInfo.WindowsSdkVersioncCs|�t|jd��S)zt
        Microsoft Windows SDK last version.

        Return
        ------
        str
            version
        �lib)�_use_last_dir_namer�
WindowsSdkDirrFrrr�WindowsSdkLastVersions
z SystemInfo.WindowsSdkLastVersioncCsd}|jD],}t|jjd|�}|j�|d�}|r
q8q
|rDt|�stt|jjd|j�}|j�|d�}|rtt|d�}|r�t|�s�|jD]6}|d|�d��}d	|}t|j	|�}t|�r�|}q�|r�t|�s�|jD]$}d
|}t|j	|�}t|�r�|}q�|�st|j
d�}|S)zn
        Microsoft Windows SDK directory.

        Return
        ------
        str
            path
        rzv%s�installationfolderr�rZWinSDKNr�zMicrosoft SDKs\Windows Kits\%szMicrosoft SDKs\Windows\v%sZPlatformSDK)r�rrurdrqrrarz�rfindrtr�)rC�sdkdirr+�locr�Zinstall_baseZintver�drrrr�s6




zSystemInfo.WindowsSdkDirc	Cs�|jdkrd}d}n&d}|jdkr&dnd}|jjd|d�}d	||�d
d�f}g}|jdkr~|jD]}|t|jj||�g7}qb|jD]}|t|jj	d
||�g7}q�|D]}|j�
|d�}|r�|Sq�dS)zy
        Microsoft Windows SDK executable directory.

        Return
        ------
        str
            path
        r��#r�(r�TF)r@rPzWinSDK-NetFx%dTools%srS�-r0zv%sAr�N)ryr[rQrB�NetFxSdkVersionrrurer�rdrq)	rCZnetfxverr,rPZfxZregpathsr+r�Zexecpathrrr�WindowsSDKExecutablePath7s"



z#SystemInfo.WindowsSDKExecutablePathcCs&t|jjd|j�}|j�|d�p$dS)zl
        Microsoft Visual F# directory.

        Return
        ------
        str
            path
        z%0.1f\Setup\F#r r)rrur\ryrq)rCr�rrr�FSharpInstallDirZs
zSystemInfo.FSharpInstallDircCsF|jdkrdnd}|D]*}|j�|jjd|�}|r|p:dSqdS)zt
        Microsoft Universal CRT SDK directory.

        Return
        ------
        str
            path
        r0)Z10Z81rz
kitsroot%srN)ryrurqrf)rCZversr+r�rrr�UniversalCRTSdkDirgs�zSystemInfo.UniversalCRTSdkDircCs|�t|jd��S)z�
        Microsoft Universal C Runtime SDK last version.

        Return
        ------
        str
            version
        r�)r�rr�rFrrr�UniversalCRTSdkLastVersion{s
z%SystemInfo.UniversalCRTSdkLastVersioncCs|jdkrdSdS)z�
        Microsoft .NET Framework SDK versions.

        Return
        ------
        tuple of str
            versions
        r0)	z4.7.2z4.7.1z4.7z4.6.2z4.6.1z4.6z4.5.2z4.5.1z4.5rr�rFrrrr��s��zSystemInfo.NetFxSdkVersioncCs8d}|jD](}t|jj|�}|j�|d�}|r
q4q
|S)zu
        Microsoft .NET Framework SDK directory.

        Return
        ------
        str
            path
        rZkitsinstallationfolder)r�rrurerq)rCr�r+r�rrr�NetFxSdkDir�s

zSystemInfo.NetFxSdkDircCs"t|jd�}|j�|jjd�p |S)zw
        Microsoft .NET Framework 32bit directory.

        Return
        ------
        str
            path
        zMicrosoft.NET\FrameworkZframeworkdir32�rrsrurqr_�rCZguess_fwrrr�FrameworkDir32�szSystemInfo.FrameworkDir32cCs"t|jd�}|j�|jjd�p |S)zw
        Microsoft .NET Framework 64bit directory.

        Return
        ------
        str
            path
        zMicrosoft.NET\Framework64Zframeworkdir64r�r�rrr�FrameworkDir64�szSystemInfo.FrameworkDir64cCs
|�d�S)z�
        Microsoft .NET Framework 32bit versions.

        Return
        ------
        tuple of str
            versions
        � ��_find_dot_net_versionsrFrrr�FrameworkVersion32�s
zSystemInfo.FrameworkVersion32cCs
|�d�S)z�
        Microsoft .NET Framework 64bit versions.

        Return
        ------
        tuple of str
            versions
        �@r�rFrrr�FrameworkVersion64�s
zSystemInfo.FrameworkVersion64cCs�|j�|jjd|�}t|d|�}|p6|�|d�p6d}|jdkrJ|dfS|jdkrt|��dd	�d
krldn|dfS|jd
kr�dS|jdkr�dSdS)z�
        Find Microsoft .NET Framework versions.

        Parameters
        ----------
        bits: int
            Platform number of bits: 32 or 64.

        Return
        ------
        tuple of str
            versions
        zframeworkver%dzFrameworkDir%d�vrr�zv4.0r9Nr�Zv4z
v4.0.30319�v3.5r7)r��
v2.0.50727g @)zv3.0r�)rurqr_�getattrr�ryr:)rC�bitsZreg_verZdot_net_dirr+rrrr��s

 

z!SystemInfo._find_dot_net_versionscs*��fdd�tt���D�}t|d�p(dS)a)
        Return name of the last dir in path or '' if no dir found.

        Parameters
        ----------
        path: str
            Use dirs in this path
        prefix: str
            Use only dirs starting by this prefix

        Return
        ------
        str
            name
        c3s*|]"}tt�|��r|���r|VqdSrZ)rr�
startswith)�.0Zdir_name�r��prefixrr�	<genexpr>s
�z0SystemInfo._use_last_dir_name.<locals>.<genexpr>Nr)�reversedr�next)r�r�Z
matching_dirsrr�rr��s
�zSystemInfo._use_last_dir_name)N)r)#rrrrVrrWrsrtr�rDrxr{rv�staticmethodr�rXr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rrrrrr	sZ


#*





*
"








rrc@sbeZdZdZd?dd�Zedd��Zedd	��Zed
d��Zedd
��Z	edd��Z
edd��Zedd��Zedd��Z
edd��Zedd��Zedd��Zdd�Zedd��Zed d!��Zed"d#��Zed$d%��Zed&d'��Zed(d)��Zed*d+��Zed,d-��Zed.d/��Zed0d1��Zed2d3��Zed4d5��Zed6d7��Zd@d9d:�Zd;d<�Z e!dAd=d>��Z"dS)Br(aY
    Return environment variables for specified Microsoft Visual C++ version
    and platform : Lib, Include, Path and libpath.

    This function is compatible with Microsoft Visual C++ 9.0 to 14.X.

    Script created by analysing Microsoft environment configuration files like
    "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ...

    Parameters
    ----------
    arch: str
        Target architecture.
    vc_ver: float
        Required Microsoft Visual C++ version. If not set, autodetect the last
        version.
    vc_min_ver: float
        Minimum Microsoft Visual C++ version.
    NrcCsBt|�|_t|j�|_t|j|�|_|j|kr>d}tj�	|��dS)Nz.No suitable Microsoft Visual C++ version found)
r?r[rYrurr�sirzr$r%r&)rCr,rzr1�errrrrrD0s

zEnvironmentInfo.__init__cCs|jjS)zk
        Microsoft Visual Studio.

        Return
        ------
        float
            version
        )r�ryrFrrrry9s
zEnvironmentInfo.vs_vercCs|jjS)zp
        Microsoft Visual C++ version.

        Return
        ------
        float
            version
        )r�rzrFrrrrzEs
zEnvironmentInfo.vc_vercsVddg}�jdkrD�jjddd�}|dg7}|dg7}|d|g7}�fd	d
�|D�S)zu
        Microsoft Visual Studio Tools.

        Return
        ------
        list of str
            paths
        zCommon7\IDEz
Common7\Toolsr0T�rPr@z1Common7\IDE\CommonExtensions\Microsoft\TestWindowzTeam Tools\Performance ToolszTeam Tools\Performance Tools%scsg|]}t�jj|��qSr�rr�r��r�r�rFrr�
<listcomp>csz+EnvironmentInfo.VSTools.<locals>.<listcomp>)ryr[rQ)rC�paths�arch_subdirrrFr�VSToolsQs



zEnvironmentInfo.VSToolscCst|jjd�t|jjd�gS)z�
        Microsoft Visual C++ & Microsoft Foundation Class Includes.

        Return
        ------
        list of str
            paths
        ZIncludezATLMFC\Include�rr�r�rFrrr�
VCIncludeses
�zEnvironmentInfo.VCIncludescsb�jdkr�jjdd�}n�jjdd�}d|d|g}�jdkrP|d|g7}�fd	d
�|D�S)z�
        Microsoft Visual C++ & Microsoft Foundation Class Libraries.

        Return
        ------
        list of str
            paths
        �.@T�r@�rP�Lib%szATLMFC\Lib%sr0zLib\store%scsg|]}t�jj|��qSrr�r�rFrrr��sz/EnvironmentInfo.VCLibraries.<locals>.<listcomp>)ryr[rR)rCr�r�rrFr�VCLibrariesrs


zEnvironmentInfo.VCLibrariescCs|jdkrgSt|jjd�gS)z�
        Microsoft Visual C++ store references Libraries.

        Return
        ------
        list of str
            paths
        r0zLib\store\references)ryrr�r�rFrrr�VCStoreRefs�s

zEnvironmentInfo.VCStoreRefscCs|j}t|jd�g}|jdkr"dnd}|j�|�}|rL|t|jd|�g7}|jdkr|d|jjdd�}|t|j|�g7}n�|jdkr�|j��r�d	nd
}|t|j||jjdd��g7}|jj	|jj
kr�|t|j||jjdd��g7}n|t|jd�g7}|S)
zr
        Microsoft Visual C++ Tools.

        Return
        ------
        list of str
            paths
        Z
VCPackagesr9TF�Bin%sr0r�r�z
bin\HostX86%sz
bin\HostX64%sr��Bin)r�rr�ryr[rUrQrLrRrKrG)rCr��toolsrTr�r�Zhost_dirrrr�VCTools�s0


���
zEnvironmentInfo.VCToolscCsh|jdkr.|jjddd�}t|jjd|�gS|jjdd�}t|jjd�}|j}t|d||f�gSdS)	zw
        Microsoft Windows SDK Libraries.

        Return
        ------
        list of str
            paths
        r9Tr�r�r�r�z%sum%sN)ryr[rRrr�r��_sdk_subdir)rCr�r�Zlibverrrr�OSLibraries�s

zEnvironmentInfo.OSLibrariescCsht|jjd�}|jdkr&|t|d�gS|jdkr8|j}nd}t|d|�t|d|�t|d|�gSd	S)
zu
        Microsoft Windows SDK Include.

        Return
        ------
        list of str
            paths
        �includer9Zglr0rz%ssharedz%sumz%swinrtN)rr�r�ryr�)rCr��sdkverrrr�
OSIncludes�s


�zEnvironmentInfo.OSIncludescCs�t|jjd�}g}|jdkr&||j7}|jdkr@|t|d�g7}|jdkr�||t|jjd�t|dd�t|d	d�t|d
d�t|jjddd
|jddd�g7}|S)z}
        Microsoft Windows SDK Libraries Paths.

        Return
        ------
        list of str
            paths
        Z
Referencesr7r�zCommonConfiguration\Neutralr0Z
UnionMetadataz'Windows.Foundation.UniversalApiContractz1.0.0.0z%Windows.Foundation.FoundationContractz,Windows.Networking.Connectivity.WwanContractZ
ExtensionSDKszMicrosoft.VCLibsr�ZCommonConfigurationZneutral)rr�r�ryr�)rC�ref�libpathrrr�	OSLibpath�s.






���zEnvironmentInfo.OSLibpathcCst|���S)zs
        Microsoft Windows SDK Tools.

        Return
        ------
        list of str
            paths
        )�list�
_sdk_toolsrFrrr�SdkToolss
zEnvironmentInfo.SdkToolsccs�|jdkr,|jdkrdnd}t|jj|�V|j��s\|jjdd�}d|}t|jj|�V|jdkr�|j��rvd	}n|jjddd
�}d|}t|jj|�VnB|jdkr�t|jjd�}|jjdd�}|jj}t|d||f�V|jj	r�|jj	Vd
S)z�
        Microsoft Windows SDK Tools paths generator.

        Return
        ------
        generator of str
            paths
        r�r�r�zBin\x86Tr�r�)r9r�rr�zBin\NETFX 4.0 Tools%sz%s%sN)
ryrr�r�r[rLrQrIr�r�)rCZbin_dirr�r�r�rrrr�s(	




zEnvironmentInfo._sdk_toolscCs|jj}|rd|SdS)zu
        Microsoft Windows SDK version subdir.

        Return
        ------
        str
            subdir
        �%s\r)r�r��rC�ucrtverrrrr�6s
zEnvironmentInfo._sdk_subdircCs|jdkrgSt|jjd�gS)zs
        Microsoft Windows SDK Setup.

        Return
        ------
        list of str
            paths
        r7ZSetup)ryrr�r�rFrrr�SdkSetupCs

zEnvironmentInfo.SdkSetupcs�|j}|j�|jdkr0d}|��o,|��}n$|��p>|��}|jdkpR|jdk}g}|rt|�fdd��jD�7}|r�|�fdd��jD�7}|S)zv
        Microsoft .NET Framework Tools.

        Return
        ------
        list of str
            paths
        r9TrAcsg|]}t�j|��qSr)rr��r�r+�r�rrr�hs�z+EnvironmentInfo.FxTools.<locals>.<listcomp>csg|]}t�j|��qSr)rr�r�r�rrr�ks�)	r[r�ryrIrLrKrGr�r�)rCr[Z	include32Z	include64r�rr�r�FxToolsRs"

��zEnvironmentInfo.FxToolscCs8|jdks|jjsgS|jjdd�}t|jjd|�gS)z~
        Microsoft .Net Framework SDK Libraries.

        Return
        ------
        list of str
            paths
        r0Tr�zlib\um%s)ryr�r�r[rRr)rCr�rrr�NetFxSDKLibrariesos
z!EnvironmentInfo.NetFxSDKLibrariescCs&|jdks|jjsgSt|jjd�gS)z}
        Microsoft .Net Framework SDK Includes.

        Return
        ------
        list of str
            paths
        r0z
include\um)ryr�r�rrFrrr�NetFxSDKIncludess
z EnvironmentInfo.NetFxSDKIncludescCst|jjd�gS)z�
        Microsoft Visual Studio Team System Database.

        Return
        ------
        list of str
            paths
        z
VSTSDB\Deployr�rFrrr�VsTDb�s
zEnvironmentInfo.VsTDbcCsv|jdkrgS|jdkr0|jj}|jjdd�}n|jj}d}d|j|f}t||�g}|jdkrr|t||d�g7}|S)zn
        Microsoft Build Engine.

        Return
        ------
        list of str
            paths
        r�r�Tr�rzMSBuild\%0.1f\bin%sZRoslyn)ryr�r�r[rQr�r)rC�	base_pathr�r�Zbuildrrr�MSBuild�s



zEnvironmentInfo.MSBuildcCs|jdkrgSt|jjd�gS)zt
        Microsoft HTML Help Workshop.

        Return
        ------
        list of str
            paths
        r�zHTML Help Workshop)ryrr�r�rFrrr�HTMLHelpWorkshop�s

z EnvironmentInfo.HTMLHelpWorkshopcCsD|jdkrgS|jjdd�}t|jjd�}|j}t|d||f�gS)z�
        Microsoft Universal C Runtime SDK Libraries.

        Return
        ------
        list of str
            paths
        r0Tr�r�z%sucrt%s)ryr[rRrr�r��_ucrt_subdir)rCr�r�r�rrr�
UCRTLibraries�s

zEnvironmentInfo.UCRTLibrariescCs.|jdkrgSt|jjd�}t|d|j�gS)z�
        Microsoft Universal C Runtime SDK Include.

        Return
        ------
        list of str
            paths
        r0r�z%sucrt)ryrr�r�r�)rCr�rrr�UCRTIncludes�s

zEnvironmentInfo.UCRTIncludescCs|jj}|rd|SdS)z�
        Microsoft Universal C Runtime SDK version subdir.

        Return
        ------
        str
            subdir
        r�r)r�r�r�rrrr��s
zEnvironmentInfo._ucrt_subdircCs(d|jkrdkrnngS|jjgS)zk
        Microsoft Visual F#.

        Return
        ------
        list of str
            paths
        r�r�)ryr�r�rFrrr�FSharp�s
zEnvironmentInfo.FSharpc
Cs�d|j}|jjdd��d�}g}|jj}t|�dd��}t|�rft	|t
|�d�}||t	|d�g7}|t	|d	�g7}d
|jdd
t|j�df}t
�||�D]&\}}t	||||�}	t|	�r�|	Sq�dS)
z
        Microsoft Visual C++ runtime redistributable dll.

        Return
        ------
        str
            path
        zvcruntime%d0.dllTr�rSz\Toolsz\Redistr8ZonecoreZredistzMicrosoft.VC%d.CRT�
N)rzr[rR�stripr�r�rrBrrr�intry�	itertools�productr)
rCZ	vcruntimer��prefixesZ
tools_pathZredist_pathZcrt_dirsr�Zcrt_dirr�rrr�VCRuntimeRedists 

�zEnvironmentInfo.VCRuntimeRedistTcCs�t|�d|j|j|j|jg|�|�d|j|j|j|j	|j
g|�|�d|j|j|j|jg|�|�d|j
|j|j|j|j|j|j|j|jg	|�d�}|jdkr�t|j�r�|j|d<|S)z�
        Return environment dict.

        Parameters
        ----------
        exists: bool
            It True, only return existing paths.

        Return
        ------
        dict
            environment
        r�r�r�r�)r�r�r�r��Zpy_vcruntime_redist)�dict�_build_pathsr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�ryrr�)rC�exists�envrrrr)&sV�������	�� 
zEnvironmentInfo.return_envc
Csptj�|�}t�|d��t�}t�||�}|r<ttt	|��n|}|s\d|�
�}tj�
|��|�|�}	t�|	�S)aC
        Given an environment variable name and specified paths,
        return a pathsep-separated string of paths containing
        unique, extant, directories from those paths and from
        the environment variable. Raise an error if no paths
        are resolved.

        Parameters
        ----------
        name: str
            Environment variable name
        spec_path_lists: list of str
            Paths
        exists: bool
            It True, only return existing paths.

        Return
        ------
        str
            Pathsep-separated paths
        rz %s environment variable is empty)r��chain�
from_iterablerrWr�rr��filterr�upperr$r%r&�_unique_everseenr)
rCrmZspec_path_listsrZ
spec_pathsZ	env_pathsr�Zextant_pathsr�Zunique_pathsrrrr�Xs
zEnvironmentInfo._build_pathsccsbt�}|j}|dkr6t|j|�D]}||�|Vq n(|D]"}||�}||kr:||�|Vq:dS)z�
        List unique elements, preserving order.
        Remember all elements ever seen.

        _unique_everseen('AAAABBBCCDAABBB') --> A B C D

        _unique_everseen('ABBCcAD', str.lower) --> A B C D
        N)r|�addr
�__contains__)�iterabler�seenZseen_addZelement�krrrrzs

z EnvironmentInfo._unique_everseen)Nr)T)N)#rrrrVrDrXryrzr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r)r�r�rrrrrr(sn
	







$


 
#












"
2"r()r")r)*rVr��ior�osrrZos.pathrrrrr3�platformr�Zdistutils.errorsr$Z#setuptools.extern.packaging.versionr	Zsetuptools.extern.six.movesr
Zmonkeyr�systemrrr��ImportErrorr%r&Z_msvc9_suppress_errorsZdistutils.msvc9compilerrrr#r2r6r*r?rYrrr(rrrr�<module>sJ�	*
& 
$s5site-packages/setuptools/__pycache__/site-patch.cpython-38.opt-1.pyc000064400000002702151446177000021353 0ustar00U

�Qab��@sdd�Zedkre�[dS)c	Cs
ddl}ddl}|j�d�}|dks2|jdkr8|s8g}n|�|j�}t|di�}|jt	|�d�}|j�
t�}|D]�}||ksr|s�qr|�|�}|dk	r�|�d�}|dk	r�|�
d��q.qrz ddl}	|	�d|g�\}
}}Wntk
r�YqrYnX|
dkr�qrz|	�
d|
||�W5|
��X�q.qrtd��tdd�|jD��}
t|d	d�}d|_|D]}t|��qX|j|7_t|d�\}}d}g}|jD]b}t|�\}}||k�r�|dk�r�t	|�}||
k�s�|dk�r�|�|�n|�||�|d
7}�q�||jdd�<dS)N��
PYTHONPATHZwin32�path_importer_cache�sitez$Couldn't find the real 'site' modulecSsg|]}t|�ddf�qS)�)�makepath)�.0�item�r	�9/usr/lib/python3.8/site-packages/setuptools/site-patch.py�
<listcomp>)sz__boot.<locals>.<listcomp>�__egginsertr)�sys�os�environ�get�platform�split�pathsep�getattr�path�len�dirname�__file__�find_module�load_module�imp�ImportError�close�dictr�
addsitedirr�append�insert)r
rrZpicZstdpathZmydirrZimporter�loaderr�streamrZdescr�known_pathsZoldpos�dZndZ	insert_at�new_path�pZnpr	r	r
�__boots`





r(rN)r(�__name__r	r	r	r
�<module>sGsite-packages/setuptools/__pycache__/__init__.cpython-38.pyc000064400000017130151446177000020113 0ustar00U

�Qabs�@s�dZddlZddlZddlZddlZddlZddlZddlm	Z	ddl
mZddlm
Z
ddlmZddlmZmZdd	lmZmZddlZdd
lmZddlmZmZddlmZdd
lm Z e!Z"ddddddddgZ#er�e#�$d�ej%j&Z&dZ'dZ(dgZ)Gdd�d�Z*Gdd�de*�Z+e*j,Z-e�r,e+j,Z.dd�Z/dd�Z0ej1j0je0_e �2ej1j3�Z4Gd d�de4�Z3d!d"�Z5ej6fd#d$�Z7e �8�dS)%z@Extensions to the 'distutils' for large or complex distributions�N)�DistutilsOptionError)�convert_path��fnmatchcase�)�SetuptoolsDeprecationWarning)�PY3�string_types)�filter�map)�	Extension)�Distribution�Feature)�Require)�monkey�setupr
r�Commandrrr�
find_packages�find_namespace_packagesTz
lib2to3.fixesc@sBeZdZdZeddd��Zedd��Zed	d
��Zedd��Z	d
S)�
PackageFinderzI
    Generate a list of all Python packages found within a directory
    �.���*cCs&t|�t|�|jd|��|j|���S)a	Return a list all Python packages found within directory 'where'

        'where' is the root directory which will be searched for packages.  It
        should be supplied as a "cross-platform" (i.e. URL-style) path; it will
        be converted to the appropriate local path syntax.

        'exclude' is a sequence of package names to exclude; '*' can be used
        as a wildcard in the names, such that 'foo.*' will exclude all
        subpackages of 'foo' (but not 'foo' itself).

        'include' is a sequence of package names to include.  If it's
        specified, only the named packages will be included.  If it's not
        specified, all found packages will be included.  'include' can contain
        shell style wildcard patterns just like 'exclude'.
        �ez_setup�*__pycache__)rr)�list�_find_packages_iterr�
_build_filter)�cls�where�exclude�includerr�7/usr/lib/python3.8/site-packages/setuptools/__init__.py�find4s
�zPackageFinder.findccs�tj|dd�D]�\}}}|dd�}g|dd�<|D]d}tj�||�}	tj�|	|�}
|
�tjjd�}d|ks4|�|	�sxq4||�r�||�s�|V|�|�q4qdS)zy
        All the packages found in 'where' that pass the 'include' filter, but
        not the 'exclude' filter.
        T��followlinksNr)	�os�walk�path�join�relpath�replace�sep�_looks_like_package�append)rr r!r"�root�dirs�filesZall_dirs�dir�	full_pathZrel_path�packagerrr#rKsz!PackageFinder._find_packages_itercCstj�tj�|d��S)z%Does a directory look like a package?z__init__.py)r'r)�isfiler*�r)rrr#r.gsz!PackageFinder._looks_like_packagecs�fdd�S)z�
        Given a list of patterns, return a callable that will be true only if
        the input matches at least one of the patterns.
        cst�fdd��D��S)Nc3s|]}t�|d�VqdS))�patNr)�.0r8��namerr#�	<genexpr>rsz@PackageFinder._build_filter.<locals>.<lambda>.<locals>.<genexpr>)�anyr:�Zpatternsr:r#�<lambda>r�z-PackageFinder._build_filter.<locals>.<lambda>rr>rr>r#rlszPackageFinder._build_filterN)rrr)
�__name__�
__module__�__qualname__�__doc__�classmethodr$r�staticmethodr.rrrrr#r/s

rc@seZdZedd��ZdS)�PEP420PackageFindercCsdS)NTrr7rrr#r.vsz'PEP420PackageFinder._looks_like_packageN)rArBrCrFr.rrrr#rGusrGcCs@tj�tdd�|��D���}|jdd�|jr<|�|j�dS)Ncss"|]\}}|dkr||fVqdS))Zdependency_links�setup_requiresNr)r9�k�vrrr#r<�s�z*_install_setup_requires.<locals>.<genexpr>T)Zignore_option_errors)�	distutils�corer
�dict�itemsZparse_config_filesrHZfetch_build_eggs)�attrs�distrrr#�_install_setup_requires�s�
rQcKst|�tjjf|�S�N)rQrKrLr)rOrrr#r�sc@s:eZdZejZdZdd�Zddd�Zdd�Zd
d
d�Z	dS)rFcKst�||�t|��|�dS)zj
        Construct the command for dist, updating
        vars(self) with any keyword parameters.
        N)�_Command�__init__�vars�update)�selfrP�kwrrr#rT�szCommand.__init__NcCsBt||�}|dkr"t|||�|St|t�s>td|||f��|S)Nz'%s' must be a %s (got `%s`))�getattr�setattr�
isinstancer	r)rW�optionZwhat�default�valrrr#�_ensure_stringlike�s

�zCommand._ensure_stringlikecCspt||�}|dkrdSt|t�r6t||t�d|��n6t|t�rTtdd�|D��}nd}|sltd||f��dS)z�Ensure that 'option' is a list of strings.  If 'option' is
        currently a string, we split it either on /,\s*/ or /\s+/, so
        "foo bar baz", "foo,bar,baz", and "foo,   bar baz" all become
        ["foo", "bar", "baz"].
        Nz,\s*|\s+css|]}t|t�VqdSrR)r[r	)r9rJrrr#r<�sz-Command.ensure_string_list.<locals>.<genexpr>Fz''%s' must be a list of strings (got %r))	rYr[r	rZ�re�splitr�allr)rWr\r^�okrrr#�ensure_string_list�s


��zCommand.ensure_string_listrcKs t�|||�}t|��|�|SrR)rS�reinitialize_commandrUrV)rWZcommandZreinit_subcommandsrX�cmdrrr#re�szCommand.reinitialize_command)N)r)
rArBrCrSrDZcommand_consumes_argumentsrTr_rdrerrrr#r�s

cCs&dd�tj|dd�D�}ttjj|�S)z%
    Find all files under 'path'
    css,|]$\}}}|D]}tj�||�VqqdSrR)r'r)r*)r9�baser1r2�filerrr#r<�s�z#_find_all_simple.<locals>.<genexpr>Tr%)r'r(r
r)r6)r)�resultsrrr#�_find_all_simple�s�rjcCs6t|�}|tjkr.tjtjj|d�}t||�}t|�S)z�
    Find all files under 'dir' and return the list of full filenames.
    Unless dir is '.', return full filenames with dir prepended.
    )�start)	rjr'�curdir�	functools�partialr)r+rr)r3r2Zmake_relrrr#�findall�s


ro)9rDr'�sysrmZdistutils.corerKZdistutils.filelistr`Zdistutils.errorsrZdistutils.utilrZfnmatchrZ_deprecation_warningrZsetuptools.extern.sixrr	Zsetuptools.extern.six.movesr
rZsetuptools.versionZ
setuptoolsZsetuptools.extensionrZsetuptools.distr
rZsetuptools.dependsr�r�typeZ
__metaclass__�__all__r/�version�__version__Zbootstrap_install_fromZrun_2to3_on_doctestsZlib2to3_fixer_packagesrrGr$rrrQrrLZ
get_unpatchedrrSrjrlroZ	patch_allrrrr#�<module>s\�
F
2
site-packages/setuptools/__pycache__/lib2to3_ex.cpython-38.opt-1.pyc000064400000004553151446177000021272 0ustar00U

�Qab��@sXdZddlmZddlmZddlmZmZddl	Z	Gdd�de�Z
Gdd	�d	e�ZdS)
zy
Customized Mixin2to3 support:

 - adds support for converting doctests


This module raises an ImportError on Python 2.
�)�	Mixin2to3)�log)�RefactoringTool�get_fixers_from_packageNc@s$eZdZdd�Zdd�Zdd�ZdS)�DistutilsRefactoringToolcOstj|f|��dS�N)r�error)�self�msg�args�kw�r
�9/usr/lib/python3.8/site-packages/setuptools/lib2to3_ex.py�	log_errorsz"DistutilsRefactoringTool.log_errorcGstj|f|��dSr)r�info�r	r
rr
r
r�log_messagesz$DistutilsRefactoringTool.log_messagecGstj|f|��dSr)r�debugrr
r
r�	log_debugsz"DistutilsRefactoringTool.log_debugN)�__name__�
__module__�__qualname__rrrr
r
r
rrsrc@s&eZdZd	dd�Zdd�Zdd�ZdS)
rFcCsr|jjdk	rdS|sdSt�dd�|��|��|��|rbtjrnt	|j
�}|j|ddd�nt�
||�dS)NTzFixing � )�writeZ
doctests_only)�distributionZuse_2to3rr�join�_Mixin2to3__build_fixer_names�_Mixin2to3__exclude_fixers�
setuptoolsZrun_2to3_on_doctestsr�fixer_namesZrefactor�
_Mixin2to3�run_2to3)r	�filesZdoctests�rr
r
rr!s
zMixin2to3.run_2to3cCsZ|jr
dSg|_tjD]}|j�t|��q|jjdk	rV|jjD]}|j�t|��q@dSr)rrZlib2to3_fixer_packages�extendrrZuse_2to3_fixers)r	�pr
r
rZ__build_fixer_names.s
zMixin2to3.__build_fixer_namescCsJt|dg�}|jjdk	r&|�|jj�|D]}||jkr*|j�|�q*dS)NZexclude_fixers)�getattrrZuse_2to3_exclude_fixersr$r�remove)r	Zexcluded_fixersZ
fixer_namer
r
rZ__exclude_fixers8s
zMixin2to3.__exclude_fixersN)F)rrrr!rrr
r
r
rrs

r)�__doc__Zdistutils.utilrr Z	distutilsrZlib2to3.refactorrrrrr
r
r
r�<module>s	site-packages/setuptools/__pycache__/dist.cpython-38.opt-1.pyc000064400000122205151446177000020256 0ustar00U

�Qab���@sdgZddlZddlZddlZddlZddlZddlZddlZddl	Zddl
ZddlZddlm
Z
ddlmZddlmZddlZddlmZddlmZddlmZmZmZdd	lmZdd
lmZddlmZddlm Z dd
lm!Z!ddl"m#Z#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0Z0e1d�e1d�dd�Z2dd�Z3dd�Z4dd�Z5e6e7fZ8dd �Z9d!d"�Z:d#d$�Z;d%d&�Z<d'd(�Z=d)d*�Z>d+d,�Z?d-d.�Z@d/d0�ZAd1d2�ZBd3d4�ZCd5d6�ZDe-ejEjF�ZGGd7d�deG�ZFGd8d9�d9�ZHGd:d;�d;e'�ZIdS)<�Distribution�N)�	strtobool)�DEBUG��translate_longopt)�defaultdict)�message_from_file)�DistutilsOptionError�DistutilsPlatformError�DistutilsSetupError)�
rfc822_escape)�
StrictVersion)�six)�	packaging)�ordered_set)�map�filter�filterfalse�)�SetuptoolsDeprecationWarning)�Require)�windows_support)�
get_unpatched)�parse_configurationz&setuptools.extern.packaging.specifiersz#setuptools.extern.packaging.versioncCst�dt�t|�S)NzDo not call this function)�warnings�warn�DistDeprecationWarningr)�cls�r�3/usr/lib/python3.8/site-packages/setuptools/dist.py�_get_unpatched-sr cCs�t|dd�}|dkr�|js |jr*td�}nd|jdk	sT|jdk	sTt|dd�dk	sT|jr^td�}n0|js||js||j	s||j
s||jr�td�}ntd�}||_|S)N�metadata_versionz2.1�python_requires�1.2�1.1z1.0)
�getattr�long_description_content_type�provides_extrasr
�
maintainer�maintainer_email�project_urls�provides�requires�	obsoletes�classifiers�download_urlr!)�selfZmvrrr�get_metadata_version2s*

���
��
r1cs t|���fdd�}�fdd�}t�d�|_|d�|_|d�|_|d�|_|d	�|_d
|_|d�|_d
|_	|d�|_
|d
�|_d�kr�|d�|_nd
|_|d�|_
|d�|_d�kr�|d��d�|_|d�|_|d�|_|jtd�k�r
|d�|_|d�|_|d�|_nd
|_d
|_d
|_d
S)z-Reads the metadata values from a file object.cs�|}|dkrdS|S)NZUNKNOWNr)�name�value��msgrr�_read_fieldLsz"read_pkg_file.<locals>._read_fieldcs��|d�}|gkrdS|S�N)Zget_all)r2�valuesr4rr�
_read_listRsz!read_pkg_file.<locals>._read_listzmetadata-versionr2�versionZsummary�authorNzauthor-emailz	home-page�licensezdownload-url�description�keywords�,�platformZ
classifierr$r,r+r-)rr
r!r2r:r=r;r(�author_emailr)Zurlr<r/Zlong_description�splitr>Z	platformsr.r,r+r-)r0�filer6r9rr4r�
read_pkg_fileHs:












rDc
s���}tjr��fdd�}n�fdd�}|dt|��|d����|d����|d����|d����|td	�kr�|d
��	��|d��
��n.d}|D]$\}}t�|�}|d
k	r�|||�q�|d�����j
r�|d�j
��j��D]}|dd|�q�t����}	|d|	�d�����}
|
�r:|d|
�|td	�k�rd���D]}|d|��qPn���d�������d�������d�������d�������d����t�d��r�|d�j��j�r�|d�j��j�r
�jD]}|d|��q�d
S)z5Write the PKG-INFO format data to a file object.
    cs��d|��|�f�dS�Nz%s: %s
)�writeZ
_encode_field��keyr3�rCr0rr�write_field�sz#write_pkg_file.<locals>.write_fieldcs��d||f�dSrE)rFrG)rCrrrJ�szMetadata-Version�Name�VersionZSummaryz	Home-pager#�Author�Author-email))rMr;)rNrA)Z
Maintainerr()zMaintainer-emailr)NZLicensezDownload-URLzProject-URLz%s, %sZDescriptionr?ZKeywordsZPlatformZ
ClassifierZRequiresZProvidesZ	Obsoletesr"zRequires-PythonzDescription-Content-TypezProvides-Extra)r1r�PY2�strZget_nameZget_versionZget_descriptionZget_urlr
Zget_contactZget_contact_emailr%Zget_licenser/r*�itemsrZget_long_description�joinZget_keywordsZ
get_platformsZ_write_listZget_classifiersZget_requiresZget_providesZ
get_obsoletes�hasattrr"r&r')
r0rCr:rJZoptional_fieldsZfield�attrZattr_valZproject_urlZ	long_descr>r@�extrarrIr�write_pkg_file~sZ


�
rVcCsFztj�d|�}Wn,ttttfk
r@td||f��YnXdS)Nzx=z4%r must be importable 'module:attrs' string (got %r))�
pkg_resources�
EntryPoint�parse�	TypeError�
ValueError�AttributeError�AssertionErrorr)�distrTr3�eprrr�check_importable�s��r`cCs6zWn,ttttfk
r0td||f��YnXdS)z"Verify that value is a string listz%%r must be a list of strings (got %r)N)rZr[r\r]r�r^rTr3rrr�assert_string_list�s
�rbcCsd|}t|||�|D]J}|�|�s2tdd|��|�d�\}}}|r||krtj�d||�qdS)z(Verify that namespace packages are validz1Distribution contains no modules or packages for znamespace package %r�.z^WARNING: %r is declared as a package namespace, but %r is not: please correct this in setup.pyN)rb�has_contents_forr�
rpartition�	distutils�logr)r^rTr3Zns_packagesZnsp�parent�sepZchildrrr�	check_nsp�s 
���rjc
Cs@ztt�t|����Wn"tttfk
r:td��YnXdS)z+Verify that extras_require mapping is validz�'extras_require' must be a dictionary whose values are strings or lists of strings containing valid project/version requirement specifiers.N)	�list�	itertools�starmap�_check_extrarQrZr[r\rrarrr�check_extras�s�rocCs<|�d�\}}}|r*t�|�r*td|��tt�|��dS)N�:zInvalid environment marker: )�	partitionrWZinvalid_markerrrk�parse_requirements)rUZreqsr2ri�markerrrrrnsrncCs&t|�|kr"d}t|j||d���dS)z)Verify that value is True, False, 0, or 1z0{attr!r} must be a boolean value (got {value!r}))rTr3N)�boolr�format)r^rTr3�tmplrrr�assert_boolsrwc
Csjz(tt�|��t|ttf�r&td��Wn<ttfk
rd}zd}t|j	||d���W5d}~XYnXdS)z9Verify that install_requires is a valid requirements listzUnordered types are not allowedzm{attr!r} must be a string or list of strings containing valid project/version requirement specifiers; {error}�rT�errorN)
rkrWrr�
isinstance�dict�setrZr[rru�r^rTr3ryrvrrr�check_requirementss�r~c
CsRztj�|�Wn<tjjk
rL}zd}t|j||d���W5d}~XYnXdS)z.Verify that value is a valid version specifierzF{attr!r} must be a string containing valid version specifiers; {error}rxN)rZ
specifiersZSpecifierSetZInvalidSpecifierrrur}rrr�check_specifier s�rc
Cs@ztj�|�Wn*tk
r:}zt|��W5d}~XYnXdS)z)Verify that entry_points map is parseableN)rWrXZ	parse_mapr[r)r^rTr3�errr�check_entry_points,sr�cCst|tj�std��dS)Nztest_suite must be a string)rzr�string_typesrrarrr�check_test_suite4sr�cCs\t|t�std�|���|��D]6\}}t|tj�sDtd�||���t|d�|�|�q dS)z@Verify that value is a dictionary of package names to glob listszT{!r} must be a dictionary mapping package names to lists of string wildcard patternsz,keys of {!r} dict must be strings (got {!r})zvalues of {!r} dictN)rzr{rrurQrr�rb)r^rTr3�k�vrrr�check_package_data9s
����r�cCs(|D]}t�d|�stj�d|�qdS)Nz\w+(\.\w+)*z[WARNING: %r not a valid package name; please use only .-separated package names in setup.py)�re�matchrfrgr)r^rTr3Zpkgnamerrr�check_packagesHs�r�c@sReZdZdZdeejd�ZdZdd�Z	dMdd�Z
dd	�Zd
d�Ze
dd
��Zdd�Zdd�ZdNdd�Ze
dd��ZdOdd�ZdPdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Z d3d4�Z!d5d6�Z"d7d8�Z#d9d:�Z$d;d<�Z%d=d>�Z&d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*dGdH�Z+dIdJ�Z,dKdL�Z-dS)Qra�Distribution with support for features, tests, and package data

    This is an enhanced version of 'distutils.dist.Distribution' that
    effectively adds the following new optional keyword arguments to 'setup()':

     'install_requires' -- a string or sequence of strings specifying project
        versions that the distribution requires when installed, in the format
        used by 'pkg_resources.require()'.  They will be installed
        automatically when the package is installed.  If you wish to use
        packages that are not available in PyPI, or want to give your users an
        alternate download location, you can add a 'find_links' option to the
        '[easy_install]' section of your project's 'setup.cfg' file, and then
        setuptools will scan the listed web pages for links that satisfy the
        requirements.

     'extras_require' -- a dictionary mapping names of optional "extras" to the
        additional requirement(s) that using those extras incurs. For example,
        this::

            extras_require = dict(reST = ["docutils>=0.3", "reSTedit"])

        indicates that the distribution can optionally provide an extra
        capability called "reST", but it can only be used if docutils and
        reSTedit are installed.  If the user installs your package using
        EasyInstall and requests one of your extras, the corresponding
        additional requirements will be installed if needed.

     'features' **deprecated** -- a dictionary mapping option names to
        'setuptools.Feature'
        objects.  Features are a portion of the distribution that can be
        included or excluded based on user options, inter-feature dependencies,
        and availability on the current system.  Excluded features are omitted
        from all setup commands, including source and binary distributions, so
        you can create multiple distributions from the same source tree.
        Feature names should be valid Python identifiers, except that they may
        contain the '-' (minus) sign.  Features can be included or excluded
        via the command line options '--with-X' and '--without-X', where 'X' is
        the name of the feature.  Whether a feature is included by default, and
        whether you are allowed to control this from the command line, is
        determined by the Feature object.  See the 'Feature' class for more
        information.

     'test_suite' -- the name of a test suite to run for the 'test' command.
        If the user runs 'python setup.py test', the package will be installed,
        and the named test suite will be run.  The format is the same as
        would be used on a 'unittest.py' command line.  That is, it is the
        dotted name of an object to import and call to generate a test suite.

     'package_data' -- a dictionary mapping package names to lists of filenames
        or globs to use to find data files contained in the named packages.
        If the dictionary has filenames or globs listed under '""' (the empty
        string), those names will be searched for in every package, in addition
        to any names for the specific package.  Data files found using these
        names/globs will be installed along with the package, in the same
        location as the package.  Note that globs are allowed to reference
        the contents of non-package subdirectories, as long as you use '/' as
        a path separator.  (Globs are automatically converted to
        platform-specific paths at runtime.)

    In addition to these new keywords, this class also has several new methods
    for manipulating the distribution's contents.  For example, the 'include()'
    and 'exclude()' methods can be thought of as in-place add and subtract
    commands that add or remove packages, modules, extensions, and so on from
    the distribution.  They are used by the feature subsystem to configure the
    distribution for the included and excluded features.
    N)r&r*r'cCsl|rd|ksd|krdSt�t|d����}tjj�|�}|dk	rh|�d�sht�t|d��|_	||_
dS)Nr2r:zPKG-INFO)rWZ	safe_namerP�lower�working_setZby_key�getZhas_metadataZsafe_versionZ_version�
_patched_dist)r0�attrsrHr^rrr�patch_missing_pkg_info�sz#Distribution.patch_missing_pkg_infoc
	s�t�d�}|si�_|pi}d|ks,d|kr4t��g�_i�_g�_|�dd��_��	|�|�dg��_
|�dg��_t�
d�D]}t���|jd�q�t���fdd	�|��D���j��D]L\}}�jj|fD]}||kr�||}�qq�|r�|�nd}t�j||�q�t�jjtj��r4t�jj��j_�jjdk	�r�zHtj��jj�}t|�}	�jj|	k�r�t� d
�jj|	f�|	�j_Wn0tjj!t"fk
�r�t� d�jj�YnX��#�dS)N�package_data�features�require_features�src_root�dependency_links�setup_requires�distutils.setup_keywordscs i|]\}}|�jkr||�qSr)�_DISTUTILS_UNSUPPORTED_METADATA��.0r�r��r0rr�
<dictcomp>�s
�z)Distribution.__init__.<locals>.<dictcomp>zNormalizing '%s' to '%s'z�The version specified (%r) is an invalid version, this may not work as expected with newer versions of setuptools, pip, and PyPI. Please see PEP 440 for more details.)$rSr��Feature�warn_deprecatedr�r�Z
dist_files�popr�r�r�r�rW�iter_entry_points�vars�
setdefaultr2�
_Distribution�__init__rQr��metadata�__dict__�setattrrzr:�numbers�NumberrPrrLrrZInvalidVersionrZ�_finalize_requires)
r0r�Zhave_package_datar_�option�default�sourcer3ZverZnormalized_versionrr�rr��s\

�����
zDistribution.__init__cCsft|dd�r|j|j_t|dd�rR|j��D]$}|�d�d}|r,|jj�|�q,|��|�	�dS)z�
        Set `metadata.python_requires` and fix environment markers
        in `install_requires` and `extras_require`.
        r"N�extras_requirerpr)
r%r"r�r��keysrBr'�add�_convert_extras_requirements�"_move_install_requirements_markers)r0rUrrrr��s
zDistribution._finalize_requirescCsht|dd�pi}tt�|_|��D]@\}}|j|t�|�D]"}|�|�}|j||�|�q>q"dS)z�
        Convert requirements in `extras_require` of the form
        `"extra": ["barbazquux; {marker}"]` to
        `"extra:{marker}": ["barbazquux"]`.
        r�N)	r%rrk�_tmp_extras_requirerQrWrr�_suffix_for�append)r0Z
spec_ext_reqs�sectionr��r�suffixrrrr��s


z)Distribution._convert_extras_requirementscCs|jrdt|j�SdS)ze
        For a requirement, return the 'extras_require' suffix for
        that requirement.
        rp�)rsrP��reqrrrr�szDistribution._suffix_forcs�dd�}t�dd�pd}tt�|��}t||�}t||�}ttt|���_|D]}�j	dt|j
��|�qNt�fdd��j	�
�D���_dS)	zv
        Move requirements in `install_requires` that are using environment
        markers `extras_require`.
        cSs|jSr7�rsr�rrr�
is_simple_reqszFDistribution._move_install_requirements_markers.<locals>.is_simple_req�install_requiresNrrpc3s,|]$\}}|dd�t�j|�D�fVqdS)cSsg|]}t|��qSr)rP�r�r�rrr�
<listcomp>)szMDistribution._move_install_requirements_markers.<locals>.<genexpr>.<listcomp>N)r�
_clean_reqr�r�rr�	<genexpr>(s�zBDistribution._move_install_requirements_markers.<locals>.<genexpr>)r%rkrWrrrrrrPr�r�rsr�r{rQr�)r0r�Zspec_inst_reqsZ	inst_reqsZsimple_reqsZcomplex_reqsr�rr�rr�s


�z/Distribution._move_install_requirements_markerscCs
d|_|S)zP
        Given a Requirement, remove environment markers and return it.
        Nr�)r0r�rrrr�-szDistribution._clean_reqc
Cs�ddlm}tjr>tjtjkr>ddddddd	d
ddd
ddg
}ng}t|�}|dkrZ|��}t	rh|�
d�|�}|D]�}tj|dd��4}t	r�|�
dj
ft���tjr�|jn|j|�W5QRX|��D]\}|�|�}|�|�}	|D]>}
|
dkr�|
|kr�|�|�||
��}|
�dd�}
||f|	|
<q�q�|��qrd|jk�r�|jd��D]�\}
\}}|j�|
�}
zF|
�r|t||
t|��n(|
dk�r�t||
t|��nt||
|�Wn,tk
�r�}zt|��W5d}~XYnX�qHdS)z�
        Adapted from distutils.dist.Distribution.parse_config_files,
        this method provides the same functionality in subtly-improved
        ways.
        r)�ConfigParserzinstall-basezinstall-platbasezinstall-libzinstall-platlibzinstall-purelibzinstall-headerszinstall-scriptszinstall-data�prefixzexec-prefix�home�user�rootNz"Distribution.parse_config_files():�utf-8)�encodingz  reading {filename}�__name__�-�_�global)�verboseZdry_run)Z(setuptools.extern.six.moves.configparserr�r�PY3�sysr��base_prefix�	frozensetZfind_config_filesr�announce�io�openru�localsZ	read_fileZreadfpZsections�options�get_option_dict�_try_strr��replacer��command_optionsrQ�negative_optr�rr[r	)r0�	filenamesr�Zignore_options�parser�filename�readerr�r�Zopt_dict�opt�val�src�aliasr5rrr�_parse_config_files4s`�
 



z Distribution._parse_config_filescCs.tjr
|Sz
|��WStk
r(YnX|S)ab
        On Python 2, much of distutils relies on string values being of
        type 'str' (bytes) and not unicode text. If the value can be safely
        encoded to bytes using the default encoding, prefer that.

        Why the default encoding? Because that value can be implicitly
        decoded back to text if needed.

        Ref #1653
        )rr��encode�UnicodeEncodeError)r�rrrr�rs
zDistribution._try_strcCs^|��}|dkr|�|�}tr,|�d|�|��D�]"\}\}}trZ|�d|||f�zdd�|jD�}Wntk
r�g}YnXz
|j}Wntk
r�i}YnXz~t|t	j
�}	||kr�|	r�t|||t|��nJ||kr�|	r�t||t|��n,t
||��rt|||�ntd|||f��Wq4tk
�rV}
zt|
��W5d}
~
XYq4Xq4dS)a�
        Set the options for 'command_obj' from 'option_dict'.  Basically
        this means copying elements of a dictionary ('option_dict') to
        attributes of an instance ('command').

        'command_obj' must be a Command instance.  If 'option_dict' is not
        supplied, uses the standard option dictionary for this command
        (from 'self.command_options').

        (Adopted from distutils.dist.Distribution._set_command_options)
        Nz#  setting options for '%s' command:z    %s = %s (from %s)cSsg|]}t|��qSrr)r��orrrr��s�z5Distribution._set_command_options.<locals>.<listcomp>z1error in %s: command '%s' has no such option '%s')Zget_command_namer�rr�rQZboolean_optionsr\r�rzrr�r�rrSr	r[)r0Zcommand_objZoption_dictZcommand_namer�r�r3Z	bool_opts�neg_optZ	is_stringr5rrr�_set_command_options�sF

��



��z!Distribution._set_command_optionsFcCs(|j|d�t||j|d�|��dS)zYParses configuration files from various levels
        and loads configuration.

        )r�)�ignore_option_errorsN)r�rr�r�)r0r�r�rrr�parse_config_files�s
�zDistribution.parse_config_filescCst�|�}|jr|��|S)z3Process features after parsing command line options)r��parse_command_liner��_finalize_features)r0�resultrrrr��s
zDistribution.parse_command_linecCsd|�dd�S)z;Convert feature name to corresponding option attribute nameZwith_r�r��r��r0r2rrr�_feature_attrname�szDistribution._feature_attrnamecCs8tjjt�|�|jdd�}|D]}tjj|dd�q|S)zResolve pre-setup requirementsT)�	installerZreplace_conflictingr�)rWr��resolverr�fetch_build_eggr�)r0r,Zresolved_distsr^rrr�fetch_build_eggs�s�zDistribution.fetch_build_eggscCs�t�|�|jr|��t�d�D]:}t||jd�}|dk	r"|j|j	d�|�
�||j|�q"t|dd�r~dd�|jD�|_ng|_dS)Nr��r��convert_2to3_doctestscSsg|]}tj�|��qSr)�os�path�abspath�r��prrrr��s�z1Distribution.finalize_options.<locals>.<listcomp>)r��finalize_optionsr��_set_global_opts_from_featuresrWr�r%r2�requirer��loadr�)r0r_r3rrrr��s
�
zDistribution.finalize_optionsc	Csvtj�tjd�}tj�|�srt�|�t�|�tj�|d�}t|d��$}|�	d�|�	d�|�	d�W5QRX|S)Nz.eggsz
README.txt�wzcThis directory contains eggs that were downloaded by setuptools to build, test, and run plug-ins.

zAThis directory caches those eggs to prevent repeated downloads.

z/However, it is safe to delete this directory.

)
r�r�rR�curdir�exists�mkdirrZ	hide_filer�rF)r0Z
egg_cache_dirZreadme_txt_filename�frrr�get_egg_cache_dir�s



zDistribution.get_egg_cache_dirc
Cs�ddlm}|�ddgi�}|�d�}|��|�dd�|�d���D��|jr�|jdd�}d|krx|dd	|}d
|f|d<|��}||dg|dd
dd
d
ddd
d�}|�	�|�|�S)z Fetch an egg needed for buildingr)�easy_installZscript_argsrcss"|]\}}|dkr||fVqdS))�
find_links�	site_dirsZ	index_url�optimizer	Zallow_hostsNrr�rrrr��s�z/Distribution.fetch_build_egg.<locals>.<genexpr>NrrZsetup�xTF)
�args�install_dirZexclude_scriptsZalways_copyZbuild_directoryZeditableZupgradeZ
multi_versionZ	no_reportr�)
Zsetuptools.command.easy_installr�	__class__r��clear�updaterQr�rZensure_finalized)r0r�rr^�optsZlinksr
�cmdrrrr��s8

��zDistribution.fetch_build_eggc	Cs�g}|j��}|j��D]�\}}|�|d�|�|�|jr|j}d}d}|��s\||}}d|dd||fd|dd||ff}|�	|�d||d|<q||j
|_
|_||_|_dS)z;Add --with-X/--without-X options based on optional featuresNz
 (default)r�zwith-zinclude zwithout-zexclude )
r��copyr�rQ�_set_feature�validate�optionalr=�include_by_default�extend�global_optionsZfeature_optionsZfeature_negopt)	r0ZgoZnor2�feature�descrZincdefZexcdef�newrrrr�s$


�
z+Distribution._set_global_opts_from_featurescCs�|j��D]<\}}|�|�}|s0|dkr
|��r
|�|�|�|d�q
|j��D](\}}|�|�sR|�|�|�|d�qRdS)z9Add/remove features and resolve dependencies between themNrr)r�rQ�feature_is_includedr�
include_inr�exclude_from)r0r2rZenabledrrrr�0s



zDistribution._finalize_featurescCs\||jkr|j|St�d|�}|D]*}|j|jd�|��|j|<}|St�||�S)z(Pluggable version of get_command_class()�distutils.commandsr�N)�cmdclassrWr�r�r�rr��get_command_class)r0�commandZepsr_r!rrrr"As

zDistribution.get_command_classcCs:t�d�D]$}|j|jkr
|��}||j|j<q
t�|�S�Nr )rWr�r2r!r�r��print_commands�r0r_r!rrrr%Ns
zDistribution.print_commandscCs:t�d�D]$}|j|jkr
|��}||j|j<q
t�|�Sr$)rWr�r2r!r�r��get_command_listr&rrrr'Vs
zDistribution.get_command_listcCst||�|�|�dS)zSet feature's inclusion statusN)r�r�)r0r2Zstatusrrrr^szDistribution._set_featurecCst||�|��S)zAReturn 1 if feature is included, 0 if excluded, 'None' if unknown)r%r�r�rrrrbsz Distribution.feature_is_includedcCsF|�|�dkr&|j|j}t|d��|j|�|�|�|d�dS)z)Request inclusion of feature named 'name'rz2 is required, but was excluded or is not availablerN)rr�r=r	rr)r0r2rrrr�include_featurefs�zDistribution.include_featurecKs@|��D]2\}}t|d|d�}|r.||�q|�||�qdS)a�Add items to distribution that are named in keyword arguments

        For example, 'dist.include(py_modules=["x"])' would add 'x' to
        the distribution's 'py_modules' attribute, if it was not already
        there.

        Currently, this method only supports inclusion for attributes that are
        lists or tuples.  If you need to add support for adding to other
        attributes in this or a subclass, you can add an '_include_X' method,
        where 'X' is the name of the attribute.  The method will be called with
        the value passed to 'include()'.  So, 'dist.include(foo={"bar":"baz"})'
        will try to call 'dist._include_foo({"bar":"baz"})', which can then
        handle whatever special inclusion logic is needed.
        Z	_include_N)rQr%�
_include_misc)r0r�r�r��includerrrr*qs

zDistribution.includecsf�d�|jr&��fdd�|jD�|_|jrD��fdd�|jD�|_|jrb��fdd�|jD�|_dS)z9Remove packages, modules, and extensions in named packagerccs"g|]}|�kr|���s|�qSr��
startswithr���package�pfxrrr��s
�z0Distribution.exclude_package.<locals>.<listcomp>cs"g|]}|�kr|���s|�qSrr+r�r-rrr��s
�cs&g|]}|j�kr|j���s|�qSr)r2r,r�r-rrr��s
�N)�packages�
py_modules�ext_modules)r0r.rr-r�exclude_package�s���zDistribution.exclude_packagecCs2|d}|��D]}||ks&|�|�rdSqdS)z<Return true if 'exclude_package(package)' would do somethingrcTN)�iter_distribution_namesr,)r0r.r/r�rrrrd�szDistribution.has_contents_forcs�t�t�std|�f��zt||�}Wn tk
rHtd|��YnX|dk	rjt|t�sjt|d��n|r�t||�fdd�|D��dS)zAHandle 'exclude()' for list/tuple attrs without a special handlerz(%s: setting must be a list or tuple (%r)� %s: No such distribution settingN�4: this setting cannot be changed via include/excludecsg|]}|�kr|�qSrr�r��item�r3rrr��sz.Distribution._exclude_misc.<locals>.<listcomp>�rz�sequencerr%r\r�)r0r2r3�oldrr9r�
_exclude_misc�s 

��
�zDistribution._exclude_misccs�t|t�std||f��zt||��Wn tk
rHtd|��YnX�dkr`t|||�n:t�t�sxt|d��n"�fdd�|D�}t||�|�dS)zAHandle 'include()' for list/tuple attrs without a special handlerz%s: setting must be a list (%r)r5Nr6csg|]}|�kr|�qSrrr7�r<rrr��sz.Distribution._include_misc.<locals>.<listcomp>r:)r0r2r3rrr>rr)�s$

��

�zDistribution._include_misccKs@|��D]2\}}t|d|d�}|r.||�q|�||�qdS)aRemove items from distribution that are named in keyword arguments

        For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from
        the distribution's 'py_modules' attribute.  Excluding packages uses
        the 'exclude_package()' method, so all of the package's contained
        packages, modules, and extensions are also excluded.

        Currently, this method only supports exclusion from attributes that are
        lists or tuples.  If you need to add support for excluding from other
        attributes in this or a subclass, you can add an '_exclude_X' method,
        where 'X' is the name of the attribute.  The method will be called with
        the value passed to 'exclude()'.  So, 'dist.exclude(foo={"bar":"baz"})'
        will try to call 'dist._exclude_foo({"bar":"baz"})', which can then
        handle whatever special exclusion logic is needed.
        Z	_exclude_N)rQr%r=)r0r�r�r��excluderrrr?�s

zDistribution.excludecCs,t|t�std|f��tt|j|��dS)Nz.packages: setting must be a list or tuple (%r))rzr;rrkrr3)r0r0rrr�_exclude_packages�s

�zDistribution._exclude_packagesc
Cs�|jj|_|jj|_|d}|�d�}||krf||\}}||=ddl}|�|d�|dd�<|d}q&t�|||�}|�|�}	t	|	dd�r�d|f|�|�d<|dk	r�gS|S)Nr�aliasesTrZcommand_consumes_arguments�command liner)
rrr�r��shlexrBr��_parse_command_optsr"r%)
r0r�rr#rAr�r�rC�nargsZ	cmd_classrrrrD�s"




z Distribution._parse_command_optscCs�i}|j��D]�\}}|��D]�\}\}}|dkr4q|�dd�}|dkr�|�|�}|j��}|�t|di��|��D]\}	}
|
|krv|	}d}q�qvtd��n|dkr�d}||�	|i�|<qq|S)	ahReturn a '{cmd: {opt:val}}' map of all command-line options

        Option names are all long, but do not include the leading '--', and
        contain dashes rather than underscores.  If the option doesn't take
        an argument (e.g. '--quiet'), the 'val' is 'None'.

        Note that options provided by config files are intentionally excluded.
        rBr�r�rr�NzShouldn't be able to get herer)
r�rQr�Zget_command_objr�rrr%r]r�)r0�drrr�r�r�Zcmdobjr��neg�posrrr�get_cmdline_optionss(



z Distribution.get_cmdline_optionsccsv|jpdD]
}|Vq
|jpdD]
}|Vq |jp4dD]:}t|t�rN|\}}n|j}|�d�rj|dd�}|Vq6dS)z@Yield all packages, modules, and extension names in distributionr�moduleNi����)r0r1r2rz�tupler2�endswith)r0ZpkgrJZextr2Z	buildinforrrr40s


z$Distribution.iter_distribution_namesc
Cs�ddl}tjs|jr t�||�St|jtj	�s:t�||�S|jj
��dkrVt�||�S|jj
}|jj}|j
dkrtdpvd}|jj}t�	|j��d|||�|_zt�||�W�St�	|j��||||�|_XdS)z�If there were any non-global "display-only" options
        (--help-commands or the metadata display options) on the command
        line, display the requested info and return true; else return
        false.
        rN)r��utf8Zwin32�
r�)r�rrOZ
help_commandsr��handle_display_optionsrz�stdoutr��
TextIOWrapperr�r��errorsr@�line_buffering�detach)r0Zoption_orderr�r�rR�newlinerSrrrrOBs6��z#Distribution.handle_display_options)N)N)N)NF).r��
__module__�__qualname__�__doc__r{rZ
OrderedSetr�r�r�r�r�r��staticmethodr�r�r�r�r�r�r�r�r�r�r�rr�r�r�r"r%r'rrr(r*r3rdr=r)r?r@rDrIr4rOrrrrrTsXD�
;

>

/

	(c@sFeZdZdZedd��Zddd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)r�a�
    **deprecated** -- The `Feature` facility was never completely implemented
    or supported, `has reported issues
    <https://github.com/pypa/setuptools/issues/58>`_ and will be removed in
    a future version.

    A subset of the distribution that can be excluded if unneeded/wanted

    Features are created using these keyword arguments:

      'description' -- a short, human readable description of the feature, to
         be used in error messages, and option help messages.

      'standard' -- if true, the feature is included by default if it is
         available on the current system.  Otherwise, the feature is only
         included if requested via a command line '--with-X' option, or if
         another included feature requires it.  The default setting is 'False'.

      'available' -- if true, the feature is available for installation on the
         current system.  The default setting is 'True'.

      'optional' -- if true, the feature's inclusion can be controlled from the
         command line, using the '--with-X' or '--without-X' options.  If
         false, the feature's inclusion status is determined automatically,
         based on 'availabile', 'standard', and whether any other feature
         requires it.  The default setting is 'True'.

      'require_features' -- a string or sequence of strings naming features
         that should also be included if this feature is included.  Defaults to
         empty list.  May also contain 'Require' objects that should be
         added/removed from the distribution.

      'remove' -- a string or list of strings naming packages to be removed
         from the distribution if this feature is *not* included.  If the
         feature *is* included, this argument is ignored.  This argument exists
         to support removing features that "crosscut" a distribution, such as
         defining a 'tests' feature that removes all the 'tests' subpackages
         provided by other features.  The default for this argument is an empty
         list.  (Note: the named package(s) or modules must exist in the base
         distribution when the 'setup()' function is initially called.)

      other keywords -- any other keyword arguments are saved, and passed to
         the distribution's 'include()' and 'exclude()' methods when the
         feature is included or excluded, respectively.  So, for example, you
         could pass 'packages=["a","b"]' to cause packages 'a' and 'b' to be
         added or removed from the distribution as appropriate.

    A feature must include at least one 'requires', 'remove', or other
    keyword argument.  Otherwise, it can't affect the distribution in any way.
    Note also that you can subclass 'Feature' to create your own specialized
    feature types that modify the distribution in other ways when included or
    excluded.  See the docstrings for the various methods here for more detail.
    Aside from the methods, the only feature attributes that distributions look
    at are 'description' and 'optional'.
    cCsd}tj|tdd�dS)NzrFeatures are deprecated and will be removed in a future version. See https://github.com/pypa/setuptools/issues/65.�)�
stacklevel)rrrr4rrrr��s�zFeature.warn_deprecatedFTrc	Ks�|��||_||_||_||_t|ttf�r4|f}dd�|D�|_dd�|D�}|r^||d<t|t�rn|f}||_	||_
|s�|s�|s�td��dS)NcSsg|]}t|t�r|�qSr�rzrPr�rrrr��s
z$Feature.__init__.<locals>.<listcomp>cSsg|]}t|t�s|�qSrr\r�rrrr��s
r�zgFeature %s: must define 'require_features', 'remove', or at least one of 'packages', 'py_modules', etc.)r�r=�standard�	availablerrzrPrr��remove�extrasr)	r0r=r]r^rr�r_r`Zerrrrr��s*�
�zFeature.__init__cCs|jo
|jS)z+Should this feature be included by default?)r^r]r�rrrr�szFeature.include_by_defaultcCs<|jst|jd��|jf|j�|jD]}|�|�q(dS)aEnsure feature and its requirements are included in distribution

        You may override this in a subclass to perform additional operations on
        the distribution.  Note that this method may be called more than once
        per feature, and so should be idempotent.

        z3 is required, but is not available on this platformN)r^r
r=r*r`r�r()r0r^rrrrr�s	�
zFeature.include_incCs.|jf|j�|jr*|jD]}|�|�qdS)a2Ensure feature is excluded from distribution

        You may override this in a subclass to perform additional operations on
        the distribution.  This method will be called at most once per
        feature, and only after all included features have been asked to
        include themselves.
        N)r?r`r_r3�r0r^r8rrrr�s	
zFeature.exclude_fromcCs.|jD]"}|�|�std|j||f��qdS)a�Verify that feature makes sense in context of distribution

        This method is called by the distribution just before it parses its
        command line.  It checks to ensure that the 'remove' attribute, if any,
        contains only valid package/module names that are present in the base
        distribution when 'setup()' is called.  You may override it in a
        subclass to perform any other required validation of the feature
        against a target distribution.
        zg%s wants to be able to remove %s, but the distribution doesn't contain any packages or modules under %sN)r_rdrr=rarrrr�s


��zFeature.validateN)FTTrr)r�rVrWrXrYr�r�rrrrrrrrr�es8
�
r�c@seZdZdZdS)rzrClass for warning about deprecations in dist in
    setuptools. Not ignored by default, unlike DeprecationWarning.N)r�rVrWrXrrrrr�sr)J�__all__r�r�r�r�rr�Z
distutils.logrfZdistutils.coreZ
distutils.cmdZdistutils.distZdistutils.utilrZdistutils.debugrZdistutils.fancy_getoptrrl�collectionsrZemailrZdistutils.errorsr	r
rrZdistutils.versionr
Zsetuptools.externrrrZsetuptools.extern.six.movesrrrr�rZsetuptools.dependsrZ
setuptoolsrZsetuptools.monkeyrZsetuptools.configrrW�
__import__r r1rDrVrKrkr;r`rbrjrornrwr~rr�r�r�r�Zcorerr�r�rrrrr�<module>sv6L	site-packages/setuptools/__pycache__/sandbox.cpython-38.opt-1.pyc000064400000036260151446177000020756 0ustar00U

�Qab�7�@s
ddlZddlZddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
mZddlm
Z
mZddlZej�d�r�ddlmmmmZnejejZzeZWnek
r�dZYnXeZddlm Z ddlm!Z!ddd	d
gZ"d-dd�Z#ej$d.d
d��Z%ej$dd��Z&ej$dd��Z'ej$dd��Z(Gdd�de)�Z*Gdd�d�Z+ej$dd��Z,dd�Z-ej$dd��Z.ej$dd ��Z/d!d"�Z0d#d$�Z1d%d
�Z2Gd&d�d�Z3e4ed'��r�ej5gZ6ngZ6Gd(d�de3�Z7e�8ej9d)d*�d+�:�D��Z;Gd,d	�d	e �Z<dS)/�N)�six)�builtins�map�java)�DistutilsError)�working_set�AbstractSandbox�DirectorySandbox�SandboxViolation�	run_setupc	CsJd}t||��}|��}W5QRX|dkr.|}t||d�}t|||�dS)z.
    Python 3 implementation of execfile.
    �rbN�exec)�open�read�compiler
)�filename�globals�locals�mode�streamZscript�code�r�6/usr/lib/python3.8/site-packages/setuptools/sandbox.py�	_execfile#src
csDtjdd�}|dk	r$|tjdd�<z
|VW5|tjdd�<XdS�N)�sys�argv)�repl�savedrrr�	save_argv0s
rc
cs.tjdd�}z
|VW5|tjdd�<XdSr)r�path�rrrr�	save_path;s
r"ccs4tjj|dd�tj}|t_z
dVW5|t_XdS)zL
    Monkey-patch tempfile.tempdir with replacement, ensuring it exists
    T)�exist_okN)�
pkg_resourcesZ
py31compat�makedirs�tempfileZtempdir)Zreplacementrrrr�
override_tempDs
r'c	cs.t��}t�|�z
|VW5t�|�XdSr)�os�getcwd�chdir)�targetrrrr�pushdUs


r,c@seZdZdZedd��ZdS)�UnpickleableExceptionzP
    An exception representing another Exception that could not be pickled.
    c	CsPzt�|�t�|�fWStk
rJddlm}|�||t|���YSXdS)z�
        Always return a dumped (pickled) type and exc. If exc can't be pickled,
        wrap it in UnpickleableException first.
        r)r-N)�pickle�dumps�	Exception�setuptools.sandboxr-�dump�repr)�type�exc�clsrrrr2ds
zUnpickleableException.dumpN)�__name__�
__module__�__qualname__�__doc__�staticmethodr2rrrrr-_sr-c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�ExceptionSaverz^
    A Context Manager that will save an exception, serialized, and restore it
    later.
    cCs|Srr��selfrrr�	__enter__xszExceptionSaver.__enter__cCs |sdSt�||�|_||_dS�NT)r-r2�_saved�_tb)r>r4r5�tbrrr�__exit__{s
zExceptionSaver.__exit__cCs6dt|�krdSttj|j�\}}t�|||j�dS)z"restore and re-raise any exceptionrAN)�varsrr.�loadsrArZreraiserB)r>r4r5rrr�resume�szExceptionSaver.resumeN)r7r8r9r:r?rDrGrrrrr<rsr<c	#sVtj���t��}�VW5QRXtj����fdd�tjD�}t|�|��dS)z�
    Context in which imported modules are saved.

    Translates exceptions internal to the context into the equivalent exception
    outside the context.
    c3s$|]}|�kr|�d�s|VqdS)z
encodings.N��
startswith)�.0�mod_namer!rr�	<genexpr>�s
�zsave_modules.<locals>.<genexpr>N)r�modules�copyr<�update�_clear_modulesrG)�	saved_excZdel_modulesrr!r�save_modules�s

�rRcCst|�D]}tj|=qdSr)�listrrM)Zmodule_namesrKrrrrP�srPc	cs$t��}z
|VW5t�|�XdSr)r$�__getstate__�__setstate__r!rrr�save_pkg_resources_state�s
rVccs�tj�|d�}t��xt��ft�t��Nt��<t|��(t	|��t
d�dVW5QRXW5QRXW5QRXW5QRXW5QRXW5QRXdS)NZtempZ
setuptools)r(r �joinrVrR�hide_setuptoolsr"rr'r,�
__import__)�	setup_dirZtemp_dirrrr�
setup_context�s

r[cCst�d�}t|�|��S)aH
    >>> _needs_hiding('setuptools')
    True
    >>> _needs_hiding('pkg_resources')
    True
    >>> _needs_hiding('setuptools_plugin')
    False
    >>> _needs_hiding('setuptools.__init__')
    True
    >>> _needs_hiding('distutils')
    True
    >>> _needs_hiding('os')
    False
    >>> _needs_hiding('Cython')
    True
    z1(setuptools|pkg_resources|distutils|Cython)(\.|$))�rer�bool�match)rK�patternrrr�
_needs_hiding�s
r`cCstttj�}t|�dS)a%
    Remove references to setuptools' modules from sys.modules to allow the
    invocation to import the most appropriate setuptools. This technique is
    necessary to avoid issues such as #315 where setuptools upgrading itself
    would fail to find a function declared in the metadata.
    N)�filterr`rrMrP)rMrrrrX�srXcCs�tj�tj�|��}t|���z�|gt|�tjdd�<tj�d|�t	�
�t	j�dd��t
|t�rl|n|�t���}t|��t|dd�}t||�W5QRXWn4tk
r�}z|jr�|jdrʂW5d}~XYnXW5QRXdS)z8Run a distutils setup script, sandboxed in its directoryNrcSs|��Sr)Zactivate)Zdistrrr�<lambda>��zrun_setup.<locals>.<lambda>�__main__)�__file__r7)r(r �abspath�dirnamer[rSrr�insertr�__init__Z	callbacks�append�
isinstance�str�encode�getfilesystemencodingr	�dictr�
SystemExit�args)Zsetup_scriptrqrZZdunder_file�ns�vrrrr�s"
��
c@seZdZdZdZdd�Zdd�Zdd�Zd	d
�Zdd�Z	d
d�Z
dD]Zee
e�rDe
e�e�e<qDd$dd�Zerzede�Zede�ZdD]Zee
e�r�ee�e�e<q�dd�ZdD]Zee
e�r�ee�e�e<q�dd�ZdD]Zee
e�r�ee�e�e<q�dd�Zdd�Zd d!�Zd"d#�ZdS)%rzDWrap 'os' module and 'open()' builtin for virtualizing setup scriptsFcs�fdd�tt�D��_dS)Ncs$g|]}|�d�st�|�r|�qS)�_)rI�hasattr)rJ�namer=rr�
<listcomp>s

�z,AbstractSandbox.__init__.<locals>.<listcomp>)�dir�_os�_attrsr=rr=rris
�zAbstractSandbox.__init__cCs"|jD]}tt|t||��qdSr)rz�setattrr(�getattr)r>�sourcervrrr�_copys
zAbstractSandbox._copycCs(|�|�tr|jt_|jt_d|_dSr@)r~�_filer�file�_openr�_activer=rrrr?s

zAbstractSandbox.__enter__cCs$d|_trtt_tt_|�t�dS�NF)r�rrr�r�rr~ry)r>�exc_type�	exc_value�	tracebackrrrrDs
zAbstractSandbox.__exit__c
Cs"|�|�W5QR�SQRXdS)zRun 'func' under os sandboxingNr)r>�funcrrr�runszAbstractSandbox.runcstt�����fdd�}|S)Ncs2|jr |j�||f|�|�\}}�||f|�|�Sr)r��_remap_pair)r>�src�dstrq�kw�rv�originalrr�wrap&sz3AbstractSandbox._mk_dual_path_wrapper.<locals>.wrap�r|ry�rvr�rr�r�_mk_dual_path_wrapper#s
z%AbstractSandbox._mk_dual_path_wrapper)�rename�link�symlinkNcs �ptt�����fdd�}|S)Ncs*|jr|j�|f|�|�}�|f|�|�Sr)r��_remap_input�r>r rqr�r�rrr�4sz5AbstractSandbox._mk_single_path_wrapper.<locals>.wrapr�)rvr�r�rr�r�_mk_single_path_wrapper1sz'AbstractSandbox._mk_single_path_wrapperr�r)�stat�listdirr*r�chmod�chown�mkdir�remove�unlink�rmdir�utime�lchown�chroot�lstatZ	startfile�mkfifo�mknod�pathconf�accesscstt�����fdd�}|S)NcsB|jr2|j�|f|�|�}|���|f|�|��S�|f|�|�Sr)r�r��
_remap_outputr�r�rrr�Isz4AbstractSandbox._mk_single_with_return.<locals>.wrapr�r�rr�r�_mk_single_with_returnFs
z&AbstractSandbox._mk_single_with_return)�readlink�tempnamcstt�����fdd�}|S)Ncs �||�}|jr|��|�S|Sr)r�r�)r>rqr�Zretvalr�rrr�Xs
z'AbstractSandbox._mk_query.<locals>.wrapr�r�rr�r�	_mk_queryUs
zAbstractSandbox._mk_query)r)�tmpnamcCs|S)z=Called to remap or validate any path, whether input or outputr)r>r rrr�_validate_pathdszAbstractSandbox._validate_pathcOs
|�|�S�zCalled for path inputs�r��r>�	operationr rqr�rrrr�hszAbstractSandbox._remap_inputcCs
|�|�S)zCalled for path outputsr�)r>r�r rrrr�lszAbstractSandbox._remap_outputcOs0|j|d|f|�|�|j|d|f|�|�fS)�?Called for path pairs like rename, link, and symlink operationsz-fromz-to)r��r>r�r�r�rqr�rrrr�ps�zAbstractSandbox._remap_pair)N)r7r8r9r:r�rir~r?rDr�r�rvruryrr�rr�r�r�r�r�r�r�rrrrrs<








�devnullc@s�eZdZdZe�dddddddd	d
ddd
dg
�ZdgZefdd�Z	dd�Z
erXd'dd�Zd(dd�Zdd�Z
dd�Zdd�Zdd �Zd!d"�Zd)d$d%�Zd&S)*r	z<Restrict operations to a single subdirectory - pseudo-chrootrr�r�r�r�r�r�r�r�r�r�r�r�z.*lib2to3.*\.pickle$cCsFtj�tj�|��|_tj�|jd�|_dd�|D�|_t�	|�dS)N�cSs g|]}tj�tj�|���qSr)r(r �normcase�realpath)rJr rrrrw�s�z-DirectorySandbox.__init__.<locals>.<listcomp>)
r(r r�r��_sandboxrW�_prefix�_exceptionsrri)r>Zsandbox�
exceptionsrrrri�s�zDirectorySandbox.__init__cOsddlm}||||��dS)Nr)r
)r1r
)r>r�rqr�r
rrr�
_violation�szDirectorySandbox._violation�rcOs:|dkr(|�|�s(|jd||f|�|�t||f|�|�S)N�r�ZrtrZrU�Ur�)�_okr�r�r>r rrqr�rrrr�szDirectorySandbox._filecOs:|dkr(|�|�s(|jd||f|�|�t||f|�|�S)Nr�r)r�r�r�r�rrrr��szDirectorySandbox._opencCs|�d�dS)Nr�)r�r=rrrr��szDirectorySandbox.tmpnamcCsR|j}z>d|_tj�tj�|��}|�|�p@||jkp@|�|j�W�S||_XdSr�)	r�r(r r�r��	_exemptedr�rIr�)r>r Zactiver�rrrr��s
�
�zDirectorySandbox._okcs<�fdd�|jD�}�fdd�|jD�}t�||�}t|�S)Nc3s|]}��|�VqdSrrH)rJZ	exception��filepathrrrL�s�z-DirectorySandbox._exempted.<locals>.<genexpr>c3s|]}t�|��VqdSr)r\r^)rJr_r�rrrL�s�)r��_exception_patterns�	itertools�chain�any)r>r�Z
start_matchesZpattern_matchesZ
candidatesrr�rr��s
�
�zDirectorySandbox._exemptedcOs4||jkr0|�|�s0|j|tj�|�f|�|�|Sr�)�	write_opsr�r�r(r r�r�rrrr��szDirectorySandbox._remap_inputcOs2|�|�r|�|�s*|j|||f|�|�||fS)r�)r�r�r�rrrr��szDirectorySandbox._remap_pair�cOs@|t@r*|�|�s*|jd|||f|�|�tj|||f|�|�S)zCalled for low-level os.open()zos.open)�WRITE_FLAGSr�r�ryr)r>r��flagsrrqr�rrrr�szDirectorySandbox.openN)r�)r�)r�)r7r8r9r:ro�fromkeysr�r��_EXCEPTIONSrir�rr�r�r�r�r�r�rrrrrr	~s:��	


cCsg|]}tt|d��qS)rr�)rJ�arrrrw�srwz4O_WRONLY O_RDWR O_APPEND O_CREAT O_TRUNC O_TEMPORARYc@s&eZdZdZe�d���Zdd�ZdS)r
zEA setup script attempted to modify the filesystem outside the sandboxa
        SandboxViolation: {cmd}{args!r} {kwargs}

        The package setup script has attempted to modify files on your system
        that are not within the EasyInstall build area, and has been aborted.

        This package cannot be safely installed by EasyInstall, and may not
        support alternate installation locations even if you run its setup
        script by hand.  Please inform the package's author and the EasyInstall
        maintainers to find out if a fix or workaround is available.
        cCs|j\}}}|jjft��Sr)rq�tmpl�formatr)r>�cmdrq�kwargsrrr�__str__�szSandboxViolation.__str__N)	r7r8r9r:�textwrap�dedent�lstripr�r�rrrrr
�s)N)N)=r(rr&�operator�	functoolsr�r\�
contextlibr.r�Zsetuptools.externrZsetuptools.extern.six.movesrrZpkg_resources.py31compatr$�platformrIZ$org.python.modules.posix.PosixModule�pythonrM�posixZPosixModuleryrvr�r�	NameErrorrr�Zdistutils.errorsrr�__all__r�contextmanagerrr"r'r,r0r-r<rRrPrVr[r`rXrrrur�r�r	�reduce�or_�splitr�r
rrrr�<module>sx 
�





	


w
V��site-packages/setuptools/__pycache__/launch.cpython-38.pyc000064400000001470151446177000017626 0ustar00U

�Qab�@s.dZddlZddlZdd�Zedkr*e�dS)z[
Launch the Python script on the command line after
setuptools is bootstrapped via import.
�NcCsrttjd}t|ddd�}tjdd�tjdd�<ttdt�}||���}|�dd�}t	||d�}t
||�dS)	zP
    Run the script in sys.argv[1] as if it had
    been invoked naturally.
    ��__main__N)�__file__�__name__�__doc__�openz\r\nz\n�exec)�__builtins__�sys�argv�dict�getattr�tokenizer�read�replace�compiler)Zscript_name�	namespaceZopen_ZscriptZnorm_script�code�r�5/usr/lib/python3.8/site-packages/setuptools/launch.py�run
s
�rr)rrr
rrrrrr�<module>s
site-packages/setuptools/script (dev).tmpl000064400000000332151446177000014572 0ustar00# EASY-INSTALL-DEV-SCRIPT: %(spec)r,%(script_name)r
__requires__ = %(spec)r
__import__('pkg_resources').require(%(spec)r)
__file__ = %(dev_path)r
with open(__file__) as f:
    exec(compile(f.read(), __file__, 'exec'))
site-packages/setuptools/lib2to3_ex.py000064400000003735151446177000014046 0ustar00"""
Customized Mixin2to3 support:

 - adds support for converting doctests


This module raises an ImportError on Python 2.
"""

from distutils.util import Mixin2to3 as _Mixin2to3
from distutils import log
from lib2to3.refactor import RefactoringTool, get_fixers_from_package

import setuptools


class DistutilsRefactoringTool(RefactoringTool):
    def log_error(self, msg, *args, **kw):
        log.error(msg, *args)

    def log_message(self, msg, *args):
        log.info(msg, *args)

    def log_debug(self, msg, *args):
        log.debug(msg, *args)


class Mixin2to3(_Mixin2to3):
    def run_2to3(self, files, doctests=False):
        # See of the distribution option has been set, otherwise check the
        # setuptools default.
        if self.distribution.use_2to3 is not True:
            return
        if not files:
            return
        log.info("Fixing " + " ".join(files))
        self.__build_fixer_names()
        self.__exclude_fixers()
        if doctests:
            if setuptools.run_2to3_on_doctests:
                r = DistutilsRefactoringTool(self.fixer_names)
                r.refactor(files, write=True, doctests_only=True)
        else:
            _Mixin2to3.run_2to3(self, files)

    def __build_fixer_names(self):
        if self.fixer_names:
            return
        self.fixer_names = []
        for p in setuptools.lib2to3_fixer_packages:
            self.fixer_names.extend(get_fixers_from_package(p))
        if self.distribution.use_2to3_fixers is not None:
            for p in self.distribution.use_2to3_fixers:
                self.fixer_names.extend(get_fixers_from_package(p))

    def __exclude_fixers(self):
        excluded_fixers = getattr(self, 'exclude_fixers', [])
        if self.distribution.use_2to3_exclude_fixers is not None:
            excluded_fixers.extend(self.distribution.use_2to3_exclude_fixers)
        for fixer_name in excluded_fixers:
            if fixer_name in self.fixer_names:
                self.fixer_names.remove(fixer_name)
site-packages/setuptools/package_index.py000064400000117235151446177000014657 0ustar00"""PyPI and direct package downloading"""
import sys
import os
import re
import shutil
import socket
import base64
import hashlib
import itertools
import warnings
from functools import wraps

from setuptools.extern import six
from setuptools.extern.six.moves import urllib, http_client, configparser, map

import setuptools
from pkg_resources import (
    CHECKOUT_DIST, Distribution, BINARY_DIST, normalize_path, SOURCE_DIST,
    Environment, find_distributions, safe_name, safe_version,
    to_filename, Requirement, DEVELOP_DIST, EGG_DIST,
)
from setuptools import ssl_support
from distutils import log
from distutils.errors import DistutilsError
from fnmatch import translate
from setuptools.py27compat import get_all_headers
from setuptools.py33compat import unescape
from setuptools.wheel import Wheel

__metaclass__ = type

EGG_FRAGMENT = re.compile(r'^egg=([-A-Za-z0-9_.+!]+)$')
HREF = re.compile(r"""href\s*=\s*['"]?([^'"> ]+)""", re.I)
PYPI_MD5 = re.compile(
    r'<a href="([^"#]+)">([^<]+)</a>\n\s+\(<a (?:title="MD5 hash"\n\s+)'
    r'href="[^?]+\?:action=show_md5&amp;digest=([0-9a-f]{32})">md5</a>\)'
)
URL_SCHEME = re.compile('([-+.a-z0-9]{2,}):', re.I).match
EXTENSIONS = ".tar.gz .tar.bz2 .tar .zip .tgz".split()

__all__ = [
    'PackageIndex', 'distros_for_url', 'parse_bdist_wininst',
    'interpret_distro_name',
]

_SOCKET_TIMEOUT = 15

_tmpl = "setuptools/{setuptools.__version__} Python-urllib/{py_major}"
user_agent = _tmpl.format(py_major='{}.{}'.format(*sys.version_info), setuptools=setuptools)


def parse_requirement_arg(spec):
    try:
        return Requirement.parse(spec)
    except ValueError:
        raise DistutilsError(
            "Not a URL, existing file, or requirement spec: %r" % (spec,)
        )


def parse_bdist_wininst(name):
    """Return (base,pyversion) or (None,None) for possible .exe name"""

    lower = name.lower()
    base, py_ver, plat = None, None, None

    if lower.endswith('.exe'):
        if lower.endswith('.win32.exe'):
            base = name[:-10]
            plat = 'win32'
        elif lower.startswith('.win32-py', -16):
            py_ver = name[-7:-4]
            base = name[:-16]
            plat = 'win32'
        elif lower.endswith('.win-amd64.exe'):
            base = name[:-14]
            plat = 'win-amd64'
        elif lower.startswith('.win-amd64-py', -20):
            py_ver = name[-7:-4]
            base = name[:-20]
            plat = 'win-amd64'
    return base, py_ver, plat


def egg_info_for_url(url):
    parts = urllib.parse.urlparse(url)
    scheme, server, path, parameters, query, fragment = parts
    base = urllib.parse.unquote(path.split('/')[-1])
    if server == 'sourceforge.net' and base == 'download':  # XXX Yuck
        base = urllib.parse.unquote(path.split('/')[-2])
    if '#' in base:
        base, fragment = base.split('#', 1)
    return base, fragment


def distros_for_url(url, metadata=None):
    """Yield egg or source distribution objects that might be found at a URL"""
    base, fragment = egg_info_for_url(url)
    for dist in distros_for_location(url, base, metadata):
        yield dist
    if fragment:
        match = EGG_FRAGMENT.match(fragment)
        if match:
            for dist in interpret_distro_name(
                url, match.group(1), metadata, precedence=CHECKOUT_DIST
            ):
                yield dist


def distros_for_location(location, basename, metadata=None):
    """Yield egg or source distribution objects based on basename"""
    if basename.endswith('.egg.zip'):
        basename = basename[:-4]  # strip the .zip
    if basename.endswith('.egg') and '-' in basename:
        # only one, unambiguous interpretation
        return [Distribution.from_location(location, basename, metadata)]
    if basename.endswith('.whl') and '-' in basename:
        wheel = Wheel(basename)
        if not wheel.is_compatible():
            return []
        return [Distribution(
            location=location,
            project_name=wheel.project_name,
            version=wheel.version,
            # Increase priority over eggs.
            precedence=EGG_DIST + 1,
        )]
    if basename.endswith('.exe'):
        win_base, py_ver, platform = parse_bdist_wininst(basename)
        if win_base is not None:
            return interpret_distro_name(
                location, win_base, metadata, py_ver, BINARY_DIST, platform
            )
    # Try source distro extensions (.zip, .tgz, etc.)
    #
    for ext in EXTENSIONS:
        if basename.endswith(ext):
            basename = basename[:-len(ext)]
            return interpret_distro_name(location, basename, metadata)
    return []  # no extension matched


def distros_for_filename(filename, metadata=None):
    """Yield possible egg or source distribution objects based on a filename"""
    return distros_for_location(
        normalize_path(filename), os.path.basename(filename), metadata
    )


def interpret_distro_name(
        location, basename, metadata, py_version=None, precedence=SOURCE_DIST,
        platform=None
):
    """Generate alternative interpretations of a source distro name

    Note: if `location` is a filesystem filename, you should call
    ``pkg_resources.normalize_path()`` on it before passing it to this
    routine!
    """
    # Generate alternative interpretations of a source distro name
    # Because some packages are ambiguous as to name/versions split
    # e.g. "adns-python-1.1.0", "egenix-mx-commercial", etc.
    # So, we generate each possible interepretation (e.g. "adns, python-1.1.0"
    # "adns-python, 1.1.0", and "adns-python-1.1.0, no version").  In practice,
    # the spurious interpretations should be ignored, because in the event
    # there's also an "adns" package, the spurious "python-1.1.0" version will
    # compare lower than any numeric version number, and is therefore unlikely
    # to match a request for it.  It's still a potential problem, though, and
    # in the long run PyPI and the distutils should go for "safe" names and
    # versions in distribution archive names (sdist and bdist).

    parts = basename.split('-')
    if not py_version and any(re.match(r'py\d\.\d$', p) for p in parts[2:]):
        # it is a bdist_dumb, not an sdist -- bail out
        return

    for p in range(1, len(parts) + 1):
        yield Distribution(
            location, metadata, '-'.join(parts[:p]), '-'.join(parts[p:]),
            py_version=py_version, precedence=precedence,
            platform=platform
        )


# From Python 2.7 docs
def unique_everseen(iterable, key=None):
    "List unique elements, preserving order. Remember all elements ever seen."
    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
    # unique_everseen('ABBCcAD', str.lower) --> A B C D
    seen = set()
    seen_add = seen.add
    if key is None:
        for element in six.moves.filterfalse(seen.__contains__, iterable):
            seen_add(element)
            yield element
    else:
        for element in iterable:
            k = key(element)
            if k not in seen:
                seen_add(k)
                yield element


def unique_values(func):
    """
    Wrap a function returning an iterable such that the resulting iterable
    only ever yields unique items.
    """

    @wraps(func)
    def wrapper(*args, **kwargs):
        return unique_everseen(func(*args, **kwargs))

    return wrapper


REL = re.compile(r"""<([^>]*\srel\s*=\s*['"]?([^'">]+)[^>]*)>""", re.I)
# this line is here to fix emacs' cruddy broken syntax highlighting


@unique_values
def find_external_links(url, page):
    """Find rel="homepage" and rel="download" links in `page`, yielding URLs"""

    for match in REL.finditer(page):
        tag, rel = match.groups()
        rels = set(map(str.strip, rel.lower().split(',')))
        if 'homepage' in rels or 'download' in rels:
            for match in HREF.finditer(tag):
                yield urllib.parse.urljoin(url, htmldecode(match.group(1)))

    for tag in ("<th>Home Page", "<th>Download URL"):
        pos = page.find(tag)
        if pos != -1:
            match = HREF.search(page, pos)
            if match:
                yield urllib.parse.urljoin(url, htmldecode(match.group(1)))


class ContentChecker:
    """
    A null content checker that defines the interface for checking content
    """

    def feed(self, block):
        """
        Feed a block of data to the hash.
        """
        return

    def is_valid(self):
        """
        Check the hash. Return False if validation fails.
        """
        return True

    def report(self, reporter, template):
        """
        Call reporter with information about the checker (hash name)
        substituted into the template.
        """
        return


class HashChecker(ContentChecker):
    pattern = re.compile(
        r'(?P<hash_name>sha1|sha224|sha384|sha256|sha512|md5)='
        r'(?P<expected>[a-f0-9]+)'
    )

    def __init__(self, hash_name, expected):
        self.hash_name = hash_name
        self.hash = hashlib.new(hash_name)
        self.expected = expected

    @classmethod
    def from_url(cls, url):
        "Construct a (possibly null) ContentChecker from a URL"
        fragment = urllib.parse.urlparse(url)[-1]
        if not fragment:
            return ContentChecker()
        match = cls.pattern.search(fragment)
        if not match:
            return ContentChecker()
        return cls(**match.groupdict())

    def feed(self, block):
        self.hash.update(block)

    def is_valid(self):
        return self.hash.hexdigest() == self.expected

    def report(self, reporter, template):
        msg = template % self.hash_name
        return reporter(msg)


class PackageIndex(Environment):
    """A distribution index that scans web pages for download URLs"""

    def __init__(
            self, index_url="https://pypi.org/simple/", hosts=('*',),
            ca_bundle=None, verify_ssl=True, *args, **kw
    ):
        Environment.__init__(self, *args, **kw)
        self.index_url = index_url + "/" [:not index_url.endswith('/')]
        self.scanned_urls = {}
        self.fetched_urls = {}
        self.package_pages = {}
        self.allows = re.compile('|'.join(map(translate, hosts))).match
        self.to_scan = []
        use_ssl = (
            verify_ssl
            and ssl_support.is_available
            and (ca_bundle or ssl_support.find_ca_bundle())
        )
        if use_ssl:
            self.opener = ssl_support.opener_for(ca_bundle)
        else:
            self.opener = urllib.request.urlopen

    def process_url(self, url, retrieve=False):
        """Evaluate a URL as a possible download, and maybe retrieve it"""
        if url in self.scanned_urls and not retrieve:
            return
        self.scanned_urls[url] = True
        if not URL_SCHEME(url):
            self.process_filename(url)
            return
        else:
            dists = list(distros_for_url(url))
            if dists:
                if not self.url_ok(url):
                    return
                self.debug("Found link: %s", url)

        if dists or not retrieve or url in self.fetched_urls:
            list(map(self.add, dists))
            return  # don't need the actual page

        if not self.url_ok(url):
            self.fetched_urls[url] = True
            return

        self.info("Reading %s", url)
        self.fetched_urls[url] = True  # prevent multiple fetch attempts
        tmpl = "Download error on %s: %%s -- Some packages may not be found!"
        f = self.open_url(url, tmpl % url)
        if f is None:
            return
        self.fetched_urls[f.url] = True
        if 'html' not in f.headers.get('content-type', '').lower():
            f.close()  # not html, we can't process it
            return

        base = f.url  # handle redirects
        page = f.read()
        if not isinstance(page, str):
            # In Python 3 and got bytes but want str.
            if isinstance(f, urllib.error.HTTPError):
                # Errors have no charset, assume latin1:
                charset = 'latin-1'
            else:
                charset = f.headers.get_param('charset') or 'latin-1'
            page = page.decode(charset, "ignore")
        f.close()
        for match in HREF.finditer(page):
            link = urllib.parse.urljoin(base, htmldecode(match.group(1)))
            self.process_url(link)
        if url.startswith(self.index_url) and getattr(f, 'code', None) != 404:
            page = self.process_index(url, page)

    def process_filename(self, fn, nested=False):
        # process filenames or directories
        if not os.path.exists(fn):
            self.warn("Not found: %s", fn)
            return

        if os.path.isdir(fn) and not nested:
            path = os.path.realpath(fn)
            for item in os.listdir(path):
                self.process_filename(os.path.join(path, item), True)

        dists = distros_for_filename(fn)
        if dists:
            self.debug("Found: %s", fn)
            list(map(self.add, dists))

    def url_ok(self, url, fatal=False):
        s = URL_SCHEME(url)
        is_file = s and s.group(1).lower() == 'file'
        if is_file or self.allows(urllib.parse.urlparse(url)[1]):
            return True
        msg = (
            "\nNote: Bypassing %s (disallowed host; see "
            "http://bit.ly/2hrImnY for details).\n")
        if fatal:
            raise DistutilsError(msg % url)
        else:
            self.warn(msg, url)

    def scan_egg_links(self, search_path):
        dirs = filter(os.path.isdir, search_path)
        egg_links = (
            (path, entry)
            for path in dirs
            for entry in os.listdir(path)
            if entry.endswith('.egg-link')
        )
        list(itertools.starmap(self.scan_egg_link, egg_links))

    def scan_egg_link(self, path, entry):
        with open(os.path.join(path, entry)) as raw_lines:
            # filter non-empty lines
            lines = list(filter(None, map(str.strip, raw_lines)))

        if len(lines) != 2:
            # format is not recognized; punt
            return

        egg_path, setup_path = lines

        for dist in find_distributions(os.path.join(path, egg_path)):
            dist.location = os.path.join(path, *lines)
            dist.precedence = SOURCE_DIST
            self.add(dist)

    def process_index(self, url, page):
        """Process the contents of a PyPI page"""

        def scan(link):
            # Process a URL to see if it's for a package page
            if link.startswith(self.index_url):
                parts = list(map(
                    urllib.parse.unquote, link[len(self.index_url):].split('/')
                ))
                if len(parts) == 2 and '#' not in parts[1]:
                    # it's a package page, sanitize and index it
                    pkg = safe_name(parts[0])
                    ver = safe_version(parts[1])
                    self.package_pages.setdefault(pkg.lower(), {})[link] = True
                    return to_filename(pkg), to_filename(ver)
            return None, None

        # process an index page into the package-page index
        for match in HREF.finditer(page):
            try:
                scan(urllib.parse.urljoin(url, htmldecode(match.group(1))))
            except ValueError:
                pass

        pkg, ver = scan(url)  # ensure this page is in the page index
        if pkg:
            # process individual package page
            for new_url in find_external_links(url, page):
                # Process the found URL
                base, frag = egg_info_for_url(new_url)
                if base.endswith('.py') and not frag:
                    if ver:
                        new_url += '#egg=%s-%s' % (pkg, ver)
                    else:
                        self.need_version_info(url)
                self.scan_url(new_url)

            return PYPI_MD5.sub(
                lambda m: '<a href="%s#md5=%s">%s</a>' % m.group(1, 3, 2), page
            )
        else:
            return ""  # no sense double-scanning non-package pages

    def need_version_info(self, url):
        self.scan_all(
            "Page at %s links to .py file(s) without version info; an index "
            "scan is required.", url
        )

    def scan_all(self, msg=None, *args):
        if self.index_url not in self.fetched_urls:
            if msg:
                self.warn(msg, *args)
            self.info(
                "Scanning index of all packages (this may take a while)"
            )
        self.scan_url(self.index_url)

    def find_packages(self, requirement):
        self.scan_url(self.index_url + requirement.unsafe_name + '/')

        if not self.package_pages.get(requirement.key):
            # Fall back to safe version of the name
            self.scan_url(self.index_url + requirement.project_name + '/')

        if not self.package_pages.get(requirement.key):
            # We couldn't find the target package, so search the index page too
            self.not_found_in_index(requirement)

        for url in list(self.package_pages.get(requirement.key, ())):
            # scan each page that might be related to the desired package
            self.scan_url(url)

    def obtain(self, requirement, installer=None):
        self.prescan()
        self.find_packages(requirement)
        for dist in self[requirement.key]:
            if dist in requirement:
                return dist
            self.debug("%s does not match %s", requirement, dist)
        return super(PackageIndex, self).obtain(requirement, installer)

    def check_hash(self, checker, filename, tfp):
        """
        checker is a ContentChecker
        """
        checker.report(
            self.debug,
            "Validating %%s checksum for %s" % filename)
        if not checker.is_valid():
            tfp.close()
            os.unlink(filename)
            raise DistutilsError(
                "%s validation failed for %s; "
                "possible download problem?"
                % (checker.hash.name, os.path.basename(filename))
            )

    def add_find_links(self, urls):
        """Add `urls` to the list that will be prescanned for searches"""
        for url in urls:
            if (
                self.to_scan is None  # if we have already "gone online"
                or not URL_SCHEME(url)  # or it's a local file/directory
                or url.startswith('file:')
                or list(distros_for_url(url))  # or a direct package link
            ):
                # then go ahead and process it now
                self.scan_url(url)
            else:
                # otherwise, defer retrieval till later
                self.to_scan.append(url)

    def prescan(self):
        """Scan urls scheduled for prescanning (e.g. --find-links)"""
        if self.to_scan:
            list(map(self.scan_url, self.to_scan))
        self.to_scan = None  # from now on, go ahead and process immediately

    def not_found_in_index(self, requirement):
        if self[requirement.key]:  # we've seen at least one distro
            meth, msg = self.info, "Couldn't retrieve index page for %r"
        else:  # no distros seen for this name, might be misspelled
            meth, msg = (
                self.warn,
                "Couldn't find index page for %r (maybe misspelled?)")
        meth(msg, requirement.unsafe_name)
        self.scan_all()

    def download(self, spec, tmpdir):
        """Locate and/or download `spec` to `tmpdir`, returning a local path

        `spec` may be a ``Requirement`` object, or a string containing a URL,
        an existing local filename, or a project/version requirement spec
        (i.e. the string form of a ``Requirement`` object).  If it is the URL
        of a .py file with an unambiguous ``#egg=name-version`` tag (i.e., one
        that escapes ``-`` as ``_`` throughout), a trivial ``setup.py`` is
        automatically created alongside the downloaded file.

        If `spec` is a ``Requirement`` object or a string containing a
        project/version requirement spec, this method returns the location of
        a matching distribution (possibly after downloading it to `tmpdir`).
        If `spec` is a locally existing file or directory name, it is simply
        returned unchanged.  If `spec` is a URL, it is downloaded to a subpath
        of `tmpdir`, and the local filename is returned.  Various errors may be
        raised if a problem occurs during downloading.
        """
        if not isinstance(spec, Requirement):
            scheme = URL_SCHEME(spec)
            if scheme:
                # It's a url, download it to tmpdir
                found = self._download_url(scheme.group(1), spec, tmpdir)
                base, fragment = egg_info_for_url(spec)
                if base.endswith('.py'):
                    found = self.gen_setup(found, fragment, tmpdir)
                return found
            elif os.path.exists(spec):
                # Existing file or directory, just return it
                return spec
            else:
                spec = parse_requirement_arg(spec)
        return getattr(self.fetch_distribution(spec, tmpdir), 'location', None)

    def fetch_distribution(
            self, requirement, tmpdir, force_scan=False, source=False,
            develop_ok=False, local_index=None):
        """Obtain a distribution suitable for fulfilling `requirement`

        `requirement` must be a ``pkg_resources.Requirement`` instance.
        If necessary, or if the `force_scan` flag is set, the requirement is
        searched for in the (online) package index as well as the locally
        installed packages.  If a distribution matching `requirement` is found,
        the returned distribution's ``location`` is the value you would have
        gotten from calling the ``download()`` method with the matching
        distribution's URL or filename.  If no matching distribution is found,
        ``None`` is returned.

        If the `source` flag is set, only source distributions and source
        checkout links will be considered.  Unless the `develop_ok` flag is
        set, development and system eggs (i.e., those using the ``.egg-info``
        format) will be ignored.
        """
        # process a Requirement
        self.info("Searching for %s", requirement)
        skipped = {}
        dist = None

        def find(req, env=None):
            if env is None:
                env = self
            # Find a matching distribution; may be called more than once

            for dist in env[req.key]:

                if dist.precedence == DEVELOP_DIST and not develop_ok:
                    if dist not in skipped:
                        self.warn(
                            "Skipping development or system egg: %s", dist,
                        )
                        skipped[dist] = 1
                    continue

                test = (
                    dist in req
                    and (dist.precedence <= SOURCE_DIST or not source)
                )
                if test:
                    loc = self.download(dist.location, tmpdir)
                    dist.download_location = loc
                    if os.path.exists(dist.download_location):
                        return dist

        if force_scan:
            self.prescan()
            self.find_packages(requirement)
            dist = find(requirement)

        if not dist and local_index is not None:
            dist = find(requirement, local_index)

        if dist is None:
            if self.to_scan is not None:
                self.prescan()
            dist = find(requirement)

        if dist is None and not force_scan:
            self.find_packages(requirement)
            dist = find(requirement)

        if dist is None:
            self.warn(
                "No local packages or working download links found for %s%s",
                (source and "a source distribution of " or ""),
                requirement,
            )
        else:
            self.info("Best match: %s", dist)
            return dist.clone(location=dist.download_location)

    def fetch(self, requirement, tmpdir, force_scan=False, source=False):
        """Obtain a file suitable for fulfilling `requirement`

        DEPRECATED; use the ``fetch_distribution()`` method now instead.  For
        backward compatibility, this routine is identical but returns the
        ``location`` of the downloaded distribution instead of a distribution
        object.
        """
        dist = self.fetch_distribution(requirement, tmpdir, force_scan, source)
        if dist is not None:
            return dist.location
        return None

    def gen_setup(self, filename, fragment, tmpdir):
        match = EGG_FRAGMENT.match(fragment)
        dists = match and [
            d for d in
            interpret_distro_name(filename, match.group(1), None) if d.version
        ] or []

        if len(dists) == 1:  # unambiguous ``#egg`` fragment
            basename = os.path.basename(filename)

            # Make sure the file has been downloaded to the temp dir.
            if os.path.dirname(filename) != tmpdir:
                dst = os.path.join(tmpdir, basename)
                from setuptools.command.easy_install import samefile
                if not samefile(filename, dst):
                    shutil.copy2(filename, dst)
                    filename = dst

            with open(os.path.join(tmpdir, 'setup.py'), 'w') as file:
                file.write(
                    "from setuptools import setup\n"
                    "setup(name=%r, version=%r, py_modules=[%r])\n"
                    % (
                        dists[0].project_name, dists[0].version,
                        os.path.splitext(basename)[0]
                    )
                )
            return filename

        elif match:
            raise DistutilsError(
                "Can't unambiguously interpret project/version identifier %r; "
                "any dashes in the name or version should be escaped using "
                "underscores. %r" % (fragment, dists)
            )
        else:
            raise DistutilsError(
                "Can't process plain .py files without an '#egg=name-version'"
                " suffix to enable automatic setup script generation."
            )

    dl_blocksize = 8192

    def _download_to(self, url, filename):
        self.info("Downloading %s", url)
        # Download the file
        fp = None
        try:
            checker = HashChecker.from_url(url)
            fp = self.open_url(url)
            if isinstance(fp, urllib.error.HTTPError):
                raise DistutilsError(
                    "Can't download %s: %s %s" % (url, fp.code, fp.msg)
                )
            headers = fp.info()
            blocknum = 0
            bs = self.dl_blocksize
            size = -1
            if "content-length" in headers:
                # Some servers return multiple Content-Length headers :(
                sizes = get_all_headers(headers, 'Content-Length')
                size = max(map(int, sizes))
                self.reporthook(url, filename, blocknum, bs, size)
            with open(filename, 'wb') as tfp:
                while True:
                    block = fp.read(bs)
                    if block:
                        checker.feed(block)
                        tfp.write(block)
                        blocknum += 1
                        self.reporthook(url, filename, blocknum, bs, size)
                    else:
                        break
                self.check_hash(checker, filename, tfp)
            return headers
        finally:
            if fp:
                fp.close()

    def reporthook(self, url, filename, blocknum, blksize, size):
        pass  # no-op

    def open_url(self, url, warning=None):
        if url.startswith('file:'):
            return local_open(url)
        try:
            return open_with_auth(url, self.opener)
        except (ValueError, http_client.InvalidURL) as v:
            msg = ' '.join([str(arg) for arg in v.args])
            if warning:
                self.warn(warning, msg)
            else:
                raise DistutilsError('%s %s' % (url, msg))
        except urllib.error.HTTPError as v:
            return v
        except urllib.error.URLError as v:
            if warning:
                self.warn(warning, v.reason)
            else:
                raise DistutilsError("Download error for %s: %s"
                                     % (url, v.reason))
        except http_client.BadStatusLine as v:
            if warning:
                self.warn(warning, v.line)
            else:
                raise DistutilsError(
                    '%s returned a bad status line. The server might be '
                    'down, %s' %
                    (url, v.line)
                )
        except (http_client.HTTPException, socket.error) as v:
            if warning:
                self.warn(warning, v)
            else:
                raise DistutilsError("Download error for %s: %s"
                                     % (url, v))

    def _download_url(self, scheme, url, tmpdir):
        # Determine download filename
        #
        name, fragment = egg_info_for_url(url)
        if name:
            while '..' in name:
                name = name.replace('..', '.').replace('\\', '_')
        else:
            name = "__downloaded__"  # default if URL has no path contents

        if name.endswith('.egg.zip'):
            name = name[:-4]  # strip the extra .zip before download

        filename = os.path.join(tmpdir, name)

        # Download the file
        #
        if scheme == 'svn' or scheme.startswith('svn+'):
            return self._download_svn(url, filename)
        elif scheme == 'git' or scheme.startswith('git+'):
            return self._download_git(url, filename)
        elif scheme.startswith('hg+'):
            return self._download_hg(url, filename)
        elif scheme == 'file':
            return urllib.request.url2pathname(urllib.parse.urlparse(url)[2])
        else:
            self.url_ok(url, True)  # raises error if not allowed
            return self._attempt_download(url, filename)

    def scan_url(self, url):
        self.process_url(url, True)

    def _attempt_download(self, url, filename):
        headers = self._download_to(url, filename)
        if 'html' in headers.get('content-type', '').lower():
            return self._download_html(url, headers, filename)
        else:
            return filename

    def _download_html(self, url, headers, filename):
        file = open(filename)
        for line in file:
            if line.strip():
                # Check for a subversion index page
                if re.search(r'<title>([^- ]+ - )?Revision \d+:', line):
                    # it's a subversion index page:
                    file.close()
                    os.unlink(filename)
                    return self._download_svn(url, filename)
                break  # not an index page
        file.close()
        os.unlink(filename)
        raise DistutilsError("Unexpected HTML page found at " + url)

    def _download_svn(self, url, filename):
        warnings.warn("SVN download support is deprecated", UserWarning)
        url = url.split('#', 1)[0]  # remove any fragment for svn's sake
        creds = ''
        if url.lower().startswith('svn:') and '@' in url:
            scheme, netloc, path, p, q, f = urllib.parse.urlparse(url)
            if not netloc and path.startswith('//') and '/' in path[2:]:
                netloc, path = path[2:].split('/', 1)
                auth, host = _splituser(netloc)
                if auth:
                    if ':' in auth:
                        user, pw = auth.split(':', 1)
                        creds = " --username=%s --password=%s" % (user, pw)
                    else:
                        creds = " --username=" + auth
                    netloc = host
                    parts = scheme, netloc, url, p, q, f
                    url = urllib.parse.urlunparse(parts)
        self.info("Doing subversion checkout from %s to %s", url, filename)
        os.system("svn checkout%s -q %s %s" % (creds, url, filename))
        return filename

    @staticmethod
    def _vcs_split_rev_from_url(url, pop_prefix=False):
        scheme, netloc, path, query, frag = urllib.parse.urlsplit(url)

        scheme = scheme.split('+', 1)[-1]

        # Some fragment identification fails
        path = path.split('#', 1)[0]

        rev = None
        if '@' in path:
            path, rev = path.rsplit('@', 1)

        # Also, discard fragment
        url = urllib.parse.urlunsplit((scheme, netloc, path, query, ''))

        return url, rev

    def _download_git(self, url, filename):
        filename = filename.split('#', 1)[0]
        url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True)

        self.info("Doing git clone from %s to %s", url, filename)
        os.system("git clone --quiet %s %s" % (url, filename))

        if rev is not None:
            self.info("Checking out %s", rev)
            os.system("git -C %s checkout --quiet %s" % (
                filename,
                rev,
            ))

        return filename

    def _download_hg(self, url, filename):
        filename = filename.split('#', 1)[0]
        url, rev = self._vcs_split_rev_from_url(url, pop_prefix=True)

        self.info("Doing hg clone from %s to %s", url, filename)
        os.system("hg clone --quiet %s %s" % (url, filename))

        if rev is not None:
            self.info("Updating to %s", rev)
            os.system("hg --cwd %s up -C -r %s -q" % (
                filename,
                rev,
            ))

        return filename

    def debug(self, msg, *args):
        log.debug(msg, *args)

    def info(self, msg, *args):
        log.info(msg, *args)

    def warn(self, msg, *args):
        log.warn(msg, *args)


# This pattern matches a character entity reference (a decimal numeric
# references, a hexadecimal numeric reference, or a named reference).
entity_sub = re.compile(r'&(#(\d+|x[\da-fA-F]+)|[\w.:-]+);?').sub


def decode_entity(match):
    what = match.group(0)
    return unescape(what)


def htmldecode(text):
    """
    Decode HTML entities in the given text.

    >>> htmldecode(
    ...     'https://../package_name-0.1.2.tar.gz'
    ...     '?tokena=A&amp;tokenb=B">package_name-0.1.2.tar.gz')
    'https://../package_name-0.1.2.tar.gz?tokena=A&tokenb=B">package_name-0.1.2.tar.gz'
    """
    return entity_sub(decode_entity, text)


def socket_timeout(timeout=15):
    def _socket_timeout(func):
        def _socket_timeout(*args, **kwargs):
            old_timeout = socket.getdefaulttimeout()
            socket.setdefaulttimeout(timeout)
            try:
                return func(*args, **kwargs)
            finally:
                socket.setdefaulttimeout(old_timeout)

        return _socket_timeout

    return _socket_timeout


def _encode_auth(auth):
    """
    A function compatible with Python 2.3-3.3 that will encode
    auth from a URL suitable for an HTTP header.
    >>> str(_encode_auth('username%3Apassword'))
    'dXNlcm5hbWU6cGFzc3dvcmQ='

    Long auth strings should not cause a newline to be inserted.
    >>> long_auth = 'username:' + 'password'*10
    >>> chr(10) in str(_encode_auth(long_auth))
    False
    """
    auth_s = urllib.parse.unquote(auth)
    # convert to bytes
    auth_bytes = auth_s.encode()
    encoded_bytes = base64.b64encode(auth_bytes)
    # convert back to a string
    encoded = encoded_bytes.decode()
    # strip the trailing carriage return
    return encoded.replace('\n', '')


class Credential:
    """
    A username/password pair. Use like a namedtuple.
    """

    def __init__(self, username, password):
        self.username = username
        self.password = password

    def __iter__(self):
        yield self.username
        yield self.password

    def __str__(self):
        return '%(username)s:%(password)s' % vars(self)


class PyPIConfig(configparser.RawConfigParser):
    def __init__(self):
        """
        Load from ~/.pypirc
        """
        defaults = dict.fromkeys(['username', 'password', 'repository'], '')
        configparser.RawConfigParser.__init__(self, defaults)

        rc = os.path.join(os.path.expanduser('~'), '.pypirc')
        if os.path.exists(rc):
            self.read(rc)

    @property
    def creds_by_repository(self):
        sections_with_repositories = [
            section for section in self.sections()
            if self.get(section, 'repository').strip()
        ]

        return dict(map(self._get_repo_cred, sections_with_repositories))

    def _get_repo_cred(self, section):
        repo = self.get(section, 'repository').strip()
        return repo, Credential(
            self.get(section, 'username').strip(),
            self.get(section, 'password').strip(),
        )

    def find_credential(self, url):
        """
        If the URL indicated appears to be a repository defined in this
        config, return the credential for that repository.
        """
        for repository, cred in self.creds_by_repository.items():
            if url.startswith(repository):
                return cred


def open_with_auth(url, opener=urllib.request.urlopen):
    """Open a urllib2 request, handling HTTP authentication"""

    parsed = urllib.parse.urlparse(url)
    scheme, netloc, path, params, query, frag = parsed

    # Double scheme does not raise on Mac OS X as revealed by a
    # failing test. We would expect "nonnumeric port". Refs #20.
    if netloc.endswith(':'):
        raise http_client.InvalidURL("nonnumeric port: ''")

    if scheme in ('http', 'https'):
        auth, address = _splituser(netloc)
    else:
        auth = None

    if not auth:
        cred = PyPIConfig().find_credential(url)
        if cred:
            auth = str(cred)
            info = cred.username, url
            log.info('Authenticating as %s for %s (from .pypirc)', *info)

    if auth:
        auth = "Basic " + _encode_auth(auth)
        parts = scheme, address, path, params, query, frag
        new_url = urllib.parse.urlunparse(parts)
        request = urllib.request.Request(new_url)
        request.add_header("Authorization", auth)
    else:
        request = urllib.request.Request(url)

    request.add_header('User-Agent', user_agent)
    fp = opener(request)

    if auth:
        # Put authentication info back into request URL if same host,
        # so that links found on the page will work
        s2, h2, path2, param2, query2, frag2 = urllib.parse.urlparse(fp.url)
        if s2 == scheme and h2 == address:
            parts = s2, netloc, path2, param2, query2, frag2
            fp.url = urllib.parse.urlunparse(parts)

    return fp


# copy of urllib.parse._splituser from Python 3.8
def _splituser(host):
    """splituser('user[:passwd]@host[:port]') --> 'user[:passwd]', 'host[:port]'."""
    user, delim, host = host.rpartition('@')
    return (user if delim else None), host


# adding a timeout to avoid freezing package_index
open_with_auth = socket_timeout(_SOCKET_TIMEOUT)(open_with_auth)


def fix_sf_url(url):
    return url  # backward compatibility


def local_open(url):
    """Read a local path, with special support for directories"""
    scheme, server, path, param, query, frag = urllib.parse.urlparse(url)
    filename = urllib.request.url2pathname(path)
    if os.path.isfile(filename):
        return urllib.request.urlopen(url)
    elif path.endswith('/') and os.path.isdir(filename):
        files = []
        for f in os.listdir(filename):
            filepath = os.path.join(filename, f)
            if f == 'index.html':
                with open(filepath, 'r') as fp:
                    body = fp.read()
                break
            elif os.path.isdir(filepath):
                f += '/'
            files.append('<a href="{name}">{name}</a>'.format(name=f))
        else:
            tmpl = (
                "<html><head><title>{url}</title>"
                "</head><body>{files}</body></html>")
            body = tmpl.format(url=url, files='\n'.join(files))
        status, message = 200, "OK"
    else:
        status, message, body = 404, "Path not found", "Not found"

    headers = {'content-type': 'text/html'}
    body_stream = six.StringIO(body)
    return urllib.error.HTTPError(url, status, message, headers, body_stream)
site-packages/setuptools/__init__.py000064400000016163151446177000013632 0ustar00"""Extensions to the 'distutils' for large or complex distributions"""

import os
import sys
import functools
import distutils.core
import distutils.filelist
import re
from distutils.errors import DistutilsOptionError
from distutils.util import convert_path
from fnmatch import fnmatchcase

from ._deprecation_warning import SetuptoolsDeprecationWarning

from setuptools.extern.six import PY3, string_types
from setuptools.extern.six.moves import filter, map

import setuptools.version
from setuptools.extension import Extension
from setuptools.dist import Distribution, Feature
from setuptools.depends import Require
from . import monkey

__metaclass__ = type


__all__ = [
    'setup', 'Distribution', 'Feature', 'Command', 'Extension', 'Require',
    'SetuptoolsDeprecationWarning',
    'find_packages'
]

if PY3:
  __all__.append('find_namespace_packages')

__version__ = setuptools.version.__version__

bootstrap_install_from = None

# If we run 2to3 on .py files, should we also convert docstrings?
# Default: yes; assume that we can detect doctests reliably
run_2to3_on_doctests = True
# Standard package names for fixer packages
lib2to3_fixer_packages = ['lib2to3.fixes']


class PackageFinder:
    """
    Generate a list of all Python packages found within a directory
    """

    @classmethod
    def find(cls, where='.', exclude=(), include=('*',)):
        """Return a list all Python packages found within directory 'where'

        'where' is the root directory which will be searched for packages.  It
        should be supplied as a "cross-platform" (i.e. URL-style) path; it will
        be converted to the appropriate local path syntax.

        'exclude' is a sequence of package names to exclude; '*' can be used
        as a wildcard in the names, such that 'foo.*' will exclude all
        subpackages of 'foo' (but not 'foo' itself).

        'include' is a sequence of package names to include.  If it's
        specified, only the named packages will be included.  If it's not
        specified, all found packages will be included.  'include' can contain
        shell style wildcard patterns just like 'exclude'.
        """

        return list(cls._find_packages_iter(
            convert_path(where),
            cls._build_filter('ez_setup', '*__pycache__', *exclude),
            cls._build_filter(*include)))

    @classmethod
    def _find_packages_iter(cls, where, exclude, include):
        """
        All the packages found in 'where' that pass the 'include' filter, but
        not the 'exclude' filter.
        """
        for root, dirs, files in os.walk(where, followlinks=True):
            # Copy dirs to iterate over it, then empty dirs.
            all_dirs = dirs[:]
            dirs[:] = []

            for dir in all_dirs:
                full_path = os.path.join(root, dir)
                rel_path = os.path.relpath(full_path, where)
                package = rel_path.replace(os.path.sep, '.')

                # Skip directory trees that are not valid packages
                if ('.' in dir or not cls._looks_like_package(full_path)):
                    continue

                # Should this package be included?
                if include(package) and not exclude(package):
                    yield package

                # Keep searching subdirectories, as there may be more packages
                # down there, even if the parent was excluded.
                dirs.append(dir)

    @staticmethod
    def _looks_like_package(path):
        """Does a directory look like a package?"""
        return os.path.isfile(os.path.join(path, '__init__.py'))

    @staticmethod
    def _build_filter(*patterns):
        """
        Given a list of patterns, return a callable that will be true only if
        the input matches at least one of the patterns.
        """
        return lambda name: any(fnmatchcase(name, pat=pat) for pat in patterns)


class PEP420PackageFinder(PackageFinder):
    @staticmethod
    def _looks_like_package(path):
        return True


find_packages = PackageFinder.find

if PY3:
  find_namespace_packages = PEP420PackageFinder.find


def _install_setup_requires(attrs):
    # Note: do not use `setuptools.Distribution` directly, as
    # our PEP 517 backend patch `distutils.core.Distribution`.
    dist = distutils.core.Distribution(dict(
        (k, v) for k, v in attrs.items()
        if k in ('dependency_links', 'setup_requires')
    ))
    # Honor setup.cfg's options.
    dist.parse_config_files(ignore_option_errors=True)
    if dist.setup_requires:
        dist.fetch_build_eggs(dist.setup_requires)


def setup(**attrs):
    # Make sure we have any requirements needed to interpret 'attrs'.
    _install_setup_requires(attrs)
    return distutils.core.setup(**attrs)

setup.__doc__ = distutils.core.setup.__doc__


_Command = monkey.get_unpatched(distutils.core.Command)


class Command(_Command):
    __doc__ = _Command.__doc__

    command_consumes_arguments = False

    def __init__(self, dist, **kw):
        """
        Construct the command for dist, updating
        vars(self) with any keyword parameters.
        """
        _Command.__init__(self, dist)
        vars(self).update(kw)

    def _ensure_stringlike(self, option, what, default=None):
        val = getattr(self, option)
        if val is None:
            setattr(self, option, default)
            return default
        elif not isinstance(val, string_types):
            raise DistutilsOptionError("'%s' must be a %s (got `%s`)"
                                       % (option, what, val))
        return val

    def ensure_string_list(self, option):
        r"""Ensure that 'option' is a list of strings.  If 'option' is
        currently a string, we split it either on /,\s*/ or /\s+/, so
        "foo bar baz", "foo,bar,baz", and "foo,   bar baz" all become
        ["foo", "bar", "baz"].
        """
        val = getattr(self, option)
        if val is None:
            return
        elif isinstance(val, string_types):
            setattr(self, option, re.split(r',\s*|\s+', val))
        else:
            if isinstance(val, list):
                ok = all(isinstance(v, string_types) for v in val)
            else:
                ok = False
            if not ok:
                raise DistutilsOptionError(
                      "'%s' must be a list of strings (got %r)"
                      % (option, val))

    def reinitialize_command(self, command, reinit_subcommands=0, **kw):
        cmd = _Command.reinitialize_command(self, command, reinit_subcommands)
        vars(cmd).update(kw)
        return cmd


def _find_all_simple(path):
    """
    Find all files under 'path'
    """
    results = (
        os.path.join(base, file)
        for base, dirs, files in os.walk(path, followlinks=True)
        for file in files
    )
    return filter(os.path.isfile, results)


def findall(dir=os.curdir):
    """
    Find all files under 'dir' and return the list of full filenames.
    Unless dir is '.', return full filenames with dir prepended.
    """
    files = _find_all_simple(dir)
    if dir == os.curdir:
        make_rel = functools.partial(os.path.relpath, start=dir)
        files = map(make_rel, files)
    return list(files)


# Apply monkey patches
monkey.patch_all()
site-packages/setuptools/dist.py000064400000142205151446177000013033 0ustar00# -*- coding: utf-8 -*-
__all__ = ['Distribution']

import io
import sys
import re
import os
import warnings
import numbers
import distutils.log
import distutils.core
import distutils.cmd
import distutils.dist
from distutils.util import strtobool
from distutils.debug import DEBUG
from distutils.fancy_getopt import translate_longopt
import itertools

from collections import defaultdict
from email import message_from_file

from distutils.errors import (
    DistutilsOptionError, DistutilsPlatformError, DistutilsSetupError,
)
from distutils.util import rfc822_escape
from distutils.version import StrictVersion

from setuptools.extern import six
from setuptools.extern import packaging
from setuptools.extern import ordered_set
from setuptools.extern.six.moves import map, filter, filterfalse

from . import SetuptoolsDeprecationWarning

from setuptools.depends import Require
from setuptools import windows_support
from setuptools.monkey import get_unpatched
from setuptools.config import parse_configuration
import pkg_resources

__import__('setuptools.extern.packaging.specifiers')
__import__('setuptools.extern.packaging.version')


def _get_unpatched(cls):
    warnings.warn("Do not call this function", DistDeprecationWarning)
    return get_unpatched(cls)


def get_metadata_version(self):
    mv = getattr(self, 'metadata_version', None)

    if mv is None:
        if self.long_description_content_type or self.provides_extras:
            mv = StrictVersion('2.1')
        elif (self.maintainer is not None or
              self.maintainer_email is not None or
              getattr(self, 'python_requires', None) is not None or
              self.project_urls):
            mv = StrictVersion('1.2')
        elif (self.provides or self.requires or self.obsoletes or
                self.classifiers or self.download_url):
            mv = StrictVersion('1.1')
        else:
            mv = StrictVersion('1.0')

        self.metadata_version = mv

    return mv


def read_pkg_file(self, file):
    """Reads the metadata values from a file object."""
    msg = message_from_file(file)

    def _read_field(name):
        value = msg[name]
        if value == 'UNKNOWN':
            return None
        return value

    def _read_list(name):
        values = msg.get_all(name, None)
        if values == []:
            return None
        return values

    self.metadata_version = StrictVersion(msg['metadata-version'])
    self.name = _read_field('name')
    self.version = _read_field('version')
    self.description = _read_field('summary')
    # we are filling author only.
    self.author = _read_field('author')
    self.maintainer = None
    self.author_email = _read_field('author-email')
    self.maintainer_email = None
    self.url = _read_field('home-page')
    self.license = _read_field('license')

    if 'download-url' in msg:
        self.download_url = _read_field('download-url')
    else:
        self.download_url = None

    self.long_description = _read_field('description')
    self.description = _read_field('summary')

    if 'keywords' in msg:
        self.keywords = _read_field('keywords').split(',')

    self.platforms = _read_list('platform')
    self.classifiers = _read_list('classifier')

    # PEP 314 - these fields only exist in 1.1
    if self.metadata_version == StrictVersion('1.1'):
        self.requires = _read_list('requires')
        self.provides = _read_list('provides')
        self.obsoletes = _read_list('obsoletes')
    else:
        self.requires = None
        self.provides = None
        self.obsoletes = None


# Based on Python 3.5 version
def write_pkg_file(self, file):
    """Write the PKG-INFO format data to a file object.
    """
    version = self.get_metadata_version()

    if six.PY2:
        def write_field(key, value):
            file.write("%s: %s\n" % (key, self._encode_field(value)))
    else:
        def write_field(key, value):
            file.write("%s: %s\n" % (key, value))

    write_field('Metadata-Version', str(version))
    write_field('Name', self.get_name())
    write_field('Version', self.get_version())
    write_field('Summary', self.get_description())
    write_field('Home-page', self.get_url())

    if version < StrictVersion('1.2'):
        write_field('Author', self.get_contact())
        write_field('Author-email', self.get_contact_email())
    else:
        optional_fields = (
            ('Author', 'author'),
            ('Author-email', 'author_email'),
            ('Maintainer', 'maintainer'),
            ('Maintainer-email', 'maintainer_email'),
        )

        for field, attr in optional_fields:
            attr_val = getattr(self, attr)

            if attr_val is not None:
                write_field(field, attr_val)

    write_field('License', self.get_license())
    if self.download_url:
        write_field('Download-URL', self.download_url)
    for project_url in self.project_urls.items():
        write_field('Project-URL',  '%s, %s' % project_url)

    long_desc = rfc822_escape(self.get_long_description())
    write_field('Description', long_desc)

    keywords = ','.join(self.get_keywords())
    if keywords:
        write_field('Keywords', keywords)

    if version >= StrictVersion('1.2'):
        for platform in self.get_platforms():
            write_field('Platform', platform)
    else:
        self._write_list(file, 'Platform', self.get_platforms())

    self._write_list(file, 'Classifier', self.get_classifiers())

    # PEP 314
    self._write_list(file, 'Requires', self.get_requires())
    self._write_list(file, 'Provides', self.get_provides())
    self._write_list(file, 'Obsoletes', self.get_obsoletes())

    # Setuptools specific for PEP 345
    if hasattr(self, 'python_requires'):
        write_field('Requires-Python', self.python_requires)

    # PEP 566
    if self.long_description_content_type:
        write_field(
            'Description-Content-Type',
            self.long_description_content_type
        )
    if self.provides_extras:
        for extra in self.provides_extras:
            write_field('Provides-Extra', extra)


sequence = tuple, list


def check_importable(dist, attr, value):
    try:
        ep = pkg_resources.EntryPoint.parse('x=' + value)
        assert not ep.extras
    except (TypeError, ValueError, AttributeError, AssertionError):
        raise DistutilsSetupError(
            "%r must be importable 'module:attrs' string (got %r)"
            % (attr, value)
        )


def assert_string_list(dist, attr, value):
    """Verify that value is a string list"""
    try:
        # verify that value is a list or tuple to exclude unordered
        # or single-use iterables
        assert isinstance(value, (list, tuple))
        # verify that elements of value are strings
        assert ''.join(value) != value
    except (TypeError, ValueError, AttributeError, AssertionError):
        raise DistutilsSetupError(
            "%r must be a list of strings (got %r)" % (attr, value)
        )


def check_nsp(dist, attr, value):
    """Verify that namespace packages are valid"""
    ns_packages = value
    assert_string_list(dist, attr, ns_packages)
    for nsp in ns_packages:
        if not dist.has_contents_for(nsp):
            raise DistutilsSetupError(
                "Distribution contains no modules or packages for " +
                "namespace package %r" % nsp
            )
        parent, sep, child = nsp.rpartition('.')
        if parent and parent not in ns_packages:
            distutils.log.warn(
                "WARNING: %r is declared as a package namespace, but %r"
                " is not: please correct this in setup.py", nsp, parent
            )


def check_extras(dist, attr, value):
    """Verify that extras_require mapping is valid"""
    try:
        list(itertools.starmap(_check_extra, value.items()))
    except (TypeError, ValueError, AttributeError):
        raise DistutilsSetupError(
            "'extras_require' must be a dictionary whose values are "
            "strings or lists of strings containing valid project/version "
            "requirement specifiers."
        )


def _check_extra(extra, reqs):
    name, sep, marker = extra.partition(':')
    if marker and pkg_resources.invalid_marker(marker):
        raise DistutilsSetupError("Invalid environment marker: " + marker)
    list(pkg_resources.parse_requirements(reqs))


def assert_bool(dist, attr, value):
    """Verify that value is True, False, 0, or 1"""
    if bool(value) != value:
        tmpl = "{attr!r} must be a boolean value (got {value!r})"
        raise DistutilsSetupError(tmpl.format(attr=attr, value=value))


def check_requirements(dist, attr, value):
    """Verify that install_requires is a valid requirements list"""
    try:
        list(pkg_resources.parse_requirements(value))
        if isinstance(value, (dict, set)):
            raise TypeError("Unordered types are not allowed")
    except (TypeError, ValueError) as error:
        tmpl = (
            "{attr!r} must be a string or list of strings "
            "containing valid project/version requirement specifiers; {error}"
        )
        raise DistutilsSetupError(tmpl.format(attr=attr, error=error))


def check_specifier(dist, attr, value):
    """Verify that value is a valid version specifier"""
    try:
        packaging.specifiers.SpecifierSet(value)
    except packaging.specifiers.InvalidSpecifier as error:
        tmpl = (
            "{attr!r} must be a string "
            "containing valid version specifiers; {error}"
        )
        raise DistutilsSetupError(tmpl.format(attr=attr, error=error))


def check_entry_points(dist, attr, value):
    """Verify that entry_points map is parseable"""
    try:
        pkg_resources.EntryPoint.parse_map(value)
    except ValueError as e:
        raise DistutilsSetupError(e)


def check_test_suite(dist, attr, value):
    if not isinstance(value, six.string_types):
        raise DistutilsSetupError("test_suite must be a string")


def check_package_data(dist, attr, value):
    """Verify that value is a dictionary of package names to glob lists"""
    if not isinstance(value, dict):
        raise DistutilsSetupError(
            "{!r} must be a dictionary mapping package names to lists of "
            "string wildcard patterns".format(attr))
    for k, v in value.items():
        if not isinstance(k, six.string_types):
            raise DistutilsSetupError(
                "keys of {!r} dict must be strings (got {!r})"
                .format(attr, k)
            )
        assert_string_list(dist, 'values of {!r} dict'.format(attr), v)


def check_packages(dist, attr, value):
    for pkgname in value:
        if not re.match(r'\w+(\.\w+)*', pkgname):
            distutils.log.warn(
                "WARNING: %r not a valid package name; please use only "
                ".-separated package names in setup.py", pkgname
            )


_Distribution = get_unpatched(distutils.core.Distribution)


class Distribution(_Distribution):
    """Distribution with support for features, tests, and package data

    This is an enhanced version of 'distutils.dist.Distribution' that
    effectively adds the following new optional keyword arguments to 'setup()':

     'install_requires' -- a string or sequence of strings specifying project
        versions that the distribution requires when installed, in the format
        used by 'pkg_resources.require()'.  They will be installed
        automatically when the package is installed.  If you wish to use
        packages that are not available in PyPI, or want to give your users an
        alternate download location, you can add a 'find_links' option to the
        '[easy_install]' section of your project's 'setup.cfg' file, and then
        setuptools will scan the listed web pages for links that satisfy the
        requirements.

     'extras_require' -- a dictionary mapping names of optional "extras" to the
        additional requirement(s) that using those extras incurs. For example,
        this::

            extras_require = dict(reST = ["docutils>=0.3", "reSTedit"])

        indicates that the distribution can optionally provide an extra
        capability called "reST", but it can only be used if docutils and
        reSTedit are installed.  If the user installs your package using
        EasyInstall and requests one of your extras, the corresponding
        additional requirements will be installed if needed.

     'features' **deprecated** -- a dictionary mapping option names to
        'setuptools.Feature'
        objects.  Features are a portion of the distribution that can be
        included or excluded based on user options, inter-feature dependencies,
        and availability on the current system.  Excluded features are omitted
        from all setup commands, including source and binary distributions, so
        you can create multiple distributions from the same source tree.
        Feature names should be valid Python identifiers, except that they may
        contain the '-' (minus) sign.  Features can be included or excluded
        via the command line options '--with-X' and '--without-X', where 'X' is
        the name of the feature.  Whether a feature is included by default, and
        whether you are allowed to control this from the command line, is
        determined by the Feature object.  See the 'Feature' class for more
        information.

     'test_suite' -- the name of a test suite to run for the 'test' command.
        If the user runs 'python setup.py test', the package will be installed,
        and the named test suite will be run.  The format is the same as
        would be used on a 'unittest.py' command line.  That is, it is the
        dotted name of an object to import and call to generate a test suite.

     'package_data' -- a dictionary mapping package names to lists of filenames
        or globs to use to find data files contained in the named packages.
        If the dictionary has filenames or globs listed under '""' (the empty
        string), those names will be searched for in every package, in addition
        to any names for the specific package.  Data files found using these
        names/globs will be installed along with the package, in the same
        location as the package.  Note that globs are allowed to reference
        the contents of non-package subdirectories, as long as you use '/' as
        a path separator.  (Globs are automatically converted to
        platform-specific paths at runtime.)

    In addition to these new keywords, this class also has several new methods
    for manipulating the distribution's contents.  For example, the 'include()'
    and 'exclude()' methods can be thought of as in-place add and subtract
    commands that add or remove packages, modules, extensions, and so on from
    the distribution.  They are used by the feature subsystem to configure the
    distribution for the included and excluded features.
    """

    _DISTUTILS_UNSUPPORTED_METADATA = {
        'long_description_content_type': None,
        'project_urls': dict,
        'provides_extras': ordered_set.OrderedSet,
    }

    _patched_dist = None

    def patch_missing_pkg_info(self, attrs):
        # Fake up a replacement for the data that would normally come from
        # PKG-INFO, but which might not yet be built if this is a fresh
        # checkout.
        #
        if not attrs or 'name' not in attrs or 'version' not in attrs:
            return
        key = pkg_resources.safe_name(str(attrs['name'])).lower()
        dist = pkg_resources.working_set.by_key.get(key)
        if dist is not None and not dist.has_metadata('PKG-INFO'):
            dist._version = pkg_resources.safe_version(str(attrs['version']))
            self._patched_dist = dist

    def __init__(self, attrs=None):
        have_package_data = hasattr(self, "package_data")
        if not have_package_data:
            self.package_data = {}
        attrs = attrs or {}
        if 'features' in attrs or 'require_features' in attrs:
            Feature.warn_deprecated()
        self.require_features = []
        self.features = {}
        self.dist_files = []
        # Filter-out setuptools' specific options.
        self.src_root = attrs.pop("src_root", None)
        self.patch_missing_pkg_info(attrs)
        self.dependency_links = attrs.pop('dependency_links', [])
        self.setup_requires = attrs.pop('setup_requires', [])
        for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'):
            vars(self).setdefault(ep.name, None)
        _Distribution.__init__(self, {
            k: v for k, v in attrs.items()
            if k not in self._DISTUTILS_UNSUPPORTED_METADATA
        })

        # Fill-in missing metadata fields not supported by distutils.
        # Note some fields may have been set by other tools (e.g. pbr)
        # above; they are taken preferrentially to setup() arguments
        for option, default in self._DISTUTILS_UNSUPPORTED_METADATA.items():
            for source in self.metadata.__dict__, attrs:
                if option in source:
                    value = source[option]
                    break
            else:
                value = default() if default else None
            setattr(self.metadata, option, value)

        if isinstance(self.metadata.version, numbers.Number):
            # Some people apparently take "version number" too literally :)
            self.metadata.version = str(self.metadata.version)

        if self.metadata.version is not None:
            try:
                ver = packaging.version.Version(self.metadata.version)
                normalized_version = str(ver)
                if self.metadata.version != normalized_version:
                    warnings.warn(
                        "Normalizing '%s' to '%s'" % (
                            self.metadata.version,
                            normalized_version,
                        )
                    )
                    self.metadata.version = normalized_version
            except (packaging.version.InvalidVersion, TypeError):
                warnings.warn(
                    "The version specified (%r) is an invalid version, this "
                    "may not work as expected with newer versions of "
                    "setuptools, pip, and PyPI. Please see PEP 440 for more "
                    "details." % self.metadata.version
                )
        self._finalize_requires()

    def _finalize_requires(self):
        """
        Set `metadata.python_requires` and fix environment markers
        in `install_requires` and `extras_require`.
        """
        if getattr(self, 'python_requires', None):
            self.metadata.python_requires = self.python_requires

        if getattr(self, 'extras_require', None):
            for extra in self.extras_require.keys():
                # Since this gets called multiple times at points where the
                # keys have become 'converted' extras, ensure that we are only
                # truly adding extras we haven't seen before here.
                extra = extra.split(':')[0]
                if extra:
                    self.metadata.provides_extras.add(extra)

        self._convert_extras_requirements()
        self._move_install_requirements_markers()

    def _convert_extras_requirements(self):
        """
        Convert requirements in `extras_require` of the form
        `"extra": ["barbazquux; {marker}"]` to
        `"extra:{marker}": ["barbazquux"]`.
        """
        spec_ext_reqs = getattr(self, 'extras_require', None) or {}
        self._tmp_extras_require = defaultdict(list)
        for section, v in spec_ext_reqs.items():
            # Do not strip empty sections.
            self._tmp_extras_require[section]
            for r in pkg_resources.parse_requirements(v):
                suffix = self._suffix_for(r)
                self._tmp_extras_require[section + suffix].append(r)

    @staticmethod
    def _suffix_for(req):
        """
        For a requirement, return the 'extras_require' suffix for
        that requirement.
        """
        return ':' + str(req.marker) if req.marker else ''

    def _move_install_requirements_markers(self):
        """
        Move requirements in `install_requires` that are using environment
        markers `extras_require`.
        """

        # divide the install_requires into two sets, simple ones still
        # handled by install_requires and more complex ones handled
        # by extras_require.

        def is_simple_req(req):
            return not req.marker

        spec_inst_reqs = getattr(self, 'install_requires', None) or ()
        inst_reqs = list(pkg_resources.parse_requirements(spec_inst_reqs))
        simple_reqs = filter(is_simple_req, inst_reqs)
        complex_reqs = filterfalse(is_simple_req, inst_reqs)
        self.install_requires = list(map(str, simple_reqs))

        for r in complex_reqs:
            self._tmp_extras_require[':' + str(r.marker)].append(r)
        self.extras_require = dict(
            (k, [str(r) for r in map(self._clean_req, v)])
            for k, v in self._tmp_extras_require.items()
        )

    def _clean_req(self, req):
        """
        Given a Requirement, remove environment markers and return it.
        """
        req.marker = None
        return req

    def _parse_config_files(self, filenames=None):
        """
        Adapted from distutils.dist.Distribution.parse_config_files,
        this method provides the same functionality in subtly-improved
        ways.
        """
        from setuptools.extern.six.moves.configparser import ConfigParser

        # Ignore install directory options if we have a venv
        if six.PY3 and sys.prefix != sys.base_prefix:
            ignore_options = [
                'install-base', 'install-platbase', 'install-lib',
                'install-platlib', 'install-purelib', 'install-headers',
                'install-scripts', 'install-data', 'prefix', 'exec-prefix',
                'home', 'user', 'root']
        else:
            ignore_options = []

        ignore_options = frozenset(ignore_options)

        if filenames is None:
            filenames = self.find_config_files()

        if DEBUG:
            self.announce("Distribution.parse_config_files():")

        parser = ConfigParser()
        for filename in filenames:
            with io.open(filename, encoding='utf-8') as reader:
                if DEBUG:
                    self.announce("  reading {filename}".format(**locals()))
                (parser.read_file if six.PY3 else parser.readfp)(reader)
            for section in parser.sections():
                options = parser.options(section)
                opt_dict = self.get_option_dict(section)

                for opt in options:
                    if opt != '__name__' and opt not in ignore_options:
                        val = self._try_str(parser.get(section, opt))
                        opt = opt.replace('-', '_')
                        opt_dict[opt] = (filename, val)

            # Make the ConfigParser forget everything (so we retain
            # the original filenames that options come from)
            parser.__init__()

        # If there was a "global" section in the config file, use it
        # to set Distribution options.

        if 'global' in self.command_options:
            for (opt, (src, val)) in self.command_options['global'].items():
                alias = self.negative_opt.get(opt)
                try:
                    if alias:
                        setattr(self, alias, not strtobool(val))
                    elif opt in ('verbose', 'dry_run'):  # ugh!
                        setattr(self, opt, strtobool(val))
                    else:
                        setattr(self, opt, val)
                except ValueError as msg:
                    raise DistutilsOptionError(msg)

    @staticmethod
    def _try_str(val):
        """
        On Python 2, much of distutils relies on string values being of
        type 'str' (bytes) and not unicode text. If the value can be safely
        encoded to bytes using the default encoding, prefer that.

        Why the default encoding? Because that value can be implicitly
        decoded back to text if needed.

        Ref #1653
        """
        if six.PY3:
            return val
        try:
            return val.encode()
        except UnicodeEncodeError:
            pass
        return val

    def _set_command_options(self, command_obj, option_dict=None):
        """
        Set the options for 'command_obj' from 'option_dict'.  Basically
        this means copying elements of a dictionary ('option_dict') to
        attributes of an instance ('command').

        'command_obj' must be a Command instance.  If 'option_dict' is not
        supplied, uses the standard option dictionary for this command
        (from 'self.command_options').

        (Adopted from distutils.dist.Distribution._set_command_options)
        """
        command_name = command_obj.get_command_name()
        if option_dict is None:
            option_dict = self.get_option_dict(command_name)

        if DEBUG:
            self.announce("  setting options for '%s' command:" % command_name)
        for (option, (source, value)) in option_dict.items():
            if DEBUG:
                self.announce("    %s = %s (from %s)" % (option, value,
                                                         source))
            try:
                bool_opts = [translate_longopt(o)
                             for o in command_obj.boolean_options]
            except AttributeError:
                bool_opts = []
            try:
                neg_opt = command_obj.negative_opt
            except AttributeError:
                neg_opt = {}

            try:
                is_string = isinstance(value, six.string_types)
                if option in neg_opt and is_string:
                    setattr(command_obj, neg_opt[option], not strtobool(value))
                elif option in bool_opts and is_string:
                    setattr(command_obj, option, strtobool(value))
                elif hasattr(command_obj, option):
                    setattr(command_obj, option, value)
                else:
                    raise DistutilsOptionError(
                        "error in %s: command '%s' has no such option '%s'"
                        % (source, command_name, option))
            except ValueError as msg:
                raise DistutilsOptionError(msg)

    def parse_config_files(self, filenames=None, ignore_option_errors=False):
        """Parses configuration files from various levels
        and loads configuration.

        """
        self._parse_config_files(filenames=filenames)

        parse_configuration(self, self.command_options,
                            ignore_option_errors=ignore_option_errors)
        self._finalize_requires()

    def parse_command_line(self):
        """Process features after parsing command line options"""
        result = _Distribution.parse_command_line(self)
        if self.features:
            self._finalize_features()
        return result

    def _feature_attrname(self, name):
        """Convert feature name to corresponding option attribute name"""
        return 'with_' + name.replace('-', '_')

    def fetch_build_eggs(self, requires):
        """Resolve pre-setup requirements"""
        resolved_dists = pkg_resources.working_set.resolve(
            pkg_resources.parse_requirements(requires),
            installer=self.fetch_build_egg,
            replace_conflicting=True,
        )
        for dist in resolved_dists:
            pkg_resources.working_set.add(dist, replace=True)
        return resolved_dists

    def finalize_options(self):
        _Distribution.finalize_options(self)
        if self.features:
            self._set_global_opts_from_features()

        for ep in pkg_resources.iter_entry_points('distutils.setup_keywords'):
            value = getattr(self, ep.name, None)
            if value is not None:
                ep.require(installer=self.fetch_build_egg)
                ep.load()(self, ep.name, value)
        if getattr(self, 'convert_2to3_doctests', None):
            # XXX may convert to set here when we can rely on set being builtin
            self.convert_2to3_doctests = [
                os.path.abspath(p)
                for p in self.convert_2to3_doctests
            ]
        else:
            self.convert_2to3_doctests = []

    def get_egg_cache_dir(self):
        egg_cache_dir = os.path.join(os.curdir, '.eggs')
        if not os.path.exists(egg_cache_dir):
            os.mkdir(egg_cache_dir)
            windows_support.hide_file(egg_cache_dir)
            readme_txt_filename = os.path.join(egg_cache_dir, 'README.txt')
            with open(readme_txt_filename, 'w') as f:
                f.write('This directory contains eggs that were downloaded '
                        'by setuptools to build, test, and run plug-ins.\n\n')
                f.write('This directory caches those eggs to prevent '
                        'repeated downloads.\n\n')
                f.write('However, it is safe to delete this directory.\n\n')

        return egg_cache_dir

    def fetch_build_egg(self, req):
        """Fetch an egg needed for building"""
        from setuptools.command.easy_install import easy_install
        dist = self.__class__({'script_args': ['easy_install']})
        opts = dist.get_option_dict('easy_install')
        opts.clear()
        opts.update(
            (k, v)
            for k, v in self.get_option_dict('easy_install').items()
            if k in (
                # don't use any other settings
                'find_links', 'site_dirs', 'index_url',
                'optimize', 'site_dirs', 'allow_hosts',
            ))
        if self.dependency_links:
            links = self.dependency_links[:]
            if 'find_links' in opts:
                links = opts['find_links'][1] + links
            opts['find_links'] = ('setup', links)
        install_dir = self.get_egg_cache_dir()
        cmd = easy_install(
            dist, args=["x"], install_dir=install_dir,
            exclude_scripts=True,
            always_copy=False, build_directory=None, editable=False,
            upgrade=False, multi_version=True, no_report=True, user=False
        )
        cmd.ensure_finalized()
        return cmd.easy_install(req)

    def _set_global_opts_from_features(self):
        """Add --with-X/--without-X options based on optional features"""

        go = []
        no = self.negative_opt.copy()

        for name, feature in self.features.items():
            self._set_feature(name, None)
            feature.validate(self)

            if feature.optional:
                descr = feature.description
                incdef = ' (default)'
                excdef = ''
                if not feature.include_by_default():
                    excdef, incdef = incdef, excdef

                new = (
                    ('with-' + name, None, 'include ' + descr + incdef),
                    ('without-' + name, None, 'exclude ' + descr + excdef),
                )
                go.extend(new)
                no['without-' + name] = 'with-' + name

        self.global_options = self.feature_options = go + self.global_options
        self.negative_opt = self.feature_negopt = no

    def _finalize_features(self):
        """Add/remove features and resolve dependencies between them"""

        # First, flag all the enabled items (and thus their dependencies)
        for name, feature in self.features.items():
            enabled = self.feature_is_included(name)
            if enabled or (enabled is None and feature.include_by_default()):
                feature.include_in(self)
                self._set_feature(name, 1)

        # Then disable the rest, so that off-by-default features don't
        # get flagged as errors when they're required by an enabled feature
        for name, feature in self.features.items():
            if not self.feature_is_included(name):
                feature.exclude_from(self)
                self._set_feature(name, 0)

    def get_command_class(self, command):
        """Pluggable version of get_command_class()"""
        if command in self.cmdclass:
            return self.cmdclass[command]

        eps = pkg_resources.iter_entry_points('distutils.commands', command)
        for ep in eps:
            ep.require(installer=self.fetch_build_egg)
            self.cmdclass[command] = cmdclass = ep.load()
            return cmdclass
        else:
            return _Distribution.get_command_class(self, command)

    def print_commands(self):
        for ep in pkg_resources.iter_entry_points('distutils.commands'):
            if ep.name not in self.cmdclass:
                # don't require extras as the commands won't be invoked
                cmdclass = ep.resolve()
                self.cmdclass[ep.name] = cmdclass
        return _Distribution.print_commands(self)

    def get_command_list(self):
        for ep in pkg_resources.iter_entry_points('distutils.commands'):
            if ep.name not in self.cmdclass:
                # don't require extras as the commands won't be invoked
                cmdclass = ep.resolve()
                self.cmdclass[ep.name] = cmdclass
        return _Distribution.get_command_list(self)

    def _set_feature(self, name, status):
        """Set feature's inclusion status"""
        setattr(self, self._feature_attrname(name), status)

    def feature_is_included(self, name):
        """Return 1 if feature is included, 0 if excluded, 'None' if unknown"""
        return getattr(self, self._feature_attrname(name))

    def include_feature(self, name):
        """Request inclusion of feature named 'name'"""

        if self.feature_is_included(name) == 0:
            descr = self.features[name].description
            raise DistutilsOptionError(
                descr + " is required, but was excluded or is not available"
            )
        self.features[name].include_in(self)
        self._set_feature(name, 1)

    def include(self, **attrs):
        """Add items to distribution that are named in keyword arguments

        For example, 'dist.include(py_modules=["x"])' would add 'x' to
        the distribution's 'py_modules' attribute, if it was not already
        there.

        Currently, this method only supports inclusion for attributes that are
        lists or tuples.  If you need to add support for adding to other
        attributes in this or a subclass, you can add an '_include_X' method,
        where 'X' is the name of the attribute.  The method will be called with
        the value passed to 'include()'.  So, 'dist.include(foo={"bar":"baz"})'
        will try to call 'dist._include_foo({"bar":"baz"})', which can then
        handle whatever special inclusion logic is needed.
        """
        for k, v in attrs.items():
            include = getattr(self, '_include_' + k, None)
            if include:
                include(v)
            else:
                self._include_misc(k, v)

    def exclude_package(self, package):
        """Remove packages, modules, and extensions in named package"""

        pfx = package + '.'
        if self.packages:
            self.packages = [
                p for p in self.packages
                if p != package and not p.startswith(pfx)
            ]

        if self.py_modules:
            self.py_modules = [
                p for p in self.py_modules
                if p != package and not p.startswith(pfx)
            ]

        if self.ext_modules:
            self.ext_modules = [
                p for p in self.ext_modules
                if p.name != package and not p.name.startswith(pfx)
            ]

    def has_contents_for(self, package):
        """Return true if 'exclude_package(package)' would do something"""

        pfx = package + '.'

        for p in self.iter_distribution_names():
            if p == package or p.startswith(pfx):
                return True

    def _exclude_misc(self, name, value):
        """Handle 'exclude()' for list/tuple attrs without a special handler"""
        if not isinstance(value, sequence):
            raise DistutilsSetupError(
                "%s: setting must be a list or tuple (%r)" % (name, value)
            )
        try:
            old = getattr(self, name)
        except AttributeError:
            raise DistutilsSetupError(
                "%s: No such distribution setting" % name
            )
        if old is not None and not isinstance(old, sequence):
            raise DistutilsSetupError(
                name + ": this setting cannot be changed via include/exclude"
            )
        elif old:
            setattr(self, name, [item for item in old if item not in value])

    def _include_misc(self, name, value):
        """Handle 'include()' for list/tuple attrs without a special handler"""

        if not isinstance(value, sequence):
            raise DistutilsSetupError(
                "%s: setting must be a list (%r)" % (name, value)
            )
        try:
            old = getattr(self, name)
        except AttributeError:
            raise DistutilsSetupError(
                "%s: No such distribution setting" % name
            )
        if old is None:
            setattr(self, name, value)
        elif not isinstance(old, sequence):
            raise DistutilsSetupError(
                name + ": this setting cannot be changed via include/exclude"
            )
        else:
            new = [item for item in value if item not in old]
            setattr(self, name, old + new)

    def exclude(self, **attrs):
        """Remove items from distribution that are named in keyword arguments

        For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from
        the distribution's 'py_modules' attribute.  Excluding packages uses
        the 'exclude_package()' method, so all of the package's contained
        packages, modules, and extensions are also excluded.

        Currently, this method only supports exclusion from attributes that are
        lists or tuples.  If you need to add support for excluding from other
        attributes in this or a subclass, you can add an '_exclude_X' method,
        where 'X' is the name of the attribute.  The method will be called with
        the value passed to 'exclude()'.  So, 'dist.exclude(foo={"bar":"baz"})'
        will try to call 'dist._exclude_foo({"bar":"baz"})', which can then
        handle whatever special exclusion logic is needed.
        """
        for k, v in attrs.items():
            exclude = getattr(self, '_exclude_' + k, None)
            if exclude:
                exclude(v)
            else:
                self._exclude_misc(k, v)

    def _exclude_packages(self, packages):
        if not isinstance(packages, sequence):
            raise DistutilsSetupError(
                "packages: setting must be a list or tuple (%r)" % (packages,)
            )
        list(map(self.exclude_package, packages))

    def _parse_command_opts(self, parser, args):
        # Remove --with-X/--without-X options when processing command args
        self.global_options = self.__class__.global_options
        self.negative_opt = self.__class__.negative_opt

        # First, expand any aliases
        command = args[0]
        aliases = self.get_option_dict('aliases')
        while command in aliases:
            src, alias = aliases[command]
            del aliases[command]  # ensure each alias can expand only once!
            import shlex
            args[:1] = shlex.split(alias, True)
            command = args[0]

        nargs = _Distribution._parse_command_opts(self, parser, args)

        # Handle commands that want to consume all remaining arguments
        cmd_class = self.get_command_class(command)
        if getattr(cmd_class, 'command_consumes_arguments', None):
            self.get_option_dict(command)['args'] = ("command line", nargs)
            if nargs is not None:
                return []

        return nargs

    def get_cmdline_options(self):
        """Return a '{cmd: {opt:val}}' map of all command-line options

        Option names are all long, but do not include the leading '--', and
        contain dashes rather than underscores.  If the option doesn't take
        an argument (e.g. '--quiet'), the 'val' is 'None'.

        Note that options provided by config files are intentionally excluded.
        """

        d = {}

        for cmd, opts in self.command_options.items():

            for opt, (src, val) in opts.items():

                if src != "command line":
                    continue

                opt = opt.replace('_', '-')

                if val == 0:
                    cmdobj = self.get_command_obj(cmd)
                    neg_opt = self.negative_opt.copy()
                    neg_opt.update(getattr(cmdobj, 'negative_opt', {}))
                    for neg, pos in neg_opt.items():
                        if pos == opt:
                            opt = neg
                            val = None
                            break
                    else:
                        raise AssertionError("Shouldn't be able to get here")

                elif val == 1:
                    val = None

                d.setdefault(cmd, {})[opt] = val

        return d

    def iter_distribution_names(self):
        """Yield all packages, modules, and extension names in distribution"""

        for pkg in self.packages or ():
            yield pkg

        for module in self.py_modules or ():
            yield module

        for ext in self.ext_modules or ():
            if isinstance(ext, tuple):
                name, buildinfo = ext
            else:
                name = ext.name
            if name.endswith('module'):
                name = name[:-6]
            yield name

    def handle_display_options(self, option_order):
        """If there were any non-global "display-only" options
        (--help-commands or the metadata display options) on the command
        line, display the requested info and return true; else return
        false.
        """
        import sys

        if six.PY2 or self.help_commands:
            return _Distribution.handle_display_options(self, option_order)

        # Stdout may be StringIO (e.g. in tests)
        if not isinstance(sys.stdout, io.TextIOWrapper):
            return _Distribution.handle_display_options(self, option_order)

        # Don't wrap stdout if utf-8 is already the encoding. Provides
        #  workaround for #334.
        if sys.stdout.encoding.lower() in ('utf-8', 'utf8'):
            return _Distribution.handle_display_options(self, option_order)

        # Print metadata in UTF-8 no matter the platform
        encoding = sys.stdout.encoding
        errors = sys.stdout.errors
        newline = sys.platform != 'win32' and '\n' or None
        line_buffering = sys.stdout.line_buffering

        sys.stdout = io.TextIOWrapper(
            sys.stdout.detach(), 'utf-8', errors, newline, line_buffering)
        try:
            return _Distribution.handle_display_options(self, option_order)
        finally:
            sys.stdout = io.TextIOWrapper(
                sys.stdout.detach(), encoding, errors, newline, line_buffering)


class Feature:
    """
    **deprecated** -- The `Feature` facility was never completely implemented
    or supported, `has reported issues
    <https://github.com/pypa/setuptools/issues/58>`_ and will be removed in
    a future version.

    A subset of the distribution that can be excluded if unneeded/wanted

    Features are created using these keyword arguments:

      'description' -- a short, human readable description of the feature, to
         be used in error messages, and option help messages.

      'standard' -- if true, the feature is included by default if it is
         available on the current system.  Otherwise, the feature is only
         included if requested via a command line '--with-X' option, or if
         another included feature requires it.  The default setting is 'False'.

      'available' -- if true, the feature is available for installation on the
         current system.  The default setting is 'True'.

      'optional' -- if true, the feature's inclusion can be controlled from the
         command line, using the '--with-X' or '--without-X' options.  If
         false, the feature's inclusion status is determined automatically,
         based on 'availabile', 'standard', and whether any other feature
         requires it.  The default setting is 'True'.

      'require_features' -- a string or sequence of strings naming features
         that should also be included if this feature is included.  Defaults to
         empty list.  May also contain 'Require' objects that should be
         added/removed from the distribution.

      'remove' -- a string or list of strings naming packages to be removed
         from the distribution if this feature is *not* included.  If the
         feature *is* included, this argument is ignored.  This argument exists
         to support removing features that "crosscut" a distribution, such as
         defining a 'tests' feature that removes all the 'tests' subpackages
         provided by other features.  The default for this argument is an empty
         list.  (Note: the named package(s) or modules must exist in the base
         distribution when the 'setup()' function is initially called.)

      other keywords -- any other keyword arguments are saved, and passed to
         the distribution's 'include()' and 'exclude()' methods when the
         feature is included or excluded, respectively.  So, for example, you
         could pass 'packages=["a","b"]' to cause packages 'a' and 'b' to be
         added or removed from the distribution as appropriate.

    A feature must include at least one 'requires', 'remove', or other
    keyword argument.  Otherwise, it can't affect the distribution in any way.
    Note also that you can subclass 'Feature' to create your own specialized
    feature types that modify the distribution in other ways when included or
    excluded.  See the docstrings for the various methods here for more detail.
    Aside from the methods, the only feature attributes that distributions look
    at are 'description' and 'optional'.
    """

    @staticmethod
    def warn_deprecated():
        msg = (
            "Features are deprecated and will be removed in a future "
            "version. See https://github.com/pypa/setuptools/issues/65."
        )
        warnings.warn(msg, DistDeprecationWarning, stacklevel=3)

    def __init__(
            self, description, standard=False, available=True,
            optional=True, require_features=(), remove=(), **extras):
        self.warn_deprecated()

        self.description = description
        self.standard = standard
        self.available = available
        self.optional = optional
        if isinstance(require_features, (str, Require)):
            require_features = require_features,

        self.require_features = [
            r for r in require_features if isinstance(r, str)
        ]
        er = [r for r in require_features if not isinstance(r, str)]
        if er:
            extras['require_features'] = er

        if isinstance(remove, str):
            remove = remove,
        self.remove = remove
        self.extras = extras

        if not remove and not require_features and not extras:
            raise DistutilsSetupError(
                "Feature %s: must define 'require_features', 'remove', or "
                "at least one of 'packages', 'py_modules', etc."
            )

    def include_by_default(self):
        """Should this feature be included by default?"""
        return self.available and self.standard

    def include_in(self, dist):
        """Ensure feature and its requirements are included in distribution

        You may override this in a subclass to perform additional operations on
        the distribution.  Note that this method may be called more than once
        per feature, and so should be idempotent.

        """

        if not self.available:
            raise DistutilsPlatformError(
                self.description + " is required, "
                "but is not available on this platform"
            )

        dist.include(**self.extras)

        for f in self.require_features:
            dist.include_feature(f)

    def exclude_from(self, dist):
        """Ensure feature is excluded from distribution

        You may override this in a subclass to perform additional operations on
        the distribution.  This method will be called at most once per
        feature, and only after all included features have been asked to
        include themselves.
        """

        dist.exclude(**self.extras)

        if self.remove:
            for item in self.remove:
                dist.exclude_package(item)

    def validate(self, dist):
        """Verify that feature makes sense in context of distribution

        This method is called by the distribution just before it parses its
        command line.  It checks to ensure that the 'remove' attribute, if any,
        contains only valid package/module names that are present in the base
        distribution when 'setup()' is called.  You may override it in a
        subclass to perform any other required validation of the feature
        against a target distribution.
        """

        for item in self.remove:
            if not dist.has_contents_for(item):
                raise DistutilsSetupError(
                    "%s wants to be able to remove %s, but the distribution"
                    " doesn't contain any packages or modules under %s"
                    % (self.description, item, item)
                )


class DistDeprecationWarning(SetuptoolsDeprecationWarning):
    """Class for warning about deprecations in dist in
    setuptools. Not ignored by default, unlike DeprecationWarning."""
site-packages/setuptools/ssl_support.py000064400000020455151446177000014467 0ustar00import os
import socket
import atexit
import re
import functools

from setuptools.extern.six.moves import urllib, http_client, map, filter

from pkg_resources import ResolutionError, ExtractionError

try:
    import ssl
except ImportError:
    ssl = None

__all__ = [
    'VerifyingHTTPSHandler', 'find_ca_bundle', 'is_available', 'cert_paths',
    'opener_for'
]

cert_paths = """
/etc/pki/tls/certs/ca-bundle.crt
/etc/ssl/certs/ca-certificates.crt
/usr/share/ssl/certs/ca-bundle.crt
/usr/local/share/certs/ca-root.crt
/etc/ssl/cert.pem
/System/Library/OpenSSL/certs/cert.pem
/usr/local/share/certs/ca-root-nss.crt
/etc/ssl/ca-bundle.pem
""".strip().split()

try:
    HTTPSHandler = urllib.request.HTTPSHandler
    HTTPSConnection = http_client.HTTPSConnection
except AttributeError:
    HTTPSHandler = HTTPSConnection = object

is_available = ssl is not None and object not in (HTTPSHandler, HTTPSConnection)


try:
    from ssl import CertificateError, match_hostname
except ImportError:
    try:
        from backports.ssl_match_hostname import CertificateError
        from backports.ssl_match_hostname import match_hostname
    except ImportError:
        CertificateError = None
        match_hostname = None

if not CertificateError:

    class CertificateError(ValueError):
        pass


if not match_hostname:

    def _dnsname_match(dn, hostname, max_wildcards=1):
        """Matching according to RFC 6125, section 6.4.3

        https://tools.ietf.org/html/rfc6125#section-6.4.3
        """
        pats = []
        if not dn:
            return False

        # Ported from python3-syntax:
        # leftmost, *remainder = dn.split(r'.')
        parts = dn.split(r'.')
        leftmost = parts[0]
        remainder = 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: " + repr(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")
        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")


class VerifyingHTTPSHandler(HTTPSHandler):
    """Simple verifying handler: no auth, subclasses, timeouts, etc."""

    def __init__(self, ca_bundle):
        self.ca_bundle = ca_bundle
        HTTPSHandler.__init__(self)

    def https_open(self, req):
        return self.do_open(
            lambda host, **kw: VerifyingHTTPSConn(host, self.ca_bundle, **kw), req
        )


class VerifyingHTTPSConn(HTTPSConnection):
    """Simple verifying connection: no auth, subclasses, timeouts, etc."""

    def __init__(self, host, ca_bundle, **kw):
        HTTPSConnection.__init__(self, host, **kw)
        self.ca_bundle = ca_bundle

    def connect(self):
        sock = socket.create_connection(
            (self.host, self.port), getattr(self, 'source_address', None)
        )

        # Handle the socket if a (proxy) tunnel is present
        if hasattr(self, '_tunnel') and getattr(self, '_tunnel_host', None):
            self.sock = sock
            self._tunnel()
            # http://bugs.python.org/issue7776: Python>=3.4.1 and >=2.7.7
            # change self.host to mean the proxy server host when tunneling is
            # being used. Adapt, since we are interested in the destination
            # host for the match_hostname() comparison.
            actual_host = self._tunnel_host
        else:
            actual_host = self.host

        if hasattr(ssl, 'create_default_context'):
            ctx = ssl.create_default_context(cafile=self.ca_bundle)
            self.sock = ctx.wrap_socket(sock, server_hostname=actual_host)
        else:
            # This is for python < 2.7.9 and < 3.4?
            self.sock = ssl.wrap_socket(
                sock, cert_reqs=ssl.CERT_REQUIRED, ca_certs=self.ca_bundle
            )
        try:
            match_hostname(self.sock.getpeercert(), actual_host)
        except CertificateError:
            self.sock.shutdown(socket.SHUT_RDWR)
            self.sock.close()
            raise


def opener_for(ca_bundle=None):
    """Get a urlopen() replacement that uses ca_bundle for verification"""
    return urllib.request.build_opener(
        VerifyingHTTPSHandler(ca_bundle or find_ca_bundle())
    ).open


# from jaraco.functools
def once(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        if not hasattr(func, 'always_returns'):
            func.always_returns = func(*args, **kwargs)
        return func.always_returns
    return wrapper


@once
def get_win_certfile():
    try:
        import wincertstore
    except ImportError:
        return None

    class CertFile(wincertstore.CertFile):
        def __init__(self):
            super(CertFile, self).__init__()
            atexit.register(self.close)

        def close(self):
            try:
                super(CertFile, self).close()
            except OSError:
                pass

    _wincerts = CertFile()
    _wincerts.addstore('CA')
    _wincerts.addstore('ROOT')
    return _wincerts.name


def find_ca_bundle():
    """Return an existing CA bundle path, or None"""
    extant_cert_paths = filter(os.path.isfile, cert_paths)
    return (
        get_win_certfile()
        or next(extant_cert_paths, None)
        or _certifi_where()
    )


def _certifi_where():
    try:
        return __import__('certifi').where()
    except (ImportError, ResolutionError, ExtractionError):
        pass
site-packages/setuptools/_vendor/packaging/_compat.py000064400000001534151446177000017071 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import sys


PY2 = sys.version_info[0] == 2
PY3 = sys.version_info[0] == 3

# flake8: noqa

if PY3:
    string_types = str,
else:
    string_types = basestring,


def with_metaclass(meta, *bases):
    """
    Create a base class with a metaclass.
    """
    # This requires a bit of explanation: the basic idea is to make a dummy
    # metaclass for one level of class instantiation that replaces itself with
    # the actual metaclass.
    class metaclass(meta):
        def __new__(cls, name, this_bases, d):
            return meta(name, bases, d)
    return type.__new__(metaclass, 'temporary_class', (), {})
site-packages/setuptools/_vendor/packaging/version.py000064400000026444151446177000017143 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import collections
import itertools
import re

from ._structures import Infinity


__all__ = [
    "parse", "Version", "LegacyVersion", "InvalidVersion", "VERSION_PATTERN"
]


_Version = collections.namedtuple(
    "_Version",
    ["epoch", "release", "dev", "pre", "post", "local"],
)


def parse(version):
    """
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    """
    try:
        return Version(version)
    except InvalidVersion:
        return LegacyVersion(version)


class InvalidVersion(ValueError):
    """
    An invalid version was found, users should refer to PEP 440.
    """


class _BaseVersion(object):

    def __hash__(self):
        return hash(self._key)

    def __lt__(self, other):
        return self._compare(other, lambda s, o: s < o)

    def __le__(self, other):
        return self._compare(other, lambda s, o: s <= o)

    def __eq__(self, other):
        return self._compare(other, lambda s, o: s == o)

    def __ge__(self, other):
        return self._compare(other, lambda s, o: s >= o)

    def __gt__(self, other):
        return self._compare(other, lambda s, o: s > o)

    def __ne__(self, other):
        return self._compare(other, lambda s, o: s != o)

    def _compare(self, other, method):
        if not isinstance(other, _BaseVersion):
            return NotImplemented

        return method(self._key, other._key)


class LegacyVersion(_BaseVersion):

    def __init__(self, version):
        self._version = str(version)
        self._key = _legacy_cmpkey(self._version)

    def __str__(self):
        return self._version

    def __repr__(self):
        return "<LegacyVersion({0})>".format(repr(str(self)))

    @property
    def public(self):
        return self._version

    @property
    def base_version(self):
        return self._version

    @property
    def local(self):
        return None

    @property
    def is_prerelease(self):
        return False

    @property
    def is_postrelease(self):
        return False


_legacy_version_component_re = re.compile(
    r"(\d+ | [a-z]+ | \.| -)", re.VERBOSE,
)

_legacy_version_replacement_map = {
    "pre": "c", "preview": "c", "-": "final-", "rc": "c", "dev": "@",
}


def _parse_version_parts(s):
    for part in _legacy_version_component_re.split(s):
        part = _legacy_version_replacement_map.get(part, part)

        if not part or part == ".":
            continue

        if part[:1] in "0123456789":
            # pad for numeric comparison
            yield part.zfill(8)
        else:
            yield "*" + part

    # ensure that alpha/beta/candidate are before final
    yield "*final"


def _legacy_cmpkey(version):
    # We hardcode an epoch of -1 here. A PEP 440 version can only have a epoch
    # greater than or equal to 0. This will effectively put the LegacyVersion,
    # which uses the defacto standard originally implemented by setuptools,
    # as before all PEP 440 versions.
    epoch = -1

    # This scheme is taken from pkg_resources.parse_version setuptools prior to
    # it's adoption of the packaging library.
    parts = []
    for part in _parse_version_parts(version.lower()):
        if part.startswith("*"):
            # remove "-" before a prerelease tag
            if part < "*final":
                while parts and parts[-1] == "*final-":
                    parts.pop()

            # remove trailing zeros from each series of numeric parts
            while parts and parts[-1] == "00000000":
                parts.pop()

        parts.append(part)
    parts = tuple(parts)

    return epoch, parts

# Deliberately not anchored to the start and end of the string, to make it
# easier for 3rd party code to reuse
VERSION_PATTERN = r"""
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
"""


class Version(_BaseVersion):

    _regex = re.compile(
        r"^\s*" + VERSION_PATTERN + r"\s*$",
        re.VERBOSE | re.IGNORECASE,
    )

    def __init__(self, version):
        # Validate the version and parse it into pieces
        match = self._regex.search(version)
        if not match:
            raise InvalidVersion("Invalid version: '{0}'".format(version))

        # Store the parsed out pieces of the version
        self._version = _Version(
            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
            release=tuple(int(i) for i in match.group("release").split(".")),
            pre=_parse_letter_version(
                match.group("pre_l"),
                match.group("pre_n"),
            ),
            post=_parse_letter_version(
                match.group("post_l"),
                match.group("post_n1") or match.group("post_n2"),
            ),
            dev=_parse_letter_version(
                match.group("dev_l"),
                match.group("dev_n"),
            ),
            local=_parse_local_version(match.group("local")),
        )

        # Generate a key which will be used for sorting
        self._key = _cmpkey(
            self._version.epoch,
            self._version.release,
            self._version.pre,
            self._version.post,
            self._version.dev,
            self._version.local,
        )

    def __repr__(self):
        return "<Version({0})>".format(repr(str(self)))

    def __str__(self):
        parts = []

        # Epoch
        if self._version.epoch != 0:
            parts.append("{0}!".format(self._version.epoch))

        # Release segment
        parts.append(".".join(str(x) for x in self._version.release))

        # Pre-release
        if self._version.pre is not None:
            parts.append("".join(str(x) for x in self._version.pre))

        # Post-release
        if self._version.post is not None:
            parts.append(".post{0}".format(self._version.post[1]))

        # Development release
        if self._version.dev is not None:
            parts.append(".dev{0}".format(self._version.dev[1]))

        # Local version segment
        if self._version.local is not None:
            parts.append(
                "+{0}".format(".".join(str(x) for x in self._version.local))
            )

        return "".join(parts)

    @property
    def public(self):
        return str(self).split("+", 1)[0]

    @property
    def base_version(self):
        parts = []

        # Epoch
        if self._version.epoch != 0:
            parts.append("{0}!".format(self._version.epoch))

        # Release segment
        parts.append(".".join(str(x) for x in self._version.release))

        return "".join(parts)

    @property
    def local(self):
        version_string = str(self)
        if "+" in version_string:
            return version_string.split("+", 1)[1]

    @property
    def is_prerelease(self):
        return bool(self._version.dev or self._version.pre)

    @property
    def is_postrelease(self):
        return bool(self._version.post)


def _parse_letter_version(letter, number):
    if letter:
        # We consider there to be an implicit 0 in a pre-release if there is
        # not a numeral associated with it.
        if number is None:
            number = 0

        # We normalize any letters to their lower case form
        letter = letter.lower()

        # We consider some words to be alternate spellings of other words and
        # in those cases we want to normalize the spellings to our preferred
        # spelling.
        if letter == "alpha":
            letter = "a"
        elif letter == "beta":
            letter = "b"
        elif letter in ["c", "pre", "preview"]:
            letter = "rc"
        elif letter in ["rev", "r"]:
            letter = "post"

        return letter, int(number)
    if not letter and number:
        # We assume if we are given a number, but we are not given a letter
        # then this is using the implicit post release syntax (e.g. 1.0-1)
        letter = "post"

        return letter, int(number)


_local_version_seperators = re.compile(r"[\._-]")


def _parse_local_version(local):
    """
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    """
    if local is not None:
        return tuple(
            part.lower() if not part.isdigit() else int(part)
            for part in _local_version_seperators.split(local)
        )


def _cmpkey(epoch, release, pre, post, dev, local):
    # When we compare a release version, we want to compare it with all of the
    # trailing zeros removed. So we'll use a reverse the list, drop all the now
    # leading zeros until we come to something non zero, then take the rest
    # re-reverse it back into the correct order and make it a tuple and use
    # that for our sorting key.
    release = tuple(
        reversed(list(
            itertools.dropwhile(
                lambda x: x == 0,
                reversed(release),
            )
        ))
    )

    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
    # We'll do this by abusing the pre segment, but we _only_ want to do this
    # if there is not a pre or a post segment. If we have one of those then
    # the normal sorting rules will handle this case correctly.
    if pre is None and post is None and dev is not None:
        pre = -Infinity
    # Versions without a pre-release (except as noted above) should sort after
    # those with one.
    elif pre is None:
        pre = Infinity

    # Versions without a post segment should sort before those with one.
    if post is None:
        post = -Infinity

    # Versions without a development segment should sort after those with one.
    if dev is None:
        dev = Infinity

    if local is None:
        # Versions without a local segment should sort before those with one.
        local = -Infinity
    else:
        # Versions with a local segment need that segment parsed to implement
        # the sorting rules in PEP440.
        # - Alpha numeric segments sort before numeric segments
        # - Alpha numeric segments sort lexicographically
        # - Numeric segments sort numerically
        # - Shorter versions sort before longer versions when the prefixes
        #   match exactly
        local = tuple(
            (i, "") if isinstance(i, int) else (-Infinity, i)
            for i in local
        )

    return epoch, release, pre, post, dev, local
site-packages/setuptools/_vendor/packaging/utils.py000064400000000645151446177000016611 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import re


_canonicalize_regex = re.compile(r"[-_.]+")


def canonicalize_name(name):
    # This is taken from PEP 503.
    return _canonicalize_regex.sub("-", name).lower()
site-packages/setuptools/_vendor/packaging/__about__.py000064400000001320151446177000017346 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

__all__ = [
    "__title__", "__summary__", "__uri__", "__version__", "__author__",
    "__email__", "__license__", "__copyright__",
]

__title__ = "packaging"
__summary__ = "Core utilities for Python packages"
__uri__ = "https://github.com/pypa/packaging"

__version__ = "16.8"

__author__ = "Donald Stufft and individual contributors"
__email__ = "donald@stufft.io"

__license__ = "BSD or Apache License, Version 2.0"
__copyright__ = "Copyright 2014-2016 %s" % __author__
site-packages/setuptools/_vendor/packaging/specifiers.py000064400000066571151446177000017617 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import abc
import functools
import itertools
import re

from ._compat import string_types, with_metaclass
from .version import Version, LegacyVersion, parse


class InvalidSpecifier(ValueError):
    """
    An invalid specifier was found, users should refer to PEP 440.
    """


class BaseSpecifier(with_metaclass(abc.ABCMeta, object)):

    @abc.abstractmethod
    def __str__(self):
        """
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        """

    @abc.abstractmethod
    def __hash__(self):
        """
        Returns a hash value for this Specifier like object.
        """

    @abc.abstractmethod
    def __eq__(self, other):
        """
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        """

    @abc.abstractmethod
    def __ne__(self, other):
        """
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        """

    @abc.abstractproperty
    def prereleases(self):
        """
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        """

    @prereleases.setter
    def prereleases(self, value):
        """
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        """

    @abc.abstractmethod
    def contains(self, item, prereleases=None):
        """
        Determines if the given item is contained within this specifier.
        """

    @abc.abstractmethod
    def filter(self, iterable, prereleases=None):
        """
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        """


class _IndividualSpecifier(BaseSpecifier):

    _operators = {}

    def __init__(self, spec="", prereleases=None):
        match = self._regex.search(spec)
        if not match:
            raise InvalidSpecifier("Invalid specifier: '{0}'".format(spec))

        self._spec = (
            match.group("operator").strip(),
            match.group("version").strip(),
        )

        # Store whether or not this Specifier should accept prereleases
        self._prereleases = prereleases

    def __repr__(self):
        pre = (
            ", prereleases={0!r}".format(self.prereleases)
            if self._prereleases is not None
            else ""
        )

        return "<{0}({1!r}{2})>".format(
            self.__class__.__name__,
            str(self),
            pre,
        )

    def __str__(self):
        return "{0}{1}".format(*self._spec)

    def __hash__(self):
        return hash(self._spec)

    def __eq__(self, other):
        if isinstance(other, string_types):
            try:
                other = self.__class__(other)
            except InvalidSpecifier:
                return NotImplemented
        elif not isinstance(other, self.__class__):
            return NotImplemented

        return self._spec == other._spec

    def __ne__(self, other):
        if isinstance(other, string_types):
            try:
                other = self.__class__(other)
            except InvalidSpecifier:
                return NotImplemented
        elif not isinstance(other, self.__class__):
            return NotImplemented

        return self._spec != other._spec

    def _get_operator(self, op):
        return getattr(self, "_compare_{0}".format(self._operators[op]))

    def _coerce_version(self, version):
        if not isinstance(version, (LegacyVersion, Version)):
            version = parse(version)
        return version

    @property
    def operator(self):
        return self._spec[0]

    @property
    def version(self):
        return self._spec[1]

    @property
    def prereleases(self):
        return self._prereleases

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value

    def __contains__(self, item):
        return self.contains(item)

    def contains(self, item, prereleases=None):
        # Determine if prereleases are to be allowed or not.
        if prereleases is None:
            prereleases = self.prereleases

        # Normalize item to a Version or LegacyVersion, this allows us to have
        # a shortcut for ``"2.0" in Specifier(">=2")
        item = self._coerce_version(item)

        # Determine if we should be supporting prereleases in this specifier
        # or not, if we do not support prereleases than we can short circuit
        # logic if this version is a prereleases.
        if item.is_prerelease and not prereleases:
            return False

        # Actually do the comparison to determine if this item is contained
        # within this Specifier or not.
        return self._get_operator(self.operator)(item, self.version)

    def filter(self, iterable, prereleases=None):
        yielded = False
        found_prereleases = []

        kw = {"prereleases": prereleases if prereleases is not None else True}

        # Attempt to iterate over all the values in the iterable and if any of
        # them match, yield them.
        for version in iterable:
            parsed_version = self._coerce_version(version)

            if self.contains(parsed_version, **kw):
                # If our version is a prerelease, and we were not set to allow
                # prereleases, then we'll store it for later incase nothing
                # else matches this specifier.
                if (parsed_version.is_prerelease and not
                        (prereleases or self.prereleases)):
                    found_prereleases.append(version)
                # Either this is not a prerelease, or we should have been
                # accepting prereleases from the begining.
                else:
                    yielded = True
                    yield version

        # Now that we've iterated over everything, determine if we've yielded
        # any values, and if we have not and we have any prereleases stored up
        # then we will go ahead and yield the prereleases.
        if not yielded and found_prereleases:
            for version in found_prereleases:
                yield version


class LegacySpecifier(_IndividualSpecifier):

    _regex_str = (
        r"""
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        """
    )

    _regex = re.compile(
        r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)

    _operators = {
        "==": "equal",
        "!=": "not_equal",
        "<=": "less_than_equal",
        ">=": "greater_than_equal",
        "<": "less_than",
        ">": "greater_than",
    }

    def _coerce_version(self, version):
        if not isinstance(version, LegacyVersion):
            version = LegacyVersion(str(version))
        return version

    def _compare_equal(self, prospective, spec):
        return prospective == self._coerce_version(spec)

    def _compare_not_equal(self, prospective, spec):
        return prospective != self._coerce_version(spec)

    def _compare_less_than_equal(self, prospective, spec):
        return prospective <= self._coerce_version(spec)

    def _compare_greater_than_equal(self, prospective, spec):
        return prospective >= self._coerce_version(spec)

    def _compare_less_than(self, prospective, spec):
        return prospective < self._coerce_version(spec)

    def _compare_greater_than(self, prospective, spec):
        return prospective > self._coerce_version(spec)


def _require_version_compare(fn):
    @functools.wraps(fn)
    def wrapped(self, prospective, spec):
        if not isinstance(prospective, Version):
            return False
        return fn(self, prospective, spec)
    return wrapped


class Specifier(_IndividualSpecifier):

    _regex_str = (
        r"""
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        """
    )

    _regex = re.compile(
        r"^\s*" + _regex_str + r"\s*$", re.VERBOSE | re.IGNORECASE)

    _operators = {
        "~=": "compatible",
        "==": "equal",
        "!=": "not_equal",
        "<=": "less_than_equal",
        ">=": "greater_than_equal",
        "<": "less_than",
        ">": "greater_than",
        "===": "arbitrary",
    }

    @_require_version_compare
    def _compare_compatible(self, prospective, spec):
        # Compatible releases have an equivalent combination of >= and ==. That
        # is that ~=2.2 is equivalent to >=2.2,==2.*. This allows us to
        # implement this in terms of the other specifiers instead of
        # implementing it ourselves. The only thing we need to do is construct
        # the other specifiers.

        # We want everything but the last item in the version, but we want to
        # ignore post and dev releases and we want to treat the pre-release as
        # it's own separate segment.
        prefix = ".".join(
            list(
                itertools.takewhile(
                    lambda x: (not x.startswith("post") and not
                               x.startswith("dev")),
                    _version_split(spec),
                )
            )[:-1]
        )

        # Add the prefix notation to the end of our string
        prefix += ".*"

        return (self._get_operator(">=")(prospective, spec) and
                self._get_operator("==")(prospective, prefix))

    @_require_version_compare
    def _compare_equal(self, prospective, spec):
        # We need special logic to handle prefix matching
        if spec.endswith(".*"):
            # In the case of prefix matching we want to ignore local segment.
            prospective = Version(prospective.public)
            # Split the spec out by dots, and pretend that there is an implicit
            # dot in between a release segment and a pre-release segment.
            spec = _version_split(spec[:-2])  # Remove the trailing .*

            # Split the prospective version out by dots, and pretend that there
            # is an implicit dot in between a release segment and a pre-release
            # segment.
            prospective = _version_split(str(prospective))

            # Shorten the prospective version to be the same length as the spec
            # so that we can determine if the specifier is a prefix of the
            # prospective version or not.
            prospective = prospective[:len(spec)]

            # Pad out our two sides with zeros so that they both equal the same
            # length.
            spec, prospective = _pad_version(spec, prospective)
        else:
            # Convert our spec string into a Version
            spec = Version(spec)

            # If the specifier does not have a local segment, then we want to
            # act as if the prospective version also does not have a local
            # segment.
            if not spec.local:
                prospective = Version(prospective.public)

        return prospective == spec

    @_require_version_compare
    def _compare_not_equal(self, prospective, spec):
        return not self._compare_equal(prospective, spec)

    @_require_version_compare
    def _compare_less_than_equal(self, prospective, spec):
        return prospective <= Version(spec)

    @_require_version_compare
    def _compare_greater_than_equal(self, prospective, spec):
        return prospective >= Version(spec)

    @_require_version_compare
    def _compare_less_than(self, prospective, spec):
        # Convert our spec to a Version instance, since we'll want to work with
        # it as a version.
        spec = Version(spec)

        # Check to see if the prospective version is less than the spec
        # version. If it's not we can short circuit and just return False now
        # instead of doing extra unneeded work.
        if not prospective < spec:
            return False

        # This special case is here so that, unless the specifier itself
        # includes is a pre-release version, that we do not accept pre-release
        # versions for the version mentioned in the specifier (e.g. <3.1 should
        # not match 3.1.dev0, but should match 3.0.dev0).
        if not spec.is_prerelease and prospective.is_prerelease:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # If we've gotten to here, it means that prospective version is both
        # less than the spec version *and* it's not a pre-release of the same
        # version in the spec.
        return True

    @_require_version_compare
    def _compare_greater_than(self, prospective, spec):
        # Convert our spec to a Version instance, since we'll want to work with
        # it as a version.
        spec = Version(spec)

        # Check to see if the prospective version is greater than the spec
        # version. If it's not we can short circuit and just return False now
        # instead of doing extra unneeded work.
        if not prospective > spec:
            return False

        # This special case is here so that, unless the specifier itself
        # includes is a post-release version, that we do not accept
        # post-release versions for the version mentioned in the specifier
        # (e.g. >3.1 should not match 3.0.post0, but should match 3.2.post0).
        if not spec.is_postrelease and prospective.is_postrelease:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # Ensure that we do not allow a local version of the version mentioned
        # in the specifier, which is techincally greater than, to match.
        if prospective.local is not None:
            if Version(prospective.base_version) == Version(spec.base_version):
                return False

        # If we've gotten to here, it means that prospective version is both
        # greater than the spec version *and* it's not a pre-release of the
        # same version in the spec.
        return True

    def _compare_arbitrary(self, prospective, spec):
        return str(prospective).lower() == str(spec).lower()

    @property
    def prereleases(self):
        # If there is an explicit prereleases set for this, then we'll just
        # blindly use that.
        if self._prereleases is not None:
            return self._prereleases

        # Look at all of our specifiers and determine if they are inclusive
        # operators, and if they are if they are including an explicit
        # prerelease.
        operator, version = self._spec
        if operator in ["==", ">=", "<=", "~=", "==="]:
            # The == specifier can include a trailing .*, if it does we
            # want to remove before parsing.
            if operator == "==" and version.endswith(".*"):
                version = version[:-2]

            # Parse the version, and if it is a pre-release than this
            # specifier allows pre-releases.
            if parse(version).is_prerelease:
                return True

        return False

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value


_prefix_regex = re.compile(r"^([0-9]+)((?:a|b|c|rc)[0-9]+)$")


def _version_split(version):
    result = []
    for item in version.split("."):
        match = _prefix_regex.search(item)
        if match:
            result.extend(match.groups())
        else:
            result.append(item)
    return result


def _pad_version(left, right):
    left_split, right_split = [], []

    # Get the release segment of our versions
    left_split.append(list(itertools.takewhile(lambda x: x.isdigit(), left)))
    right_split.append(list(itertools.takewhile(lambda x: x.isdigit(), right)))

    # Get the rest of our versions
    left_split.append(left[len(left_split[0]):])
    right_split.append(right[len(right_split[0]):])

    # Insert our padding
    left_split.insert(
        1,
        ["0"] * max(0, len(right_split[0]) - len(left_split[0])),
    )
    right_split.insert(
        1,
        ["0"] * max(0, len(left_split[0]) - len(right_split[0])),
    )

    return (
        list(itertools.chain(*left_split)),
        list(itertools.chain(*right_split)),
    )


class SpecifierSet(BaseSpecifier):

    def __init__(self, specifiers="", prereleases=None):
        # Split on , to break each indidivual specifier into it's own item, and
        # strip each item to remove leading/trailing whitespace.
        specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]

        # Parsed each individual specifier, attempting first to make it a
        # Specifier and falling back to a LegacySpecifier.
        parsed = set()
        for specifier in specifiers:
            try:
                parsed.add(Specifier(specifier))
            except InvalidSpecifier:
                parsed.add(LegacySpecifier(specifier))

        # Turn our parsed specifiers into a frozen set and save them for later.
        self._specs = frozenset(parsed)

        # Store our prereleases value so we can use it later to determine if
        # we accept prereleases or not.
        self._prereleases = prereleases

    def __repr__(self):
        pre = (
            ", prereleases={0!r}".format(self.prereleases)
            if self._prereleases is not None
            else ""
        )

        return "<SpecifierSet({0!r}{1})>".format(str(self), pre)

    def __str__(self):
        return ",".join(sorted(str(s) for s in self._specs))

    def __hash__(self):
        return hash(self._specs)

    def __and__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        specifier = SpecifierSet()
        specifier._specs = frozenset(self._specs | other._specs)

        if self._prereleases is None and other._prereleases is not None:
            specifier._prereleases = other._prereleases
        elif self._prereleases is not None and other._prereleases is None:
            specifier._prereleases = self._prereleases
        elif self._prereleases == other._prereleases:
            specifier._prereleases = self._prereleases
        else:
            raise ValueError(
                "Cannot combine SpecifierSets with True and False prerelease "
                "overrides."
            )

        return specifier

    def __eq__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif isinstance(other, _IndividualSpecifier):
            other = SpecifierSet(str(other))
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        return self._specs == other._specs

    def __ne__(self, other):
        if isinstance(other, string_types):
            other = SpecifierSet(other)
        elif isinstance(other, _IndividualSpecifier):
            other = SpecifierSet(str(other))
        elif not isinstance(other, SpecifierSet):
            return NotImplemented

        return self._specs != other._specs

    def __len__(self):
        return len(self._specs)

    def __iter__(self):
        return iter(self._specs)

    @property
    def prereleases(self):
        # If we have been given an explicit prerelease modifier, then we'll
        # pass that through here.
        if self._prereleases is not None:
            return self._prereleases

        # If we don't have any specifiers, and we don't have a forced value,
        # then we'll just return None since we don't know if this should have
        # pre-releases or not.
        if not self._specs:
            return None

        # Otherwise we'll see if any of the given specifiers accept
        # prereleases, if any of them do we'll return True, otherwise False.
        return any(s.prereleases for s in self._specs)

    @prereleases.setter
    def prereleases(self, value):
        self._prereleases = value

    def __contains__(self, item):
        return self.contains(item)

    def contains(self, item, prereleases=None):
        # Ensure that our item is a Version or LegacyVersion instance.
        if not isinstance(item, (LegacyVersion, Version)):
            item = parse(item)

        # Determine if we're forcing a prerelease or not, if we're not forcing
        # one for this particular filter call, then we'll use whatever the
        # SpecifierSet thinks for whether or not we should support prereleases.
        if prereleases is None:
            prereleases = self.prereleases

        # We can determine if we're going to allow pre-releases by looking to
        # see if any of the underlying items supports them. If none of them do
        # and this item is a pre-release then we do not allow it and we can
        # short circuit that here.
        # Note: This means that 1.0.dev1 would not be contained in something
        #       like >=1.0.devabc however it would be in >=1.0.debabc,>0.0.dev0
        if not prereleases and item.is_prerelease:
            return False

        # We simply dispatch to the underlying specs here to make sure that the
        # given version is contained within all of them.
        # Note: This use of all() here means that an empty set of specifiers
        #       will always return True, this is an explicit design decision.
        return all(
            s.contains(item, prereleases=prereleases)
            for s in self._specs
        )

    def filter(self, iterable, prereleases=None):
        # Determine if we're forcing a prerelease or not, if we're not forcing
        # one for this particular filter call, then we'll use whatever the
        # SpecifierSet thinks for whether or not we should support prereleases.
        if prereleases is None:
            prereleases = self.prereleases

        # If we have any specifiers, then we want to wrap our iterable in the
        # filter method for each one, this will act as a logical AND amongst
        # each specifier.
        if self._specs:
            for spec in self._specs:
                iterable = spec.filter(iterable, prereleases=bool(prereleases))
            return iterable
        # If we do not have any specifiers, then we need to have a rough filter
        # which will filter out any pre-releases, unless there are no final
        # releases, and which will filter out LegacyVersion in general.
        else:
            filtered = []
            found_prereleases = []

            for item in iterable:
                # Ensure that we some kind of Version class for this item.
                if not isinstance(item, (LegacyVersion, Version)):
                    parsed_version = parse(item)
                else:
                    parsed_version = item

                # Filter out any item which is parsed as a LegacyVersion
                if isinstance(parsed_version, LegacyVersion):
                    continue

                # Store any item which is a pre-release for later unless we've
                # already found a final version or we are accepting prereleases
                if parsed_version.is_prerelease and not prereleases:
                    if not filtered:
                        found_prereleases.append(item)
                else:
                    filtered.append(item)

            # If we've found no items except for pre-releases, then we'll go
            # ahead and use the pre-releases
            if not filtered and found_prereleases and prereleases is None:
                return found_prereleases

            return filtered
site-packages/setuptools/_vendor/packaging/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001036151446177000024430 0ustar00U

�Qab�@sTddlmZmZmZddlmZmZmZmZm	Z	m
Z
mZmZdddddd	d
dgZ
dS)
�)�absolute_import�division�print_function�)�
__author__�
__copyright__�	__email__�__license__�__summary__�	__title__�__uri__�__version__rr
rr
rrr	rN)Z
__future__rrr�	__about__rrrr	r
rrr
�__all__�rr�I/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py�<module>s(�site-packages/setuptools/_vendor/packaging/__pycache__/specifiers.cpython-38.pyc000064400000046510151446177000024074 0ustar00U

�Qabym�@s�ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
ddlmZm
Z
mZGdd�de�ZGdd	�d	e
eje��ZGd
d�de�ZGdd
�d
e�Zdd�ZGdd�de�Ze�d�Zdd�Zdd�ZGdd�de�ZdS)�)�absolute_import�division�print_functionN�)�string_types�with_metaclass)�Version�
LegacyVersion�parsec@seZdZdZdS)�InvalidSpecifierzH
    An invalid specifier was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__�rr�K/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.pyrsrc@s�eZdZejdd��Zejdd��Zejdd��Zejdd��Zej	d	d
��Z
e
jdd
��Z
ejdd
d��Zejddd��Z
dS)�
BaseSpecifiercCsdS)z�
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        Nr��selfrrr�__str__szBaseSpecifier.__str__cCsdS)zF
        Returns a hash value for this Specifier like object.
        Nrrrrr�__hash__szBaseSpecifier.__hash__cCsdS)zq
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        Nr�r�otherrrr�__eq__$szBaseSpecifier.__eq__cCsdS)zu
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        Nrrrrr�__ne__+szBaseSpecifier.__ne__cCsdS)zg
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        Nrrrrr�prereleases2szBaseSpecifier.prereleasescCsdS)zd
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr�r�valuerrrr9sNcCsdS)zR
        Determines if the given item is contained within this specifier.
        Nr�r�itemrrrr�contains@szBaseSpecifier.containscCsdS)z�
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        Nr)r�iterablerrrr�filterFszBaseSpecifier.filter)N)N)rr
r�abc�abstractmethodrrrr�abstractpropertyr�setterr r"rrrrrs 





rc@s�eZdZiZd dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zedd��Z
edd��Zedd��Zejdd��Zdd�Zd!dd�Zd"dd�ZdS)#�_IndividualSpecifier�NcCsF|j�|�}|std�|���|�d���|�d���f|_||_dS)NzInvalid specifier: '{0}'�operator�version)�_regex�searchr�format�group�strip�_spec�_prereleases)r�specr�matchrrr�__init__Rs�z_IndividualSpecifier.__init__cCs0|jdk	rd�|j�nd}d�|jjt|�|�S)N�, prereleases={0!r}r(z<{0}({1!r}{2})>)r1r-r�	__class__r�str�rZprerrr�__repr___s���z_IndividualSpecifier.__repr__cCsdj|j�S)Nz{0}{1})r-r0rrrrrlsz_IndividualSpecifier.__str__cCs
t|j�S�N)�hashr0rrrrrosz_IndividualSpecifier.__hash__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:��
isinstancerr6r�NotImplementedr0rrrrrrs
z_IndividualSpecifier.__eq__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:r<rrrrr}s
z_IndividualSpecifier.__ne__cCst|d�|j|��S)Nz_compare_{0})�getattrr-�
_operators)r�oprrr�
_get_operator�sz"_IndividualSpecifier._get_operatorcCst|ttf�st|�}|Sr:)r=r	rr
�rr*rrr�_coerce_version�sz$_IndividualSpecifier._coerce_versioncCs
|jdS)Nr�r0rrrrr)�sz_IndividualSpecifier.operatorcCs
|jdS)NrrErrrrr*�sz_IndividualSpecifier.versioncCs|jSr:�r1rrrrr�sz _IndividualSpecifier.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:�r �rrrrr�__contains__�sz!_IndividualSpecifier.__contains__cCs:|dkr|j}|�|�}|jr&|s&dS|�|j�||j�S�NF)rrD�
is_prereleaserBr)r*rrrrr �s

z_IndividualSpecifier.containsccs�d}g}d|dk	r|ndi}|D]B}|�|�}|j|f|�r |jrX|sX|jsX|�|�q d}|Vq |s||r||D]
}|VqpdS)NFrT)rDr rKr�append)rr!rZyielded�found_prereleases�kwr*�parsed_versionrrrr"�s"
��z_IndividualSpecifier.filter)r(N)N)N)rr
rr@r4r9rrrrrBrD�propertyr)r*rr&rIr r"rrrrr'Ns(







r'c@sveZdZdZe�dedejejB�Zdddddd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�LegacySpecifiera�
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        �^\s*�\s*$�equal�	not_equal�less_than_equal�greater_than_equal�	less_than�greater_than)�==�!=�<=�>=�<�>cCst|t�stt|��}|Sr:)r=r	r7rCrrrrD�s
zLegacySpecifier._coerce_versioncCs||�|�kSr:�rD�r�prospectiver2rrr�_compare_equal�szLegacySpecifier._compare_equalcCs||�|�kSr:r`rarrr�_compare_not_equal�sz"LegacySpecifier._compare_not_equalcCs||�|�kSr:r`rarrr�_compare_less_than_equal�sz(LegacySpecifier._compare_less_than_equalcCs||�|�kSr:r`rarrr�_compare_greater_than_equalsz+LegacySpecifier._compare_greater_than_equalcCs||�|�kSr:r`rarrr�_compare_less_thansz"LegacySpecifier._compare_less_thancCs||�|�kSr:r`rarrr�_compare_greater_thansz%LegacySpecifier._compare_greater_thanN)rr
r�
_regex_str�re�compile�VERBOSE�
IGNORECASEr+r@rDrcrdrerfrgrhrrrrrQ�s(�

��	rQcst����fdd��}|S)Ncst|t�sdS�|||�SrJ)r=rra��fnrr�wrappeds
z)_require_version_compare.<locals>.wrapped)�	functools�wraps)rorprrnr�_require_version_compare
srsc	@s�eZdZdZe�dedejejB�Zdddddd	d
dd�Z	e
d
d��Ze
dd��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��Ze
dd��Zdd�Zedd��Zejdd��Zd S)!�	Specifiera
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        rRrSZ
compatiblerTrUrVrWrXrYZ	arbitrary)�~=rZr[r\r]r^r_�===cCsNd�tt�dd�t|���dd��}|d7}|�d�||�oL|�d�||�S)N�.cSs|�d�o|�d�S)NZpostZdev)�
startswith��xrrr�<lambda>�s�z/Specifier._compare_compatible.<locals>.<lambda>����.*r]rZ)�join�list�	itertools�	takewhile�_version_splitrB)rrbr2�prefixrrr�_compare_compatible�s�����zSpecifier._compare_compatiblecCsp|�d�rPt|j�}t|dd��}tt|��}|dt|��}t||�\}}nt|�}|jsht|j�}||kS)Nr}���)�endswithrZpublicr�r7�len�_pad_version�localrarrrrc�s


zSpecifier._compare_equalcCs|�||�Sr:)rcrarrrrd�szSpecifier._compare_not_equalcCs|t|�kSr:�rrarrrre�sz"Specifier._compare_less_than_equalcCs|t|�kSr:r�rarrrrf�sz%Specifier._compare_greater_than_equalcCs<t|�}||ksdS|js8|jr8t|j�t|j�kr8dSdS�NFT)rrK�base_versionrarrrrg�szSpecifier._compare_less_thancCs^t|�}||ksdS|js8|jr8t|j�t|j�kr8dS|jdk	rZt|j�t|j�krZdSdSr�)rZis_postreleaser�r�rarrrrh�s
zSpecifier._compare_greater_thancCst|���t|���kSr:)r7�lowerrarrr�_compare_arbitraryszSpecifier._compare_arbitrarycCsR|jdk	r|jS|j\}}|dkrN|dkr@|�d�r@|dd�}t|�jrNdSdS)N)rZr]r\rurvrZr}r�TF)r1r0r�r
rK)rr)r*rrrrs


zSpecifier.prereleasescCs
||_dSr:rFrrrrrsN)rr
rrirjrkrlrmr+r@rsr�rcrdrerfrgrhr�rPrr&rrrrrtsD�_

��

"





rtz^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCs@g}|�d�D],}t�|�}|r0|�|���q|�|�q|S)Nrw)�split�
_prefix_regexr,�extend�groupsrL)r*�resultrr3rrrr�'s
r�c
Cs�gg}}|�tt�dd�|���|�tt�dd�|���|�|t|d�d��|�|t|d�d��|�ddgtdt|d�t|d���|�ddgtdt|d�t|d���ttj|��ttj|��fS)NcSs|��Sr:��isdigitryrrrr{6�z_pad_version.<locals>.<lambda>cSs|��Sr:r�ryrrrr{7r�rr�0)rLrr�r�r��insert�max�chain)�left�rightZ
left_splitZright_splitrrrr�2s 
"�"��r�c@s�eZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zedd��Z
e
jdd��Z
dd�Zddd�Zd dd�ZdS)!�SpecifierSetr(Nc	Csndd�|�d�D�}t�}|D]:}z|�t|��Wqtk
rV|�t|��YqXqt|�|_||_dS)NcSsg|]}|��r|���qSr)r/��.0�srrr�
<listcomp>Rsz)SpecifierSet.__init__.<locals>.<listcomp>�,)	r��set�addrtrrQ�	frozenset�_specsr1)rZ
specifiersrZparsed�	specifierrrrr4Os
zSpecifierSet.__init__cCs*|jdk	rd�|j�nd}d�t|�|�S)Nr5r(z<SpecifierSet({0!r}{1})>)r1r-rr7r8rrrr9ds
��zSpecifierSet.__repr__cCsd�tdd�|jD���S)Nr�css|]}t|�VqdSr:)r7r�rrr�	<genexpr>nsz'SpecifierSet.__str__.<locals>.<genexpr>)r~�sortedr�rrrrrmszSpecifierSet.__str__cCs
t|j�Sr:)r;r�rrrrrpszSpecifierSet.__hash__cCs�t|t�rt|�}nt|t�s"tSt�}t|j|jB�|_|jdkrX|jdk	rX|j|_n<|jdk	rv|jdkrv|j|_n|j|jkr�|j|_ntd��|S)NzFCannot combine SpecifierSets with True and False prerelease overrides.)r=rr�r>r�r�r1�
ValueError)rrr�rrr�__and__ss 





�zSpecifierSet.__and__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:�r=rr�r'r7r>r�rrrrr�s



zSpecifierSet.__eq__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:r�rrrrr�s



zSpecifierSet.__ne__cCs
t|j�Sr:)r�r�rrrr�__len__�szSpecifierSet.__len__cCs
t|j�Sr:)�iterr�rrrr�__iter__�szSpecifierSet.__iter__cCs.|jdk	r|jS|jsdStdd�|jD��S)Ncss|]}|jVqdSr:�rr�rrrr��sz+SpecifierSet.prereleases.<locals>.<genexpr>)r1r��anyrrrrr�s

zSpecifierSet.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:rGrHrrrrI�szSpecifierSet.__contains__csLt�ttf�st����dkr$|j��s2�jr2dSt��fdd�|jD��S)NFc3s|]}|j��d�VqdS)r�NrGr��rrrrr��s�z(SpecifierSet.contains.<locals>.<genexpr>)r=r	rr
rrK�allr�rrr�rr �s
�zSpecifierSet.containscCs�|dkr|j}|jr6|jD]}|j|t|�d�}q|Sg}g}|D]P}t|ttf�s^t|�}n|}t|t�rnqB|jr�|s�|s�|�	|�qB|�	|�qB|s�|r�|dkr�|S|SdS)Nr�)
rr�r"�boolr=r	rr
rKrL)rr!rr2ZfilteredrMrrOrrrr"�s*



zSpecifierSet.filter)r(N)N)N)rr
rr4r9rrr�rrr�r�rPrr&rIr r"rrrrr�Ms 
	




r�)Z
__future__rrrr#rqr�rjZ_compatrrr*rr	r
r�r�ABCMeta�objectrr'rQrsrtrkr�r�r�r�rrrr�<module>s&9	4	
site-packages/setuptools/_vendor/packaging/__pycache__/_compat.cpython-38.pyc000064400000001722151446177000023356 0ustar00U

�Qab\�@sVddlmZmZmZddlZejddkZejddkZerDefZ	ne
fZ	dd�ZdS)�)�absolute_import�division�print_functionN��cs&G��fdd�d��}t�|ddi�S)z/
    Create a base class with a metaclass.
    cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�S)N�)�cls�nameZ
this_bases�d��bases�metar�H/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py�__new__sz)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__�__qualname__rrrrr�	metaclasssrZtemporary_classr)�typer)r
rrrrr�with_metaclasssr)Z
__future__rrr�sys�version_infoZPY2ZPY3�strZstring_typesZ
basestringrrrrr�<module>ssite-packages/setuptools/_vendor/packaging/__pycache__/_compat.cpython-38.opt-1.pyc000064400000001722151446177000024315 0ustar00U

�Qab\�@sVddlmZmZmZddlZejddkZejddkZerDefZ	ne
fZ	dd�ZdS)�)�absolute_import�division�print_functionN��cs&G��fdd�d��}t�|ddi�S)z/
    Create a base class with a metaclass.
    cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�S)N�)�cls�nameZ
this_bases�d��bases�metar�H/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/_compat.py�__new__sz)with_metaclass.<locals>.metaclass.__new__N)�__name__�
__module__�__qualname__rrrrr�	metaclasssrZtemporary_classr)�typer)r
rrrrr�with_metaclasssr)Z
__future__rrr�sys�version_infoZPY2ZPY3�strZstring_typesZ
basestringrrrrr�<module>ssite-packages/setuptools/_vendor/packaging/__pycache__/utils.cpython-38.opt-1.pyc000064400000000717151446177000024036 0ustar00U

�Qab��@s2ddlmZmZmZddlZe�d�Zdd�ZdS)�)�absolute_import�division�print_functionNz[-_.]+cCst�d|���S)N�-)�_canonicalize_regex�sub�lower)�name�r
�F/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py�canonicalize_namesr)Z
__future__rrr�re�compilerrr
r
r
r�<module>s
site-packages/setuptools/_vendor/packaging/__pycache__/markers.cpython-38.opt-1.pyc000064400000021154151446177000024340 0ustar00U

�Qab/ �	@s@ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
mZmZddlm
Z
mZmZmZddlmZddlmZddlmZmZd	d
ddd
gZGdd	�d	e�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�Z Gdd�de�Z!ed�ed�Bed�Bed�Bed�Bed�Bed�Bed �Bed!�Bed"�Bed#�Bed$�Bed%�Bed&�Bed'�Bed(�Bed)�Bed*�BZ"d#d"ddddd+�Z#e"�$d,d-��ed.�ed/�Bed0�Bed1�Bed2�Bed3�Bed4�Bed5�BZ%e%ed6�Bed7�BZ&e&�$d8d-��ed9�ed:�BZ'e'�$d;d-��ed<�ed=�BZ(e"e'BZ)ee)e&e)�Z*e*�$d>d-��ed?��+�Z,ed@��+�Z-e�Z.e*ee,e.e-�BZ/e.e/e
e(e.�>ee.eZ0dAdB�Z1dSdDdE�Z2dFd-�dGd-�ej3ej4ej5ej6ej7ej8dH�Z9dIdJ�Z:e�Z;dKdL�Z<dMdN�Z=dOdP�Z>dQd
�Z?GdRd�de�Z@dS)T�)�absolute_import�division�print_functionN)�ParseException�ParseResults�stringStart�	stringEnd)�
ZeroOrMore�Group�Forward�QuotedString)�Literal�)�string_types)�	Specifier�InvalidSpecifier�
InvalidMarker�UndefinedComparison�UndefinedEnvironmentName�Marker�default_environmentc@seZdZdZdS)rzE
    An invalid marker was found, users should refer to PEP 508.
    N��__name__�
__module__�__qualname__�__doc__�rr�H/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.pyrsc@seZdZdZdS)rzP
    An invalid operation was attempted on a value that doesn't support it.
    Nrrrrrrsc@seZdZdZdS)rz\
    A name was attempted to be used that does not exist inside of the
    environment.
    Nrrrrrr%sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�NodecCs
||_dS�N)�value)�selfr rrr�__init__.sz
Node.__init__cCs
t|j�Sr)�strr �r!rrr�__str__1szNode.__str__cCsd�|jjt|��S)Nz<{0}({1!r})>)�format�	__class__rr#r$rrr�__repr__4sz
Node.__repr__cCst�dSr)�NotImplementedErrorr$rrr�	serialize7szNode.serializeN)rrrr"r%r(r*rrrrr,src@seZdZdd�ZdS)�VariablecCst|�Sr�r#r$rrrr*=szVariable.serializeN�rrrr*rrrrr+;sr+c@seZdZdd�ZdS)�ValuecCs
d�|�S)Nz"{0}")r&r$rrrr*CszValue.serializeNr-rrrrr.Asr.c@seZdZdd�ZdS)�OpcCst|�Srr,r$rrrr*IszOp.serializeNr-rrrrr/Gsr/�implementation_version�platform_python_implementation�implementation_name�python_full_version�platform_release�platform_version�platform_machine�platform_system�python_version�sys_platform�os_name�os.name�sys.platform�platform.version�platform.machine�platform.python_implementation�python_implementationZextra)r;r<r=r>r?r@cCstt�|d|d��S�Nr)r+�ALIASES�get��s�l�trrr�<lambda>i�rHz===�==�>=�<=�!=z~=�>�<�not in�incCst|d�SrA)r/rDrrrrHwrI�'�"cCst|d�SrA)r.rDrrrrHzrI�and�orcCst|d�SrA)�tuplerDrrrrH�rI�(�)cCs t|t�rdd�|D�S|SdS)NcSsg|]}t|��qSr)�_coerce_parse_result)�.0�irrr�
<listcomp>�sz(_coerce_parse_result.<locals>.<listcomp>)�
isinstancer)�resultsrrrrY�s
rYTcCs�t|t�r4t|�dkr4t|dttf�r4t|d�St|t�rndd�|D�}|rZd�|�Sdd�|�dSn"t|t�r�d�dd	�|D��S|SdS)
Nrrcss|]}t|dd�VqdS)F)�firstN)�_format_marker�rZ�mrrr�	<genexpr>�sz!_format_marker.<locals>.<genexpr>� rWrXcSsg|]}|���qSr)r*rarrrr\�sz"_format_marker.<locals>.<listcomp>)r]�list�lenrVr`�join)�markerr_�innerrrrr`�s�


r`cCs||kSrr��lhs�rhsrrrrH�rIcCs||kSrrrjrrrrH�rI)rQrPrOrLrJrMrKrNcCslztd�|��|g��}Wntk
r.YnX|�|�St�|���}|dkrbtd�|||���|||�S)N�z#Undefined {0!r} on {1!r} and {2!r}.)	rrgr*r�contains�
_operatorsrCrr&)rk�oprl�specZoperrrr�_eval_op�s
�rrcCs&|�|t�}|tkr"td�|���|S)Nz/{0!r} does not exist in evaluation environment.)rC�
_undefinedrr&)�environment�namer rrr�_get_env�s�rvc	Cs�gg}|D]�}t|t�r.|d�t||��q
t|t�r�|\}}}t|t�r`t||j�}|j}n|j}t||j�}|d�t|||��q
|dkr
|�g�q
t	dd�|D��S)N���rUcss|]}t|�VqdSr)�all)rZ�itemrrrrc�sz$_evaluate_markers.<locals>.<genexpr>)
r]re�append�_evaluate_markersrVr+rvr rr�any)	Zmarkersrt�groupsrhrkrprlZ	lhs_valueZ	rhs_valuerrrr{�s



r{cCs2d�|�}|j}|dkr.||dt|j�7}|S)Nz{0.major}.{0.minor}.{0.micro}�finalr)r&�releaselevelr#�serial)�info�versionZkindrrr�format_full_version�s

r�cCslttd�r ttjj�}tjj}nd}d}||tjt��t�	�t�
�t��t��t��t��dd�tjd�S)N�implementation�0rm�)r2r0r:r6r4r7r5r3r1r8r9)
�hasattr�sysr�r�r�ru�os�platform�machine�release�systemr8r@)Ziverr2rrrr�s"

�c@s.eZdZdd�Zdd�Zdd�Zd
dd	�ZdS)rc
Cs`ztt�|��|_WnFtk
rZ}z(d�|||j|jd��}t|��W5d}~XYnXdS)Nz+Invalid marker: {0!r}, parse error at {1!r}�)rY�MARKERZparseString�_markersrr&Zlocr)r!rh�eZerr_strrrrr"s�zMarker.__init__cCs
t|j�Sr)r`r�r$rrrr%szMarker.__str__cCsd�t|��S)Nz<Marker({0!r})>)r&r#r$rrrr(szMarker.__repr__NcCs$t�}|dk	r|�|�t|j|�S)a$Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        N)r�updater{r�)r!rtZcurrent_environmentrrr�evaluate s	
zMarker.evaluate)N)rrrr"r%r(r�rrrrrs)T)AZ
__future__rrr�operatorr�r�r�Zsetuptools.extern.pyparsingrrrrr	r
rrr
�LZ_compatrZ
specifiersrr�__all__�
ValueErrorrrr�objectrr+r.r/ZVARIABLErBZsetParseActionZVERSION_CMPZ	MARKER_OPZMARKER_VALUEZBOOLOPZ
MARKER_VARZMARKER_ITEM�suppressZLPARENZRPARENZMARKER_EXPRZMARKER_ATOMr�rYr`�lt�le�eq�ne�ge�gtrorrrsrvr{r�rrrrrr�<module>s����������	�
���
���������������
�site-packages/setuptools/_vendor/packaging/__pycache__/requirements.cpython-38.pyc000064400000007435151446177000024466 0ustar00U

�Qab��@srddlmZmZmZddlZddlZddlmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZddlmZddlmZddlmZmZdd	lmZmZmZGd
d�de�Zeejej�Z ed��!�Z"ed
��!�Z#ed��!�Z$ed��!�Z%ed��!�Z&ed��!�Z'ed��!�Z(ed�Z)e ee)�e BZ*ee ee*��Z+e+d�Z,e+Z-ed�d�Z.e(e.Z/e-ee&e-�Z0e"e
e0�e#d�Z1eej2ej3ej4B�Z5eej2ej3ej4B�Z6e5e6AZ7ee7ee&e7�ddd�d�Z8e
e$e8e%e8B�Z9e9�:dd��e	e9�d�Z;e;�:dd��e	e��d�Ze�:d d��e'Z<e<eZ=e;e
e=�Z>e/e
e=�Z?e,e
e1�e?e>BZ@ee@eZAGd!d"�d"eB�ZCdS)#�)�absolute_import�division�print_functionN)�stringStart�	stringEnd�originalTextFor�ParseException)�
ZeroOrMore�Word�Optional�Regex�Combine)�Literal)�parse�)�MARKER_EXPR�Marker)�LegacySpecifier�	Specifier�SpecifierSetc@seZdZdZdS)�InvalidRequirementzJ
    An invalid requirement was found, users should refer to PEP 508.
    N)�__name__�
__module__�__qualname__�__doc__�rr�M/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.pyrsr�[�]�(�)�,�;�@z-_.�namez[^ ]+�url�extrasF)Z
joinStringZadjacent�	_raw_speccCs
|jpdS)N�)r'��s�l�trrr�<lambda>6�r-�	specifiercCs|dS)Nrrr)rrrr-9r.�markercCst||j|j��S)N)rZ_original_startZ
_original_endr)rrrr-=r.c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Requirementz�Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    c
Cs�zt�|�}Wn@tk
rN}z"td�||j|jd����W5d}~XYnX|j|_|jr�t�|j�}|j	r�|j
r�|j	s�|j
s�td��|j|_nd|_t|jr�|j�
�ng�|_t|j�|_|jr�|jnd|_dS)Nz+Invalid requirement, parse error at "{0!r}"�zInvalid URL given)�REQUIREMENTZparseStringrr�formatZlocr$r%�urlparseZschemeZnetloc�setr&ZasListrr/r0)�selfZrequirement_stringZreq�eZ
parsed_urlrrr�__init__Xs,����
zRequirement.__init__cCsz|jg}|jr*|�d�d�t|j����|jr@|�t|j��|jrX|�d�|j��|j	rp|�d�|j	��d�|�S)Nz[{0}]r!z@ {0}z; {0}r()
r$r&�appendr4�join�sortedr/�strr%r0)r7�partsrrr�__str__mszRequirement.__str__cCsd�t|��S)Nz<Requirement({0!r})>)r4r=)r7rrr�__repr__~szRequirement.__repr__N)rrrrr9r?r@rrrrr1Ksr1)DZ
__future__rrr�string�reZsetuptools.extern.pyparsingrrrrr	r
rrr
r�LZ"setuptools.extern.six.moves.urllibrr5ZmarkersrrZ
specifiersrrr�
ValueErrorrZ
ascii_lettersZdigitsZALPHANUM�suppressZLBRACKETZRBRACKETZLPARENZRPAREN�COMMAZ	SEMICOLON�ATZPUNCTUATIONZIDENTIFIER_ENDZ
IDENTIFIER�NAMEZEXTRAZURIZURLZEXTRAS_LISTZEXTRASZ
_regex_str�VERBOSE�
IGNORECASEZVERSION_PEP440ZVERSION_LEGACYZVERSION_ONEZVERSION_MANYZ
_VERSION_SPECZsetParseActionZVERSION_SPECZMARKER_SEPERATORZMARKERZVERSION_AND_MARKERZURL_AND_MARKERZNAMED_REQUIREMENTr3�objectr1rrrr�<module>sf����site-packages/setuptools/_vendor/packaging/__pycache__/_structures.cpython-38.opt-1.pyc000064400000005310151446177000025252 0ustar00U

�Qab��@sDddlmZmZmZGdd�de�Ze�ZGdd�de�Ze�ZdS)�)�absolute_import�division�print_functionc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)�InfinitycCsdS)Nr���selfrr�L/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py�__repr__	szInfinity.__repr__cCstt|��S�N��hash�reprrrrr	�__hash__szInfinity.__hash__cCsdS�NFr�r�otherrrr	�__lt__szInfinity.__lt__cCsdSrrrrrr	�__le__szInfinity.__le__cCst||j�Sr��
isinstance�	__class__rrrr	�__eq__szInfinity.__eq__cCst||j�Srrrrrr	�__ne__szInfinity.__ne__cCsdS�NTrrrrr	�__gt__szInfinity.__gt__cCsdSrrrrrr	�__ge__szInfinity.__ge__cCstSr)�NegativeInfinityrrrr	�__neg__!szInfinity.__neg__N��__name__�
__module__�__qualname__r
rrrrrrrrrrrr	rsrc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)rcCsdS)Nz	-Infinityrrrrr	r
)szNegativeInfinity.__repr__cCstt|��Srrrrrr	r,szNegativeInfinity.__hash__cCsdSrrrrrr	r/szNegativeInfinity.__lt__cCsdSrrrrrr	r2szNegativeInfinity.__le__cCst||j�Srrrrrr	r5szNegativeInfinity.__eq__cCst||j�Srrrrrr	r8szNegativeInfinity.__ne__cCsdSrrrrrr	r;szNegativeInfinity.__gt__cCsdSrrrrrr	r>szNegativeInfinity.__ge__cCstSr)rrrrr	rAszNegativeInfinity.__neg__Nrrrrr	r'srN)Z
__future__rrr�objectrrrrrr	�<module>ssite-packages/setuptools/_vendor/packaging/__pycache__/version.cpython-38.pyc000064400000024607151446177000023430 0ustar00U

�Qab$-�	@s�ddlmZmZmZddlZddlZddlZddlmZddddd	gZ	e�
d
ddd
dddg�Zdd�ZGdd�de
�ZGdd�de�ZGdd�de�Ze�dej�Zdddddd�Zdd�Zdd�ZdZGd d�de�Zd!d"�Ze�d#�Zd$d%�Zd&d'�ZdS)(�)�absolute_import�division�print_functionN�)�Infinity�parse�Version�
LegacyVersion�InvalidVersion�VERSION_PATTERN�_Version�epoch�release�dev�pre�post�localcCs,z
t|�WStk
r&t|�YSXdS)z�
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    N)rr
r	)�version�r�H/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.pyrs
c@seZdZdZdS)r
zF
    An invalid version was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__rrrrr
$sc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)�_BaseVersioncCs
t|j�S�N)�hash�_key��selfrrr�__hash__,sz_BaseVersion.__hash__cCs|�|dd��S)NcSs||kSrr��s�orrr�<lambda>0�z%_BaseVersion.__lt__.<locals>.<lambda>��_compare�r�otherrrr�__lt__/sz_BaseVersion.__lt__cCs|�|dd��S)NcSs||kSrrr!rrrr$3r%z%_BaseVersion.__le__.<locals>.<lambda>r&r(rrr�__le__2sz_BaseVersion.__le__cCs|�|dd��S)NcSs||kSrrr!rrrr$6r%z%_BaseVersion.__eq__.<locals>.<lambda>r&r(rrr�__eq__5sz_BaseVersion.__eq__cCs|�|dd��S)NcSs||kSrrr!rrrr$9r%z%_BaseVersion.__ge__.<locals>.<lambda>r&r(rrr�__ge__8sz_BaseVersion.__ge__cCs|�|dd��S)NcSs||kSrrr!rrrr$<r%z%_BaseVersion.__gt__.<locals>.<lambda>r&r(rrr�__gt__;sz_BaseVersion.__gt__cCs|�|dd��S)NcSs||kSrrr!rrrr$?r%z%_BaseVersion.__ne__.<locals>.<lambda>r&r(rrr�__ne__>sz_BaseVersion.__ne__cCst|t�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr)�methodrrrr'As
z_BaseVersion._compareN)rrrr r*r+r,r-r.r/r'rrrrr*src@s`eZdZdd�Zdd�Zdd�Zedd��Zed	d
��Zedd��Z	ed
d��Z
edd��ZdS)r	cCst|�|_t|j�|_dSr)�str�_version�_legacy_cmpkeyr)rrrrr�__init__Js
zLegacyVersion.__init__cCs|jSr�r4rrrr�__str__NszLegacyVersion.__str__cCsd�tt|���S)Nz<LegacyVersion({0})>��format�reprr3rrrr�__repr__QszLegacyVersion.__repr__cCs|jSrr7rrrr�publicTszLegacyVersion.publiccCs|jSrr7rrrr�base_versionXszLegacyVersion.base_versioncCsdSrrrrrrr\szLegacyVersion.localcCsdS�NFrrrrr�
is_prerelease`szLegacyVersion.is_prereleasecCsdSr?rrrrr�is_postreleasedszLegacyVersion.is_postreleaseN)rrrr6r8r<�propertyr=r>rr@rArrrrr	Hs



z(\d+ | [a-z]+ | \.| -)�czfinal-�@)r�preview�-�rcrccs\t�|�D]F}t�||�}|r
|dkr(q
|dd�dkrF|�d�Vq
d|Vq
dVdS)N�.r�
0123456789��*�*final)�_legacy_version_component_re�split�_legacy_version_replacement_map�get�zfill)r"�partrrr�_parse_version_partsrsrScCszd}g}t|���D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�}||fS)N���rKrLz*final-Z00000000)rS�lower�
startswith�pop�append�tuple)rr
�partsrRrrrr5�s


r5a�
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
c@s|eZdZe�dedejejB�Zdd�Z	dd�Z
dd�Zed	d
��Z
edd��Zed
d��Zedd��Zedd��ZdS)rz^\s*z\s*$c
Cs�|j�|�}|std�|���t|�d�r8t|�d��ndtdd�|�d��d�D��t	|�d�|�d	��t	|�d
�|�d�p�|�d��t	|�d
�|�d��t
|�d��d�|_t|jj
|jj|jj|jj|jj|jj�|_dS)NzInvalid version: '{0}'r
rcss|]}t|�VqdSr)�int��.0�irrr�	<genexpr>�sz#Version.__init__.<locals>.<genexpr>rrHZpre_lZpre_nZpost_lZpost_n1Zpost_n2Zdev_lZdev_nr�r
rrrrr)�_regex�searchr
r:r�groupr[rYrN�_parse_letter_version�_parse_local_versionr4�_cmpkeyr
rrrrrr)rr�matchrrrr6�s8�����zVersion.__init__cCsd�tt|���S)Nz<Version({0})>r9rrrrr<�szVersion.__repr__cCs�g}|jjdkr$|�d�|jj��|�d�dd�|jjD���|jjdk	rl|�d�dd�|jjD���|jjdk	r�|�d�|jjd	��|jjdk	r�|�d
�|jjd	��|jj	dk	r�|�d�d�dd�|jj	D����d�|�S)
Nr�{0}!rHcss|]}t|�VqdSr�r3�r]�xrrrr_�sz"Version.__str__.<locals>.<genexpr>�css|]}t|�VqdSrrirjrrrr_�sz.post{0}rz.dev{0}z+{0}css|]}t|�VqdSrrirjrrrr_s)
r4r
rXr:�joinrrrrr�rrZrrrr8�s�zVersion.__str__cCst|��dd�dS)N�+rr�r3rNrrrrr=
szVersion.publiccCsLg}|jjdkr$|�d�|jj��|�d�dd�|jjD���d�|�S)NrrhrHcss|]}t|�VqdSrrirjrrrr_sz'Version.base_version.<locals>.<genexpr>rl)r4r
rXr:rmrrnrrrr>s
zVersion.base_versioncCs$t|�}d|kr |�dd�dSdS)Nrorrp)rZversion_stringrrrrsz
Version.localcCst|jjp|jj�Sr)�boolr4rrrrrrr@!szVersion.is_prereleasecCst|jj�Sr)rqr4rrrrrrA%szVersion.is_postreleaseN)rrr�re�compiler�VERBOSE�
IGNORECASErar6r<r8rBr=r>rr@rArrrrr�s"

�#



cCsv|rZ|dkrd}|��}|dkr&d}n(|dkr4d}n|dkrBd}n|dkrNd	}|t|�fS|sr|rrd	}|t|�fSdS)
NrZalpha�aZbeta�b)rCrrErG)Zrev�rr)rUr[)ZletterZnumberrrrrd*s rdz[\._-]cCs$|dk	r tdd�t�|�D��SdS)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Ncss&|]}|��s|��nt|�VqdSr)�isdigitrUr[)r]rRrrrr_Qs�z'_parse_local_version.<locals>.<genexpr>)rY�_local_version_seperatorsrN)rrrrreLs�recCs�tttt�dd�t|�����}|dkr@|dkr@|dk	r@t}n|dkrLt}|dkrZt}|dkrft}|dkrvt}ntdd�|D��}||||||fS)NcSs|dkS)Nrr)rkrrrr$`r%z_cmpkey.<locals>.<lambda>css*|]"}t|t�r|dfnt|fVqdS)rlN)r0r[rr\rrrr_�s�z_cmpkey.<locals>.<genexpr>)rY�reversed�list�	itertools�	dropwhilerr`rrrrfWs,���
	�rf)Z
__future__rrr�collectionsr}rrZ_structuresr�__all__�
namedtuplerr�
ValueErrorr
�objectrr	rsrtrMrOrSr5rrrdrzrerfrrrr�<module>sH��!�� k
site-packages/setuptools/_vendor/packaging/__pycache__/__about__.cpython-38.opt-1.pyc000064400000001300151446177000024571 0ustar00U

�Qab��@sPddlmZmZmZdddddddd	gZd
ZdZdZd
ZdZ	dZ
dZde	ZdS)�)�absolute_import�division�print_function�	__title__�__summary__�__uri__�__version__�
__author__�	__email__�__license__�
__copyright__Z	packagingz"Core utilities for Python packagesz!https://github.com/pypa/packagingz16.8z)Donald Stufft and individual contributorszdonald@stufft.ioz"BSD or Apache License, Version 2.0zCopyright 2014-2016 %sN)
Z
__future__rrr�__all__rrrrr	r
rr�rr�J/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py�<module>s"�site-packages/setuptools/_vendor/packaging/__pycache__/__about__.cpython-38.pyc000064400000001300151446177000023632 0ustar00U

�Qab��@sPddlmZmZmZdddddddd	gZd
ZdZdZd
ZdZ	dZ
dZde	ZdS)�)�absolute_import�division�print_function�	__title__�__summary__�__uri__�__version__�
__author__�	__email__�__license__�
__copyright__Z	packagingz"Core utilities for Python packagesz!https://github.com/pypa/packagingz16.8z)Donald Stufft and individual contributorszdonald@stufft.ioz"BSD or Apache License, Version 2.0zCopyright 2014-2016 %sN)
Z
__future__rrr�__all__rrrrr	r
rr�rr�J/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/__about__.py�<module>s"�site-packages/setuptools/_vendor/packaging/__pycache__/utils.cpython-38.pyc000064400000000717151446177000023077 0ustar00U

�Qab��@s2ddlmZmZmZddlZe�d�Zdd�ZdS)�)�absolute_import�division�print_functionNz[-_.]+cCst�d|���S)N�-)�_canonicalize_regex�sub�lower)�name�r
�F/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/utils.py�canonicalize_namesr)Z
__future__rrr�re�compilerrr
r
r
r�<module>s
site-packages/setuptools/_vendor/packaging/__pycache__/markers.cpython-38.pyc000064400000021321151446177000023375 0ustar00U

�Qab/ �	@s@ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
mZmZddlm
Z
mZmZmZddlmZddlmZddlmZmZd	d
ddd
gZGdd	�d	e�ZGdd
�d
e�ZGdd�de�ZGdd�de�ZGdd�de�ZGdd�de�Z Gdd�de�Z!ed�ed�Bed�Bed�Bed�Bed�Bed�Bed �Bed!�Bed"�Bed#�Bed$�Bed%�Bed&�Bed'�Bed(�Bed)�Bed*�BZ"d#d"ddddd+�Z#e"�$d,d-��ed.�ed/�Bed0�Bed1�Bed2�Bed3�Bed4�Bed5�BZ%e%ed6�Bed7�BZ&e&�$d8d-��ed9�ed:�BZ'e'�$d;d-��ed<�ed=�BZ(e"e'BZ)ee)e&e)�Z*e*�$d>d-��ed?��+�Z,ed@��+�Z-e�Z.e*ee,e.e-�BZ/e.e/e
e(e.�>ee.eZ0dAdB�Z1dSdDdE�Z2dFd-�dGd-�ej3ej4ej5ej6ej7ej8dH�Z9dIdJ�Z:e�Z;dKdL�Z<dMdN�Z=dOdP�Z>dQd
�Z?GdRd�de�Z@dS)T�)�absolute_import�division�print_functionN)�ParseException�ParseResults�stringStart�	stringEnd)�
ZeroOrMore�Group�Forward�QuotedString)�Literal�)�string_types)�	Specifier�InvalidSpecifier�
InvalidMarker�UndefinedComparison�UndefinedEnvironmentName�Marker�default_environmentc@seZdZdZdS)rzE
    An invalid marker was found, users should refer to PEP 508.
    N��__name__�
__module__�__qualname__�__doc__�rr�H/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/markers.pyrsc@seZdZdZdS)rzP
    An invalid operation was attempted on a value that doesn't support it.
    Nrrrrrrsc@seZdZdZdS)rz\
    A name was attempted to be used that does not exist inside of the
    environment.
    Nrrrrrr%sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�NodecCs
||_dS�N)�value)�selfr rrr�__init__.sz
Node.__init__cCs
t|j�Sr)�strr �r!rrr�__str__1szNode.__str__cCsd�|jjt|��S)Nz<{0}({1!r})>)�format�	__class__rr#r$rrr�__repr__4sz
Node.__repr__cCst�dSr)�NotImplementedErrorr$rrr�	serialize7szNode.serializeN)rrrr"r%r(r*rrrrr,src@seZdZdd�ZdS)�VariablecCst|�Sr�r#r$rrrr*=szVariable.serializeN�rrrr*rrrrr+;sr+c@seZdZdd�ZdS)�ValuecCs
d�|�S)Nz"{0}")r&r$rrrr*CszValue.serializeNr-rrrrr.Asr.c@seZdZdd�ZdS)�OpcCst|�Srr,r$rrrr*IszOp.serializeNr-rrrrr/Gsr/�implementation_version�platform_python_implementation�implementation_name�python_full_version�platform_release�platform_version�platform_machine�platform_system�python_version�sys_platform�os_name�os.name�sys.platform�platform.version�platform.machine�platform.python_implementation�python_implementationZextra)r;r<r=r>r?r@cCstt�|d|d��S�Nr)r+�ALIASES�get��s�l�trrr�<lambda>i�rHz===�==�>=�<=�!=z~=�>�<�not in�incCst|d�SrA)r/rDrrrrHwrI�'�"cCst|d�SrA)r.rDrrrrHzrI�and�orcCst|d�SrA)�tuplerDrrrrH�rI�(�)cCs t|t�rdd�|D�S|SdS)NcSsg|]}t|��qSr)�_coerce_parse_result)�.0�irrr�
<listcomp>�sz(_coerce_parse_result.<locals>.<listcomp>)�
isinstancer)�resultsrrrrY�s
rYTcCs�t|tttf�st�t|t�rHt|�dkrHt|dttf�rHt|d�St|t�r�dd�|D�}|rnd�|�Sdd�|�dSn"t|t�r�d�dd	�|D��S|SdS)
Nrrcss|]}t|dd�VqdS)F)�firstN)�_format_marker�rZ�mrrr�	<genexpr>�sz!_format_marker.<locals>.<genexpr>� rWrXcSsg|]}|���qSr)r*rarrrr\�sz"_format_marker.<locals>.<listcomp>)r]�listrVr�AssertionError�lenr`�join)�markerr_�innerrrrr`�s�


r`cCs||kSrr��lhs�rhsrrrrH�rIcCs||kSrrrkrrrrH�rI)rQrPrOrLrJrMrKrNcCslztd�|��|g��}Wntk
r.YnX|�|�St�|���}|dkrbtd�|||���|||�S)N�z#Undefined {0!r} on {1!r} and {2!r}.)	rrhr*r�contains�
_operatorsrCrr&)rl�oprm�specZoperrrr�_eval_op�s
�rscCs&|�|t�}|tkr"td�|���|S)Nz/{0!r} does not exist in evaluation environment.)rC�
_undefinedrr&)�environment�namer rrr�_get_env�s�rwc	Cs�gg}|D]�}t|tttf�s"t�t|t�rB|d�t||��q
t|t�r�|\}}}t|t�rtt||j	�}|j	}n|j	}t||j	�}|d�t
|||��q
|dks�t�|dkr
|�g�q
tdd�|D��S)N���)rTrUrUcss|]}t|�VqdSr)�all)rZ�itemrrrrc�sz$_evaluate_markers.<locals>.<genexpr>)r]rerVrrf�append�_evaluate_markersr+rwr rs�any)	Zmarkersru�groupsrirlrqrmZ	lhs_valueZ	rhs_valuerrrr|�s"



r|cCs2d�|�}|j}|dkr.||dt|j�7}|S)Nz{0.major}.{0.minor}.{0.micro}�finalr)r&�releaselevelr#�serial)�info�versionZkindrrr�format_full_version�s

r�cCslttd�r ttjj�}tjj}nd}d}||tjt��t�	�t�
�t��t��t��t��dd�tjd�S)N�implementation�0rn�)r2r0r:r6r4r7r5r3r1r8r9)
�hasattr�sysr�r�r�rv�os�platform�machine�release�systemr8r@)Ziverr2rrrr�s"

�c@s.eZdZdd�Zdd�Zdd�Zd
dd	�ZdS)rc
Cs`ztt�|��|_WnFtk
rZ}z(d�|||j|jd��}t|��W5d}~XYnXdS)Nz+Invalid marker: {0!r}, parse error at {1!r}�)rY�MARKERZparseString�_markersrr&Zlocr)r!ri�eZerr_strrrrr"s�zMarker.__init__cCs
t|j�Sr)r`r�r$rrrr%szMarker.__str__cCsd�t|��S)Nz<Marker({0!r})>)r&r#r$rrrr(szMarker.__repr__NcCs$t�}|dk	r|�|�t|j|�S)a$Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        N)r�updater|r�)r!ruZcurrent_environmentrrr�evaluate s	
zMarker.evaluate)N)rrrr"r%r(r�rrrrrs)T)AZ
__future__rrr�operatorr�r�r�Zsetuptools.extern.pyparsingrrrrr	r
rrr
�LZ_compatrZ
specifiersrr�__all__�
ValueErrorrrr�objectrr+r.r/ZVARIABLErBZsetParseActionZVERSION_CMPZ	MARKER_OPZMARKER_VALUEZBOOLOPZ
MARKER_VARZMARKER_ITEM�suppressZLPARENZRPARENZMARKER_EXPRZMARKER_ATOMr�rYr`�lt�le�eq�ne�ge�gtrprsrtrwr|r�rrrrrr�<module>s����������	�
���
���������������
�site-packages/setuptools/_vendor/packaging/__pycache__/requirements.cpython-38.opt-1.pyc000064400000007435151446177000025425 0ustar00U

�Qab��@srddlmZmZmZddlZddlZddlmZmZm	Z	m
Z
ddlmZmZm
Z
mZmZddlmZddlmZddlmZmZdd	lmZmZmZGd
d�de�Zeejej�Z ed��!�Z"ed
��!�Z#ed��!�Z$ed��!�Z%ed��!�Z&ed��!�Z'ed��!�Z(ed�Z)e ee)�e BZ*ee ee*��Z+e+d�Z,e+Z-ed�d�Z.e(e.Z/e-ee&e-�Z0e"e
e0�e#d�Z1eej2ej3ej4B�Z5eej2ej3ej4B�Z6e5e6AZ7ee7ee&e7�ddd�d�Z8e
e$e8e%e8B�Z9e9�:dd��e	e9�d�Z;e;�:dd��e	e��d�Ze�:d d��e'Z<e<eZ=e;e
e=�Z>e/e
e=�Z?e,e
e1�e?e>BZ@ee@eZAGd!d"�d"eB�ZCdS)#�)�absolute_import�division�print_functionN)�stringStart�	stringEnd�originalTextFor�ParseException)�
ZeroOrMore�Word�Optional�Regex�Combine)�Literal)�parse�)�MARKER_EXPR�Marker)�LegacySpecifier�	Specifier�SpecifierSetc@seZdZdZdS)�InvalidRequirementzJ
    An invalid requirement was found, users should refer to PEP 508.
    N)�__name__�
__module__�__qualname__�__doc__�rr�M/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/requirements.pyrsr�[�]�(�)�,�;�@z-_.�namez[^ ]+�url�extrasF)Z
joinStringZadjacent�	_raw_speccCs
|jpdS)N�)r'��s�l�trrr�<lambda>6�r-�	specifiercCs|dS)Nrrr)rrrr-9r.�markercCst||j|j��S)N)rZ_original_startZ
_original_endr)rrrr-=r.c@s(eZdZdZdd�Zdd�Zdd�ZdS)	�Requirementz�Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    c
Cs�zt�|�}Wn@tk
rN}z"td�||j|jd����W5d}~XYnX|j|_|jr�t�|j�}|j	r�|j
r�|j	s�|j
s�td��|j|_nd|_t|jr�|j�
�ng�|_t|j�|_|jr�|jnd|_dS)Nz+Invalid requirement, parse error at "{0!r}"�zInvalid URL given)�REQUIREMENTZparseStringrr�formatZlocr$r%�urlparseZschemeZnetloc�setr&ZasListrr/r0)�selfZrequirement_stringZreq�eZ
parsed_urlrrr�__init__Xs,����
zRequirement.__init__cCsz|jg}|jr*|�d�d�t|j����|jr@|�t|j��|jrX|�d�|j��|j	rp|�d�|j	��d�|�S)Nz[{0}]r!z@ {0}z; {0}r()
r$r&�appendr4�join�sortedr/�strr%r0)r7�partsrrr�__str__mszRequirement.__str__cCsd�t|��S)Nz<Requirement({0!r})>)r4r=)r7rrr�__repr__~szRequirement.__repr__N)rrrrr9r?r@rrrrr1Ksr1)DZ
__future__rrr�string�reZsetuptools.extern.pyparsingrrrrr	r
rrr
r�LZ"setuptools.extern.six.moves.urllibrr5ZmarkersrrZ
specifiersrrr�
ValueErrorrZ
ascii_lettersZdigitsZALPHANUM�suppressZLBRACKETZRBRACKETZLPARENZRPAREN�COMMAZ	SEMICOLON�ATZPUNCTUATIONZIDENTIFIER_ENDZ
IDENTIFIER�NAMEZEXTRAZURIZURLZEXTRAS_LISTZEXTRASZ
_regex_str�VERBOSE�
IGNORECASEZVERSION_PEP440ZVERSION_LEGACYZVERSION_ONEZVERSION_MANYZ
_VERSION_SPECZsetParseActionZVERSION_SPECZMARKER_SEPERATORZMARKERZVERSION_AND_MARKERZURL_AND_MARKERZNAMED_REQUIREMENTr3�objectr1rrrr�<module>sf����site-packages/setuptools/_vendor/packaging/__pycache__/specifiers.cpython-38.opt-1.pyc000064400000046510151446177000025033 0ustar00U

�Qabym�@s�ddlmZmZmZddlZddlZddlZddlZddlm	Z	m
Z
ddlmZm
Z
mZGdd�de�ZGdd	�d	e
eje��ZGd
d�de�ZGdd
�d
e�Zdd�ZGdd�de�Ze�d�Zdd�Zdd�ZGdd�de�ZdS)�)�absolute_import�division�print_functionN�)�string_types�with_metaclass)�Version�
LegacyVersion�parsec@seZdZdZdS)�InvalidSpecifierzH
    An invalid specifier was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__�rr�K/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/specifiers.pyrsrc@s�eZdZejdd��Zejdd��Zejdd��Zejdd��Zej	d	d
��Z
e
jdd
��Z
ejdd
d��Zejddd��Z
dS)�
BaseSpecifiercCsdS)z�
        Returns the str representation of this Specifier like object. This
        should be representative of the Specifier itself.
        Nr��selfrrr�__str__szBaseSpecifier.__str__cCsdS)zF
        Returns a hash value for this Specifier like object.
        Nrrrrr�__hash__szBaseSpecifier.__hash__cCsdS)zq
        Returns a boolean representing whether or not the two Specifier like
        objects are equal.
        Nr�r�otherrrr�__eq__$szBaseSpecifier.__eq__cCsdS)zu
        Returns a boolean representing whether or not the two Specifier like
        objects are not equal.
        Nrrrrr�__ne__+szBaseSpecifier.__ne__cCsdS)zg
        Returns whether or not pre-releases as a whole are allowed by this
        specifier.
        Nrrrrr�prereleases2szBaseSpecifier.prereleasescCsdS)zd
        Sets whether or not pre-releases as a whole are allowed by this
        specifier.
        Nr�r�valuerrrr9sNcCsdS)zR
        Determines if the given item is contained within this specifier.
        Nr�r�itemrrrr�contains@szBaseSpecifier.containscCsdS)z�
        Takes an iterable of items and filters them so that only items which
        are contained within this specifier are allowed in it.
        Nr)r�iterablerrrr�filterFszBaseSpecifier.filter)N)N)rr
r�abc�abstractmethodrrrr�abstractpropertyr�setterr r"rrrrrs 





rc@s�eZdZiZd dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zedd��Z
edd��Zedd��Zejdd��Zdd�Zd!dd�Zd"dd�ZdS)#�_IndividualSpecifier�NcCsF|j�|�}|std�|���|�d���|�d���f|_||_dS)NzInvalid specifier: '{0}'�operator�version)�_regex�searchr�format�group�strip�_spec�_prereleases)r�specr�matchrrr�__init__Rs�z_IndividualSpecifier.__init__cCs0|jdk	rd�|j�nd}d�|jjt|�|�S)N�, prereleases={0!r}r(z<{0}({1!r}{2})>)r1r-r�	__class__r�str�rZprerrr�__repr___s���z_IndividualSpecifier.__repr__cCsdj|j�S)Nz{0}{1})r-r0rrrrrlsz_IndividualSpecifier.__str__cCs
t|j�S�N)�hashr0rrrrrosz_IndividualSpecifier.__hash__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:��
isinstancerr6r�NotImplementedr0rrrrrrs
z_IndividualSpecifier.__eq__cCsPt|t�r4z|�|�}WqDtk
r0tYSXnt||j�sDtS|j|jkSr:r<rrrrr}s
z_IndividualSpecifier.__ne__cCst|d�|j|��S)Nz_compare_{0})�getattrr-�
_operators)r�oprrr�
_get_operator�sz"_IndividualSpecifier._get_operatorcCst|ttf�st|�}|Sr:)r=r	rr
�rr*rrr�_coerce_version�sz$_IndividualSpecifier._coerce_versioncCs
|jdS)Nr�r0rrrrr)�sz_IndividualSpecifier.operatorcCs
|jdS)NrrErrrrr*�sz_IndividualSpecifier.versioncCs|jSr:�r1rrrrr�sz _IndividualSpecifier.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:�r �rrrrr�__contains__�sz!_IndividualSpecifier.__contains__cCs:|dkr|j}|�|�}|jr&|s&dS|�|j�||j�S�NF)rrD�
is_prereleaserBr)r*rrrrr �s

z_IndividualSpecifier.containsccs�d}g}d|dk	r|ndi}|D]B}|�|�}|j|f|�r |jrX|sX|jsX|�|�q d}|Vq |s||r||D]
}|VqpdS)NFrT)rDr rKr�append)rr!rZyielded�found_prereleases�kwr*�parsed_versionrrrr"�s"
��z_IndividualSpecifier.filter)r(N)N)N)rr
rr@r4r9rrrrrBrD�propertyr)r*rr&rIr r"rrrrr'Ns(







r'c@sveZdZdZe�dedejejB�Zdddddd	d
�Z	dd�Z
d
d�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)�LegacySpecifiera�
        (?P<operator>(==|!=|<=|>=|<|>))
        \s*
        (?P<version>
            [^,;\s)]* # Since this is a "legacy" specifier, and the version
                      # string can be just about anything, we match everything
                      # except for whitespace, a semi-colon for marker support,
                      # a closing paren since versions can be enclosed in
                      # them, and a comma since it's a version separator.
        )
        �^\s*�\s*$�equal�	not_equal�less_than_equal�greater_than_equal�	less_than�greater_than)�==�!=�<=�>=�<�>cCst|t�stt|��}|Sr:)r=r	r7rCrrrrD�s
zLegacySpecifier._coerce_versioncCs||�|�kSr:�rD�r�prospectiver2rrr�_compare_equal�szLegacySpecifier._compare_equalcCs||�|�kSr:r`rarrr�_compare_not_equal�sz"LegacySpecifier._compare_not_equalcCs||�|�kSr:r`rarrr�_compare_less_than_equal�sz(LegacySpecifier._compare_less_than_equalcCs||�|�kSr:r`rarrr�_compare_greater_than_equalsz+LegacySpecifier._compare_greater_than_equalcCs||�|�kSr:r`rarrr�_compare_less_thansz"LegacySpecifier._compare_less_thancCs||�|�kSr:r`rarrr�_compare_greater_thansz%LegacySpecifier._compare_greater_thanN)rr
r�
_regex_str�re�compile�VERBOSE�
IGNORECASEr+r@rDrcrdrerfrgrhrrrrrQ�s(�

��	rQcst����fdd��}|S)Ncst|t�sdS�|||�SrJ)r=rra��fnrr�wrappeds
z)_require_version_compare.<locals>.wrapped)�	functools�wraps)rorprrnr�_require_version_compare
srsc	@s�eZdZdZe�dedejejB�Zdddddd	d
dd�Z	e
d
d��Ze
dd��Ze
dd��Z
e
dd��Ze
dd��Ze
dd��Ze
dd��Zdd�Zedd��Zejdd��Zd S)!�	Specifiera
        (?P<operator>(~=|==|!=|<=|>=|<|>|===))
        (?P<version>
            (?:
                # The identity operators allow for an escape hatch that will
                # do an exact string match of the version you wish to install.
                # This will not be parsed by PEP 440 and we cannot determine
                # any semantic meaning from it. This operator is discouraged
                # but included entirely as an escape hatch.
                (?<====)  # Only match for the identity operator
                \s*
                [^\s]*    # We just match everything, except for whitespace
                          # since we are only testing for strict identity.
            )
            |
            (?:
                # The (non)equality operators allow for wild card and local
                # versions to be specified so we have to define these two
                # operators separately to enable that.
                (?<===|!=)            # Only match for equals and not equals

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?

                # You cannot use a wild card and a dev or local version
                # together so group them with a | and make them optional.
                (?:
                    (?:[-_\.]?dev[-_\.]?[0-9]*)?         # dev release
                    (?:\+[a-z0-9]+(?:[-_\.][a-z0-9]+)*)? # local
                    |
                    \.\*  # Wild card syntax of .*
                )?
            )
            |
            (?:
                # The compatible operator requires at least two digits in the
                # release segment.
                (?<=~=)               # Only match for the compatible operator

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)+   # release  (We have a + instead of a *)
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
            |
            (?:
                # All other operators only allow a sub set of what the
                # (non)equality operators do. Specifically they do not allow
                # local versions to be specified nor do they allow the prefix
                # matching wild cards.
                (?<!==|!=|~=)         # We have special cases for these
                                      # operators so we want to make sure they
                                      # don't match here.

                \s*
                v?
                (?:[0-9]+!)?          # epoch
                [0-9]+(?:\.[0-9]+)*   # release
                (?:                   # pre release
                    [-_\.]?
                    (a|b|c|rc|alpha|beta|pre|preview)
                    [-_\.]?
                    [0-9]*
                )?
                (?:                                   # post release
                    (?:-[0-9]+)|(?:[-_\.]?(post|rev|r)[-_\.]?[0-9]*)
                )?
                (?:[-_\.]?dev[-_\.]?[0-9]*)?          # dev release
            )
        )
        rRrSZ
compatiblerTrUrVrWrXrYZ	arbitrary)�~=rZr[r\r]r^r_�===cCsNd�tt�dd�t|���dd��}|d7}|�d�||�oL|�d�||�S)N�.cSs|�d�o|�d�S)NZpostZdev)�
startswith��xrrr�<lambda>�s�z/Specifier._compare_compatible.<locals>.<lambda>����.*r]rZ)�join�list�	itertools�	takewhile�_version_splitrB)rrbr2�prefixrrr�_compare_compatible�s�����zSpecifier._compare_compatiblecCsp|�d�rPt|j�}t|dd��}tt|��}|dt|��}t||�\}}nt|�}|jsht|j�}||kS)Nr}���)�endswithrZpublicr�r7�len�_pad_version�localrarrrrc�s


zSpecifier._compare_equalcCs|�||�Sr:)rcrarrrrd�szSpecifier._compare_not_equalcCs|t|�kSr:�rrarrrre�sz"Specifier._compare_less_than_equalcCs|t|�kSr:r�rarrrrf�sz%Specifier._compare_greater_than_equalcCs<t|�}||ksdS|js8|jr8t|j�t|j�kr8dSdS�NFT)rrK�base_versionrarrrrg�szSpecifier._compare_less_thancCs^t|�}||ksdS|js8|jr8t|j�t|j�kr8dS|jdk	rZt|j�t|j�krZdSdSr�)rZis_postreleaser�r�rarrrrh�s
zSpecifier._compare_greater_thancCst|���t|���kSr:)r7�lowerrarrr�_compare_arbitraryszSpecifier._compare_arbitrarycCsR|jdk	r|jS|j\}}|dkrN|dkr@|�d�r@|dd�}t|�jrNdSdS)N)rZr]r\rurvrZr}r�TF)r1r0r�r
rK)rr)r*rrrrs


zSpecifier.prereleasescCs
||_dSr:rFrrrrrsN)rr
rrirjrkrlrmr+r@rsr�rcrdrerfrgrhr�rPrr&rrrrrtsD�_

��

"





rtz^([0-9]+)((?:a|b|c|rc)[0-9]+)$cCs@g}|�d�D],}t�|�}|r0|�|���q|�|�q|S)Nrw)�split�
_prefix_regexr,�extend�groupsrL)r*�resultrr3rrrr�'s
r�c
Cs�gg}}|�tt�dd�|���|�tt�dd�|���|�|t|d�d��|�|t|d�d��|�ddgtdt|d�t|d���|�ddgtdt|d�t|d���ttj|��ttj|��fS)NcSs|��Sr:��isdigitryrrrr{6�z_pad_version.<locals>.<lambda>cSs|��Sr:r�ryrrrr{7r�rr�0)rLrr�r�r��insert�max�chain)�left�rightZ
left_splitZright_splitrrrr�2s 
"�"��r�c@s�eZdZddd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Zdd�Z	dd�Z
dd�Zedd��Z
e
jdd��Z
dd�Zddd�Zd dd�ZdS)!�SpecifierSetr(Nc	Csndd�|�d�D�}t�}|D]:}z|�t|��Wqtk
rV|�t|��YqXqt|�|_||_dS)NcSsg|]}|��r|���qSr)r/��.0�srrr�
<listcomp>Rsz)SpecifierSet.__init__.<locals>.<listcomp>�,)	r��set�addrtrrQ�	frozenset�_specsr1)rZ
specifiersrZparsed�	specifierrrrr4Os
zSpecifierSet.__init__cCs*|jdk	rd�|j�nd}d�t|�|�S)Nr5r(z<SpecifierSet({0!r}{1})>)r1r-rr7r8rrrr9ds
��zSpecifierSet.__repr__cCsd�tdd�|jD���S)Nr�css|]}t|�VqdSr:)r7r�rrr�	<genexpr>nsz'SpecifierSet.__str__.<locals>.<genexpr>)r~�sortedr�rrrrrmszSpecifierSet.__str__cCs
t|j�Sr:)r;r�rrrrrpszSpecifierSet.__hash__cCs�t|t�rt|�}nt|t�s"tSt�}t|j|jB�|_|jdkrX|jdk	rX|j|_n<|jdk	rv|jdkrv|j|_n|j|jkr�|j|_ntd��|S)NzFCannot combine SpecifierSets with True and False prerelease overrides.)r=rr�r>r�r�r1�
ValueError)rrr�rrr�__and__ss 





�zSpecifierSet.__and__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:�r=rr�r'r7r>r�rrrrr�s



zSpecifierSet.__eq__cCsFt|t�rt|�}n&t|t�r,tt|��}nt|t�s:tS|j|jkSr:r�rrrrr�s



zSpecifierSet.__ne__cCs
t|j�Sr:)r�r�rrrr�__len__�szSpecifierSet.__len__cCs
t|j�Sr:)�iterr�rrrr�__iter__�szSpecifierSet.__iter__cCs.|jdk	r|jS|jsdStdd�|jD��S)Ncss|]}|jVqdSr:�rr�rrrr��sz+SpecifierSet.prereleases.<locals>.<genexpr>)r1r��anyrrrrr�s

zSpecifierSet.prereleasescCs
||_dSr:rFrrrrr�scCs
|�|�Sr:rGrHrrrrI�szSpecifierSet.__contains__csLt�ttf�st����dkr$|j��s2�jr2dSt��fdd�|jD��S)NFc3s|]}|j��d�VqdS)r�NrGr��rrrrr��s�z(SpecifierSet.contains.<locals>.<genexpr>)r=r	rr
rrK�allr�rrr�rr �s
�zSpecifierSet.containscCs�|dkr|j}|jr6|jD]}|j|t|�d�}q|Sg}g}|D]P}t|ttf�s^t|�}n|}t|t�rnqB|jr�|s�|s�|�	|�qB|�	|�qB|s�|r�|dkr�|S|SdS)Nr�)
rr�r"�boolr=r	rr
rKrL)rr!rr2ZfilteredrMrrOrrrr"�s*



zSpecifierSet.filter)r(N)N)N)rr
rr4r9rrr�rrr�r�rPrr&rIr r"rrrrr�Ms 
	




r�)Z
__future__rrrr#rqr�rjZ_compatrrr*rr	r
r�r�ABCMeta�objectrr'rQrsrtrkr�r�r�r�rrrr�<module>s&9	4	
site-packages/setuptools/_vendor/packaging/__pycache__/version.cpython-38.opt-1.pyc000064400000024607151446177000024367 0ustar00U

�Qab$-�	@s�ddlmZmZmZddlZddlZddlZddlmZddddd	gZ	e�
d
ddd
dddg�Zdd�ZGdd�de
�ZGdd�de�ZGdd�de�Ze�dej�Zdddddd�Zdd�Zdd�ZdZGd d�de�Zd!d"�Ze�d#�Zd$d%�Zd&d'�ZdS)(�)�absolute_import�division�print_functionN�)�Infinity�parse�Version�
LegacyVersion�InvalidVersion�VERSION_PATTERN�_Version�epoch�release�dev�pre�post�localcCs,z
t|�WStk
r&t|�YSXdS)z�
    Parse the given version string and return either a :class:`Version` object
    or a :class:`LegacyVersion` object depending on if the given version is
    a valid PEP 440 version or a legacy version.
    N)rr
r	)�version�r�H/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/version.pyrs
c@seZdZdZdS)r
zF
    An invalid version was found, users should refer to PEP 440.
    N)�__name__�
__module__�__qualname__�__doc__rrrrr
$sc@sLeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dS)�_BaseVersioncCs
t|j�S�N)�hash�_key��selfrrr�__hash__,sz_BaseVersion.__hash__cCs|�|dd��S)NcSs||kSrr��s�orrr�<lambda>0�z%_BaseVersion.__lt__.<locals>.<lambda>��_compare�r�otherrrr�__lt__/sz_BaseVersion.__lt__cCs|�|dd��S)NcSs||kSrrr!rrrr$3r%z%_BaseVersion.__le__.<locals>.<lambda>r&r(rrr�__le__2sz_BaseVersion.__le__cCs|�|dd��S)NcSs||kSrrr!rrrr$6r%z%_BaseVersion.__eq__.<locals>.<lambda>r&r(rrr�__eq__5sz_BaseVersion.__eq__cCs|�|dd��S)NcSs||kSrrr!rrrr$9r%z%_BaseVersion.__ge__.<locals>.<lambda>r&r(rrr�__ge__8sz_BaseVersion.__ge__cCs|�|dd��S)NcSs||kSrrr!rrrr$<r%z%_BaseVersion.__gt__.<locals>.<lambda>r&r(rrr�__gt__;sz_BaseVersion.__gt__cCs|�|dd��S)NcSs||kSrrr!rrrr$?r%z%_BaseVersion.__ne__.<locals>.<lambda>r&r(rrr�__ne__>sz_BaseVersion.__ne__cCst|t�stS||j|j�Sr)�
isinstancer�NotImplementedr)rr)�methodrrrr'As
z_BaseVersion._compareN)rrrr r*r+r,r-r.r/r'rrrrr*src@s`eZdZdd�Zdd�Zdd�Zedd��Zed	d
��Zedd��Z	ed
d��Z
edd��ZdS)r	cCst|�|_t|j�|_dSr)�str�_version�_legacy_cmpkeyr)rrrrr�__init__Js
zLegacyVersion.__init__cCs|jSr�r4rrrr�__str__NszLegacyVersion.__str__cCsd�tt|���S)Nz<LegacyVersion({0})>��format�reprr3rrrr�__repr__QszLegacyVersion.__repr__cCs|jSrr7rrrr�publicTszLegacyVersion.publiccCs|jSrr7rrrr�base_versionXszLegacyVersion.base_versioncCsdSrrrrrrr\szLegacyVersion.localcCsdS�NFrrrrr�
is_prerelease`szLegacyVersion.is_prereleasecCsdSr?rrrrr�is_postreleasedszLegacyVersion.is_postreleaseN)rrrr6r8r<�propertyr=r>rr@rArrrrr	Hs



z(\d+ | [a-z]+ | \.| -)�czfinal-�@)r�preview�-�rcrccs\t�|�D]F}t�||�}|r
|dkr(q
|dd�dkrF|�d�Vq
d|Vq
dVdS)N�.r�
0123456789��*�*final)�_legacy_version_component_re�split�_legacy_version_replacement_map�get�zfill)r"�partrrr�_parse_version_partsrsrScCszd}g}t|���D]T}|�d�r^|dkrD|rD|ddkrD|��q*|r^|ddkr^|��qD|�|�qt|�}||fS)N���rKrLz*final-Z00000000)rS�lower�
startswith�pop�append�tuple)rr
�partsrRrrrr5�s


r5a�
    v?
    (?:
        (?:(?P<epoch>[0-9]+)!)?                           # epoch
        (?P<release>[0-9]+(?:\.[0-9]+)*)                  # release segment
        (?P<pre>                                          # pre-release
            [-_\.]?
            (?P<pre_l>(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P<pre_n>[0-9]+)?
        )?
        (?P<post>                                         # post release
            (?:-(?P<post_n1>[0-9]+))
            |
            (?:
                [-_\.]?
                (?P<post_l>post|rev|r)
                [-_\.]?
                (?P<post_n2>[0-9]+)?
            )
        )?
        (?P<dev>                                          # dev release
            [-_\.]?
            (?P<dev_l>dev)
            [-_\.]?
            (?P<dev_n>[0-9]+)?
        )?
    )
    (?:\+(?P<local>[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
c@s|eZdZe�dedejejB�Zdd�Z	dd�Z
dd�Zed	d
��Z
edd��Zed
d��Zedd��Zedd��ZdS)rz^\s*z\s*$c
Cs�|j�|�}|std�|���t|�d�r8t|�d��ndtdd�|�d��d�D��t	|�d�|�d	��t	|�d
�|�d�p�|�d��t	|�d
�|�d��t
|�d��d�|_t|jj
|jj|jj|jj|jj|jj�|_dS)NzInvalid version: '{0}'r
rcss|]}t|�VqdSr)�int��.0�irrr�	<genexpr>�sz#Version.__init__.<locals>.<genexpr>rrHZpre_lZpre_nZpost_lZpost_n1Zpost_n2Zdev_lZdev_nr�r
rrrrr)�_regex�searchr
r:r�groupr[rYrN�_parse_letter_version�_parse_local_versionr4�_cmpkeyr
rrrrrr)rr�matchrrrr6�s8�����zVersion.__init__cCsd�tt|���S)Nz<Version({0})>r9rrrrr<�szVersion.__repr__cCs�g}|jjdkr$|�d�|jj��|�d�dd�|jjD���|jjdk	rl|�d�dd�|jjD���|jjdk	r�|�d�|jjd	��|jjdk	r�|�d
�|jjd	��|jj	dk	r�|�d�d�dd�|jj	D����d�|�S)
Nr�{0}!rHcss|]}t|�VqdSr�r3�r]�xrrrr_�sz"Version.__str__.<locals>.<genexpr>�css|]}t|�VqdSrrirjrrrr_�sz.post{0}rz.dev{0}z+{0}css|]}t|�VqdSrrirjrrrr_s)
r4r
rXr:�joinrrrrr�rrZrrrr8�s�zVersion.__str__cCst|��dd�dS)N�+rr�r3rNrrrrr=
szVersion.publiccCsLg}|jjdkr$|�d�|jj��|�d�dd�|jjD���d�|�S)NrrhrHcss|]}t|�VqdSrrirjrrrr_sz'Version.base_version.<locals>.<genexpr>rl)r4r
rXr:rmrrnrrrr>s
zVersion.base_versioncCs$t|�}d|kr |�dd�dSdS)Nrorrp)rZversion_stringrrrrsz
Version.localcCst|jjp|jj�Sr)�boolr4rrrrrrr@!szVersion.is_prereleasecCst|jj�Sr)rqr4rrrrrrA%szVersion.is_postreleaseN)rrr�re�compiler�VERBOSE�
IGNORECASErar6r<r8rBr=r>rr@rArrrrr�s"

�#



cCsv|rZ|dkrd}|��}|dkr&d}n(|dkr4d}n|dkrBd}n|dkrNd	}|t|�fS|sr|rrd	}|t|�fSdS)
NrZalpha�aZbeta�b)rCrrErG)Zrev�rr)rUr[)ZletterZnumberrrrrd*s rdz[\._-]cCs$|dk	r tdd�t�|�D��SdS)zR
    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    Ncss&|]}|��s|��nt|�VqdSr)�isdigitrUr[)r]rRrrrr_Qs�z'_parse_local_version.<locals>.<genexpr>)rY�_local_version_seperatorsrN)rrrrreLs�recCs�tttt�dd�t|�����}|dkr@|dkr@|dk	r@t}n|dkrLt}|dkrZt}|dkrft}|dkrvt}ntdd�|D��}||||||fS)NcSs|dkS)Nrr)rkrrrr$`r%z_cmpkey.<locals>.<lambda>css*|]"}t|t�r|dfnt|fVqdS)rlN)r0r[rr\rrrr_�s�z_cmpkey.<locals>.<genexpr>)rY�reversed�list�	itertools�	dropwhilerr`rrrrfWs,���
	�rf)Z
__future__rrr�collectionsr}rrZ_structuresr�__all__�
namedtuplerr�
ValueErrorr
�objectrr	rsrtrMrOrSr5rrrdrzrerfrrrr�<module>sH��!�� k
site-packages/setuptools/_vendor/packaging/__pycache__/_structures.cpython-38.pyc000064400000005310151446177000024313 0ustar00U

�Qab��@sDddlmZmZmZGdd�de�Ze�ZGdd�de�Ze�ZdS)�)�absolute_import�division�print_functionc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)�InfinitycCsdS)Nr���selfrr�L/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/_structures.py�__repr__	szInfinity.__repr__cCstt|��S�N��hash�reprrrrr	�__hash__szInfinity.__hash__cCsdS�NFr�r�otherrrr	�__lt__szInfinity.__lt__cCsdSrrrrrr	�__le__szInfinity.__le__cCst||j�Sr��
isinstance�	__class__rrrr	�__eq__szInfinity.__eq__cCst||j�Srrrrrr	�__ne__szInfinity.__ne__cCsdS�NTrrrrr	�__gt__szInfinity.__gt__cCsdSrrrrrr	�__ge__szInfinity.__ge__cCstSr)�NegativeInfinityrrrr	�__neg__!szInfinity.__neg__N��__name__�
__module__�__qualname__r
rrrrrrrrrrrr	rsrc@sTeZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZdS)rcCsdS)Nz	-Infinityrrrrr	r
)szNegativeInfinity.__repr__cCstt|��Srrrrrr	r,szNegativeInfinity.__hash__cCsdSrrrrrr	r/szNegativeInfinity.__lt__cCsdSrrrrrr	r2szNegativeInfinity.__le__cCst||j�Srrrrrr	r5szNegativeInfinity.__eq__cCst||j�Srrrrrr	r8szNegativeInfinity.__ne__cCsdSrrrrrr	r;szNegativeInfinity.__gt__cCsdSrrrrrr	r>szNegativeInfinity.__ge__cCstSr)rrrrr	rAszNegativeInfinity.__neg__Nrrrrr	r'srN)Z
__future__rrr�objectrrrrrr	�<module>ssite-packages/setuptools/_vendor/packaging/__pycache__/__init__.cpython-38.pyc000064400000001036151446177000023471 0ustar00U

�Qab�@sTddlmZmZmZddlmZmZmZmZm	Z	m
Z
mZmZdddddd	d
dgZ
dS)
�)�absolute_import�division�print_function�)�
__author__�
__copyright__�	__email__�__license__�__summary__�	__title__�__uri__�__version__rr
rr
rrr	rN)Z
__future__rrr�	__about__rrrr	r
rrr
�__all__�rr�I/usr/lib/python3.8/site-packages/setuptools/_vendor/packaging/__init__.py�<module>s(�site-packages/setuptools/_vendor/packaging/__init__.py000064400000001001151446177000017173 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

from .__about__ import (
    __author__, __copyright__, __email__, __license__, __summary__, __title__,
    __uri__, __version__
)

__all__ = [
    "__title__", "__summary__", "__uri__", "__version__", "__author__",
    "__email__", "__license__", "__copyright__",
]
site-packages/setuptools/_vendor/packaging/markers.py000064400000020057151446177000017114 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import operator
import os
import platform
import sys

from setuptools.extern.pyparsing import ParseException, ParseResults, stringStart, stringEnd
from setuptools.extern.pyparsing import ZeroOrMore, Group, Forward, QuotedString
from setuptools.extern.pyparsing import Literal as L  # noqa

from ._compat import string_types
from .specifiers import Specifier, InvalidSpecifier


__all__ = [
    "InvalidMarker", "UndefinedComparison", "UndefinedEnvironmentName",
    "Marker", "default_environment",
]


class InvalidMarker(ValueError):
    """
    An invalid marker was found, users should refer to PEP 508.
    """


class UndefinedComparison(ValueError):
    """
    An invalid operation was attempted on a value that doesn't support it.
    """


class UndefinedEnvironmentName(ValueError):
    """
    A name was attempted to be used that does not exist inside of the
    environment.
    """


class Node(object):

    def __init__(self, value):
        self.value = value

    def __str__(self):
        return str(self.value)

    def __repr__(self):
        return "<{0}({1!r})>".format(self.__class__.__name__, str(self))

    def serialize(self):
        raise NotImplementedError


class Variable(Node):

    def serialize(self):
        return str(self)


class Value(Node):

    def serialize(self):
        return '"{0}"'.format(self)


class Op(Node):

    def serialize(self):
        return str(self)


VARIABLE = (
    L("implementation_version") |
    L("platform_python_implementation") |
    L("implementation_name") |
    L("python_full_version") |
    L("platform_release") |
    L("platform_version") |
    L("platform_machine") |
    L("platform_system") |
    L("python_version") |
    L("sys_platform") |
    L("os_name") |
    L("os.name") |  # PEP-345
    L("sys.platform") |  # PEP-345
    L("platform.version") |  # PEP-345
    L("platform.machine") |  # PEP-345
    L("platform.python_implementation") |  # PEP-345
    L("python_implementation") |  # undocumented setuptools legacy
    L("extra")
)
ALIASES = {
    'os.name': 'os_name',
    'sys.platform': 'sys_platform',
    'platform.version': 'platform_version',
    'platform.machine': 'platform_machine',
    'platform.python_implementation': 'platform_python_implementation',
    'python_implementation': 'platform_python_implementation'
}
VARIABLE.setParseAction(lambda s, l, t: Variable(ALIASES.get(t[0], t[0])))

VERSION_CMP = (
    L("===") |
    L("==") |
    L(">=") |
    L("<=") |
    L("!=") |
    L("~=") |
    L(">") |
    L("<")
)

MARKER_OP = VERSION_CMP | L("not in") | L("in")
MARKER_OP.setParseAction(lambda s, l, t: Op(t[0]))

MARKER_VALUE = QuotedString("'") | QuotedString('"')
MARKER_VALUE.setParseAction(lambda s, l, t: Value(t[0]))

BOOLOP = L("and") | L("or")

MARKER_VAR = VARIABLE | MARKER_VALUE

MARKER_ITEM = Group(MARKER_VAR + MARKER_OP + MARKER_VAR)
MARKER_ITEM.setParseAction(lambda s, l, t: tuple(t[0]))

LPAREN = L("(").suppress()
RPAREN = L(")").suppress()

MARKER_EXPR = Forward()
MARKER_ATOM = MARKER_ITEM | Group(LPAREN + MARKER_EXPR + RPAREN)
MARKER_EXPR << MARKER_ATOM + ZeroOrMore(BOOLOP + MARKER_EXPR)

MARKER = stringStart + MARKER_EXPR + stringEnd


def _coerce_parse_result(results):
    if isinstance(results, ParseResults):
        return [_coerce_parse_result(i) for i in results]
    else:
        return results


def _format_marker(marker, first=True):
    assert isinstance(marker, (list, tuple, string_types))

    # Sometimes we have a structure like [[...]] which is a single item list
    # where the single item is itself it's own list. In that case we want skip
    # the rest of this function so that we don't get extraneous () on the
    # outside.
    if (isinstance(marker, list) and len(marker) == 1 and
            isinstance(marker[0], (list, tuple))):
        return _format_marker(marker[0])

    if isinstance(marker, list):
        inner = (_format_marker(m, first=False) for m in marker)
        if first:
            return " ".join(inner)
        else:
            return "(" + " ".join(inner) + ")"
    elif isinstance(marker, tuple):
        return " ".join([m.serialize() for m in marker])
    else:
        return marker


_operators = {
    "in": lambda lhs, rhs: lhs in rhs,
    "not in": lambda lhs, rhs: lhs not in rhs,
    "<": operator.lt,
    "<=": operator.le,
    "==": operator.eq,
    "!=": operator.ne,
    ">=": operator.ge,
    ">": operator.gt,
}


def _eval_op(lhs, op, rhs):
    try:
        spec = Specifier("".join([op.serialize(), rhs]))
    except InvalidSpecifier:
        pass
    else:
        return spec.contains(lhs)

    oper = _operators.get(op.serialize())
    if oper is None:
        raise UndefinedComparison(
            "Undefined {0!r} on {1!r} and {2!r}.".format(op, lhs, rhs)
        )

    return oper(lhs, rhs)


_undefined = object()


def _get_env(environment, name):
    value = environment.get(name, _undefined)

    if value is _undefined:
        raise UndefinedEnvironmentName(
            "{0!r} does not exist in evaluation environment.".format(name)
        )

    return value


def _evaluate_markers(markers, environment):
    groups = [[]]

    for marker in markers:
        assert isinstance(marker, (list, tuple, string_types))

        if isinstance(marker, list):
            groups[-1].append(_evaluate_markers(marker, environment))
        elif isinstance(marker, tuple):
            lhs, op, rhs = marker

            if isinstance(lhs, Variable):
                lhs_value = _get_env(environment, lhs.value)
                rhs_value = rhs.value
            else:
                lhs_value = lhs.value
                rhs_value = _get_env(environment, rhs.value)

            groups[-1].append(_eval_op(lhs_value, op, rhs_value))
        else:
            assert marker in ["and", "or"]
            if marker == "or":
                groups.append([])

    return any(all(item) for item in groups)


def format_full_version(info):
    version = '{0.major}.{0.minor}.{0.micro}'.format(info)
    kind = info.releaselevel
    if kind != 'final':
        version += kind[0] + str(info.serial)
    return version


def default_environment():
    if hasattr(sys, 'implementation'):
        iver = format_full_version(sys.implementation.version)
        implementation_name = sys.implementation.name
    else:
        iver = '0'
        implementation_name = ''

    return {
        "implementation_name": implementation_name,
        "implementation_version": iver,
        "os_name": os.name,
        "platform_machine": platform.machine(),
        "platform_release": platform.release(),
        "platform_system": platform.system(),
        "platform_version": platform.version(),
        "python_full_version": platform.python_version(),
        "platform_python_implementation": platform.python_implementation(),
        "python_version": platform.python_version()[:3],
        "sys_platform": sys.platform,
    }


class Marker(object):

    def __init__(self, marker):
        try:
            self._markers = _coerce_parse_result(MARKER.parseString(marker))
        except ParseException as e:
            err_str = "Invalid marker: {0!r}, parse error at {1!r}".format(
                marker, marker[e.loc:e.loc + 8])
            raise InvalidMarker(err_str)

    def __str__(self):
        return _format_marker(self._markers)

    def __repr__(self):
        return "<Marker({0!r})>".format(str(self))

    def evaluate(self, environment=None):
        """Evaluate a marker.

        Return the boolean from evaluating the given marker against the
        environment. environment is an optional argument to override all or
        part of the determined environment.

        The environment is determined from the current Python process.
        """
        current_environment = default_environment()
        if environment is not None:
            current_environment.update(environment)

        return _evaluate_markers(self._markers, current_environment)
site-packages/setuptools/_vendor/packaging/_structures.py000064400000002610151446177000020025 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function


class Infinity(object):

    def __repr__(self):
        return "Infinity"

    def __hash__(self):
        return hash(repr(self))

    def __lt__(self, other):
        return False

    def __le__(self, other):
        return False

    def __eq__(self, other):
        return isinstance(other, self.__class__)

    def __ne__(self, other):
        return not isinstance(other, self.__class__)

    def __gt__(self, other):
        return True

    def __ge__(self, other):
        return True

    def __neg__(self):
        return NegativeInfinity

Infinity = Infinity()


class NegativeInfinity(object):

    def __repr__(self):
        return "-Infinity"

    def __hash__(self):
        return hash(repr(self))

    def __lt__(self, other):
        return True

    def __le__(self, other):
        return True

    def __eq__(self, other):
        return isinstance(other, self.__class__)

    def __ne__(self, other):
        return not isinstance(other, self.__class__)

    def __gt__(self, other):
        return False

    def __ge__(self, other):
        return False

    def __neg__(self):
        return Infinity

NegativeInfinity = NegativeInfinity()
site-packages/setuptools/_vendor/packaging/requirements.py000064400000010367151446177000020176 0ustar00# This file is dual licensed under the terms of the Apache License, Version
# 2.0, and the BSD License. See the LICENSE file in the root of this repository
# for complete details.
from __future__ import absolute_import, division, print_function

import string
import re

from setuptools.extern.pyparsing import stringStart, stringEnd, originalTextFor, ParseException
from setuptools.extern.pyparsing import ZeroOrMore, Word, Optional, Regex, Combine
from setuptools.extern.pyparsing import Literal as L  # noqa
from setuptools.extern.six.moves.urllib import parse as urlparse

from .markers import MARKER_EXPR, Marker
from .specifiers import LegacySpecifier, Specifier, SpecifierSet


class InvalidRequirement(ValueError):
    """
    An invalid requirement was found, users should refer to PEP 508.
    """


ALPHANUM = Word(string.ascii_letters + string.digits)

LBRACKET = L("[").suppress()
RBRACKET = L("]").suppress()
LPAREN = L("(").suppress()
RPAREN = L(")").suppress()
COMMA = L(",").suppress()
SEMICOLON = L(";").suppress()
AT = L("@").suppress()

PUNCTUATION = Word("-_.")
IDENTIFIER_END = ALPHANUM | (ZeroOrMore(PUNCTUATION) + ALPHANUM)
IDENTIFIER = Combine(ALPHANUM + ZeroOrMore(IDENTIFIER_END))

NAME = IDENTIFIER("name")
EXTRA = IDENTIFIER

URI = Regex(r'[^ ]+')("url")
URL = (AT + URI)

EXTRAS_LIST = EXTRA + ZeroOrMore(COMMA + EXTRA)
EXTRAS = (LBRACKET + Optional(EXTRAS_LIST) + RBRACKET)("extras")

VERSION_PEP440 = Regex(Specifier._regex_str, re.VERBOSE | re.IGNORECASE)
VERSION_LEGACY = Regex(LegacySpecifier._regex_str, re.VERBOSE | re.IGNORECASE)

VERSION_ONE = VERSION_PEP440 ^ VERSION_LEGACY
VERSION_MANY = Combine(VERSION_ONE + ZeroOrMore(COMMA + VERSION_ONE),
                       joinString=",", adjacent=False)("_raw_spec")
_VERSION_SPEC = Optional(((LPAREN + VERSION_MANY + RPAREN) | VERSION_MANY))
_VERSION_SPEC.setParseAction(lambda s, l, t: t._raw_spec or '')

VERSION_SPEC = originalTextFor(_VERSION_SPEC)("specifier")
VERSION_SPEC.setParseAction(lambda s, l, t: t[1])

MARKER_EXPR = originalTextFor(MARKER_EXPR())("marker")
MARKER_EXPR.setParseAction(
    lambda s, l, t: Marker(s[t._original_start:t._original_end])
)
MARKER_SEPERATOR = SEMICOLON
MARKER = MARKER_SEPERATOR + MARKER_EXPR

VERSION_AND_MARKER = VERSION_SPEC + Optional(MARKER)
URL_AND_MARKER = URL + Optional(MARKER)

NAMED_REQUIREMENT = \
    NAME + Optional(EXTRAS) + (URL_AND_MARKER | VERSION_AND_MARKER)

REQUIREMENT = stringStart + NAMED_REQUIREMENT + stringEnd


class Requirement(object):
    """Parse a requirement.

    Parse a given requirement string into its parts, such as name, specifier,
    URL, and extras. Raises InvalidRequirement on a badly-formed requirement
    string.
    """

    # TODO: Can we test whether something is contained within a requirement?
    #       If so how do we do that? Do we need to test against the _name_ of
    #       the thing as well as the version? What about the markers?
    # TODO: Can we normalize the name and extra name?

    def __init__(self, requirement_string):
        try:
            req = REQUIREMENT.parseString(requirement_string)
        except ParseException as e:
            raise InvalidRequirement(
                "Invalid requirement, parse error at \"{0!r}\"".format(
                    requirement_string[e.loc:e.loc + 8]))

        self.name = req.name
        if req.url:
            parsed_url = urlparse.urlparse(req.url)
            if not (parsed_url.scheme and parsed_url.netloc) or (
                    not parsed_url.scheme and not parsed_url.netloc):
                raise InvalidRequirement("Invalid URL given")
            self.url = req.url
        else:
            self.url = None
        self.extras = set(req.extras.asList() if req.extras else [])
        self.specifier = SpecifierSet(req.specifier)
        self.marker = req.marker if req.marker else None

    def __str__(self):
        parts = [self.name]

        if self.extras:
            parts.append("[{0}]".format(",".join(sorted(self.extras))))

        if self.specifier:
            parts.append(str(self.specifier))

        if self.url:
            parts.append("@ {0}".format(self.url))

        if self.marker:
            parts.append("; {0}".format(self.marker))

        return "".join(parts)

    def __repr__(self):
        return "<Requirement({0!r})>".format(str(self))
site-packages/setuptools/_vendor/six.py000064400000072622151446177000014334 0ustar00"""Utilities for writing code that runs on Python 2 and 3"""

# Copyright (c) 2010-2015 Benjamin Peterson
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.

from __future__ import absolute_import

import functools
import itertools
import operator
import sys
import types

__author__ = "Benjamin Peterson <benjamin@python.org>"
__version__ = "1.10.0"


# Useful for very coarse version differentiation.
PY2 = sys.version_info[0] == 2
PY3 = sys.version_info[0] == 3
PY34 = sys.version_info[0:2] >= (3, 4)

if PY3:
    string_types = str,
    integer_types = int,
    class_types = type,
    text_type = str
    binary_type = bytes

    MAXSIZE = sys.maxsize
else:
    string_types = basestring,
    integer_types = (int, long)
    class_types = (type, types.ClassType)
    text_type = unicode
    binary_type = str

    if sys.platform.startswith("java"):
        # Jython always uses 32 bits.
        MAXSIZE = int((1 << 31) - 1)
    else:
        # It's possible to have sizeof(long) != sizeof(Py_ssize_t).
        class X(object):

            def __len__(self):
                return 1 << 31
        try:
            len(X())
        except OverflowError:
            # 32-bit
            MAXSIZE = int((1 << 31) - 1)
        else:
            # 64-bit
            MAXSIZE = int((1 << 63) - 1)
        del X


def _add_doc(func, doc):
    """Add documentation to a function."""
    func.__doc__ = doc


def _import_module(name):
    """Import module, returning the module after the last dot."""
    __import__(name)
    return sys.modules[name]


class _LazyDescr(object):

    def __init__(self, name):
        self.name = name

    def __get__(self, obj, tp):
        result = self._resolve()
        setattr(obj, self.name, result)  # Invokes __set__.
        try:
            # This is a bit ugly, but it avoids running this again by
            # removing this descriptor.
            delattr(obj.__class__, self.name)
        except AttributeError:
            pass
        return result


class MovedModule(_LazyDescr):

    def __init__(self, name, old, new=None):
        super(MovedModule, self).__init__(name)
        if PY3:
            if new is None:
                new = name
            self.mod = new
        else:
            self.mod = old

    def _resolve(self):
        return _import_module(self.mod)

    def __getattr__(self, attr):
        _module = self._resolve()
        value = getattr(_module, attr)
        setattr(self, attr, value)
        return value


class _LazyModule(types.ModuleType):

    def __init__(self, name):
        super(_LazyModule, self).__init__(name)
        self.__doc__ = self.__class__.__doc__

    def __dir__(self):
        attrs = ["__doc__", "__name__"]
        attrs += [attr.name for attr in self._moved_attributes]
        return attrs

    # Subclasses should override this
    _moved_attributes = []


class MovedAttribute(_LazyDescr):

    def __init__(self, name, old_mod, new_mod, old_attr=None, new_attr=None):
        super(MovedAttribute, self).__init__(name)
        if PY3:
            if new_mod is None:
                new_mod = name
            self.mod = new_mod
            if new_attr is None:
                if old_attr is None:
                    new_attr = name
                else:
                    new_attr = old_attr
            self.attr = new_attr
        else:
            self.mod = old_mod
            if old_attr is None:
                old_attr = name
            self.attr = old_attr

    def _resolve(self):
        module = _import_module(self.mod)
        return getattr(module, self.attr)


class _SixMetaPathImporter(object):

    """
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    """

    def __init__(self, six_module_name):
        self.name = six_module_name
        self.known_modules = {}

    def _add_module(self, mod, *fullnames):
        for fullname in fullnames:
            self.known_modules[self.name + "." + fullname] = mod

    def _get_module(self, fullname):
        return self.known_modules[self.name + "." + fullname]

    def find_module(self, fullname, path=None):
        if fullname in self.known_modules:
            return self
        return None

    def __get_module(self, fullname):
        try:
            return self.known_modules[fullname]
        except KeyError:
            raise ImportError("This loader does not know module " + fullname)

    def load_module(self, fullname):
        try:
            # in case of a reload
            return sys.modules[fullname]
        except KeyError:
            pass
        mod = self.__get_module(fullname)
        if isinstance(mod, MovedModule):
            mod = mod._resolve()
        else:
            mod.__loader__ = self
        sys.modules[fullname] = mod
        return mod

    def is_package(self, fullname):
        """
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        """
        return hasattr(self.__get_module(fullname), "__path__")

    def get_code(self, fullname):
        """Return None

        Required, if is_package is implemented"""
        self.__get_module(fullname)  # eventually raises ImportError
        return None
    get_source = get_code  # same as get_code

_importer = _SixMetaPathImporter(__name__)


class _MovedItems(_LazyModule):

    """Lazy loading of moved objects"""
    __path__ = []  # mark as package


_moved_attributes = [
    MovedAttribute("cStringIO", "cStringIO", "io", "StringIO"),
    MovedAttribute("filter", "itertools", "builtins", "ifilter", "filter"),
    MovedAttribute("filterfalse", "itertools", "itertools", "ifilterfalse", "filterfalse"),
    MovedAttribute("input", "__builtin__", "builtins", "raw_input", "input"),
    MovedAttribute("intern", "__builtin__", "sys"),
    MovedAttribute("map", "itertools", "builtins", "imap", "map"),
    MovedAttribute("getcwd", "os", "os", "getcwdu", "getcwd"),
    MovedAttribute("getcwdb", "os", "os", "getcwd", "getcwdb"),
    MovedAttribute("range", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute("reload_module", "__builtin__", "importlib" if PY34 else "imp", "reload"),
    MovedAttribute("reduce", "__builtin__", "functools"),
    MovedAttribute("shlex_quote", "pipes", "shlex", "quote"),
    MovedAttribute("StringIO", "StringIO", "io"),
    MovedAttribute("UserDict", "UserDict", "collections"),
    MovedAttribute("UserList", "UserList", "collections"),
    MovedAttribute("UserString", "UserString", "collections"),
    MovedAttribute("xrange", "__builtin__", "builtins", "xrange", "range"),
    MovedAttribute("zip", "itertools", "builtins", "izip", "zip"),
    MovedAttribute("zip_longest", "itertools", "itertools", "izip_longest", "zip_longest"),
    MovedModule("builtins", "__builtin__"),
    MovedModule("configparser", "ConfigParser"),
    MovedModule("copyreg", "copy_reg"),
    MovedModule("dbm_gnu", "gdbm", "dbm.gnu"),
    MovedModule("_dummy_thread", "dummy_thread", "_dummy_thread"),
    MovedModule("http_cookiejar", "cookielib", "http.cookiejar"),
    MovedModule("http_cookies", "Cookie", "http.cookies"),
    MovedModule("html_entities", "htmlentitydefs", "html.entities"),
    MovedModule("html_parser", "HTMLParser", "html.parser"),
    MovedModule("http_client", "httplib", "http.client"),
    MovedModule("email_mime_multipart", "email.MIMEMultipart", "email.mime.multipart"),
    MovedModule("email_mime_nonmultipart", "email.MIMENonMultipart", "email.mime.nonmultipart"),
    MovedModule("email_mime_text", "email.MIMEText", "email.mime.text"),
    MovedModule("email_mime_base", "email.MIMEBase", "email.mime.base"),
    MovedModule("BaseHTTPServer", "BaseHTTPServer", "http.server"),
    MovedModule("CGIHTTPServer", "CGIHTTPServer", "http.server"),
    MovedModule("SimpleHTTPServer", "SimpleHTTPServer", "http.server"),
    MovedModule("cPickle", "cPickle", "pickle"),
    MovedModule("queue", "Queue"),
    MovedModule("reprlib", "repr"),
    MovedModule("socketserver", "SocketServer"),
    MovedModule("_thread", "thread", "_thread"),
    MovedModule("tkinter", "Tkinter"),
    MovedModule("tkinter_dialog", "Dialog", "tkinter.dialog"),
    MovedModule("tkinter_filedialog", "FileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_scrolledtext", "ScrolledText", "tkinter.scrolledtext"),
    MovedModule("tkinter_simpledialog", "SimpleDialog", "tkinter.simpledialog"),
    MovedModule("tkinter_tix", "Tix", "tkinter.tix"),
    MovedModule("tkinter_ttk", "ttk", "tkinter.ttk"),
    MovedModule("tkinter_constants", "Tkconstants", "tkinter.constants"),
    MovedModule("tkinter_dnd", "Tkdnd", "tkinter.dnd"),
    MovedModule("tkinter_colorchooser", "tkColorChooser",
                "tkinter.colorchooser"),
    MovedModule("tkinter_commondialog", "tkCommonDialog",
                "tkinter.commondialog"),
    MovedModule("tkinter_tkfiledialog", "tkFileDialog", "tkinter.filedialog"),
    MovedModule("tkinter_font", "tkFont", "tkinter.font"),
    MovedModule("tkinter_messagebox", "tkMessageBox", "tkinter.messagebox"),
    MovedModule("tkinter_tksimpledialog", "tkSimpleDialog",
                "tkinter.simpledialog"),
    MovedModule("urllib_parse", __name__ + ".moves.urllib_parse", "urllib.parse"),
    MovedModule("urllib_error", __name__ + ".moves.urllib_error", "urllib.error"),
    MovedModule("urllib", __name__ + ".moves.urllib", __name__ + ".moves.urllib"),
    MovedModule("urllib_robotparser", "robotparser", "urllib.robotparser"),
    MovedModule("xmlrpc_client", "xmlrpclib", "xmlrpc.client"),
    MovedModule("xmlrpc_server", "SimpleXMLRPCServer", "xmlrpc.server"),
]
# Add windows specific modules.
if sys.platform == "win32":
    _moved_attributes += [
        MovedModule("winreg", "_winreg"),
    ]

for attr in _moved_attributes:
    setattr(_MovedItems, attr.name, attr)
    if isinstance(attr, MovedModule):
        _importer._add_module(attr, "moves." + attr.name)
del attr

_MovedItems._moved_attributes = _moved_attributes

moves = _MovedItems(__name__ + ".moves")
_importer._add_module(moves, "moves")


class Module_six_moves_urllib_parse(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_parse"""


_urllib_parse_moved_attributes = [
    MovedAttribute("ParseResult", "urlparse", "urllib.parse"),
    MovedAttribute("SplitResult", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qs", "urlparse", "urllib.parse"),
    MovedAttribute("parse_qsl", "urlparse", "urllib.parse"),
    MovedAttribute("urldefrag", "urlparse", "urllib.parse"),
    MovedAttribute("urljoin", "urlparse", "urllib.parse"),
    MovedAttribute("urlparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlsplit", "urlparse", "urllib.parse"),
    MovedAttribute("urlunparse", "urlparse", "urllib.parse"),
    MovedAttribute("urlunsplit", "urlparse", "urllib.parse"),
    MovedAttribute("quote", "urllib", "urllib.parse"),
    MovedAttribute("quote_plus", "urllib", "urllib.parse"),
    MovedAttribute("unquote", "urllib", "urllib.parse"),
    MovedAttribute("unquote_plus", "urllib", "urllib.parse"),
    MovedAttribute("urlencode", "urllib", "urllib.parse"),
    MovedAttribute("splitquery", "urllib", "urllib.parse"),
    MovedAttribute("splittag", "urllib", "urllib.parse"),
    MovedAttribute("splituser", "urllib", "urllib.parse"),
    MovedAttribute("uses_fragment", "urlparse", "urllib.parse"),
    MovedAttribute("uses_netloc", "urlparse", "urllib.parse"),
    MovedAttribute("uses_params", "urlparse", "urllib.parse"),
    MovedAttribute("uses_query", "urlparse", "urllib.parse"),
    MovedAttribute("uses_relative", "urlparse", "urllib.parse"),
]
for attr in _urllib_parse_moved_attributes:
    setattr(Module_six_moves_urllib_parse, attr.name, attr)
del attr

Module_six_moves_urllib_parse._moved_attributes = _urllib_parse_moved_attributes

_importer._add_module(Module_six_moves_urllib_parse(__name__ + ".moves.urllib_parse"),
                      "moves.urllib_parse", "moves.urllib.parse")


class Module_six_moves_urllib_error(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_error"""


_urllib_error_moved_attributes = [
    MovedAttribute("URLError", "urllib2", "urllib.error"),
    MovedAttribute("HTTPError", "urllib2", "urllib.error"),
    MovedAttribute("ContentTooShortError", "urllib", "urllib.error"),
]
for attr in _urllib_error_moved_attributes:
    setattr(Module_six_moves_urllib_error, attr.name, attr)
del attr

Module_six_moves_urllib_error._moved_attributes = _urllib_error_moved_attributes

_importer._add_module(Module_six_moves_urllib_error(__name__ + ".moves.urllib.error"),
                      "moves.urllib_error", "moves.urllib.error")


class Module_six_moves_urllib_request(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_request"""


_urllib_request_moved_attributes = [
    MovedAttribute("urlopen", "urllib2", "urllib.request"),
    MovedAttribute("install_opener", "urllib2", "urllib.request"),
    MovedAttribute("build_opener", "urllib2", "urllib.request"),
    MovedAttribute("pathname2url", "urllib", "urllib.request"),
    MovedAttribute("url2pathname", "urllib", "urllib.request"),
    MovedAttribute("getproxies", "urllib", "urllib.request"),
    MovedAttribute("Request", "urllib2", "urllib.request"),
    MovedAttribute("OpenerDirector", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDefaultErrorHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPRedirectHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPCookieProcessor", "urllib2", "urllib.request"),
    MovedAttribute("ProxyHandler", "urllib2", "urllib.request"),
    MovedAttribute("BaseHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgr", "urllib2", "urllib.request"),
    MovedAttribute("HTTPPasswordMgrWithDefaultRealm", "urllib2", "urllib.request"),
    MovedAttribute("AbstractBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyBasicAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("AbstractDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("ProxyDigestAuthHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPSHandler", "urllib2", "urllib.request"),
    MovedAttribute("FileHandler", "urllib2", "urllib.request"),
    MovedAttribute("FTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("CacheFTPHandler", "urllib2", "urllib.request"),
    MovedAttribute("UnknownHandler", "urllib2", "urllib.request"),
    MovedAttribute("HTTPErrorProcessor", "urllib2", "urllib.request"),
    MovedAttribute("urlretrieve", "urllib", "urllib.request"),
    MovedAttribute("urlcleanup", "urllib", "urllib.request"),
    MovedAttribute("URLopener", "urllib", "urllib.request"),
    MovedAttribute("FancyURLopener", "urllib", "urllib.request"),
    MovedAttribute("proxy_bypass", "urllib", "urllib.request"),
]
for attr in _urllib_request_moved_attributes:
    setattr(Module_six_moves_urllib_request, attr.name, attr)
del attr

Module_six_moves_urllib_request._moved_attributes = _urllib_request_moved_attributes

_importer._add_module(Module_six_moves_urllib_request(__name__ + ".moves.urllib.request"),
                      "moves.urllib_request", "moves.urllib.request")


class Module_six_moves_urllib_response(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_response"""


_urllib_response_moved_attributes = [
    MovedAttribute("addbase", "urllib", "urllib.response"),
    MovedAttribute("addclosehook", "urllib", "urllib.response"),
    MovedAttribute("addinfo", "urllib", "urllib.response"),
    MovedAttribute("addinfourl", "urllib", "urllib.response"),
]
for attr in _urllib_response_moved_attributes:
    setattr(Module_six_moves_urllib_response, attr.name, attr)
del attr

Module_six_moves_urllib_response._moved_attributes = _urllib_response_moved_attributes

_importer._add_module(Module_six_moves_urllib_response(__name__ + ".moves.urllib.response"),
                      "moves.urllib_response", "moves.urllib.response")


class Module_six_moves_urllib_robotparser(_LazyModule):

    """Lazy loading of moved objects in six.moves.urllib_robotparser"""


_urllib_robotparser_moved_attributes = [
    MovedAttribute("RobotFileParser", "robotparser", "urllib.robotparser"),
]
for attr in _urllib_robotparser_moved_attributes:
    setattr(Module_six_moves_urllib_robotparser, attr.name, attr)
del attr

Module_six_moves_urllib_robotparser._moved_attributes = _urllib_robotparser_moved_attributes

_importer._add_module(Module_six_moves_urllib_robotparser(__name__ + ".moves.urllib.robotparser"),
                      "moves.urllib_robotparser", "moves.urllib.robotparser")


class Module_six_moves_urllib(types.ModuleType):

    """Create a six.moves.urllib namespace that resembles the Python 3 namespace"""
    __path__ = []  # mark as package
    parse = _importer._get_module("moves.urllib_parse")
    error = _importer._get_module("moves.urllib_error")
    request = _importer._get_module("moves.urllib_request")
    response = _importer._get_module("moves.urllib_response")
    robotparser = _importer._get_module("moves.urllib_robotparser")

    def __dir__(self):
        return ['parse', 'error', 'request', 'response', 'robotparser']

_importer._add_module(Module_six_moves_urllib(__name__ + ".moves.urllib"),
                      "moves.urllib")


def add_move(move):
    """Add an item to six.moves."""
    setattr(_MovedItems, move.name, move)


def remove_move(name):
    """Remove item from six.moves."""
    try:
        delattr(_MovedItems, name)
    except AttributeError:
        try:
            del moves.__dict__[name]
        except KeyError:
            raise AttributeError("no such move, %r" % (name,))


if PY3:
    _meth_func = "__func__"
    _meth_self = "__self__"

    _func_closure = "__closure__"
    _func_code = "__code__"
    _func_defaults = "__defaults__"
    _func_globals = "__globals__"
else:
    _meth_func = "im_func"
    _meth_self = "im_self"

    _func_closure = "func_closure"
    _func_code = "func_code"
    _func_defaults = "func_defaults"
    _func_globals = "func_globals"


try:
    advance_iterator = next
except NameError:
    def advance_iterator(it):
        return it.next()
next = advance_iterator


try:
    callable = callable
except NameError:
    def callable(obj):
        return any("__call__" in klass.__dict__ for klass in type(obj).__mro__)


if PY3:
    def get_unbound_function(unbound):
        return unbound

    create_bound_method = types.MethodType

    def create_unbound_method(func, cls):
        return func

    Iterator = object
else:
    def get_unbound_function(unbound):
        return unbound.im_func

    def create_bound_method(func, obj):
        return types.MethodType(func, obj, obj.__class__)

    def create_unbound_method(func, cls):
        return types.MethodType(func, None, cls)

    class Iterator(object):

        def next(self):
            return type(self).__next__(self)

    callable = callable
_add_doc(get_unbound_function,
         """Get the function out of a possibly unbound function""")


get_method_function = operator.attrgetter(_meth_func)
get_method_self = operator.attrgetter(_meth_self)
get_function_closure = operator.attrgetter(_func_closure)
get_function_code = operator.attrgetter(_func_code)
get_function_defaults = operator.attrgetter(_func_defaults)
get_function_globals = operator.attrgetter(_func_globals)


if PY3:
    def iterkeys(d, **kw):
        return iter(d.keys(**kw))

    def itervalues(d, **kw):
        return iter(d.values(**kw))

    def iteritems(d, **kw):
        return iter(d.items(**kw))

    def iterlists(d, **kw):
        return iter(d.lists(**kw))

    viewkeys = operator.methodcaller("keys")

    viewvalues = operator.methodcaller("values")

    viewitems = operator.methodcaller("items")
else:
    def iterkeys(d, **kw):
        return d.iterkeys(**kw)

    def itervalues(d, **kw):
        return d.itervalues(**kw)

    def iteritems(d, **kw):
        return d.iteritems(**kw)

    def iterlists(d, **kw):
        return d.iterlists(**kw)

    viewkeys = operator.methodcaller("viewkeys")

    viewvalues = operator.methodcaller("viewvalues")

    viewitems = operator.methodcaller("viewitems")

_add_doc(iterkeys, "Return an iterator over the keys of a dictionary.")
_add_doc(itervalues, "Return an iterator over the values of a dictionary.")
_add_doc(iteritems,
         "Return an iterator over the (key, value) pairs of a dictionary.")
_add_doc(iterlists,
         "Return an iterator over the (key, [values]) pairs of a dictionary.")


if PY3:
    def b(s):
        return s.encode("latin-1")

    def u(s):
        return s
    unichr = chr
    import struct
    int2byte = struct.Struct(">B").pack
    del struct
    byte2int = operator.itemgetter(0)
    indexbytes = operator.getitem
    iterbytes = iter
    import io
    StringIO = io.StringIO
    BytesIO = io.BytesIO
    _assertCountEqual = "assertCountEqual"
    if sys.version_info[1] <= 1:
        _assertRaisesRegex = "assertRaisesRegexp"
        _assertRegex = "assertRegexpMatches"
    else:
        _assertRaisesRegex = "assertRaisesRegex"
        _assertRegex = "assertRegex"
else:
    def b(s):
        return s
    # Workaround for standalone backslash

    def u(s):
        return unicode(s.replace(r'\\', r'\\\\'), "unicode_escape")
    unichr = unichr
    int2byte = chr

    def byte2int(bs):
        return ord(bs[0])

    def indexbytes(buf, i):
        return ord(buf[i])
    iterbytes = functools.partial(itertools.imap, ord)
    import StringIO
    StringIO = BytesIO = StringIO.StringIO
    _assertCountEqual = "assertItemsEqual"
    _assertRaisesRegex = "assertRaisesRegexp"
    _assertRegex = "assertRegexpMatches"
_add_doc(b, """Byte literal""")
_add_doc(u, """Text literal""")


def assertCountEqual(self, *args, **kwargs):
    return getattr(self, _assertCountEqual)(*args, **kwargs)


def assertRaisesRegex(self, *args, **kwargs):
    return getattr(self, _assertRaisesRegex)(*args, **kwargs)


def assertRegex(self, *args, **kwargs):
    return getattr(self, _assertRegex)(*args, **kwargs)


if PY3:
    exec_ = getattr(moves.builtins, "exec")

    def reraise(tp, value, tb=None):
        if value is None:
            value = tp()
        if value.__traceback__ is not tb:
            raise value.with_traceback(tb)
        raise value

else:
    def exec_(_code_, _globs_=None, _locs_=None):
        """Execute code in a namespace."""
        if _globs_ is None:
            frame = sys._getframe(1)
            _globs_ = frame.f_globals
            if _locs_ is None:
                _locs_ = frame.f_locals
            del frame
        elif _locs_ is None:
            _locs_ = _globs_
        exec("""exec _code_ in _globs_, _locs_""")

    exec_("""def reraise(tp, value, tb=None):
    raise tp, value, tb
""")


if sys.version_info[:2] == (3, 2):
    exec_("""def raise_from(value, from_value):
    if from_value is None:
        raise value
    raise value from from_value
""")
elif sys.version_info[:2] > (3, 2):
    exec_("""def raise_from(value, from_value):
    raise value from from_value
""")
else:
    def raise_from(value, from_value):
        raise value


print_ = getattr(moves.builtins, "print", None)
if print_ is None:
    def print_(*args, **kwargs):
        """The new-style print function for Python 2.4 and 2.5."""
        fp = kwargs.pop("file", sys.stdout)
        if fp is None:
            return

        def write(data):
            if not isinstance(data, basestring):
                data = str(data)
            # If the file has an encoding, encode unicode with it.
            if (isinstance(fp, file) and
                    isinstance(data, unicode) and
                    fp.encoding is not None):
                errors = getattr(fp, "errors", None)
                if errors is None:
                    errors = "strict"
                data = data.encode(fp.encoding, errors)
            fp.write(data)
        want_unicode = False
        sep = kwargs.pop("sep", None)
        if sep is not None:
            if isinstance(sep, unicode):
                want_unicode = True
            elif not isinstance(sep, str):
                raise TypeError("sep must be None or a string")
        end = kwargs.pop("end", None)
        if end is not None:
            if isinstance(end, unicode):
                want_unicode = True
            elif not isinstance(end, str):
                raise TypeError("end must be None or a string")
        if kwargs:
            raise TypeError("invalid keyword arguments to print()")
        if not want_unicode:
            for arg in args:
                if isinstance(arg, unicode):
                    want_unicode = True
                    break
        if want_unicode:
            newline = unicode("\n")
            space = unicode(" ")
        else:
            newline = "\n"
            space = " "
        if sep is None:
            sep = space
        if end is None:
            end = newline
        for i, arg in enumerate(args):
            if i:
                write(sep)
            write(arg)
        write(end)
if sys.version_info[:2] < (3, 3):
    _print = print_

    def print_(*args, **kwargs):
        fp = kwargs.get("file", sys.stdout)
        flush = kwargs.pop("flush", False)
        _print(*args, **kwargs)
        if flush and fp is not None:
            fp.flush()

_add_doc(reraise, """Reraise an exception.""")

if sys.version_info[0:2] < (3, 4):
    def wraps(wrapped, assigned=functools.WRAPPER_ASSIGNMENTS,
              updated=functools.WRAPPER_UPDATES):
        def wrapper(f):
            f = functools.wraps(wrapped, assigned, updated)(f)
            f.__wrapped__ = wrapped
            return f
        return wrapper
else:
    wraps = functools.wraps


def with_metaclass(meta, *bases):
    """Create a base class with a metaclass."""
    # This requires a bit of explanation: the basic idea is to make a dummy
    # metaclass for one level of class instantiation that replaces itself with
    # the actual metaclass.
    class metaclass(meta):

        def __new__(cls, name, this_bases, d):
            return meta(name, bases, d)
    return type.__new__(metaclass, 'temporary_class', (), {})


def add_metaclass(metaclass):
    """Class decorator for creating a class with a metaclass."""
    def wrapper(cls):
        orig_vars = cls.__dict__.copy()
        slots = orig_vars.get('__slots__')
        if slots is not None:
            if isinstance(slots, str):
                slots = [slots]
            for slots_var in slots:
                orig_vars.pop(slots_var)
        orig_vars.pop('__dict__', None)
        orig_vars.pop('__weakref__', None)
        return metaclass(cls.__name__, cls.__bases__, orig_vars)
    return wrapper


def python_2_unicode_compatible(klass):
    """
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    """
    if PY2:
        if '__str__' not in klass.__dict__:
            raise ValueError("@python_2_unicode_compatible cannot be applied "
                             "to %s because it doesn't define __str__()." %
                             klass.__name__)
        klass.__unicode__ = klass.__str__
        klass.__str__ = lambda self: self.__unicode__().encode('utf-8')
    return klass


# Complete the moves implementation.
# This code is at the end of this module to speed up module loading.
# Turn this module into a package.
__path__ = []  # required for PEP 302 and PEP 451
__package__ = __name__  # see PEP 366 @ReservedAssignment
if globals().get("__spec__") is not None:
    __spec__.submodule_search_locations = []  # PEP 451 @UndefinedVariable
# Remove other six meta path importers, since they cause problems. This can
# happen if six is removed from sys.modules and then reloaded. (Setuptools does
# this for some reason.)
if sys.meta_path:
    for i, importer in enumerate(sys.meta_path):
        # Here's some real nastiness: Another "instance" of the six module might
        # be floating around. Therefore, we can't use isinstance() to check for
        # the six meta path importer, since the other six instance will have
        # inserted an importer with different class.
        if (type(importer).__name__ == "_SixMetaPathImporter" and
                importer.name == __name__):
            del sys.meta_path[i]
            break
    del i, importer
# Finally, add the importer to the meta path import hook.
sys.meta_path.append(_importer)
site-packages/setuptools/_vendor/ordered_set.py000064400000035432151446177000016026 0ustar00"""
An OrderedSet is a custom MutableSet that remembers its order, so that every
entry has an index that can be looked up.

Based on a recipe originally posted to ActiveState Recipes by Raymond Hettiger,
and released under the MIT license.
"""
import itertools as it
from collections import deque

try:
    # Python 3
    from collections.abc import MutableSet, Sequence
except ImportError:
    # Python 2.7
    from collections import MutableSet, Sequence

SLICE_ALL = slice(None)
__version__ = "3.1"


def is_iterable(obj):
    """
    Are we being asked to look up a list of things, instead of a single thing?
    We check for the `__iter__` attribute so that this can cover types that
    don't have to be known by this module, such as NumPy arrays.

    Strings, however, should be considered as atomic values to look up, not
    iterables. The same goes for tuples, since they are immutable and therefore
    valid entries.

    We don't need to check for the Python 2 `unicode` type, because it doesn't
    have an `__iter__` attribute anyway.
    """
    return (
        hasattr(obj, "__iter__")
        and not isinstance(obj, str)
        and not isinstance(obj, tuple)
    )


class OrderedSet(MutableSet, Sequence):
    """
    An OrderedSet is a custom MutableSet that remembers its order, so that
    every entry has an index that can be looked up.

    Example:
        >>> OrderedSet([1, 1, 2, 3, 2])
        OrderedSet([1, 2, 3])
    """

    def __init__(self, iterable=None):
        self.items = []
        self.map = {}
        if iterable is not None:
            self |= iterable

    def __len__(self):
        """
        Returns the number of unique elements in the ordered set

        Example:
            >>> len(OrderedSet([]))
            0
            >>> len(OrderedSet([1, 2]))
            2
        """
        return len(self.items)

    def __getitem__(self, index):
        """
        Get the item at a given index.

        If `index` is a slice, you will get back that slice of items, as a
        new OrderedSet.

        If `index` is a list or a similar iterable, you'll get a list of
        items corresponding to those indices. This is similar to NumPy's
        "fancy indexing". The result is not an OrderedSet because you may ask
        for duplicate indices, and the number of elements returned should be
        the number of elements asked for.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset[1]
            2
        """
        if isinstance(index, slice) and index == SLICE_ALL:
            return self.copy()
        elif is_iterable(index):
            return [self.items[i] for i in index]
        elif hasattr(index, "__index__") or isinstance(index, slice):
            result = self.items[index]
            if isinstance(result, list):
                return self.__class__(result)
            else:
                return result
        else:
            raise TypeError("Don't know how to index an OrderedSet by %r" % index)

    def copy(self):
        """
        Return a shallow copy of this object.

        Example:
            >>> this = OrderedSet([1, 2, 3])
            >>> other = this.copy()
            >>> this == other
            True
            >>> this is other
            False
        """
        return self.__class__(self)

    def __getstate__(self):
        if len(self) == 0:
            # The state can't be an empty list.
            # We need to return a truthy value, or else __setstate__ won't be run.
            #
            # This could have been done more gracefully by always putting the state
            # in a tuple, but this way is backwards- and forwards- compatible with
            # previous versions of OrderedSet.
            return (None,)
        else:
            return list(self)

    def __setstate__(self, state):
        if state == (None,):
            self.__init__([])
        else:
            self.__init__(state)

    def __contains__(self, key):
        """
        Test if the item is in this ordered set

        Example:
            >>> 1 in OrderedSet([1, 3, 2])
            True
            >>> 5 in OrderedSet([1, 3, 2])
            False
        """
        return key in self.map

    def add(self, key):
        """
        Add `key` as an item to this OrderedSet, then return its index.

        If `key` is already in the OrderedSet, return the index it already
        had.

        Example:
            >>> oset = OrderedSet()
            >>> oset.append(3)
            0
            >>> print(oset)
            OrderedSet([3])
        """
        if key not in self.map:
            self.map[key] = len(self.items)
            self.items.append(key)
        return self.map[key]

    append = add

    def update(self, sequence):
        """
        Update the set with the given iterable sequence, then return the index
        of the last element inserted.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.update([3, 1, 5, 1, 4])
            4
            >>> print(oset)
            OrderedSet([1, 2, 3, 5, 4])
        """
        item_index = None
        try:
            for item in sequence:
                item_index = self.add(item)
        except TypeError:
            raise ValueError(
                "Argument needs to be an iterable, got %s" % type(sequence)
            )
        return item_index

    def index(self, key):
        """
        Get the index of a given entry, raising an IndexError if it's not
        present.

        `key` can be an iterable of entries that is not a string, in which case
        this returns a list of indices.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.index(2)
            1
        """
        if is_iterable(key):
            return [self.index(subkey) for subkey in key]
        return self.map[key]

    # Provide some compatibility with pd.Index
    get_loc = index
    get_indexer = index

    def pop(self):
        """
        Remove and return the last element from the set.

        Raises KeyError if the set is empty.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.pop()
            3
        """
        if not self.items:
            raise KeyError("Set is empty")

        elem = self.items[-1]
        del self.items[-1]
        del self.map[elem]
        return elem

    def discard(self, key):
        """
        Remove an element.  Do not raise an exception if absent.

        The MutableSet mixin uses this to implement the .remove() method, which
        *does* raise an error when asked to remove a non-existent item.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.discard(2)
            >>> print(oset)
            OrderedSet([1, 3])
            >>> oset.discard(2)
            >>> print(oset)
            OrderedSet([1, 3])
        """
        if key in self:
            i = self.map[key]
            del self.items[i]
            del self.map[key]
            for k, v in self.map.items():
                if v >= i:
                    self.map[k] = v - 1

    def clear(self):
        """
        Remove all items from this OrderedSet.
        """
        del self.items[:]
        self.map.clear()

    def __iter__(self):
        """
        Example:
            >>> list(iter(OrderedSet([1, 2, 3])))
            [1, 2, 3]
        """
        return iter(self.items)

    def __reversed__(self):
        """
        Example:
            >>> list(reversed(OrderedSet([1, 2, 3])))
            [3, 2, 1]
        """
        return reversed(self.items)

    def __repr__(self):
        if not self:
            return "%s()" % (self.__class__.__name__,)
        return "%s(%r)" % (self.__class__.__name__, list(self))

    def __eq__(self, other):
        """
        Returns true if the containers have the same items. If `other` is a
        Sequence, then order is checked, otherwise it is ignored.

        Example:
            >>> oset = OrderedSet([1, 3, 2])
            >>> oset == [1, 3, 2]
            True
            >>> oset == [1, 2, 3]
            False
            >>> oset == [2, 3]
            False
            >>> oset == OrderedSet([3, 2, 1])
            False
        """
        # In Python 2 deque is not a Sequence, so treat it as one for
        # consistent behavior with Python 3.
        if isinstance(other, (Sequence, deque)):
            # Check that this OrderedSet contains the same elements, in the
            # same order, as the other object.
            return list(self) == list(other)
        try:
            other_as_set = set(other)
        except TypeError:
            # If `other` can't be converted into a set, it's not equal.
            return False
        else:
            return set(self) == other_as_set

    def union(self, *sets):
        """
        Combines all unique items.
        Each items order is defined by its first appearance.

        Example:
            >>> oset = OrderedSet.union(OrderedSet([3, 1, 4, 1, 5]), [1, 3], [2, 0])
            >>> print(oset)
            OrderedSet([3, 1, 4, 5, 2, 0])
            >>> oset.union([8, 9])
            OrderedSet([3, 1, 4, 5, 2, 0, 8, 9])
            >>> oset | {10}
            OrderedSet([3, 1, 4, 5, 2, 0, 10])
        """
        cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet
        containers = map(list, it.chain([self], sets))
        items = it.chain.from_iterable(containers)
        return cls(items)

    def __and__(self, other):
        # the parent implementation of this is backwards
        return self.intersection(other)

    def intersection(self, *sets):
        """
        Returns elements in common between all sets. Order is defined only
        by the first set.

        Example:
            >>> oset = OrderedSet.intersection(OrderedSet([0, 1, 2, 3]), [1, 2, 3])
            >>> print(oset)
            OrderedSet([1, 2, 3])
            >>> oset.intersection([2, 4, 5], [1, 2, 3, 4])
            OrderedSet([2])
            >>> oset.intersection()
            OrderedSet([1, 2, 3])
        """
        cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet
        if sets:
            common = set.intersection(*map(set, sets))
            items = (item for item in self if item in common)
        else:
            items = self
        return cls(items)

    def difference(self, *sets):
        """
        Returns all elements that are in this set but not the others.

        Example:
            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]))
            OrderedSet([1, 3])
            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]), OrderedSet([3]))
            OrderedSet([1])
            >>> OrderedSet([1, 2, 3]) - OrderedSet([2])
            OrderedSet([1, 3])
            >>> OrderedSet([1, 2, 3]).difference()
            OrderedSet([1, 2, 3])
        """
        cls = self.__class__
        if sets:
            other = set.union(*map(set, sets))
            items = (item for item in self if item not in other)
        else:
            items = self
        return cls(items)

    def issubset(self, other):
        """
        Report whether another set contains this set.

        Example:
            >>> OrderedSet([1, 2, 3]).issubset({1, 2})
            False
            >>> OrderedSet([1, 2, 3]).issubset({1, 2, 3, 4})
            True
            >>> OrderedSet([1, 2, 3]).issubset({1, 4, 3, 5})
            False
        """
        if len(self) > len(other):  # Fast check for obvious cases
            return False
        return all(item in other for item in self)

    def issuperset(self, other):
        """
        Report whether this set contains another set.

        Example:
            >>> OrderedSet([1, 2]).issuperset([1, 2, 3])
            False
            >>> OrderedSet([1, 2, 3, 4]).issuperset({1, 2, 3})
            True
            >>> OrderedSet([1, 4, 3, 5]).issuperset({1, 2, 3})
            False
        """
        if len(self) < len(other):  # Fast check for obvious cases
            return False
        return all(item in self for item in other)

    def symmetric_difference(self, other):
        """
        Return the symmetric difference of two OrderedSets as a new set.
        That is, the new set will contain all elements that are in exactly
        one of the sets.

        Their order will be preserved, with elements from `self` preceding
        elements from `other`.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.symmetric_difference(other)
            OrderedSet([4, 5, 9, 2])
        """
        cls = self.__class__ if isinstance(self, OrderedSet) else OrderedSet
        diff1 = cls(self).difference(other)
        diff2 = cls(other).difference(self)
        return diff1.union(diff2)

    def _update_items(self, items):
        """
        Replace the 'items' list of this OrderedSet with a new one, updating
        self.map accordingly.
        """
        self.items = items
        self.map = {item: idx for (idx, item) in enumerate(items)}

    def difference_update(self, *sets):
        """
        Update this OrderedSet to remove items from one or more other sets.

        Example:
            >>> this = OrderedSet([1, 2, 3])
            >>> this.difference_update(OrderedSet([2, 4]))
            >>> print(this)
            OrderedSet([1, 3])

            >>> this = OrderedSet([1, 2, 3, 4, 5])
            >>> this.difference_update(OrderedSet([2, 4]), OrderedSet([1, 4, 6]))
            >>> print(this)
            OrderedSet([3, 5])
        """
        items_to_remove = set()
        for other in sets:
            items_to_remove |= set(other)
        self._update_items([item for item in self.items if item not in items_to_remove])

    def intersection_update(self, other):
        """
        Update this OrderedSet to keep only items in another set, preserving
        their order in this set.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.intersection_update(other)
            >>> print(this)
            OrderedSet([1, 3, 7])
        """
        other = set(other)
        self._update_items([item for item in self.items if item in other])

    def symmetric_difference_update(self, other):
        """
        Update this OrderedSet to remove items from another set, then
        add items from the other set that were not present in this set.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.symmetric_difference_update(other)
            >>> print(this)
            OrderedSet([4, 5, 9, 2])
        """
        items_to_add = [item for item in other if item not in self]
        items_to_remove = set(other)
        self._update_items(
            [item for item in self.items if item not in items_to_remove] + items_to_add
        )
site-packages/setuptools/_vendor/__pycache__/__init__.cpython-38.opt-1.pyc000064400000000232151446177000022501 0ustar00U

�Qab�@sdS)N�rrr�?/usr/lib/python3.8/site-packages/setuptools/_vendor/__init__.py�<module>�site-packages/setuptools/_vendor/__pycache__/six.cpython-38.pyc000064400000057553151446177000020630 0ustar00U

�Qab�u�A@sRdZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d(d#d3d2�e)d4d(e
�rd5nd6d7�e)d8d(d9�e)d:d;d<d=�e)d d d�e)d>d>d?�e)d@d@d?�e)dAdAd?�e)d3d(d#d3d2�e)dBd"d#dCdB�e)dDd"d"dEdD�e&d#d(�e&dFdG�e&dHdI�e&dJdKdL�e&dMdNdM�e&dOdPdQ�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdjdk�e&dldldk�e&dmdmdk�e&dndndo�e&dpdq�e&drds�e&dtdu�e&dvdwdv�e&dxdy�e&dzd{d|�e&d}d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g>Z.ejd�k�rRe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rVe,�3e/d�e/j1��qV[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d=d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dҡGd�dԄd�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q[/e8e7_.e,�3e7e+d��d�dۡGd�d݄d�e(�Z9e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃g!Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d��d�d�G�d�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�d	d��d�gZ<e<D]Z/e0e;e/j1e/��q8[/e<e;_.e,�3e;e+�d
��d�d�G�d
�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d�d�Z@�d�d�ZAe�	rH�dZB�dZC�dZD�dZE�dZF�dZGn$�d ZB�d!ZC�d"ZD�d#ZE�d$ZF�d%ZGzeHZIWn"eJk
�	r��d&�d'�ZIYnXeIZHzeKZKWn"eJk
�	r��d(�d)�ZKYnXe�	r�d*�d+�ZLejMZN�d,�d-�ZOeZPn>�d.�d+�ZL�d/�d0�ZN�d1�d-�ZOG�d2�d3��d3e�ZPeKZKe#eL�d4�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�
rԐd5�d6�ZX�d7�d8�ZY�d9�d:�ZZ�d;�d<�Z[e�\�d=�Z]e�\�d>�Z^e�\�d?�Z_nT�d@�d6�ZX�dA�d8�ZY�dB�d:�ZZ�dC�d<�Z[e�\�dD�Z]e�\�dE�Z^e�\�dF�Z_e#eX�dG�e#eY�dH�e#eZ�dI�e#e[�dJ�e�r�dK�dL�Z`�dM�dN�ZaebZcddldZded�e�dO�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp�dPZqej
�dQ�dQk�r�dRZr�dSZsn�dTZr�dUZsnj�dV�dL�Z`�dW�dN�ZaecZcebZg�dX�dY�Zi�dZ�d[�Zke�tejuev�ZmddloZoeojoZoZp�d\Zq�dRZr�dSZse#e`�d]�e#ea�d^��d_�dP�Zw�d`�dT�Zx�da�dU�Zye�r�eze4j{�db�Z|�d|�dc�dd�Z}n�d}�de�df�Z|e|�dg�ej
dd��dhk�r�e|�di�n.ej
dd��dhk�
re|�dj�n�dk�dl�Z~eze4j{�dmd�Zedk�
rL�dn�do�Zej
dd��dpk�
rreZ��dq�do�Ze#e}�dr�ej
dd�dk�
r�ej�ej�f�ds�dt�Z�nej�Z��du�dv�Z��dw�dx�Z��dy�dz�Z�gZ�e+Z�e�����d{�dk	�
r�ge�_�ej��rBe�ej��D]4\Z�Z�ee��j+dk�re�j1e+k�rej�e�=�q>�q[�[�ej���e,�dS(~z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.10.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�:/usr/lib/python3.8/site-packages/setuptools/_vendor/six.py�__len__>sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Xsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__[sz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrriszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrrszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__us
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'gs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr~sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__�sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4|sr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdb�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZemail_mime_basezemail.MIMEBasezemail.mime.baseZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrrt@srtZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrurrrrrwhsrwZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrurrrrry|sryZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrurrrrr{�sr{Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrurrrrr}�sr}ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacervrxrzr|r~cCsdddddgS)N�parse�error�request�responserprr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rpr8rrrrr�s




rzmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_move�sr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rs�__dict__rFrrrr�remove_move�sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iteratorsr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callablesr�cCs|Srr�Zunboundrrr�get_unbound_functionsr�cCs|Srr�r�clsrrr�create_unbound_methodsr�cCs|jSr)r�r�rrrr�"scCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_method%sr�cCst�|d|�Sr)r�r�r�rrrr�(sc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�-sz
Iterator.nextN)r
rrr�rrrrr�+sr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeys>sr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesAsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsDsr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistsGsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�PscKs|jf|�Sr)r�r�rrrr�SscKs|jf|�Sr)r�r�rrrr�VscKs|jf|�Sr)r�r�rrrr�Ys�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�bksr�cCs|Srrr�rrr�unsr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs*|dkr|�}|j|k	r"|�|��|�dSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s


r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�z9def reraise(tp, value, tb=None):
    raise tp, value, tb
)rrzrdef raise_from(value, from_value):
    if from_value is None:
        raise value
    raise value from from_value
zCdef raise_from(value, from_value):
    raise value from from_value
cCs|�dSrr)r1Z
from_valuerrr�
raise_from�sr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr��s

��zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_�sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�s

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rc�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapperszwraps.<locals>.wrapperr)r�r�r�r�rr�rr�sr�cs&G��fdd�d��}t�|ddi�S)z%Create a base class with a metaclass.cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�rZ
this_basesr���bases�metarr�__new__'sz)with_metaclass.<locals>.metaclass.__new__N)r
rrr�rr�rr�	metaclass%sr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclass sr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.csh|j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd��|j|j|�S)N�	__slots__r��__weakref__)r��copyr�rIr�r�r
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr�.s


zadd_metaclass.<locals>.wrapperr)r�r�rr�r�
add_metaclass,sr�cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nzutf-8)�__unicode__r�r	rrr�<lambda>J�z-python_2_unicode_compatible.<locals>.<lambda>)�PY2r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible<s
�
r�__spec__)N)NN)�rZ
__future__rrcrU�operatorrr��
__author__�__version__�version_inforr)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesZ	text_type�bytesZbinary_type�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArsrtZ_urllib_parse_moved_attributesrwZ_urllib_error_moved_attributesryZ _urllib_request_moved_attributesr{Z!_urllib_response_moved_attributesr}Z$_urllib_robotparser_moved_attributesrr�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�r�rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>s�

>





























��


�


�D�






















��


��
































�#�����
��





��



5��
site-packages/setuptools/_vendor/__pycache__/pyparsing.cpython-38.opt-1.pyc000064400000611637151446177000022777 0ustar00U

�Qabw��i@s�dZdZdZdZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZzddlmZWn ek
r�ddlmZYnXzdd	lmZdd
lmZWn,ek
r�dd	l
mZdd
l
mZYnXzddl
mZWnBek
�rFzddlmZWnek
�r@dZYnXYnXdd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtgiZee	j�ddu�ZeddukZ e �rpe	j!Z"e#Z$e%Z&e#Z'e(e)e*e+e,ee-e.e/e0e1gZ2n`e	j3Z"e4Z5dvdw�Z'gZ2ddl6Z6dx�7�D]8Z8ze2�9e:e6e8��Wne;k
�r�Y�q�YnX�q�e<dydz�e5d{�D��Z=d|d}�Z>Gd~d�de?�Z@ejAejBZCd�ZDeDd�ZEeCeDZFe%d��ZGd��Hd�dz�ejID��ZJGd�d#�d#eK�ZLGd�d%�d%eL�ZMGd�d'�d'eL�ZNGd�d)�d)eN�ZOGd�d,�d,eK�ZPGd�d��d�e?�ZQGd�d(�d(e?�ZRe�SeR�d�d?�ZTd�dP�ZUd�dM�ZVd�d��ZWd�d��ZXd�d��ZYd�dW�ZZ�d/d�d��Z[Gd�d*�d*e?�Z\Gd�d2�d2e\�Z]Gd�d�de]�Z^Gd�d�de]�Z_Gd�d�de]�Z`e`Zae`e\_bGd�d�de]�ZcGd�d�de`�ZdGd�d
�d
ec�ZeGd�dr�dre]�ZfGd�d5�d5e]�ZgGd�d-�d-e]�ZhGd�d+�d+e]�ZiGd�d�de]�ZjGd�d4�d4e]�ZkGd�d��d�e]�ZlGd�d�del�ZmGd�d�del�ZnGd�d�del�ZoGd�d0�d0el�ZpGd�d/�d/el�ZqGd�d7�d7el�ZrGd�d6�d6el�ZsGd�d&�d&e\�ZtGd�d�det�ZuGd�d"�d"et�ZvGd�d�det�ZwGd�d�det�ZxGd�d$�d$e\�ZyGd�d�dey�ZzGd�d�dey�Z{Gd�d��d�ey�Z|Gd�d�de|�Z}Gd�d8�d8e|�Z~Gd�d��d�e?�Ze�Z�Gd�d!�d!ey�Z�Gd�d.�d.ey�Z�Gd�d�dey�Z�Gd�dÄd�e��Z�Gd�d3�d3ey�Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d1�d1e��Z�Gd�d �d e?�Z�d�dh�Z��d0d�dF�Z��d1d�dB�Z�d�dЄZ�d�dU�Z�d�dT�Z�d�dԄZ��d2d�dY�Z�d�dG�Z��d3d�dm�Z�d�dn�Z�d�dp�Z�e^���dI�Z�en���dO�Z�eo���dN�Z�ep���dg�Z�eq���df�Z�egeGd�d�d܍��d�dބ�Z�ehd߃��d�dބ�Z�ehd���d�dބ�Z�e�e�Be�Bejd�d{d܍BZ�e�e�e�d�e��Z�e`d�e�d���d�e�e}e�e�B����d�d�Z�d�de�Z�d�dS�Z�d�db�Z�d�d`�Z�d�ds�Z�e�d�dބ�Z�e�d�dބ�Z�d�d�Z�d�dQ�Z�d�dR�Z�d�dk�Z�e?�e�_��d4d�dq�Z�e@�Z�e?�e�_�e?�e�_�e�d��e�d��fd�do�Z�e�Z�e�ehd��d����d��Z�e�ehd��d����d��Z�e�ehd��d�ehd��d�B����d�Z�e�ea�d�e�������d�Z�d�d�de���f�ddV�Z��d5�ddl�Z�e��d�Z�e��d�Z�e�egeCeF�d����d��\Z�Z�e�ed	�7��d
��Z�eh�d�d�Heàġ��d
����d�ZŐdda�Z�e�eh�d��d����d�Z�eh�d����d�Z�eh�d��ɡ���d�Z�eh�d����d�Z�e�eh�d��de�B����d�Z�e�Z�eh�d����d�Z�e�e}egeJdːd�e�eg�d�e`d˃eo�����ϡ���d�Z�e�e�e���e�Bd��d����d@�Z�G�d dt�dt�Z�eӐd!k�r�ed�d"�Z�ed�d#�Z�egeCeF�d$�Z�e�e֐d%dՐd&���e��Z�e�e�e׃����d'�Zؐd(e�BZ�e�e֐d%dՐd&���e��Z�e�e�eڃ����d)�Z�eԐd*�eِd'�e�eېd)�Z�eܠݐd+�e�jޠݐd,�e�jߠݐd,�e�j�ݐd-�ddl�Z�e�j᠝e�e�j��e�j�ݐd.�dS(6a�	
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and executing simple grammars,
vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
provides a library of classes that you use to construct the grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form 
C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
L{Literal} expressions)::

    from pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the self-explanatory
class names, and the use of '+', '|' and '^' operators.

The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
object with named attributes.

The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
 - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
 - quoted strings
 - embedded comments


Getting Started -
-----------------
Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:
 - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
 - construct character word-group expressions using the L{Word} class
 - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
 - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
 - associate names with your parsed results using L{ParserElement.setResultsName}
 - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
 - find more useful common expressions in the L{pyparsing_common} namespace class
z2.2.1z18 Sep 2018 00:49 UTCz*Paul McGuire <ptmcg@users.sourceforge.net>�N)�ref)�datetime)�RLock)�Iterable)�MutableMapping)�OrderedDict�And�CaselessKeyword�CaselessLiteral�
CharsNotIn�Combine�Dict�Each�Empty�
FollowedBy�Forward�
GoToColumn�Group�Keyword�LineEnd�	LineStart�Literal�
MatchFirst�NoMatch�NotAny�	OneOrMore�OnlyOnce�Optional�Or�ParseBaseException�ParseElementEnhance�ParseException�ParseExpression�ParseFatalException�ParseResults�ParseSyntaxException�
ParserElement�QuotedString�RecursiveGrammarException�Regex�SkipTo�	StringEnd�StringStart�Suppress�Token�TokenConverter�White�Word�WordEnd�	WordStart�
ZeroOrMore�	alphanums�alphas�
alphas8bit�anyCloseTag�
anyOpenTag�
cStyleComment�col�commaSeparatedList�commonHTMLEntity�countedArray�cppStyleComment�dblQuotedString�dblSlashComment�
delimitedList�dictOf�downcaseTokens�empty�hexnums�htmlComment�javaStyleComment�line�lineEnd�	lineStart�lineno�makeHTMLTags�makeXMLTags�matchOnlyAtCol�matchPreviousExpr�matchPreviousLiteral�
nestedExpr�nullDebugAction�nums�oneOf�opAssoc�operatorPrecedence�
printables�punc8bit�pythonStyleComment�quotedString�removeQuotes�replaceHTMLEntity�replaceWith�
restOfLine�sglQuotedString�srange�	stringEnd�stringStart�traceParseAction�
unicodeString�upcaseTokens�
withAttribute�
indentedBlock�originalTextFor�ungroup�
infixNotation�locatedExpr�	withClass�
CloseMatch�tokenMap�pyparsing_common�cCsft|t�r|Sz
t|�WStk
r`t|��t��d�}td�}|�dd��|�	|�YSXdS)aDrop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
           then < returns the unicode object | encodes it with the default encoding | ... >.
        �xmlcharrefreplacez&#\d+;cSs$dtt|ddd���dd�S)Nz\ur����)�hex�int��t�ry�@/usr/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py�<lambda>��z_ustr.<locals>.<lambda>N)
�
isinstanceZunicode�str�UnicodeEncodeError�encode�sys�getdefaultencodingr)�setParseAction�transformString)�obj�retZ
xmlcharrefryryrz�_ustr�s

r�z6sum len sorted reversed list tuple set any all min maxccs|]
}|VqdS�Nry)�.0�yryryrz�	<genexpr>�sr��cCs:d}dd�d��D�}t||�D]\}}|�||�}q |S)z/Escape &, <, >, ", ', etc. in a string of data.z&><"'css|]}d|dVqdS)�&�;Nry)r��sryryrzr��sz_xml_escape.<locals>.<genexpr>zamp gt lt quot apos)�split�zip�replace)�dataZfrom_symbolsZ
to_symbolsZfrom_Zto_ryryrz�_xml_escape�s
r�c@seZdZdS)�
_ConstantsN)�__name__�
__module__�__qualname__ryryryrzr��sr��
0123456789ZABCDEFabcdef�\�ccs|]}|tjkr|VqdSr�)�stringZ
whitespace�r��cryryrzr��s
c@sPeZdZdZddd�Zedd��Zdd	�Zd
d�Zdd
�Z	ddd�Z
dd�ZdS)rz7base exception class for all parsing runtime exceptionsrNcCs>||_|dkr||_d|_n||_||_||_|||f|_dS�Nr�)�loc�msg�pstr�
parserElement�args)�selfr�r�r��elemryryrz�__init__�szParseBaseException.__init__cCs||j|j|j|j�S)z�
        internal factory method to simplify creating one type of ParseException 
        from another - avoids having __init__ signature conflicts among subclasses
        )r�r�r�r�)�cls�peryryrz�_from_exception�sz"ParseBaseException._from_exceptioncCsN|dkrt|j|j�S|dkr,t|j|j�S|dkrBt|j|j�St|��dS)z�supported attributes by name are:
            - lineno - returns the line number of the exception text
            - col - returns the column number of the exception text
            - line - returns the line containing the exception text
        rL)r;�columnrIN)rLr�r�r;rI�AttributeError)r�Zanameryryrz�__getattr__�szParseBaseException.__getattr__cCsd|j|j|j|jfS)Nz"%s (at char %d), (line:%d, col:%d))r�r�rLr��r�ryryrz�__str__�s�zParseBaseException.__str__cCst|�Sr��r�r�ryryrz�__repr__�szParseBaseException.__repr__�>!<cCs<|j}|jd}|r4d�|d|�|||d�f�}|��S)z�Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        r�r�N)rIr��join�strip)r�ZmarkerStringZline_strZline_columnryryrz�
markInputline�s

�z ParseBaseException.markInputlinecCsd��tt|��S)Nzlineno col line)r��dir�typer�ryryrz�__dir__szParseBaseException.__dir__)rNN)r�)r�r�r��__doc__r��classmethodr�r�r�r�r�r�ryryryrzr�s



c@seZdZdZdS)r!aN
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
     - lineno - returns the line number of the exception text
     - col - returns the column number of the exception text
     - line - returns the line containing the exception text
        
    Example::
        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))
            
    prints::
       Expected integer (at char 0), (line:1, col:1)
        column: 1
    N�r�r�r�r�ryryryrzr!sc@seZdZdZdS)r#znuser-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediatelyNr�ryryryrzr#sc@seZdZdZdS)r%z�just like L{ParseFatalException}, but thrown internally when an
       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
       immediately because an unbacktrackable syntax error has been foundNr�ryryryrzr%sc@s eZdZdZdd�Zdd�ZdS)r(zZexception thrown by L{ParserElement.validate} if the grammar could be improperly recursivecCs
||_dSr��ZparseElementTrace�r��parseElementListryryrzr�4sz"RecursiveGrammarException.__init__cCs
d|jS)NzRecursiveGrammarException: %sr�r�ryryrzr�7sz!RecursiveGrammarException.__str__N)r�r�r�r�r�r�ryryryrzr(2sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�_ParseResultsWithOffsetcCs||f|_dSr���tup)r�Zp1Zp2ryryrzr�;sz _ParseResultsWithOffset.__init__cCs
|j|Sr�r��r��iryryrz�__getitem__=sz#_ParseResultsWithOffset.__getitem__cCst|jd�S�Nr)�reprr�r�ryryrzr�?sz _ParseResultsWithOffset.__repr__cCs|jd|f|_dSr�r�r�ryryrz�	setOffsetAsz!_ParseResultsWithOffset.setOffsetN)r�r�r�r�r�r�r�ryryryrzr�:sr�c@s�eZdZdZd[dd�Zddddefdd�Zdd	�Zefd
d�Zdd
�Z	dd�Z
dd�Zdd�ZeZ
dd�Zdd�Zdd�Zdd�Zdd�Zer�eZeZeZn$eZeZeZdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd\d(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Z d2d3�Z!d4d5�Z"d6d7�Z#d8d9�Z$d:d;�Z%d<d=�Z&d]d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*d^dHdI�Z+dJdK�Z,dLdM�Z-d_dOdP�Z.dQdR�Z/dSdT�Z0dUdV�Z1dWdX�Z2dYdZ�Z3dS)`r$aI
    Structured parse results, to provide multiple means of access to the parsed data:
       - as a list (C{len(results)})
       - by list index (C{results[0], results[1]}, etc.)
       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})

    Example::
        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)
    prints::
        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    NTcCs"t||�r|St�|�}d|_|S�NT)r}�object�__new__�_ParseResults__doinit)r��toklist�name�asList�modalZretobjryryrzr�ks


zParseResults.__new__c
Csb|jrvd|_d|_d|_i|_||_||_|dkr6g}||t�rP|dd�|_n||t�rft|�|_n|g|_t	�|_
|dk	�r^|�r^|s�d|j|<||t�r�t|�}||_||t
d�ttf�r�|ddgfk�s^||t�r�|g}|�r(||t��rt|��d�||<ntt|d�d�||<|||_n6z|d||<Wn$tttfk
�r\|||<YnXdS)NFrr�)r��_ParseResults__name�_ParseResults__parent�_ParseResults__accumNames�_ParseResults__asList�_ParseResults__modal�list�_ParseResults__toklist�_generatorType�dict�_ParseResults__tokdictrvr�r��
basestringr$r��copy�KeyError�	TypeError�
IndexError)r�r�r�r�r�r}ryryrzr�tsB



$
zParseResults.__init__cCsPt|ttf�r|j|S||jkr4|j|ddStdd�|j|D��SdS)NrtrcSsg|]}|d�qS�rry�r��vryryrz�
<listcomp>�sz,ParseResults.__getitem__.<locals>.<listcomp>)r}rv�slicer�r�r�r$r�ryryrzr��s


zParseResults.__getitem__cCs�||t�r0|j�|t��|g|j|<|d}nD||ttf�rN||j|<|}n&|j�|t��t|d�g|j|<|}||t�r�t|�|_	dSr�)
r�r��getr�rvr�r�r$�wkrefr�)r��kr�r}�subryryrz�__setitem__�s


"
zParseResults.__setitem__c
Cs�t|ttf�r�t|j�}|j|=t|t�rH|dkr:||7}t||d�}tt|�|���}|��|j	�
�D]>\}}|D]0}t|�D]"\}\}}	t||	|	|k�||<q�qxqln|j	|=dS�Nrr�)
r}rvr��lenr�r��range�indices�reverser��items�	enumerater�)
r�r�ZmylenZremovedr��occurrences�jr��value�positionryryrz�__delitem__�s

zParseResults.__delitem__cCs
||jkSr�)r�)r�r�ryryrz�__contains__�szParseResults.__contains__cCs
t|j�Sr�)r�r�r�ryryrz�__len__�r|zParseResults.__len__cCs
|jSr��r�r�ryryrz�__bool__�r|zParseResults.__bool__cCs
t|j�Sr���iterr�r�ryryrz�__iter__�r|zParseResults.__iter__cCst|jddd��S�Nrtr�r�ryryrz�__reversed__�r|zParseResults.__reversed__cCs$t|jd�r|j��St|j�SdS)N�iterkeys)�hasattrr�r�r�r�ryryrz�	_iterkeys�s
zParseResults._iterkeyscs�fdd����D�S)Nc3s|]}�|VqdSr�ry�r�r�r�ryrzr��sz+ParseResults._itervalues.<locals>.<genexpr>�rr�ryr�rz�_itervalues�szParseResults._itervaluescs�fdd����D�S)Nc3s|]}|�|fVqdSr�ryrr�ryrzr��sz*ParseResults._iteritems.<locals>.<genexpr>rr�ryr�rz�
_iteritems�szParseResults._iteritemscCst|���S)zVReturns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x).)r�r�r�ryryrz�keys�szParseResults.keyscCst|���S)zXReturns all named result values (as a list in Python 2.x, as an iterator in Python 3.x).)r��
itervaluesr�ryryrz�values�szParseResults.valuescCst|���S)zfReturns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x).)r��	iteritemsr�ryryrzr��szParseResults.itemscCs
t|j�S)z�Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names.)�boolr�r�ryryrz�haskeys�szParseResults.haskeyscOs�|s
dg}|��D]*\}}|dkr0|d|f}qtd|��qt|dt�sdt|�dksd|d|kr~|d}||}||=|S|d}|SdS)a�
        Removes and returns item at specified index (default=C{last}).
        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
        argument or an integer argument, it will use C{list} semantics
        and pop tokens from the list of parsed tokens. If passed a 
        non-integer argument (most likely a string), it will use C{dict}
        semantics and pop the corresponding value from any defined 
        results names. A second default return value argument is 
        supported, just as in C{dict.pop()}.

        Example::
            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())
        prints::
            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        rt�defaultrz-pop() got an unexpected keyword argument '%s'r�N)r�r�r}rvr�)r�r��kwargsr�r��indexr�Zdefaultvalueryryrz�pop�s""
�
�zParseResults.popcCs||kr||S|SdS)ai
        Returns named result matching the given key, or if there is no
        such name, then returns the given C{defaultValue} or C{None} if no
        C{defaultValue} is specified.

        Similar to C{dict.get()}.
        
        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        Nry)r��key�defaultValueryryrzr�3szParseResults.getcCsR|j�||�|j��D]4\}}t|�D]"\}\}}t||||k�||<q(qdS)a
        Inserts new element at location index in the list of parsed tokens.
        
        Similar to C{list.insert()}.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        N)r��insertr�r�r�r�)r�r
ZinsStrr�r�r�r�r�ryryrzrIszParseResults.insertcCs|j�|�dS)a�
        Add single element to end of ParseResults list of elements.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            
            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        N)r��append)r��itemryryrzr]szParseResults.appendcCs$t|t�r||7}n|j�|�dS)a
        Add sequence of elements to end of ParseResults list of elements.

        Example::
            patt = OneOrMore(Word(alphas))
            
            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        N)r}r$r��extend)r�Zitemseqryryrzrks

zParseResults.extendcCs|jdd�=|j��dS)z7
        Clear all elements and results names.
        N)r�r��clearr�ryryrzr}szParseResults.clearcCsjz
||WStk
r YdSX||jkrb||jkrH|j|ddStdd�|j|D��SndSdS)Nr�rtrcSsg|]}|d�qSr�ryr�ryryrzr��sz,ParseResults.__getattr__.<locals>.<listcomp>)r�r�r�r$�r�r�ryryrzr��s


zParseResults.__getattr__cCs|��}||7}|Sr��r�)r��otherr�ryryrz�__add__�szParseResults.__add__cs�|jrjt|j���fdd��|j��}�fdd�|D�}|D],\}}|||<t|dt�r<t|�|d_q<|j|j7_|j�	|j�|S)Ncs|dkr�S|�Sr�ry)�a)�offsetryrzr{�r|z'ParseResults.__iadd__.<locals>.<lambda>c	s4g|],\}}|D]}|t|d�|d��f�qqS�rr�)r��r�r��vlistr�)�	addoffsetryrzr��s�z)ParseResults.__iadd__.<locals>.<listcomp>r)
r�r�r�r�r}r$r�r�r��update)r�rZ
otheritemsZotherdictitemsr�r�ry)rrrz�__iadd__�s


�zParseResults.__iadd__cCs&t|t�r|dkr|��S||SdSr�)r}rvr��r�rryryrz�__radd__�szParseResults.__radd__cCsdt|j�t|j�fS)Nz(%s, %s))r�r�r�r�ryryrzr��szParseResults.__repr__cCsdd�dd�|jD��dS)N�[�, css(|] }t|t�rt|�nt|�VqdSr�)r}r$r�r��r�r�ryryrzr��sz'ParseResults.__str__.<locals>.<genexpr>�])r�r�r�ryryrzr��szParseResults.__str__r�cCsLg}|jD]<}|r |r |�|�t|t�r8||��7}q
|�t|��q
|Sr�)r�rr}r$�
_asStringListr�)r��sep�outrryryrzr(�s


zParseResults._asStringListcCsdd�|jD�S)a�
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::
            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
            
            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        cSs"g|]}t|t�r|��n|�qSry)r}r$r�)r��resryryrzr��sz'ParseResults.asList.<locals>.<listcomp>r�r�ryryrzr��szParseResults.asListcs6tr|j}n|j}�fdd��t�fdd�|�D��S)a�
        Returns the named parse results as a nested dictionary.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
            
            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        cs6t|t�r.|��r|��S�fdd�|D�Sn|SdS)Ncsg|]}�|��qSryryr���toItemryrzr��sz7ParseResults.asDict.<locals>.toItem.<locals>.<listcomp>)r}r$r
�asDict)r�r,ryrzr-�s

z#ParseResults.asDict.<locals>.toItemc3s|]\}}|�|�fVqdSr�ry�r�r�r�r,ryrzr��sz&ParseResults.asDict.<locals>.<genexpr>)�PY_3r�rr�)r�Zitem_fnryr,rzr.�s
	zParseResults.asDictcCs8t|j�}|j��|_|j|_|j�|j�|j|_|S)zA
        Returns a new copy of a C{ParseResults} object.
        )r$r�r�r�r�r�r r��r�r�ryryrzr��s
zParseResults.copyFcCsLd}g}tdd�|j��D��}|d}|s8d}d}d}d}	|dk	rJ|}	n|jrV|j}	|	sf|rbdSd}	|||d|	d	g7}t|j�D]�\}
}t|t�r�|
|kr�||�||
|o�|dk||�g7}n||�d|o�|dk||�g7}q�d}|
|kr�||
}|�s|�rq�nd}t	t
|��}
|||d|d	|
d
|d	g	7}q�|||d
|	d	g7}d�|�S)z�
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        �
css(|] \}}|D]}|d|fVqqdS�r�Nryrryryrzr�s�z%ParseResults.asXML.<locals>.<genexpr>�  r�NZITEM�<�>�</)r�r�r�r�r�r�r}r$�asXMLr�r�r�)r�ZdoctagZnamedItemsOnly�indentZ	formatted�nlr*Z
namedItemsZnextLevelIndentZselfTagr�r+ZresTagZxmlBodyTextryryrzr8�s^

�

�
�zParseResults.asXMLcCs:|j��D]*\}}|D]\}}||kr|Sqq
dSr�)r�r�)r�r�r�rr�r�ryryrzZ__lookup;s
zParseResults.__lookupcCs�|jr|jS|jr.|��}|r(|�|�SdSnNt|�dkrxt|j�dkrxtt|j����dddkrxtt|j����SdSdS)a(
        Returns the results name for this token expression. Useful when several 
        different expressions might match at a particular location.

        Example::
            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number") 
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)
            
            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])
        prints::
            age : 22
            ssn : 111-22-3333
            house_number : 221B
        Nr�r)rrt)	r�r��_ParseResults__lookupr�r��nextr�rr)r��parryryrz�getNameBs
��zParseResults.getNamercCsZg}d}|�|t|����|�rP|��r�tdd�|��D��}|D]r\}}|r\|�|�|�d|d||f�t|t�r�|r�|�|�||d��q�|�t|��qF|�t	|��qFn�t
dd�|D���rP|}t|�D]r\}	}
t|
t��r$|�d|d||	|d|d|
�||d�f�q�|�d|d||	|d|dt|
�f�q�d	�|�S)
aH
        Diagnostic method for listing out the contents of a C{ParseResults}.
        Accepts an optional C{indent} argument so that this string can be embedded
        in a nested display of other data.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(result.dump())
        prints::
            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        r2css|]\}}t|�|fVqdSr�)r~r/ryryrzr�~sz$ParseResults.dump.<locals>.<genexpr>z
%s%s- %s: r4r�css|]}t|t�VqdSr�)r}r$)r��vvryryrzr��sz
%s%s[%d]:
%s%s%sr�)
rr�r�r
�sortedr�r}r$�dumpr��anyr�r�)r�r9�depth�fullr*�NLr�r�r�r�r?ryryrzrAgs,

4,zParseResults.dumpcOstj|��f|�|�dS)a�
        Pretty-printer for parsed results as a list, using the C{pprint} module.
        Accepts additional positional or keyword args as defined for the 
        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})

        Example::
            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)
        prints::
            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        N)�pprintr��r�r�rryryrzrF�szParseResults.pprintcCs.|j|j��|jdk	r|��p d|j|jffSr�)r�r�r�r�r�r�r�ryryrz�__getstate__�s��zParseResults.__getstate__cCsN|d|_|d\|_}}|_i|_|j�|�|dk	rDt|�|_nd|_dSr�)r�r�r�r�r r�r�)r��stater=ZinAccumNamesryryrz�__setstate__�s
�zParseResults.__setstate__cCs|j|j|j|jfSr�)r�r�r�r�r�ryryrz�__getnewargs__�szParseResults.__getnewargs__cCstt|��t|���Sr�)r�r�r�rr�ryryrzr��szParseResults.__dir__)NNTT)N)r�)NFr�T)r�rT)4r�r�r�r�r�r}r�r�r�r�r�r�r��__nonzero__r�r�rrrr0rrr�r�rrr
rr�rrrrr�rr!r#r�r�r(r�r.r�r8r;r>rArFrHrJrKr�ryryryrzr$Dsh&
	'	
4

#
=%
-
cCsF|}d|krt|�kr4nn||ddkr4dS||�dd|�S)aReturns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   rr�r2)r��rfind)r��strgr�ryryrzr;�s
cCs|�dd|�dS)aReturns current line number within a string, counting newlines as line separators.
   The first line is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   r2rr�)�count)r�rNryryrzrL�s
cCsF|�dd|�}|�d|�}|dkr2||d|�S||dd�SdS)zfReturns the line of text containing loc within a string, counting newlines as line separators.
       r2rr�N)rM�find)r�rNZlastCRZnextCRryryrzrI�s
cCs8tdt|�dt|�dt||�t||�f�dS)NzMatch z at loc z(%d,%d))�printr�rLr;)�instringr��exprryryrz�_defaultStartDebugAction�srTcCs$tdt|�dt|����dS)NzMatched z -> )rQr�r~r�)rR�startlocZendlocrS�toksryryrz�_defaultSuccessDebugAction�srWcCstdt|��dS)NzException raised:)rQr�)rRr�rS�excryryrz�_defaultExceptionDebugAction�srYcGsdS)zG'Do-nothing' debug action, to suppress debugging output during parsing.Nry)r�ryryrzrS�srscs��tkr�fdd�Sdg�dg�tdd�dkrFddd�}dd	d
��ntj}tj�d}|dd�d
}|d|d|f�������fdd�}d}zt�dt�d�j�}Wntk
r�t��}YnX||_|S)Ncs�|�Sr�ry�r��lrx)�funcryrzr{r|z_trim_arity.<locals>.<lambda>rFrs)rq�cSs8tdkrdnd}tj||dd�|}|dd�gS)N)rqr]r������r���limitrs)�system_version�	traceback�
extract_stack)rar�
frame_summaryryryrzrdsz"_trim_arity.<locals>.extract_stackcSs$tj||d�}|d}|dd�gS)Nr`rtrs)rc�
extract_tb)�tbraZframesreryryrzrfsz_trim_arity.<locals>.extract_tb�r`rtr�c	s�z"�|�dd��}d�d<|WStk
r��dr>�n4z.t��d}�|dd�ddd��ksj�W5~X�d�kr��dd7<Yq�YqXqdS)NrTrtrsr`r�)r�r��exc_info)r�r�rg�rfZ
foundArityr\ra�maxargsZpa_call_line_synthryrz�wrapper-s z_trim_arity.<locals>.wrapperz<parse action>r��	__class__)r)r)	�singleArgBuiltinsrbrcrdrf�getattrr��	Exceptionr~)r\rkrdZ	LINE_DIFFZ	this_linerl�	func_nameryrjrz�_trim_aritys,

�rrcs�eZdZdZdZdZedd��Zedd��Zd�dd	�Z	d
d�Z
dd
�Zd�dd�Zd�dd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd�dd �Zd!d"�Zd�d#d$�Zd%d&�Zd'd(�ZGd)d*�d*e�Zed+k	r�Gd,d-�d-e�ZnGd.d-�d-e�ZiZe�Zd/d/gZ d�d0d1�Z!eZ"ed2d3��Z#dZ$ed�d5d6��Z%d�d7d8�Z&e'dfd9d:�Z(d;d<�Z)e'fd=d>�Z*e'dfd?d@�Z+dAdB�Z,dCdD�Z-dEdF�Z.dGdH�Z/dIdJ�Z0dKdL�Z1dMdN�Z2dOdP�Z3dQdR�Z4dSdT�Z5dUdV�Z6dWdX�Z7dYdZ�Z8d�d[d\�Z9d]d^�Z:d_d`�Z;dadb�Z<dcdd�Z=dedf�Z>dgdh�Z?d�didj�Z@dkdl�ZAdmdn�ZBdodp�ZCdqdr�ZDgfdsdt�ZEd�dudv�ZF�fdwdx�ZGdydz�ZHd{d|�ZId}d~�ZJdd��ZKd�d�d��ZLd�d�d��ZM�ZNS)�r&z)Abstract base level parser element class.z 
	
FcCs
|t_dS)a�
        Overrides the default whitespace chars

        Example::
            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
            
            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        N)r&�DEFAULT_WHITE_CHARS��charsryryrz�setDefaultWhitespaceCharsTs
z'ParserElement.setDefaultWhitespaceCharscCs
|t_dS)a�
        Set class to be used for inclusion of string literals into a parser.
        
        Example::
            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        N)r&�_literalStringClass)r�ryryrz�inlineLiteralsUsingcsz!ParserElement.inlineLiteralsUsingcCs�t�|_d|_d|_d|_||_d|_tj|_	d|_
d|_d|_t�|_
d|_d|_d|_d|_d|_d|_d|_d|_d|_dS)NTFr�)NNN)r��parseAction�
failAction�strRepr�resultsName�
saveAsList�skipWhitespacer&rs�
whiteChars�copyDefaultWhiteChars�mayReturnEmpty�keepTabs�ignoreExprs�debug�streamlined�
mayIndexError�errmsg�modalResults�debugActions�re�callPreparse�
callDuringTry)r��savelistryryrzr�xs(zParserElement.__init__cCs<t�|�}|jdd�|_|jdd�|_|jr8tj|_|S)a$
        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
        for the same parsing pattern, using copies of the original parse element.
        
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
            
            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
        prints::
            [5120, 100, 655360, 268435456]
        Equivalent form of C{expr.copy()} is just C{expr()}::
            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
        N)r�ryr�r�r&rsr)r�Zcpyryryrzr��s
zParserElement.copycCs*||_d|j|_t|d�r&|j|j_|S)af
        Define name for this expression, makes debugging and exception messages clearer.
        
        Example::
            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        �	Expected �	exception)r�r�r�r�r�rryryrz�setName�s


zParserElement.setNamecCs4|��}|�d�r"|dd�}d}||_||_|S)aP
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original C{ParserElement} object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        C{expr("name")} in place of C{expr.setResultsName("name")} - 
        see L{I{__call__}<__call__>}.

        Example::
            date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        �*NrtT)r��endswithr|r�)r�r��listAllMatchesZnewselfryryrz�setResultsName�s
zParserElement.setResultsNameTcs@|r&|j�d�fdd�	}�|_||_nt|jd�r<|jj|_|S)z�Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set C{breakFlag} to True to enable, False to
           disable.
        Tcsddl}|���||||�Sr�)�pdbZ	set_trace)rRr��	doActions�callPreParser��Z_parseMethodryrz�breaker�sz'ParserElement.setBreak.<locals>.breaker�_originalParseMethod)TT)�_parser�r�)r�Z	breakFlagr�ryr�rz�setBreak�s
zParserElement.setBreakcOs&tttt|���|_|�dd�|_|S)a
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
         - s   = the original string being parsed (see note below)
         - loc = the location of the matching substring
         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        Optional keyword arguments:
         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
        consistent view of the parsed string, the parse location, and line and column
        positions within the parsed string.
        
        Example::
            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        r�F)r��maprrryr�r��r��fnsrryryrzr��s"zParserElement.setParseActioncOs4|jtttt|���7_|jp,|�dd�|_|S)z�
        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
        
        See examples in L{I{copy}<copy>}.
        r�F)ryr�r�rrr�r�r�ryryrz�addParseActionszParserElement.addParseActioncs^|�dd��|�dd�rtnt�|D] ����fdd�}|j�|�q$|jpV|�dd�|_|S)a�Add a boolean predicate function to expression's list of parse actions. See 
        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
        functions passed to C{addCondition} need to return boolean success/fail of the condition.

        Optional keyword arguments:
         - message = define a custom message to be used in the raised exception
         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
         
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        �messagezfailed user-defined condition�fatalFcs$tt��|||��s �||���dSr�)r	rrrZ��exc_type�fnr�ryrz�pa&sz&ParserElement.addCondition.<locals>.par�)r�r#r!ryrr�)r�r�rr�ryr�rz�addConditionszParserElement.addConditioncCs
||_|S)aDefine action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           C{fn(s,loc,expr,err)} where:
            - s = string being parsed
            - loc = location where expression match was attempted and failed
            - expr = the parse expression that failed
            - err = the exception thrown
           The function returns no value.  It may throw C{L{ParseFatalException}}
           if it is desired to stop parsing immediately.)rz)r�r�ryryrz�
setFailAction-s
zParserElement.setFailActionc	CsNd}|rJd}|jD]4}z|�||�\}}d}qWqtk
rDYqXqq|S�NTF)r�r�r!)r�rRr�Z
exprsFound�eZdummyryryrz�_skipIgnorables:s


zParserElement._skipIgnorablescCsH|jr|�||�}|jrD|j}t|�}||krD|||krD|d7}q&|S�Nr�)r�r�r~rr�)r�rRr�Zwt�instrlenryryrz�preParseGs
zParserElement.preParsecCs|gfSr�ry�r�rRr�r�ryryrz�	parseImplSszParserElement.parseImplcCs|Sr�ry�r�rRr��	tokenlistryryrz�	postParseVszParserElement.postParsec
Cs�|j}|s|jr�|jdr,|jd|||�|rD|jrD|�||�}n|}|}zDz|�|||�\}}Wn(tk
r�t|t|�|j	|��YnXWnXt
k
r�}	z:|jdr�|jd||||	�|jr�|�||||	��W5d}	~	XYnXn�|�r|j�r|�||�}n|}|}|j�s&|t|�k�rjz|�|||�\}}Wn*tk
�rft|t|�|j	|��YnXn|�|||�\}}|�|||�}t
||j|j|jd�}
|j�r�|�s�|j�r�|�rTzN|jD]B}||||
�}|dk	�r�t
||j|j�o�t|t
tf�|jd�}
�q�WnFt
k
�rP}	z&|jd�r>|jd||||	��W5d}	~	XYnXnJ|jD]B}||||
�}|dk	�rZt
||j|j�o�t|t
tf�|jd�}
�qZ|�r�|jd�r�|jd|||||
�||
fS)Nrrs)r�r�r�)r�rzr�r�r�r�r�r!r�r�rr�r�r$r|r}r�ryr�r}r�)r�rRr�r�r�Z	debugging�prelocZtokensStart�tokens�errZ	retTokensr�ryryrz�
_parseNoCacheZst





�

�
zParserElement._parseNoCachecCs@z|j||dd�dWStk
r:t|||j|��YnXdS)NF)r�r)r�r#r!r��r�rRr�ryryrz�tryParse�szParserElement.tryParsec	Cs4z|�||�Wnttfk
r*YdSXdSdS)NFT)r�r!r�r�ryryrz�canParseNext�s
zParserElement.canParseNextc@seZdZdd�ZdS)zParserElement._UnboundedCachecs~i�t�|_���fdd�}�fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr��r��r�r��cache�not_in_cacheryrzr��sz3ParserElement._UnboundedCache.__init__.<locals>.getcs|�|<dSr�ry�r�rr��r�ryrz�set�sz3ParserElement._UnboundedCache.__init__.<locals>.setcs���dSr��rr�r�ryrzr�sz5ParserElement._UnboundedCache.__init__.<locals>.clearcst��Sr��r�r�r�ryrz�	cache_len�sz9ParserElement._UnboundedCache.__init__.<locals>.cache_len)r�r��types�
MethodTyper�r�rr�)r�r�r�rr�ryr�rzr��sz&ParserElement._UnboundedCache.__init__N�r�r�r�r�ryryryrz�_UnboundedCache�sr�Nc@seZdZdd�ZdS)�ParserElement._FifoCachecs�t�|_�t����fdd�}��fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr�r�r�r�ryrzr��s�.ParserElement._FifoCache.__init__.<locals>.getcs>|�|<t���kr:z��d�Wqtk
r6YqXqdS�NF)r��popitemr�r�)r��sizeryrzr��s�.ParserElement._FifoCache.__init__.<locals>.setcs���dSr�r�r�r�ryrzr�s�0ParserElement._FifoCache.__init__.<locals>.clearcst��Sr�r�r�r�ryrzr��s�4ParserElement._FifoCache.__init__.<locals>.cache_len)	r�r��_OrderedDictr�r�r�r�rr��r�r�r�r�rr�ry)r�r�r�rzr��s�!ParserElement._FifoCache.__init__Nr�ryryryrz�
_FifoCache�sr�c@seZdZdd�ZdS)r�cs�t�|_�i�t�g�����fdd�}���fdd�}��fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_	dS)	Ncs��|��Sr�r�r�r�ryrzr��sr�cs4|�|<t���kr&�����d�q��|�dSr�)r�r�popleftrr�)r��key_fifor�ryrzr��sr�cs������dSr�r�r�)r�r�ryrzr�sr�cst��Sr�r�r�r�ryrzr��sr�)
r�r��collections�dequer�r�r�r�rr�r�ry)r�r�r�r�rzr��sr�Nr�ryryryrzr��srcCsd\}}|||||f}tj��tj}|�|�}	|	|jkr�tj|d7<z|�||||�}	Wn8tk
r�}
z|�||
j	|
j
���W5d}
~
XYn.X|�||	d|	d��f�|	W5QR�Sn@tj|d7<t|	t
�r�|	�|	d|	d��fW5QR�SW5QRXdS)Nrr�r)r&�packrat_cache_lock�
packrat_cacher�r��packrat_cache_statsr�rr�rmr�r�r}rp)r�rRr�r�r�ZHITZMISS�lookupr�r�r�ryryrz�_parseCaches$


zParserElement._parseCachecCs(tj��dgttj�tjdd�<dSr�)r&r�rr�r�ryryryrz�
resetCaches
zParserElement.resetCache�cCs8tjs4dt_|dkr t��t_nt�|�t_tjt_dS)a�Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.
           
           Parameters:
            - cache_size_limit - (default=C{128}) - if an integer value is provided
              will limit the size of the packrat cache; if None is passed, then
              the cache size will be unbounded; if 0 is passed, the cache will
              be effectively disabled.
            
           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method C{ParserElement.enablePackrat()}.  If
           your program uses C{psyco} to "compile as you go", you must call
           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
           Python will crash.  For best results, call C{enablePackrat()} immediately
           after importing pyparsing.
           
           Example::
               import pyparsing
               pyparsing.ParserElement.enablePackrat()
        TN)r&�_packratEnabledr�r�r�r�r�)Zcache_size_limitryryrz�
enablePackrat%szParserElement.enablePackratc
Cs�t��|js|��|jD]}|��q|js8|��}z<|�|d�\}}|rr|�||�}t	�t
�}|�||�Wn0tk
r�}ztjr��n|�W5d}~XYnX|SdS)aB
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set C{parseAll} to True (equivalent to ending
        the grammar with C{L{StringEnd()}}).

        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the C{loc} argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:
         - calling C{parseWithTabs} on your grammar before calling C{parseString}
           (see L{I{parseWithTabs}<parseWithTabs>})
         - define your parse action using the full C{(s,loc,toks)} signature, and
           reference the input string using the parse action's C{s} argument
         - explictly expand the tabs in your input string before calling
           C{parseString}
        
        Example::
            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        rN)
r&r�r��
streamliner�r��
expandtabsr�r�rr+r�verbose_stacktrace)r�rR�parseAllr�r�r�ZserXryryrz�parseStringHs$

zParserElement.parseStringc
cs6|js|��|jD]}|��q|js4t|���}t|�}d}|j}|j}t	�
�d}	z�||kr�|	|kr�z |||�}
|||
dd�\}}Wntk
r�|
d}YqZX||kr�|	d7}	||
|fV|r�|||�}
|
|kr�|}q�|d7}q�|}qZ|
d}qZWn4tk
�r0}zt	j
�r�n|�W5d}~XYnXdS)a�
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
        C{overlap} is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
        strings with embedded tabs.

        Example::
            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens,start,end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])
        
        prints::
        
            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        rF�r�r�N)r�r�r�r�r�r�r�r�r�r&r�r!rr�)r�rR�
maxMatchesZoverlapr�r�r�Z
preparseFnZparseFn�matchesr�ZnextLocr�ZnextlocrXryryrz�
scanStringzsB




zParserElement.scanStringc
Cs�g}d}d|_z�|�|�D]Z\}}}|�|||��|rpt|t�rR||��7}nt|t�rf||7}n
|�|�|}q|�||d��dd�|D�}d�tt	t
|���WStk
r�}ztj
rƂn|�W5d}~XYnXdS)af
        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
        be returned from a parse action.  To use C{transformString}, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking C{transformString()} on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  C{transformString()} returns the resulting transformed string.
        
        Example::
            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())
            
            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
        Prints::
            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        rTNcSsg|]}|r|�qSryry)r��oryryrzr��sz1ParserElement.transformString.<locals>.<listcomp>r�)r�r�rr}r$r�r�r�r�r��_flattenrr&r�)r�rRr*ZlastErxr�r�rXryryrzr��s(



zParserElement.transformStringc
CsRztdd�|�||�D��WStk
rL}ztjr8�n|�W5d}~XYnXdS)a�
        Another extension to C{L{scanString}}, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        C{maxMatches} argument, to clip searching after 'n' matches are found.
        
        Example::
            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())
            
            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
        prints::
            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        cSsg|]\}}}|�qSryry)r�rxr�r�ryryrzr��sz.ParserElement.searchString.<locals>.<listcomp>N)r$r�rr&r�)r�rRr�rXryryrz�searchString�szParserElement.searchStringc	csTd}d}|j||d�D]*\}}}|||�V|r<|dV|}q||d�VdS)a[
        Generator method to split a string using the given expression as a separator.
        May be called with optional C{maxsplit} argument, to limit the number of splits;
        and the optional C{includeSeparators} argument (default=C{False}), if the separating
        matching text should be included in the split results.
        
        Example::        
            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
        prints::
            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        r)r�N)r�)	r�rR�maxsplitZincludeSeparatorsZsplitsZlastrxr�r�ryryrzr�s

zParserElement.splitcCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)a�
        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
        converts them to L{Literal}s by default.
        
        Example::
            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))
        Prints::
            Hello, World! -> ['Hello', ',', 'World', '!']
        �4Cannot combine element of type %s with ParserElementrs��
stacklevelN)	r}r�r&rw�warnings�warnr��
SyntaxWarningrr"ryryrzrs


�zParserElement.__add__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of + operator when left operand is not a C{L{ParserElement}}
        r�rsr�N�r}r�r&rwr�r�r�r�r"ryryrzr#1s


�zParserElement.__radd__cCsJt|t�rt�|�}t|t�s:tjdt|�tdd�dS|t�	�|S)zQ
        Implementation of - operator, returns C{L{And}} with error stop
        r�rsr�N)
r}r�r&rwr�r�r�r�r�
_ErrorStopr"ryryrz�__sub__=s


�zParserElement.__sub__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of - operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rsub__Is


�zParserElement.__rsub__cs�t|t�r|d}}n�t|t�r�|ddd�}|ddkrHd|df}t|dt�r�|ddkr�|ddkrvt��S|ddkr�t��S�|dt��Sq�t|dt�r�t|dt�r�|\}}||8}q�tdt|d�t|d���ntdt|���|dk�rtd��|dk�rtd	��||k�r6dk�rBnntd
��|�r���fdd��|�r�|dk�rt��|�}nt�g|��|�}n�|�}n|dk�r��}nt�g|�}|S)
a�
        Implementation of * operator, allows use of C{expr * 3} in place of
        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
        may also include C{None} as in:
         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
              to C{expr*n + L{ZeroOrMore}(expr)}
              (read as "at least n instances of C{expr}")
         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
              (read as "0 to n instances of C{expr}")
         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}

        Note that C{expr*(None,n)} does not raise an exception if
        more than n exprs exist in the input stream; that is,
        C{expr*(None,n)} does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        C{expr*(None,n) + ~expr}
        r)NNNrsr�z7cannot multiply 'ParserElement' and ('%s','%s') objectsz0cannot multiply 'ParserElement' and '%s' objectsz/cannot multiply ParserElement by negative valuez@second tuple value must be greater or equal to first tuple valuez+cannot multiply ParserElement by 0 or (0,0)cs(|dkrt��|d��St��SdSr�)r��n��makeOptionalListr�ryrzr��sz/ParserElement.__mul__.<locals>.makeOptionalList)	r}rv�tupler4rr�r��
ValueErrorr)r�rZminElementsZoptElementsr�ryr�rz�__mul__UsD







zParserElement.__mul__cCs
|�|�Sr�)rr"ryryrz�__rmul__�szParserElement.__rmul__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zI
        Implementation of | operator - returns C{L{MatchFirst}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__or__�s


�zParserElement.__or__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||BS)z]
        Implementation of | operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__ror__�s


�zParserElement.__ror__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zA
        Implementation of ^ operator - returns C{L{Or}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__xor__�s


�zParserElement.__xor__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||AS)z]
        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rxor__�s


�zParserElement.__rxor__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zC
        Implementation of & operator - returns C{L{Each}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__and__�s


�zParserElement.__and__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||@S)z]
        Implementation of & operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rand__�s


�zParserElement.__rand__cCst|�S)zE
        Implementation of ~ operator - returns C{L{NotAny}}
        )rr�ryryrz�
__invert__�szParserElement.__invert__cCs|dk	r|�|�S|��SdS)a

        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
        
        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
        passed as C{True}.
           
        If C{name} is omitted, same as calling C{L{copy}}.

        Example::
            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
        N)r�r�rryryrz�__call__�s
zParserElement.__call__cCst|�S)z�
        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
        cluttering up returned output.
        )r-r�ryryrz�suppress�szParserElement.suppresscCs
d|_|S)a
        Disables the skipping of whitespace before matching the characters in the
        C{ParserElement}'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        F�r~r�ryryrz�leaveWhitespaceszParserElement.leaveWhitespacecCsd|_||_d|_|S)z8
        Overrides the default whitespace chars
        TF)r~rr�)r�ruryryrz�setWhitespaceChars
sz ParserElement.setWhitespaceCharscCs
d|_|S)z�
        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
        Must be called before C{parseString} when the input grammar contains elements that
        match C{<TAB>} characters.
        T)r�r�ryryrz�
parseWithTabsszParserElement.parseWithTabscCsLt|t�rt|�}t|t�r4||jkrH|j�|�n|j�t|����|S)a�
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.
        
        Example::
            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
            
            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        )r}r�r-r�rr�r"ryryrz�ignores


zParserElement.ignorecCs"|pt|pt|ptf|_d|_|S)zT
        Enable display of debugging messages while doing pattern matching.
        T)rTrWrYr�r�)r�ZstartActionZ
successActionZexceptionActionryryrz�setDebugActions6s�zParserElement.setDebugActionscCs|r|�ttt�nd|_|S)a�
        Enable display of debugging messages while doing pattern matching.
        Set C{flag} to True to enable, False to disable.

        Example::
            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer
            
            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")
        
        prints::
            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using L{setDebugActions}. Prior to attempting
        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
        F)rrTrWrYr�)r��flagryryrz�setDebug@s#zParserElement.setDebugcCs|jSr�)r�r�ryryrzr�iszParserElement.__str__cCst|�Sr�r�r�ryryrzr�lszParserElement.__repr__cCsd|_d|_|Sr�)r�r{r�ryryrzr�oszParserElement.streamlinecCsdSr�ryr�ryryrz�checkRecursiontszParserElement.checkRecursioncCs|�g�dS)zj
        Check defined expressions for valid structure, check for infinite recursive definitions.
        N)r)r��
validateTraceryryrz�validatewszParserElement.validatecCs�z|��}Wn2tk
r>t|d��}|��}W5QRXYnXz|�||�WStk
r~}ztjrj�n|�W5d}~XYnXdS)z�
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        �rN)�readr��openr�rr&r�)r�Zfile_or_filenamer�Z
file_contents�frXryryrz�	parseFile}szParserElement.parseFilecsHt|t�r"||kp t|�t|�kSt|t�r6|�|�Stt|�|kSdSr�)r}r&�varsr�r��superr"�rmryrz�__eq__�s



zParserElement.__eq__cCs
||kSr�ryr"ryryrz�__ne__�szParserElement.__ne__cCstt|��Sr�)�hash�idr�ryryrz�__hash__�szParserElement.__hash__cCs||kSr�ryr"ryryrz�__req__�szParserElement.__req__cCs
||kSr�ryr"ryryrz�__rne__�szParserElement.__rne__cCs4z|jt|�|d�WdStk
r.YdSXdS)a�
        Method for quick testing of a parser against a test string. Good for simple 
        inline microtests of sub expressions while building up larger parser.
           
        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
            
        Example::
            expr = Word(nums)
            assert expr.matches("100")
        �r�TFN)r�r�r)r�Z
testStringr�ryryrzr��s

zParserElement.matches�#cCs�t|t�r"tttj|������}t|t�r4t|�}g}g}d}	|D�]�}
|dk	r^|�	|
d�sf|rr|
sr|�
|
�qD|
sxqDd�|�|
g}g}z:|
�dd�}
|j
|
|d�}|�
|j|d��|	o�|}	Wn�tk
�rr}
z�t|
t�r�dnd	}d|
k�r*|�
t|
j|
��|�
d
t|
j|
�dd|�n|�
d
|
jd|�|�
d
t|
��|	�o\|}	|
}W5d}
~
XYnDtk
�r�}z$|�
dt|��|	�o�|}	|}W5d}~XYnX|�r�|�r�|�
d	�td�|��|�
|
|f�qD|	|fS)a3
        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.
           
        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
              string; pass None to disable comment filtering
         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default=C{True}) prints test output to stdout
         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
        test's output
        
        Example::
            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")
        prints::
            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success
            
            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\n of strings that spans \n 3 lines")
        
        (Note that this is a raw string literal, you must include the leading 'r'.)
        TNFr2�\nr%)rDz(FATAL)r�� r��^zFAIL: zFAIL-EXCEPTION: )r}r�r�r�r~r��rstrip�
splitlinesrr�rr�r�r�rArr#rIr�r;rprQ)r�Ztestsr�ZcommentZfullDumpZprintResultsZfailureTestsZ
allResultsZcomments�successrxr*�resultr�r�rXryryrz�runTests�sNW




$


zParserElement.runTests)F)F)T)T)TT)TT)r�)F)N)T)F)T)Tr&TTF)Or�r�r�r�rsr��staticmethodrvrxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r��_MAX_INTr�r�r�r�rr#r�r�rrrrrrrrrr	r
rr
rrrrr�r�r�rrrrrr"r#r$r�r.�
__classcell__ryryrrzr&Os�




&




G

"
2G+D
			

)

cs eZdZdZ�fdd�Z�ZS)r.zT
    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
    cstt|�jdd�dS�NF�r�)rr.r�r�rryrzr�@	szToken.__init__�r�r�r�r�r�r1ryryrrzr.<	scs eZdZdZ�fdd�Z�ZS)rz,
    An empty token, will always match.
    cs$tt|���d|_d|_d|_dS)NrTF)rrr�r�r�r�r�rryrzr�H	szEmpty.__init__r4ryryrrzrD	scs*eZdZdZ�fdd�Zddd�Z�ZS)rz(
    A token that will never match.
    cs*tt|���d|_d|_d|_d|_dS)NrTFzUnmatchable token)rrr�r�r�r�r�r�rryrzr�S	s
zNoMatch.__init__TcCst|||j|��dSr�)r!r�r�ryryrzr�Z	szNoMatch.parseImpl)T�r�r�r�r�r�r�r1ryryrrzrO	scs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Token to exactly match a specified string.
    
    Example::
        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
    
    For case-insensitive matching, use L{CaselessLiteral}.
    
    For keyword matching (force word break before and after the matched string),
    use L{Keyword} or L{CaselessKeyword}.
    cs�tt|���||_t|�|_z|d|_Wn*tk
rVtj	dt
dd�t|_YnXdt
|j�|_d|j|_d|_d|_dS)Nrz2null string passed to Literal; use Empty() insteadrsr��"%s"r�F)rrr��matchr��matchLen�firstMatchCharr�r�r�r�rrmr�r�r�r�r��r��matchStringrryrzr�l	s
�zLiteral.__init__TcCsJ|||jkr6|jdks&|�|j|�r6||j|jfSt|||j|��dSr�)r9r8�
startswithr7r!r�r�ryryrzr�	s��zLiteral.parseImpl)Tr5ryryrrzr^	s
csLeZdZdZedZd�fdd�	Zddd	�Z�fd
d�Ze	dd
��Z
�ZS)ra\
    Token to exactly match a specified string as a keyword, that is, it must be
    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
    Accepts two optional constructor arguments in addition to the keyword string:
     - C{identChars} is a string of characters that would be valid identifier characters,
          defaulting to all alphanumerics + "_" and "$"
     - C{caseless} allows case-insensitive matching, default is C{False}.
       
    Example::
        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use L{CaselessKeyword}.
    �_$NFcs�tt|���|dkrtj}||_t|�|_z|d|_Wn$tk
r^t	j
dtdd�YnXd|j|_d|j|_
d|_d|_||_|r�|��|_|��}t|�|_dS)Nrz2null string passed to Keyword; use Empty() insteadrsr�r6r�F)rrr��DEFAULT_KEYWORD_CHARSr7r�r8r9r�r�r�r�r�r�r�r��caseless�upper�
caselessmatchr��
identChars)r�r;rBr?rryrzr��	s*
�
zKeyword.__init__TcCs|jr|||||j���|jkr�|t|�|jksL|||j��|jkr�|dksj||d��|jkr�||j|jfSnv|||jkr�|jdks�|�|j|�r�|t|�|jks�|||j|jkr�|dks�||d|jkr�||j|jfSt	|||j
|��dSr�)r?r8r@rAr�rBr7r9r<r!r�r�ryryrzr��	s4����������zKeyword.parseImplcstt|���}tj|_|Sr�)rrr�r>rB)r�r�rryrzr��	szKeyword.copycCs
|t_dS)z,Overrides the default Keyword chars
        N)rr>rtryryrz�setDefaultKeywordChars�	szKeyword.setDefaultKeywordChars)NF)T)r�r�r�r�r5r>r�r�r�r/rCr1ryryrrzr�	s
cs*eZdZdZ�fdd�Zddd�Z�ZS)r
al
    Token to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::
        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
        
    (Contrast with example for L{CaselessKeyword}.)
    cs6tt|��|���||_d|j|_d|j|_dS)Nz'%s'r�)rr
r�r@�returnStringr�r�r:rryrzr��	szCaselessLiteral.__init__TcCs@||||j���|jkr,||j|jfSt|||j|��dSr�)r8r@r7rDr!r�r�ryryrzr��	szCaselessLiteral.parseImpl)Tr5ryryrrzr
�	s
cs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
r	z�
    Caseless version of L{Keyword}.

    Example::
        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
        
    (Contrast with example for L{CaselessLiteral}.)
    Ncstt|�j||dd�dS)NT�r?)rr	r�)r�r;rBrryrzr��	szCaselessKeyword.__init__TcCsj||||j���|jkrV|t|�|jksF|||j��|jkrV||j|jfSt|||j|��dSr�)r8r@rAr�rBr7r!r�r�ryryrzr��	s��zCaselessKeyword.parseImpl)N)Tr5ryryrrzr	�	scs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
rnax
    A variation on L{Literal} which matches "close" matches, that is, 
    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
     - C{match_string} - string to be matched
     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
    
    The results from a successful parse will contain the matched text from the input string and the following named results:
     - C{mismatches} - a list of the positions within the match_string where mismatches were found
     - C{original} - the original match_string used to compare against the input string
    
    If C{mismatches} is an empty list, then the match was an exact match.
    
    Example::
        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    r�csBtt|���||_||_||_d|j|jf|_d|_d|_dS)Nz&Expected %r (with up to %d mismatches)F)	rrnr�r��match_string�
maxMismatchesr�r�r�)r�rFrGrryrzr�

szCloseMatch.__init__TcCs�|}t|�}|t|j�}||kr�|j}d}g}	|j}
tt|||�|j��D]2\}}|\}}
||
krN|	�|�t|	�|
krNq�qN|d}t|||�g�}|j|d<|	|d<||fSt|||j|��dS)Nrr��original�
mismatches)	r�rFrGr�r�rr$r!r�)r�rRr�r��startr��maxlocrFZmatch_stringlocrIrGZs_m�src�mat�resultsryryrzr�
s( 

zCloseMatch.parseImpl)r�)Tr5ryryrrzrn�	s	cs8eZdZdZd
�fdd�	Zdd	d
�Z�fdd�Z�ZS)r1a	
    Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters,
    an optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction. An optional
    C{excludeChars} parameter can list characters that might be found in 
    the input C{bodyChars} string; useful to define a word of all printables
    except for one or two characters, for instance.
    
    L{srange} is useful for defining custom character set strings for defining 
    C{Word} expressions, using range notation from regular expression character sets.
    
    A common mistake is to use C{Word} to match a specific literal string, as in 
    C{Word("Address")}. Remember that C{Word} uses the string argument to define
    I{sets} of matchable characters. This expression would match "Add", "AAA",
    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
    To match an exact literal string, use L{Literal} or L{Keyword}.

    pyparsing includes helper strings for building Words:
     - L{alphas}
     - L{nums}
     - L{alphanums}
     - L{hexnums}
     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - L{printables} (any non-whitespace character)

    Example::
        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
        
        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums+'-')
        
        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")
        
        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    Nr�rFcs�tt|����rFd��fdd�|D��}|rFd��fdd�|D��}||_t|�|_|rl||_t|�|_n||_t|�|_|dk|_	|dkr�t
d��||_|dkr�||_nt
|_|dkr�||_||_t|�|_d|j|_d	|_||_d
|j|jk�r�|dk�r�|dk�r�|dk�r�|j|jk�r8dt|j�|_nHt|j�dk�rfdt�|j�t|j�f|_nd
t|j�t|j�f|_|j�r�d|jd|_zt�|j�|_Wntk
�r�d|_YnXdS)Nr�c3s|]}|�kr|VqdSr�ryr���excludeCharsryrzr�`
sz Word.__init__.<locals>.<genexpr>c3s|]}|�kr|VqdSr�ryr�rOryrzr�b
srr�zZcannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permittedr�Fr(z[%s]+z%s[%s]*z	[%s][%s]*z\b)rr1r�r��
initCharsOrigr��	initChars�
bodyCharsOrig�	bodyChars�maxSpecifiedr��minLen�maxLenr0r�r�r�r��	asKeyword�_escapeRegexRangeChars�reStringr�r��escape�compilerp)r�rRrT�min�max�exactrXrPrrOrzr�]
s\



0
����z
Word.__init__Tc
Cs>|jr<|j�||�}|s(t|||j|��|��}||��fS|||jkrZt|||j|��|}|d7}t|�}|j}||j	}t
||�}||kr�|||kr�|d7}q�d}	|||jkr�d}	|jr�||kr�|||kr�d}	|j
�r|dkr�||d|k�s||k�r|||k�rd}	|	�r.t|||j|��||||�fS)Nr�FTr)r�r7r!r��end�grouprRr�rTrWr]rVrUrX)
r�rRr�r�r-rJr�Z	bodycharsrKZthrowExceptionryryrzr��
s6


2zWord.parseImplcsvztt|���WStk
r$YnX|jdkrpdd�}|j|jkr`d||j�||j�f|_nd||j�|_|jS)NcSs$t|�dkr|dd�dS|SdS)N��...r��r�ryryrz�
charsAsStr�
sz Word.__str__.<locals>.charsAsStrz	W:(%s,%s)zW:(%s))rr1r�rpr{rQrS)r�rerryrzr��
s
zWord.__str__)Nr�rrFN)T�r�r�r�r�r�r�r�r1ryryrrzr1.
s.6
#csFeZdZdZee�d��Zd�fdd�	Zddd�Z	�fd	d
�Z
�ZS)
r)a�
    Token for matching strings that match a given regular expression.
    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
    named parse results.

    Example::
        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    z[A-Z]rcs�tt|���t|t�r�|s,tjdtdd�||_||_	zt
�|j|j	�|_
|j|_Wq�t
jk
r�tjd|tdd��Yq�Xn2t|tj�r�||_
t|�|_|_||_	ntd��t|�|_d|j|_d|_d|_d	S)
z�The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags.z0null string passed to Regex; use Empty() insteadrsr��$invalid pattern (%s) passed to RegexzCRegex may only be constructed with a string or a compiled RE objectr�FTN)rr)r�r}r�r�r�r��pattern�flagsr�r\rZ�
sre_constants�error�compiledREtyper~r�r�r�r�r�r�)r�rhrirryrzr��
s:
�
�
�
zRegex.__init__TcCs`|j�||�}|s"t|||j|��|��}|��}t|���}|rX|D]}||||<qF||fSr�)r�r7r!r�r`�	groupdictr$ra)r�rRr�r�r-�dr�r�ryryrzr��
szRegex.parseImplcsFztt|���WStk
r$YnX|jdkr@dt|j�|_|jS)NzRe:(%s))rr)r�rpr{r�rhr�rryrzr�
s
z
Regex.__str__)r)T)r�r�r�r�r�r�r\rlr�r�r�r1ryryrrzr)�
s
"

cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
r'a�
    Token for matching strings that are delimited by quoting characters.
    
    Defined with the following parameters:
        - quoteChar - string of one or more characters defining the quote delimiting string
        - escChar - character to escape quotes, typically backslash (default=C{None})
        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})

    Example::
        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
    prints::
        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    NFTc
sNtt����|��}|s0tjdtdd�t��|dkr>|}n"|��}|s`tjdtdd�t��|�_t	|��_
|d�_|�_t	|��_
|�_|�_|�_|�_|r�tjtjB�_dt��j�t�jd�|dk	r�t|�p�df�_n<d�_dt��j�t�jd�|dk	�rt|��pdf�_t	�j�d	k�rp�jd
d��fdd
�tt	�j�d	dd�D��d7_|�r��jdt�|�7_|�r��jdt�|�7_t��j�d�_�jdt��j�7_zt��j�j��_�j�_Wn0tjk
�r&tjd�jtdd��YnXt ���_!d�j!�_"d�_#d�_$dS)Nz$quoteChar cannot be the empty stringrsr�z'endQuoteChar cannot be the empty stringrz%s(?:[^%s%s]r�z%s(?:[^%s\n\r%s]r�z|(?:z)|(?:c3s4|],}dt��jd|��t�j|�fVqdS)z%s[^%s]N)r�r[�endQuoteCharrYr&r�ryrzr�Xs��z(QuotedString.__init__.<locals>.<genexpr>rt�)z|(?:%s)z|(?:%s.)z(.)z)*%srgr�FT)%rr'r�r�r�r�r��SyntaxError�	quoteCharr��quoteCharLen�firstQuoteCharro�endQuoteCharLen�escChar�escQuote�unquoteResults�convertWhitespaceEscapesr��	MULTILINE�DOTALLrir[rYrhr�r��escCharReplacePatternr\rZrjrkr�r�r�r�r�)r�rrrvrwZ	multilinerxroryrr�rzr�/s|



��
������
zQuotedString.__init__c	Cs�|||jkr|j�||�pd}|s4t|||j|��|��}|��}|jr�||j|j	�}t
|t�r�d|kr�|jr�ddddd�}|�
�D]\}}|�||�}q�|jr�t�|jd|�}|jr�|�|j|j�}||fS)N�\�	r2��
)�\tr'z\fz\rz\g<1>)rtr�r7r!r�r`rarxrsrur}r�ryr�r�rvr�r|rwro)	r�rRr�r�r-r�Zws_mapZwslitZwscharryryrzr�ps* 
�zQuotedString.parseImplcsHztt|���WStk
r$YnX|jdkrBd|j|jf|_|jS)Nz.quoted string, starting with %s ending with %s)rr'r�rpr{rrror�rryrzr��s
zQuotedString.__str__)NNFTNT)Trfryryrrzr'sA
#cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
ra�
    Token for matching words composed of characters I{not} in a given set (will
    include whitespace in matched characters if not listed in the provided exclusion set - see example).
    Defined with string containing all disallowed characters, and an optional
    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction.

    Example::
        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
    prints::
        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    r�rcs�tt|���d|_||_|dkr*td��||_|dkr@||_nt|_|dkrZ||_||_t	|�|_
d|j
|_|jdk|_d|_
dS)NFr�zfcannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permittedrr�)rrr�r~�notCharsr�rVrWr0r�r�r�r�r�)r�r�r]r^r_rryrzr��s 
zCharsNotIn.__init__TcCs�|||jkrt|||j|��|}|d7}|j}t||jt|��}||krb|||krb|d7}qD|||jkr�t|||j|��||||�fSr�)r�r!r�r]rWr�rV)r�rRr�r�rJZnotchars�maxlenryryrzr��s
�
zCharsNotIn.parseImplcsfztt|���WStk
r$YnX|jdkr`t|j�dkrTd|jdd�|_nd|j|_|jS)Nrbz
!W:(%s...)z!W:(%s))rrr�rpr{r�r�r�rryrzr��s
zCharsNotIn.__str__)r�rr)Trfryryrrzr�s
cs<eZdZdZdddddd�Zd�fdd�	Zddd�Z�ZS)r0a�
    Special matching class for matching whitespace.  Normally, whitespace is ignored
    by pyparsing grammars.  This class is included when some whitespace structures
    are significant.  Define with a string containing the whitespace characters to be
    matched; default is C{" \t\r\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
    as defined for the C{L{Word}} class.
    z<SPC>z<TAB>z<LF>z<CR>z<FF>)r(r~r2r�r� 	
r�rcs�tt����|�_��d��fdd��jD���d�dd��jD���_d�_d�j�_	|�_
|dkrt|�_nt�_|dkr�|�_|�_
dS)Nr�c3s|]}|�jkr|VqdSr�)�
matchWhiter�r�ryrzr��s
z!White.__init__.<locals>.<genexpr>css|]}tj|VqdSr�)r0�	whiteStrsr�ryryrzr��sTr�r)
rr0r�r�r
r�rr�r�r�rVrWr0)r�Zwsr]r^r_rr�rzr��s zWhite.__init__TcCs�|||jkrt|||j|��|}|d7}||j}t|t|��}||krb|||jkrb|d7}qB|||jkr�t|||j|��||||�fSr�)r�r!r�rWr]r�rV)r�rRr�r�rJrKryryrzr�	s

zWhite.parseImpl)r�r�rr)T)r�r�r�r�r�r�r�r1ryryrrzr0�s�cseZdZ�fdd�Z�ZS)�_PositionTokencs(tt|���|jj|_d|_d|_dSr�)rr�r�rmr�r�r�r�r�rryrzr�s
z_PositionToken.__init__�r�r�r�r�r1ryryrrzr�sr�cs2eZdZdZ�fdd�Zdd�Zd	dd�Z�ZS)
rzb
    Token to advance to a specific column of input text; useful for tabular report scraping.
    cstt|���||_dSr�)rrr�r;)r��colnorryrzr�$szGoToColumn.__init__cCs\t||�|jkrXt|�}|jr*|�||�}||krX||��rXt||�|jkrX|d7}q*|Sr�)r;r�r�r��isspace)r�rRr�r�ryryrzr�(s$
zGoToColumn.preParseTcCsDt||�}||jkr"t||d|��||j|}|||�}||fS)NzText not in expected column�r;r!)r�rRr�r�ZthiscolZnewlocr�ryryrzr�1s

zGoToColumn.parseImpl)T)r�r�r�r�r�r�r�r1ryryrrzr s	cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Matches if current position is at the beginning of a line within the parse string
    
    Example::
    
        test = '''        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)
    
    Prints::
        ['AAA', ' this line']
        ['AAA', ' and this line']    

    cstt|���d|_dS)NzExpected start of line)rrr�r�r�rryrzr�OszLineStart.__init__TcCs*t||�dkr|gfSt|||j|��dSr�)r;r!r�r�ryryrzr�SszLineStart.parseImpl)Tr5ryryrrzr:scs*eZdZdZ�fdd�Zddd�Z�ZS)rzU
    Matches if current position is at the end of a line within the parse string
    cs,tt|���|�tj�dd��d|_dS)Nr2r�zExpected end of line)rrr�r
r&rsr�r�r�rryrzr�\szLineEnd.__init__TcCsb|t|�kr6||dkr$|ddfSt|||j|��n(|t|�krN|dgfSt|||j|��dS)Nr2r��r�r!r�r�ryryrzr�aszLineEnd.parseImpl)Tr5ryryrrzrXscs*eZdZdZ�fdd�Zddd�Z�ZS)r,zM
    Matches if current position is at the beginning of the parse string
    cstt|���d|_dS)NzExpected start of text)rr,r�r�r�rryrzr�pszStringStart.__init__TcCs0|dkr(||�|d�kr(t|||j|��|gfSr�)r�r!r�r�ryryrzr�tszStringStart.parseImpl)Tr5ryryrrzr,lscs*eZdZdZ�fdd�Zddd�Z�ZS)r+zG
    Matches if current position is at the end of the parse string
    cstt|���d|_dS)NzExpected end of text)rr+r�r�r�rryrzr�szStringEnd.__init__TcCs^|t|�krt|||j|��n<|t|�kr6|dgfS|t|�krJ|gfSt|||j|��dSr�r�r�ryryrzr��szStringEnd.parseImpl)Tr5ryryrrzr+{scs.eZdZdZef�fdd�	Zddd�Z�ZS)r3ap
    Matches if the current position is at the beginning of a Word, and
    is not preceded by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
    the string being parsed, or at the beginning of a line.
    cs"tt|���t|�|_d|_dS)NzNot at the start of a word)rr3r�r��	wordCharsr��r�r�rryrzr��s
zWordStart.__init__TcCs@|dkr8||d|jks(|||jkr8t|||j|��|gfSr�)r�r!r�r�ryryrzr��s�zWordStart.parseImpl)T�r�r�r�r�rXr�r�r1ryryrrzr3�scs.eZdZdZef�fdd�	Zddd�Z�ZS)r2aZ
    Matches if the current position is at the end of a Word, and
    is not followed by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
    the string being parsed, or at the end of a line.
    cs(tt|���t|�|_d|_d|_dS)NFzNot at the end of a word)rr2r�r�r�r~r�r�rryrzr��s
zWordEnd.__init__TcCsPt|�}|dkrH||krH|||jks8||d|jkrHt|||j|��|gfSr�)r�r�r!r�)r�rRr�r�r�ryryrzr��s�zWordEnd.parseImpl)Tr�ryryrrzr2�scs�eZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Z�fdd�Z�fd
d�Z	�fdd�Z
d�fdd�	Zgfdd�Z�fdd�Z
�ZS)r"z^
    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r"t|�}t|t�r<t�|�g|_	nht|t
�rxt|�}tdd�|D��rlttj|�}t|�|_	n,zt|�|_	Wnt
k
r�|g|_	YnXd|_dS)Ncss|]}t|t�VqdSr�)r}r�)r�rSryryrzr��sz+ParseExpression.__init__.<locals>.<genexpr>F)rr"r�r}r�r�r�r&rw�exprsr�allr�r�r��r�r�r�rryrzr��s


zParseExpression.__init__cCs
|j|Sr�)r�r�ryryrzr��szParseExpression.__getitem__cCs|j�|�d|_|Sr�)r�rr{r"ryryrzr�szParseExpression.appendcCs0d|_dd�|jD�|_|jD]}|��q|S)z~Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
           all contained expressions.FcSsg|]}|���qSryr�r�r�ryryrzr��sz3ParseExpression.leaveWhitespace.<locals>.<listcomp>)r~r�r)r�r�ryryrzr�s


zParseExpression.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jD]}|�|jd�q*n,tt|��|�|jD]}|�|jd�qX|Sr�)r}r-r�rr"rr�)r�rr�rryrzr�s



zParseExpression.ignorecsNztt|���WStk
r$YnX|jdkrHd|jjt|j�f|_|jS�Nz%s:(%s))	rr"r�rpr{rmr�r�r�r�rryrzr��s
zParseExpression.__str__cs*tt|���|jD]}|��qt|j�dk�r|jd}t||j�r�|js�|jdkr�|j	s�|jdd�|jdg|_d|_
|j|jO_|j|jO_|jd}t||j��r|j�s|jdk�r|j	�s|jdd�|jdd�|_d|_
|j|jO_|j|jO_dt
|�|_|S)Nrsrr�rtr�)rr"r�r�r�r}rmryr|r�r{r�r�r�r�)r�r�rrryrzr��s<


���
���zParseExpression.streamlinecstt|��||�}|Sr�)rr"r�)r�r�r�r�rryrzr�
szParseExpression.setResultsNamecCs6|dd�|g}|jD]}|�|�q|�g�dSr�)r�rr)r�r�tmpr�ryryrzr
s
zParseExpression.validatecs$tt|���}dd�|jD�|_|S)NcSsg|]}|���qSryrr�ryryrzr�%
sz(ParseExpression.copy.<locals>.<listcomp>)rr"r�r�r1rryrzr�#
szParseExpression.copy)F)F)r�r�r�r�r�r�rrrr�r�r�rr�r1ryryrrzr"�s	
"csTeZdZdZGdd�de�Zd�fdd�	Zddd�Zd	d
�Zdd�Z	d
d�Z
�ZS)ra

    Requires all given C{ParseExpression}s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'+'} operator.
    May also be constructed using the C{'-'} operator, which will suppress backtracking.

    Example::
        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"),name_expr("name"),integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    cseZdZ�fdd�Z�ZS)zAnd._ErrorStopcs&ttj|�j||�d|_|��dS)N�-)rrr�r�r�rrGrryrzr�9
szAnd._ErrorStop.__init__r�ryryrrzr�8
sr�TcsRtt|��||�tdd�|jD��|_|�|jdj�|jdj|_d|_	dS)Ncss|]}|jVqdSr��r�r�ryryrzr�@
szAnd.__init__.<locals>.<genexpr>rT)
rrr�r�r�r�r
rr~r�r�rryrzr�>
s
zAnd.__init__c	Cs�|jdj|||dd�\}}d}|jdd�D]�}t|tj�rDd}q.|r�z|�|||�\}}Wq�tk
rt�Yq�tk
r�}zd|_t�|��W5d}~XYq�t	k
r�t|t
|�|j|��Yq�Xn|�|||�\}}|s�|��r.||7}q.||fS)NrFr�r�T)
r�r�r}rr�r%r�
__traceback__r�r�r�r�r
)	r�rRr�r��
resultlistZ	errorStopr�Z
exprtokensr�ryryrzr�E
s(
z
And.parseImplcCst|t�rt�|�}|�|�Sr��r}r�r&rwrr"ryryrzr!^
s

zAnd.__iadd__cCs6|dd�|g}|jD]}|�|�|jsq2qdSr�)r�rr��r�r��subRecCheckListr�ryryrzrc
s


zAnd.checkRecursioncCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr��{r(css|]}t|�VqdSr�r�r�ryryrzr�o
szAnd.__str__.<locals>.<genexpr>�}�r�r�r{r�r�r�ryryrzr�j
s


 zAnd.__str__)T)T)r�r�r�r�rr�r�r�r!rr�r1ryryrrzr(
s
csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the expression that matches the longest string will be used.
    May be constructed using the C{'^'} operator.

    Example::
        # construct Or using '^' operator
        
        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))
    prints::
        [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
szOr.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szOr.__init__TcCsRd}d}g}|jD]�}z|�||�}Wnvtk
rb}	zd|	_|	j|krR|	}|	j}W5d}	~	XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqX|�||f�q|�r(|j	dd�d�|D]^\}
}z|�
|||�WStk
�r$}	z d|	_|	j|k�r|	}|	j}W5d}	~	XYq�Xq�|dk	�r@|j|_|�nt||d|��dS)NrtcSs
|dSr�ry)�xryryrzr{�
r|zOr.parseImpl.<locals>.<lambda>)r� no defined alternatives to match)r�r�r!r�r�r�r�r�r�sortr�r�)r�rRr�r��	maxExcLoc�maxExceptionr�r�Zloc2r��_ryryrzr��
s<


zOr.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ixor__�
s

zOr.__ixor__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z ^ css|]}t|�VqdSr�r�r�ryryrzr��
szOr.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 z
Or.__str__cCs,|dd�|g}|jD]}|�|�qdSr��r�rr�ryryrzr�
s
zOr.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzrt
s

&	csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the first one listed is the one that will match.
    May be constructed using the C{'|'} operator.

    Example::
        # construct MatchFirst using '|' operator
        
        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
sz&MatchFirst.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szMatchFirst.__init__Tc	Cs�d}d}|jD]�}z|�|||�}|WStk
r`}z|j|krP|}|j}W5d}~XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqXq|dk	r�|j|_|�nt||d|��dS)Nrtr�)r�r�r!r�r�r�r�r�)	r�rRr�r�r�r�r�r�r�ryryrzr��
s$


zMatchFirst.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ior__�
s

zMatchFirst.__ior__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�� | css|]}t|�VqdSr�r�r�ryryrzr��
sz%MatchFirst.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 zMatchFirst.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzrs
zMatchFirst.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzr�
s
	cs<eZdZdZd�fdd�	Zddd�Zdd�Zd	d
�Z�ZS)
ram
    Requires all given C{ParseExpression}s to be found, but in any order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'&'} operator.

    Example::
        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order 
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )
    prints::
        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    Tcs8tt|��||�tdd�|jD��|_d|_d|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr�?sz Each.__init__.<locals>.<genexpr>T)rrr�r�r�r�r~�initExprGroupsr�rryrzr�=sz
Each.__init__c	s�|jr�tdd�|jD��|_dd�|jD�}dd�|jD�}|||_dd�|jD�|_dd�|jD�|_dd�|jD�|_|j|j7_d	|_|}|jdd�}|jdd��g}d
}	|	�rj|�|j|j}
g}|
D]v}z|�||�}Wn t	k
�r|�
|�Yq�X|�
|j�t|�|��||k�r@|�
|�q�|�kr܈�
|�q�t|�t|
�kr�d	}	q�|�r�d�dd�|D��}
t	||d
|
��|�fdd�|jD�7}g}|D]"}|�|||�\}}|�
|��q�t|tg��}||fS)Ncss&|]}t|t�rt|j�|fVqdSr�)r}rr!rSr�ryryrzr�Es
z!Each.parseImpl.<locals>.<genexpr>cSsg|]}t|t�r|j�qSry�r}rrSr�ryryrzr�Fs
z"Each.parseImpl.<locals>.<listcomp>cSs g|]}|jrt|t�s|�qSry)r�r}rr�ryryrzr�Gs
cSsg|]}t|t�r|j�qSry)r}r4rSr�ryryrzr�Is
cSsg|]}t|t�r|j�qSry)r}rrSr�ryryrzr�Js
cSs g|]}t|tttf�s|�qSry)r}rr4rr�ryryrzr�KsFTr%css|]}t|�VqdSr�r�r�ryryrzr�fsz*Missing one or more required elements (%s)cs$g|]}t|t�r|j�kr|�qSryr�r��ZtmpOptryrzr�js

)r�r�r�Zopt1mapZ	optionalsZmultioptionalsZ
multirequiredZrequiredr�r!rr�r!�remover�r�r��sumr$)r�rRr�r�Zopt1Zopt2ZtmpLocZtmpReqdZ
matchOrderZkeepMatchingZtmpExprsZfailedr�Zmissingr�rNZfinalResultsryr�rzr�CsP

zEach.parseImplcCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z & css|]}t|�VqdSr�r�r�ryryrzr�yszEach.__str__.<locals>.<genexpr>r�r�r�ryryrzr�ts


 zEach.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzr}s
zEach.checkRecursion)T)T)	r�r�r�r�r�r�r�rr1ryryrrzrs
5
1	csleZdZdZd�fdd�	Zddd�Zdd	�Z�fd
d�Z�fdd
�Zdd�Z	gfdd�Z
�fdd�Z�ZS)r za
    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r@ttjt�r2t�|�}nt�t	|��}||_
d|_|dk	r�|j|_|j
|_
|�|j�|j|_|j|_|j|_|j�|j�dSr�)rr r�r}r��
issubclassr&rwr.rrSr{r�r�r
rr~r}r�r�r�r�rSr�rryrzr��s
zParseElementEnhance.__init__TcCs2|jdk	r|jj|||dd�Std||j|��dS)NFr�r�)rSr�r!r�r�ryryrzr��s
zParseElementEnhance.parseImplcCs*d|_|j��|_|jdk	r&|j��|Sr�)r~rSr�rr�ryryrzr�s


z#ParseElementEnhance.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jdk	rn|j�|jd�n,tt|��|�|jdk	rn|j�|jd�|Sr�)r}r-r�rr rrSr"rryrzr�s



zParseElementEnhance.ignorecs&tt|���|jdk	r"|j��|Sr�)rr r�rSr�rryrzr��s

zParseElementEnhance.streamlinecCsB||krt||g��|dd�|g}|jdk	r>|j�|�dSr�)r(rSr)r�r�r�ryryrzr�s

z"ParseElementEnhance.checkRecursioncCs6|dd�|g}|jdk	r(|j�|�|�g�dSr��rSrr�r�rr�ryryrzr�s
zParseElementEnhance.validatecsXztt|���WStk
r$YnX|jdkrR|jdk	rRd|jjt|j�f|_|jSr�)	rr r�rpr{rSrmr�r�r�rryrzr��szParseElementEnhance.__str__)F)T)
r�r�r�r�r�r�rrr�rrr�r1ryryrrzr �s
cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Lookahead matching of the given parse expression.  C{FollowedBy}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression matches at the current
    position.  C{FollowedBy} always returns a null token list.

    Example::
        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
    prints::
        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    cstt|��|�d|_dSr�)rrr�r��r�rSrryrzr��szFollowedBy.__init__TcCs|j�||�|gfSr�)rSr�r�ryryrzr��szFollowedBy.parseImpl)Tr5ryryrrzr�scs2eZdZdZ�fdd�Zd	dd�Zdd�Z�ZS)
ra�
    Lookahead to disallow matching with the given parse expression.  C{NotAny}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression does I{not} match at the current
    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
    always returns a null token list.  May be constructed using the '~' operator.

    Example::
        
    cs0tt|��|�d|_d|_dt|j�|_dS)NFTzFound unwanted token, )rrr�r~r�r�rSr�r�rryrzr��szNotAny.__init__TcCs&|j�||�rt|||j|��|gfSr�)rSr�r!r�r�ryryrzr��szNotAny.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�z~{r��r�r�r{r�rSr�ryryrzr�s


zNotAny.__str__)Trfryryrrzr�s

cs(eZdZd�fdd�	Zddd�Z�ZS)	�_MultipleMatchNcsFtt|��|�d|_|}t|t�r.t�|�}|dk	r<|nd|_dSr�)	rr�r�r}r}r�r&rw�	not_ender)r�rS�stopOnZenderrryrzr�s

z_MultipleMatch.__init__Tc	Cs�|jj}|j}|jdk	}|r$|jj}|r2|||�||||dd�\}}zV|j}	|r`|||�|	rp|||�}
n|}
|||
|�\}}|s�|��rR||7}qRWnttfk
r�YnX||fS�NFr�)	rSr�r�r�r�r�r
r!r�)r�rRr�r�Zself_expr_parseZself_skip_ignorablesZcheck_enderZ
try_not_enderr�ZhasIgnoreExprsr�Z	tmptokensryryrzr�s*



z_MultipleMatch.parseImpl)N)T)r�r�r�r�r�r1ryryrrzr�
sr�c@seZdZdZdd�ZdS)ra�
    Repetition of one or more of the given expression.
    
    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
        
        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    cCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r�z}...r�r�ryryrzr�Js


zOneOrMore.__str__N)r�r�r�r�r�ryryryrzr0scs8eZdZdZd
�fdd�	Zd�fdd�	Zdd	�Z�ZS)r4aw
    Optional repetition of zero or more of the given expression.
    
    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example: similar to L{OneOrMore}
    Ncstt|�j||d�d|_dS)N)r�T)rr4r�r�)r�rSr�rryrzr�_szZeroOrMore.__init__Tc	s<ztt|��|||�WSttfk
r6|gfYSXdSr�)rr4r�r!r�r�rryrzr�cszZeroOrMore.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$�]...r�r�ryryrzr�is


zZeroOrMore.__str__)N)Trfryryrrzr4Ssc@s eZdZdd�ZeZdd�ZdS)�
_NullTokencCsdSr�ryr�ryryrzr�ssz_NullToken.__bool__cCsdSr�ryr�ryryrzr�vsz_NullToken.__str__N)r�r�r�r�rLr�ryryryrzr�rsr�cs6eZdZdZef�fdd�	Zd	dd�Zdd�Z�ZS)
raa
    Optional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::
        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345
            
            # ZIP+4 form
            12101-0001
            
            # invalid ZIP
            98765-
            ''')
    prints::
        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    cs.tt|�j|dd�|jj|_||_d|_dS)NFr3T)rrr�rSr}rr�)r�rSrrryrzr��s
zOptional.__init__Tc	Cszz|jj|||dd�\}}WnTttfk
rp|jtk	rh|jjr^t|jg�}|j||jj<ql|jg}ng}YnX||fSr�)rSr�r!r�r�_optionalNotMatchedr|r$)r�rRr�r�r�ryryrzr��s


zOptional.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$r'r�r�ryryrzr��s


zOptional.__str__)T)	r�r�r�r�r�r�r�r�r1ryryrrzrzs"
cs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r*a�	
    Token for skipping over all undefined text until the matched expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default=C{False}) if True, the target expression is also parsed 
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
          comments) that might contain false matches to the target expression
     - failOn - (default=C{None}) define expressions that are not allowed to be 
          included in the skipped test; if found before the target expression is found, 
          the SkipTo is not a match

    Example::
        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP 
                      + string_data("sev") + SEP 
                      + string_data("desc") + SEP 
                      + integer("days_open"))
        
        for tkt in ticket_expr.searchString(report):
            print tkt.dump()
    prints::
        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    FNcs`tt|��|�||_d|_d|_||_d|_t|t	�rFt
�|�|_n||_dt
|j�|_dS)NTFzNo match found for )rr*r��
ignoreExprr�r��includeMatchr�r}r�r&rw�failOnr�rSr�)r�rZincluderr�rryrzr��s
zSkipTo.__init__Tc	Cs&|}t|�}|j}|jj}|jdk	r,|jjnd}|jdk	rB|jjnd}	|}
|
|kr�|dk	rf|||
�rfq�|	dk	r�z|	||
�}
Wqntk
r�Yq�YqnXqnz|||
ddd�Wq�tt	fk
r�|
d7}
YqJXq�qJt|||j
|��|
}|||�}t|�}|j�r||||dd�\}}
||
7}||fS)NF)r�r�r�r�)
r�rSr�r�r�r�r�rr!r�r�r$r�)r�rRr�r�rUr�rSZ
expr_parseZself_failOn_canParseNextZself_ignoreExpr_tryParseZtmplocZskiptextZ
skipresultrMryryrzr��s:
zSkipTo.parseImpl)FNN)Tr5ryryrrzr*�s6
csbeZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zgfd
d�Z	dd�Z
�fdd�Z�ZS)raK
    Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.

    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
    Specifically, '|' has a lower precedence than '<<', so that::
        fwdExpr << a | b | c
    will actually be evaluated as::
        (fwdExpr << a) | b | c
    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the C{Forward}::
        fwdExpr << (a | b | c)
    Converting to use the '<<=' operator instead will avoid this problem.

    See L{ParseResults.pprint} for an example of a recursive parser created using
    C{Forward}.
    Ncstt|�j|dd�dSr2)rrr�r"rryrzr�@szForward.__init__cCsjt|t�rt�|�}||_d|_|jj|_|jj|_|�|jj	�|jj
|_
|jj|_|j�
|jj�|Sr�)r}r�r&rwrSr{r�r�r
rr~r}r�rr"ryryrz�
__lshift__Cs





zForward.__lshift__cCs||>Sr�ryr"ryryrz�__ilshift__PszForward.__ilshift__cCs
d|_|Sr�rr�ryryrzrSszForward.leaveWhitespacecCs$|js d|_|jdk	r |j��|Sr�)r�rSr�r�ryryrzr�Ws


zForward.streamlinecCs>||kr0|dd�|g}|jdk	r0|j�|�|�g�dSr�r�r�ryryrzr^s

zForward.validatecCsVt|d�r|jS|jjdSz|jdk	r4t|j�}nd}W5|j|_X|jjd|S)Nr�z: ...�Nonez: )r�r�rmr�Z_revertClass�_ForwardNoRecurserSr�)r�Z	retStringryryrzr�es


zForward.__str__cs.|jdk	rtt|���St�}||K}|SdSr�)rSrrr�r1rryrzr�vs

zForward.copy)N)
r�r�r�r�r�r�r�rr�rr�r�r1ryryrrzr-s
c@seZdZdd�ZdS)r�cCsdS)Nrcryr�ryryrzr�sz_ForwardNoRecurse.__str__N)r�r�r�r�ryryryrzr�~sr�cs"eZdZdZd�fdd�	Z�ZS)r/zQ
    Abstract subclass of C{ParseExpression}, for converting parsed results.
    Fcstt|��|�d|_dSr�)rr/r�r}r�rryrzr��szTokenConverter.__init__)Fr4ryryrrzr/�scs6eZdZdZd
�fdd�	Z�fdd�Zdd	�Z�ZS)ra�
    Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the input string;
    this can be disabled by specifying C{'adjacent=False'} in the constructor.

    Example::
        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    r�Tcs8tt|��|�|r|��||_d|_||_d|_dSr�)rrr�r�adjacentr~�
joinStringr�)r�rSr�r�rryrzr��szCombine.__init__cs(|jrt�||�ntt|��|�|Sr�)r�r&rrrr"rryrzr�szCombine.ignorecCsP|��}|dd�=|td�|�|j��g|jd�7}|jrH|��rH|gS|SdS)Nr�)r�)r�r$r�r(r�r�r|r
)r�rRr�r�ZretToksryryrzr��s
"zCombine.postParse)r�T)r�r�r�r�r�rr�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)ra�
    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.

    Example::
        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
    cstt|��|�d|_dSr�)rrr�r}r�rryrzr��szGroup.__init__cCs|gSr�ryr�ryryrzr��szGroup.postParse�r�r�r�r�r�r�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)r
aW
    Converter to return a repetitive expression as a list, but also as a dictionary.
    Each element can also be referenced using the first token in the expression as its key.
    Useful for tabular report scraping when the first column can be used as a item key.

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())
        
        # access named fields as dict entries, or output as dict
        print(result['shape'])        
        print(result.asDict())
    prints::
        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
    See more examples at L{ParseResults} of accessing fields by results name.
    cstt|��|�d|_dSr�)rr
r�r}r�rryrzr��sz
Dict.__init__cCs�t|�D]�\}}t|�dkrq|d}t|t�r@t|d���}t|�dkr\td|�||<qt|�dkr�t|dt�s�t|d|�||<q|��}|d=t|�dks�t|t�r�|�	�r�t||�||<qt|d|�||<q|j
r�|gS|SdS)Nrr�r�rs)r�r�r}rvr�r�r�r$r�r
r|)r�rRr�r�r��tokZikeyZ	dictvalueryryrzr��s$
zDict.postParser�ryryrrzr
�s#c@s eZdZdZdd�Zdd�ZdS)r-aV
    Converter for ignoring the results of a parsed expression.

    Example::
        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))
    prints::
        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']
    (See also L{delimitedList}.)
    cCsgSr�ryr�ryryrzr�szSuppress.postParsecCs|Sr�ryr�ryryrzr
"szSuppress.suppressN)r�r�r�r�r�r
ryryryrzr-sc@s(eZdZdZdd�Zdd�Zdd�ZdS)	rzI
    Wrapper for parse actions, to ensure they are only called once.
    cCst|�|_d|_dSr�)rr�callable�called)r�Z
methodCallryryrzr�*s
zOnlyOnce.__init__cCs.|js|�|||�}d|_|St||d��dS)NTr�)r�r�r!)r�r�r[rxrNryryrzr	-s
zOnlyOnce.__call__cCs
d|_dSr�)r�r�ryryrz�reset3szOnlyOnce.resetN)r�r�r�r�r�r	r�ryryryrzr&scs:t����fdd�}z�j|_Wntk
r4YnX|S)at
    Decorator for debugging parse actions. 
    
    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.

    Example::
        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
    prints::
        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    c
s��j}|dd�\}}}t|�dkr8|djjd|}tj�d|t||�||f�z�|�}Wn8tk
r�}ztj�d||f��W5d}~XYnXtj�d||f�|S)Nr^rqr�.z">>entering %s(line: '%s', %d, %r)
z<<leaving %s (exception: %s)
z<<leaving %s (ret: %r)
)r�r�rmr��stderr�writerIrp)ZpaArgsZthisFuncr�r[rxr�rX�rryrz�zLsztraceParseAction.<locals>.z)rrr�r�)rr�ryr�rzrd6s
�,FcCs`t|�dt|�dt|�d}|rBt|t||���|�S|tt|�|��|�SdS)a�
    Helper to define a delimited list of expressions - the delimiter defaults to ','.
    By default, the list elements and delimiters can have intervening whitespace, and
    comments, but this can be overridden by passing C{combine=True} in the constructor.
    If C{combine} is set to C{True}, the matching tokens are returned as a single token
    string, with the delimiters included; otherwise, the matching tokens are returned
    as a list of tokens, with the delimiters suppressed.

    Example::
        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    z [r(r�N)r�rr4r�r-)rSZdelim�combineZdlNameryryrzrBbs
$csjt����fdd�}|dkr0tt��dd��}n|��}|�d�|j|dd�|��d	t��d
�S)a:
    Helper to define a counted list of expressions.
    This helper defines a pattern of the form::
        integer expr expr expr...
    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
    
    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.

    Example::
        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    cs.|d}�|r tt�g|��p&tt�>gSr�)rrrE)r�r[rxr��Z	arrayExprrSryrz�countFieldParseAction�s"z+countedArray.<locals>.countFieldParseActionNcSst|d�Sr�)rvrwryryrzr{�r|zcountedArray.<locals>.<lambda>ZarrayLenT�r�z(len) rc)rr1rTr�r�r�r�r�)rSZintExprr�ryr�rzr>us
cCs6g}|D](}t|t�r&|�t|��q|�|�q|Sr�)r}r�rr�r)�Lr�r�ryryrzr��s
r�cs6t���fdd�}|j|dd���dt|���S)a*
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
    If this is not desired, use C{matchPreviousExpr}.
    Do I{not} use with packrat parsing enabled.
    csP|rBt|�dkr�|d>qLt|���}�tdd�|D��>n
�t�>dS)Nr�rcss|]}t|�VqdSr�)r�r�Zttryryrzr��szDmatchPreviousLiteral.<locals>.copyTokenToRepeater.<locals>.<genexpr>)r�r�r�rr)r�r[rxZtflat�Zrepryrz�copyTokenToRepeater�sz1matchPreviousLiteral.<locals>.copyTokenToRepeaterTr��(prev) )rr�r�r�)rSr�ryr�rzrQ�s


csFt��|��}�|K��fdd�}|j|dd���dt|���S)aS
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
    the expressions are evaluated first, and then compared, so
    C{"1"} is compared with C{"10"}.
    Do I{not} use with packrat parsing enabled.
    cs*t|�����fdd�}�j|dd�dS)Ncs$t|���}|�kr tddd��dS)Nr�r)r�r�r!)r�r[rxZtheseTokens�ZmatchTokensryrz�mustMatchTheseTokens�szLmatchPreviousExpr.<locals>.copyTokenToRepeater.<locals>.mustMatchTheseTokensTr�)r�r�r�)r�r[rxr�r�r�rzr��sz.matchPreviousExpr.<locals>.copyTokenToRepeaterTr�r�)rr�r�r�r�)rSZe2r�ryr�rzrP�scCs:dD]}|�|t|�}q|�dd�}|�dd�}t|�S)Nz\^-]r2r'r~r�)r��_bslashr�)r�r�ryryrzrY�s
rYTc
s�|rdd�}dd�}t�ndd�}dd�}t�g}t|t�rF|��}n$t|t�rZt|�}ntjdt	dd�|stt
�Sd	}|t|�d
k�r||}t||d
d��D]R\}}	||	|�r�|||d
=qxq�|||	�r�|||d
=|�
||	�|	}qxq�|d
7}qx|�s�|�r�zlt|�td�|��k�rTtd
d�dd�|D����d�|��WStd�dd�|D����d�|��WSWn&tk
�r�tjdt	dd�YnXt�fdd�|D���d�|��S)a�
    Helper to quickly define a set of alternative Literals, and makes sure to do
    longest-first testing when there is a conflict, regardless of the input order,
    but returns a C{L{MatchFirst}} for best performance.

    Parameters:
     - strs - a string of space-delimited literals, or a collection of string literals
     - caseless - (default=C{False}) - treat all literals as caseless
     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
          if creating a C{Regex} raises an exception)

    Example::
        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
    prints::
        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    cSs|��|��kSr�)r@�r�bryryrzr{�r|zoneOf.<locals>.<lambda>cSs|���|���Sr�)r@r<r�ryryrzr{�r|cSs||kSr�ryr�ryryrzr{�r|cSs
|�|�Sr�)r<r�ryryrzr{�r|z6Invalid argument to oneOf, expected string or iterablersr�rr�Nr�z[%s]css|]}t|�VqdSr�)rY�r�Zsymryryrzr�szoneOf.<locals>.<genexpr>r��|css|]}t�|�VqdSr�)r�r[r�ryryrzr�sz7Exception creating Regex for oneOf, building MatchFirstc3s|]}�|�VqdSr�ryr��ZparseElementClassryrzr�$s)r
rr}r�r�rr�r�r�r�rr�r�rr�r)r�rpr)
Zstrsr?ZuseRegexZisequalZmasksZsymbolsr�Zcurr�rryr�rzrU�sT



�


**�cCsttt||���S)a�
    Helper to easily and clearly define a dictionary by specifying the respective patterns
    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
    in the proper order.  The key pattern can include delimiting markers or punctuation,
    as long as they are suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the C{Dict} results can include named token
    fields.

    Example::
        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())
    prints::
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    )r
r4r)rr�ryryrzrC&s!cCs^t��dd��}|��}d|_|d�||d�}|r@dd�}ndd�}|�|�|j|_|S)	a�
    Helper to return the original, untokenized text for a given expression.  Useful to
    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
    revert separate tokens with intervening whitespace back to the original matching
    input text. By default, returns astring containing the original parsed text.  
       
    If the optional C{asString} argument is passed as C{False}, then the return value is a 
    C{L{ParseResults}} containing any results names that were originally matched, and a 
    single token containing the original matched text from the input string.  So if 
    the expression passed to C{L{originalTextFor}} contains expressions with defined
    results names, you must set C{asString} to C{False} if you want to preserve those
    results name values.

    Example::
        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b","i"):
            opener,closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])
    prints::
        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    cSs|Sr�ry)r�r�rxryryrzr{ar|z!originalTextFor.<locals>.<lambda>F�_original_start�
_original_endcSs||j|j�Sr�)r�r�rZryryrzr{fr|cSs&||�d�|�d��g|dd�<dS)Nr�r�)rrZryryrz�extractTexthsz$originalTextFor.<locals>.extractText)rr�r�r�r�)rSZasStringZ	locMarkerZendlocMarker�	matchExprr�ryryrzriIs

cCst|��dd��S)zp
    Helper to undo pyparsing's default grouping of And expressions, even
    if all but one are non-empty.
    cSs|dSr�ryrwryryrzr{sr|zungroup.<locals>.<lambda>)r/r�)rSryryrzrjnscCs4t��dd��}t|d�|d�|����d��S)a�
    Helper to decorate a returned token with its starting and ending locations in the input string.
    This helper adds the following results names:
     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains C{<TAB>} characters, you may want to call
    C{L{ParserElement.parseWithTabs}}

    Example::
        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)
    prints::
        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    cSs|Sr�ryrZryryrzr{�r|zlocatedExpr.<locals>.<lambda>Z
locn_startr�Zlocn_end)rr�rr�r)rSZlocatorryryrzrlusz\[]-*.$+^?()~ �r_cCs|ddSr�ryrZryryrzr{�r|r{z\\0?[xX][0-9a-fA-F]+cCstt|d�d�d��S)Nrz\0x�)�unichrrv�lstriprZryryrzr{�r|z	\\0[0-7]+cCstt|ddd�d��S)Nrr��)r�rvrZryryrzr{�r|z\]r�r$r)�negate�bodyr'csFdd��z"d��fdd�t�|�jD��WStk
r@YdSXdS)a�
    Helper to easily define string ranges for use in Word construction.  Borrows
    syntax from regexp '[]' string range definitions::
        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
    The input string must be enclosed in []'s, and the returned string is the expanded
    character set joined into a single string.
    The values enclosed in the []'s may be:
     - a single character
     - an escaped character with a leading backslash (such as C{\-} or C{\]})
     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
         (C{\0x##} is also supported for backwards compatibility) 
     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
    cSs<t|t�s|Sd�dd�tt|d�t|d�d�D��S)Nr�css|]}t|�VqdSr�)r�r�ryryrzr��sz+srange.<locals>.<lambda>.<locals>.<genexpr>rr�)r}r$r�r��ord)�pryryrzr{�r|zsrange.<locals>.<lambda>r�c3s|]}�|�VqdSr�ry)r��part�Z	_expandedryrzr��szsrange.<locals>.<genexpr>N)r��_reBracketExprr�r�rprdryr�rzra�s
"cs�fdd�}|S)zt
    Helper method for defining parse actions that require matching at a specific
    column in the input text.
    cs"t||��krt||d���dS)Nzmatched token not at column %dr�)rNZlocnrVr�ryrz�	verifyCol�sz!matchOnlyAtCol.<locals>.verifyColry)r�r�ryr�rzrO�scs�fdd�S)a�
    Helper method for common parse actions that simply return a literal value.  Especially
    useful when used with C{L{transformString<ParserElement.transformString>}()}.

    Example::
        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num
        
        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    cs�gSr�ryrZ�ZreplStrryrzr{�r|zreplaceWith.<locals>.<lambda>ryr�ryr�rzr^�scCs|ddd�S)a
    Helper parse action for removing quotation marks from parsed quoted strings.

    Example::
        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    rr�rtryrZryryrzr\�scsN��fdd�}zt�dt�d�j�}Wntk
rBt��}YnX||_|S)aG
    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
    args are passed, they are forwarded to the given function as additional arguments after
    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
    parsed data to an integer using base 16.

    Example (compare the last to example in L{ParserElement.transformString}::
        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')
        
        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')
    prints::
        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    cs��fdd�|D�S)Ncsg|]}�|f����qSryry)r�Ztokn�r�r\ryrzr��sz(tokenMap.<locals>.pa.<locals>.<listcomp>ryrZr�ryrzr��sztokenMap.<locals>.par�rm)ror�rpr~)r\r�r�rqryr�rzro�s 
�cCst|���Sr��r�r@rwryryrzr{r|cCst|���Sr��r��lowerrwryryrzr{r|c	Cs�t|t�r|}t||d�}n|j}tttd�}|r�t���	t
�}td�|d�tt
t|td�|���tddgd��d	��	d
d��td�}n�d
�dd�tD��}t���	t
�t|�B}td�|d�tt
t|�	t�ttd�|����tddgd��d	��	dd��td�}ttd�|d�}|�dd
�|�dd��������d|�}|�dd
�|�dd��������d|�}||_||_||fS)zRInternal helper to construct opening and closing tag expressions, given a tag namerEz_-:r5�tag�=�/F�rrEcSs|ddkS�Nrr�ryrZryryrzr{r|z_makeTags.<locals>.<lambda>r6r�css|]}|dkr|VqdS)r6Nryr�ryryrzr�sz_makeTags.<locals>.<genexpr>cSs|ddkSr�ryrZryryrzr{r|r7rJ�:r(z<%s>r`z</%s>)r}r�rr�r1r6r5r@r�r�r\r-r
r4rrr�r�rXr[rDr�_Lr��titler�r�r�)�tagStrZxmlZresnameZtagAttrNameZtagAttrValueZopenTagZprintablesLessRAbrackZcloseTagryryrz�	_makeTagss>
�������..rcCs
t|d�S)a 
    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.

    Example::
        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
        a,a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end
        
        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
            print(link.link_text, '->', link.href)
    prints::
        pyparsing -> http://pyparsing.wikispaces.com
    F�r�r�ryryrzrM(scCs
t|d�S)z�
    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
    tags only in the given upper/lower case.

    Example: similar to L{makeHTMLTags}
    TrrryryrzrN;scs8|r|dd��n|���dd��D���fdd�}|S)a<
    Helper to create a validating parse action to be used with start tags created
    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
    with a required attribute value, to avoid false matches on common tags such as
    C{<TD>} or C{<DIV>}.

    Call C{withAttribute} with a series of attribute names and values. Specify the list
    of filter attributes names and values as:
     - keyword arguments, as in C{(align="right")}, or
     - as an explicit dict with C{**} operator, when an attribute name is also a Python
          reserved word, as in C{**{"class":"Customer", "align":"right"}}
     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
    For attribute names with a namespace prefix, you must use the second form.  Attribute
    names are matched insensitive to upper/lower case.
       
    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.

    To verify that the attribute exists, but without specifying a value, pass
    C{withAttribute.ANY_VALUE} as the value.

    Example::
        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    NcSsg|]\}}||f�qSryryr/ryryrzr�zsz!withAttribute.<locals>.<listcomp>csZ�D]P\}}||kr$t||d|��|tjkr|||krt||d||||f��qdS)Nzno matching attribute z+attribute '%s' has value '%s', must be '%s')r!rg�	ANY_VALUE)r�r[r�ZattrNameZ	attrValue�Zattrsryrzr�{s�zwithAttribute.<locals>.pa)r�)r�ZattrDictr�ryrrzrgDs2cCs|rd|nd}tf||i�S)a�
    Simplified version of C{L{withAttribute}} when matching on a div class - made
    difficult because C{class} is a reserved word in Python.

    Example::
        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))
        
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    z%s:class�class)rg)Z	classname�	namespaceZ	classattrryryrzrm�s �(rpcCs�t�}||||B}t|�D�]l\}}|ddd�\}}	}
}|	dkrPd|nd|}|	dkr�|dkstt|�dkr|td��|\}
}t��|�}|
tjk�r^|	d	kr�t||�t|t	|��}n�|	dk�r|dk	r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�rTt||
|||�t||
|||�}ntd
��n�|
tj
k�rB|	d	k�r�t|t��s�t|�}t|j
|�t||�}n�|	dk�r�|dk	�r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�r8t||
|||�t||
|||�}ntd
��ntd��|�rvt|ttf��rl|j|�n
|�|�||�|�|BK}|}q||K}|S)aD

    Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary or
    binary, left- or right-associative.  Parse actions can also be attached
    to operator expressions. The generated parser will also recognize the use 
    of parentheses to override operator precedences (see example below).
    
    Note: if you define a deep operator list, you may see performance issues
    when using infixNotation. See L{ParserElement.enablePackrat} for a
    mechanism to potentially improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the nested
     - opList - list of tuples, one for each operator precedence level in the
      expression grammar; each tuple is of the form
      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
       - opExpr is the pyparsing expression for the operator;
          may also be a string, which will be converted to a Literal;
          if numTerms is 3, opExpr is a tuple of two expressions, for the
          two operators separating the 3 terms
       - numTerms is the number of terms for this operator (must
          be 1, 2, or 3)
       - rightLeftAssoc is the indicator whether the operator is
          right or left associative, using the pyparsing-defined
          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
       - parseAction is the parse action to be associated with
          expressions matching this operator expression (the
          parse action tuple member may be omitted); if the parse action
          is passed a tuple or list of functions, this is equivalent to
          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})

    Example::
        # simple example of four-function arithmetic with ints and variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier 
        
        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])
        
        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)
    prints::
        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    r�Nrbrqz%s termz	%s%s termrsz@if numterms=3, opExpr must be a tuple or list of two expressionsr�z6operator must be unary (1), binary (2), or ternary (3)z2operator must indicate right or left associativity)rr�r�r�r�rV�LEFTrrr�RIGHTr}rrSr�r�r�)ZbaseExprZopListZlparZrparr�ZlastExprr�ZoperDefZopExprZarityZrightLeftAssocr�ZtermNameZopExpr1ZopExpr2ZthisExprr�ryryrzrk�sZ=
&
�



&
�

z4"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�"z string enclosed in double quotesz4'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�'z string enclosed in single quotesz*quotedString using single or double quotes�uzunicode string literalcCs�||krtd��|dk�r*t|t��r"t|t��r"t|�dkr�t|�dkr�|dk	r�tt|t||tjdd����	dd��}n$t
��t||tj��	dd��}nx|dk	r�tt|t|�t|�ttjdd����	dd��}n4ttt|�t|�ttjdd����	d	d��}ntd
��t
�}|dk	�rd|tt|�t||B|B�t|��K}n$|tt|�t||B�t|��K}|�d||f�|S)a~	
    Helper method for defining nested lists enclosed in opening and closing
    delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
     - content - expression for items within the nested lists (default=C{None})
     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})

    If an expression is not provided for the content argument, the nested
    expression will capture all whitespace-delimited content between delimiters
    as a list of separate values.

    Use the C{ignoreExpr} argument to define expressions that may contain
    opening or closing characters that should not be treated as opening
    or closing characters for nesting, such as quotedString or a comment
    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
    The default is L{quotedString}, but if no expressions are to be ignored,
    then pass C{None} for this argument.

    Example::
        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR,RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type") 
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
                      + code_body("body"))
        c_function.ignore(cStyleComment)
        
        source_code = '''
            int is_odd(int x) { 
                return (x%2); 
            }
                
            int dec_to_hex(char hchar) { 
                if (hchar >= '0' && hchar <= '9') { 
                    return (ord(hchar)-ord('0')); 
                } else { 
                    return (10+ord(hchar)-ord('A'));
                } 
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)

    prints::
        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    z.opening and closing strings cannot be the sameNr�r�cSs|d��Sr��r�rwryryrzr{gr|znestedExpr.<locals>.<lambda>cSs|d��Sr�r
rwryryrzr{jr|cSs|d��Sr�r
rwryryrzr{pr|cSs|d��Sr�r
rwryryrzr{tr|zOopening and closing arguments must be strings if no content expression is givenznested %s%s expression)r�r}r�r�rrrr&rsr�rEr�rrrr-r4r�)ZopenerZcloserZcontentr�r�ryryrzrR%sH:
���������
*$cs��fdd�}�fdd�}�fdd�}tt��d����}t�t��|��d�}t��|��d	�}t��|��d
�}	|r�tt|�|t|t|�t|��|	�}
n$tt|�t|t|�t|���}
|�	t
t��|
�d�S)a
	
    Helper method for defining space-delimited indentation blocks, such as
    those used to define block statements in Python source code.

    Parameters:
     - blockStatementExpr - expression defining syntax of statement that
            is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
            (multiple statementWithIndentedBlock expressions within a single grammar
            should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond the
            the current level; set to False for block of left-most statements
            (default=C{True})

    A valid block must contain at least one C{blockStatement}.

    Example::
        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group( funcDecl + func_body )

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << ( funcDef | assignment | identifier )

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()
    prints::
        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
    csN|t|�krdSt||�}|�dkrJ|�dkr>t||d��t||d��dS)Nrtzillegal nestingznot a peer entry)r�r;r#r!�r�r[rxZcurCol��indentStackryrz�checkPeerIndent�s
z&indentedBlock.<locals>.checkPeerIndentcs2t||�}|�dkr"��|�nt||d��dS)Nrtznot a subentry)r;rr!rrryrz�checkSubIndent�s
z%indentedBlock.<locals>.checkSubIndentcsN|t|�krdSt||�}�r6|�dkr6|�dksBt||d�����dS)Nrtr_znot an unindent)r�r;r!rrrryrz�
checkUnindent�s
z$indentedBlock.<locals>.checkUnindentz	 �INDENTr�ZUNINDENTzindented block)rrr
r
rr�r�rrrr�)ZblockStatementExprrr9rrrrErZPEERZUNDENTZsmExprryrrzrhs(N����z#[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]z[\0xa1-\0xbf\0xd7\0xf7]z_:zany tagzgt lt amp nbsp quot aposz><& "'z&(?P<entity>r�z);zcommon HTML entitycCst�|j�S)zRHelper parser action to replace common HTML entities with their special characters)�_htmlEntityMapr�Zentityrwryryrzr]�sz/\*(?:[^*]|\*(?!/))*z*/zC style commentz<!--[\s\S]*?-->zHTML commentz.*zrest of linez//(?:\\\n|[^\n])*z
// commentzC++ style commentz#.*zPython style commentrO� 	�	commaItemr�c@s�eZdZdZee�Zee�Ze	e
��d��e�Z
e	e��d��eed��Zed��d��e�Ze��e�de��e��d�Ze�d	d
��eeeed���e�B�d�Ze�e�ed
��d��e�Zed��d��e�ZeeBeB��Zed��d��e�Ze	eded��d�Zed��d�Z ed��d�Z!e!de!d�d�Z"ee!de!d�dee!de!d��d�Z#e#�$dd
��d e �d!�Z%e&e"e%Be#B�d"���d"�Z'ed#��d$�Z(e)d=d&d'��Z*e)d>d)d*��Z+ed+��d,�Z,ed-��d.�Z-ed/��d0�Z.e/��e0��BZ1e)d1d2��Z2e&e3e4d3�e5�e	e6d3d4�ee7d5�������d6�Z8e9ee:�;�e8Bd7d8���d9�Z<e)ed:d
���Z=e)ed;d
���Z>d<S)?rpa�

    Here are some common low-level expressions that may be useful in jump-starting parser development:
     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
     - common L{programming identifiers<identifier>}
     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
     - L{UUID<uuid>}
     - L{comma-separated list<comma_separated_list>}
    Parse actions:
     - C{L{convertToInteger}}
     - C{L{convertToFloat}}
     - C{L{convertToDate}}
     - C{L{convertToDatetime}}
     - C{L{stripHTMLTags}}
     - C{L{upcaseTokens}}
     - C{L{downcaseTokens}}

    Example::
        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')
    prints::
        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    �integerzhex integerr�z[+-]?\d+zsigned integerr��fractioncCs|d|dS)Nrrtryrwryryrzr{�r|zpyparsing_common.<lambda>r�z"fraction or mixed integer-fractionz
[+-]?\d+\.\d*zreal numberz+[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)z$real number with scientific notationz[+-]?\d+\.?\d*([eE][+-]?\d+)?�fnumberr��
identifierzK(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}zIPv4 addressz[0-9a-fA-F]{1,4}�hex_integerr��zfull IPv6 address)rrhz::zshort IPv6 addresscCstdd�|D��dkS)Ncss|]}tj�|�rdVqdSr3)rp�
_ipv6_partr�r�ryryrzr��sz,pyparsing_common.<lambda>.<locals>.<genexpr>r�)r�rwryryrzr{�r|z::ffff:zmixed IPv6 addresszIPv6 addressz:[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}zMAC address�%Y-%m-%dcs�fdd�}|S)a�
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})

        Example::
            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))
        prints::
            [datetime.date(1999, 12, 31)]
        c
sNzt�|d����WStk
rH}zt||t|���W5d}~XYnXdSr�)r�strptime�dater�r!r~�r�r[rxZve��fmtryrz�cvt_fn�sz.pyparsing_common.convertToDate.<locals>.cvt_fnry�r$r%ryr#rz�
convertToDate�szpyparsing_common.convertToDate�%Y-%m-%dT%H:%M:%S.%fcs�fdd�}|S)a
        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})

        Example::
            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
        prints::
            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        c
sJzt�|d��WStk
rD}zt||t|���W5d}~XYnXdSr�)rr r�r!r~r"r#ryrzr%�sz2pyparsing_common.convertToDatetime.<locals>.cvt_fnryr&ryr#rz�convertToDatetime�sz"pyparsing_common.convertToDatetimez7(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?zISO8601 datez�(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?zISO8601 datetimez2[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}�UUIDcCstj�|d�S)a
        Parse action to remove HTML tags from web page HTML source

        Example::
            # strip HTML links from normal text 
            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
            td,td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            
            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
        r)rp�_html_stripperr�)r�r[r�ryryrz�
stripHTMLTagss
zpyparsing_common.stripHTMLTagsr�rOrrr�r�zcomma separated listcCst|���Sr�r�rwryryrzr{"r|cCst|���Sr�r�rwryryrzr{%r|N)r)r()?r�r�r�r�rorvZconvertToInteger�floatZconvertToFloatr1rTr�r�rrFrr)Zsigned_integerrr�rr
Z
mixed_integerr��realZsci_realr��numberrr6r5rZipv4_addressrZ_full_ipv6_addressZ_short_ipv6_addressr�Z_mixed_ipv6_addressrZipv6_addressZmac_addressr/r'r)Ziso8601_dateZiso8601_datetime�uuidr9r8r+r,rrrrXr0�
_commasepitemrBr[r�Zcomma_separated_listrfrDryryryrzrpsV""
2
 
���__main__Zselect�fromr=r�)r��columnsr�ZtablesZcommandaK
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        z]
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        z 
        100
        FF
        z6
        12345678-1234-5678-1234-567812345678
        )rs)r�F)N)FT)T)r�)T)�r��__version__Z__versionTime__�
__author__r��weakrefrr�r�r�r�r�rjr�rFrcr�r�_threadr�ImportErrorZ	threadingZcollections.abcrrrr�Zordereddict�__all__r��version_inforbr0�maxsizer0r~r��chrr�r�r�r�r@�reversedr�r�rBr�r]r^rnZmaxintZxranger�Z__builtin__r�Zfnamerror�r�r�r�r�r�Zascii_uppercaseZascii_lowercaser6rTrFr5r�r�Z	printablerXrprr!r#r%r(r�r$�registerr;rLrIrTrWrYrSrrr&r.rrrr�rwrr
r	rnr1r)r'rr0r�rrrr,r+r3r2r"rrrrr rrr�rr4r�r�rr*rr�r/rrr
r-rrdrBr>r�rQrPrYrUrCrirjrlr�rErKrJrcrbr�Z_escapedPuncZ_escapedHexCharZ_escapedOctCharZ_singleCharZ
_charRanger�r�rarOr^r\rorfrDrrMrNrgrrmrVrr	rkrWr@r`r[rerRrhr7rYr9r8r�r�rrr=r]r:rGrr_rAr?rHrZr�r1r<rpr�ZselectTokenZ	fromTokenZidentZ
columnNameZcolumnNameListZ
columnSpecZ	tableNameZ
tableNameListZ	simpleSQLr.r/rrr0r*ryryryrz�<module>s��4�
8



@v&A= I
G3pLOD|M &#@sQ,A,	I#%0
,	?#p
��Zr

 (
 
���� 


"
	site-packages/setuptools/_vendor/__pycache__/six.cpython-38.opt-1.pyc000064400000057553151446177000021567 0ustar00U

�Qab�u�A@sRdZddlmZddlZddlZddlZddlZddlZdZdZ	ej
ddkZej
ddkZej
dd�dkZ
er�efZefZefZeZeZejZn~efZeefZeejfZeZeZej�d	�r�ed
�ZnHGdd�de�Z ze!e ��Wne"k
�red
�ZYn
Xed
�Z[ dd�Z#dd�Z$Gdd�de�Z%Gdd�de%�Z&Gdd�dej'�Z(Gdd�de%�Z)Gdd�de�Z*e*e+�Z,Gdd�de(�Z-e)dddd �e)d!d"d#d$d!�e)d%d"d"d&d%�e)d'd(d#d)d'�e)d*d(d+�e)d,d"d#d-d,�e)d.d/d/d0d.�e)d1d/d/d.d1�e)d2d(d#d3d2�e)d4d(e
�rd5nd6d7�e)d8d(d9�e)d:d;d<d=�e)d d d�e)d>d>d?�e)d@d@d?�e)dAdAd?�e)d3d(d#d3d2�e)dBd"d#dCdB�e)dDd"d"dEdD�e&d#d(�e&dFdG�e&dHdI�e&dJdKdL�e&dMdNdM�e&dOdPdQ�e&dRdSdT�e&dUdVdW�e&dXdYdZ�e&d[d\d]�e&d^d_d`�e&dadbdc�e&dddedf�e&dgdhdi�e&djdjdk�e&dldldk�e&dmdmdk�e&dndndo�e&dpdq�e&drds�e&dtdu�e&dvdwdv�e&dxdy�e&dzd{d|�e&d}d~d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d��e&d�d�d�e&d�d�d��e&d�d�d��e&d�d�d��e&d�e+d�d��e&d�e+d�d��e&d�e+d�e+d��e&d�d�d��e&d�d�d��e&d�d�d��g>Z.ejd�k�rRe.e&d�d��g7Z.e.D]2Z/e0e-e/j1e/�e2e/e&��rVe,�3e/d�e/j1��qV[/e.e-_.e-e+d��Z4e,�3e4d��Gd�d��d�e(�Z5e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d=d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��e)d�d�d��gZ6e6D]Z/e0e5e/j1e/��q�[/e6e5_.e,�3e5e+d��d�dҡGd�dԄd�e(�Z7e)d�d�d��e)d�d�d��e)d�d�d��gZ8e8D]Z/e0e7e/j1e/��q[/e8e7_.e,�3e7e+d��d�dۡGd�d݄d�e(�Z9e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃e)d�d�d߃g!Z:e:D]Z/e0e9e/j1e/��q�[/e:e9_.e,�3e9e+�d��d�d�G�d�d��de(�Z;e)�dd��d�e)�dd��d�e)�dd��d�e)�d	d��d�gZ<e<D]Z/e0e;e/j1e/��q8[/e<e;_.e,�3e;e+�d
��d�d�G�d
�d��de(�Z=e)�dd�d��gZ>e>D]Z/e0e=e/j1e/��q�[/e>e=_.e,�3e=e+�d��d�d�G�d�d��dej'�Z?e,�3e?e+d���d��d�d�Z@�d�d�ZAe�	rH�dZB�dZC�dZD�dZE�dZF�dZGn$�d ZB�d!ZC�d"ZD�d#ZE�d$ZF�d%ZGzeHZIWn"eJk
�	r��d&�d'�ZIYnXeIZHzeKZKWn"eJk
�	r��d(�d)�ZKYnXe�	r�d*�d+�ZLejMZN�d,�d-�ZOeZPn>�d.�d+�ZL�d/�d0�ZN�d1�d-�ZOG�d2�d3��d3e�ZPeKZKe#eL�d4�e�QeB�ZRe�QeC�ZSe�QeD�ZTe�QeE�ZUe�QeF�ZVe�QeG�ZWe�
rԐd5�d6�ZX�d7�d8�ZY�d9�d:�ZZ�d;�d<�Z[e�\�d=�Z]e�\�d>�Z^e�\�d?�Z_nT�d@�d6�ZX�dA�d8�ZY�dB�d:�ZZ�dC�d<�Z[e�\�dD�Z]e�\�dE�Z^e�\�dF�Z_e#eX�dG�e#eY�dH�e#eZ�dI�e#e[�dJ�e�r�dK�dL�Z`�dM�dN�ZaebZcddldZded�e�dO�jfZg[de�hd�ZiejjZkelZmddlnZnenjoZoenjpZp�dPZqej
�dQ�dQk�r�dRZr�dSZsn�dTZr�dUZsnj�dV�dL�Z`�dW�dN�ZaecZcebZg�dX�dY�Zi�dZ�d[�Zke�tejuev�ZmddloZoeojoZoZp�d\Zq�dRZr�dSZse#e`�d]�e#ea�d^��d_�dP�Zw�d`�dT�Zx�da�dU�Zye�r�eze4j{�db�Z|�d|�dc�dd�Z}n�d}�de�df�Z|e|�dg�ej
dd��dhk�r�e|�di�n.ej
dd��dhk�
re|�dj�n�dk�dl�Z~eze4j{�dmd�Zedk�
rL�dn�do�Zej
dd��dpk�
rreZ��dq�do�Ze#e}�dr�ej
dd�dk�
r�ej�ej�f�ds�dt�Z�nej�Z��du�dv�Z��dw�dx�Z��dy�dz�Z�gZ�e+Z�e�����d{�dk	�
r�ge�_�ej��rBe�ej��D]4\Z�Z�ee��j+dk�re�j1e+k�rej�e�=�q>�q[�[�ej���e,�dS(~z6Utilities for writing code that runs on Python 2 and 3�)�absolute_importNz'Benjamin Peterson <benjamin@python.org>z1.10.0��)r��javai���c@seZdZdd�ZdS)�XcCsdS)Nl���selfrr�:/usr/lib/python3.8/site-packages/setuptools/_vendor/six.py�__len__>sz	X.__len__N)�__name__�
__module__�__qualname__rrrrrr<srl����cCs
||_dS)z Add documentation to a function.N)�__doc__)�func�docrrr�_add_docKsrcCst|�tj|S)z7Import module, returning the module after the last dot.)�
__import__�sys�modules��namerrr�_import_modulePsrc@seZdZdd�Zdd�ZdS)�
_LazyDescrcCs
||_dS�Nr�r
rrrr�__init__Xsz_LazyDescr.__init__cCsB|��}t||j|�zt|j|j�Wntk
r<YnX|Sr)�_resolve�setattrr�delattr�	__class__�AttributeError)r
�obj�tp�resultrrr�__get__[sz_LazyDescr.__get__N)r
rrrr&rrrrrVsrcs.eZdZd�fdd�	Zdd�Zdd�Z�ZS)	�MovedModuleNcs2tt|��|�tr(|dkr |}||_n||_dSr)�superr'r�PY3�mod)r
r�old�new�r!rrriszMovedModule.__init__cCs
t|j�Sr)rr*r	rrrrrszMovedModule._resolvecCs"|��}t||�}t|||�|Sr)r�getattrr)r
�attr�_module�valuerrr�__getattr__us
zMovedModule.__getattr__)N)r
rrrrr2�
__classcell__rrr-rr'gs	r'cs(eZdZ�fdd�Zdd�ZgZ�ZS)�_LazyModulecstt|��|�|jj|_dSr)r(r4rr!rrr-rrr~sz_LazyModule.__init__cCs ddg}|dd�|jD�7}|S)Nrr
cSsg|]
}|j�qSrr)�.0r/rrr�
<listcomp>�sz'_LazyModule.__dir__.<locals>.<listcomp>)�_moved_attributes)r
Zattrsrrr�__dir__�sz_LazyModule.__dir__)r
rrrr8r7r3rrr-rr4|sr4cs&eZdZd�fdd�	Zdd�Z�ZS)�MovedAttributeNcsdtt|��|�trH|dkr |}||_|dkr@|dkr<|}n|}||_n||_|dkrZ|}||_dSr)r(r9rr)r*r/)r
rZold_modZnew_modZold_attrZnew_attrr-rrr�szMovedAttribute.__init__cCst|j�}t||j�Sr)rr*r.r/)r
�modulerrrr�s
zMovedAttribute._resolve)NN)r
rrrrr3rrr-rr9�sr9c@sVeZdZdZdd�Zdd�Zdd�Zdd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdS)�_SixMetaPathImporterz�
    A meta path importer to import six.moves and its submodules.

    This class implements a PEP302 finder and loader. It should be compatible
    with Python 2.5 and all existing versions of Python3
    cCs||_i|_dSr)r�
known_modules)r
Zsix_module_namerrrr�sz_SixMetaPathImporter.__init__cGs"|D]}||j|jd|<qdS�N�.�r<r)r
r*Z	fullnames�fullnamerrr�_add_module�sz _SixMetaPathImporter._add_modulecCs|j|jd|Sr=r?�r
r@rrr�_get_module�sz _SixMetaPathImporter._get_moduleNcCs||jkr|SdSr)r<)r
r@�pathrrr�find_module�s
z _SixMetaPathImporter.find_modulecCs2z|j|WStk
r,td|��YnXdS)Nz!This loader does not know module )r<�KeyError�ImportErrorrBrrrZ__get_module�sz!_SixMetaPathImporter.__get_modulecCsTztj|WStk
r YnX|�|�}t|t�r@|��}n||_|tj|<|Sr)rrrF� _SixMetaPathImporter__get_module�
isinstancer'r�
__loader__)r
r@r*rrr�load_module�s



z _SixMetaPathImporter.load_modulecCst|�|�d�S)z�
        Return true, if the named module is a package.

        We need this method to get correct spec objects with
        Python 3.4 (see PEP451)
        �__path__)�hasattrrHrBrrr�
is_package�sz_SixMetaPathImporter.is_packagecCs|�|�dS)z;Return None

        Required, if is_package is implementedN)rHrBrrr�get_code�s
z_SixMetaPathImporter.get_code)N)
r
rrrrrArCrErHrKrNrO�
get_sourcerrrrr;�s
	r;c@seZdZdZgZdS)�_MovedItemszLazy loading of moved objectsN)r
rrrrLrrrrrQ�srQZ	cStringIO�io�StringIO�filter�	itertools�builtinsZifilter�filterfalseZifilterfalse�inputZ__builtin__Z	raw_input�internr�map�imap�getcwd�osZgetcwdu�getcwdb�rangeZxrangeZ
reload_module�	importlibZimp�reload�reduce�	functoolsZshlex_quoteZpipesZshlexZquote�UserDict�collections�UserList�
UserString�zipZizip�zip_longestZizip_longestZconfigparserZConfigParser�copyregZcopy_regZdbm_gnuZgdbmzdbm.gnuZ
_dummy_threadZdummy_threadZhttp_cookiejarZ	cookielibzhttp.cookiejarZhttp_cookiesZCookiezhttp.cookiesZ
html_entitiesZhtmlentitydefsz
html.entitiesZhtml_parserZ
HTMLParserzhtml.parserZhttp_clientZhttplibzhttp.clientZemail_mime_multipartzemail.MIMEMultipartzemail.mime.multipartZemail_mime_nonmultipartzemail.MIMENonMultipartzemail.mime.nonmultipartZemail_mime_textzemail.MIMETextzemail.mime.textZemail_mime_basezemail.MIMEBasezemail.mime.baseZBaseHTTPServerzhttp.serverZ
CGIHTTPServerZSimpleHTTPServerZcPickle�pickleZqueueZQueue�reprlib�reprZsocketserverZSocketServer�_thread�threadZtkinterZTkinterZtkinter_dialogZDialogztkinter.dialogZtkinter_filedialogZ
FileDialogztkinter.filedialogZtkinter_scrolledtextZScrolledTextztkinter.scrolledtextZtkinter_simpledialogZSimpleDialogztkinter.simpledialogZtkinter_tixZTixztkinter.tixZtkinter_ttkZttkztkinter.ttkZtkinter_constantsZTkconstantsztkinter.constantsZtkinter_dndZTkdndztkinter.dndZtkinter_colorchooserZtkColorChooserztkinter.colorchooserZtkinter_commondialogZtkCommonDialogztkinter.commondialogZtkinter_tkfiledialogZtkFileDialogZtkinter_fontZtkFontztkinter.fontZtkinter_messageboxZtkMessageBoxztkinter.messageboxZtkinter_tksimpledialogZtkSimpleDialogZurllib_parsez.moves.urllib_parsezurllib.parseZurllib_errorz.moves.urllib_errorzurllib.errorZurllibz
.moves.urllibZurllib_robotparser�robotparserzurllib.robotparserZ
xmlrpc_clientZ	xmlrpclibz
xmlrpc.clientZ
xmlrpc_serverZSimpleXMLRPCServerz
xmlrpc.serverZwin32�winreg�_winregzmoves.z.moves�movesc@seZdZdZdS)�Module_six_moves_urllib_parsez7Lazy loading of moved objects in six.moves.urllib_parseN�r
rrrrrrrrt@srtZParseResultZurlparseZSplitResultZparse_qsZ	parse_qslZ	urldefragZurljoinZurlsplitZ
urlunparseZ
urlunsplitZ
quote_plusZunquoteZunquote_plusZ	urlencodeZ
splitqueryZsplittagZ	splituserZ
uses_fragmentZuses_netlocZuses_paramsZ
uses_queryZ
uses_relative�moves.urllib_parsezmoves.urllib.parsec@seZdZdZdS)�Module_six_moves_urllib_errorz7Lazy loading of moved objects in six.moves.urllib_errorNrurrrrrwhsrwZURLErrorZurllib2Z	HTTPErrorZContentTooShortErrorz.moves.urllib.error�moves.urllib_errorzmoves.urllib.errorc@seZdZdZdS)�Module_six_moves_urllib_requestz9Lazy loading of moved objects in six.moves.urllib_requestNrurrrrry|sryZurlopenzurllib.requestZinstall_openerZbuild_openerZpathname2urlZurl2pathnameZ
getproxiesZRequestZOpenerDirectorZHTTPDefaultErrorHandlerZHTTPRedirectHandlerZHTTPCookieProcessorZProxyHandlerZBaseHandlerZHTTPPasswordMgrZHTTPPasswordMgrWithDefaultRealmZAbstractBasicAuthHandlerZHTTPBasicAuthHandlerZProxyBasicAuthHandlerZAbstractDigestAuthHandlerZHTTPDigestAuthHandlerZProxyDigestAuthHandlerZHTTPHandlerZHTTPSHandlerZFileHandlerZ
FTPHandlerZCacheFTPHandlerZUnknownHandlerZHTTPErrorProcessorZurlretrieveZ
urlcleanupZ	URLopenerZFancyURLopenerZproxy_bypassz.moves.urllib.request�moves.urllib_requestzmoves.urllib.requestc@seZdZdZdS)� Module_six_moves_urllib_responsez:Lazy loading of moved objects in six.moves.urllib_responseNrurrrrr{�sr{Zaddbasezurllib.responseZaddclosehookZaddinfoZ
addinfourlz.moves.urllib.response�moves.urllib_responsezmoves.urllib.responsec@seZdZdZdS)�#Module_six_moves_urllib_robotparserz=Lazy loading of moved objects in six.moves.urllib_robotparserNrurrrrr}�sr}ZRobotFileParserz.moves.urllib.robotparser�moves.urllib_robotparserzmoves.urllib.robotparserc@sNeZdZdZgZe�d�Ze�d�Ze�d�Z	e�d�Z
e�d�Zdd�Zd	S)
�Module_six_moves_urllibzICreate a six.moves.urllib namespace that resembles the Python 3 namespacervrxrzr|r~cCsdddddgS)N�parse�error�request�responserprr	rrrr8�szModule_six_moves_urllib.__dir__N)
r
rrrrL�	_importerrCr�r�r�r�rpr8rrrrr�s




rzmoves.urllibcCstt|j|�dS)zAdd an item to six.moves.N)rrQr)Zmoverrr�add_move�sr�cCsXztt|�WnDtk
rRztj|=Wn"tk
rLtd|f��YnXYnXdS)zRemove item from six.moves.zno such move, %rN)r rQr"rs�__dict__rFrrrr�remove_move�sr��__func__�__self__�__closure__�__code__�__defaults__�__globals__�im_funcZim_selfZfunc_closureZ	func_codeZ
func_defaultsZfunc_globalscCs|��Sr)�next)�itrrr�advance_iteratorsr�cCstdd�t|�jD��S)Ncss|]}d|jkVqdS)�__call__N)r�)r5�klassrrr�	<genexpr>szcallable.<locals>.<genexpr>)�any�type�__mro__)r#rrr�callablesr�cCs|Srr�Zunboundrrr�get_unbound_functionsr�cCs|Srr�r�clsrrr�create_unbound_methodsr�cCs|jSr)r�r�rrrr�"scCst�|||j�Sr)�types�
MethodTyper!)rr#rrr�create_bound_method%sr�cCst�|d|�Sr)r�r�r�rrrr�(sc@seZdZdd�ZdS)�IteratorcCst|��|�Sr)r��__next__r	rrrr�-sz
Iterator.nextN)r
rrr�rrrrr�+sr�z3Get the function out of a possibly unbound functioncKst|jf|��Sr)�iter�keys��d�kwrrr�iterkeys>sr�cKst|jf|��Sr)r��valuesr�rrr�
itervaluesAsr�cKst|jf|��Sr)r��itemsr�rrr�	iteritemsDsr�cKst|jf|��Sr)r�Zlistsr�rrr�	iterlistsGsr�r�r�r�cKs|jf|�Sr)r�r�rrrr�PscKs|jf|�Sr)r�r�rrrr�SscKs|jf|�Sr)r�r�rrrr�VscKs|jf|�Sr)r�r�rrrr�Ys�viewkeys�
viewvalues�	viewitemsz1Return an iterator over the keys of a dictionary.z3Return an iterator over the values of a dictionary.z?Return an iterator over the (key, value) pairs of a dictionary.zBReturn an iterator over the (key, [values]) pairs of a dictionary.cCs
|�d�S)Nzlatin-1)�encode��srrr�bksr�cCs|Srrr�rrr�unsr�z>B�assertCountEqual�ZassertRaisesRegexpZassertRegexpMatches�assertRaisesRegex�assertRegexcCs|Srrr�rrrr��scCst|�dd�d�S)Nz\\z\\\\Zunicode_escape)�unicode�replacer�rrrr��scCst|d�S)Nr��ord)Zbsrrr�byte2int�sr�cCst||�Srr�)Zbuf�irrr�
indexbytes�sr�ZassertItemsEqualzByte literalzText literalcOst|t�||�Sr)r.�_assertCountEqual�r
�args�kwargsrrrr��scOst|t�||�Sr)r.�_assertRaisesRegexr�rrrr��scOst|t�||�Sr)r.�_assertRegexr�rrrr��s�execcCs*|dkr|�}|j|k	r"|�|��|�dSr)�
__traceback__�with_traceback)r$r1�tbrrr�reraise�s


r�cCsB|dkr*t�d�}|j}|dkr&|j}~n|dkr6|}td�dS)zExecute code in a namespace.Nr�zexec _code_ in _globs_, _locs_)r�	_getframe�	f_globals�f_localsr�)Z_code_Z_globs_Z_locs_�framerrr�exec_�s
r�z9def reraise(tp, value, tb=None):
    raise tp, value, tb
)rrzrdef raise_from(value, from_value):
    if from_value is None:
        raise value
    raise value from from_value
zCdef raise_from(value, from_value):
    raise value from from_value
cCs|�dSrr)r1Z
from_valuerrr�
raise_from�sr��printc
s.|�dtj���dkrdS�fdd�}d}|�dd�}|dk	r`t|t�rNd}nt|t�s`td��|�d	d�}|dk	r�t|t�r�d}nt|t�s�td
��|r�td��|s�|D]}t|t�r�d}q�q�|r�td�}td
�}nd}d
}|dkr�|}|dkr�|}t|�D] \}	}|	�r||�||��q||�dS)z4The new-style print function for Python 2.4 and 2.5.�fileNcsdt|t�st|�}t�t�rVt|t�rV�jdk	rVt�dd�}|dkrHd}|��j|�}��|�dS)N�errors�strict)	rI�
basestring�strr�r��encodingr.r��write)�datar���fprrr��s

��zprint_.<locals>.writeF�sepTzsep must be None or a string�endzend must be None or a stringz$invalid keyword arguments to print()�
� )�popr�stdoutrIr�r��	TypeError�	enumerate)
r�r�r�Zwant_unicoder�r��arg�newlineZspacer�rr�r�print_�sL





r�)rrcOs<|�dtj�}|�dd�}t||�|r8|dk	r8|��dS)Nr��flushF)�getrr�r��_printr�)r�r�r�r�rrrr�s

zReraise an exception.cs���fdd�}|S)Ncst�����|�}�|_|Sr)rc�wraps�__wrapped__)�f��assigned�updated�wrappedrr�wrapperszwraps.<locals>.wrapperr)r�r�r�r�rr�rr�sr�cs&G��fdd�d��}t�|ddi�S)z%Create a base class with a metaclass.cseZdZ��fdd�ZdS)z!with_metaclass.<locals>.metaclasscs�|�|�Srr)r�rZ
this_basesr���bases�metarr�__new__'sz)with_metaclass.<locals>.metaclass.__new__N)r
rrr�rr�rr�	metaclass%sr�Ztemporary_classr)r�r�)r�r�r�rr�r�with_metaclass sr�cs�fdd�}|S)z6Class decorator for creating a class with a metaclass.csh|j��}|�d�}|dk	r@t|t�r,|g}|D]}|�|�q0|�dd�|�dd��|j|j|�S)N�	__slots__r��__weakref__)r��copyr�rIr�r�r
�	__bases__)r�Z	orig_vars�slotsZ	slots_var�r�rrr�.s


zadd_metaclass.<locals>.wrapperr)r�r�rr�r�
add_metaclass,sr�cCs2tr.d|jkrtd|j��|j|_dd�|_|S)a
    A decorator that defines __unicode__ and __str__ methods under Python 2.
    Under Python 3 it does nothing.

    To support Python 2 and 3 with a single code base, define a __str__ method
    returning text and apply this decorator to the class.
    �__str__zY@python_2_unicode_compatible cannot be applied to %s because it doesn't define __str__().cSs|���d�S)Nzutf-8)�__unicode__r�r	rrr�<lambda>J�z-python_2_unicode_compatible.<locals>.<lambda>)�PY2r��
ValueErrorr
rr)r�rrr�python_2_unicode_compatible<s
�
r�__spec__)N)NN)�rZ
__future__rrcrU�operatorrr��
__author__�__version__�version_inforr)ZPY34r�Zstring_types�intZ
integer_typesr�Zclass_typesZ	text_type�bytesZbinary_type�maxsizeZMAXSIZEr�ZlongZ	ClassTyper��platform�
startswith�objectr�len�
OverflowErrorrrrr'�
ModuleTyper4r9r;r
r�rQr7r/rrrIrArsrtZ_urllib_parse_moved_attributesrwZ_urllib_error_moved_attributesryZ _urllib_request_moved_attributesr{Z!_urllib_response_moved_attributesr}Z$_urllib_robotparser_moved_attributesrr�r�Z
_meth_funcZ
_meth_selfZ
_func_closureZ
_func_codeZ_func_defaultsZ
_func_globalsr�r��	NameErrorr�r�r�r�r�r��
attrgetterZget_method_functionZget_method_selfZget_function_closureZget_function_codeZget_function_defaultsZget_function_globalsr�r�r�r��methodcallerr�r�r�r�r��chrZunichr�struct�Struct�packZint2byte�
itemgetterr��getitemr�r�Z	iterbytesrRrS�BytesIOr�r�r��partialr[r�r�r�r�r.rVr�r�r�r�r��WRAPPER_ASSIGNMENTS�WRAPPER_UPDATESr�r�r�rrL�__package__�globalsr�r�submodule_search_locations�	meta_pathr�r�Zimporter�appendrrrr�<module>s�

>





























��


�


�D�






















��


��
































�#�����
��





��



5��
site-packages/setuptools/_vendor/__pycache__/pyparsing.cpython-38.pyc000064400000611637151446177000022040 0ustar00U

�Qabw��i@s�dZdZdZdZddlZddlmZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZzddlmZWn ek
r�ddlmZYnXzdd	lmZdd
lmZWn,ek
r�dd	l
mZdd
l
mZYnXzddl
mZWnBek
�rFzddlmZWnek
�r@dZYnXYnXdd
ddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<d=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTdUdVdWdXdYdZd[d\d]d^d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtgiZee	j�ddu�ZeddukZ e �rpe	j!Z"e#Z$e%Z&e#Z'e(e)e*e+e,ee-e.e/e0e1gZ2n`e	j3Z"e4Z5dvdw�Z'gZ2ddl6Z6dx�7�D]8Z8ze2�9e:e6e8��Wne;k
�r�Y�q�YnX�q�e<dydz�e5d{�D��Z=d|d}�Z>Gd~d�de?�Z@ejAejBZCd�ZDeDd�ZEeCeDZFe%d��ZGd��Hd�dz�ejID��ZJGd�d#�d#eK�ZLGd�d%�d%eL�ZMGd�d'�d'eL�ZNGd�d)�d)eN�ZOGd�d,�d,eK�ZPGd�d��d�e?�ZQGd�d(�d(e?�ZRe�SeR�d�d?�ZTd�dP�ZUd�dM�ZVd�d��ZWd�d��ZXd�d��ZYd�dW�ZZ�d/d�d��Z[Gd�d*�d*e?�Z\Gd�d2�d2e\�Z]Gd�d�de]�Z^Gd�d�de]�Z_Gd�d�de]�Z`e`Zae`e\_bGd�d�de]�ZcGd�d�de`�ZdGd�d
�d
ec�ZeGd�dr�dre]�ZfGd�d5�d5e]�ZgGd�d-�d-e]�ZhGd�d+�d+e]�ZiGd�d�de]�ZjGd�d4�d4e]�ZkGd�d��d�e]�ZlGd�d�del�ZmGd�d�del�ZnGd�d�del�ZoGd�d0�d0el�ZpGd�d/�d/el�ZqGd�d7�d7el�ZrGd�d6�d6el�ZsGd�d&�d&e\�ZtGd�d�det�ZuGd�d"�d"et�ZvGd�d�det�ZwGd�d�det�ZxGd�d$�d$e\�ZyGd�d�dey�ZzGd�d�dey�Z{Gd�d��d�ey�Z|Gd�d�de|�Z}Gd�d8�d8e|�Z~Gd�d��d�e?�Ze�Z�Gd�d!�d!ey�Z�Gd�d.�d.ey�Z�Gd�d�dey�Z�Gd�dÄd�e��Z�Gd�d3�d3ey�Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d�de��Z�Gd�d1�d1e��Z�Gd�d �d e?�Z�d�dh�Z��d0d�dF�Z��d1d�dB�Z�d�dЄZ�d�dU�Z�d�dT�Z�d�dԄZ��d2d�dY�Z�d�dG�Z��d3d�dm�Z�d�dn�Z�d�dp�Z�e^���dI�Z�en���dO�Z�eo���dN�Z�ep���dg�Z�eq���df�Z�egeGd�d�d܍��d�dބ�Z�ehd߃��d�dބ�Z�ehd���d�dބ�Z�e�e�Be�Bejd�d{d܍BZ�e�e�e�d�e��Z�e`d�e�d���d�e�e}e�e�B����d�d�Z�d�de�Z�d�dS�Z�d�db�Z�d�d`�Z�d�ds�Z�e�d�dބ�Z�e�d�dބ�Z�d�d�Z�d�dQ�Z�d�dR�Z�d�dk�Z�e?�e�_��d4d�dq�Z�e@�Z�e?�e�_�e?�e�_�e�d��e�d��fd�do�Z�e�Z�e�ehd��d����d��Z�e�ehd��d����d��Z�e�ehd��d�ehd��d�B����d�Z�e�ea�d�e�������d�Z�d�d�de���f�ddV�Z��d5�ddl�Z�e��d�Z�e��d�Z�e�egeCeF�d����d��\Z�Z�e�ed	�7��d
��Z�eh�d�d�Heàġ��d
����d�ZŐdda�Z�e�eh�d��d����d�Z�eh�d����d�Z�eh�d��ɡ���d�Z�eh�d����d�Z�e�eh�d��de�B����d�Z�e�Z�eh�d����d�Z�e�e}egeJdːd�e�eg�d�e`d˃eo�����ϡ���d�Z�e�e�e���e�Bd��d����d@�Z�G�d dt�dt�Z�eӐd!k�r�ed�d"�Z�ed�d#�Z�egeCeF�d$�Z�e�e֐d%dՐd&���e��Z�e�e�e׃����d'�Zؐd(e�BZ�e�e֐d%dՐd&���e��Z�e�e�eڃ����d)�Z�eԐd*�eِd'�e�eېd)�Z�eܠݐd+�e�jޠݐd,�e�jߠݐd,�e�j�ݐd-�ddl�Z�e�j᠝e�e�j��e�j�ݐd.�dS(6a�	
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and executing simple grammars,
vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
provides a library of classes that you use to construct the grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form 
C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
L{Literal} expressions)::

    from pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the self-explanatory
class names, and the use of '+', '|' and '^' operators.

The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
object with named attributes.

The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
 - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
 - quoted strings
 - embedded comments


Getting Started -
-----------------
Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:
 - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
 - construct character word-group expressions using the L{Word} class
 - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
 - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
 - associate names with your parsed results using L{ParserElement.setResultsName}
 - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
 - find more useful common expressions in the L{pyparsing_common} namespace class
z2.2.1z18 Sep 2018 00:49 UTCz*Paul McGuire <ptmcg@users.sourceforge.net>�N)�ref)�datetime)�RLock)�Iterable)�MutableMapping)�OrderedDict�And�CaselessKeyword�CaselessLiteral�
CharsNotIn�Combine�Dict�Each�Empty�
FollowedBy�Forward�
GoToColumn�Group�Keyword�LineEnd�	LineStart�Literal�
MatchFirst�NoMatch�NotAny�	OneOrMore�OnlyOnce�Optional�Or�ParseBaseException�ParseElementEnhance�ParseException�ParseExpression�ParseFatalException�ParseResults�ParseSyntaxException�
ParserElement�QuotedString�RecursiveGrammarException�Regex�SkipTo�	StringEnd�StringStart�Suppress�Token�TokenConverter�White�Word�WordEnd�	WordStart�
ZeroOrMore�	alphanums�alphas�
alphas8bit�anyCloseTag�
anyOpenTag�
cStyleComment�col�commaSeparatedList�commonHTMLEntity�countedArray�cppStyleComment�dblQuotedString�dblSlashComment�
delimitedList�dictOf�downcaseTokens�empty�hexnums�htmlComment�javaStyleComment�line�lineEnd�	lineStart�lineno�makeHTMLTags�makeXMLTags�matchOnlyAtCol�matchPreviousExpr�matchPreviousLiteral�
nestedExpr�nullDebugAction�nums�oneOf�opAssoc�operatorPrecedence�
printables�punc8bit�pythonStyleComment�quotedString�removeQuotes�replaceHTMLEntity�replaceWith�
restOfLine�sglQuotedString�srange�	stringEnd�stringStart�traceParseAction�
unicodeString�upcaseTokens�
withAttribute�
indentedBlock�originalTextFor�ungroup�
infixNotation�locatedExpr�	withClass�
CloseMatch�tokenMap�pyparsing_common�cCsft|t�r|Sz
t|�WStk
r`t|��t��d�}td�}|�dd��|�	|�YSXdS)aDrop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
           then < returns the unicode object | encodes it with the default encoding | ... >.
        �xmlcharrefreplacez&#\d+;cSs$dtt|ddd���dd�S)Nz\ur����)�hex�int��t�ry�@/usr/lib/python3.8/site-packages/setuptools/_vendor/pyparsing.py�<lambda>��z_ustr.<locals>.<lambda>N)
�
isinstanceZunicode�str�UnicodeEncodeError�encode�sys�getdefaultencodingr)�setParseAction�transformString)�obj�retZ
xmlcharrefryryrz�_ustr�s

r�z6sum len sorted reversed list tuple set any all min maxccs|]
}|VqdS�Nry)�.0�yryryrz�	<genexpr>�sr��cCs:d}dd�d��D�}t||�D]\}}|�||�}q |S)z/Escape &, <, >, ", ', etc. in a string of data.z&><"'css|]}d|dVqdS)�&�;Nry)r��sryryrzr��sz_xml_escape.<locals>.<genexpr>zamp gt lt quot apos)�split�zip�replace)�dataZfrom_symbolsZ
to_symbolsZfrom_Zto_ryryrz�_xml_escape�s
r�c@seZdZdS)�
_ConstantsN)�__name__�
__module__�__qualname__ryryryrzr��sr��
0123456789ZABCDEFabcdef�\�ccs|]}|tjkr|VqdSr�)�stringZ
whitespace�r��cryryrzr��s
c@sPeZdZdZddd�Zedd��Zdd	�Zd
d�Zdd
�Z	ddd�Z
dd�ZdS)rz7base exception class for all parsing runtime exceptionsrNcCs>||_|dkr||_d|_n||_||_||_|||f|_dS�Nr�)�loc�msg�pstr�
parserElement�args)�selfr�r�r��elemryryrz�__init__�szParseBaseException.__init__cCs||j|j|j|j�S)z�
        internal factory method to simplify creating one type of ParseException 
        from another - avoids having __init__ signature conflicts among subclasses
        )r�r�r�r�)�cls�peryryrz�_from_exception�sz"ParseBaseException._from_exceptioncCsN|dkrt|j|j�S|dkr,t|j|j�S|dkrBt|j|j�St|��dS)z�supported attributes by name are:
            - lineno - returns the line number of the exception text
            - col - returns the column number of the exception text
            - line - returns the line containing the exception text
        rL)r;�columnrIN)rLr�r�r;rI�AttributeError)r�Zanameryryrz�__getattr__�szParseBaseException.__getattr__cCsd|j|j|j|jfS)Nz"%s (at char %d), (line:%d, col:%d))r�r�rLr��r�ryryrz�__str__�s�zParseBaseException.__str__cCst|�Sr��r�r�ryryrz�__repr__�szParseBaseException.__repr__�>!<cCs<|j}|jd}|r4d�|d|�|||d�f�}|��S)z�Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        r�r�N)rIr��join�strip)r�ZmarkerStringZline_strZline_columnryryrz�
markInputline�s

�z ParseBaseException.markInputlinecCsd��tt|��S)Nzlineno col line)r��dir�typer�ryryrz�__dir__szParseBaseException.__dir__)rNN)r�)r�r�r��__doc__r��classmethodr�r�r�r�r�r�ryryryrzr�s



c@seZdZdZdS)r!aN
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
     - lineno - returns the line number of the exception text
     - col - returns the column number of the exception text
     - line - returns the line containing the exception text
        
    Example::
        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))
            
    prints::
       Expected integer (at char 0), (line:1, col:1)
        column: 1
    N�r�r�r�r�ryryryrzr!sc@seZdZdZdS)r#znuser-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediatelyNr�ryryryrzr#sc@seZdZdZdS)r%z�just like L{ParseFatalException}, but thrown internally when an
       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
       immediately because an unbacktrackable syntax error has been foundNr�ryryryrzr%sc@s eZdZdZdd�Zdd�ZdS)r(zZexception thrown by L{ParserElement.validate} if the grammar could be improperly recursivecCs
||_dSr��ZparseElementTrace�r��parseElementListryryrzr�4sz"RecursiveGrammarException.__init__cCs
d|jS)NzRecursiveGrammarException: %sr�r�ryryrzr�7sz!RecursiveGrammarException.__str__N)r�r�r�r�r�r�ryryryrzr(2sc@s,eZdZdd�Zdd�Zdd�Zdd�Zd	S)
�_ParseResultsWithOffsetcCs||f|_dSr���tup)r�Zp1Zp2ryryrzr�;sz _ParseResultsWithOffset.__init__cCs
|j|Sr�r��r��iryryrz�__getitem__=sz#_ParseResultsWithOffset.__getitem__cCst|jd�S�Nr)�reprr�r�ryryrzr�?sz _ParseResultsWithOffset.__repr__cCs|jd|f|_dSr�r�r�ryryrz�	setOffsetAsz!_ParseResultsWithOffset.setOffsetN)r�r�r�r�r�r�r�ryryryrzr�:sr�c@s�eZdZdZd[dd�Zddddefdd�Zdd	�Zefd
d�Zdd
�Z	dd�Z
dd�Zdd�ZeZ
dd�Zdd�Zdd�Zdd�Zdd�Zer�eZeZeZn$eZeZeZdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd\d(d)�Zd*d+�Zd,d-�Zd.d/�Zd0d1�Z d2d3�Z!d4d5�Z"d6d7�Z#d8d9�Z$d:d;�Z%d<d=�Z&d]d?d@�Z'dAdB�Z(dCdD�Z)dEdF�Z*d^dHdI�Z+dJdK�Z,dLdM�Z-d_dOdP�Z.dQdR�Z/dSdT�Z0dUdV�Z1dWdX�Z2dYdZ�Z3dS)`r$aI
    Structured parse results, to provide multiple means of access to the parsed data:
       - as a list (C{len(results)})
       - by list index (C{results[0], results[1]}, etc.)
       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})

    Example::
        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)
    prints::
        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    NTcCs"t||�r|St�|�}d|_|S�NT)r}�object�__new__�_ParseResults__doinit)r��toklist�name�asList�modalZretobjryryrzr�ks


zParseResults.__new__c
Csb|jrvd|_d|_d|_i|_||_||_|dkr6g}||t�rP|dd�|_n||t�rft|�|_n|g|_t	�|_
|dk	�r^|�r^|s�d|j|<||t�r�t|�}||_||t
d�ttf�r�|ddgfk�s^||t�r�|g}|�r(||t��rt|��d�||<ntt|d�d�||<|||_n6z|d||<Wn$tttfk
�r\|||<YnXdS)NFrr�)r��_ParseResults__name�_ParseResults__parent�_ParseResults__accumNames�_ParseResults__asList�_ParseResults__modal�list�_ParseResults__toklist�_generatorType�dict�_ParseResults__tokdictrvr�r��
basestringr$r��copy�KeyError�	TypeError�
IndexError)r�r�r�r�r�r}ryryrzr�tsB



$
zParseResults.__init__cCsPt|ttf�r|j|S||jkr4|j|ddStdd�|j|D��SdS)NrtrcSsg|]}|d�qS�rry�r��vryryrz�
<listcomp>�sz,ParseResults.__getitem__.<locals>.<listcomp>)r}rv�slicer�r�r�r$r�ryryrzr��s


zParseResults.__getitem__cCs�||t�r0|j�|t��|g|j|<|d}nD||ttf�rN||j|<|}n&|j�|t��t|d�g|j|<|}||t�r�t|�|_	dSr�)
r�r��getr�rvr�r�r$�wkrefr�)r��kr�r}�subryryrz�__setitem__�s


"
zParseResults.__setitem__c
Cs�t|ttf�r�t|j�}|j|=t|t�rH|dkr:||7}t||d�}tt|�|���}|��|j	�
�D]>\}}|D]0}t|�D]"\}\}}	t||	|	|k�||<q�qxqln|j	|=dS�Nrr�)
r}rvr��lenr�r��range�indices�reverser��items�	enumerater�)
r�r�ZmylenZremovedr��occurrences�jr��value�positionryryrz�__delitem__�s

zParseResults.__delitem__cCs
||jkSr�)r�)r�r�ryryrz�__contains__�szParseResults.__contains__cCs
t|j�Sr�)r�r�r�ryryrz�__len__�r|zParseResults.__len__cCs
|jSr��r�r�ryryrz�__bool__�r|zParseResults.__bool__cCs
t|j�Sr���iterr�r�ryryrz�__iter__�r|zParseResults.__iter__cCst|jddd��S�Nrtr�r�ryryrz�__reversed__�r|zParseResults.__reversed__cCs$t|jd�r|j��St|j�SdS)N�iterkeys)�hasattrr�r�r�r�ryryrz�	_iterkeys�s
zParseResults._iterkeyscs�fdd����D�S)Nc3s|]}�|VqdSr�ry�r�r�r�ryrzr��sz+ParseResults._itervalues.<locals>.<genexpr>�rr�ryr�rz�_itervalues�szParseResults._itervaluescs�fdd����D�S)Nc3s|]}|�|fVqdSr�ryrr�ryrzr��sz*ParseResults._iteritems.<locals>.<genexpr>rr�ryr�rz�
_iteritems�szParseResults._iteritemscCst|���S)zVReturns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x).)r�r�r�ryryrz�keys�szParseResults.keyscCst|���S)zXReturns all named result values (as a list in Python 2.x, as an iterator in Python 3.x).)r��
itervaluesr�ryryrz�values�szParseResults.valuescCst|���S)zfReturns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x).)r��	iteritemsr�ryryrzr��szParseResults.itemscCs
t|j�S)z�Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names.)�boolr�r�ryryrz�haskeys�szParseResults.haskeyscOs�|s
dg}|��D]*\}}|dkr0|d|f}qtd|��qt|dt�sdt|�dksd|d|kr~|d}||}||=|S|d}|SdS)a�
        Removes and returns item at specified index (default=C{last}).
        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
        argument or an integer argument, it will use C{list} semantics
        and pop tokens from the list of parsed tokens. If passed a 
        non-integer argument (most likely a string), it will use C{dict}
        semantics and pop the corresponding value from any defined 
        results names. A second default return value argument is 
        supported, just as in C{dict.pop()}.

        Example::
            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())
        prints::
            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        rt�defaultrz-pop() got an unexpected keyword argument '%s'r�N)r�r�r}rvr�)r�r��kwargsr�r��indexr�Zdefaultvalueryryrz�pop�s""
�
�zParseResults.popcCs||kr||S|SdS)ai
        Returns named result matching the given key, or if there is no
        such name, then returns the given C{defaultValue} or C{None} if no
        C{defaultValue} is specified.

        Similar to C{dict.get()}.
        
        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        Nry)r��key�defaultValueryryrzr�3szParseResults.getcCsR|j�||�|j��D]4\}}t|�D]"\}\}}t||||k�||<q(qdS)a
        Inserts new element at location index in the list of parsed tokens.
        
        Similar to C{list.insert()}.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        N)r��insertr�r�r�r�)r�r
ZinsStrr�r�r�r�r�ryryrzrIszParseResults.insertcCs|j�|�dS)a�
        Add single element to end of ParseResults list of elements.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            
            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        N)r��append)r��itemryryrzr]szParseResults.appendcCs$t|t�r||7}n|j�|�dS)a
        Add sequence of elements to end of ParseResults list of elements.

        Example::
            patt = OneOrMore(Word(alphas))
            
            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        N)r}r$r��extend)r�Zitemseqryryrzrks

zParseResults.extendcCs|jdd�=|j��dS)z7
        Clear all elements and results names.
        N)r�r��clearr�ryryrzr}szParseResults.clearcCsjz
||WStk
r YdSX||jkrb||jkrH|j|ddStdd�|j|D��SndSdS)Nr�rtrcSsg|]}|d�qSr�ryr�ryryrzr��sz,ParseResults.__getattr__.<locals>.<listcomp>)r�r�r�r$�r�r�ryryrzr��s


zParseResults.__getattr__cCs|��}||7}|Sr��r�)r��otherr�ryryrz�__add__�szParseResults.__add__cs�|jrjt|j���fdd��|j��}�fdd�|D�}|D],\}}|||<t|dt�r<t|�|d_q<|j|j7_|j�	|j�|S)Ncs|dkr�S|�Sr�ry)�a)�offsetryrzr{�r|z'ParseResults.__iadd__.<locals>.<lambda>c	s4g|],\}}|D]}|t|d�|d��f�qqS�rr�)r��r�r��vlistr�)�	addoffsetryrzr��s�z)ParseResults.__iadd__.<locals>.<listcomp>r)
r�r�r�r�r}r$r�r�r��update)r�rZ
otheritemsZotherdictitemsr�r�ry)rrrz�__iadd__�s


�zParseResults.__iadd__cCs&t|t�r|dkr|��S||SdSr�)r}rvr��r�rryryrz�__radd__�szParseResults.__radd__cCsdt|j�t|j�fS)Nz(%s, %s))r�r�r�r�ryryrzr��szParseResults.__repr__cCsdd�dd�|jD��dS)N�[�, css(|] }t|t�rt|�nt|�VqdSr�)r}r$r�r��r�r�ryryrzr��sz'ParseResults.__str__.<locals>.<genexpr>�])r�r�r�ryryrzr��szParseResults.__str__r�cCsLg}|jD]<}|r |r |�|�t|t�r8||��7}q
|�t|��q
|Sr�)r�rr}r$�
_asStringListr�)r��sep�outrryryrzr(�s


zParseResults._asStringListcCsdd�|jD�S)a�
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::
            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
            
            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        cSs"g|]}t|t�r|��n|�qSry)r}r$r�)r��resryryrzr��sz'ParseResults.asList.<locals>.<listcomp>r�r�ryryrzr��szParseResults.asListcs6tr|j}n|j}�fdd��t�fdd�|�D��S)a�
        Returns the named parse results as a nested dictionary.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
            
            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        cs6t|t�r.|��r|��S�fdd�|D�Sn|SdS)Ncsg|]}�|��qSryryr���toItemryrzr��sz7ParseResults.asDict.<locals>.toItem.<locals>.<listcomp>)r}r$r
�asDict)r�r,ryrzr-�s

z#ParseResults.asDict.<locals>.toItemc3s|]\}}|�|�fVqdSr�ry�r�r�r�r,ryrzr��sz&ParseResults.asDict.<locals>.<genexpr>)�PY_3r�rr�)r�Zitem_fnryr,rzr.�s
	zParseResults.asDictcCs8t|j�}|j��|_|j|_|j�|j�|j|_|S)zA
        Returns a new copy of a C{ParseResults} object.
        )r$r�r�r�r�r�r r��r�r�ryryrzr��s
zParseResults.copyFcCsLd}g}tdd�|j��D��}|d}|s8d}d}d}d}	|dk	rJ|}	n|jrV|j}	|	sf|rbdSd}	|||d|	d	g7}t|j�D]�\}
}t|t�r�|
|kr�||�||
|o�|dk||�g7}n||�d|o�|dk||�g7}q�d}|
|kr�||
}|�s|�rq�nd}t	t
|��}
|||d|d	|
d
|d	g	7}q�|||d
|	d	g7}d�|�S)z�
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        �
css(|] \}}|D]}|d|fVqqdS�r�Nryrryryrzr�s�z%ParseResults.asXML.<locals>.<genexpr>�  r�NZITEM�<�>�</)r�r�r�r�r�r�r}r$�asXMLr�r�r�)r�ZdoctagZnamedItemsOnly�indentZ	formatted�nlr*Z
namedItemsZnextLevelIndentZselfTagr�r+ZresTagZxmlBodyTextryryrzr8�s^

�

�
�zParseResults.asXMLcCs:|j��D]*\}}|D]\}}||kr|Sqq
dSr�)r�r�)r�r�r�rr�r�ryryrzZ__lookup;s
zParseResults.__lookupcCs�|jr|jS|jr.|��}|r(|�|�SdSnNt|�dkrxt|j�dkrxtt|j����dddkrxtt|j����SdSdS)a(
        Returns the results name for this token expression. Useful when several 
        different expressions might match at a particular location.

        Example::
            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number") 
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)
            
            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])
        prints::
            age : 22
            ssn : 111-22-3333
            house_number : 221B
        Nr�r)rrt)	r�r��_ParseResults__lookupr�r��nextr�rr)r��parryryrz�getNameBs
��zParseResults.getNamercCsZg}d}|�|t|����|�rP|��r�tdd�|��D��}|D]r\}}|r\|�|�|�d|d||f�t|t�r�|r�|�|�||d��q�|�t|��qF|�t	|��qFn�t
dd�|D���rP|}t|�D]r\}	}
t|
t��r$|�d|d||	|d|d|
�||d�f�q�|�d|d||	|d|dt|
�f�q�d	�|�S)
aH
        Diagnostic method for listing out the contents of a C{ParseResults}.
        Accepts an optional C{indent} argument so that this string can be embedded
        in a nested display of other data.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(result.dump())
        prints::
            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        r2css|]\}}t|�|fVqdSr�)r~r/ryryrzr�~sz$ParseResults.dump.<locals>.<genexpr>z
%s%s- %s: r4r�css|]}t|t�VqdSr�)r}r$)r��vvryryrzr��sz
%s%s[%d]:
%s%s%sr�)
rr�r�r
�sortedr�r}r$�dumpr��anyr�r�)r�r9�depth�fullr*�NLr�r�r�r�r?ryryrzrAgs,

4,zParseResults.dumpcOstj|��f|�|�dS)a�
        Pretty-printer for parsed results as a list, using the C{pprint} module.
        Accepts additional positional or keyword args as defined for the 
        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})

        Example::
            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)
        prints::
            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        N)�pprintr��r�r�rryryrzrF�szParseResults.pprintcCs.|j|j��|jdk	r|��p d|j|jffSr�)r�r�r�r�r�r�r�ryryrz�__getstate__�s��zParseResults.__getstate__cCsN|d|_|d\|_}}|_i|_|j�|�|dk	rDt|�|_nd|_dSr�)r�r�r�r�r r�r�)r��stater=ZinAccumNamesryryrz�__setstate__�s
�zParseResults.__setstate__cCs|j|j|j|jfSr�)r�r�r�r�r�ryryrz�__getnewargs__�szParseResults.__getnewargs__cCstt|��t|���Sr�)r�r�r�rr�ryryrzr��szParseResults.__dir__)NNTT)N)r�)NFr�T)r�rT)4r�r�r�r�r�r}r�r�r�r�r�r�r��__nonzero__r�r�rrrr0rrr�r�rrr
rr�rrrrr�rr!r#r�r�r(r�r.r�r8r;r>rArFrHrJrKr�ryryryrzr$Dsh&
	'	
4

#
=%
-
cCsF|}d|krt|�kr4nn||ddkr4dS||�dd|�S)aReturns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   rr�r2)r��rfind)r��strgr�ryryrzr;�s
cCs|�dd|�dS)aReturns current line number within a string, counting newlines as line separators.
   The first line is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   r2rr�)�count)r�rNryryrzrL�s
cCsF|�dd|�}|�d|�}|dkr2||d|�S||dd�SdS)zfReturns the line of text containing loc within a string, counting newlines as line separators.
       r2rr�N)rM�find)r�rNZlastCRZnextCRryryrzrI�s
cCs8tdt|�dt|�dt||�t||�f�dS)NzMatch z at loc z(%d,%d))�printr�rLr;)�instringr��exprryryrz�_defaultStartDebugAction�srTcCs$tdt|�dt|����dS)NzMatched z -> )rQr�r~r�)rR�startlocZendlocrS�toksryryrz�_defaultSuccessDebugAction�srWcCstdt|��dS)NzException raised:)rQr�)rRr�rS�excryryrz�_defaultExceptionDebugAction�srYcGsdS)zG'Do-nothing' debug action, to suppress debugging output during parsing.Nry)r�ryryrzrS�srscs��tkr�fdd�Sdg�dg�tdd�dkrFddd�}dd	d
��ntj}tj�d}|dd�d
}|d|d|f�������fdd�}d}zt�dt�d�j�}Wntk
r�t��}YnX||_|S)Ncs�|�Sr�ry�r��lrx)�funcryrzr{r|z_trim_arity.<locals>.<lambda>rFrs)rq�cSs8tdkrdnd}tj||dd�|}|dd�gS)N)rqr]r������r���limitrs)�system_version�	traceback�
extract_stack)rar�
frame_summaryryryrzrdsz"_trim_arity.<locals>.extract_stackcSs$tj||d�}|d}|dd�gS)Nr`rtrs)rc�
extract_tb)�tbraZframesreryryrzrfsz_trim_arity.<locals>.extract_tb�r`rtr�c	s�z"�|�dd��}d�d<|WStk
r��dr>�n4z.t��d}�|dd�ddd��ksj�W5~X�d�kr��dd7<Yq�YqXqdS)NrTrtrsr`r�)r�r��exc_info)r�r�rg�rfZ
foundArityr\ra�maxargsZpa_call_line_synthryrz�wrapper-s z_trim_arity.<locals>.wrapperz<parse action>r��	__class__)r)r)	�singleArgBuiltinsrbrcrdrf�getattrr��	Exceptionr~)r\rkrdZ	LINE_DIFFZ	this_linerl�	func_nameryrjrz�_trim_aritys,

�rrcs�eZdZdZdZdZedd��Zedd��Zd�dd	�Z	d
d�Z
dd
�Zd�dd�Zd�dd�Z
dd�Zdd�Zdd�Zdd�Zdd�Zdd�Zd�dd �Zd!d"�Zd�d#d$�Zd%d&�Zd'd(�ZGd)d*�d*e�Zed+k	r�Gd,d-�d-e�ZnGd.d-�d-e�ZiZe�Zd/d/gZ d�d0d1�Z!eZ"ed2d3��Z#dZ$ed�d5d6��Z%d�d7d8�Z&e'dfd9d:�Z(d;d<�Z)e'fd=d>�Z*e'dfd?d@�Z+dAdB�Z,dCdD�Z-dEdF�Z.dGdH�Z/dIdJ�Z0dKdL�Z1dMdN�Z2dOdP�Z3dQdR�Z4dSdT�Z5dUdV�Z6dWdX�Z7dYdZ�Z8d�d[d\�Z9d]d^�Z:d_d`�Z;dadb�Z<dcdd�Z=dedf�Z>dgdh�Z?d�didj�Z@dkdl�ZAdmdn�ZBdodp�ZCdqdr�ZDgfdsdt�ZEd�dudv�ZF�fdwdx�ZGdydz�ZHd{d|�ZId}d~�ZJdd��ZKd�d�d��ZLd�d�d��ZM�ZNS)�r&z)Abstract base level parser element class.z 
	
FcCs
|t_dS)a�
        Overrides the default whitespace chars

        Example::
            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
            
            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        N)r&�DEFAULT_WHITE_CHARS��charsryryrz�setDefaultWhitespaceCharsTs
z'ParserElement.setDefaultWhitespaceCharscCs
|t_dS)a�
        Set class to be used for inclusion of string literals into a parser.
        
        Example::
            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        N)r&�_literalStringClass)r�ryryrz�inlineLiteralsUsingcsz!ParserElement.inlineLiteralsUsingcCs�t�|_d|_d|_d|_||_d|_tj|_	d|_
d|_d|_t�|_
d|_d|_d|_d|_d|_d|_d|_d|_d|_dS)NTFr�)NNN)r��parseAction�
failAction�strRepr�resultsName�
saveAsList�skipWhitespacer&rs�
whiteChars�copyDefaultWhiteChars�mayReturnEmpty�keepTabs�ignoreExprs�debug�streamlined�
mayIndexError�errmsg�modalResults�debugActions�re�callPreparse�
callDuringTry)r��savelistryryrzr�xs(zParserElement.__init__cCs<t�|�}|jdd�|_|jdd�|_|jr8tj|_|S)a$
        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
        for the same parsing pattern, using copies of the original parse element.
        
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
            
            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
        prints::
            [5120, 100, 655360, 268435456]
        Equivalent form of C{expr.copy()} is just C{expr()}::
            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
        N)r�ryr�r�r&rsr)r�Zcpyryryrzr��s
zParserElement.copycCs*||_d|j|_t|d�r&|j|j_|S)af
        Define name for this expression, makes debugging and exception messages clearer.
        
        Example::
            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        �	Expected �	exception)r�r�r�r�r�rryryrz�setName�s


zParserElement.setNamecCs4|��}|�d�r"|dd�}d}||_||_|S)aP
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original C{ParserElement} object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        C{expr("name")} in place of C{expr.setResultsName("name")} - 
        see L{I{__call__}<__call__>}.

        Example::
            date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        �*NrtT)r��endswithr|r�)r�r��listAllMatchesZnewselfryryrz�setResultsName�s
zParserElement.setResultsNameTcs@|r&|j�d�fdd�	}�|_||_nt|jd�r<|jj|_|S)z�Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set C{breakFlag} to True to enable, False to
           disable.
        Tcsddl}|���||||�Sr�)�pdbZ	set_trace)rRr��	doActions�callPreParser��Z_parseMethodryrz�breaker�sz'ParserElement.setBreak.<locals>.breaker�_originalParseMethod)TT)�_parser�r�)r�Z	breakFlagr�ryr�rz�setBreak�s
zParserElement.setBreakcOs&tttt|���|_|�dd�|_|S)a
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
         - s   = the original string being parsed (see note below)
         - loc = the location of the matching substring
         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        Optional keyword arguments:
         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
        consistent view of the parsed string, the parse location, and line and column
        positions within the parsed string.
        
        Example::
            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        r�F)r��maprrryr�r��r��fnsrryryrzr��s"zParserElement.setParseActioncOs4|jtttt|���7_|jp,|�dd�|_|S)z�
        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
        
        See examples in L{I{copy}<copy>}.
        r�F)ryr�r�rrr�r�r�ryryrz�addParseActionszParserElement.addParseActioncs^|�dd��|�dd�rtnt�|D] ����fdd�}|j�|�q$|jpV|�dd�|_|S)a�Add a boolean predicate function to expression's list of parse actions. See 
        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
        functions passed to C{addCondition} need to return boolean success/fail of the condition.

        Optional keyword arguments:
         - message = define a custom message to be used in the raised exception
         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
         
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        �messagezfailed user-defined condition�fatalFcs$tt��|||��s �||���dSr�)r	rrrZ��exc_type�fnr�ryrz�pa&sz&ParserElement.addCondition.<locals>.par�)r�r#r!ryrr�)r�r�rr�ryr�rz�addConditionszParserElement.addConditioncCs
||_|S)aDefine action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           C{fn(s,loc,expr,err)} where:
            - s = string being parsed
            - loc = location where expression match was attempted and failed
            - expr = the parse expression that failed
            - err = the exception thrown
           The function returns no value.  It may throw C{L{ParseFatalException}}
           if it is desired to stop parsing immediately.)rz)r�r�ryryrz�
setFailAction-s
zParserElement.setFailActionc	CsNd}|rJd}|jD]4}z|�||�\}}d}qWqtk
rDYqXqq|S�NTF)r�r�r!)r�rRr�Z
exprsFound�eZdummyryryrz�_skipIgnorables:s


zParserElement._skipIgnorablescCsH|jr|�||�}|jrD|j}t|�}||krD|||krD|d7}q&|S�Nr�)r�r�r~rr�)r�rRr�Zwt�instrlenryryrz�preParseGs
zParserElement.preParsecCs|gfSr�ry�r�rRr�r�ryryrz�	parseImplSszParserElement.parseImplcCs|Sr�ry�r�rRr��	tokenlistryryrz�	postParseVszParserElement.postParsec
Cs�|j}|s|jr�|jdr,|jd|||�|rD|jrD|�||�}n|}|}zDz|�|||�\}}Wn(tk
r�t|t|�|j	|��YnXWnXt
k
r�}	z:|jdr�|jd||||	�|jr�|�||||	��W5d}	~	XYnXn�|�r|j�r|�||�}n|}|}|j�s&|t|�k�rjz|�|||�\}}Wn*tk
�rft|t|�|j	|��YnXn|�|||�\}}|�|||�}t
||j|j|jd�}
|j�r�|�s�|j�r�|�rTzN|jD]B}||||
�}|dk	�r�t
||j|j�o�t|t
tf�|jd�}
�q�WnFt
k
�rP}	z&|jd�r>|jd||||	��W5d}	~	XYnXnJ|jD]B}||||
�}|dk	�rZt
||j|j�o�t|t
tf�|jd�}
�qZ|�r�|jd�r�|jd|||||
�||
fS)Nrrs)r�r�r�)r�rzr�r�r�r�r�r!r�r�rr�r�r$r|r}r�ryr�r}r�)r�rRr�r�r�Z	debugging�prelocZtokensStart�tokens�errZ	retTokensr�ryryrz�
_parseNoCacheZst





�

�
zParserElement._parseNoCachecCs@z|j||dd�dWStk
r:t|||j|��YnXdS)NF)r�r)r�r#r!r��r�rRr�ryryrz�tryParse�szParserElement.tryParsec	Cs4z|�||�Wnttfk
r*YdSXdSdS)NFT)r�r!r�r�ryryrz�canParseNext�s
zParserElement.canParseNextc@seZdZdd�ZdS)zParserElement._UnboundedCachecs~i�t�|_���fdd�}�fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr��r��r�r��cache�not_in_cacheryrzr��sz3ParserElement._UnboundedCache.__init__.<locals>.getcs|�|<dSr�ry�r�rr��r�ryrz�set�sz3ParserElement._UnboundedCache.__init__.<locals>.setcs���dSr��rr�r�ryrzr�sz5ParserElement._UnboundedCache.__init__.<locals>.clearcst��Sr��r�r�r�ryrz�	cache_len�sz9ParserElement._UnboundedCache.__init__.<locals>.cache_len)r�r��types�
MethodTyper�r�rr�)r�r�r�rr�ryr�rzr��sz&ParserElement._UnboundedCache.__init__N�r�r�r�r�ryryryrz�_UnboundedCache�sr�Nc@seZdZdd�ZdS)�ParserElement._FifoCachecs�t�|_�t����fdd�}��fdd�}�fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_dS)	Ncs��|��Sr�r�r�r�ryrzr��s�.ParserElement._FifoCache.__init__.<locals>.getcs>|�|<t���kr:z��d�Wqtk
r6YqXqdS�NF)r��popitemr�r�)r��sizeryrzr��s�.ParserElement._FifoCache.__init__.<locals>.setcs���dSr�r�r�r�ryrzr�s�0ParserElement._FifoCache.__init__.<locals>.clearcst��Sr�r�r�r�ryrzr��s�4ParserElement._FifoCache.__init__.<locals>.cache_len)	r�r��_OrderedDictr�r�r�r�rr��r�r�r�r�rr�ry)r�r�r�rzr��s�!ParserElement._FifoCache.__init__Nr�ryryryrz�
_FifoCache�sr�c@seZdZdd�ZdS)r�cs�t�|_�i�t�g�����fdd�}���fdd�}��fdd�}�fdd�}t�||�|_t�||�|_t�||�|_t�||�|_	dS)	Ncs��|��Sr�r�r�r�ryrzr��sr�cs4|�|<t���kr&�����d�q��|�dSr�)r�r�popleftrr�)r��key_fifor�ryrzr��sr�cs������dSr�r�r�)r�r�ryrzr�sr�cst��Sr�r�r�r�ryrzr��sr�)
r�r��collections�dequer�r�r�r�rr�r�ry)r�r�r�r�rzr��sr�Nr�ryryryrzr��srcCsd\}}|||||f}tj��tj}|�|�}	|	|jkr�tj|d7<z|�||||�}	Wn8tk
r�}
z|�||
j	|
j
���W5d}
~
XYn.X|�||	d|	d��f�|	W5QR�Sn@tj|d7<t|	t
�r�|	�|	d|	d��fW5QR�SW5QRXdS)Nrr�r)r&�packrat_cache_lock�
packrat_cacher�r��packrat_cache_statsr�rr�rmr�r�r}rp)r�rRr�r�r�ZHITZMISS�lookupr�r�r�ryryrz�_parseCaches$


zParserElement._parseCachecCs(tj��dgttj�tjdd�<dSr�)r&r�rr�r�ryryryrz�
resetCaches
zParserElement.resetCache�cCs8tjs4dt_|dkr t��t_nt�|�t_tjt_dS)a�Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.
           
           Parameters:
            - cache_size_limit - (default=C{128}) - if an integer value is provided
              will limit the size of the packrat cache; if None is passed, then
              the cache size will be unbounded; if 0 is passed, the cache will
              be effectively disabled.
            
           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method C{ParserElement.enablePackrat()}.  If
           your program uses C{psyco} to "compile as you go", you must call
           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
           Python will crash.  For best results, call C{enablePackrat()} immediately
           after importing pyparsing.
           
           Example::
               import pyparsing
               pyparsing.ParserElement.enablePackrat()
        TN)r&�_packratEnabledr�r�r�r�r�)Zcache_size_limitryryrz�
enablePackrat%szParserElement.enablePackratc
Cs�t��|js|��|jD]}|��q|js8|��}z<|�|d�\}}|rr|�||�}t	�t
�}|�||�Wn0tk
r�}ztjr��n|�W5d}~XYnX|SdS)aB
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set C{parseAll} to True (equivalent to ending
        the grammar with C{L{StringEnd()}}).

        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the C{loc} argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:
         - calling C{parseWithTabs} on your grammar before calling C{parseString}
           (see L{I{parseWithTabs}<parseWithTabs>})
         - define your parse action using the full C{(s,loc,toks)} signature, and
           reference the input string using the parse action's C{s} argument
         - explictly expand the tabs in your input string before calling
           C{parseString}
        
        Example::
            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        rN)
r&r�r��
streamliner�r��
expandtabsr�r�rr+r�verbose_stacktrace)r�rR�parseAllr�r�r�ZserXryryrz�parseStringHs$

zParserElement.parseStringc
cs6|js|��|jD]}|��q|js4t|���}t|�}d}|j}|j}t	�
�d}	z�||kr�|	|kr�z |||�}
|||
dd�\}}Wntk
r�|
d}YqZX||kr�|	d7}	||
|fV|r�|||�}
|
|kr�|}q�|d7}q�|}qZ|
d}qZWn4tk
�r0}zt	j
�r�n|�W5d}~XYnXdS)a�
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
        C{overlap} is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
        strings with embedded tabs.

        Example::
            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens,start,end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])
        
        prints::
        
            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        rF�r�r�N)r�r�r�r�r�r�r�r�r�r&r�r!rr�)r�rR�
maxMatchesZoverlapr�r�r�Z
preparseFnZparseFn�matchesr�ZnextLocr�ZnextlocrXryryrz�
scanStringzsB




zParserElement.scanStringc
Cs�g}d}d|_z�|�|�D]Z\}}}|�|||��|rpt|t�rR||��7}nt|t�rf||7}n
|�|�|}q|�||d��dd�|D�}d�tt	t
|���WStk
r�}ztj
rƂn|�W5d}~XYnXdS)af
        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
        be returned from a parse action.  To use C{transformString}, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking C{transformString()} on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  C{transformString()} returns the resulting transformed string.
        
        Example::
            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())
            
            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
        Prints::
            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        rTNcSsg|]}|r|�qSryry)r��oryryrzr��sz1ParserElement.transformString.<locals>.<listcomp>r�)r�r�rr}r$r�r�r�r�r��_flattenrr&r�)r�rRr*ZlastErxr�r�rXryryrzr��s(



zParserElement.transformStringc
CsRztdd�|�||�D��WStk
rL}ztjr8�n|�W5d}~XYnXdS)a�
        Another extension to C{L{scanString}}, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        C{maxMatches} argument, to clip searching after 'n' matches are found.
        
        Example::
            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())
            
            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
        prints::
            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        cSsg|]\}}}|�qSryry)r�rxr�r�ryryrzr��sz.ParserElement.searchString.<locals>.<listcomp>N)r$r�rr&r�)r�rRr�rXryryrz�searchString�szParserElement.searchStringc	csTd}d}|j||d�D]*\}}}|||�V|r<|dV|}q||d�VdS)a[
        Generator method to split a string using the given expression as a separator.
        May be called with optional C{maxsplit} argument, to limit the number of splits;
        and the optional C{includeSeparators} argument (default=C{False}), if the separating
        matching text should be included in the split results.
        
        Example::        
            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
        prints::
            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        r)r�N)r�)	r�rR�maxsplitZincludeSeparatorsZsplitsZlastrxr�r�ryryrzr�s

zParserElement.splitcCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)a�
        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
        converts them to L{Literal}s by default.
        
        Example::
            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))
        Prints::
            Hello, World! -> ['Hello', ',', 'World', '!']
        �4Cannot combine element of type %s with ParserElementrs��
stacklevelN)	r}r�r&rw�warnings�warnr��
SyntaxWarningrr"ryryrzrs


�zParserElement.__add__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of + operator when left operand is not a C{L{ParserElement}}
        r�rsr�N�r}r�r&rwr�r�r�r�r"ryryrzr#1s


�zParserElement.__radd__cCsJt|t�rt�|�}t|t�s:tjdt|�tdd�dS|t�	�|S)zQ
        Implementation of - operator, returns C{L{And}} with error stop
        r�rsr�N)
r}r�r&rwr�r�r�r�r�
_ErrorStopr"ryryrz�__sub__=s


�zParserElement.__sub__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||S)z]
        Implementation of - operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rsub__Is


�zParserElement.__rsub__cs�t|t�r|d}}n�t|t�r�|ddd�}|ddkrHd|df}t|dt�r�|ddkr�|ddkrvt��S|ddkr�t��S�|dt��Sq�t|dt�r�t|dt�r�|\}}||8}q�tdt|d�t|d���ntdt|���|dk�rtd��|dk�rtd	��||k�r6dk�rBnntd
��|�r���fdd��|�r�|dk�rt��|�}nt�g|��|�}n�|�}n|dk�r��}nt�g|�}|S)
a�
        Implementation of * operator, allows use of C{expr * 3} in place of
        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
        may also include C{None} as in:
         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
              to C{expr*n + L{ZeroOrMore}(expr)}
              (read as "at least n instances of C{expr}")
         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
              (read as "0 to n instances of C{expr}")
         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}

        Note that C{expr*(None,n)} does not raise an exception if
        more than n exprs exist in the input stream; that is,
        C{expr*(None,n)} does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        C{expr*(None,n) + ~expr}
        r)NNNrsr�z7cannot multiply 'ParserElement' and ('%s','%s') objectsz0cannot multiply 'ParserElement' and '%s' objectsz/cannot multiply ParserElement by negative valuez@second tuple value must be greater or equal to first tuple valuez+cannot multiply ParserElement by 0 or (0,0)cs(|dkrt��|d��St��SdSr�)r��n��makeOptionalListr�ryrzr��sz/ParserElement.__mul__.<locals>.makeOptionalList)	r}rv�tupler4rr�r��
ValueErrorr)r�rZminElementsZoptElementsr�ryr�rz�__mul__UsD







zParserElement.__mul__cCs
|�|�Sr�)rr"ryryrz�__rmul__�szParserElement.__rmul__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zI
        Implementation of | operator - returns C{L{MatchFirst}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__or__�s


�zParserElement.__or__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||BS)z]
        Implementation of | operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__ror__�s


�zParserElement.__ror__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zA
        Implementation of ^ operator - returns C{L{Or}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__xor__�s


�zParserElement.__xor__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||AS)z]
        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rxor__�s


�zParserElement.__rxor__cCsFt|t�rt�|�}t|t�s:tjdt|�tdd�dSt||g�S)zC
        Implementation of & operator - returns C{L{Each}}
        r�rsr�N)	r}r�r&rwr�r�r�r�rr"ryryrz�__and__�s


�zParserElement.__and__cCsBt|t�rt�|�}t|t�s:tjdt|�tdd�dS||@S)z]
        Implementation of & operator when left operand is not a C{L{ParserElement}}
        r�rsr�Nr�r"ryryrz�__rand__�s


�zParserElement.__rand__cCst|�S)zE
        Implementation of ~ operator - returns C{L{NotAny}}
        )rr�ryryrz�
__invert__�szParserElement.__invert__cCs|dk	r|�|�S|��SdS)a

        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
        
        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
        passed as C{True}.
           
        If C{name} is omitted, same as calling C{L{copy}}.

        Example::
            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
        N)r�r�rryryrz�__call__�s
zParserElement.__call__cCst|�S)z�
        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
        cluttering up returned output.
        )r-r�ryryrz�suppress�szParserElement.suppresscCs
d|_|S)a
        Disables the skipping of whitespace before matching the characters in the
        C{ParserElement}'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        F�r~r�ryryrz�leaveWhitespaceszParserElement.leaveWhitespacecCsd|_||_d|_|S)z8
        Overrides the default whitespace chars
        TF)r~rr�)r�ruryryrz�setWhitespaceChars
sz ParserElement.setWhitespaceCharscCs
d|_|S)z�
        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
        Must be called before C{parseString} when the input grammar contains elements that
        match C{<TAB>} characters.
        T)r�r�ryryrz�
parseWithTabsszParserElement.parseWithTabscCsLt|t�rt|�}t|t�r4||jkrH|j�|�n|j�t|����|S)a�
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.
        
        Example::
            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
            
            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        )r}r�r-r�rr�r"ryryrz�ignores


zParserElement.ignorecCs"|pt|pt|ptf|_d|_|S)zT
        Enable display of debugging messages while doing pattern matching.
        T)rTrWrYr�r�)r�ZstartActionZ
successActionZexceptionActionryryrz�setDebugActions6s�zParserElement.setDebugActionscCs|r|�ttt�nd|_|S)a�
        Enable display of debugging messages while doing pattern matching.
        Set C{flag} to True to enable, False to disable.

        Example::
            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer
            
            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")
        
        prints::
            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using L{setDebugActions}. Prior to attempting
        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
        F)rrTrWrYr�)r��flagryryrz�setDebug@s#zParserElement.setDebugcCs|jSr�)r�r�ryryrzr�iszParserElement.__str__cCst|�Sr�r�r�ryryrzr�lszParserElement.__repr__cCsd|_d|_|Sr�)r�r{r�ryryrzr�oszParserElement.streamlinecCsdSr�ryr�ryryrz�checkRecursiontszParserElement.checkRecursioncCs|�g�dS)zj
        Check defined expressions for valid structure, check for infinite recursive definitions.
        N)r)r��
validateTraceryryrz�validatewszParserElement.validatecCs�z|��}Wn2tk
r>t|d��}|��}W5QRXYnXz|�||�WStk
r~}ztjrj�n|�W5d}~XYnXdS)z�
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        �rN)�readr��openr�rr&r�)r�Zfile_or_filenamer�Z
file_contents�frXryryrz�	parseFile}szParserElement.parseFilecsHt|t�r"||kp t|�t|�kSt|t�r6|�|�Stt|�|kSdSr�)r}r&�varsr�r��superr"�rmryrz�__eq__�s



zParserElement.__eq__cCs
||kSr�ryr"ryryrz�__ne__�szParserElement.__ne__cCstt|��Sr�)�hash�idr�ryryrz�__hash__�szParserElement.__hash__cCs||kSr�ryr"ryryrz�__req__�szParserElement.__req__cCs
||kSr�ryr"ryryrz�__rne__�szParserElement.__rne__cCs4z|jt|�|d�WdStk
r.YdSXdS)a�
        Method for quick testing of a parser against a test string. Good for simple 
        inline microtests of sub expressions while building up larger parser.
           
        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
            
        Example::
            expr = Word(nums)
            assert expr.matches("100")
        �r�TFN)r�r�r)r�Z
testStringr�ryryrzr��s

zParserElement.matches�#cCs�t|t�r"tttj|������}t|t�r4t|�}g}g}d}	|D�]�}
|dk	r^|�	|
d�sf|rr|
sr|�
|
�qD|
sxqDd�|�|
g}g}z:|
�dd�}
|j
|
|d�}|�
|j|d��|	o�|}	Wn�tk
�rr}
z�t|
t�r�dnd	}d|
k�r*|�
t|
j|
��|�
d
t|
j|
�dd|�n|�
d
|
jd|�|�
d
t|
��|	�o\|}	|
}W5d}
~
XYnDtk
�r�}z$|�
dt|��|	�o�|}	|}W5d}~XYnX|�r�|�r�|�
d	�td�|��|�
|
|f�qD|	|fS)a3
        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.
           
        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
              string; pass None to disable comment filtering
         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default=C{True}) prints test output to stdout
         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
        test's output
        
        Example::
            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")
        prints::
            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success
            
            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\n of strings that spans \n 3 lines")
        
        (Note that this is a raw string literal, you must include the leading 'r'.)
        TNFr2�\nr%)rDz(FATAL)r�� r��^zFAIL: zFAIL-EXCEPTION: )r}r�r�r�r~r��rstrip�
splitlinesrr�rr�r�r�rArr#rIr�r;rprQ)r�Ztestsr�ZcommentZfullDumpZprintResultsZfailureTestsZ
allResultsZcomments�successrxr*�resultr�r�rXryryrz�runTests�sNW




$


zParserElement.runTests)F)F)T)T)TT)TT)r�)F)N)T)F)T)Tr&TTF)Or�r�r�r�rsr��staticmethodrvrxr�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�r�rr�r�r�r�r�r�r�r��_MAX_INTr�r�r�r�rr#r�r�rrrrrrrrrr	r
rr
rrrrr�r�r�rrrrrr"r#r$r�r.�
__classcell__ryryrrzr&Os�




&




G

"
2G+D
			

)

cs eZdZdZ�fdd�Z�ZS)r.zT
    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
    cstt|�jdd�dS�NF�r�)rr.r�r�rryrzr�@	szToken.__init__�r�r�r�r�r�r1ryryrrzr.<	scs eZdZdZ�fdd�Z�ZS)rz,
    An empty token, will always match.
    cs$tt|���d|_d|_d|_dS)NrTF)rrr�r�r�r�r�rryrzr�H	szEmpty.__init__r4ryryrrzrD	scs*eZdZdZ�fdd�Zddd�Z�ZS)rz(
    A token that will never match.
    cs*tt|���d|_d|_d|_d|_dS)NrTFzUnmatchable token)rrr�r�r�r�r�r�rryrzr�S	s
zNoMatch.__init__TcCst|||j|��dSr�)r!r�r�ryryrzr�Z	szNoMatch.parseImpl)T�r�r�r�r�r�r�r1ryryrrzrO	scs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Token to exactly match a specified string.
    
    Example::
        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
    
    For case-insensitive matching, use L{CaselessLiteral}.
    
    For keyword matching (force word break before and after the matched string),
    use L{Keyword} or L{CaselessKeyword}.
    cs�tt|���||_t|�|_z|d|_Wn*tk
rVtj	dt
dd�t|_YnXdt
|j�|_d|j|_d|_d|_dS)Nrz2null string passed to Literal; use Empty() insteadrsr��"%s"r�F)rrr��matchr��matchLen�firstMatchCharr�r�r�r�rrmr�r�r�r�r��r��matchStringrryrzr�l	s
�zLiteral.__init__TcCsJ|||jkr6|jdks&|�|j|�r6||j|jfSt|||j|��dSr�)r9r8�
startswithr7r!r�r�ryryrzr�	s��zLiteral.parseImpl)Tr5ryryrrzr^	s
csLeZdZdZedZd�fdd�	Zddd	�Z�fd
d�Ze	dd
��Z
�ZS)ra\
    Token to exactly match a specified string as a keyword, that is, it must be
    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
    Accepts two optional constructor arguments in addition to the keyword string:
     - C{identChars} is a string of characters that would be valid identifier characters,
          defaulting to all alphanumerics + "_" and "$"
     - C{caseless} allows case-insensitive matching, default is C{False}.
       
    Example::
        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use L{CaselessKeyword}.
    �_$NFcs�tt|���|dkrtj}||_t|�|_z|d|_Wn$tk
r^t	j
dtdd�YnXd|j|_d|j|_
d|_d|_||_|r�|��|_|��}t|�|_dS)Nrz2null string passed to Keyword; use Empty() insteadrsr�r6r�F)rrr��DEFAULT_KEYWORD_CHARSr7r�r8r9r�r�r�r�r�r�r�r��caseless�upper�
caselessmatchr��
identChars)r�r;rBr?rryrzr��	s*
�
zKeyword.__init__TcCs|jr|||||j���|jkr�|t|�|jksL|||j��|jkr�|dksj||d��|jkr�||j|jfSnv|||jkr�|jdks�|�|j|�r�|t|�|jks�|||j|jkr�|dks�||d|jkr�||j|jfSt	|||j
|��dSr�)r?r8r@rAr�rBr7r9r<r!r�r�ryryrzr��	s4����������zKeyword.parseImplcstt|���}tj|_|Sr�)rrr�r>rB)r�r�rryrzr��	szKeyword.copycCs
|t_dS)z,Overrides the default Keyword chars
        N)rr>rtryryrz�setDefaultKeywordChars�	szKeyword.setDefaultKeywordChars)NF)T)r�r�r�r�r5r>r�r�r�r/rCr1ryryrrzr�	s
cs*eZdZdZ�fdd�Zddd�Z�ZS)r
al
    Token to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::
        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
        
    (Contrast with example for L{CaselessKeyword}.)
    cs6tt|��|���||_d|j|_d|j|_dS)Nz'%s'r�)rr
r�r@�returnStringr�r�r:rryrzr��	szCaselessLiteral.__init__TcCs@||||j���|jkr,||j|jfSt|||j|��dSr�)r8r@r7rDr!r�r�ryryrzr��	szCaselessLiteral.parseImpl)Tr5ryryrrzr
�	s
cs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
r	z�
    Caseless version of L{Keyword}.

    Example::
        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
        
    (Contrast with example for L{CaselessLiteral}.)
    Ncstt|�j||dd�dS)NT�r?)rr	r�)r�r;rBrryrzr��	szCaselessKeyword.__init__TcCsj||||j���|jkrV|t|�|jksF|||j��|jkrV||j|jfSt|||j|��dSr�)r8r@rAr�rBr7r!r�r�ryryrzr��	s��zCaselessKeyword.parseImpl)N)Tr5ryryrrzr	�	scs,eZdZdZd�fdd�	Zd	dd�Z�ZS)
rnax
    A variation on L{Literal} which matches "close" matches, that is, 
    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
     - C{match_string} - string to be matched
     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
    
    The results from a successful parse will contain the matched text from the input string and the following named results:
     - C{mismatches} - a list of the positions within the match_string where mismatches were found
     - C{original} - the original match_string used to compare against the input string
    
    If C{mismatches} is an empty list, then the match was an exact match.
    
    Example::
        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    r�csBtt|���||_||_||_d|j|jf|_d|_d|_dS)Nz&Expected %r (with up to %d mismatches)F)	rrnr�r��match_string�
maxMismatchesr�r�r�)r�rFrGrryrzr�

szCloseMatch.__init__TcCs�|}t|�}|t|j�}||kr�|j}d}g}	|j}
tt|||�|j��D]2\}}|\}}
||
krN|	�|�t|	�|
krNq�qN|d}t|||�g�}|j|d<|	|d<||fSt|||j|��dS)Nrr��original�
mismatches)	r�rFrGr�r�rr$r!r�)r�rRr�r��startr��maxlocrFZmatch_stringlocrIrGZs_m�src�mat�resultsryryrzr�
s( 

zCloseMatch.parseImpl)r�)Tr5ryryrrzrn�	s	cs8eZdZdZd
�fdd�	Zdd	d
�Z�fdd�Z�ZS)r1a	
    Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters,
    an optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction. An optional
    C{excludeChars} parameter can list characters that might be found in 
    the input C{bodyChars} string; useful to define a word of all printables
    except for one or two characters, for instance.
    
    L{srange} is useful for defining custom character set strings for defining 
    C{Word} expressions, using range notation from regular expression character sets.
    
    A common mistake is to use C{Word} to match a specific literal string, as in 
    C{Word("Address")}. Remember that C{Word} uses the string argument to define
    I{sets} of matchable characters. This expression would match "Add", "AAA",
    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
    To match an exact literal string, use L{Literal} or L{Keyword}.

    pyparsing includes helper strings for building Words:
     - L{alphas}
     - L{nums}
     - L{alphanums}
     - L{hexnums}
     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - L{printables} (any non-whitespace character)

    Example::
        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
        
        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums+'-')
        
        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")
        
        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    Nr�rFcs�tt|����rFd��fdd�|D��}|rFd��fdd�|D��}||_t|�|_|rl||_t|�|_n||_t|�|_|dk|_	|dkr�t
d��||_|dkr�||_nt
|_|dkr�||_||_t|�|_d|j|_d	|_||_d
|j|jk�r�|dk�r�|dk�r�|dk�r�|j|jk�r8dt|j�|_nHt|j�dk�rfdt�|j�t|j�f|_nd
t|j�t|j�f|_|j�r�d|jd|_zt�|j�|_Wntk
�r�d|_YnXdS)Nr�c3s|]}|�kr|VqdSr�ryr���excludeCharsryrzr�`
sz Word.__init__.<locals>.<genexpr>c3s|]}|�kr|VqdSr�ryr�rOryrzr�b
srr�zZcannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permittedr�Fr(z[%s]+z%s[%s]*z	[%s][%s]*z\b)rr1r�r��
initCharsOrigr��	initChars�
bodyCharsOrig�	bodyChars�maxSpecifiedr��minLen�maxLenr0r�r�r�r��	asKeyword�_escapeRegexRangeChars�reStringr�r��escape�compilerp)r�rRrT�min�max�exactrXrPrrOrzr�]
s\



0
����z
Word.__init__Tc
Cs>|jr<|j�||�}|s(t|||j|��|��}||��fS|||jkrZt|||j|��|}|d7}t|�}|j}||j	}t
||�}||kr�|||kr�|d7}q�d}	|||jkr�d}	|jr�||kr�|||kr�d}	|j
�r|dkr�||d|k�s||k�r|||k�rd}	|	�r.t|||j|��||||�fS)Nr�FTr)r�r7r!r��end�grouprRr�rTrWr]rVrUrX)
r�rRr�r�r-rJr�Z	bodycharsrKZthrowExceptionryryrzr��
s6


2zWord.parseImplcsvztt|���WStk
r$YnX|jdkrpdd�}|j|jkr`d||j�||j�f|_nd||j�|_|jS)NcSs$t|�dkr|dd�dS|SdS)N��...r��r�ryryrz�
charsAsStr�
sz Word.__str__.<locals>.charsAsStrz	W:(%s,%s)zW:(%s))rr1r�rpr{rQrS)r�rerryrzr��
s
zWord.__str__)Nr�rrFN)T�r�r�r�r�r�r�r�r1ryryrrzr1.
s.6
#csFeZdZdZee�d��Zd�fdd�	Zddd�Z	�fd	d
�Z
�ZS)
r)a�
    Token for matching strings that match a given regular expression.
    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
    named parse results.

    Example::
        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    z[A-Z]rcs�tt|���t|t�r�|s,tjdtdd�||_||_	zt
�|j|j	�|_
|j|_Wq�t
jk
r�tjd|tdd��Yq�Xn2t|tj�r�||_
t|�|_|_||_	ntd��t|�|_d|j|_d|_d|_d	S)
z�The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags.z0null string passed to Regex; use Empty() insteadrsr��$invalid pattern (%s) passed to RegexzCRegex may only be constructed with a string or a compiled RE objectr�FTN)rr)r�r}r�r�r�r��pattern�flagsr�r\rZ�
sre_constants�error�compiledREtyper~r�r�r�r�r�r�)r�rhrirryrzr��
s:
�
�
�
zRegex.__init__TcCs`|j�||�}|s"t|||j|��|��}|��}t|���}|rX|D]}||||<qF||fSr�)r�r7r!r�r`�	groupdictr$ra)r�rRr�r�r-�dr�r�ryryrzr��
szRegex.parseImplcsFztt|���WStk
r$YnX|jdkr@dt|j�|_|jS)NzRe:(%s))rr)r�rpr{r�rhr�rryrzr�
s
z
Regex.__str__)r)T)r�r�r�r�r�r�r\rlr�r�r�r1ryryrrzr)�
s
"

cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
r'a�
    Token for matching strings that are delimited by quoting characters.
    
    Defined with the following parameters:
        - quoteChar - string of one or more characters defining the quote delimiting string
        - escChar - character to escape quotes, typically backslash (default=C{None})
        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})

    Example::
        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
    prints::
        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    NFTc
sNtt����|��}|s0tjdtdd�t��|dkr>|}n"|��}|s`tjdtdd�t��|�_t	|��_
|d�_|�_t	|��_
|�_|�_|�_|�_|r�tjtjB�_dt��j�t�jd�|dk	r�t|�p�df�_n<d�_dt��j�t�jd�|dk	�rt|��pdf�_t	�j�d	k�rp�jd
d��fdd
�tt	�j�d	dd�D��d7_|�r��jdt�|�7_|�r��jdt�|�7_t��j�d�_�jdt��j�7_zt��j�j��_�j�_Wn0tjk
�r&tjd�jtdd��YnXt ���_!d�j!�_"d�_#d�_$dS)Nz$quoteChar cannot be the empty stringrsr�z'endQuoteChar cannot be the empty stringrz%s(?:[^%s%s]r�z%s(?:[^%s\n\r%s]r�z|(?:z)|(?:c3s4|],}dt��jd|��t�j|�fVqdS)z%s[^%s]N)r�r[�endQuoteCharrYr&r�ryrzr�Xs��z(QuotedString.__init__.<locals>.<genexpr>rt�)z|(?:%s)z|(?:%s.)z(.)z)*%srgr�FT)%rr'r�r�r�r�r��SyntaxError�	quoteCharr��quoteCharLen�firstQuoteCharro�endQuoteCharLen�escChar�escQuote�unquoteResults�convertWhitespaceEscapesr��	MULTILINE�DOTALLrir[rYrhr�r��escCharReplacePatternr\rZrjrkr�r�r�r�r�)r�rrrvrwZ	multilinerxroryrr�rzr�/s|



��
������
zQuotedString.__init__c	Cs�|||jkr|j�||�pd}|s4t|||j|��|��}|��}|jr�||j|j	�}t
|t�r�d|kr�|jr�ddddd�}|�
�D]\}}|�||�}q�|jr�t�|jd|�}|jr�|�|j|j�}||fS)N�\�	r2��
)�\tr'z\fz\rz\g<1>)rtr�r7r!r�r`rarxrsrur}r�ryr�r�rvr�r|rwro)	r�rRr�r�r-r�Zws_mapZwslitZwscharryryrzr�ps* 
�zQuotedString.parseImplcsHztt|���WStk
r$YnX|jdkrBd|j|jf|_|jS)Nz.quoted string, starting with %s ending with %s)rr'r�rpr{rrror�rryrzr��s
zQuotedString.__str__)NNFTNT)Trfryryrrzr'sA
#cs8eZdZdZd�fdd�	Zddd�Z�fd	d
�Z�ZS)
ra�
    Token for matching words composed of characters I{not} in a given set (will
    include whitespace in matched characters if not listed in the provided exclusion set - see example).
    Defined with string containing all disallowed characters, and an optional
    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction.

    Example::
        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
    prints::
        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    r�rcs�tt|���d|_||_|dkr*td��||_|dkr@||_nt|_|dkrZ||_||_t	|�|_
d|j
|_|jdk|_d|_
dS)NFr�zfcannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permittedrr�)rrr�r~�notCharsr�rVrWr0r�r�r�r�r�)r�r�r]r^r_rryrzr��s 
zCharsNotIn.__init__TcCs�|||jkrt|||j|��|}|d7}|j}t||jt|��}||krb|||krb|d7}qD|||jkr�t|||j|��||||�fSr�)r�r!r�r]rWr�rV)r�rRr�r�rJZnotchars�maxlenryryrzr��s
�
zCharsNotIn.parseImplcsfztt|���WStk
r$YnX|jdkr`t|j�dkrTd|jdd�|_nd|j|_|jS)Nrbz
!W:(%s...)z!W:(%s))rrr�rpr{r�r�r�rryrzr��s
zCharsNotIn.__str__)r�rr)Trfryryrrzr�s
cs<eZdZdZdddddd�Zd�fdd�	Zddd�Z�ZS)r0a�
    Special matching class for matching whitespace.  Normally, whitespace is ignored
    by pyparsing grammars.  This class is included when some whitespace structures
    are significant.  Define with a string containing the whitespace characters to be
    matched; default is C{" \t\r\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
    as defined for the C{L{Word}} class.
    z<SPC>z<TAB>z<LF>z<CR>z<FF>)r(r~r2r�r� 	
r�rcs�tt����|�_��d��fdd��jD���d�dd��jD���_d�_d�j�_	|�_
|dkrt|�_nt�_|dkr�|�_|�_
dS)Nr�c3s|]}|�jkr|VqdSr�)�
matchWhiter�r�ryrzr��s
z!White.__init__.<locals>.<genexpr>css|]}tj|VqdSr�)r0�	whiteStrsr�ryryrzr��sTr�r)
rr0r�r�r
r�rr�r�r�rVrWr0)r�Zwsr]r^r_rr�rzr��s zWhite.__init__TcCs�|||jkrt|||j|��|}|d7}||j}t|t|��}||krb|||jkrb|d7}qB|||jkr�t|||j|��||||�fSr�)r�r!r�rWr]r�rV)r�rRr�r�rJrKryryrzr�	s

zWhite.parseImpl)r�r�rr)T)r�r�r�r�r�r�r�r1ryryrrzr0�s�cseZdZ�fdd�Z�ZS)�_PositionTokencs(tt|���|jj|_d|_d|_dSr�)rr�r�rmr�r�r�r�r�rryrzr�s
z_PositionToken.__init__�r�r�r�r�r1ryryrrzr�sr�cs2eZdZdZ�fdd�Zdd�Zd	dd�Z�ZS)
rzb
    Token to advance to a specific column of input text; useful for tabular report scraping.
    cstt|���||_dSr�)rrr�r;)r��colnorryrzr�$szGoToColumn.__init__cCs\t||�|jkrXt|�}|jr*|�||�}||krX||��rXt||�|jkrX|d7}q*|Sr�)r;r�r�r��isspace)r�rRr�r�ryryrzr�(s$
zGoToColumn.preParseTcCsDt||�}||jkr"t||d|��||j|}|||�}||fS)NzText not in expected column�r;r!)r�rRr�r�ZthiscolZnewlocr�ryryrzr�1s

zGoToColumn.parseImpl)T)r�r�r�r�r�r�r�r1ryryrrzr s	cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Matches if current position is at the beginning of a line within the parse string
    
    Example::
    
        test = '''        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)
    
    Prints::
        ['AAA', ' this line']
        ['AAA', ' and this line']    

    cstt|���d|_dS)NzExpected start of line)rrr�r�r�rryrzr�OszLineStart.__init__TcCs*t||�dkr|gfSt|||j|��dSr�)r;r!r�r�ryryrzr�SszLineStart.parseImpl)Tr5ryryrrzr:scs*eZdZdZ�fdd�Zddd�Z�ZS)rzU
    Matches if current position is at the end of a line within the parse string
    cs,tt|���|�tj�dd��d|_dS)Nr2r�zExpected end of line)rrr�r
r&rsr�r�r�rryrzr�\szLineEnd.__init__TcCsb|t|�kr6||dkr$|ddfSt|||j|��n(|t|�krN|dgfSt|||j|��dS)Nr2r��r�r!r�r�ryryrzr�aszLineEnd.parseImpl)Tr5ryryrrzrXscs*eZdZdZ�fdd�Zddd�Z�ZS)r,zM
    Matches if current position is at the beginning of the parse string
    cstt|���d|_dS)NzExpected start of text)rr,r�r�r�rryrzr�pszStringStart.__init__TcCs0|dkr(||�|d�kr(t|||j|��|gfSr�)r�r!r�r�ryryrzr�tszStringStart.parseImpl)Tr5ryryrrzr,lscs*eZdZdZ�fdd�Zddd�Z�ZS)r+zG
    Matches if current position is at the end of the parse string
    cstt|���d|_dS)NzExpected end of text)rr+r�r�r�rryrzr�szStringEnd.__init__TcCs^|t|�krt|||j|��n<|t|�kr6|dgfS|t|�krJ|gfSt|||j|��dSr�r�r�ryryrzr��szStringEnd.parseImpl)Tr5ryryrrzr+{scs.eZdZdZef�fdd�	Zddd�Z�ZS)r3ap
    Matches if the current position is at the beginning of a Word, and
    is not preceded by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
    the string being parsed, or at the beginning of a line.
    cs"tt|���t|�|_d|_dS)NzNot at the start of a word)rr3r�r��	wordCharsr��r�r�rryrzr��s
zWordStart.__init__TcCs@|dkr8||d|jks(|||jkr8t|||j|��|gfSr�)r�r!r�r�ryryrzr��s�zWordStart.parseImpl)T�r�r�r�r�rXr�r�r1ryryrrzr3�scs.eZdZdZef�fdd�	Zddd�Z�ZS)r2aZ
    Matches if the current position is at the end of a Word, and
    is not followed by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{} behavior of regular expressions,
    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
    the string being parsed, or at the end of a line.
    cs(tt|���t|�|_d|_d|_dS)NFzNot at the end of a word)rr2r�r�r�r~r�r�rryrzr��s
zWordEnd.__init__TcCsPt|�}|dkrH||krH|||jks8||d|jkrHt|||j|��|gfSr�)r�r�r!r�)r�rRr�r�r�ryryrzr��s�zWordEnd.parseImpl)Tr�ryryrrzr2�scs�eZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Z�fdd�Z�fd
d�Z	�fdd�Z
d�fdd�	Zgfdd�Z�fdd�Z
�ZS)r"z^
    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r"t|�}t|t�r<t�|�g|_	nht|t
�rxt|�}tdd�|D��rlttj|�}t|�|_	n,zt|�|_	Wnt
k
r�|g|_	YnXd|_dS)Ncss|]}t|t�VqdSr�)r}r�)r�rSryryrzr��sz+ParseExpression.__init__.<locals>.<genexpr>F)rr"r�r}r�r�r�r&rw�exprsr�allr�r�r��r�r�r�rryrzr��s


zParseExpression.__init__cCs
|j|Sr�)r�r�ryryrzr��szParseExpression.__getitem__cCs|j�|�d|_|Sr�)r�rr{r"ryryrzr�szParseExpression.appendcCs0d|_dd�|jD�|_|jD]}|��q|S)z~Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
           all contained expressions.FcSsg|]}|���qSryr�r�r�ryryrzr��sz3ParseExpression.leaveWhitespace.<locals>.<listcomp>)r~r�r)r�r�ryryrzr�s


zParseExpression.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jD]}|�|jd�q*n,tt|��|�|jD]}|�|jd�qX|Sr�)r}r-r�rr"rr�)r�rr�rryrzr�s



zParseExpression.ignorecsNztt|���WStk
r$YnX|jdkrHd|jjt|j�f|_|jS�Nz%s:(%s))	rr"r�rpr{rmr�r�r�r�rryrzr��s
zParseExpression.__str__cs*tt|���|jD]}|��qt|j�dk�r|jd}t||j�r�|js�|jdkr�|j	s�|jdd�|jdg|_d|_
|j|jO_|j|jO_|jd}t||j��r|j�s|jdk�r|j	�s|jdd�|jdd�|_d|_
|j|jO_|j|jO_dt
|�|_|S)Nrsrr�rtr�)rr"r�r�r�r}rmryr|r�r{r�r�r�r�)r�r�rrryrzr��s<


���
���zParseExpression.streamlinecstt|��||�}|Sr�)rr"r�)r�r�r�r�rryrzr�
szParseExpression.setResultsNamecCs6|dd�|g}|jD]}|�|�q|�g�dSr�)r�rr)r�r�tmpr�ryryrzr
s
zParseExpression.validatecs$tt|���}dd�|jD�|_|S)NcSsg|]}|���qSryrr�ryryrzr�%
sz(ParseExpression.copy.<locals>.<listcomp>)rr"r�r�r1rryrzr�#
szParseExpression.copy)F)F)r�r�r�r�r�r�rrrr�r�r�rr�r1ryryrrzr"�s	
"csTeZdZdZGdd�de�Zd�fdd�	Zddd�Zd	d
�Zdd�Z	d
d�Z
�ZS)ra

    Requires all given C{ParseExpression}s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'+'} operator.
    May also be constructed using the C{'-'} operator, which will suppress backtracking.

    Example::
        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"),name_expr("name"),integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    cseZdZ�fdd�Z�ZS)zAnd._ErrorStopcs&ttj|�j||�d|_|��dS)N�-)rrr�r�r�rrGrryrzr�9
szAnd._ErrorStop.__init__r�ryryrrzr�8
sr�TcsRtt|��||�tdd�|jD��|_|�|jdj�|jdj|_d|_	dS)Ncss|]}|jVqdSr��r�r�ryryrzr�@
szAnd.__init__.<locals>.<genexpr>rT)
rrr�r�r�r�r
rr~r�r�rryrzr�>
s
zAnd.__init__c	Cs�|jdj|||dd�\}}d}|jdd�D]�}t|tj�rDd}q.|r�z|�|||�\}}Wq�tk
rt�Yq�tk
r�}zd|_t�|��W5d}~XYq�t	k
r�t|t
|�|j|��Yq�Xn|�|||�\}}|s�|��r.||7}q.||fS)NrFr�r�T)
r�r�r}rr�r%r�
__traceback__r�r�r�r�r
)	r�rRr�r��
resultlistZ	errorStopr�Z
exprtokensr�ryryrzr�E
s(
z
And.parseImplcCst|t�rt�|�}|�|�Sr��r}r�r&rwrr"ryryrzr!^
s

zAnd.__iadd__cCs6|dd�|g}|jD]}|�|�|jsq2qdSr�)r�rr��r�r��subRecCheckListr�ryryrzrc
s


zAnd.checkRecursioncCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr��{r(css|]}t|�VqdSr�r�r�ryryrzr�o
szAnd.__str__.<locals>.<genexpr>�}�r�r�r{r�r�r�ryryrzr�j
s


 zAnd.__str__)T)T)r�r�r�r�rr�r�r�r!rr�r1ryryrrzr(
s
csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the expression that matches the longest string will be used.
    May be constructed using the C{'^'} operator.

    Example::
        # construct Or using '^' operator
        
        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))
    prints::
        [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
szOr.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szOr.__init__TcCsRd}d}g}|jD]�}z|�||�}Wnvtk
rb}	zd|	_|	j|krR|	}|	j}W5d}	~	XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqX|�||f�q|�r(|j	dd�d�|D]^\}
}z|�
|||�WStk
�r$}	z d|	_|	j|k�r|	}|	j}W5d}	~	XYq�Xq�|dk	�r@|j|_|�nt||d|��dS)NrtcSs
|dSr�ry)�xryryrzr{�
r|zOr.parseImpl.<locals>.<lambda>)r� no defined alternatives to match)r�r�r!r�r�r�r�r�r�sortr�r�)r�rRr�r��	maxExcLoc�maxExceptionr�r�Zloc2r��_ryryrzr��
s<


zOr.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ixor__�
s

zOr.__ixor__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z ^ css|]}t|�VqdSr�r�r�ryryrzr��
szOr.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 z
Or.__str__cCs,|dd�|g}|jD]}|�|�qdSr��r�rr�ryryrzr�
s
zOr.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzrt
s

&	csDeZdZdZd�fdd�	Zddd�Zdd	�Zd
d�Zdd
�Z�Z	S)ra�
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the first one listed is the one that will match.
    May be constructed using the C{'|'} operator.

    Example::
        # construct MatchFirst using '|' operator
        
        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    Fcs:tt|��||�|jr0tdd�|jD��|_nd|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr��
sz&MatchFirst.__init__.<locals>.<genexpr>T)rrr�r�rBr�r�rryrzr��
szMatchFirst.__init__Tc	Cs�d}d}|jD]�}z|�|||�}|WStk
r`}z|j|krP|}|j}W5d}~XYqtk
r�t|�|kr�t|t|�|j|�}t|�}YqXq|dk	r�|j|_|�nt||d|��dS)Nrtr�)r�r�r!r�r�r�r�r�)	r�rRr�r�r�r�r�r�r�ryryrzr��
s$


zMatchFirst.parseImplcCst|t�rt�|�}|�|�Sr�r�r"ryryrz�__ior__�
s

zMatchFirst.__ior__cCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�� | css|]}t|�VqdSr�r�r�ryryrzr��
sz%MatchFirst.__str__.<locals>.<genexpr>r�r�r�ryryrzr��
s


 zMatchFirst.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzrs
zMatchFirst.checkRecursion)F)T)
r�r�r�r�r�r�r�r�rr1ryryrrzr�
s
	cs<eZdZdZd�fdd�	Zddd�Zdd�Zd	d
�Z�ZS)
ram
    Requires all given C{ParseExpression}s to be found, but in any order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'&'} operator.

    Example::
        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order 
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )
    prints::
        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    Tcs8tt|��||�tdd�|jD��|_d|_d|_dS)Ncss|]}|jVqdSr�r�r�ryryrzr�?sz Each.__init__.<locals>.<genexpr>T)rrr�r�r�r�r~�initExprGroupsr�rryrzr�=sz
Each.__init__c	s�|jr�tdd�|jD��|_dd�|jD�}dd�|jD�}|||_dd�|jD�|_dd�|jD�|_dd�|jD�|_|j|j7_d	|_|}|jdd�}|jdd��g}d
}	|	�rj|�|j|j}
g}|
D]v}z|�||�}Wn t	k
�r|�
|�Yq�X|�
|j�t|�|��||k�r@|�
|�q�|�kr܈�
|�q�t|�t|
�kr�d	}	q�|�r�d�dd�|D��}
t	||d
|
��|�fdd�|jD�7}g}|D]"}|�|||�\}}|�
|��q�t|tg��}||fS)Ncss&|]}t|t�rt|j�|fVqdSr�)r}rr!rSr�ryryrzr�Es
z!Each.parseImpl.<locals>.<genexpr>cSsg|]}t|t�r|j�qSry�r}rrSr�ryryrzr�Fs
z"Each.parseImpl.<locals>.<listcomp>cSs g|]}|jrt|t�s|�qSry)r�r}rr�ryryrzr�Gs
cSsg|]}t|t�r|j�qSry)r}r4rSr�ryryrzr�Is
cSsg|]}t|t�r|j�qSry)r}rrSr�ryryrzr�Js
cSs g|]}t|tttf�s|�qSry)r}rr4rr�ryryrzr�KsFTr%css|]}t|�VqdSr�r�r�ryryrzr�fsz*Missing one or more required elements (%s)cs$g|]}t|t�r|j�kr|�qSryr�r��ZtmpOptryrzr�js

)r�r�r�Zopt1mapZ	optionalsZmultioptionalsZ
multirequiredZrequiredr�r!rr�r!�remover�r�r��sumr$)r�rRr�r�Zopt1Zopt2ZtmpLocZtmpReqdZ
matchOrderZkeepMatchingZtmpExprsZfailedr�Zmissingr�rNZfinalResultsryr�rzr�CsP

zEach.parseImplcCs@t|d�r|jS|jdkr:dd�dd�|jD��d|_|jS)Nr�r�z & css|]}t|�VqdSr�r�r�ryryrzr�yszEach.__str__.<locals>.<genexpr>r�r�r�ryryrzr�ts


 zEach.__str__cCs,|dd�|g}|jD]}|�|�qdSr�r�r�ryryrzr}s
zEach.checkRecursion)T)T)	r�r�r�r�r�r�r�rr1ryryrrzrs
5
1	csleZdZdZd�fdd�	Zddd�Zdd	�Z�fd
d�Z�fdd
�Zdd�Z	gfdd�Z
�fdd�Z�ZS)r za
    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
    Fcs�tt|��|�t|t�r@ttjt�r2t�|�}nt�t	|��}||_
d|_|dk	r�|j|_|j
|_
|�|j�|j|_|j|_|j|_|j�|j�dSr�)rr r�r}r��
issubclassr&rwr.rrSr{r�r�r
rr~r}r�r�r�r�rSr�rryrzr��s
zParseElementEnhance.__init__TcCs2|jdk	r|jj|||dd�Std||j|��dS)NFr�r�)rSr�r!r�r�ryryrzr��s
zParseElementEnhance.parseImplcCs*d|_|j��|_|jdk	r&|j��|Sr�)r~rSr�rr�ryryrzr�s


z#ParseElementEnhance.leaveWhitespacecsrt|t�rB||jkrntt|��|�|jdk	rn|j�|jd�n,tt|��|�|jdk	rn|j�|jd�|Sr�)r}r-r�rr rrSr"rryrzr�s



zParseElementEnhance.ignorecs&tt|���|jdk	r"|j��|Sr�)rr r�rSr�rryrzr��s

zParseElementEnhance.streamlinecCsB||krt||g��|dd�|g}|jdk	r>|j�|�dSr�)r(rSr)r�r�r�ryryrzr�s

z"ParseElementEnhance.checkRecursioncCs6|dd�|g}|jdk	r(|j�|�|�g�dSr��rSrr�r�rr�ryryrzr�s
zParseElementEnhance.validatecsXztt|���WStk
r$YnX|jdkrR|jdk	rRd|jjt|j�f|_|jSr�)	rr r�rpr{rSrmr�r�r�rryrzr��szParseElementEnhance.__str__)F)T)
r�r�r�r�r�r�rrr�rrr�r1ryryrrzr �s
cs*eZdZdZ�fdd�Zddd�Z�ZS)ra�
    Lookahead matching of the given parse expression.  C{FollowedBy}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression matches at the current
    position.  C{FollowedBy} always returns a null token list.

    Example::
        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
    prints::
        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    cstt|��|�d|_dSr�)rrr�r��r�rSrryrzr��szFollowedBy.__init__TcCs|j�||�|gfSr�)rSr�r�ryryrzr��szFollowedBy.parseImpl)Tr5ryryrrzr�scs2eZdZdZ�fdd�Zd	dd�Zdd�Z�ZS)
ra�
    Lookahead to disallow matching with the given parse expression.  C{NotAny}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression does I{not} match at the current
    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
    always returns a null token list.  May be constructed using the '~' operator.

    Example::
        
    cs0tt|��|�d|_d|_dt|j�|_dS)NFTzFound unwanted token, )rrr�r~r�r�rSr�r�rryrzr��szNotAny.__init__TcCs&|j�||�rt|||j|��|gfSr�)rSr�r!r�r�ryryrzr��szNotAny.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�z~{r��r�r�r{r�rSr�ryryrzr�s


zNotAny.__str__)Trfryryrrzr�s

cs(eZdZd�fdd�	Zddd�Z�ZS)	�_MultipleMatchNcsFtt|��|�d|_|}t|t�r.t�|�}|dk	r<|nd|_dSr�)	rr�r�r}r}r�r&rw�	not_ender)r�rS�stopOnZenderrryrzr�s

z_MultipleMatch.__init__Tc	Cs�|jj}|j}|jdk	}|r$|jj}|r2|||�||||dd�\}}zV|j}	|r`|||�|	rp|||�}
n|}
|||
|�\}}|s�|��rR||7}qRWnttfk
r�YnX||fS�NFr�)	rSr�r�r�r�r�r
r!r�)r�rRr�r�Zself_expr_parseZself_skip_ignorablesZcheck_enderZ
try_not_enderr�ZhasIgnoreExprsr�Z	tmptokensryryrzr�s*



z_MultipleMatch.parseImpl)N)T)r�r�r�r�r�r1ryryrrzr�
sr�c@seZdZdZdd�ZdS)ra�
    Repetition of one or more of the given expression.
    
    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
        
        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    cCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r�z}...r�r�ryryrzr�Js


zOneOrMore.__str__N)r�r�r�r�r�ryryryrzr0scs8eZdZdZd
�fdd�	Zd�fdd�	Zdd	�Z�ZS)r4aw
    Optional repetition of zero or more of the given expression.
    
    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example: similar to L{OneOrMore}
    Ncstt|�j||d�d|_dS)N)r�T)rr4r�r�)r�rSr�rryrzr�_szZeroOrMore.__init__Tc	s<ztt|��|||�WSttfk
r6|gfYSXdSr�)rr4r�r!r�r�rryrzr�cszZeroOrMore.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$�]...r�r�ryryrzr�is


zZeroOrMore.__str__)N)Trfryryrrzr4Ssc@s eZdZdd�ZeZdd�ZdS)�
_NullTokencCsdSr�ryr�ryryrzr�ssz_NullToken.__bool__cCsdSr�ryr�ryryrzr�vsz_NullToken.__str__N)r�r�r�r�rLr�ryryryrzr�rsr�cs6eZdZdZef�fdd�	Zd	dd�Zdd�Z�ZS)
raa
    Optional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::
        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345
            
            # ZIP+4 form
            12101-0001
            
            # invalid ZIP
            98765-
            ''')
    prints::
        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    cs.tt|�j|dd�|jj|_||_d|_dS)NFr3T)rrr�rSr}rr�)r�rSrrryrzr��s
zOptional.__init__Tc	Cszz|jj|||dd�\}}WnTttfk
rp|jtk	rh|jjr^t|jg�}|j||jj<ql|jg}ng}YnX||fSr�)rSr�r!r�r�_optionalNotMatchedr|r$)r�rRr�r�r�ryryrzr��s


zOptional.parseImplcCs4t|d�r|jS|jdkr.dt|j�d|_|jS)Nr�r$r'r�r�ryryrzr��s


zOptional.__str__)T)	r�r�r�r�r�r�r�r�r1ryryrrzrzs"
cs,eZdZdZd	�fdd�	Zd
dd�Z�ZS)r*a�	
    Token for skipping over all undefined text until the matched expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default=C{False}) if True, the target expression is also parsed 
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
          comments) that might contain false matches to the target expression
     - failOn - (default=C{None}) define expressions that are not allowed to be 
          included in the skipped test; if found before the target expression is found, 
          the SkipTo is not a match

    Example::
        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP 
                      + string_data("sev") + SEP 
                      + string_data("desc") + SEP 
                      + integer("days_open"))
        
        for tkt in ticket_expr.searchString(report):
            print tkt.dump()
    prints::
        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    FNcs`tt|��|�||_d|_d|_||_d|_t|t	�rFt
�|�|_n||_dt
|j�|_dS)NTFzNo match found for )rr*r��
ignoreExprr�r��includeMatchr�r}r�r&rw�failOnr�rSr�)r�rZincluderr�rryrzr��s
zSkipTo.__init__Tc	Cs&|}t|�}|j}|jj}|jdk	r,|jjnd}|jdk	rB|jjnd}	|}
|
|kr�|dk	rf|||
�rfq�|	dk	r�z|	||
�}
Wqntk
r�Yq�YqnXqnz|||
ddd�Wq�tt	fk
r�|
d7}
YqJXq�qJt|||j
|��|
}|||�}t|�}|j�r||||dd�\}}
||
7}||fS)NF)r�r�r�r�)
r�rSr�r�r�r�r�rr!r�r�r$r�)r�rRr�r�rUr�rSZ
expr_parseZself_failOn_canParseNextZself_ignoreExpr_tryParseZtmplocZskiptextZ
skipresultrMryryrzr��s:
zSkipTo.parseImpl)FNN)Tr5ryryrrzr*�s6
csbeZdZdZd�fdd�	Zdd�Zdd�Zd	d
�Zdd�Zgfd
d�Z	dd�Z
�fdd�Z�ZS)raK
    Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.

    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
    Specifically, '|' has a lower precedence than '<<', so that::
        fwdExpr << a | b | c
    will actually be evaluated as::
        (fwdExpr << a) | b | c
    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the C{Forward}::
        fwdExpr << (a | b | c)
    Converting to use the '<<=' operator instead will avoid this problem.

    See L{ParseResults.pprint} for an example of a recursive parser created using
    C{Forward}.
    Ncstt|�j|dd�dSr2)rrr�r"rryrzr�@szForward.__init__cCsjt|t�rt�|�}||_d|_|jj|_|jj|_|�|jj	�|jj
|_
|jj|_|j�
|jj�|Sr�)r}r�r&rwrSr{r�r�r
rr~r}r�rr"ryryrz�
__lshift__Cs





zForward.__lshift__cCs||>Sr�ryr"ryryrz�__ilshift__PszForward.__ilshift__cCs
d|_|Sr�rr�ryryrzrSszForward.leaveWhitespacecCs$|js d|_|jdk	r |j��|Sr�)r�rSr�r�ryryrzr�Ws


zForward.streamlinecCs>||kr0|dd�|g}|jdk	r0|j�|�|�g�dSr�r�r�ryryrzr^s

zForward.validatecCsVt|d�r|jS|jjdSz|jdk	r4t|j�}nd}W5|j|_X|jjd|S)Nr�z: ...�Nonez: )r�r�rmr�Z_revertClass�_ForwardNoRecurserSr�)r�Z	retStringryryrzr�es


zForward.__str__cs.|jdk	rtt|���St�}||K}|SdSr�)rSrrr�r1rryrzr�vs

zForward.copy)N)
r�r�r�r�r�r�r�rr�rr�r�r1ryryrrzr-s
c@seZdZdd�ZdS)r�cCsdS)Nrcryr�ryryrzr�sz_ForwardNoRecurse.__str__N)r�r�r�r�ryryryrzr�~sr�cs"eZdZdZd�fdd�	Z�ZS)r/zQ
    Abstract subclass of C{ParseExpression}, for converting parsed results.
    Fcstt|��|�d|_dSr�)rr/r�r}r�rryrzr��szTokenConverter.__init__)Fr4ryryrrzr/�scs6eZdZdZd
�fdd�	Z�fdd�Zdd	�Z�ZS)ra�
    Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the input string;
    this can be disabled by specifying C{'adjacent=False'} in the constructor.

    Example::
        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    r�Tcs8tt|��|�|r|��||_d|_||_d|_dSr�)rrr�r�adjacentr~�
joinStringr�)r�rSr�r�rryrzr��szCombine.__init__cs(|jrt�||�ntt|��|�|Sr�)r�r&rrrr"rryrzr�szCombine.ignorecCsP|��}|dd�=|td�|�|j��g|jd�7}|jrH|��rH|gS|SdS)Nr�)r�)r�r$r�r(r�r�r|r
)r�rRr�r�ZretToksryryrzr��s
"zCombine.postParse)r�T)r�r�r�r�r�rr�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)ra�
    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.

    Example::
        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
    cstt|��|�d|_dSr�)rrr�r}r�rryrzr��szGroup.__init__cCs|gSr�ryr�ryryrzr��szGroup.postParse�r�r�r�r�r�r�r1ryryrrzr�s
cs(eZdZdZ�fdd�Zdd�Z�ZS)r
aW
    Converter to return a repetitive expression as a list, but also as a dictionary.
    Each element can also be referenced using the first token in the expression as its key.
    Useful for tabular report scraping when the first column can be used as a item key.

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())
        
        # access named fields as dict entries, or output as dict
        print(result['shape'])        
        print(result.asDict())
    prints::
        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
    See more examples at L{ParseResults} of accessing fields by results name.
    cstt|��|�d|_dSr�)rr
r�r}r�rryrzr��sz
Dict.__init__cCs�t|�D]�\}}t|�dkrq|d}t|t�r@t|d���}t|�dkr\td|�||<qt|�dkr�t|dt�s�t|d|�||<q|��}|d=t|�dks�t|t�r�|�	�r�t||�||<qt|d|�||<q|j
r�|gS|SdS)Nrr�r�rs)r�r�r}rvr�r�r�r$r�r
r|)r�rRr�r�r��tokZikeyZ	dictvalueryryrzr��s$
zDict.postParser�ryryrrzr
�s#c@s eZdZdZdd�Zdd�ZdS)r-aV
    Converter for ignoring the results of a parsed expression.

    Example::
        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))
    prints::
        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']
    (See also L{delimitedList}.)
    cCsgSr�ryr�ryryrzr�szSuppress.postParsecCs|Sr�ryr�ryryrzr
"szSuppress.suppressN)r�r�r�r�r�r
ryryryrzr-sc@s(eZdZdZdd�Zdd�Zdd�ZdS)	rzI
    Wrapper for parse actions, to ensure they are only called once.
    cCst|�|_d|_dSr�)rr�callable�called)r�Z
methodCallryryrzr�*s
zOnlyOnce.__init__cCs.|js|�|||�}d|_|St||d��dS)NTr�)r�r�r!)r�r�r[rxrNryryrzr	-s
zOnlyOnce.__call__cCs
d|_dSr�)r�r�ryryrz�reset3szOnlyOnce.resetN)r�r�r�r�r�r	r�ryryryrzr&scs:t����fdd�}z�j|_Wntk
r4YnX|S)at
    Decorator for debugging parse actions. 
    
    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.

    Example::
        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
    prints::
        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    c
s��j}|dd�\}}}t|�dkr8|djjd|}tj�d|t||�||f�z�|�}Wn8tk
r�}ztj�d||f��W5d}~XYnXtj�d||f�|S)Nr^rqr�.z">>entering %s(line: '%s', %d, %r)
z<<leaving %s (exception: %s)
z<<leaving %s (ret: %r)
)r�r�rmr��stderr�writerIrp)ZpaArgsZthisFuncr�r[rxr�rX�rryrz�zLsztraceParseAction.<locals>.z)rrr�r�)rr�ryr�rzrd6s
�,FcCs`t|�dt|�dt|�d}|rBt|t||���|�S|tt|�|��|�SdS)a�
    Helper to define a delimited list of expressions - the delimiter defaults to ','.
    By default, the list elements and delimiters can have intervening whitespace, and
    comments, but this can be overridden by passing C{combine=True} in the constructor.
    If C{combine} is set to C{True}, the matching tokens are returned as a single token
    string, with the delimiters included; otherwise, the matching tokens are returned
    as a list of tokens, with the delimiters suppressed.

    Example::
        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    z [r(r�N)r�rr4r�r-)rSZdelim�combineZdlNameryryrzrBbs
$csjt����fdd�}|dkr0tt��dd��}n|��}|�d�|j|dd�|��d	t��d
�S)a:
    Helper to define a counted list of expressions.
    This helper defines a pattern of the form::
        integer expr expr expr...
    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
    
    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.

    Example::
        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    cs.|d}�|r tt�g|��p&tt�>gSr�)rrrE)r�r[rxr��Z	arrayExprrSryrz�countFieldParseAction�s"z+countedArray.<locals>.countFieldParseActionNcSst|d�Sr�)rvrwryryrzr{�r|zcountedArray.<locals>.<lambda>ZarrayLenT�r�z(len) rc)rr1rTr�r�r�r�r�)rSZintExprr�ryr�rzr>us
cCs6g}|D](}t|t�r&|�t|��q|�|�q|Sr�)r}r�rr�r)�Lr�r�ryryrzr��s
r�cs6t���fdd�}|j|dd���dt|���S)a*
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
    If this is not desired, use C{matchPreviousExpr}.
    Do I{not} use with packrat parsing enabled.
    csP|rBt|�dkr�|d>qLt|���}�tdd�|D��>n
�t�>dS)Nr�rcss|]}t|�VqdSr�)r�r�Zttryryrzr��szDmatchPreviousLiteral.<locals>.copyTokenToRepeater.<locals>.<genexpr>)r�r�r�rr)r�r[rxZtflat�Zrepryrz�copyTokenToRepeater�sz1matchPreviousLiteral.<locals>.copyTokenToRepeaterTr��(prev) )rr�r�r�)rSr�ryr�rzrQ�s


csFt��|��}�|K��fdd�}|j|dd���dt|���S)aS
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
    the expressions are evaluated first, and then compared, so
    C{"1"} is compared with C{"10"}.
    Do I{not} use with packrat parsing enabled.
    cs*t|�����fdd�}�j|dd�dS)Ncs$t|���}|�kr tddd��dS)Nr�r)r�r�r!)r�r[rxZtheseTokens�ZmatchTokensryrz�mustMatchTheseTokens�szLmatchPreviousExpr.<locals>.copyTokenToRepeater.<locals>.mustMatchTheseTokensTr�)r�r�r�)r�r[rxr�r�r�rzr��sz.matchPreviousExpr.<locals>.copyTokenToRepeaterTr�r�)rr�r�r�r�)rSZe2r�ryr�rzrP�scCs:dD]}|�|t|�}q|�dd�}|�dd�}t|�S)Nz\^-]r2r'r~r�)r��_bslashr�)r�r�ryryrzrY�s
rYTc
s�|rdd�}dd�}t�ndd�}dd�}t�g}t|t�rF|��}n$t|t�rZt|�}ntjdt	dd�|stt
�Sd	}|t|�d
k�r||}t||d
d��D]R\}}	||	|�r�|||d
=qxq�|||	�r�|||d
=|�
||	�|	}qxq�|d
7}qx|�s�|�r�zlt|�td�|��k�rTtd
d�dd�|D����d�|��WStd�dd�|D����d�|��WSWn&tk
�r�tjdt	dd�YnXt�fdd�|D���d�|��S)a�
    Helper to quickly define a set of alternative Literals, and makes sure to do
    longest-first testing when there is a conflict, regardless of the input order,
    but returns a C{L{MatchFirst}} for best performance.

    Parameters:
     - strs - a string of space-delimited literals, or a collection of string literals
     - caseless - (default=C{False}) - treat all literals as caseless
     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
          if creating a C{Regex} raises an exception)

    Example::
        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
    prints::
        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    cSs|��|��kSr�)r@�r�bryryrzr{�r|zoneOf.<locals>.<lambda>cSs|���|���Sr�)r@r<r�ryryrzr{�r|cSs||kSr�ryr�ryryrzr{�r|cSs
|�|�Sr�)r<r�ryryrzr{�r|z6Invalid argument to oneOf, expected string or iterablersr�rr�Nr�z[%s]css|]}t|�VqdSr�)rY�r�Zsymryryrzr�szoneOf.<locals>.<genexpr>r��|css|]}t�|�VqdSr�)r�r[r�ryryrzr�sz7Exception creating Regex for oneOf, building MatchFirstc3s|]}�|�VqdSr�ryr��ZparseElementClassryrzr�$s)r
rr}r�r�rr�r�r�r�rr�r�rr�r)r�rpr)
Zstrsr?ZuseRegexZisequalZmasksZsymbolsr�Zcurr�rryr�rzrU�sT



�


**�cCsttt||���S)a�
    Helper to easily and clearly define a dictionary by specifying the respective patterns
    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
    in the proper order.  The key pattern can include delimiting markers or punctuation,
    as long as they are suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the C{Dict} results can include named token
    fields.

    Example::
        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())
    prints::
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    )r
r4r)rr�ryryrzrC&s!cCs^t��dd��}|��}d|_|d�||d�}|r@dd�}ndd�}|�|�|j|_|S)	a�
    Helper to return the original, untokenized text for a given expression.  Useful to
    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
    revert separate tokens with intervening whitespace back to the original matching
    input text. By default, returns astring containing the original parsed text.  
       
    If the optional C{asString} argument is passed as C{False}, then the return value is a 
    C{L{ParseResults}} containing any results names that were originally matched, and a 
    single token containing the original matched text from the input string.  So if 
    the expression passed to C{L{originalTextFor}} contains expressions with defined
    results names, you must set C{asString} to C{False} if you want to preserve those
    results name values.

    Example::
        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b","i"):
            opener,closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])
    prints::
        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    cSs|Sr�ry)r�r�rxryryrzr{ar|z!originalTextFor.<locals>.<lambda>F�_original_start�
_original_endcSs||j|j�Sr�)r�r�rZryryrzr{fr|cSs&||�d�|�d��g|dd�<dS)Nr�r�)rrZryryrz�extractTexthsz$originalTextFor.<locals>.extractText)rr�r�r�r�)rSZasStringZ	locMarkerZendlocMarker�	matchExprr�ryryrzriIs

cCst|��dd��S)zp
    Helper to undo pyparsing's default grouping of And expressions, even
    if all but one are non-empty.
    cSs|dSr�ryrwryryrzr{sr|zungroup.<locals>.<lambda>)r/r�)rSryryrzrjnscCs4t��dd��}t|d�|d�|����d��S)a�
    Helper to decorate a returned token with its starting and ending locations in the input string.
    This helper adds the following results names:
     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains C{<TAB>} characters, you may want to call
    C{L{ParserElement.parseWithTabs}}

    Example::
        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)
    prints::
        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    cSs|Sr�ryrZryryrzr{�r|zlocatedExpr.<locals>.<lambda>Z
locn_startr�Zlocn_end)rr�rr�r)rSZlocatorryryrzrlusz\[]-*.$+^?()~ �r_cCs|ddSr�ryrZryryrzr{�r|r{z\\0?[xX][0-9a-fA-F]+cCstt|d�d�d��S)Nrz\0x�)�unichrrv�lstriprZryryrzr{�r|z	\\0[0-7]+cCstt|ddd�d��S)Nrr��)r�rvrZryryrzr{�r|z\]r�r$r)�negate�bodyr'csFdd��z"d��fdd�t�|�jD��WStk
r@YdSXdS)a�
    Helper to easily define string ranges for use in Word construction.  Borrows
    syntax from regexp '[]' string range definitions::
        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
    The input string must be enclosed in []'s, and the returned string is the expanded
    character set joined into a single string.
    The values enclosed in the []'s may be:
     - a single character
     - an escaped character with a leading backslash (such as C{\-} or C{\]})
     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
         (C{\0x##} is also supported for backwards compatibility) 
     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
    cSs<t|t�s|Sd�dd�tt|d�t|d�d�D��S)Nr�css|]}t|�VqdSr�)r�r�ryryrzr��sz+srange.<locals>.<lambda>.<locals>.<genexpr>rr�)r}r$r�r��ord)�pryryrzr{�r|zsrange.<locals>.<lambda>r�c3s|]}�|�VqdSr�ry)r��part�Z	_expandedryrzr��szsrange.<locals>.<genexpr>N)r��_reBracketExprr�r�rprdryr�rzra�s
"cs�fdd�}|S)zt
    Helper method for defining parse actions that require matching at a specific
    column in the input text.
    cs"t||��krt||d���dS)Nzmatched token not at column %dr�)rNZlocnrVr�ryrz�	verifyCol�sz!matchOnlyAtCol.<locals>.verifyColry)r�r�ryr�rzrO�scs�fdd�S)a�
    Helper method for common parse actions that simply return a literal value.  Especially
    useful when used with C{L{transformString<ParserElement.transformString>}()}.

    Example::
        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num
        
        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    cs�gSr�ryrZ�ZreplStrryrzr{�r|zreplaceWith.<locals>.<lambda>ryr�ryr�rzr^�scCs|ddd�S)a
    Helper parse action for removing quotation marks from parsed quoted strings.

    Example::
        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    rr�rtryrZryryrzr\�scsN��fdd�}zt�dt�d�j�}Wntk
rBt��}YnX||_|S)aG
    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
    args are passed, they are forwarded to the given function as additional arguments after
    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
    parsed data to an integer using base 16.

    Example (compare the last to example in L{ParserElement.transformString}::
        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')
        
        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')
    prints::
        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    cs��fdd�|D�S)Ncsg|]}�|f����qSryry)r�Ztokn�r�r\ryrzr��sz(tokenMap.<locals>.pa.<locals>.<listcomp>ryrZr�ryrzr��sztokenMap.<locals>.par�rm)ror�rpr~)r\r�r�rqryr�rzro�s 
�cCst|���Sr��r�r@rwryryrzr{r|cCst|���Sr��r��lowerrwryryrzr{r|c	Cs�t|t�r|}t||d�}n|j}tttd�}|r�t���	t
�}td�|d�tt
t|td�|���tddgd��d	��	d
d��td�}n�d
�dd�tD��}t���	t
�t|�B}td�|d�tt
t|�	t�ttd�|����tddgd��d	��	dd��td�}ttd�|d�}|�dd
�|�dd��������d|�}|�dd
�|�dd��������d|�}||_||_||fS)zRInternal helper to construct opening and closing tag expressions, given a tag namerEz_-:r5�tag�=�/F�rrEcSs|ddkS�Nrr�ryrZryryrzr{r|z_makeTags.<locals>.<lambda>r6r�css|]}|dkr|VqdS)r6Nryr�ryryrzr�sz_makeTags.<locals>.<genexpr>cSs|ddkSr�ryrZryryrzr{r|r7rJ�:r(z<%s>r`z</%s>)r}r�rr�r1r6r5r@r�r�r\r-r
r4rrr�r�rXr[rDr�_Lr��titler�r�r�)�tagStrZxmlZresnameZtagAttrNameZtagAttrValueZopenTagZprintablesLessRAbrackZcloseTagryryrz�	_makeTagss>
�������..rcCs
t|d�S)a 
    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.

    Example::
        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
        a,a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end
        
        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
            print(link.link_text, '->', link.href)
    prints::
        pyparsing -> http://pyparsing.wikispaces.com
    F�r�r�ryryrzrM(scCs
t|d�S)z�
    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
    tags only in the given upper/lower case.

    Example: similar to L{makeHTMLTags}
    TrrryryrzrN;scs8|r|dd��n|���dd��D���fdd�}|S)a<
    Helper to create a validating parse action to be used with start tags created
    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
    with a required attribute value, to avoid false matches on common tags such as
    C{<TD>} or C{<DIV>}.

    Call C{withAttribute} with a series of attribute names and values. Specify the list
    of filter attributes names and values as:
     - keyword arguments, as in C{(align="right")}, or
     - as an explicit dict with C{**} operator, when an attribute name is also a Python
          reserved word, as in C{**{"class":"Customer", "align":"right"}}
     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
    For attribute names with a namespace prefix, you must use the second form.  Attribute
    names are matched insensitive to upper/lower case.
       
    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.

    To verify that the attribute exists, but without specifying a value, pass
    C{withAttribute.ANY_VALUE} as the value.

    Example::
        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    NcSsg|]\}}||f�qSryryr/ryryrzr�zsz!withAttribute.<locals>.<listcomp>csZ�D]P\}}||kr$t||d|��|tjkr|||krt||d||||f��qdS)Nzno matching attribute z+attribute '%s' has value '%s', must be '%s')r!rg�	ANY_VALUE)r�r[r�ZattrNameZ	attrValue�Zattrsryrzr�{s�zwithAttribute.<locals>.pa)r�)r�ZattrDictr�ryrrzrgDs2cCs|rd|nd}tf||i�S)a�
    Simplified version of C{L{withAttribute}} when matching on a div class - made
    difficult because C{class} is a reserved word in Python.

    Example::
        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))
        
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    z%s:class�class)rg)Z	classname�	namespaceZ	classattrryryrzrm�s �(rpcCs�t�}||||B}t|�D�]l\}}|ddd�\}}	}
}|	dkrPd|nd|}|	dkr�|dkstt|�dkr|td��|\}
}t��|�}|
tjk�r^|	d	kr�t||�t|t	|��}n�|	dk�r|dk	r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�rTt||
|||�t||
|||�}ntd
��n�|
tj
k�rB|	d	k�r�t|t��s�t|�}t|j
|�t||�}n�|	dk�r�|dk	�r�t|||�t|t	||��}nt||�t|t	|��}nD|	dk�r8t||
|||�t||
|||�}ntd
��ntd��|�rvt|ttf��rl|j|�n
|�|�||�|�|BK}|}q||K}|S)aD

    Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary or
    binary, left- or right-associative.  Parse actions can also be attached
    to operator expressions. The generated parser will also recognize the use 
    of parentheses to override operator precedences (see example below).
    
    Note: if you define a deep operator list, you may see performance issues
    when using infixNotation. See L{ParserElement.enablePackrat} for a
    mechanism to potentially improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the nested
     - opList - list of tuples, one for each operator precedence level in the
      expression grammar; each tuple is of the form
      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
       - opExpr is the pyparsing expression for the operator;
          may also be a string, which will be converted to a Literal;
          if numTerms is 3, opExpr is a tuple of two expressions, for the
          two operators separating the 3 terms
       - numTerms is the number of terms for this operator (must
          be 1, 2, or 3)
       - rightLeftAssoc is the indicator whether the operator is
          right or left associative, using the pyparsing-defined
          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
       - parseAction is the parse action to be associated with
          expressions matching this operator expression (the
          parse action tuple member may be omitted); if the parse action
          is passed a tuple or list of functions, this is equivalent to
          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})

    Example::
        # simple example of four-function arithmetic with ints and variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier 
        
        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])
        
        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)
    prints::
        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    r�Nrbrqz%s termz	%s%s termrsz@if numterms=3, opExpr must be a tuple or list of two expressionsr�z6operator must be unary (1), binary (2), or ternary (3)z2operator must indicate right or left associativity)rr�r�r�r�rV�LEFTrrr�RIGHTr}rrSr�r�r�)ZbaseExprZopListZlparZrparr�ZlastExprr�ZoperDefZopExprZarityZrightLeftAssocr�ZtermNameZopExpr1ZopExpr2ZthisExprr�ryryrzrk�sZ=
&
�



&
�

z4"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�"z string enclosed in double quotesz4'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*�'z string enclosed in single quotesz*quotedString using single or double quotes�uzunicode string literalcCs�||krtd��|dk�r*t|t��r"t|t��r"t|�dkr�t|�dkr�|dk	r�tt|t||tjdd����	dd��}n$t
��t||tj��	dd��}nx|dk	r�tt|t|�t|�ttjdd����	dd��}n4ttt|�t|�ttjdd����	d	d��}ntd
��t
�}|dk	�rd|tt|�t||B|B�t|��K}n$|tt|�t||B�t|��K}|�d||f�|S)a~	
    Helper method for defining nested lists enclosed in opening and closing
    delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
     - content - expression for items within the nested lists (default=C{None})
     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})

    If an expression is not provided for the content argument, the nested
    expression will capture all whitespace-delimited content between delimiters
    as a list of separate values.

    Use the C{ignoreExpr} argument to define expressions that may contain
    opening or closing characters that should not be treated as opening
    or closing characters for nesting, such as quotedString or a comment
    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
    The default is L{quotedString}, but if no expressions are to be ignored,
    then pass C{None} for this argument.

    Example::
        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR,RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type") 
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
                      + code_body("body"))
        c_function.ignore(cStyleComment)
        
        source_code = '''
            int is_odd(int x) { 
                return (x%2); 
            }
                
            int dec_to_hex(char hchar) { 
                if (hchar >= '0' && hchar <= '9') { 
                    return (ord(hchar)-ord('0')); 
                } else { 
                    return (10+ord(hchar)-ord('A'));
                } 
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)

    prints::
        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    z.opening and closing strings cannot be the sameNr�r�cSs|d��Sr��r�rwryryrzr{gr|znestedExpr.<locals>.<lambda>cSs|d��Sr�r
rwryryrzr{jr|cSs|d��Sr�r
rwryryrzr{pr|cSs|d��Sr�r
rwryryrzr{tr|zOopening and closing arguments must be strings if no content expression is givenznested %s%s expression)r�r}r�r�rrrr&rsr�rEr�rrrr-r4r�)ZopenerZcloserZcontentr�r�ryryrzrR%sH:
���������
*$cs��fdd�}�fdd�}�fdd�}tt��d����}t�t��|��d�}t��|��d	�}t��|��d
�}	|r�tt|�|t|t|�t|��|	�}
n$tt|�t|t|�t|���}
|�	t
t��|
�d�S)a
	
    Helper method for defining space-delimited indentation blocks, such as
    those used to define block statements in Python source code.

    Parameters:
     - blockStatementExpr - expression defining syntax of statement that
            is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
            (multiple statementWithIndentedBlock expressions within a single grammar
            should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond the
            the current level; set to False for block of left-most statements
            (default=C{True})

    A valid block must contain at least one C{blockStatement}.

    Example::
        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group( funcDecl + func_body )

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << ( funcDef | assignment | identifier )

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()
    prints::
        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
    csN|t|�krdSt||�}|�dkrJ|�dkr>t||d��t||d��dS)Nrtzillegal nestingznot a peer entry)r�r;r#r!�r�r[rxZcurCol��indentStackryrz�checkPeerIndent�s
z&indentedBlock.<locals>.checkPeerIndentcs2t||�}|�dkr"��|�nt||d��dS)Nrtznot a subentry)r;rr!rrryrz�checkSubIndent�s
z%indentedBlock.<locals>.checkSubIndentcsN|t|�krdSt||�}�r6|�dkr6|�dksBt||d�����dS)Nrtr_znot an unindent)r�r;r!rrrryrz�
checkUnindent�s
z$indentedBlock.<locals>.checkUnindentz	 �INDENTr�ZUNINDENTzindented block)rrr
r
rr�r�rrrr�)ZblockStatementExprrr9rrrrErZPEERZUNDENTZsmExprryrrzrhs(N����z#[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]z[\0xa1-\0xbf\0xd7\0xf7]z_:zany tagzgt lt amp nbsp quot aposz><& "'z&(?P<entity>r�z);zcommon HTML entitycCst�|j�S)zRHelper parser action to replace common HTML entities with their special characters)�_htmlEntityMapr�Zentityrwryryrzr]�sz/\*(?:[^*]|\*(?!/))*z*/zC style commentz<!--[\s\S]*?-->zHTML commentz.*zrest of linez//(?:\\\n|[^\n])*z
// commentzC++ style commentz#.*zPython style commentrO� 	�	commaItemr�c@s�eZdZdZee�Zee�Ze	e
��d��e�Z
e	e��d��eed��Zed��d��e�Ze��e�de��e��d�Ze�d	d
��eeeed���e�B�d�Ze�e�ed
��d��e�Zed��d��e�ZeeBeB��Zed��d��e�Ze	eded��d�Zed��d�Z ed��d�Z!e!de!d�d�Z"ee!de!d�dee!de!d��d�Z#e#�$dd
��d e �d!�Z%e&e"e%Be#B�d"���d"�Z'ed#��d$�Z(e)d=d&d'��Z*e)d>d)d*��Z+ed+��d,�Z,ed-��d.�Z-ed/��d0�Z.e/��e0��BZ1e)d1d2��Z2e&e3e4d3�e5�e	e6d3d4�ee7d5�������d6�Z8e9ee:�;�e8Bd7d8���d9�Z<e)ed:d
���Z=e)ed;d
���Z>d<S)?rpa�

    Here are some common low-level expressions that may be useful in jump-starting parser development:
     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
     - common L{programming identifiers<identifier>}
     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
     - L{UUID<uuid>}
     - L{comma-separated list<comma_separated_list>}
    Parse actions:
     - C{L{convertToInteger}}
     - C{L{convertToFloat}}
     - C{L{convertToDate}}
     - C{L{convertToDatetime}}
     - C{L{stripHTMLTags}}
     - C{L{upcaseTokens}}
     - C{L{downcaseTokens}}

    Example::
        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')
    prints::
        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    �integerzhex integerr�z[+-]?\d+zsigned integerr��fractioncCs|d|dS)Nrrtryrwryryrzr{�r|zpyparsing_common.<lambda>r�z"fraction or mixed integer-fractionz
[+-]?\d+\.\d*zreal numberz+[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)z$real number with scientific notationz[+-]?\d+\.?\d*([eE][+-]?\d+)?�fnumberr��
identifierzK(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}zIPv4 addressz[0-9a-fA-F]{1,4}�hex_integerr��zfull IPv6 address)rrhz::zshort IPv6 addresscCstdd�|D��dkS)Ncss|]}tj�|�rdVqdSr3)rp�
_ipv6_partr�r�ryryrzr��sz,pyparsing_common.<lambda>.<locals>.<genexpr>r�)r�rwryryrzr{�r|z::ffff:zmixed IPv6 addresszIPv6 addressz:[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}zMAC address�%Y-%m-%dcs�fdd�}|S)a�
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})

        Example::
            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))
        prints::
            [datetime.date(1999, 12, 31)]
        c
sNzt�|d����WStk
rH}zt||t|���W5d}~XYnXdSr�)r�strptime�dater�r!r~�r�r[rxZve��fmtryrz�cvt_fn�sz.pyparsing_common.convertToDate.<locals>.cvt_fnry�r$r%ryr#rz�
convertToDate�szpyparsing_common.convertToDate�%Y-%m-%dT%H:%M:%S.%fcs�fdd�}|S)a
        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})

        Example::
            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
        prints::
            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        c
sJzt�|d��WStk
rD}zt||t|���W5d}~XYnXdSr�)rr r�r!r~r"r#ryrzr%�sz2pyparsing_common.convertToDatetime.<locals>.cvt_fnryr&ryr#rz�convertToDatetime�sz"pyparsing_common.convertToDatetimez7(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?zISO8601 datez�(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?zISO8601 datetimez2[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}�UUIDcCstj�|d�S)a
        Parse action to remove HTML tags from web page HTML source

        Example::
            # strip HTML links from normal text 
            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
            td,td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            
            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
        r)rp�_html_stripperr�)r�r[r�ryryrz�
stripHTMLTagss
zpyparsing_common.stripHTMLTagsr�rOrrr�r�zcomma separated listcCst|���Sr�r�rwryryrzr{"r|cCst|���Sr�r�rwryryrzr{%r|N)r)r()?r�r�r�r�rorvZconvertToInteger�floatZconvertToFloatr1rTr�r�rrFrr)Zsigned_integerrr�rr
Z
mixed_integerr��realZsci_realr��numberrr6r5rZipv4_addressrZ_full_ipv6_addressZ_short_ipv6_addressr�Z_mixed_ipv6_addressrZipv6_addressZmac_addressr/r'r)Ziso8601_dateZiso8601_datetime�uuidr9r8r+r,rrrrXr0�
_commasepitemrBr[r�Zcomma_separated_listrfrDryryryrzrpsV""
2
 
���__main__Zselect�fromr=r�)r��columnsr�ZtablesZcommandaK
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        z]
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        z 
        100
        FF
        z6
        12345678-1234-5678-1234-567812345678
        )rs)r�F)N)FT)T)r�)T)�r��__version__Z__versionTime__�
__author__r��weakrefrr�r�r�r�r�rjr�rFrcr�r�_threadr�ImportErrorZ	threadingZcollections.abcrrrr�Zordereddict�__all__r��version_inforbr0�maxsizer0r~r��chrr�r�r�r�r@�reversedr�r�rBr�r]r^rnZmaxintZxranger�Z__builtin__r�Zfnamerror�r�r�r�r�r�Zascii_uppercaseZascii_lowercaser6rTrFr5r�r�Z	printablerXrprr!r#r%r(r�r$�registerr;rLrIrTrWrYrSrrr&r.rrrr�rwrr
r	rnr1r)r'rr0r�rrrr,r+r3r2r"rrrrr rrr�rr4r�r�rr*rr�r/rrr
r-rrdrBr>r�rQrPrYrUrCrirjrlr�rErKrJrcrbr�Z_escapedPuncZ_escapedHexCharZ_escapedOctCharZ_singleCharZ
_charRanger�r�rarOr^r\rorfrDrrMrNrgrrmrVrr	rkrWr@r`r[rerRrhr7rYr9r8r�r�rrr=r]r:rGrr_rAr?rHrZr�r1r<rpr�ZselectTokenZ	fromTokenZidentZ
columnNameZcolumnNameListZ
columnSpecZ	tableNameZ
tableNameListZ	simpleSQLr.r/rrr0r*ryryryrz�<module>s��4�
8



@v&A= I
G3pLOD|M &#@sQ,A,	I#%0
,	?#p
��Zr

 (
 
���� 


"
	site-packages/setuptools/_vendor/__pycache__/ordered_set.cpython-38.opt-1.pyc000064400000040034151446177000023245 0ustar00U

�Qab;�@s|dZddlZddlmZzddlmZmZWn$ek
rPddlmZmZYnXe	d�Z
dZdd�ZGdd	�d	ee�Z
dS)
z�
An OrderedSet is a custom MutableSet that remembers its order, so that every
entry has an index that can be looked up.

Based on a recipe originally posted to ActiveState Recipes by Raymond Hettiger,
and released under the MIT license.
�N)�deque)�
MutableSet�Sequencez3.1cCs"t|d�o t|t�o t|t�S)a

    Are we being asked to look up a list of things, instead of a single thing?
    We check for the `__iter__` attribute so that this can cover types that
    don't have to be known by this module, such as NumPy arrays.

    Strings, however, should be considered as atomic values to look up, not
    iterables. The same goes for tuples, since they are immutable and therefore
    valid entries.

    We don't need to check for the Python 2 `unicode` type, because it doesn't
    have an `__iter__` attribute anyway.
    �__iter__)�hasattr�
isinstance�str�tuple)�obj�r�B/usr/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py�is_iterables


�
�r
c@s�eZdZdZd;dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdd�Z
dd�ZeZeZdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�Z d7d8�Z!d9d:�Z"dS)<�
OrderedSetz�
    An OrderedSet is a custom MutableSet that remembers its order, so that
    every entry has an index that can be looked up.

    Example:
        >>> OrderedSet([1, 1, 2, 3, 2])
        OrderedSet([1, 2, 3])
    NcCs g|_i|_|dk	r||O}dS�N)�items�map)�self�iterablerrr�__init__4szOrderedSet.__init__cCs
t|j�S)z�
        Returns the number of unique elements in the ordered set

        Example:
            >>> len(OrderedSet([]))
            0
            >>> len(OrderedSet([1, 2]))
            2
        )�lenr�rrrr�__len__:s
zOrderedSet.__len__cs|t|t�r|tkr���St|�r4�fdd�|D�St|d�sHt|t�rl�j|}t|t�rf��|�S|Snt	d|��dS)aQ
        Get the item at a given index.

        If `index` is a slice, you will get back that slice of items, as a
        new OrderedSet.

        If `index` is a list or a similar iterable, you'll get a list of
        items corresponding to those indices. This is similar to NumPy's
        "fancy indexing". The result is not an OrderedSet because you may ask
        for duplicate indices, and the number of elements returned should be
        the number of elements asked for.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset[1]
            2
        csg|]}�j|�qSr)r)�.0�irrr�
<listcomp>[sz*OrderedSet.__getitem__.<locals>.<listcomp>�	__index__z+Don't know how to index an OrderedSet by %rN)
r�slice�	SLICE_ALL�copyr
rr�list�	__class__�	TypeError)r�index�resultrrr�__getitem__Fs


zOrderedSet.__getitem__cCs
|�|�S)z�
        Return a shallow copy of this object.

        Example:
            >>> this = OrderedSet([1, 2, 3])
            >>> other = this.copy()
            >>> this == other
            True
            >>> this is other
            False
        )r rrrrreszOrderedSet.copycCst|�dkrdSt|�SdS)Nrr)rrrrrr�__getstate__sszOrderedSet.__getstate__cCs"|dkr|�g�n
|�|�dS)Nr)r)r�staterrr�__setstate__szOrderedSet.__setstate__cCs
||jkS)z�
        Test if the item is in this ordered set

        Example:
            >>> 1 in OrderedSet([1, 3, 2])
            True
            >>> 5 in OrderedSet([1, 3, 2])
            False
        )r�r�keyrrr�__contains__�s
zOrderedSet.__contains__cCs0||jkr&t|j�|j|<|j�|�|j|S)aE
        Add `key` as an item to this OrderedSet, then return its index.

        If `key` is already in the OrderedSet, return the index it already
        had.

        Example:
            >>> oset = OrderedSet()
            >>> oset.append(3)
            0
            >>> print(oset)
            OrderedSet([3])
        )rrr�appendr(rrr�add�s
zOrderedSet.addcCsFd}z|D]}|�|�}q
Wn$tk
r@tdt|���YnX|S)a<
        Update the set with the given iterable sequence, then return the index
        of the last element inserted.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.update([3, 1, 5, 1, 4])
            4
            >>> print(oset)
            OrderedSet([1, 2, 3, 5, 4])
        Nz(Argument needs to be an iterable, got %s)r,r!�
ValueError�type)rZsequenceZ
item_index�itemrrr�update�s
�
zOrderedSet.updatecs$t|�r�fdd�|D�S�j|S)aH
        Get the index of a given entry, raising an IndexError if it's not
        present.

        `key` can be an iterable of entries that is not a string, in which case
        this returns a list of indices.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.index(2)
            1
        csg|]}��|��qSr)r")rZsubkeyrrrr�sz$OrderedSet.index.<locals>.<listcomp>)r
rr(rrrr"�s
zOrderedSet.indexcCs,|jstd��|jd}|jd=|j|=|S)z�
        Remove and return the last element from the set.

        Raises KeyError if the set is empty.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.pop()
            3
        zSet is empty���)r�KeyErrorr)r�elemrrr�pop�s
zOrderedSet.popcCsP||krL|j|}|j|=|j|=|j��D]\}}||kr,|d|j|<q,dS)a�
        Remove an element.  Do not raise an exception if absent.

        The MutableSet mixin uses this to implement the .remove() method, which
        *does* raise an error when asked to remove a non-existent item.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.discard(2)
            >>> print(oset)
            OrderedSet([1, 3])
            >>> oset.discard(2)
            >>> print(oset)
            OrderedSet([1, 3])
        �N)rr)rr)r�k�vrrr�discard�s
zOrderedSet.discardcCs|jdd�=|j��dS)z8
        Remove all items from this OrderedSet.
        N)rr�clearrrrrr9�szOrderedSet.clearcCs
t|j�S)zb
        Example:
            >>> list(iter(OrderedSet([1, 2, 3])))
            [1, 2, 3]
        )�iterrrrrrrszOrderedSet.__iter__cCs
t|j�S)zf
        Example:
            >>> list(reversed(OrderedSet([1, 2, 3])))
            [3, 2, 1]
        )�reversedrrrrr�__reversed__szOrderedSet.__reversed__cCs&|sd|jjfSd|jjt|�fS)Nz%s()z%s(%r))r �__name__rrrrr�__repr__szOrderedSet.__repr__cCsRt|ttf�rt|�t|�kSzt|�}Wntk
r@YdSXt|�|kSdS)a�
        Returns true if the containers have the same items. If `other` is a
        Sequence, then order is checked, otherwise it is ignored.

        Example:
            >>> oset = OrderedSet([1, 3, 2])
            >>> oset == [1, 3, 2]
            True
            >>> oset == [1, 2, 3]
            False
            >>> oset == [2, 3]
            False
            >>> oset == OrderedSet([3, 2, 1])
            False
        FN)rrrr�setr!)r�otherZother_as_setrrr�__eq__szOrderedSet.__eq__cGs<t|t�r|jnt}ttt�|g|��}tj�|�}||�S)a�
        Combines all unique items.
        Each items order is defined by its first appearance.

        Example:
            >>> oset = OrderedSet.union(OrderedSet([3, 1, 4, 1, 5]), [1, 3], [2, 0])
            >>> print(oset)
            OrderedSet([3, 1, 4, 5, 2, 0])
            >>> oset.union([8, 9])
            OrderedSet([3, 1, 4, 5, 2, 0, 8, 9])
            >>> oset | {10}
            OrderedSet([3, 1, 4, 5, 2, 0, 10])
        )rrr rr�it�chain�
from_iterable)r�sets�clsZ
containersrrrr�union6szOrderedSet.unioncCs
|�|�Sr)�intersection�rr@rrr�__and__IszOrderedSet.__and__csHt|t�r|jnt}|r<tjtt|����fdd�|D�}n|}||�S)a�
        Returns elements in common between all sets. Order is defined only
        by the first set.

        Example:
            >>> oset = OrderedSet.intersection(OrderedSet([0, 1, 2, 3]), [1, 2, 3])
            >>> print(oset)
            OrderedSet([1, 2, 3])
            >>> oset.intersection([2, 4, 5], [1, 2, 3, 4])
            OrderedSet([2])
            >>> oset.intersection()
            OrderedSet([1, 2, 3])
        c3s|]}|�kr|VqdSrr�rr/��commonrr�	<genexpr>^sz*OrderedSet.intersection.<locals>.<genexpr>)rrr r?rHr�rrErFrrrLrrHMszOrderedSet.intersectioncs:|j}|r.tjtt|����fdd�|D�}n|}||�S)a�
        Returns all elements that are in this set but not the others.

        Example:
            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]))
            OrderedSet([1, 3])
            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]), OrderedSet([3]))
            OrderedSet([1])
            >>> OrderedSet([1, 2, 3]) - OrderedSet([2])
            OrderedSet([1, 3])
            >>> OrderedSet([1, 2, 3]).difference()
            OrderedSet([1, 2, 3])
        c3s|]}|�kr|VqdSrrrK�r@rrrNtsz(OrderedSet.difference.<locals>.<genexpr>)r r?rGrrOrrPr�
differencecszOrderedSet.differencecs*t|�t��krdSt�fdd�|D��S)a7
        Report whether another set contains this set.

        Example:
            >>> OrderedSet([1, 2, 3]).issubset({1, 2})
            False
            >>> OrderedSet([1, 2, 3]).issubset({1, 2, 3, 4})
            True
            >>> OrderedSet([1, 2, 3]).issubset({1, 4, 3, 5})
            False
        Fc3s|]}|�kVqdSrrrKrPrrrN�sz&OrderedSet.issubset.<locals>.<genexpr>�r�allrIrrPr�issubsetyszOrderedSet.issubsetcs*t��t|�krdSt�fdd�|D��S)a=
        Report whether this set contains another set.

        Example:
            >>> OrderedSet([1, 2]).issuperset([1, 2, 3])
            False
            >>> OrderedSet([1, 2, 3, 4]).issuperset({1, 2, 3})
            True
            >>> OrderedSet([1, 4, 3, 5]).issuperset({1, 2, 3})
            False
        Fc3s|]}|�kVqdSrrrKrrrrN�sz(OrderedSet.issuperset.<locals>.<genexpr>rRrIrrr�
issuperset�szOrderedSet.issupersetcCs:t|t�r|jnt}||��|�}||��|�}|�|�S)a�
        Return the symmetric difference of two OrderedSets as a new set.
        That is, the new set will contain all elements that are in exactly
        one of the sets.

        Their order will be preserved, with elements from `self` preceding
        elements from `other`.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.symmetric_difference(other)
            OrderedSet([4, 5, 9, 2])
        )rrr rQrG)rr@rFZdiff1Zdiff2rrr�symmetric_difference�szOrderedSet.symmetric_differencecCs||_dd�t|�D�|_dS)zt
        Replace the 'items' list of this OrderedSet with a new one, updating
        self.map accordingly.
        cSsi|]\}}||�qSrr)r�idxr/rrr�
<dictcomp>�sz,OrderedSet._update_items.<locals>.<dictcomp>N)r�	enumerater)rrrrr�
_update_items�szOrderedSet._update_itemscs:t��|D]}�t|�O�q
|��fdd�|jD��dS)a�
        Update this OrderedSet to remove items from one or more other sets.

        Example:
            >>> this = OrderedSet([1, 2, 3])
            >>> this.difference_update(OrderedSet([2, 4]))
            >>> print(this)
            OrderedSet([1, 3])

            >>> this = OrderedSet([1, 2, 3, 4, 5])
            >>> this.difference_update(OrderedSet([2, 4]), OrderedSet([1, 4, 6]))
            >>> print(this)
            OrderedSet([3, 5])
        csg|]}|�kr|�qSrrrK��items_to_removerrr�sz0OrderedSet.difference_update.<locals>.<listcomp>N�r?rZr)rrEr@rr[r�difference_update�szOrderedSet.difference_updatecs&t���|��fdd�|jD��dS)a^
        Update this OrderedSet to keep only items in another set, preserving
        their order in this set.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.intersection_update(other)
            >>> print(this)
            OrderedSet([1, 3, 7])
        csg|]}|�kr|�qSrrrKrPrrr�sz2OrderedSet.intersection_update.<locals>.<listcomp>Nr]rIrrPr�intersection_update�szOrderedSet.intersection_updatecs<�fdd�|D�}t|�����fdd��jD�|�dS)a�
        Update this OrderedSet to remove items from another set, then
        add items from the other set that were not present in this set.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.symmetric_difference_update(other)
            >>> print(this)
            OrderedSet([4, 5, 9, 2])
        csg|]}|�kr|�qSrrrKrrrr�sz:OrderedSet.symmetric_difference_update.<locals>.<listcomp>csg|]}|�kr|�qSrrrKr[rrr�sNr])rr@Zitems_to_addr)r\rr�symmetric_difference_update�s
�z&OrderedSet.symmetric_difference_update)N)#r=�
__module__�__qualname__�__doc__rrr$rr%r'r*r,r+r0r"Zget_locZget_indexerr4r8r9rr<r>rArGrJrHrQrTrUrVrZr^r_r`rrrrr*s@	
r)rc�	itertoolsrB�collectionsrZcollections.abcrr�ImportErrorrr�__version__r
rrrrr�<module>ssite-packages/setuptools/_vendor/__pycache__/ordered_set.cpython-38.pyc000064400000040034151446177000022306 0ustar00U

�Qab;�@s|dZddlZddlmZzddlmZmZWn$ek
rPddlmZmZYnXe	d�Z
dZdd�ZGdd	�d	ee�Z
dS)
z�
An OrderedSet is a custom MutableSet that remembers its order, so that every
entry has an index that can be looked up.

Based on a recipe originally posted to ActiveState Recipes by Raymond Hettiger,
and released under the MIT license.
�N)�deque)�
MutableSet�Sequencez3.1cCs"t|d�o t|t�o t|t�S)a

    Are we being asked to look up a list of things, instead of a single thing?
    We check for the `__iter__` attribute so that this can cover types that
    don't have to be known by this module, such as NumPy arrays.

    Strings, however, should be considered as atomic values to look up, not
    iterables. The same goes for tuples, since they are immutable and therefore
    valid entries.

    We don't need to check for the Python 2 `unicode` type, because it doesn't
    have an `__iter__` attribute anyway.
    �__iter__)�hasattr�
isinstance�str�tuple)�obj�r�B/usr/lib/python3.8/site-packages/setuptools/_vendor/ordered_set.py�is_iterables


�
�r
c@s�eZdZdZd;dd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�ZeZdd�Z
dd�ZeZeZdd�Zdd�Zdd�Zdd�Zdd �Zd!d"�Zd#d$�Zd%d&�Zd'd(�Zd)d*�Zd+d,�Zd-d.�Zd/d0�Zd1d2�Zd3d4�Zd5d6�Z d7d8�Z!d9d:�Z"dS)<�
OrderedSetz�
    An OrderedSet is a custom MutableSet that remembers its order, so that
    every entry has an index that can be looked up.

    Example:
        >>> OrderedSet([1, 1, 2, 3, 2])
        OrderedSet([1, 2, 3])
    NcCs g|_i|_|dk	r||O}dS�N)�items�map)�self�iterablerrr�__init__4szOrderedSet.__init__cCs
t|j�S)z�
        Returns the number of unique elements in the ordered set

        Example:
            >>> len(OrderedSet([]))
            0
            >>> len(OrderedSet([1, 2]))
            2
        )�lenr�rrrr�__len__:s
zOrderedSet.__len__cs|t|t�r|tkr���St|�r4�fdd�|D�St|d�sHt|t�rl�j|}t|t�rf��|�S|Snt	d|��dS)aQ
        Get the item at a given index.

        If `index` is a slice, you will get back that slice of items, as a
        new OrderedSet.

        If `index` is a list or a similar iterable, you'll get a list of
        items corresponding to those indices. This is similar to NumPy's
        "fancy indexing". The result is not an OrderedSet because you may ask
        for duplicate indices, and the number of elements returned should be
        the number of elements asked for.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset[1]
            2
        csg|]}�j|�qSr)r)�.0�irrr�
<listcomp>[sz*OrderedSet.__getitem__.<locals>.<listcomp>�	__index__z+Don't know how to index an OrderedSet by %rN)
r�slice�	SLICE_ALL�copyr
rr�list�	__class__�	TypeError)r�index�resultrrr�__getitem__Fs


zOrderedSet.__getitem__cCs
|�|�S)z�
        Return a shallow copy of this object.

        Example:
            >>> this = OrderedSet([1, 2, 3])
            >>> other = this.copy()
            >>> this == other
            True
            >>> this is other
            False
        )r rrrrreszOrderedSet.copycCst|�dkrdSt|�SdS)Nrr)rrrrrr�__getstate__sszOrderedSet.__getstate__cCs"|dkr|�g�n
|�|�dS)Nr)r)r�staterrr�__setstate__szOrderedSet.__setstate__cCs
||jkS)z�
        Test if the item is in this ordered set

        Example:
            >>> 1 in OrderedSet([1, 3, 2])
            True
            >>> 5 in OrderedSet([1, 3, 2])
            False
        )r�r�keyrrr�__contains__�s
zOrderedSet.__contains__cCs0||jkr&t|j�|j|<|j�|�|j|S)aE
        Add `key` as an item to this OrderedSet, then return its index.

        If `key` is already in the OrderedSet, return the index it already
        had.

        Example:
            >>> oset = OrderedSet()
            >>> oset.append(3)
            0
            >>> print(oset)
            OrderedSet([3])
        )rrr�appendr(rrr�add�s
zOrderedSet.addcCsFd}z|D]}|�|�}q
Wn$tk
r@tdt|���YnX|S)a<
        Update the set with the given iterable sequence, then return the index
        of the last element inserted.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.update([3, 1, 5, 1, 4])
            4
            >>> print(oset)
            OrderedSet([1, 2, 3, 5, 4])
        Nz(Argument needs to be an iterable, got %s)r,r!�
ValueError�type)rZsequenceZ
item_index�itemrrr�update�s
�
zOrderedSet.updatecs$t|�r�fdd�|D�S�j|S)aH
        Get the index of a given entry, raising an IndexError if it's not
        present.

        `key` can be an iterable of entries that is not a string, in which case
        this returns a list of indices.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.index(2)
            1
        csg|]}��|��qSr)r")rZsubkeyrrrr�sz$OrderedSet.index.<locals>.<listcomp>)r
rr(rrrr"�s
zOrderedSet.indexcCs,|jstd��|jd}|jd=|j|=|S)z�
        Remove and return the last element from the set.

        Raises KeyError if the set is empty.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.pop()
            3
        zSet is empty���)r�KeyErrorr)r�elemrrr�pop�s
zOrderedSet.popcCsP||krL|j|}|j|=|j|=|j��D]\}}||kr,|d|j|<q,dS)a�
        Remove an element.  Do not raise an exception if absent.

        The MutableSet mixin uses this to implement the .remove() method, which
        *does* raise an error when asked to remove a non-existent item.

        Example:
            >>> oset = OrderedSet([1, 2, 3])
            >>> oset.discard(2)
            >>> print(oset)
            OrderedSet([1, 3])
            >>> oset.discard(2)
            >>> print(oset)
            OrderedSet([1, 3])
        �N)rr)rr)r�k�vrrr�discard�s
zOrderedSet.discardcCs|jdd�=|j��dS)z8
        Remove all items from this OrderedSet.
        N)rr�clearrrrrr9�szOrderedSet.clearcCs
t|j�S)zb
        Example:
            >>> list(iter(OrderedSet([1, 2, 3])))
            [1, 2, 3]
        )�iterrrrrrrszOrderedSet.__iter__cCs
t|j�S)zf
        Example:
            >>> list(reversed(OrderedSet([1, 2, 3])))
            [3, 2, 1]
        )�reversedrrrrr�__reversed__szOrderedSet.__reversed__cCs&|sd|jjfSd|jjt|�fS)Nz%s()z%s(%r))r �__name__rrrrr�__repr__szOrderedSet.__repr__cCsRt|ttf�rt|�t|�kSzt|�}Wntk
r@YdSXt|�|kSdS)a�
        Returns true if the containers have the same items. If `other` is a
        Sequence, then order is checked, otherwise it is ignored.

        Example:
            >>> oset = OrderedSet([1, 3, 2])
            >>> oset == [1, 3, 2]
            True
            >>> oset == [1, 2, 3]
            False
            >>> oset == [2, 3]
            False
            >>> oset == OrderedSet([3, 2, 1])
            False
        FN)rrrr�setr!)r�otherZother_as_setrrr�__eq__szOrderedSet.__eq__cGs<t|t�r|jnt}ttt�|g|��}tj�|�}||�S)a�
        Combines all unique items.
        Each items order is defined by its first appearance.

        Example:
            >>> oset = OrderedSet.union(OrderedSet([3, 1, 4, 1, 5]), [1, 3], [2, 0])
            >>> print(oset)
            OrderedSet([3, 1, 4, 5, 2, 0])
            >>> oset.union([8, 9])
            OrderedSet([3, 1, 4, 5, 2, 0, 8, 9])
            >>> oset | {10}
            OrderedSet([3, 1, 4, 5, 2, 0, 10])
        )rrr rr�it�chain�
from_iterable)r�sets�clsZ
containersrrrr�union6szOrderedSet.unioncCs
|�|�Sr)�intersection�rr@rrr�__and__IszOrderedSet.__and__csHt|t�r|jnt}|r<tjtt|����fdd�|D�}n|}||�S)a�
        Returns elements in common between all sets. Order is defined only
        by the first set.

        Example:
            >>> oset = OrderedSet.intersection(OrderedSet([0, 1, 2, 3]), [1, 2, 3])
            >>> print(oset)
            OrderedSet([1, 2, 3])
            >>> oset.intersection([2, 4, 5], [1, 2, 3, 4])
            OrderedSet([2])
            >>> oset.intersection()
            OrderedSet([1, 2, 3])
        c3s|]}|�kr|VqdSrr�rr/��commonrr�	<genexpr>^sz*OrderedSet.intersection.<locals>.<genexpr>)rrr r?rHr�rrErFrrrLrrHMszOrderedSet.intersectioncs:|j}|r.tjtt|����fdd�|D�}n|}||�S)a�
        Returns all elements that are in this set but not the others.

        Example:
            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]))
            OrderedSet([1, 3])
            >>> OrderedSet([1, 2, 3]).difference(OrderedSet([2]), OrderedSet([3]))
            OrderedSet([1])
            >>> OrderedSet([1, 2, 3]) - OrderedSet([2])
            OrderedSet([1, 3])
            >>> OrderedSet([1, 2, 3]).difference()
            OrderedSet([1, 2, 3])
        c3s|]}|�kr|VqdSrrrK�r@rrrNtsz(OrderedSet.difference.<locals>.<genexpr>)r r?rGrrOrrPr�
differencecszOrderedSet.differencecs*t|�t��krdSt�fdd�|D��S)a7
        Report whether another set contains this set.

        Example:
            >>> OrderedSet([1, 2, 3]).issubset({1, 2})
            False
            >>> OrderedSet([1, 2, 3]).issubset({1, 2, 3, 4})
            True
            >>> OrderedSet([1, 2, 3]).issubset({1, 4, 3, 5})
            False
        Fc3s|]}|�kVqdSrrrKrPrrrN�sz&OrderedSet.issubset.<locals>.<genexpr>�r�allrIrrPr�issubsetyszOrderedSet.issubsetcs*t��t|�krdSt�fdd�|D��S)a=
        Report whether this set contains another set.

        Example:
            >>> OrderedSet([1, 2]).issuperset([1, 2, 3])
            False
            >>> OrderedSet([1, 2, 3, 4]).issuperset({1, 2, 3})
            True
            >>> OrderedSet([1, 4, 3, 5]).issuperset({1, 2, 3})
            False
        Fc3s|]}|�kVqdSrrrKrrrrN�sz(OrderedSet.issuperset.<locals>.<genexpr>rRrIrrr�
issuperset�szOrderedSet.issupersetcCs:t|t�r|jnt}||��|�}||��|�}|�|�S)a�
        Return the symmetric difference of two OrderedSets as a new set.
        That is, the new set will contain all elements that are in exactly
        one of the sets.

        Their order will be preserved, with elements from `self` preceding
        elements from `other`.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.symmetric_difference(other)
            OrderedSet([4, 5, 9, 2])
        )rrr rQrG)rr@rFZdiff1Zdiff2rrr�symmetric_difference�szOrderedSet.symmetric_differencecCs||_dd�t|�D�|_dS)zt
        Replace the 'items' list of this OrderedSet with a new one, updating
        self.map accordingly.
        cSsi|]\}}||�qSrr)r�idxr/rrr�
<dictcomp>�sz,OrderedSet._update_items.<locals>.<dictcomp>N)r�	enumerater)rrrrr�
_update_items�szOrderedSet._update_itemscs:t��|D]}�t|�O�q
|��fdd�|jD��dS)a�
        Update this OrderedSet to remove items from one or more other sets.

        Example:
            >>> this = OrderedSet([1, 2, 3])
            >>> this.difference_update(OrderedSet([2, 4]))
            >>> print(this)
            OrderedSet([1, 3])

            >>> this = OrderedSet([1, 2, 3, 4, 5])
            >>> this.difference_update(OrderedSet([2, 4]), OrderedSet([1, 4, 6]))
            >>> print(this)
            OrderedSet([3, 5])
        csg|]}|�kr|�qSrrrK��items_to_removerrr�sz0OrderedSet.difference_update.<locals>.<listcomp>N�r?rZr)rrEr@rr[r�difference_update�szOrderedSet.difference_updatecs&t���|��fdd�|jD��dS)a^
        Update this OrderedSet to keep only items in another set, preserving
        their order in this set.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.intersection_update(other)
            >>> print(this)
            OrderedSet([1, 3, 7])
        csg|]}|�kr|�qSrrrKrPrrr�sz2OrderedSet.intersection_update.<locals>.<listcomp>Nr]rIrrPr�intersection_update�szOrderedSet.intersection_updatecs<�fdd�|D�}t|�����fdd��jD�|�dS)a�
        Update this OrderedSet to remove items from another set, then
        add items from the other set that were not present in this set.

        Example:
            >>> this = OrderedSet([1, 4, 3, 5, 7])
            >>> other = OrderedSet([9, 7, 1, 3, 2])
            >>> this.symmetric_difference_update(other)
            >>> print(this)
            OrderedSet([4, 5, 9, 2])
        csg|]}|�kr|�qSrrrKrrrr�sz:OrderedSet.symmetric_difference_update.<locals>.<listcomp>csg|]}|�kr|�qSrrrKr[rrr�sNr])rr@Zitems_to_addr)r\rr�symmetric_difference_update�s
�z&OrderedSet.symmetric_difference_update)N)#r=�
__module__�__qualname__�__doc__rrr$rr%r'r*r,r+r0r"Zget_locZget_indexerr4r8r9rr<r>rArGrJrHrQrTrUrVrZr^r_r`rrrrr*s@	
r)rc�	itertoolsrB�collectionsrZcollections.abcrr�ImportErrorrr�__version__r
rrrrr�<module>ssite-packages/setuptools/_vendor/__pycache__/__init__.cpython-38.pyc000064400000000232151446177000021542 0ustar00U

�Qab�@sdS)N�rrr�?/usr/lib/python3.8/site-packages/setuptools/_vendor/__init__.py�<module>�site-packages/setuptools/_vendor/__init__.py000064400000000000151446177000015245 0ustar00site-packages/setuptools/_vendor/pyparsing.py000064400000705167151446177000015554 0ustar00# module pyparsing.py
#
# Copyright (c) 2003-2018  Paul T. McGuire
#
# Permission is hereby granted, free of charge, to any person obtaining
# a copy of this software and associated documentation files (the
# "Software"), to deal in the Software without restriction, including
# without limitation the rights to use, copy, modify, merge, publish,
# distribute, sublicense, and/or sell copies of the Software, and to
# permit persons to whom the Software is furnished to do so, subject to
# the following conditions:
#
# The above copyright notice and this permission notice shall be
# included in all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
# IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
# CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
# TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
# SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
#

__doc__ = \
"""
pyparsing module - Classes and methods to define and execute parsing grammars
=============================================================================

The pyparsing module is an alternative approach to creating and executing simple grammars,
vs. the traditional lex/yacc approach, or the use of regular expressions.  With pyparsing, you
don't need to learn a new syntax for defining grammars or matching expressions - the parsing module
provides a library of classes that you use to construct the grammar directly in Python.

Here is a program to parse "Hello, World!" (or any greeting of the form 
C{"<salutation>, <addressee>!"}), built up using L{Word}, L{Literal}, and L{And} elements 
(L{'+'<ParserElement.__add__>} operator gives L{And} expressions, strings are auto-converted to
L{Literal} expressions)::

    from pyparsing import Word, alphas

    # define grammar of a greeting
    greet = Word(alphas) + "," + Word(alphas) + "!"

    hello = "Hello, World!"
    print (hello, "->", greet.parseString(hello))

The program outputs the following::

    Hello, World! -> ['Hello', ',', 'World', '!']

The Python representation of the grammar is quite readable, owing to the self-explanatory
class names, and the use of '+', '|' and '^' operators.

The L{ParseResults} object returned from L{ParserElement.parseString<ParserElement.parseString>} can be accessed as a nested list, a dictionary, or an
object with named attributes.

The pyparsing module handles some of the problems that are typically vexing when writing text parsers:
 - extra or missing whitespace (the above program will also handle "Hello,World!", "Hello  ,  World  !", etc.)
 - quoted strings
 - embedded comments


Getting Started -
-----------------
Visit the classes L{ParserElement} and L{ParseResults} to see the base classes that most other pyparsing
classes inherit from. Use the docstrings for examples of how to:
 - construct literal match expressions from L{Literal} and L{CaselessLiteral} classes
 - construct character word-group expressions using the L{Word} class
 - see how to create repetitive expressions using L{ZeroOrMore} and L{OneOrMore} classes
 - use L{'+'<And>}, L{'|'<MatchFirst>}, L{'^'<Or>}, and L{'&'<Each>} operators to combine simple expressions into more complex ones
 - associate names with your parsed results using L{ParserElement.setResultsName}
 - find some helpful expression short-cuts like L{delimitedList} and L{oneOf}
 - find more useful common expressions in the L{pyparsing_common} namespace class
"""

__version__ = "2.2.1"
__versionTime__ = "18 Sep 2018 00:49 UTC"
__author__ = "Paul McGuire <ptmcg@users.sourceforge.net>"

import string
from weakref import ref as wkref
import copy
import sys
import warnings
import re
import sre_constants
import collections
import pprint
import traceback
import types
from datetime import datetime

try:
    from _thread import RLock
except ImportError:
    from threading import RLock

try:
    # Python 3
    from collections.abc import Iterable
    from collections.abc import MutableMapping
except ImportError:
    # Python 2.7
    from collections import Iterable
    from collections import MutableMapping

try:
    from collections import OrderedDict as _OrderedDict
except ImportError:
    try:
        from ordereddict import OrderedDict as _OrderedDict
    except ImportError:
        _OrderedDict = None

#~ sys.stderr.write( "testing pyparsing module, version %s, %s\n" % (__version__,__versionTime__ ) )

__all__ = [
'And', 'CaselessKeyword', 'CaselessLiteral', 'CharsNotIn', 'Combine', 'Dict', 'Each', 'Empty',
'FollowedBy', 'Forward', 'GoToColumn', 'Group', 'Keyword', 'LineEnd', 'LineStart', 'Literal',
'MatchFirst', 'NoMatch', 'NotAny', 'OneOrMore', 'OnlyOnce', 'Optional', 'Or',
'ParseBaseException', 'ParseElementEnhance', 'ParseException', 'ParseExpression', 'ParseFatalException',
'ParseResults', 'ParseSyntaxException', 'ParserElement', 'QuotedString', 'RecursiveGrammarException',
'Regex', 'SkipTo', 'StringEnd', 'StringStart', 'Suppress', 'Token', 'TokenConverter', 
'White', 'Word', 'WordEnd', 'WordStart', 'ZeroOrMore',
'alphanums', 'alphas', 'alphas8bit', 'anyCloseTag', 'anyOpenTag', 'cStyleComment', 'col',
'commaSeparatedList', 'commonHTMLEntity', 'countedArray', 'cppStyleComment', 'dblQuotedString',
'dblSlashComment', 'delimitedList', 'dictOf', 'downcaseTokens', 'empty', 'hexnums',
'htmlComment', 'javaStyleComment', 'line', 'lineEnd', 'lineStart', 'lineno',
'makeHTMLTags', 'makeXMLTags', 'matchOnlyAtCol', 'matchPreviousExpr', 'matchPreviousLiteral',
'nestedExpr', 'nullDebugAction', 'nums', 'oneOf', 'opAssoc', 'operatorPrecedence', 'printables',
'punc8bit', 'pythonStyleComment', 'quotedString', 'removeQuotes', 'replaceHTMLEntity', 
'replaceWith', 'restOfLine', 'sglQuotedString', 'srange', 'stringEnd',
'stringStart', 'traceParseAction', 'unicodeString', 'upcaseTokens', 'withAttribute',
'indentedBlock', 'originalTextFor', 'ungroup', 'infixNotation','locatedExpr', 'withClass',
'CloseMatch', 'tokenMap', 'pyparsing_common',
]

system_version = tuple(sys.version_info)[:3]
PY_3 = system_version[0] == 3
if PY_3:
    _MAX_INT = sys.maxsize
    basestring = str
    unichr = chr
    _ustr = str

    # build list of single arg builtins, that can be used as parse actions
    singleArgBuiltins = [sum, len, sorted, reversed, list, tuple, set, any, all, min, max]

else:
    _MAX_INT = sys.maxint
    range = xrange

    def _ustr(obj):
        """Drop-in replacement for str(obj) that tries to be Unicode friendly. It first tries
           str(obj). If that fails with a UnicodeEncodeError, then it tries unicode(obj). It
           then < returns the unicode object | encodes it with the default encoding | ... >.
        """
        if isinstance(obj,unicode):
            return obj

        try:
            # If this works, then _ustr(obj) has the same behaviour as str(obj), so
            # it won't break any existing code.
            return str(obj)

        except UnicodeEncodeError:
            # Else encode it
            ret = unicode(obj).encode(sys.getdefaultencoding(), 'xmlcharrefreplace')
            xmlcharref = Regex(r'&#\d+;')
            xmlcharref.setParseAction(lambda t: '\\u' + hex(int(t[0][2:-1]))[2:])
            return xmlcharref.transformString(ret)

    # build list of single arg builtins, tolerant of Python version, that can be used as parse actions
    singleArgBuiltins = []
    import __builtin__
    for fname in "sum len sorted reversed list tuple set any all min max".split():
        try:
            singleArgBuiltins.append(getattr(__builtin__,fname))
        except AttributeError:
            continue
            
_generatorType = type((y for y in range(1)))
 
def _xml_escape(data):
    """Escape &, <, >, ", ', etc. in a string of data."""

    # ampersand must be replaced first
    from_symbols = '&><"\''
    to_symbols = ('&'+s+';' for s in "amp gt lt quot apos".split())
    for from_,to_ in zip(from_symbols, to_symbols):
        data = data.replace(from_, to_)
    return data

class _Constants(object):
    pass

alphas     = string.ascii_uppercase + string.ascii_lowercase
nums       = "0123456789"
hexnums    = nums + "ABCDEFabcdef"
alphanums  = alphas + nums
_bslash    = chr(92)
printables = "".join(c for c in string.printable if c not in string.whitespace)

class ParseBaseException(Exception):
    """base exception class for all parsing runtime exceptions"""
    # Performance tuning: we construct a *lot* of these, so keep this
    # constructor as small and fast as possible
    def __init__( self, pstr, loc=0, msg=None, elem=None ):
        self.loc = loc
        if msg is None:
            self.msg = pstr
            self.pstr = ""
        else:
            self.msg = msg
            self.pstr = pstr
        self.parserElement = elem
        self.args = (pstr, loc, msg)

    @classmethod
    def _from_exception(cls, pe):
        """
        internal factory method to simplify creating one type of ParseException 
        from another - avoids having __init__ signature conflicts among subclasses
        """
        return cls(pe.pstr, pe.loc, pe.msg, pe.parserElement)

    def __getattr__( self, aname ):
        """supported attributes by name are:
            - lineno - returns the line number of the exception text
            - col - returns the column number of the exception text
            - line - returns the line containing the exception text
        """
        if( aname == "lineno" ):
            return lineno( self.loc, self.pstr )
        elif( aname in ("col", "column") ):
            return col( self.loc, self.pstr )
        elif( aname == "line" ):
            return line( self.loc, self.pstr )
        else:
            raise AttributeError(aname)

    def __str__( self ):
        return "%s (at char %d), (line:%d, col:%d)" % \
                ( self.msg, self.loc, self.lineno, self.column )
    def __repr__( self ):
        return _ustr(self)
    def markInputline( self, markerString = ">!<" ):
        """Extracts the exception line from the input string, and marks
           the location of the exception with a special symbol.
        """
        line_str = self.line
        line_column = self.column - 1
        if markerString:
            line_str = "".join((line_str[:line_column],
                                markerString, line_str[line_column:]))
        return line_str.strip()
    def __dir__(self):
        return "lineno col line".split() + dir(type(self))

class ParseException(ParseBaseException):
    """
    Exception thrown when parse expressions don't match class;
    supported attributes by name are:
     - lineno - returns the line number of the exception text
     - col - returns the column number of the exception text
     - line - returns the line containing the exception text
        
    Example::
        try:
            Word(nums).setName("integer").parseString("ABC")
        except ParseException as pe:
            print(pe)
            print("column: {}".format(pe.col))
            
    prints::
       Expected integer (at char 0), (line:1, col:1)
        column: 1
    """
    pass

class ParseFatalException(ParseBaseException):
    """user-throwable exception thrown when inconsistent parse content
       is found; stops all parsing immediately"""
    pass

class ParseSyntaxException(ParseFatalException):
    """just like L{ParseFatalException}, but thrown internally when an
       L{ErrorStop<And._ErrorStop>} ('-' operator) indicates that parsing is to stop 
       immediately because an unbacktrackable syntax error has been found"""
    pass

#~ class ReparseException(ParseBaseException):
    #~ """Experimental class - parse actions can raise this exception to cause
       #~ pyparsing to reparse the input string:
        #~ - with a modified input string, and/or
        #~ - with a modified start location
       #~ Set the values of the ReparseException in the constructor, and raise the
       #~ exception in a parse action to cause pyparsing to use the new string/location.
       #~ Setting the values as None causes no change to be made.
       #~ """
    #~ def __init_( self, newstring, restartLoc ):
        #~ self.newParseText = newstring
        #~ self.reparseLoc = restartLoc

class RecursiveGrammarException(Exception):
    """exception thrown by L{ParserElement.validate} if the grammar could be improperly recursive"""
    def __init__( self, parseElementList ):
        self.parseElementTrace = parseElementList

    def __str__( self ):
        return "RecursiveGrammarException: %s" % self.parseElementTrace

class _ParseResultsWithOffset(object):
    def __init__(self,p1,p2):
        self.tup = (p1,p2)
    def __getitem__(self,i):
        return self.tup[i]
    def __repr__(self):
        return repr(self.tup[0])
    def setOffset(self,i):
        self.tup = (self.tup[0],i)

class ParseResults(object):
    """
    Structured parse results, to provide multiple means of access to the parsed data:
       - as a list (C{len(results)})
       - by list index (C{results[0], results[1]}, etc.)
       - by attribute (C{results.<resultsName>} - see L{ParserElement.setResultsName})

    Example::
        integer = Word(nums)
        date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))
        # equivalent form:
        # date_str = integer("year") + '/' + integer("month") + '/' + integer("day")

        # parseString returns a ParseResults object
        result = date_str.parseString("1999/12/31")

        def test(s, fn=repr):
            print("%s -> %s" % (s, fn(eval(s))))
        test("list(result)")
        test("result[0]")
        test("result['month']")
        test("result.day")
        test("'month' in result")
        test("'minutes' in result")
        test("result.dump()", str)
    prints::
        list(result) -> ['1999', '/', '12', '/', '31']
        result[0] -> '1999'
        result['month'] -> '12'
        result.day -> '31'
        'month' in result -> True
        'minutes' in result -> False
        result.dump() -> ['1999', '/', '12', '/', '31']
        - day: 31
        - month: 12
        - year: 1999
    """
    def __new__(cls, toklist=None, name=None, asList=True, modal=True ):
        if isinstance(toklist, cls):
            return toklist
        retobj = object.__new__(cls)
        retobj.__doinit = True
        return retobj

    # Performance tuning: we construct a *lot* of these, so keep this
    # constructor as small and fast as possible
    def __init__( self, toklist=None, name=None, asList=True, modal=True, isinstance=isinstance ):
        if self.__doinit:
            self.__doinit = False
            self.__name = None
            self.__parent = None
            self.__accumNames = {}
            self.__asList = asList
            self.__modal = modal
            if toklist is None:
                toklist = []
            if isinstance(toklist, list):
                self.__toklist = toklist[:]
            elif isinstance(toklist, _generatorType):
                self.__toklist = list(toklist)
            else:
                self.__toklist = [toklist]
            self.__tokdict = dict()

        if name is not None and name:
            if not modal:
                self.__accumNames[name] = 0
            if isinstance(name,int):
                name = _ustr(name) # will always return a str, but use _ustr for consistency
            self.__name = name
            if not (isinstance(toklist, (type(None), basestring, list)) and toklist in (None,'',[])):
                if isinstance(toklist,basestring):
                    toklist = [ toklist ]
                if asList:
                    if isinstance(toklist,ParseResults):
                        self[name] = _ParseResultsWithOffset(toklist.copy(),0)
                    else:
                        self[name] = _ParseResultsWithOffset(ParseResults(toklist[0]),0)
                    self[name].__name = name
                else:
                    try:
                        self[name] = toklist[0]
                    except (KeyError,TypeError,IndexError):
                        self[name] = toklist

    def __getitem__( self, i ):
        if isinstance( i, (int,slice) ):
            return self.__toklist[i]
        else:
            if i not in self.__accumNames:
                return self.__tokdict[i][-1][0]
            else:
                return ParseResults([ v[0] for v in self.__tokdict[i] ])

    def __setitem__( self, k, v, isinstance=isinstance ):
        if isinstance(v,_ParseResultsWithOffset):
            self.__tokdict[k] = self.__tokdict.get(k,list()) + [v]
            sub = v[0]
        elif isinstance(k,(int,slice)):
            self.__toklist[k] = v
            sub = v
        else:
            self.__tokdict[k] = self.__tokdict.get(k,list()) + [_ParseResultsWithOffset(v,0)]
            sub = v
        if isinstance(sub,ParseResults):
            sub.__parent = wkref(self)

    def __delitem__( self, i ):
        if isinstance(i,(int,slice)):
            mylen = len( self.__toklist )
            del self.__toklist[i]

            # convert int to slice
            if isinstance(i, int):
                if i < 0:
                    i += mylen
                i = slice(i, i+1)
            # get removed indices
            removed = list(range(*i.indices(mylen)))
            removed.reverse()
            # fixup indices in token dictionary
            for name,occurrences in self.__tokdict.items():
                for j in removed:
                    for k, (value, position) in enumerate(occurrences):
                        occurrences[k] = _ParseResultsWithOffset(value, position - (position > j))
        else:
            del self.__tokdict[i]

    def __contains__( self, k ):
        return k in self.__tokdict

    def __len__( self ): return len( self.__toklist )
    def __bool__(self): return ( not not self.__toklist )
    __nonzero__ = __bool__
    def __iter__( self ): return iter( self.__toklist )
    def __reversed__( self ): return iter( self.__toklist[::-1] )
    def _iterkeys( self ):
        if hasattr(self.__tokdict, "iterkeys"):
            return self.__tokdict.iterkeys()
        else:
            return iter(self.__tokdict)

    def _itervalues( self ):
        return (self[k] for k in self._iterkeys())
            
    def _iteritems( self ):
        return ((k, self[k]) for k in self._iterkeys())

    if PY_3:
        keys = _iterkeys       
        """Returns an iterator of all named result keys (Python 3.x only)."""

        values = _itervalues
        """Returns an iterator of all named result values (Python 3.x only)."""

        items = _iteritems
        """Returns an iterator of all named result key-value tuples (Python 3.x only)."""

    else:
        iterkeys = _iterkeys
        """Returns an iterator of all named result keys (Python 2.x only)."""

        itervalues = _itervalues
        """Returns an iterator of all named result values (Python 2.x only)."""

        iteritems = _iteritems
        """Returns an iterator of all named result key-value tuples (Python 2.x only)."""

        def keys( self ):
            """Returns all named result keys (as a list in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.iterkeys())

        def values( self ):
            """Returns all named result values (as a list in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.itervalues())
                
        def items( self ):
            """Returns all named result key-values (as a list of tuples in Python 2.x, as an iterator in Python 3.x)."""
            return list(self.iteritems())

    def haskeys( self ):
        """Since keys() returns an iterator, this method is helpful in bypassing
           code that looks for the existence of any defined results names."""
        return bool(self.__tokdict)
        
    def pop( self, *args, **kwargs):
        """
        Removes and returns item at specified index (default=C{last}).
        Supports both C{list} and C{dict} semantics for C{pop()}. If passed no
        argument or an integer argument, it will use C{list} semantics
        and pop tokens from the list of parsed tokens. If passed a 
        non-integer argument (most likely a string), it will use C{dict}
        semantics and pop the corresponding value from any defined 
        results names. A second default return value argument is 
        supported, just as in C{dict.pop()}.

        Example::
            def remove_first(tokens):
                tokens.pop(0)
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            print(OneOrMore(Word(nums)).addParseAction(remove_first).parseString("0 123 321")) # -> ['123', '321']

            label = Word(alphas)
            patt = label("LABEL") + OneOrMore(Word(nums))
            print(patt.parseString("AAB 123 321").dump())

            # Use pop() in a parse action to remove named result (note that corresponding value is not
            # removed from list form of results)
            def remove_LABEL(tokens):
                tokens.pop("LABEL")
                return tokens
            patt.addParseAction(remove_LABEL)
            print(patt.parseString("AAB 123 321").dump())
        prints::
            ['AAB', '123', '321']
            - LABEL: AAB

            ['AAB', '123', '321']
        """
        if not args:
            args = [-1]
        for k,v in kwargs.items():
            if k == 'default':
                args = (args[0], v)
            else:
                raise TypeError("pop() got an unexpected keyword argument '%s'" % k)
        if (isinstance(args[0], int) or 
                        len(args) == 1 or 
                        args[0] in self):
            index = args[0]
            ret = self[index]
            del self[index]
            return ret
        else:
            defaultvalue = args[1]
            return defaultvalue

    def get(self, key, defaultValue=None):
        """
        Returns named result matching the given key, or if there is no
        such name, then returns the given C{defaultValue} or C{None} if no
        C{defaultValue} is specified.

        Similar to C{dict.get()}.
        
        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            result = date_str.parseString("1999/12/31")
            print(result.get("year")) # -> '1999'
            print(result.get("hour", "not specified")) # -> 'not specified'
            print(result.get("hour")) # -> None
        """
        if key in self:
            return self[key]
        else:
            return defaultValue

    def insert( self, index, insStr ):
        """
        Inserts new element at location index in the list of parsed tokens.
        
        Similar to C{list.insert()}.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']

            # use a parse action to insert the parse location in the front of the parsed results
            def insert_locn(locn, tokens):
                tokens.insert(0, locn)
            print(OneOrMore(Word(nums)).addParseAction(insert_locn).parseString("0 123 321")) # -> [0, '0', '123', '321']
        """
        self.__toklist.insert(index, insStr)
        # fixup indices in token dictionary
        for name,occurrences in self.__tokdict.items():
            for k, (value, position) in enumerate(occurrences):
                occurrences[k] = _ParseResultsWithOffset(value, position + (position > index))

    def append( self, item ):
        """
        Add single element to end of ParseResults list of elements.

        Example::
            print(OneOrMore(Word(nums)).parseString("0 123 321")) # -> ['0', '123', '321']
            
            # use a parse action to compute the sum of the parsed integers, and add it to the end
            def append_sum(tokens):
                tokens.append(sum(map(int, tokens)))
            print(OneOrMore(Word(nums)).addParseAction(append_sum).parseString("0 123 321")) # -> ['0', '123', '321', 444]
        """
        self.__toklist.append(item)

    def extend( self, itemseq ):
        """
        Add sequence of elements to end of ParseResults list of elements.

        Example::
            patt = OneOrMore(Word(alphas))
            
            # use a parse action to append the reverse of the matched strings, to make a palindrome
            def make_palindrome(tokens):
                tokens.extend(reversed([t[::-1] for t in tokens]))
                return ''.join(tokens)
            print(patt.addParseAction(make_palindrome).parseString("lskdj sdlkjf lksd")) # -> 'lskdjsdlkjflksddsklfjkldsjdksl'
        """
        if isinstance(itemseq, ParseResults):
            self += itemseq
        else:
            self.__toklist.extend(itemseq)

    def clear( self ):
        """
        Clear all elements and results names.
        """
        del self.__toklist[:]
        self.__tokdict.clear()

    def __getattr__( self, name ):
        try:
            return self[name]
        except KeyError:
            return ""
            
        if name in self.__tokdict:
            if name not in self.__accumNames:
                return self.__tokdict[name][-1][0]
            else:
                return ParseResults([ v[0] for v in self.__tokdict[name] ])
        else:
            return ""

    def __add__( self, other ):
        ret = self.copy()
        ret += other
        return ret

    def __iadd__( self, other ):
        if other.__tokdict:
            offset = len(self.__toklist)
            addoffset = lambda a: offset if a<0 else a+offset
            otheritems = other.__tokdict.items()
            otherdictitems = [(k, _ParseResultsWithOffset(v[0],addoffset(v[1])) )
                                for (k,vlist) in otheritems for v in vlist]
            for k,v in otherdictitems:
                self[k] = v
                if isinstance(v[0],ParseResults):
                    v[0].__parent = wkref(self)
            
        self.__toklist += other.__toklist
        self.__accumNames.update( other.__accumNames )
        return self

    def __radd__(self, other):
        if isinstance(other,int) and other == 0:
            # useful for merging many ParseResults using sum() builtin
            return self.copy()
        else:
            # this may raise a TypeError - so be it
            return other + self
        
    def __repr__( self ):
        return "(%s, %s)" % ( repr( self.__toklist ), repr( self.__tokdict ) )

    def __str__( self ):
        return '[' + ', '.join(_ustr(i) if isinstance(i, ParseResults) else repr(i) for i in self.__toklist) + ']'

    def _asStringList( self, sep='' ):
        out = []
        for item in self.__toklist:
            if out and sep:
                out.append(sep)
            if isinstance( item, ParseResults ):
                out += item._asStringList()
            else:
                out.append( _ustr(item) )
        return out

    def asList( self ):
        """
        Returns the parse results as a nested list of matching tokens, all converted to strings.

        Example::
            patt = OneOrMore(Word(alphas))
            result = patt.parseString("sldkj lsdkj sldkj")
            # even though the result prints in string-like form, it is actually a pyparsing ParseResults
            print(type(result), result) # -> <class 'pyparsing.ParseResults'> ['sldkj', 'lsdkj', 'sldkj']
            
            # Use asList() to create an actual list
            result_list = result.asList()
            print(type(result_list), result_list) # -> <class 'list'> ['sldkj', 'lsdkj', 'sldkj']
        """
        return [res.asList() if isinstance(res,ParseResults) else res for res in self.__toklist]

    def asDict( self ):
        """
        Returns the named parse results as a nested dictionary.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(type(result), repr(result)) # -> <class 'pyparsing.ParseResults'> (['12', '/', '31', '/', '1999'], {'day': [('1999', 4)], 'year': [('12', 0)], 'month': [('31', 2)]})
            
            result_dict = result.asDict()
            print(type(result_dict), repr(result_dict)) # -> <class 'dict'> {'day': '1999', 'year': '12', 'month': '31'}

            # even though a ParseResults supports dict-like access, sometime you just need to have a dict
            import json
            print(json.dumps(result)) # -> Exception: TypeError: ... is not JSON serializable
            print(json.dumps(result.asDict())) # -> {"month": "31", "day": "1999", "year": "12"}
        """
        if PY_3:
            item_fn = self.items
        else:
            item_fn = self.iteritems
            
        def toItem(obj):
            if isinstance(obj, ParseResults):
                if obj.haskeys():
                    return obj.asDict()
                else:
                    return [toItem(v) for v in obj]
            else:
                return obj
                
        return dict((k,toItem(v)) for k,v in item_fn())

    def copy( self ):
        """
        Returns a new copy of a C{ParseResults} object.
        """
        ret = ParseResults( self.__toklist )
        ret.__tokdict = self.__tokdict.copy()
        ret.__parent = self.__parent
        ret.__accumNames.update( self.__accumNames )
        ret.__name = self.__name
        return ret

    def asXML( self, doctag=None, namedItemsOnly=False, indent="", formatted=True ):
        """
        (Deprecated) Returns the parse results as XML. Tags are created for tokens and lists that have defined results names.
        """
        nl = "\n"
        out = []
        namedItems = dict((v[1],k) for (k,vlist) in self.__tokdict.items()
                                                            for v in vlist)
        nextLevelIndent = indent + "  "

        # collapse out indents if formatting is not desired
        if not formatted:
            indent = ""
            nextLevelIndent = ""
            nl = ""

        selfTag = None
        if doctag is not None:
            selfTag = doctag
        else:
            if self.__name:
                selfTag = self.__name

        if not selfTag:
            if namedItemsOnly:
                return ""
            else:
                selfTag = "ITEM"

        out += [ nl, indent, "<", selfTag, ">" ]

        for i,res in enumerate(self.__toklist):
            if isinstance(res,ParseResults):
                if i in namedItems:
                    out += [ res.asXML(namedItems[i],
                                        namedItemsOnly and doctag is None,
                                        nextLevelIndent,
                                        formatted)]
                else:
                    out += [ res.asXML(None,
                                        namedItemsOnly and doctag is None,
                                        nextLevelIndent,
                                        formatted)]
            else:
                # individual token, see if there is a name for it
                resTag = None
                if i in namedItems:
                    resTag = namedItems[i]
                if not resTag:
                    if namedItemsOnly:
                        continue
                    else:
                        resTag = "ITEM"
                xmlBodyText = _xml_escape(_ustr(res))
                out += [ nl, nextLevelIndent, "<", resTag, ">",
                                                xmlBodyText,
                                                "</", resTag, ">" ]

        out += [ nl, indent, "</", selfTag, ">" ]
        return "".join(out)

    def __lookup(self,sub):
        for k,vlist in self.__tokdict.items():
            for v,loc in vlist:
                if sub is v:
                    return k
        return None

    def getName(self):
        r"""
        Returns the results name for this token expression. Useful when several 
        different expressions might match at a particular location.

        Example::
            integer = Word(nums)
            ssn_expr = Regex(r"\d\d\d-\d\d-\d\d\d\d")
            house_number_expr = Suppress('#') + Word(nums, alphanums)
            user_data = (Group(house_number_expr)("house_number") 
                        | Group(ssn_expr)("ssn")
                        | Group(integer)("age"))
            user_info = OneOrMore(user_data)
            
            result = user_info.parseString("22 111-22-3333 #221B")
            for item in result:
                print(item.getName(), ':', item[0])
        prints::
            age : 22
            ssn : 111-22-3333
            house_number : 221B
        """
        if self.__name:
            return self.__name
        elif self.__parent:
            par = self.__parent()
            if par:
                return par.__lookup(self)
            else:
                return None
        elif (len(self) == 1 and
               len(self.__tokdict) == 1 and
               next(iter(self.__tokdict.values()))[0][1] in (0,-1)):
            return next(iter(self.__tokdict.keys()))
        else:
            return None

    def dump(self, indent='', depth=0, full=True):
        """
        Diagnostic method for listing out the contents of a C{ParseResults}.
        Accepts an optional C{indent} argument so that this string can be embedded
        in a nested display of other data.

        Example::
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
            
            result = date_str.parseString('12/31/1999')
            print(result.dump())
        prints::
            ['12', '/', '31', '/', '1999']
            - day: 1999
            - month: 31
            - year: 12
        """
        out = []
        NL = '\n'
        out.append( indent+_ustr(self.asList()) )
        if full:
            if self.haskeys():
                items = sorted((str(k), v) for k,v in self.items())
                for k,v in items:
                    if out:
                        out.append(NL)
                    out.append( "%s%s- %s: " % (indent,('  '*depth), k) )
                    if isinstance(v,ParseResults):
                        if v:
                            out.append( v.dump(indent,depth+1) )
                        else:
                            out.append(_ustr(v))
                    else:
                        out.append(repr(v))
            elif any(isinstance(vv,ParseResults) for vv in self):
                v = self
                for i,vv in enumerate(v):
                    if isinstance(vv,ParseResults):
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),vv.dump(indent,depth+1) ))
                    else:
                        out.append("\n%s%s[%d]:\n%s%s%s" % (indent,('  '*(depth)),i,indent,('  '*(depth+1)),_ustr(vv)))
            
        return "".join(out)

    def pprint(self, *args, **kwargs):
        """
        Pretty-printer for parsed results as a list, using the C{pprint} module.
        Accepts additional positional or keyword args as defined for the 
        C{pprint.pprint} method. (U{http://docs.python.org/3/library/pprint.html#pprint.pprint})

        Example::
            ident = Word(alphas, alphanums)
            num = Word(nums)
            func = Forward()
            term = ident | num | Group('(' + func + ')')
            func <<= ident + Group(Optional(delimitedList(term)))
            result = func.parseString("fna a,b,(fnb c,d,200),100")
            result.pprint(width=40)
        prints::
            ['fna',
             ['a',
              'b',
              ['(', 'fnb', ['c', 'd', '200'], ')'],
              '100']]
        """
        pprint.pprint(self.asList(), *args, **kwargs)

    # add support for pickle protocol
    def __getstate__(self):
        return ( self.__toklist,
                 ( self.__tokdict.copy(),
                   self.__parent is not None and self.__parent() or None,
                   self.__accumNames,
                   self.__name ) )

    def __setstate__(self,state):
        self.__toklist = state[0]
        (self.__tokdict,
         par,
         inAccumNames,
         self.__name) = state[1]
        self.__accumNames = {}
        self.__accumNames.update(inAccumNames)
        if par is not None:
            self.__parent = wkref(par)
        else:
            self.__parent = None

    def __getnewargs__(self):
        return self.__toklist, self.__name, self.__asList, self.__modal

    def __dir__(self):
        return (dir(type(self)) + list(self.keys()))

MutableMapping.register(ParseResults)

def col (loc,strg):
    """Returns current column within a string, counting newlines as line separators.
   The first column is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   """
    s = strg
    return 1 if 0<loc<len(s) and s[loc-1] == '\n' else loc - s.rfind("\n", 0, loc)

def lineno(loc,strg):
    """Returns current line number within a string, counting newlines as line separators.
   The first line is number 1.

   Note: the default parsing behavior is to expand tabs in the input string
   before starting the parsing process.  See L{I{ParserElement.parseString}<ParserElement.parseString>} for more information
   on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
   consistent view of the parsed string, the parse location, and line and column
   positions within the parsed string.
   """
    return strg.count("\n",0,loc) + 1

def line( loc, strg ):
    """Returns the line of text containing loc within a string, counting newlines as line separators.
       """
    lastCR = strg.rfind("\n", 0, loc)
    nextCR = strg.find("\n", loc)
    if nextCR >= 0:
        return strg[lastCR+1:nextCR]
    else:
        return strg[lastCR+1:]

def _defaultStartDebugAction( instring, loc, expr ):
    print (("Match " + _ustr(expr) + " at loc " + _ustr(loc) + "(%d,%d)" % ( lineno(loc,instring), col(loc,instring) )))

def _defaultSuccessDebugAction( instring, startloc, endloc, expr, toks ):
    print ("Matched " + _ustr(expr) + " -> " + str(toks.asList()))

def _defaultExceptionDebugAction( instring, loc, expr, exc ):
    print ("Exception raised:" + _ustr(exc))

def nullDebugAction(*args):
    """'Do-nothing' debug action, to suppress debugging output during parsing."""
    pass

# Only works on Python 3.x - nonlocal is toxic to Python 2 installs
#~ 'decorator to trim function calls to match the arity of the target'
#~ def _trim_arity(func, maxargs=3):
    #~ if func in singleArgBuiltins:
        #~ return lambda s,l,t: func(t)
    #~ limit = 0
    #~ foundArity = False
    #~ def wrapper(*args):
        #~ nonlocal limit,foundArity
        #~ while 1:
            #~ try:
                #~ ret = func(*args[limit:])
                #~ foundArity = True
                #~ return ret
            #~ except TypeError:
                #~ if limit == maxargs or foundArity:
                    #~ raise
                #~ limit += 1
                #~ continue
    #~ return wrapper

# this version is Python 2.x-3.x cross-compatible
'decorator to trim function calls to match the arity of the target'
def _trim_arity(func, maxargs=2):
    if func in singleArgBuiltins:
        return lambda s,l,t: func(t)
    limit = [0]
    foundArity = [False]
    
    # traceback return data structure changed in Py3.5 - normalize back to plain tuples
    if system_version[:2] >= (3,5):
        def extract_stack(limit=0):
            # special handling for Python 3.5.0 - extra deep call stack by 1
            offset = -3 if system_version == (3,5,0) else -2
            frame_summary = traceback.extract_stack(limit=-offset+limit-1)[offset]
            return [frame_summary[:2]]
        def extract_tb(tb, limit=0):
            frames = traceback.extract_tb(tb, limit=limit)
            frame_summary = frames[-1]
            return [frame_summary[:2]]
    else:
        extract_stack = traceback.extract_stack
        extract_tb = traceback.extract_tb
    
    # synthesize what would be returned by traceback.extract_stack at the call to 
    # user's parse action 'func', so that we don't incur call penalty at parse time
    
    LINE_DIFF = 6
    # IF ANY CODE CHANGES, EVEN JUST COMMENTS OR BLANK LINES, BETWEEN THE NEXT LINE AND 
    # THE CALL TO FUNC INSIDE WRAPPER, LINE_DIFF MUST BE MODIFIED!!!!
    this_line = extract_stack(limit=2)[-1]
    pa_call_line_synth = (this_line[0], this_line[1]+LINE_DIFF)

    def wrapper(*args):
        while 1:
            try:
                ret = func(*args[limit[0]:])
                foundArity[0] = True
                return ret
            except TypeError:
                # re-raise TypeErrors if they did not come from our arity testing
                if foundArity[0]:
                    raise
                else:
                    try:
                        tb = sys.exc_info()[-1]
                        if not extract_tb(tb, limit=2)[-1][:2] == pa_call_line_synth:
                            raise
                    finally:
                        del tb

                if limit[0] <= maxargs:
                    limit[0] += 1
                    continue
                raise

    # copy func name to wrapper for sensible debug output
    func_name = "<parse action>"
    try:
        func_name = getattr(func, '__name__', 
                            getattr(func, '__class__').__name__)
    except Exception:
        func_name = str(func)
    wrapper.__name__ = func_name

    return wrapper

class ParserElement(object):
    """Abstract base level parser element class."""
    DEFAULT_WHITE_CHARS = " \n\t\r"
    verbose_stacktrace = False

    @staticmethod
    def setDefaultWhitespaceChars( chars ):
        r"""
        Overrides the default whitespace chars

        Example::
            # default whitespace chars are space, <TAB> and newline
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def', 'ghi', 'jkl']
            
            # change to just treat newline as significant
            ParserElement.setDefaultWhitespaceChars(" \t")
            OneOrMore(Word(alphas)).parseString("abc def\nghi jkl")  # -> ['abc', 'def']
        """
        ParserElement.DEFAULT_WHITE_CHARS = chars

    @staticmethod
    def inlineLiteralsUsing(cls):
        """
        Set class to be used for inclusion of string literals into a parser.
        
        Example::
            # default literal class used is Literal
            integer = Word(nums)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']


            # change to Suppress
            ParserElement.inlineLiteralsUsing(Suppress)
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")           

            date_str.parseString("1999/12/31")  # -> ['1999', '12', '31']
        """
        ParserElement._literalStringClass = cls

    def __init__( self, savelist=False ):
        self.parseAction = list()
        self.failAction = None
        #~ self.name = "<unknown>"  # don't define self.name, let subclasses try/except upcall
        self.strRepr = None
        self.resultsName = None
        self.saveAsList = savelist
        self.skipWhitespace = True
        self.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
        self.copyDefaultWhiteChars = True
        self.mayReturnEmpty = False # used when checking for left-recursion
        self.keepTabs = False
        self.ignoreExprs = list()
        self.debug = False
        self.streamlined = False
        self.mayIndexError = True # used to optimize exception handling for subclasses that don't advance parse index
        self.errmsg = ""
        self.modalResults = True # used to mark results names as modal (report only last) or cumulative (list all)
        self.debugActions = ( None, None, None ) #custom debug actions
        self.re = None
        self.callPreparse = True # used to avoid redundant calls to preParse
        self.callDuringTry = False

    def copy( self ):
        """
        Make a copy of this C{ParserElement}.  Useful for defining different parse actions
        for the same parsing pattern, using copies of the original parse element.
        
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            integerK = integer.copy().addParseAction(lambda toks: toks[0]*1024) + Suppress("K")
            integerM = integer.copy().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
            
            print(OneOrMore(integerK | integerM | integer).parseString("5K 100 640K 256M"))
        prints::
            [5120, 100, 655360, 268435456]
        Equivalent form of C{expr.copy()} is just C{expr()}::
            integerM = integer().addParseAction(lambda toks: toks[0]*1024*1024) + Suppress("M")
        """
        cpy = copy.copy( self )
        cpy.parseAction = self.parseAction[:]
        cpy.ignoreExprs = self.ignoreExprs[:]
        if self.copyDefaultWhiteChars:
            cpy.whiteChars = ParserElement.DEFAULT_WHITE_CHARS
        return cpy

    def setName( self, name ):
        """
        Define name for this expression, makes debugging and exception messages clearer.
        
        Example::
            Word(nums).parseString("ABC")  # -> Exception: Expected W:(0123...) (at char 0), (line:1, col:1)
            Word(nums).setName("integer").parseString("ABC")  # -> Exception: Expected integer (at char 0), (line:1, col:1)
        """
        self.name = name
        self.errmsg = "Expected " + self.name
        if hasattr(self,"exception"):
            self.exception.msg = self.errmsg
        return self

    def setResultsName( self, name, listAllMatches=False ):
        """
        Define name for referencing matching tokens as a nested attribute
        of the returned parse results.
        NOTE: this returns a *copy* of the original C{ParserElement} object;
        this is so that the client can define a basic element, such as an
        integer, and reference it in multiple places with different names.

        You can also set results names using the abbreviated syntax,
        C{expr("name")} in place of C{expr.setResultsName("name")} - 
        see L{I{__call__}<__call__>}.

        Example::
            date_str = (integer.setResultsName("year") + '/' 
                        + integer.setResultsName("month") + '/' 
                        + integer.setResultsName("day"))

            # equivalent form:
            date_str = integer("year") + '/' + integer("month") + '/' + integer("day")
        """
        newself = self.copy()
        if name.endswith("*"):
            name = name[:-1]
            listAllMatches=True
        newself.resultsName = name
        newself.modalResults = not listAllMatches
        return newself

    def setBreak(self,breakFlag = True):
        """Method to invoke the Python pdb debugger when this element is
           about to be parsed. Set C{breakFlag} to True to enable, False to
           disable.
        """
        if breakFlag:
            _parseMethod = self._parse
            def breaker(instring, loc, doActions=True, callPreParse=True):
                import pdb
                pdb.set_trace()
                return _parseMethod( instring, loc, doActions, callPreParse )
            breaker._originalParseMethod = _parseMethod
            self._parse = breaker
        else:
            if hasattr(self._parse,"_originalParseMethod"):
                self._parse = self._parse._originalParseMethod
        return self

    def setParseAction( self, *fns, **kwargs ):
        """
        Define one or more actions to perform when successfully matching parse element definition.
        Parse action fn is a callable method with 0-3 arguments, called as C{fn(s,loc,toks)},
        C{fn(loc,toks)}, C{fn(toks)}, or just C{fn()}, where:
         - s   = the original string being parsed (see note below)
         - loc = the location of the matching substring
         - toks = a list of the matched tokens, packaged as a C{L{ParseResults}} object
        If the functions in fns modify the tokens, they can return them as the return
        value from fn, and the modified list of tokens will replace the original.
        Otherwise, fn does not need to return any value.

        Optional keyword arguments:
         - callDuringTry = (default=C{False}) indicate if parse action should be run during lookaheads and alternate testing

        Note: the default parsing behavior is to expand tabs in the input string
        before starting the parsing process.  See L{I{parseString}<parseString>} for more information
        on parsing strings containing C{<TAB>}s, and suggested methods to maintain a
        consistent view of the parsed string, the parse location, and line and column
        positions within the parsed string.
        
        Example::
            integer = Word(nums)
            date_str = integer + '/' + integer + '/' + integer

            date_str.parseString("1999/12/31")  # -> ['1999', '/', '12', '/', '31']

            # use parse action to convert to ints at parse time
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            date_str = integer + '/' + integer + '/' + integer

            # note that integer fields are now ints, not strings
            date_str.parseString("1999/12/31")  # -> [1999, '/', 12, '/', 31]
        """
        self.parseAction = list(map(_trim_arity, list(fns)))
        self.callDuringTry = kwargs.get("callDuringTry", False)
        return self

    def addParseAction( self, *fns, **kwargs ):
        """
        Add one or more parse actions to expression's list of parse actions. See L{I{setParseAction}<setParseAction>}.
        
        See examples in L{I{copy}<copy>}.
        """
        self.parseAction += list(map(_trim_arity, list(fns)))
        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
        return self

    def addCondition(self, *fns, **kwargs):
        """Add a boolean predicate function to expression's list of parse actions. See 
        L{I{setParseAction}<setParseAction>} for function call signatures. Unlike C{setParseAction}, 
        functions passed to C{addCondition} need to return boolean success/fail of the condition.

        Optional keyword arguments:
         - message = define a custom message to be used in the raised exception
         - fatal   = if True, will raise ParseFatalException to stop parsing immediately; otherwise will raise ParseException
         
        Example::
            integer = Word(nums).setParseAction(lambda toks: int(toks[0]))
            year_int = integer.copy()
            year_int.addCondition(lambda toks: toks[0] >= 2000, message="Only support years 2000 and later")
            date_str = year_int + '/' + integer + '/' + integer

            result = date_str.parseString("1999/12/31")  # -> Exception: Only support years 2000 and later (at char 0), (line:1, col:1)
        """
        msg = kwargs.get("message", "failed user-defined condition")
        exc_type = ParseFatalException if kwargs.get("fatal", False) else ParseException
        for fn in fns:
            def pa(s,l,t):
                if not bool(_trim_arity(fn)(s,l,t)):
                    raise exc_type(s,l,msg)
            self.parseAction.append(pa)
        self.callDuringTry = self.callDuringTry or kwargs.get("callDuringTry", False)
        return self

    def setFailAction( self, fn ):
        """Define action to perform if parsing fails at this expression.
           Fail acton fn is a callable function that takes the arguments
           C{fn(s,loc,expr,err)} where:
            - s = string being parsed
            - loc = location where expression match was attempted and failed
            - expr = the parse expression that failed
            - err = the exception thrown
           The function returns no value.  It may throw C{L{ParseFatalException}}
           if it is desired to stop parsing immediately."""
        self.failAction = fn
        return self

    def _skipIgnorables( self, instring, loc ):
        exprsFound = True
        while exprsFound:
            exprsFound = False
            for e in self.ignoreExprs:
                try:
                    while 1:
                        loc,dummy = e._parse( instring, loc )
                        exprsFound = True
                except ParseException:
                    pass
        return loc

    def preParse( self, instring, loc ):
        if self.ignoreExprs:
            loc = self._skipIgnorables( instring, loc )

        if self.skipWhitespace:
            wt = self.whiteChars
            instrlen = len(instring)
            while loc < instrlen and instring[loc] in wt:
                loc += 1

        return loc

    def parseImpl( self, instring, loc, doActions=True ):
        return loc, []

    def postParse( self, instring, loc, tokenlist ):
        return tokenlist

    #~ @profile
    def _parseNoCache( self, instring, loc, doActions=True, callPreParse=True ):
        debugging = ( self.debug ) #and doActions )

        if debugging or self.failAction:
            #~ print ("Match",self,"at loc",loc,"(%d,%d)" % ( lineno(loc,instring), col(loc,instring) ))
            if (self.debugActions[0] ):
                self.debugActions[0]( instring, loc, self )
            if callPreParse and self.callPreparse:
                preloc = self.preParse( instring, loc )
            else:
                preloc = loc
            tokensStart = preloc
            try:
                try:
                    loc,tokens = self.parseImpl( instring, preloc, doActions )
                except IndexError:
                    raise ParseException( instring, len(instring), self.errmsg, self )
            except ParseBaseException as err:
                #~ print ("Exception raised:", err)
                if self.debugActions[2]:
                    self.debugActions[2]( instring, tokensStart, self, err )
                if self.failAction:
                    self.failAction( instring, tokensStart, self, err )
                raise
        else:
            if callPreParse and self.callPreparse:
                preloc = self.preParse( instring, loc )
            else:
                preloc = loc
            tokensStart = preloc
            if self.mayIndexError or preloc >= len(instring):
                try:
                    loc,tokens = self.parseImpl( instring, preloc, doActions )
                except IndexError:
                    raise ParseException( instring, len(instring), self.errmsg, self )
            else:
                loc,tokens = self.parseImpl( instring, preloc, doActions )

        tokens = self.postParse( instring, loc, tokens )

        retTokens = ParseResults( tokens, self.resultsName, asList=self.saveAsList, modal=self.modalResults )
        if self.parseAction and (doActions or self.callDuringTry):
            if debugging:
                try:
                    for fn in self.parseAction:
                        tokens = fn( instring, tokensStart, retTokens )
                        if tokens is not None:
                            retTokens = ParseResults( tokens,
                                                      self.resultsName,
                                                      asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
                                                      modal=self.modalResults )
                except ParseBaseException as err:
                    #~ print "Exception raised in user parse action:", err
                    if (self.debugActions[2] ):
                        self.debugActions[2]( instring, tokensStart, self, err )
                    raise
            else:
                for fn in self.parseAction:
                    tokens = fn( instring, tokensStart, retTokens )
                    if tokens is not None:
                        retTokens = ParseResults( tokens,
                                                  self.resultsName,
                                                  asList=self.saveAsList and isinstance(tokens,(ParseResults,list)),
                                                  modal=self.modalResults )
        if debugging:
            #~ print ("Matched",self,"->",retTokens.asList())
            if (self.debugActions[1] ):
                self.debugActions[1]( instring, tokensStart, loc, self, retTokens )

        return loc, retTokens

    def tryParse( self, instring, loc ):
        try:
            return self._parse( instring, loc, doActions=False )[0]
        except ParseFatalException:
            raise ParseException( instring, loc, self.errmsg, self)
    
    def canParseNext(self, instring, loc):
        try:
            self.tryParse(instring, loc)
        except (ParseException, IndexError):
            return False
        else:
            return True

    class _UnboundedCache(object):
        def __init__(self):
            cache = {}
            self.not_in_cache = not_in_cache = object()

            def get(self, key):
                return cache.get(key, not_in_cache)

            def set(self, key, value):
                cache[key] = value

            def clear(self):
                cache.clear()
                
            def cache_len(self):
                return len(cache)

            self.get = types.MethodType(get, self)
            self.set = types.MethodType(set, self)
            self.clear = types.MethodType(clear, self)
            self.__len__ = types.MethodType(cache_len, self)

    if _OrderedDict is not None:
        class _FifoCache(object):
            def __init__(self, size):
                self.not_in_cache = not_in_cache = object()

                cache = _OrderedDict()

                def get(self, key):
                    return cache.get(key, not_in_cache)

                def set(self, key, value):
                    cache[key] = value
                    while len(cache) > size:
                        try:
                            cache.popitem(False)
                        except KeyError:
                            pass

                def clear(self):
                    cache.clear()

                def cache_len(self):
                    return len(cache)

                self.get = types.MethodType(get, self)
                self.set = types.MethodType(set, self)
                self.clear = types.MethodType(clear, self)
                self.__len__ = types.MethodType(cache_len, self)

    else:
        class _FifoCache(object):
            def __init__(self, size):
                self.not_in_cache = not_in_cache = object()

                cache = {}
                key_fifo = collections.deque([], size)

                def get(self, key):
                    return cache.get(key, not_in_cache)

                def set(self, key, value):
                    cache[key] = value
                    while len(key_fifo) > size:
                        cache.pop(key_fifo.popleft(), None)
                    key_fifo.append(key)

                def clear(self):
                    cache.clear()
                    key_fifo.clear()

                def cache_len(self):
                    return len(cache)

                self.get = types.MethodType(get, self)
                self.set = types.MethodType(set, self)
                self.clear = types.MethodType(clear, self)
                self.__len__ = types.MethodType(cache_len, self)

    # argument cache for optimizing repeated calls when backtracking through recursive expressions
    packrat_cache = {} # this is set later by enabledPackrat(); this is here so that resetCache() doesn't fail
    packrat_cache_lock = RLock()
    packrat_cache_stats = [0, 0]

    # this method gets repeatedly called during backtracking with the same arguments -
    # we can cache these arguments and save ourselves the trouble of re-parsing the contained expression
    def _parseCache( self, instring, loc, doActions=True, callPreParse=True ):
        HIT, MISS = 0, 1
        lookup = (self, instring, loc, callPreParse, doActions)
        with ParserElement.packrat_cache_lock:
            cache = ParserElement.packrat_cache
            value = cache.get(lookup)
            if value is cache.not_in_cache:
                ParserElement.packrat_cache_stats[MISS] += 1
                try:
                    value = self._parseNoCache(instring, loc, doActions, callPreParse)
                except ParseBaseException as pe:
                    # cache a copy of the exception, without the traceback
                    cache.set(lookup, pe.__class__(*pe.args))
                    raise
                else:
                    cache.set(lookup, (value[0], value[1].copy()))
                    return value
            else:
                ParserElement.packrat_cache_stats[HIT] += 1
                if isinstance(value, Exception):
                    raise value
                return (value[0], value[1].copy())

    _parse = _parseNoCache

    @staticmethod
    def resetCache():
        ParserElement.packrat_cache.clear()
        ParserElement.packrat_cache_stats[:] = [0] * len(ParserElement.packrat_cache_stats)

    _packratEnabled = False
    @staticmethod
    def enablePackrat(cache_size_limit=128):
        """Enables "packrat" parsing, which adds memoizing to the parsing logic.
           Repeated parse attempts at the same string location (which happens
           often in many complex grammars) can immediately return a cached value,
           instead of re-executing parsing/validating code.  Memoizing is done of
           both valid results and parsing exceptions.
           
           Parameters:
            - cache_size_limit - (default=C{128}) - if an integer value is provided
              will limit the size of the packrat cache; if None is passed, then
              the cache size will be unbounded; if 0 is passed, the cache will
              be effectively disabled.
            
           This speedup may break existing programs that use parse actions that
           have side-effects.  For this reason, packrat parsing is disabled when
           you first import pyparsing.  To activate the packrat feature, your
           program must call the class method C{ParserElement.enablePackrat()}.  If
           your program uses C{psyco} to "compile as you go", you must call
           C{enablePackrat} before calling C{psyco.full()}.  If you do not do this,
           Python will crash.  For best results, call C{enablePackrat()} immediately
           after importing pyparsing.
           
           Example::
               import pyparsing
               pyparsing.ParserElement.enablePackrat()
        """
        if not ParserElement._packratEnabled:
            ParserElement._packratEnabled = True
            if cache_size_limit is None:
                ParserElement.packrat_cache = ParserElement._UnboundedCache()
            else:
                ParserElement.packrat_cache = ParserElement._FifoCache(cache_size_limit)
            ParserElement._parse = ParserElement._parseCache

    def parseString( self, instring, parseAll=False ):
        """
        Execute the parse expression with the given string.
        This is the main interface to the client code, once the complete
        expression has been built.

        If you want the grammar to require that the entire input string be
        successfully parsed, then set C{parseAll} to True (equivalent to ending
        the grammar with C{L{StringEnd()}}).

        Note: C{parseString} implicitly calls C{expandtabs()} on the input string,
        in order to report proper column numbers in parse actions.
        If the input string contains tabs and
        the grammar uses parse actions that use the C{loc} argument to index into the
        string being parsed, you can ensure you have a consistent view of the input
        string by:
         - calling C{parseWithTabs} on your grammar before calling C{parseString}
           (see L{I{parseWithTabs}<parseWithTabs>})
         - define your parse action using the full C{(s,loc,toks)} signature, and
           reference the input string using the parse action's C{s} argument
         - explictly expand the tabs in your input string before calling
           C{parseString}
        
        Example::
            Word('a').parseString('aaaaabaaa')  # -> ['aaaaa']
            Word('a').parseString('aaaaabaaa', parseAll=True)  # -> Exception: Expected end of text
        """
        ParserElement.resetCache()
        if not self.streamlined:
            self.streamline()
            #~ self.saveAsList = True
        for e in self.ignoreExprs:
            e.streamline()
        if not self.keepTabs:
            instring = instring.expandtabs()
        try:
            loc, tokens = self._parse( instring, 0 )
            if parseAll:
                loc = self.preParse( instring, loc )
                se = Empty() + StringEnd()
                se._parse( instring, loc )
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc
        else:
            return tokens

    def scanString( self, instring, maxMatches=_MAX_INT, overlap=False ):
        """
        Scan the input string for expression matches.  Each match will return the
        matching tokens, start location, and end location.  May be called with optional
        C{maxMatches} argument, to clip scanning after 'n' matches are found.  If
        C{overlap} is specified, then overlapping matches will be reported.

        Note that the start and end locations are reported relative to the string
        being parsed.  See L{I{parseString}<parseString>} for more information on parsing
        strings with embedded tabs.

        Example::
            source = "sldjf123lsdjjkf345sldkjf879lkjsfd987"
            print(source)
            for tokens,start,end in Word(alphas).scanString(source):
                print(' '*start + '^'*(end-start))
                print(' '*start + tokens[0])
        
        prints::
        
            sldjf123lsdjjkf345sldkjf879lkjsfd987
            ^^^^^
            sldjf
                    ^^^^^^^
                    lsdjjkf
                              ^^^^^^
                              sldkjf
                                       ^^^^^^
                                       lkjsfd
        """
        if not self.streamlined:
            self.streamline()
        for e in self.ignoreExprs:
            e.streamline()

        if not self.keepTabs:
            instring = _ustr(instring).expandtabs()
        instrlen = len(instring)
        loc = 0
        preparseFn = self.preParse
        parseFn = self._parse
        ParserElement.resetCache()
        matches = 0
        try:
            while loc <= instrlen and matches < maxMatches:
                try:
                    preloc = preparseFn( instring, loc )
                    nextLoc,tokens = parseFn( instring, preloc, callPreParse=False )
                except ParseException:
                    loc = preloc+1
                else:
                    if nextLoc > loc:
                        matches += 1
                        yield tokens, preloc, nextLoc
                        if overlap:
                            nextloc = preparseFn( instring, loc )
                            if nextloc > loc:
                                loc = nextLoc
                            else:
                                loc += 1
                        else:
                            loc = nextLoc
                    else:
                        loc = preloc+1
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def transformString( self, instring ):
        """
        Extension to C{L{scanString}}, to modify matching text with modified tokens that may
        be returned from a parse action.  To use C{transformString}, define a grammar and
        attach a parse action to it that modifies the returned token list.
        Invoking C{transformString()} on a target string will then scan for matches,
        and replace the matched text patterns according to the logic in the parse
        action.  C{transformString()} returns the resulting transformed string.
        
        Example::
            wd = Word(alphas)
            wd.setParseAction(lambda toks: toks[0].title())
            
            print(wd.transformString("now is the winter of our discontent made glorious summer by this sun of york."))
        Prints::
            Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York.
        """
        out = []
        lastE = 0
        # force preservation of <TAB>s, to minimize unwanted transformation of string, and to
        # keep string locs straight between transformString and scanString
        self.keepTabs = True
        try:
            for t,s,e in self.scanString( instring ):
                out.append( instring[lastE:s] )
                if t:
                    if isinstance(t,ParseResults):
                        out += t.asList()
                    elif isinstance(t,list):
                        out += t
                    else:
                        out.append(t)
                lastE = e
            out.append(instring[lastE:])
            out = [o for o in out if o]
            return "".join(map(_ustr,_flatten(out)))
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def searchString( self, instring, maxMatches=_MAX_INT ):
        """
        Another extension to C{L{scanString}}, simplifying the access to the tokens found
        to match the given parse expression.  May be called with optional
        C{maxMatches} argument, to clip searching after 'n' matches are found.
        
        Example::
            # a capitalized word starts with an uppercase letter, followed by zero or more lowercase letters
            cap_word = Word(alphas.upper(), alphas.lower())
            
            print(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity"))

            # the sum() builtin can be used to merge results into a single ParseResults object
            print(sum(cap_word.searchString("More than Iron, more than Lead, more than Gold I need Electricity")))
        prints::
            [['More'], ['Iron'], ['Lead'], ['Gold'], ['I'], ['Electricity']]
            ['More', 'Iron', 'Lead', 'Gold', 'I', 'Electricity']
        """
        try:
            return ParseResults([ t for t,s,e in self.scanString( instring, maxMatches ) ])
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def split(self, instring, maxsplit=_MAX_INT, includeSeparators=False):
        """
        Generator method to split a string using the given expression as a separator.
        May be called with optional C{maxsplit} argument, to limit the number of splits;
        and the optional C{includeSeparators} argument (default=C{False}), if the separating
        matching text should be included in the split results.
        
        Example::        
            punc = oneOf(list(".,;:/-!?"))
            print(list(punc.split("This, this?, this sentence, is badly punctuated!")))
        prints::
            ['This', ' this', '', ' this sentence', ' is badly punctuated', '']
        """
        splits = 0
        last = 0
        for t,s,e in self.scanString(instring, maxMatches=maxsplit):
            yield instring[last:s]
            if includeSeparators:
                yield t[0]
            last = e
        yield instring[last:]

    def __add__(self, other ):
        """
        Implementation of + operator - returns C{L{And}}. Adding strings to a ParserElement
        converts them to L{Literal}s by default.
        
        Example::
            greet = Word(alphas) + "," + Word(alphas) + "!"
            hello = "Hello, World!"
            print (hello, "->", greet.parseString(hello))
        Prints::
            Hello, World! -> ['Hello', ',', 'World', '!']
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return And( [ self, other ] )

    def __radd__(self, other ):
        """
        Implementation of + operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other + self

    def __sub__(self, other):
        """
        Implementation of - operator, returns C{L{And}} with error stop
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return self + And._ErrorStop() + other

    def __rsub__(self, other ):
        """
        Implementation of - operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other - self

    def __mul__(self,other):
        """
        Implementation of * operator, allows use of C{expr * 3} in place of
        C{expr + expr + expr}.  Expressions may also me multiplied by a 2-integer
        tuple, similar to C{{min,max}} multipliers in regular expressions.  Tuples
        may also include C{None} as in:
         - C{expr*(n,None)} or C{expr*(n,)} is equivalent
              to C{expr*n + L{ZeroOrMore}(expr)}
              (read as "at least n instances of C{expr}")
         - C{expr*(None,n)} is equivalent to C{expr*(0,n)}
              (read as "0 to n instances of C{expr}")
         - C{expr*(None,None)} is equivalent to C{L{ZeroOrMore}(expr)}
         - C{expr*(1,None)} is equivalent to C{L{OneOrMore}(expr)}

        Note that C{expr*(None,n)} does not raise an exception if
        more than n exprs exist in the input stream; that is,
        C{expr*(None,n)} does not enforce a maximum number of expr
        occurrences.  If this behavior is desired, then write
        C{expr*(None,n) + ~expr}
        """
        if isinstance(other,int):
            minElements, optElements = other,0
        elif isinstance(other,tuple):
            other = (other + (None, None))[:2]
            if other[0] is None:
                other = (0, other[1])
            if isinstance(other[0],int) and other[1] is None:
                if other[0] == 0:
                    return ZeroOrMore(self)
                if other[0] == 1:
                    return OneOrMore(self)
                else:
                    return self*other[0] + ZeroOrMore(self)
            elif isinstance(other[0],int) and isinstance(other[1],int):
                minElements, optElements = other
                optElements -= minElements
            else:
                raise TypeError("cannot multiply 'ParserElement' and ('%s','%s') objects", type(other[0]),type(other[1]))
        else:
            raise TypeError("cannot multiply 'ParserElement' and '%s' objects", type(other))

        if minElements < 0:
            raise ValueError("cannot multiply ParserElement by negative value")
        if optElements < 0:
            raise ValueError("second tuple value must be greater or equal to first tuple value")
        if minElements == optElements == 0:
            raise ValueError("cannot multiply ParserElement by 0 or (0,0)")

        if (optElements):
            def makeOptionalList(n):
                if n>1:
                    return Optional(self + makeOptionalList(n-1))
                else:
                    return Optional(self)
            if minElements:
                if minElements == 1:
                    ret = self + makeOptionalList(optElements)
                else:
                    ret = And([self]*minElements) + makeOptionalList(optElements)
            else:
                ret = makeOptionalList(optElements)
        else:
            if minElements == 1:
                ret = self
            else:
                ret = And([self]*minElements)
        return ret

    def __rmul__(self, other):
        return self.__mul__(other)

    def __or__(self, other ):
        """
        Implementation of | operator - returns C{L{MatchFirst}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return MatchFirst( [ self, other ] )

    def __ror__(self, other ):
        """
        Implementation of | operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other | self

    def __xor__(self, other ):
        """
        Implementation of ^ operator - returns C{L{Or}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return Or( [ self, other ] )

    def __rxor__(self, other ):
        """
        Implementation of ^ operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other ^ self

    def __and__(self, other ):
        """
        Implementation of & operator - returns C{L{Each}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return Each( [ self, other ] )

    def __rand__(self, other ):
        """
        Implementation of & operator when left operand is not a C{L{ParserElement}}
        """
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        if not isinstance( other, ParserElement ):
            warnings.warn("Cannot combine element of type %s with ParserElement" % type(other),
                    SyntaxWarning, stacklevel=2)
            return None
        return other & self

    def __invert__( self ):
        """
        Implementation of ~ operator - returns C{L{NotAny}}
        """
        return NotAny( self )

    def __call__(self, name=None):
        """
        Shortcut for C{L{setResultsName}}, with C{listAllMatches=False}.
        
        If C{name} is given with a trailing C{'*'} character, then C{listAllMatches} will be
        passed as C{True}.
           
        If C{name} is omitted, same as calling C{L{copy}}.

        Example::
            # these are equivalent
            userdata = Word(alphas).setResultsName("name") + Word(nums+"-").setResultsName("socsecno")
            userdata = Word(alphas)("name") + Word(nums+"-")("socsecno")             
        """
        if name is not None:
            return self.setResultsName(name)
        else:
            return self.copy()

    def suppress( self ):
        """
        Suppresses the output of this C{ParserElement}; useful to keep punctuation from
        cluttering up returned output.
        """
        return Suppress( self )

    def leaveWhitespace( self ):
        """
        Disables the skipping of whitespace before matching the characters in the
        C{ParserElement}'s defined pattern.  This is normally only used internally by
        the pyparsing module, but may be needed in some whitespace-sensitive grammars.
        """
        self.skipWhitespace = False
        return self

    def setWhitespaceChars( self, chars ):
        """
        Overrides the default whitespace chars
        """
        self.skipWhitespace = True
        self.whiteChars = chars
        self.copyDefaultWhiteChars = False
        return self

    def parseWithTabs( self ):
        """
        Overrides default behavior to expand C{<TAB>}s to spaces before parsing the input string.
        Must be called before C{parseString} when the input grammar contains elements that
        match C{<TAB>} characters.
        """
        self.keepTabs = True
        return self

    def ignore( self, other ):
        """
        Define expression to be ignored (e.g., comments) while doing pattern
        matching; may be called repeatedly, to define multiple comment or other
        ignorable patterns.
        
        Example::
            patt = OneOrMore(Word(alphas))
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj']
            
            patt.ignore(cStyleComment)
            patt.parseString('ablaj /* comment */ lskjd') # -> ['ablaj', 'lskjd']
        """
        if isinstance(other, basestring):
            other = Suppress(other)

        if isinstance( other, Suppress ):
            if other not in self.ignoreExprs:
                self.ignoreExprs.append(other)
        else:
            self.ignoreExprs.append( Suppress( other.copy() ) )
        return self

    def setDebugActions( self, startAction, successAction, exceptionAction ):
        """
        Enable display of debugging messages while doing pattern matching.
        """
        self.debugActions = (startAction or _defaultStartDebugAction,
                             successAction or _defaultSuccessDebugAction,
                             exceptionAction or _defaultExceptionDebugAction)
        self.debug = True
        return self

    def setDebug( self, flag=True ):
        """
        Enable display of debugging messages while doing pattern matching.
        Set C{flag} to True to enable, False to disable.

        Example::
            wd = Word(alphas).setName("alphaword")
            integer = Word(nums).setName("numword")
            term = wd | integer
            
            # turn on debugging for wd
            wd.setDebug()

            OneOrMore(term).parseString("abc 123 xyz 890")
        
        prints::
            Match alphaword at loc 0(1,1)
            Matched alphaword -> ['abc']
            Match alphaword at loc 3(1,4)
            Exception raised:Expected alphaword (at char 4), (line:1, col:5)
            Match alphaword at loc 7(1,8)
            Matched alphaword -> ['xyz']
            Match alphaword at loc 11(1,12)
            Exception raised:Expected alphaword (at char 12), (line:1, col:13)
            Match alphaword at loc 15(1,16)
            Exception raised:Expected alphaword (at char 15), (line:1, col:16)

        The output shown is that produced by the default debug actions - custom debug actions can be
        specified using L{setDebugActions}. Prior to attempting
        to match the C{wd} expression, the debugging message C{"Match <exprname> at loc <n>(<line>,<col>)"}
        is shown. Then if the parse succeeds, a C{"Matched"} message is shown, or an C{"Exception raised"}
        message is shown. Also note the use of L{setName} to assign a human-readable name to the expression,
        which makes debugging and exception messages easier to understand - for instance, the default
        name created for the C{Word} expression without calling C{setName} is C{"W:(ABCD...)"}.
        """
        if flag:
            self.setDebugActions( _defaultStartDebugAction, _defaultSuccessDebugAction, _defaultExceptionDebugAction )
        else:
            self.debug = False
        return self

    def __str__( self ):
        return self.name

    def __repr__( self ):
        return _ustr(self)

    def streamline( self ):
        self.streamlined = True
        self.strRepr = None
        return self

    def checkRecursion( self, parseElementList ):
        pass

    def validate( self, validateTrace=[] ):
        """
        Check defined expressions for valid structure, check for infinite recursive definitions.
        """
        self.checkRecursion( [] )

    def parseFile( self, file_or_filename, parseAll=False ):
        """
        Execute the parse expression on the given file or filename.
        If a filename is specified (instead of a file object),
        the entire file is opened, read, and closed before parsing.
        """
        try:
            file_contents = file_or_filename.read()
        except AttributeError:
            with open(file_or_filename, "r") as f:
                file_contents = f.read()
        try:
            return self.parseString(file_contents, parseAll)
        except ParseBaseException as exc:
            if ParserElement.verbose_stacktrace:
                raise
            else:
                # catch and re-raise exception from here, clears out pyparsing internal stack trace
                raise exc

    def __eq__(self,other):
        if isinstance(other, ParserElement):
            return self is other or vars(self) == vars(other)
        elif isinstance(other, basestring):
            return self.matches(other)
        else:
            return super(ParserElement,self)==other

    def __ne__(self,other):
        return not (self == other)

    def __hash__(self):
        return hash(id(self))

    def __req__(self,other):
        return self == other

    def __rne__(self,other):
        return not (self == other)

    def matches(self, testString, parseAll=True):
        """
        Method for quick testing of a parser against a test string. Good for simple 
        inline microtests of sub expressions while building up larger parser.
           
        Parameters:
         - testString - to test against this expression for a match
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests
            
        Example::
            expr = Word(nums)
            assert expr.matches("100")
        """
        try:
            self.parseString(_ustr(testString), parseAll=parseAll)
            return True
        except ParseBaseException:
            return False
                
    def runTests(self, tests, parseAll=True, comment='#', fullDump=True, printResults=True, failureTests=False):
        """
        Execute the parse expression on a series of test strings, showing each
        test, the parsed results or where the parse failed. Quick and easy way to
        run a parse expression against a list of sample strings.
           
        Parameters:
         - tests - a list of separate test strings, or a multiline string of test strings
         - parseAll - (default=C{True}) - flag to pass to C{L{parseString}} when running tests           
         - comment - (default=C{'#'}) - expression for indicating embedded comments in the test 
              string; pass None to disable comment filtering
         - fullDump - (default=C{True}) - dump results as list followed by results names in nested outline;
              if False, only dump nested list
         - printResults - (default=C{True}) prints test output to stdout
         - failureTests - (default=C{False}) indicates if these tests are expected to fail parsing

        Returns: a (success, results) tuple, where success indicates that all tests succeeded
        (or failed if C{failureTests} is True), and the results contain a list of lines of each 
        test's output
        
        Example::
            number_expr = pyparsing_common.number.copy()

            result = number_expr.runTests('''
                # unsigned integer
                100
                # negative integer
                -100
                # float with scientific notation
                6.02e23
                # integer with scientific notation
                1e-12
                ''')
            print("Success" if result[0] else "Failed!")

            result = number_expr.runTests('''
                # stray character
                100Z
                # missing leading digit before '.'
                -.100
                # too many '.'
                3.14.159
                ''', failureTests=True)
            print("Success" if result[0] else "Failed!")
        prints::
            # unsigned integer
            100
            [100]

            # negative integer
            -100
            [-100]

            # float with scientific notation
            6.02e23
            [6.02e+23]

            # integer with scientific notation
            1e-12
            [1e-12]

            Success
            
            # stray character
            100Z
               ^
            FAIL: Expected end of text (at char 3), (line:1, col:4)

            # missing leading digit before '.'
            -.100
            ^
            FAIL: Expected {real number with scientific notation | real number | signed integer} (at char 0), (line:1, col:1)

            # too many '.'
            3.14.159
                ^
            FAIL: Expected end of text (at char 4), (line:1, col:5)

            Success

        Each test string must be on a single line. If you want to test a string that spans multiple
        lines, create a test like this::

            expr.runTest(r"this is a test\\n of strings that spans \\n 3 lines")
        
        (Note that this is a raw string literal, you must include the leading 'r'.)
        """
        if isinstance(tests, basestring):
            tests = list(map(str.strip, tests.rstrip().splitlines()))
        if isinstance(comment, basestring):
            comment = Literal(comment)
        allResults = []
        comments = []
        success = True
        for t in tests:
            if comment is not None and comment.matches(t, False) or comments and not t:
                comments.append(t)
                continue
            if not t:
                continue
            out = ['\n'.join(comments), t]
            comments = []
            try:
                t = t.replace(r'\n','\n')
                result = self.parseString(t, parseAll=parseAll)
                out.append(result.dump(full=fullDump))
                success = success and not failureTests
            except ParseBaseException as pe:
                fatal = "(FATAL)" if isinstance(pe, ParseFatalException) else ""
                if '\n' in t:
                    out.append(line(pe.loc, t))
                    out.append(' '*(col(pe.loc,t)-1) + '^' + fatal)
                else:
                    out.append(' '*pe.loc + '^' + fatal)
                out.append("FAIL: " + str(pe))
                success = success and failureTests
                result = pe
            except Exception as exc:
                out.append("FAIL-EXCEPTION: " + str(exc))
                success = success and failureTests
                result = exc

            if printResults:
                if fullDump:
                    out.append('')
                print('\n'.join(out))

            allResults.append((t, result))
        
        return success, allResults

        
class Token(ParserElement):
    """
    Abstract C{ParserElement} subclass, for defining atomic matching patterns.
    """
    def __init__( self ):
        super(Token,self).__init__( savelist=False )


class Empty(Token):
    """
    An empty token, will always match.
    """
    def __init__( self ):
        super(Empty,self).__init__()
        self.name = "Empty"
        self.mayReturnEmpty = True
        self.mayIndexError = False


class NoMatch(Token):
    """
    A token that will never match.
    """
    def __init__( self ):
        super(NoMatch,self).__init__()
        self.name = "NoMatch"
        self.mayReturnEmpty = True
        self.mayIndexError = False
        self.errmsg = "Unmatchable token"

    def parseImpl( self, instring, loc, doActions=True ):
        raise ParseException(instring, loc, self.errmsg, self)


class Literal(Token):
    """
    Token to exactly match a specified string.
    
    Example::
        Literal('blah').parseString('blah')  # -> ['blah']
        Literal('blah').parseString('blahfooblah')  # -> ['blah']
        Literal('blah').parseString('bla')  # -> Exception: Expected "blah"
    
    For case-insensitive matching, use L{CaselessLiteral}.
    
    For keyword matching (force word break before and after the matched string),
    use L{Keyword} or L{CaselessKeyword}.
    """
    def __init__( self, matchString ):
        super(Literal,self).__init__()
        self.match = matchString
        self.matchLen = len(matchString)
        try:
            self.firstMatchChar = matchString[0]
        except IndexError:
            warnings.warn("null string passed to Literal; use Empty() instead",
                            SyntaxWarning, stacklevel=2)
            self.__class__ = Empty
        self.name = '"%s"' % _ustr(self.match)
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = False
        self.mayIndexError = False

    # Performance tuning: this routine gets called a *lot*
    # if this is a single character match string  and the first character matches,
    # short-circuit as quickly as possible, and avoid calling startswith
    #~ @profile
    def parseImpl( self, instring, loc, doActions=True ):
        if (instring[loc] == self.firstMatchChar and
            (self.matchLen==1 or instring.startswith(self.match,loc)) ):
            return loc+self.matchLen, self.match
        raise ParseException(instring, loc, self.errmsg, self)
_L = Literal
ParserElement._literalStringClass = Literal

class Keyword(Token):
    """
    Token to exactly match a specified string as a keyword, that is, it must be
    immediately followed by a non-keyword character.  Compare with C{L{Literal}}:
     - C{Literal("if")} will match the leading C{'if'} in C{'ifAndOnlyIf'}.
     - C{Keyword("if")} will not; it will only match the leading C{'if'} in C{'if x=1'}, or C{'if(y==2)'}
    Accepts two optional constructor arguments in addition to the keyword string:
     - C{identChars} is a string of characters that would be valid identifier characters,
          defaulting to all alphanumerics + "_" and "$"
     - C{caseless} allows case-insensitive matching, default is C{False}.
       
    Example::
        Keyword("start").parseString("start")  # -> ['start']
        Keyword("start").parseString("starting")  # -> Exception

    For case-insensitive matching, use L{CaselessKeyword}.
    """
    DEFAULT_KEYWORD_CHARS = alphanums+"_$"

    def __init__( self, matchString, identChars=None, caseless=False ):
        super(Keyword,self).__init__()
        if identChars is None:
            identChars = Keyword.DEFAULT_KEYWORD_CHARS
        self.match = matchString
        self.matchLen = len(matchString)
        try:
            self.firstMatchChar = matchString[0]
        except IndexError:
            warnings.warn("null string passed to Keyword; use Empty() instead",
                            SyntaxWarning, stacklevel=2)
        self.name = '"%s"' % self.match
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = False
        self.mayIndexError = False
        self.caseless = caseless
        if caseless:
            self.caselessmatch = matchString.upper()
            identChars = identChars.upper()
        self.identChars = set(identChars)

    def parseImpl( self, instring, loc, doActions=True ):
        if self.caseless:
            if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
                 (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) and
                 (loc == 0 or instring[loc-1].upper() not in self.identChars) ):
                return loc+self.matchLen, self.match
        else:
            if (instring[loc] == self.firstMatchChar and
                (self.matchLen==1 or instring.startswith(self.match,loc)) and
                (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen] not in self.identChars) and
                (loc == 0 or instring[loc-1] not in self.identChars) ):
                return loc+self.matchLen, self.match
        raise ParseException(instring, loc, self.errmsg, self)

    def copy(self):
        c = super(Keyword,self).copy()
        c.identChars = Keyword.DEFAULT_KEYWORD_CHARS
        return c

    @staticmethod
    def setDefaultKeywordChars( chars ):
        """Overrides the default Keyword chars
        """
        Keyword.DEFAULT_KEYWORD_CHARS = chars

class CaselessLiteral(Literal):
    """
    Token to match a specified string, ignoring case of letters.
    Note: the matched results will always be in the case of the given
    match string, NOT the case of the input text.

    Example::
        OneOrMore(CaselessLiteral("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD', 'CMD']
        
    (Contrast with example for L{CaselessKeyword}.)
    """
    def __init__( self, matchString ):
        super(CaselessLiteral,self).__init__( matchString.upper() )
        # Preserve the defining literal.
        self.returnString = matchString
        self.name = "'%s'" % self.returnString
        self.errmsg = "Expected " + self.name

    def parseImpl( self, instring, loc, doActions=True ):
        if instring[ loc:loc+self.matchLen ].upper() == self.match:
            return loc+self.matchLen, self.returnString
        raise ParseException(instring, loc, self.errmsg, self)

class CaselessKeyword(Keyword):
    """
    Caseless version of L{Keyword}.

    Example::
        OneOrMore(CaselessKeyword("CMD")).parseString("cmd CMD Cmd10") # -> ['CMD', 'CMD']
        
    (Contrast with example for L{CaselessLiteral}.)
    """
    def __init__( self, matchString, identChars=None ):
        super(CaselessKeyword,self).__init__( matchString, identChars, caseless=True )

    def parseImpl( self, instring, loc, doActions=True ):
        if ( (instring[ loc:loc+self.matchLen ].upper() == self.caselessmatch) and
             (loc >= len(instring)-self.matchLen or instring[loc+self.matchLen].upper() not in self.identChars) ):
            return loc+self.matchLen, self.match
        raise ParseException(instring, loc, self.errmsg, self)

class CloseMatch(Token):
    """
    A variation on L{Literal} which matches "close" matches, that is, 
    strings with at most 'n' mismatching characters. C{CloseMatch} takes parameters:
     - C{match_string} - string to be matched
     - C{maxMismatches} - (C{default=1}) maximum number of mismatches allowed to count as a match
    
    The results from a successful parse will contain the matched text from the input string and the following named results:
     - C{mismatches} - a list of the positions within the match_string where mismatches were found
     - C{original} - the original match_string used to compare against the input string
    
    If C{mismatches} is an empty list, then the match was an exact match.
    
    Example::
        patt = CloseMatch("ATCATCGAATGGA")
        patt.parseString("ATCATCGAAXGGA") # -> (['ATCATCGAAXGGA'], {'mismatches': [[9]], 'original': ['ATCATCGAATGGA']})
        patt.parseString("ATCAXCGAAXGGA") # -> Exception: Expected 'ATCATCGAATGGA' (with up to 1 mismatches) (at char 0), (line:1, col:1)

        # exact match
        patt.parseString("ATCATCGAATGGA") # -> (['ATCATCGAATGGA'], {'mismatches': [[]], 'original': ['ATCATCGAATGGA']})

        # close match allowing up to 2 mismatches
        patt = CloseMatch("ATCATCGAATGGA", maxMismatches=2)
        patt.parseString("ATCAXCGAAXGGA") # -> (['ATCAXCGAAXGGA'], {'mismatches': [[4, 9]], 'original': ['ATCATCGAATGGA']})
    """
    def __init__(self, match_string, maxMismatches=1):
        super(CloseMatch,self).__init__()
        self.name = match_string
        self.match_string = match_string
        self.maxMismatches = maxMismatches
        self.errmsg = "Expected %r (with up to %d mismatches)" % (self.match_string, self.maxMismatches)
        self.mayIndexError = False
        self.mayReturnEmpty = False

    def parseImpl( self, instring, loc, doActions=True ):
        start = loc
        instrlen = len(instring)
        maxloc = start + len(self.match_string)

        if maxloc <= instrlen:
            match_string = self.match_string
            match_stringloc = 0
            mismatches = []
            maxMismatches = self.maxMismatches

            for match_stringloc,s_m in enumerate(zip(instring[loc:maxloc], self.match_string)):
                src,mat = s_m
                if src != mat:
                    mismatches.append(match_stringloc)
                    if len(mismatches) > maxMismatches:
                        break
            else:
                loc = match_stringloc + 1
                results = ParseResults([instring[start:loc]])
                results['original'] = self.match_string
                results['mismatches'] = mismatches
                return loc, results

        raise ParseException(instring, loc, self.errmsg, self)


class Word(Token):
    """
    Token for matching words composed of allowed character sets.
    Defined with string containing all allowed initial characters,
    an optional string containing allowed body characters (if omitted,
    defaults to the initial character set), and an optional minimum,
    maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction. An optional
    C{excludeChars} parameter can list characters that might be found in 
    the input C{bodyChars} string; useful to define a word of all printables
    except for one or two characters, for instance.
    
    L{srange} is useful for defining custom character set strings for defining 
    C{Word} expressions, using range notation from regular expression character sets.
    
    A common mistake is to use C{Word} to match a specific literal string, as in 
    C{Word("Address")}. Remember that C{Word} uses the string argument to define
    I{sets} of matchable characters. This expression would match "Add", "AAA",
    "dAred", or any other word made up of the characters 'A', 'd', 'r', 'e', and 's'.
    To match an exact literal string, use L{Literal} or L{Keyword}.

    pyparsing includes helper strings for building Words:
     - L{alphas}
     - L{nums}
     - L{alphanums}
     - L{hexnums}
     - L{alphas8bit} (alphabetic characters in ASCII range 128-255 - accented, tilded, umlauted, etc.)
     - L{punc8bit} (non-alphabetic characters in ASCII range 128-255 - currency, symbols, superscripts, diacriticals, etc.)
     - L{printables} (any non-whitespace character)

    Example::
        # a word composed of digits
        integer = Word(nums) # equivalent to Word("0123456789") or Word(srange("0-9"))
        
        # a word with a leading capital, and zero or more lowercase
        capital_word = Word(alphas.upper(), alphas.lower())

        # hostnames are alphanumeric, with leading alpha, and '-'
        hostname = Word(alphas, alphanums+'-')
        
        # roman numeral (not a strict parser, accepts invalid mix of characters)
        roman = Word("IVXLCDM")
        
        # any string of non-whitespace characters, except for ','
        csv_value = Word(printables, excludeChars=",")
    """
    def __init__( self, initChars, bodyChars=None, min=1, max=0, exact=0, asKeyword=False, excludeChars=None ):
        super(Word,self).__init__()
        if excludeChars:
            initChars = ''.join(c for c in initChars if c not in excludeChars)
            if bodyChars:
                bodyChars = ''.join(c for c in bodyChars if c not in excludeChars)
        self.initCharsOrig = initChars
        self.initChars = set(initChars)
        if bodyChars :
            self.bodyCharsOrig = bodyChars
            self.bodyChars = set(bodyChars)
        else:
            self.bodyCharsOrig = initChars
            self.bodyChars = set(initChars)

        self.maxSpecified = max > 0

        if min < 1:
            raise ValueError("cannot specify a minimum length < 1; use Optional(Word()) if zero-length word is permitted")

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.asKeyword = asKeyword

        if ' ' not in self.initCharsOrig+self.bodyCharsOrig and (min==1 and max==0 and exact==0):
            if self.bodyCharsOrig == self.initCharsOrig:
                self.reString = "[%s]+" % _escapeRegexRangeChars(self.initCharsOrig)
            elif len(self.initCharsOrig) == 1:
                self.reString = "%s[%s]*" % \
                                      (re.escape(self.initCharsOrig),
                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
            else:
                self.reString = "[%s][%s]*" % \
                                      (_escapeRegexRangeChars(self.initCharsOrig),
                                      _escapeRegexRangeChars(self.bodyCharsOrig),)
            if self.asKeyword:
                self.reString = r"\b"+self.reString+r"\b"
            try:
                self.re = re.compile( self.reString )
            except Exception:
                self.re = None

    def parseImpl( self, instring, loc, doActions=True ):
        if self.re:
            result = self.re.match(instring,loc)
            if not result:
                raise ParseException(instring, loc, self.errmsg, self)

            loc = result.end()
            return loc, result.group()

        if not(instring[ loc ] in self.initChars):
            raise ParseException(instring, loc, self.errmsg, self)

        start = loc
        loc += 1
        instrlen = len(instring)
        bodychars = self.bodyChars
        maxloc = start + self.maxLen
        maxloc = min( maxloc, instrlen )
        while loc < maxloc and instring[loc] in bodychars:
            loc += 1

        throwException = False
        if loc - start < self.minLen:
            throwException = True
        if self.maxSpecified and loc < instrlen and instring[loc] in bodychars:
            throwException = True
        if self.asKeyword:
            if (start>0 and instring[start-1] in bodychars) or (loc<instrlen and instring[loc] in bodychars):
                throwException = True

        if throwException:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]

    def __str__( self ):
        try:
            return super(Word,self).__str__()
        except Exception:
            pass


        if self.strRepr is None:

            def charsAsStr(s):
                if len(s)>4:
                    return s[:4]+"..."
                else:
                    return s

            if ( self.initCharsOrig != self.bodyCharsOrig ):
                self.strRepr = "W:(%s,%s)" % ( charsAsStr(self.initCharsOrig), charsAsStr(self.bodyCharsOrig) )
            else:
                self.strRepr = "W:(%s)" % charsAsStr(self.initCharsOrig)

        return self.strRepr


class Regex(Token):
    r"""
    Token for matching strings that match a given regular expression.
    Defined with string specifying the regular expression in a form recognized by the inbuilt Python re module.
    If the given regex contains named groups (defined using C{(?P<name>...)}), these will be preserved as 
    named parse results.

    Example::
        realnum = Regex(r"[+-]?\d+\.\d*")
        date = Regex(r'(?P<year>\d{4})-(?P<month>\d\d?)-(?P<day>\d\d?)')
        # ref: http://stackoverflow.com/questions/267399/how-do-you-match-only-valid-roman-numerals-with-a-regular-expression
        roman = Regex(r"M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})")
    """
    compiledREtype = type(re.compile("[A-Z]"))
    def __init__( self, pattern, flags=0):
        """The parameters C{pattern} and C{flags} are passed to the C{re.compile()} function as-is. See the Python C{re} module for an explanation of the acceptable patterns and flags."""
        super(Regex,self).__init__()

        if isinstance(pattern, basestring):
            if not pattern:
                warnings.warn("null string passed to Regex; use Empty() instead",
                        SyntaxWarning, stacklevel=2)

            self.pattern = pattern
            self.flags = flags

            try:
                self.re = re.compile(self.pattern, self.flags)
                self.reString = self.pattern
            except sre_constants.error:
                warnings.warn("invalid pattern (%s) passed to Regex" % pattern,
                    SyntaxWarning, stacklevel=2)
                raise

        elif isinstance(pattern, Regex.compiledREtype):
            self.re = pattern
            self.pattern = \
            self.reString = str(pattern)
            self.flags = flags
            
        else:
            raise ValueError("Regex may only be constructed with a string or a compiled RE object")

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        result = self.re.match(instring,loc)
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        d = result.groupdict()
        ret = ParseResults(result.group())
        if d:
            for k in d:
                ret[k] = d[k]
        return loc,ret

    def __str__( self ):
        try:
            return super(Regex,self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "Re:(%s)" % repr(self.pattern)

        return self.strRepr


class QuotedString(Token):
    r"""
    Token for matching strings that are delimited by quoting characters.
    
    Defined with the following parameters:
        - quoteChar - string of one or more characters defining the quote delimiting string
        - escChar - character to escape quotes, typically backslash (default=C{None})
        - escQuote - special quote sequence to escape an embedded quote string (such as SQL's "" to escape an embedded ") (default=C{None})
        - multiline - boolean indicating whether quotes can span multiple lines (default=C{False})
        - unquoteResults - boolean indicating whether the matched text should be unquoted (default=C{True})
        - endQuoteChar - string of one or more characters defining the end of the quote delimited string (default=C{None} => same as quoteChar)
        - convertWhitespaceEscapes - convert escaped whitespace (C{'\t'}, C{'\n'}, etc.) to actual whitespace (default=C{True})

    Example::
        qs = QuotedString('"')
        print(qs.searchString('lsjdf "This is the quote" sldjf'))
        complex_qs = QuotedString('{{', endQuoteChar='}}')
        print(complex_qs.searchString('lsjdf {{This is the "quote"}} sldjf'))
        sql_qs = QuotedString('"', escQuote='""')
        print(sql_qs.searchString('lsjdf "This is the quote with ""embedded"" quotes" sldjf'))
    prints::
        [['This is the quote']]
        [['This is the "quote"']]
        [['This is the quote with "embedded" quotes']]
    """
    def __init__( self, quoteChar, escChar=None, escQuote=None, multiline=False, unquoteResults=True, endQuoteChar=None, convertWhitespaceEscapes=True):
        super(QuotedString,self).__init__()

        # remove white space from quote chars - wont work anyway
        quoteChar = quoteChar.strip()
        if not quoteChar:
            warnings.warn("quoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
            raise SyntaxError()

        if endQuoteChar is None:
            endQuoteChar = quoteChar
        else:
            endQuoteChar = endQuoteChar.strip()
            if not endQuoteChar:
                warnings.warn("endQuoteChar cannot be the empty string",SyntaxWarning,stacklevel=2)
                raise SyntaxError()

        self.quoteChar = quoteChar
        self.quoteCharLen = len(quoteChar)
        self.firstQuoteChar = quoteChar[0]
        self.endQuoteChar = endQuoteChar
        self.endQuoteCharLen = len(endQuoteChar)
        self.escChar = escChar
        self.escQuote = escQuote
        self.unquoteResults = unquoteResults
        self.convertWhitespaceEscapes = convertWhitespaceEscapes

        if multiline:
            self.flags = re.MULTILINE | re.DOTALL
            self.pattern = r'%s(?:[^%s%s]' % \
                ( re.escape(self.quoteChar),
                  _escapeRegexRangeChars(self.endQuoteChar[0]),
                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
        else:
            self.flags = 0
            self.pattern = r'%s(?:[^%s\n\r%s]' % \
                ( re.escape(self.quoteChar),
                  _escapeRegexRangeChars(self.endQuoteChar[0]),
                  (escChar is not None and _escapeRegexRangeChars(escChar) or '') )
        if len(self.endQuoteChar) > 1:
            self.pattern += (
                '|(?:' + ')|(?:'.join("%s[^%s]" % (re.escape(self.endQuoteChar[:i]),
                                               _escapeRegexRangeChars(self.endQuoteChar[i]))
                                    for i in range(len(self.endQuoteChar)-1,0,-1)) + ')'
                )
        if escQuote:
            self.pattern += (r'|(?:%s)' % re.escape(escQuote))
        if escChar:
            self.pattern += (r'|(?:%s.)' % re.escape(escChar))
            self.escCharReplacePattern = re.escape(self.escChar)+"(.)"
        self.pattern += (r')*%s' % re.escape(self.endQuoteChar))

        try:
            self.re = re.compile(self.pattern, self.flags)
            self.reString = self.pattern
        except sre_constants.error:
            warnings.warn("invalid pattern (%s) passed to Regex" % self.pattern,
                SyntaxWarning, stacklevel=2)
            raise

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayIndexError = False
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        result = instring[loc] == self.firstQuoteChar and self.re.match(instring,loc) or None
        if not result:
            raise ParseException(instring, loc, self.errmsg, self)

        loc = result.end()
        ret = result.group()

        if self.unquoteResults:

            # strip off quotes
            ret = ret[self.quoteCharLen:-self.endQuoteCharLen]

            if isinstance(ret,basestring):
                # replace escaped whitespace
                if '\\' in ret and self.convertWhitespaceEscapes:
                    ws_map = {
                        r'\t' : '\t',
                        r'\n' : '\n',
                        r'\f' : '\f',
                        r'\r' : '\r',
                    }
                    for wslit,wschar in ws_map.items():
                        ret = ret.replace(wslit, wschar)

                # replace escaped characters
                if self.escChar:
                    ret = re.sub(self.escCharReplacePattern, r"\g<1>", ret)

                # replace escaped quotes
                if self.escQuote:
                    ret = ret.replace(self.escQuote, self.endQuoteChar)

        return loc, ret

    def __str__( self ):
        try:
            return super(QuotedString,self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "quoted string, starting with %s ending with %s" % (self.quoteChar, self.endQuoteChar)

        return self.strRepr


class CharsNotIn(Token):
    """
    Token for matching words composed of characters I{not} in a given set (will
    include whitespace in matched characters if not listed in the provided exclusion set - see example).
    Defined with string containing all disallowed characters, and an optional
    minimum, maximum, and/or exact length.  The default value for C{min} is 1 (a
    minimum value < 1 is not valid); the default values for C{max} and C{exact}
    are 0, meaning no maximum or exact length restriction.

    Example::
        # define a comma-separated-value as anything that is not a ','
        csv_value = CharsNotIn(',')
        print(delimitedList(csv_value).parseString("dkls,lsdkjf,s12 34,@!#,213"))
    prints::
        ['dkls', 'lsdkjf', 's12 34', '@!#', '213']
    """
    def __init__( self, notChars, min=1, max=0, exact=0 ):
        super(CharsNotIn,self).__init__()
        self.skipWhitespace = False
        self.notChars = notChars

        if min < 1:
            raise ValueError("cannot specify a minimum length < 1; use Optional(CharsNotIn()) if zero-length char group is permitted")

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

        self.name = _ustr(self)
        self.errmsg = "Expected " + self.name
        self.mayReturnEmpty = ( self.minLen == 0 )
        self.mayIndexError = False

    def parseImpl( self, instring, loc, doActions=True ):
        if instring[loc] in self.notChars:
            raise ParseException(instring, loc, self.errmsg, self)

        start = loc
        loc += 1
        notchars = self.notChars
        maxlen = min( start+self.maxLen, len(instring) )
        while loc < maxlen and \
              (instring[loc] not in notchars):
            loc += 1

        if loc - start < self.minLen:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]

    def __str__( self ):
        try:
            return super(CharsNotIn, self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            if len(self.notChars) > 4:
                self.strRepr = "!W:(%s...)" % self.notChars[:4]
            else:
                self.strRepr = "!W:(%s)" % self.notChars

        return self.strRepr

class White(Token):
    """
    Special matching class for matching whitespace.  Normally, whitespace is ignored
    by pyparsing grammars.  This class is included when some whitespace structures
    are significant.  Define with a string containing the whitespace characters to be
    matched; default is C{" \\t\\r\\n"}.  Also takes optional C{min}, C{max}, and C{exact} arguments,
    as defined for the C{L{Word}} class.
    """
    whiteStrs = {
        " " : "<SPC>",
        "\t": "<TAB>",
        "\n": "<LF>",
        "\r": "<CR>",
        "\f": "<FF>",
        }
    def __init__(self, ws=" \t\r\n", min=1, max=0, exact=0):
        super(White,self).__init__()
        self.matchWhite = ws
        self.setWhitespaceChars( "".join(c for c in self.whiteChars if c not in self.matchWhite) )
        #~ self.leaveWhitespace()
        self.name = ("".join(White.whiteStrs[c] for c in self.matchWhite))
        self.mayReturnEmpty = True
        self.errmsg = "Expected " + self.name

        self.minLen = min

        if max > 0:
            self.maxLen = max
        else:
            self.maxLen = _MAX_INT

        if exact > 0:
            self.maxLen = exact
            self.minLen = exact

    def parseImpl( self, instring, loc, doActions=True ):
        if not(instring[ loc ] in self.matchWhite):
            raise ParseException(instring, loc, self.errmsg, self)
        start = loc
        loc += 1
        maxloc = start + self.maxLen
        maxloc = min( maxloc, len(instring) )
        while loc < maxloc and instring[loc] in self.matchWhite:
            loc += 1

        if loc - start < self.minLen:
            raise ParseException(instring, loc, self.errmsg, self)

        return loc, instring[start:loc]


class _PositionToken(Token):
    def __init__( self ):
        super(_PositionToken,self).__init__()
        self.name=self.__class__.__name__
        self.mayReturnEmpty = True
        self.mayIndexError = False

class GoToColumn(_PositionToken):
    """
    Token to advance to a specific column of input text; useful for tabular report scraping.
    """
    def __init__( self, colno ):
        super(GoToColumn,self).__init__()
        self.col = colno

    def preParse( self, instring, loc ):
        if col(loc,instring) != self.col:
            instrlen = len(instring)
            if self.ignoreExprs:
                loc = self._skipIgnorables( instring, loc )
            while loc < instrlen and instring[loc].isspace() and col( loc, instring ) != self.col :
                loc += 1
        return loc

    def parseImpl( self, instring, loc, doActions=True ):
        thiscol = col( loc, instring )
        if thiscol > self.col:
            raise ParseException( instring, loc, "Text not in expected column", self )
        newloc = loc + self.col - thiscol
        ret = instring[ loc: newloc ]
        return newloc, ret


class LineStart(_PositionToken):
    """
    Matches if current position is at the beginning of a line within the parse string
    
    Example::
    
        test = '''\
        AAA this line
        AAA and this line
          AAA but not this one
        B AAA and definitely not this one
        '''

        for t in (LineStart() + 'AAA' + restOfLine).searchString(test):
            print(t)
    
    Prints::
        ['AAA', ' this line']
        ['AAA', ' and this line']    

    """
    def __init__( self ):
        super(LineStart,self).__init__()
        self.errmsg = "Expected start of line"

    def parseImpl( self, instring, loc, doActions=True ):
        if col(loc, instring) == 1:
            return loc, []
        raise ParseException(instring, loc, self.errmsg, self)

class LineEnd(_PositionToken):
    """
    Matches if current position is at the end of a line within the parse string
    """
    def __init__( self ):
        super(LineEnd,self).__init__()
        self.setWhitespaceChars( ParserElement.DEFAULT_WHITE_CHARS.replace("\n","") )
        self.errmsg = "Expected end of line"

    def parseImpl( self, instring, loc, doActions=True ):
        if loc<len(instring):
            if instring[loc] == "\n":
                return loc+1, "\n"
            else:
                raise ParseException(instring, loc, self.errmsg, self)
        elif loc == len(instring):
            return loc+1, []
        else:
            raise ParseException(instring, loc, self.errmsg, self)

class StringStart(_PositionToken):
    """
    Matches if current position is at the beginning of the parse string
    """
    def __init__( self ):
        super(StringStart,self).__init__()
        self.errmsg = "Expected start of text"

    def parseImpl( self, instring, loc, doActions=True ):
        if loc != 0:
            # see if entire string up to here is just whitespace and ignoreables
            if loc != self.preParse( instring, 0 ):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

class StringEnd(_PositionToken):
    """
    Matches if current position is at the end of the parse string
    """
    def __init__( self ):
        super(StringEnd,self).__init__()
        self.errmsg = "Expected end of text"

    def parseImpl( self, instring, loc, doActions=True ):
        if loc < len(instring):
            raise ParseException(instring, loc, self.errmsg, self)
        elif loc == len(instring):
            return loc+1, []
        elif loc > len(instring):
            return loc, []
        else:
            raise ParseException(instring, loc, self.errmsg, self)

class WordStart(_PositionToken):
    """
    Matches if the current position is at the beginning of a Word, and
    is not preceded by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
    use C{WordStart(alphanums)}. C{WordStart} will also match at the beginning of
    the string being parsed, or at the beginning of a line.
    """
    def __init__(self, wordChars = printables):
        super(WordStart,self).__init__()
        self.wordChars = set(wordChars)
        self.errmsg = "Not at the start of a word"

    def parseImpl(self, instring, loc, doActions=True ):
        if loc != 0:
            if (instring[loc-1] in self.wordChars or
                instring[loc] not in self.wordChars):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

class WordEnd(_PositionToken):
    """
    Matches if the current position is at the end of a Word, and
    is not followed by any character in a given set of C{wordChars}
    (default=C{printables}). To emulate the C{\b} behavior of regular expressions,
    use C{WordEnd(alphanums)}. C{WordEnd} will also match at the end of
    the string being parsed, or at the end of a line.
    """
    def __init__(self, wordChars = printables):
        super(WordEnd,self).__init__()
        self.wordChars = set(wordChars)
        self.skipWhitespace = False
        self.errmsg = "Not at the end of a word"

    def parseImpl(self, instring, loc, doActions=True ):
        instrlen = len(instring)
        if instrlen>0 and loc<instrlen:
            if (instring[loc] in self.wordChars or
                instring[loc-1] not in self.wordChars):
                raise ParseException(instring, loc, self.errmsg, self)
        return loc, []


class ParseExpression(ParserElement):
    """
    Abstract subclass of ParserElement, for combining and post-processing parsed tokens.
    """
    def __init__( self, exprs, savelist = False ):
        super(ParseExpression,self).__init__(savelist)
        if isinstance( exprs, _generatorType ):
            exprs = list(exprs)

        if isinstance( exprs, basestring ):
            self.exprs = [ ParserElement._literalStringClass( exprs ) ]
        elif isinstance( exprs, Iterable ):
            exprs = list(exprs)
            # if sequence of strings provided, wrap with Literal
            if all(isinstance(expr, basestring) for expr in exprs):
                exprs = map(ParserElement._literalStringClass, exprs)
            self.exprs = list(exprs)
        else:
            try:
                self.exprs = list( exprs )
            except TypeError:
                self.exprs = [ exprs ]
        self.callPreparse = False

    def __getitem__( self, i ):
        return self.exprs[i]

    def append( self, other ):
        self.exprs.append( other )
        self.strRepr = None
        return self

    def leaveWhitespace( self ):
        """Extends C{leaveWhitespace} defined in base class, and also invokes C{leaveWhitespace} on
           all contained expressions."""
        self.skipWhitespace = False
        self.exprs = [ e.copy() for e in self.exprs ]
        for e in self.exprs:
            e.leaveWhitespace()
        return self

    def ignore( self, other ):
        if isinstance( other, Suppress ):
            if other not in self.ignoreExprs:
                super( ParseExpression, self).ignore( other )
                for e in self.exprs:
                    e.ignore( self.ignoreExprs[-1] )
        else:
            super( ParseExpression, self).ignore( other )
            for e in self.exprs:
                e.ignore( self.ignoreExprs[-1] )
        return self

    def __str__( self ):
        try:
            return super(ParseExpression,self).__str__()
        except Exception:
            pass

        if self.strRepr is None:
            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.exprs) )
        return self.strRepr

    def streamline( self ):
        super(ParseExpression,self).streamline()

        for e in self.exprs:
            e.streamline()

        # collapse nested And's of the form And( And( And( a,b), c), d) to And( a,b,c,d )
        # but only if there are no parse actions or resultsNames on the nested And's
        # (likewise for Or's and MatchFirst's)
        if ( len(self.exprs) == 2 ):
            other = self.exprs[0]
            if ( isinstance( other, self.__class__ ) and
                  not(other.parseAction) and
                  other.resultsName is None and
                  not other.debug ):
                self.exprs = other.exprs[:] + [ self.exprs[1] ]
                self.strRepr = None
                self.mayReturnEmpty |= other.mayReturnEmpty
                self.mayIndexError  |= other.mayIndexError

            other = self.exprs[-1]
            if ( isinstance( other, self.__class__ ) and
                  not(other.parseAction) and
                  other.resultsName is None and
                  not other.debug ):
                self.exprs = self.exprs[:-1] + other.exprs[:]
                self.strRepr = None
                self.mayReturnEmpty |= other.mayReturnEmpty
                self.mayIndexError  |= other.mayIndexError

        self.errmsg = "Expected " + _ustr(self)
        
        return self

    def setResultsName( self, name, listAllMatches=False ):
        ret = super(ParseExpression,self).setResultsName(name,listAllMatches)
        return ret

    def validate( self, validateTrace=[] ):
        tmp = validateTrace[:]+[self]
        for e in self.exprs:
            e.validate(tmp)
        self.checkRecursion( [] )
        
    def copy(self):
        ret = super(ParseExpression,self).copy()
        ret.exprs = [e.copy() for e in self.exprs]
        return ret

class And(ParseExpression):
    """
    Requires all given C{ParseExpression}s to be found in the given order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'+'} operator.
    May also be constructed using the C{'-'} operator, which will suppress backtracking.

    Example::
        integer = Word(nums)
        name_expr = OneOrMore(Word(alphas))

        expr = And([integer("id"),name_expr("name"),integer("age")])
        # more easily written as:
        expr = integer("id") + name_expr("name") + integer("age")
    """

    class _ErrorStop(Empty):
        def __init__(self, *args, **kwargs):
            super(And._ErrorStop,self).__init__(*args, **kwargs)
            self.name = '-'
            self.leaveWhitespace()

    def __init__( self, exprs, savelist = True ):
        super(And,self).__init__(exprs, savelist)
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        self.setWhitespaceChars( self.exprs[0].whiteChars )
        self.skipWhitespace = self.exprs[0].skipWhitespace
        self.callPreparse = True

    def parseImpl( self, instring, loc, doActions=True ):
        # pass False as last arg to _parse for first element, since we already
        # pre-parsed the string as part of our And pre-parsing
        loc, resultlist = self.exprs[0]._parse( instring, loc, doActions, callPreParse=False )
        errorStop = False
        for e in self.exprs[1:]:
            if isinstance(e, And._ErrorStop):
                errorStop = True
                continue
            if errorStop:
                try:
                    loc, exprtokens = e._parse( instring, loc, doActions )
                except ParseSyntaxException:
                    raise
                except ParseBaseException as pe:
                    pe.__traceback__ = None
                    raise ParseSyntaxException._from_exception(pe)
                except IndexError:
                    raise ParseSyntaxException(instring, len(instring), self.errmsg, self)
            else:
                loc, exprtokens = e._parse( instring, loc, doActions )
            if exprtokens or exprtokens.haskeys():
                resultlist += exprtokens
        return loc, resultlist

    def __iadd__(self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        return self.append( other ) #And( [ self, other ] )

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )
            if not e.mayReturnEmpty:
                break

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr


class Or(ParseExpression):
    """
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the expression that matches the longest string will be used.
    May be constructed using the C{'^'} operator.

    Example::
        # construct Or using '^' operator
        
        number = Word(nums) ^ Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789"))
    prints::
        [['123'], ['3.1416'], ['789']]
    """
    def __init__( self, exprs, savelist = False ):
        super(Or,self).__init__(exprs, savelist)
        if self.exprs:
            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
        else:
            self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        maxExcLoc = -1
        maxException = None
        matches = []
        for e in self.exprs:
            try:
                loc2 = e.tryParse( instring, loc )
            except ParseException as err:
                err.__traceback__ = None
                if err.loc > maxExcLoc:
                    maxException = err
                    maxExcLoc = err.loc
            except IndexError:
                if len(instring) > maxExcLoc:
                    maxException = ParseException(instring,len(instring),e.errmsg,self)
                    maxExcLoc = len(instring)
            else:
                # save match among all matches, to retry longest to shortest
                matches.append((loc2, e))

        if matches:
            matches.sort(key=lambda x: -x[0])
            for _,e in matches:
                try:
                    return e._parse( instring, loc, doActions )
                except ParseException as err:
                    err.__traceback__ = None
                    if err.loc > maxExcLoc:
                        maxException = err
                        maxExcLoc = err.loc

        if maxException is not None:
            maxException.msg = self.errmsg
            raise maxException
        else:
            raise ParseException(instring, loc, "no defined alternatives to match", self)


    def __ixor__(self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        return self.append( other ) #Or( [ self, other ] )

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " ^ ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )


class MatchFirst(ParseExpression):
    """
    Requires that at least one C{ParseExpression} is found.
    If two expressions match, the first one listed is the one that will match.
    May be constructed using the C{'|'} operator.

    Example::
        # construct MatchFirst using '|' operator
        
        # watch the order of expressions to match
        number = Word(nums) | Combine(Word(nums) + '.' + Word(nums))
        print(number.searchString("123 3.1416 789")) #  Fail! -> [['123'], ['3'], ['1416'], ['789']]

        # put more selective expression first
        number = Combine(Word(nums) + '.' + Word(nums)) | Word(nums)
        print(number.searchString("123 3.1416 789")) #  Better -> [['123'], ['3.1416'], ['789']]
    """
    def __init__( self, exprs, savelist = False ):
        super(MatchFirst,self).__init__(exprs, savelist)
        if self.exprs:
            self.mayReturnEmpty = any(e.mayReturnEmpty for e in self.exprs)
        else:
            self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        maxExcLoc = -1
        maxException = None
        for e in self.exprs:
            try:
                ret = e._parse( instring, loc, doActions )
                return ret
            except ParseException as err:
                if err.loc > maxExcLoc:
                    maxException = err
                    maxExcLoc = err.loc
            except IndexError:
                if len(instring) > maxExcLoc:
                    maxException = ParseException(instring,len(instring),e.errmsg,self)
                    maxExcLoc = len(instring)

        # only got here if no expression matched, raise exception for match that made it the furthest
        else:
            if maxException is not None:
                maxException.msg = self.errmsg
                raise maxException
            else:
                raise ParseException(instring, loc, "no defined alternatives to match", self)

    def __ior__(self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass( other )
        return self.append( other ) #MatchFirst( [ self, other ] )

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " | ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )


class Each(ParseExpression):
    """
    Requires all given C{ParseExpression}s to be found, but in any order.
    Expressions may be separated by whitespace.
    May be constructed using the C{'&'} operator.

    Example::
        color = oneOf("RED ORANGE YELLOW GREEN BLUE PURPLE BLACK WHITE BROWN")
        shape_type = oneOf("SQUARE CIRCLE TRIANGLE STAR HEXAGON OCTAGON")
        integer = Word(nums)
        shape_attr = "shape:" + shape_type("shape")
        posn_attr = "posn:" + Group(integer("x") + ',' + integer("y"))("posn")
        color_attr = "color:" + color("color")
        size_attr = "size:" + integer("size")

        # use Each (using operator '&') to accept attributes in any order 
        # (shape and posn are required, color and size are optional)
        shape_spec = shape_attr & posn_attr & Optional(color_attr) & Optional(size_attr)

        shape_spec.runTests('''
            shape: SQUARE color: BLACK posn: 100, 120
            shape: CIRCLE size: 50 color: BLUE posn: 50,80
            color:GREEN size:20 shape:TRIANGLE posn:20,40
            '''
            )
    prints::
        shape: SQUARE color: BLACK posn: 100, 120
        ['shape:', 'SQUARE', 'color:', 'BLACK', 'posn:', ['100', ',', '120']]
        - color: BLACK
        - posn: ['100', ',', '120']
          - x: 100
          - y: 120
        - shape: SQUARE


        shape: CIRCLE size: 50 color: BLUE posn: 50,80
        ['shape:', 'CIRCLE', 'size:', '50', 'color:', 'BLUE', 'posn:', ['50', ',', '80']]
        - color: BLUE
        - posn: ['50', ',', '80']
          - x: 50
          - y: 80
        - shape: CIRCLE
        - size: 50


        color: GREEN size: 20 shape: TRIANGLE posn: 20,40
        ['color:', 'GREEN', 'size:', '20', 'shape:', 'TRIANGLE', 'posn:', ['20', ',', '40']]
        - color: GREEN
        - posn: ['20', ',', '40']
          - x: 20
          - y: 40
        - shape: TRIANGLE
        - size: 20
    """
    def __init__( self, exprs, savelist = True ):
        super(Each,self).__init__(exprs, savelist)
        self.mayReturnEmpty = all(e.mayReturnEmpty for e in self.exprs)
        self.skipWhitespace = True
        self.initExprGroups = True

    def parseImpl( self, instring, loc, doActions=True ):
        if self.initExprGroups:
            self.opt1map = dict((id(e.expr),e) for e in self.exprs if isinstance(e,Optional))
            opt1 = [ e.expr for e in self.exprs if isinstance(e,Optional) ]
            opt2 = [ e for e in self.exprs if e.mayReturnEmpty and not isinstance(e,Optional)]
            self.optionals = opt1 + opt2
            self.multioptionals = [ e.expr for e in self.exprs if isinstance(e,ZeroOrMore) ]
            self.multirequired = [ e.expr for e in self.exprs if isinstance(e,OneOrMore) ]
            self.required = [ e for e in self.exprs if not isinstance(e,(Optional,ZeroOrMore,OneOrMore)) ]
            self.required += self.multirequired
            self.initExprGroups = False
        tmpLoc = loc
        tmpReqd = self.required[:]
        tmpOpt  = self.optionals[:]
        matchOrder = []

        keepMatching = True
        while keepMatching:
            tmpExprs = tmpReqd + tmpOpt + self.multioptionals + self.multirequired
            failed = []
            for e in tmpExprs:
                try:
                    tmpLoc = e.tryParse( instring, tmpLoc )
                except ParseException:
                    failed.append(e)
                else:
                    matchOrder.append(self.opt1map.get(id(e),e))
                    if e in tmpReqd:
                        tmpReqd.remove(e)
                    elif e in tmpOpt:
                        tmpOpt.remove(e)
            if len(failed) == len(tmpExprs):
                keepMatching = False

        if tmpReqd:
            missing = ", ".join(_ustr(e) for e in tmpReqd)
            raise ParseException(instring,loc,"Missing one or more required elements (%s)" % missing )

        # add any unmatched Optionals, in case they have default values defined
        matchOrder += [e for e in self.exprs if isinstance(e,Optional) and e.expr in tmpOpt]

        resultlist = []
        for e in matchOrder:
            loc,results = e._parse(instring,loc,doActions)
            resultlist.append(results)

        finalResults = sum(resultlist, ParseResults([]))
        return loc, finalResults

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + " & ".join(_ustr(e) for e in self.exprs) + "}"

        return self.strRepr

    def checkRecursion( self, parseElementList ):
        subRecCheckList = parseElementList[:] + [ self ]
        for e in self.exprs:
            e.checkRecursion( subRecCheckList )


class ParseElementEnhance(ParserElement):
    """
    Abstract subclass of C{ParserElement}, for combining and post-processing parsed tokens.
    """
    def __init__( self, expr, savelist=False ):
        super(ParseElementEnhance,self).__init__(savelist)
        if isinstance( expr, basestring ):
            if issubclass(ParserElement._literalStringClass, Token):
                expr = ParserElement._literalStringClass(expr)
            else:
                expr = ParserElement._literalStringClass(Literal(expr))
        self.expr = expr
        self.strRepr = None
        if expr is not None:
            self.mayIndexError = expr.mayIndexError
            self.mayReturnEmpty = expr.mayReturnEmpty
            self.setWhitespaceChars( expr.whiteChars )
            self.skipWhitespace = expr.skipWhitespace
            self.saveAsList = expr.saveAsList
            self.callPreparse = expr.callPreparse
            self.ignoreExprs.extend(expr.ignoreExprs)

    def parseImpl( self, instring, loc, doActions=True ):
        if self.expr is not None:
            return self.expr._parse( instring, loc, doActions, callPreParse=False )
        else:
            raise ParseException("",loc,self.errmsg,self)

    def leaveWhitespace( self ):
        self.skipWhitespace = False
        self.expr = self.expr.copy()
        if self.expr is not None:
            self.expr.leaveWhitespace()
        return self

    def ignore( self, other ):
        if isinstance( other, Suppress ):
            if other not in self.ignoreExprs:
                super( ParseElementEnhance, self).ignore( other )
                if self.expr is not None:
                    self.expr.ignore( self.ignoreExprs[-1] )
        else:
            super( ParseElementEnhance, self).ignore( other )
            if self.expr is not None:
                self.expr.ignore( self.ignoreExprs[-1] )
        return self

    def streamline( self ):
        super(ParseElementEnhance,self).streamline()
        if self.expr is not None:
            self.expr.streamline()
        return self

    def checkRecursion( self, parseElementList ):
        if self in parseElementList:
            raise RecursiveGrammarException( parseElementList+[self] )
        subRecCheckList = parseElementList[:] + [ self ]
        if self.expr is not None:
            self.expr.checkRecursion( subRecCheckList )

    def validate( self, validateTrace=[] ):
        tmp = validateTrace[:]+[self]
        if self.expr is not None:
            self.expr.validate(tmp)
        self.checkRecursion( [] )

    def __str__( self ):
        try:
            return super(ParseElementEnhance,self).__str__()
        except Exception:
            pass

        if self.strRepr is None and self.expr is not None:
            self.strRepr = "%s:(%s)" % ( self.__class__.__name__, _ustr(self.expr) )
        return self.strRepr


class FollowedBy(ParseElementEnhance):
    """
    Lookahead matching of the given parse expression.  C{FollowedBy}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression matches at the current
    position.  C{FollowedBy} always returns a null token list.

    Example::
        # use FollowedBy to match a label only if it is followed by a ':'
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        OneOrMore(attr_expr).parseString("shape: SQUARE color: BLACK posn: upper left").pprint()
    prints::
        [['shape', 'SQUARE'], ['color', 'BLACK'], ['posn', 'upper left']]
    """
    def __init__( self, expr ):
        super(FollowedBy,self).__init__(expr)
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        self.expr.tryParse( instring, loc )
        return loc, []


class NotAny(ParseElementEnhance):
    """
    Lookahead to disallow matching with the given parse expression.  C{NotAny}
    does I{not} advance the parsing position within the input string, it only
    verifies that the specified parse expression does I{not} match at the current
    position.  Also, C{NotAny} does I{not} skip over leading whitespace. C{NotAny}
    always returns a null token list.  May be constructed using the '~' operator.

    Example::
        
    """
    def __init__( self, expr ):
        super(NotAny,self).__init__(expr)
        #~ self.leaveWhitespace()
        self.skipWhitespace = False  # do NOT use self.leaveWhitespace(), don't want to propagate to exprs
        self.mayReturnEmpty = True
        self.errmsg = "Found unwanted token, "+_ustr(self.expr)

    def parseImpl( self, instring, loc, doActions=True ):
        if self.expr.canParseNext(instring, loc):
            raise ParseException(instring, loc, self.errmsg, self)
        return loc, []

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "~{" + _ustr(self.expr) + "}"

        return self.strRepr

class _MultipleMatch(ParseElementEnhance):
    def __init__( self, expr, stopOn=None):
        super(_MultipleMatch, self).__init__(expr)
        self.saveAsList = True
        ender = stopOn
        if isinstance(ender, basestring):
            ender = ParserElement._literalStringClass(ender)
        self.not_ender = ~ender if ender is not None else None

    def parseImpl( self, instring, loc, doActions=True ):
        self_expr_parse = self.expr._parse
        self_skip_ignorables = self._skipIgnorables
        check_ender = self.not_ender is not None
        if check_ender:
            try_not_ender = self.not_ender.tryParse
        
        # must be at least one (but first see if we are the stopOn sentinel;
        # if so, fail)
        if check_ender:
            try_not_ender(instring, loc)
        loc, tokens = self_expr_parse( instring, loc, doActions, callPreParse=False )
        try:
            hasIgnoreExprs = (not not self.ignoreExprs)
            while 1:
                if check_ender:
                    try_not_ender(instring, loc)
                if hasIgnoreExprs:
                    preloc = self_skip_ignorables( instring, loc )
                else:
                    preloc = loc
                loc, tmptokens = self_expr_parse( instring, preloc, doActions )
                if tmptokens or tmptokens.haskeys():
                    tokens += tmptokens
        except (ParseException,IndexError):
            pass

        return loc, tokens
        
class OneOrMore(_MultipleMatch):
    """
    Repetition of one or more of the given expression.
    
    Parameters:
     - expr - expression that must match one or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: BLACK"
        OneOrMore(attr_expr).parseString(text).pprint()  # Fail! read 'color' as data instead of next label -> [['shape', 'SQUARE color']]

        # use stopOn attribute for OneOrMore to avoid reading label string as part of the data
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        OneOrMore(attr_expr).parseString(text).pprint() # Better -> [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'BLACK']]
        
        # could also be written as
        (attr_expr * (1,)).parseString(text).pprint()
    """

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "{" + _ustr(self.expr) + "}..."

        return self.strRepr

class ZeroOrMore(_MultipleMatch):
    """
    Optional repetition of zero or more of the given expression.
    
    Parameters:
     - expr - expression that must match zero or more times
     - stopOn - (default=C{None}) - expression for a terminating sentinel
          (only required if the sentinel would ordinarily match the repetition 
          expression)          

    Example: similar to L{OneOrMore}
    """
    def __init__( self, expr, stopOn=None):
        super(ZeroOrMore,self).__init__(expr, stopOn=stopOn)
        self.mayReturnEmpty = True
        
    def parseImpl( self, instring, loc, doActions=True ):
        try:
            return super(ZeroOrMore, self).parseImpl(instring, loc, doActions)
        except (ParseException,IndexError):
            return loc, []

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "[" + _ustr(self.expr) + "]..."

        return self.strRepr

class _NullToken(object):
    def __bool__(self):
        return False
    __nonzero__ = __bool__
    def __str__(self):
        return ""

_optionalNotMatched = _NullToken()
class Optional(ParseElementEnhance):
    """
    Optional matching of the given expression.

    Parameters:
     - expr - expression that must match zero or more times
     - default (optional) - value to be returned if the optional expression is not found.

    Example::
        # US postal code can be a 5-digit zip, plus optional 4-digit qualifier
        zip = Combine(Word(nums, exact=5) + Optional('-' + Word(nums, exact=4)))
        zip.runTests('''
            # traditional ZIP code
            12345
            
            # ZIP+4 form
            12101-0001
            
            # invalid ZIP
            98765-
            ''')
    prints::
        # traditional ZIP code
        12345
        ['12345']

        # ZIP+4 form
        12101-0001
        ['12101-0001']

        # invalid ZIP
        98765-
             ^
        FAIL: Expected end of text (at char 5), (line:1, col:6)
    """
    def __init__( self, expr, default=_optionalNotMatched ):
        super(Optional,self).__init__( expr, savelist=False )
        self.saveAsList = self.expr.saveAsList
        self.defaultValue = default
        self.mayReturnEmpty = True

    def parseImpl( self, instring, loc, doActions=True ):
        try:
            loc, tokens = self.expr._parse( instring, loc, doActions, callPreParse=False )
        except (ParseException,IndexError):
            if self.defaultValue is not _optionalNotMatched:
                if self.expr.resultsName:
                    tokens = ParseResults([ self.defaultValue ])
                    tokens[self.expr.resultsName] = self.defaultValue
                else:
                    tokens = [ self.defaultValue ]
            else:
                tokens = []
        return loc, tokens

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name

        if self.strRepr is None:
            self.strRepr = "[" + _ustr(self.expr) + "]"

        return self.strRepr

class SkipTo(ParseElementEnhance):
    """
    Token for skipping over all undefined text until the matched expression is found.

    Parameters:
     - expr - target expression marking the end of the data to be skipped
     - include - (default=C{False}) if True, the target expression is also parsed 
          (the skipped text and target expression are returned as a 2-element list).
     - ignore - (default=C{None}) used to define grammars (typically quoted strings and 
          comments) that might contain false matches to the target expression
     - failOn - (default=C{None}) define expressions that are not allowed to be 
          included in the skipped test; if found before the target expression is found, 
          the SkipTo is not a match

    Example::
        report = '''
            Outstanding Issues Report - 1 Jan 2000

               # | Severity | Description                               |  Days Open
            -----+----------+-------------------------------------------+-----------
             101 | Critical | Intermittent system crash                 |          6
              94 | Cosmetic | Spelling error on Login ('log|n')         |         14
              79 | Minor    | System slow when running too many reports |         47
            '''
        integer = Word(nums)
        SEP = Suppress('|')
        # use SkipTo to simply match everything up until the next SEP
        # - ignore quoted strings, so that a '|' character inside a quoted string does not match
        # - parse action will call token.strip() for each matched token, i.e., the description body
        string_data = SkipTo(SEP, ignore=quotedString)
        string_data.setParseAction(tokenMap(str.strip))
        ticket_expr = (integer("issue_num") + SEP 
                      + string_data("sev") + SEP 
                      + string_data("desc") + SEP 
                      + integer("days_open"))
        
        for tkt in ticket_expr.searchString(report):
            print tkt.dump()
    prints::
        ['101', 'Critical', 'Intermittent system crash', '6']
        - days_open: 6
        - desc: Intermittent system crash
        - issue_num: 101
        - sev: Critical
        ['94', 'Cosmetic', "Spelling error on Login ('log|n')", '14']
        - days_open: 14
        - desc: Spelling error on Login ('log|n')
        - issue_num: 94
        - sev: Cosmetic
        ['79', 'Minor', 'System slow when running too many reports', '47']
        - days_open: 47
        - desc: System slow when running too many reports
        - issue_num: 79
        - sev: Minor
    """
    def __init__( self, other, include=False, ignore=None, failOn=None ):
        super( SkipTo, self ).__init__( other )
        self.ignoreExpr = ignore
        self.mayReturnEmpty = True
        self.mayIndexError = False
        self.includeMatch = include
        self.asList = False
        if isinstance(failOn, basestring):
            self.failOn = ParserElement._literalStringClass(failOn)
        else:
            self.failOn = failOn
        self.errmsg = "No match found for "+_ustr(self.expr)

    def parseImpl( self, instring, loc, doActions=True ):
        startloc = loc
        instrlen = len(instring)
        expr = self.expr
        expr_parse = self.expr._parse
        self_failOn_canParseNext = self.failOn.canParseNext if self.failOn is not None else None
        self_ignoreExpr_tryParse = self.ignoreExpr.tryParse if self.ignoreExpr is not None else None
        
        tmploc = loc
        while tmploc <= instrlen:
            if self_failOn_canParseNext is not None:
                # break if failOn expression matches
                if self_failOn_canParseNext(instring, tmploc):
                    break
                    
            if self_ignoreExpr_tryParse is not None:
                # advance past ignore expressions
                while 1:
                    try:
                        tmploc = self_ignoreExpr_tryParse(instring, tmploc)
                    except ParseBaseException:
                        break
            
            try:
                expr_parse(instring, tmploc, doActions=False, callPreParse=False)
            except (ParseException, IndexError):
                # no match, advance loc in string
                tmploc += 1
            else:
                # matched skipto expr, done
                break

        else:
            # ran off the end of the input string without matching skipto expr, fail
            raise ParseException(instring, loc, self.errmsg, self)

        # build up return values
        loc = tmploc
        skiptext = instring[startloc:loc]
        skipresult = ParseResults(skiptext)
        
        if self.includeMatch:
            loc, mat = expr_parse(instring,loc,doActions,callPreParse=False)
            skipresult += mat

        return loc, skipresult

class Forward(ParseElementEnhance):
    """
    Forward declaration of an expression to be defined later -
    used for recursive grammars, such as algebraic infix notation.
    When the expression is known, it is assigned to the C{Forward} variable using the '<<' operator.

    Note: take care when assigning to C{Forward} not to overlook precedence of operators.
    Specifically, '|' has a lower precedence than '<<', so that::
        fwdExpr << a | b | c
    will actually be evaluated as::
        (fwdExpr << a) | b | c
    thereby leaving b and c out as parseable alternatives.  It is recommended that you
    explicitly group the values inserted into the C{Forward}::
        fwdExpr << (a | b | c)
    Converting to use the '<<=' operator instead will avoid this problem.

    See L{ParseResults.pprint} for an example of a recursive parser created using
    C{Forward}.
    """
    def __init__( self, other=None ):
        super(Forward,self).__init__( other, savelist=False )

    def __lshift__( self, other ):
        if isinstance( other, basestring ):
            other = ParserElement._literalStringClass(other)
        self.expr = other
        self.strRepr = None
        self.mayIndexError = self.expr.mayIndexError
        self.mayReturnEmpty = self.expr.mayReturnEmpty
        self.setWhitespaceChars( self.expr.whiteChars )
        self.skipWhitespace = self.expr.skipWhitespace
        self.saveAsList = self.expr.saveAsList
        self.ignoreExprs.extend(self.expr.ignoreExprs)
        return self
        
    def __ilshift__(self, other):
        return self << other
    
    def leaveWhitespace( self ):
        self.skipWhitespace = False
        return self

    def streamline( self ):
        if not self.streamlined:
            self.streamlined = True
            if self.expr is not None:
                self.expr.streamline()
        return self

    def validate( self, validateTrace=[] ):
        if self not in validateTrace:
            tmp = validateTrace[:]+[self]
            if self.expr is not None:
                self.expr.validate(tmp)
        self.checkRecursion([])

    def __str__( self ):
        if hasattr(self,"name"):
            return self.name
        return self.__class__.__name__ + ": ..."

        # stubbed out for now - creates awful memory and perf issues
        self._revertClass = self.__class__
        self.__class__ = _ForwardNoRecurse
        try:
            if self.expr is not None:
                retString = _ustr(self.expr)
            else:
                retString = "None"
        finally:
            self.__class__ = self._revertClass
        return self.__class__.__name__ + ": " + retString

    def copy(self):
        if self.expr is not None:
            return super(Forward,self).copy()
        else:
            ret = Forward()
            ret <<= self
            return ret

class _ForwardNoRecurse(Forward):
    def __str__( self ):
        return "..."

class TokenConverter(ParseElementEnhance):
    """
    Abstract subclass of C{ParseExpression}, for converting parsed results.
    """
    def __init__( self, expr, savelist=False ):
        super(TokenConverter,self).__init__( expr )#, savelist )
        self.saveAsList = False

class Combine(TokenConverter):
    """
    Converter to concatenate all matching tokens to a single string.
    By default, the matching patterns must also be contiguous in the input string;
    this can be disabled by specifying C{'adjacent=False'} in the constructor.

    Example::
        real = Word(nums) + '.' + Word(nums)
        print(real.parseString('3.1416')) # -> ['3', '.', '1416']
        # will also erroneously match the following
        print(real.parseString('3. 1416')) # -> ['3', '.', '1416']

        real = Combine(Word(nums) + '.' + Word(nums))
        print(real.parseString('3.1416')) # -> ['3.1416']
        # no match when there are internal spaces
        print(real.parseString('3. 1416')) # -> Exception: Expected W:(0123...)
    """
    def __init__( self, expr, joinString="", adjacent=True ):
        super(Combine,self).__init__( expr )
        # suppress whitespace-stripping in contained parse expressions, but re-enable it on the Combine itself
        if adjacent:
            self.leaveWhitespace()
        self.adjacent = adjacent
        self.skipWhitespace = True
        self.joinString = joinString
        self.callPreparse = True

    def ignore( self, other ):
        if self.adjacent:
            ParserElement.ignore(self, other)
        else:
            super( Combine, self).ignore( other )
        return self

    def postParse( self, instring, loc, tokenlist ):
        retToks = tokenlist.copy()
        del retToks[:]
        retToks += ParseResults([ "".join(tokenlist._asStringList(self.joinString)) ], modal=self.modalResults)

        if self.resultsName and retToks.haskeys():
            return [ retToks ]
        else:
            return retToks

class Group(TokenConverter):
    """
    Converter to return the matched tokens as a list - useful for returning tokens of C{L{ZeroOrMore}} and C{L{OneOrMore}} expressions.

    Example::
        ident = Word(alphas)
        num = Word(nums)
        term = ident | num
        func = ident + Optional(delimitedList(term))
        print(func.parseString("fn a,b,100"))  # -> ['fn', 'a', 'b', '100']

        func = ident + Group(Optional(delimitedList(term)))
        print(func.parseString("fn a,b,100"))  # -> ['fn', ['a', 'b', '100']]
    """
    def __init__( self, expr ):
        super(Group,self).__init__( expr )
        self.saveAsList = True

    def postParse( self, instring, loc, tokenlist ):
        return [ tokenlist ]

class Dict(TokenConverter):
    """
    Converter to return a repetitive expression as a list, but also as a dictionary.
    Each element can also be referenced using the first token in the expression as its key.
    Useful for tabular report scraping when the first column can be used as a item key.

    Example::
        data_word = Word(alphas)
        label = data_word + FollowedBy(':')
        attr_expr = Group(label + Suppress(':') + OneOrMore(data_word).setParseAction(' '.join))

        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        
        # print attributes as plain groups
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        # instead of OneOrMore(expr), parse using Dict(OneOrMore(Group(expr))) - Dict will auto-assign names
        result = Dict(OneOrMore(Group(attr_expr))).parseString(text)
        print(result.dump())
        
        # access named fields as dict entries, or output as dict
        print(result['shape'])        
        print(result.asDict())
    prints::
        ['shape', 'SQUARE', 'posn', 'upper left', 'color', 'light blue', 'texture', 'burlap']

        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        {'color': 'light blue', 'posn': 'upper left', 'texture': 'burlap', 'shape': 'SQUARE'}
    See more examples at L{ParseResults} of accessing fields by results name.
    """
    def __init__( self, expr ):
        super(Dict,self).__init__( expr )
        self.saveAsList = True

    def postParse( self, instring, loc, tokenlist ):
        for i,tok in enumerate(tokenlist):
            if len(tok) == 0:
                continue
            ikey = tok[0]
            if isinstance(ikey,int):
                ikey = _ustr(tok[0]).strip()
            if len(tok)==1:
                tokenlist[ikey] = _ParseResultsWithOffset("",i)
            elif len(tok)==2 and not isinstance(tok[1],ParseResults):
                tokenlist[ikey] = _ParseResultsWithOffset(tok[1],i)
            else:
                dictvalue = tok.copy() #ParseResults(i)
                del dictvalue[0]
                if len(dictvalue)!= 1 or (isinstance(dictvalue,ParseResults) and dictvalue.haskeys()):
                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue,i)
                else:
                    tokenlist[ikey] = _ParseResultsWithOffset(dictvalue[0],i)

        if self.resultsName:
            return [ tokenlist ]
        else:
            return tokenlist


class Suppress(TokenConverter):
    """
    Converter for ignoring the results of a parsed expression.

    Example::
        source = "a, b, c,d"
        wd = Word(alphas)
        wd_list1 = wd + ZeroOrMore(',' + wd)
        print(wd_list1.parseString(source))

        # often, delimiters that are useful during parsing are just in the
        # way afterward - use Suppress to keep them out of the parsed output
        wd_list2 = wd + ZeroOrMore(Suppress(',') + wd)
        print(wd_list2.parseString(source))
    prints::
        ['a', ',', 'b', ',', 'c', ',', 'd']
        ['a', 'b', 'c', 'd']
    (See also L{delimitedList}.)
    """
    def postParse( self, instring, loc, tokenlist ):
        return []

    def suppress( self ):
        return self


class OnlyOnce(object):
    """
    Wrapper for parse actions, to ensure they are only called once.
    """
    def __init__(self, methodCall):
        self.callable = _trim_arity(methodCall)
        self.called = False
    def __call__(self,s,l,t):
        if not self.called:
            results = self.callable(s,l,t)
            self.called = True
            return results
        raise ParseException(s,l,"")
    def reset(self):
        self.called = False

def traceParseAction(f):
    """
    Decorator for debugging parse actions. 
    
    When the parse action is called, this decorator will print C{">> entering I{method-name}(line:I{current_source_line}, I{parse_location}, I{matched_tokens})".}
    When the parse action completes, the decorator will print C{"<<"} followed by the returned value, or any exception that the parse action raised.

    Example::
        wd = Word(alphas)

        @traceParseAction
        def remove_duplicate_chars(tokens):
            return ''.join(sorted(set(''.join(tokens))))

        wds = OneOrMore(wd).setParseAction(remove_duplicate_chars)
        print(wds.parseString("slkdjs sld sldd sdlf sdljf"))
    prints::
        >>entering remove_duplicate_chars(line: 'slkdjs sld sldd sdlf sdljf', 0, (['slkdjs', 'sld', 'sldd', 'sdlf', 'sdljf'], {}))
        <<leaving remove_duplicate_chars (ret: 'dfjkls')
        ['dfjkls']
    """
    f = _trim_arity(f)
    def z(*paArgs):
        thisFunc = f.__name__
        s,l,t = paArgs[-3:]
        if len(paArgs)>3:
            thisFunc = paArgs[0].__class__.__name__ + '.' + thisFunc
        sys.stderr.write( ">>entering %s(line: '%s', %d, %r)\n" % (thisFunc,line(l,s),l,t) )
        try:
            ret = f(*paArgs)
        except Exception as exc:
            sys.stderr.write( "<<leaving %s (exception: %s)\n" % (thisFunc,exc) )
            raise
        sys.stderr.write( "<<leaving %s (ret: %r)\n" % (thisFunc,ret) )
        return ret
    try:
        z.__name__ = f.__name__
    except AttributeError:
        pass
    return z

#
# global helpers
#
def delimitedList( expr, delim=",", combine=False ):
    """
    Helper to define a delimited list of expressions - the delimiter defaults to ','.
    By default, the list elements and delimiters can have intervening whitespace, and
    comments, but this can be overridden by passing C{combine=True} in the constructor.
    If C{combine} is set to C{True}, the matching tokens are returned as a single token
    string, with the delimiters included; otherwise, the matching tokens are returned
    as a list of tokens, with the delimiters suppressed.

    Example::
        delimitedList(Word(alphas)).parseString("aa,bb,cc") # -> ['aa', 'bb', 'cc']
        delimitedList(Word(hexnums), delim=':', combine=True).parseString("AA:BB:CC:DD:EE") # -> ['AA:BB:CC:DD:EE']
    """
    dlName = _ustr(expr)+" ["+_ustr(delim)+" "+_ustr(expr)+"]..."
    if combine:
        return Combine( expr + ZeroOrMore( delim + expr ) ).setName(dlName)
    else:
        return ( expr + ZeroOrMore( Suppress( delim ) + expr ) ).setName(dlName)

def countedArray( expr, intExpr=None ):
    """
    Helper to define a counted list of expressions.
    This helper defines a pattern of the form::
        integer expr expr expr...
    where the leading integer tells how many expr expressions follow.
    The matched tokens returns the array of expr tokens as a list - the leading count token is suppressed.
    
    If C{intExpr} is specified, it should be a pyparsing expression that produces an integer value.

    Example::
        countedArray(Word(alphas)).parseString('2 ab cd ef')  # -> ['ab', 'cd']

        # in this parser, the leading integer value is given in binary,
        # '10' indicating that 2 values are in the array
        binaryConstant = Word('01').setParseAction(lambda t: int(t[0], 2))
        countedArray(Word(alphas), intExpr=binaryConstant).parseString('10 ab cd ef')  # -> ['ab', 'cd']
    """
    arrayExpr = Forward()
    def countFieldParseAction(s,l,t):
        n = t[0]
        arrayExpr << (n and Group(And([expr]*n)) or Group(empty))
        return []
    if intExpr is None:
        intExpr = Word(nums).setParseAction(lambda t:int(t[0]))
    else:
        intExpr = intExpr.copy()
    intExpr.setName("arrayLen")
    intExpr.addParseAction(countFieldParseAction, callDuringTry=True)
    return ( intExpr + arrayExpr ).setName('(len) ' + _ustr(expr) + '...')

def _flatten(L):
    ret = []
    for i in L:
        if isinstance(i,list):
            ret.extend(_flatten(i))
        else:
            ret.append(i)
    return ret

def matchPreviousLiteral(expr):
    """
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousLiteral(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches a
    previous literal, will also match the leading C{"1:1"} in C{"1:10"}.
    If this is not desired, use C{matchPreviousExpr}.
    Do I{not} use with packrat parsing enabled.
    """
    rep = Forward()
    def copyTokenToRepeater(s,l,t):
        if t:
            if len(t) == 1:
                rep << t[0]
            else:
                # flatten t tokens
                tflat = _flatten(t.asList())
                rep << And(Literal(tt) for tt in tflat)
        else:
            rep << Empty()
    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
    rep.setName('(prev) ' + _ustr(expr))
    return rep

def matchPreviousExpr(expr):
    """
    Helper to define an expression that is indirectly defined from
    the tokens matched in a previous expression, that is, it looks
    for a 'repeat' of a previous expression.  For example::
        first = Word(nums)
        second = matchPreviousExpr(first)
        matchExpr = first + ":" + second
    will match C{"1:1"}, but not C{"1:2"}.  Because this matches by
    expressions, will I{not} match the leading C{"1:1"} in C{"1:10"};
    the expressions are evaluated first, and then compared, so
    C{"1"} is compared with C{"10"}.
    Do I{not} use with packrat parsing enabled.
    """
    rep = Forward()
    e2 = expr.copy()
    rep <<= e2
    def copyTokenToRepeater(s,l,t):
        matchTokens = _flatten(t.asList())
        def mustMatchTheseTokens(s,l,t):
            theseTokens = _flatten(t.asList())
            if  theseTokens != matchTokens:
                raise ParseException("",0,"")
        rep.setParseAction( mustMatchTheseTokens, callDuringTry=True )
    expr.addParseAction(copyTokenToRepeater, callDuringTry=True)
    rep.setName('(prev) ' + _ustr(expr))
    return rep

def _escapeRegexRangeChars(s):
    #~  escape these chars: ^-]
    for c in r"\^-]":
        s = s.replace(c,_bslash+c)
    s = s.replace("\n",r"\n")
    s = s.replace("\t",r"\t")
    return _ustr(s)

def oneOf( strs, caseless=False, useRegex=True ):
    """
    Helper to quickly define a set of alternative Literals, and makes sure to do
    longest-first testing when there is a conflict, regardless of the input order,
    but returns a C{L{MatchFirst}} for best performance.

    Parameters:
     - strs - a string of space-delimited literals, or a collection of string literals
     - caseless - (default=C{False}) - treat all literals as caseless
     - useRegex - (default=C{True}) - as an optimization, will generate a Regex
          object; otherwise, will generate a C{MatchFirst} object (if C{caseless=True}, or
          if creating a C{Regex} raises an exception)

    Example::
        comp_oper = oneOf("< = > <= >= !=")
        var = Word(alphas)
        number = Word(nums)
        term = var | number
        comparison_expr = term + comp_oper + term
        print(comparison_expr.searchString("B = 12  AA=23 B<=AA AA>12"))
    prints::
        [['B', '=', '12'], ['AA', '=', '23'], ['B', '<=', 'AA'], ['AA', '>', '12']]
    """
    if caseless:
        isequal = ( lambda a,b: a.upper() == b.upper() )
        masks = ( lambda a,b: b.upper().startswith(a.upper()) )
        parseElementClass = CaselessLiteral
    else:
        isequal = ( lambda a,b: a == b )
        masks = ( lambda a,b: b.startswith(a) )
        parseElementClass = Literal

    symbols = []
    if isinstance(strs,basestring):
        symbols = strs.split()
    elif isinstance(strs, Iterable):
        symbols = list(strs)
    else:
        warnings.warn("Invalid argument to oneOf, expected string or iterable",
                SyntaxWarning, stacklevel=2)
    if not symbols:
        return NoMatch()

    i = 0
    while i < len(symbols)-1:
        cur = symbols[i]
        for j,other in enumerate(symbols[i+1:]):
            if ( isequal(other, cur) ):
                del symbols[i+j+1]
                break
            elif ( masks(cur, other) ):
                del symbols[i+j+1]
                symbols.insert(i,other)
                cur = other
                break
        else:
            i += 1

    if not caseless and useRegex:
        #~ print (strs,"->", "|".join( [ _escapeRegexChars(sym) for sym in symbols] ))
        try:
            if len(symbols)==len("".join(symbols)):
                return Regex( "[%s]" % "".join(_escapeRegexRangeChars(sym) for sym in symbols) ).setName(' | '.join(symbols))
            else:
                return Regex( "|".join(re.escape(sym) for sym in symbols) ).setName(' | '.join(symbols))
        except Exception:
            warnings.warn("Exception creating Regex for oneOf, building MatchFirst",
                    SyntaxWarning, stacklevel=2)


    # last resort, just use MatchFirst
    return MatchFirst(parseElementClass(sym) for sym in symbols).setName(' | '.join(symbols))

def dictOf( key, value ):
    """
    Helper to easily and clearly define a dictionary by specifying the respective patterns
    for the key and value.  Takes care of defining the C{L{Dict}}, C{L{ZeroOrMore}}, and C{L{Group}} tokens
    in the proper order.  The key pattern can include delimiting markers or punctuation,
    as long as they are suppressed, thereby leaving the significant key text.  The value
    pattern can include named results, so that the C{Dict} results can include named token
    fields.

    Example::
        text = "shape: SQUARE posn: upper left color: light blue texture: burlap"
        attr_expr = (label + Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join))
        print(OneOrMore(attr_expr).parseString(text).dump())
        
        attr_label = label
        attr_value = Suppress(':') + OneOrMore(data_word, stopOn=label).setParseAction(' '.join)

        # similar to Dict, but simpler call format
        result = dictOf(attr_label, attr_value).parseString(text)
        print(result.dump())
        print(result['shape'])
        print(result.shape)  # object attribute access works too
        print(result.asDict())
    prints::
        [['shape', 'SQUARE'], ['posn', 'upper left'], ['color', 'light blue'], ['texture', 'burlap']]
        - color: light blue
        - posn: upper left
        - shape: SQUARE
        - texture: burlap
        SQUARE
        SQUARE
        {'color': 'light blue', 'shape': 'SQUARE', 'posn': 'upper left', 'texture': 'burlap'}
    """
    return Dict( ZeroOrMore( Group ( key + value ) ) )

def originalTextFor(expr, asString=True):
    """
    Helper to return the original, untokenized text for a given expression.  Useful to
    restore the parsed fields of an HTML start tag into the raw tag text itself, or to
    revert separate tokens with intervening whitespace back to the original matching
    input text. By default, returns astring containing the original parsed text.  
       
    If the optional C{asString} argument is passed as C{False}, then the return value is a 
    C{L{ParseResults}} containing any results names that were originally matched, and a 
    single token containing the original matched text from the input string.  So if 
    the expression passed to C{L{originalTextFor}} contains expressions with defined
    results names, you must set C{asString} to C{False} if you want to preserve those
    results name values.

    Example::
        src = "this is test <b> bold <i>text</i> </b> normal text "
        for tag in ("b","i"):
            opener,closer = makeHTMLTags(tag)
            patt = originalTextFor(opener + SkipTo(closer) + closer)
            print(patt.searchString(src)[0])
    prints::
        ['<b> bold <i>text</i> </b>']
        ['<i>text</i>']
    """
    locMarker = Empty().setParseAction(lambda s,loc,t: loc)
    endlocMarker = locMarker.copy()
    endlocMarker.callPreparse = False
    matchExpr = locMarker("_original_start") + expr + endlocMarker("_original_end")
    if asString:
        extractText = lambda s,l,t: s[t._original_start:t._original_end]
    else:
        def extractText(s,l,t):
            t[:] = [s[t.pop('_original_start'):t.pop('_original_end')]]
    matchExpr.setParseAction(extractText)
    matchExpr.ignoreExprs = expr.ignoreExprs
    return matchExpr

def ungroup(expr): 
    """
    Helper to undo pyparsing's default grouping of And expressions, even
    if all but one are non-empty.
    """
    return TokenConverter(expr).setParseAction(lambda t:t[0])

def locatedExpr(expr):
    """
    Helper to decorate a returned token with its starting and ending locations in the input string.
    This helper adds the following results names:
     - locn_start = location where matched expression begins
     - locn_end = location where matched expression ends
     - value = the actual parsed results

    Be careful if the input text contains C{<TAB>} characters, you may want to call
    C{L{ParserElement.parseWithTabs}}

    Example::
        wd = Word(alphas)
        for match in locatedExpr(wd).searchString("ljsdf123lksdjjf123lkkjj1222"):
            print(match)
    prints::
        [[0, 'ljsdf', 5]]
        [[8, 'lksdjjf', 15]]
        [[18, 'lkkjj', 23]]
    """
    locator = Empty().setParseAction(lambda s,l,t: l)
    return Group(locator("locn_start") + expr("value") + locator.copy().leaveWhitespace()("locn_end"))


# convenience constants for positional expressions
empty       = Empty().setName("empty")
lineStart   = LineStart().setName("lineStart")
lineEnd     = LineEnd().setName("lineEnd")
stringStart = StringStart().setName("stringStart")
stringEnd   = StringEnd().setName("stringEnd")

_escapedPunc = Word( _bslash, r"\[]-*.$+^?()~ ", exact=2 ).setParseAction(lambda s,l,t:t[0][1])
_escapedHexChar = Regex(r"\\0?[xX][0-9a-fA-F]+").setParseAction(lambda s,l,t:unichr(int(t[0].lstrip(r'\0x'),16)))
_escapedOctChar = Regex(r"\\0[0-7]+").setParseAction(lambda s,l,t:unichr(int(t[0][1:],8)))
_singleChar = _escapedPunc | _escapedHexChar | _escapedOctChar | CharsNotIn(r'\]', exact=1)
_charRange = Group(_singleChar + Suppress("-") + _singleChar)
_reBracketExpr = Literal("[") + Optional("^").setResultsName("negate") + Group( OneOrMore( _charRange | _singleChar ) ).setResultsName("body") + "]"

def srange(s):
    r"""
    Helper to easily define string ranges for use in Word construction.  Borrows
    syntax from regexp '[]' string range definitions::
        srange("[0-9]")   -> "0123456789"
        srange("[a-z]")   -> "abcdefghijklmnopqrstuvwxyz"
        srange("[a-z$_]") -> "abcdefghijklmnopqrstuvwxyz$_"
    The input string must be enclosed in []'s, and the returned string is the expanded
    character set joined into a single string.
    The values enclosed in the []'s may be:
     - a single character
     - an escaped character with a leading backslash (such as C{\-} or C{\]})
     - an escaped hex character with a leading C{'\x'} (C{\x21}, which is a C{'!'} character) 
         (C{\0x##} is also supported for backwards compatibility) 
     - an escaped octal character with a leading C{'\0'} (C{\041}, which is a C{'!'} character)
     - a range of any of the above, separated by a dash (C{'a-z'}, etc.)
     - any combination of the above (C{'aeiouy'}, C{'a-zA-Z0-9_$'}, etc.)
    """
    _expanded = lambda p: p if not isinstance(p,ParseResults) else ''.join(unichr(c) for c in range(ord(p[0]),ord(p[1])+1))
    try:
        return "".join(_expanded(part) for part in _reBracketExpr.parseString(s).body)
    except Exception:
        return ""

def matchOnlyAtCol(n):
    """
    Helper method for defining parse actions that require matching at a specific
    column in the input text.
    """
    def verifyCol(strg,locn,toks):
        if col(locn,strg) != n:
            raise ParseException(strg,locn,"matched token not at column %d" % n)
    return verifyCol

def replaceWith(replStr):
    """
    Helper method for common parse actions that simply return a literal value.  Especially
    useful when used with C{L{transformString<ParserElement.transformString>}()}.

    Example::
        num = Word(nums).setParseAction(lambda toks: int(toks[0]))
        na = oneOf("N/A NA").setParseAction(replaceWith(math.nan))
        term = na | num
        
        OneOrMore(term).parseString("324 234 N/A 234") # -> [324, 234, nan, 234]
    """
    return lambda s,l,t: [replStr]

def removeQuotes(s,l,t):
    """
    Helper parse action for removing quotation marks from parsed quoted strings.

    Example::
        # by default, quotation marks are included in parsed results
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["'Now is the Winter of our Discontent'"]

        # use removeQuotes to strip quotation marks from parsed results
        quotedString.setParseAction(removeQuotes)
        quotedString.parseString("'Now is the Winter of our Discontent'") # -> ["Now is the Winter of our Discontent"]
    """
    return t[0][1:-1]

def tokenMap(func, *args):
    """
    Helper to define a parse action by mapping a function to all elements of a ParseResults list.If any additional 
    args are passed, they are forwarded to the given function as additional arguments after
    the token, as in C{hex_integer = Word(hexnums).setParseAction(tokenMap(int, 16))}, which will convert the
    parsed data to an integer using base 16.

    Example (compare the last to example in L{ParserElement.transformString}::
        hex_ints = OneOrMore(Word(hexnums)).setParseAction(tokenMap(int, 16))
        hex_ints.runTests('''
            00 11 22 aa FF 0a 0d 1a
            ''')
        
        upperword = Word(alphas).setParseAction(tokenMap(str.upper))
        OneOrMore(upperword).runTests('''
            my kingdom for a horse
            ''')

        wd = Word(alphas).setParseAction(tokenMap(str.title))
        OneOrMore(wd).setParseAction(' '.join).runTests('''
            now is the winter of our discontent made glorious summer by this sun of york
            ''')
    prints::
        00 11 22 aa FF 0a 0d 1a
        [0, 17, 34, 170, 255, 10, 13, 26]

        my kingdom for a horse
        ['MY', 'KINGDOM', 'FOR', 'A', 'HORSE']

        now is the winter of our discontent made glorious summer by this sun of york
        ['Now Is The Winter Of Our Discontent Made Glorious Summer By This Sun Of York']
    """
    def pa(s,l,t):
        return [func(tokn, *args) for tokn in t]

    try:
        func_name = getattr(func, '__name__', 
                            getattr(func, '__class__').__name__)
    except Exception:
        func_name = str(func)
    pa.__name__ = func_name

    return pa

upcaseTokens = tokenMap(lambda t: _ustr(t).upper())
"""(Deprecated) Helper parse action to convert tokens to upper case. Deprecated in favor of L{pyparsing_common.upcaseTokens}"""

downcaseTokens = tokenMap(lambda t: _ustr(t).lower())
"""(Deprecated) Helper parse action to convert tokens to lower case. Deprecated in favor of L{pyparsing_common.downcaseTokens}"""
    
def _makeTags(tagStr, xml):
    """Internal helper to construct opening and closing tag expressions, given a tag name"""
    if isinstance(tagStr,basestring):
        resname = tagStr
        tagStr = Keyword(tagStr, caseless=not xml)
    else:
        resname = tagStr.name

    tagAttrName = Word(alphas,alphanums+"_-:")
    if (xml):
        tagAttrValue = dblQuotedString.copy().setParseAction( removeQuotes )
        openTag = Suppress("<") + tagStr("tag") + \
                Dict(ZeroOrMore(Group( tagAttrName + Suppress("=") + tagAttrValue ))) + \
                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
    else:
        printablesLessRAbrack = "".join(c for c in printables if c not in ">")
        tagAttrValue = quotedString.copy().setParseAction( removeQuotes ) | Word(printablesLessRAbrack)
        openTag = Suppress("<") + tagStr("tag") + \
                Dict(ZeroOrMore(Group( tagAttrName.setParseAction(downcaseTokens) + \
                Optional( Suppress("=") + tagAttrValue ) ))) + \
                Optional("/",default=[False]).setResultsName("empty").setParseAction(lambda s,l,t:t[0]=='/') + Suppress(">")
    closeTag = Combine(_L("</") + tagStr + ">")

    openTag = openTag.setResultsName("start"+"".join(resname.replace(":"," ").title().split())).setName("<%s>" % resname)
    closeTag = closeTag.setResultsName("end"+"".join(resname.replace(":"," ").title().split())).setName("</%s>" % resname)
    openTag.tag = resname
    closeTag.tag = resname
    return openTag, closeTag

def makeHTMLTags(tagStr):
    """
    Helper to construct opening and closing tag expressions for HTML, given a tag name. Matches
    tags in either upper or lower case, attributes with namespaces and with quoted or unquoted values.

    Example::
        text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
        # makeHTMLTags returns pyparsing expressions for the opening and closing tags as a 2-tuple
        a,a_end = makeHTMLTags("A")
        link_expr = a + SkipTo(a_end)("link_text") + a_end
        
        for link in link_expr.searchString(text):
            # attributes in the <A> tag (like "href" shown here) are also accessible as named results
            print(link.link_text, '->', link.href)
    prints::
        pyparsing -> http://pyparsing.wikispaces.com
    """
    return _makeTags( tagStr, False )

def makeXMLTags(tagStr):
    """
    Helper to construct opening and closing tag expressions for XML, given a tag name. Matches
    tags only in the given upper/lower case.

    Example: similar to L{makeHTMLTags}
    """
    return _makeTags( tagStr, True )

def withAttribute(*args,**attrDict):
    """
    Helper to create a validating parse action to be used with start tags created
    with C{L{makeXMLTags}} or C{L{makeHTMLTags}}. Use C{withAttribute} to qualify a starting tag
    with a required attribute value, to avoid false matches on common tags such as
    C{<TD>} or C{<DIV>}.

    Call C{withAttribute} with a series of attribute names and values. Specify the list
    of filter attributes names and values as:
     - keyword arguments, as in C{(align="right")}, or
     - as an explicit dict with C{**} operator, when an attribute name is also a Python
          reserved word, as in C{**{"class":"Customer", "align":"right"}}
     - a list of name-value tuples, as in ( ("ns1:class", "Customer"), ("ns2:align","right") )
    For attribute names with a namespace prefix, you must use the second form.  Attribute
    names are matched insensitive to upper/lower case.
       
    If just testing for C{class} (with or without a namespace), use C{L{withClass}}.

    To verify that the attribute exists, but without specifying a value, pass
    C{withAttribute.ANY_VALUE} as the value.

    Example::
        html = '''
            <div>
            Some text
            <div type="grid">1 4 0 1 0</div>
            <div type="graph">1,3 2,3 1,1</div>
            <div>this has no type</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")

        # only match div tag having a type attribute with value "grid"
        div_grid = div().setParseAction(withAttribute(type="grid"))
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        # construct a match with any div tag having a type attribute, regardless of the value
        div_any_type = div().setParseAction(withAttribute(type=withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    """
    if args:
        attrs = args[:]
    else:
        attrs = attrDict.items()
    attrs = [(k,v) for k,v in attrs]
    def pa(s,l,tokens):
        for attrName,attrValue in attrs:
            if attrName not in tokens:
                raise ParseException(s,l,"no matching attribute " + attrName)
            if attrValue != withAttribute.ANY_VALUE and tokens[attrName] != attrValue:
                raise ParseException(s,l,"attribute '%s' has value '%s', must be '%s'" %
                                            (attrName, tokens[attrName], attrValue))
    return pa
withAttribute.ANY_VALUE = object()

def withClass(classname, namespace=''):
    """
    Simplified version of C{L{withAttribute}} when matching on a div class - made
    difficult because C{class} is a reserved word in Python.

    Example::
        html = '''
            <div>
            Some text
            <div class="grid">1 4 0 1 0</div>
            <div class="graph">1,3 2,3 1,1</div>
            <div>this &lt;div&gt; has no class</div>
            </div>
                
        '''
        div,div_end = makeHTMLTags("div")
        div_grid = div().setParseAction(withClass("grid"))
        
        grid_expr = div_grid + SkipTo(div | div_end)("body")
        for grid_header in grid_expr.searchString(html):
            print(grid_header.body)
        
        div_any_type = div().setParseAction(withClass(withAttribute.ANY_VALUE))
        div_expr = div_any_type + SkipTo(div | div_end)("body")
        for div_header in div_expr.searchString(html):
            print(div_header.body)
    prints::
        1 4 0 1 0

        1 4 0 1 0
        1,3 2,3 1,1
    """
    classattr = "%s:class" % namespace if namespace else "class"
    return withAttribute(**{classattr : classname})        

opAssoc = _Constants()
opAssoc.LEFT = object()
opAssoc.RIGHT = object()

def infixNotation( baseExpr, opList, lpar=Suppress('('), rpar=Suppress(')') ):
    """
    Helper method for constructing grammars of expressions made up of
    operators working in a precedence hierarchy.  Operators may be unary or
    binary, left- or right-associative.  Parse actions can also be attached
    to operator expressions. The generated parser will also recognize the use 
    of parentheses to override operator precedences (see example below).
    
    Note: if you define a deep operator list, you may see performance issues
    when using infixNotation. See L{ParserElement.enablePackrat} for a
    mechanism to potentially improve your parser performance.

    Parameters:
     - baseExpr - expression representing the most basic element for the nested
     - opList - list of tuples, one for each operator precedence level in the
      expression grammar; each tuple is of the form
      (opExpr, numTerms, rightLeftAssoc, parseAction), where:
       - opExpr is the pyparsing expression for the operator;
          may also be a string, which will be converted to a Literal;
          if numTerms is 3, opExpr is a tuple of two expressions, for the
          two operators separating the 3 terms
       - numTerms is the number of terms for this operator (must
          be 1, 2, or 3)
       - rightLeftAssoc is the indicator whether the operator is
          right or left associative, using the pyparsing-defined
          constants C{opAssoc.RIGHT} and C{opAssoc.LEFT}.
       - parseAction is the parse action to be associated with
          expressions matching this operator expression (the
          parse action tuple member may be omitted); if the parse action
          is passed a tuple or list of functions, this is equivalent to
          calling C{setParseAction(*fn)} (L{ParserElement.setParseAction})
     - lpar - expression for matching left-parentheses (default=C{Suppress('(')})
     - rpar - expression for matching right-parentheses (default=C{Suppress(')')})

    Example::
        # simple example of four-function arithmetic with ints and variable names
        integer = pyparsing_common.signed_integer
        varname = pyparsing_common.identifier 
        
        arith_expr = infixNotation(integer | varname,
            [
            ('-', 1, opAssoc.RIGHT),
            (oneOf('* /'), 2, opAssoc.LEFT),
            (oneOf('+ -'), 2, opAssoc.LEFT),
            ])
        
        arith_expr.runTests('''
            5+3*6
            (5+3)*6
            -2--11
            ''', fullDump=False)
    prints::
        5+3*6
        [[5, '+', [3, '*', 6]]]

        (5+3)*6
        [[[5, '+', 3], '*', 6]]

        -2--11
        [[['-', 2], '-', ['-', 11]]]
    """
    ret = Forward()
    lastExpr = baseExpr | ( lpar + ret + rpar )
    for i,operDef in enumerate(opList):
        opExpr,arity,rightLeftAssoc,pa = (operDef + (None,))[:4]
        termName = "%s term" % opExpr if arity < 3 else "%s%s term" % opExpr
        if arity == 3:
            if opExpr is None or len(opExpr) != 2:
                raise ValueError("if numterms=3, opExpr must be a tuple or list of two expressions")
            opExpr1, opExpr2 = opExpr
        thisExpr = Forward().setName(termName)
        if rightLeftAssoc == opAssoc.LEFT:
            if arity == 1:
                matchExpr = FollowedBy(lastExpr + opExpr) + Group( lastExpr + OneOrMore( opExpr ) )
            elif arity == 2:
                if opExpr is not None:
                    matchExpr = FollowedBy(lastExpr + opExpr + lastExpr) + Group( lastExpr + OneOrMore( opExpr + lastExpr ) )
                else:
                    matchExpr = FollowedBy(lastExpr+lastExpr) + Group( lastExpr + OneOrMore(lastExpr) )
            elif arity == 3:
                matchExpr = FollowedBy(lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr) + \
                            Group( lastExpr + opExpr1 + lastExpr + opExpr2 + lastExpr )
            else:
                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
        elif rightLeftAssoc == opAssoc.RIGHT:
            if arity == 1:
                # try to avoid LR with this extra test
                if not isinstance(opExpr, Optional):
                    opExpr = Optional(opExpr)
                matchExpr = FollowedBy(opExpr.expr + thisExpr) + Group( opExpr + thisExpr )
            elif arity == 2:
                if opExpr is not None:
                    matchExpr = FollowedBy(lastExpr + opExpr + thisExpr) + Group( lastExpr + OneOrMore( opExpr + thisExpr ) )
                else:
                    matchExpr = FollowedBy(lastExpr + thisExpr) + Group( lastExpr + OneOrMore( thisExpr ) )
            elif arity == 3:
                matchExpr = FollowedBy(lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr) + \
                            Group( lastExpr + opExpr1 + thisExpr + opExpr2 + thisExpr )
            else:
                raise ValueError("operator must be unary (1), binary (2), or ternary (3)")
        else:
            raise ValueError("operator must indicate right or left associativity")
        if pa:
            if isinstance(pa, (tuple, list)):
                matchExpr.setParseAction(*pa)
            else:
                matchExpr.setParseAction(pa)
        thisExpr <<= ( matchExpr.setName(termName) | lastExpr )
        lastExpr = thisExpr
    ret <<= lastExpr
    return ret

operatorPrecedence = infixNotation
"""(Deprecated) Former name of C{L{infixNotation}}, will be dropped in a future release."""

dblQuotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"').setName("string enclosed in double quotes")
sglQuotedString = Combine(Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("string enclosed in single quotes")
quotedString = Combine(Regex(r'"(?:[^"\n\r\\]|(?:"")|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*')+'"'|
                       Regex(r"'(?:[^'\n\r\\]|(?:'')|(?:\\(?:[^x]|x[0-9a-fA-F]+)))*")+"'").setName("quotedString using single or double quotes")
unicodeString = Combine(_L('u') + quotedString.copy()).setName("unicode string literal")

def nestedExpr(opener="(", closer=")", content=None, ignoreExpr=quotedString.copy()):
    """
    Helper method for defining nested lists enclosed in opening and closing
    delimiters ("(" and ")" are the default).

    Parameters:
     - opener - opening character for a nested list (default=C{"("}); can also be a pyparsing expression
     - closer - closing character for a nested list (default=C{")"}); can also be a pyparsing expression
     - content - expression for items within the nested lists (default=C{None})
     - ignoreExpr - expression for ignoring opening and closing delimiters (default=C{quotedString})

    If an expression is not provided for the content argument, the nested
    expression will capture all whitespace-delimited content between delimiters
    as a list of separate values.

    Use the C{ignoreExpr} argument to define expressions that may contain
    opening or closing characters that should not be treated as opening
    or closing characters for nesting, such as quotedString or a comment
    expression.  Specify multiple expressions using an C{L{Or}} or C{L{MatchFirst}}.
    The default is L{quotedString}, but if no expressions are to be ignored,
    then pass C{None} for this argument.

    Example::
        data_type = oneOf("void int short long char float double")
        decl_data_type = Combine(data_type + Optional(Word('*')))
        ident = Word(alphas+'_', alphanums+'_')
        number = pyparsing_common.number
        arg = Group(decl_data_type + ident)
        LPAR,RPAR = map(Suppress, "()")

        code_body = nestedExpr('{', '}', ignoreExpr=(quotedString | cStyleComment))

        c_function = (decl_data_type("type") 
                      + ident("name")
                      + LPAR + Optional(delimitedList(arg), [])("args") + RPAR 
                      + code_body("body"))
        c_function.ignore(cStyleComment)
        
        source_code = '''
            int is_odd(int x) { 
                return (x%2); 
            }
                
            int dec_to_hex(char hchar) { 
                if (hchar >= '0' && hchar <= '9') { 
                    return (ord(hchar)-ord('0')); 
                } else { 
                    return (10+ord(hchar)-ord('A'));
                } 
            }
        '''
        for func in c_function.searchString(source_code):
            print("%(name)s (%(type)s) args: %(args)s" % func)

    prints::
        is_odd (int) args: [['int', 'x']]
        dec_to_hex (int) args: [['char', 'hchar']]
    """
    if opener == closer:
        raise ValueError("opening and closing strings cannot be the same")
    if content is None:
        if isinstance(opener,basestring) and isinstance(closer,basestring):
            if len(opener) == 1 and len(closer)==1:
                if ignoreExpr is not None:
                    content = (Combine(OneOrMore(~ignoreExpr +
                                    CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS,exact=1))
                                ).setParseAction(lambda t:t[0].strip()))
                else:
                    content = (empty.copy()+CharsNotIn(opener+closer+ParserElement.DEFAULT_WHITE_CHARS
                                ).setParseAction(lambda t:t[0].strip()))
            else:
                if ignoreExpr is not None:
                    content = (Combine(OneOrMore(~ignoreExpr + 
                                    ~Literal(opener) + ~Literal(closer) +
                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
                                ).setParseAction(lambda t:t[0].strip()))
                else:
                    content = (Combine(OneOrMore(~Literal(opener) + ~Literal(closer) +
                                    CharsNotIn(ParserElement.DEFAULT_WHITE_CHARS,exact=1))
                                ).setParseAction(lambda t:t[0].strip()))
        else:
            raise ValueError("opening and closing arguments must be strings if no content expression is given")
    ret = Forward()
    if ignoreExpr is not None:
        ret <<= Group( Suppress(opener) + ZeroOrMore( ignoreExpr | ret | content ) + Suppress(closer) )
    else:
        ret <<= Group( Suppress(opener) + ZeroOrMore( ret | content )  + Suppress(closer) )
    ret.setName('nested %s%s expression' % (opener,closer))
    return ret

def indentedBlock(blockStatementExpr, indentStack, indent=True):
    """
    Helper method for defining space-delimited indentation blocks, such as
    those used to define block statements in Python source code.

    Parameters:
     - blockStatementExpr - expression defining syntax of statement that
            is repeated within the indented block
     - indentStack - list created by caller to manage indentation stack
            (multiple statementWithIndentedBlock expressions within a single grammar
            should share a common indentStack)
     - indent - boolean indicating whether block must be indented beyond the
            the current level; set to False for block of left-most statements
            (default=C{True})

    A valid block must contain at least one C{blockStatement}.

    Example::
        data = '''
        def A(z):
          A1
          B = 100
          G = A2
          A2
          A3
        B
        def BB(a,b,c):
          BB1
          def BBA():
            bba1
            bba2
            bba3
        C
        D
        def spam(x,y):
             def eggs(z):
                 pass
        '''


        indentStack = [1]
        stmt = Forward()

        identifier = Word(alphas, alphanums)
        funcDecl = ("def" + identifier + Group( "(" + Optional( delimitedList(identifier) ) + ")" ) + ":")
        func_body = indentedBlock(stmt, indentStack)
        funcDef = Group( funcDecl + func_body )

        rvalue = Forward()
        funcCall = Group(identifier + "(" + Optional(delimitedList(rvalue)) + ")")
        rvalue << (funcCall | identifier | Word(nums))
        assignment = Group(identifier + "=" + rvalue)
        stmt << ( funcDef | assignment | identifier )

        module_body = OneOrMore(stmt)

        parseTree = module_body.parseString(data)
        parseTree.pprint()
    prints::
        [['def',
          'A',
          ['(', 'z', ')'],
          ':',
          [['A1'], [['B', '=', '100']], [['G', '=', 'A2']], ['A2'], ['A3']]],
         'B',
         ['def',
          'BB',
          ['(', 'a', 'b', 'c', ')'],
          ':',
          [['BB1'], [['def', 'BBA', ['(', ')'], ':', [['bba1'], ['bba2'], ['bba3']]]]]],
         'C',
         'D',
         ['def',
          'spam',
          ['(', 'x', 'y', ')'],
          ':',
          [[['def', 'eggs', ['(', 'z', ')'], ':', [['pass']]]]]]] 
    """
    def checkPeerIndent(s,l,t):
        if l >= len(s): return
        curCol = col(l,s)
        if curCol != indentStack[-1]:
            if curCol > indentStack[-1]:
                raise ParseFatalException(s,l,"illegal nesting")
            raise ParseException(s,l,"not a peer entry")

    def checkSubIndent(s,l,t):
        curCol = col(l,s)
        if curCol > indentStack[-1]:
            indentStack.append( curCol )
        else:
            raise ParseException(s,l,"not a subentry")

    def checkUnindent(s,l,t):
        if l >= len(s): return
        curCol = col(l,s)
        if not(indentStack and curCol < indentStack[-1] and curCol <= indentStack[-2]):
            raise ParseException(s,l,"not an unindent")
        indentStack.pop()

    NL = OneOrMore(LineEnd().setWhitespaceChars("\t ").suppress())
    INDENT = (Empty() + Empty().setParseAction(checkSubIndent)).setName('INDENT')
    PEER   = Empty().setParseAction(checkPeerIndent).setName('')
    UNDENT = Empty().setParseAction(checkUnindent).setName('UNINDENT')
    if indent:
        smExpr = Group( Optional(NL) +
            #~ FollowedBy(blockStatementExpr) +
            INDENT + (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) + UNDENT)
    else:
        smExpr = Group( Optional(NL) +
            (OneOrMore( PEER + Group(blockStatementExpr) + Optional(NL) )) )
    blockStatementExpr.ignore(_bslash + LineEnd())
    return smExpr.setName('indented block')

alphas8bit = srange(r"[\0xc0-\0xd6\0xd8-\0xf6\0xf8-\0xff]")
punc8bit = srange(r"[\0xa1-\0xbf\0xd7\0xf7]")

anyOpenTag,anyCloseTag = makeHTMLTags(Word(alphas,alphanums+"_:").setName('any tag'))
_htmlEntityMap = dict(zip("gt lt amp nbsp quot apos".split(),'><& "\''))
commonHTMLEntity = Regex('&(?P<entity>' + '|'.join(_htmlEntityMap.keys()) +");").setName("common HTML entity")
def replaceHTMLEntity(t):
    """Helper parser action to replace common HTML entities with their special characters"""
    return _htmlEntityMap.get(t.entity)

# it's easy to get these comment structures wrong - they're very common, so may as well make them available
cStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/').setName("C style comment")
"Comment of the form C{/* ... */}"

htmlComment = Regex(r"<!--[\s\S]*?-->").setName("HTML comment")
"Comment of the form C{<!-- ... -->}"

restOfLine = Regex(r".*").leaveWhitespace().setName("rest of line")
dblSlashComment = Regex(r"//(?:\\\n|[^\n])*").setName("// comment")
"Comment of the form C{// ... (to end of line)}"

cppStyleComment = Combine(Regex(r"/\*(?:[^*]|\*(?!/))*") + '*/'| dblSlashComment).setName("C++ style comment")
"Comment of either form C{L{cStyleComment}} or C{L{dblSlashComment}}"

javaStyleComment = cppStyleComment
"Same as C{L{cppStyleComment}}"

pythonStyleComment = Regex(r"#.*").setName("Python style comment")
"Comment of the form C{# ... (to end of line)}"

_commasepitem = Combine(OneOrMore(Word(printables, excludeChars=',') +
                                  Optional( Word(" \t") +
                                            ~Literal(",") + ~LineEnd() ) ) ).streamline().setName("commaItem")
commaSeparatedList = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("commaSeparatedList")
"""(Deprecated) Predefined expression of 1 or more printable words or quoted strings, separated by commas.
   This expression is deprecated in favor of L{pyparsing_common.comma_separated_list}."""

# some other useful expressions - using lower-case class name since we are really using this as a namespace
class pyparsing_common:
    """
    Here are some common low-level expressions that may be useful in jump-starting parser development:
     - numeric forms (L{integers<integer>}, L{reals<real>}, L{scientific notation<sci_real>})
     - common L{programming identifiers<identifier>}
     - network addresses (L{MAC<mac_address>}, L{IPv4<ipv4_address>}, L{IPv6<ipv6_address>})
     - ISO8601 L{dates<iso8601_date>} and L{datetime<iso8601_datetime>}
     - L{UUID<uuid>}
     - L{comma-separated list<comma_separated_list>}
    Parse actions:
     - C{L{convertToInteger}}
     - C{L{convertToFloat}}
     - C{L{convertToDate}}
     - C{L{convertToDatetime}}
     - C{L{stripHTMLTags}}
     - C{L{upcaseTokens}}
     - C{L{downcaseTokens}}

    Example::
        pyparsing_common.number.runTests('''
            # any int or real number, returned as the appropriate type
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.fnumber.runTests('''
            # any int or real number, returned as float
            100
            -100
            +100
            3.14159
            6.02e23
            1e-12
            ''')

        pyparsing_common.hex_integer.runTests('''
            # hex numbers
            100
            FF
            ''')

        pyparsing_common.fraction.runTests('''
            # fractions
            1/2
            -3/4
            ''')

        pyparsing_common.mixed_integer.runTests('''
            # mixed fractions
            1
            1/2
            -3/4
            1-3/4
            ''')

        import uuid
        pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
        pyparsing_common.uuid.runTests('''
            # uuid
            12345678-1234-5678-1234-567812345678
            ''')
    prints::
        # any int or real number, returned as the appropriate type
        100
        [100]

        -100
        [-100]

        +100
        [100]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # any int or real number, returned as float
        100
        [100.0]

        -100
        [-100.0]

        +100
        [100.0]

        3.14159
        [3.14159]

        6.02e23
        [6.02e+23]

        1e-12
        [1e-12]

        # hex numbers
        100
        [256]

        FF
        [255]

        # fractions
        1/2
        [0.5]

        -3/4
        [-0.75]

        # mixed fractions
        1
        [1]

        1/2
        [0.5]

        -3/4
        [-0.75]

        1-3/4
        [1.75]

        # uuid
        12345678-1234-5678-1234-567812345678
        [UUID('12345678-1234-5678-1234-567812345678')]
    """

    convertToInteger = tokenMap(int)
    """
    Parse action for converting parsed integers to Python int
    """

    convertToFloat = tokenMap(float)
    """
    Parse action for converting parsed numbers to Python float
    """

    integer = Word(nums).setName("integer").setParseAction(convertToInteger)
    """expression that parses an unsigned integer, returns an int"""

    hex_integer = Word(hexnums).setName("hex integer").setParseAction(tokenMap(int,16))
    """expression that parses a hexadecimal integer, returns an int"""

    signed_integer = Regex(r'[+-]?\d+').setName("signed integer").setParseAction(convertToInteger)
    """expression that parses an integer with optional leading sign, returns an int"""

    fraction = (signed_integer().setParseAction(convertToFloat) + '/' + signed_integer().setParseAction(convertToFloat)).setName("fraction")
    """fractional expression of an integer divided by an integer, returns a float"""
    fraction.addParseAction(lambda t: t[0]/t[-1])

    mixed_integer = (fraction | signed_integer + Optional(Optional('-').suppress() + fraction)).setName("fraction or mixed integer-fraction")
    """mixed integer of the form 'integer - fraction', with optional leading integer, returns float"""
    mixed_integer.addParseAction(sum)

    real = Regex(r'[+-]?\d+\.\d*').setName("real number").setParseAction(convertToFloat)
    """expression that parses a floating point number and returns a float"""

    sci_real = Regex(r'[+-]?\d+([eE][+-]?\d+|\.\d*([eE][+-]?\d+)?)').setName("real number with scientific notation").setParseAction(convertToFloat)
    """expression that parses a floating point number with optional scientific notation and returns a float"""

    # streamlining this expression makes the docs nicer-looking
    number = (sci_real | real | signed_integer).streamline()
    """any numeric expression, returns the corresponding Python type"""

    fnumber = Regex(r'[+-]?\d+\.?\d*([eE][+-]?\d+)?').setName("fnumber").setParseAction(convertToFloat)
    """any int or real number, returned as float"""
    
    identifier = Word(alphas+'_', alphanums+'_').setName("identifier")
    """typical code identifier (leading alpha or '_', followed by 0 or more alphas, nums, or '_')"""
    
    ipv4_address = Regex(r'(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})(\.(25[0-5]|2[0-4][0-9]|1?[0-9]{1,2})){3}').setName("IPv4 address")
    "IPv4 address (C{0.0.0.0 - 255.255.255.255})"

    _ipv6_part = Regex(r'[0-9a-fA-F]{1,4}').setName("hex_integer")
    _full_ipv6_address = (_ipv6_part + (':' + _ipv6_part)*7).setName("full IPv6 address")
    _short_ipv6_address = (Optional(_ipv6_part + (':' + _ipv6_part)*(0,6)) + "::" + Optional(_ipv6_part + (':' + _ipv6_part)*(0,6))).setName("short IPv6 address")
    _short_ipv6_address.addCondition(lambda t: sum(1 for tt in t if pyparsing_common._ipv6_part.matches(tt)) < 8)
    _mixed_ipv6_address = ("::ffff:" + ipv4_address).setName("mixed IPv6 address")
    ipv6_address = Combine((_full_ipv6_address | _mixed_ipv6_address | _short_ipv6_address).setName("IPv6 address")).setName("IPv6 address")
    "IPv6 address (long, short, or mixed form)"
    
    mac_address = Regex(r'[0-9a-fA-F]{2}([:.-])[0-9a-fA-F]{2}(?:\1[0-9a-fA-F]{2}){4}').setName("MAC address")
    "MAC address xx:xx:xx:xx:xx (may also have '-' or '.' delimiters)"

    @staticmethod
    def convertToDate(fmt="%Y-%m-%d"):
        """
        Helper to create a parse action for converting parsed date string to Python datetime.date

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%d"})

        Example::
            date_expr = pyparsing_common.iso8601_date.copy()
            date_expr.setParseAction(pyparsing_common.convertToDate())
            print(date_expr.parseString("1999-12-31"))
        prints::
            [datetime.date(1999, 12, 31)]
        """
        def cvt_fn(s,l,t):
            try:
                return datetime.strptime(t[0], fmt).date()
            except ValueError as ve:
                raise ParseException(s, l, str(ve))
        return cvt_fn

    @staticmethod
    def convertToDatetime(fmt="%Y-%m-%dT%H:%M:%S.%f"):
        """
        Helper to create a parse action for converting parsed datetime string to Python datetime.datetime

        Params -
         - fmt - format to be passed to datetime.strptime (default=C{"%Y-%m-%dT%H:%M:%S.%f"})

        Example::
            dt_expr = pyparsing_common.iso8601_datetime.copy()
            dt_expr.setParseAction(pyparsing_common.convertToDatetime())
            print(dt_expr.parseString("1999-12-31T23:59:59.999"))
        prints::
            [datetime.datetime(1999, 12, 31, 23, 59, 59, 999000)]
        """
        def cvt_fn(s,l,t):
            try:
                return datetime.strptime(t[0], fmt)
            except ValueError as ve:
                raise ParseException(s, l, str(ve))
        return cvt_fn

    iso8601_date = Regex(r'(?P<year>\d{4})(?:-(?P<month>\d\d)(?:-(?P<day>\d\d))?)?').setName("ISO8601 date")
    "ISO8601 date (C{yyyy-mm-dd})"

    iso8601_datetime = Regex(r'(?P<year>\d{4})-(?P<month>\d\d)-(?P<day>\d\d)[T ](?P<hour>\d\d):(?P<minute>\d\d)(:(?P<second>\d\d(\.\d*)?)?)?(?P<tz>Z|[+-]\d\d:?\d\d)?').setName("ISO8601 datetime")
    "ISO8601 datetime (C{yyyy-mm-ddThh:mm:ss.s(Z|+-00:00)}) - trailing seconds, milliseconds, and timezone optional; accepts separating C{'T'} or C{' '}"

    uuid = Regex(r'[0-9a-fA-F]{8}(-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}').setName("UUID")
    "UUID (C{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx})"

    _html_stripper = anyOpenTag.suppress() | anyCloseTag.suppress()
    @staticmethod
    def stripHTMLTags(s, l, tokens):
        """
        Parse action to remove HTML tags from web page HTML source

        Example::
            # strip HTML links from normal text 
            text = '<td>More info at the <a href="http://pyparsing.wikispaces.com">pyparsing</a> wiki page</td>'
            td,td_end = makeHTMLTags("TD")
            table_text = td + SkipTo(td_end).setParseAction(pyparsing_common.stripHTMLTags)("body") + td_end
            
            print(table_text.parseString(text).body) # -> 'More info at the pyparsing wiki page'
        """
        return pyparsing_common._html_stripper.transformString(tokens[0])

    _commasepitem = Combine(OneOrMore(~Literal(",") + ~LineEnd() + Word(printables, excludeChars=',') 
                                        + Optional( White(" \t") ) ) ).streamline().setName("commaItem")
    comma_separated_list = delimitedList( Optional( quotedString.copy() | _commasepitem, default="") ).setName("comma separated list")
    """Predefined expression of 1 or more printable words or quoted strings, separated by commas."""

    upcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).upper()))
    """Parse action to convert tokens to upper case."""

    downcaseTokens = staticmethod(tokenMap(lambda t: _ustr(t).lower()))
    """Parse action to convert tokens to lower case."""


if __name__ == "__main__":

    selectToken    = CaselessLiteral("select")
    fromToken      = CaselessLiteral("from")

    ident          = Word(alphas, alphanums + "_$")

    columnName     = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
    columnNameList = Group(delimitedList(columnName)).setName("columns")
    columnSpec     = ('*' | columnNameList)

    tableName      = delimitedList(ident, ".", combine=True).setParseAction(upcaseTokens)
    tableNameList  = Group(delimitedList(tableName)).setName("tables")
    
    simpleSQL      = selectToken("command") + columnSpec("columns") + fromToken + tableNameList("tables")

    # demo runTests method, including embedded comments in test string
    simpleSQL.runTests("""
        # '*' as column list and dotted table name
        select * from SYS.XYZZY

        # caseless match on "SELECT", and casts back to "select"
        SELECT * from XYZZY, ABC

        # list of column names, and mixed case SELECT keyword
        Select AA,BB,CC from Sys.dual

        # multiple tables
        Select A, B, C from Sys.dual, Table2

        # invalid SELECT keyword - should fail
        Xelect A, B, C from Sys.dual

        # incomplete command - should fail
        Select

        # invalid column name - should fail
        Select ^^^ frox Sys.dual

        """)

    pyparsing_common.number.runTests("""
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        """)

    # any int or real number, returned as float
    pyparsing_common.fnumber.runTests("""
        100
        -100
        +100
        3.14159
        6.02e23
        1e-12
        """)

    pyparsing_common.hex_integer.runTests("""
        100
        FF
        """)

    import uuid
    pyparsing_common.uuid.setParseAction(tokenMap(uuid.UUID))
    pyparsing_common.uuid.runTests("""
        12345678-1234-5678-1234-567812345678
        """)
site-packages/setuptools/_imp.py000064400000004257151446177000013020 0ustar00"""
Re-implementation of find_module and get_frozen_object
from the deprecated imp module.
"""

import os
import importlib.util
import importlib.machinery

from .py34compat import module_from_spec


PY_SOURCE = 1
PY_COMPILED = 2
C_EXTENSION = 3
C_BUILTIN = 6
PY_FROZEN = 7


def find_module(module, paths=None):
    """Just like 'imp.find_module()', but with package support"""
    spec = importlib.util.find_spec(module, paths)
    if spec is None:
        raise ImportError("Can't find %s" % module)
    if not spec.has_location and hasattr(spec, 'submodule_search_locations'):
        spec = importlib.util.spec_from_loader('__init__.py', spec.loader)

    kind = -1
    file = None
    static = isinstance(spec.loader, type)
    if spec.origin == 'frozen' or static and issubclass(
            spec.loader, importlib.machinery.FrozenImporter):
        kind = PY_FROZEN
        path = None  # imp compabilty
        suffix = mode = ''  # imp compability
    elif spec.origin == 'built-in' or static and issubclass(
            spec.loader, importlib.machinery.BuiltinImporter):
        kind = C_BUILTIN
        path = None  # imp compabilty
        suffix = mode = ''  # imp compability
    elif spec.has_location:
        path = spec.origin
        suffix = os.path.splitext(path)[1]
        mode = 'r' if suffix in importlib.machinery.SOURCE_SUFFIXES else 'rb'

        if suffix in importlib.machinery.SOURCE_SUFFIXES:
            kind = PY_SOURCE
        elif suffix in importlib.machinery.BYTECODE_SUFFIXES:
            kind = PY_COMPILED
        elif suffix in importlib.machinery.EXTENSION_SUFFIXES:
            kind = C_EXTENSION

        if kind in {PY_SOURCE, PY_COMPILED}:
            file = open(path, mode)
    else:
        path = None
        suffix = mode = ''

    return file, path, (suffix, mode, kind)


def get_frozen_object(module, paths=None):
    spec = importlib.util.find_spec(module, paths)
    if not spec:
        raise ImportError("Can't find %s" % module)
    return spec.loader.get_code(module)


def get_module(module, paths, info):
    spec = importlib.util.find_spec(module, paths)
    if not spec:
        raise ImportError("Can't find %s" % module)
    return module_from_spec(spec)
site-packages/setuptools/extension.py000064400000003301151446177000014075 0ustar00import re
import functools
import distutils.core
import distutils.errors
import distutils.extension

from setuptools.extern.six.moves import map

from .monkey import get_unpatched


def _have_cython():
    """
    Return True if Cython can be imported.
    """
    cython_impl = 'Cython.Distutils.build_ext'
    try:
        # from (cython_impl) import build_ext
        __import__(cython_impl, fromlist=['build_ext']).build_ext
        return True
    except Exception:
        pass
    return False


# for compatibility
have_pyrex = _have_cython

_Extension = get_unpatched(distutils.core.Extension)


class Extension(_Extension):
    """Extension that uses '.c' files in place of '.pyx' files"""

    def __init__(self, name, sources, *args, **kw):
        # The *args is needed for compatibility as calls may use positional
        # arguments. py_limited_api may be set only via keyword.
        self.py_limited_api = kw.pop("py_limited_api", False)
        _Extension.__init__(self, name, sources, *args, **kw)

    def _convert_pyx_sources_to_lang(self):
        """
        Replace sources with .pyx extensions to sources with the target
        language extension. This mechanism allows language authors to supply
        pre-converted sources but to prefer the .pyx sources.
        """
        if _have_cython():
            # the build has Cython, so allow it to compile the .pyx files
            return
        lang = self.language or ''
        target_ext = '.cpp' if lang.lower() == 'c++' else '.c'
        sub = functools.partial(re.sub, '.pyx$', target_ext)
        self.sources = list(map(sub, self.sources))


class Library(Extension):
    """Just like a regular Extension, but built as a library instead"""
site-packages/setuptools/archive_util.py000064400000014700151446177000014544 0ustar00"""Utilities for extracting common archive formats"""

import zipfile
import tarfile
import os
import shutil
import posixpath
import contextlib
from distutils.errors import DistutilsError

from pkg_resources import ensure_directory

__all__ = [
    "unpack_archive", "unpack_zipfile", "unpack_tarfile", "default_filter",
    "UnrecognizedFormat", "extraction_drivers", "unpack_directory",
]


class UnrecognizedFormat(DistutilsError):
    """Couldn't recognize the archive type"""


def default_filter(src, dst):
    """The default progress/filter callback; returns True for all files"""
    return dst


def unpack_archive(filename, extract_dir, progress_filter=default_filter,
        drivers=None):
    """Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``

    `progress_filter` is a function taking two arguments: a source path
    internal to the archive ('/'-separated), and a filesystem path where it
    will be extracted.  The callback must return the desired extract path
    (which may be the same as the one passed in), or else ``None`` to skip
    that file or directory.  The callback can thus be used to report on the
    progress of the extraction, as well as to filter the items extracted or
    alter their extraction paths.

    `drivers`, if supplied, must be a non-empty sequence of functions with the
    same signature as this function (minus the `drivers` argument), that raise
    ``UnrecognizedFormat`` if they do not support extracting the designated
    archive type.  The `drivers` are tried in sequence until one is found that
    does not raise an error, or until all are exhausted (in which case
    ``UnrecognizedFormat`` is raised).  If you do not supply a sequence of
    drivers, the module's ``extraction_drivers`` constant will be used, which
    means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that
    order.
    """
    for driver in drivers or extraction_drivers:
        try:
            driver(filename, extract_dir, progress_filter)
        except UnrecognizedFormat:
            continue
        else:
            return
    else:
        raise UnrecognizedFormat(
            "Not a recognized archive type: %s" % filename
        )


def unpack_directory(filename, extract_dir, progress_filter=default_filter):
    """"Unpack" a directory, using the same interface as for archives

    Raises ``UnrecognizedFormat`` if `filename` is not a directory
    """
    if not os.path.isdir(filename):
        raise UnrecognizedFormat("%s is not a directory" % filename)

    paths = {
        filename: ('', extract_dir),
    }
    for base, dirs, files in os.walk(filename):
        src, dst = paths[base]
        for d in dirs:
            paths[os.path.join(base, d)] = src + d + '/', os.path.join(dst, d)
        for f in files:
            target = os.path.join(dst, f)
            target = progress_filter(src + f, target)
            if not target:
                # skip non-files
                continue
            ensure_directory(target)
            f = os.path.join(base, f)
            shutil.copyfile(f, target)
            shutil.copystat(f, target)


def unpack_zipfile(filename, extract_dir, progress_filter=default_filter):
    """Unpack zip `filename` to `extract_dir`

    Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined
    by ``zipfile.is_zipfile()``).  See ``unpack_archive()`` for an explanation
    of the `progress_filter` argument.
    """

    if not zipfile.is_zipfile(filename):
        raise UnrecognizedFormat("%s is not a zip file" % (filename,))

    with zipfile.ZipFile(filename) as z:
        for info in z.infolist():
            name = info.filename

            # don't extract absolute paths or ones with .. in them
            if name.startswith('/') or '..' in name.split('/'):
                continue

            target = os.path.join(extract_dir, *name.split('/'))
            target = progress_filter(name, target)
            if not target:
                continue
            if name.endswith('/'):
                # directory
                ensure_directory(target)
            else:
                # file
                ensure_directory(target)
                data = z.read(info.filename)
                with open(target, 'wb') as f:
                    f.write(data)
            unix_attributes = info.external_attr >> 16
            if unix_attributes:
                os.chmod(target, unix_attributes)


def unpack_tarfile(filename, extract_dir, progress_filter=default_filter):
    """Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir`

    Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined
    by ``tarfile.open()``).  See ``unpack_archive()`` for an explanation
    of the `progress_filter` argument.
    """
    try:
        tarobj = tarfile.open(filename)
    except tarfile.TarError:
        raise UnrecognizedFormat(
            "%s is not a compressed or uncompressed tar file" % (filename,)
        )
    with contextlib.closing(tarobj):
        # don't do any chowning!
        tarobj.chown = lambda *args: None
        for member in tarobj:
            name = member.name
            # don't extract absolute paths or ones with .. in them
            if not name.startswith('/') and '..' not in name.split('/'):
                prelim_dst = os.path.join(extract_dir, *name.split('/'))

                # resolve any links and to extract the link targets as normal
                # files
                while member is not None and (member.islnk() or member.issym()):
                    linkpath = member.linkname
                    if member.issym():
                        base = posixpath.dirname(member.name)
                        linkpath = posixpath.join(base, linkpath)
                        linkpath = posixpath.normpath(linkpath)
                    member = tarobj._getmember(linkpath)

                if member is not None and (member.isfile() or member.isdir()):
                    final_dst = progress_filter(name, prelim_dst)
                    if final_dst:
                        if final_dst.endswith(os.sep):
                            final_dst = final_dst[:-1]
                        try:
                            # XXX Ugh
                            tarobj._extract_member(member, final_dst)
                        except tarfile.ExtractError:
                            # chown/chmod/mkfifo/mknode/makedev failed
                            pass
        return True


extraction_drivers = unpack_directory, unpack_zipfile, unpack_tarfile
site-packages/setuptools/py33compat.py000064400000002462151446177000014072 0ustar00import dis
import array
import collections

try:
    import html
except ImportError:
    html = None

from setuptools.extern import six
from setuptools.extern.six.moves import html_parser

__metaclass__ = type

OpArg = collections.namedtuple('OpArg', 'opcode arg')


class Bytecode_compat:
    def __init__(self, code):
        self.code = code

    def __iter__(self):
        """Yield '(op,arg)' pair for each operation in code object 'code'"""

        bytes = array.array('b', self.code.co_code)
        eof = len(self.code.co_code)

        ptr = 0
        extended_arg = 0

        while ptr < eof:

            op = bytes[ptr]

            if op >= dis.HAVE_ARGUMENT:

                arg = bytes[ptr + 1] + bytes[ptr + 2] * 256 + extended_arg
                ptr += 3

                if op == dis.EXTENDED_ARG:
                    long_type = six.integer_types[-1]
                    extended_arg = arg * long_type(65536)
                    continue

            else:
                arg = None
                ptr += 1

            yield OpArg(op, arg)


Bytecode = getattr(dis, 'Bytecode', Bytecode_compat)


unescape = getattr(html, 'unescape', None)
if unescape is None:
    # HTMLParser.unescape is deprecated since Python 3.4, and will be removed
    # from 3.9.
    unescape = html_parser.HTMLParser().unescape
site-packages/setuptools/site-patch.py000064400000004376151446177000014137 0ustar00def __boot():
    import sys
    import os
    PYTHONPATH = os.environ.get('PYTHONPATH')
    if PYTHONPATH is None or (sys.platform == 'win32' and not PYTHONPATH):
        PYTHONPATH = []
    else:
        PYTHONPATH = PYTHONPATH.split(os.pathsep)

    pic = getattr(sys, 'path_importer_cache', {})
    stdpath = sys.path[len(PYTHONPATH):]
    mydir = os.path.dirname(__file__)

    for item in stdpath:
        if item == mydir or not item:
            continue  # skip if current dir. on Windows, or my own directory
        importer = pic.get(item)
        if importer is not None:
            loader = importer.find_module('site')
            if loader is not None:
                # This should actually reload the current module
                loader.load_module('site')
                break
        else:
            try:
                import imp  # Avoid import loop in Python 3
                stream, path, descr = imp.find_module('site', [item])
            except ImportError:
                continue
            if stream is None:
                continue
            try:
                # This should actually reload the current module
                imp.load_module('site', stream, path, descr)
            finally:
                stream.close()
            break
    else:
        raise ImportError("Couldn't find the real 'site' module")

    known_paths = dict([(makepath(item)[1], 1) for item in sys.path])  # 2.2 comp

    oldpos = getattr(sys, '__egginsert', 0)  # save old insertion position
    sys.__egginsert = 0  # and reset the current one

    for item in PYTHONPATH:
        addsitedir(item)

    sys.__egginsert += oldpos  # restore effective old position

    d, nd = makepath(stdpath[0])
    insert_at = None
    new_path = []

    for item in sys.path:
        p, np = makepath(item)

        if np == nd and insert_at is None:
            # We've hit the first 'system' path entry, so added entries go here
            insert_at = len(new_path)

        if np in known_paths or insert_at is None:
            new_path.append(item)
        else:
            # new path after the insert point, back-insert it
            new_path.insert(insert_at, item)
            insert_at += 1

    sys.path[:] = new_path


if __name__ == 'site':
    __boot()
    del __boot
site-packages/setuptools/msvc.py000064400000133237151446177000013045 0ustar00"""
Improved support for Microsoft Visual C++ compilers.

Known supported compilers:
--------------------------
Microsoft Visual C++ 9.0:
    Microsoft Visual C++ Compiler for Python 2.7 (x86, amd64)
    Microsoft Windows SDK 6.1 (x86, x64, ia64)
    Microsoft Windows SDK 7.0 (x86, x64, ia64)

Microsoft Visual C++ 10.0:
    Microsoft Windows SDK 7.1 (x86, x64, ia64)

Microsoft Visual C++ 14.X:
    Microsoft Visual C++ Build Tools 2015 (x86, x64, arm)
    Microsoft Visual Studio Build Tools 2017 (x86, x64, arm, arm64)
    Microsoft Visual Studio Build Tools 2019 (x86, x64, arm, arm64)

This may also support compilers shipped with compatible Visual Studio versions.
"""

import json
from io import open
from os import listdir, pathsep
from os.path import join, isfile, isdir, dirname
import sys
import platform
import itertools
import distutils.errors
from setuptools.extern.packaging.version import LegacyVersion

from setuptools.extern.six.moves import filterfalse

from .monkey import get_unpatched

if platform.system() == 'Windows':
    from setuptools.extern.six.moves import winreg
    from os import environ
else:
    # Mock winreg and environ so the module can be imported on this platform.

    class winreg:
        HKEY_USERS = None
        HKEY_CURRENT_USER = None
        HKEY_LOCAL_MACHINE = None
        HKEY_CLASSES_ROOT = None

    environ = dict()

_msvc9_suppress_errors = (
    # msvc9compiler isn't available on some platforms
    ImportError,

    # msvc9compiler raises DistutilsPlatformError in some
    # environments. See #1118.
    distutils.errors.DistutilsPlatformError,
)

try:
    from distutils.msvc9compiler import Reg
except _msvc9_suppress_errors:
    pass


def msvc9_find_vcvarsall(version):
    """
    Patched "distutils.msvc9compiler.find_vcvarsall" to use the standalone
    compiler build for Python
    (VCForPython / Microsoft Visual C++ Compiler for Python 2.7).

    Fall back to original behavior when the standalone compiler is not
    available.

    Redirect the path of "vcvarsall.bat".

    Parameters
    ----------
    version: float
        Required Microsoft Visual C++ version.

    Return
    ------
    str
        vcvarsall.bat path
    """
    vc_base = r'Software\%sMicrosoft\DevDiv\VCForPython\%0.1f'
    key = vc_base % ('', version)
    try:
        # Per-user installs register the compiler path here
        productdir = Reg.get_value(key, "installdir")
    except KeyError:
        try:
            # All-user installs on a 64-bit system register here
            key = vc_base % ('Wow6432Node\\', version)
            productdir = Reg.get_value(key, "installdir")
        except KeyError:
            productdir = None

    if productdir:
        vcvarsall = join(productdir, "vcvarsall.bat")
        if isfile(vcvarsall):
            return vcvarsall

    return get_unpatched(msvc9_find_vcvarsall)(version)


def msvc9_query_vcvarsall(ver, arch='x86', *args, **kwargs):
    """
    Patched "distutils.msvc9compiler.query_vcvarsall" for support extra
    Microsoft Visual C++ 9.0 and 10.0 compilers.

    Set environment without use of "vcvarsall.bat".

    Parameters
    ----------
    ver: float
        Required Microsoft Visual C++ version.
    arch: str
        Target architecture.

    Return
    ------
    dict
        environment
    """
    # Try to get environment from vcvarsall.bat (Classical way)
    try:
        orig = get_unpatched(msvc9_query_vcvarsall)
        return orig(ver, arch, *args, **kwargs)
    except distutils.errors.DistutilsPlatformError:
        # Pass error if Vcvarsall.bat is missing
        pass
    except ValueError:
        # Pass error if environment not set after executing vcvarsall.bat
        pass

    # If error, try to set environment directly
    try:
        return EnvironmentInfo(arch, ver).return_env()
    except distutils.errors.DistutilsPlatformError as exc:
        _augment_exception(exc, ver, arch)
        raise


def msvc14_get_vc_env(plat_spec):
    """
    Patched "distutils._msvccompiler._get_vc_env" for support extra
    Microsoft Visual C++ 14.X compilers.

    Set environment without use of "vcvarsall.bat".

    Parameters
    ----------
    plat_spec: str
        Target architecture.

    Return
    ------
    dict
        environment
    """
    # Try to get environment from vcvarsall.bat (Classical way)
    try:
        return get_unpatched(msvc14_get_vc_env)(plat_spec)
    except distutils.errors.DistutilsPlatformError:
        # Pass error Vcvarsall.bat is missing
        pass

    # If error, try to set environment directly
    try:
        return EnvironmentInfo(plat_spec, vc_min_ver=14.0).return_env()
    except distutils.errors.DistutilsPlatformError as exc:
        _augment_exception(exc, 14.0)
        raise


def msvc14_gen_lib_options(*args, **kwargs):
    """
    Patched "distutils._msvccompiler.gen_lib_options" for fix
    compatibility between "numpy.distutils" and "distutils._msvccompiler"
    (for Numpy < 1.11.2)
    """
    if "numpy.distutils" in sys.modules:
        import numpy as np
        if LegacyVersion(np.__version__) < LegacyVersion('1.11.2'):
            return np.distutils.ccompiler.gen_lib_options(*args, **kwargs)
    return get_unpatched(msvc14_gen_lib_options)(*args, **kwargs)


def _augment_exception(exc, version, arch=''):
    """
    Add details to the exception message to help guide the user
    as to what action will resolve it.
    """
    # Error if MSVC++ directory not found or environment not set
    message = exc.args[0]

    if "vcvarsall" in message.lower() or "visual c" in message.lower():
        # Special error message if MSVC++ not installed
        tmpl = 'Microsoft Visual C++ {version:0.1f} is required.'
        message = tmpl.format(**locals())
        msdownload = 'www.microsoft.com/download/details.aspx?id=%d'
        if version == 9.0:
            if arch.lower().find('ia64') > -1:
                # For VC++ 9.0, if IA64 support is needed, redirect user
                # to Windows SDK 7.0.
                # Note: No download link available from Microsoft.
                message += ' Get it with "Microsoft Windows SDK 7.0"'
            else:
                # For VC++ 9.0 redirect user to Vc++ for Python 2.7 :
                # This redirection link is maintained by Microsoft.
                # Contact vspython@microsoft.com if it needs updating.
                message += ' Get it from http://aka.ms/vcpython27'
        elif version == 10.0:
            # For VC++ 10.0 Redirect user to Windows SDK 7.1
            message += ' Get it with "Microsoft Windows SDK 7.1": '
            message += msdownload % 8279
        elif version >= 14.0:
            # For VC++ 14.X Redirect user to latest Visual C++ Build Tools
            message += (' Get it with "Build Tools for Visual Studio": '
                        r'https://visualstudio.microsoft.com/downloads/')

    exc.args = (message, )


class PlatformInfo:
    """
    Current and Target Architectures information.

    Parameters
    ----------
    arch: str
        Target architecture.
    """
    current_cpu = environ.get('processor_architecture', '').lower()

    def __init__(self, arch):
        self.arch = arch.lower().replace('x64', 'amd64')

    @property
    def target_cpu(self):
        """
        Return Target CPU architecture.

        Return
        ------
        str
            Target CPU
        """
        return self.arch[self.arch.find('_') + 1:]

    def target_is_x86(self):
        """
        Return True if target CPU is x86 32 bits..

        Return
        ------
        bool
            CPU is x86 32 bits
        """
        return self.target_cpu == 'x86'

    def current_is_x86(self):
        """
        Return True if current CPU is x86 32 bits..

        Return
        ------
        bool
            CPU is x86 32 bits
        """
        return self.current_cpu == 'x86'

    def current_dir(self, hidex86=False, x64=False):
        """
        Current platform specific subfolder.

        Parameters
        ----------
        hidex86: bool
            return '' and not '\x86' if architecture is x86.
        x64: bool
            return '\x64' and not '\amd64' if architecture is amd64.

        Return
        ------
        str
            subfolder: '\target', or '' (see hidex86 parameter)
        """
        return (
            '' if (self.current_cpu == 'x86' and hidex86) else
            r'\x64' if (self.current_cpu == 'amd64' and x64) else
            r'\%s' % self.current_cpu
        )

    def target_dir(self, hidex86=False, x64=False):
        r"""
        Target platform specific subfolder.

        Parameters
        ----------
        hidex86: bool
            return '' and not '\x86' if architecture is x86.
        x64: bool
            return '\x64' and not '\amd64' if architecture is amd64.

        Return
        ------
        str
            subfolder: '\current', or '' (see hidex86 parameter)
        """
        return (
            '' if (self.target_cpu == 'x86' and hidex86) else
            r'\x64' if (self.target_cpu == 'amd64' and x64) else
            r'\%s' % self.target_cpu
        )

    def cross_dir(self, forcex86=False):
        r"""
        Cross platform specific subfolder.

        Parameters
        ----------
        forcex86: bool
            Use 'x86' as current architecture even if current architecture is
            not x86.

        Return
        ------
        str
            subfolder: '' if target architecture is current architecture,
            '\current_target' if not.
        """
        current = 'x86' if forcex86 else self.current_cpu
        return (
            '' if self.target_cpu == current else
            self.target_dir().replace('\\', '\\%s_' % current)
        )


class RegistryInfo:
    """
    Microsoft Visual Studio related registry information.

    Parameters
    ----------
    platform_info: PlatformInfo
        "PlatformInfo" instance.
    """
    HKEYS = (winreg.HKEY_USERS,
             winreg.HKEY_CURRENT_USER,
             winreg.HKEY_LOCAL_MACHINE,
             winreg.HKEY_CLASSES_ROOT)

    def __init__(self, platform_info):
        self.pi = platform_info

    @property
    def visualstudio(self):
        """
        Microsoft Visual Studio root registry key.

        Return
        ------
        str
            Registry key
        """
        return 'VisualStudio'

    @property
    def sxs(self):
        """
        Microsoft Visual Studio SxS registry key.

        Return
        ------
        str
            Registry key
        """
        return join(self.visualstudio, 'SxS')

    @property
    def vc(self):
        """
        Microsoft Visual C++ VC7 registry key.

        Return
        ------
        str
            Registry key
        """
        return join(self.sxs, 'VC7')

    @property
    def vs(self):
        """
        Microsoft Visual Studio VS7 registry key.

        Return
        ------
        str
            Registry key
        """
        return join(self.sxs, 'VS7')

    @property
    def vc_for_python(self):
        """
        Microsoft Visual C++ for Python registry key.

        Return
        ------
        str
            Registry key
        """
        return r'DevDiv\VCForPython'

    @property
    def microsoft_sdk(self):
        """
        Microsoft SDK registry key.

        Return
        ------
        str
            Registry key
        """
        return 'Microsoft SDKs'

    @property
    def windows_sdk(self):
        """
        Microsoft Windows/Platform SDK registry key.

        Return
        ------
        str
            Registry key
        """
        return join(self.microsoft_sdk, 'Windows')

    @property
    def netfx_sdk(self):
        """
        Microsoft .NET Framework SDK registry key.

        Return
        ------
        str
            Registry key
        """
        return join(self.microsoft_sdk, 'NETFXSDK')

    @property
    def windows_kits_roots(self):
        """
        Microsoft Windows Kits Roots registry key.

        Return
        ------
        str
            Registry key
        """
        return r'Windows Kits\Installed Roots'

    def microsoft(self, key, x86=False):
        """
        Return key in Microsoft software registry.

        Parameters
        ----------
        key: str
            Registry key path where look.
        x86: str
            Force x86 software registry.

        Return
        ------
        str
            Registry key
        """
        node64 = '' if self.pi.current_is_x86() or x86 else 'Wow6432Node'
        return join('Software', node64, 'Microsoft', key)

    def lookup(self, key, name):
        """
        Look for values in registry in Microsoft software registry.

        Parameters
        ----------
        key: str
            Registry key path where look.
        name: str
            Value name to find.

        Return
        ------
        str
            value
        """
        key_read = winreg.KEY_READ
        openkey = winreg.OpenKey
        ms = self.microsoft
        for hkey in self.HKEYS:
            try:
                bkey = openkey(hkey, ms(key), 0, key_read)
            except (OSError, IOError):
                if not self.pi.current_is_x86():
                    try:
                        bkey = openkey(hkey, ms(key, True), 0, key_read)
                    except (OSError, IOError):
                        continue
                else:
                    continue
            try:
                return winreg.QueryValueEx(bkey, name)[0]
            except (OSError, IOError):
                pass


class SystemInfo:
    """
    Microsoft Windows and Visual Studio related system information.

    Parameters
    ----------
    registry_info: RegistryInfo
        "RegistryInfo" instance.
    vc_ver: float
        Required Microsoft Visual C++ version.
    """

    # Variables and properties in this class use originals CamelCase variables
    # names from Microsoft source files for more easy comparison.
    WinDir = environ.get('WinDir', '')
    ProgramFiles = environ.get('ProgramFiles', '')
    ProgramFilesx86 = environ.get('ProgramFiles(x86)', ProgramFiles)

    def __init__(self, registry_info, vc_ver=None):
        self.ri = registry_info
        self.pi = self.ri.pi

        self.known_vs_paths = self.find_programdata_vs_vers()

        # Except for VS15+, VC version is aligned with VS version
        self.vs_ver = self.vc_ver = (
                vc_ver or self._find_latest_available_vs_ver())

    def _find_latest_available_vs_ver(self):
        """
        Find the latest VC version

        Return
        ------
        float
            version
        """
        reg_vc_vers = self.find_reg_vs_vers()

        if not (reg_vc_vers or self.known_vs_paths):
            raise distutils.errors.DistutilsPlatformError(
                'No Microsoft Visual C++ version found')

        vc_vers = set(reg_vc_vers)
        vc_vers.update(self.known_vs_paths)
        return sorted(vc_vers)[-1]

    def find_reg_vs_vers(self):
        """
        Find Microsoft Visual Studio versions available in registry.

        Return
        ------
        list of float
            Versions
        """
        ms = self.ri.microsoft
        vckeys = (self.ri.vc, self.ri.vc_for_python, self.ri.vs)
        vs_vers = []
        for hkey in self.ri.HKEYS:
            for key in vckeys:
                try:
                    bkey = winreg.OpenKey(hkey, ms(key), 0, winreg.KEY_READ)
                except (OSError, IOError):
                    continue
                subkeys, values, _ = winreg.QueryInfoKey(bkey)
                for i in range(values):
                    try:
                        ver = float(winreg.EnumValue(bkey, i)[0])
                        if ver not in vs_vers:
                            vs_vers.append(ver)
                    except ValueError:
                        pass
                for i in range(subkeys):
                    try:
                        ver = float(winreg.EnumKey(bkey, i))
                        if ver not in vs_vers:
                            vs_vers.append(ver)
                    except ValueError:
                        pass
        return sorted(vs_vers)

    def find_programdata_vs_vers(self):
        r"""
        Find Visual studio 2017+ versions from information in
        "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances".

        Return
        ------
        dict
            float version as key, path as value.
        """
        vs_versions = {}
        instances_dir = \
            r'C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances'

        try:
            hashed_names = listdir(instances_dir)

        except (OSError, IOError):
            # Directory not exists with all Visual Studio versions
            return vs_versions

        for name in hashed_names:
            try:
                # Get VS installation path from "state.json" file
                state_path = join(instances_dir, name, 'state.json')
                with open(state_path, 'rt', encoding='utf-8') as state_file:
                    state = json.load(state_file)
                vs_path = state['installationPath']

                # Raises OSError if this VS installation does not contain VC
                listdir(join(vs_path, r'VC\Tools\MSVC'))

                # Store version and path
                vs_versions[self._as_float_version(
                    state['installationVersion'])] = vs_path

            except (OSError, IOError, KeyError):
                # Skip if "state.json" file is missing or bad format
                continue

        return vs_versions

    @staticmethod
    def _as_float_version(version):
        """
        Return a string version as a simplified float version (major.minor)

        Parameters
        ----------
        version: str
            Version.

        Return
        ------
        float
            version
        """
        return float('.'.join(version.split('.')[:2]))

    @property
    def VSInstallDir(self):
        """
        Microsoft Visual Studio directory.

        Return
        ------
        str
            path
        """
        # Default path
        default = join(self.ProgramFilesx86,
                       'Microsoft Visual Studio %0.1f' % self.vs_ver)

        # Try to get path from registry, if fail use default path
        return self.ri.lookup(self.ri.vs, '%0.1f' % self.vs_ver) or default

    @property
    def VCInstallDir(self):
        """
        Microsoft Visual C++ directory.

        Return
        ------
        str
            path
        """
        path = self._guess_vc() or self._guess_vc_legacy()

        if not isdir(path):
            msg = 'Microsoft Visual C++ directory not found'
            raise distutils.errors.DistutilsPlatformError(msg)

        return path

    def _guess_vc(self):
        """
        Locate Visual C++ for VS2017+.

        Return
        ------
        str
            path
        """
        if self.vs_ver <= 14.0:
            return ''

        try:
            # First search in known VS paths
            vs_dir = self.known_vs_paths[self.vs_ver]
        except KeyError:
            # Else, search with path from registry
            vs_dir = self.VSInstallDir

        guess_vc = join(vs_dir, r'VC\Tools\MSVC')

        # Subdir with VC exact version as name
        try:
            # Update the VC version with real one instead of VS version
            vc_ver = listdir(guess_vc)[-1]
            self.vc_ver = self._as_float_version(vc_ver)
            return join(guess_vc, vc_ver)
        except (OSError, IOError, IndexError):
            return ''

    def _guess_vc_legacy(self):
        """
        Locate Visual C++ for versions prior to 2017.

        Return
        ------
        str
            path
        """
        default = join(self.ProgramFilesx86,
                       r'Microsoft Visual Studio %0.1f\VC' % self.vs_ver)

        # Try to get "VC++ for Python" path from registry as default path
        reg_path = join(self.ri.vc_for_python, '%0.1f' % self.vs_ver)
        python_vc = self.ri.lookup(reg_path, 'installdir')
        default_vc = join(python_vc, 'VC') if python_vc else default

        # Try to get path from registry, if fail use default path
        return self.ri.lookup(self.ri.vc, '%0.1f' % self.vs_ver) or default_vc

    @property
    def WindowsSdkVersion(self):
        """
        Microsoft Windows SDK versions for specified MSVC++ version.

        Return
        ------
        tuple of str
            versions
        """
        if self.vs_ver <= 9.0:
            return '7.0', '6.1', '6.0a'
        elif self.vs_ver == 10.0:
            return '7.1', '7.0a'
        elif self.vs_ver == 11.0:
            return '8.0', '8.0a'
        elif self.vs_ver == 12.0:
            return '8.1', '8.1a'
        elif self.vs_ver >= 14.0:
            return '10.0', '8.1'

    @property
    def WindowsSdkLastVersion(self):
        """
        Microsoft Windows SDK last version.

        Return
        ------
        str
            version
        """
        return self._use_last_dir_name(join(self.WindowsSdkDir, 'lib'))

    @property
    def WindowsSdkDir(self):
        """
        Microsoft Windows SDK directory.

        Return
        ------
        str
            path
        """
        sdkdir = ''
        for ver in self.WindowsSdkVersion:
            # Try to get it from registry
            loc = join(self.ri.windows_sdk, 'v%s' % ver)
            sdkdir = self.ri.lookup(loc, 'installationfolder')
            if sdkdir:
                break
        if not sdkdir or not isdir(sdkdir):
            # Try to get "VC++ for Python" version from registry
            path = join(self.ri.vc_for_python, '%0.1f' % self.vc_ver)
            install_base = self.ri.lookup(path, 'installdir')
            if install_base:
                sdkdir = join(install_base, 'WinSDK')
        if not sdkdir or not isdir(sdkdir):
            # If fail, use default new path
            for ver in self.WindowsSdkVersion:
                intver = ver[:ver.rfind('.')]
                path = r'Microsoft SDKs\Windows Kits\%s' % intver
                d = join(self.ProgramFiles, path)
                if isdir(d):
                    sdkdir = d
        if not sdkdir or not isdir(sdkdir):
            # If fail, use default old path
            for ver in self.WindowsSdkVersion:
                path = r'Microsoft SDKs\Windows\v%s' % ver
                d = join(self.ProgramFiles, path)
                if isdir(d):
                    sdkdir = d
        if not sdkdir:
            # If fail, use Platform SDK
            sdkdir = join(self.VCInstallDir, 'PlatformSDK')
        return sdkdir

    @property
    def WindowsSDKExecutablePath(self):
        """
        Microsoft Windows SDK executable directory.

        Return
        ------
        str
            path
        """
        # Find WinSDK NetFx Tools registry dir name
        if self.vs_ver <= 11.0:
            netfxver = 35
            arch = ''
        else:
            netfxver = 40
            hidex86 = True if self.vs_ver <= 12.0 else False
            arch = self.pi.current_dir(x64=True, hidex86=hidex86)
        fx = 'WinSDK-NetFx%dTools%s' % (netfxver, arch.replace('\\', '-'))

        # list all possibles registry paths
        regpaths = []
        if self.vs_ver >= 14.0:
            for ver in self.NetFxSdkVersion:
                regpaths += [join(self.ri.netfx_sdk, ver, fx)]

        for ver in self.WindowsSdkVersion:
            regpaths += [join(self.ri.windows_sdk, 'v%sA' % ver, fx)]

        # Return installation folder from the more recent path
        for path in regpaths:
            execpath = self.ri.lookup(path, 'installationfolder')
            if execpath:
                return execpath

    @property
    def FSharpInstallDir(self):
        """
        Microsoft Visual F# directory.

        Return
        ------
        str
            path
        """
        path = join(self.ri.visualstudio, r'%0.1f\Setup\F#' % self.vs_ver)
        return self.ri.lookup(path, 'productdir') or ''

    @property
    def UniversalCRTSdkDir(self):
        """
        Microsoft Universal CRT SDK directory.

        Return
        ------
        str
            path
        """
        # Set Kit Roots versions for specified MSVC++ version
        vers = ('10', '81') if self.vs_ver >= 14.0 else ()

        # Find path of the more recent Kit
        for ver in vers:
            sdkdir = self.ri.lookup(self.ri.windows_kits_roots,
                                    'kitsroot%s' % ver)
            if sdkdir:
                return sdkdir or ''

    @property
    def UniversalCRTSdkLastVersion(self):
        """
        Microsoft Universal C Runtime SDK last version.

        Return
        ------
        str
            version
        """
        return self._use_last_dir_name(join(self.UniversalCRTSdkDir, 'lib'))

    @property
    def NetFxSdkVersion(self):
        """
        Microsoft .NET Framework SDK versions.

        Return
        ------
        tuple of str
            versions
        """
        # Set FxSdk versions for specified VS version
        return (('4.7.2', '4.7.1', '4.7',
                 '4.6.2', '4.6.1', '4.6',
                 '4.5.2', '4.5.1', '4.5')
                if self.vs_ver >= 14.0 else ())

    @property
    def NetFxSdkDir(self):
        """
        Microsoft .NET Framework SDK directory.

        Return
        ------
        str
            path
        """
        sdkdir = ''
        for ver in self.NetFxSdkVersion:
            loc = join(self.ri.netfx_sdk, ver)
            sdkdir = self.ri.lookup(loc, 'kitsinstallationfolder')
            if sdkdir:
                break
        return sdkdir

    @property
    def FrameworkDir32(self):
        """
        Microsoft .NET Framework 32bit directory.

        Return
        ------
        str
            path
        """
        # Default path
        guess_fw = join(self.WinDir, r'Microsoft.NET\Framework')

        # Try to get path from registry, if fail use default path
        return self.ri.lookup(self.ri.vc, 'frameworkdir32') or guess_fw

    @property
    def FrameworkDir64(self):
        """
        Microsoft .NET Framework 64bit directory.

        Return
        ------
        str
            path
        """
        # Default path
        guess_fw = join(self.WinDir, r'Microsoft.NET\Framework64')

        # Try to get path from registry, if fail use default path
        return self.ri.lookup(self.ri.vc, 'frameworkdir64') or guess_fw

    @property
    def FrameworkVersion32(self):
        """
        Microsoft .NET Framework 32bit versions.

        Return
        ------
        tuple of str
            versions
        """
        return self._find_dot_net_versions(32)

    @property
    def FrameworkVersion64(self):
        """
        Microsoft .NET Framework 64bit versions.

        Return
        ------
        tuple of str
            versions
        """
        return self._find_dot_net_versions(64)

    def _find_dot_net_versions(self, bits):
        """
        Find Microsoft .NET Framework versions.

        Parameters
        ----------
        bits: int
            Platform number of bits: 32 or 64.

        Return
        ------
        tuple of str
            versions
        """
        # Find actual .NET version in registry
        reg_ver = self.ri.lookup(self.ri.vc, 'frameworkver%d' % bits)
        dot_net_dir = getattr(self, 'FrameworkDir%d' % bits)
        ver = reg_ver or self._use_last_dir_name(dot_net_dir, 'v') or ''

        # Set .NET versions for specified MSVC++ version
        if self.vs_ver >= 12.0:
            return ver, 'v4.0'
        elif self.vs_ver >= 10.0:
            return 'v4.0.30319' if ver.lower()[:2] != 'v4' else ver, 'v3.5'
        elif self.vs_ver == 9.0:
            return 'v3.5', 'v2.0.50727'
        elif self.vs_ver == 8.0:
            return 'v3.0', 'v2.0.50727'

    @staticmethod
    def _use_last_dir_name(path, prefix=''):
        """
        Return name of the last dir in path or '' if no dir found.

        Parameters
        ----------
        path: str
            Use dirs in this path
        prefix: str
            Use only dirs starting by this prefix

        Return
        ------
        str
            name
        """
        matching_dirs = (
            dir_name
            for dir_name in reversed(listdir(path))
            if isdir(join(path, dir_name)) and
            dir_name.startswith(prefix)
        )
        return next(matching_dirs, None) or ''


class EnvironmentInfo:
    """
    Return environment variables for specified Microsoft Visual C++ version
    and platform : Lib, Include, Path and libpath.

    This function is compatible with Microsoft Visual C++ 9.0 to 14.X.

    Script created by analysing Microsoft environment configuration files like
    "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ...

    Parameters
    ----------
    arch: str
        Target architecture.
    vc_ver: float
        Required Microsoft Visual C++ version. If not set, autodetect the last
        version.
    vc_min_ver: float
        Minimum Microsoft Visual C++ version.
    """

    # Variables and properties in this class use originals CamelCase variables
    # names from Microsoft source files for more easy comparison.

    def __init__(self, arch, vc_ver=None, vc_min_ver=0):
        self.pi = PlatformInfo(arch)
        self.ri = RegistryInfo(self.pi)
        self.si = SystemInfo(self.ri, vc_ver)

        if self.vc_ver < vc_min_ver:
            err = 'No suitable Microsoft Visual C++ version found'
            raise distutils.errors.DistutilsPlatformError(err)

    @property
    def vs_ver(self):
        """
        Microsoft Visual Studio.

        Return
        ------
        float
            version
        """
        return self.si.vs_ver

    @property
    def vc_ver(self):
        """
        Microsoft Visual C++ version.

        Return
        ------
        float
            version
        """
        return self.si.vc_ver

    @property
    def VSTools(self):
        """
        Microsoft Visual Studio Tools.

        Return
        ------
        list of str
            paths
        """
        paths = [r'Common7\IDE', r'Common7\Tools']

        if self.vs_ver >= 14.0:
            arch_subdir = self.pi.current_dir(hidex86=True, x64=True)
            paths += [r'Common7\IDE\CommonExtensions\Microsoft\TestWindow']
            paths += [r'Team Tools\Performance Tools']
            paths += [r'Team Tools\Performance Tools%s' % arch_subdir]

        return [join(self.si.VSInstallDir, path) for path in paths]

    @property
    def VCIncludes(self):
        """
        Microsoft Visual C++ & Microsoft Foundation Class Includes.

        Return
        ------
        list of str
            paths
        """
        return [join(self.si.VCInstallDir, 'Include'),
                join(self.si.VCInstallDir, r'ATLMFC\Include')]

    @property
    def VCLibraries(self):
        """
        Microsoft Visual C++ & Microsoft Foundation Class Libraries.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver >= 15.0:
            arch_subdir = self.pi.target_dir(x64=True)
        else:
            arch_subdir = self.pi.target_dir(hidex86=True)
        paths = ['Lib%s' % arch_subdir, r'ATLMFC\Lib%s' % arch_subdir]

        if self.vs_ver >= 14.0:
            paths += [r'Lib\store%s' % arch_subdir]

        return [join(self.si.VCInstallDir, path) for path in paths]

    @property
    def VCStoreRefs(self):
        """
        Microsoft Visual C++ store references Libraries.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver < 14.0:
            return []
        return [join(self.si.VCInstallDir, r'Lib\store\references')]

    @property
    def VCTools(self):
        """
        Microsoft Visual C++ Tools.

        Return
        ------
        list of str
            paths
        """
        si = self.si
        tools = [join(si.VCInstallDir, 'VCPackages')]

        forcex86 = True if self.vs_ver <= 10.0 else False
        arch_subdir = self.pi.cross_dir(forcex86)
        if arch_subdir:
            tools += [join(si.VCInstallDir, 'Bin%s' % arch_subdir)]

        if self.vs_ver == 14.0:
            path = 'Bin%s' % self.pi.current_dir(hidex86=True)
            tools += [join(si.VCInstallDir, path)]

        elif self.vs_ver >= 15.0:
            host_dir = (r'bin\HostX86%s' if self.pi.current_is_x86() else
                        r'bin\HostX64%s')
            tools += [join(
                si.VCInstallDir, host_dir % self.pi.target_dir(x64=True))]

            if self.pi.current_cpu != self.pi.target_cpu:
                tools += [join(
                    si.VCInstallDir, host_dir % self.pi.current_dir(x64=True))]

        else:
            tools += [join(si.VCInstallDir, 'Bin')]

        return tools

    @property
    def OSLibraries(self):
        """
        Microsoft Windows SDK Libraries.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver <= 10.0:
            arch_subdir = self.pi.target_dir(hidex86=True, x64=True)
            return [join(self.si.WindowsSdkDir, 'Lib%s' % arch_subdir)]

        else:
            arch_subdir = self.pi.target_dir(x64=True)
            lib = join(self.si.WindowsSdkDir, 'lib')
            libver = self._sdk_subdir
            return [join(lib, '%sum%s' % (libver , arch_subdir))]

    @property
    def OSIncludes(self):
        """
        Microsoft Windows SDK Include.

        Return
        ------
        list of str
            paths
        """
        include = join(self.si.WindowsSdkDir, 'include')

        if self.vs_ver <= 10.0:
            return [include, join(include, 'gl')]

        else:
            if self.vs_ver >= 14.0:
                sdkver = self._sdk_subdir
            else:
                sdkver = ''
            return [join(include, '%sshared' % sdkver),
                    join(include, '%sum' % sdkver),
                    join(include, '%swinrt' % sdkver)]

    @property
    def OSLibpath(self):
        """
        Microsoft Windows SDK Libraries Paths.

        Return
        ------
        list of str
            paths
        """
        ref = join(self.si.WindowsSdkDir, 'References')
        libpath = []

        if self.vs_ver <= 9.0:
            libpath += self.OSLibraries

        if self.vs_ver >= 11.0:
            libpath += [join(ref, r'CommonConfiguration\Neutral')]

        if self.vs_ver >= 14.0:
            libpath += [
                ref,
                join(self.si.WindowsSdkDir, 'UnionMetadata'),
                join(ref, 'Windows.Foundation.UniversalApiContract', '1.0.0.0'),
                join(ref, 'Windows.Foundation.FoundationContract', '1.0.0.0'),
                join(ref,'Windows.Networking.Connectivity.WwanContract',
                     '1.0.0.0'),
                join(self.si.WindowsSdkDir, 'ExtensionSDKs', 'Microsoft.VCLibs',
                     '%0.1f' % self.vs_ver, 'References', 'CommonConfiguration',
                     'neutral'),
            ]
        return libpath

    @property
    def SdkTools(self):
        """
        Microsoft Windows SDK Tools.

        Return
        ------
        list of str
            paths
        """
        return list(self._sdk_tools())

    def _sdk_tools(self):
        """
        Microsoft Windows SDK Tools paths generator.

        Return
        ------
        generator of str
            paths
        """
        if self.vs_ver < 15.0:
            bin_dir = 'Bin' if self.vs_ver <= 11.0 else r'Bin\x86'
            yield join(self.si.WindowsSdkDir, bin_dir)

        if not self.pi.current_is_x86():
            arch_subdir = self.pi.current_dir(x64=True)
            path = 'Bin%s' % arch_subdir
            yield join(self.si.WindowsSdkDir, path)

        if self.vs_ver in (10.0, 11.0):
            if self.pi.target_is_x86():
                arch_subdir = ''
            else:
                arch_subdir = self.pi.current_dir(hidex86=True, x64=True)
            path = r'Bin\NETFX 4.0 Tools%s' % arch_subdir
            yield join(self.si.WindowsSdkDir, path)

        elif self.vs_ver >= 15.0:
            path = join(self.si.WindowsSdkDir, 'Bin')
            arch_subdir = self.pi.current_dir(x64=True)
            sdkver = self.si.WindowsSdkLastVersion
            yield join(path, '%s%s' % (sdkver, arch_subdir))

        if self.si.WindowsSDKExecutablePath:
            yield self.si.WindowsSDKExecutablePath

    @property
    def _sdk_subdir(self):
        """
        Microsoft Windows SDK version subdir.

        Return
        ------
        str
            subdir
        """
        ucrtver = self.si.WindowsSdkLastVersion
        return ('%s\\' % ucrtver) if ucrtver else ''

    @property
    def SdkSetup(self):
        """
        Microsoft Windows SDK Setup.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver > 9.0:
            return []

        return [join(self.si.WindowsSdkDir, 'Setup')]

    @property
    def FxTools(self):
        """
        Microsoft .NET Framework Tools.

        Return
        ------
        list of str
            paths
        """
        pi = self.pi
        si = self.si

        if self.vs_ver <= 10.0:
            include32 = True
            include64 = not pi.target_is_x86() and not pi.current_is_x86()
        else:
            include32 = pi.target_is_x86() or pi.current_is_x86()
            include64 = pi.current_cpu == 'amd64' or pi.target_cpu == 'amd64'

        tools = []
        if include32:
            tools += [join(si.FrameworkDir32, ver)
                      for ver in si.FrameworkVersion32]
        if include64:
            tools += [join(si.FrameworkDir64, ver)
                      for ver in si.FrameworkVersion64]
        return tools

    @property
    def NetFxSDKLibraries(self):
        """
        Microsoft .Net Framework SDK Libraries.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver < 14.0 or not self.si.NetFxSdkDir:
            return []

        arch_subdir = self.pi.target_dir(x64=True)
        return [join(self.si.NetFxSdkDir, r'lib\um%s' % arch_subdir)]

    @property
    def NetFxSDKIncludes(self):
        """
        Microsoft .Net Framework SDK Includes.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver < 14.0 or not self.si.NetFxSdkDir:
            return []

        return [join(self.si.NetFxSdkDir, r'include\um')]

    @property
    def VsTDb(self):
        """
        Microsoft Visual Studio Team System Database.

        Return
        ------
        list of str
            paths
        """
        return [join(self.si.VSInstallDir, r'VSTSDB\Deploy')]

    @property
    def MSBuild(self):
        """
        Microsoft Build Engine.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver < 12.0:
            return []
        elif self.vs_ver < 15.0:
            base_path = self.si.ProgramFilesx86
            arch_subdir = self.pi.current_dir(hidex86=True)
        else:
            base_path = self.si.VSInstallDir
            arch_subdir = ''

        path = r'MSBuild\%0.1f\bin%s' % (self.vs_ver, arch_subdir)
        build = [join(base_path, path)]

        if self.vs_ver >= 15.0:
            # Add Roslyn C# & Visual Basic Compiler
            build += [join(base_path, path, 'Roslyn')]

        return build

    @property
    def HTMLHelpWorkshop(self):
        """
        Microsoft HTML Help Workshop.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver < 11.0:
            return []

        return [join(self.si.ProgramFilesx86, 'HTML Help Workshop')]

    @property
    def UCRTLibraries(self):
        """
        Microsoft Universal C Runtime SDK Libraries.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver < 14.0:
            return []

        arch_subdir = self.pi.target_dir(x64=True)
        lib = join(self.si.UniversalCRTSdkDir, 'lib')
        ucrtver = self._ucrt_subdir
        return [join(lib, '%sucrt%s' % (ucrtver, arch_subdir))]

    @property
    def UCRTIncludes(self):
        """
        Microsoft Universal C Runtime SDK Include.

        Return
        ------
        list of str
            paths
        """
        if self.vs_ver < 14.0:
            return []

        include = join(self.si.UniversalCRTSdkDir, 'include')
        return [join(include, '%sucrt' % self._ucrt_subdir)]

    @property
    def _ucrt_subdir(self):
        """
        Microsoft Universal C Runtime SDK version subdir.

        Return
        ------
        str
            subdir
        """
        ucrtver = self.si.UniversalCRTSdkLastVersion
        return ('%s\\' % ucrtver) if ucrtver else ''

    @property
    def FSharp(self):
        """
        Microsoft Visual F#.

        Return
        ------
        list of str
            paths
        """
        if 11.0 > self.vs_ver > 12.0:
            return []

        return [self.si.FSharpInstallDir]

    @property
    def VCRuntimeRedist(self):
        """
        Microsoft Visual C++ runtime redistributable dll.

        Return
        ------
        str
            path
        """
        vcruntime = 'vcruntime%d0.dll' % self.vc_ver
        arch_subdir = self.pi.target_dir(x64=True).strip('\\')

        # Installation prefixes candidates
        prefixes = []
        tools_path = self.si.VCInstallDir
        redist_path = dirname(tools_path.replace(r'\Tools', r'\Redist'))
        if isdir(redist_path):
            # Redist version may not be exactly the same as tools
            redist_path = join(redist_path, listdir(redist_path)[-1])
            prefixes += [redist_path, join(redist_path, 'onecore')]

        prefixes += [join(tools_path, 'redist')]  # VS14 legacy path

        # CRT directory
        crt_dirs = ('Microsoft.VC%d.CRT' % (self.vc_ver * 10),
                    # Sometime store in directory with VS version instead of VC
                    'Microsoft.VC%d.CRT' % (int(self.vs_ver) * 10))

        # vcruntime path
        for prefix, crt_dir in itertools.product(prefixes, crt_dirs):
            path = join(prefix, arch_subdir, crt_dir, vcruntime)
            if isfile(path):
                return path

    def return_env(self, exists=True):
        """
        Return environment dict.

        Parameters
        ----------
        exists: bool
            It True, only return existing paths.

        Return
        ------
        dict
            environment
        """
        env = dict(
            include=self._build_paths('include',
                                      [self.VCIncludes,
                                       self.OSIncludes,
                                       self.UCRTIncludes,
                                       self.NetFxSDKIncludes],
                                      exists),
            lib=self._build_paths('lib',
                                  [self.VCLibraries,
                                   self.OSLibraries,
                                   self.FxTools,
                                   self.UCRTLibraries,
                                   self.NetFxSDKLibraries],
                                  exists),
            libpath=self._build_paths('libpath',
                                      [self.VCLibraries,
                                       self.FxTools,
                                       self.VCStoreRefs,
                                       self.OSLibpath],
                                      exists),
            path=self._build_paths('path',
                                   [self.VCTools,
                                    self.VSTools,
                                    self.VsTDb,
                                    self.SdkTools,
                                    self.SdkSetup,
                                    self.FxTools,
                                    self.MSBuild,
                                    self.HTMLHelpWorkshop,
                                    self.FSharp],
                                   exists),
        )
        if self.vs_ver >= 14 and isfile(self.VCRuntimeRedist):
            env['py_vcruntime_redist'] = self.VCRuntimeRedist
        return env

    def _build_paths(self, name, spec_path_lists, exists):
        """
        Given an environment variable name and specified paths,
        return a pathsep-separated string of paths containing
        unique, extant, directories from those paths and from
        the environment variable. Raise an error if no paths
        are resolved.

        Parameters
        ----------
        name: str
            Environment variable name
        spec_path_lists: list of str
            Paths
        exists: bool
            It True, only return existing paths.

        Return
        ------
        str
            Pathsep-separated paths
        """
        # flatten spec_path_lists
        spec_paths = itertools.chain.from_iterable(spec_path_lists)
        env_paths = environ.get(name, '').split(pathsep)
        paths = itertools.chain(spec_paths, env_paths)
        extant_paths = list(filter(isdir, paths)) if exists else paths
        if not extant_paths:
            msg = "%s environment variable is empty" % name.upper()
            raise distutils.errors.DistutilsPlatformError(msg)
        unique_paths = self._unique_everseen(extant_paths)
        return pathsep.join(unique_paths)

    # from Python docs
    @staticmethod
    def _unique_everseen(iterable, key=None):
        """
        List unique elements, preserving order.
        Remember all elements ever seen.

        _unique_everseen('AAAABBBCCDAABBB') --> A B C D

        _unique_everseen('ABBCcAD', str.lower) --> A B C D
        """
        seen = set()
        seen_add = seen.add
        if key is None:
            for element in filterfalse(seen.__contains__, iterable):
                seen_add(element)
                yield element
        else:
            for element in iterable:
                k = key(element)
                if k not in seen:
                    seen_add(k)
                    yield element
site-packages/setuptools/launch.py000064400000001423151446177000013336 0ustar00"""
Launch the Python script on the command line after
setuptools is bootstrapped via import.
"""

# Note that setuptools gets imported implicitly by the
# invocation of this script using python -m setuptools.launch

import tokenize
import sys


def run():
    """
    Run the script in sys.argv[1] as if it had
    been invoked naturally.
    """
    __builtins__
    script_name = sys.argv[1]
    namespace = dict(
        __file__=script_name,
        __name__='__main__',
        __doc__=None,
    )
    sys.argv[:] = sys.argv[1:]

    open_ = getattr(tokenize, 'open', open)
    script = open_(script_name).read()
    norm_script = script.replace('\\r\\n', '\\n')
    code = compile(norm_script, script_name, 'exec')
    exec(code, namespace)


if __name__ == '__main__':
    run()
site-packages/setuptools/build_meta.py000064400000022575151446177000014204 0ustar00"""A PEP 517 interface to setuptools

Previously, when a user or a command line tool (let's call it a "frontend")
needed to make a request of setuptools to take a certain action, for
example, generating a list of installation requirements, the frontend would
would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line.

PEP 517 defines a different method of interfacing with setuptools. Rather
than calling "setup.py" directly, the frontend should:

  1. Set the current directory to the directory with a setup.py file
  2. Import this module into a safe python interpreter (one in which
     setuptools can potentially set global variables or crash hard).
  3. Call one of the functions defined in PEP 517.

What each function does is defined in PEP 517. However, here is a "casual"
definition of the functions (this definition should not be relied on for
bug reports or API stability):

  - `build_wheel`: build a wheel in the folder and return the basename
  - `get_requires_for_build_wheel`: get the `setup_requires` to build
  - `prepare_metadata_for_build_wheel`: get the `install_requires`
  - `build_sdist`: build an sdist in the folder and return the basename
  - `get_requires_for_build_sdist`: get the `setup_requires` to build

Again, this is not a formal definition! Just a "taste" of the module.
"""

import io
import os
import sys
import tokenize
import shutil
import contextlib

import setuptools
import distutils
from setuptools.py31compat import TemporaryDirectory

from pkg_resources import parse_requirements
from pkg_resources.py31compat import makedirs

__all__ = ['get_requires_for_build_sdist',
           'get_requires_for_build_wheel',
           'prepare_metadata_for_build_wheel',
           'build_wheel',
           'build_sdist',
           '__legacy__',
           'SetupRequirementsError']

class SetupRequirementsError(BaseException):
    def __init__(self, specifiers):
        self.specifiers = specifiers


class Distribution(setuptools.dist.Distribution):
    def fetch_build_eggs(self, specifiers):
        specifier_list = list(map(str, parse_requirements(specifiers)))

        raise SetupRequirementsError(specifier_list)

    @classmethod
    @contextlib.contextmanager
    def patch(cls):
        """
        Replace
        distutils.dist.Distribution with this class
        for the duration of this context.
        """
        orig = distutils.core.Distribution
        distutils.core.Distribution = cls
        try:
            yield
        finally:
            distutils.core.Distribution = orig


def _to_str(s):
    """
    Convert a filename to a string (on Python 2, explicitly
    a byte string, not Unicode) as distutils checks for the
    exact type str.
    """
    if sys.version_info[0] == 2 and not isinstance(s, str):
        # Assume it's Unicode, as that's what the PEP says
        # should be provided.
        return s.encode(sys.getfilesystemencoding())
    return s


def _get_immediate_subdirectories(a_dir):
    return [name for name in os.listdir(a_dir)
            if os.path.isdir(os.path.join(a_dir, name))]


def _file_with_extension(directory, extension):
    matching = (
        f for f in os.listdir(directory)
        if f.endswith(extension)
    )
    file, = matching
    return file


def _open_setup_script(setup_script):
    if not os.path.exists(setup_script):
        # Supply a default setup.py
        return io.StringIO(u"from setuptools import setup; setup()")

    return getattr(tokenize, 'open', open)(setup_script)


class _BuildMetaBackend(object):

    def _fix_config(self, config_settings):
        config_settings = config_settings or {}
        config_settings.setdefault('--global-option', [])
        return config_settings

    def _get_build_requires(self, config_settings, requirements):
        config_settings = self._fix_config(config_settings)

        sys.argv = sys.argv[:1] + ['egg_info'] + \
            config_settings["--global-option"]
        try:
            with Distribution.patch():
                self.run_setup()
        except SetupRequirementsError as e:
            requirements += e.specifiers

        return requirements

    def run_setup(self, setup_script='setup.py'):
        # Note that we can reuse our build directory between calls
        # Correctness comes first, then optimization later
        __file__ = setup_script
        __name__ = '__main__'

        with _open_setup_script(__file__) as f:
            code = f.read().replace(r'\r\n', r'\n')

        exec(compile(code, __file__, 'exec'), locals())

    def get_requires_for_build_wheel(self, config_settings=None):
        config_settings = self._fix_config(config_settings)
        return self._get_build_requires(config_settings, requirements=['wheel'])

    def get_requires_for_build_sdist(self, config_settings=None):
        config_settings = self._fix_config(config_settings)
        return self._get_build_requires(config_settings, requirements=[])

    def prepare_metadata_for_build_wheel(self, metadata_directory,
                                         config_settings=None):
        sys.argv = sys.argv[:1] + ['dist_info', '--egg-base',
                                   _to_str(metadata_directory)]
        self.run_setup()

        dist_info_directory = metadata_directory
        while True:
            dist_infos = [f for f in os.listdir(dist_info_directory)
                          if f.endswith('.dist-info')]

            if (len(dist_infos) == 0 and
                len(_get_immediate_subdirectories(dist_info_directory)) == 1):

                dist_info_directory = os.path.join(
                    dist_info_directory, os.listdir(dist_info_directory)[0])
                continue

            assert len(dist_infos) == 1
            break

        # PEP 517 requires that the .dist-info directory be placed in the
        # metadata_directory. To comply, we MUST copy the directory to the root
        if dist_info_directory != metadata_directory:
            shutil.move(
                os.path.join(dist_info_directory, dist_infos[0]),
                metadata_directory)
            shutil.rmtree(dist_info_directory, ignore_errors=True)

        return dist_infos[0]

    def _build_with_temp_dir(self, setup_command, result_extension,
                             result_directory, config_settings):
        config_settings = self._fix_config(config_settings)
        result_directory = os.path.abspath(result_directory)

        # Build in a temporary directory, then copy to the target.
        makedirs(result_directory, exist_ok=True)
        with TemporaryDirectory(dir=result_directory) as tmp_dist_dir:
            sys.argv = (sys.argv[:1] + setup_command +
                        ['--dist-dir', tmp_dist_dir] +
                        config_settings["--global-option"])
            self.run_setup()

            result_basename = _file_with_extension(tmp_dist_dir, result_extension)
            result_path = os.path.join(result_directory, result_basename)
            if os.path.exists(result_path):
                # os.rename will fail overwriting on non-Unix.
                os.remove(result_path)
            os.rename(os.path.join(tmp_dist_dir, result_basename), result_path)

        return result_basename


    def build_wheel(self, wheel_directory, config_settings=None,
                    metadata_directory=None):
        return self._build_with_temp_dir(['bdist_wheel'], '.whl',
                                         wheel_directory, config_settings)

    def build_sdist(self, sdist_directory, config_settings=None):
        return self._build_with_temp_dir(['sdist', '--formats', 'gztar'],
                                         '.tar.gz', sdist_directory,
                                         config_settings)


class _BuildMetaLegacyBackend(_BuildMetaBackend):
    """Compatibility backend for setuptools

    This is a version of setuptools.build_meta that endeavors to maintain backwards
    compatibility with pre-PEP 517 modes of invocation. It exists as a temporary
    bridge between the old packaging mechanism and the new packaging mechanism,
    and will eventually be removed.
    """
    def run_setup(self, setup_script='setup.py'):
        # In order to maintain compatibility with scripts assuming that
        # the setup.py script is in a directory on the PYTHONPATH, inject
        # '' into sys.path. (pypa/setuptools#1642)
        sys_path = list(sys.path)           # Save the original path

        script_dir = os.path.dirname(os.path.abspath(setup_script))
        if script_dir not in sys.path:
            sys.path.insert(0, script_dir)

        try:
            super(_BuildMetaLegacyBackend,
                  self).run_setup(setup_script=setup_script)
        finally:
            # While PEP 517 frontends should be calling each hook in a fresh
            # subprocess according to the standard (and thus it should not be
            # strictly necessary to restore the old sys.path), we'll restore
            # the original path so that the path manipulation does not persist
            # within the hook after run_setup is called.
            sys.path[:] = sys_path

# The primary backend
_BACKEND = _BuildMetaBackend()

get_requires_for_build_wheel = _BACKEND.get_requires_for_build_wheel
get_requires_for_build_sdist = _BACKEND.get_requires_for_build_sdist
prepare_metadata_for_build_wheel = _BACKEND.prepare_metadata_for_build_wheel
build_wheel = _BACKEND.build_wheel
build_sdist = _BACKEND.build_sdist


# The legacy backend
__legacy__ = _BuildMetaLegacyBackend()
site-packages/setuptools/depends.py000064400000012615151446177000013513 0ustar00import sys
import marshal
import contextlib
from distutils.version import StrictVersion

from .py33compat import Bytecode

from .py27compat import find_module, PY_COMPILED, PY_FROZEN, PY_SOURCE
from . import py27compat


__all__ = [
    'Require', 'find_module', 'get_module_constant', 'extract_constant'
]


class Require:
    """A prerequisite to building or installing a distribution"""

    def __init__(
            self, name, requested_version, module, homepage='',
            attribute=None, format=None):

        if format is None and requested_version is not None:
            format = StrictVersion

        if format is not None:
            requested_version = format(requested_version)
            if attribute is None:
                attribute = '__version__'

        self.__dict__.update(locals())
        del self.self

    def full_name(self):
        """Return full package/distribution name, w/version"""
        if self.requested_version is not None:
            return '%s-%s' % (self.name, self.requested_version)
        return self.name

    def version_ok(self, version):
        """Is 'version' sufficiently up-to-date?"""
        return self.attribute is None or self.format is None or \
            str(version) != "unknown" and version >= self.requested_version

    def get_version(self, paths=None, default="unknown"):
        """Get version number of installed module, 'None', or 'default'

        Search 'paths' for module.  If not found, return 'None'.  If found,
        return the extracted version attribute, or 'default' if no version
        attribute was specified, or the value cannot be determined without
        importing the module.  The version is formatted according to the
        requirement's version format (if any), unless it is 'None' or the
        supplied 'default'.
        """

        if self.attribute is None:
            try:
                f, p, i = find_module(self.module, paths)
                if f:
                    f.close()
                return default
            except ImportError:
                return None

        v = get_module_constant(self.module, self.attribute, default, paths)

        if v is not None and v is not default and self.format is not None:
            return self.format(v)

        return v

    def is_present(self, paths=None):
        """Return true if dependency is present on 'paths'"""
        return self.get_version(paths) is not None

    def is_current(self, paths=None):
        """Return true if dependency is present and up-to-date on 'paths'"""
        version = self.get_version(paths)
        if version is None:
            return False
        return self.version_ok(version)


def maybe_close(f):
    @contextlib.contextmanager
    def empty():
        yield
        return
    if not f:
        return empty()

    return contextlib.closing(f)


def get_module_constant(module, symbol, default=-1, paths=None):
    """Find 'module' by searching 'paths', and extract 'symbol'

    Return 'None' if 'module' does not exist on 'paths', or it does not define
    'symbol'.  If the module defines 'symbol' as a constant, return the
    constant.  Otherwise, return 'default'."""

    try:
        f, path, (suffix, mode, kind) = info = find_module(module, paths)
    except ImportError:
        # Module doesn't exist
        return None

    with maybe_close(f):
        if kind == PY_COMPILED:
            f.read(8)  # skip magic & date
            code = marshal.load(f)
        elif kind == PY_FROZEN:
            code = py27compat.get_frozen_object(module, paths)
        elif kind == PY_SOURCE:
            code = compile(f.read(), path, 'exec')
        else:
            # Not something we can parse; we'll have to import it.  :(
            imported = py27compat.get_module(module, paths, info)
            return getattr(imported, symbol, None)

    return extract_constant(code, symbol, default)


def extract_constant(code, symbol, default=-1):
    """Extract the constant value of 'symbol' from 'code'

    If the name 'symbol' is bound to a constant value by the Python code
    object 'code', return that value.  If 'symbol' is bound to an expression,
    return 'default'.  Otherwise, return 'None'.

    Return value is based on the first assignment to 'symbol'.  'symbol' must
    be a global, or at least a non-"fast" local in the code block.  That is,
    only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol'
    must be present in 'code.co_names'.
    """
    if symbol not in code.co_names:
        # name's not there, can't possibly be an assignment
        return None

    name_idx = list(code.co_names).index(symbol)

    STORE_NAME = 90
    STORE_GLOBAL = 97
    LOAD_CONST = 100

    const = default

    for byte_code in Bytecode(code):
        op = byte_code.opcode
        arg = byte_code.arg

        if op == LOAD_CONST:
            const = code.co_consts[arg]
        elif arg == name_idx and (op == STORE_NAME or op == STORE_GLOBAL):
            return const
        else:
            const = default


def _update_globals():
    """
    Patch the globals to remove the objects not available on some platforms.

    XXX it'd be better to test assertions about bytecode instead.
    """

    if not sys.platform.startswith('java') and sys.platform != 'cli':
        return
    incompatible = 'extract_constant', 'get_module_constant'
    for name in incompatible:
        del globals()[name]
        __all__.remove(name)


_update_globals()
site-packages/setuptools/py27compat.py000064400000002730151446177000014073 0ustar00"""
Compatibility Support for Python 2.7 and earlier
"""

import sys
import platform

from setuptools.extern import six


def get_all_headers(message, key):
    """
    Given an HTTPMessage, return all headers matching a given key.
    """
    return message.get_all(key)


if six.PY2:
    def get_all_headers(message, key):
        return message.getheaders(key)


linux_py2_ascii = (
    platform.system() == 'Linux' and
    six.PY2
)

rmtree_safe = str if linux_py2_ascii else lambda x: x
"""Workaround for http://bugs.python.org/issue24672"""


try:
    from ._imp import find_module, PY_COMPILED, PY_FROZEN, PY_SOURCE
    from ._imp import get_frozen_object, get_module
except ImportError:
    import imp
    from imp import PY_COMPILED, PY_FROZEN, PY_SOURCE  # noqa

    def find_module(module, paths=None):
        """Just like 'imp.find_module()', but with package support"""
        parts = module.split('.')
        while parts:
            part = parts.pop(0)
            f, path, (suffix, mode, kind) = info = imp.find_module(part, paths)

            if kind == imp.PKG_DIRECTORY:
                parts = parts or ['__init__']
                paths = [path]

            elif parts:
                raise ImportError("Can't find %r in %s" % (parts, module))

        return info

    def get_frozen_object(module, paths):
        return imp.get_frozen_object(module)

    def get_module(module, paths, info):
        imp.load_module(module, *info)
        return sys.modules[module]
site-packages/setuptools/glob.py000064400000011734151446177000013015 0ustar00"""
Filename globbing utility. Mostly a copy of `glob` from Python 3.5.

Changes include:
 * `yield from` and PEP3102 `*` removed.
 * Hidden files are not ignored.
"""

import os
import re
import fnmatch

__all__ = ["glob", "iglob", "escape"]


def glob(pathname, recursive=False):
    """Return a list of paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la
    fnmatch. However, unlike fnmatch, filenames starting with a
    dot are special cases that are not matched by '*' and '?'
    patterns.

    If recursive is true, the pattern '**' will match any files and
    zero or more directories and subdirectories.
    """
    return list(iglob(pathname, recursive=recursive))


def iglob(pathname, recursive=False):
    """Return an iterator which yields the paths matching a pathname pattern.

    The pattern may contain simple shell-style wildcards a la
    fnmatch. However, unlike fnmatch, filenames starting with a
    dot are special cases that are not matched by '*' and '?'
    patterns.

    If recursive is true, the pattern '**' will match any files and
    zero or more directories and subdirectories.
    """
    it = _iglob(pathname, recursive)
    if recursive and _isrecursive(pathname):
        s = next(it)  # skip empty string
        assert not s
    return it


def _iglob(pathname, recursive):
    dirname, basename = os.path.split(pathname)
    if not has_magic(pathname):
        if basename:
            if os.path.lexists(pathname):
                yield pathname
        else:
            # Patterns ending with a slash should match only directories
            if os.path.isdir(dirname):
                yield pathname
        return
    if not dirname:
        if recursive and _isrecursive(basename):
            for x in glob2(dirname, basename):
                yield x
        else:
            for x in glob1(dirname, basename):
                yield x
        return
    # `os.path.split()` returns the argument itself as a dirname if it is a
    # drive or UNC path.  Prevent an infinite recursion if a drive or UNC path
    # contains magic characters (i.e. r'\\?\C:').
    if dirname != pathname and has_magic(dirname):
        dirs = _iglob(dirname, recursive)
    else:
        dirs = [dirname]
    if has_magic(basename):
        if recursive and _isrecursive(basename):
            glob_in_dir = glob2
        else:
            glob_in_dir = glob1
    else:
        glob_in_dir = glob0
    for dirname in dirs:
        for name in glob_in_dir(dirname, basename):
            yield os.path.join(dirname, name)


# These 2 helper functions non-recursively glob inside a literal directory.
# They return a list of basenames. `glob1` accepts a pattern while `glob0`
# takes a literal basename (so it only has to check for its existence).


def glob1(dirname, pattern):
    if not dirname:
        if isinstance(pattern, bytes):
            dirname = os.curdir.encode('ASCII')
        else:
            dirname = os.curdir
    try:
        names = os.listdir(dirname)
    except OSError:
        return []
    return fnmatch.filter(names, pattern)


def glob0(dirname, basename):
    if not basename:
        # `os.path.split()` returns an empty basename for paths ending with a
        # directory separator.  'q*x/' should match only directories.
        if os.path.isdir(dirname):
            return [basename]
    else:
        if os.path.lexists(os.path.join(dirname, basename)):
            return [basename]
    return []


# This helper function recursively yields relative pathnames inside a literal
# directory.


def glob2(dirname, pattern):
    assert _isrecursive(pattern)
    yield pattern[:0]
    for x in _rlistdir(dirname):
        yield x


# Recursively yields relative pathnames inside a literal directory.
def _rlistdir(dirname):
    if not dirname:
        if isinstance(dirname, bytes):
            dirname = os.curdir.encode('ASCII')
        else:
            dirname = os.curdir
    try:
        names = os.listdir(dirname)
    except os.error:
        return
    for x in names:
        yield x
        path = os.path.join(dirname, x) if dirname else x
        for y in _rlistdir(path):
            yield os.path.join(x, y)


magic_check = re.compile('([*?[])')
magic_check_bytes = re.compile(b'([*?[])')


def has_magic(s):
    if isinstance(s, bytes):
        match = magic_check_bytes.search(s)
    else:
        match = magic_check.search(s)
    return match is not None


def _isrecursive(pattern):
    if isinstance(pattern, bytes):
        return pattern == b'**'
    else:
        return pattern == '**'


def escape(pathname):
    """Escape all special characters.
    """
    # Escaping is done by wrapping any of "*?[" between square brackets.
    # Metacharacters do not work in the drive part and shouldn't be escaped.
    drive, pathname = os.path.splitdrive(pathname)
    if isinstance(pathname, bytes):
        pathname = magic_check_bytes.sub(br'[\1]', pathname)
    else:
        pathname = magic_check.sub(r'[\1]', pathname)
    return drive + pathname
site-packages/setuptools/command/install_lib.py000064400000007426151446177000016007 0ustar00import os
import sys
from itertools import product, starmap
import distutils.command.install_lib as orig


class install_lib(orig.install_lib):
    """Don't add compiled flags to filenames of non-Python files"""

    def run(self):
        self.build()
        outfiles = self.install()
        if outfiles is not None:
            # always compile, in case we have any extension stubs to deal with
            self.byte_compile(outfiles)

    def get_exclusions(self):
        """
        Return a collections.Sized collections.Container of paths to be
        excluded for single_version_externally_managed installations.
        """
        all_packages = (
            pkg
            for ns_pkg in self._get_SVEM_NSPs()
            for pkg in self._all_packages(ns_pkg)
        )

        excl_specs = product(all_packages, self._gen_exclusion_paths())
        return set(starmap(self._exclude_pkg_path, excl_specs))

    def _exclude_pkg_path(self, pkg, exclusion_path):
        """
        Given a package name and exclusion path within that package,
        compute the full exclusion path.
        """
        parts = pkg.split('.') + [exclusion_path]
        return os.path.join(self.install_dir, *parts)

    @staticmethod
    def _all_packages(pkg_name):
        """
        >>> list(install_lib._all_packages('foo.bar.baz'))
        ['foo.bar.baz', 'foo.bar', 'foo']
        """
        while pkg_name:
            yield pkg_name
            pkg_name, sep, child = pkg_name.rpartition('.')

    def _get_SVEM_NSPs(self):
        """
        Get namespace packages (list) but only for
        single_version_externally_managed installations and empty otherwise.
        """
        # TODO: is it necessary to short-circuit here? i.e. what's the cost
        # if get_finalized_command is called even when namespace_packages is
        # False?
        if not self.distribution.namespace_packages:
            return []

        install_cmd = self.get_finalized_command('install')
        svem = install_cmd.single_version_externally_managed

        return self.distribution.namespace_packages if svem else []

    @staticmethod
    def _gen_exclusion_paths():
        """
        Generate file paths to be excluded for namespace packages (bytecode
        cache files).
        """
        # always exclude the package module itself
        yield '__init__.py'

        yield '__init__.pyc'
        yield '__init__.pyo'

        if not hasattr(sys, 'implementation'):
            return

        base = os.path.join('__pycache__', '__init__.' + sys.implementation.cache_tag)
        yield base + '.pyc'
        yield base + '.pyo'
        yield base + '.opt-1.pyc'
        yield base + '.opt-2.pyc'

    def copy_tree(
            self, infile, outfile,
            preserve_mode=1, preserve_times=1, preserve_symlinks=0, level=1
    ):
        assert preserve_mode and preserve_times and not preserve_symlinks
        exclude = self.get_exclusions()

        if not exclude:
            return orig.install_lib.copy_tree(self, infile, outfile)

        # Exclude namespace package __init__.py* files from the output

        from setuptools.archive_util import unpack_directory
        from distutils import log

        outfiles = []

        def pf(src, dst):
            if dst in exclude:
                log.warn("Skipping installation of %s (namespace package)",
                         dst)
                return False

            log.info("copying %s -> %s", src, os.path.dirname(dst))
            outfiles.append(dst)
            return dst

        unpack_directory(infile, outfile, pf)
        return outfiles

    def get_outputs(self):
        outputs = orig.install_lib.get_outputs(self)
        exclude = self.get_exclusions()
        if exclude:
            return [f for f in outputs if f not in exclude]
        return outputs
site-packages/setuptools/command/build_clib.py000064400000010604151446177000015573 0ustar00import distutils.command.build_clib as orig
from distutils.errors import DistutilsSetupError
from distutils import log
from setuptools.dep_util import newer_pairwise_group


class build_clib(orig.build_clib):
    """
    Override the default build_clib behaviour to do the following:

    1. Implement a rudimentary timestamp-based dependency system
       so 'compile()' doesn't run every time.
    2. Add more keys to the 'build_info' dictionary:
        * obj_deps - specify dependencies for each object compiled.
                     this should be a dictionary mapping a key
                     with the source filename to a list of
                     dependencies. Use an empty string for global
                     dependencies.
        * cflags   - specify a list of additional flags to pass to
                     the compiler.
    """

    def build_libraries(self, libraries):
        for (lib_name, build_info) in libraries:
            sources = build_info.get('sources')
            if sources is None or not isinstance(sources, (list, tuple)):
                raise DistutilsSetupError(
                       "in 'libraries' option (library '%s'), "
                       "'sources' must be present and must be "
                       "a list of source filenames" % lib_name)
            sources = list(sources)

            log.info("building '%s' library", lib_name)

            # Make sure everything is the correct type.
            # obj_deps should be a dictionary of keys as sources
            # and a list/tuple of files that are its dependencies.
            obj_deps = build_info.get('obj_deps', dict())
            if not isinstance(obj_deps, dict):
                raise DistutilsSetupError(
                       "in 'libraries' option (library '%s'), "
                       "'obj_deps' must be a dictionary of "
                       "type 'source: list'" % lib_name)
            dependencies = []

            # Get the global dependencies that are specified by the '' key.
            # These will go into every source's dependency list.
            global_deps = obj_deps.get('', list())
            if not isinstance(global_deps, (list, tuple)):
                raise DistutilsSetupError(
                       "in 'libraries' option (library '%s'), "
                       "'obj_deps' must be a dictionary of "
                       "type 'source: list'" % lib_name)

            # Build the list to be used by newer_pairwise_group
            # each source will be auto-added to its dependencies.
            for source in sources:
                src_deps = [source]
                src_deps.extend(global_deps)
                extra_deps = obj_deps.get(source, list())
                if not isinstance(extra_deps, (list, tuple)):
                    raise DistutilsSetupError(
                           "in 'libraries' option (library '%s'), "
                           "'obj_deps' must be a dictionary of "
                           "type 'source: list'" % lib_name)
                src_deps.extend(extra_deps)
                dependencies.append(src_deps)

            expected_objects = self.compiler.object_filenames(
                    sources,
                    output_dir=self.build_temp
                    )

            if newer_pairwise_group(dependencies, expected_objects) != ([], []):
                # First, compile the source code to object files in the library
                # directory.  (This should probably change to putting object
                # files in a temporary build directory.)
                macros = build_info.get('macros')
                include_dirs = build_info.get('include_dirs')
                cflags = build_info.get('cflags')
                objects = self.compiler.compile(
                        sources,
                        output_dir=self.build_temp,
                        macros=macros,
                        include_dirs=include_dirs,
                        extra_postargs=cflags,
                        debug=self.debug
                        )

            # Now "link" the object files together into a static library.
            # (On Unix at least, this isn't really linking -- it just
            # builds an archive.  Whatever.)
            self.compiler.create_static_lib(
                    expected_objects,
                    lib_name,
                    output_dir=self.build_clib,
                    debug=self.debug
                    )
site-packages/setuptools/command/alias.py000064400000004572151446177000014603 0ustar00from distutils.errors import DistutilsOptionError

from setuptools.extern.six.moves import map

from setuptools.command.setopt import edit_config, option_base, config_file


def shquote(arg):
    """Quote an argument for later parsing by shlex.split()"""
    for c in '"', "'", "\\", "#":
        if c in arg:
            return repr(arg)
    if arg.split() != [arg]:
        return repr(arg)
    return arg


class alias(option_base):
    """Define a shortcut that invokes one or more commands"""

    description = "define a shortcut to invoke one or more commands"
    command_consumes_arguments = True

    user_options = [
        ('remove', 'r', 'remove (unset) the alias'),
    ] + option_base.user_options

    boolean_options = option_base.boolean_options + ['remove']

    def initialize_options(self):
        option_base.initialize_options(self)
        self.args = None
        self.remove = None

    def finalize_options(self):
        option_base.finalize_options(self)
        if self.remove and len(self.args) != 1:
            raise DistutilsOptionError(
                "Must specify exactly one argument (the alias name) when "
                "using --remove"
            )

    def run(self):
        aliases = self.distribution.get_option_dict('aliases')

        if not self.args:
            print("Command Aliases")
            print("---------------")
            for alias in aliases:
                print("setup.py alias", format_alias(alias, aliases))
            return

        elif len(self.args) == 1:
            alias, = self.args
            if self.remove:
                command = None
            elif alias in aliases:
                print("setup.py alias", format_alias(alias, aliases))
                return
            else:
                print("No alias definition found for %r" % alias)
                return
        else:
            alias = self.args[0]
            command = ' '.join(map(shquote, self.args[1:]))

        edit_config(self.filename, {'aliases': {alias: command}}, self.dry_run)


def format_alias(name, aliases):
    source, command = aliases[name]
    if source == config_file('global'):
        source = '--global-config '
    elif source == config_file('user'):
        source = '--user-config '
    elif source == config_file('local'):
        source = ''
    else:
        source = '--filename=%r' % source
    return source + name + ' ' + command
site-packages/setuptools/command/launcher manifest.xml000064400000001164151446177000017244 0ustar00<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
    <assemblyIdentity version="1.0.0.0"
                      processorArchitecture="X86"
                      name="%(name)s"
                      type="win32"/>
    <!-- Identify the application security requirements. -->
    <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
        <security>
            <requestedPrivileges>
                <requestedExecutionLevel level="asInvoker" uiAccess="false"/>
            </requestedPrivileges>
        </security>
    </trustInfo>
</assembly>
site-packages/setuptools/command/saveopts.py000064400000001222151446177000015343 0ustar00from setuptools.command.setopt import edit_config, option_base


class saveopts(option_base):
    """Save command-line options to a file"""

    description = "save supplied options to setup.cfg or other config file"

    def run(self):
        dist = self.distribution
        settings = {}

        for cmd in dist.command_options:

            if cmd == 'saveopts':
                continue  # don't save our own options!

            for opt, (src, val) in dist.get_option_dict(cmd).items():
                if src == "command line":
                    settings.setdefault(cmd, {})[opt] = val

        edit_config(self.filename, settings, self.dry_run)
site-packages/setuptools/command/upload_docs.py000064400000016217151446177000016005 0ustar00# -*- coding: utf-8 -*-
"""upload_docs

Implements a Distutils 'upload_docs' subcommand (upload documentation to
PyPI's pythonhosted.org).
"""

from base64 import standard_b64encode
from distutils import log
from distutils.errors import DistutilsOptionError
import os
import socket
import zipfile
import tempfile
import shutil
import itertools
import functools

from setuptools.extern import six
from setuptools.extern.six.moves import http_client, urllib

from pkg_resources import iter_entry_points
from .upload import upload


def _encode(s):
    errors = 'surrogateescape' if six.PY3 else 'strict'
    return s.encode('utf-8', errors)


class upload_docs(upload):
    # override the default repository as upload_docs isn't
    # supported by Warehouse (and won't be).
    DEFAULT_REPOSITORY = 'https://pypi.python.org/pypi/'

    description = 'Upload documentation to PyPI'

    user_options = [
        ('repository=', 'r',
         "url of repository [default: %s]" % upload.DEFAULT_REPOSITORY),
        ('show-response', None,
         'display full response text from server'),
        ('upload-dir=', None, 'directory to upload'),
    ]
    boolean_options = upload.boolean_options

    def has_sphinx(self):
        if self.upload_dir is None:
            for ep in iter_entry_points('distutils.commands', 'build_sphinx'):
                return True

    sub_commands = [('build_sphinx', has_sphinx)]

    def initialize_options(self):
        upload.initialize_options(self)
        self.upload_dir = None
        self.target_dir = None

    def finalize_options(self):
        upload.finalize_options(self)
        if self.upload_dir is None:
            if self.has_sphinx():
                build_sphinx = self.get_finalized_command('build_sphinx')
                self.target_dir = build_sphinx.builder_target_dir
            else:
                build = self.get_finalized_command('build')
                self.target_dir = os.path.join(build.build_base, 'docs')
        else:
            self.ensure_dirname('upload_dir')
            self.target_dir = self.upload_dir
        if 'pypi.python.org' in self.repository:
            log.warn("Upload_docs command is deprecated. Use RTD instead.")
        self.announce('Using upload directory %s' % self.target_dir)

    def create_zipfile(self, filename):
        zip_file = zipfile.ZipFile(filename, "w")
        try:
            self.mkpath(self.target_dir)  # just in case
            for root, dirs, files in os.walk(self.target_dir):
                if root == self.target_dir and not files:
                    tmpl = "no files found in upload directory '%s'"
                    raise DistutilsOptionError(tmpl % self.target_dir)
                for name in files:
                    full = os.path.join(root, name)
                    relative = root[len(self.target_dir):].lstrip(os.path.sep)
                    dest = os.path.join(relative, name)
                    zip_file.write(full, dest)
        finally:
            zip_file.close()

    def run(self):
        # Run sub commands
        for cmd_name in self.get_sub_commands():
            self.run_command(cmd_name)

        tmp_dir = tempfile.mkdtemp()
        name = self.distribution.metadata.get_name()
        zip_file = os.path.join(tmp_dir, "%s.zip" % name)
        try:
            self.create_zipfile(zip_file)
            self.upload_file(zip_file)
        finally:
            shutil.rmtree(tmp_dir)

    @staticmethod
    def _build_part(item, sep_boundary):
        key, values = item
        title = '\nContent-Disposition: form-data; name="%s"' % key
        # handle multiple entries for the same name
        if not isinstance(values, list):
            values = [values]
        for value in values:
            if isinstance(value, tuple):
                title += '; filename="%s"' % value[0]
                value = value[1]
            else:
                value = _encode(value)
            yield sep_boundary
            yield _encode(title)
            yield b"\n\n"
            yield value
            if value and value[-1:] == b'\r':
                yield b'\n'  # write an extra newline (lurve Macs)

    @classmethod
    def _build_multipart(cls, data):
        """
        Build up the MIME payload for the POST data
        """
        boundary = b'--------------GHSKFJDLGDS7543FJKLFHRE75642756743254'
        sep_boundary = b'\n--' + boundary
        end_boundary = sep_boundary + b'--'
        end_items = end_boundary, b"\n",
        builder = functools.partial(
            cls._build_part,
            sep_boundary=sep_boundary,
        )
        part_groups = map(builder, data.items())
        parts = itertools.chain.from_iterable(part_groups)
        body_items = itertools.chain(parts, end_items)
        content_type = 'multipart/form-data; boundary=%s' % boundary.decode('ascii')
        return b''.join(body_items), content_type

    def upload_file(self, filename):
        with open(filename, 'rb') as f:
            content = f.read()
        meta = self.distribution.metadata
        data = {
            ':action': 'doc_upload',
            'name': meta.get_name(),
            'content': (os.path.basename(filename), content),
        }
        # set up the authentication
        credentials = _encode(self.username + ':' + self.password)
        credentials = standard_b64encode(credentials)
        if six.PY3:
            credentials = credentials.decode('ascii')
        auth = "Basic " + credentials

        body, ct = self._build_multipart(data)

        msg = "Submitting documentation to %s" % (self.repository)
        self.announce(msg, log.INFO)

        # build the Request
        # We can't use urllib2 since we need to send the Basic
        # auth right with the first request
        schema, netloc, url, params, query, fragments = \
            urllib.parse.urlparse(self.repository)
        assert not params and not query and not fragments
        if schema == 'http':
            conn = http_client.HTTPConnection(netloc)
        elif schema == 'https':
            conn = http_client.HTTPSConnection(netloc)
        else:
            raise AssertionError("unsupported schema " + schema)

        data = ''
        try:
            conn.connect()
            conn.putrequest("POST", url)
            content_type = ct
            conn.putheader('Content-type', content_type)
            conn.putheader('Content-length', str(len(body)))
            conn.putheader('Authorization', auth)
            conn.endheaders()
            conn.send(body)
        except socket.error as e:
            self.announce(str(e), log.ERROR)
            return

        r = conn.getresponse()
        if r.status == 200:
            msg = 'Server response (%s): %s' % (r.status, r.reason)
            self.announce(msg, log.INFO)
        elif r.status == 301:
            location = r.getheader('Location')
            if location is None:
                location = 'https://pythonhosted.org/%s/' % meta.get_name()
            msg = 'Upload successful. Visit %s' % location
            self.announce(msg, log.INFO)
        else:
            msg = 'Upload failed (%s): %s' % (r.status, r.reason)
            self.announce(msg, log.ERROR)
        if self.show_response:
            print('-' * 75, r.read(), '-' * 75)
site-packages/setuptools/command/bdist_wininst.py000064400000001175151446177000016366 0ustar00import distutils.command.bdist_wininst as orig


class bdist_wininst(orig.bdist_wininst):
    def reinitialize_command(self, command, reinit_subcommands=0):
        """
        Supplement reinitialize_command to work around
        http://bugs.python.org/issue20819
        """
        cmd = self.distribution.reinitialize_command(
            command, reinit_subcommands)
        if command in ('install', 'install_lib'):
            cmd.install_lib = None
        return cmd

    def run(self):
        self._is_running = True
        try:
            orig.bdist_wininst.run(self)
        finally:
            self._is_running = False
site-packages/setuptools/command/py36compat.py000064400000011572151446177000015515 0ustar00import os
from glob import glob
from distutils.util import convert_path
from distutils.command import sdist

from setuptools.extern.six.moves import filter


class sdist_add_defaults:
    """
    Mix-in providing forward-compatibility for functionality as found in
    distutils on Python 3.7.

    Do not edit the code in this class except to update functionality
    as implemented in distutils. Instead, override in the subclass.
    """

    def add_defaults(self):
        """Add all the default files to self.filelist:
          - README or README.txt
          - setup.py
          - test/test*.py
          - all pure Python modules mentioned in setup script
          - all files pointed by package_data (build_py)
          - all files defined in data_files.
          - all files defined as scripts.
          - all C sources listed as part of extensions or C libraries
            in the setup script (doesn't catch C headers!)
        Warns if (README or README.txt) or setup.py are missing; everything
        else is optional.
        """
        self._add_defaults_standards()
        self._add_defaults_optional()
        self._add_defaults_python()
        self._add_defaults_data_files()
        self._add_defaults_ext()
        self._add_defaults_c_libs()
        self._add_defaults_scripts()

    @staticmethod
    def _cs_path_exists(fspath):
        """
        Case-sensitive path existence check

        >>> sdist_add_defaults._cs_path_exists(__file__)
        True
        >>> sdist_add_defaults._cs_path_exists(__file__.upper())
        False
        """
        if not os.path.exists(fspath):
            return False
        # make absolute so we always have a directory
        abspath = os.path.abspath(fspath)
        directory, filename = os.path.split(abspath)
        return filename in os.listdir(directory)

    def _add_defaults_standards(self):
        standards = [self.READMES, self.distribution.script_name]
        for fn in standards:
            if isinstance(fn, tuple):
                alts = fn
                got_it = False
                for fn in alts:
                    if self._cs_path_exists(fn):
                        got_it = True
                        self.filelist.append(fn)
                        break

                if not got_it:
                    self.warn("standard file not found: should have one of " +
                              ', '.join(alts))
            else:
                if self._cs_path_exists(fn):
                    self.filelist.append(fn)
                else:
                    self.warn("standard file '%s' not found" % fn)

    def _add_defaults_optional(self):
        optional = ['test/test*.py', 'setup.cfg']
        for pattern in optional:
            files = filter(os.path.isfile, glob(pattern))
            self.filelist.extend(files)

    def _add_defaults_python(self):
        # build_py is used to get:
        #  - python modules
        #  - files defined in package_data
        build_py = self.get_finalized_command('build_py')

        # getting python files
        if self.distribution.has_pure_modules():
            self.filelist.extend(build_py.get_source_files())

        # getting package_data files
        # (computed in build_py.data_files by build_py.finalize_options)
        for pkg, src_dir, build_dir, filenames in build_py.data_files:
            for filename in filenames:
                self.filelist.append(os.path.join(src_dir, filename))

    def _add_defaults_data_files(self):
        # getting distribution.data_files
        if self.distribution.has_data_files():
            for item in self.distribution.data_files:
                if isinstance(item, str):
                    # plain file
                    item = convert_path(item)
                    if os.path.isfile(item):
                        self.filelist.append(item)
                else:
                    # a (dirname, filenames) tuple
                    dirname, filenames = item
                    for f in filenames:
                        f = convert_path(f)
                        if os.path.isfile(f):
                            self.filelist.append(f)

    def _add_defaults_ext(self):
        if self.distribution.has_ext_modules():
            build_ext = self.get_finalized_command('build_ext')
            self.filelist.extend(build_ext.get_source_files())

    def _add_defaults_c_libs(self):
        if self.distribution.has_c_libraries():
            build_clib = self.get_finalized_command('build_clib')
            self.filelist.extend(build_clib.get_source_files())

    def _add_defaults_scripts(self):
        if self.distribution.has_scripts():
            build_scripts = self.get_finalized_command('build_scripts')
            self.filelist.extend(build_scripts.get_source_files())


if hasattr(sdist.sdist, '_add_defaults_standards'):
    # disable the functionality already available upstream
    class sdist_add_defaults:
        pass
site-packages/setuptools/command/install.py000064400000011113151446177000015145 0ustar00from distutils.errors import DistutilsArgError
import inspect
import glob
import warnings
import platform
import distutils.command.install as orig

import setuptools

# Prior to numpy 1.9, NumPy relies on the '_install' name, so provide it for
# now. See https://github.com/pypa/setuptools/issues/199/
_install = orig.install


class install(orig.install):
    """Use easy_install to install the package, w/dependencies"""

    user_options = orig.install.user_options + [
        ('old-and-unmanageable', None, "Try not to use this!"),
        ('single-version-externally-managed', None,
         "used by system package builders to create 'flat' eggs"),
    ]
    boolean_options = orig.install.boolean_options + [
        'old-and-unmanageable', 'single-version-externally-managed',
    ]
    new_commands = [
        ('install_egg_info', lambda self: True),
        ('install_scripts', lambda self: True),
    ]
    _nc = dict(new_commands)

    def initialize_options(self):
        orig.install.initialize_options(self)
        self.old_and_unmanageable = None
        self.single_version_externally_managed = None

    def finalize_options(self):
        orig.install.finalize_options(self)
        if self.root:
            self.single_version_externally_managed = True
        elif self.single_version_externally_managed:
            if not self.root and not self.record:
                raise DistutilsArgError(
                    "You must specify --record or --root when building system"
                    " packages"
                )

    def handle_extra_path(self):
        if self.root or self.single_version_externally_managed:
            # explicit backward-compatibility mode, allow extra_path to work
            return orig.install.handle_extra_path(self)

        # Ignore extra_path when installing an egg (or being run by another
        # command without --root or --single-version-externally-managed
        self.path_file = None
        self.extra_dirs = ''

    def run(self):
        # Explicit request for old-style install?  Just do it
        if self.old_and_unmanageable or self.single_version_externally_managed:
            return orig.install.run(self)

        if not self._called_from_setup(inspect.currentframe()):
            # Run in backward-compatibility mode to support bdist_* commands.
            orig.install.run(self)
        else:
            self.do_egg_install()

    @staticmethod
    def _called_from_setup(run_frame):
        """
        Attempt to detect whether run() was called from setup() or by another
        command.  If called by setup(), the parent caller will be the
        'run_command' method in 'distutils.dist', and *its* caller will be
        the 'run_commands' method.  If called any other way, the
        immediate caller *might* be 'run_command', but it won't have been
        called by 'run_commands'. Return True in that case or if a call stack
        is unavailable. Return False otherwise.
        """
        if run_frame is None:
            msg = "Call stack not available. bdist_* commands may fail."
            warnings.warn(msg)
            if platform.python_implementation() == 'IronPython':
                msg = "For best results, pass -X:Frames to enable call stack."
                warnings.warn(msg)
            return True
        res = inspect.getouterframes(run_frame)[2]
        caller, = res[:1]
        info = inspect.getframeinfo(caller)
        caller_module = caller.f_globals.get('__name__', '')
        return (
            caller_module == 'distutils.dist'
            and info.function == 'run_commands'
        )

    def do_egg_install(self):

        easy_install = self.distribution.get_command_class('easy_install')

        cmd = easy_install(
            self.distribution, args="x", root=self.root, record=self.record,
        )
        cmd.ensure_finalized()  # finalize before bdist_egg munges install cmd
        cmd.always_copy_from = '.'  # make sure local-dir eggs get installed

        # pick up setup-dir .egg files only: no .egg-info
        cmd.package_index.scan(glob.glob('*.egg'))

        self.run_command('bdist_egg')
        args = [self.distribution.get_command_obj('bdist_egg').egg_output]

        if setuptools.bootstrap_install_from:
            # Bootstrap self-installation of setuptools
            args.insert(0, setuptools.bootstrap_install_from)

        cmd.args = args
        cmd.run()
        setuptools.bootstrap_install_from = None


# XXX Python 3.1 doesn't see _nc if this is inside the class
install.sub_commands = (
    [cmd for cmd in orig.install.sub_commands if cmd[0] not in install._nc] +
    install.new_commands
)
site-packages/setuptools/command/build_py.py000064400000022574151446177000015323 0ustar00from glob import glob
from distutils.util import convert_path
import distutils.command.build_py as orig
import os
import fnmatch
import textwrap
import io
import distutils.errors
import itertools

from setuptools.extern import six
from setuptools.extern.six.moves import map, filter, filterfalse

try:
    from setuptools.lib2to3_ex import Mixin2to3
except ImportError:

    class Mixin2to3:
        def run_2to3(self, files, doctests=True):
            "do nothing"


class build_py(orig.build_py, Mixin2to3):
    """Enhanced 'build_py' command that includes data files with packages

    The data files are specified via a 'package_data' argument to 'setup()'.
    See 'setuptools.dist.Distribution' for more details.

    Also, this version of the 'build_py' command allows you to specify both
    'py_modules' and 'packages' in the same setup operation.
    """

    def finalize_options(self):
        orig.build_py.finalize_options(self)
        self.package_data = self.distribution.package_data
        self.exclude_package_data = (self.distribution.exclude_package_data or
                                     {})
        if 'data_files' in self.__dict__:
            del self.__dict__['data_files']
        self.__updated_files = []
        self.__doctests_2to3 = []

    def run(self):
        """Build modules, packages, and copy data files to build directory"""
        if not self.py_modules and not self.packages:
            return

        if self.py_modules:
            self.build_modules()

        if self.packages:
            self.build_packages()
            self.build_package_data()

        self.run_2to3(self.__updated_files, False)
        self.run_2to3(self.__updated_files, True)
        self.run_2to3(self.__doctests_2to3, True)

        # Only compile actual .py files, using our base class' idea of what our
        # output files are.
        self.byte_compile(orig.build_py.get_outputs(self, include_bytecode=0))

    def __getattr__(self, attr):
        "lazily compute data files"
        if attr == 'data_files':
            self.data_files = self._get_data_files()
            return self.data_files
        return orig.build_py.__getattr__(self, attr)

    def build_module(self, module, module_file, package):
        if six.PY2 and isinstance(package, six.string_types):
            # avoid errors on Python 2 when unicode is passed (#190)
            package = package.split('.')
        outfile, copied = orig.build_py.build_module(self, module, module_file,
                                                     package)
        if copied:
            self.__updated_files.append(outfile)
        return outfile, copied

    def _get_data_files(self):
        """Generate list of '(package,src_dir,build_dir,filenames)' tuples"""
        self.analyze_manifest()
        return list(map(self._get_pkg_data_files, self.packages or ()))

    def _get_pkg_data_files(self, package):
        # Locate package source directory
        src_dir = self.get_package_dir(package)

        # Compute package build directory
        build_dir = os.path.join(*([self.build_lib] + package.split('.')))

        # Strip directory from globbed filenames
        filenames = [
            os.path.relpath(file, src_dir)
            for file in self.find_data_files(package, src_dir)
        ]
        return package, src_dir, build_dir, filenames

    def find_data_files(self, package, src_dir):
        """Return filenames for package's data files in 'src_dir'"""
        patterns = self._get_platform_patterns(
            self.package_data,
            package,
            src_dir,
        )
        globs_expanded = map(glob, patterns)
        # flatten the expanded globs into an iterable of matches
        globs_matches = itertools.chain.from_iterable(globs_expanded)
        glob_files = filter(os.path.isfile, globs_matches)
        files = itertools.chain(
            self.manifest_files.get(package, []),
            glob_files,
        )
        return self.exclude_data_files(package, src_dir, files)

    def build_package_data(self):
        """Copy data files into build directory"""
        for package, src_dir, build_dir, filenames in self.data_files:
            for filename in filenames:
                target = os.path.join(build_dir, filename)
                self.mkpath(os.path.dirname(target))
                srcfile = os.path.join(src_dir, filename)
                outf, copied = self.copy_file(srcfile, target)
                srcfile = os.path.abspath(srcfile)
                if (copied and
                        srcfile in self.distribution.convert_2to3_doctests):
                    self.__doctests_2to3.append(outf)

    def analyze_manifest(self):
        self.manifest_files = mf = {}
        if not self.distribution.include_package_data:
            return
        src_dirs = {}
        for package in self.packages or ():
            # Locate package source directory
            src_dirs[assert_relative(self.get_package_dir(package))] = package

        self.run_command('egg_info')
        ei_cmd = self.get_finalized_command('egg_info')
        for path in ei_cmd.filelist.files:
            d, f = os.path.split(assert_relative(path))
            prev = None
            oldf = f
            while d and d != prev and d not in src_dirs:
                prev = d
                d, df = os.path.split(d)
                f = os.path.join(df, f)
            if d in src_dirs:
                if path.endswith('.py') and f == oldf:
                    continue  # it's a module, not data
                mf.setdefault(src_dirs[d], []).append(path)

    def get_data_files(self):
        pass  # Lazily compute data files in _get_data_files() function.

    def check_package(self, package, package_dir):
        """Check namespace packages' __init__ for declare_namespace"""
        try:
            return self.packages_checked[package]
        except KeyError:
            pass

        init_py = orig.build_py.check_package(self, package, package_dir)
        self.packages_checked[package] = init_py

        if not init_py or not self.distribution.namespace_packages:
            return init_py

        for pkg in self.distribution.namespace_packages:
            if pkg == package or pkg.startswith(package + '.'):
                break
        else:
            return init_py

        with io.open(init_py, 'rb') as f:
            contents = f.read()
        if b'declare_namespace' not in contents:
            raise distutils.errors.DistutilsError(
                "Namespace package problem: %s is a namespace package, but "
                "its\n__init__.py does not call declare_namespace()! Please "
                'fix it.\n(See the setuptools manual under '
                '"Namespace Packages" for details.)\n"' % (package,)
            )
        return init_py

    def initialize_options(self):
        self.packages_checked = {}
        orig.build_py.initialize_options(self)

    def get_package_dir(self, package):
        res = orig.build_py.get_package_dir(self, package)
        if self.distribution.src_root is not None:
            return os.path.join(self.distribution.src_root, res)
        return res

    def exclude_data_files(self, package, src_dir, files):
        """Filter filenames for package's data files in 'src_dir'"""
        files = list(files)
        patterns = self._get_platform_patterns(
            self.exclude_package_data,
            package,
            src_dir,
        )
        match_groups = (
            fnmatch.filter(files, pattern)
            for pattern in patterns
        )
        # flatten the groups of matches into an iterable of matches
        matches = itertools.chain.from_iterable(match_groups)
        bad = set(matches)
        keepers = (
            fn
            for fn in files
            if fn not in bad
        )
        # ditch dupes
        return list(_unique_everseen(keepers))

    @staticmethod
    def _get_platform_patterns(spec, package, src_dir):
        """
        yield platform-specific path patterns (suitable for glob
        or fn_match) from a glob-based spec (such as
        self.package_data or self.exclude_package_data)
        matching package in src_dir.
        """
        raw_patterns = itertools.chain(
            spec.get('', []),
            spec.get(package, []),
        )
        return (
            # Each pattern has to be converted to a platform-specific path
            os.path.join(src_dir, convert_path(pattern))
            for pattern in raw_patterns
        )


# from Python docs
def _unique_everseen(iterable, key=None):
    "List unique elements, preserving order. Remember all elements ever seen."
    # unique_everseen('AAAABBBCCDAABBB') --> A B C D
    # unique_everseen('ABBCcAD', str.lower) --> A B C D
    seen = set()
    seen_add = seen.add
    if key is None:
        for element in filterfalse(seen.__contains__, iterable):
            seen_add(element)
            yield element
    else:
        for element in iterable:
            k = key(element)
            if k not in seen:
                seen_add(k)
                yield element


def assert_relative(path):
    if not os.path.isabs(path):
        return path
    from distutils.errors import DistutilsSetupError

    msg = textwrap.dedent("""
        Error: setup script specifies an absolute path:

            %s

        setup() arguments must *always* be /-separated paths relative to the
        setup.py directory, *never* absolute paths.
        """).lstrip() % path
    raise DistutilsSetupError(msg)
site-packages/setuptools/command/sdist.py000064400000016334151446177000014637 0ustar00from distutils import log
import distutils.command.sdist as orig
import os
import sys
import io
import contextlib

from setuptools.extern import six

from .py36compat import sdist_add_defaults

import pkg_resources

_default_revctrl = list


def walk_revctrl(dirname=''):
    """Find all files under revision control"""
    for ep in pkg_resources.iter_entry_points('setuptools.file_finders'):
        for item in ep.load()(dirname):
            yield item


class sdist(sdist_add_defaults, orig.sdist):
    """Smart sdist that finds anything supported by revision control"""

    user_options = [
        ('formats=', None,
         "formats for source distribution (comma-separated list)"),
        ('keep-temp', 'k',
         "keep the distribution tree around after creating " +
         "archive file(s)"),
        ('dist-dir=', 'd',
         "directory to put the source distribution archive(s) in "
         "[default: dist]"),
    ]

    negative_opt = {}

    README_EXTENSIONS = ['', '.rst', '.txt', '.md']
    READMES = tuple('README{0}'.format(ext) for ext in README_EXTENSIONS)

    def run(self):
        self.run_command('egg_info')
        ei_cmd = self.get_finalized_command('egg_info')
        self.filelist = ei_cmd.filelist
        self.filelist.append(os.path.join(ei_cmd.egg_info, 'SOURCES.txt'))
        self.check_readme()

        # Run sub commands
        for cmd_name in self.get_sub_commands():
            self.run_command(cmd_name)

        self.make_distribution()

        dist_files = getattr(self.distribution, 'dist_files', [])
        for file in self.archive_files:
            data = ('sdist', '', file)
            if data not in dist_files:
                dist_files.append(data)

    def initialize_options(self):
        orig.sdist.initialize_options(self)

        self._default_to_gztar()

    def _default_to_gztar(self):
        # only needed on Python prior to 3.6.
        if sys.version_info >= (3, 6, 0, 'beta', 1):
            return
        self.formats = ['gztar']

    def make_distribution(self):
        """
        Workaround for #516
        """
        with self._remove_os_link():
            orig.sdist.make_distribution(self)

    @staticmethod
    @contextlib.contextmanager
    def _remove_os_link():
        """
        In a context, remove and restore os.link if it exists
        """

        class NoValue:
            pass

        orig_val = getattr(os, 'link', NoValue)
        try:
            del os.link
        except Exception:
            pass
        try:
            yield
        finally:
            if orig_val is not NoValue:
                setattr(os, 'link', orig_val)

    def __read_template_hack(self):
        # This grody hack closes the template file (MANIFEST.in) if an
        #  exception occurs during read_template.
        # Doing so prevents an error when easy_install attempts to delete the
        #  file.
        try:
            orig.sdist.read_template(self)
        except Exception:
            _, _, tb = sys.exc_info()
            tb.tb_next.tb_frame.f_locals['template'].close()
            raise

    # Beginning with Python 2.7.2, 3.1.4, and 3.2.1, this leaky file handle
    #  has been fixed, so only override the method if we're using an earlier
    #  Python.
    has_leaky_handle = (
        sys.version_info < (2, 7, 2)
        or (3, 0) <= sys.version_info < (3, 1, 4)
        or (3, 2) <= sys.version_info < (3, 2, 1)
    )
    if has_leaky_handle:
        read_template = __read_template_hack

    def _add_defaults_python(self):
        """getting python files"""
        if self.distribution.has_pure_modules():
            build_py = self.get_finalized_command('build_py')
            self.filelist.extend(build_py.get_source_files())
            # This functionality is incompatible with include_package_data, and
            # will in fact create an infinite recursion if include_package_data
            # is True.  Use of include_package_data will imply that
            # distutils-style automatic handling of package_data is disabled
            if not self.distribution.include_package_data:
                for _, src_dir, _, filenames in build_py.data_files:
                    self.filelist.extend([os.path.join(src_dir, filename)
                                          for filename in filenames])

    def _add_defaults_data_files(self):
        try:
            if six.PY2:
                sdist_add_defaults._add_defaults_data_files(self)
            else:
                super()._add_defaults_data_files()
        except TypeError:
            log.warn("data_files contains unexpected objects")

    def check_readme(self):
        for f in self.READMES:
            if os.path.exists(f):
                return
        else:
            self.warn(
                "standard file not found: should have one of " +
                ', '.join(self.READMES)
            )

    def make_release_tree(self, base_dir, files):
        orig.sdist.make_release_tree(self, base_dir, files)

        # Save any egg_info command line options used to create this sdist
        dest = os.path.join(base_dir, 'setup.cfg')
        if hasattr(os, 'link') and os.path.exists(dest):
            # unlink and re-copy, since it might be hard-linked, and
            # we don't want to change the source version
            os.unlink(dest)
            self.copy_file('setup.cfg', dest)

        self.get_finalized_command('egg_info').save_version_info(dest)

    def _manifest_is_not_generated(self):
        # check for special comment used in 2.7.1 and higher
        if not os.path.isfile(self.manifest):
            return False

        with io.open(self.manifest, 'rb') as fp:
            first_line = fp.readline()
        return (first_line !=
                '# file GENERATED by distutils, do NOT edit\n'.encode())

    def read_manifest(self):
        """Read the manifest file (named by 'self.manifest') and use it to
        fill in 'self.filelist', the list of files to include in the source
        distribution.
        """
        log.info("reading manifest file '%s'", self.manifest)
        manifest = open(self.manifest, 'rb')
        for line in manifest:
            # The manifest must contain UTF-8. See #303.
            if six.PY3:
                try:
                    line = line.decode('UTF-8')
                except UnicodeDecodeError:
                    log.warn("%r not UTF-8 decodable -- skipping" % line)
                    continue
            # ignore comments and blank lines
            line = line.strip()
            if line.startswith('#') or not line:
                continue
            self.filelist.append(line)
        manifest.close()

    def check_license(self):
        """Checks if license_file' is configured and adds it to
        'self.filelist' if the value contains a valid path.
        """

        opts = self.distribution.get_option_dict('metadata')

        # ignore the source of the value
        _, license_file = opts.get('license_file', (None, None))

        if license_file is None:
            log.debug("'license_file' option was not specified")
            return

        if not os.path.exists(license_file):
            log.warn("warning: Failed to find the configured license file '%s'",
                    license_file)
            return

        self.filelist.append(license_file)
site-packages/setuptools/command/dist_info.py000064400000001700151446177000015456 0ustar00"""
Create a dist_info directory
As defined in the wheel specification
"""

import os

from distutils.core import Command
from distutils import log


class dist_info(Command):

    description = 'create a .dist-info directory'

    user_options = [
        ('egg-base=', 'e', "directory containing .egg-info directories"
                           " (default: top of the source tree)"),
    ]

    def initialize_options(self):
        self.egg_base = None

    def finalize_options(self):
        pass

    def run(self):
        egg_info = self.get_finalized_command('egg_info')
        egg_info.egg_base = self.egg_base
        egg_info.finalize_options()
        egg_info.run()
        dist_info_dir = egg_info.egg_info[:-len('.egg-info')] + '.dist-info'
        log.info("creating '{}'".format(os.path.abspath(dist_info_dir)))

        bdist_wheel = self.get_finalized_command('bdist_wheel')
        bdist_wheel.egg2dist(egg_info.egg_info, dist_info_dir)
site-packages/setuptools/command/egg_info.py000064400000061742151446177000015271 0ustar00"""setuptools.command.egg_info

Create a distribution's .egg-info directory and contents"""

from distutils.filelist import FileList as _FileList
from distutils.errors import DistutilsInternalError
from distutils.util import convert_path
from distutils import log
import distutils.errors
import distutils.filelist
import os
import re
import sys
import io
import warnings
import time
import collections

from setuptools.extern import six
from setuptools.extern.six.moves import map

from setuptools import Command
from setuptools.command.sdist import sdist
from setuptools.command.sdist import walk_revctrl
from setuptools.command.setopt import edit_config
from setuptools.command import bdist_egg
from pkg_resources import (
    parse_requirements, safe_name, parse_version,
    safe_version, yield_lines, EntryPoint, iter_entry_points, to_filename)
import setuptools.unicode_utils as unicode_utils
from setuptools.glob import glob

from setuptools.extern import packaging
from setuptools import SetuptoolsDeprecationWarning

def translate_pattern(glob):
    """
    Translate a file path glob like '*.txt' in to a regular expression.
    This differs from fnmatch.translate which allows wildcards to match
    directory separators. It also knows about '**/' which matches any number of
    directories.
    """
    pat = ''

    # This will split on '/' within [character classes]. This is deliberate.
    chunks = glob.split(os.path.sep)

    sep = re.escape(os.sep)
    valid_char = '[^%s]' % (sep,)

    for c, chunk in enumerate(chunks):
        last_chunk = c == len(chunks) - 1

        # Chunks that are a literal ** are globstars. They match anything.
        if chunk == '**':
            if last_chunk:
                # Match anything if this is the last component
                pat += '.*'
            else:
                # Match '(name/)*'
                pat += '(?:%s+%s)*' % (valid_char, sep)
            continue  # Break here as the whole path component has been handled

        # Find any special characters in the remainder
        i = 0
        chunk_len = len(chunk)
        while i < chunk_len:
            char = chunk[i]
            if char == '*':
                # Match any number of name characters
                pat += valid_char + '*'
            elif char == '?':
                # Match a name character
                pat += valid_char
            elif char == '[':
                # Character class
                inner_i = i + 1
                # Skip initial !/] chars
                if inner_i < chunk_len and chunk[inner_i] == '!':
                    inner_i = inner_i + 1
                if inner_i < chunk_len and chunk[inner_i] == ']':
                    inner_i = inner_i + 1

                # Loop till the closing ] is found
                while inner_i < chunk_len and chunk[inner_i] != ']':
                    inner_i = inner_i + 1

                if inner_i >= chunk_len:
                    # Got to the end of the string without finding a closing ]
                    # Do not treat this as a matching group, but as a literal [
                    pat += re.escape(char)
                else:
                    # Grab the insides of the [brackets]
                    inner = chunk[i + 1:inner_i]
                    char_class = ''

                    # Class negation
                    if inner[0] == '!':
                        char_class = '^'
                        inner = inner[1:]

                    char_class += re.escape(inner)
                    pat += '[%s]' % (char_class,)

                    # Skip to the end ]
                    i = inner_i
            else:
                pat += re.escape(char)
            i += 1

        # Join each chunk with the dir separator
        if not last_chunk:
            pat += sep

    pat += r'\Z'
    return re.compile(pat, flags=re.MULTILINE|re.DOTALL)


class InfoCommon:
    tag_build = None
    tag_date = None

    @property
    def name(self):
        return safe_name(self.distribution.get_name())

    def tagged_version(self):
        version = self.distribution.get_version()
        # egg_info may be called more than once for a distribution,
        # in which case the version string already contains all tags.
        if self.vtags and version.endswith(self.vtags):
            return safe_version(version)
        return safe_version(version + self.vtags)

    def tags(self):
        version = ''
        if self.tag_build:
            version += self.tag_build
        if self.tag_date:
            version += time.strftime("-%Y%m%d")
        return version
    vtags = property(tags)


class egg_info(InfoCommon, Command):
    description = "create a distribution's .egg-info directory"

    user_options = [
        ('egg-base=', 'e', "directory containing .egg-info directories"
                           " (default: top of the source tree)"),
        ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"),
        ('tag-build=', 'b', "Specify explicit tag to add to version number"),
        ('no-date', 'D', "Don't include date stamp [default]"),
    ]

    boolean_options = ['tag-date']
    negative_opt = {
        'no-date': 'tag-date',
    }

    def initialize_options(self):
        self.egg_base = None
        self.egg_name = None
        self.egg_info = None
        self.egg_version = None
        self.broken_egg_info = False

    ####################################
    # allow the 'tag_svn_revision' to be detected and
    # set, supporting sdists built on older Setuptools.
    @property
    def tag_svn_revision(self):
        pass

    @tag_svn_revision.setter
    def tag_svn_revision(self, value):
        pass
    ####################################

    def save_version_info(self, filename):
        """
        Materialize the value of date into the
        build tag. Install build keys in a deterministic order
        to avoid arbitrary reordering on subsequent builds.
        """
        egg_info = collections.OrderedDict()
        # follow the order these keys would have been added
        # when PYTHONHASHSEED=0
        egg_info['tag_build'] = self.tags()
        egg_info['tag_date'] = 0
        edit_config(filename, dict(egg_info=egg_info))

    def finalize_options(self):
        # Note: we need to capture the current value returned
        # by `self.tagged_version()`, so we can later update
        # `self.distribution.metadata.version` without
        # repercussions.
        self.egg_name = self.name
        self.egg_version = self.tagged_version()
        parsed_version = parse_version(self.egg_version)

        try:
            is_version = isinstance(parsed_version, packaging.version.Version)
            spec = (
                "%s==%s" if is_version else "%s===%s"
            )
            list(
                parse_requirements(spec % (self.egg_name, self.egg_version))
            )
        except ValueError:
            raise distutils.errors.DistutilsOptionError(
                "Invalid distribution name or version syntax: %s-%s" %
                (self.egg_name, self.egg_version)
            )

        if self.egg_base is None:
            dirs = self.distribution.package_dir
            self.egg_base = (dirs or {}).get('', os.curdir)

        self.ensure_dirname('egg_base')
        self.egg_info = to_filename(self.egg_name) + '.egg-info'
        if self.egg_base != os.curdir:
            self.egg_info = os.path.join(self.egg_base, self.egg_info)
        if '-' in self.egg_name:
            self.check_broken_egg_info()

        # Set package version for the benefit of dumber commands
        # (e.g. sdist, bdist_wininst, etc.)
        #
        self.distribution.metadata.version = self.egg_version

        # If we bootstrapped around the lack of a PKG-INFO, as might be the
        # case in a fresh checkout, make sure that any special tags get added
        # to the version info
        #
        pd = self.distribution._patched_dist
        if pd is not None and pd.key == self.egg_name.lower():
            pd._version = self.egg_version
            pd._parsed_version = parse_version(self.egg_version)
            self.distribution._patched_dist = None

    def write_or_delete_file(self, what, filename, data, force=False):
        """Write `data` to `filename` or delete if empty

        If `data` is non-empty, this routine is the same as ``write_file()``.
        If `data` is empty but not ``None``, this is the same as calling
        ``delete_file(filename)`.  If `data` is ``None``, then this is a no-op
        unless `filename` exists, in which case a warning is issued about the
        orphaned file (if `force` is false), or deleted (if `force` is true).
        """
        if data:
            self.write_file(what, filename, data)
        elif os.path.exists(filename):
            if data is None and not force:
                log.warn(
                    "%s not set in setup(), but %s exists", what, filename
                )
                return
            else:
                self.delete_file(filename)

    def write_file(self, what, filename, data):
        """Write `data` to `filename` (if not a dry run) after announcing it

        `what` is used in a log message to identify what is being written
        to the file.
        """
        log.info("writing %s to %s", what, filename)
        if six.PY3:
            data = data.encode("utf-8")
        if not self.dry_run:
            f = open(filename, 'wb')
            f.write(data)
            f.close()

    def delete_file(self, filename):
        """Delete `filename` (if not a dry run) after announcing it"""
        log.info("deleting %s", filename)
        if not self.dry_run:
            os.unlink(filename)

    def run(self):
        self.mkpath(self.egg_info)
        os.utime(self.egg_info, None)
        installer = self.distribution.fetch_build_egg
        for ep in iter_entry_points('egg_info.writers'):
            ep.require(installer=installer)
            writer = ep.resolve()
            writer(self, ep.name, os.path.join(self.egg_info, ep.name))

        # Get rid of native_libs.txt if it was put there by older bdist_egg
        nl = os.path.join(self.egg_info, "native_libs.txt")
        if os.path.exists(nl):
            self.delete_file(nl)

        self.find_sources()

    def find_sources(self):
        """Generate SOURCES.txt manifest file"""
        manifest_filename = os.path.join(self.egg_info, "SOURCES.txt")
        mm = manifest_maker(self.distribution)
        mm.manifest = manifest_filename
        mm.run()
        self.filelist = mm.filelist

    def check_broken_egg_info(self):
        bei = self.egg_name + '.egg-info'
        if self.egg_base != os.curdir:
            bei = os.path.join(self.egg_base, bei)
        if os.path.exists(bei):
            log.warn(
                "-" * 78 + '\n'
                "Note: Your current .egg-info directory has a '-' in its name;"
                '\nthis will not work correctly with "setup.py develop".\n\n'
                'Please rename %s to %s to correct this problem.\n' + '-' * 78,
                bei, self.egg_info
            )
            self.broken_egg_info = self.egg_info
            self.egg_info = bei  # make it work for now


class FileList(_FileList):
    # Implementations of the various MANIFEST.in commands

    def process_template_line(self, line):
        # 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 (dir_pattern).
        (action, patterns, dir, dir_pattern) = self._parse_template_line(line)

        # 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':
            self.debug_print("include " + ' '.join(patterns))
            for pattern in patterns:
                if not self.include(pattern):
                    log.warn("warning: no files found matching '%s'", pattern)

        elif action == 'exclude':
            self.debug_print("exclude " + ' '.join(patterns))
            for pattern in patterns:
                if not self.exclude(pattern):
                    log.warn(("warning: no previously-included files "
                              "found matching '%s'"), pattern)

        elif action == 'global-include':
            self.debug_print("global-include " + ' '.join(patterns))
            for pattern in patterns:
                if not self.global_include(pattern):
                    log.warn(("warning: no files found matching '%s' "
                              "anywhere in distribution"), pattern)

        elif action == 'global-exclude':
            self.debug_print("global-exclude " + ' '.join(patterns))
            for pattern in patterns:
                if not self.global_exclude(pattern):
                    log.warn(("warning: no previously-included files matching "
                              "'%s' found anywhere in distribution"),
                             pattern)

        elif action == 'recursive-include':
            self.debug_print("recursive-include %s %s" %
                             (dir, ' '.join(patterns)))
            for pattern in patterns:
                if not self.recursive_include(dir, pattern):
                    log.warn(("warning: no files found matching '%s' "
                              "under directory '%s'"),
                             pattern, dir)

        elif action == 'recursive-exclude':
            self.debug_print("recursive-exclude %s %s" %
                             (dir, ' '.join(patterns)))
            for pattern in patterns:
                if not self.recursive_exclude(dir, pattern):
                    log.warn(("warning: no previously-included files matching "
                              "'%s' found under directory '%s'"),
                             pattern, dir)

        elif action == 'graft':
            self.debug_print("graft " + dir_pattern)
            if not self.graft(dir_pattern):
                log.warn("warning: no directories found matching '%s'",
                         dir_pattern)

        elif action == 'prune':
            self.debug_print("prune " + dir_pattern)
            if not self.prune(dir_pattern):
                log.warn(("no previously-included directories found "
                          "matching '%s'"), dir_pattern)

        else:
            raise DistutilsInternalError(
                "this cannot happen: invalid action '%s'" % action)

    def _remove_files(self, predicate):
        """
        Remove all files from the file list that match the predicate.
        Return True if any matching files were removed
        """
        found = False
        for i in range(len(self.files) - 1, -1, -1):
            if predicate(self.files[i]):
                self.debug_print(" removing " + self.files[i])
                del self.files[i]
                found = True
        return found

    def include(self, pattern):
        """Include files that match 'pattern'."""
        found = [f for f in glob(pattern) if not os.path.isdir(f)]
        self.extend(found)
        return bool(found)

    def exclude(self, pattern):
        """Exclude files that match 'pattern'."""
        match = translate_pattern(pattern)
        return self._remove_files(match.match)

    def recursive_include(self, dir, pattern):
        """
        Include all files anywhere in 'dir/' that match the pattern.
        """
        full_pattern = os.path.join(dir, '**', pattern)
        found = [f for f in glob(full_pattern, recursive=True)
                 if not os.path.isdir(f)]
        self.extend(found)
        return bool(found)

    def recursive_exclude(self, dir, pattern):
        """
        Exclude any file anywhere in 'dir/' that match the pattern.
        """
        match = translate_pattern(os.path.join(dir, '**', pattern))
        return self._remove_files(match.match)

    def graft(self, dir):
        """Include all files from 'dir/'."""
        found = [
            item
            for match_dir in glob(dir)
            for item in distutils.filelist.findall(match_dir)
        ]
        self.extend(found)
        return bool(found)

    def prune(self, dir):
        """Filter out files from 'dir/'."""
        match = translate_pattern(os.path.join(dir, '**'))
        return self._remove_files(match.match)

    def global_include(self, pattern):
        """
        Include all files anywhere in the current directory that match the
        pattern. This is very inefficient on large file trees.
        """
        if self.allfiles is None:
            self.findall()
        match = translate_pattern(os.path.join('**', pattern))
        found = [f for f in self.allfiles if match.match(f)]
        self.extend(found)
        return bool(found)

    def global_exclude(self, pattern):
        """
        Exclude all files anywhere that match the pattern.
        """
        match = translate_pattern(os.path.join('**', pattern))
        return self._remove_files(match.match)

    def append(self, item):
        if item.endswith('\r'):  # Fix older sdists built on Windows
            item = item[:-1]
        path = convert_path(item)

        if self._safe_path(path):
            self.files.append(path)

    def extend(self, paths):
        self.files.extend(filter(self._safe_path, paths))

    def _repair(self):
        """
        Replace self.files with only safe paths

        Because some owners of FileList manipulate the underlying
        ``files`` attribute directly, this method must be called to
        repair those paths.
        """
        self.files = list(filter(self._safe_path, self.files))

    def _safe_path(self, path):
        enc_warn = "'%s' not %s encodable -- skipping"

        # To avoid accidental trans-codings errors, first to unicode
        u_path = unicode_utils.filesys_decode(path)
        if u_path is None:
            log.warn("'%s' in unexpected encoding -- skipping" % path)
            return False

        # Must ensure utf-8 encodability
        utf8_path = unicode_utils.try_encode(u_path, "utf-8")
        if utf8_path is None:
            log.warn(enc_warn, path, 'utf-8')
            return False

        try:
            # accept is either way checks out
            if os.path.exists(u_path) or os.path.exists(utf8_path):
                return True
        # this will catch any encode errors decoding u_path
        except UnicodeEncodeError:
            log.warn(enc_warn, path, sys.getfilesystemencoding())


class manifest_maker(sdist):
    template = "MANIFEST.in"

    def initialize_options(self):
        self.use_defaults = 1
        self.prune = 1
        self.manifest_only = 1
        self.force_manifest = 1

    def finalize_options(self):
        pass

    def run(self):
        self.filelist = FileList()
        if not os.path.exists(self.manifest):
            self.write_manifest()  # it must exist so it'll get in the list
        self.add_defaults()
        if os.path.exists(self.template):
            self.read_template()
        self.prune_file_list()
        self.filelist.sort()
        self.filelist.remove_duplicates()
        self.write_manifest()

    def _manifest_normalize(self, path):
        path = unicode_utils.filesys_decode(path)
        return path.replace(os.sep, '/')

    def write_manifest(self):
        """
        Write the file list in 'self.filelist' to the manifest file
        named by 'self.manifest'.
        """
        self.filelist._repair()

        # Now _repairs should encodability, but not unicode
        files = [self._manifest_normalize(f) for f in self.filelist.files]
        msg = "writing manifest file '%s'" % self.manifest
        self.execute(write_file, (self.manifest, files), msg)

    def warn(self, msg):
        if not self._should_suppress_warning(msg):
            sdist.warn(self, msg)

    @staticmethod
    def _should_suppress_warning(msg):
        """
        suppress missing-file warnings from sdist
        """
        return re.match(r"standard file .*not found", msg)

    def add_defaults(self):
        sdist.add_defaults(self)
        self.check_license()
        self.filelist.append(self.template)
        self.filelist.append(self.manifest)
        rcfiles = list(walk_revctrl())
        if rcfiles:
            self.filelist.extend(rcfiles)
        elif os.path.exists(self.manifest):
            self.read_manifest()

        if os.path.exists("setup.py"):
            # setup.py should be included by default, even if it's not
            # the script called to create the sdist
            self.filelist.append("setup.py")

        ei_cmd = self.get_finalized_command('egg_info')
        self.filelist.graft(ei_cmd.egg_info)

    def prune_file_list(self):
        build = self.get_finalized_command('build')
        base_dir = self.distribution.get_fullname()
        self.filelist.prune(build.build_base)
        self.filelist.prune(base_dir)
        sep = re.escape(os.sep)
        self.filelist.exclude_pattern(r'(^|' + sep + r')(RCS|CVS|\.svn)' + sep,
                                      is_regex=1)


def write_file(filename, contents):
    """Create a file with the specified name and write 'contents' (a
    sequence of strings without line terminators) to it.
    """
    contents = "\n".join(contents)

    # assuming the contents has been vetted for utf-8 encoding
    contents = contents.encode("utf-8")

    with open(filename, "wb") as f:  # always write POSIX-style manifest
        f.write(contents)


def write_pkg_info(cmd, basename, filename):
    log.info("writing %s", filename)
    if not cmd.dry_run:
        metadata = cmd.distribution.metadata
        metadata.version, oldver = cmd.egg_version, metadata.version
        metadata.name, oldname = cmd.egg_name, metadata.name

        try:
            # write unescaped data to PKG-INFO, so older pkg_resources
            # can still parse it
            metadata.write_pkg_info(cmd.egg_info)
        finally:
            metadata.name, metadata.version = oldname, oldver

        safe = getattr(cmd.distribution, 'zip_safe', None)

        bdist_egg.write_safety_flag(cmd.egg_info, safe)


def warn_depends_obsolete(cmd, basename, filename):
    if os.path.exists(filename):
        log.warn(
            "WARNING: 'depends.txt' is not used by setuptools 0.6!\n"
            "Use the install_requires/extras_require setup() args instead."
        )


def _write_requirements(stream, reqs):
    lines = yield_lines(reqs or ())
    append_cr = lambda line: line + '\n'
    lines = map(append_cr, lines)
    stream.writelines(lines)


def write_requirements(cmd, basename, filename):
    dist = cmd.distribution
    data = six.StringIO()
    _write_requirements(data, dist.install_requires)
    extras_require = dist.extras_require or {}
    for extra in sorted(extras_require):
        data.write('\n[{extra}]\n'.format(**vars()))
        _write_requirements(data, extras_require[extra])
    cmd.write_or_delete_file("requirements", filename, data.getvalue())


def write_setup_requirements(cmd, basename, filename):
    data = io.StringIO()
    _write_requirements(data, cmd.distribution.setup_requires)
    cmd.write_or_delete_file("setup-requirements", filename, data.getvalue())


def write_toplevel_names(cmd, basename, filename):
    pkgs = dict.fromkeys(
        [
            k.split('.', 1)[0]
            for k in cmd.distribution.iter_distribution_names()
        ]
    )
    cmd.write_file("top-level names", filename, '\n'.join(sorted(pkgs)) + '\n')


def overwrite_arg(cmd, basename, filename):
    write_arg(cmd, basename, filename, True)


def write_arg(cmd, basename, filename, force=False):
    argname = os.path.splitext(basename)[0]
    value = getattr(cmd.distribution, argname, None)
    if value is not None:
        value = '\n'.join(value) + '\n'
    cmd.write_or_delete_file(argname, filename, value, force)


def write_entries(cmd, basename, filename):
    ep = cmd.distribution.entry_points

    if isinstance(ep, six.string_types) or ep is None:
        data = ep
    elif ep is not None:
        data = []
        for section, contents in sorted(ep.items()):
            if not isinstance(contents, six.string_types):
                contents = EntryPoint.parse_group(section, contents)
                contents = '\n'.join(sorted(map(str, contents.values())))
            data.append('[%s]\n%s\n\n' % (section, contents))
        data = ''.join(data)

    cmd.write_or_delete_file('entry points', filename, data, True)


def get_pkg_info_revision():
    """
    Get a -r### off of PKG-INFO Version in case this is an sdist of
    a subversion revision.
    """
    warnings.warn("get_pkg_info_revision is deprecated.", EggInfoDeprecationWarning)
    if os.path.exists('PKG-INFO'):
        with io.open('PKG-INFO') as f:
            for line in f:
                match = re.match(r"Version:.*-r(\d+)\s*$", line)
                if match:
                    return int(match.group(1))
    return 0


class EggInfoDeprecationWarning(SetuptoolsDeprecationWarning):
    """Class for warning about deprecations in eggInfo in setupTools. Not ignored by default, unlike DeprecationWarning."""
site-packages/setuptools/command/__pycache__/__init__.cpython-38.opt-1.pyc000064400000001342151446177000022466 0ustar00U

�QabR�@szdddddddddd	d
ddd
dddddddddgZddlmZddlZddlmZdejkrrdejd<ej�d�[[dS)�alias�	bdist_eggZ	bdist_rpmZ	build_extZbuild_pyZdevelopZeasy_installZegg_infoZinstallZinstall_lib�rotateZsaveoptsZsdistZsetoptZtestZinstall_egg_info�install_scripts�registerZ
bdist_wininstZupload_docsZuploadZ
build_clibZ	dist_info�)�bdistN)rZegg)rzPython .egg file)	�__all__Zdistutils.command.bdistr�sysZsetuptools.commandrZformat_commandsZformat_command�append�rr�?/usr/lib/python3.8/site-packages/setuptools/command/__init__.py�<module>s<�

site-packages/setuptools/command/__pycache__/saveopts.cpython-38.pyc000064400000001571151446177000021640 0ustar00U

�Qab��@s$ddlmZmZGdd�de�ZdS)�)�edit_config�option_basec@seZdZdZdZdd�ZdS)�saveoptsz#Save command-line options to a filez7save supplied options to setup.cfg or other config filecCsh|j}i}|jD]B}|dkrq|�|���D]$\}\}}|dkr,||�|i�|<q,qt|j||j�dS)Nrzcommand line)ZdistributionZcommand_optionsZget_option_dict�items�
setdefaultr�filenameZdry_run)�selfZdistZsettings�cmd�opt�src�val�r
�?/usr/lib/python3.8/site-packages/setuptools/command/saveopts.py�run	s
zsaveopts.runN)�__name__�
__module__�__qualname__�__doc__�descriptionrr
r
r
rrsrN)Zsetuptools.command.setoptrrrr
r
r
r�<module>ssite-packages/setuptools/command/__pycache__/setopt.cpython-38.opt-1.pyc000064400000010671151446177000022252 0ustar00U

�Qab��@s�ddlmZddlmZddlmZddlZddlZddlmZddl	m
Z
ddd	d
gZddd�Zddd�Z
Gdd	�d	e
�ZGdd
�d
e�ZdS)�)�convert_path)�log)�DistutilsOptionErrorN)�configparser)�Command�config_file�edit_config�option_base�setopt�localcCsh|dkrdS|dkr,tj�tj�tj�d�S|dkrZtjdkrBdpDd}tj�td	|��St	d
|��dS)z�Get the filename of the distutils, local, global, or per-user config

    `kind` must be one of "local", "global", or "user"
    rz	setup.cfg�globalz
distutils.cfg�user�posix�.�z~/%spydistutils.cfgz7config_file() type must be 'local', 'global', or 'user'N)
�os�path�join�dirname�	distutils�__file__�name�
expanduserr�
ValueError)Zkind�dot�r�=/usr/lib/python3.8/site-packages/setuptools/command/setopt.pyrs��Fc		Cs&t�d|�t��}|�|g�|��D]�\}}|dkrRt�d||�|�|�q(|�|�stt�d||�|�	|�|��D]p\}}|dkr�t�d|||�|�
||�|�|�s�t�d||�|�|�q|t�d||||�|�|||�q|q(t�d|�|�s"t
|d	��}|�|�W5QRXdS)
aYEdit a configuration file to include `settings`

    `settings` is a dictionary of dictionaries or ``None`` values, keyed by
    command/section name.  A ``None`` value means to delete the entire section,
    while a dictionary lists settings to be changed or deleted in that section.
    A setting of ``None`` means to delete that setting.
    zReading configuration from %sNzDeleting section [%s] from %szAdding new section [%s] to %szDeleting %s.%s from %sz#Deleting empty [%s] section from %szSetting %s.%s to %r in %sz
Writing %s�w)r�debugrZRawConfigParser�read�items�infoZremove_sectionZhas_sectionZadd_sectionZ
remove_option�options�set�open�write)	�filenameZsettings�dry_runZoptsZsectionr"�option�value�frrrr!sJ

�
��c@s2eZdZdZdddgZddgZdd�Zd	d
�ZdS)r	z<Abstract base class for commands that mess with config files)�
global-config�gz0save options to the site-wide distutils.cfg file)�user-config�uz7save options to the current user's pydistutils.cfg file)z	filename=r*z-configuration file to use (default=setup.cfg)r+r-cCsd|_d|_d|_dS�N)�
global_config�user_configr&��selfrrr�initialize_options\szoption_base.initialize_optionscCsvg}|jr|�td��|jr,|�td��|jdk	rB|�|j�|sT|�td��t|�dkrjtd|��|\|_dS)Nrr
r�z/Must specify only one configuration file option)r0�appendrr1r&�lenr)r3�	filenamesrrr�finalize_optionsas
�zoption_base.finalize_optionsN)�__name__�
__module__�__qualname__�__doc__�user_options�boolean_optionsr4r9rrrrr	Ls�
�c@sJeZdZdZdZddddgejZejdgZdd	�Zd
d�Z	dd
�Z
dS)r
z#Save command-line options to a filez1set an option in setup.cfg or another config file)zcommand=�czcommand to set an option for)zoption=�oz
option to set)z
set-value=�szvalue of the option)�remove�rzremove (unset) the valuerCcCs&t�|�d|_d|_d|_d|_dSr/)r	r4�commandr(�	set_valuerCr2rrrr4�s

zsetopt.initialize_optionscCsBt�|�|jdks|jdkr&td��|jdkr>|js>td��dS)Nz%Must specify --command *and* --optionz$Must specify --set-value or --remove)r	r9rEr(rrFrCr2rrrr9�s

zsetopt.finalize_optionscCs*t|j|j|j�dd�|jii|j�dS)N�-�_)rr&rEr(�replacerFr'r2rrr�run�s��z
setopt.runN)r:r;r<r=�descriptionr	r>r?r4r9rJrrrrr
ss��)r)F)Zdistutils.utilrrrZdistutils.errorsrrZsetuptools.extern.six.movesrZ
setuptoolsr�__all__rrr	r
rrrr�<module>s

+'site-packages/setuptools/command/__pycache__/bdist_egg.cpython-38.opt-1.pyc000064400000033546151446177000022671 0ustar00U

�Qab	G�@sxdZddlmZddlmZmZddlmZddlm	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlmZddlmZmZmZdd	lmZdd
lmZddlmZzddlmZmZd
d�ZWn,ek
r�ddlm Z mZdd�ZYnXdd�Z!dd�Z"dd�Z#Gdd�de�Z$e%�&d�'��Z(dd�Z)dd�Z*dd�Z+d d!d"�Z,d#d$�Z-d%d&�Z.d'd(�Z/d)d*d+d,gZ0d1d/d0�Z1dS)2z6setuptools.command.bdist_egg

Build .egg distributions�)�DistutilsSetupError)�remove_tree�mkpath)�log)�CodeTypeN)�six)�get_build_platform�Distribution�ensure_directory)�
EntryPoint)�Library)�Command)�get_path�get_python_versioncCstd�S)NZpurelib)r�rr�@/usr/lib/python3.8/site-packages/setuptools/command/bdist_egg.py�_get_purelibsr)�get_python_librcCstd�S)NF)rrrrrrscCs2d|krtj�|�d}|�d�r.|dd�}|S)N�.r�modulei����)�os�path�splitext�endswith)�filenamerrr�strip_module#s

rccs6t�|�D]&\}}}|��|��|||fVq
dS)zbDo os.walk in a reproducible way,
    independent of indeterministic filesystem readdir order
    N)r�walk�sort)�dir�base�dirs�filesrrr�sorted_walk+sr"c	Cs6t�d���}t|d��}|�||�W5QRXdS)NaR
        def __bootstrap__():
            global __bootstrap__, __loader__, __file__
            import sys, pkg_resources, imp
            __file__ = pkg_resources.resource_filename(__name__, %r)
            __loader__ = None; del __bootstrap__, __loader__
            imp.load_dynamic(__name__,__file__)
        __bootstrap__()
        �w)�textwrap�dedent�lstrip�open�write)�resource�pyfileZ_stub_template�frrr�
write_stub5s	r,c@s�eZdZdZdddde�fdddd	gZd
ddgZd
d�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd �Zd!d"�Zd#S)$�	bdist_eggzcreate an "egg" distribution)z
bdist-dir=�bz1temporary directory for creating the distributionz
plat-name=�pz;platform name to embed in generated filenames (default: %s))�exclude-source-filesNz+remove all .py files from the generated egg)�	keep-temp�kzPkeep the pseudo-installation tree around after creating the distribution archive)z	dist-dir=�dz-directory to put final built distributions in)�
skip-buildNz2skip rebuilding everything (for testing/debugging)r1r4r0cCs.d|_d|_d|_d|_d|_d|_d|_dS)Nr)�	bdist_dir�	plat_name�	keep_temp�dist_dir�
skip_build�
egg_output�exclude_source_files��selfrrr�initialize_optionsZszbdist_egg.initialize_optionscCs�|�d�}|_|j|_|jdkr>|�d�j}tj�|d�|_|jdkrPt	�|_|�
dd�|jdkr�tdd|j
|jt�|j��o�|j��
�}tj�|j|d�|_dS)N�egg_infoZbdistZegg)r8r8z.egg)�get_finalized_command�ei_cmdr?r5�
bdist_baserr�joinr6rZset_undefined_optionsr:r	Zegg_nameZegg_versionr�distribution�has_ext_modulesr8)r=rArB�basenamerrr�finalize_optionscs$


�zbdist_egg.finalize_optionscCs�|j|�d�_tj�tj�t���}|jj	g}|j_	|D]�}t
|t�r�t|�dkr�tj�
|d�r�tj�|d�}tj�|�}||ks�|�|tj�r�|t|�dd�|df}|jj	�|�q:z"t�d|j�|jdddd�W5||j_	XdS)N�install�r�zinstalling package data to %s�install_data)�force�root)r5r@�install_librr�normcase�realpathrrD�
data_files�
isinstance�tuple�len�isabs�
startswith�sep�appendr�info�call_command)r=Z
site_packages�old�itemrPZ
normalizedrrr�do_install_data{s"�zbdist_egg.do_install_datacCs|jgS)N)r:r<rrr�get_outputs�szbdist_egg.get_outputscKsPtD]}|�||j�q|�d|j�|�d|j�|j|f|�}|�|�|S)z8Invoke reinitialized command `cmdname` with keyword argsr9�dry_run)�INSTALL_DIRECTORY_ATTRS�
setdefaultr5r9r_Zreinitialize_command�run_command)r=Zcmdname�kw�dirname�cmdrrrrZ�s
zbdist_egg.call_commandcCs�|�d�t�d|j�|�d�}|j}d|_|j��rH|jsH|�d�|j	ddd�}||_|�
�\}}g|_g}t|�D]|\}}t
j�|�\}	}
t
j�|jt|	�d�}|j�|�t�d	|�|js�tt
j�|�|�|�|�|�t
jd
�||<qz|�r|�|�|jj�r|��|j}t
j�|d�}
|�|
�|jj�rlt
j�|
d�}t�d
|�|j	d|dd�|�|
�t
j�|
d�}|�r�t�d|�|j�st|�t|d�}|� d�|��|� d�|�!�n,t
j�"|��rt�d|�|j�st
�#|�t$t
j�|d�|�%��t
j�&t
j�|j'd���r<t�(d�|j)�rL|�*�t+|j,||j-|j|�.�d�|j/�s�t0|j|jd�t1|jdg��dt2�|j,f�dS)Nr?zinstalling library code to %srHZ
build_clibrNr)Zwarn_dir�.pyzcreating stub loader for %s�/�EGG-INFO�scriptszinstalling scripts to %sZinstall_scriptsrJ)�install_dirZno_epznative_libs.txtz
writing %s�wt�
zremoving %szdepends.txtzxWARNING: 'depends.txt' will not be used by setuptools 0.6!
Use the install_requires/extras_require setup() args instead.)�verboser_�mode�r_Z
dist_filesr-)3rbrrYr5r@rMrDZhas_c_librariesr9rZ�get_ext_outputs�stubs�	enumeraterrrrCrrXr_r,rF�replacerWZbyte_compilerQr]rri�copy_metadata_tor
r'r(�close�isfile�unlink�write_safety_flag�zip_safe�existsr?�warnr;�zap_pyfiles�make_zipfiler:rm�
gen_headerr7r�getattrr)r=ZinstcmdZold_rootre�all_outputs�ext_outputsZ
to_compiler/Zext_namer�extr*Zarchive_rootr?Z
script_dirZnative_libsZ	libs_filerrr�run�s�


�




�




����z
bdist_egg.runc

Cs�t�d�t|j�D]�\}}}|D]�}tj�||�}|�d�rTt�d|�t�	|�|�d�r"|}d}t
�||�}tj�|tj|�
d�d�}	t�d||	f�zt�|	�Wntk
r�YnXt�||	�q"qdS)	Nz+Removing .py files from temporary directoryrfzDeleting %s�__pycache__z#(?P<name>.+)\.(?P<magic>[^.]+)\.pyc�name�.pyczRenaming file from [%s] to [%s])rrY�walk_eggr5rrrCr�debugrw�re�match�pardir�group�remove�OSError�rename)
r=rr r!r�rZpath_old�pattern�mZpath_newrrrr|�s4



���zbdist_egg.zap_pyfilescCs2t|jdd�}|dk	r|St�d�t|j|j�S)Nryz4zip_safe flag not set; analyzing archive contents...)rrDrr{�analyze_eggr5rq)r=�saferrrrys

zbdist_egg.zip_safec
Cs�t�|jjpd�}|�di��d�}|dkr0dS|jr<|jrJtd|f��djt	j
�}|j}d�|j�}|jd}t
j�|j�}d	t�}|js�tt
j�|j�|jd
�t|jd�}	|	�|�|	��dS)N�zsetuptools.installationZeggsecutabler#zGeggsecutable entry point (%r) cannot have 'extras' or refer to a modulez{}.{}rraH#!/bin/sh
if [ `basename $0` = "%(basename)s" ]
then exec python%(pyver)s -c "import sys, os; sys.path.insert(0, os.path.abspath('$0')); from %(pkg)s import %(base)s; sys.exit(%(full)s())" "$@"
else
  echo $0 is not the correct name for this egg file.
  echo Please rename it back to %(basename)s and try again.
  exec false
fi
ro�a)rZ	parse_maprDZentry_points�getZattrsZextrasr�format�sys�version_infoZmodule_namerCrrrFr:�localsr_rrdr'r(ru)
r=ZepmZepZpyver�pkgZfullrrF�headerr+rrrr~s0��
�
zbdist_egg.gen_headercCshtj�|j�}tj�|d�}|jjjD]<}|�|�r&tj�||t	|�d��}t
|�|�||�q&dS)z*Copy metadata (egg info) to the target_dirr�N)rr�normpathr?rCrAZfilelistr!rVrTr
Z	copy_file)r=Z
target_dirZ
norm_egg_info�prefixr�targetrrrrt:s
zbdist_egg.copy_metadata_tocCsg}g}|jdi}t|j�D]f\}}}|D].}tj�|�d��tkr*|�|||�q*|D]"}|||d|tj�||�<q^q|j	�
�r�|�d�}|jD]Z}	t
|	t�r�q�|�|	j�}
|�|
�}tj�|��d�s�tj�tj�|j|��r�|�|�q�||fS)zAGet a list of relative paths to C extensions in the output distror�rJrgZ	build_extzdl-)r5r"rrr�lower�NATIVE_EXTENSIONSrXrCrDrEr@�
extensionsrRrZget_ext_fullnamer�Zget_ext_filenamerFrVrz)r=r�r��pathsrr r!rZ	build_cmdr��fullnamerrrrpFs0
��




zbdist_egg.get_ext_outputsN)�__name__�
__module__�__qualname__�descriptionrZuser_optionsZboolean_optionsr>rGr]r^rZr�r|ryr~rtrprrrrr-Cs2���	
Q'r-z.dll .so .dylib .pydccsHt|�}t|�\}}}d|kr(|�d�|||fV|D]
}|Vq8dS)z@Walk an unpacked egg's contents, skipping the metadata directoryrhN)r"�nextr�)�egg_dirZwalkerrr r!Zbdfrrrr�fs
r�c	Cs�t��D](\}}tj�tj�|d|��r|Sqt�s<dSd}t|�D]R\}}}|D]B}|�d�sV|�d�rrqVqV|�d�s�|�d�rVt	||||�o�|}qVqH|S)NrhFTrfz.pywr�z.pyo)
�safety_flags�itemsrrrzrC�can_scanr�r�scan_module)	r�rq�flag�fnr�rr r!r�rrrr�qs
r�cCs�t��D]r\}}tj�||�}tj�|�rJ|dks>t|�|krzt�|�q|dk	rt|�|krt|d�}|�	d�|�
�qdS)Nrkrl)r�r�rrrCrz�boolrwr'r(ru)r�r�r�r�r+rrrrx�s

rxzzip-safeznot-zip-safe)TFc
Cstj�||�}|dd�|kr"dS|t|�dd��tjd�}||rJdpLdtj�|�d}tjrld}nt	j
d	kr|d
}nd}t|d�}|�|�t
�|�}	|��d}
t�t|	��}d
D]}||kr�t�d||�d}
q�d|k�r
dD]}||kr�t�d||�d}
q�|
S)z;Check whether module possibly uses unsafe-for-zipfile stuffN���TrJrr�r�)�����rb)�__file__�__path__z%s: module references %sF�inspect)Z	getsourceZ
getabsfileZ
getsourcefileZgetfilegetsourcelinesZ
findsourceZgetcommentsZgetframeinfoZgetinnerframesZgetouterframes�stackZtracez"%s: module MAY be using inspect.%s)rrrCrTrsrWrrZPY2r�r�r'�read�marshal�loadru�dict�fromkeys�iter_symbolsrr{)
r�rr�rqrr�r�skipr+�coder�ZsymbolsZbadrrrr��s4 




r�ccsT|jD]
}|Vq|jD]6}t|tj�r0|Vqt|t�rt|�D]
}|VqBqdS)zBYield names and strings used by `code` and its nested code objectsN)�co_names�	co_constsrRrZstring_typesrr�)r�r��constrrrr��s


r�cCs2tj�d�stjdkrdSt�d�t�d�dS)N�javaZcliTz1Unable to analyze compiled code on this platform.zfPlease ask the author to include a 'zip_safe' setting (either True or False) in the package's setup.py)r��platformrVrr{rrrrr��s
r�rNrjrKZinstall_baseTr#c
s�ddl}ttj�|��d�t�d|����fdd�}|rB|jn|j}�s�|j	|||d�}	t
��D]\}
}}||	|
|�qd|	��n t
��D]\}
}}|d|
|�q�|S)aqCreate a zip file from all the files under 'base_dir'.  The output
    zip file will be named 'base_dir' + ".zip".  Uses either the "zipfile"
    Python module (if available) or the InfoZIP "zip" utility (if installed
    and found on the default search path).  If neither tool is available,
    raises DistutilsExecError.  Returns the name of the output zip file.
    rNroz#creating '%s' and adding '%s' to itcs`|D]V}tj�tj�||��}tj�|�r|t��dd�}�sN|�||�t�d|�qdS)NrJzadding '%s')	rrr�rCrvrTr(rr�)�zrd�namesr�rr/��base_dirr_rr�visit�szmake_zipfile.<locals>.visit)�compression)�zipfilerrrrdrrYZZIP_DEFLATEDZ
ZIP_STOREDZZipFiler"ru)
Zzip_filenamer�rmr_�compressrnr�r�r�r�rdr r!rr�rr}�s	
r})rrTr#)2�__doc__Zdistutils.errorsrZdistutils.dir_utilrrZ	distutilsr�typesrr�rr�r$r�Zsetuptools.externrZ
pkg_resourcesrr	r
rZsetuptools.extensionrZ
setuptoolsr
Z	sysconfigrrr�ImportErrorZdistutils.sysconfigrrr"r,r-r�r��splitr�r�r�rxr�r�r�r�r`r}rrrr�<module>sX
"�$
��site-packages/setuptools/command/__pycache__/dist_info.cpython-38.pyc000064400000002521151446177000021746 0ustar00U

�Qab��@s8dZddlZddlmZddlmZGdd�de�ZdS)zD
Create a dist_info directory
As defined in the wheel specification
�N)�Command)�logc@s.eZdZdZdgZdd�Zdd�Zdd�Zd	S)
�	dist_infozcreate a .dist-info directory)z	egg-base=�ezLdirectory containing .egg-info directories (default: top of the source tree)cCs
d|_dS�N)�egg_base��self�r
�@/usr/lib/python3.8/site-packages/setuptools/command/dist_info.py�initialize_optionsszdist_info.initialize_optionscCsdSrr
rr
r
r�finalize_optionsszdist_info.finalize_optionscCsn|�d�}|j|_|��|��|jdtd��d}t�d�t	j
�|���|�d�}|�|j|�dS)N�egg_infoz	.egg-infoz
.dist-infoz
creating '{}'�bdist_wheel)
Zget_finalized_commandrr
�runr�lenr�info�format�os�path�abspathZegg2dist)r	rZ
dist_info_dirrr
r
rrs

z
dist_info.runN)�__name__�
__module__�__qualname__�descriptionZuser_optionsrr
rr
r
r
rrs�r)�__doc__rZdistutils.corerZ	distutilsrrr
r
r
r�<module>ssite-packages/setuptools/command/__pycache__/install_lib.cpython-38.pyc000064400000010034151446177000022262 0ustar00U

�Qab�@sHddlZddlZddlmZmZddlmmZGdd�dej�ZdS)�N)�product�starmapc@sZeZdZdZdd�Zdd�Zdd�Zedd	��Zd
d�Z	edd
��Z
ddd�Zdd�ZdS)�install_libz9Don't add compiled flags to filenames of non-Python filescCs&|��|��}|dk	r"|�|�dS�N)Zbuild�installZbyte_compile)�self�outfiles�r	�B/usr/lib/python3.8/site-packages/setuptools/command/install_lib.py�run
szinstall_lib.runcs4�fdd����D�}t|����}tt�j|��S)z�
        Return a collections.Sized collections.Container of paths to be
        excluded for single_version_externally_managed installations.
        c3s"|]}��|�D]
}|VqqdSr)�
_all_packages)�.0Zns_pkg�pkg�rr	r
�	<genexpr>s�z-install_lib.get_exclusions.<locals>.<genexpr>)�_get_SVEM_NSPsr�_gen_exclusion_paths�setr�_exclude_pkg_path)rZall_packagesZ
excl_specsr	rr
�get_exclusionss

�zinstall_lib.get_exclusionscCs$|�d�|g}tjj|jf|��S)zw
        Given a package name and exclusion path within that package,
        compute the full exclusion path.
        �.)�split�os�path�joinZinstall_dir)rrZexclusion_path�partsr	r	r
rszinstall_lib._exclude_pkg_pathccs |r|V|�d�\}}}qdS)zn
        >>> list(install_lib._all_packages('foo.bar.baz'))
        ['foo.bar.baz', 'foo.bar', 'foo']
        rN)�
rpartition)Zpkg_name�sepZchildr	r	r
r'szinstall_lib._all_packagescCs,|jjsgS|�d�}|j}|r(|jjSgS)z�
        Get namespace packages (list) but only for
        single_version_externally_managed installations and empty otherwise.
        r)ZdistributionZnamespace_packagesZget_finalized_commandZ!single_version_externally_managed)rZinstall_cmdZsvemr	r	r
r1s

zinstall_lib._get_SVEM_NSPsccsbdVdVdVttd�s dStj�ddtjj�}|dV|d	V|d
V|dVdS)zk
        Generate file paths to be excluded for namespace packages (bytecode
        cache files).
        z__init__.pyz__init__.pycz__init__.pyo�implementationN�__pycache__z	__init__.z.pycz.pyoz
.opt-1.pycz
.opt-2.pyc)�hasattr�sysrrrr�	cache_tag)�baser	r	r
rAs



z install_lib._gen_exclusion_paths�rc	sh|r|r|rt�|����s,tj�|||�Sddlm}ddlm�g����fdd�}||||��S)Nr)�unpack_directory)�logcs<|�kr��d|�dS��d|tj�|����|�|S)Nz/Skipping installation of %s (namespace package)Fzcopying %s -> %s)�warn�inforr�dirname�append)�srcZdst��excluder&rr	r
�pfgs�
z!install_lib.copy_tree.<locals>.pf)	�AssertionErrorr�origr�	copy_treeZsetuptools.archive_utilr%Z	distutilsr&)	rZinfileZoutfileZ
preserve_modeZpreserve_timesZpreserve_symlinks�levelr%r.r	r,r
r1Vs
zinstall_lib.copy_treecs.tj�|�}|����r*�fdd�|D�S|S)Ncsg|]}|�kr|�qSr	r	)r
�f�r-r	r
�
<listcomp>xsz+install_lib.get_outputs.<locals>.<listcomp>)r0r�get_outputsr)rZoutputsr	r4r
r6ts
zinstall_lib.get_outputsN)r$r$rr$)
�__name__�
__module__�__qualname__�__doc__rrr�staticmethodrrrr1r6r	r	r	r
rs
	
�
r)	rr!�	itertoolsrrZdistutils.command.install_libZcommandrr0r	r	r	r
�<module>ssite-packages/setuptools/command/__pycache__/upload.cpython-38.pyc000064400000012123151446177000021253 0ustar00U

�Qab��@s�ddlZddlZddlZddlZddlmZddlmZddlm	Z
ddlmZddl
mZddlmZmZddlmZdd	lmZGd
d�de
j	�Z	dS)�N)�standard_b64encode)�log)�upload)�spawn)�DistutilsError)�urlopen�Request)�	HTTPError)�urlparsec@s8eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
rza
    Override default upload behavior to obtain password
    in a variety of different ways.
    c
Cs&ztj�|�W5|�dtj�XdS)NzjWARNING: Uploading via this command is deprecated, use twine to upload instead (https://pypi.org/p/twine/))�announcerZWARN�origr�run��self�r�=/usr/lib/python3.8/site-packages/setuptools/command/upload.pyr
s�z
upload.runcCs8tj�|�|jpt��|_|jp0|��p0|��|_dS�N)	rr�finalize_options�username�getpassZgetuser�password�_load_password_from_keyring�_prompt_for_passwordrrrrr"s���zupload.finalize_optionsc Cs�t|j�\}}}}}}	|s"|s"|	r0td|j��|dkrDtd|��|jr|ddd|g}
|jrnd|jg|
dd�<t|
|jd	�t|d
��}|��}W5QRX|j	j
}
dd|
��|
��t
j�|�|f||t�|���t|
���|
��|
��|
��|
��|
��|
��|
��|
��|
��|
��|
��|
� �|
�!�d
�}d|d<|j�rdt
j�|�dt|dd
���f|d<|j"d|j#�$d�}dt%|��&d�}d}d|�$d�}|d}t'�(�}|�)�D]�\}}d|}t*|t+��s�|g}|D]j}t,|�t-k�r|d|d7}|d}nt|��$d�}|�.|�|�.|�$d��|�.d�|�.|��qܐq�|�.|�|�/�}d||jf}|�0|t1j2�d|tt3|��|d �}t4|j||d!�}zt5|�}|�6�}|j7}Wnft8k
�r�}z|j9}|j7}W5d}~XYn8t:k
�r"}z|�0t|�t1j;��W5d}~XYnX|d"k�r�|�0d#||ft1j2�|j<�r�t=|d$d%d&��|�}|dk	�r�d'�>d(|d(f�}|�0|t1j2�n"d)||f}|�0|t1j;�t?|��dS)*NzIncompatible url %s)ZhttpZhttpszunsupported schema Zgpgz
--detach-signz-az--local-user�)�dry_run�rbZfile_upload�1)z:actionZprotocol_version�name�version�contentZfiletype�	pyversionZ
md5_digestZmetadata_versionZsummaryZ	home_pageZauthorZauthor_email�license�description�keywords�platformZclassifiersZdownload_urlZprovidesZrequiresZ	obsoletes�Zcommentz.ascZ
gpg_signature�:�asciizBasic z3--------------GHSKFJDLGDS7543FJKLFHRE75642756743254s
--s--
z+
Content-Disposition: form-data; name="%s"z; filename="%s"r�zutf-8s

zSubmitting %s to %sz multipart/form-data; boundary=%s)zContent-typezContent-lengthZ
Authorization)�data�headers��zServer response (%s): %sZ_read_pypi_responsecSsdSrr)�xrrr�<lambda>��z$upload.upload_file.<locals>.<lambda>�
zK---------------------------------------------------------------------------zUpload failed (%s): %s)@r
�
repository�AssertionErrorZsignZidentityrr�open�readZdistributionZmetadataZget_nameZget_version�os�path�basename�hashlibZmd5Z	hexdigest�strZget_metadata_versionZget_descriptionZget_urlZget_contactZget_contact_emailZget_licenceZget_long_descriptionZget_keywordsZ
get_platformsZget_classifiersZget_download_urlZget_providesZget_requiresZ
get_obsoletesrr�encoder�decode�io�BytesIO�items�
isinstance�list�type�tuple�write�getvaluerr�INFO�lenrrZgetcode�msgr	�code�OSErrorZERRORZ
show_response�getattr�joinr) rZcommandr �filenameZschemaZnetlocZurlZparamsZqueryZ	fragmentsZgpg_args�fr�metar)Z	user_passZauth�boundaryZsep_boundaryZend_boundaryZbody�key�value�titlerFr*Zrequest�resultZstatus�reason�e�textrrr�upload_file0s���
�!�




��

���
zupload.upload_filecCs4ztd�}|�|j|j�WStk
r.YnXdS)zM
        Attempt to load password from keyring. Suppress Exceptions.
        �keyringN)�
__import__Zget_passwordr0r�	Exception)rrWrrrr�s
z"upload._load_password_from_keyringc	Cs(z
t��WSttfk
r"YnXdS)zH
        Prompt for a password on the tty. Suppress Exceptions.
        N)rrY�KeyboardInterruptrrrrr�s
zupload._prompt_for_passwordN)	�__name__�
__module__�__qualname__�__doc__r
rrVrrrrrrrs

r)r;r4r7r�base64rZ	distutilsrZdistutils.commandrrZdistutils.spawnrZdistutils.errorsrZ*setuptools.extern.six.moves.urllib.requestrrZ(setuptools.extern.six.moves.urllib.errorr	Z(setuptools.extern.six.moves.urllib.parser
rrrr�<module>ssite-packages/setuptools/command/__pycache__/py36compat.cpython-38.pyc000064400000011002151446177000021767 0ustar00U

�Qabz�@sdddlZddlmZddlmZddlmZddlmZGdd�d�Ze	ejd�r`Gd	d�d�ZdS)
�N)�glob)�convert_path)�sdist)�filterc@s\eZdZdZdd�Zedd��Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dS)�sdist_add_defaultsz�
    Mix-in providing forward-compatibility for functionality as found in
    distutils on Python 3.7.

    Do not edit the code in this class except to update functionality
    as implemented in distutils. Instead, override in the subclass.
    cCs<|��|��|��|��|��|��|��dS)a9Add all the default files to self.filelist:
          - README or README.txt
          - setup.py
          - test/test*.py
          - all pure Python modules mentioned in setup script
          - all files pointed by package_data (build_py)
          - all files defined in data_files.
          - all files defined as scripts.
          - all C sources listed as part of extensions or C libraries
            in the setup script (doesn't catch C headers!)
        Warns if (README or README.txt) or setup.py are missing; everything
        else is optional.
        N)�_add_defaults_standards�_add_defaults_optional�_add_defaults_python�_add_defaults_data_files�_add_defaults_ext�_add_defaults_c_libs�_add_defaults_scripts)�self�r�A/usr/lib/python3.8/site-packages/setuptools/command/py36compat.py�add_defaultsszsdist_add_defaults.add_defaultscCs:tj�|�sdStj�|�}tj�|�\}}|t�|�kS)z�
        Case-sensitive path existence check

        >>> sdist_add_defaults._cs_path_exists(__file__)
        True
        >>> sdist_add_defaults._cs_path_exists(__file__.upper())
        False
        F)�os�path�exists�abspath�split�listdir)�fspathrZ	directory�filenamerrr�_cs_path_exists(s

z"sdist_add_defaults._cs_path_existscCs�|j|jjg}|D]~}t|t�rj|}d}|D]"}|�|�r,d}|j�|�qPq,|s�|�dd�	|��q|�|�r�|j�|�q|�d|�qdS)NFTz,standard file not found: should have one of z, zstandard file '%s' not found)
ZREADMES�distributionZscript_name�
isinstance�tupler�filelist�append�warn�join)rZ	standards�fnZaltsZgot_itrrrr9s"

�
z*sdist_add_defaults._add_defaults_standardscCs4ddg}|D]"}ttjjt|��}|j�|�qdS)Nz
test/test*.pyz	setup.cfg)rrr�isfilerr�extend)rZoptional�pattern�filesrrrrNsz)sdist_add_defaults._add_defaults_optionalcCs\|�d�}|j��r$|j�|���|jD],\}}}}|D]}|j�tj	�
||��q:q*dS)N�build_py)�get_finalized_commandrZhas_pure_modulesrr$�get_source_files�
data_filesrrrr!)rr'ZpkgZsrc_dirZ	build_dir�	filenamesrrrrr	Ts

z'sdist_add_defaults._add_defaults_pythoncCsz|j��rv|jjD]b}t|t�rBt|�}tj�|�rt|j	�
|�q|\}}|D]$}t|�}tj�|�rN|j	�
|�qNqdS)N)rZhas_data_filesr*r�strrrrr#rr)r�item�dirnamer+�frrrr
ds

z+sdist_add_defaults._add_defaults_data_filescCs(|j��r$|�d�}|j�|���dS)N�	build_ext)rZhas_ext_modulesr(rr$r))rr0rrrrus

z$sdist_add_defaults._add_defaults_extcCs(|j��r$|�d�}|j�|���dS)N�
build_clib)rZhas_c_librariesr(rr$r))rr1rrrrzs

z'sdist_add_defaults._add_defaults_c_libscCs(|j��r$|�d�}|j�|���dS)N�
build_scripts)rZhas_scriptsr(rr$r))rr2rrrr
s

z(sdist_add_defaults._add_defaults_scriptsN)�__name__�
__module__�__qualname__�__doc__r�staticmethodrrrr	r
rrr
rrrrr	s
rrc@seZdZdS)rN)r3r4r5rrrrr�s)
rrZdistutils.utilrZdistutils.commandrZsetuptools.extern.six.movesrr�hasattrrrrr�<module>s|site-packages/setuptools/command/__pycache__/build_clib.cpython-38.opt-1.pyc000064400000004605151446177000023024 0ustar00U

�Qab��@sLddlmmZddlmZddlmZddlm	Z	Gdd�dej�ZdS)�N)�DistutilsSetupError)�log)�newer_pairwise_groupc@seZdZdZdd�ZdS)�
build_clibav
    Override the default build_clib behaviour to do the following:

    1. Implement a rudimentary timestamp-based dependency system
       so 'compile()' doesn't run every time.
    2. Add more keys to the 'build_info' dictionary:
        * obj_deps - specify dependencies for each object compiled.
                     this should be a dictionary mapping a key
                     with the source filename to a list of
                     dependencies. Use an empty string for global
                     dependencies.
        * cflags   - specify a list of additional flags to pass to
                     the compiler.
    c	Csr|D�]f\}}|�d�}|dks.t|ttf�s:td|��t|�}t�d|�|�dt��}t|t�srtd|��g}|�dt��}t|ttf�s�td|��|D]P}|g}	|	�|�|�|t��}
t|
ttf�s�td|��|	�|
�|�	|	�q�|j
j||jd�}t
||�ggfk�rT|�d�}|�d	�}
|�d
�}|j
j||j||
||jd�}|j
j|||j|jd�qdS)
N�sourceszfin 'libraries' option (library '%s'), 'sources' must be present and must be a list of source filenameszbuilding '%s' library�obj_depsz\in 'libraries' option (library '%s'), 'obj_deps' must be a dictionary of type 'source: list'�)�
output_dir�macros�include_dirs�cflags)r	r
rZextra_postargs�debug)r	r
)�get�
isinstance�list�tuplerr�info�dict�extend�appendZcompilerZobject_filenamesZ
build_tempr�compiler
Zcreate_static_libr)�selfZ	librariesZlib_nameZ
build_inforrZdependenciesZglobal_deps�sourceZsrc_depsZ
extra_depsZexpected_objectsr
rrZobjects�r�A/usr/lib/python3.8/site-packages/setuptools/command/build_clib.py�build_librariessv
��
����
��
�


��zbuild_clib.build_librariesN)�__name__�
__module__�__qualname__�__doc__rrrrrrsr)
Zdistutils.command.build_clibZcommandrZorigZdistutils.errorsrZ	distutilsrZsetuptools.dep_utilrrrrr�<module>ssite-packages/setuptools/command/__pycache__/easy_install.cpython-38.pyc000064400000177507151446177000022500 0ustar00U

�Qab�U�@s4dZddlmZddlmZddlmZmZddlmZmZm	Z	m
Z
ddlmZm
Z
ddlmZmZddlmZdd	lmZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
l Z dd
l!Z!dd
l"Z"dd
l#Z#dd
l$Z$dd
l%Z%ddl&m'Z'm(Z(ddl)m*Z*dd
l+m,Z,ddl-m.Z.m/Z/ddl)m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:m;Z;m<Z<ddl5m=Z=m>Z>ddl?m@Z@ddlAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPdd
lQZAeRZSejTdeAjUd�ddddddgZVd d!�ZWd"d�ZXe,jY�rBd#d$�ZZd%d&�Z[nd'd$�ZZd(d&�Z[d)d*�Z\Gd+d�de0�Z]d,d-�Z^d.d/�Z_d0d1�Z`d2d�Zad3d�ZbGd4d�deH�ZcGd5d6�d6ec�Zdeje�fd7d8�d9k�r�edZcd:d;�Zgd<d=�Zhd>d?�Zid@dA�ZjdsdBdC�ZkdDdE�ZldFdG�ZmdHejnk�remZondIdJ�ZodtdLdM�ZpdNdO�ZqdPdQ�ZrdRdS�ZszddTlmtZuWnevk
�rndUdV�ZuYnXdWdX�ZtGdYdZ�dZew�Zxex�y�ZzGd[d\�d\ex�Z{Gd]d^�d^�Z|Gd_d`�d`e|�Z}Gdadb�dbe}�Z~e|jZe|j�Z�dcdd�Z�dedf�Z�dgehfdhdi�Z�djdk�Z�dldm�Z�dudnd�Z�e"j�dodp��Z�Gdqdr�dre*�Z�d
S)va%
Easy Install
------------

A tool for doing automatic download/extract/build of distutils-based Python
packages.  For detailed documentation, see the accompanying EasyInstall.txt
file, or visit the `EasyInstall home page`__.

__ https://setuptools.readthedocs.io/en/latest/easy_install.html

�)�glob)�get_platform)�convert_path�
subst_vars)�DistutilsArgError�DistutilsOptionError�DistutilsError�DistutilsPlatformError)�INSTALL_SCHEMES�SCHEME_KEYS)�log�dir_util)�
first_line_re)�find_executableN)�get_config_vars�get_path)�SetuptoolsDeprecationWarning)�six)�configparser�map)�Command)�	run_setup)�rmtree_safe)�setopt)�unpack_archive)�PackageIndex�parse_requirement_arg�
URL_SCHEME)�	bdist_egg�egg_info)�Wheel)�yield_lines�normalize_path�resource_string�ensure_directory�get_distribution�find_distributions�Environment�Requirement�Distribution�PathMetadata�EggMetadata�
WorkingSet�DistributionNotFound�VersionConflict�DEVELOP_DIST�default)�category�samefile�easy_install�PthDistributions�extract_wininst_cfg�main�get_exe_prefixescCst�d�dkS)N�P�)�struct�calcsize�r<r<�C/usr/lib/python3.8/site-packages/setuptools/command/easy_install.py�is_64bitOsr>cCsjtj�|�otj�|�}ttjd�o&|}|r:tj�||�Stj�tj�|��}tj�tj�|��}||kS)z�
    Determine if two paths reference the same file.

    Augments os.path.samefile to work on Windows and
    suppresses errors if the path doesn't exist.
    r2)�os�path�exists�hasattrr2�normpath�normcase)Zp1Zp2Z
both_existZuse_samefileZnorm_p1Znorm_p2r<r<r=r2SscCs|S�Nr<��sr<r<r=�	_to_bytesesrHcCs.zt�|d�WdStk
r(YdSXdS�N�asciiTF)rZ	text_type�UnicodeErrorrFr<r<r=�isasciihs
rLcCs
|�d�S)N�utf8)�encoderFr<r<r=rHpscCs,z|�d�WdStk
r&YdSXdSrI)rNrKrFr<r<r=rLss

cCst�|����dd�S)N�
z; )�textwrap�dedent�strip�replace)�textr<r<r=�<lambda>{�rUc@s�eZdZdZdZdZdddddd	d
ddd
dddddddddddgZdddddddd d!g	Zej	r�d"ej
Ze�d#d$ef�e�d#�d%diZ
eZd&d'�Zd(d)�Zd*d+�Zed,d-��Zd.d/�Zd0d1�Zd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Zd>d?�Ze�d@�� �Z!e�dA�� �Z"e�dB�� �Z#dCdD�Z$dEdF�Z%dGdH�Z&dIdJ�Z'dKdL�Z(dMdN�Z)e*j+dOdP��Z,d�dRdS�Z-d�dTdU�Z.dVdW�Z/d�dXdY�Z0dZd[�Z1d\d]�Z2d^d_�Z3d�d`da�Z4edbdc��Z5d�dfdg�Z6dhdi�Z7djdk�Z8dldm�Z9dndo�Z:dpdq�Z;drds�Z<e�dt�� �Z=e�du�Z>d�dwdx�Z?e�dy�� �Z@dzd{�ZAd|d}�ZBd~d�ZCd�d��ZDd�d��ZEd�d��ZFd�d��ZGd�d��ZHe�d��� �ZId�d��ZJd�d��ZKd�d��ZLeMeMd�d�d��d��ZNeMd�d�d��ZOd�d��ZPd$S)�r3z'Manage a download/build/install processz Find/get/install Python packagesT)zprefix=Nzinstallation prefix)�zip-ok�zzinstall package as a zipfile)�
multi-version�mz%make apps have to require() a version)�upgrade�Uz1force upgrade (searches PyPI for latest versions))zinstall-dir=�dzinstall package to DIR)zscript-dir=rGzinstall scripts to DIR)�exclude-scripts�xzDon't install scripts)�always-copy�az'Copy all needed packages to install dir)z
index-url=�iz base URL of Python Package Index)zfind-links=�fz(additional URL(s) to search for packages)zbuild-directory=�bz/download/extract/build in DIR; keep the results)z	optimize=�Ozlalso compile with optimization: -O1 for "python -O", -O2 for "python -OO", and -O0 to disable [default: -O0])zrecord=Nz3filename in which to record list of installed files)�always-unzip�Zz*don't install as a zipfile, no matter what)z
site-dirs=�Sz)list of directories where .pth files work)�editable�ez+Install specified packages in editable form)�no-deps�Nzdon't install dependencies)zallow-hosts=�Hz$pattern(s) that hostnames must match)�local-snapshots-ok�lz(allow building eggs from local checkouts)�versionNz"print version information and exit)z
no-find-linksNz9Don't load find-links defined in packages being installedrWrYr^r[r`rirkrnrpz!install in user site-package '%s'�userNrfcCs,d|_d|_|_d|_|_|_d|_d|_d|_d|_	d|_
|_d|_|_
|_d|_|_|_d|_|_|_d|_d|_d|_d|_d|_d|_d|_d|_d|_tjr�tj |_!tj"|_#nd|_!d|_#d|_$d|_%d|_&|_'d|_(i|_)d|_*d|_+|j,j-|_-|j,�.||j,�/d��dS)NrFr3)0rq�zip_ok�local_snapshots_ok�install_dir�
script_dir�exclude_scripts�	index_url�
find_links�build_directory�args�optimize�recordr[�always_copy�
multi_versionri�no_deps�allow_hosts�root�prefix�	no_reportrp�install_purelib�install_platlib�install_headers�install_lib�install_scripts�install_data�install_base�install_platbase�site�ENABLE_USER_SITE�	USER_BASE�install_userbase�	USER_SITE�install_usersite�
no_find_links�
package_index�pth_file�always_copy_from�	site_dirs�installed_projects�sitepy_installedZ_dry_run�distribution�verboseZ_set_command_options�get_option_dict��selfr<r<r=�initialize_options�sJ


�zeasy_install.initialize_optionscCs"dd�|D�}tt|j|��dS)Ncss*|]"}tj�|�stj�|�r|VqdSrE)r?r@rA�islink)�.0�filenamer<r<r=�	<genexpr>�s�z/easy_install.delete_blockers.<locals>.<genexpr>)�listr�_delete_path)r��blockersZextant_blockersr<r<r=�delete_blockers�s�zeasy_install.delete_blockerscCsJt�d|�|jrdStj�|�o.tj�|�}|r8tntj}||�dS)NzDeleting %s)	r�info�dry_runr?r@�isdirr��rmtree�unlink)r�r@Zis_treeZremoverr<r<r=r��szeasy_install._delete_pathcCs4djtj�}td�}d}t|jft���t��dS)zT
        Render the Setuptools version and installation details, then exit.
        �{}.{}�
setuptoolsz=setuptools {dist.version} from {dist.location} (Python {ver})N)�format�sys�version_infor%�print�locals�
SystemExit)Zver�dist�tmplr<r<r=�_render_version�s
zeasy_install._render_versionc	Csh|jo|��tj��d}tdd�\}}|j��|j��|j��||dd�|d|d||||t	tdd�d�|_
tjr�|j
|j
d	<|j|j
d
<|��|��|��|�ddd
d�|jdkr�|j|_|jdkr�d|_|�dd�|�dd�|j�r|j�r|j|_|j|_|�dd�tttj�}t�|_|jdk	�r�dd�|j�d�D�}|D]N}t j�!|��s|t"�#d|�n,t|�|k�r�t$|d��n|j�%t|���q\|j&�s�|�'�|j(�p�d|_(|jdd�|_)|jt|j�fD] }||j)k�r�|j)�*d|��q�|j+dk	�r0dd�|j+�d�D�}ndg}|j,dk�rX|j-|j(|j)|d�|_,t.|j)tj�|_/|j0dk	�r�t1|j0t2j3��r�|j0��|_0ng|_0|j4�r�|j,�5|j)tj�|j�s�|j,�6|j0�|�dd�t1|j7t8��s6z0t8|j7�|_7d|j7k�rdk�snt9�Wnt9k
�r4t$d ��YnX|j&�rN|j:�sNt;d!��|j<�s^t;d"��g|_=dS)#Nrr��exec_prefix���abiflags�)Z	dist_nameZdist_versionZ
dist_fullname�
py_versionZpy_version_shortZpy_version_nodotZ
sys_prefixr�Zsys_exec_prefixr�r��userbaseZusersitertruryr�Fr�)rtrtr��rtru�install)r|r|cSsg|]}tj�|����qSr<)r?r@�
expanduserrR�r�rGr<r<r=�
<listcomp>8sz1easy_install.finalize_options.<locals>.<listcomp>�,z"%s (in --site-dirs) does not existz$ (in --site-dirs) is not on sys.pathzhttps://pypi.org/simple/cSsg|]}|���qSr<)rRr�r<r<r=r�Ns�*)Zsearch_path�hosts)r{r{z--optimize must be 0, 1, or 2z9Must specify a build directory (-b) when using --editablez:No urls, filenames, or requirements specified (see --help))>rpr�r��splitrr�Zget_nameZget_versionZget_fullname�getattr�config_varsr�r�r�r��_fix_install_dir_for_user_site�expand_basedirs�expand_dirs�_expandrurtr�Zset_undefined_optionsrqr�r�rr"r@�
get_site_dirs�
all_site_dirsr�r?r�r�warnr�appendri�check_site_dirrw�shadow_path�insertr�r��create_indexr'�local_indexrx�
isinstancerZstring_typesrsZscan_egg_links�add_find_linksr{�int�
ValueErrorryrrz�outputs)	r�r�r�r�rCr�r]Z	path_itemr�r<r<r=�finalize_options�s�

��

��
�����zeasy_install.finalize_optionscCs\|jrtjsdS|��|jdkr.d}t|��|j|_|_tj	�
dd�d}|�|�dS)z;
        Fix the install_dir if "--user" was used.
        Nz$User base directory is not specified�posixZunixZ_user)rqr�r��create_home_pathr�r	r�r�r?�namerS�
select_scheme)r��msgZscheme_namer<r<r=r�ss
z+easy_install._fix_install_dir_for_user_sitecCsX|D]N}t||�}|dk	rtjdks.tjdkr:tj�|�}t||j�}t|||�qdS)Nr��nt)r�r?r�r@r�rr��setattr)r��attrs�attr�valr<r<r=�
_expand_attrs�s
zeasy_install._expand_attrscCs|�dddg�dS)zNCalls `os.path.expanduser` on install_base, install_platbase and
        root.r�r�r�N�r�r�r<r<r=r��szeasy_install.expand_basedirscCsddddddg}|�|�dS)z+Calls `os.path.expanduser` on install dirs.r�r�r�r�r�r�Nr�)r��dirsr<r<r=r��s�zeasy_install.expand_dirsc	Cs�|j|jjkrt�|j�z�|jD]}|�||j�q"|jr�|j}|j	rzt
|j	�}tt
|��D]}|||d�||<q`ddlm
}|�|j|j|fd|j�|��W5t�|jj�XdS)Nr)�	file_utilz'writing list of installed files to '%s')r�r�r�
set_verbosityrzr3rr|r�r��len�range�	distutilsr��executeZ
write_file�warn_deprecated_options)r��specr�Zroot_lenZcounterr�r<r<r=�run�s*

��zeasy_install.runcCsDzt��}Wn"tk
r.t�dtj�}YnXtj�|j	d|�S)z�Return a pseudo-tempname base in the install directory.
        This code is intentionally naive; if a malicious party can write to
        the target directory you're already in deep doodoo.
        rztest-easy-install-%s)
r?�getpid�	Exception�randomZrandintr��maxsizer@�joinrt)r��pidr<r<r=�pseudo_tempname�s
zeasy_install.pseudo_tempnamecCsdSrEr<r�r<r<r=r��sz$easy_install.warn_deprecated_optionsc	CsZt|j�}tj�|d�}tj�|�sTzt�|�Wn ttfk
rR|�	�YnX||j
k}|sr|jsr|��}nd|�
�d}tj�|�}z*|r�t�|�t|d���t�|�Wn ttfk
r�|�	�YnX|s�|js�t|����|�r|jdk�rt||j
�|_nd|_|ttt��k�r.d|_n"|j�rPtj�|��sPd|_d|_||_dS)z;Verify that self.install_dir is .pth-capable dir, if needed�easy-install.pthz.write-test�wNT)r"rtr?r@r�rA�makedirs�OSError�IOError�cant_write_to_targetr�r~�check_pth_processingr�r��open�closer�no_default_version_msgr�r4r�_pythonpathr�)r��instdirr�Zis_site_dirZtestfileZtest_existsr<r<r=r��s>





zeasy_install.check_site_diraS
        can't create or remove files in install directory

        The following error occurred while trying to add or remove files in the
        installation directory:

            %s

        The installation directory you specified (via --install-dir, --prefix, or
        the distutils default setting) was:

            %s
        z�
        This directory does not currently exist.  Please create it and try again, or
        choose a different installation directory (using the -d or --install-dir
        option).
        a�
        Perhaps your account does not have write access to this directory?  If the
        installation directory is a system-owned directory, you may need to sign in
        as the administrator or "root" account.  If you do not have administrative
        access to this machine, you may wish to choose a different installation
        directory, preferably one that is listed in your PYTHONPATH environment
        variable.

        For information on other options, you may wish to consult the
        documentation at:

          https://setuptools.readthedocs.io/en/latest/easy_install.html

        Please make the appropriate changes for your system and try again.
        cCsP|jt��d|jf}tj�|j�s6|d|j7}n|d|j7}t	|��dS)N�rO)
�_easy_install__cant_write_msgr��exc_infortr?r@rA�_easy_install__not_exists_id�_easy_install__access_msgr)r�r�r<r<r=r�s
z!easy_install.cant_write_to_targetc
	Cs�|j}t�d|�|��d}|d}tj�|�}td�d}z8|rNt�|�tj�	|�}t
jj|dd�t
|d�}Wn ttfk
r�|��Yn�Xz�|�|jft���|��d	}tj}tjd
k�rtj�|�\}}	tj�|d�}
|	��dk�otj�|
�}|�r|
}d
dlm}||dddgd
�tj�|��rNt�d|�W�dSW5|�r`|��tj�|��rxt�|�tj�|��r�t�|�X|j�s�t�d|�dS)z@Empirically verify whether .pth files are supported in inst. dirz Checking .pth file support in %s�.pthz.okzz
            import os
            f = open({ok_file!r}, 'w')
            f.write('OK')
            f.close()
            rOT)�exist_okr�Nr��pythonw.exe�
python.exer)�spawnz-Ez-c�passz-TEST PASSED: %s appears to support .pth filesz+TEST FAILED: %s does NOT support .pth filesF)rtrr�r�r?r@rA�
_one_linerr��dirname�
pkg_resourcesZ
py31compatr�rr�r�r�r�writer�r�r��
executabler�r�r��lower�distutils.spawnrr~r�)
r�rr�Zok_fileZ	ok_existsr�rrcr�basenameZaltZuse_altrr<r<r=r�s\�

��
z!easy_install.check_pth_processingc	CsV|jsH|�d�rH|�d�D],}|�d|�r.q|�|||�d|��q|�|�dS)z=Write all the scripts for `dist`, unless scripts are excluded�scriptszscripts/N)rvZmetadata_isdirZmetadata_listdir�install_scriptZget_metadata�install_wrapper_scripts)r�r��script_namer<r<r=�install_egg_scriptsYs�z easy_install.install_egg_scriptscCsTtj�|�rDt�|�D]*\}}}|D]}|j�tj�||��q$qn|j�|�dSrE)r?r@r��walkr�r�r�)r�r@�baser��filesr�r<r<r=�
add_outputgs
zeasy_install.add_outputcCs|jrtd|f��dS)NzjInvalid argument %r: you can't use filenames or URLs with --editable (except via the --find-links option).)rir�r�r�r<r<r=�not_editableos��zeasy_install.not_editablecCs<|js
dStj�tj�|j|j��r8td|j|jf��dS)Nz2%r already exists in %s; can't do a checkout there)rir?r@rAr�ry�keyrr!r<r<r=�check_editablews
��zeasy_install.check_editablec	cs:tjdd�}zt|�VW5tj�|�o2tt|��XdS)Nz
easy_install-)r�)�tempfile�mkdtempr?r@rAr�r�str)r��tmpdirr<r<r=�_tmpdir�szeasy_install._tmpdirFc
CsH|js|��|����&}t|t�s�t|�rb|�|�|j�||�}|�	d|||d�W5QR�St
j�|�r�|�|�|�	d|||d�W5QR�St
|�}|�|�|j�|||j|j|j|j�}|dkr�d|}|jr�|d7}t|��nJ|jtk�r|�|||d�|W5QR�S|�	||j||�W5QR�SW5QRXdS)NTz+Could not find suitable distribution for %rz2 (--always-copy skips system and development eggs)�Using)ri�install_site_pyr)r�r(rr"r��download�install_itemr?r@rArr$Zfetch_distributionr[r}r�rZ
precedencer/�process_distribution�location)r�r��depsr(�dlr�r�r<r<r=r3�s<



�
zeasy_install.easy_installcCs
|p|j}|ptj�|�|k}|p,|�d�}|pT|jdk	oTtj�t|��t|j�k}|r�|s�|j|jD]}|j	|krjq�qjd}t
�dtj�|��|r�|�
|||�}|D]}|�|||�q�n |�|�g}|�||d|d�|dk	�r|D]}||kr�|Sq�dS)N�.eggTz
Processing %srr*)r}r?r@r�endswithr�r"r��project_namer/rr�r�install_eggsr.�egg_distribution)r�r�r,r(r0Zinstall_neededr�Zdistsr<r<r=r-�s2

��

zeasy_install.install_itemcCs<t|}tD]*}d|}t||�dkrt||||�qdS)z=Sets the install directories by applying the install schemes.Zinstall_N)r
rr�r�)r�r��schemer#�attrnamer<r<r=r��s
zeasy_install.select_schemec
Gs�|�|�|j�|�||j|jkr2|j�|�|j�|�|�|�||j|j<t�	|j
||f|���|�d�r�|js�|j�
|�d��|s�|js�dS|dk	r�|j|jkr�t�d|�dS|dks�||kr�|��}tt|��}t�	d|�ztg��|g|j|j�}Wn^tk
�r<}ztt|���W5d}~XYn0tk
�rj}zt|����W5d}~XYnX|j�s||j�r�|D]"}|j|jk�r�|�|����q�t�	d|�dS)Nzdependency_links.txtzSkipping dependencies for %szProcessing dependencies for %sz'Finished processing dependencies for %s)�
update_pthr��addr�r#�removerr�rr��installation_report�has_metadatar�r�Zget_metadata_linesr}r��as_requirementr(r'r,Zresolver3r-rr.Zreportr�)r�Zrequirementr�r0r�ZdistreqZdistrosrjr<r<r=r.�sL


��
�z!easy_install.process_distributioncCs2|jdk	r|jS|�d�r dS|�d�s.dSdS)Nznot-zip-safeTzzip-safeF)rrr=�r�r�r<r<r=�should_unzips


zeasy_install.should_unzipcCs�tj�|j|j�}tj�|�r:d}t�||j|j|�|Stj�|�rL|}nRtj�	|�|krft�
|�t�|�}t|�dkr�tj�||d�}tj�|�r�|}t
|�t�||�|S)Nz<%r already exists in %s; build directory %s will not be keptrr)r?r@r�ryr#rArr�r�rr��listdirr�r$�shutil�move)r�r��
dist_filename�
setup_base�dstr��contentsr<r<r=�
maybe_moves$�

zeasy_install.maybe_movecCs,|jr
dSt���|�D]}|j|�qdSrE)rv�ScriptWriter�best�get_args�write_script)r�r�rzr<r<r=r"sz$easy_install.install_wrapper_scriptscCsNt|���}t||�}|r8|�|�t�}t�|�|}|�|t|�d�dS)z/Generate a legacy script wrapper and install itrdN)	r'r>�is_python_script�_load_templater�rI�
get_headerrLrH)r�r�r�script_text�dev_pathr�Z	is_scriptZbodyr<r<r=r(s
zeasy_install.install_scriptcCs(d}|r|�dd�}td|�}|�d�S)z�
        There are a couple of template scripts in the package. This
        function loads one of them and prepares it for use.
        zscript.tmplz.tmplz (dev).tmplr��utf-8)rSr#�decode)rQr�Z	raw_bytesr<r<r=rN2s

zeasy_install._load_template�tr<c	s����fdd�|D��t�d|�j�tj��j|�}��|��jrLdSt	�}t
|�tj�|�rpt�|�t
|d|��}|�|�W5QRXt|d|�dS)z1Write an executable file to the scripts directorycsg|]}tj��j|��qSr<)r?r@r�ru�r�r_r�r<r=r�Dsz-easy_install.write_script.<locals>.<listcomp>zInstalling %s script to %sNr�i�)r�rr�rur?r@r�r r��
current_umaskr$rAr�rr�chmod)r�rrG�moder��target�maskrcr<r�r=rLAs�

zeasy_install.write_scriptcCs^|���d�r|�||�gS|���d�r8|�||�gS|���d�rT|�||�gS|}tj�|�r~|�d�s~t|||j	�ntj�
|�r�tj�|�}|�|�r�|j
r�|dk	r�|�|||�}tj�|d�}tj�|��s0ttj�|dd��}|�stdtj�|���t|�dk�r(td	tj�|���|d
}|j�rNt�|�||��gS|�||�SdS)Nr2�.exez.whl�.pyzsetup.pyr�z"Couldn't find a setup script in %srzMultiple setup scripts in %sr)rr3�install_egg�install_exe�
install_wheelr?r@�isfiler�unpack_progressr��abspath�
startswithryrHr�rArrr�rirr��report_editable�build_and_install)r�r�rDr(rE�setup_scriptZsetupsr<r<r=r5UsJ
��
��
��zeasy_install.install_eggscCs>tj�|�r"t|tj�|d��}ntt�|��}tj	||d�S)N�EGG-INFO)�metadata)
r?r@r�r*r�r+�	zipimport�zipimporterr)Z
from_filename)r��egg_pathrhr<r<r=r6�s�zeasy_install.egg_distributionc	Cs�tj�|jtj�|��}tj�|�}|js2t|�|�|�}t	||��sztj�
|�rrtj�|�srtj
||jd�n"tj�|�r�|�tj|fd|�z�d}tj�
|�r�|�|�r�tjd}}ntjd}}nL|�|�r�|�|�|jd}}n*d}|�|��rtjd}}ntjd}}|�|||f|dtj�|�tj�|�f�t||d	�Wn$tk
�rxt|dd	��YnX|�|�|�|�S)
N�r��	Removing FZMovingZCopyingZ
ExtractingTz	 %s to %s��fix_zipimporter_caches)r?r@r�rtrrbr�r$r6r2r�r�r
�remove_treerAr�r�rcrBrCZcopytreer@Zmkpath�unpack_and_compileZcopy2r�update_dist_cachesr�r )r�rkr(�destinationr�Znew_dist_is_zippedrcrZr<r<r=r]�s^
�
�




���

zeasy_install.install_eggcsPt|�}|dkrtd|��td|�dd�|�dd�t�d�}tj�||��d�}||_	|d}tj�|d�}tj�|d	�}t
|�t||�|_|�
||�tj�|��st|d
�}	|	�d�|�d�D].\}
}|
dkr�|	�d
|
�dd���|f�q�|	��tj�|d��|��fdd�t�|�D��tj|||j|jd�|�||�S)Nz(%s is not a valid distutils Windows .exerhr�rp)r4rp�platformr2z.tmprg�PKG-INFOr�zMetadata-Version: 1.0
�target_versionz%s: %s
�_�-rcsg|]}tj��|d��qS)r)r?r@r�)r�rz�rur<r=r��s�z,easy_install.install_exe.<locals>.<listcomp>)r�r�)r5rr)�getrr?r@r��egg_namer/r$r*Z	_provider�
exe_to_eggrArr�itemsrS�titlerr�rIrKrZmake_zipfiler�r�r])r�rDr(�cfgr�rk�egg_tmpZ	_egg_infoZpkg_infrc�k�vr<ryr=r^�sJ�

�

 ��zeasy_install.install_execs6t|��g�g�i������fdd�}t|�|�g}�D]l}|���d�r<|�d�}|d}t�|d�d|d<tjj	�f|��}��
|�|�
|�t�||�q<|���t�
tj�	�d�t��|��dD]Z}	t�|	r�tj�	�d|	d	�}
tj�|
�s�t|
d
�}|�d�	t�|	�d�|��q�dS)
z;Extract a bdist_wininst to the directories an egg would usecs�|��}�D]�\}}|�|�r||t|�d�}|�d�}tjj�f|��}|��}|�d�sj|�d�r�t�	|d�|d<d�tj�
|d�d<��|�n4|�d�r�|dkr�d�tj�
|d�d<��|�|Sq|�d	�s�t�
d
|�dS)N�/�.pyd�.dll���rrr\�SCRIPTS/r
zWARNING: can't process %s)rrcr�r�r?r@r�r3r�strip_module�splitextr�rr�)�srcrFrG�old�new�partsr1�r��native_libs�prefixes�
to_compile�	top_levelr<r=�process�s$




z(easy_install.exe_to_egg.<locals>.processr�r�r�r\rg)r�r�z.txtr�rON)r7rrr3r�rr�r?r@r�r�Z
write_stub�byte_compileZwrite_safety_flagZanalyze_eggr�rArrr)r�rDr�r�Zstubs�resr��resourceZpyfiler�Ztxtrcr<r�r=r|�s8




�

zeasy_install.exe_to_eggc
Cs�t|�}|��st�tj�|j|���}tj�|�}|j	sBt
|�tj�|�rltj�|�slt
j||j	d�n"tj�|�r�|�tj|fd|�z.|�|j|fdtj�|�tj�|�f�W5t|dd�X|�|�|�|�S)NrlrmFrnzInstalling %s to %s)r Z
is_compatible�AssertionErrorr?r@r�rtr{rbr�r$r�r�r
rprAr�r�rrZinstall_as_eggrrr r6)r�Z
wheel_pathr(Zwheelrsr<r<r=r_!s4�

��	
zeasy_install.install_wheela(
        Because this distribution was installed --multi-version, before you can
        import modules from this package in an application, you will need to
        'import pkg_resources' and then use a 'require()' call similar to one of
        these examples, in order to select the desired version:

            pkg_resources.require("%(name)s")  # latest installed version
            pkg_resources.require("%(name)s==%(version)s")  # this exact version
            pkg_resources.require("%(name)s>=%(version)s")  # this version or higher
        z�
        Note also that the installation directory must be on sys.path at runtime for
        this to work.  (e.g. by being the application's script directory, by being on
        PYTHONPATH, or by being added to sys.path by your code.)
        �	Installedc	Cs^d}|jr>|js>|d|j7}|jtttj�kr>|d|j7}|j	}|j
}|j}d}|t�S)z9Helpful installation message for display to package usersz
%(what)s %(eggloc)s%(extras)srOr�)
r~r��_easy_install__mv_warningrtrr"r�r@�_easy_install__id_warningr/r4rpr�)	r�Zreqr�Zwhatr�Zegglocr�rpZextrasr<r<r=r<Osz easy_install.installation_reportaR
        Extracted editable version of %(spec)s to %(dirname)s

        If it uses setuptools in its setup script, you can activate it in
        "development" mode by going to that directory and running::

            %(python)s setup.py develop

        See the setuptools documentation for the "develop" command for more info.
        cCs"tj�|�}tj}d|jt�S)NrO)r?r@rr�r�_easy_install__editable_msgr�)r�r�rfr�pythonr<r<r=rdhszeasy_install.report_editablec
Cs�tj�dt�tj�dt�t|�}|jdkrNd|jd}|�dd|�n|jdkrd|�dd�|jrv|�dd	�t	�
d
|t|�dd�d�|��zt
||�Wn6tk
r�}ztd|jdf��W5d}~XYnXdS)
Nzdistutils.command.bdist_eggzdistutils.command.egg_infor�r�rrrx�-qz-nz
Running %s %s� zSetup script exited with %s)r��modules�
setdefaultrrr�r�r�r�rr�r�r�rr�rrz)r�rfrErzr�r<r<r=rms&

�zeasy_install.run_setupc		Cs�ddg}tjdtj�|�d�}z�|�	tj�|��|�
|�|�|||�t|g�}g}|D]&}||D]}|�
|�
|j|��qhq\|s�|js�t�d|�|W�St|�t�|j�XdS)Nrz
--dist-dirz
egg-dist-tmp-)r��dirz+No eggs found in %s (setup script problem?))r%r&r?r@rr�rr�r��_set_fetcher_optionsr�rr'r]r/r�r�)	r�rfrErzZdist_dirZall_eggsZeggsr#r�r<r<r=re�s*
�


�zeasy_install.build_and_installc	Csp|j�d���}d}i}|��D]&\}}||kr2q |d||�dd�<q t|d�}tj�|d�}t	�
||�dS)	a
        When easy_install is about to run bdist_egg on a source dist, that
        source dist might have 'setup_requires' directives, requiring
        additional fetching. Ensure the fetcher options given to easy_install
        are available to that command as well.
        r3)rxr�rwr{r�rrwrx)r3z	setup.cfgN)r�r��copyr}rS�dictr?r@r�rZedit_config)	r�rZei_optsZfetch_directivesZ
fetch_optionsr#r�ZsettingsZcfg_filenamer<r<r=r��s	
z!easy_install._set_fetcher_optionscCs*|jdkrdS|j|jD]H}|js0|j|jkrt�d|�|j�|�|j|jkr|j�|j�q|js�|j|jjkr�t�d|�n2t�d|�|j�	|�|j|jkr�|j�
|j�|j�s&|j��|jdk�r&t
j�|jd�}t
j�|�r�t
�|�t|d�}|�|j�|j�d�|��dS)Nz&Removing %s from easy-install.pth filez4%s is already the active version in easy-install.pthz"Adding %s to easy-install.pth filer��setuptools.pth�wtrO)r�r#r~r/rr�r;r��pathsr:r�r��saver?r@r�rtr�r�rr�
make_relativer)r�r�r]r�rcr<r<r=r9�s6
�


zeasy_install.update_pthcCst�d||�|S)NzUnpacking %s to %s)r�debug)r�r�rFr<r<r=ra�szeasy_install.unpack_progresscsdg�g����fdd�}t|||������js`�D]&}t�|�tjdBd@}t||�q8dS)NcsZ|�d�r |�d�s ��|�n|�d�s4|�d�r>��|���||��jrV|pXdS)Nr\�	EGG-INFO/r�z.so)r3rcr�rar�)r�rF�r�Zto_chmodr�r<r=�pf�s
z+easy_install.unpack_and_compile.<locals>.pfimi�)rr�r�r?�stat�ST_MODErW)r�rkrsr�rcrXr<r�r=rq�s
zeasy_install.unpack_and_compilec	Csjtjr
dSddlm}z@t�|jd�||dd|jd�|jrT|||jd|jd�W5t�|j�XdS)Nr)r�r)r{�forcer�)	r��dont_write_bytecode�distutils.utilr�rr�r�r�r{)r�r�r�r<r<r=r��s�
zeasy_install.byte_compilea�
        bad install directory or PYTHONPATH

        You are attempting to install a package to a directory that is not
        on PYTHONPATH and which Python does not read ".pth" files from.  The
        installation directory you specified (via --install-dir, --prefix, or
        the distutils default setting) was:

            %s

        and your PYTHONPATH environment variable currently contains:

            %r

        Here are some of your options for correcting the problem:

        * You can choose a different installation directory, i.e., one that is
          on PYTHONPATH or supports .pth files

        * You can add the installation directory to the PYTHONPATH environment
          variable.  (It must then also be on PYTHONPATH whenever you run
          Python and want to use the package(s) you are installing.)

        * You can set up the installation directory to support ".pth" files by
          using one of the approaches described here:

          https://setuptools.readthedocs.io/en/latest/easy_install.html#custom-installation-locations


        Please make the appropriate changes for your system and try again.cCs|j}||jtj�dd�fS�NZ
PYTHONPATHr�)�_easy_install__no_default_msgrtr?�environrz)r��templater<r<r=rsz#easy_install.no_default_version_msgc	Cs�|jr
dStj�|jd�}tdd�}|�d�}d}tj�|�r�t�	d|j�t
�|��}|��}W5QRX|�
d�s�td	|��||kr�t�d
|�|js�t|�t
j|ddd��}|�|�W5QRX|�|g�d
|_dS)z8Make sure there's a site.py in the target dir, if neededNzsite.pyr�z
site-patch.pyrRr�zChecking existing site.py in %sz
def __boot():z;%s is not a setuptools-generated site.py; please remove it.zCreating %sr���encodingT)r�r?r@r�rtr#rSrArr��ior�readrcrr�r�r$rr�)r�Zsitepy�sourceZcurrentZstrmr<r<r=r+#s0


��zeasy_install.install_site_pycCsd|js
dSttj�d��}t�|j�D]8\}}|�|�r&tj�	|�s&|�
d|�t�|d�q&dS)zCreate directories under ~.N�~zos.makedirs('%s', 0o700)i�)rqrr?r@r�rZ	iteritemsr�rcr�Zdebug_printr�)r��homer�r@r<r<r=r�Cszeasy_install.create_home_pathz/$base/lib/python$py_version_short/site-packagesz	$base/binr��r�z$base/Lib/site-packagesz
$base/ScriptscGs�|�d�j}|jrd|��}|j|d<|j�tj|j�}|�	�D]$\}}t
||d�dkr>t|||�q>ddlm
}|D]B}t
||�}|dk	rt|||�}tjdkr�tj�|�}t|||�qtdS)Nr�rr)rr�)Zget_finalized_commandr�r�r�r
rzr?r��DEFAULT_SCHEMEr}r�r�r�rr@r�)r�r�r�r7r�r�rr<r<r=r�Ys 



zeasy_install._expand)F)F)T)N)rTr<)r�)Q�__name__�
__module__�__qualname__�__doc__�descriptionZcommand_consumes_argumentsZuser_optionsZboolean_optionsr�r�r�Zhelp_msgr�Znegative_optrr�r�r�r��staticmethodr�r�r�r�r�r�r�r�r�r�rPrQ�lstriprrr	r�r�rr r"r$�
contextlib�contextmanagerr)r3r-r�r.r@rHrrrNrLr5r6r]r^r|r_r�r�r<r�rdrrer�r9rarqr�r�rr+r�r�r
r�r�r<r<r<r=r3~s���

0	

z	0	;


$
$	
'	



,6-5

% 
���cCs tj�dd��tj�}td|�Sr�)r?r�rzr��pathsep�filter)r}r<r<r=rpsrc	Cs~g}|�t��tjg}tjtjkr0|�tj�|D]�}|r4tjdkr^|�tj�	|dd��nVtj
dkr�|�tj�	|ddjtj�d�tj�	|dd�g�n|�|tj�	|dd�g�tjdkr4d	|kr4tj
�d
�}|r4tj�	|ddd
jtj�d�}|�|�q4td�td�f}|D]}||k�r|�|��qtj�rB|�tj�z|�t���Wntk
�rjYnXttt|��}|S)z&
    Return a list of 'site' dirs
    )Zos2emxZriscosZLibz
site-packagesr��libzpython{}.{}zsite-python�darwinzPython.framework�HOME�Library�Pythonr�ZpurelibZplatlib)�extendrr�r�r�r�rtr?r@r��sepr�r�r�rzrr�r�r��getsitepackages�AttributeErrorr�rr")�sitedirsr�r�r�Zhome_spZ	lib_pathsZsite_libr<r<r=r�us^


��
�

�
r�ccs�i}|D]�}t|�}||krqd||<tj�|�s4qt�|�}||fV|D]�}|�d�s\qL|dkrfqLttj�||��}tt	|��}|�
�|D]H}|�d�s�t|���}||kr�d||<tj�|�s�q�|t�|�fVq�qLqdS)zBYield sys.path directories that might contain "old-style" packagesrr
)r�r��importN)
r"r?r@r�rAr3rr�r�r!rrc�rstrip)Zinputs�seenrrr�rc�lines�liner<r<r=�expand_paths�s4



r�cCs@t|d�}�z$t�|�}|dkr*W��dS|d|d|d}|dkrRW��dS|�|d�t�d|�d��\}}}|dkr�W��dS|�|d|�d	d	d
�}t�	|�}z<|�|�}	|	�
dd�d
}
|
�t�
��}
|�t�|
��Wntjk
�rYW�.dSX|�d��r"|�d��s*W�dS|W�S|��XdS)znExtract configuration data from a bdist_wininst .exe

    Returns a configparser.RawConfigParser, or None
    �rbN�	���z<iii)izV4i{V4r�)rprv�rrrhZSetup)rr�zipfileZ_EndRecData�seekr:�unpackr�rZRawConfigParserr�rSr��getfilesystemencodingZreadfpr�StringIO�ErrorZhas_section)rDrcZendrecZ	prepended�tagZcfglenZbmlenZinitr�partZconfigr<r<r=r5�s4





c	Cs@dddddg}t�|�}z�|��D]�}|j}|�d�}t|�dkr�|dd	kr�|d
�d�r�|�dd�	|d
d��df��qt|�dks"|�d�s�q"|�d�r�q"|d�
�dkr"|�|�}tj
r�|��}t|�D]8}|���dd�}|�d�s�|�d|d|fdf�q�q"W5|��Xdd�|D�}|��|��|S)z4Get exe->egg path translations for a given .exe file)zPURELIB/r�)zPLATLIB/pywin32_system32r�)zPLATLIB/r�)r�zEGG-INFO/scripts/)zDATA/lib/site-packagesr�r�r�r�rurz	.egg-inforNr�r
z
-nspkg.pth)ZPURELIBZPLATLIB�\r�z%s/%s/r�cSsg|]\}}|��|f�qSr<)r)r�r_�yr<r<r=r�)sz$get_exe_prefixes.<locals>.<listcomp>)r�ZZipFilerZinfolistr�r�r�r3r�r��upperr�rZPY3rSr!rRrSrcr��sort�reverse)Zexe_filenamer�rXr�r�r�rGZpthr<r<r=r7s@�




"
c@sReZdZdZdZddd�Zdd�Zdd	�Zed
d��Z	dd
�Z
dd�Zdd�ZdS)r4z)A .pth file with Distribution paths in itFr<cCsl||_ttt|��|_ttj�|j��|_|�	�t
�|gdd�t|j
�D]}tt|jt|d���qLdS)NT)r�r�rr"r�r?r@r�basedir�_loadr'�__init__r!r�r:r&)r�r�r�r@r<r<r=r�4szPthDistributions.__init__cCs�g|_d}t�|j�}tj�|j�r�t|jd�}|D]�}|�	d�rHd}q4|�
�}|j�|�|��r4|���	d�rtq4t
tj�|j|��}|jd<tj�|�r�||kr�|j��d|_q4d||<q4|��|jr�|s�d|_|jr�|jd��s�|j��q�dS)NFZrtr�T�#r�r)r�r��fromkeysr�r?r@r`r�rrcr�r�rRr"r�r�rA�pop�dirtyr)r�Z
saw_importr�rcr�r@r<r<r=r�=s4
�


zPthDistributions._loadc	Cs�|js
dStt|j|j��}|r�t�d|j�|�|�}d�	|�d}t
j�|j�r`t
�
|j�t|jd��}|�|�W5QRXn(t
j�|j�r�t�d|j�t
�
|j�d|_dS)z$Write changed .pth file back to diskNz	Saving %srOr�zDeleting empty %sF)r�r�rr�r�rr�r��_wrap_linesr�r?r@r�r�rrrA)r�Z	rel_pathsr��datarcr<r<r=r�\s
zPthDistributions.savecCs|SrEr<)r�r<r<r=r�rszPthDistributions._wrap_linescCsN|j|jko$|j|jkp$|jt��k}|r>|j�|j�d|_t�||�dS)z"Add `dist` to the distribution mapTN)	r/r�r�r?�getcwdr�r�r'r:)r�r��new_pathr<r<r=r:vs�zPthDistributions.addcCs2|j|jkr"|j�|j�d|_qt�||�dS)z'Remove `dist` from the distribution mapTN)r/r�r;r�r'r?r<r<r=r;�szPthDistributions.removecCs�tj�t|��\}}t|j�}|g}tjdkr2dp6tj}t|�|kr�||jkrl|�tj	�|�
�|�|�Stj�|�\}}|�|�q8|S)Nr�)r?r@r�r"r�r��altsepr�r��curdirr�r�)r�r@ZnpathZlastZbaselenr�r�r<r<r=r��s


zPthDistributions.make_relativeN)r<)
r�r�r�r�r�r�r�r�r�r�r:r;r�r<r<r<r=r4/s
	
c@s(eZdZedd��Zed�Zed�ZdS)�RewritePthDistributionsccs$|jV|D]
}|Vq|jVdSrE)�prelude�postlude)�clsr�r�r<r<r=r��sz#RewritePthDistributions._wrap_linesz?
        import sys
        sys.__plen = len(sys.path)
        z�
        import sys
        new = sys.path[sys.__plen:]
        del sys.path[sys.__plen:]
        p = getattr(sys, '__egginsert', 0)
        sys.path[p:p] = new
        sys.__egginsert = p + len(new)
        N)r�r�r��classmethodr�rr�r�r<r<r<r=r��s
r�ZSETUPTOOLS_SYS_PATH_TECHNIQUE�rawZrewritecCs ttjt�rtSt�tj���S)z_
    Return a regular expression based on first_line_re suitable for matching
    strings.
    )r�r�patternr'�re�compilerSr<r<r<r=�_first_line_re�srcCsd|tjtjfkr.tjdkr.t|tj�||�St��\}}}t	�
||d|dd||ff�dS)Nr�rrz %s %s)r?r�r;r�rWr��S_IWRITEr�rrZreraise)�func�arg�excZetZevrwr<r<r=�
auto_chmod�s
r	cCs.t|�}t|tj�|r"t|�nt|�dS)aa

    Fix any globally cached `dist_path` related data

    `dist_path` should be a path of a newly installed egg distribution (zipped
    or unzipped).

    sys.path_importer_cache contains finder objects that have been cached when
    importing data from the original distribution. Any such finders need to be
    cleared since the replacement distribution might be packaged differently,
    e.g. a zipped egg distribution might get replaced with an unzipped egg
    folder or vice versa. Having the old finders cached may then cause Python
    to attempt loading modules from the replacement distribution using an
    incorrect loader.

    zipimport.zipimporter objects are Python loaders charged with importing
    data packaged inside zip archives. If stale loaders referencing the
    original distribution, are left behind, they can fail to load modules from
    the replacement distribution. E.g. if an old zipimport.zipimporter instance
    is used to load data from a new zipped egg archive, it may cause the
    operation to attempt to locate the requested data in the wrong location -
    one indicated by the original distribution's zip archive directory
    information. Such an operation may then fail outright, e.g. report having
    read a 'bad local file header', or even worse, it may fail silently &
    return invalid data.

    zipimport._zip_directory_cache contains cached zip archive directory
    information for all existing zipimport.zipimporter instances and all such
    instances connected to the same archive share the same cached directory
    information.

    If asked, and the underlying Python implementation allows it, we can fix
    all existing zipimport.zipimporter instances instead of having to track
    them down and remove them one by one, by updating their shared cached zip
    archive directory information. This, of course, assumes that the
    replacement distribution is packaged as a zipped egg.

    If not asked to fix existing zipimport.zipimporter instances, we still do
    our best to clear any remaining zipimport.zipimporter related cached data
    that might somehow later get used when attempting to load data from the new
    distribution and thus cause such load operations to fail. Note that when
    tracking down such remaining stale data, we can not catch every conceivable
    usage from here, and we clear only those that we know of and have found to
    cause problems if left alive. Any remaining caches should be updated by
    whomever is in charge of maintaining them, i.e. they should be ready to
    handle us replacing their zip archives with new distributions at runtime.

    N)r"�_uncacher��path_importer_cache�!_replace_zip_directory_cache_data�*_remove_and_clear_zip_directory_cache_data)Z	dist_pathro�normalized_pathr<r<r=rr�s
<
rrcCsPg}t|�}|D]:}t|�}|�|�r|||d�tjdfkr|�|�q|S)ap
    Return zipimporter cache entry keys related to a given normalized path.

    Alternative path spellings (e.g. those using different character case or
    those using alternative path separators) related to the same path are
    included. Any sub-path entries are included as well, i.e. those
    corresponding to zip archives embedded in other zip archives.

    rr�)r�r"rcr?r�r�)r�cache�result�
prefix_len�pZnpr<r<r=�"_collect_zipimporter_cache_entriess

�rcCs@t||�D]0}||}||=|o(|||�}|dk	r
|||<q
dS)a�
    Update zipimporter cache data for a given normalized path.

    Any sub-path entries are processed as well, i.e. those corresponding to zip
    archives embedded in other zip archives.

    Given updater is a callable taking a cache entry key and the original entry
    (after already removing the entry from the cache), and expected to update
    the entry and possibly return a new one to be inserted in its place.
    Returning None indicates that the entry should not be replaced with a new
    one. If no updater is given, the cache entries are simply removed without
    any additional processing, the same as if the updater simply returned None.

    N)r)rr�updaterr�	old_entryZ	new_entryr<r<r=�_update_zipimporter_cache/s
rcCst||�dSrE)r)rrr<r<r=r
Osr
cCsdd�}t|tj|d�dS)NcSs|��dSrE)�clear�r@rr<r<r=�2clear_and_remove_cached_zip_archive_directory_dataTszf_remove_and_clear_zip_directory_cache_data.<locals>.clear_and_remove_cached_zip_archive_directory_data�r�rri�_zip_directory_cache)rrr<r<r=r
Ss�r
Z__pypy__cCsdd�}t|tj|d�dS)NcSs&|��t�|�|�tj|�|SrE)rrirj�updaterrr<r<r=�)replace_cached_zip_archive_directory_datajs
zT_replace_zip_directory_cache_data.<locals>.replace_cached_zip_archive_directory_datarr)rrr<r<r=ris
�r�<string>c	Cs4zt||d�Wnttfk
r*YdSXdSdS)z%Is this string a valid Python script?�execFTN)r�SyntaxError�	TypeError)rTr�r<r<r=�	is_python|s
r#c	CsNz(tj|dd��}|�d�}W5QRXWnttfk
rD|YSX|dkS)zCDetermine if the specified executable is a .sh (contains a #! line)zlatin-1r�r��#!)r�rr�r�r�)r�fp�magicr<r<r=�is_sh�s
r'cCst�|g�S)z@Quote a command line argument according to Windows parsing rules��
subprocess�list2cmdline)rr<r<r=�nt_quote_arg�sr+cCsH|�d�s|�d�rdSt||�r&dS|�d�rDd|��d��kSdS)zMIs this text, as a whole, a Python script? (as opposed to shell/bat/etc.
    r\�.pywTr$r�rF)r3r#rc�
splitlinesr)rPr�r<r<r=rM�s

rM)rWcGsdSrEr<)rzr<r<r=�_chmod�sr.c
CsRt�d||�zt||�Wn0tjk
rL}zt�d|�W5d}~XYnXdS)Nzchanging mode of %s to %ozchmod failed: %s)rr�r.r?�error)r@rXrjr<r<r=rW�s
rWc@s�eZdZdZgZe�Zedd��Zedd��Z	edd��Z
edd	��Zed
d��Zdd
�Z
edd��Zdd�Zedd��Zedd��ZdS)�CommandSpeczm
    A command spec for a #! header, specified as a list of arguments akin to
    those passed to Popen.
    cCs|S)zV
        Choose the best CommandSpec class based on environmental conditions.
        r<�r�r<r<r=rJ�szCommandSpec.bestcCstj�tj�}tj�d|�S)N�__PYVENV_LAUNCHER__)r?r@rCr�rr�rz)r�Z_defaultr<r<r=�_sys_executable�szCommandSpec._sys_executablecCs:t||�r|St|t�r ||�S|dkr0|��S|�|�S)zg
        Construct a CommandSpec from a parameter to build_scripts, which may
        be None.
        N)r�r��from_environment�from_string)r�Zparamr<r<r=�
from_param�s

zCommandSpec.from_paramcCs||��g�SrE)r3r1r<r<r=r4�szCommandSpec.from_environmentcCstj|f|j�}||�S)z}
        Construct a command spec from a simple string representing a command
        line parseable by shlex.split.
        )�shlexr��
split_args)r��stringr}r<r<r=r5�szCommandSpec.from_stringcCs8t�|�|��|_t�|�}t|�s4dg|jdd�<dS)Nz-xr)r7r��_extract_options�optionsr)r*rL)r�rP�cmdliner<r<r=�install_options�s
zCommandSpec.install_optionscCs:|d��d}t��|�}|r.|�d�p0dnd}|��S)zH
        Extract any options from the first line of the script.
        rOrrr�)r-r�match�grouprR)Zorig_script�firstr>r;r<r<r=r:�szCommandSpec._extract_optionscCs|�|t|j��SrE)�_renderr�r;r�r<r<r=�	as_header�szCommandSpec.as_headercCs6d}|D](}|�|�r|�|�r|dd�Sq|S)Nz"'rr�)rcr3)�itemZ_QUOTES�qr<r<r=�
_strip_quotes�s
zCommandSpec._strip_quotescCs t�dd�|D��}d|dS)Ncss|]}t�|���VqdSrE)r0rErR)r�rCr<r<r=r�sz&CommandSpec._render.<locals>.<genexpr>r$rOr()r}r<r<r<r=rA�s
�zCommandSpec._renderN)r�r�r�r�r;r�r8r�rJr3r6r4r5r=r�r:rBrErAr<r<r<r=r0�s*





	
r0c@seZdZedd�ZdS)�WindowsCommandSpecFr�N)r�r�r�r�r8r<r<r<r=rF
srFc@s�eZdZdZe�d���ZeZ	e
ddd��Ze
ddd��Ze
dd	d
��Z
edd��Ze
d
d��Ze
dd��Ze
dd��Ze
ddd��ZdS)rIz`
    Encapsulates behavior around writing entry point scripts for console and
    gui apps.
    a�
        # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r
        __requires__ = %(spec)r
        import re
        import sys
        from pkg_resources import load_entry_point

        if __name__ == '__main__':
            sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0])
            sys.exit(
                load_entry_point(%(spec)r, %(group)r, %(name)r)()
            )
    NFcCs6t�dt�|rtnt��}|�d||�}|�||�S)NzUse get_argsr�)�warningsr��EasyInstallDeprecationWarning�WindowsScriptWriterrIrJ�get_script_headerrK)r�r�r�wininst�writer�headerr<r<r=�get_script_args$szScriptWriter.get_script_argscCs$tjdtdd�|rd}|�||�S)NzUse get_headerr�)�
stacklevelr
)rGr�rHrO)r�rPrrKr<r<r=rJ,szScriptWriter.get_script_headerccs�|dkr|��}t|���}dD]Z}|d}|�|���D]>\}}|�|�|jt�}|�||||�}	|	D]
}
|
Vqlq:q dS)z�
        Yield write_script() argument tuples for a distribution's
        console_scripts and gui_scripts entry points.
        N�Zconsole�guiZ_scripts)	rOr'r>Z
get_entry_mapr}�_ensure_safe_namer�r��_get_script_args)r�r�rMr��type_r?r�ZeprPrzr�r<r<r=rK4s
zScriptWriter.get_argscCst�d|�}|rtd��dS)z?
        Prevent paths in *_scripts entry point names.
        z[\\/]z+Path separators not allowed in script namesN)r�searchr�)r�Zhas_path_sepr<r<r=rRFszScriptWriter._ensure_safe_namecCs t�dt�|rt��S|��S�NzUse best)rGr�rHrIrJ)r�Z
force_windowsr<r<r=�
get_writerOszScriptWriter.get_writercCs.tjdkstjdkr&tjdkr&t��S|SdS)zD
        Select the best ScriptWriter for this environment.
        �win32�javar�N)r�rtr?r��_namerIrJr1r<r<r=rJUszScriptWriter.bestccs|||fVdSrEr<)r�rTr�rMrPr<r<r=rS_szScriptWriter._get_script_argsr�cCs"|j���|�}|�|�|��S)z;Create a #! line, getting options (if any) from script_text)�command_spec_classrJr6r=rB)r�rPr�cmdr<r<r=rOds
zScriptWriter.get_header)NF)NF)N)r�N)r�r�r�r�rPrQr�r�r0r[r�rNrJrKr�rRrWrJrSrOr<r<r<r=rIs&


	
rIc@sLeZdZeZedd��Zedd��Zedd��Zedd��Z	e
d	d
��ZdS)rIcCst�dt�|��SrV)rGr�rHrJr1r<r<r=rWoszWindowsScriptWriter.get_writercCs"tt|d�}tj�dd�}||S)zC
        Select the best ScriptWriter suitable for Windows
        )rZnaturalZSETUPTOOLS_LAUNCHERr)r��WindowsExecutableLauncherWriterr?r�rz)r�Z
writer_lookupZlauncherr<r<r=rJus�zWindowsScriptWriter.bestc	#s�tddd�|}|tjd���d�krBdjft��}t�|t	�dddd	d
ddg}|�
|�|�||�}�fdd
�|D�}�|||d|fVdS)z For Windows, add a .py extensionz.pyar,rPZPATHEXT�;zK{ext} not listed in PATHEXT; scripts will not be recognized as executables.r\�
-script.py�.pyc�.pyor[csg|]}�|�qSr<r<rU�r�r<r=r��sz8WindowsScriptWriter._get_script_args.<locals>.<listcomp>rTN)r�r?r�rr�r�r�rGr��UserWarningr;�_adjust_header)	r�rTr�rMrP�extr�r�r�r<rbr=rS�s��
z$WindowsScriptWriter._get_script_argscCsNd}d}|dkr||}}t�t�|�tj�}|j||d�}|�|�rJ|S|S)z�
        Make sure 'pythonw' is used for gui and and 'python' is used for
        console (regardless of what sys.executable is).
        rr
rQ)r9�repl)rr�escape�
IGNORECASE�sub�_use_header)r�rTZorig_headerrrfZ
pattern_ob�
new_headerr<r<r=rd�s
z"WindowsScriptWriter._adjust_headercCs$|dd��d�}tjdkp"t|�S)z�
        Should _adjust_header use the replaced header?

        On non-windows systems, always use. On
        Windows systems, only use the replaced header if it resolves
        to an executable on the system.
        r�r��"rX)rRr�rtr)rkZclean_headerr<r<r=rj�s	zWindowsScriptWriter._use_headerN)r�r�r�rFr[r�rWrJrSrdr�rjr<r<r<r=rIls




rIc@seZdZedd��ZdS)r]c#s�|dkrd}d}dg}nd}d}dddg}|�||�}�fd	d
�|D�}	�|||d|	fV�dt|�d
fVt�s��d}
|
t��dfVdS)zG
        For Windows, add a .py extension and an .exe launcher
        rQz-script.pywr,Zclir_r\r`racsg|]}�|�qSr<r<rUrbr<r=r��szDWindowsExecutableLauncherWriter._get_script_args.<locals>.<listcomp>rTr[rdz
.exe.manifestN)rd�get_win_launcherr>�load_launcher_manifest)r�rTr�rMrPZ
launcher_typerer�Zhdrr�Zm_namer<rbr=rS�s"
�z0WindowsExecutableLauncherWriter._get_script_argsN)r�r�r�r�rSr<r<r<r=r]�sr]cCs2d|}t�r|�dd�}n|�dd�}td|�S)z�
    Load the Windows launcher (executable) suitable for launching a script.

    `type` should be either 'cli' or 'gui'

    Returns the executable as a byte string.
    z%s.exe�.z-64.z-32.r�)r>rSr#)�typeZlauncher_fnr<r<r=rm�s
rmcCs0t�td�}tjr|t�S|�d�t�SdS)Nzlauncher manifest.xmlrR)rr#r�r�PY2�varsrS)r�Zmanifestr<r<r=rn�s
rnFcCst�|||�SrE)rBr�)r@�
ignore_errors�onerrorr<r<r=r��sr�cCst�d�}t�|�|S)N�)r?�umask)Ztmpr<r<r=rV�s

rVcCs:ddl}tj�|jd�}|tjd<tj�|�t�dS)Nr)	r�r?r@r�__path__r��argvr�r6)r�Zargv0r<r<r=�	bootstrap�s

ryc	s�ddlm}ddlm�G�fdd�d��}|dkrBtjdd�}t��0|fddd	g|tjdpfd|d
�|��W5QRXdS)Nr)�setup�r)cseZdZdZ�fdd�ZdS)z-main.<locals>.DistributionWithoutHelpCommandsr�c	s(t���j|f|�|�W5QRXdSrE)�_patch_usage�
_show_help)r�rz�kwr{r<r=r}	sz8main.<locals>.DistributionWithoutHelpCommands._show_helpN)r�r�r�Zcommon_usager}r<r{r<r=�DistributionWithoutHelpCommands	srrr�r3z-v)Zscript_argsrZ	distclass)r�rzZsetuptools.distr)r�rxr|)rxr~rzrr<r{r=r6�s��c#sLddl}t�d�����fdd�}|jj}||j_z
dVW5||j_XdS)Nrze
        usage: %(script)s [options] requirement_or_url ...
           or: %(script)s --help
        cs�ttj�|�d�S)N)Zscript)r�r?r@r)r�ZUSAGEr<r=�	gen_usage	s
�z_patch_usage.<locals>.gen_usage)Zdistutils.corerPrQr�Zcorer�)r�r�Zsavedr<r�r=r|	s
r|c@seZdZdZdS)rHzuClass for warning about deprecations in EasyInstall in SetupTools. Not ignored by default, unlike DeprecationWarning.N)r�r�r�r�r<r<r<r=rH(	srH)N)r)N)�r�rr�rrrZdistutils.errorsrrrr	Zdistutils.command.installr
rr�rr
Zdistutils.command.build_scriptsrrrr�r?rirBr%r�rr�r�rPrGr�r:r�r)r7r�Z	sysconfigrrr�rZsetuptools.externrZsetuptools.extern.six.movesrrrZsetuptools.sandboxrZsetuptools.py27compatrZsetuptools.commandrZsetuptools.archive_utilrZsetuptools.package_indexrrrrrZsetuptools.wheelr rr!r"r#r$r%r&r'r(r)r*r+r,r-r.r/Zpkg_resources.py31compatrpZ
__metaclass__�filterwarningsZ
PEP440Warning�__all__r>r2rqrHrLrr3rr�r�r5r7r4r�r�rzrr	rrrrr
r
�builtin_module_namesrr#r'r+rMrWr.�ImportErrorr�r0r3Zsys_executablerFrIrIr]rNrJrmrnr�rVryr6r�r|rHr<r<r<r=�<module>s�D�
{A))'lR
 �


T^A 


site-packages/setuptools/command/__pycache__/install_egg_info.cpython-38.opt-1.pyc000064400000004543151446177000024240 0ustar00U

�Qab��@s\ddlmZmZddlZddlmZddlmZddlmZddl	Z	Gdd�dej
e�ZdS)�)�log�dir_utilN)�Command)�
namespaces)�unpack_archivec@sBeZdZdZdZdgZdd�Zdd�Zdd�Zd	d
�Z	dd�Z
d
S)�install_egg_infoz.Install an .egg-info directory for the package)zinstall-dir=�dzdirectory to install tocCs
d|_dS�N)�install_dir��self�r
�G/usr/lib/python3.8/site-packages/setuptools/command/install_egg_info.py�initialize_optionssz#install_egg_info.initialize_optionscCsV|�dd�|�d�}t�dd|j|j���d}|j|_tj	�
|j|�|_g|_
dS)NZinstall_lib)r
r
�egg_infoz	.egg-info)Zset_undefined_optionsZget_finalized_command�
pkg_resourcesZDistributionZegg_nameZegg_versionr�source�os�path�joinr
�target�outputs)rZei_cmd�basenamer
r
r�finalize_optionss�
��z!install_egg_info.finalize_optionscCs�|�d�tj�|j�r:tj�|j�s:tj|j|jd�n(tj�	|j�rb|�
tj|jfd|j�|jstt�
|j�|�
|jdd|j|jf�|��dS)Nr)�dry_runz	Removing r
�Copying %s to %s)Zrun_commandrr�isdirr�islinkrZremove_treer�existsZexecute�unlinkrZensure_directory�copytreerZinstall_namespacesrr
r
r�run!s
�zinstall_egg_info.runcCs|jSr	)rrr
r
r�get_outputs.szinstall_egg_info.get_outputscs �fdd�}t�j�j|�dS)NcsDdD] }|�|�sd||krdSq�j�|�t�d||�|S)N)z.svn/zCVS/�/r)�
startswithr�appendr�debug)�srcZdst�skiprr
r�skimmer3sz*install_egg_info.copytree.<locals>.skimmer)rrr)rr)r
rrr 1szinstall_egg_info.copytreeN)�__name__�
__module__�__qualname__�__doc__�descriptionZuser_optionsrrr!r"r r
r
r
rr
s�
r)Z	distutilsrrrZ
setuptoolsrrZsetuptools.archive_utilrrZ	Installerrr
r
r
r�<module>ssite-packages/setuptools/command/__pycache__/develop.cpython-38.opt-1.pyc000064400000014545151446177000022376 0ustar00U

�Qab��@s�ddlmZddlmZddlmZmZddlZddlZddl	Z	ddl
mZddlZddl
mZddlmZddlZeZGdd	�d	eje�ZGd
d�d�ZdS)�)�convert_path)�log)�DistutilsError�DistutilsOptionErrorN)�six)�easy_install)�
namespacesc@sveZdZdZdZejddgZejdgZdZdd�Z	d	d
�Z
dd�Zed
d��Z
dd�Zdd�Zdd�Zdd�ZdS)�developzSet up package for developmentz%install package in 'development mode')�	uninstall�uzUninstall this source package)z	egg-path=Nz-Set the path to be used in the .egg-link filer
FcCs2|jrd|_|��|��n|��|��dS)NT)r
Z
multi_version�uninstall_linkZuninstall_namespaces�install_for_developmentZwarn_deprecated_options��self�r�>/usr/lib/python3.8/site-packages/setuptools/command/develop.py�run s
zdevelop.runcCs&d|_d|_t�|�d|_d|_dS)N�.)r
�egg_pathr�initialize_options�
setup_pathZalways_copy_fromrrrrr)s

zdevelop.initialize_optionscCs|�d�}|jr,d}|j|jf}t||��|jg|_t�|�|��|�	�|j
�t�d��|jd}t
j�|j|�|_|j|_|jdkr�t
j�|j�|_t�|j�}t�t
j�|j|j��}||kr�td|��tj|t�|t
j�|j��|jd�|_|�|j|j|j�|_dS)N�egg_infoz-Please rename %r to %r before using 'develop'z*.eggz	.egg-linkzA--egg-path must be a relative path from the install directory to �Zproject_name)�get_finalized_commandZbroken_egg_inforrZegg_name�argsr�finalize_optionsZexpand_basedirsZexpand_dirsZ
package_index�scan�glob�os�path�join�install_dir�egg_link�egg_baser�abspath�
pkg_resources�normalize_pathrZDistribution�PathMetadata�dist�_resolve_setup_pathr)rZei�templaterZegg_link_fn�targetrrrrr0sF




�����zdevelop.finalize_optionscCsn|�tjd��d�}|tjkr0d|�d�d}t�tj�	|||��}|t�tj�krjt
d|t�tj���|S)z�
        Generate a path from egg_base back to '.' where the
        setup script resides and ensure that path points to the
        setup path from $install_dir/$egg_path.
        �/z../�zGCan't get a consistent path to setup script from installation directory)�replacer�sep�rstrip�curdir�countr%r&rr r)r#r!rZ
path_to_setupZresolvedrrrr)Zs
�
�zdevelop._resolve_setup_pathc	CsHtjr�t|jdd�r�|jddd�|�d�|�d�}t�|j	�}|jd|d�|�d�|jddd�|�d�|�d�}||_
||j_t�
||j�|j_n"|�d�|jdd	d�|�d�|��tjr�|�tj�dt_|��t�d
|j|j�|j�s0t|jd��}|�|j
d|j�W5QRX|�d|j|j�dS)
NZuse_2to3FZbuild_pyr)Zinplacer)r#Z	build_extr-zCreating %s (link to %s)�w�
)rZPY3�getattr�distributionZreinitialize_commandZrun_commandrr%r&Z	build_librr(�locationr'rZ	_providerZinstall_site_py�
setuptoolsZbootstrap_install_fromrZinstall_namespacesr�infor"r#�dry_run�open�writerZprocess_distributionZno_deps)rZbpy_cmdZ
build_pathZei_cmd�frrrr
ns:




�


 zdevelop.install_for_developmentcCs�tj�|j�rzt�d|j|j�t|j�}dd�|D�}|��||j	g|j	|j
gfkrht�d|�dS|jszt�
|j�|js�|�|j�|jjr�t�d�dS)NzRemoving %s (link to %s)cSsg|]}|���qSr)r0)�.0�linerrr�
<listcomp>�sz*develop.uninstall_link.<locals>.<listcomp>z$Link points to %s: uninstall abortedz5Note: you must uninstall or replace scripts manually!)rr�existsr"rr9r#r;�closerr�warnr:�unlinkZ
update_pthr(r6�scripts)rZ
egg_link_file�contentsrrrr�s 

�zdevelop.uninstall_linkc
Cs�||jk	rt�||�S|�|�|jjp*gD]N}tj�t	|��}tj�
|�}t�|��}|�
�}W5QRX|�||||�q,dS�N)r(r�install_egg_scripts�install_wrapper_scriptsr6rErrr$r�basename�ior;�readZinstall_script)rr(Zscript_nameZscript_pathZstrmZscript_textrrrrH�s

zdevelop.install_egg_scriptscCst|�}t�||�SrG)�VersionlessRequirementrrI�rr(rrrrI�szdevelop.install_wrapper_scriptsN)�__name__�
__module__�__qualname__�__doc__�descriptionrZuser_optionsZboolean_optionsZcommand_consumes_argumentsrrr�staticmethodr)r
rrHrIrrrrr	s"�	*
0r	c@s(eZdZdZdd�Zdd�Zdd�ZdS)	rMa�
    Adapt a pkg_resources.Distribution to simply return the project
    name as the 'requirement' so that scripts will work across
    multiple versions.

    >>> from pkg_resources import Distribution
    >>> dist = Distribution(project_name='foo', version='1.0')
    >>> str(dist.as_requirement())
    'foo==1.0'
    >>> adapted_dist = VersionlessRequirement(dist)
    >>> str(adapted_dist.as_requirement())
    'foo'
    cCs
||_dSrG)�_VersionlessRequirement__distrNrrr�__init__�szVersionlessRequirement.__init__cCst|j|�SrG)r5rU)r�namerrr�__getattr__�sz"VersionlessRequirement.__getattr__cCs|jSrGrrrrr�as_requirement�sz%VersionlessRequirement.as_requirementN)rOrPrQrRrVrXrYrrrrrM�srM)Zdistutils.utilrZ	distutilsrZdistutils.errorsrrrrrKZsetuptools.externrr%Zsetuptools.command.easy_installrr8r�typeZ
__metaclass__ZDevelopInstallerr	rMrrrr�<module>s6site-packages/setuptools/command/__pycache__/install.cpython-38.opt-1.pyc000064400000007627151446177000022411 0ustar00U

�QabK�@s|ddlmZddlZddlZddlZddlZddlmmZ	ddl
Z
e	jZGdd�de	j�Zdd�e	jjD�ej
e_dS)�)�DistutilsArgErrorNc@s�eZdZdZejjddgZejjddgZddd�fd	d
d�fgZe	e�Z
dd�Zd
d�Zdd�Z
dd�Zedd��Zdd�ZdS)�installz7Use easy_install to install the package, w/dependencies)�old-and-unmanageableNzTry not to use this!)�!single-version-externally-managedNz5used by system package builders to create 'flat' eggsrrZinstall_egg_infocCsdS�NT���selfrr�>/usr/lib/python3.8/site-packages/setuptools/command/install.py�<lambda>�zinstall.<lambda>Zinstall_scriptscCsdSrrrrrr
rrcCstj�|�d|_d|_dS�N)�origr�initialize_options�old_and_unmanageable�!single_version_externally_managedrrrr
r szinstall.initialize_optionscCs8tj�|�|jrd|_n|jr4|js4|js4td��dS)NTzAYou must specify --record or --root when building system packages)rr�finalize_options�rootr�recordrrrrr
r%s�zinstall.finalize_optionscCs(|js|jrtj�|�Sd|_d|_dS)N�)rrrr�handle_extra_pathZ	path_fileZ
extra_dirsrrrr
r0szinstall.handle_extra_pathcCs@|js|jrtj�|�S|�t���s4tj�|�n|��dSr
)	rrrr�run�_called_from_setup�inspectZcurrentframe�do_egg_installrrrr
r:s
zinstall.runcCsz|dkr4d}t�|�t��dkr0d}t�|�dSt�|�d}|dd�\}t�|�}|j�dd	�}|d
kox|j	dkS)a�
        Attempt to detect whether run() was called from setup() or by another
        command.  If called by setup(), the parent caller will be the
        'run_command' method in 'distutils.dist', and *its* caller will be
        the 'run_commands' method.  If called any other way, the
        immediate caller *might* be 'run_command', but it won't have been
        called by 'run_commands'. Return True in that case or if a call stack
        is unavailable. Return False otherwise.
        Nz4Call stack not available. bdist_* commands may fail.Z
IronPythonz6For best results, pass -X:Frames to enable call stack.T���__name__rzdistutils.distZrun_commands)
�warnings�warn�platformZpython_implementationrZgetouterframesZgetframeinfo�	f_globals�getZfunction)Z	run_frame�msg�resZcaller�infoZ
caller_modulerrr
rEs


�zinstall._called_from_setupcCs�|j�d�}||jd|j|jd�}|��d|_|j�t�d��|�	d�|j�
d�jg}tj
rp|�dtj
�||_|��dt_
dS)N�easy_install�x)�argsrr�.z*.eggZ	bdist_eggr)ZdistributionZget_command_classrrZensure_finalizedZalways_copy_fromZ
package_index�scan�globZrun_commandZget_command_objZ
egg_output�
setuptoolsZbootstrap_install_from�insertr(r)r	r&�cmdr(rrr
r`s"�
zinstall.do_egg_installN)r�
__module__�__qualname__�__doc__rrZuser_optionsZboolean_options�new_commands�dict�_ncrrrr�staticmethodrrrrrr
rs(��

�

rcCsg|]}|dtjkr|�qS)r)rr4)�.0r.rrr
�
<listcomp>{sr7)Zdistutils.errorsrrr+rr Zdistutils.command.installZcommandrrr,�_installZsub_commandsr2rrrr
�<module>sl��site-packages/setuptools/command/__pycache__/bdist_wininst.cpython-38.opt-1.pyc000064400000001672151446177000023615 0ustar00U

�Qab}�@s(ddlmmZGdd�dej�ZdS)�Nc@seZdZddd�Zdd�ZdS)�
bdist_wininstrcCs |j�||�}|dkrd|_|S)zj
        Supplement reinitialize_command to work around
        http://bugs.python.org/issue20819
        )Zinstall�install_libN)Zdistribution�reinitialize_commandr)�self�commandZreinit_subcommands�cmd�r�D/usr/lib/python3.8/site-packages/setuptools/command/bdist_wininst.pyrs�z"bdist_wininst.reinitialize_commandcCs$d|_ztj�|�W5d|_XdS)NTF)Z_is_running�origr�run)rrrr	rszbdist_wininst.runN)r)�__name__�
__module__�__qualname__rrrrrr	rs
r)Zdistutils.command.bdist_wininstrrr
rrrr	�<module>ssite-packages/setuptools/command/__pycache__/build_py.cpython-38.opt-1.pyc000064400000020701151446177000022536 0ustar00U

�Qab|%�@s�ddlmZddlmZddlmmZddlZddlZddl	Z	ddl
Z
ddlZddl
Z
ddlmZddlmZmZmZzddlmZWn"ek
r�Gdd�d�ZYnXGd	d
�d
eje�Zddd�Zd
d�ZdS)�)�glob)�convert_pathN)�six)�map�filter�filterfalse)�	Mixin2to3c@seZdZddd�ZdS)rTcCsdS)z
do nothingN�)�self�filesZdoctestsr	r	�?/usr/lib/python3.8/site-packages/setuptools/command/build_py.py�run_2to3szMixin2to3.run_2to3N)T)�__name__�
__module__�__qualname__r
r	r	r	rrsrc@s�eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zedd��Zd S)!�build_pyaXEnhanced 'build_py' command that includes data files with packages

    The data files are specified via a 'package_data' argument to 'setup()'.
    See 'setuptools.dist.Distribution' for more details.

    Also, this version of the 'build_py' command allows you to specify both
    'py_modules' and 'packages' in the same setup operation.
    cCsFtj�|�|jj|_|jjp i|_d|jkr6|jd=g|_g|_dS)N�
data_files)	�origr�finalize_options�distribution�package_data�exclude_package_data�__dict__�_build_py__updated_files�_build_py__doctests_2to3�r
r	r	rr!s
�
zbuild_py.finalize_optionscCsx|js|jsdS|jr|��|jr4|��|��|�|jd�|�|jd�|�|jd�|�t	j
j|dd��dS)z?Build modules, packages, and copy data files to build directoryNFTr)Zinclude_bytecode)Z
py_modules�packagesZ
build_modulesZbuild_packages�build_package_datar
rrZbyte_compilerrZget_outputsrr	r	r�run+szbuild_py.runcCs&|dkr|��|_|jStj�||�S)zlazily compute data filesr)�_get_data_filesrrr�__getattr__)r
�attrr	r	rr ?s
zbuild_py.__getattr__cCsJtjrt|tj�r|�d�}tj�||||�\}}|rB|j�	|�||fS)N�.)
rZPY2�
isinstanceZstring_types�splitrr�build_moduler�append)r
�moduleZmodule_file�packageZoutfile�copiedr	r	rr%Fs
�zbuild_py.build_modulecCs|��tt|j|jpd��S)z?Generate list of '(package,src_dir,build_dir,filenames)' tuplesr	)�analyze_manifest�listr�_get_pkg_data_filesrrr	r	rrPszbuild_py._get_data_filescsJ|�|��tjj|jg|�d��}�fdd�|�|��D�}|�||fS)Nr"csg|]}tj�|���qSr	)�os�path�relpath)�.0�file��src_dirr	r�
<listcomp>]s�z0build_py._get_pkg_data_files.<locals>.<listcomp>)�get_package_dirr-r.�joinZ	build_libr$�find_data_files)r
r(�	build_dir�	filenamesr	r2rr,Us


�zbuild_py._get_pkg_data_filescCsX|�|j||�}tt|�}tj�|�}ttj	j
|�}t�|j�|g�|�}|�
|||�S)z6Return filenames for package's data files in 'src_dir')�_get_platform_patternsrrr�	itertools�chain�
from_iterablerr-r.�isfile�manifest_files�get�exclude_data_files)r
r(r3�patternsZglobs_expandedZ
globs_matchesZ
glob_filesrr	r	rr7cs�
�zbuild_py.find_data_filesc
Cs�|jD]|\}}}}|D]j}tj�||�}|�tj�|��tj�||�}|�||�\}}	tj�|�}|	r||jj	kr|j
�|�qqdS)z$Copy data files into build directoryN)rr-r.r6Zmkpath�dirnameZ	copy_file�abspathrZconvert_2to3_doctestsrr&)
r
r(r3r8r9�filename�targetZsrcfileZoutfr)r	r	rrts
�zbuild_py.build_package_datacCs�i|_}|jjsdSi}|jp"dD]}||t|�|��<q$|�d�|�d�}|jj	D]�}t
j�t|��\}}d}|}	|r�||kr�||kr�|}t
j�|�\}}
t
j�
|
|�}qx||krX|�d�r�||	kr�qX|�||g��|�qXdS)Nr	Zegg_infoz.py)r?rZinclude_package_datar�assert_relativer5Zrun_commandZget_finalized_commandZfilelistrr-r.r$r6�endswith�
setdefaultr&)r
ZmfZsrc_dirsr(Zei_cmdr.�d�f�prevZoldfZdfr	r	rr*�s(


zbuild_py.analyze_manifestcCsdS�Nr	rr	r	r�get_data_files�szbuild_py.get_data_filesc	Cs�z|j|WStk
r YnXtj�|||�}||j|<|rH|jjsL|S|jjD]}||ksn|�|d�rTqxqT|St�	|d��}|�
�}W5QRXd|kr�tj�
d|f��|S)z8Check namespace packages' __init__ for declare_namespacer"�rbsdeclare_namespacez�Namespace package problem: %s is a namespace package, but its
__init__.py does not call declare_namespace()! Please fix it.
(See the setuptools manual under "Namespace Packages" for details.)
")�packages_checked�KeyErrorrr�
check_packagerZnamespace_packages�
startswith�io�open�read�	distutils�errorsZDistutilsError)r
r(Zpackage_dirZinit_pyZpkgrK�contentsr	r	rrR�s*
��zbuild_py.check_packagecCsi|_tj�|�dSrM)rPrr�initialize_optionsrr	r	rrZ�szbuild_py.initialize_optionscCs0tj�||�}|jjdk	r,tj�|jj|�S|SrM)rrr5rZsrc_rootr-r.r6)r
r(�resr	r	rr5�szbuild_py.get_package_dircs\t���|�|j||�}�fdd�|D�}tj�|�}t|���fdd��D�}tt|��S)z6Filter filenames for package's data files in 'src_dir'c3s|]}t��|�VqdSrM)�fnmatchr�r0�pattern)rr	r�	<genexpr>�s�z.build_py.exclude_data_files.<locals>.<genexpr>c3s|]}|�kr|VqdSrMr	)r0�fn)�badr	rr_�s�)r+r:rr;r<r=�set�_unique_everseen)r
r(r3rrBZmatch_groupsZmatchesZkeepersr	)rarrrA�s�
�
�zbuild_py.exclude_data_filescs.t�|�dg�|�|g��}�fdd�|D�S)z�
        yield platform-specific path patterns (suitable for glob
        or fn_match) from a glob-based spec (such as
        self.package_data or self.exclude_package_data)
        matching package in src_dir.
        �c3s |]}tj��t|��VqdSrM)r-r.r6rr]r2r	rr_�s�z2build_py._get_platform_patterns.<locals>.<genexpr>)r;r<r@)�specr(r3Zraw_patternsr	r2rr:�s

�
�zbuild_py._get_platform_patternsN)rrr�__doc__rrr r%rr,r7rr*rNrRrZr5rA�staticmethodr:r	r	r	rrs"	


rccsbt�}|j}|dkr6t|j|�D]}||�|Vq n(|D]"}||�}||kr:||�|Vq:dS)zHList unique elements, preserving order. Remember all elements ever seen.N)rb�addr�__contains__)�iterable�key�seenZseen_addZelement�kr	r	rrc�s
rccCs:tj�|�s|Sddlm}t�d���|}||��dS)Nr)�DistutilsSetupErrorz�
        Error: setup script specifies an absolute path:

            %s

        setup() arguments must *always* be /-separated paths relative to the
        setup.py directory, *never* absolute paths.
        )r-r.�isabs�distutils.errorsrn�textwrap�dedent�lstrip)r.rn�msgr	r	rrGs�rG)N)rZdistutils.utilrZdistutils.command.build_pyZcommandrrr-r\rqrTrprWr;Zsetuptools.externrZsetuptools.extern.six.movesrrrZsetuptools.lib2to3_exr�ImportErrorrcrGr	r	r	r�<module>s$Y
site-packages/setuptools/command/__pycache__/sdist.cpython-38.opt-1.pyc000064400000015227151446177000022064 0ustar00U

�Qab��@s�ddlmZddlmmZddlZddlZddlZddl	Z	ddl
mZddlm
Z
ddlZeZddd�ZGd	d
�d
e
ej�ZdS)�)�logN)�six�)�sdist_add_defaults�ccs,t�d�D]}|��|�D]
}|Vqq
dS)z%Find all files under revision controlzsetuptools.file_findersN)�
pkg_resourcesZiter_entry_points�load)�dirnameZep�item�r�</usr/lib/python3.8/site-packages/setuptools/command/sdist.py�walk_revctrlsr
cs�eZdZdZdddgZiZddddgZed	d
�eD��Zdd�Z	d
d�Z
dd�Zdd�Ze
ejdd���Zdd�Zejdkp�dejko�dknp�dejko�dknZer�eZdd�Z�fdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Z�ZS)*�sdistz=Smart sdist that finds anything supported by revision control)zformats=Nz6formats for source distribution (comma-separated list))z	keep-temp�kz@keep the distribution tree around after creating archive file(s))z	dist-dir=�dzFdirectory to put the source distribution archive(s) in [default: dist]rz.rstz.txtz.mdccs|]}d�|�VqdS)z	README{0}N)�format)�.0Zextrrr�	<genexpr>)szsdist.<genexpr>cCs�|�d�|�d�}|j|_|j�tj�|jd��|��|�	�D]}|�|�qD|�
�t|jdg�}|j
D] }dd|f}||krp|�|�qpdS)N�egg_infozSOURCES.txt�
dist_filesrr)Zrun_command�get_finalized_command�filelist�append�os�path�joinr�check_readmeZget_sub_commands�make_distribution�getattr�distributionZ
archive_files)�selfZei_cmdZcmd_namer�file�datarrr�run+s



z	sdist.runcCstj�|�|��dS)N)�origr�initialize_options�_default_to_gztar�r rrrr%>szsdist.initialize_optionscCstjdkrdSdg|_dS)N)��rZbetarZgztar)�sys�version_infoZformatsr'rrrr&Cs
zsdist._default_to_gztarc	Cs$|���tj�|�W5QRXdS)z%
        Workaround for #516
        N)�_remove_os_linkr$rrr'rrrrIs
zsdist.make_distributionc
cs^Gdd�d�}ttd|�}zt`Wntk
r6YnXz
dVW5||k	rXttd|�XdS)zG
        In a context, remove and restore os.link if it exists
        c@seZdZdS)z&sdist._remove_os_link.<locals>.NoValueN)�__name__�
__module__�__qualname__rrrr�NoValueWsr0�linkN)rrr1�	Exception�setattr)r0Zorig_valrrrr,Ps
zsdist._remove_os_linkcCsLztj�|�Wn6tk
rFt��\}}}|jjjd�	��YnXdS)N�template)
r$r�
read_templater2r*�exc_info�tb_next�tb_frame�f_locals�close)r �_�tbrrrZ__read_template_hackeszsdist.__read_template_hack)��r=)r(r)r(r�)r(r=)r(r=rcs^|j��rZ|�d�}|j�|���|jjsZ|jD]&\}�}}|j��fdd�|D��q2dS)zgetting python files�build_pycsg|]}tj��|��qSr)rrr)r�filename�Zsrc_dirrr�
<listcomp>�s�z.sdist._add_defaults_python.<locals>.<listcomp>N)rZhas_pure_modulesrr�extendZget_source_filesZinclude_package_dataZ
data_files)r r@r;�	filenamesrrBr�_add_defaults_python|s

�zsdist._add_defaults_pythoncsDz tjrt�|�n
t���Wntk
r>t�d�YnXdS)Nz&data_files contains unexpected objects)rZPY2r�_add_defaults_data_files�super�	TypeErrorr�warnr'��	__class__rrrG�szsdist._add_defaults_data_filescCs8|jD]}tj�|�rdSq|�dd�|j��dS)Nz,standard file not found: should have one of z, )�READMESrr�existsrJr)r �frrrr�s

��zsdist.check_readmecCs^tj�|||�tj�|d�}ttd�rJtj�|�rJt�|�|�	d|�|�
d��|�dS)Nz	setup.cfgr1r)r$r�make_release_treerrr�hasattrrN�unlinkZ	copy_filerZsave_version_info)r Zbase_dir�files�destrrrrP�s
zsdist.make_release_treec	Cs@tj�|j�sdSt�|jd��}|��}W5QRX|d��kS)NF�rbz+# file GENERATED by distutils, do NOT edit
)rr�isfile�manifest�io�open�readline�encode)r �fpZ
first_linerrr�_manifest_is_not_generated�s�z sdist._manifest_is_not_generatedc	Cs�t�d|j�t|jd�}|D]d}tjr^z|�d�}Wn&tk
r\t�d|�YqYnX|�	�}|�
d�s|svq|j�|�q|�
�dS)z�Read the manifest file (named by 'self.manifest') and use it to
        fill in 'self.filelist', the list of files to include in the source
        distribution.
        zreading manifest file '%s'rUzUTF-8z"%r not UTF-8 decodable -- skipping�#N)r�inforWrYrZPY3�decode�UnicodeDecodeErrorrJ�strip�
startswithrrr:)r rW�linerrr�
read_manifest�s
zsdist.read_manifestcCs^|j�d�}|�dd�\}}|dkr2t�d�dStj�|�sNt�d|�dS|j	�
|�dS)zyChecks if license_file' is configured and adds it to
        'self.filelist' if the value contains a valid path.
        Zmetadata�license_file)NNNz''license_file' option was not specifiedz8warning: Failed to find the configured license file '%s')rZget_option_dict�getr�debugrrrNrJrr)r Zoptsr;rfrrr�
check_license�s
�zsdist.check_license)r-r.r/�__doc__Zuser_optionsZnegative_optZREADME_EXTENSIONS�tuplerMr#r%r&r�staticmethod�
contextlib�contextmanagerr,Z_sdist__read_template_hackr*r+Zhas_leaky_handler5rFrGrrPr]reri�
__classcell__rrrKrrs<�
��	


r)r)Z	distutilsrZdistutils.command.sdistZcommandrr$rr*rXrmZsetuptools.externrZ
py36compatrr�listZ_default_revctrlr
rrrr�<module>s
site-packages/setuptools/command/__pycache__/setopt.cpython-38.pyc000064400000010671151446177000021313 0ustar00U

�Qab��@s�ddlmZddlmZddlmZddlZddlZddlmZddl	m
Z
ddd	d
gZddd�Zddd�Z
Gdd	�d	e
�ZGdd
�d
e�ZdS)�)�convert_path)�log)�DistutilsOptionErrorN)�configparser)�Command�config_file�edit_config�option_base�setopt�localcCsh|dkrdS|dkr,tj�tj�tj�d�S|dkrZtjdkrBdpDd}tj�td	|��St	d
|��dS)z�Get the filename of the distutils, local, global, or per-user config

    `kind` must be one of "local", "global", or "user"
    rz	setup.cfg�globalz
distutils.cfg�user�posix�.�z~/%spydistutils.cfgz7config_file() type must be 'local', 'global', or 'user'N)
�os�path�join�dirname�	distutils�__file__�name�
expanduserr�
ValueError)Zkind�dot�r�=/usr/lib/python3.8/site-packages/setuptools/command/setopt.pyrs��Fc		Cs&t�d|�t��}|�|g�|��D]�\}}|dkrRt�d||�|�|�q(|�|�stt�d||�|�	|�|��D]p\}}|dkr�t�d|||�|�
||�|�|�s�t�d||�|�|�q|t�d||||�|�|||�q|q(t�d|�|�s"t
|d	��}|�|�W5QRXdS)
aYEdit a configuration file to include `settings`

    `settings` is a dictionary of dictionaries or ``None`` values, keyed by
    command/section name.  A ``None`` value means to delete the entire section,
    while a dictionary lists settings to be changed or deleted in that section.
    A setting of ``None`` means to delete that setting.
    zReading configuration from %sNzDeleting section [%s] from %szAdding new section [%s] to %szDeleting %s.%s from %sz#Deleting empty [%s] section from %szSetting %s.%s to %r in %sz
Writing %s�w)r�debugrZRawConfigParser�read�items�infoZremove_sectionZhas_sectionZadd_sectionZ
remove_option�options�set�open�write)	�filenameZsettings�dry_runZoptsZsectionr"�option�value�frrrr!sJ

�
��c@s2eZdZdZdddgZddgZdd�Zd	d
�ZdS)r	z<Abstract base class for commands that mess with config files)�
global-config�gz0save options to the site-wide distutils.cfg file)�user-config�uz7save options to the current user's pydistutils.cfg file)z	filename=r*z-configuration file to use (default=setup.cfg)r+r-cCsd|_d|_d|_dS�N)�
global_config�user_configr&��selfrrr�initialize_options\szoption_base.initialize_optionscCsvg}|jr|�td��|jr,|�td��|jdk	rB|�|j�|sT|�td��t|�dkrjtd|��|\|_dS)Nrr
r�z/Must specify only one configuration file option)r0�appendrr1r&�lenr)r3�	filenamesrrr�finalize_optionsas
�zoption_base.finalize_optionsN)�__name__�
__module__�__qualname__�__doc__�user_options�boolean_optionsr4r9rrrrr	Ls�
�c@sJeZdZdZdZddddgejZejdgZdd	�Zd
d�Z	dd
�Z
dS)r
z#Save command-line options to a filez1set an option in setup.cfg or another config file)zcommand=�czcommand to set an option for)zoption=�oz
option to set)z
set-value=�szvalue of the option)�remove�rzremove (unset) the valuerCcCs&t�|�d|_d|_d|_d|_dSr/)r	r4�commandr(�	set_valuerCr2rrrr4�s

zsetopt.initialize_optionscCsBt�|�|jdks|jdkr&td��|jdkr>|js>td��dS)Nz%Must specify --command *and* --optionz$Must specify --set-value or --remove)r	r9rEr(rrFrCr2rrrr9�s

zsetopt.finalize_optionscCs*t|j|j|j�dd�|jii|j�dS)N�-�_)rr&rEr(�replacerFr'r2rrr�run�s��z
setopt.runN)r:r;r<r=�descriptionr	r>r?r4r9rJrrrrr
ss��)r)F)Zdistutils.utilrrrZdistutils.errorsrrZsetuptools.extern.six.movesrZ
setuptoolsr�__all__rrr	r
rrrr�<module>s

+'site-packages/setuptools/command/__pycache__/bdist_wininst.cpython-38.pyc000064400000001672151446177000022656 0ustar00U

�Qab}�@s(ddlmmZGdd�dej�ZdS)�Nc@seZdZddd�Zdd�ZdS)�
bdist_wininstrcCs |j�||�}|dkrd|_|S)zj
        Supplement reinitialize_command to work around
        http://bugs.python.org/issue20819
        )Zinstall�install_libN)Zdistribution�reinitialize_commandr)�self�commandZreinit_subcommands�cmd�r�D/usr/lib/python3.8/site-packages/setuptools/command/bdist_wininst.pyrs�z"bdist_wininst.reinitialize_commandcCs$d|_ztj�|�W5d|_XdS)NTF)Z_is_running�origr�run)rrrr	rszbdist_wininst.runN)r)�__name__�
__module__�__qualname__rrrrrr	rs
r)Zdistutils.command.bdist_wininstrrr
rrrr	�<module>ssite-packages/setuptools/command/__pycache__/install_lib.cpython-38.opt-1.pyc000064400000007772151446177000023240 0ustar00U

�Qab�@sHddlZddlZddlmZmZddlmmZGdd�dej�ZdS)�N)�product�starmapc@sZeZdZdZdd�Zdd�Zdd�Zedd	��Zd
d�Z	edd
��Z
ddd�Zdd�ZdS)�install_libz9Don't add compiled flags to filenames of non-Python filescCs&|��|��}|dk	r"|�|�dS�N)Zbuild�installZbyte_compile)�self�outfiles�r	�B/usr/lib/python3.8/site-packages/setuptools/command/install_lib.py�run
szinstall_lib.runcs4�fdd����D�}t|����}tt�j|��S)z�
        Return a collections.Sized collections.Container of paths to be
        excluded for single_version_externally_managed installations.
        c3s"|]}��|�D]
}|VqqdSr)�
_all_packages)�.0Zns_pkg�pkg�rr	r
�	<genexpr>s�z-install_lib.get_exclusions.<locals>.<genexpr>)�_get_SVEM_NSPsr�_gen_exclusion_paths�setr�_exclude_pkg_path)rZall_packagesZ
excl_specsr	rr
�get_exclusionss

�zinstall_lib.get_exclusionscCs$|�d�|g}tjj|jf|��S)zw
        Given a package name and exclusion path within that package,
        compute the full exclusion path.
        �.)�split�os�path�joinZinstall_dir)rrZexclusion_path�partsr	r	r
rszinstall_lib._exclude_pkg_pathccs |r|V|�d�\}}}qdS)zn
        >>> list(install_lib._all_packages('foo.bar.baz'))
        ['foo.bar.baz', 'foo.bar', 'foo']
        rN)�
rpartition)Zpkg_name�sepZchildr	r	r
r'szinstall_lib._all_packagescCs,|jjsgS|�d�}|j}|r(|jjSgS)z�
        Get namespace packages (list) but only for
        single_version_externally_managed installations and empty otherwise.
        r)ZdistributionZnamespace_packagesZget_finalized_commandZ!single_version_externally_managed)rZinstall_cmdZsvemr	r	r
r1s

zinstall_lib._get_SVEM_NSPsccsbdVdVdVttd�s dStj�ddtjj�}|dV|d	V|d
V|dVdS)zk
        Generate file paths to be excluded for namespace packages (bytecode
        cache files).
        z__init__.pyz__init__.pycz__init__.pyo�implementationN�__pycache__z	__init__.z.pycz.pyoz
.opt-1.pycz
.opt-2.pyc)�hasattr�sysrrrr�	cache_tag)�baser	r	r
rAs



z install_lib._gen_exclusion_paths�rc	sX|����stj�|||�Sddlm}ddlm�g����fdd�}||||��S)Nr)�unpack_directory)�logcs<|�kr��d|�dS��d|tj�|����|�|S)Nz/Skipping installation of %s (namespace package)Fzcopying %s -> %s)�warn�inforr�dirname�append)�srcZdst��excluder&rr	r
�pfgs�
z!install_lib.copy_tree.<locals>.pf)r�origr�	copy_treeZsetuptools.archive_utilr%Z	distutilsr&)	rZinfileZoutfileZ
preserve_modeZpreserve_timesZpreserve_symlinks�levelr%r.r	r,r
r0Vs
zinstall_lib.copy_treecs.tj�|�}|����r*�fdd�|D�S|S)Ncsg|]}|�kr|�qSr	r	)r
�f�r-r	r
�
<listcomp>xsz+install_lib.get_outputs.<locals>.<listcomp>)r/r�get_outputsr)rZoutputsr	r3r
r5ts
zinstall_lib.get_outputsN)r$r$rr$)
�__name__�
__module__�__qualname__�__doc__rrr�staticmethodrrrr0r5r	r	r	r
rs
	
�
r)	rr!�	itertoolsrrZdistutils.command.install_libZcommandrr/r	r	r	r
�<module>ssite-packages/setuptools/command/__pycache__/build_clib.cpython-38.pyc000064400000004605151446177000022065 0ustar00U

�Qab��@sLddlmmZddlmZddlmZddlm	Z	Gdd�dej�ZdS)�N)�DistutilsSetupError)�log)�newer_pairwise_groupc@seZdZdZdd�ZdS)�
build_clibav
    Override the default build_clib behaviour to do the following:

    1. Implement a rudimentary timestamp-based dependency system
       so 'compile()' doesn't run every time.
    2. Add more keys to the 'build_info' dictionary:
        * obj_deps - specify dependencies for each object compiled.
                     this should be a dictionary mapping a key
                     with the source filename to a list of
                     dependencies. Use an empty string for global
                     dependencies.
        * cflags   - specify a list of additional flags to pass to
                     the compiler.
    c	Csr|D�]f\}}|�d�}|dks.t|ttf�s:td|��t|�}t�d|�|�dt��}t|t�srtd|��g}|�dt��}t|ttf�s�td|��|D]P}|g}	|	�|�|�|t��}
t|
ttf�s�td|��|	�|
�|�	|	�q�|j
j||jd�}t
||�ggfk�rT|�d�}|�d	�}
|�d
�}|j
j||j||
||jd�}|j
j|||j|jd�qdS)
N�sourceszfin 'libraries' option (library '%s'), 'sources' must be present and must be a list of source filenameszbuilding '%s' library�obj_depsz\in 'libraries' option (library '%s'), 'obj_deps' must be a dictionary of type 'source: list'�)�
output_dir�macros�include_dirs�cflags)r	r
rZextra_postargs�debug)r	r
)�get�
isinstance�list�tuplerr�info�dict�extend�appendZcompilerZobject_filenamesZ
build_tempr�compiler
Zcreate_static_libr)�selfZ	librariesZlib_nameZ
build_inforrZdependenciesZglobal_deps�sourceZsrc_depsZ
extra_depsZexpected_objectsr
rrZobjects�r�A/usr/lib/python3.8/site-packages/setuptools/command/build_clib.py�build_librariessv
��
����
��
�


��zbuild_clib.build_librariesN)�__name__�
__module__�__qualname__�__doc__rrrrrrsr)
Zdistutils.command.build_clibZcommandrZorigZdistutils.errorsrZ	distutilsrZsetuptools.dep_utilrrrrr�<module>ssite-packages/setuptools/command/__pycache__/sdist.cpython-38.pyc000064400000015227151446177000021125 0ustar00U

�Qab��@s�ddlmZddlmmZddlZddlZddlZddl	Z	ddl
mZddlm
Z
ddlZeZddd�ZGd	d
�d
e
ej�ZdS)�)�logN)�six�)�sdist_add_defaults�ccs,t�d�D]}|��|�D]
}|Vqq
dS)z%Find all files under revision controlzsetuptools.file_findersN)�
pkg_resourcesZiter_entry_points�load)�dirnameZep�item�r�</usr/lib/python3.8/site-packages/setuptools/command/sdist.py�walk_revctrlsr
cs�eZdZdZdddgZiZddddgZed	d
�eD��Zdd�Z	d
d�Z
dd�Zdd�Ze
ejdd���Zdd�Zejdkp�dejko�dknp�dejko�dknZer�eZdd�Z�fdd�Zd d!�Zd"d#�Zd$d%�Zd&d'�Zd(d)�Z�ZS)*�sdistz=Smart sdist that finds anything supported by revision control)zformats=Nz6formats for source distribution (comma-separated list))z	keep-temp�kz@keep the distribution tree around after creating archive file(s))z	dist-dir=�dzFdirectory to put the source distribution archive(s) in [default: dist]rz.rstz.txtz.mdccs|]}d�|�VqdS)z	README{0}N)�format)�.0Zextrrr�	<genexpr>)szsdist.<genexpr>cCs�|�d�|�d�}|j|_|j�tj�|jd��|��|�	�D]}|�|�qD|�
�t|jdg�}|j
D] }dd|f}||krp|�|�qpdS)N�egg_infozSOURCES.txt�
dist_filesrr)Zrun_command�get_finalized_command�filelist�append�os�path�joinr�check_readmeZget_sub_commands�make_distribution�getattr�distributionZ
archive_files)�selfZei_cmdZcmd_namer�file�datarrr�run+s



z	sdist.runcCstj�|�|��dS)N)�origr�initialize_options�_default_to_gztar�r rrrr%>szsdist.initialize_optionscCstjdkrdSdg|_dS)N)��rZbetarZgztar)�sys�version_infoZformatsr'rrrr&Cs
zsdist._default_to_gztarc	Cs$|���tj�|�W5QRXdS)z%
        Workaround for #516
        N)�_remove_os_linkr$rrr'rrrrIs
zsdist.make_distributionc
cs^Gdd�d�}ttd|�}zt`Wntk
r6YnXz
dVW5||k	rXttd|�XdS)zG
        In a context, remove and restore os.link if it exists
        c@seZdZdS)z&sdist._remove_os_link.<locals>.NoValueN)�__name__�
__module__�__qualname__rrrr�NoValueWsr0�linkN)rrr1�	Exception�setattr)r0Zorig_valrrrr,Ps
zsdist._remove_os_linkcCsLztj�|�Wn6tk
rFt��\}}}|jjjd�	��YnXdS)N�template)
r$r�
read_templater2r*�exc_info�tb_next�tb_frame�f_locals�close)r �_�tbrrrZ__read_template_hackeszsdist.__read_template_hack)��r=)r(r)r(r�)r(r=)r(r=rcs^|j��rZ|�d�}|j�|���|jjsZ|jD]&\}�}}|j��fdd�|D��q2dS)zgetting python files�build_pycsg|]}tj��|��qSr)rrr)r�filename�Zsrc_dirrr�
<listcomp>�s�z.sdist._add_defaults_python.<locals>.<listcomp>N)rZhas_pure_modulesrr�extendZget_source_filesZinclude_package_dataZ
data_files)r r@r;�	filenamesrrBr�_add_defaults_python|s

�zsdist._add_defaults_pythoncsDz tjrt�|�n
t���Wntk
r>t�d�YnXdS)Nz&data_files contains unexpected objects)rZPY2r�_add_defaults_data_files�super�	TypeErrorr�warnr'��	__class__rrrG�szsdist._add_defaults_data_filescCs8|jD]}tj�|�rdSq|�dd�|j��dS)Nz,standard file not found: should have one of z, )�READMESrr�existsrJr)r �frrrr�s

��zsdist.check_readmecCs^tj�|||�tj�|d�}ttd�rJtj�|�rJt�|�|�	d|�|�
d��|�dS)Nz	setup.cfgr1r)r$r�make_release_treerrr�hasattrrN�unlinkZ	copy_filerZsave_version_info)r Zbase_dir�files�destrrrrP�s
zsdist.make_release_treec	Cs@tj�|j�sdSt�|jd��}|��}W5QRX|d��kS)NF�rbz+# file GENERATED by distutils, do NOT edit
)rr�isfile�manifest�io�open�readline�encode)r �fpZ
first_linerrr�_manifest_is_not_generated�s�z sdist._manifest_is_not_generatedc	Cs�t�d|j�t|jd�}|D]d}tjr^z|�d�}Wn&tk
r\t�d|�YqYnX|�	�}|�
d�s|svq|j�|�q|�
�dS)z�Read the manifest file (named by 'self.manifest') and use it to
        fill in 'self.filelist', the list of files to include in the source
        distribution.
        zreading manifest file '%s'rUzUTF-8z"%r not UTF-8 decodable -- skipping�#N)r�inforWrYrZPY3�decode�UnicodeDecodeErrorrJ�strip�
startswithrrr:)r rW�linerrr�
read_manifest�s
zsdist.read_manifestcCs^|j�d�}|�dd�\}}|dkr2t�d�dStj�|�sNt�d|�dS|j	�
|�dS)zyChecks if license_file' is configured and adds it to
        'self.filelist' if the value contains a valid path.
        Zmetadata�license_file)NNNz''license_file' option was not specifiedz8warning: Failed to find the configured license file '%s')rZget_option_dict�getr�debugrrrNrJrr)r Zoptsr;rfrrr�
check_license�s
�zsdist.check_license)r-r.r/�__doc__Zuser_optionsZnegative_optZREADME_EXTENSIONS�tuplerMr#r%r&r�staticmethod�
contextlib�contextmanagerr,Z_sdist__read_template_hackr*r+Zhas_leaky_handler5rFrGrrPr]reri�
__classcell__rrrKrrs<�
��	


r)r)Z	distutilsrZdistutils.command.sdistZcommandrr$rr*rXrmZsetuptools.externrZ
py36compatrr�listZ_default_revctrlr
rrrr�<module>s
site-packages/setuptools/command/__pycache__/build_ext.cpython-38.opt-1.pyc000064400000023211151446177000022705 0ustar00U

�Qab�2�
@s�ddlZddlZddlZddlmZddlmZddlm	Z	ddl
mZmZddl
mZddlmZddlmZdd	lmZejr�ddlZd
d�e��D�ZnddlmZzddlmZed
�Wnek
r�eZYnXed�ddl
mZdd�Z dZ!dZ"dZ#ej$dk�rdZ"n>ej%dk�rTzddl&Z&e'e&d�Z"Z!Wnek
�rRYnXdd�Z(dd�Z)Gdd�de�Ze"�s�ej%dk�r�d"dd�Z*nd Z#d#d!d�Z*dS)$�N)�	build_ext)�	copy_file)�new_compiler)�customize_compiler�get_config_var)�DistutilsError)�log)�Library)�sixcCs g|]\}}}|tjkr|�qS�)�impZC_EXTENSION)�.0�s�_�tprr�@/usr/lib/python3.8/site-packages/setuptools/command/build_ext.py�
<listcomp>s
r��EXTENSION_SUFFIXESzCython.Compiler.Main�LDSHARED)�_config_varsc	CsZtjdkrNt��}z$dtd<dtd<dtd<t|�W5t��t�|�Xnt|�dS)N�darwinz0gcc -Wl,-x -dynamiclib -undefined dynamic_lookuprz -dynamiclibZCCSHAREDz.dylibZSO)�sys�platform�_CONFIG_VARS�copy�clear�updater)�compilerZtmprrr�_customize_compiler_for_shlib#s
�rFZsharedrT�nt�RTLD_NOWcCstr|SdS)N�)�	have_rtld)rrrr�<lambda>D�r$cCs.tD]$}d|kr|S|dkr|SqdS)z;Return the file extension for an abi3-compliant Extension()z.abi3z.pydNr)�suffixrrr�get_abi3_suffixGs
r'c@sveZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zddd�ZdS)rcCs.|jd}|_t�|�||_|r*|��dS)z;Build extensions in build directory, then copy if --inplacerN)Zinplace�
_build_ext�run�copy_extensions_to_source)�selfZold_inplacerrrr)Qs

z
build_ext.runc
Cs�|�d�}|jD]�}|�|j�}|�|�}|�d�}d�|dd��}|�|�}tj	�|tj	�
|��}tj	�|j|�}	t|	||j
|jd�|jr|�|p�tj|d�qdS)N�build_py�.���)�verbose�dry_runT)�get_finalized_command�
extensions�get_ext_fullname�name�get_ext_filename�split�joinZget_package_dir�os�path�basename�	build_librr/r0�_needs_stub�
write_stub�curdir)
r+r,�ext�fullname�filename�modpath�packageZpackage_dirZ
dest_filenameZsrc_filenamerrrr*Ys&





��z#build_ext.copy_extensions_to_sourcecCs�t�||�}||jkr�|j|}tjo4t|d�o4t�}|r^td�}|dt|��}|t�}t	|t
�r�tj�
|�\}}|j�|t�Str�|jr�tj�|�\}}tj�|d|�S|S)NZpy_limited_apiZ
EXT_SUFFIXzdl-)r(r5�ext_mapr
ZPY3�getattrr'r�len�
isinstancer	r8r9�splitext�shlib_compiler�library_filename�libtype�	use_stubs�_links_to_dynamicr6r7)r+r@rAr?Zuse_abi3Zso_ext�fn�drrrr5os&

��


zbuild_ext.get_ext_filenamecCs t�|�d|_g|_i|_dS�N)r(�initialize_optionsrI�shlibsrD�r+rrrrQ�s
zbuild_ext.initialize_optionscCs,t�|�|jpg|_|�|j�dd�|jD�|_|jrB|��|jD]}|�|j�|_qH|jD]�}|j}||j	|<||j	|�
d�d<|jr�|�|�p�d}|o�to�t
|t�}||_||_|�|�}|_tj�tj�|j|��}|�r||jk�r|j�|�|rbtrbtj|jkrb|j�tj�qbdS)NcSsg|]}t|t�r|�qSr)rGr	�r
r?rrrr�s
�z.build_ext.finalize_options.<locals>.<listcomp>r-r.F)r(�finalize_optionsr2Zcheck_extensions_listrR�setup_shlib_compilerr3r4�
_full_namerDr6�links_to_dynamicrLrGr	rMr<r5�
_file_namer8r9�dirnamer7r;�library_dirs�appendr>�runtime_library_dirs)r+r?r@Zltd�nsrAZlibdirrrrrU�s,



zbuild_ext.finalize_optionscCs�t|j|j|jd�}|_t|�|jdk	r8|�|j�|jdk	r^|jD]\}}|�	||�qH|j
dk	r~|j
D]}|�|�qn|jdk	r�|�
|j�|jdk	r�|�|j�|jdk	r�|�|j�|jdk	r�|�|j�t�|�|_dS)N)rr0�force)rrr0r_rIrZinclude_dirsZset_include_dirsZdefineZdefine_macroZundefZundefine_macro�	librariesZ
set_librariesr[Zset_library_dirsZrpathZset_runtime_library_dirsZlink_objectsZset_link_objects�link_shared_object�__get__)r+rr4�valueZmacrorrrrV�s.�







zbuild_ext.setup_shlib_compilercCst|t�r|jSt�||�SrP)rGr	�export_symbolsr(�get_export_symbols�r+r?rrrre�s
zbuild_ext.get_export_symbolscCs\|��|j}z@t|t�r"|j|_t�||�|jrL|�d�j	}|�
||�W5||_XdS)Nr,)Z_convert_pyx_sources_to_langrrGr	rIr(�build_extensionr<r1r;r=)r+r?Z	_compiler�cmdrrrrg�s
zbuild_ext.build_extensioncsPt�dd�|jD���d�|j�d�dd�dg��t��fdd�|jD��S)	z?Return true if 'ext' links to a dynamic lib in the same packagecSsg|]
}|j�qSr)rW)r
�librrrr�sz.build_ext.links_to_dynamic.<locals>.<listcomp>r-Nr.r"c3s|]}�|�kVqdSrPr)r
Zlibname�ZlibnamesZpkgrr�	<genexpr>�sz-build_ext.links_to_dynamic.<locals>.<genexpr>)�dict�fromkeysrRr7rWr6�anyr`rfrrjrrX�s zbuild_ext.links_to_dynamiccCst�|�|��SrP)r(�get_outputs�_build_ext__get_stubs_outputsrSrrrro�szbuild_ext.get_outputscs6�fdd��jD�}t�|����}tdd�|D��S)Nc3s0|](}|jrtjj�jf|j�d���VqdS)r-N)r<r8r9r7r;rWr6rTrSrrrk�s�z0build_ext.__get_stubs_outputs.<locals>.<genexpr>css|]\}}||VqdSrPr)r
�baseZfnextrrrrk�s)r2�	itertools�product�!_build_ext__get_output_extensions�list)r+Zns_ext_basesZpairsrrSrZ__get_stubs_outputs�s

�zbuild_ext.__get_stubs_outputsccs"dVdV|�d�jrdVdS)N�.pyz.pycr,z.pyo)r1�optimizerSrrrZ__get_output_extensions�sz!build_ext.__get_output_extensionsFcCs,t�d|j|�tjj|f|j�d���d}|rJtj�|�rJt|d��|j	s�t
|d�}|�d�ddd	td
�dtj�
|j�dd
dtd�dddtd�ddtd�dddg��|��|�r(ddlm}||gdd|j	d�|�d�j}|dk�r||g|d|j	d�tj�|��r(|j	�s(t�|�dS)Nz writing stub loader for %s to %sr-rvz already exists! Please delete.�w�
zdef __bootstrap__():z-   global __bootstrap__, __file__, __loader__z%   import sys, os, pkg_resources, impz, dlz:   __file__ = pkg_resources.resource_filename(__name__,%r)z   del __bootstrap__z    if '__loader__' in globals():z       del __loader__z#   old_flags = sys.getdlopenflags()z   old_dir = os.getcwd()z   try:z(     os.chdir(os.path.dirname(__file__))z$     sys.setdlopenflags(dl.RTLD_NOW)z(     imp.load_dynamic(__name__,__file__)z   finally:z"     sys.setdlopenflags(old_flags)z     os.chdir(old_dir)z__bootstrap__()r"r)�byte_compileT)rwr_r0Zinstall_lib)r�inforWr8r9r7r6�existsrr0�open�write�if_dlr:rY�closeZdistutils.utilrzr1rw�unlink)r+�
output_dirr?�compileZ	stub_file�frzrwrrrr=�sb
��

����
�zbuild_ext.write_stubN)F)�__name__�
__module__�__qualname__r)r*r5rQrUrVrergrXrorprtr=rrrrrPs
	rc

Cs(|�|j|||||||||	|
||�
dSrP)�linkZSHARED_LIBRARY)
r+�objects�output_libnamer�r`r[r]rd�debug�
extra_preargs�extra_postargs�
build_temp�target_langrrrra#s�raZstaticc
CsRtj�|�\}}
tj�|
�\}}|�d��d�r<|dd�}|�|||||�dS)N�xri�)r8r9r6rHrJ�
startswithZcreate_static_lib)r+r�r�r�r`r[r]rdr�r�r�r�r�rAr:r?rrrra2s�)
NNNNNrNNNN)
NNNNNrNNNN)+r8rrrZdistutils.command.build_extrZ
_du_build_extZdistutils.file_utilrZdistutils.ccompilerrZdistutils.sysconfigrrZdistutils.errorsrZ	distutilsrZsetuptools.extensionr	Zsetuptools.externr
ZPY2rZget_suffixesrZimportlib.machineryZCython.Distutils.build_extr(�
__import__�ImportErrorrrrr#rLrKrr4Zdl�hasattrrr'rarrrr�<module>sz
	Q�
�site-packages/setuptools/command/__pycache__/easy_install.cpython-38.opt-1.pyc000064400000177432151446177000023434 0ustar00U

�Qab�U�@s4dZddlmZddlmZddlmZmZddlmZmZm	Z	m
Z
ddlmZm
Z
ddlmZmZddlmZdd	lmZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
lZdd
l Z dd
l!Z!dd
l"Z"dd
l#Z#dd
l$Z$dd
l%Z%ddl&m'Z'm(Z(ddl)m*Z*dd
l+m,Z,ddl-m.Z.m/Z/ddl)m0Z0ddl1m2Z2ddl3m4Z4ddl5m6Z6ddl7m8Z8ddl9m:Z:m;Z;m<Z<ddl5m=Z=m>Z>ddl?m@Z@ddlAmBZBmCZCmDZDmEZEmFZFmGZGmHZHmIZImJZJmKZKmLZLmMZMmNZNmOZOmPZPdd
lQZAeRZSejTdeAjUd�ddddddgZVd d!�ZWd"d�ZXe,jY�rBd#d$�ZZd%d&�Z[nd'd$�ZZd(d&�Z[d)d*�Z\Gd+d�de0�Z]d,d-�Z^d.d/�Z_d0d1�Z`d2d�Zad3d�ZbGd4d�deH�ZcGd5d6�d6ec�Zdeje�fd7d8�d9k�r�edZcd:d;�Zgd<d=�Zhd>d?�Zid@dA�ZjdsdBdC�ZkdDdE�ZldFdG�ZmdHejnk�remZondIdJ�ZodtdLdM�ZpdNdO�ZqdPdQ�ZrdRdS�ZszddTlmtZuWnevk
�rndUdV�ZuYnXdWdX�ZtGdYdZ�dZew�Zxex�y�ZzGd[d\�d\ex�Z{Gd]d^�d^�Z|Gd_d`�d`e|�Z}Gdadb�dbe}�Z~e|jZe|j�Z�dcdd�Z�dedf�Z�dgehfdhdi�Z�djdk�Z�dldm�Z�dudnd�Z�e"j�dodp��Z�Gdqdr�dre*�Z�d
S)va%
Easy Install
------------

A tool for doing automatic download/extract/build of distutils-based Python
packages.  For detailed documentation, see the accompanying EasyInstall.txt
file, or visit the `EasyInstall home page`__.

__ https://setuptools.readthedocs.io/en/latest/easy_install.html

�)�glob)�get_platform)�convert_path�
subst_vars)�DistutilsArgError�DistutilsOptionError�DistutilsError�DistutilsPlatformError)�INSTALL_SCHEMES�SCHEME_KEYS)�log�dir_util)�
first_line_re)�find_executableN)�get_config_vars�get_path)�SetuptoolsDeprecationWarning)�six)�configparser�map)�Command)�	run_setup)�rmtree_safe)�setopt)�unpack_archive)�PackageIndex�parse_requirement_arg�
URL_SCHEME)�	bdist_egg�egg_info)�Wheel)�yield_lines�normalize_path�resource_string�ensure_directory�get_distribution�find_distributions�Environment�Requirement�Distribution�PathMetadata�EggMetadata�
WorkingSet�DistributionNotFound�VersionConflict�DEVELOP_DIST�default)�category�samefile�easy_install�PthDistributions�extract_wininst_cfg�main�get_exe_prefixescCst�d�dkS)N�P�)�struct�calcsize�r<r<�C/usr/lib/python3.8/site-packages/setuptools/command/easy_install.py�is_64bitOsr>cCsjtj�|�otj�|�}ttjd�o&|}|r:tj�||�Stj�tj�|��}tj�tj�|��}||kS)z�
    Determine if two paths reference the same file.

    Augments os.path.samefile to work on Windows and
    suppresses errors if the path doesn't exist.
    r2)�os�path�exists�hasattrr2�normpath�normcase)Zp1Zp2Z
both_existZuse_samefileZnorm_p1Znorm_p2r<r<r=r2SscCs|S�Nr<��sr<r<r=�	_to_bytesesrHcCs.zt�|d�WdStk
r(YdSXdS�N�asciiTF)rZ	text_type�UnicodeErrorrFr<r<r=�isasciihs
rLcCs
|�d�S)N�utf8)�encoderFr<r<r=rHpscCs,z|�d�WdStk
r&YdSXdSrI)rNrKrFr<r<r=rLss

cCst�|����dd�S)N�
z; )�textwrap�dedent�strip�replace)�textr<r<r=�<lambda>{�rUc@s�eZdZdZdZdZdddddd	d
ddd
dddddddddddgZdddddddd d!g	Zej	r�d"ej
Ze�d#d$ef�e�d#�d%diZ
eZd&d'�Zd(d)�Zd*d+�Zed,d-��Zd.d/�Zd0d1�Zd2d3�Zd4d5�Zd6d7�Zd8d9�Zd:d;�Zd<d=�Zd>d?�Ze�d@�� �Z!e�dA�� �Z"e�dB�� �Z#dCdD�Z$dEdF�Z%dGdH�Z&dIdJ�Z'dKdL�Z(dMdN�Z)e*j+dOdP��Z,d�dRdS�Z-d�dTdU�Z.dVdW�Z/d�dXdY�Z0dZd[�Z1d\d]�Z2d^d_�Z3d�d`da�Z4edbdc��Z5d�dfdg�Z6dhdi�Z7djdk�Z8dldm�Z9dndo�Z:dpdq�Z;drds�Z<e�dt�� �Z=e�du�Z>d�dwdx�Z?e�dy�� �Z@dzd{�ZAd|d}�ZBd~d�ZCd�d��ZDd�d��ZEd�d��ZFd�d��ZGd�d��ZHe�d��� �ZId�d��ZJd�d��ZKd�d��ZLeMeMd�d�d��d��ZNeMd�d�d��ZOd�d��ZPd$S)�r3z'Manage a download/build/install processz Find/get/install Python packagesT)zprefix=Nzinstallation prefix)�zip-ok�zzinstall package as a zipfile)�
multi-version�mz%make apps have to require() a version)�upgrade�Uz1force upgrade (searches PyPI for latest versions))zinstall-dir=�dzinstall package to DIR)zscript-dir=rGzinstall scripts to DIR)�exclude-scripts�xzDon't install scripts)�always-copy�az'Copy all needed packages to install dir)z
index-url=�iz base URL of Python Package Index)zfind-links=�fz(additional URL(s) to search for packages)zbuild-directory=�bz/download/extract/build in DIR; keep the results)z	optimize=�Ozlalso compile with optimization: -O1 for "python -O", -O2 for "python -OO", and -O0 to disable [default: -O0])zrecord=Nz3filename in which to record list of installed files)�always-unzip�Zz*don't install as a zipfile, no matter what)z
site-dirs=�Sz)list of directories where .pth files work)�editable�ez+Install specified packages in editable form)�no-deps�Nzdon't install dependencies)zallow-hosts=�Hz$pattern(s) that hostnames must match)�local-snapshots-ok�lz(allow building eggs from local checkouts)�versionNz"print version information and exit)z
no-find-linksNz9Don't load find-links defined in packages being installedrWrYr^r[r`rirkrnrpz!install in user site-package '%s'�userNrfcCs,d|_d|_|_d|_|_|_d|_d|_d|_d|_	d|_
|_d|_|_
|_d|_|_|_d|_|_|_d|_d|_d|_d|_d|_d|_d|_d|_d|_tjr�tj |_!tj"|_#nd|_!d|_#d|_$d|_%d|_&|_'d|_(i|_)d|_*d|_+|j,j-|_-|j,�.||j,�/d��dS)NrFr3)0rq�zip_ok�local_snapshots_ok�install_dir�
script_dir�exclude_scripts�	index_url�
find_links�build_directory�args�optimize�recordr[�always_copy�
multi_versionri�no_deps�allow_hosts�root�prefix�	no_reportrp�install_purelib�install_platlib�install_headers�install_lib�install_scripts�install_data�install_base�install_platbase�site�ENABLE_USER_SITE�	USER_BASE�install_userbase�	USER_SITE�install_usersite�
no_find_links�
package_index�pth_file�always_copy_from�	site_dirs�installed_projects�sitepy_installedZ_dry_run�distribution�verboseZ_set_command_options�get_option_dict��selfr<r<r=�initialize_options�sJ


�zeasy_install.initialize_optionscCs"dd�|D�}tt|j|��dS)Ncss*|]"}tj�|�stj�|�r|VqdSrE)r?r@rA�islink)�.0�filenamer<r<r=�	<genexpr>�s�z/easy_install.delete_blockers.<locals>.<genexpr>)�listr�_delete_path)r��blockersZextant_blockersr<r<r=�delete_blockers�s�zeasy_install.delete_blockerscCsJt�d|�|jrdStj�|�o.tj�|�}|r8tntj}||�dS)NzDeleting %s)	r�info�dry_runr?r@�isdirr��rmtree�unlink)r�r@Zis_treeZremoverr<r<r=r��szeasy_install._delete_pathcCs4djtj�}td�}d}t|jft���t��dS)zT
        Render the Setuptools version and installation details, then exit.
        �{}.{}�
setuptoolsz=setuptools {dist.version} from {dist.location} (Python {ver})N)�format�sys�version_infor%�print�locals�
SystemExit)Zver�dist�tmplr<r<r=�_render_version�s
zeasy_install._render_versionc	Csh|jo|��tj��d}tdd�\}}|j��|j��|j��||dd�|d|d||||t	tdd�d�|_
tjr�|j
|j
d	<|j|j
d
<|��|��|��|�ddd
d�|jdkr�|j|_|jdkr�d|_|�dd�|�dd�|j�r|j�r|j|_|j|_|�dd�tttj�}t�|_|jdk	�r�dd�|j�d�D�}|D]N}t j�!|��s|t"�#d|�n,t|�|k�r�t$|d��n|j�%t|���q\|j&�s�|�'�|j(�p�d|_(|jdd�|_)|jt|j�fD] }||j)k�r�|j)�*d|��q�|j+dk	�r0dd�|j+�d�D�}ndg}|j,dk�rX|j-|j(|j)|d�|_,t.|j)tj�|_/|j0dk	�r�t1|j0t2j3��r�|j0��|_0ng|_0|j4�r�|j,�5|j)tj�|j�s�|j,�6|j0�|�dd�t1|j7t8��s6z0t8|j7�|_7d|j7k�rdk�snt9�Wnt9k
�r4t$d ��YnX|j&�rN|j:�sNt;d!��|j<�s^t;d"��g|_=dS)#Nrr��exec_prefix���abiflags�)Z	dist_nameZdist_versionZ
dist_fullname�
py_versionZpy_version_shortZpy_version_nodotZ
sys_prefixr�Zsys_exec_prefixr�r��userbaseZusersitertruryr�Fr�)rtrtr��rtru�install)r|r|cSsg|]}tj�|����qSr<)r?r@�
expanduserrR�r�rGr<r<r=�
<listcomp>8sz1easy_install.finalize_options.<locals>.<listcomp>�,z"%s (in --site-dirs) does not existz$ (in --site-dirs) is not on sys.pathzhttps://pypi.org/simple/cSsg|]}|���qSr<)rRr�r<r<r=r�Ns�*)Zsearch_path�hosts)r{r{z--optimize must be 0, 1, or 2z9Must specify a build directory (-b) when using --editablez:No urls, filenames, or requirements specified (see --help))>rpr�r��splitrr�Zget_nameZget_versionZget_fullname�getattr�config_varsr�r�r�r��_fix_install_dir_for_user_site�expand_basedirs�expand_dirs�_expandrurtr�Zset_undefined_optionsrqr�r�rr"r@�
get_site_dirs�
all_site_dirsr�r?r�r�warnr�appendri�check_site_dirrw�shadow_path�insertr�r��create_indexr'�local_indexrx�
isinstancerZstring_typesrsZscan_egg_links�add_find_linksr{�int�
ValueErrorryrrz�outputs)	r�r�r�r�rCr�r]Z	path_itemr�r<r<r=�finalize_options�s�

��

��
�����zeasy_install.finalize_optionscCs\|jrtjsdS|��|jdkr.d}t|��|j|_|_tj	�
dd�d}|�|�dS)z;
        Fix the install_dir if "--user" was used.
        Nz$User base directory is not specified�posixZunixZ_user)rqr�r��create_home_pathr�r	r�r�r?�namerS�
select_scheme)r��msgZscheme_namer<r<r=r�ss
z+easy_install._fix_install_dir_for_user_sitecCsX|D]N}t||�}|dk	rtjdks.tjdkr:tj�|�}t||j�}t|||�qdS)Nr��nt)r�r?r�r@r�rr��setattr)r��attrs�attr�valr<r<r=�
_expand_attrs�s
zeasy_install._expand_attrscCs|�dddg�dS)zNCalls `os.path.expanduser` on install_base, install_platbase and
        root.r�r�r�N�r�r�r<r<r=r��szeasy_install.expand_basedirscCsddddddg}|�|�dS)z+Calls `os.path.expanduser` on install dirs.r�r�r�r�r�r�Nr�)r��dirsr<r<r=r��s�zeasy_install.expand_dirsc	Cs�|j|jjkrt�|j�z�|jD]}|�||j�q"|jr�|j}|j	rzt
|j	�}tt
|��D]}|||d�||<q`ddlm
}|�|j|j|fd|j�|��W5t�|jj�XdS)Nr)�	file_utilz'writing list of installed files to '%s')r�r�r�
set_verbosityrzr3rr|r�r��len�range�	distutilsr��executeZ
write_file�warn_deprecated_options)r��specr�Zroot_lenZcounterr�r<r<r=�run�s*

��zeasy_install.runcCsDzt��}Wn"tk
r.t�dtj�}YnXtj�|j	d|�S)z�Return a pseudo-tempname base in the install directory.
        This code is intentionally naive; if a malicious party can write to
        the target directory you're already in deep doodoo.
        rztest-easy-install-%s)
r?�getpid�	Exception�randomZrandintr��maxsizer@�joinrt)r��pidr<r<r=�pseudo_tempname�s
zeasy_install.pseudo_tempnamecCsdSrEr<r�r<r<r=r��sz$easy_install.warn_deprecated_optionsc	CsZt|j�}tj�|d�}tj�|�sTzt�|�Wn ttfk
rR|�	�YnX||j
k}|sr|jsr|��}nd|�
�d}tj�|�}z*|r�t�|�t|d���t�|�Wn ttfk
r�|�	�YnX|s�|js�t|����|�r|jdk�rt||j
�|_nd|_|ttt��k�r.d|_n"|j�rPtj�|��sPd|_d|_||_dS)z;Verify that self.install_dir is .pth-capable dir, if needed�easy-install.pthz.write-test�wNT)r"rtr?r@r�rA�makedirs�OSError�IOError�cant_write_to_targetr�r~�check_pth_processingr�r��open�closer�no_default_version_msgr�r4r�_pythonpathr�)r��instdirr�Zis_site_dirZtestfileZtest_existsr<r<r=r��s>





zeasy_install.check_site_diraS
        can't create or remove files in install directory

        The following error occurred while trying to add or remove files in the
        installation directory:

            %s

        The installation directory you specified (via --install-dir, --prefix, or
        the distutils default setting) was:

            %s
        z�
        This directory does not currently exist.  Please create it and try again, or
        choose a different installation directory (using the -d or --install-dir
        option).
        a�
        Perhaps your account does not have write access to this directory?  If the
        installation directory is a system-owned directory, you may need to sign in
        as the administrator or "root" account.  If you do not have administrative
        access to this machine, you may wish to choose a different installation
        directory, preferably one that is listed in your PYTHONPATH environment
        variable.

        For information on other options, you may wish to consult the
        documentation at:

          https://setuptools.readthedocs.io/en/latest/easy_install.html

        Please make the appropriate changes for your system and try again.
        cCsP|jt��d|jf}tj�|j�s6|d|j7}n|d|j7}t	|��dS)N�rO)
�_easy_install__cant_write_msgr��exc_infortr?r@rA�_easy_install__not_exists_id�_easy_install__access_msgr)r�r�r<r<r=r�s
z!easy_install.cant_write_to_targetc
	Cs�|j}t�d|�|��d}|d}tj�|�}td�d}z8|rNt�|�tj�	|�}t
jj|dd�t
|d�}Wn ttfk
r�|��Yn�Xz�|�|jft���|��d	}tj}tjd
k�rtj�|�\}}	tj�|d�}
|	��dk�otj�|
�}|�r|
}d
dlm}||dddgd
�tj�|��rNt�d|�W�dSW5|�r`|��tj�|��rxt�|�tj�|��r�t�|�X|j�s�t�d|�dS)z@Empirically verify whether .pth files are supported in inst. dirz Checking .pth file support in %s�.pthz.okzz
            import os
            f = open({ok_file!r}, 'w')
            f.write('OK')
            f.close()
            rOT)�exist_okr�Nr��pythonw.exe�
python.exer)�spawnz-Ez-c�passz-TEST PASSED: %s appears to support .pth filesz+TEST FAILED: %s does NOT support .pth filesF)rtrr�r�r?r@rA�
_one_linerr��dirname�
pkg_resourcesZ
py31compatr�rr�r�r�r�writer�r�r��
executabler�r�r��lower�distutils.spawnrr~r�)
r�rr�Zok_fileZ	ok_existsr�rrcr�basenameZaltZuse_altrr<r<r=r�s\�

��
z!easy_install.check_pth_processingc	CsV|jsH|�d�rH|�d�D],}|�d|�r.q|�|||�d|��q|�|�dS)z=Write all the scripts for `dist`, unless scripts are excluded�scriptszscripts/N)rvZmetadata_isdirZmetadata_listdir�install_scriptZget_metadata�install_wrapper_scripts)r�r��script_namer<r<r=�install_egg_scriptsYs�z easy_install.install_egg_scriptscCsTtj�|�rDt�|�D]*\}}}|D]}|j�tj�||��q$qn|j�|�dSrE)r?r@r��walkr�r�r�)r�r@�baser��filesr�r<r<r=�
add_outputgs
zeasy_install.add_outputcCs|jrtd|f��dS)NzjInvalid argument %r: you can't use filenames or URLs with --editable (except via the --find-links option).)rir�r�r�r<r<r=�not_editableos��zeasy_install.not_editablecCs<|js
dStj�tj�|j|j��r8td|j|jf��dS)Nz2%r already exists in %s; can't do a checkout there)rir?r@rAr�ry�keyrr!r<r<r=�check_editablews
��zeasy_install.check_editablec	cs:tjdd�}zt|�VW5tj�|�o2tt|��XdS)Nz
easy_install-)r�)�tempfile�mkdtempr?r@rAr�r�str)r��tmpdirr<r<r=�_tmpdir�szeasy_install._tmpdirFc
CsH|js|��|����&}t|t�s�t|�rb|�|�|j�||�}|�	d|||d�W5QR�St
j�|�r�|�|�|�	d|||d�W5QR�St
|�}|�|�|j�|||j|j|j|j�}|dkr�d|}|jr�|d7}t|��nJ|jtk�r|�|||d�|W5QR�S|�	||j||�W5QR�SW5QRXdS)NTz+Could not find suitable distribution for %rz2 (--always-copy skips system and development eggs)�Using)ri�install_site_pyr)r�r(rr"r��download�install_itemr?r@rArr$Zfetch_distributionr[r}r�rZ
precedencer/�process_distribution�location)r�r��depsr(�dlr�r�r<r<r=r3�s<



�
zeasy_install.easy_installcCs
|p|j}|ptj�|�|k}|p,|�d�}|pT|jdk	oTtj�t|��t|j�k}|r�|s�|j|jD]}|j	|krjq�qjd}t
�dtj�|��|r�|�
|||�}|D]}|�|||�q�n |�|�g}|�||d|d�|dk	�r|D]}||kr�|Sq�dS)N�.eggTz
Processing %srr*)r}r?r@r�endswithr�r"r��project_namer/rr�r�install_eggsr.�egg_distribution)r�r�r,r(r0Zinstall_neededr�Zdistsr<r<r=r-�s2

��

zeasy_install.install_itemcCs<t|}tD]*}d|}t||�dkrt||||�qdS)z=Sets the install directories by applying the install schemes.Zinstall_N)r
rr�r�)r�r��schemer#�attrnamer<r<r=r��s
zeasy_install.select_schemec
Gs�|�|�|j�|�||j|jkr2|j�|�|j�|�|�|�||j|j<t�	|j
||f|���|�d�r�|js�|j�
|�d��|s�|js�dS|dk	r�|j|jkr�t�d|�dS|dks�||kr�|��}tt|��}t�	d|�ztg��|g|j|j�}Wn^tk
�r<}ztt|���W5d}~XYn0tk
�rj}zt|����W5d}~XYnX|j�s||j�r�|D]"}|j|jk�r�|�|����q�t�	d|�dS)Nzdependency_links.txtzSkipping dependencies for %szProcessing dependencies for %sz'Finished processing dependencies for %s)�
update_pthr��addr�r#�removerr�rr��installation_report�has_metadatar�r�Zget_metadata_linesr}r��as_requirementr(r'r,Zresolver3r-rr.Zreportr�)r�Zrequirementr�r0r�ZdistreqZdistrosrjr<r<r=r.�sL


��
�z!easy_install.process_distributioncCs2|jdk	r|jS|�d�r dS|�d�s.dSdS)Nznot-zip-safeTzzip-safeF)rrr=�r�r�r<r<r=�should_unzips


zeasy_install.should_unzipcCs�tj�|j|j�}tj�|�r:d}t�||j|j|�|Stj�|�rL|}nRtj�	|�|krft�
|�t�|�}t|�dkr�tj�||d�}tj�|�r�|}t
|�t�||�|S)Nz<%r already exists in %s; build directory %s will not be keptrr)r?r@r�ryr#rArr�r�rr��listdirr�r$�shutil�move)r�r��
dist_filename�
setup_base�dstr��contentsr<r<r=�
maybe_moves$�

zeasy_install.maybe_movecCs,|jr
dSt���|�D]}|j|�qdSrE)rv�ScriptWriter�best�get_args�write_script)r�r�rzr<r<r=r"sz$easy_install.install_wrapper_scriptscCsNt|���}t||�}|r8|�|�t�}t�|�|}|�|t|�d�dS)z/Generate a legacy script wrapper and install itrdN)	r'r>�is_python_script�_load_templater�rI�
get_headerrLrH)r�r�r�script_text�dev_pathr�Z	is_scriptZbodyr<r<r=r(s
zeasy_install.install_scriptcCs(d}|r|�dd�}td|�}|�d�S)z�
        There are a couple of template scripts in the package. This
        function loads one of them and prepares it for use.
        zscript.tmplz.tmplz (dev).tmplr��utf-8)rSr#�decode)rQr�Z	raw_bytesr<r<r=rN2s

zeasy_install._load_template�tr<c	s����fdd�|D��t�d|�j�tj��j|�}��|��jrLdSt	�}t
|�tj�|�rpt�|�t
|d|��}|�|�W5QRXt|d|�dS)z1Write an executable file to the scripts directorycsg|]}tj��j|��qSr<)r?r@r�ru�r�r_r�r<r=r�Dsz-easy_install.write_script.<locals>.<listcomp>zInstalling %s script to %sNr�i�)r�rr�rur?r@r�r r��
current_umaskr$rAr�rr�chmod)r�rrG�moder��target�maskrcr<r�r=rLAs�

zeasy_install.write_scriptcCs^|���d�r|�||�gS|���d�r8|�||�gS|���d�rT|�||�gS|}tj�|�r~|�d�s~t|||j	�ntj�
|�r�tj�|�}|�|�r�|j
r�|dk	r�|�|||�}tj�|d�}tj�|��s0ttj�|dd��}|�stdtj�|���t|�dk�r(td	tj�|���|d
}|j�rNt�|�||��gS|�||�SdS)Nr2�.exez.whl�.pyzsetup.pyr�z"Couldn't find a setup script in %srzMultiple setup scripts in %sr)rr3�install_egg�install_exe�
install_wheelr?r@�isfiler�unpack_progressr��abspath�
startswithryrHr�rArrr�rirr��report_editable�build_and_install)r�r�rDr(rE�setup_scriptZsetupsr<r<r=r5UsJ
��
��
��zeasy_install.install_eggscCs>tj�|�r"t|tj�|d��}ntt�|��}tj	||d�S)N�EGG-INFO)�metadata)
r?r@r�r*r�r+�	zipimport�zipimporterr)Z
from_filename)r��egg_pathrhr<r<r=r6�s�zeasy_install.egg_distributionc	Cs�tj�|jtj�|��}tj�|�}|js2t|�|�|�}t	||��sztj�
|�rrtj�|�srtj
||jd�n"tj�|�r�|�tj|fd|�z�d}tj�
|�r�|�|�r�tjd}}ntjd}}nL|�|�r�|�|�|jd}}n*d}|�|��rtjd}}ntjd}}|�|||f|dtj�|�tj�|�f�t||d	�Wn$tk
�rxt|dd	��YnX|�|�|�|�S)
N�r��	Removing FZMovingZCopyingZ
ExtractingTz	 %s to %s��fix_zipimporter_caches)r?r@r�rtrrbr�r$r6r2r�r�r
�remove_treerAr�r�rcrBrCZcopytreer@Zmkpath�unpack_and_compileZcopy2r�update_dist_cachesr�r )r�rkr(�destinationr�Znew_dist_is_zippedrcrZr<r<r=r]�s^
�
�




���

zeasy_install.install_eggcsPt|�}|dkrtd|��td|�dd�|�dd�t�d�}tj�||��d�}||_	|d}tj�|d�}tj�|d	�}t
|�t||�|_|�
||�tj�|��st|d
�}	|	�d�|�d�D].\}
}|
dkr�|	�d
|
�dd���|f�q�|	��tj�|d��|��fdd�t�|�D��tj|||j|jd�|�||�S)Nz(%s is not a valid distutils Windows .exerhr�rp)r4rp�platformr2z.tmprg�PKG-INFOr�zMetadata-Version: 1.0
�target_versionz%s: %s
�_�-rcsg|]}tj��|d��qS)r)r?r@r�)r�rz�rur<r=r��s�z,easy_install.install_exe.<locals>.<listcomp>)r�r�)r5rr)�getrr?r@r��egg_namer/r$r*Z	_provider�
exe_to_eggrArr�itemsrS�titlerr�rIrKrZmake_zipfiler�r�r])r�rDr(�cfgr�rk�egg_tmpZ	_egg_infoZpkg_infrc�k�vr<ryr=r^�sJ�

�

 ��zeasy_install.install_execs6t|��g�g�i������fdd�}t|�|�g}�D]l}|���d�r<|�d�}|d}t�|d�d|d<tjj	�f|��}��
|�|�
|�t�||�q<|���t�
tj�	�d�t��|��dD]Z}	t�|	r�tj�	�d|	d	�}
tj�|
�s�t|
d
�}|�d�	t�|	�d�|��q�dS)
z;Extract a bdist_wininst to the directories an egg would usecs�|��}�D]�\}}|�|�r||t|�d�}|�d�}tjj�f|��}|��}|�d�sj|�d�r�t�	|d�|d<d�tj�
|d�d<��|�n4|�d�r�|dkr�d�tj�
|d�d<��|�|Sq|�d	�s�t�
d
|�dS)N�/�.pyd�.dll���rrr\�SCRIPTS/r
zWARNING: can't process %s)rrcr�r�r?r@r�r3r�strip_module�splitextr�rr�)�srcrFrG�old�new�partsr1�r��native_libs�prefixes�
to_compile�	top_levelr<r=�process�s$




z(easy_install.exe_to_egg.<locals>.processr�r�r�r\rg)r�r�z.txtr�rON)r7rrr3r�rr�r?r@r�r�Z
write_stub�byte_compileZwrite_safety_flagZanalyze_eggr�rArrr)r�rDr�r�Zstubs�resr��resourceZpyfiler�Ztxtrcr<r�r=r|�s8




�

zeasy_install.exe_to_eggc
Cs�t|�}tj�|j|���}tj�|�}|js6t|�tj�	|�r`tj�
|�s`tj||jd�n"tj�
|�r�|�tj|fd|�z.|�|j|fdtj�|�tj�|�f�W5t|dd�X|�|�|�|�S)NrlrmFrnzInstalling %s to %s)r r?r@r�rtr{rbr�r$r�r�r
rprAr�r�rrZinstall_as_eggrrr r6)r�Z
wheel_pathr(Zwheelrsr<r<r=r_!s2�

��	
zeasy_install.install_wheela(
        Because this distribution was installed --multi-version, before you can
        import modules from this package in an application, you will need to
        'import pkg_resources' and then use a 'require()' call similar to one of
        these examples, in order to select the desired version:

            pkg_resources.require("%(name)s")  # latest installed version
            pkg_resources.require("%(name)s==%(version)s")  # this exact version
            pkg_resources.require("%(name)s>=%(version)s")  # this version or higher
        z�
        Note also that the installation directory must be on sys.path at runtime for
        this to work.  (e.g. by being the application's script directory, by being on
        PYTHONPATH, or by being added to sys.path by your code.)
        �	Installedc	Cs^d}|jr>|js>|d|j7}|jtttj�kr>|d|j7}|j	}|j
}|j}d}|t�S)z9Helpful installation message for display to package usersz
%(what)s %(eggloc)s%(extras)srOr�)
r~r��_easy_install__mv_warningrtrr"r�r@�_easy_install__id_warningr/r4rpr�)	r�Zreqr�Zwhatr�Zegglocr�rpZextrasr<r<r=r<Osz easy_install.installation_reportaR
        Extracted editable version of %(spec)s to %(dirname)s

        If it uses setuptools in its setup script, you can activate it in
        "development" mode by going to that directory and running::

            %(python)s setup.py develop

        See the setuptools documentation for the "develop" command for more info.
        cCs"tj�|�}tj}d|jt�S)NrO)r?r@rr�r�_easy_install__editable_msgr�)r�r�rfr�pythonr<r<r=rdhszeasy_install.report_editablec
Cs�tj�dt�tj�dt�t|�}|jdkrNd|jd}|�dd|�n|jdkrd|�dd�|jrv|�dd	�t	�
d
|t|�dd�d�|��zt
||�Wn6tk
r�}ztd|jdf��W5d}~XYnXdS)
Nzdistutils.command.bdist_eggzdistutils.command.egg_infor�r�rrrx�-qz-nz
Running %s %s� zSetup script exited with %s)r��modules�
setdefaultrrr�r�r�r�rr�r�r�rr�rrz)r�rfrErzr�r<r<r=rms&

�zeasy_install.run_setupc		Cs�ddg}tjdtj�|�d�}z�|�	tj�|��|�
|�|�|||�t|g�}g}|D]&}||D]}|�
|�
|j|��qhq\|s�|js�t�d|�|W�St|�t�|j�XdS)Nrz
--dist-dirz
egg-dist-tmp-)r��dirz+No eggs found in %s (setup script problem?))r%r&r?r@rr�rr�r��_set_fetcher_optionsr�rr'r]r/r�r�)	r�rfrErzZdist_dirZall_eggsZeggsr#r�r<r<r=re�s*
�


�zeasy_install.build_and_installc	Csp|j�d���}d}i}|��D]&\}}||kr2q |d||�dd�<q t|d�}tj�|d�}t	�
||�dS)	a
        When easy_install is about to run bdist_egg on a source dist, that
        source dist might have 'setup_requires' directives, requiring
        additional fetching. Ensure the fetcher options given to easy_install
        are available to that command as well.
        r3)rxr�rwr{r�rrwrx)r3z	setup.cfgN)r�r��copyr}rS�dictr?r@r�rZedit_config)	r�rZei_optsZfetch_directivesZ
fetch_optionsr#r�ZsettingsZcfg_filenamer<r<r=r��s	
z!easy_install._set_fetcher_optionscCs*|jdkrdS|j|jD]H}|js0|j|jkrt�d|�|j�|�|j|jkr|j�|j�q|js�|j|jjkr�t�d|�n2t�d|�|j�	|�|j|jkr�|j�
|j�|j�s&|j��|jdk�r&t
j�|jd�}t
j�|�r�t
�|�t|d�}|�|j�|j�d�|��dS)Nz&Removing %s from easy-install.pth filez4%s is already the active version in easy-install.pthz"Adding %s to easy-install.pth filer��setuptools.pth�wtrO)r�r#r~r/rr�r;r��pathsr:r�r��saver?r@r�rtr�r�rr�
make_relativer)r�r�r]r�rcr<r<r=r9�s6
�


zeasy_install.update_pthcCst�d||�|S)NzUnpacking %s to %s)r�debug)r�r�rFr<r<r=ra�szeasy_install.unpack_progresscsdg�g����fdd�}t|||������js`�D]&}t�|�tjdBd@}t||�q8dS)NcsZ|�d�r |�d�s ��|�n|�d�s4|�d�r>��|���||��jrV|pXdS)Nr\�	EGG-INFO/r�z.so)r3rcr�rar�)r�rF�r�Zto_chmodr�r<r=�pf�s
z+easy_install.unpack_and_compile.<locals>.pfimi�)rr�r�r?�stat�ST_MODErW)r�rkrsr�rcrXr<r�r=rq�s
zeasy_install.unpack_and_compilec	Csjtjr
dSddlm}z@t�|jd�||dd|jd�|jrT|||jd|jd�W5t�|j�XdS)Nr)r�r)r{�forcer�)	r��dont_write_bytecode�distutils.utilr�rr�r�r�r{)r�r�r�r<r<r=r��s�
zeasy_install.byte_compilea�
        bad install directory or PYTHONPATH

        You are attempting to install a package to a directory that is not
        on PYTHONPATH and which Python does not read ".pth" files from.  The
        installation directory you specified (via --install-dir, --prefix, or
        the distutils default setting) was:

            %s

        and your PYTHONPATH environment variable currently contains:

            %r

        Here are some of your options for correcting the problem:

        * You can choose a different installation directory, i.e., one that is
          on PYTHONPATH or supports .pth files

        * You can add the installation directory to the PYTHONPATH environment
          variable.  (It must then also be on PYTHONPATH whenever you run
          Python and want to use the package(s) you are installing.)

        * You can set up the installation directory to support ".pth" files by
          using one of the approaches described here:

          https://setuptools.readthedocs.io/en/latest/easy_install.html#custom-installation-locations


        Please make the appropriate changes for your system and try again.cCs|j}||jtj�dd�fS�NZ
PYTHONPATHr�)�_easy_install__no_default_msgrtr?�environrz)r��templater<r<r=rsz#easy_install.no_default_version_msgc	Cs�|jr
dStj�|jd�}tdd�}|�d�}d}tj�|�r�t�	d|j�t
�|��}|��}W5QRX|�
d�s�td	|��||kr�t�d
|�|js�t|�t
j|ddd��}|�|�W5QRX|�|g�d
|_dS)z8Make sure there's a site.py in the target dir, if neededNzsite.pyr�z
site-patch.pyrRr�zChecking existing site.py in %sz
def __boot():z;%s is not a setuptools-generated site.py; please remove it.zCreating %sr���encodingT)r�r?r@r�rtr#rSrArr��ior�readrcrr�r�r$rr�)r�Zsitepy�sourceZcurrentZstrmr<r<r=r+#s0


��zeasy_install.install_site_pycCsd|js
dSttj�d��}t�|j�D]8\}}|�|�r&tj�	|�s&|�
d|�t�|d�q&dS)zCreate directories under ~.N�~zos.makedirs('%s', 0o700)i�)rqrr?r@r�rZ	iteritemsr�rcr�Zdebug_printr�)r��homer�r@r<r<r=r�Cszeasy_install.create_home_pathz/$base/lib/python$py_version_short/site-packagesz	$base/binr��r�z$base/Lib/site-packagesz
$base/ScriptscGs�|�d�j}|jrd|��}|j|d<|j�tj|j�}|�	�D]$\}}t
||d�dkr>t|||�q>ddlm
}|D]B}t
||�}|dk	rt|||�}tjdkr�tj�|�}t|||�qtdS)Nr�rr)rr�)Zget_finalized_commandr�r�r�r
rzr?r��DEFAULT_SCHEMEr}r�r�r�rr@r�)r�r�r�r7r�r�rr<r<r=r�Ys 



zeasy_install._expand)F)F)T)N)rTr<)r�)Q�__name__�
__module__�__qualname__�__doc__�descriptionZcommand_consumes_argumentsZuser_optionsZboolean_optionsr�r�r�Zhelp_msgr�Znegative_optrr�r�r�r��staticmethodr�r�r�r�r�r�r�r�r�r�rPrQ�lstriprrr	r�r�rr r"r$�
contextlib�contextmanagerr)r3r-r�r.r@rHrrrNrLr5r6r]r^r|r_r�r�r<r�rdrrer�r9rarqr�r�rr+r�r�r
r�r�r<r<r<r=r3~s���

0	

z	0	;


$
$	
'	



,6-5

% 
���cCs tj�dd��tj�}td|�Sr�)r?r�rzr��pathsep�filter)r}r<r<r=rpsrc	Cs~g}|�t��tjg}tjtjkr0|�tj�|D]�}|r4tjdkr^|�tj�	|dd��nVtj
dkr�|�tj�	|ddjtj�d�tj�	|dd�g�n|�|tj�	|dd�g�tjdkr4d	|kr4tj
�d
�}|r4tj�	|ddd
jtj�d�}|�|�q4td�td�f}|D]}||k�r|�|��qtj�rB|�tj�z|�t���Wntk
�rjYnXttt|��}|S)z&
    Return a list of 'site' dirs
    )Zos2emxZriscosZLibz
site-packagesr��libzpython{}.{}zsite-python�darwinzPython.framework�HOME�Library�Pythonr�ZpurelibZplatlib)�extendrr�r�r�r�rtr?r@r��sepr�r�r�rzrr�r�r��getsitepackages�AttributeErrorr�rr")�sitedirsr�r�r�Zhome_spZ	lib_pathsZsite_libr<r<r=r�us^


��
�

�
r�ccs�i}|D]�}t|�}||krqd||<tj�|�s4qt�|�}||fV|D]�}|�d�s\qL|dkrfqLttj�||��}tt	|��}|�
�|D]H}|�d�s�t|���}||kr�d||<tj�|�s�q�|t�|�fVq�qLqdS)zBYield sys.path directories that might contain "old-style" packagesrr
)r�r��importN)
r"r?r@r�rAr3rr�r�r!rrc�rstrip)Zinputs�seenrrr�rc�lines�liner<r<r=�expand_paths�s4



r�cCs@t|d�}�z$t�|�}|dkr*W��dS|d|d|d}|dkrRW��dS|�|d�t�d|�d��\}}}|dkr�W��dS|�|d|�d	d	d
�}t�	|�}z<|�|�}	|	�
dd�d
}
|
�t�
��}
|�t�|
��Wntjk
�rYW�.dSX|�d��r"|�d��s*W�dS|W�S|��XdS)znExtract configuration data from a bdist_wininst .exe

    Returns a configparser.RawConfigParser, or None
    �rbN�	���z<iii)izV4i{V4r�)rprv�rrrhZSetup)rr�zipfileZ_EndRecData�seekr:�unpackr�rZRawConfigParserr�rSr��getfilesystemencodingZreadfpr�StringIO�ErrorZhas_section)rDrcZendrecZ	prepended�tagZcfglenZbmlenZinitr�partZconfigr<r<r=r5�s4





c	Cs@dddddg}t�|�}z�|��D]�}|j}|�d�}t|�dkr�|dd	kr�|d
�d�r�|�dd�	|d
d��df��qt|�dks"|�d�s�q"|�d�r�q"|d�
�dkr"|�|�}tj
r�|��}t|�D]8}|���dd�}|�d�s�|�d|d|fdf�q�q"W5|��Xdd�|D�}|��|��|S)z4Get exe->egg path translations for a given .exe file)zPURELIB/r�)zPLATLIB/pywin32_system32r�)zPLATLIB/r�)r�zEGG-INFO/scripts/)zDATA/lib/site-packagesr�r�r�r�rurz	.egg-inforNr�r
z
-nspkg.pth)ZPURELIBZPLATLIB�\r�z%s/%s/r�cSsg|]\}}|��|f�qSr<)r)r�r_�yr<r<r=r�)sz$get_exe_prefixes.<locals>.<listcomp>)r�ZZipFilerZinfolistr�r�r�r3r�r��upperr�rZPY3rSr!rRrSrcr��sort�reverse)Zexe_filenamer�rXr�r�r�rGZpthr<r<r=r7s@�




"
c@sReZdZdZdZddd�Zdd�Zdd	�Zed
d��Z	dd
�Z
dd�Zdd�ZdS)r4z)A .pth file with Distribution paths in itFr<cCsl||_ttt|��|_ttj�|j��|_|�	�t
�|gdd�t|j
�D]}tt|jt|d���qLdS)NT)r�r�rr"r�r?r@r�basedir�_loadr'�__init__r!r�r:r&)r�r�r�r@r<r<r=r�4szPthDistributions.__init__cCs�g|_d}t�|j�}tj�|j�r�t|jd�}|D]�}|�	d�rHd}q4|�
�}|j�|�|��r4|���	d�rtq4t
tj�|j|��}|jd<tj�|�r�||kr�|j��d|_q4d||<q4|��|jr�|s�d|_|jr�|jd��s�|j��q�dS)NFZrtr�T�#r�r)r�r��fromkeysr�r?r@r`r�rrcr�r�rRr"r�r�rA�pop�dirtyr)r�Z
saw_importr�rcr�r@r<r<r=r�=s4
�


zPthDistributions._loadc	Cs�|js
dStt|j|j��}|r�t�d|j�|�|�}d�	|�d}t
j�|j�r`t
�
|j�t|jd��}|�|�W5QRXn(t
j�|j�r�t�d|j�t
�
|j�d|_dS)z$Write changed .pth file back to diskNz	Saving %srOr�zDeleting empty %sF)r�r�rr�r�rr�r��_wrap_linesr�r?r@r�r�rrrA)r�Z	rel_pathsr��datarcr<r<r=r�\s
zPthDistributions.savecCs|SrEr<)r�r<r<r=r�rszPthDistributions._wrap_linescCsN|j|jko$|j|jkp$|jt��k}|r>|j�|j�d|_t�||�dS)z"Add `dist` to the distribution mapTN)	r/r�r�r?�getcwdr�r�r'r:)r�r��new_pathr<r<r=r:vs�zPthDistributions.addcCs2|j|jkr"|j�|j�d|_qt�||�dS)z'Remove `dist` from the distribution mapTN)r/r�r;r�r'r?r<r<r=r;�szPthDistributions.removecCs�tj�t|��\}}t|j�}|g}tjdkr2dp6tj}t|�|kr�||jkrl|�tj	�|�
�|�|�Stj�|�\}}|�|�q8|S)Nr�)r?r@r�r"r�r��altsepr�r��curdirr�r�)r�r@ZnpathZlastZbaselenr�r�r<r<r=r��s


zPthDistributions.make_relativeN)r<)
r�r�r�r�r�r�r�r�r�r�r:r;r�r<r<r<r=r4/s
	
c@s(eZdZedd��Zed�Zed�ZdS)�RewritePthDistributionsccs$|jV|D]
}|Vq|jVdSrE)�prelude�postlude)�clsr�r�r<r<r=r��sz#RewritePthDistributions._wrap_linesz?
        import sys
        sys.__plen = len(sys.path)
        z�
        import sys
        new = sys.path[sys.__plen:]
        del sys.path[sys.__plen:]
        p = getattr(sys, '__egginsert', 0)
        sys.path[p:p] = new
        sys.__egginsert = p + len(new)
        N)r�r�r��classmethodr�rr�r�r<r<r<r=r��s
r�ZSETUPTOOLS_SYS_PATH_TECHNIQUE�rawZrewritecCs ttjt�rtSt�tj���S)z_
    Return a regular expression based on first_line_re suitable for matching
    strings.
    )r�r�patternr'�re�compilerSr<r<r<r=�_first_line_re�srcCsd|tjtjfkr.tjdkr.t|tj�||�St��\}}}t	�
||d|dd||ff�dS)Nr�rrz %s %s)r?r�r;r�rWr��S_IWRITEr�rrZreraise)�func�arg�excZetZevrwr<r<r=�
auto_chmod�s
rcCs.t|�}t|tj�|r"t|�nt|�dS)aa

    Fix any globally cached `dist_path` related data

    `dist_path` should be a path of a newly installed egg distribution (zipped
    or unzipped).

    sys.path_importer_cache contains finder objects that have been cached when
    importing data from the original distribution. Any such finders need to be
    cleared since the replacement distribution might be packaged differently,
    e.g. a zipped egg distribution might get replaced with an unzipped egg
    folder or vice versa. Having the old finders cached may then cause Python
    to attempt loading modules from the replacement distribution using an
    incorrect loader.

    zipimport.zipimporter objects are Python loaders charged with importing
    data packaged inside zip archives. If stale loaders referencing the
    original distribution, are left behind, they can fail to load modules from
    the replacement distribution. E.g. if an old zipimport.zipimporter instance
    is used to load data from a new zipped egg archive, it may cause the
    operation to attempt to locate the requested data in the wrong location -
    one indicated by the original distribution's zip archive directory
    information. Such an operation may then fail outright, e.g. report having
    read a 'bad local file header', or even worse, it may fail silently &
    return invalid data.

    zipimport._zip_directory_cache contains cached zip archive directory
    information for all existing zipimport.zipimporter instances and all such
    instances connected to the same archive share the same cached directory
    information.

    If asked, and the underlying Python implementation allows it, we can fix
    all existing zipimport.zipimporter instances instead of having to track
    them down and remove them one by one, by updating their shared cached zip
    archive directory information. This, of course, assumes that the
    replacement distribution is packaged as a zipped egg.

    If not asked to fix existing zipimport.zipimporter instances, we still do
    our best to clear any remaining zipimport.zipimporter related cached data
    that might somehow later get used when attempting to load data from the new
    distribution and thus cause such load operations to fail. Note that when
    tracking down such remaining stale data, we can not catch every conceivable
    usage from here, and we clear only those that we know of and have found to
    cause problems if left alive. Any remaining caches should be updated by
    whomever is in charge of maintaining them, i.e. they should be ready to
    handle us replacing their zip archives with new distributions at runtime.

    N)r"�_uncacher��path_importer_cache�!_replace_zip_directory_cache_data�*_remove_and_clear_zip_directory_cache_data)Z	dist_pathro�normalized_pathr<r<r=rr�s
<
rrcCsPg}t|�}|D]:}t|�}|�|�r|||d�tjdfkr|�|�q|S)ap
    Return zipimporter cache entry keys related to a given normalized path.

    Alternative path spellings (e.g. those using different character case or
    those using alternative path separators) related to the same path are
    included. Any sub-path entries are included as well, i.e. those
    corresponding to zip archives embedded in other zip archives.

    rr�)r�r"rcr?r�r�)r
�cache�result�
prefix_len�pZnpr<r<r=�"_collect_zipimporter_cache_entriess

�rcCs@t||�D]0}||}||=|o(|||�}|dk	r
|||<q
dS)a�
    Update zipimporter cache data for a given normalized path.

    Any sub-path entries are processed as well, i.e. those corresponding to zip
    archives embedded in other zip archives.

    Given updater is a callable taking a cache entry key and the original entry
    (after already removing the entry from the cache), and expected to update
    the entry and possibly return a new one to be inserted in its place.
    Returning None indicates that the entry should not be replaced with a new
    one. If no updater is given, the cache entries are simply removed without
    any additional processing, the same as if the updater simply returned None.

    N)r)r
r�updaterr�	old_entryZ	new_entryr<r<r=�_update_zipimporter_cache/s
rcCst||�dSrE)r)r
rr<r<r=r	Osr	cCsdd�}t|tj|d�dS)NcSs|��dSrE)�clear�r@rr<r<r=�2clear_and_remove_cached_zip_archive_directory_dataTszf_remove_and_clear_zip_directory_cache_data.<locals>.clear_and_remove_cached_zip_archive_directory_data�r�rri�_zip_directory_cache)r
rr<r<r=rSs�rZ__pypy__cCsdd�}t|tj|d�dS)NcSs&|��t�|�|�tj|�|SrE)rrirj�updaterrr<r<r=�)replace_cached_zip_archive_directory_datajs
zT_replace_zip_directory_cache_data.<locals>.replace_cached_zip_archive_directory_datarr)r
rr<r<r=ris
�r�<string>c	Cs4zt||d�Wnttfk
r*YdSXdSdS)z%Is this string a valid Python script?�execFTN)r�SyntaxError�	TypeError)rTr�r<r<r=�	is_python|s
r"c	CsNz(tj|dd��}|�d�}W5QRXWnttfk
rD|YSX|dkS)zCDetermine if the specified executable is a .sh (contains a #! line)zlatin-1r�r��#!)r�rr�r�r�)r�fp�magicr<r<r=�is_sh�s
r&cCst�|g�S)z@Quote a command line argument according to Windows parsing rules��
subprocess�list2cmdline)rr<r<r=�nt_quote_arg�sr*cCsH|�d�s|�d�rdSt||�r&dS|�d�rDd|��d��kSdS)zMIs this text, as a whole, a Python script? (as opposed to shell/bat/etc.
    r\�.pywTr#r�rF)r3r"rc�
splitlinesr)rPr�r<r<r=rM�s

rM)rWcGsdSrEr<)rzr<r<r=�_chmod�sr-c
CsRt�d||�zt||�Wn0tjk
rL}zt�d|�W5d}~XYnXdS)Nzchanging mode of %s to %ozchmod failed: %s)rr�r-r?�error)r@rXrjr<r<r=rW�s
rWc@s�eZdZdZgZe�Zedd��Zedd��Z	edd��Z
edd	��Zed
d��Zdd
�Z
edd��Zdd�Zedd��Zedd��ZdS)�CommandSpeczm
    A command spec for a #! header, specified as a list of arguments akin to
    those passed to Popen.
    cCs|S)zV
        Choose the best CommandSpec class based on environmental conditions.
        r<�r�r<r<r=rJ�szCommandSpec.bestcCstj�tj�}tj�d|�S)N�__PYVENV_LAUNCHER__)r?r@rCr�rr�rz)r�Z_defaultr<r<r=�_sys_executable�szCommandSpec._sys_executablecCs:t||�r|St|t�r ||�S|dkr0|��S|�|�S)zg
        Construct a CommandSpec from a parameter to build_scripts, which may
        be None.
        N)r�r��from_environment�from_string)r�Zparamr<r<r=�
from_param�s

zCommandSpec.from_paramcCs||��g�SrE)r2r0r<r<r=r3�szCommandSpec.from_environmentcCstj|f|j�}||�S)z}
        Construct a command spec from a simple string representing a command
        line parseable by shlex.split.
        )�shlexr��
split_args)r��stringr}r<r<r=r4�szCommandSpec.from_stringcCs8t�|�|��|_t�|�}t|�s4dg|jdd�<dS)Nz-xr)r6r��_extract_options�optionsr(r)rL)r�rP�cmdliner<r<r=�install_options�s
zCommandSpec.install_optionscCs:|d��d}t��|�}|r.|�d�p0dnd}|��S)zH
        Extract any options from the first line of the script.
        rOrrr�)r,r�match�grouprR)Zorig_script�firstr=r:r<r<r=r9�szCommandSpec._extract_optionscCs|�|t|j��SrE)�_renderr�r:r�r<r<r=�	as_header�szCommandSpec.as_headercCs6d}|D](}|�|�r|�|�r|dd�Sq|S)Nz"'rr�)rcr3)�itemZ_QUOTES�qr<r<r=�
_strip_quotes�s
zCommandSpec._strip_quotescCs t�dd�|D��}d|dS)Ncss|]}t�|���VqdSrE)r/rDrR)r�rBr<r<r=r�sz&CommandSpec._render.<locals>.<genexpr>r#rOr')r}r;r<r<r=r@�s
�zCommandSpec._renderN)r�r�r�r�r:r�r7r�rJr2r5r3r4r<r�r9rArDr@r<r<r<r=r/�s*





	
r/c@seZdZedd�ZdS)�WindowsCommandSpecFr�N)r�r�r�r�r7r<r<r<r=rE
srEc@s�eZdZdZe�d���ZeZ	e
ddd��Ze
ddd��Ze
dd	d
��Z
edd��Ze
d
d��Ze
dd��Ze
dd��Ze
ddd��ZdS)rIz`
    Encapsulates behavior around writing entry point scripts for console and
    gui apps.
    a�
        # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r
        __requires__ = %(spec)r
        import re
        import sys
        from pkg_resources import load_entry_point

        if __name__ == '__main__':
            sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0])
            sys.exit(
                load_entry_point(%(spec)r, %(group)r, %(name)r)()
            )
    NFcCs6t�dt�|rtnt��}|�d||�}|�||�S)NzUse get_argsr�)�warningsr��EasyInstallDeprecationWarning�WindowsScriptWriterrIrJ�get_script_headerrK)r�r�r�wininst�writer�headerr<r<r=�get_script_args$szScriptWriter.get_script_argscCs$tjdtdd�|rd}|�||�S)NzUse get_headerr�)�
stacklevelr
)rFr�rGrO)r�rPrrJr<r<r=rI,szScriptWriter.get_script_headerccs�|dkr|��}t|���}dD]Z}|d}|�|���D]>\}}|�|�|jt�}|�||||�}	|	D]
}
|
Vqlq:q dS)z�
        Yield write_script() argument tuples for a distribution's
        console_scripts and gui_scripts entry points.
        N�Zconsole�guiZ_scripts)	rOr'r>Z
get_entry_mapr}�_ensure_safe_namer�r��_get_script_args)r�r�rLr��type_r>r�ZeprPrzr�r<r<r=rK4s
zScriptWriter.get_argscCst�d|�}|rtd��dS)z?
        Prevent paths in *_scripts entry point names.
        z[\\/]z+Path separators not allowed in script namesN)r�searchr�)r�Zhas_path_sepr<r<r=rQFszScriptWriter._ensure_safe_namecCs t�dt�|rt��S|��S�NzUse best)rFr�rGrHrJ)r�Z
force_windowsr<r<r=�
get_writerOszScriptWriter.get_writercCs.tjdkstjdkr&tjdkr&t��S|SdS)zD
        Select the best ScriptWriter for this environment.
        �win32�javar�N)r�rtr?r��_namerHrJr0r<r<r=rJUszScriptWriter.bestccs|||fVdSrEr<)r�rSr�rLrPr<r<r=rR_szScriptWriter._get_script_argsr�cCs"|j���|�}|�|�|��S)z;Create a #! line, getting options (if any) from script_text)�command_spec_classrJr5r<rA)r�rPr�cmdr<r<r=rOds
zScriptWriter.get_header)NF)NF)N)r�N)r�r�r�r�rPrQr�r�r/rZr�rMrIrKr�rQrVrJrRrOr<r<r<r=rIs&


	
rIc@sLeZdZeZedd��Zedd��Zedd��Zedd��Z	e
d	d
��ZdS)rHcCst�dt�|��SrU)rFr�rGrJr0r<r<r=rVoszWindowsScriptWriter.get_writercCs"tt|d�}tj�dd�}||S)zC
        Select the best ScriptWriter suitable for Windows
        )rZnaturalZSETUPTOOLS_LAUNCHERr)r��WindowsExecutableLauncherWriterr?r�rz)r�Z
writer_lookupZlauncherr<r<r=rJus�zWindowsScriptWriter.bestc	#s�tddd�|}|tjd���d�krBdjft��}t�|t	�dddd	d
ddg}|�
|�|�||�}�fdd
�|D�}�|||d|fVdS)z For Windows, add a .py extensionz.pyar+rOZPATHEXT�;zK{ext} not listed in PATHEXT; scripts will not be recognized as executables.r\�
-script.py�.pyc�.pyor[csg|]}�|�qSr<r<rU�r�r<r=r��sz8WindowsScriptWriter._get_script_args.<locals>.<listcomp>rTN)r�r?r�rr�r�r�rFr��UserWarningr;�_adjust_header)	r�rSr�rLrP�extr�r�r�r<rar=rR�s��
z$WindowsScriptWriter._get_script_argscCsNd}d}|dkr||}}t�t�|�tj�}|j||d�}|�|�rJ|S|S)z�
        Make sure 'pythonw' is used for gui and and 'python' is used for
        console (regardless of what sys.executable is).
        rr
rP)r8�repl)rr�escape�
IGNORECASE�sub�_use_header)r�rSZorig_headerrreZ
pattern_ob�
new_headerr<r<r=rc�s
z"WindowsScriptWriter._adjust_headercCs$|dd��d�}tjdkp"t|�S)z�
        Should _adjust_header use the replaced header?

        On non-windows systems, always use. On
        Windows systems, only use the replaced header if it resolves
        to an executable on the system.
        r�r��"rW)rRr�rtr)rjZclean_headerr<r<r=ri�s	zWindowsScriptWriter._use_headerN)r�r�r�rErZr�rVrJrRrcr�rir<r<r<r=rHls




rHc@seZdZedd��ZdS)r\c#s�|dkrd}d}dg}nd}d}dddg}|�||�}�fd	d
�|D�}	�|||d|	fV�dt|�d
fVt�s��d}
|
t��dfVdS)zG
        For Windows, add a .py extension and an .exe launcher
        rPz-script.pywr+Zclir^r\r_r`csg|]}�|�qSr<r<rUrar<r=r��szDWindowsExecutableLauncherWriter._get_script_args.<locals>.<listcomp>rTr[rdz
.exe.manifestN)rc�get_win_launcherr>�load_launcher_manifest)r�rSr�rLrPZ
launcher_typerdr�Zhdrr�Zm_namer<rar=rR�s"
�z0WindowsExecutableLauncherWriter._get_script_argsN)r�r�r�r�rRr<r<r<r=r\�sr\cCs2d|}t�r|�dd�}n|�dd�}td|�S)z�
    Load the Windows launcher (executable) suitable for launching a script.

    `type` should be either 'cli' or 'gui'

    Returns the executable as a byte string.
    z%s.exe�.z-64.z-32.r�)r>rSr#)�typeZlauncher_fnr<r<r=rl�s
rlcCs0t�td�}tjr|t�S|�d�t�SdS)Nzlauncher manifest.xmlrR)rr#r�r�PY2�varsrS)r�Zmanifestr<r<r=rm�s
rmFcCst�|||�SrE)rBr�)r@�
ignore_errors�onerrorr<r<r=r��sr�cCst�d�}t�|�|S)N�)r?�umask)Ztmpr<r<r=rV�s

rVcCs:ddl}tj�|jd�}|tjd<tj�|�t�dS)Nr)	r�r?r@r�__path__r��argvr�r6)r�Zargv0r<r<r=�	bootstrap�s

rxc	s�ddlm}ddlm�G�fdd�d��}|dkrBtjdd�}t��0|fddd	g|tjdpfd|d
�|��W5QRXdS)Nr)�setup�r)cseZdZdZ�fdd�ZdS)z-main.<locals>.DistributionWithoutHelpCommandsr�c	s(t���j|f|�|�W5QRXdSrE)�_patch_usage�
_show_help)r�rz�kwrzr<r=r|	sz8main.<locals>.DistributionWithoutHelpCommands._show_helpN)r�r�r�Zcommon_usager|r<rzr<r=�DistributionWithoutHelpCommands	sr~rr�r3z-v)Zscript_argsrZ	distclass)r�ryZsetuptools.distr)r�rwr{)rwr}ryr~r<rzr=r6�s��c#sLddl}t�d�����fdd�}|jj}||j_z
dVW5||j_XdS)Nrze
        usage: %(script)s [options] requirement_or_url ...
           or: %(script)s --help
        cs�ttj�|�d�S)N)Zscript)r�r?r@r)r�ZUSAGEr<r=�	gen_usage	s
�z_patch_usage.<locals>.gen_usage)Zdistutils.corerPrQr�Zcorer�)r�r�Zsavedr<rr=r{	s
r{c@seZdZdZdS)rGzuClass for warning about deprecations in EasyInstall in SetupTools. Not ignored by default, unlike DeprecationWarning.N)r�r�r�r�r<r<r<r=rG(	srG)N)r)N)�r�rr�rrrZdistutils.errorsrrrr	Zdistutils.command.installr
rr�rr
Zdistutils.command.build_scriptsrrrr�r?rirBr%r�rr�r�rPrFr�r:r�r(r6r�Z	sysconfigrrr�rZsetuptools.externrZsetuptools.extern.six.movesrrrZsetuptools.sandboxrZsetuptools.py27compatrZsetuptools.commandrZsetuptools.archive_utilrZsetuptools.package_indexrrrrrZsetuptools.wheelr rr!r"r#r$r%r&r'r(r)r*r+r,r-r.r/Zpkg_resources.py31compatroZ
__metaclass__�filterwarningsZ
PEP440Warning�__all__r>r2rprHrLrr3rr�r�r5r7r4r�r�rzrrrrrrr	r�builtin_module_namesrr"r&r*rMrWr-�ImportErrorr�r/r2Zsys_executablerErIrHr\rMrIrlrmr�rVrxr6r�r{rGr<r<r<r=�<module>s�D�
{A))'lR
 �


T^A 


site-packages/setuptools/command/__pycache__/egg_info.cpython-38.pyc000064400000052404151446177000021552 0ustar00U

�Qab�c�@s�dZddlmZddlmZddlmZddlm	Z	ddlZddlZddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ddlm+Z+ddlm,Z,dd�Z-Gdd�d�Z.Gdd�de.e�Z/Gdd�de�ZGdd�de�Z0dd�Z1dd�Z2d d!�Z3d"d#�Z4d$d%�Z5d&d'�Z6d(d)�Z7d*d+�Z8d5d-d.�Z9d/d0�Z:d1d2�Z;Gd3d4�d4e,�Z<dS)6zUsetuptools.command.egg_info

Create a distribution's .egg-info directory and contents�)�FileList)�DistutilsInternalError)�convert_path)�logN)�six)�map)�Command)�sdist)�walk_revctrl)�edit_config)�	bdist_egg)�parse_requirements�	safe_name�
parse_version�safe_version�yield_lines�
EntryPoint�iter_entry_points�to_filename)�glob)�	packaging)�SetuptoolsDeprecationWarningcCs�d}|�tjj�}t�tj�}d|f}t|�D�]�\}}|t|�dk}|dkrr|r`|d7}q0|d||f7}q0d}t|�}	||	k�r�||}
|
dkr�||d7}�n|
d	kr�||7}n�|
d
k�r�|d}||	kr�||dkr�|d}||	k�r||dk�r|d}||	k�r,||dk�r,|d}�q||	k�rF|t�|
�7}nR||d|�}d}
|ddk�rxd
}
|dd�}|
t�|�7}
|d|
f7}|}n|t�|
�7}|d7}q~|s0||7}q0|d7}tj|tj	tj
Bd�S)z�
    Translate a file path glob like '*.txt' in to a regular expression.
    This differs from fnmatch.translate which allows wildcards to match
    directory separators. It also knows about '**/' which matches any number of
    directories.
    �z[^%s]��**z.*z
(?:%s+%s)*r�*�?�[�!�]�^Nz[%s]z\Z)�flags)�split�os�path�sep�re�escape�	enumerate�len�compile�	MULTILINE�DOTALL)rZpatZchunksr%Z
valid_char�c�chunkZ
last_chunk�iZ	chunk_len�charZinner_i�innerZ
char_class�r2�?/usr/lib/python3.8/site-packages/setuptools/command/egg_info.py�translate_pattern$sV







r4c@s8eZdZdZdZedd��Zdd�Zdd�Zee�Z	dS)�
InfoCommonNcCst|j���S�N)r�distributionZget_name��selfr2r2r3�name{szInfoCommon.namecCs2|j��}|jr$|�|j�r$t|�St||j�Sr6)r7Zget_version�vtags�endswithr�r9�versionr2r2r3�tagged_versions
zInfoCommon.tagged_versioncCs,d}|jr||j7}|jr(|t�d�7}|S)Nrz-%Y%m%d)�	tag_build�tag_date�time�strftimer=r2r2r3�tags�s
zInfoCommon.tags)
�__name__�
__module__�__qualname__r@rA�propertyr:r?rDr;r2r2r2r3r5ws
r5c@s�eZdZdZddddgZdgZddiZdd	�Zed
d��Z	e	j
dd��Z	d
d�Zdd�Zddd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZdS) �egg_infoz+create a distribution's .egg-info directory)z	egg-base=�ezLdirectory containing .egg-info directories (default: top of the source tree))�tag-date�dz0Add date stamp (e.g. 20050528) to version number)z
tag-build=�bz-Specify explicit tag to add to version number)�no-date�Dz"Don't include date stamp [default]rKrNcCs"d|_d|_d|_d|_d|_dS)NF)�egg_base�egg_namerI�egg_version�broken_egg_infor8r2r2r3�initialize_options�s
zegg_info.initialize_optionscCsdSr6r2r8r2r2r3�tag_svn_revision�szegg_info.tag_svn_revisioncCsdSr6r2)r9�valuer2r2r3rU�scCs0t��}|��|d<d|d<t|t|d��dS)z�
        Materialize the value of date into the
        build tag. Install build keys in a deterministic order
        to avoid arbitrary reordering on subsequent builds.
        r@rrA)rIN)�collections�OrderedDictrDr�dict)r9�filenamerIr2r2r3�save_version_info�szegg_info.save_version_infocCsB|j|_|��|_t|j�}z6t|tjj�}|r4dnd}t	t
||j|jf��Wn,tk
r~tj
�d|j|jf��YnX|jdkr�|jj}|p�i�dtj�|_|�d�t|j�d|_|jtjkr�tj�|j|j�|_d|jkr�|��|j|jj_|jj}|dk	�r>|j|j��k�r>|j|_t|j�|_ d|j_dS)Nz%s==%sz%s===%sz2Invalid distribution name or version syntax: %s-%srrP�	.egg-info�-)!r:rQr?rRr�
isinstancerr>ZVersion�listr
�
ValueError�	distutils�errorsZDistutilsOptionErrorrPr7Zpackage_dir�getr#�curdirZensure_dirnamerrIr$�join�check_broken_egg_info�metadataZ
_patched_dist�key�lowerZ_versionZ_parsed_version)r9Zparsed_versionZ
is_version�spec�dirsZpdr2r2r3�finalize_options�s>


��
��



zegg_info.finalize_optionsFcCsL|r|�|||�n4tj�|�rH|dkr>|s>t�d||�dS|�|�dS)a�Write `data` to `filename` or delete if empty

        If `data` is non-empty, this routine is the same as ``write_file()``.
        If `data` is empty but not ``None``, this is the same as calling
        ``delete_file(filename)`.  If `data` is ``None``, then this is a no-op
        unless `filename` exists, in which case a warning is issued about the
        orphaned file (if `force` is false), or deleted (if `force` is true).
        Nz$%s not set in setup(), but %s exists)�
write_filer#r$�existsr�warn�delete_file)r9�whatrZ�data�forcer2r2r3�write_or_delete_file�s	�zegg_info.write_or_delete_filecCsDt�d||�tjr|�d�}|js@t|d�}|�|�|��dS)z�Write `data` to `filename` (if not a dry run) after announcing it

        `what` is used in a log message to identify what is being written
        to the file.
        zwriting %s to %s�utf-8�wbN)	r�inforZPY3�encode�dry_run�open�write�close)r9rqrZrr�fr2r2r3rms


zegg_info.write_filecCs t�d|�|jst�|�dS)z8Delete `filename` (if not a dry run) after announcing itzdeleting %sN)rrwryr#�unlink)r9rZr2r2r3rpszegg_info.delete_filecCs�|�|j�t�|jd�|jj}td�D]4}|j|d�|��}|||j	tj
�|j|j	��q*tj
�|jd�}tj
�|�r�|�
|�|��dS)Nzegg_info.writers)�	installerznative_libs.txt)ZmkpathrIr#�utimer7Zfetch_build_eggrZrequireZresolver:r$rernrp�find_sources)r9r�ep�writer�nlr2r2r3�runs
zegg_info.runcCs4tj�|jd�}t|j�}||_|��|j|_dS)z"Generate SOURCES.txt manifest filezSOURCES.txtN)	r#r$rerI�manifest_makerr7�manifestr��filelist)r9Zmanifest_filenameZmmr2r2r3r�*s

zegg_info.find_sourcescCsT|jd}|jtjkr&tj�|j|�}tj�|�rPt�d||j	�|j	|_
||_	dS)Nr\aB------------------------------------------------------------------------------
Note: Your current .egg-info directory has a '-' in its name;
this will not work correctly with "setup.py develop".

Please rename %s to %s to correct this problem.
------------------------------------------------------------------------------)rQrPr#rdr$rernrrorIrS)r9Zbeir2r2r3rf2s
�zegg_info.check_broken_egg_infoN)F)rErFrG�descriptionZuser_optionsZboolean_optionsZnegative_optrTrHrU�setterr[rlrtrmrpr�r�rfr2r2r2r3rI�s.��



1
rIc@s|eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)rcCs |�|�\}}}}|dkrR|�dd�|��|D]}|�|�s2t�d|�q2�n�|dkr�|�dd�|��|D]}|�|�srt�d|�qr�n�|dkr�|�d	d�|��|D]}|�|�s�t�d
|�q��nJ|dk�r|�dd�|��|D]}|�|�s�t�d
|�q�n|dk�r`|�d|d�|�f�|D]"}|�	||��s:t�d||��q:n�|dk�r�|�d|d�|�f�|D]"}|�
||��s�t�d||��q�np|dk�r�|�d|�|�|��st�d|�n>|dk�r|�d|�|�|��st�d|�nt
d|��dS)N�includezinclude � z%warning: no files found matching '%s'�excludezexclude z9warning: no previously-included files found matching '%s'zglobal-includezglobal-include z>warning: no files found matching '%s' anywhere in distributionzglobal-excludezglobal-exclude zRwarning: no previously-included files matching '%s' found anywhere in distributionzrecursive-includezrecursive-include %s %sz:warning: no files found matching '%s' under directory '%s'zrecursive-excludezrecursive-exclude %s %szNwarning: no previously-included files matching '%s' found under directory '%s'�graftzgraft z+warning: no directories found matching '%s'�prunezprune z6no previously-included directories found matching '%s'z'this cannot happen: invalid action '%s')Z_parse_template_line�debug_printrer�rror��global_include�global_exclude�recursive_include�recursive_excluder�r�r)r9�line�actionZpatterns�dirZdir_pattern�patternr2r2r3�process_template_lineEs|

�

�


�

��

��

�
��zFileList.process_template_linecCsRd}tt|j�ddd�D]2}||j|�r|�d|j|�|j|=d}q|S)z�
        Remove all files from the file list that match the predicate.
        Return True if any matching files were removed
        Fr���z
 removing T)�ranger)�filesr�)r9Z	predicate�foundr/r2r2r3�
_remove_files�szFileList._remove_filescCs$dd�t|�D�}|�|�t|�S)z#Include files that match 'pattern'.cSsg|]}tj�|�s|�qSr2�r#r$�isdir��.0r}r2r2r3�
<listcomp>�sz$FileList.include.<locals>.<listcomp>�r�extend�bool�r9r�r�r2r2r3r��s
zFileList.includecCst|�}|�|j�S)z#Exclude files that match 'pattern'.)r4r��match�r9r�r�r2r2r3r��szFileList.excludecCs8tj�|d|�}dd�t|dd�D�}|�|�t|�S)zN
        Include all files anywhere in 'dir/' that match the pattern.
        rcSsg|]}tj�|�s|�qSr2r�r�r2r2r3r��s�z.FileList.recursive_include.<locals>.<listcomp>T)�	recursive)r#r$rerr�r�)r9r�r�Zfull_patternr�r2r2r3r��s
zFileList.recursive_includecCs ttj�|d|��}|�|j�S)zM
        Exclude any file anywhere in 'dir/' that match the pattern.
        r�r4r#r$rer�r�)r9r�r�r�r2r2r3r��szFileList.recursive_excludecCs$dd�t|�D�}|�|�t|�S)zInclude all files from 'dir/'.cSs"g|]}tj�|�D]}|�qqSr2)rar��findall)r�Z	match_dir�itemr2r2r3r��s�z"FileList.graft.<locals>.<listcomp>r�)r9r�r�r2r2r3r��s
�
zFileList.graftcCsttj�|d��}|�|j�S)zFilter out files from 'dir/'.rr�)r9r�r�r2r2r3r��szFileList.prunecsJ|jdkr|��ttj�d|����fdd�|jD�}|�|�t|�S)z�
        Include all files anywhere in the current directory that match the
        pattern. This is very inefficient on large file trees.
        Nrcsg|]}��|�r|�qSr2�r�r�r�r2r3r��s
z+FileList.global_include.<locals>.<listcomp>)Zallfilesr�r4r#r$rer�r�r�r2r�r3r��s

zFileList.global_includecCsttj�d|��}|�|j�S)zD
        Exclude all files anywhere that match the pattern.
        rr�r�r2r2r3r��szFileList.global_excludecCs8|�d�r|dd�}t|�}|�|�r4|j�|�dS)N�
r�)r<r�
_safe_pathr��append)r9r�r$r2r2r3r��s


zFileList.appendcCs|j�t|j|��dSr6)r�r��filterr�)r9�pathsr2r2r3r��szFileList.extendcCstt|j|j��|_dS)z�
        Replace self.files with only safe paths

        Because some owners of FileList manipulate the underlying
        ``files`` attribute directly, this method must be called to
        repair those paths.
        N)r_r�r�r�r8r2r2r3�_repair�szFileList._repairc	Cs�d}t�|�}|dkr(t�d|�dSt�|d�}|dkrNt�||d�dSz"tj�|�shtj�|�rnWdSWn&tk
r�t�||t	�
��YnXdS)Nz!'%s' not %s encodable -- skippingz''%s' in unexpected encoding -- skippingFruT)�
unicode_utils�filesys_decoderroZ
try_encoder#r$rn�UnicodeEncodeError�sys�getfilesystemencoding)r9r$Zenc_warnZu_pathZ	utf8_pathr2r2r3r��s

zFileList._safe_pathN)rErFrGr�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r2r2r3rBsI



rc@s\eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	e
dd��Zdd�Zdd�Z
dS)r�zMANIFEST.incCsd|_d|_d|_d|_dS)Nr)Zuse_defaultsr�Z
manifest_onlyZforce_manifestr8r2r2r3rT	sz!manifest_maker.initialize_optionscCsdSr6r2r8r2r2r3rlszmanifest_maker.finalize_optionscCsdt�|_tj�|j�s|��|��tj�|j�r<|�	�|�
�|j��|j��|��dSr6)
rr�r#r$rnr��write_manifest�add_defaults�templateZ
read_template�prune_file_list�sortZremove_duplicatesr8r2r2r3r�s

zmanifest_maker.runcCst�|�}|�tjd�S)N�/)r�r��replacer#r%)r9r$r2r2r3�_manifest_normalizes
z"manifest_maker._manifest_normalizecsB�j���fdd��jjD�}d�j}��t�j|f|�dS)zo
        Write the file list in 'self.filelist' to the manifest file
        named by 'self.manifest'.
        csg|]}��|��qSr2)r�r�r8r2r3r�*sz1manifest_maker.write_manifest.<locals>.<listcomp>zwriting manifest file '%s'N)r�r�r�r�Zexecuterm)r9r��msgr2r8r3r�"s

zmanifest_maker.write_manifestcCs|�|�st�||�dSr6)�_should_suppress_warningr	ro)r9r�r2r2r3ro.s
zmanifest_maker.warncCst�d|�S)z;
        suppress missing-file warnings from sdist
        zstandard file .*not found)r&r�)r�r2r2r3r�2sz'manifest_maker._should_suppress_warningcCs�t�|�|��|j�|j�|j�|j�tt��}|rJ|j�	|�nt
j�|j�r`|�
�t
j�d�rx|j�d�|�d�}|j�|j�dS)Nzsetup.pyrI)r	r�Z
check_licenser�r�r�r�r_r
r�r#r$rnZ
read_manifest�get_finalized_commandr�rI)r9ZrcfilesZei_cmdr2r2r3r�9s


zmanifest_maker.add_defaultscCsZ|�d�}|j��}|j�|j�|j�|�t�tj	�}|jj
d|d|dd�dS)N�buildz(^|z)(RCS|CVS|\.svn)r)Zis_regex)r�r7Zget_fullnamer�r�Z
build_baser&r'r#r%Zexclude_pattern)r9r�Zbase_dirr%r2r2r3r�Ls

�zmanifest_maker.prune_file_listN)rErFrGr�rTrlr�r�r�ro�staticmethodr�r�r�r2r2r2r3r�s
r�c	Cs8d�|�}|�d�}t|d��}|�|�W5QRXdS)z{Create a file with the specified name and write 'contents' (a
    sequence of strings without line terminators) to it.
    �
rurvN)rerxrzr{)rZ�contentsr}r2r2r3rmVs

rmc	Cs|t�d|�|jsx|jj}|j|j|_}|j|j|_}z|�	|j
�W5|||_|_Xt|jdd�}t�
|j
|�dS)Nz
writing %sZzip_safe)rrwryr7rgrRr>rQr:�write_pkg_inforI�getattrrZwrite_safety_flag)�cmd�basenamerZrgZoldverZoldnameZsafer2r2r3r�csr�cCstj�|�rt�d�dS)NzsWARNING: 'depends.txt' is not used by setuptools 0.6!
Use the install_requires/extras_require setup() args instead.)r#r$rnrro�r�r�rZr2r2r3�warn_depends_obsoletevs�r�cCs,t|pd�}dd�}t||�}|�|�dS)Nr2cSs|dS)Nr�r2)r�r2r2r3�<lambda>��z%_write_requirements.<locals>.<lambda>)rr�
writelines)�streamZreqs�linesZ	append_crr2r2r3�_write_requirements~s
r�cCsj|j}t��}t||j�|jp"i}t|�D]&}|�djft	���t|||�q,|�
d||���dS)Nz
[{extra}]
Zrequirements)r7r�StringIOr�Zinstall_requires�extras_require�sortedr{�format�varsrt�getvalue)r�r�rZZdistrrr�Zextrar2r2r3�write_requirements�s
r�cCs,t��}t||jj�|�d||���dS)Nzsetup-requirements)�ior�r�r7Zsetup_requiresrtr�)r�r�rZrrr2r2r3�write_setup_requirements�sr�cCs:t�dd�|j��D��}|�d|d�t|��d�dS)NcSsg|]}|�dd�d�qS)�.rr)r")r��kr2r2r3r��s�z(write_toplevel_names.<locals>.<listcomp>ztop-level namesr�)rY�fromkeysr7Ziter_distribution_namesrmrer�)r�r�rZZpkgsr2r2r3�write_toplevel_names�s��r�cCst|||d�dS)NT)�	write_argr�r2r2r3�
overwrite_arg�sr�FcCsHtj�|�d}t|j|d�}|dk	r4d�|�d}|�||||�dS)Nrr�)r#r$�splitextr�r7rert)r�r�rZrs�argnamerVr2r2r3r��s
r�cCs�|jj}t|tj�s|dkr"|}nn|dk	r�g}t|���D]J\}}t|tj�srt�||�}d�	tt
t|�����}|�
d||f�q:d�	|�}|�d||d�dS)Nr�z	[%s]
%s

rzentry pointsT)r7Zentry_pointsr^rZstring_typesr��itemsrZparse_grouprer�str�valuesr�rt)r�r�rZr�rrZsectionr�r2r2r3�
write_entries�s
r�c
Csjt�dt�tj�d�rft�d��>}|D]2}t�	d|�}|r(t
|�d��W5QR�Sq(W5QRXdS)zd
    Get a -r### off of PKG-INFO Version in case this is an sdist of
    a subversion revision.
    z$get_pkg_info_revision is deprecated.zPKG-INFOzVersion:.*-r(\d+)\s*$rr)�warningsro�EggInfoDeprecationWarningr#r$rnr�rzr&r��int�group)r}r�r�r2r2r3�get_pkg_info_revision�s*r�c@seZdZdZdS)r�zqClass for warning about deprecations in eggInfo in setupTools. Not ignored by default, unlike DeprecationWarning.N)rErFrG�__doc__r2r2r2r3r��sr�)F)=r�Zdistutils.filelistrZ	_FileListZdistutils.errorsrZdistutils.utilrrarr#r&r�r�r�rBrWZsetuptools.externrZsetuptools.extern.six.movesrZ
setuptoolsrZsetuptools.command.sdistr	r
Zsetuptools.command.setoptrZsetuptools.commandrZ
pkg_resourcesr
rrrrrrrZsetuptools.unicode_utilsr�Zsetuptools.globrrrr4r5rIr�rmr�r�r�r�r�r�r�r�r�r�r�r2r2r2r3�<module>sX(S2EP


site-packages/setuptools/command/__pycache__/upload_docs.cpython-38.pyc000064400000013774151446177000022300 0ustar00U

�Qab��@s�dZddlmZddlmZddlmZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlmZddlmZmZddlmZd	d
lmZdd�ZGd
d�de�ZdS)zpupload_docs

Implements a Distutils 'upload_docs' subcommand (upload documentation to
PyPI's pythonhosted.org).
�)�standard_b64encode)�log)�DistutilsOptionErrorN)�six)�http_client�urllib)�iter_entry_points�)�uploadcCstjr
dnd}|�d|�S)N�surrogateescape�strictzutf-8)r�PY3�encode)�s�errors�r�B/usr/lib/python3.8/site-packages/setuptools/command/upload_docs.py�_encodesrc@s�eZdZdZdZdddejfddgZejZdd	�Zd
efgZ	dd�Z
d
d�Zdd�Zdd�Z
edd��Zedd��Zdd�ZdS)�upload_docszhttps://pypi.python.org/pypi/zUpload documentation to PyPIzrepository=�rzurl of repository [default: %s])z
show-responseNz&display full response text from server)zupload-dir=Nzdirectory to uploadcCs"|jdkrtdd�D]}dSdS)Nzdistutils.commands�build_sphinxT)�
upload_dirr)�selfZeprrr�
has_sphinx/s
zupload_docs.has_sphinxrcCst�|�d|_d|_dS)N)r
�initialize_optionsr�
target_dir)rrrrr6s
zupload_docs.initialize_optionscCs�t�|�|jdkrN|��r0|�d�}|j|_q`|�d�}tj�	|j
d�|_n|�d�|j|_d|jkrtt
�d�|�d|j�dS)Nr�buildZdocsrzpypi.python.orgz3Upload_docs command is deprecated. Use RTD instead.zUsing upload directory %s)r
�finalize_optionsrrZget_finalized_commandZbuilder_target_dirr�os�path�joinZ
build_baseZensure_dirname�
repositoryr�warn�announce)rrrrrrr;s







zupload_docs.finalize_optionscCs�t�|d�}z�|�|j�t�|j�D]x\}}}||jkrP|sPd}t||j��|D]H}tj�	||�}|t
|j�d��tjj�}	tj�	|	|�}
|�
||
�qTq&W5|��XdS)N�wz'no files found in upload directory '%s')�zipfileZZipFile�closeZmkpathrr�walkrrr �len�lstrip�sep�write)r�filename�zip_file�root�dirs�filesZtmpl�nameZfull�relative�destrrr�create_zipfileKszupload_docs.create_zipfilec	Csh|��D]}|�|�qt��}|jj��}tj�	|d|�}z|�|�|�
|�W5t
�|�XdS)Nz%s.zip)Zget_sub_commandsZrun_command�tempfileZmkdtemp�distribution�metadata�get_namerrr �shutilZrmtreer4�upload_file)rZcmd_nameZtmp_dirr1r-rrr�run[s
zupload_docs.runccs�|\}}d|}t|t�s |g}|D]f}t|t�rL|d|d7}|d}nt|�}|Vt|�VdV|V|r$|dd�dkr$dVq$dS)	Nz*
Content-Disposition: form-data; name="%s"z; filename="%s"rr	s

����
�
)�
isinstance�list�tupler)�item�sep_boundary�key�values�title�valuerrr�_build_partis



zupload_docs._build_partcCsnd}d|}|d}|df}tj|j|d�}t||���}tj�|�}t�||�}	d|�d�}
d�	|	�|
fS)	z=
        Build up the MIME payload for the POST data
        s3--------------GHSKFJDLGDS7543FJKLFHRE75642756743254s
--s--r>)rCz multipart/form-data; boundary=%s�ascii�)
�	functools�partialrH�map�items�	itertools�chain�
from_iterable�decoder )�cls�data�boundaryrCZend_boundaryZ	end_itemsZbuilderZpart_groups�partsZ
body_items�content_typerrr�_build_multipart}s�zupload_docs._build_multipartc
CsJt|d��}|��}W5QRX|jj}d|��tj�|�|fd�}t|j	d|j
�}t|�}tj
rn|�d�}d|}|�|�\}}	d|j}
|�|
tj�tj�|j�\}}}
}}}|s�|s�|r�t�|dkr�t�|�}n |d	kr�t�|�}ntd
|��d}zZ|��|�d|
�|	}|�d
|�|�dtt|���|�d|�|� �|�!|�Wn>t"j#k
�r�}z|�t|�tj$�WY�dSd}~XYnX|�%�}|j&dk�r�d|j&|j'f}
|�|
tj�nb|j&dk�r|�(d�}|dk�r�d|��}d|}
|�|
tj�nd|j&|j'f}
|�|
tj$�|j)�rFt*d|��d�dS)N�rbZ
doc_upload)z:actionr1�content�:rIzBasic zSubmitting documentation to %sZhttpZhttpszunsupported schema �ZPOSTzContent-typezContent-lengthZ
Authorization��zServer response (%s): %si-ZLocationzhttps://pythonhosted.org/%s/zUpload successful. Visit %szUpload failed (%s): %szK---------------------------------------------------------------------------)+�open�readr6r7r8rr�basenamerZusernameZpasswordrrr
rRrXr!r#r�INFOr�parseZurlparse�AssertionErrorrZHTTPConnectionZHTTPSConnectionZconnectZ
putrequestZ	putheader�strr(Z
endheaders�send�socket�errorZERRORZgetresponseZstatus�reasonZ	getheaderZ
show_response�print)rr,�frZ�metarTZcredentialsZauthZbodyZct�msgZschemaZnetlocZurlZparamsZqueryZ	fragmentsZconnrW�er�locationrrrr:�sd�

�

zupload_docs.upload_fileN)�__name__�
__module__�__qualname__ZDEFAULT_REPOSITORY�descriptionr
Zuser_optionsZboolean_optionsrZsub_commandsrrr4r;�staticmethodrH�classmethodrXr:rrrrrs(��


r)�__doc__�base64rZ	distutilsrZdistutils.errorsrrrfr%r5r9rOrKZsetuptools.externrZsetuptools.extern.six.movesrrZ
pkg_resourcesrr
rrrrrr�<module>s site-packages/setuptools/command/__pycache__/bdist_rpm.cpython-38.pyc000064400000003370151446177000021756 0ustar00U

�Qab��@s(ddlmmZGdd�dej�ZdS)�Nc@s eZdZdZdd�Zdd�ZdS)�	bdist_rpmaf
    Override the default bdist_rpm behavior to do the following:

    1. Run egg_info to ensure the name and version are properly calculated.
    2. Always run 'install' using --single-version-externally-managed to
       disable eggs in RPM distributions.
    3. Replace dash with underscore in the version numbers for better RPM
       compatibility.
    cCs|�d�tj�|�dS)NZegg_info)Zrun_command�origr�run)�self�r�@/usr/lib/python3.8/site-packages/setuptools/command/bdist_rpm.pyrs
z
bdist_rpm.runcsl|j��}|�dd�}tj�|�}d|�d|���fdd�|D�}|���d}d|}|�||�|S)N�-�_z%define version cs0g|](}|�dd��dd��dd������qS)zSource0: %{name}-%{version}.tarz)Source0: %{name}-%{unmangled_version}.tarzsetup.py install z5setup.py install --single-version-externally-managed z%setupz&%setup -n %{name}-%{unmangled_version})�replace)�.0�line�Zline23Zline24rr�
<listcomp>s����	�z-bdist_rpm._make_spec_file.<locals>.<listcomp>�z%define unmangled_version )ZdistributionZget_versionr
rr�_make_spec_file�index�insert)r�versionZ
rpmversion�specZ
insert_locZunmangled_versionrr
rrs
�
zbdist_rpm._make_spec_fileN)�__name__�
__module__�__qualname__�__doc__rrrrrrrs
r)Zdistutils.command.bdist_rpmZcommandrrrrrr�<module>ssite-packages/setuptools/command/__pycache__/py36compat.cpython-38.opt-1.pyc000064400000011002151446177000022726 0ustar00U

�Qabz�@sdddlZddlmZddlmZddlmZddlmZGdd�d�Ze	ejd�r`Gd	d�d�ZdS)
�N)�glob)�convert_path)�sdist)�filterc@s\eZdZdZdd�Zedd��Zdd�Zdd	�Zd
d�Z	dd
�Z
dd�Zdd�Zdd�Z
dS)�sdist_add_defaultsz�
    Mix-in providing forward-compatibility for functionality as found in
    distutils on Python 3.7.

    Do not edit the code in this class except to update functionality
    as implemented in distutils. Instead, override in the subclass.
    cCs<|��|��|��|��|��|��|��dS)a9Add all the default files to self.filelist:
          - README or README.txt
          - setup.py
          - test/test*.py
          - all pure Python modules mentioned in setup script
          - all files pointed by package_data (build_py)
          - all files defined in data_files.
          - all files defined as scripts.
          - all C sources listed as part of extensions or C libraries
            in the setup script (doesn't catch C headers!)
        Warns if (README or README.txt) or setup.py are missing; everything
        else is optional.
        N)�_add_defaults_standards�_add_defaults_optional�_add_defaults_python�_add_defaults_data_files�_add_defaults_ext�_add_defaults_c_libs�_add_defaults_scripts)�self�r�A/usr/lib/python3.8/site-packages/setuptools/command/py36compat.py�add_defaultsszsdist_add_defaults.add_defaultscCs:tj�|�sdStj�|�}tj�|�\}}|t�|�kS)z�
        Case-sensitive path existence check

        >>> sdist_add_defaults._cs_path_exists(__file__)
        True
        >>> sdist_add_defaults._cs_path_exists(__file__.upper())
        False
        F)�os�path�exists�abspath�split�listdir)�fspathrZ	directory�filenamerrr�_cs_path_exists(s

z"sdist_add_defaults._cs_path_existscCs�|j|jjg}|D]~}t|t�rj|}d}|D]"}|�|�r,d}|j�|�qPq,|s�|�dd�	|��q|�|�r�|j�|�q|�d|�qdS)NFTz,standard file not found: should have one of z, zstandard file '%s' not found)
ZREADMES�distributionZscript_name�
isinstance�tupler�filelist�append�warn�join)rZ	standards�fnZaltsZgot_itrrrr9s"

�
z*sdist_add_defaults._add_defaults_standardscCs4ddg}|D]"}ttjjt|��}|j�|�qdS)Nz
test/test*.pyz	setup.cfg)rrr�isfilerr�extend)rZoptional�pattern�filesrrrrNsz)sdist_add_defaults._add_defaults_optionalcCs\|�d�}|j��r$|j�|���|jD],\}}}}|D]}|j�tj	�
||��q:q*dS)N�build_py)�get_finalized_commandrZhas_pure_modulesrr$�get_source_files�
data_filesrrrr!)rr'ZpkgZsrc_dirZ	build_dir�	filenamesrrrrr	Ts

z'sdist_add_defaults._add_defaults_pythoncCsz|j��rv|jjD]b}t|t�rBt|�}tj�|�rt|j	�
|�q|\}}|D]$}t|�}tj�|�rN|j	�
|�qNqdS)N)rZhas_data_filesr*r�strrrrr#rr)r�item�dirnamer+�frrrr
ds

z+sdist_add_defaults._add_defaults_data_filescCs(|j��r$|�d�}|j�|���dS)N�	build_ext)rZhas_ext_modulesr(rr$r))rr0rrrrus

z$sdist_add_defaults._add_defaults_extcCs(|j��r$|�d�}|j�|���dS)N�
build_clib)rZhas_c_librariesr(rr$r))rr1rrrrzs

z'sdist_add_defaults._add_defaults_c_libscCs(|j��r$|�d�}|j�|���dS)N�
build_scripts)rZhas_scriptsr(rr$r))rr2rrrr
s

z(sdist_add_defaults._add_defaults_scriptsN)�__name__�
__module__�__qualname__�__doc__r�staticmethodrrrr	r
rrr
rrrrr	s
rrc@seZdZdS)rN)r3r4r5rrrrr�s)
rrZdistutils.utilrZdistutils.commandrZsetuptools.extern.six.movesrr�hasattrrrrr�<module>s|site-packages/setuptools/command/__pycache__/test.cpython-38.opt-1.pyc000064400000020433151446177000021710 0ustar00U

�Qab�%�@s�ddlZddlZddlZddlZddlZddlZddlmZmZddl	m
Z
ddlmZddlm
Z
ddlmZmZddlmZmZmZmZmZmZmZmZmZddlmZd	d
lmZeZ Gdd�de�Z!Gd
d�d�Z"Gdd�de�Z#dS)�N)�DistutilsError�DistutilsOptionError)�log)�
TestLoader)�six)�map�filter)	�resource_listdir�resource_exists�normalize_path�working_set�_namespace_packages�evaluate_marker�add_activation_listener�require�
EntryPoint)�Command�)�_unique_everseenc@seZdZdd�Zddd�ZdS)�ScanningLoadercCst�|�t�|_dS�N)r�__init__�set�_visited��self�r�;/usr/lib/python3.8/site-packages/setuptools/command/test.pyrs
zScanningLoader.__init__NcCs�||jkrdS|j�|�g}|�t�||��t|d�rH|�|���t|d�r�t|jd�D]`}|�	d�r�|dkr�|jd|dd�}n"t
|j|d	�r^|jd|}nq^|�|�|��q^t|�d
kr�|�
|�S|dSdS)aReturn a suite of all tests cases contained in the given module

        If the module is a package, load tests from all the modules in it.
        If the module has an ``additional_tests`` function, call it and add
        the return value to the tests.
        N�additional_tests�__path__�z.pyz__init__.py�.���z/__init__.pyrr)r�add�appendr�loadTestsFromModule�hasattrrr	�__name__�endswithr
ZloadTestsFromName�lenZ
suiteClass)r�module�patternZtests�fileZ	submodulerrrr%s$



z"ScanningLoader.loadTestsFromModule)N)r'�
__module__�__qualname__rr%rrrrrsrc@seZdZdd�Zddd�ZdS)�NonDataPropertycCs
||_dSr��fget)rr1rrrrAszNonDataProperty.__init__NcCs|dkr|S|�|�Srr0)r�objZobjtyperrr�__get__DszNonDataProperty.__get__)N)r'r-r.rr3rrrrr/@sr/c@s�eZdZdZdZdddgZdd�Zdd	�Zed
d��Z	dd
�Z
dd�Zej
gfdd��Zeej
dd���Zedd��Zdd�Zdd�Zedd��Zedd��ZdS)�testz.Command to run unit tests after in-place buildz0run unit tests after in-place build (deprecated))ztest-module=�mz$Run 'test_suite' in specified module)ztest-suite=�sz9Run single test, case or suite (e.g. 'module.test_suite'))ztest-runner=�rzTest runner to usecCsd|_d|_d|_d|_dSr)�
test_suite�test_module�test_loader�test_runnerrrrr�initialize_optionsVsztest.initialize_optionscCs�|jr|jrd}t|��|jdkrD|jdkr8|jj|_n|jd|_|jdkr^t|jdd�|_|jdkrnd|_|jdkr�t|jdd�|_dS)Nz1You may specify a module or a suite, but not bothz.test_suiter:z&setuptools.command.test:ScanningLoaderr;)r8r9r�distributionr:�getattrr;)r�msgrrr�finalize_options\s




ztest.finalize_optionscCst|���Sr)�list�
_test_argsrrrr�	test_argsosztest.test_argsccs4|jstjdkrdV|jr"dV|jr0|jVdS)N)��Zdiscoverz	--verbose)r8�sys�version_info�verboserrrrrBssztest._test_argsc	Cs|���|�W5QRXdS)zI
        Backward compatibility for project_on_sys_path context.
        N)�project_on_sys_path)r�funcrrr�with_project_on_sys_path{s
ztest.with_project_on_sys_pathc	
csPtjot|jdd�}|rv|jddd�|�d�|�d�}t|j�}|jd|d�|�d�|jddd�|�d�n"|�d�|jdd	d�|�d�|�d�}t	j
dd�}t	j��}zbt|j�}t	j
�d|�t��td
d��td|j|jf�|�|g��dVW5QRXW5|t	j
dd�<t	j�
�t	j�|�t��XdS)
N�use_2to3F�build_pyr)ZinplaceZegg_info)�egg_baseZ	build_extrcSs|��Sr)Zactivate)�distrrr�<lambda>��z*test.project_on_sys_path.<locals>.<lambda>z%s==%s)r�PY3r>r=Zreinitialize_commandZrun_commandZget_finalized_commandrZ	build_librF�path�modules�copy�clear�updaterrrN�insertrrZegg_nameZegg_version�paths_on_pythonpath)	rZ
include_distsZ	with_2to3Zbpy_cmdZ
build_pathZei_cmdZold_pathZold_modulesZproject_pathrrrrI�s8









ztest.project_on_sys_pathc
cs�t�}tj�d|�}tj�dd�}zBtj�t|��}td||g�}tj�|�}|r\|tjd<dVW5||kr~tj�dd�n
|tjd<XdS)z�
        Add the indicated paths to the head of the PYTHONPATH environment
        variable so that subprocesses will also see the packages at
        these paths.

        Do this in a context that restores the value on exit.
        Z
PYTHONPATHr N)	�object�os�environ�get�pop�pathsep�joinrr)�pathsZnothingZorig_pythonpathZcurrent_pythonpath�prefixZto_join�new_pathrrrrY�s


ztest.paths_on_pythonpathcCsD|�|j�}|�|jpg�}|�dd�|j��D��}t�|||�S)z�
        Install the requirements indicated by self.distribution and
        return an iterable of the dists that were built.
        css0|](\}}|�d�rt|dd��r|VqdS)�:rN)�
startswithr)�.0�k�vrrr�	<genexpr>�s
�z%test.install_dists.<locals>.<genexpr>)Zfetch_build_eggsZinstall_requiresZ
tests_requireZextras_require�items�	itertools�chain)rOZir_dZtr_dZer_drrr�
install_dists�s
�ztest.install_distsc
Cs�|�dtj�|�|j�}d�|j�}|jr>|�d|�dS|�d|�tt	�
d�|�}|�|��"|���|�
�W5QRXW5QRXdS)Nz�WARNING: Testing via this command is deprecated and will be removed in a future version. Users looking for a generic test entry point independent of test runner are encouraged to use tox.� zskipping "%s" (dry run)zrunning "%s"�location)�announcerZWARNrmr=r`�_argvZdry_runr�operator�
attrgetterrYrI�	run_tests)rZinstalled_dists�cmdrarrr�run�s�
ztest.runcCs�tjr~t|jdd�r~|j�d�d}|tkr~g}|tjkrD|�	|�|d7}tjD]}|�
|�rR|�	|�qRtttjj
|��tjdd|j|�|j�|�|j�dd�}|j��s�d|j}|�|tj�t|��dS)NrLFr!r)Z
testLoaderZ
testRunner�exitzTest failed: %s)rrRr>r=r8�splitr
rFrTr$rerAr�__delitem__�unittest�mainrq�_resolve_as_epr:r;�resultZ
wasSuccessfulrprZERRORr)rr*Zdel_modules�namer4r?rrrrt�s.





�

ztest.run_testscCsdg|jS)Nrz)rCrrrrrq
sz
test._argvcCs$|dkrdSt�d|�}|���S)zu
        Load the indicated attribute value, called, as a as if it were
        specified as an entry point.
        Nzx=)r�parseZresolve)�valZparsedrrrr|sztest._resolve_as_epN)r'r-r.�__doc__�descriptionZuser_optionsr<r@r/rCrBrK�
contextlib�contextmanagerrI�staticmethodrYrmrvrt�propertyrqr|rrrrr4Js2�
-


r4)$r[rrrFr�rkrzZdistutils.errorsrrZ	distutilsrrZsetuptools.externrZsetuptools.extern.six.movesrrZ
pkg_resourcesr	r
rrr
rrrrZ
setuptoolsrrMr�typeZ
__metaclass__rr/r4rrrr�<module>s",)
site-packages/setuptools/command/__pycache__/install_scripts.cpython-38.opt-1.pyc000064400000004341151446177000024146 0ustar00U

�Qab�	�@sXddlmZddlmmZddlZddlZddlm	Z	m
Z
mZGdd�dej�ZdS)�)�logN)�Distribution�PathMetadata�ensure_directoryc@s*eZdZdZdd�Zdd�Zd
dd�Zd	S)�install_scriptsz;Do normal script install, plus any egg_info wrapper scriptscCstj�|�d|_dS)NF)�origr�initialize_options�no_ep)�self�r�F/usr/lib/python3.8/site-packages/setuptools/command/install_scripts.pyrsz"install_scripts.initialize_optionscCs�ddlmm}|�d�|jjr2tj�|�ng|_	|j
rBdS|�d�}t|j
t|j
|j�|j|j�}|�d�}t|dd�}|�d�}t|dd�}|j}|r�d}|j}|tjkr�|g}|��}|j���|�}	|�||	���D]}
|j|
�q�dS)	Nr�egg_infoZ
build_scripts�
executableZ
bdist_wininstZ_is_runningFz
python.exe)�setuptools.command.easy_install�commandZeasy_installZrun_commandZdistributionZscriptsrr�run�outfilesr	Zget_finalized_commandrZegg_baserr
Zegg_nameZegg_version�getattrZScriptWriterZWindowsScriptWriter�sysrZbestZcommand_spec_classZ
from_paramZget_argsZ	as_header�write_script)r
ZeiZei_cmdZdistZbs_cmdZ
exec_paramZbw_cmdZ
is_wininst�writer�cmd�argsrrrrs8

�


zinstall_scripts.run�tc
Gs�ddlm}m}t�d||j�tj�|j|�}|j	�
|�|�}|js~t|�t
|d|�}	|	�|�|	��||d|�dS)z1Write an executable file to the scripts directoryr)�chmod�
current_umaskzInstalling %s script to %s�wi�N)rrrr�infoZinstall_dir�os�path�joinr�appendZdry_runr�open�write�close)
r
Zscript_name�contents�modeZignoredrr�target�mask�frrrr3s
zinstall_scripts.write_scriptN)r)�__name__�
__module__�__qualname__�__doc__rrrrrrrr	s#r)Z	distutilsrZ!distutils.command.install_scriptsrrrrrZ
pkg_resourcesrrrrrrr�<module>s
site-packages/setuptools/command/__pycache__/rotate.cpython-38.pyc000064400000004730151446177000021272 0ustar00U

�Qabt�@s`ddlmZddlmZddlmZddlZddlZddlm	Z	ddl
mZGdd�de�ZdS)	�)�convert_path)�log)�DistutilsOptionErrorN)�six)�Commandc@s:eZdZdZdZdddgZgZdd�Zdd	�Zd
d�Z	dS)
�rotatezDelete older distributionsz2delete older distributions, keeping N newest files)zmatch=�mzpatterns to match (required))z	dist-dir=�dz%directory where the distributions are)zkeep=�kz(number of matching distributions to keepcCsd|_d|_d|_dS)N)�match�dist_dir�keep��self�r�=/usr/lib/python3.8/site-packages/setuptools/command/rotate.py�initialize_optionsszrotate.initialize_optionscCs�|jdkrtd��|jdkr$td��zt|j�|_Wntk
rPtd��YnXt|jtj�rxdd�|j�d�D�|_|�	dd�dS)	NzQMust specify one or more (comma-separated) match patterns (e.g. '.zip' or '.egg')z$Must specify number of files to keepz--keep must be an integercSsg|]}t|����qSr)r�strip)�.0�prrr�
<listcomp>*sz+rotate.finalize_options.<locals>.<listcomp>�,Zbdist)rr)
rrr
�int�
ValueError�
isinstancerZstring_types�splitZset_undefined_optionsrrrr�finalize_optionss
�

�zrotate.finalize_optionscCs�|�d�ddlm}|jD]�}|j��d|}|tj�|j|��}dd�|D�}|�	�|�
�t�dt
|�|�||jd�}|D]<\}}t�d|�|js�tj�|�r�t�|�q�t�|�q�qdS)	NZegg_infor)�glob�*cSsg|]}tj�|�|f�qSr)�os�path�getmtime)r�frrrr6szrotate.run.<locals>.<listcomp>z%d file(s) matching %szDeleting %s)Zrun_commandrrZdistributionZget_namerr �joinr�sort�reverser�info�lenr
Zdry_run�isdir�shutilZrmtree�unlink)rr�pattern�files�tr"rrr�run/s 

z
rotate.runN)
�__name__�
__module__�__qualname__�__doc__�descriptionZuser_optionsZboolean_optionsrrr.rrrrrs�r)
Zdistutils.utilrZ	distutilsrZdistutils.errorsrrr)Zsetuptools.externrZ
setuptoolsrrrrrr�<module>ssite-packages/setuptools/command/__pycache__/install_egg_info.cpython-38.pyc000064400000004543151446177000023301 0ustar00U

�Qab��@s\ddlmZmZddlZddlmZddlmZddlmZddl	Z	Gdd�dej
e�ZdS)�)�log�dir_utilN)�Command)�
namespaces)�unpack_archivec@sBeZdZdZdZdgZdd�Zdd�Zdd�Zd	d
�Z	dd�Z
d
S)�install_egg_infoz.Install an .egg-info directory for the package)zinstall-dir=�dzdirectory to install tocCs
d|_dS�N)�install_dir��self�r
�G/usr/lib/python3.8/site-packages/setuptools/command/install_egg_info.py�initialize_optionssz#install_egg_info.initialize_optionscCsV|�dd�|�d�}t�dd|j|j���d}|j|_tj	�
|j|�|_g|_
dS)NZinstall_lib)r
r
�egg_infoz	.egg-info)Zset_undefined_optionsZget_finalized_command�
pkg_resourcesZDistributionZegg_nameZegg_versionr�source�os�path�joinr
�target�outputs)rZei_cmd�basenamer
r
r�finalize_optionss�
��z!install_egg_info.finalize_optionscCs�|�d�tj�|j�r:tj�|j�s:tj|j|jd�n(tj�	|j�rb|�
tj|jfd|j�|jstt�
|j�|�
|jdd|j|jf�|��dS)Nr)�dry_runz	Removing r
�Copying %s to %s)Zrun_commandrr�isdirr�islinkrZremove_treer�existsZexecute�unlinkrZensure_directory�copytreerZinstall_namespacesrr
r
r�run!s
�zinstall_egg_info.runcCs|jSr	)rrr
r
r�get_outputs.szinstall_egg_info.get_outputscs �fdd�}t�j�j|�dS)NcsDdD] }|�|�sd||krdSq�j�|�t�d||�|S)N)z.svn/zCVS/�/r)�
startswithr�appendr�debug)�srcZdst�skiprr
r�skimmer3sz*install_egg_info.copytree.<locals>.skimmer)rrr)rr)r
rrr 1szinstall_egg_info.copytreeN)�__name__�
__module__�__qualname__�__doc__�descriptionZuser_optionsrrr!r"r r
r
r
rr
s�
r)Z	distutilsrrrZ
setuptoolsrrZsetuptools.archive_utilrrZ	Installerrr
r
r
r�<module>ssite-packages/setuptools/command/__pycache__/install.cpython-38.pyc000064400000007627151446177000021452 0ustar00U

�QabK�@s|ddlmZddlZddlZddlZddlZddlmmZ	ddl
Z
e	jZGdd�de	j�Zdd�e	jjD�ej
e_dS)�)�DistutilsArgErrorNc@s�eZdZdZejjddgZejjddgZddd�fd	d
d�fgZe	e�Z
dd�Zd
d�Zdd�Z
dd�Zedd��Zdd�ZdS)�installz7Use easy_install to install the package, w/dependencies)�old-and-unmanageableNzTry not to use this!)�!single-version-externally-managedNz5used by system package builders to create 'flat' eggsrrZinstall_egg_infocCsdS�NT���selfrr�>/usr/lib/python3.8/site-packages/setuptools/command/install.py�<lambda>�zinstall.<lambda>Zinstall_scriptscCsdSrrrrrr
rrcCstj�|�d|_d|_dS�N)�origr�initialize_options�old_and_unmanageable�!single_version_externally_managedrrrr
r szinstall.initialize_optionscCs8tj�|�|jrd|_n|jr4|js4|js4td��dS)NTzAYou must specify --record or --root when building system packages)rr�finalize_options�rootr�recordrrrrr
r%s�zinstall.finalize_optionscCs(|js|jrtj�|�Sd|_d|_dS)N�)rrrr�handle_extra_pathZ	path_fileZ
extra_dirsrrrr
r0szinstall.handle_extra_pathcCs@|js|jrtj�|�S|�t���s4tj�|�n|��dSr
)	rrrr�run�_called_from_setup�inspectZcurrentframe�do_egg_installrrrr
r:s
zinstall.runcCsz|dkr4d}t�|�t��dkr0d}t�|�dSt�|�d}|dd�\}t�|�}|j�dd	�}|d
kox|j	dkS)a�
        Attempt to detect whether run() was called from setup() or by another
        command.  If called by setup(), the parent caller will be the
        'run_command' method in 'distutils.dist', and *its* caller will be
        the 'run_commands' method.  If called any other way, the
        immediate caller *might* be 'run_command', but it won't have been
        called by 'run_commands'. Return True in that case or if a call stack
        is unavailable. Return False otherwise.
        Nz4Call stack not available. bdist_* commands may fail.Z
IronPythonz6For best results, pass -X:Frames to enable call stack.T���__name__rzdistutils.distZrun_commands)
�warnings�warn�platformZpython_implementationrZgetouterframesZgetframeinfo�	f_globals�getZfunction)Z	run_frame�msg�resZcaller�infoZ
caller_modulerrr
rEs


�zinstall._called_from_setupcCs�|j�d�}||jd|j|jd�}|��d|_|j�t�d��|�	d�|j�
d�jg}tj
rp|�dtj
�||_|��dt_
dS)N�easy_install�x)�argsrr�.z*.eggZ	bdist_eggr)ZdistributionZget_command_classrrZensure_finalizedZalways_copy_fromZ
package_index�scan�globZrun_commandZget_command_objZ
egg_output�
setuptoolsZbootstrap_install_from�insertr(r)r	r&�cmdr(rrr
r`s"�
zinstall.do_egg_installN)r�
__module__�__qualname__�__doc__rrZuser_optionsZboolean_options�new_commands�dict�_ncrrrr�staticmethodrrrrrr
rs(��

�

rcCsg|]}|dtjkr|�qS)r)rr4)�.0r.rrr
�
<listcomp>{sr7)Zdistutils.errorsrrr+rr Zdistutils.command.installZcommandrrr,�_installZsub_commandsr2rrrr
�<module>sl��site-packages/setuptools/command/__pycache__/upload_docs.cpython-38.opt-1.pyc000064400000013752151446177000023233 0ustar00U

�Qab��@s�dZddlmZddlmZddlmZddlZddlZddl	Z	ddl
Z
ddlZddlZddl
Z
ddlmZddlmZmZddlmZd	d
lmZdd�ZGd
d�de�ZdS)zpupload_docs

Implements a Distutils 'upload_docs' subcommand (upload documentation to
PyPI's pythonhosted.org).
�)�standard_b64encode)�log)�DistutilsOptionErrorN)�six)�http_client�urllib)�iter_entry_points�)�uploadcCstjr
dnd}|�d|�S)N�surrogateescape�strictzutf-8)r�PY3�encode)�s�errors�r�B/usr/lib/python3.8/site-packages/setuptools/command/upload_docs.py�_encodesrc@s�eZdZdZdZdddejfddgZejZdd	�Zd
efgZ	dd�Z
d
d�Zdd�Zdd�Z
edd��Zedd��Zdd�ZdS)�upload_docszhttps://pypi.python.org/pypi/zUpload documentation to PyPIzrepository=�rzurl of repository [default: %s])z
show-responseNz&display full response text from server)zupload-dir=Nzdirectory to uploadcCs"|jdkrtdd�D]}dSdS)Nzdistutils.commands�build_sphinxT)�
upload_dirr)�selfZeprrr�
has_sphinx/s
zupload_docs.has_sphinxrcCst�|�d|_d|_dS)N)r
�initialize_optionsr�
target_dir)rrrrr6s
zupload_docs.initialize_optionscCs�t�|�|jdkrN|��r0|�d�}|j|_q`|�d�}tj�	|j
d�|_n|�d�|j|_d|jkrtt
�d�|�d|j�dS)Nr�buildZdocsrzpypi.python.orgz3Upload_docs command is deprecated. Use RTD instead.zUsing upload directory %s)r
�finalize_optionsrrZget_finalized_commandZbuilder_target_dirr�os�path�joinZ
build_baseZensure_dirname�
repositoryr�warn�announce)rrrrrrr;s







zupload_docs.finalize_optionscCs�t�|d�}z�|�|j�t�|j�D]x\}}}||jkrP|sPd}t||j��|D]H}tj�	||�}|t
|j�d��tjj�}	tj�	|	|�}
|�
||
�qTq&W5|��XdS)N�wz'no files found in upload directory '%s')�zipfileZZipFile�closeZmkpathrr�walkrrr �len�lstrip�sep�write)r�filename�zip_file�root�dirs�filesZtmpl�nameZfull�relative�destrrr�create_zipfileKszupload_docs.create_zipfilec	Csh|��D]}|�|�qt��}|jj��}tj�	|d|�}z|�|�|�
|�W5t
�|�XdS)Nz%s.zip)Zget_sub_commandsZrun_command�tempfileZmkdtemp�distribution�metadata�get_namerrr �shutilZrmtreer4�upload_file)rZcmd_nameZtmp_dirr1r-rrr�run[s
zupload_docs.runccs�|\}}d|}t|t�s |g}|D]f}t|t�rL|d|d7}|d}nt|�}|Vt|�VdV|V|r$|dd�dkr$dVq$dS)	Nz*
Content-Disposition: form-data; name="%s"z; filename="%s"rr	s

����
�
)�
isinstance�list�tupler)�item�sep_boundary�key�values�title�valuerrr�_build_partis



zupload_docs._build_partcCsnd}d|}|d}|df}tj|j|d�}t||���}tj�|�}t�||�}	d|�d�}
d�	|	�|
fS)	z=
        Build up the MIME payload for the POST data
        s3--------------GHSKFJDLGDS7543FJKLFHRE75642756743254s
--s--r>)rCz multipart/form-data; boundary=%s�ascii�)
�	functools�partialrH�map�items�	itertools�chain�
from_iterable�decoder )�cls�data�boundaryrCZend_boundaryZ	end_itemsZbuilderZpart_groups�partsZ
body_items�content_typerrr�_build_multipart}s�zupload_docs._build_multipartc
Cs:t|d��}|��}W5QRX|jj}d|��tj�|�|fd�}t|j	d|j
�}t|�}tj
rn|�d�}d|}|�|�\}}	d|j}
|�|
tj�tj�|j�\}}}
}}}|dkr�t�|�}n |d	kr�t�|�}ntd
|��d}zZ|��|�d|
�|	}|�d
|�|�dtt|���|�d|�|� �|�!|�Wn>t"j#k
�r�}z|�t|�tj$�WY�dSd}~XYnX|�%�}|j&dk�r�d|j&|j'f}
|�|
tj�nb|j&dk�r|�(d�}|dk�r�d|��}d|}
|�|
tj�nd|j&|j'f}
|�|
tj$�|j)�r6t*d|��d�dS)N�rbZ
doc_upload)z:actionr1�content�:rIzBasic zSubmitting documentation to %sZhttpZhttpszunsupported schema �ZPOSTzContent-typezContent-lengthZ
Authorization��zServer response (%s): %si-ZLocationzhttps://pythonhosted.org/%s/zUpload successful. Visit %szUpload failed (%s): %szK---------------------------------------------------------------------------)+�open�readr6r7r8rr�basenamerZusernameZpasswordrrr
rRrXr!r#r�INFOr�parseZurlparserZHTTPConnectionZHTTPSConnection�AssertionErrorZconnectZ
putrequestZ	putheader�strr(Z
endheaders�send�socket�errorZERRORZgetresponseZstatus�reasonZ	getheaderZ
show_response�print)rr,�frZ�metarTZcredentialsZauthZbodyZct�msgZschemaZnetlocZurlZparamsZqueryZ	fragmentsZconnrW�er�locationrrrr:�sb�

�

zupload_docs.upload_fileN)�__name__�
__module__�__qualname__ZDEFAULT_REPOSITORY�descriptionr
Zuser_optionsZboolean_optionsrZsub_commandsrrr4r;�staticmethodrH�classmethodrXr:rrrrrs(��


r)�__doc__�base64rZ	distutilsrZdistutils.errorsrrrfr%r5r9rOrKZsetuptools.externrZsetuptools.extern.six.movesrrZ
pkg_resourcesrr
rrrrrr�<module>s site-packages/setuptools/command/__pycache__/rotate.cpython-38.opt-1.pyc000064400000004730151446177000022231 0ustar00U

�Qabt�@s`ddlmZddlmZddlmZddlZddlZddlm	Z	ddl
mZGdd�de�ZdS)	�)�convert_path)�log)�DistutilsOptionErrorN)�six)�Commandc@s:eZdZdZdZdddgZgZdd�Zdd	�Zd
d�Z	dS)
�rotatezDelete older distributionsz2delete older distributions, keeping N newest files)zmatch=�mzpatterns to match (required))z	dist-dir=�dz%directory where the distributions are)zkeep=�kz(number of matching distributions to keepcCsd|_d|_d|_dS)N)�match�dist_dir�keep��self�r�=/usr/lib/python3.8/site-packages/setuptools/command/rotate.py�initialize_optionsszrotate.initialize_optionscCs�|jdkrtd��|jdkr$td��zt|j�|_Wntk
rPtd��YnXt|jtj�rxdd�|j�d�D�|_|�	dd�dS)	NzQMust specify one or more (comma-separated) match patterns (e.g. '.zip' or '.egg')z$Must specify number of files to keepz--keep must be an integercSsg|]}t|����qSr)r�strip)�.0�prrr�
<listcomp>*sz+rotate.finalize_options.<locals>.<listcomp>�,Zbdist)rr)
rrr
�int�
ValueError�
isinstancerZstring_types�splitZset_undefined_optionsrrrr�finalize_optionss
�

�zrotate.finalize_optionscCs�|�d�ddlm}|jD]�}|j��d|}|tj�|j|��}dd�|D�}|�	�|�
�t�dt
|�|�||jd�}|D]<\}}t�d|�|js�tj�|�r�t�|�q�t�|�q�qdS)	NZegg_infor)�glob�*cSsg|]}tj�|�|f�qSr)�os�path�getmtime)r�frrrr6szrotate.run.<locals>.<listcomp>z%d file(s) matching %szDeleting %s)Zrun_commandrrZdistributionZget_namerr �joinr�sort�reverser�info�lenr
Zdry_run�isdir�shutilZrmtree�unlink)rr�pattern�files�tr"rrr�run/s 

z
rotate.runN)
�__name__�
__module__�__qualname__�__doc__�descriptionZuser_optionsZboolean_optionsrrr.rrrrrs�r)
Zdistutils.utilrZ	distutilsrZdistutils.errorsrrr)Zsetuptools.externrZ
setuptoolsrrrrrr�<module>ssite-packages/setuptools/command/__pycache__/build_ext.cpython-38.pyc000064400000023247151446177000021757 0ustar00U

�Qab�2�
@s�ddlZddlZddlZddlmZddlmZddlm	Z	ddl
mZmZddl
mZddlmZddlmZdd	lmZejr�ddlZd
d�e��D�ZnddlmZzddlmZed
�Wnek
r�eZYnXed�ddl
mZdd�Z dZ!dZ"dZ#ej$dk�rdZ"n>ej%dk�rTzddl&Z&e'e&d�Z"Z!Wnek
�rRYnXdd�Z(dd�Z)Gdd�de�Ze"�s�ej%dk�r�d"dd�Z*nd Z#d#d!d�Z*dS)$�N)�	build_ext)�	copy_file)�new_compiler)�customize_compiler�get_config_var)�DistutilsError)�log)�Library)�sixcCs g|]\}}}|tjkr|�qS�)�impZC_EXTENSION)�.0�s�_�tprr�@/usr/lib/python3.8/site-packages/setuptools/command/build_ext.py�
<listcomp>s
r��EXTENSION_SUFFIXESzCython.Compiler.Main�LDSHARED)�_config_varsc	CsZtjdkrNt��}z$dtd<dtd<dtd<t|�W5t��t�|�Xnt|�dS)N�darwinz0gcc -Wl,-x -dynamiclib -undefined dynamic_lookuprz -dynamiclibZCCSHAREDz.dylibZSO)�sys�platform�_CONFIG_VARS�copy�clear�updater)�compilerZtmprrr�_customize_compiler_for_shlib#s
�rFZsharedrT�nt�RTLD_NOWcCstr|SdS)N�)�	have_rtld)rrrr�<lambda>D�r$cCs.tD]$}d|kr|S|dkr|SqdS)z;Return the file extension for an abi3-compliant Extension()z.abi3z.pydNr)�suffixrrr�get_abi3_suffixGs
r'c@sveZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zddd�ZdS)rcCs.|jd}|_t�|�||_|r*|��dS)z;Build extensions in build directory, then copy if --inplacerN)Zinplace�
_build_ext�run�copy_extensions_to_source)�selfZold_inplacerrrr)Qs

z
build_ext.runc
Cs�|�d�}|jD]�}|�|j�}|�|�}|�d�}d�|dd��}|�|�}tj	�|tj	�
|��}tj	�|j|�}	t|	||j
|jd�|jr|�|p�tj|d�qdS)N�build_py�.���)�verbose�dry_runT)�get_finalized_command�
extensions�get_ext_fullname�name�get_ext_filename�split�joinZget_package_dir�os�path�basename�	build_librr/r0�_needs_stub�
write_stub�curdir)
r+r,�ext�fullname�filename�modpath�packageZpackage_dirZ
dest_filenameZsrc_filenamerrrr*Ys&





��z#build_ext.copy_extensions_to_sourcecCs�t�||�}||jkr�|j|}tjo4t|d�o4t�}|r^td�}|dt|��}|t�}t	|t
�r�tj�
|�\}}|j�|t�Str�|jr�tj�|�\}}tj�|d|�S|S)NZpy_limited_apiZ
EXT_SUFFIXzdl-)r(r5�ext_mapr
ZPY3�getattrr'r�len�
isinstancer	r8r9�splitext�shlib_compiler�library_filename�libtype�	use_stubs�_links_to_dynamicr6r7)r+r@rAr?Zuse_abi3Zso_ext�fn�drrrr5os&

��


zbuild_ext.get_ext_filenamecCs t�|�d|_g|_i|_dS�N)r(�initialize_optionsrI�shlibsrD�r+rrrrQ�s
zbuild_ext.initialize_optionscCs,t�|�|jpg|_|�|j�dd�|jD�|_|jrB|��|jD]}|�|j�|_qH|jD]�}|j}||j	|<||j	|�
d�d<|jr�|�|�p�d}|o�to�t
|t�}||_||_|�|�}|_tj�tj�|j|��}|�r||jk�r|j�|�|rbtrbtj|jkrb|j�tj�qbdS)NcSsg|]}t|t�r|�qSr)rGr	�r
r?rrrr�s
�z.build_ext.finalize_options.<locals>.<listcomp>r-r.F)r(�finalize_optionsr2Zcheck_extensions_listrR�setup_shlib_compilerr3r4�
_full_namerDr6�links_to_dynamicrLrGr	rMr<r5�
_file_namer8r9�dirnamer7r;�library_dirs�appendr>�runtime_library_dirs)r+r?r@Zltd�nsrAZlibdirrrrrU�s,



zbuild_ext.finalize_optionscCs�t|j|j|jd�}|_t|�|jdk	r8|�|j�|jdk	r^|jD]\}}|�	||�qH|j
dk	r~|j
D]}|�|�qn|jdk	r�|�
|j�|jdk	r�|�|j�|jdk	r�|�|j�|jdk	r�|�|j�t�|�|_dS)N)rr0�force)rrr0r_rIrZinclude_dirsZset_include_dirsZdefineZdefine_macroZundefZundefine_macro�	librariesZ
set_librariesr[Zset_library_dirsZrpathZset_runtime_library_dirsZlink_objectsZset_link_objects�link_shared_object�__get__)r+rr4�valueZmacrorrrrV�s.�







zbuild_ext.setup_shlib_compilercCst|t�r|jSt�||�SrP)rGr	�export_symbolsr(�get_export_symbols�r+r?rrrre�s
zbuild_ext.get_export_symbolscCs\|��|j}z@t|t�r"|j|_t�||�|jrL|�d�j	}|�
||�W5||_XdS)Nr,)Z_convert_pyx_sources_to_langrrGr	rIr(�build_extensionr<r1r;r=)r+r?Z	_compiler�cmdrrrrg�s
zbuild_ext.build_extensioncsPt�dd�|jD���d�|j�d�dd�dg��t��fdd�|jD��S)	z?Return true if 'ext' links to a dynamic lib in the same packagecSsg|]
}|j�qSr)rW)r
�librrrr�sz.build_ext.links_to_dynamic.<locals>.<listcomp>r-Nr.r"c3s|]}�|�kVqdSrPr)r
Zlibname�ZlibnamesZpkgrr�	<genexpr>�sz-build_ext.links_to_dynamic.<locals>.<genexpr>)�dict�fromkeysrRr7rWr6�anyr`rfrrjrrX�s zbuild_ext.links_to_dynamiccCst�|�|��SrP)r(�get_outputs�_build_ext__get_stubs_outputsrSrrrro�szbuild_ext.get_outputscs6�fdd��jD�}t�|����}tdd�|D��S)Nc3s0|](}|jrtjj�jf|j�d���VqdS)r-N)r<r8r9r7r;rWr6rTrSrrrk�s�z0build_ext.__get_stubs_outputs.<locals>.<genexpr>css|]\}}||VqdSrPr)r
�baseZfnextrrrrk�s)r2�	itertools�product�!_build_ext__get_output_extensions�list)r+Zns_ext_basesZpairsrrSrZ__get_stubs_outputs�s

�zbuild_ext.__get_stubs_outputsccs"dVdV|�d�jrdVdS)N�.pyz.pycr,z.pyo)r1�optimizerSrrrZ__get_output_extensions�sz!build_ext.__get_output_extensionsFcCs,t�d|j|�tjj|f|j�d���d}|rJtj�|�rJt|d��|j	s�t
|d�}|�d�ddd	td
�dtj�
|j�dd
dtd�dddtd�ddtd�dddg��|��|�r(ddlm}||gdd|j	d�|�d�j}|dk�r||g|d|j	d�tj�|��r(|j	�s(t�|�dS)Nz writing stub loader for %s to %sr-rvz already exists! Please delete.�w�
zdef __bootstrap__():z-   global __bootstrap__, __file__, __loader__z%   import sys, os, pkg_resources, impz, dlz:   __file__ = pkg_resources.resource_filename(__name__,%r)z   del __bootstrap__z    if '__loader__' in globals():z       del __loader__z#   old_flags = sys.getdlopenflags()z   old_dir = os.getcwd()z   try:z(     os.chdir(os.path.dirname(__file__))z$     sys.setdlopenflags(dl.RTLD_NOW)z(     imp.load_dynamic(__name__,__file__)z   finally:z"     sys.setdlopenflags(old_flags)z     os.chdir(old_dir)z__bootstrap__()r"r)�byte_compileT)rwr_r0Zinstall_lib)r�inforWr8r9r7r6�existsrr0�open�write�if_dlr:rY�closeZdistutils.utilrzr1rw�unlink)r+�
output_dirr?�compileZ	stub_file�frzrwrrrr=�sb
��

����
�zbuild_ext.write_stubN)F)�__name__�
__module__�__qualname__r)r*r5rQrUrVrergrXrorprtr=rrrrrPs
	rc

Cs(|�|j|||||||||	|
||�
dSrP)�linkZSHARED_LIBRARY)
r+�objects�output_libnamer�r`r[r]rd�debug�
extra_preargs�extra_postargs�
build_temp�target_langrrrra#s�raZstaticc
Cs^|dkst�tj�|�\}}
tj�|
�\}}|�d��d�rH|dd�}|�|||||�dS)N�xri�)�AssertionErrorr8r9r6rHrJ�
startswithZcreate_static_lib)r+r�r�r�r`r[r]rdr�r�r�r�r�rAr:r?rrrra2s�)
NNNNNrNNNN)
NNNNNrNNNN)+r8rrrZdistutils.command.build_extrZ
_du_build_extZdistutils.file_utilrZdistutils.ccompilerrZdistutils.sysconfigrrZdistutils.errorsrZ	distutilsrZsetuptools.extensionr	Zsetuptools.externr
ZPY2rZget_suffixesrZimportlib.machineryZCython.Distutils.build_extr(�
__import__�ImportErrorrrrr#rLrKrr4Zdl�hasattrrr'rarrrr�<module>sz
	Q�
�site-packages/setuptools/command/__pycache__/develop.cpython-38.pyc000064400000014545151446177000021437 0ustar00U

�Qab��@s�ddlmZddlmZddlmZmZddlZddlZddl	Z	ddl
mZddlZddl
mZddlmZddlZeZGdd	�d	eje�ZGd
d�d�ZdS)�)�convert_path)�log)�DistutilsError�DistutilsOptionErrorN)�six)�easy_install)�
namespacesc@sveZdZdZdZejddgZejdgZdZdd�Z	d	d
�Z
dd�Zed
d��Z
dd�Zdd�Zdd�Zdd�ZdS)�developzSet up package for developmentz%install package in 'development mode')�	uninstall�uzUninstall this source package)z	egg-path=Nz-Set the path to be used in the .egg-link filer
FcCs2|jrd|_|��|��n|��|��dS)NT)r
Z
multi_version�uninstall_linkZuninstall_namespaces�install_for_developmentZwarn_deprecated_options��self�r�>/usr/lib/python3.8/site-packages/setuptools/command/develop.py�run s
zdevelop.runcCs&d|_d|_t�|�d|_d|_dS)N�.)r
�egg_pathr�initialize_options�
setup_pathZalways_copy_fromrrrrr)s

zdevelop.initialize_optionscCs|�d�}|jr,d}|j|jf}t||��|jg|_t�|�|��|�	�|j
�t�d��|jd}t
j�|j|�|_|j|_|jdkr�t
j�|j�|_t�|j�}t�t
j�|j|j��}||kr�td|��tj|t�|t
j�|j��|jd�|_|�|j|j|j�|_dS)N�egg_infoz-Please rename %r to %r before using 'develop'z*.eggz	.egg-linkzA--egg-path must be a relative path from the install directory to �Zproject_name)�get_finalized_commandZbroken_egg_inforrZegg_name�argsr�finalize_optionsZexpand_basedirsZexpand_dirsZ
package_index�scan�glob�os�path�join�install_dir�egg_link�egg_baser�abspath�
pkg_resources�normalize_pathrZDistribution�PathMetadata�dist�_resolve_setup_pathr)rZei�templaterZegg_link_fn�targetrrrrr0sF




�����zdevelop.finalize_optionscCsn|�tjd��d�}|tjkr0d|�d�d}t�tj�	|||��}|t�tj�krjt
d|t�tj���|S)z�
        Generate a path from egg_base back to '.' where the
        setup script resides and ensure that path points to the
        setup path from $install_dir/$egg_path.
        �/z../�zGCan't get a consistent path to setup script from installation directory)�replacer�sep�rstrip�curdir�countr%r&rr r)r#r!rZ
path_to_setupZresolvedrrrr)Zs
�
�zdevelop._resolve_setup_pathc	CsHtjr�t|jdd�r�|jddd�|�d�|�d�}t�|j	�}|jd|d�|�d�|jddd�|�d�|�d�}||_
||j_t�
||j�|j_n"|�d�|jdd	d�|�d�|��tjr�|�tj�dt_|��t�d
|j|j�|j�s0t|jd��}|�|j
d|j�W5QRX|�d|j|j�dS)
NZuse_2to3FZbuild_pyr)Zinplacer)r#Z	build_extr-zCreating %s (link to %s)�w�
)rZPY3�getattr�distributionZreinitialize_commandZrun_commandrr%r&Z	build_librr(�locationr'rZ	_providerZinstall_site_py�
setuptoolsZbootstrap_install_fromrZinstall_namespacesr�infor"r#�dry_run�open�writerZprocess_distributionZno_deps)rZbpy_cmdZ
build_pathZei_cmd�frrrr
ns:




�


 zdevelop.install_for_developmentcCs�tj�|j�rzt�d|j|j�t|j�}dd�|D�}|��||j	g|j	|j
gfkrht�d|�dS|jszt�
|j�|js�|�|j�|jjr�t�d�dS)NzRemoving %s (link to %s)cSsg|]}|���qSr)r0)�.0�linerrr�
<listcomp>�sz*develop.uninstall_link.<locals>.<listcomp>z$Link points to %s: uninstall abortedz5Note: you must uninstall or replace scripts manually!)rr�existsr"rr9r#r;�closerr�warnr:�unlinkZ
update_pthr(r6�scripts)rZ
egg_link_file�contentsrrrr�s 

�zdevelop.uninstall_linkc
Cs�||jk	rt�||�S|�|�|jjp*gD]N}tj�t	|��}tj�
|�}t�|��}|�
�}W5QRX|�||||�q,dS�N)r(r�install_egg_scripts�install_wrapper_scriptsr6rErrr$r�basename�ior;�readZinstall_script)rr(Zscript_nameZscript_pathZstrmZscript_textrrrrH�s

zdevelop.install_egg_scriptscCst|�}t�||�SrG)�VersionlessRequirementrrI�rr(rrrrI�szdevelop.install_wrapper_scriptsN)�__name__�
__module__�__qualname__�__doc__�descriptionrZuser_optionsZboolean_optionsZcommand_consumes_argumentsrrr�staticmethodr)r
rrHrIrrrrr	s"�	*
0r	c@s(eZdZdZdd�Zdd�Zdd�ZdS)	rMa�
    Adapt a pkg_resources.Distribution to simply return the project
    name as the 'requirement' so that scripts will work across
    multiple versions.

    >>> from pkg_resources import Distribution
    >>> dist = Distribution(project_name='foo', version='1.0')
    >>> str(dist.as_requirement())
    'foo==1.0'
    >>> adapted_dist = VersionlessRequirement(dist)
    >>> str(adapted_dist.as_requirement())
    'foo'
    cCs
||_dSrG)�_VersionlessRequirement__distrNrrr�__init__�szVersionlessRequirement.__init__cCst|j|�SrG)r5rU)r�namerrr�__getattr__�sz"VersionlessRequirement.__getattr__cCs|jSrGrrrrr�as_requirement�sz%VersionlessRequirement.as_requirementN)rOrPrQrRrVrXrYrrrrrM�srM)Zdistutils.utilrZ	distutilsrZdistutils.errorsrrrrrKZsetuptools.externrr%Zsetuptools.command.easy_installrr8r�typeZ
__metaclass__ZDevelopInstallerr	rMrrrr�<module>s6site-packages/setuptools/command/__pycache__/build_py.cpython-38.pyc000064400000020701151446177000021577 0ustar00U

�Qab|%�@s�ddlmZddlmZddlmmZddlZddlZddl	Z	ddl
Z
ddlZddl
Z
ddlmZddlmZmZmZzddlmZWn"ek
r�Gdd�d�ZYnXGd	d
�d
eje�Zddd�Zd
d�ZdS)�)�glob)�convert_pathN)�six)�map�filter�filterfalse)�	Mixin2to3c@seZdZddd�ZdS)rTcCsdS)z
do nothingN�)�self�filesZdoctestsr	r	�?/usr/lib/python3.8/site-packages/setuptools/command/build_py.py�run_2to3szMixin2to3.run_2to3N)T)�__name__�
__module__�__qualname__r
r	r	r	rrsrc@s�eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd�Zedd��Zd S)!�build_pyaXEnhanced 'build_py' command that includes data files with packages

    The data files are specified via a 'package_data' argument to 'setup()'.
    See 'setuptools.dist.Distribution' for more details.

    Also, this version of the 'build_py' command allows you to specify both
    'py_modules' and 'packages' in the same setup operation.
    cCsFtj�|�|jj|_|jjp i|_d|jkr6|jd=g|_g|_dS)N�
data_files)	�origr�finalize_options�distribution�package_data�exclude_package_data�__dict__�_build_py__updated_files�_build_py__doctests_2to3�r
r	r	rr!s
�
zbuild_py.finalize_optionscCsx|js|jsdS|jr|��|jr4|��|��|�|jd�|�|jd�|�|jd�|�t	j
j|dd��dS)z?Build modules, packages, and copy data files to build directoryNFTr)Zinclude_bytecode)Z
py_modules�packagesZ
build_modulesZbuild_packages�build_package_datar
rrZbyte_compilerrZget_outputsrr	r	r�run+szbuild_py.runcCs&|dkr|��|_|jStj�||�S)zlazily compute data filesr)�_get_data_filesrrr�__getattr__)r
�attrr	r	rr ?s
zbuild_py.__getattr__cCsJtjrt|tj�r|�d�}tj�||||�\}}|rB|j�	|�||fS)N�.)
rZPY2�
isinstanceZstring_types�splitrr�build_moduler�append)r
�moduleZmodule_file�packageZoutfile�copiedr	r	rr%Fs
�zbuild_py.build_modulecCs|��tt|j|jpd��S)z?Generate list of '(package,src_dir,build_dir,filenames)' tuplesr	)�analyze_manifest�listr�_get_pkg_data_filesrrr	r	rrPszbuild_py._get_data_filescsJ|�|��tjj|jg|�d��}�fdd�|�|��D�}|�||fS)Nr"csg|]}tj�|���qSr	)�os�path�relpath)�.0�file��src_dirr	r�
<listcomp>]s�z0build_py._get_pkg_data_files.<locals>.<listcomp>)�get_package_dirr-r.�joinZ	build_libr$�find_data_files)r
r(�	build_dir�	filenamesr	r2rr,Us


�zbuild_py._get_pkg_data_filescCsX|�|j||�}tt|�}tj�|�}ttj	j
|�}t�|j�|g�|�}|�
|||�S)z6Return filenames for package's data files in 'src_dir')�_get_platform_patternsrrr�	itertools�chain�
from_iterablerr-r.�isfile�manifest_files�get�exclude_data_files)r
r(r3�patternsZglobs_expandedZ
globs_matchesZ
glob_filesrr	r	rr7cs�
�zbuild_py.find_data_filesc
Cs�|jD]|\}}}}|D]j}tj�||�}|�tj�|��tj�||�}|�||�\}}	tj�|�}|	r||jj	kr|j
�|�qqdS)z$Copy data files into build directoryN)rr-r.r6Zmkpath�dirnameZ	copy_file�abspathrZconvert_2to3_doctestsrr&)
r
r(r3r8r9�filename�targetZsrcfileZoutfr)r	r	rrts
�zbuild_py.build_package_datacCs�i|_}|jjsdSi}|jp"dD]}||t|�|��<q$|�d�|�d�}|jj	D]�}t
j�t|��\}}d}|}	|r�||kr�||kr�|}t
j�|�\}}
t
j�
|
|�}qx||krX|�d�r�||	kr�qX|�||g��|�qXdS)Nr	Zegg_infoz.py)r?rZinclude_package_datar�assert_relativer5Zrun_commandZget_finalized_commandZfilelistrr-r.r$r6�endswith�
setdefaultr&)r
ZmfZsrc_dirsr(Zei_cmdr.�d�f�prevZoldfZdfr	r	rr*�s(


zbuild_py.analyze_manifestcCsdS�Nr	rr	r	r�get_data_files�szbuild_py.get_data_filesc	Cs�z|j|WStk
r YnXtj�|||�}||j|<|rH|jjsL|S|jjD]}||ksn|�|d�rTqxqT|St�	|d��}|�
�}W5QRXd|kr�tj�
d|f��|S)z8Check namespace packages' __init__ for declare_namespacer"�rbsdeclare_namespacez�Namespace package problem: %s is a namespace package, but its
__init__.py does not call declare_namespace()! Please fix it.
(See the setuptools manual under "Namespace Packages" for details.)
")�packages_checked�KeyErrorrr�
check_packagerZnamespace_packages�
startswith�io�open�read�	distutils�errorsZDistutilsError)r
r(Zpackage_dirZinit_pyZpkgrK�contentsr	r	rrR�s*
��zbuild_py.check_packagecCsi|_tj�|�dSrM)rPrr�initialize_optionsrr	r	rrZ�szbuild_py.initialize_optionscCs0tj�||�}|jjdk	r,tj�|jj|�S|SrM)rrr5rZsrc_rootr-r.r6)r
r(�resr	r	rr5�szbuild_py.get_package_dircs\t���|�|j||�}�fdd�|D�}tj�|�}t|���fdd��D�}tt|��S)z6Filter filenames for package's data files in 'src_dir'c3s|]}t��|�VqdSrM)�fnmatchr�r0�pattern)rr	r�	<genexpr>�s�z.build_py.exclude_data_files.<locals>.<genexpr>c3s|]}|�kr|VqdSrMr	)r0�fn)�badr	rr_�s�)r+r:rr;r<r=�set�_unique_everseen)r
r(r3rrBZmatch_groupsZmatchesZkeepersr	)rarrrA�s�
�
�zbuild_py.exclude_data_filescs.t�|�dg�|�|g��}�fdd�|D�S)z�
        yield platform-specific path patterns (suitable for glob
        or fn_match) from a glob-based spec (such as
        self.package_data or self.exclude_package_data)
        matching package in src_dir.
        �c3s |]}tj��t|��VqdSrM)r-r.r6rr]r2r	rr_�s�z2build_py._get_platform_patterns.<locals>.<genexpr>)r;r<r@)�specr(r3Zraw_patternsr	r2rr:�s

�
�zbuild_py._get_platform_patternsN)rrr�__doc__rrr r%rr,r7rr*rNrRrZr5rA�staticmethodr:r	r	r	rrs"	


rccsbt�}|j}|dkr6t|j|�D]}||�|Vq n(|D]"}||�}||kr:||�|Vq:dS)zHList unique elements, preserving order. Remember all elements ever seen.N)rb�addr�__contains__)�iterable�key�seenZseen_addZelement�kr	r	rrc�s
rccCs:tj�|�s|Sddlm}t�d���|}||��dS)Nr)�DistutilsSetupErrorz�
        Error: setup script specifies an absolute path:

            %s

        setup() arguments must *always* be /-separated paths relative to the
        setup.py directory, *never* absolute paths.
        )r-r.�isabs�distutils.errorsrn�textwrap�dedent�lstrip)r.rn�msgr	r	rrGs�rG)N)rZdistutils.utilrZdistutils.command.build_pyZcommandrrr-r\rqrTrprWr;Zsetuptools.externrZsetuptools.extern.six.movesrrrZsetuptools.lib2to3_exr�ImportErrorrcrGr	r	r	r�<module>s$Y
site-packages/setuptools/command/__pycache__/upload.cpython-38.opt-1.pyc000064400000012123151446177000022212 0ustar00U

�Qab��@s�ddlZddlZddlZddlZddlmZddlmZddlm	Z
ddlmZddl
mZddlmZmZddlmZdd	lmZGd
d�de
j	�Z	dS)�N)�standard_b64encode)�log)�upload)�spawn)�DistutilsError)�urlopen�Request)�	HTTPError)�urlparsec@s8eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�ZdS)
rza
    Override default upload behavior to obtain password
    in a variety of different ways.
    c
Cs&ztj�|�W5|�dtj�XdS)NzjWARNING: Uploading via this command is deprecated, use twine to upload instead (https://pypi.org/p/twine/))�announcerZWARN�origr�run��self�r�=/usr/lib/python3.8/site-packages/setuptools/command/upload.pyr
s�z
upload.runcCs8tj�|�|jpt��|_|jp0|��p0|��|_dS�N)	rr�finalize_options�username�getpassZgetuser�password�_load_password_from_keyring�_prompt_for_passwordrrrrr"s���zupload.finalize_optionsc Cs�t|j�\}}}}}}	|s"|s"|	r0td|j��|dkrDtd|��|jr|ddd|g}
|jrnd|jg|
dd�<t|
|jd	�t|d
��}|��}W5QRX|j	j
}
dd|
��|
��t
j�|�|f||t�|���t|
���|
��|
��|
��|
��|
��|
��|
��|
��|
��|
��|
��|
� �|
�!�d
�}d|d<|j�rdt
j�|�dt|dd
���f|d<|j"d|j#�$d�}dt%|��&d�}d}d|�$d�}|d}t'�(�}|�)�D]�\}}d|}t*|t+��s�|g}|D]j}t,|�t-k�r|d|d7}|d}nt|��$d�}|�.|�|�.|�$d��|�.d�|�.|��qܐq�|�.|�|�/�}d||jf}|�0|t1j2�d|tt3|��|d �}t4|j||d!�}zt5|�}|�6�}|j7}Wnft8k
�r�}z|j9}|j7}W5d}~XYn8t:k
�r"}z|�0t|�t1j;��W5d}~XYnX|d"k�r�|�0d#||ft1j2�|j<�r�t=|d$d%d&��|�}|dk	�r�d'�>d(|d(f�}|�0|t1j2�n"d)||f}|�0|t1j;�t?|��dS)*NzIncompatible url %s)ZhttpZhttpszunsupported schema Zgpgz
--detach-signz-az--local-user�)�dry_run�rbZfile_upload�1)z:actionZprotocol_version�name�version�contentZfiletype�	pyversionZ
md5_digestZmetadata_versionZsummaryZ	home_pageZauthorZauthor_email�license�description�keywords�platformZclassifiersZdownload_urlZprovidesZrequiresZ	obsoletes�Zcommentz.ascZ
gpg_signature�:�asciizBasic z3--------------GHSKFJDLGDS7543FJKLFHRE75642756743254s
--s--
z+
Content-Disposition: form-data; name="%s"z; filename="%s"r�zutf-8s

zSubmitting %s to %sz multipart/form-data; boundary=%s)zContent-typezContent-lengthZ
Authorization)�data�headers��zServer response (%s): %sZ_read_pypi_responsecSsdSrr)�xrrr�<lambda>��z$upload.upload_file.<locals>.<lambda>�
zK---------------------------------------------------------------------------zUpload failed (%s): %s)@r
�
repository�AssertionErrorZsignZidentityrr�open�readZdistributionZmetadataZget_nameZget_version�os�path�basename�hashlibZmd5Z	hexdigest�strZget_metadata_versionZget_descriptionZget_urlZget_contactZget_contact_emailZget_licenceZget_long_descriptionZget_keywordsZ
get_platformsZget_classifiersZget_download_urlZget_providesZget_requiresZ
get_obsoletesrr�encoder�decode�io�BytesIO�items�
isinstance�list�type�tuple�write�getvaluerr�INFO�lenrrZgetcode�msgr	�code�OSErrorZERRORZ
show_response�getattr�joinr) rZcommandr �filenameZschemaZnetlocZurlZparamsZqueryZ	fragmentsZgpg_args�fr�metar)Z	user_passZauth�boundaryZsep_boundaryZend_boundaryZbody�key�value�titlerFr*Zrequest�resultZstatus�reason�e�textrrr�upload_file0s���
�!�




��

���
zupload.upload_filecCs4ztd�}|�|j|j�WStk
r.YnXdS)zM
        Attempt to load password from keyring. Suppress Exceptions.
        �keyringN)�
__import__Zget_passwordr0r�	Exception)rrWrrrr�s
z"upload._load_password_from_keyringc	Cs(z
t��WSttfk
r"YnXdS)zH
        Prompt for a password on the tty. Suppress Exceptions.
        N)rrY�KeyboardInterruptrrrrr�s
zupload._prompt_for_passwordN)	�__name__�
__module__�__qualname__�__doc__r
rrVrrrrrrrs

r)r;r4r7r�base64rZ	distutilsrZdistutils.commandrrZdistutils.spawnrZdistutils.errorsrZ*setuptools.extern.six.moves.urllib.requestrrZ(setuptools.extern.six.moves.urllib.errorr	Z(setuptools.extern.six.moves.urllib.parser
rrrr�<module>ssite-packages/setuptools/command/__pycache__/register.cpython-38.opt-1.pyc000064400000001363151446177000022556 0ustar00U

�Qab�@s4ddlmZddlmmZGdd�dej�ZdS)�)�logNc@seZdZejjZdd�ZdS)�registerc
Cs0z|�d�tj�|�W5|�dtj�XdS)Nz[WARNING: Registering is deprecated, use twine to upload instead (https://pypi.org/p/twine/)Zegg_info)ZannouncerZWARNZrun_command�origr�run)�self�r�?/usr/lib/python3.8/site-packages/setuptools/command/register.pyrs
�zregister.runN)�__name__�
__module__�__qualname__rr�__doc__rrrrrrsr)Z	distutilsrZdistutils.command.registerZcommandrrrrrr�<module>ssite-packages/setuptools/command/__pycache__/bdist_egg.cpython-38.pyc000064400000033546151446177000021732 0ustar00U

�Qab	G�@sxdZddlmZddlmZmZddlmZddlm	Z	ddl
Z
ddlZddlZddl
Z
ddlZddlmZddlmZmZmZdd	lmZdd
lmZddlmZzddlmZmZd
d�ZWn,ek
r�ddlm Z mZdd�ZYnXdd�Z!dd�Z"dd�Z#Gdd�de�Z$e%�&d�'��Z(dd�Z)dd�Z*dd�Z+d d!d"�Z,d#d$�Z-d%d&�Z.d'd(�Z/d)d*d+d,gZ0d1d/d0�Z1dS)2z6setuptools.command.bdist_egg

Build .egg distributions�)�DistutilsSetupError)�remove_tree�mkpath)�log)�CodeTypeN)�six)�get_build_platform�Distribution�ensure_directory)�
EntryPoint)�Library)�Command)�get_path�get_python_versioncCstd�S)NZpurelib)r�rr�@/usr/lib/python3.8/site-packages/setuptools/command/bdist_egg.py�_get_purelibsr)�get_python_librcCstd�S)NF)rrrrrrscCs2d|krtj�|�d}|�d�r.|dd�}|S)N�.r�modulei����)�os�path�splitext�endswith)�filenamerrr�strip_module#s

rccs6t�|�D]&\}}}|��|��|||fVq
dS)zbDo os.walk in a reproducible way,
    independent of indeterministic filesystem readdir order
    N)r�walk�sort)�dir�base�dirs�filesrrr�sorted_walk+sr"c	Cs6t�d���}t|d��}|�||�W5QRXdS)NaR
        def __bootstrap__():
            global __bootstrap__, __loader__, __file__
            import sys, pkg_resources, imp
            __file__ = pkg_resources.resource_filename(__name__, %r)
            __loader__ = None; del __bootstrap__, __loader__
            imp.load_dynamic(__name__,__file__)
        __bootstrap__()
        �w)�textwrap�dedent�lstrip�open�write)�resource�pyfileZ_stub_template�frrr�
write_stub5s	r,c@s�eZdZdZdddde�fdddd	gZd
ddgZd
d�Zdd�Zdd�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd �Zd!d"�Zd#S)$�	bdist_eggzcreate an "egg" distribution)z
bdist-dir=�bz1temporary directory for creating the distributionz
plat-name=�pz;platform name to embed in generated filenames (default: %s))�exclude-source-filesNz+remove all .py files from the generated egg)�	keep-temp�kzPkeep the pseudo-installation tree around after creating the distribution archive)z	dist-dir=�dz-directory to put final built distributions in)�
skip-buildNz2skip rebuilding everything (for testing/debugging)r1r4r0cCs.d|_d|_d|_d|_d|_d|_d|_dS)Nr)�	bdist_dir�	plat_name�	keep_temp�dist_dir�
skip_build�
egg_output�exclude_source_files��selfrrr�initialize_optionsZszbdist_egg.initialize_optionscCs�|�d�}|_|j|_|jdkr>|�d�j}tj�|d�|_|jdkrPt	�|_|�
dd�|jdkr�tdd|j
|jt�|j��o�|j��
�}tj�|j|d�|_dS)N�egg_infoZbdistZegg)r8r8z.egg)�get_finalized_command�ei_cmdr?r5�
bdist_baserr�joinr6rZset_undefined_optionsr:r	Zegg_nameZegg_versionr�distribution�has_ext_modulesr8)r=rArB�basenamerrr�finalize_optionscs$


�zbdist_egg.finalize_optionscCs�|j|�d�_tj�tj�t���}|jj	g}|j_	|D]�}t
|t�r�t|�dkr�tj�
|d�r�tj�|d�}tj�|�}||ks�|�|tj�r�|t|�dd�|df}|jj	�|�q:z"t�d|j�|jdddd�W5||j_	XdS)N�install�r�zinstalling package data to %s�install_data)�force�root)r5r@�install_librr�normcase�realpathrrD�
data_files�
isinstance�tuple�len�isabs�
startswith�sep�appendr�info�call_command)r=Z
site_packages�old�itemrPZ
normalizedrrr�do_install_data{s"�zbdist_egg.do_install_datacCs|jgS)N)r:r<rrr�get_outputs�szbdist_egg.get_outputscKsPtD]}|�||j�q|�d|j�|�d|j�|j|f|�}|�|�|S)z8Invoke reinitialized command `cmdname` with keyword argsr9�dry_run)�INSTALL_DIRECTORY_ATTRS�
setdefaultr5r9r_Zreinitialize_command�run_command)r=Zcmdname�kw�dirname�cmdrrrrZ�s
zbdist_egg.call_commandcCs�|�d�t�d|j�|�d�}|j}d|_|j��rH|jsH|�d�|j	ddd�}||_|�
�\}}g|_g}t|�D]|\}}t
j�|�\}	}
t
j�|jt|	�d�}|j�|�t�d	|�|js�tt
j�|�|�|�|�|�t
jd
�||<qz|�r|�|�|jj�r|��|j}t
j�|d�}
|�|
�|jj�rlt
j�|
d�}t�d
|�|j	d|dd�|�|
�t
j�|
d�}|�r�t�d|�|j�st|�t|d�}|� d�|��|� d�|�!�n,t
j�"|��rt�d|�|j�st
�#|�t$t
j�|d�|�%��t
j�&t
j�|j'd���r<t�(d�|j)�rL|�*�t+|j,||j-|j|�.�d�|j/�s�t0|j|jd�t1|jdg��dt2�|j,f�dS)Nr?zinstalling library code to %srHZ
build_clibrNr)Zwarn_dir�.pyzcreating stub loader for %s�/�EGG-INFO�scriptszinstalling scripts to %sZinstall_scriptsrJ)�install_dirZno_epznative_libs.txtz
writing %s�wt�
zremoving %szdepends.txtzxWARNING: 'depends.txt' will not be used by setuptools 0.6!
Use the install_requires/extras_require setup() args instead.)�verboser_�mode�r_Z
dist_filesr-)3rbrrYr5r@rMrDZhas_c_librariesr9rZ�get_ext_outputs�stubs�	enumeraterrrrCrrXr_r,rF�replacerWZbyte_compilerQr]rri�copy_metadata_tor
r'r(�close�isfile�unlink�write_safety_flag�zip_safe�existsr?�warnr;�zap_pyfiles�make_zipfiler:rm�
gen_headerr7r�getattrr)r=ZinstcmdZold_rootre�all_outputs�ext_outputsZ
to_compiler/Zext_namer�extr*Zarchive_rootr?Z
script_dirZnative_libsZ	libs_filerrr�run�s�


�




�




����z
bdist_egg.runc

Cs�t�d�t|j�D]�\}}}|D]�}tj�||�}|�d�rTt�d|�t�	|�|�d�r"|}d}t
�||�}tj�|tj|�
d�d�}	t�d||	f�zt�|	�Wntk
r�YnXt�||	�q"qdS)	Nz+Removing .py files from temporary directoryrfzDeleting %s�__pycache__z#(?P<name>.+)\.(?P<magic>[^.]+)\.pyc�name�.pyczRenaming file from [%s] to [%s])rrY�walk_eggr5rrrCr�debugrw�re�match�pardir�group�remove�OSError�rename)
r=rr r!r�rZpath_old�pattern�mZpath_newrrrr|�s4



���zbdist_egg.zap_pyfilescCs2t|jdd�}|dk	r|St�d�t|j|j�S)Nryz4zip_safe flag not set; analyzing archive contents...)rrDrr{�analyze_eggr5rq)r=�saferrrrys

zbdist_egg.zip_safec
Cs�t�|jjpd�}|�di��d�}|dkr0dS|jr<|jrJtd|f��djt	j
�}|j}d�|j�}|jd}t
j�|j�}d	t�}|js�tt
j�|j�|jd
�t|jd�}	|	�|�|	��dS)N�zsetuptools.installationZeggsecutabler#zGeggsecutable entry point (%r) cannot have 'extras' or refer to a modulez{}.{}rraH#!/bin/sh
if [ `basename $0` = "%(basename)s" ]
then exec python%(pyver)s -c "import sys, os; sys.path.insert(0, os.path.abspath('$0')); from %(pkg)s import %(base)s; sys.exit(%(full)s())" "$@"
else
  echo $0 is not the correct name for this egg file.
  echo Please rename it back to %(basename)s and try again.
  exec false
fi
ro�a)rZ	parse_maprDZentry_points�getZattrsZextrasr�format�sys�version_infoZmodule_namerCrrrFr:�localsr_rrdr'r(ru)
r=ZepmZepZpyver�pkgZfullrrF�headerr+rrrr~s0��
�
zbdist_egg.gen_headercCshtj�|j�}tj�|d�}|jjjD]<}|�|�r&tj�||t	|�d��}t
|�|�||�q&dS)z*Copy metadata (egg info) to the target_dirr�N)rr�normpathr?rCrAZfilelistr!rVrTr
Z	copy_file)r=Z
target_dirZ
norm_egg_info�prefixr�targetrrrrt:s
zbdist_egg.copy_metadata_tocCsg}g}|jdi}t|j�D]f\}}}|D].}tj�|�d��tkr*|�|||�q*|D]"}|||d|tj�||�<q^q|j	�
�r�|�d�}|jD]Z}	t
|	t�r�q�|�|	j�}
|�|
�}tj�|��d�s�tj�tj�|j|��r�|�|�q�||fS)zAGet a list of relative paths to C extensions in the output distror�rJrgZ	build_extzdl-)r5r"rrr�lower�NATIVE_EXTENSIONSrXrCrDrEr@�
extensionsrRrZget_ext_fullnamer�Zget_ext_filenamerFrVrz)r=r�r��pathsrr r!rZ	build_cmdr��fullnamerrrrpFs0
��




zbdist_egg.get_ext_outputsN)�__name__�
__module__�__qualname__�descriptionrZuser_optionsZboolean_optionsr>rGr]r^rZr�r|ryr~rtrprrrrr-Cs2���	
Q'r-z.dll .so .dylib .pydccsHt|�}t|�\}}}d|kr(|�d�|||fV|D]
}|Vq8dS)z@Walk an unpacked egg's contents, skipping the metadata directoryrhN)r"�nextr�)�egg_dirZwalkerrr r!Zbdfrrrr�fs
r�c	Cs�t��D](\}}tj�tj�|d|��r|Sqt�s<dSd}t|�D]R\}}}|D]B}|�d�sV|�d�rrqVqV|�d�s�|�d�rVt	||||�o�|}qVqH|S)NrhFTrfz.pywr�z.pyo)
�safety_flags�itemsrrrzrC�can_scanr�r�scan_module)	r�rq�flag�fnr�rr r!r�rrrr�qs
r�cCs�t��D]r\}}tj�||�}tj�|�rJ|dks>t|�|krzt�|�q|dk	rt|�|krt|d�}|�	d�|�
�qdS)Nrkrl)r�r�rrrCrz�boolrwr'r(ru)r�r�r�r�r+rrrrx�s

rxzzip-safeznot-zip-safe)TFc
Cstj�||�}|dd�|kr"dS|t|�dd��tjd�}||rJdpLdtj�|�d}tjrld}nt	j
d	kr|d
}nd}t|d�}|�|�t
�|�}	|��d}
t�t|	��}d
D]}||kr�t�d||�d}
q�d|k�r
dD]}||kr�t�d||�d}
q�|
S)z;Check whether module possibly uses unsafe-for-zipfile stuffN���TrJrr�r�)�����rb)�__file__�__path__z%s: module references %sF�inspect)Z	getsourceZ
getabsfileZ
getsourcefileZgetfilegetsourcelinesZ
findsourceZgetcommentsZgetframeinfoZgetinnerframesZgetouterframes�stackZtracez"%s: module MAY be using inspect.%s)rrrCrTrsrWrrZPY2r�r�r'�read�marshal�loadru�dict�fromkeys�iter_symbolsrr{)
r�rr�rqrr�r�skipr+�coder�ZsymbolsZbadrrrr��s4 




r�ccsT|jD]
}|Vq|jD]6}t|tj�r0|Vqt|t�rt|�D]
}|VqBqdS)zBYield names and strings used by `code` and its nested code objectsN)�co_names�	co_constsrRrZstring_typesrr�)r�r��constrrrr��s


r�cCs2tj�d�stjdkrdSt�d�t�d�dS)N�javaZcliTz1Unable to analyze compiled code on this platform.zfPlease ask the author to include a 'zip_safe' setting (either True or False) in the package's setup.py)r��platformrVrr{rrrrr��s
r�rNrjrKZinstall_baseTr#c
s�ddl}ttj�|��d�t�d|����fdd�}|rB|jn|j}�s�|j	|||d�}	t
��D]\}
}}||	|
|�qd|	��n t
��D]\}
}}|d|
|�q�|S)aqCreate a zip file from all the files under 'base_dir'.  The output
    zip file will be named 'base_dir' + ".zip".  Uses either the "zipfile"
    Python module (if available) or the InfoZIP "zip" utility (if installed
    and found on the default search path).  If neither tool is available,
    raises DistutilsExecError.  Returns the name of the output zip file.
    rNroz#creating '%s' and adding '%s' to itcs`|D]V}tj�tj�||��}tj�|�r|t��dd�}�sN|�||�t�d|�qdS)NrJzadding '%s')	rrr�rCrvrTr(rr�)�zrd�namesr�rr/��base_dirr_rr�visit�szmake_zipfile.<locals>.visit)�compression)�zipfilerrrrdrrYZZIP_DEFLATEDZ
ZIP_STOREDZZipFiler"ru)
Zzip_filenamer�rmr_�compressrnr�r�r�r�rdr r!rr�rr}�s	
r})rrTr#)2�__doc__Zdistutils.errorsrZdistutils.dir_utilrrZ	distutilsr�typesrr�rr�r$r�Zsetuptools.externrZ
pkg_resourcesrr	r
rZsetuptools.extensionrZ
setuptoolsr
Z	sysconfigrrr�ImportErrorZdistutils.sysconfigrrr"r,r-r�r��splitr�r�r�rxr�r�r�r�r`r}rrrr�<module>sX
"�$
��site-packages/setuptools/command/__pycache__/egg_info.cpython-38.opt-1.pyc000064400000052404151446177000022511 0ustar00U

�Qab�c�@s�dZddlmZddlmZddlmZddlm	Z	ddlZddlZddl
Z
ddlZddlZddl
Z
ddlZddlZddlZddlmZddlmZdd	lmZdd
lmZddlmZddlmZdd
lmZddlmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&ddl'm(Z(ddl)m*Z*ddlm+Z+ddlm,Z,dd�Z-Gdd�d�Z.Gdd�de.e�Z/Gdd�de�ZGdd�de�Z0dd�Z1dd�Z2d d!�Z3d"d#�Z4d$d%�Z5d&d'�Z6d(d)�Z7d*d+�Z8d5d-d.�Z9d/d0�Z:d1d2�Z;Gd3d4�d4e,�Z<dS)6zUsetuptools.command.egg_info

Create a distribution's .egg-info directory and contents�)�FileList)�DistutilsInternalError)�convert_path)�logN)�six)�map)�Command)�sdist)�walk_revctrl)�edit_config)�	bdist_egg)�parse_requirements�	safe_name�
parse_version�safe_version�yield_lines�
EntryPoint�iter_entry_points�to_filename)�glob)�	packaging)�SetuptoolsDeprecationWarningcCs�d}|�tjj�}t�tj�}d|f}t|�D�]�\}}|t|�dk}|dkrr|r`|d7}q0|d||f7}q0d}t|�}	||	k�r�||}
|
dkr�||d7}�n|
d	kr�||7}n�|
d
k�r�|d}||	kr�||dkr�|d}||	k�r||dk�r|d}||	k�r,||dk�r,|d}�q||	k�rF|t�|
�7}nR||d|�}d}
|ddk�rxd
}
|dd�}|
t�|�7}
|d|
f7}|}n|t�|
�7}|d7}q~|s0||7}q0|d7}tj|tj	tj
Bd�S)z�
    Translate a file path glob like '*.txt' in to a regular expression.
    This differs from fnmatch.translate which allows wildcards to match
    directory separators. It also knows about '**/' which matches any number of
    directories.
    �z[^%s]��**z.*z
(?:%s+%s)*r�*�?�[�!�]�^Nz[%s]z\Z)�flags)�split�os�path�sep�re�escape�	enumerate�len�compile�	MULTILINE�DOTALL)rZpatZchunksr%Z
valid_char�c�chunkZ
last_chunk�iZ	chunk_len�charZinner_i�innerZ
char_class�r2�?/usr/lib/python3.8/site-packages/setuptools/command/egg_info.py�translate_pattern$sV







r4c@s8eZdZdZdZedd��Zdd�Zdd�Zee�Z	dS)�
InfoCommonNcCst|j���S�N)r�distributionZget_name��selfr2r2r3�name{szInfoCommon.namecCs2|j��}|jr$|�|j�r$t|�St||j�Sr6)r7Zget_version�vtags�endswithr�r9�versionr2r2r3�tagged_versions
zInfoCommon.tagged_versioncCs,d}|jr||j7}|jr(|t�d�7}|S)Nrz-%Y%m%d)�	tag_build�tag_date�time�strftimer=r2r2r3�tags�s
zInfoCommon.tags)
�__name__�
__module__�__qualname__r@rA�propertyr:r?rDr;r2r2r2r3r5ws
r5c@s�eZdZdZddddgZdgZddiZdd	�Zed
d��Z	e	j
dd��Z	d
d�Zdd�Zddd�Z
dd�Zdd�Zdd�Zdd�Zdd�ZdS) �egg_infoz+create a distribution's .egg-info directory)z	egg-base=�ezLdirectory containing .egg-info directories (default: top of the source tree))�tag-date�dz0Add date stamp (e.g. 20050528) to version number)z
tag-build=�bz-Specify explicit tag to add to version number)�no-date�Dz"Don't include date stamp [default]rKrNcCs"d|_d|_d|_d|_d|_dS)NF)�egg_base�egg_namerI�egg_version�broken_egg_infor8r2r2r3�initialize_options�s
zegg_info.initialize_optionscCsdSr6r2r8r2r2r3�tag_svn_revision�szegg_info.tag_svn_revisioncCsdSr6r2)r9�valuer2r2r3rU�scCs0t��}|��|d<d|d<t|t|d��dS)z�
        Materialize the value of date into the
        build tag. Install build keys in a deterministic order
        to avoid arbitrary reordering on subsequent builds.
        r@rrA)rIN)�collections�OrderedDictrDr�dict)r9�filenamerIr2r2r3�save_version_info�szegg_info.save_version_infocCsB|j|_|��|_t|j�}z6t|tjj�}|r4dnd}t	t
||j|jf��Wn,tk
r~tj
�d|j|jf��YnX|jdkr�|jj}|p�i�dtj�|_|�d�t|j�d|_|jtjkr�tj�|j|j�|_d|jkr�|��|j|jj_|jj}|dk	�r>|j|j��k�r>|j|_t|j�|_ d|j_dS)Nz%s==%sz%s===%sz2Invalid distribution name or version syntax: %s-%srrP�	.egg-info�-)!r:rQr?rRr�
isinstancerr>ZVersion�listr
�
ValueError�	distutils�errorsZDistutilsOptionErrorrPr7Zpackage_dir�getr#�curdirZensure_dirnamerrIr$�join�check_broken_egg_info�metadataZ
_patched_dist�key�lowerZ_versionZ_parsed_version)r9Zparsed_versionZ
is_version�spec�dirsZpdr2r2r3�finalize_options�s>


��
��



zegg_info.finalize_optionsFcCsL|r|�|||�n4tj�|�rH|dkr>|s>t�d||�dS|�|�dS)a�Write `data` to `filename` or delete if empty

        If `data` is non-empty, this routine is the same as ``write_file()``.
        If `data` is empty but not ``None``, this is the same as calling
        ``delete_file(filename)`.  If `data` is ``None``, then this is a no-op
        unless `filename` exists, in which case a warning is issued about the
        orphaned file (if `force` is false), or deleted (if `force` is true).
        Nz$%s not set in setup(), but %s exists)�
write_filer#r$�existsr�warn�delete_file)r9�whatrZ�data�forcer2r2r3�write_or_delete_file�s	�zegg_info.write_or_delete_filecCsDt�d||�tjr|�d�}|js@t|d�}|�|�|��dS)z�Write `data` to `filename` (if not a dry run) after announcing it

        `what` is used in a log message to identify what is being written
        to the file.
        zwriting %s to %s�utf-8�wbN)	r�inforZPY3�encode�dry_run�open�write�close)r9rqrZrr�fr2r2r3rms


zegg_info.write_filecCs t�d|�|jst�|�dS)z8Delete `filename` (if not a dry run) after announcing itzdeleting %sN)rrwryr#�unlink)r9rZr2r2r3rpszegg_info.delete_filecCs�|�|j�t�|jd�|jj}td�D]4}|j|d�|��}|||j	tj
�|j|j	��q*tj
�|jd�}tj
�|�r�|�
|�|��dS)Nzegg_info.writers)�	installerznative_libs.txt)ZmkpathrIr#�utimer7Zfetch_build_eggrZrequireZresolver:r$rernrp�find_sources)r9r�ep�writer�nlr2r2r3�runs
zegg_info.runcCs4tj�|jd�}t|j�}||_|��|j|_dS)z"Generate SOURCES.txt manifest filezSOURCES.txtN)	r#r$rerI�manifest_makerr7�manifestr��filelist)r9Zmanifest_filenameZmmr2r2r3r�*s

zegg_info.find_sourcescCsT|jd}|jtjkr&tj�|j|�}tj�|�rPt�d||j	�|j	|_
||_	dS)Nr\aB------------------------------------------------------------------------------
Note: Your current .egg-info directory has a '-' in its name;
this will not work correctly with "setup.py develop".

Please rename %s to %s to correct this problem.
------------------------------------------------------------------------------)rQrPr#rdr$rernrrorIrS)r9Zbeir2r2r3rf2s
�zegg_info.check_broken_egg_infoN)F)rErFrG�descriptionZuser_optionsZboolean_optionsZnegative_optrTrHrU�setterr[rlrtrmrpr�r�rfr2r2r2r3rI�s.��



1
rIc@s|eZdZdd�Zdd�Zdd�Zdd�Zd	d
�Zdd�Zd
d�Z	dd�Z
dd�Zdd�Zdd�Z
dd�Zdd�Zdd�ZdS)rcCs |�|�\}}}}|dkrR|�dd�|��|D]}|�|�s2t�d|�q2�n�|dkr�|�dd�|��|D]}|�|�srt�d|�qr�n�|dkr�|�d	d�|��|D]}|�|�s�t�d
|�q��nJ|dk�r|�dd�|��|D]}|�|�s�t�d
|�q�n|dk�r`|�d|d�|�f�|D]"}|�	||��s:t�d||��q:n�|dk�r�|�d|d�|�f�|D]"}|�
||��s�t�d||��q�np|dk�r�|�d|�|�|��st�d|�n>|dk�r|�d|�|�|��st�d|�nt
d|��dS)N�includezinclude � z%warning: no files found matching '%s'�excludezexclude z9warning: no previously-included files found matching '%s'zglobal-includezglobal-include z>warning: no files found matching '%s' anywhere in distributionzglobal-excludezglobal-exclude zRwarning: no previously-included files matching '%s' found anywhere in distributionzrecursive-includezrecursive-include %s %sz:warning: no files found matching '%s' under directory '%s'zrecursive-excludezrecursive-exclude %s %szNwarning: no previously-included files matching '%s' found under directory '%s'�graftzgraft z+warning: no directories found matching '%s'�prunezprune z6no previously-included directories found matching '%s'z'this cannot happen: invalid action '%s')Z_parse_template_line�debug_printrer�rror��global_include�global_exclude�recursive_include�recursive_excluder�r�r)r9�line�actionZpatterns�dirZdir_pattern�patternr2r2r3�process_template_lineEs|

�

�


�

��

��

�
��zFileList.process_template_linecCsRd}tt|j�ddd�D]2}||j|�r|�d|j|�|j|=d}q|S)z�
        Remove all files from the file list that match the predicate.
        Return True if any matching files were removed
        Fr���z
 removing T)�ranger)�filesr�)r9Z	predicate�foundr/r2r2r3�
_remove_files�szFileList._remove_filescCs$dd�t|�D�}|�|�t|�S)z#Include files that match 'pattern'.cSsg|]}tj�|�s|�qSr2�r#r$�isdir��.0r}r2r2r3�
<listcomp>�sz$FileList.include.<locals>.<listcomp>�r�extend�bool�r9r�r�r2r2r3r��s
zFileList.includecCst|�}|�|j�S)z#Exclude files that match 'pattern'.)r4r��match�r9r�r�r2r2r3r��szFileList.excludecCs8tj�|d|�}dd�t|dd�D�}|�|�t|�S)zN
        Include all files anywhere in 'dir/' that match the pattern.
        rcSsg|]}tj�|�s|�qSr2r�r�r2r2r3r��s�z.FileList.recursive_include.<locals>.<listcomp>T)�	recursive)r#r$rerr�r�)r9r�r�Zfull_patternr�r2r2r3r��s
zFileList.recursive_includecCs ttj�|d|��}|�|j�S)zM
        Exclude any file anywhere in 'dir/' that match the pattern.
        r�r4r#r$rer�r�)r9r�r�r�r2r2r3r��szFileList.recursive_excludecCs$dd�t|�D�}|�|�t|�S)zInclude all files from 'dir/'.cSs"g|]}tj�|�D]}|�qqSr2)rar��findall)r�Z	match_dir�itemr2r2r3r��s�z"FileList.graft.<locals>.<listcomp>r�)r9r�r�r2r2r3r��s
�
zFileList.graftcCsttj�|d��}|�|j�S)zFilter out files from 'dir/'.rr�)r9r�r�r2r2r3r��szFileList.prunecsJ|jdkr|��ttj�d|����fdd�|jD�}|�|�t|�S)z�
        Include all files anywhere in the current directory that match the
        pattern. This is very inefficient on large file trees.
        Nrcsg|]}��|�r|�qSr2�r�r�r�r2r3r��s
z+FileList.global_include.<locals>.<listcomp>)Zallfilesr�r4r#r$rer�r�r�r2r�r3r��s

zFileList.global_includecCsttj�d|��}|�|j�S)zD
        Exclude all files anywhere that match the pattern.
        rr�r�r2r2r3r��szFileList.global_excludecCs8|�d�r|dd�}t|�}|�|�r4|j�|�dS)N�
r�)r<r�
_safe_pathr��append)r9r�r$r2r2r3r��s


zFileList.appendcCs|j�t|j|��dSr6)r�r��filterr�)r9�pathsr2r2r3r��szFileList.extendcCstt|j|j��|_dS)z�
        Replace self.files with only safe paths

        Because some owners of FileList manipulate the underlying
        ``files`` attribute directly, this method must be called to
        repair those paths.
        N)r_r�r�r�r8r2r2r3�_repair�szFileList._repairc	Cs�d}t�|�}|dkr(t�d|�dSt�|d�}|dkrNt�||d�dSz"tj�|�shtj�|�rnWdSWn&tk
r�t�||t	�
��YnXdS)Nz!'%s' not %s encodable -- skippingz''%s' in unexpected encoding -- skippingFruT)�
unicode_utils�filesys_decoderroZ
try_encoder#r$rn�UnicodeEncodeError�sys�getfilesystemencoding)r9r$Zenc_warnZu_pathZ	utf8_pathr2r2r3r��s

zFileList._safe_pathN)rErFrGr�r�r�r�r�r�r�r�r�r�r�r�r�r�r2r2r2r3rBsI



rc@s\eZdZdZdd�Zdd�Zdd�Zdd	�Zd
d�Zdd
�Z	e
dd��Zdd�Zdd�Z
dS)r�zMANIFEST.incCsd|_d|_d|_d|_dS)Nr)Zuse_defaultsr�Z
manifest_onlyZforce_manifestr8r2r2r3rT	sz!manifest_maker.initialize_optionscCsdSr6r2r8r2r2r3rlszmanifest_maker.finalize_optionscCsdt�|_tj�|j�s|��|��tj�|j�r<|�	�|�
�|j��|j��|��dSr6)
rr�r#r$rnr��write_manifest�add_defaults�templateZ
read_template�prune_file_list�sortZremove_duplicatesr8r2r2r3r�s

zmanifest_maker.runcCst�|�}|�tjd�S)N�/)r�r��replacer#r%)r9r$r2r2r3�_manifest_normalizes
z"manifest_maker._manifest_normalizecsB�j���fdd��jjD�}d�j}��t�j|f|�dS)zo
        Write the file list in 'self.filelist' to the manifest file
        named by 'self.manifest'.
        csg|]}��|��qSr2)r�r�r8r2r3r�*sz1manifest_maker.write_manifest.<locals>.<listcomp>zwriting manifest file '%s'N)r�r�r�r�Zexecuterm)r9r��msgr2r8r3r�"s

zmanifest_maker.write_manifestcCs|�|�st�||�dSr6)�_should_suppress_warningr	ro)r9r�r2r2r3ro.s
zmanifest_maker.warncCst�d|�S)z;
        suppress missing-file warnings from sdist
        zstandard file .*not found)r&r�)r�r2r2r3r�2sz'manifest_maker._should_suppress_warningcCs�t�|�|��|j�|j�|j�|j�tt��}|rJ|j�	|�nt
j�|j�r`|�
�t
j�d�rx|j�d�|�d�}|j�|j�dS)Nzsetup.pyrI)r	r�Z
check_licenser�r�r�r�r_r
r�r#r$rnZ
read_manifest�get_finalized_commandr�rI)r9ZrcfilesZei_cmdr2r2r3r�9s


zmanifest_maker.add_defaultscCsZ|�d�}|j��}|j�|j�|j�|�t�tj	�}|jj
d|d|dd�dS)N�buildz(^|z)(RCS|CVS|\.svn)r)Zis_regex)r�r7Zget_fullnamer�r�Z
build_baser&r'r#r%Zexclude_pattern)r9r�Zbase_dirr%r2r2r3r�Ls

�zmanifest_maker.prune_file_listN)rErFrGr�rTrlr�r�r�ro�staticmethodr�r�r�r2r2r2r3r�s
r�c	Cs8d�|�}|�d�}t|d��}|�|�W5QRXdS)z{Create a file with the specified name and write 'contents' (a
    sequence of strings without line terminators) to it.
    �
rurvN)rerxrzr{)rZ�contentsr}r2r2r3rmVs

rmc	Cs|t�d|�|jsx|jj}|j|j|_}|j|j|_}z|�	|j
�W5|||_|_Xt|jdd�}t�
|j
|�dS)Nz
writing %sZzip_safe)rrwryr7rgrRr>rQr:�write_pkg_inforI�getattrrZwrite_safety_flag)�cmd�basenamerZrgZoldverZoldnameZsafer2r2r3r�csr�cCstj�|�rt�d�dS)NzsWARNING: 'depends.txt' is not used by setuptools 0.6!
Use the install_requires/extras_require setup() args instead.)r#r$rnrro�r�r�rZr2r2r3�warn_depends_obsoletevs�r�cCs,t|pd�}dd�}t||�}|�|�dS)Nr2cSs|dS)Nr�r2)r�r2r2r3�<lambda>��z%_write_requirements.<locals>.<lambda>)rr�
writelines)�streamZreqs�linesZ	append_crr2r2r3�_write_requirements~s
r�cCsj|j}t��}t||j�|jp"i}t|�D]&}|�djft	���t|||�q,|�
d||���dS)Nz
[{extra}]
Zrequirements)r7r�StringIOr�Zinstall_requires�extras_require�sortedr{�format�varsrt�getvalue)r�r�rZZdistrrr�Zextrar2r2r3�write_requirements�s
r�cCs,t��}t||jj�|�d||���dS)Nzsetup-requirements)�ior�r�r7Zsetup_requiresrtr�)r�r�rZrrr2r2r3�write_setup_requirements�sr�cCs:t�dd�|j��D��}|�d|d�t|��d�dS)NcSsg|]}|�dd�d�qS)�.rr)r")r��kr2r2r3r��s�z(write_toplevel_names.<locals>.<listcomp>ztop-level namesr�)rY�fromkeysr7Ziter_distribution_namesrmrer�)r�r�rZZpkgsr2r2r3�write_toplevel_names�s��r�cCst|||d�dS)NT)�	write_argr�r2r2r3�
overwrite_arg�sr�FcCsHtj�|�d}t|j|d�}|dk	r4d�|�d}|�||||�dS)Nrr�)r#r$�splitextr�r7rert)r�r�rZrs�argnamerVr2r2r3r��s
r�cCs�|jj}t|tj�s|dkr"|}nn|dk	r�g}t|���D]J\}}t|tj�srt�||�}d�	tt
t|�����}|�
d||f�q:d�	|�}|�d||d�dS)Nr�z	[%s]
%s

rzentry pointsT)r7Zentry_pointsr^rZstring_typesr��itemsrZparse_grouprer�str�valuesr�rt)r�r�rZr�rrZsectionr�r2r2r3�
write_entries�s
r�c
Csjt�dt�tj�d�rft�d��>}|D]2}t�	d|�}|r(t
|�d��W5QR�Sq(W5QRXdS)zd
    Get a -r### off of PKG-INFO Version in case this is an sdist of
    a subversion revision.
    z$get_pkg_info_revision is deprecated.zPKG-INFOzVersion:.*-r(\d+)\s*$rr)�warningsro�EggInfoDeprecationWarningr#r$rnr�rzr&r��int�group)r}r�r�r2r2r3�get_pkg_info_revision�s*r�c@seZdZdZdS)r�zqClass for warning about deprecations in eggInfo in setupTools. Not ignored by default, unlike DeprecationWarning.N)rErFrG�__doc__r2r2r2r3r��sr�)F)=r�Zdistutils.filelistrZ	_FileListZdistutils.errorsrZdistutils.utilrrarr#r&r�r�r�rBrWZsetuptools.externrZsetuptools.extern.six.movesrZ
setuptoolsrZsetuptools.command.sdistr	r
Zsetuptools.command.setoptrZsetuptools.commandrZ
pkg_resourcesr
rrrrrrrZsetuptools.unicode_utilsr�Zsetuptools.globrrrr4r5rIr�rmr�r�r�r�r�r�r�r�r�r�r�r2r2r2r3�<module>sX(S2EP


site-packages/setuptools/command/__pycache__/install_scripts.cpython-38.pyc000064400000004341151446177000023207 0ustar00U

�Qab�	�@sXddlmZddlmmZddlZddlZddlm	Z	m
Z
mZGdd�dej�ZdS)�)�logN)�Distribution�PathMetadata�ensure_directoryc@s*eZdZdZdd�Zdd�Zd
dd�Zd	S)�install_scriptsz;Do normal script install, plus any egg_info wrapper scriptscCstj�|�d|_dS)NF)�origr�initialize_options�no_ep)�self�r�F/usr/lib/python3.8/site-packages/setuptools/command/install_scripts.pyrsz"install_scripts.initialize_optionscCs�ddlmm}|�d�|jjr2tj�|�ng|_	|j
rBdS|�d�}t|j
t|j
|j�|j|j�}|�d�}t|dd�}|�d�}t|dd�}|j}|r�d}|j}|tjkr�|g}|��}|j���|�}	|�||	���D]}
|j|
�q�dS)	Nr�egg_infoZ
build_scripts�
executableZ
bdist_wininstZ_is_runningFz
python.exe)�setuptools.command.easy_install�commandZeasy_installZrun_commandZdistributionZscriptsrr�run�outfilesr	Zget_finalized_commandrZegg_baserr
Zegg_nameZegg_version�getattrZScriptWriterZWindowsScriptWriter�sysrZbestZcommand_spec_classZ
from_paramZget_argsZ	as_header�write_script)r
ZeiZei_cmdZdistZbs_cmdZ
exec_paramZbw_cmdZ
is_wininst�writer�cmd�argsrrrrs8

�


zinstall_scripts.run�tc
Gs�ddlm}m}t�d||j�tj�|j|�}|j	�
|�|�}|js~t|�t
|d|�}	|	�|�|	��||d|�dS)z1Write an executable file to the scripts directoryr)�chmod�
current_umaskzInstalling %s script to %s�wi�N)rrrr�infoZinstall_dir�os�path�joinr�appendZdry_runr�open�write�close)
r
Zscript_name�contents�modeZignoredrr�target�mask�frrrr3s
zinstall_scripts.write_scriptN)r)�__name__�
__module__�__qualname__�__doc__rrrrrrrr	s#r)Z	distutilsrZ!distutils.command.install_scriptsrrrrrZ
pkg_resourcesrrrrrrr�<module>s
site-packages/setuptools/command/__pycache__/test.cpython-38.pyc000064400000020433151446177000020751 0ustar00U

�Qab�%�@s�ddlZddlZddlZddlZddlZddlZddlmZmZddl	m
Z
ddlmZddlm
Z
ddlmZmZddlmZmZmZmZmZmZmZmZmZddlmZd	d
lmZeZ Gdd�de�Z!Gd
d�d�Z"Gdd�de�Z#dS)�N)�DistutilsError�DistutilsOptionError)�log)�
TestLoader)�six)�map�filter)	�resource_listdir�resource_exists�normalize_path�working_set�_namespace_packages�evaluate_marker�add_activation_listener�require�
EntryPoint)�Command�)�_unique_everseenc@seZdZdd�Zddd�ZdS)�ScanningLoadercCst�|�t�|_dS�N)r�__init__�set�_visited��self�r�;/usr/lib/python3.8/site-packages/setuptools/command/test.pyrs
zScanningLoader.__init__NcCs�||jkrdS|j�|�g}|�t�||��t|d�rH|�|���t|d�r�t|jd�D]`}|�	d�r�|dkr�|jd|dd�}n"t
|j|d	�r^|jd|}nq^|�|�|��q^t|�d
kr�|�
|�S|dSdS)aReturn a suite of all tests cases contained in the given module

        If the module is a package, load tests from all the modules in it.
        If the module has an ``additional_tests`` function, call it and add
        the return value to the tests.
        N�additional_tests�__path__�z.pyz__init__.py�.���z/__init__.pyrr)r�add�appendr�loadTestsFromModule�hasattrrr	�__name__�endswithr
ZloadTestsFromName�lenZ
suiteClass)r�module�patternZtests�fileZ	submodulerrrr%s$



z"ScanningLoader.loadTestsFromModule)N)r'�
__module__�__qualname__rr%rrrrrsrc@seZdZdd�Zddd�ZdS)�NonDataPropertycCs
||_dSr��fget)rr1rrrrAszNonDataProperty.__init__NcCs|dkr|S|�|�Srr0)r�objZobjtyperrr�__get__DszNonDataProperty.__get__)N)r'r-r.rr3rrrrr/@sr/c@s�eZdZdZdZdddgZdd�Zdd	�Zed
d��Z	dd
�Z
dd�Zej
gfdd��Zeej
dd���Zedd��Zdd�Zdd�Zedd��Zedd��ZdS)�testz.Command to run unit tests after in-place buildz0run unit tests after in-place build (deprecated))ztest-module=�mz$Run 'test_suite' in specified module)ztest-suite=�sz9Run single test, case or suite (e.g. 'module.test_suite'))ztest-runner=�rzTest runner to usecCsd|_d|_d|_d|_dSr)�
test_suite�test_module�test_loader�test_runnerrrrr�initialize_optionsVsztest.initialize_optionscCs�|jr|jrd}t|��|jdkrD|jdkr8|jj|_n|jd|_|jdkr^t|jdd�|_|jdkrnd|_|jdkr�t|jdd�|_dS)Nz1You may specify a module or a suite, but not bothz.test_suiter:z&setuptools.command.test:ScanningLoaderr;)r8r9r�distributionr:�getattrr;)r�msgrrr�finalize_options\s




ztest.finalize_optionscCst|���Sr)�list�
_test_argsrrrr�	test_argsosztest.test_argsccs4|jstjdkrdV|jr"dV|jr0|jVdS)N)��Zdiscoverz	--verbose)r8�sys�version_info�verboserrrrrBssztest._test_argsc	Cs|���|�W5QRXdS)zI
        Backward compatibility for project_on_sys_path context.
        N)�project_on_sys_path)r�funcrrr�with_project_on_sys_path{s
ztest.with_project_on_sys_pathc	
csPtjot|jdd�}|rv|jddd�|�d�|�d�}t|j�}|jd|d�|�d�|jddd�|�d�n"|�d�|jdd	d�|�d�|�d�}t	j
dd�}t	j��}zbt|j�}t	j
�d|�t��td
d��td|j|jf�|�|g��dVW5QRXW5|t	j
dd�<t	j�
�t	j�|�t��XdS)
N�use_2to3F�build_pyr)ZinplaceZegg_info)�egg_baseZ	build_extrcSs|��Sr)Zactivate)�distrrr�<lambda>��z*test.project_on_sys_path.<locals>.<lambda>z%s==%s)r�PY3r>r=Zreinitialize_commandZrun_commandZget_finalized_commandrZ	build_librF�path�modules�copy�clear�updaterrrN�insertrrZegg_nameZegg_version�paths_on_pythonpath)	rZ
include_distsZ	with_2to3Zbpy_cmdZ
build_pathZei_cmdZold_pathZold_modulesZproject_pathrrrrI�s8









ztest.project_on_sys_pathc
cs�t�}tj�d|�}tj�dd�}zBtj�t|��}td||g�}tj�|�}|r\|tjd<dVW5||kr~tj�dd�n
|tjd<XdS)z�
        Add the indicated paths to the head of the PYTHONPATH environment
        variable so that subprocesses will also see the packages at
        these paths.

        Do this in a context that restores the value on exit.
        Z
PYTHONPATHr N)	�object�os�environ�get�pop�pathsep�joinrr)�pathsZnothingZorig_pythonpathZcurrent_pythonpath�prefixZto_join�new_pathrrrrY�s


ztest.paths_on_pythonpathcCsD|�|j�}|�|jpg�}|�dd�|j��D��}t�|||�S)z�
        Install the requirements indicated by self.distribution and
        return an iterable of the dists that were built.
        css0|](\}}|�d�rt|dd��r|VqdS)�:rN)�
startswithr)�.0�k�vrrr�	<genexpr>�s
�z%test.install_dists.<locals>.<genexpr>)Zfetch_build_eggsZinstall_requiresZ
tests_requireZextras_require�items�	itertools�chain)rOZir_dZtr_dZer_drrr�
install_dists�s
�ztest.install_distsc
Cs�|�dtj�|�|j�}d�|j�}|jr>|�d|�dS|�d|�tt	�
d�|�}|�|��"|���|�
�W5QRXW5QRXdS)Nz�WARNING: Testing via this command is deprecated and will be removed in a future version. Users looking for a generic test entry point independent of test runner are encouraged to use tox.� zskipping "%s" (dry run)zrunning "%s"�location)�announcerZWARNrmr=r`�_argvZdry_runr�operator�
attrgetterrYrI�	run_tests)rZinstalled_dists�cmdrarrr�run�s�
ztest.runcCs�tjr~t|jdd�r~|j�d�d}|tkr~g}|tjkrD|�	|�|d7}tjD]}|�
|�rR|�	|�qRtttjj
|��tjdd|j|�|j�|�|j�dd�}|j��s�d|j}|�|tj�t|��dS)NrLFr!r)Z
testLoaderZ
testRunner�exitzTest failed: %s)rrRr>r=r8�splitr
rFrTr$rerAr�__delitem__�unittest�mainrq�_resolve_as_epr:r;�resultZ
wasSuccessfulrprZERRORr)rr*Zdel_modules�namer4r?rrrrt�s.





�

ztest.run_testscCsdg|jS)Nrz)rCrrrrrq
sz
test._argvcCs$|dkrdSt�d|�}|���S)zu
        Load the indicated attribute value, called, as a as if it were
        specified as an entry point.
        Nzx=)r�parseZresolve)�valZparsedrrrr|sztest._resolve_as_epN)r'r-r.�__doc__�descriptionZuser_optionsr<r@r/rCrBrK�
contextlib�contextmanagerrI�staticmethodrYrmrvrt�propertyrqr|rrrrr4Js2�
-


r4)$r[rrrFr�rkrzZdistutils.errorsrrZ	distutilsrrZsetuptools.externrZsetuptools.extern.six.movesrrZ
pkg_resourcesr	r
rrr
rrrrZ
setuptoolsrrMr�typeZ
__metaclass__rr/r4rrrr�<module>s",)
site-packages/setuptools/command/__pycache__/saveopts.cpython-38.opt-1.pyc000064400000001571151446177000022577 0ustar00U

�Qab��@s$ddlmZmZGdd�de�ZdS)�)�edit_config�option_basec@seZdZdZdZdd�ZdS)�saveoptsz#Save command-line options to a filez7save supplied options to setup.cfg or other config filecCsh|j}i}|jD]B}|dkrq|�|���D]$\}\}}|dkr,||�|i�|<q,qt|j||j�dS)Nrzcommand line)ZdistributionZcommand_optionsZget_option_dict�items�
setdefaultr�filenameZdry_run)�selfZdistZsettings�cmd�opt�src�val�r
�?/usr/lib/python3.8/site-packages/setuptools/command/saveopts.py�run	s
zsaveopts.runN)�__name__�
__module__�__qualname__�__doc__�descriptionrr
r
r
rrsrN)Zsetuptools.command.setoptrrrr
r
r
r�<module>ssite-packages/setuptools/command/__pycache__/dist_info.cpython-38.opt-1.pyc000064400000002521151446177000022705 0ustar00U

�Qab��@s8dZddlZddlmZddlmZGdd�de�ZdS)zD
Create a dist_info directory
As defined in the wheel specification
�N)�Command)�logc@s.eZdZdZdgZdd�Zdd�Zdd�Zd	S)
�	dist_infozcreate a .dist-info directory)z	egg-base=�ezLdirectory containing .egg-info directories (default: top of the source tree)cCs
d|_dS�N)�egg_base��self�r
�@/usr/lib/python3.8/site-packages/setuptools/command/dist_info.py�initialize_optionsszdist_info.initialize_optionscCsdSrr
rr
r
r�finalize_optionsszdist_info.finalize_optionscCsn|�d�}|j|_|��|��|jdtd��d}t�d�t	j
�|���|�d�}|�|j|�dS)N�egg_infoz	.egg-infoz
.dist-infoz
creating '{}'�bdist_wheel)
Zget_finalized_commandrr
�runr�lenr�info�format�os�path�abspathZegg2dist)r	rZ
dist_info_dirrr
r
rrs

z
dist_info.runN)�__name__�
__module__�__qualname__�descriptionZuser_optionsrr
rr
r
r
rrs�r)�__doc__rZdistutils.corerZ	distutilsrrr
r
r
r�<module>ssite-packages/setuptools/command/__pycache__/register.cpython-38.pyc000064400000001363151446177000021617 0ustar00U

�Qab�@s4ddlmZddlmmZGdd�dej�ZdS)�)�logNc@seZdZejjZdd�ZdS)�registerc
Cs0z|�d�tj�|�W5|�dtj�XdS)Nz[WARNING: Registering is deprecated, use twine to upload instead (https://pypi.org/p/twine/)Zegg_info)ZannouncerZWARNZrun_command�origr�run)�self�r�?/usr/lib/python3.8/site-packages/setuptools/command/register.pyrs
�zregister.runN)�__name__�
__module__�__qualname__rr�__doc__rrrrrrsr)Z	distutilsrZdistutils.command.registerZcommandrrrrrr�<module>ssite-packages/setuptools/command/__pycache__/bdist_rpm.cpython-38.opt-1.pyc000064400000003370151446177000022715 0ustar00U

�Qab��@s(ddlmmZGdd�dej�ZdS)�Nc@s eZdZdZdd�Zdd�ZdS)�	bdist_rpmaf
    Override the default bdist_rpm behavior to do the following:

    1. Run egg_info to ensure the name and version are properly calculated.
    2. Always run 'install' using --single-version-externally-managed to
       disable eggs in RPM distributions.
    3. Replace dash with underscore in the version numbers for better RPM
       compatibility.
    cCs|�d�tj�|�dS)NZegg_info)Zrun_command�origr�run)�self�r�@/usr/lib/python3.8/site-packages/setuptools/command/bdist_rpm.pyrs
z
bdist_rpm.runcsl|j��}|�dd�}tj�|�}d|�d|���fdd�|D�}|���d}d|}|�||�|S)N�-�_z%define version cs0g|](}|�dd��dd��dd������qS)zSource0: %{name}-%{version}.tarz)Source0: %{name}-%{unmangled_version}.tarzsetup.py install z5setup.py install --single-version-externally-managed z%setupz&%setup -n %{name}-%{unmangled_version})�replace)�.0�line�Zline23Zline24rr�
<listcomp>s����	�z-bdist_rpm._make_spec_file.<locals>.<listcomp>�z%define unmangled_version )ZdistributionZget_versionr
rr�_make_spec_file�index�insert)r�versionZ
rpmversion�specZ
insert_locZunmangled_versionrr
rrs
�
zbdist_rpm._make_spec_fileN)�__name__�
__module__�__qualname__�__doc__rrrrrrrs
r)Zdistutils.command.bdist_rpmZcommandrrrrrr�<module>ssite-packages/setuptools/command/__pycache__/__init__.cpython-38.pyc000064400000001342151446177000021527 0ustar00U

�QabR�@szdddddddddd	d
ddd
dddddddddgZddlmZddlZddlmZdejkrrdejd<ej�d�[[dS)�alias�	bdist_eggZ	bdist_rpmZ	build_extZbuild_pyZdevelopZeasy_installZegg_infoZinstallZinstall_lib�rotateZsaveoptsZsdistZsetoptZtestZinstall_egg_info�install_scripts�registerZ
bdist_wininstZupload_docsZuploadZ
build_clibZ	dist_info�)�bdistN)rZegg)rzPython .egg file)	�__all__Zdistutils.command.bdistr�sysZsetuptools.commandrZformat_commandsZformat_command�append�rr�?/usr/lib/python3.8/site-packages/setuptools/command/__init__.py�<module>s<�

site-packages/setuptools/command/__pycache__/alias.cpython-38.opt-1.pyc000064400000004530151446177000022022 0ustar00U

�Qabz	�@sPddlmZddlmZddlmZmZmZdd�ZGdd�de�Z	dd	�Z
d
S)�)�DistutilsOptionError)�map)�edit_config�option_base�config_filecCs8dD]}||krt|�Sq|��|gkr4t|�S|S)z4Quote an argument for later parsing by shlex.split())�"�'�\�#)�repr�split)�arg�c�r�</usr/lib/python3.8/site-packages/setuptools/command/alias.py�shquotesrc@sHeZdZdZdZdZdgejZejdgZdd�Z	dd	�Z
d
d�ZdS)
�aliasz3Define a shortcut that invokes one or more commandsz0define a shortcut to invoke one or more commandsT)�remove�rzremove (unset) the aliasrcCst�|�d|_d|_dS)N)r�initialize_options�argsr��selfrrrrs
zalias.initialize_optionscCs*t�|�|jr&t|j�dkr&td��dS)N�zFMust specify exactly one argument (the alias name) when using --remove)r�finalize_optionsr�lenrrrrrrr#s

�zalias.finalize_optionscCs�|j�d�}|js@td�td�|D]}tdt||��q&dSt|j�dkr�|j\}|jrbd}q�||kr~tdt||��dStd|�dSn$|jd}d�tt	|jdd���}t
|jd||ii|j�dS)	N�aliaseszCommand Aliasesz---------------zsetup.py aliasrz No alias definition found for %rr� )
ZdistributionZget_option_dictr�print�format_aliasrr�joinrrr�filenameZdry_run)rrr�commandrrr�run+s&
z	alias.runN)�__name__�
__module__�__qualname__�__doc__�descriptionZcommand_consumes_argumentsrZuser_optionsZboolean_optionsrrr#rrrrrs��rcCsZ||\}}|td�krd}n,|td�kr0d}n|td�krBd}nd|}||d|S)	N�globalz--global-config �userz--user-config Zlocal�z
--filename=%rr)r)�namer�sourcer"rrrrFsrN)Zdistutils.errorsrZsetuptools.extern.six.movesrZsetuptools.command.setoptrrrrrrrrrr�<module>s

4site-packages/setuptools/command/__pycache__/alias.cpython-38.pyc000064400000004530151446177000021063 0ustar00U

�Qabz	�@sPddlmZddlmZddlmZmZmZdd�ZGdd�de�Z	dd	�Z
d
S)�)�DistutilsOptionError)�map)�edit_config�option_base�config_filecCs8dD]}||krt|�Sq|��|gkr4t|�S|S)z4Quote an argument for later parsing by shlex.split())�"�'�\�#)�repr�split)�arg�c�r�</usr/lib/python3.8/site-packages/setuptools/command/alias.py�shquotesrc@sHeZdZdZdZdZdgejZejdgZdd�Z	dd	�Z
d
d�ZdS)
�aliasz3Define a shortcut that invokes one or more commandsz0define a shortcut to invoke one or more commandsT)�remove�rzremove (unset) the aliasrcCst�|�d|_d|_dS)N)r�initialize_options�argsr��selfrrrrs
zalias.initialize_optionscCs*t�|�|jr&t|j�dkr&td��dS)N�zFMust specify exactly one argument (the alias name) when using --remove)r�finalize_optionsr�lenrrrrrrr#s

�zalias.finalize_optionscCs�|j�d�}|js@td�td�|D]}tdt||��q&dSt|j�dkr�|j\}|jrbd}q�||kr~tdt||��dStd|�dSn$|jd}d�tt	|jdd���}t
|jd||ii|j�dS)	N�aliaseszCommand Aliasesz---------------zsetup.py aliasrz No alias definition found for %rr� )
ZdistributionZget_option_dictr�print�format_aliasrr�joinrrr�filenameZdry_run)rrr�commandrrr�run+s&
z	alias.runN)�__name__�
__module__�__qualname__�__doc__�descriptionZcommand_consumes_argumentsrZuser_optionsZboolean_optionsrrr#rrrrrs��rcCsZ||\}}|td�krd}n,|td�kr0d}n|td�krBd}nd|}||d|S)	N�globalz--global-config �userz--user-config Zlocal�z
--filename=%rr)r)�namer�sourcer"rrrrFsrN)Zdistutils.errorsrZsetuptools.extern.six.movesrZsetuptools.command.setoptrrrrrrrrrr�<module>s

4site-packages/setuptools/command/bdist_egg.py000064400000043411151446177000015434 0ustar00"""setuptools.command.bdist_egg

Build .egg distributions"""

from distutils.errors import DistutilsSetupError
from distutils.dir_util import remove_tree, mkpath
from distutils import log
from types import CodeType
import sys
import os
import re
import textwrap
import marshal

from setuptools.extern import six

from pkg_resources import get_build_platform, Distribution, ensure_directory
from pkg_resources import EntryPoint
from setuptools.extension import Library
from setuptools import Command

try:
    # Python 2.7 or >=3.2
    from sysconfig import get_path, get_python_version

    def _get_purelib():
        return get_path("purelib")
except ImportError:
    from distutils.sysconfig import get_python_lib, get_python_version

    def _get_purelib():
        return get_python_lib(False)


def strip_module(filename):
    if '.' in filename:
        filename = os.path.splitext(filename)[0]
    if filename.endswith('module'):
        filename = filename[:-6]
    return filename


def sorted_walk(dir):
    """Do os.walk in a reproducible way,
    independent of indeterministic filesystem readdir order
    """
    for base, dirs, files in os.walk(dir):
        dirs.sort()
        files.sort()
        yield base, dirs, files


def write_stub(resource, pyfile):
    _stub_template = textwrap.dedent("""
        def __bootstrap__():
            global __bootstrap__, __loader__, __file__
            import sys, pkg_resources, imp
            __file__ = pkg_resources.resource_filename(__name__, %r)
            __loader__ = None; del __bootstrap__, __loader__
            imp.load_dynamic(__name__,__file__)
        __bootstrap__()
        """).lstrip()
    with open(pyfile, 'w') as f:
        f.write(_stub_template % resource)


class bdist_egg(Command):
    description = "create an \"egg\" distribution"

    user_options = [
        ('bdist-dir=', 'b',
         "temporary directory for creating the distribution"),
        ('plat-name=', 'p', "platform name to embed in generated filenames "
                            "(default: %s)" % get_build_platform()),
        ('exclude-source-files', None,
         "remove all .py files from the generated egg"),
        ('keep-temp', 'k',
         "keep the pseudo-installation tree around after " +
         "creating the distribution archive"),
        ('dist-dir=', 'd',
         "directory to put final built distributions in"),
        ('skip-build', None,
         "skip rebuilding everything (for testing/debugging)"),
    ]

    boolean_options = [
        'keep-temp', 'skip-build', 'exclude-source-files'
    ]

    def initialize_options(self):
        self.bdist_dir = None
        self.plat_name = None
        self.keep_temp = 0
        self.dist_dir = None
        self.skip_build = 0
        self.egg_output = None
        self.exclude_source_files = None

    def finalize_options(self):
        ei_cmd = self.ei_cmd = self.get_finalized_command("egg_info")
        self.egg_info = ei_cmd.egg_info

        if self.bdist_dir is None:
            bdist_base = self.get_finalized_command('bdist').bdist_base
            self.bdist_dir = os.path.join(bdist_base, 'egg')

        if self.plat_name is None:
            self.plat_name = get_build_platform()

        self.set_undefined_options('bdist', ('dist_dir', 'dist_dir'))

        if self.egg_output is None:

            # Compute filename of the output egg
            basename = Distribution(
                None, None, ei_cmd.egg_name, ei_cmd.egg_version,
                get_python_version(),
                self.distribution.has_ext_modules() and self.plat_name
            ).egg_name()

            self.egg_output = os.path.join(self.dist_dir, basename + '.egg')

    def do_install_data(self):
        # Hack for packages that install data to install's --install-lib
        self.get_finalized_command('install').install_lib = self.bdist_dir

        site_packages = os.path.normcase(os.path.realpath(_get_purelib()))
        old, self.distribution.data_files = self.distribution.data_files, []

        for item in old:
            if isinstance(item, tuple) and len(item) == 2:
                if os.path.isabs(item[0]):
                    realpath = os.path.realpath(item[0])
                    normalized = os.path.normcase(realpath)
                    if normalized == site_packages or normalized.startswith(
                        site_packages + os.sep
                    ):
                        item = realpath[len(site_packages) + 1:], item[1]
                        # XXX else: raise ???
            self.distribution.data_files.append(item)

        try:
            log.info("installing package data to %s", self.bdist_dir)
            self.call_command('install_data', force=0, root=None)
        finally:
            self.distribution.data_files = old

    def get_outputs(self):
        return [self.egg_output]

    def call_command(self, cmdname, **kw):
        """Invoke reinitialized command `cmdname` with keyword args"""
        for dirname in INSTALL_DIRECTORY_ATTRS:
            kw.setdefault(dirname, self.bdist_dir)
        kw.setdefault('skip_build', self.skip_build)
        kw.setdefault('dry_run', self.dry_run)
        cmd = self.reinitialize_command(cmdname, **kw)
        self.run_command(cmdname)
        return cmd

    def run(self):
        # Generate metadata first
        self.run_command("egg_info")
        # We run install_lib before install_data, because some data hacks
        # pull their data path from the install_lib command.
        log.info("installing library code to %s", self.bdist_dir)
        instcmd = self.get_finalized_command('install')
        old_root = instcmd.root
        instcmd.root = None
        if self.distribution.has_c_libraries() and not self.skip_build:
            self.run_command('build_clib')
        cmd = self.call_command('install_lib', warn_dir=0)
        instcmd.root = old_root

        all_outputs, ext_outputs = self.get_ext_outputs()
        self.stubs = []
        to_compile = []
        for (p, ext_name) in enumerate(ext_outputs):
            filename, ext = os.path.splitext(ext_name)
            pyfile = os.path.join(self.bdist_dir, strip_module(filename) +
                                  '.py')
            self.stubs.append(pyfile)
            log.info("creating stub loader for %s", ext_name)
            if not self.dry_run:
                write_stub(os.path.basename(ext_name), pyfile)
            to_compile.append(pyfile)
            ext_outputs[p] = ext_name.replace(os.sep, '/')

        if to_compile:
            cmd.byte_compile(to_compile)
        if self.distribution.data_files:
            self.do_install_data()

        # Make the EGG-INFO directory
        archive_root = self.bdist_dir
        egg_info = os.path.join(archive_root, 'EGG-INFO')
        self.mkpath(egg_info)
        if self.distribution.scripts:
            script_dir = os.path.join(egg_info, 'scripts')
            log.info("installing scripts to %s", script_dir)
            self.call_command('install_scripts', install_dir=script_dir,
                              no_ep=1)

        self.copy_metadata_to(egg_info)
        native_libs = os.path.join(egg_info, "native_libs.txt")
        if all_outputs:
            log.info("writing %s", native_libs)
            if not self.dry_run:
                ensure_directory(native_libs)
                libs_file = open(native_libs, 'wt')
                libs_file.write('\n'.join(all_outputs))
                libs_file.write('\n')
                libs_file.close()
        elif os.path.isfile(native_libs):
            log.info("removing %s", native_libs)
            if not self.dry_run:
                os.unlink(native_libs)

        write_safety_flag(
            os.path.join(archive_root, 'EGG-INFO'), self.zip_safe()
        )

        if os.path.exists(os.path.join(self.egg_info, 'depends.txt')):
            log.warn(
                "WARNING: 'depends.txt' will not be used by setuptools 0.6!\n"
                "Use the install_requires/extras_require setup() args instead."
            )

        if self.exclude_source_files:
            self.zap_pyfiles()

        # Make the archive
        make_zipfile(self.egg_output, archive_root, verbose=self.verbose,
                     dry_run=self.dry_run, mode=self.gen_header())
        if not self.keep_temp:
            remove_tree(self.bdist_dir, dry_run=self.dry_run)

        # Add to 'Distribution.dist_files' so that the "upload" command works
        getattr(self.distribution, 'dist_files', []).append(
            ('bdist_egg', get_python_version(), self.egg_output))

    def zap_pyfiles(self):
        log.info("Removing .py files from temporary directory")
        for base, dirs, files in walk_egg(self.bdist_dir):
            for name in files:
                path = os.path.join(base, name)

                if name.endswith('.py'):
                    log.debug("Deleting %s", path)
                    os.unlink(path)

                if base.endswith('__pycache__'):
                    path_old = path

                    pattern = r'(?P<name>.+)\.(?P<magic>[^.]+)\.pyc'
                    m = re.match(pattern, name)
                    path_new = os.path.join(
                        base, os.pardir, m.group('name') + '.pyc')
                    log.info(
                        "Renaming file from [%s] to [%s]"
                        % (path_old, path_new))
                    try:
                        os.remove(path_new)
                    except OSError:
                        pass
                    os.rename(path_old, path_new)

    def zip_safe(self):
        safe = getattr(self.distribution, 'zip_safe', None)
        if safe is not None:
            return safe
        log.warn("zip_safe flag not set; analyzing archive contents...")
        return analyze_egg(self.bdist_dir, self.stubs)

    def gen_header(self):
        epm = EntryPoint.parse_map(self.distribution.entry_points or '')
        ep = epm.get('setuptools.installation', {}).get('eggsecutable')
        if ep is None:
            return 'w'  # not an eggsecutable, do it the usual way.

        if not ep.attrs or ep.extras:
            raise DistutilsSetupError(
                "eggsecutable entry point (%r) cannot have 'extras' "
                "or refer to a module" % (ep,)
            )

        pyver = '{}.{}'.format(*sys.version_info)
        pkg = ep.module_name
        full = '.'.join(ep.attrs)
        base = ep.attrs[0]
        basename = os.path.basename(self.egg_output)

        header = (
            "#!/bin/sh\n"
            'if [ `basename $0` = "%(basename)s" ]\n'
            'then exec python%(pyver)s -c "'
            "import sys, os; sys.path.insert(0, os.path.abspath('$0')); "
            "from %(pkg)s import %(base)s; sys.exit(%(full)s())"
            '" "$@"\n'
            'else\n'
            '  echo $0 is not the correct name for this egg file.\n'
            '  echo Please rename it back to %(basename)s and try again.\n'
            '  exec false\n'
            'fi\n'
        ) % locals()

        if not self.dry_run:
            mkpath(os.path.dirname(self.egg_output), dry_run=self.dry_run)
            f = open(self.egg_output, 'w')
            f.write(header)
            f.close()
        return 'a'

    def copy_metadata_to(self, target_dir):
        "Copy metadata (egg info) to the target_dir"
        # normalize the path (so that a forward-slash in egg_info will
        # match using startswith below)
        norm_egg_info = os.path.normpath(self.egg_info)
        prefix = os.path.join(norm_egg_info, '')
        for path in self.ei_cmd.filelist.files:
            if path.startswith(prefix):
                target = os.path.join(target_dir, path[len(prefix):])
                ensure_directory(target)
                self.copy_file(path, target)

    def get_ext_outputs(self):
        """Get a list of relative paths to C extensions in the output distro"""

        all_outputs = []
        ext_outputs = []

        paths = {self.bdist_dir: ''}
        for base, dirs, files in sorted_walk(self.bdist_dir):
            for filename in files:
                if os.path.splitext(filename)[1].lower() in NATIVE_EXTENSIONS:
                    all_outputs.append(paths[base] + filename)
            for filename in dirs:
                paths[os.path.join(base, filename)] = (paths[base] +
                                                       filename + '/')

        if self.distribution.has_ext_modules():
            build_cmd = self.get_finalized_command('build_ext')
            for ext in build_cmd.extensions:
                if isinstance(ext, Library):
                    continue
                fullname = build_cmd.get_ext_fullname(ext.name)
                filename = build_cmd.get_ext_filename(fullname)
                if not os.path.basename(filename).startswith('dl-'):
                    if os.path.exists(os.path.join(self.bdist_dir, filename)):
                        ext_outputs.append(filename)

        return all_outputs, ext_outputs


NATIVE_EXTENSIONS = dict.fromkeys('.dll .so .dylib .pyd'.split())


def walk_egg(egg_dir):
    """Walk an unpacked egg's contents, skipping the metadata directory"""
    walker = sorted_walk(egg_dir)
    base, dirs, files = next(walker)
    if 'EGG-INFO' in dirs:
        dirs.remove('EGG-INFO')
    yield base, dirs, files
    for bdf in walker:
        yield bdf


def analyze_egg(egg_dir, stubs):
    # check for existing flag in EGG-INFO
    for flag, fn in safety_flags.items():
        if os.path.exists(os.path.join(egg_dir, 'EGG-INFO', fn)):
            return flag
    if not can_scan():
        return False
    safe = True
    for base, dirs, files in walk_egg(egg_dir):
        for name in files:
            if name.endswith('.py') or name.endswith('.pyw'):
                continue
            elif name.endswith('.pyc') or name.endswith('.pyo'):
                # always scan, even if we already know we're not safe
                safe = scan_module(egg_dir, base, name, stubs) and safe
    return safe


def write_safety_flag(egg_dir, safe):
    # Write or remove zip safety flag file(s)
    for flag, fn in safety_flags.items():
        fn = os.path.join(egg_dir, fn)
        if os.path.exists(fn):
            if safe is None or bool(safe) != flag:
                os.unlink(fn)
        elif safe is not None and bool(safe) == flag:
            f = open(fn, 'wt')
            f.write('\n')
            f.close()


safety_flags = {
    True: 'zip-safe',
    False: 'not-zip-safe',
}


def scan_module(egg_dir, base, name, stubs):
    """Check whether module possibly uses unsafe-for-zipfile stuff"""

    filename = os.path.join(base, name)
    if filename[:-1] in stubs:
        return True  # Extension module
    pkg = base[len(egg_dir) + 1:].replace(os.sep, '.')
    module = pkg + (pkg and '.' or '') + os.path.splitext(name)[0]
    if six.PY2:
        skip = 8  # skip magic & date
    elif sys.version_info < (3, 7):
        skip = 12  # skip magic & date & file size
    else:
        skip = 16  # skip magic & reserved? & date & file size
    f = open(filename, 'rb')
    f.read(skip)
    code = marshal.load(f)
    f.close()
    safe = True
    symbols = dict.fromkeys(iter_symbols(code))
    for bad in ['__file__', '__path__']:
        if bad in symbols:
            log.warn("%s: module references %s", module, bad)
            safe = False
    if 'inspect' in symbols:
        for bad in [
            'getsource', 'getabsfile', 'getsourcefile', 'getfile'
            'getsourcelines', 'findsource', 'getcomments', 'getframeinfo',
            'getinnerframes', 'getouterframes', 'stack', 'trace'
        ]:
            if bad in symbols:
                log.warn("%s: module MAY be using inspect.%s", module, bad)
                safe = False
    return safe


def iter_symbols(code):
    """Yield names and strings used by `code` and its nested code objects"""
    for name in code.co_names:
        yield name
    for const in code.co_consts:
        if isinstance(const, six.string_types):
            yield const
        elif isinstance(const, CodeType):
            for name in iter_symbols(const):
                yield name


def can_scan():
    if not sys.platform.startswith('java') and sys.platform != 'cli':
        # CPython, PyPy, etc.
        return True
    log.warn("Unable to analyze compiled code on this platform.")
    log.warn("Please ask the author to include a 'zip_safe'"
             " setting (either True or False) in the package's setup.py")


# Attribute names of options for commands that might need to be convinced to
# install to the egg build directory

INSTALL_DIRECTORY_ATTRS = [
    'install_lib', 'install_dir', 'install_data', 'install_base'
]


def make_zipfile(zip_filename, base_dir, verbose=0, dry_run=0, compress=True,
                 mode='w'):
    """Create a zip file from all the files under 'base_dir'.  The output
    zip file will be named 'base_dir' + ".zip".  Uses either the "zipfile"
    Python module (if available) or the InfoZIP "zip" utility (if installed
    and found on the default search path).  If neither tool is available,
    raises DistutilsExecError.  Returns the name of the output zip file.
    """
    import zipfile

    mkpath(os.path.dirname(zip_filename), dry_run=dry_run)
    log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir)

    def visit(z, dirname, names):
        for name in names:
            path = os.path.normpath(os.path.join(dirname, name))
            if os.path.isfile(path):
                p = path[len(base_dir) + 1:]
                if not dry_run:
                    z.write(path, p)
                log.debug("adding '%s'", p)

    compression = zipfile.ZIP_DEFLATED if compress else zipfile.ZIP_STORED
    if not dry_run:
        z = zipfile.ZipFile(zip_filename, mode, compression=compression)
        for dirname, dirs, files in sorted_walk(base_dir):
            visit(z, dirname, files)
        z.close()
    else:
        for dirname, dirs, files in sorted_walk(base_dir):
            visit(None, dirname, files)
    return zip_filename
site-packages/setuptools/command/__init__.py000064400000001122151446177000015235 0ustar00__all__ = [
    'alias', 'bdist_egg', 'bdist_rpm', 'build_ext', 'build_py', 'develop',
    'easy_install', 'egg_info', 'install', 'install_lib', 'rotate', 'saveopts',
    'sdist', 'setopt', 'test', 'install_egg_info', 'install_scripts',
    'register', 'bdist_wininst', 'upload_docs', 'upload', 'build_clib',
    'dist_info',
]

from distutils.command.bdist import bdist
import sys

from setuptools.command import install_scripts

if 'egg' not in bdist.format_commands:
    bdist.format_command['egg'] = ('bdist_egg', "Python .egg file")
    bdist.format_commands.append('egg')

del bdist, sys
site-packages/setuptools/command/rotate.py000064400000004164151446177000015005 0ustar00from distutils.util import convert_path
from distutils import log
from distutils.errors import DistutilsOptionError
import os
import shutil

from setuptools.extern import six

from setuptools import Command


class rotate(Command):
    """Delete older distributions"""

    description = "delete older distributions, keeping N newest files"
    user_options = [
        ('match=', 'm', "patterns to match (required)"),
        ('dist-dir=', 'd', "directory where the distributions are"),
        ('keep=', 'k', "number of matching distributions to keep"),
    ]

    boolean_options = []

    def initialize_options(self):
        self.match = None
        self.dist_dir = None
        self.keep = None

    def finalize_options(self):
        if self.match is None:
            raise DistutilsOptionError(
                "Must specify one or more (comma-separated) match patterns "
                "(e.g. '.zip' or '.egg')"
            )
        if self.keep is None:
            raise DistutilsOptionError("Must specify number of files to keep")
        try:
            self.keep = int(self.keep)
        except ValueError:
            raise DistutilsOptionError("--keep must be an integer")
        if isinstance(self.match, six.string_types):
            self.match = [
                convert_path(p.strip()) for p in self.match.split(',')
            ]
        self.set_undefined_options('bdist', ('dist_dir', 'dist_dir'))

    def run(self):
        self.run_command("egg_info")
        from glob import glob

        for pattern in self.match:
            pattern = self.distribution.get_name() + '*' + pattern
            files = glob(os.path.join(self.dist_dir, pattern))
            files = [(os.path.getmtime(f), f) for f in files]
            files.sort()
            files.reverse()

            log.info("%d file(s) matching %s", len(files), pattern)
            files = files[self.keep:]
            for (t, f) in files:
                log.info("Deleting %s", f)
                if not self.dry_run:
                    if os.path.isdir(f):
                        shutil.rmtree(f)
                    else:
                        os.unlink(f)
site-packages/setuptools/command/bdist_rpm.py000064400000002744151446177000015474 0ustar00import distutils.command.bdist_rpm as orig


class bdist_rpm(orig.bdist_rpm):
    """
    Override the default bdist_rpm behavior to do the following:

    1. Run egg_info to ensure the name and version are properly calculated.
    2. Always run 'install' using --single-version-externally-managed to
       disable eggs in RPM distributions.
    3. Replace dash with underscore in the version numbers for better RPM
       compatibility.
    """

    def run(self):
        # ensure distro name is up-to-date
        self.run_command('egg_info')

        orig.bdist_rpm.run(self)

    def _make_spec_file(self):
        version = self.distribution.get_version()
        rpmversion = version.replace('-', '_')
        spec = orig.bdist_rpm._make_spec_file(self)
        line23 = '%define version ' + version
        line24 = '%define version ' + rpmversion
        spec = [
            line.replace(
                "Source0: %{name}-%{version}.tar",
                "Source0: %{name}-%{unmangled_version}.tar"
            ).replace(
                "setup.py install ",
                "setup.py install --single-version-externally-managed "
            ).replace(
                "%setup",
                "%setup -n %{name}-%{unmangled_version}"
            ).replace(line23, line24)
            for line in spec
        ]
        insert_loc = spec.index(line24) + 1
        unmangled_version = "%define unmangled_version " + version
        spec.insert(insert_loc, unmangled_version)
        return spec
site-packages/setuptools/command/register.py000064400000001026151446177000015325 0ustar00from distutils import log
import distutils.command.register as orig


class register(orig.register):
    __doc__ = orig.register.__doc__

    def run(self):
        try:
            # Make sure that we are using valid current name/version info
            self.run_command('egg_info')
            orig.register.run(self)
        finally:
            self.announce(
                "WARNING: Registering is deprecated, use twine to "
                "upload instead (https://pypi.org/p/twine/)",
                log.WARN
            )
site-packages/setuptools/command/setopt.py000064400000011735151446177000015027 0ustar00from distutils.util import convert_path
from distutils import log
from distutils.errors import DistutilsOptionError
import distutils
import os

from setuptools.extern.six.moves import configparser

from setuptools import Command

__all__ = ['config_file', 'edit_config', 'option_base', 'setopt']


def config_file(kind="local"):
    """Get the filename of the distutils, local, global, or per-user config

    `kind` must be one of "local", "global", or "user"
    """
    if kind == 'local':
        return 'setup.cfg'
    if kind == 'global':
        return os.path.join(
            os.path.dirname(distutils.__file__), 'distutils.cfg'
        )
    if kind == 'user':
        dot = os.name == 'posix' and '.' or ''
        return os.path.expanduser(convert_path("~/%spydistutils.cfg" % dot))
    raise ValueError(
        "config_file() type must be 'local', 'global', or 'user'", kind
    )


def edit_config(filename, settings, dry_run=False):
    """Edit a configuration file to include `settings`

    `settings` is a dictionary of dictionaries or ``None`` values, keyed by
    command/section name.  A ``None`` value means to delete the entire section,
    while a dictionary lists settings to be changed or deleted in that section.
    A setting of ``None`` means to delete that setting.
    """
    log.debug("Reading configuration from %s", filename)
    opts = configparser.RawConfigParser()
    opts.read([filename])
    for section, options in settings.items():
        if options is None:
            log.info("Deleting section [%s] from %s", section, filename)
            opts.remove_section(section)
        else:
            if not opts.has_section(section):
                log.debug("Adding new section [%s] to %s", section, filename)
                opts.add_section(section)
            for option, value in options.items():
                if value is None:
                    log.debug(
                        "Deleting %s.%s from %s",
                        section, option, filename
                    )
                    opts.remove_option(section, option)
                    if not opts.options(section):
                        log.info("Deleting empty [%s] section from %s",
                                 section, filename)
                        opts.remove_section(section)
                else:
                    log.debug(
                        "Setting %s.%s to %r in %s",
                        section, option, value, filename
                    )
                    opts.set(section, option, value)

    log.info("Writing %s", filename)
    if not dry_run:
        with open(filename, 'w') as f:
            opts.write(f)


class option_base(Command):
    """Abstract base class for commands that mess with config files"""

    user_options = [
        ('global-config', 'g',
         "save options to the site-wide distutils.cfg file"),
        ('user-config', 'u',
         "save options to the current user's pydistutils.cfg file"),
        ('filename=', 'f',
         "configuration file to use (default=setup.cfg)"),
    ]

    boolean_options = [
        'global-config', 'user-config',
    ]

    def initialize_options(self):
        self.global_config = None
        self.user_config = None
        self.filename = None

    def finalize_options(self):
        filenames = []
        if self.global_config:
            filenames.append(config_file('global'))
        if self.user_config:
            filenames.append(config_file('user'))
        if self.filename is not None:
            filenames.append(self.filename)
        if not filenames:
            filenames.append(config_file('local'))
        if len(filenames) > 1:
            raise DistutilsOptionError(
                "Must specify only one configuration file option",
                filenames
            )
        self.filename, = filenames


class setopt(option_base):
    """Save command-line options to a file"""

    description = "set an option in setup.cfg or another config file"

    user_options = [
        ('command=', 'c', 'command to set an option for'),
        ('option=', 'o', 'option to set'),
        ('set-value=', 's', 'value of the option'),
        ('remove', 'r', 'remove (unset) the value'),
    ] + option_base.user_options

    boolean_options = option_base.boolean_options + ['remove']

    def initialize_options(self):
        option_base.initialize_options(self)
        self.command = None
        self.option = None
        self.set_value = None
        self.remove = None

    def finalize_options(self):
        option_base.finalize_options(self)
        if self.command is None or self.option is None:
            raise DistutilsOptionError("Must specify --command *and* --option")
        if self.set_value is None and not self.remove:
            raise DistutilsOptionError("Must specify --set-value or --remove")

    def run(self):
        edit_config(
            self.filename, {
                self.command: {self.option.replace('-', '_'): self.set_value}
            },
            self.dry_run
        )
site-packages/setuptools/command/easy_install.py000064400000252635151446177000016206 0ustar00"""
Easy Install
------------

A tool for doing automatic download/extract/build of distutils-based Python
packages.  For detailed documentation, see the accompanying EasyInstall.txt
file, or visit the `EasyInstall home page`__.

__ https://setuptools.readthedocs.io/en/latest/easy_install.html

"""

from glob import glob
from distutils.util import get_platform
from distutils.util import convert_path, subst_vars
from distutils.errors import (
    DistutilsArgError, DistutilsOptionError,
    DistutilsError, DistutilsPlatformError,
)
from distutils.command.install import INSTALL_SCHEMES, SCHEME_KEYS
from distutils import log, dir_util
from distutils.command.build_scripts import first_line_re
from distutils.spawn import find_executable
import sys
import os
import zipimport
import shutil
import tempfile
import zipfile
import re
import stat
import random
import textwrap
import warnings
import site
import struct
import contextlib
import subprocess
import shlex
import io


from sysconfig import get_config_vars, get_path

from setuptools import SetuptoolsDeprecationWarning

from setuptools.extern import six
from setuptools.extern.six.moves import configparser, map

from setuptools import Command
from setuptools.sandbox import run_setup
from setuptools.py27compat import rmtree_safe
from setuptools.command import setopt
from setuptools.archive_util import unpack_archive
from setuptools.package_index import (
    PackageIndex, parse_requirement_arg, URL_SCHEME,
)
from setuptools.command import bdist_egg, egg_info
from setuptools.wheel import Wheel
from pkg_resources import (
    yield_lines, normalize_path, resource_string, ensure_directory,
    get_distribution, find_distributions, Environment, Requirement,
    Distribution, PathMetadata, EggMetadata, WorkingSet, DistributionNotFound,
    VersionConflict, DEVELOP_DIST,
)
import pkg_resources.py31compat

__metaclass__ = type

# Turn on PEP440Warnings
warnings.filterwarnings("default", category=pkg_resources.PEP440Warning)

__all__ = [
    'samefile', 'easy_install', 'PthDistributions', 'extract_wininst_cfg',
    'main', 'get_exe_prefixes',
]


def is_64bit():
    return struct.calcsize("P") == 8


def samefile(p1, p2):
    """
    Determine if two paths reference the same file.

    Augments os.path.samefile to work on Windows and
    suppresses errors if the path doesn't exist.
    """
    both_exist = os.path.exists(p1) and os.path.exists(p2)
    use_samefile = hasattr(os.path, 'samefile') and both_exist
    if use_samefile:
        return os.path.samefile(p1, p2)
    norm_p1 = os.path.normpath(os.path.normcase(p1))
    norm_p2 = os.path.normpath(os.path.normcase(p2))
    return norm_p1 == norm_p2


if six.PY2:

    def _to_bytes(s):
        return s

    def isascii(s):
        try:
            six.text_type(s, 'ascii')
            return True
        except UnicodeError:
            return False
else:

    def _to_bytes(s):
        return s.encode('utf8')

    def isascii(s):
        try:
            s.encode('ascii')
            return True
        except UnicodeError:
            return False


_one_liner = lambda text: textwrap.dedent(text).strip().replace('\n', '; ')


class easy_install(Command):
    """Manage a download/build/install process"""
    description = "Find/get/install Python packages"
    command_consumes_arguments = True

    user_options = [
        ('prefix=', None, "installation prefix"),
        ("zip-ok", "z", "install package as a zipfile"),
        ("multi-version", "m", "make apps have to require() a version"),
        ("upgrade", "U", "force upgrade (searches PyPI for latest versions)"),
        ("install-dir=", "d", "install package to DIR"),
        ("script-dir=", "s", "install scripts to DIR"),
        ("exclude-scripts", "x", "Don't install scripts"),
        ("always-copy", "a", "Copy all needed packages to install dir"),
        ("index-url=", "i", "base URL of Python Package Index"),
        ("find-links=", "f", "additional URL(s) to search for packages"),
        ("build-directory=", "b",
         "download/extract/build in DIR; keep the results"),
        ('optimize=', 'O',
         "also compile with optimization: -O1 for \"python -O\", "
         "-O2 for \"python -OO\", and -O0 to disable [default: -O0]"),
        ('record=', None,
         "filename in which to record list of installed files"),
        ('always-unzip', 'Z', "don't install as a zipfile, no matter what"),
        ('site-dirs=', 'S', "list of directories where .pth files work"),
        ('editable', 'e', "Install specified packages in editable form"),
        ('no-deps', 'N', "don't install dependencies"),
        ('allow-hosts=', 'H', "pattern(s) that hostnames must match"),
        ('local-snapshots-ok', 'l',
         "allow building eggs from local checkouts"),
        ('version', None, "print version information and exit"),
        ('no-find-links', None,
         "Don't load find-links defined in packages being installed")
    ]
    boolean_options = [
        'zip-ok', 'multi-version', 'exclude-scripts', 'upgrade', 'always-copy',
        'editable',
        'no-deps', 'local-snapshots-ok', 'version'
    ]

    if site.ENABLE_USER_SITE:
        help_msg = "install in user site-package '%s'" % site.USER_SITE
        user_options.append(('user', None, help_msg))
        boolean_options.append('user')

    negative_opt = {'always-unzip': 'zip-ok'}
    create_index = PackageIndex

    def initialize_options(self):
        # the --user option seems to be an opt-in one,
        # so the default should be False.
        self.user = 0
        self.zip_ok = self.local_snapshots_ok = None
        self.install_dir = self.script_dir = self.exclude_scripts = None
        self.index_url = None
        self.find_links = None
        self.build_directory = None
        self.args = None
        self.optimize = self.record = None
        self.upgrade = self.always_copy = self.multi_version = None
        self.editable = self.no_deps = self.allow_hosts = None
        self.root = self.prefix = self.no_report = None
        self.version = None
        self.install_purelib = None  # for pure module distributions
        self.install_platlib = None  # non-pure (dists w/ extensions)
        self.install_headers = None  # for C/C++ headers
        self.install_lib = None  # set to either purelib or platlib
        self.install_scripts = None
        self.install_data = None
        self.install_base = None
        self.install_platbase = None
        if site.ENABLE_USER_SITE:
            self.install_userbase = site.USER_BASE
            self.install_usersite = site.USER_SITE
        else:
            self.install_userbase = None
            self.install_usersite = None
        self.no_find_links = None

        # Options not specifiable via command line
        self.package_index = None
        self.pth_file = self.always_copy_from = None
        self.site_dirs = None
        self.installed_projects = {}
        self.sitepy_installed = False
        # Always read easy_install options, even if we are subclassed, or have
        # an independent instance created.  This ensures that defaults will
        # always come from the standard configuration file(s)' "easy_install"
        # section, even if this is a "develop" or "install" command, or some
        # other embedding.
        self._dry_run = None
        self.verbose = self.distribution.verbose
        self.distribution._set_command_options(
            self, self.distribution.get_option_dict('easy_install')
        )

    def delete_blockers(self, blockers):
        extant_blockers = (
            filename for filename in blockers
            if os.path.exists(filename) or os.path.islink(filename)
        )
        list(map(self._delete_path, extant_blockers))

    def _delete_path(self, path):
        log.info("Deleting %s", path)
        if self.dry_run:
            return

        is_tree = os.path.isdir(path) and not os.path.islink(path)
        remover = rmtree if is_tree else os.unlink
        remover(path)

    @staticmethod
    def _render_version():
        """
        Render the Setuptools version and installation details, then exit.
        """
        ver = '{}.{}'.format(*sys.version_info)
        dist = get_distribution('setuptools')
        tmpl = 'setuptools {dist.version} from {dist.location} (Python {ver})'
        print(tmpl.format(**locals()))
        raise SystemExit()

    def finalize_options(self):
        self.version and self._render_version()

        py_version = sys.version.split()[0]
        prefix, exec_prefix = get_config_vars('prefix', 'exec_prefix')

        self.config_vars = {
            'dist_name': self.distribution.get_name(),
            'dist_version': self.distribution.get_version(),
            'dist_fullname': self.distribution.get_fullname(),
            'py_version': py_version,
            'py_version_short': py_version[0:3],
            'py_version_nodot': py_version[0] + py_version[2],
            'sys_prefix': prefix,
            'prefix': prefix,
            'sys_exec_prefix': exec_prefix,
            'exec_prefix': exec_prefix,
            # Only python 3.2+ has abiflags
            'abiflags': getattr(sys, 'abiflags', ''),
        }

        if site.ENABLE_USER_SITE:
            self.config_vars['userbase'] = self.install_userbase
            self.config_vars['usersite'] = self.install_usersite

        self._fix_install_dir_for_user_site()

        self.expand_basedirs()
        self.expand_dirs()

        self._expand(
            'install_dir', 'script_dir', 'build_directory',
            'site_dirs',
        )
        # If a non-default installation directory was specified, default the
        # script directory to match it.
        if self.script_dir is None:
            self.script_dir = self.install_dir

        if self.no_find_links is None:
            self.no_find_links = False

        # Let install_dir get set by install_lib command, which in turn
        # gets its info from the install command, and takes into account
        # --prefix and --home and all that other crud.
        self.set_undefined_options(
            'install_lib', ('install_dir', 'install_dir')
        )
        # Likewise, set default script_dir from 'install_scripts.install_dir'
        self.set_undefined_options(
            'install_scripts', ('install_dir', 'script_dir')
        )

        if self.user and self.install_purelib:
            self.install_dir = self.install_purelib
            self.script_dir = self.install_scripts
        # default --record from the install command
        self.set_undefined_options('install', ('record', 'record'))
        # Should this be moved to the if statement below? It's not used
        # elsewhere
        normpath = map(normalize_path, sys.path)
        self.all_site_dirs = get_site_dirs()
        if self.site_dirs is not None:
            site_dirs = [
                os.path.expanduser(s.strip()) for s in
                self.site_dirs.split(',')
            ]
            for d in site_dirs:
                if not os.path.isdir(d):
                    log.warn("%s (in --site-dirs) does not exist", d)
                elif normalize_path(d) not in normpath:
                    raise DistutilsOptionError(
                        d + " (in --site-dirs) is not on sys.path"
                    )
                else:
                    self.all_site_dirs.append(normalize_path(d))
        if not self.editable:
            self.check_site_dir()
        self.index_url = self.index_url or "https://pypi.org/simple/"
        self.shadow_path = self.all_site_dirs[:]
        for path_item in self.install_dir, normalize_path(self.script_dir):
            if path_item not in self.shadow_path:
                self.shadow_path.insert(0, path_item)

        if self.allow_hosts is not None:
            hosts = [s.strip() for s in self.allow_hosts.split(',')]
        else:
            hosts = ['*']
        if self.package_index is None:
            self.package_index = self.create_index(
                self.index_url, search_path=self.shadow_path, hosts=hosts,
            )
        self.local_index = Environment(self.shadow_path + sys.path)

        if self.find_links is not None:
            if isinstance(self.find_links, six.string_types):
                self.find_links = self.find_links.split()
        else:
            self.find_links = []
        if self.local_snapshots_ok:
            self.package_index.scan_egg_links(self.shadow_path + sys.path)
        if not self.no_find_links:
            self.package_index.add_find_links(self.find_links)
        self.set_undefined_options('install_lib', ('optimize', 'optimize'))
        if not isinstance(self.optimize, int):
            try:
                self.optimize = int(self.optimize)
                if not (0 <= self.optimize <= 2):
                    raise ValueError
            except ValueError:
                raise DistutilsOptionError("--optimize must be 0, 1, or 2")

        if self.editable and not self.build_directory:
            raise DistutilsArgError(
                "Must specify a build directory (-b) when using --editable"
            )
        if not self.args:
            raise DistutilsArgError(
                "No urls, filenames, or requirements specified (see --help)")

        self.outputs = []

    def _fix_install_dir_for_user_site(self):
        """
        Fix the install_dir if "--user" was used.
        """
        if not self.user or not site.ENABLE_USER_SITE:
            return

        self.create_home_path()
        if self.install_userbase is None:
            msg = "User base directory is not specified"
            raise DistutilsPlatformError(msg)
        self.install_base = self.install_platbase = self.install_userbase
        scheme_name = os.name.replace('posix', 'unix') + '_user'
        self.select_scheme(scheme_name)

    def _expand_attrs(self, attrs):
        for attr in attrs:
            val = getattr(self, attr)
            if val is not None:
                if os.name == 'posix' or os.name == 'nt':
                    val = os.path.expanduser(val)
                val = subst_vars(val, self.config_vars)
                setattr(self, attr, val)

    def expand_basedirs(self):
        """Calls `os.path.expanduser` on install_base, install_platbase and
        root."""
        self._expand_attrs(['install_base', 'install_platbase', 'root'])

    def expand_dirs(self):
        """Calls `os.path.expanduser` on install dirs."""
        dirs = [
            'install_purelib',
            'install_platlib',
            'install_lib',
            'install_headers',
            'install_scripts',
            'install_data',
        ]
        self._expand_attrs(dirs)

    def run(self):
        if self.verbose != self.distribution.verbose:
            log.set_verbosity(self.verbose)
        try:
            for spec in self.args:
                self.easy_install(spec, not self.no_deps)
            if self.record:
                outputs = self.outputs
                if self.root:  # strip any package prefix
                    root_len = len(self.root)
                    for counter in range(len(outputs)):
                        outputs[counter] = outputs[counter][root_len:]
                from distutils import file_util

                self.execute(
                    file_util.write_file, (self.record, outputs),
                    "writing list of installed files to '%s'" %
                    self.record
                )
            self.warn_deprecated_options()
        finally:
            log.set_verbosity(self.distribution.verbose)

    def pseudo_tempname(self):
        """Return a pseudo-tempname base in the install directory.
        This code is intentionally naive; if a malicious party can write to
        the target directory you're already in deep doodoo.
        """
        try:
            pid = os.getpid()
        except Exception:
            pid = random.randint(0, sys.maxsize)
        return os.path.join(self.install_dir, "test-easy-install-%s" % pid)

    def warn_deprecated_options(self):
        pass

    def check_site_dir(self):
        """Verify that self.install_dir is .pth-capable dir, if needed"""

        instdir = normalize_path(self.install_dir)
        pth_file = os.path.join(instdir, 'easy-install.pth')

        if not os.path.exists(instdir):
            try:
                os.makedirs(instdir)
            except (OSError, IOError):
                self.cant_write_to_target()

        # Is it a configured, PYTHONPATH, implicit, or explicit site dir?
        is_site_dir = instdir in self.all_site_dirs

        if not is_site_dir and not self.multi_version:
            # No?  Then directly test whether it does .pth file processing
            is_site_dir = self.check_pth_processing()
        else:
            # make sure we can write to target dir
            testfile = self.pseudo_tempname() + '.write-test'
            test_exists = os.path.exists(testfile)
            try:
                if test_exists:
                    os.unlink(testfile)
                open(testfile, 'w').close()
                os.unlink(testfile)
            except (OSError, IOError):
                self.cant_write_to_target()

        if not is_site_dir and not self.multi_version:
            # Can't install non-multi to non-site dir
            raise DistutilsError(self.no_default_version_msg())

        if is_site_dir:
            if self.pth_file is None:
                self.pth_file = PthDistributions(pth_file, self.all_site_dirs)
        else:
            self.pth_file = None

        if instdir not in map(normalize_path, _pythonpath()):
            # only PYTHONPATH dirs need a site.py, so pretend it's there
            self.sitepy_installed = True
        elif self.multi_version and not os.path.exists(pth_file):
            self.sitepy_installed = True  # don't need site.py in this case
            self.pth_file = None  # and don't create a .pth file
        self.install_dir = instdir

    __cant_write_msg = textwrap.dedent("""
        can't create or remove files in install directory

        The following error occurred while trying to add or remove files in the
        installation directory:

            %s

        The installation directory you specified (via --install-dir, --prefix, or
        the distutils default setting) was:

            %s
        """).lstrip()

    __not_exists_id = textwrap.dedent("""
        This directory does not currently exist.  Please create it and try again, or
        choose a different installation directory (using the -d or --install-dir
        option).
        """).lstrip()

    __access_msg = textwrap.dedent("""
        Perhaps your account does not have write access to this directory?  If the
        installation directory is a system-owned directory, you may need to sign in
        as the administrator or "root" account.  If you do not have administrative
        access to this machine, you may wish to choose a different installation
        directory, preferably one that is listed in your PYTHONPATH environment
        variable.

        For information on other options, you may wish to consult the
        documentation at:

          https://setuptools.readthedocs.io/en/latest/easy_install.html

        Please make the appropriate changes for your system and try again.
        """).lstrip()

    def cant_write_to_target(self):
        msg = self.__cant_write_msg % (sys.exc_info()[1], self.install_dir,)

        if not os.path.exists(self.install_dir):
            msg += '\n' + self.__not_exists_id
        else:
            msg += '\n' + self.__access_msg
        raise DistutilsError(msg)

    def check_pth_processing(self):
        """Empirically verify whether .pth files are supported in inst. dir"""
        instdir = self.install_dir
        log.info("Checking .pth file support in %s", instdir)
        pth_file = self.pseudo_tempname() + ".pth"
        ok_file = pth_file + '.ok'
        ok_exists = os.path.exists(ok_file)
        tmpl = _one_liner("""
            import os
            f = open({ok_file!r}, 'w')
            f.write('OK')
            f.close()
            """) + '\n'
        try:
            if ok_exists:
                os.unlink(ok_file)
            dirname = os.path.dirname(ok_file)
            pkg_resources.py31compat.makedirs(dirname, exist_ok=True)
            f = open(pth_file, 'w')
        except (OSError, IOError):
            self.cant_write_to_target()
        else:
            try:
                f.write(tmpl.format(**locals()))
                f.close()
                f = None
                executable = sys.executable
                if os.name == 'nt':
                    dirname, basename = os.path.split(executable)
                    alt = os.path.join(dirname, 'pythonw.exe')
                    use_alt = (
                        basename.lower() == 'python.exe' and
                        os.path.exists(alt)
                    )
                    if use_alt:
                        # use pythonw.exe to avoid opening a console window
                        executable = alt

                from distutils.spawn import spawn

                spawn([executable, '-E', '-c', 'pass'], 0)

                if os.path.exists(ok_file):
                    log.info(
                        "TEST PASSED: %s appears to support .pth files",
                        instdir
                    )
                    return True
            finally:
                if f:
                    f.close()
                if os.path.exists(ok_file):
                    os.unlink(ok_file)
                if os.path.exists(pth_file):
                    os.unlink(pth_file)
        if not self.multi_version:
            log.warn("TEST FAILED: %s does NOT support .pth files", instdir)
        return False

    def install_egg_scripts(self, dist):
        """Write all the scripts for `dist`, unless scripts are excluded"""
        if not self.exclude_scripts and dist.metadata_isdir('scripts'):
            for script_name in dist.metadata_listdir('scripts'):
                if dist.metadata_isdir('scripts/' + script_name):
                    # The "script" is a directory, likely a Python 3
                    # __pycache__ directory, so skip it.
                    continue
                self.install_script(
                    dist, script_name,
                    dist.get_metadata('scripts/' + script_name)
                )
        self.install_wrapper_scripts(dist)

    def add_output(self, path):
        if os.path.isdir(path):
            for base, dirs, files in os.walk(path):
                for filename in files:
                    self.outputs.append(os.path.join(base, filename))
        else:
            self.outputs.append(path)

    def not_editable(self, spec):
        if self.editable:
            raise DistutilsArgError(
                "Invalid argument %r: you can't use filenames or URLs "
                "with --editable (except via the --find-links option)."
                % (spec,)
            )

    def check_editable(self, spec):
        if not self.editable:
            return

        if os.path.exists(os.path.join(self.build_directory, spec.key)):
            raise DistutilsArgError(
                "%r already exists in %s; can't do a checkout there" %
                (spec.key, self.build_directory)
            )

    @contextlib.contextmanager
    def _tmpdir(self):
        tmpdir = tempfile.mkdtemp(prefix=u"easy_install-")
        try:
            # cast to str as workaround for #709 and #710 and #712
            yield str(tmpdir)
        finally:
            os.path.exists(tmpdir) and rmtree(rmtree_safe(tmpdir))

    def easy_install(self, spec, deps=False):
        if not self.editable:
            self.install_site_py()

        with self._tmpdir() as tmpdir:
            if not isinstance(spec, Requirement):
                if URL_SCHEME(spec):
                    # It's a url, download it to tmpdir and process
                    self.not_editable(spec)
                    dl = self.package_index.download(spec, tmpdir)
                    return self.install_item(None, dl, tmpdir, deps, True)

                elif os.path.exists(spec):
                    # Existing file or directory, just process it directly
                    self.not_editable(spec)
                    return self.install_item(None, spec, tmpdir, deps, True)
                else:
                    spec = parse_requirement_arg(spec)

            self.check_editable(spec)
            dist = self.package_index.fetch_distribution(
                spec, tmpdir, self.upgrade, self.editable,
                not self.always_copy, self.local_index
            )
            if dist is None:
                msg = "Could not find suitable distribution for %r" % spec
                if self.always_copy:
                    msg += " (--always-copy skips system and development eggs)"
                raise DistutilsError(msg)
            elif dist.precedence == DEVELOP_DIST:
                # .egg-info dists don't need installing, just process deps
                self.process_distribution(spec, dist, deps, "Using")
                return dist
            else:
                return self.install_item(spec, dist.location, tmpdir, deps)

    def install_item(self, spec, download, tmpdir, deps, install_needed=False):

        # Installation is also needed if file in tmpdir or is not an egg
        install_needed = install_needed or self.always_copy
        install_needed = install_needed or os.path.dirname(download) == tmpdir
        install_needed = install_needed or not download.endswith('.egg')
        install_needed = install_needed or (
            self.always_copy_from is not None and
            os.path.dirname(normalize_path(download)) ==
            normalize_path(self.always_copy_from)
        )

        if spec and not install_needed:
            # at this point, we know it's a local .egg, we just don't know if
            # it's already installed.
            for dist in self.local_index[spec.project_name]:
                if dist.location == download:
                    break
            else:
                install_needed = True  # it's not in the local index

        log.info("Processing %s", os.path.basename(download))

        if install_needed:
            dists = self.install_eggs(spec, download, tmpdir)
            for dist in dists:
                self.process_distribution(spec, dist, deps)
        else:
            dists = [self.egg_distribution(download)]
            self.process_distribution(spec, dists[0], deps, "Using")

        if spec is not None:
            for dist in dists:
                if dist in spec:
                    return dist

    def select_scheme(self, name):
        """Sets the install directories by applying the install schemes."""
        # it's the caller's problem if they supply a bad name!
        scheme = INSTALL_SCHEMES[name]
        for key in SCHEME_KEYS:
            attrname = 'install_' + key
            if getattr(self, attrname) is None:
                setattr(self, attrname, scheme[key])

    def process_distribution(self, requirement, dist, deps=True, *info):
        self.update_pth(dist)
        self.package_index.add(dist)
        if dist in self.local_index[dist.key]:
            self.local_index.remove(dist)
        self.local_index.add(dist)
        self.install_egg_scripts(dist)
        self.installed_projects[dist.key] = dist
        log.info(self.installation_report(requirement, dist, *info))
        if (dist.has_metadata('dependency_links.txt') and
                not self.no_find_links):
            self.package_index.add_find_links(
                dist.get_metadata_lines('dependency_links.txt')
            )
        if not deps and not self.always_copy:
            return
        elif requirement is not None and dist.key != requirement.key:
            log.warn("Skipping dependencies for %s", dist)
            return  # XXX this is not the distribution we were looking for
        elif requirement is None or dist not in requirement:
            # if we wound up with a different version, resolve what we've got
            distreq = dist.as_requirement()
            requirement = Requirement(str(distreq))
        log.info("Processing dependencies for %s", requirement)
        try:
            distros = WorkingSet([]).resolve(
                [requirement], self.local_index, self.easy_install
            )
        except DistributionNotFound as e:
            raise DistutilsError(str(e))
        except VersionConflict as e:
            raise DistutilsError(e.report())
        if self.always_copy or self.always_copy_from:
            # Force all the relevant distros to be copied or activated
            for dist in distros:
                if dist.key not in self.installed_projects:
                    self.easy_install(dist.as_requirement())
        log.info("Finished processing dependencies for %s", requirement)

    def should_unzip(self, dist):
        if self.zip_ok is not None:
            return not self.zip_ok
        if dist.has_metadata('not-zip-safe'):
            return True
        if not dist.has_metadata('zip-safe'):
            return True
        return False

    def maybe_move(self, spec, dist_filename, setup_base):
        dst = os.path.join(self.build_directory, spec.key)
        if os.path.exists(dst):
            msg = (
                "%r already exists in %s; build directory %s will not be kept"
            )
            log.warn(msg, spec.key, self.build_directory, setup_base)
            return setup_base
        if os.path.isdir(dist_filename):
            setup_base = dist_filename
        else:
            if os.path.dirname(dist_filename) == setup_base:
                os.unlink(dist_filename)  # get it out of the tmp dir
            contents = os.listdir(setup_base)
            if len(contents) == 1:
                dist_filename = os.path.join(setup_base, contents[0])
                if os.path.isdir(dist_filename):
                    # if the only thing there is a directory, move it instead
                    setup_base = dist_filename
        ensure_directory(dst)
        shutil.move(setup_base, dst)
        return dst

    def install_wrapper_scripts(self, dist):
        if self.exclude_scripts:
            return
        for args in ScriptWriter.best().get_args(dist):
            self.write_script(*args)

    def install_script(self, dist, script_name, script_text, dev_path=None):
        """Generate a legacy script wrapper and install it"""
        spec = str(dist.as_requirement())
        is_script = is_python_script(script_text, script_name)

        if is_script:
            body = self._load_template(dev_path) % locals()
            script_text = ScriptWriter.get_header(script_text) + body
        self.write_script(script_name, _to_bytes(script_text), 'b')

    @staticmethod
    def _load_template(dev_path):
        """
        There are a couple of template scripts in the package. This
        function loads one of them and prepares it for use.
        """
        # See https://github.com/pypa/setuptools/issues/134 for info
        # on script file naming and downstream issues with SVR4
        name = 'script.tmpl'
        if dev_path:
            name = name.replace('.tmpl', ' (dev).tmpl')

        raw_bytes = resource_string('setuptools', name)
        return raw_bytes.decode('utf-8')

    def write_script(self, script_name, contents, mode="t", blockers=()):
        """Write an executable file to the scripts directory"""
        self.delete_blockers(  # clean up old .py/.pyw w/o a script
            [os.path.join(self.script_dir, x) for x in blockers]
        )
        log.info("Installing %s script to %s", script_name, self.script_dir)
        target = os.path.join(self.script_dir, script_name)
        self.add_output(target)

        if self.dry_run:
            return

        mask = current_umask()
        ensure_directory(target)
        if os.path.exists(target):
            os.unlink(target)
        with open(target, "w" + mode) as f:
            f.write(contents)
        chmod(target, 0o777 - mask)

    def install_eggs(self, spec, dist_filename, tmpdir):
        # .egg dirs or files are already built, so just return them
        if dist_filename.lower().endswith('.egg'):
            return [self.install_egg(dist_filename, tmpdir)]
        elif dist_filename.lower().endswith('.exe'):
            return [self.install_exe(dist_filename, tmpdir)]
        elif dist_filename.lower().endswith('.whl'):
            return [self.install_wheel(dist_filename, tmpdir)]

        # Anything else, try to extract and build
        setup_base = tmpdir
        if os.path.isfile(dist_filename) and not dist_filename.endswith('.py'):
            unpack_archive(dist_filename, tmpdir, self.unpack_progress)
        elif os.path.isdir(dist_filename):
            setup_base = os.path.abspath(dist_filename)

        if (setup_base.startswith(tmpdir)  # something we downloaded
                and self.build_directory and spec is not None):
            setup_base = self.maybe_move(spec, dist_filename, setup_base)

        # Find the setup.py file
        setup_script = os.path.join(setup_base, 'setup.py')

        if not os.path.exists(setup_script):
            setups = glob(os.path.join(setup_base, '*', 'setup.py'))
            if not setups:
                raise DistutilsError(
                    "Couldn't find a setup script in %s" %
                    os.path.abspath(dist_filename)
                )
            if len(setups) > 1:
                raise DistutilsError(
                    "Multiple setup scripts in %s" %
                    os.path.abspath(dist_filename)
                )
            setup_script = setups[0]

        # Now run it, and return the result
        if self.editable:
            log.info(self.report_editable(spec, setup_script))
            return []
        else:
            return self.build_and_install(setup_script, setup_base)

    def egg_distribution(self, egg_path):
        if os.path.isdir(egg_path):
            metadata = PathMetadata(egg_path, os.path.join(egg_path,
                                                           'EGG-INFO'))
        else:
            metadata = EggMetadata(zipimport.zipimporter(egg_path))
        return Distribution.from_filename(egg_path, metadata=metadata)

    def install_egg(self, egg_path, tmpdir):
        destination = os.path.join(
            self.install_dir,
            os.path.basename(egg_path),
        )
        destination = os.path.abspath(destination)
        if not self.dry_run:
            ensure_directory(destination)

        dist = self.egg_distribution(egg_path)
        if not samefile(egg_path, destination):
            if os.path.isdir(destination) and not os.path.islink(destination):
                dir_util.remove_tree(destination, dry_run=self.dry_run)
            elif os.path.exists(destination):
                self.execute(
                    os.unlink,
                    (destination,),
                    "Removing " + destination,
                )
            try:
                new_dist_is_zipped = False
                if os.path.isdir(egg_path):
                    if egg_path.startswith(tmpdir):
                        f, m = shutil.move, "Moving"
                    else:
                        f, m = shutil.copytree, "Copying"
                elif self.should_unzip(dist):
                    self.mkpath(destination)
                    f, m = self.unpack_and_compile, "Extracting"
                else:
                    new_dist_is_zipped = True
                    if egg_path.startswith(tmpdir):
                        f, m = shutil.move, "Moving"
                    else:
                        f, m = shutil.copy2, "Copying"
                self.execute(
                    f,
                    (egg_path, destination),
                    (m + " %s to %s") % (
                        os.path.basename(egg_path),
                        os.path.dirname(destination)
                    ),
                )
                update_dist_caches(
                    destination,
                    fix_zipimporter_caches=new_dist_is_zipped,
                )
            except Exception:
                update_dist_caches(destination, fix_zipimporter_caches=False)
                raise

        self.add_output(destination)
        return self.egg_distribution(destination)

    def install_exe(self, dist_filename, tmpdir):
        # See if it's valid, get data
        cfg = extract_wininst_cfg(dist_filename)
        if cfg is None:
            raise DistutilsError(
                "%s is not a valid distutils Windows .exe" % dist_filename
            )
        # Create a dummy distribution object until we build the real distro
        dist = Distribution(
            None,
            project_name=cfg.get('metadata', 'name'),
            version=cfg.get('metadata', 'version'), platform=get_platform(),
        )

        # Convert the .exe to an unpacked egg
        egg_path = os.path.join(tmpdir, dist.egg_name() + '.egg')
        dist.location = egg_path
        egg_tmp = egg_path + '.tmp'
        _egg_info = os.path.join(egg_tmp, 'EGG-INFO')
        pkg_inf = os.path.join(_egg_info, 'PKG-INFO')
        ensure_directory(pkg_inf)  # make sure EGG-INFO dir exists
        dist._provider = PathMetadata(egg_tmp, _egg_info)  # XXX
        self.exe_to_egg(dist_filename, egg_tmp)

        # Write EGG-INFO/PKG-INFO
        if not os.path.exists(pkg_inf):
            f = open(pkg_inf, 'w')
            f.write('Metadata-Version: 1.0\n')
            for k, v in cfg.items('metadata'):
                if k != 'target_version':
                    f.write('%s: %s\n' % (k.replace('_', '-').title(), v))
            f.close()
        script_dir = os.path.join(_egg_info, 'scripts')
        # delete entry-point scripts to avoid duping
        self.delete_blockers([
            os.path.join(script_dir, args[0])
            for args in ScriptWriter.get_args(dist)
        ])
        # Build .egg file from tmpdir
        bdist_egg.make_zipfile(
            egg_path, egg_tmp, verbose=self.verbose, dry_run=self.dry_run,
        )
        # install the .egg
        return self.install_egg(egg_path, tmpdir)

    def exe_to_egg(self, dist_filename, egg_tmp):
        """Extract a bdist_wininst to the directories an egg would use"""
        # Check for .pth file and set up prefix translations
        prefixes = get_exe_prefixes(dist_filename)
        to_compile = []
        native_libs = []
        top_level = {}

        def process(src, dst):
            s = src.lower()
            for old, new in prefixes:
                if s.startswith(old):
                    src = new + src[len(old):]
                    parts = src.split('/')
                    dst = os.path.join(egg_tmp, *parts)
                    dl = dst.lower()
                    if dl.endswith('.pyd') or dl.endswith('.dll'):
                        parts[-1] = bdist_egg.strip_module(parts[-1])
                        top_level[os.path.splitext(parts[0])[0]] = 1
                        native_libs.append(src)
                    elif dl.endswith('.py') and old != 'SCRIPTS/':
                        top_level[os.path.splitext(parts[0])[0]] = 1
                        to_compile.append(dst)
                    return dst
            if not src.endswith('.pth'):
                log.warn("WARNING: can't process %s", src)
            return None

        # extract, tracking .pyd/.dll->native_libs and .py -> to_compile
        unpack_archive(dist_filename, egg_tmp, process)
        stubs = []
        for res in native_libs:
            if res.lower().endswith('.pyd'):  # create stubs for .pyd's
                parts = res.split('/')
                resource = parts[-1]
                parts[-1] = bdist_egg.strip_module(parts[-1]) + '.py'
                pyfile = os.path.join(egg_tmp, *parts)
                to_compile.append(pyfile)
                stubs.append(pyfile)
                bdist_egg.write_stub(resource, pyfile)
        self.byte_compile(to_compile)  # compile .py's
        bdist_egg.write_safety_flag(
            os.path.join(egg_tmp, 'EGG-INFO'),
            bdist_egg.analyze_egg(egg_tmp, stubs))  # write zip-safety flag

        for name in 'top_level', 'native_libs':
            if locals()[name]:
                txt = os.path.join(egg_tmp, 'EGG-INFO', name + '.txt')
                if not os.path.exists(txt):
                    f = open(txt, 'w')
                    f.write('\n'.join(locals()[name]) + '\n')
                    f.close()

    def install_wheel(self, wheel_path, tmpdir):
        wheel = Wheel(wheel_path)
        assert wheel.is_compatible()
        destination = os.path.join(self.install_dir, wheel.egg_name())
        destination = os.path.abspath(destination)
        if not self.dry_run:
            ensure_directory(destination)
        if os.path.isdir(destination) and not os.path.islink(destination):
            dir_util.remove_tree(destination, dry_run=self.dry_run)
        elif os.path.exists(destination):
            self.execute(
                os.unlink,
                (destination,),
                "Removing " + destination,
            )
        try:
            self.execute(
                wheel.install_as_egg,
                (destination,),
                ("Installing %s to %s") % (
                    os.path.basename(wheel_path),
                    os.path.dirname(destination)
                ),
            )
        finally:
            update_dist_caches(destination, fix_zipimporter_caches=False)
        self.add_output(destination)
        return self.egg_distribution(destination)

    __mv_warning = textwrap.dedent("""
        Because this distribution was installed --multi-version, before you can
        import modules from this package in an application, you will need to
        'import pkg_resources' and then use a 'require()' call similar to one of
        these examples, in order to select the desired version:

            pkg_resources.require("%(name)s")  # latest installed version
            pkg_resources.require("%(name)s==%(version)s")  # this exact version
            pkg_resources.require("%(name)s>=%(version)s")  # this version or higher
        """).lstrip()

    __id_warning = textwrap.dedent("""
        Note also that the installation directory must be on sys.path at runtime for
        this to work.  (e.g. by being the application's script directory, by being on
        PYTHONPATH, or by being added to sys.path by your code.)
        """)

    def installation_report(self, req, dist, what="Installed"):
        """Helpful installation message for display to package users"""
        msg = "\n%(what)s %(eggloc)s%(extras)s"
        if self.multi_version and not self.no_report:
            msg += '\n' + self.__mv_warning
            if self.install_dir not in map(normalize_path, sys.path):
                msg += '\n' + self.__id_warning

        eggloc = dist.location
        name = dist.project_name
        version = dist.version
        extras = ''  # TODO: self.report_extras(req, dist)
        return msg % locals()

    __editable_msg = textwrap.dedent("""
        Extracted editable version of %(spec)s to %(dirname)s

        If it uses setuptools in its setup script, you can activate it in
        "development" mode by going to that directory and running::

            %(python)s setup.py develop

        See the setuptools documentation for the "develop" command for more info.
        """).lstrip()

    def report_editable(self, spec, setup_script):
        dirname = os.path.dirname(setup_script)
        python = sys.executable
        return '\n' + self.__editable_msg % locals()

    def run_setup(self, setup_script, setup_base, args):
        sys.modules.setdefault('distutils.command.bdist_egg', bdist_egg)
        sys.modules.setdefault('distutils.command.egg_info', egg_info)

        args = list(args)
        if self.verbose > 2:
            v = 'v' * (self.verbose - 1)
            args.insert(0, '-' + v)
        elif self.verbose < 2:
            args.insert(0, '-q')
        if self.dry_run:
            args.insert(0, '-n')
        log.info(
            "Running %s %s", setup_script[len(setup_base) + 1:], ' '.join(args)
        )
        try:
            run_setup(setup_script, args)
        except SystemExit as v:
            raise DistutilsError("Setup script exited with %s" % (v.args[0],))

    def build_and_install(self, setup_script, setup_base):
        args = ['bdist_egg', '--dist-dir']

        dist_dir = tempfile.mkdtemp(
            prefix='egg-dist-tmp-', dir=os.path.dirname(setup_script)
        )
        try:
            self._set_fetcher_options(os.path.dirname(setup_script))
            args.append(dist_dir)

            self.run_setup(setup_script, setup_base, args)
            all_eggs = Environment([dist_dir])
            eggs = []
            for key in all_eggs:
                for dist in all_eggs[key]:
                    eggs.append(self.install_egg(dist.location, setup_base))
            if not eggs and not self.dry_run:
                log.warn("No eggs found in %s (setup script problem?)",
                         dist_dir)
            return eggs
        finally:
            rmtree(dist_dir)
            log.set_verbosity(self.verbose)  # restore our log verbosity

    def _set_fetcher_options(self, base):
        """
        When easy_install is about to run bdist_egg on a source dist, that
        source dist might have 'setup_requires' directives, requiring
        additional fetching. Ensure the fetcher options given to easy_install
        are available to that command as well.
        """
        # find the fetch options from easy_install and write them out
        # to the setup.cfg file.
        ei_opts = self.distribution.get_option_dict('easy_install').copy()
        fetch_directives = (
            'find_links', 'site_dirs', 'index_url', 'optimize', 'allow_hosts',
        )
        fetch_options = {}
        for key, val in ei_opts.items():
            if key not in fetch_directives:
                continue
            fetch_options[key.replace('_', '-')] = val[1]
        # create a settings dictionary suitable for `edit_config`
        settings = dict(easy_install=fetch_options)
        cfg_filename = os.path.join(base, 'setup.cfg')
        setopt.edit_config(cfg_filename, settings)

    def update_pth(self, dist):
        if self.pth_file is None:
            return

        for d in self.pth_file[dist.key]:  # drop old entries
            if self.multi_version or d.location != dist.location:
                log.info("Removing %s from easy-install.pth file", d)
                self.pth_file.remove(d)
                if d.location in self.shadow_path:
                    self.shadow_path.remove(d.location)

        if not self.multi_version:
            if dist.location in self.pth_file.paths:
                log.info(
                    "%s is already the active version in easy-install.pth",
                    dist,
                )
            else:
                log.info("Adding %s to easy-install.pth file", dist)
                self.pth_file.add(dist)  # add new entry
                if dist.location not in self.shadow_path:
                    self.shadow_path.append(dist.location)

        if not self.dry_run:

            self.pth_file.save()

            if dist.key == 'setuptools':
                # Ensure that setuptools itself never becomes unavailable!
                # XXX should this check for latest version?
                filename = os.path.join(self.install_dir, 'setuptools.pth')
                if os.path.islink(filename):
                    os.unlink(filename)
                f = open(filename, 'wt')
                f.write(self.pth_file.make_relative(dist.location) + '\n')
                f.close()

    def unpack_progress(self, src, dst):
        # Progress filter for unpacking
        log.debug("Unpacking %s to %s", src, dst)
        return dst  # only unpack-and-compile skips files for dry run

    def unpack_and_compile(self, egg_path, destination):
        to_compile = []
        to_chmod = []

        def pf(src, dst):
            if dst.endswith('.py') and not src.startswith('EGG-INFO/'):
                to_compile.append(dst)
            elif dst.endswith('.dll') or dst.endswith('.so'):
                to_chmod.append(dst)
            self.unpack_progress(src, dst)
            return not self.dry_run and dst or None

        unpack_archive(egg_path, destination, pf)
        self.byte_compile(to_compile)
        if not self.dry_run:
            for f in to_chmod:
                mode = ((os.stat(f)[stat.ST_MODE]) | 0o555) & 0o7755
                chmod(f, mode)

    def byte_compile(self, to_compile):
        if sys.dont_write_bytecode:
            return

        from distutils.util import byte_compile

        try:
            # try to make the byte compile messages quieter
            log.set_verbosity(self.verbose - 1)

            byte_compile(to_compile, optimize=0, force=1, dry_run=self.dry_run)
            if self.optimize:
                byte_compile(
                    to_compile, optimize=self.optimize, force=1,
                    dry_run=self.dry_run,
                )
        finally:
            log.set_verbosity(self.verbose)  # restore original verbosity

    __no_default_msg = textwrap.dedent("""
        bad install directory or PYTHONPATH

        You are attempting to install a package to a directory that is not
        on PYTHONPATH and which Python does not read ".pth" files from.  The
        installation directory you specified (via --install-dir, --prefix, or
        the distutils default setting) was:

            %s

        and your PYTHONPATH environment variable currently contains:

            %r

        Here are some of your options for correcting the problem:

        * You can choose a different installation directory, i.e., one that is
          on PYTHONPATH or supports .pth files

        * You can add the installation directory to the PYTHONPATH environment
          variable.  (It must then also be on PYTHONPATH whenever you run
          Python and want to use the package(s) you are installing.)

        * You can set up the installation directory to support ".pth" files by
          using one of the approaches described here:

          https://setuptools.readthedocs.io/en/latest/easy_install.html#custom-installation-locations


        Please make the appropriate changes for your system and try again.""").lstrip()

    def no_default_version_msg(self):
        template = self.__no_default_msg
        return template % (self.install_dir, os.environ.get('PYTHONPATH', ''))

    def install_site_py(self):
        """Make sure there's a site.py in the target dir, if needed"""

        if self.sitepy_installed:
            return  # already did it, or don't need to

        sitepy = os.path.join(self.install_dir, "site.py")
        source = resource_string("setuptools", "site-patch.py")
        source = source.decode('utf-8')
        current = ""

        if os.path.exists(sitepy):
            log.debug("Checking existing site.py in %s", self.install_dir)
            with io.open(sitepy) as strm:
                current = strm.read()

            if not current.startswith('def __boot():'):
                raise DistutilsError(
                    "%s is not a setuptools-generated site.py; please"
                    " remove it." % sitepy
                )

        if current != source:
            log.info("Creating %s", sitepy)
            if not self.dry_run:
                ensure_directory(sitepy)
                with io.open(sitepy, 'w', encoding='utf-8') as strm:
                    strm.write(source)
            self.byte_compile([sitepy])

        self.sitepy_installed = True

    def create_home_path(self):
        """Create directories under ~."""
        if not self.user:
            return
        home = convert_path(os.path.expanduser("~"))
        for name, path in six.iteritems(self.config_vars):
            if path.startswith(home) and not os.path.isdir(path):
                self.debug_print("os.makedirs('%s', 0o700)" % path)
                os.makedirs(path, 0o700)

    INSTALL_SCHEMES = dict(
        posix=dict(
            install_dir='$base/lib/python$py_version_short/site-packages',
            script_dir='$base/bin',
        ),
    )

    DEFAULT_SCHEME = dict(
        install_dir='$base/Lib/site-packages',
        script_dir='$base/Scripts',
    )

    def _expand(self, *attrs):
        config_vars = self.get_finalized_command('install').config_vars

        if self.prefix:
            # Set default install_dir/scripts from --prefix
            config_vars = config_vars.copy()
            config_vars['base'] = self.prefix
            scheme = self.INSTALL_SCHEMES.get(os.name, self.DEFAULT_SCHEME)
            for attr, val in scheme.items():
                if getattr(self, attr, None) is None:
                    setattr(self, attr, val)

        from distutils.util import subst_vars

        for attr in attrs:
            val = getattr(self, attr)
            if val is not None:
                val = subst_vars(val, config_vars)
                if os.name == 'posix':
                    val = os.path.expanduser(val)
                setattr(self, attr, val)


def _pythonpath():
    items = os.environ.get('PYTHONPATH', '').split(os.pathsep)
    return filter(None, items)


def get_site_dirs():
    """
    Return a list of 'site' dirs
    """

    sitedirs = []

    # start with PYTHONPATH
    sitedirs.extend(_pythonpath())

    prefixes = [sys.prefix]
    if sys.exec_prefix != sys.prefix:
        prefixes.append(sys.exec_prefix)
    for prefix in prefixes:
        if prefix:
            if sys.platform in ('os2emx', 'riscos'):
                sitedirs.append(os.path.join(prefix, "Lib", "site-packages"))
            elif os.sep == '/':
                sitedirs.extend([
                    os.path.join(
                        prefix,
                        "lib",
                        "python{}.{}".format(*sys.version_info),
                        "site-packages",
                    ),
                    os.path.join(prefix, "lib", "site-python"),
                ])
            else:
                sitedirs.extend([
                    prefix,
                    os.path.join(prefix, "lib", "site-packages"),
                ])
            if sys.platform == 'darwin':
                # for framework builds *only* we add the standard Apple
                # locations. Currently only per-user, but /Library and
                # /Network/Library could be added too
                if 'Python.framework' in prefix:
                    home = os.environ.get('HOME')
                    if home:
                        home_sp = os.path.join(
                            home,
                            'Library',
                            'Python',
                            '{}.{}'.format(*sys.version_info),
                            'site-packages',
                        )
                        sitedirs.append(home_sp)
    lib_paths = get_path('purelib'), get_path('platlib')
    for site_lib in lib_paths:
        if site_lib not in sitedirs:
            sitedirs.append(site_lib)

    if site.ENABLE_USER_SITE:
        sitedirs.append(site.USER_SITE)

    try:
        sitedirs.extend(site.getsitepackages())
    except AttributeError:
        pass

    sitedirs = list(map(normalize_path, sitedirs))

    return sitedirs


def expand_paths(inputs):
    """Yield sys.path directories that might contain "old-style" packages"""

    seen = {}

    for dirname in inputs:
        dirname = normalize_path(dirname)
        if dirname in seen:
            continue

        seen[dirname] = 1
        if not os.path.isdir(dirname):
            continue

        files = os.listdir(dirname)
        yield dirname, files

        for name in files:
            if not name.endswith('.pth'):
                # We only care about the .pth files
                continue
            if name in ('easy-install.pth', 'setuptools.pth'):
                # Ignore .pth files that we control
                continue

            # Read the .pth file
            f = open(os.path.join(dirname, name))
            lines = list(yield_lines(f))
            f.close()

            # Yield existing non-dupe, non-import directory lines from it
            for line in lines:
                if not line.startswith("import"):
                    line = normalize_path(line.rstrip())
                    if line not in seen:
                        seen[line] = 1
                        if not os.path.isdir(line):
                            continue
                        yield line, os.listdir(line)


def extract_wininst_cfg(dist_filename):
    """Extract configuration data from a bdist_wininst .exe

    Returns a configparser.RawConfigParser, or None
    """
    f = open(dist_filename, 'rb')
    try:
        endrec = zipfile._EndRecData(f)
        if endrec is None:
            return None

        prepended = (endrec[9] - endrec[5]) - endrec[6]
        if prepended < 12:  # no wininst data here
            return None
        f.seek(prepended - 12)

        tag, cfglen, bmlen = struct.unpack("<iii", f.read(12))
        if tag not in (0x1234567A, 0x1234567B):
            return None  # not a valid tag

        f.seek(prepended - (12 + cfglen))
        init = {'version': '', 'target_version': ''}
        cfg = configparser.RawConfigParser(init)
        try:
            part = f.read(cfglen)
            # Read up to the first null byte.
            config = part.split(b'\0', 1)[0]
            # Now the config is in bytes, but for RawConfigParser, it should
            #  be text, so decode it.
            config = config.decode(sys.getfilesystemencoding())
            cfg.readfp(six.StringIO(config))
        except configparser.Error:
            return None
        if not cfg.has_section('metadata') or not cfg.has_section('Setup'):
            return None
        return cfg

    finally:
        f.close()


def get_exe_prefixes(exe_filename):
    """Get exe->egg path translations for a given .exe file"""

    prefixes = [
        ('PURELIB/', ''),
        ('PLATLIB/pywin32_system32', ''),
        ('PLATLIB/', ''),
        ('SCRIPTS/', 'EGG-INFO/scripts/'),
        ('DATA/lib/site-packages', ''),
    ]
    z = zipfile.ZipFile(exe_filename)
    try:
        for info in z.infolist():
            name = info.filename
            parts = name.split('/')
            if len(parts) == 3 and parts[2] == 'PKG-INFO':
                if parts[1].endswith('.egg-info'):
                    prefixes.insert(0, ('/'.join(parts[:2]), 'EGG-INFO/'))
                    break
            if len(parts) != 2 or not name.endswith('.pth'):
                continue
            if name.endswith('-nspkg.pth'):
                continue
            if parts[0].upper() in ('PURELIB', 'PLATLIB'):
                contents = z.read(name)
                if six.PY3:
                    contents = contents.decode()
                for pth in yield_lines(contents):
                    pth = pth.strip().replace('\\', '/')
                    if not pth.startswith('import'):
                        prefixes.append((('%s/%s/' % (parts[0], pth)), ''))
    finally:
        z.close()
    prefixes = [(x.lower(), y) for x, y in prefixes]
    prefixes.sort()
    prefixes.reverse()
    return prefixes


class PthDistributions(Environment):
    """A .pth file with Distribution paths in it"""

    dirty = False

    def __init__(self, filename, sitedirs=()):
        self.filename = filename
        self.sitedirs = list(map(normalize_path, sitedirs))
        self.basedir = normalize_path(os.path.dirname(self.filename))
        self._load()
        Environment.__init__(self, [], None, None)
        for path in yield_lines(self.paths):
            list(map(self.add, find_distributions(path, True)))

    def _load(self):
        self.paths = []
        saw_import = False
        seen = dict.fromkeys(self.sitedirs)
        if os.path.isfile(self.filename):
            f = open(self.filename, 'rt')
            for line in f:
                if line.startswith('import'):
                    saw_import = True
                    continue
                path = line.rstrip()
                self.paths.append(path)
                if not path.strip() or path.strip().startswith('#'):
                    continue
                # skip non-existent paths, in case somebody deleted a package
                # manually, and duplicate paths as well
                path = self.paths[-1] = normalize_path(
                    os.path.join(self.basedir, path)
                )
                if not os.path.exists(path) or path in seen:
                    self.paths.pop()  # skip it
                    self.dirty = True  # we cleaned up, so we're dirty now :)
                    continue
                seen[path] = 1
            f.close()

        if self.paths and not saw_import:
            self.dirty = True  # ensure anything we touch has import wrappers
        while self.paths and not self.paths[-1].strip():
            self.paths.pop()

    def save(self):
        """Write changed .pth file back to disk"""
        if not self.dirty:
            return

        rel_paths = list(map(self.make_relative, self.paths))
        if rel_paths:
            log.debug("Saving %s", self.filename)
            lines = self._wrap_lines(rel_paths)
            data = '\n'.join(lines) + '\n'

            if os.path.islink(self.filename):
                os.unlink(self.filename)
            with open(self.filename, 'wt') as f:
                f.write(data)

        elif os.path.exists(self.filename):
            log.debug("Deleting empty %s", self.filename)
            os.unlink(self.filename)

        self.dirty = False

    @staticmethod
    def _wrap_lines(lines):
        return lines

    def add(self, dist):
        """Add `dist` to the distribution map"""
        new_path = (
            dist.location not in self.paths and (
                dist.location not in self.sitedirs or
                # account for '.' being in PYTHONPATH
                dist.location == os.getcwd()
            )
        )
        if new_path:
            self.paths.append(dist.location)
            self.dirty = True
        Environment.add(self, dist)

    def remove(self, dist):
        """Remove `dist` from the distribution map"""
        while dist.location in self.paths:
            self.paths.remove(dist.location)
            self.dirty = True
        Environment.remove(self, dist)

    def make_relative(self, path):
        npath, last = os.path.split(normalize_path(path))
        baselen = len(self.basedir)
        parts = [last]
        sep = os.altsep == '/' and '/' or os.sep
        while len(npath) >= baselen:
            if npath == self.basedir:
                parts.append(os.curdir)
                parts.reverse()
                return sep.join(parts)
            npath, last = os.path.split(npath)
            parts.append(last)
        else:
            return path


class RewritePthDistributions(PthDistributions):
    @classmethod
    def _wrap_lines(cls, lines):
        yield cls.prelude
        for line in lines:
            yield line
        yield cls.postlude

    prelude = _one_liner("""
        import sys
        sys.__plen = len(sys.path)
        """)
    postlude = _one_liner("""
        import sys
        new = sys.path[sys.__plen:]
        del sys.path[sys.__plen:]
        p = getattr(sys, '__egginsert', 0)
        sys.path[p:p] = new
        sys.__egginsert = p + len(new)
        """)


if os.environ.get('SETUPTOOLS_SYS_PATH_TECHNIQUE', 'raw') == 'rewrite':
    PthDistributions = RewritePthDistributions


def _first_line_re():
    """
    Return a regular expression based on first_line_re suitable for matching
    strings.
    """
    if isinstance(first_line_re.pattern, str):
        return first_line_re

    # first_line_re in Python >=3.1.4 and >=3.2.1 is a bytes pattern.
    return re.compile(first_line_re.pattern.decode())


def auto_chmod(func, arg, exc):
    if func in [os.unlink, os.remove] and os.name == 'nt':
        chmod(arg, stat.S_IWRITE)
        return func(arg)
    et, ev, _ = sys.exc_info()
    six.reraise(et, (ev[0], ev[1] + (" %s %s" % (func, arg))))


def update_dist_caches(dist_path, fix_zipimporter_caches):
    """
    Fix any globally cached `dist_path` related data

    `dist_path` should be a path of a newly installed egg distribution (zipped
    or unzipped).

    sys.path_importer_cache contains finder objects that have been cached when
    importing data from the original distribution. Any such finders need to be
    cleared since the replacement distribution might be packaged differently,
    e.g. a zipped egg distribution might get replaced with an unzipped egg
    folder or vice versa. Having the old finders cached may then cause Python
    to attempt loading modules from the replacement distribution using an
    incorrect loader.

    zipimport.zipimporter objects are Python loaders charged with importing
    data packaged inside zip archives. If stale loaders referencing the
    original distribution, are left behind, they can fail to load modules from
    the replacement distribution. E.g. if an old zipimport.zipimporter instance
    is used to load data from a new zipped egg archive, it may cause the
    operation to attempt to locate the requested data in the wrong location -
    one indicated by the original distribution's zip archive directory
    information. Such an operation may then fail outright, e.g. report having
    read a 'bad local file header', or even worse, it may fail silently &
    return invalid data.

    zipimport._zip_directory_cache contains cached zip archive directory
    information for all existing zipimport.zipimporter instances and all such
    instances connected to the same archive share the same cached directory
    information.

    If asked, and the underlying Python implementation allows it, we can fix
    all existing zipimport.zipimporter instances instead of having to track
    them down and remove them one by one, by updating their shared cached zip
    archive directory information. This, of course, assumes that the
    replacement distribution is packaged as a zipped egg.

    If not asked to fix existing zipimport.zipimporter instances, we still do
    our best to clear any remaining zipimport.zipimporter related cached data
    that might somehow later get used when attempting to load data from the new
    distribution and thus cause such load operations to fail. Note that when
    tracking down such remaining stale data, we can not catch every conceivable
    usage from here, and we clear only those that we know of and have found to
    cause problems if left alive. Any remaining caches should be updated by
    whomever is in charge of maintaining them, i.e. they should be ready to
    handle us replacing their zip archives with new distributions at runtime.

    """
    # There are several other known sources of stale zipimport.zipimporter
    # instances that we do not clear here, but might if ever given a reason to
    # do so:
    # * Global setuptools pkg_resources.working_set (a.k.a. 'master working
    # set') may contain distributions which may in turn contain their
    #   zipimport.zipimporter loaders.
    # * Several zipimport.zipimporter loaders held by local variables further
    #   up the function call stack when running the setuptools installation.
    # * Already loaded modules may have their __loader__ attribute set to the
    #   exact loader instance used when importing them. Python 3.4 docs state
    #   that this information is intended mostly for introspection and so is
    #   not expected to cause us problems.
    normalized_path = normalize_path(dist_path)
    _uncache(normalized_path, sys.path_importer_cache)
    if fix_zipimporter_caches:
        _replace_zip_directory_cache_data(normalized_path)
    else:
        # Here, even though we do not want to fix existing and now stale
        # zipimporter cache information, we still want to remove it. Related to
        # Python's zip archive directory information cache, we clear each of
        # its stale entries in two phases:
        #   1. Clear the entry so attempting to access zip archive information
        #      via any existing stale zipimport.zipimporter instances fails.
        #   2. Remove the entry from the cache so any newly constructed
        #      zipimport.zipimporter instances do not end up using old stale
        #      zip archive directory information.
        # This whole stale data removal step does not seem strictly necessary,
        # but has been left in because it was done before we started replacing
        # the zip archive directory information cache content if possible, and
        # there are no relevant unit tests that we can depend on to tell us if
        # this is really needed.
        _remove_and_clear_zip_directory_cache_data(normalized_path)


def _collect_zipimporter_cache_entries(normalized_path, cache):
    """
    Return zipimporter cache entry keys related to a given normalized path.

    Alternative path spellings (e.g. those using different character case or
    those using alternative path separators) related to the same path are
    included. Any sub-path entries are included as well, i.e. those
    corresponding to zip archives embedded in other zip archives.

    """
    result = []
    prefix_len = len(normalized_path)
    for p in cache:
        np = normalize_path(p)
        if (np.startswith(normalized_path) and
                np[prefix_len:prefix_len + 1] in (os.sep, '')):
            result.append(p)
    return result


def _update_zipimporter_cache(normalized_path, cache, updater=None):
    """
    Update zipimporter cache data for a given normalized path.

    Any sub-path entries are processed as well, i.e. those corresponding to zip
    archives embedded in other zip archives.

    Given updater is a callable taking a cache entry key and the original entry
    (after already removing the entry from the cache), and expected to update
    the entry and possibly return a new one to be inserted in its place.
    Returning None indicates that the entry should not be replaced with a new
    one. If no updater is given, the cache entries are simply removed without
    any additional processing, the same as if the updater simply returned None.

    """
    for p in _collect_zipimporter_cache_entries(normalized_path, cache):
        # N.B. pypy's custom zipimport._zip_directory_cache implementation does
        # not support the complete dict interface:
        # * Does not support item assignment, thus not allowing this function
        #    to be used only for removing existing cache entries.
        #  * Does not support the dict.pop() method, forcing us to use the
        #    get/del patterns instead. For more detailed information see the
        #    following links:
        #      https://github.com/pypa/setuptools/issues/202#issuecomment-202913420
        #      http://bit.ly/2h9itJX
        old_entry = cache[p]
        del cache[p]
        new_entry = updater and updater(p, old_entry)
        if new_entry is not None:
            cache[p] = new_entry


def _uncache(normalized_path, cache):
    _update_zipimporter_cache(normalized_path, cache)


def _remove_and_clear_zip_directory_cache_data(normalized_path):
    def clear_and_remove_cached_zip_archive_directory_data(path, old_entry):
        old_entry.clear()

    _update_zipimporter_cache(
        normalized_path, zipimport._zip_directory_cache,
        updater=clear_and_remove_cached_zip_archive_directory_data)


# PyPy Python implementation does not allow directly writing to the
# zipimport._zip_directory_cache and so prevents us from attempting to correct
# its content. The best we can do there is clear the problematic cache content
# and have PyPy repopulate it as needed. The downside is that if there are any
# stale zipimport.zipimporter instances laying around, attempting to use them
# will fail due to not having its zip archive directory information available
# instead of being automatically corrected to use the new correct zip archive
# directory information.
if '__pypy__' in sys.builtin_module_names:
    _replace_zip_directory_cache_data = \
        _remove_and_clear_zip_directory_cache_data
else:

    def _replace_zip_directory_cache_data(normalized_path):
        def replace_cached_zip_archive_directory_data(path, old_entry):
            # N.B. In theory, we could load the zip directory information just
            # once for all updated path spellings, and then copy it locally and
            # update its contained path strings to contain the correct
            # spelling, but that seems like a way too invasive move (this cache
            # structure is not officially documented anywhere and could in
            # theory change with new Python releases) for no significant
            # benefit.
            old_entry.clear()
            zipimport.zipimporter(path)
            old_entry.update(zipimport._zip_directory_cache[path])
            return old_entry

        _update_zipimporter_cache(
            normalized_path, zipimport._zip_directory_cache,
            updater=replace_cached_zip_archive_directory_data)


def is_python(text, filename='<string>'):
    "Is this string a valid Python script?"
    try:
        compile(text, filename, 'exec')
    except (SyntaxError, TypeError):
        return False
    else:
        return True


def is_sh(executable):
    """Determine if the specified executable is a .sh (contains a #! line)"""
    try:
        with io.open(executable, encoding='latin-1') as fp:
            magic = fp.read(2)
    except (OSError, IOError):
        return executable
    return magic == '#!'


def nt_quote_arg(arg):
    """Quote a command line argument according to Windows parsing rules"""
    return subprocess.list2cmdline([arg])


def is_python_script(script_text, filename):
    """Is this text, as a whole, a Python script? (as opposed to shell/bat/etc.
    """
    if filename.endswith('.py') or filename.endswith('.pyw'):
        return True  # extension says it's Python
    if is_python(script_text, filename):
        return True  # it's syntactically valid Python
    if script_text.startswith('#!'):
        # It begins with a '#!' line, so check if 'python' is in it somewhere
        return 'python' in script_text.splitlines()[0].lower()

    return False  # Not any Python I can recognize


try:
    from os import chmod as _chmod
except ImportError:
    # Jython compatibility
    def _chmod(*args):
        pass


def chmod(path, mode):
    log.debug("changing mode of %s to %o", path, mode)
    try:
        _chmod(path, mode)
    except os.error as e:
        log.debug("chmod failed: %s", e)


class CommandSpec(list):
    """
    A command spec for a #! header, specified as a list of arguments akin to
    those passed to Popen.
    """

    options = []
    split_args = dict()

    @classmethod
    def best(cls):
        """
        Choose the best CommandSpec class based on environmental conditions.
        """
        return cls

    @classmethod
    def _sys_executable(cls):
        _default = os.path.normpath(sys.executable)
        return os.environ.get('__PYVENV_LAUNCHER__', _default)

    @classmethod
    def from_param(cls, param):
        """
        Construct a CommandSpec from a parameter to build_scripts, which may
        be None.
        """
        if isinstance(param, cls):
            return param
        if isinstance(param, list):
            return cls(param)
        if param is None:
            return cls.from_environment()
        # otherwise, assume it's a string.
        return cls.from_string(param)

    @classmethod
    def from_environment(cls):
        return cls([cls._sys_executable()])

    @classmethod
    def from_string(cls, string):
        """
        Construct a command spec from a simple string representing a command
        line parseable by shlex.split.
        """
        items = shlex.split(string, **cls.split_args)
        return cls(items)

    def install_options(self, script_text):
        self.options = shlex.split(self._extract_options(script_text))
        cmdline = subprocess.list2cmdline(self)
        if not isascii(cmdline):
            self.options[:0] = ['-x']

    @staticmethod
    def _extract_options(orig_script):
        """
        Extract any options from the first line of the script.
        """
        first = (orig_script + '\n').splitlines()[0]
        match = _first_line_re().match(first)
        options = match.group(1) or '' if match else ''
        return options.strip()

    def as_header(self):
        return self._render(self + list(self.options))

    @staticmethod
    def _strip_quotes(item):
        _QUOTES = '"\''
        for q in _QUOTES:
            if item.startswith(q) and item.endswith(q):
                return item[1:-1]
        return item

    @staticmethod
    def _render(items):
        cmdline = subprocess.list2cmdline(
            CommandSpec._strip_quotes(item.strip()) for item in items)
        return '#!' + cmdline + '\n'


# For pbr compat; will be removed in a future version.
sys_executable = CommandSpec._sys_executable()


class WindowsCommandSpec(CommandSpec):
    split_args = dict(posix=False)


class ScriptWriter:
    """
    Encapsulates behavior around writing entry point scripts for console and
    gui apps.
    """

    template = textwrap.dedent(r"""
        # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r
        __requires__ = %(spec)r
        import re
        import sys
        from pkg_resources import load_entry_point

        if __name__ == '__main__':
            sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0])
            sys.exit(
                load_entry_point(%(spec)r, %(group)r, %(name)r)()
            )
    """).lstrip()

    command_spec_class = CommandSpec

    @classmethod
    def get_script_args(cls, dist, executable=None, wininst=False):
        # for backward compatibility
        warnings.warn("Use get_args", EasyInstallDeprecationWarning)
        writer = (WindowsScriptWriter if wininst else ScriptWriter).best()
        header = cls.get_script_header("", executable, wininst)
        return writer.get_args(dist, header)

    @classmethod
    def get_script_header(cls, script_text, executable=None, wininst=False):
        # for backward compatibility
        warnings.warn("Use get_header", EasyInstallDeprecationWarning, stacklevel=2)
        if wininst:
            executable = "python.exe"
        return cls.get_header(script_text, executable)

    @classmethod
    def get_args(cls, dist, header=None):
        """
        Yield write_script() argument tuples for a distribution's
        console_scripts and gui_scripts entry points.
        """
        if header is None:
            header = cls.get_header()
        spec = str(dist.as_requirement())
        for type_ in 'console', 'gui':
            group = type_ + '_scripts'
            for name, ep in dist.get_entry_map(group).items():
                cls._ensure_safe_name(name)
                script_text = cls.template % locals()
                args = cls._get_script_args(type_, name, header, script_text)
                for res in args:
                    yield res

    @staticmethod
    def _ensure_safe_name(name):
        """
        Prevent paths in *_scripts entry point names.
        """
        has_path_sep = re.search(r'[\\/]', name)
        if has_path_sep:
            raise ValueError("Path separators not allowed in script names")

    @classmethod
    def get_writer(cls, force_windows):
        # for backward compatibility
        warnings.warn("Use best", EasyInstallDeprecationWarning)
        return WindowsScriptWriter.best() if force_windows else cls.best()

    @classmethod
    def best(cls):
        """
        Select the best ScriptWriter for this environment.
        """
        if sys.platform == 'win32' or (os.name == 'java' and os._name == 'nt'):
            return WindowsScriptWriter.best()
        else:
            return cls

    @classmethod
    def _get_script_args(cls, type_, name, header, script_text):
        # Simply write the stub with no extension.
        yield (name, header + script_text)

    @classmethod
    def get_header(cls, script_text="", executable=None):
        """Create a #! line, getting options (if any) from script_text"""
        cmd = cls.command_spec_class.best().from_param(executable)
        cmd.install_options(script_text)
        return cmd.as_header()


class WindowsScriptWriter(ScriptWriter):
    command_spec_class = WindowsCommandSpec

    @classmethod
    def get_writer(cls):
        # for backward compatibility
        warnings.warn("Use best", EasyInstallDeprecationWarning)
        return cls.best()

    @classmethod
    def best(cls):
        """
        Select the best ScriptWriter suitable for Windows
        """
        writer_lookup = dict(
            executable=WindowsExecutableLauncherWriter,
            natural=cls,
        )
        # for compatibility, use the executable launcher by default
        launcher = os.environ.get('SETUPTOOLS_LAUNCHER', 'executable')
        return writer_lookup[launcher]

    @classmethod
    def _get_script_args(cls, type_, name, header, script_text):
        "For Windows, add a .py extension"
        ext = dict(console='.pya', gui='.pyw')[type_]
        if ext not in os.environ['PATHEXT'].lower().split(';'):
            msg = (
                "{ext} not listed in PATHEXT; scripts will not be "
                "recognized as executables."
            ).format(**locals())
            warnings.warn(msg, UserWarning)
        old = ['.pya', '.py', '-script.py', '.pyc', '.pyo', '.pyw', '.exe']
        old.remove(ext)
        header = cls._adjust_header(type_, header)
        blockers = [name + x for x in old]
        yield name + ext, header + script_text, 't', blockers

    @classmethod
    def _adjust_header(cls, type_, orig_header):
        """
        Make sure 'pythonw' is used for gui and and 'python' is used for
        console (regardless of what sys.executable is).
        """
        pattern = 'pythonw.exe'
        repl = 'python.exe'
        if type_ == 'gui':
            pattern, repl = repl, pattern
        pattern_ob = re.compile(re.escape(pattern), re.IGNORECASE)
        new_header = pattern_ob.sub(string=orig_header, repl=repl)
        return new_header if cls._use_header(new_header) else orig_header

    @staticmethod
    def _use_header(new_header):
        """
        Should _adjust_header use the replaced header?

        On non-windows systems, always use. On
        Windows systems, only use the replaced header if it resolves
        to an executable on the system.
        """
        clean_header = new_header[2:-1].strip('"')
        return sys.platform != 'win32' or find_executable(clean_header)


class WindowsExecutableLauncherWriter(WindowsScriptWriter):
    @classmethod
    def _get_script_args(cls, type_, name, header, script_text):
        """
        For Windows, add a .py extension and an .exe launcher
        """
        if type_ == 'gui':
            launcher_type = 'gui'
            ext = '-script.pyw'
            old = ['.pyw']
        else:
            launcher_type = 'cli'
            ext = '-script.py'
            old = ['.py', '.pyc', '.pyo']
        hdr = cls._adjust_header(type_, header)
        blockers = [name + x for x in old]
        yield (name + ext, hdr + script_text, 't', blockers)
        yield (
            name + '.exe', get_win_launcher(launcher_type),
            'b'  # write in binary mode
        )
        if not is_64bit():
            # install a manifest for the launcher to prevent Windows
            # from detecting it as an installer (which it will for
            #  launchers like easy_install.exe). Consider only
            #  adding a manifest for launchers detected as installers.
            #  See Distribute #143 for details.
            m_name = name + '.exe.manifest'
            yield (m_name, load_launcher_manifest(name), 't')


# for backward-compatibility
get_script_args = ScriptWriter.get_script_args
get_script_header = ScriptWriter.get_script_header


def get_win_launcher(type):
    """
    Load the Windows launcher (executable) suitable for launching a script.

    `type` should be either 'cli' or 'gui'

    Returns the executable as a byte string.
    """
    launcher_fn = '%s.exe' % type
    if is_64bit():
        launcher_fn = launcher_fn.replace(".", "-64.")
    else:
        launcher_fn = launcher_fn.replace(".", "-32.")
    return resource_string('setuptools', launcher_fn)


def load_launcher_manifest(name):
    manifest = pkg_resources.resource_string(__name__, 'launcher manifest.xml')
    if six.PY2:
        return manifest % vars()
    else:
        return manifest.decode('utf-8') % vars()


def rmtree(path, ignore_errors=False, onerror=auto_chmod):
    return shutil.rmtree(path, ignore_errors, onerror)


def current_umask():
    tmp = os.umask(0o022)
    os.umask(tmp)
    return tmp


def bootstrap():
    # This function is called when setuptools*.egg is run using /bin/sh
    import setuptools

    argv0 = os.path.dirname(setuptools.__path__[0])
    sys.argv[0] = argv0
    sys.argv.append(argv0)
    main()


def main(argv=None, **kw):
    from setuptools import setup
    from setuptools.dist import Distribution

    class DistributionWithoutHelpCommands(Distribution):
        common_usage = ""

        def _show_help(self, *args, **kw):
            with _patch_usage():
                Distribution._show_help(self, *args, **kw)

    if argv is None:
        argv = sys.argv[1:]

    with _patch_usage():
        setup(
            script_args=['-q', 'easy_install', '-v'] + argv,
            script_name=sys.argv[0] or 'easy_install',
            distclass=DistributionWithoutHelpCommands,
            **kw
        )


@contextlib.contextmanager
def _patch_usage():
    import distutils.core
    USAGE = textwrap.dedent("""
        usage: %(script)s [options] requirement_or_url ...
           or: %(script)s --help
        """).lstrip()

    def gen_usage(script_name):
        return USAGE % dict(
            script=os.path.basename(script_name),
        )

    saved = distutils.core.gen_usage
    distutils.core.gen_usage = gen_usage
    try:
        yield
    finally:
        distutils.core.gen_usage = saved

class EasyInstallDeprecationWarning(SetuptoolsDeprecationWarning):
    """Class for warning about deprecations in EasyInstall in SetupTools. Not ignored by default, unlike DeprecationWarning."""
    
site-packages/setuptools/command/install_scripts.py000064400000004607151446177000016726 0ustar00from distutils import log
import distutils.command.install_scripts as orig
import os
import sys

from pkg_resources import Distribution, PathMetadata, ensure_directory


class install_scripts(orig.install_scripts):
    """Do normal script install, plus any egg_info wrapper scripts"""

    def initialize_options(self):
        orig.install_scripts.initialize_options(self)
        self.no_ep = False

    def run(self):
        import setuptools.command.easy_install as ei

        self.run_command("egg_info")
        if self.distribution.scripts:
            orig.install_scripts.run(self)  # run first to set up self.outfiles
        else:
            self.outfiles = []
        if self.no_ep:
            # don't install entry point scripts into .egg file!
            return

        ei_cmd = self.get_finalized_command("egg_info")
        dist = Distribution(
            ei_cmd.egg_base, PathMetadata(ei_cmd.egg_base, ei_cmd.egg_info),
            ei_cmd.egg_name, ei_cmd.egg_version,
        )
        bs_cmd = self.get_finalized_command('build_scripts')
        exec_param = getattr(bs_cmd, 'executable', None)
        bw_cmd = self.get_finalized_command("bdist_wininst")
        is_wininst = getattr(bw_cmd, '_is_running', False)
        writer = ei.ScriptWriter
        if is_wininst:
            exec_param = "python.exe"
            writer = ei.WindowsScriptWriter
        if exec_param == sys.executable:
            # In case the path to the Python executable contains a space, wrap
            # it so it's not split up.
            exec_param = [exec_param]
        # resolve the writer to the environment
        writer = writer.best()
        cmd = writer.command_spec_class.best().from_param(exec_param)
        for args in writer.get_args(dist, cmd.as_header()):
            self.write_script(*args)

    def write_script(self, script_name, contents, mode="t", *ignored):
        """Write an executable file to the scripts directory"""
        from setuptools.command.easy_install import chmod, current_umask

        log.info("Installing %s script to %s", script_name, self.install_dir)
        target = os.path.join(self.install_dir, script_name)
        self.outfiles.append(target)

        mask = current_umask()
        if not self.dry_run:
            ensure_directory(target)
            f = open(target, "w" + mode)
            f.write(contents)
            f.close()
            chmod(target, 0o777 - mask)
site-packages/setuptools/command/upload.py000064400000015233151446177000014772 0ustar00import io
import os
import hashlib
import getpass

from base64 import standard_b64encode

from distutils import log
from distutils.command import upload as orig
from distutils.spawn import spawn

from distutils.errors import DistutilsError

from setuptools.extern.six.moves.urllib.request import urlopen, Request
from setuptools.extern.six.moves.urllib.error import HTTPError
from setuptools.extern.six.moves.urllib.parse import urlparse


class upload(orig.upload):
    """
    Override default upload behavior to obtain password
    in a variety of different ways.
    """
    def run(self):
        try:
            orig.upload.run(self)
        finally:
            self.announce(
                "WARNING: Uploading via this command is deprecated, use twine "
                "to upload instead (https://pypi.org/p/twine/)",
                log.WARN
            )

    def finalize_options(self):
        orig.upload.finalize_options(self)
        self.username = (
            self.username or
            getpass.getuser()
        )
        # Attempt to obtain password. Short circuit evaluation at the first
        # sign of success.
        self.password = (
            self.password or
            self._load_password_from_keyring() or
            self._prompt_for_password()
        )

    def upload_file(self, command, pyversion, filename):
        # Makes sure the repository URL is compliant
        schema, netloc, url, params, query, fragments = \
            urlparse(self.repository)
        if params or query or fragments:
            raise AssertionError("Incompatible url %s" % self.repository)

        if schema not in ('http', 'https'):
            raise AssertionError("unsupported schema " + schema)

        # Sign if requested
        if self.sign:
            gpg_args = ["gpg", "--detach-sign", "-a", filename]
            if self.identity:
                gpg_args[2:2] = ["--local-user", self.identity]
            spawn(gpg_args,
                  dry_run=self.dry_run)

        # Fill in the data - send all the meta-data in case we need to
        # register a new release
        with open(filename, 'rb') as f:
            content = f.read()

        meta = self.distribution.metadata

        data = {
            # action
            ':action': 'file_upload',
            'protocol_version': '1',

            # identify release
            'name': meta.get_name(),
            'version': meta.get_version(),

            # file content
            'content': (os.path.basename(filename), content),
            'filetype': command,
            'pyversion': pyversion,
            'md5_digest': hashlib.md5(content).hexdigest(),

            # additional meta-data
            'metadata_version': str(meta.get_metadata_version()),
            'summary': meta.get_description(),
            'home_page': meta.get_url(),
            'author': meta.get_contact(),
            'author_email': meta.get_contact_email(),
            'license': meta.get_licence(),
            'description': meta.get_long_description(),
            'keywords': meta.get_keywords(),
            'platform': meta.get_platforms(),
            'classifiers': meta.get_classifiers(),
            'download_url': meta.get_download_url(),
            # PEP 314
            'provides': meta.get_provides(),
            'requires': meta.get_requires(),
            'obsoletes': meta.get_obsoletes(),
            }

        data['comment'] = ''

        if self.sign:
            data['gpg_signature'] = (os.path.basename(filename) + ".asc",
                                     open(filename+".asc", "rb").read())

        # set up the authentication
        user_pass = (self.username + ":" + self.password).encode('ascii')
        # The exact encoding of the authentication string is debated.
        # Anyway PyPI only accepts ascii for both username or password.
        auth = "Basic " + standard_b64encode(user_pass).decode('ascii')

        # Build up the MIME payload for the POST data
        boundary = '--------------GHSKFJDLGDS7543FJKLFHRE75642756743254'
        sep_boundary = b'\r\n--' + boundary.encode('ascii')
        end_boundary = sep_boundary + b'--\r\n'
        body = io.BytesIO()
        for key, value in data.items():
            title = '\r\nContent-Disposition: form-data; name="%s"' % key
            # handle multiple entries for the same name
            if not isinstance(value, list):
                value = [value]
            for value in value:
                if type(value) is tuple:
                    title += '; filename="%s"' % value[0]
                    value = value[1]
                else:
                    value = str(value).encode('utf-8')
                body.write(sep_boundary)
                body.write(title.encode('utf-8'))
                body.write(b"\r\n\r\n")
                body.write(value)
        body.write(end_boundary)
        body = body.getvalue()

        msg = "Submitting %s to %s" % (filename, self.repository)
        self.announce(msg, log.INFO)

        # build the Request
        headers = {
            'Content-type': 'multipart/form-data; boundary=%s' % boundary,
            'Content-length': str(len(body)),
            'Authorization': auth,
        }

        request = Request(self.repository, data=body,
                          headers=headers)
        # send the data
        try:
            result = urlopen(request)
            status = result.getcode()
            reason = result.msg
        except HTTPError as e:
            status = e.code
            reason = e.msg
        except OSError as e:
            self.announce(str(e), log.ERROR)
            raise

        if status == 200:
            self.announce('Server response (%s): %s' % (status, reason),
                          log.INFO)
            if self.show_response:
                text = getattr(self, '_read_pypi_response',
                               lambda x: None)(result)
                if text is not None:
                    msg = '\n'.join(('-' * 75, text, '-' * 75))
                    self.announce(msg, log.INFO)
        else:
            msg = 'Upload failed (%s): %s' % (status, reason)
            self.announce(msg, log.ERROR)
            raise DistutilsError(msg)

    def _load_password_from_keyring(self):
        """
        Attempt to load password from keyring. Suppress Exceptions.
        """
        try:
            keyring = __import__('keyring')
            return keyring.get_password(self.repository, self.username)
        except Exception:
            pass

    def _prompt_for_password(self):
        """
        Prompt for a password on the tty. Suppress Exceptions.
        """
        try:
            return getpass.getpass()
        except (Exception, KeyboardInterrupt):
            pass
site-packages/setuptools/command/install_egg_info.py000064400000004233151446177000017007 0ustar00from distutils import log, dir_util
import os

from setuptools import Command
from setuptools import namespaces
from setuptools.archive_util import unpack_archive
import pkg_resources


class install_egg_info(namespaces.Installer, Command):
    """Install an .egg-info directory for the package"""

    description = "Install an .egg-info directory for the package"

    user_options = [
        ('install-dir=', 'd', "directory to install to"),
    ]

    def initialize_options(self):
        self.install_dir = None

    def finalize_options(self):
        self.set_undefined_options('install_lib',
                                   ('install_dir', 'install_dir'))
        ei_cmd = self.get_finalized_command("egg_info")
        basename = pkg_resources.Distribution(
            None, None, ei_cmd.egg_name, ei_cmd.egg_version
        ).egg_name() + '.egg-info'
        self.source = ei_cmd.egg_info
        self.target = os.path.join(self.install_dir, basename)
        self.outputs = []

    def run(self):
        self.run_command('egg_info')
        if os.path.isdir(self.target) and not os.path.islink(self.target):
            dir_util.remove_tree(self.target, dry_run=self.dry_run)
        elif os.path.exists(self.target):
            self.execute(os.unlink, (self.target,), "Removing " + self.target)
        if not self.dry_run:
            pkg_resources.ensure_directory(self.target)
        self.execute(
            self.copytree, (), "Copying %s to %s" % (self.source, self.target)
        )
        self.install_namespaces()

    def get_outputs(self):
        return self.outputs

    def copytree(self):
        # Copy the .egg-info tree to site-packages
        def skimmer(src, dst):
            # filter out source-control directories; note that 'src' is always
            # a '/'-separated path, regardless of platform.  'dst' is a
            # platform-specific path.
            for skip in '.svn/', 'CVS/':
                if src.startswith(skip) or '/' + skip in src:
                    return None
            self.outputs.append(dst)
            log.debug("Copying %s to %s", src, dst)
            return dst

        unpack_archive(self.source, self.target, skimmer)
site-packages/setuptools/command/build_ext.py000064400000031333151446177000015464 0ustar00import os
import sys
import itertools
from distutils.command.build_ext import build_ext as _du_build_ext
from distutils.file_util import copy_file
from distutils.ccompiler import new_compiler
from distutils.sysconfig import customize_compiler, get_config_var
from distutils.errors import DistutilsError
from distutils import log

from setuptools.extension import Library
from setuptools.extern import six

if six.PY2:
    import imp

    EXTENSION_SUFFIXES = [s for s, _, tp in imp.get_suffixes() if tp == imp.C_EXTENSION]
else:
    from importlib.machinery import EXTENSION_SUFFIXES

try:
    # Attempt to use Cython for building extensions, if available
    from Cython.Distutils.build_ext import build_ext as _build_ext
    # Additionally, assert that the compiler module will load
    # also. Ref #1229.
    __import__('Cython.Compiler.Main')
except ImportError:
    _build_ext = _du_build_ext

# make sure _config_vars is initialized
get_config_var("LDSHARED")
from distutils.sysconfig import _config_vars as _CONFIG_VARS


def _customize_compiler_for_shlib(compiler):
    if sys.platform == "darwin":
        # building .dylib requires additional compiler flags on OSX; here we
        # temporarily substitute the pyconfig.h variables so that distutils'
        # 'customize_compiler' uses them before we build the shared libraries.
        tmp = _CONFIG_VARS.copy()
        try:
            # XXX Help!  I don't have any idea whether these are right...
            _CONFIG_VARS['LDSHARED'] = (
                "gcc -Wl,-x -dynamiclib -undefined dynamic_lookup")
            _CONFIG_VARS['CCSHARED'] = " -dynamiclib"
            _CONFIG_VARS['SO'] = ".dylib"
            customize_compiler(compiler)
        finally:
            _CONFIG_VARS.clear()
            _CONFIG_VARS.update(tmp)
    else:
        customize_compiler(compiler)


have_rtld = False
use_stubs = False
libtype = 'shared'

if sys.platform == "darwin":
    use_stubs = True
elif os.name != 'nt':
    try:
        import dl
        use_stubs = have_rtld = hasattr(dl, 'RTLD_NOW')
    except ImportError:
        pass

if_dl = lambda s: s if have_rtld else ''


def get_abi3_suffix():
    """Return the file extension for an abi3-compliant Extension()"""
    for suffix in EXTENSION_SUFFIXES:
        if '.abi3' in suffix:  # Unix
            return suffix
        elif suffix == '.pyd':  # Windows
            return suffix


class build_ext(_build_ext):
    def run(self):
        """Build extensions in build directory, then copy if --inplace"""
        old_inplace, self.inplace = self.inplace, 0
        _build_ext.run(self)
        self.inplace = old_inplace
        if old_inplace:
            self.copy_extensions_to_source()

    def copy_extensions_to_source(self):
        build_py = self.get_finalized_command('build_py')
        for ext in self.extensions:
            fullname = self.get_ext_fullname(ext.name)
            filename = self.get_ext_filename(fullname)
            modpath = fullname.split('.')
            package = '.'.join(modpath[:-1])
            package_dir = build_py.get_package_dir(package)
            dest_filename = os.path.join(package_dir,
                                         os.path.basename(filename))
            src_filename = os.path.join(self.build_lib, filename)

            # Always copy, even if source is older than destination, to ensure
            # that the right extensions for the current Python/platform are
            # used.
            copy_file(
                src_filename, dest_filename, verbose=self.verbose,
                dry_run=self.dry_run
            )
            if ext._needs_stub:
                self.write_stub(package_dir or os.curdir, ext, True)

    def get_ext_filename(self, fullname):
        filename = _build_ext.get_ext_filename(self, fullname)
        if fullname in self.ext_map:
            ext = self.ext_map[fullname]
            use_abi3 = (
                six.PY3
                and getattr(ext, 'py_limited_api')
                and get_abi3_suffix()
            )
            if use_abi3:
                so_ext = get_config_var('EXT_SUFFIX')
                filename = filename[:-len(so_ext)]
                filename = filename + get_abi3_suffix()
            if isinstance(ext, Library):
                fn, ext = os.path.splitext(filename)
                return self.shlib_compiler.library_filename(fn, libtype)
            elif use_stubs and ext._links_to_dynamic:
                d, fn = os.path.split(filename)
                return os.path.join(d, 'dl-' + fn)
        return filename

    def initialize_options(self):
        _build_ext.initialize_options(self)
        self.shlib_compiler = None
        self.shlibs = []
        self.ext_map = {}

    def finalize_options(self):
        _build_ext.finalize_options(self)
        self.extensions = self.extensions or []
        self.check_extensions_list(self.extensions)
        self.shlibs = [ext for ext in self.extensions
                       if isinstance(ext, Library)]
        if self.shlibs:
            self.setup_shlib_compiler()
        for ext in self.extensions:
            ext._full_name = self.get_ext_fullname(ext.name)
        for ext in self.extensions:
            fullname = ext._full_name
            self.ext_map[fullname] = ext

            # distutils 3.1 will also ask for module names
            # XXX what to do with conflicts?
            self.ext_map[fullname.split('.')[-1]] = ext

            ltd = self.shlibs and self.links_to_dynamic(ext) or False
            ns = ltd and use_stubs and not isinstance(ext, Library)
            ext._links_to_dynamic = ltd
            ext._needs_stub = ns
            filename = ext._file_name = self.get_ext_filename(fullname)
            libdir = os.path.dirname(os.path.join(self.build_lib, filename))
            if ltd and libdir not in ext.library_dirs:
                ext.library_dirs.append(libdir)
            if ltd and use_stubs and os.curdir not in ext.runtime_library_dirs:
                ext.runtime_library_dirs.append(os.curdir)

    def setup_shlib_compiler(self):
        compiler = self.shlib_compiler = new_compiler(
            compiler=self.compiler, dry_run=self.dry_run, force=self.force
        )
        _customize_compiler_for_shlib(compiler)

        if self.include_dirs is not None:
            compiler.set_include_dirs(self.include_dirs)
        if self.define is not None:
            # 'define' option is a list of (name,value) tuples
            for (name, value) in self.define:
                compiler.define_macro(name, value)
        if self.undef is not None:
            for macro in self.undef:
                compiler.undefine_macro(macro)
        if self.libraries is not None:
            compiler.set_libraries(self.libraries)
        if self.library_dirs is not None:
            compiler.set_library_dirs(self.library_dirs)
        if self.rpath is not None:
            compiler.set_runtime_library_dirs(self.rpath)
        if self.link_objects is not None:
            compiler.set_link_objects(self.link_objects)

        # hack so distutils' build_extension() builds a library instead
        compiler.link_shared_object = link_shared_object.__get__(compiler)

    def get_export_symbols(self, ext):
        if isinstance(ext, Library):
            return ext.export_symbols
        return _build_ext.get_export_symbols(self, ext)

    def build_extension(self, ext):
        ext._convert_pyx_sources_to_lang()
        _compiler = self.compiler
        try:
            if isinstance(ext, Library):
                self.compiler = self.shlib_compiler
            _build_ext.build_extension(self, ext)
            if ext._needs_stub:
                cmd = self.get_finalized_command('build_py').build_lib
                self.write_stub(cmd, ext)
        finally:
            self.compiler = _compiler

    def links_to_dynamic(self, ext):
        """Return true if 'ext' links to a dynamic lib in the same package"""
        # XXX this should check to ensure the lib is actually being built
        # XXX as dynamic, and not just using a locally-found version or a
        # XXX static-compiled version
        libnames = dict.fromkeys([lib._full_name for lib in self.shlibs])
        pkg = '.'.join(ext._full_name.split('.')[:-1] + [''])
        return any(pkg + libname in libnames for libname in ext.libraries)

    def get_outputs(self):
        return _build_ext.get_outputs(self) + self.__get_stubs_outputs()

    def __get_stubs_outputs(self):
        # assemble the base name for each extension that needs a stub
        ns_ext_bases = (
            os.path.join(self.build_lib, *ext._full_name.split('.'))
            for ext in self.extensions
            if ext._needs_stub
        )
        # pair each base with the extension
        pairs = itertools.product(ns_ext_bases, self.__get_output_extensions())
        return list(base + fnext for base, fnext in pairs)

    def __get_output_extensions(self):
        yield '.py'
        yield '.pyc'
        if self.get_finalized_command('build_py').optimize:
            yield '.pyo'

    def write_stub(self, output_dir, ext, compile=False):
        log.info("writing stub loader for %s to %s", ext._full_name,
                 output_dir)
        stub_file = (os.path.join(output_dir, *ext._full_name.split('.')) +
                     '.py')
        if compile and os.path.exists(stub_file):
            raise DistutilsError(stub_file + " already exists! Please delete.")
        if not self.dry_run:
            f = open(stub_file, 'w')
            f.write(
                '\n'.join([
                    "def __bootstrap__():",
                    "   global __bootstrap__, __file__, __loader__",
                    "   import sys, os, pkg_resources, imp" + if_dl(", dl"),
                    "   __file__ = pkg_resources.resource_filename"
                    "(__name__,%r)"
                    % os.path.basename(ext._file_name),
                    "   del __bootstrap__",
                    "   if '__loader__' in globals():",
                    "       del __loader__",
                    if_dl("   old_flags = sys.getdlopenflags()"),
                    "   old_dir = os.getcwd()",
                    "   try:",
                    "     os.chdir(os.path.dirname(__file__))",
                    if_dl("     sys.setdlopenflags(dl.RTLD_NOW)"),
                    "     imp.load_dynamic(__name__,__file__)",
                    "   finally:",
                    if_dl("     sys.setdlopenflags(old_flags)"),
                    "     os.chdir(old_dir)",
                    "__bootstrap__()",
                    ""  # terminal \n
                ])
            )
            f.close()
        if compile:
            from distutils.util import byte_compile

            byte_compile([stub_file], optimize=0,
                         force=True, dry_run=self.dry_run)
            optimize = self.get_finalized_command('install_lib').optimize
            if optimize > 0:
                byte_compile([stub_file], optimize=optimize,
                             force=True, dry_run=self.dry_run)
            if os.path.exists(stub_file) and not self.dry_run:
                os.unlink(stub_file)


if use_stubs or os.name == 'nt':
    # Build shared libraries
    #
    def link_shared_object(
            self, objects, output_libname, output_dir=None, libraries=None,
            library_dirs=None, runtime_library_dirs=None, export_symbols=None,
            debug=0, extra_preargs=None, extra_postargs=None, build_temp=None,
            target_lang=None):
        self.link(
            self.SHARED_LIBRARY, objects, output_libname,
            output_dir, libraries, library_dirs, runtime_library_dirs,
            export_symbols, debug, extra_preargs, extra_postargs,
            build_temp, target_lang
        )
else:
    # Build static libraries everywhere else
    libtype = 'static'

    def link_shared_object(
            self, objects, output_libname, output_dir=None, libraries=None,
            library_dirs=None, runtime_library_dirs=None, export_symbols=None,
            debug=0, extra_preargs=None, extra_postargs=None, build_temp=None,
            target_lang=None):
        # XXX we need to either disallow these attrs on Library instances,
        # or warn/abort here if set, or something...
        # libraries=None, library_dirs=None, runtime_library_dirs=None,
        # export_symbols=None, extra_preargs=None, extra_postargs=None,
        # build_temp=None

        assert output_dir is None  # distutils build_ext doesn't pass this
        output_dir, filename = os.path.split(output_libname)
        basename, ext = os.path.splitext(filename)
        if self.library_filename("x").startswith('lib'):
            # strip 'lib' prefix; this is kludgy if some platform uses
            # a different prefix
            basename = basename[3:]

        self.create_static_lib(
            objects, basename, output_dir, debug, target_lang
        )
site-packages/setuptools/command/test.py000064400000022602151446177000014463 0ustar00import os
import operator
import sys
import contextlib
import itertools
import unittest
from distutils.errors import DistutilsError, DistutilsOptionError
from distutils import log
from unittest import TestLoader

from setuptools.extern import six
from setuptools.extern.six.moves import map, filter

from pkg_resources import (resource_listdir, resource_exists, normalize_path,
                           working_set, _namespace_packages, evaluate_marker,
                           add_activation_listener, require, EntryPoint)
from setuptools import Command
from .build_py import _unique_everseen

__metaclass__ = type


class ScanningLoader(TestLoader):

    def __init__(self):
        TestLoader.__init__(self)
        self._visited = set()

    def loadTestsFromModule(self, module, pattern=None):
        """Return a suite of all tests cases contained in the given module

        If the module is a package, load tests from all the modules in it.
        If the module has an ``additional_tests`` function, call it and add
        the return value to the tests.
        """
        if module in self._visited:
            return None
        self._visited.add(module)

        tests = []
        tests.append(TestLoader.loadTestsFromModule(self, module))

        if hasattr(module, "additional_tests"):
            tests.append(module.additional_tests())

        if hasattr(module, '__path__'):
            for file in resource_listdir(module.__name__, ''):
                if file.endswith('.py') and file != '__init__.py':
                    submodule = module.__name__ + '.' + file[:-3]
                else:
                    if resource_exists(module.__name__, file + '/__init__.py'):
                        submodule = module.__name__ + '.' + file
                    else:
                        continue
                tests.append(self.loadTestsFromName(submodule))

        if len(tests) != 1:
            return self.suiteClass(tests)
        else:
            return tests[0]  # don't create a nested suite for only one return


# adapted from jaraco.classes.properties:NonDataProperty
class NonDataProperty:
    def __init__(self, fget):
        self.fget = fget

    def __get__(self, obj, objtype=None):
        if obj is None:
            return self
        return self.fget(obj)


class test(Command):
    """Command to run unit tests after in-place build"""

    description = "run unit tests after in-place build (deprecated)"

    user_options = [
        ('test-module=', 'm', "Run 'test_suite' in specified module"),
        ('test-suite=', 's',
         "Run single test, case or suite (e.g. 'module.test_suite')"),
        ('test-runner=', 'r', "Test runner to use"),
    ]

    def initialize_options(self):
        self.test_suite = None
        self.test_module = None
        self.test_loader = None
        self.test_runner = None

    def finalize_options(self):

        if self.test_suite and self.test_module:
            msg = "You may specify a module or a suite, but not both"
            raise DistutilsOptionError(msg)

        if self.test_suite is None:
            if self.test_module is None:
                self.test_suite = self.distribution.test_suite
            else:
                self.test_suite = self.test_module + ".test_suite"

        if self.test_loader is None:
            self.test_loader = getattr(self.distribution, 'test_loader', None)
        if self.test_loader is None:
            self.test_loader = "setuptools.command.test:ScanningLoader"
        if self.test_runner is None:
            self.test_runner = getattr(self.distribution, 'test_runner', None)

    @NonDataProperty
    def test_args(self):
        return list(self._test_args())

    def _test_args(self):
        if not self.test_suite and sys.version_info >= (2, 7):
            yield 'discover'
        if self.verbose:
            yield '--verbose'
        if self.test_suite:
            yield self.test_suite

    def with_project_on_sys_path(self, func):
        """
        Backward compatibility for project_on_sys_path context.
        """
        with self.project_on_sys_path():
            func()

    @contextlib.contextmanager
    def project_on_sys_path(self, include_dists=[]):
        with_2to3 = six.PY3 and getattr(self.distribution, 'use_2to3', False)

        if with_2to3:
            # If we run 2to3 we can not do this inplace:

            # Ensure metadata is up-to-date
            self.reinitialize_command('build_py', inplace=0)
            self.run_command('build_py')
            bpy_cmd = self.get_finalized_command("build_py")
            build_path = normalize_path(bpy_cmd.build_lib)

            # Build extensions
            self.reinitialize_command('egg_info', egg_base=build_path)
            self.run_command('egg_info')

            self.reinitialize_command('build_ext', inplace=0)
            self.run_command('build_ext')
        else:
            # Without 2to3 inplace works fine:
            self.run_command('egg_info')

            # Build extensions in-place
            self.reinitialize_command('build_ext', inplace=1)
            self.run_command('build_ext')

        ei_cmd = self.get_finalized_command("egg_info")

        old_path = sys.path[:]
        old_modules = sys.modules.copy()

        try:
            project_path = normalize_path(ei_cmd.egg_base)
            sys.path.insert(0, project_path)
            working_set.__init__()
            add_activation_listener(lambda dist: dist.activate())
            require('%s==%s' % (ei_cmd.egg_name, ei_cmd.egg_version))
            with self.paths_on_pythonpath([project_path]):
                yield
        finally:
            sys.path[:] = old_path
            sys.modules.clear()
            sys.modules.update(old_modules)
            working_set.__init__()

    @staticmethod
    @contextlib.contextmanager
    def paths_on_pythonpath(paths):
        """
        Add the indicated paths to the head of the PYTHONPATH environment
        variable so that subprocesses will also see the packages at
        these paths.

        Do this in a context that restores the value on exit.
        """
        nothing = object()
        orig_pythonpath = os.environ.get('PYTHONPATH', nothing)
        current_pythonpath = os.environ.get('PYTHONPATH', '')
        try:
            prefix = os.pathsep.join(_unique_everseen(paths))
            to_join = filter(None, [prefix, current_pythonpath])
            new_path = os.pathsep.join(to_join)
            if new_path:
                os.environ['PYTHONPATH'] = new_path
            yield
        finally:
            if orig_pythonpath is nothing:
                os.environ.pop('PYTHONPATH', None)
            else:
                os.environ['PYTHONPATH'] = orig_pythonpath

    @staticmethod
    def install_dists(dist):
        """
        Install the requirements indicated by self.distribution and
        return an iterable of the dists that were built.
        """
        ir_d = dist.fetch_build_eggs(dist.install_requires)
        tr_d = dist.fetch_build_eggs(dist.tests_require or [])
        er_d = dist.fetch_build_eggs(
            v for k, v in dist.extras_require.items()
            if k.startswith(':') and evaluate_marker(k[1:])
        )
        return itertools.chain(ir_d, tr_d, er_d)

    def run(self):
        self.announce(
            "WARNING: Testing via this command is deprecated and will be "
            "removed in a future version. Users looking for a generic test "
            "entry point independent of test runner are encouraged to use "
            "tox.",
            log.WARN,
        )

        installed_dists = self.install_dists(self.distribution)

        cmd = ' '.join(self._argv)
        if self.dry_run:
            self.announce('skipping "%s" (dry run)' % cmd)
            return

        self.announce('running "%s"' % cmd)

        paths = map(operator.attrgetter('location'), installed_dists)
        with self.paths_on_pythonpath(paths):
            with self.project_on_sys_path():
                self.run_tests()

    def run_tests(self):
        # Purge modules under test from sys.modules. The test loader will
        # re-import them from the build location. Required when 2to3 is used
        # with namespace packages.
        if six.PY3 and getattr(self.distribution, 'use_2to3', False):
            module = self.test_suite.split('.')[0]
            if module in _namespace_packages:
                del_modules = []
                if module in sys.modules:
                    del_modules.append(module)
                module += '.'
                for name in sys.modules:
                    if name.startswith(module):
                        del_modules.append(name)
                list(map(sys.modules.__delitem__, del_modules))

        test = unittest.main(
            None, None, self._argv,
            testLoader=self._resolve_as_ep(self.test_loader),
            testRunner=self._resolve_as_ep(self.test_runner),
            exit=False,
        )
        if not test.result.wasSuccessful():
            msg = 'Test failed: %s' % test.result
            self.announce(msg, log.ERROR)
            raise DistutilsError(msg)

    @property
    def _argv(self):
        return ['unittest'] + self.test_args

    @staticmethod
    def _resolve_as_ep(val):
        """
        Load the indicated attribute value, called, as a as if it were
        specified as an entry point.
        """
        if val is None:
            return
        parsed = EntryPoint.parse("x=" + val)
        return parsed.resolve()()
site-packages/setuptools/command/develop.py000064400000017770151446177000015154 0ustar00from distutils.util import convert_path
from distutils import log
from distutils.errors import DistutilsError, DistutilsOptionError
import os
import glob
import io

from setuptools.extern import six

import pkg_resources
from setuptools.command.easy_install import easy_install
from setuptools import namespaces
import setuptools

__metaclass__ = type


class develop(namespaces.DevelopInstaller, easy_install):
    """Set up package for development"""

    description = "install package in 'development mode'"

    user_options = easy_install.user_options + [
        ("uninstall", "u", "Uninstall this source package"),
        ("egg-path=", None, "Set the path to be used in the .egg-link file"),
    ]

    boolean_options = easy_install.boolean_options + ['uninstall']

    command_consumes_arguments = False  # override base

    def run(self):
        if self.uninstall:
            self.multi_version = True
            self.uninstall_link()
            self.uninstall_namespaces()
        else:
            self.install_for_development()
        self.warn_deprecated_options()

    def initialize_options(self):
        self.uninstall = None
        self.egg_path = None
        easy_install.initialize_options(self)
        self.setup_path = None
        self.always_copy_from = '.'  # always copy eggs installed in curdir

    def finalize_options(self):
        ei = self.get_finalized_command("egg_info")
        if ei.broken_egg_info:
            template = "Please rename %r to %r before using 'develop'"
            args = ei.egg_info, ei.broken_egg_info
            raise DistutilsError(template % args)
        self.args = [ei.egg_name]

        easy_install.finalize_options(self)
        self.expand_basedirs()
        self.expand_dirs()
        # pick up setup-dir .egg files only: no .egg-info
        self.package_index.scan(glob.glob('*.egg'))

        egg_link_fn = ei.egg_name + '.egg-link'
        self.egg_link = os.path.join(self.install_dir, egg_link_fn)
        self.egg_base = ei.egg_base
        if self.egg_path is None:
            self.egg_path = os.path.abspath(ei.egg_base)

        target = pkg_resources.normalize_path(self.egg_base)
        egg_path = pkg_resources.normalize_path(
            os.path.join(self.install_dir, self.egg_path))
        if egg_path != target:
            raise DistutilsOptionError(
                "--egg-path must be a relative path from the install"
                " directory to " + target
            )

        # Make a distribution for the package's source
        self.dist = pkg_resources.Distribution(
            target,
            pkg_resources.PathMetadata(target, os.path.abspath(ei.egg_info)),
            project_name=ei.egg_name
        )

        self.setup_path = self._resolve_setup_path(
            self.egg_base,
            self.install_dir,
            self.egg_path,
        )

    @staticmethod
    def _resolve_setup_path(egg_base, install_dir, egg_path):
        """
        Generate a path from egg_base back to '.' where the
        setup script resides and ensure that path points to the
        setup path from $install_dir/$egg_path.
        """
        path_to_setup = egg_base.replace(os.sep, '/').rstrip('/')
        if path_to_setup != os.curdir:
            path_to_setup = '../' * (path_to_setup.count('/') + 1)
        resolved = pkg_resources.normalize_path(
            os.path.join(install_dir, egg_path, path_to_setup)
        )
        if resolved != pkg_resources.normalize_path(os.curdir):
            raise DistutilsOptionError(
                "Can't get a consistent path to setup script from"
                " installation directory", resolved,
                pkg_resources.normalize_path(os.curdir))
        return path_to_setup

    def install_for_development(self):
        if six.PY3 and getattr(self.distribution, 'use_2to3', False):
            # If we run 2to3 we can not do this inplace:

            # Ensure metadata is up-to-date
            self.reinitialize_command('build_py', inplace=0)
            self.run_command('build_py')
            bpy_cmd = self.get_finalized_command("build_py")
            build_path = pkg_resources.normalize_path(bpy_cmd.build_lib)

            # Build extensions
            self.reinitialize_command('egg_info', egg_base=build_path)
            self.run_command('egg_info')

            self.reinitialize_command('build_ext', inplace=0)
            self.run_command('build_ext')

            # Fixup egg-link and easy-install.pth
            ei_cmd = self.get_finalized_command("egg_info")
            self.egg_path = build_path
            self.dist.location = build_path
            # XXX
            self.dist._provider = pkg_resources.PathMetadata(
                build_path, ei_cmd.egg_info)
        else:
            # Without 2to3 inplace works fine:
            self.run_command('egg_info')

            # Build extensions in-place
            self.reinitialize_command('build_ext', inplace=1)
            self.run_command('build_ext')

        self.install_site_py()  # ensure that target dir is site-safe
        if setuptools.bootstrap_install_from:
            self.easy_install(setuptools.bootstrap_install_from)
            setuptools.bootstrap_install_from = None

        self.install_namespaces()

        # create an .egg-link in the installation dir, pointing to our egg
        log.info("Creating %s (link to %s)", self.egg_link, self.egg_base)
        if not self.dry_run:
            with open(self.egg_link, "w") as f:
                f.write(self.egg_path + "\n" + self.setup_path)
        # postprocess the installed distro, fixing up .pth, installing scripts,
        # and handling requirements
        self.process_distribution(None, self.dist, not self.no_deps)

    def uninstall_link(self):
        if os.path.exists(self.egg_link):
            log.info("Removing %s (link to %s)", self.egg_link, self.egg_base)
            egg_link_file = open(self.egg_link)
            contents = [line.rstrip() for line in egg_link_file]
            egg_link_file.close()
            if contents not in ([self.egg_path],
                                [self.egg_path, self.setup_path]):
                log.warn("Link points to %s: uninstall aborted", contents)
                return
            if not self.dry_run:
                os.unlink(self.egg_link)
        if not self.dry_run:
            self.update_pth(self.dist)  # remove any .pth link to us
        if self.distribution.scripts:
            # XXX should also check for entry point scripts!
            log.warn("Note: you must uninstall or replace scripts manually!")

    def install_egg_scripts(self, dist):
        if dist is not self.dist:
            # Installing a dependency, so fall back to normal behavior
            return easy_install.install_egg_scripts(self, dist)

        # create wrapper scripts in the script dir, pointing to dist.scripts

        # new-style...
        self.install_wrapper_scripts(dist)

        # ...and old-style
        for script_name in self.distribution.scripts or []:
            script_path = os.path.abspath(convert_path(script_name))
            script_name = os.path.basename(script_path)
            with io.open(script_path) as strm:
                script_text = strm.read()
            self.install_script(dist, script_name, script_text, script_path)

    def install_wrapper_scripts(self, dist):
        dist = VersionlessRequirement(dist)
        return easy_install.install_wrapper_scripts(self, dist)


class VersionlessRequirement:
    """
    Adapt a pkg_resources.Distribution to simply return the project
    name as the 'requirement' so that scripts will work across
    multiple versions.

    >>> from pkg_resources import Distribution
    >>> dist = Distribution(project_name='foo', version='1.0')
    >>> str(dist.as_requirement())
    'foo==1.0'
    >>> adapted_dist = VersionlessRequirement(dist)
    >>> str(adapted_dist.as_requirement())
    'foo'
    """

    def __init__(self, dist):
        self.__dist = dist

    def __getattr__(self, name):
        return getattr(self.__dist, name)

    def as_requirement(self):
        return self.project_name
site-packages/setuptools/windows_support.py000064400000001312151446177000015347 0ustar00import platform
import ctypes


def windows_only(func):
    if platform.system() != 'Windows':
        return lambda *args, **kwargs: None
    return func


@windows_only
def hide_file(path):
    """
    Set the hidden attribute on a file or directory.

    From http://stackoverflow.com/questions/19622133/

    `path` must be text.
    """
    __import__('ctypes.wintypes')
    SetFileAttributes = ctypes.windll.kernel32.SetFileAttributesW
    SetFileAttributes.argtypes = ctypes.wintypes.LPWSTR, ctypes.wintypes.DWORD
    SetFileAttributes.restype = ctypes.wintypes.BOOL

    FILE_ATTRIBUTE_HIDDEN = 0x02

    ret = SetFileAttributes(path, FILE_ATTRIBUTE_HIDDEN)
    if not ret:
        raise ctypes.WinError()
site-packages/setuptools/monkey.py000064400000012220151446177000013363 0ustar00"""
Monkey patching of distutils.
"""

import sys
import distutils.filelist
import platform
import types
import functools
from importlib import import_module
import inspect

from setuptools.extern import six

import setuptools

__all__ = []
"""
Everything is private. Contact the project team
if you think you need this functionality.
"""


def _get_mro(cls):
    """
    Returns the bases classes for cls sorted by the MRO.

    Works around an issue on Jython where inspect.getmro will not return all
    base classes if multiple classes share the same name. Instead, this
    function will return a tuple containing the class itself, and the contents
    of cls.__bases__. See https://github.com/pypa/setuptools/issues/1024.
    """
    if platform.python_implementation() == "Jython":
        return (cls,) + cls.__bases__
    return inspect.getmro(cls)


def get_unpatched(item):
    lookup = (
        get_unpatched_class if isinstance(item, six.class_types) else
        get_unpatched_function if isinstance(item, types.FunctionType) else
        lambda item: None
    )
    return lookup(item)


def get_unpatched_class(cls):
    """Protect against re-patching the distutils if reloaded

    Also ensures that no other distutils extension monkeypatched the distutils
    first.
    """
    external_bases = (
        cls
        for cls in _get_mro(cls)
        if not cls.__module__.startswith('setuptools')
    )
    base = next(external_bases)
    if not base.__module__.startswith('distutils'):
        msg = "distutils has already been patched by %r" % cls
        raise AssertionError(msg)
    return base


def patch_all():
    # we can't patch distutils.cmd, alas
    distutils.core.Command = setuptools.Command

    has_issue_12885 = sys.version_info <= (3, 5, 3)

    if has_issue_12885:
        # fix findall bug in distutils (http://bugs.python.org/issue12885)
        distutils.filelist.findall = setuptools.findall

    needs_warehouse = (
        sys.version_info < (2, 7, 13)
        or
        (3, 4) < sys.version_info < (3, 4, 6)
        or
        (3, 5) < sys.version_info <= (3, 5, 3)
    )

    if needs_warehouse:
        warehouse = 'https://upload.pypi.org/legacy/'
        distutils.config.PyPIRCCommand.DEFAULT_REPOSITORY = warehouse

    _patch_distribution_metadata()

    # Install Distribution throughout the distutils
    for module in distutils.dist, distutils.core, distutils.cmd:
        module.Distribution = setuptools.dist.Distribution

    # Install the patched Extension
    distutils.core.Extension = setuptools.extension.Extension
    distutils.extension.Extension = setuptools.extension.Extension
    if 'distutils.command.build_ext' in sys.modules:
        sys.modules['distutils.command.build_ext'].Extension = (
            setuptools.extension.Extension
        )

    patch_for_msvc_specialized_compiler()


def _patch_distribution_metadata():
    """Patch write_pkg_file and read_pkg_file for higher metadata standards"""
    for attr in ('write_pkg_file', 'read_pkg_file', 'get_metadata_version'):
        new_val = getattr(setuptools.dist, attr)
        setattr(distutils.dist.DistributionMetadata, attr, new_val)


def patch_func(replacement, target_mod, func_name):
    """
    Patch func_name in target_mod with replacement

    Important - original must be resolved by name to avoid
    patching an already patched function.
    """
    original = getattr(target_mod, func_name)

    # set the 'unpatched' attribute on the replacement to
    # point to the original.
    vars(replacement).setdefault('unpatched', original)

    # replace the function in the original module
    setattr(target_mod, func_name, replacement)


def get_unpatched_function(candidate):
    return getattr(candidate, 'unpatched')


def patch_for_msvc_specialized_compiler():
    """
    Patch functions in distutils to use standalone Microsoft Visual C++
    compilers.
    """
    # import late to avoid circular imports on Python < 3.5
    msvc = import_module('setuptools.msvc')

    if platform.system() != 'Windows':
        # Compilers only availables on Microsoft Windows
        return

    def patch_params(mod_name, func_name):
        """
        Prepare the parameters for patch_func to patch indicated function.
        """
        repl_prefix = 'msvc9_' if 'msvc9' in mod_name else 'msvc14_'
        repl_name = repl_prefix + func_name.lstrip('_')
        repl = getattr(msvc, repl_name)
        mod = import_module(mod_name)
        if not hasattr(mod, func_name):
            raise ImportError(func_name)
        return repl, mod, func_name

    # Python 2.7 to 3.4
    msvc9 = functools.partial(patch_params, 'distutils.msvc9compiler')

    # Python 3.5+
    msvc14 = functools.partial(patch_params, 'distutils._msvccompiler')

    try:
        # Patch distutils.msvc9compiler
        patch_func(*msvc9('find_vcvarsall'))
        patch_func(*msvc9('query_vcvarsall'))
    except ImportError:
        pass

    try:
        # Patch distutils._msvccompiler._get_vc_env
        patch_func(*msvc14('_get_vc_env'))
    except ImportError:
        pass

    try:
        # Patch distutils._msvccompiler.gen_lib_options for Numpy
        patch_func(*msvc14('gen_lib_options'))
    except ImportError:
        pass